extension 4.1.29 → 4.1.30

package/dist/597.cjs

@@ -193,6 +193,8 @@ exports.modules = {
         var external_node_path_ = __webpack_require__("node:path");
         var messaging = __webpack_require__("./helpers/messaging.ts");
         var banner = __webpack_require__("./browsers/browsers-lib/banner.ts");
+        var browser_family = __webpack_require__("./browsers/browsers-lib/browser-family.ts");
+        var companion_session = __webpack_require__("./browsers/browsers-lib/companion-session.ts");
         var messages = __webpack_require__("./browsers/browsers-lib/messages.ts");
         var newtab_override = __webpack_require__("./browsers/browsers-lib/newtab-override.ts");
         var ready_stamp = __webpack_require__("./browsers/browsers-lib/ready-stamp.ts");
@@ -828,7 +830,12 @@ exports.modules = {
             else obj[key] = value;
             return obj;
         }
-        const DEVTOOLS_COMPANION_ID_CHROMIUM = 'kgdaecdpfkikjncaalnmmnjjfpofkcbl';
+        function devtoolsCompanionWelcomeUrl(companionPath) {
+            return `chrome-extension://${(0, banner.vy)(companionPath)}/pages/welcome.html`;
+        }
+        const FORK_FIRST_RUN_PAGES = {
+            vivaldi: /^chrome-extension:\/\/mpognobbkildjkofajifpdfhcoklimli\/components\/welcome\//
+        };
         const __fileReadCache = new Map();
         function readTextFileCached(filePath) {
             try {
@@ -863,11 +870,32 @@ exports.modules = {
                     url
                 });
             }
+            async replaceForkFirstRunTabs(browser, replacementUrl) {
+                if (!this.cdp) return 0;
+                const pattern = FORK_FIRST_RUN_PAGES[String(browser || '').toLowerCase()];
+                if (!pattern) return 0;
+                const targets = await this.cdp.getTargets();
+                let replaced = 0;
+                for (const target of targets)if (target?.type === 'page') {
+                    if (pattern.test(String(target?.url || ''))) try {
+                        const attached = await this.cdp.sendCommand('Target.attachToTarget', {
+                            targetId: target.targetId,
+                            flatten: true
+                        });
+                        const sessionId = attached?.sessionId || '';
+                        if (!sessionId) continue;
+                        await this.cdp.sendCommand('Page.navigate', {
+                            url: replacementUrl
+                        }, sessionId);
+                        replaced += 1;
+                    } catch  {}
+                }
+                return replaced;
+            }
             async closeSelfOpenedTabs() {
                 if (!this.cdp) return 0;
-                const selfIds = new Set([
-                    DEVTOOLS_COMPANION_ID_CHROMIUM
-                ]);
+                const selfIds = new Set();
+                if (this.companionPath) selfIds.add((0, banner.vy)(this.companionPath));
                 for (const extensionPath of this.extensionPaths || [])if (external_node_path_.resolve(extensionPath) !== external_node_path_.resolve(this.outPath)) selfIds.add((0, banner.vy)(extensionPath));
                 const targets = await this.cdp.getTargets();
                 let closed = 0;
@@ -892,7 +920,8 @@ exports.modules = {
                     status: 'unknown'
                 };
                 const expectedId = (0, banner.vy)(this.outPath);
-                if (expectedId && (0, ensure.tg)(this.outPath)) {
+                const loadedFromCommandLine = !(0, browser_family.v$)(this.browser);
+                if (expectedId && loadedFromCommandLine && (0, ensure.tg)(this.outPath)) {
                     const present = await this.waitForExtensionTarget(expectedId, 12, 200);
                     if (present) {
                         if (!this.extensionId) this.extensionId = expectedId;
@@ -921,6 +950,25 @@ exports.modules = {
             getLoadRefusalReason() {
                 return this.loadRefusalReason;
             }
+            async loadCompanions(extensionPaths) {
+                if (!this.cdp) return [];
+                const results = [];
+                for (const extensionPath of extensionPaths){
+                    let outcome;
+                    try {
+                        outcome = await (0, ensure.iF)(this.cdp, extensionPath);
+                    } catch  {
+                        outcome = {
+                            status: 'unknown'
+                        };
+                    }
+                    results.push({
+                        path: extensionPath,
+                        outcome
+                    });
+                }
+                return results;
+            }
             async waitForExtensionTarget(extensionId, maxRetries, backoffMs) {
                 const prefix = `chrome-extension://${extensionId}/`;
                 for(let attempt = 0; attempt <= maxRetries; attempt++){
@@ -1136,9 +1184,11 @@ exports.modules = {
             }
             constructor(args){
                 cdp_extension_controller_define_property(this, "outPath", void 0);
+                cdp_extension_controller_define_property(this, "browser", void 0);
                 cdp_extension_controller_define_property(this, "cdpPort", void 0);
                 cdp_extension_controller_define_property(this, "profilePath", void 0);
                 cdp_extension_controller_define_property(this, "extensionPaths", void 0);
+                cdp_extension_controller_define_property(this, "companionPath", void 0);
                 cdp_extension_controller_define_property(this, "pipeIn", void 0);
                 cdp_extension_controller_define_property(this, "pipeOut", void 0);
                 cdp_extension_controller_define_property(this, "logSink", void 0);
@@ -1146,9 +1196,11 @@ exports.modules = {
                 cdp_extension_controller_define_property(this, "extensionId", null);
                 cdp_extension_controller_define_property(this, "loadRefusalReason", null);
                 this.outPath = args.outPath;
+                this.browser = args.browser;
                 this.cdpPort = args.cdpPort;
                 this.profilePath = args.profilePath;
                 this.extensionPaths = args.extensionPaths;
+                this.companionPath = args.companionPath;
                 this.pipeIn = args.pipeIn;
                 this.pipeOut = args.pipeOut;
                 this.logSink = args.logSink;
@@ -1162,6 +1214,7 @@ exports.modules = {
             const selectedExtensionPaths = extensionOutputPath && extensionOutputPath.length > 0 ? [
                 extensionOutputPath
             ] : extensionPaths;
+            const companionPath = extensionPaths.find(companion_session.Ck);
             const remoteDebugPortFlag = chromiumArgs.find((flag)=>flag.startsWith('--remote-debugging-port='));
             const chromeRemoteDebugPort = remoteDebugPortFlag ? parseInt(remoteDebugPortFlag.split('=')[1], 10) : (0, shared_utils.jl)(plugin.port, plugin.instanceId);
             const userDataDirFlag = chromiumArgs.find((flag)=>flag.startsWith('--user-data-dir='));
@@ -1173,10 +1226,11 @@ exports.modules = {
             }
             const cdpExtensionController = new CDPExtensionController({
                 outPath: extensionOutputPath,
-                browser: 'chromium-based' === plugin.browser ? 'chrome' : plugin.browser,
+                browser: plugin.browser,
                 cdpPort: chromeRemoteDebugPort,
                 profilePath: userDataDir || void 0,
                 extensionPaths: selectedExtensionPaths,
+                companionPath,
                 pipeIn: pipeStreams?.input,
                 pipeOut: pipeStreams?.output,
                 logSink: plugin.logSink
@@ -1344,9 +1398,18 @@ exports.modules = {
                     });
                 } catch  {}
             }
+            try {
+                if ((0, browser_family.v$)(plugin.browser)) {
+                    const results = await cdpExtensionController.loadCompanions((0, companion_session.xz)(extensionPaths, extensionOutputPath));
+                    if ((0, messaging._o)()) for (const { path: loadedPath, outcome } of results)(0, messaging._w)(`[CDP] companion ${loadedPath}: ${outcome.status}${'refused' === outcome.status ? ` (${outcome.reason})` : ''}`);
+                }
+            } catch  {}
             try {
                 if (extensionControllerInfo && !plugin.startingUrl && !plugin.noOpen && (0, newtab_override.c)(extensionOutputPath)) await cdpExtensionController.openTab('chrome://newtab/');
             } catch  {}
+            try {
+                if (extensionControllerInfo) await cdpExtensionController.replaceForkFirstRunTabs(plugin.browser, plugin.noOpen || !companionPath ? 'about:blank' : devtoolsCompanionWelcomeUrl(companionPath));
+            } catch  {}
             try {
                 if (plugin.noOpen) await cdpExtensionController.closeSelfOpenedTabs();
             } catch  {}

package/dist/browsers.cjs

@@ -289,6 +289,9 @@ var __webpack_modules__ = {
             'vivaldi',
             'yandex'
         ]);
+        const CDP_ONLY_EXTENSION_LOAD_BROWSERS = new Set([
+            'yandex'
+        ]);
         const FIREFOX_BROWSERS = new Set([
             'firefox',
             'waterfox',
@@ -304,6 +307,9 @@ var __webpack_modules__ = {
         function isSystemLocatedChromiumFork(browser) {
             return SYSTEM_LOCATED_CHROMIUM_FORKS.has(String(browser));
         }
+        function loadsExtensionsOverCdpOnly(browser) {
+            return CDP_ONLY_EXTENSION_LOAD_BROWSERS.has(String(browser));
+        }
         function isFirefoxBrowser(browser) {
             return FIREFOX_BROWSERS.has(String(browser));
         }
@@ -317,24 +323,48 @@ var __webpack_modules__ = {
             M_: ()=>isFirefoxBrowser,
             cA: ()=>isSystemLocatedChromiumFork,
             eP: ()=>isEmulatorBrowser,
-            rG: ()=>isChromiumBrowser
+            rG: ()=>isChromiumBrowser,
+            v$: ()=>loadsExtensionsOverCdpOnly
         });
     },
     "./browsers/browsers-lib/companion-session.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
         var node_fs__rspack_import_0 = __webpack_require__("node:fs");
         var node_path__rspack_import_1 = __webpack_require__("node:path");
         var _helpers_messaging__rspack_import_2 = __webpack_require__("./helpers/messaging.ts");
+        var _browser_family__rspack_import_3 = __webpack_require__("./browsers/browsers-lib/browser-family.ts");
         const COMPANION_SESSION_FLAGS_FILE = 'extension-js-session.json';
         const COMPANION_DIR_NAME = 'extension-js-devtools';
         function isDevtoolsCompanionPath(extensionPath) {
             return node_path__rspack_import_1.normalize(String(extensionPath || '')).split(/[\\/]+/).includes(COMPANION_DIR_NAME);
         }
+        function readManifest(extensionPath) {
+            try {
+                const parsed = JSON.parse(node_fs__rspack_import_0.readFileSync(node_path__rspack_import_1.join(extensionPath, 'manifest.json'), 'utf8'));
+                return parsed && 'object' == typeof parsed ? parsed : null;
+            } catch  {
+                return null;
+            }
+        }
+        function companionPathsForCdpLoad(extensionPaths, outPath) {
+            return extensionPaths.filter((extensionPath)=>{
+                if (node_path__rspack_import_1.resolve(extensionPath) === node_path__rspack_import_1.resolve(outPath)) return false;
+                return !readManifest(extensionPath)?.theme;
+            });
+        }
+        function dropNewTabOverride(extensionPath) {
+            const manifestPath = node_path__rspack_import_1.join(extensionPath, 'manifest.json');
+            const manifest = readManifest(extensionPath);
+            if (!manifest || !('chrome_url_overrides' in manifest)) return;
+            delete manifest.chrome_url_overrides;
+            node_fs__rspack_import_0.writeFileSync(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`, 'utf8');
+        }
         function stagedCompanionPath(stageRoot, companionPath) {
             return node_path__rspack_import_1.join(stageRoot, COMPANION_DIR_NAME, node_path__rspack_import_1.basename(companionPath));
         }
-        function stageCompanionForNoOpen(input) {
+        function stageCompanionForSession(input) {
             const { extensionPaths } = input;
-            if (!input.noOpen || !input.stageRoot) return extensionPaths;
+            const cdpOnly = (0, _browser_family__rspack_import_3.v$)(input.browser || '');
+            if (!input.noOpen && !cdpOnly || !input.stageRoot) return extensionPaths;
             const index = extensionPaths.findIndex((p)=>isDevtoolsCompanionPath(p));
             if (-1 === index) return extensionPaths;
             const source = extensionPaths[index];
@@ -349,11 +379,12 @@ var __webpack_modules__ = {
                     recursive: true
                 });
                 const flags = {
-                    noOpen: true
+                    noOpen: Boolean(input.noOpen)
                 };
                 node_fs__rspack_import_0.writeFileSync(node_path__rspack_import_1.join(staged, COMPANION_SESSION_FLAGS_FILE), `${JSON.stringify(flags)}\n`, 'utf8');
+                if (cdpOnly) dropNewTabOverride(staged);
             } catch (error) {
-                if ((0, _helpers_messaging__rspack_import_2._o)()) (0, _helpers_messaging__rspack_import_2.mR)(`[browser] Could not stage the devtools companion for --no-open: ${error?.message || String(error)}`);
+                if ((0, _helpers_messaging__rspack_import_2._o)()) (0, _helpers_messaging__rspack_import_2.mR)(`[browser] Could not stage the devtools companion for this session: ${error?.message || String(error)}`);
                 return extensionPaths;
             }
             const next = [
@@ -363,7 +394,9 @@ var __webpack_modules__ = {
             return next;
         }
         __webpack_require__.d(__webpack_exports__, {
-            Br: ()=>stageCompanionForNoOpen
+            Ck: ()=>isDevtoolsCompanionPath,
+            mO: ()=>stageCompanionForSession,
+            xz: ()=>companionPathsForCdpLoad
         });
     },
     "./browsers/browsers-lib/constants.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
@@ -1568,7 +1601,7 @@ var __webpack_modules__ = {
                 (0, _write_json_atomic__rspack_import_2.Z)(readyPath, ready);
             } catch  {}
         }
-        function stampReadyBrowserExited(extensionOutputPath, code) {
+        function stampReadyBrowserExited(extensionOutputPath, code, signal = null) {
             try {
                 if (!extensionOutputPath) return;
                 const readyPath = readyPathFor(extensionOutputPath);
@@ -1576,10 +1609,11 @@ var __webpack_modules__ = {
                 const ready = JSON.parse(node_fs__rspack_import_0.readFileSync(readyPath, 'utf-8'));
                 ready.browserExitedAt = new Date().toISOString();
                 ready.browserExitCode = code;
+                ready.browserExitSignal = signal;
                 if ('preview' === ready.command || 'start' === ready.command) {
                     ready.status = 'error';
                     ready.code = 'browser_exited';
-                    ready.message = `the ${ready.browser || 'browser'} process exited (code ${code ?? 'unknown'}); nothing is running`;
+                    ready.message = `the ${ready.browser || 'browser'} process exited (${null == code && signal ? `signal ${signal}` : `code ${code ?? 'unknown'}`}); nothing is running`;
                 }
                 (0, _write_json_atomic__rspack_import_2.Z)(readyPath, ready);
             } catch  {}
@@ -2857,6 +2891,18 @@ var __webpack_modules__ = {
         const edgeMasterPreferences = {
             ...masterPreferences
         };
+        const forkPreferences = {
+            vivaldi: {
+                vivaldi: {
+                    startup: {
+                        has_seen_welcome_page: true
+                    }
+                }
+            }
+        };
+        function getForkPreferences(browser) {
+            return forkPreferences[String(browser || '')] || {};
+        }
         const DEFAULT_BROWSER_FLAGS = [
             '--no-first-run',
             '--disable-client-side-phishing-detection',
@@ -2902,7 +2948,8 @@ var __webpack_modules__ = {
             return merged;
         }
         function getChromiumMasterPreferences(browser) {
-            return 'edge' === browser ? edgeMasterPreferences : chromeMasterPreferences;
+            const base = 'edge' === browser ? edgeMasterPreferences : chromeMasterPreferences;
+            return deepMergePreferences(base, getForkPreferences(browser));
         }
         function seedChromiumPreferences(profilePath, browser, customPreferences) {
             const preferencesPath = external_node_path_.join(profilePath, 'Default', 'Preferences');
@@ -2975,9 +3022,10 @@ var __webpack_modules__ = {
                     seedChromiumPreferences(userProfilePath, configOptions.browser, configOptions.preferences);
                 } catch  {}
             }
-            const extensionsForLaunch = (0, companion_session.Br)({
+            const extensionsForLaunch = (0, companion_session.mO)({
                 extensionPaths: extensionsToLoad,
                 noOpen: configOptions.noOpen,
+                browser: configOptions.browser,
                 stageRoot: userProfilePath || void 0,
                 provision
             });
@@ -3807,7 +3855,7 @@ var __webpack_modules__ = {
                         const how = null == code ? `signal ${signal || 'unknown'}` : `code ${code}`;
                         if (!(0, process_teardown.Op)(child)) {
                             this.logger.error(this.closeHandlerContext?.isDevMode ? `[browser] ${this.options.browser} exited mid-session (${how}). The dev server is still running but reloads cannot be delivered, restart "extension dev" to relaunch the browser.` : `[browser] ${this.options.browser} exited (${how}); the preview session is over.`);
-                            (0, ready_stamp.Wi)(this.closeHandlerContext?.extensionOutputPath, code);
+                            (0, ready_stamp.Wi)(this.closeHandlerContext?.extensionOutputPath, code, signal);
                         }
                         disposeSignalHandlers?.();
                         const userDataDir = launchArgs.find((arg)=>arg.startsWith('--user-data-dir='))?.slice('--user-data-dir='.length).replace(/^"|"$/g, '');
@@ -4425,7 +4473,7 @@ var __webpack_modules__ = {
                 const userJsContent = prefsToUserJs(prefs);
                 external_node_fs_.writeFileSync(userJsPath, userJsContent);
             } catch  {}
-            const extensionsToLoad = (0, companion_session.Br)({
+            const extensionsToLoad = (0, companion_session.mO)({
                 extensionPaths: configOptions.extension ? (0, runtime_options.fT)(configOptions.extension) : [],
                 noOpen: configOptions.noOpen,
                 stageRoot: profilePath || void 0,
@@ -6029,7 +6077,7 @@ var __webpack_modules__ = {
                 if ((0, messaging._o)()) this.ctx.logger?.info?.(messages.Th(this.host.browser));
                 if (!expected) {
                     this.ctx.logger?.error?.(`[browser] ${this.host.browser} exited (${null == code ? `signal ${signal || 'unknown'}` : `code ${code}`}) without being asked to. The add-on may have been rejected or the browser crashed; the session cannot be driven.`);
-                    (0, ready_stamp.Wi)(this.extensionOutputPath, code);
+                    (0, ready_stamp.Wi)(this.extensionOutputPath, code, signal ?? null);
                 }
                 this.cleanupInstance().catch((err)=>{
                     if ((0, messaging._o)()) this.ctx.logger?.error?.(`[browser] Cleanup error on child close: ${err?.message || err}`);

package/dist/cli.cjs

@@ -290,6 +290,9 @@ var __webpack_modules__ = {
             'vivaldi',
             'yandex'
         ]);
+        const CDP_ONLY_EXTENSION_LOAD_BROWSERS = new Set([
+            'yandex'
+        ]);
         const FIREFOX_BROWSERS = new Set([
             'firefox',
             'waterfox',
@@ -305,6 +308,9 @@ var __webpack_modules__ = {
         function isSystemLocatedChromiumFork(browser) {
             return SYSTEM_LOCATED_CHROMIUM_FORKS.has(String(browser));
         }
+        function loadsExtensionsOverCdpOnly(browser) {
+            return CDP_ONLY_EXTENSION_LOAD_BROWSERS.has(String(browser));
+        }
         function isFirefoxBrowser(browser) {
             return FIREFOX_BROWSERS.has(String(browser));
         }
@@ -318,24 +324,48 @@ var __webpack_modules__ = {
             M_: ()=>isFirefoxBrowser,
             cA: ()=>isSystemLocatedChromiumFork,
             eP: ()=>isEmulatorBrowser,
-            rG: ()=>isChromiumBrowser
+            rG: ()=>isChromiumBrowser,
+            v$: ()=>loadsExtensionsOverCdpOnly
         });
     },
     "./browsers/browsers-lib/companion-session.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
         var node_fs__rspack_import_0 = __webpack_require__("node:fs");
         var node_path__rspack_import_1 = __webpack_require__("node:path");
         var _helpers_messaging__rspack_import_2 = __webpack_require__("./helpers/messaging.ts");
+        var _browser_family__rspack_import_3 = __webpack_require__("./browsers/browsers-lib/browser-family.ts");
         const COMPANION_SESSION_FLAGS_FILE = 'extension-js-session.json';
         const COMPANION_DIR_NAME = 'extension-js-devtools';
         function isDevtoolsCompanionPath(extensionPath) {
             return node_path__rspack_import_1.normalize(String(extensionPath || '')).split(/[\\/]+/).includes(COMPANION_DIR_NAME);
         }
+        function readManifest(extensionPath) {
+            try {
+                const parsed = JSON.parse(node_fs__rspack_import_0.readFileSync(node_path__rspack_import_1.join(extensionPath, 'manifest.json'), 'utf8'));
+                return parsed && 'object' == typeof parsed ? parsed : null;
+            } catch  {
+                return null;
+            }
+        }
+        function companionPathsForCdpLoad(extensionPaths, outPath) {
+            return extensionPaths.filter((extensionPath)=>{
+                if (node_path__rspack_import_1.resolve(extensionPath) === node_path__rspack_import_1.resolve(outPath)) return false;
+                return !readManifest(extensionPath)?.theme;
+            });
+        }
+        function dropNewTabOverride(extensionPath) {
+            const manifestPath = node_path__rspack_import_1.join(extensionPath, 'manifest.json');
+            const manifest = readManifest(extensionPath);
+            if (!manifest || !('chrome_url_overrides' in manifest)) return;
+            delete manifest.chrome_url_overrides;
+            node_fs__rspack_import_0.writeFileSync(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`, 'utf8');
+        }
         function stagedCompanionPath(stageRoot, companionPath) {
             return node_path__rspack_import_1.join(stageRoot, COMPANION_DIR_NAME, node_path__rspack_import_1.basename(companionPath));
         }
-        function stageCompanionForNoOpen(input) {
+        function stageCompanionForSession(input) {
             const { extensionPaths } = input;
-            if (!input.noOpen || !input.stageRoot) return extensionPaths;
+            const cdpOnly = (0, _browser_family__rspack_import_3.v$)(input.browser || '');
+            if (!input.noOpen && !cdpOnly || !input.stageRoot) return extensionPaths;
             const index = extensionPaths.findIndex((p)=>isDevtoolsCompanionPath(p));
             if (-1 === index) return extensionPaths;
             const source = extensionPaths[index];
@@ -350,11 +380,12 @@ var __webpack_modules__ = {
                     recursive: true
                 });
                 const flags = {
-                    noOpen: true
+                    noOpen: Boolean(input.noOpen)
                 };
                 node_fs__rspack_import_0.writeFileSync(node_path__rspack_import_1.join(staged, COMPANION_SESSION_FLAGS_FILE), `${JSON.stringify(flags)}\n`, 'utf8');
+                if (cdpOnly) dropNewTabOverride(staged);
             } catch (error) {
-                if ((0, _helpers_messaging__rspack_import_2._o)()) (0, _helpers_messaging__rspack_import_2.mR)(`[browser] Could not stage the devtools companion for --no-open: ${error?.message || String(error)}`);
+                if ((0, _helpers_messaging__rspack_import_2._o)()) (0, _helpers_messaging__rspack_import_2.mR)(`[browser] Could not stage the devtools companion for this session: ${error?.message || String(error)}`);
                 return extensionPaths;
             }
             const next = [
@@ -364,7 +395,9 @@ var __webpack_modules__ = {
             return next;
         }
         __webpack_require__.d(__webpack_exports__, {
-            Br: ()=>stageCompanionForNoOpen
+            Ck: ()=>isDevtoolsCompanionPath,
+            mO: ()=>stageCompanionForSession,
+            xz: ()=>companionPathsForCdpLoad
         });
     },
     "./browsers/browsers-lib/constants.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
@@ -1569,7 +1602,7 @@ var __webpack_modules__ = {
                 (0, _write_json_atomic__rspack_import_2.Z)(readyPath, ready);
             } catch  {}
         }
-        function stampReadyBrowserExited(extensionOutputPath, code) {
+        function stampReadyBrowserExited(extensionOutputPath, code, signal = null) {
             try {
                 if (!extensionOutputPath) return;
                 const readyPath = readyPathFor(extensionOutputPath);
@@ -1577,10 +1610,11 @@ var __webpack_modules__ = {
                 const ready = JSON.parse(node_fs__rspack_import_0.readFileSync(readyPath, 'utf-8'));
                 ready.browserExitedAt = new Date().toISOString();
                 ready.browserExitCode = code;
+                ready.browserExitSignal = signal;
                 if ('preview' === ready.command || 'start' === ready.command) {
                     ready.status = 'error';
                     ready.code = 'browser_exited';
-                    ready.message = `the ${ready.browser || 'browser'} process exited (code ${code ?? 'unknown'}); nothing is running`;
+                    ready.message = `the ${ready.browser || 'browser'} process exited (${null == code && signal ? `signal ${signal}` : `code ${code ?? 'unknown'}`}); nothing is running`;
                 }
                 (0, _write_json_atomic__rspack_import_2.Z)(readyPath, ready);
             } catch  {}
@@ -2848,6 +2882,18 @@ var __webpack_modules__ = {
         const edgeMasterPreferences = {
             ...masterPreferences
         };
+        const forkPreferences = {
+            vivaldi: {
+                vivaldi: {
+                    startup: {
+                        has_seen_welcome_page: true
+                    }
+                }
+            }
+        };
+        function getForkPreferences(browser) {
+            return forkPreferences[String(browser || '')] || {};
+        }
         const DEFAULT_BROWSER_FLAGS = [
             '--no-first-run',
             '--disable-client-side-phishing-detection',
@@ -2893,7 +2939,8 @@ var __webpack_modules__ = {
             return merged;
         }
         function getChromiumMasterPreferences(browser) {
-            return 'edge' === browser ? edgeMasterPreferences : chromeMasterPreferences;
+            const base = 'edge' === browser ? edgeMasterPreferences : chromeMasterPreferences;
+            return deepMergePreferences(base, getForkPreferences(browser));
         }
         function seedChromiumPreferences(profilePath, browser, customPreferences) {
             const preferencesPath = external_node_path_.join(profilePath, 'Default', 'Preferences');
@@ -2966,9 +3013,10 @@ var __webpack_modules__ = {
                     seedChromiumPreferences(userProfilePath, configOptions.browser, configOptions.preferences);
                 } catch  {}
             }
-            const extensionsForLaunch = (0, companion_session.Br)({
+            const extensionsForLaunch = (0, companion_session.mO)({
                 extensionPaths: extensionsToLoad,
                 noOpen: configOptions.noOpen,
+                browser: configOptions.browser,
                 stageRoot: userProfilePath || void 0,
                 provision
             });
@@ -3798,7 +3846,7 @@ var __webpack_modules__ = {
                         const how = null == code ? `signal ${signal || 'unknown'}` : `code ${code}`;
                         if (!(0, process_teardown.Op)(child)) {
                             this.logger.error(this.closeHandlerContext?.isDevMode ? `[browser] ${this.options.browser} exited mid-session (${how}). The dev server is still running but reloads cannot be delivered, restart "extension dev" to relaunch the browser.` : `[browser] ${this.options.browser} exited (${how}); the preview session is over.`);
-                            (0, ready_stamp.Wi)(this.closeHandlerContext?.extensionOutputPath, code);
+                            (0, ready_stamp.Wi)(this.closeHandlerContext?.extensionOutputPath, code, signal);
                         }
                         disposeSignalHandlers?.();
                         const userDataDir = launchArgs.find((arg)=>arg.startsWith('--user-data-dir='))?.slice('--user-data-dir='.length).replace(/^"|"$/g, '');
@@ -4416,7 +4464,7 @@ var __webpack_modules__ = {
                 const userJsContent = prefsToUserJs(prefs);
                 external_node_fs_.writeFileSync(userJsPath, userJsContent);
             } catch  {}
-            const extensionsToLoad = (0, companion_session.Br)({
+            const extensionsToLoad = (0, companion_session.mO)({
                 extensionPaths: configOptions.extension ? (0, runtime_options.fT)(configOptions.extension) : [],
                 noOpen: configOptions.noOpen,
                 stageRoot: profilePath || void 0,
@@ -6020,7 +6068,7 @@ var __webpack_modules__ = {
                 if ((0, messaging._o)()) this.ctx.logger?.info?.(messages.Th(this.host.browser));
                 if (!expected) {
                     this.ctx.logger?.error?.(`[browser] ${this.host.browser} exited (${null == code ? `signal ${signal || 'unknown'}` : `code ${code}`}) without being asked to. The add-on may have been rejected or the browser crashed; the session cannot be driven.`);
-                    (0, ready_stamp.Wi)(this.extensionOutputPath, code);
+                    (0, ready_stamp.Wi)(this.extensionOutputPath, code, signal ?? null);
                 }
                 this.cleanupInstance().catch((err)=>{
                     if ((0, messaging._o)()) this.ctx.logger?.error?.(`[browser] Cleanup error on child close: ${err?.message || err}`);
@@ -7931,7 +7979,7 @@ var __webpack_modules__ = {
             return Math.min(Math.max(n, min), max);
         }
         const TEMPLATE_CORPUS_REPO = 'extension-js/examples';
-        const TEMPLATE_CORPUS_REF = '893a06ba86125ac721ca2df71e6eec7aba123e38';
+        const TEMPLATE_CORPUS_REF = '639c381c2bcf09b15fb442e22c251567dfa68c6a';
         const TEMPLATE_CORPUS_SLUGS = [
             'action',
             'action-locales',
@@ -9684,8 +9732,20 @@ Cross-browser compatibility
             needs_headed_window: messaging.Lp.E_HEADED_WINDOW_REQUIRED,
             needs_user_gesture: messaging.Lp.E_USER_GESTURE_REQUIRED,
             surface_not_open: messaging.Lp.E_TARGET_NOT_FOUND,
-            api_unavailable: messaging.Lp.E_NOT_IMPLEMENTED
+            surface_reply_failed: messaging.Lp.E_INTERNAL,
+            api_unavailable: messaging.Lp.E_NOT_IMPLEMENTED,
+            url_refused: messaging.Lp.E_ARGS,
+            tab_not_found: messaging.Lp.E_TARGET_NOT_FOUND
         };
+        const URL_REFUSED_HINT_GECKO = "Firefox refuses privileged pages (about:newtab, about:config, about:addons, and chrome:, file:, data: and javascript: urls) from an extension's tabs API. Only web urls and about:blank open this way. Open the extension's own pages by their moz-extension:// url instead.";
+        const URL_REFUSED_HINT_CHROMIUM = "Chromium refuses javascript: urls from an extension's tabs API. To run code in a page, use extension eval --context content --tab <id> on a session started with --allow-eval.";
+        const URL_REFUSED_HINT_GENERIC = "The browser refuses this url from an extension's tabs API. Web urls and about:blank open on every engine.";
+        function urlRefusedHint(engine) {
+            if ('firefox' === engine) return URL_REFUSED_HINT_GECKO;
+            if ('chromium' === engine) return URL_REFUSED_HINT_CHROMIUM;
+            return URL_REFUSED_HINT_GENERIC;
+        }
+        const TAB_NOT_FOUND_HINT = "List the open tabs and their ids with extension inspect --list-tabs, or drop --tab to target the active tab.";
         function codeForBridgeError(name, message, refusal) {
             if (refusal && refusal in REFUSAL_TO_CODE) return REFUSAL_TO_CODE[refusal];
             if ('Timeout' === name) return messaging.Lp.E_TIMEOUT;
@@ -9694,7 +9754,7 @@ Cross-browser compatibility
             if ('EvalDisabled' === name || 'EvalTokenMismatch' === name || 'Forbidden' === name) return messaging.Lp.E_EVAL_REFUSED;
             if ('TargetNotFound' === name) return messaging.Lp.E_TARGET_NOT_FOUND;
             if ('BadRequest' === name) return messaging.Lp.E_ARGS;
-            if ('Unsupported' === name) return /needs a --tab id|is not open/i.test(message) ? messaging.Lp.E_TARGET_NOT_FOUND : messaging.Lp.E_NOT_IMPLEMENTED;
+            if ('Unsupported' === name) return /needs a --tab id|is not open|no open tab matches|no active tab/i.test(message) ? messaging.Lp.E_TARGET_NOT_FOUND : messaging.Lp.E_NOT_IMPLEMENTED;
             if ('EvalError' === name) return messaging.Lp.E_EVAL;
             if ('InspectError' === name) return messaging.Lp.E_INSPECT;
             if ('StorageError' === name) return messaging.Lp.E_STORAGE;
@@ -9721,7 +9781,7 @@ Cross-browser compatibility
             const message = 'string' == typeof raw.message ? raw.message : 'command failed';
             const refusal = 'string' == typeof raw.code ? raw.code : void 0;
             const code = codeForBridgeError(name, message, refusal);
-            const hint = 'string' == typeof raw.hint ? raw.hint : code === messaging.Lp.E_EVAL ? 'The expression threw inside the page. Check the expression itself.' : code === messaging.Lp.E_USER_GESTURE_REQUIRED ? "The browser opens this surface only in response to a click, and refuses to open it any other way. Click the extension in the browser toolbar to open it." : void 0;
+            const hint = 'string' == typeof raw.hint ? raw.hint : 'url_refused' === refusal ? urlRefusedHint(raw.engine) : 'tab_not_found' === refusal ? TAB_NOT_FOUND_HINT : code === messaging.Lp.E_EVAL ? 'The expression threw inside the page. Check the expression itself.' : code === messaging.Lp.E_USER_GESTURE_REQUIRED ? "The browser opens this surface only in response to a click, and refuses to open it any other way. Click the extension in the browser toolbar to open it." : void 0;
             return {
                 ...extras,
                 ...messaging.Pr.fail(command, statusForCode(code), {
@@ -9993,7 +10053,17 @@ Cross-browser compatibility
                     output: opts.output
                 });
             });
-            commonOptions(program.command('reload').arguments('[project-path]').description(commandDescriptions.reload).option('--context <background|content|page>', 'target context (default background)').option('--tab <id>', 'for content/page: a specific tab')).action(async (projectPathArg, opts)=>{
+            commonOptions(program.command('reload').arguments('[project-path]').description(commandDescriptions.reload).option('--context <background|content|page>', 'target context (default background)').option('--url <pattern>', 'for content/page: document to target (resolved to its tab)').option('--tab <id>', 'for content/page: a specific tab (default: the --url match, else the active tab)')).action(async (projectPathArg, opts)=>{
+                const context = opts.context || 'background';
+                if (![
+                    'background',
+                    'content',
+                    'page'
+                ].includes(context)) fail(`reload takes --context background, content or page (got ${context}). A ${context} page reloads with the extension: run extension reload without --context.`, {
+                    command: 'reload',
+                    code: messaging.Lp.E_ARGS,
+                    output: opts.output
+                });
                 await runCommand({
                     projectPathArg,
                     command: 'reload',

package/dist/extension/browsers/browsers-lib/browser-family.d.ts

@@ -1,9 +1,11 @@
 import type { BrowserType } from '../browsers-types.js';
 export declare const CHROMIUM_BROWSERS: ReadonlySet<string>;
 export declare const SYSTEM_LOCATED_CHROMIUM_FORKS: ReadonlySet<string>;
+export declare const CDP_ONLY_EXTENSION_LOAD_BROWSERS: ReadonlySet<string>;
 export declare const FIREFOX_BROWSERS: ReadonlySet<string>;
 export declare function isChromiumBrowser(browser: BrowserType | string): boolean;
 export declare function isSystemLocatedChromiumFork(browser: BrowserType | string): boolean;
+export declare function loadsExtensionsOverCdpOnly(browser: BrowserType | string): boolean;
 export declare function isFirefoxBrowser(browser: BrowserType | string): boolean;
 export declare const EMULATOR_BROWSERS: ReadonlySet<string>;
 export declare function isEmulatorBrowser(browser: BrowserType | string): boolean;

package/dist/extension/browsers/browsers-lib/companion-session.d.ts

@@ -3,10 +3,12 @@ export interface CompanionSessionFlags {
     noOpen: boolean;
 }
 export declare function isDevtoolsCompanionPath(extensionPath: string): boolean;
+export declare function companionPathsForCdpLoad(extensionPaths: string[], outPath: string): string[];
 export declare function stagedCompanionPath(stageRoot: string, companionPath: string): string;
-export declare function stageCompanionForNoOpen(input: {
+export declare function stageCompanionForSession(input: {
     extensionPaths: string[];
     noOpen?: boolean;
+    browser?: string;
     stageRoot?: string;
     provision?: boolean;
 }): string[];

package/dist/extension/browsers/browsers-lib/ready-stamp.d.ts

@@ -16,4 +16,4 @@ export declare function stampReadyProfileLocked(extensionOutputPath: string | un
         pid: number;
     };
 }): void;
-export declare function stampReadyBrowserExited(extensionOutputPath: string | undefined, code: number | null): void;
+export declare function stampReadyBrowserExited(extensionOutputPath: string | undefined, code: number | null, signal?: string | null): void;

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

@@ -8,11 +8,14 @@ interface ExtensionInfoResult {
     name?: string;
     version?: string;
 }
+export declare function devtoolsCompanionWelcomeUrl(companionPath: string): string;
 export declare class CDPExtensionController {
     private readonly outPath;
+    private readonly browser;
     private readonly cdpPort;
     private readonly profilePath?;
     private readonly extensionPaths?;
+    private readonly companionPath?;
     private readonly pipeIn?;
     private readonly pipeOut?;
     private readonly logSink?;
@@ -21,10 +24,11 @@ export declare class CDPExtensionController {
     private loadRefusalReason;
     constructor(args: {
         outPath: string;
-        browser: 'chrome' | 'edge' | 'chromium-based';
+        browser: string;
         cdpPort: number;
         profilePath?: string;
         extensionPaths?: string[];
+        companionPath?: string;
         pipeIn?: Readable;
         pipeOut?: Writable;
         logSink?: BrowserLogSink;
@@ -32,9 +36,14 @@ export declare class CDPExtensionController {
     connect(): Promise<void>;
     ensureDeveloperMode(): Promise<DeveloperModeOutcome>;
     openTab(url: string): Promise<void>;
+    replaceForkFirstRunTabs(browser: string, replacementUrl: string): Promise<number>;
     closeSelfOpenedTabs(): Promise<number>;
     verifyGuestLoaded(): Promise<LoadUnpackedOutcome>;
     getLoadRefusalReason(): string | null;
+    loadCompanions(extensionPaths: string[]): Promise<Array<{
+        path: string;
+        outcome: LoadUnpackedOutcome;
+    }>>;
     private waitForExtensionTarget;
     ensureLoaded(): Promise<ExtensionInfoResult>;
     private deriveExtensionIdFromTargets;

package/dist/extension/browsers/run-chromium/chromium-launch/browser-config.d.ts

@@ -1,5 +1,6 @@
 import type { CompilationLike, DefaultBrowserFlags, PluginInterface } from '../../browsers-types.js';
 export declare const DEFAULT_BROWSER_FLAGS: DefaultBrowserFlags[];
+export declare function getChromiumMasterPreferences(browser: PluginInterface['browser']): Record<string, unknown>;
 export interface BrowserConfigMode {
     provision?: boolean;
 }

package/dist/extension/browsers/run-chromium/chromium-launch/master-preferences.d.ts

@@ -160,4 +160,5 @@ declare const edgeMasterPreferences: {
         enabled: boolean;
     };
 };
+export declare function getForkPreferences(browser?: string): Record<string, unknown>;
 export { chromeMasterPreferences, edgeMasterPreferences };

package/dist/extension/helpers/template-catalog.d.ts

@@ -1,6 +1,6 @@
 export declare const DEFAULT_TEMPLATE = "typescript";
 export declare const BUNDLED_TEMPLATES: readonly string[];
-export declare const TEMPLATE_CATALOG_URL = "https://github.com/extension-js/examples/tree/893a06ba86125ac721ca2df71e6eec7aba123e38/examples";
+export declare const TEMPLATE_CATALOG_URL = "https://github.com/extension-js/examples/tree/639c381c2bcf09b15fb442e22c251567dfa68c6a/examples";
 export interface TemplateGroup {
     title: string;
     summary: string;

package/dist/extension/helpers/template-corpus.generated.d.ts

@@ -1,3 +1,3 @@
 export declare const TEMPLATE_CORPUS_REPO = "extension-js/examples";
-export declare const TEMPLATE_CORPUS_REF = "893a06ba86125ac721ca2df71e6eec7aba123e38";
+export declare const TEMPLATE_CORPUS_REF = "639c381c2bcf09b15fb442e22c251567dfa68c6a";
 export declare const TEMPLATE_CORPUS_SLUGS: readonly string[];

package/package.json

@@ -38,7 +38,7 @@
     "extension": "./bin/extension.cjs"
   },
   "name": "extension",
-  "version": "4.1.29",
+  "version": "4.1.30",
   "description": "The cross-browser extension framework. Build Chrome, Edge, Firefox, and Safari extensions with no build configuration.",
   "homepage": "https://extension.js.org/",
   "funding": "https://github.com/sponsors/cezaraugusto",
@@ -104,9 +104,9 @@
     "chromium-location": "2.1.2",
     "commander": "^15.0.0",
     "edge-location": "2.3.1",
-    "extension-create": "4.1.29",
-    "extension-develop": "4.1.29",
-    "extension-install": "4.1.29",
+    "extension-create": "4.1.30",
+    "extension-develop": "4.1.30",
+    "extension-install": "4.1.30",
     "firefox-location2": "3.2.0",
     "floorp-location": "1.0.0",
     "librewolf-location": "1.2.1",