extension-develop 4.1.19 → 4.1.20

package/dist/plugin-browsers/index.d.ts

@@ -49,7 +49,6 @@ export interface BrowserLaunchOptions {
     logTab?: number | string;
     logSink?: BrowserLogSink;
 }
-/** Browser-generated log entry normalized by the launcher's CDP controller. */
 export interface BrowserLogSinkEvent {
     level: 'log' | 'info' | 'warn' | 'error' | 'debug';
     text: string;
@@ -74,9 +73,7 @@ export interface BrowserController {
         urlFilter?: string;
         tabFilter?: number | string;
     }): Promise<void>;
-    /** The browser's refusal reason for this session, or null when it loaded. */
     getExtensionLoadRefusal?(): string | null;
-    /** Re-offer the current dist. Only ever called while the session is refused. */
     retryExtensionLoad?(): Promise<ExtensionLoadRetryResult>;
 }
 export type BrowserLauncherFn = (opts: BrowserLaunchOptions) => Promise<BrowserController>;
@@ -86,33 +83,13 @@ export interface RunnerPlugin {
     apply(compiler: Compiler): void;
 }
 export interface BrowsersPluginOptions {
-    /** Injected browser launcher, provided by the CLI from programs/extension/browsers/ */
     launcher: BrowserLauncherFn;
-    /** Browser-related options forwarded to the launcher (outputPath/contextDir/extensionsToLoad are filled at compile time) */
     browserOptions: Omit<BrowserLaunchOptions, 'outputPath' | 'contextDir' | 'extensionsToLoad'>;
 }
-/**
- * BrowsersPlugin
- *
- * An rspack plugin that manages the browser lifecycle for extension development.
- * On first successful compilation it launches a browser via the injected launcher
- * function; on subsequent compilations it classifies changed files and triggers
- * the appropriate reload strategy (full / service-worker / content-scripts).
- *
- * A `BuildEmitter` is exposed as `plugin.emitter` so that external consumers
- * (CLI telemetry, wait-mode, etc.) can subscribe to build events without
- * coupling to rspack.
- */
 export declare class BrowsersPlugin implements RunnerPlugin {
     private readonly options;
     static readonly name = "plugin-browsers";
-    /** EventEmitter for build lifecycle events (compiled, error, close). */
     readonly emitter: BuildEmitter;
-    /**
-     * Extension directories to load alongside the user extension.
-     * Set externally by webpack-config after computing companion extensions,
-     * before the first compilation.
-     */
     extensionsToLoad: string[];
     private isFirstCompile;
     private controller;
@@ -120,20 +97,8 @@ export declare class BrowsersPlugin implements RunnerPlugin {
     private logSink;
     private lastReportedRefusal;
     constructor(options: BrowsersPluginOptions);
-    /**
-     * The dev server injects the control-bridge broker so a launched
-     * Chromium reloads through the SW producer (the same path as `--no-browser`),
-     * not the CDP controller. Called once, before the first compile.
-     */
     setReloadBroker(broker: ReloadBroker): void;
     setLogSink(sink: BrowserLogSink): void;
-    /**
-     * Re-offer the dist to a browser that refused it at launch. Returns true
-     * when the browser has now accepted it, so the caller skips the reload.
-     *
-     * Only ever runs while the session is refused: re-asking a healthy browser
-     * would restart the guest and destroy its HMR state.
-     */
     private retryRefusedExtensionLoad;
     apply(compiler: Compiler): void;
 }

package/dist/plugin-browsers/safari-dev-plugin.d.ts

@@ -1,6 +1,8 @@
 import type { Compiler } from '@rspack/core';
+import { type ReloadBroker, type ReloadInstruction } from '../plugin-reload/index.js';
 import { BuildEmitter, type RunnerPlugin } from './index.js';
 export type SafariPackagerFn = (distPath: string, mode: 'full' | 'resync') => Promise<unknown>;
+export declare function reloadSurvivingPackage(instruction: ReloadInstruction | undefined): ReloadInstruction | undefined;
 export declare class SafariDevPlugin implements RunnerPlugin {
     private readonly packager;
     static readonly name = "safari-dev";
@@ -10,7 +12,9 @@ export declare class SafariDevPlugin implements RunnerPlugin {
     private active;
     private pending;
     private idleWaiters;
+    private reloadBroker;
     constructor(packager: SafariPackagerFn);
+    setReloadBroker(broker: ReloadBroker): void;
     apply(compiler: Compiler): void;
     idle(): Promise<void>;
     private drain;

package/dist/plugin-compatibility/feature-polyfill.d.ts

@@ -1,9 +1,5 @@
 import { type Compiler } from '@rspack/core';
 import type { DevOptions, PluginInterface } from '../types.js';
-/**
- * PolyfillPlugin is responsible for providing the `browser`
- * global variable to the extension's codebase.
- */
 export declare class PolyfillPlugin {
     readonly browser: DevOptions['browser'];
     constructor(options: PluginInterface);

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

@@ -8,9 +8,4 @@ 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-css/css-lib/dead-url-refs.d.ts

@@ -3,12 +3,6 @@ export interface DeadUrlRefContext {
     issuerDir: string;
     roots: string[];
 }
-/** True when the reference names no file under the issuer or any project root. */
 export declare function isDeadCssUrlRef(rawRequest: string, { issuerDir, roots }: DeadUrlRefContext): boolean;
-/**
- * Rewrites url() targets in place. The replacer returns the new target, or
- * undefined to keep the reference exactly as authored.
- */
 export declare function replaceCssUrlRefs(source: string, replacer: (request: string) => string | undefined): string;
-/** Every url() target in a stylesheet, in source order, duplicates collapsed. */
 export declare function extractCssUrlRefs(source: string): string[];

package/dist/plugin-css/css-lib/inline-content-script-css.d.ts

@@ -10,23 +10,8 @@ export interface RewriteInlinedCssUrlsContext {
     manifestDir: string;
     publicRoot: string;
 }
-/**
- * Every relative or root-absolute url() that names a real file is rewritten
- * to `<placeholder><output name><query/hash>` and reported so the caller can
- * emit it. A file public/ owns keeps the name the public copier gives it at
- * the dist root. Remote, data:, fragment-only, protocol-relative and already
- * absolute references stay as authored, and so does a reference to a file
- * that does not exist (the dead-reference scan reports those).
- */
 export declare function rewriteInlinedCssUrls(source: string, context: RewriteInlinedCssUrlsContext): {
     css: string;
     targets: InlinedCssUrlTarget[];
 };
-/**
- * The JavaScript module a content script gets for an inlined stylesheet: a
- * CommonJS export of a data: URL, so `import sheet from './x.css'` and
- * `new URL('./x.css', import.meta.url)` both keep working as they did when
- * rspack inlined the file itself. The placeholder becomes the extension root
- * when the module evaluates, which is after the runtime API exists.
- */
 export declare function toRuntimeStylesheetModule(css: string): string;

package/dist/plugin-css/css-lib/resolve-css-asset.d.ts

@@ -3,12 +3,4 @@ export interface CssAssetResult {
     found: boolean;
     href: string | undefined;
 }
-/**
- * Resolves the CSS asset emitted for a given entry feature.
- *
- * First tries the canonical name (`<feature>.css`).  If that misses,
- * which can happen when rspack's native CSS (`experiments.css`) splits
- * the stylesheet into a chunk whose name differs from the entry, it
- * falls back to inspecting the entrypoint's actual chunk files.
- */
 export declare function resolveCssAsset(compilation: Compilation, feature: string): CssAssetResult;

package/dist/plugin-perf-budgets/index.d.ts

@@ -4,27 +4,6 @@ interface PerfBudgetsPluginOptions {
     enabled?: boolean;
     budgets?: Partial<Record<AssetCategory, number>>;
 }
-/**
- * PerfBudgetsPlugin, extension-aware performance budgets.
- *
- * Replaces rspack's stock single-threshold `performance.hints` with a
- * per-asset-category budget tuned to how browser extensions actually
- * load code:
- *
- *   content_scripts/*    → 512 KiB  (injected on every navigation)
- *   background / SW      → 512 KiB  (wakes from cold each session)
- *   pages / sidebar / …  → 1 MiB    (opened on demand)
- *   runtime / wasm cores → 1 MiB    (hashed payloads at the output root)
- *   images, fonts, etc.  → silenced (not a code-splitting concern)
- *
- * Numbers are sized to clear realistic framework templates (React/Vue/
- * Preact/Svelte + a design system) and still flag genuine outliers
- * (multi-MiB AI sidebars, heavyweight WASM service workers). Override
- * per-category via `perfBudgets` in `extension.config.{js,ts}`.
- *
- * Set `compiler.options.performance.hints = false` when this plugin is
- * registered to avoid double-warnings.
- */
 export declare class PerfBudgetsPlugin {
     static readonly name = "plugin-perf-budgets";
     private readonly options;

package/dist/plugin-playwright/index.d.ts

@@ -36,7 +36,7 @@ export type ReadyMetadata = {
     extensionId?: string;
     browserExitedAt?: string;
     browserExitCode?: number | null;
-    runtime?: 'attached';
+    runtime?: 'attached' | 'detached';
     executorAttachedAt?: string;
     managedExtensions?: ManagedExtensionRecord[];
 };
@@ -105,7 +105,8 @@ export declare function createPlaywrightMetadataWriter(options: WriterOptions):
     writeStarting(): void;
     writeReady(compiledAt?: string | null): void;
     writeError(code: string, message: string, errors?: string[]): void;
-    writeShutdown(): void;
+    writeShutdown(message?: string): void;
+    stampExecutorDetached(): void;
     stampExecutorAttached(): void;
     appendEvent: (event: PlaywrightAutomationEvent) => void;
 };

package/dist/plugin-reload/classify-reload.d.ts

@@ -6,17 +6,13 @@ export interface ReloadInstruction {
     changedScriptFiles?: string[];
     label?: string;
 }
-/** "context (fileA, fileB +2 more)", the one label every reload surface shows. */
 export declare function formatReloadContextLabel(context: string, files: string[]): string;
 export declare function pageContextFromSources(changedSources: string[]): string;
 export interface SourceFeatureIndex {
     swSources: Set<string>;
-    /** Source → canonical content_scripts entry names whose chunks contain it. */
     contentEntriesBySource: Map<string, Set<string>>;
     pageSources: Set<string>;
-    /** Source → emitted scripts/ bundle names whose chunks contain it. */
     scriptFilesBySource?: Map<string, Set<string>>;
-    /** Project-relative public/ roots the copier ships at the dist root. */
     publicRoots?: string[];
 }
 export declare function publicOutputPath(rel: string, publicRoots: string[] | undefined): string | undefined;

package/dist/plugin-reload/index.d.ts

@@ -1,26 +1,8 @@
 import type { Compiler } from '@rspack/core';
 import type { DevOptions, PluginInterface } from '../types.js';
 export { buildSourceFeatureIndex, classifyReloadFromSources, formatReloadContextLabel, pageContextFromSources, publicOutputPath, type ReloadInstruction, type ReloadType, readContentScriptCount, type SourceFeatureIndex } from './classify-reload.js';
-export { type ChangedSourcesSnapshot, type ChangedSourcesTracker, createChangedSourcesTracker, dispatchReload, type ReloadBroker, type ReloadExecutor } from './reload-dispatch.js';
+export { type ChangedSourcesSnapshot, type ChangedSourcesTracker, createChangedSourcesTracker, dispatchReload, type ReloadBroker, type ReloadExecutor, type UndeliveredReloadContext } from './reload-dispatch.js';
 export { SetupChunkLoadingTarget } from './steps/setup-chunk-loading-target.js';
-/**
- * ReloadPlugin owns the dev-only reload/HMR strategy end to end:
- *
- * - build-time injection of the reload runtime (SetupReloadStrategy and the
- *   vendored webpack-target-webextension fork), the SW scripts-replay shim,
- *   and the control-bridge producer/relay instrumentation
- * - the reload classifier and dispatch seam consumed by plugin-browsers'
- *   BrowsersPlugin and the dev server's `--no-browser` broadcast path
- *   (re-exported above from classify-reload.ts / reload-dispatch.ts)
- *
- * Registration order matters: this plugin must be applied AFTER
- * plugin-web-extension, SetupReloadStrategy decorates the background and
- * content-script entries that feature-scripts' AddScripts declares.
- *
- * The whole pipeline is dev-only; `EXTENSION_NO_RELOAD=true` opts out. The
- * every-mode content-script wrapper (mount lifecycle) is NOT part of this
- * plugin. It lives in feature-scripts/steps/add-content-script-wrapper.
- */
 export declare class ReloadPlugin {
     static readonly name = "plugin-reload";
     readonly manifestPath: string;

package/dist/plugin-reload/reload-dispatch.d.ts

@@ -1,5 +1,8 @@
 import type { Compiler } from '@rspack/core';
 import type { ReloadInstruction } from './classify-reload.js';
+export interface UndeliveredReloadContext {
+    producerRestartExpected?: boolean;
+}
 export interface ReloadBroker {
     broadcastReload(instruction: {
         type: ReloadInstruction['type'];
@@ -8,17 +11,17 @@ export interface ReloadBroker {
         changedFiles?: string[];
         changedScriptFiles?: string[];
     }): number;
-    undeliveredReloadWarning?(): string | null;
+    undeliveredReloadWarning?(context?: UndeliveredReloadContext): string | null;
 }
 export interface ReloadExecutor {
     broker?: ReloadBroker;
+    producerRestartExpected?: boolean;
 }
 export declare function formatReloadingLine(label: string): string;
+export declare function formatQueuedReloadLine(label: string): string;
 export declare function dispatchReload(instruction: ReloadInstruction | undefined, executor: ReloadExecutor): Promise<void>;
 export interface ChangedSourcesSnapshot {
-    /** A manifest.json / _locales change, forces a full reload regardless of which other files changed. */
     forcedFull: boolean;
-    /** Project-relative, forward-slashed paths of every file changed since the last successful compile. */
     changedSources: string[];
 }
 export interface ChangedSourcesTracker {

package/dist/plugin-reload/steps/setup-chunk-loading-target.d.ts

@@ -1,18 +1,5 @@
 import type { Compiler } from '@rspack/core';
 import type { PluginInterface } from '../../types.js';
-/**
- * How a chunk gets loaded is a property of the extension platform, not of dev
- * mode. Without this, a production build falls back to rspack's web target,
- * whose loader appends a `<script>` to the host document: that runs in the MAIN
- * world while the content script lives in the isolated world, so the chunk never
- * reaches the requester and a dynamic `import()` dies with ChunkLoadError. Dev
- * looked fine only because the target rode along inside the reload plugin
- * (issue #507).
- *
- * This is the target ALONE. Everything reload-specific, including the
- * synthesized background entry, stays in SetupReloadStrategy: production must
- * never gain a background script the author did not write.
- */
 export declare class SetupChunkLoadingTarget {
     private readonly manifestPath;
     private readonly browser;

package/dist/plugin-special-folders/folder-extensions/types.d.ts

@@ -1,17 +1,4 @@
-/**
- * Companion extensions are "load-only" unpacked extension directories that
- * should be loaded alongside the user extension in dev/preview/start.
- *
- * Each directory MUST be an unpacked extension root containing a manifest.json.
- */
 export type CompanionExtensionsConfig = string[] | {
-    /**
-     * Folder to scan for subfolders that contain a manifest.json.
-     * Example: "./extensions" -> loads "./extensions/*" (one level deep)
-     */
     dir?: string;
-    /**
-     * Explicit extension directories to load (absolute or relative to projectRoot).
-     */
     paths?: string[];
 };

package/dist/plugin-special-folders/index.d.ts

@@ -2,15 +2,6 @@ import { type Compiler } from '@rspack/core';
 interface SpecialFoldersPluginOptions {
     manifestPath: string;
 }
-/**
- * SpecialFoldersPlugin is responsible for handling the
- * special folders in the extension:
- *
- * - /pages - HTML pages not included in the manifest
- * - /scripts - Script files not included in the manifest
- * - /public - Static files not included in the manifest
- * - /extensions - Load-only companion extensions (unpacked)
- */
 export declare class SpecialFoldersPlugin {
     static readonly name: string;
     private readonly options;

package/dist/plugin-web-extension/feature-html/html-lib/utils.d.ts

@@ -34,7 +34,6 @@ export declare function resolveAbsoluteFsPath(params: {
     projectRoot: string;
     publicRootForResource: string;
     outputRoot: string;
-    /** Manifest dir: Chrome resolves root URLs (/pages/x.html) against it. */
     manifestRoot?: string;
 }): {
     absoluteFsPath: string;

package/dist/plugin-web-extension/feature-html/index.d.ts

@@ -1,32 +1,5 @@
 import type { Compiler } from '@rspack/core';
 import type { FilepathList, PluginInterface } from '../../types.js';
-/**
- * HtmlPlugin is responsible for handling the HTML file
- * defined in the manifest.json. Static assets and CSS files
- * within the HTML file are added to the compilation. JS files
- * are added as webpack entrypoints. It also supports ecxtra
- * html files defined via this.include option. These extra
- * html files are added to the compilation and are also HMR
- * enabled. They are useful for adding extra pages to the
- * extension runtime that are not defined in manifest.
- *
- * The plugin also has a guard against recompiling entrypoints
- * at runtime, throwing an error if any of those files change.
- *
- * Features supported:
- * action.default_popup - HMR enabled
- * background.page - HMR enabled
- * chrome_settings_overrides.homepage - HMR enabled
- * chrome_url_overrides.newtab - HMR enabled
- * chrome_url_overrides.history - HMR enabled
- * chrome_url_overrides.bookmarks - HMR enabled
- * devtools_page - HMR enabled
- * options_ui.page - HMR enabled
- * page_action.default_popup - HMR enabled
- * sandbox.page - HMR enabled
- * side_panel.default_panel - HMR enabled
- * sidebar_action.default_panel - HMR enabled
- */
 export declare class HtmlPlugin {
     readonly manifestPath: string;
     readonly includeList?: FilepathList;

package/dist/plugin-web-extension/feature-icons/index.d.ts

@@ -1,17 +1,5 @@
 import type { Compiler } from '@rspack/core';
 import type { DevOptions, FilepathList, PluginInterface, ThemeIcon } from '../../types.js';
-/**
- * IconsPlugin is responsible for handling the icon files defined
- * in the manifest.json. It emits the icon files to the output
- * directory and adds them to the file dependencies of the compilation.
- *
- * Features supported:
- * action.default_icon
- * browser_action.default_icon
- * icons
- * page_action.default_icon
- * sidebar_action.default_icon
- */
 export declare class IconsPlugin {
     readonly manifestPath: string;
     readonly includeList?: FilepathList | {

package/dist/plugin-web-extension/feature-json/index.d.ts

@@ -1,14 +1,5 @@
 import { type Compiler } from '@rspack/core';
 import type { DevOptions, FilepathList, PluginInterface } from '../../types.js';
-/**
- * JsonPlugin is responsible for handling the JSON files defined
- * in the manifest.json. It emits the JSON files to the output
- * directory and adds them to the file dependencies of the compilation.
- *
- * Features supported:
- * - declarative_net_request.ruleset
- * - storage.managed_schema
- */
 export declare class JsonPlugin {
     readonly manifestPath: string;
     readonly includeList?: FilepathList;

package/dist/plugin-web-extension/feature-locales/index.d.ts

@@ -1,9 +1,5 @@
 import { type Compiler } from '@rspack/core';
 import type { FilepathList, PluginInterface } from '../../types.js';
-/**
- * LocalesPlugin is responsible for emitting the locales files
- * to the output directory.
- */
 export declare class LocalesPlugin {
     readonly manifestPath: string;
     readonly includeList?: FilepathList;

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

@@ -1,15 +1,5 @@
 import type { Compiler } from '@rspack/core';
 import type { DevOptions, FilepathList, PluginInterface } from '../../types.js';
-/**
- * ManifestPlugin is responsible for handling the manifest.json file.
- * It ensures that the files defined in the manifest have valid paths,
- * throwing errors if they don't. It also ensures the manifest is emitted
- * to the assets bundle, so other plugins can modify it, and stored
- * as file dependency so webpack can watch and trigger changes.
- *
- * The plugin also has a guard against recompiling entrypoints
- * at runtime, throwing an error if any of those files change.
- */
 export declare class ManifestPlugin {
     readonly manifestPath: string;
     readonly browser: DevOptions['browser'];

package/dist/plugin-web-extension/feature-manifest/manifest-lib/filter-key-edge.d.ts

@@ -0,0 +1,5 @@
+import type { DevOptions, Manifest } from '../../../types.js';
+export declare function dropEdgeStoreKey(manifest: Manifest, browser: DevOptions['browser']): {
+    manifest: Manifest;
+    dropped: boolean;
+};

package/dist/plugin-web-extension/feature-manifest/manifest-lib/filter-keys-safari.d.ts

@@ -0,0 +1,11 @@
+import type { DevOptions, Manifest } from '../../../types.js';
+export interface WebkitDroppedKey {
+    path: string;
+    reason: string;
+}
+export declare function dropWebkitUnsupportedKeys(manifest: Manifest, browser: DevOptions['browser']): {
+    manifest: Manifest;
+    dropped: WebkitDroppedKey[];
+};
+export declare function reportWebkitDroppedKeys(dropped: WebkitDroppedKey[], browser: DevOptions['browser']): void;
+export declare function resetWebkitDropNotices(): void;

package/dist/plugin-web-extension/feature-manifest/manifest-lib/gecko-data-collection.d.ts

@@ -1,14 +1,2 @@
 import type { Manifest } from '../../../types.js';
-/**
- * AMO rejects every new add-on submitted since 2025-11-03 whose manifest
- * lacks `browser_specific_settings.gecko.data_collection_permissions`
- * (add-ons that transmit nothing must declare `{"required": ["none"]}`),
- * and Mozilla has announced the key becomes mandatory for ALL add-ons
- * during 2026. Firefox parses the key from 140 (desktop) / 142 (Android)
- * on both MV2 and MV3, so declaring it is safe everywhere.
- *
- * Returns true when the resolved Gecko manifest carries no such
- * declaration, so the build can surface a store-readiness warning instead
- * of letting the author discover the rejection at submission time.
- */
 export declare function missingGeckoDataCollectionPermissions(manifest: Manifest): boolean;

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

@@ -1,14 +1,6 @@
-/**
- * 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 {
@@ -17,10 +9,5 @@ export interface LegacyManifestPathHit {
     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/manifest-lib/sanitize-fatal-shapes.d.ts

@@ -3,42 +3,6 @@ export interface FatalShapeFix {
     field: string;
     detail: string;
 }
-/**
- * Repair author-manifest shapes that make Chrome refuse to load the whole
- * extension. Loading via --load-extension surfaces the refusal as a native
- * modal dialog (no CDP, no console), so a dev session just wedges, the
- * browser never binds its debug endpoint. Both shapes below were found in
- * the wild and are unambiguous to fix:
- *
- * - `"name"` missing, empty, or not a string, Chrome refuses with
- *   "Required value 'name' is missing or invalid" (verified live on Chrome
- *   150 via CDP loadUnpacked for all three shapes). Coerce scalars,
- *   fall back to "Unnamed Extension".
- * - `"version"` missing entirely, Chrome refuses with "Required value
- *   'version' is missing or invalid" (wild: Ananyakk71/javscript). Inject
- *   "0.0.0" so the session can attach.
- * - `"version": 1.0`, JSON authors write a number; Chrome requires a string
- *   of 1-4 dot-separated integers. String() preserves the intent.
- * - `"version": "x.y.z"` (any string that is not 1-4 dot-separated integers
- *   0-65535), a placeholder the author never filled in; Chrome refuses the
- *   whole extension over it. Salvage the numeric parts when there are any,
- *   fall back to "0.0.0" otherwise.
- * - `"default_icon": ""` (in action/browser_action/page_action), an empty
- *   icon path rejects the extension. Empty means "no icon": drop the key.
- * - An icon path (`icons`, `*_action.default_icon`) whose file exists but is
- *   0 bytes (wild: Speak2Type ships an empty icon-128.png), Chrome cannot
- *   decode it and refuses the whole extension with "Could not load icon".
- *   Requires `manifestDir` to resolve the paths; drop the entry.
- * - `'unsafe-inline'` in `content_security_policy.extension_pages`
- *   script-src, Chrome refuses the whole extension with "Insecure CSP
- *   value" (wild: zenwerk/tonikakuyare). MV3 never honors it, so stripping
- *   it changes nothing but the refusal.
- * - A named (non-`_execute_*`) command whose `description` is missing,
- *   empty, or not a string, Chrome refuses the whole extension with
- *   "Invalid value for 'commands[N].description'" (seen live loading a
- *   built extension). Fall back to the command name so the shortcut stays
- *   registered and the session can attach.
- */
 export declare function sanitizeFatalManifestShapes(manifest: Manifest, manifestDir?: string): {
     manifest: Manifest;
     fixes: FatalShapeFix[];

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

@@ -13,6 +13,25 @@ export declare function manifestLegacyWarningsSummary(count: number): string;
 export declare function pageActionNotSupportedByBrowser(browser: string): string;
 export declare function pageActionDroppedForBrowserAction(browser: string): string;
 export declare function vendorPrefixedKeyDropped(key: string, familyKey: string, vendor: 'chrome' | 'edge', browser: string): string;
+export declare function edgeStoreKeyDropped(browser: string): string;
 export declare function mv2SandboxPolicyDropped(browser: string): string;
 export declare function geckoSidePanelUnsupported(file: string): string;
+export declare function safariSidePanelUnsupported(file: string): string;
+export declare function safariOffscreenUnsupported(file: string): string;
+export declare function safariTabGroupsUnsupported(file: string): string;
+export declare function safariManagementUnsupported(file: string): string;
+export declare function safariUserScriptsUnsupported(file: string): string;
+export declare function safariIdentityUnsupported(file: string): string;
+export declare function safariNotificationsUnsupported(file: string): string;
+export declare function safariOmniboxUnsupported(file: string): string;
+export declare function safariBookmarksUnsupported(file: string): string;
+export declare function safariHistoryUnsupported(file: string): string;
+export declare function safariDownloadsUnsupported(file: string): string;
+export declare function safariIdleUnsupported(file: string): string;
+export declare const safariMissingMemberDetails: Record<string, string>;
+export declare function safariMemberUnsupported(file: string, api: string, member: string, kind: 'call' | 'read'): string;
 export declare function geckoActionUnsupportedOnMv2(file: string): string;
+export declare function webkitUnsupportedKeysDropped(browser: string, dropped: Array<{
+    path: string;
+    reason: string;
+}>): string;

package/dist/plugin-web-extension/feature-manifest/steps/apply-dev-defaults-lib/dev-injected-hosts.d.ts

@@ -16,10 +16,5 @@ interface ScannableModule {
 }
 export declare function isContentScriptModule(module: ScannableModule): boolean;
 export declare function findAbsoluteRequestUrls(source: string): string[];
-/**
- * Finds absolute request URLs whose host is granted only because dev unioned
- * the content-script matches into the manifest. Content-script modules are
- * skipped: their requests answer to page CORS rather than host permissions.
- */
 export declare function findInjectedOnlyHostUses(modules: Iterable<ScannableModule>, injected: readonly string[], declared: readonly string[], optional: readonly string[]): InjectedOnlyHostUse[];
 export {};

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

@@ -1,10 +1,5 @@
 import { type Compiler } from '@rspack/core';
 import type { DevOptions, PluginInterface } from '../../../types.js';
-/**
- * Patches manifest.json with web_accessible_resources from content script
- * imports. Depends on CollectContentEntryImports (feature-web-resources)
- * populating getSharedFor(compilation).entryImports before this runs.
- */
 export declare class PatchWAR {
     readonly manifestPath: string;
     readonly browser?: DevOptions['browser'];

package/dist/plugin-web-extension/feature-manifest/steps/patch-webkit-background.d.ts

@@ -0,0 +1,2 @@
+import type { DevOptions, Manifest } from '../../../types.js';
+export declare function patchWebkitBackground(manifest: Manifest, browser: DevOptions['browser']): Manifest;

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

@@ -4,6 +4,7 @@ export declare class UpdateManifest {
     readonly manifestPath: string;
     readonly browser: DevOptions['browser'];
     private reportedFatalFixes;
+    private reportedUnsupportedApis;
     constructor(options: PluginInterface);
     private applyDevOverrides;
     apply(compiler: Compiler): void;