extension 4.1.28 → 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

@@ -283,6 +283,15 @@ var __webpack_modules__ = {
             'yandex',
             'chromium-based'
         ]);
+        const SYSTEM_LOCATED_CHROMIUM_FORKS = new Set([
+            'brave',
+            'opera',
+            'vivaldi',
+            'yandex'
+        ]);
+        const CDP_ONLY_EXTENSION_LOAD_BROWSERS = new Set([
+            'yandex'
+        ]);
         const FIREFOX_BROWSERS = new Set([
             'firefox',
             'waterfox',
@@ -295,6 +304,12 @@ var __webpack_modules__ = {
         function isChromiumBrowser(browser) {
             return CHROMIUM_BROWSERS.has(String(browser));
         }
+        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));
         }
@@ -306,25 +321,50 @@ var __webpack_modules__ = {
         }
         __webpack_require__.d(__webpack_exports__, {
             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];
@@ -339,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 = [
@@ -353,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__) {
@@ -572,6 +615,10 @@ var __webpack_modules__ = {
             const steps = String(guidance || '').split('\n').map((line)=>line.trimEnd()).filter((line)=>line && !/^We couldn't find/i.test(line)).filter((line)=>!/^Re-run your command/i.test(line)).join('\n');
             return `${getLoggingPrefix('error')} ${capitalizedBrowserName(browser)} isn't installed.\n${steps}\nOr point at a binary with ${pintor__rspack_import_8_default().blue('--gecko-binary')} ${pintor__rspack_import_8_default().gray('<path>')}, or choose another browser with ${pintor__rspack_import_8_default().blue('--browser')} ${pintor__rspack_import_8_default().gray('<firefox|waterfox|librewolf|zen|floorp>')}.`;
         }
+        function chromiumForkNotInstalled(browser, guidance) {
+            const steps = String(guidance || '').split('\n').map((line)=>line.trimEnd()).filter((line)=>line && !/^We couldn't find/i.test(line)).filter((line)=>!/^Re-run your command/i.test(line)).join('\n');
+            return `${getLoggingPrefix('error')} ${capitalizedBrowserName(browser)} isn't installed.\n${steps}\nOr point at a binary with ${pintor__rspack_import_8_default().blue('--chromium-binary')} ${pintor__rspack_import_8_default().gray('<path>')}, or choose another browser with ${pintor__rspack_import_8_default().blue('--browser')} ${pintor__rspack_import_8_default().gray('<chrome|chromium|edge|brave|opera|vivaldi|yandex>')}.`;
+        }
         function usingManagedChromiumFamilyFallback(requestedBrowser, _fallbackBrowser, _binaryPath) {
             return `${getLoggingPrefix('warn')} ${managedBrowserDisplayName(requestedBrowser)} isn't installed.\nRun ${pintor__rspack_import_8_default().blue(`npx extension install ${requestedBrowser}`)} to use ${managedBrowserDisplayName(requestedBrowser)} itself.`;
         }
@@ -1018,6 +1065,7 @@ var __webpack_modules__ = {
             Gq: ()=>locatingBrowser,
             H1: ()=>safariRegenerationDiscards,
             HH: ()=>messageWithoutSenderError,
+            I5: ()=>chromiumForkNotInstalled,
             Ih: ()=>browserNotInstalledError,
             JB: ()=>devChannelSnapshotInUse,
             KP: ()=>safariBuildCalled,
@@ -1553,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);
@@ -1561,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  {}
@@ -2465,6 +2514,7 @@ var __webpack_modules__ = {
         var external_yandex_location_default = /*#__PURE__*/ __webpack_require__.n(external_yandex_location_namespaceObject);
         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");
         const external_node_readline_namespaceObject = require("node:readline");
         var external_node_readline_default = /*#__PURE__*/ __webpack_require__.n(external_node_readline_namespaceObject);
         var browser_install_outcome = __webpack_require__("./helpers/browser-install-outcome.ts");
@@ -2841,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',
@@ -2886,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');
@@ -2959,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
             });
@@ -3012,6 +3076,27 @@ var __webpack_modules__ = {
             (0, messaging._w)(messages.E8(chromiumConfig.join(' ')));
         }
         var extension_output_path = __webpack_require__("./browsers/run-chromium/chromium-launch/extension-output-path.ts");
+        function chromiumForkInstallGuidance(browser) {
+            const read = (fn)=>{
+                try {
+                    return fn();
+                } catch  {
+                    return '';
+                }
+            };
+            switch(browser){
+                case 'brave':
+                    return read(()=>(0, external_brave_location_namespaceObject.getInstallGuidance)());
+                case 'opera':
+                    return read(()=>(0, external_opera_location2_namespaceObject.getInstallGuidance)());
+                case 'vivaldi':
+                    return read(()=>(0, external_vivaldi_location2_namespaceObject.getInstallGuidance)());
+                case 'yandex':
+                    return read(()=>(0, external_yandex_location_namespaceObject.getInstallGuidance)());
+                default:
+                    return null;
+            }
+        }
         const activeInstances = new Set();
         let globalHandlersInstalled = false;
         function cleanupOne(instance) {
@@ -3293,6 +3378,7 @@ var __webpack_modules__ = {
                 };
                 const isUsableBinary = (p)=>Boolean(p && external_node_fs_.existsSync(p));
                 const resolveManagedBinary = ()=>{
+                    if ((0, browser_family.cA)(browser)) return null;
                     try {
                         const resolved = output_binaries_resolver.kI(compilation, 'chromium' === browser || 'chromium-based' === browser ? 'chromium' : 'edge' === browser ? 'edge' : 'chrome');
                         const normalized = normalizePath(resolved || null);
@@ -3567,7 +3653,10 @@ var __webpack_modules__ = {
                     }
                     if (!browserBinaryLocation || !external_node_fs_.existsSync(browserBinaryLocation)) {
                         if ('chromium' === browser || 'chromium-based' === browser) printInstallGuidance(getInstallGuidanceText('chromium'), 'chromium');
-                        if (!printedGuidance && 'chromium' !== browser && 'chromium-based' !== browser) this.logger.error(messages.Ih(browser, browserBinaryLocation || ''));
+                        if (!printedGuidance && 'chromium' !== browser && 'chromium-based' !== browser) {
+                            const forkGuidance = chromiumForkInstallGuidance(browser);
+                            this.logger.error(null !== forkGuidance ? messages.I5(browser, forkGuidance) : messages.Ih(browser, browserBinaryLocation || ''));
+                        }
                         if (process.env.VITEST || process.env.VITEST_WORKER_ID) throw new Error('Browser not installed or binary path not found');
                         process.exit(1);
                     }
@@ -3766,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, '');
@@ -4293,9 +4382,25 @@ var __webpack_modules__ = {
             'security.enterprise_roots.enabled': true,
             'xpinstall.signatures.required': false
         };
-        function getPreferences(customPrefs) {
+        const forkPreferences = {
+            zen: {
+                'zen.welcome-screen.seen': true,
+                'zen.updates.show-update-notification': false
+            },
+            floorp: {
+                'floorp.browser.welcome.page.shown': true,
+                'floorp.releaseNotes.mode': 'disabled',
+                'floorp.releaseNotes.choiceConfirmed': true,
+                'floorp.releaseNotes.promptShown': true
+            }
+        };
+        function getForkPreferences(browser) {
+            return forkPreferences[String(browser || '')] || {};
+        }
+        function getPreferences(customPrefs, browser) {
             return {
                 ...masterPreferences,
+                ...getForkPreferences(browser),
                 ...customPrefs
             };
         }
@@ -4354,7 +4459,7 @@ var __webpack_modules__ = {
                 } catch  {}
             }
             if (profilePath && provision) try {
-                const prefs = getPreferences(configOptions?.preferences || {});
+                const prefs = getPreferences(configOptions?.preferences || {}, String(browser));
                 function serializeValue(value) {
                     if ('string' == typeof value) return JSON.stringify(value);
                     if ('boolean' == typeof value) return String(value);
@@ -4368,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,
@@ -5843,6 +5948,8 @@ var __webpack_modules__ = {
                     (0, ready_stamp.M)(this.extensionOutputPath, {
                         profilePath,
                         browserPid: this.child?.pid,
+                        binary: this.child?.spawnfile || binary,
+                        binaryProvenance: this.host.launchBinaryProvenance,
                         extensionId: this.extensionOutputPath ? (0, banner.MT)(this.extensionOutputPath) : void 0
                     });
                     this.wireChildLifecycle();
@@ -5879,6 +5986,8 @@ var __webpack_modules__ = {
                     this.child = await this.spawnFirefoxChild(plan.binary, plan.args, wslFallbackBinary);
                     (0, ready_stamp.M)(this.extensionOutputPath, {
                         browserPid: this.child?.pid,
+                        binary: this.child?.spawnfile || plan.binary,
+                        binaryProvenance: this.host.launchBinaryProvenance,
                         extensionId: this.extensionOutputPath ? (0, banner.MT)(this.extensionOutputPath) : void 0
                     });
                     this.wireChildLifecycle();
@@ -5968,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}`);
@@ -7029,7 +7138,7 @@ var __webpack_modules__ = {
             const display = browserDisplayName(browser);
             const line = String(versionLine || '').trim();
             if (!line) return display;
-            if (!/[a-zA-Z]/.test(line)) return `${display} ${line}`;
+            if (/^v?\d+(?:\.\d+)*(?:[a-z]+\d*)?$/i.test(line)) return `${display} ${line}`;
             return line.charAt(0).toUpperCase() + line.slice(1);
         }
         const CARD_KEYS_ENV = 'EXTENSION_CLI_CARD_KEYS';

package/dist/cli.cjs

@@ -284,6 +284,15 @@ var __webpack_modules__ = {
             'yandex',
             'chromium-based'
         ]);
+        const SYSTEM_LOCATED_CHROMIUM_FORKS = new Set([
+            'brave',
+            'opera',
+            'vivaldi',
+            'yandex'
+        ]);
+        const CDP_ONLY_EXTENSION_LOAD_BROWSERS = new Set([
+            'yandex'
+        ]);
         const FIREFOX_BROWSERS = new Set([
             'firefox',
             'waterfox',
@@ -296,6 +305,12 @@ var __webpack_modules__ = {
         function isChromiumBrowser(browser) {
             return CHROMIUM_BROWSERS.has(String(browser));
         }
+        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));
         }
@@ -307,25 +322,50 @@ var __webpack_modules__ = {
         }
         __webpack_require__.d(__webpack_exports__, {
             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];
@@ -340,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 = [
@@ -354,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__) {
@@ -573,6 +616,10 @@ var __webpack_modules__ = {
             const steps = String(guidance || '').split('\n').map((line)=>line.trimEnd()).filter((line)=>line && !/^We couldn't find/i.test(line)).filter((line)=>!/^Re-run your command/i.test(line)).join('\n');
             return `${getLoggingPrefix('error')} ${capitalizedBrowserName(browser)} isn't installed.\n${steps}\nOr point at a binary with ${pintor__rspack_import_8_default().blue('--gecko-binary')} ${pintor__rspack_import_8_default().gray('<path>')}, or choose another browser with ${pintor__rspack_import_8_default().blue('--browser')} ${pintor__rspack_import_8_default().gray('<firefox|waterfox|librewolf|zen|floorp>')}.`;
         }
+        function chromiumForkNotInstalled(browser, guidance) {
+            const steps = String(guidance || '').split('\n').map((line)=>line.trimEnd()).filter((line)=>line && !/^We couldn't find/i.test(line)).filter((line)=>!/^Re-run your command/i.test(line)).join('\n');
+            return `${getLoggingPrefix('error')} ${capitalizedBrowserName(browser)} isn't installed.\n${steps}\nOr point at a binary with ${pintor__rspack_import_8_default().blue('--chromium-binary')} ${pintor__rspack_import_8_default().gray('<path>')}, or choose another browser with ${pintor__rspack_import_8_default().blue('--browser')} ${pintor__rspack_import_8_default().gray('<chrome|chromium|edge|brave|opera|vivaldi|yandex>')}.`;
+        }
         function usingManagedChromiumFamilyFallback(requestedBrowser, _fallbackBrowser, _binaryPath) {
             return `${getLoggingPrefix('warn')} ${managedBrowserDisplayName(requestedBrowser)} isn't installed.\nRun ${pintor__rspack_import_8_default().blue(`npx extension install ${requestedBrowser}`)} to use ${managedBrowserDisplayName(requestedBrowser)} itself.`;
         }
@@ -1019,6 +1066,7 @@ var __webpack_modules__ = {
             Gq: ()=>locatingBrowser,
             H1: ()=>safariRegenerationDiscards,
             HH: ()=>messageWithoutSenderError,
+            I5: ()=>chromiumForkNotInstalled,
             Ih: ()=>browserNotInstalledError,
             JB: ()=>devChannelSnapshotInUse,
             KP: ()=>safariBuildCalled,
@@ -1554,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);
@@ -1562,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  {}
@@ -2456,6 +2505,7 @@ var __webpack_modules__ = {
         var external_yandex_location_default = /*#__PURE__*/ __webpack_require__.n(external_yandex_location_namespaceObject);
         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");
         const external_node_readline_namespaceObject = require("node:readline");
         var external_node_readline_default = /*#__PURE__*/ __webpack_require__.n(external_node_readline_namespaceObject);
         var browser_install_outcome = __webpack_require__("./helpers/browser-install-outcome.ts");
@@ -2832,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',
@@ -2877,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');
@@ -2950,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
             });
@@ -3003,6 +3067,27 @@ var __webpack_modules__ = {
             (0, messaging._w)(messages.E8(chromiumConfig.join(' ')));
         }
         var extension_output_path = __webpack_require__("./browsers/run-chromium/chromium-launch/extension-output-path.ts");
+        function chromiumForkInstallGuidance(browser) {
+            const read = (fn)=>{
+                try {
+                    return fn();
+                } catch  {
+                    return '';
+                }
+            };
+            switch(browser){
+                case 'brave':
+                    return read(()=>(0, external_brave_location_namespaceObject.getInstallGuidance)());
+                case 'opera':
+                    return read(()=>(0, external_opera_location2_namespaceObject.getInstallGuidance)());
+                case 'vivaldi':
+                    return read(()=>(0, external_vivaldi_location2_namespaceObject.getInstallGuidance)());
+                case 'yandex':
+                    return read(()=>(0, external_yandex_location_namespaceObject.getInstallGuidance)());
+                default:
+                    return null;
+            }
+        }
         const activeInstances = new Set();
         let globalHandlersInstalled = false;
         function cleanupOne(instance) {
@@ -3284,6 +3369,7 @@ var __webpack_modules__ = {
                 };
                 const isUsableBinary = (p)=>Boolean(p && external_node_fs_.existsSync(p));
                 const resolveManagedBinary = ()=>{
+                    if ((0, browser_family.cA)(browser)) return null;
                     try {
                         const resolved = output_binaries_resolver.kI(compilation, 'chromium' === browser || 'chromium-based' === browser ? 'chromium' : 'edge' === browser ? 'edge' : 'chrome');
                         const normalized = normalizePath(resolved || null);
@@ -3558,7 +3644,10 @@ var __webpack_modules__ = {
                     }
                     if (!browserBinaryLocation || !external_node_fs_.existsSync(browserBinaryLocation)) {
                         if ('chromium' === browser || 'chromium-based' === browser) printInstallGuidance(getInstallGuidanceText('chromium'), 'chromium');
-                        if (!printedGuidance && 'chromium' !== browser && 'chromium-based' !== browser) this.logger.error(messages.Ih(browser, browserBinaryLocation || ''));
+                        if (!printedGuidance && 'chromium' !== browser && 'chromium-based' !== browser) {
+                            const forkGuidance = chromiumForkInstallGuidance(browser);
+                            this.logger.error(null !== forkGuidance ? messages.I5(browser, forkGuidance) : messages.Ih(browser, browserBinaryLocation || ''));
+                        }
                         if (process.env.VITEST || process.env.VITEST_WORKER_ID) throw new Error('Browser not installed or binary path not found');
                         process.exit(1);
                     }
@@ -3757,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, '');
@@ -4284,9 +4373,25 @@ var __webpack_modules__ = {
             'security.enterprise_roots.enabled': true,
             'xpinstall.signatures.required': false
         };
-        function getPreferences(customPrefs) {
+        const forkPreferences = {
+            zen: {
+                'zen.welcome-screen.seen': true,
+                'zen.updates.show-update-notification': false
+            },
+            floorp: {
+                'floorp.browser.welcome.page.shown': true,
+                'floorp.releaseNotes.mode': 'disabled',
+                'floorp.releaseNotes.choiceConfirmed': true,
+                'floorp.releaseNotes.promptShown': true
+            }
+        };
+        function getForkPreferences(browser) {
+            return forkPreferences[String(browser || '')] || {};
+        }
+        function getPreferences(customPrefs, browser) {
             return {
                 ...masterPreferences,
+                ...getForkPreferences(browser),
                 ...customPrefs
             };
         }
@@ -4345,7 +4450,7 @@ var __webpack_modules__ = {
                 } catch  {}
             }
             if (profilePath && provision) try {
-                const prefs = getPreferences(configOptions?.preferences || {});
+                const prefs = getPreferences(configOptions?.preferences || {}, String(browser));
                 function serializeValue(value) {
                     if ('string' == typeof value) return JSON.stringify(value);
                     if ('boolean' == typeof value) return String(value);
@@ -4359,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,
@@ -5834,6 +5939,8 @@ var __webpack_modules__ = {
                     (0, ready_stamp.M)(this.extensionOutputPath, {
                         profilePath,
                         browserPid: this.child?.pid,
+                        binary: this.child?.spawnfile || binary,
+                        binaryProvenance: this.host.launchBinaryProvenance,
                         extensionId: this.extensionOutputPath ? (0, banner.MT)(this.extensionOutputPath) : void 0
                     });
                     this.wireChildLifecycle();
@@ -5870,6 +5977,8 @@ var __webpack_modules__ = {
                     this.child = await this.spawnFirefoxChild(plan.binary, plan.args, wslFallbackBinary);
                     (0, ready_stamp.M)(this.extensionOutputPath, {
                         browserPid: this.child?.pid,
+                        binary: this.child?.spawnfile || plan.binary,
+                        binaryProvenance: this.host.launchBinaryProvenance,
                         extensionId: this.extensionOutputPath ? (0, banner.MT)(this.extensionOutputPath) : void 0
                     });
                     this.wireChildLifecycle();
@@ -5959,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}`);
@@ -7073,7 +7182,7 @@ var __webpack_modules__ = {
             const display = browserDisplayName(browser);
             const line = String(versionLine || '').trim();
             if (!line) return display;
-            if (!/[a-zA-Z]/.test(line)) return `${display} ${line}`;
+            if (/^v?\d+(?:\.\d+)*(?:[a-z]+\d*)?$/i.test(line)) return `${display} ${line}`;
             return line.charAt(0).toUpperCase() + line.slice(1);
         }
         const CARD_KEYS_ENV = 'EXTENSION_CLI_CARD_KEYS';
@@ -7870,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',
@@ -8164,6 +8273,7 @@ var __webpack_modules__ = {
             'inspect',
             'install',
             'logs',
+            'navigate',
             'open',
             'preview',
             'publish',
@@ -8625,6 +8735,21 @@ var __webpack_modules__ = {
                 description: 'Open an extension surface: popup, options, sidebar, action, or command (requires --allow-control)',
                 supportsSourceInspection: false
             },
+            {
+                name: 'navigate',
+                positionals: [
+                    {
+                        name: 'url',
+                        required: true
+                    },
+                    {
+                        name: 'project-path',
+                        required: false
+                    }
+                ],
+                description: 'Open a url in a tab through the extension: the active tab, --tab <id>, or a new tab with --new-tab (requires --allow-control). A static tabs call, so it works where an MV3 background refuses eval',
+                supportsSourceInspection: false
+            },
             {
                 name: 'inspect',
                 positionals: [
@@ -9237,6 +9362,18 @@ Cross-browser compatibility
                 remedy
             ].filter(Boolean).join('\n');
         }
+        function navigateFailed(url, reason, engine, remedy) {
+            const engineNote = engine ? messages_arg(` (engine ${engine})`) : '';
+            return [
+                `${getLoggingPrefix('error')} Can't navigate a tab to ${messaging.Sc.val(url)}`,
+                `${messaging.Sc.label('REASON')} ${messaging.Sc.val(reason)}${engineNote}`,
+                remedy
+            ].filter(Boolean).join('\n');
+        }
+        function navigatedTab(url, tabId, created) {
+            const where = null == tabId ? 'a tab' : `${created ? 'new ' : ''}tab ${messaging.Sc.val(String(tabId))}`;
+            return `${getLoggingPrefix('success')} Navigated ${where} to ${messaging.Sc.val(url)}`;
+        }
         function openSurfaceGestureStep(surface) {
             return `Click the extension's toolbar entry, or its row in the extensions menu, to open the ${openSurfaceNoun(surface)}.`;
         }
@@ -9595,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;
@@ -9605,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;
@@ -9632,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), {
@@ -9703,6 +9852,14 @@ Cross-browser compatibility
                 hint: openSurfaceGestureStep(surface)
             };
         }
+        function navigateResultLines(value) {
+            if (!value || 'object' != typeof value) return;
+            const reply = value;
+            if ('string' != typeof reply.url) return;
+            return [
+                navigatedTab(reply.url, 'number' == typeof reply.tabId ? reply.tabId : null, true === reply.created)
+            ];
+        }
         function openResultLines(value) {
             if (!value || 'object' != typeof value) return;
             const reply = value;
@@ -9896,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',
@@ -9938,6 +10105,34 @@ Cross-browser compatibility
                     } : void 0
                 });
             });
+            commonOptions(program.command('navigate').arguments('<url> [project-path]').description('Open a url in a tab through the extension: the active tab, --tab <id>, or a new tab with --new-tab (requires --allow-control). A static tabs call, so it works where an MV3 background refuses eval').option('--tab <id>', 'the tab to navigate (default: the active tab)').option('--new-tab', 'open the url in a new tab instead of the active one').option('--background', 'with --new-tab: open it without activating it')).action(async (url, projectPathArg, opts)=>{
+                if (!/^[a-z][a-z0-9+.-]*:/i.test(url)) fail(`navigate needs an absolute url (got ${url})`, {
+                    command: 'navigate',
+                    code: messaging.Lp.E_ARGS,
+                    output: opts.output
+                });
+                const target = {
+                    context: 'background'
+                };
+                if (opts.tab) target.tabId = Number(opts.tab);
+                const args = {
+                    url
+                };
+                if (opts.newTab) args.newTab = true;
+                if (opts.newTab && opts.background) args.active = false;
+                await runCommand({
+                    projectPathArg,
+                    command: 'navigate',
+                    op: 'tabs.navigate',
+                    target,
+                    args,
+                    opts,
+                    pretty: {
+                        value: navigateResultLines,
+                        failure: (error)=>navigateFailed(url, error.message, error.engine, error.hint)
+                    }
+                });
+            });
             commonOptions(program.command('open').arguments('<surface> [project-path]').description('Open an extension surface: popup, options, sidebar, action, or command (requires --allow-control)').option('--name <command>', 'with `open command`: the chrome.commands name to trigger')).action(async (surface, projectPathArg, opts)=>{
                 const allowed = [
                     'popup',

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

@@ -1,7 +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/messages.d.ts

@@ -12,6 +12,7 @@ export declare function firefoxRdpRuntimeCapabilitySummary(state: 'available' |
 export declare function skippingBrowserLaunchDueToCompileErrors(): string;
 export declare function browserNotInstalledError(browser: Browser, browserBinaryLocation: string): string;
 export declare function geckoForkNotInstalled(browser: Browser, guidance: string): string;
+export declare function chromiumForkNotInstalled(browser: Browser, guidance: string): string;
 export declare function usingManagedChromiumFamilyFallback(requestedBrowser: Browser, _fallbackBrowser: Browser, _binaryPath: string): string;
 export declare function preferringSystemBrowserOverSnapshot(_systemBinary: string, _snapshotBinary: string): string;
 export declare function mv2NotSupportedByChromium(extensionPath: string): 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/fork-install-guidance.d.ts

@@ -0,0 +1 @@
+export declare function chromiumForkInstallGuidance(browser: unknown): string | null;

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/browsers/run-firefox/firefox-launch/master-preferences.d.ts

@@ -67,7 +67,8 @@ declare const masterPreferences: {
     'xpinstall.signatures.required': boolean;
 };
 export default masterPreferences;
-export declare function getPreferences(customPrefs: Record<string, unknown>): {
+export declare function getForkPreferences(browser?: string): Record<string, unknown>;
+export declare function getPreferences(customPrefs: Record<string, unknown>, browser?: string): {
     'browser.aboutwelcome.enabled': boolean;
     'browser.startup.homepage_override.mstone': string;
     'browser.shell.didSkipDefaultBrowserCheckOnFirstRun': boolean;

package/dist/extension/helpers/messages.d.ts

@@ -113,6 +113,17 @@ declare const COMMAND_TABLE: readonly [{
     }];
     readonly description: 'Open an extension surface: popup, options, sidebar, action, or command (requires --allow-control)';
     readonly supportsSourceInspection: false;
+}, {
+    readonly name: 'navigate';
+    readonly positionals: readonly [{
+        readonly name: 'url';
+        readonly required: true;
+    }, {
+        readonly name: 'project-path';
+        readonly required: false;
+    }];
+    readonly description: 'Open a url in a tab through the extension: the active tab, --tab <id>, or a new tab with --new-tab (requires --allow-control). A static tabs call, so it works where an MV3 background refuses eval';
+    readonly supportsSourceInspection: false;
 }, {
     readonly name: 'inspect';
     readonly positionals: readonly [{
@@ -286,6 +297,8 @@ export declare function replayedActionClick(listeners: number): string;
 export declare function replayedCommand(listeners: number, command?: string): string;
 export declare function openSurfaceWarning(warning: string): string;
 export declare function openSurfaceFailed(surface: string, reason: string, engine?: string, remedy?: string): string;
+export declare function navigateFailed(url: string, reason: string, engine?: string, remedy?: string): string;
+export declare function navigatedTab(url: string, tabId: number | null, created: boolean): string;
 export declare function openSurfaceGestureStep(surface: string): string;
 export declare function openSurfaceNeedsGesturePlain(surface: string): string;
 export declare function openSurfaceNeedsGesture(surface: string): string;

package/dist/extension/helpers/telemetry-cli.d.ts

@@ -1,5 +1,5 @@
 import { Telemetry, type TelemetrySource } from './telemetry.js';
-type KnownCommand = 'build' | 'capabilities' | 'create' | 'dev' | 'doctor' | 'eval' | 'inspect' | 'install' | 'logs' | 'open' | 'preview' | 'publish' | 'reload' | 'start' | 'storage' | 'telemetry' | 'uninstall' | 'unknown';
+type KnownCommand = 'build' | 'capabilities' | 'create' | 'dev' | 'doctor' | 'eval' | 'inspect' | 'install' | 'logs' | 'navigate' | 'open' | 'preview' | 'publish' | 'reload' | 'start' | 'storage' | 'telemetry' | 'uninstall' | 'unknown';
 export declare const KNOWN_COMMANDS: ReadonlySet<KnownCommand>;
 export declare function detectInvokedCommand(argv: string[]): KnownCommand;
 export declare function advertisedTemplateName(value: string | undefined): string | undefined;

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.28",
+  "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,10 +104,10 @@
     "chromium-location": "2.1.2",
     "commander": "^15.0.0",
     "edge-location": "2.3.1",
-    "extension-create": "4.1.28",
-    "extension-develop": "4.1.28",
-    "extension-install": "4.1.28",
-    "firefox-location2": "3.1.1",
+    "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",
     "opera-location2": "2.1.1",