electron-types 45.0.0-alpha.1 → 45.0.0-alpha.10

package/README.md

@@ -14,11 +14,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@45.0.0-alpha.1
+npm install -D electron-types@45.0.0-alpha.10
 # or
-yarn add -D electron-types@45.0.0-alpha.1
+yarn add -D electron-types@45.0.0-alpha.10
 # or
-pnpm add -D electron-types@45.0.0-alpha.1
+pnpm add -D electron-types@45.0.0-alpha.10
 ```
 
 ## Usage

package/dist/electron.d.ts

@@ -1,4 +1,4 @@
-// Type definitions for Electron 45.0.0-alpha.1
+// Type definitions for Electron 45.0.0-alpha.10
 // Project: http://electronjs.org/
 // Definitions by: The Electron Team <https://github.com/electron/electron>
 // Definitions: https://github.com/electron/typescript-definitions
@@ -1220,6 +1220,12 @@ declare namespace Electron {
     /**
      * Array of `ProcessMetric` objects that correspond to memory and CPU usage
      * statistics of all the processes associated with the app.
+     *
+     * > [!NOTE] `cpu.percentCPUUsage` and `cpu.idleWakeupsPerSecond` are averages over
+     * the time since the last call to `app.getAppMetrics()`, and each call starts a
+     * new measurement interval for every process at once. Other code in the main
+     * process, including dependencies, shares those intervals. See `CPUUsage` for more
+     * details.
      */
     getAppMetrics(): ProcessMetric[];
     /**
@@ -3011,6 +3017,10 @@ declare namespace Electron {
     isContentProtected(): boolean;
     /**
      * Whether the window is destroyed.
+     *
+     * > [!NOTE] Once a window is destroyed, accessing most of its other properties and
+     * methods throws `Object has been destroyed`, so callbacks that may run after the
+     * window is gone should guard with `isDestroyed()`.
      */
     isDestroyed(): boolean;
     /**
@@ -6712,6 +6722,9 @@ declare namespace Electron {
      *
      * See the `webContents` documentation for its methods and events.
      *
+     * > [!NOTE] Reading this property throws `Object has been destroyed` once the
+     * window has been destroyed; see `win.isDestroyed()`.
+     *
      */
     readonly webContents: WebContents;
   }
@@ -7196,36 +7209,6 @@ declare namespace Electron {
 
     // Docs: https://electronjs.org/docs/api/content-tracing
 
-    /**
-     * Resolves once heap profiling has been enabled.
-     *
-     * Enable heap profiling for MemoryInfra traces. Equivalent to the `--memlog`
-     * switch in Chrome.
-     *
-     * Only takes effect if the `disabled-by-default-memory-infra` category is
-     * included.
-     *
-     * Needs to be called before `contentTracing.startRecording()`.
-     *
-     * Usage:
-     *
-     * To view the recorded heap dumps:
-     *
-     * * Download the breakpad symbols for your Electron version from the Electron
-     * GitHub releases
-     * * Clone the Electron source code
-     * * In your Chromium checkout for Electron, run this command to symbolicate the
-     * heap dump:
-     * * Open the symbolicated trace in `chrome://tracing` (the Perfetto UI does not
-     * support memory dumps yet)
-     * * Click on one of the `M` symbols
-     * * Click on a `☰` triple bar icon (e.g., in the `malloc` column)
-     *
-     * [Image: Screenshot showing how to view a heapdump in Chromium's tracing view]
-     *
-     * @experimental
-     */
-    enableHeapProfiling(options?: EnableHeapProfilingOptions): Promise<void>;
     /**
      * resolves with an array of category groups once all child processes have
      * acknowledged the `getCategories` request
@@ -7460,12 +7443,14 @@ declare namespace Electron {
      */
     cumulativeCPUUsage?: number;
     /**
-     * The number of average idle CPU wakeups per second since the last call to
-     * getCPUUsage. First call returns 0. Will always return 0 on Windows.
+     * The number of average idle CPU wakeups per second since the last call to the API
+     * that returned this object. First call returns 0. Will always return 0 on
+     * Windows.
      */
     idleWakeupsPerSecond: number;
     /**
-     * Percentage of CPU used since the last call to getCPUUsage. First call returns 0.
+     * Percentage of CPU used since the last call to the API that returned this object.
+     * First call returns 0.
      */
     percentCPUUsage: number;
   }
@@ -7707,6 +7692,14 @@ declare namespace Electron {
      * indicating the failure of the command.
      *
      * Send given command to the debugging target.
+     *
+     * > [!NOTE]
+     *
+     * * If `sendCommand` is called before the target has navigated (e.g. immediately
+     * after `attach()`), the returned promise may not resolve until navigation occurs.
+     * * If the command's response has no `result` data, as defined by that command's
+     * entry in the remote debugging protocol, the promise resolves with an empty
+     * object (`{}`), not `null` or `undefined`.
      */
     sendCommand(method: string, commandParams?: any, sessionId?: string): Promise<any>;
   }
@@ -8314,6 +8307,14 @@ declare namespace Electron {
      * actual name of saved file will be different.
      */
     getFilename(): string;
+    /**
+     * The origin that started the download (for example `https://example.com`, or
+     * `null` for an opaque origin), or an empty string if the download was not started
+     * by web content (for example `webContents.downloadURL()`). Use this rather than
+     * `getURL()` or the `webContents` to decide whose download it is: the URL is
+     * chosen by the initiator and the `webContents` is the whole tab.
+     */
+    getInitiatorOrigin(): string;
     /**
      * Last-Modified header value.
      */
@@ -8411,32 +8412,6 @@ declare namespace Electron {
     savePath: string;
   }
 
-  interface EnableHeapProfilingOptions {
-
-    // Docs: https://electronjs.org/docs/api/structures/enable-heap-profiling-options
-
-    /**
-     * Controls which processes are profiled. Equivalent to `--memlog` in Chrome.
-     * Default is `all`.
-     */
-    mode?: ('all' | 'browser' | 'gpu' | 'minimal' | 'renderer-sampling' | 'all-renderers' | 'utility-sampling' | 'all-utilities' | 'utility-and-browser');
-    /**
-     * Controls the sampling interval in bytes. The lower the interval, the more
-     * precise the profile is. However it comes at the cost of performance. Default is
-     * `100000` (100KB). That is enough to observe allocation sites that make
-     * allocations >500KB total, where total equals to a single allocation size times
-     * the number of such allocations at the same call site. Equivalent to
-     * `--memlog-sampling-rate` in Chrome. Must be an integer between `1000` and
-     * `10000000`.
-     */
-    samplingRate?: number;
-    /**
-     * Controls the type of metadata recorded for each allocation. Equivalent to
-     * `--memlog-stack-mode` in Chrome. Default is `native`.
-     */
-    stackMode?: ('native' | 'native-with-thread-names');
-  }
-
   interface Extension {
 
     // Docs: https://electronjs.org/docs/api/structures/extension
@@ -9860,6 +9835,9 @@ declare namespace Electron {
      * This property can be dynamically changed; setting it to `undefined` removes the
      * badge. Only available on macOS 14 and up.
      *
+     * Badges are not displayed in Dock menus, though the same item shows its badge in
+     * an application menu.
+     *
      * @platform darwin
      */
     badge?: MenuItemBadge;
@@ -11614,7 +11592,8 @@ declare namespace Electron {
     // Docs: https://electronjs.org/docs/api/structures/process-metric
 
     /**
-     * CPU usage of the process.
+     * CPU usage of the process. Its `percentCPUUsage` and `idleWakeupsPerSecond` are
+     * averages over the time since the previous call to the API returning this object.
      */
     cpu: CPUUsage;
     /**
@@ -11779,6 +11758,12 @@ declare namespace Electron {
      * Register a protocol handler for `scheme`. Requests made to URLs with this scheme
      * will delegate to this handler to determine what response should be sent.
      *
+     * In addition to the standard `Request` fields, `request.initiatorOrigin` is set
+     * to the origin that issued the request (for example `https://example.com`, or
+     * `null` for an opaque origin) when web content made it; it is absent for requests
+     * the browser started itself. Unlike `request.referrer` it is not controlled by
+     * the requesting page, so prefer it when deciding whether to serve a request.
+     *
      * Either a `Response` or a `Promise<Response>` can be returned.
      *
      * Example:
@@ -11983,6 +11968,12 @@ declare namespace Electron {
     // Docs: https://electronjs.org/docs/api/structures/protocol-request
 
     headers: Record<string, string>;
+    /**
+     * The origin that issued the request (for example `https://example.com`, or `null`
+     * for an opaque origin). Absent for requests the browser started itself. Unlike
+     * `referrer`, this is not controlled by the requesting page.
+     */
+    initiatorOrigin?: string;
     method: string;
     referrer: string;
     uploadData?: UploadData[];
@@ -12228,6 +12219,12 @@ declare namespace Electron {
     /**
      * the decrypted string. Decrypts the encrypted buffer obtained  with
      * `safeStorage.encryptString` back into a string.
+     *
+     * **Deprecated:** Use `safeStorage.decryptStringAsync(encrypted)` instead. Data
+     * encrypted with `safeStorage.encryptString` can be decrypted with
+     * `safeStorage.decryptStringAsync`.
+     *
+     * @deprecated
      */
     decryptString(encrypted: Buffer): string;
     /**
@@ -12244,6 +12241,10 @@ declare namespace Electron {
      * An array of bytes representing the encrypted string.
      *
      * This function will throw an error if encryption fails.
+     *
+     * **Deprecated:** Use `safeStorage.encryptStringAsync(plainText)` instead.
+     *
+     * @deprecated
      */
     encryptString(plainText: string): Buffer;
     /**
@@ -12287,6 +12288,10 @@ declare namespace Electron {
      * On Linux, returns true if the app has emitted the `ready` event and the secret
      * key is available. On MacOS, returns true if Keychain is available. On Windows,
      * returns true once the app has emitted the `ready` event.
+     *
+     * **Deprecated:** Use `safeStorage.isAsyncEncryptionAvailable()` instead.
+     *
+     * @deprecated
      */
     isEncryptionAvailable(): boolean;
     /**
@@ -12851,7 +12856,11 @@ declare namespace Electron {
                                         * True if the renderer is requesting that the connection include credentials (see
                                         * the spec for more details.)
                                         */
-                                       allowCredentials: boolean) => void): this;
+                                       allowCredentials: boolean,
+                                       /**
+                                        * The frame that requested the preconnection, if it still exists.
+                                        */
+                                       frame: (WebFrameMain) | (null)) => void): this;
     off(event: 'preconnect', listener: (event: Event,
                                        /**
                                         * The URL being requested for preconnection by the renderer.
@@ -12861,7 +12870,11 @@ declare namespace Electron {
                                         * True if the renderer is requesting that the connection include credentials (see
                                         * the spec for more details.)
                                         */
-                                       allowCredentials: boolean) => void): this;
+                                       allowCredentials: boolean,
+                                       /**
+                                        * The frame that requested the preconnection, if it still exists.
+                                        */
+                                       frame: (WebFrameMain) | (null)) => void): this;
     once(event: 'preconnect', listener: (event: Event,
                                        /**
                                         * The URL being requested for preconnection by the renderer.
@@ -12871,7 +12884,11 @@ declare namespace Electron {
                                         * True if the renderer is requesting that the connection include credentials (see
                                         * the spec for more details.)
                                         */
-                                       allowCredentials: boolean) => void): this;
+                                       allowCredentials: boolean,
+                                       /**
+                                        * The frame that requested the preconnection, if it still exists.
+                                        */
+                                       frame: (WebFrameMain) | (null)) => void): this;
     addListener(event: 'preconnect', listener: (event: Event,
                                        /**
                                         * The URL being requested for preconnection by the renderer.
@@ -12881,7 +12898,11 @@ declare namespace Electron {
                                         * True if the renderer is requesting that the connection include credentials (see
                                         * the spec for more details.)
                                         */
-                                       allowCredentials: boolean) => void): this;
+                                       allowCredentials: boolean,
+                                       /**
+                                        * The frame that requested the preconnection, if it still exists.
+                                        */
+                                       frame: (WebFrameMain) | (null)) => void): this;
     removeListener(event: 'preconnect', listener: (event: Event,
                                        /**
                                         * The URL being requested for preconnection by the renderer.
@@ -12891,7 +12912,11 @@ declare namespace Electron {
                                         * True if the renderer is requesting that the connection include credentials (see
                                         * the spec for more details.)
                                         */
-                                       allowCredentials: boolean) => void): this;
+                                       allowCredentials: boolean,
+                                       /**
+                                        * The frame that requested the preconnection, if it still exists.
+                                        */
+                                       frame: (WebFrameMain) | (null)) => void): this;
     /**
      * Emitted when a HID device needs to be selected when a call to
      * `navigator.hid.requestDevice` is made. `callback` should be called with
@@ -13273,26 +13298,47 @@ declare namespace Electron {
     removeListener(event: 'usb-device-revoked', listener: (event: Event,
                                                details: UsbDeviceRevokedDetails) => void): this;
     /**
-     * Emitted when Electron is about to download `item` in `webContents`.
+     * Emitted when Electron is about to download `item` in `webContents`. See also
+     * `item.getInitiatorOrigin()`.
      *
      * Calling `event.preventDefault()` will cancel the download and `item` will not be
      * available from next tick of the process.
      */
     on(event: 'will-download', listener: (event: Event,
                                           item: DownloadItem,
-                                          webContents: WebContents) => void): this;
+                                          webContents: WebContents,
+                                          /**
+                                           * The frame that started the download, if it still exists.
+                                           */
+                                          frame: (WebFrameMain) | (null)) => void): this;
     off(event: 'will-download', listener: (event: Event,
                                           item: DownloadItem,
-                                          webContents: WebContents) => void): this;
+                                          webContents: WebContents,
+                                          /**
+                                           * The frame that started the download, if it still exists.
+                                           */
+                                          frame: (WebFrameMain) | (null)) => void): this;
     once(event: 'will-download', listener: (event: Event,
                                           item: DownloadItem,
-                                          webContents: WebContents) => void): this;
+                                          webContents: WebContents,
+                                          /**
+                                           * The frame that started the download, if it still exists.
+                                           */
+                                          frame: (WebFrameMain) | (null)) => void): this;
     addListener(event: 'will-download', listener: (event: Event,
                                           item: DownloadItem,
-                                          webContents: WebContents) => void): this;
+                                          webContents: WebContents,
+                                          /**
+                                           * The frame that started the download, if it still exists.
+                                           */
+                                          frame: (WebFrameMain) | (null)) => void): this;
     removeListener(event: 'will-download', listener: (event: Event,
                                           item: DownloadItem,
-                                          webContents: WebContents) => void): this;
+                                          webContents: WebContents,
+                                          /**
+                                           * The frame that started the download, if it still exists.
+                                           */
+                                          frame: (WebFrameMain) | (null)) => void): this;
     /**
      * Whether the word was successfully written to the custom dictionary. This API
      * will not work on non-persistent (in-memory) sessions.
@@ -13671,8 +13717,12 @@ declare namespace Electron {
      * is available and `useSystemPicker` is set to `true`, the handler will not be
      * invoked.
      *
-     * Passing a WebFrameMain object as a video or audio stream will capture the video
-     * or audio stream from that frame.
+     * Passing a WebFrameMain object as a video or audio stream captures the whole
+     * `webContents` that contains that frame (the tab), not just the frame:
+     * `request.frame` from an `<iframe>` therefore grants that iframe a capture of the
+     * page that embeds it. Check `request.frame` before using it this way, and note
+     * that the callback throws if the frame has been destroyed by the time it is
+     * called.
      *
      * Passing `null` instead of a function resets the handler to its default state.
      */
@@ -18455,7 +18505,9 @@ declare namespace Electron {
      * The identifier of a WebContents stream. This identifier can be used with
      * `navigator.mediaDevices.getUserMedia` using a `chromeMediaSource` of `tab`. The
      * identifier is restricted to the web contents that it is registered to and is
-     * only valid for 10 seconds.
+     * only valid for 10 seconds. The `desktop` source only accepts screen and window
+     * identifiers from `desktopCapturer.getSources`; to capture a WebContents use this
+     * identifier with the `tab` source, or `ses.setDisplayMediaRequestHandler`.
      */
     getMediaSourceId(requestWebContents: WebContents): string;
     /**
@@ -19795,8 +19847,10 @@ declare namespace Electron {
      */
     nodeIntegrationInSubFrames?: boolean;
     /**
-     * Whether node integration is enabled in web workers. Default is `false`. More
-     * about this can be found in Multithreading.
+     * Whether node integration is enabled in web workers. Default is `false`. Only
+     * workers created by a frame that itself has access to Node.js (the main frame, or
+     * any frame when `nodeIntegrationInSubFrames` is enabled) get it. More about this
+     * can be found in Multithreading.
      */
     nodeIntegrationInWorker?: boolean;
     /**
@@ -20366,6 +20420,10 @@ declare namespace Electron {
     removeEventListener(event: 'close', listener: (event: DOMEvent) => void): this;
     /**
      * Fired when the guest page has sent an asynchronous message to embedder page.
+     * `frameId` does not tell the embedder which document sent the message; when that
+     * matters, have the guest use `ipcRenderer.send()` and handle the guest
+     * `webContents`' `ipc-message` event in the main process, where
+     * `event.senderFrame` identifies the sender.
      *
      * With `sendToHost` method and `ipc-message` event you can communicate between
      * guest page and embedder page:
@@ -20748,7 +20806,9 @@ declare namespace Electron {
     unselect(): void;
     /**
      * A `boolean`. When this attribute is present the guest page will be allowed to
-     * open new windows. Popups are disabled by default.
+     * open new windows, whether through `window.open()` or a link opened into a new
+     * window (for example a modifier-clicked or `target="_blank"` link). Popups are
+     * disabled by default.
      */
     allowpopups: boolean;
     /**
@@ -22199,6 +22259,15 @@ declare namespace Electron {
      * The blocked path attempting to be accessed.
      */
     path: string;
+    /**
+     * The frame that initiated access. May be `null` if the frame has since been
+     * destroyed.
+     */
+    frame: (WebFrameMain) | (null);
+    /**
+     * The WebContents that contains `frame`.
+     */
+    webContents: (WebContents) | (null);
   }
 
   interface FindInPageOptions {
@@ -22789,6 +22858,7 @@ declare namespace Electron {
     /**
      * A badge shown alongside the label, either a system-styled count (`alerts`,
      * `updates`, `new-items`) or a custom string. Only available on macOS 14 and up.
+     * Not displayed in Dock menus.
      *
      * @platform darwin
      */
@@ -23184,6 +23254,12 @@ declare namespace Electron {
      * or been destroyed.
      */
     frame?: (WebFrameMain) | (null);
+    /**
+     * The origin that issued the request (for example `https://example.com`, or `null`
+     * for an opaque origin). Kept from the original request across redirects; absent
+     * for requests the browser started itself.
+     */
+    initiatorOrigin?: string;
     /**
      * Can be `mainFrame`, `subFrame`, `stylesheet`, `script`, `image`, `font`,
      * `object`, `xhr`, `ping`, `cspReport`, `media`, `webSocket` or `other`.
@@ -23213,6 +23289,12 @@ declare namespace Electron {
      * or been destroyed.
      */
     frame?: (WebFrameMain) | (null);
+    /**
+     * The origin that issued the request (for example `https://example.com`, or `null`
+     * for an opaque origin). Kept from the original request across redirects; absent
+     * for requests the browser started itself.
+     */
+    initiatorOrigin?: string;
     /**
      * Can be `mainFrame`, `subFrame`, `stylesheet`, `script`, `image`, `font`,
      * `object`, `xhr`, `ping`, `cspReport`, `media`, `webSocket` or `other`.
@@ -23234,6 +23316,12 @@ declare namespace Electron {
      * or been destroyed.
      */
     frame?: (WebFrameMain) | (null);
+    /**
+     * The origin that issued the request (for example `https://example.com`, or `null`
+     * for an opaque origin). Kept from the original request across redirects; absent
+     * for requests the browser started itself.
+     */
+    initiatorOrigin?: string;
     /**
      * Can be `mainFrame`, `subFrame`, `stylesheet`, `script`, `image`, `font`,
      * `object`, `xhr`, `ping`, `cspReport`, `media`, `webSocket` or `other`.
@@ -23256,6 +23344,12 @@ declare namespace Electron {
      * or been destroyed.
      */
     frame?: (WebFrameMain) | (null);
+    /**
+     * The origin that issued the request (for example `https://example.com`, or `null`
+     * for an opaque origin). Kept from the original request across redirects; absent
+     * for requests the browser started itself.
+     */
+    initiatorOrigin?: string;
     /**
      * Can be `mainFrame`, `subFrame`, `stylesheet`, `script`, `image`, `font`,
      * `object`, `xhr`, `ping`, `cspReport`, `media`, `webSocket` or `other`.
@@ -23281,6 +23375,12 @@ declare namespace Electron {
      * or been destroyed.
      */
     frame?: (WebFrameMain) | (null);
+    /**
+     * The origin that issued the request (for example `https://example.com`, or `null`
+     * for an opaque origin). Kept from the original request across redirects; absent
+     * for requests the browser started itself.
+     */
+    initiatorOrigin?: string;
     /**
      * Can be `mainFrame`, `subFrame`, `stylesheet`, `script`, `image`, `font`,
      * `object`, `xhr`, `ping`, `cspReport`, `media`, `webSocket` or `other`.
@@ -23306,6 +23406,12 @@ declare namespace Electron {
      * or been destroyed.
      */
     frame?: (WebFrameMain) | (null);
+    /**
+     * The origin that issued the request (for example `https://example.com`, or `null`
+     * for an opaque origin). Kept from the original request across redirects; absent
+     * for requests the browser started itself.
+     */
+    initiatorOrigin?: string;
     /**
      * Can be `mainFrame`, `subFrame`, `stylesheet`, `script`, `image`, `font`,
      * `object`, `xhr`, `ping`, `cspReport`, `media`, `webSocket` or `other`.
@@ -23329,6 +23435,12 @@ declare namespace Electron {
      * or been destroyed.
      */
     frame?: (WebFrameMain) | (null);
+    /**
+     * The origin that issued the request (for example `https://example.com`, or `null`
+     * for an opaque origin). Kept from the original request across redirects; absent
+     * for requests the browser started itself.
+     */
+    initiatorOrigin?: string;
     /**
      * Can be `mainFrame`, `subFrame`, `stylesheet`, `script`, `image`, `font`,
      * `object`, `xhr`, `ping`, `cspReport`, `media`, `webSocket` or `other`.
@@ -23356,6 +23468,12 @@ declare namespace Electron {
      * or been destroyed.
      */
     frame?: (WebFrameMain) | (null);
+    /**
+     * The origin that issued the request (for example `https://example.com`, or `null`
+     * for an opaque origin). Kept from the original request across redirects; absent
+     * for requests the browser started itself.
+     */
+    initiatorOrigin?: string;
     /**
      * Can be `mainFrame`, `subFrame`, `stylesheet`, `script`, `image`, `font`,
      * `object`, `xhr`, `ping`, `cspReport`, `media`, `webSocket` or `other`.
@@ -23574,7 +23692,8 @@ declare namespace Electron {
      */
     embeddingOrigin?: string;
     /**
-     * The security origin of the `media` check.
+     * The origin of the requesting frame, for `media`, `hid`, `usb` and `serial`
+     * checks.
      */
     securityOrigin?: string;
     /**
@@ -23582,8 +23701,8 @@ declare namespace Electron {
      */
     mediaType?: ('video' | 'audio' | 'unknown');
     /**
-     * The last URL the requesting frame loaded.  This is not provided for cross-origin
-     * sub frames making permission checks.
+     * The last URL the requesting frame loaded. Not provided when the check is not
+     * made on behalf of a document (for example for a service worker).
      */
     requestingUrl?: string;
     /**
@@ -24216,7 +24335,8 @@ declare namespace Electron {
     /**
      * If a string is specified, can be `loopback` or `loopbackWithMute`. Specifying a
      * loopback device will capture system audio, and is currently only supported on
-     * Windows. If a WebFrameMain is specified, will capture audio from that frame.
+     * Windows. If a WebFrameMain is specified, will capture audio from the
+     * `webContents` that contains that frame.
      */
     audio?: (('loopback' | 'loopbackWithMute')) | (WebFrameMain);
     /**
@@ -25750,7 +25870,6 @@ declare namespace Electron {
     type CustomScheme = Electron.CustomScheme;
     type DesktopCapturerSource = Electron.DesktopCapturerSource;
     type Display = Electron.Display;
-    type EnableHeapProfilingOptions = Electron.EnableHeapProfilingOptions;
     type Extension = Electron.Extension;
     type ExtensionInfo = Electron.ExtensionInfo;
     type FileFilter = Electron.FileFilter;
@@ -26175,7 +26294,6 @@ declare namespace Electron {
     type CustomScheme = Electron.CustomScheme;
     type DesktopCapturerSource = Electron.DesktopCapturerSource;
     type Display = Electron.Display;
-    type EnableHeapProfilingOptions = Electron.EnableHeapProfilingOptions;
     type Extension = Electron.Extension;
     type ExtensionInfo = Electron.ExtensionInfo;
     type FileFilter = Electron.FileFilter;
@@ -26524,7 +26642,6 @@ declare namespace Electron {
     type CustomScheme = Electron.CustomScheme;
     type DesktopCapturerSource = Electron.DesktopCapturerSource;
     type Display = Electron.Display;
-    type EnableHeapProfilingOptions = Electron.EnableHeapProfilingOptions;
     type Extension = Electron.Extension;
     type ExtensionInfo = Electron.ExtensionInfo;
     type FileFilter = Electron.FileFilter;
@@ -26875,7 +26992,6 @@ declare namespace Electron {
     type CustomScheme = Electron.CustomScheme;
     type DesktopCapturerSource = Electron.DesktopCapturerSource;
     type Display = Electron.Display;
-    type EnableHeapProfilingOptions = Electron.EnableHeapProfilingOptions;
     type Extension = Electron.Extension;
     type ExtensionInfo = Electron.ExtensionInfo;
     type FileFilter = Electron.FileFilter;
@@ -27322,7 +27438,6 @@ declare namespace Electron {
     type CustomScheme = Electron.CustomScheme;
     type DesktopCapturerSource = Electron.DesktopCapturerSource;
     type Display = Electron.Display;
-    type EnableHeapProfilingOptions = Electron.EnableHeapProfilingOptions;
     type Extension = Electron.Extension;
     type ExtensionInfo = Electron.ExtensionInfo;
     type FileFilter = Electron.FileFilter;
@@ -27539,6 +27654,14 @@ declare namespace NodeJS {
      * Kilobytes.
      */
     getBlinkMemoryInfo(): Electron.BlinkMemoryInfo;
+    /**
+     * CPU usage of the process this is called in.
+     * 
+     * > [!NOTE] `percentCPUUsage` and `idleWakeupsPerSecond` are averages over the
+     * time since the previous call to `process.getCPUUsage()` in this process, and
+     * each call starts a new measurement interval. Every caller in the process shares
+     * that interval. See `CPUUsage` for details.
+     */
     getCPUUsage(): Electron.CPUUsage;
     /**
      * The number of milliseconds since epoch, or `null` if the information is

package/dist/version.json

@@ -1,4 +1,4 @@
 {
-  "electronVersion": "45.0.0-alpha.1",
-  "extractedAt": "2026-08-28T07:39:05.308Z"
+  "electronVersion": "45.0.0-alpha.10",
+  "extractedAt": "2026-09-21T23:11:40.260Z"
 }

package/package.json

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