wxt 0.19.0-alpha1 → 0.19.0

package/dist/browser/index.d.ts

@@ -1,4 +1,18 @@
 /**
+ * Includes the `browser` API and types when using `extensionApi: 'webextension-polyfill'` (the default).
+ *
  * @module wxt/browser
  */
-export * from './webextension-polyfill';
+import { Browser, Runtime, I18n } from 'webextension-polyfill';
+export interface AugmentedBrowser extends Browser {
+    runtime: WxtRuntime;
+    i18n: WxtI18n;
+}
+export interface WxtRuntime extends Runtime.Static {
+}
+export interface WxtI18n extends I18n.Static {
+}
+export declare const browser: AugmentedBrowser;
+/** @ignore */
+export type { ActivityLog, Alarms, Bookmarks, Action, BrowserAction, BrowserSettings, BrowsingData, CaptivePortal, Clipboard, Commands, ContentScripts, ContextualIdentities, Cookies, DeclarativeNetRequest, Devtools, Dns, Downloads, Events, Experiments, Extension, ExtensionTypes, Find, GeckoProfiler, History, I18n, Identity, Idle, Management, Manifest, // TODO: Export custom manifest types that are valid for both Chrome and Firefox.
+ContextMenus, Menus, NetworkStatus, NormandyAddonStudy, Notifications, Omnibox, PageAction, Permissions, Pkcs11, Privacy, Proxy, Runtime, Scripting, Search, Sessions, SidebarAction, Storage, Tabs, Theme, TopSites, Types, Urlbar, UserScripts, WebNavigation, WebRequest, Windows, } from 'webextension-polyfill';

package/dist/browser/index.mjs

@@ -1 +1,2 @@
-export * from "./webextension-polyfill.mjs";
+import originalBrowser from "webextension-polyfill";
+export const browser = originalBrowser;

package/dist/client/content-scripts/ui/types.d.ts

@@ -149,9 +149,9 @@ export interface ContentScriptModalPositioningOptions {
     zIndex?: number;
 }
 /**
- * Choose between `"inline"`, `"overlay"`, or `"modal" `types.
+ * Choose between `"inline"`, `"overlay"`, or `"modal"` positions.
  *
- * ![Visualization of different types](https://wxt.dev/content-script-ui-type.png)
+ * ![Visualization of different types](https://wxt.dev/content-script-ui-position.png)
  */
 export type ContentScriptPositioningOptions = ContentScriptInlinePositioningOptions | ContentScriptOverlayPositioningOptions | ContentScriptModalPositioningOptions;
 export interface ContentScriptAnchoredOptions {

package/dist/core/builders/vite/index.mjs

@@ -11,7 +11,7 @@ import { ViteNodeRunner } from "vite-node/client";
 import { installSourcemapsSupport } from "vite-node/source-map";
 export async function createViteBuilder(wxtConfig, hooks, server) {
   const vite = await import("vite");
-  const getBaseConfig = async () => {
+  const getBaseConfig = async (baseConfigOptions) => {
     const config = await wxtConfig.vite(wxtConfig.env);
     config.root = wxtConfig.root;
     config.configFile = false;
@@ -42,7 +42,9 @@ export async function createViteBuilder(wxtConfig, hooks, server) {
       wxtPlugins.wxtPluginLoader(wxtConfig),
       wxtPlugins.resolveAppConfig(wxtConfig)
     );
-    if (wxtConfig.analysis.enabled) {
+    if (wxtConfig.analysis.enabled && // If included, vite-node entrypoint loader will increment the
+    // bundleAnalysis's internal build index tracker, which we don't want
+    !baseConfigOptions?.excludeAnalysisPlugin) {
       config.plugins.push(wxtPlugins.bundleAnalysis(wxtConfig));
     }
     return config;
@@ -157,29 +159,15 @@ export async function createViteBuilder(wxtConfig, hooks, server) {
     name: "Vite",
     version: vite.version,
     async importEntrypoint(path) {
-      switch (wxtConfig.experimental.entrypointImporter) {
+      switch (wxtConfig.entrypointLoader) {
         default:
         case "jiti": {
           return await importEntrypointFile(path);
         }
-        case "vite-runtime": {
-          const baseConfig = await getBaseConfig();
-          const envConfig = {
-            plugins: [
-              wxtPlugins.extensionApiMock(wxtConfig),
-              wxtPlugins.removeEntrypointMainFunction(wxtConfig, path)
-            ]
-          };
-          const config = vite.mergeConfig(baseConfig, envConfig);
-          const server2 = await vite.createServer(config);
-          await server2.listen();
-          const runtime = await vite.createViteRuntime(server2, { hmr: false });
-          const module = await runtime.executeUrl(path);
-          await server2.close();
-          return module.default;
-        }
         case "vite-node": {
-          const baseConfig = await getBaseConfig();
+          const baseConfig = await getBaseConfig({
+            excludeAnalysisPlugin: true
+          });
           baseConfig.optimizeDeps ??= {};
           baseConfig.optimizeDeps.noDiscovery = true;
           baseConfig.optimizeDeps.include = [];

package/dist/core/utils/building/generate-wxt-dir.mjs

@@ -40,13 +40,15 @@ export async function generateTypesDir(entrypoints) {
   );
 }
 async function getPathsDeclarationEntry(entrypoints) {
-  const unions = entrypoints.map(
+  const paths = entrypoints.map(
     (entry) => getEntrypointBundlePath(
       entry,
       wxt.config.outDir,
       isHtmlEntrypoint(entry) ? ".html" : ".js"
     )
-  ).concat(await getPublicFiles()).map(normalizePath).map((path2) => `    | "/${path2}"`).sort().join("\n");
+  ).concat(await getPublicFiles());
+  await wxt.hooks.callHook("prepare:publicPaths", wxt, paths);
+  const unions = paths.map(normalizePath).sort().map((path2) => `    | "/${path2}"`).join("\n");
   const template = `// Generated by wxt
 import "${wxt.config.browserModule}";
 

package/dist/core/utils/building/resolve-config.mjs

@@ -135,9 +135,8 @@ export async function resolveConfig(inlineConfig, command) {
     alias,
     extensionApi,
     browserModule: extensionApi === "chrome" ? "wxt/browser/chrome" : "wxt/browser",
-    experimental: defu(mergedConfig.experimental, {
-      entrypointImporter: "jiti"
-    }),
+    entrypointLoader: mergedConfig.entrypointLoader ?? "vite-node",
+    experimental: defu(mergedConfig.experimental, {}),
     dev: {
       server: devServerConfig,
       reloadCommand

package/dist/core/utils/testing/fake-objects.d.ts

@@ -487,9 +487,7 @@ export declare const fakeResolvedConfig: (overrides?: {
                 root?: string;
                 mode?: string;
                 publicDir?: string;
-                experimental?: {
-                    entrypointImporter?: "jiti" | "vite-runtime" | "vite-node";
-                } | undefined;
+                experimental?: {} | undefined;
                 srcDir?: string;
                 entrypointsDir?: string;
                 modulesDir?: string;
@@ -664,6 +662,7 @@ export declare const fakeResolvedConfig: (overrides?: {
                     [x: string]: string | undefined;
                 } | undefined;
                 extensionApi?: "webextension-polyfill" | "chrome";
+                entrypointLoader?: "vite-node" | "jiti";
                 dev?: {
                     server?: {
                         port?: number;
@@ -676,6 +675,7 @@ export declare const fakeResolvedConfig: (overrides?: {
                     'vite:devServer:extendConfig'?: {} | undefined;
                     ready?: {} | undefined;
                     'prepare:types'?: {} | undefined;
+                    'prepare:publicPaths'?: {} | undefined;
                     'build:before'?: {} | undefined;
                     'build:done'?: {} | undefined;
                     'build:manifestGenerated'?: {} | undefined;
@@ -720,8 +720,10 @@ export declare const fakeResolvedConfig: (overrides?: {
                     } | undefined;
                     prepare?: {
                         types?: {} | undefined;
+                        publicPaths?: {} | undefined;
                     } | {
                         types?: {} | undefined;
+                        publicPaths?: {} | undefined;
                     } | undefined;
                     entrypoints?: {
                         resolved?: {} | undefined;
@@ -769,8 +771,10 @@ export declare const fakeResolvedConfig: (overrides?: {
                     } | undefined;
                     prepare?: {
                         types?: {} | undefined;
+                        publicPaths?: {} | undefined;
                     } | {
                         types?: {} | undefined;
+                        publicPaths?: {} | undefined;
                     } | undefined;
                     entrypoints?: {
                         resolved?: {} | undefined;
@@ -805,9 +809,7 @@ export declare const fakeResolvedConfig: (overrides?: {
                     root?: string;
                     mode?: string;
                     publicDir?: string;
-                    experimental?: {
-                        entrypointImporter?: "jiti" | "vite-runtime" | "vite-node";
-                    } | undefined;
+                    experimental?: {} | undefined;
                     srcDir?: string;
                     entrypointsDir?: string;
                     modulesDir?: string;
@@ -982,6 +984,7 @@ export declare const fakeResolvedConfig: (overrides?: {
                         [x: string]: string | undefined;
                     } | undefined;
                     extensionApi?: "webextension-polyfill" | "chrome";
+                    entrypointLoader?: "vite-node" | "jiti";
                     dev?: {
                         server?: {
                             port?: number;
@@ -994,6 +997,7 @@ export declare const fakeResolvedConfig: (overrides?: {
                         'vite:devServer:extendConfig'?: {} | undefined;
                         ready?: {} | undefined;
                         'prepare:types'?: {} | undefined;
+                        'prepare:publicPaths'?: {} | undefined;
                         'build:before'?: {} | undefined;
                         'build:done'?: {} | undefined;
                         'build:manifestGenerated'?: {} | undefined;
@@ -1038,8 +1042,10 @@ export declare const fakeResolvedConfig: (overrides?: {
                         } | undefined;
                         prepare?: {
                             types?: {} | undefined;
+                            publicPaths?: {} | undefined;
                         } | {
                             types?: {} | undefined;
+                            publicPaths?: {} | undefined;
                         } | undefined;
                         entrypoints?: {
                             resolved?: {} | undefined;
@@ -1087,8 +1093,10 @@ export declare const fakeResolvedConfig: (overrides?: {
                         } | undefined;
                         prepare?: {
                             types?: {} | undefined;
+                            publicPaths?: {} | undefined;
                         } | {
                             types?: {} | undefined;
+                            publicPaths?: {} | undefined;
                         } | undefined;
                         entrypoints?: {
                             resolved?: {} | undefined;
@@ -1149,9 +1157,7 @@ export declare const fakeResolvedConfig: (overrides?: {
                 root?: string;
                 mode?: string;
                 publicDir?: string;
-                experimental?: {
-                    entrypointImporter?: "jiti" | "vite-runtime" | "vite-node";
-                } | undefined;
+                experimental?: {} | undefined;
                 srcDir?: string;
                 entrypointsDir?: string;
                 modulesDir?: string;
@@ -1326,6 +1332,7 @@ export declare const fakeResolvedConfig: (overrides?: {
                     [x: string]: string | undefined;
                 } | undefined;
                 extensionApi?: "webextension-polyfill" | "chrome";
+                entrypointLoader?: "vite-node" | "jiti";
                 dev?: {
                     server?: {
                         port?: number;
@@ -1338,6 +1345,7 @@ export declare const fakeResolvedConfig: (overrides?: {
                     'vite:devServer:extendConfig'?: {} | undefined;
                     ready?: {} | undefined;
                     'prepare:types'?: {} | undefined;
+                    'prepare:publicPaths'?: {} | undefined;
                     'build:before'?: {} | undefined;
                     'build:done'?: {} | undefined;
                     'build:manifestGenerated'?: {} | undefined;
@@ -1382,8 +1390,10 @@ export declare const fakeResolvedConfig: (overrides?: {
                     } | undefined;
                     prepare?: {
                         types?: {} | undefined;
+                        publicPaths?: {} | undefined;
                     } | {
                         types?: {} | undefined;
+                        publicPaths?: {} | undefined;
                     } | undefined;
                     entrypoints?: {
                         resolved?: {} | undefined;
@@ -1431,8 +1441,10 @@ export declare const fakeResolvedConfig: (overrides?: {
                     } | undefined;
                     prepare?: {
                         types?: {} | undefined;
+                        publicPaths?: {} | undefined;
                     } | {
                         types?: {} | undefined;
+                        publicPaths?: {} | undefined;
                     } | undefined;
                     entrypoints?: {
                         resolved?: {} | undefined;
@@ -1470,9 +1482,8 @@ export declare const fakeResolvedConfig: (overrides?: {
     } | undefined;
     extensionApi?: "webextension-polyfill" | "chrome" | undefined;
     browserModule?: "wxt/browser" | "wxt/browser/chrome" | undefined;
-    experimental?: {
-        entrypointImporter?: "jiti" | "vite-runtime" | "vite-node" | undefined;
-    } | undefined;
+    entrypointLoader?: "vite-node" | "jiti" | undefined;
+    experimental?: {} | undefined;
     dev?: {
         server?: {
             port?: number | undefined;
@@ -1485,6 +1496,7 @@ export declare const fakeResolvedConfig: (overrides?: {
         'vite:devServer:extendConfig'?: {} | undefined;
         ready?: {} | undefined;
         'prepare:types'?: {} | undefined;
+        'prepare:publicPaths'?: {} | undefined;
         'build:before'?: {} | undefined;
         'build:done'?: {} | undefined;
         'build:manifestGenerated'?: {} | undefined;
@@ -1529,8 +1541,10 @@ export declare const fakeResolvedConfig: (overrides?: {
         } | undefined;
         prepare?: {
             types?: {} | undefined;
+            publicPaths?: {} | undefined;
         } | {
             types?: {} | undefined;
+            publicPaths?: {} | undefined;
         } | undefined;
         entrypoints?: {
             resolved?: {} | undefined;
@@ -1578,8 +1592,10 @@ export declare const fakeResolvedConfig: (overrides?: {
         } | undefined;
         prepare?: {
             types?: {} | undefined;
+            publicPaths?: {} | undefined;
         } | {
             types?: {} | undefined;
+            publicPaths?: {} | undefined;
         } | undefined;
         entrypoints?: {
             resolved?: {} | undefined;
@@ -1617,6 +1633,7 @@ export declare const fakeResolvedConfig: (overrides?: {
             'vite:devServer:extendConfig'?: {} | undefined;
             ready?: {} | undefined;
             'prepare:types'?: {} | undefined;
+            'prepare:publicPaths'?: {} | undefined;
             'build:before'?: {} | undefined;
             'build:done'?: {} | undefined;
             'build:manifestGenerated'?: {} | undefined;
@@ -1655,6 +1672,7 @@ export declare const fakeResolvedConfig: (overrides?: {
             'vite:devServer:extendConfig'?: {} | undefined;
             ready?: {} | undefined;
             'prepare:types'?: {} | undefined;
+            'prepare:publicPaths'?: {} | undefined;
             'build:before'?: {} | undefined;
             'build:done'?: {} | undefined;
             'build:manifestGenerated'?: {} | undefined;
@@ -2025,9 +2043,7 @@ export declare const fakeWxt: (overrides?: {
                     root?: string;
                     mode?: string;
                     publicDir?: string;
-                    experimental?: {
-                        entrypointImporter?: "jiti" | "vite-runtime" | "vite-node";
-                    } | undefined;
+                    experimental?: {} | undefined;
                     srcDir?: string;
                     entrypointsDir?: string;
                     modulesDir?: string;
@@ -2202,6 +2218,7 @@ export declare const fakeWxt: (overrides?: {
                         [x: string]: string | undefined;
                     } | undefined;
                     extensionApi?: "webextension-polyfill" | "chrome";
+                    entrypointLoader?: "vite-node" | "jiti";
                     dev?: {
                         server?: {
                             port?: number;
@@ -2214,6 +2231,7 @@ export declare const fakeWxt: (overrides?: {
                         'vite:devServer:extendConfig'?: {} | undefined;
                         ready?: {} | undefined;
                         'prepare:types'?: {} | undefined;
+                        'prepare:publicPaths'?: {} | undefined;
                         'build:before'?: {} | undefined;
                         'build:done'?: {} | undefined;
                         'build:manifestGenerated'?: {} | undefined;
@@ -2258,8 +2276,10 @@ export declare const fakeWxt: (overrides?: {
                         } | undefined;
                         prepare?: {
                             types?: {} | undefined;
+                            publicPaths?: {} | undefined;
                         } | {
                             types?: {} | undefined;
+                            publicPaths?: {} | undefined;
                         } | undefined;
                         entrypoints?: {
                             resolved?: {} | undefined;
@@ -2307,8 +2327,10 @@ export declare const fakeWxt: (overrides?: {
                         } | undefined;
                         prepare?: {
                             types?: {} | undefined;
+                            publicPaths?: {} | undefined;
                         } | {
                             types?: {} | undefined;
+                            publicPaths?: {} | undefined;
                         } | undefined;
                         entrypoints?: {
                             resolved?: {} | undefined;
@@ -2343,9 +2365,7 @@ export declare const fakeWxt: (overrides?: {
                         root?: string;
                         mode?: string;
                         publicDir?: string;
-                        experimental?: {
-                            entrypointImporter?: "jiti" | "vite-runtime" | "vite-node";
-                        } | undefined;
+                        experimental?: {} | undefined;
                         srcDir?: string;
                         entrypointsDir?: string;
                         modulesDir?: string;
@@ -2520,6 +2540,7 @@ export declare const fakeWxt: (overrides?: {
                             [x: string]: string | undefined;
                         } | undefined;
                         extensionApi?: "webextension-polyfill" | "chrome";
+                        entrypointLoader?: "vite-node" | "jiti";
                         dev?: {
                             server?: {
                                 port?: number;
@@ -2532,6 +2553,7 @@ export declare const fakeWxt: (overrides?: {
                             'vite:devServer:extendConfig'?: {} | undefined;
                             ready?: {} | undefined;
                             'prepare:types'?: {} | undefined;
+                            'prepare:publicPaths'?: {} | undefined;
                             'build:before'?: {} | undefined;
                             'build:done'?: {} | undefined;
                             'build:manifestGenerated'?: {} | undefined;
@@ -2576,8 +2598,10 @@ export declare const fakeWxt: (overrides?: {
                             } | undefined;
                             prepare?: {
                                 types?: {} | undefined;
+                                publicPaths?: {} | undefined;
                             } | {
                                 types?: {} | undefined;
+                                publicPaths?: {} | undefined;
                             } | undefined;
                             entrypoints?: {
                                 resolved?: {} | undefined;
@@ -2625,8 +2649,10 @@ export declare const fakeWxt: (overrides?: {
                             } | undefined;
                             prepare?: {
                                 types?: {} | undefined;
+                                publicPaths?: {} | undefined;
                             } | {
                                 types?: {} | undefined;
+                                publicPaths?: {} | undefined;
                             } | undefined;
                             entrypoints?: {
                                 resolved?: {} | undefined;
@@ -2687,9 +2713,7 @@ export declare const fakeWxt: (overrides?: {
                     root?: string;
                     mode?: string;
                     publicDir?: string;
-                    experimental?: {
-                        entrypointImporter?: "jiti" | "vite-runtime" | "vite-node";
-                    } | undefined;
+                    experimental?: {} | undefined;
                     srcDir?: string;
                     entrypointsDir?: string;
                     modulesDir?: string;
@@ -2864,6 +2888,7 @@ export declare const fakeWxt: (overrides?: {
                         [x: string]: string | undefined;
                     } | undefined;
                     extensionApi?: "webextension-polyfill" | "chrome";
+                    entrypointLoader?: "vite-node" | "jiti";
                     dev?: {
                         server?: {
                             port?: number;
@@ -2876,6 +2901,7 @@ export declare const fakeWxt: (overrides?: {
                         'vite:devServer:extendConfig'?: {} | undefined;
                         ready?: {} | undefined;
                         'prepare:types'?: {} | undefined;
+                        'prepare:publicPaths'?: {} | undefined;
                         'build:before'?: {} | undefined;
                         'build:done'?: {} | undefined;
                         'build:manifestGenerated'?: {} | undefined;
@@ -2920,8 +2946,10 @@ export declare const fakeWxt: (overrides?: {
                         } | undefined;
                         prepare?: {
                             types?: {} | undefined;
+                            publicPaths?: {} | undefined;
                         } | {
                             types?: {} | undefined;
+                            publicPaths?: {} | undefined;
                         } | undefined;
                         entrypoints?: {
                             resolved?: {} | undefined;
@@ -2969,8 +2997,10 @@ export declare const fakeWxt: (overrides?: {
                         } | undefined;
                         prepare?: {
                             types?: {} | undefined;
+                            publicPaths?: {} | undefined;
                         } | {
                             types?: {} | undefined;
+                            publicPaths?: {} | undefined;
                         } | undefined;
                         entrypoints?: {
                             resolved?: {} | undefined;
@@ -3008,9 +3038,8 @@ export declare const fakeWxt: (overrides?: {
         } | undefined;
         extensionApi?: "webextension-polyfill" | "chrome" | undefined;
         browserModule?: "wxt/browser" | "wxt/browser/chrome" | undefined;
-        experimental?: {
-            entrypointImporter?: "jiti" | "vite-runtime" | "vite-node" | undefined;
-        } | undefined;
+        entrypointLoader?: "vite-node" | "jiti" | undefined;
+        experimental?: {} | undefined;
         dev?: {
             server?: {
                 port?: number | undefined;
@@ -3023,6 +3052,7 @@ export declare const fakeWxt: (overrides?: {
             'vite:devServer:extendConfig'?: {} | undefined;
             ready?: {} | undefined;
             'prepare:types'?: {} | undefined;
+            'prepare:publicPaths'?: {} | undefined;
             'build:before'?: {} | undefined;
             'build:done'?: {} | undefined;
             'build:manifestGenerated'?: {} | undefined;
@@ -3067,8 +3097,10 @@ export declare const fakeWxt: (overrides?: {
             } | undefined;
             prepare?: {
                 types?: {} | undefined;
+                publicPaths?: {} | undefined;
             } | {
                 types?: {} | undefined;
+                publicPaths?: {} | undefined;
             } | undefined;
             entrypoints?: {
                 resolved?: {} | undefined;
@@ -3116,8 +3148,10 @@ export declare const fakeWxt: (overrides?: {
             } | undefined;
             prepare?: {
                 types?: {} | undefined;
+                publicPaths?: {} | undefined;
             } | {
                 types?: {} | undefined;
+                publicPaths?: {} | undefined;
             } | undefined;
             entrypoints?: {
                 resolved?: {} | undefined;
@@ -3155,6 +3189,7 @@ export declare const fakeWxt: (overrides?: {
                 'vite:devServer:extendConfig'?: {} | undefined;
                 ready?: {} | undefined;
                 'prepare:types'?: {} | undefined;
+                'prepare:publicPaths'?: {} | undefined;
                 'build:before'?: {} | undefined;
                 'build:done'?: {} | undefined;
                 'build:manifestGenerated'?: {} | undefined;
@@ -3193,6 +3228,7 @@ export declare const fakeWxt: (overrides?: {
                 'vite:devServer:extendConfig'?: {} | undefined;
                 ready?: {} | undefined;
                 'prepare:types'?: {} | undefined;
+                'prepare:publicPaths'?: {} | undefined;
                 'build:before'?: {} | undefined;
                 'build:done'?: {} | undefined;
                 'build:manifestGenerated'?: {} | undefined;

package/dist/core/utils/testing/fake-objects.mjs

@@ -248,9 +248,8 @@ export const fakeResolvedConfig = fakeObjectCreator(() => {
     alias: {},
     extensionApi: "webextension-polyfill",
     browserModule: "wxt/browser",
-    experimental: {
-      entrypointImporter: "jiti"
-    },
+    entrypointLoader: "vite-node",
+    experimental: {},
     dev: {
       reloadCommand: "Alt+R"
     },

package/dist/storage.d.ts

@@ -109,7 +109,14 @@ export interface WxtStorage {
     defineItem<TValue, TMetadata extends Record<string, unknown> = {}>(key: StorageItemKey, options: WxtStorageItemOptions<TValue>): WxtStorageItem<TValue, TMetadata>;
 }
 export interface WxtStorageItem<TValue, TMetadata extends Record<string, unknown>> {
+    /**
+     * @deprecated Renamed to `fallback`, use it instead.
+     */
     defaultValue: TValue;
+    /**
+     * The value provided by the `fallback` option.
+     */
+    fallback: TValue;
     /**
      * Get the latest value from storage.
      */
@@ -150,9 +157,13 @@ export type StorageArea = 'local' | 'session' | 'sync' | 'managed';
 export type StorageItemKey = `${StorageArea}:${string}`;
 export interface GetItemOptions<T> {
     /**
-     * Value returned from `getValue` when it would otherwise return null.
+     * @deprecated Renamed to `fallback`, use it instead.
      */
     defaultValue?: T;
+    /**
+     * Default value returned when `getItem` would otherwise return `null`.
+     */
+    fallback?: T;
 }
 export interface RemoveItemOptions {
     /**
@@ -170,7 +181,21 @@ export interface SnapshotOptions {
     excludeKeys?: string[];
 }
 export interface WxtStorageItemOptions<T> {
-    defaultValue: T;
+    /**
+     * @deprecated Renamed to `fallback`, use it instead.
+     */
+    defaultValue?: T;
+    /**
+     * Default value returned when `getValue` would otherwise return `null`.
+     */
+    fallback?: T;
+    /**
+     * If passed, a value in storage will be initialized immediately after
+     * defining the storage item. This function returns the value that will be
+     * saved to storage during the initialization process if a value doesn't
+     * already exist.
+     */
+    init?: () => T | Promise<T>;
     /**
      * Provide a version number for the storage item to enable migrations. When changing the version
      * in the future, migration functions will be ran on application startup.

package/dist/storage.mjs

@@ -2,6 +2,7 @@ import { browser } from "wxt/browser";
 import { dequal } from "dequal/lite";
 import { logger } from "./sandbox/utils/logger.mjs";
 import { toArray } from "./core/utils/arrays.mjs";
+import { Mutex } from "async-mutex";
 export const storage = createStorage();
 function createStorage() {
   const drivers = {
@@ -33,11 +34,11 @@ function createStorage() {
     };
   };
   const getMetaKey = (key) => key + "$";
-  const getValueOrDefault = (value, defaultValue) => value ?? defaultValue ?? null;
+  const getValueOrFallback = (value, fallback) => value ?? fallback ?? null;
   const getMetaValue = (properties) => typeof properties === "object" && !Array.isArray(properties) ? properties : {};
   const getItem = async (driver, driverKey, opts) => {
     const res = await driver.getItem(driverKey);
-    return getValueOrDefault(res, opts?.defaultValue);
+    return getValueOrFallback(res, opts?.fallback ?? opts?.defaultValue);
   };
   const getMeta = async (driver, driverKey) => {
     const metaKey = getMetaKey(driverKey);
@@ -107,9 +108,10 @@ function createStorage() {
           const driverResults = await drivers[driverArea].getItems(keys2);
           return driverResults.map((driverResult) => {
             const key = `${driverArea}:${driverResult.key}`;
-            const value = getValueOrDefault(
+            const opts = keyToOptsMap.get(key);
+            const value = getValueOrFallback(
               driverResult.value,
-              keyToOptsMap.get(key)?.defaultValue
+              opts?.fallback ?? opts?.defaultValue
             );
             return { key, value };
           });
@@ -248,14 +250,30 @@ function createStorage() {
       const migrationsDone = opts?.migrations == null ? Promise.resolve() : migrate().catch((err) => {
         logger.error(`Migration failed for ${key}`, err);
       });
-      const getDefaultValue = () => opts?.defaultValue ?? null;
+      const initMutex = new Mutex();
+      const getFallback = () => opts?.fallback ?? opts?.defaultValue ?? null;
+      const getOrInitValue = () => initMutex.runExclusive(async () => {
+        const value = await driver.getItem(driverKey);
+        if (value != null || opts?.init == null) return value;
+        const newValue = await opts.init();
+        await driver.setItem(driverKey, newValue);
+        return newValue;
+      });
+      migrationsDone.then(getOrInitValue);
       return {
         get defaultValue() {
-          return getDefaultValue();
+          return getFallback();
+        },
+        get fallback() {
+          return getFallback();
         },
         getValue: async () => {
           await migrationsDone;
-          return await getItem(driver, driverKey, opts);
+          if (opts?.init) {
+            return await getOrInitValue();
+          } else {
+            return await getItem(driver, driverKey, opts);
+          }
         },
         getMeta: async () => {
           await migrationsDone;
@@ -280,7 +298,7 @@ function createStorage() {
         watch: (cb) => watch(
           driver,
           driverKey,
-          (newValue, oldValue) => cb(newValue ?? getDefaultValue(), oldValue ?? getDefaultValue())
+          (newValue, oldValue) => cb(newValue ?? getFallback(), oldValue ?? getFallback())
         ),
         migrate
       };

package/dist/types.d.ts

@@ -297,25 +297,27 @@ export interface InlineConfig {
      * - `"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?: {
-        /**
-         * 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.
      */
@@ -941,6 +943,20 @@ export 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.
      *
@@ -948,7 +964,9 @@ export 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
      */
@@ -1079,9 +1097,8 @@ export interface ResolvedConfig {
     alias: Record<string, string>;
     extensionApi: 'webextension-polyfill' | 'chrome';
     browserModule: 'wxt/browser' | 'wxt/browser/chrome';
-    experimental: {
-        entrypointImporter: 'jiti' | 'vite-runtime' | 'vite-node';
-    };
+    entrypointLoader: 'vite-node' | 'jiti';
+    experimental: {};
     dev: {
         /** Only defined during dev command */
         server?: {

package/dist/version.mjs

@@ -1 +1 @@
-export const version = "0.19.0-alpha1";
+export const version = "0.19.0";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "wxt",
   "type": "module",
-  "version": "0.19.0-alpha1",
+  "version": "0.19.0",
   "description": "Next gen framework for developing web extensions",
   "repository": {
     "type": "git",
@@ -53,10 +53,6 @@
       "types": "./dist/browser/chrome.d.ts",
       "import": "./dist/browser/chrome.mjs"
     },
-    "./browser/webextension-polyfill": {
-      "types": "./dist/browser/webextension-polyfill.d.ts",
-      "import": "./dist/browser/webextension-polyfill.mjs"
-    },
     "./testing": {
       "types": "./dist/testing/index.d.ts",
       "default": "./dist/testing/index.mjs"

package/dist/browser/webextension-polyfill.d.ts

@@ -1,18 +0,0 @@
-/**
- * Includes the `browser` API and types when using `extensionApi: 'webextension-polyfill'` (the default).
- *
- * @module wxt/browser/webextension-polyfill
- */
-import { Browser, Runtime, I18n } from 'webextension-polyfill';
-export interface AugmentedBrowser extends Browser {
-    runtime: WxtRuntime;
-    i18n: WxtI18n;
-}
-export interface WxtRuntime extends Runtime.Static {
-}
-export interface WxtI18n extends I18n.Static {
-}
-export declare const browser: AugmentedBrowser;
-/** @ignore */
-export type { ActivityLog, Alarms, Bookmarks, Action, BrowserAction, BrowserSettings, BrowsingData, CaptivePortal, Clipboard, Commands, ContentScripts, ContextualIdentities, Cookies, DeclarativeNetRequest, Devtools, Dns, Downloads, Events, Experiments, Extension, ExtensionTypes, Find, GeckoProfiler, History, I18n, Identity, Idle, Management, Manifest, // TODO: Export custom manifest types that are valid for both Chrome and Firefox.
-ContextMenus, Menus, NetworkStatus, NormandyAddonStudy, Notifications, Omnibox, PageAction, Permissions, Pkcs11, Privacy, Proxy, Runtime, Scripting, Search, Sessions, SidebarAction, Storage, Tabs, Theme, TopSites, Types, Urlbar, UserScripts, WebNavigation, WebRequest, Windows, } from 'webextension-polyfill';

package/dist/browser/webextension-polyfill.mjs

@@ -1,2 +0,0 @@
-import originalBrowser from "webextension-polyfill";
-export const browser = originalBrowser;