wxt 0.20.17 → 0.21.0

package/bin/wxt-publish-extension.mjs

@@ -4,4 +4,4 @@
  * `publish-browser-extension` as a direct dependency (like for PNPM, which doesn't link
  * sub-dependency binaries to "node_modules/.bin")
  */
-import 'publish-browser-extension/cli';
+await import('publish-browser-extension/cli');

package/dist/browser.d.mts

@@ -1,3 +1,4 @@
+import { ScriptPublicPath } from "./utils/inject-script.mjs";
 import { Browser, browser as browser$1 } from "@wxt-dev/browser";
 
 //#region src/browser.d.ts
@@ -11,10 +12,26 @@ interface WxtRuntime {}
  * - `.wxt/types/i18n.d.ts`
  */
 interface WxtI18n {}
-type WxtBrowser = Omit<typeof browser$1, 'runtime' | 'i18n'> & {
+type ScriptInjection<Args extends any[], Result> = Browser.scripting.ScriptInjection<Args, Result> extends infer T ? T extends {
+  files: string[];
+} ? Omit<T, 'files'> & {
+  files: ScriptPublicPath[];
+} : T : never;
+type InjectionResult<Result> = Array<Browser.scripting.InjectionResult<Awaited<Result>>>;
+interface WxtScripting {
+  executeScript: {
+    /**
+     * @see {@link Browser.scripting.executeScript}
+     */
+    <Args extends any[], Result>(injection: ScriptInjection<Args, Result>): Promise<InjectionResult<Result>>;
+    <Args extends any[], Result>(injection: ScriptInjection<Args, Result>, callback: (results: InjectionResult<Result>) => void): void;
+  };
+}
+type WxtBrowser = Omit<typeof browser$1, 'runtime' | 'i18n' | 'scripting'> & {
   runtime: WxtRuntime & Omit<(typeof browser$1)['runtime'], 'getURL'>;
   i18n: WxtI18n & Omit<(typeof browser$1)['i18n'], 'getMessage'>;
+  scripting: WxtScripting & Omit<(typeof browser$1)['scripting'], 'executeScript'>;
 };
 declare const browser: WxtBrowser;
 //#endregion
-export { Browser, WxtBrowser, WxtI18n, WxtRuntime, browser };
+export { Browser, WxtBrowser, WxtI18n, WxtRuntime, WxtScripting, browser };

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

@@ -16,6 +16,7 @@ import { removeEntrypointMainFunction } from "./plugins/removeEntrypointMainFunc
 import { wxtPluginLoader } from "./plugins/wxtPluginLoader.mjs";
 import { resolveAppConfig } from "./plugins/resolveAppConfig.mjs";
 import { iifeFooter } from "./plugins/iifeFooter.mjs";
+import { iifeAnonymous } from "./plugins/iifeAnonymous.mjs";
 import "./plugins/index.mjs";
 import { toArray } from "../../utils/arrays.mjs";
 import { safeVarName } from "../../utils/strings.mjs";
@@ -63,9 +64,14 @@ async function createViteBuilder(wxtConfig, hooks, getWxtDevServer) {
 	const getLibModeConfig = (entrypoint) => {
 		const entry = getRollupEntry(entrypoint);
 		const plugins = [entrypointGroupGlobals(entrypoint)];
-		const iifeReturnValueName = safeVarName(entrypoint.name);
+		let iifeReturnValueName = safeVarName(entrypoint.name);
 		if (entrypoint.type === "content-script-style" || entrypoint.type === "unlisted-style") plugins.push(cssEntrypoints(entrypoint, wxtConfig));
-		if (entrypoint.type === "content-script" || entrypoint.type === "unlisted-script") plugins.push(iifeFooter(iifeReturnValueName));
+		if (entrypoint.type === "content-script" || entrypoint.type === "unlisted-script") {
+			if (typeof entrypoint.options.globalName === "string") iifeReturnValueName = entrypoint.options.globalName;
+			else if (typeof entrypoint.options.globalName === "function") iifeReturnValueName = entrypoint.options.globalName(entrypoint);
+			if (entrypoint.options.globalName === false) plugins.push(iifeAnonymous(iifeReturnValueName));
+			else plugins.push(iifeFooter(iifeReturnValueName));
+		}
 		return {
 			mode: wxtConfig.mode,
 			plugins,

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

@@ -0,0 +1,15 @@
+//#region src/core/builders/vite/plugins/iifeAnonymous.ts
+function iifeAnonymous(iifeReturnValueName) {
+	return {
+		name: "wxt:iife-anonymous",
+		generateBundle(_, bundle) {
+			for (const chunk of Object.values(bundle)) if (chunk.type === "chunk" && chunk.isEntry) {
+				const namedIIFEPrefix = new RegExp(`^var ${iifeReturnValueName}\\s*=\\s*(\\(function)`);
+				chunk.code = chunk.code.replace(namedIIFEPrefix, "$1");
+			}
+		}
+	};
+}
+
+//#endregion
+export { iifeAnonymous };

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

@@ -14,5 +14,6 @@ import { removeEntrypointMainFunction } from "./removeEntrypointMainFunction.mjs
 import { wxtPluginLoader } from "./wxtPluginLoader.mjs";
 import { resolveAppConfig } from "./resolveAppConfig.mjs";
 import { iifeFooter } from "./iifeFooter.mjs";
+import { iifeAnonymous } from "./iifeAnonymous.mjs";
 
 export {  };

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

@@ -34,7 +34,7 @@ async function generateWxtDir(entrypoints) {
 	}));
 }
 async function getPathsDeclarationEntry(entrypoints) {
-	const paths = entrypoints.map((entry) => getEntrypointBundlePath(entry, wxt.config.outDir, isHtmlEntrypoint(entry) ? ".html" : ".js")).concat(await getPublicFiles());
+	const paths = entrypoints.map((entry) => getEntrypointBundlePath(entry, wxt.config.outDir, getEntrypointPublicExt(entry))).concat(await getPublicFiles());
 	await wxt.hooks.callHook("prepare:publicPaths", wxt, paths);
 	const unions = [
 		`    | ""`,
@@ -59,6 +59,14 @@ declare module "wxt/browser" {
 		tsReference: true
 	};
 }
+function getEntrypointPublicExt(entry) {
+	if (isHtmlEntrypoint(entry)) return ".html";
+	switch (entry.type) {
+		case "content-script-style":
+		case "unlisted-style": return ".css";
+		default: return ".js";
+	}
+}
 async function getI18nDeclarationEntry() {
 	const defaultLocale = wxt.config.manifest.default_locale;
 	const template = `// Generated by wxt

package/dist/core/resolve-config.mjs

@@ -246,7 +246,7 @@ async function getUnimportOptions(wxtDir, srcDir, logger, config) {
 			},
 			{
 				from: "wxt/utils/app-config",
-				imports: defineImportsAndTypes(["useAppConfig"], [])
+				imports: defineImportsAndTypes(["getAppConfig", "useAppConfig"], [])
 			},
 			{
 				from: "wxt/utils/content-script-context",

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

@@ -14,7 +14,6 @@ function createWebExtRunner() {
 		},
 		async openBrowser() {
 			const startTime = Date.now();
-			if (wxt.config.browser === "firefox" && wxt.config.manifestVersion === 3) throw Error("Dev mode does not support Firefox MV3. For alternatives, see https://github.com/wxt-dev/wxt/issues/230#issuecomment-1806881653");
 			const webExtLogger = await import("web-ext-run/util/logger");
 			webExtLogger.consoleStream.write = ({ level, msg, name }) => {
 				if (level >= ERROR_LOG_LEVEL) wxt.logger.error(name, msg);

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

@@ -65,19 +65,13 @@ async function findEntrypoints() {
 				...info,
 				type,
 				outputDir: resolve(wxt.config.outDir, CONTENT_SCRIPT_OUT_DIR),
-				options: {
-					include: options.include,
-					exclude: options.exclude
-				}
+				options
 			};
 			default: return {
 				...info,
 				type,
 				outputDir: wxt.config.outDir,
-				options: {
-					include: options.include,
-					exclude: options.exclude
-				}
+				options
 			};
 		}
 	}));
@@ -110,15 +104,17 @@ async function importEntrypoints(infos) {
 	})()]);
 	return resMap;
 }
-/** Extract `manifest.` options from meta tags, converting snake_case keys to camelCase */
+/** Extract `manifest.` and `wxt.` options from meta tags, converting snake_case keys to camelCase */
 async function importHtmlEntrypoint(info) {
 	const { document } = parseHTML(await fs.readFile(info.inputPath, "utf-8"));
 	const metaTags = document.querySelectorAll("meta");
 	const res = { title: document.querySelector("title")?.textContent || void 0 };
 	metaTags.forEach((tag) => {
 		const name = tag.name;
-		if (!name.startsWith("manifest.")) return;
-		const key = camelCase(name.slice(9));
+		let key;
+		if (name.startsWith("manifest.")) key = camelCase(name.slice(9));
+		else if (name.startsWith("wxt.")) key = camelCase(name.slice(4));
+		else return;
 		try {
 			res[key] = JSON5.parse(tag.content);
 		} catch {
@@ -151,17 +147,13 @@ function preventNoEntrypoints(files) {
 	if (files.length === 0) throw Error(`No entrypoints found in ${wxt.config.entrypointsDir}`);
 }
 async function getPopupEntrypoint(info, options) {
+	const { themeIcons, title, type, ...perBrowserOptions } = options;
 	const strictOptions = resolvePerBrowserOptions({
-		browserStyle: options.browserStyle,
-		exclude: options.exclude,
-		include: options.include,
-		defaultIcon: options.defaultIcon,
-		defaultTitle: options.title,
-		mv2Key: options.type,
-		defaultArea: options.defaultArea
+		...perBrowserOptions,
+		defaultTitle: title,
+		mv2Key: type
 	}, wxt.config.browser);
 	if (strictOptions.mv2Key && strictOptions.mv2Key !== "page_action") strictOptions.mv2Key = "browser_action";
-	const themeIcons = options.themeIcons;
 	return {
 		type: "popup",
 		name: "popup",
@@ -177,13 +169,7 @@ async function getOptionsEntrypoint(info, options) {
 	return {
 		type: "options",
 		name: "options",
-		options: resolvePerBrowserOptions({
-			browserStyle: options.browserStyle,
-			chromeStyle: options.chromeStyle,
-			exclude: options.exclude,
-			include: options.include,
-			openInTab: options.openInTab
-		}, wxt.config.browser),
+		options: resolvePerBrowserOptions(options, wxt.config.browser),
 		inputPath: info.inputPath,
 		outputDir: wxt.config.outDir
 	};
@@ -194,10 +180,7 @@ async function getUnlistedPageEntrypoint(info, options) {
 		name: info.name,
 		inputPath: info.inputPath,
 		outputDir: wxt.config.outDir,
-		options: {
-			include: options.include,
-			exclude: options.exclude
-		}
+		options
 	};
 }
 async function getUnlistedScriptEntrypoint({ inputPath, name }, options) {
@@ -206,19 +189,11 @@ async function getUnlistedScriptEntrypoint({ inputPath, name }, options) {
 		name,
 		inputPath,
 		outputDir: wxt.config.outDir,
-		options: resolvePerBrowserOptions({
-			include: options.include,
-			exclude: options.exclude
-		}, wxt.config.browser)
+		options: resolvePerBrowserOptions(options, wxt.config.browser)
 	};
 }
 async function getBackgroundEntrypoint({ inputPath, name }, options) {
-	const strictOptions = resolvePerBrowserOptions({
-		include: options.include,
-		exclude: options.exclude,
-		persistent: options.persistent,
-		type: options.type
-	}, wxt.config.browser);
+	const strictOptions = resolvePerBrowserOptions(options, wxt.config.browser);
 	if (wxt.config.manifestVersion !== 3) delete strictOptions.type;
 	return {
 		type: "background",
@@ -238,16 +213,13 @@ async function getContentScriptEntrypoint({ inputPath, name }, options) {
 	};
 }
 async function getSidepanelEntrypoint(info, options) {
+	const { title, ...perBrowserOptions } = options;
 	return {
 		type: "sidepanel",
 		name: info.name,
 		options: resolvePerBrowserOptions({
-			browserStyle: options.browserStyle,
-			exclude: options.exclude,
-			include: options.include,
-			defaultIcon: options.defaultIcon,
-			defaultTitle: options.title,
-			openAtInstall: options.openAtInstall
+			...perBrowserOptions,
+			defaultTitle: title
 		}, wxt.config.browser),
 		inputPath: info.inputPath,
 		outputDir: wxt.config.outDir

package/dist/core/utils/network.mjs

@@ -1,11 +1,17 @@
 import { withTimeout } from "./time.mjs";
+import consola from "consola";
 import dns from "node:dns";
 
 //#region src/core/utils/network.ts
-function isOffline() {
-	return withTimeout(new Promise((res) => {
-		dns.resolve("google.com", (err) => res(err != null));
-	}), 1e3).catch(() => true);
+async function isOffline() {
+	try {
+		return await withTimeout(new Promise((res) => {
+			dns.resolve("google.com", (err) => res(err != null));
+		}), 1e3);
+	} catch (error) {
+		consola.error("Error checking offline status:", error);
+		return true;
+	}
 }
 async function isOnline() {
 	return !await isOffline();

package/dist/index.d.mts

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

package/dist/types.d.mts

@@ -560,7 +560,27 @@ interface BackgroundEntrypointOptions extends BaseEntrypointOptions {
    */
   type?: PerBrowserOption<'module'>;
 }
-interface BaseContentScriptEntrypointOptions extends BaseEntrypointOptions {
+interface BaseScriptEntrypointOptions extends BaseEntrypointOptions {
+  /**
+   * The variable name for the IIFE in the output bundle.
+   *
+   * This option is relevant for scripts inserted into the page context where the default IIFE
+   * variable name may conflict with an existing variable on the target page. This applies to content
+   * scripts with world=MAIN, and others, such as unlisted scripts, that could be dynamically injected
+   * into the page with a <script> tag.
+   *
+   * Available options:
+   * - `true`: automatically generate a name for the IIFE based on the entrypoint name
+   * - `false`: Output the IIFE without a variable name, making it anonymous. This is the safest option
+   *  to avoid conflicts with existing variables on the page. This will become the default in a future version of WXT.
+   * - `string`: Use the provided string as the global variable name.
+   * - `function`: A function that receives the entrypoint and returns a string to use as the variable name.
+   *
+   * @default true
+   */
+  globalName?: string | boolean | ((entrypoint: Entrypoint) => string);
+}
+interface BaseContentScriptEntrypointOptions extends BaseScriptEntrypointOptions {
   matches?: PerBrowserOption<NonNullable<ManifestContentScript['matches']>>;
   /**
    * See https://developer.chrome.com/docs/extensions/mv3/content_scripts/
@@ -669,6 +689,7 @@ interface PopupEntrypointOptions extends BaseEntrypointOptions {
   themeIcons?: ThemeIcon[];
 }
 interface OptionsEntrypointOptions extends BaseEntrypointOptions {
+  title?: string;
   openInTab?: PerBrowserOption<boolean>;
   browserStyle?: PerBrowserOption<boolean>;
   chromeStyle?: PerBrowserOption<boolean>;
@@ -723,9 +744,13 @@ interface BaseEntrypoint {
   skipped?: boolean;
 }
 interface GenericEntrypoint extends BaseEntrypoint {
-  type: 'sandbox' | 'bookmarks' | 'history' | 'newtab' | 'devtools' | 'unlisted-page' | 'unlisted-script' | 'unlisted-style' | 'content-script-style';
+  type: 'sandbox' | 'bookmarks' | 'history' | 'newtab' | 'devtools' | 'unlisted-page' | 'unlisted-style' | 'content-script-style';
   options: ResolvedPerBrowserOptions<BaseEntrypointOptions>;
 }
+interface UnlistedScriptEntrypoint extends BaseEntrypoint {
+  type: 'unlisted-script';
+  options: ResolvedPerBrowserOptions<BaseScriptEntrypointOptions>;
+}
 interface BackgroundEntrypoint extends BaseEntrypoint {
   type: 'background';
   options: ResolvedPerBrowserOptions<BackgroundEntrypointOptions>;
@@ -746,7 +771,7 @@ interface SidepanelEntrypoint extends BaseEntrypoint {
   type: 'sidepanel';
   options: ResolvedPerBrowserOptions<SidepanelEntrypointOptions, 'defaultIcon'>;
 }
-type Entrypoint = GenericEntrypoint | BackgroundEntrypoint | ContentScriptEntrypoint | PopupEntrypoint | OptionsEntrypoint | SidepanelEntrypoint;
+type Entrypoint = GenericEntrypoint | BackgroundEntrypoint | UnlistedScriptEntrypoint | ContentScriptEntrypoint | PopupEntrypoint | OptionsEntrypoint | SidepanelEntrypoint;
 interface EntrypointInfo {
   name: string;
   /** Absolute path to the entrypoint file. */
@@ -782,7 +807,7 @@ interface BackgroundDefinition extends BackgroundEntrypointOptions {
    */
   main(): void;
 }
-interface UnlistedScriptDefinition extends BaseEntrypointOptions {
+interface UnlistedScriptDefinition extends BaseScriptEntrypointOptions {
   /**
    * Main function executed when the unlisted script is ran.
    *
@@ -1472,4 +1497,4 @@ interface WxtDirFileEntry {
   tsReference?: boolean;
 }
 //#endregion
-export { BackgroundDefinition, BackgroundEntrypoint, BackgroundEntrypointOptions, BaseContentScriptEntrypointOptions, BaseEntrypoint, BaseEntrypointOptions, BuildOutput, BuildStepOutput, ConfigEnv, ContentScriptDefinition, ContentScriptEntrypoint, CopiedPublicFile, Dependency, Entrypoint, EntrypointGroup, EntrypointInfo, EslintGlobalsPropValue, Eslintrc, ExtensionRunner, ExtensionRunnerConfig, FsCache, GeneratedPublicFile, GenericEntrypoint, HookResult, InlineConfig, IsolatedWorldContentScriptDefinition, IsolatedWorldContentScriptEntrypointOptions, Logger, MainWorldContentScriptDefinition, MainWorldContentScriptEntrypointOptions, OnContentScriptStopped, OptionsEntrypoint, OptionsEntrypointOptions, OutputAsset, OutputChunk, OutputFile, PerBrowserMap, PerBrowserOption, PopupEntrypoint, PopupEntrypointOptions, ReloadContentScriptPayload, ResolvedBasePublicFile, ResolvedConfig$1 as ResolvedConfig, ResolvedEslintrc, ResolvedPerBrowserOptions, ResolvedPublicFile, ServerInfo, SidepanelEntrypoint, SidepanelEntrypointOptions, TargetBrowser, TargetManifestVersion, ThemeIcon, UnlistedScriptDefinition, UserConfig, UserManifest, UserManifestFn, WebExtConfig, Wxt, WxtBuilder, WxtBuilderServer, WxtCommand, WxtDevServer, WxtDirEntry, WxtDirFileEntry, WxtDirTypeReferenceEntry, WxtHooks, WxtModule, WxtModuleOptions, WxtModuleSetup, WxtModuleWithMetadata, WxtPackageManager, WxtPlugin, WxtResolvedUnimportOptions, WxtUnimportOptions, WxtViteConfig };
+export { BackgroundDefinition, BackgroundEntrypoint, BackgroundEntrypointOptions, BaseContentScriptEntrypointOptions, BaseEntrypoint, BaseEntrypointOptions, BaseScriptEntrypointOptions, BuildOutput, BuildStepOutput, ConfigEnv, ContentScriptDefinition, ContentScriptEntrypoint, CopiedPublicFile, Dependency, Entrypoint, EntrypointGroup, EntrypointInfo, EslintGlobalsPropValue, Eslintrc, ExtensionRunner, ExtensionRunnerConfig, FsCache, GeneratedPublicFile, GenericEntrypoint, HookResult, InlineConfig, IsolatedWorldContentScriptDefinition, IsolatedWorldContentScriptEntrypointOptions, Logger, MainWorldContentScriptDefinition, MainWorldContentScriptEntrypointOptions, OnContentScriptStopped, OptionsEntrypoint, OptionsEntrypointOptions, OutputAsset, OutputChunk, OutputFile, PerBrowserMap, PerBrowserOption, PopupEntrypoint, PopupEntrypointOptions, ReloadContentScriptPayload, ResolvedBasePublicFile, ResolvedConfig$1 as ResolvedConfig, ResolvedEslintrc, ResolvedPerBrowserOptions, ResolvedPublicFile, ServerInfo, SidepanelEntrypoint, SidepanelEntrypointOptions, TargetBrowser, TargetManifestVersion, ThemeIcon, UnlistedScriptDefinition, UnlistedScriptEntrypoint, UserConfig, UserManifest, UserManifestFn, WebExtConfig, Wxt, WxtBuilder, WxtBuilderServer, WxtCommand, WxtDevServer, WxtDirEntry, WxtDirFileEntry, WxtDirTypeReferenceEntry, WxtHooks, WxtModule, WxtModuleOptions, WxtModuleSetup, WxtModuleWithMetadata, WxtPackageManager, WxtPlugin, WxtResolvedUnimportOptions, WxtUnimportOptions, WxtViteConfig };

package/dist/utils/app-config.d.mts

@@ -1,6 +1,17 @@
 import { WxtAppConfig } from "./define-app-config.mjs";
 
 //#region src/utils/app-config.d.ts
+/**
+ * Get runtime config defined in `<srcDir>/app.config.ts`
+ *
+ * @see https://wxt.dev/guide/essentials/config/runtime.html
+ */
+declare function getAppConfig(): WxtAppConfig;
+/**
+ * Alias for {@link getAppConfig}.
+ *
+ * @see https://wxt.dev/guide/essentials/config/runtime.html
+ */
 declare function useAppConfig(): WxtAppConfig;
 //#endregion
-export { useAppConfig };
+export { getAppConfig, useAppConfig };

package/dist/utils/app-config.mjs

@@ -2,9 +2,22 @@ import appConfig from "virtual:app-config";
 
 //#region src/utils/app-config.ts
 /** @module wxt/utils/app-config */
-function useAppConfig() {
+/**
+* Get runtime config defined in `<srcDir>/app.config.ts`
+*
+* @see https://wxt.dev/guide/essentials/config/runtime.html
+*/
+function getAppConfig() {
 	return appConfig;
 }
+/**
+* Alias for {@link getAppConfig}.
+*
+* @see https://wxt.dev/guide/essentials/config/runtime.html
+*/
+function useAppConfig() {
+	return getAppConfig();
+}
 
 //#endregion
-export { useAppConfig };
+export { getAppConfig, useAppConfig };

package/dist/utils/internal/location-watcher.mjs

@@ -1,21 +1,30 @@
 import { WxtLocationChangeEvent } from "./custom-events.mjs";
 
 //#region src/utils/internal/location-watcher.ts
+const supportsNavigationApi = typeof globalThis.navigation?.addEventListener === "function";
 /**
 * Create a util that watches for URL changes, dispatching the custom event when detected. Stops
-* watching when content script is invalidated.
+* watching when content script is invalidated. Uses Navigation API when available, otherwise
+* falls back to polling.
 */
 function createLocationWatcher(ctx) {
-	let interval;
-	let oldUrl;
+	let lastUrl;
+	let watching = false;
 	return { run() {
-		if (interval != null) return;
-		oldUrl = new URL(location.href);
-		interval = ctx.setInterval(() => {
-			let newUrl = new URL(location.href);
-			if (newUrl.href !== oldUrl.href) {
-				window.dispatchEvent(new WxtLocationChangeEvent(newUrl, oldUrl));
-				oldUrl = newUrl;
+		if (watching) return;
+		watching = true;
+		lastUrl = new URL(location.href);
+		if (supportsNavigationApi) globalThis.navigation.addEventListener("navigate", (event) => {
+			const newUrl = new URL(event.destination.url);
+			if (newUrl.href === lastUrl.href) return;
+			window.dispatchEvent(new WxtLocationChangeEvent(newUrl, lastUrl));
+			lastUrl = newUrl;
+		}, { signal: ctx.signal });
+		else ctx.setInterval(() => {
+			const newUrl = new URL(location.href);
+			if (newUrl.href !== lastUrl.href) {
+				window.dispatchEvent(new WxtLocationChangeEvent(newUrl, lastUrl));
+				lastUrl = newUrl;
 			}
 		}, 1e3);
 	} };

package/dist/version.mjs

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "wxt",
   "type": "module",
-  "version": "0.20.17",
+  "version": "0.21.0",
   "description": "⚡ Next-gen Web Extension Framework",
   "license": "MIT",
   "dependencies": {
@@ -43,13 +43,13 @@
     "perfect-debounce": "^2.1.0",
     "picocolors": "^1.1.1",
     "prompts": "^2.4.2",
-    "publish-browser-extension": "^2.3.0 || ^3.0.2 || ^4.0.0",
+    "publish-browser-extension": "^2.3.0 || ^3.0.2 || ^4.0.4",
     "scule": "^1.3.0",
     "unimport": "^3.13.1 || ^4.0.0 || ^5.0.0",
     "vite": "^5.4.19 || ^6.3.4 || ^7.0.0",
     "vite-node": "^3.2.4 || ^5.0.0",
     "web-ext-run": "^0.2.4",
-    "@wxt-dev/browser": "^0.1.36"
+    "@wxt-dev/browser": "^0.1.37"
   },
   "peerDependencies": {
     "eslint": "^8.57.0 || ^9.0.0"