@itwin/core-electron 4.0.0-dev.7 → 4.0.0-dev.72

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 (43) hide show
  1. package/CHANGELOG.md +49 -1
  2. package/lib/cjs/ElectronBackend.d.ts +1 -1
  3. package/lib/cjs/ElectronBackend.js +21 -17
  4. package/lib/cjs/ElectronBackend.js.map +1 -1
  5. package/lib/cjs/ElectronFrontend.d.ts +1 -1
  6. package/lib/cjs/ElectronFrontend.js +21 -17
  7. package/lib/cjs/ElectronFrontend.js.map +1 -1
  8. package/lib/cjs/__DOC_ONLY__.d.ts +3 -3
  9. package/lib/cjs/__DOC_ONLY__.js +26 -22
  10. package/lib/cjs/__DOC_ONLY__.js.map +1 -1
  11. package/lib/cjs/backend/ElectronHost.d.ts +104 -104
  12. package/lib/cjs/backend/ElectronHost.d.ts.map +1 -1
  13. package/lib/cjs/backend/ElectronHost.js +240 -243
  14. package/lib/cjs/backend/ElectronHost.js.map +1 -1
  15. package/lib/cjs/backend/ElectronPreload.d.ts +1 -1
  16. package/lib/cjs/backend/ElectronPreload.js +39 -39
  17. package/lib/cjs/common/ElectronIpcInterface.d.ts +7 -7
  18. package/lib/cjs/common/ElectronIpcInterface.d.ts.map +1 -1
  19. package/lib/cjs/common/ElectronIpcInterface.js +5 -5
  20. package/lib/cjs/common/ElectronIpcTransport.d.ts +44 -44
  21. package/lib/cjs/common/ElectronIpcTransport.js +186 -186
  22. package/lib/cjs/common/ElectronIpcTransport.js.map +1 -1
  23. package/lib/cjs/common/ElectronManagerLoggerCategory.d.ts +10 -10
  24. package/lib/cjs/common/ElectronManagerLoggerCategory.js +18 -18
  25. package/lib/cjs/common/ElectronPush.d.ts +20 -20
  26. package/lib/cjs/common/ElectronPush.js +48 -48
  27. package/lib/cjs/common/ElectronPush.js.map +1 -1
  28. package/lib/cjs/common/ElectronRpcManager.d.ts +26 -26
  29. package/lib/cjs/common/ElectronRpcManager.js +65 -65
  30. package/lib/cjs/common/ElectronRpcManager.js.map +1 -1
  31. package/lib/cjs/common/ElectronRpcProtocol.d.ts +34 -34
  32. package/lib/cjs/common/ElectronRpcProtocol.js +58 -58
  33. package/lib/cjs/common/ElectronRpcProtocol.js.map +1 -1
  34. package/lib/cjs/common/ElectronRpcRequest.d.ts +19 -19
  35. package/lib/cjs/common/ElectronRpcRequest.js +56 -56
  36. package/lib/cjs/common/ITwinElectronApi.d.ts +10 -10
  37. package/lib/cjs/common/ITwinElectronApi.d.ts.map +1 -1
  38. package/lib/cjs/common/ITwinElectronApi.js +6 -6
  39. package/lib/cjs/frontend/ElectronApp.d.ts +35 -35
  40. package/lib/cjs/frontend/ElectronApp.d.ts.map +1 -1
  41. package/lib/cjs/frontend/ElectronApp.js +73 -75
  42. package/lib/cjs/frontend/ElectronApp.js.map +1 -1
  43. package/package.json +27 -27
package/CHANGELOG.md CHANGED
@@ -1,6 +1,54 @@
1
1
  # Change Log - @itwin/core-electron
2
2
 
3
- This log was last generated on Thu, 26 Jan 2023 22:53:27 GMT and should not be manually modified.
3
+ This log was last generated on Wed, 12 Apr 2023 13:12:42 GMT and should not be manually modified.
4
+
5
+ ## 3.7.2
6
+ Wed, 12 Apr 2023 13:12:42 GMT
7
+
8
+ _Version update only_
9
+
10
+ ## 3.7.1
11
+ Mon, 03 Apr 2023 15:15:37 GMT
12
+
13
+ _Version update only_
14
+
15
+ ## 3.7.0
16
+ Wed, 29 Mar 2023 15:02:27 GMT
17
+
18
+ ### Updates
19
+
20
+ - React to IModelApp.rpcInterfaces and BentleyCloudRpcManager changes.
21
+ - Add support for Electron 23.
22
+
23
+ ## 3.6.3
24
+ Mon, 27 Mar 2023 16:26:47 GMT
25
+
26
+ _Version update only_
27
+
28
+ ## 3.6.2
29
+ Fri, 17 Mar 2023 17:52:32 GMT
30
+
31
+ _Version update only_
32
+
33
+ ## 3.6.1
34
+ Fri, 24 Feb 2023 22:00:48 GMT
35
+
36
+ _Version update only_
37
+
38
+ ## 3.6.0
39
+ Wed, 08 Feb 2023 14:58:39 GMT
40
+
41
+ ### Updates
42
+
43
+ - Added ElectronHost.getWindowSizeAndPositionSetting to replace now deprecated ElectronHost.getWindowSizeSetting
44
+ - Add support for Electron 22.
45
+ - Use EmptyLocalization for localization in tests to increase test performance
46
+ - React to RPC deprecations.
47
+
48
+ ## 3.5.6
49
+ Fri, 24 Feb 2023 16:02:47 GMT
50
+
51
+ _Version update only_
4
52
 
5
53
  ## 3.5.5
6
54
  Thu, 26 Jan 2023 22:53:27 GMT
@@ -1,2 +1,2 @@
1
- export * from "./backend/ElectronHost";
1
+ export * from "./backend/ElectronHost";
2
2
  //# sourceMappingURL=ElectronBackend.d.ts.map
@@ -1,18 +1,22 @@
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
+ var desc = Object.getOwnPropertyDescriptor(m, k);
9
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
10
+ desc = { enumerable: true, get: function() { return m[k]; } };
11
+ }
12
+ Object.defineProperty(o, k2, desc);
13
+ }) : (function(o, m, k, k2) {
14
+ if (k2 === undefined) k2 = k;
15
+ o[k2] = m[k];
16
+ }));
17
+ var __exportStar = (this && this.__exportStar) || function(m, exports) {
18
+ for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
19
+ };
20
+ Object.defineProperty(exports, "__esModule", { value: true });
21
+ __exportStar(require("./backend/ElectronHost"), exports);
18
22
  //# 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":["/*---------------------------------------------------------------------------------------------\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,2 +1,2 @@
1
- export * from "./frontend/ElectronApp";
1
+ export * from "./frontend/ElectronApp";
2
2
  //# sourceMappingURL=ElectronFrontend.d.ts.map
@@ -1,18 +1,22 @@
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
+ var desc = Object.getOwnPropertyDescriptor(m, k);
9
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
10
+ desc = { enumerable: true, get: function() { return m[k]; } };
11
+ }
12
+ Object.defineProperty(o, k2, desc);
13
+ }) : (function(o, m, k, k2) {
14
+ if (k2 === undefined) k2 = k;
15
+ o[k2] = m[k];
16
+ }));
17
+ var __exportStar = (this && this.__exportStar) || function(m, exports) {
18
+ for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
19
+ };
20
+ Object.defineProperty(exports, "__esModule", { value: true });
21
+ __exportStar(require("./frontend/ElectronApp"), exports);
18
22
  //# 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":["/*---------------------------------------------------------------------------------------------\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,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,27 @@
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
+ var desc = Object.getOwnPropertyDescriptor(m, k);
9
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
10
+ desc = { enumerable: true, get: function() { return m[k]; } };
11
+ }
12
+ Object.defineProperty(o, k2, desc);
13
+ }) : (function(o, m, k, k2) {
14
+ if (k2 === undefined) k2 = k;
15
+ o[k2] = m[k];
16
+ }));
17
+ var __exportStar = (this && this.__exportStar) || function(m, exports) {
18
+ for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
19
+ };
20
+ Object.defineProperty(exports, "__esModule", { value: true });
21
+ // THIS FILE EXISTS ONLY FOR DOCUMENTATION GENERATION.
22
+ // It imports both frontend and backend code, which is not legal anywhere.
23
+ // Do not import it in real code!
24
+ __exportStar(require("./backend/ElectronHost"), exports);
25
+ __exportStar(require("./common/ElectronIpcInterface"), exports);
26
+ __exportStar(require("./frontend/ElectronApp"), exports);
23
27
  //# 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":["/*---------------------------------------------------------------------------------------------\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,105 +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 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
- }
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
+ }
105
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,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"}
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;IAsD1B,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"}