electron-types 44.0.0-alpha.2 → 44.0.0-alpha.4

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

package/dist/electron.d.ts

@@ -1,4 +1,4 @@
-// Type definitions for Electron 44.0.0-alpha.2
+// Type definitions for Electron 44.0.0-alpha.4
 // Project: http://electronjs.org/
 // Definitions by: The Electron Team <https://github.com/electron/electron>
 // Definitions: https://github.com/electron/typescript-definitions
@@ -1865,7 +1865,7 @@ declare namespace Electron {
      * resources will be leaked and your app will lose its ability to reach outside the
      * sandbox completely, until your app is restarted.
      *
-     * Start accessing a security scoped resource. With this method Electron
+     * Start accessing a security scoped resource. With this method, Electron
      * applications that are packaged for the Mac App Store may reach outside their
      * sandbox to access files chosen by the user. See Apple's documentation for a
      * description of how this system works.
@@ -2297,6 +2297,20 @@ declare namespace Electron {
      * @platform darwin
      */
     removeListener(event: 'new-window-for-tab', listener: () => void): this;
+    /**
+     * Emitted after the persisted window state has been restored.
+     *
+     * Window state includes the window bounds (x, y, height, width) and display mode
+     * (maximized, fullscreen, kiosk).
+     *
+     * > [!NOTE] This event is only emitted when windowStatePersistence is enabled in
+     * BaseWindowConstructorOptions or in BrowserWindowConstructorOptions.
+     */
+    on(event: 'persisted-state-restored', listener: () => void): this;
+    off(event: 'persisted-state-restored', listener: () => void): this;
+    once(event: 'persisted-state-restored', listener: () => void): this;
+    addListener(event: 'persisted-state-restored', listener: () => void): this;
+    removeListener(event: 'persisted-state-restored', listener: () => void): this;
     /**
      * Emitted when a session is about to end due to a shutdown, machine restart, or
      * user log-off. Calling `event.preventDefault()` can delay the system shutdown,
@@ -2674,6 +2688,15 @@ declare namespace Electron {
      * BaseWindow
      */
     constructor(options?: BaseWindowConstructorOptions);
+    /**
+     * Clears the saved state for a window with the given name. This removes all
+     * persisted window bounds, display mode, and work area information that was
+     * previously saved when `windowStatePersistence` was enabled.
+     *
+     * If the window `name` is empty or the window state doesn't exist, the method will
+     * log a warning.
+     */
+    static clearPersistedState(name: string): void;
     /**
      * The window with the given `id`.
      */
@@ -3908,6 +3931,14 @@ declare namespace Electron {
      * @platform darwin,win32
      */
     movable?: boolean;
+    /**
+     * A unique identifier for the window, used internally by Electron to enable
+     * features such as state persistence. Each window must have a distinct name. It
+     * can only be reused after the corresponding window has been destroyed. An error
+     * is thrown if the name is already in use. This is not the visible title shown to
+     * users on the title bar.
+     */
+    name?: string;
     /**
      * Set the initial opacity of the window, between 0.0 (fully transparent) and 1.0
      * (fully opaque). This is only implemented on Windows and macOS.
@@ -4025,6 +4056,13 @@ declare namespace Electron {
      * Window's width in pixels. Default is `800`.
      */
     width?: number;
+    /**
+     * Configures or enables the persistence of window state (position, size, maximized
+     * state, etc.) across application restarts. Has no effect if window `name` is not
+     * provided. Automatically disabled when there is no available display.
+     * _Experimental_
+     */
+    windowStatePersistence?: (WindowStatePersistence) | (boolean);
     /**
      * (**required** if y is used) Window's left offset from screen. Default is to
      * center the window.
@@ -4561,6 +4599,20 @@ declare namespace Electron {
     removeListener(event: 'page-title-updated', listener: (event: Event,
                                                title: string,
                                                explicitSet: boolean) => void): this;
+    /**
+     * Emitted after the persisted window state has been restored.
+     *
+     * Window state includes the window bounds (x, y, height, width) and display mode
+     * (maximized, fullscreen, kiosk).
+     *
+     * > [!NOTE] This event is only emitted when windowStatePersistence is enabled in
+     * BaseWindowConstructorOptions or in BrowserWindowConstructorOptions.
+     */
+    on(event: 'persisted-state-restored', listener: () => void): this;
+    off(event: 'persisted-state-restored', listener: () => void): this;
+    once(event: 'persisted-state-restored', listener: () => void): this;
+    addListener(event: 'persisted-state-restored', listener: () => void): this;
+    removeListener(event: 'persisted-state-restored', listener: () => void): this;
     /**
      * Emitted when a session is about to end due to a shutdown, machine restart, or
      * user log-off. Calling `event.preventDefault()` can delay the system shutdown,
@@ -20327,6 +20379,22 @@ declare namespace Electron {
     reasons: Array<'shutdown' | 'close-app' | 'critical' | 'logoff'>;
   }
 
+  interface WindowStatePersistence {
+
+    // Docs: https://electronjs.org/docs/api/structures/window-state-persistence
+
+    /**
+     * Whether to persist window position and size across application restarts.
+     * Defaults to `true` if not specified.
+     */
+    bounds?: boolean;
+    /**
+     * Whether to persist display modes (fullscreen, kiosk, maximized, etc.) across
+     * application restarts. Defaults to `true` if not specified.
+     */
+    displayMode?: boolean;
+  }
+
   interface AboutPanelOptionsOptions {
     /**
      * The app's name.
@@ -25292,6 +25360,7 @@ declare namespace Electron {
     type WebSource = Electron.WebSource;
     type WindowOpenHandlerResponse = Electron.WindowOpenHandlerResponse;
     type WindowSessionEndEvent = Electron.WindowSessionEndEvent;
+    type WindowStatePersistence = Electron.WindowStatePersistence;
   }
 
   namespace Main {
@@ -25701,6 +25770,7 @@ declare namespace Electron {
     type WebSource = Electron.WebSource;
     type WindowOpenHandlerResponse = Electron.WindowOpenHandlerResponse;
     type WindowSessionEndEvent = Electron.WindowSessionEndEvent;
+    type WindowStatePersistence = Electron.WindowStatePersistence;
   }
 
   namespace Renderer {
@@ -26037,6 +26107,7 @@ declare namespace Electron {
     type WebSource = Electron.WebSource;
     type WindowOpenHandlerResponse = Electron.WindowOpenHandlerResponse;
     type WindowSessionEndEvent = Electron.WindowSessionEndEvent;
+    type WindowStatePersistence = Electron.WindowStatePersistence;
   }
 
   namespace Utility {
@@ -26372,6 +26443,7 @@ declare namespace Electron {
     type WebSource = Electron.WebSource;
     type WindowOpenHandlerResponse = Electron.WindowOpenHandlerResponse;
     type WindowSessionEndEvent = Electron.WindowSessionEndEvent;
+    type WindowStatePersistence = Electron.WindowStatePersistence;
   }
 
   namespace CrossProcessExports {
@@ -26802,6 +26874,7 @@ declare namespace Electron {
     type WebSource = Electron.WebSource;
     type WindowOpenHandlerResponse = Electron.WindowOpenHandlerResponse;
     type WindowSessionEndEvent = Electron.WindowSessionEndEvent;
+    type WindowStatePersistence = Electron.WindowStatePersistence;
   }
 
   const app: App;

package/dist/version.json

@@ -1,4 +1,4 @@
 {
-  "electronVersion": "44.0.0-alpha.2",
-  "extractedAt": "2026-07-08T18:37:23.555Z"
+  "electronVersion": "44.0.0-alpha.4",
+  "extractedAt": "2026-07-17T08:22:13.899Z"
 }

package/package.json

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