extension-develop 4.1.20 → 4.1.22

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

@@ -3,6 +3,24 @@ 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, 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-special-folders/folder-extensions/types.d.ts

@@ -1,4 +1,17 @@
+/**
+ * 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/messages.d.ts

@@ -1,6 +1,6 @@
 export declare function serverRestartRequiredFromSpecialFolderMessageOnly(addingOrRemoving: string, folder: string, typeOfAsset: string): string;
-export declare function publicMustBeAtProjectRoot(foundAt: string, expectedAt: string): string;
-export declare function publicFolderShadowed(usedAt: string, ignoredAt: string): string;
+export declare function publicMustBeAtProjectRoot(foundAt: string, expectedAt: string, projectRoot: string): string;
+export declare function publicFolderShadowed(usedAt: string, ignoredAt: string, projectRoot: string): string;
 export declare function specialFoldersSetupSummary(hasPublic: boolean, copyEnabled: boolean, ignoredCount: number): string;
 export declare function specialFolderChangeDetected(action: 'add' | 'remove', folder: 'pages' | 'scripts', relativePath: string): string;
 export declare function unreferencedScriptDropped(relativePaths: string[]): string;

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

@@ -13,6 +13,7 @@ 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 manifestVersionLostForBrowser(browser: string, prefixedKeys: string[], resolved: unknown): string;
 export declare function edgeStoreKeyDropped(browser: string): string;
 export declare function mv2SandboxPolicyDropped(browser: string): string;
 export declare function geckoSidePanelUnsupported(file: string): string;

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

@@ -0,0 +1,22 @@
+export interface EmittedModule {
+    resource?: string;
+    modules?: Iterable<EmittedModule>;
+}
+export interface EmittedChunk {
+    files?: Iterable<string>;
+}
+export interface EmittedCompilation {
+    getAssets?: () => readonly {
+        name: string;
+        source: {
+            source(): string | Buffer;
+        };
+    }[];
+    chunkGraph?: {
+        getModuleChunksIterable(module: EmittedModule): Iterable<EmittedChunk>;
+    };
+}
+export declare function shippableText(text: string): string;
+export declare function readEmittedScripts(compilation: EmittedCompilation): Map<string, string>;
+export declare function readProjectSource(resource: string): string | undefined;
+export declare function emittedFilesOf(compilation: EmittedCompilation, module: EmittedModule): string[] | undefined;

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

@@ -1,5 +1,14 @@
 import type { DevOptions, Manifest } from '../../../../types.js';
 export default function patchBackground(manifest: Manifest, browser: DevOptions['browser']): {
+    background: ({
+        scripts?: string[] | undefined;
+        page?: string | undefined;
+        persistent?: boolean | undefined;
+    } & {
+        service_worker: string;
+        type?: "module";
+    }) | undefined;
+} | {
     background: {
         scripts?: string[] | undefined;
         page?: string | undefined;

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

@@ -1,19 +1,10 @@
 import type { Manifest } from '../../../../types.js';
+export declare const DEV_RUNTIME_RESOURCES: string[];
 declare function patchWebResourcesV2(manifest: Manifest): string[];
-declare function patchWebResourcesV3(manifest: Manifest): ({
-    resources: string[];
-    matches: string[];
-} | (string & {
-    resources: string[];
-    use_dynamic_url?: boolean | undefined;
-} & {
-    extension_ids: string[];
-    matches?: string[] | undefined;
-}) | (string & {
-    resources: string[];
-    use_dynamic_url?: boolean | undefined;
-} & {
-    matches: string[];
-    extension_ids?: string[] | undefined;
-}))[];
+declare function patchWebResourcesV3(manifest: Manifest): unknown[];
+export declare function patchWebResources(manifest: Manifest): {
+    web_accessible_resources?: undefined;
+} | {
+    web_accessible_resources: Manifest['web_accessible_resources'];
+};
 export { patchWebResourcesV2, patchWebResourcesV3 };

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

@@ -1,6 +1,10 @@
-import { Compilation, type Compiler } from '@rspack/core';
+import { type Compiler } from '@rspack/core';
 import type { PluginInterface } from '../../../types.js';
-export declare function findInjectedOnlyPermissionUses(compilation: Pick<Compilation, 'modules'>, declared: Set<string>, injected: readonly string[]): Map<string, string>;
+import { type EmittedCompilation, type EmittedModule } from './apply-dev-defaults-lib/emitted-evidence.js';
+export interface PermissionScanCompilation extends EmittedCompilation {
+    modules: Iterable<EmittedModule>;
+}
+export declare function findInjectedOnlyPermissionUses(compilation: PermissionScanCompilation, declared: Set<string>, injected: readonly string[]): Map<string, string>;
 export declare class ApplyDevDefaults {
     private readonly manifestPath?;
     private readonly browser;

package/dist/plugin-web-extension/feature-manifest/steps/warn-gecko-unsupported-apis.d.ts

@@ -1,6 +1,7 @@
 import { type Compilation, type Compiler } from '@rspack/core';
 import type { DevOptions, Manifest } from '../../../types.js';
 import * as messages from '../messages.js';
+import { type EmittedCompilation } from './apply-dev-defaults-lib/emitted-evidence.js';
 declare const webkitUnsupportedApis: {
     readonly sidePanel: typeof messages.safariSidePanelUnsupported;
     readonly offscreen: typeof messages.safariOffscreenUnsupported;
@@ -124,20 +125,8 @@ interface ScannableModule {
     modules?: Iterable<ScannableModule>;
     rootModule?: ScannableModule;
 }
-interface ScannableChunk {
-    files?: Iterable<string>;
-}
-export interface ScannableCompilation {
+export interface ScannableCompilation extends EmittedCompilation {
     modules: Iterable<ScannableModule>;
-    getAssets?: () => readonly {
-        name: string;
-        source: {
-            source(): string | Buffer;
-        };
-    }[];
-    chunkGraph?: {
-        getModuleChunksIterable(module: ScannableModule): Iterable<ScannableChunk>;
-    };
 }
 export declare function findGeckoUnsupportedApiUses(compilation: ScannableCompilation, manifestVersion: unknown, engine?: UnsupportedApiEngine, requireEmittedEvidence?: boolean): GeckoUnsupportedApiUse[];
 export declare function reportGeckoUnsupportedApis(compilation: Compilation, compiler: Compiler, browser: DevOptions['browser'], manifest: Manifest, projectPath: string, reported?: Set<string>): void;

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

@@ -20,6 +20,11 @@ declare const SPLIT_ENTRY_SURFACES: {
     };
 };
 export declare function entrySplitAcrossInitialFiles(entryName: string, surface: keyof typeof SPLIT_ENTRY_SURFACES, ownFile: string, extraFiles: string[]): string;
+declare const PAGE_CONTEXT_SURFACES: {
+    readonly content_script: 'a content script';
+    readonly script: 'an injected script';
+};
+export declare function workerStartedFromPageContext(assetName: string, surface: keyof typeof PAGE_CONTEXT_SURFACES): string;
 export declare function fetchedFileDependencyMissing(assetName: string, literal: string, expectedPath: string): string;
 export declare function getURLDependencyMissing(assetName: string, literal: string, expectedPath: string): string;
 export declare function runtimeSetSurfaceDependencyMissing(assetName: string, literal: string, expectedPath: string): string;

package/dist/plugin-web-extension/feature-scripts/steps/warn-page-context-worker.d.ts

@@ -0,0 +1,5 @@
+import { type Compiler } from '@rspack/core';
+export declare function startsWorkerFromExtensionUrl(source: string): boolean;
+export declare class WarnPageContextWorker {
+    apply(compiler: Compiler): void;
+}

package/dist/plugin-web-extension/feature-web-resources/collect-entry-imports.d.ts

@@ -6,4 +6,5 @@ export declare const EMITTED_ASSET_REF_PATTERN: RegExp;
 export declare function listEmittedAssetNames(compilation: Compilation): string[];
 export declare function collectReferencedRuntimePayloads(source: string, emittedAssetNames: string[]): string[];
 export declare function collectContentScriptAsyncChunkFiles(compilation: Compilation): Record<string, string[]>;
+export declare function collectPageContextEntryFiles(compilation: Compilation): Record<string, string[]>;
 export declare function collectContentScriptEntryImports(compilation: Compilation, includeList?: FilepathList): Record<string, string[]>;

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

@@ -6,5 +6,6 @@ export declare function warFieldError(filePath: string, opts?: {
 }): string;
 export declare function warStringEntryInMv3(entry: string): string;
 export declare function warInvalidMatchPattern(pattern: string): string;
+export declare function warUnreachableResource(resource: string, entryName: string): string;
 export declare function entryImportsSummary(entryCount: number, totalResources: number): string;
 export declare function warPatchedSummary(v3Groups: number, v3ResourcesTotal: number, v2Resources: number): string;

package/dist/plugin-web-extension/feature-web-resources/web-resources-lib/unreachable-resources.d.ts

@@ -0,0 +1,9 @@
+export declare function normalizeResourcePath(value: string): string;
+export declare function isResourceCovered(declared: readonly string[], candidate: string): boolean;
+export declare const GET_URL_LITERAL_PATTERN: RegExp;
+export declare function collectGetUrlLiterals(source: string): string[];
+export declare function findUnreachableRuntimeResources(options: {
+    source: string;
+    emittedAssetNames: readonly string[];
+    declaredResources: readonly string[];
+}): string[];

package/dist/rspack-config.d.ts

@@ -1,4 +1,4 @@
-import type { Configuration } from '@rspack/core';
+import { type Configuration } from '@rspack/core';
 import type { ProjectStructure } from './lib/project.js';
 import type { WebpackConfigOptions } from './types.js';
 export default function webpackConfig(projectStructure: ProjectStructure, devOptions: WebpackConfigOptions): Configuration;