@wxt-dev/browser 0.1.1 → 0.1.4

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.1",
+  "version": "0.1.4",
   "type": "module",
   "main": "src/index.mjs",
   "types": "src/index.d.ts",
@@ -19,7 +19,7 @@
     "src"
   ],
   "devDependencies": {
-    "@types/chrome": "0.1.1",
+    "@types/chrome": "0.1.4",
     "fs-extra": "^11.3.0",
     "nano-spawn": "^0.2.0",
     "tsx": "4.19.4",

package/src/gen/index.d.ts

@@ -1088,267 +1088,209 @@ export namespace Browser {
      */
     export namespace browsingData {
         export interface OriginTypes {
-            /** Optional. Extensions and packaged applications a user has installed (be _really_ careful!).  */
+            /** Extensions and packaged applications a user has installed (be _really_ careful!). */
             extension?: boolean | undefined;
-            /** Optional. Websites that have been installed as hosted applications (be careful!).  */
+            /** Websites that have been installed as hosted applications (be careful!). */
             protectedWeb?: boolean | undefined;
-            /** Optional. Normal websites.  */
+            /** Normal websites. */
             unprotectedWeb?: boolean | undefined;
         }
 
         /** Options that determine exactly what data will be removed. */
         export interface RemovalOptions {
             /**
-             * Optional.
+             * When present, data for origins in this list is excluded from deletion. Can't be used together with `origins`. Only supported for cookies, storage and cache. Cookies are excluded for the whole registrable domain.
              * @since Chrome 74
-             * When present, data for origins in this list is excluded from deletion. Can't be used together with origins. Only supported for cookies, storage and cache. Cookies are excluded for the whole registrable domain.
              */
             excludeOrigins?: string[] | undefined;
-            /**
-             * Optional.
-             * An object whose properties specify which origin types ought to be cleared. If this object isn't specified, it defaults to clearing only "unprotected" origins. Please ensure that you _really_ want to remove application data before adding 'protectedWeb' or 'extensions'.
-             */
+            /** An object whose properties specify which origin types ought to be cleared. If this object isn't specified, it defaults to clearing only "unprotected" origins. Please ensure that you _really_ want to remove application data before adding 'protectedWeb' or 'extensions'. */
             originTypes?: OriginTypes | undefined;
             /**
-             * Optional.
-             * @since Chrome 74
              * When present, only data for origins in this list is deleted. Only supported for cookies, storage and cache. Cookies are cleared for the whole registrable domain.
+             * @since Chrome 74
              */
-            origins?: string[] | undefined;
-            /**
-             * Optional.
-             * Remove data accumulated on or after this date, represented in milliseconds since the epoch (accessible via the {@link Date.getTime} method). If absent, defaults to 0 (which would remove all browsing data).
-             */
+            origins?: [string, ...string[]] | undefined;
+            /** Remove data accumulated on or after this date, represented in milliseconds since the epoch (accessible via the {@link Date.getTime getTime} method of the JavaScript `Date` object). If absent, defaults to 0 (which would remove all browsing data). */
             since?: number | undefined;
         }
 
-        /**
-         * @since Chrome 27
-         * A set of data types. Missing data types are interpreted as false.
-         */
+        /** A set of data types. Missing data types are interpreted as `false`. */
         export interface DataTypeSet {
-            /** Optional. Websites' WebSQL data.  */
+            /** Websites' WebSQL data. */
             webSQL?: boolean | undefined;
-            /** Optional. Websites' IndexedDB data.  */
+            /** Websites' IndexedDB data. */
             indexedDB?: boolean | undefined;
-            /** Optional. The browser's cookies.  */
+            /** The browser's cookies. */
             cookies?: boolean | undefined;
-            /** Optional. Stored passwords.  */
+            /** Stored passwords. */
             passwords?: boolean | undefined;
             /**
-             * @deprecated Deprecated since Chrome 76.
-             * Support for server-bound certificates has been removed. This data type will be ignored.
-             *
-             * Optional. Server-bound certificates.
+             * Server-bound certificates.
+             * @deprecated since Chrome 76. Support for server-bound certificates has been removed. This data type will be ignored.
              */
             serverBoundCertificates?: boolean | undefined;
-            /** Optional. The browser's download list.  */
+            /** The browser's download list. */
             downloads?: boolean | undefined;
-            /** Optional. The browser's cache. Note: when removing data, this clears the entire cache: it is not limited to the range you specify.  */
+            /** The browser's cache. */
             cache?: boolean | undefined;
-            /** Optional. The browser's cacheStorage.  */
+            /** Cache storage. */
             cacheStorage?: boolean | undefined;
-            /** Optional. Websites' appcaches.  */
+            /** Websites' appcaches. */
             appcache?: boolean | undefined;
-            /** Optional. Websites' file systems.  */
+            /** Websites' file systems. */
             fileSystems?: boolean | undefined;
             /**
-             * @deprecated Deprecated since Chrome 88.
-             * Support for Flash has been removed. This data type will be ignored.
-             *
-             * Optional. Plugins' data.
+             * Plugins' data.
+             * @deprecated since Chrome 88. Support for Flash has been removed. This data type will be ignored.
              */
             pluginData?: boolean | undefined;
-            /** Optional. Websites' local storage data.  */
+            /** Websites' local storage data. */
             localStorage?: boolean | undefined;
-            /** Optional. The browser's stored form data.  */
+            /** The browser's stored form data. */
             formData?: boolean | undefined;
-            /** Optional. The browser's history.  */
+            /** The browser's history. */
             history?: boolean | undefined;
-            /**
-             * Optional.
-             * @since Chrome 39
-             * Service Workers.
-             */
+            /** Service Workers. */
             serviceWorkers?: boolean | undefined;
         }
 
         export interface SettingsResult {
             options: RemovalOptions;
-            /** All of the types will be present in the result, with values of true if they are both selected to be removed and permitted to be removed, otherwise false. */
+            /** All of the types will be present in the result, with values of `true` if they are both selected to be removed and permitted to be removed, otherwise `false`. */
             dataToRemove: DataTypeSet;
-            /** All of the types will be present in the result, with values of true if they are permitted to be removed (e.g., by enterprise policy) and false if not. */
+            /** All of the types will be present in the result, with values of `true` if they are permitted to be removed (e.g., by enterprise policy) and `false` if not. */
             dataRemovalPermitted: DataTypeSet;
         }
 
         /**
-         * @since Chrome 26
          * Reports which types of data are currently selected in the 'Clear browsing data' settings UI. Note: some of the data types included in this API are not available in the settings UI, and some UI settings control more than one data type listed here.
-         * @return The `settings` method provides its result via callback or returned as a `Promise` (MV3 only). It has no parameters.
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 96.
          */
         export function settings(): Promise<SettingsResult>;
-        /**
-         * @since Chrome 26
-         * Reports which types of data are currently selected in the 'Clear browsing data' settings UI. Note: some of the data types included in this API are not available in the settings UI, and some UI settings control more than one data type listed here.
-         */
         export function settings(callback: (result: SettingsResult) => void): void;
+
         /**
-         * @deprecated Deprecated since Chrome 88.
-         * Support for Flash has been removed. This function has no effect.
-         *
          * Clears plugins' data.
-         * @return The `removePluginData` method provides its result via callback or returned as a `Promise` (MV3 only). It has no parameters.
-         */
-        export function removePluginData(options: RemovalOptions): Promise<void>;
-        /**
-         * @deprecated Deprecated since Chrome 88.
-         * Support for Flash has been removed. This function has no effect.
          *
-         * Clears plugins' data.
-         * @param callback Called when plugins' data has been cleared.
+         * Can return its result via Promise in Manifest V3 or later since Chrome 96.
+         * @deprecated since Chrome 88. Support for Flash has been removed. This function has no effect
          */
+        export function removePluginData(options: RemovalOptions): Promise<void>;
         export function removePluginData(options: RemovalOptions, callback: () => void): void;
+
         /**
-         * @since Chrome 72
          * Clears websites' service workers.
-         * @return The `removeServiceWorkers` method provides its result via callback or returned as a `Promise` (MV3 only). It has no parameters.
-         */
-        export function removeServiceWorkers(options: RemovalOptions): Promise<void>;
-        /**
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 96.
          * @since Chrome 72
-         * Clears websites' service workers.
-         * @param callback Called when the browser's service workers have been cleared.
          */
+        export function removeServiceWorkers(options: RemovalOptions): Promise<void>;
         export function removeServiceWorkers(options: RemovalOptions, callback: () => void): void;
+
         /**
          * Clears the browser's stored form data (autofill).
-         * @return The `removeFormData` method provides its result via callback or returned as a `Promise` (MV3 only). It has no parameters.
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 96.
          */
         export function removeFormData(options: RemovalOptions): Promise<void>;
-        /**
-         * Clears the browser's stored form data (autofill).
-         * @param callback Called when the browser's form data has been cleared.
-         */
         export function removeFormData(options: RemovalOptions, callback: () => void): void;
+
         /**
          * Clears websites' file system data.
-         * @return The `removeFileSystems` method provides its result via callback or returned as a `Promise` (MV3 only). It has no parameters.
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 96.
          */
         export function removeFileSystems(options: RemovalOptions): Promise<void>;
-        /**
-         * Clears websites' file system data.
-         * @param callback Called when websites' file systems have been cleared.
-         */
         export function removeFileSystems(options: RemovalOptions, callback: () => void): void;
+
         /**
          * Clears various types of browsing data stored in a user's profile.
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 96.
          * @param dataToRemove The set of data types to remove.
-         * @return The `remove` method provides its result via callback or returned as a `Promise` (MV3 only). It has no parameters.
          */
         export function remove(options: RemovalOptions, dataToRemove: DataTypeSet): Promise<void>;
-        /**
-         * Clears various types of browsing data stored in a user's profile.
-         * @param dataToRemove The set of data types to remove.
-         * @param callback Called when deletion has completed.
-         */
         export function remove(options: RemovalOptions, dataToRemove: DataTypeSet, callback: () => void): void;
+
         /**
          * Clears the browser's stored passwords.
-         * @return The `removePasswords` method provides its result via callback or returned as a `Promise` (MV3 only). It has no parameters.
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 96.
          */
         export function removePasswords(options: RemovalOptions): Promise<void>;
-        /**
-         * Clears the browser's stored passwords.
-         * @param callback Called when the browser's passwords have been cleared.
-         */
         export function removePasswords(options: RemovalOptions, callback: () => void): void;
+
         /**
          * Clears the browser's cookies and server-bound certificates modified within a particular timeframe.
-         * @return The `removeCookies` method provides its result via callback or returned as a `Promise` (MV3 only). It has no parameters.
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 96.
          */
         export function removeCookies(options: RemovalOptions): Promise<void>;
-        /**
-         * Clears the browser's cookies and server-bound certificates modified within a particular timeframe.
-         * @param callback Called when the browser's cookies and server-bound certificates have been cleared.
-         */
         export function removeCookies(options: RemovalOptions, callback: () => void): void;
+
         /**
          * Clears websites' WebSQL data.
-         * @return The `removeWebSQL` method provides its result via callback or returned as a `Promise` (MV3 only). It has no parameters.
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 96.
          */
         export function removeWebSQL(options: RemovalOptions): Promise<void>;
-        /**
-         * Clears websites' WebSQL data.
-         * @param callback Called when websites' WebSQL databases have been cleared.
-         */
         export function removeWebSQL(options: RemovalOptions, callback: () => void): void;
+
         /**
          * Clears websites' appcache data.
-         * @return The `removeAppcache` method provides its result via callback or returned as a `Promise` (MV3 only). It has no parameters.
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 96.
          */
         export function removeAppcache(options: RemovalOptions): Promise<void>;
-        /**
-         * Clears websites' appcache data.
-         * @param callback Called when websites' appcache data has been cleared.
-         */
         export function removeAppcache(options: RemovalOptions, callback: () => void): void;
-        /** Clears websites' cache storage data.
-         * @return The `removeCacheStorage` method provides its result via callback or returned as a `Promise` (MV3 only). It has no parameters.
+
+        /**
+         * Clears websites' cache storage data.
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 96.
          */
         export function removeCacheStorage(options: RemovalOptions): Promise<void>;
-        /** Clears websites' cache storage data.
-         * @param callback Called when websites' appcache data has been cleared.
-         */
         export function removeCacheStorage(options: RemovalOptions, callback: () => void): void;
+
         /**
          * Clears the browser's list of downloaded files (not the downloaded files themselves).
-         * @return The `removeDownloads` method provides its result via callback or returned as a `Promise` (MV3 only). It has no parameters.
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 96.
          */
         export function removeDownloads(options: RemovalOptions): Promise<void>;
-        /**
-         * Clears the browser's list of downloaded files (not the downloaded files themselves).
-         * @param callback Called when the browser's list of downloaded files has been cleared.
-         */
         export function removeDownloads(options: RemovalOptions, callback: () => void): void;
+
         /**
          * Clears websites' local storage data.
-         * @return The `removeLocalStorage` method provides its result via callback or returned as a `Promise` (MV3 only). It has no parameters.
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 96.
          */
         export function removeLocalStorage(options: RemovalOptions): Promise<void>;
-        /**
-         * Clears websites' local storage data.
-         * @param callback Called when websites' local storage has been cleared.
-         */
         export function removeLocalStorage(options: RemovalOptions, callback: () => void): void;
+
         /**
          * Clears the browser's cache.
-         * @return The `removeCache` method provides its result via callback or returned as a `Promise` (MV3 only). It has no parameters.
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 96.
          */
         export function removeCache(options: RemovalOptions): Promise<void>;
-        /**
-         * Clears the browser's cache.
-         * @param callback Called when the browser's cache has been cleared.
-         */
         export function removeCache(options: RemovalOptions, callback: () => void): void;
+
         /**
          * Clears the browser's history.
-         * @return The `removeHistory` method provides its result via callback or returned as a `Promise` (MV3 only). It has no parameters.
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 96.
          */
         export function removeHistory(options: RemovalOptions): Promise<void>;
-        /**
-         * Clears the browser's history.
-         * @param callback Called when the browser's history has cleared.
-         */
         export function removeHistory(options: RemovalOptions, callback: () => void): void;
+
         /**
          * Clears websites' IndexedDB data.
-         * @return The `removeIndexedDB` method provides its result via callback or returned as a `Promise` (MV3 only). It has no parameters.
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 96.
          */
         export function removeIndexedDB(options: RemovalOptions): Promise<void>;
-        /**
-         * Clears websites' IndexedDB data.
-         * @param callback Called when websites' IndexedDB data has been cleared.
-         */
         export function removeIndexedDB(options: RemovalOptions, callback: () => void): void;
     }
 
@@ -1602,29 +1544,24 @@ export namespace Browser {
      */
     export namespace commands {
         export interface Command {
-            /** Optional. The name of the Extension Command  */
-            name?: string | undefined;
-            /** Optional. The Extension Command description  */
-            description?: string | undefined;
-            /** Optional. The shortcut active for this command, or blank if not active.  */
-            shortcut?: string | undefined;
+            /** The name of the Extension Command */
+            name?: string;
+            /** The Extension Command description */
+            description?: string;
+            /** The shortcut active for this command, or blank if not active. */
+            shortcut?: string;
         }
 
-        export interface CommandEvent extends Browser.events.Event<(command: string, tab: Browser.tabs.Tab) => void> {}
-
         /**
-         * Returns all the registered extension commands for this extension and their shortcut (if active).
-         * @return The `getAll` method provides its result via callback or returned as a `Promise` (MV3 only).
+         * Returns all the registered extension commands for this extension and their shortcut (if active). Before Chrome 110, this command did not return `_execute_action`.
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 96.
          */
         export function getAll(): Promise<Command[]>;
-        /**
-         * Returns all the registered extension commands for this extension and their shortcut (if active).
-         * @param callback Called to return the registered commands.
-         */
         export function getAll(callback: (commands: Command[]) => void): void;
 
         /** Fired when a registered command is activated using a keyboard shortcut. */
-        export var onCommand: CommandEvent;
+        export const onCommand: events.Event<(command: string, tab?: tabs.Tab) => void>;
     }
 
     ////////////////////
@@ -2151,7 +2088,12 @@ export namespace Browser {
      */
     export namespace cookies {
         /** A cookie's 'SameSite' state (https://tools.ietf.org/html/draft-west-first-party-cookies). 'no_restriction' corresponds to a cookie set with 'SameSite=None', 'lax' to 'SameSite=Lax', and 'strict' to 'SameSite=Strict'. 'unspecified' corresponds to a cookie set without the SameSite attribute. **/
-        export type SameSiteStatus = "unspecified" | "no_restriction" | "lax" | "strict";
+        export enum SameSiteStatus {
+            NO_RESTRICTION = "no_restriction",
+            LAX = "lax",
+            STRICT = "strict",
+            UNSPECIFIED = "unspecified",
+        }
 
         /** Represents information about an HTTP cookie. */
         export interface Cookie {
@@ -2172,8 +2114,8 @@ export namespace Browser {
             session: boolean;
             /** True if the cookie is a host-only cookie (i.e. a request's host must exactly match the domain of the cookie). */
             hostOnly: boolean;
-            /** Optional. The expiration date of the cookie as the number of seconds since the UNIX epoch. Not provided for session cookies.  */
-            expirationDate?: number | undefined;
+            /** The expiration date of the cookie as the number of seconds since the UNIX epoch. Not provided for session cookies. */
+            expirationDate?: number;
             /** The path of the cookie. */
             path: string;
             /** True if the cookie is marked as HttpOnly (i.e. the cookie is inaccessible to client-side scripts). */
@@ -2184,10 +2126,13 @@ export namespace Browser {
              * The cookie's same-site status (i.e. whether the cookie is sent with cross-site requests).
              * @since Chrome 51
              */
-            sameSite: SameSiteStatus;
+            sameSite: `${SameSiteStatus}`;
         }
 
-        /** Represents a partitioned cookie's partition key. */
+        /**
+         * Represents a partitioned cookie's partition key.
+         * @since Chrome 119
+         */
         export interface CookiePartitionKey {
             /**
              * Indicates if the cookie was set in a cross-cross site context. This prevents a top-level site embedded in a cross-site context from accessing cookies set by the top-level site in a same-site context.
@@ -2207,31 +2152,31 @@ export namespace Browser {
         }
 
         export interface GetAllDetails {
-            /** Optional. Restricts the retrieved cookies to those whose domains match or are subdomains of this one.  */
+            /** Restricts the retrieved cookies to those whose domains match or are subdomains of this one. */
             domain?: string | undefined;
-            /** Optional. Filters the cookies by name.  */
+            /** Filters the cookies by name. */
             name?: string | undefined;
             /**
              * The partition key for reading or modifying cookies with the Partitioned attribute.
              * @since Chrome 119
              */
             partitionKey?: CookiePartitionKey | undefined;
-            /** Optional. Restricts the retrieved cookies to those that would match the given URL.  */
+            /** Restricts the retrieved cookies to those that would match the given URL. */
             url?: string | undefined;
-            /** Optional. The cookie store to retrieve cookies from. If omitted, the current execution context's cookie store will be used.  */
+            /** The cookie store to retrieve cookies from. If omitted, the current execution context's cookie store will be used. */
             storeId?: string | undefined;
-            /** Optional. Filters out session vs. persistent cookies.  */
+            /** Filters out session vs. persistent cookies. */
             session?: boolean | undefined;
-            /** Optional. Restricts the retrieved cookies to those whose path exactly matches this string.  */
+            /** Restricts the retrieved cookies to those whose path exactly matches this string. */
             path?: string | undefined;
-            /** Optional. Filters the cookies by their Secure property.  */
+            /** Filters the cookies by their Secure property. */
             secure?: boolean | undefined;
         }
 
         export interface SetDetails {
-            /** Optional. The domain of the cookie. If omitted, the cookie becomes a host-only cookie.  */
+            /** The domain of the cookie. If omitted, the cookie becomes a host-only cookie. */
             domain?: string | undefined;
-            /** Optional. The name of the cookie. Empty by default if omitted.  */
+            /** The name of the cookie. Empty by default if omitted. */
             name?: string | undefined;
             /**
              * The partition key for reading or modifying cookies with the Partitioned attribute.
@@ -2240,26 +2185,29 @@ export namespace Browser {
             partitionKey?: CookiePartitionKey | undefined;
             /** The request-URI to associate with the setting of the cookie. This value can affect the default domain and path values of the created cookie. If host permissions for this URL are not specified in the manifest file, the API call will fail. */
             url: string;
-            /** Optional. The ID of the cookie store in which to set the cookie. By default, the cookie is set in the current execution context's cookie store.  */
+            /** The ID of the cookie store in which to set the cookie. By default, the cookie is set in the current execution context's cookie store. */
             storeId?: string | undefined;
-            /** Optional. The value of the cookie. Empty by default if omitted.  */
+            /** The value of the cookie. Empty by default if omitted. */
             value?: string | undefined;
-            /** Optional. The expiration date of the cookie as the number of seconds since the UNIX epoch. If omitted, the cookie becomes a session cookie.  */
+            /** The expiration date of the cookie as the number of seconds since the UNIX epoch. If omitted, the cookie becomes a session cookie. */
             expirationDate?: number | undefined;
-            /** Optional. The path of the cookie. Defaults to the path portion of the url parameter.  */
+            /** The path of the cookie. Defaults to the path portion of the url parameter. */
             path?: string | undefined;
-            /** Optional. Whether the cookie should be marked as HttpOnly. Defaults to false.  */
+            /** Whether the cookie should be marked as HttpOnly. Defaults to false. */
             httpOnly?: boolean | undefined;
-            /** Optional. Whether the cookie should be marked as Secure. Defaults to false.  */
+            /** Whether the cookie should be marked as Secure. Defaults to false. */
             secure?: boolean | undefined;
             /**
-             * Optional. The cookie's same-site status. Defaults to "unspecified", i.e., if omitted, the cookie is set without specifying a SameSite attribute.
+             * The cookie's same-site status. Defaults to "unspecified", i.e., if omitted, the cookie is set without specifying a SameSite attribute.
              * @since Chrome 51
              */
-            sameSite?: SameSiteStatus | undefined;
+            sameSite?: `${SameSiteStatus}` | undefined;
         }
 
-        /** Details to identify the cookie. */
+        /**
+         * Details to identify the cookie.
+         * @since Chrome 88
+         */
         export interface CookieDetails {
             /** The name of the cookie to access. */
             name: string;
@@ -2279,11 +2227,8 @@ export namespace Browser {
             cookie: Cookie;
             /** True if a cookie was removed. */
             removed: boolean;
-            /**
-             * @since Chrome 12
-             * The underlying reason behind the cookie's change.
-             */
-            cause: string;
+            /** The underlying reason behind the cookie's change. */
+            cause: `${OnChangedCause}`;
         }
 
         /**
@@ -2292,30 +2237,37 @@ export namespace Browser {
          */
         export interface FrameDetails {
             /** The unique identifier for the document. If the frameId and/or tabId are provided they will be validated to match the document found by provided document ID. */
-            documentId?: string;
+            documentId?: string | undefined;
             /** The unique identifier for the frame within the tab. */
-            frameId?: number;
+            frameId?: number | undefined;
             /* The unique identifier for the tab containing the frame. */
-            tabId?: number;
+            tabId?: number | undefined;
         }
 
-        export interface CookieChangedEvent extends Browser.events.Event<(changeInfo: CookieChangeInfo) => void> {}
-
         /**
-         * Lists all existing cookie stores.
-         * Parameter cookieStores: All the existing cookie stores.
+         * The underlying reason behind the cookie's change. If a cookie was inserted, or removed via an explicit call to "Browser.cookies.remove", "cause" will be "explicit". If a cookie was automatically removed due to expiry, "cause" will be "expired". If a cookie was removed due to being overwritten with an already-expired expiration date, "cause" will be set to "expired_overwrite". If a cookie was automatically removed due to garbage collection, "cause" will be "evicted". If a cookie was automatically removed due to a "set" call that overwrote it, "cause" will be "overwrite". Plan your response accordingly.
+         * @since Chrome 44
          */
-        export function getAllCookieStores(callback: (cookieStores: CookieStore[]) => void): void;
+        export enum OnChangedCause {
+            EVICTED = "evicted",
+            EXPIRED = "expired",
+            EXPLICIT = "explicit",
+            EXPIRED_OVERWRITE = "expired_overwrite",
+            OVERWRITE = "overwrite",
+        }
 
         /**
          * Lists all existing cookie stores.
-         * @return The `getAllCookieStores` method provides its result via callback or returned as a `Promise` (MV3 only).
+         *
+         * Can return its result via Promise in Manifest V3 or later.
          */
         export function getAllCookieStores(): Promise<CookieStore[]>;
+        export function getAllCookieStores(callback: (cookieStores: CookieStore[]) => void): void;
 
         /**
          * The partition key for the frame indicated.
-         * Can return its result via Promise in Manifest V3
+         *
+         * Can return its result via Promise in Manifest V3 or later.
          * @since Chrome 132
          */
         export function getPartitionKey(details: FrameDetails): Promise<{ partitionKey: CookiePartitionKey }>;
@@ -2325,62 +2277,41 @@ export namespace Browser {
         ): void;
 
         /**
-         * Retrieves all cookies from a single cookie store that match the given information. The cookies returned will be sorted, with those with the longest path first. If multiple cookies have the same path length, those with the earliest creation time will be first.
-         * @param details Information to filter the cookies being retrieved.
-         * Parameter cookies: All the existing, unexpired cookies that match the given cookie info.
-         */
-        export function getAll(details: GetAllDetails, callback: (cookies: Cookie[]) => void): void;
-
-        /**
-         * Retrieves all cookies from a single cookie store that match the given information. The cookies returned will be sorted, with those with the longest path first. If multiple cookies have the same path length, those with the earliest creation time will be first.
-         * @param details Information to filter the cookies being retrieved.
-         * @return The `getAll` method provides its result via callback or returned as a `Promise` (MV3 only).
+         * Retrieves all cookies from a single cookie store that match the given information. The cookies returned will be sorted, with those with the longest path first. If multiple cookies have the same path length, those with the earliest creation time will be first. This method only retrieves cookies for domains that the extension has host permissions to
+         * @param details Information to identify the cookie to remove.
+         *
+         * Can return its result via Promise in Manifest V3 or later.
          */
         export function getAll(details: GetAllDetails): Promise<Cookie[]>;
+        export function getAll(details: GetAllDetails, callback: (cookies: Cookie[]) => void): void;
 
         /**
          * Sets a cookie with the given cookie data; may overwrite equivalent cookies if they exist.
          * @param details Details about the cookie being set.
-         * @return The `set` method provides its result via callback or returned as a `Promise` (MV3 only).
+         *
+         * Can return its result via Promise in Manifest V3 or later.
          */
         export function set(details: SetDetails): Promise<Cookie | null>;
-
-        /**
-         * Sets a cookie with the given cookie data; may overwrite equivalent cookies if they exist.
-         * @param details Details about the cookie being set.
-         * Optional parameter cookie: Contains details about the cookie that's been set. If setting failed for any reason, this will be "null", and "Browser.runtime.lastError" will be set.
-         */
         export function set(details: SetDetails, callback: (cookie: Cookie | null) => void): void;
 
         /**
          * Deletes a cookie by name.
-         * @param details Information to identify the cookie to remove.
-         * @return The `remove` method provides its result via callback or returned as a `Promise` (MV3 only).
+         *
+         * Can return its result via Promise in Manifest V3 or later.
          */
         export function remove(details: CookieDetails): Promise<CookieDetails>;
-
-        /**
-         * Deletes a cookie by name.
-         * @param details Information to identify the cookie to remove.
-         */
         export function remove(details: CookieDetails, callback?: (details: CookieDetails) => void): void;
 
         /**
          * Retrieves information about a single cookie. If more than one cookie of the same name exists for the given URL, the one with the longest path will be returned. For cookies with the same path length, the cookie with the earliest creation time will be returned.
-         * @param details Details to identify the cookie being retrieved.
-         * Parameter cookie: Contains details about the cookie. This parameter is null if no such cookie was found.
-         */
-        export function get(details: CookieDetails, callback: (cookie: Cookie | null) => void): void;
-
-        /**
-         * Retrieves information about a single cookie. If more than one cookie of the same name exists for the given URL, the one with the longest path will be returned. For cookies with the same path length, the cookie with the earliest creation time will be returned.
-         * @param details Details to identify the cookie being retrieved.
-         * @return The `get` method provides its result via callback or returned as a `Promise` (MV3 only).
+         *
+         * Can return its result via Promise in Manifest V3 or later.
          */
         export function get(details: CookieDetails): Promise<Cookie | null>;
+        export function get(details: CookieDetails, callback: (cookie: Cookie | null) => void): void;
 
         /** Fired when a cookie is set or removed. As a special case, note that updating a cookie's properties is implemented as a two step process: the cookie to be updated is first removed entirely, generating a notification with "cause" of "overwrite" . Afterwards, a new cookie is written with the updated values, generating a second notification with "cause" "explicit". */
-        export var onChanged: CookieChangedEvent;
+        export const onChanged: events.Event<(changeInfo: CookieChangeInfo) => void>;
     }
 
     ////////////////////
@@ -2688,31 +2619,39 @@ export namespace Browser {
      * Permissions: "desktopCapture"
      */
     export namespace desktopCapture {
-        /** Contains properties that describe the stream. */
+        /** Enum used to define set of desktop media sources used in {@link chooseDesktopMedia}. */
+        export enum DesktopCaptureSourceType {
+            SCREEN = "screen",
+            WINDOW = "window",
+            TAB = "tab",
+            AUDIO = "audio",
+        }
+
+        /**
+         * Contains properties that describe the stream.
+         * @since Chrome 57
+         */
         export interface StreamOptions {
             /** True if "audio" is included in parameter sources, and the end user does not uncheck the "Share audio" checkbox. Otherwise false, and in this case, one should not ask for audio stream through getUserMedia call. */
             canRequestAudioTrack: boolean;
         }
         /**
          * Shows desktop media picker UI with the specified set of sources.
-         * @param sources Set of sources that should be shown to the user.
-         * Parameter streamId: An opaque string that can be passed to getUserMedia() API to generate media stream that corresponds to the source selected by the user. If user didn't select any source (i.e. canceled the prompt) then the callback is called with an empty streamId. The created streamId can be used only once and expires after a few seconds when it is not used.
+         * @param sources Set of sources that should be shown to the user. The sources order in the set decides the tab order in the picker.
+         * @param targetTab Optional tab for which the stream is created. If not specified then the resulting stream can be used only by the calling extension. The stream can only be used by frames in the given tab whose security origin matches `tab.url`. The tab's origin must be a secure origin, e.g. HTTPS.
+         * @param callback streamId: An opaque string that can be passed to `getUserMedia()` API to generate media stream that corresponds to the source selected by the user. If user didn't select any source (i.e. canceled the prompt) then the callback is called with an empty `streamId`. The created `streamId` can be used only once and expires after a few seconds when it is not used.
+         * @return An id that can be passed to cancelChooseDesktopMedia() in case the prompt need to be canceled.
          */
         export function chooseDesktopMedia(
-            sources: string[],
+            sources: `${DesktopCaptureSourceType}`[],
             callback: (streamId: string, options: StreamOptions) => void,
         ): number;
-        /**
-         * Shows desktop media picker UI with the specified set of sources.
-         * @param sources Set of sources that should be shown to the user.
-         * @param targetTab Optional tab for which the stream is created. If not specified then the resulting stream can be used only by the calling extension. The stream can only be used by frames in the given tab whose security origin matches tab.url.
-         * Parameter streamId: An opaque string that can be passed to getUserMedia() API to generate media stream that corresponds to the source selected by the user. If user didn't select any source (i.e. canceled the prompt) then the callback is called with an empty streamId. The created streamId can be used only once and expires after a few seconds when it is not used.
-         */
         export function chooseDesktopMedia(
-            sources: string[],
-            targetTab: Browser.tabs.Tab,
+            sources: `${DesktopCaptureSourceType}`[],
+            targetTab: tabs.Tab | undefined,
             callback: (streamId: string, options: StreamOptions) => void,
         ): number;
+
         /**
          * Hides desktop media picker dialog shown by chooseDesktopMedia().
          * @param desktopMediaRequestId Id returned by chooseDesktopMedia()
@@ -2928,7 +2867,7 @@ export namespace Browser {
 
         export interface PanelSearchEvent extends Browser.events.Event<(action: string, queryString?: string) => void> {}
 
-        /** Represents a panel created by extension. */
+        /** Represents a panel created by an extension. */
         export interface ExtensionPanel {
             /**
              * Appends a button to the status bar of the panel.
@@ -4327,6 +4266,24 @@ export namespace Browser {
         export function getHardwarePlatformInfo(callback: (info: HardwarePlatformInfo) => void): void;
     }
 
+    ////////////////////
+    // Enterprise Login
+    ////////////////////
+    /**
+     * Use the `Browser.enterprise.login` API to exit Managed Guest sessions. Note: This API is only available to extensions installed by enterprise policy in ChromeOS Managed Guest sessions.
+     *
+     * Permissions: "enterprise.login"
+     *
+     * Note: Only available to policy installed extensions.
+     * @platform ChromeOS only
+     * @since Chrome 139
+     */
+    export namespace enterprise.login {
+        /** Exits the current managed guest session. */
+        export function exitCurrentManagedGuestSession(): Promise<void>;
+        export function exitCurrentManagedGuestSession(callback: () => void): void;
+    }
+
     ////////////////////
     // Enterprise Networking Attributes
     ////////////////////
@@ -8345,10 +8302,7 @@ export namespace Browser {
              */
             relatedWebsiteSetsEnabled: Browser.types.ChromeSetting<boolean>;
 
-            /**
-             * If disabled, Chrome blocks third-party sites from setting cookies.
-             * The value of this preference is of type boolean, and the default value is `true`.
-             */
+            /** If disabled, Chrome blocks third-party sites from setting cookies. The value of this preference is of type boolean, and the default value is `true`. Extensions may not enable this API in Incognito mode, where third-party cookies are blocked and can only be allowed at the site level. If you try setting this API to true in Incognito, it will throw an error. */
             thirdPartyCookiesAllowed: Browser.types.ChromeSetting<boolean>;
 
             /**
@@ -8639,6 +8593,8 @@ export namespace Browser {
             MIPS = "mips",
             /** Specifies the processer architecture as mips64. */
             MIPS64 = "mips64",
+            /** Specifies the processer architecture as riscv64. */
+            RISCV64 = "riscv64",
         }
 
         /**
@@ -8805,7 +8761,7 @@ export namespace Browser {
             /** The machine's processor architecture. */
             arch: `${PlatformArch}`;
             /** The native client architecture. This may be different from arch on some platforms. */
-            nacl_arch: `${PlatformNaclArch}`;
+            nacl_arch?: `${PlatformNaclArch}`;
         }
 
         /** An object which allows two way communication with other pages. */
@@ -8894,6 +8850,7 @@ export namespace Browser {
             | "downloads.ui"
             | "enterprise.deviceAttributes"
             | "enterprise.hardwarePlatform"
+            | "enterprise.login"
             | "enterprise.networkingAttributes"
             | "enterprise.platformKeys"
             | "experimental"
@@ -9917,14 +9874,14 @@ export namespace Browser {
              */
             get<T = { [key: string]: any }>(callback: (items: T) => void): void;
             /**
-             * Sets the desired access level for the storage area. The default will be only trusted contexts.
+             * Sets the desired access level for the storage area. By default, session storage is restricted to trusted contexts (extension pages and service workers), while managed, local, and sync storage allow access from both trusted and untrusted contexts.
              * @param accessOptions An object containing an accessLevel key which contains the access level of the storage area.
              * @return A void Promise.
              * @since Chrome 102
              */
             setAccessLevel(accessOptions: { accessLevel: AccessLevel }): Promise<void>;
             /**
-             * Sets the desired access level for the storage area. The default will be only trusted contexts.
+             * Sets the desired access level for the storage area. By default, session storage is restricted to trusted contexts (extension pages and service workers), while managed, local, and sync storage allow access from both trusted and untrusted contexts.
              * @param accessOptions An object containing an accessLevel key which contains the access level of the storage area.
              * @param callback Optional.
              * @since Chrome 102