wxt 0.21.0 → 0.21.2

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

@@ -1,6 +1,5 @@
 import { dedupeDependencies, npm } from "./npm.mjs";
 import spawn from "nano-spawn";
-
 //#region src/core/package-managers/yarn.ts
 const yarn = {
 	overridesKey: "resolutions",
@@ -29,6 +28,5 @@ const yarn = {
 		return dedupeDependencies(dependencies);
 	}
 };
-
 //#endregion
-export { yarn };
+export { yarn };

package/dist/core/prepare.mjs

@@ -2,13 +2,11 @@ import { registerWxt, wxt } from "./wxt.mjs";
 import { findEntrypoints } from "./utils/building/find-entrypoints.mjs";
 import { generateWxtDir } from "./generate-wxt-dir.mjs";
 import "./utils/building/index.mjs";
-
 //#region src/core/prepare.ts
 async function prepare(config) {
 	await registerWxt("build", config);
 	wxt.logger.info("Generating types...");
 	await generateWxtDir(await findEntrypoints());
 }
-
 //#endregion
-export { prepare };
+export { prepare };

package/dist/core/resolve-config.mjs

@@ -1,12 +1,15 @@
+import { builtinModules } from "../builtin-modules/index.mjs";
 import { normalizePath } from "./utils/paths.mjs";
-import { createFsCache } from "./utils/cache.mjs";
 import "./utils/index.mjs";
-import { builtinModules } from "../builtin-modules/index.mjs";
+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 fs from "fs-extra";
-import glob from "fast-glob";
+import { createSafariRunner } from "./runners/safari.mjs";
+import { createWslRunner } from "./runners/wsl.mjs";
+import { createManualRunner } from "./runners/manual.mjs";
+import { pathExists } from "./utils/fs.mjs";
+import { glob } from "tinyglobby";
 import path from "node:path";
 import { loadConfig } from "c12";
 import { resolve as resolve$1 } from "import-meta-resolve";
@@ -14,14 +17,15 @@ 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 results, resolve any
-* relative paths, and apply any defaults.
+* Given an inline config, discover the config file if necessary, merge the
+* results, resolve any relative paths, and apply any defaults.
 *
-* Inline config always has priority over user config. Cli flags are passed as inline config if set.
-* If unset, undefined is passed in, letting this function decide default values.
+* Inline config always has priority over user config. Cli flags are passed as
+* inline config if set. If unset, undefined is passed in, letting this function
+* decide default values.
 */
 async function resolveConfig(inlineConfig, command) {
 	let userConfig = {};
@@ -69,14 +73,13 @@ async function resolveConfig(inlineConfig, command) {
 	const outDirTemplate = (mergedConfig.outDirTemplate ?? `${browser}-mv${manifestVersion}${modeSuffix}`).replaceAll("{{browser}}", browser).replaceAll("{{manifestVersion}}", manifestVersion.toString()).replaceAll("{{modeSuffix}}", modeSuffix).replaceAll("{{mode}}", mode).replaceAll("{{command}}", command);
 	const outDir = path.resolve(outBaseDir, outDirTemplate);
 	const reloadCommand = mergedConfig.dev?.reloadCommand ?? "Alt+R";
-	if (inlineConfig.runner != null || userConfig.runner != null) logger.warn("`InlineConfig#runner` is deprecated, use `InlineConfig#webExt` instead. See https://wxt.dev/guide/resources/upgrading.html#v0-19-0-rarr-v0-20-0");
-	const runnerConfig = await loadConfig({
+	const webExt = await loadConfig({
 		name: "web-ext",
 		cwd: root,
 		globalRc: true,
 		rcFile: ".webextrc",
-		overrides: inlineConfig.webExt ?? inlineConfig.runner,
-		defaults: userConfig.webExt ?? userConfig.runner
+		overrides: inlineConfig.webExt,
+		defaults: userConfig.webExt
 	});
 	const alias = Object.fromEntries(Object.entries({
 		...mergedConfig.alias,
@@ -87,15 +90,19 @@ async function resolveConfig(inlineConfig, command) {
 	}).map(([key, value]) => [key, path.resolve(root, value)]));
 	let devServerConfig;
 	if (command === "serve") {
-		if (mergedConfig.dev?.server?.hostname) logger.warn(`The 'hostname' option is deprecated, please use 'host' or 'origin' depending on your circumstances.`);
-		const host = mergedConfig.dev?.server?.host ?? mergedConfig.dev?.server?.hostname ?? "localhost";
+		const host = mergedConfig.dev?.server?.host ?? "localhost";
 		let port = mergedConfig.dev?.server?.port;
-		const origin = mergedConfig.dev?.server?.origin ?? mergedConfig.dev?.server?.hostname ?? "localhost";
+		const origin = mergedConfig.dev?.server?.origin ?? "localhost";
+		const strictPort = mergedConfig.dev?.server?.strictPort ?? false;
 		if (port == null || !isFinite(port)) port = await getPort({
 			host,
 			port: 3e3,
 			portRange: [3001, 3010]
 		});
+		else if (!strictPort) port = await getPort({
+			host,
+			port
+		});
 		const originWithProtocolAndPort = [
 			origin.match(/^https?:\/\//) ? "" : "http://",
 			origin,
@@ -105,6 +112,7 @@ async function resolveConfig(inlineConfig, command) {
 			host,
 			port,
 			origin: originWithProtocolAndPort,
+			strictPort,
 			watchDebounce: safeStringToNumber(process.env.WXT_WATCH_DEBOUNCE) ?? 800
 		};
 	}
@@ -133,7 +141,8 @@ async function resolveConfig(inlineConfig, command) {
 		publicDir,
 		wxtModuleDir,
 		root,
-		runnerConfig,
+		webExt,
+		runner: command === "serve" ? await resolveRunner(browser, logger, mergedConfig) : createManualRunner(),
 		srcDir,
 		typesDir,
 		wxtDir,
@@ -142,6 +151,8 @@ async function resolveConfig(inlineConfig, command) {
 		userConfigMetadata: userConfigMetadata ?? {},
 		alias,
 		experimental: defu(mergedConfig.experimental, {}),
+		suppressWarnings: mergedConfig.suppressWarnings ?? {},
+		watchOptions: mergedConfig.watchOptions ?? {},
 		dev: {
 			server: devServerConfig,
 			reloadCommand
@@ -158,7 +169,8 @@ async function resolveManifestConfig(env, manifest) {
 	return typeof manifest === "function" ? await manifest(env) : await (manifest ?? {});
 }
 /**
-* Merge the inline config and user config. Inline config is given priority. Defaults are not applied here.
+* Merge the inline config and user config. Inline config is given priority.
+* Defaults are not applied here.
 */
 async function mergeInlineConfig(inlineConfig, userConfig) {
 	const imports = inlineConfig.imports === false || userConfig.imports === false ? false : userConfig.imports == null && inlineConfig.imports == null ? void 0 : defu(inlineConfig.imports ?? {}, userConfig.imports ?? {});
@@ -179,10 +191,10 @@ function resolveZipConfig(root, browser, outBaseDir, mergedConfig) {
 	const downloadedPackagesDir = path.resolve(root, ".wxt/local_modules");
 	return {
 		name: void 0,
-		sourcesTemplate: "{{name}}-{{version}}-sources.zip",
-		artifactTemplate: "{{name}}-{{version}}-{{browser}}.zip",
+		sourcesTemplate: "{{name}}-{{packageVersion}}-sources{{modeSuffix}}.zip",
+		artifactTemplate: "{{name}}-{{packageVersion}}-{{browser}}{{modeSuffix}}.zip",
 		sourcesRoot: root,
-		includeSources: [],
+		includeSources: mergedConfig.zip?.includeSources ?? ["**/*"],
 		compressionLevel: 9,
 		...mergedConfig.zip,
 		zipSources: mergedConfig.zip?.zipSources ?? ["firefox", "opera"].includes(browser),
@@ -190,12 +202,12 @@ function resolveZipConfig(root, browser, outBaseDir, mergedConfig) {
 		excludeSources: [
 			"**/node_modules",
 			"**/web-ext.config.ts",
-			"**/.*",
 			"**/__tests__/**",
 			"**/*.+(test|spec).?(c|m)+(j|t)s?(x)",
 			`${path.relative(root, outBaseDir)}/**`,
 			...mergedConfig.zip?.excludeSources ?? []
 		],
+		dotSources: mergedConfig.zip?.dotSources ?? false,
 		downloadPackages: mergedConfig.zip?.downloadPackages ?? [],
 		downloadedPackagesDir
 	};
@@ -216,7 +228,7 @@ function resolveAnalysisConfig(root, mergedConfig) {
 }
 async function getUnimportOptions(wxtDir, srcDir, logger, config) {
 	const disabled = config.imports === false;
-	const eslintrc = await getUnimportEslintOptions(wxtDir, config.imports);
+	const eslintrc = await getUnimportEslintOptions(logger, wxtDir, config.imports);
 	const invalidExports = ["options"];
 	const defineImportsAndTypes = (imports, typeImports) => [...imports, ...typeImports.map((name) => ({
 		name,
@@ -225,7 +237,7 @@ async function getUnimportOptions(wxtDir, srcDir, logger, config) {
 	const defaultOptions = {
 		imports: [{
 			name: "fakeBrowser",
-			from: "wxt/testing"
+			from: "wxt/testing/fake-browser"
 		}],
 		presets: [
 			{
@@ -329,45 +341,41 @@ async function getUnimportOptions(wxtDir, srcDir, logger, config) {
 	};
 	return defu(config.imports ?? {}, defaultOptions);
 }
-async function getUnimportEslintOptions(wxtDir, options) {
+async function getUnimportEslintOptions(logger, wxtDir, options) {
 	const inlineEnabled = options === false ? false : options?.eslintrc?.enabled ?? "auto";
+	const version = await getEslintVersion();
+	const major = parseInt(version[0]);
 	let enabled;
 	switch (inlineEnabled) {
 		case "auto":
-			const version = await getEslintVersion();
-			let major = parseInt(version[0]);
-			if (isNaN(major)) enabled = false;
-			if (major <= 8) enabled = 8;
+		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;
 			else if (major >= 9) enabled = 9;
 			else enabled = false;
 			break;
-		case true:
-			enabled = 8;
-			break;
 		default: enabled = inlineEnabled;
 	}
 	return {
 		enabled,
-		filePath: path.resolve(wxtDir, enabled === 9 ? "eslint-auto-imports.mjs" : "eslintrc-auto-import.json"),
+		filePath: path.resolve(wxtDir, enabled === 8 ? "eslintrc-auto-import.json" : "eslint-auto-imports.mjs"),
 		globalsPropValue: true
 	};
 }
-/**
-* Returns the path to `node_modules/wxt`.
-*/
+/** Returns the path to `node_modules/wxt`. */
 function resolveWxtModuleDir() {
 	const url = resolve$1("wxt", import.meta.url);
 	return path.resolve(fileURLToPath(url), "../..");
 }
 async function isDirMissing(dir) {
-	return !await fs.pathExists(dir);
+	return !await pathExists(dir);
 }
 function logMissingDir(logger, name, expected) {
 	logger.warn(`${name} directory not found: ./${normalizePath(path.relative(process.cwd(), expected))}`);
 }
-/**
-* Map of `ConfigEnv` commands to their default modes.
-*/
+/** Map of `ConfigEnv` commands to their default modes. */
 const COMMAND_MODES = {
 	build: "production",
 	serve: "development"
@@ -395,7 +403,8 @@ async function resolveWxtUserModules(root, modulesDir, modules = []) {
 	}));
 	const localModulePaths = await glob(["*.[tj]s", "*/index.[tj]s"], {
 		cwd: modulesDir,
-		onlyFiles: true
+		onlyFiles: true,
+		expandDirectories: false
 	}).catch(() => []);
 	localModulePaths.sort();
 	const localModules = await Promise.all(localModulePaths.map(async (file) => {
@@ -418,6 +427,17 @@ async function resolveWxtUserModules(root, modulesDir, modules = []) {
 	}));
 	return [...npmModules, ...localModules];
 }
-
+async function resolveRunner(browser, logger, mergedConfig) {
+	if (browser === "safari") return createSafariRunner();
+	if (isWsl) return createWslRunner();
+	try {
+		const { createWebExtRunner } = await import("./runners/web-ext.mjs");
+		return mergedConfig.webExt?.disabled ? createManualRunner() : createWebExtRunner();
+	} catch (err) {
+		if (err?.code !== "ERR_MODULE_NOT_FOUND") throw err;
+		logger.debug("Error loading the web-ext runner", err);
+	}
+	return createManualRunner();
+}
 //#endregion
-export { resolveConfig };
+export { resolveConfig };

package/dist/core/runners/manual.mjs

@@ -1,15 +1,11 @@
 import { wxt } from "../wxt.mjs";
 import { relative } from "node:path";
-
 //#region src/core/runners/manual.ts
-/**
-* The manual runner tells the user to load the unpacked extension manually.
-*/
+/** 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`);
 	} };
 }
-
 //#endregion
-export { createManualRunner };
+export { createManualRunner };

package/dist/core/runners/safari.mjs

@@ -1,15 +1,14 @@
 import { wxt } from "../wxt.mjs";
 import { relative } from "node:path";
-
 //#region src/core/runners/safari.ts
 /**
-* The Safari runner just logs a warning message because `web-ext` doesn't work with Safari.
+* 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`);
 	} };
 }
-
 //#endregion
-export { createSafariRunner };
+export { createSafariRunner };

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

@@ -1,11 +1,10 @@
-import { formatDuration } from "../utils/time.mjs";
 import { wxt } from "../wxt.mjs";
+import { formatDuration } from "../utils/time.mjs";
 import defu from "defu";
-
+import webExt from "web-ext";
+import { consoleStream } from "web-ext/util/logger";
 //#region src/core/runners/web-ext.ts
-/**
-* Create an `ExtensionRunner` backed by `web-ext`.
-*/
+/** Create an `ExtensionRunner` backed by `web-ext`. */
 function createWebExtRunner() {
 	let runner;
 	return {
@@ -14,12 +13,11 @@ function createWebExtRunner() {
 		},
 		async openBrowser() {
 			const startTime = Date.now();
-			const webExtLogger = await import("web-ext-run/util/logger");
-			webExtLogger.consoleStream.write = ({ level, msg, name }) => {
+			consoleStream.write = ({ level, msg, name }) => {
 				if (level >= ERROR_LOG_LEVEL) wxt.logger.error(name, msg);
 				if (level >= WARN_LOG_LEVEL) wxt.logger.warn(msg);
 			};
-			const wxtUserConfig = wxt.config.runnerConfig.config;
+			const wxtUserConfig = wxt.config.webExt.config;
 			const finalConfig = {
 				browserConsole: wxtUserConfig?.openConsole,
 				devtools: wxtUserConfig?.openDevtools,
@@ -46,7 +44,7 @@ function createWebExtRunner() {
 			const options = { shouldExitProgram: false };
 			wxt.logger.debug("web-ext config:", finalConfig);
 			wxt.logger.debug("web-ext options:", options);
-			runner = await (await import("web-ext-run")).default.cmd.run(finalConfig, options);
+			runner = await webExt.cmd.run(finalConfig, options);
 			const duration = Date.now() - startTime;
 			wxt.logger.success(`Opened browser in ${formatDuration(duration)}`);
 		},
@@ -61,6 +59,5 @@ const DEFAULT_CHROMIUM_PREFS = { devtools: { synced_preferences_sync_disabled: {
 	skipContentScripts: false,
 	"skip-content-scripts": false
 } } };
-
 //#endregion
-export { createWebExtRunner };
+export { createWebExtRunner };

package/dist/core/runners/wsl.mjs

@@ -1,15 +1,14 @@
 import { wxt } from "../wxt.mjs";
 import { relative } from "node:path";
-
 //#region src/core/runners/wsl.ts
 /**
-* The WSL runner just logs a warning message because `web-ext` doesn't work in WSL.
+* 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`);
 	} };
 }
-
 //#endregion
-export { createWslRunner };
+export { createWslRunner };

package/dist/core/utils/arrays.mjs

@@ -1,27 +1,20 @@
 //#region src/core/utils/arrays.ts
-/**
-* Checks if `predicate` returns truthy for all elements of the array.
-*/
+/** Checks if `predicate` returns truthy for all elements of the array. */
 function every(array, predicate) {
 	for (let i = 0; i < array.length; i++) if (!predicate(array[i], i)) return false;
 	return true;
 }
-/**
-* Returns true when any of the predicates return true;
-*/
+/** Returns true when any of the predicates return true; */
 function some(array, predicate) {
 	for (let i = 0; i < array.length; i++) if (predicate(array[i], i)) return true;
 	return false;
 }
-/**
-* Convert an item or array to an array.
-*/
+/** Convert an item or array to an array. */
 function toArray(a) {
 	return Array.isArray(a) ? a : [a];
 }
 function filterTruthy(array) {
 	return array.filter((item) => !!item);
 }
-
 //#endregion
-export { every, filterTruthy, some, toArray };
+export { every, filterTruthy, some, toArray };

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

@@ -1,22 +1,22 @@
 import { toArray } from "../arrays.mjs";
 import { wxt } from "../../wxt.mjs";
 import { getPublicFiles } from "../fs.mjs";
-import fs from "fs-extra";
+import { copyFile, mkdir, writeFile } from "node:fs/promises";
 import { dirname, resolve } from "path";
-import pc from "picocolors";
-
+import { styleText } from "node:util";
 //#region src/core/utils/building/build-entrypoints.ts
 async function buildEntrypoints(groups, spinner) {
 	const steps = [];
 	for (let i = 0; i < groups.length; i++) {
 		const group = groups[i];
 		const groupNames = toArray(group).map((e) => e.name);
-		const groupNameColored = groupNames.join(pc.dim(", "));
-		spinner.text = pc.dim(`[${i + 1}/${groups.length}]`) + ` ${groupNameColored}`;
+		const groupNameColored = groupNames.join(styleText("dim", ", "));
+		spinner.update({ text: styleText("dim", `[${i + 1}/${groups.length}]`) + ` ${groupNameColored}` });
 		try {
 			steps.push(await wxt.builder.build(group));
 		} catch (err) {
-			spinner.stop().clear();
+			spinner.stop();
+			spinner.clear();
 			wxt.logger.error(err);
 			throw Error(`Failed to build ${groupNames.join(", ")}`, { cause: err });
 		}
@@ -36,9 +36,9 @@ async function copyPublicDirectory() {
 	const publicAssets = [];
 	for (const file of files) {
 		const absoluteDest = resolve(wxt.config.outDir, file.relativeDest);
-		await fs.ensureDir(dirname(absoluteDest));
-		if ("absoluteSrc" in file) await fs.copyFile(file.absoluteSrc, absoluteDest);
-		else await fs.writeFile(absoluteDest, file.contents, "utf8");
+		await mkdir(dirname(absoluteDest), { recursive: true });
+		if ("absoluteSrc" in file) await copyFile(file.absoluteSrc, absoluteDest);
+		else await writeFile(absoluteDest, file.contents, "utf8");
 		publicAssets.push({
 			type: "asset",
 			fileName: file.relativeDest
@@ -46,6 +46,5 @@ async function copyPublicDirectory() {
 	}
 	return publicAssets;
 }
-
 //#endregion
-export { buildEntrypoints };
+export { buildEntrypoints };

package/dist/core/utils/building/detect-dev-changes.mjs

@@ -1,38 +1,47 @@
 import { normalizePath } from "../paths.mjs";
 import { every, some } from "../arrays.mjs";
 import { wxt } from "../../wxt.mjs";
-
 //#region src/core/utils/building/detect-dev-changes.ts
 /**
-* Compare the changed files vs the build output and determine what kind of reload needs to happen:
+* Compare the changed files vs the build output and determine what kind of
+* reload needs to happen:
 *
 * - Do nothing
-*   - CSS or JS file associated with an HTML page is changed - this is handled automatically by the
-*     dev server
+*
+*   - CSS or JS file associated with an HTML page is changed - this is handled
+*       automatically by the dev server
 *   - Change isn't used by any of the entrypoints
 * - Reload Content script
+*
 *   - CSS or JS file associated with a content script
 *   - Background script will be told to reload the content script
 * - Reload HTML file
-*   - HTML file itself is saved - HMR doesn't handle this because the HTML pages are pre-rendered
-*   - Chrome is OK reloading the page when the HTML file is changed without reloading the whole
-*     extension. Not sure about firefox, this might need to change to an extension reload
+*
+*   - HTML file itself is saved - HMR doesn't handle this because the HTML pages
+*       are pre-rendered
+*   - Chrome is OK reloading the page when the HTML file is changed without
+*       reloading the whole extension. Not sure about firefox, this might need
+*       to change to an extension reload
 * - Reload extension
+*
 *   - Background script is changed
 *   - Manifest is different
 * - Restart browser
-*   - web-ext.config.ts (runner config changes)
+*
+*   - Web-ext.config.ts (runner config changes)
 * - Full dev server restart
-*   - wxt.config.ts (main config file)
-*   - modules/* (any file related to WXT modules)
+*
+*   - Wxt.config.ts (main config file)
+*   - Modules/* (any file related to WXT modules)
 *   - .env (environment variable changed could effect build)
 */
 function detectDevChanges(changedFiles, currentOutput) {
-	if (some(changedFiles, (file) => file === wxt.config.userConfigMetadata.configFile)) return { type: "full-restart" };
-	if (some(changedFiles, (file) => file.startsWith(wxt.config.modulesDir))) return { type: "full-restart" };
-	if (some(changedFiles, (file) => file === wxt.config.runnerConfig.configFile)) return { type: "browser-restart" };
-	const changedSteps = new Set(changedFiles.flatMap((changedFile) => findEffectedSteps(changedFile, currentOutput)));
-	if (changedSteps.size === 0) if (some(changedFiles, (file) => file.startsWith(wxt.config.publicDir))) return {
+	const relevantChangedFiles = getRelevantDevChangedFiles(changedFiles, currentOutput);
+	if (some(relevantChangedFiles, (file) => file === wxt.config.userConfigMetadata.configFile)) return { type: "full-restart" };
+	if (some(relevantChangedFiles, (file) => file.startsWith(wxt.config.modulesDir))) return { type: "full-restart" };
+	if (some(relevantChangedFiles, (file) => file === wxt.config.webExt.configFile)) return { type: "browser-restart" };
+	const changedSteps = new Set(relevantChangedFiles.flatMap((changedFile) => findEffectedSteps(changedFile, currentOutput)));
+	if (changedSteps.size === 0) if (some(relevantChangedFiles, (file) => file.startsWith(wxt.config.publicDir))) return {
 		type: "extension-reload",
 		rebuildGroups: [],
 		cachedOutput: currentOutput
@@ -50,7 +59,7 @@ function detectDevChanges(changedFiles, currentOutput) {
 	};
 	for (const step of currentOutput.steps) if (changedSteps.has(step)) changedOutput.steps.push(step);
 	else unchangedOutput.steps.push(step);
-	if (changedFiles.length > 0 && every(changedFiles, (file) => file.endsWith(".html"))) return {
+	if (relevantChangedFiles.length > 0 && every(relevantChangedFiles, (file) => file.endsWith(".html"))) return {
 		type: "html-reload",
 		cachedOutput: unchangedOutput,
 		rebuildGroups: changedOutput.steps.map((step) => step.entrypoints)
@@ -67,8 +76,18 @@ function detectDevChanges(changedFiles, currentOutput) {
 		rebuildGroups: changedOutput.steps.map((step) => step.entrypoints)
 	};
 }
+function getRelevantDevChangedFiles(changedFiles, currentOutput) {
+	return Array.from(new Set(changedFiles)).filter((changedFile) => {
+		if (changedFile === wxt.config.userConfigMetadata.configFile) return true;
+		if (changedFile.startsWith(wxt.config.modulesDir)) return true;
+		if (changedFile === wxt.config.webExt.configFile) return true;
+		if (changedFile.startsWith(wxt.config.publicDir)) return true;
+		return findEffectedSteps(changedFile, currentOutput).length > 0;
+	});
+}
 /**
-* For a single change, return all the step of the build output that were effected by it.
+* For a single change, return all the step of the build output that were
+* effected by it.
 */
 function findEffectedSteps(changedFile, currentOutput) {
 	const changes = [];
@@ -83,6 +102,5 @@ function findEffectedSteps(changedFile, currentOutput) {
 	for (const step of currentOutput.steps) if (step.chunks.find((chunk) => isChunkEffected(chunk))) changes.push(step);
 	return changes;
 }
-
 //#endregion
-export { detectDevChanges };
+export { detectDevChanges, getRelevantDevChangedFiles };