extension-develop 4.0.21 → 4.0.22-canary.1785348713.017c274a

package/dist/0~rspack-config.mjs

@@ -12,12 +12,12 @@ import { filterKeysForThisBrowser as external_browser_extension_manifest_fields_
 import content_security_policy_parser from "content-security-policy-parser";
 import node_fs from "node:fs";
 import node_path from "node:path";
-import { debugExtensionsToLoad, package_namespaceObject, getDirs, asAbsolute, browserRunnerDisabled, treeWithDistFilesBrowser, packagingDistributionFiles, zipArtifactReady, resolveCompanionExtensionDirs, debugContextPath, toPosixPath, isGeckoBasedBrowser, spacerLine, PlaywrightPlugin, messages_ready, CHROMIUM_FAMILY_ALIASES, treeWithSourceAndDistFiles, computeExtensionsToLoad, noCompanionExtensionsResolved, treeWithSourceFiles, bundlerFatalError, bundlerRecompiling, noEntrypointsDetected, GECKO_FAMILY_ALIASES, packagingSourceFiles, debugBrowser, debugOutputPath, manifestInvalidJson, isChromiumBasedBrowser, getSpecialFoldersDataForCompiler } from "./101.mjs";
+import { debugExtensionsToLoad, package_namespaceObject, getDirs, asAbsolute, browserRunnerDisabled, treeWithDistFilesBrowser, packagingDistributionFiles, toPosixPath, resolveCompanionExtensionDirs, debugContextPath, PlaywrightPlugin, isGeckoBasedBrowser, spacerLine, messages_ready, CHROMIUM_FAMILY_ALIASES, treeWithSourceAndDistFiles, computeExtensionsToLoad, noCompanionExtensionsResolved, treeWithSourceFiles, bundlerFatalError, bundlerRecompiling, noEntrypointsDetected, GECKO_FAMILY_ALIASES, packagingSourceFiles, debugBrowser, debugOutputPath, manifestInvalidJson, isChromiumBasedBrowser, getSpecialFoldersDataForCompiler } from "./101.mjs";
 import { stripBom, parseJsonSafe } from "./23.mjs";
 import { isResourceUnderDirs, canonicalizeDir, toResourceKey } from "./93.mjs";
 import { prefix as messaging_prefix, isDebug } from "./349.mjs";
-import { jsFrameworksHmrSummary, isUsingTypeScript, resolvePackageManager, humanLine, jsFrameworksIntegrationsEnabled, jsFrameworksConfigsDetected, ensureTypeScriptConfig, hasDependency, resolveDevelopInstallRoot, resolveDevelopDistFile, isUsingCustomLoader, getUserTypeScriptConfigFile, isUsingIntegration as messages_isUsingIntegration } from "./839.mjs";
-import { scrubBrand, makeSanitizedConsole } from "./0~branding.mjs";
+import { jsFrameworksHmrSummary, isUsingTypeScript, resolvePackageManager, humanLine, jsFrameworksIntegrationsEnabled, jsFrameworksConfigsDetected, recordZipArtifact, hasDependency, resolveDevelopInstallRoot, resolveDevelopDistFile, isUsingCustomLoader, ensureTypeScriptConfig, isUsingIntegration as messages_isUsingIntegration, getUserTypeScriptConfigFile } from "./839.mjs";
+import { renderStatsBlocks, makeSanitizedConsole } from "./0~stats-handler.mjs";
 import { getCanonicalContentScriptEntryName, parseCanonicalContentScriptAsset, EXTENSIONJS_CONTENT_SCRIPT_LAYER, isCanonicalContentScriptAsset, getCanonicalContentScriptJsAssetName, getCanonicalContentScriptCssAssetName } from "./291.mjs";
 import { hasProjectDependency, findNearestProjectManifestSync, PROJECT_MANIFEST_FILENAMES, readProjectDependencies } from "./80.mjs";
 import { cssIntegrationsEnabled, cssConfigsDetected, deadCssUrlRef, missingSassDependency, isUsingIntegration, postCssPluginNotResolved } from "./845.mjs";
@@ -200,7 +200,7 @@ function getLoggingPrefix(type) {
 }
 const messages_code = (text)=>pintor.blue(text);
 function webextensionPolyfillNotFound() {
-    return `${getLoggingPrefix('warn')} webextension-polyfill is not installed.\nThe browser API polyfill is disabled for this build.\nInstall it with ${messages_code('npm install webextension-polyfill')}.`;
+    return `${getLoggingPrefix('warn')} webextension-polyfill isn't installed.\nThe browser API polyfill is disabled for this build.\nInstall it with ${messages_code('npm install webextension-polyfill')}.`;
 }
 function browserKey(browser) {
     return String(browser || 'unknown');
@@ -289,7 +289,8 @@ function setupNoBrowserBannerOnFirstDone(opts) {
         humanLine(browserRunnerDisabled({
             browser: opts.browser,
             manifestPath: opts.manifestPath,
-            readyPath: opts.readyPath
+            readyPath: opts.readyPath,
+            distPath: opts.distPath
         }));
         humanLine(spacerLine());
         humanLine(messages_ready('development', opts.browser));
@@ -300,21 +301,17 @@ function setupCompilerDoneDiagnostics(compiler, port) {
     compiler.hooks.done.tap('extension.js:done', (stats)=>{
         try {
             if (stats?.hasErrors?.()) {
-                const str = stats?.toString?.({
-                    colors: true,
-                    all: false,
+                const str = renderStatsBlocks(stats, {
                     errors: true,
                     warnings: true
                 });
-                if (str) console.error(scrubBrand(str));
+                if (str) console.error(str);
             } else if (stats?.hasWarnings?.()) {
-                const str = stats?.toString?.({
-                    colors: true,
-                    all: false,
+                const str = renderStatsBlocks(stats, {
                     errors: false,
                     warnings: true
                 });
-                if (str) console.warn(scrubBrand(str));
+                if (str) console.warn(str);
             }
             if (!reportedNoEntries && 'number' == typeof port) {
                 const info = stats.toJson({
@@ -330,14 +327,12 @@ function setupCompilerDoneDiagnostics(compiler, port) {
                     console.warn(noEntrypointsDetected(port));
                 }
             }
-        } catch (error) {
-            const str = stats?.toString({
-                colors: true,
-                all: false,
+        } catch  {
+            const str = renderStatsBlocks(stats, {
                 errors: true,
                 warnings: true
             });
-            if (str) console.error(scrubBrand(str));
+            if (str) console.error(str);
         }
     });
 }
@@ -350,10 +345,10 @@ function boring(manifestName, durationMs, stats) {
     const hasErrors = stats.hasErrors();
     const hasWarnings = stats.hasWarnings();
     const arrow = hasErrors ? messaging_prefix('error') : hasWarnings ? messaging_prefix('warn') : messaging_prefix('info');
-    const label = hasErrors ? pintor.red('with errors') : hasWarnings ? pintor.yellow('with warnings') : pintor.green('successfully');
+    const status = hasErrors ? `compiled ${pintor.red('with errors')}` : hasWarnings ? `compiled ${pintor.yellow('with warnings')}` : 'compiled';
     const app = manifestName;
     const time = `${durationMs} ms`;
-    return `${arrow} ${timestamp} ${app} compiled ${label} in ${time}.`;
+    return `${arrow} ${timestamp} ${app} ${status} in ${time}.`;
 }
 function cleanDistStarting(distPath) {
     return `${messaging_prefix('debug')} clean    start path=${distPath}`;
@@ -376,34 +371,12 @@ function envInjectedPublicVars(count) {
 function envNoMatchingFile(browser, mode, presentFiles, expectedCandidates) {
     return `Found ${presentFiles.map((file)=>pintor.yellow(file)).join(', ')}, but none match browser ${pintor.yellow(browser)} in mode ${pintor.yellow(mode)}.\nEXTENSION_PUBLIC_* variables read from code are ${pintor.yellow('undefined')} in this build.\nRename the file to one of these, in priority order: ${expectedCandidates.map((file)=>pintor.gray(file)).join(', ')}.\nFamily names apply to every family member, so ${pintor.yellow('.env.chrome')} also matches ${pintor.yellow('chromium')} and ${pintor.yellow('edge')} targets.`;
 }
-const sharedState = {
-    bannerPrinted: false,
-    pendingCompilationLine: ''
-};
-function markBannerPrinted() {
-    sharedState.bannerPrinted = true;
-    if (sharedState.pendingCompilationLine) {
-        humanLine(sharedState.pendingCompilationLine);
-        sharedState.pendingCompilationLine = '';
-    }
-}
-function isBannerPrinted() {
-    if (sharedState.bannerPrinted) return true;
-    if ('true' === process.env.EXTENSION_CLI_BANNER_PRINTED) {
-        markBannerPrinted();
-        return true;
-    }
-    return false;
-}
-function setPendingCompilationLine(line) {
-    sharedState.pendingCompilationLine = line;
-}
 class BoringPlugin {
     static name = 'plugin-boring';
     manifestPath;
     browser;
     sawUserInvalidation = false;
-    printedPostBannerStartupSuccess = false;
+    printedStartupSuccess = false;
     lastKnownManifestName;
     constructor(options){
         this.manifestPath = options.manifestPath;
@@ -412,10 +385,7 @@ class BoringPlugin {
     apply(compiler) {
         compiler.hooks.watchClose.tap('develop:brand:watch-close', ()=>{
             this.sawUserInvalidation = false;
-            this.printedPostBannerStartupSuccess = false;
-        });
-        compiler.hooks.afterDone?.tap('develop:brand:flush', ()=>{
-            isBannerPrinted();
+            this.printedStartupSuccess = false;
         });
         compiler.hooks.done.tap('develop:brand', (stats)=>{
             const hasErrors = Boolean(stats?.hasErrors?.());
@@ -450,14 +420,9 @@ class BoringPlugin {
                     });
                     if (hasUserFileChange) this.sawUserInvalidation = true;
                 }
-                if (browserLaunchEnabled && !isBannerPrinted() && !hasErrors && !hasWarnings) {
-                    this.printedPostBannerStartupSuccess = true;
-                    setPendingCompilationLine(line);
-                    return;
-                }
                 if (browserLaunchEnabled && !hasErrors && !hasWarnings) {
-                    if (!this.sawUserInvalidation) if (this.printedPostBannerStartupSuccess) return;
-                    else this.printedPostBannerStartupSuccess = true;
+                    if (!this.sawUserInvalidation) if (this.printedStartupSuccess) return;
+                    else this.printedStartupSuccess = true;
                 }
                 humanLine(line);
             } catch  {}
@@ -1414,7 +1379,11 @@ class ZipPlugin {
                     try {
                         size = __rspack_external_node_fs_5ea92f0c.statSync(artifact.path).size;
                     } catch  {}
-                    console.log(zipArtifactReady(this.browser, artifact.path, size));
+                    recordZipArtifact(stats?.compilation, {
+                        kind: artifact.kind,
+                        path: artifact.path,
+                        size
+                    });
                 }
                 if (isDebug()) {
                     const sourceItem = created.find((c)=>'source' === c.kind);
@@ -1438,6 +1407,7 @@ class CompilationPlugin {
     zipSource;
     zipFilename;
     port;
+    command;
     constructor(options){
         this.manifestPath = options.manifestPath;
         this.browser = options.browser || 'chrome';
@@ -1446,6 +1416,7 @@ class CompilationPlugin {
         this.zipSource = options.zipSource;
         this.zipFilename = options.zipFilename;
         this.port = options.port;
+        this.command = options.command;
     }
     applyIgnoreWarnings(compiler) {
         const existing = compiler.options.ignoreWarnings;
@@ -1506,7 +1477,7 @@ class CompilationPlugin {
             manifestPath: this.manifestPath,
             browser: this.browser || 'chrome'
         }).apply(compiler);
-        setupCompilerDoneDiagnostics(compiler, this.port);
+        if ('build' !== this.command && 'start' !== this.command) setupCompilerDoneDiagnostics(compiler, this.port);
     }
 }
 const BUNDLED_DEPENDENCY_VERSIONS = {
@@ -3831,7 +3802,8 @@ function fmtKiB(bytes) {
     return `${kib.toFixed(1)} KiB`;
 }
 function perfBudgetWarning(assets) {
-    const header = `${1 === assets.length ? 'asset exceeds' : 'assets exceed'} the extension performance budget. Browser extensions inject content scripts on every navigation and wake service workers from cold, so we apply tighter budgets than the rspack default.`;
+    const count = assets.length;
+    const header = `${1 === count ? 'One asset exceeds' : `${count} assets exceed`} the extension performance budget. Browser extensions inject content scripts on every navigation and wake service workers from cold, so Extension.js applies tighter budgets than the rspack default.`;
     const lines = assets.map((a)=>{
         const over = (a.size / a.budget * 100 - 100).toFixed(0);
         return `  ${a.name}\n    size:   ${fmtKiB(a.size)}\n    budget: ${fmtKiB(a.budget)}  (over by ${over}%)\n    role:   ${categoryRole(a.category)}`;
@@ -5465,7 +5437,7 @@ function reportToCompilation(compilation, compiler, message, type = 'error', fil
     compilation[bucket].push(issue);
 }
 function backgroundIsRequiredMessageOnly(backgroundChunkName) {
-    return `Check the ${pintor.yellow(backgroundChunkName.replace('/', '.'))} field in your ${pintor.yellow('manifest.json')} file.`;
+    return `Check the ${pintor.blue(backgroundChunkName.replace('/', '.'))} field in your ${pintor.blue('manifest.json')} file.`;
 }
 class SetupBackgroundEntry {
     manifestPath;
@@ -7668,47 +7640,41 @@ class WasmPlugin {
 }
 function javaScriptError(errorSourcePath, missingFilePath, opts) {
     const lines = [];
-    lines.push(`Missing script file in ${pintor.underline(errorSourcePath)}.`);
-    lines.push(`Update your ${pintor.yellow("<script>")} src to point to a file that exists.`);
-    if (opts?.publicRootHint) lines.push(`Paths starting with '/' are resolved from the extension output root (served from ${pintor.yellow('public/')}), not your source directory.`);
-    if (opts?.deadRefHint) {
-        lines.push("The build ships an empty placeholder for this script, so the page loads and no 404 appears in DevTools (likely dead code).");
-        lines.push(`Set ${pintor.yellow('EXTENSION_STRICT_REFS=true')} to make this a build error.`);
-    }
-    lines.push('');
-    lines.push(`${pintor.red('NOT FOUND')} ${pintor.underline(missingFilePath)}`);
+    lines.push("The page references a script file that doesn't exist.");
+    lines.push(`${pintor.gray('PATH')} ${pintor.underline(errorSourcePath)}`);
+    lines.push(`${pintor.gray('NOT FOUND')} ${pintor.underline(missingFilePath)}`);
+    if (opts?.publicRootHint) lines.push(`Paths starting with '/' are resolved from the extension output root (served from ${pintor.blue('public/')}), not your source directory.`);
+    if (opts?.deadRefHint) lines.push("The build ships an empty placeholder for this script, so the page loads and no 404 appears in DevTools (likely dead code).");
+    lines.push(`Update the ${pintor.blue("<script>")} src to point to a file that exists.`);
+    if (opts?.deadRefHint) lines.push(`Set ${pintor.blue('EXTENSION_STRICT_REFS=true')} to make this a build error.`);
     return lines.join('\n');
 }
 function cssError(errorSourcePath, missingFilePath, opts) {
     const lines = [];
-    lines.push(`Missing stylesheet in ${pintor.underline(errorSourcePath)}.`);
-    lines.push(`Update your ${pintor.yellow('<link>')} href to point to a file that exists.`);
-    if (opts?.publicRootHint) lines.push(`Paths starting with '/' are resolved from the extension output root (served from ${pintor.yellow('public/')}), not your source directory.`);
-    if (opts?.deadRefHint) {
-        lines.push("Chrome loads the page anyway and 404s this reference silently, so it is likely dead code.");
-        lines.push(`Set ${pintor.yellow('EXTENSION_STRICT_REFS=true')} to make this a build error.`);
-    }
-    lines.push('');
-    lines.push(`${pintor.red('NOT FOUND')} ${pintor.underline(missingFilePath)}`);
+    lines.push("The page references a stylesheet that doesn't exist.");
+    lines.push(`${pintor.gray('PATH')} ${pintor.underline(errorSourcePath)}`);
+    lines.push(`${pintor.gray('NOT FOUND')} ${pintor.underline(missingFilePath)}`);
+    if (opts?.publicRootHint) lines.push(`Paths starting with '/' are resolved from the extension output root (served from ${pintor.blue('public/')}), not your source directory.`);
+    if (opts?.deadRefHint) lines.push("Chrome loads the page anyway and 404s this reference silently, so it is likely dead code.");
+    lines.push(`Update the ${pintor.blue('<link>')} href to point to a file that exists.`);
+    if (opts?.deadRefHint) lines.push(`Set ${pintor.blue('EXTENSION_STRICT_REFS=true')} to make this a build error.`);
     return lines.join('\n');
 }
 function staticAssetError(errorSourcePath, missingFilePath, opts) {
     const extname = __rspack_external_node_path_c5b9b54f.extname(missingFilePath);
     const lines = [];
-    lines.push(`Missing asset in ${pintor.underline(errorSourcePath)}.`);
+    lines.push("The page references an asset that doesn't exist.");
+    lines.push(`${pintor.gray('PATH')} ${pintor.underline(errorSourcePath)}`);
+    lines.push(`${pintor.gray('NOT FOUND')} ${pintor.underline(missingFilePath)}`);
     const ref = opts?.refLabel || `*${extname}`;
-    lines.push(`Update the ${pintor.yellow(ref)} reference to point to a file that exists.`);
-    if (opts?.publicRootHint) lines.push(`Paths starting with '/' are resolved from the extension output root (served from ${pintor.yellow('public/')}), not your source directory.`);
-    if (opts?.deadRefHint) {
-        lines.push("Chrome loads the page anyway and 404s this reference silently, so it is likely dead code.");
-        lines.push(`Set ${pintor.yellow('EXTENSION_STRICT_REFS=true')} to make this a build error.`);
-    }
-    lines.push('');
-    lines.push(`${pintor.red('NOT FOUND')} ${pintor.underline(missingFilePath)}`);
+    if (opts?.publicRootHint) lines.push(`Paths starting with '/' are resolved from the extension output root (served from ${pintor.blue('public/')}), not your source directory.`);
+    if (opts?.deadRefHint) lines.push("Chrome loads the page anyway and 404s this reference silently, so it is likely dead code.");
+    lines.push(`Update the ${pintor.blue(ref)} reference to point to a file that exists.`);
+    if (opts?.deadRefHint) lines.push(`Set ${pintor.blue('EXTENSION_STRICT_REFS=true')} to make this a build error.`);
     return lines.join('\n');
 }
 function fileNotFound(errorSourcePath, missingFilePath, opts) {
-    if (!errorSourcePath) throw new Error('This state should not occur. Please report a bug.');
+    if (!errorSourcePath) throw new Error('This state should not occur. Report a bug.');
     switch(__rspack_external_node_path_c5b9b54f.extname(missingFilePath)){
         case '.js':
         case '.ts':
@@ -7726,38 +7692,34 @@ function fileNotFound(errorSourcePath, missingFilePath, opts) {
 }
 function remoteResourceWarning(errorSourcePath, remoteUrl, kind) {
     const label = "script" === kind ? "<script>" : '<link>';
-    const cspHint = "script" === kind ? "Remote scripts are blocked by the MV3 CSP.\nBundle the script or self-host it instead." : 'Remote styles can be blocked by the CSP.\nBundle the stylesheet or self-host it instead.';
     const lines = [];
-    lines.push(`Remote ${pintor.yellow(label)} in ${pintor.underline(errorSourcePath)}.`);
-    lines.push(cspHint);
-    lines.push('');
-    lines.push(`${pintor.red('URL')} ${pintor.underline(remoteUrl)}`);
+    lines.push("script" === kind ? `The page loads a remote ${pintor.blue(label)}, which the MV3 CSP blocks.` : `The page loads a remote ${pintor.blue(label)}, which the CSP can block.`);
+    lines.push(`${pintor.gray('PATH')} ${pintor.underline(errorSourcePath)}`);
+    lines.push(`${pintor.gray('GOT')} ${pintor.underline(remoteUrl)}`);
+    lines.push("script" === kind ? "Bundle the script or self-host it instead." : "Bundle the stylesheet or self-host it instead.");
     return lines.join('\n');
 }
 function serverRestartRequiredFromHtml(relativeHtmlPath, absoluteHtmlPath) {
     const lines = [];
     lines.push("Entrypoint references changed.");
-    lines.push(`Restart the dev server to pick up changes to ${pintor.yellow("<script>")} and ${pintor.yellow('<link rel="stylesheet">')} entries.`);
-    lines.push('');
     lines.push(`${pintor.gray('PATH')} ${pintor.underline(absoluteHtmlPath)}`);
+    lines.push(`Restart the dev server to pick up changes to ${pintor.blue("<script>")} and ${pintor.blue('<link rel="stylesheet">')} entries.`);
     return lines.join('\n');
 }
 function manifestHtmlEntrypointChange(manifestField, pathAfter, pathBefore) {
     const lines = [];
     const fieldLabel = manifestField ? manifestField.replace(/\//g, '.') : void 0;
-    lines.push(`Entrypoint references changed${fieldLabel ? ` in ${pintor.yellow(fieldLabel)}` : ''}.`);
+    lines.push(`Entrypoint references changed${fieldLabel ? ` in ${pintor.blue(fieldLabel)}` : ''}.`);
+    if (pathBefore) lines.push(`${pintor.gray('EXPECTED')} ${pintor.underline(pathBefore)}`);
+    if (pathAfter) lines.push(`${pintor.gray('GOT')} ${pintor.underline(pathAfter)}`);
     lines.push("Restart the dev server to pick up changes to manifest entrypoints.");
-    lines.push('');
-    if (pathBefore) lines.push(`${pintor.red('PATH BEFORE')} ${pintor.underline(pathBefore)}`);
-    if (pathAfter) lines.push(`${pintor.green('PATH AFTER')} ${pintor.underline(pathAfter)}`);
     return lines.join('\n');
 }
 function manifestPageMissing(manifestField, missingFilePath) {
     const lines = [];
-    lines.push(`Check the ${pintor.yellow(manifestField)} field in your ${pintor.yellow('manifest.json')} file.`);
-    lines.push("The page path must point to an existing HTML file that will be bundled.");
-    lines.push('');
-    lines.push(`${pintor.red('NOT FOUND')} ${pintor.underline(missingFilePath)}`);
+    lines.push(`Can't find the page listed in ${pintor.blue(manifestField)}.`);
+    lines.push(`${pintor.gray('NOT FOUND')} ${pintor.underline(missingFilePath)}`);
+    lines.push(`Update the path in your ${pintor.blue('manifest.json')} to an HTML file that exists.`);
     return lines.join('\n');
 }
 function manifestFieldMessageOnly(manifestField) {
@@ -7765,7 +7727,7 @@ function manifestFieldMessageOnly(manifestField) {
     const contentIndex = manifestField.split('-')[1];
     const isContentScripts = manifestField.startsWith("content_scripts");
     const fieldLabel = isContentScripts ? `content_scripts (index ${contentIndex})` : manifestFieldName;
-    return `Check the ${pintor.yellow(fieldLabel)} field in your ${pintor.yellow('manifest.json')} file.`;
+    return `Check the ${pintor.blue(fieldLabel)} field in your ${pintor.blue('manifest.json')} file.`;
 }
 function injectCssLink(headNode, feature, firstLinkAttrs, hrefOverride) {
     const linkTag = __rspack_external_parse5_utilities_78b19c6a.createNode('link');
@@ -8752,12 +8714,11 @@ class HtmlPlugin {
 }
 function iconsMissingFile(manifestField, filePath, opts) {
     const lines = [];
-    lines.push(`Check the ${pintor.yellow(manifestField)} field in your ${pintor.yellow('manifest.json')} file.`);
-    lines.push("The icon path must point to an existing file that will be packaged with the extension.");
-    lines.push(opts?.fatal ? `Browsers reject the whole extension when this file is missing.\nThe build stops here to protect you.` : `Browsers can reject or misrender the extension when this file is missing.\nThe build continues.`);
-    if (opts?.publicRootHint) lines.push(`Paths starting with '/' are resolved from the extension output root (served from ${pintor.yellow('public/')}), not your source directory.`);
-    lines.push('');
-    lines.push(`${pintor.red('NOT FOUND')} ${pintor.underline(filePath)}`);
+    lines.push(`Can't find an icon file listed in ${pintor.blue(manifestField)}.`);
+    lines.push(`${pintor.gray('NOT FOUND')} ${pintor.underline(filePath)}`);
+    lines.push(opts?.fatal ? `Browsers reject the whole extension when this file is missing.\nThe build stops here.` : `Browsers can reject or misrender the extension when this file is missing.\nThe build continues.`);
+    if (opts?.publicRootHint) lines.push(`Paths starting with '/' are resolved from the extension output root (served from ${pintor.blue('public/')}), not your source directory.`);
+    lines.push(`Update the icon path in your ${pintor.blue('manifest.json')} to a file that ships with the extension.`);
     return lines.join('\n');
 }
 function themeImageMissingFile(manifestField, filePath, opts) {
@@ -8782,11 +8743,10 @@ function themeImageIsEmpty(manifestField, filePath) {
 function manifestIconsEntrypointChange(manifestField, pathAfter, pathBefore) {
     const lines = [];
     const fieldLabel = manifestField ? manifestField.replace(/\//g, '.') : 'icons';
-    lines.push(`Entrypoint references changed in ${pintor.yellow(fieldLabel)}.`);
+    lines.push(`Entrypoint references changed in ${pintor.blue(fieldLabel)}.`);
+    if (pathBefore) lines.push(`${pintor.gray('EXPECTED')} ${pintor.underline(pathBefore)}`);
+    if (pathAfter) lines.push(`${pintor.gray('GOT')} ${pintor.underline(pathAfter)}`);
     lines.push("Restart the dev server to pick up changes to manifest icons.");
-    lines.push('');
-    if (pathBefore) lines.push(`${pintor.red('PATH BEFORE')} ${pintor.underline(pathBefore)}`);
-    if (pathAfter) lines.push(`${pintor.green('PATH AFTER')} ${pintor.underline(pathAfter)}`);
     return lines.join('\n');
 }
 function iconsEmitSummary(feature, stats) {
@@ -9002,39 +8962,35 @@ class IconsPlugin {
 }
 function jsonMissingFile(manifestField, filePath, opts) {
     const lines = [];
-    lines.push(`Check the ${pintor.yellow(manifestField)} field in your ${pintor.yellow('manifest.json')} file.`);
-    lines.push("The JSON path must point to an existing file that will be packaged with the extension.");
-    lines.push(opts?.fatal ? `Browsers can reject or crash the extension when required JSON files (like rulesets or managed schemas) are missing.\nThe build stops here to protect you.` : `Browsers can reject or misread the extension when this file is missing.\nThe build continues.`);
-    if (opts?.publicRootHint) lines.push(`Paths starting with '/' are resolved from the extension output root (served from ${pintor.yellow('public/')}), not your source directory.`);
-    lines.push('');
-    lines.push(`${pintor.red('NOT FOUND')} ${pintor.underline(filePath)}`);
+    lines.push(`Can't find the JSON file listed in ${pintor.blue(manifestField)}.`);
+    lines.push(`${pintor.gray('NOT FOUND')} ${pintor.underline(filePath)}`);
+    lines.push(opts?.fatal ? `Browsers can reject or crash the extension when required JSON files like rulesets are missing.\nThe build stops here.` : `Browsers can reject or misread the extension when this file is missing.\nThe build continues.`);
+    if (opts?.publicRootHint) lines.push(`Paths starting with '/' are resolved from the extension output root (served from ${pintor.blue('public/')}), not your source directory.`);
+    lines.push(`Update the JSON path in your ${pintor.blue('manifest.json')} to a file that ships with the extension.`);
     return lines.join('\n');
 }
 function invalidJsonSyntax(manifestField, file, cause) {
     return [
-        "Invalid JSON.",
-        "",
-        `Check the ${pintor.yellow(manifestField)} field in your ${pintor.yellow('manifest.json')} file.`,
-        `The JSON at ${pintor.underline(file)} could not be parsed:`,
-        `${pintor.red(cause)}`
+        `Can't parse the JSON file listed in ${pintor.blue(manifestField)}.`,
+        `${pintor.gray('PATH')} ${pintor.underline(file)}`,
+        `${pintor.gray('REASON')} ${pintor.underline(cause)}`,
+        "Fix the JSON syntax, then rebuild."
     ].join('\n');
 }
 function invalidRulesetStructure(manifestField, file) {
     return [
-        "Invalid Declarative Net Request ruleset.",
-        "",
-        `Check the ${pintor.yellow(manifestField)} field in your ${pintor.yellow('manifest.json')} file.`,
-        "Chrome expects a top-level JSON array of rule objects.",
-        `${pintor.red('INVALID SHAPE')} ${pintor.underline(file)}`
+        `The Declarative Net Request ruleset listed in ${pintor.blue(manifestField)} isn't a rule array.`,
+        `${pintor.gray('PATH')} ${pintor.underline(file)}`,
+        `${pintor.gray('EXPECTED')} ${pintor.underline('a top-level JSON array of rule objects')}`,
+        "Update the file to contain an array of rules."
     ].join('\n');
 }
 function invalidManagedSchemaStructure(manifestField, file) {
     return [
-        "Invalid managed storage schema.",
-        "",
-        `Check the ${pintor.yellow(manifestField)} field in your ${pintor.yellow('manifest.json')} file.`,
-        "Expected a top-level JSON object describing the schema.",
-        `${pintor.red('INVALID SHAPE')} ${pintor.underline(file)}`
+        `The managed storage schema listed in ${pintor.blue(manifestField)} isn't a schema object.`,
+        `${pintor.gray('PATH')} ${pintor.underline(file)}`,
+        `${pintor.gray('EXPECTED')} ${pintor.underline('a top-level JSON object describing the schema')}`,
+        "Update the file to contain a schema object."
     ].join('\n');
 }
 function jsonEmitSummary(feature, stats) {
@@ -9205,34 +9161,34 @@ class JsonPlugin {
     }
 }
 function manifestNotFoundMessageOnly(absPath) {
-    return `Check for a valid manifest.json file.\n\nNOT FOUND ${absPath}`;
+    return `Can't find a manifest.json file.\nNOT FOUND ${absPath}\nAdd a manifest.json file to your project root.`;
 }
 function messages_entryNotFoundMessageOnly(manifestField, absPath) {
-    const guidance = `Check the ${manifestField} field in your manifest.json file.`;
-    const suffix = absPath ? `\n\nNOT FOUND ${absPath}` : '';
-    return guidance + suffix;
+    const lines = [
+        `Can't find the file listed in ${manifestField}.`
+    ];
+    if (absPath) lines.push(`NOT FOUND ${absPath}`);
+    lines.push(`Update the ${manifestField} field in your manifest.json file.`);
+    return lines.join('\n');
 }
 function defaultLocaleSpecifiedButLocalesMissing() {
     return "default_locale is set, but the _locales folder is missing.\nAdd _locales/<default>/messages.json.";
 }
 function defaultLocaleFolderMissing(defaultLocale) {
-    return `Default locale folder is missing: _locales/${defaultLocale}.\nCreate it and add messages.json.`;
+    return `The default locale folder is missing.\nNOT FOUND _locales/${defaultLocale}\nCreate the folder and add a messages.json file.`;
 }
 function defaultLocaleMessagesMissing(defaultLocale) {
-    return `Default locale messages.json is missing: _locales/${defaultLocale}/messages.json.\nCreate the file with your strings.`;
+    return `The default locale messages.json file is missing.\nNOT FOUND _locales/${defaultLocale}/messages.json\nCreate the file with your strings.`;
 }
 function localesPresentButNoDefaultLocale() {
     return "The _locales folder exists, but manifest.json is missing default_locale.\nAdd default_locale to manifest.json.";
 }
 function invalidMessagesJson(absPath) {
-    return `Invalid JSON in locale messages file: ${absPath}.\nFix the JSON syntax and try again.`;
+    return `Can't parse a locale messages.json file.\nPATH ${absPath}\nFix the JSON syntax and try again.`;
 }
 function missingManifestMessageKey(key, defaultLocale) {
-    const header = 'Check the i18n placeholders in your manifest.json file.';
     const localePath = defaultLocale ? `_locales/${defaultLocale}/messages.json` : '_locales/<default>/messages.json';
-    const guidance = `The key "${key}" referenced via __MSG_${key}__ must be defined in ${localePath}.\nAdd the key to that file.`;
-    const final = `MISSING KEY ${key} in ${localePath}`;
-    return `${header}\n${guidance}\n\n${final}`;
+    return `The manifest references __MSG_${key}__, but the key "${key}" isn't defined.\nNOT FOUND ${key}\nPATH ${localePath}\nAdd the key to the messages file.`;
 }
 function localesIncludeSummary(hasManifest, hasLocalesRoot, defaultLocale) {
     const dl = defaultLocale || 'none';
@@ -9248,7 +9204,7 @@ function localesValidationDetected(issue) {
     return `${messaging_prefix('debug')} locales  validation="${issue}"`;
 }
 function localesMustBeAtProjectRoot(foundAt, expectedAt) {
-    return `_locales/ is canonically placed at the project root, next to package.json, public/ and dist/, because Chrome reads locales from the extension root.\nThis one sits in the legacy next-to-manifest location.\nMove it to the project root to silence this warning.\nThe build uses it either way.\n\n  found:    ${foundAt}\n  preferred: ${expectedAt}`;
+    return `The _locales folder sits in the legacy next-to-manifest location.\nGOT ${foundAt}\nEXPECTED ${expectedAt}\nChrome reads locales from the extension root, so _locales/ is canonically placed at the project root.\nThe build uses it either way.\nMove the folder to the project root to silence this warning.`;
 }
 function isUsableDir(p) {
     try {
@@ -9478,26 +9434,23 @@ class LocalesPlugin {
 function serverRestartRequiredFromManifestError(fileAdded, fileRemoved) {
     const lines = [];
     lines.push("Entrypoint references changed.");
+    if (fileRemoved) lines.push(`${pintor.gray('EXPECTED')} ${pintor.underline(fileRemoved)}`);
+    if (fileAdded) lines.push(`${pintor.gray('GOT')} ${pintor.underline(fileAdded)}`);
     lines.push("Restart the dev server to pick up changes to manifest entrypoints.");
-    lines.push('');
-    if (fileRemoved) lines.push(`${pintor.red('PATH BEFORE')} ${pintor.underline(fileRemoved)}`);
-    if (fileAdded) lines.push(`${pintor.green('PATH AFTER')} ${pintor.underline(fileAdded)}`);
     return lines.join('\n');
 }
 function legacyManifestPathWarning(legacyPath) {
     const lines = [];
-    lines.push(`${messaging_prefix('warn')} Deprecated manifest path detected.`);
+    lines.push(`${messaging_prefix('warn')} The manifest uses a deprecated path.`);
+    lines.push(`${pintor.gray('PATH')} ${pintor.underline(legacyPath)}`);
     lines.push("Extension.js rewrites it to the standardized folders in the next major.");
-    lines.push('');
-    lines.push(`${pintor.brightBlue('PATH')} ${pintor.underline(legacyPath)}`);
     return lines.join('\n');
 }
 function fatalManifestShapeFixed(field, detail) {
     const lines = [];
-    lines.push(`${messaging_prefix('warn')} Repaired a manifest field Chrome refuses to load the extension over.`);
-    lines.push("Fix it in your manifest.json.");
-    lines.push('');
-    lines.push(`${pintor.brightBlue('FIELD')} ${pintor.underline(field)}, ${detail}`);
+    lines.push(`${messaging_prefix('warn')} Repaired the ${pintor.blue(field)} field, which Chrome refuses to load the extension over.`);
+    lines.push(`${pintor.gray('REASON')} ${pintor.underline(detail)}`);
+    lines.push(`Fix the field in your ${pintor.blue('manifest.json')} file.`);
     return lines.join('\n');
 }
 function invalidThemeValue(field, detail, value) {
@@ -9511,18 +9464,16 @@ function invalidThemeValue(field, detail, value) {
 }
 function missingGeckoDataCollectionPermissions() {
     const lines = [];
-    lines.push(`${messaging_prefix('warn')} addons.mozilla.org requires ${pintor.yellow('browser_specific_settings.gecko.data_collection_permissions')} for new add-ons.`);
-    lines.push('Declare {"required": ["none"]} if this extension transmits no data.');
-    lines.push('');
-    lines.push(`${pintor.brightBlue('DOCS')} ${pintor.underline('https://extensionworkshop.com/documentation/develop/firefox-builtin-data-consent/')}`);
+    lines.push(`${messaging_prefix('warn')} addons.mozilla.org requires ${pintor.blue('browser_specific_settings.gecko.data_collection_permissions')} for new add-ons.`);
+    lines.push(`Declare ${pintor.blue('{"required": ["none"]}')} if this extension transmits no data.`);
+    lines.push(`See ${pintor.underline('https://extensionworkshop.com/documentation/develop/firefox-builtin-data-consent/')} for details.`);
     return lines.join('\n');
 }
 function manifestInvalidError(error) {
     const lines = [];
-    lines.push(`Invalid ${pintor.yellow('manifest.json')}.`);
+    lines.push(`Can't read your ${pintor.blue('manifest.json')} file.`);
+    lines.push(`${pintor.gray('REASON')} ${pintor.underline(String(error))}`);
     lines.push("Update your manifest and try again.");
-    lines.push('');
-    lines.push(`${pintor.red('REASON')} ${pintor.red(String(error))}`);
     return lines.join('\n');
 }
 function manifestIncludeSummary(browser, manifestPath) {
@@ -9995,47 +9946,43 @@ function cleanMatches(matches) {
 function warFieldError(filePath, opts) {
     const displayPath = opts?.overrideNotFoundPath || filePath;
     const lines = [];
-    if (opts?.relativeRef) lines.push(`The file ${pintor.yellow(opts.relativeRef)} defined in ${pintor.yellow('web_accessible_resources')} was not found.`);
-    else lines.push(`A file listed in ${pintor.yellow('web_accessible_resources')} was not found.`);
-    lines.push(`Only list assets your pages fetch with ${pintor.yellow('chrome.runtime.getURL()')}.`);
-    lines.push("Imports from content scripts are bundled automatically and do not need to be listed here.");
+    if (opts?.relativeRef) lines.push(`Can't find the file ${pintor.blue(opts.relativeRef)} listed in ${pintor.blue('web_accessible_resources')}.`);
+    else lines.push(`Can't find a file listed in ${pintor.blue('web_accessible_resources')}.`);
+    lines.push(`${pintor.gray('NOT FOUND')} ${pintor.underline(displayPath)}`);
+    lines.push(`Only list assets your pages fetch with ${pintor.blue('chrome.runtime.getURL()')}.`);
+    lines.push("Imports from content scripts are bundled automatically and don't need to be listed here.");
     if (opts?.publicRootHint) {
-        lines.push(`To reference files in ${pintor.yellow('public/')}, use a leading '/' (e.g. ${pintor.yellow('/open-panel.gif')}).`);
+        lines.push(`To reference files in ${pintor.blue('public/')}, use a leading '/' (for example ${pintor.blue('/open-panel.gif')}).`);
         lines.push("These resolve from the built extension root.");
-        lines.push('');
-        lines.push(`Add the file to ${pintor.yellow('public/')}, or update the path to a root-absolute location.`);
+        lines.push(`Learn more: ${pintor.underline('https://extension.js.org/docs/development/web-accessible-resources')}`);
+        lines.push(`Add the file to ${pintor.blue('public/')}, or update the path to a root-absolute location.`);
     } else if (opts?.sourceSibling) {
-        lines.push(`Found ${pintor.yellow(opts.sourceSibling)}, but web_accessible_resources entries are copied as-is, not compiled.`);
-        lines.push('');
-        lines.push(`Import the file from a script so it gets bundled, or move a prebuilt copy to ${pintor.yellow('public/')} and reference it with a leading '/'.`);
+        lines.push(`Found ${pintor.underline(opts.sourceSibling)}, but web_accessible_resources entries are copied as-is, not compiled.`);
+        lines.push(`Learn more: ${pintor.underline('https://extension.js.org/docs/development/web-accessible-resources')}`);
+        lines.push("- Import the file from a script so it gets bundled.");
+        lines.push(`- Move a prebuilt copy to ${pintor.blue('public/')} and reference it with a leading '/'.`);
     } else {
         lines.push("Relative paths must point to a real source file so the build can emit it.");
-        lines.push('');
+        lines.push(`Learn more: ${pintor.underline('https://extension.js.org/docs/development/web-accessible-resources')}`);
         lines.push("Create the missing file, or update the path to an existing source file.");
     }
-    lines.push(`Learn more: ${pintor.underline('https://extension.js.org/docs/development/web-accessible-resources')}`);
-    lines.push('');
-    lines.push(`${pintor.red('NOT FOUND')} ${pintor.underline(displayPath)}`);
     return lines.join('\n');
 }
 function warStringEntryInMv3(entry) {
     const lines = [];
-    lines.push(`Check the ${pintor.yellow('web_accessible_resources')} field in your ${pintor.yellow('manifest.json')} file.`);
-    lines.push(`Manifest V3 requires object entries with ${pintor.yellow('resources')} and ${pintor.yellow('matches')} (or ${pintor.yellow('extension_ids')}).`);
-    lines.push("Plain string entries are the Manifest V2 format and Chrome rejects them at load time.");
-    lines.push('');
-    lines.push(`Wrap it like ${pintor.yellow(`{"resources": ["${entry}"], "matches": ["<all_urls>"]}`)} with the matches your pages need.`);
-    lines.push('');
-    lines.push(`${pintor.red('INVALID MV3 ENTRY')} ${pintor.underline(entry)}`);
+    lines.push(`Chrome rejects plain string entries in ${pintor.blue('web_accessible_resources')} under Manifest V3.`);
+    lines.push(`${pintor.gray('GOT')} ${pintor.underline(entry)}`);
+    lines.push("Plain string entries are the Manifest V2 format.");
+    lines.push(`Manifest V3 requires object entries with ${pintor.blue('resources')} and ${pintor.blue('matches')} (or ${pintor.blue('extension_ids')}).`);
+    lines.push(`Wrap it like ${pintor.blue(`{"resources": ["${entry}"], "matches": ["<all_urls>"]}`)} with the matches your pages need.`);
     return lines.join('\n');
 }
 function warInvalidMatchPattern(pattern) {
     const lines = [];
-    lines.push(`Check the ${pintor.yellow('web_accessible_resources')} field in your ${pintor.yellow('manifest.json')} file.`);
-    lines.push(`Chrome requires match patterns to end with ${pintor.yellow('/*')} and not include deeper paths.`);
-    lines.push(`See ${pintor.underline('https://developer.chrome.com/docs/extensions/reference/manifest/web-accessible-resources#manifest_declaration')}`);
-    lines.push('');
-    lines.push(`${pintor.red('INVALID MATCH PATTERN')} ${pintor.underline(pattern)}`);
+    lines.push(`Chrome rejects a match pattern in ${pintor.blue('web_accessible_resources')}.`);
+    lines.push(`${pintor.gray('GOT')} ${pintor.underline(pattern)}`);
+    lines.push(`Match patterns must end with ${pintor.blue('/*')} and can't include deeper paths.`);
+    lines.push(`Update the pattern in your ${pintor.blue('manifest.json')} file. See ${pintor.underline('https://developer.chrome.com/docs/extensions/reference/manifest/web-accessible-resources#manifest_declaration')} for the format.`);
     return lines.join('\n');
 }
 function entryImportsSummary(entryCount, totalResources) {
@@ -11878,7 +11825,8 @@ function webpackConfig(projectStructure, devOptions) {
             zip: true === devOptions.zip,
             zipSource: true === devOptions.zipSource,
             zipFilename: devOptions.zipFilename,
-            port: 'string' == typeof devOptions.port ? parseInt(devOptions.port, 10) : devOptions.port
+            port: 'string' == typeof devOptions.port ? parseInt(devOptions.port, 10) : devOptions.port,
+            command: devOptions.metadataCommand
         }),
         new StaticAssetsPlugin({
             manifestPath,