wxt 0.21.4 → 0.21.5

package/dist/{core → internal}/package-managers/yarn.mjs

@@ -1,6 +1,6 @@
 import { dedupeDependencies, npm } from "./npm.mjs";
 import { x } from "tinyexec";
-//#region src/core/package-managers/yarn.ts
+//#region src/internal/package-managers/yarn.ts
 const yarn = {
 	overridesKey: "resolutions",
 	downloadDependency(...args) {

package/dist/{core/utils → internal}/package.mjs

@@ -1,7 +1,7 @@
-import { wxt } from "../wxt.mjs";
-import { readJson } from "./fs.mjs";
+import { readJson } from "../internal-utils/fs-utils.mjs";
+import { wxt } from "./wxt.mjs";
 import { resolve } from "node:path";
-//#region src/core/utils/package.ts
+//#region src/internal/package.ts
 /**
 * Read the project's package.json.
 *

package/dist/{core/utils/building → internal}/rebuild.mjs

@@ -1,9 +1,9 @@
-import { wxt } from "../../wxt.mjs";
+import { wxt } from "./wxt.mjs";
+import { createSpinner } from "./spinner.mjs";
+import { generateWxtDir } from "./generate-wxt-dir.mjs";
+import { generateManifest, writeManifest } from "./manifest.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";
-//#region src/core/utils/building/rebuild.ts
+//#region src/internal/rebuild.ts
 /**
 * Given a configuration, list of entrypoints, and an existing, partial output,
 * build the entrypoints and merge the new output with the existing output.

package/dist/{core → internal}/resolve-config.mjs

@@ -1,24 +1,19 @@
-import { builtinModules } from "../builtin-modules/index.mjs";
-import { normalizePath } from "./utils/paths.mjs";
-import "./utils/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 { normalizePath } from "../internal-utils/path-utils.mjs";
+import { builtinModules } from "./builtin-modules/index.mjs";
+import { pathExists } from "../internal-utils/fs-utils.mjs";
+import { createFsCache } from "../internal-utils/cache-utils.mjs";
+import { getEslintVersion } from "../internal-utils/eslint-utils.mjs";
+import { safeStringToNumber } from "../internal-utils/number-utils.mjs";
+import { loadEnv } from "../internal-utils/env-utils.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 { createWxtLogger } from "../internal-utils/log/wxt-logger.mjs";
 import path from "node:path";
+import { glob } from "tinyglobby";
 import { loadConfig } from "c12";
 import consola, { LogLevels } from "consola";
 import defu from "defu";
-import { fileURLToPath, pathToFileURL } from "node:url";
-//#region src/core/resolve-config.ts
+import { fileURLToPath } from "node:url";
+//#region src/internal/resolve-config.ts
 /**
 * Given an inline config, discover the config file if necessary, merge the
 * results, resolve any relative paths, and apply any defaults.
@@ -142,7 +137,7 @@ async function resolveConfig(inlineConfig, command) {
 		wxtModuleDir,
 		root,
 		webExt,
-		runner: command === "serve" ? await resolveRunner(browser, logger, webExt.config) : createManualRunner(),
+		runner: void 0,
 		srcDir,
 		typesDir,
 		wxtDir,
@@ -363,7 +358,7 @@ async function getUnimportEslintOptions(logger, wxtDir, options) {
 }
 /** Returns the path to `node_modules/wxt`. */
 function resolveWxtModuleDir() {
-	const url = import.meta.resolve("wxt", import.meta.url);
+	const url = import.meta.resolve("wxt");
 	return path.resolve(fileURLToPath(url), "../..");
 }
 async function isDirMissing(dir) {
@@ -388,9 +383,8 @@ async function mergeBuilderConfig(logger, inlineConfig, userConfig) {
 	throw Error("Builder not found. Make sure vite is installed.");
 }
 async function resolveWxtUserModules(root, modulesDir, modules = []) {
-	const importer = pathToFileURL(path.join(root, "index.js")).href;
 	const npmModules = await Promise.all(modules.map(async (moduleId) => {
-		const mod = await import(import.meta.resolve(moduleId, importer));
+		const mod = await import(import.meta.resolve(moduleId));
 		if (mod.default == null) throw Error("Module missing default export: " + moduleId);
 		return {
 			...mod.default,
@@ -424,17 +418,5 @@ async function resolveWxtUserModules(root, modulesDir, modules = []) {
 	}));
 	return [...npmModules, ...localModules];
 }
-async function resolveRunner(browser, logger, webExt) {
-	if (browser === "safari") return createSafariRunner();
-	if (d) return createWslRunner();
-	try {
-		const { createWebExtRunner } = await import("./runners/web-ext.mjs");
-		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);
-	}
-	return createManualRunner();
-}
 //#endregion
 export { resolveConfig };

package/dist/internal/runners/manual.mjs

@@ -0,0 +1,22 @@
+import { relative } from "node:path";
+//#region src/internal/runners/manual.ts
+/**
+* Base runner that just tells developers to load the extension into their
+* browser manually.
+*
+* You can extend this class and call any `super` method when your runner can't
+* open the browser.
+*/
+var ManualRunner = class {
+	constructor(config) {
+		this.config = config;
+	}
+	canOpen() {
+		return Promise.resolve(false);
+	}
+	async openBrowser() {
+		this.config.logger.info(`Load "${relative(process.cwd(), this.config.outDir)}" as an unpacked extension manually`);
+	}
+};
+//#endregion
+export { ManualRunner };

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

@@ -0,0 +1,79 @@
+import { d } from "../../inline/is-wsl/index.mjs";
+import { formatDuration } from "../../internal-utils/time-utils.mjs";
+import { mkdir } from "node:fs/promises";
+import { relative } from "node:path";
+import defu from "defu";
+//#region src/internal/runners/web-ext.ts
+/**
+* WXT's default `ExtensionRunner` that uses web-ext to open the browser. It
+* cannot open the browser automatically in some environments, like WSL.
+*/
+var WebExtRunner = class {
+	instance;
+	constructor(webExt, logger, config) {
+		this.webExt = webExt;
+		this.logger = logger;
+		this.config = config;
+	}
+	async canOpen() {
+		return true;
+	}
+	async openBrowser() {
+		if (this.config.browser === "safari") return this.logManualReason("Cannot open Safari using web-ext");
+		if (d) return this.logManualReason("Cannot open browser when using WSL");
+		if (this.config.webExt.config.disabled) return this.config.logger.info(this.loadManualMessage());
+		const startTime = Date.now();
+		this.logger.consoleStream.write = ({ level, msg, name }) => {
+			if (level >= ERROR_LOG_LEVEL) this.config.logger.error(name, msg);
+			if (level >= WARN_LOG_LEVEL) this.config.logger.warn(msg);
+		};
+		const wxtUserConfig = this.config.webExt.config;
+		if (this.config.browser !== "firefox" && wxtUserConfig?.chromiumProfile) await mkdir(wxtUserConfig.chromiumProfile, { recursive: true });
+		const finalConfig = {
+			browserConsole: wxtUserConfig?.openConsole,
+			devtools: wxtUserConfig?.openDevtools,
+			startUrl: wxtUserConfig?.startUrls,
+			keepProfileChanges: wxtUserConfig?.keepProfileChanges,
+			chromiumPort: wxtUserConfig?.chromiumPort,
+			...this.config.browser === "firefox" ? {
+				firefox: wxtUserConfig?.binaries?.firefox,
+				firefoxProfile: wxtUserConfig?.firefoxProfile,
+				pref: wxtUserConfig?.firefoxPref,
+				args: wxtUserConfig?.firefoxArgs
+			} : {
+				chromiumBinary: wxtUserConfig?.binaries?.[this.config.browser],
+				chromiumProfile: wxtUserConfig?.chromiumProfile,
+				chromiumPref: defu(wxtUserConfig?.chromiumPref, DEFAULT_CHROMIUM_PREFS),
+				args: ["--unsafely-disable-devtools-self-xss-warnings", ...wxtUserConfig?.chromiumArgs ?? []]
+			},
+			target: this.config.browser === "firefox" ? "firefox-desktop" : "chromium",
+			sourceDir: this.config.outDir,
+			noReloadManagerExtension: true,
+			noReload: true,
+			noInput: true
+		};
+		const options = { shouldExitProgram: false };
+		this.config.logger.debug("web-ext config:", finalConfig);
+		this.config.logger.debug("web-ext options:", options);
+		this.instance = await this.webExt.cmd.run(finalConfig, options);
+		const duration = Date.now() - startTime;
+		this.config.logger.success(`Opened browser in ${formatDuration(duration)}`);
+	}
+	async closeBrowser() {
+		await this.instance?.exit();
+	}
+	logManualReason(reason) {
+		this.config.logger.warn(`${reason}. ${this.loadManualMessage()}`);
+	}
+	loadManualMessage() {
+		return `Load "${relative(process.cwd(), this.config.outDir)}" as an unpacked extension manually`;
+	}
+};
+const WARN_LOG_LEVEL = 40;
+const ERROR_LOG_LEVEL = 50;
+const DEFAULT_CHROMIUM_PREFS = { devtools: { synced_preferences_sync_disabled: {
+	skipContentScripts: false,
+	"skip-content-scripts": false
+} } };
+//#endregion
+export { WebExtRunner };

package/dist/{core/utils/globals.mjs → internal/runtime-env-entries.mjs}

@@ -1,5 +1,5 @@
-//#region src/core/utils/globals.ts
-function getGlobals(config) {
+//#region src/internal/runtime-env-entries.ts
+function getRuntimeEnvEntries(config) {
 	return [
 		{
 			name: "MANIFEST_VERSION",
@@ -43,7 +43,7 @@ function getGlobals(config) {
 		}
 	];
 }
-function getEntrypointGlobals(entrypointName) {
+function getEntrypointRuntimeEnvEntries(entrypointName) {
 	return [{
 		name: "ENTRYPOINT",
 		value: entrypointName,
@@ -51,4 +51,4 @@ function getEntrypointGlobals(entrypointName) {
 	}];
 }
 //#endregion
-export { getEntrypointGlobals, getGlobals };
+export { getEntrypointRuntimeEnvEntries, getRuntimeEnvEntries };

package/dist/{core/utils → internal}/spinner.mjs

@@ -1,5 +1,5 @@
 import { styleText } from "node:util";
-//#region src/core/utils/spinner.ts
+//#region src/internal/spinner.ts
 function createSpinner(initialText = "", options = {}) {
 	const { color = "cyan" } = options;
 	const frames = [

package/dist/{core/utils → internal}/syntax-errors.mjs

@@ -1,7 +1,7 @@
-import { wxt } from "../wxt.mjs";
+import { wxt } from "./wxt.mjs";
 import { relative } from "node:path";
 import { styleText } from "node:util";
-//#region src/core/utils/syntax-errors.ts
+//#region src/internal/syntax-errors.ts
 function isBabelSyntaxError(error) {
 	return error instanceof SyntaxError && error.code === "BABEL_PARSER_SYNTAX_ERROR";
 }

package/dist/{core/utils → internal}/theme-icons.mjs

@@ -1,6 +1,6 @@
-import { normalizePath } from "./paths.mjs";
-import { wxt } from "../wxt.mjs";
-//#region src/core/utils/theme-icons.ts
+import { normalizePath } from "../internal-utils/path-utils.mjs";
+import { wxt } from "./wxt.mjs";
+//#region src/internal/theme-icons.ts
 /**
 * Firefox only.
 *

package/dist/{core/utils → internal}/transform.mjs

@@ -1,5 +1,5 @@
 import { parseModule } from "magicast";
-//#region src/core/utils/transform.ts
+//#region src/internal/transform.ts
 /**
 * Removes any code used at runtime related to an entrypoint's main function.
 *

package/dist/{core/utils → internal}/validation.mjs

@@ -1,4 +1,4 @@
-//#region src/core/utils/validation.ts
+//#region src/internal/validation.ts
 function validateEntrypoints(entrypoints) {
 	const errors = entrypoints.flatMap((entrypoint) => {
 		switch (entrypoint.type) {

package/dist/{core → internal}/wxt.mjs

@@ -1,10 +1,12 @@
-import { builtinModules } from "../builtin-modules/index.mjs";
-import { createViteBuilder } from "./builders/vite/index.mjs";
+import { builtinModules } from "./builtin-modules/index.mjs";
 import { createWxtPackageManager } from "./package-managers/index.mjs";
 import { resolveConfig } from "./resolve-config.mjs";
-import { createHooks } from "hookable";
+import { FlatEntrypointFinder } from "./entrypoint-finders/flat.mjs";
+import { detectBuilder } from "./detect-builder.mjs";
+import { detectRunner } from "./detect-runner.mjs";
 import { relative } from "path";
-//#region src/core/wxt.ts
+import { createHooks } from "hookable";
+//#region src/internal/wxt.ts
 /**
 * Global variable set once `createWxt` is called once. Since this variable is
 * used everywhere, this global can be used instead of passing the variable as a
@@ -12,14 +14,27 @@ import { relative } from "path";
 */
 let wxt;
 /**
-* Create and register a global instance of the Wxt interface for use throughout
-* the project.
+* Create and register a global instance of the `Wxt` interface for use
+* throughout the project.
 */
 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, pm] = await Promise.all([createViteBuilder(config, hooks, () => wxt.server), createWxtPackageManager(config.root)]);
+	const [pm, builder, runner] = await Promise.all([
+		createWxtPackageManager(config.root),
+		detectBuilder(config, hooks, () => wxt.server),
+		detectRunner(config)
+	]);
+	const entrypointFinder = new FlatEntrypointFinder(config);
+	Object.defineProperty(config, "runner", {
+		get() {
+			return runner;
+		},
+		set(value) {
+			wxt.runner = value;
+		}
+	});
 	wxt = {
 		config,
 		hooks,
@@ -39,6 +54,8 @@ async function registerWxt(command, inlineConfig = {}) {
 		},
 		pm,
 		builder,
+		runner,
+		entrypointFinder,
 		server: void 0
 	};
 	await initWxtModules();

package/dist/{core/utils/arrays.mjs → internal-utils/array-utils.mjs}

@@ -1,4 +1,4 @@
-//#region src/core/utils/arrays.ts
+//#region src/internal-utils/array-utils.ts
 /** 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;

package/dist/{core/utils/cache.mjs → internal-utils/cache-utils.mjs}

@@ -1,7 +1,7 @@
-import { writeFileIfDifferent } from "./fs.mjs";
-import { mkdir, readFile } from "node:fs/promises";
+import { writeFileIfDifferent } from "./fs-utils.mjs";
 import { dirname, resolve } from "path";
-//#region src/core/utils/cache.ts
+import { mkdir, readFile } from "node:fs/promises";
+//#region src/internal-utils/cache-utils.ts
 /**
 * A basic file system cache stored at `<srcDir>/.wxt/cache/<key>`. Just caches
 * a string in a file for the given key.

package/dist/{core/utils/content-scripts.mjs → internal-utils/content-script-utils.mjs}

@@ -1,5 +1,5 @@
-import { getEntrypointBundlePath } from "./entrypoints.mjs";
-//#region src/core/utils/content-scripts.ts
+import { getEntrypointBundlePath } from "./entrypoint-utils.mjs";
+//#region src/internal-utils/content-script-utils.ts
 /**
 * Returns a unique and consistent string hash based on a content scripts
 * options.

package/dist/{core/utils/content-security-policy.mjs → internal-utils/csp-utils.mjs}

@@ -1,4 +1,4 @@
-//#region src/core/utils/content-security-policy.ts
+//#region src/internal-utils/csp-utils.ts
 var ContentSecurityPolicy = class ContentSecurityPolicy {
 	static DIRECTIVE_ORDER = {
 		"default-src": 0,

package/dist/{core/utils/entrypoints.d.mts → internal-utils/entrypoint-utils.d.mts}

@@ -1,6 +1,6 @@
-import { Entrypoint } from "../../types.mjs";
+import { Entrypoint } from "../types.mjs";
 
-//#region src/core/utils/entrypoints.d.ts
+//#region src/internal-utils/entrypoint-utils.d.ts
 /**
  * Return's the entrypoint's output path relative to the output directory. Used
  * for paths in the manifest and rollup's bundle.

package/dist/{core/utils/entrypoints.mjs → internal-utils/entrypoint-utils.mjs}

@@ -1,6 +1,6 @@
-import { normalizePath } from "./paths.mjs";
+import { normalizePath } from "./path-utils.mjs";
 import path, { extname, relative, resolve } from "node:path";
-//#region src/core/utils/entrypoints.ts
+//#region src/internal-utils/entrypoint-utils.ts
 function getEntrypointName(entrypointsDir, inputPath) {
 	return path.relative(entrypointsDir, inputPath).split(/[./\\]/, 2)[0];
 }

package/dist/{core/utils/env.mjs → internal-utils/env-utils.mjs}

@@ -1,7 +1,7 @@
-import { expand } from "dotenv-expand";
+import dotenv_expand_default from "../inline/dotenv-expand/index.mjs";
 import { existsSync, readFileSync } from "node:fs";
 import { parseEnv } from "node:util";
-//#region src/core/utils/env.ts
+//#region src/internal-utils/env-utils.ts
 /** Returns true when running in a CI environment. */
 function isCI() {
 	return !!process.env.CI && process.env.CI !== "false";
@@ -27,7 +27,7 @@ function loadEnv(mode, browser) {
 			return [];
 		}
 	}));
-	expand({ parsed });
+	dotenv_expand_default.expand({ parsed });
 	return parsed;
 }
 //#endregion

package/dist/internal-utils/eslint-utils.mjs

@@ -0,0 +1,8 @@
+import { tryImport } from "./module-utils.mjs";
+//#region src/internal-utils/eslint-utils.ts
+async function getEslintVersion() {
+	const mod = await tryImport(() => import("eslint"));
+	return mod ? mod.ESLint.version?.split(".") ?? [] : [];
+}
+//#endregion
+export { getEslintVersion };

package/dist/{core/utils/fs.mjs → internal-utils/fs-utils.mjs}

@@ -1,8 +1,5 @@
-import { unnormalizePath } from "./paths.mjs";
-import { wxt } from "../wxt.mjs";
 import { access, readFile, writeFile } from "node:fs/promises";
-import { glob } from "tinyglobby";
-//#region src/core/utils/fs.ts
+//#region src/internal-utils/fs-utils.ts
 async function pathExists(path) {
 	try {
 		await access(path);
@@ -25,17 +22,10 @@ async function readJson(path) {
 async function writeFileIfDifferent(file, newContents) {
 	if (await readFile(file, "utf-8").catch(() => void 0) !== newContents) await writeFile(file, newContents);
 }
-async function getPublicFiles() {
-	if (!await pathExists(wxt.config.publicDir)) return [];
-	return (await glob("**/*", {
-		cwd: wxt.config.publicDir,
-		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 { getBytesDisplay, getPublicFiles, pathExists, readJson, writeFileIfDifferent };
+export { getBytesDisplay, pathExists, readJson, writeFileIfDifferent };

package/dist/internal-utils/log/index.mjs

@@ -0,0 +1,6 @@
+import "./wxt-logger.mjs";
+import "./print-table.mjs";
+import "./print-file-list.mjs";
+import "./print-build-summary.mjs";
+import "./print-header.mjs";
+export {};

package/dist/{core/utils/log/printBuildSummary.mjs → internal-utils/log/print-build-summary.mjs}

@@ -1,7 +1,7 @@
-import { wxt } from "../../wxt.mjs";
-import { printFileList } from "./printFileList.mjs";
+import { wxt } from "../../internal/wxt.mjs";
+import { printFileList } from "./print-file-list.mjs";
 import { resolve } from "path";
-//#region src/core/utils/log/printBuildSummary.ts
+//#region src/internal-utils/log/print-build-summary.ts
 async function printBuildSummary(log, header, output) {
 	const files = [...output.steps.flatMap((step) => step.chunks), ...output.publicAssets].sort((l, r) => {
 		const diff = getChunkSortWeight(l.fileName) - getChunkSortWeight(r.fileName);

package/dist/{core/utils/log/printFileList.mjs → internal-utils/log/print-file-list.mjs}

@@ -1,19 +1,20 @@
-import { wxt } from "../../wxt.mjs";
-import { getBytesDisplay } from "../fs.mjs";
-import { printTable } from "./printTable.mjs";
+import { getBytesDisplay } from "../fs-utils.mjs";
+import { wxt } from "../../internal/wxt.mjs";
+import { printTable } from "./print-table.mjs";
 import { lstat } from "node:fs/promises";
 import path from "node:path";
 import { styleText } from "node:util";
-//#region src/core/utils/log/printFileList.ts
+//#region src/internal-utils/log/print-file-list.ts
 async function printFileList(log, header, baseDir, files) {
 	let totalSize = 0;
 	const fileRows = await Promise.all(files.map(async (file, i) => {
-		const parts = [path.relative(process.cwd(), baseDir) + path.sep, path.relative(baseDir, file)];
+		const absoluteFile = path.resolve(baseDir, file);
+		const parts = [path.relative(process.cwd(), baseDir) + path.sep, path.relative(baseDir, absoluteFile)];
 		const prefix = i === files.length - 1 ? "  └─" : "  ├─";
 		const chunkColor = getChunkColor(file);
 		let size = "";
 		try {
-			const stats = await lstat(file);
+			const stats = await lstat(absoluteFile);
 			totalSize += stats.size;
 			size = getBytesDisplay(stats.size);
 		} catch (ex) {

package/dist/{core/utils/log/printHeader.mjs → internal-utils/log/print-header.mjs}

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

package/dist/{core/utils/log/printTable.mjs → internal-utils/log/print-table.mjs}

@@ -1,4 +1,4 @@
-//#region src/core/utils/log/printTable.ts
+//#region src/internal-utils/log/print-table.ts
 function printTable(log, header, rows, gap = 2) {
 	if (rows.length === 0) return;
 	const columnWidths = rows.reduce((widths, row) => {

package/dist/{core/utils/log/wxtLogger.mjs → internal-utils/log/wxt-logger.mjs}

@@ -1,4 +1,4 @@
-//#region src/core/utils/log/wxtLogger.ts
+//#region src/internal-utils/log/wxt-logger.ts
 const warned = /* @__PURE__ */ new Set();
 /**
 * Wraps a `Logger` with a `warnOnce`. The set of already-warned messages is

package/dist/internal-utils/module-utils.mjs

@@ -0,0 +1,32 @@
+//#region src/internal-utils/module-utils.ts
+/**
+* Returns the result of the first mapper function that resolves successfully.
+* If an error other than "module-not-found" is thrown, it is re-thrown
+* immediately.
+*
+* @param mappers - An array of functions that dynamically import a module and
+*   return a value based on it.
+* @returns The result of the first module that resolves successfully.
+*/
+async function withFirstModule(...mappers) {
+	for (const map of mappers) try {
+		return await map();
+	} catch (err) {
+		if (!isModuleNotFound(err)) throw err;
+	}
+	throw Error("No optional modules found");
+}
+async function tryImport(fn) {
+	try {
+		return await fn();
+	} catch (err) {
+		if (isModuleNotFound(err)) return void 0;
+		throw err;
+	}
+}
+const MODULE_NOT_FOUND_CODE = "ERR_MODULE_NOT_FOUND";
+function isModuleNotFound(err) {
+	return err?.code === MODULE_NOT_FOUND_CODE;
+}
+//#endregion
+export { tryImport, withFirstModule };

package/dist/{core/utils/number.mjs → internal-utils/number-utils.mjs}

@@ -1,4 +1,4 @@
-//#region src/core/utils/number.ts
+//#region src/internal-utils/number-utils.ts
 function safeStringToNumber(str) {
 	const num = Number(str);
 	return isNaN(num) ? null : num;

package/dist/{core/utils/paths.d.mts → internal-utils/path-utils.d.mts}

@@ -1,4 +1,4 @@
-//#region src/core/utils/paths.d.ts
+//#region src/internal-utils/path-utils.d.ts
 /**
  * Converts system paths to normalized bundler path. On Windows, this returns
  * paths with `/` instead of `\`.

package/dist/{core/utils/paths.mjs → internal-utils/path-utils.mjs}

@@ -1,6 +1,6 @@
-import normalize_path_default from "../../inline/normalize-path/index.mjs";
+import normalize_path_default from "../inline/normalize-path/index.mjs";
 import path from "node:path";
-//#region src/core/utils/paths.ts
+//#region src/internal-utils/path-utils.ts
 /**
 * Converts system paths to normalized bundler path. On Windows, this returns
 * paths with `/` instead of `\`.

package/dist/{core/utils/strings.mjs → internal-utils/string-utils.mjs}

@@ -1,5 +1,5 @@
-import { s } from "../../inline/scule/index.mjs";
-//#region src/core/utils/strings.ts
+import { s } from "../inline/scule/index.mjs";
+//#region src/internal-utils/string-utils.ts
 function kebabCaseAlphanumeric(str) {
 	return str.toLowerCase().replace(/[^a-z0-9-\s]/g, "").replace(/\s+/g, "-");
 }

package/dist/{core/utils/time.mjs → internal-utils/time-utils.mjs}

@@ -1,4 +1,4 @@
-//#region src/core/utils/time.ts
+//#region src/internal-utils/time-utils.ts
 function formatDuration(duration) {
 	if (duration < 1e3) return `${duration} ms`;
 	if (duration < 1e4) return `${(duration / 1e3).toFixed(3)} s`;

package/dist/{core/utils/types.d.mts → internal-utils/type-utils.d.mts}

@@ -1,6 +1,7 @@
+import { styleText } from "node:util";
 import { Browser } from "@wxt-dev/browser";
 
-//#region src/core/utils/types.d.ts
+//#region src/internal-utils/type-utils.d.ts
 type ManifestContentScript = NonNullable<Browser.runtime.Manifest['content_scripts']>[number];
 //#endregion
 export { ManifestContentScript };