extension 4.1.25 → 4.1.27

package/dist/cli.cjs

@@ -71,14 +71,27 @@ var __webpack_modules__ = {
                 return '';
             }
         }
+        function registeredDirectoryPath(dir, platform) {
+            const absolute = node_path__rspack_import_2.resolve(dir);
+            if ('win32' === platform) return absolute;
+            try {
+                return node_fs__rspack_import_1.realpathSync.native(absolute);
+            } catch  {
+                return absolute;
+            }
+        }
+        function upperCaseDriveLetter(windowsPath) {
+            return /^[a-z]:/.test(windowsPath) ? windowsPath[0].toUpperCase() + windowsPath.slice(1) : windowsPath;
+        }
+        function chromiumExtensionIdFromRegisteredPath(registeredPath, platform = process.platform) {
+            const bytes = 'win32' === platform ? Buffer.from(upperCaseDriveLetter(registeredPath.replace(/\//g, '\\')), 'utf16le') : Buffer.from(registeredPath, 'utf8');
+            const digest = (0, node_crypto__rspack_import_0.createHash)('sha256').update(bytes).digest().subarray(0, 16);
+            return encodeChromiumExtensionIdFromDigest(digest);
+        }
         function deriveChromiumExtensionIdFromPath(extensionPath) {
             if (!extensionPath || 'string' != typeof extensionPath) return '';
             try {
-                const absolute = node_path__rspack_import_2.resolve(extensionPath);
-                const isWindows = 'win32' === process.platform;
-                const seedBuffer = isWindows ? Buffer.from(absolute.replace(/\//g, '\\'), 'utf16le') : Buffer.from(absolute, 'utf8');
-                const digest = (0, node_crypto__rspack_import_0.createHash)('sha256').update(seedBuffer).digest().subarray(0, 16);
-                return encodeChromiumExtensionIdFromDigest(digest);
+                return chromiumExtensionIdFromRegisteredPath(registeredDirectoryPath(extensionPath, process.platform), process.platform);
             } catch  {
                 return '';
             }
@@ -275,6 +288,8 @@ var __webpack_modules__ = {
             'firefox',
             'waterfox',
             'librewolf',
+            'zen',
+            'floorp',
             'gecko-based',
             'firefox-based'
         ]);
@@ -284,8 +299,15 @@ var __webpack_modules__ = {
         function isFirefoxBrowser(browser) {
             return FIREFOX_BROWSERS.has(String(browser));
         }
+        const EMULATOR_BROWSERS = new Set([
+            'chromium-emulator'
+        ]);
+        function isEmulatorBrowser(browser) {
+            return EMULATOR_BROWSERS.has(String(browser));
+        }
         __webpack_require__.d(__webpack_exports__, {
             M_: ()=>isFirefoxBrowser,
+            eP: ()=>isEmulatorBrowser,
             rG: ()=>isChromiumBrowser
         });
     },
@@ -421,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);
@@ -497,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();
@@ -546,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.`;
         }
@@ -686,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))}`;
@@ -836,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';
         }
@@ -852,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;
@@ -1025,6 +1052,7 @@ var __webpack_modules__ = {
             _D: ()=>browserLaunchError,
             aI: ()=>devChromeProfilePath,
             aO: ()=>safariOpenHint,
+            bC: ()=>librewolfRemoteDebuggingLocked,
             bv: ()=>cdpUnifiedExtensionLog,
             cD: ()=>targetActorHasActiveRequestError,
             cF: ()=>safariRebuilt,
@@ -1062,6 +1090,7 @@ var __webpack_modules__ = {
             sP: ()=>mv2NotSupportedByChromium,
             sY: ()=>creatingUserProfile,
             uK: ()=>safariConverting,
+            v5: ()=>geckoForkNotInstalled,
             wk: ()=>chromeFailedToSpawn,
             xX: ()=>binaryProvenanceNote,
             xy: ()=>chromeInitializingEnhancedReload,
@@ -1139,7 +1168,7 @@ var __webpack_modules__ = {
             const root = String(cacheRoot || '').trim();
             if (!root) return {};
             if ('safari' === browser || 'webkit-based' === browser) return {};
-            if ('brave' === browser || 'opera' === browser || 'vivaldi' === browser || 'yandex' === browser || 'waterfox' === browser || 'librewolf' === browser) return {};
+            if ('brave' === browser || 'opera' === browser || 'vivaldi' === browser || 'yandex' === browser || 'waterfox' === browser || 'librewolf' === browser || 'zen' === browser || 'floorp' === browser) return {};
             if ('chrome' === browser) return {
                 PUPPETEER_CACHE_DIR: node_path__rspack_import_1.join(root, 'chrome', 'chrome')
             };
@@ -2032,13 +2061,113 @@ var __webpack_modules__ = {
         const external_wsl_support_namespaceObject = require("wsl-support");
     },
     "./browsers/index.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
-        var _browsers_lib_browser_family__rspack_import_0 = __webpack_require__("./browsers/browsers-lib/browser-family.ts");
-        var _browsers_lib_output_binaries_resolver__rspack_import_1 = __webpack_require__("./browsers/browsers-lib/output-binaries-resolver.ts");
-        var _browsers_lib_runtime_options__rspack_import_10 = __webpack_require__("./browsers/browsers-lib/runtime-options.ts");
-        var _run_chromium_chromium_context__rspack_import_8 = __webpack_require__("./browsers/run-chromium/chromium-context/index.ts");
-        var _run_chromium_chromium_launch__rspack_import_2 = __webpack_require__("./browsers/run-chromium/chromium-launch/index.ts");
-        var _run_firefox_firefox_context__rspack_import_9 = __webpack_require__("./browsers/run-firefox/firefox-context/index.ts");
-        var _run_firefox_firefox_launch__rspack_import_3 = __webpack_require__("./browsers/run-firefox/firefox-launch/index.ts");
+        __webpack_require__.d(__webpack_exports__, {
+            launchBrowser: ()=>launchBrowser
+        });
+        var browser_family = __webpack_require__("./browsers/browsers-lib/browser-family.ts");
+        var output_binaries_resolver = __webpack_require__("./browsers/browsers-lib/output-binaries-resolver.ts");
+        var runtime_options = __webpack_require__("./browsers/browsers-lib/runtime-options.ts");
+        var chromium_context = __webpack_require__("./browsers/run-chromium/chromium-context/index.ts");
+        var chromium_launch = __webpack_require__("./browsers/run-chromium/chromium-launch/index.ts");
+        var external_node_child_process_ = __webpack_require__("node:child_process");
+        var external_pintor_ = __webpack_require__("pintor");
+        var external_pintor_default = /*#__PURE__*/ __webpack_require__.n(external_pintor_);
+        var emulator_session = __webpack_require__("./helpers/emulator-session.ts");
+        var messaging = __webpack_require__("./helpers/messaging.ts");
+        function emulatorViewerUrlLine(url) {
+            return `${(0, messaging.Pl)('info')} Emulated Chromium runs in a web page. Open this address to load your extension:\n${external_pintor_default().underline(url)}`;
+        }
+        function emulatorLogsLimitLine() {
+            return `${(0, messaging.Pl)('warn')} --logs has no effect here: ${emulator_session.fg}`;
+        }
+        function openCommandFor(url, platform = process.platform) {
+            if ('darwin' === platform) return {
+                command: 'open',
+                args: [
+                    url
+                ]
+            };
+            if ('win32' === platform) return {
+                command: 'rundll32',
+                args: [
+                    'url.dll,FileProtocolHandler',
+                    url
+                ]
+            };
+            return {
+                command: 'xdg-open',
+                args: [
+                    url
+                ]
+            };
+        }
+        function engineVersionUrl(viewerUrl) {
+            try {
+                const parsed = new URL(viewerUrl);
+                const base = parsed.pathname.endsWith('/') ? parsed.pathname : `${parsed.pathname.replace(/[^/]*$/, '')}`;
+                return `${parsed.origin}${base}version.json`;
+            } catch  {
+                return null;
+            }
+        }
+        async function probeEngineOrigin(viewerUrl, fetchImpl = (url, init)=>fetch(url, init), timeoutMs = 3000) {
+            const url = engineVersionUrl(viewerUrl);
+            if (!url) return 'unknown';
+            const controller = new AbortController();
+            const timer = setTimeout(()=>controller.abort(), timeoutMs);
+            try {
+                const response = await fetchImpl(url, {
+                    signal: controller.signal
+                });
+                if (429 === response.status) return 'throttled';
+                if (503 === response.status) return 'held';
+                if (200 !== response.status) return 'unknown';
+                const report = await response.json();
+                return report && 'held' === report.hold ? 'held' : 'open';
+            } catch  {
+                return 'unknown';
+            } finally{
+                clearTimeout(timer);
+            }
+        }
+        function engineOriginLine(verdict) {
+            if ('held' === verdict) return `${(0, messaging.Pl)('warn')} emulated Chromium is not open to the public yet, so this address answers 503 until it is. Run this project with --browser=chrome in the meantime.`;
+            if ('throttled' === verdict) return `${(0, messaging.Pl)('warn')} the emulated Chromium origin is rate limiting this address (HTTP 429). Wait a minute, then run extension dev again, or run this project with --browser=chrome.`;
+            return null;
+        }
+        function openInDefaultBrowser(url) {
+            const { command, args } = openCommandFor(url);
+            try {
+                const child = (0, external_node_child_process_.spawn)(command, args, {
+                    detached: true,
+                    stdio: 'ignore',
+                    windowsHide: true
+                });
+                child.on('error', ()=>{});
+                child.unref();
+            } catch  {
+                return;
+            }
+        }
+        async function launchEmulator(opts, opener = openInDefaultBrowser, probe = probeEngineOrigin) {
+            if ('development' !== (opts.mode || 'production')) throw new Error('emulated Chromium needs the dev server that serves the files the page reads. Run extension dev instead.');
+            const url = opts.emulatorViewerUrl;
+            if (!url) throw new Error('this version of extension-develop does not serve emulated Chromium. Update extension-develop so it matches the CLI, then run extension dev again.');
+            console.log(emulatorViewerUrlLine(url));
+            const willOpen = !opts.noOpen && !opts.dryRun;
+            const verdict = willOpen ? await probe(url) : 'unknown';
+            const originLine = engineOriginLine(verdict);
+            if (originLine) console.warn(originLine);
+            if (willOpen && !originLine) opener(url);
+            const logsRequested = Boolean(opts.logLevel && 'off' !== opts.logLevel);
+            return {
+                async enableUnifiedLogging () {
+                    if (logsRequested) console.warn(emulatorLogsLimitLine());
+                }
+            };
+        }
+        var firefox_context = __webpack_require__("./browsers/run-firefox/firefox-context/index.ts");
+        var firefox_launch = __webpack_require__("./browsers/run-firefox/firefox-launch/index.ts");
         __webpack_require__("./browsers/run-only.ts");
         __webpack_require__("./browsers/run-safari/safari-launch/index.ts");
         __webpack_require__("./browsers/run-safari/safari-launch/safari-config.ts");
@@ -2058,11 +2187,12 @@ var __webpack_modules__ = {
             };
         }
         async function launchBrowser(opts) {
+            if ((0, browser_family.eP)(opts.browser)) return launchEmulator(opts);
             const compilationLike = createCompilationLike(opts);
             const mode = opts.mode || 'production';
-            (0, _browsers_lib_output_binaries_resolver__rspack_import_1.LB)(compilationLike);
-            if ((0, _browsers_lib_browser_family__rspack_import_0.rG)(opts.browser)) return launchChromium(opts, compilationLike, mode);
-            if ((0, _browsers_lib_browser_family__rspack_import_0.M_)(opts.browser)) return launchFirefox(opts, compilationLike, mode);
+            (0, output_binaries_resolver.LB)(compilationLike);
+            if ((0, browser_family.rG)(opts.browser)) return launchChromium(opts, compilationLike, mode);
+            if ((0, browser_family.M_)(opts.browser)) return launchFirefox(opts, compilationLike, mode);
             throw new Error(`Unsupported browser: ${String(opts.browser)}`);
         }
         async function launchChromium(opts, compilationLike, mode) {
@@ -2091,8 +2221,8 @@ var __webpack_modules__ = {
                 logTab: opts.logTab,
                 logSink: opts.logSink
             };
-            const ctx = (0, _run_chromium_chromium_context__rspack_import_8.g)();
-            const launcher = new _run_chromium_chromium_launch__rspack_import_2.f(chromiumOpts, ctx);
+            const ctx = (0, chromium_context.g)();
+            const launcher = new chromium_launch.f(chromiumOpts, ctx);
             const enableCdp = 'development' === mode;
             await launcher.runOnce(compilationLike, {
                 enableCdpPostLaunch: enableCdp
@@ -2166,9 +2296,9 @@ var __webpack_modules__ = {
                 port: opts.port,
                 dryRun: opts.dryRun
             };
-            const ctx = (0, _run_firefox_firefox_context__rspack_import_9.D)();
-            const launcher = new _run_firefox_firefox_launch__rspack_import_3.c(firefoxOpts, ctx);
-            const launchRequest = (0, _browsers_lib_runtime_options__rspack_import_10.zU)(pluginOptions, mode, {
+            const ctx = (0, firefox_context.D)();
+            const launcher = new firefox_launch.c(firefoxOpts, ctx);
+            const launchRequest = (0, runtime_options.zU)(pluginOptions, mode, {
                 persistProfile: opts.persistProfile,
                 geckoBinary: opts.geckoBinary
             });
@@ -2198,9 +2328,6 @@ var __webpack_modules__ = {
                 }
             };
         }
-        __webpack_require__.d(__webpack_exports__, {
-            launchBrowser: ()=>launchBrowser
-        });
     },
     "./browsers/run-chromium/cdp/discovery.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
         __webpack_require__.d(__webpack_exports__, {
@@ -3625,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?.();
@@ -3836,10 +3964,14 @@ var __webpack_modules__ = {
         var external_node_fs_ = __webpack_require__("node:fs");
         var external_firefox_location2_ = __webpack_require__("firefox-location2");
         var external_firefox_location2_default = /*#__PURE__*/ __webpack_require__.n(external_firefox_location2_);
+        const external_floorp_location_namespaceObject = require("floorp-location");
+        var external_floorp_location_default = /*#__PURE__*/ __webpack_require__.n(external_floorp_location_namespaceObject);
         const external_librewolf_location_namespaceObject = require("librewolf-location");
         var external_librewolf_location_default = /*#__PURE__*/ __webpack_require__.n(external_librewolf_location_namespaceObject);
         const external_waterfox_location_namespaceObject = require("waterfox-location");
         var external_waterfox_location_default = /*#__PURE__*/ __webpack_require__.n(external_waterfox_location_namespaceObject);
+        const external_zen_location_namespaceObject = require("zen-location");
+        var external_zen_location_default = /*#__PURE__*/ __webpack_require__.n(external_zen_location_namespaceObject);
         var messaging = __webpack_require__("./helpers/messaging.ts");
         var banner = __webpack_require__("./browsers/browsers-lib/banner.ts");
         var instance_registry = __webpack_require__("./browsers/browsers-lib/instance-registry.ts");
@@ -4245,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) {
@@ -5257,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
@@ -5509,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 {
@@ -5544,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;
@@ -5582,6 +5741,18 @@ var __webpack_modules__ = {
                         });
                         const normalized = normalizePath(located);
                         if (normalized) browserBinaryLocation = normalized;
+                    } else if ('zen' === this.host.browser) {
+                        const located = external_zen_location_default()(true, {
+                            env: process.env
+                        });
+                        const normalized = normalizePath(located);
+                        if (normalized) browserBinaryLocation = normalized;
+                    } else if ('floorp' === this.host.browser) {
+                        const located = external_floorp_location_default()(true, {
+                            env: process.env
+                        });
+                        const normalized = normalizePath(located);
+                        if (normalized) browserBinaryLocation = normalized;
                     } else {
                         const cacheRoot = (0, output_binaries_resolver.LB)(compilation);
                         const env = {
@@ -5753,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;
@@ -5765,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) {
@@ -5787,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)=>{
@@ -5903,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);
@@ -5925,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");
@@ -6710,6 +6946,32 @@ var __webpack_modules__ = {
             w6: ()=>readBrowserInstall
         });
     },
+    "./helpers/emulator-session.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
+        var _vendors__rspack_import_0 = __webpack_require__("./helpers/vendors.ts");
+        const EMULATOR_LOGS_REFUSAL = 'emulated Chromium runs in a web page, so extension logs has nothing to attach to. Open your browser devtools on that page to read the console.';
+        function emulatorRefusalFor(command) {
+            if ('logs' === command) return EMULATOR_LOGS_REFUSAL;
+            return `emulated Chromium runs in a web page and speaks no debugging protocol, so extension ${command} cannot reach it. Work in the page the dev server printed, or run this project with --browser=chrome.`;
+        }
+        function isEmulatorSession(bridge, projectPath, browser, env = process.env) {
+            if ((0, _vendors__rspack_import_0.CM)(browser) && (0, _vendors__rspack_import_0.hs)(env)) return true;
+            const reader = bridge?.readReadyContractDocument;
+            if ('function' != typeof reader) return false;
+            try {
+                return reader(projectPath, browser)?.engine === 'emulator';
+            } catch  {
+                return false;
+            }
+        }
+        function emulatorSessionRefusal(bridge, projectPath, browser, command, env = process.env) {
+            return isEmulatorSession(bridge, projectPath, browser, env) ? emulatorRefusalFor(command) : null;
+        }
+        __webpack_require__.d(__webpack_exports__, {
+            MC: ()=>emulatorSessionRefusal
+        }, {
+            fg: EMULATOR_LOGS_REFUSAL
+        });
+    },
     "./helpers/messaging.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
         var pintor__rspack_import_0 = __webpack_require__("pintor");
         var pintor__rspack_import_0_default = /*#__PURE__*/ __webpack_require__.n(pintor__rspack_import_0);
@@ -6795,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}`;
@@ -6821,6 +7094,8 @@ var __webpack_modules__ = {
             'firefox-based',
             'gecko-based',
             'librewolf',
+            'zen',
+            'floorp',
             'waterfox'
         ]);
         function artifactNoun(browser) {
@@ -6998,6 +7273,7 @@ var __webpack_modules__ = {
             Gg: ()=>humanError,
             Nr: ()=>card,
             Pl: ()=>prefix,
+            QZ: ()=>browserDisplayName,
             Qi: ()=>hasChannelPrefix,
             T_: ()=>artifactNoun,
             VR: ()=>isCardKeyClaimed,
@@ -7011,6 +7287,134 @@ var __webpack_modules__ = {
             Sc: fmt
         });
     },
+    "./helpers/vendors.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
+        const EMULATOR_BROWSER_TARGET = 'chromium-emulator';
+        function isEmulatorLaneEnabled(env = process.env) {
+            const value = String(env.EXTENSION_EXPERIMENTAL_EMULATOR || '').trim().toLowerCase();
+            return '1' === value || 'true' === value;
+        }
+        function isEmulatorVendor(value) {
+            return value === EMULATOR_BROWSER_TARGET;
+        }
+        function isSafariVendor(value) {
+            return 'safari' === value || 'webkit-based' === value;
+        }
+        const SUPPORTED_BROWSER_TARGETS = [
+            'chrome',
+            'chromium',
+            'edge',
+            'firefox',
+            'brave',
+            'opera',
+            'vivaldi',
+            'yandex',
+            'waterfox',
+            'librewolf',
+            'zen',
+            'floorp',
+            'chromium-based',
+            'gecko-based',
+            'firefox-based',
+            'safari',
+            'webkit-based'
+        ];
+        const BROWSER_TARGETS_HELP = SUPPORTED_BROWSER_TARGETS.join(' | ');
+        function supportedBrowserTargets(env = process.env) {
+            return isEmulatorLaneEnabled(env) ? [
+                ...SUPPORTED_BROWSER_TARGETS,
+                EMULATOR_BROWSER_TARGET
+            ] : [
+                ...SUPPORTED_BROWSER_TARGETS
+            ];
+        }
+        const SESSION_BROWSER_TARGETS_HELP = "chrome | chromium | edge | firefox | safari";
+        const NO_SAFARI_BROWSER_TARGETS_HELP = SUPPORTED_BROWSER_TARGETS.filter((target)=>!isSafariVendor(target)).join(' | ');
+        function parseOptionalBoolean(value) {
+            if (void 0 === value) return true;
+            const normalized = String(value).trim().toLowerCase();
+            return ![
+                'false',
+                '0',
+                'no',
+                'off'
+            ].includes(normalized);
+        }
+        const vendors = (browser)=>{
+            const value = browser ?? 'chromium';
+            return 'all' === value ? [
+                'chrome',
+                'edge',
+                'firefox'
+            ] : String(value).split(',').map((part)=>part.trim()).filter(Boolean);
+        };
+        const MANAGED_INSTALL_TARGETS = [
+            'chrome',
+            'chromium',
+            'edge',
+            'firefox',
+            'chromium-based',
+            'gecko-based',
+            'firefox-based'
+        ];
+        const MANAGED_INSTALL_TARGETS_HELP = [
+            ...MANAGED_INSTALL_TARGETS,
+            'all'
+        ].join(' | ');
+        const MANAGED_INSTALL_BINARIES = [
+            'chrome',
+            'chromium',
+            'edge',
+            'firefox'
+        ];
+        const installTargets = (browser)=>'all' === browser ? [
+                ...MANAGED_INSTALL_BINARIES
+            ] : vendors(browser);
+        function validateVendors(vendorsList, onInvalid, options = {}) {
+            const supported = false === options.allowEmulator ? [
+                ...SUPPORTED_BROWSER_TARGETS
+            ] : supportedBrowserTargets();
+            for (const v of vendorsList)if (!supported.includes(v)) {
+                onInvalid(v, supported);
+                return false;
+            }
+            return true;
+        }
+        const MANAGED_INSTALL_TARGET_SET = new Set(MANAGED_INSTALL_TARGETS);
+        const SUPPORTED_BROWSER_TARGET_SET = new Set(SUPPORTED_BROWSER_TARGETS);
+        function classifyManagedInstallTarget(name) {
+            const value = String(name || '').trim().toLowerCase();
+            if (!value) return 'unknown';
+            if (MANAGED_INSTALL_TARGET_SET.has(value)) return 'managed';
+            if (SUPPORTED_BROWSER_TARGET_SET.has(value)) return 'not-installable';
+            return 'unknown';
+        }
+        function firstNonManagedInstallTarget(targetsList) {
+            for (const name of targetsList){
+                const kind = classifyManagedInstallTarget(name);
+                if ('managed' !== kind) return {
+                    name,
+                    kind
+                };
+            }
+            return null;
+        }
+        __webpack_require__.d(__webpack_exports__, {
+            $q: ()=>isSafariVendor,
+            CM: ()=>isEmulatorVendor,
+            RY: ()=>firstNonManagedInstallTarget,
+            hs: ()=>isEmulatorLaneEnabled,
+            sJ: ()=>parseOptionalBoolean,
+            sS: ()=>validateVendors
+        }, {
+            DB: NO_SAFARI_BROWSER_TARGETS_HELP,
+            I9: BROWSER_TARGETS_HELP,
+            L_: MANAGED_INSTALL_TARGETS,
+            OB: installTargets,
+            Xf: SESSION_BROWSER_TARGETS_HELP,
+            b_: MANAGED_INSTALL_TARGETS_HELP,
+            oJ: vendors
+        });
+    },
     "./index.ts" (__unused_rspack_module, __unused_rspack___webpack_exports__, __webpack_require__) {
         const MIN_NODE_MAJOR = 22;
         const MIN_NODE_MINOR = 12;
@@ -7078,6 +7482,7 @@ var __webpack_modules__ = {
         var external_node_fs_default = /*#__PURE__*/ __webpack_require__.n(external_node_fs_);
         var external_node_path_ = __webpack_require__("node:path");
         var external_node_path_default = /*#__PURE__*/ __webpack_require__.n(external_node_path_);
+        var emulator_session = __webpack_require__("./helpers/emulator-session.ts");
         var external_pintor_ = __webpack_require__("pintor");
         var external_pintor_default = /*#__PURE__*/ __webpack_require__.n(external_pintor_);
         var browser_install_outcome = __webpack_require__("./helpers/browser-install-outcome.ts");
@@ -8406,6 +8811,7 @@ Build options
 - ${messages_code('--zip-source')} ${messages_arg('[boolean]')}          Include source files in ZIP
 - ${messages_code('--zip-filename')} ${messages_arg('<name>')}           Custom ZIP filename
 - ${messages_code('--no-addon-lint')}                          Skip the addons.mozilla.org lint of Firefox builds (runs when addons-linter is installed)
+- ${messages_code('--no-minify')}                              Ship readable first-party code (the default for ${messages_code('--browser=opera')}, whose store rejects minified code)
 
 ${external_pintor_default().underline('Centralized logger (terminal output)')}
 - The manager extension embeds a centralized logger that streams events to the CLI.
@@ -8922,96 +9328,7 @@ Cross-browser compatibility
         function sessionLogsPath(bridge, projectPath, browser) {
             return sessionFilePath(bridge, 'logsPath', projectPath, browser, 'logs.ndjson');
         }
-        function isSafariVendor(value) {
-            return 'safari' === value || 'webkit-based' === value;
-        }
-        const SUPPORTED_BROWSER_TARGETS = [
-            'chrome',
-            'chromium',
-            'edge',
-            'firefox',
-            'brave',
-            'opera',
-            'vivaldi',
-            'yandex',
-            'waterfox',
-            'librewolf',
-            'chromium-based',
-            'gecko-based',
-            'firefox-based',
-            'safari',
-            'webkit-based'
-        ];
-        const BROWSER_TARGETS_HELP = SUPPORTED_BROWSER_TARGETS.join(' | ');
-        const SESSION_BROWSER_TARGETS_HELP = "chrome | chromium | edge | firefox | safari";
-        const NO_SAFARI_BROWSER_TARGETS_HELP = SUPPORTED_BROWSER_TARGETS.filter((target)=>!isSafariVendor(target)).join(' | ');
-        function parseOptionalBoolean(value) {
-            if (void 0 === value) return true;
-            const normalized = String(value).trim().toLowerCase();
-            return ![
-                'false',
-                '0',
-                'no',
-                'off'
-            ].includes(normalized);
-        }
-        const vendors = (browser)=>{
-            const value = browser ?? 'chromium';
-            return 'all' === value ? [
-                'chrome',
-                'edge',
-                'firefox'
-            ] : String(value).split(',').map((part)=>part.trim()).filter(Boolean);
-        };
-        const MANAGED_INSTALL_TARGETS = [
-            'chrome',
-            'chromium',
-            'edge',
-            'firefox',
-            'chromium-based',
-            'gecko-based',
-            'firefox-based'
-        ];
-        const MANAGED_INSTALL_TARGETS_HELP = [
-            ...MANAGED_INSTALL_TARGETS,
-            'all'
-        ].join(' | ');
-        const MANAGED_INSTALL_BINARIES = [
-            'chrome',
-            'chromium',
-            'edge',
-            'firefox'
-        ];
-        const installTargets = (browser)=>'all' === browser ? [
-                ...MANAGED_INSTALL_BINARIES
-            ] : vendors(browser);
-        function validateVendors(vendorsList, onInvalid) {
-            const supported = SUPPORTED_BROWSER_TARGETS;
-            for (const v of vendorsList)if (!supported.includes(v)) {
-                onInvalid(v, supported);
-                return false;
-            }
-            return true;
-        }
-        const MANAGED_INSTALL_TARGET_SET = new Set(MANAGED_INSTALL_TARGETS);
-        const SUPPORTED_BROWSER_TARGET_SET = new Set(SUPPORTED_BROWSER_TARGETS);
-        function classifyManagedInstallTarget(name) {
-            const value = String(name || '').trim().toLowerCase();
-            if (!value) return 'unknown';
-            if (MANAGED_INSTALL_TARGET_SET.has(value)) return 'managed';
-            if (SUPPORTED_BROWSER_TARGET_SET.has(value)) return 'not-installable';
-            return 'unknown';
-        }
-        function firstNonManagedInstallTarget(targetsList) {
-            for (const name of targetsList){
-                const kind = classifyManagedInstallTarget(name);
-                if ('managed' !== kind) return {
-                    name,
-                    kind
-                };
-            }
-            return null;
-        }
+        var vendors = __webpack_require__("./helpers/vendors.ts");
         function parseLogSinceLocal(value) {
             if (null == value || '' === value) return null;
             if ('number' == typeof value) return Number.isFinite(value) ? {
@@ -9131,7 +9448,7 @@ Cross-browser compatibility
             }
         }
         function registerLogsCommand(program) {
-            program.command('logs').arguments('[project-path]').usage('[project-path] [options]').description(commandDescriptions.logs).option(`--browser <${SESSION_BROWSER_TARGETS_HELP}>`, 'which dist/extension-js/<browser> to read. Defaults to `chromium`').option('--follow', 'stream live via the control channel instead of printing and exiting').option('--context <list>', 'comma-separated contexts (background, content, popup, options, sidebar, devtools, page)').option('--level <off|error|warn|info|debug|trace|all>', 'minimum severity to show. Defaults to `all`').option('--signals-only', '[experimental] show only structured dx.signal diagnostics. No emitter ships yet, so this currently prints nothing').option('--since <seq|iso>', 'only show events after this sequence number or ISO timestamp').option('--url <glob|substring>', 'only events whose url/hostname matches (glob with * or plain substring)').option('--tab <id>', 'only events from this tab id').option('--output <pretty|json|ndjson>', 'output format. Defaults to pretty on a TTY, ndjson when piped').action(async (projectPathArg, options)=>{
+            program.command('logs').arguments('[project-path]').usage('[project-path] [options]').description(commandDescriptions.logs).option(`--browser <${vendors.Xf}>`, 'which dist/extension-js/<browser> to read. Defaults to `chromium`').option('--follow', 'stream live via the control channel instead of printing and exiting').option('--context <list>', 'comma-separated contexts (background, content, popup, options, sidebar, devtools, page)').option('--level <off|error|warn|info|debug|trace|all>', 'minimum severity to show. Defaults to `all`').option('--signals-only', '[experimental] show only structured dx.signal diagnostics. No emitter ships yet, so this currently prints nothing').option('--since <seq|iso>', 'only show events after this sequence number or ISO timestamp').option('--url <glob|substring>', 'only events whose url/hostname matches (glob with * or plain substring)').option('--tab <id>', 'only events from this tab id').option('--output <pretty|json|ndjson>', 'output format. Defaults to pretty on a TTY, ndjson when piped').action(async (projectPathArg, options)=>{
                 const bridge = await loadExtensionDevelopBridgeModule();
                 const projectPath = resolveSessionProjectPath(bridge, projectPathArg);
                 const browser = options.browser || 'chromium';
@@ -9148,6 +9465,16 @@ Cross-browser compatibility
                     }));
                     process.exit(1);
                 }
+                const emulatorRefusal = (0, emulator_session.MC)(bridge, projectPath, browser, 'logs');
+                if (emulatorRefusal) {
+                    console.error(emulatorRefusal);
+                    if ('pretty' !== format) writeFrame(messaging.Pr.fail('logs', 'failed', {
+                        code: messaging.Lp.E_COMMAND_UNSUPPORTED_FOR_TARGET,
+                        message: emulatorRefusal,
+                        name: 'CliError'
+                    }));
+                    process.exit(1);
+                }
                 const matches = makeFilter(options, since ?? null, helpers);
                 if (options.signalsOnly) console.error("extension logs --signals-only: no signals emitter ships in this build, so dev sessions record no dx.signal events and this filter will print nothing.");
                 if (options.follow) return void await followLogs(projectPath, browser, format, matches);
@@ -9439,6 +9766,11 @@ Cross-browser compatibility
                 plain: refusal.plain,
                 hint: refusal.hint
             });
+            const emulatorRefusal = (0, emulator_session.MC)(bridge, projectPath, browser, input.command);
+            if (emulatorRefusal) fail(emulatorRefusal, {
+                ...outputFrame,
+                code: messaging.Lp.E_COMMAND_UNSUPPORTED_FOR_TARGET
+            });
             const ready = readReadyContract(projectPath, browser);
             if (!ready) fail(`No active control channel found for ${browser}. Looked at ${sessionReadyPath(bridge, projectPath, browser)}. Run \`extension dev --browser=${browser} ${unlockFlag}\` first.`, {
                 ...outputFrame,
@@ -9501,7 +9833,7 @@ Cross-browser compatibility
             if (null != opts.tab && '' !== opts.tab) target.tabId = Number(opts.tab);
             return target;
         }
-        const commonOptions = (cmd)=>cmd.option(`--browser <${SESSION_BROWSER_TARGETS_HELP}>`, 'which session to target (default chromium)').option('--timeout <ms>', 'command timeout in milliseconds (default 5000)').option('--output <pretty|json>', 'output format (default pretty)');
+        const commonOptions = (cmd)=>cmd.option(`--browser <${vendors.Xf}>`, 'which session to target (default chromium)').option('--timeout <ms>', 'command timeout in milliseconds (default 5000)').option('--output <pretty|json>', 'output format (default pretty)');
         function registerActCommands(program) {
             commonOptions(program.command('eval').arguments('<expression> [project-path]').description(commandDescriptions.eval).option('--context <background|popup|options|sidebar|devtools|newtab|history|bookmarks|content|page>', 'target context (default background). Extension pages (popup/options/sidebar/devtools/newtab/history/bookmarks) answer via their own in-page relay and must be open').option('--url <glob|substring>', '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 (expression, projectPathArg, opts)=>{
                 await runCommand({
@@ -9773,15 +10105,15 @@ Cross-browser compatibility
             };
         }
         function registerBuildCommand(program) {
-            program.command('build').arguments('[project-name]').usage('[path-to-remote-extension] [options]').description(commandDescriptions.build).option(`--browser <${BROWSER_TARGETS_HELP}>`, 'specify a browser/engine to run. Defaults to `chromium`. `safari` builds a Safari app via Xcode (macOS only)').option('--polyfill [boolean]', 'whether or not to apply the cross-browser polyfill. Defaults to `false`', parseOptionalBoolean).option('--no-polyfill', 'disable the cross-browser polyfill').option('--zip [boolean]', 'whether or not to compress the extension into a ZIP file. Defaults to `false`', parseOptionalBoolean).option('--zip-source [boolean]', 'whether or not to include the source files in the ZIP file. Defaults to `false`', parseOptionalBoolean).option('--zip-filename <string>', 'specify the name of the ZIP file. Defaults to the extension name and version').option('--silent [boolean]', 'suppress the build summary output. Defaults to `false`', parseOptionalBoolean).option('--addon-lint [boolean]', 'check Firefox builds against addons.mozilla.org rules with addons-linter when it is installed. Findings print as warnings. Defaults to `true`', parseOptionalBoolean).option('--no-addon-lint', 'skip the addons.mozilla.org lint of Firefox builds').option('--install [boolean]', '[internal] install project dependencies when missing', parseOptionalBoolean).option('--extensions <list>', 'comma-separated list of companion extensions or store URLs to load').option('--mode <development|production|none>', 'bundler mode override (also sets NODE_ENV). Defaults to `production`').option('--open [boolean]', 'open the built Safari app after packaging (safari targets only). Defaults to `false`', parseOptionalBoolean).option('--app-name <name>', 'override the Safari app name (safari targets only). Defaults to the manifest `name`').option('--bundle-id <reverse.dns>', 'set a user-owned Safari bundle identifier (safari targets only). Defaults to a generated dev.extensionjs.* id shared by every build of the same source, so set your own before the first submission').option('--development-team <id>', 'sign the Safari app with an Apple Developer team id (safari targets only). Without it the build is ad-hoc signed, which Safari loads locally with no per-launch toggle. Use a team id for a stable identity you can distribute').option('--macos-only [boolean]', 'generate a macOS-only Safari Xcode project (safari targets only). Pass `false` for a universal macOS + iOS project. Defaults to `true`', parseOptionalBoolean).option('--force-regenerate', 'regenerate the Safari Xcode project even when up to date (safari targets only)').option('--output <pretty|json>', 'result format. Use json for a schema-1 envelope on stdout').addOption(new external_commander_namespaceObject.Option('--debug', 'print maintainer diagnostics alongside normal output')).addOption(new external_commander_namespaceObject.Option('--author, --author-mode', 'deprecated alias for --debug').hideHelp()).action(async (pathOrRemoteUrl, { browser: cliBrowser, ...buildOptions })=>{
+            program.command('build').arguments('[project-name]').usage('[path-to-remote-extension] [options]').description(commandDescriptions.build).option(`--browser <${vendors.I9}>`, 'specify a browser/engine to run. Defaults to `chromium`. `safari` builds a Safari app via Xcode (macOS only)').option('--polyfill [boolean]', 'whether or not to apply the cross-browser polyfill. Defaults to `false`', vendors.sJ).option('--no-polyfill', 'disable the cross-browser polyfill').option('--zip [boolean]', 'whether or not to compress the extension into a ZIP file. Defaults to `false`', vendors.sJ).option('--zip-source [boolean]', 'whether or not to include the source files in the ZIP file. Defaults to `false`', vendors.sJ).option('--zip-filename <string>', 'specify the name of the ZIP file. Defaults to the extension name and version').option('--silent [boolean]', 'suppress the build summary output. Defaults to `false`', vendors.sJ).option('--addon-lint [boolean]', 'check Firefox builds against addons.mozilla.org rules with addons-linter when it is installed. Findings print as warnings. Defaults to `true`', vendors.sJ).option('--no-addon-lint', 'skip the addons.mozilla.org lint of Firefox builds').option('--minify [boolean]', 'minify first-party code in production builds. Defaults to `true`, and to `false` for `opera`, whose store rejects minified code', vendors.sJ).option('--no-minify', 'ship readable first-party code, the Opera Add-ons review requirement').option('--install [boolean]', '[internal] install project dependencies when missing', vendors.sJ).option('--extensions <list>', 'comma-separated list of companion extensions or store URLs to load').option('--mode <development|production|none>', 'bundler mode override (also sets NODE_ENV). Defaults to `production`').option('--open [boolean]', 'open the built Safari app after packaging (safari targets only). Defaults to `false`', vendors.sJ).option('--app-name <name>', 'override the Safari app name (safari targets only). Defaults to the manifest `name`').option('--bundle-id <reverse.dns>', 'set a user-owned Safari bundle identifier (safari targets only). Defaults to a generated dev.extensionjs.* id shared by every build of the same source, so set your own before the first submission').option('--development-team <id>', 'sign the Safari app with an Apple Developer team id (safari targets only). Without it the build is ad-hoc signed, which Safari loads locally with no per-launch toggle. Use a team id for a stable identity you can distribute').option('--macos-only [boolean]', 'generate a macOS-only Safari Xcode project (safari targets only). Pass `false` for a universal macOS + iOS project. Defaults to `true`', vendors.sJ).option('--force-regenerate', 'regenerate the Safari Xcode project even when up to date (safari targets only)').option('--output <pretty|json>', 'result format. Use json for a schema-1 envelope on stdout').addOption(new external_commander_namespaceObject.Option('--debug', 'print maintainer diagnostics alongside normal output')).addOption(new external_commander_namespaceObject.Option('--author, --author-mode', 'deprecated alias for --debug').hideHelp()).action(async (pathOrRemoteUrl, { browser: cliBrowser, ...buildOptions })=>{
                 const browser = cliBrowser ?? await resolveConfigBrowser(pathOrRemoteUrl || process.cwd(), 'build') ?? 'chromium';
                 if (buildOptions.debug || buildOptions.author || buildOptions.authorMode) {
                     process.env.EXTENSION_DEBUG = '1';
                     process.env.EXTENSION_AUTHOR_MODE = 'true';
                     if (!process.env.EXTENSION_VERBOSE) process.env.EXTENSION_VERBOSE = '1';
                 }
-                const list = vendors(browser);
-                const vendorsAreSupported = validateVendors(list, (invalid, supported)=>{
+                const list = (0, vendors.oJ)(browser);
+                const vendorsAreSupported = (0, vendors.sS)(list, (invalid, supported)=>{
                     console.error(unsupportedBrowserFlag(invalid, supported));
                 });
                 if (!vendorsAreSupported) process.exit(1);
@@ -9817,7 +10149,7 @@ Cross-browser compatibility
                     ]
                 ].filter(([, value])=>void 0 !== value && false !== value).map(([flag])=>flag);
                 if (void 0 !== buildOptions.macosOnly) safariOnlyFlags.push('--macos-only');
-                if (safariOnlyFlags.length > 0 && !list.some(isSafariVendor)) {
+                if (safariOnlyFlags.length > 0 && !list.some(vendors.$q)) {
                     console.error(safariOnlyOption(safariOnlyFlags));
                     process.exit(1);
                 }
@@ -9826,7 +10158,7 @@ Cross-browser compatibility
                     process.exit(1);
                 }
                 let safariPackagingEnabled = true;
-                if (list.some(isSafariVendor)) {
+                if (list.some(vendors.$q)) {
                     const preflight = (0, safari_launch.QW)();
                     if ('fatal' === preflight.severity) {
                         console.error(preflight.message);
@@ -9854,6 +10186,7 @@ Cross-browser compatibility
                         zipFilename: buildOptions.zipFilename,
                         silent: buildOptions.silent,
                         addonLint: buildOptions.addonLint,
+                        minify: buildOptions.minify,
                         install: buildOptions.install,
                         extensions: parseExtensionsList(buildOptions.extensions),
                         mode,
@@ -9939,7 +10272,7 @@ Cross-browser compatibility
             return messaging.Lp.E_INTERNAL;
         }
         function registerCreateCommand(program) {
-            program.command('create').arguments('<project-name|project-path>').usage('<project-name|project-path> [options]').description(commandDescriptions.create).option('-t, --template <template-name>', `catalog name, GitHub URL, or ZIP URL to scaffold from; every catalog name is listed below (default: ${DEFAULT_TEMPLATE})`).option('--install [boolean]', 'whether or not to install the dependencies after creating the project (disabled by default, pass --install to opt in)', parseOptionalBoolean, false).option('--source <source>', 'attribution tag for where this create was initiated (e.g. cli, templates); recorded in anonymous telemetry only').option('--output <pretty|json>', 'result format. Use json for a schema-1 envelope on stdout').addHelpText('after', renderCreateTemplateHelp()).action(async (pathOrRemoteUrl, { template, install, output })=>{
+            program.command('create').arguments('<project-name|project-path>').usage('<project-name|project-path> [options]').description(commandDescriptions.create).option('-t, --template <template-name>', `catalog name, GitHub URL, or ZIP URL to scaffold from; every catalog name is listed below (default: ${DEFAULT_TEMPLATE})`).option('--install [boolean]', 'whether or not to install the dependencies after creating the project (disabled by default, pass --install to opt in)', vendors.sJ, false).option('--source <source>', 'attribution tag for where this create was initiated (e.g. cli, templates); recorded in anonymous telemetry only').option('--output <pretty|json>', 'result format. Use json for a schema-1 envelope on stdout').addHelpText('after', renderCreateTemplateHelp()).action(async (pathOrRemoteUrl, { template, install, output })=>{
                 const asJson = isJsonOutput({
                     output
                 });
@@ -10419,7 +10752,7 @@ Cross-browser compatibility
             return Number.isFinite(parsed) && parsed >= 0 ? Math.floor(parsed) : 8080;
         }
         function registerDevCommand(program) {
-            program.command('dev').arguments('[project-path|remote-url]').usage('[project-path|remote-url] [options]').description(commandDescriptions.dev).addHelpText('after', "\nAdditional options:\n  --no-browser    stop the browser launch, the dev server still starts\n  --no-reload     emit a dev-mode dist without the content-script reload runtime, tabs need a manual reload to see changes\n  --wait          wait for ready contract and exit, pair with --output json for machine output\n" + BROWSER_LAUNCH_HELP_FOOTER).option('--profile <path-to-file | boolean>', 'what path to use for the browser profile. A boolean value of false sets the profile to the default user profile. Defaults to a fresh profile').option(`-b, --browser <${BROWSER_TARGETS_HELP}>`, 'specify a browser/engine to run. Defaults to `chromium`. `safari` builds and opens a Safari app via Xcode (macOS only)').option('--chromium-binary <path-to-binary>', 'specify a path to the Chromium binary. This option overrides the --browser setting. Defaults to the system default').addOption(geckoBinaryOption()).addOption(firefoxBinaryAliasOption()).option('--safari-binary <path-to-binary>', 'specify the Safari binary to open after packaging (safari targets only)').option('--app-name <name>', 'override the Safari app name (safari targets only). Defaults to the manifest `name`').option('--bundle-id <reverse.dns>', 'set a user-owned Safari bundle identifier (safari targets only). Defaults to a generated dev.extensionjs.* id shared by every build of the same source, so set your own before the first submission').option('--development-team <id>', 'sign the Safari app with an Apple Developer team id (safari targets only). Without it the build is ad-hoc signed, which Safari loads locally with no per-launch toggle. Use a team id for a stable identity you can distribute').option('--macos-only [boolean]', 'generate a macOS-only Safari Xcode project (safari targets only). Pass `false` for a universal macOS + iOS project. Defaults to `true`', parseOptionalBoolean).option('--force-regenerate', 'regenerate the Safari Xcode project even when up to date (safari targets only)').option('--polyfill [boolean]', 'whether or not to apply the cross-browser polyfill. Defaults to `true`', parseOptionalBoolean).option('--no-polyfill', 'disable the cross-browser polyfill').option('--no-open', NO_OPEN_FLAG_DESCRIPTION).option('--starting-url <url>', 'specify the starting URL for the browser. Defaults to `undefined`').option('--port <port>', 'specify the port to use for the development server. Defaults to `8080`').option('--host <host>', 'specify the host to bind the dev server to. Use 0.0.0.0 for Docker/devcontainers. Defaults to `127.0.0.1`').option('--public-host <host>', 'connectable host the browser (HMR + reload bridge) dials when it differs from the bind host (e.g. a remote/devcontainer). Defaults to the bind host, or 127.0.0.1 when bound to 0.0.0.0').option('--log-context <list>', '[experimental] comma-separated contexts to include (background,content,page,sidebar,popup,options,devtools). Use `all` to include all contexts (default)').option('--logs <off|error|warn|info|debug|trace|all>', '[experimental] minimum centralized logger level to display in terminal (default: off)').option('--log-format <pretty|json|ndjson>', '[experimental] output format for logger events. Defaults to `pretty`').option('--no-log-timestamps', 'disable ISO timestamps in pretty output').option('--no-log-color', 'disable color in pretty output').option('--log-url <pattern>', '[experimental] only show logs where event.url matches this substring or regex (/re/i)').option('--log-tab <id>', 'only show logs for a specific tabId (number)').option('--extensions <list>', 'comma-separated list of companion extensions or store URLs to load').option('--install [boolean]', '[internal] install project dependencies when missing', parseOptionalBoolean).option('--wait [boolean]', 'wait for dist/extension-js/<browser>/ready.json and exit', parseOptionalBoolean).option('--wait-timeout <ms>', 'timeout in milliseconds when using --wait (default: 60000)').option('--output <pretty|json>', 'result format. Use json for a schema-1 envelope on stdout').addOption(new external_commander_namespaceObject.Option('--wait-format <pretty|json>').hideHelp()).addOption(new external_commander_namespaceObject.Option('--debug', 'print maintainer diagnostics alongside normal output')).addOption(new external_commander_namespaceObject.Option('--author, --author-mode', 'deprecated alias for --debug').hideHelp()).option('--allow-control', 'enable the agent-bridge control channel for bounded act (storage/reload/open): see `extension reload|storage|open`').option('--allow-eval', 'additionally enable `extension eval` (implies --allow-control, runs arbitrary code in a context, writes a 0600 session token)').option('--parent-pid <pid>', 'exit when the given process dies. For wrappers that spawn `extension dev`, so a leaked dev server can never outlive its owner').action(async (pathOrRemoteUrl, options, command)=>{
+            program.command('dev').arguments('[project-path|remote-url]').usage('[project-path|remote-url] [options]').description(commandDescriptions.dev).addHelpText('after', "\nAdditional options:\n  --no-browser    stop the browser launch, the dev server still starts\n  --no-reload     emit a dev-mode dist without the content-script reload runtime, tabs need a manual reload to see changes\n  --wait          wait for ready contract and exit, pair with --output json for machine output\n" + BROWSER_LAUNCH_HELP_FOOTER).option('--profile <path-to-file | boolean>', 'what path to use for the browser profile. A boolean value of false sets the profile to the default user profile. Defaults to a fresh profile').option(`-b, --browser <${vendors.I9}>`, 'specify a browser/engine to run. Defaults to `chromium`. `safari` builds and opens a Safari app via Xcode (macOS only)').option('--chromium-binary <path-to-binary>', 'specify a path to the Chromium binary. This option overrides the --browser setting. Defaults to the system default').addOption(geckoBinaryOption()).addOption(firefoxBinaryAliasOption()).option('--safari-binary <path-to-binary>', 'specify the Safari binary to open after packaging (safari targets only)').option('--app-name <name>', 'override the Safari app name (safari targets only). Defaults to the manifest `name`').option('--bundle-id <reverse.dns>', 'set a user-owned Safari bundle identifier (safari targets only). Defaults to a generated dev.extensionjs.* id shared by every build of the same source, so set your own before the first submission').option('--development-team <id>', 'sign the Safari app with an Apple Developer team id (safari targets only). Without it the build is ad-hoc signed, which Safari loads locally with no per-launch toggle. Use a team id for a stable identity you can distribute').option('--macos-only [boolean]', 'generate a macOS-only Safari Xcode project (safari targets only). Pass `false` for a universal macOS + iOS project. Defaults to `true`', vendors.sJ).option('--force-regenerate', 'regenerate the Safari Xcode project even when up to date (safari targets only)').option('--polyfill [boolean]', 'whether or not to apply the cross-browser polyfill. Defaults to `true`', vendors.sJ).option('--no-polyfill', 'disable the cross-browser polyfill').option('--no-open', NO_OPEN_FLAG_DESCRIPTION).option('--starting-url <url>', 'specify the starting URL for the browser. Defaults to `undefined`').option('--port <port>', 'specify the port to use for the development server. Defaults to `8080`').option('--host <host>', 'specify the host to bind the dev server to. Use 0.0.0.0 for Docker/devcontainers. Defaults to `127.0.0.1`').option('--public-host <host>', 'connectable host the browser (HMR + reload bridge) dials when it differs from the bind host (e.g. a remote/devcontainer). Defaults to the bind host, or 127.0.0.1 when bound to 0.0.0.0').option('--log-context <list>', '[experimental] comma-separated contexts to include (background,content,page,sidebar,popup,options,devtools). Use `all` to include all contexts (default)').option('--logs <off|error|warn|info|debug|trace|all>', '[experimental] minimum centralized logger level to display in terminal (default: off)').option('--log-format <pretty|json|ndjson>', '[experimental] output format for logger events. Defaults to `pretty`').option('--no-log-timestamps', 'disable ISO timestamps in pretty output').option('--no-log-color', 'disable color in pretty output').option('--log-url <pattern>', '[experimental] only show logs where event.url matches this substring or regex (/re/i)').option('--log-tab <id>', 'only show logs for a specific tabId (number)').option('--extensions <list>', 'comma-separated list of companion extensions or store URLs to load').option('--install [boolean]', '[internal] install project dependencies when missing', vendors.sJ).option('--wait [boolean]', 'wait for dist/extension-js/<browser>/ready.json and exit', vendors.sJ).option('--wait-timeout <ms>', 'timeout in milliseconds when using --wait (default: 60000)').option('--output <pretty|json>', 'result format. Use json for a schema-1 envelope on stdout').addOption(new external_commander_namespaceObject.Option('--wait-format <pretty|json>').hideHelp()).addOption(new external_commander_namespaceObject.Option('--debug', 'print maintainer diagnostics alongside normal output')).addOption(new external_commander_namespaceObject.Option('--author, --author-mode', 'deprecated alias for --debug').hideHelp()).option('--allow-control', 'enable the agent-bridge control channel for bounded act (storage/reload/open): see `extension reload|storage|open`').option('--allow-eval', 'additionally enable `extension eval` (implies --allow-control, runs arbitrary code in a context, writes a 0600 session token)').option('--parent-pid <pid>', 'exit when the given process dies. For wrappers that spawn `extension dev`, so a leaked dev server can never outlive its owner').action(async (pathOrRemoteUrl, options, command)=>{
                 const { browser: cliBrowser, ...devOptions } = options;
                 const browser = cliBrowser ?? await resolveConfigBrowser(pathOrRemoteUrl || process.cwd(), 'dev') ?? 'chromium';
                 if (devOptions.debug || devOptions.author || devOptions.authorMode) {
@@ -10442,9 +10775,9 @@ Cross-browser compatibility
                     }
                     setupParentWatchdog(parentPid);
                 }
-                const list = vendors(browser);
+                const list = (0, vendors.oJ)(browser);
                 let unsupportedBrowser = '';
-                const vendorsAreSupported = validateVendors(list, (invalid, supported)=>{
+                const vendorsAreSupported = (0, vendors.sS)(list, (invalid, supported)=>{
                     unsupportedBrowser = invalid;
                     console.error(unsupportedBrowserFlag(invalid, supported));
                 });
@@ -10476,7 +10809,7 @@ Cross-browser compatibility
                     ]
                 ].filter(([, value])=>void 0 !== value && false !== value).map(([flag])=>flag);
                 if (void 0 !== opts.macosOnly) safariOnlyFlags.push('--macos-only');
-                if (safariOnlyFlags.length > 0 && !list.some(isSafariVendor)) {
+                if (safariOnlyFlags.length > 0 && !list.some(vendors.$q)) {
                     console.error(safariOnlyOption(safariOnlyFlags));
                     failAndExit(asJson, 'usage', {
                         code: messaging.Lp.E_INVALID_OPTION,
@@ -10490,7 +10823,7 @@ Cross-browser compatibility
                         message: `--bundle-id expects a reverse-DNS identifier, got: ${opts.bundleId}`
                     });
                 }
-                if (list.some(isSafariVendor)) {
+                if (list.some(vendors.$q)) {
                     const issue = (0, safari_launch.iF)();
                     if (issue) {
                         console.error(issue);
@@ -10666,6 +10999,15 @@ Cross-browser compatibility
                 detail: `multiple live sessions found (${sessionBrowsers.join(', ')}), diagnosing ${browser}`,
                 remediation: 'Pass --browser=<name> to diagnose a specific session'
             });
+            const emulatorRefusal = (0, emulator_session.MC)(bridge, projectPath, browser, 'doctor');
+            if (emulatorRefusal) {
+                results.push({
+                    check: 'engine',
+                    status: 'fail',
+                    detail: emulatorRefusal
+                });
+                return results;
+            }
             const skip = (check, blockedBy)=>{
                 results.push({
                     check,
@@ -10898,10 +11240,11 @@ Cross-browser compatibility
             'control-channel': messaging.Lp.E_CONTROL_UNAVAILABLE,
             'eval-token': messaging.Lp.E_TOKEN_MISSING,
             executor: messaging.Lp.E_CONTROL_UNAVAILABLE,
-            browser: messaging.Lp.E_BROWSER_LAUNCH
+            browser: messaging.Lp.E_BROWSER_LAUNCH,
+            engine: messaging.Lp.E_COMMAND_UNSUPPORTED_FOR_TARGET
         };
         function registerDoctorCommand(program) {
-            program.command('doctor').argument('[project-path]', 'path to the extension project root or the folder holding its manifest').option(`--browser <${SESSION_BROWSER_TARGETS_HELP}>`, 'which session to diagnose (defaults to the single live session, else chromium)').option('--output <pretty|json>', 'result format. Use json for a schema-1 envelope on stdout').description(commandDescriptions.doctor).action(async (projectPathArg, opts)=>{
+            program.command('doctor').argument('[project-path]', 'path to the extension project root or the folder holding its manifest').option(`--browser <${vendors.Xf}>`, 'which session to diagnose (defaults to the single live session, else chromium)').option('--output <pretty|json>', 'result format. Use json for a schema-1 envelope on stdout').description(commandDescriptions.doctor).action(async (projectPathArg, opts)=>{
                 const asJson = isJsonOutput(opts);
                 let results;
                 try {
@@ -10949,7 +11292,7 @@ Cross-browser compatibility
             await exitAfterDrain(1);
         }
         async function refuseIfNotManagedTarget(command, browserList, asJson) {
-            const bad = firstNonManagedInstallTarget(browserList);
+            const bad = (0, vendors.RY)(browserList);
             if (!bad) return false;
             if ('not-installable' === bad.kind) {
                 const message = browserNotInstallablePlain(bad.name);
@@ -10966,7 +11309,7 @@ Cross-browser compatibility
                 message: `Unsupported browser: ${bad.name}.`
             }));
             else console.error(unsupportedBrowserFlag(bad.name, [
-                ...MANAGED_INSTALL_TARGETS
+                ...vendors.L_
             ]));
             await exitAfterDrain(1);
             return true;
@@ -10983,11 +11326,11 @@ Cross-browser compatibility
             await exitAfterDrain(1);
         }
         function registerInstallCommand(program) {
-            program.command('install').arguments('[browser-name]').usage('[browser-name] [options]').description(commandDescriptions.install).option(`--browser <${MANAGED_INSTALL_TARGETS_HELP}>`, 'override the positional browser name. Supports comma-separated values and `all`.').option('--where', 'print the resolved managed browser cache root').option('--output <pretty|json>', 'result format. Use json for a schema-1 envelope on stdout').action(async (browserArg, options)=>{
+            program.command('install').arguments('[browser-name]').usage('[browser-name] [options]').description(commandDescriptions.install).option(`--browser <${vendors.b_}>`, 'override the positional browser name. Supports comma-separated values and `all`.').option('--where', 'print the resolved managed browser cache root').option('--output <pretty|json>', 'result format. Use json for a schema-1 envelope on stdout').action(async (browserArg, options)=>{
                 const asJson = isJsonOutput(options);
                 const named = Boolean(options.browser || browserArg);
                 const selectedBrowser = options.browser || browserArg || 'chromium';
-                const browserList = installTargets(selectedBrowser);
+                const browserList = (0, vendors.OB)(selectedBrowser);
                 if (!(options.where && !named)) {
                     if (await refuseIfNotManagedTarget('install', browserList, asJson)) return;
                 }
@@ -11023,7 +11366,7 @@ Cross-browser compatibility
                     browsers: installed
                 }));
             });
-            program.command('uninstall').usage('<browser-name> | --all | --where').description(commandDescriptions.uninstall).option(`--browser <${MANAGED_INSTALL_TARGETS_HELP}>`, 'browser(s) to uninstall. Supports comma-separated values and `all`.').option('--all', 'remove all managed browser binaries').option('--where', 'print the resolved managed browser cache root').option('--output <pretty|json>', 'result format. Use json for a schema-1 envelope on stdout').argument('[browser-name]').action(async (browserArg, { browser, all, where, output })=>{
+            program.command('uninstall').usage('<browser-name> | --all | --where').description(commandDescriptions.uninstall).option(`--browser <${vendors.b_}>`, 'browser(s) to uninstall. Supports comma-separated values and `all`.').option('--all', 'remove all managed browser binaries').option('--where', 'print the resolved managed browser cache root').option('--output <pretty|json>', 'result format. Use json for a schema-1 envelope on stdout').argument('[browser-name]').action(async (browserArg, { browser, all, where, output })=>{
                 const asJson = isJsonOutput({
                     output
                 });
@@ -11050,7 +11393,7 @@ Cross-browser compatibility
                     await exitAfterDrain(1);
                     return;
                 }
-                const browserList = installTargets(selected);
+                const browserList = (0, vendors.OB)(selected);
                 if (await refuseIfNotManagedTarget('uninstall', browserList, asJson)) return;
                 if (where) {
                     let paths;
@@ -11094,7 +11437,7 @@ Cross-browser compatibility
             'Manifest file not found'
         ];
         function registerPreviewCommand(program) {
-            program.command('preview').arguments('[project-name]').usage('[path-to-remote-extension] [options]').description(commandDescriptions.preview).addHelpText('after', "\nAdditional options:\n  --no-browser    stop the browser launch\n" + BROWSER_LAUNCH_HELP_FOOTER).option('--profile <path-to-file | boolean>', 'what path to use for the browser profile. A boolean value of false sets the profile to the default user profile. Defaults to a fresh profile').option(`--browser <${NO_SAFARI_BROWSER_TARGETS_HELP}>`, 'specify a browser/engine to run. Defaults to `chromium`').option('--chromium-binary <path-to-binary>', 'specify a path to the Chromium binary. This option overrides the --browser setting. Defaults to the system default').addOption(geckoBinaryOption()).addOption(firefoxBinaryAliasOption()).option('--no-open', NO_OPEN_FLAG_DESCRIPTION).option('--starting-url <url>', 'specify the starting URL for the browser. Defaults to `undefined`').option('--port <port>', 'specify the port to use for the development server. Defaults to `8080`').option('--log-context <list>', '[experimental] comma-separated contexts to include (background,content,page,sidebar,popup,options,devtools). Use `all` to include all contexts (default)').option('--logs <off|error|warn|info|debug|trace|all>', '[experimental] minimum centralized logger level to display in terminal (default: off)').option('--log-format <pretty|json|ndjson>', '[experimental] output format for logger events. Defaults to `pretty`').option('--no-log-timestamps', 'disable ISO timestamps in pretty output').option('--no-log-color', 'disable color in pretty output').option('--log-url <pattern>', '[experimental] only show logs where event.url matches this substring or regex (/re/i)').option('--log-tab <id>', 'only show logs for a specific tabId (number)').option('--extensions <list>', 'comma-separated list of companion extensions or store URLs to load').option('--output-path <dir>', 'path to an existing unpacked extension directory. Defaults to dist/<browser> when available').option('--output <pretty|json>', 'result format. Use json for a schema-1 envelope on stdout').addOption(new external_commander_namespaceObject.Option('--debug', 'print maintainer diagnostics alongside normal output')).addOption(new external_commander_namespaceObject.Option('--author, --author-mode', 'deprecated alias for --debug').hideHelp()).action(async (pathOrRemoteUrl, options, command)=>{
+            program.command('preview').arguments('[project-name]').usage('[path-to-remote-extension] [options]').description(commandDescriptions.preview).addHelpText('after', "\nAdditional options:\n  --no-browser    stop the browser launch\n" + BROWSER_LAUNCH_HELP_FOOTER).option('--profile <path-to-file | boolean>', 'what path to use for the browser profile. A boolean value of false sets the profile to the default user profile. Defaults to a fresh profile').option(`--browser <${vendors.DB}>`, 'specify a browser/engine to run. Defaults to `chromium`').option('--chromium-binary <path-to-binary>', 'specify a path to the Chromium binary. This option overrides the --browser setting. Defaults to the system default').addOption(geckoBinaryOption()).addOption(firefoxBinaryAliasOption()).option('--no-open', NO_OPEN_FLAG_DESCRIPTION).option('--starting-url <url>', 'specify the starting URL for the browser. Defaults to `undefined`').option('--port <port>', 'specify the port to use for the development server. Defaults to `8080`').option('--log-context <list>', '[experimental] comma-separated contexts to include (background,content,page,sidebar,popup,options,devtools). Use `all` to include all contexts (default)').option('--logs <off|error|warn|info|debug|trace|all>', '[experimental] minimum centralized logger level to display in terminal (default: off)').option('--log-format <pretty|json|ndjson>', '[experimental] output format for logger events. Defaults to `pretty`').option('--no-log-timestamps', 'disable ISO timestamps in pretty output').option('--no-log-color', 'disable color in pretty output').option('--log-url <pattern>', '[experimental] only show logs where event.url matches this substring or regex (/re/i)').option('--log-tab <id>', 'only show logs for a specific tabId (number)').option('--extensions <list>', 'comma-separated list of companion extensions or store URLs to load').option('--output-path <dir>', 'path to an existing unpacked extension directory. Defaults to dist/<browser> when available').option('--output <pretty|json>', 'result format. Use json for a schema-1 envelope on stdout').addOption(new external_commander_namespaceObject.Option('--debug', 'print maintainer diagnostics alongside normal output')).addOption(new external_commander_namespaceObject.Option('--author, --author-mode', 'deprecated alias for --debug').hideHelp()).action(async (pathOrRemoteUrl, options, command)=>{
                 const { browser: cliBrowser, ...previewOptions } = options;
                 const browser = cliBrowser ?? await resolveConfigBrowser(pathOrRemoteUrl || process.cwd(), 'preview') ?? 'chromium';
                 if (previewOptions.debug || previewOptions.author || previewOptions.authorMode) {
@@ -11107,12 +11450,14 @@ Cross-browser compatibility
                 const emit = (frame)=>{
                     console.log(JSON.stringify(frame));
                 };
-                const list = vendors(browser);
+                const list = (0, vendors.oJ)(browser);
                 let unsupported = '';
-                const vendorsAreSupported = validateVendors(list, (invalid, supported)=>{
+                const vendorsAreSupported = (0, vendors.sS)(list, (invalid, supported)=>{
                     unsupported = invalid;
                     if (asJson) return;
                     console.error(unsupportedBrowserFlag(invalid, supported));
+                }, {
+                    allowEmulator: false
                 });
                 if (!vendorsAreSupported) {
                     if (asJson) emit(messaging.Pr.fail('preview', 'usage', {
@@ -11122,7 +11467,7 @@ Cross-browser compatibility
                     await exitAfterDrain(1);
                     return;
                 }
-                if (list.some(isSafariVendor)) {
+                if (list.some(vendors.$q)) {
                     if (asJson) emit(messaging.Pr.fail('preview', 'usage', {
                         code: messaging.Lp.E_COMMAND_UNSUPPORTED_FOR_TARGET,
                         message: 'Safari is not supported by preview.'
@@ -11361,7 +11706,7 @@ Cross-browser compatibility
             return Number.isFinite(parsed) && parsed >= 0 ? Math.floor(parsed) : 8080;
         }
         function registerStartCommand(program) {
-            program.command('start').arguments('[project-path|remote-url]').usage('[project-path|remote-url] [options]').description(commandDescriptions.start).addHelpText('after', "\nAdditional options:\n  --no-browser    stop the browser launch, the build still runs\n  --wait          wait for ready contract and exit, pair with --output json for machine output\n" + BROWSER_LAUNCH_HELP_FOOTER).option('--profile <path-to-file | boolean>', 'what path to use for the browser profile. A boolean value of false sets the profile to the default user profile. Defaults to a fresh profile').option(`--browser <${NO_SAFARI_BROWSER_TARGETS_HELP}>`, 'specify a browser/engine to run. Defaults to `chromium`').option('--polyfill [boolean]', 'whether or not to apply the cross-browser polyfill. Defaults to `true`', parseOptionalBoolean).option('--no-polyfill', 'disable the cross-browser polyfill').option('--no-open', NO_OPEN_FLAG_DESCRIPTION).option('--chromium-binary <path-to-binary>', 'specify a path to the Chromium binary. This option overrides the --browser setting. Defaults to the system default').addOption(geckoBinaryOption()).addOption(firefoxBinaryAliasOption()).option('--starting-url <url>', 'specify the starting URL for the browser. Defaults to `undefined`').option('--port <port>', 'specify the port to use for the development server. Defaults to `8080`').option('--host <host>', 'specify the host to bind the dev server to. Use 0.0.0.0 for Docker/devcontainers. Defaults to `127.0.0.1`').option('--public-host <host>', 'connectable host the browser (HMR + reload bridge) dials when it differs from the bind host (e.g. a remote/devcontainer). Defaults to the bind host, or 127.0.0.1 when bound to 0.0.0.0').option('--log-context <list>', '[experimental] comma-separated contexts to include (background,content,page,sidebar,popup,options,devtools). Use `all` to include all contexts (default)').option('--logs <off|error|warn|info|debug|trace|all>', '[experimental] minimum centralized logger level to display in terminal (default: off)').option('--log-format <pretty|json|ndjson>', '[experimental] output format for logger events. Defaults to `pretty`').option('--no-log-timestamps', 'disable ISO timestamps in pretty output').option('--no-log-color', 'disable color in pretty output').option('--log-url <pattern>', '[experimental] only show logs where event.url matches this substring or regex (/re/i)').option('--log-tab <id>', 'only show logs for a specific tabId (number)').option('--extensions <list>', 'comma-separated list of companion extensions or store URLs to load').option('--install [boolean]', '[internal] install project dependencies when missing', parseOptionalBoolean).option('--wait [boolean]', 'wait for dist/extension-js/<browser>/ready.json and exit', parseOptionalBoolean).option('--wait-timeout <ms>', 'timeout in milliseconds when using --wait (default: 60000)').option('--output <pretty|json>', 'result format. Use json for a schema-1 envelope on stdout').addOption(new external_commander_namespaceObject.Option('--wait-format <pretty|json>').hideHelp()).addOption(new external_commander_namespaceObject.Option('--debug', 'print maintainer diagnostics alongside normal output')).addOption(new external_commander_namespaceObject.Option('--author, --author-mode', 'deprecated alias for --debug').hideHelp()).action(async (pathOrRemoteUrl, options, command)=>{
+            program.command('start').arguments('[project-path|remote-url]').usage('[project-path|remote-url] [options]').description(commandDescriptions.start).addHelpText('after', "\nAdditional options:\n  --no-browser    stop the browser launch, the build still runs\n  --wait          wait for ready contract and exit, pair with --output json for machine output\n" + BROWSER_LAUNCH_HELP_FOOTER).option('--profile <path-to-file | boolean>', 'what path to use for the browser profile. A boolean value of false sets the profile to the default user profile. Defaults to a fresh profile').option(`--browser <${vendors.DB}>`, 'specify a browser/engine to run. Defaults to `chromium`').option('--polyfill [boolean]', 'whether or not to apply the cross-browser polyfill. Defaults to `true`', vendors.sJ).option('--no-polyfill', 'disable the cross-browser polyfill').option('--no-open', NO_OPEN_FLAG_DESCRIPTION).option('--chromium-binary <path-to-binary>', 'specify a path to the Chromium binary. This option overrides the --browser setting. Defaults to the system default').addOption(geckoBinaryOption()).addOption(firefoxBinaryAliasOption()).option('--starting-url <url>', 'specify the starting URL for the browser. Defaults to `undefined`').option('--port <port>', 'specify the port to use for the development server. Defaults to `8080`').option('--host <host>', 'specify the host to bind the dev server to. Use 0.0.0.0 for Docker/devcontainers. Defaults to `127.0.0.1`').option('--public-host <host>', 'connectable host the browser (HMR + reload bridge) dials when it differs from the bind host (e.g. a remote/devcontainer). Defaults to the bind host, or 127.0.0.1 when bound to 0.0.0.0').option('--log-context <list>', '[experimental] comma-separated contexts to include (background,content,page,sidebar,popup,options,devtools). Use `all` to include all contexts (default)').option('--logs <off|error|warn|info|debug|trace|all>', '[experimental] minimum centralized logger level to display in terminal (default: off)').option('--log-format <pretty|json|ndjson>', '[experimental] output format for logger events. Defaults to `pretty`').option('--no-log-timestamps', 'disable ISO timestamps in pretty output').option('--no-log-color', 'disable color in pretty output').option('--log-url <pattern>', '[experimental] only show logs where event.url matches this substring or regex (/re/i)').option('--log-tab <id>', 'only show logs for a specific tabId (number)').option('--extensions <list>', 'comma-separated list of companion extensions or store URLs to load').option('--install [boolean]', '[internal] install project dependencies when missing', vendors.sJ).option('--wait [boolean]', 'wait for dist/extension-js/<browser>/ready.json and exit', vendors.sJ).option('--wait-timeout <ms>', 'timeout in milliseconds when using --wait (default: 60000)').option('--output <pretty|json>', 'result format. Use json for a schema-1 envelope on stdout').addOption(new external_commander_namespaceObject.Option('--wait-format <pretty|json>').hideHelp()).addOption(new external_commander_namespaceObject.Option('--debug', 'print maintainer diagnostics alongside normal output')).addOption(new external_commander_namespaceObject.Option('--author, --author-mode', 'deprecated alias for --debug').hideHelp()).action(async (pathOrRemoteUrl, options, command)=>{
                 const { browser: cliBrowser, ...startOptions } = options;
                 const browser = cliBrowser ?? await resolveConfigBrowser(pathOrRemoteUrl || process.cwd(), 'start') ?? 'chromium';
                 if (startOptions.debug || startOptions.author || startOptions.authorMode) {
@@ -11373,18 +11718,20 @@ Cross-browser compatibility
                 const cliVersion = checkProjectCliVersion(external_node_path_.resolve(pathOrRemoteUrl || process.cwd()), getCliPackageJson().version);
                 if (cliVersion) console.warn(projectCliVersionMismatch(cliVersion.running, cliVersion.declared, cliVersion.range, cliVersion.command));
                 if (asJson) process.env.EXTENSION_OUTPUT = 'json';
-                const list = vendors(browser);
+                const list = (0, vendors.oJ)(browser);
                 let unsupportedBrowser = '';
-                const vendorsAreSupported = validateVendors(list, (invalid, supported)=>{
+                const vendorsAreSupported = (0, vendors.sS)(list, (invalid, supported)=>{
                     unsupportedBrowser = invalid;
                     if (asJson) return;
                     console.error(unsupportedBrowserFlag(invalid, supported));
+                }, {
+                    allowEmulator: false
                 });
                 if (!vendorsAreSupported) start_failAndExit(asJson, 'usage', {
                     code: messaging.Lp.E_UNSUPPORTED_BROWSER,
                     message: `Unsupported browser: ${unsupportedBrowser}`
                 });
-                if (list.some(isSafariVendor)) {
+                if (list.some(vendors.$q)) {
                     if (!asJson) console.error(safariCommandNotSupported('start'));
                     start_failAndExit(asJson, 'usage', {
                         code: messaging.Lp.E_COMMAND_UNSUPPORTED_FOR_TARGET,