@types/chrome 0.1.16 → 0.1.18

chrome/README.md

@@ -8,7 +8,7 @@ This package contains type definitions for chrome (https://developer.chrome.com/
 Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/chrome.
 
 ### Additional Details
- * Last updated: Tue, 30 Sep 2025 21:32:35 GMT
+ * Last updated: Thu, 02 Oct 2025 06:39:55 GMT
  * Dependencies: [@types/filesystem](https://npmjs.com/package/@types/filesystem), [@types/har-format](https://npmjs.com/package/@types/har-format)
 
 # Credits

chrome/index.d.ts

@@ -6276,96 +6276,86 @@ declare namespace chrome {
      * @platform ChromeOS only
      */
     export namespace input.ime {
-        /** See http://www.w3.org/TR/DOM-Level-3-Events/#events-KeyboardEvent */
+        /** See https://www.w3.org/TR/uievents/#events-KeyboardEvent */
         export interface KeyboardEvent {
-            /**
-             * Optional.
-             * Whether or not the SHIFT key is pressed.
-             */
+            /** Whether or not the SHIFT key is pressed. */
             shiftKey?: boolean | undefined;
-            /**
-             * Optional.
-             * Whether or not the ALT key is pressed.
-             */
+            /** Whether or not the ALT key is pressed. */
             altKey?: boolean | undefined;
             /**
-             * Optional.
              * Whether or not the ALTGR key is pressed.
              * @since Chrome 79
              */
             altgrKey?: boolean | undefined;
             /**
-             * Optional.
-             * The ID of the request. Use the requestId param from the onKeyEvent event instead.
-             * @deprecated since Chrome 79.
+             * The ID of the request
+             * @deprecated Use the `requestId` param from the `onKeyEvent` event instead.
              */
             requestId?: string | undefined;
-            /** Value of the key being pressed */
+            /** Value of the key being pressed. */
             key: string;
-            /**
-             * Optional.
-             * Whether or not the CTRL key is pressed.
-             */
+            /** Whether or not the CTRL key is pressed. */
             ctrlKey?: boolean | undefined;
             /** One of keyup or keydown. */
-            type: string;
-            /**
-             * Optional.
-             * The extension ID of the sender of this keyevent.
-             * @since Chrome 34
-             */
+            type: `${KeyboardEventType}`;
+            /** The extension ID of the sender of this keyevent. */
             extensionId?: string | undefined;
-            /**
-             * Optional.
-             * Value of the physical key being pressed. The value is not affected by current keyboard layout or modifier state.
-             * @since Chrome 26
-             */
+            /** Value of the physical key being pressed. The value is not affected by current keyboard layout or modifier state. */
             code: string;
-            /**
-             * Optional.
-             * The deprecated HTML keyCode, which is system- and implementation-dependent numerical code signifying the unmodified identifier associated with the key pressed.
-             * @since Chrome 37
-             */
+            /** The deprecated HTML keyCode, which is system- and implementation-dependent numerical code signifying the unmodified identifier associated with the key pressed. */
             keyCode?: number | undefined;
-            /**
-             * Optional.
-             * Whether or not the CAPS_LOCK is enabled.
-             * @since Chrome 29
-             */
+            /** Whether or not the CAPS_LOCK is enabled. */
             capsLock?: boolean | undefined;
         }
 
+        /** @since Chrome 44 */
+        export enum KeyboardEventType {
+            KEYUP = "keyup",
+            KEYDOWN = "keydown",
+        }
+
         /**
          * The auto-capitalize type of the text field.
          * @since Chrome 69
          */
-        export type AutoCapitalizeType = "characters" | "words" | "sentences";
+        export enum AutoCapitalizeType {
+            CHARACTERS = "characters",
+            WORDS = "words",
+            SENTENCES = "sentences",
+        }
+
+        /**
+         * Type of value this text field edits, (Text, Number, URL, etc)
+         * @since Chrome 44
+         */
+        export enum InputContextType {
+            TEXT = "text",
+            SEARCH = "search",
+            TEL = "tel",
+            URL = "url",
+            EMAIL = "email",
+            NUMBER = "number",
+            PASSWORD = "password",
+            NULL = "null",
+        }
+
         /** Describes an input Context */
         export interface InputContext {
             /** This is used to specify targets of text field operations. This ID becomes invalid as soon as onBlur is called. */
             contextID: number;
             /** Type of value this text field edits, (Text, Number, URL, etc) */
-            type: string;
-            /**
-             * Whether the text field wants auto-correct.
-             * @since Chrome 40
-             */
+            type: `${InputContextType}`;
+            /** Whether the text field wants auto-correct. */
             autoCorrect: boolean;
-            /**
-             * Whether the text field wants auto-complete.
-             * @since Chrome 40
-             */
+            /** Whether the text field wants auto-complete. */
             autoComplete: boolean;
-            /**
-             * Whether the text field wants spell-check.
-             * @since Chrome 40
-             */
+            /** Whether the text field wants spell-check. */
             spellCheck: boolean;
             /**
              * The auto-capitalize type of the text field.
              * @since Chrome 69
              */
-            autoCapitalize: AutoCapitalizeType;
+            autoCapitalize: `${AutoCapitalizeType}`;
             /**
              * Whether text entered into the text field should be used to improve typing suggestions for the user.
              * @since Chrome 68
@@ -6373,18 +6363,15 @@ declare namespace chrome {
             shouldDoLearning: boolean;
         }
 
-        /**
-         * A menu item used by an input method to interact with the user from the language menu.
-         * @since Chrome 30
-         */
+        /** A menu item used by an input method to interact with the user from the language menu. */
         export interface MenuItem {
             /** String that will be passed to callbacks referencing this MenuItem. */
             id: string;
-            /** Optional. Text displayed in the menu for this item. */
+            /** Text displayed in the menu for this item. */
             label?: string | undefined;
-            /** Optional. The type of menu item. */
-            style?: string | undefined;
-            /** Optional. Indicates this item is visible. */
+            /** The type of menu item. */
+            style?: `${MenuItemStyle}` | undefined;
+            /** Indicates this item is visible. */
             visible?: boolean | undefined;
             /** Indicates this item should be drawn with a check. */
             checked?: boolean | undefined;
@@ -6392,11 +6379,14 @@ declare namespace chrome {
             enabled?: boolean | undefined;
         }
 
-        export interface ImeParameters {
-            /** MenuItems to use. */
-            items: MenuItem[];
-            /** ID of the engine to use */
-            engineID: string;
+        /**
+         * The type of menu item. Radio buttons between separators are considered grouped.
+         * @since Chrome 44
+         */
+        export enum MenuItemStyle {
+            CHECK = "check",
+            RADIO = "radio",
+            SEPARATOR = "separator",
         }
 
         export interface CommitTextParameters {
@@ -6418,25 +6408,13 @@ declare namespace chrome {
             candidate: string;
             /** The candidate's id */
             id: number;
-            /**
-             * Optional.
-             * The id to add these candidates under
-             */
+            /** The id to add these candidates under */
             parentId?: number | undefined;
-            /**
-             * Optional.
-             * Short string displayed to next to the candidate, often the shortcut key or index
-             */
+            /** Short string displayed to next to the candidate, often the shortcut key or index */
             label?: string | undefined;
-            /**
-             * Optional.
-             * Additional text describing the candidate
-             */
+            /** Additional text describing the candidate */
             annotation?: string | undefined;
-            /**
-             * Optional.
-             * The usage or detail description of word.
-             */
+            /** The usage or detail description of word. */
             usage?: CandidateUsage | undefined;
         }
 
@@ -6453,7 +6431,7 @@ declare namespace chrome {
             /** Index of the character to end this segment after. */
             end: number;
             /** The type of the underline to modify this segment. */
-            style: string;
+            style: `${UnderlineStyle}`;
         }
 
         export interface CompositionParameters {
@@ -6461,79 +6439,111 @@ declare namespace chrome {
             contextID: number;
             /** Text to set */
             text: string;
-            /** Optional. List of segments and their associated types. */
+            /** List of segments and their associated types. */
             segments?: CompositionParameterSegment[] | undefined;
             /** Position in the text of the cursor. */
             cursor: number;
-            /** Optional. Position in the text that the selection starts at. */
+            /** Position in the text that the selection starts at. */
             selectionStart?: number | undefined;
-            /** Optional. Position in the text that the selection ends at. */
+            /** Position in the text that the selection ends at. */
             selectionEnd?: number | undefined;
         }
 
-        export interface MenuItemParameters {
+        /** @since Chrome 88 */
+        export interface MenuParameters {
+            /** MenuItems to add or update. They will be added in the order they exist in the array. */
             items: MenuItem[];
-            engineId: string;
+            /** ID of the engine to use. */
+            engineID: string;
         }
 
-        /** Type of the assistive window. */
-        export type AssistiveWindowType = "undo";
+        /**
+         * Which mouse buttons was clicked.
+         * @since Chrome 44
+         */
+        export enum MouseButton {
+            LEFT = "left",
+            MIDDLE = "middle",
+            RIGHT = "right",
+        }
 
-        /** ID of a button in an assistive window. */
-        export type AssistiveWindowButton = "undo" | "addToDictionary";
+        /**
+         * The screen type under which the IME is activated.
+         * @since Chrome 44
+         */
+        export enum ScreenType {
+            NORMAL = "normal",
+            LOGIN = "login",
+            LOCK = "lock",
+            SECONDARY_LOGIN = "secondary-login",
+        }
+
+        /**
+         * The type of the underline to modify this segment.
+         * @since Chrome 44
+         */
+        export enum UnderlineStyle {
+            UNDERLINE = "underline",
+            DOUBLE_UNDERLINE = "doubleUnderline",
+            NO_UNDERLINE = "noUnderline",
+        }
 
-        /** Properties of an assistive window. */
+        /**
+         * Where to display the candidate window. If set to 'cursor', the window follows the cursor. If set to 'composition', the window is locked to the beginning of the composition.
+         * @since Chrome 44
+         */
+        export enum WindowPosition {
+            CURSOR = "cursor",
+            COMPOSITION = "composition",
+        }
+
+        /** Type of assistive window. */
+        export enum AssistiveWindowType {
+            UNDO = "undo",
+        }
+
+        /**
+         * ID of a button in an assistive window.
+         * @since Chrome 85
+         */
+        export enum AssistiveWindowButton {
+            UNDO = "undo",
+            ADD_TO_DICTIONARY = "addToDictionary",
+        }
+
+        /**
+         * Properties of the assistive window.
+         * @since Chrome 85
+         */
         export interface AssistiveWindowProperties {
-            type: AssistiveWindowType;
+            type: `${AssistiveWindowType}`;
+            /** Sets true to show AssistiveWindow, sets false to hide. */
             visible: boolean;
+            /** Strings for ChromeVox to announce */
             announceString?: string | undefined;
         }
 
         export interface CandidateWindowParameterProperties {
-            /**
-             * Optional.
-             * True to show the cursor, false to hide it.
-             */
+            /** True to show the cursor, false to hide it. */
             cursorVisible?: boolean | undefined;
-            /**
-             * Optional.
-             * True if the candidate window should be rendered vertical, false to make it horizontal.
-             */
+            /** True if the candidate window should be rendered vertical, false to make it horizontal. */
             vertical?: boolean | undefined;
-            /**
-             * Optional.
-             * The number of candidates to display per page.
-             */
+            /** The number of candidates to display per page. */
             pageSize?: number | undefined;
-            /**
-             * Optional.
-             * True to display the auxiliary text, false to hide it.
-             */
+            /** True to display the auxiliary text, false to hide it. */
             auxiliaryTextVisible?: boolean | undefined;
-            /**
-             * Optional.
-             * Text that is shown at the bottom of the candidate window.
-             */
+            /** Text that is shown at the bottom of the candidate window. */
             auxiliaryText?: string | undefined;
-            /**
-             * Optional.
-             * True to show the Candidate window, false to hide it.
-             */
+            /** True to show the Candidate window, false to hide it. */
             visible?: boolean | undefined;
+            /** Where to display the candidate window. */
+            windowPosition?: `${WindowPosition}` | undefined;
             /**
-             * Optional.
-             * Where to display the candidate window.
-             * @since Chrome 28
-             */
-            windowPosition?: string | undefined;
-            /**
-             * Optional.
              * The index of the current chosen candidate out of total candidates.
              * @since Chrome 84
              */
             currentCandidateIndex?: number | undefined;
             /**
-             * Optional.
              * The total number of candidates for the candidate window.
              * @since Chrome 84
              */
@@ -6576,179 +6586,215 @@ declare namespace chrome {
             length: number;
         }
 
+        export interface AssistiveWindowButtonHighlightedParameters {
+            /** The text for the screenreader to announce. */
+            announceString?: string | undefined;
+            /** The ID of the button */
+            buttonID: `${AssistiveWindowButton}`;
+            /** ID of the context owning the assistive window. */
+            contextID: number;
+            /** Whether the button should be highlighted. */
+            highlighted: boolean;
+            /** The window type the button belongs to. */
+            windowType: `${AssistiveWindowType}`;
+        }
+
+        export interface AssistiveWindowPropertiesParameters {
+            /** ID of the context owning the assistive window. */
+            contextID: number;
+            /** Properties of the assistive window. */
+            properties: AssistiveWindowProperties;
+        }
+
         export interface SurroundingTextInfo {
-            /** The text around cursor. */
+            /** The text around the cursor. This is only a subset of all text in the input field. */
             text: string;
             /** The ending position of the selection. This value indicates caret position if there is no selection. */
             focus: number;
-            /** The beginning position of the selection. This value indicates caret position if is no selection. */
+            /**
+             * The offset position of `text`. Since `text` only includes a subset of text around the cursor, offset indicates the absolute position of the first character of `text`.
+             * @since Chrome 46
+             */
+            offset: number;
+            /** The beginning position of the selection. This value indicates caret position if there is no selection. */
             anchor: number;
         }
 
         export interface AssistiveWindowButtonClickedDetails {
             /** The ID of the button clicked. */
-            buttonID: AssistiveWindowButton;
+            buttonID: `${AssistiveWindowButton}`;
             /** The type of the assistive window. */
-            windowType: AssistiveWindowType;
+            windowType: `${AssistiveWindowType}`;
         }
 
-        export interface BlurEvent extends chrome.events.Event<(contextID: number) => void> {}
-
-        export interface AssistiveWindowButtonClickedEvent
-            extends chrome.events.Event<(details: AssistiveWindowButtonClickedDetails) => void>
-        {}
-
-        export interface CandidateClickedEvent
-            extends chrome.events.Event<(engineID: string, candidateID: number, button: string) => void>
-        {}
-
-        export interface KeyEventEvent
-            extends chrome.events.Event<(engineID: string, keyData: KeyboardEvent, requestId: string) => void>
-        {}
-
-        export interface DeactivatedEvent extends chrome.events.Event<(engineID: string) => void> {}
-
-        export interface InputContextUpdateEvent extends chrome.events.Event<(context: InputContext) => void> {}
-
-        export interface ActivateEvent extends chrome.events.Event<(engineID: string, screen: string) => void> {}
-
-        export interface FocusEvent extends chrome.events.Event<(context: InputContext) => void> {}
-
-        export interface MenuItemActivatedEvent extends chrome.events.Event<(engineID: string, name: string) => void> {}
-
-        export interface SurroundingTextChangedEvent
-            extends chrome.events.Event<(engineID: string, surroundingInfo: SurroundingTextInfo) => void>
-        {}
-
-        export interface InputResetEvent extends chrome.events.Event<(engineID: string) => void> {}
-
         /**
          * Adds the provided menu items to the language menu when this IME is active.
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 111.
          */
-        export function setMenuItems(parameters: ImeParameters, callback?: () => void): void;
+        export function setMenuItems(parameters: MenuParameters): Promise<void>;
+        export function setMenuItems(parameters: MenuParameters, callback: () => void): void;
+
         /**
          * Commits the provided text to the current input.
-         * @param callback Called when the operation completes with a boolean indicating if the text was accepted or not. On failure, chrome.runtime.lastError is set.
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 111.
          */
-        export function commitText(parameters: CommitTextParameters, callback?: (success: boolean) => void): void;
+        export function commitText(parameters: CommitTextParameters): Promise<boolean>;
+        export function commitText(parameters: CommitTextParameters, callback: (success: boolean) => void): void;
+
         /**
          * Sets the current candidate list. This fails if this extension doesn't own the active IME
-         * @param callback Called when the operation completes.
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 111.
          */
-        export function setCandidates(parameters: CandidatesParameters, callback?: (success: boolean) => void): void;
+        export function setCandidates(parameters: CandidatesParameters): Promise<boolean>;
+        export function setCandidates(parameters: CandidatesParameters, callback: (success: boolean) => void): void;
+
         /**
          * Set the current composition. If this extension does not own the active IME, this fails.
-         * @param callback Called when the operation completes with a boolean indicating if the text was accepted or not. On failure, chrome.runtime.lastError is set.
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 111.
          */
-        export function setComposition(parameters: CompositionParameters, callback?: (success: boolean) => void): void;
+        export function setComposition(parameters: CompositionParameters): Promise<boolean>;
+        export function setComposition(parameters: CompositionParameters, callback: (success: boolean) => void): void;
+
         /**
          * Updates the state of the MenuItems specified
-         * @param callback Called when the operation completes
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 111.
          */
-        export function updateMenuItems(parameters: MenuItemParameters, callback?: () => void): void;
+        export function updateMenuItems(parameters: MenuParameters): Promise<void>;
+        export function updateMenuItems(parameters: MenuParameters, callback: () => void): void;
+
         /**
          * Shows/Hides an assistive window with the given properties.
-         * @param parameters
-         * @param callback Called when the operation completes.
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 111.
          */
         export function setAssistiveWindowProperties(
-            parameters: {
-                contextID: number;
-                properties: chrome.input.ime.AssistiveWindowProperties;
-            },
-            callback?: (success: boolean) => void,
+            parameters: AssistiveWindowPropertiesParameters,
+        ): Promise<boolean>;
+        export function setAssistiveWindowProperties(
+            parameters: AssistiveWindowPropertiesParameters,
+            callback: (success: boolean) => void,
         ): void;
+
         /**
          * Highlights/Unhighlights a button in an assistive window.
-         * @param parameters
-         * @param callback Called when the operation completes. On failure, chrome.runtime.lastError is set.
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 111.
          */
         export function setAssistiveWindowButtonHighlighted(
-            parameters: {
-                contextID: number;
-                buttonID: chrome.input.ime.AssistiveWindowButton;
-                windowType: chrome.input.ime.AssistiveWindowType;
-                announceString?: string | undefined;
-                highlighted: boolean;
-            },
-            callback?: () => void,
+            parameters: AssistiveWindowButtonHighlightedParameters,
+        ): Promise<void>;
+        export function setAssistiveWindowButtonHighlighted(
+            parameters: AssistiveWindowButtonHighlightedParameters,
+            callback: () => void,
         ): void;
+
         /**
          * Sets the properties of the candidate window. This fails if the extension doesn't own the active IME
-         * @param callback Called when the operation completes.
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 111.
          */
+        export function setCandidateWindowProperties(parameters: CandidateWindowParameter): Promise<boolean>;
         export function setCandidateWindowProperties(
             parameters: CandidateWindowParameter,
-            callback?: (success: boolean) => void,
+            callback: (success: boolean) => void,
         ): void;
+
         /**
          * Clear the current composition. If this extension does not own the active IME, this fails.
-         * @param callback Called when the operation completes with a boolean indicating if the text was accepted or not. On failure, chrome.runtime.lastError is set.
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 111.
          */
+        export function clearComposition(parameters: ClearCompositionParameters): Promise<boolean>;
         export function clearComposition(
             parameters: ClearCompositionParameters,
-            callback?: (success: boolean) => void,
+            callback: (success: boolean) => void,
         ): void;
+
         /**
          * Set the position of the cursor in the candidate window. This is a no-op if this extension does not own the active IME.
-         * @param callback Called when the operation completes
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 111.
          */
         export function setCursorPosition(
             parameters: CursorPositionParameters,
-            callback?: (success: boolean) => void,
+        ): Promise<boolean>;
+        export function setCursorPosition(
+            parameters: CursorPositionParameters,
+            callback: (success: boolean) => void,
         ): void;
+
         /**
          * Sends the key events. This function is expected to be used by virtual keyboards. When key(s) on a virtual keyboard is pressed by a user, this function is used to propagate that event to the system.
-         * @since Chrome 33
-         * @param callback Called when the operation completes.
-         */
-        export function sendKeyEvents(parameters: SendKeyEventParameters, callback?: () => void): void;
-        /**
-         * Hides the input view window, which is popped up automatically by system. If the input view window is already hidden, this function will do nothing.
-         * @since Chrome 34
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 111.
          */
+        export function sendKeyEvents(parameters: SendKeyEventParameters): Promise<void>;
+        export function sendKeyEvents(parameters: SendKeyEventParameters, callback: () => void): void;
+
+        /** Hides the input view window, which is popped up automatically by system. If the input view window is already hidden, this function will do nothing. */
         export function hideInputView(): void;
+
         /**
          * Deletes the text around the caret.
-         * @since Chrome 27
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 111.
          */
-        export function deleteSurroundingText(parameters: DeleteSurroundingTextParameters, callback?: () => void): void;
+        export function deleteSurroundingText(parameters: DeleteSurroundingTextParameters): Promise<void>;
+        export function deleteSurroundingText(parameters: DeleteSurroundingTextParameters, callback: () => void): void;
+
         /**
          * Indicates that the key event received by onKeyEvent is handled. This should only be called if the onKeyEvent listener is asynchronous.
-         * @since Chrome 25
          * @param requestId Request id of the event that was handled. This should come from keyEvent.requestId
          * @param response True if the keystroke was handled, false if not
          */
         export function keyEventHandled(requestId: string, response: boolean): void;
 
         /** This event is sent when focus leaves a text box. It is sent to all extensions that are listening to this event, and enabled by the user. */
-        export var onBlur: BlurEvent;
-        /** This event is sent when a button in an assistive window is clicked. */
-        export var onAssistiveWindowButtonClicked: AssistiveWindowButtonClickedEvent;
-        /** This event is sent if this extension owns the active IME. */
-        export var onCandidateClicked: CandidateClickedEvent;
+        export const onBlur: events.Event<(contextID: number) => void>;
+
+        /**
+         * This event is sent when a button in an assistive window is clicked.
+         * @since Chrome 85
+         */
+        export const onAssistiveWindowButtonClicked: events.Event<
+            (details: AssistiveWindowButtonClickedDetails) => void
+        >;
+
         /** This event is sent if this extension owns the active IME. */
-        export var onKeyEvent: KeyEventEvent;
+        export const onCandidateClicked: events.Event<
+            (engineID: string, candidateID: number, button: `${MouseButton}`) => void
+        >;
+
+        /** Fired when a key event is sent from the operating system. The event will be sent to the extension if this extension owns the active IME. The listener function should return true if the event was handled false if it was not. If the event will be evaluated asynchronously, this function must return undefined and the IME must later call keyEventHandled() with the result. */
+        export const onKeyEvent: events.Event<(engineID: string, keyData: KeyboardEvent, requestId: string) => void>;
+
         /** This event is sent when an IME is deactivated. It signals that the IME will no longer be receiving onKeyPress events. */
-        export var onDeactivated: DeactivatedEvent;
-        /** 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. */
-        export var onInputContextUpdate: InputContextUpdateEvent;
+        export 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. */
+        export 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. */
-        export var onActivate: ActivateEvent;
-        /** 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. */
-        export var onFocus: FocusEvent;
+        export 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. */
+        export const onFocus: events.Event<(context: InputContext) => void>;
+
         /** Called when the user selects a menu item */
-        export var onMenuItemActivated: MenuItemActivatedEvent;
-        /**
-         * Called when the editable string around caret is changed or when the caret position is moved. The text length is limited to 100 characters for each back and forth direction.
-         * @since Chrome 27
-         */
-        export var onSurroundingTextChanged: SurroundingTextChangedEvent;
-        /**
-         * This event is sent when chrome terminates ongoing text input session.
-         * @since Chrome 29
-         */
-        export var onReset: InputResetEvent;
+        export const onMenuItemActivated: events.Event<(engineID: string, name: string) => void>;
+
+        /** Called when the editable string around caret is changed or when the caret position is moved. The text length is limited to 100 characters for each back and forth direction. */
+        export const onSurroundingTextChanged: events.Event<
+            (engineID: string, surroundingInfo: SurroundingTextInfo) => void
+        >;
+
+        /** This event is sent when chrome terminates ongoing text input session. */
+        export const onReset: events.Event<(engineID: string) => void>;
     }
 
     ////////////////////
@@ -10069,14 +10115,13 @@ declare namespace chrome {
             availableCapacity: number;
         }
 
-        /** Get physical memory information. */
-        export function getInfo(callback: (info: MemoryInfo) => void): void;
-
         /**
          * Get physical memory information.
-         * @return The `getInfo` method provides its result via callback or returned as a `Promise` (MV3 only).
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 91.
          */
         export function getInfo(): Promise<MemoryInfo>;
+        export function getInfo(callback: (info: MemoryInfo) => void): void;
     }
 
     ////////////////////
@@ -14103,27 +14148,26 @@ declare namespace chrome {
              * If specified, the side panel options for the given tab will be returned.
              * Otherwise, returns the default side panel options (used for any tab that doesn't have specific settings).
              */
-            tabId?: number;
+            tabId?: number | undefined;
         }
 
-        /**
-         * @since Chrome 116
-         */
+        /** @since Chrome 116 */
         export type OpenOptions =
             & {
-                /** The tab in which to open the side panel.
+                /**
+                 * 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.
                  * 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;
+                 * At least one of this and `windowId` must be provided. */
+                tabId?: number | undefined;
                 /**
                  * The window in which to open the side panel.
-                 * This is only applicable if the extension has a global (non-tab-specific) side panel or tabId is also specified.
+                 * This is only applicable if the extension has a global (non-tab-specific) side panel or `tabId` is also specified.
                  * This will override any currently-active global side panel the user has open in the given window.
-                 * At least one of this and tabId must be provided.
+                 * At least one of this and `tabId` must be provided.
                  */
-                windowId?: number;
+                windowId?: number | undefined;
             }
             & ({
                 tabId: number;
@@ -14133,7 +14177,7 @@ declare namespace chrome {
 
         export interface PanelBehavior {
             /** Whether clicking the extension's icon will toggle showing the extension's entry in the side panel. Defaults to false. */
-            openPanelOnActionClick?: boolean;
+            openPanelOnActionClick?: boolean | undefined;
         }
 
         /** @since Chrome 140 */
@@ -14143,15 +14187,15 @@ declare namespace chrome {
 
         export interface PanelOptions {
             /** Whether the side panel should be enabled. This is optional. The default value is true. */
-            enabled?: boolean;
+            enabled?: boolean | undefined;
             /** The path to the side panel HTML file to use. This must be a local resource within the extension package. */
-            path?: string;
+            path?: string | undefined;
             /**
              * If specified, the side panel options will only apply to the tab with this id.
              * If omitted, these options set the default behavior (used for any tab that doesn't have specific settings).
              * Note: if the same path is set for this tabId and the default tabId, then the panel for this tabId will be a different instance than the panel for the default tabId.
              */
-            tabId?: number;
+            tabId?: number | undefined;
         }
 
         /**
@@ -14177,84 +14221,48 @@ declare namespace chrome {
 
         /**
          * Returns the active panel configuration.
-         * Promises are supported in Manifest V3 and later, but callbacks are provided for backward compatibility.
-         * You cannot use both on the same function call.
-         * The promise resolves with the same type that is passed to the callback.
-         */
-        export function getOptions(
-            /** Specifies the context to return the configuration for. */
-            options: GetPanelOptions,
-            callback: (options: PanelOptions) => void,
-        ): void;
-
-        export function getOptions(
-            /** Specifies the context to return the configuration for. */
-            options: GetPanelOptions,
-        ): Promise<PanelOptions>;
+         *
+         * Can return its result via Promise.
+         * @param options Specifies the context to return the configuration for.
+         */
+        export function getOptions(options: GetPanelOptions): Promise<PanelOptions>;
+        export function getOptions(options: GetPanelOptions, callback: (options: PanelOptions) => void): void;
 
         /**
          * Returns the extension's current side panel behavior.
-         * Promises are supported in Manifest V3 and later, but callbacks are provided for backward compatibility.
-         * You cannot use both on the same function call.
-         * The promise resolves with the same type that is passed to the callback.
+         *
+         * Can return its result via Promise.
          */
-        export function getPanelBehavior(
-            callback: (behavior: PanelBehavior) => void,
-        ): void;
-
         export function getPanelBehavior(): Promise<PanelBehavior>;
+        export function getPanelBehavior(callback: (behavior: PanelBehavior) => void): void;
 
         /**
-         * @since Chrome 116
          * Opens the side panel for the extension. This may only be called in response to a user action.
-         * Promises are supported in Manifest V3 and later, but callbacks are provided for backward compatibility.
-         * You cannot use both on the same function call.
-         * The promise resolves with the same type that is passed to the callback.
+         *
+         * Can return its result via Promise.
+         * @param options Specifies the context in which to open the side panel.
+         * @since Chrome 116
          */
-        export function open(
-            /** Specifies the context in which to open the side panel. */
-            options: OpenOptions,
-            callback: () => void,
-        ): void;
-
-        export function open(
-            /** Specifies the context in which to open the side panel. */
-            options: OpenOptions,
-        ): Promise<void>;
+        export function open(options: OpenOptions): Promise<void>;
+        export function open(options: OpenOptions, callback: () => void): void;
 
         /**
          * Configures the side panel.
-         * Promises are supported in Manifest V3 and later, but callbacks are provided for backward compatibility.
-         * You cannot use both on the same function call.
-         * The promise resolves with the same type that is passed to the callback.
+         *
+         * Can return its result via Promise.
+         * @param options The configuration options to apply to the panel.
          */
-        export function setOptions(
-            /** The configuration options to apply to the panel. */
-            options: PanelOptions,
-            callback: () => void,
-        ): void;
-
-        export function setOptions(
-            /** The configuration options to apply to the panel. */
-            options: PanelOptions,
-        ): Promise<void>;
+        export function setOptions(options: PanelOptions): Promise<void>;
+        export function setOptions(options: PanelOptions, callback: () => void): void;
 
         /**
          * Configures the extension's side panel behavior. This is an upsert operation.
-         * Promises are supported in Manifest V3 and later, but callbacks are provided for backward compatibility.
-         * You cannot use both on the same function call.
-         * The promise resolves with the same type that is passed to the callback.
+         *
+         * Can return its result via Promise.
+         * @param behavior The new behavior to be set.
          */
-        export function setPanelBehavior(
-            /** The new behavior to be set. */
-            behavior: PanelBehavior,
-            callback: () => void,
-        ): void;
-
-        export function setPanelBehavior(
-            /** The new behavior to be set. */
-            behavior: PanelBehavior,
-        ): Promise<void>;
+        export function setPanelBehavior(behavior: PanelBehavior): Promise<void>;
+        export function setPanelBehavior(behavior: PanelBehavior, callback: () => void): void;
     }
 
     ////////////////////

chrome/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/chrome",
-    "version": "0.1.16",
+    "version": "0.1.18",
     "description": "TypeScript definitions for chrome",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/chrome",
     "license": "MIT",
@@ -94,6 +94,6 @@
         "@types/har-format": "*"
     },
     "peerDependencies": {},
-    "typesPublisherContentHash": "3cb748894519c88fdf8bbd53c9b88cde0db71bd0e3a5becf92e9e47bbb21bd6c",
+    "typesPublisherContentHash": "29c78aebedd7b318174f7216589325a219bf672ea2647e846d05e9ab4bb3bf43",
     "typeScriptVersion": "5.2"
 }