wxt 0.20.14 → 0.20.15

package/dist/builtin-modules/unimport.mjs

@@ -25,7 +25,7 @@ var unimport_default = defineWxtModule({
 			entries.push(await getImportsModuleEntry(wxt, unimport));
 			if (!isEnabled()) return;
 			entries.push(await getImportsDeclarationEntry(unimport));
-			if (wxt.config.imports.eslintrc.enabled === false) return;
+			if (!wxt.config.imports.eslintrc.enabled) return;
 			entries.push(await getEslintConfigEntry(unimport, wxt.config.imports.eslintrc.enabled, wxt.config.imports));
 		});
 		addViteConfig(wxt, () => ({ plugins: [UnimportPlugin.vite(wxt.config.imports)] }));

package/dist/cli/cli-utils.mjs

@@ -13,6 +13,8 @@ import spawn from "nano-spawn";
 */
 function wrapAction(cb, options) {
 	return async (...args) => {
+		const level = args.find((arg) => arg?.level)?.level;
+		if (level && Object.keys(LogLevels).includes(level)) consola.level = LogLevels[level];
 		if (!!args.find((arg) => arg?.debug)) consola.level = LogLevels.debug;
 		const startTime = Date.now();
 		try {
@@ -20,7 +22,7 @@ function wrapAction(cb, options) {
 			if (!(await cb(...args))?.isOngoing && !options?.disableFinishedLog) consola.success(`Finished in ${formatDuration(Date.now() - startTime)}`);
 		} catch (err) {
 			consola.fail(`Command failed after ${formatDuration(Date.now() - startTime)}`);
-			if (err instanceof ValidationError) {} else consola.error(err);
+			if (!(err instanceof ValidationError)) consola.error(err);
 			process.exit(1);
 		}
 	};

package/dist/cli/commands.mjs

@@ -11,6 +11,7 @@ import cac from "cac";
 //#region src/cli/commands.ts
 const cli = cac("wxt");
 cli.option("--debug", "enable debug mode");
+cli.option("--level <level>", "specify log level (\"silent\" | \"fatal\" | \"error\" | \"warn\" | \"log\" | \"info\" | \"success\" | \"fail\" | \"ready\" | \"start\" | \"box\" | \"debug\" | \"trace\" | \"verbose\")");
 cli.command("[root]", "start dev server").option("-c, --config <file>", "use specified config file").option("-m, --mode <mode>", "set env mode").option("-b, --browser <browser>", "specify a browser").option("--host <host>", "specify a host for the dev server to bind to").option("-p, --port <port>", "specify a port for the dev server to bind to").option("-e, --filter-entrypoint <entrypoint>", "only build specific entrypoints", { type: [] }).option("--mv3", "target manifest v3").option("--mv2", "target manifest v2").action(wrapAction(async (root, flags) => {
 	const serverOptions = {};
 	if (flags.host) serverOptions.host = flags.host;

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

@@ -1,4 +1,5 @@
 import { normalizePath } from "../../utils/paths.mjs";
+import "../../utils/index.mjs";
 import { getEntrypointBundlePath, isHtmlEntrypoint } from "../../utils/entrypoints.mjs";
 import { devHtmlPrerender } from "./plugins/devHtmlPrerender.mjs";
 import { devServerGlobals } from "./plugins/devServerGlobals.mjs";
@@ -77,8 +78,8 @@ async function createViteBuilder(wxtConfig, hooks, getWxtDevServer) {
 				},
 				rollupOptions: { output: {
 					entryFileNames: getEntrypointBundlePath(entrypoint, wxtConfig.outDir, ".js"),
-					assetFileNames: ({ name }) => {
-						if (entrypoint.type === "content-script" && name?.endsWith("css")) return `content-scripts/${entrypoint.name}.[ext]`;
+					assetFileNames: ({ names }) => {
+						if (entrypoint.type === "content-script" && names[0].endsWith("css")) return `content-scripts/${entrypoint.name}.[ext]`;
 						else return `assets/${entrypoint.name}.[ext]`;
 					}
 				} }
@@ -284,7 +285,7 @@ async function moveHtmlFiles(config, group, chunks) {
 			fileName: newBundlePath
 		};
 	}));
-	removeEmptyDirs(config.outDir);
+	await removeEmptyDirs(config.outDir);
 	return movedChunks;
 }
 /**

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

@@ -1,4 +1,5 @@
 import { normalizePath } from "../../../utils/paths.mjs";
+import "../../../utils/index.mjs";
 import { getEntrypointName } from "../../../utils/entrypoints.mjs";
 import { dirname, relative, resolve } from "node:path";
 import { parseHTML } from "linkedom";

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

@@ -14,9 +14,9 @@ function download(config) {
 		resolveId(id) {
 			if (id.startsWith("url:")) return "\0" + id;
 		},
-		async load(id) {
+		load(id) {
 			if (!id.startsWith("\0url:")) return;
-			return await fetchCached(id.replace("\0url:", ""), config);
+			return fetchCached(id.replace("\0url:", ""), config);
 		}
 	};
 }

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

@@ -1,4 +1,5 @@
 import { normalizePath } from "../../../utils/paths.mjs";
+import "../../../utils/index.mjs";
 import { removeMainFunctionCode } from "../../../utils/transform.mjs";
 import { resolve } from "node:path";
 

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

@@ -1,4 +1,4 @@
-import { exists } from "fs-extra";
+import { pathExists } from "fs-extra";
 import { resolve } from "node:path";
 
 //#region src/core/builders/vite/plugins/resolveAppConfig.ts
@@ -16,7 +16,7 @@ function resolveAppConfig(config) {
 		},
 		async resolveId(id) {
 			if (id !== virtualModuleId) return;
-			return await exists(appConfigFile) ? appConfigFile : resolvedVirtualModuleId;
+			return await pathExists(appConfigFile) ? appConfigFile : resolvedVirtualModuleId;
 		},
 		load(id) {
 			if (id === resolvedVirtualModuleId) return `export default {}`;

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

@@ -1,4 +1,5 @@
 import { normalizePath } from "../../../utils/paths.mjs";
+import "../../../utils/index.mjs";
 import { virtualModuleNames } from "../../../utils/virtual-modules.mjs";
 import fs from "fs-extra";
 import { resolve } from "path";

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

@@ -1,4 +1,5 @@
 import { normalizePath } from "../../../utils/paths.mjs";
+import "../../../utils/index.mjs";
 import { parseHTML } from "linkedom";
 
 //#region src/core/builders/vite/plugins/wxtPluginLoader.ts

package/dist/core/create-server.mjs

@@ -87,7 +87,7 @@ async function createServerInternal() {
 		async stop() {
 			wasStopped = true;
 			keyboardShortcuts.stop();
-			await runner.closeBrowser();
+			await runner.closeBrowser?.();
 			await builderServer.close();
 			await wxt.hooks.callHook("server:closed", wxt, server);
 			deinitWxtModules();
@@ -110,7 +110,7 @@ async function createServerInternal() {
 			server.ws.send("wxt:reload-extension");
 		},
 		async restartBrowser() {
-			await runner.closeBrowser();
+			await runner.closeBrowser?.();
 			keyboardShortcuts.stop();
 			await wxt.reloadConfig();
 			runner = await createExtensionRunner();

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

@@ -1,4 +1,5 @@
 import { normalizePath } from "./utils/paths.mjs";
+import "./utils/index.mjs";
 import { getEntrypointBundlePath, isHtmlEntrypoint } from "./utils/entrypoints.mjs";
 import { getEntrypointGlobals, getGlobals } from "./utils/globals.mjs";
 import { wxt } from "./wxt.mjs";
@@ -81,7 +82,7 @@ declare module "wxt/browser" {
 `;
 	const defaultLocalePath = path.resolve(wxt.config.publicDir, "_locales", defaultLocale ?? "", "messages.json");
 	let messages;
-	if (await fs.exists(defaultLocalePath)) messages = parseI18nMessages(JSON.parse(await fs.readFile(defaultLocalePath, "utf-8")));
+	if (await fs.pathExists(defaultLocalePath)) messages = parseI18nMessages(JSON.parse(await fs.readFile(defaultLocalePath, "utf-8")));
 	else messages = parseI18nMessages({});
 	const renderGetMessageOverload = (keyType, description, translation) => {
 		const commentLines = [];

package/dist/core/index.d.mts

@@ -5,4 +5,5 @@ import { defineRunnerConfig, defineWebExtConfig } from "./define-web-ext-config.
 import { createServer } from "./create-server.mjs";
 import { initialize } from "./initialize.mjs";
 import { prepare } from "./prepare.mjs";
-import { zip } from "./zip.mjs";
+import { zip } from "./zip.mjs";
+import { normalizePath } from "./utils/paths.mjs";

package/dist/core/index.mjs

@@ -1,3 +1,5 @@
+import { normalizePath } from "./utils/paths.mjs";
+import "./utils/index.mjs";
 import { build } from "./build.mjs";
 import { clean } from "./clean.mjs";
 import { defineConfig } from "./define-config.mjs";

package/dist/core/resolve-config.mjs

@@ -1,5 +1,6 @@
 import { normalizePath } from "./utils/paths.mjs";
 import { createFsCache } from "./utils/cache.mjs";
+import "./utils/index.mjs";
 import { builtinModules } from "../builtin-modules/index.mjs";
 import { getEslintVersion } from "./utils/eslint.mjs";
 import { safeStringToNumber } from "./utils/number.mjs";
@@ -355,11 +356,11 @@ async function getUnimportEslintOptions(wxtDir, options) {
 * Returns the path to `node_modules/wxt`.
 */
 function resolveWxtModuleDir() {
-	const url = resolve$1("wxt", typeof __filename === "string" ? pathToFileURL(__filename).href : import.meta.url);
+	const url = resolve$1("wxt", import.meta.url);
 	return path.resolve(fileURLToPath(url), "../..");
 }
 async function isDirMissing(dir) {
-	return !await fs.exists(dir);
+	return !await fs.pathExists(dir);
 }
 function logMissingDir(logger, name, expected) {
 	logger.warn(`${name} directory not found: ./${normalizePath(path.relative(process.cwd(), expected))}`);
@@ -376,8 +377,7 @@ async function mergeBuilderConfig(logger, inlineConfig, userConfig) {
 		logger.debug("Failed to import vite:", err);
 	});
 	if (vite) return { vite: async (env) => {
-		const resolvedInlineConfig = await inlineConfig.vite?.(env) ?? {};
-		const resolvedUserConfig = await userConfig.vite?.(env) ?? {};
+		const [resolvedInlineConfig = {}, resolvedUserConfig = {}] = await Promise.all([inlineConfig.vite?.(env), userConfig.vite?.(env)]);
 		return vite.mergeConfig(resolvedUserConfig, resolvedInlineConfig);
 	} };
 	throw Error("Builder not found. Make sure vite is installed.");

package/dist/core/runners/index.mjs

@@ -1,14 +1,14 @@
 import { wxt } from "../wxt.mjs";
-import { createWslRunner } from "./wsl.mjs";
-import { createWebExtRunner } from "./web-ext.mjs";
-import { createSafariRunner } from "./safari.mjs";
-import { createManualRunner } from "./manual.mjs";
 import { isWsl } from "../utils/wsl.mjs";
+import { createManualRunner } from "./manual.mjs";
+import { createSafariRunner } from "./safari.mjs";
+import { createWebExtRunner } from "./web-ext.mjs";
+import { createWslRunner } from "./wsl.mjs";
 
 //#region src/core/runners/index.ts
 async function createExtensionRunner() {
 	if (wxt.config.browser === "safari") return createSafariRunner();
-	if (await isWsl()) return createWslRunner();
+	if (isWsl()) return createWslRunner();
 	if (wxt.config.runnerConfig.config?.disabled) return createManualRunner();
 	return createWebExtRunner();
 }

package/dist/core/runners/manual.mjs

@@ -6,12 +6,9 @@ import { relative } from "node:path";
 * The manual runner tells the user to load the unpacked extension manually.
 */
 function createManualRunner() {
-	return {
-		async openBrowser() {
-			wxt.logger.info(`Load "${relative(process.cwd(), wxt.config.outDir)}" as an unpacked extension manually`);
-		},
-		async closeBrowser() {}
-	};
+	return { async openBrowser() {
+		wxt.logger.info(`Load "${relative(process.cwd(), wxt.config.outDir)}" as an unpacked extension manually`);
+	} };
 }
 
 //#endregion

package/dist/core/runners/safari.mjs

@@ -6,12 +6,9 @@ import { relative } from "node:path";
 * The Safari runner just logs a warning message because `web-ext` doesn't work with Safari.
 */
 function createSafariRunner() {
-	return {
-		async openBrowser() {
-			wxt.logger.warn(`Cannot Safari using web-ext. Load "${relative(process.cwd(), wxt.config.outDir)}" as an unpacked extension manually`);
-		},
-		async closeBrowser() {}
-	};
+	return { async openBrowser() {
+		wxt.logger.warn(`Cannot Safari using web-ext. Load "${relative(process.cwd(), wxt.config.outDir)}" as an unpacked extension manually`);
+	} };
 }
 
 //#endregion

package/dist/core/runners/web-ext.mjs

@@ -52,7 +52,7 @@ function createWebExtRunner() {
 			wxt.logger.success(`Opened browser in ${formatDuration(duration)}`);
 		},
 		async closeBrowser() {
-			return await runner?.exit();
+			await runner?.exit();
 		}
 	};
 }

package/dist/core/runners/wsl.mjs

@@ -6,12 +6,9 @@ import { relative } from "node:path";
 * The WSL runner just logs a warning message because `web-ext` doesn't work in WSL.
 */
 function createWslRunner() {
-	return {
-		async openBrowser() {
-			wxt.logger.warn(`Cannot open browser when using WSL. Load "${relative(process.cwd(), wxt.config.outDir)}" as an unpacked extension manually`);
-		},
-		async closeBrowser() {}
-	};
+	return { async openBrowser() {
+		wxt.logger.warn(`Cannot open browser when using WSL. Load "${relative(process.cwd(), wxt.config.outDir)}" as an unpacked extension manually`);
+	} };
 }
 
 //#endregion

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

@@ -41,8 +41,7 @@ async function findEntrypoints() {
 	}, []).filter(({ name, inputPath }, _, entrypointInfos) => {
 		if (inputPath.endsWith(".html")) return true;
 		if (!/index\..+$/.test(inputPath)) return true;
-		if (entrypointInfos.some((entry) => entry.name === name && entry.inputPath.endsWith("index.html"))) return false;
-		return true;
+		return !entrypointInfos.some((entry) => entry.name === name && entry.inputPath.endsWith("index.html"));
 	});
 	await wxt.hooks.callHook("entrypoints:found", wxt, entrypointInfos);
 	preventNoEntrypoints(entrypointInfos);
@@ -103,8 +102,7 @@ async function importEntrypoints(infos) {
 	const htmlInfos = infos.filter((info) => isHtmlEntrypoint(info));
 	const jsInfos = infos.filter((info) => isJsEntrypoint(info));
 	await Promise.all([...htmlInfos.map(async (info) => {
-		const res = await importHtmlEntrypoint(info);
-		resMap[info.inputPath] = res;
+		resMap[info.inputPath] = await importHtmlEntrypoint(info);
 	}), (async () => {
 		(await wxt.builder.importEntrypoints(jsInfos.map((info) => info.inputPath))).forEach((res, i) => {
 			resMap[jsInfos[i].inputPath] = res;
@@ -153,19 +151,24 @@ function preventNoEntrypoints(files) {
 	if (files.length === 0) throw Error(`No entrypoints found in ${wxt.config.entrypointsDir}`);
 }
 async function getPopupEntrypoint(info, options) {
-	const stictOptions = resolvePerBrowserOptions({
+	const strictOptions = resolvePerBrowserOptions({
 		browserStyle: options.browserStyle,
 		exclude: options.exclude,
 		include: options.include,
 		defaultIcon: options.defaultIcon,
 		defaultTitle: options.title,
-		mv2Key: options.type
+		mv2Key: options.type,
+		defaultArea: options.defaultArea
 	}, wxt.config.browser);
-	if (stictOptions.mv2Key && stictOptions.mv2Key !== "page_action") stictOptions.mv2Key = "browser_action";
+	if (strictOptions.mv2Key && strictOptions.mv2Key !== "page_action") strictOptions.mv2Key = "browser_action";
+	const themeIcons = options.themeIcons;
 	return {
 		type: "popup",
 		name: "popup",
-		options: stictOptions,
+		options: {
+			...strictOptions,
+			themeIcons
+		},
 		inputPath: info.inputPath,
 		outputDir: wxt.config.outDir
 	};

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

@@ -55,7 +55,7 @@ async function internalBuild() {
 		else {
 			wxt.logger.info(`Opening ${pc.yellow(statsPath)} in browser...`);
 			const { default: open } = await import("open");
-			open(wxt.config.analysis.outputFile);
+			await open(wxt.config.analysis.outputFile);
 		}
 	}
 	return output;
@@ -82,12 +82,11 @@ function printValidationResults({ errorCount, errors, warningCount }) {
 		return map;
 	}, /* @__PURE__ */ new Map());
 	Array.from(entrypointErrors.entries()).forEach(([entrypoint, errors]) => {
-		wxt.logger.log(relative(cwd, entrypoint.inputPath));
-		console.log();
+		wxt.logger.log(relative(cwd, entrypoint.inputPath) + "\n");
 		errors.forEach((err) => {
 			const type = err.type === "error" ? pc.red("ERROR") : pc.yellow("WARN");
-			const recieved = pc.dim(`(recieved: ${JSON.stringify(err.value)})`);
-			wxt.logger.log(`  - ${type} ${err.message} ${recieved}`);
+			const received = pc.dim(`(received: ${JSON.stringify(err.value)})`);
+			wxt.logger.log(`  - ${type} ${err.message} ${received}`);
 		});
 		console.log();
 	});

package/dist/core/utils/eslint.mjs

@@ -1,7 +1,7 @@
 //#region src/core/utils/eslint.ts
 async function getEslintVersion() {
 	try {
-		const { ESLint } = (await import("node:module")).default.createRequire(import.meta.url)("eslint");
+		const { ESLint } = await import("eslint");
 		return ESLint.version?.split(".") ?? [];
 	} catch {
 		return [];

package/dist/core/utils/fs.mjs

@@ -19,7 +19,7 @@ async function writeFileIfDifferent(file, newContents) {
 * `config.publicDir`.
 */
 async function getPublicFiles() {
-	if (!await fs.exists(wxt.config.publicDir)) return [];
+	if (!await fs.pathExists(wxt.config.publicDir)) return [];
 	return (await glob("**/*", { cwd: wxt.config.publicDir })).map(unnormalizePath);
 }
 

package/dist/core/utils/index.mjs

@@ -0,0 +1,3 @@
+import { normalizePath } from "./paths.mjs";
+
+export {  };

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

@@ -4,8 +4,7 @@ import pc from "picocolors";
 
 //#region src/core/utils/log/printHeader.ts
 function printHeader() {
-	console.log();
-	consola$1.log(`${pc.gray("WXT")} ${pc.gray(pc.bold(version))}`);
+	consola$1.log(`\n${pc.gray("WXT")} ${pc.gray(pc.bold(version))}`);
 }
 
 //#endregion

package/dist/core/utils/manifest.mjs

@@ -138,6 +138,8 @@ function addEntrypoints(manifest, entrypoints, buildOutput) {
 		if (popup.options.defaultIcon) options.default_icon = popup.options.defaultIcon;
 		if (popup.options.defaultTitle) options.default_title = popup.options.defaultTitle;
 		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,
 			...options,
@@ -237,13 +239,13 @@ function discoverIcons(buildOutput) {
 	return icons.length > 0 ? Object.fromEntries(icons) : void 0;
 }
 function addDevModeCsp(manifest) {
-	let permissonUrl = wxt.server?.origin;
-	if (permissonUrl) {
-		const permissionUrlInstance = new URL(permissonUrl);
+	let permissionUrl = wxt.server?.origin;
+	if (permissionUrl) {
+		const permissionUrlInstance = new URL(permissionUrl);
 		permissionUrlInstance.port = "";
-		permissonUrl = permissionUrlInstance.toString();
+		permissionUrl = permissionUrlInstance.toString();
 	}
-	const permission = `${permissonUrl}*`;
+	const permission = `${permissionUrl}*`;
 	const allowedCsp = wxt.server?.origin ?? "http://localhost:*";
 	if (manifest.manifest_version === 3) addHostPermission(manifest, permission);
 	else addPermission(manifest, permission);
@@ -353,7 +355,7 @@ function convertCspToMv2(manifest) {
 	manifest.content_security_policy = manifest.content_security_policy.extension_pages;
 }
 /**
-* Make sure all resources are in MV3 format. If not, add a wanring
+* Make sure all resources are in MV3 format. If not, add a warning.
 */
 function validateMv3WebAccessibleResources(manifest) {
 	if (manifest.web_accessible_resources == null) return;

package/dist/core/utils/network.mjs

@@ -4,10 +4,7 @@ import dns from "node:dns";
 //#region src/core/utils/network.ts
 function isOffline() {
 	return withTimeout(new Promise((res) => {
-		dns.resolve("google.com", (err) => {
-			if (err == null) res(false);
-			else res(true);
-		});
+		dns.resolve("google.com", (err) => res(err != null));
 	}), 1e3).catch(() => true);
 }
 async function isOnline() {

package/dist/core/utils/paths.d.mts

@@ -0,0 +1,8 @@
+//#region src/core/utils/paths.d.ts
+/**
+ * Converts system paths to normalized bundler path.
+ * On Windows, this returns paths with `/` instead of `\`.
+ */
+declare function normalizePath(path: string): string;
+//#endregion
+export { normalizePath };

package/dist/core/utils/paths.mjs

@@ -3,8 +3,8 @@ import normalize from "normalize-path";
 
 //#region src/core/utils/paths.ts
 /**
-* Converts system paths to normalized bundler path. On windows and unix, this returns paths with /
-* instead of \.
+* Converts system paths to normalized bundler path.
+* On Windows, this returns paths with `/` instead of `\`.
 */
 function normalizePath(path) {
 	return normalize(path);

package/dist/core/utils/wsl.mjs

@@ -1,10 +1,11 @@
+import isWsl_ from "is-wsl";
+
 //#region src/core/utils/wsl.ts
 /**
 * Returns true when running on WSL or WSL2.
 */
-async function isWsl() {
-	const { default: isWsl } = await import("is-wsl");
-	return isWsl;
+function isWsl() {
+	return isWsl_;
 }
 
 //#endregion

package/dist/core/wxt.mjs

@@ -18,8 +18,7 @@ async function registerWxt(command, inlineConfig = {}) {
 	process.env.NODE_ENV ??= inlineConfig.mode ?? (command === "serve" ? "development" : "production");
 	const hooks = createHooks();
 	const config = await resolveConfig(inlineConfig, command);
-	const builder = await createViteBuilder(config, hooks, () => wxt.server);
-	const pm = await createWxtPackageManager(config.root);
+	const [builder, pm] = await Promise.all([createViteBuilder(config, hooks, () => wxt.server), createWxtPackageManager(config.root)]);
 	wxt = {
 		config,
 		hooks,

package/dist/core/zip.mjs

@@ -1,9 +1,11 @@
 import { normalizePath } from "./utils/paths.mjs";
+import "./utils/index.mjs";
 import { formatDuration } from "./utils/time.mjs";
 import { safeFilename } from "./utils/strings.mjs";
 import { registerWxt, wxt } from "./wxt.mjs";
 import { findEntrypoints } from "./utils/building/find-entrypoints.mjs";
 import { printFileList } from "./utils/log/printFileList.mjs";
+import "./utils/log/index.mjs";
 import { getPackageJson } from "./utils/package.mjs";
 import { internalBuild } from "./utils/building/internal-build.mjs";
 import "./utils/building/index.mjs";

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { BackgroundDefinition, BackgroundEntrypoint, BackgroundEntrypointOptions, BaseContentScriptEntrypointOptions, BaseEntrypoint, BaseEntrypointOptions, 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, UnlistedScriptDefinition, 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, 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, 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";
@@ -7,6 +7,7 @@ import { createServer } from "./core/create-server.mjs";
 import { initialize } from "./core/initialize.mjs";
 import { prepare } from "./core/prepare.mjs";
 import { zip } from "./core/zip.mjs";
+import { normalizePath } from "./core/utils/paths.mjs";
 import "./core/index.mjs";
 import { version } from "./version.mjs";
-export { BackgroundDefinition, BackgroundEntrypoint, BackgroundEntrypointOptions, BaseContentScriptEntrypointOptions, BaseEntrypoint, BaseEntrypointOptions, 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, UnlistedScriptDefinition, 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, prepare, version, zip };
+export { BackgroundDefinition, BackgroundEntrypoint, BackgroundEntrypointOptions, BaseContentScriptEntrypointOptions, BaseEntrypoint, BaseEntrypointOptions, 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, 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/index.mjs

@@ -1,3 +1,4 @@
+import { normalizePath } from "./core/utils/paths.mjs";
 import { version } from "./version.mjs";
 import { build } from "./core/build.mjs";
 import { clean } from "./core/clean.mjs";
@@ -9,4 +10,4 @@ import { prepare } from "./core/prepare.mjs";
 import { zip } from "./core/zip.mjs";
 import "./core/index.mjs";
 
-export { build, clean, createServer, defineConfig, defineRunnerConfig, defineWebExtConfig, initialize, prepare, version, zip };
+export { build, clean, createServer, defineConfig, defineRunnerConfig, defineWebExtConfig, initialize, normalizePath, prepare, version, zip };

package/dist/modules.d.mts

@@ -1,6 +1,6 @@
 import { Entrypoint, Wxt, WxtModule, WxtModuleOptions, WxtModuleSetup } from "./types.mjs";
-import * as vite from "vite";
 import { UnimportOptions } from "unimport";
+import * as vite from "vite";
 
 //#region src/modules.d.ts
 declare function defineWxtModule<TOptions extends WxtModuleOptions>(module: WxtModule<TOptions> | WxtModuleSetup<TOptions>): WxtModule<TOptions>;

package/dist/modules.mjs

@@ -1,6 +1,5 @@
 import glob from "fast-glob";
 import { resolve } from "node:path";
-import * as vite from "vite";
 
 //#region src/modules.ts
 function defineWxtModule(module) {
@@ -89,7 +88,7 @@ function addViteConfig(wxt, viteConfig) {
 	wxt.hooks.hook("config:resolved", (wxt) => {
 		const userVite = wxt.config.vite;
 		wxt.config.vite = async (env) => {
-			const fromUser = await userVite(env);
+			const [vite, fromUser] = await Promise.all([import("vite"), userVite(env)]);
 			const fromModule = viteConfig(env) ?? {};
 			return vite.mergeConfig(fromModule, fromUser);
 		};
@@ -142,7 +141,6 @@ function addWxtPlugin(wxt, plugin) {
 */
 function addImportPreset(wxt, preset) {
 	wxt.hooks.hook("config:resolved", (wxt) => {
-		if (!wxt.config.imports) return;
 		wxt.config.imports.presets ??= [];
 		if (wxt.config.imports.presets.includes(preset)) return;
 		wxt.config.imports.presets.push(preset);

package/dist/types.d.mts

@@ -27,12 +27,12 @@
 import { ManifestContentScript } from "./core/utils/types.mjs";
 import { ResolvedConfig } from "c12";
 import { LogLevel } from "consola";
-import * as vite from "vite";
 import { Import, UnimportOptions } from "unimport";
 import { Hookable, NestedHooks } from "hookable";
 import * as Nypm from "nypm";
 import { PluginVisualizerOptions } from "@aklinker1/rollup-plugin-visualizer";
 import { Browser } from "@wxt-dev/browser";
+import * as vite from "vite";
 
 //#region src/types.d.ts
 interface InlineConfig {
@@ -47,7 +47,7 @@ interface InlineConfig {
    * Directory containing all source code. Set to `"src"` to move all source code to a `src/`
    * directory.
    *
-   * After changing, don't forget to move the `public/` and `entrypoints/` directories into the new
+   * After changing, remember to move the `public/` and `entrypoints/` directories into the new
    * source dir.
    *
    * @default config.root
@@ -637,6 +637,18 @@ interface IsolatedWorldContentScriptEntrypointOptions extends BaseContentScriptE
    */
   world?: 'ISOLATED';
 }
+/**
+ * Firefox theme icon definition for light/dark mode support.
+ * @see https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/browser_action#theme_icons
+ */
+interface ThemeIcon {
+  /** Path to the icon shown when the browser uses a light theme. */
+  light: string;
+  /** Path to the icon shown when the browser uses a dark theme. */
+  dark: string;
+  /** Icon size in pixels. */
+  size: number;
+}
 interface PopupEntrypointOptions extends BaseEntrypointOptions {
   /**
    * Defaults to "browser_action" to be equivalent to MV3's "action" key
@@ -645,6 +657,16 @@ interface PopupEntrypointOptions extends BaseEntrypointOptions {
   defaultIcon?: Record<string, string>;
   defaultTitle?: PerBrowserOption<string>;
   browserStyle?: PerBrowserOption<boolean>;
+  /**
+   * Firefox only. Defines the part of the browser in which the button is initially placed.
+   * @see https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/action#default_area
+   */
+  defaultArea?: PerBrowserOption<'navbar' | 'menupanel' | 'tabstrip' | 'personaltoolbar'>;
+  /**
+   * Firefox only. Icons for light and dark themes.
+   * @see https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/action#theme_icons
+   */
+  themeIcons?: ThemeIcon[];
 }
 interface OptionsEntrypointOptions extends BaseEntrypointOptions {
   openInTab?: PerBrowserOption<boolean>;
@@ -1281,7 +1303,7 @@ interface FsCache {
 }
 interface ExtensionRunner {
   openBrowser(): Promise<void>;
-  closeBrowser(): Promise<void>;
+  closeBrowser?(): Promise<void>;
   /** Whether or not this runner actually opens the browser. */
   canOpen?(): boolean;
 }
@@ -1450,4 +1472,4 @@ interface WxtDirFileEntry {
   tsReference?: boolean;
 }
 //#endregion
-export { BackgroundDefinition, BackgroundEntrypoint, BackgroundEntrypointOptions, BaseContentScriptEntrypointOptions, BaseEntrypoint, BaseEntrypointOptions, 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, UnlistedScriptDefinition, 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, 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, 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-context.d.mts

@@ -36,10 +36,9 @@ declare class ContentScriptContext implements AbortController {
   private readonly contentScriptName;
   readonly options?: Omit<ContentScriptDefinition, "main"> | undefined;
   private static SCRIPT_STARTED_MESSAGE_TYPE;
-  private isTopFrame;
+  private id;
   private abortController;
   private locationWatcher;
-  private receivedMessageIds;
   constructor(contentScriptName: string, options?: Omit<ContentScriptDefinition, "main"> | undefined);
   get signal(): AbortSignal;
   abort(reason?: any): void;
@@ -125,10 +124,8 @@ declare class ContentScriptContext implements AbortController {
    */
   notifyInvalidated(): void;
   stopOldScripts(): void;
-  verifyScriptStartedEvent(event: MessageEvent): boolean;
-  listenForNewerScripts(options?: {
-    ignoreFirstEvent?: boolean;
-  }): void;
+  verifyScriptStartedEvent(event: CustomEvent): boolean;
+  listenForNewerScripts(): void;
 }
 interface WxtWindowEventMap extends WindowEventMap {
   'wxt:locationchange': WxtLocationChangeEvent;

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

@@ -36,18 +36,16 @@ import { browser } from "wxt/browser";
 */
 var ContentScriptContext = class ContentScriptContext {
 	static SCRIPT_STARTED_MESSAGE_TYPE = getUniqueEventName("wxt:content-script-started");
-	isTopFrame = window.self === window.top;
+	id;
 	abortController;
 	locationWatcher = createLocationWatcher(this);
-	receivedMessageIds = /* @__PURE__ */ new Set();
 	constructor(contentScriptName, options) {
 		this.contentScriptName = contentScriptName;
 		this.options = options;
+		this.id = Math.random().toString(36).slice(2);
 		this.abortController = new AbortController();
-		if (this.isTopFrame) {
-			this.listenForNewerScripts({ ignoreFirstEvent: true });
-			this.stopOldScripts();
-		} else this.listenForNewerScripts();
+		this.stopOldScripts();
+		this.listenForNewerScripts();
 	}
 	get signal() {
 		return this.abortController.signal;
@@ -161,31 +159,28 @@ var ContentScriptContext = class ContentScriptContext {
 		logger.debug(`Content script "${this.contentScriptName}" context invalidated`);
 	}
 	stopOldScripts() {
+		document.dispatchEvent(new CustomEvent(ContentScriptContext.SCRIPT_STARTED_MESSAGE_TYPE, { detail: {
+			contentScriptName: this.contentScriptName,
+			messageId: this.id
+		} }));
 		window.postMessage({
 			type: ContentScriptContext.SCRIPT_STARTED_MESSAGE_TYPE,
 			contentScriptName: this.contentScriptName,
-			messageId: Math.random().toString(36).slice(2)
+			messageId: this.id
 		}, "*");
 	}
 	verifyScriptStartedEvent(event) {
-		const isScriptStartedEvent = event.data?.type === ContentScriptContext.SCRIPT_STARTED_MESSAGE_TYPE;
-		const isSameContentScript = event.data?.contentScriptName === this.contentScriptName;
-		const isNotDuplicate = !this.receivedMessageIds.has(event.data?.messageId);
-		return isScriptStartedEvent && isSameContentScript && isNotDuplicate;
+		const isSameContentScript = event.detail?.contentScriptName === this.contentScriptName;
+		const isFromSelf = event.detail?.messageId === this.id;
+		return isSameContentScript && !isFromSelf;
 	}
-	listenForNewerScripts(options) {
-		let isFirst = true;
+	listenForNewerScripts() {
 		const cb = (event) => {
-			if (this.verifyScriptStartedEvent(event)) {
-				this.receivedMessageIds.add(event.data.messageId);
-				const wasFirst = isFirst;
-				isFirst = false;
-				if (wasFirst && options?.ignoreFirstEvent) return;
-				this.notifyInvalidated();
-			}
+			if (!(event instanceof CustomEvent) || !this.verifyScriptStartedEvent(event)) return;
+			this.notifyInvalidated();
 		};
-		addEventListener("message", cb);
-		this.onInvalidated(() => removeEventListener("message", cb));
+		document.addEventListener(ContentScriptContext.SCRIPT_STARTED_MESSAGE_TYPE, cb);
+		this.onInvalidated(() => document.removeEventListener(ContentScriptContext.SCRIPT_STARTED_MESSAGE_TYPE, cb));
 	}
 };
 

package/dist/utils/content-script-ui/iframe.mjs

@@ -13,7 +13,7 @@ function createIframeUi(ctx, options) {
 	const iframe = document.createElement("iframe");
 	iframe.src = browser.runtime.getURL(options.page);
 	wrapper.appendChild(iframe);
-	let mounted = void 0;
+	let mounted;
 	const mount = () => {
 		applyPosition(wrapper, iframe, options);
 		options.onBeforeMount?.(wrapper, iframe);

package/dist/utils/content-script-ui/integrated.mjs

@@ -8,7 +8,7 @@ import { applyPosition, createMountFunctions, mountUi } from "./shared.mjs";
 */
 function createIntegratedUi(ctx, options) {
 	const wrapper = document.createElement(options.tag || "div");
-	let mounted = void 0;
+	let mounted;
 	const mount = () => {
 		applyPosition(wrapper, void 0, options);
 		mountUi(wrapper, options);

package/dist/utils/content-script-ui/shared.mjs

@@ -52,13 +52,11 @@ function mountUi(root, options) {
 		case "before":
 			anchor.parentElement?.insertBefore(root, anchor);
 			break;
-		default:
-			options.append(anchor, root);
-			break;
+		default: options.append(anchor, root);
 	}
 }
 function createMountFunctions(baseFunctions, options) {
-	let autoMountInstance = void 0;
+	let autoMountInstance;
 	const stopAutoMount = () => {
 		autoMountInstance?.stopAutoMount();
 		autoMountInstance = void 0;

package/dist/version.mjs

@@ -1,5 +1,5 @@
 //#region src/version.ts
-const version = "0.20.14";
+const version = "0.20.15";
 
 //#endregion
 export { version };

package/dist/virtual/background-entrypoint.mjs

@@ -24,9 +24,6 @@ const logger = {
 let ws;
 /**
 * Connect to the websocket and listen for messages.
-*
-* @param onMessage Optional callback that is called when a message is recieved and we've verified
-*                  it's structure is what we expect.
 */
 function getDevServerWebSocket() {
 	if (import.meta.env.COMMAND !== "serve") throw Error("Must be running WXT dev command to connect to call getDevServerWebSocket()");

package/dist/virtual/reload-html.mjs

@@ -19,9 +19,6 @@ const logger = {
 let ws;
 /**
 * Connect to the websocket and listen for messages.
-*
-* @param onMessage Optional callback that is called when a message is recieved and we've verified
-*                  it's structure is what we expect.
 */
 function getDevServerWebSocket() {
 	if (import.meta.env.COMMAND !== "serve") throw Error("Must be running WXT dev command to connect to call getDevServerWebSocket()");

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "wxt",
   "type": "module",
-  "version": "0.20.14",
+  "version": "0.20.15",
   "description": "⚡ Next-gen Web Extension Framework",
   "license": "MIT",
   "dependencies": {
@@ -51,6 +51,14 @@
     "web-ext-run": "^0.2.4",
     "@wxt-dev/browser": "^0.1.36"
   },
+  "peerDependencies": {
+    "eslint": "^8.57.0 || ^9.0.0"
+  },
+  "peerDependenciesMeta": {
+    "eslint": {
+      "optional": true
+    }
+  },
   "devDependencies": {
     "@faker-js/faker": "^10.2.0",
     "@types/fs-extra": "^11.0.4",
@@ -58,6 +66,7 @@
     "@types/node": "^20.17.6",
     "@types/normalize-path": "^3.0.2",
     "@types/prompts": "^2.4.9",
+    "eslint": "^9.38.0",
     "extract-zip": "^2.0.1",
     "happy-dom": "^20.5.0",
     "lodash.merge": "^4.6.2",
@@ -67,7 +76,6 @@
     "vitest": "^4.0.18",
     "vitest-plugin-random-seed": "^1.1.2"
   },
-  "peerDependenciesMeta": {},
   "repository": {
     "type": "git",
     "url": "git+https://github.com/wxt-dev/wxt.git"