extension 4.1.26 → 4.1.27

package/dist/browsers.cjs

@@ -442,7 +442,8 @@ var __webpack_modules__ = {
         var pintor__rspack_import_8 = __webpack_require__("pintor");
         var pintor__rspack_import_8_default = /*#__PURE__*/ __webpack_require__.n(pintor__rspack_import_8);
         var _helpers_messaging__rspack_import_9 = __webpack_require__("./helpers/messaging.ts");
-        var _browser_family__rspack_import_10 = __webpack_require__("./browsers/browsers-lib/browser-family.ts");
+        var _run_firefox_firefox_launch_librewolf_overrides__rspack_import_10 = __webpack_require__("./browsers/run-firefox/firefox-launch/librewolf-overrides.ts");
+        var _browser_family__rspack_import_11 = __webpack_require__("./browsers/browsers-lib/browser-family.ts");
         const require1 = (0, node_module__rspack_import_1.createRequire)(__rslib_import_meta_url__);
         function getLoggingPrefix(type) {
             return (0, _helpers_messaging__rspack_import_9.Pl)(type);
@@ -518,7 +519,7 @@ var __webpack_modules__ = {
             return browser;
         }
         function capitalizedBrowserName(browser) {
-            return `${browser.charAt(0).toUpperCase() + browser.slice(1)}`;
+            return (0, _helpers_messaging__rspack_import_9.QZ)(String(browser));
         }
         function resolveBrowserVersionLine(browser, pinnedLine, opts) {
             const pinned = String(pinnedLine || '').trim();
@@ -567,6 +568,10 @@ var __webpack_modules__ = {
             })();
             return `${getLoggingPrefix('error')} ${isUnreachable}${pintor__rspack_import_8_default().gray('NOT FOUND')} ${pintor__rspack_import_8_default().underline(browserBinaryLocation || `${capitalizedBrowserName(browser)}BROWSER`)}\nInstall the missing browser, or choose another one with ${pintor__rspack_import_8_default().blue('--browser')} ${pintor__rspack_import_8_default().gray('<chrome|edge|firefox>')}.` + wslHint;
         }
+        function geckoForkNotInstalled(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('--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 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.`;
         }
@@ -707,8 +712,11 @@ var __webpack_modules__ = {
             body.push("Run your command again after the install finishes.");
             return `${body.join('\n')}\n`;
         }
-        function firefoxLaunchCalled() {
-            return `${getLoggingPrefix('debug')} browser  launch browser=firefox`;
+        function firefoxLaunchCalled(browser = 'firefox') {
+            return `${getLoggingPrefix('debug')} browser  launch browser=${browser}`;
+        }
+        function librewolfRemoteDebuggingLocked(overridesPath) {
+            return `${getLoggingPrefix('error')} LibreWolf keeps remote debugging off, so Extension.js can't reach it.\nLibreWolf resets ${pintor__rspack_import_8_default().gray('devtools.debugger.remote-enabled')} to false at every start. Add these two lines to ${pintor__rspack_import_8_default().underline(overridesPath)} and run the command again:\n` + _run_firefox_firefox_launch_librewolf_overrides__rspack_import_10.Tu.map((line)=>`  ${pintor__rspack_import_8_default().blue(line)}\n`).join('') + `Or choose another browser with ${pintor__rspack_import_8_default().blue('--browser')} ${pintor__rspack_import_8_default().gray('<firefox|waterfox|zen|floorp>')}.`;
         }
         function firefoxFailedToStart(error) {
             return `${getLoggingPrefix('error')} Firefox failed to start.\n${pintor__rspack_import_8_default().red(errorDetail(error))}`;
@@ -857,7 +865,7 @@ var __webpack_modules__ = {
         }
         function pinnedBinaryFlag(browser) {
             const name = String(browser || '');
-            if ((0, _browser_family__rspack_import_10.M_)(name)) return '--gecko-binary';
+            if ((0, _browser_family__rspack_import_11.M_)(name)) return '--gecko-binary';
             if ('safari' === name || 'webkit-based' === name) return '--safari-binary';
             return '--chromium-binary';
         }
@@ -873,11 +881,8 @@ var __webpack_modules__ = {
                 case 'edge':
                     browserDevToolsUrl = 'edge://extensions';
                     break;
-                case 'firefox':
-                    browserDevToolsUrl = 'about:debugging#/runtime/this-firefox';
-                    break;
                 default:
-                    browserDevToolsUrl = '';
+                    browserDevToolsUrl = (0, _browser_family__rspack_import_11.M_)(browser) ? 'about:debugging#/runtime/this-firefox' : '';
             }
             if (!message.data) return `${getLoggingPrefix('error')} No client data received for ${manifestName}.\n\n${pintor__rspack_import_8_default().red("Extension.js can't read data from your extension.")}\n${pintor__rspack_import_8_default().red('To fix, ensure that:')}\n\n- Your extension is enabled in ${pintor__rspack_import_8_default().underline(browserDevToolsUrl)}\n- No previous ${capitalize(browser)} browser instance is open\n\nIf both hold, restart the ${pintor__rspack_import_8_default().yellow(manifest.name || '')} and the\n${pintor__rspack_import_8_default().yellow('Manager Extension')} in ${pintor__rspack_import_8_default().underline(browserDevToolsUrl)} and try again.\nIf the issue persists, report a bug:\n` + pintor__rspack_import_8_default().underline("https://github.com/extension-js/extension.js/issues");
             const { id = '', management } = message.data;
@@ -1046,6 +1051,7 @@ var __webpack_modules__ = {
             _D: ()=>browserLaunchError,
             aI: ()=>devChromeProfilePath,
             aO: ()=>safariOpenHint,
+            bC: ()=>librewolfRemoteDebuggingLocked,
             bv: ()=>cdpUnifiedExtensionLog,
             cD: ()=>targetActorHasActiveRequestError,
             cF: ()=>safariRebuilt,
@@ -1083,6 +1089,7 @@ var __webpack_modules__ = {
             sP: ()=>mv2NotSupportedByChromium,
             sY: ()=>creatingUserProfile,
             uK: ()=>safariConverting,
+            v5: ()=>geckoForkNotInstalled,
             wk: ()=>chromeFailedToSpawn,
             xX: ()=>binaryProvenanceNote,
             xy: ()=>chromeInitializingEnhancedReload,
@@ -3754,10 +3761,11 @@ var __webpack_modules__ = {
                         stderrStream.on('error', ()=>{});
                     }
                     let disposeSignalHandlers;
-                    child.on('close', (code)=>{
+                    child.on('close', (code, signal)=>{
                         if ((0, messaging._o)()) this.logger.info(messages.nn(code || 0));
+                        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 (code ${code ?? 'unknown'}). The dev server is still running but reloads cannot be delivered, restart "extension dev" to relaunch the browser.` : `[browser] ${this.options.browser} exited (code ${code ?? 'unknown'}); the preview session is over.`);
+                            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);
                         }
                         disposeSignalHandlers?.();
@@ -4378,12 +4386,30 @@ var __webpack_modules__ = {
                 extensionsToLoad
             };
         }
+        function attachChildOutput(child, opts) {
+            const sinks = opts.sinks || {
+                stdout: process.stdout,
+                stderr: process.stderr
+            };
+            for (const [stream, sink] of [
+                [
+                    child.stdout,
+                    sinks.stdout
+                ],
+                [
+                    child.stderr,
+                    sinks.stderr
+                ]
+            ])if (stream) if (opts.debug) stream.pipe(sink);
+            else stream.resume();
+        }
         function logFirefoxDryRun(browserBinaryLocation, launchArgs) {
             if ((0, messaging._o)()) (0, messaging._w)(messages.A9());
             (0, messaging._w)(messages.qn());
             (0, messaging._w)(messages.LD(browserBinaryLocation));
             (0, messaging._w)(messages.lO(launchArgs.join(' ')));
         }
+        var librewolf_overrides = __webpack_require__("./browsers/run-firefox/firefox-launch/librewolf-overrides.ts");
         const activeInstances = new Set();
         let globalHandlersInstalled = false;
         async function attemptCleanup(instance) {
@@ -5390,7 +5416,7 @@ var __webpack_modules__ = {
                     }
                 } catch  {}
                 this.lastInstalledAddonPath = primaryAddonPath;
-                const bannerPrinted = await printRunningInDevelopmentSummary(candidateAddonPaths, 'firefox', this.derivedExtensionId, this.options.browserVersionLine, {
+                const bannerPrinted = await printRunningInDevelopmentSummary(candidateAddonPaths, this.options.browser, this.derivedExtensionId, this.options.browserVersionLine, {
                     profilePath: this.options.launchProfilePath,
                     binaryPath: this.options.launchBinaryPath,
                     binaryProvenance: this.options.launchBinaryProvenance
@@ -5642,12 +5668,13 @@ var __webpack_modules__ = {
             async launch(compilation, options) {
                 const compilationErrors = compilation?.errors || [];
                 if (compilationErrors.length > 0) return void this.ctx.logger?.info?.(messages.y7());
-                if ((0, messaging._o)()) this.ctx.logger?.info?.(messages.A9());
+                if ((0, messaging._o)()) this.ctx.logger?.info?.(messages.A9(this.host.browser));
                 const normalizePath = (value)=>{
                     const normalized = value ? (0, wsl_support.f7)(value) : null;
                     return normalized && external_node_fs_.existsSync(normalized) ? normalized : null;
                 };
-                const resolveManagedBinary = ()=>normalizePath((0, output_binaries_resolver.kI)(compilation, 'firefox') || null);
+                const isNamedGeckoFork = 'waterfox' === this.host.browser || 'librewolf' === this.host.browser || 'zen' === this.host.browser || 'floorp' === this.host.browser;
+                const resolveManagedBinary = ()=>isNamedGeckoFork ? null : normalizePath((0, output_binaries_resolver.kI)(compilation, 'firefox') || null);
                 const resolveWslFallback = ()=>resolveWslWindowsBinary();
                 const getInstallGuidanceText = ()=>{
                     try {
@@ -5677,6 +5704,14 @@ var __webpack_modules__ = {
                 const dryRun = Boolean(this.host.dryRun);
                 if (inTestRunner && !dryRun) return void logFirefoxDryRun('firefox-mock-binary', []);
                 if (inTestRunner && dryRun) return void await this.printDryRunPlan(compilation, options, this.host.geckoBinary ? (0, wsl_support.f7)(String(this.host.geckoBinary)) : 'firefox-mock-binary');
+                if ('librewolf' === this.host.browser) {
+                    const remoteDebugging = (0, librewolf_overrides.u5)(external_node_fs_, process.env, process.platform);
+                    if (!remoteDebugging.enabled) {
+                        (0, messaging.Gg)(messages.bC(remoteDebugging.expectedPath));
+                        if (inTestRunner) throw new Error('LibreWolf remote debugging is disabled');
+                        process.exit(1);
+                    }
+                }
                 let browserBinaryLocation = resolveManagedBinary();
                 let skipDetection = Boolean(browserBinaryLocation);
                 const engineBased = 'gecko-based' === this.host.browser || 'firefox-based' === this.host.browser;
@@ -5898,9 +5933,9 @@ var __webpack_modules__ = {
                 });
             }
             pipeChildOutput(child) {
-                if (!(0, messaging._o)()) return;
-                child.stdout?.pipe(process.stdout);
-                child.stderr?.pipe(process.stderr);
+                attachChildOutput(child, {
+                    debug: (0, messaging._o)()
+                });
             }
             wireChildLifecycle() {
                 const child = this.child;
@@ -5910,15 +5945,15 @@ var __webpack_modules__ = {
                     if (process.env.VITEST || process.env.VITEST_WORKER_ID) throw new Error('Firefox startup timed out');
                     process.exit(1);
                 });
-                child.on('close', (code)=>{
+                child.on('close', (code, signal)=>{
                     const expected = (0, process_teardown.Op)(child);
                     if (!expected && this.adoptHandedOffBrowser()) return;
-                    this.onBrowserGone(code, expected);
+                    this.onBrowserGone(code, expected, signal);
                 });
                 this.pipeChildOutput(child);
                 this.disposeProcessHandlers = setupFirefoxProcessHandlers(this.host.browser, ()=>this.child, ()=>this.cleanupInstance(), ()=>this.livePid);
             }
-            onBrowserGone(code, expected) {
+            onBrowserGone(code, expected, signal) {
                 if (this.browserGone) return;
                 this.browserGone = true;
                 if (this.watchTimeout) {
@@ -5932,7 +5967,7 @@ var __webpack_modules__ = {
                 if (this.host.launchProfilePath) (0, shared_utils.sW)(this.host.launchProfilePath);
                 if ((0, messaging._o)()) this.ctx.logger?.info?.(messages.Th(this.host.browser));
                 if (!expected) {
-                    this.ctx.logger?.error?.(`[browser] ${this.host.browser} exited (code ${code ?? 'unknown'}) without being asked to. The add-on may have been rejected or the browser crashed; the session cannot be driven.`);
+                    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);
                 }
                 this.cleanupInstance().catch((err)=>{
@@ -6048,6 +6083,8 @@ var __webpack_modules__ = {
                 if ('function' == typeof this.watchTimeout.unref) this.watchTimeout.unref();
             }
             printInstallHint(compilation, raw) {
+                const forkGuidance = geckoForkInstallGuidance(this.host.browser);
+                if (null !== forkGuidance) return void (0, messaging.Gg)(messages.v5(this.host.browser, forkGuidance));
                 try {
                     const displayCacheDir = (0, output_binaries_resolver.LB)(compilation);
                     const pretty = messages.MG(this.host.browser || 'firefox', raw, displayCacheDir);
@@ -6070,6 +6107,69 @@ var __webpack_modules__ = {
                 this.ctx = ctx;
             }
         }
+        function geckoForkInstallGuidance(browser) {
+            const read = (fn)=>{
+                try {
+                    return fn();
+                } catch  {
+                    return '';
+                }
+            };
+            switch(browser){
+                case 'waterfox':
+                    return read(()=>(0, external_waterfox_location_namespaceObject.getInstallGuidance)());
+                case 'librewolf':
+                    return read(()=>(0, external_librewolf_location_namespaceObject.getInstallGuidance)());
+                case 'zen':
+                    return read(()=>(0, external_zen_location_namespaceObject.getInstallGuidance)());
+                case 'floorp':
+                    return read(()=>(0, external_floorp_location_namespaceObject.getInstallGuidance)());
+                default:
+                    return null;
+            }
+        }
+    },
+    "./browsers/run-firefox/firefox-launch/librewolf-overrides.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
+        var node_path__rspack_import_0 = __webpack_require__("node:path");
+        const LIBREWOLF_REMOTE_DEBUGGING_LINES = [
+            'pref("devtools.debugger.remote-enabled", true);',
+            'pref("devtools.debugger.prompt-connection", false);'
+        ];
+        const OVERRIDES_FILE = 'librewolf.overrides.cfg';
+        function librewolfOverridesCandidates(env, platform) {
+            const home = String(env.HOME || env.USERPROFILE || '').trim();
+            const candidates = [];
+            if ('win32' === platform) {
+                if (home) candidates.push(node_path__rspack_import_0.join(home, '.librewolf', OVERRIDES_FILE));
+                return candidates;
+            }
+            if (home) candidates.push(node_path__rspack_import_0.join(home, '.librewolf', OVERRIDES_FILE));
+            const xdg = String(env.XDG_CONFIG_HOME || '').trim();
+            if (xdg) candidates.push(node_path__rspack_import_0.join(xdg, 'librewolf', 'librewolf', OVERRIDES_FILE));
+            if (home) candidates.push(node_path__rspack_import_0.join(home, '.config', 'librewolf', 'librewolf', OVERRIDES_FILE));
+            return candidates;
+        }
+        function librewolfRemoteDebuggingEnabled(fsLike, env, platform) {
+            const candidates = librewolfOverridesCandidates(env, platform);
+            const expectedPath = candidates[0] || node_path__rspack_import_0.join('~', '.librewolf', OVERRIDES_FILE);
+            const enabledLine = /^\s*(?:pref|defaultPref|lockPref)\(\s*"devtools\.debugger\.remote-enabled"\s*,\s*true\s*\)/m;
+            for (const candidate of candidates)try {
+                if (!fsLike.existsSync(candidate)) continue;
+                if (enabledLine.test(fsLike.readFileSync(candidate, 'utf-8'))) return {
+                    enabled: true,
+                    expectedPath: candidate
+                };
+            } catch  {}
+            return {
+                enabled: false,
+                expectedPath
+            };
+        }
+        __webpack_require__.d(__webpack_exports__, {
+            u5: ()=>librewolfRemoteDebuggingEnabled
+        }, {
+            Tu: LIBREWOLF_REMOTE_DEBUGGING_LINES
+        });
     },
     "./browsers/run-only.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
         var node_fs__rspack_import_0 = __webpack_require__("node:fs");
@@ -6913,9 +7013,20 @@ var __webpack_modules__ = {
                 ...body
             ].join('\n');
         }
-        function browserRowValue(browser, versionLine) {
+        const BRAND_SPELLINGS = {
+            librewolf: 'LibreWolf',
+            chromium: 'Chromium',
+            'chromium-based': 'Chromium-based',
+            'gecko-based': 'Gecko-based',
+            'firefox-based': 'Firefox-based',
+            'webkit-based': 'WebKit-based'
+        };
+        function browserDisplayName(browser) {
             const name = String(browser || '').trim() || 'unknown';
-            const display = name.charAt(0).toUpperCase() + name.slice(1);
+            return BRAND_SPELLINGS[name] || name.charAt(0).toUpperCase() + name.slice(1);
+        }
+        function browserRowValue(browser, versionLine) {
+            const display = browserDisplayName(browser);
             const line = String(versionLine || '').trim();
             if (!line) return display;
             if (!/[a-zA-Z]/.test(line)) return `${display} ${line}`;
@@ -6954,6 +7065,7 @@ var __webpack_modules__ = {
             Gg: ()=>humanError,
             Nr: ()=>card,
             Pl: ()=>prefix,
+            QZ: ()=>browserDisplayName,
             T_: ()=>artifactNoun,
             VR: ()=>isCardKeyClaimed,
             _o: ()=>isDebug,

package/dist/cli.cjs

@@ -443,7 +443,8 @@ var __webpack_modules__ = {
         var pintor__rspack_import_8 = __webpack_require__("pintor");
         var pintor__rspack_import_8_default = /*#__PURE__*/ __webpack_require__.n(pintor__rspack_import_8);
         var _helpers_messaging__rspack_import_9 = __webpack_require__("./helpers/messaging.ts");
-        var _browser_family__rspack_import_10 = __webpack_require__("./browsers/browsers-lib/browser-family.ts");
+        var _run_firefox_firefox_launch_librewolf_overrides__rspack_import_10 = __webpack_require__("./browsers/run-firefox/firefox-launch/librewolf-overrides.ts");
+        var _browser_family__rspack_import_11 = __webpack_require__("./browsers/browsers-lib/browser-family.ts");
         const require1 = (0, node_module__rspack_import_1.createRequire)(__rslib_import_meta_url__);
         function getLoggingPrefix(type) {
             return (0, _helpers_messaging__rspack_import_9.Pl)(type);
@@ -519,7 +520,7 @@ var __webpack_modules__ = {
             return browser;
         }
         function capitalizedBrowserName(browser) {
-            return `${browser.charAt(0).toUpperCase() + browser.slice(1)}`;
+            return (0, _helpers_messaging__rspack_import_9.QZ)(String(browser));
         }
         function resolveBrowserVersionLine(browser, pinnedLine, opts) {
             const pinned = String(pinnedLine || '').trim();
@@ -568,6 +569,10 @@ var __webpack_modules__ = {
             })();
             return `${getLoggingPrefix('error')} ${isUnreachable}${pintor__rspack_import_8_default().gray('NOT FOUND')} ${pintor__rspack_import_8_default().underline(browserBinaryLocation || `${capitalizedBrowserName(browser)}BROWSER`)}\nInstall the missing browser, or choose another one with ${pintor__rspack_import_8_default().blue('--browser')} ${pintor__rspack_import_8_default().gray('<chrome|edge|firefox>')}.` + wslHint;
         }
+        function geckoForkNotInstalled(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('--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 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.`;
         }
@@ -708,8 +713,11 @@ var __webpack_modules__ = {
             body.push("Run your command again after the install finishes.");
             return `${body.join('\n')}\n`;
         }
-        function firefoxLaunchCalled() {
-            return `${getLoggingPrefix('debug')} browser  launch browser=firefox`;
+        function firefoxLaunchCalled(browser = 'firefox') {
+            return `${getLoggingPrefix('debug')} browser  launch browser=${browser}`;
+        }
+        function librewolfRemoteDebuggingLocked(overridesPath) {
+            return `${getLoggingPrefix('error')} LibreWolf keeps remote debugging off, so Extension.js can't reach it.\nLibreWolf resets ${pintor__rspack_import_8_default().gray('devtools.debugger.remote-enabled')} to false at every start. Add these two lines to ${pintor__rspack_import_8_default().underline(overridesPath)} and run the command again:\n` + _run_firefox_firefox_launch_librewolf_overrides__rspack_import_10.Tu.map((line)=>`  ${pintor__rspack_import_8_default().blue(line)}\n`).join('') + `Or choose another browser with ${pintor__rspack_import_8_default().blue('--browser')} ${pintor__rspack_import_8_default().gray('<firefox|waterfox|zen|floorp>')}.`;
         }
         function firefoxFailedToStart(error) {
             return `${getLoggingPrefix('error')} Firefox failed to start.\n${pintor__rspack_import_8_default().red(errorDetail(error))}`;
@@ -858,7 +866,7 @@ var __webpack_modules__ = {
         }
         function pinnedBinaryFlag(browser) {
             const name = String(browser || '');
-            if ((0, _browser_family__rspack_import_10.M_)(name)) return '--gecko-binary';
+            if ((0, _browser_family__rspack_import_11.M_)(name)) return '--gecko-binary';
             if ('safari' === name || 'webkit-based' === name) return '--safari-binary';
             return '--chromium-binary';
         }
@@ -874,11 +882,8 @@ var __webpack_modules__ = {
                 case 'edge':
                     browserDevToolsUrl = 'edge://extensions';
                     break;
-                case 'firefox':
-                    browserDevToolsUrl = 'about:debugging#/runtime/this-firefox';
-                    break;
                 default:
-                    browserDevToolsUrl = '';
+                    browserDevToolsUrl = (0, _browser_family__rspack_import_11.M_)(browser) ? 'about:debugging#/runtime/this-firefox' : '';
             }
             if (!message.data) return `${getLoggingPrefix('error')} No client data received for ${manifestName}.\n\n${pintor__rspack_import_8_default().red("Extension.js can't read data from your extension.")}\n${pintor__rspack_import_8_default().red('To fix, ensure that:')}\n\n- Your extension is enabled in ${pintor__rspack_import_8_default().underline(browserDevToolsUrl)}\n- No previous ${capitalize(browser)} browser instance is open\n\nIf both hold, restart the ${pintor__rspack_import_8_default().yellow(manifest.name || '')} and the\n${pintor__rspack_import_8_default().yellow('Manager Extension')} in ${pintor__rspack_import_8_default().underline(browserDevToolsUrl)} and try again.\nIf the issue persists, report a bug:\n` + pintor__rspack_import_8_default().underline("https://github.com/extension-js/extension.js/issues");
             const { id = '', management } = message.data;
@@ -1047,6 +1052,7 @@ var __webpack_modules__ = {
             _D: ()=>browserLaunchError,
             aI: ()=>devChromeProfilePath,
             aO: ()=>safariOpenHint,
+            bC: ()=>librewolfRemoteDebuggingLocked,
             bv: ()=>cdpUnifiedExtensionLog,
             cD: ()=>targetActorHasActiveRequestError,
             cF: ()=>safariRebuilt,
@@ -1084,6 +1090,7 @@ var __webpack_modules__ = {
             sP: ()=>mv2NotSupportedByChromium,
             sY: ()=>creatingUserProfile,
             uK: ()=>safariConverting,
+            v5: ()=>geckoForkNotInstalled,
             wk: ()=>chromeFailedToSpawn,
             xX: ()=>binaryProvenanceNote,
             xy: ()=>chromeInitializingEnhancedReload,
@@ -3745,10 +3752,11 @@ var __webpack_modules__ = {
                         stderrStream.on('error', ()=>{});
                     }
                     let disposeSignalHandlers;
-                    child.on('close', (code)=>{
+                    child.on('close', (code, signal)=>{
                         if ((0, messaging._o)()) this.logger.info(messages.nn(code || 0));
+                        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 (code ${code ?? 'unknown'}). The dev server is still running but reloads cannot be delivered, restart "extension dev" to relaunch the browser.` : `[browser] ${this.options.browser} exited (code ${code ?? 'unknown'}); the preview session is over.`);
+                            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);
                         }
                         disposeSignalHandlers?.();
@@ -4369,12 +4377,30 @@ var __webpack_modules__ = {
                 extensionsToLoad
             };
         }
+        function attachChildOutput(child, opts) {
+            const sinks = opts.sinks || {
+                stdout: process.stdout,
+                stderr: process.stderr
+            };
+            for (const [stream, sink] of [
+                [
+                    child.stdout,
+                    sinks.stdout
+                ],
+                [
+                    child.stderr,
+                    sinks.stderr
+                ]
+            ])if (stream) if (opts.debug) stream.pipe(sink);
+            else stream.resume();
+        }
         function logFirefoxDryRun(browserBinaryLocation, launchArgs) {
             if ((0, messaging._o)()) (0, messaging._w)(messages.A9());
             (0, messaging._w)(messages.qn());
             (0, messaging._w)(messages.LD(browserBinaryLocation));
             (0, messaging._w)(messages.lO(launchArgs.join(' ')));
         }
+        var librewolf_overrides = __webpack_require__("./browsers/run-firefox/firefox-launch/librewolf-overrides.ts");
         const activeInstances = new Set();
         let globalHandlersInstalled = false;
         async function attemptCleanup(instance) {
@@ -5381,7 +5407,7 @@ var __webpack_modules__ = {
                     }
                 } catch  {}
                 this.lastInstalledAddonPath = primaryAddonPath;
-                const bannerPrinted = await printRunningInDevelopmentSummary(candidateAddonPaths, 'firefox', this.derivedExtensionId, this.options.browserVersionLine, {
+                const bannerPrinted = await printRunningInDevelopmentSummary(candidateAddonPaths, this.options.browser, this.derivedExtensionId, this.options.browserVersionLine, {
                     profilePath: this.options.launchProfilePath,
                     binaryPath: this.options.launchBinaryPath,
                     binaryProvenance: this.options.launchBinaryProvenance
@@ -5633,12 +5659,13 @@ var __webpack_modules__ = {
             async launch(compilation, options) {
                 const compilationErrors = compilation?.errors || [];
                 if (compilationErrors.length > 0) return void this.ctx.logger?.info?.(messages.y7());
-                if ((0, messaging._o)()) this.ctx.logger?.info?.(messages.A9());
+                if ((0, messaging._o)()) this.ctx.logger?.info?.(messages.A9(this.host.browser));
                 const normalizePath = (value)=>{
                     const normalized = value ? (0, wsl_support.f7)(value) : null;
                     return normalized && external_node_fs_.existsSync(normalized) ? normalized : null;
                 };
-                const resolveManagedBinary = ()=>normalizePath((0, output_binaries_resolver.kI)(compilation, 'firefox') || null);
+                const isNamedGeckoFork = 'waterfox' === this.host.browser || 'librewolf' === this.host.browser || 'zen' === this.host.browser || 'floorp' === this.host.browser;
+                const resolveManagedBinary = ()=>isNamedGeckoFork ? null : normalizePath((0, output_binaries_resolver.kI)(compilation, 'firefox') || null);
                 const resolveWslFallback = ()=>resolveWslWindowsBinary();
                 const getInstallGuidanceText = ()=>{
                     try {
@@ -5668,6 +5695,14 @@ var __webpack_modules__ = {
                 const dryRun = Boolean(this.host.dryRun);
                 if (inTestRunner && !dryRun) return void logFirefoxDryRun('firefox-mock-binary', []);
                 if (inTestRunner && dryRun) return void await this.printDryRunPlan(compilation, options, this.host.geckoBinary ? (0, wsl_support.f7)(String(this.host.geckoBinary)) : 'firefox-mock-binary');
+                if ('librewolf' === this.host.browser) {
+                    const remoteDebugging = (0, librewolf_overrides.u5)(external_node_fs_, process.env, process.platform);
+                    if (!remoteDebugging.enabled) {
+                        (0, messaging.Gg)(messages.bC(remoteDebugging.expectedPath));
+                        if (inTestRunner) throw new Error('LibreWolf remote debugging is disabled');
+                        process.exit(1);
+                    }
+                }
                 let browserBinaryLocation = resolveManagedBinary();
                 let skipDetection = Boolean(browserBinaryLocation);
                 const engineBased = 'gecko-based' === this.host.browser || 'firefox-based' === this.host.browser;
@@ -5889,9 +5924,9 @@ var __webpack_modules__ = {
                 });
             }
             pipeChildOutput(child) {
-                if (!(0, messaging._o)()) return;
-                child.stdout?.pipe(process.stdout);
-                child.stderr?.pipe(process.stderr);
+                attachChildOutput(child, {
+                    debug: (0, messaging._o)()
+                });
             }
             wireChildLifecycle() {
                 const child = this.child;
@@ -5901,15 +5936,15 @@ var __webpack_modules__ = {
                     if (process.env.VITEST || process.env.VITEST_WORKER_ID) throw new Error('Firefox startup timed out');
                     process.exit(1);
                 });
-                child.on('close', (code)=>{
+                child.on('close', (code, signal)=>{
                     const expected = (0, process_teardown.Op)(child);
                     if (!expected && this.adoptHandedOffBrowser()) return;
-                    this.onBrowserGone(code, expected);
+                    this.onBrowserGone(code, expected, signal);
                 });
                 this.pipeChildOutput(child);
                 this.disposeProcessHandlers = setupFirefoxProcessHandlers(this.host.browser, ()=>this.child, ()=>this.cleanupInstance(), ()=>this.livePid);
             }
-            onBrowserGone(code, expected) {
+            onBrowserGone(code, expected, signal) {
                 if (this.browserGone) return;
                 this.browserGone = true;
                 if (this.watchTimeout) {
@@ -5923,7 +5958,7 @@ var __webpack_modules__ = {
                 if (this.host.launchProfilePath) (0, shared_utils.sW)(this.host.launchProfilePath);
                 if ((0, messaging._o)()) this.ctx.logger?.info?.(messages.Th(this.host.browser));
                 if (!expected) {
-                    this.ctx.logger?.error?.(`[browser] ${this.host.browser} exited (code ${code ?? 'unknown'}) without being asked to. The add-on may have been rejected or the browser crashed; the session cannot be driven.`);
+                    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);
                 }
                 this.cleanupInstance().catch((err)=>{
@@ -6039,6 +6074,8 @@ var __webpack_modules__ = {
                 if ('function' == typeof this.watchTimeout.unref) this.watchTimeout.unref();
             }
             printInstallHint(compilation, raw) {
+                const forkGuidance = geckoForkInstallGuidance(this.host.browser);
+                if (null !== forkGuidance) return void (0, messaging.Gg)(messages.v5(this.host.browser, forkGuidance));
                 try {
                     const displayCacheDir = (0, output_binaries_resolver.LB)(compilation);
                     const pretty = messages.MG(this.host.browser || 'firefox', raw, displayCacheDir);
@@ -6061,6 +6098,69 @@ var __webpack_modules__ = {
                 this.ctx = ctx;
             }
         }
+        function geckoForkInstallGuidance(browser) {
+            const read = (fn)=>{
+                try {
+                    return fn();
+                } catch  {
+                    return '';
+                }
+            };
+            switch(browser){
+                case 'waterfox':
+                    return read(()=>(0, external_waterfox_location_namespaceObject.getInstallGuidance)());
+                case 'librewolf':
+                    return read(()=>(0, external_librewolf_location_namespaceObject.getInstallGuidance)());
+                case 'zen':
+                    return read(()=>(0, external_zen_location_namespaceObject.getInstallGuidance)());
+                case 'floorp':
+                    return read(()=>(0, external_floorp_location_namespaceObject.getInstallGuidance)());
+                default:
+                    return null;
+            }
+        }
+    },
+    "./browsers/run-firefox/firefox-launch/librewolf-overrides.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
+        var node_path__rspack_import_0 = __webpack_require__("node:path");
+        const LIBREWOLF_REMOTE_DEBUGGING_LINES = [
+            'pref("devtools.debugger.remote-enabled", true);',
+            'pref("devtools.debugger.prompt-connection", false);'
+        ];
+        const OVERRIDES_FILE = 'librewolf.overrides.cfg';
+        function librewolfOverridesCandidates(env, platform) {
+            const home = String(env.HOME || env.USERPROFILE || '').trim();
+            const candidates = [];
+            if ('win32' === platform) {
+                if (home) candidates.push(node_path__rspack_import_0.join(home, '.librewolf', OVERRIDES_FILE));
+                return candidates;
+            }
+            if (home) candidates.push(node_path__rspack_import_0.join(home, '.librewolf', OVERRIDES_FILE));
+            const xdg = String(env.XDG_CONFIG_HOME || '').trim();
+            if (xdg) candidates.push(node_path__rspack_import_0.join(xdg, 'librewolf', 'librewolf', OVERRIDES_FILE));
+            if (home) candidates.push(node_path__rspack_import_0.join(home, '.config', 'librewolf', 'librewolf', OVERRIDES_FILE));
+            return candidates;
+        }
+        function librewolfRemoteDebuggingEnabled(fsLike, env, platform) {
+            const candidates = librewolfOverridesCandidates(env, platform);
+            const expectedPath = candidates[0] || node_path__rspack_import_0.join('~', '.librewolf', OVERRIDES_FILE);
+            const enabledLine = /^\s*(?:pref|defaultPref|lockPref)\(\s*"devtools\.debugger\.remote-enabled"\s*,\s*true\s*\)/m;
+            for (const candidate of candidates)try {
+                if (!fsLike.existsSync(candidate)) continue;
+                if (enabledLine.test(fsLike.readFileSync(candidate, 'utf-8'))) return {
+                    enabled: true,
+                    expectedPath: candidate
+                };
+            } catch  {}
+            return {
+                enabled: false,
+                expectedPath
+            };
+        }
+        __webpack_require__.d(__webpack_exports__, {
+            u5: ()=>librewolfRemoteDebuggingEnabled
+        }, {
+            Tu: LIBREWOLF_REMOTE_DEBUGGING_LINES
+        });
     },
     "./browsers/run-only.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
         var node_fs__rspack_import_0 = __webpack_require__("node:fs");
@@ -6957,9 +7057,20 @@ var __webpack_modules__ = {
                 ...body
             ].join('\n');
         }
-        function browserRowValue(browser, versionLine) {
+        const BRAND_SPELLINGS = {
+            librewolf: 'LibreWolf',
+            chromium: 'Chromium',
+            'chromium-based': 'Chromium-based',
+            'gecko-based': 'Gecko-based',
+            'firefox-based': 'Firefox-based',
+            'webkit-based': 'WebKit-based'
+        };
+        function browserDisplayName(browser) {
             const name = String(browser || '').trim() || 'unknown';
-            const display = name.charAt(0).toUpperCase() + name.slice(1);
+            return BRAND_SPELLINGS[name] || name.charAt(0).toUpperCase() + name.slice(1);
+        }
+        function browserRowValue(browser, versionLine) {
+            const display = browserDisplayName(browser);
             const line = String(versionLine || '').trim();
             if (!line) return display;
             if (!/[a-zA-Z]/.test(line)) return `${display} ${line}`;
@@ -7162,6 +7273,7 @@ var __webpack_modules__ = {
             Gg: ()=>humanError,
             Nr: ()=>card,
             Pl: ()=>prefix,
+            QZ: ()=>browserDisplayName,
             Qi: ()=>hasChannelPrefix,
             T_: ()=>artifactNoun,
             VR: ()=>isCardKeyClaimed,

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

@@ -11,6 +11,7 @@ export declare function bestEffortBannerPrintFailed(message: string): string;
 export declare function firefoxRdpRuntimeCapabilitySummary(state: 'available' | 'unavailable'): string;
 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 usingManagedChromiumFamilyFallback(requestedBrowser: Browser, _fallbackBrowser: Browser, _binaryPath: string): string;
 export declare function preferringSystemBrowserOverSnapshot(_systemBinary: string, _snapshotBinary: string): string;
 export declare function mv2NotSupportedByChromium(extensionPath: string): string;
@@ -52,7 +53,8 @@ export declare function chromiumDryRunNotLaunching(): string;
 export declare function chromiumDryRunBinary(path: string): string;
 export declare function chromiumDryRunFlags(flags: string): string;
 export declare function prettyPuppeteerInstallGuidance(browser: Browser, rawGuidance: string, cacheDir: string): string;
-export declare function firefoxLaunchCalled(): string;
+export declare function firefoxLaunchCalled(browser?: Browser | string): string;
+export declare function librewolfRemoteDebuggingLocked(overridesPath: string): string;
 export declare function firefoxBinaryArgsExtracted(args: string): string;
 export declare function firefoxNoBinaryArgsFound(): string;
 export declare function firefoxFailedToStart(error: unknown): string;

package/dist/extension/browsers/run-firefox/firefox-launch/child-output.d.ts

@@ -0,0 +1,11 @@
+import type { ChildProcess } from 'node:child_process';
+import type { Writable } from 'node:stream';
+type ChildStreams = Pick<ChildProcess, 'stdout' | 'stderr'>;
+export declare function attachChildOutput(child: ChildStreams, opts: {
+    debug: boolean;
+    sinks?: {
+        stdout: Writable;
+        stderr: Writable;
+    };
+}): void;
+export {};

package/dist/extension/browsers/run-firefox/firefox-launch/librewolf-overrides.d.ts

@@ -0,0 +1,11 @@
+type FsLike = {
+    existsSync: (p: string) => boolean;
+    readFileSync: (p: string, encoding: 'utf-8') => string;
+};
+export declare const LIBREWOLF_REMOTE_DEBUGGING_LINES: string[];
+export declare function librewolfOverridesCandidates(env: NodeJS.ProcessEnv, platform: NodeJS.Platform): string[];
+export declare function librewolfRemoteDebuggingEnabled(fsLike: FsLike, env: NodeJS.ProcessEnv, platform: NodeJS.Platform): {
+    enabled: boolean;
+    expectedPath: string;
+};
+export {};

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

@@ -1,4 +1,5 @@
-export declare function printRunningInDevelopmentSummary(candidateAddonPaths: string[], browser: 'firefox', extensionId?: string, browserVersionLine?: string, launchIdentity?: {
+import type { BrowserType } from '../../../browsers-types.js';
+export declare function printRunningInDevelopmentSummary(candidateAddonPaths: string[], browser: BrowserType, extensionId?: string, browserVersionLine?: string, launchIdentity?: {
     profilePath?: string;
     binaryPath?: string;
     binaryProvenance?: 'managed' | 'pinned' | 'system' | 'snapshot';

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

@@ -26,6 +26,7 @@ export interface CardInput {
 }
 export declare const MAX_CARD_ROWS = 3;
 export declare function card(input?: CardInput): string;
+export declare function browserDisplayName(browser: string): string;
 export declare function browserRowValue(browser: string, versionLine?: string): string;
 export declare function isCardKeyClaimed(key: string): boolean;
 export declare function claimCardKey(key: string): boolean;

package/package.json

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