wxt 0.20.13 → 0.20.14

package/dist/core/utils/entrypoints.mjs

@@ -1,36 +1,59 @@
-import path, { relative, resolve, extname } from "node:path";
 import { normalizePath } from "./paths.mjs";
-export function getEntrypointName(entrypointsDir, inputPath) {
-  const relativePath = path.relative(entrypointsDir, inputPath);
-  const name = relativePath.split(/[./\\]/, 2)[0];
-  return name;
+import path, { extname, relative, resolve } from "node:path";
+
+//#region src/core/utils/entrypoints.ts
+function getEntrypointName(entrypointsDir, inputPath) {
+	return path.relative(entrypointsDir, inputPath).split(/[./\\]/, 2)[0];
 }
-export function getEntrypointOutputFile(entrypoint, ext) {
-  return resolve(entrypoint.outputDir, `${entrypoint.name}${ext}`);
+function getEntrypointOutputFile(entrypoint, ext) {
+	return resolve(entrypoint.outputDir, `${entrypoint.name}${ext}`);
 }
-export function getEntrypointBundlePath(entrypoint, outDir, ext) {
-  return normalizePath(
-    relative(outDir, getEntrypointOutputFile(entrypoint, ext))
-  );
+/**
+* Return's the entrypoint's output path relative to the output directory. Used for paths in the
+* manifest and rollup's bundle.
+*/
+function getEntrypointBundlePath(entrypoint, outDir, ext) {
+	return normalizePath(relative(outDir, getEntrypointOutputFile(entrypoint, ext)));
 }
-export function resolvePerBrowserOption(option, browser) {
-  if (typeof option === "object" && !Array.isArray(option))
-    return option[browser];
-  return option;
+/**
+* Given an entrypoint option, resolve it's value based on a target browser.
+*/
+function resolvePerBrowserOption(option, browser) {
+	if (typeof option === "object" && !Array.isArray(option)) return option[browser];
+	return option;
 }
-export function resolvePerBrowserOptions(options, browser) {
-  return Object.fromEntries(
-    Object.entries(options).map(([key, value]) => [
-      key,
-      key === "defaultIcon" ? value : resolvePerBrowserOption(value, browser)
-    ])
-  );
+/**
+* Given an entrypoint option, resolve it's value based on a target browser.
+*
+* defaultIcon is special, it's the only key that's a record, which can confuse this function. So
+* it's been manually excluded from resolution.
+*/
+function resolvePerBrowserOptions(options, browser) {
+	return Object.fromEntries(Object.entries(options).map(([key, value]) => [key, key === "defaultIcon" ? value : resolvePerBrowserOption(value, browser)]));
 }
-export function isHtmlEntrypoint(entrypoint) {
-  const ext = extname(entrypoint.inputPath);
-  return [".html"].includes(ext);
+/**
+* Returns true when the entrypoint is an HTML entrypoint.
+*
+* Naively just checking the file extension of the input path.
+*/
+function isHtmlEntrypoint(entrypoint) {
+	const ext = extname(entrypoint.inputPath);
+	return [".html"].includes(ext);
 }
-export function isJsEntrypoint(entrypoint) {
-  const ext = extname(entrypoint.inputPath);
-  return [".js", ".jsx", ".ts", ".tsx"].includes(ext);
+/**
+* Returns true when the entrypoint is a JS entrypoint.
+*
+* Naively just checking the file extension of the input path.
+*/
+function isJsEntrypoint(entrypoint) {
+	const ext = extname(entrypoint.inputPath);
+	return [
+		".js",
+		".jsx",
+		".ts",
+		".tsx"
+	].includes(ext);
 }
+
+//#endregion
+export { getEntrypointBundlePath, getEntrypointName, isHtmlEntrypoint, isJsEntrypoint, resolvePerBrowserOptions };

package/dist/core/utils/env.mjs

@@ -1,20 +1,25 @@
 import { config } from "dotenv";
 import { expand } from "dotenv-expand";
-export function loadEnv(mode, browser) {
-  return expand(
-    config({
-      quiet: true,
-      // Files on top override files below
-      path: [
-        `.env.${mode}.${browser}.local`,
-        `.env.${mode}.${browser}`,
-        `.env.${browser}.local`,
-        `.env.${browser}`,
-        `.env.${mode}.local`,
-        `.env.${mode}`,
-        `.env.local`,
-        `.env`
-      ]
-    })
-  );
+
+//#region src/core/utils/env.ts
+/**
+* Load environment files based on the current mode and browser.
+*/
+function loadEnv(mode, browser) {
+	return expand(config({
+		quiet: true,
+		path: [
+			`.env.${mode}.${browser}.local`,
+			`.env.${mode}.${browser}`,
+			`.env.${browser}.local`,
+			`.env.${browser}`,
+			`.env.${mode}.local`,
+			`.env.${mode}`,
+			`.env.local`,
+			`.env`
+		]
+	}));
 }
+
+//#endregion
+export { loadEnv };

package/dist/core/utils/environments/browser-environment.mjs

@@ -1,19 +1,20 @@
 import { parseHTML } from "linkedom";
-import { createEnvironment } from "./environment.mjs";
-export function createBrowserEnvironment() {
-  return createEnvironment(getBrowserEnvironmentGlobals);
-}
-export function getBrowserEnvironmentGlobals() {
-  const { window, document, global } = parseHTML(`
+
+//#region src/core/utils/environments/browser-environment.ts
+function getBrowserEnvironmentGlobals() {
+	const { window, document, global } = parseHTML(`
     <html>
       <head></head>
       <body></body>
     </html>
   `);
-  return {
-    ...global,
-    window,
-    document,
-    self: global
-  };
+	return {
+		...global,
+		window,
+		document,
+		self: global
+	};
 }
+
+//#endregion
+export { getBrowserEnvironmentGlobals };

package/dist/core/utils/environments/environment.mjs

@@ -1,36 +1,39 @@
-export function createEnvironment(getGlobals) {
-  const setup = () => {
-    const envGlobals = getGlobals();
-    const ogGlobals = getOgGlobals(envGlobals);
-    applyGlobals(envGlobals);
-    return () => {
-      applyGlobals(ogGlobals);
-    };
-  };
-  const run = async (fn) => {
-    const teardown = setup();
-    try {
-      return await fn();
-    } finally {
-      teardown();
-    }
-  };
-  return {
-    setup,
-    run
-  };
+//#region src/core/utils/environments/environment.ts
+function createEnvironment(getGlobals) {
+	const setup = () => {
+		const envGlobals = getGlobals();
+		const ogGlobals = getOgGlobals(envGlobals);
+		applyGlobals(envGlobals);
+		return () => {
+			applyGlobals(ogGlobals);
+		};
+	};
+	const run = async (fn) => {
+		const teardown = setup();
+		try {
+			return await fn();
+		} finally {
+			teardown();
+		}
+	};
+	return {
+		setup,
+		run
+	};
 }
-export function getOgGlobals(envGlobals) {
-  return Object.keys(envGlobals).reduce((acc, key) => {
-    acc[key] = globalThis[key];
-    return acc;
-  }, {});
+function getOgGlobals(envGlobals) {
+	return Object.keys(envGlobals).reduce((acc, key) => {
+		acc[key] = globalThis[key];
+		return acc;
+	}, {});
 }
-export function applyGlobals(globals) {
-  Object.entries(globals).forEach(([key, envValue]) => {
-    try {
-      globalThis[key] = envValue;
-    } catch {
-    }
-  });
+function applyGlobals(globals) {
+	Object.entries(globals).forEach(([key, envValue]) => {
+		try {
+			globalThis[key] = envValue;
+		} catch {}
+	});
 }
+
+//#endregion
+export { createEnvironment };

package/dist/core/utils/environments/extension-environment.mjs

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

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

@@ -1,2 +1,4 @@
-export * from "./browser-environment.mjs";
-export * from "./extension-environment.mjs";
+import { getBrowserEnvironmentGlobals } from "./browser-environment.mjs";
+import { createExtensionEnvironment, getExtensionEnvironmentGlobals } from "./extension-environment.mjs";
+
+export {  };

package/dist/core/utils/eslint.mjs

@@ -1,11 +1,12 @@
-export async function getEslintVersion() {
-  try {
-    const require = (await import("node:module")).default.createRequire(
-      import.meta.url
-    );
-    const { ESLint } = require("eslint");
-    return ESLint.version?.split(".") ?? [];
-  } catch {
-    return [];
-  }
+//#region src/core/utils/eslint.ts
+async function getEslintVersion() {
+	try {
+		const { ESLint } = (await import("node:module")).default.createRequire(import.meta.url)("eslint");
+		return ESLint.version?.split(".") ?? [];
+	} catch {
+		return [];
+	}
 }
+
+//#endregion
+export { getEslintVersion };

package/dist/core/utils/fs.mjs

@@ -1,15 +1,27 @@
-import fs from "fs-extra";
-import glob from "fast-glob";
 import { unnormalizePath } from "./paths.mjs";
 import { wxt } from "../wxt.mjs";
-export async function writeFileIfDifferent(file, newContents) {
-  const existingContents = await fs.readFile(file, "utf-8").catch(() => void 0);
-  if (existingContents !== newContents) {
-    await fs.writeFile(file, newContents);
-  }
+import fs from "fs-extra";
+import glob from "fast-glob";
+
+//#region src/core/utils/fs.ts
+/**
+* Only write the contents to a file if it results in a change. This prevents unnecessary file
+* watchers from being triggered, like WXT's dev server or the TS language server in editors.
+*
+* @param file The file to write to.
+* @param newContents The new text content to write.
+*/
+async function writeFileIfDifferent(file, newContents) {
+	if (await fs.readFile(file, "utf-8").catch(() => void 0) !== newContents) await fs.writeFile(file, newContents);
 }
-export async function getPublicFiles() {
-  if (!await fs.exists(wxt.config.publicDir)) return [];
-  const files = await glob("**/*", { cwd: wxt.config.publicDir });
-  return files.map(unnormalizePath);
+/**
+* Get all the files in the project's public directory. Returned paths are relative to the
+* `config.publicDir`.
+*/
+async function getPublicFiles() {
+	if (!await fs.exists(wxt.config.publicDir)) return [];
+	return (await glob("**/*", { cwd: wxt.config.publicDir })).map(unnormalizePath);
 }
+
+//#endregion
+export { getPublicFiles, writeFileIfDifferent };

package/dist/core/utils/globals.mjs

@@ -1,53 +1,55 @@
-export function getGlobals(config) {
-  return [
-    {
-      name: "MANIFEST_VERSION",
-      value: config.manifestVersion,
-      type: `2 | 3`
-    },
-    {
-      name: "BROWSER",
-      value: config.browser,
-      type: config.targetBrowsers.length === 0 ? "string" : config.targetBrowsers.map((browser) => `"${browser}"`).join(" | ")
-    },
-    {
-      name: "CHROME",
-      value: config.browser === "chrome",
-      type: `boolean`
-    },
-    {
-      name: "FIREFOX",
-      value: config.browser === "firefox",
-      type: `boolean`
-    },
-    {
-      name: "SAFARI",
-      value: config.browser === "safari",
-      type: `boolean`
-    },
-    {
-      name: "EDGE",
-      value: config.browser === "edge",
-      type: `boolean`
-    },
-    {
-      name: "OPERA",
-      value: config.browser === "opera",
-      type: `boolean`
-    },
-    {
-      name: "COMMAND",
-      value: config.command,
-      type: `"build" | "serve"`
-    }
-  ];
+//#region src/core/utils/globals.ts
+function getGlobals(config) {
+	return [
+		{
+			name: "MANIFEST_VERSION",
+			value: config.manifestVersion,
+			type: `2 | 3`
+		},
+		{
+			name: "BROWSER",
+			value: config.browser,
+			type: config.targetBrowsers.length === 0 ? "string" : config.targetBrowsers.map((browser) => `"${browser}"`).join(" | ")
+		},
+		{
+			name: "CHROME",
+			value: config.browser === "chrome",
+			type: `boolean`
+		},
+		{
+			name: "FIREFOX",
+			value: config.browser === "firefox",
+			type: `boolean`
+		},
+		{
+			name: "SAFARI",
+			value: config.browser === "safari",
+			type: `boolean`
+		},
+		{
+			name: "EDGE",
+			value: config.browser === "edge",
+			type: `boolean`
+		},
+		{
+			name: "OPERA",
+			value: config.browser === "opera",
+			type: `boolean`
+		},
+		{
+			name: "COMMAND",
+			value: config.command,
+			type: `"build" | "serve"`
+		}
+	];
 }
-export function getEntrypointGlobals(entrypointName) {
-  return [
-    {
-      name: "ENTRYPOINT",
-      value: entrypointName,
-      type: `string`
-    }
-  ];
+function getEntrypointGlobals(entrypointName) {
+	return [{
+		name: "ENTRYPOINT",
+		value: entrypointName,
+		type: `string`
+	}];
 }
+
+//#endregion
+export { getEntrypointGlobals, getGlobals };

package/dist/core/utils/i18n.mjs

@@ -1,35 +1,44 @@
+//#region src/core/utils/i18n.ts
 const predefinedMessages = {
-  "@@extension_id": {
-    message: "<browser.runtime.id>",
-    description: "The extension or app ID; you might use this string to construct URLs for resources inside the extension. Even unlocalized extensions can use this message.\nNote: You can't use this message in a manifest file."
-  },
-  "@@ui_locale": {
-    message: "<browser.i18n.getUiLocale()>",
-    description: ""
-  },
-  "@@bidi_dir": {
-    message: "<ltr|rtl>",
-    description: 'The text direction for the current locale, either "ltr" for left-to-right languages such as English or "rtl" for right-to-left languages such as Japanese.'
-  },
-  "@@bidi_reversed_dir": {
-    message: "<rtl|ltr>",
-    description: `If the @@bidi_dir is "ltr", then this is "rtl"; otherwise, it's "ltr".`
-  },
-  "@@bidi_start_edge": {
-    message: "<left|right>",
-    description: `If the @@bidi_dir is "ltr", then this is "left"; otherwise, it's "right".`
-  },
-  "@@bidi_end_edge": {
-    message: "<right|left>",
-    description: `If the @@bidi_dir is "ltr", then this is "right"; otherwise, it's "left".`
-  }
+	"@@extension_id": {
+		message: "<browser.runtime.id>",
+		description: "The extension or app ID; you might use this string to construct URLs for resources inside the extension. Even unlocalized extensions can use this message.\nNote: You can't use this message in a manifest file."
+	},
+	"@@ui_locale": {
+		message: "<browser.i18n.getUiLocale()>",
+		description: ""
+	},
+	"@@bidi_dir": {
+		message: "<ltr|rtl>",
+		description: "The text direction for the current locale, either \"ltr\" for left-to-right languages such as English or \"rtl\" for right-to-left languages such as Japanese."
+	},
+	"@@bidi_reversed_dir": {
+		message: "<rtl|ltr>",
+		description: "If the @@bidi_dir is \"ltr\", then this is \"rtl\"; otherwise, it's \"ltr\"."
+	},
+	"@@bidi_start_edge": {
+		message: "<left|right>",
+		description: "If the @@bidi_dir is \"ltr\", then this is \"left\"; otherwise, it's \"right\"."
+	},
+	"@@bidi_end_edge": {
+		message: "<right|left>",
+		description: "If the @@bidi_dir is \"ltr\", then this is \"right\"; otherwise, it's \"left\"."
+	}
 };
-export function parseI18nMessages(messagesJson) {
-  return Object.entries({
-    ...predefinedMessages,
-    ...messagesJson
-  }).map(([name, details]) => ({
-    name,
-    ...details
-  }));
+/**
+* Get a list of all messages and their metadata from JSON file contents.
+*
+* @param messagesJson The contents of a `_locales/en/messages.json` file.
+*/
+function parseI18nMessages(messagesJson) {
+	return Object.entries({
+		...predefinedMessages,
+		...messagesJson
+	}).map(([name, details]) => ({
+		name,
+		...details
+	}));
 }
+
+//#endregion
+export { parseI18nMessages };

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

@@ -1,4 +1,6 @@
-export * from "./printBuildSummary.mjs";
-export * from "./printFileList.mjs";
-export * from "./printHeader.mjs";
-export * from "./printTable.mjs";
+import { printTable } from "./printTable.mjs";
+import { printFileList } from "./printFileList.mjs";
+import { printBuildSummary } from "./printBuildSummary.mjs";
+import { printHeader } from "./printHeader.mjs";
+
+export {  };

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

@@ -1,32 +1,27 @@
-import { resolve } from "path";
-import { printFileList } from "./printFileList.mjs";
 import { wxt } from "../../wxt.mjs";
-export async function printBuildSummary(log, header, output) {
-  const chunks = [
-    ...output.steps.flatMap((step) => step.chunks),
-    ...output.publicAssets
-  ].sort((l, r) => {
-    const lWeight = getChunkSortWeight(l.fileName);
-    const rWeight = getChunkSortWeight(r.fileName);
-    const diff = lWeight - rWeight;
-    if (diff !== 0) return diff;
-    return l.fileName.localeCompare(r.fileName);
-  });
-  const files = chunks.map(
-    (chunk) => resolve(wxt.config.outDir, chunk.fileName)
-  );
-  await printFileList(log, header, wxt.config.outDir, files);
+import { printFileList } from "./printFileList.mjs";
+import { resolve } from "path";
+
+//#region src/core/utils/log/printBuildSummary.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);
+		if (diff !== 0) return diff;
+		return l.fileName.localeCompare(r.fileName);
+	}).map((chunk) => resolve(wxt.config.outDir, chunk.fileName));
+	await printFileList(log, header, wxt.config.outDir, files);
 }
 const DEFAULT_SORT_WEIGHT = 100;
 const CHUNK_SORT_WEIGHTS = {
-  "manifest.json": 0,
-  ".html": 1,
-  ".js.map": 2,
-  ".js": 2,
-  ".css": 3
+	"manifest.json": 0,
+	".html": 1,
+	".js.map": 2,
+	".js": 2,
+	".css": 3
 };
 function getChunkSortWeight(filename) {
-  return Object.entries(CHUNK_SORT_WEIGHTS).find(
-    ([key]) => filename.endsWith(key)
-  )?.[1] ?? DEFAULT_SORT_WEIGHT;
+	return Object.entries(CHUNK_SORT_WEIGHTS).find(([key]) => filename.endsWith(key))?.[1] ?? DEFAULT_SORT_WEIGHT;
 }
+
+//#endregion
+export { printBuildSummary };