wxt 0.14.2-alpha2 → 0.14.2

package/dist/cli.js

@@ -4,7 +4,7 @@ import "./chunk-VBXJIVYU.js";
 import cac from "cac";
 
 // package.json
-var version = "0.14.2-alpha2";
+var version = "0.14.2";
 
 // src/core/utils/fs.ts
 import fs from "fs-extra";
@@ -13,11 +13,11 @@ import glob from "fast-glob";
 // src/core/utils/paths.ts
 import systemPath from "node:path";
 import normalize from "normalize-path";
-function normalizePath(path6) {
-  return normalize(path6);
+function normalizePath(path7) {
+  return normalize(path7);
 }
-function unnormalizePath(path6) {
-  return systemPath.normalize(path6);
+function unnormalizePath(path7) {
+  return systemPath.normalize(path7);
 }
 var CSS_EXTENSIONS = ["css", "scss", "sass", "less", "styl", "stylus"];
 var CSS_EXTENSIONS_PATTERN = `+(${CSS_EXTENSIONS.join("|")})`;
@@ -38,145 +38,8 @@ async function getPublicFiles(config) {
 
 // src/core/utils/building/build-entrypoints.ts
 import fs2 from "fs-extra";
-import { dirname, resolve, extname } from "node:path";
+import { dirname, resolve } from "path";
 import pc from "picocolors";
-
-// src/i18n/node.ts
-import { readFile } from "node:fs/promises";
-import JSON5 from "json5";
-import YAML from "yaml";
-async function readMessagesFile(file) {
-  const text = await readFile(file, "utf-8");
-  return readMessagesText(text);
-}
-function readMessagesText(text) {
-  const parsers = [
-    JSON.parse,
-    JSON5.parse,
-    YAML.parse
-  ];
-  for (const parse of parsers) {
-    try {
-      const result = parse(text);
-      if (typeof result === "object") {
-        return readMessagesObject(result);
-      }
-    } catch {
-      continue;
-    }
-  }
-  throw Error("I18n messages text is not valid JSON, JSON5, or YAML");
-}
-function readMessagesObject(input) {
-  const messagesFromInput = findEntries([], input);
-  return [...messagesFromInput, ...PREDEFINED_MESSAGES];
-}
-function convertMessagesToManifest(messages) {
-  return messages.filter((message) => !message.isBuiltin).reduce((schema, { name, entry }) => {
-    schema[name] = entry;
-    return schema;
-  }, {});
-}
-function findEntries(keyPath, input) {
-  const name = keyPath.join("_");
-  if (isBasicEntry(input))
-    return [
-      {
-        name,
-        entry: { message: input }
-      }
-    ];
-  if (isManifestEntry(input))
-    return [
-      {
-        name,
-        entry: input
-      }
-    ];
-  if (isPluralEntry(input))
-    return [
-      {
-        name,
-        entry: {
-          message: Object.values(input).join(" | ")
-        },
-        isPlural: true
-      }
-    ];
-  return Object.entries(input).reduce((items, [key, child]) => {
-    const nestedEntries = findEntries(keyPath.concat(key), child);
-    return [...items, ...nestedEntries];
-  }, []);
-}
-function isBasicEntry(entry) {
-  return typeof entry === "string";
-}
-function isManifestEntry(entry) {
-  const keys = Object.keys(entry);
-  if (keys.length < 1 || keys.length > 3)
-    return false;
-  const knownKeys = /* @__PURE__ */ new Set(["message", "placeholders", "description"]);
-  const unknownKeys = keys.filter((key) => !knownKeys.has(key));
-  return unknownKeys.length === 0;
-}
-function isPluralEntry(entry) {
-  const keys = Object.keys(entry);
-  if (keys.length === 0)
-    return false;
-  const invalidKeys = keys.filter((key) => key !== "n" && isNaN(Number(key)));
-  return invalidKeys.length === 0;
-}
-var PREDEFINED_MESSAGES = [
-  {
-    name: "@@extension_id",
-    isBuiltin: true,
-    entry: {
-      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."
-    }
-  },
-  {
-    name: "@@ui_locale",
-    isBuiltin: true,
-    entry: {
-      message: "<browser.i18n.getUiLocale()>"
-    }
-  },
-  {
-    name: "@@bidi_dir",
-    isBuiltin: true,
-    entry: {
-      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.'
-    }
-  },
-  {
-    name: "@@bidi_reversed_dir",
-    isBuiltin: true,
-    entry: {
-      message: "<rtl|ltr>",
-      description: `If the @@bidi_dir is "ltr", then this is "rtl"; otherwise, it's "ltr".`
-    }
-  },
-  {
-    name: "@@bidi_start_edge",
-    isBuiltin: true,
-    entry: {
-      message: "<left|right>",
-      description: `If the @@bidi_dir is "ltr", then this is "left"; otherwise, it's "right".`
-    }
-  },
-  {
-    name: "@@bidi_end_edge",
-    isBuiltin: true,
-    entry: {
-      message: "<right|left>",
-      description: `If the @@bidi_dir is "ltr", then this is "right"; otherwise, it's "left".`
-    }
-  }
-];
-
-// src/core/utils/building/build-entrypoints.ts
 async function buildEntrypoints(groups, config, spinner) {
   const steps = [];
   for (let i = 0; i < groups.length; i++) {
@@ -185,10 +48,7 @@ async function buildEntrypoints(groups, config, spinner) {
     spinner.text = pc.dim(`[${i + 1}/${groups.length}]`) + ` ${groupNames}`;
     steps.push(await config.builder.build(group));
   }
-  const publicAssets = (await Promise.all([
-    copyPublicDirectory(config),
-    copyLocalesDirectory(config)
-  ])).flat();
+  const publicAssets = await copyPublicDirectory(config);
   return { publicAssets, steps };
 }
 async function copyPublicDirectory(config) {
@@ -208,28 +68,6 @@ async function copyPublicDirectory(config) {
   }
   return publicAssets;
 }
-async function copyLocalesDirectory(config) {
-  const localesExist = await fs2.exists(config.localesDir);
-  if (!localesExist || config.manifest.default_locale == null)
-    return [];
-  const files = await fs2.readdir(config.localesDir);
-  return await Promise.all(
-    files.map(async (file) => {
-      const locale = file.replace(extname(file), "");
-      const fileName = unnormalizePath(`_locales/${locale}/messages.json`);
-      const srcPath = resolve(config.localesDir, file);
-      const outPath = resolve(config.outDir, fileName);
-      const messages = await readMessagesFile(srcPath);
-      const json = convertMessagesToManifest(messages);
-      await fs2.ensureDir(dirname(outPath));
-      await fs2.writeJson(outPath, json);
-      return {
-        fileName,
-        type: "asset"
-      };
-    })
-  );
-}
 
 // src/core/utils/arrays.ts
 function every(array, predicate) {
@@ -328,7 +166,7 @@ import { relative as relative2, resolve as resolve3 } from "path";
 import fs3 from "fs-extra";
 import { minimatch } from "minimatch";
 import { parseHTML } from "linkedom";
-import JSON52 from "json5";
+import JSON5 from "json5";
 import glob2 from "fast-glob";
 
 // src/core/utils/entrypoints.ts
@@ -356,6 +194,7 @@ function resolvePerBrowserOption(option, browser) {
 var VIRTUAL_NOOP_BACKGROUND_MODULE_ID = "virtual:user-background";
 
 // src/core/utils/building/find-entrypoints.ts
+import pc2 from "picocolors";
 async function findEntrypoints(config) {
   const relativePaths = await glob2(Object.keys(PATH_GLOB_TO_TYPE_MAP), {
     cwd: config.entrypointsDir
@@ -366,11 +205,16 @@ async function findEntrypoints(config) {
     const inputPath = resolve3(config.entrypointsDir, relativePath);
     const name = getEntrypointName(config.entrypointsDir, inputPath);
     const matchingGlob = pathGlobs.find(
-      (glob6) => minimatch(relativePath, glob6)
+      (glob5) => minimatch(relativePath, glob5)
     );
     if (matchingGlob) {
       const type = PATH_GLOB_TO_TYPE_MAP[matchingGlob];
-      results.push({ name, inputPath, type });
+      results.push({
+        name,
+        inputPath,
+        type,
+        skipped: config.filterEntrypoints != null && !config.filterEntrypoints.has(name)
+      });
     }
     return results;
   }, []);
@@ -422,11 +266,19 @@ async function findEntrypoints(config) {
       await getBackgroundEntrypoint(config, {
         inputPath: VIRTUAL_NOOP_BACKGROUND_MODULE_ID,
         name: "background",
-        type: "background"
+        type: "background",
+        skipped: false
       })
     );
   }
   config.logger.debug("All entrypoints:", entrypoints);
+  const skippedEntrypointNames = entrypointInfos.filter((item) => item.skipped).map((item) => item.name);
+  if (skippedEntrypointNames.length) {
+    config.logger.warn(
+      `Filter excluded the following entrypoints:
+${skippedEntrypointNames.map((item) => `${pc2.dim("-")} ${pc2.cyan(item)}`).join("\n")}`
+    );
+  }
   const targetEntrypoints = entrypoints.filter((entry) => {
     const { include, exclude } = entry.options;
     if (include?.length && exclude?.length) {
@@ -441,6 +293,9 @@ async function findEntrypoints(config) {
     if (include?.length && !exclude?.length) {
       return include.includes(config.browser);
     }
+    if (skippedEntrypointNames.includes(entry.name)) {
+      return false;
+    }
     return true;
   });
   config.logger.debug(`${config.browser} entrypoints:`, targetEntrypoints);
@@ -485,15 +340,15 @@ function getHtmlBaseOptions(document) {
   const options = {};
   const includeContent = document.querySelector("meta[name='manifest.include']")?.getAttribute("content");
   if (includeContent) {
-    options.include = JSON52.parse(includeContent);
+    options.include = JSON5.parse(includeContent);
   }
   const excludeContent = document.querySelector("meta[name='manifest.exclude']")?.getAttribute("content");
   if (excludeContent) {
-    options.exclude = JSON52.parse(excludeContent);
+    options.exclude = JSON5.parse(excludeContent);
   }
   return options;
 }
-async function getPopupEntrypoint(config, { inputPath, name }) {
+async function getPopupEntrypoint(config, { inputPath, name, skipped }) {
   const content = await fs3.readFile(inputPath, "utf-8");
   const { document } = parseHTML(content);
   const options = getHtmlBaseOptions(document);
@@ -503,7 +358,7 @@ async function getPopupEntrypoint(config, { inputPath, name }) {
   const defaultIconContent = document.querySelector("meta[name='manifest.default_icon']")?.getAttribute("content");
   if (defaultIconContent) {
     try {
-      options.defaultIcon = JSON52.parse(defaultIconContent);
+      options.defaultIcon = JSON5.parse(defaultIconContent);
     } catch (err) {
       config.logger.fatal(
         `Failed to parse default_icon meta tag content as JSON5. content=${defaultIconContent}`,
@@ -524,10 +379,11 @@ async function getPopupEntrypoint(config, { inputPath, name }) {
     name: "popup",
     options,
     inputPath,
-    outputDir: config.outDir
+    outputDir: config.outDir,
+    skipped
   };
 }
-async function getOptionsEntrypoint(config, { inputPath, name }) {
+async function getOptionsEntrypoint(config, { inputPath, name, skipped }) {
   const content = await fs3.readFile(inputPath, "utf-8");
   const { document } = parseHTML(content);
   const options = getHtmlBaseOptions(document);
@@ -548,10 +404,11 @@ async function getOptionsEntrypoint(config, { inputPath, name }) {
     name: "options",
     options,
     inputPath,
-    outputDir: config.outDir
+    outputDir: config.outDir,
+    skipped
   };
 }
-async function getUnlistedPageEntrypoint(config, { inputPath, name }) {
+async function getUnlistedPageEntrypoint(config, { inputPath, name, skipped }) {
   const content = await fs3.readFile(inputPath, "utf-8");
   const { document } = parseHTML(content);
   return {
@@ -559,10 +416,11 @@ async function getUnlistedPageEntrypoint(config, { inputPath, name }) {
     name: getEntrypointName(config.entrypointsDir, inputPath),
     inputPath,
     outputDir: config.outDir,
-    options: getHtmlBaseOptions(document)
+    options: getHtmlBaseOptions(document),
+    skipped
   };
 }
-async function getUnlistedScriptEntrypoint(config, { inputPath, name }) {
+async function getUnlistedScriptEntrypoint(config, { inputPath, name, skipped }) {
   const defaultExport = await importEntrypointFile(
     inputPath,
     config
@@ -579,10 +437,11 @@ async function getUnlistedScriptEntrypoint(config, { inputPath, name }) {
     name,
     inputPath,
     outputDir: config.outDir,
-    options
+    options,
+    skipped
   };
 }
-async function getBackgroundEntrypoint(config, { inputPath, name }) {
+async function getBackgroundEntrypoint(config, { inputPath, name, skipped }) {
   let options = {};
   if (inputPath !== VIRTUAL_NOOP_BACKGROUND_MODULE_ID) {
     const defaultExport = await importEntrypointFile(
@@ -606,10 +465,11 @@ async function getBackgroundEntrypoint(config, { inputPath, name }) {
       ...options,
       type: resolvePerBrowserOption(options.type, config.browser),
       persistent: resolvePerBrowserOption(options.persistent, config.browser)
-    }
+    },
+    skipped
   };
 }
-async function getContentScriptEntrypoint(config, { inputPath, name }) {
+async function getContentScriptEntrypoint(config, { inputPath, name, skipped }) {
   const { main: _, ...options } = await importEntrypointFile(inputPath, config);
   if (options == null) {
     throw Error(
@@ -621,7 +481,8 @@ async function getContentScriptEntrypoint(config, { inputPath, name }) {
     name,
     inputPath,
     outputDir: resolve3(config.outDir, CONTENT_SCRIPT_OUT_DIR),
-    options
+    options,
+    skipped
   };
 }
 var PATH_GLOB_TO_TYPE_MAP = {
@@ -679,8 +540,7 @@ function getUnimportOptions(config) {
     debugLog: config.logger.debug,
     imports: [
       { name: "defineConfig", from: "wxt" },
-      { name: "fakeBrowser", from: "wxt/testing" },
-      { name: "i18n", from: "wxt/i18n" }
+      { name: "fakeBrowser", from: "wxt/testing" }
     ],
     presets: [
       { package: "wxt/client" },
@@ -753,7 +613,46 @@ function surroundInUnderscore(name) {
 }
 
 // src/core/utils/building/generate-wxt-dir.ts
-import glob3 from "fast-glob";
+import path2 from "node:path";
+
+// src/core/utils/i18n.ts
+var 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".`
+  }
+};
+function parseI18nMessages(messagesJson) {
+  return Object.entries({
+    ...predefinedMessages,
+    ...messagesJson
+  }).map(([name, details]) => ({
+    name,
+    ...details
+  }));
+}
+
+// src/core/utils/building/generate-wxt-dir.ts
 async function generateTypesDir(entrypoints, config) {
   await fs4.ensureDir(config.typesDir);
   const references = [];
@@ -787,15 +686,17 @@ async function writePathsDeclarationFile(entrypoints, config) {
       config.outDir,
       entry.inputPath.endsWith(".html") ? ".html" : ".js"
     )
-  ).concat(await getPublicFiles(config)).map(normalizePath).map((path6) => `    | "/${path6}"`).sort().join("\n");
+  ).concat(await getPublicFiles(config)).map(normalizePath).map((path7) => `    | "/${path7}"`).sort().join("\n");
   const template = `// Generated by wxt
 import "wxt/browser";
 
 declare module "wxt/browser" {
   export type PublicPath =
 {{ union }}
+  type HtmlPublicPath = Extract<PublicPath, \`\${string}.html\`>
   export interface WxtRuntime extends Runtime.Static {
     getURL(path: PublicPath): string;
+    getURL(path: \`\${HtmlPublicPath}\${string}\`): string;
   }
 }
 `;
@@ -823,36 +724,28 @@ declare module "wxt/browser" {
   }
 
   export interface WxtI18n extends I18n.Static {
-{{ browserOverrides }}
-  }
-}
-
-declare module "wxt/i18n" {
-  export interface WxtMessageSchema {
-    t: {
-{{ translationTOverrides }}
-    };
-    tp: {
-{{ translationTpOverrides }}
-    };
+{{ overrides }}
   }
 }
 `;
   let messages;
   if (defaultLocale) {
-    const [defaultLocalePath] = await glob3(`${defaultLocale}.*`, {
-      cwd: config.localesDir,
-      absolute: true
-    });
-    messages = await readMessagesFile(defaultLocalePath);
+    const defaultLocalePath = path2.resolve(
+      config.publicDir,
+      "_locales",
+      defaultLocale,
+      "messages.json"
+    );
+    const content = JSON.parse(await fs4.readFile(defaultLocalePath, "utf-8"));
+    messages = parseI18nMessages(content);
   } else {
-    messages = PREDEFINED_MESSAGES;
+    messages = parseI18nMessages({});
   }
   const overrides = messages.map((message) => {
     return `    /**
-     * ${message.entry.description ?? "No message description."}
+     * ${message.description ?? "No message description."}
      *
-     * "${message.entry.message}"
+     * "${message.message}"
      */
     getMessage(
       messageName: "${message.name}",
@@ -862,13 +755,7 @@ declare module "wxt/i18n" {
   });
   await writeFileIfDifferent(
     filePath,
-    template.replace("{{ browserOverrides }}", overrides.join("\n")).replace(
-      "{{ translationTOverrides }}",
-      messages.filter((message) => !message.isPlural).map((message) => `      "${message.name}": any;`).join("\n")
-    ).replace(
-      "{{ translationTpOverrides }}",
-      messages.filter((message) => message.isPlural).map((message) => `      "${message.name}": any;`).join("\n")
-    )
+    template.replace("{{ overrides }}", overrides.join("\n"))
   );
   return filePath;
 }
@@ -904,7 +791,7 @@ async function writeMainDeclarationFile(references, config) {
 }
 async function writeTsConfigFile(mainReference, config) {
   const dir = config.wxtDir;
-  const getTsconfigPath = (path6) => normalizePath(relative3(dir, path6));
+  const getTsconfigPath = (path7) => normalizePath(relative3(dir, path7));
   const paths = Object.entries(config.alias).flatMap(([alias, absolutePath]) => {
     const aliasPath = getTsconfigPath(absolutePath);
     return [
@@ -940,7 +827,7 @@ ${paths}
 
 // src/core/utils/building/get-internal-config.ts
 import { loadConfig } from "c12";
-import path2 from "node:path";
+import path3 from "node:path";
 
 // src/core/utils/cache.ts
 import fs5, { ensureDir } from "fs-extra";
@@ -949,14 +836,14 @@ function createFsCache(wxtDir) {
   const getPath = (key) => resolve5(wxtDir, "cache", encodeURIComponent(key));
   return {
     async set(key, value) {
-      const path6 = getPath(key);
-      await ensureDir(dirname2(path6));
-      await writeFileIfDifferent(path6, value);
+      const path7 = getPath(key);
+      await ensureDir(dirname2(path7));
+      await writeFileIfDifferent(path7, value);
     },
     async get(key) {
-      const path6 = getPath(key);
+      const path7 = getPath(key);
       try {
-        return await fs5.readFile(path6, "utf-8");
+        return await fs5.readFile(path7, "utf-8");
       } catch {
         return void 0;
       }
@@ -1178,7 +1065,7 @@ function download(config) {
 }
 
 // src/core/builders/vite/plugins/multipageMove.ts
-import { dirname as dirname4, extname as extname2, resolve as resolve7, join } from "node:path";
+import { dirname as dirname4, extname, resolve as resolve7, join } from "node:path";
 import fs6, { ensureDir as ensureDir2 } from "fs-extra";
 function multipageMove(entrypoints, config) {
   return {
@@ -1197,7 +1084,7 @@ function multipageMove(entrypoints, config) {
         const newBundlePath = getEntrypointBundlePath(
           entrypoint,
           config.outDir,
-          extname2(oldBundlePath)
+          extname(oldBundlePath)
         );
         if (newBundlePath === oldBundlePath) {
           config.logger.debug(
@@ -1238,7 +1125,7 @@ async function removeEmptyDirs(dir) {
 
 // src/core/builders/vite/plugins/unimport.ts
 import { createUnimport as createUnimport2 } from "unimport";
-import { extname as extname3 } from "path";
+import { extname as extname2 } from "path";
 var ENABLED_EXTENSIONS = /* @__PURE__ */ new Set([
   ".js",
   ".jsx",
@@ -1260,7 +1147,7 @@ function unimport(config) {
     async transform(code, id) {
       if (id.includes("node_modules"))
         return;
-      if (!ENABLED_EXTENSIONS.has(extname3(id)))
+      if (!ENABLED_EXTENSIONS.has(extname2(id)))
         return;
       return unimport2.injectImports(code, id);
     }
@@ -1652,20 +1539,20 @@ async function getInternalConfig(inlineConfig, command, server) {
   const manifestVersion = mergedConfig.manifestVersion ?? (browser === "firefox" || browser === "safari" ? 2 : 3);
   const mode = mergedConfig.mode ?? (command === "build" ? "production" : "development");
   const env = { browser, command, manifestVersion, mode };
-  const root = path2.resolve(
+  const root = path3.resolve(
     inlineConfig.root ?? userConfig.root ?? process.cwd()
   );
-  const wxtDir = path2.resolve(root, ".wxt");
-  const srcDir = path2.resolve(root, mergedConfig.srcDir ?? root);
-  const entrypointsDir = path2.resolve(
+  const wxtDir = path3.resolve(root, ".wxt");
+  const srcDir = path3.resolve(root, mergedConfig.srcDir ?? root);
+  const entrypointsDir = path3.resolve(
     srcDir,
     mergedConfig.entrypointsDir ?? "entrypoints"
   );
-  const publicDir = path2.resolve(srcDir, mergedConfig.publicDir ?? "public");
-  const localesDir = path2.resolve(srcDir, mergedConfig.localesDir ?? "locales");
-  const typesDir = path2.resolve(wxtDir, "types");
-  const outBaseDir = path2.resolve(root, mergedConfig.outDir ?? ".output");
-  const outDir = path2.resolve(outBaseDir, `${browser}-mv${manifestVersion}`);
+  const filterEntrypoints = !!mergedConfig.filterEntrypoints?.length ? new Set(mergedConfig.filterEntrypoints) : void 0;
+  const publicDir = path3.resolve(srcDir, mergedConfig.publicDir ?? "public");
+  const typesDir = path3.resolve(wxtDir, "types");
+  const outBaseDir = path3.resolve(root, mergedConfig.outDir ?? ".output");
+  const outDir = path3.resolve(outBaseDir, `${browser}-mv${manifestVersion}`);
   const runnerConfig = await loadConfig({
     name: "web-ext",
     cwd: root,
@@ -1681,13 +1568,14 @@ async function getInternalConfig(inlineConfig, command, server) {
       "~": srcDir,
       "@@": root,
       "~~": root
-    }).map(([key, value]) => [key, path2.resolve(root, value)])
+    }).map(([key, value]) => [key, path3.resolve(root, value)])
   );
   const finalConfig = {
     browser,
     command,
     debug,
     entrypointsDir,
+    filterEntrypoints,
     env,
     fsCache: createFsCache(wxtDir),
     imports: mergedConfig.imports ?? {},
@@ -1698,7 +1586,6 @@ async function getInternalConfig(inlineConfig, command, server) {
     outBaseDir,
     outDir,
     publicDir,
-    localesDir,
     root,
     runnerConfig,
     srcDir,
@@ -1762,12 +1649,12 @@ function mergeInlineConfig(inlineConfig, userConfig) {
     configFile: inlineConfig.configFile,
     debug: inlineConfig.debug ?? userConfig.debug,
     entrypointsDir: inlineConfig.entrypointsDir ?? userConfig.entrypointsDir,
+    filterEntrypoints: inlineConfig.filterEntrypoints ?? userConfig.filterEntrypoints,
     imports,
     logger: inlineConfig.logger ?? userConfig.logger,
     manifest,
     mode: inlineConfig.mode ?? userConfig.mode,
     publicDir: inlineConfig.publicDir ?? userConfig.publicDir,
-    localesDir: inlineConfig.localesDir ?? userConfig.localesDir,
     runner,
     srcDir: inlineConfig.srcDir ?? userConfig.srcDir,
     outDir: inlineConfig.outDir ?? userConfig.outDir,
@@ -1850,7 +1737,7 @@ var ENTRY_TYPE_TO_GROUP_MAP = {
 import createJITI from "jiti";
 import { createUnimport as createUnimport3 } from "unimport";
 import fs8 from "fs-extra";
-import { resolve as resolve9 } from "node:path";
+import { relative as relative5, resolve as resolve9 } from "node:path";
 
 // src/core/utils/strings.ts
 function kebabCaseAlphanumeric(str) {
@@ -1872,16 +1759,16 @@ ${noImports}`;
 // src/core/utils/building/import-entrypoint.ts
 import { transformSync } from "esbuild";
 import { fileURLToPath } from "node:url";
-async function importEntrypointFile(path6, config) {
-  config.logger.debug("Loading file metadata:", path6);
-  const normalPath = normalizePath(path6);
+async function importEntrypointFile(path7, config) {
+  config.logger.debug("Loading file metadata:", path7);
+  const normalPath = normalizePath(path7);
   const unimport2 = createUnimport3({
     ...getUnimportOptions(config),
     // Only allow specific imports, not all from the project
     dirs: []
   });
   await unimport2.init();
-  const text = await fs8.readFile(path6, "utf-8");
+  const text = await fs8.readFile(path7, "utf-8");
   const textNoImports = removeProjectImportStatements(text);
   const { code } = await unimport2.injectImports(textNoImports);
   config.logger.debug(
@@ -1924,11 +1811,19 @@ async function importEntrypointFile(path6, config) {
     }
   );
   try {
-    const res = await jiti(path6);
+    const res = await jiti(path7);
     return res.default;
   } catch (err) {
-    config.logger.error(err);
-    throw err;
+    if (err instanceof ReferenceError) {
+      const variableName = err.message.replace(" is not defined", "");
+      const filePath = relative5(config.root, path7);
+      throw Error(
+        `${filePath}: Cannot use imported variable "${variableName}" outside the main function. See https://wxt.dev/guide/entrypoints.html#side-effects`,
+        { cause: err }
+      );
+    } else {
+      throw err;
+    }
   }
 }
 function getEsbuildOptions(opts) {
@@ -1941,15 +1836,15 @@ function getEsbuildOptions(opts) {
 }
 
 // src/core/utils/building/internal-build.ts
-import pc4 from "picocolors";
+import pc5 from "picocolors";
 import fs12 from "fs-extra";
 
 // src/core/utils/log/printBuildSummary.ts
 import { resolve as resolve10 } from "path";
 
 // src/core/utils/log/printFileList.ts
-import path3 from "node:path";
-import pc2 from "picocolors";
+import path4 from "node:path";
+import pc3 from "picocolors";
 import fs9 from "fs-extra";
 import { filesize } from "filesize";
 
@@ -1986,8 +1881,8 @@ async function printFileList(log, header, baseDir, files) {
   const fileRows = await Promise.all(
     files.map(async (file, i) => {
       const parts = [
-        path3.relative(process.cwd(), baseDir) + path3.sep,
-        path3.relative(baseDir, file)
+        path4.relative(process.cwd(), baseDir) + path4.sep,
+        path4.relative(baseDir, file)
       ];
       const prefix = i === files.length - 1 ? "  \u2514\u2500" : "  \u251C\u2500";
       const color = getChunkColor(file);
@@ -1995,25 +1890,25 @@ async function printFileList(log, header, baseDir, files) {
       totalSize += stats.size;
       const size = String(filesize(stats.size));
       return [
-        `${pc2.gray(prefix)} ${pc2.dim(parts[0])}${color(parts[1])}`,
-        pc2.dim(size)
+        `${pc3.gray(prefix)} ${pc3.dim(parts[0])}${color(parts[1])}`,
+        pc3.dim(size)
       ];
     })
   );
-  fileRows.push([`${pc2.cyan("\u03A3 Total size:")} ${String(filesize(totalSize))}`]);
+  fileRows.push([`${pc3.cyan("\u03A3 Total size:")} ${String(filesize(totalSize))}`]);
   printTable(log, header, fileRows);
 }
-var DEFAULT_COLOR = pc2.blue;
+var DEFAULT_COLOR = pc3.blue;
 var CHUNK_COLORS = {
-  ".js.map": pc2.gray,
-  ".cjs.map": pc2.gray,
-  ".mjs.map": pc2.gray,
-  ".html": pc2.green,
-  ".css": pc2.magenta,
-  ".js": pc2.cyan,
-  ".cjs": pc2.cyan,
-  ".mjs": pc2.cyan,
-  ".zip": pc2.yellow
+  ".js.map": pc3.gray,
+  ".cjs.map": pc3.gray,
+  ".mjs.map": pc3.gray,
+  ".html": pc3.green,
+  ".css": pc3.magenta,
+  ".js": pc3.cyan,
+  ".cjs": pc3.cyan,
+  ".mjs": pc3.cyan,
+  ".zip": pc3.yellow
 };
 function getChunkColor(filename) {
   return Object.entries(CHUNK_COLORS).find(([key]) => filename.endsWith(key))?.[1] ?? DEFAULT_COLOR;
@@ -2050,15 +1945,15 @@ function getChunkSortWeight(filename) {
 }
 
 // src/core/utils/log/printHeader.ts
-import pc3 from "picocolors";
+import pc4 from "picocolors";
 import { consola as consola2 } from "consola";
 function printHeader() {
   console.log();
-  consola2.log(`${pc3.gray("WXT")} ${pc3.gray(pc3.bold(version))}`);
+  consola2.log(`${pc4.gray("WXT")} ${pc4.gray(pc4.bold(version))}`);
 }
 
 // src/core/utils/building/internal-build.ts
-import glob4 from "fast-glob";
+import glob3 from "fast-glob";
 
 // src/core/utils/manifest.ts
 import fs11 from "fs-extra";
@@ -2633,7 +2528,7 @@ async function internalBuild(config) {
   const verb = config.command === "serve" ? "Pre-rendering" : "Building";
   const target = `${config.browser}-mv${config.manifestVersion}`;
   config.logger.info(
-    `${verb} ${pc4.cyan(target)} for ${pc4.cyan(config.mode)} with ${pc4.green(
+    `${verb} ${pc5.cyan(target)} for ${pc5.cyan(config.mode)} with ${pc5.green(
       `${config.builder.name} ${config.builder.version}`
     )}`
   );
@@ -2654,14 +2549,14 @@ async function internalBuild(config) {
     await combineAnalysisStats(config);
     config.logger.info(
       `Analysis complete:
-  ${pc4.gray("\u2514\u2500")} ${pc4.yellow("stats.html")}`
+  ${pc5.gray("\u2514\u2500")} ${pc5.yellow("stats.html")}`
     );
   }
   return output;
 }
 async function combineAnalysisStats(config) {
   const { execaCommand } = await import("./execa-4F7CCWCA.js");
-  const unixFiles = await glob4(`stats-*.json`, {
+  const unixFiles = await glob3(`stats-*.json`, {
     cwd: config.outDir,
     absolute: true
   });
@@ -2679,11 +2574,11 @@ async function build(config) {
 }
 
 // src/core/clean.ts
-import path4 from "node:path";
-import glob5 from "fast-glob";
+import path5 from "node:path";
+import glob4 from "fast-glob";
 import fs13 from "fs-extra";
 import { consola as consola3 } from "consola";
-import pc5 from "picocolors";
+import pc6 from "picocolors";
 async function clean(root = process.cwd()) {
   consola3.info("Cleaning Project");
   const tempDirs = [
@@ -2692,9 +2587,9 @@ async function clean(root = process.cwd()) {
     "**/.wxt",
     ".output/*"
   ];
-  consola3.debug("Looking for:", tempDirs.map(pc5.cyan).join(", "));
-  const directories = await glob5(tempDirs, {
-    cwd: path4.resolve(root),
+  consola3.debug("Looking for:", tempDirs.map(pc6.cyan).join(", "));
+  const directories = await glob4(tempDirs, {
+    cwd: path5.resolve(root),
     absolute: true,
     onlyDirectories: true,
     deep: 2
@@ -2705,21 +2600,21 @@ async function clean(root = process.cwd()) {
   }
   consola3.debug(
     "Found:",
-    directories.map((dir) => pc5.cyan(path4.relative(root, dir))).join(", ")
+    directories.map((dir) => pc6.cyan(path5.relative(root, dir))).join(", ")
   );
   for (const directory of directories) {
     await fs13.rm(directory, { force: true, recursive: true });
-    consola3.debug("Deleted " + pc5.cyan(path4.relative(root, directory)));
+    consola3.debug("Deleted " + pc6.cyan(path5.relative(root, directory)));
   }
 }
 
 // src/core/runners/wsl.ts
-import { relative as relative5 } from "node:path";
+import { relative as relative6 } from "node:path";
 function createWslRunner() {
   return {
     async openBrowser(config) {
       config.logger.warn(
-        `Cannot open browser when using WSL. Load "${relative5(
+        `Cannot open browser when using WSL. Load "${relative6(
           process.cwd(),
           config.outDir
         )}" as an unpacked extension manually`
@@ -2791,12 +2686,12 @@ var WARN_LOG_LEVEL = 40;
 var ERROR_LOG_LEVEL = 50;
 
 // src/core/runners/safari.ts
-import { relative as relative6 } from "node:path";
+import { relative as relative7 } from "node:path";
 function createSafariRunner() {
   return {
     async openBrowser(config) {
       config.logger.warn(
-        `Cannot Safari using web-ext. Load "${relative6(
+        `Cannot Safari using web-ext. Load "${relative7(
           process.cwd(),
           config.outDir
         )}" as an unpacked extension manually`
@@ -2808,12 +2703,12 @@ function createSafariRunner() {
 }
 
 // src/core/runners/manual.ts
-import { relative as relative7 } from "node:path";
+import { relative as relative8 } from "node:path";
 function createManualRunner() {
   return {
     async openBrowser(config) {
       config.logger.info(
-        `Load "${relative7(
+        `Load "${relative8(
           process.cwd(),
           config.outDir
         )}" as an unpacked extension manually`
@@ -2844,8 +2739,8 @@ async function createExtensionRunner(config) {
 // src/core/create-server.ts
 import { consola as consola4 } from "consola";
 import { Mutex } from "async-mutex";
-import pc6 from "picocolors";
-import { relative as relative8 } from "node:path";
+import pc7 from "picocolors";
+import { relative as relative9 } from "node:path";
 async function createServer(inlineConfig) {
   const port = await getPort();
   const hostname = "localhost";
@@ -2875,8 +2770,8 @@ async function createServer(inlineConfig) {
     reloadContentScript(contentScript) {
       server.ws.send("wxt:reload-content-script", contentScript);
     },
-    reloadPage(path6) {
-      server.ws.send("wxt:reload-page", path6);
+    reloadPage(path7) {
+      server.ws.send("wxt:reload-page", path7);
     },
     reloadExtension() {
       server.ws.send("wxt:reload-extension");
@@ -2911,12 +2806,12 @@ function createFileReloader(options) {
   const { server, getLatestConfig, updateConfig } = options;
   const fileChangedMutex = new Mutex();
   const changeQueue = [];
-  return async (event, path6) => {
+  return async (event, path7) => {
     const config = await getLatestConfig();
     updateConfig(config);
-    if (path6.startsWith(config.outBaseDir))
+    if (path7.startsWith(config.outBaseDir))
       return;
-    changeQueue.push([event, path6]);
+    changeQueue.push([event, path7]);
     await fileChangedMutex.runExclusive(async () => {
       const fileChanges = changeQueue.splice(0, changeQueue.length);
       if (fileChanges.length === 0)
@@ -2925,13 +2820,13 @@ function createFileReloader(options) {
       if (changes.type === "no-change")
         return;
       config.logger.info(
-        `Changed: ${Array.from(new Set(fileChanges.map((change) => change[1]))).map((file) => pc6.dim(relative8(config.root, file))).join(", ")}`
+        `Changed: ${Array.from(new Set(fileChanges.map((change) => change[1]))).map((file) => pc7.dim(relative9(config.root, file))).join(", ")}`
       );
       const rebuiltNames = changes.rebuildGroups.flat().map((entry) => {
-        return pc6.cyan(
-          relative8(config.outDir, getEntrypointOutputFile(entry, ""))
+        return pc7.cyan(
+          relative9(config.outDir, getEntrypointOutputFile(entry, ""))
         );
-      }).join(pc6.dim(", "));
+      }).join(pc7.dim(", "));
       const allEntrypoints = await findEntrypoints(config);
       const { output: newOutput } = await rebuild(
         config,
@@ -2988,8 +2883,8 @@ function reloadContentScripts(steps, config, server) {
 }
 function reloadHtmlPages(groups, server, config) {
   groups.flat().forEach((entry) => {
-    const path6 = getEntrypointBundlePath(entry, config.outDir, ".html");
-    server.reloadPage(path6);
+    const path7 = getEntrypointBundlePath(entry, config.outDir, ".html");
+    server.reloadPage(path7);
   });
 }
 
@@ -2998,8 +2893,8 @@ import prompts from "prompts";
 import { consola as consola5 } from "consola";
 import { downloadTemplate } from "giget";
 import fs14 from "fs-extra";
-import path5 from "node:path";
-import pc7 from "picocolors";
+import path6 from "node:path";
+import pc8 from "picocolors";
 async function initialize(options) {
   consola5.info("Initalizing new project");
   const templates = await listTemplates();
@@ -3028,11 +2923,11 @@ async function initialize(options) {
         type: () => options.packageManager == null ? "select" : void 0,
         message: "Package Manager",
         choices: [
-          { title: pc7.red("npm"), value: "npm" },
-          { title: pc7.yellow("pnpm"), value: "pnpm" },
-          { title: pc7.cyan("yarn"), value: "yarn" },
+          { title: pc8.red("npm"), value: "npm" },
+          { title: pc8.yellow("pnpm"), value: "pnpm" },
+          { title: pc8.cyan("yarn"), value: "yarn" },
           {
-            title: `${pc7.magenta("bun")}${pc7.gray(" (experimental)")}`,
+            title: `${pc8.magenta("bun")}${pc8.gray(" (experimental)")}`,
             value: "bun"
           }
         ]
@@ -3046,7 +2941,7 @@ async function initialize(options) {
   input.template ??= defaultTemplate;
   input.packageManager ??= options.packageManager;
   await cloneProject(input);
-  const cdPath = path5.relative(process.cwd(), path5.resolve(input.directory));
+  const cdPath = path6.relative(process.cwd(), path6.resolve(input.directory));
   console.log();
   consola5.log(
     `\u2728 WXT project created with the ${TEMPLATE_COLORS[input.template.name]?.(input.template.name) ?? input.template.name} template.`
@@ -3055,8 +2950,8 @@ async function initialize(options) {
   consola5.log("Next steps:");
   let step = 0;
   if (cdPath !== "")
-    consola5.log(`  ${++step}.`, pc7.cyan(`cd ${cdPath}`));
-  consola5.log(`  ${++step}.`, pc7.cyan(`${input.packageManager} install`));
+    consola5.log(`  ${++step}.`, pc8.cyan(`cd ${cdPath}`));
+  consola5.log(`  ${++step}.`, pc8.cyan(`${input.packageManager} install`));
   console.log();
 }
 async function listTemplates() {
@@ -3098,8 +2993,8 @@ async function cloneProject({
       force: true
     });
     await fs14.move(
-      path5.join(directory, "_gitignore"),
-      path5.join(directory, ".gitignore")
+      path6.join(directory, "_gitignore"),
+      path6.join(directory, ".gitignore")
     ).catch(
       (err) => consola5.warn("Failed to move _gitignore to .gitignore:", err)
     );
@@ -3110,11 +3005,11 @@ async function cloneProject({
   }
 }
 var TEMPLATE_COLORS = {
-  vanilla: pc7.blue,
-  vue: pc7.green,
-  react: pc7.cyan,
-  svelte: pc7.red,
-  solid: pc7.blue
+  vanilla: pc8.blue,
+  vue: pc8.green,
+  react: pc8.cyan,
+  svelte: pc8.red,
+  solid: pc8.blue
 };
 var TEMPLATE_SORT_WEIGHT = {
   vanilla: 0,
@@ -3132,7 +3027,7 @@ async function prepare(config) {
 
 // src/core/zip.ts
 import zipdir from "zip-dir";
-import { dirname as dirname5, relative as relative9, resolve as resolve13 } from "node:path";
+import { dirname as dirname5, relative as relative10, resolve as resolve13 } from "node:path";
 import fs15 from "fs-extra";
 import { minimatch as minimatch2 } from "minimatch";
 async function zip(config) {
@@ -3165,8 +3060,8 @@ async function zip(config) {
     );
     await zipdir(internalConfig.zip.sourcesRoot, {
       saveTo: sourcesZipPath,
-      filter(path6) {
-        const relativePath = relative9(internalConfig.zip.sourcesRoot, path6);
+      filter(path7) {
+        const relativePath = relative10(internalConfig.zip.sourcesRoot, path7);
         const matchedPattern = internalConfig.zip.ignoredSources.find(
           (pattern) => minimatch2(relativePath, pattern)
         );
@@ -3191,7 +3086,13 @@ var cli = cac("wxt");
 cli.help();
 cli.version(version);
 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("--mv3", "target manifest v3").option("--mv2", "target manifest v2").action(
+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(
+  "-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 server = await createServer({
       root,
@@ -3199,13 +3100,20 @@ cli.command("[root]", "start dev server").option("-c, --config <file>", "use spe
       browser: flags.browser,
       manifestVersion: flags.mv3 ? 3 : flags.mv2 ? 2 : void 0,
       configFile: flags.config,
-      debug: flags.debug
+      debug: flags.debug,
+      filterEntrypoints: getArrayFromFlags(flags, "filterEntrypoint")
     });
     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("--mv3", "target manifest v3").option("--mv2", "target manifest v2").option("--analyze", "visualize extension bundle").action(
+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").action(
   wrapAction(async (root, flags) => {
     await build({
       root,
@@ -3216,7 +3124,8 @@ cli.command("build [root]", "build for production").option("-c, --config <file>"
       debug: flags.debug,
       analysis: {
         enabled: flags.analyze
-      }
+      },
+      filterEntrypoints: getArrayFromFlags(flags, "filterEntrypoint")
     });
   })
 );
@@ -3282,3 +3191,7 @@ function wrapAction(cb, options) {
     }
   };
 }
+function getArrayFromFlags(flags, name) {
+  const array = [flags[name]].flat();
+  return array.filter((item) => item != null);
+}