wxt 0.21.3 → 0.21.4

package/dist/builtin-modules/unimport.mjs

@@ -55,13 +55,13 @@ async function getImportsModuleEntry(wxt, unimport) {
 		tsReference: true
 	};
 }
-async function getEslintConfigEntry(unimport, version, options) {
+async function getEslintConfigEntry(unimport, configVersion, options) {
 	const globals = (await unimport.getImports()).map((i) => i.as ?? i.name).filter(Boolean).sort().reduce((globals, name) => {
 		globals[name] = options.eslintrc.globalsPropValue;
 		return globals;
 	}, {});
-	if (version <= 8) return getEslint8ConfigEntry(options, globals);
-	else return getEslint9ConfigEntry(options, globals);
+	if (configVersion === 8) return getEslint8ConfigEntry(options, globals);
+	return getEslint9ConfigEntry(options, globals);
 }
 function getEslint8ConfigEntry(options, globals) {
 	return {

package/dist/cli/cli-utils.mjs

@@ -4,7 +4,7 @@ import { formatDuration } from "../core/utils/time.mjs";
 import { printHeader } from "../core/utils/log/printHeader.mjs";
 import "../core/utils/log/index.mjs";
 import { ValidationError } from "../core/utils/validation.mjs";
-import spawn from "nano-spawn";
+import { x } from "tinyexec";
 import consola, { LogLevels } from "consola";
 //#region src/cli/cli-utils.ts
 /**
@@ -47,7 +47,10 @@ function createAliasedCommand(base, name, alias, bin, docsUrl) {
 	const aliasedCommand = base.command(`${name} [...args]`, `Alias for ${alias} (${docsUrl})`).allowUnknownOptions().action(async () => {
 		try {
 			await registerWxt("build");
-			await spawn(bin, process.argv.slice(process.argv.indexOf(aliasedCommand.name) + 1), { stdio: "inherit" });
+			await x(bin, process.argv.slice(process.argv.indexOf(aliasedCommand.name) + 1), {
+				throwOnError: true,
+				nodeOptions: { stdio: "inherit" }
+			});
 		} catch {
 			process.exit(1);
 		}

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

@@ -347,7 +347,14 @@ async function removeEmptyDirs(dir) {
 	const files = await readdir(dir);
 	for (const file of files) {
 		const filePath = join(dir, file);
-		if ((await stat(filePath)).isDirectory()) await removeEmptyDirs(filePath);
+		let stats;
+		try {
+			stats = await stat(filePath);
+		} catch (err) {
+			if (err?.code === "ENOENT") continue;
+			throw err;
+		}
+		if (stats.isDirectory()) await removeEmptyDirs(filePath);
 	}
 	try {
 		await rmdir(dir);

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

@@ -1,9 +1,9 @@
 import { normalizePath } from "../../../utils/paths.mjs";
 import { getEntrypointName } from "../../../utils/entrypoints.mjs";
 import "../../../utils/index.mjs";
+import { c } from "../../../../inline/ohash/index.mjs";
 import { dirname, relative, resolve } from "node:path";
 import { parseHTML } from "linkedom";
-import { hash } from "ohash";
 //#region src/core/builders/vite/plugins/devHtmlPrerender.ts
 const inlineScriptContents = {};
 /**
@@ -48,7 +48,7 @@ function devHtmlPrerender(config, server) {
 			const { document } = parseHTML(await server.transformHtml(url, html, originalUrl));
 			document.querySelectorAll("script:not([src])").forEach((script) => {
 				const textContent = script.textContent ?? "";
-				const key = hash(textContent);
+				const key = c(textContent);
 				inlineScriptContents[key] = textContent;
 				const virtualScript = document.createElement("script");
 				virtualScript.type = "module";

package/dist/core/initialize.mjs

@@ -1,4 +1,5 @@
 import { pathExists } from "./utils/fs.mjs";
+import { createSpinner } from "./utils/spinner.mjs";
 import { readdir, rename } from "node:fs/promises";
 import path from "node:path";
 import { consola as consola$1 } from "consola";
@@ -80,7 +81,6 @@ async function listTemplatesGithub() {
 	return await res.json();
 }
 async function cloneProject({ directory, template }) {
-	const { createSpinner } = await import("nanospinner");
 	const spinner = createSpinner("Downloading template").start();
 	try {
 		await downloadTemplate(`gh:${REPO}/${template.path}`, {

package/dist/core/keyboard-shortcuts.mjs

@@ -11,6 +11,7 @@ function createKeyboardShortcuts(server) {
 	return {
 		start() {
 			this.stop();
+			if (!process.stdin.isTTY) return;
 			rl ??= readline.createInterface({
 				input: process.stdin,
 				terminal: false

package/dist/core/package-managers/bun.mjs

@@ -1,5 +1,5 @@
 import { dedupeDependencies, npm } from "./npm.mjs";
-import spawn from "nano-spawn";
+import { x } from "tinyexec";
 //#region src/core/package-managers/bun.ts
 const bun = {
 	overridesKey: "overrides",
@@ -9,7 +9,10 @@ const bun = {
 	async listDependencies(options) {
 		const args = ["pm", "ls"];
 		if (options?.all) args.push("--all");
-		return dedupeDependencies((await spawn("bun", args, { cwd: options?.cwd })).stdout.split("\n").slice(1).map((line) => line.trim()).map((line) => /.* (@?\S+)@(\S+)$/.exec(line)).filter((match) => !!match).map(([_, name, version]) => ({
+		return dedupeDependencies((await x("bun", args, {
+			throwOnError: true,
+			nodeOptions: { cwd: options?.cwd }
+		})).stdout.split("\n").slice(1).map((line) => line.trim()).map((line) => /.* (@?\S+)@(\S+)$/.exec(line)).filter((match) => !!match).map(([_, name, version]) => ({
 			name,
 			version
 		})));

package/dist/core/package-managers/npm.mjs

@@ -1,23 +1,29 @@
 import { mkdir } from "node:fs/promises";
 import path from "node:path";
-import spawn from "nano-spawn";
+import { x } from "tinyexec";
 //#region src/core/package-managers/npm.ts
 const npm = {
 	overridesKey: "overrides",
 	async downloadDependency(id, downloadDir) {
 		await mkdir(downloadDir, { recursive: true });
-		const res = await spawn("npm", [
+		const res = await x("npm", [
 			"pack",
 			id,
 			"--json"
-		], { cwd: downloadDir });
+		], {
+			throwOnError: true,
+			nodeOptions: { cwd: downloadDir }
+		});
 		const packed = JSON.parse(res.stdout);
 		return path.resolve(downloadDir, packed[0].filename);
 	},
 	async listDependencies(options) {
 		const args = ["ls", "--json"];
 		if (options?.all) args.push("--depth", "Infinity");
-		const res = await spawn("npm", args, { cwd: options?.cwd });
+		const res = await x("npm", args, {
+			throwOnError: true,
+			nodeOptions: { cwd: options?.cwd }
+		});
 		return flattenNpmListOutput([JSON.parse(res.stdout)]);
 	}
 };

package/dist/core/package-managers/pnpm.mjs

@@ -1,5 +1,5 @@
 import { flattenNpmListOutput, npm } from "./npm.mjs";
-import spawn from "nano-spawn";
+import { x } from "tinyexec";
 //#region src/core/package-managers/pnpm.ts
 const pnpm = {
 	overridesKey: "resolutions",
@@ -14,7 +14,10 @@ const pnpm = {
 		];
 		if (options?.all) args.push("--depth", "Infinity");
 		if (typeof process !== "undefined" && process.env.WXT_PNPM_IGNORE_WORKSPACE === "true") args.push("--ignore-workspace");
-		const res = await spawn("pnpm", args, { cwd: options?.cwd });
+		const res = await x("pnpm", args, {
+			throwOnError: true,
+			nodeOptions: { cwd: options?.cwd }
+		});
 		return flattenNpmListOutput(JSON.parse(res.stdout));
 	}
 };

package/dist/core/package-managers/yarn.mjs

@@ -1,5 +1,5 @@
 import { dedupeDependencies, npm } from "./npm.mjs";
-import spawn from "nano-spawn";
+import { x } from "tinyexec";
 //#region src/core/package-managers/yarn.ts
 const yarn = {
 	overridesKey: "resolutions",
@@ -9,7 +9,10 @@ const yarn = {
 	async listDependencies(options) {
 		const args = ["list", "--json"];
 		if (options?.all) args.push("--depth", "Infinity");
-		const tree = (await spawn("yarn", args, { cwd: options?.cwd })).stdout.split("\n").map((line) => JSON.parse(line)).find((line) => line.type === "tree")?.data;
+		const tree = (await x("yarn", args, {
+			throwOnError: true,
+			nodeOptions: { cwd: options?.cwd }
+		})).stdout.trimEnd().split("\n").map((line) => JSON.parse(line)).find((line) => line.type === "tree")?.data;
 		if (tree == null) throw Error("'yarn list --json' did not output a tree");
 		const queue = [...tree.trees];
 		const dependencies = [];

package/dist/core/resolve-config.mjs

@@ -5,18 +5,19 @@ import { createFsCache } from "./utils/cache.mjs";
 import { getEslintVersion } from "./utils/eslint.mjs";
 import { safeStringToNumber } from "./utils/number.mjs";
 import { loadEnv } from "./utils/env.mjs";
+import { v } from "../inline/get-port-please/index.mjs";
 import { createSafariRunner } from "./runners/safari.mjs";
+import { d } from "../inline/is-wsl/index.mjs";
 import { createWslRunner } from "./runners/wsl.mjs";
 import { createManualRunner } from "./runners/manual.mjs";
+import { createWxtLogger } from "./utils/log/wxtLogger.mjs";
 import { pathExists } from "./utils/fs.mjs";
 import { glob } from "tinyglobby";
 import path from "node:path";
 import { loadConfig } from "c12";
 import consola, { LogLevels } from "consola";
 import defu from "defu";
-import { getPort } from "get-port-please";
 import { fileURLToPath, pathToFileURL } from "node:url";
-import isWsl from "is-wsl";
 //#region src/core/resolve-config.ts
 /**
 * Given an inline config, discover the config file if necessary, merge the
@@ -40,7 +41,7 @@ async function resolveConfig(inlineConfig, command) {
 	}
 	const mergedConfig = await mergeInlineConfig(inlineConfig, userConfig);
 	const debug = mergedConfig.debug ?? false;
-	const logger = mergedConfig.logger ?? consola;
+	const logger = createWxtLogger(mergedConfig.logger ?? consola);
 	if (debug) logger.level = LogLevels.debug;
 	const browser = mergedConfig.browser ?? "chrome";
 	const targetBrowsers = mergedConfig.targetBrowsers ?? [];
@@ -93,12 +94,12 @@ async function resolveConfig(inlineConfig, command) {
 		let port = mergedConfig.dev?.server?.port;
 		const origin = mergedConfig.dev?.server?.origin ?? "localhost";
 		const strictPort = mergedConfig.dev?.server?.strictPort ?? false;
-		if (port == null || !isFinite(port)) port = await getPort({
+		if (port == null || !isFinite(port)) port = await v({
 			host,
 			port: 3e3,
 			portRange: [3001, 3010]
 		});
-		else if (!strictPort) port = await getPort({
+		else if (!strictPort) port = await v({
 			host,
 			port
 		});
@@ -141,7 +142,7 @@ async function resolveConfig(inlineConfig, command) {
 		wxtModuleDir,
 		root,
 		webExt,
-		runner: command === "serve" ? await resolveRunner(browser, logger, mergedConfig) : createManualRunner(),
+		runner: command === "serve" ? await resolveRunner(browser, logger, webExt.config) : createManualRunner(),
 		srcDir,
 		typesDir,
 		wxtDir,
@@ -341,17 +342,14 @@ async function getUnimportOptions(wxtDir, srcDir, logger, config) {
 	return defu(config.imports ?? {}, defaultOptions);
 }
 async function getUnimportEslintOptions(logger, wxtDir, options) {
-	const inlineEnabled = options === false ? false : options?.eslintrc?.enabled ?? "auto";
+	const inlineEnabled = options === false ? false : options?.eslintrc?.enabled ?? true;
 	const version = await getEslintVersion();
 	const major = parseInt(version[0]);
 	let enabled;
 	switch (inlineEnabled) {
-		case "auto":
+		case "auto": logger.warn(`\`imports.eslintrc.enabled: "auto"\` is deprecated. Use \`true\` instead.`);
 		case true:
-			if (isNaN(major)) {
-				if (inlineEnabled === true) logger.warn("Could not determine installed ESLint version, `eslint-auto-imports.mjs` not generated");
-				enabled = false;
-			} else if (major <= 8) enabled = 8;
+			if (major <= 8) enabled = 8;
 			else if (major >= 9) enabled = 9;
 			else enabled = false;
 			break;
@@ -372,7 +370,7 @@ async function isDirMissing(dir) {
 	return !await pathExists(dir);
 }
 function logMissingDir(logger, name, expected) {
-	logger.warn(`${name} directory not found: ./${normalizePath(path.relative(process.cwd(), expected))}`);
+	logger.warnOnce(`${name} directory not found: ./${normalizePath(path.relative(process.cwd(), expected))}`);
 }
 /** Map of `ConfigEnv` commands to their default modes. */
 const COMMAND_MODES = {
@@ -426,12 +424,12 @@ async function resolveWxtUserModules(root, modulesDir, modules = []) {
 	}));
 	return [...npmModules, ...localModules];
 }
-async function resolveRunner(browser, logger, mergedConfig) {
+async function resolveRunner(browser, logger, webExt) {
 	if (browser === "safari") return createSafariRunner();
-	if (isWsl) return createWslRunner();
+	if (d) return createWslRunner();
 	try {
 		const { createWebExtRunner } = await import("./runners/web-ext.mjs");
-		return mergedConfig.webExt?.disabled ? createManualRunner() : createWebExtRunner();
+		return webExt.disabled ? createManualRunner() : createWebExtRunner();
 	} catch (err) {
 		if (err?.code !== "ERR_MODULE_NOT_FOUND") throw err;
 		logger.debug("Error loading the web-ext runner", err);

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

@@ -1,12 +1,12 @@
 import { CSS_EXTENSIONS_PATTERN } from "../paths.mjs";
 import { getEntrypointName, isHtmlEntrypoint, isJsEntrypoint, resolvePerBrowserOptions } from "../entrypoints.mjs";
+import { s } from "../../../inline/scule/index.mjs";
 import { VIRTUAL_NOOP_BACKGROUND_MODULE_ID } from "../constants.mjs";
 import { wxt } from "../../wxt.mjs";
 import { mkdir, readFile, writeFile } from "node:fs/promises";
 import { glob } from "tinyglobby";
 import { relative, resolve } from "path";
 import { parseHTML } from "linkedom";
-import { camelCase } from "scule";
 import { styleText } from "node:util";
 import picomatch from "picomatch";
 import JSON5 from "json5";
@@ -118,8 +118,8 @@ async function importHtmlEntrypoint(info) {
 	metaTags.forEach((tag) => {
 		const name = tag.name;
 		let key;
-		if (name.startsWith("manifest.")) key = camelCase(name.slice(9));
-		else if (name.startsWith("wxt.")) key = camelCase(name.slice(4));
+		if (name.startsWith("manifest.")) key = s(name.slice(9));
+		else if (name.startsWith("wxt.")) key = s(name.slice(4));
 		else return;
 		try {
 			res[key] = JSON5.parse(tag.content);

package/dist/core/utils/building/rebuild.mjs

@@ -1,8 +1,8 @@
 import { wxt } from "../../wxt.mjs";
 import { buildEntrypoints } from "./build-entrypoints.mjs";
+import { createSpinner } from "../spinner.mjs";
 import { generateWxtDir } from "../../generate-wxt-dir.mjs";
 import { generateManifest, writeManifest } from "../manifest.mjs";
-import { createSpinner } from "nanospinner";
 //#region src/core/utils/building/rebuild.ts
 /**
 * Given a configuration, list of entrypoints, and an existing, partial output,

package/dist/core/utils/fs.mjs

@@ -32,5 +32,10 @@ async function getPublicFiles() {
 		expandDirectories: false
 	})).map(unnormalizePath);
 }
+function getBytesDisplay(bytes) {
+	if (bytes < 1e3) return `${bytes} B`;
+	if (bytes < 999995) return `${(bytes / 1e3).toFixed(2)} kB`;
+	return `${(bytes / 1e6).toFixed(2)} MB`;
+}
 //#endregion
-export { getPublicFiles, pathExists, readJson, writeFileIfDifferent };
+export { getBytesDisplay, getPublicFiles, pathExists, readJson, writeFileIfDifferent };

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

@@ -1,3 +1,4 @@
+import "./wxtLogger.mjs";
 import "./printTable.mjs";
 import "./printFileList.mjs";
 import "./printBuildSummary.mjs";

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

@@ -1,9 +1,9 @@
 import { wxt } from "../../wxt.mjs";
+import { getBytesDisplay } from "../fs.mjs";
 import { printTable } from "./printTable.mjs";
 import { lstat } from "node:fs/promises";
 import path from "node:path";
 import { styleText } from "node:util";
-import { filesize } from "filesize";
 //#region src/core/utils/log/printFileList.ts
 async function printFileList(log, header, baseDir, files) {
 	let totalSize = 0;
@@ -15,13 +15,13 @@ async function printFileList(log, header, baseDir, files) {
 		try {
 			const stats = await lstat(file);
 			totalSize += stats.size;
-			size = String(filesize(stats.size));
+			size = getBytesDisplay(stats.size);
 		} catch (ex) {
 			wxt.logger.warn(`Could not get stats of '${file}' error: ${ex}`);
 		}
 		return [`${styleText("gray", prefix)} ${styleText("dim", parts[0])}${styleText(chunkColor, parts[1])}`, styleText("dim", size)];
 	}));
-	fileRows.push([`${styleText("cyan", "Σ Total size:")} ${String(filesize(totalSize))}`]);
+	fileRows.push([`${styleText("cyan", "Σ Total size:")} ${getBytesDisplay(totalSize)}`]);
 	printTable(log, header, fileRows);
 }
 const DEFAULT_COLOR = "blue";

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

@@ -0,0 +1,32 @@
+//#region src/core/utils/log/wxtLogger.ts
+const warned = /* @__PURE__ */ new Set();
+/**
+* Wraps a `Logger` with a `warnOnce`. The set of already-warned messages is
+* scoped to this wrapper instance, so it's reset whenever a new wrapper is
+* created, e.g. once per `resolveConfig` call.
+*/
+function createWxtLogger(logger) {
+	return {
+		get level() {
+			return logger.level;
+		},
+		set level(value) {
+			logger.level = value;
+		},
+		debug: logger.debug,
+		log: logger.log.bind(logger),
+		info: logger.info.bind(logger),
+		warn: logger.warn.bind(logger),
+		error: logger.error.bind(logger),
+		fatal: logger.fatal.bind(logger),
+		success: logger.success.bind(logger),
+		warnOnce: (...args) => {
+			const key = JSON.stringify(args);
+			if (warned.has(key)) return;
+			warned.add(key);
+			logger.warn(...args);
+		}
+	};
+}
+//#endregion
+export { createWxtLogger };

package/dist/core/utils/manifest.mjs

@@ -28,7 +28,7 @@ async function generateManifest(allEntrypoints, buildOutput) {
 	let versionName = wxt.config.manifest.version_name ?? wxt.config.manifest.version ?? pkg?.version;
 	if (versionName == null) {
 		versionName = "0.0.0";
-		wxt.logger.warn("Extension version not found, defaulting to \"0.0.0\". Add a version to your `package.json` or `wxt.config.ts` file. For more details, see: https://wxt.dev/guide/key-concepts/manifest.html#version-and-version-name");
+		wxt.logger.warnOnce("Extension version not found, defaulting to \"0.0.0\". Add a version to your `package.json` or `wxt.config.ts` file. For more details, see: https://wxt.dev/guide/key-concepts/manifest.html#version-and-version-name");
 	}
 	const version = wxt.config.manifest.version ?? simplifyVersion(versionName);
 	const baseManifest = {
@@ -42,7 +42,7 @@ async function generateManifest(allEntrypoints, buildOutput) {
 	const userManifest = wxt.config.manifest;
 	if (userManifest.manifest_version) {
 		delete userManifest.manifest_version;
-		wxt.logger.warn("`manifest.manifest_version` config was set, but ignored. To change the target manifest version, use the `manifestVersion` option or the `--mv2`/`--mv3` CLI flags.\nSee https://wxt.dev/guide/essentials/target-different-browsers.html#target-a-manifest-version");
+		wxt.logger.warnOnce("`manifest.manifest_version` config was set, but ignored. To change the target manifest version, use the `manifestVersion` option or the `--mv2`/`--mv3` CLI flags.\nSee https://wxt.dev/guide/essentials/target-different-browsers.html#target-a-manifest-version");
 	}
 	let manifest = defu(userManifest, baseManifest);
 	if (wxt.config.command === "serve" && wxt.config.dev.reloadCommand) if (manifest.commands && Object.values(manifest.commands).filter((command) => command.suggested_key).length >= 4) warnings.push(["Extension already has 4 registered commands with suggested keys, WXT's reload command is disabled"]);
@@ -55,8 +55,8 @@ async function generateManifest(allEntrypoints, buildOutput) {
 	}
 	manifest.version = version;
 	manifest.version_name = wxt.config.browser === "firefox" || versionName === version ? void 0 : versionName;
-	if (wxt.config.browser === "firefox" && !userManifest.browser_specific_settings?.gecko?.data_collection_permissions && !wxt.config.suppressWarnings?.firefoxDataCollection) wxt.logger.warn("Firefox requires `data_collection_permissions` for new extensions from November 3, 2025. Existing extensions are exempt for now.\nFor more details, see: https://extensionworkshop.com/documentation/develop/firefox-builtin-data-consent/\nTo suppress this warning, set `suppressWarnings.firefoxDataCollection` to `true` in your wxt config.\n");
-	if (wxt.config.browser === "firefox" && !manifest.browser_specific_settings?.gecko?.id && !wxt.config.suppressWarnings?.firefoxId) wxt.logger.warn("Firefox requires extension ID for MV3 and recommends it for MV2.\nFor more details, see: https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/browser_specific_settings#id");
+	if (wxt.config.browser === "firefox" && !userManifest.browser_specific_settings?.gecko?.data_collection_permissions && !wxt.config.suppressWarnings?.firefoxDataCollection) wxt.logger.warnOnce("Firefox requires `data_collection_permissions` for new extensions from November 3, 2025. Existing extensions are exempt for now.\nFor more details, see: https://extensionworkshop.com/documentation/develop/firefox-builtin-data-consent/\nTo suppress this warning, set `suppressWarnings.firefoxDataCollection` to `true` in your wxt config.\n");
+	if (wxt.config.browser === "firefox" && !manifest.browser_specific_settings?.gecko?.id && !wxt.config.suppressWarnings?.firefoxId) wxt.logger.warnOnce("Firefox requires extension ID for MV3 and recommends it for MV2.\nFor more details, see: https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/browser_specific_settings#id");
 	addEntrypoints(manifest, entrypoints, buildOutput);
 	if (wxt.config.browser === "firefox") addDiscoveredThemeIcons(manifest, buildOutput);
 	if (wxt.config.command === "serve") addDevModeCsp(manifest);
@@ -190,7 +190,7 @@ function addEntrypoints(manifest, entrypoints, buildOutput) {
 				return map;
 			}, /* @__PURE__ */ new Map());
 			const manifestContentScripts = Array.from(hashToEntrypointsMap.values()).map((scripts) => mapWxtOptionsToContentScript(scripts[0].options, scripts.map((entry) => getEntrypointBundlePath(entry, wxt.config.outDir, ".js")), getContentScriptCssFiles(scripts, cssMap)));
-			if (manifestContentScripts.length >= 0) {
+			if (manifestContentScripts.length > 0) {
 				manifest.content_scripts ??= [];
 				manifest.content_scripts.push(...manifestContentScripts);
 			}
@@ -284,7 +284,7 @@ function getContentScriptCssWebAccessibleResources(contentScripts, contentScript
 		if (cssFile == null) return;
 		resources.push({
 			resources: [cssFile],
-			use_dynamic_url: true,
+			...wxt.config.browser !== "firefox" && wxt.config.browser !== "safari" ? { use_dynamic_url: true } : {},
 			matches: script.options.matches?.map((matchPattern) => stripPathFromMatchPattern(matchPattern)) ?? []
 		});
 	});

package/dist/core/utils/paths.mjs

@@ -1,12 +1,12 @@
+import normalize_path_default from "../../inline/normalize-path/index.mjs";
 import path from "node:path";
-import normalize from "normalize-path";
 //#region src/core/utils/paths.ts
 /**
 * Converts system paths to normalized bundler path. On Windows, this returns
 * paths with `/` instead of `\`.
 */
 function normalizePath(path) {
-	return normalize(path);
+	return normalize_path_default(path);
 }
 /**
 * Given a normalized path, convert it to the system path style. On Windows,

package/dist/core/utils/spinner.mjs

@@ -0,0 +1,69 @@
+import { styleText } from "node:util";
+//#region src/core/utils/spinner.ts
+function createSpinner(initialText = "", options = {}) {
+	const { color = "cyan" } = options;
+	const frames = [
+		"⠋",
+		"⠙",
+		"⠹",
+		"⠸",
+		"⠼",
+		"⠴",
+		"⠦",
+		"⠧",
+		"⠇",
+		"⠏"
+	];
+	const FRAME_INTERVAL = 80;
+	let frameIndex = 0;
+	let timer = null;
+	let text = initialText;
+	function render() {
+		const frame = frames[frameIndex % frames.length];
+		const coloredFrame = color ? styleText(color, frame) : frame;
+		process.stdout.write(`\r${coloredFrame} ${text}\x1B[K`);
+	}
+	const spinner = {
+		start(startText) {
+			if (startText !== void 0) text = startText;
+			if (timer) return spinner;
+			process.stdout.write("\x1B[?25l");
+			render();
+			timer = setInterval(() => {
+				frameIndex++;
+				render();
+			}, FRAME_INTERVAL);
+			return spinner;
+		},
+		update(opts = {}) {
+			text = typeof opts === "string" ? opts : opts.text ?? text;
+			if (timer) render();
+			return spinner;
+		},
+		clear() {
+			if (timer) {
+				clearInterval(timer);
+				timer = null;
+			}
+			process.stdout.write("\r\x1B[K");
+			process.stdout.write("\x1B[?25h");
+			return spinner;
+		},
+		stop(finalText = "") {
+			spinner.clear();
+			if (finalText) process.stdout.write(finalText + "\n");
+			return spinner;
+		},
+		success(finalText) {
+			const message = finalText ?? text;
+			return spinner.stop(`${styleText("green", "✔")} ${message}`);
+		},
+		error(finalText) {
+			const message = finalText ?? text;
+			return spinner.stop(`${styleText("red", "✖")} ${message}`);
+		}
+	};
+	return spinner;
+}
+//#endregion
+export { createSpinner };

package/dist/core/utils/strings.mjs

@@ -1,11 +1,11 @@
-import { camelCase } from "scule";
+import { s } from "../../inline/scule/index.mjs";
 //#region src/core/utils/strings.ts
 function kebabCaseAlphanumeric(str) {
 	return str.toLowerCase().replace(/[^a-z0-9-\s]/g, "").replace(/\s+/g, "-");
 }
 /** Return a safe variable name for a given string. */
 function safeVarName(str) {
-	const name = camelCase(kebabCaseAlphanumeric(str));
+	const name = s(kebabCaseAlphanumeric(str));
 	if (name.match(/^[a-z]/)) return name;
 	return "_" + name;
 }

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, FirefoxDataCollectionPermissions, FirefoxDataCollectionType, FsCache, GeneratedPublicFile, GenericEntrypoint, HookResult, InlineConfig, IsolatedWorldContentScriptDefinition, IsolatedWorldContentScriptEntrypointOptions, Logger, MainWorldContentScriptDefinition, MainWorldContentScriptEntrypointOptions, OnContentScriptStopped, OptionsEntrypoint, OptionsEntrypointOptions, OutputAsset, OutputChunk, OutputFile, PerBrowserMap, PerBrowserOption, PopupEntrypoint, PopupEntrypointOptions, PrepareTsconfigs, 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 { BackgroundDefinition, BackgroundEntrypoint, BackgroundEntrypointOptions, BaseContentScriptEntrypointOptions, BaseEntrypoint, BaseEntrypointOptions, BaseScriptEntrypointOptions, BuildOutput, BuildStepOutput, ConfigEnv, ContentScriptDefinition, ContentScriptEntrypoint, CopiedPublicFile, Dependency, Entrypoint, EntrypointGroup, EntrypointInfo, EslintConfigVersion, EslintGlobalsPropValue, Eslintrc, ExtensionRunner, FirefoxDataCollectionPermissions, FirefoxDataCollectionType, FsCache, GeneratedPublicFile, GenericEntrypoint, HookResult, InlineConfig, IsolatedWorldContentScriptDefinition, IsolatedWorldContentScriptEntrypointOptions, Logger, MainWorldContentScriptDefinition, MainWorldContentScriptEntrypointOptions, OnContentScriptStopped, OptionsEntrypoint, OptionsEntrypointOptions, OutputAsset, OutputChunk, OutputFile, PerBrowserMap, PerBrowserOption, PopupEntrypoint, PopupEntrypointOptions, PrepareTsconfigs, 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, WxtLogger, 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";
@@ -10,4 +10,4 @@ import { zip } from "./core/zip.mjs";
 import { normalizePath } from "./core/utils/paths.mjs";
 import { getEntrypointBundlePath } from "./core/utils/entrypoints.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, FirefoxDataCollectionPermissions, FirefoxDataCollectionType, FsCache, GeneratedPublicFile, GenericEntrypoint, HookResult, InlineConfig, IsolatedWorldContentScriptDefinition, IsolatedWorldContentScriptEntrypointOptions, Logger, MainWorldContentScriptDefinition, MainWorldContentScriptEntrypointOptions, OnContentScriptStopped, OptionsEntrypoint, OptionsEntrypointOptions, OutputAsset, OutputChunk, OutputFile, PerBrowserMap, PerBrowserOption, PopupEntrypoint, PopupEntrypointOptions, PrepareTsconfigs, 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, defineWebExtConfig, getEntrypointBundlePath, initialize, normalizePath, prepare, version, zip };
+export { BackgroundDefinition, BackgroundEntrypoint, BackgroundEntrypointOptions, BaseContentScriptEntrypointOptions, BaseEntrypoint, BaseEntrypointOptions, BaseScriptEntrypointOptions, BuildOutput, BuildStepOutput, ConfigEnv, ContentScriptDefinition, ContentScriptEntrypoint, CopiedPublicFile, Dependency, Entrypoint, EntrypointGroup, EntrypointInfo, EslintConfigVersion, EslintGlobalsPropValue, Eslintrc, ExtensionRunner, FirefoxDataCollectionPermissions, FirefoxDataCollectionType, FsCache, GeneratedPublicFile, GenericEntrypoint, HookResult, InlineConfig, IsolatedWorldContentScriptDefinition, IsolatedWorldContentScriptEntrypointOptions, Logger, MainWorldContentScriptDefinition, MainWorldContentScriptEntrypointOptions, OnContentScriptStopped, OptionsEntrypoint, OptionsEntrypointOptions, OutputAsset, OutputChunk, OutputFile, PerBrowserMap, PerBrowserOption, PopupEntrypoint, PopupEntrypointOptions, PrepareTsconfigs, 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, WxtLogger, WxtModule, WxtModuleOptions, WxtModuleSetup, WxtModuleWithMetadata, WxtPackageManager, WxtPlugin, WxtResolvedUnimportOptions, WxtUnimportOptions, WxtViteConfig, build, clean, createServer, defineConfig, defineWebExtConfig, getEntrypointBundlePath, initialize, normalizePath, prepare, version, zip };

package/dist/inline/get-port-please/index.mjs

@@ -0,0 +1,196 @@
+import "node:fs/promises";
+import "node:path";
+import { createServer } from "node:net";
+import { networkInterfaces } from "node:os";
+//#region inline/get-port-please/index.mjs
+const o = new Set([
+	1,
+	7,
+	9,
+	11,
+	13,
+	15,
+	17,
+	19,
+	20,
+	21,
+	22,
+	23,
+	25,
+	37,
+	42,
+	43,
+	53,
+	69,
+	77,
+	79,
+	87,
+	95,
+	101,
+	102,
+	103,
+	104,
+	109,
+	110,
+	111,
+	113,
+	115,
+	117,
+	119,
+	123,
+	135,
+	137,
+	139,
+	143,
+	161,
+	179,
+	389,
+	427,
+	465,
+	512,
+	513,
+	514,
+	515,
+	526,
+	530,
+	531,
+	532,
+	540,
+	548,
+	554,
+	556,
+	563,
+	587,
+	601,
+	636,
+	989,
+	990,
+	993,
+	995,
+	1719,
+	1720,
+	1723,
+	2049,
+	3659,
+	4045,
+	5060,
+	5061,
+	6e3,
+	6566,
+	6665,
+	6666,
+	6667,
+	6668,
+	6669,
+	6697,
+	10080
+]);
+function s(e) {
+	return o.has(e);
+}
+function c(e) {
+	return !s(e);
+}
+var l = class extends Error {
+	constructor(e, t) {
+		super(e, t), this.message = e;
+	}
+	name = `GetPortError`;
+};
+function u(e, t) {
+	e && console.log(`[get-port] ${t}`);
+}
+function d(e, t) {
+	if (t < e) return [];
+	let n = [];
+	for (let r = e; r <= t; r++) n.push(r);
+	return n;
+}
+function f(e, n) {
+	return new Promise((r) => {
+		let i = createServer();
+		i.unref(), i.on(`error`, () => {
+			r(!1);
+		}), i.listen({
+			port: e,
+			host: n
+		}, () => {
+			let { port: e } = i.address();
+			i.close(() => {
+				r(c(e) && e);
+			});
+		});
+	});
+}
+function p(e) {
+	let t = new Set(e);
+	for (let e of Object.values(networkInterfaces())) for (let n of e || []) n.address && !n.internal && !n.address.startsWith(`fe80::`) && !n.address.startsWith(`169.254`) && t.add(n.address);
+	return [...t];
+}
+async function m(e, t) {
+	for (let n of e) {
+		let e = await f(n, t);
+		if (e) return e;
+	}
+}
+function h(e) {
+	return e ? `on host ${JSON.stringify(e)}` : `on any host`;
+}
+const g = /^(?!-)[\d.:A-Za-z-]{1,63}(?<!-)$/;
+function _(e, t, n) {
+	if (e && !g.test(e)) {
+		let r = t ? `0.0.0.0` : `127.0.0.1`;
+		return u(n, `Invalid hostname: ${JSON.stringify(e)}. Using ${JSON.stringify(r)} as fallback.`), r;
+	}
+	return e;
+}
+async function v(e = {}) {
+	(typeof e == `number` || typeof e == `string`) && (e = { port: Number.parseInt(e + ``) || 0 });
+	let t = Number(e.port ?? process.env.PORT), n = !!(e.port || e.ports?.length || e.portRange?.length), r = {
+		random: t === 0,
+		ports: [],
+		portRange: [],
+		alternativePortRange: n ? [] : [3e3, 3100],
+		verbose: !1,
+		...e,
+		port: t,
+		host: _(e.host ?? process.env.HOST, e.public, e.verbose)
+	};
+	if (r.random && !n) return y(r.host);
+	let i = [
+		r.port,
+		...r.ports,
+		...d(...r.portRange)
+	].filter((e) => e ? c(e) ? !0 : (u(r.verbose, `Ignoring unsafe port: ${e}`), !1) : !1);
+	i.length === 0 && i.push(3e3);
+	let a = await m(i, r.host);
+	if (!a && r.alternativePortRange.length > 0 && (a = await m(d(...r.alternativePortRange), r.host), i.length > 0)) {
+		let e = `Unable to find an available port (tried ${i.join(`-`)} ${h(r.host)}).`;
+		a && (e += ` Using alternative port ${a}.`), u(r.verbose, e);
+	}
+	if (!a && e.random !== !1 && (a = await y(r.host), a && u(r.verbose, `Using random port ${a}`)), !a) {
+		let e = [
+			r.port,
+			r.portRange.join(`-`),
+			r.alternativePortRange.join(`-`)
+		].filter(Boolean).join(`, `);
+		throw new l(`Unable to find an available port ${h(r.host)} (tried ${e})`);
+	}
+	return a;
+}
+async function y(e) {
+	let t = await x(0, e);
+	if (t === !1) throw new l(`Unable to find a random port ${h(e)}`);
+	return t;
+}
+async function x(e, t = process.env.HOST, n) {
+	if (t ||= p([void 0, `0.0.0.0`]), !Array.isArray(t)) return f(e, t);
+	for (let r of t) {
+		let t = await f(e, r);
+		if (t === !1) return e < 1024 && n && u(n, `Unable to listen to the privileged port ${e} ${h(r)}`), !1;
+		e === 0 && t !== 0 && (e = t);
+	}
+	return e;
+}
+//#endregion
+export { v };

package/dist/inline/is-wsl/index.mjs

@@ -0,0 +1,44 @@
+import n from "node:fs";
+import t from "node:os";
+import e from "node:process";
+//#region inline/is-wsl/index.mjs
+let r;
+function i() {
+	try {
+		return n.statSync(`/.dockerenv`), !0;
+	} catch {
+		return !1;
+	}
+}
+function a() {
+	try {
+		return n.readFileSync(`/proc/self/cgroup`, `utf8`).includes(`docker`);
+	} catch {
+		return !1;
+	}
+}
+function o() {
+	return r === void 0 && (r = i() || a()), r;
+}
+let s;
+const c = () => {
+	try {
+		return n.statSync(`/run/.containerenv`), !0;
+	} catch {
+		return !1;
+	}
+};
+function l() {
+	return s === void 0 && (s = c() || o()), s;
+}
+const u = () => {
+	if (e.platform !== `linux`) return !1;
+	if (t.release().toLowerCase().includes(`microsoft`)) return !l();
+	try {
+		if (n.readFileSync(`/proc/version`, `utf8`).toLowerCase().includes(`microsoft`)) return !l();
+	} catch {}
+	return n.existsSync(`/proc/sys/fs/binfmt_misc/WSLInterop`) || n.existsSync(`/run/WSL`) ? !l() : !1;
+};
+var d = e.env.__IS_WSL_TEST__ ? u : u();
+//#endregion
+export { d };

package/dist/inline/normalize-path/index.mjs

@@ -0,0 +1,23 @@
+var normalize_path_default = ((e, t) => () => (t || e((t = { exports: {} }).exports, t), t.exports))(((e, t) => {
+	/*!
+	* normalize-path <https://github.com/jonschlinkert/normalize-path>
+	*
+	* Copyright (c) 2014-2018, Jon Schlinkert.
+	* Released under the MIT License.
+	*/
+	t.exports = function(e, t) {
+		if (typeof e != `string`) throw TypeError(`expected path to be a string`);
+		if (e === `\\` || e === `/`) return `/`;
+		var n = e.length;
+		if (n <= 1) return e;
+		var r = ``;
+		if (n > 4 && e[3] === `\\`) {
+			var i = e[2];
+			(i === `?` || i === `.`) && e.slice(0, 2) === `\\\\` && (e = e.slice(2), r = `//`);
+		}
+		var a = e.split(/[/\\]+/);
+		return t !== !1 && a[a.length - 1] === `` && a.pop(), r + a.join(`/`);
+	};
+}))();
+//#endregion
+export { normalize_path_default as default };

package/dist/inline/ohash/index.mjs

@@ -0,0 +1,113 @@
+import { createHash } from "node:crypto";
+//#region inline/ohash/index.mjs
+function t(e) {
+	return typeof e == `string` ? `'${e}'` : new n().serialize(e);
+}
+const n = function() {
+	class e {
+		#e = /* @__PURE__ */ new Map();
+		compare(e, t) {
+			let n = typeof e, r = typeof t;
+			return n === `string` && r === `string` ? e.localeCompare(t) : n === `number` && r === `number` ? e - t : String.prototype.localeCompare.call(this.serialize(e, !0), this.serialize(t, !0));
+		}
+		serialize(e, t) {
+			if (e === null) return `null`;
+			switch (typeof e) {
+				case `string`: return t ? e : `'${e}'`;
+				case `bigint`: return `${e}n`;
+				case `object`: return this.$object(e);
+				case `function`: return this.$function(e);
+			}
+			return String(e);
+		}
+		serializeObject(e) {
+			let t = Object.prototype.toString.call(e);
+			if (t !== `[object Object]`) return this.serializeBuiltInType(t.length < 10 ? `unknown:${t}` : t.slice(8, -1), e);
+			let n = e.constructor, r = n === Object || n === void 0 ? `` : n.name;
+			if (r !== `` && globalThis[r] === n) return this.serializeBuiltInType(r, e);
+			if (typeof e.toJSON == `function`) {
+				let t = e.toJSON();
+				return r + (typeof t == `object` && t ? this.$object(t) : `(${this.serialize(t)})`);
+			}
+			return this.serializeObjectEntries(r, Object.entries(e));
+		}
+		serializeBuiltInType(e, t) {
+			let n = this[`$` + e];
+			if (n) return n.call(this, t);
+			if (typeof t?.entries == `function`) return this.serializeObjectEntries(e, t.entries());
+			throw Error(`Cannot serialize ${e}`);
+		}
+		serializeObjectEntries(e, t) {
+			let n = Array.from(t).sort((e, t) => this.compare(e[0], t[0])), r = `${e}{`;
+			for (let e = 0; e < n.length; e++) {
+				let [t, i] = n[e];
+				r += `${this.serialize(t, !0)}:${this.serialize(i)}`, e < n.length - 1 && (r += `,`);
+			}
+			return r + `}`;
+		}
+		$object(e) {
+			let t = this.#e.get(e);
+			return t === void 0 && (this.#e.set(e, `#${this.#e.size}`), t = this.serializeObject(e), this.#e.set(e, t)), t;
+		}
+		$function(e) {
+			let t = Function.prototype.toString.call(e);
+			return t.slice(-15) === `[native code] }` ? `${e.name || ``}()[native]` : `${e.name}(${e.length})${t.replace(/\s*\n\s*/g, ``)}`;
+		}
+		$Array(e) {
+			let t = `[`;
+			for (let n = 0; n < e.length; n++) t += this.serialize(e[n]), n < e.length - 1 && (t += `,`);
+			return t + `]`;
+		}
+		$Date(e) {
+			try {
+				return `Date(${e.toISOString()})`;
+			} catch {
+				return `Date(null)`;
+			}
+		}
+		$ArrayBuffer(e) {
+			return `ArrayBuffer[${new Uint8Array(e).join(`,`)}]`;
+		}
+		$Set(e) {
+			return `Set${this.$Array(Array.from(e).sort((e, t) => this.compare(e, t)))}`;
+		}
+		$Map(e) {
+			return this.serializeObjectEntries(`Map`, e.entries());
+		}
+	}
+	for (let t of [
+		`Error`,
+		`RegExp`,
+		`URL`
+	]) e.prototype[`$` + t] = function(e) {
+		return `${t}(${e})`;
+	};
+	for (let t of [
+		`Int8Array`,
+		`Uint8Array`,
+		`Uint8ClampedArray`,
+		`Int16Array`,
+		`Uint16Array`,
+		`Int32Array`,
+		`Uint32Array`,
+		`Float32Array`,
+		`Float64Array`
+	]) e.prototype[`$` + t] = function(e) {
+		return `${t}[${e.join(`,`)}]`;
+	};
+	for (let t of [`BigInt64Array`, `BigUint64Array`]) e.prototype[`$` + t] = function(e) {
+		return `${t}[${e.join(`n,`)}${e.length > 0 ? `n` : ``}]`;
+	};
+	return e;
+}();
+const i = globalThis.process?.getBuiltinModule?.(`crypto`)?.hash, a = `sha256`, o = `base64url`;
+function s(t) {
+	if (i) return i(a, t, o);
+	let n = createHash(a).update(t);
+	return globalThis.process?.versions?.webcontainer ? n.digest().toString(o) : n.digest(o);
+}
+function c(e) {
+	return s(t(e));
+}
+//#endregion
+export { c };

package/dist/inline/scule/index.mjs

@@ -0,0 +1,50 @@
+//#region inline/scule/index.mjs
+const e = /\d/, t = [
+	`-`,
+	`_`,
+	`/`,
+	`.`
+];
+function n(t = ``) {
+	if (!e.test(t)) return t !== t.toLowerCase();
+}
+function r(e, r) {
+	let i = r ?? t, a = [];
+	if (!e || typeof e != `string`) return a;
+	let o = ``, s, c;
+	for (let t of e) {
+		let e = i.includes(t);
+		if (e === !0) {
+			a.push(o), o = ``, s = void 0;
+			continue;
+		}
+		let r = n(t);
+		if (c === !1) {
+			if (s === !1 && r === !0) {
+				a.push(o), o = t, s = r;
+				continue;
+			}
+			if (s === !0 && r === !1 && o.length > 1) {
+				let e = o.at(-1);
+				a.push(o.slice(0, Math.max(0, o.length - 1))), o = e + t, s = r;
+				continue;
+			}
+		}
+		o += t, s = r, c = e;
+	}
+	return a.push(o), a;
+}
+function i(e) {
+	return e ? e[0].toUpperCase() + e.slice(1) : ``;
+}
+function a(e) {
+	return e ? e[0].toLowerCase() + e.slice(1) : ``;
+}
+function o(e, t) {
+	return e ? (Array.isArray(e) ? e : r(e)).map((e) => i(t?.normalize ? e.toLowerCase() : e)).join(``) : ``;
+}
+function s(e, t) {
+	return a(o(e || ``, t));
+}
+//#endregion
+export { s };

package/dist/types.d.mts

@@ -634,6 +634,17 @@ interface Logger {
   success(...args: any[]): void;
   level: LogLevel;
 }
+/**
+ * The logger available at `wxt.logger`. Extends {@link Logger} with a `warnOnce`
+ * which only logs a message once per process.
+ */
+interface WxtLogger extends Logger {
+  /**
+   * Same as {@link Logger.warn}, but only logs a given message once per process,
+   * even if called multiple times with the same arguments.
+   */
+  warnOnce(...args: any[]): void;
+}
 interface BaseEntrypointOptions {
   /**
    * List of target browsers to include this entrypoint in. Defaults to being
@@ -1122,21 +1133,6 @@ interface WebExtConfig {
    *   default_directory: "/my/custom/dir",
    *   },
    *   }
-   *
-   * @default
-   * // Enable dev mode and allow content script sourcemaps
-   * {
-   *   devtools: {
-   *     synced_preferences_sync_disabled: {
-   *       skipContentScripts: false,
-   *     },
-   *   }
-   *   extensions: {
-   *     ui: {
-   *       developer_mode: true,
-   *     },
-   *   }
-   * }
    */
   chromiumPref?: Record<string, any>;
   /**
@@ -1381,8 +1377,8 @@ interface Wxt {
   hooks: Hookable<WxtHooks>;
   /** Alias for `wxt.hooks.hook(...)`. */
   hook: Hookable<WxtHooks>['hook'];
-  /** Alias for config.logger */
-  logger: Logger;
+  /** Wraps `config.logger`, adding `warnOnce`. */
+  logger: WxtLogger;
   /** Reload config file and update `wxt.config` with the result. */
   reloadConfig: () => Promise<void>;
   /** Package manager utilities. */
@@ -1433,7 +1429,7 @@ interface ResolvedConfig$1 {
   targetBrowsers: TargetBrowser[];
   manifestVersion: TargetManifestVersion;
   env: ConfigEnv;
-  logger: Logger;
+  logger: WxtLogger;
   imports: WxtResolvedUnimportOptions;
   manifest: UserManifest;
   fsCache: FsCache;
@@ -1526,28 +1522,29 @@ interface ExtensionRunner {
   canOpen?(): boolean;
 }
 type EslintGlobalsPropValue = boolean | 'readonly' | 'readable' | 'writable' | 'writeable';
+type EslintConfigVersion = 8 | 9;
 interface Eslintrc {
   /**
-   * When true, generates a file that can be used by ESLint to know which
-   * variables are valid globals.
+   * Determines if and in what format a config file will be generated to inform
+   * ESLint of unimport globals.
    *
-   * - `'auto'`: Check if eslint is installed, and if it is, generate a compatible
-   *   config file.
-   * - `true`: Same as `'auto'`.
-   * - `false`: Don't generate the file.
-   * - `8`: Generate a config file compatible with ESLint 8.
-   * - `9`: Generate a config file compatible with ESLint 9.
+   * - `true`: If eslint is installed, generate a compatible config file based on
+   *   the installed version.
+   * - `false`: Never generate the file.
+   * - `8`: Generate an eslintrc file compatible with ESLint &lte; 8.
+   * - `9`: Generate a flat config file compatible with ESLint &gte; 9.
+   * - `'auto'` (Deprecated): Same as `true`.
    *
-   * @default 'auto'
+   * @default true
    */
-  enabled?: 'auto' | boolean | 8 | 9;
+  enabled?: boolean | 'auto' | EslintConfigVersion;
   /**
    * File path to save the generated eslint config.
    *
    * Default depends on version of ESLint used:
    *
-   * - 9 and above: './.wxt/eslint-auto-imports.mjs'
-   * - 8 and below: './.wxt/eslintrc-auto-import.json'
+   * - &gte; 9: './.wxt/eslint-auto-imports.mjs'
+   * - &lte; 8: './.wxt/eslintrc-auto-import.json'
    */
   filePath?: string;
   /** @default true */
@@ -1555,7 +1552,7 @@ interface Eslintrc {
 }
 interface ResolvedEslintrc {
   /** False if disabled, otherwise the major version of ESLint installed */
-  enabled: false | 8 | 9;
+  enabled: false | EslintConfigVersion;
   /** Absolute path */
   filePath: string;
   globalsPropValue: EslintGlobalsPropValue;
@@ -1701,4 +1698,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, FirefoxDataCollectionPermissions, FirefoxDataCollectionType, FsCache, GeneratedPublicFile, GenericEntrypoint, HookResult, InlineConfig, IsolatedWorldContentScriptDefinition, IsolatedWorldContentScriptEntrypointOptions, Logger, MainWorldContentScriptDefinition, MainWorldContentScriptEntrypointOptions, OnContentScriptStopped, OptionsEntrypoint, OptionsEntrypointOptions, OutputAsset, OutputChunk, OutputFile, PerBrowserMap, PerBrowserOption, PopupEntrypoint, PopupEntrypointOptions, PrepareTsconfigs, 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 };
+export { BackgroundDefinition, BackgroundEntrypoint, BackgroundEntrypointOptions, BaseContentScriptEntrypointOptions, BaseEntrypoint, BaseEntrypointOptions, BaseScriptEntrypointOptions, BuildOutput, BuildStepOutput, ConfigEnv, ContentScriptDefinition, ContentScriptEntrypoint, CopiedPublicFile, Dependency, Entrypoint, EntrypointGroup, EntrypointInfo, EslintConfigVersion, EslintGlobalsPropValue, Eslintrc, ExtensionRunner, FirefoxDataCollectionPermissions, FirefoxDataCollectionType, FsCache, GeneratedPublicFile, GenericEntrypoint, HookResult, InlineConfig, IsolatedWorldContentScriptDefinition, IsolatedWorldContentScriptEntrypointOptions, Logger, MainWorldContentScriptDefinition, MainWorldContentScriptEntrypointOptions, OnContentScriptStopped, OptionsEntrypoint, OptionsEntrypointOptions, OutputAsset, OutputChunk, OutputFile, PerBrowserMap, PerBrowserOption, PopupEntrypoint, PopupEntrypointOptions, PrepareTsconfigs, 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, WxtLogger, WxtModule, WxtModuleOptions, WxtModuleSetup, WxtModuleWithMetadata, WxtPackageManager, WxtPlugin, WxtResolvedUnimportOptions, WxtUnimportOptions, WxtViteConfig };

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

@@ -6,6 +6,8 @@ import * as _$wxt_browser0 from "wxt/browser";
 /**
  * Create a content script UI using an iframe.
  *
+ * @param options - Iframe options. See {@link ContentScriptUiOptions} for shared
+ *   positioning, anchoring, `append`, and removal options.
  * @see https://wxt.dev/guide/essentials/content-scripts.html#iframe
  */
 declare function createIframeUi<TMounted>(ctx: ContentScriptContext, options: IframeContentScriptUiOptions<TMounted>): IframeContentScriptUi<TMounted>;

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

@@ -5,6 +5,8 @@ import { browser } from "wxt/browser";
 /**
 * Create a content script UI using an iframe.
 *
+* @param options - Iframe options. See {@link ContentScriptUiOptions} for shared
+*   positioning, anchoring, `append`, and removal options.
 * @see https://wxt.dev/guide/essentials/content-scripts.html#iframe
 */
 function createIframeUi(ctx, options) {

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

@@ -5,6 +5,8 @@ import { ContentScriptUi, ContentScriptUiOptions } from "./types.mjs";
 /**
  * Create a content script UI without any isolation.
  *
+ * @param options - Integrated UI options. See {@link ContentScriptUiOptions} for
+ *   shared positioning, anchoring, `append`, and removal options.
  * @see https://wxt.dev/guide/essentials/content-scripts.html#integrated
  */
 declare function createIntegratedUi<TMounted>(ctx: ContentScriptContext, options: IntegratedContentScriptUiOptions<TMounted>): IntegratedContentScriptUi<TMounted>;

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

@@ -3,6 +3,8 @@ import { applyPosition, createMountFunctions, mountUi } from "./shared.mjs";
 /**
 * Create a content script UI without any isolation.
 *
+* @param options - Integrated UI options. See {@link ContentScriptUiOptions} for
+*   shared positioning, anchoring, `append`, and removal options.
 * @see https://wxt.dev/guide/essentials/content-scripts.html#integrated
 */
 function createIntegratedUi(ctx, options) {

package/dist/utils/content-script-ui/shadow-root.d.mts

@@ -8,6 +8,8 @@ import { ContentScriptUi, ContentScriptUiOptions } from "./types.mjs";
  *
  * > This function is async because it has to load the CSS via a network call.
  *
+ * @param options - Shadow root options. See {@link ContentScriptUiOptions} for
+ *   shared positioning, anchoring, `append`, and removal options.
  * @see https://wxt.dev/guide/essentials/content-scripts.html#shadow-root
  */
 declare function createShadowRootUi<TMounted>(ctx: ContentScriptContext, options: ShadowRootContentScriptUiOptions<TMounted>): Promise<ShadowRootContentScriptUi<TMounted>>;

package/dist/utils/content-script-ui/shadow-root.mjs

@@ -11,6 +11,8 @@ import { createIsolatedElement } from "@webext-core/isolated-element";
 *
 * > This function is async because it has to load the CSS via a network call.
 *
+* @param options - Shadow root options. See {@link ContentScriptUiOptions} for
+*   shared positioning, anchoring, `append`, and removal options.
 * @see https://wxt.dev/guide/essentials/content-scripts.html#shadow-root
 */
 async function createShadowRootUi(ctx, options) {

package/dist/version.mjs

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "wxt",
   "type": "module",
-  "version": "0.21.3",
+  "version": "0.21.4",
   "description": "⚡ Next-gen Web Extension Framework",
   "license": "MIT",
   "scripts": {
@@ -22,7 +22,7 @@
     "@webext-core/fake-browser": "^2.0.1",
     "@webext-core/isolated-element": "^1.1.3 || ^2 || ^3",
     "@webext-core/match-patterns": "^2.0.0",
-    "@wxt-dev/browser": "^0.2.2",
+    "@wxt-dev/browser": ">=0.1",
     "@wxt-dev/storage": "^1.0.0",
     "c12": "^3.3.4",
     "cac": "^6.7.14 || ^7.0.0",
@@ -31,23 +31,17 @@
     "defu": "^6.1.4",
     "dotenv-expand": "^13.0.0",
     "filesize": "^11.0.17",
-    "get-port-please": "^3.2.0",
     "giget": "^1.2.3 || ^2.0.0 || ^3.0.0",
     "hookable": "^6.1.0",
-    "is-wsl": "^3.1.1",
     "json5": "^2.2.3",
     "linkedom": "^0.18.12",
     "magicast": "^0.5.2",
-    "nano-spawn": "^2.0.0",
-    "nanospinner": "^1.2.2",
-    "normalize-path": "^3.0.0",
     "nypm": "^0.6.5",
-    "ohash": "^2.0.11",
     "picomatch": "^4.0.3",
     "publish-browser-extension": "^5.1.0 || ^6.0.0",
-    "scule": "^1.3.0",
     "superlock": "^1.3.2",
     "tiny-open": "^1.3.0",
+    "tinyexec": "^1.2.4",
     "tinyglobby": "^0.2.16",
     "unimport": "^3.13.1 || ^4.0.0 || ^5.0.0 || ^6.0.0"
   },
@@ -79,10 +73,15 @@
     "@types/prompts": "^2.4.9",
     "eslint": "^10.1.0",
     "extract-zip": "^2.0.1",
+    "get-port-please": "^3.2.0",
     "happy-dom": "^20.8.3",
+    "is-wsl": "^3.1.1",
     "lodash.merge": "^4.6.2",
+    "normalize-path": "^3.0.0",
+    "ohash": "^2.0.11",
     "oxlint": "^1.63.0",
     "publint": "^0.3.18",
+    "scule": "^1.3.0",
     "tsdown": "^0.21.0",
     "typescript": "^6.0.3",
     "vite": "^8.2.0",