npm - @itwin/appui-react - Versions diffs - 4.0.0-dev.1 → 4.0.0-dev.10 - Mend

@itwin/appui-react 4.0.0-dev.1 → 4.0.0-dev.10

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 (1682) hide show

package/lib/esm/appui-react/childwindow/ChildWindowManager.js CHANGED Viewed

@@ -2,175 +2,102 @@
 * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
 * See LICENSE.md in the project root for license terms and full copyright notice.
 *--------------------------------------------------------------------------------------------*/
-/** @packageDocumentation
- * @module ChildWindowManager
- */
-import "./ChildWindowManager.scss";
-import * as React from "react";
-import * as ReactDOM from "react-dom";
-import { copyStyles } from "./CopyStyles";
-import { Provider } from "react-redux";
-import { StateManager } from "../redux/StateManager";
-import { UiStateStorageHandler } from "../uistate/useUiStateStorage";
-import { PopupRenderer } from "../popup/PopupManager";
-import { ModelessDialogRenderer } from "../dialog/ModelessDialogManager";
-import { ModalDialogRenderer } from "../dialog/ModalDialogManager";
-import { CursorPopupMenu } from "../cursor/cursormenu/CursorMenu";
-import { FrameworkVersion } from "../hooks/useFrameworkVersion";
-import { FrontstageManager } from "../frontstage/FrontstageManager";
-import { ThemeManager } from "../theme/ThemeManager";
-const childHtml = `<!DOCTYPE html>
-<html>
-<head>
-  <meta charset="utf-8" />
-  <style>
-    html,
-    body {
-      height: 100%;
-      width: 100%;
-      margin: 0;
-      overflow: hidden;
-    }
-    #root {
-      height: 100%;
-    }
-  </style>
-</head>
-<body>
-  <noscript>You need to enable JavaScript to run this app.</noscript>
-  <div id="root"></div>
-</body>
-</html>`;
+import { InternalChildWindowManager } from "./InternalChildWindowManager";
 /** Supports opening a child browser window from the main application window. The child window is managed by the main application
  * and is running in the same security context. The application must deliver the html file iTwinPopup.html along side its index.html.
  * See also: [Child Window Manager]($docs/learning/ui/appui-react/ChildWindows.md)
- * @public */
+ * @public
+ * @deprecated in 3.7. Use `UiFramework.childWindows` property to access.
+ * */
 export class ChildWindowManager {
     constructor() {
-        this._openChildWindows = [];
+        this.internal = new InternalChildWindowManager();
+        /**
+         * @deprecated in 3.7. Use `close` method.
+         */
         this.closeChildWindow = (childWindowId, processWindowClose = true) => {
-            const windowIndex = this.openChildWindows.findIndex((openWindow) => openWindow.childWindowId === childWindowId);
-            if (-1 === windowIndex)
-                return false;
-            const childWindow = this.openChildWindows[windowIndex];
-            this.openChildWindows.splice(windowIndex, 1);
-            if (processWindowClose) {
-                childWindow.window.close();
-            }
-            else {
-                // call the following to convert popout to docked widget
-                const frontStageDef = FrontstageManager.activeFrontstageDef;
-                frontStageDef && frontStageDef.dockPopoutWidgetContainer(childWindowId);
-            }
-            return true;
+            return this.internal.close(childWindowId, processWindowClose);
         };
+        /**
+           * Close a specific child window.
+           * @param childWindowId Id of the window to close
+           * @param processWindowClose should the `close` method be called on the closing window. (defaults to true)
+           * @returns false if the window could not be found.
+           */
+        this.close = (childWindowId, processWindowClose = true) => {
+            return this.internal.close(childWindowId, processWindowClose);
+        };
+    }
+    /**
+     * Override internal implementation for a mock
+     * @internal For tests only.
+     */
+    mockInternal(internal) {
+        this.internal = internal;
     }
     get openChildWindows() {
-        return this._openChildWindows;
+        return this.internal.openChildWindows;
     }
+    /**
+     * @deprecated in 3.7. Use `find` method.
+     */
     findChildWindow(childWindowId) {
-        if (undefined === childWindowId)
-            return undefined;
-        return this.openChildWindows.find((openWindow) => openWindow.childWindowId === childWindowId);
+        return this.internal.find(childWindowId);
     }
+    /**
+     * @deprecated in 3.7. Use `findId` method.
+     */
     findChildWindowId(contentWindow) {
-        if (!contentWindow)
-            return undefined;
-        const childWindow = this.openChildWindows.find((openWindow) => openWindow.window === contentWindow);
-        return childWindow === null || childWindow === void 0 ? void 0 : childWindow.childWindowId;
+        return this.internal.findId(contentWindow);
     }
-    // istanbul ignore next
-    renderChildWindowContents(childWindow, childWindowId, content) {
-        const reactConnectionDiv = childWindow.document.getElementById("root");
-        if (reactConnectionDiv) {
-            // set openChildWindows now so components can use it when they mount
-            this._openChildWindows.push({
-                childWindowId,
-                window: childWindow,
-                parentWindow: window,
-            });
-            setTimeout(() => {
-                copyStyles(childWindow.document);
-                setTimeout(() => {
-                    ReactDOM.render(React.createElement(Provider, { store: StateManager.store },
-                        React.createElement(UiStateStorageHandler, null,
-                            React.createElement(ThemeManager, null,
-                                React.createElement(FrameworkVersion, null,
-                                    " ",
-                                    React.createElement("div", { className: "uifw-child-window-container-host" },
-                                        React.createElement(PopupRenderer, null),
-                                        React.createElement(ModalDialogRenderer, null),
-                                        React.createElement(ModelessDialogRenderer, null),
-                                        React.createElement(CursorPopupMenu, null),
-                                        React.createElement("div", { className: "uifw-child-window-container nz-widget-widget" }, content)))))), reactConnectionDiv);
-                });
-            });
-            childWindow.onbeforeunload = () => {
-                const frontStageDef = FrontstageManager.activeFrontstageDef;
-                if (!frontStageDef)
-                    return;
-                frontStageDef.saveChildWindowSizeAndPosition(childWindowId, childWindow);
-                this.closeChildWindow(childWindowId, false);
-            };
-        }
-    }
-    /** Close all child/pop-out windows. This typically is called when the frontstage is changed. */
+    /** Close all child/pop-out windows. This typically is called when the frontstage is changed.
+     * @deprecated in 3.7. Use `closeAll` method.
+     */
     closeAllChildWindows() {
-        // istanbul ignore next
-        this.openChildWindows.forEach((openChildWindow) => openChildWindow.window.close());
-        this._openChildWindows = [];
+        return this.internal.closeAll();
     }
+    /**
+     * @deprecated in 3.7. Use `open` method.
+     */
     // istanbul ignore next
-    adjustWidowLocation(location, center) {
-        var _a;
-        const outLocation = { ...location };
-        if (0 === location.top && 0 === location.left) {
-            center = center !== null && center !== void 0 ? center : true;
-            const windowTop = (_a = window.top) !== null && _a !== void 0 ? _a : window;
-            // Prepare position of the new window to be centered against the 'parent' window.
-            if (center) {
-                outLocation.left =
-                    windowTop.outerWidth / 2 + windowTop.screenX - location.width / 2;
-                outLocation.top =
-                    windowTop.outerHeight / 2 + windowTop.screenY - location.height / 2;
-            }
-            else {
-                if (undefined !== window.screenLeft && undefined !== window.screenTop) {
-                    outLocation.top = window.screenTop + location.top;
-                    outLocation.left = window.screenLeft + location.left;
-                }
-            }
-        }
-        return outLocation;
+    openChildWindow(childWindowId, title, content, location, useDefaultPopoutUrl) {
+        return this.internal.open(childWindowId, title, content, location, useDefaultPopoutUrl);
+    }
+    useCreateRoot(createRootFn) {
+        return this.internal.useCreateRoot(createRootFn);
+    }
+    /**
+     * Returns the OpenChildWindowInfo for the related id.
+     * @param childWindowId Id of the window to retrieve.
+     * @returns undefined if not found.
+     */
+    find(childWindowId) {
+        return this.internal.find(childWindowId);
+    }
+    /**
+       * Return the childWindowId of the provided window.
+       * @param contentWindow Window element to identify
+       * @returns undefined if not found
+       */
+    findId(contentWindow) {
+        return this.internal.findId(contentWindow);
     }
+    /** Close all child/pop-out windows. This typically is called when the frontstage is changed. */
+    closeAll() {
+        return this.internal.closeAll();
+    }
+    /**
+       * Open a new child window.
+       * @param childWindowId Id to assign to the newly created window.
+       * @param title Title to display on the window.
+       * @param content ReactNode to be rendered in the window.
+       * @param location Position and size information
+       * @param useDefaultPopoutUrl use "/iTwinPopup.html" as the window Url, "" otherwise.
+       * @returns true if the window is opened successfully.
+       */
     // istanbul ignore next
-    openChildWindow(childWindowId, title, content, location, useDefaultPopoutUrl) {
-        // first check to see if content is already open in child window
-        if (this.openChildWindows.findIndex((openWindow) => openWindow.childWindowId === childWindowId) >= 0) {
-            return false;
-        }
-        location = this.adjustWidowLocation(location);
-        const url = useDefaultPopoutUrl ? "/iTwinPopup.html" : "";
-        const childWindow = window.open(url, "", `width=${location.width},height=${location.height},left=${location.left},top=${location.top},menubar=no,resizable=yes,scrollbars=no,status=no,location=no`);
-        if (!childWindow)
-            return false;
-        if (0 === url.length) {
-            childWindow.document.write(childHtml);
-            this.renderChildWindowContents(childWindow, childWindowId, content);
-        }
-        else {
-            childWindow.addEventListener("load", () => {
-                childWindow.document.title = title;
-                this.renderChildWindowContents(childWindow, childWindowId, content);
-            }, false);
-        }
-        window.addEventListener("unload", () => {
-            const frontStageDef = FrontstageManager.activeFrontstageDef;
-            if (frontStageDef) {
-                this.closeChildWindow(childWindowId, true);
-            }
-        }, false);
-        return true;
+    open(childWindowId, title, content, location, useDefaultPopoutUrl) {
+        return this.internal.open(childWindowId, title, content, location, useDefaultPopoutUrl);
     }
 }
 //# sourceMappingURL=ChildWindowManager.js.map

package/lib/esm/appui-react/childwindow/ChildWindowManager.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"ChildWindowManager.js","sourceRoot":"","sources":["../../../../src/appui-react/childwindow/ChildWindowManager.tsx"],"names":[],"mappings":"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","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/** @packageDocumentation\r\n * @module ChildWindowManager\r\n /\r\n\r\nimport \"./ChildWindowManager.scss\";\r\nimport as React from \"react\";\r\nimport * as ReactDOM from \"react-dom\";\r\nimport { copyStyles } from \"./CopyStyles\";\r\nimport { Provider } from \"react-redux\";\r\nimport { StateManager } from \"../redux/StateManager\";\r\nimport { UiStateStorageHandler } from \"../uistate/useUiStateStorage\";\r\nimport { PopupRenderer } from \"../popup/PopupManager\";\r\nimport { ModelessDialogRenderer } from \"../dialog/ModelessDialogManager\";\r\nimport { ModalDialogRenderer } from \"../dialog/ModalDialogManager\";\r\nimport { CursorPopupMenu } from \"../cursor/cursormenu/CursorMenu\";\r\nimport { FrameworkVersion } from \"../hooks/useFrameworkVersion\";\r\nimport { FrontstageManager } from \"../frontstage/FrontstageManager\";\r\nimport { ThemeManager } from \"../theme/ThemeManager\";\r\n\r\nconst childHtml = `<!DOCTYPE html>\r\n<html>\r\n<head>\r\n <meta charset=\"utf-8\" />\r\n <style>\r\n html,\r\n body {\r\n height: 100%;\r\n width: 100%;\r\n margin: 0;\r\n overflow: hidden;\r\n }\r\n #root {\r\n height: 100%;\r\n }\r\n </style>\r\n</head>\r\n<body>\r\n <noscript>You need to enable JavaScript to run this app.</noscript>\r\n <div id=\"root\"></div>\r\n</body>\r\n</html>`;\r\n\r\n/** @public /\r\nexport interface OpenChildWindowInfo {\r\n childWindowId: string;\r\n window: Window;\r\n parentWindow: Window;\r\n}\r\n\r\n/* @public /\r\nexport interface ChildWindowLocationProps {\r\n width: number;\r\n height: number;\r\n left: number;\r\n top: number;\r\n}\r\n\r\n/* Supports opening a child browser window from the main application window. The child window is managed by the main application\r\n * and is running in the same security context. The application must deliver the html file iTwinPopup.html along side its index.html.\r\n * See also: [Child Window Manager]($docs/learning/ui/appui-react/ChildWindows.md)\r\n * @public /\r\nexport class ChildWindowManager {\r\n private _openChildWindows: OpenChildWindowInfo[] = [];\r\n\r\n public get openChildWindows() {\r\n return this._openChildWindows;\r\n }\r\n\r\n public findChildWindow(childWindowId: string \| undefined): OpenChildWindowInfo \| undefined {\r\n if (undefined === childWindowId)\r\n return undefined;\r\n\r\n return this.openChildWindows.find((openWindow) => openWindow.childWindowId === childWindowId);\r\n }\r\n\r\n public findChildWindowId(contentWindow: Window \| undefined \| null): string \| undefined {\r\n if (!contentWindow)\r\n return undefined;\r\n\r\n const childWindow = this.openChildWindows.find((openWindow) => openWindow.window === contentWindow);\r\n return childWindow?.childWindowId;\r\n }\r\n\r\n // istanbul ignore next\r\n private renderChildWindowContents(childWindow: Window, childWindowId: string, content: React.ReactNode) {\r\n const reactConnectionDiv = childWindow.document.getElementById(\"root\");\r\n if (reactConnectionDiv) {\r\n // set openChildWindows now so components can use it when they mount\r\n this._openChildWindows.push({\r\n childWindowId,\r\n window: childWindow,\r\n parentWindow: window,\r\n });\r\n\r\n setTimeout(() => {\r\n copyStyles(childWindow.document);\r\n setTimeout(() => {\r\n ReactDOM.render(\r\n <Provider store={StateManager.store} >\r\n <UiStateStorageHandler>\r\n <ThemeManager>\r\n <FrameworkVersion> {/ eslint-disable-line deprecation/deprecation /}\r\n <div className=\"uifw-child-window-container-host\">\r\n <PopupRenderer />\r\n <ModalDialogRenderer />\r\n <ModelessDialogRenderer />\r\n <CursorPopupMenu />\r\n <div className=\"uifw-child-window-container nz-widget-widget\">\r\n {content}\r\n </div>\r\n </div>\r\n </FrameworkVersion>\r\n </ThemeManager>\r\n </UiStateStorageHandler>\r\n </Provider>,\r\n reactConnectionDiv\r\n );\r\n });\r\n });\r\n\r\n childWindow.onbeforeunload = () => {\r\n const frontStageDef = FrontstageManager.activeFrontstageDef;\r\n if (!frontStageDef)\r\n return;\r\n frontStageDef.saveChildWindowSizeAndPosition(childWindowId, childWindow);\r\n this.closeChildWindow(childWindowId, false);\r\n };\r\n }\r\n }\r\n\r\n /* Close all child/pop-out windows. This typically is called when the frontstage is changed. */\r\n public closeAllChildWindows() {\r\n // istanbul ignore next\r\n this.openChildWindows.forEach((openChildWindow) => openChildWindow.window.close());\r\n this._openChildWindows = [];\r\n }\r\n\r\n public closeChildWindow = (childWindowId: string, processWindowClose = true) => {\r\n const windowIndex = this.openChildWindows.findIndex((openWindow) => openWindow.childWindowId === childWindowId);\r\n if (-1 === windowIndex)\r\n return false;\r\n const childWindow = this.openChildWindows[windowIndex];\r\n this.openChildWindows.splice(windowIndex, 1);\r\n if (processWindowClose) {\r\n childWindow.window.close();\r\n } else {\r\n // call the following to convert popout to docked widget\r\n const frontStageDef = FrontstageManager.activeFrontstageDef;\r\n frontStageDef && frontStageDef.dockPopoutWidgetContainer(childWindowId);\r\n }\r\n return true;\r\n };\r\n\r\n // istanbul ignore next\r\n private adjustWidowLocation(location: ChildWindowLocationProps, center?: boolean): ChildWindowLocationProps {\r\n const outLocation = { ...location };\r\n if (0 === location.top && 0 === location.left) {\r\n center = center ?? true;\r\n const windowTop = window.top ?? window;\r\n\r\n // Prepare position of the new window to be centered against the 'parent' window.\r\n if (center) {\r\n outLocation.left =\r\n windowTop.outerWidth / 2 + windowTop.screenX - location.width / 2;\r\n outLocation.top =\r\n windowTop.outerHeight / 2 + windowTop.screenY - location.height / 2;\r\n } else {\r\n if (undefined !== window.screenLeft && undefined !== window.screenTop) {\r\n outLocation.top = window.screenTop + location.top;\r\n outLocation.left = window.screenLeft + location.left;\r\n }\r\n }\r\n }\r\n return outLocation;\r\n }\r\n\r\n // istanbul ignore next\r\n public openChildWindow(childWindowId: string, title: string, content: React.ReactNode, location: ChildWindowLocationProps, useDefaultPopoutUrl?: boolean) {\r\n // first check to see if content is already open in child window\r\n if (this.openChildWindows.findIndex((openWindow) => openWindow.childWindowId === childWindowId) >= 0) {\r\n return false;\r\n }\r\n\r\n location = this.adjustWidowLocation(location);\r\n const url = useDefaultPopoutUrl ? \"/iTwinPopup.html\" : \"\";\r\n const childWindow = window.open(url, \"\", `width=${location.width},height=${location.height},left=${location.left},top=${location.top},menubar=no,resizable=yes,scrollbars=no,status=no,location=no`);\r\n if (!childWindow)\r\n return false;\r\n if (0 === url.length) {\r\n childWindow.document.write(childHtml);\r\n this.renderChildWindowContents(childWindow, childWindowId, content);\r\n } else {\r\n childWindow.addEventListener(\"load\", () => {\r\n childWindow.document.title = title;\r\n this.renderChildWindowContents(childWindow, childWindowId, content);\r\n }, false);\r\n }\r\n\r\n window.addEventListener(\"unload\", () => {\r\n const frontStageDef = FrontstageManager.activeFrontstageDef;\r\n if (frontStageDef) {\r\n this.closeChildWindow(childWindowId, true);\r\n }\r\n }, false);\r\n\r\n return true;\r\n }\r\n}\r\n"]}
1	+ {"version":3,"file":"ChildWindowManager.js","sourceRoot":"","sources":["../../../../src/appui-react/childwindow/ChildWindowManager.tsx"],"names":[],"mappings":"AAAA;;;+FAG+F;AAQ/F,OAAO,EAAc,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAEtF;;;;;KAKK;AACL,MAAM,OAAO,kBAAkB;IAA/B;QACU,aAAQ,GAAG,IAAI,0BAA0B,EAAE,CAAC;QAuCpD;;WAEG;QACI,qBAAgB,GAAG,CACxB,aAAqB,EACrB,kBAAkB,GAAG,IAAI,EACzB,EAAE;YACF,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,aAAa,EAAE,kBAAkB,CAAC,CAAC;QAChE,CAAC,CAAC;QAiDF;;;;;aAKK;QACE,UAAK,GAAG,CAAC,aAAqB,EAAE,kBAAkB,GAAG,IAAI,EAAE,EAAE;YAClE,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,aAAa,EAAE,kBAAkB,CAAC,CAAC;QAChE,CAAC,CAAC;IAeJ,CAAC;IArHC;;;OAGG;IACI,YAAY,CAAC,QAAoC;QACtD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,IAAW,gBAAgB;QACzB,OAAO,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IACxC,CAAC;IAED;;OAEG;IACI,eAAe,CACpB,aAAiC;QAEjC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACI,iBAAiB,CACtB,aAAwC;QAExC,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACI,oBAAoB;QACzB,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;IAClC,CAAC;IAYD;;OAEG;IACH,uBAAuB;IAChB,eAAe,CACpB,aAAqB,EACrB,KAAa,EACb,OAAwB,EACxB,QAAkC,EAClC,mBAA6B;QAE7B,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CACvB,aAAa,EACb,KAAK,EACL,OAAO,EACP,QAAQ,EACR,mBAAmB,CACpB,CAAC;IACJ,CAAC;IAEM,aAAa,CAAC,YAAwB;QAC3C,OAAO,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;IACnD,CAAC;IAED;;;;OAIG;IACI,IAAI,CAAC,aAAiC;QAC3C,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC3C,CAAC;IAED;;;;SAIK;IACE,MAAM,CAAC,aAAwC;QACpD,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IAC7C,CAAC;IAED,gGAAgG;IACzF,QAAQ;QACb,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;IAClC,CAAC;IAYD;;;;;;;;SAQK;IACL,uBAAuB;IAChB,IAAI,CAAC,aAAqB,EAAE,KAAa,EAAE,OAAwB,EAAE,QAAkC,EAAE,mBAA6B;QAC3I,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,mBAAmB,CAAC,CAAC;IAC1F,CAAC;CACF","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/** @packageDocumentation\r\n * @module ChildWindowManager\r\n /\r\n\r\nimport as React from \"react\";\r\nimport { ChildWindowLocationProps, OpenChildWindowInfo } from \"../framework/FrameworkChildWindows\";\r\nimport { CreateRoot, InternalChildWindowManager } from \"./InternalChildWindowManager\";\r\n\r\n/** Supports opening a child browser window from the main application window. The child window is managed by the main application\r\n * and is running in the same security context. The application must deliver the html file iTwinPopup.html along side its index.html.\r\n * See also: [Child Window Manager]($docs/learning/ui/appui-react/ChildWindows.md)\r\n * @public\r\n * @deprecated in 3.7. Use `UiFramework.childWindows` property to access.\r\n * /\r\nexport class ChildWindowManager {\r\n private internal = new InternalChildWindowManager();\r\n\r\n /\r\n Override internal implementation for a mock\r\n * @internal For tests only.\r\n /\r\n public mockInternal(internal: InternalChildWindowManager) {\r\n this.internal = internal;\r\n }\r\n\r\n public get openChildWindows() {\r\n return this.internal.openChildWindows;\r\n }\r\n\r\n /\r\n @deprecated in 3.7. Use `find` method.\r\n /\r\n public findChildWindow(\r\n childWindowId: string \| undefined\r\n ): OpenChildWindowInfo \| undefined {\r\n return this.internal.find(childWindowId);\r\n }\r\n\r\n /\r\n @deprecated in 3.7. Use `findId` method.\r\n /\r\n public findChildWindowId(\r\n contentWindow: Window \| undefined \| null\r\n ): string \| undefined {\r\n return this.internal.findId(contentWindow);\r\n }\r\n\r\n /* Close all child/pop-out windows. This typically is called when the frontstage is changed.\r\n * @deprecated in 3.7. Use `closeAll` method.\r\n /\r\n public closeAllChildWindows() {\r\n return this.internal.closeAll();\r\n }\r\n\r\n /\r\n @deprecated in 3.7. Use `close` method.\r\n /\r\n public closeChildWindow = (\r\n childWindowId: string,\r\n processWindowClose = true\r\n ) => {\r\n return this.internal.close(childWindowId, processWindowClose);\r\n };\r\n\r\n /\r\n @deprecated in 3.7. Use `open` method.\r\n /\r\n // istanbul ignore next\r\n public openChildWindow(\r\n childWindowId: string,\r\n title: string,\r\n content: React.ReactNode,\r\n location: ChildWindowLocationProps,\r\n useDefaultPopoutUrl?: boolean\r\n ) {\r\n return this.internal.open(\r\n childWindowId,\r\n title,\r\n content,\r\n location,\r\n useDefaultPopoutUrl\r\n );\r\n }\r\n\r\n public useCreateRoot(createRootFn: CreateRoot) {\r\n return this.internal.useCreateRoot(createRootFn);\r\n }\r\n\r\n /\r\n Returns the OpenChildWindowInfo for the related id.\r\n * @param childWindowId Id of the window to retrieve.\r\n * @returns undefined if not found.\r\n /\r\n public find(childWindowId: string \| undefined): OpenChildWindowInfo \| undefined {\r\n return this.internal.find(childWindowId);\r\n }\r\n\r\n /\r\n Return the childWindowId of the provided window.\r\n * @param contentWindow Window element to identify\r\n * @returns undefined if not found\r\n /\r\n public findId(contentWindow: Window \| undefined \| null): string \| undefined {\r\n return this.internal.findId(contentWindow);\r\n }\r\n\r\n /* Close all child/pop-out windows. This typically is called when the frontstage is changed. /\r\n public closeAll() {\r\n return this.internal.closeAll();\r\n }\r\n\r\n /\r\n Close a specific child window.\r\n * @param childWindowId Id of the window to close\r\n * @param processWindowClose should the `close` method be called on the closing window. (defaults to true)\r\n * @returns false if the window could not be found.\r\n /\r\n public close = (childWindowId: string, processWindowClose = true) => {\r\n return this.internal.close(childWindowId, processWindowClose);\r\n };\r\n\r\n /\r\n Open a new child window.\r\n * @param childWindowId Id to assign to the newly created window.\r\n * @param title Title to display on the window.\r\n * @param content ReactNode to be rendered in the window.\r\n * @param location Position and size information\r\n * @param useDefaultPopoutUrl use \"/iTwinPopup.html\" as the window Url, \"\" otherwise.\r\n * @returns true if the window is opened successfully.\r\n */\r\n // istanbul ignore next\r\n public open(childWindowId: string, title: string, content: React.ReactNode, location: ChildWindowLocationProps, useDefaultPopoutUrl?: boolean) {\r\n return this.internal.open(childWindowId, title, content, location, useDefaultPopoutUrl);\r\n }\r\n}\r\n\r\n"]}

package/lib/esm/appui-react/childwindow/InternalChildWindowManager.d.ts ADDED Viewed

@@ -0,0 +1,72 @@
+/** @packageDocumentation
+ * @module ChildWindowManager
+ */
+import "./InternalChildWindowManager.scss";
+import * as React from "react";
+import { ChildWindowLocationProps, FrameworkChildWindows, OpenChildWindowInfo } from "../framework/FrameworkChildWindows";
+/**
+ * Simplification of non exported CreateRoot parameter, only to be used
+ * in InternalChildWindowManager and ChildWindowManager
+ * @internal
+ */
+export declare type CreateRoot = Parameters<FrameworkChildWindows["useCreateRoot"]>[0];
+/** Supports opening a child browser window from the main application window. The child window is managed by the main application
+ * and is running in the same security context. The application must deliver the html file iTwinPopup.html along side its index.html.
+ * See also: [Child Window Manager]($docs/learning/ui/appui-react/ChildWindows.md)
+ * @internal
+ * */
+export declare class InternalChildWindowManager implements FrameworkChildWindows {
+    private _openChildWindows;
+    private _createRoot?;
+    get openChildWindows(): OpenChildWindowInfo[];
+    /**
+     * When using React18, the `createRoot` function must be provided in order to render Popout content with React18.
+     * Do not call if using React 17 or before.
+     *
+     * Note: The type of the function is intentionally simplified here.
+     *
+     * @param createRootFn Function imported from `import { createRoot } from "react-dom/client";`
+     * @beta Will be removed once the transition to react 18 is complete.
+     */
+    useCreateRoot(createRootFn: CreateRoot): void;
+    /**
+     * Abstracts ReactDOM.render to use either the _createRoot method or the default ReactDOM.render.
+     * @param element Element to render.
+     * @param container Container to render to.
+     */
+    private render;
+    /**
+     * Returns the OpenChildWindowInfo for the related id.
+     * @param childWindowId Id of the window to retrieve.
+     * @returns undefined if not found.
+     */
+    find(childWindowId: string | undefined): OpenChildWindowInfo | undefined;
+    /**
+     * Return the childWindowId of the provided window.
+     * @param contentWindow Window element to identify
+     * @returns undefined if not found
+     */
+    findId(contentWindow: Window | undefined | null): string | undefined;
+    private renderChildWindowContents;
+    /** Close all child/pop-out windows. This typically is called when the frontstage is changed. */
+    closeAll(): void;
+    /**
+     * Close a specific child window.
+     * @param childWindowId Id of the window to close
+     * @param processWindowClose should the `close` method be called on the closing window. (defaults to true)
+     * @returns false if the window could not be found.
+     */
+    close: (childWindowId: string, processWindowClose?: boolean) => boolean;
+    private adjustWidowLocation;
+    /**
+     * Open a new child window.
+     * @param childWindowId Id to assign to the newly created window.
+     * @param title Title to display on the window.
+     * @param content ReactNode to be rendered in the window.
+     * @param location Position and size information
+     * @param useDefaultPopoutUrl use "/iTwinPopup.html" as the window Url, "" otherwise.
+     * @returns true if the window is opened successfully.
+     */
+    open(childWindowId: string, title: string, content: React.ReactNode, location: ChildWindowLocationProps, useDefaultPopoutUrl?: boolean): boolean;
+}
+//# sourceMappingURL=InternalChildWindowManager.d.ts.map

package/lib/esm/appui-react/childwindow/InternalChildWindowManager.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"InternalChildWindowManager.d.ts","sourceRoot":"","sources":["../../../../src/appui-react/childwindow/InternalChildWindowManager.tsx"],"names":[],"mappings":"AAKA;;GAEG;AAEH,OAAO,mCAAmC,CAAC;AAC3C,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAY/B,OAAO,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAyB1H;;;;GAIG;AACH,oBAAY,UAAU,GAAG,UAAU,CAAC,qBAAqB,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAE/E;;;;KAIK;AACL,qBAAa,0BAA2B,YAAW,qBAAqB;IACtE,OAAO,CAAC,iBAAiB,CAA6B;IACtD,OAAO,CAAC,WAAW,CAAC,CAAa;IAEjC,IAAW,gBAAgB,0BAE1B;IAED;;;;;;;;OAQG;IAEI,aAAa,CAAC,YAAY,EAAE,UAAU,GAAG,IAAI;IAIpD;;;;OAIG;IAEH,OAAO,CAAC,MAAM;IAQd;;;;OAIG;IACI,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,GAAG,mBAAmB,GAAG,SAAS;IAO/E;;;;OAIG;IACI,MAAM,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,SAAS;IAS3E,OAAO,CAAC,yBAAyB;IA4CjC,gGAAgG;IACzF,QAAQ;IAMf;;;;;OAKG;IACI,KAAK,kBAAmB,MAAM,2CAcnC;IAGF,OAAO,CAAC,mBAAmB;IAsB3B;;;;;;;;OAQG;IAEI,IAAI,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,SAAS,EAAE,QAAQ,EAAE,wBAAwB,EAAE,mBAAmB,CAAC,EAAE,OAAO;CA8B9I"}

package/lib/esm/appui-react/childwindow/InternalChildWindowManager.js ADDED Viewed

@@ -0,0 +1,226 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module ChildWindowManager
+ */
+import "./InternalChildWindowManager.scss";
+import * as React from "react";
+import * as ReactDOM from "react-dom";
+import { copyStyles } from "./CopyStyles";
+import { Provider } from "react-redux";
+import { StateManager } from "../redux/StateManager";
+import { UiStateStorageHandler } from "../uistate/useUiStateStorage";
+import { PopupRenderer } from "../popup/PopupManager";
+import { ModelessDialogRenderer } from "../dialog/ModelessDialogManager";
+import { ModalDialogRenderer } from "../dialog/ModalDialogManager";
+import { CursorPopupMenu } from "../cursor/cursormenu/CursorMenu";
+import { ThemeManager } from "../theme/ThemeManager";
+import { UiFramework } from "../UiFramework";
+const childHtml = `<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8" />
+  <style>
+    html,
+    body {
+      height: 100%;
+      width: 100%;
+      margin: 0;
+      overflow: hidden;
+    }
+    #root {
+      height: 100%;
+    }
+  </style>
+</head>
+<body>
+  <noscript>You need to enable JavaScript to run this app.</noscript>
+  <div id="root"></div>
+</body>
+</html>`;
+/** Supports opening a child browser window from the main application window. The child window is managed by the main application
+ * and is running in the same security context. The application must deliver the html file iTwinPopup.html along side its index.html.
+ * See also: [Child Window Manager]($docs/learning/ui/appui-react/ChildWindows.md)
+ * @internal
+ * */
+export class InternalChildWindowManager {
+    constructor() {
+        this._openChildWindows = [];
+        /**
+         * Close a specific child window.
+         * @param childWindowId Id of the window to close
+         * @param processWindowClose should the `close` method be called on the closing window. (defaults to true)
+         * @returns false if the window could not be found.
+         */
+        this.close = (childWindowId, processWindowClose = true) => {
+            const windowIndex = this.openChildWindows.findIndex((openWindow) => openWindow.childWindowId === childWindowId);
+            if (-1 === windowIndex)
+                return false;
+            const childWindow = this.openChildWindows[windowIndex];
+            this.openChildWindows.splice(windowIndex, 1);
+            if (processWindowClose) {
+                childWindow.window.close();
+            }
+            else {
+                // call the following to convert popout to docked widget
+                const frontStageDef = UiFramework.frontstages.activeFrontstageDef;
+                frontStageDef && frontStageDef.dockPopoutWidgetContainer(childWindowId);
+            }
+            return true;
+        };
+    }
+    get openChildWindows() {
+        return this._openChildWindows;
+    }
+    /**
+     * When using React18, the `createRoot` function must be provided in order to render Popout content with React18.
+     * Do not call if using React 17 or before.
+     *
+     * Note: The type of the function is intentionally simplified here.
+     *
+     * @param createRootFn Function imported from `import { createRoot } from "react-dom/client";`
+     * @beta Will be removed once the transition to react 18 is complete.
+     */
+    // istanbul ignore next: Result of this assignment is only visible in `open`, which is not tested.
+    useCreateRoot(createRootFn) {
+        this._createRoot = createRootFn;
+    }
+    /**
+     * Abstracts ReactDOM.render to use either the _createRoot method or the default ReactDOM.render.
+     * @param element Element to render.
+     * @param container Container to render to.
+     */
+    // istanbul ignore next: Used in `open` which is not tested.
+    render(element, container) {
+        if (this._createRoot) {
+            this._createRoot(container).render(element);
+        }
+        else {
+            ReactDOM.render(element, container);
+        }
+    }
+    /**
+     * Returns the OpenChildWindowInfo for the related id.
+     * @param childWindowId Id of the window to retrieve.
+     * @returns undefined if not found.
+     */
+    find(childWindowId) {
+        if (undefined === childWindowId)
+            return undefined;
+        return this.openChildWindows.find((openWindow) => openWindow.childWindowId === childWindowId);
+    }
+    /**
+     * Return the childWindowId of the provided window.
+     * @param contentWindow Window element to identify
+     * @returns undefined if not found
+     */
+    findId(contentWindow) {
+        if (!contentWindow)
+            return undefined;
+        const childWindow = this.openChildWindows.find((openWindow) => openWindow.window === contentWindow);
+        return childWindow === null || childWindow === void 0 ? void 0 : childWindow.childWindowId;
+    }
+    // istanbul ignore next: Used in `open` which is not tested.
+    renderChildWindowContents(childWindow, childWindowId, content) {
+        const reactConnectionDiv = childWindow.document.getElementById("root");
+        if (reactConnectionDiv) {
+            // set openChildWindows now so components can use it when they mount
+            this._openChildWindows.push({
+                childWindowId,
+                window: childWindow,
+                parentWindow: window,
+            });
+            setTimeout(() => {
+                copyStyles(childWindow.document);
+                setTimeout(() => {
+                    this.render(React.createElement(Provider, { store: StateManager.store },
+                        React.createElement(UiStateStorageHandler, null,
+                            React.createElement(ThemeManager, null,
+                                React.createElement("div", { className: "uifw-child-window-container-host" },
+                                    React.createElement(PopupRenderer, null),
+                                    React.createElement(ModalDialogRenderer, null),
+                                    React.createElement(ModelessDialogRenderer, null),
+                                    React.createElement(CursorPopupMenu, null),
+                                    React.createElement("div", { className: "uifw-child-window-container nz-widget-widget" }, content))))), reactConnectionDiv);
+                });
+            });
+            childWindow.onbeforeunload = () => {
+                const frontStageDef = UiFramework.frontstages.activeFrontstageDef;
+                if (!frontStageDef)
+                    return;
+                frontStageDef.saveChildWindowSizeAndPosition(childWindowId, childWindow);
+                this.close(childWindowId, false);
+            };
+        }
+    }
+    /** Close all child/pop-out windows. This typically is called when the frontstage is changed. */
+    closeAll() {
+        // istanbul ignore next
+        this.openChildWindows.forEach((openChildWindow) => openChildWindow.window.close());
+        this._openChildWindows = [];
+    }
+    // istanbul ignore next: Used in `open` which is not tested.
+    adjustWidowLocation(location, center) {
+        var _a;
+        const outLocation = { ...location };
+        if (0 === location.top && 0 === location.left) {
+            center = center !== null && center !== void 0 ? center : true;
+            const windowTop = (_a = window.top) !== null && _a !== void 0 ? _a : window;
+            // Prepare position of the new window to be centered against the 'parent' window.
+            if (center) {
+                outLocation.left =
+                    windowTop.outerWidth / 2 + windowTop.screenX - location.width / 2;
+                outLocation.top =
+                    windowTop.outerHeight / 2 + windowTop.screenY - location.height / 2;
+            }
+            else {
+                if (undefined !== window.screenLeft && undefined !== window.screenTop) {
+                    outLocation.top = window.screenTop + location.top;
+                    outLocation.left = window.screenLeft + location.left;
+                }
+            }
+        }
+        return outLocation;
+    }
+    /**
+     * Open a new child window.
+     * @param childWindowId Id to assign to the newly created window.
+     * @param title Title to display on the window.
+     * @param content ReactNode to be rendered in the window.
+     * @param location Position and size information
+     * @param useDefaultPopoutUrl use "/iTwinPopup.html" as the window Url, "" otherwise.
+     * @returns true if the window is opened successfully.
+     */
+    // istanbul ignore next: Would require mocking window.open to return a window object.
+    open(childWindowId, title, content, location, useDefaultPopoutUrl) {
+        // first check to see if content is already open in child window
+        if (this.openChildWindows.findIndex((openWindow) => openWindow.childWindowId === childWindowId) >= 0) {
+            return false;
+        }
+        location = this.adjustWidowLocation(location);
+        const url = useDefaultPopoutUrl ? "/iTwinPopup.html" : "";
+        const childWindow = window.open(url, "", `width=${location.width},height=${location.height},left=${location.left},top=${location.top},menubar=no,resizable=yes,scrollbars=no,status=no,location=no`);
+        if (!childWindow)
+            return false;
+        if (0 === url.length) {
+            childWindow.document.write(childHtml);
+            this.renderChildWindowContents(childWindow, childWindowId, content);
+        }
+        else {
+            childWindow.addEventListener("load", () => {
+                childWindow.document.title = title;
+                this.renderChildWindowContents(childWindow, childWindowId, content);
+            }, false);
+        }
+        window.addEventListener("unload", () => {
+            const frontStageDef = UiFramework.frontstages.activeFrontstageDef;
+            if (frontStageDef) {
+                this.close(childWindowId, true);
+            }
+        }, false);
+        return true;
+    }
+}
+//# sourceMappingURL=InternalChildWindowManager.js.map

package/lib/esm/appui-react/childwindow/InternalChildWindowManager.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"InternalChildWindowManager.js","sourceRoot":"","sources":["../../../../src/appui-react/childwindow/InternalChildWindowManager.tsx"],"names":[],"mappings":"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","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/** @packageDocumentation\r\n * @module ChildWindowManager\r\n */\r\n\r\nimport \"./InternalChildWindowManager.scss\";\r\nimport * as React from \"react\";\r\nimport * as ReactDOM from \"react-dom\";\r\nimport { copyStyles } from \"./CopyStyles\";\r\nimport { Provider } from \"react-redux\";\r\nimport { StateManager } from \"../redux/StateManager\";\r\nimport { UiStateStorageHandler } from \"../uistate/useUiStateStorage\";\r\nimport { PopupRenderer } from \"../popup/PopupManager\";\r\nimport { ModelessDialogRenderer } from \"../dialog/ModelessDialogManager\";\r\nimport { ModalDialogRenderer } from \"../dialog/ModalDialogManager\";\r\nimport { CursorPopupMenu } from \"../cursor/cursormenu/CursorMenu\";\r\nimport { ThemeManager } from \"../theme/ThemeManager\";\r\nimport { UiFramework } from \"../UiFramework\";\r\nimport { ChildWindowLocationProps, FrameworkChildWindows, OpenChildWindowInfo } from \"../framework/FrameworkChildWindows\";\r\n\r\nconst childHtml = `<!DOCTYPE html>\r\n<html>\r\n<head>\r\n <meta charset=\"utf-8\" />\r\n <style>\r\n html,\r\n body {\r\n height: 100%;\r\n width: 100%;\r\n margin: 0;\r\n overflow: hidden;\r\n }\r\n #root {\r\n height: 100%;\r\n }\r\n </style>\r\n</head>\r\n<body>\r\n <noscript>You need to enable JavaScript to run this app.</noscript>\r\n <div id=\"root\"></div>\r\n</body>\r\n</html>`;\r\n\r\n/**\r\n * Simplification of non exported CreateRoot parameter, only to be used\r\n * in InternalChildWindowManager and ChildWindowManager\r\n * @internal\r\n */\r\nexport type CreateRoot = Parameters<FrameworkChildWindows[\"useCreateRoot\"]>[0];\r\n\r\n/** Supports opening a child browser window from the main application window. The child window is managed by the main application\r\n * and is running in the same security context. The application must deliver the html file iTwinPopup.html along side its index.html.\r\n * See also: [Child Window Manager]($docs/learning/ui/appui-react/ChildWindows.md)\r\n * @internal\r\n * */\r\nexport class InternalChildWindowManager implements FrameworkChildWindows {\r\n private _openChildWindows: OpenChildWindowInfo[] = [];\r\n private _createRoot?: CreateRoot;\r\n\r\n public get openChildWindows() {\r\n return this._openChildWindows;\r\n }\r\n\r\n /**\r\n * When using React18, the `createRoot` function must be provided in order to render Popout content with React18.\r\n * Do not call if using React 17 or before.\r\n *\r\n * Note: The type of the function is intentionally simplified here.\r\n *\r\n * @param createRootFn Function imported from `import { createRoot } from \"react-dom/client\";`\r\n * @beta Will be removed once the transition to react 18 is complete.\r\n */\r\n // istanbul ignore next: Result of this assignment is only visible in `open`, which is not tested.\r\n public useCreateRoot(createRootFn: CreateRoot): void {\r\n this._createRoot = createRootFn;\r\n }\r\n\r\n /**\r\n * Abstracts ReactDOM.render to use either the _createRoot method or the default ReactDOM.render.\r\n * @param element Element to render.\r\n * @param container Container to render to.\r\n */\r\n // istanbul ignore next: Used in `open` which is not tested.\r\n private render(element: React.FunctionComponentElement<any>, container: Element | DocumentFragment) {\r\n if(this._createRoot) {\r\n this._createRoot(container).render(element);\r\n } else {\r\n ReactDOM.render(element, container);\r\n }\r\n }\r\n\r\n /**\r\n * Returns the OpenChildWindowInfo for the related id.\r\n * @param childWindowId Id of the window to retrieve.\r\n * @returns undefined if not found.\r\n */\r\n public find(childWindowId: string | undefined): OpenChildWindowInfo | undefined {\r\n if (undefined === childWindowId)\r\n return undefined;\r\n\r\n return this.openChildWindows.find((openWindow) => openWindow.childWindowId === childWindowId);\r\n }\r\n\r\n /**\r\n * Return the childWindowId of the provided window.\r\n * @param contentWindow Window element to identify\r\n * @returns undefined if not found\r\n */\r\n public findId(contentWindow: Window | undefined | null): string | undefined {\r\n if (!contentWindow)\r\n return undefined;\r\n\r\n const childWindow = this.openChildWindows.find((openWindow) => openWindow.window === contentWindow);\r\n return childWindow?.childWindowId;\r\n }\r\n\r\n // istanbul ignore next: Used in `open` which is not tested.\r\n private renderChildWindowContents(childWindow: Window, childWindowId: string, content: React.ReactNode) {\r\n const reactConnectionDiv = childWindow.document.getElementById(\"root\");\r\n if (reactConnectionDiv) {\r\n // set openChildWindows now so components can use it when they mount\r\n this._openChildWindows.push({\r\n childWindowId,\r\n window: childWindow,\r\n parentWindow: window,\r\n });\r\n\r\n setTimeout(() => {\r\n copyStyles(childWindow.document);\r\n setTimeout(() => {\r\n this.render(\r\n <Provider store={StateManager.store} >\r\n <UiStateStorageHandler>\r\n <ThemeManager>\r\n <div className=\"uifw-child-window-container-host\">\r\n <PopupRenderer />\r\n <ModalDialogRenderer />\r\n <ModelessDialogRenderer />\r\n <CursorPopupMenu />\r\n <div className=\"uifw-child-window-container nz-widget-widget\">\r\n {content}\r\n </div>\r\n </div>\r\n </ThemeManager>\r\n </UiStateStorageHandler>\r\n </Provider>,\r\n reactConnectionDiv\r\n );\r\n });\r\n });\r\n\r\n childWindow.onbeforeunload = () => {\r\n const frontStageDef = UiFramework.frontstages.activeFrontstageDef;\r\n if (!frontStageDef)\r\n return;\r\n frontStageDef.saveChildWindowSizeAndPosition(childWindowId, childWindow);\r\n this.close(childWindowId, false);\r\n };\r\n }\r\n }\r\n\r\n /** Close all child/pop-out windows. This typically is called when the frontstage is changed. */\r\n public closeAll() {\r\n // istanbul ignore next\r\n this.openChildWindows.forEach((openChildWindow) => openChildWindow.window.close());\r\n this._openChildWindows = [];\r\n }\r\n\r\n /**\r\n * Close a specific child window.\r\n * @param childWindowId Id of the window to close\r\n * @param processWindowClose should the `close` method be called on the closing window. (defaults to true)\r\n * @returns false if the window could not be found.\r\n */\r\n public close = (childWindowId: string, processWindowClose = true) => {\r\n const windowIndex = this.openChildWindows.findIndex((openWindow) => openWindow.childWindowId === childWindowId);\r\n if (-1 === windowIndex)\r\n return false;\r\n const childWindow = this.openChildWindows[windowIndex];\r\n this.openChildWindows.splice(windowIndex, 1);\r\n if (processWindowClose) {\r\n childWindow.window.close();\r\n } else {\r\n // call the following to convert popout to docked widget\r\n const frontStageDef = UiFramework.frontstages.activeFrontstageDef;\r\n frontStageDef && frontStageDef.dockPopoutWidgetContainer(childWindowId);\r\n }\r\n return true;\r\n };\r\n\r\n // istanbul ignore next: Used in `open` which is not tested.\r\n private adjustWidowLocation(location: ChildWindowLocationProps, center?: boolean): ChildWindowLocationProps {\r\n const outLocation = { ...location };\r\n if (0 === location.top && 0 === location.left) {\r\n center = center ?? true;\r\n const windowTop = window.top ?? window;\r\n\r\n // Prepare position of the new window to be centered against the 'parent' window.\r\n if (center) {\r\n outLocation.left =\r\n windowTop.outerWidth / 2 + windowTop.screenX - location.width / 2;\r\n outLocation.top =\r\n windowTop.outerHeight / 2 + windowTop.screenY - location.height / 2;\r\n } else {\r\n if (undefined !== window.screenLeft && undefined !== window.screenTop) {\r\n outLocation.top = window.screenTop + location.top;\r\n outLocation.left = window.screenLeft + location.left;\r\n }\r\n }\r\n }\r\n return outLocation;\r\n }\r\n\r\n /**\r\n * Open a new child window.\r\n * @param childWindowId Id to assign to the newly created window.\r\n * @param title Title to display on the window.\r\n * @param content ReactNode to be rendered in the window.\r\n * @param location Position and size information\r\n * @param useDefaultPopoutUrl use \"/iTwinPopup.html\" as the window Url, \"\" otherwise.\r\n * @returns true if the window is opened successfully.\r\n */\r\n // istanbul ignore next: Would require mocking window.open to return a window object.\r\n public open(childWindowId: string, title: string, content: React.ReactNode, location: ChildWindowLocationProps, useDefaultPopoutUrl?: boolean) {\r\n // first check to see if content is already open in child window\r\n if (this.openChildWindows.findIndex((openWindow) => openWindow.childWindowId === childWindowId) >= 0) {\r\n return false;\r\n }\r\n\r\n location = this.adjustWidowLocation(location);\r\n const url = useDefaultPopoutUrl ? \"/iTwinPopup.html\" : \"\";\r\n const childWindow = window.open(url, \"\", `width=${location.width},height=${location.height},left=${location.left},top=${location.top},menubar=no,resizable=yes,scrollbars=no,status=no,location=no`);\r\n if (!childWindow)\r\n return false;\r\n if (0 === url.length) {\r\n childWindow.document.write(childHtml);\r\n this.renderChildWindowContents(childWindow, childWindowId, content);\r\n } else {\r\n childWindow.addEventListener(\"load\", () => {\r\n childWindow.document.title = title;\r\n this.renderChildWindowContents(childWindow, childWindowId, content);\r\n }, false);\r\n }\r\n\r\n window.addEventListener(\"unload\", () => {\r\n const frontStageDef = UiFramework.frontstages.activeFrontstageDef;\r\n if (frontStageDef) {\r\n this.close(childWindowId, true);\r\n }\r\n }, false);\r\n\r\n return true;\r\n }\r\n}\r\n"]}