@wxt-dev/browser 0.2.2 → 0.2.6

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.2.2",
+  "version": "0.2.6",
   "type": "module",
   "main": "src/index.mjs",
   "types": "src/index.d.ts",
@@ -25,11 +25,10 @@
     "src"
   ],
   "devDependencies": {
-    "@types/chrome": "0.2.2",
-    "@types/node": "^20.17.6",
-    "nano-spawn": "^2.0.0",
+    "@types/chrome": "0.2.6",
+    "@types/node": "^22",
     "typescript": "^6.0.3",
-    "vitest": "^4.1.5"
+    "vitest": "^4.1.10"
   },
   "dependencies": {
     "@types/filesystem": "*",

package/src/gen/index.d.ts

@@ -170,7 +170,7 @@ export namespace Browser {
         interface TitleDetails {
             /** The string the action should display when moused over. */
             title: string;
-            /** Limits the change to when a particular tab is selected. Automatically resets when the tab is closed.  */
+            /** Limits the change to when a particular tab is selected. Automatically resets when the tab is closed. */
             tabId?: number | undefined;
         }
 
@@ -181,23 +181,34 @@ export namespace Browser {
             popup: string;
         }
 
-        interface TabIconDetails {
-            /** Either a relative image path or a dictionary {size -> relative image path} pointing to icon to be set. If the icon is specified as a dictionary, the actual image to be used is chosen depending on screen's pixel density. If the number of image pixels that fit into one screen space unit equals `scale`, then image with size `scale` \* n will be selected, where n is the size of the icon in the UI. At least one image must be specified. Note that 'details.path = foo' is equivalent to 'details.path = {'16': foo}' */
-            path?: string | { [index: number]: string } | undefined;
-            /** Limits the change to when a particular tab is selected. Automatically resets when the tab is closed.  */
-            tabId?: number | undefined;
-            /** Either an ImageData object or a dictionary {size -> ImageData} representing icon to be set. If the icon is specified as a dictionary, the actual image to be used is chosen depending on screen's pixel density. If the number of image pixels that fit into one screen space unit equals `scale`, then image with size `scale` \* n will be selected, where n is the size of the icon in the UI. At least one image must be specified. Note that 'details.imageData = foo' is equivalent to 'details.imageData = {'16': foo}' */
-            imageData?: ImageData | { [index: number]: ImageData } | undefined;
-        }
+        type TabIconDetails =
+            & {
+                /** Limits the change to when a particular tab is selected. Automatically resets when the tab is closed. */
+                tabId?: number | null | undefined;
+            }
+            & (
+                | {
+                    /** Either an ImageData object or a dictionary {size -> ImageData} representing an icon to be set. If the icon is specified as a dictionary, the image used is chosen depending on the screen's pixel density. If the number of image pixels that fit into one screen space unit equals `scale`, then an image with size `scale` \* n is selected, where _n_ is the size of the icon in the UI. At least one image must be specified. Note that 'details.imageData = foo' is equivalent to 'details.imageData = {'16': foo}' */
+                    imageData: ImageData | { [index: number]: ImageData };
+                    /** Either a relative image path or a dictionary {size -> relative image path} pointing to an icon to be set. If the icon is specified as a dictionary, the image used is chosen depending on the screen's pixel density. If the number of image pixels that fit into one screen space unit equals `scale`, then an image with size `scale` \* n is selected, where _n_ is the size of the icon in the UI. At least one image must be specified. Note that 'details.path = foo' is equivalent to 'details.path = {'16': foo}' */
+                    path?: string | { [index: string]: string } | undefined;
+                }
+                | {
+                    /** Either an ImageData object or a dictionary {size -> ImageData} representing an icon to be set. If the icon is specified as a dictionary, the image used is chosen depending on the screen's pixel density. If the number of image pixels that fit into one screen space unit equals `scale`, then an image with size `scale` \* n is selected, where _n_ is the size of the icon in the UI. At least one image must be specified. Note that 'details.imageData = foo' is equivalent to 'details.imageData = {'16': foo}' */
+                    imageData?: ImageData | { [index: number]: ImageData } | undefined;
+                    /** Either a relative image path or a dictionary {size -> relative image path} pointing to an icon to be set. If the icon is specified as a dictionary, the image used is chosen depending on the screen's pixel density. If the number of image pixels that fit into one screen space unit equals `scale`, then an image with size `scale` \* n is selected, where _n_ is the size of the icon in the UI. At least one image must be specified. Note that 'details.path = foo' is equivalent to 'details.path = {'16': foo}' */
+                    path: string | { [index: string]: string };
+                }
+            );
 
         /** @since Chrome 99 */
         interface OpenPopupOptions {
-            /** The id of the window to open the action popup in. Defaults to the currently-active window if unspecified.  */
+            /** The id of the window to open the action popup in. Defaults to the currently-active window if unspecified. */
             windowId?: number | undefined;
         }
 
         interface TabDetails {
-            /** The ID of the tab to query state for. If no tab is specified, the non-tab-specific state is returned.  */
+            /** The ID of the tab to query state for. If no tab is specified, the non-tab-specific state is returned. */
             tabId?: number | undefined;
         }
 
@@ -393,24 +404,24 @@ export namespace Browser {
             }
             & (
                 | {
-                    /** Length of time in minutes after which the {@link onAlarm} event should fire.  */
+                    /** Length of time in minutes after which the {@link onAlarm} event should fire. */
                     delayInMinutes: number;
                     /** If set, the onAlarm event should fire every `periodInMinutes` minutes after the initial event specified by `when` or `delayInMinutes`. If not set, the alarm will only fire once. */
                     periodInMinutes?: number | undefined;
                     /** Time at which the alarm should fire, in milliseconds past the epoch (e.g. `Date.now() + n`). */
-                    when?: never | undefined;
+                    when?: undefined;
                 }
                 | {
-                    /** Length of time in minutes after which the {@link onAlarm} event should fire.  */
+                    /** Length of time in minutes after which the {@link onAlarm} event should fire. */
                     delayInMinutes?: number | undefined;
                     /** If set, the onAlarm event should fire every `periodInMinutes` minutes after the initial event specified by `when` or `delayInMinutes`. If not set, the alarm will only fire once. */
                     periodInMinutes: number;
                     /** Time at which the alarm should fire, in milliseconds past the epoch (e.g. `Date.now() + n`). */
-                    when?: number | undefined;
+                    when?: undefined;
                 }
                 | {
-                    /** Length of time in minutes after which the {@link onAlarm} event should fire.  */
-                    delayInMinutes?: never | undefined;
+                    /** Length of time in minutes after which the {@link onAlarm} event should fire. */
+                    delayInMinutes?: undefined;
                     /** If set, the onAlarm event should fire every `periodInMinutes` minutes after the initial event specified by `when` or `delayInMinutes`. If not set, the alarm will only fire once. */
                     periodInMinutes?: number | undefined;
                     /** Time at which the alarm should fire, in milliseconds past the epoch (e.g. `Date.now() + n`). */
@@ -824,7 +835,7 @@ export namespace Browser {
         function removeTree(id: string, callback: () => void): void;
 
         interface SearchQuery {
-            /** A string of words and quoted phrases that are matched against bookmark URLs and titles.*/
+            /** A string of words and quoted phrases that are matched against bookmark URLs and titles. */
             query?: string;
             /** The URL of the bookmark; matches verbatim. Note that folders have no URL. */
             url?: string;
@@ -854,7 +865,7 @@ export namespace Browser {
         function update(id: string, changes: UpdateChanges): Promise<BookmarkTreeNode>;
         function update(id: string, changes: UpdateChanges, callback: (result: BookmarkTreeNode) => void): void;
 
-        /** Fired when a bookmark or folder changes. **Note:** Currently, only title and url changes trigger this.*/
+        /** Fired when a bookmark or folder changes. **Note:** Currently, only title and url changes trigger this. */
         const onChanged: events.Event<(id: string, changeInfo: { title: string; url?: string }) => void>;
 
         /** Fired when the children of a folder have changed their order due to the order being sorted in the UI. This is not called as a result of a move(). */
@@ -866,7 +877,7 @@ export namespace Browser {
         /** Fired when a bookmark import session is begun. Expensive observers should ignore onCreated updates until onImportEnded is fired. Observers should still handle other notifications immediately. */
         const onImportBegan: events.Event<() => void>;
 
-        /** Fired when a bookmark import session is ended.  */
+        /** Fired when a bookmark import session is ended. */
         const onImportEnded: events.Event<() => void>;
 
         /** Fired when a bookmark or folder is moved to a different parent folder. */
@@ -924,7 +935,7 @@ export namespace Browser {
         interface TitleDetails {
             /** The string the browser action should display when moused over. */
             title: string;
-            /** Optional. Limits the change to when a particular tab is selected. Automatically resets when the tab is closed.  */
+            /** Optional. Limits the change to when a particular tab is selected. Automatically resets when the tab is closed. */
             tabId?: number | null | undefined;
         }
 
@@ -956,7 +967,7 @@ export namespace Browser {
         interface PopupDetails {
             /** Limits the change to when a particular tab is selected. Automatically resets when the tab is closed. */
             tabId?: number | null | undefined;
-            /** The relative path to the HTML file to show in a popup. If set to the empty string (`''`), no popup is shown.*/
+            /** The relative path to the HTML file to show in a popup. If set to the empty string (`''`), no popup is shown. */
             popup: string;
         }
 
@@ -1062,7 +1073,10 @@ export namespace Browser {
 
         /** A set of data types. Missing data types are interpreted as `false`. */
         interface DataTypeSet {
-            /** Websites' WebSQL data. */
+            /**
+             * Websites' WebSQL data.
+             * @deprecated since Chrome 139. Support for WebSQL has been removed. This data type will be ignored.
+             */
             webSQL?: boolean | undefined;
             /** Websites' IndexedDB data. */
             indexedDB?: boolean | undefined;
@@ -1084,7 +1098,10 @@ export namespace Browser {
             cache?: boolean | undefined;
             /** Cache storage. */
             cacheStorage?: boolean | undefined;
-            /** Websites' appcaches. */
+            /**
+             * Websites' appcaches.
+             * @deprecated since Chrome 98. Support for appcache has been removed. This data type will be ignored.
+             */
             appcache?: boolean | undefined;
             /** Websites' file systems. */
             fileSystems?: boolean | undefined;
@@ -1183,6 +1200,7 @@ export namespace Browser {
          * Clears websites' WebSQL data.
          *
          * Can return its result via Promise in Manifest V3 or later since Chrome 96.
+         * @deprecated since Chrome 139. Support for WebSQL has been removed. This function has no effect.
          */
         function removeWebSQL(options: RemovalOptions): Promise<void>;
         function removeWebSQL(options: RemovalOptions, callback: () => void): void;
@@ -1191,6 +1209,7 @@ export namespace Browser {
          * Clears websites' appcache data.
          *
          * Can return its result via Promise in Manifest V3 or later since Chrome 96.
+         * @deprecated since Chrome 98. Support for appcache has been removed. This function has no effect.
          */
         function removeAppcache(options: RemovalOptions): Promise<void>;
         function removeAppcache(options: RemovalOptions, callback: () => void): void;
@@ -1312,7 +1331,7 @@ export namespace Browser {
             GENERAL_ERROR = "GENERAL_ERROR",
         }
 
-        /** @deprecated Replaced by {@link Algorithm}.*/
+        /** @deprecated Replaced by {@link Algorithm}. */
         enum Hash {
             /** Specifies the MD5 and SHA1 hashing algorithms. */
             MD5_SHA1 = "MD5_SHA1",
@@ -1390,7 +1409,7 @@ export namespace Browser {
             error?: `${Error}` | undefined;
         }
 
-        /**  @since Chrome 86 */
+        /** @since Chrome 86 */
         interface SignatureRequest {
             /** Signature algorithm to be used. */
             algorithm: `${Algorithm}`;
@@ -1405,7 +1424,7 @@ export namespace Browser {
         interface SignRequest {
             /** The DER encoding of a X.509 certificate. The extension must sign `digest` using the associated private key. */
             certificate: ArrayBuffer;
-            /**  The digest that must be signed. */
+            /** The digest that must be signed. */
             digest: ArrayBuffer;
             /** Refers to the hash algorithm that was used to create `digest`. */
             hash: `${Hash}`;
@@ -1572,7 +1591,7 @@ export namespace Browser {
             resourceIdentifier?: ResourceIdentifier;
             /** Where to set the setting (default: regular). */
             scope?: `${Scope}`;
-            /** The pattern for the secondary URL. Defaults to matching all URLs. For details on the format of a pattern, see Content Setting Patterns.*/
+            /** The pattern for the secondary URL. Defaults to matching all URLs. For details on the format of a pattern, see Content Setting Patterns. */
             secondaryPattern?: string;
             /** The setting applied by this rule. See the description of the individual ContentSetting objects for the possible values. */
             setting: T;
@@ -1683,7 +1702,7 @@ export namespace Browser {
 
         /** The only content type using resource identifiers is contentSettings.plugins. For more information, see Resource Identifiers. */
         interface ResourceIdentifier {
-            /** A human readable description of the resource.  */
+            /** A human readable description of the resource. */
             description?: string;
             /** The resource identifier for the given content type. */
             id: string;
@@ -1922,15 +1941,15 @@ export namespace Browser {
             checked?: boolean;
             /** List of contexts this menu item will appear in. Defaults to `['page']`. */
             contexts?: [`${ContextType}`, ...`${ContextType}`[]];
-            /** Restricts the item to apply only to documents or frames whose URL matches one of the given patterns. For details on pattern formats, see Match Patterns.  */
+            /** Restricts the item to apply only to documents or frames whose URL matches one of the given patterns. For details on pattern formats, see Match Patterns. */
             documentUrlPatterns?: string[];
-            /**  Whether this context menu item is enabled or disabled. Defaults to `true`. */
+            /** Whether this context menu item is enabled or disabled. Defaults to `true`. */
             enabled?: boolean;
             /** The unique ID to assign to this item. Mandatory for event pages. Cannot be the same as another ID for this extension. */
             id?: string;
-            /**  The ID of a parent menu item; this makes the item a child of a previously added item. */
+            /** The ID of a parent menu item; this makes the item a child of a previously added item. */
             parentId?: number | string;
-            /**  Similar to `documentUrlPatterns`, filters based on the `src` attribute of `img`, `audio`, and `video` tags and the `href` attribute of `a` tags. */
+            /** Similar to `documentUrlPatterns`, filters based on the `src` attribute of `img`, `audio`, and `video` tags and the `href` attribute of `a` tags. */
             targetUrlPatterns?: string[];
             /** The text to display in the item; this is _required_ unless `type` is `separator`. When the context is `selection`, use `%s` within the string to show the selected text. For example, if this parameter's value is "Translate '%s' to Pig Latin" and the user selects the word "cool", the context menu item for the selection is "Translate 'cool' to Pig Latin". */
             title?: string;
@@ -1964,7 +1983,7 @@ export namespace Browser {
         interface OnClickData {
             /** A flag indicating the state of a checkbox or radio item after it is clicked. */
             checked?: boolean;
-            /**  A flag indicating whether the element is editable (text input, textarea, etc.). */
+            /** A flag indicating whether the element is editable (text input, textarea, etc.). */
             editable: boolean;
             /**
              * The ID of the frame of the element where the context menu was clicked, if it was in a frame.
@@ -1981,7 +2000,7 @@ export namespace Browser {
             menuItemId: number | string;
             /** The URL of the page where the menu item was clicked. This property is not set if the click occurred in a context where there is no current page, such as in a launcher context menu. */
             pageUrl?: string;
-            /** The parent ID, if any, for the item clicked.*/
+            /** The parent ID, if any, for the item clicked. */
             parentMenuItemId?: number | string;
             /** The text for the context selection, if any. */
             selectionText?: string | undefined;
@@ -2046,7 +2065,7 @@ export namespace Browser {
      * Manifest: "host_permissions"
      */
     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. **/
+        /** 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. */
         enum SameSiteStatus {
             NO_RESTRICTION = "no_restriction",
             LAX = "lax",
@@ -2297,7 +2316,7 @@ export namespace Browser {
          * @since Chrome 125
          */
         interface DebuggerSession {
-            /** The id of the extension which you intend to debug. Attaching to an extension background page is only possible when the `--silent-debugger-extension-api` command-line switch is used.*/
+            /** The id of the extension which you intend to debug. Attaching to an extension background page is only possible when the `--silent-debugger-extension-api` command-line switch is used. */
             extensionId?: string;
             /** The opaque id of the Chrome DevTools Protocol session. Identifies a child session within the root session identified by tabId, extensionId or targetId. */
             sessionId?: string;
@@ -2332,7 +2351,7 @@ export namespace Browser {
             title: string;
             /** Target URL. */
             url: string;
-            /** Target favicon URL.  */
+            /** Target favicon URL. */
             faviconUrl?: string;
         }
 
@@ -2495,7 +2514,7 @@ export namespace Browser {
      *
      * Permissions: "declarativeWebRequest"
      *
-     * MV2 only
+     * Beta and MV2 only
      * @deprecated Check out the {@link declarativeNetRequest} API instead
      */
     export namespace declarativeWebRequest {
@@ -2550,9 +2569,9 @@ export namespace Browser {
             /** Matches if the MIME media type of a response (from the HTTP Content-Type header) is not contained in the list. */
             excludeContentType?: string[] | undefined;
             /** Matches if none of the request headers is matched by any of the HeaderFilters. */
-            excludeResponseHeaders?: HeaderFilter[] | undefined;
+            excludeRequestHeaders?: HeaderFilter[] | undefined;
             /** Matches if none of the response headers is matched by any of the HeaderFilters. */
-            excludeResponseHeader?: HeaderFilter[] | undefined;
+            excludeResponseHeaders?: HeaderFilter[] | undefined;
             /**
              * Matches if the conditions of the UrlFilter are fulfilled for the 'first party' URL of the request. The 'first party' URL of a request, when present, can be different from the request's target URL, and describes what is considered 'first party' for the sake of third-party checks for cookies.
              * @deprecated since Chrome 82
@@ -2619,7 +2638,7 @@ export namespace Browser {
         /** Edits one or more cookies of response. Note that it is preferred to use the Cookies API because this is computationally less expensive. */
         interface EditResponseCookie {
             /** Filter for cookies that will be modified. All empty entries are ignored. */
-            filter: ResponseCookie;
+            filter: FilterResponseCookie;
             /** Attributes that shall be overridden in cookies that matched the filter. Attributes that are set to an empty string are removed. */
             modification: ResponseCookie;
         }
@@ -2663,7 +2682,7 @@ export namespace Browser {
             /** Existence of the Secure cookie attribute. */
             secure?: string | undefined;
             /** Filters session cookies. Session cookies have no lifetime specified in any of 'max-age' or 'expires' attributes. */
-            session?: boolean | undefined;
+            sessionCookie?: boolean | undefined;
             /** Value of a cookie, may be padded in double-quotes. */
             value?: string | undefined;
         }
@@ -2814,11 +2833,28 @@ export namespace Browser {
      * Manifest: "devtools_page"
      */
     export namespace devtools.inspectedWindow {
+        interface SetContentResult {
+            code: string;
+            description: string;
+            details: string[];
+            isError?: boolean;
+        }
+
         /** A resource within the inspected page, such as a document, a script, or an image. */
         interface Resource {
             /** The URL of the resource. */
             url: string;
-            /** Gets the content of the resource. */
+            /**
+             * Gets the content of the resource.
+             *
+             * Can return its result via Promise in Manifest V3 or later since Chrome 151.
+             */
+            getContent(): Promise<{
+                /** Content of the resource (potentially encoded). */
+                content: string;
+                /** Empty if the content is not encoded, encoding name otherwise. Currently, only base64 is supported. */
+                encoding: string;
+            }>;
             getContent(
                 callback: (
                     /** Content of the resource (potentially encoded). */
@@ -2831,14 +2867,17 @@ export namespace Browser {
              * Sets the content of the resource.
              * @param content New content of the resource. Only resources with the text type are currently supported.
              * @param commit True if the user has finished editing the resource, and the new content of the resource should be persisted; false if this is a minor change sent in progress of the user editing the resource.
+             *
+             * Can return its result via Promise in Manifest V3 or later since Chrome 151.
              */
             setContent(
                 content: string,
                 commit: boolean,
-                callback?: (
-                    /** Set to undefined if the resource content was set successfully; describes error otherwise. */
-                    error?: object,
-                ) => void,
+            ): Promise<undefined>;
+            setContent(
+                content: string,
+                commit: boolean,
+                callback: (result: SetContentResult) => void,
             ): void;
         }
 
@@ -2878,7 +2917,13 @@ export namespace Browser {
          * @param expression An expression to evaluate.
          * @param options The options parameter can contain one or more options.
          * @param callback A function called when evaluation completes.
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 151.
          */
+        function eval<T = { [key: string]: unknown }>(
+            expression: string,
+            options?: EvalOptions,
+        ): Promise<{ result: T; exceptionInfo: EvaluationExceptionInfo }>;
         function eval<T = { [key: string]: unknown }>(
             expression: string,
             callback?: (result: T, exceptionInfo: EvaluationExceptionInfo) => void,
@@ -2889,7 +2934,12 @@ export namespace Browser {
             callback?: (result: T, exceptionInfo: EvaluationExceptionInfo) => void,
         ): void;
 
-        /** Retrieves the list of resources from the inspected page. */
+        /**
+         * Retrieves the list of resources from the inspected page.
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 151.
+         */
+        function getResources(): Promise<Resource[]>;
         function getResources(callback: (resources: Resource[]) => void): void;
 
         /** Fired when a new resource is added to the inspected page. */
@@ -2922,7 +2972,17 @@ export namespace Browser {
     export namespace devtools.network {
         /** Represents a network request for a document resource (script, image and so on). See HAR Specification for reference. */
         interface Request extends HARFormatEntry {
-            /** Returns content of the response body. */
+            /**
+             * Returns content of the response body.
+             *
+             * Can return its result via Promise in Manifest V3 or later since Chrome 151.
+             */
+            getContent(): Promise<{
+                /** Content of the response body (potentially encoded). */
+                content: string;
+                /** Empty if content is not encoded, encoding name otherwise. Currently, only base64 is supported. */
+                encoding: string;
+            }>;
             getContent(
                 callback: (
                     /** Content of the response body (potentially encoded). */
@@ -2933,7 +2993,12 @@ export namespace Browser {
             ): void;
         }
 
-        /** Returns HAR log that contains all known network requests. */
+        /**
+         * Returns HAR log that contains all known network requests.
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 151.
+         */
+        function getHAR(): Promise<HARFormatLog>;
         function getHAR(
             callback: (
                 /** A HAR log. See HAR specification for details. */
@@ -3319,7 +3384,7 @@ export namespace Browser {
         enum OperationResult {
             /** An unknown or generic failure occurred. */
             UNKNOWN = "UNKNOWN",
-            /**The operation succeeded. */
+            /** The operation succeeded. */
             SUCCESS = "SUCCESS",
             /** The operation is not supported. */
             UNSUPPORTED = "UNSUPPORTED",
@@ -3502,7 +3567,7 @@ export namespace Browser {
 
         /** @since Chrome 125 */
         interface SetOptionResult {
-            /**  Indicates the name of the option that was set. */
+            /** Indicates the name of the option that was set. */
             name: string;
             /** Indicates the result of setting the option. */
             result: `${OperationResult}`;
@@ -3534,7 +3599,7 @@ export namespace Browser {
         interface StartScanResponse<T> {
             /** If `result` is `SUCCESS`, provides a handle that can be used to read scan data or cancel the job. */
             job?: string;
-            /**  The result of starting a scan. If the value of this is `SUCCESS`, the `job` property will be populated. */
+            /** The result of starting a scan. If the value of this is `SUCCESS`, the `job` property will be populated. */
             result: `${OperationResult}`;
             /** Provides the same scanner handle that was passed to {@link startScan}. */
             scannerHandle: T;
@@ -5102,7 +5167,7 @@ export namespace Browser {
             requestId: number;
         }
 
-        /** Error codes used by providing extensions in response to requests as well as in case of errors when calling methods of the API. For success, `"OK"` must be used.*/
+        /** Error codes used by providing extensions in response to requests as well as in case of errors when calling methods of the API. For success, `"OK"` must be used. */
         enum ProviderError {
             OK = "OK",
             FAILED = "FAILED",
@@ -5309,7 +5374,7 @@ export namespace Browser {
             ) => void
         >;
 
-        /** Raised when opening a file previously opened with `openRequestId` is requested to be closed.*/
+        /** Raised when opening a file previously opened with `openRequestId` is requested to be closed. */
         const onCloseFileRequested: events.Event<
             (
                 options: CloseFileRequestedOptions,
@@ -5754,7 +5819,7 @@ export namespace Browser {
             genericFamily: `${GenericFamily}`;
             /** The level of control this extension has over the setting. */
             levelOfControl: `${LevelOfControl}`;
-            /** Optional. The script code for which the font setting has changed.  */
+            /** Optional. The script code for which the font setting has changed. */
             script?: `${ScriptCode}`;
             /** The font ID. See the description in {@link getFont}. */
             fontId: string;
@@ -6213,7 +6278,8 @@ export namespace Browser {
         /** Gets the browser UI language of the browser. This is different from {@link i18n.getAcceptLanguages} which returns the preferred user languages. */
         function getUILanguage(): string;
 
-        /** Detects the language of the provided text using CLD.
+        /**
+         * Detects the language of the provided text using CLD.
          * @param text User input string to be translated.
          *
          * Can return its result via Promise in Manifest V3 or later since Chrome 99.
@@ -6343,14 +6409,17 @@ export namespace Browser {
          *
          * The Identity API caches access tokens in memory, so it's ok to call getAuthToken non-interactively any time a token is required. The token cache automatically handles expiration.
          *
-         * For a good user experience it is important interactive token requests are initiated by UI in your app explaining what the authorization is for. Failing to do this will cause your users to get authorization requests, or Chrome sign in screens if they are not signed in, with with no context. In particular, do not use getAuthToken interactively when your app is first launched.
+         * For a good user experience it is important interactive token requests are initiated by UI in your app explaining what the authorization is for. Failing to do this will cause your users to get authorization requests, or Chrome sign in screens if they are not signed in, with no context. In particular, do not use getAuthToken interactively when your app is first launched.
          * @param details Token options.
          *
          * Can return its result via Promise since Chrome 105.
          */
         function getAuthToken(details?: TokenDetails): Promise<GetAuthTokenResult>;
-        function getAuthToken(details: TokenDetails, callback: (result: GetAuthTokenResult) => void): void;
-        function getAuthToken(callback: (result: GetAuthTokenResult) => void): void;
+        function getAuthToken(
+            details: TokenDetails | undefined,
+            callback: (token?: string, grantedScopes?: string[]) => void,
+        ): void;
+        function getAuthToken(callback: (token?: string, grantedScopes?: string[]) => void): void;
 
         /**
          * Retrieves email address and obfuscated gaia id of the user signed into a profile.
@@ -6963,13 +7032,13 @@ export namespace Browser {
         /** This event is sent when an IME is deactivated. It signals that the IME will no longer be receiving onKeyPress events. */
         const onDeactivated: events.Event<(engineID: string) => void>;
 
-        /** This event is sent when the properties of the current InputContext change, such as the the type. It is sent to all extensions that are listening to this event, and enabled by the user. */
+        /** This event is sent when the properties of the current InputContext change, such as the type. It is sent to all extensions that are listening to this event, and enabled by the user. */
         const onInputContextUpdate: events.Event<(context: InputContext) => void>;
 
         /** This event is sent when an IME is activated. It signals that the IME will be receiving onKeyPress events. */
         const onActivate: events.Event<(engineID: string, screen: `${ScreenType}`) => void>;
 
-        // /** This event is sent when focus enters a text box. It is sent to all extensions that are listening to this event, and enabled by the user. */
+        /** This event is sent when focus enters a text box. It is sent to all extensions that are listening to this event, and enabled by the user. */
         const onFocus: events.Event<(context: InputContext) => void>;
 
         /** Called when the user selects a menu item */
@@ -7127,7 +7196,7 @@ export namespace Browser {
         function getSessionState(): Promise<`${SessionState}`>;
         function getSessionState(callback: (sessionState: `${SessionState}`) => void): void;
 
-        /** Dispatched when the session state changes. `sessionState` is the new session state.*/
+        /** Dispatched when the session state changes. `sessionState` is the new session state. */
         const onSessionStateChanged: events.Event<(sessionState: `${SessionState}`) => void>;
     }
 
@@ -7232,7 +7301,7 @@ export namespace Browser {
         enum ExtensionType {
             EXTENSION = "extension",
             HOSTED_APP = "hosted_app",
-            PACKAGE_APP = "package_app",
+            PACKAGED_APP = "packaged_app",
             LEGACY_PACKAGED_APP = "legacy_packaged_app",
             THEME = "theme",
             LOGIN_SCREEN_EXTENSION = "login_screen_extension",
@@ -7398,6 +7467,66 @@ export namespace Browser {
         const onEnabled: events.Event<(info: ExtensionInfo) => void>;
     }
 
+    ////////////////////
+    // MimeHandler
+    ////////////////////
+    /**
+     * Use the `Browser.mimeHandler` API to handle MIME type streams in third-party extensions.
+     * @since Chrome 151, MV3
+     */
+    export namespace mimeHandler {
+        interface MimeHandlerOptions {
+            /** Whether this handler is active for the given MIME type. */
+            enabled: boolean;
+        }
+
+        interface StreamInfo {
+            /** True if loaded in an embedded context (iframe/embed/object). */
+            embedded: boolean;
+            /** The MIME type of the intercepted content. */
+            mimeType: string;
+            /** The original URL the user navigated to. */
+            originalUrl: string;
+            /** HTTP response headers as key-value pairs. */
+            responseHeaders: { [key: string]: unknown };
+            /** The URL to fetch the stream data from. */
+            streamUrl: string;
+            /** The tab ID containing the document. */
+            tabId: number;
+        }
+
+        /**
+         * Aborts current stream handling and hands the content off to the user agent's native handler. After this call the extension frame will be torn down; callers should not expect further execution.
+         *
+         * Can return its result via Promise
+         */
+        function abortAndFallbackToNativeHandler(): Promise<void>;
+        function abortAndFallbackToNativeHandler(callback: () => void): void;
+
+        /**
+         * Reads the persisted options for a MIME type. Returns defaults (enabled=true) if none have been stored.
+         * @param mimeType The MIME type whose options to read.
+         *
+         * Can return its result via Promise
+         */
+        function getMimeHandlerOptions(mimeType: string): Promise<MimeHandlerOptions>;
+        function getMimeHandlerOptions(mimeType: string, callback: (options: MimeHandlerOptions) => void): void;
+
+        /** Retrieves stream information for the current MIME handler context. Must be called from within a MIME handler extension page. */
+        function getStreamInfo(): Promise<StreamInfo>;
+        function getStreamInfo(callback: (info: StreamInfo) => void): void;
+
+        /**
+         * Sets the configuration options for a specified MIME type.
+         * @param mimeType The MIME type to configure.
+         * @param options The new options to use.
+         *
+         * Can return its result via Promise
+         */
+        function setMimeHandlerOptions(mimeType: string, options: MimeHandlerOptions): Promise<void>;
+        function setMimeHandlerOptions(mimeType: string, options: MimeHandlerOptions, callback: () => void): void;
+    }
+
     ////////////////////
     // Notifications
     ////////////////////
@@ -7477,7 +7606,8 @@ export namespace Browser {
              * **Note:** This value is required for the {@link notifications.create}() method.
              */
             title?: string;
-            /** Which type of notification to display.
+            /**
+             * Which type of notification to display.
              *
              * **Note:** This value is required for the {@link notifications.create}() method.
              */
@@ -7941,7 +8071,7 @@ export namespace Browser {
     // Platform Keys
     ////////////////////
     /**
-     * Use the `Browser.platformKeys` API to access client certificates managed by the platform. If the user or policy grants the permission, an extension can use such a certficate in its custom authentication protocol. E.g. this allows usage of platform managed certificates in third party VPNs (see Browser.vpnProvider).
+     * Use the `Browser.platformKeys` API to access client certificates managed by the platform. If the user or policy grants the permission, an extension can use such a certificate in its custom authentication protocol. E.g. this allows usage of platform managed certificates in third party VPNs (see Browser.vpnProvider).
      *
      * Permissions: "platformKeys"
      * @platform ChromeOS only
@@ -8103,7 +8233,7 @@ export namespace Browser {
         enum PrintError {
             /** Specifies that the operation was completed successfully. */
             OK = "OK",
-            /** Specifies that a general failure occured. */
+            /** Specifies that a general failure occurred. */
             FAILED = "FAILED",
             /** Specifies that the print ticket is invalid. For example, the ticket is inconsistent with some capabilities, or the extension is not able to handle all settings from the ticket. */
             INVALID_TICKET = "INVALID_TICKET",
@@ -8485,6 +8615,17 @@ export namespace Browser {
      * Permissions: "privacy"
      */
     export namespace privacy {
+        /**
+         * Categories of Autofill data.
+         * @since Chrome 151
+         */
+        enum AutofillBlockedType {
+            CONTACT_INFO = "contact_info",
+            PAYMENTS = "payments",
+            IDENTITY_DOCS = "identity_docs",
+            TRAVEL = "travel",
+        }
+
         /**
          * The IP handling policy of WebRTC.
          * @since Chrome 48
@@ -8893,7 +9034,7 @@ export namespace Browser {
      */
     export namespace runtime {
         interface LastError {
-            /** Details about the error which occurred.  */
+            /** Details about the error which occurred. */
             message?: string;
         }
 
@@ -8929,19 +9070,19 @@ export namespace Browser {
          * @since Chrome 44
          */
         enum PlatformArch {
-            /** Specifies the processer architecture as arm. */
+            /** Specifies the processor architecture as arm. */
             ARM = "arm",
-            /** Specifies the processer architecture as arm64. */
+            /** Specifies the processor architecture as arm64. */
             ARM64 = "arm64",
-            /** Specifies the processer architecture as x86-32. */
+            /** Specifies the processor architecture as x86-32. */
             X86_32 = "x86-32",
-            /** Specifies the processer architecture as x86-64. */
+            /** Specifies the processor architecture as x86-64. */
             X86_64 = "x86-64",
-            /** Specifies the processer architecture as mips. */
+            /** Specifies the processor architecture as mips. */
             MIPS = "mips",
-            /** Specifies the processer architecture as mips64. */
+            /** Specifies the processor architecture as mips64. */
             MIPS64 = "mips64",
-            /** Specifies the processer architecture as riscv64. */
+            /** Specifies the processor architecture as riscv64. */
             RISCV64 = "riscv64",
         }
 
@@ -9048,7 +9189,7 @@ export namespace Browser {
             contextId: string;
             /** The type of context this corresponds to. */
             contextType: `${ContextType}`;
-            /** A UUID for the document associated with this context, or undefined if this context is hosted not in a document.*/
+            /** A UUID for the document associated with this context, or undefined if this context is hosted not in a document. */
             documentId?: string;
             /** The origin of the document associated with this context, or undefined if the context is not hosted in a document. */
             documentOrigin?: string;
@@ -9167,9 +9308,11 @@ export namespace Browser {
         }
 
         interface ManifestAction {
-            default_icon?: ManifestIcons | undefined;
+            default_icon?: ManifestIcons | string | undefined;
             default_title?: string | undefined;
             default_popup?: string | undefined;
+            /** @default 'enabled' */
+            default_state?: "enabled" | "disabled";
         }
 
         /** Source: https://developer.chrome.com/docs/extensions/reference/permissions-list */
@@ -9275,22 +9418,37 @@ export namespace Browser {
             | "webAuthenticationProxy"
         >;
 
+        /** A search engine. */
         interface SearchProvider {
+            /** Name of the search engine displayed to user. This is required if you don't set `prepopulated_id`. */
             name?: string | undefined;
+            /** An omnibox keyword for the search engine. This is required if you don't set `prepopulated_id`. */
             keyword?: string | undefined;
+            /** An icon URL for the search engine. This is required if you don't set `prepopulated_id`. */
             favicon_url?: string | undefined;
+            /** The search URL the search engine uses. */
             search_url: string;
+            /** The encoding used for search terms. This is required if you don't set `prepopulated_id`. */
             encoding?: string | undefined;
+            /** The URL the search engine uses for suggestions. If this isn't used, the engine doesn't support suggestions. */
             suggest_url?: string | undefined;
             instant_url?: string | undefined;
+            /** The URL the search engine uses for image search. If this isn't used, the engine doesn't support image search. */
             image_url?: string | undefined;
+            /** The post parameters for `search_url`. */
             search_url_post_params?: string | undefined;
+            /** The post parameters for `suggest_url`. */
             suggest_url_post_params?: string | undefined;
+            /** The post parameters for `instant_url`. */
             instant_url_post_params?: string | undefined;
+            /** The post parameters for `image_url`. */
             image_url_post_params?: string | undefined;
+            /** A list of URL patterns that can be used in addition to `search_url`. */
             alternate_urls?: string[] | undefined;
+            /** An ID for Chrome's built-in search engine. */
             prepopulated_id?: number | undefined;
-            is_default?: boolean | undefined;
+            /** Specifies whether the search provider should be default. */
+            is_default: boolean;
         }
 
         interface ManifestBase {
@@ -9313,10 +9471,12 @@ export namespace Browser {
             // Optional
             /** @deprecated As of February 2024, the `author` key is no longer supported by Chrome or the Chrome Web Store. If present, it's silently ignored. */
             author?: { email: string } | undefined;
-            /** Defines overrides for selected Chrome settings.  */
+            /** Defines overrides for selected Chrome settings. */
             chrome_settings_overrides?: {
+                /** The new value for the homepage. */
                 homepage?: string | undefined;
                 search_provider?: SearchProvider | undefined;
+                /** An array of length one containing a URL to be used as the startup page. */
                 startup_pages?: string[] | undefined;
             } | undefined;
             /** Defines overrides for default Chrome pages. */
@@ -9328,13 +9488,16 @@ export namespace Browser {
             /** Defines keyboard shortcuts within the extension. */
             commands?: {
                 [name: string]: {
-                    suggested_key?: {
-                        default?: string | undefined;
-                        windows?: string | undefined;
-                        mac?: string | undefined;
-                        chromeos?: string | undefined;
-                        linux?: string | undefined;
-                    } | undefined;
+                    suggested_key?:
+                        | {
+                            default?: string | undefined;
+                            windows?: string | undefined;
+                            mac?: string | undefined;
+                            chromeos?: string | undefined;
+                            linux?: string | undefined;
+                        }
+                        | string
+                        | undefined;
                     description?: string | undefined;
                     global?: boolean | undefined;
                 };
@@ -9350,7 +9513,7 @@ export namespace Browser {
             cross_origin_opener_policy?: { value: string } | undefined;
             current_locale?: string | undefined;
             /** Defines static rules for the declarativeNetRequest API, which allows blocking and modifying of network requests. */
-            declarative_net_request?: { rule_resources?: declarativeNetRequest.Ruleset[] } | undefined;
+            declarative_net_request?: { rule_resources: declarativeNetRequest.Ruleset[] } | undefined;
             /** Defines pages that use the DevTools APIs. */
             devtools_page?: string | undefined;
             event_rules?:
@@ -9385,7 +9548,7 @@ export namespace Browser {
                 /** Files app uses above information in order to render related UI elements appropriately. For example, if `configurable` is set to true, then a menu item for configuring volumes will be rendered. Similarly, if `multiple_mounts` is set to true, then Files app will allow to add more than one mount points from the UI. If `watchable` is false, then a refresh button will be rendered. Note, that if possible you should add support for watchers, so changes on the file system can be reflected immediately and automatically. */
                 source: "file" | "device" | "network";
             } | undefined;
-            /**  string specifying a URL for the extension's homepage. If this is undefined, the homepage defaults to the extension's Chrome Web Store page. This field is particularly useful if you host the extension on your own site. */
+            /** string specifying a URL for the extension's homepage. If this is undefined, the homepage defaults to the extension's Chrome Web Store page. This field is particularly useful if you host the extension on your own site. */
             homepage_url?: string | undefined;
             /** Allows resources to be imported into the extension. */
             import?:
@@ -9422,20 +9585,13 @@ export namespace Browser {
             /** Allows the use of an OAuth 2.0 security ID. The value of this key must be an object with "client_id" and "scopes" properties. */
             oauth2?: {
                 client_id: string;
-                scopes?: string[] | undefined;
+                scopes: string[];
             } | undefined;
             offline_enabled?: boolean | undefined;
             /** Allows the extension to register a keyword in Chrome's address bar. */
             omnibox?: { keyword: string } | undefined;
             /** Specifies a path to an options.html file for the extension to use as an options page. */
             options_page?: string | undefined;
-            /** Specifies a path to an HTML file that lets a user change extension options from the Chrome Extensions page. */
-            options_ui?: {
-                /** Path to the options page, relative to the extension's root. */
-                page: string;
-                /** Specify as `false` to declare an embedded options page. If `true`, the extension's options page will be opened in a new tab rather than embedded in `chrome://extensions`. */
-                open_in_tab: boolean;
-            } | undefined;
             /** Lists technologies required to use the extension. */
             requirements?: {
                 "3D"?: { features?: string[] | undefined } | undefined;
@@ -9471,8 +9627,8 @@ export namespace Browser {
             manifest_version: 2;
 
             // Pick one (or none)
-            browser_action?: ManifestAction | undefined;
-            page_action?: ManifestAction | undefined;
+            browser_action?: Omit<ManifestAction, "default_state"> | undefined;
+            page_action?: Omit<ManifestAction, "default_state"> | undefined;
 
             // Optional
             background?:
@@ -9498,6 +9654,15 @@ export namespace Browser {
                 | undefined;
             /** Defines restrictions on the scripts, styles, and other resources an extension can use. */
             content_security_policy?: string | undefined;
+            /** Specifies a path to an HTML file that lets a user change extension options from the Chrome Extensions page. */
+            options_ui?: {
+                /** Path to the options page, relative to the extension's root. */
+                page: string;
+                /** If `true`, a Chrome user agent stylesheet will be applied to your options page. Defaults to `false`. */
+                chrome_style?: boolean | undefined;
+                /** Specify as `false` to declare an embedded options page. If `true`, the extension's options page will be opened in a new tab rather than embedded in `chrome://extensions`. */
+                open_in_tab?: boolean | undefined;
+            } | undefined;
             /** Declares optional permissions for your extension. */
             optional_permissions?: (ManifestOptionalPermission | string)[] | undefined;
             /** Enables use of particular extension APIs. */
@@ -9561,6 +9726,25 @@ export namespace Browser {
                 | undefined;
             /** Lists the web pages your extension is allowed to interact with, defined using URL match patterns. User permission for these sites is requested at install time. */
             host_permissions?: string[] | undefined;
+            /** Specifies a path to an HTML file that lets a user change extension options from the Chrome Extensions page. */
+            options_ui?: {
+                /** Specifies the path to the options page, relative to the extension's root. */
+                page: string;
+                /** Indicates whether the extension's options page will be opened in a new tab. If set to `false`, the extension's options page is embedded in `chrome://extensions` rather than opened in a new tab. */
+                open_in_tab?: boolean | undefined;
+            } | undefined;
+            /**
+             * Maps MIME types to the extension pages that render them. As of Chrome 151, `application/pdf` is the only MIME type available to public handlers. Declaring an unsupported MIME type causes an installation warning.
+             * @since Chrome 151
+             */
+            mime_types_handler?: {
+                "application/pdf": {
+                    /** The HTML file to display when a document of the corresponding MIME type is opened. This file must be located within your extension. */
+                    handler_url: string;
+                    /** Specifies whether to handle documents embedded in `<embed>`, `<object>`, or `<iframe>` elements. Defaults to `false`, meaning the handler only receives top-level navigations. */
+                    can_embed?: boolean;
+                };
+            };
             /** Declares optional permissions for your extension. */
             optional_permissions?: ManifestOptionalPermission[] | undefined;
             /** Declares optional host permissions for your extension. */
@@ -10487,9 +10671,9 @@ export namespace Browser {
         }
 
         interface Bounds {
-            /**  The x-coordinate of the upper-left corner. */
+            /** The x-coordinate of the upper-left corner. */
             left: number;
-            /**  The y-coordinate of the upper-left corner. */
+            /** The y-coordinate of the upper-left corner. */
             top: number;
             /** The width of the display in pixels. */
             width: number;
@@ -10719,7 +10903,8 @@ export namespace Browser {
             dpiX: number;
             /** The number of pixels per inch along the y-axis. */
             dpiY: number;
-            /** The display's clockwise rotation in degrees relative to the vertical position.
+            /**
+             * The display's clockwise rotation in degrees relative to the vertical position.
              * Currently exposed only on ChromeOS. Will be set to 0 on other platforms.
              * A value of -1 will be interpreted as auto-rotate when the device is in a physical tablet state.
              * @platform ChromeOS only
@@ -10776,15 +10961,10 @@ export namespace Browser {
 
         interface MirrorModeInfo {
             /** The mirror mode that should be set. */
-            mode?: `${MirrorMode}`;
-        }
-
-        interface MirrorModeInfoMixed extends MirrorModeInfo {
-            /** The mirror mode that should be set. */
-            mode: "mixed";
-            /** The id of the mirroring source display. */
+            mode: `${MirrorMode}`;
+            /** The id of the mirroring source display. This is only valid for 'mixed'. */
             mirroringSourceId?: string | undefined;
-            /** The ids of the mirroring destination displays. */
+            /** The ids of the mirroring destination displays. This is only valid for 'mixed'. */
             mirroringDestinationIds?: string[] | undefined;
         }
 
@@ -10925,8 +11105,8 @@ export namespace Browser {
          * @param info The information of the mirror mode that should be applied to the display mode.
          * @since Chrome 65
          */
-        function setMirrorMode(info: MirrorModeInfo | MirrorModeInfoMixed, callback: () => void): void;
-        function setMirrorMode(info: MirrorModeInfo | MirrorModeInfoMixed): Promise<void>;
+        function setMirrorMode(info: MirrorModeInfo, callback: () => void): void;
+        function setMirrorMode(info: MirrorModeInfo): Promise<void>;
 
         /** Fired when anything changes to the display configuration. */
         const onDisplayChanged: Browser.events.Event<() => void>;
@@ -10989,7 +11169,7 @@ export namespace Browser {
 
         /** @since Chrome 71 */
         interface GetMediaStreamOptions {
-            /** Optional tab id of the tab which will later invoke `getUserMedia()` to consume the stream. 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 the consumber tab's origin. The tab's origin must be a secure origin, e.g. HTTPS. */
+            /** Optional tab id of the tab which will later invoke `getUserMedia()` to consume the stream. 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 the consumer tab's origin. The tab's origin must be a secure origin, e.g. HTTPS. */
             consumerTabId?: number | undefined;
             /** Optional tab id of the tab which will be captured. If not specified then the current active tab will be selected. Only tabs for which the extension has been granted the `activeTab` permission can be used as the target tab. */
             targetTabId?: number | undefined;
@@ -11147,7 +11327,7 @@ export namespace Browser {
              * The last time the tab became active in its window as the number of milliseconds since epoch.
              * @since Chrome 121
              */
-            lastAccessed?: number | undefined;
+            lastAccessed: number;
         }
 
         /** The tab's loading status. */
@@ -11263,7 +11443,7 @@ export namespace Browser {
             url?: string | undefined;
             /** Adds or removes the tab from the current selection. */
             highlighted?: boolean | undefined;
-            /** Whether the tab should be active. Does not affect whether the window is focused (see {@link windows.update}).*/
+            /** Whether the tab should be active. Does not affect whether the window is focused (see {@link windows.update}). */
             active?: boolean | undefined;
             /**
              * Whether the tab should be selected.
@@ -11717,8 +11897,11 @@ export namespace Browser {
         function insertCSS(details: extensionTypes.InjectDetails): Promise<void>;
         function insertCSS(tabId: number | undefined, details: extensionTypes.InjectDetails): Promise<void>;
         function insertCSS(details: extensionTypes.InjectDetails, callback: () => void): void;
-        function insertCSS(tabId: number | undefined, details: extensionTypes.InjectDetails): Promise<void>;
-        function insertCSS(tabId: number, details: extensionTypes.InjectDetails, callback: () => void): void;
+        function insertCSS(
+            tabId: number | undefined,
+            details: extensionTypes.InjectDetails,
+            callback: () => void,
+        ): void;
 
         /**
          * Highlights the given tabs and focuses on the first of group. Will appear to do nothing if the specified tab is currently active.
@@ -11797,7 +11980,7 @@ export namespace Browser {
          * Discards a tab from memory. Discarded tabs are still visible on the tab strip and are reloaded when activated.
          *
          * Can return its result via Promise in Manifest V3 or later since Chrome 88.
-         * @param tabId The ID of the tab to be discarded. If specified, the tab is discarded unless it is active or already discarded. If omitted, the browser discards the least important tab. This can fail if no discardable tabs exist..
+         * @param tabId The ID of the tab to be discarded. If specified, the tab is discarded unless it is active or already discarded. If omitted, the browser discards the least important tab. This can fail if no discardable tabs exist.
          * @since Chrome 54
          */
         function discard(tabId?: number): Promise<Tab | undefined>;
@@ -12172,7 +12355,7 @@ export namespace Browser {
             voiceName?: string;
         }
 
-        /** @deprecated since Chrome 70. Gender is deprecated and is ignored.*/
+        /** @deprecated since Chrome 70. Gender is deprecated and is ignored. */
         enum VoiceGender {
             FEMALE = "female",
             MALE = "male",
@@ -12639,7 +12822,7 @@ export namespace Browser {
         /** Triggered when a configuration created by the extension is removed by the platform. */
         const onConfigRemoved: events.Event<(id: string) => void>;
 
-        // /** Triggered when a configuration is created by the platform for the extension. */
+        /** Triggered when a configuration is created by the platform for the extension. */
         const onConfigCreated: events.Event<
             (id: string, name: string, data: { [key: string]: unknown }) => void
         >;
@@ -12725,7 +12908,7 @@ export namespace Browser {
         interface GetRequest {
             /** The `PublicKeyCredentialRequestOptions` passed to `navigator.credentials.get()`, serialized as a JSON string. The serialization format is compatible with [`PublicKeyCredential.parseRequestOptionsFromJSON()`](https://w3c.github.io/webauthn/#sctn-parseRequestOptionsFromJSON). */
             requestDetailsJson: string;
-            /**  An opaque identifier for the request. */
+            /** An opaque identifier for the request. */
             requestId: number;
         }
 
@@ -12757,7 +12940,7 @@ export namespace Browser {
          *
          * The attached extension must call `detach()` once the remote desktop session has ended in order to resume regular WebAuthn request processing. Extensions automatically become detached if they are unloaded.
          *
-         * Refer to the `onRemoteSessionStateChange` event for signaling a change of remote session attachment from a native application to to the (possibly suspended) extension.
+         * Refer to the `onRemoteSessionStateChange` event for signaling a change of remote session attachment from a native application to the (possibly suspended) extension.
          */
         function attach(): Promise<string | undefined>;
         function attach(callback: (error?: string | undefined) => void): void;
@@ -12779,7 +12962,7 @@ export namespace Browser {
          *
          * This method is typically called when the extension detects that a remote desktop session was terminated. Once this method returns, the extension ceases to be the active Web Authentication API request proxy.
          *
-         * Refer to the `onRemoteSessionStateChange` event for signaling a change of remote session attachment from a native application to to the (possibly suspended) extension.
+         * Refer to the `onRemoteSessionStateChange` event for signaling a change of remote session attachment from a native application to the (possibly suspended) extension.
          */
         function detach(): Promise<string | undefined>;
         function detach(callback: (error?: string | undefined) => void): void;
@@ -12876,7 +13059,7 @@ export namespace Browser {
             );
 
         interface GetFrameResultDetails {
-            /** The URL currently associated with this frame, if the frame identified by the frameId existed at one point in the given tab. The fact that an URL is associated with a given frameId does not imply that the corresponding frame still exists. */
+            /** The URL currently associated with this frame, if the frame identified by the frameId existed at one point in the given tab. The fact that a URL is associated with a given frameId does not imply that the corresponding frame still exists. */
             url: string;
             /** A UUID of the document loaded. */
             documentId: string;
@@ -12981,7 +13164,7 @@ export namespace Browser {
             documentId: string;
             /** Cause of the navigation. */
             transitionType: `${TransitionType}`;
-            /** A list of transition qualifiers.*/
+            /** A list of transition qualifiers. */
             transitionQualifiers: `${TransitionQualifier}`[];
         }
 
@@ -13032,7 +13215,7 @@ export namespace Browser {
         /** Fired when a document, including the resources it refers to, is completely loaded and initialized. */
         const onCompleted: WebNavigationEvent<(details: WebNavigationFramedCallbackDetails) => void>;
 
-        // /** Fired when the frame's history was updated to a new URL. All future events for that frame will use the updated URL. */
+        /** Fired when the frame's history was updated to a new URL. All future events for that frame will use the updated URL. */
         const onHistoryStateUpdated: WebNavigationEvent<
             (details: WebNavigationTransitionCallbackDetails) => void
         >;
@@ -13042,7 +13225,7 @@ export namespace Browser {
             (details: WebNavigationSourceCallbackDetails) => void
         >;
 
-        /** Fired when the contents of the tab is replaced by a different (usually previously pre-rendered) tab*/
+        /** Fired when the contents of the tab is replaced by a different (usually previously pre-rendered) tab */
         const onTabReplaced: events.Event<(details: WebNavigationReplacementCallbackDetails) => void>;
 
         /** Fired when a navigation is about to occur. */
@@ -13335,7 +13518,7 @@ export namespace Browser {
              * @since Chrome 43
              */
             statusCode: number;
-            /** HTTP status line of the response or the 'HTTP/0.9 200 OK' string for HTTP/0.9 responses (i.e., responses that lack a status line) or an empty string if there are no headers.*/
+            /** HTTP status line of the response or the 'HTTP/0.9 200 OK' string for HTTP/0.9 responses (i.e., responses that lack a status line) or an empty string if there are no headers. */
             statusLine: string;
         }
 
@@ -13350,7 +13533,7 @@ export namespace Browser {
             responseHeaders?: HttpHeader[];
             /** Standard HTTP status code returned by the server. */
             statusCode: number;
-            /** HTTP status line of the response or the 'HTTP/0.9 200 OK' string for HTTP/0.9 responses (i.e., responses that lack a status line) or an empty string if there are no headers.*/
+            /** HTTP status line of the response or the 'HTTP/0.9 200 OK' string for HTTP/0.9 responses (i.e., responses that lack a status line) or an empty string if there are no headers. */
             statusLine: string;
         }
 
@@ -13382,7 +13565,7 @@ export namespace Browser {
             responseHeaders?: HttpHeader[];
             /** Standard HTTP status code returned by the server. */
             statusCode: number;
-            /** HTTP status line of the response or the 'HTTP/0.9 200 OK' string for HTTP/0.9 responses (i.e., responses that lack a status line) or an empty string if there are no headers.*/
+            /** HTTP status line of the response or the 'HTTP/0.9 200 OK' string for HTTP/0.9 responses (i.e., responses that lack a status line) or an empty string if there are no headers. */
             statusLine: string;
         }
 
@@ -13405,7 +13588,7 @@ export namespace Browser {
             securityInfo?: SecurityInfo;
             /** Standard HTTP status code returned by the server. */
             statusCode: number;
-            /** HTTP status line of the response or the 'HTTP/0.9 200 OK' string for HTTP/0.9 responses (i.e., responses that lack a status line) or an empty string if there are no headers.*/
+            /** HTTP status line of the response or the 'HTTP/0.9 200 OK' string for HTTP/0.9 responses (i.e., responses that lack a status line) or an empty string if there are no headers. */
             statusLine: string;
         }
 
@@ -13436,9 +13619,9 @@ export namespace Browser {
 
         const onActionIgnored: events.Event<
             (details: {
-                // The proposed action which was ignored.
+                /** The proposed action which was ignored. */
                 action: `${IgnoredActionType}`;
-                // The ID of the request. Request IDs are unique within a browser session. As a result, they could be used to relate different events of the same request.
+                /** The ID of the request. Request IDs are unique within a browser session. As a result, they could be used to relate different events of the same request. */
                 requestId: string;
             }) => void
         >;
@@ -13483,7 +13666,6 @@ export namespace Browser {
             ) => BlockingResponse | undefined,
             `${OnAuthRequiredOptions}`[]
         >;
-        // const onAuthRequired: WebAuthenticationChallengeEvent;
 
         /** Fired when the first byte of the response body is received. For HTTP requests, this means that the status line and response headers are available. */
         const onResponseStarted: WebRequestEvent<
@@ -14589,13 +14771,13 @@ export namespace Browser {
         /** @since Chrome 141 */
         type CloseOptions =
             | {
-                /** The tab in which to close the side panel. If a tab-specific side panel is open in the specified tab, it will be closed for that tab. At least one of this or `windowId` must be provided.  */
+                /** The tab in which to close the side panel. If a tab-specific side panel is open in the specified tab, it will be closed for that tab. At least one of this or `windowId` must be provided. */
                 tabId: number;
                 /** The window in which to close the side panel. If a global side panel is open in the specified window, it will be closed for all tabs in that window where no tab-specific panel is active. At least one of this or `tabId` must be provided. */
                 windowId?: number | undefined;
             }
             | {
-                /** The tab in which to close the side panel. If a tab-specific side panel is open in the specified tab, it will be closed for that tab. At least one of this or `windowId` must be provided.  */
+                /** The tab in which to close the side panel. If a tab-specific side panel is open in the specified tab, it will be closed for that tab. At least one of this or `windowId` must be provided. */
                 tabId?: number | undefined;
                 /** The window in which to close the side panel. If a global side panel is open in the specified window, it will be closed for all tabs in that window where no tab-specific panel is active. At least one of this or `tabId` must be provided. */
                 windowId: number;
@@ -14615,7 +14797,7 @@ export namespace Browser {
                 /**
                  * The tab in which to open the side panel.
                  * If the corresponding tab has a tab-specific side panel, the panel will only be open for that tab.
-                 * If there is not a tab-specific panel, the global panel will be open in the specified tab and any other tabs without a currently-open tab- specific panel.
+                 * If there is not a tab-specific panel, the global panel will be open in the specified tab and any other tabs without a currently-open tab-specific panel.
                  * This will override any currently-active side panel (global or tab-specific) in the corresponding tab.
                  * At least one of this and `windowId` must be provided. */
                 tabId?: number | undefined;
@@ -14807,7 +14989,7 @@ export namespace Browser {
         interface WorldProperties {
             /** Specifies the world csp. The default is the `ISOLATED` world csp. */
             csp?: string | undefined;
-            /** Specifies whether messaging APIs are exposed. The default is `false`.*/
+            /** Specifies whether messaging APIs are exposed. The default is `false`. */
             messaging?: boolean | undefined;
             /**
              * Specifies the ID of the specific user script world to update. If not provided, updates the properties of the default user script world. Values with leading underscores (`_`) are reserved.
@@ -14821,7 +15003,7 @@ export namespace Browser {
             ids?: string[] | undefined;
         }
 
-        // /** @since Chrome 135 */
+        /** @since Chrome 135 */
         type InjectionTarget =
             & {
                 /** The ID of the tab into which to inject. */
@@ -14859,13 +15041,13 @@ export namespace Browser {
             allFrames?: boolean | undefined;
             /** Specifies wildcard patterns for pages this user script will NOT be injected into. */
             excludeGlobs?: string[] | undefined;
-            /**Excludes pages that this user script would otherwise be injected into. See Match Patterns for more details on the syntax of these strings. */
+            /** Excludes pages that this user script would otherwise be injected into. See Match Patterns for more details on the syntax of these strings. */
             excludeMatches?: string[] | undefined;
             /** The ID of the user script specified in the API call. This property must not start with a '_' as it's reserved as a prefix for generated script IDs. */
             id: string;
             /** Specifies wildcard patterns for pages this user script will be injected into. */
             includeGlobs?: string[] | undefined;
-            /** The list of ScriptSource objects defining sources of scripts to be injected into matching pages. This property must be specified for {@link register}, and when specified it must be a non-empty array.*/
+            /** The list of ScriptSource objects defining sources of scripts to be injected into matching pages. This property must be specified for {@link register}, and when specified it must be a non-empty array. */
             js?: ScriptSource[] | undefined;
             /** Specifies which pages this user script will be injected into. See Match Patterns for more details on the syntax of these strings. This property must be specified for {@link register}. */
             matches?: string[] | undefined;