@itwin/core-electron 3.6.0-dev.8 → 3.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (50) hide show
  1. package/CHANGELOG.md +36 -1
  2. package/LICENSE.md +1 -1
  3. package/lib/cjs/ElectronBackend.d.ts +1 -1
  4. package/lib/cjs/ElectronBackend.js +17 -17
  5. package/lib/cjs/ElectronBackend.js.map +1 -1
  6. package/lib/cjs/ElectronFrontend.d.ts +1 -1
  7. package/lib/cjs/ElectronFrontend.js +17 -17
  8. package/lib/cjs/ElectronFrontend.js.map +1 -1
  9. package/lib/cjs/__DOC_ONLY__.d.ts +3 -3
  10. package/lib/cjs/__DOC_ONLY__.js +22 -22
  11. package/lib/cjs/__DOC_ONLY__.js.map +1 -1
  12. package/lib/cjs/backend/ElectronHost.d.ts +104 -91
  13. package/lib/cjs/backend/ElectronHost.d.ts.map +1 -1
  14. package/lib/cjs/backend/ElectronHost.js +243 -221
  15. package/lib/cjs/backend/ElectronHost.js.map +1 -1
  16. package/lib/cjs/backend/ElectronPreload.d.ts +1 -1
  17. package/lib/cjs/backend/ElectronPreload.js +39 -39
  18. package/lib/cjs/backend/ElectronPreload.js.map +1 -1
  19. package/lib/cjs/common/ElectronIpcInterface.d.ts +7 -7
  20. package/lib/cjs/common/ElectronIpcInterface.js +5 -5
  21. package/lib/cjs/common/ElectronIpcInterface.js.map +1 -1
  22. package/lib/cjs/common/ElectronIpcTransport.d.ts +44 -44
  23. package/lib/cjs/common/ElectronIpcTransport.js +186 -186
  24. package/lib/cjs/common/ElectronIpcTransport.js.map +1 -1
  25. package/lib/cjs/common/ElectronManagerLoggerCategory.d.ts +10 -10
  26. package/lib/cjs/common/ElectronManagerLoggerCategory.js +18 -18
  27. package/lib/cjs/common/ElectronManagerLoggerCategory.js.map +1 -1
  28. package/lib/cjs/common/ElectronPush.d.ts +20 -20
  29. package/lib/cjs/common/ElectronPush.d.ts.map +1 -1
  30. package/lib/cjs/common/ElectronPush.js +48 -47
  31. package/lib/cjs/common/ElectronPush.js.map +1 -1
  32. package/lib/cjs/common/ElectronRpcManager.d.ts +26 -26
  33. package/lib/cjs/common/ElectronRpcManager.d.ts.map +1 -1
  34. package/lib/cjs/common/ElectronRpcManager.js +65 -64
  35. package/lib/cjs/common/ElectronRpcManager.js.map +1 -1
  36. package/lib/cjs/common/ElectronRpcProtocol.d.ts +34 -34
  37. package/lib/cjs/common/ElectronRpcProtocol.d.ts.map +1 -1
  38. package/lib/cjs/common/ElectronRpcProtocol.js +58 -57
  39. package/lib/cjs/common/ElectronRpcProtocol.js.map +1 -1
  40. package/lib/cjs/common/ElectronRpcRequest.d.ts +19 -19
  41. package/lib/cjs/common/ElectronRpcRequest.d.ts.map +1 -1
  42. package/lib/cjs/common/ElectronRpcRequest.js +56 -55
  43. package/lib/cjs/common/ElectronRpcRequest.js.map +1 -1
  44. package/lib/cjs/common/ITwinElectronApi.d.ts +10 -10
  45. package/lib/cjs/common/ITwinElectronApi.js +6 -6
  46. package/lib/cjs/common/ITwinElectronApi.js.map +1 -1
  47. package/lib/cjs/frontend/ElectronApp.d.ts +35 -35
  48. package/lib/cjs/frontend/ElectronApp.js +75 -75
  49. package/lib/cjs/frontend/ElectronApp.js.map +1 -1
  50. package/package.json +14 -14
package/CHANGELOG.md CHANGED
@@ -1,6 +1,41 @@
1
1
  # Change Log - @itwin/core-electron
2
2
 
3
- This log was last generated on Wed, 07 Dec 2022 19:12:36 GMT and should not be manually modified.
3
+ This log was last generated on Wed, 08 Feb 2023 14:58:39 GMT and should not be manually modified.
4
+
5
+ ## 3.6.0
6
+ Wed, 08 Feb 2023 14:58:39 GMT
7
+
8
+ ### Updates
9
+
10
+ - Added ElectronHost.getWindowSizeAndPositionSetting to replace now deprecated ElectronHost.getWindowSizeSetting
11
+ - Add support for Electron 22.
12
+ - Use EmptyLocalization for localization in tests to increase test performance
13
+ - React to RPC deprecations.
14
+
15
+ ## 3.5.5
16
+ Thu, 26 Jan 2023 22:53:27 GMT
17
+
18
+ _Version update only_
19
+
20
+ ## 3.5.4
21
+ Wed, 18 Jan 2023 15:27:15 GMT
22
+
23
+ _Version update only_
24
+
25
+ ## 3.5.3
26
+ Fri, 13 Jan 2023 17:23:07 GMT
27
+
28
+ _Version update only_
29
+
30
+ ## 3.5.2
31
+ Wed, 11 Jan 2023 16:46:30 GMT
32
+
33
+ _Version update only_
34
+
35
+ ## 3.5.1
36
+ Thu, 15 Dec 2022 16:38:28 GMT
37
+
38
+ _Version update only_
4
39
 
5
40
  ## 3.5.0
6
41
  Wed, 07 Dec 2022 19:12:36 GMT
package/LICENSE.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # MIT License
2
2
 
3
- Copyright © 2017-2022 Bentley Systems, Incorporated. All rights reserved.
3
+ Copyright © 2017-2023 Bentley Systems, Incorporated. All rights reserved.
4
4
 
5
5
  Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
6
6
 
@@ -1,2 +1,2 @@
1
- export * from "./backend/ElectronHost";
1
+ export * from "./backend/ElectronHost";
2
2
  //# sourceMappingURL=ElectronBackend.d.ts.map
@@ -1,18 +1,18 @@
1
- "use strict";
2
- /*---------------------------------------------------------------------------------------------
3
- * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
4
- * See LICENSE.md in the project root for license terms and full copyright notice.
5
- *--------------------------------------------------------------------------------------------*/
6
- var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
7
- if (k2 === undefined) k2 = k;
8
- Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
9
- }) : (function(o, m, k, k2) {
10
- if (k2 === undefined) k2 = k;
11
- o[k2] = m[k];
12
- }));
13
- var __exportStar = (this && this.__exportStar) || function(m, exports) {
14
- for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
15
- };
16
- Object.defineProperty(exports, "__esModule", { value: true });
17
- __exportStar(require("./backend/ElectronHost"), exports);
1
+ "use strict";
2
+ /*---------------------------------------------------------------------------------------------
3
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
4
+ * See LICENSE.md in the project root for license terms and full copyright notice.
5
+ *--------------------------------------------------------------------------------------------*/
6
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
7
+ if (k2 === undefined) k2 = k;
8
+ Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __exportStar = (this && this.__exportStar) || function(m, exports) {
14
+ for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
15
+ };
16
+ Object.defineProperty(exports, "__esModule", { value: true });
17
+ __exportStar(require("./backend/ElectronHost"), exports);
18
18
  //# sourceMappingURL=ElectronBackend.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"ElectronBackend.js","sourceRoot":"","sources":["../../src/ElectronBackend.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;;;;;;;;;;;;AAE/F,yDAAuC","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n\r\nexport * from \"./backend/ElectronHost\";\r\n"]}
1
+ {"version":3,"file":"ElectronBackend.js","sourceRoot":"","sources":["../../src/ElectronBackend.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;;;;;;;;;;;;AAE/F,yDAAuC","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n\nexport * from \"./backend/ElectronHost\";\n"]}
@@ -1,2 +1,2 @@
1
- export * from "./frontend/ElectronApp";
1
+ export * from "./frontend/ElectronApp";
2
2
  //# sourceMappingURL=ElectronFrontend.d.ts.map
@@ -1,18 +1,18 @@
1
- "use strict";
2
- /*---------------------------------------------------------------------------------------------
3
- * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
4
- * See LICENSE.md in the project root for license terms and full copyright notice.
5
- *--------------------------------------------------------------------------------------------*/
6
- var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
7
- if (k2 === undefined) k2 = k;
8
- Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
9
- }) : (function(o, m, k, k2) {
10
- if (k2 === undefined) k2 = k;
11
- o[k2] = m[k];
12
- }));
13
- var __exportStar = (this && this.__exportStar) || function(m, exports) {
14
- for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
15
- };
16
- Object.defineProperty(exports, "__esModule", { value: true });
17
- __exportStar(require("./frontend/ElectronApp"), exports);
1
+ "use strict";
2
+ /*---------------------------------------------------------------------------------------------
3
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
4
+ * See LICENSE.md in the project root for license terms and full copyright notice.
5
+ *--------------------------------------------------------------------------------------------*/
6
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
7
+ if (k2 === undefined) k2 = k;
8
+ Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __exportStar = (this && this.__exportStar) || function(m, exports) {
14
+ for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
15
+ };
16
+ Object.defineProperty(exports, "__esModule", { value: true });
17
+ __exportStar(require("./frontend/ElectronApp"), exports);
18
18
  //# sourceMappingURL=ElectronFrontend.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"ElectronFrontend.js","sourceRoot":"","sources":["../../src/ElectronFrontend.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;;;;;;;;;;;;AAE/F,yDAAuC","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n\r\nexport * from \"./frontend/ElectronApp\";\r\n"]}
1
+ {"version":3,"file":"ElectronFrontend.js","sourceRoot":"","sources":["../../src/ElectronFrontend.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;;;;;;;;;;;;AAE/F,yDAAuC","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n\nexport * from \"./frontend/ElectronApp\";\n"]}
@@ -1,4 +1,4 @@
1
- export * from "./backend/ElectronHost";
2
- export * from "./common/ElectronIpcInterface";
3
- export * from "./frontend/ElectronApp";
1
+ export * from "./backend/ElectronHost";
2
+ export * from "./common/ElectronIpcInterface";
3
+ export * from "./frontend/ElectronApp";
4
4
  //# sourceMappingURL=__DOC_ONLY__.d.ts.map
@@ -1,23 +1,23 @@
1
- "use strict";
2
- /*---------------------------------------------------------------------------------------------
3
- * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
4
- * See LICENSE.md in the project root for license terms and full copyright notice.
5
- *--------------------------------------------------------------------------------------------*/
6
- var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
7
- if (k2 === undefined) k2 = k;
8
- Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
9
- }) : (function(o, m, k, k2) {
10
- if (k2 === undefined) k2 = k;
11
- o[k2] = m[k];
12
- }));
13
- var __exportStar = (this && this.__exportStar) || function(m, exports) {
14
- for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
15
- };
16
- Object.defineProperty(exports, "__esModule", { value: true });
17
- // THIS FILE EXISTS ONLY FOR DOCUMENTATION GENERATION.
18
- // It imports both frontend and backend code, which is not legal anywhere.
19
- // Do not import it in real code!
20
- __exportStar(require("./backend/ElectronHost"), exports);
21
- __exportStar(require("./common/ElectronIpcInterface"), exports);
22
- __exportStar(require("./frontend/ElectronApp"), exports);
1
+ "use strict";
2
+ /*---------------------------------------------------------------------------------------------
3
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
4
+ * See LICENSE.md in the project root for license terms and full copyright notice.
5
+ *--------------------------------------------------------------------------------------------*/
6
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
7
+ if (k2 === undefined) k2 = k;
8
+ Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __exportStar = (this && this.__exportStar) || function(m, exports) {
14
+ for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
15
+ };
16
+ Object.defineProperty(exports, "__esModule", { value: true });
17
+ // THIS FILE EXISTS ONLY FOR DOCUMENTATION GENERATION.
18
+ // It imports both frontend and backend code, which is not legal anywhere.
19
+ // Do not import it in real code!
20
+ __exportStar(require("./backend/ElectronHost"), exports);
21
+ __exportStar(require("./common/ElectronIpcInterface"), exports);
22
+ __exportStar(require("./frontend/ElectronApp"), exports);
23
23
  //# sourceMappingURL=__DOC_ONLY__.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"__DOC_ONLY__.js","sourceRoot":"","sources":["../../src/__DOC_ONLY__.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;;;;;;;;;;;;AAE/F,sDAAsD;AACtD,0EAA0E;AAC1E,iCAAiC;AAEjC,yDAAuC;AACvC,gEAA8C;AAC9C,yDAAuC","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n\r\n// THIS FILE EXISTS ONLY FOR DOCUMENTATION GENERATION.\r\n// It imports both frontend and backend code, which is not legal anywhere.\r\n// Do not import it in real code!\r\n\r\nexport * from \"./backend/ElectronHost\";\r\nexport * from \"./common/ElectronIpcInterface\";\r\nexport * from \"./frontend/ElectronApp\";\r\n"]}
1
+ {"version":3,"file":"__DOC_ONLY__.js","sourceRoot":"","sources":["../../src/__DOC_ONLY__.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;;;;;;;;;;;;AAE/F,sDAAsD;AACtD,0EAA0E;AAC1E,iCAAiC;AAEjC,yDAAuC;AACvC,gEAA8C;AAC9C,yDAAuC","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n\n// THIS FILE EXISTS ONLY FOR DOCUMENTATION GENERATION.\n// It imports both frontend and backend code, which is not legal anywhere.\n// Do not import it in real code!\n\nexport * from \"./backend/ElectronHost\";\nexport * from \"./common/ElectronIpcInterface\";\nexport * from \"./frontend/ElectronApp\";\n"]}
@@ -1,92 +1,105 @@
1
- import type { BrowserWindow, BrowserWindowConstructorOptions } from "electron";
2
- import type * as ElectronModule from "electron";
3
- import { IpcHandler, NativeHostOpts } from "@itwin/core-backend";
4
- import { RpcConfiguration, RpcInterfaceDefinition } from "@itwin/core-common";
5
- /**
6
- * Options for [[ElectronHost.startup]]
7
- * @beta
8
- */
9
- export interface ElectronHostOptions {
10
- /** the path to find web resources */
11
- webResourcesPath?: string;
12
- /** filename for the app's icon, relative to [[webResourcesPath]] */
13
- iconName?: string;
14
- /** name of frontend url to open. */
15
- frontendURL?: string;
16
- /** use a development server rather than the "electron" protocol for loading frontend (see https://www.electronjs.org/docs/api/protocol) */
17
- developmentServer?: boolean;
18
- /** port number for development server. Default is 3000 */
19
- frontendPort?: number;
20
- /** list of RPC interface definitions to register */
21
- rpcInterfaces?: RpcInterfaceDefinition[];
22
- /** list of [IpcHandler]($common) classes to register */
23
- ipcHandlers?: (typeof IpcHandler)[];
24
- }
25
- /** @beta */
26
- export interface ElectronHostOpts extends NativeHostOpts {
27
- electronHost?: ElectronHostOptions;
28
- }
29
- /** @beta */
30
- export interface ElectronHostWindowOptions extends BrowserWindowConstructorOptions {
31
- storeWindowName?: string;
32
- /** The style of window title bar. Default is `default`. */
33
- titleBarStyle?: ("default" | "hidden" | "hiddenInset" | "customButtonsOnHover");
34
- }
35
- /** the size and position of a window as stored in the settings file.
36
- * @beta
37
- */
38
- export interface WindowSizeAndPositionProps {
39
- width: number;
40
- height: number;
41
- x: number;
42
- y: number;
43
- }
44
- /**
45
- * The backend for Electron-based desktop applications
46
- * @beta
47
- */
48
- export declare class ElectronHost {
49
- private static _ipc;
50
- private static _developmentServer;
51
- private static _electron;
52
- private static _electronFrontend;
53
- private static _mainWindow?;
54
- static webResourcesPath: string;
55
- static appIconPath: string;
56
- static frontendURL: string;
57
- static rpcConfig: RpcConfiguration;
58
- static get ipcMain(): Electron.IpcMain;
59
- static get app(): Electron.App;
60
- static get electron(): typeof ElectronModule;
61
- private constructor();
62
- /**
63
- * Converts an "electron://frontend/" URL to an absolute file path.
64
- *
65
- * We use this protocol in production builds because our frontend must be built with absolute URLs,
66
- * however, since we're loading everything directly from the install directory, we cannot know the
67
- * absolute path at build time.
68
- */
69
- private static parseElectronUrl;
70
- private static _openWindow;
71
- /** The "main" BrowserWindow for this application. */
72
- static get mainWindow(): BrowserWindow | undefined;
73
- /** Gets window size and position for a window, by name, from settings file, if present */
74
- static getWindowSizeSetting(windowName: string): WindowSizeAndPositionProps | undefined;
75
- /** Gets "window maximized" flag for a window, by name, from settings file if present */
76
- static getWindowMaximizedSetting(windowName: string): boolean | undefined;
77
- /**
78
- * Open the main Window when the app is ready.
79
- * @param windowOptions Options for constructing the main BrowserWindow. See: https://electronjs.org/docs/api/browser-window#new-browserwindowoptions
80
- */
81
- static openMainWindow(windowOptions?: ElectronHostWindowOptions): Promise<void>;
82
- static get isValid(): boolean;
83
- /**
84
- * Initialize the backend of an Electron app.
85
- * This method configures the backend for all of the inter-process communication (RPC and IPC) for an
86
- * Electron app. It should be called from your Electron main function.
87
- * @param opts Options that control aspects of your backend.
88
- * @note This method must only be called from the backend of an Electron app (i.e. when [ProcessDetector.isElectronAppBackend]($bentley) is `true`).
89
- */
90
- static startup(opts?: ElectronHostOpts): Promise<void>;
91
- }
1
+ import type { BrowserWindow, BrowserWindowConstructorOptions } from "electron";
2
+ import type * as ElectronModule from "electron";
3
+ import { IpcHandler, NativeHostOpts } from "@itwin/core-backend";
4
+ import { RpcConfiguration, RpcInterfaceDefinition } from "@itwin/core-common";
5
+ /**
6
+ * Options for [[ElectronHost.startup]]
7
+ * @beta
8
+ */
9
+ export interface ElectronHostOptions {
10
+ /** the path to find web resources */
11
+ webResourcesPath?: string;
12
+ /** filename for the app's icon, relative to [[webResourcesPath]] */
13
+ iconName?: string;
14
+ /** name of frontend url to open. */
15
+ frontendURL?: string;
16
+ /** use a development server rather than the "electron" protocol for loading frontend (see https://www.electronjs.org/docs/api/protocol) */
17
+ developmentServer?: boolean;
18
+ /** port number for development server. Default is 3000 */
19
+ frontendPort?: number;
20
+ /** list of RPC interface definitions to register */
21
+ rpcInterfaces?: RpcInterfaceDefinition[];
22
+ /** list of [IpcHandler]($common) classes to register */
23
+ ipcHandlers?: (typeof IpcHandler)[];
24
+ }
25
+ /** @beta */
26
+ export interface ElectronHostOpts extends NativeHostOpts {
27
+ electronHost?: ElectronHostOptions;
28
+ }
29
+ /** @beta */
30
+ export interface ElectronHostWindowOptions extends BrowserWindowConstructorOptions {
31
+ storeWindowName?: string;
32
+ /** The style of window title bar. Default is `default`. */
33
+ titleBarStyle?: ("default" | "hidden" | "hiddenInset" | "customButtonsOnHover");
34
+ }
35
+ /** the size and position of a window as stored in the settings file.
36
+ * @beta
37
+ */
38
+ export interface WindowSizeAndPositionProps {
39
+ width: number;
40
+ height: number;
41
+ x: number;
42
+ y: number;
43
+ }
44
+ /**
45
+ * The backend for Electron-based desktop applications
46
+ * @beta
47
+ */
48
+ export declare class ElectronHost {
49
+ private static readonly _deprecatedSizeAndPosStoreKey;
50
+ private static readonly _sizeAndPosStoreKey;
51
+ private static _ipc;
52
+ private static _developmentServer;
53
+ private static _electron;
54
+ private static _electronFrontend;
55
+ private static _mainWindow?;
56
+ static webResourcesPath: string;
57
+ static appIconPath: string;
58
+ static frontendURL: string;
59
+ static rpcConfig: RpcConfiguration;
60
+ static get ipcMain(): Electron.IpcMain;
61
+ static get app(): Electron.App;
62
+ static get electron(): typeof ElectronModule;
63
+ private constructor();
64
+ /**
65
+ * Converts an "electron://frontend/" URL to an absolute file path.
66
+ *
67
+ * We use this protocol in production builds because our frontend must be built with absolute URLs,
68
+ * however, since we're loading everything directly from the install directory, we cannot know the
69
+ * absolute path at build time.
70
+ */
71
+ private static parseElectronUrl;
72
+ private static _openWindow;
73
+ /** The "main" BrowserWindow for this application. */
74
+ static get mainWindow(): BrowserWindow | undefined;
75
+ /**
76
+ * Gets window size and position for a window, by name, from settings file, if present.
77
+ * @note Size and position values in the settings file will be updated differently depending on platform.
78
+ * On Linux values are only updated on window "unmaximize".
79
+ * On Windows and MacOS values are also updated on window manual resize or move.
80
+ * To get consistent behavior across different platforms, use [[ElectronHost.getWindowSizeAndPositionSetting]].
81
+ * @deprecated in 3.6. Use [[ElectronHost.getWindowSizeAndPositionSetting]].
82
+ */
83
+ static getWindowSizeSetting(windowName: string): WindowSizeAndPositionProps | undefined;
84
+ /**
85
+ * Gets window size and position for a window, by name, from settings file, if present.
86
+ */
87
+ static getWindowSizeAndPositionSetting(windowName: string): WindowSizeAndPositionProps | undefined;
88
+ /** Gets "window maximized" flag for a window, by name, from settings file if present */
89
+ static getWindowMaximizedSetting(windowName: string): boolean | undefined;
90
+ /**
91
+ * Open the main Window when the app is ready.
92
+ * @param windowOptions Options for constructing the main BrowserWindow. See: https://electronjs.org/docs/api/browser-window#new-browserwindowoptions
93
+ */
94
+ static openMainWindow(windowOptions?: ElectronHostWindowOptions): Promise<void>;
95
+ static get isValid(): boolean;
96
+ /**
97
+ * Initialize the backend of an Electron app.
98
+ * This method configures the backend for all of the inter-process communication (RPC and IPC) for an
99
+ * Electron app. It should be called from your Electron main function.
100
+ * @param opts Options that control aspects of your backend.
101
+ * @note This method must only be called from the backend of an Electron app (i.e. when [ProcessDetector.isElectronAppBackend]($bentley) is `true`).
102
+ */
103
+ static startup(opts?: ElectronHostOpts): Promise<void>;
104
+ }
92
105
  //# sourceMappingURL=ElectronHost.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"ElectronHost.d.ts","sourceRoot":"","sources":["../../../src/backend/ElectronHost.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,+BAA+B,EAAkB,MAAM,UAAU,CAAC;AAC/F,OAAO,KAAK,KAAK,cAAc,MAAM,UAAU,CAAC;AAKhD,OAAO,EAAE,UAAU,EAAuB,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACtF,OAAO,EAA8D,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAyB1I;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,sCAAsC;IACtC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2IAA2I;IAC3I,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,aAAa,CAAC,EAAE,sBAAsB,EAAE,CAAC;IACzC,wDAAwD;IACxD,WAAW,CAAC,EAAE,CAAC,OAAO,UAAU,CAAC,EAAE,CAAC;CACrC;AAED,YAAY;AACZ,MAAM,WAAW,gBAAiB,SAAQ,cAAc;IACtD,YAAY,CAAC,EAAE,mBAAmB,CAAC;CACpC;AAED,YAAY;AACZ,MAAM,WAAW,yBAA0B,SAAQ,+BAA+B;IAChF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,2DAA2D;IAC3D,aAAa,CAAC,EAAE,CAAC,SAAS,GAAG,QAAQ,GAAG,aAAa,GAAG,sBAAsB,CAAC,CAAC;CACjF;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,IAAI,CAAc;IACjC,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAU;IAC3C,OAAO,CAAC,MAAM,CAAC,SAAS,CAAwB;IAChD,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAA0B;IAC1D,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,CAAgB;IAC3C,OAAc,gBAAgB,EAAE,MAAM,CAAC;IACvC,OAAc,WAAW,EAAE,MAAM,CAAC;IAClC,OAAc,WAAW,EAAE,MAAM,CAAC;IAClC,OAAc,SAAS,EAAE,gBAAgB,CAAC;IAC1C,WAAkB,OAAO,qBAAsC;IAC/D,WAAkB,GAAG,iBAAkC;IACvD,WAAkB,QAAQ,0BAA6B;IAEvD,OAAO;IAEP;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAmB/B,OAAO,CAAC,MAAM,CAAC,WAAW;IAyD1B,qDAAqD;IACrD,WAAkB,UAAU,8BAA+B;IAE3D,0FAA0F;WAC5E,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,0BAA0B,GAAG,SAAS;IAK9F,wFAAwF;WAC1E,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAIhF;;;OAGG;WACiB,cAAc,CAAC,aAAa,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC;IAsC5F,WAAkB,OAAO,YAAsC;IAE/D;;;;;;OAMG;WACiB,OAAO,CAAC,IAAI,CAAC,EAAE,gBAAgB;CAmCpD"}
1
+ {"version":3,"file":"ElectronHost.d.ts","sourceRoot":"","sources":["../../../src/backend/ElectronHost.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,+BAA+B,EAAkB,MAAM,UAAU,CAAC;AAC/F,OAAO,KAAK,KAAK,cAAc,MAAM,UAAU,CAAC;AAKhD,OAAO,EAAE,UAAU,EAAuB,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACtF,OAAO,EAA8D,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAyB1I;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,sCAAsC;IACtC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2IAA2I;IAC3I,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,aAAa,CAAC,EAAE,sBAAsB,EAAE,CAAC;IACzC,wDAAwD;IACxD,WAAW,CAAC,EAAE,CAAC,OAAO,UAAU,CAAC,EAAE,CAAC;CACrC;AAED,YAAY;AACZ,MAAM,WAAW,gBAAiB,SAAQ,cAAc;IACtD,YAAY,CAAC,EAAE,mBAAmB,CAAC;CACpC;AAED,YAAY;AACZ,MAAM,WAAW,yBAA0B,SAAQ,+BAA+B;IAChF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,2DAA2D;IAC3D,aAAa,CAAC,EAAE,CAAC,SAAS,GAAG,QAAQ,GAAG,aAAa,GAAG,sBAAsB,CAAC,CAAC;CACjF;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,6BAA6B,CAAe;IACpE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAsB;IAEjE,OAAO,CAAC,MAAM,CAAC,IAAI,CAAc;IACjC,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAU;IAC3C,OAAO,CAAC,MAAM,CAAC,SAAS,CAAwB;IAChD,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAA0B;IAC1D,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,CAAgB;IAC3C,OAAc,gBAAgB,EAAE,MAAM,CAAC;IACvC,OAAc,WAAW,EAAE,MAAM,CAAC;IAClC,OAAc,WAAW,EAAE,MAAM,CAAC;IAClC,OAAc,SAAS,EAAE,gBAAgB,CAAC;IAC1C,WAAkB,OAAO,qBAAsC;IAC/D,WAAkB,GAAG,iBAAkC;IACvD,WAAkB,QAAQ,0BAA6B;IAEvD,OAAO;IAEP;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAmB/B,OAAO,CAAC,MAAM,CAAC,WAAW;IAuD1B,qDAAqD;IACrD,WAAkB,UAAU,8BAA+B;IAE3D;;;;;;;OAOG;WACW,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,0BAA0B,GAAG,SAAS;IAK9F;;OAEG;WACW,+BAA+B,CAAC,UAAU,EAAE,MAAM,GAAG,0BAA0B,GAAG,SAAS;IAKzG,wFAAwF;WAC1E,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAIhF;;;OAGG;WACiB,cAAc,CAAC,aAAa,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC;IAsC5F,WAAkB,OAAO,YAAsC;IAE/D;;;;;;OAMG;WACiB,OAAO,CAAC,IAAI,CAAC,EAAE,gBAAgB;CAmCpD"}