extension-develop 4.0.26 → 4.0.27

package/dist/lib/config-loader.d.ts

@@ -2,33 +2,33 @@ import type { Configuration } from '@rspack/core';
 import type { BrowserConfig, DevOptions } from '../types';
 export declare function loadCustomConfig(projectPath: string): Promise<(config: Configuration) => Configuration>;
 export declare function loadCommandConfig(projectPath: string, command: 'dev' | 'build' | 'start' | 'preview'): Promise<{
-    extensions: {};
-    transpilePackages: any[];
-    perfBudgets: object;
+    extensions: import("../module").CompanionExtensionsConfig;
+    transpilePackages: string[];
+    perfBudgets: Partial<Record<import("../plugin-perf-budgets").AssetCategory, number>>;
 } | {
-    extensions: {};
-    transpilePackages: any[];
+    extensions: import("../module").CompanionExtensionsConfig;
+    transpilePackages: string[];
     perfBudgets?: undefined;
 } | {
-    extensions: {};
+    extensions: import("../module").CompanionExtensionsConfig;
     transpilePackages?: undefined;
-    perfBudgets: object;
+    perfBudgets: Partial<Record<import("../plugin-perf-budgets").AssetCategory, number>>;
 } | {
-    extensions: {};
+    extensions: import("../module").CompanionExtensionsConfig;
     transpilePackages?: undefined;
     perfBudgets?: undefined;
 } | {
     extensions?: undefined;
-    transpilePackages: any[];
-    perfBudgets: object;
+    transpilePackages: string[];
+    perfBudgets: Partial<Record<import("../plugin-perf-budgets").AssetCategory, number>>;
 } | {
     extensions?: undefined;
-    transpilePackages: any[];
+    transpilePackages: string[];
     perfBudgets?: undefined;
 } | {
     extensions?: undefined;
     transpilePackages?: undefined;
-    perfBudgets: object;
+    perfBudgets: Partial<Record<import("../plugin-perf-budgets").AssetCategory, number>>;
 } | {
     extensions?: undefined;
     transpilePackages?: undefined;

package/dist/lib/constants.d.ts

@@ -1,6 +1,7 @@
 export declare const CERTIFICATE_DESTINATION_PATH: string;
 export declare const CHROMIUM_BASED_BROWSERS: string[];
 export declare const GECKO_BASED_BROWSERS: string[];
+export declare const WEBKIT_BASED_BROWSERS: string[];
 export declare const CHROMIUM_FAMILY_ALIASES: string[];
 export declare const GECKO_FAMILY_ALIASES: string[];
 export declare const SUPPORTED_BROWSERS: string[];
@@ -9,3 +10,4 @@ export declare const SUPPORTED_UI_FRAMEWORKS: readonly ['react', 'preact', 'vue'
 export declare const SUPPORTED_CSS_TECH: readonly ['css', 'css-modules', 'sass', 'less', 'postcss', 'tailwind'];
 export declare function isChromiumBasedBrowser(browser: string): boolean;
 export declare function isGeckoBasedBrowser(browser: string): boolean;
+export declare function isWebkitBasedBrowser(browser: string): boolean;

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

@@ -0,0 +1,67 @@
+/**
+ * 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';
+    logTimestamps: boolean;
+    logColor: boolean;
+    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;
+    zipSource: boolean;
+    silent: 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;
+};
+/**
+ * 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/paths.d.ts

@@ -16,4 +16,4 @@ export declare function normalizeBrowser(browser: BrowserInput, chromiumBinary?:
 export declare function getDistPath(packageJsonDir: AbsolutePath, browser: string): AbsolutePath;
 export declare function computePreviewOutputPath(struct: ProjectStructure, browser: string, explicitOutputPath?: string): AbsolutePath;
 export declare function ensureDirSync(dir: AbsolutePath): void;
-export declare function devtoolsEngineFor(browser: unknown): 'chrome' | 'edge' | 'chromium' | 'firefox';
+export declare function devtoolsEngineFor(browser: unknown): 'chrome' | 'edge' | 'chromium' | 'firefox' | 'safari';

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

@@ -29,6 +29,7 @@ export declare function sessionArtifactsRootDir(projectPath: string): string;
 export declare const SESSION_ARTIFACTS_IGNORE_CONTENT: string;
 export declare function sessionArtifactsIgnoreFilePath(projectPath: string): string;
 export declare function ensureSessionArtifactsIgnoreFile(projectPath: string): void;
+export declare function ensureSessionStateInProjectGitignore(projectPath: string): void;
 export declare function browserArtifactsDir(projectPath: string, browser: string): string;
 export declare function browserProfileRootDir(projectPath: string, browser: string): string;
 export declare function browserDistDir(projectPath: string, browser: string): string;

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

@@ -6,6 +6,7 @@ export declare class BoringPlugin {
     readonly browser: PluginInterface['browser'];
     private sawUserInvalidation;
     private printedStartupSuccess;
+    private printedStartupWarning;
     private lastKnownManifestName?;
     constructor(options: PluginInterface);
     apply(compiler: Compiler): void;

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

@@ -9,6 +9,8 @@ export interface ZipPluginOptions {
         zipFilename?: string;
     };
 }
+export declare function isDeniedFromSourceZip(file: string): boolean;
+export declare function getFilesToZip(projectDir: string): Promise<string[]>;
 export declare class ZipPlugin {
     private readonly options;
     private readonly browser;

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

@@ -83,6 +83,8 @@ type PluginOptions = {
 };
 export declare function formatStatsErrors(errors: unknown): string[];
 export declare function getSessionRunId(packageJsonDir: string, browser: string): string;
+export declare function stampReadyDistExtensionId(packageJsonDir: string, browser: string, distPath: string): void;
+export declare function stampReadyKnownExtensionId(packageJsonDir: string, browser: string, extensionId: string): void;
 export interface LiveDevSessionOwner {
     pid: number;
     runId: string;

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

@@ -5,7 +5,8 @@ export interface ParsedHtmlAsset {
     moduleJs?: string[];
     static?: string[];
 }
-export declare function getAssetsFromHtml(htmlFilePath: string | undefined, htmlContent?: string, publicPath?: string): ParsedHtmlAsset;
+export declare function evictAssetsFromHtmlCache(htmlFilePath?: string): void;
+export declare function getAssetsFromHtml(htmlFilePath: string | undefined, htmlContent?: string): ParsedHtmlAsset;
 export declare function getHtmlPageDeclaredAssetPath(filepathList: FilepathList, filePath: string, extension: string): string;
 export declare function getExtname(filePath: string): string;
 export declare function getFilePath(filePath: string, extension: string, isPublic: boolean): string;

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

@@ -5,6 +5,8 @@ export declare function jsonMissingFile(manifestField: string, filePath: string,
 }): string;
 export declare function invalidJsonSyntax(manifestField: string, file: string, cause: string): string;
 export declare function invalidRulesetStructure(manifestField: string, file: string): string;
+export declare function invalidRulesetRule(manifestField: string, file: string, ruleIndex: number, reason: string): string;
+export declare function rulesetRuleShapeIssue(manifestField: string, file: string, ruleIndex: number, reason: string): string;
 export declare function invalidManagedSchemaStructure(manifestField: string, file: string): string;
 export declare function jsonEmitSummary(feature: string, stats: {
     entries: number;

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

@@ -2,6 +2,7 @@ export declare function serverRestartRequiredFromManifestError(fileAdded: string
 export declare function legacyManifestPathWarning(legacyPath: 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;
 export declare function missingGeckoDataCollectionPermissions(): string;
 export declare function manifestInvalidError(error: NodeJS.ErrnoException): string;
 export declare function manifestIncludeSummary(browser: string, manifestPath: string): string;

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

@@ -1,3 +1,4 @@
 import type { Compilation } from '@rspack/core';
 import type { FilepathList } from '../../types';
+export declare const EMITTED_ASSET_REF_PATTERN: RegExp;
 export declare function collectContentScriptEntryImports(compilation: Compilation, includeList?: FilepathList): Record<string, string[]>;

package/dist/types.d.ts

@@ -110,6 +110,8 @@ export interface SafariPackagerOverrides {
     macOsOnly?: boolean;
     forceRegenerate?: boolean;
     safariBinary?: string;
+    /** When set, overrides the factory `noOpen` for this packaging call. */
+    noOpen?: boolean;
 }
 /**
  * The packaging callback develop calls once the Safari dist is on disk. The
@@ -335,7 +337,19 @@ export interface BrowserConfig extends BrowserOptionsBase {
 export type OutputConfig = {
     clean: boolean;
     path: string;
+    /**
+     * Internal: the final dist path when `path` points at the staging
+     * directory a one-shot build is later promoted from. Metadata surfaces
+     * (ready.json) advertise this path, never the staging directory.
+     */
+    finalPath?: string;
 };
+/**
+ * Per-category asset size budgets (bytes) for the perf-budgets plugin.
+ * Set at the top level of extension.config.js, or per command via
+ * `commands.dev.perfBudgets` / `commands.build.perfBudgets`.
+ */
+export type PerfBudgetsConfig = Partial<Record<import('./plugin-perf-budgets').AssetCategory, number>>;
 export interface CommonWebpackOptions {
     output: OutputConfig;
     preferences?: Record<string, unknown>;
@@ -346,7 +360,7 @@ export interface CommonWebpackOptions {
      * Useful for monorepos where package exports point to TS/TSX files.
      */
     transpilePackages?: string[];
-    perfBudgets?: Partial<Record<import('./plugin-perf-budgets').AssetCategory, number>>;
+    perfBudgets?: PerfBudgetsConfig;
     /**
      * Companion extensions (load-only). Each entry must be an unpacked extension root
      * containing a manifest.json. These are loaded alongside the user extension in
@@ -386,13 +400,14 @@ export interface FileConfig {
         [K in BrowserType]?: BrowserConfig;
     };
     commands?: {
-        dev?: Pick<DevOptions, 'browser' | 'profile' | 'chromiumBinary' | 'geckoBinary' | 'noOpen' | 'noBrowser' | 'polyfill'> & Pick<DevOptions, 'logLevel' | 'logContexts' | 'logFormat' | 'logTimestamps' | 'logColor' | 'logUrl' | 'logTab' | 'hashContentScripts'> & {
+        dev?: Pick<DevOptions, 'browser' | 'profile' | 'chromiumBinary' | 'geckoBinary' | 'safariBinary' | 'appName' | 'bundleId' | 'macOsOnly' | 'noOpen' | 'noBrowser' | 'polyfill'> & Pick<DevOptions, 'logLevel' | 'logContexts' | 'logFormat' | 'logTimestamps' | 'logColor' | 'logUrl' | 'logTab' | 'hashContentScripts'> & {
             browserFlags?: string[];
             excludeBrowserFlags?: string[];
             preferences?: Record<string, unknown>;
             persistProfile?: boolean;
             extensions?: CompanionExtensionsConfig;
             transpilePackages?: string[];
+            perfBudgets?: PerfBudgetsConfig;
         };
         start?: Pick<StartOptions, 'browser' | 'profile' | 'chromiumBinary' | 'geckoBinary' | 'polyfill' | 'noBrowser' | 'port' | 'host' | 'publicHost' | 'logLevel' | 'logContexts' | 'logFormat' | 'logTimestamps' | 'logColor' | 'logUrl' | 'logTab'> & {
             browserFlags?: string[];
@@ -410,9 +425,10 @@ export interface FileConfig {
             extensions?: CompanionExtensionsConfig;
             transpilePackages?: string[];
         };
-        build?: Pick<BuildOptions, 'browser' | 'zipFilename' | 'zip' | 'zipSource' | 'polyfill'> & {
+        build?: Pick<BuildOptions, 'browser' | 'zipFilename' | 'zip' | 'zipSource' | 'polyfill' | 'silent' | 'safariBinary' | 'appName' | 'bundleId' | 'macOsOnly'> & {
             extensions?: CompanionExtensionsConfig;
             transpilePackages?: string[];
+            perfBudgets?: PerfBudgetsConfig;
         };
     };
     /**
@@ -425,5 +441,10 @@ export interface FileConfig {
      * Per-command `commands.<name>.transpilePackages` overrides this value.
      */
     transpilePackages?: string[];
+    /**
+     * Default per-category asset budgets for all commands.
+     * Per-command `commands.dev|build.perfBudgets` overrides this value.
+     */
+    perfBudgets?: PerfBudgetsConfig;
     config?: (config: Configuration) => Configuration;
 }

package/package.json

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