wxt 0.21.3 → 0.21.5

package/dist/{core/builders/vite/plugins/devHtmlPrerender.mjs → internal/builders/vite/plugins/dev-html-prerender.mjs}

@@ -1,10 +1,9 @@
-import { normalizePath } from "../../../utils/paths.mjs";
-import { getEntrypointName } from "../../../utils/entrypoints.mjs";
-import "../../../utils/index.mjs";
-import { dirname, relative, resolve } from "node:path";
+import { normalizePath } from "../../../../internal-utils/path-utils.mjs";
+import { getEntrypointName } from "../../../../internal-utils/entrypoint-utils.mjs";
+import { c } from "../../../../inline/ohash/index.mjs";
 import { parseHTML } from "linkedom";
-import { hash } from "ohash";
-//#region src/core/builders/vite/plugins/devHtmlPrerender.ts
+import { dirname, relative, resolve } from "node:path";
+//#region src/internal/builders/vite/plugins/dev-html-prerender.ts
 const inlineScriptContents = {};
 /**
 * Pre-renders the HTML entrypoints when building the extension to connect to
@@ -48,7 +47,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/builders/vite/plugins/devServerGlobals.mjs → internal/builders/vite/plugins/dev-server-globals.mjs}

@@ -1,4 +1,4 @@
-//#region src/core/builders/vite/plugins/devServerGlobals.ts
+//#region src/internal/builders/vite/plugins/dev-server-globals.ts
 /**
 * Defines global constants about the dev server. Helps scripts connect to the
 * server's web socket.

package/dist/{core/builders/vite/plugins/extensionApiMock.mjs → internal/builders/vite/plugins/extension-api-mock.mjs}

@@ -1,5 +1,5 @@
 import path from "node:path";
-//#region src/core/builders/vite/plugins/extensionApiMock.ts
+//#region src/internal/builders/vite/plugins/extension-api-mock.ts
 /**
 * Mock `wxt/browser` and stub the global `browser`/`chrome` types with a fake
 * version of the extension APIs

package/dist/{core/builders/vite/plugins/iifeAnonymous.mjs → internal/builders/vite/plugins/iife-anonymous.mjs}

@@ -1,4 +1,4 @@
-//#region src/core/builders/vite/plugins/iifeAnonymous.ts
+//#region src/internal/builders/vite/plugins/iife-anonymous.ts
 function iifeAnonymous(iifeReturnValueName) {
 	return {
 		name: "wxt:iife-anonymous",

package/dist/{core/builders/vite/plugins/iifeFooter.mjs → internal/builders/vite/plugins/iife-footer.mjs}

@@ -1,4 +1,4 @@
-//#region src/core/builders/vite/plugins/iifeFooter.ts
+//#region src/internal/builders/vite/plugins/iife-footer.ts
 /**
 * Add a footer with the returned value so it can return values to
 * `scripting.executeScript` Footer is added a part of esbuild to make sure it's

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

@@ -0,0 +1,17 @@
+import "./resolve-virtual-modules.mjs";
+import "./wxt-plugin-loader.mjs";
+import "./add-entrypoint-group-runtime-env-entries.mjs";
+import "./add-runtime-env-entries.mjs";
+import "./bundle-analysis.mjs";
+import "./css-entrypoints.mjs";
+import "./define-import-meta.mjs";
+import "./dev-html-prerender.mjs";
+import "./dev-server-globals.mjs";
+import "./extension-api-mock.mjs";
+import "./iife-anonymous.mjs";
+import "./iife-footer.mjs";
+import "./noop-background.mjs";
+import "./remove-entrypoint-main-function.mjs";
+import "./resolve-app-config.mjs";
+import "./tsconfig-paths.mjs";
+export {};

package/dist/{core/builders/vite/plugins/noopBackground.mjs → internal/builders/vite/plugins/noop-background.mjs}

@@ -1,5 +1,5 @@
-import { VIRTUAL_NOOP_BACKGROUND_MODULE_ID } from "../../../utils/constants.mjs";
-//#region src/core/builders/vite/plugins/noopBackground.ts
+import { VIRTUAL_NOOP_BACKGROUND_MODULE_ID } from "../../../constants.mjs";
+//#region src/internal/builders/vite/plugins/noop-background.ts
 /**
 * In dev mode, if there's not a background script listed, we need to add one so
 * that the web socket connection is setup and the extension reloads HTML pages

package/dist/{core/builders/vite/plugins/removeEntrypointMainFunction.mjs → internal/builders/vite/plugins/remove-entrypoint-main-function.mjs}

@@ -1,8 +1,7 @@
-import { normalizePath } from "../../../utils/paths.mjs";
-import "../../../utils/index.mjs";
-import { removeMainFunctionCode } from "../../../utils/transform.mjs";
+import { normalizePath } from "../../../../internal-utils/path-utils.mjs";
+import { removeMainFunctionCode } from "../../../transform.mjs";
 import { resolve } from "node:path";
-//#region src/core/builders/vite/plugins/removeEntrypointMainFunction.ts
+//#region src/internal/builders/vite/plugins/remove-entrypoint-main-function.ts
 /**
 * Transforms entrypoints, removing the main function from the entrypoint if it
 * exists.

package/dist/{core/builders/vite/plugins/resolveAppConfig.mjs → internal/builders/vite/plugins/resolve-app-config.mjs}

@@ -1,6 +1,6 @@
-import { pathExists } from "../../../utils/fs.mjs";
+import { pathExists } from "../../../../internal-utils/fs-utils.mjs";
 import { resolve } from "node:path";
-//#region src/core/builders/vite/plugins/resolveAppConfig.ts
+//#region src/internal/builders/vite/plugins/resolve-app-config.ts
 /**
 * When importing `virtual:app-config`, resolve it to the `app.config.ts` file
 * in the project.

package/dist/{core/builders/vite/plugins/resolveVirtualModules.mjs → internal/builders/vite/plugins/resolve-virtual-modules.mjs}

@@ -1,9 +1,9 @@
-import { normalizePath } from "../../../utils/paths.mjs";
-import "../../../utils/index.mjs";
-import { virtualModuleNames } from "../../../utils/virtual-modules.mjs";
-import { readFile } from "node:fs/promises";
+import { normalizePath } from "../../../../internal-utils/path-utils.mjs";
+import { getEntrypointName } from "../../../../internal-utils/entrypoint-utils.mjs";
+import { virtualModuleNames } from "../../../virtual-modules.mjs";
 import { resolve } from "path";
-//#region src/core/builders/vite/plugins/resolveVirtualModules.ts
+import { readFile } from "node:fs/promises";
+//#region src/internal/builders/vite/plugins/resolve-virtual-modules.ts
 /**
 * Resolve all the virtual modules to the `node_modules/wxt/dist/virtual`
 * directory.
@@ -24,7 +24,9 @@ function resolveVirtualModules(config) {
 				filter: { id: new RegExp(`^${resolvedVirtualId}`) },
 				async handler(id) {
 					const inputPath = id.replace(resolvedVirtualId, "");
-					return (await readFile(resolve(config.wxtModuleDir, `dist/virtual/${name}.mjs`), "utf-8")).replace(`virtual:user-${name}`, inputPath);
+					const template = await readFile(resolve(config.wxtModuleDir, `dist/virtual/${name}.mjs`), "utf-8");
+					const entrypointName = getEntrypointName(config.entrypointsDir, inputPath);
+					return template.replace(`virtual:user-${name}`, inputPath).replace("virtual:wxt-plugins", `virtual:wxt-plugins?entrypoint=${encodeURIComponent(entrypointName)}`);
 				}
 			}
 		};

package/dist/{core/builders/vite/plugins/tsconfigPaths.mjs → internal/builders/vite/plugins/tsconfig-paths.mjs}

@@ -1,4 +1,4 @@
-//#region src/core/builders/vite/plugins/tsconfigPaths.ts
+//#region src/internal/builders/vite/plugins/tsconfig-paths.ts
 function tsconfigPaths(config) {
 	return {
 		name: "wxt:aliases",

package/dist/internal/builders/vite/plugins/wxt-plugin-loader.mjs

@@ -0,0 +1,77 @@
+import { normalizePath } from "../../../../internal-utils/path-utils.mjs";
+import { getEntrypointName } from "../../../../internal-utils/entrypoint-utils.mjs";
+import { parseHTML } from "linkedom";
+//#region src/internal/builders/vite/plugins/wxt-plugin-loader.ts
+function getPluginModules(plugins, entrypoint) {
+	return plugins.map((plugin) => typeof plugin === "string" ? { module: plugin } : plugin).filter((plugin) => entrypoint == null || (plugin.apply?.(entrypoint) ?? true)).map((plugin) => plugin.module);
+}
+/**
+* Resolve and load plugins for each entrypoint. This handles both JS
+* entrypoints via the `virtual:wxt-plugins` import, and HTML files by adding
+* `virtual:wxt-html-plugins` to the document's `<head>`. Accepts an optional
+* `?entrypoint=<name>` query to evaluate plugin `apply` hooks per request.
+*
+* @param getEntrypoints Returns the most recently resolved entrypoints.
+*   Injected by the caller instead of read from a global, so this plugin
+*   doesn't depend on global `wxt` state.
+*/
+function wxtPluginLoader(config, getEntrypoints) {
+	const virtualModuleId = "virtual:wxt-plugins";
+	const resolvedVirtualModuleId = "\0" + virtualModuleId;
+	const virtualHtmlModuleId = "virtual:wxt-html-plugins";
+	const resolvedVirtualHtmlModuleId = "\0" + virtualHtmlModuleId;
+	function getEntrypointFromId(id) {
+		const queryIndex = id.indexOf("?");
+		if (queryIndex === -1) return void 0;
+		const entrypointNameFromQueryParam = new URLSearchParams(id.slice(queryIndex)).get("entrypoint");
+		if (!entrypointNameFromQueryParam) return void 0;
+		return getEntrypoints().find((entry) => entry.name === entrypointNameFromQueryParam);
+	}
+	return {
+		name: "wxt:plugin-loader",
+		resolveId: {
+			filter: { id: [new RegExp(`^${virtualModuleId}`), new RegExp(`^${virtualHtmlModuleId}`)] },
+			handler(id) {
+				return "\0" + id;
+			}
+		},
+		load: {
+			filter: { id: [new RegExp(`^${resolvedVirtualModuleId}`), new RegExp(`^${resolvedVirtualHtmlModuleId}`)] },
+			handler(id) {
+				const bareId = id.slice(1);
+				const entrypoint = getEntrypointFromId(bareId);
+				if (bareId === virtualModuleId || bareId.startsWith(`${virtualModuleId}?`)) {
+					const modules = getPluginModules(config.plugins, entrypoint);
+					return `${modules.map((module, i) => `import initPlugin${i} from '${normalizePath(module)}';`).join("\n")}\n\nexport function initPlugins() {\n${modules.map((_, i) => `  initPlugin${i}();`).join("\n")}\n}`;
+				} else return `import { initPlugins } from '${entrypoint ? `${virtualModuleId}?entrypoint=${encodeURIComponent(entrypoint.name)}` : virtualModuleId}';
+            try {
+              initPlugins();
+            } catch (err) {
+              console.error("[wxt] Failed to initialize plugins", err);
+            }`;
+			}
+		},
+		transformIndexHtml: {
+			order: "pre",
+			handler(html, ctx) {
+				const entrypointName = getEntrypointName(config.entrypointsDir, ctx.filename);
+				const entrypoint = getEntrypoints().find((entry) => entry.name === entrypointName);
+				const htmlModuleId = `${virtualHtmlModuleId}${entrypoint ? `?entrypoint=${encodeURIComponent(entrypoint.name)}` : ""}`;
+				const src = config.command === "serve" ? `${config.dev.server?.origin}/@id/${htmlModuleId}` : htmlModuleId;
+				const { document } = parseHTML(html);
+				if (document.querySelector(`script[src='${src}']`)) return;
+				const script = document.createElement("script");
+				script.type = "module";
+				script.src = src;
+				if (document.head == null) {
+					const newHead = document.createElement("head");
+					document.documentElement.prepend(newHead);
+				}
+				document.head?.prepend(script);
+				return document.toString();
+			}
+		}
+	};
+}
+//#endregion
+export { getPluginModules, wxtPluginLoader };

package/dist/{builtin-modules → internal/builtin-modules}/escape-unicode.mjs

@@ -1,5 +1,5 @@
-import { addViteConfig, defineWxtModule } from "../modules.mjs";
-//#region src/builtin-modules/escape-unicode.ts
+import { addViteConfig, defineWxtModule } from "../../modules/index.mjs";
+//#region src/internal/builtin-modules/escape-unicode.ts
 var escape_unicode_default = defineWxtModule({
 	name: "wxt:built-in:escape-unicode",
 	setup(wxt) {

package/dist/{builtin-modules → internal/builtin-modules}/favicon-permission.mjs

@@ -1,5 +1,5 @@
-import { defineWxtModule } from "../modules.mjs";
-//#region src/builtin-modules/favicon-permission.ts
+import { defineWxtModule } from "../../modules/index.mjs";
+//#region src/internal/builtin-modules/favicon-permission.ts
 /**
 * Adds a template-literal type for the `_favicon/` paths served by Chrome's
 * favicon API when the `favicon` permission is declared. With this module,

package/dist/{builtin-modules → internal/builtin-modules}/index.mjs

@@ -1,11 +1,13 @@
 import favicon_permission_default from "./favicon-permission.mjs";
 import unimport_default from "./unimport.mjs";
 import escape_unicode_default from "./escape-unicode.mjs";
-//#region src/builtin-modules/index.ts
+import plugins_default from "./plugins.mjs";
+//#region src/internal/builtin-modules/index.ts
 const builtinModules = [
 	unimport_default,
 	favicon_permission_default,
-	escape_unicode_default
+	escape_unicode_default,
+	plugins_default
 ];
 //#endregion
 export { builtinModules };

package/dist/internal/builtin-modules/plugins.mjs

@@ -0,0 +1,21 @@
+import { addViteConfig, defineWxtModule } from "../../modules/index.mjs";
+import { resolveVirtualModules } from "../builders/vite/plugins/resolve-virtual-modules.mjs";
+import { wxtPluginLoader } from "../builders/vite/plugins/wxt-plugin-loader.mjs";
+//#region src/internal/builtin-modules/plugins.ts
+/**
+* Owns the virtual `wxt-plugins`/`wxt-html-plugins` modules used by
+* `addWxtPlugin`. Keeps the latest resolved entrypoints in module-local state
+* instead of on the global `wxt` object.
+*/
+var plugins_default = defineWxtModule({
+	name: "wxt:built-in:plugins",
+	setup(wxt) {
+		let entrypoints = [];
+		wxt.hooks.hook("entrypoints:resolved", (_, resolved) => {
+			entrypoints = resolved;
+		});
+		addViteConfig(wxt, () => ({ plugins: [resolveVirtualModules(wxt.config), wxtPluginLoader(wxt.config, () => entrypoints)] }));
+	}
+});
+//#endregion
+export { plugins_default as default };

package/dist/{builtin-modules → internal/builtin-modules}/unimport.mjs

@@ -1,7 +1,8 @@
-import { addViteConfig, defineWxtModule } from "../modules.mjs";
+import { addViteConfig, defineWxtModule } from "../../modules/index.mjs";
+import { extname } from "node:path";
 import { createUnimport, toExports } from "unimport";
 import UnimportPlugin from "unimport/unplugin";
-//#region src/builtin-modules/unimport.ts
+//#region src/internal/builtin-modules/unimport.ts
 var unimport_default = defineWxtModule({
 	name: "wxt:built-in:unimport",
 	setup(wxt) {
@@ -25,7 +26,8 @@ var unimport_default = defineWxtModule({
 			if (!isEnabled()) return;
 			entries.push(await getImportsDeclarationEntry(unimport));
 			if (!wxt.config.imports.eslintrc.enabled) return;
-			entries.push(await getEslintConfigEntry(unimport, wxt.config.imports.eslintrc.enabled, wxt.config.imports));
+			const eslintConfigEntries = await getEslintConfigEntry(unimport, wxt.config.imports.eslintrc.enabled, wxt.config.imports);
+			entries.push(...eslintConfigEntries);
 		});
 		addViteConfig(wxt, () => ({ plugins: [UnimportPlugin.vite(wxt.config.imports)] }));
 	}
@@ -55,22 +57,22 @@ 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 {
+	return [{
 		path: options.eslintrc.filePath,
 		text: JSON.stringify({ globals }, null, 2) + "\n"
-	};
+	}];
 }
 function getEslint9ConfigEntry(options, globals) {
-	return {
+	const javaScriptFileEntry = {
 		path: options.eslintrc.filePath,
 		text: `const globals = ${JSON.stringify(globals, null, 2)}
 
@@ -84,6 +86,15 @@ export default {
 };
 `
 	};
+	const ext = extname(options.eslintrc.filePath);
+	const declarationExt = ext === ".mjs" ? ".d.mts" : ext === ".cjs" ? ".d.cts" : ".d.ts";
+	return [javaScriptFileEntry, {
+		path: options.eslintrc.filePath.slice(0, -ext.length) + declarationExt,
+		text: `import type { ConfigObject } from "@eslint/core";
+declare const config: ConfigObject;
+export default config;
+`
+	}];
 }
 //#endregion
 export { unimport_default as default };

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

@@ -1,4 +1,4 @@
-//#region src/core/utils/constants.ts
+//#region src/internal/constants.ts
 /**
 * Module ID used to build the background in dev mode if the extension doesn't
 * include a background script/service worker.

package/dist/internal/detect-builder.mjs

@@ -0,0 +1,9 @@
+import { withFirstModule } from "../internal-utils/module-utils.mjs";
+import { ViteBuilder } from "./builders/vite/index.mjs";
+import { UnknownBuilder } from "./builders/unknown.mjs";
+//#region src/internal/detect-builder.ts
+function detectBuilder(config, hooks, getWxtDevServer) {
+	return withFirstModule(async () => new ViteBuilder(await import("vite"), config, hooks, getWxtDevServer), () => new UnknownBuilder());
+}
+//#endregion
+export { detectBuilder };

package/dist/{core/utils/building → internal}/detect-dev-changes.mjs

@@ -1,7 +1,7 @@
-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
+import { normalizePath } from "../internal-utils/path-utils.mjs";
+import { every, some } from "../internal-utils/array-utils.mjs";
+import { wxt } from "./wxt.mjs";
+//#region src/internal/detect-dev-changes.ts
 /**
 * Compare the changed files vs the build output and determine what kind of
 * reload needs to happen:

package/dist/internal/detect-runner.mjs

@@ -0,0 +1,11 @@
+import { withFirstModule } from "../internal-utils/module-utils.mjs";
+import { ManualRunner } from "./runners/manual.mjs";
+import { WebExtRunner } from "./runners/web-ext.mjs";
+//#region src/internal/detect-runner.ts
+async function detectRunner(config) {
+	return withFirstModule(async () => {
+		return new WebExtRunner(await import("web-ext").then((mod) => mod.default), await import("web-ext/util/logger"), config);
+	}, () => new ManualRunner(config));
+}
+//#endregion
+export { detectRunner };

package/dist/internal/entrypoint-finders/flat.mjs

@@ -0,0 +1,84 @@
+import { CSS_EXTENSIONS_PATTERN } from "../../internal-utils/path-utils.mjs";
+import { getEntrypointName } from "../../internal-utils/entrypoint-utils.mjs";
+import { VIRTUAL_NOOP_BACKGROUND_MODULE_ID } from "../constants.mjs";
+import { resolve } from "node:path";
+import { glob } from "tinyglobby";
+import picomatch from "picomatch";
+//#region src/internal/entrypoint-finders/flat.ts
+const PATH_GLOB_TO_TYPE_MAP = {
+	"sandbox.html": "sandbox",
+	"sandbox/index.html": "sandbox",
+	"*.sandbox.html": "sandbox",
+	"*.sandbox/index.html": "sandbox",
+	"bookmarks.html": "bookmarks",
+	"bookmarks/index.html": "bookmarks",
+	"history.html": "history",
+	"history/index.html": "history",
+	"newtab.html": "newtab",
+	"newtab/index.html": "newtab",
+	"sidepanel.html": "sidepanel",
+	"sidepanel/index.html": "sidepanel",
+	"*.sidepanel.html": "sidepanel",
+	"*.sidepanel/index.html": "sidepanel",
+	"devtools.html": "devtools",
+	"devtools/index.html": "devtools",
+	"background.[jt]s": "background",
+	"background/index.[jt]s": "background",
+	[VIRTUAL_NOOP_BACKGROUND_MODULE_ID]: "background",
+	"content.[jt]s?(x)": "content-script",
+	"content/index.[jt]s?(x)": "content-script",
+	"*.content.[jt]s?(x)": "content-script",
+	"*.content/index.[jt]s?(x)": "content-script",
+	[`content.${CSS_EXTENSIONS_PATTERN}`]: "content-script-style",
+	[`*.content.${CSS_EXTENSIONS_PATTERN}`]: "content-script-style",
+	[`content/index.${CSS_EXTENSIONS_PATTERN}`]: "content-script-style",
+	[`*.content/index.${CSS_EXTENSIONS_PATTERN}`]: "content-script-style",
+	"popup.html": "popup",
+	"popup/index.html": "popup",
+	"options.html": "options",
+	"options/index.html": "options",
+	"*.html": "unlisted-page",
+	"*/index.html": "unlisted-page",
+	"*.[jt]s?(x)": "unlisted-script",
+	"*/index.[jt]s?(x)": "unlisted-script",
+	[`*.${CSS_EXTENSIONS_PATTERN}`]: "unlisted-style",
+	[`*/index.${CSS_EXTENSIONS_PATTERN}`]: "unlisted-style"
+};
+/**
+* WXT's default entrypoint finder. It looks up entrypoints using a flat folder
+* structure inside the `entrypoints.` directory, as described in the docs:
+* https://wxt.dev/guide/essentials/entrypoints.html
+*/
+var FlatEntrypointFinder = class {
+	constructor(config) {
+		this.config = config;
+	}
+	async findEntrypoints() {
+		const relativePaths = await glob(Object.keys(PATH_GLOB_TO_TYPE_MAP), {
+			cwd: this.config.entrypointsDir,
+			expandDirectories: false
+		});
+		relativePaths.sort();
+		const pathGlobs = Object.keys(PATH_GLOB_TO_TYPE_MAP);
+		return relativePaths.reduce((results, relativePath) => {
+			const inputPath = resolve(this.config.entrypointsDir, relativePath);
+			const name = getEntrypointName(this.config.entrypointsDir, inputPath);
+			const matchingGlob = pathGlobs.find((glob) => picomatch(glob)(relativePath));
+			if (matchingGlob) {
+				const type = PATH_GLOB_TO_TYPE_MAP[matchingGlob];
+				results.push({
+					name,
+					inputPath,
+					type
+				});
+			}
+			return results;
+		}, []).filter(({ name, inputPath }, _, entrypointInfos) => {
+			if (inputPath.endsWith(".html")) return true;
+			if (!/index\..+$/.test(inputPath)) return true;
+			return !entrypointInfos.some((entry) => entry.name === name && entry.inputPath.endsWith("index.html"));
+		});
+	}
+};
+//#endregion
+export { FlatEntrypointFinder };

package/dist/internal/environments/browser-environment.mjs

@@ -0,0 +1,48 @@
+import { parseHTML } from "linkedom";
+//#region src/internal/environments/browser-environment.ts
+function getBrowserEnvironmentGlobals() {
+	const { window, document, global } = parseHTML(`
+    <html>
+      <head></head>
+      <body></body>
+    </html>
+  `);
+	const location = createBuildTimeLocation("http://localhost/");
+	window.location = location;
+	global.location = location;
+	return {
+		...global,
+		window,
+		document,
+		self: global,
+		location
+	};
+}
+/**
+* A read-only stand-in for `location`. There is no page to navigate at build
+* time, so `assign`, `reload` and `replace` do nothing rather than throw.
+*/
+function createBuildTimeLocation(href) {
+	const url = new URL(href);
+	return {
+		ancestorOrigins: Object.assign([], {
+			contains: () => false,
+			item: () => null
+		}),
+		hash: url.hash,
+		host: url.host,
+		hostname: url.hostname,
+		href: url.href,
+		origin: url.origin,
+		pathname: url.pathname,
+		port: url.port,
+		protocol: url.protocol,
+		search: url.search,
+		assign: () => {},
+		reload: () => {},
+		replace: () => {},
+		toString: () => url.href
+	};
+}
+//#endregion
+export { getBrowserEnvironmentGlobals };

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

@@ -1,4 +1,4 @@
-//#region src/core/utils/environments/environment.ts
+//#region src/internal/environments/environment.ts
 function createEnvironment(getGlobals) {
 	const setup = () => {
 		const envGlobals = getGlobals();

package/dist/{core/utils → internal}/environments/extension-environment.mjs

@@ -1,7 +1,7 @@
 import { createEnvironment } from "./environment.mjs";
 import { getBrowserEnvironmentGlobals } from "./browser-environment.mjs";
 import { fakeBrowser } from "@webext-core/fake-browser";
-//#region src/core/utils/environments/extension-environment.ts
+//#region src/internal/environments/extension-environment.ts
 function createExtensionEnvironment() {
 	return createEnvironment(getExtensionEnvironmentGlobals);
 }

package/dist/{core/utils/create-file-reloader.mjs → internal/file-reloader.mjs}

@@ -1,19 +1,18 @@
-import { normalizePath } from "./paths.mjs";
-import { getEntrypointBundlePath, isHtmlEntrypoint } from "./entrypoints.mjs";
-import { filterTruthy, toArray } from "./arrays.mjs";
-import { wxt } from "../wxt.mjs";
-import { detectDevChanges, getRelevantDevChangedFiles } from "./building/detect-dev-changes.mjs";
-import { findEntrypoints } from "./building/find-entrypoints.mjs";
-import { groupEntrypoints } from "./building/group-entrypoints.mjs";
-import { getContentScriptJs, mapWxtOptionsToRegisteredContentScript } from "./content-scripts.mjs";
+import { normalizePath } from "../internal-utils/path-utils.mjs";
+import { getEntrypointBundlePath, isHtmlEntrypoint } from "../internal-utils/entrypoint-utils.mjs";
+import { filterTruthy, toArray } from "../internal-utils/array-utils.mjs";
+import { wxt } from "./wxt.mjs";
+import { findEntrypoints } from "./find-entrypoints.mjs";
+import { groupEntrypoints } from "./group-entrypoints.mjs";
+import { getContentScriptJs, mapWxtOptionsToRegisteredContentScript } from "../internal-utils/content-script-utils.mjs";
 import { getContentScriptCssFiles, getContentScriptsCssMap } from "./manifest.mjs";
-import { rebuild } from "./building/rebuild.mjs";
-import "./building/index.mjs";
+import { rebuild } from "./rebuild.mjs";
 import { isBabelSyntaxError, logBabelSyntaxError } from "./syntax-errors.mjs";
+import { detectDevChanges, getRelevantDevChangedFiles } from "./detect-dev-changes.mjs";
 import { relative } from "node:path";
 import { styleText } from "node:util";
 import { withLock } from "superlock";
-//#region src/core/utils/create-file-reloader.ts
+//#region src/internal/file-reloader.ts
 /**
 * Returns a function responsible for reloading different parts of the extension
 * when a file changes.