wxt 0.18.15 → 0.19.0

package/dist/{index-nWRfwAJi.d.cts → types.d.ts}

@@ -1,133 +1,14 @@
-import * as vite from 'vite';
-import { Manifest, Scripting } from 'webextension-polyfill';
+import type * as vite from 'vite';
+import type { Manifest, Scripting } from 'wxt/browser';
 import { UnimportOptions, Import } from 'unimport';
 import { LogLevel } from 'consola';
-import { PluginVisualizerOptions } from '@aklinker1/rollup-plugin-visualizer';
-import { FSWatcher } from 'chokidar';
-import { ResolvedConfig as ResolvedConfig$1 } from 'c12';
-import { NestedHooks, Hookable } from 'hookable';
-import * as Nypm from 'nypm';
-
-declare class WxtLocationChangeEvent extends Event {
-    readonly newUrl: URL;
-    readonly oldUrl: URL;
-    static EVENT_NAME: string;
-    constructor(newUrl: URL, oldUrl: URL);
-}
-
-/**
- * Implements [`AbortController`](https://developer.mozilla.org/en-US/docs/Web/API/AbortController).
- * Used to detect and stop content script code when the script is invalidated.
- *
- * It also provides several utilities like `ctx.setTimeout` and `ctx.setInterval` that should be used in
- * content scripts instead of `window.setTimeout` or `window.setInterval`.
- *
- * To create context for testing, you can use the class's constructor:
- *
- * ```ts
- * import { ContentScriptContext } from 'wxt/client';
- *
- * test("storage listener should be removed when context is invalidated", () => {
- *   const ctx = new ContentScriptContext('test');
- *   const item = storage.defineItem("local:count", { defaultValue: 0 });
- *   const watcher = vi.fn();
- *
- *   const unwatch = item.watch(watcher);
- *   ctx.onInvalidated(unwatch); // Listen for invalidate here
- *
- *   await item.setValue(1);
- *   expect(watcher).toBeCalledTimes(1);
- *   expect(watcher).toBeCalledWith(1, 0);
- *
- *   ctx.notifyInvalidated(); // Use this function to invalidate the context
- *   await item.setValue(2);
- *   expect(watcher).toBeCalledTimes(1);
- * });
- * ```
- */
-declare class ContentScriptContext implements AbortController {
-    #private;
-    private readonly contentScriptName;
-    readonly options?: Omit<ContentScriptDefinition, "main"> | undefined;
-    private static SCRIPT_STARTED_MESSAGE_TYPE;
-    constructor(contentScriptName: string, options?: Omit<ContentScriptDefinition, "main"> | undefined);
-    get signal(): AbortSignal;
-    abort(reason?: any): void;
-    get isInvalid(): boolean;
-    get isValid(): boolean;
-    /**
-     * Add a listener that is called when the content script's context is invalidated.
-     *
-     * @returns A function to remove the listener.
-     *
-     * @example
-     * browser.runtime.onMessage.addListener(cb);
-     * const removeInvalidatedListener = ctx.onInvalidated(() => {
-     *   browser.runtime.onMessage.removeListener(cb);
-     * })
-     * // ...
-     * removeInvalidatedListener();
-     */
-    onInvalidated(cb: () => void): () => void;
-    /**
-     * Return a promise that never resolves. Useful if you have an async function that shouldn't run
-     * after the context is expired.
-     *
-     * @example
-     * const getValueFromStorage = async () => {
-     *   if (ctx.isInvalid) return ctx.block();
-     *
-     *   // ...
-     * }
-     */
-    block<T>(): Promise<T>;
-    /**
-     * Wrapper around `window.setInterval` that automatically clears the interval when invalidated.
-     */
-    setInterval(handler: () => void, timeout?: number): number;
-    /**
-     * Wrapper around `window.setTimeout` that automatically clears the interval when invalidated.
-     */
-    setTimeout(handler: () => void, timeout?: number): number;
-    /**
-     * Wrapper around `window.requestAnimationFrame` that automatically cancels the request when
-     * invalidated.
-     */
-    requestAnimationFrame(callback: FrameRequestCallback): number;
-    /**
-     * Wrapper around `window.requestIdleCallback` that automatically cancels the request when
-     * invalidated.
-     */
-    requestIdleCallback(callback: IdleRequestCallback, options?: IdleRequestOptions): number;
-    /**
-     * Call `target.addEventListener` and remove the event listener when the context is invalidated.
-     *
-     * Includes additional events useful for content scripts:
-     *
-     * - `"wxt:locationchange"` - Triggered when HTML5 history mode is used to change URL. Content
-     *   scripts are not reloaded when navigating this way, so this can be used to reset the content
-     *   script state on URL change, or run custom code.
-     *
-     * @example
-     * ctx.addEventListener(document, "visibilitychange", () => {
-     *   // ...
-     * });
-     * ctx.addEventListener(document, "wxt:locationchange", () => {
-     *   // ...
-     * });
-     */
-    addEventListener<TTarget extends EventTarget, TType extends keyof WxtContentScriptEventMap>(target: TTarget, type: TType, handler: (event: WxtContentScriptEventMap[TType]) => void, options?: AddEventListenerOptions): void;
-    /**
-     * @internal
-     * Abort the abort controller and execute all `onInvalidated` listeners.
-     */
-    notifyInvalidated(): void;
-}
-interface WxtContentScriptEventMap extends WindowEventMap {
-    'wxt:locationchange': WxtLocationChangeEvent;
-}
-
-interface InlineConfig {
+import type { ContentScriptContext } from './client/content-scripts/content-script-context';
+import type { PluginVisualizerOptions } from '@aklinker1/rollup-plugin-visualizer';
+import type { FSWatcher } from 'chokidar';
+import { ResolvedConfig as C12ResolvedConfig } from 'c12';
+import { Hookable, NestedHooks } from 'hookable';
+import type * as Nypm from 'nypm';
+export interface InlineConfig {
     /**
      * Your project's root directory containing the `package.json` used to fill out the
      * `manifest.json`.
@@ -409,43 +290,34 @@ interface InlineConfig {
      * }
      */
     alias?: Record<string, string>;
+    /**
+     * Which extension API to use.
+     *
+     * - `"webextension-polyfill"`: Use `browser` and types from [`webextension-polyfill`](https://www.npmjs.com/package/webextension-polyfill).
+     * - `"chrome"` (unstable): Use the regular `chrome` (or `browser` for Firefox/Safari) globals provided by the browser. Types provided by [`@types/chrome`](https://www.npmjs.com/package/@types/chrome), make sure to install the package or types won't work.
+     *
+     * @default "webextension-polyfill"
+     * @since 0.19.0
+     */
+    extensionApi?: 'webextension-polyfill' | 'chrome';
+    /**
+     * @deprecated Will be removed in v0.20.0, please migrate to using `vite-node`, the new default.
+     *
+     * Method used to import entrypoint files during the build process to extract their options.
+     *
+     * - `"vite-node"` (default as of 0.19.0): Uses `vite-node` to import the entrypoints. Automatically includes vite config based on your wxt.config.ts file
+     * - `"jiti"`: Simplest and fastest, but doesn't allow using any imported variables outside the entrypoint's main function
+     *
+     * @see {@link https://wxt.dev/guide/go-further/entrypoint-importers.html|Entrypoint Importers}
+     *
+     * @default "vite-node"
+     * @since 0.19.0
+     */
+    entrypointLoader?: 'vite-node' | 'jiti';
     /**
      * Experimental settings - use with caution.
      */
-    experimental?: {
-        /**
-         * Whether to use [`webextension-polyfill`](https://www.npmjs.com/package/webextension-polyfill)
-         * when importing `browser` from `wxt/browser`.
-         *
-         * When set to `false`, WXT will export the chrome global instead of the polyfill from
-         * `wxt/browser`.
-         *
-         * You should use `browser` to access the web extension APIs.
-         *
-         * @experimental This option will remain experimental until Manifest V2 is dead.
-         *
-         * @default true
-         * @example
-         * export default defineConfig({
-         *   experimental: {
-         *     includeBrowserPolyfill: false
-         *   }
-         * })
-         */
-        includeBrowserPolyfill?: boolean;
-        /**
-         * Method used to import entrypoint files during the build process to extract their options.
-         *
-         * - "jiti": Simplest and fastest, but doesn't allow using any imported variables outside the entrypoint's main function
-         * - "vite-runtime" (unstable): Uses Vite 5.3's new runtime API to import the entrypoints. Automatically includes vite config based on your wxt.config.ts file
-         * - "vite-node" (unstable): Uses `vite-node` to import the entrypoints. Automatically includes vite config based on your wxt.config.ts file
-         *
-         * @see {@link https://wxt.dev/guide/go-further/entrypoint-side-effects.html|Entrypoint Side-effect Docs}
-         *
-         * @default "jiti"
-         */
-        entrypointImporter?: 'jiti' | 'vite-runtime' | 'vite-node';
-    };
+    experimental?: {};
     /**
      * Config effecting dev mode only.
      */
@@ -487,7 +359,7 @@ interface InlineConfig {
      */
     modules?: string[];
 }
-interface InlineConfig {
+export interface InlineConfig {
     /**
      * Return custom Vite options from a function. See
      * <https://vitejs.dev/config/shared-options.html>.
@@ -500,14 +372,34 @@ interface InlineConfig {
      */
     vite?: (env: ConfigEnv) => WxtViteConfig | Promise<WxtViteConfig>;
 }
-type WxtViteConfig = Omit<vite.UserConfig, 'root' | 'configFile' | 'mode'>;
-interface BuildOutput {
+export interface ResolvedConfig {
+    vite: (env: ConfigEnv) => WxtViteConfig | Promise<WxtViteConfig>;
+}
+export type WxtViteConfig = Omit<vite.UserConfig, 'root' | 'configFile' | 'mode'>;
+export 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 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.
+     *
+     * @param viteConfig The config that will be used to build the entrypoints. Can be updated by reference.
+     */
+    'vite:devServer:extendConfig': (config: vite.InlineConfig) => HookResult;
+}
+export interface BuildOutput {
     manifest: Manifest.WebExtensionManifest;
     publicAssets: OutputAsset[];
     steps: BuildStepOutput[];
 }
-type OutputFile = OutputChunk | OutputAsset;
-interface OutputChunk {
+export type OutputFile = OutputChunk | OutputAsset;
+export interface OutputChunk {
     type: 'chunk';
     /**
      * Relative, normalized path relative to the output directory.
@@ -520,7 +412,7 @@ interface OutputChunk {
      */
     moduleIds: string[];
 }
-interface OutputAsset {
+export interface OutputAsset {
     type: 'asset';
     /**
      * Relative, normalized path relative to the output directory.
@@ -529,11 +421,11 @@ interface OutputAsset {
      */
     fileName: string;
 }
-interface BuildStepOutput {
+export interface BuildStepOutput {
     entrypoints: EntrypointGroup;
     chunks: OutputFile[];
 }
-interface WxtDevServer extends Omit<WxtBuilderServer, 'listen' | 'close'>, ServerInfo {
+export interface WxtDevServer extends Omit<WxtBuilderServer, 'listen' | 'close'>, ServerInfo {
     /**
      * Stores the current build output of the server.
      */
@@ -581,14 +473,14 @@ interface WxtDevServer extends Omit<WxtBuilderServer, 'listen' | 'close'>, Serve
      */
     restartBrowser: () => void;
 }
-interface ReloadContentScriptPayload {
+export interface ReloadContentScriptPayload {
     registration?: BaseContentScriptEntrypointOptions['registration'];
     contentScript: Omit<Scripting.RegisteredContentScript, 'id'>;
 }
-type TargetBrowser = string;
-type TargetManifestVersion = 2 | 3;
-type UserConfig = Omit<InlineConfig, 'configFile'>;
-interface Logger {
+export type TargetBrowser = string;
+export type TargetManifestVersion = 2 | 3;
+export type UserConfig = Omit<InlineConfig, 'configFile'>;
+export interface Logger {
     debug(...args: any[]): void;
     log(...args: any[]): void;
     info(...args: any[]): void;
@@ -598,7 +490,7 @@ interface Logger {
     success(...args: any[]): void;
     level: LogLevel;
 }
-interface BaseEntrypointOptions {
+export 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.
@@ -614,7 +506,7 @@ interface BaseEntrypointOptions {
      */
     exclude?: TargetBrowser[];
 }
-interface BackgroundEntrypointOptions extends BaseEntrypointOptions {
+export interface BackgroundEntrypointOptions extends BaseEntrypointOptions {
     persistent?: PerBrowserOption<boolean>;
     /**
      * Set to `"module"` to output the background entrypoint as ESM. ESM outputs can share chunks and
@@ -626,7 +518,7 @@ interface BackgroundEntrypointOptions extends BaseEntrypointOptions {
      */
     type?: PerBrowserOption<'module'>;
 }
-interface BaseContentScriptEntrypointOptions extends BaseEntrypointOptions {
+export interface BaseContentScriptEntrypointOptions extends BaseEntrypointOptions {
     matches: PerBrowserOption<Manifest.ContentScript['matches']>;
     /**
      * See https://developer.chrome.com/docs/extensions/mv3/content_scripts/
@@ -690,20 +582,20 @@ interface BaseContentScriptEntrypointOptions extends BaseEntrypointOptions {
      */
     registration?: PerBrowserOption<'manifest' | 'runtime'>;
 }
-interface MainWorldContentScriptEntrypointOptions extends BaseContentScriptEntrypointOptions {
+export interface MainWorldContentScriptEntrypointOptions extends BaseContentScriptEntrypointOptions {
     /**
      * See https://developer.chrome.com/docs/extensions/develop/concepts/content-scripts#isolated_world
      */
     world: 'MAIN';
 }
-interface IsolatedWorldContentScriptEntrypointOptions extends BaseContentScriptEntrypointOptions {
+export interface IsolatedWorldContentScriptEntrypointOptions extends BaseContentScriptEntrypointOptions {
     /**
      * See https://developer.chrome.com/docs/extensions/develop/concepts/content-scripts#isolated_world
      * @default "ISOLATED"
      */
     world?: 'ISOLATED';
 }
-interface PopupEntrypointOptions extends BaseEntrypointOptions {
+export interface PopupEntrypointOptions extends BaseEntrypointOptions {
     /**
      * Defaults to "browser_action" to be equivalent to MV3's "action" key
      */
@@ -712,12 +604,12 @@ interface PopupEntrypointOptions extends BaseEntrypointOptions {
     defaultTitle?: PerBrowserOption<string>;
     browserStyle?: PerBrowserOption<boolean>;
 }
-interface OptionsEntrypointOptions extends BaseEntrypointOptions {
+export interface OptionsEntrypointOptions extends BaseEntrypointOptions {
     openInTab?: PerBrowserOption<boolean>;
     browserStyle?: PerBrowserOption<boolean>;
     chromeStyle?: PerBrowserOption<boolean>;
 }
-interface SidepanelEntrypointOptions extends BaseEntrypointOptions {
+export interface SidepanelEntrypointOptions extends BaseEntrypointOptions {
     /**
      * Firefox only. See https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/sidebar_action#syntax
      * @default false
@@ -730,7 +622,7 @@ interface SidepanelEntrypointOptions extends BaseEntrypointOptions {
     defaultIcon?: string | Record<string, string>;
     defaultTitle?: PerBrowserOption<string>;
 }
-interface BaseEntrypoint {
+export interface BaseEntrypoint {
     /**
      * The entrypoint's name. This is the filename or dirname without the type suffix.
      *
@@ -759,34 +651,34 @@ interface BaseEntrypoint {
     outputDir: string;
     skipped: boolean;
 }
-interface GenericEntrypoint extends BaseEntrypoint {
+export interface GenericEntrypoint extends BaseEntrypoint {
     type: 'sandbox' | 'bookmarks' | 'history' | 'newtab' | 'devtools' | 'unlisted-page' | 'unlisted-script' | 'unlisted-style' | 'content-script-style';
     options: ResolvedPerBrowserOptions<BaseEntrypointOptions>;
 }
-interface BackgroundEntrypoint extends BaseEntrypoint {
+export interface BackgroundEntrypoint extends BaseEntrypoint {
     type: 'background';
     options: ResolvedPerBrowserOptions<BackgroundEntrypointOptions>;
 }
-interface ContentScriptEntrypoint extends BaseEntrypoint {
+export interface ContentScriptEntrypoint extends BaseEntrypoint {
     type: 'content-script';
     options: ResolvedPerBrowserOptions<MainWorldContentScriptEntrypointOptions | IsolatedWorldContentScriptEntrypointOptions>;
 }
-interface PopupEntrypoint extends BaseEntrypoint {
+export interface PopupEntrypoint extends BaseEntrypoint {
     type: 'popup';
     options: ResolvedPerBrowserOptions<PopupEntrypointOptions, 'defaultIcon'>;
 }
-interface OptionsEntrypoint extends BaseEntrypoint {
+export interface OptionsEntrypoint extends BaseEntrypoint {
     type: 'options';
     options: ResolvedPerBrowserOptions<OptionsEntrypointOptions>;
 }
-interface SidepanelEntrypoint extends BaseEntrypoint {
+export interface SidepanelEntrypoint extends BaseEntrypoint {
     type: 'sidepanel';
     options: ResolvedPerBrowserOptions<SidepanelEntrypointOptions, 'defaultIcon'>;
 }
-type Entrypoint = GenericEntrypoint | BackgroundEntrypoint | ContentScriptEntrypoint | PopupEntrypoint | OptionsEntrypoint | SidepanelEntrypoint;
-type EntrypointGroup = Entrypoint | Entrypoint[];
-type OnContentScriptStopped = (cb: () => void) => void;
-interface IsolatedWorldContentScriptDefinition extends IsolatedWorldContentScriptEntrypointOptions {
+export type Entrypoint = GenericEntrypoint | BackgroundEntrypoint | ContentScriptEntrypoint | PopupEntrypoint | OptionsEntrypoint | SidepanelEntrypoint;
+export type EntrypointGroup = Entrypoint | Entrypoint[];
+export type OnContentScriptStopped = (cb: () => void) => void;
+export interface IsolatedWorldContentScriptDefinition extends IsolatedWorldContentScriptEntrypointOptions {
     /**
      * Main function executed when the content script is loaded.
      *
@@ -796,7 +688,7 @@ interface IsolatedWorldContentScriptDefinition extends IsolatedWorldContentScrip
      */
     main(ctx: ContentScriptContext): any | Promise<any>;
 }
-interface MainWorldContentScriptDefinition extends MainWorldContentScriptEntrypointOptions {
+export interface MainWorldContentScriptDefinition extends MainWorldContentScriptEntrypointOptions {
     /**
      * Main function executed when the content script is loaded.
      *
@@ -806,14 +698,14 @@ interface MainWorldContentScriptDefinition extends MainWorldContentScriptEntrypo
      */
     main(): any | Promise<any>;
 }
-type ContentScriptDefinition = IsolatedWorldContentScriptDefinition | MainWorldContentScriptDefinition;
-interface BackgroundDefinition extends BackgroundEntrypointOptions {
+export type ContentScriptDefinition = IsolatedWorldContentScriptDefinition | MainWorldContentScriptDefinition;
+export interface BackgroundDefinition extends BackgroundEntrypointOptions {
     /**
      * Main function executed when the background script is started. Cannot be async.
      */
     main(): void;
 }
-interface UnlistedScriptDefinition extends BaseEntrypointOptions {
+export interface UnlistedScriptDefinition extends BaseEntrypointOptions {
     /**
      * Main function executed when the unlisted script is ran.
      *
@@ -826,8 +718,8 @@ interface UnlistedScriptDefinition extends BaseEntrypointOptions {
 /**
  * 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> = {
+export type PerBrowserOption<T> = T | PerBrowserMap<T>;
+export type PerBrowserMap<T> = {
     [browser: TargetBrowser]: T;
 };
 /**
@@ -836,7 +728,7 @@ type PerBrowserMap<T> = {
  *
  * 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> = {
+export 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];
@@ -845,9 +737,9 @@ type ResolvedPerBrowserOptions<T, TOmitted extends keyof T = never> = {
  * Manifest customization available in the `wxt.config.ts` file. You cannot configure entrypoints
  * here, they are configured inline.
  */
-type UserManifest = Partial<Omit<Manifest.WebExtensionManifest, 'background' | 'chrome_url_overrides' | 'devtools_page' | 'manifest_version' | 'options_page' | 'options_ui' | 'sandbox'>>;
-type UserManifestFn = (env: ConfigEnv) => UserManifest | Promise<UserManifest>;
-interface ConfigEnv {
+export type UserManifest = Partial<Omit<Manifest.WebExtensionManifest, 'background' | 'chrome_url_overrides' | 'devtools_page' | 'manifest_version' | 'options_page' | 'options_ui' | 'sandbox'>>;
+export type UserManifestFn = (env: ConfigEnv) => UserManifest | Promise<UserManifest>;
+export interface ConfigEnv {
     /**
      * The build mode passed into the CLI. By default, `wxt` uses `"development"` and `wxt build|zip`
      * uses `"production"`.
@@ -868,11 +760,11 @@ interface ConfigEnv {
      */
     manifestVersion: 2 | 3;
 }
-type WxtCommand = 'build' | 'serve';
+export type WxtCommand = 'build' | 'serve';
 /**
  * Configure how the browser starts up.
  */
-interface ExtensionRunnerConfig {
+export interface ExtensionRunnerConfig {
     /**
      * Whether or not to open the browser with the extension installed in dev mode.
      *
@@ -954,7 +846,7 @@ interface ExtensionRunnerConfig {
      */
     keepProfileChanges?: boolean;
 }
-interface WxtBuilder {
+export interface WxtBuilder {
     /**
      * Name of tool used to build. Ex: "Vite" or "Webpack".
      */
@@ -977,7 +869,7 @@ interface WxtBuilder {
      */
     createServer(info: ServerInfo): Promise<WxtBuilderServer>;
 }
-interface WxtBuilderServer {
+export interface WxtBuilderServer {
     /**
      * Start the server.
      */
@@ -1012,7 +904,7 @@ interface WxtBuilderServer {
      */
     watcher: FSWatcher;
 }
-interface ServerInfo {
+export interface ServerInfo {
     /**
      * Ex: `3000`
      */
@@ -1026,25 +918,8 @@ interface ServerInfo {
      */
     origin: string;
 }
-type HookResult = Promise<void> | void;
-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 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.
-     *
-     * @param viteConfig The config that will be used to build the entrypoints. Can be updated by reference.
-     */
-    'vite:devServer:extendConfig': (config: vite.InlineConfig) => HookResult;
-}
-interface WxtHooks {
+export type HookResult = Promise<void> | void;
+export interface WxtHooks {
     /**
      * Called after WXT initialization, when the WXT instance is ready to work.
      * @param wxt The configured WXT object
@@ -1068,6 +943,20 @@ interface WxtHooks {
      * })
      */
     '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.
+     *
+     * @example
+     * wxt.hooks.hook('prepare:publicPaths', (wxt, paths) => {
+     *   paths.push('/icons/128.png');
+     * })
+     */
+    'prepare:publicPaths': (wxt: Wxt, paths: string[]) => HookResult;
     /**
      * Called before the build is started in both dev mode and build mode.
      *
@@ -1075,7 +964,9 @@ interface WxtHooks {
      */
     'build:before': (wxt: Wxt) => HookResult;
     /**
-     * Called once the build process has finished.
+     * Called once the build process has finished. You can add files to the build
+     * summary here by pushing to `output.publicAssets`.
+     *
      * @param wxt The configured WXT object
      * @param output The results of the build
      */
@@ -1107,7 +998,7 @@ interface WxtHooks {
      */
     'build:publicAssets': (wxt: Wxt, files: ResolvedPublicFile[]) => HookResult;
 }
-interface Wxt {
+export interface Wxt {
     config: ResolvedConfig;
     hooks: Hookable<WxtHooks>;
     /**
@@ -1131,10 +1022,7 @@ interface Wxt {
      */
     builder: WxtBuilder;
 }
-interface ResolvedConfig {
-    vite: (env: ConfigEnv) => WxtViteConfig | Promise<WxtViteConfig>;
-}
-interface ResolvedConfig {
+export interface ResolvedConfig {
     root: string;
     srcDir: string;
     publicDir: string;
@@ -1174,7 +1062,7 @@ interface ResolvedConfig {
     imports: false | WxtResolvedUnimportOptions;
     manifest: UserManifest;
     fsCache: FsCache;
-    runnerConfig: ResolvedConfig$1<ExtensionRunnerConfig>;
+    runnerConfig: C12ResolvedConfig<ExtensionRunnerConfig>;
     zip: {
         name?: string;
         artifactTemplate: string;
@@ -1202,15 +1090,15 @@ interface ResolvedConfig {
         outputName: string;
         keepArtifacts: boolean;
     };
-    userConfigMetadata: Omit<ResolvedConfig$1<UserConfig>, 'config'>;
+    userConfigMetadata: Omit<C12ResolvedConfig<UserConfig>, 'config'>;
     /**
      * Import aliases to absolute paths.
      */
     alias: Record<string, string>;
-    experimental: {
-        includeBrowserPolyfill: boolean;
-        entrypointImporter: 'jiti' | 'vite-runtime' | 'vite-node';
-    };
+    extensionApi: 'webextension-polyfill' | 'chrome';
+    browserModule: 'wxt/browser' | 'wxt/browser/chrome';
+    entrypointLoader: 'vite-node' | 'jiti';
+    experimental: {};
     dev: {
         /** Only defined during dev command */
         server?: {
@@ -1231,16 +1119,16 @@ interface ResolvedConfig {
      */
     plugins: string[];
 }
-interface FsCache {
+export interface FsCache {
     set(key: string, value: string): Promise<void>;
     get(key: string): Promise<string | undefined>;
 }
-interface ExtensionRunner {
+export interface ExtensionRunner {
     openBrowser(): Promise<void>;
     closeBrowser(): Promise<void>;
 }
-type EslintGlobalsPropValue = boolean | 'readonly' | 'readable' | 'writable' | 'writeable';
-interface Eslintrc {
+export type EslintGlobalsPropValue = boolean | 'readonly' | 'readable' | 'writable' | 'writeable';
+export interface Eslintrc {
     /**
      * When true, generates a file that can be used by ESLint to know which variables are valid globals.
      *
@@ -1266,14 +1154,14 @@ interface Eslintrc {
      */
     globalsPropValue?: EslintGlobalsPropValue;
 }
-interface ResolvedEslintrc {
+export interface ResolvedEslintrc {
     /** False if disabled, otherwise the major version of ESLint installed */
     enabled: false | 8 | 9;
     /** Absolute path */
     filePath: string;
     globalsPropValue: EslintGlobalsPropValue;
 }
-type WxtUnimportOptions = Partial<UnimportOptions> & {
+export type WxtUnimportOptions = Partial<UnimportOptions> & {
     /**
      * When using ESLint, auto-imported variables are linted as "undeclared
      * globals". This option lets you configure a base eslintrc that, when
@@ -1283,13 +1171,13 @@ type WxtUnimportOptions = Partial<UnimportOptions> & {
      */
     eslintrc?: Eslintrc;
 };
-type WxtResolvedUnimportOptions = Partial<UnimportOptions> & {
+export type WxtResolvedUnimportOptions = Partial<UnimportOptions> & {
     eslintrc: ResolvedEslintrc;
 };
 /**
  * Package management utils built on top of [`nypm`](https://www.npmjs.com/package/nypm)
  */
-interface WxtPackageManager extends Nypm.PackageManager {
+export interface WxtPackageManager extends Nypm.PackageManager {
     addDependency: typeof Nypm.addDependency;
     addDevDependency: typeof Nypm.addDevDependency;
     ensureDependencyInstalled: typeof Nypm.ensureDependencyInstalled;
@@ -1318,13 +1206,13 @@ interface WxtPackageManager extends Nypm.PackageManager {
      */
     overridesKey: string;
 }
-interface Dependency {
+export interface Dependency {
     name: string;
     version: string;
 }
-type WxtModuleOptions = Record<string, any>;
-type WxtModuleSetup<TOptions extends WxtModuleOptions> = (wxt: Wxt, moduleOptions?: TOptions) => void | Promise<void>;
-interface WxtModule<TOptions extends WxtModuleOptions> {
+export type WxtModuleOptions = Record<string, any>;
+export type WxtModuleSetup<TOptions extends WxtModuleOptions> = (wxt: Wxt, moduleOptions?: TOptions) => void | Promise<void>;
+export interface WxtModule<TOptions extends WxtModuleOptions> {
     name?: string;
     /**
      * Key for users to pass options into your module from their `wxt.config.ts` file.
@@ -1338,19 +1226,19 @@ interface WxtModule<TOptions extends WxtModuleOptions> {
      * Alternative to adding hooks in setup function with `wxt.hooks`. Hooks are
      * added before the `setup` function is called.
      */
-    hooks?: WxtHooks;
+    hooks?: Partial<WxtHooks>;
     /**
      * A custom function that can be used to setup hooks and call module-specific
      * APIs.
      */
     setup?: WxtModuleSetup<TOptions>;
 }
-interface WxtModuleWithMetadata<TOptions extends WxtModuleOptions> extends WxtModule<TOptions> {
+export interface WxtModuleWithMetadata<TOptions extends WxtModuleOptions> extends WxtModule<TOptions> {
     type: 'local' | 'node_module';
     id: string;
 }
-type ResolvedPublicFile = CopiedPublicFile | GeneratedPublicFile;
-interface ResolvedBasePublicFile {
+export type ResolvedPublicFile = CopiedPublicFile | GeneratedPublicFile;
+export interface ResolvedBasePublicFile {
     /**
      * The relative path in the output directory to copy the file to.
      * @example
@@ -1358,7 +1246,7 @@ interface ResolvedBasePublicFile {
      */
     relativeDest: string;
 }
-interface CopiedPublicFile extends ResolvedBasePublicFile {
+export interface CopiedPublicFile extends ResolvedBasePublicFile {
     /**
      * The absolute path to the file that will be copied to the output directory.
      * @example
@@ -1366,24 +1254,24 @@ interface CopiedPublicFile extends ResolvedBasePublicFile {
      */
     absoluteSrc: string;
 }
-interface GeneratedPublicFile extends ResolvedBasePublicFile {
+export interface GeneratedPublicFile extends ResolvedBasePublicFile {
     /**
      * Text to write to the file.
      */
     contents: string;
 }
-type WxtPlugin = () => void;
-type WxtDirEntry = WxtDirTypeReferenceEntry | WxtDirFileEntry;
+export type WxtPlugin = () => void;
+export type WxtDirEntry = WxtDirTypeReferenceEntry | WxtDirFileEntry;
 /**
  * Represents type reference to a node module to be added to `.wxt/wxt.d.ts` file
  */
-interface WxtDirTypeReferenceEntry {
+export interface WxtDirTypeReferenceEntry {
     module: string;
 }
 /**
  * Represents a file to be written to the project's `.wxt/` directory.
  */
-interface WxtDirFileEntry {
+export interface WxtDirFileEntry {
     /**
      * Path relative to the `.wxt/` directory. So "tsconfig.json" would resolve to ".wxt/tsconfig.json".
      */
@@ -1397,5 +1285,3 @@ interface WxtDirFileEntry {
      */
     tsReference?: boolean;
 }
-
-export type { EslintGlobalsPropValue as $, PerBrowserMap as A, BuildOutput as B, ContentScriptEntrypoint as C, ResolvedPerBrowserOptions as D, ExtensionRunnerConfig as E, UserManifest as F, GenericEntrypoint as G, UserManifestFn as H, InlineConfig as I, ConfigEnv as J, WxtCommand as K, Logger as L, MainWorldContentScriptEntrypointOptions as M, WxtBuilder as N, OutputFile as O, PopupEntrypointOptions as P, WxtBuilderServer as Q, ResolvedConfig as R, SidepanelEntrypointOptions as S, TargetBrowser as T, UserConfig as U, ServerInfo as V, WxtDevServer as W, HookResult as X, Wxt as Y, FsCache as Z, ExtensionRunner as _, WxtViteConfig as a, Eslintrc as a0, ResolvedEslintrc as a1, WxtUnimportOptions as a2, WxtResolvedUnimportOptions as a3, WxtPackageManager as a4, Dependency as a5, WxtModuleOptions as a6, WxtModuleSetup as a7, WxtModule as a8, WxtModuleWithMetadata as a9, ResolvedPublicFile as aa, ResolvedBasePublicFile as ab, CopiedPublicFile as ac, GeneratedPublicFile as ad, WxtPlugin as ae, WxtDirEntry as af, WxtDirTypeReferenceEntry as ag, WxtDirFileEntry as ah, WxtHooks as b, OutputChunk as c, OutputAsset as d, BuildStepOutput as e, ReloadContentScriptPayload as f, TargetManifestVersion as g, BaseEntrypointOptions as h, BackgroundEntrypointOptions as i, BaseContentScriptEntrypointOptions as j, IsolatedWorldContentScriptEntrypointOptions as k, OptionsEntrypointOptions as l, BaseEntrypoint as m, BackgroundEntrypoint as n, PopupEntrypoint as o, OptionsEntrypoint as p, SidepanelEntrypoint as q, Entrypoint as r, EntrypointGroup as s, OnContentScriptStopped as t, IsolatedWorldContentScriptDefinition as u, MainWorldContentScriptDefinition as v, ContentScriptDefinition as w, BackgroundDefinition as x, UnlistedScriptDefinition as y, PerBrowserOption as z };