wxt 0.19.5 → 0.19.7

package/dist/browser/chrome.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @module wxt/browser/chrome
+ */
 import type { WxtRuntime, WxtI18n } from './index';
 /**
  * EXPERIMENTAL

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

@@ -227,7 +227,10 @@ export async function createViteBuilder(wxtConfig, hooks, server) {
           port: info.port,
           strictPort: true,
           host: info.hostname,
-          origin: info.origin
+          origin: info.origin,
+          watch: {
+            ignored: [`${wxtConfig.outBaseDir}/**`, `${wxtConfig.wxtDir}/**`]
+          }
         }
       };
       const baseConfig = await getBaseConfig();

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

@@ -1,5 +1,7 @@
 import path from "node:path";
 export function extensionApiMock(config) {
+  const virtualSetupModule = "virtual:wxt-setup";
+  const resolvedVirtualSetupModule = "\0" + virtualSetupModule;
   return {
     name: "wxt:extension-api-mock",
     config() {
@@ -8,6 +10,9 @@ export function extensionApiMock(config) {
         "dist/virtual/mock-browser"
       );
       return {
+        test: {
+          setupFiles: [virtualSetupModule]
+        },
         resolve: {
           alias: [
             { find: "webextension-polyfill", replacement },
@@ -21,6 +26,19 @@ export function extensionApiMock(config) {
           noExternal: ["wxt"]
         }
       };
+    },
+    resolveId(id) {
+      if (id.endsWith(virtualSetupModule)) return resolvedVirtualSetupModule;
+    },
+    load(id) {
+      if (id === resolvedVirtualSetupModule) return setupTemplate;
     }
   };
 }
+const setupTemplate = `
+  import { vi } from 'vitest';
+  import { fakeBrowser } from 'wxt/testing';
+
+  vi.stubGlobal("chrome", fakeBrowser);
+  vi.stubGlobal("browser", fakeBrowser);
+`;

package/dist/core/create-server.mjs

@@ -99,14 +99,12 @@ function createFileReloader(server) {
   const fileChangedMutex = new Mutex();
   const changeQueue = [];
   return async (event, path) => {
-    await wxt.reloadConfig();
-    if (path.startsWith(wxt.config.outBaseDir)) return;
-    if (path.startsWith(wxt.config.wxtDir)) return;
     changeQueue.push([event, path]);
     await fileChangedMutex.runExclusive(async () => {
       if (server.currentOutput == null) return;
       const fileChanges = changeQueue.splice(0, changeQueue.length).map(([_, file]) => file);
       if (fileChanges.length === 0) return;
+      await wxt.reloadConfig();
       const changes = detectDevChanges(fileChanges, server.currentOutput);
       if (changes.type === "no-change") return;
       if (changes.type === "full-restart") {

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

@@ -313,7 +313,7 @@ async function getSidepanelEntrypoint(info) {
   const options = await getHtmlEntrypointOptions(
     info,
     {
-      browserStyle: "browse_style",
+      browserStyle: "browser_style",
       exclude: "exclude",
       include: "include",
       defaultIcon: "default_icon",

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

@@ -102,18 +102,38 @@ declare module "wxt/browser" {
   } else {
     messages = parseI18nMessages({});
   }
-  const overrides = messages.map((message) => {
-    return `    /**
-     * ${message.description || "No message description."}
-     *
-     * "${message.message}"
+  const renderGetMessageOverload = (keyType, description, translation) => {
+    const commentLines = [];
+    if (description) commentLines.push(...description.split("\n"));
+    if (translation) {
+      if (commentLines.length > 0) commentLines.push("");
+      commentLines.push(`"${translation}"`);
+    }
+    const comment = commentLines.length > 0 ? `/**
+${commentLines.map((line) => `     * ${line}`.trimEnd()).join("\n")}
      */
-    getMessage(
-      messageName: "${message.name}",
+    ` : "";
+    return `    ${comment}getMessage(
+      messageName: ${keyType},
       substitutions?: string | string[],
       options?: GetMessageOptions,
     ): string;`;
-  });
+  };
+  const overrides = [
+    // Generate individual overloads for each message so JSDoc contains description and base translation.
+    ...messages.map(
+      (message) => renderGetMessageOverload(
+        `"${message.name}"`,
+        message.description,
+        message.message
+      )
+    ),
+    // Include a final union-based override so TS accepts valid string templates or concatinations
+    // ie: browser.i18n.getMessage(`some_enum_${enumValue}`)
+    renderGetMessageOverload(
+      messages.map((message) => `"${message.name}"`).join(" | ")
+    )
+  ];
   return {
     path: "types/i18n.d.ts",
     text: template.replace("{{ overrides }}", overrides.join("\n")),
@@ -156,7 +176,11 @@ function getMainDeclarationEntry(references) {
 }
 async function getTsConfigEntry() {
   const dir = wxt.config.wxtDir;
-  const getTsconfigPath = (path2) => normalizePath(relative(dir, path2));
+  const getTsconfigPath = (path2) => {
+    const res = normalizePath(relative(dir, path2));
+    if (res.startsWith(".") || res.startsWith("/")) return res;
+    return "./" + res;
+  };
   const paths = Object.entries(wxt.config.alias).flatMap(([alias, absolutePath]) => {
     const aliasPath = getTsconfigPath(absolutePath);
     return [

package/dist/core/utils/building/resolve-config.mjs

@@ -48,9 +48,6 @@ export async function resolveConfig(inlineConfig, command) {
   }
   const filterEntrypoints = !!mergedConfig.filterEntrypoints?.length ? new Set(mergedConfig.filterEntrypoints) : void 0;
   const publicDir = path.resolve(srcDir, mergedConfig.publicDir ?? "public");
-  if (await isDirMissing(publicDir)) {
-    logMissingDir(logger, "Public", publicDir);
-  }
   const typesDir = path.resolve(wxtDir, "types");
   const outBaseDir = path.resolve(root, mergedConfig.outDir ?? ".output");
   const outDir = path.resolve(outBaseDir, `${browser}-mv${manifestVersion}`);

package/dist/modules.d.ts

@@ -107,3 +107,31 @@ export declare function addWxtPlugin(wxt: Wxt, plugin: string): void;
  * });
  */
 export 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.
+ *
+ * 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
+ * wants to provide access to, so it creates the file and adds an import alias
+ * to it.
+ *
+ * @example
+ * import path from 'node:path';
+ *
+ * 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 = ...`,
+ *     });
+ *   });
+ *
+ *   // Add alias
+ *   addAlias(wxt, "#i18n", i18nPath);
+ * });
+ */
+export declare function addAlias(wxt: Wxt, alias: string, path: string): void;

package/dist/modules.mjs

@@ -46,3 +46,14 @@ export function addImportPreset(wxt, preset) {
     wxt2.config.imports.presets.push(preset);
   });
 }
+export function addAlias(wxt, alias, path) {
+  wxt.hooks.hook("ready", (wxt2) => {
+    const target = resolve(wxt2.config.root, path);
+    if (wxt2.config.alias[alias] != null) {
+      wxt2.logger.warn(
+        `Skipped adding alias (${alias} => ${target}) because an alias with the same name already exists: ${alias} => ${wxt2.config.alias[alias]}`
+      );
+    }
+    wxt2.config.alias[alias] = target;
+  });
+}

package/dist/testing/wxt-vitest-plugin.mjs

@@ -5,20 +5,20 @@ import {
   extensionApiMock,
   resolveAppConfig
 } from "../core/builders/vite/plugins/index.mjs";
-import { resolveConfig } from "../core/utils/building/index.mjs";
 import { vitePlugin as unimportPlugin } from "../builtin-modules/unimport.mjs";
 import { createUnimport } from "unimport";
+import { registerWxt, wxt } from "../core/wxt.mjs";
 export async function WxtVitest(inlineConfig) {
-  const config = await resolveConfig(inlineConfig ?? {}, "serve");
+  await registerWxt("serve", inlineConfig ?? {});
   const plugins = [
-    globals(config),
-    download(config),
-    tsconfigPaths(config),
-    resolveAppConfig(config),
-    extensionApiMock(config)
+    globals(wxt.config),
+    download(wxt.config),
+    tsconfigPaths(wxt.config),
+    resolveAppConfig(wxt.config),
+    extensionApiMock(wxt.config)
   ];
-  if (config.imports !== false) {
-    const unimport = createUnimport(config.imports);
+  if (wxt.config.imports !== false) {
+    const unimport = createUnimport(wxt.config.imports);
     await unimport.init();
     plugins.push(unimportPlugin(unimport));
   }

package/dist/version.mjs

@@ -1 +1 @@
-export const version = "0.19.5";
+export const version = "0.19.7";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "wxt",
   "type": "module",
-  "version": "0.19.5",
+  "version": "0.19.7",
   "description": "Next gen framework for developing web extensions",
   "repository": {
     "type": "git",