wxt 0.20.18 → 0.20.20

package/dist/core/utils/paths.mjs

@@ -1,29 +1,27 @@
 import path from "node:path";
 import normalize from "normalize-path";
-
 //#region src/core/utils/paths.ts
 /**
-* Converts system paths to normalized bundler path.
-* On Windows, this returns paths with `/` instead of `\`.
+* Converts system paths to normalized bundler path. On Windows, this returns
+* paths with `/` instead of `\`.
 */
 function normalizePath(path) {
 	return normalize(path);
 }
 /**
-* Given a normalized path, convert it to the system path style. On Windows, switch to \, otherwise use /.
+* Given a normalized path, convert it to the system path style. On Windows,
+* switch to , otherwise use /.
 */
 function unnormalizePath(path$1) {
 	return path.normalize(path$1);
 }
-const CSS_EXTENSIONS = [
+const CSS_EXTENSIONS_PATTERN = `+(${[
 	"css",
 	"scss",
 	"sass",
 	"less",
 	"styl",
 	"stylus"
-];
-const CSS_EXTENSIONS_PATTERN = `+(${CSS_EXTENSIONS.join("|")})`;
-
+].join("|")})`;
 //#endregion
-export { CSS_EXTENSIONS_PATTERN, normalizePath, unnormalizePath };
+export { CSS_EXTENSIONS_PATTERN, normalizePath, unnormalizePath };

package/dist/core/utils/strings.mjs

@@ -1,23 +1,20 @@
 import { camelCase } from "scule";
-
 //#region src/core/utils/strings.ts
 function kebabCaseAlphanumeric(str) {
 	return str.toLowerCase().replace(/[^a-z0-9-\s]/g, "").replace(/\s+/g, "-");
 }
-/**
-* Return a safe variable name for a given string.
-*/
+/** Return a safe variable name for a given string. */
 function safeVarName(str) {
 	const name = camelCase(kebabCaseAlphanumeric(str));
 	if (name.match(/^[a-z]/)) return name;
 	return "_" + name;
 }
 /**
-* Converts a string to a valid filename (NOT path), stripping out invalid characters.
+* Converts a string to a valid filename (NOT path), stripping out invalid
+* characters.
 */
 function safeFilename(str) {
 	return kebabCaseAlphanumeric(str);
 }
-
 //#endregion
-export { safeFilename, safeVarName };
+export { safeFilename, safeVarName };

package/dist/core/utils/syntax-errors.mjs

@@ -1,7 +1,6 @@
 import { wxt } from "../wxt.mjs";
 import { relative } from "node:path";
 import pc from "picocolors";
-
 //#region src/core/utils/syntax-errors.ts
 function isBabelSyntaxError(error) {
 	return error instanceof SyntaxError && error.code === "BABEL_PARSER_SYNTAX_ERROR";
@@ -13,6 +12,5 @@ function logBabelSyntaxError(error) {
 	if (error.frame) message += "\n\n" + pc.red(error.frame);
 	wxt.logger.error(message);
 }
-
 //#endregion
-export { isBabelSyntaxError, logBabelSyntaxError };
+export { isBabelSyntaxError, logBabelSyntaxError };

package/dist/core/utils/time.mjs

@@ -5,9 +5,7 @@ function formatDuration(duration) {
 	if (duration < 6e4) return `${(duration / 1e3).toFixed(1)} s`;
 	return `${(duration / 1e3).toFixed(0)} s`;
 }
-/**
-* Add a timeout to a promise.
-*/
+/** Add a timeout to a promise. */
 function withTimeout(promise, duration) {
 	return new Promise((res, rej) => {
 		const timeout = setTimeout(() => {
@@ -16,6 +14,5 @@ function withTimeout(promise, duration) {
 		promise.then(res).catch(rej).finally(() => clearTimeout(timeout));
 	});
 }
-
 //#endregion
-export { formatDuration, withTimeout };
+export { formatDuration, withTimeout };

package/dist/core/utils/transform.mjs

@@ -1,12 +1,14 @@
 import { parseModule } from "magicast";
-
 //#region src/core/utils/transform.ts
 /**
 * Removes any code used at runtime related to an entrypoint's main function.
+*
 * 1. Removes or clears out `main` function from returned object
-* 2. Removes any unused functions/variables outside the definition that aren't being called/used
+* 2. Removes any unused functions/variables outside the definition that aren't
+*    being called/used
 * 3. Removes unused imports
-* 3. Removes value-less, side-effect only imports (like `import "./styles.css"` or `import "polyfill"`)
+* 4. Removes value-less, side-effect only imports (like `import "./styles.css"` or
+*    `import "polyfill"`)
 */
 function removeMainFunctionCode(code) {
 	const mod = parseModule(code);
@@ -134,7 +136,8 @@ function removeSideEffectImports(mod) {
 	deleteImportAst(mod, (node) => node.specifiers.length === 0);
 }
 /**
-* Util to get the AST as a simple JSON object, stripping out large objects and file locations to keep it readible
+* Util to get the AST as a simple JSON object, stripping out large objects and
+* file locations to keep it readible
 */
 function getSimpleAstJson(ast) {
 	if (!ast) return ast;
@@ -142,6 +145,5 @@ function getSimpleAstJson(ast) {
 	else if (typeof ast === "object") return Object.fromEntries(Object.entries(ast).filter(([key]) => key !== "loc" && key !== "start" && key !== "end").map(([key, value]) => [key, getSimpleAstJson(value)]));
 	else return ast;
 }
-
 //#endregion
-export { removeMainFunctionCode };
+export { removeMainFunctionCode };

package/dist/core/utils/validation.mjs

@@ -43,6 +43,5 @@ function validateBaseEntrypoint(definition) {
 	return errors;
 }
 var ValidationError = class extends Error {};
-
 //#endregion
-export { ValidationError, validateEntrypoints };
+export { ValidationError, validateEntrypoints };

package/dist/core/utils/virtual-modules.mjs

@@ -1,22 +1,16 @@
-//#region src/core/utils/virtual-modules.ts
-const virtualEntrypointTypes = [
-	"content-script-main-world",
-	"content-script-isolated-world",
-	"background",
-	"unlisted-script"
-];
-/**
-* All the names of entrypoint files in the `src/virtual/` and `dist/virtual/` directories, minus the extension.
-*/
-const virtualEntrypointModuleNames = virtualEntrypointTypes.map((name) => `${name}-entrypoint`);
 /**
-* All the names of files in the `src/virtual/` and `dist/virtual/` directories, minus the extension.
+* All the names of files in the `src/virtual/` and `dist/virtual/` directories,
+* minus the extension.
 */
 const virtualModuleNames = [
-	...virtualEntrypointModuleNames,
+	...[
+		"content-script-main-world",
+		"content-script-isolated-world",
+		"background",
+		"unlisted-script"
+	].map((name) => `${name}-entrypoint`),
 	"mock-browser",
 	"reload-html"
 ];
-
 //#endregion
-export { virtualModuleNames };
+export { virtualModuleNames };

package/dist/core/utils/wsl.mjs

@@ -1,12 +1,8 @@
 import isWsl_ from "is-wsl";
-
 //#region src/core/utils/wsl.ts
-/**
-* Returns true when running on WSL or WSL2.
-*/
+/** Returns true when running on WSL or WSL2. */
 function isWsl() {
 	return isWsl_;
 }
-
 //#endregion
-export { isWsl };
+export { isWsl };

package/dist/core/wxt.mjs

@@ -4,15 +4,16 @@ import { createWxtPackageManager } from "./package-managers/index.mjs";
 import { createViteBuilder } from "./builders/vite/index.mjs";
 import { relative } from "path";
 import { createHooks } from "hookable";
-
 //#region src/core/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 function parameter everywhere.
+* 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
+* function parameter everywhere.
 */
 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");
@@ -63,12 +64,9 @@ async function initWxtModule(module) {
 	if (module.hooks) wxt.hooks.addHooks(module.hooks);
 	await module.setup?.(wxt, module.configKey ? wxt.config[module.configKey] : void 0);
 }
-/**
-* Unloads WXT modules.
-*/
+/** Unloads WXT modules. */
 function deinitWxtModules() {
 	wxt.hooks.removeAllHooks();
 }
-
 //#endregion
-export { deinitWxtModules, initWxtModules, registerWxt, wxt };
+export { deinitWxtModules, initWxtModules, registerWxt, wxt };

package/dist/core/zip.d.mts

@@ -3,6 +3,7 @@ import { InlineConfig } from "../types.mjs";
 //#region src/core/zip.d.ts
 /**
  * Build and zip the extension for distribution.
+ *
  * @param config Optional config that will override your `<root>/wxt.config.ts`.
  * @returns A list of all files included in the ZIP.
  */

package/dist/core/zip.mjs

@@ -10,14 +10,15 @@ import { getPackageJson } from "./utils/package.mjs";
 import { internalBuild } from "./utils/building/internal-build.mjs";
 import "./utils/building/index.mjs";
 import { minimatchMultiple } from "./utils/minimatch-multiple.mjs";
-import fs from "fs-extra";
-import glob from "fast-glob";
+import { mkdir, readFile } from "node:fs/promises";
+import { glob } from "tinyglobby";
 import path from "node:path";
+import { createWriteStream } from "node:fs";
 import JSZip from "jszip";
-
 //#region src/core/zip.ts
 /**
 * Build and zip the extension for distribution.
+*
 * @param config Optional config that will override your `<root>/wxt.config.ts`.
 * @returns A list of all files included in the ZIP.
 */
@@ -31,7 +32,7 @@ async function zip(config) {
 	const packageJson = await getPackageJson();
 	const projectName = wxt.config.zip.name ?? safeFilename(packageJson?.name || path.basename(process.cwd()));
 	const applyTemplate = (template) => template.replaceAll("{{name}}", projectName).replaceAll("{{browser}}", wxt.config.browser).replaceAll("{{version}}", output.manifest.version_name ?? output.manifest.version).replaceAll("{{packageVersion}}", packageJson?.version).replaceAll("{{mode}}", wxt.config.mode).replaceAll("{{manifestVersion}}", `mv${wxt.config.manifestVersion}`);
-	await fs.ensureDir(wxt.config.outBaseDir);
+	await mkdir(wxt.config.outBaseDir, { recursive: true });
 	await wxt.hooks.callHook("zip:extension:start", wxt);
 	const outZipFilename = applyTemplate(wxt.config.zip.artifactTemplate);
 	const outZipPath = path.resolve(wxt.config.outBaseDir, outZipFilename);
@@ -65,17 +66,18 @@ async function zipDir(directory, outputPath, options) {
 	const filesToZip = [...(await glob(["**/*", ...options?.include || []], {
 		cwd: directory,
 		ignore: ["**/node_modules"],
-		onlyFiles: true
+		onlyFiles: true,
+		expandDirectories: false
 	})).filter((relativePath) => {
 		return minimatchMultiple(relativePath, options?.include) || !minimatchMultiple(relativePath, options?.exclude);
 	}), ...(options?.additionalFiles ?? []).map((file) => path.relative(directory, file))];
 	for (const file of filesToZip) {
 		const absolutePath = path.resolve(directory, file);
 		if (file.endsWith(".json")) {
-			const content = await fs.readFile(absolutePath, "utf-8");
+			const content = await readFile(absolutePath, "utf-8");
 			archive.file(file, await options?.transform?.(absolutePath, file, content) || content);
 		} else {
-			const content = await fs.readFile(absolutePath);
+			const content = await readFile(absolutePath);
 			archive.file(file, content);
 		}
 	}
@@ -86,7 +88,7 @@ async function zipDir(directory, outputPath, options) {
 			compression: "DEFLATE",
 			compressionOptions: { level: wxt.config.zip.compressionLevel }
 		}
-	}).pipe(fs.createWriteStream(outputPath)).on("error", reject).on("close", resolve));
+	}).pipe(createWriteStream(outputPath)).on("error", reject).on("close", resolve));
 }
 async function downloadPrivatePackages() {
 	const overrides = {};
@@ -123,6 +125,5 @@ function addOverridesToPackageJson(absolutePackageJsonPath, content, overrides)
 	});
 	return JSON.stringify(newPackage, null, 2);
 }
-
 //#endregion
-export { zip };
+export { zip };

package/dist/index.d.mts

@@ -8,6 +8,5 @@ import { initialize } from "./core/initialize.mjs";
 import { prepare } from "./core/prepare.mjs";
 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, 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/index.mjs

@@ -9,5 +9,4 @@ import { initialize } from "./core/initialize.mjs";
 import { prepare } from "./core/prepare.mjs";
 import { zip } from "./core/zip.mjs";
 import "./core/index.mjs";
-
-export { build, clean, createServer, defineConfig, defineRunnerConfig, defineWebExtConfig, initialize, normalizePath, prepare, version, zip };
+export { build, clean, createServer, defineConfig, defineRunnerConfig, defineWebExtConfig, initialize, normalizePath, prepare, version, zip };

package/dist/modules.d.mts

@@ -16,20 +16,20 @@ declare function defineWxtModule<TOptions extends WxtModuleOptions>(module: WxtM
  * To extract entrypoint options from a JS/TS file, use
  * `wxt.builder.importEntrypoint` (see example).
  *
- * @param wxt The wxt instance provided by the module's setup function.
- * @param entrypoint The entrypoint to be bundled along with the extension.
- *
  * @example
- * export default defineWxtModule(async (wxt, options) => {
- *   const entrypointPath = "/path/to/my-entrypoint.ts";
- *   addEntrypoint(wxt, {
- *     type: "content-script",
- *     name: "some-name",
- *     inputPath: entrypointPath,
- *     outputDir: wxt.config.outDir,
- *     options: await wxt.builder.importEntrypoint(entrypointPath),
+ *   export default defineWxtModule(async (wxt, options) => {
+ *     const entrypointPath = '/path/to/my-entrypoint.ts';
+ *     addEntrypoint(wxt, {
+ *       type: 'content-script',
+ *       name: 'some-name',
+ *       inputPath: entrypointPath,
+ *       outputDir: wxt.config.outDir,
+ *       options: await wxt.builder.importEntrypoint(entrypointPath),
+ *     });
  *   });
- * });
+ *
+ * @param wxt The wxt instance provided by the module's setup function.
+ * @param entrypoint The entrypoint to be bundled along with the extension.
  */
 declare function addEntrypoint(wxt: Wxt, entrypoint: Entrypoint): void;
 /**
@@ -37,79 +37,82 @@ declare function addEntrypoint(wxt: Wxt, entrypoint: Entrypoint): void;
  * extension's output directory. The directory itself is not copied, just the
  * files inside it. If a filename matches an existing one, it is ignored.
  *
+ * @example
+ *   export default defineWxtModule((wxt, options) => {
+ *     addPublicAssets(wxt, './dist/prebundled');
+ *   });
+ *
  * @param wxt The wxt instance provided by the module's setup function.
  * @param dir The directory to copy.
- *
- * @example
- * export default defineWxtModule((wxt, options) => {
- *   addPublicAssets(wxt, "./dist/prebundled");
- * });
  */
 declare function addPublicAssets(wxt: Wxt, dir: string): void;
 /**
- * Merge additional vite config for one or more entrypoint "groups" that make
- * up individual builds. Config in the project's `wxt.config.ts` file takes
+ * Merge additional vite config for one or more entrypoint "groups" that make up
+ * individual builds. Config in the project's `wxt.config.ts` file takes
  * precedence over any config added by this function.
  *
- * @param wxt The wxt instance provided by the module's setup function.
- * @param viteConfig A function that returns the vite config the module is
-                     adding. Same format as `vite` in `wxt.config.ts`.
- *
  * @example
- * export default defineWxtModule((wxt, options) => {
+ *   export default defineWxtModule((wxt, options) => {
  *   addViteConfig(wxt, () => ({
- *     build: {
- *       sourceMaps: true,
- *     },
+ *   build: {
+ *   sourceMaps: true,
+ *   },
  *   });
- * });
+ *   });
+ *
+ * @param wxt The wxt instance provided by the module's setup function.
+ * @param viteConfig A function that returns the vite config the module is
+ *   adding. Same format as `vite` in `wxt.config.ts`.
  */
 declare function addViteConfig(wxt: Wxt, viteConfig: (env: vite.ConfigEnv) => vite.UserConfig | undefined): void;
 /**
- * Add a runtime plugin to the project. In each entrypoint, before executing
- * the `main` function, plugins are executed.
+ * Add a runtime plugin to the project. In each entrypoint, before executing the
+ * `main` function, plugins are executed.
+ *
+ * @example
+ *   export default defineWxtModule((wxt) => {
+ *     addWxtPlugin(wxt, 'wxt-module-analytics/client-plugin');
+ *   });
  *
  * @param wxt The wxt instance provided by the module's setup function.
  * @param plugin An import from an NPM module, or an absolute file path to the
- *               file to load at runtime.
- *
- * @example
- * export default defineWxtModule((wxt) => {
- *   addWxtPlugin(wxt, "wxt-module-analytics/client-plugin");
- * });
+ *   file to load at runtime.
  */
 declare function addWxtPlugin(wxt: Wxt, plugin: string): void;
 /**
- * Add an Unimport preset ([built-in](https://github.com/unjs/unimport?tab=readme-ov-file#built-in-presets),
+ * Add an Unimport preset
+ * ([built-in](https://github.com/unjs/unimport?tab=readme-ov-file#built-in-presets),
  * [custom](https://github.com/unjs/unimport?tab=readme-ov-file#custom-presets),
- * or [auto-scanned](https://github.com/unjs/unimport?tab=readme-ov-file#exports-auto-scan)),
+ * or
+ * [auto-scanned](https://github.com/unjs/unimport?tab=readme-ov-file#exports-auto-scan)),
  * to the project's list of auto-imported utilities.
  *
  * Some things to note:
- * - This function will only de-duplicate built-in preset names. It will not
- *   stop you adding duplicate custom or auto-scanned presets.
- * - If the project has disabled imports, this function has no effect.
  *
- * @param wxt The wxt instance provided by the module's setup function.
- * @param preset The preset to add to the project.
+ * - This function will only de-duplicate built-in preset names. It will not stop
+ *   you adding duplicate custom or auto-scanned presets.
+ * - If the project has disabled imports, this function has no effect.
  *
  * @example
- * export default defineWxtModule((wxt) => {
+ *   export default defineWxtModule((wxt) => {
  *   // Built-in preset:
  *   addImportPreset(wxt, "vue");
  *   // Custom preset:
  *   addImportPreset(wxt, {
- *     from: "vue",
- *     imports: ["ref", "reactive", ...],
+ *   from: "vue",
+ *   imports: ["ref", "reactive", ...],
  *   });
  *   // Auto-scanned preset:
  *   addImportPreset(wxt, { package: "vue" });
- * });
+ *   });
+ *
+ * @param wxt The wxt instance provided by the module's setup function.
+ * @param preset The preset to add to the project.
  */
 declare function addImportPreset(wxt: Wxt, preset: UnimportOptions['presets'][0]): void;
 /**
- * Adds an import alias to the project's TSConfig paths and bundler. Path can
- * be absolute or relative to the project's root directory.
+ * Adds an import alias to the project's TSConfig paths and bundler. Path can be
+ * absolute or relative to the project's root directory.
  *
  * Usually, this is used to provide access to some code generated by your
  * module. In the example below, a `i18n` plugin generates a variable that it
@@ -117,22 +120,22 @@ declare function addImportPreset(wxt: Wxt, preset: UnimportOptions['presets'][0]
  * to it.
  *
  * @example
- * import path from 'node:path';
+ *   import path from 'node:path';
  *
- * export default defineWxtModule((wxt) => {
- *   const i18nPath = path.resolve(wxt.config.wxtDir, "i18n.ts");
+ *   export default defineWxtModule((wxt) => {
+ *     const i18nPath = path.resolve(wxt.config.wxtDir, 'i18n.ts');
  *
- *   // Generate the file
- *   wxt.hooks.hook("prepare:types", (_, entries) => {
- *     entries.push({
- *       path: i18nPath,
- *       text: `export const i18n = ...`,
+ *     // Generate the file
+ *     wxt.hooks.hook('prepare:types', (_, entries) => {
+ *       entries.push({
+ *         path: i18nPath,
+ *         text: `export const i18n = ...`,
+ *       });
  *     });
- *   });
  *
- *   // Add alias
- *   addAlias(wxt, "#i18n", i18nPath);
- * });
+ *     // Add alias
+ *     addAlias(wxt, '#i18n', i18nPath);
+ *   });
  */
 declare function addAlias(wxt: Wxt, alias: string, path: string): void;
 //#endregion