extension 4.0.18 → 4.0.19

package/dist/cli.cjs

@@ -149,7 +149,9 @@ var __webpack_modules__ = {
             };
             const updateSuffix = readUpdateSuffixOnce();
             console.log(_messages__rspack_import_5.io());
-            console.log(_messages__rspack_import_5.e_(manifest, opts.browser, message, opts.browserVersionLine, updateSuffix || void 0));
+            console.log(_messages__rspack_import_5.e_(manifest, opts.browser, message, opts.browserVersionLine, updateSuffix || void 0, {
+                profilePath: opts.profilePath
+            }));
             console.log(_messages__rspack_import_5.io());
             markCardPrinted(k, opts.browser, opts.outPath);
             return true;
@@ -188,7 +190,8 @@ var __webpack_modules__ = {
                     console.log(_messages__rspack_import_5.io());
                     console.log(_messages__rspack_import_5.e_(manifest, opts.browser, message, browserLabel, updateSuffix || void 0, {
                         includeExtensionId: opts.includeExtensionId,
-                        runLabel
+                        runLabel,
+                        profilePath: opts.profilePath
                     }));
                     console.log(_messages__rspack_import_5.io());
                 } else {
@@ -205,7 +208,8 @@ var __webpack_modules__ = {
                     console.log(_messages__rspack_import_5.io());
                     console.log(_messages__rspack_import_5.e_(manifest, opts.browser, message, browserLabel, updateSuffix || void 0, {
                         includeExtensionId: opts.includeExtensionId,
-                        runLabel
+                        runLabel,
+                        profilePath: opts.profilePath
                     }));
                     console.log(_messages__rspack_import_5.io());
                 }
@@ -220,6 +224,10 @@ var __webpack_modules__ = {
                         {
                             label: 'Output',
                             value: opts.outPath
+                        },
+                        {
+                            label: 'Profile',
+                            value: opts.profilePath || ''
                         }
                     ]
                 }));
@@ -796,6 +804,10 @@ var __webpack_modules__ = {
                         label: 'Extension ID',
                         value: includeExtensionId ? cleanId : ''
                     },
+                    {
+                        label: 'Profile',
+                        value: String(opts?.profilePath || '').trim()
+                    },
                     {
                         label: 'Run ID',
                         value: opts?.runLabel || ''
@@ -1696,12 +1708,15 @@ var __webpack_modules__ = {
     "./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_7 = __webpack_require__("./browsers/browsers-lib/runtime-options.ts");
-        var _run_chromium_chromium_context__rspack_import_5 = __webpack_require__("./browsers/run-chromium/chromium-context/index.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_6 = __webpack_require__("./browsers/run-firefox/firefox-context/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__("./browsers/run-only.ts");
+        __webpack_require__("./browsers/run-safari/safari-launch/index.ts");
+        __webpack_require__("./browsers/run-safari/safari-launch/safari-config.ts");
+        __webpack_require__("./browsers/run-safari/safari-packager.ts");
         function createCompilationLike(opts) {
             return {
                 options: {
@@ -1750,7 +1765,7 @@ var __webpack_modules__ = {
                 logTab: opts.logTab,
                 logSink: opts.logSink
             };
-            const ctx = (0, _run_chromium_chromium_context__rspack_import_5.g)();
+            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 enableCdp = 'development' === mode;
             await launcher.runOnce(compilationLike, {
@@ -1824,9 +1839,9 @@ var __webpack_modules__ = {
                 port: opts.port,
                 dryRun: opts.dryRun
             };
-            const ctx = (0, _run_firefox_firefox_context__rspack_import_6.D)();
+            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_7.zU)(pluginOptions, mode, {
+            const launchRequest = (0, _browsers_lib_runtime_options__rspack_import_10.zU)(pluginOptions, mode, {
                 persistProfile: opts.persistProfile,
                 geckoBinary: opts.geckoBinary
             });
@@ -2618,10 +2633,13 @@ var __webpack_modules__ = {
             const loadExtensionFlag = args.chromiumConfig.find((flag)=>flag.startsWith('--load-extension='));
             const extensionOutputPath = (0, extension_output_path.W)(args.compilation, loadExtensionFlag);
             if (!extensionOutputPath) return;
+            const userDataDirFlag = args.chromiumConfig.find((flag)=>flag.startsWith('--user-data-dir='));
+            const profilePath = userDataDirFlag ? userDataDirFlag.replace('--user-data-dir=', '').replace(/^"|"$/g, '') : void 0;
             if ('production' === mode) return void await (0, banner.MK)({
                 browser: args.browser,
                 outPath: extensionOutputPath,
-                browserVersionLine: args.browserVersionLine
+                browserVersionLine: args.browserVersionLine,
+                profilePath
             });
             if ('development' !== mode) return;
             const ready = await (0, manifest_readiness.fR)(extensionOutputPath, {
@@ -2634,7 +2652,8 @@ var __webpack_modules__ = {
                 outPath: extensionOutputPath,
                 hostPort: args.hostPort,
                 getInfo: async ()=>null,
-                browserVersionLine: args.browserVersionLine
+                browserVersionLine: args.browserVersionLine,
+                profilePath
             });
         }
         class ChromiumLaunchPlugin {
@@ -5128,1801 +5147,1880 @@ var __webpack_modules__ = {
             E: ()=>runOnlyPreviewBrowser
         });
     },
-    "./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);
-        const GLYPH = '⏵⏵⏵';
-        const DEBUG_GLYPH = '···';
-        const DEBUG_VALUES = new Set([
-            '1',
-            'true',
-            'yes',
-            'on',
-            'debug',
-            'dev',
-            'development'
-        ]);
-        function isDebug() {
-            const raw = process.env.EXTENSION_DEBUG ?? process.env.EXTENSION_AUTHOR_MODE;
-            return DEBUG_VALUES.has(String(raw ?? '').trim().toLowerCase());
+    "./browsers/run-safari/safari-launch/index.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
+        __webpack_require__.d(__webpack_exports__, {
+            Ah: ()=>packageSafariExtension,
+            QW: ()=>safariBuildPreflight,
+            iF: ()=>safariPreflightError
+        });
+        var external_node_child_process_ = __webpack_require__("node:child_process");
+        var external_node_fs_ = __webpack_require__("node:fs");
+        var messaging = __webpack_require__("./helpers/messaging.ts");
+        var messages = __webpack_require__("./browsers/browsers-lib/messages.ts");
+        function logSafariDryRun(converterCmd, xcodebuildCmd) {
+            if ((0, messaging._o)()) console.log(messages.KP());
+            console.log(messages.yc());
+            console.log(messages.fL(converterCmd));
+            console.log(messages.Aj(xcodebuildCmd));
         }
-        function prefix(type) {
-            if ('error' === type) return pintor__rspack_import_0_default().red(GLYPH);
-            if ('warn' === type) return pintor__rspack_import_0_default().brightYellow(GLYPH);
-            if ('success' === type) return pintor__rspack_import_0_default().green(GLYPH);
-            if ('debug' === type) return pintor__rspack_import_0_default().dim(pintor__rspack_import_0_default().gray(DEBUG_GLYPH));
-            return pintor__rspack_import_0_default().gray(GLYPH);
+        var safari_config = __webpack_require__("./browsers/run-safari/safari-launch/safari-config.ts");
+        function isMacOS() {
+            return 'darwin' === process.platform;
         }
-        const fmt = {
-            heading: (title)=>pintor__rspack_import_0_default().underline(pintor__rspack_import_0_default().blue(title)),
-            label: (key)=>pintor__rspack_import_0_default().gray(key.toUpperCase()),
-            val: (value)=>pintor__rspack_import_0_default().underline(value),
-            code: (value)=>pintor__rspack_import_0_default().blue(value),
-            bullet: (value)=>`- ${value}`,
-            block (title, rows) {
-                const head = fmt.heading(title);
-                const body = rows.map(([key, value])=>`${fmt.label(key)} ${value}`).join('\n');
-                return `${head}\n${body}`;
-            },
-            truncate (input, max = 800) {
-                const s = (()=>{
-                    try {
-                        return 'string' == typeof input ? input : JSON.stringify(input);
-                    } catch  {
-                        return String(input);
-                    }
-                })();
-                return s.length > max ? `${s.slice(0, max)}…` : s;
+        function activeDeveloperDir() {
+            try {
+                const result = (0, external_node_child_process_.spawnSync)('xcode-select', [
+                    '-p'
+                ], {
+                    encoding: 'utf8',
+                    timeout: 15000
+                });
+                if (0 !== result.status) return null;
+                const resolved = String(result.stdout || '').trim();
+                return resolved.length > 0 ? resolved : null;
+            } catch  {
+                return null;
             }
-        };
-        const CARD_LABEL_WIDTH = 15;
-        function card(input = {}) {
-            const version = String(input.version || '').trim();
-            const suffix = String(input.suffix || '').trim();
-            const head = ` 🧩 ${pintor__rspack_import_0_default().brightBlue('Extension.js')}` + (version ? ` ${pintor__rspack_import_0_default().gray(version)}` : '') + (suffix ? ` ${suffix}` : '');
-            const body = (input.rows || []).filter((row)=>String(row.value || '').trim().length > 0).map((row)=>{
-                const label = row.label.padEnd(CARD_LABEL_WIDTH);
-                return `    ${label}${pintor__rspack_import_0_default().gray(String(row.value).trim())}`;
+        }
+        function findWithXcrun(tool) {
+            try {
+                const result = (0, external_node_child_process_.spawnSync)('xcrun', [
+                    '--find',
+                    tool
+                ], {
+                    encoding: 'utf8',
+                    timeout: 15000
+                });
+                if (0 !== result.status) return null;
+                const resolved = String(result.stdout || '').trim();
+                return resolved.length > 0 ? resolved : null;
+            } catch  {
+                return null;
+            }
+        }
+        function detectSafariToolchain() {
+            const platformOk = isMacOS();
+            if (!platformOk) return {
+                platformOk: false,
+                developerDir: null,
+                needsFullXcode: false,
+                converter: null,
+                xcodebuild: null,
+                ok: false
+            };
+            const developerDir = activeDeveloperDir();
+            const needsFullXcode = !developerDir || /CommandLineTools/i.test(developerDir);
+            const converter = findWithXcrun('safari-web-extension-converter');
+            const xcodebuild = findWithXcrun('xcodebuild');
+            return {
+                platformOk,
+                developerDir,
+                needsFullXcode,
+                converter,
+                xcodebuild,
+                ok: Boolean(converter && xcodebuild)
+            };
+        }
+        function fallbackLogger() {
+            return {
+                info: (...a)=>console.log(...a),
+                warn: (...a)=>console.warn(...a),
+                error: (...a)=>console.error(...a),
+                debug: (...a)=>console?.debug?.(...a)
+            };
+        }
+        function isTestEnv() {
+            return Boolean(process.env.VITEST || process.env.VITEST_WORKER_ID);
+        }
+        function delay(ms) {
+            return new Promise((resolve)=>setTimeout(resolve, ms));
+        }
+        const TOOL_TAIL_LINES = 50;
+        const TOOL_TAIL_BYTES = 8192;
+        function toolOutputTail(output) {
+            const lines = output.slice(4 * -TOOL_TAIL_BYTES).split(/\r?\n/).filter((line)=>line.trim().length > 0);
+            const tail = lines.slice(-TOOL_TAIL_LINES).join('\n');
+            return tail.length > TOOL_TAIL_BYTES ? tail.slice(-TOOL_TAIL_BYTES) : tail;
+        }
+        function runTool(bin, args, opts) {
+            const streamOutput = (0, messaging._o)() && !opts?.quiet;
+            return new Promise((resolve)=>{
+                let output = '';
+                const child = (0, external_node_child_process_.spawn)(bin, args, {
+                    stdio: [
+                        'ignore',
+                        'pipe',
+                        'pipe'
+                    ]
+                });
+                const onChunk = (chunk)=>{
+                    const text = String(chunk);
+                    output += text;
+                    if (output.length > 8 * TOOL_TAIL_BYTES) output = output.slice(4 * -TOOL_TAIL_BYTES);
+                    if (streamOutput) process.stdout.write(text);
+                };
+                child.stdout?.on('data', onChunk);
+                child.stderr?.on('data', onChunk);
+                child.on('error', (error)=>resolve({
+                        ok: false,
+                        code: null,
+                        output: `${output}${String(error)}`
+                    }));
+                child.on('close', (code)=>resolve({
+                        ok: 0 === code,
+                        code,
+                        output
+                    }));
             });
-            return [
-                head,
-                ...body
-            ].join('\n');
         }
-        const CARD_KEYS_ENV = 'EXTENSION_CLI_CARD_KEYS';
-        const CARD_KEYS_SEPARATOR = '\u001f';
-        function isCardKeyClaimed(key) {
-            const claimed = String(process.env[CARD_KEYS_ENV] || '');
-            if (!claimed) return false;
-            return claimed.split(CARD_KEYS_SEPARATOR).includes(key);
+        function converterWarnings(output) {
+            return output.split(/\r?\n/).filter((line)=>/warning/i.test(line)).map((line)=>line.trim()).filter((line)=>line.length > 0);
         }
-        function claimCardKey(key) {
-            if (isCardKeyClaimed(key)) return false;
-            const claimed = String(process.env[CARD_KEYS_ENV] || '');
-            process.env[CARD_KEYS_ENV] = claimed ? `${claimed}${CARD_KEYS_SEPARATOR}${key}` : key;
-            return true;
+        async function confirmRegisteredWithSafari(bundleIdentifier) {
+            const needle = `${bundleIdentifier}.Extension`;
+            for(let attempt = 0; attempt < 6; attempt += 1){
+                const { ok, output } = await runTool('pluginkit', [
+                    '-m'
+                ], {
+                    quiet: true
+                });
+                if (ok && output.includes(needle)) return true;
+                await delay(800);
+            }
+            return false;
         }
-        const GECKO_BROWSERS = new Set([
-            'firefox',
-            'firefox-based',
-            'gecko-based',
-            'librewolf',
-            'waterfox'
-        ]);
-        function artifactNoun(browser) {
-            const name = String(browser || '').trim().toLowerCase();
-            if (GECKO_BROWSERS.has(name)) return 'Add-on';
-            if (name.includes('gecko') || name.includes('firefox')) return 'Add-on';
-            return 'Extension';
+        function describePackage(config) {
+            return {
+                appName: config.appName,
+                bundleId: config.bundleIdentifier,
+                bundleIdDerived: config.bundleIdDerived,
+                appPath: (0, safari_config.fd)(config),
+                xcodeProjectPath: (0, safari_config.Gi)(config),
+                macOsOnly: config.macOsOnly
+            };
         }
-        const ENVELOPE_SCHEMA = 1;
-        const CODES = {
-            E_ARGS: 'E_ARGS',
-            E_PROJECT_NOT_FOUND: 'E_PROJECT_NOT_FOUND',
-            E_MANIFEST_NOT_FOUND: 'E_MANIFEST_NOT_FOUND',
-            E_MANIFEST_INVALID: 'E_MANIFEST_INVALID',
-            E_FIRST_COMPILE: 'E_FIRST_COMPILE',
-            E_COMPILE: 'E_COMPILE',
-            E_BROWSER_NOT_FOUND: 'E_BROWSER_NOT_FOUND',
-            E_BROWSER_LAUNCH: 'E_BROWSER_LAUNCH',
-            E_PROFILE_LOCKED: 'E_PROFILE_LOCKED',
-            E_READY_TIMEOUT: 'E_READY_TIMEOUT',
-            E_SESSION_EXISTS: 'E_SESSION_EXISTS',
-            E_CONTROL_DENIED: 'E_CONTROL_DENIED',
-            E_CONTROL_UNAVAILABLE: 'E_CONTROL_UNAVAILABLE',
-            E_TOKEN_MISSING: 'E_TOKEN_MISSING',
-            E_NETWORK: 'E_NETWORK',
-            E_INTERRUPTED: 'E_INTERRUPTED',
-            E_NOT_IMPLEMENTED: 'E_NOT_IMPLEMENTED',
-            E_INTERNAL: 'E_INTERNAL',
-            E_UNSUPPORTED_BROWSER: 'E_UNSUPPORTED_BROWSER',
-            E_INVALID_OPTION: 'E_INVALID_OPTION',
-            E_PORT_UNAVAILABLE: 'E_PORT_UNAVAILABLE',
-            E_DEPENDENCY_INSTALL: 'E_DEPENDENCY_INSTALL',
-            E_TEMPLATE_NOT_FOUND: 'E_TEMPLATE_NOT_FOUND',
-            E_DESTINATION_NOT_EMPTY: 'E_DESTINATION_NOT_EMPTY',
-            E_DESTINATION_NOT_WRITABLE: 'E_DESTINATION_NOT_WRITABLE',
-            E_BROWSER_DOWNLOAD: 'E_BROWSER_DOWNLOAD',
-            E_SESSION_NOT_FOUND: 'E_SESSION_NOT_FOUND',
-            E_EVAL_REFUSED: 'E_EVAL_REFUSED',
-            E_TARGET_NOT_FOUND: 'E_TARGET_NOT_FOUND',
-            E_TIMEOUT: 'E_TIMEOUT',
-            E_PUBLISH_REJECTED: 'E_PUBLISH_REJECTED',
-            E_AUTH_REQUIRED: 'E_AUTH_REQUIRED',
-            E_SAFARI_TOOLCHAIN: 'E_SAFARI_TOOLCHAIN',
-            E_EVAL: 'E_EVAL',
-            E_INSPECT: 'E_INSPECT',
-            E_STORAGE: 'E_STORAGE',
-            E_LOGS_NOT_FOUND: 'E_LOGS_NOT_FOUND',
-            E_READY_ERROR_STATUS: 'E_READY_ERROR_STATUS',
-            E_COMMAND_UNSUPPORTED_FOR_TARGET: 'E_COMMAND_UNSUPPORTED_FOR_TARGET',
-            E_FLAG_VALUE_INVALID: 'E_FLAG_VALUE_INVALID',
-            E_FLAG_NOT_SUPPORTED_HERE: 'E_FLAG_NOT_SUPPORTED_HERE',
-            E_DEV_SERVER_START: 'E_DEV_SERVER_START',
-            E_DOCTOR_CHECKS_FAILED: 'E_DOCTOR_CHECKS_FAILED',
-            E_TELEMETRY_WRITE: 'E_TELEMETRY_WRITE',
-            E_PREVIEW_NO_DIST: 'E_PREVIEW_NO_DIST',
-            E_BROWSER_UNINSTALL: 'E_BROWSER_UNINSTALL',
-            E_NODE_VERSION: 'E_NODE_VERSION',
-            E_UNKNOWN_COMMAND: 'E_UNKNOWN_COMMAND',
-            E_REMOVED_FLAG: 'E_REMOVED_FLAG',
-            E_BROWSER_NOT_INSTALLABLE: 'E_BROWSER_NOT_INSTALLABLE',
-            E_PARENT_GONE: 'E_PARENT_GONE',
-            E_REMOTE_URL_UNSUPPORTED: 'E_REMOTE_URL_UNSUPPORTED',
-            E_CONFIG_LOAD: 'E_CONFIG_LOAD',
-            E_MANAGED_DEP_CONFLICT: 'E_MANAGED_DEP_CONFLICT',
-            E_TYPES_EMIT: 'E_TYPES_EMIT',
-            E_TSCONFIG_MISSING: 'E_TSCONFIG_MISSING',
-            E_OPTIONAL_DEP_UNRESOLVED: 'E_OPTIONAL_DEP_UNRESOLVED',
-            E_OPTIONAL_DEP_LOAD: 'E_OPTIONAL_DEP_LOAD',
-            E_OPTIONAL_DEP_UNKNOWN: 'E_OPTIONAL_DEP_UNKNOWN',
-            E_COMPANION_EXTENSION_PATH: 'E_COMPANION_EXTENSION_PATH',
-            E_MANIFEST_IN_PUBLIC: 'E_MANIFEST_IN_PUBLIC',
-            E_RUNTIME_NOT_FOUND: 'E_RUNTIME_NOT_FOUND',
-            E_MANIFEST_SHAPE: 'E_MANIFEST_SHAPE',
-            E_MANIFEST_PAGE_MISSING: 'E_MANIFEST_PAGE_MISSING',
-            E_MANIFEST_VERSION_UNSUPPORTED: 'E_MANIFEST_VERSION_UNSUPPORTED',
-            E_MANIFEST_LOAD_BLOCKERS: 'E_MANIFEST_LOAD_BLOCKERS',
-            E_MANIFEST_PERMISSION_MISSING: 'E_MANIFEST_PERMISSION_MISSING',
-            E_MANIFEST_MSG_KEY_MISSING: 'E_MANIFEST_MSG_KEY_MISSING',
-            E_MANIFEST_EMIT: 'E_MANIFEST_EMIT',
-            E_RESTART_REQUIRED: 'E_RESTART_REQUIRED',
-            E_COMPILE_FATAL: 'E_COMPILE_FATAL',
-            E_MODULE_NOT_FOUND: 'E_MODULE_NOT_FOUND',
-            E_ENTRY_NOT_FOUND: 'E_ENTRY_NOT_FOUND',
-            E_ASSET_MISSING: 'E_ASSET_MISSING',
-            E_SCRIPT_DEP_MISSING: 'E_SCRIPT_DEP_MISSING',
-            E_RESERVED_FOLDER: 'E_RESERVED_FOLDER',
-            E_CSS_PARSE: 'E_CSS_PARSE',
-            E_CSS_PREPROCESSOR_MISSING: 'E_CSS_PREPROCESSOR_MISSING',
-            E_CSS_DEAD_REF: 'E_CSS_DEAD_REF',
-            E_INTEGRATION_INSTALL: 'E_INTEGRATION_INSTALL',
-            E_POLYFILL_NOT_FOUND: 'E_POLYFILL_NOT_FOUND',
-            E_LOCALES_LAYOUT: 'E_LOCALES_LAYOUT',
-            E_WAR_INVALID: 'E_WAR_INVALID',
-            E_MATCH_PATTERN_INVALID: 'E_MATCH_PATTERN_INVALID',
-            E_BACKGROUND_REQUIRED: 'E_BACKGROUND_REQUIRED',
-            E_CONTENT_SCRIPT_SYNTAX: 'E_CONTENT_SCRIPT_SYNTAX',
-            E_NO_ENTRYPOINTS: 'E_NO_ENTRYPOINTS',
-            E_REMOTE_RESOURCE_BLOCKED: 'E_REMOTE_RESOURCE_BLOCKED',
-            E_PERF_BUDGET: 'E_PERF_BUDGET',
-            E_ZIP_SKIPPED: 'E_ZIP_SKIPPED',
-            E_ENV_NO_MATCH: 'E_ENV_NO_MATCH',
-            E_REMOTE_FETCH_TIMEOUT: 'E_REMOTE_FETCH_TIMEOUT',
-            E_REMOTE_DOWNLOAD: 'E_REMOTE_DOWNLOAD',
-            E_REMOTE_ZIP_INVALID: 'E_REMOTE_ZIP_INVALID',
-            E_LOCAL_ZIP_NOT_FOUND: 'E_LOCAL_ZIP_NOT_FOUND',
-            E_PROJECT_DOWNLOAD_EMPTY: 'E_PROJECT_DOWNLOAD_EMPTY',
-            E_BROWSER_BINARY_REQUIRED: 'E_BROWSER_BINARY_REQUIRED',
-            E_BROWSER_BINARY_INVALID: 'E_BROWSER_BINARY_INVALID',
-            E_BROWSER_EXITED: 'E_BROWSER_EXITED',
-            E_BROWSER_START_TIMEOUT: 'E_BROWSER_START_TIMEOUT',
-            E_LAUNCH_SKIPPED_COMPILE_ERRORS: 'E_LAUNCH_SKIPPED_COMPILE_ERRORS',
-            E_INSTANCE_AMBIGUOUS: 'E_INSTANCE_AMBIGUOUS',
-            E_WSL_INTEROP: 'E_WSL_INTEROP',
-            E_EXTENSION_LOAD_REFUSED: 'E_EXTENSION_LOAD_REFUSED',
-            E_ADDON_INSTALL: 'E_ADDON_INSTALL',
-            E_BROWSER_CONNECT: 'E_BROWSER_CONNECT',
-            E_BROWSER_CONNECTION_CLOSED: 'E_BROWSER_CONNECTION_CLOSED',
-            E_CDP_NOT_CONNECTED: 'E_CDP_NOT_CONNECTED',
-            E_CDP_TIMEOUT: 'E_CDP_TIMEOUT',
-            E_CDP_OP_FAILED: 'E_CDP_OP_FAILED',
-            E_EXTENSION_ID_UNKNOWN: 'E_EXTENSION_ID_UNKNOWN',
-            E_RDP_PROTOCOL: 'E_RDP_PROTOCOL',
-            E_DEV_SERVER_TIMEOUT: 'E_DEV_SERVER_TIMEOUT',
-            E_PORT_IN_USE: 'E_PORT_IN_USE',
-            E_SESSION_STOPPED: 'E_SESSION_STOPPED',
-            E_LOGS_STREAM_GAP: 'E_LOGS_STREAM_GAP',
-            E_CREATE_DIR: 'E_CREATE_DIR',
-            E_CREATE_WRITE: 'E_CREATE_WRITE',
-            E_CREATE_TESTS_SETUP: 'E_CREATE_TESTS_SETUP',
-            E_GIT_SKIPPED: 'E_GIT_SKIPPED',
-            E_BROWSER_INSTALL_PRIVILEGE: 'E_BROWSER_INSTALL_PRIVILEGE',
-            E_UNINSTALL_NOOP: 'E_UNINSTALL_NOOP'
-        };
-        function withExtras(base, extras) {
+        function safariPreflightError() {
+            const tc = detectSafariToolchain();
+            if (!tc.platformOk) return messages.G3(process.platform);
+            if (!tc.ok) {
+                if (tc.needsFullXcode) return messages.Xi(tc.developerDir);
+                return messages.Cs(tc.converter ? 'xcodebuild' : 'safari-web-extension-converter');
+            }
+            return null;
+        }
+        function safariBuildPreflight() {
+            const tc = detectSafariToolchain();
+            if (!tc.platformOk) return {
+                severity: 'skip',
+                message: messages.UW(process.platform)
+            };
+            if (!tc.ok) return {
+                severity: 'fatal',
+                message: tc.needsFullXcode ? messages.Xi(tc.developerDir) : messages.Cs(tc.converter ? 'xcodebuild' : 'safari-web-extension-converter')
+            };
             return {
-                ...base,
-                ...extras.hint ? {
-                    hint: extras.hint
-                } : {},
-                ...extras.truncated ? {
-                    truncated: true
-                } : {},
-                warnings: extras.warnings || []
+                severity: 'ok'
             };
         }
-        const ENVELOPE = {
-            schema: ENVELOPE_SCHEMA,
-            ok (command, status, value, extras = {}) {
-                return withExtras({
-                    schema: ENVELOPE_SCHEMA,
-                    ok: true,
-                    command,
-                    status,
-                    value,
-                    error: null,
-                    warnings: []
-                }, extras);
-            },
-            fail (command, status, error, extras = {}) {
-                return withExtras({
-                    schema: ENVELOPE_SCHEMA,
-                    ok: false,
-                    command,
-                    status,
-                    value: extras.value ?? null,
-                    error,
-                    warnings: []
-                }, extras);
+        async function runSafariPipeline(compilation, host, logger, mode) {
+            const config = (0, safari_config.F7)(compilation, host);
+            const converterArgs = (0, safari_config.w7)(config);
+            const xcodebuildArgs = (0, safari_config.vx)(config);
+            if (host.dryRun || isTestEnv()) {
+                logSafariDryRun(`xcrun ${converterArgs.join(' ')}`, `xcodebuild ${xcodebuildArgs.join(' ')}`);
+                return describePackage(config);
             }
-        };
-        __webpack_require__.d(__webpack_exports__, {
-            Nr: ()=>card,
-            Pl: ()=>prefix,
-            T_: ()=>artifactNoun,
-            VR: ()=>isCardKeyClaimed,
-            _o: ()=>isDebug,
-            od: ()=>claimCardKey
-        }, {
-            Lp: CODES,
-            Pr: ENVELOPE,
-            Sc: fmt
-        });
+            const toolchain = detectSafariToolchain();
+            if (!toolchain.platformOk) {
+                logger.warn?.(messages.G3(process.platform));
+                return describePackage(config);
+            }
+            if (!toolchain.ok) {
+                if (toolchain.needsFullXcode) logger.error?.(messages.Xi(toolchain.developerDir));
+                else {
+                    const missing = toolchain.converter ? 'xcodebuild' : 'safari-web-extension-converter';
+                    logger.error?.(messages.Cs(missing));
+                }
+                return describePackage(config);
+            }
+            const projectExists = external_node_fs_.existsSync((0, safari_config.Gi)(config));
+            const needsConversion = !projectExists || host.forceRegenerate || (0, safari_config.vk)(config);
+            if (needsConversion) {
+                if (projectExists) {
+                    logger.info?.(host.forceRegenerate ? messages.Tq() : messages.jc());
+                    logger.warn?.(messages.H1([
+                        ...safari_config.X9
+                    ]));
+                }
+                const { saved, restore } = (0, safari_config._D)(config);
+                logger.info?.(messages.uK(config.extensionDir));
+                const converted = await runTool('xcrun', converterArgs);
+                if (!converted.ok) {
+                    const tail = toolOutputTail(converted.output);
+                    logger.error?.(messages.A('safari-web-extension-converter', converted.code, tail));
+                    throw new Error(`safari-web-extension-converter failed (exit ${converted.code})\n${tail}`);
+                }
+                const warnings = converterWarnings(converted.output);
+                if (warnings.length > 0) logger.warn?.(messages.y1(warnings));
+                const projFile = (0, safari_config.vh)(config);
+                if (external_node_fs_.existsSync(projFile)) external_node_fs_.writeFileSync(projFile, (0, safari_config.IA)(external_node_fs_.readFileSync(projFile, 'utf8'), config.bundleIdentifier), 'utf8');
+                restore();
+                const preservedKeys = Object.keys(saved);
+                if (preservedKeys.length > 0) logger.info?.(messages.oB(preservedKeys));
+                (0, safari_config.x7)(config);
+                logger.info?.(messages.l_(config.projectLocation));
+            } else logger.info?.(messages.oM());
+            if ('full' === mode) logger.info?.(messages.jR((0, safari_config.aD)(config)));
+            const built = await runTool('xcodebuild', xcodebuildArgs);
+            if (!built.ok) {
+                const tail = toolOutputTail(built.output);
+                logger.error?.(messages.A('xcodebuild', built.code, tail));
+                throw new Error(`xcodebuild failed (exit ${built.code})\n${tail}`);
+            }
+            const appPath = (0, safari_config.fd)(config);
+            if ('resync' === mode) {
+                logger.info?.(messages.cF(config.appName));
+                return describePackage(config);
+            }
+            logger.info?.(messages.Rl(appPath));
+            if (config.bundleIdDerived) logger.info?.(messages.$q(config.bundleIdentifier));
+            if (!config.open) {
+                logger.info?.(messages.aO(appPath, config.appName));
+                return describePackage(config);
+            }
+            const target = external_node_fs_.existsSync(appPath) ? appPath : (0, safari_config.Gi)(config);
+            logger.info?.(messages.fw(target));
+            await runTool('open', [
+                target
+            ]);
+            if (config.safariBinary) await runTool('open', [
+                '-a',
+                config.safariBinary
+            ]);
+            logger.info?.(messages.fO(config.appName));
+            if (await confirmRegisteredWithSafari(config.bundleIdentifier)) logger.info?.(messages.fd(config.appName));
+            else logger.warn?.(messages.qY(config.appName));
+            return describePackage(config);
+        }
+        async function packageSafariExtension(host, outputPath, logger, mode = 'full') {
+            const compilation = {
+                options: {
+                    output: {
+                        path: outputPath
+                    }
+                },
+                outputOptions: {
+                    path: outputPath
+                }
+            };
+            return await runSafariPipeline(compilation, host, logger || fallbackLogger(), mode);
+        }
     },
-    "./index.ts" (__unused_rspack_module, __unused_rspack___webpack_exports__, __webpack_require__) {
-        const MIN_NODE_MAJOR = 22;
-        const MIN_NODE_MINOR = 12;
-        function isSupportedNodeVersion(version) {
-            const [major, minor] = version.split('.').map((part)=>parseInt(part, 10));
-            if (!Number.isFinite(major)) return true;
-            if (major !== MIN_NODE_MAJOR) return major > MIN_NODE_MAJOR;
-            return (Number.isFinite(minor) ? minor : 0) >= MIN_NODE_MINOR;
+    "./browsers/run-safari/safari-launch/safari-config.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
+        var node_fs__rspack_import_0 = __webpack_require__("node:fs");
+        var node_path__rspack_import_1 = __webpack_require__("node:path");
+        function sanitizeAppName(value) {
+            const cleaned = String(value || '').replace(/[\\/:*?"<>|]+/g, ' ').replace(/\s+/g, ' ').trim();
+            return cleaned.length > 0 ? cleaned : 'Extension';
         }
-        function unsupportedNodeVersionMessage(version) {
-            return `[Extension.js] Requires Node.js >= ${MIN_NODE_MAJOR}.${MIN_NODE_MINOR} (you are on ${version}). Upgrade Node.js to run the extension CLI.`;
+        function bundleSegment(appName) {
+            return String(appName || '').replace(/[^A-Za-z0-9]+/g, '-').replace(/^-+|-+$/g, '') || 'extension';
         }
-        function enforceSupportedNodeVersion(version = process.versions.node) {
-            if (isSupportedNodeVersion(version)) return;
-            console.error(unsupportedNodeVersionMessage(version));
-            process.exit(1);
+        function deriveBundleId(appName) {
+            return `dev.extensionjs.${bundleSegment(appName)}`;
         }
-        enforceSupportedNodeVersion();
-        const external_commander_namespaceObject = require("commander");
-        var external_node_fs_ = __webpack_require__("node:fs");
-        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_);
-        async function exitAfterDrain(code) {
-            await Promise.all([
-                process.stdout,
-                process.stderr
-            ].map((stream)=>new Promise((resolve)=>{
-                    if (0 === stream.writableLength) return resolve();
-                    stream.write('', ()=>resolve());
-                })));
-            process.exit(code);
+        function isValidBundleId(value) {
+            return /^[A-Za-z][A-Za-z0-9-]*(\.[A-Za-z][A-Za-z0-9-]*)+$/.test(value);
         }
-        var external_node_module_ = __webpack_require__("node:module");
-        const external_node_url_namespaceObject = require("node:url");
-        const extension_develop_runtime_require = (0, external_node_module_.createRequire)(__rslib_import_meta_url__);
-        function parseJsonSafe(filePath) {
-            return JSON.parse(external_node_fs_default().readFileSync(filePath, 'utf8'));
-        }
-        function resolveDevelopRootFromDir(dir) {
-            try {
-                const packageJsonPath = external_node_path_default().join(dir, 'package.json');
-                if (!external_node_fs_default().existsSync(packageJsonPath)) return;
-                const pkg = parseJsonSafe(packageJsonPath);
-                return pkg?.name === 'extension-develop' ? dir : void 0;
-            } catch  {
-                return;
-            }
-        }
-        function resolveWorkspaceDevelopRoot(startDir) {
-            let currentDir = external_node_path_default().resolve(startDir);
-            if (currentDir.split(external_node_path_default().sep).includes('node_modules')) return;
-            for(let depth = 0; depth < 8; depth += 1){
-                const candidate = external_node_path_default().join(currentDir, 'programs', 'develop');
-                const resolved = resolveDevelopRootFromDir(candidate);
-                if (resolved) return resolved;
-                const parent = external_node_path_default().dirname(currentDir);
-                if (parent === currentDir) break;
-                currentDir = parent;
-            }
-        }
-        function resolveInstalledDevelopRoot() {
+        function readManifest(extensionDir) {
             try {
-                const packageJsonPath = extension_develop_runtime_require.resolve('extension-develop/package.json');
-                return resolveDevelopRootFromDir(external_node_path_default().dirname(packageJsonPath));
-            } catch  {
-                try {
-                    const entryPath = extension_develop_runtime_require.resolve('extension-develop');
-                    return resolveDevelopRootFromDir(external_node_path_default().dirname(external_node_path_default().dirname(entryPath)));
-                } catch  {
-                    return;
-                }
-            }
+                const manifestPath = node_path__rspack_import_1.join(extensionDir, 'manifest.json');
+                if (node_fs__rspack_import_0.existsSync(manifestPath)) return JSON.parse(node_fs__rspack_import_0.readFileSync(manifestPath, 'utf8')) || {};
+            } catch  {}
+            return {};
         }
-        function resolvePreferredDevelopRoot(startDir) {
-            const workspaceRoot = resolveWorkspaceDevelopRoot(startDir);
-            if (workspaceRoot) return {
-                root: workspaceRoot,
-                source: 'workspace'
-            };
-            const envRoot = process.env.EXTENSION_DEVELOP_ROOT ? resolveDevelopRootFromDir(external_node_path_default().resolve(process.env.EXTENSION_DEVELOP_ROOT)) : void 0;
-            if (envRoot) return {
-                root: envRoot,
-                source: 'env'
-            };
-            const installedRoot = resolveInstalledDevelopRoot();
-            if (installedRoot) return {
-                root: installedRoot,
-                source: 'installed'
-            };
+        function resolveSafariBuildConfig(compilation, host) {
+            const extensionDir = String(compilation?.options?.output?.path || '');
+            const manifest = readManifest(extensionDir);
+            const appName = sanitizeAppName(String(host.appName || manifest?.name || 'Extension'));
+            const userBundleId = String(host.bundleId || '').trim();
+            const bundleIdDerived = !userBundleId;
+            const bundleIdentifier = bundleIdDerived ? deriveBundleId(appName) : userBundleId;
+            const projectLocation = `${extensionDir.replace(/[\\/]+$/, '')}-xcode`;
             return {
-                root: void 0,
-                source: 'missing'
+                extensionDir,
+                projectLocation,
+                appName,
+                bundleIdentifier,
+                bundleIdDerived,
+                macOsOnly: false !== host.macOsOnly,
+                language: 'swift',
+                open: !host.noOpen,
+                safariBinary: host.safariBinary
             };
         }
-        function resolveDevelopDistEntry(root, name = 'module') {
-            const base = external_node_path_default().join(root, 'dist', name);
-            const candidates = [
-                `${base}.mjs`,
-                `${base}.cjs`,
-                `${base}.js`,
-                base
+        function composeConverterArgs(config) {
+            const args = [
+                'safari-web-extension-converter',
+                config.extensionDir,
+                '--project-location',
+                config.projectLocation,
+                '--app-name',
+                config.appName,
+                '--bundle-identifier',
+                config.bundleIdentifier,
+                '--no-prompt',
+                '--no-open',
+                '--force',
+                'objc' === config.language ? '--objc' : '--swift'
             ];
-            for (const candidate of candidates)if (external_node_fs_default().existsSync(candidate)) return candidate;
+            if (config.macOsOnly) args.push('--macos-only');
+            return args;
         }
-        function resolveExtensionDevelopRoot(startDir = __dirname) {
-            const { root, source } = resolvePreferredDevelopRoot(startDir);
-            if (!root) throw new Error('Unable to locate the extension-develop runtime.');
-            process.env.EXTENSION_DEVELOP_ROOT = root;
-            if ('workspace' === source) process.env.EXTENSION_CREATE_DEVELOP_ROOT = root;
-            return root;
+        function macOsSchemeName(config) {
+            return config.macOsOnly ? config.appName : `${config.appName} (macOS)`;
         }
-        function resolveExtensionDevelopVersion(startDir = __dirname, fallbackVersion) {
+        function xcodeProjectPath(config) {
+            return node_path__rspack_import_1.join(config.projectLocation, config.appName, `${config.appName}.xcodeproj`);
+        }
+        function derivedDataPath(config) {
+            return node_path__rspack_import_1.join(config.projectLocation, '.derived');
+        }
+        function builtAppPath(config) {
+            return node_path__rspack_import_1.join(derivedDataPath(config), 'Build', 'Products', 'Release', `${config.appName}.app`);
+        }
+        function composeXcodebuildArgs(config) {
+            return [
+                '-project',
+                xcodeProjectPath(config),
+                '-scheme',
+                macOsSchemeName(config),
+                '-configuration',
+                'Release',
+                '-derivedDataPath',
+                derivedDataPath(config),
+                'CODE_SIGN_IDENTITY=-',
+                'CODE_SIGNING_REQUIRED=NO',
+                'CODE_SIGNING_ALLOWED=YES',
+                'build'
+            ];
+        }
+        function manifestFingerprintPath(config) {
+            return node_path__rspack_import_1.join(config.projectLocation, '.manifest-fingerprint');
+        }
+        function stableStringify(obj) {
+            if (null == obj) return JSON.stringify(obj);
+            if ('object' != typeof obj) return JSON.stringify(obj);
+            if (Array.isArray(obj)) return `[${obj.map(stableStringify).join(',')}]`;
+            const keys = Object.keys(obj).sort();
+            return `{${keys.map((k)=>`${JSON.stringify(k)}:${stableStringify(obj[k])}`).join(',')}}`;
+        }
+        function readManifestRaw(extensionDir) {
             try {
-                const root = resolveExtensionDevelopRoot(startDir);
-                const packageJsonPath = external_node_path_default().join(root, 'package.json');
-                const pkg = parseJsonSafe(packageJsonPath);
-                return pkg?.version || fallbackVersion || '0.0.0';
+                return node_fs__rspack_import_0.readFileSync(node_path__rspack_import_1.join(extensionDir, 'manifest.json'), 'utf8');
             } catch  {
-                return fallbackVersion || '0.0.0';
+                return '';
             }
         }
-        async function importModule(filePath) {
-            const mod = await import((0, external_node_url_namespaceObject.pathToFileURL)(filePath).href);
-            return mod?.default && 'object' == typeof mod.default ? {
-                ...mod.default,
-                ...mod
-            } : mod;
+        function normalizeManifest(raw) {
+            try {
+                return stableStringify(JSON.parse(raw));
+            } catch  {
+                return raw;
+            }
         }
-        async function loadExtensionDevelopModule(startDir = __dirname) {
-            const root = resolveExtensionDevelopRoot(startDir);
-            const { source } = resolvePreferredDevelopRoot(startDir);
-            const distEntry = resolveDevelopDistEntry(root);
-            if (distEntry) return importModule(distEntry);
-            if ('workspace' === source) throw new Error(`Local extension-develop runtime is not built at ${external_node_path_default().join(root, 'dist')}. Run \`pnpm --filter extension-develop compile\` before invoking the local CLI.`);
-            return await import("extension-develop");
+        function composeProjectFingerprint(config) {
+            return JSON.stringify({
+                v: 2,
+                identity: {
+                    appName: config.appName,
+                    bundleId: config.bundleIdentifier,
+                    macOsOnly: config.macOsOnly
+                },
+                manifest: normalizeManifest(readManifestRaw(config.extensionDir))
+            });
         }
-        async function loadExtensionDevelopPreviewModule(startDir = __dirname) {
-            const root = resolveExtensionDevelopRoot(startDir);
-            const { source } = resolvePreferredDevelopRoot(startDir);
-            const previewEntry = resolveDevelopDistEntry(root, 'preview');
-            if (previewEntry) return importModule(previewEntry);
-            const fullEntry = resolveDevelopDistEntry(root);
-            if (fullEntry) return importModule(fullEntry);
-            if ('workspace' === source) throw new Error(`Local extension-develop runtime is not built at ${external_node_path_default().join(root, 'dist')}. Run \`pnpm --filter extension-develop compile\` before invoking the local CLI.`);
-            return await import("extension-develop/preview");
+        function saveManifestFingerprint(config) {
+            node_fs__rspack_import_0.mkdirSync(node_path__rspack_import_1.dirname(manifestFingerprintPath(config)), {
+                recursive: true
+            });
+            node_fs__rspack_import_0.writeFileSync(manifestFingerprintPath(config), composeProjectFingerprint(config), 'utf8');
         }
-        async function loadExtensionDevelopBridgeModule(startDir = __dirname) {
-            const root = resolveExtensionDevelopRoot(startDir);
-            const { source } = resolvePreferredDevelopRoot(startDir);
-            const bridgeEntry = resolveDevelopDistEntry(root, 'bridge');
-            if (bridgeEntry) return importModule(bridgeEntry);
-            if ('workspace' === source) throw new Error(`Local extension-develop runtime is not built at ${external_node_path_default().join(root, 'dist')}. Run \`pnpm --filter extension-develop compile\` before invoking the local CLI.`);
-            const bridgeSpecifier = 'extension-develop/bridge';
-            return await import(bridgeSpecifier);
+        function isProjectStale(config) {
+            const fpPath = manifestFingerprintPath(config);
+            if (!node_fs__rspack_import_0.existsSync(fpPath)) return true;
+            const stored = node_fs__rspack_import_0.readFileSync(fpPath, 'utf8');
+            return stored !== composeProjectFingerprint(config);
         }
-        var external_pintor_ = __webpack_require__("pintor");
-        var external_pintor_default = /*#__PURE__*/ __webpack_require__.n(external_pintor_);
-        var messaging = __webpack_require__("./helpers/messaging.ts");
-        function getLoggingPrefix(type) {
-            return (0, messaging.Pl)(type);
+        function alignBundleIdentifiers(pbxprojContent, bundleId) {
+            return pbxprojContent.replace(/PRODUCT_BUNDLE_IDENTIFIER = ("?)([^;"]+)\1;/g, (_match, _quote, value)=>/\.Extension$/.test(String(value)) ? `PRODUCT_BUNDLE_IDENTIFIER = "${bundleId}.Extension";` : `PRODUCT_BUNDLE_IDENTIFIER = "${bundleId}";`);
         }
-        const messages_code = (text)=>external_pintor_default().blue(text);
-        const messages_arg = (text)=>external_pintor_default().gray(text);
-        function renderArgToken(spec) {
-            const token = spec.values ? spec.values.join('|') : spec.label ?? spec.name;
-            return spec.required ? `<${token}>` : `[${token}]`;
+        const PRESERVED_SETTINGS = [
+            'DEVELOPMENT_TEAM',
+            'CODE_SIGN_STYLE',
+            'PROVISIONING_PROFILE_SPECIFIER'
+        ];
+        function pbxprojPath(config) {
+            return node_path__rspack_import_1.join(xcodeProjectPath(config), 'project.pbxproj');
         }
-        function commandArgSignature(positionals) {
-            return positionals.map(renderArgToken).join(' ');
+        function extractXcodeUserSettings(pbxprojContent) {
+            const found = {};
+            for (const key of PRESERVED_SETTINGS){
+                const m = new RegExp(`\\b${key}\\s*=\\s*([^;]+);`).exec(pbxprojContent);
+                if (m) {
+                    const val = m[1].trim();
+                    if (val && '""' !== val && "''" !== val) found[key] = val;
+                }
+            }
+            return found;
         }
-        const COMMAND_TABLE = [
-            {
-                name: 'create',
-                positionals: [
-                    {
-                        name: 'project-name|project-path',
-                        required: true
-                    }
-                ],
-                description: 'Create a new extension from a template (React, TypeScript, Vue, Svelte, etc.)',
-                supportsSourceInspection: false
-            },
-            {
-                name: 'dev',
-                positionals: [
-                    {
-                        name: 'project-path|remote-url',
-                        required: false
-                    }
-                ],
-                description: 'Start the development server with hot reloading',
-                supportsSourceInspection: true
-            },
-            {
-                name: 'start',
-                positionals: [
-                    {
-                        name: 'project-path|remote-url',
-                        required: false
-                    }
-                ],
-                description: 'Build and start the extension in production mode',
-                supportsSourceInspection: false
-            },
-            {
-                name: 'preview',
-                positionals: [
-                    {
-                        name: 'project-name',
-                        required: false,
-                        label: 'project-path|remote-url'
-                    }
-                ],
-                description: 'Preview the extension in production mode without building',
-                supportsSourceInspection: false
-            },
-            {
-                name: 'build',
-                positionals: [
-                    {
-                        name: 'project-name',
-                        required: false,
-                        label: 'project-path|remote-url'
-                    }
-                ],
-                description: 'Build the extension for packaging and distribution',
-                supportsSourceInspection: false
-            },
-            {
-                name: 'logs',
-                positionals: [
-                    {
-                        name: 'project-path',
-                        required: false
-                    }
-                ],
-                description: 'Print or stream logs from every context of a running dev session',
-                supportsSourceInspection: false
-            },
-            {
-                name: 'eval',
-                positionals: [
-                    {
-                        name: 'expression',
-                        required: true
-                    },
-                    {
-                        name: 'project-path',
-                        required: false
-                    }
-                ],
-                description: 'Evaluate an expression in a running extension context (requires --allow-eval)',
-                supportsSourceInspection: false
-            },
-            {
-                name: 'storage',
-                positionals: [
-                    {
-                        name: 'action',
-                        required: true,
-                        values: [
-                            'get',
-                            'set'
-                        ]
-                    },
-                    {
-                        name: 'project-path',
-                        required: false
-                    }
-                ],
-                description: 'Read or write chrome.storage in a running extension (requires --allow-control)',
-                supportsSourceInspection: false
-            },
-            {
-                name: 'reload',
-                positionals: [
-                    {
-                        name: 'project-path',
-                        required: false
-                    }
-                ],
-                description: 'Reload a running extension or tab (requires --allow-control)',
-                supportsSourceInspection: false
-            },
-            {
-                name: 'open',
-                positionals: [
-                    {
-                        name: 'surface',
-                        required: true,
-                        values: [
-                            'popup',
-                            'options',
-                            'sidebar',
-                            'action',
-                            'command'
-                        ]
-                    },
-                    {
-                        name: 'project-path',
-                        required: false
-                    }
-                ],
-                description: 'Open an extension surface: popup, options, sidebar, action, or command (requires --allow-control)',
-                supportsSourceInspection: false
-            },
-            {
-                name: 'inspect',
-                positionals: [
-                    {
-                        name: 'project-path',
-                        required: false
-                    }
-                ],
-                description: 'Inspect a page or content DOM through the agent bridge (CDP-free; requires --allow-control)',
-                supportsSourceInspection: true
-            },
-            {
-                name: 'publish',
-                positionals: [
-                    {
-                        name: 'project-path',
-                        required: false
-                    }
-                ],
-                description: 'Publish to extension.dev and print a shareable URL (requires EXTENSION_DEV_TOKEN)',
-                supportsSourceInspection: false
-            },
-            {
-                name: 'install',
-                positionals: [
-                    {
-                        name: 'browser-name',
-                        required: false
-                    }
-                ],
-                description: 'Install a managed browser binary into the Extension.js cache',
-                detail: 'Defaults to chromium when no browser is named.',
-                supportsSourceInspection: false,
-                notes: [
-                    {
-                        usage: '--browser <chrome|chromium|edge|firefox|chromium-based|gecko-based|firefox-based|all>',
-                        description: 'Install multiple browsers, browser families, or all'
-                    },
-                    {
-                        usage: '--where',
-                        description: 'Print the managed browser cache root (or browser install path(s) when a browser name or --browser is provided)'
-                    }
-                ]
-            },
-            {
-                name: 'uninstall',
-                positionals: [
-                    {
-                        name: 'browser-name',
-                        required: false
-                    }
-                ],
-                description: 'Remove managed browser binaries from the Extension.js cache',
-                supportsSourceInspection: false,
-                notes: [
-                    {
-                        usage: '--all',
-                        description: 'Remove every managed browser binary'
-                    },
-                    {
-                        usage: '--where',
-                        description: 'Print the managed browser cache root (or browser install path(s) when --browser/--all is provided)'
-                    }
-                ]
-            },
-            {
-                name: 'telemetry',
-                positionals: [
-                    {
-                        name: 'action',
-                        required: false,
-                        values: [
-                            'enable',
-                            'disable',
-                            'status'
-                        ]
-                    }
-                ],
-                description: 'Manage anonymous telemetry consent (enable, disable, or show status)',
-                supportsSourceInspection: false
-            },
-            {
-                name: 'doctor',
-                positionals: [
-                    {
-                        name: 'project-path',
-                        required: false
-                    }
-                ],
-                description: 'Diagnose a dev session: ready contract, control channel, token, executor, browser',
-                supportsSourceInspection: false
+        function applyXcodeUserSettings(pbxprojContent, settings) {
+            let result = pbxprojContent;
+            for (const [key, value] of Object.entries(settings)){
+                const existing = new RegExp(`\\b${key}\\s*=\\s*[^;]+;`, 'g');
+                result = existing.test(result) ? result.replace(existing, `${key} = ${value};`) : result.replace(/buildSettings\s*=\s*\{/g, `buildSettings = {\n\t\t\t\t${key} = ${value};`);
             }
-        ];
-        const COMMANDS = COMMAND_TABLE.map((entry)=>({
-                ...entry,
-                args: commandArgSignature(entry.positionals)
-            }));
-        const commandDescriptions = Object.fromEntries(COMMANDS.map((spec)=>[
-                spec.name,
-                spec.description
-            ]));
-        function commandHelpEntry(spec) {
-            const signature = spec.args ? ` ${messages_arg(spec.args)}` : '';
-            const lines = [
-                `- ${messages_code(`extension ${spec.name}`)}${signature}`,
-                `  ${spec.description}`
-            ];
-            if (spec.detail) lines.push(`  ${spec.detail}`);
-            for (const note of spec.notes ?? [])lines.push('', `- ${messages_code(`extension ${spec.name}`)} ${messages_arg(note.usage)}`, `  ${note.description}`);
-            return lines.join('\n');
-        }
-        function availableCommandsBlock() {
-            return COMMANDS.map(commandHelpEntry).join('\n\n');
-        }
-        function unhandledError(err) {
-            const message = err instanceof Error ? err.stack || err.message : 'string' == typeof err ? err : messaging.Sc.truncate(err);
-            return `${getLoggingPrefix('error')} ${external_pintor_default().red(String(message || 'Unknown error'))}`;
-        }
-        function updateFailed(err) {
-            return `${getLoggingPrefix('warn')} Couldn't check for updates.\n${external_pintor_default().yellow('The command continues without the update check.')}\n${external_pintor_default().yellow(String(err?.message || err))}`;
+            return result;
         }
-        function checkUpdates(packageJson, update) {
-            const latest = String(update.latest);
-            const releaseNotesUrl = `https://github.com/extension-js/extension.js/releases/tag/v${latest}`;
-            const suffix = external_pintor_default().gray(`(version ${latest} is available!)`);
-            const message = `${getLoggingPrefix('info')} 🧩 An ${external_pintor_default().blue('Extension.js')} update is available.\n\nYou are on version ${external_pintor_default().red(String(packageJson.version))}.\nThe latest stable is ${external_pintor_default().green(latest)}.\nSee what's new: ${external_pintor_default().underline(releaseNotesUrl)}\nUpdate to the latest stable to get fixes and new features.`;
+        function backupAndRestoreXcodeSettings(config) {
+            const projFile = pbxprojPath(config);
+            let saved = {};
+            if (node_fs__rspack_import_0.existsSync(projFile)) saved = extractXcodeUserSettings(node_fs__rspack_import_0.readFileSync(projFile, 'utf8'));
             return {
-                suffix,
-                message
+                saved,
+                restore () {
+                    if (0 === Object.keys(saved).length) return;
+                    if (!node_fs__rspack_import_0.existsSync(projFile)) return;
+                    const content = node_fs__rspack_import_0.readFileSync(projFile, 'utf8');
+                    node_fs__rspack_import_0.writeFileSync(projFile, applyXcodeUserSettings(content, saved), 'utf8');
+                }
             };
         }
-        function programUserHelp() {
-            return `\n${getLoggingPrefix('info')} ${external_pintor_default().underline('Help center for the Extension.js program')}
-
-Usage: extension [command] [options]
-
-Notes
-- All high-level commands offer their own \`--help\` with usage and flag lists.
-- Telemetry is anonymous and privacy-safe by default; see ${messages_code('docs/TELEMETRY.md')} for the full contract.
-
-Example
-- ${messages_code('extension create --help')} outputs information about the "create" command.
-
-Available Commands
-${availableCommandsBlock()}
-
-Common Options
-- ${messages_code('--browser')} ${messages_arg('<chrome|edge|firefox|chromium|chromium-based|gecko-based|firefox-based>')} Target browser/engine (default: chromium)
-- ${messages_code('--profile')} ${messages_arg('<path|boolean>')}        Browser profile configuration
-- ${messages_code('--polyfill')} ${messages_arg('[boolean]')}            Enable/disable cross-browser polyfill
-- ${messages_code('--no-telemetry')}                            Disable anonymous telemetry for this run (persistent toggle: ${messages_code('extension telemetry disable')}, or ${messages_code('EXTENSION_TELEMETRY=0')})
-- ${messages_code('--ai-help')}                                 Show AI-assistant oriented help and tips
-- ${messages_code('--output')} ${messages_arg('<pretty|json>')}          Result format for ${messages_code('--ai-help')} and machine-readable command results (default: pretty)
-  ${messages_code('--format')} and ${messages_code('--wait-format')} still work as deprecated aliases of ${messages_code('--output')}
-- ${messages_code('--help')}                                    Show help output
-- ${messages_code('--port')} ${messages_arg('<number>')}                 Development server port (default: 8080; use 0 for OS-assigned)
-- ${messages_code('--host')} ${messages_arg('<address>')}               Dev server host (default: 127.0.0.1; use 0.0.0.0 for Docker/devcontainers)
-- ${messages_code('--public-host')} ${messages_arg('<address>')}        Connectable host the browser dials for HMR + reload bridge when it differs from ${messages_code('--host')} (remote/devcontainer; default: the bind host, or 127.0.0.1 when bound to 0.0.0.0)
-- ${messages_code('--starting-url')} ${messages_arg('<url>')}            Initial URL to load in browser
-- ${messages_code('--silent')} ${messages_arg('[boolean]')}              Suppress console output during build
-
-Browser-Specific Options
-- ${messages_code('--chromium-binary')} ${messages_arg('<path>')}        Custom Chromium binary path
-- ${messages_code('--gecko-binary')}/${messages_code('--firefox-binary')} ${messages_arg('<path>')}           Custom Firefox/Gecko binary path
-  Use ${messages_code('flatpak:org.mozilla.firefox')} as the path to launch a Flatpak-installed Firefox
-
-Build Options
-- ${messages_code('--zip')} ${messages_arg('[boolean]')}                 Create ZIP archive of built extension
-- ${messages_code('--zip-source')} ${messages_arg('[boolean]')}          Include source files in ZIP
-- ${messages_code('--zip-filename')} ${messages_arg('<name>')}           Custom ZIP filename
-
-${external_pintor_default().underline('Centralized Logger (terminal output)')}
-- The manager extension embeds a centralized logger that streams events to the CLI.
-- Enable and filter logs directly via ${messages_code('extension dev')} flags:
-  - ${messages_code('--logs')} ${messages_arg('<off|error|warn|info|debug|trace>')}    Minimum level (default: off)
-  - ${messages_code('--log-context')} ${messages_arg('<list|all>')}                     Contexts: background,content,page,sidebar,popup,options,devtools
-  - ${messages_code('--log-format')} ${messages_arg('<pretty|json|ndjson>')}            Output format (default: pretty)
-  - ${messages_code('--no-log-timestamps')}                                   Hide ISO timestamps in pretty output
-  - ${messages_code('--no-log-color')}                                        Disable color in pretty output
-  - ${messages_code('--log-url')} ${messages_arg('<substring|/regex/>')}                Filter by event.url
-  - ${messages_code('--log-tab')} ${messages_arg('<id>')}                               Filter by tabId
-- Example: ${messages_code('extension dev ./my-ext --logs=debug --log-context=all --log-format=pretty')}
-
-${messages_code('extension --help')}
-This command outputs a help file with key command options.
-
-${external_pintor_default().underline('Path Resolution (important)')}
-- Leading ${messages_code('/')} in manifest/HTML means extension root (the directory containing ${messages_code('manifest.json')}).
-- Relative paths resolve from the ${messages_code('manifest.json')} directory.
-- Absolute OS paths are used as-is.
-
-AI Assistants
-- For AI-oriented guidance and deeper tips, run ${messages_code('extension --ai-help')}
-- For machine-readable AI guidance, run ${messages_code('extension --ai-help --output json')}
-
- Report issues
- - ${external_pintor_default().underline('https://github.com/cezaraugusto/extension/issues/new')}`;
+        __webpack_require__.d(__webpack_exports__, {
+            F7: ()=>resolveSafariBuildConfig,
+            Gi: ()=>xcodeProjectPath,
+            IA: ()=>alignBundleIdentifiers,
+            OA: ()=>isValidBundleId,
+            _D: ()=>backupAndRestoreXcodeSettings,
+            aD: ()=>macOsSchemeName,
+            fd: ()=>builtAppPath,
+            vh: ()=>pbxprojPath,
+            vk: ()=>isProjectStale,
+            vx: ()=>composeXcodebuildArgs,
+            w7: ()=>composeConverterArgs,
+            x7: ()=>saveManifestFingerprint
+        }, {
+            X9: PRESERVED_SETTINGS
+        });
+    },
+    "./browsers/run-safari/safari-packager.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
+        var _safari_launch__rspack_import_0 = __webpack_require__("./browsers/run-safari/safari-launch/index.ts");
+        function withoutUndefined(input) {
+            if (!input) return {};
+            return Object.fromEntries(Object.entries(input).filter(([, value])=>void 0 !== value));
+        }
+        function createSafariPackager(options = {}) {
+            const { browser = 'safari', noOpen = true, dryRun = false, logger, ...identity } = options;
+            return async (distPath, mode = 'full', overrides)=>await (0, _safari_launch__rspack_import_0.Ah)({
+                    extension: [
+                        distPath
+                    ],
+                    browser,
+                    noOpen,
+                    dryRun,
+                    ...withoutUndefined(identity),
+                    ...withoutUndefined(overrides)
+                }, distPath, logger, mode);
         }
-        function unsupportedBrowserFlag(value, supported) {
-            return `${getLoggingPrefix('error')} Unsupported --browser value: ${value}.\n${external_pintor_default().red('Choose one of:')} ${supported.join(', ')}${external_pintor_default().red('.')}`;
+        __webpack_require__.d(__webpack_exports__, {
+            P: ()=>createSafariPackager
+        });
+    },
+    "./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);
+        const GLYPH = '⏵⏵⏵';
+        const DEBUG_GLYPH = '···';
+        const DEBUG_VALUES = new Set([
+            '1',
+            'true',
+            'yes',
+            'on',
+            'debug',
+            'dev',
+            'development'
+        ]);
+        function isDebug() {
+            const raw = process.env.EXTENSION_DEBUG ?? process.env.EXTENSION_AUTHOR_MODE;
+            return DEBUG_VALUES.has(String(raw ?? '').trim().toLowerCase());
         }
-        function safariOnlyOption(flags) {
-            return `${getLoggingPrefix('error')} ${flags.map(messages_code).join(', ')} only appl${1 === flags.length ? 'ies' : 'y'} to Safari targets.\nAdd ${messages_code('--browser safari')} (or ${messages_code('webkit-based')}).`;
+        function prefix(type) {
+            if ('error' === type) return pintor__rspack_import_0_default().red(GLYPH);
+            if ('warn' === type) return pintor__rspack_import_0_default().brightYellow(GLYPH);
+            if ('success' === type) return pintor__rspack_import_0_default().green(GLYPH);
+            if ('debug' === type) return pintor__rspack_import_0_default().dim(pintor__rspack_import_0_default().gray(DEBUG_GLYPH));
+            return pintor__rspack_import_0_default().gray(GLYPH);
         }
-        function safariInvalidBundleId(bundleId) {
-            return `${getLoggingPrefix('error')} Invalid bundle identifier: ${messages_code(bundleId)}.\nUse reverse-DNS form: dot-separated segments of letters, digits and hyphens, each starting with a letter (e.g. ${messages_code('com.example.my-extension')}).`;
+        const fmt = {
+            heading: (title)=>pintor__rspack_import_0_default().underline(pintor__rspack_import_0_default().blue(title)),
+            label: (key)=>pintor__rspack_import_0_default().gray(key.toUpperCase()),
+            val: (value)=>pintor__rspack_import_0_default().underline(value),
+            code: (value)=>pintor__rspack_import_0_default().blue(value),
+            bullet: (value)=>`- ${value}`,
+            block (title, rows) {
+                const head = fmt.heading(title);
+                const body = rows.map(([key, value])=>`${fmt.label(key)} ${value}`).join('\n');
+                return `${head}\n${body}`;
+            },
+            truncate (input, max = 800) {
+                const s = (()=>{
+                    try {
+                        return 'string' == typeof input ? input : JSON.stringify(input);
+                    } catch  {
+                        return String(input);
+                    }
+                })();
+                return s.length > max ? `${s.slice(0, max)}…` : s;
+            }
+        };
+        const CARD_LABEL_WIDTH = 15;
+        function card(input = {}) {
+            const version = String(input.version || '').trim();
+            const suffix = String(input.suffix || '').trim();
+            const head = ` 🧩 ${pintor__rspack_import_0_default().brightBlue('Extension.js')}` + (version ? ` ${pintor__rspack_import_0_default().gray(version)}` : '') + (suffix ? ` ${suffix}` : '');
+            const body = (input.rows || []).filter((row)=>String(row.value || '').trim().length > 0).map((row)=>{
+                const label = row.label.padEnd(CARD_LABEL_WIDTH);
+                return `    ${label}${pintor__rspack_import_0_default().gray(String(row.value).trim())}`;
+            });
+            return [
+                head,
+                ...body
+            ].join('\n');
         }
-        function safariCommandNotSupported(command) {
-            return `${getLoggingPrefix('error')} ${messages_code(command)} can't load an extension into Safari automatically.\nSafari extensions ship inside a signed app and are enabled by hand, so there's no live browser session to load into, unlike Chromium and Firefox.\nBuild the Safari app instead: ${messages_code('extension build --browser safari')}\nThen open the generated app and enable it in Safari → Settings → Extensions.`;
+        const CARD_KEYS_ENV = 'EXTENSION_CLI_CARD_KEYS';
+        const CARD_KEYS_SEPARATOR = '\u001f';
+        function isCardKeyClaimed(key) {
+            const claimed = String(process.env[CARD_KEYS_ENV] || '');
+            if (!claimed) return false;
+            return claimed.split(CARD_KEYS_SEPARATOR).includes(key);
         }
-        function programAIHelp() {
-            return `\n${getLoggingPrefix('info')} ${external_pintor_default().gray('Development tips for extension developers and AI assistants')}
-
-Browser-Specific Configuration
-- Use browser prefixes in manifest.json for browser-specific fields:
-  ${messages_code('{"firefox:manifest": 2, "chrome:manifest": 3}')}
-  This applies manifest v2 to Firefox only, v3 to Chrome/Edge.
-
-Centralized Logger (for AI & CI)
-- Logs from all contexts are centralized by the manager extension and streamed to the CLI.
-- Prefer these flags to control terminal logs during ${messages_code('extension dev')}:
-  - ${messages_code('--logs')} ${messages_arg('<off|error|warn|info|debug|trace>')}    Minimum level
-  - ${messages_code('--log-context')} ${messages_arg('<list|all>')}                     Contexts to include
-  - ${messages_code('--log-format')} ${messages_arg('<pretty|json|ndjson>')}            Pretty for humans; JSON for machines/NDJSON pipelines
-  - ${messages_code('--no-log-timestamps')} ${messages_arg(' ')}                        Disable timestamps (pretty)
-  - ${messages_code('--no-log-color')} ${messages_arg(' ')}                             Disable ANSI colors (pretty)
-  - ${messages_code('--log-url')} ${messages_arg('<substring|/regex/>')}                Filter by URL
-  - ${messages_code('--log-tab')} ${messages_arg('<id>')}                               Filter by tabId
-- Good CI pattern: ${messages_code('EXTENSION_DEBUG=1 EXTENSION_AUTO_EXIT_MS=6000 extension dev ./ext --logs=info --log-format=json')}
-
-Special Folders for Entrypoints
-- Use special folders to handle entrypoints and assets not declared in manifest.json:
-- ${external_pintor_default().underline(messages_code('public/'))}  - Static assets automatically copied to build (resolves to output root)
-- ${external_pintor_default().underline(messages_code('pages/'))}   - HTML files not declared in manifest (e.g., welcome pages)
-- ${external_pintor_default().underline(messages_code("scripts/"))} - JavaScript files not declared in manifest (e.g., executable scripts)
-
-Predictable Output Paths
-- Core HTML destinations are standardized across browsers so you can reference them safely in code/tests:
-  - ${messages_code('devtools_page')} → ${messages_code('devtools/index.html')}
-  - ${messages_code('sidebar_action.default_panel')} (MV2) and ${messages_code('side_panel.default_path')} (MV3) → ${messages_code('sidebar/index.html')}
-  - ${messages_code('options_ui.page')} and ${messages_code('options_page')} → ${messages_code('options/index.html')}
-  - ${messages_code('background.page')} → ${messages_code('background/index.html')}
-  - ${messages_code('action.default_popup')}, ${messages_code('browser_action.default_popup')}, ${messages_code('page_action.default_popup')} → ${messages_code('action/index.html')}
-- Other predictable outputs:
-  - ${messages_code('chrome_url_overrides.*')} → ${messages_code('chrome_url_overrides/<key>.html')}
-  - ${messages_code("content_scripts[n].js/css")} → ${messages_code("content_scripts/content-<n>.{js,css}")}
-  - ${messages_code('sandbox.pages[]')} → ${messages_code('sandbox/page-<n>.html')}
-  - ${messages_code("user_scripts.api_script")} → ${messages_code("user_scripts/api_script.js")}
-  - ${messages_code('icons/*')} → ${messages_code('icons/')} (feature-specific icon folders preserved where applicable)
-
-Public & Special Folders (Output Behavior)
-- ${external_pintor_default().underline(messages_code('public/'))} is the web root in output. Authors can use ${messages_code('/foo')}, ${messages_code('/public/foo')}, ${messages_code('public/foo')}, or ${messages_code('./public/foo')} and they all emit as ${messages_code('dist/<browser>/foo')}.
-- ${external_pintor_default().underline(messages_code('pages/'))} files emit as ${messages_code('pages/<name>.html')}. Relative assets referenced inside page HTML are emitted under ${messages_code('assets/')} preserving relative structure; public-root URLs are preserved.
-- ${external_pintor_default().underline(messages_code("scripts/"))} files emit as ${messages_code("scripts/<name>.js")} with extracted CSS when applicable.
-
-Shadow DOM for Content Scripts
-- Add ${messages_code('use shadow-dom')} directive to content scripts for style isolation
-- Automatically creates ${messages_code('#extension-root')} element with shadow DOM
-- All CSS imports are automatically injected into shadow DOM
-- Prevents style conflicts with host page
-
-Environment Variables
-- Use ${messages_code(messages_arg('EXTENSION_PUBLIC_*'))} prefix for variables accessible in extension code
-- Supported in both ${messages_code('process.env')} and ${messages_code('import.meta.env')}
-- Environment file priority: ${external_pintor_default().underline(messages_code(messages_arg('.env.{browser}.{mode}')))} > ${external_pintor_default().underline(messages_code(messages_arg('.env.{browser}')))} > ${external_pintor_default().underline(messages_code(messages_arg('.env.{mode}')))} > ${external_pintor_default().underline(messages_code(messages_arg('.env')))}
-- Example: ${messages_code(messages_arg('EXTENSION_PUBLIC_API_KEY=your_key'))}
-
-Available Templates
-- ${external_pintor_default().green('Frameworks')}: ${messages_code(messages_arg('react'))}, ${messages_code(messages_arg('preact'))}, ${messages_code(messages_arg('vue'))}, ${messages_code(messages_arg('svelte'))}
-- ${external_pintor_default().green('Languages')}: ${messages_code(messages_arg("javascript"))}, ${messages_code(messages_arg("typescript"))}
-- ${external_pintor_default().green('Contexts')}: ${messages_code(messages_arg('content'))} (content scripts), ${messages_code(messages_arg('new'))} (new tab), ${messages_code(messages_arg('action'))} (popup)
-- ${external_pintor_default().green('Styling')}: ${messages_code(messages_arg('tailwind'))}, ${messages_code(messages_arg('sass'))}, ${messages_code(messages_arg('less'))}
-- ${external_pintor_default().green('Configs')}: ${messages_code(messages_arg('eslint'))}, ${messages_code(messages_arg('prettier'))}, ${messages_code(messages_arg('stylelint'))}
-
-Webpack/Rspack Configuration
-- Create ${external_pintor_default().underline(messages_code(messages_arg('extension.config.js')))} for custom webpack configuration
-- Function receives base config, return modified config
-- Supports all webpack/rspack loaders and plugins
-- Example:
-  ${messages_code('export default {')}
-  ${messages_code('  config: (config) => {')}
-  ${messages_code("    config.module.rules.push({ test: /\\.svg$/, use: ['@svgr/webpack'] })")}
-  ${messages_code('    return config')}
-  ${messages_code('  }')}
-  ${messages_code('}')}
-
-Managed Dependencies (Important)
-- ${external_pintor_default().green('Do not add')} packages that ${external_pintor_default().blue('Extension.js')} already ships in its own toolchain.
-- The guard only triggers when a managed package is declared in your ${messages_code('package.json')} ${external_pintor_default().gray('and')} is imported (as a module specifier) in your ${external_pintor_default().underline(messages_code('extension.config.js'))}.
-- In that case, the program will ${external_pintor_default().red('print an error and abort')} to avoid version conflicts.
-- Remove the duplicate from your project ${messages_code('package.json')} or avoid referencing it in ${external_pintor_default().underline(messages_code('extension.config.js'))} and rely on the built-in version instead.
-- If you truly need a different version, open an issue so we can evaluate a safe upgrade.
-
-Framework-Specific Configuration
-- Create ${external_pintor_default().underline(messages_code(messages_arg('vue.loader.js')))} for Vue-specific loader configuration
-- Create ${external_pintor_default().underline(messages_code(messages_arg('svelte.loader.js')))} for Svelte-specific loader configuration
-- Automatically detected and used by Extension.js
-- Example svelte.loader.js:
-  ${messages_code('module.exports = {')}
-  ${messages_code('  preprocess: require("svelte-preprocess")({')}
-  ${messages_code("    typescript: true")}
-  ${messages_code('  })')}
-  ${messages_code('}')}
-
-Hot Module Replacement (HMR)
-- Automatically enabled in development mode
-- CSS changes trigger automatic style updates
-- React components fast-refresh; Svelte components hot-update
-- Preact and Vue rebuild with a live reload (component state resets)
-- Content scripts automatically re-inject on changes
-- Service workers, _locales and manifest changes reload the extension
-
-Non-Destructive Testing in CI
-- Prefer ${messages_code('EXTENSION_DEBUG=1')} to copy local templates and avoid network.
-- Reuse Playwright's Chromium via ${messages_code('--chromium-binary')} path when available.
-- Set ${messages_code(messages_arg('EXTENSION_AUTO_EXIT_MS'))} and ${messages_code(messages_arg('EXTENSION_FORCE_KILL_MS'))} for non-interactive dev sessions.
-
-File Watching & HMR Examples
-- Content script JS/TS changes trigger reinjection; CSS changes update styles live.
-- For watch-source HTML prints, update a visible string in ${messages_code("content/scripts.*")} and assert it appears in stdout.
-
-Troubleshooting
-- Use ${messages_code('--silent true')} during builds to reduce noise; logs still surface errors.
-- When ports conflict, pass ${messages_code('--port 0')} to auto-select an available port.
-- In Docker/devcontainers, pass ${messages_code('--host 0.0.0.0')} so the dev server is reachable from the host.
-
-Non-Interactive / Auto Mode (CI)
-- Set ${messages_code(messages_arg('EXTENSION_AUTO_EXIT_MS'))} to enable self-termination after N milliseconds.
-  Useful when ${messages_code('pnpm extension dev')} would otherwise hang under Rspack watch.
-  Example: ${messages_code(messages_arg('EXTENSION_AUTO_EXIT_MS=6000'))} pnpm extension dev ./templates/react --browser chrome --starting-url ${messages_arg('https://example.com')}
-- Optional: ${messages_code(messages_arg('EXTENSION_FORCE_KILL_MS'))} to hard-exit after N ms as a fallback (defaults to auto-exit + 4000).
-
-Docker / Devcontainers / Codespaces
-- Use ${messages_code('--host 0.0.0.0')} to bind the dev server on all interfaces so HMR is reachable from the host.
-- Use ${messages_code('--no-browser')} inside the container and load the extension manually from ${messages_code('dist/<browser>/')} in your host browser.
-- Chromium sandbox flags (${messages_code('--no-sandbox')}) are added automatically when Docker, Podman, devcontainers, or Codespaces are detected.
-- File watching uses polling by default (1 s interval), which works across bind-mounted volumes.
-- Example: ${messages_code('extension dev ./my-ext --host 0.0.0.0 --no-browser --port 8080')}
-
-Flatpak Firefox
-- Use ${messages_code('--gecko-binary flatpak:org.mozilla.firefox')} (or ${messages_code('--firefox-binary')}) to launch a Flatpak-installed Firefox.
-- Extension.js rewrites the binary path to ${messages_code('flatpak run')} with the correct filesystem grants automatically.
-
-Cross-Browser Compatibility
-- Use ${messages_code('--polyfill')} flag to enable webextension-polyfill
-- Automatically handles browser API differences
-- Supports Chrome, Edge, Firefox with single codebase`;
+        function claimCardKey(key) {
+            if (isCardKeyClaimed(key)) return false;
+            const claimed = String(process.env[CARD_KEYS_ENV] || '');
+            process.env[CARD_KEYS_ENV] = claimed ? `${claimed}${CARD_KEYS_SEPARATOR}${key}` : key;
+            return true;
+        }
+        const GECKO_BROWSERS = new Set([
+            'firefox',
+            'firefox-based',
+            'gecko-based',
+            'librewolf',
+            'waterfox'
+        ]);
+        function artifactNoun(browser) {
+            const name = String(browser || '').trim().toLowerCase();
+            if (GECKO_BROWSERS.has(name)) return 'Add-on';
+            if (name.includes('gecko') || name.includes('firefox')) return 'Add-on';
+            return 'Extension';
+        }
+        const ENVELOPE_SCHEMA = 1;
+        const CODES = {
+            E_ARGS: 'E_ARGS',
+            E_PROJECT_NOT_FOUND: 'E_PROJECT_NOT_FOUND',
+            E_MANIFEST_NOT_FOUND: 'E_MANIFEST_NOT_FOUND',
+            E_MANIFEST_INVALID: 'E_MANIFEST_INVALID',
+            E_FIRST_COMPILE: 'E_FIRST_COMPILE',
+            E_COMPILE: 'E_COMPILE',
+            E_BROWSER_NOT_FOUND: 'E_BROWSER_NOT_FOUND',
+            E_BROWSER_LAUNCH: 'E_BROWSER_LAUNCH',
+            E_PROFILE_LOCKED: 'E_PROFILE_LOCKED',
+            E_READY_TIMEOUT: 'E_READY_TIMEOUT',
+            E_SESSION_EXISTS: 'E_SESSION_EXISTS',
+            E_CONTROL_DENIED: 'E_CONTROL_DENIED',
+            E_CONTROL_UNAVAILABLE: 'E_CONTROL_UNAVAILABLE',
+            E_TOKEN_MISSING: 'E_TOKEN_MISSING',
+            E_NETWORK: 'E_NETWORK',
+            E_INTERRUPTED: 'E_INTERRUPTED',
+            E_NOT_IMPLEMENTED: 'E_NOT_IMPLEMENTED',
+            E_INTERNAL: 'E_INTERNAL',
+            E_UNSUPPORTED_BROWSER: 'E_UNSUPPORTED_BROWSER',
+            E_INVALID_OPTION: 'E_INVALID_OPTION',
+            E_PORT_UNAVAILABLE: 'E_PORT_UNAVAILABLE',
+            E_DEPENDENCY_INSTALL: 'E_DEPENDENCY_INSTALL',
+            E_TEMPLATE_NOT_FOUND: 'E_TEMPLATE_NOT_FOUND',
+            E_DESTINATION_NOT_EMPTY: 'E_DESTINATION_NOT_EMPTY',
+            E_DESTINATION_NOT_WRITABLE: 'E_DESTINATION_NOT_WRITABLE',
+            E_BROWSER_DOWNLOAD: 'E_BROWSER_DOWNLOAD',
+            E_SESSION_NOT_FOUND: 'E_SESSION_NOT_FOUND',
+            E_EVAL_REFUSED: 'E_EVAL_REFUSED',
+            E_TARGET_NOT_FOUND: 'E_TARGET_NOT_FOUND',
+            E_TIMEOUT: 'E_TIMEOUT',
+            E_PUBLISH_REJECTED: 'E_PUBLISH_REJECTED',
+            E_AUTH_REQUIRED: 'E_AUTH_REQUIRED',
+            E_SAFARI_TOOLCHAIN: 'E_SAFARI_TOOLCHAIN',
+            E_EVAL: 'E_EVAL',
+            E_INSPECT: 'E_INSPECT',
+            E_STORAGE: 'E_STORAGE',
+            E_LOGS_NOT_FOUND: 'E_LOGS_NOT_FOUND',
+            E_READY_ERROR_STATUS: 'E_READY_ERROR_STATUS',
+            E_COMMAND_UNSUPPORTED_FOR_TARGET: 'E_COMMAND_UNSUPPORTED_FOR_TARGET',
+            E_FLAG_VALUE_INVALID: 'E_FLAG_VALUE_INVALID',
+            E_FLAG_NOT_SUPPORTED_HERE: 'E_FLAG_NOT_SUPPORTED_HERE',
+            E_DEV_SERVER_START: 'E_DEV_SERVER_START',
+            E_DOCTOR_CHECKS_FAILED: 'E_DOCTOR_CHECKS_FAILED',
+            E_TELEMETRY_WRITE: 'E_TELEMETRY_WRITE',
+            E_PREVIEW_NO_DIST: 'E_PREVIEW_NO_DIST',
+            E_BROWSER_UNINSTALL: 'E_BROWSER_UNINSTALL',
+            E_NODE_VERSION: 'E_NODE_VERSION',
+            E_UNKNOWN_COMMAND: 'E_UNKNOWN_COMMAND',
+            E_REMOVED_FLAG: 'E_REMOVED_FLAG',
+            E_BROWSER_NOT_INSTALLABLE: 'E_BROWSER_NOT_INSTALLABLE',
+            E_PARENT_GONE: 'E_PARENT_GONE',
+            E_REMOTE_URL_UNSUPPORTED: 'E_REMOTE_URL_UNSUPPORTED',
+            E_CONFIG_LOAD: 'E_CONFIG_LOAD',
+            E_MANAGED_DEP_CONFLICT: 'E_MANAGED_DEP_CONFLICT',
+            E_TYPES_EMIT: 'E_TYPES_EMIT',
+            E_TSCONFIG_MISSING: 'E_TSCONFIG_MISSING',
+            E_OPTIONAL_DEP_UNRESOLVED: 'E_OPTIONAL_DEP_UNRESOLVED',
+            E_OPTIONAL_DEP_LOAD: 'E_OPTIONAL_DEP_LOAD',
+            E_OPTIONAL_DEP_UNKNOWN: 'E_OPTIONAL_DEP_UNKNOWN',
+            E_COMPANION_EXTENSION_PATH: 'E_COMPANION_EXTENSION_PATH',
+            E_MANIFEST_IN_PUBLIC: 'E_MANIFEST_IN_PUBLIC',
+            E_RUNTIME_NOT_FOUND: 'E_RUNTIME_NOT_FOUND',
+            E_MANIFEST_SHAPE: 'E_MANIFEST_SHAPE',
+            E_MANIFEST_PAGE_MISSING: 'E_MANIFEST_PAGE_MISSING',
+            E_MANIFEST_VERSION_UNSUPPORTED: 'E_MANIFEST_VERSION_UNSUPPORTED',
+            E_MANIFEST_LOAD_BLOCKERS: 'E_MANIFEST_LOAD_BLOCKERS',
+            E_MANIFEST_PERMISSION_MISSING: 'E_MANIFEST_PERMISSION_MISSING',
+            E_MANIFEST_MSG_KEY_MISSING: 'E_MANIFEST_MSG_KEY_MISSING',
+            E_MANIFEST_EMIT: 'E_MANIFEST_EMIT',
+            E_RESTART_REQUIRED: 'E_RESTART_REQUIRED',
+            E_COMPILE_FATAL: 'E_COMPILE_FATAL',
+            E_MODULE_NOT_FOUND: 'E_MODULE_NOT_FOUND',
+            E_ENTRY_NOT_FOUND: 'E_ENTRY_NOT_FOUND',
+            E_ASSET_MISSING: 'E_ASSET_MISSING',
+            E_SCRIPT_DEP_MISSING: 'E_SCRIPT_DEP_MISSING',
+            E_RESERVED_FOLDER: 'E_RESERVED_FOLDER',
+            E_CSS_PARSE: 'E_CSS_PARSE',
+            E_CSS_PREPROCESSOR_MISSING: 'E_CSS_PREPROCESSOR_MISSING',
+            E_CSS_DEAD_REF: 'E_CSS_DEAD_REF',
+            E_INTEGRATION_INSTALL: 'E_INTEGRATION_INSTALL',
+            E_POLYFILL_NOT_FOUND: 'E_POLYFILL_NOT_FOUND',
+            E_LOCALES_LAYOUT: 'E_LOCALES_LAYOUT',
+            E_WAR_INVALID: 'E_WAR_INVALID',
+            E_MATCH_PATTERN_INVALID: 'E_MATCH_PATTERN_INVALID',
+            E_BACKGROUND_REQUIRED: 'E_BACKGROUND_REQUIRED',
+            E_CONTENT_SCRIPT_SYNTAX: 'E_CONTENT_SCRIPT_SYNTAX',
+            E_NO_ENTRYPOINTS: 'E_NO_ENTRYPOINTS',
+            E_REMOTE_RESOURCE_BLOCKED: 'E_REMOTE_RESOURCE_BLOCKED',
+            E_PERF_BUDGET: 'E_PERF_BUDGET',
+            E_ZIP_SKIPPED: 'E_ZIP_SKIPPED',
+            E_ENV_NO_MATCH: 'E_ENV_NO_MATCH',
+            E_REMOTE_FETCH_TIMEOUT: 'E_REMOTE_FETCH_TIMEOUT',
+            E_REMOTE_DOWNLOAD: 'E_REMOTE_DOWNLOAD',
+            E_REMOTE_ZIP_INVALID: 'E_REMOTE_ZIP_INVALID',
+            E_LOCAL_ZIP_NOT_FOUND: 'E_LOCAL_ZIP_NOT_FOUND',
+            E_PROJECT_DOWNLOAD_EMPTY: 'E_PROJECT_DOWNLOAD_EMPTY',
+            E_BROWSER_BINARY_REQUIRED: 'E_BROWSER_BINARY_REQUIRED',
+            E_BROWSER_BINARY_INVALID: 'E_BROWSER_BINARY_INVALID',
+            E_BROWSER_EXITED: 'E_BROWSER_EXITED',
+            E_BROWSER_START_TIMEOUT: 'E_BROWSER_START_TIMEOUT',
+            E_LAUNCH_SKIPPED_COMPILE_ERRORS: 'E_LAUNCH_SKIPPED_COMPILE_ERRORS',
+            E_INSTANCE_AMBIGUOUS: 'E_INSTANCE_AMBIGUOUS',
+            E_WSL_INTEROP: 'E_WSL_INTEROP',
+            E_EXTENSION_LOAD_REFUSED: 'E_EXTENSION_LOAD_REFUSED',
+            E_ADDON_INSTALL: 'E_ADDON_INSTALL',
+            E_BROWSER_CONNECT: 'E_BROWSER_CONNECT',
+            E_BROWSER_CONNECTION_CLOSED: 'E_BROWSER_CONNECTION_CLOSED',
+            E_CDP_NOT_CONNECTED: 'E_CDP_NOT_CONNECTED',
+            E_CDP_TIMEOUT: 'E_CDP_TIMEOUT',
+            E_CDP_OP_FAILED: 'E_CDP_OP_FAILED',
+            E_EXTENSION_ID_UNKNOWN: 'E_EXTENSION_ID_UNKNOWN',
+            E_RDP_PROTOCOL: 'E_RDP_PROTOCOL',
+            E_DEV_SERVER_TIMEOUT: 'E_DEV_SERVER_TIMEOUT',
+            E_PORT_IN_USE: 'E_PORT_IN_USE',
+            E_SESSION_STOPPED: 'E_SESSION_STOPPED',
+            E_LOGS_STREAM_GAP: 'E_LOGS_STREAM_GAP',
+            E_CREATE_DIR: 'E_CREATE_DIR',
+            E_CREATE_WRITE: 'E_CREATE_WRITE',
+            E_CREATE_TESTS_SETUP: 'E_CREATE_TESTS_SETUP',
+            E_GIT_SKIPPED: 'E_GIT_SKIPPED',
+            E_BROWSER_INSTALL_PRIVILEGE: 'E_BROWSER_INSTALL_PRIVILEGE',
+            E_UNINSTALL_NOOP: 'E_UNINSTALL_NOOP'
+        };
+        function withExtras(base, extras) {
+            return {
+                ...base,
+                ...extras.hint ? {
+                    hint: extras.hint
+                } : {},
+                ...extras.truncated ? {
+                    truncated: true
+                } : {},
+                warnings: extras.warnings || []
+            };
+        }
+        const ENVELOPE = {
+            schema: ENVELOPE_SCHEMA,
+            ok (command, status, value, extras = {}) {
+                return withExtras({
+                    schema: ENVELOPE_SCHEMA,
+                    ok: true,
+                    command,
+                    status,
+                    value,
+                    error: null,
+                    warnings: []
+                }, extras);
+            },
+            fail (command, status, error, extras = {}) {
+                return withExtras({
+                    schema: ENVELOPE_SCHEMA,
+                    ok: false,
+                    command,
+                    status,
+                    value: extras.value ?? null,
+                    error,
+                    warnings: []
+                }, extras);
+            }
+        };
+        __webpack_require__.d(__webpack_exports__, {
+            Nr: ()=>card,
+            Pl: ()=>prefix,
+            T_: ()=>artifactNoun,
+            VR: ()=>isCardKeyClaimed,
+            _o: ()=>isDebug,
+            od: ()=>claimCardKey
+        }, {
+            Lp: CODES,
+            Pr: ENVELOPE,
+            Sc: fmt
+        });
+    },
+    "./index.ts" (__unused_rspack_module, __unused_rspack___webpack_exports__, __webpack_require__) {
+        const MIN_NODE_MAJOR = 22;
+        const MIN_NODE_MINOR = 12;
+        function isSupportedNodeVersion(version) {
+            const [major, minor] = version.split('.').map((part)=>parseInt(part, 10));
+            if (!Number.isFinite(major)) return true;
+            if (major !== MIN_NODE_MAJOR) return major > MIN_NODE_MAJOR;
+            return (Number.isFinite(minor) ? minor : 0) >= MIN_NODE_MINOR;
+        }
+        function unsupportedNodeVersionMessage(version) {
+            return `[Extension.js] Requires Node.js >= ${MIN_NODE_MAJOR}.${MIN_NODE_MINOR} (you are on ${version}). Upgrade Node.js to run the extension CLI.`;
+        }
+        function enforceSupportedNodeVersion(version = process.versions.node) {
+            if (isSupportedNodeVersion(version)) return;
+            console.error(unsupportedNodeVersionMessage(version));
+            process.exit(1);
+        }
+        enforceSupportedNodeVersion();
+        const external_commander_namespaceObject = require("commander");
+        var external_node_fs_ = __webpack_require__("node:fs");
+        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_);
+        async function exitAfterDrain(code) {
+            await Promise.all([
+                process.stdout,
+                process.stderr
+            ].map((stream)=>new Promise((resolve)=>{
+                    if (0 === stream.writableLength) return resolve();
+                    stream.write('', ()=>resolve());
+                })));
+            process.exit(code);
+        }
+        var external_node_module_ = __webpack_require__("node:module");
+        const external_node_url_namespaceObject = require("node:url");
+        const extension_develop_runtime_require = (0, external_node_module_.createRequire)(__rslib_import_meta_url__);
+        function parseJsonSafe(filePath) {
+            return JSON.parse(external_node_fs_default().readFileSync(filePath, 'utf8'));
+        }
+        function resolveDevelopRootFromDir(dir) {
+            try {
+                const packageJsonPath = external_node_path_default().join(dir, 'package.json');
+                if (!external_node_fs_default().existsSync(packageJsonPath)) return;
+                const pkg = parseJsonSafe(packageJsonPath);
+                return pkg?.name === 'extension-develop' ? dir : void 0;
+            } catch  {
+                return;
+            }
         }
-        function programAIHelpJSON(version) {
+        function resolveWorkspaceDevelopRoot(startDir) {
+            let currentDir = external_node_path_default().resolve(startDir);
+            if (currentDir.split(external_node_path_default().sep).includes('node_modules')) return;
+            for(let depth = 0; depth < 8; depth += 1){
+                const candidate = external_node_path_default().join(currentDir, 'programs', 'develop');
+                const resolved = resolveDevelopRootFromDir(candidate);
+                if (resolved) return resolved;
+                const parent = external_node_path_default().dirname(currentDir);
+                if (parent === currentDir) break;
+                currentDir = parent;
+            }
+        }
+        function resolveInstalledDevelopRoot() {
+            try {
+                const packageJsonPath = extension_develop_runtime_require.resolve('extension-develop/package.json');
+                return resolveDevelopRootFromDir(external_node_path_default().dirname(packageJsonPath));
+            } catch  {
+                try {
+                    const entryPath = extension_develop_runtime_require.resolve('extension-develop');
+                    return resolveDevelopRootFromDir(external_node_path_default().dirname(external_node_path_default().dirname(entryPath)));
+                } catch  {
+                    return;
+                }
+            }
+        }
+        function resolvePreferredDevelopRoot(startDir) {
+            const workspaceRoot = resolveWorkspaceDevelopRoot(startDir);
+            if (workspaceRoot) return {
+                root: workspaceRoot,
+                source: 'workspace'
+            };
+            const envRoot = process.env.EXTENSION_DEVELOP_ROOT ? resolveDevelopRootFromDir(external_node_path_default().resolve(process.env.EXTENSION_DEVELOP_ROOT)) : void 0;
+            if (envRoot) return {
+                root: envRoot,
+                source: 'env'
+            };
+            const installedRoot = resolveInstalledDevelopRoot();
+            if (installedRoot) return {
+                root: installedRoot,
+                source: 'installed'
+            };
             return {
-                version,
-                commands: COMMANDS.map((spec)=>({
-                        name: spec.name,
-                        summary: spec.description,
-                        supportsSourceInspection: spec.supportsSourceInspection
-                    })),
-                globalOptions: [
+                root: void 0,
+                source: 'missing'
+            };
+        }
+        function resolveDevelopDistEntry(root, name = 'module') {
+            const base = external_node_path_default().join(root, 'dist', name);
+            const candidates = [
+                `${base}.mjs`,
+                `${base}.cjs`,
+                `${base}.js`,
+                base
+            ];
+            for (const candidate of candidates)if (external_node_fs_default().existsSync(candidate)) return candidate;
+        }
+        function resolveExtensionDevelopRoot(startDir = __dirname) {
+            const { root, source } = resolvePreferredDevelopRoot(startDir);
+            if (!root) throw new Error('Unable to locate the extension-develop runtime.');
+            process.env.EXTENSION_DEVELOP_ROOT = root;
+            if ('workspace' === source) process.env.EXTENSION_CREATE_DEVELOP_ROOT = root;
+            return root;
+        }
+        function resolveExtensionDevelopVersion(startDir = __dirname, fallbackVersion) {
+            try {
+                const root = resolveExtensionDevelopRoot(startDir);
+                const packageJsonPath = external_node_path_default().join(root, 'package.json');
+                const pkg = parseJsonSafe(packageJsonPath);
+                return pkg?.version || fallbackVersion || '0.0.0';
+            } catch  {
+                return fallbackVersion || '0.0.0';
+            }
+        }
+        async function importModule(filePath) {
+            const mod = await import((0, external_node_url_namespaceObject.pathToFileURL)(filePath).href);
+            return mod?.default && 'object' == typeof mod.default ? {
+                ...mod.default,
+                ...mod
+            } : mod;
+        }
+        async function loadExtensionDevelopModule(startDir = __dirname) {
+            const root = resolveExtensionDevelopRoot(startDir);
+            const { source } = resolvePreferredDevelopRoot(startDir);
+            const distEntry = resolveDevelopDistEntry(root);
+            if (distEntry) return importModule(distEntry);
+            if ('workspace' === source) throw new Error(`Local extension-develop runtime is not built at ${external_node_path_default().join(root, 'dist')}. Run \`pnpm --filter extension-develop compile\` before invoking the local CLI.`);
+            return await import("extension-develop");
+        }
+        async function loadExtensionDevelopPreviewModule(startDir = __dirname) {
+            const root = resolveExtensionDevelopRoot(startDir);
+            const { source } = resolvePreferredDevelopRoot(startDir);
+            const previewEntry = resolveDevelopDistEntry(root, 'preview');
+            if (previewEntry) return importModule(previewEntry);
+            const fullEntry = resolveDevelopDistEntry(root);
+            if (fullEntry) return importModule(fullEntry);
+            if ('workspace' === source) throw new Error(`Local extension-develop runtime is not built at ${external_node_path_default().join(root, 'dist')}. Run \`pnpm --filter extension-develop compile\` before invoking the local CLI.`);
+            return await import("extension-develop/preview");
+        }
+        async function loadExtensionDevelopBridgeModule(startDir = __dirname) {
+            const root = resolveExtensionDevelopRoot(startDir);
+            const { source } = resolvePreferredDevelopRoot(startDir);
+            const bridgeEntry = resolveDevelopDistEntry(root, 'bridge');
+            if (bridgeEntry) return importModule(bridgeEntry);
+            if ('workspace' === source) throw new Error(`Local extension-develop runtime is not built at ${external_node_path_default().join(root, 'dist')}. Run \`pnpm --filter extension-develop compile\` before invoking the local CLI.`);
+            const bridgeSpecifier = 'extension-develop/bridge';
+            return await import(bridgeSpecifier);
+        }
+        var external_pintor_ = __webpack_require__("pintor");
+        var external_pintor_default = /*#__PURE__*/ __webpack_require__.n(external_pintor_);
+        var messaging = __webpack_require__("./helpers/messaging.ts");
+        function getLoggingPrefix(type) {
+            return (0, messaging.Pl)(type);
+        }
+        const messages_code = (text)=>external_pintor_default().blue(text);
+        const messages_arg = (text)=>external_pintor_default().gray(text);
+        function renderArgToken(spec) {
+            const token = spec.values ? spec.values.join('|') : spec.label ?? spec.name;
+            return spec.required ? `<${token}>` : `[${token}]`;
+        }
+        function commandArgSignature(positionals) {
+            return positionals.map(renderArgToken).join(' ');
+        }
+        const COMMAND_TABLE = [
+            {
+                name: 'create',
+                positionals: [
                     {
-                        name: '--ai-help',
-                        description: 'Show AI-assistant oriented help and tips'
+                        name: 'project-name|project-path',
+                        required: true
+                    }
+                ],
+                description: 'Create a new extension from a template (React, TypeScript, Vue, Svelte, etc.)',
+                supportsSourceInspection: false
+            },
+            {
+                name: 'dev',
+                positionals: [
+                    {
+                        name: 'project-path|remote-url',
+                        required: false
+                    }
+                ],
+                description: 'Start the development server with hot reloading',
+                supportsSourceInspection: true
+            },
+            {
+                name: 'start',
+                positionals: [
+                    {
+                        name: 'project-path|remote-url',
+                        required: false
+                    }
+                ],
+                description: 'Build and start the extension in production mode',
+                supportsSourceInspection: false
+            },
+            {
+                name: 'preview',
+                positionals: [
+                    {
+                        name: 'project-name',
+                        required: false,
+                        label: 'project-path|remote-url'
+                    }
+                ],
+                description: 'Preview the extension in production mode without building',
+                supportsSourceInspection: false
+            },
+            {
+                name: 'build',
+                positionals: [
+                    {
+                        name: 'project-name',
+                        required: false,
+                        label: 'project-path|remote-url'
+                    }
+                ],
+                description: 'Build the extension for packaging and distribution',
+                supportsSourceInspection: false
+            },
+            {
+                name: 'logs',
+                positionals: [
+                    {
+                        name: 'project-path',
+                        required: false
+                    }
+                ],
+                description: 'Print or stream logs from every context of a running dev session',
+                supportsSourceInspection: false
+            },
+            {
+                name: 'eval',
+                positionals: [
+                    {
+                        name: 'expression',
+                        required: true
+                    },
+                    {
+                        name: 'project-path',
+                        required: false
+                    }
+                ],
+                description: 'Evaluate an expression in a running extension context (requires --allow-eval)',
+                supportsSourceInspection: false
+            },
+            {
+                name: 'storage',
+                positionals: [
+                    {
+                        name: 'action',
+                        required: true,
+                        values: [
+                            'get',
+                            'set'
+                        ]
+                    },
+                    {
+                        name: 'project-path',
+                        required: false
+                    }
+                ],
+                description: 'Read or write chrome.storage in a running extension (requires --allow-control)',
+                supportsSourceInspection: false
+            },
+            {
+                name: 'reload',
+                positionals: [
+                    {
+                        name: 'project-path',
+                        required: false
+                    }
+                ],
+                description: 'Reload a running extension or tab (requires --allow-control)',
+                supportsSourceInspection: false
+            },
+            {
+                name: 'open',
+                positionals: [
+                    {
+                        name: 'surface',
+                        required: true,
+                        values: [
+                            'popup',
+                            'options',
+                            'sidebar',
+                            'action',
+                            'command'
+                        ]
                     },
                     {
-                        name: '--output',
-                        values: [
-                            'pretty',
-                            'json'
-                        ],
-                        default: 'pretty',
-                        description: 'Result format for --ai-help (--format is a deprecated alias)'
-                    },
+                        name: 'project-path',
+                        required: false
+                    }
+                ],
+                description: 'Open an extension surface: popup, options, sidebar, action, or command (requires --allow-control)',
+                supportsSourceInspection: false
+            },
+            {
+                name: 'inspect',
+                positionals: [
                     {
-                        name: '--no-telemetry',
-                        description: 'Disable anonymous telemetry for this run. Persistent toggle: `extension telemetry disable`. Hard override: `EXTENSION_TELEMETRY=0`.'
-                    },
+                        name: 'project-path',
+                        required: false
+                    }
+                ],
+                description: 'Inspect a page or content DOM through the agent bridge (CDP-free; requires --allow-control)',
+                supportsSourceInspection: true
+            },
+            {
+                name: 'publish',
+                positionals: [
                     {
-                        name: '--browser',
-                        values: [
-                            'chrome',
-                            'edge',
-                            'firefox',
-                            'chromium',
-                            'chromium-based',
-                            'gecko-based',
-                            'firefox-based'
-                        ],
-                        default: 'chromium',
-                        description: 'Target browser/engine'
-                    },
+                        name: 'project-path',
+                        required: false
+                    }
+                ],
+                description: 'Publish to extension.dev and print a shareable URL (requires EXTENSION_DEV_TOKEN)',
+                supportsSourceInspection: false
+            },
+            {
+                name: 'install',
+                positionals: [
                     {
-                        name: '--port',
-                        default: '8080',
-                        description: 'Development server port (use 0 for OS-assigned available port)'
-                    },
+                        name: 'browser-name',
+                        required: false
+                    }
+                ],
+                description: 'Install a managed browser binary into the Extension.js cache',
+                detail: 'Defaults to chromium when no browser is named.',
+                supportsSourceInspection: false,
+                notes: [
                     {
-                        name: '--host',
-                        default: '127.0.0.1',
-                        description: 'Dev server host address (use 0.0.0.0 for Docker/devcontainers)'
+                        usage: '--browser <chrome|chromium|edge|firefox|chromium-based|gecko-based|firefox-based|all>',
+                        description: 'Install multiple browsers, browser families, or all'
                     },
                     {
-                        name: '--public-host',
-                        default: 'bind host (127.0.0.1 when bound to 0.0.0.0)',
-                        description: 'Connectable host the browser dials for HMR + the reload bridge when it differs from the bind host (remote/devcontainer)'
+                        usage: '--where',
+                        description: 'Print the managed browser cache root (or browser install path(s) when a browser name or --browser is provided)'
+                    }
+                ]
+            },
+            {
+                name: 'uninstall',
+                positionals: [
+                    {
+                        name: 'browser-name',
+                        required: false
                     }
                 ],
-                capabilities: {
-                    logger: {
-                        levels: [
-                            'off',
-                            'error',
-                            'warn',
-                            'info',
-                            'debug',
-                            'trace',
-                            'all'
-                        ],
-                        formats: [
-                            'pretty',
-                            'json',
-                            'ndjson'
-                        ],
-                        notes: [
-                            'centralized logger streams logs from multiple extension contexts',
-                            '--logs defaults to off unless explicitly enabled'
-                        ]
-                    },
-                    managedDependencies: {
-                        enforcement: 'guarded',
-                        trigger: 'when managed packages are declared in package.json and imported as a module specifier in extension.config',
-                        action: 'print an error and abort'
-                    },
-                    readyContract: {
-                        readyPath: 'dist/extension-js/<browser>/ready.json',
-                        eventsPath: 'dist/extension-js/<browser>/events.ndjson',
-                        waitFlag: '--wait blocks until ready.json reports ready (or error) then exits; pair with --output json for machine output (--wait-format is a deprecated alias)',
-                        statuses: [
-                            'starting',
-                            'ready',
-                            'error'
-                        ],
-                        readyFields: [
-                            'status',
-                            'command',
-                            'browser',
-                            'runId',
-                            'startedAt',
-                            'distPath',
-                            'manifestPath',
-                            'port',
-                            'pid',
-                            'ts',
-                            'compiledAt',
-                            'errors'
-                        ],
-                        eventTypes: [
-                            'compile_start',
-                            'compile_success',
-                            'compile_error',
-                            'shutdown'
-                        ],
-                        notes: [
-                            'ready.json is written atomically by the build (dev/start) on each compile',
-                            'events.ndjson is an append-only build timeline with durationMs and errorCount per entry',
-                            '--wait requires a local project path (remote URLs are not supported)',
-                            'consumers should verify pid liveness and recency before trusting a contract'
-                        ]
+                description: 'Remove managed browser binaries from the Extension.js cache',
+                supportsSourceInspection: false,
+                notes: [
+                    {
+                        usage: '--all',
+                        description: 'Remove every managed browser binary'
                     },
-                    dockerAndContainers: {
-                        hostFlag: '--host 0.0.0.0 binds the dev server to all interfaces',
-                        sandboxDetection: [
-                            '/.dockerenv',
-                            '/run/.containerenv',
-                            'REMOTE_CONTAINERS=true',
-                            'CODESPACES=true',
-                            'container env var'
-                        ],
-                        notes: [
-                            'Use --no-browser inside the container and load dist/<browser>/ in the host browser',
-                            'File watching uses polling (1s interval) for bind-mount compatibility',
-                            '--no-sandbox is added automatically when a container environment is detected'
-                        ]
+                    {
+                        usage: '--where',
+                        description: 'Print the managed browser cache root (or browser install path(s) when --browser/--all is provided)'
                     }
-                },
-                examples: [
-                    'extension --ai-help',
-                    'extension --ai-help --output json',
-                    'extension dev ./my-ext --logs=info --log-format=json',
-                    'extension dev ./my-ext --host 0.0.0.0 --no-browser',
-                    'extension dev ./my-ext --wait --browser=chromium --output json',
-                    'extension start ./my-ext --wait --browser=chromium --output json',
-                    'extension dev ./my-ext --gecko-binary flatpak:org.mozilla.firefox',
-                    'extension install chromium',
-                    'extension install --where',
-                    'extension uninstall --where',
-                    'extension uninstall --all'
                 ]
-            };
-        }
-        function invalidAIHelpFormat(value) {
-            return `${getLoggingPrefix('error')} Invalid value for ${messages_code('--output')}: ${external_pintor_default().red(String(value))}.\n${external_pintor_default().red('Pass')} ${messages_arg('pretty')} ${external_pintor_default().red('or')} ${messages_arg('json')}${external_pintor_default().red(', for example')} ${messages_code('extension --ai-help --output json')}${external_pintor_default().red('.')}`;
-        }
-        function removedNoRunnerFlag() {
-            return `${getLoggingPrefix('error')} ${messages_code('--no-runner')} was removed.\nUse ${messages_code('--no-browser')} instead.`;
-        }
-        function deprecatedOutputAlias(flag) {
-            return `${getLoggingPrefix('warn')} ${messages_code(flag)} is deprecated and maps to ${messages_code('--output')}.\nPass ${messages_code('--output')} ${messages_arg('<pretty|json>')} instead.`;
-        }
-        function noBrowserNotSupportedForCommand(command) {
-            return `${getLoggingPrefix('error')} ${messages_code('--no-browser')} is only supported for ${messages_code('dev')}, ${messages_code('start')}, and ${messages_code('preview')}.\nReceived command: ${messages_code(command || '(none)')}`;
-        }
-        function readRecentConsole(projectPath, browser, target, limit) {
-            const file = external_node_path_default().resolve(projectPath, 'dist', 'extension-js', browser, 'logs.ndjson');
-            let lines;
-            try {
-                lines = external_node_fs_default().readFileSync(file, 'utf-8').split('\n').filter(Boolean);
-            } catch  {
-                return [];
-            }
-            const out = [];
-            for (const line of lines){
-                let e;
-                try {
-                    e = JSON.parse(line);
-                } catch  {
-                    continue;
-                }
-                if (e && 'header' !== e.type) {
-                    if (!target.context || e.context === target.context) {
-                        if (null == target.tabId || e.tabId === target.tabId) out.push({
-                            seq: e.seq,
-                            level: e.level,
-                            context: e.context,
-                            messageParts: e.messageParts,
-                            eventType: e.eventType,
-                            code: e.code,
-                            tabId: e.tabId
-                        });
+            },
+            {
+                name: 'telemetry',
+                positionals: [
+                    {
+                        name: 'action',
+                        required: false,
+                        values: [
+                            'enable',
+                            'disable',
+                            'status'
+                        ]
                     }
-                }
+                ],
+                description: 'Manage anonymous telemetry consent (enable, disable, or show status)',
+                supportsSourceInspection: false
+            },
+            {
+                name: 'doctor',
+                positionals: [
+                    {
+                        name: 'project-path',
+                        required: false
+                    }
+                ],
+                description: 'Diagnose a dev session: ready contract, control channel, token, executor, browser',
+                supportsSourceInspection: false
             }
-            return out.slice(Math.max(0, out.length - limit));
+        ];
+        const COMMANDS = COMMAND_TABLE.map((entry)=>({
+                ...entry,
+                args: commandArgSignature(entry.positionals)
+            }));
+        const commandDescriptions = Object.fromEntries(COMMANDS.map((spec)=>[
+                spec.name,
+                spec.description
+            ]));
+        function commandHelpEntry(spec) {
+            const signature = spec.args ? ` ${messages_arg(spec.args)}` : '';
+            const lines = [
+                `- ${messages_code(`extension ${spec.name}`)}${signature}`,
+                `  ${spec.description}`
+            ];
+            if (spec.detail) lines.push(`  ${spec.detail}`);
+            for (const note of spec.notes ?? [])lines.push('', `- ${messages_code(`extension ${spec.name}`)} ${messages_arg(note.usage)}`, `  ${note.description}`);
+            return lines.join('\n');
         }
-        function codeForBridgeError(name, message) {
-            if ('Timeout' === name) return messaging.Lp.E_TIMEOUT;
-            if ('Unavailable' === name) return messaging.Lp.E_CONTROL_UNAVAILABLE;
-            if ('Forbidden' === name) return /token missing/i.test(message) ? messaging.Lp.E_TOKEN_MISSING : messaging.Lp.E_EVAL_REFUSED;
-            if ('BadRequest' === name) return messaging.Lp.E_ARGS;
-            if ('Unsupported' === name) return /needs a --tab id|no injectable frame|is not open/i.test(message) ? messaging.Lp.E_TARGET_NOT_FOUND : messaging.Lp.E_NOT_IMPLEMENTED;
-            if ('EvalError' === name) return messaging.Lp.E_EVAL;
-            if ('InspectError' === name) return messaging.Lp.E_INSPECT;
-            if ('StorageError' === name) return messaging.Lp.E_STORAGE;
-            return messaging.Lp.E_INTERNAL;
+        function availableCommandsBlock() {
+            return COMMANDS.map(commandHelpEntry).join('\n\n');
         }
-        function statusForCode(code) {
-            if (code === messaging.Lp.E_TIMEOUT) return 'timeout';
-            if (code === messaging.Lp.E_SESSION_NOT_FOUND || code === messaging.Lp.E_TARGET_NOT_FOUND) return 'not-found';
-            if (code === messaging.Lp.E_CONTROL_DENIED || code === messaging.Lp.E_EVAL_REFUSED || code === messaging.Lp.E_TOKEN_MISSING) return 'denied';
-            if (code === messaging.Lp.E_ARGS) return 'usage';
-            return 'failed';
+        function unhandledError(err) {
+            const message = err instanceof Error ? err.stack || err.message : 'string' == typeof err ? err : messaging.Sc.truncate(err);
+            return `${getLoggingPrefix('error')} ${external_pintor_default().red(String(message || 'Unknown error'))}`;
         }
-        function buildActEnvelope(command, result) {
-            const { ok, value, truncated, error, ...extras } = result;
-            const wasTruncated = true === truncated;
-            if (ok) return {
-                ...extras,
-                ...messaging.Pr.ok(command, 'ok', value ?? null, {
-                    truncated: wasTruncated
-                })
-            };
-            const raw = error || {};
-            const name = 'string' == typeof raw.name ? raw.name : 'Error';
-            const message = 'string' == typeof raw.message ? raw.message : 'command failed';
-            const code = codeForBridgeError(name, message);
+        function updateFailed(err) {
+            return `${getLoggingPrefix('warn')} Couldn't check for updates.\n${external_pintor_default().yellow('The command continues without the update check.')}\n${external_pintor_default().yellow(String(err?.message || err))}`;
+        }
+        function checkUpdates(packageJson, update) {
+            const latest = String(update.latest);
+            const releaseNotesUrl = `https://github.com/extension-js/extension.js/releases/tag/v${latest}`;
+            const suffix = external_pintor_default().gray(`(version ${latest} is available!)`);
+            const message = `${getLoggingPrefix('info')} 🧩 An ${external_pintor_default().blue('Extension.js')} update is available.\n\nYou are on version ${external_pintor_default().red(String(packageJson.version))}.\nThe latest stable is ${external_pintor_default().green(latest)}.\nSee what's new: ${external_pintor_default().underline(releaseNotesUrl)}\nUpdate to the latest stable to get fixes and new features.`;
             return {
-                ...extras,
-                ...messaging.Pr.fail(command, statusForCode(code), {
-                    ...raw,
-                    code,
-                    message,
-                    name
-                }, {
-                    truncated: wasTruncated
-                })
+                suffix,
+                message
             };
         }
-        function writeFrame(frame) {
-            try {
-                external_node_fs_default().writeSync(1, `${JSON.stringify(frame)}\n`);
-            } catch  {
-                console.log(JSON.stringify(frame));
-            }
+        function programUserHelp() {
+            return `\n${getLoggingPrefix('info')} ${external_pintor_default().underline('Help center for the Extension.js program')}
+
+Usage: extension [command] [options]
+
+Notes
+- All high-level commands offer their own \`--help\` with usage and flag lists.
+- Telemetry is anonymous and privacy-safe by default; see ${messages_code('docs/TELEMETRY.md')} for the full contract.
+
+Example
+- ${messages_code('extension create --help')} outputs information about the "create" command.
+
+Available Commands
+${availableCommandsBlock()}
+
+Common Options
+- ${messages_code('--browser')} ${messages_arg('<chrome|edge|firefox|chromium|chromium-based|gecko-based|firefox-based>')} Target browser/engine (default: chromium)
+- ${messages_code('--profile')} ${messages_arg('<path|boolean>')}        Browser profile configuration
+- ${messages_code('--polyfill')} ${messages_arg('[boolean]')}            Enable/disable cross-browser polyfill
+- ${messages_code('--no-telemetry')}                            Disable anonymous telemetry for this run (persistent toggle: ${messages_code('extension telemetry disable')}, or ${messages_code('EXTENSION_TELEMETRY=0')})
+- ${messages_code('--ai-help')}                                 Show AI-assistant oriented help and tips
+- ${messages_code('--output')} ${messages_arg('<pretty|json>')}          Result format for ${messages_code('--ai-help')} and machine-readable command results (default: pretty)
+  ${messages_code('--format')} and ${messages_code('--wait-format')} still work as deprecated aliases of ${messages_code('--output')}
+- ${messages_code('--help')}                                    Show help output
+- ${messages_code('--port')} ${messages_arg('<number>')}                 Development server port (default: 8080; use 0 for OS-assigned)
+- ${messages_code('--host')} ${messages_arg('<address>')}               Dev server host (default: 127.0.0.1; use 0.0.0.0 for Docker/devcontainers)
+- ${messages_code('--public-host')} ${messages_arg('<address>')}        Connectable host the browser dials for HMR + reload bridge when it differs from ${messages_code('--host')} (remote/devcontainer; default: the bind host, or 127.0.0.1 when bound to 0.0.0.0)
+- ${messages_code('--starting-url')} ${messages_arg('<url>')}            Initial URL to load in browser
+- ${messages_code('--silent')} ${messages_arg('[boolean]')}              Suppress console output during build
+
+Browser-Specific Options
+- ${messages_code('--chromium-binary')} ${messages_arg('<path>')}        Custom Chromium binary path
+- ${messages_code('--gecko-binary')}/${messages_code('--firefox-binary')} ${messages_arg('<path>')}           Custom Firefox/Gecko binary path
+  Use ${messages_code('flatpak:org.mozilla.firefox')} as the path to launch a Flatpak-installed Firefox
+
+Build Options
+- ${messages_code('--zip')} ${messages_arg('[boolean]')}                 Create ZIP archive of built extension
+- ${messages_code('--zip-source')} ${messages_arg('[boolean]')}          Include source files in ZIP
+- ${messages_code('--zip-filename')} ${messages_arg('<name>')}           Custom ZIP filename
+
+${external_pintor_default().underline('Centralized Logger (terminal output)')}
+- The manager extension embeds a centralized logger that streams events to the CLI.
+- Enable and filter logs directly via ${messages_code('extension dev')} flags:
+  - ${messages_code('--logs')} ${messages_arg('<off|error|warn|info|debug|trace>')}    Minimum level (default: off)
+  - ${messages_code('--log-context')} ${messages_arg('<list|all>')}                     Contexts: background,content,page,sidebar,popup,options,devtools
+  - ${messages_code('--log-format')} ${messages_arg('<pretty|json|ndjson>')}            Output format (default: pretty)
+  - ${messages_code('--no-log-timestamps')}                                   Hide ISO timestamps in pretty output
+  - ${messages_code('--no-log-color')}                                        Disable color in pretty output
+  - ${messages_code('--log-url')} ${messages_arg('<substring|/regex/>')}                Filter by event.url
+  - ${messages_code('--log-tab')} ${messages_arg('<id>')}                               Filter by tabId
+- Example: ${messages_code('extension dev ./my-ext --logs=debug --log-context=all --log-format=pretty')}
+
+${messages_code('extension --help')}
+This command outputs a help file with key command options.
+
+${external_pintor_default().underline('Path Resolution (important)')}
+- Leading ${messages_code('/')} in manifest/HTML means extension root (the directory containing ${messages_code('manifest.json')}).
+- Relative paths resolve from the ${messages_code('manifest.json')} directory.
+- Absolute OS paths are used as-is.
+
+AI Assistants
+- For AI-oriented guidance and deeper tips, run ${messages_code('extension --ai-help')}
+- For machine-readable AI guidance, run ${messages_code('extension --ai-help --output json')}
+
+ Report issues
+ - ${external_pintor_default().underline('https://github.com/cezaraugusto/extension/issues/new')}`;
         }
-        function fail(message, frame) {
-            console.error(message);
-            if (frame && 'json' === frame.output) writeFrame(messaging.Pr.fail(frame.command, statusForCode(frame.code), {
-                code: frame.code,
-                message,
-                name: 'CliError'
-            }));
-            process.exit(1);
+        function unsupportedBrowserFlag(value, supported) {
+            return `${getLoggingPrefix('error')} Unsupported --browser value: ${value}.\n${external_pintor_default().red('Choose one of:')} ${supported.join(', ')}${external_pintor_default().red('.')}`;
         }
-        function printResult(result, output, command) {
-            if ('json' === output) return void console.log(JSON.stringify(buildActEnvelope(command, result)));
-            if (result.ok) {
-                const value = result.value;
-                console.log('string' == typeof value ? value : JSON.stringify(value, null, 2));
-                if (result.truncated) console.error('… result truncated (byte cap)');
-                return;
-            }
-            const err = result.error || {
-                name: 'Error',
-                message: 'command failed'
-            };
-            console.error(`${err.name}: ${err.message}${err.engine ? ` (engine: ${err.engine})` : ''}`);
+        function safariOnlyOption(flags) {
+            return `${getLoggingPrefix('error')} ${flags.map(messages_code).join(', ')} only appl${1 === flags.length ? 'ies' : 'y'} to Safari targets.\nAdd ${messages_code('--browser safari')} (or ${messages_code('webkit-based')}).`;
         }
-        async function runCommand(input) {
-            const projectPath = external_node_path_default().resolve(input.projectPathArg || process.cwd());
-            const browser = input.opts.browser || 'chromium';
-            const { BridgeController, readReadyContract, readControlToken } = await loadExtensionDevelopBridgeModule();
-            const outputFrame = {
-                command: input.command,
-                output: input.opts.output
-            };
-            const ready = readReadyContract(projectPath, browser);
-            if (!ready) fail(`No active control channel found for ${browser}. Run \`extension dev --browser=${browser} --allow-control\` first.`, {
-                ...outputFrame,
-                code: messaging.Lp.E_SESSION_NOT_FOUND
-            });
-            const token = input.needsToken ? readControlToken(projectPath, browser) : void 0;
-            const controller = new BridgeController({
-                controlPort: ready.controlPort,
-                instanceId: ready.instanceId,
-                token: token ?? void 0
-            });
-            try {
-                await controller.connect();
-            } catch (err) {
-                controller.close();
-                const message = err?.message || 'could not connect to the control channel';
-                fail(message, {
-                    ...outputFrame,
-                    code: /code 40\d\d/.test(message) ? messaging.Lp.E_CONTROL_DENIED : messaging.Lp.E_CONTROL_UNAVAILABLE
-                });
-            }
-            const timeoutMs = input.opts.timeout ? Number(input.opts.timeout) : 5000;
-            let result;
-            try {
-                result = await controller.command({
-                    op: input.op,
-                    target: input.target,
-                    args: input.args,
-                    timeoutMs
-                });
-            } catch (err) {
-                controller.close();
-                const message = err?.message || 'command failed';
-                fail(message, {
-                    ...outputFrame,
-                    code: /timed out/i.test(message) ? messaging.Lp.E_TIMEOUT : messaging.Lp.E_CONTROL_UNAVAILABLE
-                });
-            } finally{
-                controller.close();
-            }
-            if (result?.ok && input.augment) try {
-                Object.assign(result, input.augment(projectPath, browser, result));
-            } catch  {}
-            printResult(result, input.opts.output, input.command);
-            await exitAfterDrain(result.ok ? 0 : 1);
+        function safariInvalidBundleId(bundleId) {
+            return `${getLoggingPrefix('error')} Invalid bundle identifier: ${messages_code(bundleId)}.\nUse reverse-DNS form: dot-separated segments of letters, digits and hyphens, each starting with a letter (e.g. ${messages_code('com.example.my-extension')}).`;
         }
-        function targetFrom(opts, fallback = 'background') {
-            const context = opts.context || fallback;
-            const target = {
-                context
-            };
-            if (opts.url) target.url = opts.url;
-            if (null != opts.tab && '' !== opts.tab) target.tabId = Number(opts.tab);
-            return target;
+        function safariCommandNotSupported(command) {
+            return `${getLoggingPrefix('error')} ${messages_code(command)} can't load an extension into Safari automatically.\nSafari extensions ship inside a signed app and are enabled by hand, so there's no live browser session to load into, unlike Chromium and Firefox.\nBuild the Safari app instead: ${messages_code('extension build --browser safari')}\nThen open the generated app and enable it in Safari → Settings → Extensions.`;
+        }
+        function programAIHelp() {
+            return `\n${getLoggingPrefix('info')} ${external_pintor_default().gray('Development tips for extension developers and AI assistants')}
+
+Browser-Specific Configuration
+- Use browser prefixes in manifest.json for browser-specific fields:
+  ${messages_code('{"firefox:manifest": 2, "chrome:manifest": 3}')}
+  This applies manifest v2 to Firefox only, v3 to Chrome/Edge.
+
+Centralized Logger (for AI & CI)
+- Logs from all contexts are centralized by the manager extension and streamed to the CLI.
+- Prefer these flags to control terminal logs during ${messages_code('extension dev')}:
+  - ${messages_code('--logs')} ${messages_arg('<off|error|warn|info|debug|trace>')}    Minimum level
+  - ${messages_code('--log-context')} ${messages_arg('<list|all>')}                     Contexts to include
+  - ${messages_code('--log-format')} ${messages_arg('<pretty|json|ndjson>')}            Pretty for humans; JSON for machines/NDJSON pipelines
+  - ${messages_code('--no-log-timestamps')} ${messages_arg(' ')}                        Disable timestamps (pretty)
+  - ${messages_code('--no-log-color')} ${messages_arg(' ')}                             Disable ANSI colors (pretty)
+  - ${messages_code('--log-url')} ${messages_arg('<substring|/regex/>')}                Filter by URL
+  - ${messages_code('--log-tab')} ${messages_arg('<id>')}                               Filter by tabId
+- Good CI pattern: ${messages_code('EXTENSION_DEBUG=1 EXTENSION_AUTO_EXIT_MS=6000 extension dev ./ext --logs=info --log-format=json')}
+
+Special Folders for Entrypoints
+- Use special folders to handle entrypoints and assets not declared in manifest.json:
+- ${external_pintor_default().underline(messages_code('public/'))}  - Static assets automatically copied to build (resolves to output root)
+- ${external_pintor_default().underline(messages_code('pages/'))}   - HTML files not declared in manifest (e.g., welcome pages)
+- ${external_pintor_default().underline(messages_code("scripts/"))} - JavaScript files not declared in manifest (e.g., executable scripts)
+
+Predictable Output Paths
+- Core HTML destinations are standardized across browsers so you can reference them safely in code/tests:
+  - ${messages_code('devtools_page')} → ${messages_code('devtools/index.html')}
+  - ${messages_code('sidebar_action.default_panel')} (MV2) and ${messages_code('side_panel.default_path')} (MV3) → ${messages_code('sidebar/index.html')}
+  - ${messages_code('options_ui.page')} and ${messages_code('options_page')} → ${messages_code('options/index.html')}
+  - ${messages_code('background.page')} → ${messages_code('background/index.html')}
+  - ${messages_code('action.default_popup')}, ${messages_code('browser_action.default_popup')}, ${messages_code('page_action.default_popup')} → ${messages_code('action/index.html')}
+- Other predictable outputs:
+  - ${messages_code('chrome_url_overrides.*')} → ${messages_code('chrome_url_overrides/<key>.html')}
+  - ${messages_code("content_scripts[n].js/css")} → ${messages_code("content_scripts/content-<n>.{js,css}")}
+  - ${messages_code('sandbox.pages[]')} → ${messages_code('sandbox/page-<n>.html')}
+  - ${messages_code("user_scripts.api_script")} → ${messages_code("user_scripts/api_script.js")}
+  - ${messages_code('icons/*')} → ${messages_code('icons/')} (feature-specific icon folders preserved where applicable)
+
+Public & Special Folders (Output Behavior)
+- ${external_pintor_default().underline(messages_code('public/'))} is the web root in output. Authors can use ${messages_code('/foo')}, ${messages_code('/public/foo')}, ${messages_code('public/foo')}, or ${messages_code('./public/foo')} and they all emit as ${messages_code('dist/<browser>/foo')}.
+- ${external_pintor_default().underline(messages_code('pages/'))} files emit as ${messages_code('pages/<name>.html')}. Relative assets referenced inside page HTML are emitted under ${messages_code('assets/')} preserving relative structure; public-root URLs are preserved.
+- ${external_pintor_default().underline(messages_code("scripts/"))} files emit as ${messages_code("scripts/<name>.js")} with extracted CSS when applicable.
+
+Shadow DOM for Content Scripts
+- Add ${messages_code('use shadow-dom')} directive to content scripts for style isolation
+- Automatically creates ${messages_code('#extension-root')} element with shadow DOM
+- All CSS imports are automatically injected into shadow DOM
+- Prevents style conflicts with host page
+
+Environment Variables
+- Use ${messages_code(messages_arg('EXTENSION_PUBLIC_*'))} prefix for variables accessible in extension code
+- Supported in both ${messages_code('process.env')} and ${messages_code('import.meta.env')}
+- Environment file priority: ${external_pintor_default().underline(messages_code(messages_arg('.env.{browser}.{mode}')))} > ${external_pintor_default().underline(messages_code(messages_arg('.env.{browser}')))} > ${external_pintor_default().underline(messages_code(messages_arg('.env.{mode}')))} > ${external_pintor_default().underline(messages_code(messages_arg('.env')))}
+- Example: ${messages_code(messages_arg('EXTENSION_PUBLIC_API_KEY=your_key'))}
+
+Available Templates
+- ${external_pintor_default().green('Frameworks')}: ${messages_code(messages_arg('react'))}, ${messages_code(messages_arg('preact'))}, ${messages_code(messages_arg('vue'))}, ${messages_code(messages_arg('svelte'))}
+- ${external_pintor_default().green('Languages')}: ${messages_code(messages_arg("javascript"))}, ${messages_code(messages_arg("typescript"))}
+- ${external_pintor_default().green('Contexts')}: ${messages_code(messages_arg('content'))} (content scripts), ${messages_code(messages_arg('new'))} (new tab), ${messages_code(messages_arg('action'))} (popup)
+- ${external_pintor_default().green('Styling')}: ${messages_code(messages_arg('tailwind'))}, ${messages_code(messages_arg('sass'))}, ${messages_code(messages_arg('less'))}
+- ${external_pintor_default().green('Configs')}: ${messages_code(messages_arg('eslint'))}, ${messages_code(messages_arg('prettier'))}, ${messages_code(messages_arg('stylelint'))}
+
+Webpack/Rspack Configuration
+- Create ${external_pintor_default().underline(messages_code(messages_arg('extension.config.js')))} for custom webpack configuration
+- Function receives base config, return modified config
+- Supports all webpack/rspack loaders and plugins
+- Example:
+  ${messages_code('export default {')}
+  ${messages_code('  config: (config) => {')}
+  ${messages_code("    config.module.rules.push({ test: /\\.svg$/, use: ['@svgr/webpack'] })")}
+  ${messages_code('    return config')}
+  ${messages_code('  }')}
+  ${messages_code('}')}
+
+Managed Dependencies (Important)
+- ${external_pintor_default().green('Do not add')} packages that ${external_pintor_default().blue('Extension.js')} already ships in its own toolchain.
+- The guard only triggers when a managed package is declared in your ${messages_code('package.json')} ${external_pintor_default().gray('and')} is imported (as a module specifier) in your ${external_pintor_default().underline(messages_code('extension.config.js'))}.
+- In that case, the program will ${external_pintor_default().red('print an error and abort')} to avoid version conflicts.
+- Remove the duplicate from your project ${messages_code('package.json')} or avoid referencing it in ${external_pintor_default().underline(messages_code('extension.config.js'))} and rely on the built-in version instead.
+- If you truly need a different version, open an issue so we can evaluate a safe upgrade.
+
+Framework-Specific Configuration
+- Create ${external_pintor_default().underline(messages_code(messages_arg('vue.loader.js')))} for Vue-specific loader configuration
+- Create ${external_pintor_default().underline(messages_code(messages_arg('svelte.loader.js')))} for Svelte-specific loader configuration
+- Automatically detected and used by Extension.js
+- Example svelte.loader.js:
+  ${messages_code('module.exports = {')}
+  ${messages_code('  preprocess: require("svelte-preprocess")({')}
+  ${messages_code("    typescript: true")}
+  ${messages_code('  })')}
+  ${messages_code('}')}
+
+Hot Module Replacement (HMR)
+- Automatically enabled in development mode
+- CSS changes trigger automatic style updates
+- React components fast-refresh; Svelte components hot-update
+- Preact and Vue rebuild with a live reload (component state resets)
+- Content scripts automatically re-inject on changes
+- Service workers, _locales and manifest changes reload the extension
+
+Non-Destructive Testing in CI
+- Prefer ${messages_code('EXTENSION_DEBUG=1')} to copy local templates and avoid network.
+- Reuse Playwright's Chromium via ${messages_code('--chromium-binary')} path when available.
+- Set ${messages_code(messages_arg('EXTENSION_AUTO_EXIT_MS'))} and ${messages_code(messages_arg('EXTENSION_FORCE_KILL_MS'))} for non-interactive dev sessions.
+
+File Watching & HMR Examples
+- Content script JS/TS changes trigger reinjection; CSS changes update styles live.
+- For watch-source HTML prints, update a visible string in ${messages_code("content/scripts.*")} and assert it appears in stdout.
+
+Troubleshooting
+- Use ${messages_code('--silent true')} during builds to reduce noise; logs still surface errors.
+- When ports conflict, pass ${messages_code('--port 0')} to auto-select an available port.
+- In Docker/devcontainers, pass ${messages_code('--host 0.0.0.0')} so the dev server is reachable from the host.
+
+Non-Interactive / Auto Mode (CI)
+- Set ${messages_code(messages_arg('EXTENSION_AUTO_EXIT_MS'))} to enable self-termination after N milliseconds.
+  Useful when ${messages_code('pnpm extension dev')} would otherwise hang under Rspack watch.
+  Example: ${messages_code(messages_arg('EXTENSION_AUTO_EXIT_MS=6000'))} pnpm extension dev ./templates/react --browser chrome --starting-url ${messages_arg('https://example.com')}
+- Optional: ${messages_code(messages_arg('EXTENSION_FORCE_KILL_MS'))} to hard-exit after N ms as a fallback (defaults to auto-exit + 4000).
+
+Docker / Devcontainers / Codespaces
+- Use ${messages_code('--host 0.0.0.0')} to bind the dev server on all interfaces so HMR is reachable from the host.
+- Use ${messages_code('--no-browser')} inside the container and load the extension manually from ${messages_code('dist/<browser>/')} in your host browser.
+- Chromium sandbox flags (${messages_code('--no-sandbox')}) are added automatically when Docker, Podman, devcontainers, or Codespaces are detected.
+- File watching uses polling by default (1 s interval), which works across bind-mounted volumes.
+- Example: ${messages_code('extension dev ./my-ext --host 0.0.0.0 --no-browser --port 8080')}
+
+Flatpak Firefox
+- Use ${messages_code('--gecko-binary flatpak:org.mozilla.firefox')} (or ${messages_code('--firefox-binary')}) to launch a Flatpak-installed Firefox.
+- Extension.js rewrites the binary path to ${messages_code('flatpak run')} with the correct filesystem grants automatically.
+
+Cross-Browser Compatibility
+- Use ${messages_code('--polyfill')} flag to enable webextension-polyfill
+- Automatically handles browser API differences
+- Supports Chrome, Edge, Firefox with single codebase`;
         }
-        const commonOptions = (cmd)=>cmd.option('--browser <chrome | chromium | edge | firefox>', '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({
-                    projectPathArg,
-                    command: 'eval',
-                    op: 'eval',
-                    target: targetFrom(opts),
-                    args: {
-                        expression
+        function programAIHelpJSON(version) {
+            return {
+                version,
+                commands: COMMANDS.map((spec)=>({
+                        name: spec.name,
+                        summary: spec.description,
+                        supportsSourceInspection: spec.supportsSourceInspection
+                    })),
+                globalOptions: [
+                    {
+                        name: '--ai-help',
+                        description: 'Show AI-assistant oriented help and tips'
                     },
-                    needsToken: true,
-                    opts
-                });
-            });
-            commonOptions(program.command('storage').arguments('<action> [project-path]').description(commandDescriptions.storage).option('--area <local|sync|session|managed>', 'storage area (default local)').option('--key <key>', 'key to get or set').option('--value <json>', 'JSON value to set (with set)').option('--context <background|popup|options|sidebar|content>', 'target context (default background)')).action(async (action, projectPathArg, opts)=>{
-                const area = opts.area || 'local';
-                if ('get' === action) return void await runCommand({
-                    projectPathArg,
-                    command: 'storage',
-                    op: 'storage.get',
-                    target: targetFrom(opts),
-                    args: opts.key ? {
-                        area,
-                        key: opts.key
-                    } : {
-                        area
+                    {
+                        name: '--output',
+                        values: [
+                            'pretty',
+                            'json'
+                        ],
+                        default: 'pretty',
+                        description: 'Result format for --ai-help (--format is a deprecated alias)'
                     },
-                    opts
-                });
-                if ('set' === action) {
-                    if (!opts.key || null == opts.value) fail('storage set requires --key and --value', {
-                        command: 'storage',
-                        code: messaging.Lp.E_ARGS,
-                        output: opts.output
-                    });
-                    let parsed;
-                    try {
-                        parsed = JSON.parse(opts.value);
-                    } catch  {
-                        parsed = opts.value;
+                    {
+                        name: '--no-telemetry',
+                        description: 'Disable anonymous telemetry for this run. Persistent toggle: `extension telemetry disable`. Hard override: `EXTENSION_TELEMETRY=0`.'
+                    },
+                    {
+                        name: '--browser',
+                        values: [
+                            'chrome',
+                            'edge',
+                            'firefox',
+                            'chromium',
+                            'chromium-based',
+                            'gecko-based',
+                            'firefox-based'
+                        ],
+                        default: 'chromium',
+                        description: 'Target browser/engine'
+                    },
+                    {
+                        name: '--port',
+                        default: '8080',
+                        description: 'Development server port (use 0 for OS-assigned available port)'
+                    },
+                    {
+                        name: '--host',
+                        default: '127.0.0.1',
+                        description: 'Dev server host address (use 0.0.0.0 for Docker/devcontainers)'
+                    },
+                    {
+                        name: '--public-host',
+                        default: 'bind host (127.0.0.1 when bound to 0.0.0.0)',
+                        description: 'Connectable host the browser dials for HMR + the reload bridge when it differs from the bind host (remote/devcontainer)'
                     }
-                    await runCommand({
-                        projectPathArg,
-                        command: 'storage',
-                        op: 'storage.set',
-                        target: targetFrom(opts),
-                        args: {
-                            area,
-                            items: {
-                                [opts.key]: parsed
-                            }
-                        },
-                        opts
-                    });
-                    return;
-                }
-                fail(`unknown storage action: ${action} (use get or set)`, {
-                    command: 'storage',
-                    code: messaging.Lp.E_ARGS,
-                    output: opts.output
-                });
-            });
-            commonOptions(program.command('reload').arguments('[project-path]').description(commandDescriptions.reload).option('--context <background|content|page>', 'target context (default background)').option('--tab <id>', 'for content/page: a specific tab')).action(async (projectPathArg, opts)=>{
-                await runCommand({
-                    projectPathArg,
-                    command: 'reload',
-                    op: 'reload',
-                    target: targetFrom(opts),
-                    opts
-                });
-            });
-            commonOptions(program.command('inspect').arguments('[project-path]').description(commandDescriptions.inspect).option('--context <content|page|popup|options|sidebar|devtools|newtab|history|bookmarks>', 'what to inspect: content/page or an open surface, including url-override pages (default content)').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)').option('--list-tabs', 'list open tabs as {tabId,url,title} and exit').option('--include <list>', 'comma-separated: html,summary (default summary)').option('--max-bytes <n>', 'cap on returned HTML bytes (default 262144)').option('--with-console [n]', 'also include the last n console lines for the target (default 20)')).action(async (projectPathArg, opts)=>{
-                if (opts.listTabs) return void await runCommand({
-                    projectPathArg,
-                    command: 'inspect',
-                    op: 'tabs.query',
-                    target: {
-                        context: 'background'
+                ],
+                capabilities: {
+                    logger: {
+                        levels: [
+                            'off',
+                            'error',
+                            'warn',
+                            'info',
+                            'debug',
+                            'trace',
+                            'all'
+                        ],
+                        formats: [
+                            'pretty',
+                            'json',
+                            'ndjson'
+                        ],
+                        notes: [
+                            'centralized logger streams logs from multiple extension contexts',
+                            '--logs defaults to off unless explicitly enabled'
+                        ]
                     },
-                    args: {},
-                    opts
-                });
-                const include = opts.include ? opts.include.split(',').map((s)=>s.trim()).filter(Boolean) : [
-                    'summary'
-                ];
-                const target = targetFrom(opts, 'content');
-                await runCommand({
-                    projectPathArg,
-                    command: 'inspect',
-                    op: 'inspect',
-                    target,
-                    args: {
-                        include,
-                        maxBytes: opts.maxBytes ? Number(opts.maxBytes) : void 0
+                    managedDependencies: {
+                        enforcement: 'guarded',
+                        trigger: 'when managed packages are declared in package.json and imported as a module specifier in extension.config',
+                        action: 'print an error and abort'
                     },
-                    opts,
-                    augment: opts.withConsole ? (projectPath, browser)=>{
-                        const n = 'string' == typeof opts.withConsole && '' !== opts.withConsole ? Number(opts.withConsole) : 20;
-                        return {
-                            console: readRecentConsole(projectPath, browser, target, Number.isFinite(n) && n > 0 ? n : 20)
-                        };
-                    } : void 0
-                });
-            });
-            commonOptions(program.command('open').arguments('<surface> [project-path]').description('Open an extension surface: popup, options, sidebar, action, or command (requires --allow-control)').option('--name <command>', 'with `open command`: the chrome.commands name to trigger')).action(async (surface, projectPathArg, opts)=>{
-                const allowed = [
-                    'popup',
-                    'options',
-                    'sidebar',
-                    'action',
-                    'command'
-                ];
-                if (!allowed.includes(surface)) fail(`unknown surface: ${surface} (use popup, options, sidebar, action, or command)`, {
-                    command: 'open',
-                    code: messaging.Lp.E_ARGS,
-                    output: opts.output
-                });
-                const inBackground = 'action' === surface || 'command' === surface;
-                const context = inBackground ? 'background' : surface;
-                const args = {
-                    surface
-                };
-                if ('command' === surface && opts.name) args.name = opts.name;
-                await runCommand({
-                    projectPathArg,
-                    command: 'open',
-                    op: 'open',
-                    target: {
-                        context
+                    readyContract: {
+                        readyPath: 'dist/extension-js/<browser>/ready.json',
+                        eventsPath: 'dist/extension-js/<browser>/events.ndjson',
+                        waitFlag: '--wait blocks until ready.json reports ready (or error) then exits; pair with --output json for machine output (--wait-format is a deprecated alias)',
+                        statuses: [
+                            'starting',
+                            'ready',
+                            'error'
+                        ],
+                        readyFields: [
+                            'status',
+                            'command',
+                            'browser',
+                            'runId',
+                            'startedAt',
+                            'distPath',
+                            'manifestPath',
+                            'port',
+                            'pid',
+                            'ts',
+                            'compiledAt',
+                            'errors'
+                        ],
+                        eventTypes: [
+                            'compile_start',
+                            'compile_success',
+                            'compile_error',
+                            'shutdown'
+                        ],
+                        notes: [
+                            'ready.json is written atomically by the build (dev/start) on each compile',
+                            'events.ndjson is an append-only build timeline with durationMs and errorCount per entry',
+                            '--wait requires a local project path (remote URLs are not supported)',
+                            'consumers should verify pid liveness and recency before trusting a contract'
+                        ]
                     },
-                    args,
-                    opts
-                });
-            });
-        }
-        var external_node_child_process_ = __webpack_require__("node:child_process");
-        var messages = __webpack_require__("./browsers/browsers-lib/messages.ts");
-        function logSafariDryRun(converterCmd, xcodebuildCmd) {
-            if ((0, messaging._o)()) console.log(messages.KP());
-            console.log(messages.yc());
-            console.log(messages.fL(converterCmd));
-            console.log(messages.Aj(xcodebuildCmd));
-        }
-        function sanitizeAppName(value) {
-            const cleaned = String(value || '').replace(/[\\/:*?"<>|]+/g, ' ').replace(/\s+/g, ' ').trim();
-            return cleaned.length > 0 ? cleaned : 'Extension';
-        }
-        function bundleSegment(appName) {
-            return String(appName || '').replace(/[^A-Za-z0-9]+/g, '-').replace(/^-+|-+$/g, '') || 'extension';
-        }
-        function deriveBundleId(appName) {
-            return `dev.extensionjs.${bundleSegment(appName)}`;
-        }
-        function isValidBundleId(value) {
-            return /^[A-Za-z][A-Za-z0-9-]*(\.[A-Za-z][A-Za-z0-9-]*)+$/.test(value);
-        }
-        function readManifest(extensionDir) {
-            try {
-                const manifestPath = external_node_path_.join(extensionDir, 'manifest.json');
-                if (external_node_fs_.existsSync(manifestPath)) return JSON.parse(external_node_fs_.readFileSync(manifestPath, 'utf8')) || {};
-            } catch  {}
-            return {};
-        }
-        function resolveSafariBuildConfig(compilation, host) {
-            const extensionDir = String(compilation?.options?.output?.path || '');
-            const manifest = readManifest(extensionDir);
-            const appName = sanitizeAppName(String(host.appName || manifest?.name || 'Extension'));
-            const userBundleId = String(host.bundleId || '').trim();
-            const bundleIdDerived = !userBundleId;
-            const bundleIdentifier = bundleIdDerived ? deriveBundleId(appName) : userBundleId;
-            const projectLocation = `${extensionDir.replace(/[\\/]+$/, '')}-xcode`;
-            return {
-                extensionDir,
-                projectLocation,
-                appName,
-                bundleIdentifier,
-                bundleIdDerived,
-                macOsOnly: false !== host.macOsOnly,
-                language: 'swift',
-                open: !host.noOpen,
-                safariBinary: host.safariBinary
-            };
-        }
-        function composeConverterArgs(config) {
-            const args = [
-                'safari-web-extension-converter',
-                config.extensionDir,
-                '--project-location',
-                config.projectLocation,
-                '--app-name',
-                config.appName,
-                '--bundle-identifier',
-                config.bundleIdentifier,
-                '--no-prompt',
-                '--no-open',
-                '--force',
-                'objc' === config.language ? '--objc' : '--swift'
-            ];
-            if (config.macOsOnly) args.push('--macos-only');
-            return args;
-        }
-        function macOsSchemeName(config) {
-            return config.macOsOnly ? config.appName : `${config.appName} (macOS)`;
-        }
-        function xcodeProjectPath(config) {
-            return external_node_path_.join(config.projectLocation, config.appName, `${config.appName}.xcodeproj`);
-        }
-        function derivedDataPath(config) {
-            return external_node_path_.join(config.projectLocation, '.derived');
-        }
-        function builtAppPath(config) {
-            return external_node_path_.join(derivedDataPath(config), 'Build', 'Products', 'Release', `${config.appName}.app`);
-        }
-        function composeXcodebuildArgs(config) {
-            return [
-                '-project',
-                xcodeProjectPath(config),
-                '-scheme',
-                macOsSchemeName(config),
-                '-configuration',
-                'Release',
-                '-derivedDataPath',
-                derivedDataPath(config),
-                'CODE_SIGN_IDENTITY=-',
-                'CODE_SIGNING_REQUIRED=NO',
-                'CODE_SIGNING_ALLOWED=YES',
-                'build'
-            ];
-        }
-        function manifestFingerprintPath(config) {
-            return external_node_path_.join(config.projectLocation, '.manifest-fingerprint');
-        }
-        function stableStringify(obj) {
-            if (null == obj) return JSON.stringify(obj);
-            if ('object' != typeof obj) return JSON.stringify(obj);
-            if (Array.isArray(obj)) return `[${obj.map(stableStringify).join(',')}]`;
-            const keys = Object.keys(obj).sort();
-            return `{${keys.map((k)=>`${JSON.stringify(k)}:${stableStringify(obj[k])}`).join(',')}}`;
-        }
-        function readManifestRaw(extensionDir) {
-            try {
-                return external_node_fs_.readFileSync(external_node_path_.join(extensionDir, 'manifest.json'), 'utf8');
-            } catch  {
-                return '';
-            }
-        }
-        function normalizeManifest(raw) {
-            try {
-                return stableStringify(JSON.parse(raw));
-            } catch  {
-                return raw;
-            }
-        }
-        function composeProjectFingerprint(config) {
-            return JSON.stringify({
-                v: 2,
-                identity: {
-                    appName: config.appName,
-                    bundleId: config.bundleIdentifier,
-                    macOsOnly: config.macOsOnly
+                    dockerAndContainers: {
+                        hostFlag: '--host 0.0.0.0 binds the dev server to all interfaces',
+                        sandboxDetection: [
+                            '/.dockerenv',
+                            '/run/.containerenv',
+                            'REMOTE_CONTAINERS=true',
+                            'CODESPACES=true',
+                            'container env var'
+                        ],
+                        notes: [
+                            'Use --no-browser inside the container and load dist/<browser>/ in the host browser',
+                            'File watching uses polling (1s interval) for bind-mount compatibility',
+                            '--no-sandbox is added automatically when a container environment is detected'
+                        ]
+                    }
                 },
-                manifest: normalizeManifest(readManifestRaw(config.extensionDir))
-            });
-        }
-        function saveManifestFingerprint(config) {
-            external_node_fs_.mkdirSync(external_node_path_.dirname(manifestFingerprintPath(config)), {
-                recursive: true
-            });
-            external_node_fs_.writeFileSync(manifestFingerprintPath(config), composeProjectFingerprint(config), 'utf8');
+                examples: [
+                    'extension --ai-help',
+                    'extension --ai-help --output json',
+                    'extension dev ./my-ext --logs=info --log-format=json',
+                    'extension dev ./my-ext --host 0.0.0.0 --no-browser',
+                    'extension dev ./my-ext --wait --browser=chromium --output json',
+                    'extension start ./my-ext --wait --browser=chromium --output json',
+                    'extension dev ./my-ext --gecko-binary flatpak:org.mozilla.firefox',
+                    'extension install chromium',
+                    'extension install --where',
+                    'extension uninstall --where',
+                    'extension uninstall --all'
+                ]
+            };
         }
-        function isProjectStale(config) {
-            const fpPath = manifestFingerprintPath(config);
-            if (!external_node_fs_.existsSync(fpPath)) return true;
-            const stored = external_node_fs_.readFileSync(fpPath, 'utf8');
-            return stored !== composeProjectFingerprint(config);
+        function invalidAIHelpFormat(value) {
+            return `${getLoggingPrefix('error')} Invalid value for ${messages_code('--output')}: ${external_pintor_default().red(String(value))}.\n${external_pintor_default().red('Pass')} ${messages_arg('pretty')} ${external_pintor_default().red('or')} ${messages_arg('json')}${external_pintor_default().red(', for example')} ${messages_code('extension --ai-help --output json')}${external_pintor_default().red('.')}`;
         }
-        function alignBundleIdentifiers(pbxprojContent, bundleId) {
-            return pbxprojContent.replace(/PRODUCT_BUNDLE_IDENTIFIER = ("?)([^;"]+)\1;/g, (_match, _quote, value)=>/\.Extension$/.test(String(value)) ? `PRODUCT_BUNDLE_IDENTIFIER = "${bundleId}.Extension";` : `PRODUCT_BUNDLE_IDENTIFIER = "${bundleId}";`);
+        function removedNoRunnerFlag() {
+            return `${getLoggingPrefix('error')} ${messages_code('--no-runner')} was removed.\nUse ${messages_code('--no-browser')} instead.`;
         }
-        const PRESERVED_SETTINGS = [
-            'DEVELOPMENT_TEAM',
-            'CODE_SIGN_STYLE',
-            'PROVISIONING_PROFILE_SPECIFIER'
-        ];
-        function pbxprojPath(config) {
-            return external_node_path_.join(xcodeProjectPath(config), 'project.pbxproj');
+        function deprecatedOutputAlias(flag) {
+            return `${getLoggingPrefix('warn')} ${messages_code(flag)} is deprecated and maps to ${messages_code('--output')}.\nPass ${messages_code('--output')} ${messages_arg('<pretty|json>')} instead.`;
         }
-        function extractXcodeUserSettings(pbxprojContent) {
-            const found = {};
-            for (const key of PRESERVED_SETTINGS){
-                const m = new RegExp(`\\b${key}\\s*=\\s*([^;]+);`).exec(pbxprojContent);
-                if (m) {
-                    const val = m[1].trim();
-                    if (val && '""' !== val && "''" !== val) found[key] = val;
+        function noBrowserNotSupportedForCommand(command) {
+            return `${getLoggingPrefix('error')} ${messages_code('--no-browser')} is only supported for ${messages_code('dev')}, ${messages_code('start')}, and ${messages_code('preview')}.\nReceived command: ${messages_code(command || '(none)')}`;
+        }
+        function readRecentConsole(projectPath, browser, target, limit) {
+            const file = external_node_path_default().resolve(projectPath, 'dist', 'extension-js', browser, 'logs.ndjson');
+            let lines;
+            try {
+                lines = external_node_fs_default().readFileSync(file, 'utf-8').split('\n').filter(Boolean);
+            } catch  {
+                return [];
+            }
+            const out = [];
+            for (const line of lines){
+                let e;
+                try {
+                    e = JSON.parse(line);
+                } catch  {
+                    continue;
+                }
+                if (e && 'header' !== e.type) {
+                    if (!target.context || e.context === target.context) {
+                        if (null == target.tabId || e.tabId === target.tabId) out.push({
+                            seq: e.seq,
+                            level: e.level,
+                            context: e.context,
+                            messageParts: e.messageParts,
+                            eventType: e.eventType,
+                            code: e.code,
+                            tabId: e.tabId
+                        });
+                    }
                 }
             }
-            return found;
+            return out.slice(Math.max(0, out.length - limit));
         }
-        function applyXcodeUserSettings(pbxprojContent, settings) {
-            let result = pbxprojContent;
-            for (const [key, value] of Object.entries(settings)){
-                const existing = new RegExp(`\\b${key}\\s*=\\s*[^;]+;`, 'g');
-                result = existing.test(result) ? result.replace(existing, `${key} = ${value};`) : result.replace(/buildSettings\s*=\s*\{/g, `buildSettings = {\n\t\t\t\t${key} = ${value};`);
-            }
-            return result;
+        function codeForBridgeError(name, message) {
+            if ('Timeout' === name) return messaging.Lp.E_TIMEOUT;
+            if ('Unavailable' === name) return messaging.Lp.E_CONTROL_UNAVAILABLE;
+            if ('Forbidden' === name) return /token missing/i.test(message) ? messaging.Lp.E_TOKEN_MISSING : messaging.Lp.E_EVAL_REFUSED;
+            if ('BadRequest' === name) return messaging.Lp.E_ARGS;
+            if ('Unsupported' === name) return /needs a --tab id|no injectable frame|is not open/i.test(message) ? messaging.Lp.E_TARGET_NOT_FOUND : messaging.Lp.E_NOT_IMPLEMENTED;
+            if ('EvalError' === name) return messaging.Lp.E_EVAL;
+            if ('InspectError' === name) return messaging.Lp.E_INSPECT;
+            if ('StorageError' === name) return messaging.Lp.E_STORAGE;
+            return messaging.Lp.E_INTERNAL;
         }
-        function backupAndRestoreXcodeSettings(config) {
-            const projFile = pbxprojPath(config);
-            let saved = {};
-            if (external_node_fs_.existsSync(projFile)) saved = extractXcodeUserSettings(external_node_fs_.readFileSync(projFile, 'utf8'));
+        function statusForCode(code) {
+            if (code === messaging.Lp.E_TIMEOUT) return 'timeout';
+            if (code === messaging.Lp.E_SESSION_NOT_FOUND || code === messaging.Lp.E_TARGET_NOT_FOUND) return 'not-found';
+            if (code === messaging.Lp.E_CONTROL_DENIED || code === messaging.Lp.E_EVAL_REFUSED || code === messaging.Lp.E_TOKEN_MISSING) return 'denied';
+            if (code === messaging.Lp.E_ARGS) return 'usage';
+            return 'failed';
+        }
+        function buildActEnvelope(command, result) {
+            const { ok, value, truncated, error, ...extras } = result;
+            const wasTruncated = true === truncated;
+            if (ok) return {
+                ...extras,
+                ...messaging.Pr.ok(command, 'ok', value ?? null, {
+                    truncated: wasTruncated
+                })
+            };
+            const raw = error || {};
+            const name = 'string' == typeof raw.name ? raw.name : 'Error';
+            const message = 'string' == typeof raw.message ? raw.message : 'command failed';
+            const code = codeForBridgeError(name, message);
             return {
-                saved,
-                restore () {
-                    if (0 === Object.keys(saved).length) return;
-                    if (!external_node_fs_.existsSync(projFile)) return;
-                    const content = external_node_fs_.readFileSync(projFile, 'utf8');
-                    external_node_fs_.writeFileSync(projFile, applyXcodeUserSettings(content, saved), 'utf8');
-                }
+                ...extras,
+                ...messaging.Pr.fail(command, statusForCode(code), {
+                    ...raw,
+                    code,
+                    message,
+                    name
+                }, {
+                    truncated: wasTruncated
+                })
             };
         }
-        function isMacOS() {
-            return 'darwin' === process.platform;
-        }
-        function activeDeveloperDir() {
+        function writeFrame(frame) {
             try {
-                const result = (0, external_node_child_process_.spawnSync)('xcode-select', [
-                    '-p'
-                ], {
-                    encoding: 'utf8',
-                    timeout: 15000
-                });
-                if (0 !== result.status) return null;
-                const resolved = String(result.stdout || '').trim();
-                return resolved.length > 0 ? resolved : null;
+                external_node_fs_default().writeSync(1, `${JSON.stringify(frame)}\n`);
             } catch  {
-                return null;
+                console.log(JSON.stringify(frame));
             }
         }
-        function findWithXcrun(tool) {
-            try {
-                const result = (0, external_node_child_process_.spawnSync)('xcrun', [
-                    '--find',
-                    tool
-                ], {
-                    encoding: 'utf8',
-                    timeout: 15000
-                });
-                if (0 !== result.status) return null;
-                const resolved = String(result.stdout || '').trim();
-                return resolved.length > 0 ? resolved : null;
-            } catch  {
-                return null;
-            }
+        function fail(message, frame) {
+            console.error(message);
+            if (frame && 'json' === frame.output) writeFrame(messaging.Pr.fail(frame.command, statusForCode(frame.code), {
+                code: frame.code,
+                message,
+                name: 'CliError'
+            }));
+            process.exit(1);
         }
-        function detectSafariToolchain() {
-            const platformOk = isMacOS();
-            if (!platformOk) return {
-                platformOk: false,
-                developerDir: null,
-                needsFullXcode: false,
-                converter: null,
-                xcodebuild: null,
-                ok: false
-            };
-            const developerDir = activeDeveloperDir();
-            const needsFullXcode = !developerDir || /CommandLineTools/i.test(developerDir);
-            const converter = findWithXcrun('safari-web-extension-converter');
-            const xcodebuild = findWithXcrun('xcodebuild');
-            return {
-                platformOk,
-                developerDir,
-                needsFullXcode,
-                converter,
-                xcodebuild,
-                ok: Boolean(converter && xcodebuild)
+        function printResult(result, output, command) {
+            if ('json' === output) return void console.log(JSON.stringify(buildActEnvelope(command, result)));
+            if (result.ok) {
+                const value = result.value;
+                console.log('string' == typeof value ? value : JSON.stringify(value, null, 2));
+                if (result.truncated) console.error('… result truncated (byte cap)');
+                return;
+            }
+            const err = result.error || {
+                name: 'Error',
+                message: 'command failed'
             };
+            console.error(`${err.name}: ${err.message}${err.engine ? ` (engine: ${err.engine})` : ''}`);
         }
-        function fallbackLogger() {
-            return {
-                info: (...a)=>console.log(...a),
-                warn: (...a)=>console.warn(...a),
-                error: (...a)=>console.error(...a),
-                debug: (...a)=>console?.debug?.(...a)
+        async function runCommand(input) {
+            const projectPath = external_node_path_default().resolve(input.projectPathArg || process.cwd());
+            const browser = input.opts.browser || 'chromium';
+            const { BridgeController, readReadyContract, readControlToken } = await loadExtensionDevelopBridgeModule();
+            const outputFrame = {
+                command: input.command,
+                output: input.opts.output
             };
-        }
-        function isTestEnv() {
-            return Boolean(process.env.VITEST || process.env.VITEST_WORKER_ID);
-        }
-        function delay(ms) {
-            return new Promise((resolve)=>setTimeout(resolve, ms));
-        }
-        const TOOL_TAIL_LINES = 50;
-        const TOOL_TAIL_BYTES = 8192;
-        function toolOutputTail(output) {
-            const lines = output.slice(4 * -TOOL_TAIL_BYTES).split(/\r?\n/).filter((line)=>line.trim().length > 0);
-            const tail = lines.slice(-TOOL_TAIL_LINES).join('\n');
-            return tail.length > TOOL_TAIL_BYTES ? tail.slice(-TOOL_TAIL_BYTES) : tail;
-        }
-        function runTool(bin, args, opts) {
-            const streamOutput = (0, messaging._o)() && !opts?.quiet;
-            return new Promise((resolve)=>{
-                let output = '';
-                const child = (0, external_node_child_process_.spawn)(bin, args, {
-                    stdio: [
-                        'ignore',
-                        'pipe',
-                        'pipe'
-                    ]
-                });
-                const onChunk = (chunk)=>{
-                    const text = String(chunk);
-                    output += text;
-                    if (output.length > 8 * TOOL_TAIL_BYTES) output = output.slice(4 * -TOOL_TAIL_BYTES);
-                    if (streamOutput) process.stdout.write(text);
-                };
-                child.stdout?.on('data', onChunk);
-                child.stderr?.on('data', onChunk);
-                child.on('error', (error)=>resolve({
-                        ok: false,
-                        code: null,
-                        output: `${output}${String(error)}`
-                    }));
-                child.on('close', (code)=>resolve({
-                        ok: 0 === code,
-                        code,
-                        output
-                    }));
+            const ready = readReadyContract(projectPath, browser);
+            if (!ready) fail(`No active control channel found for ${browser}. Run \`extension dev --browser=${browser} --allow-control\` first.`, {
+                ...outputFrame,
+                code: messaging.Lp.E_SESSION_NOT_FOUND
             });
-        }
-        function converterWarnings(output) {
-            return output.split(/\r?\n/).filter((line)=>/warning/i.test(line)).map((line)=>line.trim()).filter((line)=>line.length > 0);
-        }
-        async function confirmRegisteredWithSafari(bundleIdentifier) {
-            const needle = `${bundleIdentifier}.Extension`;
-            for(let attempt = 0; attempt < 6; attempt += 1){
-                const { ok, output } = await runTool('pluginkit', [
-                    '-m'
-                ], {
-                    quiet: true
+            const token = input.needsToken ? readControlToken(projectPath, browser) : void 0;
+            const controller = new BridgeController({
+                controlPort: ready.controlPort,
+                instanceId: ready.instanceId,
+                token: token ?? void 0
+            });
+            try {
+                await controller.connect();
+            } catch (err) {
+                controller.close();
+                const message = err?.message || 'could not connect to the control channel';
+                fail(message, {
+                    ...outputFrame,
+                    code: /code 40\d\d/.test(message) ? messaging.Lp.E_CONTROL_DENIED : messaging.Lp.E_CONTROL_UNAVAILABLE
                 });
-                if (ok && output.includes(needle)) return true;
-                await delay(800);
             }
-            return false;
-        }
-        function safariPreflightError() {
-            const tc = detectSafariToolchain();
-            if (!tc.platformOk) return messages.G3(process.platform);
-            if (!tc.ok) {
-                if (tc.needsFullXcode) return messages.Xi(tc.developerDir);
-                return messages.Cs(tc.converter ? 'xcodebuild' : 'safari-web-extension-converter');
+            const timeoutMs = input.opts.timeout ? Number(input.opts.timeout) : 5000;
+            let result;
+            try {
+                result = await controller.command({
+                    op: input.op,
+                    target: input.target,
+                    args: input.args,
+                    timeoutMs
+                });
+            } catch (err) {
+                controller.close();
+                const message = err?.message || 'command failed';
+                fail(message, {
+                    ...outputFrame,
+                    code: /timed out/i.test(message) ? messaging.Lp.E_TIMEOUT : messaging.Lp.E_CONTROL_UNAVAILABLE
+                });
+            } finally{
+                controller.close();
             }
-            return null;
+            if (result?.ok && input.augment) try {
+                Object.assign(result, input.augment(projectPath, browser, result));
+            } catch  {}
+            printResult(result, input.opts.output, input.command);
+            await exitAfterDrain(result.ok ? 0 : 1);
         }
-        function safariBuildPreflight() {
-            const tc = detectSafariToolchain();
-            if (!tc.platformOk) return {
-                severity: 'skip',
-                message: messages.UW(process.platform)
-            };
-            if (!tc.ok) return {
-                severity: 'fatal',
-                message: tc.needsFullXcode ? messages.Xi(tc.developerDir) : messages.Cs(tc.converter ? 'xcodebuild' : 'safari-web-extension-converter')
-            };
-            return {
-                severity: 'ok'
+        function targetFrom(opts, fallback = 'background') {
+            const context = opts.context || fallback;
+            const target = {
+                context
             };
+            if (opts.url) target.url = opts.url;
+            if (null != opts.tab && '' !== opts.tab) target.tabId = Number(opts.tab);
+            return target;
         }
-        async function runSafariPipeline(compilation, host, logger, mode) {
-            const config = resolveSafariBuildConfig(compilation, host);
-            const converterArgs = composeConverterArgs(config);
-            const xcodebuildArgs = composeXcodebuildArgs(config);
-            if (host.dryRun || isTestEnv()) return void logSafariDryRun(`xcrun ${converterArgs.join(' ')}`, `xcodebuild ${xcodebuildArgs.join(' ')}`);
-            const toolchain = detectSafariToolchain();
-            if (!toolchain.platformOk) return void logger.warn?.(messages.G3(process.platform));
-            if (!toolchain.ok) {
-                if (toolchain.needsFullXcode) logger.error?.(messages.Xi(toolchain.developerDir));
-                else {
-                    const missing = toolchain.converter ? 'xcodebuild' : 'safari-web-extension-converter';
-                    logger.error?.(messages.Cs(missing));
-                }
-                return;
-            }
-            const projectExists = external_node_fs_.existsSync(xcodeProjectPath(config));
-            const needsConversion = !projectExists || host.forceRegenerate || isProjectStale(config);
-            if (needsConversion) {
-                if (projectExists) {
-                    logger.info?.(host.forceRegenerate ? messages.Tq() : messages.jc());
-                    logger.warn?.(messages.H1([
-                        ...PRESERVED_SETTINGS
-                    ]));
-                }
-                const { saved, restore } = backupAndRestoreXcodeSettings(config);
-                logger.info?.(messages.uK(config.extensionDir));
-                const converted = await runTool('xcrun', converterArgs);
-                if (!converted.ok) {
-                    const tail = toolOutputTail(converted.output);
-                    logger.error?.(messages.A('safari-web-extension-converter', converted.code, tail));
-                    throw new Error(`safari-web-extension-converter failed (exit ${converted.code})\n${tail}`);
-                }
-                const warnings = converterWarnings(converted.output);
-                if (warnings.length > 0) logger.warn?.(messages.y1(warnings));
-                const projFile = pbxprojPath(config);
-                if (external_node_fs_.existsSync(projFile)) external_node_fs_.writeFileSync(projFile, alignBundleIdentifiers(external_node_fs_.readFileSync(projFile, 'utf8'), config.bundleIdentifier), 'utf8');
-                restore();
-                const preservedKeys = Object.keys(saved);
-                if (preservedKeys.length > 0) logger.info?.(messages.oB(preservedKeys));
-                saveManifestFingerprint(config);
-                logger.info?.(messages.l_(config.projectLocation));
-            } else logger.info?.(messages.oM());
-            if ('full' === mode) logger.info?.(messages.jR(macOsSchemeName(config)));
-            const built = await runTool('xcodebuild', xcodebuildArgs);
-            if (!built.ok) {
-                const tail = toolOutputTail(built.output);
-                logger.error?.(messages.A('xcodebuild', built.code, tail));
-                throw new Error(`xcodebuild failed (exit ${built.code})\n${tail}`);
-            }
-            const appPath = builtAppPath(config);
-            if ('resync' === mode) return void logger.info?.(messages.cF(config.appName));
-            logger.info?.(messages.Rl(appPath));
-            if (config.bundleIdDerived) logger.info?.(messages.$q(config.bundleIdentifier));
-            if (!config.open) return void logger.info?.(messages.aO(appPath, config.appName));
-            const target = external_node_fs_.existsSync(appPath) ? appPath : xcodeProjectPath(config);
-            logger.info?.(messages.fw(target));
-            await runTool('open', [
-                target
-            ]);
-            if (config.safariBinary) await runTool('open', [
-                '-a',
-                config.safariBinary
-            ]);
-            logger.info?.(messages.fO(config.appName));
-            if (await confirmRegisteredWithSafari(config.bundleIdentifier)) logger.info?.(messages.fd(config.appName));
-            else logger.warn?.(messages.qY(config.appName));
-        }
-        async function packageSafariExtension(host, outputPath, logger, mode = 'full') {
-            const compilation = {
-                options: {
-                    output: {
-                        path: outputPath
+        const commonOptions = (cmd)=>cmd.option('--browser <chrome | chromium | edge | firefox>', '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({
+                    projectPathArg,
+                    command: 'eval',
+                    op: 'eval',
+                    target: targetFrom(opts),
+                    args: {
+                        expression
+                    },
+                    needsToken: true,
+                    opts
+                });
+            });
+            commonOptions(program.command('storage').arguments('<action> [project-path]').description(commandDescriptions.storage).option('--area <local|sync|session|managed>', 'storage area (default local)').option('--key <key>', 'key to get or set').option('--value <json>', 'JSON value to set (with set)').option('--context <background|popup|options|sidebar|content>', 'target context (default background)')).action(async (action, projectPathArg, opts)=>{
+                const area = opts.area || 'local';
+                if ('get' === action) return void await runCommand({
+                    projectPathArg,
+                    command: 'storage',
+                    op: 'storage.get',
+                    target: targetFrom(opts),
+                    args: opts.key ? {
+                        area,
+                        key: opts.key
+                    } : {
+                        area
+                    },
+                    opts
+                });
+                if ('set' === action) {
+                    if (!opts.key || null == opts.value) fail('storage set requires --key and --value', {
+                        command: 'storage',
+                        code: messaging.Lp.E_ARGS,
+                        output: opts.output
+                    });
+                    let parsed;
+                    try {
+                        parsed = JSON.parse(opts.value);
+                    } catch  {
+                        parsed = opts.value;
                     }
-                },
-                outputOptions: {
-                    path: outputPath
+                    await runCommand({
+                        projectPathArg,
+                        command: 'storage',
+                        op: 'storage.set',
+                        target: targetFrom(opts),
+                        args: {
+                            area,
+                            items: {
+                                [opts.key]: parsed
+                            }
+                        },
+                        opts
+                    });
+                    return;
                 }
-            };
-            await runSafariPipeline(compilation, host, logger || fallbackLogger(), mode);
+                fail(`unknown storage action: ${action} (use get or set)`, {
+                    command: 'storage',
+                    code: messaging.Lp.E_ARGS,
+                    output: opts.output
+                });
+            });
+            commonOptions(program.command('reload').arguments('[project-path]').description(commandDescriptions.reload).option('--context <background|content|page>', 'target context (default background)').option('--tab <id>', 'for content/page: a specific tab')).action(async (projectPathArg, opts)=>{
+                await runCommand({
+                    projectPathArg,
+                    command: 'reload',
+                    op: 'reload',
+                    target: targetFrom(opts),
+                    opts
+                });
+            });
+            commonOptions(program.command('inspect').arguments('[project-path]').description(commandDescriptions.inspect).option('--context <content|page|popup|options|sidebar|devtools|newtab|history|bookmarks>', 'what to inspect: content/page or an open surface, including url-override pages (default content)').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)').option('--list-tabs', 'list open tabs as {tabId,url,title} and exit').option('--include <list>', 'comma-separated: html,summary (default summary)').option('--max-bytes <n>', 'cap on returned HTML bytes (default 262144)').option('--with-console [n]', 'also include the last n console lines for the target (default 20)')).action(async (projectPathArg, opts)=>{
+                if (opts.listTabs) return void await runCommand({
+                    projectPathArg,
+                    command: 'inspect',
+                    op: 'tabs.query',
+                    target: {
+                        context: 'background'
+                    },
+                    args: {},
+                    opts
+                });
+                const include = opts.include ? opts.include.split(',').map((s)=>s.trim()).filter(Boolean) : [
+                    'summary'
+                ];
+                const target = targetFrom(opts, 'content');
+                await runCommand({
+                    projectPathArg,
+                    command: 'inspect',
+                    op: 'inspect',
+                    target,
+                    args: {
+                        include,
+                        maxBytes: opts.maxBytes ? Number(opts.maxBytes) : void 0
+                    },
+                    opts,
+                    augment: opts.withConsole ? (projectPath, browser)=>{
+                        const n = 'string' == typeof opts.withConsole && '' !== opts.withConsole ? Number(opts.withConsole) : 20;
+                        return {
+                            console: readRecentConsole(projectPath, browser, target, Number.isFinite(n) && n > 0 ? n : 20)
+                        };
+                    } : void 0
+                });
+            });
+            commonOptions(program.command('open').arguments('<surface> [project-path]').description('Open an extension surface: popup, options, sidebar, action, or command (requires --allow-control)').option('--name <command>', 'with `open command`: the chrome.commands name to trigger')).action(async (surface, projectPathArg, opts)=>{
+                const allowed = [
+                    'popup',
+                    'options',
+                    'sidebar',
+                    'action',
+                    'command'
+                ];
+                if (!allowed.includes(surface)) fail(`unknown surface: ${surface} (use popup, options, sidebar, action, or command)`, {
+                    command: 'open',
+                    code: messaging.Lp.E_ARGS,
+                    output: opts.output
+                });
+                const inBackground = 'action' === surface || 'command' === surface;
+                const context = inBackground ? 'background' : surface;
+                const args = {
+                    surface
+                };
+                if ('command' === surface && opts.name) args.name = opts.name;
+                await runCommand({
+                    projectPathArg,
+                    command: 'open',
+                    op: 'open',
+                    target: {
+                        context
+                    },
+                    args,
+                    opts
+                });
+            });
         }
+        var safari_launch = __webpack_require__("./browsers/run-safari/safari-launch/index.ts");
+        var safari_config = __webpack_require__("./browsers/run-safari/safari-launch/safari-config.ts");
+        var safari_packager = __webpack_require__("./browsers/run-safari/safari-packager.ts");
         function parseLogContexts(raw) {
             if (!raw || 0 === String(raw).trim().length) return;
             if ('all' === String(raw).trim().toLowerCase()) return;
@@ -6995,7 +7093,7 @@ Cross-Browser Compatibility
             return true;
         }
         function registerBuildCommand(program) {
-            program.command('build').arguments('[project-name]').usage('[path-to-remote-extension] [options]').description(commandDescriptions.build).option('--browser <chrome | chromium | edge | firefox | chromium-based | gecko-based | firefox-based | safari | webkit-based>', '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('--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').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 = 'chromium', ...buildOptions })=>{
+            program.command('build').arguments('[project-name]').usage('[path-to-remote-extension] [options]').description(commandDescriptions.build).option('--browser <chrome | chromium | edge | firefox | chromium-based | gecko-based | firefox-based | safari | webkit-based>', '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('--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').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 = 'chromium', ...buildOptions })=>{
                 if (buildOptions.debug || buildOptions.author || buildOptions.authorMode) {
                     process.env.EXTENSION_DEBUG = '1';
                     process.env.EXTENSION_AUTHOR_MODE = 'true';
@@ -7032,18 +7130,19 @@ Cross-Browser Compatibility
                         '--force-regenerate',
                         buildOptions.forceRegenerate
                     ]
-                ].filter(([, value])=>void 0 !== value && false !== value);
+                ].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)) {
-                    console.error(safariOnlyOption(safariOnlyFlags.map(([flag])=>flag)));
+                    console.error(safariOnlyOption(safariOnlyFlags));
                     process.exit(1);
                 }
-                if (buildOptions.bundleId && !isValidBundleId(buildOptions.bundleId)) {
+                if (buildOptions.bundleId && !(0, safari_config.OA)(buildOptions.bundleId)) {
                     console.error(safariInvalidBundleId(buildOptions.bundleId));
                     process.exit(1);
                 }
                 let safariPackagingEnabled = true;
                 if (list.some(isSafariVendor)) {
-                    const preflight = safariBuildPreflight();
+                    const preflight = (0, safari_launch.QW)();
                     if ('fatal' === preflight.severity) {
                         console.error(preflight.message);
                         process.exit(1);
@@ -7057,8 +7156,9 @@ Cross-Browser Compatibility
                 const asJson = 'json' === buildOptions.output;
                 if (asJson) process.env.EXTENSION_OUTPUT = 'json';
                 const built = [];
+                const summaries = [];
                 for (const vendor of list)try {
-                    await extensionBuild(pathOrRemoteUrl, {
+                    const summary = await extensionBuild(pathOrRemoteUrl, {
                         browser: vendor,
                         exitOnError: !asJson,
                         polyfill: buildOptions.polyfill,
@@ -7071,20 +7171,15 @@ Cross-Browser Compatibility
                         mode,
                         appName: buildOptions.appName,
                         bundleId: buildOptions.bundleId,
+                        macOsOnly: buildOptions.macosOnly,
                         forceRegenerate: buildOptions.forceRegenerate,
-                        safariPackager: safariPackagingEnabled ? async (distPath, packagerMode, overrides)=>{
-                            await packageSafariExtension({
-                                extension: [
-                                    distPath
-                                ],
-                                browser: vendor,
-                                noOpen: true !== buildOptions.open,
-                                dryRun: false,
-                                ...overrides
-                            }, distPath, void 0, packagerMode);
-                        } : void 0
+                        safariPackager: safariPackagingEnabled ? (0, safari_packager.P)({
+                            browser: vendor,
+                            noOpen: true !== buildOptions.open
+                        }) : void 0
                     });
                     built.push(vendor);
+                    if (summary) summaries.push(summary);
                 } catch (error) {
                     if (!asJson) throw error;
                     console.log(JSON.stringify(messaging.Pr.fail('build', 'build-failed', {
@@ -7098,7 +7193,8 @@ Cross-Browser Compatibility
                 if (asJson) console.log(JSON.stringify(messaging.Pr.ok('build', 'built', {
                     projectPath: pathOrRemoteUrl,
                     browsers: built,
-                    mode
+                    mode,
+                    summaries
                 })));
             });
         }
@@ -7413,7 +7509,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    do not launch the browser (dev server still starts)\n  --no-reload     emit a dev-mode dist without the content-script reload runtime; tabs need manual reload to see changes\n  --wait          wait for ready contract and exit; pair with --output json for machine output\n").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 <chrome | chromium | edge | firefox | chromium-based | gecko-based | firefox-based | safari | webkit-based>', 'specify a browser/engine to run. Defaults to `chromium`. `safari` builds and opens a Safari app via Xcode (macOS only; no live reload)').option('--chromium-binary <path-to-binary>', 'specify a path to the Chromium binary. This option overrides the --browser setting. Defaults to the system default').option('--gecko-binary, --firefox-binary <path-to-binary>', 'specify a path to the Gecko binary. This option overrides the --browser setting. Defaults to the system default').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').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', 'do not open the browser automatically (default: open)').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` (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, { browser = 'chromium', ...devOptions })=>{
+            program.command('dev').arguments('[project-path|remote-url]').usage('[project-path|remote-url] [options]').description(commandDescriptions.dev).addHelpText('after', "\nAdditional options:\n  --no-browser    do not launch the browser (dev server still starts)\n  --no-reload     emit a dev-mode dist without the content-script reload runtime; tabs need manual reload to see changes\n  --wait          wait for ready contract and exit; pair with --output json for machine output\n").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 <chrome | chromium | edge | firefox | chromium-based | gecko-based | firefox-based | safari | webkit-based>', 'specify a browser/engine to run. Defaults to `chromium`. `safari` builds and opens a Safari app via Xcode (macOS only; no live reload)').option('--chromium-binary <path-to-binary>', 'specify a path to the Chromium binary. This option overrides the --browser setting. Defaults to the system default').option('--gecko-binary, --firefox-binary <path-to-binary>', 'specify a path to the Gecko binary. This option overrides the --browser setting. Defaults to the system default').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').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', 'do not open the browser automatically (default: open)').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` (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, { browser = 'chromium', ...devOptions })=>{
                 if (devOptions.debug || devOptions.author || devOptions.authorMode) {
                     process.env.EXTENSION_DEBUG = '1';
                     process.env.EXTENSION_AUTHOR_MODE = 'true';
@@ -7460,16 +7556,16 @@ Cross-Browser Compatibility
                         '--force-regenerate',
                         opts.forceRegenerate
                     ]
-                ].filter(([, value])=>void 0 !== value && false !== value);
+                ].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)) {
-                    const flags = safariOnlyFlags.map(([flag])=>flag);
-                    console.error(safariOnlyOption(flags));
+                    console.error(safariOnlyOption(safariOnlyFlags));
                     failAndExit(asJson, 'usage', {
                         code: messaging.Lp.E_INVALID_OPTION,
-                        message: `${flags.join(', ')} apply to safari targets only.`
+                        message: `${safariOnlyFlags.join(', ')} apply to safari targets only.`
                     });
                 }
-                if (opts.bundleId && !isValidBundleId(opts.bundleId)) {
+                if (opts.bundleId && !(0, safari_config.OA)(opts.bundleId)) {
                     console.error(safariInvalidBundleId(opts.bundleId));
                     failAndExit(asJson, 'usage', {
                         code: messaging.Lp.E_INVALID_OPTION,
@@ -7477,7 +7573,7 @@ Cross-Browser Compatibility
                     });
                 }
                 if (list.some(isSafariVendor)) {
-                    const issue = safariPreflightError();
+                    const issue = (0, safari_launch.iF)();
                     if (issue) {
                         console.error(issue);
                         failAndExit(asJson, 'failed', {
@@ -7541,6 +7637,7 @@ Cross-Browser Compatibility
                         geckoBinary: devOptions.geckoBinary,
                         polyfill: devOptions.polyfill?.toString() !== 'false',
                         noOpen: false === devOptions.open,
+                        macOsOnly: opts.macosOnly,
                         startingUrl: devOptions.startingUrl,
                         install: devOptions.install,
                         noBrowser,
@@ -7553,17 +7650,10 @@ Cross-Browser Compatibility
                         logUrl: devOptions.logUrl,
                         logTab: devOptions.logTab,
                         launcher: noBrowser ? void 0 : browsers.launchBrowser,
-                        safariPackager: async (distPath, mode, overrides)=>{
-                            await packageSafariExtension({
-                                extension: [
-                                    distPath
-                                ],
-                                browser: vendor,
-                                noOpen: false === devOptions.open,
-                                dryRun: false,
-                                ...overrides
-                            }, distPath, void 0, mode);
-                        }
+                        safariPackager: (0, safari_packager.P)({
+                            browser: vendor,
+                            noOpen: false === devOptions.open
+                        })
                     };
                     try {
                         await extensionDev(pathOrRemoteUrl, devArgs);