electron 13.2.2 → 13.5.0

package/electron.d.ts

@@ -1,4 +1,4 @@
-// Type definitions for Electron 13.2.2
+// Type definitions for Electron 13.5.0
 // Project: http://electronjs.org/
 // Definitions by: The Electron Team <https://github.com/electron/electron>
 // Definitions: https://github.com/electron/electron-typescript-definitions
@@ -2554,8 +2554,8 @@ On Linux always returns `true`.
      * and height are within the content view--only that they exist. Sum any extra
      * width and height areas you have within the overall content view.
      *
-     * The aspect ratio is not respected when window is resized programmingly with APIs
-     * like `win.setSize`.
+     * The aspect ratio is not respected when window is resized programmatically with
+     * APIs like `win.setSize`.
      */
     setAspectRatio(aspectRatio: number, extraSize?: Size): void;
     /**
@@ -5889,6 +5889,26 @@ Starts recording network events to `path`.
     userText?: string;
   }
 
+  interface OverlayOptions {
+
+    // Docs: https://electronjs.org/docs/api/structures/overlay-options
+
+    /**
+     * The CSS color of the Window Controls Overlay when enabled. Default is the system
+     * color.
+     *
+     * @platform win32
+     */
+    color?: string;
+    /**
+     * The CSS color of the symbols on the Window Controls Overlay when enabled.
+     * Default is the system color.
+     *
+     * @platform win32
+     */
+    symbolColor?: string;
+  }
+
   interface Point {
 
     // Docs: https://electronjs.org/docs/api/structures/point
@@ -8816,6 +8836,14 @@ This value is set to false by default.
 
     // Docs: https://electronjs.org/docs/api/web-contents
 
+    /**
+     * | undefined - A WebContents instance with the given TargetID, or `undefined` if
+     * there is no WebContents associated with the given TargetID.
+     *
+     * When communicating with the Chrome DevTools Protocol, it can be useful to lookup
+     * a WebContents instance based on its assigned TargetID.
+     */
+    static fromDevToolsTargetId(targetId: string): WebContents;
     /**
      * | undefined - A WebContents instance with the given ID, or `undefined` if there
      * is no WebContents associated with the given ID.
@@ -11646,8 +11674,9 @@ See webContents.sendInputEvent for detailed description of `event` object.
     plugins: boolean;
     /**
      * A `String` that specifies a script that will be loaded before other scripts run
-     * in the guest page. The protocol of script's URL must be either `file:` or
-     * `asar:`, because it will be loaded by `require` in guest page under the hood.
+     * in the guest page. The protocol of script's URL must be `file:` (even when using
+     * `asar:` archives) because it will be loaded by Node's `require` under the hood,
+     * which treats `asar:` archives as virtual directories.
      *
      * When the guest page doesn't have node integration this script will still have
      * access to all Node APIs, but global objects injected by Node will be deleted
@@ -12077,6 +12106,8 @@ See webContents.sendInputEvent for detailed description of `event` object.
     visualEffectState?: ('followWindow' | 'active' | 'inactive');
     /**
      * The style of window title bar. Default is `default`. Possible values are:
+     *
+     * @platform darwin,win32
      */
     titleBarStyle?: ('default' | 'hidden' | 'hiddenInset' | 'customButtonsOnHover');
     /**
@@ -12129,6 +12160,16 @@ See webContents.sendInputEvent for detailed description of `event` object.
      * Settings of web page's features.
      */
     webPreferences?: WebPreferences;
+    /**
+     * When using a frameless window in conjuction with
+     * `win.setWindowButtonVisibility(true)` on macOS or using a `titleBarStyle` so
+     * that the standard window controls ("traffic lights" on macOS) are visible, this
+     * property enables the Window Controls Overlay JavaScript APIs and CSS Environment
+     * Variables. Specifying `true` will result in an overlay with default system
+     * colors. Default is `false`.  On Windows, the OverlayOptions can be used instead
+     * of a boolean to specify colors for the overlay.
+     */
+    titleBarOverlay?: (OverlayOptions) | (boolean);
   }
 
   interface CertificateTrustDialogOptions {
@@ -14399,7 +14440,8 @@ See webContents.sendInputEvent for detailed description of `event` object.
      */
     overlayStyle?: ('background' | 'outline' | 'none');
     /**
-     * Defaults to `false`.
+     * Whether to show arrow buttons. Defaults to `false` and is only shown if `items`
+     * is non-empty.
      */
     showArrowButtons?: boolean;
     /**
@@ -15343,6 +15385,7 @@ See webContents.sendInputEvent for detailed description of `event` object.
     type NewWindowWebContentsEvent = Electron.NewWindowWebContentsEvent;
     type NotificationAction = Electron.NotificationAction;
     type NotificationResponse = Electron.NotificationResponse;
+    type OverlayOptions = Electron.OverlayOptions;
     type Point = Electron.Point;
     type PostBody = Electron.PostBody;
     type PrinterInfo = Electron.PrinterInfo;
@@ -15602,6 +15645,7 @@ See webContents.sendInputEvent for detailed description of `event` object.
     type NewWindowWebContentsEvent = Electron.NewWindowWebContentsEvent;
     type NotificationAction = Electron.NotificationAction;
     type NotificationResponse = Electron.NotificationResponse;
+    type OverlayOptions = Electron.OverlayOptions;
     type Point = Electron.Point;
     type PostBody = Electron.PostBody;
     type PrinterInfo = Electron.PrinterInfo;
@@ -15814,6 +15858,7 @@ See webContents.sendInputEvent for detailed description of `event` object.
     type NewWindowWebContentsEvent = Electron.NewWindowWebContentsEvent;
     type NotificationAction = Electron.NotificationAction;
     type NotificationResponse = Electron.NotificationResponse;
+    type OverlayOptions = Electron.OverlayOptions;
     type Point = Electron.Point;
     type PostBody = Electron.PostBody;
     type PrinterInfo = Electron.PrinterInfo;

package/package.json

@@ -16,7 +16,7 @@
     "node": ">= 8.6"
   },
   "name": "electron",
-  "version": "13.2.2",
+  "version": "13.5.0",
   "repository": "https://github.com/electron/electron",
   "description": "Build cross platform desktop apps with JavaScript, HTML, and CSS",
   "license": "MIT",