wxt 0.20.20 → 0.20.22

package/dist/builtin-modules/favicon-permission.mjs

@@ -0,0 +1,28 @@
+import { defineWxtModule } from "../modules.mjs";
+//#region src/builtin-modules/favicon-permission.ts
+/**
+* Adds a template-literal type for the `_favicon/` paths served by Chrome's
+* favicon API when the `favicon` permission is declared. With this module,
+* `browser.runtime.getURL('/_favicon/?pageUrl=...')` type-checks without
+* needing a `@ts-expect-error`.
+*
+* Extensions that load favicons from a content script must still add their own
+* `web_accessible_resources` entry — this module intentionally does not touch
+* the manifest. See the review thread on #1570 for context.
+*
+* @see https://developer.chrome.com/docs/extensions/how-to/ui/favicons
+*/
+var favicon_permission_default = defineWxtModule({
+	name: "wxt:built-in:favicon-permission",
+	setup(wxt) {
+		wxt.hooks.hook("prepare:publicPaths", (_, paths) => {
+			if (!wxt.config.manifest.permissions?.includes("favicon")) return;
+			paths.push({
+				type: "templateLiteral",
+				path: "_favicon/?${string}"
+			});
+		});
+	}
+});
+//#endregion
+export { favicon_permission_default as default };

package/dist/builtin-modules/index.mjs

@@ -1,5 +1,6 @@
+import favicon_permission_default from "./favicon-permission.mjs";
 import unimport_default from "./unimport.mjs";
 //#region src/builtin-modules/index.ts
-const builtinModules = [unimport_default];
+const builtinModules = [unimport_default, favicon_permission_default];
 //#endregion
 export { builtinModules };

package/dist/cli/cli-utils.mjs

@@ -1,5 +1,5 @@
-import { formatDuration } from "../core/utils/time.mjs";
 import { filterTruthy, toArray } from "../core/utils/arrays.mjs";
+import { formatDuration } from "../core/utils/time.mjs";
 import { registerWxt } from "../core/wxt.mjs";
 import { printHeader } from "../core/utils/log/printHeader.mjs";
 import "../core/utils/log/index.mjs";

package/dist/core/builders/vite/index.mjs

@@ -1,6 +1,10 @@
 import { normalizePath } from "../../utils/paths.mjs";
 import "../../utils/index.mjs";
+import { toArray } from "../../utils/arrays.mjs";
 import { getEntrypointBundlePath, isHtmlEntrypoint } from "../../utils/entrypoints.mjs";
+import { createExtensionEnvironment } from "../../utils/environments/extension-environment.mjs";
+import "../../utils/environments/index.mjs";
+import { safeVarName } from "../../utils/strings.mjs";
 import { devHtmlPrerender } from "./plugins/devHtmlPrerender.mjs";
 import { devServerGlobals } from "./plugins/devServerGlobals.mjs";
 import { download } from "./plugins/download.mjs";
@@ -18,14 +22,10 @@ import { resolveAppConfig } from "./plugins/resolveAppConfig.mjs";
 import { iifeFooter } from "./plugins/iifeFooter.mjs";
 import { iifeAnonymous } from "./plugins/iifeAnonymous.mjs";
 import "./plugins/index.mjs";
-import { toArray } from "../../utils/arrays.mjs";
-import { safeVarName } from "../../utils/strings.mjs";
-import { createExtensionEnvironment } from "../../utils/environments/extension-environment.mjs";
-import "../../utils/environments/index.mjs";
 import { mkdir, readdir, rename, rmdir, stat } from "node:fs/promises";
 import { dirname, extname, join, relative } from "node:path";
-import { ViteNodeServer } from "vite-node/server";
 import { ViteNodeRunner } from "vite-node/client";
+import { ViteNodeServer } from "vite-node/server";
 import { installSourcemapsSupport } from "vite-node/source-map";
 //#region src/core/builders/vite/index.ts
 async function createViteBuilder(wxtConfig, hooks, getWxtDevServer) {
@@ -52,6 +52,10 @@ async function createViteBuilder(wxtConfig, hooks, getWxtDevServer) {
 		config.server.watch = { ignored: [`${wxtConfig.outBaseDir}/**`, `${wxtConfig.wxtDir}/**`] };
 		config.legacy ??= {};
 		config.legacy.skipWebSocketTokenCheck = true;
+		if (isRolldownVersion(vite.version)) {} else {
+			config.esbuild ??= {};
+			if (config.esbuild) config.esbuild.charset = "ascii";
+		}
 		const server = getWxtDevServer?.();
 		config.plugins ??= [];
 		config.plugins.push(download(wxtConfig), devHtmlPrerender(wxtConfig, server), resolveVirtualModules(wxtConfig), devServerGlobals(wxtConfig, server), tsconfigPaths(wxtConfig), noopBackground(), globals(wxtConfig), defineImportMeta(), wxtPluginLoader(wxtConfig), resolveAppConfig(wxtConfig));
@@ -263,7 +267,7 @@ function getRollupEntry(entrypoint) {
 	return entrypoint.inputPath;
 }
 /**
-* Ensures the HTML files output by a multipage build are in the correct
+* Ensures the HTML files output by a multi-page build are in the correct
 * location. This does two things:
 *
 * 1. Moves the HTML files to their final location at
@@ -310,5 +314,8 @@ async function removeEmptyDirs(dir) {
 		await rmdir(dir);
 	} catch {}
 }
+function isRolldownVersion(version) {
+	return Number(version.split(".")[0]) >= 8;
+}
 //#endregion
 export { createViteBuilder };

package/dist/core/builders/vite/plugins/download.mjs

@@ -11,6 +11,7 @@ import { fetchCached } from "../../../utils/network.mjs";
 function download(config) {
 	return {
 		name: "wxt:download",
+		enforce: "pre",
 		resolveId: {
 			filter: { id: /^url:/ },
 			handler(id) {

package/dist/core/clean.mjs

@@ -2,7 +2,7 @@ import { registerWxt, wxt } from "./wxt.mjs";
 import { rm } from "node:fs/promises";
 import { glob } from "tinyglobby";
 import path from "node:path";
-import pc from "picocolors";
+import { styleText } from "node:util";
 //#region src/core/clean.ts
 async function clean(config) {
 	if (typeof config === "string") config = { root: config };
@@ -15,7 +15,7 @@ async function clean(config) {
 		"**/.wxt",
 		`${path.relative(root, wxt.config.outBaseDir)}/*`
 	];
-	wxt.logger.debug("Looking for:", tempDirs.map(pc.cyan).join(", "));
+	wxt.logger.debug("Looking for:", tempDirs.map((dir) => styleText("cyan", dir)).join(", "));
 	const directories = await glob(tempDirs, {
 		cwd: root,
 		absolute: true,
@@ -27,13 +27,13 @@ async function clean(config) {
 		wxt.logger.debug("No generated files found.");
 		return;
 	}
-	wxt.logger.debug("Found:", directories.map((dir) => pc.cyan(path.relative(root, dir))).join(", "));
+	wxt.logger.debug("Found:", directories.map((dir) => styleText("cyan", path.relative(root, dir))).join(", "));
 	for (const directory of directories) {
 		await rm(directory, {
 			force: true,
 			recursive: true
 		});
-		wxt.logger.debug("Deleted " + pc.cyan(path.relative(root, directory)));
+		wxt.logger.debug("Deleted " + styleText("cyan", path.relative(root, directory)));
 	}
 }
 //#endregion

package/dist/core/create-server.mjs

@@ -12,7 +12,7 @@ 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 pc from "picocolors";
+import { styleText } from "node:util";
 import { debounce } from "perfect-debounce";
 import chokidar from "chokidar";
 import { Mutex } from "async-mutex";
@@ -172,7 +172,7 @@ function createFileReloader(server) {
 				server.restartBrowser();
 				return;
 			}
-			wxt.logger.info(`Changed: ${Array.from(new Set(fileChanges)).map((file) => pc.dim(relative(wxt.config.root, file))).join(", ")}`);
+			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);
@@ -231,9 +231,7 @@ function reloadHtmlPages(groups, server) {
 	return { reloadedNames: htmlEntries.map((entry) => entry.name) };
 }
 function getFilenameList(names) {
-	return names.map((name) => {
-		return pc.cyan(name);
-	}).join(pc.dim(", "));
+	return names.map((name) => styleText("cyan", name)).join(styleText("dim", ", "));
 }
 /**
 * Based on the current build output, return a list of files that are:

package/dist/core/generate-wxt-dir.mjs

@@ -39,7 +39,7 @@ async function getPathsDeclarationEntry(entrypoints) {
 	const unions = [
 		`    | ""`,
 		`    | "/"`,
-		...paths.map(normalizePath).sort().map((path) => `    | "/${path}"`)
+		...paths.map(normalizePublicPathEntry).sort((a, b) => a.path.localeCompare(b.path) || a.type.localeCompare(b.type)).map(renderPublicPathUnionMember)
 	].join("\n");
 	return {
 		path: "types/paths.d.ts",
@@ -59,6 +59,23 @@ declare module "wxt/browser" {
 		tsReference: true
 	};
 }
+function normalizePublicPathEntry(entry) {
+	if (typeof entry === "string") return {
+		type: "string",
+		path: normalizePath(entry)
+	};
+	return {
+		type: entry.type,
+		path: normalizePath(entry.path)
+	};
+}
+function renderPublicPathUnionMember(entry) {
+	const path = entry.path.startsWith("/") ? entry.path : `/${entry.path}`;
+	switch (entry.type) {
+		case "templateLiteral": return `    | \`${path}\``;
+		case "string": return `    | "${path}"`;
+	}
+}
 function getEntrypointPublicExt(entry) {
 	if (isHtmlEntrypoint(entry)) return ".html";
 	switch (entry.type) {

package/dist/core/initialize.mjs

@@ -2,7 +2,7 @@ import { pathExists } from "./utils/fs.mjs";
 import { readdir, rename } from "node:fs/promises";
 import path from "node:path";
 import { consola as consola$1 } from "consola";
-import pc from "picocolors";
+import { styleText } from "node:util";
 import prompts from "prompts";
 import { downloadTemplate } from "giget";
 //#region src/core/initialize.ts
@@ -22,7 +22,7 @@ async function initialize(options) {
 			type: () => defaultTemplate == null ? "select" : void 0,
 			message: "Choose a template",
 			choices: templates.map((template) => ({
-				title: TEMPLATE_COLORS[template.name]?.(template.name) ?? template.name,
+				title: TEMPLATE_COLORS[template.name] ? styleText(TEMPLATE_COLORS[template.name], template.name) : template.name,
 				value: template
 			}))
 		},
@@ -32,19 +32,19 @@ async function initialize(options) {
 			message: "Package Manager",
 			choices: [
 				{
-					title: pc.red("npm"),
+					title: styleText("red", "npm"),
 					value: "npm"
 				},
 				{
-					title: pc.yellow("pnpm"),
+					title: styleText("yellow", "pnpm"),
 					value: "pnpm"
 				},
 				{
-					title: pc.cyan("yarn"),
+					title: styleText("cyan", "yarn"),
 					value: "yarn"
 				},
 				{
-					title: pc.magenta("bun"),
+					title: styleText("magenta", "bun"),
 					value: "bun"
 				}
 			]
@@ -62,12 +62,12 @@ async function initialize(options) {
 	await cloneProject(input);
 	const cdPath = path.relative(process.cwd(), path.resolve(input.directory));
 	console.log();
-	consola$1.log(`✨ WXT project created with the ${TEMPLATE_COLORS[input.template.name]?.(input.template.name) ?? input.template.name} template.`);
+	consola$1.log(`✨ WXT project created with the ${TEMPLATE_COLORS[input.template.name] ? styleText(TEMPLATE_COLORS[input.template.name], input.template.name) : input.template.name} template.`);
 	console.log();
 	consola$1.log("Next steps:");
 	let step = 0;
-	if (cdPath !== "") consola$1.log(`  ${++step}.`, pc.cyan(`cd ${cdPath}`));
-	consola$1.log(`  ${++step}.`, pc.cyan(`${input.packageManager} install`));
+	if (cdPath !== "") consola$1.log(`  ${++step}.`, styleText("cyan", `cd ${cdPath}`));
+	consola$1.log(`  ${++step}.`, styleText("cyan", `${input.packageManager} install`));
 	console.log();
 }
 async function listTemplates() {
@@ -109,11 +109,11 @@ async function cloneProject({ directory, template }) {
 	}
 }
 const TEMPLATE_COLORS = {
-	vanilla: pc.blue,
-	vue: pc.green,
-	react: pc.cyan,
-	svelte: pc.red,
-	solid: pc.blue
+	vanilla: "blue",
+	vue: "green",
+	react: "cyan",
+	svelte: "red",
+	solid: "blue"
 };
 const TEMPLATE_SORT_WEIGHT = {
 	vanilla: 0,

package/dist/core/keyboard-shortcuts.mjs

@@ -1,5 +1,5 @@
 import { wxt } from "./wxt.mjs";
-import pc from "picocolors";
+import { styleText } from "node:util";
 import readline from "node:readline";
 //#region src/core/keyboard-shortcuts.ts
 /** Function that creates a keyboard shortcut handler for the extension. */
@@ -21,7 +21,7 @@ function createKeyboardShortcuts(server) {
 			rl?.removeListener("line", handleInput);
 		},
 		printHelp(flags) {
-			if (flags.canReopenBrowser) wxt.logger.info(`${pc.dim("Press")} ${pc.bold("o + enter")} ${pc.dim("to reopen the browser")}`);
+			if (flags.canReopenBrowser) wxt.logger.info(`${styleText("dim", "Press")} ${styleText("bold", "o + enter")} ${styleText("dim", "to reopen the browser")}`);
 		}
 	};
 }

package/dist/core/resolve-config.mjs

@@ -91,11 +91,16 @@ async function resolveConfig(inlineConfig, command) {
 		const host = mergedConfig.dev?.server?.host ?? mergedConfig.dev?.server?.hostname ?? "localhost";
 		let port = mergedConfig.dev?.server?.port;
 		const origin = mergedConfig.dev?.server?.origin ?? mergedConfig.dev?.server?.hostname ?? "localhost";
+		const strictPort = mergedConfig.dev?.server?.strictPort ?? false;
 		if (port == null || !isFinite(port)) port = await getPort({
 			host,
 			port: 3e3,
 			portRange: [3001, 3010]
 		});
+		else if (!strictPort) port = await getPort({
+			host,
+			port
+		});
 		const originWithProtocolAndPort = [
 			origin.match(/^https?:\/\//) ? "" : "http://",
 			origin,
@@ -105,6 +110,7 @@ async function resolveConfig(inlineConfig, command) {
 			host,
 			port,
 			origin: originWithProtocolAndPort,
+			strictPort,
 			watchDebounce: safeStringToNumber(process.env.WXT_WATCH_DEBOUNCE) ?? 800
 		};
 	}
@@ -142,6 +148,7 @@ async function resolveConfig(inlineConfig, command) {
 		userConfigMetadata: userConfigMetadata ?? {},
 		alias,
 		experimental: defu(mergedConfig.experimental, {}),
+		suppressWarnings: mergedConfig.suppressWarnings ?? {},
 		dev: {
 			server: devServerConfig,
 			reloadCommand

package/dist/core/utils/building/build-entrypoints.mjs

@@ -3,15 +3,15 @@ import { wxt } from "../../wxt.mjs";
 import { getPublicFiles } from "../fs.mjs";
 import { copyFile, mkdir, writeFile } from "node:fs/promises";
 import { dirname, resolve } from "path";
-import pc from "picocolors";
+import { styleText } from "node:util";
 //#region src/core/utils/building/build-entrypoints.ts
 async function buildEntrypoints(groups, spinner) {
 	const steps = [];
 	for (let i = 0; i < groups.length; i++) {
 		const group = groups[i];
 		const groupNames = toArray(group).map((e) => e.name);
-		const groupNameColored = groupNames.join(pc.dim(", "));
-		spinner.update({ text: pc.dim(`[${i + 1}/${groups.length}]`) + ` ${groupNameColored}` });
+		const groupNameColored = groupNames.join(styleText("dim", ", "));
+		spinner.update({ text: styleText("dim", `[${i + 1}/${groups.length}]`) + ` ${groupNameColored}` });
 		try {
 			steps.push(await wxt.builder.build(group));
 		} catch (err) {

package/dist/core/utils/building/find-entrypoints.mjs

@@ -5,10 +5,10 @@ import { wxt } from "../../wxt.mjs";
 import { mkdir, readFile, writeFile } from "node:fs/promises";
 import { glob } from "tinyglobby";
 import { relative, resolve } from "path";
+import { styleText } from "node:util";
 import { parseHTML } from "linkedom";
 import { camelCase } from "scule";
-import pc from "picocolors";
-import { minimatch } from "minimatch";
+import picomatch from "picomatch";
 import JSON5 from "json5";
 //#region src/core/utils/building/find-entrypoints.ts
 /**
@@ -31,7 +31,7 @@ async function findEntrypoints() {
 	const entrypointInfos = relativePaths.reduce((results, relativePath) => {
 		const inputPath = resolve(wxt.config.entrypointsDir, relativePath);
 		const name = getEntrypointName(wxt.config.entrypointsDir, inputPath);
-		const matchingGlob = pathGlobs.find((glob) => minimatch(relativePath, glob));
+		const matchingGlob = pathGlobs.find((glob) => picomatch(glob)(relativePath));
 		if (matchingGlob) {
 			const type = PATH_GLOB_TO_TYPE_MAP[matchingGlob];
 			results.push({
@@ -90,7 +90,7 @@ async function findEntrypoints() {
 	await wxt.hooks.callHook("entrypoints:resolved", wxt, entrypoints);
 	wxt.logger.debug("All entrypoints:", entrypoints);
 	const skippedEntrypointNames = entrypoints.filter((item) => item.skipped).map((item) => item.name);
-	if (skippedEntrypointNames.length) wxt.logger.warn(["The following entrypoints have been skipped:", ...skippedEntrypointNames.map((item) => `${pc.dim("-")} ${pc.cyan(item)}`)].join("\n"));
+	if (skippedEntrypointNames.length) wxt.logger.warn(["The following entrypoints have been skipped:", ...skippedEntrypointNames.map((item) => `${styleText("dim", "-")} ${styleText("cyan", item)}`)].join("\n"));
 	return entrypoints;
 }
 /** Returns a map of input paths to the file's options. */
@@ -157,16 +157,30 @@ async function getPopupEntrypoint(info, options) {
 	const strictOptions = resolvePerBrowserOptions({
 		...perBrowserOptions,
 		defaultTitle: title,
-		mv2Key: type
+		actionType: type
 	}, wxt.config.browser);
-	if (strictOptions.mv2Key && strictOptions.mv2Key !== "page_action") strictOptions.mv2Key = "browser_action";
+	if (strictOptions.actionType && strictOptions.actionType !== "page_action") strictOptions.actionType = "browser_action";
+	const opts = {
+		...strictOptions,
+		themeIcons
+	};
+	let _actionType = opts.actionType;
+	Object.defineProperty(opts, "actionType", {
+		get: () => _actionType,
+		set: (v) => _actionType = v,
+		enumerable: true,
+		configurable: true
+	});
+	Object.defineProperty(opts, "mv2Key", {
+		get: () => _actionType,
+		set: (v) => _actionType = v,
+		enumerable: true,
+		configurable: true
+	});
 	return {
 		type: "popup",
 		name: "popup",
-		options: {
-			...strictOptions,
-			themeIcons
-		},
+		options: opts,
 		inputPath: info.inputPath,
 		outputDir: wxt.config.outDir
 	};

package/dist/core/utils/building/internal-build.mjs

@@ -10,8 +10,8 @@ import { ValidationError, validateEntrypoints } from "../validation.mjs";
 import { mkdir, rm } from "node:fs/promises";
 import { glob } from "tinyglobby";
 import { relative } from "node:path";
+import { styleText } from "node:util";
 import { mergeJsonOutputs } from "@aklinker1/rollup-plugin-visualizer";
-import pc from "picocolors";
 import { isCI } from "ci-info";
 //#region src/core/utils/building/internal-build.ts
 /**
@@ -29,7 +29,7 @@ async function internalBuild() {
 	await wxt.hooks.callHook("build:before", wxt);
 	const verb = wxt.config.command === "serve" ? "Pre-rendering" : "Building";
 	const target = `${wxt.config.browser}-mv${wxt.config.manifestVersion}`;
-	wxt.logger.info(`${verb} ${pc.cyan(target)} for ${pc.cyan(wxt.config.mode)} with ${pc.green(`${wxt.builder.name} ${wxt.builder.version}`)}`);
+	wxt.logger.info(`${verb} ${styleText("cyan", target)} for ${styleText("cyan", wxt.config.mode)} with ${styleText("green", `${wxt.builder.name} ${wxt.builder.version}`)}`);
 	const startTime = Date.now();
 	await rm(wxt.config.outDir, {
 		recursive: true,
@@ -50,10 +50,10 @@ async function internalBuild() {
 	if (wxt.config.analysis.enabled) {
 		await combineAnalysisStats();
 		const statsPath = relative(wxt.config.root, wxt.config.analysis.outputFile);
-		wxt.logger.info(`Analysis complete:\n  ${pc.gray("└─")} ${pc.yellow(statsPath)}`);
-		if (wxt.config.analysis.open) if (isCI) wxt.logger.debug(`Skipped opening ${pc.yellow(statsPath)} in CI`);
+		wxt.logger.info(`Analysis complete:\n  ${styleText("gray", "└─")} ${styleText("yellow", statsPath)}`);
+		if (wxt.config.analysis.open) if (isCI) wxt.logger.debug(`Skipped opening ${styleText("yellow", statsPath)} in CI`);
 		else {
-			wxt.logger.info(`Opening ${pc.yellow(statsPath)} in browser...`);
+			wxt.logger.info(`Opening ${styleText("yellow", statsPath)} in browser...`);
 			const { default: open } = await import("open");
 			await open(wxt.config.analysis.outputFile);
 		}
@@ -85,8 +85,8 @@ function printValidationResults({ errorCount, errors, warningCount }) {
 	Array.from(entrypointErrors.entries()).forEach(([entrypoint, errors]) => {
 		wxt.logger.log(relative(cwd, entrypoint.inputPath) + "\n");
 		errors.forEach((err) => {
-			const type = err.type === "error" ? pc.red("ERROR") : pc.yellow("WARN");
-			const received = pc.dim(`(received: ${JSON.stringify(err.value)})`);
+			const type = err.type === "error" ? styleText("red", "ERROR") : styleText("yellow", "WARN");
+			const received = styleText("dim", `(received: ${JSON.stringify(err.value)})`);
 			wxt.logger.log(`  - ${type} ${err.message} ${received}`);
 		});
 		console.log();

package/dist/core/utils/env.mjs

@@ -1,21 +1,30 @@
-import { config } from "dotenv";
 import { expand } from "dotenv-expand";
+import { existsSync, readFileSync } from "node:fs";
+import { parseEnv } from "node:util";
 //#region src/core/utils/env.ts
 /** Load environment files based on the current mode and browser. */
 function loadEnv(mode, browser) {
-	return expand(config({
-		quiet: true,
-		path: [
-			`.env.${mode}.${browser}.local`,
-			`.env.${mode}.${browser}`,
-			`.env.${browser}.local`,
-			`.env.${browser}`,
-			`.env.${mode}.local`,
-			`.env.${mode}`,
-			`.env.local`,
-			`.env`
-		]
+	const envFiles = [
+		`.env`,
+		`.env.local`,
+		`.env.${mode}`,
+		`.env.${mode}.local`,
+		`.env.${browser}`,
+		`.env.${browser}.local`,
+		`.env.${mode}.${browser}`,
+		`.env.${mode}.${browser}.local`
+	];
+	const parsed = Object.fromEntries(envFiles.flatMap((filePath) => {
+		if (!existsSync(filePath)) return [];
+		try {
+			const parsedEnv = parseEnv(readFileSync(filePath, "utf-8"));
+			return Object.entries(parsedEnv);
+		} catch {
+			return [];
+		}
 	}));
+	expand({ parsed });
+	return parsed;
 }
 //#endregion
 export { loadEnv };

package/dist/core/utils/i18n.mjs

@@ -2,7 +2,7 @@
 const predefinedMessages = {
 	"@@extension_id": {
 		message: "<browser.runtime.id>",
-		description: "The extension or app ID; you might use this string to construct URLs for resources inside the extension. Even unlocalized extensions can use this message.\nNote: You can't use this message in a manifest file."
+		description: "The extension or app ID; you might use this string to construct URLs for resources inside the extension. Even non-localized extensions can use this message.\nNote: You can't use this message in a manifest file."
 	},
 	"@@ui_locale": {
 		message: "<browser.i18n.getUiLocale()>",

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

@@ -1,7 +1,7 @@
 import { printTable } from "./printTable.mjs";
 import { lstat } from "node:fs/promises";
 import path from "node:path";
-import pc from "picocolors";
+import { styleText } from "node:util";
 import { filesize } from "filesize";
 //#region src/core/utils/log/printFileList.ts
 async function printFileList(log, header, baseDir, files) {
@@ -9,26 +9,26 @@ async function printFileList(log, header, baseDir, files) {
 	const fileRows = await Promise.all(files.map(async (file, i) => {
 		const parts = [path.relative(process.cwd(), baseDir) + path.sep, path.relative(baseDir, file)];
 		const prefix = i === files.length - 1 ? "  └─" : "  ├─";
-		const color = getChunkColor(file);
+		const chunkColor = getChunkColor(file);
 		const stats = await lstat(file);
 		totalSize += stats.size;
 		const size = String(filesize(stats.size));
-		return [`${pc.gray(prefix)} ${pc.dim(parts[0])}${color(parts[1])}`, pc.dim(size)];
+		return [`${styleText("gray", prefix)} ${styleText("dim", parts[0])}${styleText(chunkColor, parts[1])}`, styleText("dim", size)];
 	}));
-	fileRows.push([`${pc.cyan("Σ Total size:")} ${String(filesize(totalSize))}`]);
+	fileRows.push([`${styleText("cyan", "Σ Total size:")} ${String(filesize(totalSize))}`]);
 	printTable(log, header, fileRows);
 }
-const DEFAULT_COLOR = pc.blue;
+const DEFAULT_COLOR = "blue";
 const CHUNK_COLORS = {
-	".js.map": pc.gray,
-	".cjs.map": pc.gray,
-	".mjs.map": pc.gray,
-	".html": pc.green,
-	".css": pc.magenta,
-	".js": pc.cyan,
-	".cjs": pc.cyan,
-	".mjs": pc.cyan,
-	".zip": pc.yellow
+	".js.map": "gray",
+	".cjs.map": "gray",
+	".mjs.map": "gray",
+	".html": "green",
+	".css": "magenta",
+	".js": "cyan",
+	".cjs": "cyan",
+	".mjs": "cyan",
+	".zip": "yellow"
 };
 function getChunkColor(filename) {
 	return Object.entries(CHUNK_COLORS).find(([key]) => filename.endsWith(key))?.[1] ?? DEFAULT_COLOR;

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

@@ -1,9 +1,9 @@
 import { version } from "../../../version.mjs";
 import { consola as consola$1 } from "consola";
-import pc from "picocolors";
+import { styleText } from "node:util";
 //#region src/core/utils/log/printHeader.ts
 function printHeader() {
-	consola$1.log(`\n${pc.gray("WXT")} ${pc.gray(pc.bold(version))}`);
+	consola$1.log(`\n${styleText("gray", "WXT")} ${styleText(["bold", "grey"], version)}`);
 }
 //#endregion
 export { printHeader };

package/dist/core/utils/manifest.mjs

@@ -5,6 +5,7 @@ import { writeFileIfDifferent } from "./fs.mjs";
 import { ContentSecurityPolicy } from "./content-security-policy.mjs";
 import { hashContentScriptOptions, mapWxtOptionsToContentScript } from "./content-scripts.mjs";
 import { getPackageJson } from "./package.mjs";
+import { addDiscoveredThemeIcons } from "./theme-icons.mjs";
 import { mkdir } from "node:fs/promises";
 import { resolve } from "path";
 import defu from "defu";
@@ -54,7 +55,9 @@ 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");
 	addEntrypoints(manifest, entrypoints, buildOutput);
+	if (wxt.config.browser === "firefox") addDiscoveredThemeIcons(manifest, buildOutput);
 	if (wxt.config.command === "serve") addDevModeCsp(manifest);
 	if (wxt.config.command === "serve") addDevModePermissions(manifest);
 	await wxt.hooks.callHook("build:manifestGenerated", wxt, manifest);
@@ -136,25 +139,18 @@ function addEntrypoints(manifest, entrypoints, buildOutput) {
 		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;
-		if (manifest.manifest_version === 3) manifest.action = {
-			...manifest.action,
+		const actionKey = manifest.manifest_version === 2 ? popup.options.actionType ?? "browser_action" : wxt.config.browser === "firefox" ? popup.options.actionType ?? "action" : "action";
+		manifest[actionKey] = {
+			...manifest[actionKey],
 			...options,
 			default_popup
 		};
-		else {
-			const key = popup.options.mv2Key ?? "browser_action";
-			manifest[key] = {
-				...manifest[key],
-				...options,
-				default_popup
-			};
-		}
 	}
 	if (devtools) manifest.devtools_page = getEntrypointBundlePath(devtools, wxt.config.outDir, ".html");
 	if (options) {
 		const page = getEntrypointBundlePath(options, wxt.config.outDir, ".html");
 		manifest.options_ui = {
-			open_in_tab: options.options.openInTab,
+			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
@@ -363,13 +359,15 @@ function stripKeys(manifest) {
 	if (wxt.config.manifestVersion === 2) {
 		keysToRemove.push(...mv3OnlyKeys);
 		if (wxt.config.browser === "firefox") keysToRemove.push(...firefoxMv3OnlyKeys);
-	} else keysToRemove.push(...mv2OnlyKeys);
+	} else {
+		keysToRemove.push(...mv2OnlyKeys);
+		if (wxt.config.browser !== "firefox") keysToRemove.push(...chromeMv2OnlyKeys);
+	}
 	keysToRemove.forEach((key) => {
 		delete manifest[key];
 	});
 }
 const mv2OnlyKeys = [
-	"page_action",
 	"browser_action",
 	"automation",
 	"content_capabilities",
@@ -393,6 +391,7 @@ const mv3OnlyKeys = [
 	"optional_host_permissions",
 	"side_panel"
 ];
+const chromeMv2OnlyKeys = ["page_action"];
 const firefoxMv3OnlyKeys = ["host_permissions"];
 const DEFAULT_MV3_EXTENSION_PAGES_CSP = "script-src 'self' 'wasm-unsafe-eval'; object-src 'self';";
 const DEFAULT_MV3_SANDBOX_CSP = "sandbox allow-scripts allow-forms allow-popups allow-modals; script-src 'self' 'unsafe-inline' 'unsafe-eval'; child-src 'self';";

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

@@ -0,0 +1,26 @@
+import picomatch from "picomatch";
+//#region src/core/utils/picomatch-multiple.ts
+/**
+* Run [`picomatch`](https://npmjs.com/package/picomatch) against multiple
+* patterns.
+*
+* Supports negated patterns, the order does not matter. If your `search` string
+* 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;
+	const negatePatterns = [];
+	const positivePatterns = [];
+	for (const pattern of patterns) if (pattern[0] === "!") negatePatterns.push(pattern.slice(1));
+	else positivePatterns.push(pattern);
+	if (negatePatterns.some((negatePattern) => picomatch(negatePattern, options)(search))) return false;
+	return positivePatterns.some((positivePattern) => picomatch(positivePattern, options)(search));
+}
+//#endregion
+export { picomatchMultiple };

package/dist/core/utils/syntax-errors.mjs

@@ -1,6 +1,6 @@
 import { wxt } from "../wxt.mjs";
 import { relative } from "node:path";
-import pc from "picocolors";
+import { styleText } from "node:util";
 //#region src/core/utils/syntax-errors.ts
 function isBabelSyntaxError(error) {
 	return error instanceof SyntaxError && error.code === "BABEL_PARSER_SYNTAX_ERROR";
@@ -9,7 +9,7 @@ function logBabelSyntaxError(error) {
 	let filename = relative(wxt.config.root, error.id);
 	if (filename.startsWith("..")) filename = error.id;
 	let message = error.message.replace(/\(\d+:\d+\)$/, `(${filename}:${error.loc.line}:${error.loc.column + 1})`);
-	if (error.frame) message += "\n\n" + pc.red(error.frame);
+	if (error.frame) message += "\n\n" + styleText("red", error.frame);
 	wxt.logger.error(message);
 }
 //#endregion

package/dist/core/utils/theme-icons.mjs

@@ -0,0 +1,71 @@
+import { normalizePath } from "./paths.mjs";
+import { wxt } from "../wxt.mjs";
+//#region src/core/utils/theme-icons.ts
+/**
+* Firefox only.
+*
+* If the manifest has an `action` (MV3) or `browser_action` (MV2) and the user
+* has not already set `theme_icons` on it, discover light/dark icon pairs from
+* the public assets and attach them.
+*/
+function addDiscoveredThemeIcons(manifest, buildOutput) {
+	const action = manifest.action ?? manifest.browser_action;
+	if (action == null) return;
+	if (action.theme_icons != null) return;
+	const themeIcons = discoverThemeIcons(buildOutput);
+	if (themeIcons == null) return;
+	action.theme_icons = themeIcons;
+}
+/**
+* Scan `publicAssets` for paired `-light`/`-dark` icon files and return the
+* sizes where both variants exist, sorted ascending. Returns `undefined` if no
+* complete pairs are found so callers can short-circuit.
+*/
+function discoverThemeIcons(buildOutput) {
+	const bySize = /* @__PURE__ */ new Map();
+	for (const asset of buildOutput.publicAssets) for (const regex of themeIconRegex) {
+		const match = asset.fileName.match(regex);
+		if (match?.groups == null) continue;
+		const size = Number(match.groups.size);
+		const variant = match.groups.variant;
+		const entry = bySize.get(size) ?? {};
+		const incoming = normalizePath(asset.fileName);
+		const existing = entry[variant];
+		if (existing != null && existing !== incoming) {
+			wxt.logger.warn(`Multiple theme icon files matched size ${size} variant "${variant}": keeping "${existing}", ignoring "${incoming}". Use a single naming pattern per (size, variant).`);
+			break;
+		}
+		entry[variant] = incoming;
+		bySize.set(size, entry);
+		break;
+	}
+	const pairs = [];
+	for (const [size, entry] of bySize) {
+		if (entry.light != null && entry.dark != null) {
+			pairs.push({
+				light: entry.light,
+				dark: entry.dark,
+				size
+			});
+			continue;
+		}
+		const present = entry.light != null ? "light" : "dark";
+		const missing = entry.light != null ? "dark" : "light";
+		const file = entry.light ?? entry.dark;
+		wxt.logger.warn(`Skipping theme icon size ${size}: found ${present} variant ("${file}") but no matching ${missing} variant. Add the missing file to include this size in theme_icons.`);
+	}
+	pairs.sort((a, b) => a.size - b.size);
+	return pairs.length > 0 ? pairs : void 0;
+}
+const themeIconRegex = [
+	/^icon-(?<variant>light|dark)-(?<size>[0-9]+)\.png$/,
+	/^icon-(?<variant>light|dark)-(?<size>[0-9]+)x[0-9]+\.png$/,
+	/^icon-(?<size>[0-9]+)-(?<variant>light|dark)\.png$/,
+	/^icon-(?<size>[0-9]+)x[0-9]+-(?<variant>light|dark)\.png$/,
+	/^icons?[/\\](?<variant>light|dark)-(?<size>[0-9]+)\.png$/,
+	/^icons?[/\\](?<variant>light|dark)-(?<size>[0-9]+)x[0-9]+\.png$/,
+	/^icons?[/\\](?<size>[0-9]+)-(?<variant>light|dark)\.png$/,
+	/^icons?[/\\](?<size>[0-9]+)x[0-9]+-(?<variant>light|dark)\.png$/
+];
+//#endregion
+export { addDiscoveredThemeIcons };

package/dist/core/utils/transform.mjs

@@ -137,7 +137,7 @@ function removeSideEffectImports(mod) {
 }
 /**
 * Util to get the AST as a simple JSON object, stripping out large objects and
-* file locations to keep it readible
+* file locations to keep it readable.
 */
 function getSimpleAstJson(ast) {
 	if (!ast) return ast;

package/dist/core/zip.mjs

@@ -1,7 +1,7 @@
 import { normalizePath } from "./utils/paths.mjs";
 import "./utils/index.mjs";
-import { formatDuration } from "./utils/time.mjs";
 import { safeFilename } from "./utils/strings.mjs";
+import { formatDuration } from "./utils/time.mjs";
 import { registerWxt, wxt } from "./wxt.mjs";
 import { findEntrypoints } from "./utils/building/find-entrypoints.mjs";
 import { printFileList } from "./utils/log/printFileList.mjs";
@@ -9,7 +9,7 @@ import "./utils/log/index.mjs";
 import { getPackageJson } from "./utils/package.mjs";
 import { internalBuild } from "./utils/building/internal-build.mjs";
 import "./utils/building/index.mjs";
-import { minimatchMultiple } from "./utils/minimatch-multiple.mjs";
+import { picomatchMultiple } from "./utils/picomatch-multiple.mjs";
 import { mkdir, readFile } from "node:fs/promises";
 import { glob } from "tinyglobby";
 import path from "node:path";
@@ -69,7 +69,7 @@ async function zipDir(directory, outputPath, options) {
 		onlyFiles: true,
 		expandDirectories: false
 	})).filter((relativePath) => {
-		return minimatchMultiple(relativePath, options?.include) || !minimatchMultiple(relativePath, options?.exclude);
+		return picomatchMultiple(relativePath, options?.include) || !picomatchMultiple(relativePath, options?.exclude);
 	}), ...(options?.additionalFiles ?? []).map((file) => path.relative(directory, file))];
 	for (const file of filesToZip) {
 		const absolutePath = path.resolve(directory, file);

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { BackgroundDefinition, BackgroundEntrypoint, BackgroundEntrypointOptions, BaseContentScriptEntrypointOptions, BaseEntrypoint, BaseEntrypointOptions, BaseScriptEntrypointOptions, BuildOutput, BuildStepOutput, ConfigEnv, ContentScriptDefinition, ContentScriptEntrypoint, CopiedPublicFile, Dependency, Entrypoint, EntrypointGroup, EntrypointInfo, EslintGlobalsPropValue, Eslintrc, ExtensionRunner, ExtensionRunnerConfig, FsCache, GeneratedPublicFile, GenericEntrypoint, HookResult, InlineConfig, IsolatedWorldContentScriptDefinition, IsolatedWorldContentScriptEntrypointOptions, Logger, MainWorldContentScriptDefinition, MainWorldContentScriptEntrypointOptions, OnContentScriptStopped, OptionsEntrypoint, OptionsEntrypointOptions, OutputAsset, OutputChunk, OutputFile, PerBrowserMap, PerBrowserOption, PopupEntrypoint, PopupEntrypointOptions, ReloadContentScriptPayload, ResolvedBasePublicFile, ResolvedConfig, ResolvedEslintrc, ResolvedPerBrowserOptions, ResolvedPublicFile, ServerInfo, SidepanelEntrypoint, SidepanelEntrypointOptions, TargetBrowser, TargetManifestVersion, ThemeIcon, UnlistedScriptDefinition, UnlistedScriptEntrypoint, UserConfig, UserManifest, UserManifestFn, WebExtConfig, Wxt, WxtBuilder, WxtBuilderServer, WxtCommand, WxtDevServer, WxtDirEntry, WxtDirFileEntry, WxtDirTypeReferenceEntry, WxtHooks, WxtModule, WxtModuleOptions, WxtModuleSetup, WxtModuleWithMetadata, WxtPackageManager, WxtPlugin, WxtResolvedUnimportOptions, WxtUnimportOptions, WxtViteConfig } from "./types.mjs";
+import { BackgroundDefinition, BackgroundEntrypoint, BackgroundEntrypointOptions, BaseContentScriptEntrypointOptions, BaseEntrypoint, BaseEntrypointOptions, BaseScriptEntrypointOptions, BuildOutput, BuildStepOutput, ConfigEnv, ContentScriptDefinition, ContentScriptEntrypoint, CopiedPublicFile, Dependency, Entrypoint, EntrypointGroup, EntrypointInfo, EslintGlobalsPropValue, Eslintrc, ExtensionRunner, ExtensionRunnerConfig, FirefoxDataCollectionPermissions, FirefoxDataCollectionType, FsCache, GeneratedPublicFile, GenericEntrypoint, HookResult, InlineConfig, IsolatedWorldContentScriptDefinition, IsolatedWorldContentScriptEntrypointOptions, Logger, MainWorldContentScriptDefinition, MainWorldContentScriptEntrypointOptions, OnContentScriptStopped, OptionsEntrypoint, OptionsEntrypointOptions, OutputAsset, OutputChunk, OutputFile, PerBrowserMap, PerBrowserOption, PopupEntrypoint, PopupEntrypointOptions, PublicPathEntry, ReloadContentScriptPayload, ResolvedBasePublicFile, ResolvedConfig, ResolvedEslintrc, ResolvedPerBrowserOptions, ResolvedPublicFile, ServerInfo, SidepanelEntrypoint, SidepanelEntrypointOptions, TargetBrowser, TargetManifestVersion, ThemeIcon, UnlistedScriptDefinition, UnlistedScriptEntrypoint, UserConfig, UserManifest, UserManifestFn, WebExtConfig, Wxt, WxtBuilder, WxtBuilderServer, WxtCommand, WxtDevServer, WxtDirEntry, WxtDirFileEntry, WxtDirTypeReferenceEntry, WxtHooks, WxtModule, WxtModuleOptions, WxtModuleSetup, WxtModuleWithMetadata, WxtPackageManager, WxtPlugin, WxtResolvedUnimportOptions, WxtUnimportOptions, WxtViteConfig } from "./types.mjs";
 import { build } from "./core/build.mjs";
 import { clean } from "./core/clean.mjs";
 import { defineConfig } from "./core/define-config.mjs";
@@ -9,4 +9,4 @@ import { prepare } from "./core/prepare.mjs";
 import { zip } from "./core/zip.mjs";
 import { normalizePath } from "./core/utils/paths.mjs";
 import { version } from "./version.mjs";
-export { BackgroundDefinition, BackgroundEntrypoint, BackgroundEntrypointOptions, BaseContentScriptEntrypointOptions, BaseEntrypoint, BaseEntrypointOptions, BaseScriptEntrypointOptions, BuildOutput, BuildStepOutput, ConfigEnv, ContentScriptDefinition, ContentScriptEntrypoint, CopiedPublicFile, Dependency, Entrypoint, EntrypointGroup, EntrypointInfo, EslintGlobalsPropValue, Eslintrc, ExtensionRunner, ExtensionRunnerConfig, FsCache, GeneratedPublicFile, GenericEntrypoint, HookResult, InlineConfig, IsolatedWorldContentScriptDefinition, IsolatedWorldContentScriptEntrypointOptions, Logger, MainWorldContentScriptDefinition, MainWorldContentScriptEntrypointOptions, OnContentScriptStopped, OptionsEntrypoint, OptionsEntrypointOptions, OutputAsset, OutputChunk, OutputFile, PerBrowserMap, PerBrowserOption, PopupEntrypoint, PopupEntrypointOptions, ReloadContentScriptPayload, ResolvedBasePublicFile, ResolvedConfig, ResolvedEslintrc, ResolvedPerBrowserOptions, ResolvedPublicFile, ServerInfo, SidepanelEntrypoint, SidepanelEntrypointOptions, TargetBrowser, TargetManifestVersion, ThemeIcon, UnlistedScriptDefinition, UnlistedScriptEntrypoint, UserConfig, UserManifest, UserManifestFn, WebExtConfig, Wxt, WxtBuilder, WxtBuilderServer, WxtCommand, WxtDevServer, WxtDirEntry, WxtDirFileEntry, WxtDirTypeReferenceEntry, WxtHooks, WxtModule, WxtModuleOptions, WxtModuleSetup, WxtModuleWithMetadata, WxtPackageManager, WxtPlugin, WxtResolvedUnimportOptions, WxtUnimportOptions, WxtViteConfig, build, clean, createServer, defineConfig, defineRunnerConfig, defineWebExtConfig, initialize, normalizePath, prepare, version, zip };
+export { BackgroundDefinition, BackgroundEntrypoint, BackgroundEntrypointOptions, BaseContentScriptEntrypointOptions, BaseEntrypoint, BaseEntrypointOptions, BaseScriptEntrypointOptions, BuildOutput, BuildStepOutput, ConfigEnv, ContentScriptDefinition, ContentScriptEntrypoint, CopiedPublicFile, Dependency, Entrypoint, EntrypointGroup, EntrypointInfo, EslintGlobalsPropValue, Eslintrc, ExtensionRunner, ExtensionRunnerConfig, FirefoxDataCollectionPermissions, FirefoxDataCollectionType, FsCache, GeneratedPublicFile, GenericEntrypoint, HookResult, InlineConfig, IsolatedWorldContentScriptDefinition, IsolatedWorldContentScriptEntrypointOptions, Logger, MainWorldContentScriptDefinition, MainWorldContentScriptEntrypointOptions, OnContentScriptStopped, OptionsEntrypoint, OptionsEntrypointOptions, OutputAsset, OutputChunk, OutputFile, PerBrowserMap, PerBrowserOption, PopupEntrypoint, PopupEntrypointOptions, PublicPathEntry, ReloadContentScriptPayload, ResolvedBasePublicFile, ResolvedConfig, ResolvedEslintrc, ResolvedPerBrowserOptions, ResolvedPublicFile, ServerInfo, SidepanelEntrypoint, SidepanelEntrypointOptions, TargetBrowser, TargetManifestVersion, ThemeIcon, UnlistedScriptDefinition, UnlistedScriptEntrypoint, UserConfig, UserManifest, UserManifestFn, WebExtConfig, Wxt, WxtBuilder, WxtBuilderServer, WxtCommand, WxtDevServer, WxtDirEntry, WxtDirFileEntry, WxtDirTypeReferenceEntry, WxtHooks, WxtModule, WxtModuleOptions, WxtModuleSetup, WxtModuleWithMetadata, WxtPackageManager, WxtPlugin, WxtResolvedUnimportOptions, WxtUnimportOptions, WxtViteConfig, build, clean, createServer, defineConfig, defineRunnerConfig, defineWebExtConfig, initialize, normalizePath, prepare, version, zip };

package/dist/types.d.mts

@@ -164,6 +164,25 @@ interface InlineConfig {
    * function that returns an object or promise.
    */
   manifest?: UserManifest | Promise<UserManifest> | UserManifestFn;
+  /**
+   * Suppress specific warnings during the build process.
+   *
+   * @example
+   *   ```ts
+   *   export default defineConfig({
+   *     suppressWarnings: {
+   *       firefoxDataCollection: true,
+   *     },
+   *   })
+   *   ```;
+   */
+  suppressWarnings?: {
+    /**
+     * Suppress warnings for:
+     * https://extensionworkshop.com/documentation/develop/firefox-builtin-data-consent
+     */
+    firefoxDataCollection?: boolean;
+  };
   /**
    * Configure browser startup. Options set here can be overridden in a
    * `web-ext.config.ts` file.
@@ -233,7 +252,7 @@ interface InlineConfig {
      */
     sourcesRoot?: string;
     /**
-     * [Minimatch](https://www.npmjs.com/package/minimatch) patterns of files to
+     * [Picomatch](https://www.npmjs.com/package/picomatch) patterns of files to
      * include when creating a ZIP of all your source code for Firefox. Patterns
      * are relative to your `config.zip.sourcesRoot`.
      *
@@ -247,7 +266,7 @@ interface InlineConfig {
      */
     includeSources?: string[];
     /**
-     * [Minimatch](https://www.npmjs.com/package/minimatch) patterns of files to
+     * [Picomatch](https://www.npmjs.com/package/picomatch) patterns of files to
      * exclude when creating a ZIP of all your source code for Firefox. Patterns
      * are relative to your `config.zip.sourcesRoot`.
      *
@@ -260,7 +279,7 @@ interface InlineConfig {
      */
     excludeSources?: string[];
     /**
-     * [Minimatch](https://www.npmjs.com/package/minimatch) patterns of files to
+     * [Picomatch](https://www.npmjs.com/package/picomatch) patterns of files to
      * exclude when zipping the extension.
      *
      * @example
@@ -389,6 +408,14 @@ interface InlineConfig {
        * @default 'http://localhost:3000'
        */
       origin?: string;
+      /**
+       * Whether the dev server should fail if the specified port is already in
+       * use. When `false` and a `port` is specified, the next available port
+       * will be used instead of throwing an error.
+       *
+       * @default false
+       */
+      strictPort?: boolean;
       /**
        * Hostname to run the dev server on.
        *
@@ -430,8 +457,8 @@ interface InlineConfig {
    * set in WXT's config instead of Vite's.
    *
    * This is a function because any vite plugins added need to be recreated for
-   * each individual build step, incase they have internal state causing them to
-   * fail when reused.
+   * each individual build step, in case they have internal state causing them
+   * to fail when reused.
    */
   vite?: (env: ConfigEnv) => WxtViteConfig | Promise<WxtViteConfig>;
 }
@@ -703,7 +730,15 @@ interface ThemeIcon {
   size: number;
 }
 interface PopupEntrypointOptions extends BaseEntrypointOptions {
-  /** Defaults to "browser_action" to be equivalent to MV3's "action" key */
+  /**
+   * The type of action to use in the manifest.
+   *
+   * In MV2, defaults to `"browser_action"`. In MV3, `"browser_action"` is
+   * converted to `"action"`, while `"page_action"` is kept as-is (Firefox MV3
+   * only).
+   */
+  actionType?: PerBrowserOption<'browser_action' | 'page_action'>;
+  /** @deprecated Use `actionType` instead. */
   mv2Key?: PerBrowserOption<'browser_action' | 'page_action'>;
   defaultIcon?: Record<string, string>;
   defaultTitle?: PerBrowserOption<string>;
@@ -872,16 +907,42 @@ type PerBrowserMap<T> = {
  * `PerBrowserOption`, like `defaultIcon`.
  */
 type ResolvedPerBrowserOptions<T, TOmitted extends keyof T = never> = { [key in keyof Omit<T, TOmitted>]: T[key] extends PerBrowserOption<infer U> ? U : T[key] } & { [key in TOmitted]: T[key] };
+/**
+ * Firefox data collection permission types for personal data. See:
+ * https://extensionworkshop.com/documentation/develop/firefox-builtin-data-consent/#specifying-data-types
+ */
+type FirefoxDataCollectionType = 'locationInfo' | 'browsingActivity' | 'websiteContent' | 'websiteActivity' | 'searchTerms' | 'bookmarksInfo' | 'healthInfo' | 'contactInfo' | 'socialInfo' | (string & {});
+/**
+ * Firefox data collection permissions configuration. See:
+ * https://extensionworkshop.com/documentation/develop/firefox-builtin-data-consent/#specifying-data-types
+ */
+interface FirefoxDataCollectionPermissions {
+  /**
+   * Required data collection permissions. Users must opt in to use the
+   * extension. Can include personal data types or "none" to explicitly indicate
+   * no data collection.
+   */
+  required?: Array<FirefoxDataCollectionType | 'none'>;
+  /**
+   * Optional data collection permissions. Users can opt in after installation.
+   * Can include personal data types or "technicalAndInteraction" (which can
+   * only be optional).
+   */
+  optional?: Array<FirefoxDataCollectionType | 'technicalAndInteraction'>;
+}
 /**
  * Manifest customization available in the `wxt.config.ts` file. You cannot
  * configure entrypoints here, they are configured inline.
  */
 type UserManifest = { [key in keyof Browser.runtime.ManifestV3 as key extends 'action' | 'background' | 'chrome_url_overrides' | 'devtools_page' | 'manifest_version' | 'options_page' | 'options_ui' | 'permissions' | 'sandbox' | 'web_accessible_resources' ? never : key]?: Browser.runtime.ManifestV3[key] } & {
   action?: Browser.runtime.ManifestV3['action'] & {
-    browser_style?: boolean;
+    default_area?: 'navbar' | 'menupanel' | 'tabstrip' | 'personaltoolbar';
+    theme_icons?: ThemeIcon[];
   };
   browser_action?: Browser.runtime.ManifestV2['browser_action'] & {
     browser_style?: boolean;
+    default_area?: 'navbar' | 'menupanel' | 'tabstrip' | 'personaltoolbar';
+    theme_icons?: ThemeIcon[];
   };
   page_action?: Browser.runtime.ManifestV2['page_action'] & {
     browser_style?: boolean;
@@ -892,6 +953,11 @@ type UserManifest = { [key in keyof Browser.runtime.ManifestV3 as key extends 'a
       strict_min_version?: string;
       strict_max_version?: string;
       update_url?: string;
+      /**
+       * Firefox data collection permissions configuration. See:
+       * https://extensionworkshop.com/documentation/develop/firefox-builtin-data-consent/#specifying-data-types
+       */
+      data_collection_permissions?: FirefoxDataCollectionPermissions;
     };
     gecko_android?: {
       strict_min_version?: string;
@@ -1080,14 +1146,18 @@ interface WxtHooks {
    *
    * @example
    *   wxt.hooks.hook('prepare:publicPaths', (wxt, paths) => {
-   *     paths.push('/icons/128.png');
+   *     paths.push('icons/128.png');
+   *     paths.push({
+   *       type: 'templateLiteral',
+   *       path: '_favicon/?${string}',
+   *     });
    *   });
    *
    * @param wxt The configured WXT object
    * @param paths This list of paths TypeScript allows `browser.runtime.getURL`
    *   to be called with.
    */
-  'prepare:publicPaths': (wxt: Wxt, paths: string[]) => HookResult;
+  'prepare:publicPaths': (wxt: Wxt, paths: PublicPathEntry[]) => HookResult;
   /**
    * Called before the build is started in both dev mode and build mode.
    *
@@ -1296,11 +1366,16 @@ interface ResolvedConfig$1 {
   /** Import aliases to absolute paths. */
   alias: Record<string, string>;
   experimental: {};
+  /** List of warning identifiers to suppress during the build process. */
+  suppressWarnings: {
+    firefoxDataCollection?: boolean;
+  };
   dev: {
     /** Only defined during dev command */server?: {
       host: string;
       port: number;
       origin: string;
+      strictPort: boolean;
       /**
        * The milliseconds to debounce when a file is saved before reloading. The
        * only way to set this option is to set the `WXT_WATCH_DEBOUNCE`
@@ -1490,6 +1565,10 @@ interface GeneratedPublicFile extends ResolvedBasePublicFile {
   /** Text to write to the file. */
   contents: string;
 }
+type PublicPathEntry = string | {
+  type: 'string' | 'templateLiteral';
+  path: string;
+};
 type WxtPlugin = () => void;
 type WxtDirEntry = WxtDirTypeReferenceEntry | WxtDirFileEntry;
 /**
@@ -1517,4 +1596,4 @@ interface WxtDirFileEntry {
   tsReference?: boolean;
 }
 //#endregion
-export { BackgroundDefinition, BackgroundEntrypoint, BackgroundEntrypointOptions, BaseContentScriptEntrypointOptions, BaseEntrypoint, BaseEntrypointOptions, BaseScriptEntrypointOptions, BuildOutput, BuildStepOutput, ConfigEnv, ContentScriptDefinition, ContentScriptEntrypoint, CopiedPublicFile, Dependency, Entrypoint, EntrypointGroup, EntrypointInfo, EslintGlobalsPropValue, Eslintrc, ExtensionRunner, ExtensionRunnerConfig, FsCache, GeneratedPublicFile, GenericEntrypoint, HookResult, InlineConfig, IsolatedWorldContentScriptDefinition, IsolatedWorldContentScriptEntrypointOptions, Logger, MainWorldContentScriptDefinition, MainWorldContentScriptEntrypointOptions, OnContentScriptStopped, OptionsEntrypoint, OptionsEntrypointOptions, OutputAsset, OutputChunk, OutputFile, PerBrowserMap, PerBrowserOption, PopupEntrypoint, PopupEntrypointOptions, ReloadContentScriptPayload, ResolvedBasePublicFile, ResolvedConfig$1 as ResolvedConfig, ResolvedEslintrc, ResolvedPerBrowserOptions, ResolvedPublicFile, ServerInfo, SidepanelEntrypoint, SidepanelEntrypointOptions, TargetBrowser, TargetManifestVersion, ThemeIcon, UnlistedScriptDefinition, UnlistedScriptEntrypoint, UserConfig, UserManifest, UserManifestFn, WebExtConfig, Wxt, WxtBuilder, WxtBuilderServer, WxtCommand, WxtDevServer, WxtDirEntry, WxtDirFileEntry, WxtDirTypeReferenceEntry, WxtHooks, WxtModule, WxtModuleOptions, WxtModuleSetup, WxtModuleWithMetadata, WxtPackageManager, WxtPlugin, WxtResolvedUnimportOptions, WxtUnimportOptions, WxtViteConfig };
+export { BackgroundDefinition, BackgroundEntrypoint, BackgroundEntrypointOptions, BaseContentScriptEntrypointOptions, BaseEntrypoint, BaseEntrypointOptions, BaseScriptEntrypointOptions, BuildOutput, BuildStepOutput, ConfigEnv, ContentScriptDefinition, ContentScriptEntrypoint, CopiedPublicFile, Dependency, Entrypoint, EntrypointGroup, EntrypointInfo, EslintGlobalsPropValue, Eslintrc, ExtensionRunner, ExtensionRunnerConfig, FirefoxDataCollectionPermissions, FirefoxDataCollectionType, FsCache, GeneratedPublicFile, GenericEntrypoint, HookResult, InlineConfig, IsolatedWorldContentScriptDefinition, IsolatedWorldContentScriptEntrypointOptions, Logger, MainWorldContentScriptDefinition, MainWorldContentScriptEntrypointOptions, OnContentScriptStopped, OptionsEntrypoint, OptionsEntrypointOptions, OutputAsset, OutputChunk, OutputFile, PerBrowserMap, PerBrowserOption, PopupEntrypoint, PopupEntrypointOptions, PublicPathEntry, ReloadContentScriptPayload, ResolvedBasePublicFile, ResolvedConfig$1 as ResolvedConfig, ResolvedEslintrc, ResolvedPerBrowserOptions, ResolvedPublicFile, ServerInfo, SidepanelEntrypoint, SidepanelEntrypointOptions, TargetBrowser, TargetManifestVersion, ThemeIcon, UnlistedScriptDefinition, UnlistedScriptEntrypoint, UserConfig, UserManifest, UserManifestFn, WebExtConfig, Wxt, WxtBuilder, WxtBuilderServer, WxtCommand, WxtDevServer, WxtDirEntry, WxtDirFileEntry, WxtDirTypeReferenceEntry, WxtHooks, WxtModule, WxtModuleOptions, WxtModuleSetup, WxtModuleWithMetadata, WxtPackageManager, WxtPlugin, WxtResolvedUnimportOptions, WxtUnimportOptions, WxtViteConfig };

package/dist/utils/content-script-ui/iframe.d.mts

@@ -1,6 +1,6 @@
 import { ContentScriptContext } from "../content-script-context.mjs";
 import { ContentScriptUi, ContentScriptUiOptions } from "./types.mjs";
-import * as wxt_browser0 from "wxt/browser";
+import * as _$wxt_browser0 from "wxt/browser";
 
 //#region src/utils/content-script-ui/iframe.d.ts
 /**
@@ -20,7 +20,7 @@ type IframeContentScriptUiOptions<TMounted> = ContentScriptUiOptions<TMounted> &
    * The path to the HTML page that will be shown in the iframe. This string
    * is passed into `browser.runtime.getURL`.
    */
-  page: wxt_browser0.HtmlPublicPath;
+  page: _$wxt_browser0.HtmlPublicPath;
   /**
    * Callback executed when mounting the UI. Use this function to customize
    * the iframe or wrapper element's appearance. It is called every time

package/dist/utils/inject-script.d.mts

@@ -1,7 +1,7 @@
-import * as wxt_browser0 from "wxt/browser";
+import * as _$wxt_browser0 from "wxt/browser";
 
 //#region src/utils/inject-script.d.ts
-type ScriptPublicPath = Extract<wxt_browser0.PublicPath, `${string}.js`>;
+type ScriptPublicPath = Extract<_$wxt_browser0.PublicPath, `${string}.js`>;
 /**
  * This function can only be called inside content scripts.
  *

package/dist/utils/inject-script.mjs

@@ -15,9 +15,10 @@ import { browser } from "wxt/browser";
 async function injectScript(path, options) {
 	const url = browser.runtime.getURL(path);
 	const script = document.createElement("script");
-	if (browser.runtime.getManifest().manifest_version === 2) script.text = await fetch(url).then((res) => res.text());
+	const isManifestV2 = browser.runtime.getManifest().manifest_version === 2;
+	if (isManifestV2) script.text = await fetch(url).then((res) => res.text());
 	else script.src = url;
-	const loadedPromise = makeLoadedPromise(script);
+	const loadedPromise = isManifestV2 ? void 0 : makeLoadedPromise(script);
 	await options?.modifyScript?.(script);
 	(document.head ?? document.documentElement).append(script);
 	if (!options?.keepInDom) script.remove();

package/dist/version.mjs

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

package/package.json

@@ -1,15 +1,27 @@
 {
   "name": "wxt",
   "type": "module",
-  "version": "0.20.20",
+  "version": "0.20.22",
   "description": "⚡ Next-gen Web Extension Framework",
   "license": "MIT",
+  "scripts": {
+    "wxt": "bun run src/cli/index.ts",
+    "build": "buildc -- bun run tsdown --config-loader unrun",
+    "check": "bun run build && bun run --sequential 'check:*'",
+    "check:default": "check",
+    "check:tsc-virtual": "tsc --noEmit -p src/virtual",
+    "test": "buildc --deps-only -- vitest",
+    "test:coverage": "bun run test run --coverage",
+    "sync-releases": "pnpx changelogen@latest gh release",
+    "prepack": "bun run build"
+  },
   "dependencies": {
     "@1natsu/wait-element": "^4.1.2",
     "@aklinker1/rollup-plugin-visualizer": "5.12.0",
     "@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/storage": "^1.0.0",
     "async-mutex": "^0.5.0",
     "c12": "^3.3.3",
@@ -18,20 +30,18 @@
     "ci-info": "^4.4.0",
     "consola": "^3.4.2",
     "defu": "^6.1.4",
-    "dotenv": "^17.3.1",
     "dotenv-expand": "^12.0.3",
     "esbuild": "^0.27.1",
-    "filesize": "^11.0.13",
+    "filesize": "^11.0.15",
     "get-port-please": "^3.2.0",
     "giget": "^1.2.3 || ^2.0.0 || ^3.0.0",
-    "hookable": "^6.0.1",
+    "hookable": "^6.1.0",
     "import-meta-resolve": "^4.2.0",
     "is-wsl": "^3.1.1",
     "json5": "^2.2.3",
     "jszip": "^3.10.1",
     "linkedom": "^0.18.12",
     "magicast": "^0.5.2",
-    "minimatch": "^10.2.4",
     "nano-spawn": "^2.0.0",
     "nanospinner": "^1.2.2",
     "normalize-path": "^3.0.0",
@@ -39,7 +49,7 @@
     "ohash": "^2.0.11",
     "open": "^11.0.0",
     "perfect-debounce": "^2.1.0",
-    "picocolors": "^1.1.1",
+    "picomatch": "^4.0.3",
     "prompts": "^2.4.2",
     "publish-browser-extension": "^2.3.0 || ^3.0.2 || ^4.0.4",
     "scule": "^1.3.0",
@@ -47,8 +57,7 @@
     "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",
-    "web-ext-run": "^0.2.4",
-    "@wxt-dev/browser": "^0.1.38"
+    "web-ext-run": "^0.2.4"
   },
   "peerDependencies": {
     "eslint": "^8.57.0 || ^9.0.0 || ^10.0.0"
@@ -59,17 +68,22 @@
     }
   },
   "devDependencies": {
+    "@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",
+    "@types/picomatch": "^4.0.2",
     "@types/prompts": "^2.4.9",
-    "eslint": "^10.0.0",
+    "eslint": "^10.1.0",
     "extract-zip": "^2.0.1",
     "happy-dom": "^20.8.3",
     "lodash.merge": "^4.6.2",
     "oxlint": "^1.51.0",
     "publint": "^0.3.18",
+    "tsdown": "^0.21.0",
     "typescript": "^5.9.3",
     "vitest": "^4.0.18",
     "vitest-plugin-random-seed": "^1.1.2"
@@ -192,14 +206,8 @@
       "default": "./dist/modules.mjs"
     }
   },
-  "scripts": {
-    "wxt": "tsx src/cli/index.ts",
-    "build": "buildc -- tsdown --config-loader unrun",
-    "check": "pnpm build && pnpm run --reporter-hide-prefix /^check:.*/",
-    "check:default": "check",
-    "check:tsc-virtual": "tsc --noEmit -p src/virtual",
-    "test": "buildc --deps-only -- vitest",
-    "test:coverage": "pnpm test run --coverage",
-    "sync-releases": "pnpx changelogen@latest gh release"
+  "engines": {
+    "node": ">=20.12.0",
+    "bun": ">=1.2.0"
   }
-}
+}

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2023 Aaron
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

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

@@ -1,26 +0,0 @@
-import { minimatch } from "minimatch";
-//#region src/core/utils/minimatch-multiple.ts
-/**
-* Run [`minimatch`](https://npmjs.com/package/minimatch) against multiple
-* patterns.
-*
-* Supports negated patterns, the order does not matter. If your `search` string
-* matches any of the negative patterns, it will return `false`.
-*
-* @example
-*   ```ts
-*   minimatchMultiple('a.json', ['*.json', '!b.json']); // => true
-*   minimatchMultiple('b.json', ['*.json', '!b.json']); // => false
-*   ```;
-*/
-function minimatchMultiple(search, patterns, options) {
-	if (patterns == null) return false;
-	const negatePatterns = [];
-	const positivePatterns = [];
-	for (const pattern of patterns) if (pattern[0] === "!") negatePatterns.push(pattern.slice(1));
-	else positivePatterns.push(pattern);
-	if (negatePatterns.some((negatePattern) => minimatch(search, negatePattern, options))) return false;
-	return positivePatterns.some((positivePattern) => minimatch(search, positivePattern, options));
-}
-//#endregion
-export { minimatchMultiple };