extension-develop 4.0.30 → 4.0.32

package/README.md

@@ -172,7 +172,7 @@ Options accepted by each command. Values shown are typical types or enumerations
 - Supported sections:
   - config(config: Configuration): mutate the assembled Rspack config. Supports a function or a plain object. When an object is provided, it is deep‑merged on top of the assembled config.
   - commands.dev | .build | .start | .preview: per‑command options (browser, profile, binaries, flags, preferences, unified logger defaults, packaging). These defaults are applied for all respective commands.
-- browser.chrome | .firefox | .edge | .chromium-based | .gecko-based: start flags, excluded flags, preferences, binaries, profile reuse (persistProfile), and per-browser `extensions`.
+- browser.chrome | .firefox | .edge | .safari | .chromium-based | .gecko-based | .webkit-based: start flags, excluded flags, preferences, binaries, profile reuse (persistProfile), and per-browser `extensions`.
   - extensions: load-only companion extensions (unpacked dirs) loaded alongside your extension in dev/preview/start.
     - Example: { dir: "./extensions" } loads every "./extensions/\*" folder that contains a manifest.json.
 - Precedence when composing options (one contract for every command): stock defaults → browser._ → commands._ → CLI flags.
@@ -180,11 +180,11 @@ Options accepted by each command. Values shown are typical types or enumerations
     - Example: `commands.dev.polyfill: false` turns the polyfill off for the team, and `--polyfill` turns it back on for one run.
   - Lists (`browserFlags`, `excludeBrowserFlags`): concatenate across layers in order (browser, then command, then CLI) and dedupe.
   - Objects (`preferences`): deep-merge, later layers win on key conflict.
-- Browser key aliases when resolving `browser.*` from `extension.config.*`:
-  - When the runtime asks for `chromium`, `loadBrowserConfig` prefers `browser.chromium` and then falls back to `browser['chromium-based']`.
+- Browser key aliases when resolving `browser.*` from `extension.config.*` (engine families adopt product blocks; named products do not adopt engine-based blocks):
   - When the runtime asks for `chromium-based`, it prefers `browser['chromium-based']` and then `browser.chromium`.
-  - When the runtime asks for `firefox`, it prefers `browser.firefox` and then `browser['gecko-based']`.
   - When the runtime asks for `gecko-based`, it prefers `browser['gecko-based']` and then `browser.firefox`.
+  - When the runtime asks for `webkit-based` **or any webkit-flavored fork name** (e.g. `acme-webkit`), it prefers the exact `browser.<name>` block, then `browser['webkit-based']`, then `browser.safari`.
+  - Named product `safari` only uses `browser.safari` (does not adopt `webkit-based`).
 - When detected, a one‑time notice is printed to indicate config is active.
 
 ### Companion extensions (load-only)
@@ -300,7 +300,7 @@ dist/
 | plugin-css           | core  | - Auto‑wires CSS for HTML and content scripts<br/>- Optional SASS/LESS/PostCSS when configs exist<br/>- Integrates Stylelint when configured                                                                    |
 | plugin-js-frameworks | core  | - Detects React/Preact/Vue/Svelte and TypeScript<br/>- Configures SWC parsing, loaders/plugins, and safe aliases<br/>- Sets `tsconfig` resolution<br/>- Defers heavy work to `beforeRun` in production          |
 | plugin-static-assets | core  | - Emits images, fonts, and misc files to `assets/`<br/>- Inlines small SVGs (≤2KB), emits larger ones<br/>- Content hashing in production; stable names in development<br/>- Respects existing custom SVG rules |
-| plugin-compatibility | core  | - Cross‑browser helpers<br/>- Normalizes browser‑specific manifest fields<br/>- Optional `webextension-polyfill` for Chromium                                                                                   |
+| plugin-compatibility | core  | - Cross‑browser helpers<br/>- Normalizes browser‑specific manifest fields<br/>- Optional `webextension-polyfill` for Chromium (skipped for Firefox/Safari)                                                      |
 | plugin-compilation   | core  | - Loads env and templating (`EXTENSION_PUBLIC_*`)<br/>- Optional `dist/<browser>` cleaning<br/>- Compact, de‑duplicated compilation summary                                                                     |
 
 ## Notes and compatibility

package/dist/0~rspack-config.mjs

@@ -12,7 +12,7 @@ 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, toPosixPath, resolveCompanionExtensionDirs, debugContextPath, PlaywrightPlugin, isWebkitBasedBrowser, spacerLine, isGeckoBasedBrowser, 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, isWebkitBasedBrowser, 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";
@@ -246,6 +246,11 @@ class PolyfillPlugin {
         }
     }
 }
+function polyfillSkipReason(browser) {
+    if (isGeckoBasedBrowser(String(browser))) return 'Firefox bundles browser.* APIs';
+    if (isWebkitBasedBrowser(String(browser))) return 'Safari ships a native promise-based browser.* namespace';
+    return null;
+}
 class CompatibilityPlugin {
     static name = 'plugin-compatibility';
     manifestPath;
@@ -257,9 +262,9 @@ class CompatibilityPlugin {
         this.polyfill = options.polyfill || false;
     }
     apply(compiler) {
-        const isGeckoFamily = isGeckoBasedBrowser(String(this.browser));
-        if (this.polyfill) if (isGeckoFamily) {
-            if (isDebug()) console.log(compatibilityPolyfillSkipped('Firefox bundles browser.* APIs', this.browser));
+        const skipReason = polyfillSkipReason(this.browser);
+        if (this.polyfill) if (skipReason) {
+            if (isDebug()) console.log(compatibilityPolyfillSkipped(skipReason, this.browser));
         } else {
             if (isDebug()) console.log(compatibilityPolyfillEnabled(this.browser, 'webextension-polyfill'));
             new PolyfillPlugin({
@@ -1001,10 +1006,12 @@ function declarativeNetRequest(manifest) {
     return manifest.declarative_net_request && {
         declarative_net_request: {
             ...manifest.declarative_net_request,
-            rule_resources: manifest.declarative_net_request.rule_resources.map((resourceObj)=>({
-                    ...resourceObj,
-                    path: resourceObj.path && getFilename(`declarative_net_request/${resourceObj.id}.json`, resourceObj.path)
-                }))
+            ...Array.isArray(manifest.declarative_net_request.rule_resources) && {
+                rule_resources: manifest.declarative_net_request.rule_resources.map((resourceObj)=>({
+                        ...resourceObj,
+                        path: resourceObj.path && getFilename(`declarative_net_request/${resourceObj.id}.json`, resourceObj.path)
+                    }))
+            }
         }
     };
 }
@@ -1254,6 +1261,7 @@ class EnvPlugin {
         if (processShim) new ProvidePlugin({
             process: processShim
         }).apply(compiler);
+        const templateVars = buildTemplateVars(combinedVars, this.browser, mode);
         compiler.hooks.thisCompilation.tap('manifest:update-manifest', (compilation)=>{
             compilation.hooks.processAssets.tap({
                 name: 'env:module',
@@ -1264,29 +1272,11 @@ class EnvPlugin {
                     if (filename.endsWith('.json') || filename.endsWith('.html')) {
                         let fileContent = String(compilation.assets[filename]?.source() ?? '');
                         const resolveVar = (name)=>{
-                            if (Object.prototype.hasOwnProperty.call(process.env, name)) {
-                                const systemValue = process.env[name];
-                                if ('string' == typeof systemValue) return systemValue;
-                            }
-                            if (Object.prototype.hasOwnProperty.call(envVars, name)) {
-                                const explicitEnvValue = envVars[name];
-                                if ('string' == typeof explicitEnvValue) return explicitEnvValue;
-                            }
-                            if (Object.prototype.hasOwnProperty.call(defaultsVars, name)) {
-                                const defaultsValue = defaultsVars[name];
-                                if ('string' == typeof defaultsValue) return defaultsValue;
-                            }
-                            const combinedValue = combinedVars[name];
-                            return 'string' == typeof combinedValue ? combinedValue : `$${name}`;
+                            if (Object.prototype.hasOwnProperty.call(templateVars, name)) return templateVars[name];
+                            return `$${name}`;
                         };
-                        fileContent = fileContent.replace(/\$EXTENSION_PUBLIC_[A-Z_]+/g, (match)=>{
-                            const envVarName = match.slice(1);
-                            return resolveVar(envVarName);
-                        });
-                        fileContent = fileContent.replace(/\$EXTENSION_[A-Z_]+/g, (match)=>{
-                            const envVarName = match.slice(1);
-                            return resolveVar(envVarName);
-                        });
+                        fileContent = fileContent.replace(/\$EXTENSION_PUBLIC_[A-Z0-9_]+/g, (match)=>resolveVar(match.slice(1)));
+                        fileContent = fileContent.replace(/\$EXTENSION_[A-Z0-9_]+/g, (match)=>resolveVar(match.slice(1)));
                         compilation.updateAsset(filename, new core_sources.RawSource(fileContent));
                         if ('manifest.json' === filename) setCurrentManifestContent(compilation, fileContent);
                     }
@@ -1295,6 +1285,17 @@ class EnvPlugin {
         });
     }
 }
+function buildTemplateVars(combinedVars, browser, mode) {
+    const vars = {};
+    for (const [key, value] of Object.entries(combinedVars))if ('string' == typeof value && key.startsWith('EXTENSION_')) vars[key] = value;
+    const browserValue = String(browser);
+    const modeValue = String(mode);
+    vars.EXTENSION_BROWSER = browserValue;
+    vars.EXTENSION_PUBLIC_BROWSER = browserValue;
+    vars.EXTENSION_MODE = modeValue;
+    vars.EXTENSION_PUBLIC_MODE = modeValue;
+    return vars;
+}
 function sanitize(input) {
     return input.toLowerCase().replace(/[^a-z0-9 ]/gi, '').trim().replace(/\s+/g, '-');
 }
@@ -8672,11 +8673,16 @@ class ThrowIfRecompileIsNeeded {
         this.storeInitialHtmlAssets(htmlFields);
         compiler.hooks.make.tapAsync('html:throw-if-recompile-is-needed', (compilation, done)=>{
             const files = compiler.modifiedFiles || new Set();
-            const changedFile = Array.from(files)[0];
-            if (changedFile && this.initialHtmlAssets[changedFile]) {
-                const isRemoteUrl = (p)=>/^(https?:)?\/\//i.test(p);
-                const looksLikePublicRootUrl = (p)=>p.startsWith('/') && !__rspack_external_node_fs_5ea92f0c.existsSync(p);
-                const updatedAssets = __rspack_external_node_fs_5ea92f0c.existsSync(changedFile) ? getAssetsFromHtml(changedFile) : void 0;
+            const isRemoteUrl = (p)=>/^(https?:)?\/\//i.test(p);
+            const looksLikePublicRootUrl = (p)=>p.startsWith('/') && !__rspack_external_node_fs_5ea92f0c.existsSync(p);
+            for (const changedFile of files){
+                if (!this.initialHtmlAssets[changedFile]) continue;
+                let updatedAssets;
+                try {
+                    updatedAssets = getAssetsFromHtml(changedFile, __rspack_external_node_fs_5ea92f0c.readFileSync(changedFile, 'utf8'));
+                } catch  {
+                    updatedAssets = void 0;
+                }
                 const updatedJsEntries = (updatedAssets?.js || []).filter((p)=>!looksLikePublicRootUrl(p) && !isRemoteUrl(p));
                 const updatedCssEntries = (updatedAssets?.css || []).filter((p)=>!looksLikePublicRootUrl(p) && !isRemoteUrl(p));
                 const { js, css } = this.initialHtmlAssets[changedFile];
@@ -9591,11 +9597,11 @@ function serverRestartRequiredFromManifestError(fileAdded, fileRemoved) {
     lines.push("Restart the dev server to pick up changes to manifest entrypoints.");
     return lines.join('\n');
 }
-function legacyManifestPathWarning(legacyPath) {
+function legacyManifestPathWarning(field, legacyPath, modernPath) {
     const lines = [];
-    lines.push(`${messaging_prefix('warn')} The manifest uses a deprecated path.`);
+    lines.push(`${messaging_prefix('warn')} The ${pintor.blue(field)} field uses a deprecated scaffold 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(`Point it at ${pintor.underline(modernPath)}, Extension.js already emits the page there.`);
     return lines.join('\n');
 }
 function fatalManifestShapeFixed(field, detail) {
@@ -10053,40 +10059,100 @@ class EmitManifest {
         });
     }
 }
+const LEGACY_MANIFEST_PATH_RULES = [
+    {
+        field: 'devtools_page',
+        legacyPath: 'devtools_page/devtools_page.html',
+        modernPath: 'devtools/index.html'
+    },
+    {
+        field: 'options_ui.page',
+        legacyPath: 'options_ui/page.html',
+        modernPath: 'options/index.html'
+    },
+    {
+        field: 'background.page',
+        legacyPath: 'background/page.html',
+        modernPath: 'background/index.html'
+    },
+    {
+        field: 'browser_action.default_popup',
+        legacyPath: 'browser_action/default_popup.html',
+        modernPath: 'action/index.html'
+    },
+    {
+        field: 'page_action.default_popup',
+        legacyPath: 'page_action/default_popup.html',
+        modernPath: 'action/index.html'
+    },
+    {
+        field: 'side_panel.default_path',
+        legacyPath: 'side_panel/default_path.html',
+        modernPath: 'sidebar/index.html'
+    },
+    {
+        field: 'sidebar_action.default_panel',
+        legacyPath: 'sidebar_action/default_panel.html',
+        modernPath: 'sidebar/index.html'
+    }
+];
+function normalizeLegacyPathRef(raw) {
+    return String(raw || '').replace(/\\/g, '/').replace(/^\.\//, '').replace(/^\//, '');
+}
+function readField(manifest, field) {
+    if (!manifest || 'object' != typeof manifest || Array.isArray(manifest)) return;
+    let current = manifest;
+    for (const part of field.split('.')){
+        if (!current || 'object' != typeof current || Array.isArray(current) || !(part in current)) return;
+        current = current[part];
+    }
+    return current;
+}
+function findLegacyManifestPathHits(manifest) {
+    const hits = [];
+    for (const rule of LEGACY_MANIFEST_PATH_RULES){
+        const value = readField(manifest, rule.field);
+        if ('string' == typeof value && value.trim()) {
+            if (normalizeLegacyPathRef(value) === rule.legacyPath) hits.push({
+                field: rule.field,
+                legacyPath: rule.legacyPath,
+                modernPath: rule.modernPath
+            });
+        }
+    }
+    return hits;
+}
 class ManifestLegacyWarnings {
     static name = 'manifest:legacy-warnings';
+    reportedHits = new Set();
     apply(compiler) {
-        if ('production' === (compiler.options.mode || 'development')) return;
-        const legacy = [
-            'devtools_page/devtools_page.html',
-            'options_ui/page.html',
-            'background/page.html',
-            'browser_action/default_popup.html',
-            'page_action/default_popup.html',
-            'side_panel/default_path.html',
-            'sidebar_action/default_panel.html'
-        ];
         compiler.hooks.thisCompilation.tap(ManifestLegacyWarnings.name, (compilation)=>{
             compilation.hooks.processAssets.tap({
                 name: ManifestLegacyWarnings.name,
                 stage: core_Compilation.PROCESS_ASSETS_STAGE_REPORT
             }, ()=>{
-                const asset = compilation.getAsset('manifest.json');
-                if (!asset) return;
-                const text = asset.source.source().toString();
-                let count = 0;
-                legacy.forEach((needle)=>{
-                    if (text.includes(needle)) {
-                        const message = legacyManifestPathWarning(needle);
-                        humanLine(message);
-                        const warn = new core_WebpackError(message);
-                        warn.name = 'ManifestLegacyWarning';
-                        warn.file = 'manifest.json';
-                        compilation.warnings.push(warn);
-                        count++;
+                const original = getOriginalManifestContent(compilation);
+                if (!original) return;
+                const manifest = parseJsonSafe(original);
+                const hits = findLegacyManifestPathHits(manifest);
+                if (0 === hits.length) return;
+                const isDev = 'development' === compiler.options.mode;
+                let printed = 0;
+                for (const hit of hits){
+                    const signature = `${hit.field}\0${hit.legacyPath}`;
+                    if (isDev) {
+                        if (this.reportedHits.has(signature)) continue;
+                        this.reportedHits.add(signature);
                     }
-                });
-                if (isDebug()) console.log(manifestLegacyWarningsSummary(count));
+                    const message = legacyManifestPathWarning(hit.field, hit.legacyPath, hit.modernPath);
+                    humanLine(message);
+                    const warn = new core_WebpackError(message);
+                    warn.name = 'ManifestLegacyWarning';
+                    warn.file = 'manifest.json';
+                    compilation.warnings.push(warn);
+                    printed++;
+                }
+                if (isDebug()) console.log(manifestLegacyWarningsSummary(printed));
             });
         });
     }
@@ -11953,6 +12019,7 @@ function patchGeckoBackground(manifest, browser) {
 class UpdateManifest {
     manifestPath;
     browser;
+    reportedFatalFixes = new Set();
     constructor(options){
         this.manifestPath = options.manifestPath;
         this.browser = options.browser || 'chrome';
@@ -12001,7 +12068,13 @@ class UpdateManifest {
                 } catch  {}
                 const sanitized = sanitizeFatalManifestShapes(patchedManifest, __rspack_external_node_path_c5b9b54f.dirname(this.manifestPath));
                 patchedManifest = sanitized.manifest;
+                const isDev = 'development' === compiler.options.mode;
                 for (const fix of sanitized.fixes){
+                    if (isDev) {
+                        const signature = `${fix.field}\0${fix.detail}`;
+                        if (this.reportedFatalFixes.has(signature)) continue;
+                        this.reportedFatalFixes.add(signature);
+                    }
                     const message = fatalManifestShapeFixed(fix.field, fix.detail);
                     humanLine(message);
                     const warn = new core_WebpackError(message);

package/dist/101.mjs

@@ -19,6 +19,46 @@ import * as __rspack_external_node_fs_5ea92f0c from "node:fs";
 import * as __rspack_external_node_os_74b4b876 from "node:os";
 import * as __rspack_external_node_path_c5b9b54f from "node:path";
 import * as __rspack_external_node_vm_bd3d9cea from "node:vm";
+__rspack_external_node_path_c5b9b54f.join(process.cwd(), 'node_modules/extension-develop/dist/certs');
+const CHROMIUM_BASED_BROWSERS = [
+    'chrome',
+    'edge',
+    'brave',
+    'opera',
+    'vivaldi',
+    'yandex'
+];
+const GECKO_BASED_BROWSERS = [
+    'firefox',
+    'waterfox',
+    'librewolf'
+];
+const WEBKIT_BASED_BROWSERS = [
+    'safari'
+];
+const CHROMIUM_FAMILY_ALIASES = [
+    'chromium',
+    'chrome',
+    'edge',
+    'chromium-based'
+];
+const GECKO_FAMILY_ALIASES = [
+    'firefox',
+    'gecko-based'
+];
+[
+    ...CHROMIUM_BASED_BROWSERS,
+    ...GECKO_BASED_BROWSERS
+];
+function isChromiumBasedBrowser(browser) {
+    return CHROMIUM_BASED_BROWSERS.includes(browser) || String(browser).includes('chromium');
+}
+function isGeckoBasedBrowser(browser) {
+    return GECKO_BASED_BROWSERS.includes(browser) || String(browser).includes('gecko') || String(browser).includes('firefox');
+}
+function isWebkitBasedBrowser(browser) {
+    return WEBKIT_BASED_BROWSERS.includes(browser) || String(browser).includes('webkit');
+}
 function getLoggingPrefix(type) {
     return messaging_prefix(type);
 }
@@ -601,14 +641,22 @@ async function loadBrowserConfig(projectPath, browser = 'chrome') {
             const userConfig = await loadConfigFile(configPath);
             if (userConfig?.browser) {
                 const browsers = userConfig.browser;
+                const browserName = String(browser);
                 if ('chromium-based' === browser) {
                     if (browsers['chromium-based']) return browsers['chromium-based'];
                     if (browsers.chromium) return browsers.chromium;
                 } else if ('gecko-based' === browser) {
                     if (browsers['gecko-based']) return browsers['gecko-based'];
                     if (browsers.firefox) return browsers.firefox;
+                } else if (isWebkitBasedBrowser(browserName)) {
+                    const direct = browsers[browserName];
+                    if (direct) return direct;
+                    if ('safari' !== browserName) {
+                        if (browsers['webkit-based']) return browsers['webkit-based'];
+                        if (browsers.safari) return browsers.safari;
+                    }
                 } else {
-                    const direct = browsers[browser];
+                    const direct = browsers[browserName];
                     if (direct) return direct;
                 }
             }
@@ -634,7 +682,7 @@ async function config_loader_isUsingExperimentalConfig(projectPath) {
     }
     return false;
 }
-var package_namespaceObject = /*#__PURE__*/ JSON.parse('{"rE":"4.0.30","El":{"@prefresh/core":"1.5.9","@prefresh/utils":"1.2.1","@rspack/core":"^2.1.1","@rspack/dev-server":"2.1.0","@rspack/plugin-preact-refresh":"2.0.1","@rspack/plugin-react-refresh":"2.0.2","@vue/compiler-sfc":"3.5.26","acorn":"^8.16.0","adm-zip":"^0.6.0","browser-extension-manifest-fields":"^2.2.9","case-sensitive-paths-webpack-plugin":"^2.4.0","content-security-policy-parser":"^0.6.0","dotenv":"^17.2.3","es-module-lexer":"^2.1.0","extension-from-store":"^0.1.1","go-git-it":"^5.1.5","ignore":"^7.0.5","less":"4.6.7","less-loader":"13.0.0","parse5-utilities":"^1.0.0","pintor":"0.3.0","postcss":"8.5.23","postcss-loader":"8.2.1","postcss-preset-env":"11.1.1","postcss-scss":"4.0.9","preact":"10.27.3","prefers-yarn":"2.0.1","react-refresh":"0.18.0","sass-loader":"17.0.0","schema-utils":"^4.3.3","svelte-loader":"3.2.4","tiny-glob":"^0.2.9","vue":"3.5.26","vue-loader":"17.4.2","webextension-polyfill":"^0.12.0","webpack-merge":"^6.0.1","webpack-target-webextension":"^2.1.3","ws":"^8.20.1"}}');
+var package_namespaceObject = /*#__PURE__*/ JSON.parse('{"rE":"4.0.32","El":{"@prefresh/core":"1.5.9","@prefresh/utils":"1.2.1","@rspack/core":"^2.1.1","@rspack/dev-server":"2.1.0","@rspack/plugin-preact-refresh":"2.0.1","@rspack/plugin-react-refresh":"2.0.2","@vue/compiler-sfc":"3.5.26","acorn":"^8.16.0","adm-zip":"^0.6.0","browser-extension-manifest-fields":"^2.2.9","case-sensitive-paths-webpack-plugin":"^2.4.0","content-security-policy-parser":"^0.6.0","dotenv":"^17.2.3","es-module-lexer":"^2.1.0","extension-from-store":"^0.1.1","go-git-it":"^5.1.5","ignore":"^7.0.5","less":"4.6.7","less-loader":"13.0.0","parse5-utilities":"^1.0.0","pintor":"0.3.0","postcss":"8.5.23","postcss-loader":"8.2.1","postcss-preset-env":"11.1.1","postcss-scss":"4.0.9","preact":"10.27.3","prefers-yarn":"2.0.1","react-refresh":"0.18.0","sass-loader":"17.0.0","schema-utils":"^4.3.3","svelte-loader":"3.2.4","tiny-glob":"^0.2.9","vue":"3.5.26","vue-loader":"17.4.2","webextension-polyfill":"^0.12.0","webpack-merge":"^6.0.1","webpack-target-webextension":"^2.1.3","ws":"^8.20.1"}}');
 function asAbsolute(p) {
     return __rspack_external_node_path_c5b9b54f.isAbsolute(p) ? p : __rspack_external_node_path_c5b9b54f.resolve(p);
 }
@@ -1182,46 +1230,6 @@ function assertNoManagedDependencyConflicts(userManifestPath, projectPath) {
     }
     if (duplicates.length > 0) throw new Error(managedDependencyConflict(duplicates, userManifestPath));
 }
-__rspack_external_node_path_c5b9b54f.join(process.cwd(), 'node_modules/extension-develop/dist/certs');
-const CHROMIUM_BASED_BROWSERS = [
-    'chrome',
-    'edge',
-    'brave',
-    'opera',
-    'vivaldi',
-    'yandex'
-];
-const GECKO_BASED_BROWSERS = [
-    'firefox',
-    'waterfox',
-    'librewolf'
-];
-const WEBKIT_BASED_BROWSERS = [
-    'safari'
-];
-const CHROMIUM_FAMILY_ALIASES = [
-    'chromium',
-    'chrome',
-    'edge',
-    'chromium-based'
-];
-const GECKO_FAMILY_ALIASES = [
-    'firefox',
-    'gecko-based'
-];
-[
-    ...CHROMIUM_BASED_BROWSERS,
-    ...GECKO_BASED_BROWSERS
-];
-function isChromiumBasedBrowser(browser) {
-    return CHROMIUM_BASED_BROWSERS.includes(browser) || String(browser).includes('chromium');
-}
-function isGeckoBasedBrowser(browser) {
-    return GECKO_BASED_BROWSERS.includes(browser) || String(browser).includes('gecko') || String(browser).includes('firefox');
-}
-function isWebkitBasedBrowser(browser) {
-    return WEBKIT_BASED_BROWSERS.includes(browser) || String(browser).includes('webkit');
-}
 function idFromHash(hash) {
     const hex = hash.subarray(0, 16).toString('hex');
     let id = '';

package/dist/plugin-compilation/env.d.ts

@@ -7,3 +7,9 @@ export declare class EnvPlugin {
     constructor(options: Partial<PluginInterface>);
     apply(compiler: Compiler): void;
 }
+/**
+ * Env values available to `$EXTENSION_*` placeholders in emitted .json/.html.
+ * Mirrors DefinePlugin: dotenv/process values plus the per-build-target
+ * browser and mode synthetics JS already reads via import.meta.env.
+ */
+export declare function buildTemplateVars(combinedVars: Record<string, unknown>, browser: DevOptions['browser'], mode: string): Record<string, string>;

package/dist/plugin-web-extension/feature-manifest/manifest-lib/legacy-paths.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Old Extension.js scaffold layout → current standardized HTML destinations.
+ * Detection is field-scoped on purpose: a string that merely looks like an old
+ * path in description, web_accessible_resources, or any other field is not a hit.
+ */
+export interface LegacyManifestPathRule {
+    /** Dot-path into the author manifest (e.g. `options_ui.page`). */
+    field: string;
+    /** Exact path the old scaffold wrote into that field. */
+    legacyPath: string;
+    /** Canonical emit destination Extension.js rewrites the field to. */
+    modernPath: string;
+}
+export interface LegacyManifestPathHit {
+    field: string;
+    legacyPath: string;
+    modernPath: string;
+}
+export declare const LEGACY_MANIFEST_PATH_RULES: readonly LegacyManifestPathRule[];
+/** Collapse author path noise so `./x` and `/x` match the scaffold form. */
+export declare function normalizeLegacyPathRef(raw: string): string;
+/**
+ * Field-by-field scan of the *author* manifest for old scaffold HTML paths.
+ * Call this on the pre-rewrite source; the emitted asset already has modern paths.
+ */
+export declare function findLegacyManifestPathHits(manifest: unknown): LegacyManifestPathHit[];

package/dist/plugin-web-extension/feature-manifest/messages.d.ts

@@ -1,5 +1,5 @@
 export declare function serverRestartRequiredFromManifestError(fileAdded: string, fileRemoved: string): string;
-export declare function legacyManifestPathWarning(legacyPath: string): string;
+export declare function legacyManifestPathWarning(field: string, legacyPath: string, modernPath: string): string;
 export declare function fatalManifestShapeFixed(field: string, detail: string): string;
 export declare function invalidThemeValue(field: string, detail: string, value: string): string;
 export declare function themeNotSupportedByBrowser(browser: string): string;

package/dist/plugin-web-extension/feature-manifest/steps/legacy-warnings.d.ts

@@ -1,5 +1,6 @@
 import { type Compiler } from '@rspack/core';
 export declare class ManifestLegacyWarnings {
     static readonly name: string;
+    private reportedHits;
     apply(compiler: Compiler): void;
 }

package/dist/plugin-web-extension/feature-manifest/steps/update-manifest.d.ts

@@ -3,6 +3,7 @@ import type { DevOptions, PluginInterface } from '../../../types';
 export declare class UpdateManifest {
     readonly manifestPath: string;
     readonly browser: DevOptions['browser'];
+    private reportedFatalFixes;
     constructor(options: PluginInterface);
     private applyDevOverrides;
     apply(compiler: Compiler): void;

package/package.json

@@ -43,7 +43,7 @@
     "runtime"
   ],
   "name": "extension-develop",
-  "version": "4.0.30",
+  "version": "4.0.32",
   "description": "Develop, build, preview, and package Extension.js projects.",
   "author": {
     "name": "Cezar Augusto",