wxt 0.19.14 → 0.19.16

package/dist/builtin-modules/unimport.mjs

@@ -7,7 +7,7 @@ export default defineWxtModule({
     const options = wxt.config.imports;
     if (options === false) return;
     let unimport;
-    wxt.hooks.hook("ready", () => {
+    wxt.hooks.hook("config:resolved", () => {
       const addModuleImports = (module) => {
         if (!module.imports) return;
         options.imports ??= [];
@@ -17,7 +17,7 @@ export default defineWxtModule({
       wxt.config.userModules.forEach(addModuleImports);
     });
     wxt.hooks.afterEach((event) => {
-      if (event.name === "ready") {
+      if (event.name === "config:resolved") {
         unimport = createUnimport(options);
       }
     });

package/dist/client/content-scripts/content-script-context.mjs

@@ -14,7 +14,9 @@ export class ContentScriptContext {
       this.listenForNewerScripts();
     }
   }
-  static SCRIPT_STARTED_MESSAGE_TYPE = "wxt:content-script-started";
+  static SCRIPT_STARTED_MESSAGE_TYPE = getUniqueEventName(
+    "wxt:content-script-started"
+  );
   isTopFrame = window.self === window.top;
   abortController;
   locationWatcher = createLocationWatcher(this);

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

@@ -43,7 +43,7 @@ async function getPathsDeclarationEntry(entrypoints) {
       wxt.config.outDir,
       isHtmlEntrypoint(entry) ? ".html" : ".js"
     )
-  ).concat(await getPublicFiles());
+  ).concat([""]).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
@@ -125,7 +125,7 @@ ${commentLines.map((line) => `     * ${line}`.trimEnd()).join("\n")}
         message.message
       )
     ),
-    // Include a final union-based override so TS accepts valid string templates or concatinations
+    // Include a final union-based override so TS accepts valid string templates or concatenations
     // ie: browser.i18n.getMessage(`some_enum_${enumValue}`)
     renderGetMessageOverload(
       messages.map((message) => `"${message.name}"`).join(" | ")

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

@@ -1570,6 +1570,7 @@ export declare const fakeResolvedConfig: (overrides?: {
                     'vite:build:extendConfig'?: {} | undefined;
                     'vite:devServer:extendConfig'?: {} | undefined;
                     ready?: {} | undefined;
+                    'config:resolved'?: {} | undefined;
                     'prepare:types'?: {} | undefined;
                     'prepare:publicPaths'?: {} | undefined;
                     'build:before'?: {} | undefined;
@@ -1620,6 +1621,11 @@ export declare const fakeResolvedConfig: (overrides?: {
                             extendConfig?: {} | undefined;
                         } | undefined;
                     } | undefined;
+                    config?: {
+                        resolved?: {} | undefined;
+                    } | {
+                        resolved?: {} | undefined;
+                    } | undefined;
                     prepare?: {
                         types?: {} | undefined;
                         publicPaths?: {} | undefined;
@@ -1710,6 +1716,11 @@ export declare const fakeResolvedConfig: (overrides?: {
                             extendConfig?: {} | undefined;
                         } | undefined;
                     } | undefined;
+                    config?: {
+                        resolved?: {} | undefined;
+                    } | {
+                        resolved?: {} | undefined;
+                    } | undefined;
                     prepare?: {
                         types?: {} | undefined;
                         publicPaths?: {} | undefined;
@@ -2279,6 +2290,7 @@ export declare const fakeResolvedConfig: (overrides?: {
                         'vite:build:extendConfig'?: {} | undefined;
                         'vite:devServer:extendConfig'?: {} | undefined;
                         ready?: {} | undefined;
+                        'config:resolved'?: {} | undefined;
                         'prepare:types'?: {} | undefined;
                         'prepare:publicPaths'?: {} | undefined;
                         'build:before'?: {} | undefined;
@@ -2329,6 +2341,11 @@ export declare const fakeResolvedConfig: (overrides?: {
                                 extendConfig?: {} | undefined;
                             } | undefined;
                         } | undefined;
+                        config?: {
+                            resolved?: {} | undefined;
+                        } | {
+                            resolved?: {} | undefined;
+                        } | undefined;
                         prepare?: {
                             types?: {} | undefined;
                             publicPaths?: {} | undefined;
@@ -2419,6 +2436,11 @@ export declare const fakeResolvedConfig: (overrides?: {
                                 extendConfig?: {} | undefined;
                             } | undefined;
                         } | undefined;
+                        config?: {
+                            resolved?: {} | undefined;
+                        } | {
+                            resolved?: {} | undefined;
+                        } | undefined;
                         prepare?: {
                             types?: {} | undefined;
                             publicPaths?: {} | undefined;
@@ -3014,6 +3036,7 @@ export declare const fakeResolvedConfig: (overrides?: {
                     'vite:build:extendConfig'?: {} | undefined;
                     'vite:devServer:extendConfig'?: {} | undefined;
                     ready?: {} | undefined;
+                    'config:resolved'?: {} | undefined;
                     'prepare:types'?: {} | undefined;
                     'prepare:publicPaths'?: {} | undefined;
                     'build:before'?: {} | undefined;
@@ -3064,6 +3087,11 @@ export declare const fakeResolvedConfig: (overrides?: {
                             extendConfig?: {} | undefined;
                         } | undefined;
                     } | undefined;
+                    config?: {
+                        resolved?: {} | undefined;
+                    } | {
+                        resolved?: {} | undefined;
+                    } | undefined;
                     prepare?: {
                         types?: {} | undefined;
                         publicPaths?: {} | undefined;
@@ -3154,6 +3182,11 @@ export declare const fakeResolvedConfig: (overrides?: {
                             extendConfig?: {} | undefined;
                         } | undefined;
                     } | undefined;
+                    config?: {
+                        resolved?: {} | undefined;
+                    } | {
+                        resolved?: {} | undefined;
+                    } | undefined;
                     prepare?: {
                         types?: {} | undefined;
                         publicPaths?: {} | undefined;
@@ -3249,6 +3282,7 @@ export declare const fakeResolvedConfig: (overrides?: {
         'vite:build:extendConfig'?: {} | undefined;
         'vite:devServer:extendConfig'?: {} | undefined;
         ready?: {} | undefined;
+        'config:resolved'?: {} | undefined;
         'prepare:types'?: {} | undefined;
         'prepare:publicPaths'?: {} | undefined;
         'build:before'?: {} | undefined;
@@ -3299,6 +3333,11 @@ export declare const fakeResolvedConfig: (overrides?: {
                 extendConfig?: {} | undefined;
             } | undefined;
         } | undefined;
+        config?: {
+            resolved?: {} | undefined;
+        } | {
+            resolved?: {} | undefined;
+        } | undefined;
         prepare?: {
             types?: {} | undefined;
             publicPaths?: {} | undefined;
@@ -3389,6 +3428,11 @@ export declare const fakeResolvedConfig: (overrides?: {
                 extendConfig?: {} | undefined;
             } | undefined;
         } | undefined;
+        config?: {
+            resolved?: {} | undefined;
+        } | {
+            resolved?: {} | undefined;
+        } | undefined;
         prepare?: {
             types?: {} | undefined;
             publicPaths?: {} | undefined;
@@ -3470,6 +3514,7 @@ export declare const fakeResolvedConfig: (overrides?: {
             'vite:build:extendConfig'?: {} | undefined;
             'vite:devServer:extendConfig'?: {} | undefined;
             ready?: {} | undefined;
+            'config:resolved'?: {} | undefined;
             'prepare:types'?: {} | undefined;
             'prepare:publicPaths'?: {} | undefined;
             'build:before'?: {} | undefined;
@@ -3520,6 +3565,11 @@ export declare const fakeResolvedConfig: (overrides?: {
                     extendConfig?: {} | undefined;
                 } | undefined;
             } | undefined;
+            config?: {
+                resolved?: {} | undefined;
+            } | {
+                resolved?: {} | undefined;
+            } | undefined;
             prepare?: {
                 types?: {} | undefined;
                 publicPaths?: {} | undefined;
@@ -3610,6 +3660,11 @@ export declare const fakeResolvedConfig: (overrides?: {
                     extendConfig?: {} | undefined;
                 } | undefined;
             } | undefined;
+            config?: {
+                resolved?: {} | undefined;
+            } | {
+                resolved?: {} | undefined;
+            } | undefined;
             prepare?: {
                 types?: {} | undefined;
                 publicPaths?: {} | undefined;
@@ -3695,6 +3750,7 @@ export declare const fakeResolvedConfig: (overrides?: {
             'vite:build:extendConfig'?: {} | undefined;
             'vite:devServer:extendConfig'?: {} | undefined;
             ready?: {} | undefined;
+            'config:resolved'?: {} | undefined;
             'prepare:types'?: {} | undefined;
             'prepare:publicPaths'?: {} | undefined;
             'build:before'?: {} | undefined;
@@ -3745,6 +3801,11 @@ export declare const fakeResolvedConfig: (overrides?: {
                     extendConfig?: {} | undefined;
                 } | undefined;
             } | undefined;
+            config?: {
+                resolved?: {} | undefined;
+            } | {
+                resolved?: {} | undefined;
+            } | undefined;
             prepare?: {
                 types?: {} | undefined;
                 publicPaths?: {} | undefined;
@@ -3835,6 +3896,11 @@ export declare const fakeResolvedConfig: (overrides?: {
                     extendConfig?: {} | undefined;
                 } | undefined;
             } | undefined;
+            config?: {
+                resolved?: {} | undefined;
+            } | {
+                resolved?: {} | undefined;
+            } | undefined;
             prepare?: {
                 types?: {} | undefined;
                 publicPaths?: {} | undefined;
@@ -5051,6 +5117,7 @@ export declare const fakeWxt: (overrides?: {
                         'vite:build:extendConfig'?: {} | undefined;
                         'vite:devServer:extendConfig'?: {} | undefined;
                         ready?: {} | undefined;
+                        'config:resolved'?: {} | undefined;
                         'prepare:types'?: {} | undefined;
                         'prepare:publicPaths'?: {} | undefined;
                         'build:before'?: {} | undefined;
@@ -5101,6 +5168,11 @@ export declare const fakeWxt: (overrides?: {
                                 extendConfig?: {} | undefined;
                             } | undefined;
                         } | undefined;
+                        config?: {
+                            resolved?: {} | undefined;
+                        } | {
+                            resolved?: {} | undefined;
+                        } | undefined;
                         prepare?: {
                             types?: {} | undefined;
                             publicPaths?: {} | undefined;
@@ -5191,6 +5263,11 @@ export declare const fakeWxt: (overrides?: {
                                 extendConfig?: {} | undefined;
                             } | undefined;
                         } | undefined;
+                        config?: {
+                            resolved?: {} | undefined;
+                        } | {
+                            resolved?: {} | undefined;
+                        } | undefined;
                         prepare?: {
                             types?: {} | undefined;
                             publicPaths?: {} | undefined;
@@ -5760,6 +5837,7 @@ export declare const fakeWxt: (overrides?: {
                             'vite:build:extendConfig'?: {} | undefined;
                             'vite:devServer:extendConfig'?: {} | undefined;
                             ready?: {} | undefined;
+                            'config:resolved'?: {} | undefined;
                             'prepare:types'?: {} | undefined;
                             'prepare:publicPaths'?: {} | undefined;
                             'build:before'?: {} | undefined;
@@ -5810,6 +5888,11 @@ export declare const fakeWxt: (overrides?: {
                                     extendConfig?: {} | undefined;
                                 } | undefined;
                             } | undefined;
+                            config?: {
+                                resolved?: {} | undefined;
+                            } | {
+                                resolved?: {} | undefined;
+                            } | undefined;
                             prepare?: {
                                 types?: {} | undefined;
                                 publicPaths?: {} | undefined;
@@ -5900,6 +5983,11 @@ export declare const fakeWxt: (overrides?: {
                                     extendConfig?: {} | undefined;
                                 } | undefined;
                             } | undefined;
+                            config?: {
+                                resolved?: {} | undefined;
+                            } | {
+                                resolved?: {} | undefined;
+                            } | undefined;
                             prepare?: {
                                 types?: {} | undefined;
                                 publicPaths?: {} | undefined;
@@ -6495,6 +6583,7 @@ export declare const fakeWxt: (overrides?: {
                         'vite:build:extendConfig'?: {} | undefined;
                         'vite:devServer:extendConfig'?: {} | undefined;
                         ready?: {} | undefined;
+                        'config:resolved'?: {} | undefined;
                         'prepare:types'?: {} | undefined;
                         'prepare:publicPaths'?: {} | undefined;
                         'build:before'?: {} | undefined;
@@ -6545,6 +6634,11 @@ export declare const fakeWxt: (overrides?: {
                                 extendConfig?: {} | undefined;
                             } | undefined;
                         } | undefined;
+                        config?: {
+                            resolved?: {} | undefined;
+                        } | {
+                            resolved?: {} | undefined;
+                        } | undefined;
                         prepare?: {
                             types?: {} | undefined;
                             publicPaths?: {} | undefined;
@@ -6635,6 +6729,11 @@ export declare const fakeWxt: (overrides?: {
                                 extendConfig?: {} | undefined;
                             } | undefined;
                         } | undefined;
+                        config?: {
+                            resolved?: {} | undefined;
+                        } | {
+                            resolved?: {} | undefined;
+                        } | undefined;
                         prepare?: {
                             types?: {} | undefined;
                             publicPaths?: {} | undefined;
@@ -6730,6 +6829,7 @@ export declare const fakeWxt: (overrides?: {
             'vite:build:extendConfig'?: {} | undefined;
             'vite:devServer:extendConfig'?: {} | undefined;
             ready?: {} | undefined;
+            'config:resolved'?: {} | undefined;
             'prepare:types'?: {} | undefined;
             'prepare:publicPaths'?: {} | undefined;
             'build:before'?: {} | undefined;
@@ -6780,6 +6880,11 @@ export declare const fakeWxt: (overrides?: {
                     extendConfig?: {} | undefined;
                 } | undefined;
             } | undefined;
+            config?: {
+                resolved?: {} | undefined;
+            } | {
+                resolved?: {} | undefined;
+            } | undefined;
             prepare?: {
                 types?: {} | undefined;
                 publicPaths?: {} | undefined;
@@ -6870,6 +6975,11 @@ export declare const fakeWxt: (overrides?: {
                     extendConfig?: {} | undefined;
                 } | undefined;
             } | undefined;
+            config?: {
+                resolved?: {} | undefined;
+            } | {
+                resolved?: {} | undefined;
+            } | undefined;
             prepare?: {
                 types?: {} | undefined;
                 publicPaths?: {} | undefined;
@@ -6951,6 +7061,7 @@ export declare const fakeWxt: (overrides?: {
                 'vite:build:extendConfig'?: {} | undefined;
                 'vite:devServer:extendConfig'?: {} | undefined;
                 ready?: {} | undefined;
+                'config:resolved'?: {} | undefined;
                 'prepare:types'?: {} | undefined;
                 'prepare:publicPaths'?: {} | undefined;
                 'build:before'?: {} | undefined;
@@ -7001,6 +7112,11 @@ export declare const fakeWxt: (overrides?: {
                         extendConfig?: {} | undefined;
                     } | undefined;
                 } | undefined;
+                config?: {
+                    resolved?: {} | undefined;
+                } | {
+                    resolved?: {} | undefined;
+                } | undefined;
                 prepare?: {
                     types?: {} | undefined;
                     publicPaths?: {} | undefined;
@@ -7091,6 +7207,11 @@ export declare const fakeWxt: (overrides?: {
                         extendConfig?: {} | undefined;
                     } | undefined;
                 } | undefined;
+                config?: {
+                    resolved?: {} | undefined;
+                } | {
+                    resolved?: {} | undefined;
+                } | undefined;
                 prepare?: {
                     types?: {} | undefined;
                     publicPaths?: {} | undefined;
@@ -7176,6 +7297,7 @@ export declare const fakeWxt: (overrides?: {
                 'vite:build:extendConfig'?: {} | undefined;
                 'vite:devServer:extendConfig'?: {} | undefined;
                 ready?: {} | undefined;
+                'config:resolved'?: {} | undefined;
                 'prepare:types'?: {} | undefined;
                 'prepare:publicPaths'?: {} | undefined;
                 'build:before'?: {} | undefined;
@@ -7226,6 +7348,11 @@ export declare const fakeWxt: (overrides?: {
                         extendConfig?: {} | undefined;
                     } | undefined;
                 } | undefined;
+                config?: {
+                    resolved?: {} | undefined;
+                } | {
+                    resolved?: {} | undefined;
+                } | undefined;
                 prepare?: {
                     types?: {} | undefined;
                     publicPaths?: {} | undefined;
@@ -7316,6 +7443,11 @@ export declare const fakeWxt: (overrides?: {
                         extendConfig?: {} | undefined;
                     } | undefined;
                 } | undefined;
+                config?: {
+                    resolved?: {} | undefined;
+                } | {
+                    resolved?: {} | undefined;
+                } | undefined;
                 prepare?: {
                     types?: {} | undefined;
                     publicPaths?: {} | undefined;

package/dist/core/wxt.mjs

@@ -21,6 +21,7 @@ export async function registerWxt(command, inlineConfig = {}, getServer) {
     },
     async reloadConfig() {
       wxt.config = await resolveConfig(inlineConfig, command);
+      await wxt.hooks.callHook("config:resolved", wxt);
     },
     pm,
     builder,
@@ -51,6 +52,7 @@ export async function registerWxt(command, inlineConfig = {}, getServer) {
     });
   }
   await wxt.hooks.callHook("ready", wxt);
+  await wxt.hooks.callHook("config:resolved", wxt);
 }
 export function setWxtForTesting(testInstance) {
   wxt = testInstance;

package/dist/modules.d.ts

@@ -11,7 +11,7 @@ export declare function defineWxtModule<TOptions extends WxtModuleOptions>(modul
 /**
  * Adds a TS/JS file as an entrypoint to the project. This file will be bundled
  * along with the other entrypoints.
-
+ *
  * If you're publishing the module to NPM, you should probably pre-build the
  * entrypoint and use `addPublicAssets` instead to copy pre-bundled assets into
  * the output directory. This will speed up project builds since it just has to

package/dist/modules.mjs

@@ -7,7 +7,7 @@ export function defineWxtModule(module) {
   return module;
 }
 export function addEntrypoint(wxt, entrypoint) {
-  wxt.hooks.hook("entrypoints:resolved", (wxt2, entrypoints) => {
+  wxt.hooks.hook("entrypoints:resolved", (_, entrypoints) => {
     entrypoints.push(entrypoint);
   });
 }
@@ -24,7 +24,7 @@ export function addPublicAssets(wxt, dir) {
   });
 }
 export function addViteConfig(wxt, viteConfig) {
-  wxt.hooks.hook("ready", (wxt2) => {
+  wxt.hooks.hook("config:resolved", (wxt2) => {
     const userVite = wxt2.config.vite;
     wxt2.config.vite = async (env) => {
       const fromUser = await userVite(env);
@@ -34,12 +34,12 @@ export function addViteConfig(wxt, viteConfig) {
   });
 }
 export function addWxtPlugin(wxt, plugin) {
-  wxt.hooks.hook("ready", (wxt2) => {
+  wxt.hooks.hook("config:resolved", (wxt2) => {
     wxt2.config.plugins.push(plugin);
   });
 }
 export function addImportPreset(wxt, preset) {
-  wxt.hooks.hook("ready", (wxt2) => {
+  wxt.hooks.hook("config:resolved", (wxt2) => {
     if (!wxt2.config.imports) return;
     wxt2.config.imports.presets ??= [];
     if (wxt2.config.imports.presets.includes(preset)) return;
@@ -47,12 +47,13 @@ export function addImportPreset(wxt, preset) {
   });
 }
 export function addAlias(wxt, alias, path) {
-  wxt.hooks.hook("ready", (wxt2) => {
+  wxt.hooks.hook("config:resolved", (wxt2) => {
     const target = resolve(wxt2.config.root, path);
-    if (wxt2.config.alias[alias] != null) {
+    if (wxt2.config.alias[alias] != null && wxt2.config.alias[alias] !== target) {
       wxt2.logger.warn(
         `Skipped adding alias (${alias} => ${target}) because an alias with the same name already exists: ${alias} => ${wxt2.config.alias[alias]}`
       );
+      return;
     }
     wxt2.config.alias[alias] = target;
   });

package/dist/storage.d.ts

@@ -1,263 +1,4 @@
-export declare const storage: WxtStorage;
-export interface WxtStorage {
-    /**
-     * Get an item from storage, or return `null` if it doesn't exist.
-     *
-     * @example
-     * await storage.getItem<number>("local:installDate");
-     */
-    getItem<TValue>(key: StorageItemKey, opts: GetItemOptions<TValue> & {
-        fallback: TValue;
-    }): Promise<TValue>;
-    getItem<TValue>(key: StorageItemKey, opts?: GetItemOptions<TValue>): Promise<TValue | null>;
-    /**
-     * Get multiple items from storage. The return order is guaranteed to be the same as the order
-     * requested.
-     *
-     * @example
-     * await storage.getItems(["local:installDate", "session:someCounter"]);
-     */
-    getItems(keys: Array<StorageItemKey | WxtStorageItem<any, any> | {
-        key: StorageItemKey;
-        options?: GetItemOptions<any>;
-    }>): Promise<Array<{
-        key: StorageItemKey;
-        value: any;
-    }>>;
-    /**
-     * Return an object containing metadata about the key. Object is stored at `key + "$"`. If value
-     * is not an object, it returns an empty object.
-     *
-     * @example
-     * await storage.getMeta("local:installDate");
-     */
-    getMeta<T extends Record<string, unknown>>(key: StorageItemKey): Promise<T>;
-    /**
-     * Get the metadata of multiple storage items.
-     *
-     * @param items List of keys or items to get the metadata of.
-     * @returns An array containing storage keys and their metadata.
-     */
-    getMetas(keys: Array<StorageItemKey | WxtStorageItem<any, any>>): Promise<Array<{
-        key: StorageItemKey;
-        meta: any;
-    }>>;
-    /**
-     * Set a value in storage. Setting a value to `null` or `undefined` is equivalent to calling
-     * `removeItem`.
-     *
-     * @example
-     * await storage.setItem<number>("local:installDate", Date.now());
-     */
-    setItem<T>(key: StorageItemKey, value: T | null): Promise<void>;
-    /**
-     * Set multiple values in storage. If a value is set to `null` or `undefined`, the key is removed.
-     *
-     * @example
-     * await storage.setItem([
-     *   { key: "local:installDate", value: Date.now() },
-     *   { key: "session:someCounter, value: 5 },
-     * ]);
-     */
-    setItems(values: Array<{
-        key: StorageItemKey;
-        value: any;
-    } | {
-        item: WxtStorageItem<any, any>;
-        value: any;
-    }>): Promise<void>;
-    /**
-     * Sets metadata properties. If some properties are already set, but are not included in the
-     * `properties` parameter, they will not be removed.
-     *
-     * @example
-     * await storage.setMeta("local:installDate", { appVersion });
-     */
-    setMeta<T extends Record<string, unknown>>(key: StorageItemKey, properties: T | null): Promise<void>;
-    /**
-     * Set the metadata of multiple storage items.
-     *
-     * @param items List of storage keys or items and metadata to set for each.
-     */
-    setMetas(metas: Array<{
-        key: StorageItemKey;
-        meta: Record<string, any>;
-    } | {
-        item: WxtStorageItem<any, any>;
-        meta: Record<string, any>;
-    }>): Promise<void>;
-    /**
-     * Removes an item from storage.
-     *
-     * @example
-     * await storage.removeItem("local:installDate");
-     */
-    removeItem(key: StorageItemKey, opts?: RemoveItemOptions): Promise<void>;
-    /**
-     * Remove a list of keys from storage.
-     */
-    removeItems(keys: Array<StorageItemKey | WxtStorageItem<any, any> | {
-        key: StorageItemKey;
-        options?: RemoveItemOptions;
-    } | {
-        item: WxtStorageItem<any, any>;
-        options?: RemoveItemOptions;
-    }>): Promise<void>;
-    /**
-     * Remove the entire metadata for a key, or specific properties by name.
-     *
-     * @example
-     * // Remove all metadata properties from the item
-     * await storage.removeMeta("local:installDate");
-     *
-     * // Remove only specific the "v" field
-     * await storage.removeMeta("local:installDate", "v")
-     */
-    removeMeta(key: StorageItemKey, properties?: string | string[]): Promise<void>;
-    /**
-     * Return all the items in storage.
-     */
-    snapshot(base: StorageArea, opts?: SnapshotOptions): Promise<Record<string, unknown>>;
-    /**
-     * Restores the results of `snapshot`. If new properties have been saved since the snapshot, they are
-     * not overridden. Only values existing in the snapshot are overridden.
-     */
-    restoreSnapshot(base: StorageArea, data: any): Promise<void>;
-    /**
-     * Watch for changes to a specific key in storage.
-     */
-    watch<T>(key: StorageItemKey, cb: WatchCallback<T | null>): Unwatch;
-    /**
-     * Remove all watch listeners.
-     */
-    unwatch(): void;
-    /**
-     * Define a storage item with a default value, type, or versioning.
-     *
-     * Read full docs: https://wxt.dev/guide/extension-apis/storage.html#defining-storage-items
-     */
-    defineItem<TValue, TMetadata extends Record<string, unknown> = {}>(key: StorageItemKey): WxtStorageItem<TValue | null, TMetadata>;
-    defineItem<TValue, TMetadata extends Record<string, unknown> = {}>(key: StorageItemKey, options: WxtStorageItemOptions<TValue>): WxtStorageItem<TValue, TMetadata>;
-}
-export interface WxtStorageItem<TValue, TMetadata extends Record<string, unknown>> {
-    /**
-     * The storage key passed when creating the storage item.
-     */
-    key: StorageItemKey;
-    /**
-     * @deprecated Renamed to fallback, use it instead.
-     */
-    defaultValue: TValue;
-    /**
-     * The value provided by the `fallback` option.
-     */
-    fallback: TValue;
-    /**
-     * Get the latest value from storage.
-     */
-    getValue(): Promise<TValue>;
-    /**
-     * Get metadata.
-     */
-    getMeta(): Promise<NullablePartial<TMetadata>>;
-    /**
-     * Set the value in storage.
-     */
-    setValue(value: TValue): Promise<void>;
-    /**
-     * Set metadata properties.
-     */
-    setMeta(properties: NullablePartial<TMetadata>): Promise<void>;
-    /**
-     * Remove the value from storage.
-     */
-    removeValue(opts?: RemoveItemOptions): Promise<void>;
-    /**
-     * Remove all metadata or certain properties from metadata.
-     */
-    removeMeta(properties?: string[]): Promise<void>;
-    /**
-     * Listen for changes to the value in storage.
-     */
-    watch(cb: WatchCallback<TValue>): Unwatch;
-    /**
-     * If there are migrations defined on the storage item, migrate to the latest version.
-     *
-     * **This function is ran automatically whenever the extension updates**, so you don't have to call it
-     * manually.
-     */
-    migrate(): Promise<void>;
-}
-export type StorageArea = 'local' | 'session' | 'sync' | 'managed';
-export type StorageItemKey = `${StorageArea}:${string}`;
-export interface GetItemOptions<T> {
-    /**
-     * @deprecated Renamed to `fallback`, use it instead.
-     */
-    defaultValue?: T;
-    /**
-     * Default value returned when `getItem` would otherwise return `null`.
-     */
-    fallback?: T;
-}
-export interface RemoveItemOptions {
-    /**
-     * Optionally remove metadata when deleting a key.
-     *
-     * @default false
-     */
-    removeMeta?: boolean;
-}
-export interface SnapshotOptions {
-    /**
-     * Exclude a list of keys. The storage area prefix should be removed since the snapshot is for a
-     * specific storage area already.
-     */
-    excludeKeys?: string[];
-}
-export interface WxtStorageItemOptions<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.
-     */
-    version?: number;
-    /**
-     * A map of version numbers to the functions used to migrate the data to that version.
-     */
-    migrations?: Record<number, (oldValue: any) => any>;
-}
 /**
- * Same as `Partial`, but includes `| null`. It makes all the properties of an object optional and
- * nullable.
+ * @module @wxt-dev/storage
  */
-export type NullablePartial<T> = {
-    [key in keyof T]+?: T[key] | undefined | null;
-};
-/**
- * Callback called when a value in storage is changed.
- */
-export type WatchCallback<T> = (newValue: T, oldValue: T) => void;
-/**
- * Call to remove a watch listener
- */
-export type Unwatch = () => void;
-export declare class MigrationError extends Error {
-    key: string;
-    version: number;
-    constructor(key: string, version: number, options?: ErrorOptions);
-}
+export * from '@wxt-dev/storage';

package/dist/storage.mjs

@@ -1,483 +1 @@
-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 = {
-    local: createDriver("local"),
-    session: createDriver("session"),
-    sync: createDriver("sync"),
-    managed: createDriver("managed")
-  };
-  const getDriver = (area) => {
-    const driver = drivers[area];
-    if (driver == null) {
-      const areaNames = Object.keys(drivers).join(", ");
-      throw Error(`Invalid area "${area}". Options: ${areaNames}`);
-    }
-    return driver;
-  };
-  const resolveKey = (key) => {
-    const deliminatorIndex = key.indexOf(":");
-    const driverArea = key.substring(0, deliminatorIndex);
-    const driverKey = key.substring(deliminatorIndex + 1);
-    if (driverKey == null)
-      throw Error(
-        `Storage key should be in the form of "area:key", but received "${key}"`
-      );
-    return {
-      driverArea,
-      driverKey,
-      driver: getDriver(driverArea)
-    };
-  };
-  const getMetaKey = (key) => key + "$";
-  const mergeMeta = (oldMeta, newMeta) => {
-    const newFields = { ...oldMeta };
-    Object.entries(newMeta).forEach(([key, value]) => {
-      if (value == null) delete newFields[key];
-      else newFields[key] = value;
-    });
-    return newFields;
-  };
-  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 getValueOrFallback(res, opts?.fallback ?? opts?.defaultValue);
-  };
-  const getMeta = async (driver, driverKey) => {
-    const metaKey = getMetaKey(driverKey);
-    const res = await driver.getItem(metaKey);
-    return getMetaValue(res);
-  };
-  const setItem = async (driver, driverKey, value) => {
-    await driver.setItem(driverKey, value ?? null);
-  };
-  const setMeta = async (driver, driverKey, properties) => {
-    const metaKey = getMetaKey(driverKey);
-    const existingFields = getMetaValue(await driver.getItem(metaKey));
-    await driver.setItem(metaKey, mergeMeta(existingFields, properties));
-  };
-  const removeItem = async (driver, driverKey, opts) => {
-    await driver.removeItem(driverKey);
-    if (opts?.removeMeta) {
-      const metaKey = getMetaKey(driverKey);
-      await driver.removeItem(metaKey);
-    }
-  };
-  const removeMeta = async (driver, driverKey, properties) => {
-    const metaKey = getMetaKey(driverKey);
-    if (properties == null) {
-      await driver.removeItem(metaKey);
-    } else {
-      const newFields = getMetaValue(await driver.getItem(metaKey));
-      toArray(properties).forEach((field) => delete newFields[field]);
-      await driver.setItem(metaKey, newFields);
-    }
-  };
-  const watch = (driver, driverKey, cb) => {
-    return driver.watch(driverKey, cb);
-  };
-  const storage2 = {
-    getItem: async (key, opts) => {
-      const { driver, driverKey } = resolveKey(key);
-      return await getItem(driver, driverKey, opts);
-    },
-    getItems: async (keys) => {
-      const areaToKeyMap = /* @__PURE__ */ new Map();
-      const keyToOptsMap = /* @__PURE__ */ new Map();
-      const orderedKeys = [];
-      keys.forEach((key) => {
-        let keyStr;
-        let opts;
-        if (typeof key === "string") {
-          keyStr = key;
-        } else if ("getValue" in key) {
-          keyStr = key.key;
-          opts = { fallback: key.fallback };
-        } else {
-          keyStr = key.key;
-          opts = key.options;
-        }
-        orderedKeys.push(keyStr);
-        const { driverArea, driverKey } = resolveKey(keyStr);
-        const areaKeys = areaToKeyMap.get(driverArea) ?? [];
-        areaToKeyMap.set(driverArea, areaKeys.concat(driverKey));
-        keyToOptsMap.set(keyStr, opts);
-      });
-      const resultsMap = /* @__PURE__ */ new Map();
-      await Promise.all(
-        Array.from(areaToKeyMap.entries()).map(async ([driverArea, keys2]) => {
-          const driverResults = await drivers[driverArea].getItems(keys2);
-          driverResults.forEach((driverResult) => {
-            const key = `${driverArea}:${driverResult.key}`;
-            const opts = keyToOptsMap.get(key);
-            const value = getValueOrFallback(
-              driverResult.value,
-              opts?.fallback ?? opts?.defaultValue
-            );
-            resultsMap.set(key, value);
-          });
-        })
-      );
-      return orderedKeys.map((key) => ({
-        key,
-        value: resultsMap.get(key)
-      }));
-    },
-    getMeta: async (key) => {
-      const { driver, driverKey } = resolveKey(key);
-      return await getMeta(driver, driverKey);
-    },
-    getMetas: async (args) => {
-      const keys = args.map((arg) => {
-        const key = typeof arg === "string" ? arg : arg.key;
-        const { driverArea, driverKey } = resolveKey(key);
-        return {
-          key,
-          driverArea,
-          driverKey,
-          driverMetaKey: getMetaKey(driverKey)
-        };
-      });
-      const areaToDriverMetaKeysMap = keys.reduce((map, key) => {
-        map[key.driverArea] ??= [];
-        map[key.driverArea].push(key);
-        return map;
-      }, {});
-      const resultsMap = {};
-      await Promise.all(
-        Object.entries(areaToDriverMetaKeysMap).map(async ([area, keys2]) => {
-          const areaRes = await browser.storage[area].get(
-            keys2.map((key) => key.driverMetaKey)
-          );
-          keys2.forEach((key) => {
-            resultsMap[key.key] = areaRes[key.driverMetaKey] ?? {};
-          });
-        })
-      );
-      return keys.map((key) => ({
-        key: key.key,
-        meta: resultsMap[key.key]
-      }));
-    },
-    setItem: async (key, value) => {
-      const { driver, driverKey } = resolveKey(key);
-      await setItem(driver, driverKey, value);
-    },
-    setItems: async (items) => {
-      const areaToKeyValueMap = {};
-      items.forEach((item) => {
-        const { driverArea, driverKey } = resolveKey(
-          "key" in item ? item.key : item.item.key
-        );
-        areaToKeyValueMap[driverArea] ??= [];
-        areaToKeyValueMap[driverArea].push({
-          key: driverKey,
-          value: item.value
-        });
-      });
-      await Promise.all(
-        Object.entries(areaToKeyValueMap).map(async ([driverArea, values]) => {
-          const driver = getDriver(driverArea);
-          await driver.setItems(values);
-        })
-      );
-    },
-    setMeta: async (key, properties) => {
-      const { driver, driverKey } = resolveKey(key);
-      await setMeta(driver, driverKey, properties);
-    },
-    setMetas: async (items) => {
-      const areaToMetaUpdatesMap = {};
-      items.forEach((item) => {
-        const { driverArea, driverKey } = resolveKey(
-          "key" in item ? item.key : item.item.key
-        );
-        areaToMetaUpdatesMap[driverArea] ??= [];
-        areaToMetaUpdatesMap[driverArea].push({
-          key: driverKey,
-          properties: item.meta
-        });
-      });
-      await Promise.all(
-        Object.entries(areaToMetaUpdatesMap).map(
-          async ([storageArea, updates]) => {
-            const driver = getDriver(storageArea);
-            const metaKeys = updates.map(({ key }) => getMetaKey(key));
-            console.log(storageArea, metaKeys);
-            const existingMetas = await driver.getItems(metaKeys);
-            const existingMetaMap = Object.fromEntries(
-              existingMetas.map(({ key, value }) => [key, getMetaValue(value)])
-            );
-            const metaUpdates = updates.map(({ key, properties }) => {
-              const metaKey = getMetaKey(key);
-              return {
-                key: metaKey,
-                value: mergeMeta(existingMetaMap[metaKey] ?? {}, properties)
-              };
-            });
-            await driver.setItems(metaUpdates);
-          }
-        )
-      );
-    },
-    removeItem: async (key, opts) => {
-      const { driver, driverKey } = resolveKey(key);
-      await removeItem(driver, driverKey, opts);
-    },
-    removeItems: async (keys) => {
-      const areaToKeysMap = {};
-      keys.forEach((key) => {
-        let keyStr;
-        let opts;
-        if (typeof key === "string") {
-          keyStr = key;
-        } else if ("getValue" in key) {
-          keyStr = key.key;
-        } else if ("item" in key) {
-          keyStr = key.item.key;
-          opts = key.options;
-        } else {
-          keyStr = key.key;
-          opts = key.options;
-        }
-        const { driverArea, driverKey } = resolveKey(keyStr);
-        areaToKeysMap[driverArea] ??= [];
-        areaToKeysMap[driverArea].push(driverKey);
-        if (opts?.removeMeta) {
-          areaToKeysMap[driverArea].push(getMetaKey(driverKey));
-        }
-      });
-      await Promise.all(
-        Object.entries(areaToKeysMap).map(async ([driverArea, keys2]) => {
-          const driver = getDriver(driverArea);
-          await driver.removeItems(keys2);
-        })
-      );
-    },
-    removeMeta: async (key, properties) => {
-      const { driver, driverKey } = resolveKey(key);
-      await removeMeta(driver, driverKey, properties);
-    },
-    snapshot: async (base, opts) => {
-      const driver = getDriver(base);
-      const data = await driver.snapshot();
-      opts?.excludeKeys?.forEach((key) => {
-        delete data[key];
-        delete data[getMetaKey(key)];
-      });
-      return data;
-    },
-    restoreSnapshot: async (base, data) => {
-      const driver = getDriver(base);
-      await driver.restoreSnapshot(data);
-    },
-    watch: (key, cb) => {
-      const { driver, driverKey } = resolveKey(key);
-      return watch(driver, driverKey, cb);
-    },
-    unwatch() {
-      Object.values(drivers).forEach((driver) => {
-        driver.unwatch();
-      });
-    },
-    defineItem: (key, opts) => {
-      const { driver, driverKey } = resolveKey(key);
-      const { version: targetVersion = 1, migrations = {} } = opts ?? {};
-      if (targetVersion < 1) {
-        throw Error(
-          "Storage item version cannot be less than 1. Initial versions should be set to 1, not 0."
-        );
-      }
-      const migrate = async () => {
-        const driverMetaKey = getMetaKey(driverKey);
-        const [{ value }, { value: meta }] = await driver.getItems([
-          driverKey,
-          driverMetaKey
-        ]);
-        if (value == null) return;
-        const currentVersion = meta?.v ?? 1;
-        if (currentVersion > targetVersion) {
-          throw Error(
-            `Version downgrade detected (v${currentVersion} -> v${targetVersion}) for "${key}"`
-          );
-        }
-        logger.debug(
-          `Running storage migration for ${key}: v${currentVersion} -> v${targetVersion}`
-        );
-        const migrationsToRun = Array.from(
-          { length: targetVersion - currentVersion },
-          (_, i) => currentVersion + i + 1
-        );
-        let migratedValue = value;
-        for (const migrateToVersion of migrationsToRun) {
-          try {
-            migratedValue = await migrations?.[migrateToVersion]?.(migratedValue) ?? migratedValue;
-          } catch (err) {
-            throw Error(`v${migrateToVersion} migration failed for "${key}"`, {
-              cause: err
-            });
-          }
-        }
-        await driver.setItems([
-          { key: driverKey, value: migratedValue },
-          { key: driverMetaKey, value: { ...meta, v: targetVersion } }
-        ]);
-        logger.debug(
-          `Storage migration completed for ${key} v${targetVersion}`,
-          { migratedValue }
-        );
-      };
-      const migrationsDone = opts?.migrations == null ? Promise.resolve() : migrate().catch((err) => {
-        logger.error(`Migration failed for ${key}`, err);
-      });
-      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 {
-        key,
-        get defaultValue() {
-          return getFallback();
-        },
-        get fallback() {
-          return getFallback();
-        },
-        getValue: async () => {
-          await migrationsDone;
-          if (opts?.init) {
-            return await getOrInitValue();
-          } else {
-            return await getItem(driver, driverKey, opts);
-          }
-        },
-        getMeta: async () => {
-          await migrationsDone;
-          return await getMeta(driver, driverKey);
-        },
-        setValue: async (value) => {
-          await migrationsDone;
-          return await setItem(driver, driverKey, value);
-        },
-        setMeta: async (properties) => {
-          await migrationsDone;
-          return await setMeta(driver, driverKey, properties);
-        },
-        removeValue: async (opts2) => {
-          await migrationsDone;
-          return await removeItem(driver, driverKey, opts2);
-        },
-        removeMeta: async (properties) => {
-          await migrationsDone;
-          return await removeMeta(driver, driverKey, properties);
-        },
-        watch: (cb) => watch(
-          driver,
-          driverKey,
-          (newValue, oldValue) => cb(newValue ?? getFallback(), oldValue ?? getFallback())
-        ),
-        migrate
-      };
-    }
-  };
-  return storage2;
-}
-function createDriver(storageArea) {
-  const getStorageArea = () => {
-    if (browser.runtime == null) {
-      throw Error(
-        [
-          "'wxt/storage' must be loaded in a web extension environment",
-          "\n - If thrown during a build, see https://github.com/wxt-dev/wxt/issues/371",
-          " - If thrown during tests, mock 'wxt/browser' correctly. See https://wxt.dev/guide/go-further/testing.html\n"
-        ].join("\n")
-      );
-    }
-    if (browser.storage == null) {
-      throw Error(
-        "You must add the 'storage' permission to your manifest to use 'wxt/storage'"
-      );
-    }
-    const area = browser.storage[storageArea];
-    if (area == null)
-      throw Error(`"browser.storage.${storageArea}" is undefined`);
-    return area;
-  };
-  const watchListeners = /* @__PURE__ */ new Set();
-  return {
-    getItem: async (key) => {
-      const res = await getStorageArea().get(key);
-      return res[key];
-    },
-    getItems: async (keys) => {
-      const result = await getStorageArea().get(keys);
-      return keys.map((key) => ({ key, value: result[key] ?? null }));
-    },
-    setItem: async (key, value) => {
-      if (value == null) {
-        await getStorageArea().remove(key);
-      } else {
-        await getStorageArea().set({ [key]: value });
-      }
-    },
-    setItems: async (values) => {
-      const map = values.reduce(
-        (map2, { key, value }) => {
-          map2[key] = value;
-          return map2;
-        },
-        {}
-      );
-      await getStorageArea().set(map);
-    },
-    removeItem: async (key) => {
-      await getStorageArea().remove(key);
-    },
-    removeItems: async (keys) => {
-      await getStorageArea().remove(keys);
-    },
-    snapshot: async () => {
-      return await getStorageArea().get();
-    },
-    restoreSnapshot: async (data) => {
-      await getStorageArea().set(data);
-    },
-    watch(key, cb) {
-      const listener = (changes) => {
-        const change = changes[key];
-        if (change == null) return;
-        if (dequal(change.newValue, change.oldValue)) return;
-        cb(change.newValue ?? null, change.oldValue ?? null);
-      };
-      getStorageArea().onChanged.addListener(listener);
-      watchListeners.add(listener);
-      return () => {
-        getStorageArea().onChanged.removeListener(listener);
-        watchListeners.delete(listener);
-      };
-    },
-    unwatch() {
-      watchListeners.forEach((listener) => {
-        getStorageArea().onChanged.removeListener(listener);
-      });
-      watchListeners.clear();
-    }
-  };
-}
-export class MigrationError extends Error {
-  constructor(key, version, options) {
-    super(`v${version} migration failed for "${key}"`, options);
-    this.key = key;
-    this.version = version;
-  }
-}
+export * from "@wxt-dev/storage";

package/dist/types.d.ts

@@ -984,11 +984,15 @@ export interface ServerInfo {
 export type HookResult = Promise<void> | void;
 export interface WxtHooks {
     /**
-     * Called after WXT initialization, when the WXT instance is ready to work.
+     * Called only one time after WXT initialization, when the WXT instance is ready to work.
      * @param wxt The configured WXT object
-     * @returns Promise
      */
     ready: (wxt: Wxt) => HookResult;
+    /**
+     * 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;
     /**
      * Called before WXT writes .wxt/tsconfig.json and .wxt/wxt.d.ts, allowing
      * addition of custom references and declarations in wxt.d.ts, or directly

package/dist/version.mjs

@@ -1 +1 @@
-export const version = "0.19.14";
+export const version = "0.19.16";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "wxt",
   "type": "module",
-  "version": "0.19.14",
+  "version": "0.19.16",
   "description": "Next gen framework for developing web extensions",
   "repository": {
     "type": "git",
@@ -76,6 +76,7 @@
     "@webext-core/fake-browser": "^1.3.1",
     "@webext-core/isolated-element": "^1.1.2",
     "@webext-core/match-patterns": "^1.0.3",
+    "@wxt-dev/storage": "^1.0.0",
     "async-mutex": "^0.5.0",
     "c12": "^1.11.2",
     "cac": "^6.7.14",
@@ -83,7 +84,6 @@
     "ci-info": "^4.1.0",
     "consola": "^3.2.3",
     "defu": "^6.1.4",
-    "dequal": "^2.0.3",
     "dotenv": "^16.4.5",
     "esbuild": "^0.21.5",
     "fast-glob": "^3.3.2",