wxt 0.18.3 → 0.18.5

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { I as InlineConfig, B as BuildOutput, U as UserConfig, E as ExtensionRunnerConfig, W as WxtDevServer } from './index-xOGXP3vY.cjs';
-export { x as BackgroundDefinition, n as BackgroundEntrypoint, i as BackgroundEntrypointOptions, j as BaseContentScriptEntrypointOptions, m as BaseEntrypoint, h as BaseEntrypointOptions, e as BuildStepOutput, J as ConfigEnv, w as ContentScriptDefinition, C as ContentScriptEntrypoint, a5 as Dependency, r as Entrypoint, s as EntrypointGroup, $ as EslintGlobalsPropValue, a0 as Eslintrc, _ as ExtensionRunner, Z as FsCache, G as GenericEntrypoint, X as HookResult, u as IsolatedWorldContentScriptDefinition, k as IsolatedWorldContentScriptEntrypointOptions, L as Logger, v as MainWorldContentScriptDefinition, M as MainWorldContentScriptEntrypointOptions, t as OnContentScriptStopped, p as OptionsEntrypoint, l as OptionsEntrypointOptions, d as OutputAsset, c as OutputChunk, O as OutputFile, A as PerBrowserMap, z as PerBrowserOption, o as PopupEntrypoint, P as PopupEntrypointOptions, f as ReloadContentScriptPayload, R as ResolvedConfig, a1 as ResolvedEslintrc, D as ResolvedPerBrowserOptions, V as ServerInfo, q as SidepanelEntrypoint, S as SidepanelEntrypointOptions, T as TargetBrowser, g as TargetManifestVersion, y as UnlistedScriptDefinition, F as UserManifest, H as UserManifestFn, Y as Wxt, N as WxtBuilder, Q as WxtBuilderServer, K as WxtCommand, b as WxtHooks, a4 as WxtPackageManager, a3 as WxtResolvedUnimportOptions, a2 as WxtUnimportOptions, a as WxtViteConfig } from './index-xOGXP3vY.cjs';
+import { I as InlineConfig, B as BuildOutput, U as UserConfig, E as ExtensionRunnerConfig, W as WxtDevServer } from './index-q2ZwJBs6.cjs';
+export { x as BackgroundDefinition, n as BackgroundEntrypoint, i as BackgroundEntrypointOptions, j as BaseContentScriptEntrypointOptions, m as BaseEntrypoint, h as BaseEntrypointOptions, e as BuildStepOutput, J as ConfigEnv, w as ContentScriptDefinition, C as ContentScriptEntrypoint, a5 as Dependency, r as Entrypoint, s as EntrypointGroup, $ as EslintGlobalsPropValue, a0 as Eslintrc, _ as ExtensionRunner, Z as FsCache, G as GenericEntrypoint, X as HookResult, u as IsolatedWorldContentScriptDefinition, k as IsolatedWorldContentScriptEntrypointOptions, L as Logger, v as MainWorldContentScriptDefinition, M as MainWorldContentScriptEntrypointOptions, t as OnContentScriptStopped, p as OptionsEntrypoint, l as OptionsEntrypointOptions, d as OutputAsset, c as OutputChunk, O as OutputFile, A as PerBrowserMap, z as PerBrowserOption, o as PopupEntrypoint, P as PopupEntrypointOptions, f as ReloadContentScriptPayload, R as ResolvedConfig, a1 as ResolvedEslintrc, D as ResolvedPerBrowserOptions, a9 as ResolvedPublicFile, V as ServerInfo, q as SidepanelEntrypoint, S as SidepanelEntrypointOptions, T as TargetBrowser, g as TargetManifestVersion, y as UnlistedScriptDefinition, F as UserManifest, H as UserManifestFn, Y as Wxt, N as WxtBuilder, Q as WxtBuilderServer, K as WxtCommand, b as WxtHooks, a8 as WxtModule, a6 as WxtModuleOptions, a7 as WxtModuleSetup, a4 as WxtPackageManager, aa as WxtPlugin, a3 as WxtResolvedUnimportOptions, a2 as WxtUnimportOptions, a as WxtViteConfig } from './index-q2ZwJBs6.cjs';
 import 'vite';
 import 'webextension-polyfill';
 import 'unimport';
@@ -65,6 +65,6 @@ declare function prepare(config: InlineConfig): Promise<void>;
  */
 declare function zip(config?: InlineConfig): Promise<string[]>;
 
-var version = "0.18.2";
+var version = "0.18.5";
 
 export { BuildOutput, ExtensionRunnerConfig, InlineConfig, UserConfig, WxtDevServer, build, clean, createServer, defineConfig, defineRunnerConfig, initialize, prepare, version, zip };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { I as InlineConfig, B as BuildOutput, U as UserConfig, E as ExtensionRunnerConfig, W as WxtDevServer } from './index-xOGXP3vY.js';
-export { x as BackgroundDefinition, n as BackgroundEntrypoint, i as BackgroundEntrypointOptions, j as BaseContentScriptEntrypointOptions, m as BaseEntrypoint, h as BaseEntrypointOptions, e as BuildStepOutput, J as ConfigEnv, w as ContentScriptDefinition, C as ContentScriptEntrypoint, a5 as Dependency, r as Entrypoint, s as EntrypointGroup, $ as EslintGlobalsPropValue, a0 as Eslintrc, _ as ExtensionRunner, Z as FsCache, G as GenericEntrypoint, X as HookResult, u as IsolatedWorldContentScriptDefinition, k as IsolatedWorldContentScriptEntrypointOptions, L as Logger, v as MainWorldContentScriptDefinition, M as MainWorldContentScriptEntrypointOptions, t as OnContentScriptStopped, p as OptionsEntrypoint, l as OptionsEntrypointOptions, d as OutputAsset, c as OutputChunk, O as OutputFile, A as PerBrowserMap, z as PerBrowserOption, o as PopupEntrypoint, P as PopupEntrypointOptions, f as ReloadContentScriptPayload, R as ResolvedConfig, a1 as ResolvedEslintrc, D as ResolvedPerBrowserOptions, V as ServerInfo, q as SidepanelEntrypoint, S as SidepanelEntrypointOptions, T as TargetBrowser, g as TargetManifestVersion, y as UnlistedScriptDefinition, F as UserManifest, H as UserManifestFn, Y as Wxt, N as WxtBuilder, Q as WxtBuilderServer, K as WxtCommand, b as WxtHooks, a4 as WxtPackageManager, a3 as WxtResolvedUnimportOptions, a2 as WxtUnimportOptions, a as WxtViteConfig } from './index-xOGXP3vY.js';
+import { I as InlineConfig, B as BuildOutput, U as UserConfig, E as ExtensionRunnerConfig, W as WxtDevServer } from './index-q2ZwJBs6.js';
+export { x as BackgroundDefinition, n as BackgroundEntrypoint, i as BackgroundEntrypointOptions, j as BaseContentScriptEntrypointOptions, m as BaseEntrypoint, h as BaseEntrypointOptions, e as BuildStepOutput, J as ConfigEnv, w as ContentScriptDefinition, C as ContentScriptEntrypoint, a5 as Dependency, r as Entrypoint, s as EntrypointGroup, $ as EslintGlobalsPropValue, a0 as Eslintrc, _ as ExtensionRunner, Z as FsCache, G as GenericEntrypoint, X as HookResult, u as IsolatedWorldContentScriptDefinition, k as IsolatedWorldContentScriptEntrypointOptions, L as Logger, v as MainWorldContentScriptDefinition, M as MainWorldContentScriptEntrypointOptions, t as OnContentScriptStopped, p as OptionsEntrypoint, l as OptionsEntrypointOptions, d as OutputAsset, c as OutputChunk, O as OutputFile, A as PerBrowserMap, z as PerBrowserOption, o as PopupEntrypoint, P as PopupEntrypointOptions, f as ReloadContentScriptPayload, R as ResolvedConfig, a1 as ResolvedEslintrc, D as ResolvedPerBrowserOptions, a9 as ResolvedPublicFile, V as ServerInfo, q as SidepanelEntrypoint, S as SidepanelEntrypointOptions, T as TargetBrowser, g as TargetManifestVersion, y as UnlistedScriptDefinition, F as UserManifest, H as UserManifestFn, Y as Wxt, N as WxtBuilder, Q as WxtBuilderServer, K as WxtCommand, b as WxtHooks, a8 as WxtModule, a6 as WxtModuleOptions, a7 as WxtModuleSetup, a4 as WxtPackageManager, aa as WxtPlugin, a3 as WxtResolvedUnimportOptions, a2 as WxtUnimportOptions, a as WxtViteConfig } from './index-q2ZwJBs6.js';
 import 'vite';
 import 'webextension-polyfill';
 import 'unimport';
@@ -65,6 +65,6 @@ declare function prepare(config: InlineConfig): Promise<void>;
  */
 declare function zip(config?: InlineConfig): Promise<string[]>;
 
-var version = "0.18.2";
+var version = "0.18.5";
 
 export { BuildOutput, ExtensionRunnerConfig, InlineConfig, UserConfig, WxtDevServer, build, clean, createServer, defineConfig, defineRunnerConfig, initialize, prepare, version, zip };

package/dist/index.js

@@ -19,7 +19,7 @@ import {
   unnormalizePath,
   version,
   wxt
-} from "./chunk-XAYX5BXI.js";
+} from "./chunk-7AOGIMIM.js";
 import "./chunk-5X3S6AWF.js";
 import {
   consola
@@ -614,13 +614,10 @@ async function zipDir(directory, outputPath, options) {
     cwd: directory,
     // Ignore node_modules, otherwise this glob step takes forever
     ignore: ["**/node_modules"],
-    onlyFiles: true
+    onlyFiles: true,
+    dot: true
   })).filter((relativePath) => {
-    return wxt.config.zip.includeSources.some(
-      (pattern) => minimatch(relativePath, pattern)
-    ) || !wxt.config.zip.excludeSources.some(
-      (pattern) => minimatch(relativePath, pattern)
-    );
+    return options?.include?.some((pattern) => minimatch(relativePath, pattern)) || !options?.exclude?.some((pattern) => minimatch(relativePath, pattern));
   });
   const filesToZip = [
     ...files,

package/dist/modules.cjs

@@ -0,0 +1,88 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/modules.ts
+var modules_exports = {};
+__export(modules_exports, {
+  addEntrypoint: () => addEntrypoint,
+  addPublicAssets: () => addPublicAssets,
+  addViteConfig: () => addViteConfig,
+  addWxtPlugin: () => addWxtPlugin,
+  defineWxtModule: () => defineWxtModule
+});
+module.exports = __toCommonJS(modules_exports);
+var vite = __toESM(require("vite"), 1);
+var import_fast_glob = __toESM(require("fast-glob"), 1);
+var import_node_path = require("path");
+function defineWxtModule(module2) {
+  if (typeof module2 === "function")
+    return { setup: module2 };
+  return module2;
+}
+function addEntrypoint(wxt, entrypoint) {
+  wxt.hooks.hook("entrypoints:resolved", (wxt2, entrypoints) => {
+    entrypoints.push(entrypoint);
+  });
+}
+function addPublicAssets(wxt, dir) {
+  wxt.hooks.hook("build:publicAssets", async (wxt2, files) => {
+    const moreFiles = await (0, import_fast_glob.default)("**/*", { cwd: dir });
+    if (moreFiles.length === 0) {
+      wxt2.logger.warn("No files to copy in", dir);
+      return;
+    }
+    moreFiles.forEach((file) => {
+      files.unshift({ absoluteSrc: (0, import_node_path.resolve)(dir, file), relativeDest: file });
+    });
+  });
+}
+function addViteConfig(wxt, viteConfig) {
+  wxt.hooks.hook("ready", (wxt2) => {
+    const userVite = wxt2.config.vite;
+    wxt2.config.vite = (env) => vite.mergeConfig(
+      // Use config added by module as base
+      viteConfig(env) ?? {},
+      // Overwrite module config with user config
+      userVite(env)
+    );
+  });
+}
+function addWxtPlugin(wxt, plugin) {
+  wxt.hooks.hook("ready", (wxt2) => {
+    wxt2.config.plugins.push(plugin);
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  addEntrypoint,
+  addPublicAssets,
+  addViteConfig,
+  addWxtPlugin,
+  defineWxtModule
+});

package/dist/modules.d.cts

@@ -0,0 +1,91 @@
+import { a6 as WxtModuleOptions, a8 as WxtModule, a7 as WxtModuleSetup, Y as Wxt, r as Entrypoint } from './index-q2ZwJBs6.cjs';
+import * as vite from 'vite';
+import 'webextension-polyfill';
+import 'unimport';
+import 'consola';
+import '@aklinker1/rollup-plugin-visualizer';
+import 'chokidar';
+import 'c12';
+import 'hookable';
+import 'nypm';
+
+/**
+ * Utilities for creating reusable, build-time modules for WXT.
+ *
+ * @module wxt/modules
+ */
+
+declare function defineWxtModule<TOptions extends WxtModuleOptions>(module: WxtModule<TOptions> | WxtModuleSetup<TOptions>): WxtModule<TOptions>;
+/**
+ * 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
+ * copy some files instead of bundling them.
+ *
+ * @param wxt The wxt instance provided by the module's setup function.
+ * @param entrypoint The entrypoint to be bundled along with the extension.
+ *
+ * @example
+ * export default defineWxtModule((wxt, options) => {
+ *   addEntrypoint(wxt, {
+ *     type: "unlisted-page",
+ *     name: "changelog",
+ *     inputPath: "wxt-module-changelog/index.html"
+ *     outputDir: wxt.config.outputDir,
+ *     options: {},
+ *   });
+ * });
+ */
+declare function addEntrypoint(wxt: Wxt, entrypoint: Entrypoint): void;
+/**
+ * Copy files inside a directory (as if it were the public directory) into the
+ * extension's output directory. The directory itself is not copied, just the
+ * files inside it. If a filename matches an existing one, it is ignored.
+ *
+ * @param wxt The wxt instance provided by the module's setup function.
+ * @param dir The directory to copy.
+ *
+ * @example
+ * export default defineWxtModule((wxt, options) => {
+ *   addPublicAssets(wxt, "./dist/prebundled");
+ * });
+ */
+declare function addPublicAssets(wxt: Wxt, dir: string): void;
+/**
+ * Merge additional vite config for one or more entrypoint "groups" that make
+ * up individual builds. Config in the project's `wxt.config.ts` file takes
+ * precedence over any config added by this function.
+ *
+ * @param wxt The wxt instance provided by the module's setup function.
+ * @param viteConfig A function that returns the vite config the module is
+                     adding. Same format as `vite` in `wxt.config.ts`.
+ *
+ * @example
+ * export default defineWxtModule((wxt, options) => {
+ *   addViteConfig(wxt, () => ({
+ *     build: {
+ *       sourceMaps: true,
+ *     },
+ *   });
+ * });
+ */
+declare function addViteConfig(wxt: Wxt, viteConfig: (env: vite.ConfigEnv) => vite.UserConfig | undefined): void;
+/**
+ * Add a runtime plugin to the project. In each entrypoint, before executing
+ * the `main` function, plugins are executed.
+ *
+ * @param wxt The wxt instance provided by the module's setup function.
+ * @param plugin An import from an NPM module, or an absolute file path to the
+ *               file to load at runtime.
+ *
+ * @example
+ * export default defineWxtModule((wxt) => {
+ *   addWxtPlugin(wxt, "wxt-module-analytics/client-plugin");
+ * });
+ */
+declare function addWxtPlugin(wxt: Wxt, plugin: string): void;
+
+export { addEntrypoint, addPublicAssets, addViteConfig, addWxtPlugin, defineWxtModule };

package/dist/modules.d.ts

@@ -0,0 +1,91 @@
+import { a6 as WxtModuleOptions, a8 as WxtModule, a7 as WxtModuleSetup, Y as Wxt, r as Entrypoint } from './index-q2ZwJBs6.js';
+import * as vite from 'vite';
+import 'webextension-polyfill';
+import 'unimport';
+import 'consola';
+import '@aklinker1/rollup-plugin-visualizer';
+import 'chokidar';
+import 'c12';
+import 'hookable';
+import 'nypm';
+
+/**
+ * Utilities for creating reusable, build-time modules for WXT.
+ *
+ * @module wxt/modules
+ */
+
+declare function defineWxtModule<TOptions extends WxtModuleOptions>(module: WxtModule<TOptions> | WxtModuleSetup<TOptions>): WxtModule<TOptions>;
+/**
+ * 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
+ * copy some files instead of bundling them.
+ *
+ * @param wxt The wxt instance provided by the module's setup function.
+ * @param entrypoint The entrypoint to be bundled along with the extension.
+ *
+ * @example
+ * export default defineWxtModule((wxt, options) => {
+ *   addEntrypoint(wxt, {
+ *     type: "unlisted-page",
+ *     name: "changelog",
+ *     inputPath: "wxt-module-changelog/index.html"
+ *     outputDir: wxt.config.outputDir,
+ *     options: {},
+ *   });
+ * });
+ */
+declare function addEntrypoint(wxt: Wxt, entrypoint: Entrypoint): void;
+/**
+ * Copy files inside a directory (as if it were the public directory) into the
+ * extension's output directory. The directory itself is not copied, just the
+ * files inside it. If a filename matches an existing one, it is ignored.
+ *
+ * @param wxt The wxt instance provided by the module's setup function.
+ * @param dir The directory to copy.
+ *
+ * @example
+ * export default defineWxtModule((wxt, options) => {
+ *   addPublicAssets(wxt, "./dist/prebundled");
+ * });
+ */
+declare function addPublicAssets(wxt: Wxt, dir: string): void;
+/**
+ * Merge additional vite config for one or more entrypoint "groups" that make
+ * up individual builds. Config in the project's `wxt.config.ts` file takes
+ * precedence over any config added by this function.
+ *
+ * @param wxt The wxt instance provided by the module's setup function.
+ * @param viteConfig A function that returns the vite config the module is
+                     adding. Same format as `vite` in `wxt.config.ts`.
+ *
+ * @example
+ * export default defineWxtModule((wxt, options) => {
+ *   addViteConfig(wxt, () => ({
+ *     build: {
+ *       sourceMaps: true,
+ *     },
+ *   });
+ * });
+ */
+declare function addViteConfig(wxt: Wxt, viteConfig: (env: vite.ConfigEnv) => vite.UserConfig | undefined): void;
+/**
+ * Add a runtime plugin to the project. In each entrypoint, before executing
+ * the `main` function, plugins are executed.
+ *
+ * @param wxt The wxt instance provided by the module's setup function.
+ * @param plugin An import from an NPM module, or an absolute file path to the
+ *               file to load at runtime.
+ *
+ * @example
+ * export default defineWxtModule((wxt) => {
+ *   addWxtPlugin(wxt, "wxt-module-analytics/client-plugin");
+ * });
+ */
+declare function addWxtPlugin(wxt: Wxt, plugin: string): void;
+
+export { addEntrypoint, addPublicAssets, addViteConfig, addWxtPlugin, defineWxtModule };

package/dist/modules.js

@@ -0,0 +1,51 @@
+import "./chunk-VBXJIVYU.js";
+
+// src/modules.ts
+import * as vite from "vite";
+import glob from "fast-glob";
+import { resolve } from "node:path";
+function defineWxtModule(module) {
+  if (typeof module === "function")
+    return { setup: module };
+  return module;
+}
+function addEntrypoint(wxt, entrypoint) {
+  wxt.hooks.hook("entrypoints:resolved", (wxt2, entrypoints) => {
+    entrypoints.push(entrypoint);
+  });
+}
+function addPublicAssets(wxt, dir) {
+  wxt.hooks.hook("build:publicAssets", async (wxt2, files) => {
+    const moreFiles = await glob("**/*", { cwd: dir });
+    if (moreFiles.length === 0) {
+      wxt2.logger.warn("No files to copy in", dir);
+      return;
+    }
+    moreFiles.forEach((file) => {
+      files.unshift({ absoluteSrc: resolve(dir, file), relativeDest: file });
+    });
+  });
+}
+function addViteConfig(wxt, viteConfig) {
+  wxt.hooks.hook("ready", (wxt2) => {
+    const userVite = wxt2.config.vite;
+    wxt2.config.vite = (env) => vite.mergeConfig(
+      // Use config added by module as base
+      viteConfig(env) ?? {},
+      // Overwrite module config with user config
+      userVite(env)
+    );
+  });
+}
+function addWxtPlugin(wxt, plugin) {
+  wxt.hooks.hook("ready", (wxt2) => {
+    wxt2.config.plugins.push(plugin);
+  });
+}
+export {
+  addEntrypoint,
+  addPublicAssets,
+  addViteConfig,
+  addWxtPlugin,
+  defineWxtModule
+};

package/dist/sandbox.d.ts

@@ -1,4 +1,4 @@
-import { U as UnlistedScriptDefinition, B as BackgroundDefinition, C as ContentScriptDefinition } from './index-CiL7hzu6.js';
+import { U as UnlistedScriptDefinition, B as BackgroundDefinition, C as ContentScriptDefinition, W as WxtPlugin } from './index-Bk-a0SkY.js';
 export * from '@webext-core/match-patterns';
 import 'webextension-polyfill';
 
@@ -10,4 +10,6 @@ declare function defineBackground(definition: BackgroundDefinition): BackgroundD
 
 declare function defineContentScript(definition: ContentScriptDefinition): ContentScriptDefinition;
 
-export { defineBackground, defineContentScript, defineUnlistedScript };
+declare function defineWxtPlugin(plugin: WxtPlugin): WxtPlugin;
+
+export { defineBackground, defineContentScript, defineUnlistedScript, defineWxtPlugin };

package/dist/sandbox.js

@@ -17,10 +17,16 @@ function defineContentScript(definition) {
   return definition;
 }
 
+// src/sandbox/define-wxt-plugin.ts
+function defineWxtPlugin(plugin) {
+  return plugin;
+}
+
 // src/sandbox/index.ts
 export * from "@webext-core/match-patterns";
 export {
   defineBackground,
   defineContentScript,
-  defineUnlistedScript
+  defineUnlistedScript,
+  defineWxtPlugin
 };

package/dist/storage.d.cts

@@ -6,7 +6,7 @@ interface WxtStorage {
      * @example
      * await storage.getItem<number>("local:installDate");
      */
-    getItem<T>(key: string, opts?: GetItemOptions<T>): Promise<T | null>;
+    getItem<T>(key: StorageItemKey, opts?: GetItemOptions<T>): Promise<T | null>;
     /**
      * Get multiple items from storage. The return order is guaranteed to be the same as the order
      * requested.
@@ -14,11 +14,11 @@ interface WxtStorage {
      * @example
      * await storage.getItems(["local:installDate", "session:someCounter"]);
      */
-    getItems(keys: Array<string | {
-        key: string;
+    getItems(keys: Array<StorageItemKey | {
+        key: StorageItemKey;
         options?: GetItemOptions<any>;
     }>): Promise<Array<{
-        key: string;
+        key: StorageItemKey;
         value: any;
     }>>;
     /**
@@ -28,7 +28,7 @@ interface WxtStorage {
      * @example
      * await storage.getMeta("local:installDate");
      */
-    getMeta<T extends Record<string, unknown>>(key: string): Promise<T>;
+    getMeta<T extends Record<string, unknown>>(key: StorageItemKey): Promise<T>;
     /**
      * Set a value in storage. Setting a value to `null` or `undefined` is equivalent to calling
      * `removeItem`.
@@ -36,7 +36,7 @@ interface WxtStorage {
      * @example
      * await storage.setItem<number>("local:installDate", Date.now());
      */
-    setItem<T>(key: string, value: T | null): Promise<void>;
+    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.
      *
@@ -47,7 +47,7 @@ interface WxtStorage {
      * ]);
      */
     setItems(values: Array<{
-        key: string;
+        key: StorageItemKey;
         value: any;
     }>): Promise<void>;
     /**
@@ -57,19 +57,19 @@ interface WxtStorage {
      * @example
      * await storage.setMeta("local:installDate", { appVersion });
      */
-    setMeta<T extends Record<string, unknown>>(key: string, properties: T | null): Promise<void>;
+    setMeta<T extends Record<string, unknown>>(key: StorageItemKey, properties: T | null): Promise<void>;
     /**
      * Removes an item from storage.
      *
      * @example
      * await storage.removeItem("local:installDate");
      */
-    removeItem(key: string, opts?: RemoveItemOptions): Promise<void>;
+    removeItem(key: StorageItemKey, opts?: RemoveItemOptions): Promise<void>;
     /**
      * Remove a list of keys from storage.
      */
-    removeItems(keys: Array<string | {
-        key: string;
+    removeItems(keys: Array<StorageItemKey | {
+        key: StorageItemKey;
         options?: RemoveItemOptions;
     }>): Promise<void>;
     /**
@@ -82,20 +82,20 @@ interface WxtStorage {
      * // Remove only specific the "v" field
      * await storage.removeMeta("local:installDate", "v")
      */
-    removeMeta(key: string, properties?: string | string[]): Promise<void>;
+    removeMeta(key: StorageItemKey, properties?: string | string[]): Promise<void>;
     /**
      * Return all the items in storage.
      */
-    snapshot(base: string, opts?: SnapshotOptions): Promise<Record<string, unknown>>;
+    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: string, data: any): Promise<void>;
+    restoreSnapshot(base: StorageArea, data: any): Promise<void>;
     /**
      * Watch for changes to a specific key in storage.
      */
-    watch<T>(key: string, cb: WatchCallback<T | null>): Unwatch;
+    watch<T>(key: StorageItemKey, cb: WatchCallback<T | null>): Unwatch;
     /**
      * Remove all watch listeners.
      */
@@ -105,8 +105,8 @@ interface WxtStorage {
      *
      * Read full docs: https://wxt.dev/guide/storage.html#defining-storage-items
      */
-    defineItem<TValue, TMetadata extends Record<string, unknown> = {}>(key: string): WxtStorageItem<TValue | null, TMetadata>;
-    defineItem<TValue, TMetadata extends Record<string, unknown> = {}>(key: string, options: WxtStorageItemOptions<TValue>): WxtStorageItem<TValue, TMetadata>;
+    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>;
 }
 interface WxtStorageItem<TValue, TMetadata extends Record<string, unknown>> {
     defaultValue: TValue;
@@ -146,6 +146,8 @@ interface WxtStorageItem<TValue, TMetadata extends Record<string, unknown>> {
      */
     migrate(): Promise<void>;
 }
+type StorageArea = 'local' | 'session' | 'sync' | 'managed';
+type StorageItemKey = `${StorageArea}:${string}`;
 interface GetItemOptions<T> {
     /**
      * Value returned from `getValue` when it would otherwise return null.
@@ -195,4 +197,4 @@ type WatchCallback<T> = (newValue: T, oldValue: T) => void;
  */
 type Unwatch = () => void;
 
-export { type GetItemOptions, type NullablePartial, type RemoveItemOptions, type SnapshotOptions, type Unwatch, type WatchCallback, type WxtStorage, type WxtStorageItem, type WxtStorageItemOptions, storage };
+export { type GetItemOptions, type NullablePartial, type RemoveItemOptions, type SnapshotOptions, type StorageArea, type StorageItemKey, type Unwatch, type WatchCallback, type WxtStorage, type WxtStorageItem, type WxtStorageItemOptions, storage };