extension-develop 4.1.19 → 4.1.21

package/dist/lib/ensure-develop-artifacts.d.ts

@@ -1,10 +1,3 @@
 import { type AbsolutePath } from './paths.js';
-/**
- * Install the user's project dependencies if node_modules is missing or stale.
- * This runs `npm install` (or pnpm/yarn/bun) in the project directory so that
- * user-declared dependencies (sass, vue, react, etc.) are available to the
- * bundler. Without this, `pnpm dlx extension build` in a clean directory would
- * fail to resolve project dependencies.
- */
 export declare function ensureUserProjectDependencies(packageJsonDir: AbsolutePath): Promise<void>;
 export declare function ensureDevelopArtifacts(): Promise<void>;

package/dist/lib/has-dependency.d.ts

@@ -1,6 +1 @@
-/**
- * True when `packageName` is declared by the project's manifest: package.json
- * dependency fields (dependencies, devDependencies, optionalDependencies,
- * peerDependencies) or a deno.json(c) `npm:` import.
- */
 export declare function hasDependency(projectPath: string, packageName: string): boolean;

package/dist/lib/manifest-utils.d.ts

@@ -8,5 +8,7 @@ export interface DroppedVendorKey {
     appliedBefore: boolean;
 }
 export declare function findDroppedVendorKeys(manifest: Manifest, browser: DevOptions['browser']): DroppedVendorKey[];
+export declare function isValidManifestVersion(value: unknown): value is 2 | 3;
+export declare function findPrefixedManifestVersionKeys(manifest: Manifest): string[];
 export declare function isStaticTheme(manifest: Manifest | undefined | null): boolean;
 export declare function isStaticThemeSource(manifestPath: string | undefined, browser: DevOptions['browser'] | string | undefined): boolean;

package/dist/lib/merge-options.d.ts

@@ -1,7 +1,3 @@
-/**
- * Stock defaults for `extension dev`. Applied only when neither
- * extension.config.js nor an explicit CLI flag set the option.
- */
 export declare const DEV_COMMAND_DEFAULTS: {
     polyfill: boolean;
     logFormat: 'pretty';
@@ -10,9 +6,6 @@ export declare const DEV_COMMAND_DEFAULTS: {
     logLevel: 'off';
     noOpen: boolean;
 };
-/**
- * Stock defaults for `extension build`. Zip and silent stay off unless set.
- */
 export declare const BUILD_COMMAND_DEFAULTS: {
     polyfill: boolean;
     zip: boolean;
@@ -20,50 +13,17 @@ export declare const BUILD_COMMAND_DEFAULTS: {
     silent: boolean;
     addonLint: boolean;
 };
-/**
- * Stock defaults for the `extension start` / `extension preview` browser
- * phase. Same logger defaults dev uses.
- */
 export declare const SERVE_COMMAND_DEFAULTS: {
     logFormat: 'pretty';
     logTimestamps: boolean;
     logColor: boolean;
     logLevel: 'off';
 };
-/**
- * Stock defaults for the silent production build `extension start` runs
- * before its preview phase. Polyfill defaults on, matching start's
- * historical behavior.
- */
 export declare const START_BUILD_DEFAULTS: {
     polyfill: boolean;
     silent: boolean;
     addonLint: boolean;
 };
-/**
- * Array-valued option keys that concatenate across layers (browser config,
- * then command config, then CLI). Order is preserved and duplicates are
- * dropped, keeping the first occurrence, so repeating a flag in a later
- * layer never doubles it on the browser command line.
- */
 export declare const CONCAT_ARRAY_KEYS: Set<string>;
-/**
- * Plain-object option keys that deep-merge across layers. Later layers win
- * on key conflict and nested plain objects recurse.
- */
 export declare const DEEP_MERGE_OBJECT_KEYS: Set<string>;
-/**
- * Layered option merge with one predictable precedence for every command:
- * stock defaults, then browser config, then command config, then CLI.
- *
- * Per-value strategy:
- * - Scalars (and most keys): the last defined layer wins, including `false`.
- * - List keys (`browserFlags`, `excludeBrowserFlags`): concatenate in layer
- *   order and dedupe, so CLI adds to config rather than replacing it.
- * - Object keys (`preferences`): deep-merge, later layers win on conflict.
- *
- * `undefined` values are stripped per layer (via {@link sanitize}) so an
- * unset CLI flag never clobbers extension.config.js, and config never
- * clobbers a flag the user actually typed (including `false`).
- */
 export declare function mergeOptionLayers<T extends object>(defaults: Partial<T>, ...layers: Array<object | null | undefined>): T;

package/dist/lib/messages.d.ts

@@ -19,9 +19,10 @@ export declare function projectInstallFallbackToNpm(pmName: string): string;
 export declare function projectInstallScriptsDisabled(pmName: string): string;
 export declare function anotherDevSessionActive(browser: string, pid: number, runId: string): string;
 export declare function buildAssetsTree(stats: Stats | undefined): string;
-export declare function buildComplete(browser: DevOptions['browser'], distDisplayPath: string, totalBytes?: number): string;
+export declare function buildComplete(browser: DevOptions['browser'], distDisplayPath: string, totalBytes?: number, mode?: 'development' | 'production' | 'none'): string;
 export declare function addonLintSummary(errorCount: number, warningCount: number, distDisplay: string): string;
-export declare function addonLintFinding(level: 'error' | 'warning', code: string, message: string, location: string): string;
+export declare function addonLintFinding(level: 'error' | 'warning', code: string, message: string, location: string, attribution?: string): string;
+export declare function addonLintDependencyAttribution(packages: string[], onlyDependencies: boolean): string;
 export declare function addonLintMore(hiddenCount: number, distDisplay: string): string;
 export declare function addonLintNotInstalled(installHint: string): string;
 export declare function addonLintFailed(reason: string): string;
@@ -41,8 +42,7 @@ type LooseBuildWarning = string | null | undefined | {
     chunkName?: unknown;
 };
 export declare function buildWarningsDetails(warnings: LooseBuildWarning[]): string;
-export declare function fetchingProjectPath(owner: string, project: string): string;
-export declare function downloadingProjectPath(projectName: string): string;
+export declare function downloadingProjectPath(projectName: string, url: string): string;
 export declare function creatingProjectPath(): string;
 export declare function downloadedProjectFolderNotFound(cwd: string, candidates: string[]): string;
 export declare function packagingSourceFiles(zipPath: string): string;

package/dist/lib/package-manager.d.ts

@@ -1,3 +1,4 @@
+import { type ChildProcess } from 'node:child_process';
 import { buildExecEnv } from 'prefers-yarn';
 export { buildExecEnv };
 import type { SUPPORTED_PACKAGE_MANAGERS } from './constants.js';
@@ -43,4 +44,5 @@ export declare function buildSpawnInvocation(command: string, args: string[]): {
     command: string;
     args: string[];
 };
+export declare function spawnInstallCommand(command: string, args: string[], options?: ExecOptions): ChildProcess;
 export declare function execInstallCommand(command: string, args: string[], options?: ExecOptions): Promise<void>;

package/dist/lib/project-manifest.d.ts

@@ -14,5 +14,4 @@ export declare function hasProjectDependency(projectDir: string, packageName: st
 export declare function findNearestProjectManifestDirSync(startPath: string, maxDepth?: number): string | undefined;
 export declare function findNearestProjectManifestSync(manifestPath: string): string | null;
 export declare function findNearestDenoConfigSync(manifestPath: string): string | null;
-/** True when the file exists and parses as JSONC. */
 export declare function validateDenoConfig(denoConfigPath: string): boolean;

package/dist/lib/session-paths.d.ts

@@ -1,29 +1,7 @@
-/**
- * THE owner of every on-disk session-state path. Dev sessions are
- * per project+browser, so every artifact here must embed the browser key,
- * a per-project single slot gets clobbered the moment a second browser
- * session starts on the same project (the control.token defect: session B's
- * start overwrote session A's eval token, and either shutdown deleted it
- * for both). New artifacts MUST be registered in SESSION_ARTIFACTS; the
- * layout spec fails any per-project shape that isn't an explicitly
- * allowlisted legacy slot, and a repo-scan spec fails path joins that
- * bypass this module.
- *
- * Two roots with different lifetimes:
- * - `<project>/.extension-js/` survives dist wipes. Anything a browser
- *   profile may have baked in (ports, tokens) lives here. A profile can
- *   outlive dist/, and state that dies with dist strands the profile's
- *   cached service worker (issue #484).
- * - `<project>/dist/extension-js/<browser>/` dies with dist. Machine
- *   contracts and logs that describe the CURRENT session only.
- */
 export declare function sessionStateDir(projectPath: string): string;
 export declare function controlPortFilePath(projectPath: string, browser: string): string;
-/** Pre-#484 location: died with dist/ while profiles outlived it. Read-only
- * fallback so a 4.0.6-era profile's cached SW can still resync. */
 export declare function legacyControlPortFilePath(projectPath: string, browser: string): string;
 export declare function controlTokenPath(projectPath: string, browser: string): string;
-/** Pre-fix single-slot token shared by every browser session of a project. */
 export declare function legacyControlTokenPath(projectPath: string): string;
 export declare function sessionArtifactsRootDir(projectPath: string): string;
 export declare const SESSION_ARTIFACTS_IGNORE_CONTENT: string;

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

@@ -127,13 +127,6 @@ export declare class BrowsersPlugin implements RunnerPlugin {
      */
     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

@@ -1,6 +1,8 @@
 import { type Compiler } from '@rspack/core';
 import type { DevOptions, PluginInterface } from '../types.js';
 export declare const IMPORT_META_URL_RUNTIME = "(function(){var h=typeof document!==\"undefined\"&&document.baseURI||self.location.href;try{var g=globalThis,r=(g.browser||g.chrome).runtime.getURL(\"/\");return h.indexOf(r)===0?h:r}catch(_){return h}})()";
+export declare function importMetaUrlForEmitPath(emitPath: string): string;
+export declare function toJsStringLiteral(value: string): string;
 export declare function getEnvFileCandidates(browser: DevOptions['browser'], mode: string): string[];
 export declare class EnvPlugin {
     readonly browser: DevOptions['browser'];
@@ -8,9 +10,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-js-frameworks/js-frameworks-lib/messages.d.ts

@@ -1,6 +1,7 @@
 export declare function installingRootDependencies(integration: string): string;
 export declare function integrationInstalledSuccessfully(integration: string): string;
 export declare function isUsingIntegration(name: string): string;
+export declare function solidIsNotSupported(): string;
 export declare function youAreAllSet(name: string): string;
 export declare function creatingTSConfig(): string;
 export declare function failedToInstallIntegration(integration: string, error: unknown): string;

package/dist/plugin-js-frameworks/js-tools/solid.d.ts

@@ -1,3 +1,6 @@
 import type { JsFramework } from '../../types.js';
 export declare function isUsingSolid(projectPath: string): boolean;
+type ResolveFromProject = (id: string) => string | undefined;
+export declare function resolveSolidHyperscript(resolveFromProject: ResolveFromProject): string | undefined;
 export declare function maybeUseSolid(projectPath: string): Promise<JsFramework | undefined>;
+export {};

package/dist/plugin-js-frameworks/js-tools/typescript.d.ts

@@ -3,6 +3,22 @@ export declare function isUsingTypeScript(projectPath: string): boolean;
 export declare function ensureTypeScriptConfig(projectPath: string): void;
 export declare function defaultTypeScriptConfig(projectPath: string, _opts?: unknown): {
     compilerOptions: {
+        jsxImportSource: import("../js-frameworks-lib/jsx-transform.js").JsxImportSource;
+        allowJs: boolean;
+        allowSyntheticDefaultImports: boolean;
+        esModuleInterop: boolean;
+        forceConsistentCasingInFileNames: boolean;
+        jsx: string;
+        lib: string[];
+        moduleResolution: string;
+        module: string;
+        resolveJsonModule: boolean;
+        strict: boolean;
+        target: string;
+        isolatedModules: boolean;
+        skipLibCheck: boolean;
+    } | {
+        jsxImportSource?: undefined;
         allowJs: boolean;
         allowSyntheticDefaultImports: boolean;
         esModuleInterop: boolean;

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

@@ -1,3 +1,4 @@
-export type AssetCategory = 'content-script' | 'service-worker' | 'page' | 'runtime' | 'ignored';
+export declare const ASSET_CATEGORIES: readonly ['content-script', 'service-worker', 'page', 'runtime', 'ignored'];
+export type AssetCategory = (typeof ASSET_CATEGORIES)[number];
 export declare function categorizeAsset(rawName: string): AssetCategory;
 export declare const BUDGET_BYTES: Record<AssetCategory, number>;

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;
@@ -32,4 +11,4 @@ export declare class PerfBudgetsPlugin {
     apply(compiler: Compiler): void;
 }
 export type { AssetCategory } from './categorize.js';
-export { BUDGET_BYTES, categorizeAsset } from './categorize.js';
+export { ASSET_CATEGORIES, BUDGET_BYTES, categorizeAsset } from './categorize.js';

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/index.d.ts

@@ -1,7 +1,7 @@
 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:

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/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[];