extension 4.0.28 → 4.0.29-next.0

package/dist/browsers.cjs

@@ -2423,7 +2423,6 @@ var __webpack_modules__ = {
             '--disable-breakpad',
             '--disable-component-update',
             '--disable-domain-reliability',
-            '--disable-sync',
             '--no-pings',
             '--enable-features=SidePanelUpdates',
             '--disable-features=DisableLoadExtensionCommandLineSwitch',
@@ -3890,7 +3889,7 @@ var __webpack_modules__ = {
             }
             return false;
         }
-        async function printRunningInDevelopmentSummary(candidateAddonPaths, browser, extensionId, browserVersionLine) {
+        async function printRunningInDevelopmentSummary(candidateAddonPaths, browser, extensionId, browserVersionLine, launchIdentity) {
             try {
                 let chosenPath = null;
                 for (const p of candidateAddonPaths){
@@ -3928,7 +3927,10 @@ var __webpack_modules__ = {
                             name: manifest.name,
                             version: manifest.version
                         }),
-                    browserVersionLine
+                    browserVersionLine,
+                    profilePath: launchIdentity?.profilePath,
+                    binaryPath: launchIdentity?.binaryPath,
+                    binaryProvenance: launchIdentity?.binaryProvenance
                 });
                 return printed;
             } catch  {
@@ -4587,7 +4589,11 @@ var __webpack_modules__ = {
                     }
                 } catch  {}
                 this.lastInstalledAddonPath = primaryAddonPath;
-                const bannerPrinted = await printRunningInDevelopmentSummary(candidateAddonPaths, 'firefox', this.derivedExtensionId, this.options.browserVersionLine);
+                const bannerPrinted = await printRunningInDevelopmentSummary(candidateAddonPaths, 'firefox', this.derivedExtensionId, this.options.browserVersionLine, {
+                    profilePath: this.options.launchProfilePath,
+                    binaryPath: this.options.launchBinaryPath,
+                    binaryProvenance: this.options.launchBinaryProvenance
+                });
                 if (!bannerPrinted) throw new Error(messages.WV(this.options.browser, 'Failed to print runningInDevelopment banner; add-on may not be installed.'));
             }
             async enableUnifiedLogging(opts) {
@@ -4665,7 +4671,10 @@ var __webpack_modules__ = {
                     instanceId: plugin.instanceId,
                     port: debugPort,
                     resolvedRdpPort: normalizedDebugPort,
-                    browserVersionLine: plugin.browserVersionLine
+                    browserVersionLine: plugin.browserVersionLine,
+                    launchProfilePath: plugin.launchProfilePath,
+                    launchBinaryPath: plugin.launchBinaryPath,
+                    launchBinaryProvenance: plugin.launchBinaryProvenance
                 });
                 this.debugPort = normalizedDebugPort;
             }
@@ -4928,6 +4937,12 @@ var __webpack_modules__ = {
                 }
                 const binaryPath = browserBinaryLocation;
                 const wslFallbackBinary = (0, wsl_support.EV)() && !engineBased ? resolveWslFallback() : null;
+                this.host.launchBinaryPath = binaryPath;
+                this.host.launchBinaryProvenance = (0, shared_utils.RU)({
+                    binaryPath,
+                    managedCacheRoot: String((0, output_binaries_resolver.LB)(compilation) || ''),
+                    pinnedByFlag: Boolean(this.host.geckoBinary)
+                });
                 if (!isFlatpak) try {
                     this.host.browserVersionLine = (0, external_firefox_location2_.getFirefoxVersion)(binaryPath, {
                         allowExec: true
@@ -4961,6 +4976,7 @@ var __webpack_modules__ = {
                 if (profileMatch) {
                     const profilePath = profileMatch[1];
                     const { binary, args } = FirefoxBinaryDetector.generateFirefoxArgs(binaryPath, profilePath, debugPort, firefoxArgs, isFirefoxHeadlessRequested());
+                    this.host.launchProfilePath = profilePath;
                     this.child = await this.spawnFirefoxChild(binary, args, wslFallbackBinary);
                     (0, ready_stamp.M)(this.extensionOutputPath, {
                         profilePath,
@@ -5325,7 +5341,9 @@ var __webpack_modules__ = {
         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 banner = __webpack_require__("./browsers/browsers-lib/banner.ts");
         var messages = __webpack_require__("./browsers/browsers-lib/messages.ts");
+        var ready_message = __webpack_require__("./browsers/browsers-lib/ready-message.ts");
         function logSafariDryRun(converterCmd, xcodebuildCmd) {
             if ((0, messaging._o)()) (0, messaging._w)(messages.KP());
             (0, messaging._w)(messages.yc());
@@ -5491,6 +5509,20 @@ var __webpack_modules__ = {
                 severity: 'ok'
             };
         }
+        async function announceSafariDevSession(host, config, appPath) {
+            try {
+                await (0, banner.ai)({
+                    browser: host.browser,
+                    outPath: config.extensionDir,
+                    getInfo: async ()=>({
+                            extensionId: `${config.bundleIdentifier}.Extension`,
+                            name: config.appName
+                        }),
+                    binaryPath: appPath
+                });
+                (0, messaging._w)((0, ready_message.G)('development', String(host.browser)));
+            } catch  {}
+        }
         async function runSafariPipeline(compilation, host, logger, mode) {
             const config = (0, safari_config.F7)(compilation, host);
             const converterArgs = (0, safari_config.w7)(config);
@@ -5555,6 +5587,7 @@ var __webpack_modules__ = {
             logger.info?.(messages.Rl(appPath));
             if (!config.open) {
                 logger.info?.(messages.aO(appPath, config.appName));
+                if (host.announceDevReady) await announceSafariDevSession(host, config, appPath);
                 return describePackage(config);
             }
             const target = external_node_fs_.existsSync(appPath) ? appPath : (0, safari_config.Gi)(config);
@@ -5569,6 +5602,7 @@ var __webpack_modules__ = {
             logger.info?.(messages.fO(config.appName));
             if (await confirmRegisteredWithSafari(config.bundleIdentifier)) logger.info?.(messages.fd(config.appName));
             else logger.info?.(messages.qY(config.appName));
+            if (host.announceDevReady) await announceSafariDevSession(host, config, appPath);
             return describePackage(config);
         }
         async function packageSafariExtension(host, outputPath, logger, mode = 'full') {

package/dist/cli.cjs

@@ -2414,7 +2414,6 @@ var __webpack_modules__ = {
             '--disable-breakpad',
             '--disable-component-update',
             '--disable-domain-reliability',
-            '--disable-sync',
             '--no-pings',
             '--enable-features=SidePanelUpdates',
             '--disable-features=DisableLoadExtensionCommandLineSwitch',
@@ -3881,7 +3880,7 @@ var __webpack_modules__ = {
             }
             return false;
         }
-        async function printRunningInDevelopmentSummary(candidateAddonPaths, browser, extensionId, browserVersionLine) {
+        async function printRunningInDevelopmentSummary(candidateAddonPaths, browser, extensionId, browserVersionLine, launchIdentity) {
             try {
                 let chosenPath = null;
                 for (const p of candidateAddonPaths){
@@ -3919,7 +3918,10 @@ var __webpack_modules__ = {
                             name: manifest.name,
                             version: manifest.version
                         }),
-                    browserVersionLine
+                    browserVersionLine,
+                    profilePath: launchIdentity?.profilePath,
+                    binaryPath: launchIdentity?.binaryPath,
+                    binaryProvenance: launchIdentity?.binaryProvenance
                 });
                 return printed;
             } catch  {
@@ -4578,7 +4580,11 @@ var __webpack_modules__ = {
                     }
                 } catch  {}
                 this.lastInstalledAddonPath = primaryAddonPath;
-                const bannerPrinted = await printRunningInDevelopmentSummary(candidateAddonPaths, 'firefox', this.derivedExtensionId, this.options.browserVersionLine);
+                const bannerPrinted = await printRunningInDevelopmentSummary(candidateAddonPaths, 'firefox', this.derivedExtensionId, this.options.browserVersionLine, {
+                    profilePath: this.options.launchProfilePath,
+                    binaryPath: this.options.launchBinaryPath,
+                    binaryProvenance: this.options.launchBinaryProvenance
+                });
                 if (!bannerPrinted) throw new Error(messages.WV(this.options.browser, 'Failed to print runningInDevelopment banner; add-on may not be installed.'));
             }
             async enableUnifiedLogging(opts) {
@@ -4656,7 +4662,10 @@ var __webpack_modules__ = {
                     instanceId: plugin.instanceId,
                     port: debugPort,
                     resolvedRdpPort: normalizedDebugPort,
-                    browserVersionLine: plugin.browserVersionLine
+                    browserVersionLine: plugin.browserVersionLine,
+                    launchProfilePath: plugin.launchProfilePath,
+                    launchBinaryPath: plugin.launchBinaryPath,
+                    launchBinaryProvenance: plugin.launchBinaryProvenance
                 });
                 this.debugPort = normalizedDebugPort;
             }
@@ -4919,6 +4928,12 @@ var __webpack_modules__ = {
                 }
                 const binaryPath = browserBinaryLocation;
                 const wslFallbackBinary = (0, wsl_support.EV)() && !engineBased ? resolveWslFallback() : null;
+                this.host.launchBinaryPath = binaryPath;
+                this.host.launchBinaryProvenance = (0, shared_utils.RU)({
+                    binaryPath,
+                    managedCacheRoot: String((0, output_binaries_resolver.LB)(compilation) || ''),
+                    pinnedByFlag: Boolean(this.host.geckoBinary)
+                });
                 if (!isFlatpak) try {
                     this.host.browserVersionLine = (0, external_firefox_location2_.getFirefoxVersion)(binaryPath, {
                         allowExec: true
@@ -4952,6 +4967,7 @@ var __webpack_modules__ = {
                 if (profileMatch) {
                     const profilePath = profileMatch[1];
                     const { binary, args } = FirefoxBinaryDetector.generateFirefoxArgs(binaryPath, profilePath, debugPort, firefoxArgs, isFirefoxHeadlessRequested());
+                    this.host.launchProfilePath = profilePath;
                     this.child = await this.spawnFirefoxChild(binary, args, wslFallbackBinary);
                     (0, ready_stamp.M)(this.extensionOutputPath, {
                         profilePath,
@@ -5316,7 +5332,9 @@ var __webpack_modules__ = {
         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 banner = __webpack_require__("./browsers/browsers-lib/banner.ts");
         var messages = __webpack_require__("./browsers/browsers-lib/messages.ts");
+        var ready_message = __webpack_require__("./browsers/browsers-lib/ready-message.ts");
         function logSafariDryRun(converterCmd, xcodebuildCmd) {
             if ((0, messaging._o)()) (0, messaging._w)(messages.KP());
             (0, messaging._w)(messages.yc());
@@ -5482,6 +5500,20 @@ var __webpack_modules__ = {
                 severity: 'ok'
             };
         }
+        async function announceSafariDevSession(host, config, appPath) {
+            try {
+                await (0, banner.ai)({
+                    browser: host.browser,
+                    outPath: config.extensionDir,
+                    getInfo: async ()=>({
+                            extensionId: `${config.bundleIdentifier}.Extension`,
+                            name: config.appName
+                        }),
+                    binaryPath: appPath
+                });
+                (0, messaging._w)((0, ready_message.G)('development', String(host.browser)));
+            } catch  {}
+        }
         async function runSafariPipeline(compilation, host, logger, mode) {
             const config = (0, safari_config.F7)(compilation, host);
             const converterArgs = (0, safari_config.w7)(config);
@@ -5546,6 +5578,7 @@ var __webpack_modules__ = {
             logger.info?.(messages.Rl(appPath));
             if (!config.open) {
                 logger.info?.(messages.aO(appPath, config.appName));
+                if (host.announceDevReady) await announceSafariDevSession(host, config, appPath);
                 return describePackage(config);
             }
             const target = external_node_fs_.existsSync(appPath) ? appPath : (0, safari_config.Gi)(config);
@@ -5560,6 +5593,7 @@ var __webpack_modules__ = {
             logger.info?.(messages.fO(config.appName));
             if (await confirmRegisteredWithSafari(config.bundleIdentifier)) logger.info?.(messages.fd(config.appName));
             else logger.info?.(messages.qY(config.appName));
+            if (host.announceDevReady) await announceSafariDevSession(host, config, appPath);
             return describePackage(config);
         }
         async function packageSafariExtension(host, outputPath, logger, mode = 'full') {
@@ -7248,12 +7282,6 @@ Public & special folders (output behavior)
 - ${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')}
@@ -7410,9 +7438,11 @@ Cross-browser compatibility
                                 ...group.templates
                             ]
                         })),
-                    aliases: TEMPLATE_ALIASES.map((alias)=>({
-                            ...alias
-                        })),
+                    ...TEMPLATE_ALIASES.length > 0 && {
+                        aliases: TEMPLATE_ALIASES.map((alias)=>({
+                                ...alias
+                            }))
+                    },
                     notes: [
                         `extension create <name> with no --template scaffolds ${DEFAULT_TEMPLATE}`,
                         `${DEFAULT_TEMPLATE} is bundled with the CLI and scaffolds offline. Every other name downloads the examples archive at create time`,
@@ -7454,7 +7484,8 @@ Cross-browser compatibility
                         statuses: [
                             'starting',
                             'ready',
-                            'error'
+                            'error',
+                            'stopped'
                         ],
                         readyFields: [
                             'status',
@@ -7478,7 +7509,7 @@ Cross-browser compatibility
                         ],
                         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',
+                            'events.ndjson is reset at every run start and appends entries with runId, durationMs and errorCount for that run only, join on runId across runs',
                             '--wait requires a local project path (remote URLs are not supported)',
                             'consumers should verify pid liveness and recency before trusting a contract'
                         ]
@@ -7526,6 +7557,146 @@ Cross-browser compatibility
         function noBrowserNotSupportedForCommand(command) {
             return `${getLoggingPrefix('error')} ${messages_code('--no-browser')} is only supported for ${messages_code('dev')}, ${messages_code('start')}, and ${messages_code('preview')}.\n${messaging.Sc.label('GOT')} ${messages_code(command || '(none)')}`;
         }
+        const LEVEL_ORDER = [
+            'error',
+            'warn',
+            'info',
+            'debug',
+            'trace'
+        ];
+        function levelRank(level) {
+            const l = 'log' === level ? 'info' : level;
+            const i = LEVEL_ORDER.indexOf(l);
+            return -1 === i ? LEVEL_ORDER.length : i;
+        }
+        function makeUrlMatcher(pattern) {
+            const hasGlob = pattern.includes('*');
+            let re = null;
+            if (hasGlob) {
+                const escaped = pattern.replace(/[.+?^${}()|[\]\\]/g, '\\$&').replace(/\*/g, '.*');
+                re = new RegExp(escaped);
+            }
+            return (event)=>{
+                const candidates = [
+                    event.url,
+                    event.hostname
+                ].filter((v)=>'string' == typeof v);
+                if (0 === candidates.length) return false;
+                return candidates.some((c)=>re ? re.test(c) : c.includes(pattern));
+            };
+        }
+        function makeFilter(opts) {
+            const minLevel = String(opts.level || 'all').toLowerCase();
+            const contexts = opts.context && 'all' !== opts.context.toLowerCase() ? new Set(opts.context.split(',').map((c)=>c.trim())) : null;
+            const sinceSeq = null != opts.since ? Number(opts.since) : null;
+            const urlMatches = opts.url ? makeUrlMatcher(opts.url) : null;
+            const tabId = null != opts.tab && '' !== opts.tab ? Number(opts.tab) : null;
+            return (event)=>{
+                if (!event || 'object' != typeof event) return false;
+                if ('header' === event.type) return false;
+                if (opts.signalsOnly && 'dx.signal' !== event.eventType) return false;
+                if (contexts && !contexts.has(String(event.context))) return false;
+                if ('all' !== minLevel && 'off' !== minLevel) {
+                    if (levelRank(String(event.level || '')) > levelRank(minLevel)) return false;
+                }
+                if (null != sinceSeq && Number.isFinite(sinceSeq) && 'number' == typeof event.seq && event.seq <= sinceSeq) return false;
+                if (urlMatches && !urlMatches(event)) return false;
+                if (null != tabId && Number.isFinite(tabId) && event.tabId !== tabId) return false;
+                return true;
+            };
+        }
+        function resolveFormat(opts) {
+            if (opts.output) return opts.output;
+            return process.stdout.isTTY ? 'pretty' : 'ndjson';
+        }
+        function printEvent(event, format) {
+            if ('ndjson' === format) return void console.log(JSON.stringify(event));
+            if ('json' === format) return void console.log(JSON.stringify(event, null, 2));
+            console.log(formatPrettyLogLine(event));
+        }
+        function formatPrettyLogLine(event) {
+            const parts = Array.isArray(event.messageParts) ? event.messageParts.map((p)=>'string' == typeof p ? p : JSON.stringify(p)).join(' ') : '';
+            const code = event.code ? ` ${event.code}` : '';
+            const remediation = event.remediation ? `\n    ↳ ${event.remediation}` : '';
+            return `[${event.seq ?? '-'}] ${String(event.level || 'log').toUpperCase()} (${event.context})${code} ${parts}${remediation}`;
+        }
+        function writeFrame(frame) {
+            try {
+                external_node_fs_default().writeSync(1, `${JSON.stringify(frame)}\n`);
+            } catch  {
+                console.log(JSON.stringify(frame));
+            }
+        }
+        function logsFilePath(projectPath, browser) {
+            return external_node_path_default().resolve(projectPath, 'dist', 'extension-js', browser, 'logs.ndjson');
+        }
+        function registerLogsCommand(program) {
+            program.command('logs').arguments('[project-path]').usage('[project-path] [options]').description(commandDescriptions.logs).option('--browser <chrome | chromium | edge | firefox>', 'which dist/extension-js/<browser> to read. Defaults to `chromium`').option('--follow', 'stream live via the control channel instead of printing and exiting').option('--context <list>', 'comma-separated contexts (background, content, popup, options, sidebar, devtools, page)').option('--level <off|error|warn|info|debug|trace|all>', 'minimum severity to show. Defaults to `all`').option('--signals-only', '[experimental] show only structured dx.signal diagnostics. No emitter ships yet, so this currently prints nothing').option('--since <seq|iso>', 'only show events after this sequence number').option('--url <glob|substring>', 'only events whose url/hostname matches (glob with * or plain substring)').option('--tab <id>', 'only events from this tab id').option('--output <pretty|json|ndjson>', 'output format. Defaults to pretty on a TTY, ndjson when piped').action(async (projectPathArg, options)=>{
+                const projectPath = external_node_path_default().resolve(projectPathArg || process.cwd());
+                const browser = options.browser || 'chromium';
+                const format = resolveFormat(options);
+                const matches = makeFilter(options);
+                if (options.follow) return void await followLogs(projectPath, browser, format, matches);
+                const file = logsFilePath(projectPath, browser);
+                if (!external_node_fs_default().existsSync(file)) {
+                    const message = `No logs found at ${file}. Start a dev session (extension dev) first, or pass --browser to match it.`;
+                    console.error(message);
+                    if ('pretty' !== format) writeFrame(messaging.Pr.fail('logs', 'not-found', {
+                        code: messaging.Lp.E_LOGS_NOT_FOUND,
+                        message,
+                        name: 'CliError'
+                    }));
+                    process.exit(1);
+                }
+                const lines = external_node_fs_default().readFileSync(file, 'utf-8').split('\n').filter(Boolean);
+                for (const line of lines){
+                    let event;
+                    try {
+                        event = JSON.parse(line);
+                    } catch  {
+                        continue;
+                    }
+                    if (matches(event)) printEvent(event, format);
+                }
+            });
+        }
+        async function followLogs(projectPath, browser, format, matches) {
+            const { BridgeConsumer, readReadyContract } = await loadExtensionDevelopBridgeModule();
+            const ready = readReadyContract(projectPath, browser);
+            if (!ready) {
+                const message = `No active dev session control channel found for ${browser}. Run \`extension dev --browser=${browser}\` first.`;
+                console.error(message);
+                if ('pretty' !== format) writeFrame(messaging.Pr.fail('logs', 'not-found', {
+                    code: messaging.Lp.E_SESSION_NOT_FOUND,
+                    message,
+                    name: 'CliError'
+                }));
+                process.exit(1);
+            }
+            const consumer = new BridgeConsumer({
+                controlPort: ready.controlPort,
+                instanceId: ready.instanceId,
+                reconnect: true,
+                onLog: (event)=>{
+                    if (matches(event)) printEvent(event, format);
+                },
+                onGap: (gap)=>{
+                    console.error(`… ${gap.dropped} event(s) dropped (${gap.reason}), stream is behind`);
+                }
+            });
+            const shutdown = (signal)=>{
+                consumer.close();
+                if ('pretty' !== format) console.log(JSON.stringify(messaging.Pr.ok('logs', 'interrupted', {
+                    signal,
+                    follow: true
+                })));
+                exitAfterDrain(0);
+            };
+            process.on('SIGINT', ()=>shutdown('SIGINT'));
+            process.on('SIGTERM', ()=>shutdown('SIGTERM'));
+            consumer.start();
+            await new Promise(()=>{});
+        }
         function readRecentConsole(projectPath, browser, target, limit) {
             const file = external_node_path_default().resolve(projectPath, 'dist', 'extension-js', browser, 'logs.ndjson');
             let lines;
@@ -7615,7 +7786,7 @@ Cross-browser compatibility
                 })
             };
         }
-        function writeFrame(frame) {
+        function act_writeFrame(frame) {
             try {
                 external_node_fs_default().writeSync(1, `${JSON.stringify(frame)}\n`);
             } catch  {
@@ -7624,7 +7795,7 @@ Cross-browser compatibility
         }
         function fail(message, frame) {
             console.error(message);
-            if (frame && 'json' === frame.output) writeFrame(messaging.Pr.fail(frame.command, statusForCode(frame.code), {
+            if (frame && 'json' === frame.output) act_writeFrame(messaging.Pr.fail(frame.command, statusForCode(frame.code), {
                 code: frame.code,
                 message,
                 name: 'CliError'
@@ -7636,6 +7807,11 @@ Cross-browser compatibility
             if (result.ok) {
                 const value = result.value;
                 console.log('string' == typeof value ? value : JSON.stringify(value, null, 2));
+                const consoleRecords = result.console;
+                if (Array.isArray(consoleRecords)) {
+                    if (0 === consoleRecords.length) console.log('(no console lines captured)');
+                    for (const record of consoleRecords)console.log(formatPrettyLogLine(record));
+                }
                 if (result.truncated) console.error('… result truncated (byte cap)');
                 return;
             }
@@ -7782,7 +7958,7 @@ Cross-browser compatibility
                     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)=>{
+            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 {id,url,title,active,windowId} and exit (pass id to --tab)').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',
@@ -7872,6 +8048,25 @@ Cross-browser compatibility
         function isSafariVendor(value) {
             return 'safari' === value || 'webkit-based' === value;
         }
+        const SUPPORTED_BROWSER_TARGETS = [
+            'chrome',
+            'chromium',
+            'edge',
+            'firefox',
+            'brave',
+            'opera',
+            'vivaldi',
+            'yandex',
+            'waterfox',
+            'librewolf',
+            'chromium-based',
+            'gecko-based',
+            'firefox-based',
+            'safari',
+            'webkit-based'
+        ];
+        const BROWSER_TARGETS_HELP = SUPPORTED_BROWSER_TARGETS.join(' | ');
+        const NO_SAFARI_BROWSER_TARGETS_HELP = SUPPORTED_BROWSER_TARGETS.filter((target)=>!isSafariVendor(target)).join(' | ');
         function parseOptionalBoolean(value) {
             if (void 0 === value) return true;
             const normalized = String(value).trim().toLowerCase();
@@ -7897,23 +8092,7 @@ Cross-browser compatibility
                 'firefox'
             ] : vendors(browser);
         function validateVendors(vendorsList, onInvalid) {
-            const supported = [
-                'chrome',
-                'edge',
-                'firefox',
-                'chromium',
-                'brave',
-                'opera',
-                'vivaldi',
-                'yandex',
-                'waterfox',
-                'librewolf',
-                'chromium-based',
-                'gecko-based',
-                'firefox-based',
-                'safari',
-                'webkit-based'
-            ];
+            const supported = SUPPORTED_BROWSER_TARGETS;
             for (const v of vendorsList)if (!supported.includes(v)) {
                 onInvalid(v, supported);
                 return false;
@@ -7921,7 +8100,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('--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 })=>{
+            program.command('build').arguments('[project-name]').usage('[path-to-remote-extension] [options]').description(commandDescriptions.build).option(`--browser <${BROWSER_TARGETS_HELP}>`, 'specify a browser/engine to run. Defaults to `chromium`. `safari` builds a Safari app via Xcode (macOS only)').option('--polyfill [boolean]', 'whether or not to apply the cross-browser polyfill. Defaults to `false`', parseOptionalBoolean).option('--no-polyfill', 'disable the cross-browser polyfill').option('--zip [boolean]', 'whether or not to compress the extension into a ZIP file. Defaults to `false`', parseOptionalBoolean).option('--zip-source [boolean]', 'whether or not to include the source files in the ZIP file. Defaults to `false`', parseOptionalBoolean).option('--zip-filename <string>', 'specify the name of the ZIP file. Defaults to the extension name and version').option('--silent [boolean]', 'suppress the build summary output. Defaults to `false`', parseOptionalBoolean).option('--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';
@@ -8508,7 +8687,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('--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` (implies --allow-control, runs arbitrary code in a context, writes a 0600 session token)').option('--parent-pid <pid>', 'exit when the given process dies. For wrappers that spawn `extension dev`, so a leaked dev server can never outlive its owner').action(async (pathOrRemoteUrl, options, command)=>{
+            program.command('dev').arguments('[project-path|remote-url]').usage('[project-path|remote-url] [options]').description(commandDescriptions.dev).addHelpText('after', "\nAdditional options:\n  --no-browser    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 <${BROWSER_TARGETS_HELP}>`, '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` (implies --allow-control, runs arbitrary code in a context, writes a 0600 session token)').option('--parent-pid <pid>', 'exit when the given process dies. For wrappers that spawn `extension dev`, so a leaked dev server can never outlive its owner').action(async (pathOrRemoteUrl, options, command)=>{
                 const { browser = 'chromium', ...devOptions } = options;
                 if (devOptions.debug || devOptions.author || devOptions.authorMode) {
                     process.env.EXTENSION_DEBUG = '1';
@@ -8654,7 +8833,8 @@ Cross-browser compatibility
                         launcher: noBrowser ? void 0 : browsers.launchBrowser,
                         safariPackager: (0, safari_packager.P)({
                             browser: vendor,
-                            noOpen: explicitNoOpen ?? false
+                            noOpen: explicitNoOpen ?? false,
+                            announceDevReady: true
                         })
                     };
                     try {
@@ -9102,150 +9282,13 @@ Cross-browser compatibility
                 }));
             });
         }
-        const LEVEL_ORDER = [
-            'error',
-            'warn',
-            'info',
-            'debug',
-            'trace'
-        ];
-        function levelRank(level) {
-            const l = 'log' === level ? 'info' : level;
-            const i = LEVEL_ORDER.indexOf(l);
-            return -1 === i ? LEVEL_ORDER.length : i;
-        }
-        function makeUrlMatcher(pattern) {
-            const hasGlob = pattern.includes('*');
-            let re = null;
-            if (hasGlob) {
-                const escaped = pattern.replace(/[.+?^${}()|[\]\\]/g, '\\$&').replace(/\*/g, '.*');
-                re = new RegExp(escaped);
-            }
-            return (event)=>{
-                const candidates = [
-                    event.url,
-                    event.hostname
-                ].filter((v)=>'string' == typeof v);
-                if (0 === candidates.length) return false;
-                return candidates.some((c)=>re ? re.test(c) : c.includes(pattern));
-            };
-        }
-        function makeFilter(opts) {
-            const minLevel = String(opts.level || 'all').toLowerCase();
-            const contexts = opts.context && 'all' !== opts.context.toLowerCase() ? new Set(opts.context.split(',').map((c)=>c.trim())) : null;
-            const sinceSeq = null != opts.since ? Number(opts.since) : null;
-            const urlMatches = opts.url ? makeUrlMatcher(opts.url) : null;
-            const tabId = null != opts.tab && '' !== opts.tab ? Number(opts.tab) : null;
-            return (event)=>{
-                if (!event || 'object' != typeof event) return false;
-                if ('header' === event.type) return false;
-                if (opts.signalsOnly && 'dx.signal' !== event.eventType) return false;
-                if (contexts && !contexts.has(String(event.context))) return false;
-                if ('all' !== minLevel && 'off' !== minLevel) {
-                    if (levelRank(String(event.level || '')) > levelRank(minLevel)) return false;
-                }
-                if (null != sinceSeq && Number.isFinite(sinceSeq) && 'number' == typeof event.seq && event.seq <= sinceSeq) return false;
-                if (urlMatches && !urlMatches(event)) return false;
-                if (null != tabId && Number.isFinite(tabId) && event.tabId !== tabId) return false;
-                return true;
-            };
-        }
-        function resolveFormat(opts) {
-            if (opts.output) return opts.output;
-            return process.stdout.isTTY ? 'pretty' : 'ndjson';
-        }
-        function printEvent(event, format) {
-            if ('ndjson' === format) return void console.log(JSON.stringify(event));
-            if ('json' === format) return void console.log(JSON.stringify(event, null, 2));
-            const parts = Array.isArray(event.messageParts) ? event.messageParts.map((p)=>'string' == typeof p ? p : JSON.stringify(p)).join(' ') : '';
-            const code = event.code ? ` ${event.code}` : '';
-            const remediation = event.remediation ? `\n    ↳ ${event.remediation}` : '';
-            console.log(`[${event.seq ?? '-'}] ${String(event.level || 'log').toUpperCase()} (${event.context})${code} ${parts}${remediation}`);
-        }
-        function logs_writeFrame(frame) {
-            try {
-                external_node_fs_default().writeSync(1, `${JSON.stringify(frame)}\n`);
-            } catch  {
-                console.log(JSON.stringify(frame));
-            }
-        }
-        function logsFilePath(projectPath, browser) {
-            return external_node_path_default().resolve(projectPath, 'dist', 'extension-js', browser, 'logs.ndjson');
-        }
-        function registerLogsCommand(program) {
-            program.command('logs').arguments('[project-path]').usage('[project-path] [options]').description(commandDescriptions.logs).option('--browser <chrome | chromium | edge | firefox>', 'which dist/extension-js/<browser> to read. Defaults to `chromium`').option('--follow', 'stream live via the control channel instead of printing and exiting').option('--context <list>', 'comma-separated contexts (background, content, popup, options, sidebar, devtools, page)').option('--level <off|error|warn|info|debug|trace|all>', 'minimum severity to show. Defaults to `all`').option('--signals-only', 'show only structured dx.signal diagnostics').option('--since <seq|iso>', 'only show events after this sequence number').option('--url <glob|substring>', 'only events whose url/hostname matches (glob with * or plain substring)').option('--tab <id>', 'only events from this tab id').option('--output <pretty|json|ndjson>', 'output format. Defaults to pretty on a TTY, ndjson when piped').action(async (projectPathArg, options)=>{
-                const projectPath = external_node_path_default().resolve(projectPathArg || process.cwd());
-                const browser = options.browser || 'chromium';
-                const format = resolveFormat(options);
-                const matches = makeFilter(options);
-                if (options.follow) return void await followLogs(projectPath, browser, format, matches);
-                const file = logsFilePath(projectPath, browser);
-                if (!external_node_fs_default().existsSync(file)) {
-                    const message = `No logs found at ${file}. Start a dev session (extension dev) first, or pass --browser to match it.`;
-                    console.error(message);
-                    if ('pretty' !== format) logs_writeFrame(messaging.Pr.fail('logs', 'not-found', {
-                        code: messaging.Lp.E_LOGS_NOT_FOUND,
-                        message,
-                        name: 'CliError'
-                    }));
-                    process.exit(1);
-                }
-                const lines = external_node_fs_default().readFileSync(file, 'utf-8').split('\n').filter(Boolean);
-                for (const line of lines){
-                    let event;
-                    try {
-                        event = JSON.parse(line);
-                    } catch  {
-                        continue;
-                    }
-                    if (matches(event)) printEvent(event, format);
-                }
-            });
-        }
-        async function followLogs(projectPath, browser, format, matches) {
-            const { BridgeConsumer, readReadyContract } = await loadExtensionDevelopBridgeModule();
-            const ready = readReadyContract(projectPath, browser);
-            if (!ready) {
-                const message = `No active dev session control channel found for ${browser}. Run \`extension dev --browser=${browser}\` first.`;
-                console.error(message);
-                if ('pretty' !== format) logs_writeFrame(messaging.Pr.fail('logs', 'not-found', {
-                    code: messaging.Lp.E_SESSION_NOT_FOUND,
-                    message,
-                    name: 'CliError'
-                }));
-                process.exit(1);
-            }
-            const consumer = new BridgeConsumer({
-                controlPort: ready.controlPort,
-                instanceId: ready.instanceId,
-                reconnect: true,
-                onLog: (event)=>{
-                    if (matches(event)) printEvent(event, format);
-                },
-                onGap: (gap)=>{
-                    console.error(`… ${gap.dropped} event(s) dropped (${gap.reason}), stream is behind`);
-                }
-            });
-            const shutdown = (signal)=>{
-                consumer.close();
-                if ('pretty' !== format) console.log(JSON.stringify(messaging.Pr.ok('logs', 'interrupted', {
-                    signal,
-                    follow: true
-                })));
-                exitAfterDrain(0);
-            };
-            process.on('SIGINT', ()=>shutdown('SIGINT'));
-            process.on('SIGTERM', ()=>shutdown('SIGTERM'));
-            consumer.start();
-            await new Promise(()=>{});
-        }
         var run_only = __webpack_require__("./browsers/run-only.ts");
         const PREVIEW_NOT_FOUND_NEEDLES = [
             'Preview is run-only',
             'Manifest file not found'
         ];
         function registerPreviewCommand(program) {
-            program.command('preview').arguments('[project-name]').usage('[path-to-remote-extension] [options]').description(commandDescriptions.preview).addHelpText('after', '\nAdditional option:\n  --no-browser    do not launch the browser\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('--browser <chrome | chromium | edge | firefox | chromium-based | gecko-based | firefox-based>', 'specify a browser/engine to run. Defaults to `chromium`').option('--chromium-binary <path-to-binary>', 'specify a path to the Chromium binary. This option overrides the --browser setting. Defaults to the system default').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('--starting-url <url>', 'specify the starting URL for the browser. Defaults to `undefined`').option('--port <port>', 'specify the port to use for the development server. Defaults to `8080`').option('--log-context <list>', '[experimental] comma-separated contexts to include (background,content,page,sidebar,popup,options,devtools). Use `all` to include all contexts (default)').option('--logs <off|error|warn|info|debug|trace|all>', '[experimental] minimum centralized logger level to display in terminal (default: off)').option('--log-format <pretty|json|ndjson>', '[experimental] output format for logger events. Defaults to `pretty`').option('--no-log-timestamps', 'disable ISO timestamps in pretty output').option('--no-log-color', 'disable color in pretty output').option('--log-url <pattern>', '[experimental] only show logs where event.url matches this substring or regex (/re/i)').option('--log-tab <id>', 'only show logs for a specific tabId (number)').option('--extensions <list>', 'comma-separated list of companion extensions or store URLs to load').option('--output <pretty|json>', 'result format. Use json for a schema-1 envelope on stdout').addOption(new external_commander_namespaceObject.Option('--debug', 'print maintainer diagnostics alongside normal output')).addOption(new external_commander_namespaceObject.Option('--author, --author-mode', 'deprecated alias for --debug').hideHelp()).action(async (pathOrRemoteUrl, options, command)=>{
+            program.command('preview').arguments('[project-name]').usage('[path-to-remote-extension] [options]').description(commandDescriptions.preview).addHelpText('after', '\nAdditional option:\n  --no-browser    do not launch the browser\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(`--browser <${NO_SAFARI_BROWSER_TARGETS_HELP}>`, 'specify a browser/engine to run. Defaults to `chromium`').option('--chromium-binary <path-to-binary>', 'specify a path to the Chromium binary. This option overrides the --browser setting. Defaults to the system default').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('--starting-url <url>', 'specify the starting URL for the browser. Defaults to `undefined`').option('--port <port>', 'specify the port to use for the development server. Defaults to `8080`').option('--log-context <list>', '[experimental] comma-separated contexts to include (background,content,page,sidebar,popup,options,devtools). Use `all` to include all contexts (default)').option('--logs <off|error|warn|info|debug|trace|all>', '[experimental] minimum centralized logger level to display in terminal (default: off)').option('--log-format <pretty|json|ndjson>', '[experimental] output format for logger events. Defaults to `pretty`').option('--no-log-timestamps', 'disable ISO timestamps in pretty output').option('--no-log-color', 'disable color in pretty output').option('--log-url <pattern>', '[experimental] only show logs where event.url matches this substring or regex (/re/i)').option('--log-tab <id>', 'only show logs for a specific tabId (number)').option('--extensions <list>', 'comma-separated list of companion extensions or store URLs to load').option('--output <pretty|json>', 'result format. Use json for a schema-1 envelope on stdout').addOption(new external_commander_namespaceObject.Option('--debug', 'print maintainer diagnostics alongside normal output')).addOption(new external_commander_namespaceObject.Option('--author, --author-mode', 'deprecated alias for --debug').hideHelp()).action(async (pathOrRemoteUrl, options, command)=>{
                 const { browser = 'chromium', ...previewOptions } = options;
                 if (previewOptions.debug || previewOptions.author || previewOptions.authorMode) {
                     process.env.EXTENSION_DEBUG = '1';
@@ -9496,7 +9539,7 @@ Cross-browser compatibility
             return Number.isFinite(parsed) && parsed >= 0 ? Math.floor(parsed) : 8080;
         }
         function registerStartCommand(program) {
-            program.command('start').arguments('[project-path|remote-url]').usage('[project-path|remote-url] [options]').description(commandDescriptions.start).addHelpText('after', '\nAdditional options:\n  --no-browser    do not launch the browser (build still runs)\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('--browser <chrome | chromium | edge | firefox | chromium-based | gecko-based | firefox-based>', 'specify a browser/engine to run. Defaults to `chromium`').option('--polyfill [boolean]', 'whether or not to apply the cross-browser polyfill. Defaults to `true`', parseOptionalBoolean).option('--no-polyfill', 'disable the cross-browser polyfill').option('--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('--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]', '[experimental] install project dependencies when missing', parseOptionalBoolean).option('--wait [boolean]', 'wait for dist/extension-js/<browser>/ready.json and exit', parseOptionalBoolean).option('--wait-timeout <ms>', 'timeout in milliseconds when using --wait (default: 60000)').option('--output <pretty|json>', 'result format. Use json for a schema-1 envelope on stdout').addOption(new external_commander_namespaceObject.Option('--wait-format <pretty|json>').hideHelp()).addOption(new external_commander_namespaceObject.Option('--debug', 'print maintainer diagnostics alongside normal output')).addOption(new external_commander_namespaceObject.Option('--author, --author-mode', 'deprecated alias for --debug').hideHelp()).action(async (pathOrRemoteUrl, options, command)=>{
+            program.command('start').arguments('[project-path|remote-url]').usage('[project-path|remote-url] [options]').description(commandDescriptions.start).addHelpText('after', '\nAdditional options:\n  --no-browser    do not launch the browser (build still runs)\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(`--browser <${NO_SAFARI_BROWSER_TARGETS_HELP}>`, 'specify a browser/engine to run. Defaults to `chromium`').option('--polyfill [boolean]', 'whether or not to apply the cross-browser polyfill. Defaults to `true`', parseOptionalBoolean).option('--no-polyfill', 'disable the cross-browser polyfill').option('--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('--starting-url <url>', 'specify the starting URL for the browser. Defaults to `undefined`').option('--port <port>', 'specify the port to use for the development server. Defaults to `8080`').option('--host <host>', 'specify the host to bind the dev server to. Use 0.0.0.0 for Docker/devcontainers. Defaults to `127.0.0.1`').option('--public-host <host>', 'connectable host the browser (HMR + reload bridge) dials when it differs from the bind host (e.g. a remote/devcontainer). Defaults to the bind host, or 127.0.0.1 when bound to 0.0.0.0').option('--log-context <list>', '[experimental] comma-separated contexts to include (background,content,page,sidebar,popup,options,devtools). Use `all` to include all contexts (default)').option('--logs <off|error|warn|info|debug|trace|all>', '[experimental] minimum centralized logger level to display in terminal (default: off)').option('--log-format <pretty|json|ndjson>', '[experimental] output format for logger events. Defaults to `pretty`').option('--no-log-timestamps', 'disable ISO timestamps in pretty output').option('--no-log-color', 'disable color in pretty output').option('--log-url <pattern>', '[experimental] only show logs where event.url matches this substring or regex (/re/i)').option('--log-tab <id>', 'only show logs for a specific tabId (number)').option('--extensions <list>', 'comma-separated list of companion extensions or store URLs to load').option('--install [boolean]', '[internal] install project dependencies when missing', parseOptionalBoolean).option('--wait [boolean]', 'wait for dist/extension-js/<browser>/ready.json and exit', parseOptionalBoolean).option('--wait-timeout <ms>', 'timeout in milliseconds when using --wait (default: 60000)').option('--output <pretty|json>', 'result format. Use json for a schema-1 envelope on stdout').addOption(new external_commander_namespaceObject.Option('--wait-format <pretty|json>').hideHelp()).addOption(new external_commander_namespaceObject.Option('--debug', 'print maintainer diagnostics alongside normal output')).addOption(new external_commander_namespaceObject.Option('--author, --author-mode', 'deprecated alias for --debug').hideHelp()).action(async (pathOrRemoteUrl, options, command)=>{
                 const { browser = 'chromium', ...startOptions } = options;
                 if (startOptions.debug || startOptions.author || startOptions.authorMode) {
                     process.env.EXTENSION_DEBUG = '1';

package/dist/extension/browsers/run-firefox/firefox-types.d.ts

@@ -6,6 +6,9 @@ export type FirefoxPluginLike = Pick<PluginInterface, 'extension' | 'browserFlag
 export interface FirefoxPluginRuntime extends FirefoxPluginLike {
     rdpController?: FirefoxRDPController;
     browserVersionLine?: string;
+    launchProfilePath?: string;
+    launchBinaryPath?: string;
+    launchBinaryProvenance?: 'managed' | 'pinned' | 'system' | 'snapshot';
     logSink?: BrowserLogSink;
     extensionLoadRefused?: string;
     retryAddonInstall?: () => Promise<ExtensionLoadRetryResult>;

package/dist/extension/browsers/run-firefox/rdp/rdp-extension-controller/index.d.ts

@@ -12,6 +12,9 @@ type PluginLike = {
     watchSource?: boolean;
     port?: number | string;
     browserVersionLine?: string;
+    launchProfilePath?: string;
+    launchBinaryPath?: string;
+    launchBinaryProvenance?: 'managed' | 'pinned' | 'system' | 'snapshot';
 };
 export declare class FirefoxRDPController {
     private readonly remote;

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

@@ -1,4 +1,8 @@
-export declare function printRunningInDevelopmentSummary(candidateAddonPaths: string[], browser: 'firefox', extensionId?: string, browserVersionLine?: string): Promise<boolean>;
+export declare function printRunningInDevelopmentSummary(candidateAddonPaths: string[], browser: 'firefox', extensionId?: string, browserVersionLine?: string, launchIdentity?: {
+    profilePath?: string;
+    binaryPath?: string;
+    binaryProvenance?: 'managed' | 'pinned' | 'system' | 'snapshot';
+}): Promise<boolean>;
 export declare function printLogEventPretty(event: {
     id: string;
     timestamp: number;

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

@@ -13,6 +13,9 @@ export declare class RemoteFirefox {
     constructor(configOptions: PluginInterface & {
         browserVersionLine?: string;
         resolvedRdpPort?: number;
+        launchProfilePath?: string;
+        launchBinaryPath?: string;
+        launchBinaryProvenance?: 'managed' | 'pinned' | 'system' | 'snapshot';
     });
     private resolveRdpPort;
     private connectClient;

package/dist/extension/browsers/run-safari/safari-packager.d.ts

@@ -16,6 +16,8 @@ export interface SafariPackagerOverrides {
 export interface SafariPackagerOptions extends SafariPackagerOverrides {
     /** 'safari' or 'webkit-based'. Defaults to 'safari'. */
     browser?: 'safari' | 'webkit-based';
+    /** Print the dev identity card and ready line after the first full package. */
+    announceDevReady?: boolean;
     /** Skip opening the packaged app. Defaults to true: packaging is not launching. */
     noOpen?: boolean;
     /** Print the commands instead of running them. */

package/dist/extension/browsers/run-safari/safari-types.d.ts

@@ -6,6 +6,7 @@ export type SafariPluginLike = Pick<PluginInterface, 'extension' | 'noOpen' | 'i
     bundleId?: string;
     macOsOnly?: boolean;
     forceRegenerate?: boolean;
+    announceDevReady?: boolean;
 };
 export interface SafariBuildConfig {
     extensionDir: string;

package/dist/extension/commands/logs.d.ts

@@ -1,2 +1,16 @@
 import type { Command } from 'commander';
+export interface LogEventLike {
+    type?: unknown;
+    eventType?: unknown;
+    context?: unknown;
+    level?: unknown;
+    seq?: unknown;
+    url?: unknown;
+    hostname?: unknown;
+    tabId?: unknown;
+    messageParts?: unknown;
+    code?: unknown;
+    remediation?: unknown;
+}
+export declare function formatPrettyLogLine(event: LogEventLike): string;
 export declare function registerLogsCommand(program: Command): void;

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

@@ -231,7 +231,7 @@ export type ProgramAIHelpJSON = {
             summary: string;
             templates: string[];
         }>;
-        aliases: Array<{
+        aliases?: Array<{
             name: string;
             resolvesTo: string;
             note: string;

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

@@ -1,5 +1,8 @@
 export type Browser = 'chrome' | 'edge' | 'firefox' | 'chromium' | 'chromium-based' | 'gecko-based' | 'firefox-based' | 'safari' | 'webkit-based';
 export declare function isSafariVendor(value: string): boolean;
+export declare const SUPPORTED_BROWSER_TARGETS: string[];
+export declare const BROWSER_TARGETS_HELP: string;
+export declare const NO_SAFARI_BROWSER_TARGETS_HELP: string;
 export declare function parseOptionalBoolean(value?: string): boolean;
 export declare const vendors: (browser?: Browser | 'all') => string[];
 export declare const installTargets: (browser?: Browser | 'all') => string[];

package/package.json

@@ -38,7 +38,7 @@
     "extension": "./bin/extension.cjs"
   },
   "name": "extension",
-  "version": "4.0.28",
+  "version": "4.0.29-next.0",
   "description": "The cross-browser extension framework. Build Chrome, Edge, Firefox, and Safari extensions with no build configuration.",
   "homepage": "https://extension.js.org/",
   "bugs": {
@@ -106,9 +106,9 @@
     "vivaldi-location2": "2.1.1",
     "waterfox-location": "2.1.1",
     "yandex-location": "2.1.1",
-    "extension-create": "4.0.28",
-    "extension-develop": "4.0.28",
-    "extension-install": "4.0.28",
+    "extension-create": "4.0.29-next.0",
+    "extension-develop": "4.0.29-next.0",
+    "extension-install": "4.0.29-next.0",
     "commander": "^15.0.0",
     "pintor": "0.3.0",
     "semver": "^7.7.3",