wxt 0.14.2-alpha2 → 0.14.3

package/dist/{chunk-Y6R4JWTX.js → chunk-E6XT3LOQ.js}

@@ -1,5 +1,5 @@
 // package.json
-var version = "0.14.2-alpha2";
+var version = "0.14.3";
 
 // src/core/utils/arrays.ts
 function every(array, predicate) {
@@ -12,11 +12,11 @@ function every(array, predicate) {
 // src/core/utils/paths.ts
 import systemPath from "node:path";
 import normalize from "normalize-path";
-function normalizePath(path5) {
-  return normalize(path5);
+function normalizePath(path6) {
+  return normalize(path6);
 }
-function unnormalizePath(path5) {
-  return systemPath.normalize(path5);
+function unnormalizePath(path6) {
+  return systemPath.normalize(path6);
 }
 var CSS_EXTENSIONS = ["css", "scss", "sass", "less", "styl", "stylus"];
 var CSS_EXTENSIONS_PATTERN = `+(${CSS_EXTENSIONS.join("|")})`;
@@ -127,11 +127,11 @@ function resolvePerBrowserOption(option, browser) {
 }
 
 // src/core/utils/building/find-entrypoints.ts
-import { relative as relative4, resolve as resolve12 } from "path";
+import { relative as relative5, resolve as resolve12 } from "path";
 import fs12 from "fs-extra";
 import { minimatch } from "minimatch";
 import { parseHTML as parseHTML2 } from "linkedom";
-import JSON52 from "json5";
+import JSON5 from "json5";
 
 // src/core/utils/fs.ts
 import fs from "fs-extra";
@@ -151,145 +151,8 @@ async function getPublicFiles(config) {
 
 // src/core/utils/building/build-entrypoints.ts
 import fs2 from "fs-extra";
-import { dirname, resolve as resolve2, extname } from "node:path";
+import { dirname, resolve as resolve2 } 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++) {
@@ -298,10 +161,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) {
@@ -321,28 +181,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 = resolve2(config.localesDir, file);
-      const outPath = resolve2(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/building/generate-wxt-dir.ts
 import { createUnimport } from "unimport";
@@ -358,8 +196,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" },
@@ -432,7 +269,46 @@ function surroundInUnderscore(name) {
 }
 
 // src/core/utils/building/generate-wxt-dir.ts
-import glob2 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 fs3.ensureDir(config.typesDir);
   const references = [];
@@ -466,15 +342,17 @@ async function writePathsDeclarationFile(entrypoints, config) {
       config.outDir,
       entry.inputPath.endsWith(".html") ? ".html" : ".js"
     )
-  ).concat(await getPublicFiles(config)).map(normalizePath).map((path5) => `    | "/${path5}"`).sort().join("\n");
+  ).concat(await getPublicFiles(config)).map(normalizePath).map((path6) => `    | "/${path6}"`).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;
   }
 }
 `;
@@ -502,36 +380,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 glob2(`${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 fs3.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}",
@@ -541,13 +411,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;
 }
@@ -583,7 +447,7 @@ async function writeMainDeclarationFile(references, config) {
 }
 async function writeTsConfigFile(mainReference, config) {
   const dir = config.wxtDir;
-  const getTsconfigPath = (path5) => normalizePath(relative2(dir, path5));
+  const getTsconfigPath = (path6) => normalizePath(relative2(dir, path6));
   const paths = Object.entries(config.alias).flatMap(([alias, absolutePath]) => {
     const aliasPath = getTsconfigPath(absolutePath);
     return [
@@ -619,7 +483,7 @@ ${paths}
 
 // src/core/utils/building/get-internal-config.ts
 import { loadConfig } from "c12";
-import path3 from "node:path";
+import path4 from "node:path";
 
 // src/core/utils/cache.ts
 import fs4, { ensureDir } from "fs-extra";
@@ -628,14 +492,14 @@ function createFsCache(wxtDir) {
   const getPath = (key) => resolve4(wxtDir, "cache", encodeURIComponent(key));
   return {
     async set(key, value) {
-      const path5 = getPath(key);
-      await ensureDir(dirname2(path5));
-      await writeFileIfDifferent(path5, value);
+      const path6 = getPath(key);
+      await ensureDir(dirname2(path6));
+      await writeFileIfDifferent(path6, value);
     },
     async get(key) {
-      const path5 = getPath(key);
+      const path6 = getPath(key);
       try {
-        return await fs4.readFile(path5, "utf-8");
+        return await fs4.readFile(path6, "utf-8");
       } catch {
         return void 0;
       }
@@ -857,7 +721,7 @@ function download(config) {
 }
 
 // src/core/builders/vite/plugins/multipageMove.ts
-import { dirname as dirname4, extname as extname2, resolve as resolve6, join } from "node:path";
+import { dirname as dirname4, extname, resolve as resolve6, join } from "node:path";
 import fs5, { ensureDir as ensureDir2 } from "fs-extra";
 function multipageMove(entrypoints, config) {
   return {
@@ -876,7 +740,7 @@ function multipageMove(entrypoints, config) {
         const newBundlePath = getEntrypointBundlePath(
           entrypoint,
           config.outDir,
-          extname2(oldBundlePath)
+          extname(oldBundlePath)
         );
         if (newBundlePath === oldBundlePath) {
           config.logger.debug(
@@ -917,7 +781,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",
@@ -939,7 +803,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);
     }
@@ -1065,7 +929,7 @@ function globals(config) {
 }
 
 // src/core/builders/vite/plugins/webextensionPolyfillMock.ts
-import path2 from "node:path";
+import path3 from "node:path";
 function webextensionPolyfillMock(config) {
   return {
     name: "wxt:testing-inline-deps",
@@ -1074,7 +938,7 @@ function webextensionPolyfillMock(config) {
         resolve: {
           alias: {
             // Alias to use a mocked version of the polyfill
-            "webextension-polyfill": path2.resolve(
+            "webextension-polyfill": path3.resolve(
               config.root,
               "node_modules/wxt/dist/virtual/mock-browser"
             )
@@ -1359,20 +1223,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 = path3.resolve(
+  const root = path4.resolve(
     inlineConfig.root ?? userConfig.root ?? process.cwd()
   );
-  const wxtDir = path3.resolve(root, ".wxt");
-  const srcDir = path3.resolve(root, mergedConfig.srcDir ?? root);
-  const entrypointsDir = path3.resolve(
+  const wxtDir = path4.resolve(root, ".wxt");
+  const srcDir = path4.resolve(root, mergedConfig.srcDir ?? root);
+  const entrypointsDir = path4.resolve(
     srcDir,
     mergedConfig.entrypointsDir ?? "entrypoints"
   );
-  const publicDir = path3.resolve(srcDir, mergedConfig.publicDir ?? "public");
-  const localesDir = path3.resolve(srcDir, mergedConfig.localesDir ?? "locales");
-  const typesDir = path3.resolve(wxtDir, "types");
-  const outBaseDir = path3.resolve(root, mergedConfig.outDir ?? ".output");
-  const outDir = path3.resolve(outBaseDir, `${browser}-mv${manifestVersion}`);
+  const filterEntrypoints = !!mergedConfig.filterEntrypoints?.length ? new Set(mergedConfig.filterEntrypoints) : void 0;
+  const publicDir = path4.resolve(srcDir, mergedConfig.publicDir ?? "public");
+  const typesDir = path4.resolve(wxtDir, "types");
+  const outBaseDir = path4.resolve(root, mergedConfig.outDir ?? ".output");
+  const outDir = path4.resolve(outBaseDir, `${browser}-mv${manifestVersion}`);
   const runnerConfig = await loadConfig({
     name: "web-ext",
     cwd: root,
@@ -1388,13 +1252,14 @@ async function getInternalConfig(inlineConfig, command, server) {
       "~": srcDir,
       "@@": root,
       "~~": root
-    }).map(([key, value]) => [key, path3.resolve(root, value)])
+    }).map(([key, value]) => [key, path4.resolve(root, value)])
   );
   const finalConfig = {
     browser,
     command,
     debug,
     entrypointsDir,
+    filterEntrypoints,
     env,
     fsCache: createFsCache(wxtDir),
     imports: mergedConfig.imports ?? {},
@@ -1405,7 +1270,6 @@ async function getInternalConfig(inlineConfig, command, server) {
     outBaseDir,
     outDir,
     publicDir,
-    localesDir,
     root,
     runnerConfig,
     srcDir,
@@ -1469,12 +1333,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,
@@ -1557,7 +1421,7 @@ var ENTRY_TYPE_TO_GROUP_MAP = {
 import createJITI from "jiti";
 import { createUnimport as createUnimport3 } from "unimport";
 import fs7 from "fs-extra";
-import { resolve as resolve8 } from "node:path";
+import { relative as relative4, resolve as resolve8 } from "node:path";
 
 // src/core/utils/strings.ts
 function kebabCaseAlphanumeric(str) {
@@ -1579,16 +1443,16 @@ ${noImports}`;
 // src/core/utils/building/import-entrypoint.ts
 import { transformSync } from "esbuild";
 import { fileURLToPath } from "node:url";
-async function importEntrypointFile(path5, config) {
-  config.logger.debug("Loading file metadata:", path5);
-  const normalPath = normalizePath(path5);
+async function importEntrypointFile(path6, config) {
+  config.logger.debug("Loading file metadata:", path6);
+  const normalPath = normalizePath(path6);
   const unimport2 = createUnimport3({
     ...getUnimportOptions(config),
     // Only allow specific imports, not all from the project
     dirs: []
   });
   await unimport2.init();
-  const text = await fs7.readFile(path5, "utf-8");
+  const text = await fs7.readFile(path6, "utf-8");
   const textNoImports = removeProjectImportStatements(text);
   const { code } = await unimport2.injectImports(textNoImports);
   config.logger.debug(
@@ -1631,11 +1495,19 @@ async function importEntrypointFile(path5, config) {
     }
   );
   try {
-    const res = await jiti(path5);
+    const res = await jiti(path6);
     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 = relative4(config.root, path6);
+      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) {
@@ -1655,7 +1527,7 @@ import fs11 from "fs-extra";
 import { resolve as resolve9 } from "path";
 
 // src/core/utils/log/printFileList.ts
-import path4 from "node:path";
+import path5 from "node:path";
 import pc2 from "picocolors";
 import fs8 from "fs-extra";
 import { filesize } from "filesize";
@@ -1693,8 +1565,8 @@ async function printFileList(log, header, baseDir, files) {
   const fileRows = await Promise.all(
     files.map(async (file, i) => {
       const parts = [
-        path4.relative(process.cwd(), baseDir) + path4.sep,
-        path4.relative(baseDir, file)
+        path5.relative(process.cwd(), baseDir) + path5.sep,
+        path5.relative(baseDir, file)
       ];
       const prefix = i === files.length - 1 ? "  \u2514\u2500" : "  \u251C\u2500";
       const color = getChunkColor(file);
@@ -1761,7 +1633,7 @@ import pc3 from "picocolors";
 import { consola as consola2 } from "consola";
 
 // src/core/utils/building/internal-build.ts
-import glob3 from "fast-glob";
+import glob2 from "fast-glob";
 
 // src/core/utils/manifest.ts
 import fs10 from "fs-extra";
@@ -2364,7 +2236,7 @@ async function internalBuild(config) {
 }
 async function combineAnalysisStats(config) {
   const { execaCommand } = await import("./execa-4F7CCWCA.js");
-  const unixFiles = await glob3(`stats-*.json`, {
+  const unixFiles = await glob2(`stats-*.json`, {
     cwd: config.outDir,
     absolute: true
   });
@@ -2376,9 +2248,10 @@ async function combineAnalysisStats(config) {
 }
 
 // src/core/utils/building/find-entrypoints.ts
-import glob4 from "fast-glob";
+import glob3 from "fast-glob";
+import pc5 from "picocolors";
 async function findEntrypoints(config) {
-  const relativePaths = await glob4(Object.keys(PATH_GLOB_TO_TYPE_MAP), {
+  const relativePaths = await glob3(Object.keys(PATH_GLOB_TO_TYPE_MAP), {
     cwd: config.entrypointsDir
   });
   relativePaths.sort();
@@ -2387,11 +2260,16 @@ async function findEntrypoints(config) {
     const inputPath = resolve12(config.entrypointsDir, relativePath);
     const name = getEntrypointName(config.entrypointsDir, inputPath);
     const matchingGlob = pathGlobs.find(
-      (glob5) => minimatch(relativePath, glob5)
+      (glob4) => minimatch(relativePath, glob4)
     );
     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;
   }, []);
@@ -2443,11 +2321,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) => `${pc5.dim("-")} ${pc5.cyan(item)}`).join("\n")}`
+    );
+  }
   const targetEntrypoints = entrypoints.filter((entry) => {
     const { include, exclude } = entry.options;
     if (include?.length && exclude?.length) {
@@ -2462,6 +2348,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);
@@ -2481,7 +2370,7 @@ function preventDuplicateEntrypointNames(config, files) {
       if (absolutePaths.length > 1) {
         lines.push(`- ${name}`);
         absolutePaths.forEach((absolutePath) => {
-          lines.push(`  - ${relative4(config.root, absolutePath)}`);
+          lines.push(`  - ${relative5(config.root, absolutePath)}`);
         });
       }
       return lines;
@@ -2506,15 +2395,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 fs12.readFile(inputPath, "utf-8");
   const { document } = parseHTML2(content);
   const options = getHtmlBaseOptions(document);
@@ -2524,7 +2413,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}`,
@@ -2545,10 +2434,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 fs12.readFile(inputPath, "utf-8");
   const { document } = parseHTML2(content);
   const options = getHtmlBaseOptions(document);
@@ -2569,10 +2459,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 fs12.readFile(inputPath, "utf-8");
   const { document } = parseHTML2(content);
   return {
@@ -2580,10 +2471,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
@@ -2600,10 +2492,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(
@@ -2627,10 +2520,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(
@@ -2642,7 +2536,8 @@ async function getContentScriptEntrypoint(config, { inputPath, name }) {
     name,
     inputPath,
     outputDir: resolve12(config.outDir, CONTENT_SCRIPT_OUT_DIR),
-    options
+    options,
+    skipped
   };
 }
 var PATH_GLOB_TO_TYPE_MAP = {