extension 4.1.25 → 4.1.26

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
         });
     },
@@ -1139,7 +1161,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 +2054,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 +2180,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 +2214,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 +2289,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 +2321,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__, {
@@ -3836,10 +3956,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");
@@ -5582,6 +5706,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 = {
@@ -6710,6 +6846,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);
@@ -6821,6 +6983,8 @@ var __webpack_modules__ = {
             'firefox-based',
             'gecko-based',
             'librewolf',
+            'zen',
+            'floorp',
             'waterfox'
         ]);
         function artifactNoun(browser) {
@@ -7011,6 +7175,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 +7370,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 +8699,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 +9216,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 +9336,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 +9353,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 +9654,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 +9721,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 +9993,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 +10037,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 +10046,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 +10074,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 +10160,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 +10640,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 +10663,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 +10697,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 +10711,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 +10887,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 +11128,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 +11180,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 +11197,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 +11214,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 +11254,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 +11281,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 +11325,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 +11338,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 +11355,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 +11594,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 +11606,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,