@wxt-dev/browser 0.1.42 → 0.2.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@wxt-dev/browser",
   "description": "Provides a cross-browser API for using extension APIs and types based on @types/chrome",
-  "version": "0.1.42",
+  "version": "0.2.0",
   "type": "module",
   "main": "src/index.mjs",
   "types": "src/index.d.ts",
@@ -25,11 +25,11 @@
     "src"
   ],
   "devDependencies": {
-    "@types/chrome": "0.1.42",
-    "@types/node": "^20.0.0",
+    "@types/chrome": "0.2.0",
+    "@types/node": "^20.17.6",
     "nano-spawn": "^2.0.0",
-    "typescript": "^5.9.3",
-    "vitest": "^4.0.18"
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.5"
   },
   "dependencies": {
     "@types/filesystem": "*",

package/src/gen/index.d.ts

@@ -1727,7 +1727,7 @@ export namespace Browser {
          *
          * `allow`: Allow sites to use advanced clipboard capabilities,
          *
-         * `block`: Don't allow sites to use advanced clipboard capabilties,
+         * `block`: Don't allow sites to use advanced clipboard capabilities,
          *
          * `ask`: Ask when a site wants to use advanced clipboard capabilities.
          *
@@ -1878,6 +1878,8 @@ export namespace Browser {
             BROWSER_ACTION = "browser_action",
             PAGE_ACTION = "page_action",
             ACTION = "action",
+            /** @since Chrome 149 */
+            TAB = "tab",
         }
 
         /**
@@ -2248,7 +2250,7 @@ export namespace Browser {
      *
      * Permissions: "debugger"
      */
-    export namespace _debugger {
+    namespace _debugger {
         /** Debuggee identifier. Either tabId, extensionId or targetId must be specified */
         interface Debuggee {
             /** The id of the tab which you intend to debug. */
@@ -2587,7 +2589,7 @@ export namespace Browser {
         interface EditResponseCookie {
             /** Filter for cookies that will be modified. All empty entries are ignored. */
             filter: ResponseCookie;
-            /** Attributes that shall be overridden in cookies that machted the filter. Attributes that are set to an empty string are removed. */
+            /** Attributes that shall be overridden in cookies that matched the filter. Attributes that are set to an empty string are removed. */
             modification: ResponseCookie;
         }
 
@@ -2605,7 +2607,7 @@ export namespace Browser {
         interface EditRequestCookie {
             /** Filter for cookies that will be modified. All empty entries are ignored. */
             filter: RequestCookie;
-            /** Attributes that shall be overridden in cookies that machted the filter. Attributes that are set to an empty string are removed. */
+            /** Attributes that shall be overridden in cookies that matched the filter. Attributes that are set to an empty string are removed. */
             modification: RequestCookie;
         }
 
@@ -4547,7 +4549,7 @@ export namespace Browser {
         const inIncognitoContext: boolean;
 
         /**
-         * Set for the lifetime of a callback if an ansychronous extension api has resulted in an error. If no error has occurred lastError will be `undefined`.
+         * Set for the lifetime of a callback if an asynchronous extension api has resulted in an error. If no error has occurred lastError will be `undefined`.
          * @deprecated since Chrome 58. Please use {@link runtime.lastError}
          */
         const lastError: runtime.LastError | undefined;
@@ -8914,6 +8916,7 @@ export namespace Browser {
         /**
          * The native client architecture. This may be different from arch on some platforms.
          * @since Chrome 44
+         * @deprecated since Chrome 149. This enum is deprecated following complete removal of Native Client.
          */
         enum PlatformNaclArch {
             /** Specifies the native client architecture as arm. */
@@ -9074,7 +9077,10 @@ export namespace Browser {
             os: `${PlatformOs}`;
             /** The machine's processor architecture. */
             arch: `${PlatformArch}`;
-            /** The native client architecture. This may be different from arch on some platforms. */
+            /**
+             * The native client architecture. This may be different from arch on some platforms.
+             * @deprecated since Chrome 149. This attribute is deprecated following complete removal of Native Client.
+             */
             nacl_arch?: `${PlatformNaclArch}`;
         }
 
@@ -9219,11 +9225,6 @@ export namespace Browser {
             | "webRequestBlocking"
             | "webRequestAuthProvider";
 
-        /**
-         * @deprecated Use `ManifestPermission` instead.
-         */
-        type ManifestPermissions = ManifestPermission;
-
         /** Source : https://developer.chrome.com/docs/extensions/reference/api/permissions */
         type ManifestOptionalPermission = Exclude<
             ManifestPermission,
@@ -9241,11 +9242,6 @@ export namespace Browser {
             | "webAuthenticationProxy"
         >;
 
-        /**
-         * @deprecated Use `ManifestOptionalPermission` instead.
-         */
-        type ManifestOptionalPermissions = ManifestOptionalPermission;
-
         interface SearchProvider {
             name?: string | undefined;
             keyword?: string | undefined;
@@ -10114,12 +10110,7 @@ export namespace Browser {
      * Permissions: "storage"
      */
     export namespace storage {
-        /** NoInfer for old TypeScript versions (Required TS 5.4+) */
-        type NoInferX<T> = T[][T extends any ? 0 : never];
-        // The next line prevents things without the export keyword from being automatically exported (like NoInferX)
-        export {};
-
-        export interface StorageArea {
+        interface StorageArea {
             /**
              * Gets the amount of space (in bytes) being used by one or more items.
              * @param keys A single key or list of keys to get the total usage for. An empty list will return 0. Pass in `null` to get the total usage of all of storage.
@@ -10166,11 +10157,11 @@ export namespace Browser {
              * Can return its result via Promise in Manifest V3 or later since Chrome 95.
              */
             get<T = { [key: string]: unknown }>(
-                keys?: NoInferX<keyof T> | Array<NoInferX<keyof T>> | Partial<NoInferX<T>> | null,
+                keys?: NoInfer<keyof T> | Array<NoInfer<keyof T>> | Partial<NoInfer<T>> | null | undefined,
             ): Promise<T>;
             get<T = { [key: string]: unknown }>(callback: (items: T) => void): void;
             get<T = { [key: string]: unknown }>(
-                keys: NoInferX<keyof T> | Array<NoInferX<keyof T>> | Partial<NoInferX<T>> | null | undefined,
+                keys: NoInfer<keyof T> | Array<NoInfer<keyof T>> | Partial<NoInfer<T>> | null | undefined,
                 callback: (items: T) => void,
             ): void;
 
@@ -10197,19 +10188,19 @@ export namespace Browser {
             getKeys(callback: (keys: string[]) => void): void;
         }
 
-        export interface StorageChange {
+        interface StorageChange {
             /** The new value of the item, if there is a new value. */
             newValue?: unknown;
             /** The old value of the item, if there was an old value. */
             oldValue?: unknown;
         }
 
-        export interface LocalStorageArea extends StorageArea {
+        interface LocalStorageArea extends StorageArea {
             /** The maximum amount (in bytes) of data that can be stored in local storage, as measured by the JSON stringification of every value plus every key's length. This value will be ignored if the extension has the unlimitedStorage permission. Updates that would cause this limit to be exceeded fail immediately and set runtime.lastError when using a callback, or a rejected Promise if using async/await. */
             QUOTA_BYTES: 10485760;
         }
 
-        export interface SyncStorageArea extends StorageArea {
+        interface SyncStorageArea extends StorageArea {
             /** @deprecated The storage.sync API no longer has a sustained write operation quota. */
             MAX_SUSTAINED_WRITE_OPERATIONS_PER_MINUTE: 1000000;
             /** The maximum total amount (in bytes) of data that can be stored in sync storage, as measured by the JSON stringification of every value plus every key's length. Updates that would cause this limit to be exceeded fail immediately and set runtime.lastError when using a callback, or when a Promise is rejected. */
@@ -10232,18 +10223,18 @@ export namespace Browser {
             MAX_WRITE_OPERATIONS_PER_MINUTE: 120;
         }
 
-        export interface SessionStorageArea extends StorageArea {
+        interface SessionStorageArea extends StorageArea {
             /** The maximum amount (in bytes) of data that can be stored in memory, as measured by estimating the dynamically allocated memory usage of every value and key. Updates that would cause this limit to be exceeded fail immediately and set runtime.lastError when using a callback, or when a Promise is rejected. */
             QUOTA_BYTES: 10485760;
         }
 
-        export type AreaName = "sync" | "local" | "managed" | "session";
+        type AreaName = "sync" | "local" | "managed" | "session";
 
         /**
          * The storage area's access level.
          * @since Chrome 102
          */
-        export enum AccessLevel {
+        enum AccessLevel {
             /** Specifies contexts originating from the extension itself. */
             TRUSTED_CONTEXTS = "TRUSTED_CONTEXTS",
             /** Specifies contexts originating from outside the extension. */
@@ -10251,13 +10242,13 @@ export namespace Browser {
         }
 
         /** Items in the `local` storage area are local to each machine. */
-        export const local: LocalStorageArea;
+        const local: LocalStorageArea;
 
         /** Items in the `sync` storage area are synced using Chrome Sync. */
-        export const sync: SyncStorageArea;
+        const sync: SyncStorageArea;
 
         /** Items in the `managed` storage area are set by an enterprise policy configured by the domain administrator, and are read-only for the extension; trying to modify this namespace results in an error. For information on configuring a policy, see Manifest for storage areas. */
-        export const managed: StorageArea;
+        const managed: StorageArea;
 
         /**
          * Items in the `session` storage area are stored in-memory and will not be persisted to disk.
@@ -10265,10 +10256,10 @@ export namespace Browser {
          * MV3 only
          * @since Chrome 102
          */
-        export const session: SessionStorageArea;
+        const session: SessionStorageArea;
 
         /** Fired when one or more items change. */
-        export const onChanged: events.Event<(changes: { [key: string]: StorageChange }, areaName: AreaName) => void>;
+        const onChanged: events.Event<(changes: { [key: string]: StorageChange }, areaName: AreaName) => void>;
     }
 
     ////////////////////
@@ -10291,10 +10282,6 @@ export namespace Browser {
             total: number;
         }
 
-        /** @deprecated Use {@link CpuTime} instead. */
-        // eslint-disable-next-line @typescript-eslint/no-empty-interface
-        interface ProcessorUsage extends CpuTime {}
-
         interface ProcessorInfo {
             /** Cumulative usage info for this logical processor. */
             usage: CpuTime;
@@ -12527,10 +12514,6 @@ export namespace Browser {
             reconnect?: string | undefined;
         }
 
-        /** @deprecated Use {@link Parameters} instead */
-        // eslint-disable-next-line @typescript-eslint/no-empty-interface
-        interface VpnSessionParameters extends Parameters {}
-
         /** The enum is used by the platform to notify the client of the VPN session status. */
         enum PlatformMessage {
             /** Indicates that the VPN configuration connected. */
@@ -13435,7 +13418,6 @@ export namespace Browser {
 
         /** Fired before sending an HTTP request, once the request headers are available. This may occur after a TCP connection is made to the server, but before any HTTP data is sent. */
         const onBeforeSendHeaders: WebRequestEvent<
-            // eslint-disable-next-line @typescript-eslint/no-invalid-void-type
             (details: OnBeforeSendHeadersDetails) => BlockingResponse | undefined,
             `${OnBeforeSendHeadersOptions}`[]
         >;