extension-develop 4.0.26 → 4.0.28

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/manifest-lib/theme-values.d.ts

@@ -4,4 +4,5 @@ export interface ThemeValueIssue {
     detail: string;
     value: string;
 }
+export declare function parseHexThemeColor(value: unknown): number[] | undefined;
 export declare function collectThemeValueIssues(manifest: Manifest | undefined | null): ThemeValueIssue[];

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-manifest/steps/patch-chromium-theme-colors.d.ts

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

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
@@ -171,8 +173,8 @@ export interface DevOptions extends BrowserOptionsBase {
     allowControl?: boolean;
     /**
      * Additionally allow the `eval` verb, which runs arbitrary code inside a
-     * context and writes a 0600 session token. Only honored together with
-     * `allowControl`. The CLI sets this from `--allow-eval`.
+     * context and writes a 0600 session token. Implies `allowControl`, since
+     * eval is strictly stronger. The CLI sets this from `--allow-eval`.
      */
     allowEval?: boolean;
     exitOnError?: boolean;
@@ -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.28",
   "description": "Develop, build, preview, and package Extension.js projects.",
   "author": {
     "name": "Cezar Augusto",