electron-types 40.6.1 → 40.8.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.6.1
+npm install -D electron-types@40.8.0
 # or
-yarn add -D electron-types@40.6.1
+yarn add -D electron-types@40.8.0
 # or
-pnpm add -D electron-types@40.6.1
+pnpm add -D electron-types@40.8.0
 ```
 
 ## Usage

package/dist/electron.d.ts

@@ -1,4 +1,4 @@
-// Type definitions for Electron 40.6.1
+// Type definitions for Electron 40.8.0
 // Project: http://electronjs.org/
 // Definitions by: The Electron Team <https://github.com/electron/electron>
 // Definitions: https://github.com/electron/typescript-definitions
@@ -1211,7 +1211,7 @@ declare namespace Electron {
      * indicates that the app should restore the windows that were open the last time
      * the app was closed. This setting is not available on MAS builds or on macOS 13
      * and up.
-     * * `status` string _macOS_ - can be one of `not-registered`, `enabled`,
+     * * `status` string _macOS_ - can be `not-registered`, `enabled`,
      * `requires-approval`, or `not-found`.
      * * `executableWillLaunchAtLogin` boolean _Windows_ - `true` if app is set to open
      * at login and its run key is not deactivated. This differs from `openAtLogin` as
@@ -1223,7 +1223,7 @@ declare namespace Electron {
      * registry entry.
      *   * `args` string[] _Windows_ - the command-line arguments to pass to the
      * executable.
-     *   * `scope` string _Windows_ - one of `user` or `machine`. Indicates whether the
+     *   * `scope` string _Windows_ - can be `user` or `machine`. Indicates whether the
      * registry entry is under `HKEY_CURRENT USER` or `HKEY_LOCAL_MACHINE`.
      *   * `enabled` boolean _Windows_ - `true` if the app registry key is startup
      * approved and therefore shows as `enabled` in Task Manager and Windows settings.
@@ -9390,8 +9390,9 @@ declare namespace Electron {
      */
     accelerator: (Accelerator) | (null);
     /**
-     * A `boolean` indicating whether the item is checked. This property can be
-     * dynamically changed.
+     * A `boolean` indicating whether the item is checked.
+     *
+     * This property can be dynamically changed.
      *
      * A `checkbox` menu item will toggle the `checked` property on and off when
      * selected.
@@ -9416,21 +9417,27 @@ declare namespace Electron {
      */
     commandId: number;
     /**
-     * A `boolean` indicating whether the item is enabled. This property can be
-     * dynamically changed.
+     * A `boolean` indicating whether the item is enabled.
+     *
+     * This property can be dynamically changed.
      */
     enabled: boolean;
     /**
      * A `NativeImage | string` (optional) indicating the item's icon, if set.
+     *
+     * This property can be dynamically changed.
      */
     icon?: (NativeImage) | (string);
     /**
-     * A `string` indicating the item's unique id. This property can be dynamically
-     * changed.
+     * A `string` indicating the item's unique id.
+     *
+     * This property can be dynamically changed.
      */
     id: string;
     /**
      * A `string` indicating the item's visible label.
+     *
+     * This property can be dynamically changed.
      */
     label: string;
     /**
@@ -9466,6 +9473,8 @@ declare namespace Electron {
     sharingItem: SharingItem;
     /**
      * A `string` indicating the item's sublabel.
+     *
+     * This property can be dynamically changed.
      */
     sublabel: string;
     /**
@@ -9498,8 +9507,9 @@ declare namespace Electron {
      */
     readonly userAccelerator: (Accelerator) | (null);
     /**
-     * A `boolean` indicating whether the item is visible. This property can be
-     * dynamically changed.
+     * A `boolean` indicating whether the item is visible.
+     *
+     * This property can be dynamically changed.
      */
     visible: boolean;
   }
@@ -10145,11 +10155,11 @@ declare namespace Electron {
      * notification from the action center but the `close` event will not be emitted
      * again.
      */
-    on(event: 'close', listener: (event: Event) => void): this;
-    off(event: 'close', listener: (event: Event) => void): this;
-    once(event: 'close', listener: (event: Event) => void): this;
-    addListener(event: 'close', listener: (event: Event) => void): this;
-    removeListener(event: 'close', listener: (event: Event) => void): this;
+    on(event: 'close', listener: (details: Event<NotificationCloseEventParams>) => void): this;
+    off(event: 'close', listener: (details: Event<NotificationCloseEventParams>) => void): this;
+    once(event: 'close', listener: (details: Event<NotificationCloseEventParams>) => void): this;
+    addListener(event: 'close', listener: (details: Event<NotificationCloseEventParams>) => void): this;
+    removeListener(event: 'close', listener: (details: Event<NotificationCloseEventParams>) => void): this;
     /**
      * Emitted when an error is encountered while creating and showing the native
      * notification.
@@ -21345,11 +21355,11 @@ declare namespace Electron {
      */
     restoreState: boolean;
     /**
-     * can be one of `not-registered`, `enabled`, `requires-approval`, or `not-found`.
+     * can be `not-registered`, `enabled`, `requires-approval`, or `not-found`.
      *
      * @platform darwin
      */
-    status: string;
+    status: ('not-registered' | 'enabled' | 'requires-approval' | 'not-found');
     /**
      * `true` if app is set to open at login and its run key is not deactivated. This
      * differs from `openAtLogin` as it ignores the `args` option, this property will
@@ -21364,13 +21374,13 @@ declare namespace Electron {
 
   interface LoginItemSettingsOptions {
     /**
-     * Can be one of `mainAppService`, `agentService`, `daemonService`, or
-     * `loginItemService`. Defaults to `mainAppService`. Only available on macOS 13 and
-     * up. See app.setLoginItemSettings for more information about each type.
+     * Can be `mainAppService`, `agentService`, `daemonService`, or `loginItemService`.
+     * Defaults to `mainAppService`. Only available on macOS 13 and up. See
+     * app.setLoginItemSettings for more information about each type.
      *
      * @platform darwin
      */
-    type?: string;
+    type?: ('mainAppService' | 'agentService' | 'daemonService' | 'loginItemService');
     /**
      * The name of the service. Required if `type` is non-default. Only available on
      * macOS 13 and up.
@@ -21726,6 +21736,14 @@ declare namespace Electron {
     selectionIndex: number;
   }
 
+  interface NotificationCloseEventParams {
+    /**
+     * The reason the notification was closed. This can be 'userCanceled',
+     * 'applicationHidden', or 'timedOut'.
+     */
+    reason?: ('userCanceled' | 'applicationHidden' | 'timedOut');
+  }
+
   interface NotificationConstructorOptions {
     /**
      * A title for the notification, which will be displayed at the top of the
@@ -21831,6 +21849,13 @@ declare namespace Electron {
      * @experimental
      */
     sharedTexturePixelFormat?: ('argb' | 'rgbaf16');
+    /**
+     * The device scale factor of the offscreen rendering output. If not set, will use
+     * primary display's scale factor as default.
+     *
+     * @experimental
+     */
+    deviceScaleFactor?: number;
   }
 
   interface OnBeforeRedirectListenerDetails {
@@ -23772,12 +23797,12 @@ declare namespace Electron {
      */
     args: string[];
     /**
-     * one of `user` or `machine`. Indicates whether the registry entry is under
+     * can be `user` or `machine`. Indicates whether the registry entry is under
      * `HKEY_CURRENT USER` or `HKEY_LOCAL_MACHINE`.
      *
      * @platform win32
      */
-    scope: string;
+    scope: ('user' | 'machine');
     /**
      * `true` if the app registry key is startup approved and therefore shows as
      * `enabled` in Task Manager and Windows settings.
@@ -24218,6 +24243,7 @@ declare namespace Electron {
     type MoveToApplicationsFolderOptions = Electron.MoveToApplicationsFolderOptions;
     type NativePixmap = Electron.NativePixmap;
     type NotificationActionEventParams = Electron.NotificationActionEventParams;
+    type NotificationCloseEventParams = Electron.NotificationCloseEventParams;
     type NotificationConstructorOptions = Electron.NotificationConstructorOptions;
     type NotificationReplyEventParams = Electron.NotificationReplyEventParams;
     type Offscreen = Electron.Offscreen;
@@ -24614,6 +24640,7 @@ declare namespace Electron {
     type MoveToApplicationsFolderOptions = Electron.MoveToApplicationsFolderOptions;
     type NativePixmap = Electron.NativePixmap;
     type NotificationActionEventParams = Electron.NotificationActionEventParams;
+    type NotificationCloseEventParams = Electron.NotificationCloseEventParams;
     type NotificationConstructorOptions = Electron.NotificationConstructorOptions;
     type NotificationReplyEventParams = Electron.NotificationReplyEventParams;
     type Offscreen = Electron.Offscreen;
@@ -24938,6 +24965,7 @@ declare namespace Electron {
     type MoveToApplicationsFolderOptions = Electron.MoveToApplicationsFolderOptions;
     type NativePixmap = Electron.NativePixmap;
     type NotificationActionEventParams = Electron.NotificationActionEventParams;
+    type NotificationCloseEventParams = Electron.NotificationCloseEventParams;
     type NotificationConstructorOptions = Electron.NotificationConstructorOptions;
     type NotificationReplyEventParams = Electron.NotificationReplyEventParams;
     type Offscreen = Electron.Offscreen;
@@ -25261,6 +25289,7 @@ declare namespace Electron {
     type MoveToApplicationsFolderOptions = Electron.MoveToApplicationsFolderOptions;
     type NativePixmap = Electron.NativePixmap;
     type NotificationActionEventParams = Electron.NotificationActionEventParams;
+    type NotificationCloseEventParams = Electron.NotificationCloseEventParams;
     type NotificationConstructorOptions = Electron.NotificationConstructorOptions;
     type NotificationReplyEventParams = Electron.NotificationReplyEventParams;
     type Offscreen = Electron.Offscreen;
@@ -25678,6 +25707,7 @@ declare namespace Electron {
     type MoveToApplicationsFolderOptions = Electron.MoveToApplicationsFolderOptions;
     type NativePixmap = Electron.NativePixmap;
     type NotificationActionEventParams = Electron.NotificationActionEventParams;
+    type NotificationCloseEventParams = Electron.NotificationCloseEventParams;
     type NotificationConstructorOptions = Electron.NotificationConstructorOptions;
     type NotificationReplyEventParams = Electron.NotificationReplyEventParams;
     type Offscreen = Electron.Offscreen;

package/dist/version.json

@@ -1,4 +1,4 @@
 {
-  "electronVersion": "40.6.1",
-  "extractedAt": "2026-02-25T00:49:58.710Z"
+  "electronVersion": "40.8.0",
+  "extractedAt": "2026-03-06T00:50:13.309Z"
 }

package/package.json

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