electron-types 40.0.0 → 40.2.1

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.0.0
+npm install -D electron-types@40.2.1
 # or
-yarn add -D electron-types@40.0.0
+yarn add -D electron-types@40.2.1
 # or
-pnpm add -D electron-types@40.0.0
+pnpm add -D electron-types@40.2.1
 ```
 
 ## Usage

package/dist/electron.d.ts

@@ -1,4 +1,4 @@
-// Type definitions for Electron 40.0.0
+// Type definitions for Electron 40.2.1
 // Project: http://electronjs.org/
 // Definitions by: The Electron Team <https://github.com/electron/electron>
 // Definitions: https://github.com/electron/typescript-definitions
@@ -1149,6 +1149,9 @@ declare namespace Electron {
      *
      * Using `basic` should be preferred if only basic information like `vendorId` or
      * `deviceId` is needed.
+     *
+     * Promise is rejected if the GPU is completely disabled, i.e. no hardware and
+     * software implementations are available.
      */
     getGPUInfo(infoType: 'basic' | 'complete'): Promise<unknown>;
     /**
@@ -1940,7 +1943,7 @@ declare namespace Electron {
     /**
      * Emitted when an update has been downloaded.
      *
-     * On Windows only `releaseName` is available.
+     * With Squirrel.Windows only `releaseName` is available.
      *
      * > [!NOTE] It is not strictly necessary to handle this event. A successfully
      * downloaded update will still be applied the next time the application starts.
@@ -2662,6 +2665,10 @@ declare namespace Electron {
      * height. For example, calling `win.setBounds({ x: 25, y: 20, width: 800, height:
      * 600 })` with a tray height of 38 means that `win.getBounds()` will return `{ x:
      * 25, y: 38, width: 800, height: 600 }`.
+     *
+     * > [!NOTE] On Wayland, this method will return `{ x: 0, y: 0, ... }` as
+     * introspecting or programmatically changing the global window coordinates is
+     * prohibited.
      */
     getBounds(): Rectangle;
     /**
@@ -2725,6 +2732,9 @@ declare namespace Electron {
     getParentWindow(): (BaseWindow) | (null);
     /**
      * Contains the window's current position.
+     *
+     * > [!NOTE] On Wayland, this method will return `[0, 0]` as introspecting or
+     * programmatically changing the global window coordinates is prohibited.
      */
     getPosition(): number[];
     /**
@@ -5341,6 +5351,10 @@ declare namespace Electron {
      * height. For example, calling `win.setBounds({ x: 25, y: 20, width: 800, height:
      * 600 })` with a tray height of 38 means that `win.getBounds()` will return `{ x:
      * 25, y: 38, width: 800, height: 600 }`.
+     *
+     * > [!NOTE] On Wayland, this method will return `{ x: 0, y: 0, ... }` as
+     * introspecting or programmatically changing the global window coordinates is
+     * prohibited.
      */
     getBounds(): Rectangle;
     /**
@@ -5423,6 +5437,9 @@ declare namespace Electron {
     getParentWindow(): (BrowserWindow) | (null);
     /**
      * Contains the window's current position.
+     *
+     * > [!NOTE] On Wayland, this method will return `[0, 0]` as introspecting or
+     * programmatically changing the global window coordinates is prohibited.
      */
     getPosition(): number[];
     /**
@@ -13155,7 +13172,7 @@ declare namespace Electron {
     /**
      * The pixel format of the texture.
      */
-    pixelFormat: ('bgra' | 'rgba' | 'rgbaf16');
+    pixelFormat: ('bgra' | 'rgba' | 'rgbaf16' | 'nv12');
     /**
      * A timestamp in microseconds that will be reflected to `VideoFrame`.
      */
@@ -13319,6 +13336,10 @@ declare namespace Electron {
      *
      * This moves a path to the OS-specific trash location (Trash on macOS, Recycle Bin
      * on Windows, and a desktop-environment-specific location on Linux).
+     *
+     * The path must use the default path separator for the platform (backslash on
+     * Windows). Use `path.resolve()` from the `node:path` module to ensure correct
+     * handling on all filesystems.
      */
     trashItem(path: string): Promise<void>;
     /**
@@ -17968,10 +17989,11 @@ declare namespace Electron {
      */
     frameRate: number;
     /**
-     * A `WebContents` instance that might own this `WebContents`.
+     * A `WebContents | null` property that represents a `WebContents` instance that
+     * might own this `WebContents`.
      *
      */
-    readonly hostWebContents: WebContents;
+    readonly hostWebContents: (WebContents) | (null);
     /**
      * A `Integer` representing the unique ID of this WebContents. Each ID is unique
      * among all `WebContents` instances of the entire Electron application.
@@ -20760,6 +20782,11 @@ declare namespace Electron {
   }
 
   interface FeedURLOptions {
+    /**
+     * The update server URL. For _Windows_ MSIX, this can be either a direct link to
+     * an MSIX file (e.g., `https://example.com/update.msix`) or a JSON endpoint that
+     * returns update information (see the Squirrel.Mac README for more information).
+     */
     url: string;
     /**
      * HTTP request headers.
@@ -20773,6 +20800,13 @@ declare namespace Electron {
      * @platform darwin
      */
     serverType?: ('json' | 'default');
+    /**
+     * If `true`, allows downgrades to older versions for MSIX packages. Defaults to
+     * `false`.
+     *
+     * @platform win32
+     */
+    allowAnyVersion?: boolean;
   }
 
   interface FileIconOptions {
@@ -25988,11 +26022,11 @@ declare namespace NodeJS {
      */
     noAsar: boolean;
     /**
-     * A `boolean` that controls whether or not deprecation warnings are printed to
-     * `stderr`. Setting this to `true` will silence deprecation warnings. This
-     * property is used instead of the `--no-deprecation` command line flag.
+     * A `boolean` (optional) that controls whether or not deprecation warnings are
+     * printed to `stderr`. Setting this to `true` will silence deprecation warnings.
+     * This property is used instead of the `--no-deprecation` command line flag.
      */
-    noDeprecation: boolean;
+    noDeprecation?: boolean;
     /**
      * A `Electron.ParentPort` property if this is a `UtilityProcess` (or `null`
      * otherwise) allowing communication with the parent process.
@@ -26041,8 +26075,8 @@ declare namespace NodeJS {
      */
     readonly type: ('browser' | 'renderer' | 'service-worker' | 'worker' | 'utility');
     /**
-     * A `boolean`. If the app is running as a Windows Store app (appx), this property
-     * is `true`, for otherwise it is `undefined`.
+     * A `boolean`. If the app is running as an MSIX package (including AppX for
+     * Windows Store), this property is `true`, otherwise it is `undefined`.
      *
      */
     readonly windowsStore: boolean;

package/dist/version.json

@@ -1,4 +1,4 @@
 {
-  "electronVersion": "40.0.0",
-  "extractedAt": "2026-01-16T06:14:54.069Z"
+  "electronVersion": "40.2.1",
+  "extractedAt": "2026-02-06T06:27:38.457Z"
 }

package/package.json

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