extension-develop 4.1.31 → 4.1.32

package/dist/{896~0.mjs → 469~0.mjs}

@@ -1,13 +1,11 @@
 import { createRequire as __extjsCreateRequire } from "node:module"; const require = __extjsCreateRequire(import.meta.url);
-import { createRequire } from "node:module";
 import pintor from "pintor";
-import { spawnSync } from "node:child_process";
 import { findNearestDenoConfigSync, validateDenoConfig, PROJECT_MANIFEST_FILENAMES, readProjectDependencies } from "./731~0.mjs";
 import { isEmulatorLaneEnabled, isEmulatorBrowser, parseJsonSafe } from "./937~0.mjs";
-import { browserRowValue, stripChannelPrefix, ENVELOPE, CODES, artifactNoun, prefix as messaging_prefix, card, fmt, isDebug, isMachineOutput, hasChannelPrefix } from "./852~0.mjs";
+import { stripChannelPrefix, artifactNoun, prefix as messaging_prefix, CODES, humanLine, fmt, isDebug, hasChannelPrefix } from "./852~0.mjs";
 import * as __rspack_external_node_fs_1b05aee1 from "node:fs";
-import * as __rspack_external_node_path_806ed179 from "node:path";
 import * as __rspack_external_node_os_4f3c9d58 from "node:os";
+import * as __rspack_external_node_path_806ed179 from "node:path";
 function asAbsolute(p) {
     return __rspack_external_node_path_806ed179.isAbsolute(p) ? p : __rspack_external_node_path_806ed179.resolve(p);
 }
@@ -192,424 +190,42 @@ function devtoolsEngineFor(browser) {
             return 'chrome';
     }
 }
-const cjsRequire = createRequire(import.meta.url);
-function getLoggingPrefix(type) {
-    return messaging_prefix(type);
-}
-function messages_ready(mode, browser) {
-    const noun = artifactNoun(browser);
-    const state = pintor.green(`ready for ${mode}`);
-    const watching = 'development' === mode ? ' Watching for file changes.' : '';
-    return `${getLoggingPrefix('success')} ${noun} ${state}.${watching}`;
-}
-function readJsonRecord(filePath) {
-    try {
-        return JSON.parse(__rspack_external_node_fs_1b05aee1.readFileSync(filePath, 'utf8'));
-    } catch  {
-        return null;
-    }
-}
-function capitalizeToken(value) {
-    if ('chromium-emulator' === value) return 'Emulated Chromium';
-    return value.split('-').filter(Boolean).map((token)=>token.charAt(0).toUpperCase() + token.slice(1)).join('-');
-}
-function getExtensionVersion() {
-    return process.env.EXTENSION_DEVELOP_VERSION || process.env.EXTENSION_CLI_VERSION || (()=>{
+function listOutputFiles(outputPath) {
+    const files = [];
+    const pending = [
+        ''
+    ];
+    while(pending.length){
+        const relativeDir = pending.pop();
+        let entries = [];
         try {
-            return cjsRequire('../package.json').version;
+            entries = __rspack_external_node_fs_1b05aee1.readdirSync(__rspack_external_node_path_806ed179.join(outputPath, relativeDir), {
+                withFileTypes: true
+            });
         } catch  {
-            return 'unknown';
+            continue;
         }
-    })();
-}
-function browserRunnerDisabled(args) {
-    const manifest = readJsonRecord(args.manifestPath);
-    const ready = readJsonRecord(args.readyPath);
-    const browserLabel = capitalizeToken(String(args.browser || 'unknown'));
-    const runId = String(ready?.runId || '').trim();
-    const pid = Number.isInteger(ready?.pid) ? String(ready?.pid) : '';
-    const runLabel = runId ? `${runId}${pid ? ` · PID ${pid}` : ''}` : pid ? `PID ${pid}` : '';
-    const extensionName = String(manifest?.name || 'Extension');
-    const extensionVersion = String(manifest?.version || '').trim();
-    const extensionLabel = extensionVersion ? `${extensionName} ${extensionVersion}` : extensionName;
-    const extensionJsVersion = getExtensionVersion();
-    const updateSuffix = process.env.EXTENSION_CLI_UPDATE_SUFFIX || '';
-    if (updateSuffix) delete process.env.EXTENSION_CLI_UPDATE_SUFFIX;
-    return card({
-        version: extensionJsVersion,
-        suffix: updateSuffix,
-        rows: [
-            {
-                label: 'Browser',
-                value: browserRowValue(String(args.browser || 'unknown'), `${browserLabel} (no-browser mode)`)
-            },
-            {
-                label: 'Extension',
-                value: extensionLabel
-            },
-            {
-                label: 'Run ID',
-                value: runLabel
-            },
-            {
-                label: 'Output',
-                value: collapseHomeDir(String(args.distPath || '').trim())
-            }
-        ]
-    });
-}
-function shouldWarnPortConflict(requested, actual) {
-    const requestedPort = Number(requested);
-    return Number.isFinite(requestedPort) && 0 !== requestedPort && requestedPort !== actual;
-}
-function emulatorViewerUrl(url) {
-    return `${getLoggingPrefix('info')} Emulated Chromium runs in a web page. Open this address to load your extension:\n${pintor.underline(url)}`;
-}
-function portInUse(requestedPort, newPort) {
-    return `${getLoggingPrefix('warn')} Port ${requestedPort} is in use.\nThe dev server listens on port ${newPort} instead.`;
-}
-function devServerHostRefused(host) {
-    const name = host || 'an empty Host header';
-    return `${getLoggingPrefix('warn')} The dev server refused a request for the host ${pintor.yellow(name)}.\nAllow it with ${pintor.blue(`--allowed-hosts ${host || '<host>'}`)} or ${pintor.blue('commands.dev.allowedHosts')} in extension.config.js. Both take more than one host, comma-separated on the flag.`;
-}
-function controlBridgeUnavailable(reason) {
-    return `${getLoggingPrefix('error')} Extension.js couldn't open the control port.\n${pintor.red(reason)}\nSaves will compile but nothing reloads in the browser. Restart the dev session, and if you passed --host make sure it is an address this machine can listen on.`;
-}
-function extensionJsRunnerError(error) {
-    return `${getLoggingPrefix('error')} Extension.js couldn't start the runner.\n${pintor.red(String(error))}`;
-}
-function autoExitModeEnabled(ms) {
-    return `${getLoggingPrefix('info')} Auto-exit is enabled.\nThe process exits after ${ms} ms of idle time.`;
-}
-function autoExitTriggered(ms) {
-    return `${getLoggingPrefix('info')} Auto-exit triggered after ${ms} ms.\nThe process cleans up and exits now.`;
-}
-function autoExitForceKill(ms) {
-    return `${getLoggingPrefix('warn')} The process didn't exit within ${ms} ms, so it exits forcibly now.`;
-}
-function devServerStartTimeout(ms) {
-    return [
-        `${getLoggingPrefix('warn')} The dev server didn't start within ${ms} ms.`,
-        "The bundler may have hit an error before emitting the first build.",
-        `If nothing else prints, set ${pintor.blue('EXTENSION_VERBOSE=1')} to see more logs.`
-    ].join('\n');
-}
-function manifestGoneDuringSession(manifestPath, projectDirGone) {
-    const what = projectDirGone ? 'The project directory disappeared during the session.' : 'The manifest.json file disappeared during the session.';
-    const where = projectDirGone ? __rspack_external_node_path_806ed179.dirname(manifestPath) : manifestPath;
-    return `${getLoggingPrefix('error')} ${what}\n${pintor.gray('NOT FOUND')} ${pintor.underline(collapseHomeDir(where))}\nThe last good build stays loaded. Restore it to keep working, or stop and run ${pintor.blue('extension dev')} again with the right path.`;
-}
-function bundlerFatalError(error) {
-    const text = error instanceof Error ? error.stack || error.message : String(error);
-    return `${getLoggingPrefix('error')} The build failed to start.\n${pintor.red(text)}`;
-}
-function devServerRestarting(request) {
-    const what = 'icons' === request.reason ? 'a manifest icon' : 'html' === request.reason ? 'an HTML entrypoint' : 'json' === request.reason ? 'a manifest JSON entry' : 'env' === request.reason ? 'an environment file' : "a manifest script entry";
-    const lines = [
-        `${getLoggingPrefix('info')} Restarting the dev server to pick up ${what} change…`
-    ];
-    if (request.pathChanged) lines.push(`${pintor.gray('CHANGED')} ${pintor.underline(displayPath(request.pathChanged))}`);
-    if (request.pathBefore) lines.push(`${pintor.gray('BEFORE')} ${pintor.underline(request.pathBefore)}`);
-    if (request.pathAfter) lines.push(`${pintor.gray('AFTER')} ${pintor.underline(request.pathAfter)}`);
-    return lines.join('\n');
-}
-function bundlerRecompiling() {
-    return `${getLoggingPrefix('info')} Recompiling due to file changes…`;
-}
-function noEntrypointsDetected(port) {
-    return [
-        `${getLoggingPrefix('warn')} The first compilation produced no entrypoints or assets.`,
-        `The dev server is running on 127.0.0.1:${port}, but nothing is being built.`,
-        "Possible causes:",
-        "- Empty or missing entry configuration.",
-        "- Extension plugins are disabled, so entries aren't derived from the manifest.",
-        "- All sources are ignored or excluded.",
-        `Set ${pintor.blue('EXTENSION_VERBOSE=1')} to see verbose logs, or review your extension config.`
-    ].join('\n');
-}
-function spacerLine() {
-    return ' ';
-}
-function runnerCleanupError(error) {
-    return `${messaging_prefix('error')} The dev server could not shut down cleanly: ${String(error?.message || error)}`;
-}
-function runnerUncaughtException(error) {
-    return `${messaging_prefix('error')} Uncaught exception in the dev server: ${String(error?.message || error)}`;
-}
-function runnerUnhandledRejection(reason) {
-    return `${messaging_prefix('error')} Unhandled rejection in the dev server: ${String(reason?.message || reason)}`;
-}
-const MAX_OUTPUT_CHARS = 2000;
-const ANSI_PATTERN = /\u001b\[[0-9;]*m/g;
-function isLifecycleStreamEnabled() {
-    return isMachineOutput();
-}
-function humanLine(line) {
-    if (isMachineOutput()) return void process.stderr.write(`${line}\n`);
-    console.log(line);
-}
-function stripAnsi(input) {
-    return String(input || '').replace(ANSI_PATTERN, '');
-}
-function readReadyContract(readyPath) {
-    if (!readyPath) return null;
-    try {
-        const parsed = JSON.parse(__rspack_external_node_fs_1b05aee1.readFileSync(readyPath, 'utf-8'));
-        return parsed && 'object' == typeof parsed ? parsed : null;
-    } catch  {
-        return null;
-    }
-}
-function isProfileLocked(ready) {
-    if (!ready) return false;
-    const code = String(ready.code ?? '').trim().toLowerCase();
-    if ('profile_locked' === code || 'profile-locked' === code) return true;
-    if (true === ready.profileLocked) return true;
-    const message = String(ready.message ?? '');
-    return /profile\s+is\s+locked|singletonlock/i.test(message);
-}
-function toFiniteNumber(value) {
-    if ('number' == typeof value && Number.isFinite(value)) return value;
-    if ('string' == typeof value) {
-        const parsed = Number.parseInt(value, 10);
-        return Number.isFinite(parsed) ? parsed : null;
-    }
-    return null;
-}
-class LifecycleStream {
-    options;
-    writeLine;
-    successfulCompiles = 0;
-    compileAttempts = 0;
-    readyEmitted = false;
-    readyErrorEmitted = false;
-    browserExitEmitted = false;
-    boundPort = null;
-    exitWatcher;
-    launchFailureWatcher;
-    constructor(options){
-        this.options = options;
-        this.writeLine = options.write || ((line)=>process.stdout.write(line));
-    }
-    get enabled() {
-        return isLifecycleStreamEnabled();
-    }
-    emit(frame) {
-        if (!this.enabled) return null;
-        this.writeLine(`${JSON.stringify(frame)}\n`);
-        return frame;
-    }
-    sessionValue(extra = {}) {
-        const ready = readReadyContract(this.options.readyPath);
-        const port = toFiniteNumber(ready?.port) ?? this.boundPort;
-        return {
-            command: this.options.command,
-            browser: this.options.browser,
-            distPath: this.options.distPath,
-            pid: process.pid,
-            port,
-            ...this.options.readyPath ? {
-                readyPath: this.options.readyPath
-            } : {},
-            ...this.options.eventsPath ? {
-                eventsPath: this.options.eventsPath
-            } : {},
-            ...'string' == typeof ready?.runId ? {
-                runId: ready.runId
-            } : {},
-            ...'string' == typeof ready?.instanceId ? {
-                instanceId: ready.instanceId
-            } : {},
-            ...'string' == typeof ready?.toolchainVersion ? {
-                toolchainVersion: ready.toolchainVersion
-            } : {},
-            ...extra
-        };
-    }
-    starting(args) {
-        const requestedPort = toFiniteNumber(args.requestedPort);
-        const port = toFiniteNumber(args.port);
-        this.boundPort = port;
-        const reassigned = null !== port && shouldWarnPortConflict(requestedPort, port);
-        return this.emit(ENVELOPE.ok(this.options.command, 'starting', this.sessionValue({
-            requestedPort,
-            port
-        }), {
-            warnings: reassigned ? [
-                `${CODES.E_PORT_IN_USE}: port ${requestedPort} was taken, so the dev server listens on port ${port}`
-            ] : []
-        }));
-    }
-    compiled(args) {
-        this.compileAttempts += 1;
-        this.successfulCompiles += 1;
-        const status = 1 === this.successfulCompiles ? 'compiled' : 'recompiled';
-        return this.emit(ENVELOPE.ok(this.options.command, status, this.sessionValue({
-            assets: toFiniteNumber(args.assets) ?? 0,
-            durationMs: toFiniteNumber(args.durationMs) ?? 0
-        })));
-    }
-    compileFailed(args) {
-        this.compileAttempts += 1;
-        const isFirst = 1 === this.compileAttempts;
-        const code = isFirst ? CODES.E_FIRST_COMPILE : CODES.E_COMPILE;
-        const raw = stripAnsi(String(args.output || ''));
-        const truncated = raw.length > MAX_OUTPUT_CHARS;
-        const output = truncated ? `${raw.slice(0, MAX_OUTPUT_CHARS)}…` : raw;
-        const message = args.message || (isFirst ? 'The first compilation failed.' : 'A recompilation failed after a change.');
-        const frame = ENVELOPE.fail(this.options.command, 'compile-failed', {
-            code,
-            message
-        }, {
-            truncated
-        });
-        frame.value = this.sessionValue({
-            output,
-            durationMs: toFiniteNumber(args.durationMs) ?? 0
-        });
-        return this.emit(frame);
-    }
-    ready(args = {}) {
-        if (this.readyEmitted) return null;
-        if (null != args.port) this.boundPort = toFiniteNumber(args.port);
-        const ready = readReadyContract(this.options.readyPath);
-        if (ready && 'error' === ready.status) {
-            if (this.readyErrorEmitted) return null;
-            this.readyErrorEmitted = true;
-            const badPin = 'browser_launch_failed' === ready.code && ready.browserLaunchFailedCode === CODES.E_BROWSER_BINARY_INVALID;
-            const frame = ENVELOPE.fail(this.options.command, badPin ? 'usage' : 'failed', {
-                code: badPin ? CODES.E_BROWSER_BINARY_INVALID : CODES.E_READY_ERROR_STATUS,
-                message: String(ready.message || '') || 'The ready contract reports an error for this session.'
-            });
-            frame.value = this.sessionValue({
-                ...'string' == typeof ready.code ? {
-                    readyCode: ready.code
-                } : {}
+        for (const entry of entries)try {
+            const name = relativeDir ? `${relativeDir}/${entry.name}` : entry.name;
+            if (entry.isDirectory()) pending.push(name);
+            else if (entry.isFile()) files.push({
+                name,
+                size: __rspack_external_node_fs_1b05aee1.statSync(__rspack_external_node_path_806ed179.join(outputPath, name)).size
             });
-            return this.emit(frame);
-        }
-        this.readyEmitted = true;
-        return this.emit(ENVELOPE.ok(this.options.command, 'ready', this.sessionValue()));
-    }
-    browserExited(args = {}) {
-        if (this.browserExitEmitted) return null;
-        this.browserExitEmitted = true;
-        const ready = readReadyContract(this.options.readyPath);
-        const locked = isProfileLocked(ready);
-        const code = locked ? CODES.E_PROFILE_LOCKED : CODES.E_BROWSER_LAUNCH;
-        const message = args.message || String(ready?.message || '') || (locked ? 'The browser profile is locked by another session.' : 'The browser exited before the session ended.');
-        const frame = ENVELOPE.fail(this.options.command, 'browser-exited', {
-            code,
-            message
-        });
-        frame.value = this.sessionValue({
-            exitCode: toFiniteNumber(args.exitCode) ?? toFiniteNumber(ready?.browserExitCode),
-            ...'string' == typeof ready?.browserExitSignal ? {
-                exitSignal: ready.browserExitSignal
-            } : {},
-            ...'string' == typeof ready?.browserExitedAt ? {
-                browserExitedAt: ready.browserExitedAt
-            } : {}
-        });
-        return this.emit(frame);
-    }
-    failed(message) {
-        const frame = ENVELOPE.fail(this.options.command, 'failed', {
-            code: CODES.E_DEV_SERVER_START,
-            message: stripAnsi(message)
-        });
-        frame.value = this.sessionValue();
-        return this.emit(frame);
-    }
-    watchBrowserExit(intervalMs = 1000, onExit) {
-        const stop = ()=>{
-            if (this.exitWatcher) clearInterval(this.exitWatcher);
-            this.exitWatcher = void 0;
-        };
-        if (!this.options.readyPath) return stop;
-        if (!this.enabled && !onExit) return stop;
-        if (this.exitWatcher) return stop;
-        this.exitWatcher = setInterval(()=>{
-            const ready = readReadyContract(this.options.readyPath);
-            if ('string' != typeof ready?.browserExitedAt) return;
-            onExit?.(ready);
-            this.browserExited();
-            stop();
-        }, intervalMs);
-        this.exitWatcher.unref?.();
-        return stop;
-    }
-    watchBrowserLaunchFailure(intervalMs = 1000, onFailure) {
-        const stop = ()=>{
-            if (this.launchFailureWatcher) clearInterval(this.launchFailureWatcher);
-            this.launchFailureWatcher = void 0;
-        };
-        if (!this.options.readyPath) return stop;
-        if (this.launchFailureWatcher) return stop;
-        this.launchFailureWatcher = setInterval(()=>{
-            const ready = readReadyContract(this.options.readyPath);
-            if ('string' != typeof ready?.browserLaunchFailedAt) return;
-            onFailure(ready);
-            stop();
-        }, intervalMs);
-        this.launchFailureWatcher.unref?.();
-        return stop;
-    }
-}
-function createLifecycleStream(options) {
-    return new LifecycleStream(options);
-}
-function assetCount(stats) {
-    const compilation = stats?.compilation;
-    try {
-        const assets = compilation?.getAssets?.();
-        if (Array.isArray(assets)) return assets.length;
-    } catch  {}
-    return Object.keys(compilation?.assets || {}).length;
-}
-function compileDuration(stats) {
-    const compilation = stats?.compilation;
-    const start = Number(compilation?.startTime || 0);
-    const end = Number(compilation?.endTime || 0);
-    const duration = end - start;
-    return Number.isFinite(duration) && duration > 0 ? duration : 0;
-}
-function errorText(stats) {
-    try {
-        return String(stats?.toString?.({
-            all: false,
-            errors: true,
-            colors: false
-        }) || '');
-    } catch  {
-        return '';
+        } catch  {}
     }
+    return files.sort((a, b)=>a.name < b.name ? -1 : a.name > b.name ? 1 : 0);
 }
-function attachLifecycleStream(compiler, stream) {
-    const hooks = compiler?.hooks;
-    hooks?.done?.tap('extension.js:lifecycle-stream', (stats)=>{
-        try {
-            if (stats?.hasErrors?.()) return void stream.compileFailed({
-                output: errorText(stats),
-                durationMs: compileDuration(stats)
-            });
-            stream.compiled({
-                assets: assetCount(stats),
-                durationMs: compileDuration(stats)
-            });
-            stream.ready();
-        } catch  {}
-    });
-    hooks?.failed?.tap('extension.js:lifecycle-stream', (error)=>{
-        try {
-            stream.compileFailed({
-                output: error instanceof Error ? error.stack || error.message : String(error),
-                message: error instanceof Error ? error.message : String(error)
-            });
-        } catch  {}
-    });
+function foldOutputFiles(files, listedNames) {
+    const listed = new Set(listedNames);
+    const folded = files.filter((file)=>!listed.has(file.name));
+    return {
+        count: folded.length,
+        bytes: folded.reduce((total, file)=>total + file.size, 0),
+        sourceMapsOnly: folded.every((file)=>file.name.endsWith('.map'))
+    };
 }
-function messages_getLoggingPrefix(type) {
+function getLoggingPrefix(type) {
     return messaging_prefix(type);
 }
 function isPathLike(input) {
@@ -619,27 +235,27 @@ function resolvedWorkspaceManifest(projectPath, manifestPath) {
     const manifestDir = __rspack_external_node_path_806ed179.dirname(manifestPath);
     const packageDir = 'src' === __rspack_external_node_path_806ed179.basename(manifestDir) ? __rspack_external_node_path_806ed179.dirname(manifestDir) : manifestDir;
     const display = __rspack_external_node_path_806ed179.relative(projectPath, packageDir) || packageDir;
-    return `${messages_getLoggingPrefix('info')} ${pintor.gray('Workspace root detected.')}\n${pintor.gray('PACKAGE')} ${pintor.underline(display)}`;
+    return `${getLoggingPrefix('info')} ${pintor.gray('Workspace root detected.')}\n${pintor.gray('PACKAGE')} ${pintor.underline(display)}`;
 }
 function declinedProjectRoot(projectManifestPath, manifestPath) {
     const manifestDir = __rspack_external_node_path_806ed179.dirname(manifestPath);
-    return `${messages_getLoggingPrefix('info')} ${pintor.gray(`Using ${__rspack_external_node_path_806ed179.basename(manifestDir)}/ as the project root.`)}\n${pintor.gray('IGNORED')} ${pintor.underline(projectManifestPath)}\n${pintor.gray('That project does not depend on Extension.js, so its dist, its special folders and its dependencies stay out of this build. Add a package.json next to your manifest, or depend on Extension.js there, to use it as the project root.')}`;
+    return `${getLoggingPrefix('info')} ${pintor.gray(`Using ${__rspack_external_node_path_806ed179.basename(manifestDir)}/ as the project root.`)}\n${pintor.gray('IGNORED')} ${pintor.underline(projectManifestPath)}\n${pintor.gray('That project does not depend on Extension.js, so its dist, its special folders and its dependencies stay out of this build. Add a package.json next to your manifest, or depend on Extension.js there, to use it as the project root.')}`;
 }
 function remoteFetchTimedOut(target, ms) {
-    return `${messages_getLoggingPrefix('error')} Timed out after ${Math.round(ms / 1000)} s fetching the remote file.\n${pintor.gray('URL')} ${pintor.underline(target)}\nCheck your network, or set ${pintor.blue('EXTENSION_FETCH_TIMEOUT_MS')} to allow more time.`;
+    return `${getLoggingPrefix('error')} Timed out after ${Math.round(ms / 1000)} s fetching the remote file.\n${pintor.gray('URL')} ${pintor.underline(target)}\nCheck your network, or set ${pintor.blue('EXTENSION_FETCH_TIMEOUT_MS')} to allow more time.`;
 }
 function manifestInvalidJson(manifestPath, error) {
     const detail = error instanceof Error ? error.message : String(error);
-    return `${messages_getLoggingPrefix('error')} Couldn't parse manifest.json as JSON.\n${pintor.gray('PATH')} ${pintor.underline(manifestPath)}\n${pintor.gray('REASON')} ${pintor.red(detail)}\nFix the syntax error, then run the command again.`;
+    return `${getLoggingPrefix('error')} Couldn't parse manifest.json as JSON.\n${pintor.gray('PATH')} ${pintor.underline(manifestPath)}\n${pintor.gray('REASON')} ${pintor.red(detail)}\nFix the syntax error, then run the command again.`;
 }
 function notAnExtensionManifestError(manifestPath) {
-    return `${messages_getLoggingPrefix('error')} manifest.json isn't a browser extension manifest.\nIt has no ${pintor.blue('manifest_version')} field, so it looks like a PWA web-app manifest.\n${pintor.gray('PATH')} ${pintor.underline(manifestPath)}\nPoint Extension.js at the directory that contains your extension manifest.`;
+    return `${getLoggingPrefix('error')} manifest.json isn't a browser extension manifest.\nIt has no ${pintor.blue('manifest_version')} field, so it looks like a PWA web-app manifest.\n${pintor.gray('PATH')} ${pintor.underline(manifestPath)}\nPoint Extension.js at the directory that contains your extension manifest.`;
 }
 function previewHasNothingToRun(manifestAtOutput) {
-    return `${messages_getLoggingPrefix('error')} Preview is run-only and does not compile.\n${pintor.gray('NOT FOUND')} ${pintor.underline(manifestAtOutput)}\nRun ${pintor.blue('extension build')} first, or pass ${pintor.blue('--output-path')} an unpacked extension directory.`;
+    return `${getLoggingPrefix('error')} Preview is run-only and does not compile.\n${pintor.gray('NOT FOUND')} ${pintor.underline(manifestAtOutput)}\nRun ${pintor.blue('extension build')} first, or pass ${pintor.blue('--output-path')} an unpacked extension directory.`;
 }
 function manifestNotFoundError(manifestPath, candidates = []) {
-    const base = `${messages_getLoggingPrefix('error')} Manifest file not found.\n${pintor.gray('NOT FOUND')} ${pintor.underline(manifestPath)}\nEnsure the path to your extension exists, then try again.`;
+    const base = `${getLoggingPrefix('error')} Manifest file not found.\n${pintor.gray('NOT FOUND')} ${pintor.underline(manifestPath)}\nEnsure the path to your extension exists, then try again.`;
     if (!candidates.length) return base;
     const projectRoot = __rspack_external_node_path_806ed179.dirname(manifestPath);
     const hint = 1 === candidates.length ? "Did you mean to point at this workspace package?" : "Did you mean to point at one of these workspace packages?";
@@ -655,63 +271,72 @@ function companionManifestNotProjectError(manifestPath, companionManifestPath) {
     const projectRoot = __rspack_external_node_path_806ed179.dirname(manifestPath);
     const companionDir = __rspack_external_node_path_806ed179.dirname(companionManifestPath);
     const display = __rspack_external_node_path_806ed179.relative(projectRoot, companionDir) || companionDir;
-    return `${messages_getLoggingPrefix('error')} Manifest file not found.\n${pintor.gray('NOT FOUND')} ${pintor.underline(manifestPath)}\nThe only manifest.json here belongs to a companion extension under ${pintor.blue('extensions/')}.\nCompanions load next to your extension and never stand in for it.\n${pintor.gray('COMPANION')} ${pintor.underline(display)}\nAdd a manifest.json at the project root or in ${pintor.blue('src/')}, or point Extension.js at your extension's directory.`;
+    return `${getLoggingPrefix('error')} Manifest file not found.\n${pintor.gray('NOT FOUND')} ${pintor.underline(manifestPath)}\nThe only manifest.json here belongs to a companion extension under ${pintor.blue('extensions/')}.\nCompanions load next to your extension and never stand in for it.\n${pintor.gray('COMPANION')} ${pintor.underline(display)}\nAdd a manifest.json at the project root or in ${pintor.blue('src/')}, or point Extension.js at your extension's directory.`;
 }
 function sessionStateIgnoreAdded(gitignorePath) {
-    return `${messages_getLoggingPrefix('info')} Added .extension-js to ${gitignorePath} so the local session state stays out of commits.`;
+    return `${getLoggingPrefix('info')} Added .extension-js to ${gitignorePath} so the local session state stays out of commits.`;
 }
 function previewingSourceFallback(browser, distDir) {
-    return `${messages_getLoggingPrefix('warn')} No production build found at ${distDir}, previewing the source manifest directory instead.\nRun \`extension build --browser ${String(browser)}\` first to preview the built output.`;
+    return `${getLoggingPrefix('warn')} No production build found at ${distDir}, previewing the source manifest directory instead.\nRun \`extension build --browser ${String(browser)}\` first to preview the built output.`;
 }
 function previewing(browser, noBrowser) {
     const suffix = noBrowser ? ' (no-browser mode)' : '';
-    return `${messages_getLoggingPrefix('info')} Previewing on ${capitalizedBrowserName(browser)}${suffix}.`;
+    return `${getLoggingPrefix('info')} Previewing on ${capitalizedBrowserName(browser)}${suffix}.`;
 }
 function starting(browser, noBrowser) {
     const suffix = noBrowser ? ' (no-browser mode)' : '';
-    return `${messages_getLoggingPrefix('info')} Starting on ${capitalizedBrowserName(browser)}${suffix}.`;
+    return `${getLoggingPrefix('info')} Starting on ${capitalizedBrowserName(browser)}${suffix}.`;
 }
 function extensionLoadRecovered() {
-    return `${messages_getLoggingPrefix('success')} The browser accepted the extension.\nIt's running now.`;
+    return `${getLoggingPrefix('success')} The browser accepted the extension.\nIt's running now.`;
 }
 function extensionLoadStillRefused(reason) {
-    return `${messages_getLoggingPrefix('error')} The browser still refuses to load this extension.\n${pintor.gray('REASON')} ${pintor.red(reason)}`;
+    return `${getLoggingPrefix('error')} The browser still refuses to load this extension.\n${pintor.gray('REASON')} ${pintor.red(reason)}`;
 }
 function browserLaunchFailed(browser, reason) {
-    return `${messages_getLoggingPrefix('error')} ${capitalizedBrowserName(browser)} couldn't start, so the extension isn't running.\n${hasChannelPrefix(reason) ? stripChannelPrefix(reason) : reason}\nThe dev server keeps watching, but nothing will load until this is fixed.`;
+    return `${getLoggingPrefix('error')} ${capitalizedBrowserName(browser)} couldn't start, so the extension isn't running.\n${hasChannelPrefix(reason) ? stripChannelPrefix(reason) : reason}\nThe dev server keeps watching, but nothing will load until this is fixed.`;
 }
 function authorInstallNotice(target) {
     return `${messaging_prefix('debug')} install  target=${target}`;
 }
 function projectInstallInWorkspaceRoot(workspaceRoot) {
-    return `${messages_getLoggingPrefix('info')} This project is a pnpm workspace member, installing from the workspace root at ${pintor.blue(workspaceRoot)}.`;
+    return `${getLoggingPrefix('info')} This project is a pnpm workspace member, installing from the workspace root at ${pintor.blue(workspaceRoot)}.`;
 }
 function projectInstallFallbackToNpm(pmName) {
-    return `${messages_getLoggingPrefix('warn')} Dependency install with ${pmName} failed.\nExtension.js retries once with npm so the build can continue.`;
+    return `${getLoggingPrefix('warn')} Dependency install with ${pmName} failed.\nExtension.js retries once with npm so the build can continue.`;
 }
 function projectInstallScriptsDisabled(pmName) {
-    return `${messages_getLoggingPrefix('info')} Installing the project dependencies with ${pmName}…\nLifecycle scripts are disabled for safety.\nSet ${pintor.blue('EXTENSION_ALLOW_INSTALL_SCRIPTS=true')} to run them.`;
+    return `${getLoggingPrefix('info')} Installing the project dependencies with ${pmName}…\nLifecycle scripts are disabled for safety.\nSet ${pintor.blue('EXTENSION_ALLOW_INSTALL_SCRIPTS=true')} to run them.`;
 }
 function anotherDevSessionActive(browser, pid, runId) {
     const run = runId ? `, run ${runId}` : '';
-    return `${messages_getLoggingPrefix('warn')} Another dev session is already writing dist/${browser} (PID ${pid}${run}).\nBoth sessions rebuild the same output, so the last compile wins.\nStop the other session, or pass ${fmt.code('--instance-id')} to run them side by side.`;
+    return `${getLoggingPrefix('warn')} Another dev session is already writing dist/${browser} (PID ${pid}${run}).\nBoth sessions rebuild the same output, so the last compile wins.\nStop the other session. A distinct ${fmt.code('EXTENSION_INSTANCE_ID')} keeps the ports apart, but ready.json and the eval token hold one session per browser.`;
 }
-function buildAssetsTree(stats) {
+function anotherDevSessionRefused(browser, pid, port) {
+    const where = port ? ` on port ${port}` : '';
+    return `${getLoggingPrefix('error')} Another dev session already owns dist/${browser} (PID ${pid}${where}).\nA second session would overwrite its eval token and leave its contract pointing at the wrong one.\nStop that session first. One dev session per browser owns dist/${browser}, whatever its ${fmt.code('EXTENSION_INSTANCE_ID')}.`;
+}
+function buildAssetsTree(stats, outputFiles) {
     const statsJson = stats?.toJson?.({
         all: false,
         assets: true
     });
     const assets = statsJson?.assets || [];
-    return getAssetsTree(assets);
+    const tree = getAssetsTree(assets);
+    if (!tree || !outputFiles?.length) return tree;
+    const folded = foldOutputFiles(outputFiles, assets.map((asset)=>asset?.name));
+    if (0 === folded.count) return tree;
+    const noun = folded.sourceMapsOnly ? 'source map' : 'file';
+    return tree + pintor.gray(`+ ${pluralize(folded.count, noun)} not shown (${getFileSize(folded.bytes)})`) + '\n';
 }
 function buildComplete(browser, distDisplayPath, totalBytes, mode) {
     const noun = artifactNoun(String(browser));
     const builtFor = 'development' === mode ? 'built for development in' : 'none' === mode ? 'built in' : 'built for production in';
     const size = 'number' == typeof totalBytes && totalBytes > 0 ? ` (${getHumanSize(totalBytes)})` : '';
-    return `${messages_getLoggingPrefix('success')} ${noun} ${builtFor} ${pintor.underline(distDisplayPath)}${size}.`;
+    return `${getLoggingPrefix('success')} ${noun} ${builtFor} ${pintor.underline(distDisplayPath)}${size}.`;
 }
 function operaBuildUnminified() {
-    return `${messages_getLoggingPrefix('info')} Opera Add-ons reviews readable source, so this build does not minify first-party code. Pass ${pintor.blue('--minify')} to minify it anyway.`;
+    return `${getLoggingPrefix('info')} Opera Add-ons reviews readable source, so this build does not minify first-party code. Pass ${pintor.blue('--minify')} to minify it anyway.`;
 }
 function platformDocsUrl() {
     return String(process.env.EXTENSION_DEV_DOCS_URL || '').trim().replace(/\/+$/, '');
@@ -723,10 +348,10 @@ function addonLintSummary(errorCount, warningCount, distDisplay) {
     const parts = [];
     if (errorCount > 0) parts.push(pluralize(errorCount, 'error'));
     if (warningCount > 0) parts.push(pluralize(warningCount, 'warning'));
-    return `${messages_getLoggingPrefix('warn')} Store check for addons.mozilla.org: addons-linter found ${parts.join(' and ')} in ${pintor.underline(distDisplay)}`;
+    return `${getLoggingPrefix('warn')} Store check for addons.mozilla.org: addons-linter found ${parts.join(' and ')} in ${pintor.underline(distDisplay)}`;
 }
 function addonLintFinding(level, code, message, location, attribution) {
-    const glyph = messages_getLoggingPrefix('error' === level ? 'warn' : 'info');
+    const glyph = getLoggingPrefix('error' === level ? 'warn' : 'info');
     const where = location ? ` ${pintor.gray(`(${location})`)}` : '';
     const from = attribution ? ` ${pintor.gray(attribution)}` : '';
     return `${glyph} AMO ${level} ${pintor.yellow(code)}: ${message}${where}${from}`;
@@ -738,26 +363,26 @@ function addonLintDependencyAttribution(packages, onlyDependencies) {
     return onlyDependencies ? `- this file is bundled dependency code (${named}${rest}), not yours` : `- this file also bundles ${named}${rest}, so the finding may be theirs`;
 }
 function addonLintMore(hiddenCount, distDisplay) {
-    return `${messages_getLoggingPrefix('info')} ${pluralize(hiddenCount, 'more finding')} not shown. Run ${pintor.blue(`npx addons-linter ${distDisplay}`)} for the full report.`;
+    return `${getLoggingPrefix('info')} ${pluralize(hiddenCount, 'more finding')} not shown. Run ${pintor.blue(`npx addons-linter ${distDisplay}`)} for the full report.`;
 }
 function addonLintNotInstalled(installHint) {
-    return `${messages_getLoggingPrefix('info')} Skipped the addons.mozilla.org lint: addons-linter is not installed. Install it with: ${pintor.blue(installHint)} or pass ${pintor.blue('--no-addon-lint')} to silence this.`;
+    return `${getLoggingPrefix('info')} Skipped the addons.mozilla.org lint: addons-linter is not installed. Install it with: ${pintor.blue(installHint)} or pass ${pintor.blue('--no-addon-lint')} to silence this.`;
 }
 function addonLintFailed(reason, distDisplay) {
-    return `${messages_getLoggingPrefix('warn')} Store check for addons.mozilla.org did not finish: ${reason}. The build is complete, run ${pintor.blue(`npx addons-linter ${distDisplay}`)} to see what AMO would flag.`;
+    return `${getLoggingPrefix('warn')} Store check for addons.mozilla.org did not finish: ${reason}. The build is complete, run ${pintor.blue(`npx addons-linter ${distDisplay}`)} to see what AMO would flag.`;
 }
 function addonLintFailedDebug(reason) {
-    return `${messages_getLoggingPrefix('debug')} addon-lint failed=true reason="${reason}"`;
+    return `${getLoggingPrefix('debug')} addon-lint failed=true reason="${reason}"`;
 }
 function buildShareHint() {
     const docs = platformDocsUrl();
     if (!docs) return '';
-    return `${messages_getLoggingPrefix('info')} Send this build to someone for review: ` + pintor.underline(`${docs}/share/unpublished-build-for-review?utm_source=cli-build`);
+    return `${getLoggingPrefix('info')} Send this build to someone for review: ` + pintor.underline(`${docs}/share/unpublished-build-for-review?utm_source=cli-build`);
 }
 function buildFailed(errorCount) {
     const count = Math.max(1, Math.floor(errorCount || 1));
     const noun = 1 === count ? 'error' : 'errors';
-    return `${messages_getLoggingPrefix('error')} Build failed with ${count} ${noun}.`;
+    return `${getLoggingPrefix('error')} Build failed with ${count} ${noun}.`;
 }
 function stripModuleWarningWrapper(message) {
     return message.replace(/^Module (?:Warning|Error) \(from [^)]*\):\s*/, '');
@@ -828,45 +453,45 @@ function buildWarningsDetails(warnings) {
         const artifact = getWarningArtifact(warning);
         const category = classifyWarning(message, source);
         const hint = suggestedHintForWarning(category);
-        if (!message) return void blocks.push(`${messages_getLoggingPrefix('warn')} Warning ${index + 1}: details were suppressed by tool output.\n${formatWarningLabelLine('Source', pintor.gray(source))}\n${formatWarningLabelLine('Hint', 'Re-run with EXTENSION_VERBOSE=1 to inspect full warning messages.')}`);
+        if (!message) return void blocks.push(`${getLoggingPrefix('warn')} Warning ${index + 1}: details were suppressed by tool output.\n${formatWarningLabelLine('Source', pintor.gray(source))}\n${formatWarningLabelLine('Hint', 'Re-run with EXTENSION_VERBOSE=1 to inspect full warning messages.')}`);
         const performanceWarning = parsePerformanceWarning(warning, source, artifact);
         if (performanceWarning) return void blocks.push(performanceWarning);
         if (hasChannelPrefix(message)) return void blocks.push(message);
-        const explained = message.includes('\n');
-        const oneLine = message.replace(/\s+/g, ' ').trim();
+        const [headline, ...body] = message.split('\n').map((line)=>line.replace(/\s+/g, ' ').trim()).filter(Boolean);
+        const explained = body.length > 0;
         const artifactSuffix = artifact ? ` ${pintor.gray(`(${artifact})`)}` : '';
-        blocks.push(`${messages_getLoggingPrefix('warn')} ${category}: ${oneLine}${artifactSuffix}\n` + formatWarningLabelLine('Source', pintor.gray(source)) + (explained ? '' : `\n${formatWarningLabelLine('Hint', hint)}`));
+        blocks.push(`${getLoggingPrefix('warn')} ${category}: ${headline}${artifactSuffix}\n` + body.map((line)=>`${line}\n`).join('') + formatWarningLabelLine('Source', pintor.gray(source)) + (explained ? '' : `\n${formatWarningLabelLine('Hint', hint)}`));
     });
     return blocks.join('\n\n');
 }
 function downloadingProjectPath(projectName, url) {
     const formatted = isPathLike(projectName) ? pintor.underline(projectName) : projectName;
-    return `${messages_getLoggingPrefix('info')} Downloading ${formatted}…\n${pintor.gray('URL')} ${fmt.val(url)}`;
+    return `${getLoggingPrefix('info')} Downloading ${formatted}…\n${pintor.gray('URL')} ${fmt.val(url)}`;
 }
 function creatingProjectPath() {
-    return `${messages_getLoggingPrefix('info')} Creating a new browser extension…`;
+    return `${getLoggingPrefix('info')} Creating a new browser extension…`;
 }
 function reusingDownloadedProject(destinationPath, url) {
-    return `${messages_getLoggingPrefix('info')} Using the extension already downloaded here…\n${pintor.gray('PATH')} ${pintor.underline(destinationPath)}\n${pintor.gray('URL')} ${fmt.val(url)}\nDelete that folder to download it again.`;
+    return `${getLoggingPrefix('info')} Using the extension already downloaded here…\n${pintor.gray('PATH')} ${pintor.underline(destinationPath)}\n${pintor.gray('URL')} ${fmt.val(url)}\nDelete that folder to download it again.`;
 }
 function remoteSourceDestinationTaken(destinationPath, source) {
     const isUrl = /^https?:\/\//i.test(source);
-    return `${messages_getLoggingPrefix('error')} ` + (isUrl ? `A folder is already here, and it isn't a download from this URL.\n` : `A folder is already here, and it wasn't extracted from this ZIP file.\n`) + `${pintor.gray('PATH')} ${pintor.underline(destinationPath)}\n` + `${pintor.gray(isUrl ? 'URL' : 'ZIP')} ${fmt.val(source)}\n` + "Rename or remove that folder, or run the command from another folder.";
+    return `${getLoggingPrefix('error')} ` + (isUrl ? `A folder is already here, and it isn't a download from this URL.\n` : `A folder is already here, and it wasn't extracted from this ZIP file.\n`) + `${pintor.gray('PATH')} ${pintor.underline(destinationPath)}\n` + `${pintor.gray(isUrl ? 'URL' : 'ZIP')} ${fmt.val(source)}\n` + "Rename or remove that folder, or run the command from another folder.";
 }
 function downloadedProjectFolderNotFound(cwd, candidates) {
-    return `${messages_getLoggingPrefix('error')} Downloaded project folder not found.\n${pintor.gray('PATH')} ${pintor.underline(cwd)}\n${pintor.gray('NOT FOUND')} ${pintor.underline(candidates.join(', '))}`;
+    return `${getLoggingPrefix('error')} Downloaded project folder not found.\n${pintor.gray('PATH')} ${pintor.underline(cwd)}\n${pintor.gray('NOT FOUND')} ${pintor.underline(candidates.join(', '))}`;
 }
 function packagingSourceFiles(zipPath) {
     return `${messaging_prefix('debug')} zip      pack=source gitignore=excluded path=${zipPath}`;
 }
 function zipSkippedSymlinks(links) {
-    return `${messages_getLoggingPrefix('warn')} The source zip skipped ${1 === links.length ? 'a symlink' : `${links.length} symlinks`}, because an archive stores files.\n${pintor.gray('SKIPPED')} ${links.join(', ')}\nCopy what the link points at into the project if the archive needs it.`;
+    return `${getLoggingPrefix('warn')} The source zip skipped ${1 === links.length ? 'a symlink' : `${links.length} symlinks`}, because an archive stores files.\n${pintor.gray('SKIPPED')} ${links.join(', ')}\nCopy what the link points at into the project if the archive needs it.`;
 }
 function zipArtifactNotCreated(kind, zipPath, reason) {
-    return `${messages_getLoggingPrefix('error')} The ${'source' === kind ? 'source' : 'distribution'} zip was requested and not created.\n${pintor.gray('PATH')} ${pintor.underline(zipPath)}\n${pintor.red(reason)}`;
+    return `${getLoggingPrefix('error')} The ${'source' === kind ? 'source' : 'distribution'} zip was requested and not created.\n${pintor.gray('PATH')} ${pintor.underline(zipPath)}\n${pintor.red(reason)}`;
 }
 function zipArtifactReady(zipPath, sizeInBytes) {
-    return `${messages_getLoggingPrefix('success')} Packaged ${pintor.underline(zipPath)} (${getHumanSize(sizeInBytes)}).`;
+    return `${getLoggingPrefix('success')} Packaged ${pintor.underline(zipPath)} (${getHumanSize(sizeInBytes)}).`;
 }
 function packagingDistributionFiles(zipPath) {
     return `${messaging_prefix('debug')} zip      pack=dist path=${zipPath}`;
@@ -881,47 +506,50 @@ function treeWithSourceFiles(name, ext, browser, zipPath) {
     return `${messaging_prefix('debug')} zip      name=${name}-source.${ext} browser=${String(browser)} source=${zipPath}`;
 }
 function writingTypeDefinitions(manifest) {
-    return `${messages_getLoggingPrefix('info')} Writing the type definitions for ${manifest.name || 'the extension'}…`;
+    return `${getLoggingPrefix('info')} Writing the type definitions for ${manifest.name || 'the extension'}…`;
+}
+function updatingTypeDefinitions(filePath) {
+    return `${getLoggingPrefix('info')} Updating the type definitions in ${filePath} to match this version.`;
 }
 function writingTypeDefinitionsError(error) {
-    return `${messages_getLoggingPrefix('error')} Couldn't write the extension type definitions.\n${pintor.gray('REASON')} ${pintor.red(String(error))}\nCheck the file permissions, then try again.`;
+    return `${getLoggingPrefix('error')} Couldn't write the extension type definitions.\n${pintor.gray('REASON')} ${pintor.red(String(error))}\nCheck the file permissions, then try again.`;
 }
 function downloadingText(url) {
-    return `${messages_getLoggingPrefix('info')} Downloading the browser extension…\n${pintor.gray('URL')} ${fmt.val(url)}`;
+    return `${getLoggingPrefix('info')} Downloading the browser extension…\n${pintor.gray('URL')} ${fmt.val(url)}`;
 }
 function unpackagingExtension(zipFilePath) {
-    return `${messages_getLoggingPrefix('info')} Unpackaging the browser extension…\n${pintor.gray('PATH')} ${pintor.underline(zipFilePath)}`;
+    return `${getLoggingPrefix('info')} Unpackaging the browser extension…\n${pintor.gray('PATH')} ${pintor.underline(zipFilePath)}`;
 }
 function unpackagedSuccessfully() {
-    return `${messages_getLoggingPrefix('success')} Extension unpackaged.`;
+    return `${getLoggingPrefix('success')} Extension unpackaged.`;
 }
 function failedToDownloadOrWriteZIPFileError(error) {
-    return `${messages_getLoggingPrefix('error')} Couldn't download the ZIP file or write it to disk.\n${pintor.gray('REASON')} ${pintor.red(String(error))}\nCheck the URL, your network and that the destination is writable, then try again.`;
+    return `${getLoggingPrefix('error')} Couldn't download the ZIP file or write it to disk.\n${pintor.gray('REASON')} ${pintor.red(String(error))}\nCheck the URL, your network and that the destination is writable, then try again.`;
 }
 function failedToWriteZIPFileError(error) {
-    return `${messages_getLoggingPrefix('error')} Couldn't write the unpacked ZIP file to disk.\n${pintor.gray('REASON')} ${pintor.red(String(error))}\nCheck that the destination is writable, then try again.`;
+    return `${getLoggingPrefix('error')} Couldn't write the unpacked ZIP file to disk.\n${pintor.gray('REASON')} ${pintor.red(String(error))}\nCheck that the destination is writable, then try again.`;
 }
 function invalidRemoteZip(url, contentType) {
-    return `${messages_getLoggingPrefix('error')} The remote URL doesn't point to a ZIP archive.\n${pintor.gray('URL')} ${pintor.underline(url)}\n${pintor.gray('GOT')} ${pintor.underline(contentType || 'unknown')}\nUse a direct-download URL, or download the file and pass the local path.`;
+    return `${getLoggingPrefix('error')} The remote URL doesn't point to a ZIP archive.\n${pintor.gray('URL')} ${pintor.underline(url)}\n${pintor.gray('GOT')} ${pintor.underline(contentType || 'unknown')}\nUse a direct-download URL, or download the file and pass the local path.`;
 }
 function notAZipArchive(source, contentType) {
-    return `${messages_getLoggingPrefix('error')} The downloaded content isn't a ZIP archive.\n${pintor.gray('SOURCE')} ${pintor.underline(source)}\n` + (contentType ? `${pintor.gray('GOT')} ${pintor.underline(contentType)}\n` : '') + `The URL likely requires authentication and returned an HTML login page instead of the file.\n` + `This happens with Slack, Google Drive, and Dropbox file pages.\n` + "Download the ZIP in the browser and pass the local path, or use a direct-download URL.";
+    return `${getLoggingPrefix('error')} The downloaded content isn't a ZIP archive.\n${pintor.gray('SOURCE')} ${pintor.underline(source)}\n` + (contentType ? `${pintor.gray('GOT')} ${pintor.underline(contentType)}\n` : '') + `The URL likely requires authentication and returned an HTML login page instead of the file.\n` + `This happens with Slack, Google Drive, and Dropbox file pages.\n` + "Download the ZIP in the browser and pass the local path, or use a direct-download URL.";
 }
 function remoteZipDamaged(url, cause) {
     const detail = cause instanceof Error ? cause.message : String(cause);
-    return `${messages_getLoggingPrefix('error')} The ZIP archive at the remote URL is damaged.\n${pintor.gray('URL')} ${pintor.underline(url)}\n${pintor.gray('REASON')} ${pintor.red(detail)}\nTry again, or download a good copy of the archive and pass the local path.`;
+    return `${getLoggingPrefix('error')} The ZIP archive at the remote URL is damaged.\n${pintor.gray('URL')} ${pintor.underline(url)}\n${pintor.gray('REASON')} ${pintor.red(detail)}\nTry again, or download a good copy of the archive and pass the local path.`;
 }
 function zipEntryOutsideFolder(source, entry) {
     const where = 'url' in source ? 'The ZIP archive at the remote URL' : 'The ZIP file';
     const row = 'url' in source ? `${pintor.gray('URL')} ${pintor.underline(source.url)}` : `${pintor.gray('PATH')} ${pintor.underline(source.path)}`;
-    return `${messages_getLoggingPrefix('error')} ${where} contains a path outside its folder, so it was refused. Nothing was written.\n${row}\n${pintor.gray('ENTRY')} ${pintor.red(entry)}\nUse an archive whose entries all stay inside its folder.`;
+    return `${getLoggingPrefix('error')} ${where} contains a path outside its folder, so it was refused. Nothing was written.\n${row}\n${pintor.gray('ENTRY')} ${pintor.red(entry)}\nUse an archive whose entries all stay inside its folder.`;
 }
 function localZipUnreadable(zipFilePath, cause) {
     const detail = cause instanceof Error ? cause.message : String(cause ?? '');
-    return `${messages_getLoggingPrefix('error')} The file isn't a ZIP archive that can be unpacked.\n${pintor.gray('PATH')} ${pintor.underline(zipFilePath)}\n` + (detail ? `${pintor.gray('REASON')} ${pintor.red(detail)}\n` : '') + "Check that the file opens as a ZIP, then try again.";
+    return `${getLoggingPrefix('error')} The file isn't a ZIP archive that can be unpacked.\n${pintor.gray('PATH')} ${pintor.underline(zipFilePath)}\n` + (detail ? `${pintor.gray('REASON')} ${pintor.red(detail)}\n` : '') + "Check that the file opens as a ZIP, then try again.";
 }
 function localZipNotFound(zipFilePath) {
-    return `${messages_getLoggingPrefix('error')} ZIP file not found.\n${pintor.gray('NOT FOUND')} ${pintor.underline(zipFilePath)}\nCheck the path, then try again.`;
+    return `${getLoggingPrefix('error')} ZIP file not found.\n${pintor.gray('NOT FOUND')} ${pintor.underline(zipFilePath)}\nCheck the path, then try again.`;
 }
 function capitalizedBrowserName(browser) {
     const b = String(browser || '');
@@ -992,7 +620,7 @@ function parsePerformanceWarning(warning, source, _artifact) {
 }
 function formatPerformanceWarningBlock(options) {
     const lines = [
-        `${messages_getLoggingPrefix('warn')} Performance: ${options.title}`
+        `${getLoggingPrefix('warn')} Performance: ${options.title}`
     ];
     if (options.threshold) lines.push(formatWarningLabelLine('Threshold', options.threshold));
     lines.push(formatWarningLabelLine('Impact', options.impact));
@@ -1025,17 +653,17 @@ function debugSplitChunksNarrowed(optionPaths) {
 }
 function runtimeChunkKeptInline(runtimeChunk) {
     const setting = 'string' == typeof runtimeChunk ? `'${runtimeChunk}'` : 'object' == typeof runtimeChunk ? 'an object' : String(runtimeChunk);
-    return `${messages_getLoggingPrefix('warn')} optimization.runtimeChunk is set to ${setting}, kept at false.\nThe background and the content scripts load one file each, so a separate runtime file never reaches them and the entry never starts. Pages already share code through the shared/ files.`;
+    return `${getLoggingPrefix('warn')} optimization.runtimeChunk is set to ${setting}, kept at false.\nThe background and the content scripts load one file each, so a separate runtime file never reaches them and the entry never starts. Pages already share code through the shared/ files.`;
 }
 function configResolvedChangeIgnored(keys) {
     const many = keys.length > 1;
-    return `${messages_getLoggingPrefix('warn')} configResolved changed ${keys.join(', ')}, which the hook cannot change. The change is ignored, set ${many ? 'them' : 'it'} in config instead.`;
+    return `${getLoggingPrefix('warn')} configResolved changed ${keys.join(', ')}, which the hook cannot change. The change is ignored, set ${many ? 'them' : 'it'} in config instead.`;
 }
 function debugOutputPath(pathValue) {
     return `${messaging_prefix('debug')} output   path=${pathValue}`;
 }
 function previewingCustomOutput(browser, outputPath, distPath) {
-    return `${messages_getLoggingPrefix('info')} Previewing ${String(browser)} from ${outputPath}.\nThis is not the build folder ${distPath}. The run record describes the folder loaded.`;
+    return `${getLoggingPrefix('info')} Previewing ${String(browser)} from ${outputPath}.\nThis is not the build folder ${distPath}. The run record describes the folder loaded.`;
 }
 function debugPreviewOutput(outputPath, distPath) {
     return `${messaging_prefix('debug')} preview  output=${outputPath} dist=${distPath}`;
@@ -1047,7 +675,7 @@ function debugExtensionsToLoad(extensions) {
     return `${messaging_prefix('debug')} extensions count=${extensions.length} paths=${extensions.join(',')}`;
 }
 function noCompanionExtensionsResolved() {
-    return `${messages_getLoggingPrefix('warn')} No companion extensions resolved from the ${pintor.blue('extensions')} config.\nPoint each entry at an unpacked extension directory that contains a manifest.json, for example ./extensions/<name>/manifest.json.`;
+    return `${getLoggingPrefix('warn')} No companion extensions resolved from the ${pintor.blue('extensions')} config.\nPoint each entry at an unpacked extension directory that contains a manifest.json, for example ./extensions/<name>/manifest.json.`;
 }
 function describeThrown(error) {
     if (error instanceof Error) return error.message || error.name || 'Error';
@@ -1064,21 +692,21 @@ function shapeOf(value) {
 }
 function configWrongShape(configPath, value) {
     const functionHint = 'function' == typeof value ? `\nTo change the bundler config, export it as ${pintor.blue('export default {config: (config) => config}')}.` : '';
-    return `${messages_getLoggingPrefix('error')} ${pintor.blue('extension.config.js')} must export an object, found ${shapeOf(value)}.\n${fmt.label('PATH')} ${fmt.val(configPath)}${functionHint}`;
+    return `${getLoggingPrefix('error')} ${pintor.blue('extension.config.js')} must export an object, found ${shapeOf(value)}.\n${fmt.label('PATH')} ${fmt.val(configPath)}${functionHint}`;
 }
 function configUnknownKeys(configPath, keys, accepted) {
-    return `${messages_getLoggingPrefix('warn')} ${pintor.blue('extension.config.js')} declares ${1 === keys.length ? 'a key' : 'keys'} nothing reads: ${pintor.yellow(keys.join(', '))}.\n${fmt.label('PATH')} ${fmt.val(configPath)}\nAccepted keys are ${pintor.blue(accepted.join(', '))}.`;
+    return `${getLoggingPrefix('warn')} ${pintor.blue('extension.config.js')} declares ${1 === keys.length ? 'a key' : 'keys'} nothing reads: ${pintor.yellow(keys.join(', '))}.\n${fmt.label('PATH')} ${fmt.val(configPath)}\nAccepted keys are ${pintor.blue(accepted.join(', '))}.`;
 }
 function configLoadingError(configPath, error) {
-    return `${messages_getLoggingPrefix('error')} Couldn't load ${pintor.blue('extension.config.js')}.\n${fmt.label('PATH')} ${fmt.val(configPath)}\n${pintor.red(describeThrown(error))}\nFix the config file, then run the command again.`;
+    return `${getLoggingPrefix('error')} Couldn't load ${pintor.blue('extension.config.js')}.\n${fmt.label('PATH')} ${fmt.val(configPath)}\n${pintor.red(describeThrown(error))}\nFix the config file, then run the command again.`;
 }
 function buildCommandFailed(error) {
     const message = (()=>{
         if (error instanceof Error && error.message) return error.message;
         return String(error || 'Unknown error');
     })();
-    if (message.includes(messages_getLoggingPrefix('error'))) return message;
-    return `${messages_getLoggingPrefix('error')} ${pintor.red(fmt.truncate(message, 1200))}`;
+    if (message.includes(getLoggingPrefix('error'))) return message;
+    return `${getLoggingPrefix('error')} ${pintor.red(fmt.truncate(message, 1200))}`;
 }
 function devCommandFailed(error) {
     const message = (()=>{
@@ -1086,17 +714,17 @@ function devCommandFailed(error) {
         return String(error || 'Unknown error');
     })();
     const detail = hasChannelPrefix(message) ? stripChannelPrefix(message) : message;
-    return `${messages_getLoggingPrefix('error')} Dev mode failed.\n${pintor.red(fmt.truncate(detail, 1200))}`;
+    return `${getLoggingPrefix('error')} Dev mode failed.\n${pintor.red(fmt.truncate(detail, 1200))}`;
 }
 function safariInvalidBundleId(bundleId) {
-    return `${messages_getLoggingPrefix('error')} Can't use ${fmt.code(bundleId)} as a bundle identifier.\nUse letters, digits, hyphens and periods, with no empty segment (e.g. ${fmt.code('com.example.my-extension')}).`;
+    return `${getLoggingPrefix('error')} Can't use ${fmt.code(bundleId)} as a bundle identifier.\nUse letters, digits, hyphens and periods, with no empty segment (e.g. ${fmt.code('com.example.my-extension')}).`;
 }
 function safariBuildOutputNotFound(outputPath) {
-    return `${messages_getLoggingPrefix('error')} No build output to package for Safari.\n${pintor.gray('NOT FOUND')} ${pintor.underline(outputPath)}\nThe bundler emitted nothing there, so there is no extension to convert into an app.`;
+    return `${getLoggingPrefix('error')} No build output to package for Safari.\n${pintor.gray('NOT FOUND')} ${pintor.underline(outputPath)}\nThe bundler emitted nothing there, so there is no extension to convert into an app.`;
 }
 function managedDependencyCopyWarning(duplicates, configPath) {
     const list = duplicates.map((d)=>`- ${pintor.yellow(d.name)} (Extension.js ships ${d.shipped})`).join('\n');
-    return `${messages_getLoggingPrefix('warn')} ${pintor.blue(__rspack_external_node_path_806ed179.basename(configPath))} loads its own copy of ${1 === duplicates.length ? 'a package' : 'packages'} Extension.js already ships.\n${list}\n${fmt.label('PATH')} ${fmt.val(configPath)}\nBoth copies take part in one build, and when their versions differ the build can break or behave differently.\nThe build goes on. If it misbehaves, install the version shown or drop the import.`;
+    return `${getLoggingPrefix('warn')} ${pintor.blue(__rspack_external_node_path_806ed179.basename(configPath))} loads its own copy of ${1 === duplicates.length ? 'a package' : 'packages'} Extension.js already ships.\n${list}\n${fmt.label('PATH')} ${fmt.val(configPath)}\nBoth copies take part in one build, and when their versions differ the build can break or behave differently.\nThe build goes on. If it misbehaves, install the version shown or drop the import.`;
 }
 function codedError(code, message) {
     const error = new Error(message);
@@ -1312,7 +940,7 @@ async function importUrlSourceFromGithub(pathOrRemoteUrl, text) {
             if (!candidate.subdir) return repoRoot;
             const withSubdir = __rspack_external_node_path_806ed179.join(repoRoot, candidate.subdir);
             if (__rspack_external_node_fs_1b05aee1.existsSync(withSubdir)) return withSubdir;
-            throw new Error(downloadedProjectFolderNotFound(repoRoot, [
+            throw codedError(CODES.E_PROJECT_DOWNLOAD_EMPTY, downloadedProjectFolderNotFound(repoRoot, [
                 candidate.subdir
             ]));
         } catch (error) {
@@ -1344,7 +972,7 @@ async function importUrlSourceFromGithub(pathOrRemoteUrl, text) {
         const ghRoot = appeared.find((name)=>/-main$|-master$/.test(name));
         return ghRoot ? __rspack_external_node_path_806ed179.join(cwd, ghRoot) : void 0;
     })();
-    if (!landed) throw new Error(downloadedProjectFolderNotFound(cwd, candidates));
+    if (!landed) throw codedError(CODES.E_PROJECT_DOWNLOAD_EMPTY, downloadedProjectFolderNotFound(cwd, candidates));
     writeRemoteSource(landed, pathOrRemoteUrl);
     return {
         projectPath: landed,
@@ -1565,102 +1193,4 @@ function resolveProjectStructureSync(projectPath, options = {}) {
         } : {}
     };
 }
-function sessionStateDir(projectPath) {
-    return __rspack_external_node_path_806ed179.resolve(projectPath, '.extension-js');
-}
-function controlPortFilePath(projectPath, browser) {
-    return __rspack_external_node_path_806ed179.join(sessionStateDir(projectPath), `control-port-${browser}`);
-}
-function legacyControlPortFilePath(projectPath, browser) {
-    return __rspack_external_node_path_806ed179.join(browserArtifactsDir(projectPath, browser), 'control-port');
-}
-const CONTROL_TOKEN_FILE_PREFIX = 'control-token-';
-function controlTokenPath(projectPath, browser) {
-    return __rspack_external_node_path_806ed179.join(sessionStateDir(projectPath), `${CONTROL_TOKEN_FILE_PREFIX}${browser}`);
-}
-function legacyControlTokenPath(projectPath) {
-    return __rspack_external_node_path_806ed179.join(sessionStateDir(projectPath), 'control.token');
-}
-function sessionArtifactsRootDir(projectPath) {
-    return __rspack_external_node_path_806ed179.resolve(projectPath, 'dist', 'extension-js');
-}
-const SESSION_ARTIFACTS_IGNORE_CONTENT = "# Extension.js session state: managed browser profiles (cookies, history,\n# logins), session logs and machine contracts. Personal data lives here:\n# this directory must never be committed or shipped.\n*\n";
-function sessionArtifactsIgnoreFilePath(projectPath) {
-    return __rspack_external_node_path_806ed179.join(sessionArtifactsRootDir(projectPath), '.gitignore');
-}
-const PROJECT_ROOT_MARKERS = [
-    'package.json',
-    'deno.jsonc',
-    'deno.json',
-    'manifest.json'
-];
-function holdsProjectRootMarker(projectPath) {
-    return PROJECT_ROOT_MARKERS.some((marker)=>__rspack_external_node_fs_1b05aee1.existsSync(__rspack_external_node_path_806ed179.join(projectPath, marker)));
-}
-function ensureSessionArtifactsIgnoreFile(projectPath) {
-    try {
-        if (!holdsProjectRootMarker(projectPath)) return;
-        const ignoreFile = sessionArtifactsIgnoreFilePath(projectPath);
-        if (__rspack_external_node_fs_1b05aee1.existsSync(ignoreFile)) return;
-        __rspack_external_node_fs_1b05aee1.mkdirSync(__rspack_external_node_path_806ed179.dirname(ignoreFile), {
-            recursive: true
-        });
-        __rspack_external_node_fs_1b05aee1.writeFileSync(ignoreFile, SESSION_ARTIFACTS_IGNORE_CONTENT);
-    } catch  {}
-}
-function isAlreadyIgnoredByGit(projectPath) {
-    try {
-        const result = spawnSync('git', [
-            'check-ignore',
-            '-q',
-            '--',
-            '.extension-js/'
-        ], {
-            cwd: projectPath,
-            stdio: 'ignore'
-        });
-        return 0 === result.status;
-    } catch  {
-        return false;
-    }
-}
-function ensureSessionStateInProjectGitignore(projectPath) {
-    try {
-        const gitignorePath = __rspack_external_node_path_806ed179.resolve(projectPath, '.gitignore');
-        if (!__rspack_external_node_fs_1b05aee1.existsSync(gitignorePath)) return;
-        const content = __rspack_external_node_fs_1b05aee1.readFileSync(gitignorePath, 'utf8');
-        const lines = content.split(/\r?\n/).map((line)=>line.trim());
-        if (lines.includes('.extension-js') || lines.includes('.extension-js/')) return;
-        if (isAlreadyIgnoredByGit(projectPath)) return;
-        const prefix = content.length > 0 && !content.endsWith('\n') ? '\n' : '';
-        __rspack_external_node_fs_1b05aee1.appendFileSync(gitignorePath, `${prefix}\n# Extension.js local session state\n.extension-js\n`);
-        const notice = sessionStateIgnoreAdded(gitignorePath);
-        if (isMachineOutput()) console.error(notice);
-        else console.log(notice);
-    } catch  {}
-}
-function browserArtifactsDir(projectPath, browser) {
-    return __rspack_external_node_path_806ed179.join(sessionArtifactsRootDir(projectPath), browser);
-}
-function browserProfileRootDir(projectPath, browser) {
-    return __rspack_external_node_path_806ed179.join(sessionArtifactsRootDir(projectPath), 'profiles', `${browser}-profile`);
-}
-function browserDistDir(projectPath, browser) {
-    return __rspack_external_node_path_806ed179.resolve(projectPath, 'dist', browser);
-}
-function readyContractPath(projectPath, browser) {
-    return __rspack_external_node_path_806ed179.join(browserArtifactsDir(projectPath, browser), 'ready.json');
-}
-function eventsPath(projectPath, browser) {
-    return __rspack_external_node_path_806ed179.join(browserArtifactsDir(projectPath, browser), 'events.ndjson');
-}
-function logsPath(projectPath, browser) {
-    return __rspack_external_node_path_806ed179.join(browserArtifactsDir(projectPath, browser), 'logs.ndjson');
-}
-function actionsPath(projectPath, browser) {
-    return __rspack_external_node_path_806ed179.join(browserArtifactsDir(projectPath, browser), 'actions.ndjson');
-}
-function buildSummaryPath(projectPath, browser) {
-    return __rspack_external_node_path_806ed179.join(browserArtifactsDir(projectPath, browser), 'build-summary.json');
-}
-export { CONTROL_TOKEN_FILE_PREFIX, actionsPath, addonLintDependencyAttribution, addonLintFailed, addonLintFailedDebug, addonLintFinding, addonLintMore, addonLintNotInstalled, addonLintSummary, anotherDevSessionActive, asAbsolute, attachLifecycleStream, authorInstallNotice, autoExitForceKill, autoExitModeEnabled, autoExitTriggered, browserArtifactsDir, browserDistDir, browserLaunchFailed, browserProfileRootDir, browserRunnerDisabled, buildAssetsTree, buildCommandFailed, buildComplete, buildFailed, buildShareHint, buildSummaryPath, buildWarningsDetails, bundlerFatalError, bundlerRecompiling, codedError, collapseHomeDir, computePreviewOutputPath, configBrowserOrThrow, configLoadingError, configResolvedChangeIgnored, configUnknownKeys, configWrongShape, controlBridgeUnavailable, controlPortFilePath, controlTokenPath, createLifecycleStream, debugBrowser, debugContextPath, debugDirs, debugExtensionsToLoad, debugOutputPath, debugPreviewOutput, debugSplitChunksNarrowed, devCommandFailed, devServerHostRefused, devServerRestarting, devServerStartTimeout, devtoolsEngineFor, displayPath, downloadingText, emulatorViewerUrl, ensureSessionArtifactsIgnoreFile, ensureSessionStateInProjectGitignore, eventsPath, extensionJsRunnerError, extensionLoadRecovered, extensionLoadStillRefused, failedToDownloadOrWriteZIPFileError, failedToWriteZIPFileError, getDirs, getDistPath, getProjectStructure, humanLine, invalidRemoteZip, isUsingExperimentalConfig, legacyControlPortFilePath, legacyControlTokenPath, localZipNotFound, localZipUnreadable, logsPath, managedDependencyCopyWarning, manifestGoneDuringSession, manifestInvalidJson, messages_ready, needsInstall, noCompanionExtensionsResolved, noEntrypointsDetected, normalizeBrowser, notAZipArchive, operaBuildUnminified, packagingDistributionFiles, packagingSourceFiles, portInUse, previewHasNothingToRun, previewing, previewingCustomOutput, previewingSourceFallback, projectInstallFallbackToNpm, projectInstallInWorkspaceRoot, projectInstallScriptsDisabled, readyContractPath, relativeToDir, remoteSourceDestinationTaken, remoteZipDamaged, resolveProjectStructureSync, runnerCleanupError, runnerUncaughtException, runnerUnhandledRejection, runtimeChunkKeptInline, safariBuildOutputNotFound, safariInvalidBundleId, sessionArtifactsRootDir, sessionStateDir, shouldWarnPortConflict, spacerLine, starting, stripAnsi, toPosixPath, treeWithDistFilesBrowser, treeWithSourceAndDistFiles, treeWithSourceFiles, unpackagedSuccessfully, unpackagingExtension, writingTypeDefinitions, writingTypeDefinitionsError, zipArtifactNotCreated, zipArtifactReady, zipEntryOutsideFolder, zipSkippedSymlinks };
+export { addonLintDependencyAttribution, addonLintFailed, addonLintFailedDebug, addonLintFinding, addonLintMore, addonLintNotInstalled, addonLintSummary, anotherDevSessionActive, anotherDevSessionRefused, asAbsolute, authorInstallNotice, browserLaunchFailed, buildAssetsTree, buildCommandFailed, buildComplete, buildFailed, buildShareHint, buildWarningsDetails, codedError, collapseHomeDir, computePreviewOutputPath, configBrowserOrThrow, configLoadingError, configResolvedChangeIgnored, configUnknownKeys, configWrongShape, debugBrowser, debugContextPath, debugDirs, debugExtensionsToLoad, debugOutputPath, debugPreviewOutput, debugSplitChunksNarrowed, devCommandFailed, devtoolsEngineFor, displayPath, downloadingText, extensionLoadRecovered, extensionLoadStillRefused, failedToDownloadOrWriteZIPFileError, failedToWriteZIPFileError, getDirs, getDistPath, getProjectStructure, invalidRemoteZip, isUsingExperimentalConfig, listOutputFiles, localZipNotFound, localZipUnreadable, managedDependencyCopyWarning, manifestInvalidJson, needsInstall, noCompanionExtensionsResolved, normalizeBrowser, notAZipArchive, operaBuildUnminified, packagingDistributionFiles, packagingSourceFiles, previewHasNothingToRun, previewing, previewingCustomOutput, previewingSourceFallback, projectInstallFallbackToNpm, projectInstallInWorkspaceRoot, projectInstallScriptsDisabled, relativeToDir, remoteSourceDestinationTaken, remoteZipDamaged, resolveProjectStructureSync, runtimeChunkKeptInline, safariBuildOutputNotFound, safariInvalidBundleId, sessionStateIgnoreAdded, starting, toPosixPath, treeWithDistFilesBrowser, treeWithSourceAndDistFiles, treeWithSourceFiles, unpackagedSuccessfully, unpackagingExtension, updatingTypeDefinitions, writingTypeDefinitions, writingTypeDefinitionsError, zipArtifactNotCreated, zipArtifactReady, zipEntryOutsideFolder, zipSkippedSymlinks };