Compare commits
45 Commits
Author | SHA1 | Date |
---|---|---|
Bauke | ccb0968b18 | |
Bauke | 2727eb51b7 | |
Bauke | 2e579f350d | |
Bauke | 6274e51752 | |
Bauke | ed29853516 | |
Bauke | fe06822b24 | |
Bauke | 6630eff27f | |
Bauke | e0583b4f77 | |
Bauke | 46b3db5538 | |
Bauke | ee70b18781 | |
Bauke | 6ba718de35 | |
Bauke | 6936cb2969 | |
Bauke | 4a46f327ab | |
Bauke | bc8a9b0efe | |
Bauke | 8d63c2ae8f | |
Bauke | 3d527ba6cc | |
Bauke | ebdab9d5c7 | |
Bauke | edbf5524b2 | |
Bauke | 4373048194 | |
Bauke | 35f8906b52 | |
Bauke | 679782a26f | |
Bauke | 903f6ebbf2 | |
Bauke | 4a24828c32 | |
Bauke | 16b017013a | |
Bauke | 08c3f467cf | |
Bauke | 7b63504323 | |
Bauke | eb6407ef7e | |
Bauke | 4660c42868 | |
Bauke | f9e9f3aa5d | |
Bauke | bbfee36f5b | |
Bauke | f9ebb80db7 | |
Bauke | 75cbdcfb75 | |
Bauke | 48bb588145 | |
Bauke | 3082221c4d | |
Bauke | 66c3f7e444 | |
Bauke | bfb0b33ba3 | |
Bauke | 9237d3f7a0 | |
Bauke | 8b76be1c0f | |
Bauke | 42f5c15826 | |
Bauke | c086eda7de | |
Bauke | 28123cfb3f | |
Bauke | d66b43e9fd | |
Bauke | 06a1ee5550 | |
Bauke | 54a841b580 | |
Bauke | aecbc024ec |
143
LICENSE
|
@ -1,5 +1,5 @@
|
||||||
GNU GENERAL PUBLIC LICENSE
|
GNU AFFERO GENERAL PUBLIC LICENSE
|
||||||
Version 3, 29 June 2007
|
Version 3, 19 November 2007
|
||||||
|
|
||||||
Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
|
Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
|
||||||
Everyone is permitted to copy and distribute verbatim copies
|
Everyone is permitted to copy and distribute verbatim copies
|
||||||
|
@ -7,17 +7,15 @@
|
||||||
|
|
||||||
Preamble
|
Preamble
|
||||||
|
|
||||||
The GNU General Public License is a free, copyleft license for
|
The GNU Affero General Public License is a free, copyleft license for
|
||||||
software and other kinds of works.
|
software and other kinds of works, specifically designed to ensure
|
||||||
|
cooperation with the community in the case of network server software.
|
||||||
|
|
||||||
The licenses for most software and other practical works are designed
|
The licenses for most software and other practical works are designed
|
||||||
to take away your freedom to share and change the works. By contrast,
|
to take away your freedom to share and change the works. By contrast,
|
||||||
the GNU General Public License is intended to guarantee your freedom to
|
our General Public Licenses are intended to guarantee your freedom to
|
||||||
share and change all versions of a program--to make sure it remains free
|
share and change all versions of a program--to make sure it remains free
|
||||||
software for all its users. We, the Free Software Foundation, use the
|
software for all its users.
|
||||||
GNU General Public License for most of our software; it applies also to
|
|
||||||
any other work released this way by its authors. You can apply it to
|
|
||||||
your programs, too.
|
|
||||||
|
|
||||||
When we speak of free software, we are referring to freedom, not
|
When we speak of free software, we are referring to freedom, not
|
||||||
price. Our General Public Licenses are designed to make sure that you
|
price. Our General Public Licenses are designed to make sure that you
|
||||||
|
@ -26,44 +24,34 @@ them if you wish), that you receive source code or can get it if you
|
||||||
want it, that you can change the software or use pieces of it in new
|
want it, that you can change the software or use pieces of it in new
|
||||||
free programs, and that you know you can do these things.
|
free programs, and that you know you can do these things.
|
||||||
|
|
||||||
To protect your rights, we need to prevent others from denying you
|
Developers that use our General Public Licenses protect your rights
|
||||||
these rights or asking you to surrender the rights. Therefore, you have
|
with two steps: (1) assert copyright on the software, and (2) offer
|
||||||
certain responsibilities if you distribute copies of the software, or if
|
you this License which gives you legal permission to copy, distribute
|
||||||
you modify it: responsibilities to respect the freedom of others.
|
and/or modify the software.
|
||||||
|
|
||||||
For example, if you distribute copies of such a program, whether
|
A secondary benefit of defending all users' freedom is that
|
||||||
gratis or for a fee, you must pass on to the recipients the same
|
improvements made in alternate versions of the program, if they
|
||||||
freedoms that you received. You must make sure that they, too, receive
|
receive widespread use, become available for other developers to
|
||||||
or can get the source code. And you must show them these terms so they
|
incorporate. Many developers of free software are heartened and
|
||||||
know their rights.
|
encouraged by the resulting cooperation. However, in the case of
|
||||||
|
software used on network servers, this result may fail to come about.
|
||||||
|
The GNU General Public License permits making a modified version and
|
||||||
|
letting the public access it on a server without ever releasing its
|
||||||
|
source code to the public.
|
||||||
|
|
||||||
Developers that use the GNU GPL protect your rights with two steps:
|
The GNU Affero General Public License is designed specifically to
|
||||||
(1) assert copyright on the software, and (2) offer you this License
|
ensure that, in such cases, the modified source code becomes available
|
||||||
giving you legal permission to copy, distribute and/or modify it.
|
to the community. It requires the operator of a network server to
|
||||||
|
provide the source code of the modified version running there to the
|
||||||
|
users of that server. Therefore, public use of a modified version, on
|
||||||
|
a publicly accessible server, gives the public access to the source
|
||||||
|
code of the modified version.
|
||||||
|
|
||||||
For the developers' and authors' protection, the GPL clearly explains
|
An older license, called the Affero General Public License and
|
||||||
that there is no warranty for this free software. For both users' and
|
published by Affero, was designed to accomplish similar goals. This is
|
||||||
authors' sake, the GPL requires that modified versions be marked as
|
a different license, not a version of the Affero GPL, but Affero has
|
||||||
changed, so that their problems will not be attributed erroneously to
|
released a new version of the Affero GPL which permits relicensing under
|
||||||
authors of previous versions.
|
this license.
|
||||||
|
|
||||||
Some devices are designed to deny users access to install or run
|
|
||||||
modified versions of the software inside them, although the manufacturer
|
|
||||||
can do so. This is fundamentally incompatible with the aim of
|
|
||||||
protecting users' freedom to change the software. The systematic
|
|
||||||
pattern of such abuse occurs in the area of products for individuals to
|
|
||||||
use, which is precisely where it is most unacceptable. Therefore, we
|
|
||||||
have designed this version of the GPL to prohibit the practice for those
|
|
||||||
products. If such problems arise substantially in other domains, we
|
|
||||||
stand ready to extend this provision to those domains in future versions
|
|
||||||
of the GPL, as needed to protect the freedom of users.
|
|
||||||
|
|
||||||
Finally, every program is threatened constantly by software patents.
|
|
||||||
States should not allow patents to restrict development and use of
|
|
||||||
software on general-purpose computers, but in those that do, we wish to
|
|
||||||
avoid the special danger that patents applied to a free program could
|
|
||||||
make it effectively proprietary. To prevent this, the GPL assures that
|
|
||||||
patents cannot be used to render the program non-free.
|
|
||||||
|
|
||||||
The precise terms and conditions for copying, distribution and
|
The precise terms and conditions for copying, distribution and
|
||||||
modification follow.
|
modification follow.
|
||||||
|
@ -72,7 +60,7 @@ modification follow.
|
||||||
|
|
||||||
0. Definitions.
|
0. Definitions.
|
||||||
|
|
||||||
"This License" refers to version 3 of the GNU General Public License.
|
"This License" refers to version 3 of the GNU Affero General Public License.
|
||||||
|
|
||||||
"Copyright" also means copyright-like laws that apply to other kinds of
|
"Copyright" also means copyright-like laws that apply to other kinds of
|
||||||
works, such as semiconductor masks.
|
works, such as semiconductor masks.
|
||||||
|
@ -549,35 +537,45 @@ to collect a royalty for further conveying from those to whom you convey
|
||||||
the Program, the only way you could satisfy both those terms and this
|
the Program, the only way you could satisfy both those terms and this
|
||||||
License would be to refrain entirely from conveying the Program.
|
License would be to refrain entirely from conveying the Program.
|
||||||
|
|
||||||
13. Use with the GNU Affero General Public License.
|
13. Remote Network Interaction; Use with the GNU General Public License.
|
||||||
|
|
||||||
|
Notwithstanding any other provision of this License, if you modify the
|
||||||
|
Program, your modified version must prominently offer all users
|
||||||
|
interacting with it remotely through a computer network (if your version
|
||||||
|
supports such interaction) an opportunity to receive the Corresponding
|
||||||
|
Source of your version by providing access to the Corresponding Source
|
||||||
|
from a network server at no charge, through some standard or customary
|
||||||
|
means of facilitating copying of software. This Corresponding Source
|
||||||
|
shall include the Corresponding Source for any work covered by version 3
|
||||||
|
of the GNU General Public License that is incorporated pursuant to the
|
||||||
|
following paragraph.
|
||||||
|
|
||||||
Notwithstanding any other provision of this License, you have
|
Notwithstanding any other provision of this License, you have
|
||||||
permission to link or combine any covered work with a work licensed
|
permission to link or combine any covered work with a work licensed
|
||||||
under version 3 of the GNU Affero General Public License into a single
|
under version 3 of the GNU General Public License into a single
|
||||||
combined work, and to convey the resulting work. The terms of this
|
combined work, and to convey the resulting work. The terms of this
|
||||||
License will continue to apply to the part which is the covered work,
|
License will continue to apply to the part which is the covered work,
|
||||||
but the special requirements of the GNU Affero General Public License,
|
but the work with which it is combined will remain governed by version
|
||||||
section 13, concerning interaction through a network will apply to the
|
3 of the GNU General Public License.
|
||||||
combination as such.
|
|
||||||
|
|
||||||
14. Revised Versions of this License.
|
14. Revised Versions of this License.
|
||||||
|
|
||||||
The Free Software Foundation may publish revised and/or new versions of
|
The Free Software Foundation may publish revised and/or new versions of
|
||||||
the GNU General Public License from time to time. Such new versions will
|
the GNU Affero General Public License from time to time. Such new versions
|
||||||
be similar in spirit to the present version, but may differ in detail to
|
will be similar in spirit to the present version, but may differ in detail to
|
||||||
address new problems or concerns.
|
address new problems or concerns.
|
||||||
|
|
||||||
Each version is given a distinguishing version number. If the
|
Each version is given a distinguishing version number. If the
|
||||||
Program specifies that a certain numbered version of the GNU General
|
Program specifies that a certain numbered version of the GNU Affero General
|
||||||
Public License "or any later version" applies to it, you have the
|
Public License "or any later version" applies to it, you have the
|
||||||
option of following the terms and conditions either of that numbered
|
option of following the terms and conditions either of that numbered
|
||||||
version or of any later version published by the Free Software
|
version or of any later version published by the Free Software
|
||||||
Foundation. If the Program does not specify a version number of the
|
Foundation. If the Program does not specify a version number of the
|
||||||
GNU General Public License, you may choose any version ever published
|
GNU Affero General Public License, you may choose any version ever published
|
||||||
by the Free Software Foundation.
|
by the Free Software Foundation.
|
||||||
|
|
||||||
If the Program specifies that a proxy can decide which future
|
If the Program specifies that a proxy can decide which future
|
||||||
versions of the GNU General Public License can be used, that proxy's
|
versions of the GNU Affero General Public License can be used, that proxy's
|
||||||
public statement of acceptance of a version permanently authorizes you
|
public statement of acceptance of a version permanently authorizes you
|
||||||
to choose that version for the Program.
|
to choose that version for the Program.
|
||||||
|
|
||||||
|
@ -635,40 +633,29 @@ the "copyright" line and a pointer to where the full notice is found.
|
||||||
Copyright (C) <year> <name of author>
|
Copyright (C) <year> <name of author>
|
||||||
|
|
||||||
This program is free software: you can redistribute it and/or modify
|
This program is free software: you can redistribute it and/or modify
|
||||||
it under the terms of the GNU General Public License as published by
|
it under the terms of the GNU Affero General Public License as published
|
||||||
the Free Software Foundation, either version 3 of the License, or
|
by the Free Software Foundation, either version 3 of the License, or
|
||||||
(at your option) any later version.
|
(at your option) any later version.
|
||||||
|
|
||||||
This program is distributed in the hope that it will be useful,
|
This program is distributed in the hope that it will be useful,
|
||||||
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||||
GNU General Public License for more details.
|
GNU Affero General Public License for more details.
|
||||||
|
|
||||||
You should have received a copy of the GNU General Public License
|
You should have received a copy of the GNU Affero General Public License
|
||||||
along with this program. If not, see <https://www.gnu.org/licenses/>.
|
along with this program. If not, see <https://www.gnu.org/licenses/>.
|
||||||
|
|
||||||
Also add information on how to contact you by electronic and paper mail.
|
Also add information on how to contact you by electronic and paper mail.
|
||||||
|
|
||||||
If the program does terminal interaction, make it output a short
|
If your software can interact with users remotely through a computer
|
||||||
notice like this when it starts in an interactive mode:
|
network, you should also make sure that it provides a way for users to
|
||||||
|
get its source. For example, if your program is a web application, its
|
||||||
<program> Copyright (C) <year> <name of author>
|
interface could display a "Source" link that leads users to an archive
|
||||||
This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
|
of the code. There are many ways you could offer source, and different
|
||||||
This is free software, and you are welcome to redistribute it
|
solutions will be better for different programs; see section 13 for the
|
||||||
under certain conditions; type `show c' for details.
|
specific requirements.
|
||||||
|
|
||||||
The hypothetical commands `show w' and `show c' should show the appropriate
|
|
||||||
parts of the General Public License. Of course, your program's commands
|
|
||||||
might be different; for a GUI interface, you would use an "about box".
|
|
||||||
|
|
||||||
You should also get your employer (if you work as a programmer) or school,
|
You should also get your employer (if you work as a programmer) or school,
|
||||||
if any, to sign a "copyright disclaimer" for the program, if necessary.
|
if any, to sign a "copyright disclaimer" for the program, if necessary.
|
||||||
For more information on this, and how to apply and follow the GNU GPL, see
|
For more information on this, and how to apply and follow the GNU AGPL, see
|
||||||
<https://www.gnu.org/licenses/>.
|
<https://www.gnu.org/licenses/>.
|
||||||
|
|
||||||
The GNU General Public License does not permit incorporating your program
|
|
||||||
into proprietary programs. If your program is a subroutine library, you
|
|
||||||
may consider it more useful to permit linking proprietary applications with
|
|
||||||
the library. If this is what you want to do, use the GNU Lesser General
|
|
||||||
Public License instead of this License. But first, please read
|
|
||||||
<https://www.gnu.org/licenses/why-not-lgpl.html>.
|
|
||||||
|
|
49
README.md
|
@ -1,48 +1,29 @@
|
||||||
# Fangs
|
# Fangs 🧛
|
||||||
|
|
||||||
> Inject custom DuckDuckGo Bangs into your browsing experience.
|
> **Inject custom DuckDuckGo Bangs.**
|
||||||
|
|
||||||
[![Fangs on AMO](https://img.shields.io/amo/v/holllo-fangs)](https://addons.mozilla.org/firefox/addon/holllo-fangs)
|
[![Get Fangs for Firefox](./images/mozilla-addons.png)](https://addons.mozilla.org/firefox/addon/fangs)
|
||||||
|
[![Get Fangs for Chrome](./images/chrome-web-store.png)](https://chrome.google.com/webstore/detail/fangs/dlllfannplfkhbiidhihagjkbmcolclf)
|
||||||
|
[![Get Fangs for Edge](./images/microsoft.png)](https://microsoftedge.microsoft.com/addons/detail/fangs/fgfkpbflhnljpfniippaagjjlncobhjd)
|
||||||
|
|
||||||
![Fangs 0.1.0](./screenshots/fangs-version-0-1-0.png)
|
![Latest Fangs screenshot](./images/fangs-version-0-2-0.png)
|
||||||
|
|
||||||
## Installation
|
## Installation
|
||||||
|
|
||||||
You can install Fangs through [Mozilla Addons], [installing from a file] (see [the Releases page] for a prebuilt version) or building [from source](#development).
|
You can install Fangs through the stores linked above, [manually from a file] (see [the Releases page] for ZIP files) or [from source](#development).
|
||||||
|
|
||||||
[installing from a file]: https://support.mozilla.org/en-US/kb/find-and-install-add-ons-add-features-to-firefox#w_how-do-i-find-and-install-add-ons
|
[manually from a file]: https://support.mozilla.org/en-US/kb/find-and-install-add-ons-add-features-to-firefox#w_how-do-i-find-and-install-add-ons
|
||||||
[Mozilla Addons]: https://addons.mozilla.org/firefox/addon/holllo-fangs/
|
[the Releases page]: https://git.bauke.xyz/Holllo/fangs/releases
|
||||||
[the Releases page]: https://github.com/Holllo/fangs/releases
|
|
||||||
|
|
||||||
## Development
|
## Development
|
||||||
|
|
||||||
To build Fangs you will need [git], [NodeJS] and [pnpm]. Then from a terminal, run the following commands.
|
To build Fangs you will need [git](https://git-scm.com), [NodeJS](https://nodejs.org) and [pnpm](https://pnpm.io).
|
||||||
|
|
||||||
[git]: https://git-scm.com
|
* Install the dependencies with `pnpm install`.
|
||||||
[NodeJS]: https://nodejs.org
|
* Start a separate browser with `pnpm start`.
|
||||||
[pnpm]: https://pnpm.io
|
* Build the WebExtension for production with `pnpm build`.
|
||||||
|
* Test the code with `pnpm test`.
|
||||||
```sh
|
|
||||||
# Step 1. Download the repository with Git.
|
|
||||||
git clone https://github.com/Holllo/fangs
|
|
||||||
cd fangs
|
|
||||||
|
|
||||||
# Step 2. Install the dependencies.
|
|
||||||
pnpm install
|
|
||||||
|
|
||||||
# Step 3. Start an auto-reloading browser instance for development.
|
|
||||||
pnpm start
|
|
||||||
|
|
||||||
# Step 4. Lint the code and run tests.
|
|
||||||
pnpm test
|
|
||||||
|
|
||||||
# Step 5. Build the WebExtension for production.
|
|
||||||
# See the web-ext-artifacts directory for output.
|
|
||||||
pnpm build
|
|
||||||
```
|
|
||||||
|
|
||||||
## License
|
## License
|
||||||
|
|
||||||
Fangs is open-sourced with the [GPL-3.0-or-later] license.
|
Distributed under the [AGPL-3.0-or-later](https://spdx.org/licenses/AGPL-3.0-or-later.html) license, see [LICENSE](https://git.bauke.xyz/Holllo/fangs/src/branch/main/LICENSE) for more information.
|
||||||
|
|
||||||
[GPL-3.0-or-later]: https://github.com/Holllo/fangs/blob/main/LICENSE
|
|
||||||
|
|
After Width: | Height: | Size: 3.7 KiB |
Before Width: | Height: | Size: 120 KiB After Width: | Height: | Size: 120 KiB |
After Width: | Height: | Size: 120 KiB |
After Width: | Height: | Size: 147 KiB |
After Width: | Height: | Size: 18 KiB |
After Width: | Height: | Size: 5.3 KiB |
49
package.json
|
@ -1,37 +1,39 @@
|
||||||
{
|
{
|
||||||
"name": "fangs",
|
|
||||||
"license": "GPL-3.0-or-later",
|
|
||||||
"repository": "https://github.com/Holllo/fangs",
|
|
||||||
"private": true,
|
"private": true,
|
||||||
"scripts": {
|
"scripts": {
|
||||||
"start": "vite build -m development --watch",
|
"start": "vite build -m development --watch",
|
||||||
|
"start:chromium": "VITE_BROWSER=chromium pnpm start",
|
||||||
"clean": "trash build web-ext-artifacts",
|
"clean": "trash build web-ext-artifacts",
|
||||||
"build": "pnpm clean && vite build && web-ext build --source-dir build && pnpm zip-source",
|
"build": "pnpm clean && pnpm build:chromium && pnpm build:firefox && pnpm zip-source",
|
||||||
|
"build:chromium": "VITE_BROWSER=chromium vite build && web-ext build -n fangs-chromium-{version}.zip -s build/chromium",
|
||||||
|
"build:firefox": "VITE_BROWSER=firefox vite build && web-ext build -n fangs-firefox-{version}.zip -s build/firefox",
|
||||||
"zip-source": "git archive --format zip --output web-ext-artifacts/fangs-source.zip HEAD",
|
"zip-source": "git archive --format zip --output web-ext-artifacts/fangs-source.zip HEAD",
|
||||||
"test": "xo && stylelint 'source/**/*.scss' && tsc && c8 ava"
|
"test": "xo && stylelint 'source/**/*.scss' && tsc && c8 ava"
|
||||||
},
|
},
|
||||||
"dependencies": {
|
"dependencies": {
|
||||||
"htm": "^3.1.0",
|
"@holllo/preact-components": "^0.2.3",
|
||||||
|
"htm": "^3.1.1",
|
||||||
"modern-normalize": "^1.1.0",
|
"modern-normalize": "^1.1.0",
|
||||||
"preact": "^10.6.6",
|
"preact": "^10.11.0",
|
||||||
"webextension-polyfill": "^0.8.0"
|
"webextension-polyfill": "^0.10.0"
|
||||||
},
|
},
|
||||||
"devDependencies": {
|
"devDependencies": {
|
||||||
"@preact/preset-vite": "^2.1.7",
|
"@preact/preset-vite": "^2.4.0",
|
||||||
"@types/webextension-polyfill": "^0.8.2",
|
"@types/babel__core": "^7.1.19",
|
||||||
"ava": "^4.1.0",
|
"@types/webextension-polyfill": "^0.9.1",
|
||||||
"c8": "^7.11.0",
|
"ava": "^4.3.3",
|
||||||
"postcss": "^8.4.8",
|
"c8": "^7.12.0",
|
||||||
"sass": "^1.49.9",
|
"postcss": "^8.4.16",
|
||||||
"stylelint": "^14.5.3",
|
"sass": "^1.55.0",
|
||||||
"stylelint-config-standard-scss": "^3.0.0",
|
"stylelint": "^14.12.1",
|
||||||
|
"stylelint-config-standard-scss": "^5.0.0",
|
||||||
"trash-cli": "^5.0.0",
|
"trash-cli": "^5.0.0",
|
||||||
"ts-node": "^10.7.0",
|
"ts-node": "^10.9.1",
|
||||||
"typescript": "^4.6.2",
|
"typescript": "^4.8.3",
|
||||||
"vite": "^2.8.6",
|
"vite": "^3.1.3",
|
||||||
"vite-plugin-web-extension": "^1.1.3",
|
"vite-plugin-web-extension": "^1.4.4",
|
||||||
"web-ext": "^6.7.0",
|
"web-ext": "^7.2.0",
|
||||||
"xo": "^0.48.0"
|
"xo": "^0.52.3"
|
||||||
},
|
},
|
||||||
"ava": {
|
"ava": {
|
||||||
"extensions": [
|
"extensions": [
|
||||||
|
@ -61,12 +63,17 @@
|
||||||
{
|
{
|
||||||
"files": "tests/**/*.test.ts",
|
"files": "tests/**/*.test.ts",
|
||||||
"rules": {
|
"rules": {
|
||||||
|
"@typescript-eslint/triple-slash-reference": "off",
|
||||||
"import/extensions": "off",
|
"import/extensions": "off",
|
||||||
"no-await-in-loop": "off"
|
"no-await-in-loop": "off"
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
],
|
],
|
||||||
"prettier": true,
|
"prettier": true,
|
||||||
|
"rules": {
|
||||||
|
"@typescript-eslint/consistent-type-definitions": "off",
|
||||||
|
"n/file-extension-in-import": "off"
|
||||||
|
},
|
||||||
"space": true
|
"space": true
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
3451
pnpm-lock.yaml
|
@ -1,20 +1,37 @@
|
||||||
import browser from 'webextension-polyfill';
|
import browser from 'webextension-polyfill';
|
||||||
|
|
||||||
import Bang, {BangParameters} from '../bang/bang.js';
|
import Bang, {type BangParameters} from '../bang/bang.js';
|
||||||
|
|
||||||
browser.browserAction.onClicked.addListener(async () => {
|
async function browserActionClicked() {
|
||||||
await browser.runtime.openOptionsPage();
|
await browser.runtime.openOptionsPage();
|
||||||
});
|
}
|
||||||
|
|
||||||
|
if (import.meta.env.VITE_BROWSER === 'chromium') {
|
||||||
|
browser.action.onClicked.addListener(browserActionClicked);
|
||||||
|
} else {
|
||||||
|
browser.browserAction.onClicked.addListener(browserActionClicked);
|
||||||
|
}
|
||||||
|
|
||||||
browser.runtime.onInstalled.addListener(async () => {
|
browser.runtime.onInstalled.addListener(async () => {
|
||||||
if (import.meta.env.DEV) {
|
if (import.meta.env.DEV) {
|
||||||
await browser.runtime.openOptionsPage();
|
await browser.runtime.openOptionsPage();
|
||||||
}
|
}
|
||||||
|
|
||||||
|
const {dataVersion} = await browser.storage.sync.get({
|
||||||
|
dataVersion: '0',
|
||||||
|
});
|
||||||
|
|
||||||
|
if (dataVersion === '0') {
|
||||||
|
const local = await browser.storage.local.get();
|
||||||
|
local.dataVersion = '1';
|
||||||
|
await browser.storage.sync.set(local);
|
||||||
|
}
|
||||||
});
|
});
|
||||||
|
|
||||||
browser.webNavigation.onBeforeNavigate.addListener(async (details) => {
|
browser.webNavigation.onBeforeNavigate.addListener(async (details) => {
|
||||||
const detailsUrl = new URL(details.url);
|
const detailsUrl = new URL(details.url);
|
||||||
if (detailsUrl.host !== 'duckduckgo.com') {
|
const supportedHosts = ['duckduckgo.com', 'google.com', 'www.google.com'];
|
||||||
|
if (!supportedHosts.includes(detailsUrl.host)) {
|
||||||
return;
|
return;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
@ -28,7 +45,7 @@ browser.webNavigation.onBeforeNavigate.addListener(async (details) => {
|
||||||
return;
|
return;
|
||||||
}
|
}
|
||||||
|
|
||||||
const data = await browser.storage.local.get(id);
|
const data = await browser.storage.sync.get(id);
|
||||||
if (data[id] === undefined) {
|
if (data[id] === undefined) {
|
||||||
return;
|
return;
|
||||||
}
|
}
|
||||||
|
|
|
@ -59,10 +59,7 @@ export default class Bang {
|
||||||
return true;
|
return true;
|
||||||
}
|
}
|
||||||
|
|
||||||
public destination: string;
|
constructor(public destination: string, public parameters: BangParameters) {
|
||||||
public parameters: BangParameters;
|
|
||||||
|
|
||||||
constructor(destination: string, parameters: BangParameters) {
|
|
||||||
this.destination = destination;
|
this.destination = destination;
|
||||||
this.parameters = parameters;
|
this.parameters = parameters;
|
||||||
}
|
}
|
||||||
|
|
|
@ -1,33 +0,0 @@
|
||||||
{
|
|
||||||
"$schema": "http://json.schemastore.org/webextension",
|
|
||||||
"manifest_version": 2,
|
|
||||||
"name": "Fangs",
|
|
||||||
"description": "Inject custom DuckDuckGo Bangs into your browsing experience.",
|
|
||||||
"version": "0.1.0",
|
|
||||||
"permissions": [
|
|
||||||
"storage",
|
|
||||||
"tabs",
|
|
||||||
"webNavigation"
|
|
||||||
],
|
|
||||||
"content_security_policy": "script-src 'self'; object-src 'self'; style-src 'unsafe-inline'",
|
|
||||||
"web_accessible_resources": [
|
|
||||||
"assets/**"
|
|
||||||
],
|
|
||||||
"icons": {
|
|
||||||
"128": "assets/fangs-128.png"
|
|
||||||
},
|
|
||||||
"browser_action": {
|
|
||||||
"default_icon": {
|
|
||||||
"128": "assets/fangs-128.png"
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"options_ui": {
|
|
||||||
"page": "options/index.html",
|
|
||||||
"open_in_tab": true
|
|
||||||
},
|
|
||||||
"background": {
|
|
||||||
"scripts": [
|
|
||||||
"background-scripts/initialize.ts"
|
|
||||||
]
|
|
||||||
}
|
|
||||||
}
|
|
|
@ -0,0 +1,51 @@
|
||||||
|
/* eslint-disable @typescript-eslint/naming-convention */
|
||||||
|
|
||||||
|
export default function createManifest(
|
||||||
|
target: string,
|
||||||
|
): Record<string, unknown> {
|
||||||
|
const manifest: Record<string, unknown> = {
|
||||||
|
name: 'Fangs',
|
||||||
|
description:
|
||||||
|
'Inject custom DuckDuckGo Bangs into your browsing experience.',
|
||||||
|
version: '0.3.1',
|
||||||
|
permissions: ['storage', 'webNavigation'],
|
||||||
|
options_ui: {
|
||||||
|
page: 'options/index.html',
|
||||||
|
open_in_tab: true,
|
||||||
|
},
|
||||||
|
};
|
||||||
|
|
||||||
|
const icons = {
|
||||||
|
128: 'assets/fangs-128.png',
|
||||||
|
};
|
||||||
|
|
||||||
|
manifest.icons = icons;
|
||||||
|
|
||||||
|
const browserAction = {
|
||||||
|
default_icon: icons,
|
||||||
|
};
|
||||||
|
|
||||||
|
const backgroundScript = 'background-scripts/initialize.ts';
|
||||||
|
|
||||||
|
if (target === 'chromium') {
|
||||||
|
manifest.manifest_version = 3;
|
||||||
|
manifest.action = browserAction;
|
||||||
|
manifest.background = {
|
||||||
|
service_worker: backgroundScript,
|
||||||
|
type: 'module',
|
||||||
|
};
|
||||||
|
} else {
|
||||||
|
manifest.manifest_version = 2;
|
||||||
|
manifest.browser_action = browserAction;
|
||||||
|
manifest.background = {
|
||||||
|
scripts: [backgroundScript],
|
||||||
|
};
|
||||||
|
manifest.applications = {
|
||||||
|
gecko: {
|
||||||
|
id: '{cbb8b06b-9d6f-42f2-9d8d-7581f411653c}',
|
||||||
|
},
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
return manifest;
|
||||||
|
}
|
|
@ -1,20 +0,0 @@
|
||||||
import {html} from 'htm/preact';
|
|
||||||
import {Component} from 'preact';
|
|
||||||
|
|
||||||
type Props = {
|
|
||||||
cssClass: string;
|
|
||||||
text: string;
|
|
||||||
url: string;
|
|
||||||
};
|
|
||||||
|
|
||||||
export class Link extends Component<Props> {
|
|
||||||
render() {
|
|
||||||
const {cssClass, text, url} = this.props;
|
|
||||||
|
|
||||||
return html`
|
|
||||||
<a class=${cssClass} href=${url} target="_blank" rel="noopener">
|
|
||||||
${text}
|
|
||||||
</a>
|
|
||||||
`;
|
|
||||||
}
|
|
||||||
}
|
|
|
@ -1,8 +1,7 @@
|
||||||
|
import {PrivacyLink} from '@holllo/preact-components';
|
||||||
import {html} from 'htm/preact';
|
import {html} from 'htm/preact';
|
||||||
import {Component} from 'preact';
|
import {Component} from 'preact';
|
||||||
import browser from 'webextension-polyfill';
|
import type browser from 'webextension-polyfill';
|
||||||
|
|
||||||
import {Link} from './link.js';
|
|
||||||
|
|
||||||
type Props = {
|
type Props = {
|
||||||
manifest: browser.Manifest.ManifestBase;
|
manifest: browser.Manifest.ManifestBase;
|
||||||
|
@ -13,15 +12,18 @@ export class PageFooter extends Component<Props> {
|
||||||
const {manifest} = this.props;
|
const {manifest} = this.props;
|
||||||
const version = manifest.version;
|
const version = manifest.version;
|
||||||
|
|
||||||
|
const donateAttributes = {
|
||||||
|
href: 'https://liberapay.com/Holllo',
|
||||||
|
};
|
||||||
const donateLink = html`
|
const donateLink = html`
|
||||||
<${Link} text="Donate" url="https://github.com/sponsors/Bauke" />
|
<${PrivacyLink} attributes="${donateAttributes}">Donate<//>
|
||||||
`;
|
`;
|
||||||
|
|
||||||
|
const versionLinkAttributes = {
|
||||||
|
href: `https://git.bauke.xyz/Holllo/fangs/releases/tag/${version}`,
|
||||||
|
};
|
||||||
const versionLink = html`
|
const versionLink = html`
|
||||||
<${Link}
|
<${PrivacyLink} attributes=${versionLinkAttributes}>v${version}<//>
|
||||||
text="v${version}"
|
|
||||||
url="https://github.com/Holllo/fangs/releases/tag/${version}"
|
|
||||||
/>
|
|
||||||
`;
|
`;
|
||||||
|
|
||||||
return html`
|
return html`
|
||||||
|
|
|
@ -1,8 +1,9 @@
|
||||||
|
import {ConfirmButton, FeedbackButton} from '@holllo/preact-components';
|
||||||
import {html} from 'htm/preact';
|
import {html} from 'htm/preact';
|
||||||
import {Component} from 'preact';
|
import {Component} from 'preact';
|
||||||
import browser from 'webextension-polyfill';
|
import browser from 'webextension-polyfill';
|
||||||
|
|
||||||
import Bang, {BangParameters} from '../../bang/bang.js';
|
import Bang, {type BangParameters} from '../../bang/bang.js';
|
||||||
|
|
||||||
type Props = Record<string, unknown>;
|
type Props = Record<string, unknown>;
|
||||||
|
|
||||||
|
@ -33,11 +34,12 @@ export class PageMain extends Component<Props, State> {
|
||||||
}
|
}
|
||||||
|
|
||||||
async componentDidMount() {
|
async componentDidMount() {
|
||||||
const localStorage = await browser.storage.local.get();
|
const storage = await browser.storage.sync.get();
|
||||||
|
|
||||||
const bangs = Object.entries(localStorage)
|
const bangs = Object.entries(storage)
|
||||||
.filter(([key, _bang]) => key.startsWith('!'))
|
.filter(([key, _bang]) => key.startsWith('!'))
|
||||||
.map(([_key, bang]) => bang as BangParameters);
|
.map(([_key, bang]) => bang as BangParameters)
|
||||||
|
.sort((a, b) => a.id.localeCompare(b.id));
|
||||||
|
|
||||||
this.setState({bangs: this.state.bangs.concat(bangs)});
|
this.setState({bangs: this.state.bangs.concat(bangs)});
|
||||||
}
|
}
|
||||||
|
@ -65,7 +67,7 @@ export class PageMain extends Component<Props, State> {
|
||||||
return;
|
return;
|
||||||
}
|
}
|
||||||
|
|
||||||
await browser.storage.local.remove(id);
|
await browser.storage.sync.remove(id);
|
||||||
|
|
||||||
const bangs = this.state.bangs;
|
const bangs = this.state.bangs;
|
||||||
const existingIndex = bangs.findIndex((bang) => bang.id === id);
|
const existingIndex = bangs.findIndex((bang) => bang.id === id);
|
||||||
|
@ -86,7 +88,7 @@ export class PageMain extends Component<Props, State> {
|
||||||
if (Bang.validate(bang)) {
|
if (Bang.validate(bang)) {
|
||||||
const update: Record<string, BangParameters> = {};
|
const update: Record<string, BangParameters> = {};
|
||||||
update[bang.id] = bang;
|
update[bang.id] = bang;
|
||||||
await browser.storage.local.set(update);
|
await browser.storage.sync.set(update);
|
||||||
}
|
}
|
||||||
} catch (error: unknown) {
|
} catch (error: unknown) {
|
||||||
if (error instanceof Error) {
|
if (error instanceof Error) {
|
||||||
|
@ -97,7 +99,8 @@ export class PageMain extends Component<Props, State> {
|
||||||
throw error;
|
throw error;
|
||||||
}
|
}
|
||||||
|
|
||||||
return;
|
// Return false to make the FeedbackButton not show feedback.
|
||||||
|
return false;
|
||||||
}
|
}
|
||||||
|
|
||||||
const bangs = this.state.bangs;
|
const bangs = this.state.bangs;
|
||||||
|
@ -118,15 +121,27 @@ export class PageMain extends Component<Props, State> {
|
||||||
const {bangs, editorError} = this.state;
|
const {bangs, editorError} = this.state;
|
||||||
|
|
||||||
const availableBangs = bangs.map((bang) => {
|
const availableBangs = bangs.map((bang) => {
|
||||||
|
const active = bang.id === this.state.editorBang.id ? 'active' : '';
|
||||||
const onClick = () => {
|
const onClick = () => {
|
||||||
|
const allEqual = Object.entries(this.state.editorBang).every(
|
||||||
|
([key, value]) => bang[key as keyof BangParameters] === value,
|
||||||
|
);
|
||||||
|
if (allEqual) {
|
||||||
|
this.setState({
|
||||||
|
editorBang: {...this.emptyBang},
|
||||||
|
});
|
||||||
|
} else {
|
||||||
this.setState({
|
this.setState({
|
||||||
editorBang: {...bang},
|
editorBang: {...bang},
|
||||||
});
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
document.querySelector('.bang-editor')?.setAttribute('open', 'true');
|
||||||
};
|
};
|
||||||
|
|
||||||
return html`
|
return html`
|
||||||
<li>
|
<li>
|
||||||
<button onClick=${onClick}>
|
<button class="${active}" onClick=${onClick}>
|
||||||
${bang.name}<span class="bang-id">${bang.id}</span>
|
${bang.name}<span class="bang-id">${bang.id}</span>
|
||||||
</button>
|
</button>
|
||||||
</li>
|
</li>
|
||||||
|
@ -183,10 +198,21 @@ export class PageMain extends Component<Props, State> {
|
||||||
${editorInputs}
|
${editorInputs}
|
||||||
|
|
||||||
<div class="button-group">
|
<div class="button-group">
|
||||||
<button class="button" onClick=${this.saveBang}>Save</button>
|
<${FeedbackButton}
|
||||||
<button class="button destructive" onClick=${this.removeBang}>
|
attributes=${{class: 'button'}}
|
||||||
Remove
|
click=${this.saveBang}
|
||||||
</button>
|
feedbackText="Saved"
|
||||||
|
text="Save"
|
||||||
|
timeout=${5 * 1000}
|
||||||
|
/>
|
||||||
|
<${ConfirmButton}
|
||||||
|
class="button destructive"
|
||||||
|
click=${this.removeBang}
|
||||||
|
confirmClass="confirm"
|
||||||
|
confirmText="Confirm Removal"
|
||||||
|
text="Remove ${this.state.editorBang.id}"
|
||||||
|
timeout=${5 * 1000}
|
||||||
|
/>
|
||||||
</div>
|
</div>
|
||||||
${validateError}
|
${validateError}
|
||||||
</div>
|
</div>
|
||||||
|
@ -240,6 +266,15 @@ export class PageMain extends Component<Props, State> {
|
||||||
button.
|
button.
|
||||||
</li>
|
</li>
|
||||||
</ul>
|
</ul>
|
||||||
|
|
||||||
|
<p>Using Bangs:</p>
|
||||||
|
<ul>
|
||||||
|
<li>On the DuckDuckGo website, use your custom Bangs directly.</li>
|
||||||
|
<li>
|
||||||
|
With DuckDuckGo set as your browser's default search engine, use
|
||||||
|
your custom Bangs in the address bar.
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
</details>
|
</details>
|
||||||
</main>
|
</main>
|
||||||
`;
|
`;
|
||||||
|
|
|
@ -7,8 +7,6 @@ import {PageHeader} from './components/page-header.js';
|
||||||
import {PageMain} from './components/page-main.js';
|
import {PageMain} from './components/page-main.js';
|
||||||
|
|
||||||
window.addEventListener('DOMContentLoaded', () => {
|
window.addEventListener('DOMContentLoaded', () => {
|
||||||
console.debug('Options page opened!');
|
|
||||||
|
|
||||||
const manifest = browser.runtime.getManifest();
|
const manifest = browser.runtime.getManifest();
|
||||||
|
|
||||||
render(html`<${OptionsPage} manifest=${manifest} />`, document.body);
|
render(html`<${OptionsPage} manifest=${manifest} />`, document.body);
|
||||||
|
|
|
@ -3,7 +3,7 @@
|
||||||
.page-header {
|
.page-header {
|
||||||
@include mixins.responsive-container;
|
@include mixins.responsive-container;
|
||||||
|
|
||||||
border: 1px solid var(--df-1);
|
border: 1px solid var(--df-2);
|
||||||
margin-bottom: 16px;
|
margin-bottom: 16px;
|
||||||
|
|
||||||
h1 {
|
h1 {
|
||||||
|
@ -12,7 +12,7 @@
|
||||||
}
|
}
|
||||||
|
|
||||||
img {
|
img {
|
||||||
background-color: var(--df-1);
|
background-color: var(--df-2);
|
||||||
display: inline-block;
|
display: inline-block;
|
||||||
height: 4.5rem;
|
height: 4.5rem;
|
||||||
margin-right: 1rem;
|
margin-right: 1rem;
|
||||||
|
|
|
@ -16,7 +16,7 @@
|
||||||
|
|
||||||
.input-group {
|
.input-group {
|
||||||
background-color: var(--db-2);
|
background-color: var(--db-2);
|
||||||
border: 1px solid var(--df-1);
|
border: 1px solid var(--df-2);
|
||||||
padding: 8px;
|
padding: 8px;
|
||||||
|
|
||||||
label,
|
label,
|
||||||
|
@ -123,6 +123,11 @@
|
||||||
padding: 16px;
|
padding: 16px;
|
||||||
width: 100%;
|
width: 100%;
|
||||||
|
|
||||||
|
&.active {
|
||||||
|
border-color: var(--da-3);
|
||||||
|
color: var(--da-3);
|
||||||
|
}
|
||||||
|
|
||||||
&:hover {
|
&:hover {
|
||||||
background-color: var(--da-3);
|
background-color: var(--da-3);
|
||||||
border-color: var(--da-3);
|
border-color: var(--da-3);
|
||||||
|
|
|
@ -1,4 +1,4 @@
|
||||||
import {html} from 'htm/preact';
|
import type {html} from 'htm/preact';
|
||||||
|
|
||||||
declare global {
|
declare global {
|
||||||
// See Vite documentation for `import.meta.env` usage.
|
// See Vite documentation for `import.meta.env` usage.
|
||||||
|
@ -13,6 +13,7 @@ declare global {
|
||||||
readonly DEV: boolean;
|
readonly DEV: boolean;
|
||||||
readonly MODE: string;
|
readonly MODE: string;
|
||||||
readonly PROD: boolean;
|
readonly PROD: boolean;
|
||||||
|
readonly VITE_BROWSER: 'chromium' | 'firefox';
|
||||||
}
|
}
|
||||||
|
|
||||||
type HtmComponent = ReturnType<typeof html>;
|
type HtmComponent = ReturnType<typeof html>;
|
||||||
|
|
|
@ -1,6 +1,8 @@
|
||||||
|
/// <reference path="../source/types.d.ts" />
|
||||||
|
|
||||||
import test from 'ava';
|
import test from 'ava';
|
||||||
|
|
||||||
import Bang, {BangParameters} from '../source/bang/bang';
|
import Bang, {type BangParameters} from '../source/bang/bang';
|
||||||
|
|
||||||
test('Bang.parseId', (t) => {
|
test('Bang.parseId', (t) => {
|
||||||
const samples: Array<[string, string | undefined]> = [
|
const samples: Array<[string, string | undefined]> = [
|
||||||
|
|
|
@ -1,5 +1,6 @@
|
||||||
import fs from 'node:fs';
|
import fs from 'node:fs';
|
||||||
import path from 'node:path';
|
import path from 'node:path';
|
||||||
|
import process from 'node:process';
|
||||||
import url from 'node:url';
|
import url from 'node:url';
|
||||||
|
|
||||||
import {defineConfig} from 'vite';
|
import {defineConfig} from 'vite';
|
||||||
|
@ -8,17 +9,37 @@ import {defineConfig} from 'vite';
|
||||||
import preactPreset from '@preact/preset-vite';
|
import preactPreset from '@preact/preset-vite';
|
||||||
import webExtension from 'vite-plugin-web-extension';
|
import webExtension from 'vite-plugin-web-extension';
|
||||||
|
|
||||||
const currentDir = path.dirname(url.fileURLToPath(import.meta.url));
|
import createManifest from './source/manifest.js';
|
||||||
|
|
||||||
const buildDir = path.join(currentDir, 'build');
|
const targetBrowser = process.env.VITE_BROWSER ?? 'firefox';
|
||||||
|
process.env.VITE_BROWSER = targetBrowser;
|
||||||
|
|
||||||
|
const currentDir = path.dirname(url.fileURLToPath(import.meta.url));
|
||||||
|
const buildDir = path.join(currentDir, 'build', targetBrowser);
|
||||||
const sourceDir = path.join(currentDir, 'source');
|
const sourceDir = path.join(currentDir, 'source');
|
||||||
|
|
||||||
// Create the Firefox profile if it doesn't already exist.
|
// Create the browser profile if it doesn't already exist.
|
||||||
fs.mkdirSync(path.join(currentDir, 'firefox'), {recursive: true});
|
fs.mkdirSync(path.join(currentDir, targetBrowser), {recursive: true});
|
||||||
|
|
||||||
|
const webExtConfig: Record<string, unknown> = {
|
||||||
|
browserConsole: true,
|
||||||
|
chromiumProfile: 'chromium/',
|
||||||
|
firefoxProfile: 'firefox/',
|
||||||
|
keepProfileChanges: true,
|
||||||
|
};
|
||||||
|
|
||||||
|
if (targetBrowser === 'chromium') {
|
||||||
|
webExtConfig.startUrl = 'chrome://extensions/';
|
||||||
|
webExtConfig.target = 'chromium';
|
||||||
|
} else {
|
||||||
|
webExtConfig.startUrl = 'about:debugging#/runtime/this-firefox';
|
||||||
|
webExtConfig.target = 'firefox-desktop';
|
||||||
|
}
|
||||||
|
|
||||||
export default defineConfig({
|
export default defineConfig({
|
||||||
build: {
|
build: {
|
||||||
outDir: buildDir,
|
outDir: buildDir,
|
||||||
|
minify: false,
|
||||||
sourcemap: 'inline',
|
sourcemap: 'inline',
|
||||||
},
|
},
|
||||||
plugins: [
|
plugins: [
|
||||||
|
@ -27,15 +48,9 @@ export default defineConfig({
|
||||||
// https://github.com/aklinker1/vite-plugin-web-extension
|
// https://github.com/aklinker1/vite-plugin-web-extension
|
||||||
webExtension({
|
webExtension({
|
||||||
assets: 'assets',
|
assets: 'assets',
|
||||||
browser: 'firefox',
|
browser: targetBrowser,
|
||||||
manifest: path.join(sourceDir, 'manifest.json'),
|
manifest: () => createManifest(targetBrowser),
|
||||||
webExtConfig: {
|
webExtConfig,
|
||||||
browserConsole: true,
|
|
||||||
firefoxProfile: 'firefox/',
|
|
||||||
keepProfileChanges: true,
|
|
||||||
startUrl: 'about:debugging#/runtime/this-firefox',
|
|
||||||
target: 'firefox-desktop',
|
|
||||||
},
|
|
||||||
}),
|
}),
|
||||||
],
|
],
|
||||||
root: sourceDir,
|
root: sourceDir,
|
||||||
|
|