wxt 0.20.12 → 0.20.14

package/dist/browser.d.mts

@@ -0,0 +1,20 @@
+import { Browser, browser as browser$1 } from "@wxt-dev/browser";
+
+//#region src/browser.d.ts
+/**
+ * This interface is empty because it is generated per-project when running `wxt prepare`. See:
+ * - `.wxt/types/paths.d.ts`
+ */
+interface WxtRuntime {}
+/**
+ * This interface is empty because it is generated per-project when running `wxt prepare`. See:
+ * - `.wxt/types/i18n.d.ts`
+ */
+interface WxtI18n {}
+type WxtBrowser = Omit<typeof browser$1, 'runtime' | 'i18n'> & {
+  runtime: WxtRuntime & Omit<(typeof browser$1)['runtime'], 'getURL'>;
+  i18n: WxtI18n & Omit<(typeof browser$1)['i18n'], 'getMessage'>;
+};
+declare const browser: WxtBrowser;
+//#endregion
+export { Browser, WxtBrowser, WxtI18n, WxtRuntime, browser };

package/dist/browser.mjs

@@ -1,3 +1,18 @@
-import { browser as _browser } from "@wxt-dev/browser";
-export const browser = _browser;
-export {};
+import { browser as browser$1 } from "@wxt-dev/browser";
+
+//#region src/browser.ts
+/**
+* Contains the `browser` export which you should use to access the extension APIs in your project:
+* ```ts
+* import { browser } from 'wxt/browser';
+*
+* browser.runtime.onInstalled.addListener(() => {
+*   // ...
+* })
+* ```
+* @module wxt/browser
+*/
+const browser = browser$1;
+
+//#endregion
+export { browser };

package/dist/builtin-modules/index.mjs

@@ -1,2 +1,7 @@
-import unimport from "./unimport.mjs";
-export const builtinModules = [unimport];
+import unimport_default from "./unimport.mjs";
+
+//#region src/builtin-modules/index.ts
+const builtinModules = [unimport_default];
+
+//#endregion
+export { builtinModules };

package/dist/builtin-modules/unimport.mjs

@@ -1,88 +1,79 @@
 import { addViteConfig, defineWxtModule } from "../modules.mjs";
 import { createUnimport, toExports } from "unimport";
 import UnimportPlugin from "unimport/unplugin";
-export default defineWxtModule({
-  name: "wxt:built-in:unimport",
-  setup(wxt) {
-    let unimport;
-    const isEnabled = () => !wxt.config.imports.disabled;
-    wxt.hooks.hook("config:resolved", () => {
-      const addModuleImports = (module) => {
-        if (!module.imports) return;
-        wxt.config.imports.imports ??= [];
-        wxt.config.imports.imports.push(...module.imports);
-      };
-      wxt.config.builtinModules.forEach(addModuleImports);
-      wxt.config.userModules.forEach(addModuleImports);
-    });
-    wxt.hooks.afterEach((event) => {
-      if (event.name === "config:resolved") {
-        unimport = createUnimport(wxt.config.imports);
-      }
-    });
-    wxt.hooks.hook("prepare:types", async (_, entries) => {
-      await unimport.init();
-      entries.push(await getImportsModuleEntry(wxt, unimport));
-      if (!isEnabled()) return;
-      entries.push(await getImportsDeclarationEntry(unimport));
-      if (wxt.config.imports.eslintrc.enabled === false) return;
-      entries.push(
-        await getEslintConfigEntry(
-          unimport,
-          wxt.config.imports.eslintrc.enabled,
-          wxt.config.imports
-        )
-      );
-    });
-    addViteConfig(wxt, () => ({
-      plugins: [UnimportPlugin.vite(wxt.config.imports)]
-    }));
-  }
+
+//#region src/builtin-modules/unimport.ts
+var unimport_default = defineWxtModule({
+	name: "wxt:built-in:unimport",
+	setup(wxt) {
+		let unimport;
+		const isEnabled = () => !wxt.config.imports.disabled;
+		wxt.hooks.hook("config:resolved", () => {
+			const addModuleImports = (module) => {
+				if (!module.imports) return;
+				wxt.config.imports.imports ??= [];
+				wxt.config.imports.imports.push(...module.imports);
+			};
+			wxt.config.builtinModules.forEach(addModuleImports);
+			wxt.config.userModules.forEach(addModuleImports);
+		});
+		wxt.hooks.afterEach((event) => {
+			if (event.name === "config:resolved") unimport = createUnimport(wxt.config.imports);
+		});
+		wxt.hooks.hook("prepare:types", async (_, entries) => {
+			await unimport.init();
+			entries.push(await getImportsModuleEntry(wxt, unimport));
+			if (!isEnabled()) return;
+			entries.push(await getImportsDeclarationEntry(unimport));
+			if (wxt.config.imports.eslintrc.enabled === false) return;
+			entries.push(await getEslintConfigEntry(unimport, wxt.config.imports.eslintrc.enabled, wxt.config.imports));
+		});
+		addViteConfig(wxt, () => ({ plugins: [UnimportPlugin.vite(wxt.config.imports)] }));
+	}
 });
 async function getImportsDeclarationEntry(unimport) {
-  return {
-    path: "types/imports.d.ts",
-    text: [
-      "// Generated by wxt",
-      await unimport.generateTypeDeclarations(),
-      ""
-    ].join("\n"),
-    tsReference: true
-  };
+	return {
+		path: "types/imports.d.ts",
+		text: [
+			"// Generated by wxt",
+			await unimport.generateTypeDeclarations(),
+			""
+		].join("\n"),
+		tsReference: true
+	};
 }
 async function getImportsModuleEntry(wxt, unimport) {
-  const imports = await unimport.getImports();
-  return {
-    path: "types/imports-module.d.ts",
-    text: [
-      "// Generated by wxt",
-      "// Types for the #import virtual module",
-      "declare module '#imports' {",
-      `  ${toExports(imports, wxt.config.wxtDir, true).replaceAll("\n", "\n  ")}`,
-      "}",
-      ""
-    ].join("\n"),
-    tsReference: true
-  };
+	return {
+		path: "types/imports-module.d.ts",
+		text: [
+			"// Generated by wxt",
+			"// Types for the #import virtual module",
+			"declare module '#imports' {",
+			`  ${toExports(await unimport.getImports(), wxt.config.wxtDir, true).replaceAll("\n", "\n  ")}`,
+			"}",
+			""
+		].join("\n"),
+		tsReference: true
+	};
 }
 async function getEslintConfigEntry(unimport, version, options) {
-  const globals = (await unimport.getImports()).map((i) => i.as ?? i.name).filter(Boolean).sort().reduce((globals2, name) => {
-    globals2[name] = options.eslintrc.globalsPropValue;
-    return globals2;
-  }, {});
-  if (version <= 8) return getEslint8ConfigEntry(options, globals);
-  else return getEslint9ConfigEntry(options, globals);
+	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);
 }
-export function getEslint8ConfigEntry(options, globals) {
-  return {
-    path: options.eslintrc.filePath,
-    text: JSON.stringify({ globals }, null, 2) + "\n"
-  };
+function getEslint8ConfigEntry(options, globals) {
+	return {
+		path: options.eslintrc.filePath,
+		text: JSON.stringify({ globals }, null, 2) + "\n"
+	};
 }
-export function getEslint9ConfigEntry(options, globals) {
-  return {
-    path: options.eslintrc.filePath,
-    text: `const globals = ${JSON.stringify(globals, null, 2)}
+function getEslint9ConfigEntry(options, globals) {
+	return {
+		path: options.eslintrc.filePath,
+		text: `const globals = ${JSON.stringify(globals, null, 2)}
 
 export default {
   name: "wxt/auto-imports",
@@ -93,5 +84,8 @@ export default {
   },
 };
 `
-  };
+	};
 }
+
+//#endregion
+export { unimport_default as default };

package/dist/cli/cli-utils.mjs

@@ -1,58 +1,60 @@
-import consola, { LogLevels } from "consola";
-import { filterTruthy, toArray } from "../core/utils/arrays.mjs";
-import { printHeader } from "../core/utils/log/index.mjs";
 import { formatDuration } from "../core/utils/time.mjs";
-import { ValidationError } from "../core/utils/validation.mjs";
+import { filterTruthy, toArray } from "../core/utils/arrays.mjs";
 import { registerWxt } from "../core/wxt.mjs";
+import { printHeader } from "../core/utils/log/printHeader.mjs";
+import "../core/utils/log/index.mjs";
+import { ValidationError } from "../core/utils/validation.mjs";
+import consola, { LogLevels } from "consola";
 import spawn from "nano-spawn";
-export function wrapAction(cb, options) {
-  return async (...args) => {
-    const isDebug = !!args.find((arg) => arg?.debug);
-    if (isDebug) {
-      consola.level = LogLevels.debug;
-    }
-    const startTime = Date.now();
-    try {
-      printHeader();
-      const status = await cb(...args);
-      if (!status?.isOngoing && !options?.disableFinishedLog)
-        consola.success(
-          `Finished in ${formatDuration(Date.now() - startTime)}`
-        );
-    } catch (err) {
-      consola.fail(
-        `Command failed after ${formatDuration(Date.now() - startTime)}`
-      );
-      if (err instanceof ValidationError) {
-      } else {
-        consola.error(err);
-      }
-      process.exit(1);
-    }
-  };
+
+//#region src/cli/cli-utils.ts
+/**
+* Wrap an action handler to add a timer, error handling, and maybe enable debug mode.
+*/
+function wrapAction(cb, options) {
+	return async (...args) => {
+		if (!!args.find((arg) => arg?.debug)) consola.level = LogLevels.debug;
+		const startTime = Date.now();
+		try {
+			printHeader();
+			if (!(await cb(...args))?.isOngoing && !options?.disableFinishedLog) consola.success(`Finished in ${formatDuration(Date.now() - startTime)}`);
+		} catch (err) {
+			consola.fail(`Command failed after ${formatDuration(Date.now() - startTime)}`);
+			if (err instanceof ValidationError) {} else consola.error(err);
+			process.exit(1);
+		}
+	};
 }
-export function getArrayFromFlags(flags, name) {
-  const array = toArray(flags[name]);
-  const result = filterTruthy(array);
-  return result.length ? result : void 0;
+/**
+* Array flags, when not passed, are either `undefined` or `[undefined]`. This function filters out
+* the
+*/
+function getArrayFromFlags(flags, name) {
+	const result = filterTruthy(toArray(flags[name]));
+	return result.length ? result : void 0;
 }
 const aliasCommandNames = /* @__PURE__ */ new Set();
-export function createAliasedCommand(base, name, alias, bin, docsUrl) {
-  const aliasedCommand = base.command(name, `Alias for ${alias} (${docsUrl})`).allowUnknownOptions().action(async () => {
-    try {
-      await registerWxt("build");
-      const args = process.argv.slice(
-        process.argv.indexOf(aliasedCommand.name) + 1
-      );
-      await spawn(bin, args, {
-        stdio: "inherit"
-      });
-    } catch {
-      process.exit(1);
-    }
-  });
-  aliasCommandNames.add(aliasedCommand.name);
+/**
+* @param base Command to add this one to
+* @param name The command name to add
+* @param alias The CLI tool being aliased
+* @param bin The CLI tool binary name. Usually the same as the alias
+* @param docsUrl URL to the docs for the aliased CLI tool
+*/
+function createAliasedCommand(base, name, alias, bin, docsUrl) {
+	const aliasedCommand = base.command(name, `Alias for ${alias} (${docsUrl})`).allowUnknownOptions().action(async () => {
+		try {
+			await registerWxt("build");
+			await spawn(bin, process.argv.slice(process.argv.indexOf(aliasedCommand.name) + 1), { stdio: "inherit" });
+		} catch {
+			process.exit(1);
+		}
+	});
+	aliasCommandNames.add(aliasedCommand.name);
 }
-export function isAliasedCommand(command) {
-  return !!command && aliasCommandNames.has(command.name);
+function isAliasedCommand(command) {
+	return !!command && aliasCommandNames.has(command.name);
 }
+
+//#endregion
+export { createAliasedCommand, getArrayFromFlags, isAliasedCommand, wrapAction };

package/dist/cli/commands.mjs

@@ -1,106 +1,80 @@
+import { build } from "../core/build.mjs";
+import { clean } from "../core/clean.mjs";
+import { createServer } from "../core/create-server.mjs";
+import { initialize } from "../core/initialize.mjs";
+import { prepare } from "../core/prepare.mjs";
+import { zip } from "../core/zip.mjs";
+import "../core/index.mjs";
+import { createAliasedCommand, getArrayFromFlags, wrapAction } from "./cli-utils.mjs";
 import cac from "cac";
-import { build, clean, createServer, initialize, prepare, zip } from "../core/index.mjs";
-import {
-  createAliasedCommand,
-  getArrayFromFlags,
-  wrapAction
-} from "./cli-utils.mjs";
+
+//#region src/cli/commands.ts
 const cli = cac("wxt");
 cli.option("--debug", "enable debug mode");
-cli.command("[root]", "start dev server").option("-c, --config <file>", "use specified config file").option("-m, --mode <mode>", "set env mode").option("-b, --browser <browser>", "specify a browser").option("--host <host>", "specify a host for the dev server to bind to").option("-p, --port <port>", "specify a port for the dev server to bind to").option(
-  "-e, --filter-entrypoint <entrypoint>",
-  "only build specific entrypoints",
-  {
-    type: []
-  }
-).option("--mv3", "target manifest v3").option("--mv2", "target manifest v2").action(
-  wrapAction(async (root, flags) => {
-    const serverOptions = {};
-    if (flags.host) serverOptions.host = flags.host;
-    if (flags.port) serverOptions.port = parseInt(flags.port);
-    const server = await createServer({
-      root,
-      mode: flags.mode,
-      browser: flags.browser,
-      manifestVersion: flags.mv3 ? 3 : flags.mv2 ? 2 : void 0,
-      configFile: flags.config,
-      debug: flags.debug,
-      filterEntrypoints: getArrayFromFlags(flags, "filterEntrypoint"),
-      dev: Object.keys(serverOptions).length === 0 ? void 0 : { server: serverOptions }
-    });
-    await server.start();
-    return { isOngoing: true };
-  })
-);
-cli.command("build [root]", "build for production").option("-c, --config <file>", "use specified config file").option("-m, --mode <mode>", "set env mode").option("-b, --browser <browser>", "specify a browser").option(
-  "-e, --filter-entrypoint <entrypoint>",
-  "only build specific entrypoints",
-  {
-    type: []
-  }
-).option("--mv3", "target manifest v3").option("--mv2", "target manifest v2").option("--analyze", "visualize extension bundle").option("--analyze-open", "automatically open stats.html in browser").action(
-  wrapAction(async (root, flags) => {
-    await build({
-      root,
-      mode: flags.mode,
-      browser: flags.browser,
-      manifestVersion: flags.mv3 ? 3 : flags.mv2 ? 2 : void 0,
-      configFile: flags.config,
-      debug: flags.debug,
-      analysis: flags.analyze ? {
-        enabled: true,
-        open: flags.analyzeOpen
-      } : void 0,
-      filterEntrypoints: getArrayFromFlags(flags, "filterEntrypoint")
-    });
-  })
-);
-cli.command("zip [root]", "build for production and zip output").option("-c, --config <file>", "use specified config file").option("-m, --mode <mode>", "set env mode").option("-b, --browser <browser>", "specify a browser").option("--mv3", "target manifest v3").option("--mv2", "target manifest v2").option("--sources", "always create sources zip").action(
-  wrapAction(async (root, flags) => {
-    await zip({
-      root,
-      mode: flags.mode,
-      browser: flags.browser,
-      manifestVersion: flags.mv3 ? 3 : flags.mv2 ? 2 : void 0,
-      configFile: flags.config,
-      debug: flags.debug,
-      zip: {
-        zipSources: flags.sources
-      }
-    });
-  })
-);
-cli.command("prepare [root]", "prepare typescript project").option("-c, --config <file>", "use specified config file").action(
-  wrapAction(async (root, flags) => {
-    await prepare({
-      root,
-      configFile: flags.config,
-      debug: flags.debug
-    });
-  })
-);
-cli.command("clean [root]", "clean generated files and caches").alias("cleanup").option("-c, --config <file>", "use specified config file").action(
-  wrapAction(async (root, flags) => {
-    await clean({ root, configFile: flags.config, debug: flags.debug });
-  })
-);
-cli.command("init [directory]", "initialize a new project").option("-t, --template <template>", "template to use").option("--pm <packageManager>", "which package manager to use").action(
-  wrapAction(
-    async (directory, flags) => {
-      await initialize({
-        directory,
-        template: flags.template,
-        packageManager: flags.pm
-      });
-    },
-    { disableFinishedLog: true }
-  )
-);
-createAliasedCommand(
-  cli,
-  "submit",
-  "publish-extension",
-  "wxt-publish-extension",
-  "https://www.npmjs.com/publish-browser-extension"
-);
-export default cli;
+cli.command("[root]", "start dev server").option("-c, --config <file>", "use specified config file").option("-m, --mode <mode>", "set env mode").option("-b, --browser <browser>", "specify a browser").option("--host <host>", "specify a host for the dev server to bind to").option("-p, --port <port>", "specify a port for the dev server to bind to").option("-e, --filter-entrypoint <entrypoint>", "only build specific entrypoints", { type: [] }).option("--mv3", "target manifest v3").option("--mv2", "target manifest v2").action(wrapAction(async (root, flags) => {
+	const serverOptions = {};
+	if (flags.host) serverOptions.host = flags.host;
+	if (flags.port) serverOptions.port = parseInt(flags.port);
+	await (await createServer({
+		root,
+		mode: flags.mode,
+		browser: flags.browser,
+		manifestVersion: flags.mv3 ? 3 : flags.mv2 ? 2 : void 0,
+		configFile: flags.config,
+		debug: flags.debug,
+		filterEntrypoints: getArrayFromFlags(flags, "filterEntrypoint"),
+		dev: Object.keys(serverOptions).length === 0 ? void 0 : { server: serverOptions }
+	})).start();
+	return { isOngoing: true };
+}));
+cli.command("build [root]", "build for production").option("-c, --config <file>", "use specified config file").option("-m, --mode <mode>", "set env mode").option("-b, --browser <browser>", "specify a browser").option("-e, --filter-entrypoint <entrypoint>", "only build specific entrypoints", { type: [] }).option("--mv3", "target manifest v3").option("--mv2", "target manifest v2").option("--analyze", "visualize extension bundle").option("--analyze-open", "automatically open stats.html in browser").action(wrapAction(async (root, flags) => {
+	await build({
+		root,
+		mode: flags.mode,
+		browser: flags.browser,
+		manifestVersion: flags.mv3 ? 3 : flags.mv2 ? 2 : void 0,
+		configFile: flags.config,
+		debug: flags.debug,
+		analysis: flags.analyze ? {
+			enabled: true,
+			open: flags.analyzeOpen
+		} : void 0,
+		filterEntrypoints: getArrayFromFlags(flags, "filterEntrypoint")
+	});
+}));
+cli.command("zip [root]", "build for production and zip output").option("-c, --config <file>", "use specified config file").option("-m, --mode <mode>", "set env mode").option("-b, --browser <browser>", "specify a browser").option("--mv3", "target manifest v3").option("--mv2", "target manifest v2").option("--sources", "always create sources zip").action(wrapAction(async (root, flags) => {
+	await zip({
+		root,
+		mode: flags.mode,
+		browser: flags.browser,
+		manifestVersion: flags.mv3 ? 3 : flags.mv2 ? 2 : void 0,
+		configFile: flags.config,
+		debug: flags.debug,
+		zip: { zipSources: flags.sources }
+	});
+}));
+cli.command("prepare [root]", "prepare typescript project").option("-c, --config <file>", "use specified config file").action(wrapAction(async (root, flags) => {
+	await prepare({
+		root,
+		configFile: flags.config,
+		debug: flags.debug
+	});
+}));
+cli.command("clean [root]", "clean generated files and caches").alias("cleanup").option("-c, --config <file>", "use specified config file").action(wrapAction(async (root, flags) => {
+	await clean({
+		root,
+		configFile: flags.config,
+		debug: flags.debug
+	});
+}));
+cli.command("init [directory]", "initialize a new project").option("-t, --template <template>", "template to use").option("--pm <packageManager>", "which package manager to use").action(wrapAction(async (directory, flags) => {
+	await initialize({
+		directory,
+		template: flags.template,
+		packageManager: flags.pm
+	});
+}, { disableFinishedLog: true }));
+createAliasedCommand(cli, "submit", "publish-extension", "wxt-publish-extension", "https://www.npmjs.com/publish-browser-extension");
+
+//#endregion
+export { cli as default };

package/dist/cli/index.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/cli/index.mjs

@@ -1,10 +1,15 @@
-import cli from "./commands.mjs";
 import { version } from "../version.mjs";
 import { isAliasedCommand } from "./cli-utils.mjs";
+import cli from "./commands.mjs";
+
+//#region src/cli/index.ts
 cli.parse(process.argv, { run: false });
 if (!isAliasedCommand(cli.matchedCommand)) {
-  cli.help();
-  cli.version(version);
-  cli.parse(process.argv, { run: false });
+	cli.help();
+	cli.version(version);
+	cli.parse(process.argv, { run: false });
 }
 await cli.runMatchedCommand();
+
+//#endregion
+export {  };

package/dist/core/{build.d.ts → build.d.mts}

@@ -1,4 +1,6 @@
-import { BuildOutput, InlineConfig } from '../types';
+import { BuildOutput, InlineConfig } from "../types.mjs";
+
+//#region src/core/build.d.ts
 /**
  * Bundles the extension for production. Returns a promise of the build result. Discovers the `wxt.config.ts` file in
  * the root directory, and merges that config with what is passed in.
@@ -12,4 +14,6 @@ import { BuildOutput, InlineConfig } from '../types';
  *   // Override config...
  * })
  */
-export declare function build(config?: InlineConfig): Promise<BuildOutput>;
+declare function build(config?: InlineConfig): Promise<BuildOutput>;
+//#endregion
+export { build };

package/dist/core/build.mjs

@@ -1,6 +1,25 @@
-import { internalBuild } from "./utils/building/index.mjs";
 import { registerWxt } from "./wxt.mjs";
-export async function build(config) {
-  await registerWxt("build", config);
-  return await internalBuild();
+import { internalBuild } from "./utils/building/internal-build.mjs";
+import "./utils/building/index.mjs";
+
+//#region src/core/build.ts
+/**
+* Bundles the extension for production. Returns a promise of the build result. Discovers the `wxt.config.ts` file in
+* the root directory, and merges that config with what is passed in.
+*
+* @example
+* // Use config from `wxt.config.ts`
+* const res = await build()
+*
+* // or override config `from wxt.config.ts`
+* const res = await build({
+*   // Override config...
+* })
+*/
+async function build(config) {
+	await registerWxt("build", config);
+	return await internalBuild();
 }
+
+//#endregion
+export { build };