extension 4.1.28 → 4.1.29

package/dist/browsers.cjs

@@ -283,6 +283,12 @@ var __webpack_modules__ = {
             'yandex',
             'chromium-based'
         ]);
+        const SYSTEM_LOCATED_CHROMIUM_FORKS = new Set([
+            'brave',
+            'opera',
+            'vivaldi',
+            'yandex'
+        ]);
         const FIREFOX_BROWSERS = new Set([
             'firefox',
             'waterfox',
@@ -295,6 +301,9 @@ var __webpack_modules__ = {
         function isChromiumBrowser(browser) {
             return CHROMIUM_BROWSERS.has(String(browser));
         }
+        function isSystemLocatedChromiumFork(browser) {
+            return SYSTEM_LOCATED_CHROMIUM_FORKS.has(String(browser));
+        }
         function isFirefoxBrowser(browser) {
             return FIREFOX_BROWSERS.has(String(browser));
         }
@@ -306,6 +315,7 @@ var __webpack_modules__ = {
         }
         __webpack_require__.d(__webpack_exports__, {
             M_: ()=>isFirefoxBrowser,
+            cA: ()=>isSystemLocatedChromiumFork,
             eP: ()=>isEmulatorBrowser,
             rG: ()=>isChromiumBrowser
         });
@@ -572,6 +582,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 +1032,7 @@ var __webpack_modules__ = {
             Gq: ()=>locatingBrowser,
             H1: ()=>safariRegenerationDiscards,
             HH: ()=>messageWithoutSenderError,
+            I5: ()=>chromiumForkNotInstalled,
             Ih: ()=>browserNotInstalledError,
             JB: ()=>devChannelSnapshotInUse,
             KP: ()=>safariBuildCalled,
@@ -2465,6 +2480,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");
@@ -3012,6 +3028,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 +3330,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 +3605,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);
                     }
@@ -4293,9 +4334,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 +4411,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);
@@ -5843,6 +5900,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 +5938,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();
@@ -7029,7 +7090,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,12 @@ var __webpack_modules__ = {
             'yandex',
             'chromium-based'
         ]);
+        const SYSTEM_LOCATED_CHROMIUM_FORKS = new Set([
+            'brave',
+            'opera',
+            'vivaldi',
+            'yandex'
+        ]);
         const FIREFOX_BROWSERS = new Set([
             'firefox',
             'waterfox',
@@ -296,6 +302,9 @@ var __webpack_modules__ = {
         function isChromiumBrowser(browser) {
             return CHROMIUM_BROWSERS.has(String(browser));
         }
+        function isSystemLocatedChromiumFork(browser) {
+            return SYSTEM_LOCATED_CHROMIUM_FORKS.has(String(browser));
+        }
         function isFirefoxBrowser(browser) {
             return FIREFOX_BROWSERS.has(String(browser));
         }
@@ -307,6 +316,7 @@ var __webpack_modules__ = {
         }
         __webpack_require__.d(__webpack_exports__, {
             M_: ()=>isFirefoxBrowser,
+            cA: ()=>isSystemLocatedChromiumFork,
             eP: ()=>isEmulatorBrowser,
             rG: ()=>isChromiumBrowser
         });
@@ -573,6 +583,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 +1033,7 @@ var __webpack_modules__ = {
             Gq: ()=>locatingBrowser,
             H1: ()=>safariRegenerationDiscards,
             HH: ()=>messageWithoutSenderError,
+            I5: ()=>chromiumForkNotInstalled,
             Ih: ()=>browserNotInstalledError,
             JB: ()=>devChannelSnapshotInUse,
             KP: ()=>safariBuildCalled,
@@ -2456,6 +2471,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");
@@ -3003,6 +3019,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 +3321,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 +3596,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);
                     }
@@ -4284,9 +4325,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 +4402,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);
@@ -5834,6 +5891,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 +5929,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();
@@ -7073,7 +7134,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';
@@ -8164,6 +8225,7 @@ var __webpack_modules__ = {
             'inspect',
             'install',
             'logs',
+            'navigate',
             'open',
             'preview',
             'publish',
@@ -8625,6 +8687,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 +9314,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)}.`;
         }
@@ -9703,6 +9792,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;
@@ -9938,6 +10035,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,9 @@
 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 FIREFOX_BROWSERS: ReadonlySet<string>;
 export declare function isChromiumBrowser(browser: BrowserType | string): boolean;
+export declare function isSystemLocatedChromiumFork(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/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/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-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/package.json

@@ -38,7 +38,7 @@
     "extension": "./bin/extension.cjs"
   },
   "name": "extension",
-  "version": "4.1.28",
+  "version": "4.1.29",
   "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.29",
+    "extension-develop": "4.1.29",
+    "extension-install": "4.1.29",
+    "firefox-location2": "3.2.0",
     "floorp-location": "1.0.0",
     "librewolf-location": "1.2.1",
     "opera-location2": "2.1.1",