extension 4.0.11 → 4.0.12

package/README.md

@@ -23,7 +23,7 @@ cd my-extension
 npm run dev
 ```
 
-Works with `npm`, `pnpm`, `yarn`, `bun`, and `deno` (run the CLI with `deno run -A npm:extension@latest ...`).
+Works with `npm`, `pnpm`, `yarn`, `bun`, and `deno`.
 
 [Documentation](https://extension.js.org) · [Templates](https://templates.extension.dev) · [Examples](https://github.com/extension-js/examples) · [Discord](https://discord.gg/v9h2RgeTSN)
 

package/dist/browsers.cjs

@@ -1219,18 +1219,9 @@ var __webpack_modules__ = {
                 extension
             ];
         }
-        function publishUserExtensionRoot(extension, setExtensionRoot) {
-            try {
-                const root = [
-                    ...toExtensionLoadList(extension)
-                ].reverse().find((entry)=>'string' == typeof entry);
-                if (root && setExtensionRoot) setExtensionRoot(String(root));
-            } catch  {}
-        }
         __webpack_require__.d(__webpack_exports__, {
             fT: ()=>toExtensionLoadList,
             pA: ()=>pickSharedBrowserRuntimeOptions,
-            sl: ()=>publishUserExtensionRoot,
             zU: ()=>buildBrowserLaunchRequest
         });
     },
@@ -1693,45 +1684,10 @@ var __webpack_modules__ = {
     "./browsers/run-chromium/chromium-context/index.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
         function createChromiumContext() {
             let controller;
-            let cdpPort;
-            let extensionRoot;
-            let swRel;
-            let swAbs;
-            let pendingReason;
-            const readyCbs = [];
             return {
                 getController: ()=>controller,
-                onControllerReady: (cb)=>{
-                    if (controller && cdpPort) cb(controller, cdpPort);
-                    else readyCbs.push(cb);
-                },
-                setController: (c, port)=>{
+                setController: (c)=>{
                     controller = c;
-                    cdpPort = port;
-                    for (const cb of readyCbs)cb(c, port);
-                    readyCbs.length = 0;
-                },
-                getPorts: ()=>({
-                        cdpPort
-                    }),
-                getExtensionRoot: ()=>extensionRoot,
-                setExtensionRoot: (root)=>{
-                    extensionRoot = root;
-                },
-                setServiceWorkerPaths: (rel, abs)=>{
-                    swRel = rel;
-                    swAbs = abs;
-                },
-                getServiceWorkerPaths: ()=>({
-                        relativePath: swRel,
-                        absolutePath: swAbs
-                    }),
-                setPendingReloadReason: (r)=>{
-                    pendingReason = r;
-                },
-                getPendingReloadReason: ()=>pendingReason,
-                clearPendingReloadReason: ()=>{
-                    pendingReason = void 0;
                 }
             };
         }
@@ -2755,7 +2711,6 @@ var __webpack_modules__ = {
                 } catch  {}
                 console.log(messages.iL(browser, browserBinaryLocation, browserVersionLine));
                 const extensionsToLoad = (0, runtime_options.fT)(this.options.extension);
-                (0, runtime_options.sl)(extensionsToLoad, this.ctx.setExtensionRoot);
                 const resolvedBrowserVersion = /(\d+(?:\.\d+){0,3})/.exec(browserVersionLine || '')?.[1];
                 for (const extPath of extensionsToLoad)try {
                     const m = JSON.parse(external_fs_.readFileSync(external_path_.join(String(extPath), 'manifest.json'), 'utf8'));
@@ -2853,7 +2808,7 @@ var __webpack_modules__ = {
                             mod.setupCdpAfterLaunch(compilation, cdpConfig, chromiumConfig, pipeStreams),
                             new Promise((_, reject)=>setTimeout(()=>reject(new Error(`CDP setup did not complete within ${CDP_SETUP_TIMEOUT_MS / 1000}s. Chrome likely rejected the extension at launch — open chrome://extensions in the dev browser window for the exact error. Common causes: MV3 content_security_policy with 'unsafe-inline', manifest keys Chrome does not support, or manifest references to files missing from the output. Reload/HMR cannot attach until this is fixed.`)), CDP_SETUP_TIMEOUT_MS).unref?.())
                         ]);
-                        if (cdpConfig.cdpController) this.ctx.setController(cdpConfig.cdpController, selectedPort);
+                        if (cdpConfig.cdpController) this.ctx.setController(cdpConfig.cdpController);
                     }
                 } catch (error) {
                     const message = String(error && error.message);
@@ -3094,45 +3049,10 @@ var __webpack_modules__ = {
     "./browsers/run-firefox/firefox-context/index.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
         function createFirefoxContext() {
             let controller;
-            let rdpPort;
-            const readyCbs = [];
-            let extensionRoot;
-            let swRel;
-            let swAbs;
-            let pendingReason;
             return {
                 getController: ()=>controller,
-                onControllerReady: (cb)=>{
-                    if (controller && rdpPort) cb(controller, rdpPort);
-                    else readyCbs.push(cb);
-                },
-                setController: (c, port)=>{
+                setController: (c)=>{
                     controller = c;
-                    rdpPort = port;
-                    for (const cb of readyCbs)cb(c, port);
-                    readyCbs.length = 0;
-                },
-                getPorts: ()=>({
-                        rdpPort
-                    }),
-                setExtensionRoot: (root)=>{
-                    extensionRoot = root;
-                },
-                getExtensionRoot: ()=>extensionRoot,
-                setServiceWorkerPaths: (rel, abs)=>{
-                    swRel = rel;
-                    swAbs = abs;
-                },
-                getServiceWorkerPaths: ()=>({
-                        relativePath: swRel,
-                        absolutePath: swAbs
-                    }),
-                setPendingReloadReason: (r)=>{
-                    pendingReason = r;
-                },
-                getPendingReloadReason: ()=>pendingReason,
-                clearPendingReloadReason: ()=>{
-                    pendingReason = void 0;
                 },
                 logger: void 0,
                 didLaunch: false
@@ -4150,7 +4070,6 @@ var __webpack_modules__ = {
             }
             invalidateConnectionScopedCaches() {
                 this.cachedAddonsActor = void 0;
-                this.cachedSupportsReload = null;
             }
             async installAddons(compilation) {
                 const { devtools } = this.options;
@@ -4237,7 +4156,6 @@ var __webpack_modules__ = {
                 remote_firefox_define_property(this, "client", null);
                 remote_firefox_define_property(this, "loggingAttached", false);
                 remote_firefox_define_property(this, "cachedAddonsActor", void 0);
-                remote_firefox_define_property(this, "cachedSupportsReload", null);
                 remote_firefox_define_property(this, "lastInstalledAddonPath", void 0);
                 remote_firefox_define_property(this, "derivedExtensionId", void 0);
                 this.options = configOptions;
@@ -4533,8 +4451,7 @@ var __webpack_modules__ = {
                         allowExec: true
                     }) || '';
                 } catch  {}
-                const extensionsToLoad = (0, runtime_options.fT)(this.host.extension);
-                (0, runtime_options.sl)(extensionsToLoad, 'function' == typeof this.ctx.setExtensionRoot ? this.ctx.setExtensionRoot : void 0);
+                (0, runtime_options.fT)(this.host.extension);
                 const desiredDebugPort = (0, shared_utils.jl)(this.host.port, this.host.instanceId);
                 const debugPort = await (0, shared_utils.aY)(desiredDebugPort);
                 (0, instance_registry.UF)(this.host.instanceId, {
@@ -4567,7 +4484,7 @@ var __webpack_modules__ = {
                     this.wireChildLifecycle();
                     const ctrl = await setupRdpAfterLaunch(this.host, compilation, debugPort);
                     this.host.rdpController = ctrl;
-                    this.ctx.setController(ctrl, debugPort);
+                    this.ctx.setController(ctrl);
                     this.scheduleWatchTimeout();
                     try {
                         if ('true' === process.env.EXTENSION_AUTHOR_MODE) {

package/dist/cli.cjs

@@ -1332,18 +1332,9 @@ var __webpack_modules__ = {
                 extension
             ];
         }
-        function publishUserExtensionRoot(extension, setExtensionRoot) {
-            try {
-                const root = [
-                    ...toExtensionLoadList(extension)
-                ].reverse().find((entry)=>'string' == typeof entry);
-                if (root && setExtensionRoot) setExtensionRoot(String(root));
-            } catch  {}
-        }
         __webpack_require__.d(__webpack_exports__, {
             fT: ()=>toExtensionLoadList,
             pA: ()=>pickSharedBrowserRuntimeOptions,
-            sl: ()=>publishUserExtensionRoot,
             zU: ()=>buildBrowserLaunchRequest
         });
     },
@@ -1804,45 +1795,10 @@ var __webpack_modules__ = {
     "./browsers/run-chromium/chromium-context/index.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
         function createChromiumContext() {
             let controller;
-            let cdpPort;
-            let extensionRoot;
-            let swRel;
-            let swAbs;
-            let pendingReason;
-            const readyCbs = [];
             return {
                 getController: ()=>controller,
-                onControllerReady: (cb)=>{
-                    if (controller && cdpPort) cb(controller, cdpPort);
-                    else readyCbs.push(cb);
-                },
-                setController: (c, port)=>{
+                setController: (c)=>{
                     controller = c;
-                    cdpPort = port;
-                    for (const cb of readyCbs)cb(c, port);
-                    readyCbs.length = 0;
-                },
-                getPorts: ()=>({
-                        cdpPort
-                    }),
-                getExtensionRoot: ()=>extensionRoot,
-                setExtensionRoot: (root)=>{
-                    extensionRoot = root;
-                },
-                setServiceWorkerPaths: (rel, abs)=>{
-                    swRel = rel;
-                    swAbs = abs;
-                },
-                getServiceWorkerPaths: ()=>({
-                        relativePath: swRel,
-                        absolutePath: swAbs
-                    }),
-                setPendingReloadReason: (r)=>{
-                    pendingReason = r;
-                },
-                getPendingReloadReason: ()=>pendingReason,
-                clearPendingReloadReason: ()=>{
-                    pendingReason = void 0;
                 }
             };
         }
@@ -2866,7 +2822,6 @@ var __webpack_modules__ = {
                 } catch  {}
                 console.log(messages.iL(browser, browserBinaryLocation, browserVersionLine));
                 const extensionsToLoad = (0, runtime_options.fT)(this.options.extension);
-                (0, runtime_options.sl)(extensionsToLoad, this.ctx.setExtensionRoot);
                 const resolvedBrowserVersion = /(\d+(?:\.\d+){0,3})/.exec(browserVersionLine || '')?.[1];
                 for (const extPath of extensionsToLoad)try {
                     const m = JSON.parse(external_fs_.readFileSync(external_path_.join(String(extPath), 'manifest.json'), 'utf8'));
@@ -2964,7 +2919,7 @@ var __webpack_modules__ = {
                             mod.setupCdpAfterLaunch(compilation, cdpConfig, chromiumConfig, pipeStreams),
                             new Promise((_, reject)=>setTimeout(()=>reject(new Error(`CDP setup did not complete within ${CDP_SETUP_TIMEOUT_MS / 1000}s. Chrome likely rejected the extension at launch — open chrome://extensions in the dev browser window for the exact error. Common causes: MV3 content_security_policy with 'unsafe-inline', manifest keys Chrome does not support, or manifest references to files missing from the output. Reload/HMR cannot attach until this is fixed.`)), CDP_SETUP_TIMEOUT_MS).unref?.())
                         ]);
-                        if (cdpConfig.cdpController) this.ctx.setController(cdpConfig.cdpController, selectedPort);
+                        if (cdpConfig.cdpController) this.ctx.setController(cdpConfig.cdpController);
                     }
                 } catch (error) {
                     const message = String(error && error.message);
@@ -3205,45 +3160,10 @@ var __webpack_modules__ = {
     "./browsers/run-firefox/firefox-context/index.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
         function createFirefoxContext() {
             let controller;
-            let rdpPort;
-            const readyCbs = [];
-            let extensionRoot;
-            let swRel;
-            let swAbs;
-            let pendingReason;
             return {
                 getController: ()=>controller,
-                onControllerReady: (cb)=>{
-                    if (controller && rdpPort) cb(controller, rdpPort);
-                    else readyCbs.push(cb);
-                },
-                setController: (c, port)=>{
+                setController: (c)=>{
                     controller = c;
-                    rdpPort = port;
-                    for (const cb of readyCbs)cb(c, port);
-                    readyCbs.length = 0;
-                },
-                getPorts: ()=>({
-                        rdpPort
-                    }),
-                setExtensionRoot: (root)=>{
-                    extensionRoot = root;
-                },
-                getExtensionRoot: ()=>extensionRoot,
-                setServiceWorkerPaths: (rel, abs)=>{
-                    swRel = rel;
-                    swAbs = abs;
-                },
-                getServiceWorkerPaths: ()=>({
-                        relativePath: swRel,
-                        absolutePath: swAbs
-                    }),
-                setPendingReloadReason: (r)=>{
-                    pendingReason = r;
-                },
-                getPendingReloadReason: ()=>pendingReason,
-                clearPendingReloadReason: ()=>{
-                    pendingReason = void 0;
                 },
                 logger: void 0,
                 didLaunch: false
@@ -4261,7 +4181,6 @@ var __webpack_modules__ = {
             }
             invalidateConnectionScopedCaches() {
                 this.cachedAddonsActor = void 0;
-                this.cachedSupportsReload = null;
             }
             async installAddons(compilation) {
                 const { devtools } = this.options;
@@ -4348,7 +4267,6 @@ var __webpack_modules__ = {
                 remote_firefox_define_property(this, "client", null);
                 remote_firefox_define_property(this, "loggingAttached", false);
                 remote_firefox_define_property(this, "cachedAddonsActor", void 0);
-                remote_firefox_define_property(this, "cachedSupportsReload", null);
                 remote_firefox_define_property(this, "lastInstalledAddonPath", void 0);
                 remote_firefox_define_property(this, "derivedExtensionId", void 0);
                 this.options = configOptions;
@@ -4644,8 +4562,7 @@ var __webpack_modules__ = {
                         allowExec: true
                     }) || '';
                 } catch  {}
-                const extensionsToLoad = (0, runtime_options.fT)(this.host.extension);
-                (0, runtime_options.sl)(extensionsToLoad, 'function' == typeof this.ctx.setExtensionRoot ? this.ctx.setExtensionRoot : void 0);
+                (0, runtime_options.fT)(this.host.extension);
                 const desiredDebugPort = (0, shared_utils.jl)(this.host.port, this.host.instanceId);
                 const debugPort = await (0, shared_utils.aY)(desiredDebugPort);
                 (0, instance_registry.UF)(this.host.instanceId, {
@@ -4678,7 +4595,7 @@ var __webpack_modules__ = {
                     this.wireChildLifecycle();
                     const ctrl = await setupRdpAfterLaunch(this.host, compilation, debugPort);
                     this.host.rdpController = ctrl;
-                    this.ctx.setController(ctrl, debugPort);
+                    this.ctx.setController(ctrl);
                     this.scheduleWatchTimeout();
                     try {
                         if ('true' === process.env.EXTENSION_AUTHOR_MODE) {
@@ -5244,7 +5161,7 @@ Troubleshooting
 Non-Interactive / Auto Mode (CI)
 - Set ${messages_code(messages_arg('EXTENSION_AUTO_EXIT_MS'))} to enable self-termination after N milliseconds.
   Useful when ${messages_code('pnpm extension dev')} would otherwise hang under Rspack watch.
-  Example: ${messages_code(messages_arg('EXTENSION_AUTO_EXIT_MS=6000'))} pnpm extension dev ./templates/react --browser chrome --source ${messages_arg('https://example.com')}
+  Example: ${messages_code(messages_arg('EXTENSION_AUTO_EXIT_MS=6000'))} pnpm extension dev ./templates/react --browser chrome --starting-url ${messages_arg('https://example.com')}
 - Optional: ${messages_code(messages_arg('EXTENSION_FORCE_KILL_MS'))} to hard-exit after N ms as a fallback (defaults to auto-exit + 4000).
 
 Docker / Devcontainers / Codespaces
@@ -6669,12 +6586,64 @@ Cross-Browser Compatibility
             const values = String(raw).split(',').map((value)=>value.trim()).filter((value)=>value.length > 0);
             return values.length > 0 ? values : void 0;
         }
+        const POLL_INTERVAL_MS = 2000;
+        const HARD_EXIT_GRACE_MS = 5000;
+        function isProcessAlive(pid) {
+            try {
+                process.kill(pid, 0);
+                return true;
+            } catch (error) {
+                return error?.code === 'EPERM';
+            }
+        }
+        function setupParentWatchdog(parentPid, options) {
+            const log = options?.log ?? console.error;
+            const pollIntervalMs = options?.pollIntervalMs ?? POLL_INTERVAL_MS;
+            const shutdown = options?.onDeath ?? (()=>{
+                const hardExit = setTimeout(()=>process.exit(1), HARD_EXIT_GRACE_MS);
+                hardExit.unref?.();
+                try {
+                    process.kill(process.pid, 'SIGTERM');
+                } catch  {
+                    process.exit(1);
+                }
+            });
+            const onParentDeath = ()=>{
+                log(`[Extension.js] Parent process ${parentPid} is gone (--parent-pid). Shutting down.`);
+                shutdown();
+            };
+            if (!isProcessAlive(parentPid)) {
+                onParentDeath();
+                return ()=>{};
+            }
+            const timer = setInterval(()=>{
+                if (isProcessAlive(parentPid)) return;
+                clearInterval(timer);
+                onParentDeath();
+            }, pollIntervalMs);
+            timer.unref?.();
+            return ()=>clearInterval(timer);
+        }
+        function parseParentPid(value) {
+            if (null == value || '' === value) return;
+            const pid = Number.parseInt(String(value), 10);
+            if (!Number.isInteger(pid) || pid <= 0) return;
+            return pid;
+        }
         function registerDevCommand(program) {
-            program.command('dev').arguments('[project-path|remote-url]').usage('[project-path|remote-url] [options]').description(commandDescriptions.dev).addHelpText('after', "\nAdditional options:\n  --no-browser    do not launch the browser (dev server still starts)\n  --no-reload     emit a dev-mode dist without the content-script reload runtime; tabs need manual reload to see changes\n  --wait          wait for ready contract and exit\n  --wait-format   pretty|json output for wait mode\n").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('-b, --browser <chrome | chromium | edge | firefox | chromium-based | gecko-based | firefox-based | safari | webkit-based>', 'specify a browser/engine to run. Defaults to `chromium`. `safari` builds and opens a Safari app via Xcode (macOS only; no live reload)').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, --firefox-binary <path-to-binary>', 'specify a path to the Gecko binary. This option overrides the --browser setting. Defaults to the system default').option('--safari-binary <path-to-binary>', 'specify the Safari binary to open after packaging (safari targets only)').option('--app-name <name>', 'override the Safari app name (safari targets only). Defaults to the manifest `name`').option('--bundle-id <reverse.dns>', 'set a user-owned Safari bundle identifier (safari targets only). Defaults to a generated dev.extensionjs.* id').option('--force-regenerate', 'regenerate the Safari Xcode project even when up to date (safari targets only)').option('--polyfill [boolean]', 'whether or not to apply the cross-browser polyfill. Defaults to `true`', parseOptionalBoolean).option('--no-open', 'do not open the browser automatically (default: open)').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`').option('--host <host>', 'specify the host to bind the dev server to. Use 0.0.0.0 for Docker/devcontainers. Defaults to `127.0.0.1`').option('--public-host <host>', 'connectable host the browser (HMR + reload bridge) dials when it differs from the bind host (e.g. a remote/devcontainer). Defaults to the bind host, or 127.0.0.1 when bound to 0.0.0.0').option('--log-context <list>', '[experimental] comma-separated contexts to include (background,content,page,sidebar,popup,options,devtools). Use `all` to include all contexts (default)').option('--logs <off|error|warn|info|debug|trace|all>', '[experimental] minimum centralized logger level to display in terminal (default: off)').option('--log-format <pretty|json|ndjson>', '[experimental] output format for logger events. Defaults to `pretty`').option('--no-log-timestamps', 'disable ISO timestamps in pretty output').option('--no-log-color', 'disable color in pretty output').option('--log-url <pattern>', '[experimental] only show logs where event.url matches this substring or regex (/re/i)').option('--log-tab <id>', 'only show logs for a specific tabId (number)').option('--extensions <list>', 'comma-separated list of companion extensions or store URLs to load').option('--install [boolean]', '[internal] install project dependencies when missing', parseOptionalBoolean).option('--wait [boolean]', 'wait for dist/extension-js/<browser>/ready.json and exit', parseOptionalBoolean).option('--wait-timeout <ms>', 'timeout in milliseconds when using --wait (default: 60000)').option('--wait-format <pretty|json>', 'output format for --wait results (default: pretty)').option('--author, --author-mode', '[internal] enable maintainer diagnostics (does not affect user runtime logs)').option('--allow-control', 'enable the agent-bridge control channel for bounded act (storage/reload/open): see `extension reload|storage|open`').option('--allow-eval', 'additionally enable `extension eval` (runs arbitrary code in a context; writes a 0600 session token)').action(async function(pathOrRemoteUrl, { browser = 'chromium', ...devOptions }) {
+            program.command('dev').arguments('[project-path|remote-url]').usage('[project-path|remote-url] [options]').description(commandDescriptions.dev).addHelpText('after', "\nAdditional options:\n  --no-browser    do not launch the browser (dev server still starts)\n  --no-reload     emit a dev-mode dist without the content-script reload runtime; tabs need manual reload to see changes\n  --wait          wait for ready contract and exit\n  --wait-format   pretty|json output for wait mode\n").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('-b, --browser <chrome | chromium | edge | firefox | chromium-based | gecko-based | firefox-based | safari | webkit-based>', 'specify a browser/engine to run. Defaults to `chromium`. `safari` builds and opens a Safari app via Xcode (macOS only; no live reload)').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, --firefox-binary <path-to-binary>', 'specify a path to the Gecko binary. This option overrides the --browser setting. Defaults to the system default').option('--safari-binary <path-to-binary>', 'specify the Safari binary to open after packaging (safari targets only)').option('--app-name <name>', 'override the Safari app name (safari targets only). Defaults to the manifest `name`').option('--bundle-id <reverse.dns>', 'set a user-owned Safari bundle identifier (safari targets only). Defaults to a generated dev.extensionjs.* id').option('--force-regenerate', 'regenerate the Safari Xcode project even when up to date (safari targets only)').option('--polyfill [boolean]', 'whether or not to apply the cross-browser polyfill. Defaults to `true`', parseOptionalBoolean).option('--no-polyfill', 'disable the cross-browser polyfill').option('--no-open', 'do not open the browser automatically (default: open)').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`').option('--host <host>', 'specify the host to bind the dev server to. Use 0.0.0.0 for Docker/devcontainers. Defaults to `127.0.0.1`').option('--public-host <host>', 'connectable host the browser (HMR + reload bridge) dials when it differs from the bind host (e.g. a remote/devcontainer). Defaults to the bind host, or 127.0.0.1 when bound to 0.0.0.0').option('--log-context <list>', '[experimental] comma-separated contexts to include (background,content,page,sidebar,popup,options,devtools). Use `all` to include all contexts (default)').option('--logs <off|error|warn|info|debug|trace|all>', '[experimental] minimum centralized logger level to display in terminal (default: off)').option('--log-format <pretty|json|ndjson>', '[experimental] output format for logger events. Defaults to `pretty`').option('--no-log-timestamps', 'disable ISO timestamps in pretty output').option('--no-log-color', 'disable color in pretty output').option('--log-url <pattern>', '[experimental] only show logs where event.url matches this substring or regex (/re/i)').option('--log-tab <id>', 'only show logs for a specific tabId (number)').option('--extensions <list>', 'comma-separated list of companion extensions or store URLs to load').option('--install [boolean]', '[internal] install project dependencies when missing', parseOptionalBoolean).option('--wait [boolean]', 'wait for dist/extension-js/<browser>/ready.json and exit', parseOptionalBoolean).option('--wait-timeout <ms>', 'timeout in milliseconds when using --wait (default: 60000)').option('--wait-format <pretty|json>', 'output format for --wait results (default: pretty)').option('--author, --author-mode', '[internal] enable maintainer diagnostics (does not affect user runtime logs)').option('--allow-control', 'enable the agent-bridge control channel for bounded act (storage/reload/open): see `extension reload|storage|open`').option('--allow-eval', 'additionally enable `extension eval` (runs arbitrary code in a context; writes a 0600 session token)').option('--parent-pid <pid>', 'exit when the given process dies. For wrappers that spawn `extension dev`, so a leaked dev server can never outlive its owner').action(async function(pathOrRemoteUrl, { browser = 'chromium', ...devOptions }) {
                 if (devOptions.author || devOptions['authorMode']) {
                     process.env.EXTENSION_AUTHOR_MODE = 'true';
                     if (!process.env.EXTENSION_VERBOSE) process.env.EXTENSION_VERBOSE = '1';
                 }
+                if (void 0 !== devOptions.parentPid) {
+                    const parentPid = parseParentPid(devOptions.parentPid);
+                    if (void 0 === parentPid) {
+                        console.error(unhandledError(`--parent-pid expects a positive integer pid, got: ${devOptions.parentPid}`));
+                        process.exit(1);
+                    }
+                    setupParentWatchdog(parentPid);
+                }
                 const list = vendors(browser);
                 validateVendorsOrExit(list, (invalid, supported)=>{
                     console.error(unsupportedBrowserFlag(invalid, supported));
@@ -6775,7 +6744,7 @@ Cross-Browser Compatibility
         }
         var run_only = __webpack_require__("./browsers/run-only.ts");
         function registerStartCommand(program) {
-            program.command('start').arguments('[project-path|remote-url]').usage('[project-path|remote-url] [options]').description(commandDescriptions.start).addHelpText('after', '\nAdditional options:\n  --no-browser    do not launch the browser (build still runs)\n  --wait          wait for ready contract and exit\n  --wait-format   pretty|json output for wait mode\n').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 | chromium | edge | firefox | chromium-based | gecko-based | firefox-based>', 'specify a browser/engine to run. Defaults to `chromium`').option('--polyfill [boolean]', 'whether or not to apply the cross-browser polyfill. Defaults to `true`', parseOptionalBoolean).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, --firefox-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`').option('--host <host>', 'specify the host to bind the dev server to. Use 0.0.0.0 for Docker/devcontainers. Defaults to `127.0.0.1`').option('--public-host <host>', 'connectable host the browser (HMR + reload bridge) dials when it differs from the bind host (e.g. a remote/devcontainer). Defaults to the bind host, or 127.0.0.1 when bound to 0.0.0.0').option('--log-context <list>', '[experimental] comma-separated contexts to include (background,content,page,sidebar,popup,options,devtools). Use `all` to include all contexts (default)').option('--logs <off|error|warn|info|debug|trace|all>', '[experimental] minimum centralized logger level to display in terminal (default: off)').option('--log-format <pretty|json|ndjson>', '[experimental] output format for logger events. Defaults to `pretty`').option('--no-log-timestamps', 'disable ISO timestamps in pretty output').option('--no-log-color', 'disable color in pretty output').option('--log-url <pattern>', '[experimental] only show logs where event.url matches this substring or regex (/re/i)').option('--log-tab <id>', 'only show logs for a specific tabId (number)').option('--extensions <list>', 'comma-separated list of companion extensions or store URLs to load').option('--install [boolean]', '[experimental] install project dependencies when missing', parseOptionalBoolean).option('--wait [boolean]', 'wait for dist/extension-js/<browser>/ready.json and exit', parseOptionalBoolean).option('--wait-timeout <ms>', 'timeout in milliseconds when using --wait (default: 60000)').option('--wait-format <pretty|json>', 'output format for --wait results (default: pretty)').option('--author, --author-mode', '[experimental] enable maintainer diagnostics (does not affect user runtime logs)').action(async function(pathOrRemoteUrl, { browser = 'chromium', ...startOptions }) {
+            program.command('start').arguments('[project-path|remote-url]').usage('[project-path|remote-url] [options]').description(commandDescriptions.start).addHelpText('after', '\nAdditional options:\n  --no-browser    do not launch the browser (build still runs)\n  --wait          wait for ready contract and exit\n  --wait-format   pretty|json output for wait mode\n').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 | chromium | edge | firefox | chromium-based | gecko-based | firefox-based>', 'specify a browser/engine to run. Defaults to `chromium`').option('--polyfill [boolean]', 'whether or not to apply the cross-browser polyfill. Defaults to `true`', parseOptionalBoolean).option('--no-polyfill', 'disable the cross-browser polyfill').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, --firefox-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`').option('--host <host>', 'specify the host to bind the dev server to. Use 0.0.0.0 for Docker/devcontainers. Defaults to `127.0.0.1`').option('--public-host <host>', 'connectable host the browser (HMR + reload bridge) dials when it differs from the bind host (e.g. a remote/devcontainer). Defaults to the bind host, or 127.0.0.1 when bound to 0.0.0.0').option('--log-context <list>', '[experimental] comma-separated contexts to include (background,content,page,sidebar,popup,options,devtools). Use `all` to include all contexts (default)').option('--logs <off|error|warn|info|debug|trace|all>', '[experimental] minimum centralized logger level to display in terminal (default: off)').option('--log-format <pretty|json|ndjson>', '[experimental] output format for logger events. Defaults to `pretty`').option('--no-log-timestamps', 'disable ISO timestamps in pretty output').option('--no-log-color', 'disable color in pretty output').option('--log-url <pattern>', '[experimental] only show logs where event.url matches this substring or regex (/re/i)').option('--log-tab <id>', 'only show logs for a specific tabId (number)').option('--extensions <list>', 'comma-separated list of companion extensions or store URLs to load').option('--install [boolean]', '[experimental] install project dependencies when missing', parseOptionalBoolean).option('--wait [boolean]', 'wait for dist/extension-js/<browser>/ready.json and exit', parseOptionalBoolean).option('--wait-timeout <ms>', 'timeout in milliseconds when using --wait (default: 60000)').option('--wait-format <pretty|json>', 'output format for --wait results (default: pretty)').option('--author, --author-mode', '[experimental] enable maintainer diagnostics (does not affect user runtime logs)').action(async function(pathOrRemoteUrl, { browser = 'chromium', ...startOptions }) {
                 if (startOptions.author || startOptions.authorMode) {
                     process.env.EXTENSION_AUTHOR_MODE = 'true';
                     if (!process.env.EXTENSION_VERBOSE) process.env.EXTENSION_VERBOSE = '1';
@@ -6814,6 +6783,7 @@ Cross-Browser Compatibility
                     await extensionBuild(pathOrRemoteUrl, {
                         browser: vendor,
                         exitOnError: true,
+                        metadataCommand: 'start',
                         polyfill: startOptions.polyfill?.toString() !== 'false',
                         install: startOptions.install,
                         extensions: parseExtensionsList(startOptions.extensions),
@@ -6890,7 +6860,7 @@ Cross-Browser Compatibility
             });
         }
         function registerBuildCommand(program) {
-            program.command('build').arguments('[project-name]').usage('[path-to-remote-extension] [options]').description(commandDescriptions.build).option('--browser <chrome | chromium | edge | firefox | chromium-based | gecko-based | firefox-based | safari | webkit-based>', 'specify a browser/engine to run. Defaults to `chromium`. `safari` builds a Safari app via Xcode (macOS only)').option('--polyfill [boolean]', 'whether or not to apply the cross-browser polyfill. Defaults to `false`', parseOptionalBoolean).option('--zip [boolean]', 'whether or not to compress the extension into a ZIP file. Defaults to `false`', parseOptionalBoolean).option('--zip-source [boolean]', 'whether or not to include the source files in the ZIP file. Defaults to `false`', parseOptionalBoolean).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`', parseOptionalBoolean).option('--install [boolean]', '[internal] install project dependencies when missing', parseOptionalBoolean).option('--extensions <list>', 'comma-separated list of companion extensions or store URLs to load').option('--mode <development|production|none>', 'bundler mode override (also sets NODE_ENV). Defaults to `production`').option('--open [boolean]', 'open the built Safari app after packaging (safari targets only). Defaults to `false`', parseOptionalBoolean).option('--app-name <name>', 'override the Safari app name (safari targets only). Defaults to the manifest `name`').option('--bundle-id <reverse.dns>', 'set a user-owned Safari bundle identifier (safari targets only). Defaults to a generated dev.extensionjs.* id').option('--force-regenerate', 'regenerate the Safari Xcode project even when up to date (safari targets only)').option('--author, --author-mode', '[internal] enable maintainer diagnostics (does not affect user runtime logs)').action(async function(pathOrRemoteUrl, { browser = 'chromium', ...buildOptions }) {
+            program.command('build').arguments('[project-name]').usage('[path-to-remote-extension] [options]').description(commandDescriptions.build).option('--browser <chrome | chromium | edge | firefox | chromium-based | gecko-based | firefox-based | safari | webkit-based>', 'specify a browser/engine to run. Defaults to `chromium`. `safari` builds a Safari app via Xcode (macOS only)').option('--polyfill [boolean]', 'whether or not to apply the cross-browser polyfill. Defaults to `false`', parseOptionalBoolean).option('--no-polyfill', 'disable the cross-browser polyfill').option('--zip [boolean]', 'whether or not to compress the extension into a ZIP file. Defaults to `false`', parseOptionalBoolean).option('--zip-source [boolean]', 'whether or not to include the source files in the ZIP file. Defaults to `false`', parseOptionalBoolean).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`', parseOptionalBoolean).option('--install [boolean]', '[internal] install project dependencies when missing', parseOptionalBoolean).option('--extensions <list>', 'comma-separated list of companion extensions or store URLs to load').option('--mode <development|production|none>', 'bundler mode override (also sets NODE_ENV). Defaults to `production`').option('--open [boolean]', 'open the built Safari app after packaging (safari targets only). Defaults to `false`', parseOptionalBoolean).option('--app-name <name>', 'override the Safari app name (safari targets only). Defaults to the manifest `name`').option('--bundle-id <reverse.dns>', 'set a user-owned Safari bundle identifier (safari targets only). Defaults to a generated dev.extensionjs.* id').option('--force-regenerate', 'regenerate the Safari Xcode project even when up to date (safari targets only)').option('--author, --author-mode', '[internal] enable maintainer diagnostics (does not affect user runtime logs)').action(async function(pathOrRemoteUrl, { browser = 'chromium', ...buildOptions }) {
                 if (buildOptions.author || buildOptions['authorMode']) {
                     process.env.EXTENSION_AUTHOR_MODE = 'true';
                     if (!process.env.EXTENSION_VERBOSE) process.env.EXTENSION_VERBOSE = '1';
@@ -7247,7 +7217,7 @@ Cross-Browser Compatibility
                     opts
                 });
             });
-            commonOptions(program.command('inspect').arguments('[project-path]').description('Inspect a page/content DOM via the agent bridge (CDP-free; requires --allow-control). For closed shadow roots use dev --source --deep-dom.').option('--context <content|page|popup|options|sidebar|devtools>', 'what to inspect: content/page (needs --tab) or an open surface (default content)').option('--tab <id>', 'tab id to inspect (required for content/page)').option('--include <list>', 'comma-separated: html,summary (default summary)').option('--max-bytes <n>', 'cap on returned HTML bytes (default 262144)').option('--with-console [n]', 'also include the last n console lines for the target (default 20)')).action(async function(projectPathArg, opts) {
+            commonOptions(program.command('inspect').arguments('[project-path]').description('Inspect a page/content DOM via the agent bridge (CDP-free; requires --allow-control). For closed shadow roots use CDP-based inspection against the ready.json cdpPort.').option('--context <content|page|popup|options|sidebar|devtools>', 'what to inspect: content/page (needs --tab) or an open surface (default content)').option('--tab <id>', 'tab id to inspect (required for content/page)').option('--include <list>', 'comma-separated: html,summary (default summary)').option('--max-bytes <n>', 'cap on returned HTML bytes (default 262144)').option('--with-console [n]', 'also include the last n console lines for the target (default 20)')).action(async function(projectPathArg, opts) {
                 const include = opts.include ? opts.include.split(',').map((s)=>s.trim()).filter(Boolean) : [
                     'summary'
                 ];

package/dist/extension/browsers/browsers-lib/messages.d.ts

@@ -91,7 +91,6 @@ export declare function cdpClientConnectionError(error: string): string;
 export declare function cdpClientBrowserConnectionEstablished(): string;
 export declare function cdpClientConnectionClosed(): string;
 export declare function cdpClientLoadEventTimeout(): string;
-export declare function cdpClientExtensionReloadFailed(extensionId: string, error: string): string;
 export declare function cdpClientExtensionUnloadFailed(extensionId: string, error: string): string;
 export declare function cdpClientExtensionInfoFailed(extensionId: string, error: string): string;
 export declare function cdpClientExtensionLoadFailed(path: string, error: string): string;

package/dist/extension/browsers/browsers-lib/runtime-options.d.ts

@@ -9,4 +9,3 @@ export type BrowserLaunchRequest = Pick<PluginInterface & BrowserConfig, 'browse
 };
 export declare function buildBrowserLaunchRequest<T extends object = {}>(options: BrowserLaunchRequestSource, mode: 'development' | 'production' | 'none', extras?: T): BrowserLaunchRequest & T;
 export declare function toExtensionLoadList(extension: PluginInterface['extension']): string[];
-export declare function publishUserExtensionRoot(extension: PluginInterface['extension'], setExtensionRoot?: (root?: string) => void): void;

package/dist/extension/browsers/index.d.ts

@@ -57,7 +57,7 @@ export interface BrowserController {
 /**
  * Launch a browser with the given extension(s) loaded.
  *
- * Returns a `BrowserController` that provides reload and unified-logging control.
+ * Returns a `BrowserController` that provides unified-logging control.
  * This is the primary entry point for the CLI orchestration layer — it replaces
  * the old BrowsersPlugin that lived inside the bundler.
  */

package/dist/extension/browsers/run-chromium/chromium-context/index.d.ts

@@ -1,20 +1,6 @@
 import type { CDPExtensionController } from '../cdp/cdp-extension-controller';
 export type ChromiumContext = {
     getController(): CDPExtensionController | undefined;
-    onControllerReady(cb: (c: CDPExtensionController, port: number) => void): void;
-    setController(c: CDPExtensionController, port: number): void;
-    getPorts(): {
-        cdpPort?: number;
-    };
-    getExtensionRoot(): string | undefined;
-    setExtensionRoot(root?: string): void;
-    setServiceWorkerPaths(rel?: string, abs?: string): void;
-    getServiceWorkerPaths(): {
-        relativePath?: string;
-        absolutePath?: string;
-    };
-    setPendingReloadReason(reason?: 'manifest' | 'locales' | 'sw'): void;
-    getPendingReloadReason(): 'manifest' | 'locales' | 'sw' | undefined;
-    clearPendingReloadReason(): void;
+    setController(c: CDPExtensionController): void;
 };
 export declare function createChromiumContext(): ChromiumContext;

package/dist/extension/browsers/run-chromium/chromium-types.d.ts

@@ -33,10 +33,9 @@ export type CdpEvent = ConsoleAPICalledEvent | LogEntryAddedEvent | {
     method: string;
     params?: unknown;
 };
-export type PendingReason = 'manifest' | 'locales' | 'sw';
 export type Logger = BrowserLogger;
 /**
- * Options consumed by Chromium plugins (launch/logger/reload/inspection).
+ * Options consumed by Chromium plugins (launch/logger/inspection).
  * Narrowed from PluginInterface and specialized for Chromium path.
  */
 export interface ChromiumLaunchOptions extends Pick<PluginInterface, 'extension' | 'browser' | 'noOpen' | 'browserFlags' | 'excludeBrowserFlags' | 'profile' | 'persistProfile' | 'keepProfileChanges' | 'copyFromProfile' | 'preferences' | 'startingUrl' | 'chromiumBinary' | 'instanceId' | 'port' | 'dryRun' | 'logLevel' | 'logContexts' | 'logFormat' | 'logTimestamps' | 'logColor' | 'logUrl' | 'logTab'> {
@@ -190,11 +189,3 @@ export type ExtensionRootTreeResult = {
     truncated: boolean;
     tree: unknown;
 };
-declare global {
-    /**
-     * Dev-only hooks the Chromium inspection flow installs on `globalThis` to
-     * coordinate content-reload snapshots across the watch loop.
-     */
-    var __EXTJS_ON_CHROMIUM_CONTENT_RELOADED__: (() => Promise<void> | void) | undefined;
-    var __EXTJS_PENDING_CHROMIUM_CONTENT_RELOAD__: unknown;
-}

package/dist/extension/browsers/run-firefox/firefox-context/index.d.ts

@@ -1,23 +1,8 @@
 import type { BrowserLogger } from '../../browsers-types';
 import type { FirefoxRDPController } from '../rdp/rdp-extension-controller';
-export type PendingReason = 'manifest' | 'locales' | 'sw';
 export type FirefoxContext = {
     getController(): FirefoxRDPController | undefined;
-    onControllerReady(cb: (c: FirefoxRDPController, port: number) => void): void;
-    setController(c: FirefoxRDPController, port: number): void;
-    getPorts(): {
-        rdpPort?: number;
-    };
-    setExtensionRoot(root?: string): void;
-    getExtensionRoot(): string | undefined;
-    setServiceWorkerPaths(rel?: string, abs?: string): void;
-    getServiceWorkerPaths(): {
-        relativePath?: string;
-        absolutePath?: string;
-    };
-    setPendingReloadReason(reason?: PendingReason): void;
-    getPendingReloadReason(): PendingReason | undefined;
-    clearPendingReloadReason(): void;
+    setController(c: FirefoxRDPController): void;
     logger?: BrowserLogger;
     didLaunch?: boolean;
 };

package/dist/extension/browsers/run-firefox/rdp/remote-firefox/index.d.ts

@@ -5,7 +5,6 @@ export declare class RemoteFirefox {
     private client;
     private loggingAttached;
     private cachedAddonsActor;
-    private cachedSupportsReload;
     private lastInstalledAddonPath;
     private derivedExtensionId;
     private selectPrimaryAddonPath;

package/dist/extension/helpers/parent-watchdog.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Exit this process when the given parent pid dies (`--parent-pid`).
+ *
+ * Wrappers that spawn `extension dev` otherwise have to own the whole
+ * process group to guarantee teardown; when a wrapper dies HARD (SIGKILL,
+ * crash, CI reaper), the orphaned dev keeps watching and compiling, and the
+ * next session's builds race it inside one dist. Watching the parent pid
+ * directly closes that hole: on death we deliver SIGTERM to ourselves so the
+ * regular cleanup handlers (dev server stop, port manager, browser plugins)
+ * run, with a hard exit as backstop.
+ *
+ * Returns a cancel function.
+ */
+export declare function setupParentWatchdog(parentPid: number, options?: {
+    log?: (message: string) => void;
+    onDeath?: () => void;
+    pollIntervalMs?: number;
+}): () => void;
+export declare function parseParentPid(value: unknown): number | undefined;

package/package.json

@@ -38,7 +38,7 @@
     "extension": "./bin/extension.cjs"
   },
   "name": "extension",
-  "version": "4.0.11",
+  "version": "4.0.12",
   "description": "The cross-browser extension framework. Build Chrome, Edge, Firefox, and Safari extensions with no build configuration.",
   "homepage": "https://extension.js.org/",
   "bugs": {
@@ -109,9 +109,9 @@
     "vivaldi-location2": "2.1.0",
     "waterfox-location": "2.1.0",
     "yandex-location": "2.1.0",
-    "extension-create": "4.0.11",
-    "extension-develop": "4.0.11",
-    "extension-install": "4.0.11",
+    "extension-create": "4.0.12",
+    "extension-develop": "4.0.12",
+    "extension-install": "4.0.12",
     "commander": "^15.0.0",
     "pintor": "0.3.0",
     "semver": "^7.7.3",