wxt 0.17.7 → 0.17.9

package/README.md

@@ -35,14 +35,14 @@
 
 ## Demo
 
-https://github.com/wxt-dev/wxt/assets/10101283/07359e53-f491-43b6-8e8f-fae94aec8063
+https://github.com/wxt-dev/wxt/assets/10101283/4d678939-1bdb-495c-9c36-3aa281d84c94
 
 ## Quick Start
 
 Bootstrap a new project:
 
 ```sh
-pnpx wxt@latest init <project-name>
+pnpm dlx wxt@latest init <project-name>
 ```
 
 Or see the [installation guide](https://wxt.dev/guide/installation.html) to get started with WXT.

package/dist/{chunk-QFL6IFHC.js → chunk-ONUEB57P.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-VBXJIVYU.js";
 
 // package.json
-var version = "0.17.7";
+var version = "0.17.9";
 
 // src/core/utils/paths.ts
 import systemPath from "node:path";
@@ -47,6 +47,7 @@ async function buildEntrypoints(groups, spinner) {
     try {
       steps.push(await wxt.config.builder.build(group));
     } catch (err) {
+      spinner.stop().clear();
       wxt.logger.error(err);
       throw Error(`Failed to build ${groupNames.join(", ")}`, { cause: err });
     }
@@ -1698,7 +1699,7 @@ async function resolveConfig(inlineConfig, command, server) {
     logger.level = LogLevels.debug;
   const browser = mergedConfig.browser ?? "chrome";
   const manifestVersion = mergedConfig.manifestVersion ?? (browser === "firefox" || browser === "safari" ? 2 : 3);
-  const mode = mergedConfig.mode ?? (command === "build" ? "production" : "development");
+  const mode = mergedConfig.mode ?? COMMAND_MODES[command];
   const env = { browser, command, manifestVersion, mode };
   const root = path5.resolve(
     inlineConfig.root ?? userConfig.root ?? process.cwd()
@@ -1739,12 +1740,6 @@ async function resolveConfig(inlineConfig, command, server) {
       "~~": root
     }).map(([key, value]) => [key, path5.resolve(root, value)])
   );
-  const analysisOutputFile = path5.resolve(
-    root,
-    mergedConfig.analysis?.outputFile ?? "stats.html"
-  );
-  const analysisOutputDir = path5.dirname(analysisOutputFile);
-  const analysisOutputName = path5.parse(analysisOutputFile).name;
   const finalConfig = {
     browser,
     command,
@@ -1767,24 +1762,14 @@ async function resolveConfig(inlineConfig, command, server) {
     srcDir,
     typesDir,
     wxtDir,
-    zip: resolveInternalZipConfig(root, mergedConfig),
-    transformManifest(manifest) {
-      userConfig.transformManifest?.(manifest);
-      inlineConfig.transformManifest?.(manifest);
-    },
-    analysis: {
-      enabled: mergedConfig.analysis?.enabled ?? false,
-      template: mergedConfig.analysis?.template ?? "treemap",
-      outputFile: analysisOutputFile,
-      outputDir: analysisOutputDir,
-      outputName: analysisOutputName,
-      keepArtifacts: mergedConfig.analysis?.keepArtifacts ?? false
-    },
+    zip: resolveZipConfig(root, mergedConfig),
+    transformManifest: mergedConfig.transformManifest,
+    analysis: resolveAnalysisConfig(root, mergedConfig),
     userConfigMetadata: userConfigMetadata ?? {},
     alias,
-    experimental: {
-      includeBrowserPolyfill: mergedConfig.experimental?.includeBrowserPolyfill ?? true
-    },
+    experimental: defu(mergedConfig.experimental, {
+      includeBrowserPolyfill: true
+    }),
     server,
     dev: {
       reloadCommand
@@ -1805,70 +1790,27 @@ async function resolveManifestConfig(env, manifest) {
   return await (typeof manifest === "function" ? manifest(env) : manifest ?? {});
 }
 function mergeInlineConfig(inlineConfig, userConfig) {
-  let imports;
-  if (inlineConfig.imports === false || userConfig.imports === false) {
-    imports = false;
-  } else if (userConfig.imports == null && inlineConfig.imports == null) {
-    imports = void 0;
-  } else {
-    imports = defu(inlineConfig.imports ?? {}, userConfig.imports ?? {});
-  }
+  const imports = inlineConfig.imports === false || userConfig.imports === false ? false : userConfig.imports == null && inlineConfig.imports == null ? void 0 : defu(inlineConfig.imports ?? {}, userConfig.imports ?? {});
   const manifest = async (env) => {
     const user = await resolveManifestConfig(env, userConfig.manifest);
     const inline = await resolveManifestConfig(env, inlineConfig.manifest);
     return defu(inline, user);
   };
-  const runner = defu(
-    inlineConfig.runner ?? {},
-    userConfig.runner ?? {}
-  );
-  const zip = defu(
-    inlineConfig.zip ?? {},
-    userConfig.zip ?? {}
-  );
-  const hooks = defu(
-    inlineConfig.hooks ?? {},
-    userConfig.hooks ?? {}
-  );
+  const transformManifest = (manifest2) => {
+    userConfig.transformManifest?.(manifest2);
+    inlineConfig.transformManifest?.(manifest2);
+  };
   return {
-    root: inlineConfig.root ?? userConfig.root,
-    browser: inlineConfig.browser ?? userConfig.browser,
-    manifestVersion: inlineConfig.manifestVersion ?? userConfig.manifestVersion,
-    configFile: inlineConfig.configFile,
-    debug: inlineConfig.debug ?? userConfig.debug,
-    entrypointsDir: inlineConfig.entrypointsDir ?? userConfig.entrypointsDir,
-    filterEntrypoints: inlineConfig.filterEntrypoints ?? userConfig.filterEntrypoints,
+    ...defu(inlineConfig, userConfig),
+    // Custom merge values
+    transformManifest,
     imports,
-    logger: inlineConfig.logger ?? userConfig.logger,
     manifest,
-    mode: inlineConfig.mode ?? userConfig.mode,
-    publicDir: inlineConfig.publicDir ?? userConfig.publicDir,
-    runner,
-    srcDir: inlineConfig.srcDir ?? userConfig.srcDir,
-    outDir: inlineConfig.outDir ?? userConfig.outDir,
-    zip,
-    analysis: {
-      ...userConfig.analysis,
-      ...inlineConfig.analysis
-    },
-    alias: {
-      ...userConfig.alias,
-      ...inlineConfig.alias
-    },
-    experimental: {
-      ...userConfig.experimental,
-      ...inlineConfig.experimental
-    },
-    vite: void 0,
-    transformManifest: void 0,
-    dev: {
-      ...userConfig.dev,
-      ...inlineConfig.dev
-    },
-    hooks
+    // Vite builder handles merging vite config internally
+    vite: void 0
   };
 }
-function resolveInternalZipConfig(root, mergedConfig) {
+function resolveZipConfig(root, mergedConfig) {
   const downloadedPackagesDir = path5.resolve(root, ".wxt/local_modules");
   return {
     name: void 0,
@@ -1893,6 +1835,23 @@ function resolveInternalZipConfig(root, mergedConfig) {
     downloadedPackagesDir
   };
 }
+function resolveAnalysisConfig(root, mergedConfig) {
+  const analysisOutputFile = path5.resolve(
+    root,
+    mergedConfig.analysis?.outputFile ?? "stats.html"
+  );
+  const analysisOutputDir = path5.dirname(analysisOutputFile);
+  const analysisOutputName = path5.parse(analysisOutputFile).name;
+  return {
+    enabled: mergedConfig.analysis?.enabled ?? false,
+    open: mergedConfig.analysis?.open ?? false,
+    template: mergedConfig.analysis?.template ?? "treemap",
+    outputFile: analysisOutputFile,
+    outputDir: analysisOutputDir,
+    outputName: analysisOutputName,
+    keepArtifacts: mergedConfig.analysis?.keepArtifacts ?? false
+  };
+}
 async function getUnimportOptions(wxtDir, logger, config) {
   if (config.imports === false)
     return false;
@@ -1945,6 +1904,10 @@ function logMissingDir(logger, name, expected) {
     )}`
   );
 }
+var COMMAND_MODES = {
+  build: "production",
+  serve: "development"
+};
 
 // src/core/utils/building/group-entrypoints.ts
 function groupEntrypoints(entrypoints) {
@@ -2377,7 +2340,7 @@ async function generateManifest(entrypoints, buildOutput) {
     addDevModeCsp(manifest);
   if (wxt.config.command === "serve")
     addDevModePermissions(manifest);
-  wxt.config.transformManifest(manifest);
+  wxt.config.transformManifest?.(manifest);
   await wxt.hooks.callHook("build:manifestGenerated", wxt, manifest);
   if (wxt.config.manifestVersion === 2) {
     convertWebAccessibleResourcesToMv2(manifest);
@@ -2925,6 +2888,7 @@ var ValidationError = class extends Error {
 // src/core/utils/building/internal-build.ts
 import consola3 from "consola";
 import { mergeJsonOutputs } from "@aklinker1/rollup-plugin-visualizer";
+import { isCI } from "ci-info";
 async function internalBuild() {
   await wxt.hooks.callHook("build:before", wxt);
   const verb = wxt.config.command === "serve" ? "Pre-rendering" : "Building";
@@ -2967,6 +2931,15 @@ async function internalBuild() {
       `Analysis complete:
   ${pc5.gray("\u2514\u2500")} ${pc5.yellow(statsPath)}`
     );
+    if (wxt.config.analysis.open) {
+      if (isCI) {
+        wxt.logger.debug(`Skipped opening ${pc5.yellow(statsPath)} in CI`);
+      } else {
+        wxt.logger.info(`Opening ${pc5.yellow(statsPath)} in browser...`);
+        const { default: open } = await import("open");
+        open(wxt.config.analysis.outputFile);
+      }
+    }
   }
   return output;
 }

package/dist/cli.d.ts

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

package/dist/cli.js

@@ -279,6 +279,7 @@ async function buildEntrypoints(groups, spinner) {
     try {
       steps.push(await wxt.config.builder.build(group));
     } catch (err) {
+      spinner.stop().clear();
       wxt.logger.error(err);
       throw Error(`Failed to build ${groupNames.join(", ")}`, { cause: err });
     }
@@ -1905,7 +1906,7 @@ async function resolveConfig(inlineConfig, command, server) {
     logger.level = LogLevels.debug;
   const browser = mergedConfig.browser ?? "chrome";
   const manifestVersion = mergedConfig.manifestVersion ?? (browser === "firefox" || browser === "safari" ? 2 : 3);
-  const mode = mergedConfig.mode ?? (command === "build" ? "production" : "development");
+  const mode = mergedConfig.mode ?? COMMAND_MODES[command];
   const env = { browser, command, manifestVersion, mode };
   const root = path5.resolve(
     inlineConfig.root ?? userConfig.root ?? process.cwd()
@@ -1946,12 +1947,6 @@ async function resolveConfig(inlineConfig, command, server) {
       "~~": root
     }).map(([key, value]) => [key, path5.resolve(root, value)])
   );
-  const analysisOutputFile = path5.resolve(
-    root,
-    mergedConfig.analysis?.outputFile ?? "stats.html"
-  );
-  const analysisOutputDir = path5.dirname(analysisOutputFile);
-  const analysisOutputName = path5.parse(analysisOutputFile).name;
   const finalConfig = {
     browser,
     command,
@@ -1974,24 +1969,14 @@ async function resolveConfig(inlineConfig, command, server) {
     srcDir,
     typesDir,
     wxtDir,
-    zip: resolveInternalZipConfig(root, mergedConfig),
-    transformManifest(manifest) {
-      userConfig.transformManifest?.(manifest);
-      inlineConfig.transformManifest?.(manifest);
-    },
-    analysis: {
-      enabled: mergedConfig.analysis?.enabled ?? false,
-      template: mergedConfig.analysis?.template ?? "treemap",
-      outputFile: analysisOutputFile,
-      outputDir: analysisOutputDir,
-      outputName: analysisOutputName,
-      keepArtifacts: mergedConfig.analysis?.keepArtifacts ?? false
-    },
+    zip: resolveZipConfig(root, mergedConfig),
+    transformManifest: mergedConfig.transformManifest,
+    analysis: resolveAnalysisConfig(root, mergedConfig),
     userConfigMetadata: userConfigMetadata ?? {},
     alias,
-    experimental: {
-      includeBrowserPolyfill: mergedConfig.experimental?.includeBrowserPolyfill ?? true
-    },
+    experimental: defu(mergedConfig.experimental, {
+      includeBrowserPolyfill: true
+    }),
     server,
     dev: {
       reloadCommand
@@ -2012,70 +1997,27 @@ async function resolveManifestConfig(env, manifest) {
   return await (typeof manifest === "function" ? manifest(env) : manifest ?? {});
 }
 function mergeInlineConfig(inlineConfig, userConfig) {
-  let imports;
-  if (inlineConfig.imports === false || userConfig.imports === false) {
-    imports = false;
-  } else if (userConfig.imports == null && inlineConfig.imports == null) {
-    imports = void 0;
-  } else {
-    imports = defu(inlineConfig.imports ?? {}, userConfig.imports ?? {});
-  }
+  const imports = inlineConfig.imports === false || userConfig.imports === false ? false : userConfig.imports == null && inlineConfig.imports == null ? void 0 : defu(inlineConfig.imports ?? {}, userConfig.imports ?? {});
   const manifest = async (env) => {
     const user = await resolveManifestConfig(env, userConfig.manifest);
     const inline = await resolveManifestConfig(env, inlineConfig.manifest);
     return defu(inline, user);
   };
-  const runner = defu(
-    inlineConfig.runner ?? {},
-    userConfig.runner ?? {}
-  );
-  const zip2 = defu(
-    inlineConfig.zip ?? {},
-    userConfig.zip ?? {}
-  );
-  const hooks = defu(
-    inlineConfig.hooks ?? {},
-    userConfig.hooks ?? {}
-  );
+  const transformManifest = (manifest2) => {
+    userConfig.transformManifest?.(manifest2);
+    inlineConfig.transformManifest?.(manifest2);
+  };
   return {
-    root: inlineConfig.root ?? userConfig.root,
-    browser: inlineConfig.browser ?? userConfig.browser,
-    manifestVersion: inlineConfig.manifestVersion ?? userConfig.manifestVersion,
-    configFile: inlineConfig.configFile,
-    debug: inlineConfig.debug ?? userConfig.debug,
-    entrypointsDir: inlineConfig.entrypointsDir ?? userConfig.entrypointsDir,
-    filterEntrypoints: inlineConfig.filterEntrypoints ?? userConfig.filterEntrypoints,
+    ...defu(inlineConfig, userConfig),
+    // Custom merge values
+    transformManifest,
     imports,
-    logger: inlineConfig.logger ?? userConfig.logger,
     manifest,
-    mode: inlineConfig.mode ?? userConfig.mode,
-    publicDir: inlineConfig.publicDir ?? userConfig.publicDir,
-    runner,
-    srcDir: inlineConfig.srcDir ?? userConfig.srcDir,
-    outDir: inlineConfig.outDir ?? userConfig.outDir,
-    zip: zip2,
-    analysis: {
-      ...userConfig.analysis,
-      ...inlineConfig.analysis
-    },
-    alias: {
-      ...userConfig.alias,
-      ...inlineConfig.alias
-    },
-    experimental: {
-      ...userConfig.experimental,
-      ...inlineConfig.experimental
-    },
-    vite: void 0,
-    transformManifest: void 0,
-    dev: {
-      ...userConfig.dev,
-      ...inlineConfig.dev
-    },
-    hooks
+    // Vite builder handles merging vite config internally
+    vite: void 0
   };
 }
-function resolveInternalZipConfig(root, mergedConfig) {
+function resolveZipConfig(root, mergedConfig) {
   const downloadedPackagesDir = path5.resolve(root, ".wxt/local_modules");
   return {
     name: void 0,
@@ -2100,6 +2042,23 @@ function resolveInternalZipConfig(root, mergedConfig) {
     downloadedPackagesDir
   };
 }
+function resolveAnalysisConfig(root, mergedConfig) {
+  const analysisOutputFile = path5.resolve(
+    root,
+    mergedConfig.analysis?.outputFile ?? "stats.html"
+  );
+  const analysisOutputDir = path5.dirname(analysisOutputFile);
+  const analysisOutputName = path5.parse(analysisOutputFile).name;
+  return {
+    enabled: mergedConfig.analysis?.enabled ?? false,
+    open: mergedConfig.analysis?.open ?? false,
+    template: mergedConfig.analysis?.template ?? "treemap",
+    outputFile: analysisOutputFile,
+    outputDir: analysisOutputDir,
+    outputName: analysisOutputName,
+    keepArtifacts: mergedConfig.analysis?.keepArtifacts ?? false
+  };
+}
 async function getUnimportOptions(wxtDir, logger, config) {
   if (config.imports === false)
     return false;
@@ -2152,6 +2111,10 @@ function logMissingDir(logger, name, expected) {
     )}`
   );
 }
+var COMMAND_MODES = {
+  build: "production",
+  serve: "development"
+};
 
 // src/core/utils/building/group-entrypoints.ts
 function groupEntrypoints(entrypoints) {
@@ -2415,7 +2378,7 @@ function getChunkSortWeight(filename) {
 import pc4 from "picocolors";
 
 // package.json
-var version = "0.17.7";
+var version = "0.17.9";
 
 // src/core/utils/log/printHeader.ts
 import { consola as consola2 } from "consola";
@@ -2593,7 +2556,7 @@ async function generateManifest(entrypoints, buildOutput) {
     addDevModeCsp(manifest);
   if (wxt.config.command === "serve")
     addDevModePermissions(manifest);
-  wxt.config.transformManifest(manifest);
+  wxt.config.transformManifest?.(manifest);
   await wxt.hooks.callHook("build:manifestGenerated", wxt, manifest);
   if (wxt.config.manifestVersion === 2) {
     convertWebAccessibleResourcesToMv2(manifest);
@@ -3141,6 +3104,7 @@ var ValidationError = class extends Error {
 // src/core/utils/building/internal-build.ts
 import consola3 from "consola";
 import { mergeJsonOutputs } from "@aklinker1/rollup-plugin-visualizer";
+import { isCI } from "ci-info";
 async function internalBuild() {
   await wxt.hooks.callHook("build:before", wxt);
   const verb = wxt.config.command === "serve" ? "Pre-rendering" : "Building";
@@ -3183,6 +3147,15 @@ async function internalBuild() {
       `Analysis complete:
   ${pc5.gray("\u2514\u2500")} ${pc5.yellow(statsPath)}`
     );
+    if (wxt.config.analysis.open) {
+      if (isCI) {
+        wxt.logger.debug(`Skipped opening ${pc5.yellow(statsPath)} in CI`);
+      } else {
+        wxt.logger.info(`Opening ${pc5.yellow(statsPath)} in browser...`);
+        const { default: open } = await import("open");
+        open(wxt.config.analysis.outputFile);
+      }
+    }
   }
   return output;
 }
@@ -3529,30 +3502,33 @@ function createFileReloader(server) {
         `Changed: ${Array.from(new Set(fileChanges)).map((file) => pc7.dim(relative10(wxt.config.root, file))).join(", ")}`
       );
       const allEntrypoints = await findEntrypoints();
-      const { output: newOutput } = await rebuild(
-        allEntrypoints,
-        // TODO: this excludes new entrypoints, so they're not built until the dev command is restarted
-        changes.rebuildGroups,
-        changes.cachedOutput
-      );
-      server.currentOutput = newOutput;
-      switch (changes.type) {
-        case "extension-reload":
-          server.reloadExtension();
-          consola5.success(`Reloaded extension`);
-          break;
-        case "html-reload":
-          const { reloadedNames } = reloadHtmlPages(
-            changes.rebuildGroups,
-            server
-          );
-          consola5.success(`Reloaded: ${getFilenameList(reloadedNames)}`);
-          break;
-        case "content-script-reload":
-          reloadContentScripts(changes.changedSteps, server);
-          const rebuiltNames = changes.rebuildGroups.flat().map((entry) => entry.name);
-          consola5.success(`Reloaded: ${getFilenameList(rebuiltNames)}`);
-          break;
+      try {
+        const { output: newOutput } = await rebuild(
+          allEntrypoints,
+          // TODO: this excludes new entrypoints, so they're not built until the dev command is restarted
+          changes.rebuildGroups,
+          changes.cachedOutput
+        );
+        server.currentOutput = newOutput;
+        switch (changes.type) {
+          case "extension-reload":
+            server.reloadExtension();
+            consola5.success(`Reloaded extension`);
+            break;
+          case "html-reload":
+            const { reloadedNames } = reloadHtmlPages(
+              changes.rebuildGroups,
+              server
+            );
+            consola5.success(`Reloaded: ${getFilenameList(reloadedNames)}`);
+            break;
+          case "content-script-reload":
+            reloadContentScripts(changes.changedSteps, server);
+            const rebuiltNames = changes.rebuildGroups.flat().map((entry) => entry.name);
+            consola5.success(`Reloaded: ${getFilenameList(rebuiltNames)}`);
+            break;
+        }
+      } catch (err) {
       }
     });
   };
@@ -3663,6 +3639,16 @@ async function initialize(options) {
   input.directory ??= options.directory;
   input.template ??= defaultTemplate;
   input.packageManager ??= options.packageManager;
+  const isExists = await fs15.pathExists(input.directory);
+  if (isExists) {
+    const isEmpty = (await fs15.readdir(input.directory)).length === 0;
+    if (!isEmpty) {
+      consola6.error(
+        `The directory ${path8.resolve(input.directory)} is not empty. Aborted.`
+      );
+      process.exit(1);
+    }
+  }
   await cloneProject(input);
   const cdPath = path8.relative(process.cwd(), path8.resolve(input.directory));
   console.log();
@@ -3692,7 +3678,8 @@ async function listTemplates() {
       return l.name.localeCompare(r.name);
     });
   } catch (err) {
-    throw Error(`Cannot load templates: ${JSON.stringify(err, null, 2)}`);
+    consola6.error(err);
+    throw Error(`Failed to load templates`);
   }
 }
 async function cloneProject({
@@ -3758,7 +3745,7 @@ async function zip(config) {
   const applyTemplate = (template) => template.replaceAll("{{name}}", projectName).replaceAll("{{browser}}", wxt.config.browser).replaceAll(
     "{{version}}",
     output.manifest.version_name ?? output.manifest.version
-  ).replaceAll("{{manifestVersion}}", `mv${wxt.config.manifestVersion}`);
+  ).replaceAll("{{mode}}", wxt.config.mode).replaceAll("{{manifestVersion}}", `mv${wxt.config.manifestVersion}`);
   await fs16.ensureDir(wxt.config.outBaseDir);
   const outZipFilename = applyTemplate(wxt.config.zip.artifactTemplate);
   const outZipPath = path9.resolve(wxt.config.outBaseDir, outZipFilename);
@@ -3953,7 +3940,7 @@ cli.command("build [root]", "build for production").option("-c, --config <file>"
   {
     type: []
   }
-).option("--mv3", "target manifest v3").option("--mv2", "target manifest v2").option("--analyze", "visualize extension bundle").action(
+).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,
@@ -3962,7 +3949,10 @@ cli.command("build [root]", "build for production").option("-c, --config <file>"
       manifestVersion: flags.mv3 ? 3 : flags.mv2 ? 2 : void 0,
       configFile: flags.config,
       debug: flags.debug,
-      analysis: flags.analyze ? { enabled: true } : void 0,
+      analysis: flags.analyze ? {
+        enabled: true,
+        open: flags.analyzeOpen
+      } : void 0,
       filterEntrypoints: getArrayFromFlags(flags, "filterEntrypoint")
     });
   })

package/dist/client.d.ts

@@ -167,7 +167,7 @@ interface ContentScriptAnchoredOptions {
      * In combination with `anchor`, decide how to add the UI to the DOM.
      *
      * - `"last"` (default) - Add the UI as the last child of the `anchor` element
-     * - `"first"` - Add the UI as the last child of the `anchor` element
+     * - `"first"` - Add the UI as the first child of the `anchor` element
      * - `"replace"` - Replace the `anchor` element with the UI.
      * - `"before"` - Add the UI as the sibling before the `anchor` element
      * - `"after"` - Add the UI as the sibling after the `anchor` element

package/dist/{index-l43sonfW.d.cts → index-mZodC81T.d.cts}

@@ -235,10 +235,11 @@ interface InlineConfig {
          *
          * Available template variables:
          *
-         * - `{{name}}` - The project's name converted to kebab-case
-         * - `{{version}}` - The version_name or version from the manifest
-         * - `{{browser}}` - The target browser from the `--browser` CLI flag
-         * - `{{manifestVersion}}` - Either "2" or "3"
+         * - <span v-pre>`{{name}}`</span> - The project's name converted to kebab-case
+         * - <span v-pre>`{{version}}`</span> - The version_name or version from the manifest
+         * - <span v-pre>`{{browser}}`</span> - The target browser from the `--browser` CLI flag
+         * - <span v-pre>`{{mode}}`</span> - The current mode
+         * - <span v-pre>`{{manifestVersion}}`</span> - Either "2" or "3"
          *
          * @default "{{name}}-{{version}}-{{browser}}.zip"
          */
@@ -248,10 +249,11 @@ interface InlineConfig {
          *
          * Available template variables:
          *
-         * - `{{name}}` - The project's name converted to kebab-case
-         * - `{{version}}` - The version_name or version from the manifest
-         * - `{{browser}}` - The target browser from the `--browser` CLI flag
-         * - `{{manifestVersion}}` - Either "2" or "3"
+         * - <span v-pre>`{{name}}`</span> - The project's name converted to kebab-case
+         * - <span v-pre>`{{version}}`</span> - The version_name or version from the manifest
+         * - <span v-pre>`{{browser}}`</span> - The target browser from the `--browser` CLI flag
+         * - <span v-pre>`{{mode}}`</span> - The current mode
+         * - <span v-pre>`{{manifestVersion}}`</span> - Either "2" or "3"
          *
          * @default "{{name}}-{{version}}-sources.zip"
          */
@@ -346,6 +348,12 @@ interface InlineConfig {
          * @default false
          */
         enabled?: boolean;
+        /**
+         * Set to true to automatically open the `stats.html` file when the build is finished. When building in CI, the browser will never open.
+         *
+         * @default false
+         */
+        open?: boolean;
         /**
          * When running `wxt build --analyze` or setting `analysis.enabled` to true, customize how the
          * bundle will be visualized. See
@@ -794,7 +802,7 @@ interface ConfigEnv {
     /**
      * The command used to run WXT. `"serve"` during development and `"build"` for any other command.
      */
-    command: 'build' | 'serve';
+    command: WxtCommand;
     /**
      * Browser passed in from the CLI via the `-b` or `--browser` flag. Defaults to `"chrome"` when not passed.
      */
@@ -806,6 +814,7 @@ interface ConfigEnv {
      */
     manifestVersion: 2 | 3;
 }
+type WxtCommand = 'build' | 'serve';
 /**
  * Configure how the browser starts up.
  */
@@ -1023,7 +1032,7 @@ interface ResolvedConfig {
      */
     wxtModuleDir: string;
     mode: string;
-    command: 'build' | 'serve';
+    command: WxtCommand;
     browser: TargetBrowser;
     manifestVersion: TargetManifestVersion;
     env: ConfigEnv;
@@ -1043,9 +1052,13 @@ interface ResolvedConfig {
         downloadedPackagesDir: string;
         downloadPackages: string[];
     };
-    transformManifest: (manifest: Manifest.WebExtensionManifest) => void;
+    /**
+     * @deprecated Use `build:manifestGenerated` hook instead.
+     */
+    transformManifest?: (manifest: Manifest.WebExtensionManifest) => void;
     analysis: {
         enabled: boolean;
+        open: boolean;
         template: NonNullable<PluginVisualizerOptions['template']>;
         /** Absolute file path to the `stats.html` file */
         outputFile: string;
@@ -1153,4 +1166,4 @@ interface Dependency {
     version: string;
 }
 
-export type { EslintGlobalsPropValue as $, UserManifest as A, BuildOutput as B, ContentScriptEntrypoint as C, UserManifestFn as D, ExtensionRunnerConfig as E, ConfigEnv as F, GenericEntrypoint as G, WxtBuilder as H, InlineConfig as I, WxtBuilderServer as J, ServerInfo as K, Logger as L, MainWorldContentScriptEntrypointOptions as M, HookResult as N, OutputFile as O, PopupEntrypointOptions as P, WxtHooks as Q, ReloadContentScriptPayload as R, SidepanelEntrypointOptions as S, TargetBrowser as T, UserConfig as U, Wxt as V, WxtDevServer as W, ResolvedConfig as X, FsCache as Y, ExtensionRunner as Z, VirtualEntrypointType as _, WxtViteConfig as a, Eslintrc as a0, ResolvedEslintrc as a1, WxtUnimportOptions as a2, WxtResolvedUnimportOptions as a3, WxtPackageManager as a4, Dependency as a5, OutputChunk as b, OutputAsset as c, BuildStepOutput as d, TargetManifestVersion as e, BaseEntrypointOptions as f, BackgroundEntrypointOptions as g, BaseContentScriptEntrypointOptions as h, IsolatedWorldContentScriptEntrypointOptions as i, OptionsEntrypointOptions as j, BaseEntrypoint as k, BackgroundEntrypoint as l, PopupEntrypoint as m, OptionsEntrypoint as n, SidepanelEntrypoint as o, Entrypoint as p, EntrypointGroup as q, OnContentScriptStopped as r, IsolatedWorldContentScriptDefinition as s, MainWorldContentScriptDefinition as t, ContentScriptDefinition as u, BackgroundDefinition as v, UnlistedScriptDefinition as w, PerBrowserOption as x, PerBrowserMap as y, ResolvedPerBrowserOptions as z };
+export type { VirtualEntrypointType as $, UserManifest as A, BuildOutput as B, ContentScriptEntrypoint as C, UserManifestFn as D, ExtensionRunnerConfig as E, ConfigEnv as F, GenericEntrypoint as G, WxtCommand as H, InlineConfig as I, WxtBuilder as J, WxtBuilderServer as K, Logger as L, MainWorldContentScriptEntrypointOptions as M, ServerInfo as N, OutputFile as O, PopupEntrypointOptions as P, HookResult as Q, ReloadContentScriptPayload as R, SidepanelEntrypointOptions as S, TargetBrowser as T, UserConfig as U, WxtHooks as V, WxtDevServer as W, Wxt as X, ResolvedConfig as Y, FsCache as Z, ExtensionRunner as _, WxtViteConfig as a, EslintGlobalsPropValue as a0, Eslintrc as a1, ResolvedEslintrc as a2, WxtUnimportOptions as a3, WxtResolvedUnimportOptions as a4, WxtPackageManager as a5, Dependency as a6, OutputChunk as b, OutputAsset as c, BuildStepOutput as d, TargetManifestVersion as e, BaseEntrypointOptions as f, BackgroundEntrypointOptions as g, BaseContentScriptEntrypointOptions as h, IsolatedWorldContentScriptEntrypointOptions as i, OptionsEntrypointOptions as j, BaseEntrypoint as k, BackgroundEntrypoint as l, PopupEntrypoint as m, OptionsEntrypoint as n, SidepanelEntrypoint as o, Entrypoint as p, EntrypointGroup as q, OnContentScriptStopped as r, IsolatedWorldContentScriptDefinition as s, MainWorldContentScriptDefinition as t, ContentScriptDefinition as u, BackgroundDefinition as v, UnlistedScriptDefinition as w, PerBrowserOption as x, PerBrowserMap as y, ResolvedPerBrowserOptions as z };