extension 2.0.0-rc.25 → 2.0.0-rc.27

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -10,31 +10,25 @@
10
10
  [prs-url]: https://github.com/extension-js/extension/blob/main/CONTRIBUTING.md
11
11
  [snyk-image]: https://snyk.io/test/github/extension-js/extension/badge.svg
12
12
  [snyk-url]: https://snyk.io/test/github/extension-js/extension
13
- [fossa-image]: https://app.fossa.com/api/projects/git%2Bgithub.com%2Fcezaraugusto%2Fextension.svg?type=shield&issueType=license
14
- [fossa-url]: https://app.fossa.com/projects/git%2Bgithub.com%2Fcezaraugusto%2Fextension?ref=badge_shield&issueType=license
13
+ [npm-version-image]: https://img.shields.io/npm/v/extension.svg?color=0971fe
14
+ [npm-version-url]: https://www.npmjs.com/package/extension
15
15
  [discord-image]: https://img.shields.io/discord/1253608412890271755?label=Discord&logo=discord&style=flat
16
16
  [discord-url]: https://discord.gg/v9h2RgeTSN
17
17
 
18
- # Extension.js [![fossa][fossa-image]][fossa-url] [![Known Vulnerabilities][snyk-image]][snyk-url] [![workflow][action-image]][action-url] [![discord][discord-image]][discord-url]
18
+ # Extension.js [![Version][npm-version-image]][npm-version-url] [![Downloads][downloads-image]][downloads-url] [![workflow][action-image]][action-url] [![discord][discord-image]][discord-url]
19
19
 
20
- <!-- > Plug-and-play, zero-config, cross-browser extension development tool. -->
20
+ > The cross-browser extension framework.
21
21
 
22
- <!-- > Make it very easy to develop cross-browser extensions. -->
22
+ <hr />
23
23
 
24
- <!-- <img alt="Extension.js with all the browser runners open" src="https://github.com/cezaraugusto/extension.js/assets/4672033/f0f5bbfc-e873-4856-9fdd-db2b42d9ab96">
25
- <hr> -->
26
-
27
- <img alt="Logo" align="right" src="https://user-images.githubusercontent.com/4672033/102850460-4d22aa80-43f8-11eb-82db-9efce586f73e.png" width="25%" />
28
-
29
- <!-- **Create cross-browser extensions with no build configuration.** -->
30
-
31
- > Plug-and-play, zero-config, cross-browser extension development tool.
24
+ <img alt="Logo" align="right" src="https://user-images.githubusercontent.com/4672033/102850460-4d22aa80-43f8-11eb-82db-9efce586f73e.png" width="22.5%" />
32
25
 
33
26
  - [Create A New Extension](#create-a-new-extension) — How to create a new extension.
34
27
  - [Get Started Immediately](#get-started-immediately) — Get work done in no time.
35
- - [I have An Extension](#i-have-an-extension) - Use only specific parts of Extension.js.
28
+ - [Start From A Template](https://extension.land/templates) Start with your favorite tool.
29
+ - [I have An Extension](#i-have-an-extension) — Use only specific parts of Extension.js.
36
30
 
37
- Extension.js is a plug-and-play, zero-config, cross-browser extension development tool with built-in support for TypeScript, WebAssembly, and modern JavaScript.
31
+ Extension.js makes it very easy to develop cross-browser extensions.<br />Developers use it due to its fast builds, simple interface, and zero-configuration setup.
38
32
 
39
33
  ## Create A New Extension
40
34
 
@@ -44,19 +38,15 @@ cd my-extension
44
38
  npm run dev
45
39
  ```
46
40
 
47
- A new browser instance will open up with your extension ready for development.
48
-
49
- You are done. Time to hack on your extension!
50
-
51
41
  https://github.com/cezaraugusto/extension/assets/4672033/7263d368-99c4-434f-a60a-72c489672586
52
42
 
53
- ## Web Standards and Modern JavaScript Support
43
+ ## Web Standards and Framework Support
54
44
 
55
- For a preview of extensions running these technologies, see documentation about [Templates](https://extension.js.org/docs/getting-started/templates).
45
+ For a preview of extensions running these technologies, see the [templates](https://extension.land/templates) website.
56
46
 
57
47
  | <img src="https://github.com/cezaraugusto/extension.js/assets/4672033/a9e2541a-96f0-4caa-9fc9-5fc5c3e901c8" width="70"> | <img src="https://github.com/cezaraugusto/extension.js/assets/4672033/b42c5330-9e2a-4045-99c3-1f7d264dfaf4" width="70"> | <img src="https://github.com/cezaraugusto/extension.js/assets/4672033/f19edff3-9005-4f50-b05c-fba615896a7f" width="70"> | <img src="https://github.com/cezaraugusto/extension.js/assets/4672033/ff64721d-d145-4213-930d-e70193f8d57e" width="70"> | <img src="https://github.com/cezaraugusto/extension.js/assets/4672033/15f1314a-aa65-4ce2-a3f3-cf53c4f730cf" width="70"> | <img src="https://github.com/cezaraugusto/extension.js/assets/4672033/c5f8a127-3c2a-4ceb-bb46-948cf2c8bd89" width="70"> | <img src="https://github.com/cezaraugusto/extension.js/assets/4672033/de1082fd-7cf6-4202-8c12-a5c3cd3e5b42" width="70"> | <img src="https://github.com/cezaraugusto/extension.js/assets/4672033/78e5fe3d-dc79-4aa2-954e-1a5973d1d9db" width="70"> | <img src="https://github.com/cezaraugusto/extension.js/assets/4672033/8807efd9-93e5-4db5-a1d2-9ac524f7ecc2" width="70"> |
58
48
  | :---------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------: |
59
- | ESNext<br>✅ | TypeScript<br>✅ | WASM<br>✅ | React<br>✅ | Vue<br>✅ | Angular<br>👋 | Svelte<br>✅ | Solid<br>👋 | Preact<br>✅ |
49
+ | ESNext<br>latest | TypeScript<br>latest | WASM<br>latest | React<br>18+ | Vue<br>3+ | Angular<br>👋 | Svelte<br>5+ | Solid<br>👋 | Preact<br>10+ |
60
50
 
61
51
  👋 = PR Welcome!
62
52
 
@@ -74,9 +64,10 @@ https://github.com/cezaraugusto/extension/assets/4672033/ee221a94-6ec7-4e04-8553
74
64
 
75
65
  </details>
76
66
 
67
+ <!--
77
68
  <details>
78
- <summary>
79
- 🔥 Use Edge to start developing an extension from Chrome Extension Samples
69
+ <summary>
70
+ 🔥 Use Edge to start developing an extension from Chrome Extension Samples
80
71
  </summary>
81
72
 
82
73
  > See the example below where we request the sample [magic8ball](https://github.com/GoogleChrome/chrome-extensions-samples/tree/main/api-samples/topSites/magic8ball) from from [Google Chrome Extension Samples](https://github.com/GoogleChrome/chrome-extensions-samples) with Edge as the runtime browser.
@@ -118,12 +109,13 @@ npx extension dev https://github.com/mdn/webextensions-examples/tree/main/firefo
118
109
  https://github.com/cezaraugusto/extension.js/assets/4672033/ac94b608-c936-40df-bce7-63ffd7fe31c5
119
110
 
120
111
  </details>
112
+ -->
121
113
 
122
114
  ## I have An Extension
123
115
 
124
116
  https://github.com/cezaraugusto/extension/assets/4672033/48694a23-b7f1-4098-9c5d-eff49983739c
125
117
 
126
- If you have an existing extension which is using a package manager, you can install the Extension.js package and manually create the scripts used to run your extension. See the demo above or follow these instructions to get it done:
118
+ If you have an existing extension which is using a package manager, you can install the Extension.js package and manually create the scripts used to run your extension.
127
119
 
128
120
  **Step 1 - Install extension as a `devDependency`**
129
121
 
@@ -138,7 +130,7 @@ npm install extension --save-dev
138
130
  "scripts": {
139
131
  "build": "extension build",
140
132
  "dev": "extension dev",
141
- "start": "extension start"
133
+ "preview": "extension preview"
142
134
  },
143
135
  "devDependencies": {
144
136
  // ...other dependencies
@@ -150,18 +142,18 @@ npm install extension --save-dev
150
142
  Done. You are all set!
151
143
 
152
144
  - To develop the extension, run `npm run dev`.
153
- - To visualize the extension in production mode, run `npm run start`.
154
145
  - To build the extension in production mode, run `npm run build`.
146
+ - To visualize the extension in production mode, run `npm run build` and `npm run preview`.
155
147
 
156
148
  ## Using a specific browser for development
157
149
 
158
150
  ### Desktop Browsers
159
151
 
160
- | <img src="https://github.com/cezaraugusto/extension.js/assets/4672033/6ce53a31-c6f6-4a1c-b927-e9ec7fd2df78" width="70"> | <img src="https://raw.githubusercontent.com/alrra/browser-logos/main/src/brave/brave.svg" width="70"> | <img src="https://raw.githubusercontent.com/alrra/browser-logos/main/src/chrome/chrome.svg" width="70"> | <img src="https://raw.githubusercontent.com/alrra/browser-logos/main/src/chromium/chromium.svg" width="70"> | <img src="https://raw.githubusercontent.com/alrra/browser-logos/main/src/edge/edge.svg" width="70"> | <img src="https://raw.githubusercontent.com/alrra/browser-logos/main/src/firefox/firefox.svg" width="70"> | <img src="https://raw.githubusercontent.com/alrra/browser-logos/main/src/opera/opera.svg" width="70"> | <img width="70" src="https://raw.githubusercontent.com/alrra/browser-logos/main/src/safari/safari.svg"> | <img src="https://raw.githubusercontent.com/alrra/browser-logos/main/src/vivaldi/vivaldi.svg" width="70"> |
161
- | :---------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------: | :-----------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------: | :-----------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------: |
162
- | Arc<br>☑️ | Brave<br>☑️ | Chrome<br>✅ | Chromium<br>☑️ | Edge<br>✅ | Firefox<br>✅ | Opera<br>☑️ | Safari<br>⛔️ | Vivaldi<br>☑️ |
152
+ | <img src="https://raw.githubusercontent.com/alrra/browser-logos/main/src/chrome/chrome.svg" width="70"> | <img src="https://raw.githubusercontent.com/alrra/browser-logos/main/src/chromium/chromium.svg" width="70"> | <img src="https://raw.githubusercontent.com/alrra/browser-logos/main/src/edge/edge.svg" width="70"> | <img src="https://raw.githubusercontent.com/alrra/browser-logos/main/src/firefox/firefox.svg" width="70"> | <img src="https://raw.githubusercontent.com/alrra/browser-logos/main/src/opera/opera.svg" width="70"> | <img src="https://raw.githubusercontent.com/alrra/browser-logos/main/src/safari/safari.svg" width="70"> |
153
+ | :-----------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------: | :-----------------------------------------------------------------------------------------------------: |
154
+ | Chrome<br>✅ | Chromium<br>☑️ | Edge<br>✅ | Firefox<br>✅ | Opera<br>☑️ | Safari<br>⛔️ |
163
155
 
164
- ☑️ = It is theoretically possible to load all Chromium forks given the current support for Chrome. There is a request ticket for [supporting all Chromium-based browsers](https://github.com/cezaraugusto/extension.js/issues/59). Most requested features are added first, so thumbs up it to speed-up the development process.
156
+ The browsers listed above represent those with official extension stores. Note that Chromium-based browsers (like Arc, Brave, Vivaldi, and many others) are theoretically supported through the Chrome/Chromium compatibility layer.
165
157
 
166
158
  ### Mobile Browsers
167
159
 
@@ -169,17 +161,6 @@ Done. You are all set!
169
161
  | :-------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------: |
170
162
  | Firefox (Android)<br>⛔️ | Safari (iOS)<br>⛔️ |
171
163
 
172
- If you want to target a specific browser, just pass the `--browser` flag to the `dev`/`start` command (based on the list available above), like `npx extension dev path/to/extension --browser=edge`.
173
-
174
- > Hint
175
- > Pass --browser="all" to load all available browsers at once.
176
-
177
- ```sh
178
- extension dev --browser=all
179
- ```
180
-
181
- <img alt="Extension.js with all the browser runners open" src="https://github.com/cezaraugusto/extension.js/assets/4672033/f0f5bbfc-e873-4856-9fdd-db2b42d9ab96">
182
-
183
164
  ## License
184
165
 
185
- MIT (c) Cezar Augusto.
166
+ MIT (c) Cezar Augusto and the Extension.js authors.
package/dist/cli.d.ts CHANGED
@@ -1,2 +1,3 @@
1
1
  #!/usr/bin/env node
2
- export { FileConfig, Manifest } from 'extension-develop';
2
+ import { type FileConfig, type Manifest } from 'extension-develop';
3
+ export { type FileConfig, type Manifest };
package/dist/cli.js CHANGED
@@ -1,339 +1,147 @@
1
1
  #!/usr/bin/env node
2
2
  "use strict";
3
- var __create = Object.create;
4
- var __defProp = Object.defineProperty;
5
- var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
6
- var __getOwnPropNames = Object.getOwnPropertyNames;
7
- var __getProtoOf = Object.getPrototypeOf;
8
- var __hasOwnProp = Object.prototype.hasOwnProperty;
9
- var __copyProps = (to, from, except, desc) => {
10
- if (from && typeof from === "object" || typeof from === "function") {
11
- for (let key of __getOwnPropNames(from))
12
- if (!__hasOwnProp.call(to, key) && key !== except)
13
- __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
14
- }
15
- return to;
16
- };
17
- var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
18
- // If the importer is in node compatibility mode or this is not an ESM
19
- // file that has been converted to a CommonJS file using a Babel-
20
- // compatible transform (i.e. "__esModule" has not been set), then set
21
- // "default" to the CommonJS "module.exports" for node compatibility.
22
- isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
23
- mod
24
- ));
25
- var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
26
-
27
- // cli.ts
28
- var cli_exports = {};
29
- module.exports = __toCommonJS(cli_exports);
30
- var import_commander = require("commander");
31
- var import_extension_create = require("extension-create");
32
- var import_extension_develop = require("extension-develop");
33
-
34
- // cli-lib/messages.ts
35
- var import_safe = require("@colors/colors/safe");
3
+ var __webpack_require__ = {};
4
+ (()=>{
5
+ __webpack_require__.n = (module)=>{
6
+ var getter = module && module.__esModule ? ()=>module['default'] : ()=>module;
7
+ __webpack_require__.d(getter, {
8
+ a: getter
9
+ });
10
+ return getter;
11
+ };
12
+ })();
13
+ (()=>{
14
+ __webpack_require__.d = (exports1, definition)=>{
15
+ for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
16
+ enumerable: true,
17
+ get: definition[key]
18
+ });
19
+ };
20
+ })();
21
+ (()=>{
22
+ __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
23
+ })();
24
+ var __webpack_exports__ = {};
25
+ const external_commander_namespaceObject = require("commander");
26
+ const external_extension_create_namespaceObject = require("extension-create");
27
+ const external_extension_develop_namespaceObject = require("extension-develop");
28
+ const external_chalk_namespaceObject = require("chalk");
29
+ var external_chalk_default = /*#__PURE__*/ __webpack_require__.n(external_chalk_namespaceObject);
36
30
  function updateFailed(err) {
37
- return "\u{1F9E9}\n" + (0, import_safe.red)(`Failed to check for updates: ${err.message}`);
31
+ return "\uD83E\uDDE9\n" + external_chalk_default().red(`Failed to check for updates: ${err.message}`);
38
32
  }
39
33
  function checkUpdates(packageJson, update) {
40
- return `\u{1F9E9}
41
- ${(0, import_safe.brightYellow)("Notice:")} A new version of ${(0, import_safe.brightGreen)(
42
- "Extension.js"
43
- )} is available!
44
- You are currently using version ${(0, import_safe.brightYellow)(packageJson.version)}.
45
- The latest stable version is ${(0, import_safe.brightYellow)(update.latest)}.
46
- Please update to the latest version to enjoy new features and improvements.
47
- `;
34
+ return `\u{1F9E9}\n${external_chalk_default().yellow('Notice:')} A new version of ${external_chalk_default().green('Extension.js')} is available!\nYou are currently using version ${external_chalk_default().yellow(packageJson.version)}.\nThe latest stable version is ${external_chalk_default().yellow(update.latest)}.\nPlease update to the latest version to enjoy new features and improvements.\n`;
48
35
  }
49
36
  function programHelp() {
50
- return `\u{1F9E9}
51
- ${(0, import_safe.underline)("Help center for the Extension.js program")}
37
+ return `\u{1F9E9}
38
+ ${external_chalk_default().underline('Help center for the Extension.js program')}
52
39
 
53
- ${(0, import_safe.brightYellow)("Usage:")} extension [command] [options]
40
+ ${external_chalk_default().yellow('Usage:')} extension [command] [options]
54
41
 
55
- ${(0, import_safe.brightYellow)("Note:")} If you are looking for a specific list of options,
42
+ ${external_chalk_default().yellow('Note:')} If you are looking for a specific list of options,
56
43
  all high-level commands offer their own \`--help\` file with
57
44
  information about usage and a list of command flags available.
58
45
 
59
46
  For example:
60
47
 
61
- ${(0, import_safe.brightGreen)("extension create --help")}
48
+ ${external_chalk_default().green('extension create --help')}
62
49
  outputs information about the "create" command.
63
50
 
64
51
  Options available:
65
52
 
66
- ${(0, import_safe.brightGreen)("extension create <extension-name>")}
53
+ ${external_chalk_default().green('extension create <extension-name>')}
67
54
  Creates a new extension from a template. The "create" command
68
55
  is optional and can be omitted.
69
56
 
70
- ${(0, import_safe.brightGreen)("extension dev <extension-path>")}
57
+ ${external_chalk_default().green('extension dev <extension-path>')}
71
58
  Starts a new browser instance in development mode, with the target
72
59
  extension loaded and auto-reloaded based on file changes.
73
60
 
74
- ${(0, import_safe.brightGreen)("extension start <extension-path>")}
61
+ ${external_chalk_default().green('extension start <extension-path>')}
75
62
  Starts a new browser instance in production mode, with the target
76
63
  extension compiled based on the browser choice.
77
64
 
78
- ${(0, import_safe.brightGreen)("extension build <extension-path>")}
65
+ ${external_chalk_default().green('extension build <extension-path>')}
79
66
  Builds the target extension with browser defaults, ready for packaging.
80
67
 
81
- ${(0, import_safe.brightGreen)("extension --help")}
68
+ ${external_chalk_default().green('extension --help')}
82
69
  This command ;) Outputs a help file with key command options.
83
70
 
84
- ${(0, import_safe.brightYellow)("Feels something is wrong? Help by reporting a bug:")}
85
- ${(0, import_safe.underline)("https://github.com/cezaraugusto/extension/issues/new")}
71
+ ${external_chalk_default().yellow('Feels something is wrong? Help by reporting a bug:')}
72
+ ${external_chalk_default().underline('https://github.com/cezaraugusto/extension/issues/new')}
86
73
  `;
87
74
  }
88
-
89
- // check-updates.ts
90
- var import_update_check = __toESM(require("update-check"));
75
+ const external_update_check_namespaceObject = require("update-check");
76
+ var external_update_check_default = /*#__PURE__*/ __webpack_require__.n(external_update_check_namespaceObject);
91
77
  function isStableVersion(version) {
92
- return !/[a-zA-Z]/.test(version);
78
+ return !/[a-zA-Z]/.test(version);
93
79
  }
94
- async function checkUpdates2(packageJson) {
95
- let update = null;
96
- try {
97
- update = await (0, import_update_check.default)(packageJson);
98
- } catch (err) {
99
- if (process.env.EXTENSION_ENV === "development") {
100
- console.error(updateFailed(err));
80
+ async function check_updates_checkUpdates(packageJson) {
81
+ let update = null;
82
+ try {
83
+ update = await external_update_check_default()(packageJson);
84
+ } catch (err) {
85
+ if ('development' === process.env.EXTENSION_ENV) console.error(updateFailed(err));
101
86
  }
102
- }
103
- if (update && isStableVersion(update.latest)) {
104
- console.log(checkUpdates(packageJson, update));
105
- }
87
+ if (update && isStableVersion(update.latest)) console.log(checkUpdates(packageJson, update));
106
88
  }
107
-
108
- // package.json
109
- var package_default = {
110
- license: "MIT",
111
- repository: {
112
- type: "git",
113
- url: "https://github.com/cezaraugusto/extension.git",
114
- directory: "programs/cli"
115
- },
116
- engines: {
117
- node: ">=18"
118
- },
119
- name: "extension",
120
- version: "2.0.0-rc.25",
121
- description: "Create cross-browser extensions with no build configuration.",
122
- main: "./dist/cli.js",
123
- types: "./dist/cli.d.ts",
124
- files: [
125
- "dist",
126
- "README.md"
127
- ],
128
- bin: {
129
- extension: "./dist/cli.js"
130
- },
131
- author: {
132
- name: "Cezar Augusto",
133
- email: "boss@cezaraugusto.net",
134
- url: "https://cezaraugusto.com"
135
- },
136
- scripts: {
137
- watch: "pnpm compile --watch",
138
- "compile:types": "bash install_scripts.sh",
139
- "compile:readme-files": "node ./scripts/copyMarkdownFilesToCli.js",
140
- "compile:tailwind-config": "node ./scripts/copyTailwindConfig.js",
141
- "compile:stylelint-config": "node ./scripts/copyStylelintConfig.js",
142
- "compile:cli": "tsup-node ./cli.ts --format cjs --dts --target=node18",
143
- compile: "pnpm compile:readme-files && pnpm compile:tailwind-config && pnpm compile:stylelint-config && pnpm compile:cli && pnpm compile:types",
144
- clean: "rm -rf dist",
145
- test: 'echo "Note: no test specified" && exit 0',
146
- "test:cli": "jest __spec__/cli.spec.ts"
147
- },
148
- keywords: [
149
- "zero-config",
150
- "build",
151
- "develop",
152
- "browser",
153
- "extension",
154
- "chrome extension",
155
- "edge extension",
156
- "firefox extension",
157
- "safari extension",
158
- "web",
159
- "react",
160
- "typescript"
161
- ],
162
- dependencies: {
163
- "@colors/colors": "^1.6.0",
164
- "@types/chrome": "^0.0.287",
165
- "@types/firefox-webext-browser": "^120.0.4",
166
- "@types/node": "^22.10.1",
167
- "@types/react": "^19.0.1",
168
- "@types/react-dom": "^19.0.1",
169
- commander: "^12.1.0",
170
- "extension-create": "workspace:*",
171
- "extension-develop": "workspace:*",
172
- semver: "^7.6.3",
173
- "update-check": "^1.5.4",
174
- "webextension-polyfill": "^0.12.0"
175
- },
176
- devDependencies: {
177
- "@types/jest": "^29.5.14",
178
- "@types/mock-fs": "^4.13.4",
179
- "@types/semver": "^7.5.8",
180
- jest: "^29.7.0",
181
- "mock-fs": "^5.4.1",
182
- "ts-jest": "^29.3.1",
183
- tsconfig: "*",
184
- tsup: "^8.3.5",
185
- typescript: "5.7.2"
186
- }
187
- };
188
-
189
- // cli.ts
190
- checkUpdates2(package_default);
191
- var extensionJs = import_commander.program;
192
- var vendors = (browser) => browser === "all" ? "chrome,edge,firefox".split(",") : browser.split(",");
193
- extensionJs.name(package_default.name).description(package_default.description).version(package_default.version).addHelpText("after", programHelp());
194
- extensionJs.command("create").arguments("<project-name|project-path>").usage("create <project-name|project-path> [options]").description("Creates a new extension.").option(
195
- "-t, --template <template-name>",
196
- "specify a template for the created project"
197
- ).option(
198
- "--install",
199
- "whether or not to install the dependencies after creating the project"
200
- ).action(async function(pathOrRemoteUrl, { template, install }) {
201
- await (0, import_extension_create.extensionCreate)(pathOrRemoteUrl, {
202
- template,
203
- install,
204
- cliVersion: package_default.version
205
- });
89
+ var package_namespaceObject = JSON.parse('{"license":"MIT","repository":{"type":"git","url":"https://github.com/cezaraugusto/extension.git","directory":"programs/cli"},"engines":{"node":">=18"},"exports":{".":{"types":"./dist/cli.d.ts","import":"./dist/cli.js","require":"./dist/cli.js"}},"main":"./dist/cli.js","types":"./dist/cli.d.ts","files":["dist"],"bin":{"extension":"./dist/cli.js"},"name":"extension","version":"2.0.0-rc.27","description":"Create cross-browser extensions with no build configuration.","author":{"name":"Cezar Augusto","email":"boss@cezaraugusto.net","url":"https://cezaraugusto.com"},"scripts":{"watch":"rslib build --watch","compile:types":"bash install_scripts.sh","compile:readme-files":"node ./scripts/copyMarkdownFilesToCli.js","compile:cli":"rslib build","compile":"pnpm compile:readme-files && pnpm compile:cli && pnpm compile:types","clean":"rm -rf dist","test":"echo \\"Note: no test specified\\" && exit 0","test:cli":"vitest run"},"keywords":["zero-config","build","develop","browser","extension","chrome extension","edge extension","firefox extension","safari extension","web","react","typescript"],"dependencies":{"chalk":"^5.3.0","@types/chrome":"^0.0.287","@types/firefox-webext-browser":"^120.0.4","@types/node":"^22.10.1","@types/react":"^19.0.1","@types/react-dom":"^19.0.1","commander":"^12.1.0","extension-create":"workspace:*","extension-develop":"workspace:*","semver":"^7.6.3","update-check":"^1.5.4","webextension-polyfill":"^0.12.0"},"devDependencies":{"@rslib/core":"^0.6.9","@types/mock-fs":"^4.13.4","@types/semver":"^7.5.8","mock-fs":"^5.4.1","tsconfig":"*","typescript":"5.7.2"}}');
90
+ check_updates_checkUpdates(package_namespaceObject);
91
+ const extensionJs = external_commander_namespaceObject.program;
92
+ const vendors = (browser)=>'all' === browser ? 'chrome,edge,firefox'.split(',') : browser.split(',');
93
+ extensionJs.name(package_namespaceObject.name).description(package_namespaceObject.description).version(package_namespaceObject.version).addHelpText('after', programHelp());
94
+ extensionJs.command('create').arguments('<project-name|project-path>').usage('create <project-name|project-path> [options]').description('Creates a new extension.').option('-t, --template <template-name>', 'specify a template for the created project').option('--install', 'whether or not to install the dependencies after creating the project').action(async function(pathOrRemoteUrl, { template, install }) {
95
+ await (0, external_extension_create_namespaceObject.extensionCreate)(pathOrRemoteUrl, {
96
+ template,
97
+ install,
98
+ cliVersion: package_namespaceObject.version
99
+ });
206
100
  });
207
- extensionJs.command("dev").arguments("[project-path|remote-url]").usage("dev [project-path|remote-url] [options]").description("Starts the development server (development mode)").option(
208
- "--profile <path-to-file | boolean>",
209
- "what path to use for the browser profile. A boolean value of false sets the profile to the default user profile. Defaults to a fresh profile"
210
- ).option(
211
- "--browser <chrome | edge | firefox>",
212
- "specify a browser to preview your extension in production mode. Defaults to `chrome`"
213
- ).option(
214
- "--chromium-binary <path-to-binary>",
215
- "specify a path to the Chromium binary. This option overrides the --browser setting. Defaults to the system default"
216
- ).option(
217
- "--gecko-binary <path-to-binary>",
218
- "specify a path to the Gecko binary. This option overrides the --browser setting. Defaults to the system default"
219
- ).option(
220
- "--polyfill [boolean]",
221
- "whether or not to apply the cross-browser polyfill. Defaults to `false`"
222
- ).option(
223
- "--open [boolean]",
224
- "whether or not to open the browser automatically. Defaults to `true`"
225
- ).option(
226
- "--starting-url <url>",
227
- "specify the starting URL for the browser. Defaults to `undefined`"
228
- ).option(
229
- "--port <port>",
230
- "specify the port to use for the development server. Defaults to `8080`"
231
- ).action(async function(pathOrRemoteUrl, { browser = "chrome", ...devOptions }) {
232
- for (const vendor of vendors(browser)) {
233
- await (0, import_extension_develop.extensionDev)(pathOrRemoteUrl, {
234
- ...devOptions,
235
- profile: devOptions.profile,
236
- browser: vendor,
237
- chromiumBinary: devOptions.chromiumBinary,
238
- geckoBinary: devOptions.geckoBinary,
239
- // @ts-expect-error open is a boolean
240
- polyfill: devOptions.polyfill === "false" ? false : true,
241
- open: devOptions.open,
242
- startingUrl: devOptions.startingUrl
101
+ extensionJs.command('dev').arguments('[project-path|remote-url]').usage('dev [project-path|remote-url] [options]').description('Starts the development server (development mode)').option('--profile <path-to-file | boolean>', 'what path to use for the browser profile. A boolean value of false sets the profile to the default user profile. Defaults to a fresh profile').option('--browser <chrome | edge | firefox>', 'specify a browser to preview your extension in production mode. Defaults to `chrome`').option('--chromium-binary <path-to-binary>', 'specify a path to the Chromium binary. This option overrides the --browser setting. Defaults to the system default').option('--gecko-binary <path-to-binary>', 'specify a path to the Gecko binary. This option overrides the --browser setting. Defaults to the system default').option('--polyfill [boolean]', 'whether or not to apply the cross-browser polyfill. Defaults to `false`').option('--open [boolean]', 'whether or not to open the browser automatically. Defaults to `true`').option('--starting-url <url>', 'specify the starting URL for the browser. Defaults to `undefined`').option('--port <port>', 'specify the port to use for the development server. Defaults to `8080`').action(async function(pathOrRemoteUrl, { browser = 'chrome', ...devOptions }) {
102
+ for (const vendor of vendors(browser))await (0, external_extension_develop_namespaceObject.extensionDev)(pathOrRemoteUrl, {
103
+ ...devOptions,
104
+ profile: devOptions.profile,
105
+ browser: vendor,
106
+ chromiumBinary: devOptions.chromiumBinary,
107
+ geckoBinary: devOptions.geckoBinary,
108
+ polyfill: 'false' !== devOptions.polyfill,
109
+ open: devOptions.open,
110
+ startingUrl: devOptions.startingUrl
243
111
  });
244
- }
245
112
  });
246
- extensionJs.command("start").arguments("[project-path|remote-url]").usage("start [project-path|remote-url] [options]").description("Starts the development server (production mode)").option(
247
- "--profile <path-to-file | boolean>",
248
- "what path to use for the browser profile. A boolean value of false sets the profile to the default user profile. Defaults to a fresh profile"
249
- ).option(
250
- "--browser <chrome | edge | firefox>",
251
- "specify a browser to preview your extension in production mode. Defaults to `chrome`"
252
- ).option(
253
- "--polyfill [boolean]",
254
- "whether or not to apply the cross-browser polyfill. Defaults to `true`"
255
- ).option(
256
- "--chromium-binary <path-to-binary>",
257
- "specify a path to the Chromium binary. This option overrides the --browser setting. Defaults to the system default"
258
- ).option(
259
- "--gecko-binary <path-to-binary>",
260
- "specify a path to the Gecko binary. This option overrides the --browser setting. Defaults to the system default"
261
- ).option(
262
- "--starting-url <url>",
263
- "specify the starting URL for the browser. Defaults to `undefined`"
264
- ).option(
265
- "--port <port>",
266
- "specify the port to use for the development server. Defaults to `8080`"
267
- ).action(async function(pathOrRemoteUrl, { browser = "chrome", ...startOptions }) {
268
- for (const vendor of vendors(browser)) {
269
- await (0, import_extension_develop.extensionStart)(pathOrRemoteUrl, {
270
- mode: "production",
271
- profile: startOptions.profile,
272
- browser: vendor,
273
- chromiumBinary: startOptions.chromiumBinary,
274
- geckoBinary: startOptions.geckoBinary,
275
- startingUrl: startOptions.startingUrl
113
+ extensionJs.command('start').arguments('[project-path|remote-url]').usage('start [project-path|remote-url] [options]').description('Starts the development server (production mode)').option('--profile <path-to-file | boolean>', 'what path to use for the browser profile. A boolean value of false sets the profile to the default user profile. Defaults to a fresh profile').option('--browser <chrome | edge | firefox>', 'specify a browser to preview your extension in production mode. Defaults to `chrome`').option('--polyfill [boolean]', 'whether or not to apply the cross-browser polyfill. Defaults to `true`').option('--chromium-binary <path-to-binary>', 'specify a path to the Chromium binary. This option overrides the --browser setting. Defaults to the system default').option('--gecko-binary <path-to-binary>', 'specify a path to the Gecko binary. This option overrides the --browser setting. Defaults to the system default').option('--starting-url <url>', 'specify the starting URL for the browser. Defaults to `undefined`').option('--port <port>', 'specify the port to use for the development server. Defaults to `8080`').action(async function(pathOrRemoteUrl, { browser = 'chrome', ...startOptions }) {
114
+ for (const vendor of vendors(browser))await (0, external_extension_develop_namespaceObject.extensionStart)(pathOrRemoteUrl, {
115
+ mode: 'production',
116
+ profile: startOptions.profile,
117
+ browser: vendor,
118
+ chromiumBinary: startOptions.chromiumBinary,
119
+ geckoBinary: startOptions.geckoBinary,
120
+ startingUrl: startOptions.startingUrl
276
121
  });
277
- }
278
122
  });
279
- extensionJs.command("preview").arguments("[project-name]").usage("preview [path-to-remote-extension] [options]").description("Preview the extension in production mode").option(
280
- "--profile <path-to-file | boolean>",
281
- "what path to use for the browser profile. A boolean value of false sets the profile to the default user profile. Defaults to a fresh profile"
282
- ).option(
283
- "--browser <chrome | edge | firefox>",
284
- "specify a browser to preview your extension in production mode. Defaults to `chrome`"
285
- ).option(
286
- "--chromium-binary <path-to-binary>",
287
- "specify a path to the Chromium binary. This option overrides the --browser setting. Defaults to the system default"
288
- ).option(
289
- "--gecko-binary <path-to-binary>",
290
- "specify a path to the Gecko binary. This option overrides the --browser setting. Defaults to the system default"
291
- ).option(
292
- "--starting-url <url>",
293
- "specify the starting URL for the browser. Defaults to `undefined`"
294
- ).option(
295
- "--port <port>",
296
- "specify the port to use for the development server. Defaults to `8080`"
297
- ).action(async function(pathOrRemoteUrl, { browser = "chrome", ...previewOptions }) {
298
- for (const vendor of vendors(browser)) {
299
- await (0, import_extension_develop.extensionPreview)(pathOrRemoteUrl, {
300
- mode: "production",
301
- profile: previewOptions.profile,
302
- browser: vendor,
303
- chromiumBinary: previewOptions.chromiumBinary,
304
- geckoBinary: previewOptions.geckoBinary,
305
- startingUrl: previewOptions.startingUrl
123
+ extensionJs.command('preview').arguments('[project-name]').usage('preview [path-to-remote-extension] [options]').description('Preview the extension in production mode').option('--profile <path-to-file | boolean>', 'what path to use for the browser profile. A boolean value of false sets the profile to the default user profile. Defaults to a fresh profile').option('--browser <chrome | edge | firefox>', 'specify a browser to preview your extension in production mode. Defaults to `chrome`').option('--chromium-binary <path-to-binary>', 'specify a path to the Chromium binary. This option overrides the --browser setting. Defaults to the system default').option('--gecko-binary <path-to-binary>', 'specify a path to the Gecko binary. This option overrides the --browser setting. Defaults to the system default').option('--starting-url <url>', 'specify the starting URL for the browser. Defaults to `undefined`').option('--port <port>', 'specify the port to use for the development server. Defaults to `8080`').action(async function(pathOrRemoteUrl, { browser = 'chrome', ...previewOptions }) {
124
+ for (const vendor of vendors(browser))await (0, external_extension_develop_namespaceObject.extensionPreview)(pathOrRemoteUrl, {
125
+ mode: 'production',
126
+ profile: previewOptions.profile,
127
+ browser: vendor,
128
+ chromiumBinary: previewOptions.chromiumBinary,
129
+ geckoBinary: previewOptions.geckoBinary,
130
+ startingUrl: previewOptions.startingUrl
306
131
  });
307
- }
308
132
  });
309
- extensionJs.command("build").arguments("[project-name]").usage("build [path-to-remote-extension] [options]").description("Builds the extension for production").option(
310
- "--browser <chrome | edge | firefox>",
311
- "specify a browser to preview your extension in production mode. Defaults to `chrome`"
312
- ).option(
313
- "--polyfill [boolean]",
314
- "whether or not to apply the cross-browser polyfill. Defaults to `false`"
315
- ).option(
316
- "--zip [boolean]",
317
- "whether or not to compress the extension into a ZIP file. Defaults to `false`"
318
- ).option(
319
- "--zip-source [boolean]",
320
- "whether or not to include the source files in the ZIP file. Defaults to `false`"
321
- ).option(
322
- "--zip-filename <string>",
323
- "specify the name of the ZIP file. Defaults to the extension name and version"
324
- ).option(
325
- "--silent [boolean]",
326
- "whether or not to open the browser automatically. Defaults to `false`"
327
- ).action(async function(pathOrRemoteUrl, { browser = "chrome", ...buildOptions }) {
328
- for (const vendor of vendors(browser)) {
329
- await (0, import_extension_develop.extensionBuild)(pathOrRemoteUrl, {
330
- browser: vendor,
331
- polyfill: buildOptions.polyfill,
332
- zip: buildOptions.zip,
333
- zipSource: buildOptions.zipSource,
334
- zipFilename: buildOptions.zipFilename,
335
- silent: buildOptions.silent
133
+ extensionJs.command('build').arguments('[project-name]').usage('build [path-to-remote-extension] [options]').description('Builds the extension for production').option('--browser <chrome | edge | firefox>', 'specify a browser to preview your extension in production mode. Defaults to `chrome`').option('--polyfill [boolean]', 'whether or not to apply the cross-browser polyfill. Defaults to `false`').option('--zip [boolean]', 'whether or not to compress the extension into a ZIP file. Defaults to `false`').option('--zip-source [boolean]', 'whether or not to include the source files in the ZIP file. Defaults to `false`').option('--zip-filename <string>', 'specify the name of the ZIP file. Defaults to the extension name and version').option('--silent [boolean]', 'whether or not to open the browser automatically. Defaults to `false`').action(async function(pathOrRemoteUrl, { browser = 'chrome', ...buildOptions }) {
134
+ for (const vendor of vendors(browser))await (0, external_extension_develop_namespaceObject.extensionBuild)(pathOrRemoteUrl, {
135
+ browser: vendor,
136
+ polyfill: buildOptions.polyfill,
137
+ zip: buildOptions.zip,
138
+ zipSource: buildOptions.zipSource,
139
+ zipFilename: buildOptions.zipFilename,
140
+ silent: buildOptions.silent
336
141
  });
337
- }
338
142
  });
339
143
  extensionJs.parse();
144
+ for(var __webpack_i__ in __webpack_exports__)exports[__webpack_i__] = __webpack_exports__[__webpack_i__];
145
+ Object.defineProperty(exports, '__esModule', {
146
+ value: true
147
+ });
@@ -5,25 +5,42 @@
5
5
  /// <reference path="./css-modules.d.ts" />
6
6
  /// <reference path="./images.d.ts" />
7
7
 
8
+ type ExtensionBrowser =
9
+ | 'chrome'
10
+ | 'edge'
11
+ | 'firefox'
12
+ | 'chromium-based'
13
+ | 'gecko-based'
14
+ type ExtensionMode = 'development' | 'production'
15
+
16
+ interface ExtensionEnv {
17
+ EXTENSION_BROWSER: ExtensionBrowser
18
+ EXTENSION_MODE: ExtensionMode
19
+ EXTENSION_PUBLIC_BROWSER: ExtensionBrowser
20
+ EXTENSION_PUBLIC_MODE: ExtensionMode
21
+ EXTENSION_PUBLIC_DESCRIPTION_TEXT: string
22
+ EXTENSION_PUBLIC_OPENAI_API_KEY: string
23
+ EXTENSION_ENV: ExtensionMode
24
+ }
25
+
8
26
  declare namespace NodeJS {
9
- interface ProcessEnv {
10
- readonly EXTENSION_BROWSER:
11
- | 'chrome'
12
- | 'edge'
13
- | 'firefox'
14
- | 'chromium-based'
15
- | 'gecko-based'
16
- readonly EXTENSION_MODE: 'development' | 'production'
27
+ interface ProcessEnv extends ExtensionEnv {
28
+ [key: string]: string | undefined
17
29
  }
18
30
  }
19
31
 
20
- interface ImportMetaEnv {
21
- readonly EXTENSION_BROWSER: NodeJS.ProcessEnv['EXTENSION_BROWSER']
22
- readonly EXTENSION_MODE: NodeJS.ProcessEnv['EXTENSION_MODE']
32
+ interface ImportMetaEnv extends ExtensionEnv {
33
+ // Remove duplicate index signature since it's already inherited from ExtensionEnv
23
34
  }
24
35
 
25
36
  interface ImportMeta {
26
37
  readonly env: ImportMetaEnv
38
+ // @ts-expect-error - This is a webpack specific property
39
+ readonly webpackHot?: {
40
+ accept: (module?: string | string[], callback?: () => void) => void
41
+ dispose: (callback: () => void) => void
42
+ }
43
+ url: string
27
44
  }
28
45
 
29
46
  interface Window {
package/package.json CHANGED
@@ -8,18 +8,24 @@
8
8
  "engines": {
9
9
  "node": ">=18"
10
10
  },
11
- "name": "extension",
12
- "version": "2.0.0-rc.25",
13
- "description": "Create cross-browser extensions with no build configuration.",
11
+ "exports": {
12
+ ".": {
13
+ "types": "./dist/cli.d.ts",
14
+ "import": "./dist/cli.js",
15
+ "require": "./dist/cli.js"
16
+ }
17
+ },
14
18
  "main": "./dist/cli.js",
15
19
  "types": "./dist/cli.d.ts",
16
20
  "files": [
17
- "dist",
18
- "README.md"
21
+ "dist"
19
22
  ],
20
23
  "bin": {
21
24
  "extension": "./dist/cli.js"
22
25
  },
26
+ "name": "extension",
27
+ "version": "2.0.0-rc.27",
28
+ "description": "Create cross-browser extensions with no build configuration.",
23
29
  "author": {
24
30
  "name": "Cezar Augusto",
25
31
  "email": "boss@cezaraugusto.net",
@@ -40,7 +46,7 @@
40
46
  "typescript"
41
47
  ],
42
48
  "dependencies": {
43
- "@colors/colors": "^1.6.0",
49
+ "chalk": "^5.3.0",
44
50
  "@types/chrome": "^0.0.287",
45
51
  "@types/firefox-webext-browser": "^120.0.4",
46
52
  "@types/node": "^22.10.1",
@@ -50,30 +56,25 @@
50
56
  "semver": "^7.6.3",
51
57
  "update-check": "^1.5.4",
52
58
  "webextension-polyfill": "^0.12.0",
53
- "extension-create": "2.0.0-rc.25",
54
- "extension-develop": "2.0.0-rc.25"
59
+ "extension-develop": "2.0.0-rc.27",
60
+ "extension-create": "2.0.0-rc.27"
55
61
  },
56
62
  "devDependencies": {
57
- "@types/jest": "^29.5.14",
63
+ "@rslib/core": "^0.6.9",
58
64
  "@types/mock-fs": "^4.13.4",
59
65
  "@types/semver": "^7.5.8",
60
- "jest": "^29.7.0",
61
66
  "mock-fs": "^5.4.1",
62
- "ts-jest": "^29.3.1",
63
67
  "tsconfig": "*",
64
- "tsup": "^8.3.5",
65
68
  "typescript": "5.7.2"
66
69
  },
67
70
  "scripts": {
68
- "watch": "pnpm compile --watch",
71
+ "watch": "rslib build --watch",
69
72
  "compile:types": "bash install_scripts.sh",
70
73
  "compile:readme-files": "node ./scripts/copyMarkdownFilesToCli.js",
71
- "compile:tailwind-config": "node ./scripts/copyTailwindConfig.js",
72
- "compile:stylelint-config": "node ./scripts/copyStylelintConfig.js",
73
- "compile:cli": "tsup-node ./cli.ts --format cjs --dts --target=node18",
74
- "compile": "pnpm compile:readme-files && pnpm compile:tailwind-config && pnpm compile:stylelint-config && pnpm compile:cli && pnpm compile:types",
74
+ "compile:cli": "rslib build",
75
+ "compile": "pnpm compile:readme-files && pnpm compile:cli && pnpm compile:types",
75
76
  "clean": "rm -rf dist",
76
77
  "test": "echo \"Note: no test specified\" && exit 0",
77
- "test:cli": "jest __spec__/cli.spec.ts"
78
+ "test:cli": "vitest run"
78
79
  }
79
80
  }
@@ -1,7 +0,0 @@
1
- /** @type {import('stylelint').Config} */
2
- const stylelintRootConfig = {
3
- extends: [],
4
- rules: {}
5
- }
6
-
7
- module.exports = stylelintRootConfig
@@ -1,25 +0,0 @@
1
- const path = require('path')
2
- const fs = require('fs')
3
-
4
- const [, pathOrRemoteUrl] = process.argv.slice(2)
5
- const projectDir = pathOrRemoteUrl.startsWith('http')
6
- ? process.cwd() + path.basename(pathOrRemoteUrl)
7
- : path.resolve(__dirname, pathOrRemoteUrl)
8
-
9
- const tailwindConfig = path.join(projectDir, 'tailwind.config.js')
10
-
11
- /** @type {import('tailwindcss').Config} */
12
- const tailwindConfigData = fs.existsSync(tailwindConfig)
13
- ? require(tailwindConfig)
14
- : {content: []}
15
-
16
- /** @type {import('tailwindcss').Config} */
17
- const tailwindRootConfig = {
18
- ...tailwindConfigData,
19
- content: [
20
- // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
21
- ...tailwindConfigData.content.map((file) => path.join(projectDir, file))
22
- ]
23
- }
24
-
25
- module.exports = tailwindRootConfig