electron-types 41.0.0-beta.3 → 41.0.0-beta.4

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@41.0.0-beta.3
+npm install -D electron-types@41.0.0-beta.4
 # or
-yarn add -D electron-types@41.0.0-beta.3
+yarn add -D electron-types@41.0.0-beta.4
 # or
-pnpm add -D electron-types@41.0.0-beta.3
+pnpm add -D electron-types@41.0.0-beta.4
 ```
 
 ## Usage

package/dist/electron.d.ts

@@ -1,4 +1,4 @@
-// Type definitions for Electron 41.0.0-beta.3
+// Type definitions for Electron 41.0.0-beta.4
 // 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
      */
@@ -1742,6 +1745,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.
@@ -1888,6 +1911,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.
@@ -2188,7 +2217,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
      */
@@ -4393,7 +4426,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
      */
@@ -4415,7 +4452,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
      */
@@ -10045,45 +10086,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>,
                                    /**
-                                    * The index of the action that was activated.
+                                    * @deprecated
                                     */
-                                   index: number) => void): this;
+                                   actionIndex: number,
+                                   /**
+                                    * @deprecated
+                                    * @platform win32
+                                    */
+                                   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.
      */
@@ -10157,43 +10223,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;
     /**
@@ -10300,14 +10366,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 {
@@ -17714,7 +17787,8 @@ declare namespace Electron {
      * When a custom `pageSize` is passed, Chromium attempts to validate platform
      * specific minimum values for `width_microns` and `height_microns`. Width and
      * height must both be minimum 353 microns but may be higher on some operating
-     * systems.
+     * systems. If a valid `pageSize` is not passed and `usePrinterDefaultPageSize` is
+     * `false`, an error will be thrown.
      *
      * Prints window's web page. When `silent` is set to `true`, Electron will pick the
      * system's default printer if `deviceName` is empty and the default settings for
@@ -21666,6 +21740,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
@@ -21746,6 +21833,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
@@ -23409,6 +23503,14 @@ declare namespace Electron {
      * `width`.
      */
     pageSize?: (('A0' | 'A1' | 'A2' | 'A3' | 'A4' | 'A5' | 'A6' | 'Legal' | 'Letter' | 'Tabloid')) | (Size);
+    /**
+     * Whether to use a given printer's default page size. Default is `false`. Cannot
+     * be combined with `pageSize`. When `deviceName` is provided, uses the default
+     * page size of that specific printer. When `deviceName` is not provided, uses the
+     * default page size of the system's default printer. If the printer's default page
+     * size cannot be retrieved, falls back to A4 (210mm x 297mm).
+     */
+    usePrinterDefaultPageSize?: boolean;
   }
 
   interface WebContentsViewConstructorOptions {
@@ -23584,6 +23686,14 @@ declare namespace Electron {
      * `Letter`, `Tabloid` or an Object containing `height` in microns.
      */
     pageSize?: (('A3' | 'A4' | 'A5' | 'Legal' | 'Letter' | 'Tabloid')) | (Size);
+    /**
+     * Whether to use the system's default page size. Default is `false`. Cannot be
+     * combined with `pageSize`. When `deviceName` is provided, uses the default page
+     * size of that specific printer. When `deviceName` is not provided, uses the
+     * default page size of the system's default printer. If the printer's default page
+     * size cannot be retrieved, falls back to A4 (210mm x 297mm).
+     */
+    usePrinterDefaultPageSize?: boolean;
   }
 
   interface WillFrameNavigateEvent extends DOMEvent {
@@ -24150,7 +24260,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;
@@ -24544,7 +24656,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;
@@ -24866,7 +24980,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;
@@ -25187,7 +25303,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;
@@ -25602,7 +25720,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": "41.0.0-beta.3",
-  "extractedAt": "2026-02-17T00:47:37.380Z"
+  "electronVersion": "41.0.0-beta.4",
+  "extractedAt": "2026-02-20T00:45:27.560Z"
 }

package/package.json

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