electron-types 40.4.1 → 40.6.0

package/README.md

@@ -11,11 +11,11 @@ The official `electron` package is ~200MB because it includes the Electron binar
 Since this package only provides TypeScript types, install it as a dev dependency. **Install the version that matches your Electron version** (see [Version Matching](#version-matching)):
 
 ```bash
-npm install -D electron-types@40.4.1
+npm install -D electron-types@40.6.0
 # or
-yarn add -D electron-types@40.4.1
+yarn add -D electron-types@40.6.0
 # or
-pnpm add -D electron-types@40.4.1
+pnpm add -D electron-types@40.6.0
 ```
 
 ## Usage

package/dist/electron.d.ts

@@ -1,4 +1,4 @@
-// Type definitions for Electron 40.4.1
+// Type definitions for Electron 40.6.0
 // Project: http://electronjs.org/
 // Definitions by: The Electron Team <https://github.com/electron/electron>
 // Definitions: https://github.com/electron/typescript-definitions
@@ -517,7 +517,10 @@ declare namespace Electron {
                                   callback: (username?: string, password?: string) => void) => void): this;
     /**
      * Emitted when the user clicks the native macOS new tab button. The new tab button
-     * is only visible if the current `BrowserWindow` has a `tabbingIdentifier`
+     * is only visible if the current `BrowserWindow` has a `tabbingIdentifier`.
+     *
+     * You must create a window in this handler in order for macOS tabbing to work as
+     * expected.
      *
      * @platform darwin
      */
@@ -1740,6 +1743,26 @@ declare namespace Electron {
      * @platform darwin
      */
     setSecureKeyboardEntryEnabled(enabled: boolean): void;
+    /**
+     * Changes the Toast Activator CLSID to `id`. If one is not set via this method, it
+     * will be randomly generated for the app.
+     *
+     * * The value must be a valid GUID/CLSID in one of the following forms:
+     *   * Canonical brace-wrapped: `{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}`
+     * (preferred)
+     *   * Canonical without braces: `XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX` (braces
+     * will be added automatically)
+     * * Hex digits are case-insensitive.
+     *
+     * This method should be called early (before showing notifications) so the value
+     * is baked into the registration/shortcut. Supplying an empty string or an
+     * unparsable value throws and leaves the existing (or generated) CLSID unchanged.
+     * If this method is never called, a random CLSID is generated once per run and
+     * exposed via `app.toastActivatorCLSID`.
+     *
+     * @platform win32
+     */
+    setToastActivatorCLSID(id: string): void;
     /**
      * Creates an `NSUserActivity` and sets it as the current activity. The activity is
      * eligible for Handoff to another device afterward.
@@ -1886,6 +1909,12 @@ declare namespace Electron {
      * @platform darwin,win32
      */
     readonly runningUnderARM64Translation: boolean;
+    /**
+     * A `string` property that returns the app's Toast Activator CLSID.
+     *
+     * @platform win32
+     */
+    readonly toastActivatorCLSID: string;
     /**
      * A `string` which is the user agent string Electron will use as a global
      * fallback.
@@ -2186,7 +2215,11 @@ declare namespace Electron {
      */
     removeListener(event: 'moved', listener: () => void): this;
     /**
-     * Emitted when the native new tab button is clicked.
+     * Emitted when the user clicks the native macOS new tab button. The new tab button
+     * is only visible if the current `BrowserWindow` has a `tabbingIdentifier`.
+     *
+     * You must create a window in this handler in order for macOS tabbing to work as
+     * expected.
      *
      * @platform darwin
      */
@@ -4391,7 +4424,11 @@ declare namespace Electron {
      */
     removeListener(event: 'moved', listener: () => void): this;
     /**
-     * Emitted when the native new tab button is clicked.
+     * Emitted when the user clicks the native macOS new tab button. The new tab button
+     * is only visible if the current `BrowserWindow` has a `tabbingIdentifier`.
+     *
+     * You must create a window in this handler in order for macOS tabbing to work as
+     * expected.
      *
      * @platform darwin
      */
@@ -4413,7 +4450,11 @@ declare namespace Electron {
      */
     removeListener(event: 'new-window-for-tab', listener: () => void): this;
     /**
-     * Emitted when the native new tab button is clicked.
+     * Emitted when the user clicks the native macOS new tab button. The new tab button
+     * is only visible if the current `BrowserWindow` has a `tabbingIdentifier`.
+     *
+     * You must create a window in this handler in order for macOS tabbing to work as
+     * expected.
      *
      * @platform darwin
      */
@@ -7440,9 +7481,12 @@ declare namespace Electron {
      * `DesktopCapturerSource` represents a screen or an individual window that can be
      * captured.
      *
-     * > [!NOTE] Capturing the screen contents requires user consent on macOS 10.15
-     * Catalina or higher, which can detected by
-     * `systemPreferences.getMediaAccessStatus`.
+     * > [!NOTE]
+     *
+     * > * Capturing audio requires `NSAudioCaptureUsageDescription` Info.plist key on
+     * macOS 14.2 Sonoma and higher - read more.
+     * * Capturing the screen contents requires user consent on macOS 10.15 Catalina or
+     * higher, which can detected by `systemPreferences.getMediaAccessStatus`.
      */
     getSources(options: SourcesOptions): Promise<Electron.DesktopCapturerSource[]>;
   }
@@ -10016,45 +10060,70 @@ declare namespace Electron {
     // Docs: https://electronjs.org/docs/api/notification
 
     /**
-     * @platform darwin
+     * @platform darwin,win32
      */
-    on(event: 'action', listener: (event: Event,
+    on(event: 'action', listener: (details: Event<NotificationActionEventParams>,
+                                   /**
+                                    * @deprecated
+                                    */
+                                   actionIndex: number,
                                    /**
-                                    * The index of the action that was activated.
+                                    * @deprecated
+                                    * @platform win32
                                     */
-                                   index: number) => void): this;
+                                   selectionIndex: number) => void): this;
     /**
-     * @platform darwin
+     * @platform darwin,win32
      */
-    off(event: 'action', listener: (event: Event,
+    off(event: 'action', listener: (details: Event<NotificationActionEventParams>,
+                                   /**
+                                    * @deprecated
+                                    */
+                                   actionIndex: number,
                                    /**
-                                    * The index of the action that was activated.
+                                    * @deprecated
+                                    * @platform win32
                                     */
-                                   index: number) => void): this;
+                                   selectionIndex: number) => void): this;
     /**
-     * @platform darwin
+     * @platform darwin,win32
      */
-    once(event: 'action', listener: (event: Event,
+    once(event: 'action', listener: (details: Event<NotificationActionEventParams>,
+                                   /**
+                                    * @deprecated
+                                    */
+                                   actionIndex: number,
                                    /**
-                                    * The index of the action that was activated.
+                                    * @deprecated
+                                    * @platform win32
                                     */
-                                   index: number) => void): this;
+                                   selectionIndex: number) => void): this;
     /**
-     * @platform darwin
+     * @platform darwin,win32
      */
-    addListener(event: 'action', listener: (event: Event,
+    addListener(event: 'action', listener: (details: Event<NotificationActionEventParams>,
+                                   /**
+                                    * @deprecated
+                                    */
+                                   actionIndex: number,
                                    /**
-                                    * The index of the action that was activated.
+                                    * @deprecated
+                                    * @platform win32
                                     */
-                                   index: number) => void): this;
+                                   selectionIndex: number) => void): this;
     /**
-     * @platform darwin
+     * @platform darwin,win32
      */
-    removeListener(event: 'action', listener: (event: Event,
+    removeListener(event: 'action', listener: (details: Event<NotificationActionEventParams>,
+                                   /**
+                                    * @deprecated
+                                    */
+                                   actionIndex: number,
                                    /**
-                                    * The index of the action that was activated.
+                                    * @deprecated
+                                    * @platform win32
                                     */
-                                   index: number) => void): this;
+                                   selectionIndex: number) => void): this;
     /**
      * Emitted when the notification is clicked by the user.
      */
@@ -10128,43 +10197,43 @@ declare namespace Electron {
      * Emitted when the user clicks the "Reply" button on a notification with
      * `hasReply: true`.
      *
-     * @platform darwin
+     * @platform darwin,win32
      */
-    on(event: 'reply', listener: (event: Event,
+    on(event: 'reply', listener: (details: Event<NotificationReplyEventParams>,
                                   /**
-                                   * The string the user entered into the inline reply field.
+                                   * @deprecated
                                    */
                                   reply: string) => void): this;
     /**
-     * @platform darwin
+     * @platform darwin,win32
      */
-    off(event: 'reply', listener: (event: Event,
+    off(event: 'reply', listener: (details: Event<NotificationReplyEventParams>,
                                   /**
-                                   * The string the user entered into the inline reply field.
+                                   * @deprecated
                                    */
                                   reply: string) => void): this;
     /**
-     * @platform darwin
+     * @platform darwin,win32
      */
-    once(event: 'reply', listener: (event: Event,
+    once(event: 'reply', listener: (details: Event<NotificationReplyEventParams>,
                                   /**
-                                   * The string the user entered into the inline reply field.
+                                   * @deprecated
                                    */
                                   reply: string) => void): this;
     /**
-     * @platform darwin
+     * @platform darwin,win32
      */
-    addListener(event: 'reply', listener: (event: Event,
+    addListener(event: 'reply', listener: (details: Event<NotificationReplyEventParams>,
                                   /**
-                                   * The string the user entered into the inline reply field.
+                                   * @deprecated
                                    */
                                   reply: string) => void): this;
     /**
-     * @platform darwin
+     * @platform darwin,win32
      */
-    removeListener(event: 'reply', listener: (event: Event,
+    removeListener(event: 'reply', listener: (details: Event<NotificationReplyEventParams>,
                                   /**
-                                   * The string the user entered into the inline reply field.
+                                   * @deprecated
                                    */
                                   reply: string) => void): this;
     /**
@@ -10271,14 +10340,21 @@ declare namespace Electron {
 
     // Docs: https://electronjs.org/docs/api/structures/notification-action
 
+    /**
+     * The list of items for the `selection` action `type`.
+     *
+     * @platform win32
+     */
+    items?: string[];
     /**
      * The label for the given action.
      */
     text?: string;
     /**
-     * The type of action, can be `button`.
+     * The type of action, can be `button` or `selection`. `selection` is only
+     * supported on Windows.
      */
-    type: ('button');
+    type: ('button' | 'selection');
   }
 
   interface NotificationResponse {
@@ -18617,6 +18693,10 @@ declare namespace Electron {
      * Enables Chromium's experimental features. Default is `false`.
      */
     experimentalFeatures?: boolean;
+    /**
+     * Whether to focus the WebContents when navigating. Default is `true`.
+     */
+    focusOnNavigation?: boolean;
     /**
      * Specifies how to run image animations (E.g. GIFs).  Can be `animate`,
      * `animateOnce` or `noAnimation`.  Default is `animate`.
@@ -21633,6 +21713,19 @@ declare namespace Electron {
     supportsZeroCopyWebGpuImport: boolean;
   }
 
+  interface NotificationActionEventParams {
+    /**
+     * The index of the action that was activated.
+     */
+    actionIndex: number;
+    /**
+     * The index of the selected item, if one was chosen. -1 if none was chosen.
+     *
+     * @platform win32
+     */
+    selectionIndex: number;
+  }
+
   interface NotificationConstructorOptions {
     /**
      * A title for the notification, which will be displayed at the top of the
@@ -21713,6 +21806,13 @@ declare namespace Electron {
     toastXml?: string;
   }
 
+  interface NotificationReplyEventParams {
+    /**
+     * The string the user entered into the inline reply field.
+     */
+    reply: string;
+  }
+
   interface Offscreen {
     /**
      * Whether to use GPU shared texture for accelerated paint event. Defaults to
@@ -24117,7 +24217,9 @@ declare namespace Electron {
     type MessageEvent = Electron.MessageEvent;
     type MoveToApplicationsFolderOptions = Electron.MoveToApplicationsFolderOptions;
     type NativePixmap = Electron.NativePixmap;
+    type NotificationActionEventParams = Electron.NotificationActionEventParams;
     type NotificationConstructorOptions = Electron.NotificationConstructorOptions;
+    type NotificationReplyEventParams = Electron.NotificationReplyEventParams;
     type Offscreen = Electron.Offscreen;
     type OnBeforeRedirectListenerDetails = Electron.OnBeforeRedirectListenerDetails;
     type OnBeforeRequestListenerDetails = Electron.OnBeforeRequestListenerDetails;
@@ -24511,7 +24613,9 @@ declare namespace Electron {
     type MessageEvent = Electron.MessageEvent;
     type MoveToApplicationsFolderOptions = Electron.MoveToApplicationsFolderOptions;
     type NativePixmap = Electron.NativePixmap;
+    type NotificationActionEventParams = Electron.NotificationActionEventParams;
     type NotificationConstructorOptions = Electron.NotificationConstructorOptions;
+    type NotificationReplyEventParams = Electron.NotificationReplyEventParams;
     type Offscreen = Electron.Offscreen;
     type OnBeforeRedirectListenerDetails = Electron.OnBeforeRedirectListenerDetails;
     type OnBeforeRequestListenerDetails = Electron.OnBeforeRequestListenerDetails;
@@ -24833,7 +24937,9 @@ declare namespace Electron {
     type MessageEvent = Electron.MessageEvent;
     type MoveToApplicationsFolderOptions = Electron.MoveToApplicationsFolderOptions;
     type NativePixmap = Electron.NativePixmap;
+    type NotificationActionEventParams = Electron.NotificationActionEventParams;
     type NotificationConstructorOptions = Electron.NotificationConstructorOptions;
+    type NotificationReplyEventParams = Electron.NotificationReplyEventParams;
     type Offscreen = Electron.Offscreen;
     type OnBeforeRedirectListenerDetails = Electron.OnBeforeRedirectListenerDetails;
     type OnBeforeRequestListenerDetails = Electron.OnBeforeRequestListenerDetails;
@@ -25154,7 +25260,9 @@ declare namespace Electron {
     type MessageEvent = Electron.MessageEvent;
     type MoveToApplicationsFolderOptions = Electron.MoveToApplicationsFolderOptions;
     type NativePixmap = Electron.NativePixmap;
+    type NotificationActionEventParams = Electron.NotificationActionEventParams;
     type NotificationConstructorOptions = Electron.NotificationConstructorOptions;
+    type NotificationReplyEventParams = Electron.NotificationReplyEventParams;
     type Offscreen = Electron.Offscreen;
     type OnBeforeRedirectListenerDetails = Electron.OnBeforeRedirectListenerDetails;
     type OnBeforeRequestListenerDetails = Electron.OnBeforeRequestListenerDetails;
@@ -25569,7 +25677,9 @@ declare namespace Electron {
     type MessageEvent = Electron.MessageEvent;
     type MoveToApplicationsFolderOptions = Electron.MoveToApplicationsFolderOptions;
     type NativePixmap = Electron.NativePixmap;
+    type NotificationActionEventParams = Electron.NotificationActionEventParams;
     type NotificationConstructorOptions = Electron.NotificationConstructorOptions;
+    type NotificationReplyEventParams = Electron.NotificationReplyEventParams;
     type Offscreen = Electron.Offscreen;
     type OnBeforeRedirectListenerDetails = Electron.OnBeforeRedirectListenerDetails;
     type OnBeforeRequestListenerDetails = Electron.OnBeforeRequestListenerDetails;

package/dist/version.json

@@ -1,4 +1,4 @@
 {
-  "electronVersion": "40.4.1",
-  "extractedAt": "2026-02-13T18:22:08.507Z"
+  "electronVersion": "40.6.0",
+  "extractedAt": "2026-02-19T12:24:30.952Z"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "electron-types",
-  "version": "40.4.1",
+  "version": "40.6.0",
   "type": "module",
   "description": "TypeScript type definitions extracted from the electron package",
   "types": "./dist/electron.d.ts",