extension-develop 4.1.31 → 4.1.32

package/dist/contract/codes.json

@@ -1,6 +1,6 @@
 {
   "schema": 1,
-  "note": "The durable error-code table for the schema-1 envelope. Codes may be added, never renamed or removed. One code per operator-distinguishable failure family; the envelope's command field carries the which-command context. 'folded' records finer inventory names that map onto a shipped family code. 'legacy' maps the three pre-envelope conventions (snake_case ready.json codes, PascalCase error names, kebab-case doctor check ids) onto the table.",
+  "note": "The durable error-code table for the schema-1 envelope. Codes may be added, never renamed. A code retired after it shipped keeps a 'folded' row pointing at the code the same path reports now, so a consumer that still lists the name resolves it. One code per operator-distinguishable failure family; the envelope's command field carries the which-command context. 'folded' records finer inventory names that map onto a shipped family code. 'legacy' maps the three pre-envelope conventions (snake_case ready.json codes, PascalCase error names, kebab-case doctor check ids) onto the table; a ready.json id that lists several codes resolves to the first unless the contract's browserLaunchFailedCode names another from the list. A row marked 'reserved' names a failure the CLI does not report under that code today, so no envelope carries it yet and a consumer need not handle it; its 'reason' says what keeps it reserved.",
   "codes": {
     "E_ARGS": {
       "area": "usage",
@@ -60,7 +60,8 @@
     },
     "E_MANAGED_DEP_CONFLICT": {
       "area": "project",
-      "summary": "The project declares a package the toolchain manages."
+      "summary": "The project declares a package the toolchain manages.",
+      "warn": true
     },
     "E_DEPENDENCY_INSTALL": {
       "area": "project",
@@ -68,11 +69,8 @@
     },
     "E_TYPES_EMIT": {
       "area": "project",
-      "summary": "Writing extension-env.d.ts failed."
-    },
-    "E_TSCONFIG_MISSING": {
-      "area": "project",
-      "summary": "TypeScript sources exist with no tsconfig.json beside package.json."
+      "summary": "Writing extension-env.d.ts failed.",
+      "warn": true
     },
     "E_OPTIONAL_DEP_UNRESOLVED": {
       "area": "project",
@@ -143,7 +141,8 @@
     },
     "E_CSS_PARSE": {
       "area": "compile",
-      "summary": "A stylesheet failed to parse."
+      "summary": "A stylesheet failed to parse.",
+      "warn": true
     },
     "E_CSS_PREPROCESSOR_MISSING": {
       "area": "compile",
@@ -155,26 +154,20 @@
       "summary": "A CSS url() points at nothing.",
       "warn": true
     },
-    "E_INTEGRATION_INSTALL": {
-      "area": "compile",
-      "summary": "A framework integration failed to install."
-    },
     "E_POLYFILL_NOT_FOUND": {
       "area": "compile",
-      "summary": "webextension-polyfill requested but absent."
+      "summary": "webextension-polyfill requested but absent.",
+      "warn": true
     },
     "E_LOCALES_LAYOUT": {
       "area": "compile",
-      "summary": "_locales layout or messages.json is invalid."
+      "summary": "_locales layout or messages.json is invalid.",
+      "warn": true
     },
     "E_WAR_INVALID": {
       "area": "compile",
       "summary": "web_accessible_resources shape or match pattern rejected."
     },
-    "E_MATCH_PATTERN_INVALID": {
-      "area": "compile",
-      "summary": "The browser rejected a content-script match pattern."
-    },
     "E_BACKGROUND_REQUIRED": {
       "area": "compile",
       "summary": "The reload runtime needs a background chunk that is absent."
@@ -185,7 +178,8 @@
     },
     "E_NO_ENTRYPOINTS": {
       "area": "compile",
-      "summary": "The compilation produced zero entrypoints."
+      "summary": "The compilation produced zero entrypoints.",
+      "warn": true
     },
     "E_REMOTE_RESOURCE_BLOCKED": {
       "area": "compile",
@@ -253,7 +247,7 @@
     },
     "E_BROWSER_START_TIMEOUT": {
       "area": "browser-binary",
-      "summary": "The browser never signalled startup."
+      "summary": "The browser accepted the debug socket but never sent its greeting."
     },
     "E_PROFILE_LOCKED": {
       "area": "browser-binary",
@@ -261,16 +255,13 @@
     },
     "E_LAUNCH_SKIPPED_COMPILE_ERRORS": {
       "area": "browser-binary",
-      "summary": "Launch was withheld because the compile failed."
+      "summary": "Launch was withheld because the compile failed.",
+      "warn": true
     },
     "E_INSTANCE_AMBIGUOUS": {
       "area": "browser-binary",
       "summary": "More than one live instance matches the requested id."
     },
-    "E_WSL_INTEROP": {
-      "area": "browser-binary",
-      "summary": "WSL interop could not resolve a Windows browser."
-    },
     "E_BROWSER_DOWNLOAD": {
       "area": "browser-binary",
       "summary": "Downloading or installing a browser failed."
@@ -345,6 +336,10 @@
       "area": "ready",
       "summary": "The session contract reports a stopped session."
     },
+    "E_SESSION_EXISTS": {
+      "area": "dev-server",
+      "summary": "A live dev session already owns this project and browser, so the new session was refused."
+    },
     "E_READY_TIMEOUT": {
       "area": "ready",
       "summary": "--wait expired before the session became ready."
@@ -371,7 +366,7 @@
     },
     "E_CSP_BLOCKS_EVAL": {
       "area": "control",
-      "summary": "The extension's own content security policy forbids eval in this document, so no expression can run there."
+      "summary": "A content security policy forbids eval in the target, the extension's own for its documents and its content-script world or the page's own for a web page, so the in-page executor runs no expression there."
     },
     "E_TIMEOUT": {
       "area": "control",
@@ -395,7 +390,7 @@
     },
     "E_EVAL": {
       "area": "control",
-      "summary": "The evaluated expression threw inside the page."
+      "summary": "The evaluated expression threw inside the page, whatever the class of the error it threw."
     },
     "E_INSPECT": {
       "area": "control",
@@ -467,7 +462,18 @@
       "dev_server_start_failed": "E_DEV_SERVER_START",
       "preview_manifest_missing": "E_PREVIEW_NO_DIST",
       "browser_exited": "E_BROWSER_EXITED",
-      "browser_launch_failed": "E_BROWSER_LAUNCH",
+      "browser_launch_failed": [
+        "E_BROWSER_LAUNCH",
+        "E_BROWSER_BINARY_INVALID",
+        "E_FLAG_NOT_SUPPORTED_HERE",
+        "E_BROWSER_BINARY_REQUIRED",
+        "E_BROWSER_NOT_FOUND",
+        "E_BROWSER_START_TIMEOUT",
+        "E_BROWSER_CONNECT",
+        "E_BROWSER_CONNECTION_CLOSED",
+        "E_RDP_PROTOCOL",
+        "E_ADDON_INSTALL"
+      ],
       "extension_load_refused": "E_EXTENSION_LOAD_REFUSED",
       "profile_locked": "E_PROFILE_LOCKED"
     },
@@ -552,6 +558,10 @@
     "E_SAFARI_BUNDLE_ID_INVALID": "E_INVALID_OPTION",
     "E_PUBLISH_NO_TOKEN": "E_AUTH_REQUIRED",
     "E_PUBLISH_UNREACHABLE": "E_NETWORK",
-    "E_UNKNOWN": "E_INTERNAL"
+    "E_UNKNOWN": "E_INTERNAL",
+    "E_TSCONFIG_MISSING": "E_COMPILE",
+    "E_INTEGRATION_INSTALL": "E_DEPENDENCY_INSTALL",
+    "E_WSL_INTEROP": "E_BROWSER_NOT_FOUND",
+    "E_MATCH_PATTERN_INVALID": "E_EXTENSION_LOAD_REFUSED"
   }
 }

package/dist/contract/envelope.schema.json

@@ -38,6 +38,22 @@
                 "path": { "type": "string" },
                 "version": { "type": "string" }
               }
+            },
+            "details": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "required": ["message", "severity"],
+                "properties": {
+                  "code": { "type": "string", "pattern": "^E_[A-Z0-9_]+$" },
+                  "message": { "type": "string" },
+                  "file": { "type": "string" },
+                  "line": { "type": "integer" },
+                  "column": { "type": "integer" },
+                  "severity": { "enum": ["error", "warning"] },
+                  "name": { "type": "string" }
+                }
+              }
             }
           }
         }

package/dist/contract/golden.build.compile.json

@@ -6,8 +6,25 @@
   "value": null,
   "error": {
     "code": "E_COMPILE",
-    "message": "Build failed with 2 errors."
+    "message": "Build failed with errors",
+    "details": [
+      {
+        "code": "E_CONTENT_SCRIPT_SYNTAX",
+        "message": "Module build failed (from builtin:swc-loader):\n  ╰─▶   × Syntax Error: Expression expected\n          ╭─[82:15]\n       80 │   return unmount;\n       81 │ }\n       82 │ const broken = ;\n          ·                ─\n       83 │\n       84 │ try { __EXTENSIONJS_scheduleBundleCssHydration() } catch (error) {\n          ╰────",
+        "file": "content/scripts.js",
+        "severity": "error",
+        "name": "ModuleBuildError"
+      },
+      {
+        "code": "E_MODULE_NOT_FOUND",
+        "message": "Module not found: Can't resolve './missing' in '/home/dev/my-extension'\n   ╭─[1:0]\n 1 │ import './missing';\n   · ───────────────────\n 2 │ console.log('x');\n   ╰────",
+        "file": "background.js",
+        "line": 1,
+        "column": 1,
+        "severity": "error"
+      }
+    ]
   },
-  "hint": "Fix the error above and run build again.",
-  "warnings": []
+  "warnings": [],
+  "hint": "Fix the error above and run build again."
 }

package/dist/contract/golden.eval.csp-blocks-eval.page.json

@@ -0,0 +1,15 @@
+{
+  "schema": 1,
+  "ok": false,
+  "command": "eval",
+  "status": "denied",
+  "value": null,
+  "error": {
+    "code": "E_CSP_BLOCKS_EVAL",
+    "message": "call to eval() blocked by CSP",
+    "name": "EvalError",
+    "engine": "firefox",
+    "hint": "The page's own Content-Security-Policy forbids eval, so the in-page executor runs no expression in this tab. The extension's policy is not involved. Read the page with extension inspect --context page --tab <id>. Firefox evaluates such a page through its debugger instead when exactly one open tab is on that url, so close the duplicate tab and run it again."
+  },
+  "warnings": []
+}

package/dist/css-parse-guard-loader.mjs

@@ -16,7 +16,9 @@ function pitch() {
             });
             callback(null);
         } catch (error) {
-            this.emitWarning(new Error(cssParseErrorShippedVerbatim(this.resourcePath, error)));
+            this.emitWarning(Object.assign(new Error(cssParseErrorShippedVerbatim(this.resourcePath, error)), {
+                name: 'CssParseWarning'
+            }));
             const moduleType = String(this._module?.type || '');
             if (moduleType.startsWith('css')) return void callback(null, verbatimCssPlaceholder(registerVerbatimCss(raw, this.resourcePath)));
             callback(null, raw);

package/dist/dead-css-url-loader.mjs

@@ -1,12 +1,119 @@
 import { createRequire as __extjsCreateRequire } from "node:module"; const require = __extjsCreateRequire(import.meta.url);
 import { WebpackError } from "@rspack/core";
-import { publicContainmentRoot } from "./105~0.mjs";
+import { isDeadCssUrlRef, publicOwnedOutputName, extractCssUrlRefs, toPosixPath, replaceCssUrlRefs } from "./273~0.mjs";
+import { toJsStringLiteral } from "./363~0.mjs";
+import { resolvePublicFolder, publicContainmentRoot } from "./105~0.mjs";
 import { canonicalizeDir, canonicalizeResourcePath } from "./712~0.mjs";
-import { isDeadCssUrlRef, extractCssUrlRefs, toPosixPath } from "./273~0.mjs";
 import { deadCssUrlRef } from "./524~0.mjs";
-import { toRuntimeStylesheetModule, rewriteInlinedCssUrls } from "./747~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_fs_1b05aee1 from "node:fs";
+const EXTENSION_ROOT_PLACEHOLDER = '__EXTENSIONJS_EXTENSION_ROOT__/';
+const BUNDLED_FILE_TOKEN = /__EXTENSIONJS_CSS_FILE_(\d+)__([^"\\]*)/g;
+function bundledFileToken(index) {
+    return `__EXTENSIONJS_CSS_FILE_${index}__`;
+}
+function isFile(candidate) {
+    try {
+        return __rspack_external_node_fs_1b05aee1.statSync(candidate).isFile();
+    } catch  {
+        return false;
+    }
+}
+function resolveTarget(req, { resourcePath, manifestDir, publicRoot, publicDir }) {
+    if (req.startsWith('/')) {
+        const rel = req.slice(1);
+        const fromPublic = __rspack_external_node_path_806ed179.join(publicRoot, rel);
+        if (isFile(fromPublic)) return {
+            absolutePath: fromPublic,
+            outputName: toPosixPath(__rspack_external_node_path_806ed179.normalize(rel)),
+            publicOwned: true
+        };
+        const fromManifest = __rspack_external_node_path_806ed179.join(manifestDir, rel);
+        if (!isFile(fromManifest)) return;
+        return {
+            absolutePath: fromManifest,
+            publicOwned: false
+        };
+    }
+    const absolutePath = __rspack_external_node_path_806ed179.resolve(__rspack_external_node_path_806ed179.dirname(resourcePath), req);
+    if (!isFile(absolutePath)) return;
+    const publicPath = publicOwnedOutputName(absolutePath, publicDir);
+    if (publicPath) return {
+        absolutePath,
+        outputName: publicPath,
+        publicOwned: true
+    };
+    return {
+        absolutePath,
+        publicOwned: false
+    };
+}
+function rewriteInlinedCssUrls(source, context) {
+    const targets = [];
+    const seen = new Map();
+    const css = replaceCssUrlRefs(source, (request)=>{
+        const suffixAt = request.search(/[?#]/);
+        const req = -1 === suffixAt ? request : request.slice(0, suffixAt);
+        const suffix = -1 === suffixAt ? '' : request.slice(suffixAt);
+        if (!req || req.startsWith('//') || /^[a-z][a-z0-9+.-]*:/i.test(req)) return;
+        if (req.startsWith('~') || req.startsWith('@')) return;
+        if (req.startsWith(EXTENSION_ROOT_PLACEHOLDER)) return;
+        let named = seen.get(req);
+        if (!named) {
+            const target = resolveTarget(req, context);
+            if (!target) return;
+            named = target.publicOwned ? `${EXTENSION_ROOT_PLACEHOLDER}${target.outputName}` : bundledFileToken(targets.filter((other)=>!other.publicOwned).length);
+            seen.set(req, named);
+            targets.push({
+                request: req,
+                ...target
+            });
+        }
+        return `${named}${suffix}`;
+    });
+    return {
+        css,
+        targets
+    };
+}
+function toRuntimeStylesheetModule(css, bundledRequests = []) {
+    const root = JSON.stringify(EXTENSION_ROOT_PLACEHOLDER);
+    const rooted = `__extjsCssText.split(${root}).join(__extjsExtensionRoot())`;
+    const text = 0 === bundledRequests.length ? rooted : `${rooted}.replace(${String(BUNDLED_FILE_TOKEN)}, __extjsCssFile)`;
+    return [
+        `var __extjsCssText = ${JSON.stringify(css)};`,
+        'function __extjsExtensionRoot() {',
+        '  try {',
+        '    var b = globalThis.browser;',
+        '    if (typeof b === "object" && b && b.runtime && typeof b.runtime.getURL === "function") return String(b.runtime.getURL("/"));',
+        '  } catch (error) {}',
+        '  try {',
+        '    var c = globalThis.chrome;',
+        '    if (typeof c === "object" && c && c.runtime && typeof c.runtime.getURL === "function") return String(c.runtime.getURL("/"));',
+        '  } catch (error) {}',
+        '  try {',
+        '    var base = (typeof globalThis === "object" && globalThis && globalThis.__EXTJS_EXTENSION_BASE__) ? String(globalThis.__EXTJS_EXTENSION_BASE__) : "";',
+        '    if (!base && typeof document === "object" && document && document.documentElement) base = String(document.documentElement.getAttribute("data-extjs-extension-base") || "");',
+        '    if (!base && typeof __webpack_require__ === "function" && __webpack_require__.extjsBase) base = String(__webpack_require__.extjsBase);',
+        '    if (base) return base.replace(/\\/+$/, "") + "/";',
+        '  } catch (error) {}',
+        '  return "/";',
+        '}',
+        ...0 === bundledRequests.length ? [] : [
+            `var __extjsCssFiles = [${bundledRequests.map((request)=>`function(){ return new URL(${toJsStringLiteral(request)}, import.meta.url); }`).join(', ')}];`,
+            'function __extjsCssFile(match, index, suffix) {',
+            '  try {',
+            '    var file = __extjsCssFiles[Number(index)]();',
+            '    if (file.protocol === "data:") return file.href;',
+            '    return __extjsExtensionRoot() + String(file.pathname).replace(/^\\/+/, "") + suffix;',
+            '  } catch (error) {}',
+            '  return "about:invalid";',
+            '}'
+        ],
+        `module.exports = "data:text/css;charset=utf-8," + encodeURIComponent(${text});`,
+        ''
+    ].join('\n');
+}
 function reportDeadRefs(loader, source, manifestDir, publicRoot) {
     const roots = [
         publicRoot,
@@ -24,27 +131,37 @@ function reportDeadRefs(loader, source, manifestDir, publicRoot) {
         })) continue;
         const report = new WebpackError(deadCssUrlRef(issuerPath, request));
         report.file = issuerPath;
+        report.name = 'CssDeadRef';
         const sink = strict ? compilation?.errors : compilation?.warnings;
         if (sink) sink.push(report);
         else if (strict) loader.emitError(report);
         else loader.emitWarning(report);
     }
 }
-function emitTargets(loader, source, manifestDir, publicRoot, sheet) {
+function resolveTargets(loader, source, manifestDir, publicRoot, publicDir) {
+    const resourcePath = canonicalizeResourcePath(loader.resourcePath);
     const { css, targets } = rewriteInlinedCssUrls(source, {
-        resourcePath: canonicalizeResourcePath(loader.resourcePath),
+        resourcePath,
         manifestDir,
-        publicRoot
+        publicRoot,
+        publicDir
     });
-    if ('function' != typeof loader.emitFile) return source;
+    const bundledRequests = [];
     for (const target of targets){
-        if (!target.publicOwned || 'chunk' === sheet) loader.emitFile(target.outputName, __rspack_external_node_fs_1b05aee1.readFileSync(target.absolutePath));
+        if (!target.publicOwned) {
+            const request = toPosixPath(__rspack_external_node_path_806ed179.relative(__rspack_external_node_path_806ed179.dirname(resourcePath), target.absolutePath));
+            bundledRequests.push(request.startsWith('../') || __rspack_external_node_path_806ed179.isAbsolute(request) ? request : `./${request}`);
+        }
         loader.addDependency?.(target.absolutePath);
     }
-    return css;
+    return {
+        css,
+        bundledRequests
+    };
 }
 function deadCssUrlLoader(source) {
     let css = source;
+    let bundledRequests = [];
     const options = this.getOptions() || {};
     try {
         const { manifestPath, projectPath } = options;
@@ -52,10 +169,9 @@ function deadCssUrlLoader(source) {
             const manifestDir = canonicalizeDir(__rspack_external_node_path_806ed179.dirname(manifestPath));
             const publicRoot = canonicalizeDir(publicContainmentRoot(manifestPath, projectPath));
             reportDeadRefs(this, source, manifestDir, publicRoot);
-            css = emitTargets(this, source, manifestDir, publicRoot, options.sheet);
+            ({ css, bundledRequests } = resolveTargets(this, source, manifestDir, publicRoot, resolvePublicFolder(manifestPath, projectPath)));
         }
     } catch  {}
-    if ('chunk' === options.sheet) return css;
-    return toRuntimeStylesheetModule(css);
+    return toRuntimeStylesheetModule(css, bundledRequests);
 }
 export default deadCssUrlLoader;

package/dist/dev-server/cleanup.d.ts

@@ -1,4 +1,4 @@
 import type { RspackDevServer } from '@rspack/dev-server';
 import type { PortManager } from './port-manager.js';
 export type DevServerHandle = RspackDevServer | (() => RspackDevServer | null | undefined);
-export declare function setupCleanupHandlers(devServer: DevServerHandle, portManager: PortManager): () => void;
+export declare function setupCleanupHandlers(devServer: DevServerHandle, portManager: PortManager, onSignal?: (signal: NodeJS.Signals) => void): () => void;

package/dist/dev-server/lifecycle-stream.d.ts

@@ -1,9 +1,9 @@
-import { type Envelope, isMachineOutput } from '../lib/messaging.js';
+import { type Diagnostic, type Envelope, isMachineOutput } from '../lib/messaging.js';
 export type LifecycleCommand = 'dev' | 'start' | 'preview';
-export type LifecycleStatus = 'starting' | 'compiled' | 'recompiled' | 'compile-failed' | 'ready' | 'browser-exited' | 'failed';
+export type LifecycleStatus = 'starting' | 'compiled' | 'recompiled' | 'compile-failed' | 'ready' | 'browser-exited' | 'failed' | 'stopped';
 export { isMachineOutput };
 export declare function isLifecycleStreamEnabled(): boolean;
-export declare function humanLine(line: string): void;
+export { humanLine } from '../lib/messaging.js';
 export declare function stripAnsi(input: string): string;
 export interface LifecycleStreamOptions {
     command: LifecycleCommand;
@@ -11,6 +11,7 @@ export interface LifecycleStreamOptions {
     distPath: string;
     readyPath?: string;
     eventsPath?: string;
+    noBrowser?: boolean;
     write?: (line: string) => void;
 }
 export declare class LifecycleStream {
@@ -21,6 +22,9 @@ export declare class LifecycleStream {
     private readyEmitted;
     private readyErrorEmitted;
     private browserExitEmitted;
+    private interruptEmitted;
+    private terminalEmitted;
+    private startingEmitted;
     private boundPort;
     private exitWatcher;
     private launchFailureWatcher;
@@ -35,19 +39,26 @@ export declare class LifecycleStream {
     compiled(args: {
         assets?: number;
         durationMs?: number;
+        entrypoints?: number;
     }): Envelope<unknown> | null;
     compileFailed(args: {
         output?: string;
         durationMs?: number;
         message?: string;
+        diagnostics?: Diagnostic[];
+        diagnosticsTruncated?: boolean;
     }): Envelope<unknown> | null;
     ready(args?: {
         port?: number | null;
     }): Envelope<unknown> | null;
+    private contractError;
+    exited(exitCode: number): Envelope<unknown> | null;
+    emitOnExit(): () => void;
     browserExited(args?: {
         exitCode?: number | null;
         message?: string;
     }): Envelope<unknown> | null;
+    interrupted(signal: string): Envelope<unknown> | null;
     failed(message: string): Envelope<unknown> | null;
     watchBrowserExit(intervalMs?: number, onExit?: (ready: Record<string, unknown>) => void): () => void;
     watchBrowserLaunchFailure(intervalMs: number | undefined, onFailure: (ready: Record<string, unknown>) => void): () => void;

package/dist/dev-server/session-start-prune.d.ts

@@ -0,0 +1,13 @@
+import type { Compiler, Configuration } from '@rspack/core';
+export interface SessionStartPruneOptions {
+    isRestart: boolean;
+    distPath: string;
+    readyPath: string;
+}
+export declare class PruneSessionStartLeftovers {
+    static readonly name: string;
+    private readonly distPath;
+    constructor(distPath: string);
+    apply(compiler: Compiler): void;
+}
+export declare function withSessionStartPrune(config: Configuration, session: SessionStartPruneOptions): Configuration;