wxt 0.20.18 → 0.20.20

package/dist/types.d.mts

@@ -4,25 +4,20 @@
  * modifying the options in `tsconfig.json`.
  *
  * @example
- * wxt.hooks.hook("prepare:types", (wxt, entries) => {
- *   // Add a file, ".wxt/types/example.d.ts", that defines a global
- *   // variable called "example" in the TS project.
- *   entries.push({
- *     path: "types/example.d.ts",
- *     text: "declare const a: string;",
- *     tsReference: true,
+ *   wxt.hooks.hook('prepare:types', (wxt, entries) => {
+ *     // Add a file, ".wxt/types/example.d.ts", that defines a global
+ *     // variable called "example" in the TS project.
+ *     entries.push({
+ *       path: 'types/example.d.ts',
+ *       text: 'declare const a: string;',
+ *       tsReference: true,
+ *     });
+ *     // use module to add Triple-Slash Directive in .wxt/wxt.d.ts
+ *     // eg: /// <reference types="@types/example" />
+ *     entries.push({
+ *       module: '@types/example',
+ *     });
  *   });
- *   // use module to add Triple-Slash Directive in .wxt/wxt.d.ts
- *   // eg: /// <reference types="@types/example" />
- *   entries.push({
- *     module: '@types/example'
- *  });
- * })
- */
-
-/**
- * Specifies the module name that will be used in the `/// <reference types="..." />` directive.
- * This value will be added to the `.wxt/wxt.d.ts` file to include type definitions from the specified module.
  */import { ContentScriptContext } from "./utils/content-script-context.mjs";
 import { ManifestContentScript } from "./core/utils/types.mjs";
 import { ResolvedConfig } from "c12";
@@ -37,79 +32,87 @@ import * as vite from "vite";
 //#region src/types.d.ts
 interface InlineConfig {
   /**
-   * Your project's root directory containing the `package.json` used to fill out the
-   * `manifest.json`.
+   * Your project's root directory containing the `package.json` used to fill
+   * out the `manifest.json`.
    *
    * @default process.cwd()
    */
   root?: string;
   /**
-   * Directory containing all source code. Set to `"src"` to move all source code to a `src/`
-   * directory.
+   * Directory containing all source code. Set to `"src"` to move all source
+   * code to a `src/` directory.
    *
-   * After changing, remember to move the `public/` and `entrypoints/` directories into the new
-   * source dir.
+   * After changing, remember to move the `public/` and `entrypoints/`
+   * directories into the new source dir.
    *
    * @default config.root
    */
   srcDir?: string;
   /**
-   * Directory containing files that will be copied to the output directory as-is.
+   * Directory containing files that will be copied to the output directory
+   * as-is.
    *
-   * @default "${config.root}/public"
+   * @default '${config.root}/public'
    */
   publicDir?: string;
-  /**
-   * @default "${config.srcDir}/entrypoints"
-   */
+  /** @default '${config.srcDir}/entrypoints' */
   entrypointsDir?: string;
-  /**
-   * @default "${config.root}/modules"
-   */
+  /** @default '${config.root}/modules' */
   modulesDir?: string;
   /**
-   * A list of entrypoint names (`"popup"`, `"options"`, etc.) to build. Will speed up the build if
-   * your extension has lots of entrypoints, and you don't need to build all of them to develop a
-   * feature.
-   * If specified, this completely overrides the `include`/`exclude` option provided per-entrypoint.
+   * A list of entrypoint names (`"popup"`, `"options"`, etc.) to build. Will
+   * speed up the build if your extension has lots of entrypoints, and you don't
+   * need to build all of them to develop a feature. If specified, this
+   * completely overrides the `include`/`exclude` option provided
+   * per-entrypoint.
    */
   filterEntrypoints?: string[];
   /**
    * Output directory that stored build folders and ZIPs.
    *
-   * @default ".output"
+   * @default '.output'
    */
   outDir?: string;
   /**
-   * Template string for customizing the output directory structure.
-   * Available variables:
-   * - <span v-pre>`{{browser}}`</span>: The target browser (e.g., 'chrome', 'firefox')
-   * - <span v-pre>`{{manifestVersion}}`</span>: The manifest version (e.g., 2 or 3)
-   * - <span v-pre>`{{mode}}`</span>: The build mode (e.g., 'development', 'production')
-   * - <span v-pre>`{{modeSuffix}}`</span>: A suffix based on the mode ('-dev' for development, '' for production)
-   * - <span v-pre>`{{command}}`</span>: The WXT command being run (e.g., 'build', 'serve')
+   * Template string for customizing the output directory structure. Available
+   * variables:
+   *
+   * - <span v-pre>`{{browser}}`</span>: The target browser (e.g., 'chrome',
+   *   'firefox')
+   * - <span v-pre>`{{manifestVersion}}`</span>: The manifest version (e.g., 2 or
+   *   3)
+   * - <span v-pre>`{{mode}}`</span>: The build mode (e.g., 'development',
+   *   'production')
+   * - <span v-pre>`{{modeSuffix}}`</span>: A suffix based on the mode ('-dev' for
+   *   development, '' for production)
+   * - <span v-pre>`{{command}}`</span>: The WXT command being run (e.g., 'build',
+   *   'serve')
+   *
+   * @example
+   *   {{browser}} -mv{{manifestVersion}}
    *
-   * @example "{{browser}}-mv{{manifestVersion}}"
    * @default <span v-pre>`"{{browser}}-mv{{manifestVersion}}{{modeSuffix}}"`</span>
    */
   outDirTemplate?: string;
   /**
-   * > Only available when using the JS API. Not available in `wxt.config.ts` files
+   * > Only available when using the JS API. Not available in `wxt.config.ts`
+   * > files
    *
    * Path to `wxt.config.ts` file or `false` to disable config file discovery.
    *
-   * @default "wxt.config.ts"
+   * @default 'wxt.config.ts'
    */
   configFile?: string | false;
   /**
-   * Set to `true` to show debug logs. Overridden by the command line `--debug` option.
+   * Set to `true` to show debug logs. Overridden by the command line `--debug`
+   * option.
    *
    * @default false
    */
   debug?: boolean;
   /**
-   * Explicitly set a mode to run in. This will override the default mode for each command, and can
-   * be overridden by the command line `--mode` option.
+   * Explicitly set a mode to run in. This will override the default mode for
+   * each command, and can be overridden by the command line `--mode` option.
    */
   mode?: string;
   /**
@@ -120,29 +123,33 @@ interface InlineConfig {
    * ```ts
    * export default defineConfig({
    *   imports: {
-   *     dirs: ["some-directory"]
-   *   }
-   * })
+   *     dirs: ['some-directory'],
+   *   },
+   * });
    * ```
    */
   imports?: WxtUnimportOptions | false;
   /**
-   * Explicitly set a browser to build for. This will override the default browser for each command,
-   * and can be overridden by the command line `--browser` option.
+   * Explicitly set a browser to build for. This will override the default
+   * browser for each command, and can be overridden by the command line
+   * `--browser` option.
    *
    * @default
    * "chrome"
    */
   browser?: TargetBrowser;
   /**
-   * Target browsers to support. When set, `import.meta.env.BROWSER` will be narrowed to a string literal type containing only the specified browser names.
+   * Target browsers to support. When set, `import.meta.env.BROWSER` will be
+   * narrowed to a string literal type containing only the specified browser
+   * names.
    *
-   * @default []
+   * @default [ ]
    */
   targetBrowsers?: TargetBrowser[];
   /**
-   * Explicitly set a manifest version to target. This will override the default manifest version
-   * for each command, and can be overridden by the command line `--mv2` or `--mv3` option.
+   * Explicitly set a manifest version to target. This will override the default
+   * manifest version for each command, and can be overridden by the command
+   * line `--mv2` or `--mv3` option.
    */
   manifestVersion?: TargetManifestVersion;
   /**
@@ -153,17 +160,16 @@ interface InlineConfig {
    */
   logger?: Logger;
   /**
-   * Customize the `manifest.json` output. Can be an object, promise, or function that returns an
-   * object or promise.
+   * Customize the `manifest.json` output. Can be an object, promise, or
+   * function that returns an object or promise.
    */
   manifest?: UserManifest | Promise<UserManifest> | UserManifestFn;
   /**
-   * Configure browser startup. Options set here can be overridden in a `web-ext.config.ts` file.
+   * Configure browser startup. Options set here can be overridden in a
+   * `web-ext.config.ts` file.
    */
   webExt?: WebExtConfig;
-  /**
-   * @deprecated Use `webExt` instead. Same option, just renamed.
-   */
+  /** @deprecated Use `webExt` instead. Same option, just renamed. */
   runner?: WebExtConfig;
   zip?: {
     /**
@@ -171,14 +177,18 @@ interface InlineConfig {
      *
      * Available template variables:
      *
-     * - <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>`{{packageVersion}}`</span> - The version from the package.json
-     * - <span v-pre>`{{browser}}`</span> - The target browser from the `--browser` CLI flag
+     * - <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>`{{packageVersion}}`</span> - The version from the
+     *   package.json
+     * - <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"
+     * @default '{{name}}-{{version}}-{{browser}}.zip'
      */
     artifactTemplate?: string;
     /**
@@ -196,19 +206,24 @@ interface InlineConfig {
      *
      * Available template variables:
      *
-     * - <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>`{{packageVersion}}`</span> - The version from the package.json
-     * - <span v-pre>`{{browser}}`</span> - The target browser from the `--browser` CLI flag
+     * - <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>`{{packageVersion}}`</span> - The version from the
+     *   package.json
+     * - <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"
+     * @default '{{name}}-{{version}}-sources.zip'
      */
     sourcesTemplate?: string;
     /**
-     * Override the artifactTemplate's `{name}` template variable. Defaults to the `package.json`'s
-     * name, or if that doesn't exist, the current working directories name.
+     * Override the artifactTemplate's `{name}` template variable. Defaults to
+     * the `package.json`'s name, or if that doesn't exist, the current working
+     * directories name.
      */
     name?: string;
     /**
@@ -218,64 +233,69 @@ interface InlineConfig {
      */
     sourcesRoot?: string;
     /**
-     * [Minimatch](https://www.npmjs.com/package/minimatch) patterns of files to include when
-     * creating a ZIP of all your source code for Firefox. Patterns are relative to your
-     * `config.zip.sourcesRoot`.
+     * [Minimatch](https://www.npmjs.com/package/minimatch) patterns of files to
+     * include when creating a ZIP of all your source code for Firefox. Patterns
+     * are relative to your `config.zip.sourcesRoot`.
      *
-     * This setting overrides `excludeSources`. So if a file matches both lists, it is included in the ZIP.
+     * This setting overrides `excludeSources`. So if a file matches both lists,
+     * it is included in the ZIP.
      *
      * @example
-     * [
-     *   "coverage", // Include the coverage directory in the `sourcesRoot`
-     * ]
+     *   [
+     *     'coverage', // Include the coverage directory in the `sourcesRoot`
+     *   ];
      */
     includeSources?: string[];
     /**
-     * [Minimatch](https://www.npmjs.com/package/minimatch) patterns of files to exclude when
-     * creating a ZIP of all your source code for Firefox. Patterns are relative to your
-     * `config.zip.sourcesRoot`.
+     * [Minimatch](https://www.npmjs.com/package/minimatch) patterns of files to
+     * exclude when creating a ZIP of all your source code for Firefox. Patterns
+     * are relative to your `config.zip.sourcesRoot`.
      *
      * Hidden files, node_modules, and tests are ignored by default.
      *
      * @example
-     * [
-     *   "coverage", // Ignore the coverage directory in the `sourcesRoot`
-     * ]
+     *   [
+     *     'coverage', // Ignore the coverage directory in the `sourcesRoot`
+     *   ];
      */
     excludeSources?: string[];
     /**
-     * [Minimatch](https://www.npmjs.com/package/minimatch) patterns of files to exclude when
-     * zipping the extension.
+     * [Minimatch](https://www.npmjs.com/package/minimatch) patterns of files to
+     * exclude when zipping the extension.
      *
      * @example
-     * [
-     *   "**\/*.map", // Exclude all sourcemaps
-     * ]
+     *   [
+     *     '**\/*.map', // Exclude all sourcemaps
+     *   ];
      */
     exclude?: string[];
     /**
-     * The Firefox review process requires the extension be buildable from source to make reviewing
-     * easier. This field allows you to use private packages without exposing your auth tokens.
+     * The Firefox review process requires the extension be buildable from
+     * source to make reviewing easier. This field allows you to use private
+     * packages without exposing your auth tokens.
      *
-     * Just list the name of all the packages you want to download and include in the sources zip.
-     * Usually, these will be private packages behind auth tokens, but they don't have to be.
+     * Just list the name of all the packages you want to download and include
+     * in the sources zip. Usually, these will be private packages behind auth
+     * tokens, but they don't have to be.
      *
-     * All packages listed here will be downloaded to in `.wxt/local_modules/` and an `overrides` or
-     * `resolutions` field (depending on your package manager) will be added to the `package.json`,
-     * pointing to the downloaded packages.
+     * All packages listed here will be downloaded to in `.wxt/local_modules/`
+     * and an `overrides` or `resolutions` field (depending on your package
+     * manager) will be added to the `package.json`, pointing to the downloaded
+     * packages.
      *
-     * > ***DO NOT include versions or version filters.*** Just the package name. If multiple
-     * > versions of a package are present in the project, all versions will be downloaded and
-     * > referenced in the package.json correctly.
-     *
-     * @default []
+     * > _**DO NOT include versions or version filters.**_ Just the package name.
+     * > If multiple versions of a package are present in the project, all
+     * > versions will be downloaded and referenced in the package.json
+     * > correctly.
      *
      * @example
-     * // Correct:
-     * ["@scope/package-name", "package-name"]
+     *   // Correct:
+     *   ['@scope/package-name', 'package-name'][
+     *     // Incorrect, don't include versions!!!
+     *     ('@scope/package-name@1.1.3', 'package-name@^2')
+     *   ];
      *
-     * // Incorrect, don't include versions!!!
-     * ["@scope/package-name@1.1.3", "package-name@^2"]
+     * @default [ ]
      */
     downloadPackages?: string[];
     /**
@@ -289,42 +309,44 @@ interface InlineConfig {
   };
   analysis?: {
     /**
-     * Explicitly include bundle analysis when running `wxt build`. This can be overridden by the
-     * command line `--analyze` option.
+     * Explicitly include bundle analysis when running `wxt build`. This can be
+     * overridden by the command line `--analyze` option.
      *
      * @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.
+     * 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
+     * When running `wxt build --analyze` or setting `analysis.enabled` to true,
+     * customize how the bundle will be visualized. See
      * [`rollup-plugin-visualizer`](https://github.com/btd/rollup-plugin-visualizer#how-to-use-generated-files)
      * for more details.
      *
-     * @default "treemap"
+     * @default 'treemap'
      */
     template?: PluginVisualizerOptions['template'];
     /**
      * Name of the output HTML file. Relative to the project's root directory.
      *
-     * Changing the filename of the outputFile also effects the names of the artifacts generated
-     * when setting `keepArtifacts` to true:
+     * Changing the filename of the outputFile also effects the names of the
+     * artifacts generated when setting `keepArtifacts` to true:
+     *
      * - "stats.html" => "stats-*.json"
      * - "stats/bundle.html" => "bundle-*.json"
      * - ".analysis/index.html" => "index-*.json"
      *
-     * @default "stats.html"
+     * @default 'stats.html'
      */
     outputFile?: string;
     /**
-     * By default, the `stats-*.json` artifacts generated during bundle analysis are deleted. Set to
-     * `true` to keep them.
+     * By default, the `stats-*.json` artifacts generated during bundle analysis
+     * are deleted. Set to `true` to keep them.
      *
      * One stats file is output per build step.
      *
@@ -333,66 +355,64 @@ interface InlineConfig {
     keepArtifacts?: boolean;
   };
   /**
-   * Add additional paths to the `.wxt/tsconfig.json`. Use this instead of overwriting the `paths`
-   * in the root `tsconfig.json` if you want to add new paths.
+   * Add additional paths to the `.wxt/tsconfig.json`. Use this instead of
+   * overwriting the `paths` in the root `tsconfig.json` if you want to add new
+   * paths.
    *
-   * The key is the import alias and the value is either a relative path to the root directory or an absolute path.
+   * The key is the import alias and the value is either a relative path to the
+   * root directory or an absolute path.
    *
    * @example
-   * {
-   *   "testing": "src/utils/testing.ts"
-   * }
+   *   { "testing": "src/utils/testing.ts" }
    */
   alias?: Record<string, string>;
-  /**
-   * Experimental settings - use with caution.
-   */
+  /** Experimental settings - use with caution. */
   experimental?: {};
-  /**
-   * Config effecting dev mode only.
-   */
+  /** Config effecting dev mode only. */
   dev?: {
     server?: {
       /**
        * Host to bind the dev server to.
        *
-       * @default "localhost"
+       * @default 'localhost'
        */
       host?: string;
       /**
-       * Port to run the dev server on. Defaults to the first open port from 3000 to 3010.
+       * Port to run the dev server on. Defaults to the first open port from
+       * 3000 to 3010.
        */
       port?: number;
       /**
-       * Origin to use to connect from the extension ui runtime to the dev server.
+       * Origin to use to connect from the extension ui runtime to the dev
+       * server.
        *
-       * @default "http://localhost:3000"
+       * @default 'http://localhost:3000'
        */
       origin?: string;
       /**
        * Hostname to run the dev server on.
        *
-       * @deprecated use `host` to specify the interface to bind to, or use `origin` to specify the dev server hostname.
+       * @deprecated Use `host` to specify the interface to bind to, or use
+       *   `origin` to specify the dev server hostname.
        */
       hostname?: string;
     };
     /**
-     * Controls whether a custom keyboard shortcut command, `Alt+R`, is added during dev mode to
-     * quickly reload the extension.
+     * Controls whether a custom keyboard shortcut command, `Alt+R`, is added
+     * during dev mode to quickly reload the extension.
      *
      * If false, the shortcut is not added during development.
      *
      * If set to a custom string, you can override the key combo used. See
-     * [Chrome's command docs](https://developer.chrome.com/docs/extensions/reference/api/commands)
+     * [Chrome's command
+     * docs](https://developer.chrome.com/docs/extensions/reference/api/commands)
      * for available options.
      *
-     * @default "Alt+R"
+     * @default 'Alt+R'
      */
     reloadCommand?: string | false;
   };
-  /**
-   * Project hooks for running logic during the build process.
-   */
+  /** Project hooks for running logic during the build process. */
   hooks?: NestedHooks<WxtHooks>;
   /**
    * List of WXT module names to include. Can be the full package name
@@ -404,13 +424,14 @@ interface InlineConfig {
 interface InlineConfig {
   /**
    * Return custom Vite options from a function. See
-   * <https://vitejs.dev/config/shared-options.html>.
+   * [https://vitejs.dev/config/shared-options.html](https://vitejs.dev/config/shared-options.html).
    *
-   * [`root`](#root), [`configFile`](#configfile), and [`mode`](#mode) should be set in WXT's config
-   * instead of Vite's.
+   * [`root`](#root), [`configFile`](#configfile), and [`mode`](#mode) should be
+   * set in WXT's config instead of Vite's.
    *
-   * This is a function because any vite plugins added need to be recreated for each individual
-   * build step, incase they have internal state causing them to fail when reused.
+   * This is a function because any vite plugins added need to be recreated for
+   * each individual build step, incase they have internal state causing them to
+   * fail when reused.
    */
   vite?: (env: ConfigEnv) => WxtViteConfig | Promise<WxtViteConfig>;
 }
@@ -423,15 +444,17 @@ interface WxtHooks {
    * Called when WXT has created Vite's config for a build step. Useful if you
    * want to add plugins or update the vite config per entrypoint group.
    *
-   * @param entrypoints The list of entrypoints being built with the provided config.
+   * @param entrypoints The list of entrypoints being built with the provided
+   *   config.
    * @param viteConfig The config that will be used for the dev server.
    */
   'vite:build:extendConfig': (entrypoints: readonly Entrypoint[], viteConfig: vite.InlineConfig) => HookResult;
   /**
-   * Called when WXT has created Vite's config for the dev server. Useful if
-   * you want to add plugins or update the vite config per entrypoint group.
+   * Called when WXT has created Vite's config for the dev server. Useful if you
+   * want to add plugins or update the vite config per entrypoint group.
    *
-   * @param viteConfig The config that will be used to build the entrypoints. Can be updated by reference.
+   * @param viteConfig The config that will be used to build the entrypoints.
+   *   Can be updated by reference.
    */
   'vite:devServer:extendConfig': (config: vite.InlineConfig) => HookResult;
 }
@@ -449,9 +472,7 @@ interface OutputChunk {
    * Ex: "content-scripts/overlay.js"
    */
   fileName: string;
-  /**
-   * Absolute, normalized paths to all dependencies this chunk relies on.
-   */
+  /** Absolute, normalized paths to all dependencies this chunk relies on. */
   moduleIds: string[];
 }
 interface OutputAsset {
@@ -468,40 +489,32 @@ interface BuildStepOutput {
   chunks: OutputFile[];
 }
 interface WxtDevServer extends Omit<WxtBuilderServer, 'listen' | 'close'>, ServerInfo {
-  /**
-   * Stores the current build output of the server.
-   */
+  /** Stores the current build output of the server. */
   currentOutput: BuildOutput | undefined;
-  /**
-   * Start the server.
-   */
+  /** Start the server. */
   start(): Promise<void>;
-  /**
-   * Stop the server.
-   */
+  /** Stop the server. */
   stop(): Promise<void>;
   /**
-   * Close the browser, stop the server, rebuild the entire extension, and start the server again.
+   * Close the browser, stop the server, rebuild the entire extension, and start
+   * the server again.
    */
   restart(): Promise<void>;
-  /**
-   * Transform the HTML for dev mode.
-   */
+  /** Transform the HTML for dev mode. */
   transformHtml(url: string, html: string, originalUrl?: string | undefined): Promise<string>;
-  /**
-   * Tell the extension to reload by running `browser.runtime.reload`.
-   */
+  /** Tell the extension to reload by running `browser.runtime.reload`. */
   reloadExtension: () => void;
   /**
    * Tell an extension page to reload.
    *
    * The path is the bundle path, not the input paths, so if the input paths is
-   * "src/options/index.html", you would pass "options.html" because that's where it is written to
-   * in the dist directory, and where it's available at in the actual extension.
+   * "src/options/index.html", you would pass "options.html" because that's
+   * where it is written to in the dist directory, and where it's available at
+   * in the actual extension.
    *
    * @example
-   * server.reloadPage("popup.html")
-   * server.reloadPage("sandbox.html")
+   *   server.reloadPage('popup.html');
+   *   server.reloadPage('sandbox.html');
    */
   reloadPage: (path: string) => void;
   /**
@@ -510,9 +523,7 @@ interface WxtDevServer extends Omit<WxtBuilderServer, 'listen' | 'close'>, Serve
    * @param payload Information about the content script to reload.
    */
   reloadContentScript: (payload: ReloadContentScriptPayload) => void;
-  /**
-   * Grab the latest runner config and restart the browser.
-   */
+  /** Grab the latest runner config and restart the browser. */
   restartBrowser: () => void;
 }
 interface ReloadContentScriptPayload {
@@ -534,15 +545,16 @@ interface Logger {
 }
 interface BaseEntrypointOptions {
   /**
-   * List of target browsers to include this entrypoint in. Defaults to being included in all
-   * builds. Cannot be used with `exclude`. You must choose one of the two options.
+   * List of target browsers to include this entrypoint in. Defaults to being
+   * included in all builds. Cannot be used with `exclude`. You must choose one
+   * of the two options.
    *
    * @default undefined
    */
   include?: TargetBrowser[];
   /**
-   * List of target browsers to exclude this entrypoint from. Cannot be used with `include`. You
-   * must choose one of the two options.
+   * List of target browsers to exclude this entrypoint from. Cannot be used
+   * with `include`. You must choose one of the two options.
    *
    * @default undefined
    */
@@ -551,10 +563,11 @@ interface BaseEntrypointOptions {
 interface BackgroundEntrypointOptions extends BaseEntrypointOptions {
   persistent?: PerBrowserOption<boolean>;
   /**
-   * Set to `"module"` to output the background entrypoint as ESM. ESM outputs can share chunks and
-   * reduce the overall size of the bundled extension.
+   * Set to `"module"` to output the background entrypoint as ESM. ESM outputs
+   * can share chunks and reduce the overall size of the bundled extension.
    *
-   * When `undefined`, the background is bundled individually into an IIFE format.
+   * When `undefined`, the background is bundled individually into an IIFE
+   * format.
    *
    * @default undefined
    */
@@ -564,17 +577,22 @@ interface BaseScriptEntrypointOptions extends BaseEntrypointOptions {
   /**
    * The variable name for the IIFE in the output bundle.
    *
-   * This option is relevant for scripts inserted into the page context where the default IIFE
-   * variable name may conflict with an existing variable on the target page. This applies to content
-   * scripts with world=MAIN, and others, such as unlisted scripts, that could be dynamically injected
-   * into the page with a <script> tag.
+   * This option is relevant for scripts inserted into the page context where
+   * the default IIFE variable name may conflict with an existing variable on
+   * the target page. This applies to content scripts with world=MAIN, and
+   * others, such as unlisted scripts, that could be dynamically injected into
+   * the page with a <script> tag.
    *
    * Available options:
-   * - `true`: automatically generate a name for the IIFE based on the entrypoint name
-   * - `false`: Output the IIFE without a variable name, making it anonymous. This is the safest option
-   *  to avoid conflicts with existing variables on the page. This will become the default in a future version of WXT.
+   *
+   * - `true`: automatically generate a name for the IIFE based on the entrypoint
+   *   name
+   * - `false`: Output the IIFE without a variable name, making it anonymous. This
+   *   is the safest option to avoid conflicts with existing variables on the
+   *   page. This will become the default in a future version of WXT.
    * - `string`: Use the provided string as the global variable name.
-   * - `function`: A function that receives the entrypoint and returns a string to use as the variable name.
+   * - `function`: A function that receives the entrypoint and returns a string to
+   *   use as the variable name.
    *
    * @default true
    */
@@ -584,81 +602,96 @@ interface BaseContentScriptEntrypointOptions extends BaseScriptEntrypointOptions
   matches?: PerBrowserOption<NonNullable<ManifestContentScript['matches']>>;
   /**
    * See https://developer.chrome.com/docs/extensions/mv3/content_scripts/
-   * @default "documentIdle"
+   *
+   * @default 'documentIdle'
    */
   runAt?: PerBrowserOption<Browser.scripting.RegisteredContentScript['runAt']>;
   /**
    * See https://developer.chrome.com/docs/extensions/mv3/content_scripts/
+   *
    * @default false
    */
   matchAboutBlank?: PerBrowserOption<ManifestContentScript['match_about_blank']>;
   /**
    * See https://developer.chrome.com/docs/extensions/mv3/content_scripts/
-   * @default []
+   *
+   * @default [ ]
    */
   excludeMatches?: PerBrowserOption<ManifestContentScript['exclude_matches']>;
   /**
    * See https://developer.chrome.com/docs/extensions/mv3/content_scripts/
-   * @default []
+   *
+   * @default [ ]
    */
   includeGlobs?: PerBrowserOption<ManifestContentScript['include_globs']>;
   /**
    * See https://developer.chrome.com/docs/extensions/mv3/content_scripts/
-   * @default []
+   *
+   * @default [ ]
    */
   excludeGlobs?: PerBrowserOption<ManifestContentScript['exclude_globs']>;
   /**
    * See https://developer.chrome.com/docs/extensions/mv3/content_scripts/
+   *
    * @default false
    */
   allFrames?: PerBrowserOption<ManifestContentScript['all_frames']>;
   /**
    * See https://developer.chrome.com/docs/extensions/mv3/content_scripts/
+   *
    * @default false
    */
   matchOriginAsFallback?: PerBrowserOption<boolean>;
   /**
-   * Customize how imported/generated styles are injected with the content script. Regardless of the
-   * mode selected, CSS will always be built and included in the output directory.
+   * Customize how imported/generated styles are injected with the content
+   * script. Regardless of the mode selected, CSS will always be built and
+   * included in the output directory.
    *
-   * - `"manifest"` - Include the CSS in the manifest, under the content script's `css` array.
-   * - `"manual"` - Exclude the CSS from the manifest. You are responsible for manually loading it
-   *   onto the page. Use `browser.runtime.getURL("content-scripts/<name>.css")` to get the file's
+   * - `"manifest"` - Include the CSS in the manifest, under the content script's
+   *   `css` array.
+   * - `"manual"` - Exclude the CSS from the manifest. You are responsible for
+   *   manually loading it onto the page. Use
+   *   `browser.runtime.getURL("content-scripts/<name>.css")` to get the file's
    *   URL
-   * - `"ui"` - Exclude the CSS from the manifest. CSS will be automatically added to your UI when
-   *   calling `createShadowRootUi`
+   * - `"ui"` - Exclude the CSS from the manifest. CSS will be automatically added
+   *   to your UI when calling `createShadowRootUi`
    *
-   * @default "manifest"
+   * @default 'manifest'
    */
   cssInjectionMode?: PerBrowserOption<'manifest' | 'manual' | 'ui'>;
   /**
    * Specify how the content script is registered.
    *
-   * - `"manifest"`: The content script will be added to the `content_scripts` entry in the
-   *   manifest. This is the normal and most well known way of registering a content script.
-   * - `"runtime"`: The content script's `matches` is added to `host_permissions` and you are
-   *   responsible for using the scripting API to register/execute the content script
-   *   dynamically at runtime.
+   * - `"manifest"`: The content script will be added to the `content_scripts`
+   *   entry in the manifest. This is the normal and most well known way of
+   *   registering a content script.
+   * - `"runtime"`: The content script's `matches` is added to `host_permissions`
+   *   and you are responsible for using the scripting API to register/execute
+   *   the content script dynamically at runtime.
    *
-   * @default "manifest"
+   * @default 'manifest'
    */
   registration?: PerBrowserOption<'manifest' | 'runtime'>;
 }
 interface MainWorldContentScriptEntrypointOptions extends BaseContentScriptEntrypointOptions {
   /**
-   * See https://developer.chrome.com/docs/extensions/develop/concepts/content-scripts#isolated_world
+   * See
+   * https://developer.chrome.com/docs/extensions/develop/concepts/content-scripts#isolated_world
    */
   world: 'MAIN';
 }
 interface IsolatedWorldContentScriptEntrypointOptions extends BaseContentScriptEntrypointOptions {
   /**
-   * See https://developer.chrome.com/docs/extensions/develop/concepts/content-scripts#isolated_world
-   * @default "ISOLATED"
+   * See
+   * https://developer.chrome.com/docs/extensions/develop/concepts/content-scripts#isolated_world
+   *
+   * @default 'ISOLATED'
    */
   world?: 'ISOLATED';
 }
 /**
  * Firefox theme icon definition for light/dark mode support.
+ *
  * @see https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/browser_action#theme_icons
  */
 interface ThemeIcon {
@@ -670,20 +703,21 @@ interface ThemeIcon {
   size: number;
 }
 interface PopupEntrypointOptions extends BaseEntrypointOptions {
-  /**
-   * Defaults to "browser_action" to be equivalent to MV3's "action" key
-   */
+  /** Defaults to "browser_action" to be equivalent to MV3's "action" key */
   mv2Key?: PerBrowserOption<'browser_action' | 'page_action'>;
   defaultIcon?: Record<string, string>;
   defaultTitle?: PerBrowserOption<string>;
   browserStyle?: PerBrowserOption<boolean>;
   /**
-   * Firefox only. Defines the part of the browser in which the button is initially placed.
+   * Firefox only. Defines the part of the browser in which the button is
+   * initially placed.
+   *
    * @see https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/action#default_area
    */
   defaultArea?: PerBrowserOption<'navbar' | 'menupanel' | 'tabstrip' | 'personaltoolbar'>;
   /**
    * Firefox only. Icons for light and dark themes.
+   *
    * @see https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/action#theme_icons
    */
   themeIcons?: ThemeIcon[];
@@ -696,12 +730,15 @@ interface OptionsEntrypointOptions extends BaseEntrypointOptions {
 }
 interface SidepanelEntrypointOptions extends BaseEntrypointOptions {
   /**
-   * Firefox only. See https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/sidebar_action#syntax
+   * Firefox only. See
+   * https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/sidebar_action#syntax
+   *
    * @default false
    */
   openAtInstall?: PerBrowserOption<boolean>;
   /**
-   * @deprecated See https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/sidebar_action#syntax
+   * @deprecated See
+   *   https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/sidebar_action#syntax
    */
   browserStyle?: PerBrowserOption<boolean>;
   defaultIcon?: string | Record<string, string>;
@@ -709,29 +746,29 @@ interface SidepanelEntrypointOptions extends BaseEntrypointOptions {
 }
 interface BaseEntrypoint {
   /**
-   * The entrypoint's name. This is the filename or dirname without the type suffix.
+   * The entrypoint's name. This is the filename or dirname without the type
+   * suffix.
    *
    * Examples:
-   * - `popup.html` &rarr; `popup`
-   * - `options/index.html` &rarr; `options`
-   * - `named.sandbox.html` &rarr; `named`
-   * - `named.sandbox/index.html` &rarr; `named`
-   * - `sandbox.html` &rarr; `sandbox`
-   * - `sandbox/index.html` &rarr; `sandbox`
-   * - `overlay.content.ts` &rarr; `overlay`
-   * - `overlay.content/index.ts` &rarr; `overlay`
+   *
+   * - `popup.html` → `popup`
+   * - `options/index.html` → `options`
+   * - `named.sandbox.html` → `named`
+   * - `named.sandbox/index.html` → `named`
+   * - `sandbox.html` → `sandbox`
+   * - `sandbox/index.html` → `sandbox`
+   * - `overlay.content.ts` → `overlay`
+   * - `overlay.content/index.ts` → `overlay`
    *
    * The name is used when generating an output file:
    * `<entrypoint.outputDir>/<entrypoint.name>.<ext>`
    */
   name: string;
-  /**
-   * Absolute path to the entrypoint's input file.
-   */
+  /** Absolute path to the entrypoint's input file. */
   inputPath: string;
   /**
-   * Absolute path to the entrypoint's output directory. Can be `wxt.config.outDir` or a
-   * subdirectory of it.
+   * Absolute path to the entrypoint's output directory. Can be
+   * `wxt.config.outDir` or a subdirectory of it.
    */
   outputDir: string;
   /**
@@ -739,7 +776,8 @@ interface BaseEntrypoint {
    * based on the `filterEntrypoints` config or the entrypoint's
    * `include`/`exclude` options defined inside the file.
    *
-   * See https://wxt.dev/guide/essentials/target-different-browsers.html#filtering-entrypoints
+   * See
+   * https://wxt.dev/guide/essentials/target-different-browsers.html#filtering-entrypoints
    */
   skipped?: boolean;
 }
@@ -803,7 +841,8 @@ interface MainWorldContentScriptDefinition extends MainWorldContentScriptEntrypo
 type ContentScriptDefinition = IsolatedWorldContentScriptDefinition | MainWorldContentScriptDefinition;
 interface BackgroundDefinition extends BackgroundEntrypointOptions {
   /**
-   * Main function executed when the background script is started. Cannot be async.
+   * Main function executed when the background script is started. Cannot be
+   * async.
    */
   main(): void;
 }
@@ -818,22 +857,24 @@ interface UnlistedScriptDefinition extends BaseScriptEntrypointOptions {
   main(): any | Promise<any>;
 }
 /**
- * Either a single value or a map of different browsers to the value for that browser.
+ * Either a single value or a map of different browsers to the value for that
+ * browser.
  */
 type PerBrowserOption<T> = T | PerBrowserMap<T>;
 type PerBrowserMap<T> = {
   [browser: TargetBrowser]: T;
 };
 /**
- * Convert `{ key: PerBrowserOption<T> }` to just `{ key: T }`, stripping away the
- * `PerBrowserOption` type for all fields inside the object.
+ * Convert `{ key: PerBrowserOption<T> }` to just `{ key: T }`, stripping away
+ * the `PerBrowserOption` type for all fields inside the object.
  *
- * A optional second list of keys can be passed if a field isn't compatible with `PerBrowserOption`, like `defaultIcon`.
+ * A optional second list of keys can be passed if a field isn't compatible with
+ * `PerBrowserOption`, like `defaultIcon`.
  */
 type ResolvedPerBrowserOptions<T, TOmitted extends keyof T = never> = { [key in keyof Omit<T, TOmitted>]: T[key] extends PerBrowserOption<infer U> ? U : T[key] } & { [key in TOmitted]: T[key] };
 /**
- * Manifest customization available in the `wxt.config.ts` file. You cannot configure entrypoints
- * here, they are configured inline.
+ * Manifest customization available in the `wxt.config.ts` file. You cannot
+ * configure entrypoints here, they are configured inline.
  */
 type UserManifest = { [key in keyof Browser.runtime.ManifestV3 as key extends 'action' | 'background' | 'chrome_url_overrides' | 'devtools_page' | 'manifest_version' | 'options_page' | 'options_ui' | 'permissions' | 'sandbox' | 'web_accessible_resources' ? never : key]?: Browser.runtime.ManifestV3[key] } & {
   action?: Browser.runtime.ManifestV3['action'] & {
@@ -867,73 +908,70 @@ type UserManifest = { [key in keyof Browser.runtime.ManifestV3 as key extends 'a
 type UserManifestFn = (env: ConfigEnv) => UserManifest | Promise<UserManifest>;
 interface ConfigEnv {
   /**
-   * The build mode passed into the CLI. By default, `wxt` uses `"development"` and `wxt build|zip`
-   * uses `"production"`.
+   * The build mode passed into the CLI. By default, `wxt` uses `"development"`
+   * and `wxt build|zip` uses `"production"`.
    */
   mode: string;
   /**
-   * The command used to run WXT. `"serve"` during development and `"build"` for any other command.
+   * The command used to run WXT. `"serve"` during development and `"build"` for
+   * any other command.
    */
   command: WxtCommand;
   /**
-   * Browser passed in from the CLI via the `-b` or `--browser` flag. Defaults to `"chrome"` when not passed.
+   * Browser passed in from the CLI via the `-b` or `--browser` flag. Defaults
+   * to `"chrome"` when not passed.
    */
   browser: TargetBrowser;
   /**
-   * Manifest version passed in from the CLI via the `--mv2` or `--mv3` flags. When not passed, it depends on the target browser. See
-   * [the guide](https://wxt.dev/guide/key-concepts/multiple-browsers.html#target-manifest-version) for more
-   * details.
+   * Manifest version passed in from the CLI via the `--mv2` or `--mv3` flags.
+   * When not passed, it depends on the target browser. See [the
+   * guide](https://wxt.dev/guide/key-concepts/multiple-browsers.html#target-manifest-version)
+   * for more details.
    */
   manifestVersion: 2 | 3;
 }
 type WxtCommand = 'build' | 'serve';
-/**
- * @deprecated Use `WebExtConfig` instead.
- */
+/** @deprecated Use `WebExtConfig` instead. */
 type ExtensionRunnerConfig = WebExtConfig;
 /**
- * Options for how [`web-ext`](https://github.com/mozilla/web-ext) starts the browser.
+ * Options for how [`web-ext`](https://github.com/mozilla/web-ext) starts the
+ * browser.
  */
 interface WebExtConfig {
   /**
-   * Whether or not to open the browser with the extension installed in dev mode.
+   * Whether or not to open the browser with the extension installed in dev
+   * mode.
    *
    * @default false
    */
   disabled?: boolean;
-  /**
-   * @see https://extensionworkshop.com/documentation/develop/web-ext-command-reference/#browser-console
-   */
+  /** @see https://extensionworkshop.com/documentation/develop/web-ext-command-reference/#browser-console */
   openConsole?: boolean;
-  /**
-   * @see https://extensionworkshop.com/documentation/develop/web-ext-command-reference/#devtools
-   */
+  /** @see https://extensionworkshop.com/documentation/develop/web-ext-command-reference/#devtools */
   openDevtools?: boolean;
   /**
-   * List of browser names and the binary that should be used to open the browser.
+   * List of browser names and the binary that should be used to open the
+   * browser.
    *
    * @see https://extensionworkshop.com/documentation/develop/web-ext-command-reference/#chromium-binary
    * @see https://extensionworkshop.com/documentation/develop/web-ext-command-reference/#firefox
    */
   binaries?: Record<string, string>;
-  /**
-   * @see https://extensionworkshop.com/documentation/develop/web-ext-command-reference/#firefox-profile
-   */
+  /** @see https://extensionworkshop.com/documentation/develop/web-ext-command-reference/#firefox-profile */
   firefoxProfile?: string;
-  /**
-   * @see https://extensionworkshop.com/documentation/develop/web-ext-command-reference/#chromium-profile
-   */
+  /** @see https://extensionworkshop.com/documentation/develop/web-ext-command-reference/#chromium-profile */
   chromiumProfile?: string;
   /**
-   * An map of chrome preferences from https://chromium.googlesource.com/chromium/src/+/main/chrome/common/pref_names.h
+   * An map of chrome preferences from
+   * https://chromium.googlesource.com/chromium/src/+/main/chrome/common/pref_names.h
    *
    * @example
-   * // change your downloads directory
-   * {
+   *   // change your downloads directory
+   *   {
    *   download: {
-   *     default_directory: "/my/custom/dir",
+   *   default_directory: "/my/custom/dir",
    *   },
-   * }
+   *   }
    *
    * @default
    * // Enable dev mode and allow content script sourcemaps
@@ -952,105 +990,70 @@ interface WebExtConfig {
    */
   chromiumPref?: Record<string, any>;
   /**
-   * By default, chrome opens a random port for debugging. Set this value to use a specific port.
+   * By default, chrome opens a random port for debugging. Set this value to use
+   * a specific port.
    */
   chromiumPort?: number;
-  /**
-   * @see https://extensionworkshop.com/documentation/develop/web-ext-command-reference/#pref
-   */
+  /** @see https://extensionworkshop.com/documentation/develop/web-ext-command-reference/#pref */
   firefoxPref?: Record<string, boolean | number | string>;
-  /**
-   * @see https://extensionworkshop.com/documentation/develop/web-ext-command-reference/#args
-   */
+  /** @see https://extensionworkshop.com/documentation/develop/web-ext-command-reference/#args */
   firefoxArgs?: string[];
-  /**
-   * @see https://extensionworkshop.com/documentation/develop/web-ext-command-reference/#args
-   */
+  /** @see https://extensionworkshop.com/documentation/develop/web-ext-command-reference/#args */
   chromiumArgs?: string[];
-  /**
-   * @see https://extensionworkshop.com/documentation/develop/web-ext-command-reference/#start-url
-   */
+  /** @see https://extensionworkshop.com/documentation/develop/web-ext-command-reference/#start-url */
   startUrls?: string[];
-  /**
-   * @see https://extensionworkshop.com/documentation/develop/web-ext-command-reference/#keep-profile-changes
-   */
+  /** @see https://extensionworkshop.com/documentation/develop/web-ext-command-reference/#keep-profile-changes */
   keepProfileChanges?: boolean;
 }
 interface WxtBuilder {
-  /**
-   * Name of tool used to build. Ex: "Vite" or "Webpack".
-   */
+  /** Name of tool used to build. Ex: "Vite" or "Webpack". */
   name: string;
-  /**
-   * Version of tool used to build. Ex: "5.0.2"
-   */
+  /** Version of tool used to build. Ex: "5.0.2" */
   version: string;
   /**
-   * Import a JS entrypoint file, returning the default export containing the options.
+   * Import a JS entrypoint file, returning the default export containing the
+   * options.
    */
   importEntrypoint<T>(path: string): Promise<T>;
-  /**
-   * Import a list of JS entrypoint files, returning their options.
-   */
+  /** Import a list of JS entrypoint files, returning their options. */
   importEntrypoints(paths: string[]): Promise<Record<string, unknown>[]>;
   /**
-   * Build a single entrypoint group. This is effectively one of the multiple "steps" during the
-   * build process.
+   * Build a single entrypoint group. This is effectively one of the multiple
+   * "steps" during the build process.
    */
   build(group: EntrypointGroup): Promise<BuildStepOutput>;
-  /**
-   * Start a dev server at the provided port.
-   */
+  /** Start a dev server at the provided port. */
   createServer(info: ServerInfo): Promise<WxtBuilderServer>;
 }
 interface WxtBuilderServer {
-  /**
-   * Start the server.
-   */
+  /** Start the server. */
   listen(): Promise<void>;
-  /**
-   * Stop the server.
-   */
+  /** Stop the server. */
   close(): Promise<void>;
-  /**
-   * Transform the HTML for dev mode.
-   */
+  /** Transform the HTML for dev mode. */
   transformHtml(url: string, html: string, originalUrl?: string | undefined): Promise<string>;
-  /**
-   * The web socket server used to communicate with the extension.
-   */
+  /** The web socket server used to communicate with the extension. */
   ws: {
     /**
      * Send a message via the server's websocket, with an optional payload.
      *
      * @example
-     * ws.send("wxt:reload-extension");
-     * ws.send("wxt:reload-content-script", { ... });
-     */
-    send(message: string, payload?: any): void;
-    /**
-     * Listen for messages over the server's websocket.
+     *   ws.send("wxt:reload-extension");
+     *   ws.send("wxt:reload-content-script", { ... });
      */
+    send(message: string, payload?: any): void; /** Listen for messages over the server's websocket. */
     on(message: string, cb: (payload: any) => void): void;
   };
-  /**
-   * Chokidar file watcher instance.
-   */
+  /** Chokidar file watcher instance. */
   watcher: vite.ViteDevServer['watcher'];
   on?(event: string, callback: () => void): void;
 }
 interface ServerInfo {
-  /**
-   * Ex: `"localhost"`
-   */
+  /** Ex: `"localhost"` */
   host: string;
-  /**
-   * Ex: `3000`
-   */
+  /** Ex: `3000` */
   port: number;
-  /**
-   * Ex: `"http://localhost:3000"`
-   */
+  /** Ex: `"http://localhost:3000"` */
   origin: string;
 }
 type HookResult = Promise<void> | void;
@@ -1058,27 +1061,31 @@ interface WxtHooks {
   /**
    * Called after WXT modules are initialized, when the WXT instance is ready to
    * be used. `wxt.server` isn't available yet, use `server:created` to get it.
+   *
    * @param wxt The configured WXT object
    */
   ready: (wxt: Wxt) => HookResult;
   /**
-   * Called whenever config is loaded or reloaded. Use this hook to modify config by modifying `wxt.config`.
+   * Called whenever config is loaded or reloaded. Use this hook to modify
+   * config by modifying `wxt.config`.
+   *
    * @param wxt The configured WXT object
    */
   'config:resolved': (wxt: Wxt) => HookResult;
   'prepare:types': (wxt: Wxt, entries: WxtDirEntry[]) => HookResult;
   /**
    * Called before generating the list of public paths inside
-   * `.wxt/types/paths.d.ts`. Use this hook to add additional paths (relative
-   * to output directory) WXT doesn't add automatically.
-   *
-   * @param wxt The configured WXT object
-   * @param paths This list of paths TypeScript allows `browser.runtime.getURL` to be called with.
+   * `.wxt/types/paths.d.ts`. Use this hook to add additional paths (relative to
+   * output directory) WXT doesn't add automatically.
    *
    * @example
-   * wxt.hooks.hook('prepare:publicPaths', (wxt, paths) => {
-   *   paths.push('/icons/128.png');
-   * })
+   *   wxt.hooks.hook('prepare:publicPaths', (wxt, paths) => {
+   *     paths.push('/icons/128.png');
+   *   });
+   *
+   * @param wxt The configured WXT object
+   * @param paths This list of paths TypeScript allows `browser.runtime.getURL`
+   *   to be called with.
    */
   'prepare:publicPaths': (wxt: Wxt, paths: string[]) => HookResult;
   /**
@@ -1096,22 +1103,25 @@ interface WxtHooks {
    */
   'build:done': (wxt: Wxt, output: Readonly<BuildOutput>) => HookResult;
   /**
-   * Called once the manifest has been generated. Used to transform the manifest by reference before
-   * it is written to the output directory.
+   * Called once the manifest has been generated. Used to transform the manifest
+   * by reference before it is written to the output directory.
+   *
    * @param wxt The configured WXT object
    * @param manifest The manifest that was generated
    */
   'build:manifestGenerated': (wxt: Wxt, manifest: Browser.runtime.Manifest) => HookResult;
   /**
    * Called once the names and paths of all entrypoints have been resolved.
+   *
    * @param wxt The configured WXT object
-   * @param infos List of entrypoints found in the project's `entrypoints` directory
+   * @param infos List of entrypoints found in the project's `entrypoints`
+   *   directory
    */
   'entrypoints:found': (wxt: Wxt, infos: EntrypointInfo[]) => HookResult;
   /**
-   * Called once all entrypoints have been loaded from the `entrypointsDir`.
-   * Use `wxt.builder.importEntrypoint` to load entrypoint options from the
-   * file, or manually define them.
+   * Called once all entrypoints have been loaded from the `entrypointsDir`. Use
+   * `wxt.builder.importEntrypoint` to load entrypoint options from the file, or
+   * manually define them.
    *
    * @param wxt The configured WXT object
    * @param entrypoints The list of entrypoints to be built
@@ -1119,6 +1129,7 @@ interface WxtHooks {
   'entrypoints:resolved': (wxt: Wxt, entrypoints: Entrypoint[]) => HookResult;
   /**
    * Called once all entrypoints have been grouped into their build groups.
+   *
    * @param wxt The configured WXT object
    * @param entrypoints The list of groups to build in each build step
    */
@@ -1126,88 +1137,91 @@ interface WxtHooks {
   /**
    * Called when public assets are found. You can modify the `files` list by
    * reference to add or remove public files.
+   *
    * @param wxt The configured WXT object
-   * @param entrypoints The list of files that will be copied into the output directory
+   * @param entrypoints The list of files that will be copied into the output
+   *   directory
    */
   'build:publicAssets': (wxt: Wxt, files: ResolvedPublicFile[]) => HookResult;
   /**
    * Called before the zip process starts.
+   *
    * @param wxt The configured WXT object
    */
   'zip:start': (wxt: Wxt) => HookResult;
   /**
    * Called before zipping the extension files.
+   *
    * @param wxt The configured WXT object
    */
   'zip:extension:start': (wxt: Wxt) => HookResult;
   /**
    * Called after zipping the extension files.
+   *
    * @param wxt The configured WXT object
    * @param zipPath The path to the created extension zip file
    */
   'zip:extension:done': (wxt: Wxt, zipPath: string) => HookResult;
   /**
    * Called before zipping the source files (for Firefox).
+   *
    * @param wxt The configured WXT object
    */
   'zip:sources:start': (wxt: Wxt) => HookResult;
   /**
    * Called after zipping the source files (for Firefox).
+   *
    * @param wxt The configured WXT object
    * @param zipPath The path to the created sources zip file
    */
   'zip:sources:done': (wxt: Wxt, zipPath: string) => HookResult;
   /**
    * Called after the entire zip process is complete.
+   *
    * @param wxt The configured WXT object
    * @param zipFiles An array of paths to all created zip files
    */
   'zip:done': (wxt: Wxt, zipFiles: string[]) => HookResult;
   /**
-   * Called when the dev server is created (and `wxt.server` is assigned). Server has not been started yet.
+   * Called when the dev server is created (and `wxt.server` is assigned).
+   * Server has not been started yet.
+   *
    * @param wxt The configured WXT object
-   * @param server Same as `wxt.server`, the object WXT uses to control the dev server.
+   * @param server Same as `wxt.server`, the object WXT uses to control the dev
+   *   server.
    */
   'server:created': (wxt: Wxt, server: WxtDevServer) => HookResult;
   /**
    * Called when the dev server is started.
+   *
    * @param wxt The configured WXT object
-   * @param server Same as `wxt.server`, the object WXT uses to control the dev server.
+   * @param server Same as `wxt.server`, the object WXT uses to control the dev
+   *   server.
    */
   'server:started': (wxt: Wxt, server: WxtDevServer) => HookResult;
   /**
    * Called when the dev server is stopped.
+   *
    * @param wxt The configured WXT object
-   * @param server Same as `wxt.server`, the object WXT uses to control the dev server.
+   * @param server Same as `wxt.server`, the object WXT uses to control the dev
+   *   server.
    */
   'server:closed': (wxt: Wxt, server: WxtDevServer) => HookResult;
 }
 interface Wxt {
   config: ResolvedConfig$1;
   hooks: Hookable<WxtHooks>;
-  /**
-   * Alias for `wxt.hooks.hook(...)`.
-   */
+  /** Alias for `wxt.hooks.hook(...)`. */
   hook: Hookable<WxtHooks>['hook'];
-  /**
-   * Alias for config.logger
-   */
+  /** Alias for config.logger */
   logger: Logger;
-  /**
-   * Reload config file and update `wxt.config` with the result.
-   */
+  /** Reload config file and update `wxt.config` with the result. */
   reloadConfig: () => Promise<void>;
-  /**
-   * Package manager utilities.
-   */
+  /** Package manager utilities. */
   pm: WxtPackageManager;
-  /**
-   * If the dev server was started, it will be available.
-   */
+  /** If the dev server was started, it will be available. */
   server?: WxtDevServer;
-  /**
-   * The module in charge of executing all the build steps.
-   */
+  /** The module in charge of executing all the build steps. */
   builder: WxtBuilder;
 }
 interface ResolvedConfig$1 {
@@ -1216,8 +1230,9 @@ interface ResolvedConfig$1 {
   publicDir: string;
   /**
    * Absolute path pointing to `.wxt` directory in project root.
+   *
    * @example
-   * "/path/to/project/.wxt"
+   *   '/path/to/project/.wxt';
    */
   wxtDir: string;
   typesDir: string;
@@ -1226,19 +1241,22 @@ interface ResolvedConfig$1 {
   filterEntrypoints?: Set<string>;
   /**
    * Absolute path to the `.output` directory
+   *
    * @example
-   * "/path/to/project/.output"
+   *   '/path/to/project/.output';
    */
   outBaseDir: string;
   /**
    * Absolute path to the target output directory.
+   *
    * @example
-   * "/path/to/project/.output/chrome-mv3"
+   *   '/path/to/project/.output/chrome-mv3';
    */
   outDir: string;
   debug: boolean;
   /**
-   * Absolute path pointing to the `node_modules/wxt` directory, wherever WXT is installed.
+   * Absolute path pointing to the `node_modules/wxt` directory, wherever WXT is
+   * installed.
    */
   wxtModuleDir: string;
   mode: string;
@@ -1262,10 +1280,7 @@ interface ResolvedConfig$1 {
     downloadedPackagesDir: string;
     downloadPackages: string[];
     compressionLevel: 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9;
-    exclude: string[];
-    /**
-     * If true, when zipping the extension, also zip the sources.
-     */
+    exclude: string[]; /** If true, when zipping the extension, also zip the sources. */
     zipSources: boolean;
   };
   analysis: {
@@ -1278,9 +1293,7 @@ interface ResolvedConfig$1 {
     keepArtifacts: boolean;
   };
   userConfigMetadata: Omit<ResolvedConfig<UserConfig>, 'config'>;
-  /**
-   * Import aliases to absolute paths.
-   */
+  /** Import aliases to absolute paths. */
   alias: Record<string, string>;
   experimental: {};
   dev: {
@@ -1289,21 +1302,21 @@ interface ResolvedConfig$1 {
       port: number;
       origin: string;
       /**
-       * The milliseconds to debounce when a file is saved before reloading.
-       * The only way to set this option is to set the `WXT_WATCH_DEBOUNCE`
+       * The milliseconds to debounce when a file is saved before reloading. The
+       * only way to set this option is to set the `WXT_WATCH_DEBOUNCE`
        * environment variable, either globally (like in `.bashrc` file) or
        * per-project (in `.env` file).
        *
        * For example:
-       * ```
-       * # ~/.zshrc
-       * export WXT_WATCH_DEBOUNCE=1000
-       * ```
-       * or
-       * ```
-       * # .env
-       * WXT_WATCH_DEBOUNCE=1000
-       * ```
+       *
+       *     # ~/.zshrc
+       *     export WXT_WATCH_DEBOUNCE=1000
+       *
+       * Or
+       *
+       *     # .env
+       *     WXT_WATCH_DEBOUNCE=1000
+       *
        * @default 800
        */
       watchDebounce: number;
@@ -1314,11 +1327,11 @@ interface ResolvedConfig$1 {
   builtinModules: WxtModule<any>[];
   userModules: WxtModuleWithMetadata<any>[];
   /**
-   * An array of string to import plugins from. These paths should be
-   * resolvable by vite, and they should `export default defineWxtPlugin(...)`.
+   * An array of string to import plugins from. These paths should be resolvable
+   * by vite, and they should `export default defineWxtPlugin(...)`.
    *
    * @example
-   * ["@wxt-dev/module-vue/plugin", "wxt-module-google-analytics/plugin"]
+   *   ['@wxt-dev/module-vue/plugin', 'wxt-module-google-analytics/plugin'];
    */
   plugins: string[];
 }
@@ -1335,10 +1348,12 @@ interface ExtensionRunner {
 type EslintGlobalsPropValue = boolean | 'readonly' | 'readable' | 'writable' | 'writeable';
 interface Eslintrc {
   /**
-   * When true, generates a file that can be used by ESLint to know which variables are valid globals.
+   * When true, generates a file that can be used by ESLint to know which
+   * variables are valid globals.
    *
    * - `false`: Don't generate the file.
-   * - `'auto'`: Check if eslint is installed, and if it is, generate a compatible config file.
+   * - `'auto'`: Check if eslint is installed, and if it is, generate a compatible
+   *   config file.
    * - `true`: Same as `8`.
    * - `8`: Generate a config file compatible with ESLint 8.
    * - `9`: Generate a config file compatible with ESLint 9.
@@ -1350,13 +1365,12 @@ interface Eslintrc {
    * File path to save the generated eslint config.
    *
    * Default depends on version of ESLint used:
+   *
    * - 9 and above: './.wxt/eslint-auto-imports.mjs'
    * - 8 and below: './.wxt/eslintrc-auto-import.json'
    */
   filePath?: string;
-  /**
-   * @default true
-   */
+  /** @default true */
   globalsPropValue?: EslintGlobalsPropValue;
 }
 interface ResolvedEslintrc {
@@ -1372,21 +1386,26 @@ type WxtUnimportOptions = Partial<UnimportOptions> & {
    * globals". This option lets you configure a base eslintrc that, when
    * extended, fixes these lint errors.
    *
-   * See <https://wxt.dev/guide/key-concepts/auto-imports.html#eslint>
+   * See
+   * [https://wxt.dev/guide/key-concepts/auto-imports.html#eslint](https://wxt.dev/guide/key-concepts/auto-imports.html#eslint)
    */
   eslintrc?: Eslintrc;
 };
 type WxtResolvedUnimportOptions = Partial<UnimportOptions> & {
   /**
-   * Set to `true` when the user disabled auto-imports. We still use unimport for the #imports module, but other features should be disabled.
+   * Set to `true` when the user disabled auto-imports. We still use unimport
+   * for the #imports module, but other features should be disabled.
    *
-   * You don't need to check this value before modifying the auto-import options. Even if `disabled` is `true`, there's no harm in adding imports to the config - they'll just be ignored.
+   * You don't need to check this value before modifying the auto-import
+   * options. Even if `disabled` is `true`, there's no harm in adding imports to
+   * the config - they'll just be ignored.
    */
   disabled: boolean;
   eslintrc: ResolvedEslintrc;
 };
 /**
- * Package management utils built on top of [`nypm`](https://www.npmjs.com/package/nypm)
+ * Package management utils built on top of
+ * [`nypm`](https://www.npmjs.com/package/nypm)
  */
 interface WxtPackageManager extends Nypm.PackageManager {
   addDependency: typeof Nypm.addDependency;
@@ -1395,16 +1414,19 @@ interface WxtPackageManager extends Nypm.PackageManager {
   installDependencies: typeof Nypm.installDependencies;
   removeDependency: typeof Nypm.removeDependency;
   /**
-   * Download a package's TGZ file and move it into the `downloadDir`. Use's `npm pack <name>`, so
-   * you must have setup authorization in `.npmrc` file, regardless of the package manager used.
+   * Download a package's TGZ file and move it into the `downloadDir`. Use's
+   * `npm pack <name>`, so you must have setup authorization in `.npmrc` file,
+   * regardless of the package manager used.
    *
-   * @param id Name of the package to download, can include a version (like `wxt@0.17.1`)
+   * @param id Name of the package to download, can include a version (like
+   *   `wxt@0.17.1`)
    * @param downloadDir Where to store the package.
    * @returns Absolute path to downloaded file.
    */
   downloadDependency: (id: string, downloadDir: string) => Promise<string>;
   /**
-   * Run `npm ls`, `pnpm ls`, or `bun pm ls`, or `yarn list` and return the results.
+   * Run `npm ls`, `pnpm ls`, or `bun pm ls`, or `yarn list` and return the
+   * results.
    *
    * WARNING: Yarn always returns all dependencies
    */
@@ -1412,9 +1434,7 @@ interface WxtPackageManager extends Nypm.PackageManager {
     cwd?: string;
     all?: boolean;
   }) => Promise<Dependency[]>;
-  /**
-   * Key used to override package versions. Sometimes called "resolutions".
-   */
+  /** Key used to override package versions. Sometimes called "resolutions". */
   overridesKey: string;
 }
 interface Dependency {
@@ -1426,12 +1446,11 @@ type WxtModuleSetup<TOptions extends WxtModuleOptions> = (wxt: Wxt, moduleOption
 interface WxtModule<TOptions extends WxtModuleOptions> {
   name?: string;
   /**
-   * Key for users to pass options into your module from their `wxt.config.ts` file.
+   * Key for users to pass options into your module from their `wxt.config.ts`
+   * file.
    */
   configKey?: string;
-  /**
-   * Provide a list of imports to add to auto-imports.
-   */
+  /** Provide a list of imports to add to auto-imports. */
   imports?: Import[];
   /**
    * Alternative to adding hooks in setup function with `wxt.hooks`. Hooks are
@@ -1452,48 +1471,49 @@ type ResolvedPublicFile = CopiedPublicFile | GeneratedPublicFile;
 interface ResolvedBasePublicFile {
   /**
    * The relative path in the output directory to copy the file to.
+   *
    * @example
-   * "content-scripts/base-styles.css"
+   *   'content-scripts/base-styles.css';
    */
   relativeDest: string;
 }
 interface CopiedPublicFile extends ResolvedBasePublicFile {
   /**
    * The absolute path to the file that will be copied to the output directory.
+   *
    * @example
-   * "/path/to/any/file.css"
+   *   '/path/to/any/file.css';
    */
   absoluteSrc: string;
 }
 interface GeneratedPublicFile extends ResolvedBasePublicFile {
-  /**
-   * Text to write to the file.
-   */
+  /** Text to write to the file. */
   contents: string;
 }
 type WxtPlugin = () => void;
 type WxtDirEntry = WxtDirTypeReferenceEntry | WxtDirFileEntry;
 /**
- * Represents type reference to a node module to be added to `.wxt/wxt.d.ts` file
+ * Represents type reference to a node module to be added to `.wxt/wxt.d.ts`
+ * file
  */
 interface WxtDirTypeReferenceEntry {
+  /**
+   * Specifies the module name that will be used in the `/// <reference
+   * types="..." />` directive. This value will be added to the `.wxt/wxt.d.ts`
+   * file to include type definitions from the specified module.
+   */
   module: string;
 }
-/**
- * Represents a file to be written to the project's `.wxt/` directory.
- */
+/** Represents a file to be written to the project's `.wxt/` directory. */
 interface WxtDirFileEntry {
   /**
-   * Path relative to the `.wxt/` directory. So "tsconfig.json" would resolve to ".wxt/tsconfig.json".
+   * Path relative to the `.wxt/` directory. So "tsconfig.json" would resolve to
+   * ".wxt/tsconfig.json".
    */
   path: string;
-  /**
-   * The text that will be written to the file.
-   */
+  /** The text that will be written to the file. */
   text: string;
-  /**
-   * Set to `true` to add a reference to this file in `.wxt/wxt.d.ts`.
-   */
+  /** Set to `true` to add a reference to this file in `.wxt/wxt.d.ts`. */
   tsReference?: boolean;
 }
 //#endregion