wxt 0.20.25 → 0.20.27

package/dist/cli/cli-utils.mjs

@@ -44,7 +44,7 @@ const aliasCommandNames = /* @__PURE__ */ new Set();
 * @param docsUrl URL to the docs for the aliased CLI tool
 */
 function createAliasedCommand(base, name, alias, bin, docsUrl) {
-	const aliasedCommand = base.command(name, `Alias for ${alias} (${docsUrl})`).allowUnknownOptions().action(async () => {
+	const aliasedCommand = base.command(`${name} [...args]`, `Alias for ${alias} (${docsUrl})`).allowUnknownOptions().action(async () => {
 		try {
 			await registerWxt("build");
 			await spawn(bin, process.argv.slice(process.argv.indexOf(aliasedCommand.name) + 1), { stdio: "inherit" });

package/dist/core/create-server.mjs

@@ -1,21 +1,12 @@
 import { unnormalizePath } from "./utils/paths.mjs";
-import { getEntrypointBundlePath, isHtmlEntrypoint } from "./utils/entrypoints.mjs";
 import { deinitWxtModules, initWxtModules, registerWxt, wxt } from "./wxt.mjs";
-import { detectDevChanges } from "./utils/building/detect-dev-changes.mjs";
-import { findEntrypoints } from "./utils/building/find-entrypoints.mjs";
-import { getContentScriptJs, mapWxtOptionsToRegisteredContentScript } from "./utils/content-scripts.mjs";
-import { getContentScriptCssFiles, getContentScriptsCssMap } from "./utils/manifest.mjs";
-import { rebuild } from "./utils/building/rebuild.mjs";
 import { internalBuild } from "./utils/building/internal-build.mjs";
 import "./utils/building/index.mjs";
 import { createExtensionRunner } from "./runners/index.mjs";
 import { createKeyboardShortcuts } from "./keyboard-shortcuts.mjs";
 import { isBabelSyntaxError, logBabelSyntaxError } from "./utils/syntax-errors.mjs";
-import { relative } from "node:path";
-import { styleText } from "node:util";
-import { debounce } from "perfect-debounce";
+import { createFileReloader, reloadContentScripts } from "./utils/create-file-reloader.mjs";
 import chokidar from "chokidar";
-import { Mutex } from "async-mutex";
 //#region src/core/create-server.ts
 /**
 * Creates a dev server and pre-builds all the files that need to exist before
@@ -147,93 +138,6 @@ async function createServerInternal() {
 	return server;
 }
 /**
-* Returns a function responsible for reloading different parts of the extension
-* when a file changes.
-*/
-function createFileReloader(server) {
-	const fileChangedMutex = new Mutex();
-	const changeQueue = [];
-	const cb = async (event, path) => {
-		changeQueue.push([event, path]);
-		await fileChangedMutex.runExclusive(async () => {
-			if (server.currentOutput == null) return;
-			const fileChanges = changeQueue.splice(0, changeQueue.length).map(([_, file]) => file);
-			if (fileChanges.length === 0) return;
-			await wxt.reloadConfig();
-			const changes = detectDevChanges(fileChanges, server.currentOutput);
-			if (changes.type === "no-change") return;
-			if (changes.type === "full-restart") {
-				wxt.logger.info("Config changed, restarting server...");
-				server.restart();
-				return;
-			}
-			if (changes.type === "browser-restart") {
-				wxt.logger.info("Runner config changed, restarting browser...");
-				server.restartBrowser();
-				return;
-			}
-			wxt.logger.info(`Changed: ${Array.from(new Set(fileChanges)).map((file) => styleText("dim", relative(wxt.config.root, file))).join(", ")}`);
-			const allEntrypoints = await findEntrypoints();
-			try {
-				const { output: newOutput } = await rebuild(allEntrypoints, changes.rebuildGroups, changes.cachedOutput);
-				server.currentOutput = newOutput;
-				switch (changes.type) {
-					case "extension-reload":
-						server.reloadExtension();
-						wxt.logger.success(`Reloaded extension`);
-						break;
-					case "html-reload":
-						const { reloadedNames } = reloadHtmlPages(changes.rebuildGroups, server);
-						wxt.logger.success(`Reloaded: ${getFilenameList(reloadedNames)}`);
-						break;
-					case "content-script-reload":
-						reloadContentScripts(changes.changedSteps, server);
-						const rebuiltNames = changes.rebuildGroups.flat().map((entry) => entry.name);
-						wxt.logger.success(`Reloaded: ${getFilenameList(rebuiltNames)}`);
-						break;
-				}
-			} catch {}
-		}).catch((error) => {
-			if (!isBabelSyntaxError(error)) throw error;
-			logBabelSyntaxError(error);
-		});
-	};
-	return debounce(cb, wxt.config.dev.server.watchDebounce, {
-		leading: true,
-		trailing: false
-	});
-}
-/**
-* From the server, tell the client to reload content scripts from the provided
-* build step outputs.
-*/
-function reloadContentScripts(steps, server) {
-	if (wxt.config.manifestVersion === 3) steps.forEach((step) => {
-		if (server.currentOutput == null) return;
-		const entry = step.entrypoints;
-		if (Array.isArray(entry) || entry.type !== "content-script") return;
-		const js = getContentScriptJs(wxt.config, entry);
-		const cssMap = getContentScriptsCssMap(server.currentOutput, [entry]);
-		const css = getContentScriptCssFiles([entry], cssMap);
-		server.reloadContentScript({
-			registration: entry.options.registration,
-			contentScript: mapWxtOptionsToRegisteredContentScript(entry.options, js, css)
-		});
-	});
-	else server.reloadExtension();
-}
-function reloadHtmlPages(groups, server) {
-	const htmlEntries = groups.flat().filter(isHtmlEntrypoint);
-	htmlEntries.forEach((entry) => {
-		const path = getEntrypointBundlePath(entry, wxt.config.outDir, ".html");
-		server.reloadPage(path);
-	});
-	return { reloadedNames: htmlEntries.map((entry) => entry.name) };
-}
-function getFilenameList(names) {
-	return names.map((name) => styleText("cyan", name)).join(styleText("dim", ", "));
-}
-/**
 * Based on the current build output, return a list of files that are:
 *
 * 1. Not in node_modules

package/dist/core/utils/create-file-reloader.mjs

@@ -0,0 +1,103 @@
+import { getEntrypointBundlePath, isHtmlEntrypoint } from "./entrypoints.mjs";
+import { wxt } from "../wxt.mjs";
+import { detectDevChanges } from "./building/detect-dev-changes.mjs";
+import { findEntrypoints } from "./building/find-entrypoints.mjs";
+import { getContentScriptJs, mapWxtOptionsToRegisteredContentScript } from "./content-scripts.mjs";
+import { getContentScriptCssFiles, getContentScriptsCssMap } from "./manifest.mjs";
+import { rebuild } from "./building/rebuild.mjs";
+import "./building/index.mjs";
+import { isBabelSyntaxError, logBabelSyntaxError } from "./syntax-errors.mjs";
+import { relative } from "node:path";
+import { styleText } from "node:util";
+import { debounce } from "perfect-debounce";
+import { Mutex } from "async-mutex";
+//#region src/core/utils/create-file-reloader.ts
+/**
+* Returns a function responsible for reloading different parts of the extension
+* when a file changes.
+*/
+function createFileReloader(server) {
+	const fileChangedMutex = new Mutex();
+	const changeQueue = [];
+	const cb = async (event, path) => {
+		changeQueue.push([event, path]);
+		await fileChangedMutex.runExclusive(async () => {
+			if (server.currentOutput == null) return;
+			const fileChanges = changeQueue.splice(0, changeQueue.length).map(([_, file]) => file);
+			if (fileChanges.length === 0) return;
+			await wxt.reloadConfig();
+			const changes = detectDevChanges(fileChanges, server.currentOutput);
+			if (changes.type === "no-change") return;
+			if (changes.type === "full-restart") {
+				wxt.logger.info("Config changed, restarting server...");
+				server.restart();
+				return;
+			}
+			if (changes.type === "browser-restart") {
+				wxt.logger.info("Runner config changed, restarting browser...");
+				server.restartBrowser();
+				return;
+			}
+			wxt.logger.info(`Changed: ${Array.from(new Set(fileChanges)).map((file) => styleText("dim", relative(wxt.config.root, file))).join(", ")}`);
+			const allEntrypoints = await findEntrypoints();
+			try {
+				const { output: newOutput } = await rebuild(allEntrypoints, changes.rebuildGroups, changes.cachedOutput);
+				server.currentOutput = newOutput;
+				switch (changes.type) {
+					case "extension-reload":
+						server.reloadExtension();
+						wxt.logger.success(`Reloaded extension`);
+						break;
+					case "html-reload":
+						const { reloadedNames } = reloadHtmlPages(changes.rebuildGroups, server);
+						wxt.logger.success(`Reloaded: ${getFilenameList(reloadedNames)}`);
+						break;
+					case "content-script-reload":
+						reloadContentScripts(changes.changedSteps, server);
+						const rebuiltNames = changes.rebuildGroups.flat().map((entry) => entry.name);
+						wxt.logger.success(`Reloaded: ${getFilenameList(rebuiltNames)}`);
+						break;
+				}
+			} catch {}
+		}).catch((error) => {
+			if (!isBabelSyntaxError(error)) throw error;
+			logBabelSyntaxError(error);
+		});
+	};
+	return debounce(cb, wxt.config.dev.server.watchDebounce, {
+		leading: true,
+		trailing: false
+	});
+}
+/**
+* From the server, tell the client to reload content scripts from the provided
+* build step outputs.
+*/
+function reloadContentScripts(steps, server) {
+	if (wxt.config.manifestVersion === 3) steps.forEach((step) => {
+		if (server.currentOutput == null) return;
+		const entry = step.entrypoints;
+		if (Array.isArray(entry) || entry.type !== "content-script") return;
+		const js = getContentScriptJs(wxt.config, entry);
+		const cssMap = getContentScriptsCssMap(server.currentOutput, [entry]);
+		const css = getContentScriptCssFiles([entry], cssMap);
+		server.reloadContentScript({
+			registration: entry.options.registration,
+			contentScript: mapWxtOptionsToRegisteredContentScript(entry.options, js, css)
+		});
+	});
+	else server.reloadExtension();
+}
+function reloadHtmlPages(groups, server) {
+	const htmlEntries = groups.flat().filter(isHtmlEntrypoint);
+	htmlEntries.forEach((entry) => {
+		const path = getEntrypointBundlePath(entry, wxt.config.outDir, ".html");
+		server.reloadPage(path);
+	});
+	return { reloadedNames: htmlEntries.map((entry) => entry.name) };
+}
+function getFilenameList(names) {
+	return names.map((name) => styleText("cyan", name)).join(styleText("dim", ", "));
+}
+//#endregion
+export { createFileReloader, reloadContentScripts };

package/dist/core/utils/log/printFileList.mjs

@@ -1,3 +1,4 @@
+import { wxt } from "../../wxt.mjs";
 import { printTable } from "./printTable.mjs";
 import { lstat } from "node:fs/promises";
 import path from "node:path";
@@ -10,9 +11,14 @@ async function printFileList(log, header, baseDir, files) {
 		const parts = [path.relative(process.cwd(), baseDir) + path.sep, path.relative(baseDir, file)];
 		const prefix = i === files.length - 1 ? "  └─" : "  ├─";
 		const chunkColor = getChunkColor(file);
-		const stats = await lstat(file);
-		totalSize += stats.size;
-		const size = String(filesize(stats.size));
+		let size = "";
+		try {
+			const stats = await lstat(file);
+			totalSize += stats.size;
+			size = String(filesize(stats.size));
+		} catch (ex) {
+			wxt.logger.warn(`Could not get stats of '${file}' error: ${ex}`);
+		}
 		return [`${styleText("gray", prefix)} ${styleText("dim", parts[0])}${styleText(chunkColor, parts[1])}`, styleText("dim", size)];
 	}));
 	fileRows.push([`${styleText("cyan", "Σ Total size:")} ${String(filesize(totalSize))}`]);

package/dist/core/utils/manifest.mjs

@@ -56,6 +56,7 @@ async function generateManifest(allEntrypoints, buildOutput) {
 	manifest.version = version;
 	manifest.version_name = wxt.config.browser === "firefox" || versionName === version ? void 0 : versionName;
 	if (wxt.config.browser === "firefox" && !userManifest.browser_specific_settings?.gecko?.data_collection_permissions && !wxt.config.suppressWarnings?.firefoxDataCollection) wxt.logger.warn("Firefox requires `data_collection_permissions` for new extensions from November 3, 2025. Existing extensions are exempt for now.\nFor more details, see: https://extensionworkshop.com/documentation/develop/firefox-builtin-data-consent/\nTo suppress this warning, set `suppressWarnings.firefoxDataCollection` to `true` in your wxt config.\n");
+	if (wxt.config.browser === "firefox" && !manifest.browser_specific_settings?.gecko?.id && !wxt.config.suppressWarnings?.firefoxId) wxt.logger.warn("Firefox requires extension ID for MV3 and recommends it for MV2.\nFor more details, see: https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/browser_specific_settings#id");
 	addEntrypoints(manifest, entrypoints, buildOutput);
 	if (wxt.config.browser === "firefox") addDiscoveredThemeIcons(manifest, buildOutput);
 	if (wxt.config.command === "serve") addDevModeCsp(manifest);
@@ -136,10 +137,11 @@ function addEntrypoints(manifest, entrypoints, buildOutput) {
 		const options = {};
 		if (popup.options.defaultIcon) options.default_icon = popup.options.defaultIcon;
 		if (popup.options.defaultTitle) options.default_title = popup.options.defaultTitle;
+		if (popup.options.defaultState && wxt.config.manifestVersion === 3) options.default_state = popup.options.defaultState;
 		if (popup.options.browserStyle) options.browser_style = popup.options.browserStyle;
 		if (popup.options.defaultArea) options.default_area = popup.options.defaultArea;
 		if (popup.options.themeIcons) options.theme_icons = popup.options.themeIcons;
-		const actionKey = manifest.manifest_version === 2 ? popup.options.actionType ?? "browser_action" : wxt.config.browser === "firefox" && popup.options.actionType === "page_action" ? "page_action" : "action";
+		const actionKey = wxt.config.manifestVersion === 2 ? popup.options.actionType ?? "browser_action" : wxt.config.browser === "firefox" && popup.options.actionType === "page_action" ? "page_action" : "action";
 		manifest[actionKey] = {
 			...manifest[actionKey],
 			...options,
@@ -150,7 +152,7 @@ function addEntrypoints(manifest, entrypoints, buildOutput) {
 	if (options) {
 		const page = getEntrypointBundlePath(options, wxt.config.outDir, ".html");
 		manifest.options_ui = {
-			open_in_tab: options.options.openInTab ?? false,
+			...wxt.config.browser !== "safari" && { open_in_tab: options.options.openInTab ?? false },
 			browser_style: wxt.config.browser === "firefox" ? options.options.browserStyle : void 0,
 			chrome_style: wxt.config.browser !== "firefox" ? options.options.chromeStyle : void 0,
 			page
@@ -239,9 +241,9 @@ function addDevModeCsp(manifest) {
 	}
 	const permission = `${permissionUrl}*`;
 	const allowedCsp = wxt.server?.origin ?? "http://localhost:*";
-	if (manifest.manifest_version === 3) addHostPermission(manifest, permission);
+	if (wxt.config.manifestVersion === 3) addHostPermission(manifest, permission);
 	else addPermission(manifest, permission);
-	const extensionPagesCsp = new ContentSecurityPolicy(manifest.content_security_policy?.extension_pages ?? (manifest.manifest_version === 3 ? DEFAULT_MV3_EXTENSION_PAGES_CSP : DEFAULT_MV2_CSP));
+	const extensionPagesCsp = new ContentSecurityPolicy(manifest.content_security_policy?.extension_pages ?? (wxt.config.manifestVersion === 3 ? DEFAULT_MV3_EXTENSION_PAGES_CSP : DEFAULT_MV2_CSP));
 	const sandboxCsp = new ContentSecurityPolicy(manifest.content_security_policy?.sandbox ?? DEFAULT_MV3_SANDBOX_CSP);
 	if (wxt.config.command === "serve") {
 		extensionPagesCsp.add("script-src", allowedCsp);

package/dist/core/utils/picomatch-multiple.mjs

@@ -8,10 +8,8 @@ import picomatch from "picomatch";
 * matches any of the negative patterns, it will return `false`.
 *
 * @example
-*   ```ts
 *   picomatchMultiple('a.json', ['*.json', '!b.json']); // => true
 *   picomatchMultiple('b.json', ['*.json', '!b.json']); // => false
-*   ```;
 */
 function picomatchMultiple(search, patterns, options) {
 	if (patterns == null) return false;

package/dist/types.d.mts

@@ -89,7 +89,7 @@ interface InlineConfig {
    *   'serve')
    *
    * @example
-   *   {{browser}} -mv{{manifestVersion}}
+   *   '{{browser}}-mv{{manifestVersion}}';
    *
    * @default <span v-pre>`"{{browser}}-mv{{manifestVersion}}{{modeSuffix}}"`</span>
    */
@@ -168,13 +168,11 @@ interface InlineConfig {
    * Suppress specific warnings during the build process.
    *
    * @example
-   *   ```ts
    *   export default defineConfig({
    *     suppressWarnings: {
    *       firefoxDataCollection: true,
    *     },
-   *   })
-   *   ```;
+   *   });
    */
   suppressWarnings?: {
     /**
@@ -182,6 +180,11 @@ interface InlineConfig {
      * https://extensionworkshop.com/documentation/develop/firefox-builtin-data-consent
      */
     firefoxDataCollection?: boolean;
+    /**
+     * Suppress warnings when the Firefox extension ID is missing.
+     * https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/browser_specific_settings#id
+     */
+    firefoxId?: boolean;
   };
   /**
    * Configure browser startup. Options set here can be overridden in a
@@ -309,10 +312,10 @@ interface InlineConfig {
      *
      * @example
      *   // Correct:
-     *   ['@scope/package-name', 'package-name'][
-     *     // Incorrect, don't include versions!!!
-     *     ('@scope/package-name@1.1.3', 'package-name@^2')
-     *   ];
+     *   ['@scope/package-name', 'package-name'];
+     *
+     *   // Incorrect, don't include versions!!!
+     *   ['@scope/package-name@1.1.3', 'package-name@^2'];
      *
      * @default [ ]
      */
@@ -699,6 +702,22 @@ interface BaseContentScriptEntrypointOptions extends BaseScriptEntrypointOptions
    * @default 'manifest'
    */
   registration?: PerBrowserOption<'manifest' | 'runtime'>;
+  /**
+   * Do not send the `wxt:content-script-started` message via
+   * `window.postMessage`.
+   *
+   * This has been replaced with custom events. The `postMessage` call is kept
+   * for backwards compatibility. For some websites the `postMessage` call is
+   * undesirable, such as those with poorly written message event listeners.
+   *
+   * Setting this to `true` opts into the behavior that will become the default
+   * in a future version of WXT, where the `postMessage` call is removed
+   * entirely.
+   *
+   * See https://github.com/wxt-dev/wxt/pull/1938 and
+   * https://github.com/wxt-dev/wxt/pull/2035 for a detailed discussion.
+   */
+  noScriptStartedPostMessage?: boolean;
 }
 interface MainWorldContentScriptEntrypointOptions extends BaseContentScriptEntrypointOptions {
   /**
@@ -742,6 +761,12 @@ interface PopupEntrypointOptions extends BaseEntrypointOptions {
   mv2Key?: PerBrowserOption<'browser_action' | 'page_action'>;
   defaultIcon?: Record<string, string>;
   defaultTitle?: PerBrowserOption<string>;
+  /**
+   * Chrome only. Controls the initial enabled/disabled state of the action.
+   *
+   * @see https://developer.chrome.com/docs/extensions/reference/api/action#enabled_state
+   */
+  defaultState?: PerBrowserOption<'enabled' | 'disabled'>;
   browserStyle?: PerBrowserOption<boolean>;
   /**
    * Firefox only. Defines the part of the browser in which the button is
@@ -968,7 +993,7 @@ type UserManifest = { [key in keyof Browser.runtime.ManifestV3 as key extends 'a
       strict_max_version?: string;
     };
   };
-  permissions?: (Browser.runtime.ManifestPermissions | (string & Record<never, never>))[];
+  permissions?: (Browser.runtime.ManifestPermission | (string & Record<never, never>))[];
   web_accessible_resources?: string[] | Browser.runtime.ManifestV3['web_accessible_resources'];
 };
 type UserManifestFn = (env: ConfigEnv) => UserManifest | Promise<UserManifest>;
@@ -1369,6 +1394,7 @@ interface ResolvedConfig$1 {
   /** List of warning identifiers to suppress during the build process. */
   suppressWarnings: {
     firefoxDataCollection?: boolean;
+    firefoxId?: boolean;
   };
   dev: {
     /** Only defined during dev command */server?: {

package/dist/utils/content-script-context.mjs

@@ -169,7 +169,7 @@ var ContentScriptContext = class ContentScriptContext {
 			contentScriptName: this.contentScriptName,
 			messageId: this.id
 		} }));
-		window.postMessage({
+		if (!this.options?.noScriptStartedPostMessage) window.postMessage({
 			type: ContentScriptContext.SCRIPT_STARTED_MESSAGE_TYPE,
 			contentScriptName: this.contentScriptName,
 			messageId: this.id

package/dist/version.mjs

@@ -1,4 +1,4 @@
 //#region src/version.ts
-const version = "0.20.25";
+const version = "0.20.27";
 //#endregion
 export { version };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "wxt",
   "type": "module",
-  "version": "0.20.25",
+  "version": "0.20.27",
   "description": "⚡ Next-gen Web Extension Framework",
   "license": "MIT",
   "scripts": {
@@ -21,10 +21,10 @@
     "@webext-core/fake-browser": "^1.3.4",
     "@webext-core/isolated-element": "^1.1.3",
     "@webext-core/match-patterns": "^1.0.3",
-    "@wxt-dev/browser": "^0.1.40",
+    "@wxt-dev/browser": "^0.2.0",
     "@wxt-dev/storage": "^1.0.0",
     "async-mutex": "^0.5.0",
-    "c12": "^3.3.3",
+    "c12": "^3.3.4",
     "cac": "^6.7.14 || ^7.0.0",
     "chokidar": "^5.0.0",
     "ci-info": "^4.4.0",
@@ -32,7 +32,7 @@
     "defu": "^6.1.4",
     "dotenv-expand": "^12.0.3",
     "esbuild": "^0.27.1",
-    "filesize": "^11.0.15",
+    "filesize": "^11.0.17",
     "get-port-please": "^3.2.0",
     "giget": "^1.2.3 || ^2.0.0 || ^3.0.0",
     "hookable": "^6.1.0",
@@ -51,9 +51,9 @@
     "perfect-debounce": "^2.1.0",
     "picomatch": "^4.0.3",
     "prompts": "^2.4.2",
-    "publish-browser-extension": "^2.3.0 || ^3.0.2 || ^4.0.4",
+    "publish-browser-extension": "^2.3.0 || ^3.0.2 || ^4.0.5",
     "scule": "^1.3.0",
-    "tinyglobby": "^0.2.15",
+    "tinyglobby": "^0.2.16",
     "unimport": "^3.13.1 || ^4.0.0 || ^5.0.0 || ^6.0.0",
     "vite": "^5.4.19 || ^6.3.4 || ^7.0.0 || ^8.0.0-0",
     "vite-node": "^3.2.4 || ^5.0.0 || ^6.0.0",
@@ -71,7 +71,6 @@
     "@aklinker1/buildc": "^1.1.7",
     "@faker-js/faker": "^10.3.0",
     "@types/bun": "^1.3.5",
-    "@types/fs-extra": "^11.0.4",
     "@types/lodash.merge": "^4.6.9",
     "@types/node": "^20.17.6",
     "@types/normalize-path": "^3.0.2",
@@ -81,11 +80,11 @@
     "extract-zip": "^2.0.1",
     "happy-dom": "^20.8.3",
     "lodash.merge": "^4.6.2",
-    "oxlint": "^1.51.0",
+    "oxlint": "^1.63.0",
     "publint": "^0.3.18",
     "tsdown": "^0.21.0",
-    "typescript": "^5.9.3",
-    "vitest": "^4.0.18",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.5",
     "vitest-plugin-random-seed": "^1.1.2"
   },
   "repository": {