extension 3.1.0-next.7 → 3.1.1

package/README.md

@@ -19,7 +19,7 @@
 
 - [Create a new extension](#create-a-new-extension) — How to create a new extension.
 - [Watch demo](#watch-demo) — See how creating a new extension works.
-- [Start from an example](https://github.com/extension-js/extension.js/tree/main/examples) — Start from a working baseline.
+- [Start from an example](https://github.com/extension-js/examples) — Start from a working baseline.
 - [I have an extension](#i-have-an-extension) — Use only specific parts of Extension.js.
 
 Create cross-browser extensions without manual build configuration.<br />Use Extension.js to develop, build, and preview across browsers with a unified workflow.

package/dist/check-updates.d.ts

@@ -1 +1 @@
-export default function checkUpdates(packageJson: Record<string, any>): Promise<void>;
+export default function checkUpdates(): Promise<string | null>;

package/dist/cli-package-json.d.ts

@@ -0,0 +1 @@
+export declare function getCliPackageJson(): Record<string, any>;

package/dist/cli.js

@@ -23,7 +23,6 @@ var __webpack_require__ = {};
 })();
 var __webpack_exports__ = {};
 const external_commander_namespaceObject = require("commander");
-var package_namespaceObject = JSON.parse('{"license":"MIT","repository":{"type":"git","url":"git+https://github.com/extension-js/extension.js.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","typesVersions":{"*":{"types":["./types/index.d.ts"],"types/*":["./types/*"]}},"files":["dist","types"],"bin":{"extension":"./dist/cli.js"},"name":"extension","version":"3.1.0-next.7","description":"Create cross-browser extensions with no build configuration.","homepage":"https://extension.js.org/","bugs":{"url":"https://github.com/extension-js/extension.js/issues"},"author":{"name":"Cezar Augusto","email":"boss@cezaraugusto.net","url":"https://cezaraugusto.com"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org"},"scripts":{"prepublishOnly":"pnpm run compile","compile":"rslib build","watch":"rslib build --watch","test":"vitest run"},"keywords":["zero-config","build","develop","browser","extension","chrome extension","edge extension","firefox extension","safari extension","web","react","typescript","webextension","browser-extension","chrome-extension","firefox-addon","edge-extension","safari-web-extension","manifest-v3","mv3","cross-browser","content-script","background-script","devtools","create-extension","scaffold","starter-template","boilerplate","cli"],"dependencies":{"extension-create":"^3.1.0-next.7","extension-develop":"^3.1.0-next.7","commander":"^14.0.2","pintor":"0.3.0","semver":"^7.7.3","update-check":"^1.5.4"},"devDependencies":{"@rslib/core":"^0.19.2","@types/chrome":"^0.1.33","@types/node":"^25.0.9","@types/react":"^19.2.8","@types/react-dom":"^19.2.3","@types/webextension-polyfill":"0.12.4","@types/mock-fs":"^4.13.4","@types/semver":"^7.7.1","mock-fs":"^5.5.0","webextension-polyfill":"^0.12.0","tsconfig":"*","typescript":"5.9.3","vitest":"^4.0.17"}}');
 const external_update_check_namespaceObject = require("update-check");
 var external_update_check_default = /*#__PURE__*/ __webpack_require__.n(external_update_check_namespaceObject);
 const external_pintor_namespaceObject = require("pintor");
@@ -156,7 +155,7 @@ ${external_pintor_default().underline('Path Resolution (important)')}
 
 
 AI Assistants
-- For AI-oriented guidance and deep-dive tips, run ${code('extension --ai-help')}
+- For AI-oriented guidance and deeper tips, run ${code('extension --ai-help')}
 
  Report issues
  - ${external_pintor_default().underline('https://github.com/cezaraugusto/extension/issues/new')}`;
@@ -271,7 +270,7 @@ Source Inspection & Real-Time Monitoring
   - Watch mode is enabled by default when ${code('--source')} is present
 - Automatically enables Chrome remote debugging (port 9222) when source inspection is active
 - Extracts Shadow DOM content from ${code('#extension-root')} or ${code('[data-extension-root=\"true\"]')} elements
-- Perfect for debugging content script behavior and style injection
+- Useful for debugging content script behavior and style injection
 - Example: ${code('extension dev --source=' + arg('https://example.com'))}
 
 Non-Destructive Testing in CI
@@ -300,18 +299,39 @@ Cross-Browser Compatibility
 - Supports Chrome, Edge, Firefox with single codebase`;
 }
 const external_semver_namespaceObject = require("semver");
+const external_node_fs_namespaceObject = require("node:fs");
+var external_node_fs_default = /*#__PURE__*/ __webpack_require__.n(external_node_fs_namespaceObject);
+const external_node_path_namespaceObject = require("node:path");
+var external_node_path_default = /*#__PURE__*/ __webpack_require__.n(external_node_path_namespaceObject);
+let cachedPackageJson = null;
+function getCliPackageJson() {
+    if (cachedPackageJson) return cachedPackageJson;
+    const candidates = [
+        external_node_path_default().resolve(__dirname, 'package.json'),
+        external_node_path_default().resolve(__dirname, '..', 'package.json')
+    ];
+    for (const candidate of candidates)if (external_node_fs_default().existsSync(candidate)) {
+        const content = external_node_fs_default().readFileSync(candidate, 'utf8');
+        const parsed = JSON.parse(content);
+        cachedPackageJson = parsed;
+        return parsed;
+    }
+    throw new Error('Extension.js CLI package.json not found.');
+}
 function isStableVersion(version) {
     const v = external_semver_namespaceObject.parse(version);
     return Boolean(v && 0 === v.prerelease.length);
 }
-async function check_updates_checkUpdates(packageJson) {
+async function check_updates_checkUpdates() {
+    const packageJson = getCliPackageJson();
     let update = null;
     try {
         update = await external_update_check_default()(packageJson);
     } catch (err) {
         if ('true' === process.env.EXTENSION_AUTHOR_MODE) console.error(updateFailed(err));
     }
-    if (update && isStableVersion(update.latest)) console.log(checkUpdates(packageJson, update));
+    if (update && isStableVersion(update.latest)) return checkUpdates(packageJson, update);
+    return null;
 }
 const external_fs_namespaceObject = require("fs");
 var external_fs_default = /*#__PURE__*/ __webpack_require__.n(external_fs_namespaceObject);
@@ -319,10 +339,6 @@ const external_path_namespaceObject = require("path");
 var external_path_default = /*#__PURE__*/ __webpack_require__.n(external_path_namespaceObject);
 const external_node_os_namespaceObject = require("node:os");
 var external_node_os_default = /*#__PURE__*/ __webpack_require__.n(external_node_os_namespaceObject);
-const external_node_fs_namespaceObject = require("node:fs");
-var external_node_fs_default = /*#__PURE__*/ __webpack_require__.n(external_node_fs_namespaceObject);
-const external_node_path_namespaceObject = require("node:path");
-var external_node_path_default = /*#__PURE__*/ __webpack_require__.n(external_node_path_namespaceObject);
 const external_node_crypto_namespaceObject = require("node:crypto");
 var external_node_crypto_default = /*#__PURE__*/ __webpack_require__.n(external_node_crypto_namespaceObject);
 function _define_property(obj, key, value) {
@@ -450,7 +466,7 @@ class Telemetry {
                 this.track('cli_telemetry_consent', {
                     value: 'implicit_opt_in'
                 });
-                console.log(`${external_pintor_default().gray('►►► system')} [extension] anonymous telemetry helps us improve. Pass --no-telemetry to opt out. Read more in TELEMETRY.md.`);
+                console.log(`${external_pintor_default().gray('►►►')} Telemetry is enabled for Extension.js. To opt out, run with --no-telemetry. Learn more in TELEMETRY.md.`);
             }
         }
     }
@@ -513,7 +529,7 @@ function findManifestJson(projectRoot) {
 }
 const telemetry_cli_telemetry = new Telemetry({
     app: 'extension',
-    version: package_namespaceObject.version,
+    version: getCliPackageJson().version,
     disabled: telemetryDisabled
 });
 if (!telemetryDisabled) {
@@ -593,7 +609,7 @@ function validateVendorsOrExit(vendorsList, onInvalid) {
     }
 }
 function registerCreateCommand(program, telemetry) {
-    program.command('create').arguments('<project-name|project-path>').usage('create <project-name|project-path> [options]').description(commandDescriptions.create).option('-t, --template <template-name>', 'specify a template for the created project').option('--install [boolean]', 'whether or not to install the dependencies after creating the project (disabled by default)', parseOptionalBoolean, false).action(async function(pathOrRemoteUrl, { template, install }) {
+    program.command('create').arguments('<project-name|project-path>').usage('create <project-name|project-path> [options]').description(commandDescriptions.create).option('-t, --template <template-name>', 'specify a template for the created project').option('--install [boolean]', 'whether or not to install the dependencies after creating the project (enabled by default)', parseOptionalBoolean, true).action(async function(pathOrRemoteUrl, { template, install }) {
         const startedAt = Date.now();
         telemetry.track('cli_command_start', {
             command: 'create',
@@ -602,10 +618,16 @@ function registerCreateCommand(program, telemetry) {
         });
         try {
             const { extensionCreate } = await import("extension-create");
+            const { ensureDependencies } = await import("extension-develop");
+            const projectPath = external_path_namespaceObject.isAbsolute(pathOrRemoteUrl) ? pathOrRemoteUrl : external_path_namespaceObject.join(process.cwd(), pathOrRemoteUrl);
             await extensionCreate(pathOrRemoteUrl, {
                 template,
                 install,
-                cliVersion: package_namespaceObject.version
+                cliVersion: getCliPackageJson().version
+            });
+            if (install) await ensureDependencies(projectPath, {
+                skipProjectInstall: true,
+                showRunAgainMessage: false
             });
             telemetry.track('cli_command_finish', {
                 command: 'create',
@@ -882,9 +904,15 @@ function registerBuildCommand(program, telemetry) {
         });
     });
 }
-check_updates_checkUpdates(package_namespaceObject);
+const cliPackageJson = getCliPackageJson();
+process.env.EXTENSION_CLI_VERSION = cliPackageJson.version;
+check_updates_checkUpdates().then((updateMessage)=>{
+    if (!updateMessage) return;
+    if ('true' === process.env.EXTENSION_CLI_BANNER_PRINTED) return void console.log(updateMessage);
+    process.env.EXTENSION_CLI_UPDATE_MESSAGE = updateMessage;
+});
 const extensionJs = external_commander_namespaceObject.program;
-extensionJs.name(package_namespaceObject.name).description(package_namespaceObject.description).version(package_namespaceObject.version).option('--no-telemetry', 'disable anonymous telemetry for this run').option('--ai-help', 'show AI-assistant oriented help and tips').addHelpText('after', programUserHelp()).showHelpAfterError(true).showSuggestionAfterError(true);
+extensionJs.name(cliPackageJson.name).description(cliPackageJson.description).version(cliPackageJson.version).option('--no-telemetry', 'disable anonymous telemetry for this run').option('--ai-help', 'show AI-assistant oriented help and tips').addHelpText('after', programUserHelp()).showHelpAfterError(true).showSuggestionAfterError(true);
 registerCreateCommand(extensionJs, telemetry_cli_telemetry);
 registerDevCommand(extensionJs, telemetry_cli_telemetry);
 registerStartCommand(extensionJs, telemetry_cli_telemetry);

package/package.json

@@ -35,7 +35,7 @@
     "extension": "./dist/cli.js"
   },
   "name": "extension",
-  "version": "3.1.0-next.7",
+  "version": "3.1.1",
   "description": "Create cross-browser extensions with no build configuration.",
   "homepage": "https://extension.js.org/",
   "bugs": {
@@ -88,8 +88,8 @@
     "cli"
   ],
   "dependencies": {
-    "extension-create": "^3.1.0-next.7",
-    "extension-develop": "^3.1.0-next.7",
+    "extension-create": "^3.1.1",
+    "extension-develop": "^3.1.1",
     "commander": "^14.0.2",
     "pintor": "0.3.0",
     "semver": "^7.7.3",

package/types/extension-develop-shim.d.ts

@@ -82,4 +82,22 @@ declare module 'extension-develop' {
     pathOrRemoteUrl: string,
     options: PreviewOptions
   ): Promise<any>
+
+  export function ensureDependencies(
+    projectPath?: string,
+    opts?: {
+      skipProjectInstall?: boolean
+      exitOnInstall?: boolean
+      showRunAgainMessage?: boolean
+    }
+  ): Promise<{
+    installed: boolean
+    installedBuild: boolean
+    installedUser: boolean
+  }>
+
+  export function preflightOptionalDependenciesForProject(
+    pathOrRemoteUrl: string,
+    mode?: ExtensionMode
+  ): Promise<void>
 }