@itwin/appui-react 4.1.0 → 4.2.0-dev.1

package/lib/cjs/appui-react/widget-panels/Frontstage.js

@@ -1,8 +1,8 @@
 "use strict";
 /*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
 /** @packageDocumentation
  * @module Frontstage
  */
@@ -66,9 +66,12 @@ function useLayoutStore() {
     }, []);
     React.useEffect(() => {
         return InternalFrontstageManager_1.InternalFrontstageManager.onFrontstageNineZoneStateChangedEvent.addListener((args) => {
-            if (args.frontstageDef !== def || def.isStageClosing || def.isApplicationClosing)
+            if (args.frontstageDef !== def ||
+                def.isStageClosing ||
+                def.isApplicationClosing)
                 return;
             (0, react_dom_1.unstable_batchedUpdates)(() => {
+                // https://github.com/pmndrs/zustand/blob/main/docs/guides/event-handler-in-pre-react-18.md
                 layout.setState(args.state || defaultNineZone);
             });
         });
@@ -125,13 +128,11 @@ function useNineZoneDispatch(frontstageDef) {
         }
         // istanbul ignore if
         if (action.type === "TOOL_SETTINGS_DRAG_START") {
-            // eslint-disable-next-line @typescript-eslint/no-floating-promises
-            UiFramework_1.UiFramework.postTelemetry("Tool Settings Undocking", "28B04E07-AE73-4533-A0BA-8E2A8DC99ADF");
+            void UiFramework_1.UiFramework.postTelemetry("Tool Settings Undocking", "28B04E07-AE73-4533-A0BA-8E2A8DC99ADF");
         }
         // istanbul ignore if
         if (action.type === "TOOL_SETTINGS_DOCK") {
-            // eslint-disable-next-line @typescript-eslint/no-floating-promises
-            UiFramework_1.UiFramework.postTelemetry("Tool Settings Docking to Settings Bar", "BEDE684B-B3DB-4637-B3AF-DC3CBA223F94");
+            void UiFramework_1.UiFramework.postTelemetry("Tool Settings Docking to Settings Bar", "BEDE684B-B3DB-4637-B3AF-DC3CBA223F94");
         }
         if (action.type === "WIDGET_TAB_POPOUT") {
             const tabId = action.id;
@@ -168,7 +169,7 @@ const defaultNineZone = (0, appui_layout_react_1.createNineZoneState)();
 const tabElement = React.createElement(Tab_1.WidgetPanelsTab, null);
 const floatingWidgetElement = React.createElement(FloatingWidget_1.FloatingWidget, null);
 /** @internal */
-function ActiveFrontstageDefProvider({ frontstageDef, layout }) {
+function ActiveFrontstageDefProvider({ frontstageDef, layout, }) {
     const dispatch = useNineZoneDispatch(frontstageDef);
     useUpdateNineZoneSize(frontstageDef);
     useSavedFrontstageState(frontstageDef);
@@ -216,7 +217,7 @@ exports.useLabels = useLabels;
 /** @internal */
 function addWidgets(state, widgets, side, widgetId) {
     var _a;
-    const visibleWidgets = widgets.filter((w) => w.isVisible && (w.defaultState !== WidgetState_1.WidgetState.Floating));
+    const visibleWidgets = widgets.filter((w) => w.isVisible && w.defaultState !== WidgetState_1.WidgetState.Floating);
     if (visibleWidgets.length === 0)
         return state;
     const tabs = new Array();
@@ -257,10 +258,17 @@ function appendWidgets(state, widgetDefs, location, section) {
     for (const widgetDef of widgetDefs) {
         const label = getWidgetLabel(widgetDef.label);
         const saveTab = state.tabs[widgetDef.id];
-        const preferredPanelWidgetSize = saveTab ? saveTab.preferredPanelWidgetSize : widgetDef.preferredPanelSize;
-        const preferredFloatingWidgetSize = saveTab ? saveTab.preferredFloatingWidgetSize : widgetDef.defaultFloatingSize;
+        const preferredPanelWidgetSize = saveTab
+            ? saveTab.preferredPanelWidgetSize
+            : widgetDef.preferredPanelSize;
+        const preferredFloatingWidgetSize = saveTab
+            ? saveTab.preferredFloatingWidgetSize
+            : widgetDef.defaultFloatingSize;
         // if a defaultFloatingSize is specified then this mean the widget can't determine its intrinsic size and must be explicitly sized
-        const userSized = saveTab ? (saveTab.userSized || !!widgetDef.defaultFloatingSize && !!saveTab.preferredFloatingWidgetSize)
+        const userSized = saveTab
+            ? saveTab.userSized ||
+                (!!widgetDef.defaultFloatingSize &&
+                    !!saveTab.preferredFloatingWidgetSize)
             : !!widgetDef.defaultFloatingSize;
         state = (0, appui_layout_react_1.addTab)(state, widgetDef.id, {
             label,
@@ -273,18 +281,30 @@ function appendWidgets(state, widgetDefs, location, section) {
             hideWithUiWhenFloating: !!widgetDef.hideWithUiWhenFloating,
             allowedPanelTargets: (_a = widgetDef.allowedPanelTargets) === null || _a === void 0 ? void 0 : _a.map((l) => (0, StagePanelDef_1.toPanelSide)(l)),
         });
-        if (widgetDef.isFloatingStateSupported && widgetDef.defaultState === WidgetState_1.WidgetState.Floating) {
+        if (widgetDef.isFloatingStateSupported &&
+            widgetDef.defaultState === WidgetState_1.WidgetState.Floating) {
             const floatingContainerId = (_b = widgetDef.floatingContainerId) !== null && _b !== void 0 ? _b : (0, appui_layout_react_1.getUniqueId)();
             const widgetContainerId = getWidgetId(location, section);
-            const home = { side, widgetId: widgetContainerId, widgetIndex: 0 };
+            const home = {
+                side,
+                widgetId: widgetContainerId,
+                widgetIndex: 0,
+            };
             const preferredPosition = widgetDef.defaultFloatingPosition;
             if (floatingContainerId in state.widgets) {
                 state = (0, appui_layout_react_1.addTabToWidget)(state, widgetDef.id, floatingContainerId);
             }
             else {
                 const tab = state.tabs[widgetDef.id];
-                const size = { height: 200, width: 300, ...tab.preferredFloatingWidgetSize };
-                const preferredPoint = preferredPosition !== null && preferredPosition !== void 0 ? preferredPosition : { x: (state.size.width - size.width) / 2, y: (state.size.height - size.height) / 2 };
+                const size = {
+                    height: 200,
+                    width: 300,
+                    ...tab.preferredFloatingWidgetSize,
+                };
+                const preferredPoint = preferredPosition !== null && preferredPosition !== void 0 ? preferredPosition : {
+                    x: (state.size.width - size.width) / 2,
+                    y: (state.size.height - size.height) / 2,
+                };
                 const nzBounds = core_react_1.Rectangle.createFromSize(state.size);
                 const bounds = core_react_1.Rectangle.createFromSize(size).offset(preferredPoint);
                 const containedBounds = bounds.containIn(nzBounds);
@@ -306,7 +326,9 @@ function appendWidgets(state, widgetDefs, location, section) {
             else {
                 const panel = state.panels[side];
                 if (panel.widgets.length < panel.maxWidgetCount) {
-                    state = (0, appui_layout_react_1.addPanelWidget)(state, side, widgetPanelSectionId, [widgetDef.id]);
+                    state = (0, appui_layout_react_1.addPanelWidget)(state, side, widgetPanelSectionId, [
+                        widgetDef.id,
+                    ]);
                 }
                 else {
                     const widgetIndex = Math.min(preferredWidgetIndex, panel.widgets.length - 1);
@@ -325,7 +347,8 @@ function processPopoutWidgets(initialState, frontstageDef) {
         return initialState;
     // istanbul ignore next - not unit testing electron case that reopens popout windows
     if (initialState.popoutWidgets && core_bentley_1.ProcessDetector.isElectronAppFrontend) {
-        if (initialState.popoutWidgets.allIds.length && core_bentley_1.ProcessDetector.isElectronAppFrontend) {
+        if (initialState.popoutWidgets.allIds.length &&
+            core_bentley_1.ProcessDetector.isElectronAppFrontend) {
             for (const widgetContainerId of initialState.popoutWidgets.allIds) {
                 frontstageDef.openPopoutWidgetContainer(initialState, widgetContainerId);
             }
@@ -462,7 +485,10 @@ function initializePanel(state, frontstageDef, location) {
             panel.maxSize = getPanelMaxSize(panelDef.maxSizeSpec, panelSide, state.size);
         }
         const size = panelDef === null || panelDef === void 0 ? void 0 : panelDef.size;
-        panel.size = size === undefined ? size : Math.min(Math.max(size, panel.minSize), panel.maxSize);
+        panel.size =
+            size === undefined
+                ? size
+                : Math.min(Math.max(size, panel.minSize), panel.maxSize);
     });
     return state;
 }
@@ -471,8 +497,10 @@ function getPanelMaxSize(maxSizeSpec, panel, nineZoneSize) {
     if (typeof maxSizeSpec === "number") {
         return maxSizeSpec;
     }
-    const size = (0, appui_layout_react_1.isHorizontalPanelSide)(panel) ? nineZoneSize.height : nineZoneSize.width;
-    return maxSizeSpec.percentage / 100 * size;
+    const size = (0, appui_layout_react_1.isHorizontalPanelSide)(panel)
+        ? nineZoneSize.height
+        : nineZoneSize.width;
+    return (maxSizeSpec.percentage / 100) * size;
 }
 const stateVersion = 13; // this needs to be bumped when NineZoneState is changed (to recreate the layout).
 /** @internal */
@@ -495,7 +523,9 @@ function initializeNineZoneState(frontstageDef) {
         var _a, _b, _c, _d;
         for (const [, panel] of Object.entries(stateDraft.panels)) {
             const expanded = panel.widgets.find((widgetId) => stateDraft.widgets[widgetId].minimized === false);
-            const firstWidget = panel.widgets.length > 0 ? stateDraft.widgets[panel.widgets[0]] : undefined;
+            const firstWidget = panel.widgets.length > 0
+                ? stateDraft.widgets[panel.widgets[0]]
+                : undefined;
             // istanbul ignore next
             if (!expanded && firstWidget) {
                 firstWidget.minimized = false;
@@ -508,7 +538,8 @@ function initializeNineZoneState(frontstageDef) {
         const toolSettingsWidgetDef = frontstageDef.toolSettings;
         if (toolSettingsWidgetDef) {
             const toolSettingsTab = stateDraft.tabs[appui_layout_react_1.toolSettingsTabId];
-            toolSettingsTab.preferredPanelWidgetSize = toolSettingsWidgetDef.preferredPanelSize;
+            toolSettingsTab.preferredPanelWidgetSize =
+                toolSettingsWidgetDef.preferredPanelSize;
         }
     });
     nineZone = addMissingWidgets(frontstageDef, nineZone);
@@ -580,7 +611,9 @@ function restoreNineZoneState(frontstageDef, saved) {
         }
         return;
     });
-    if (InternalFrontstageManager_1.InternalFrontstageManager.nineZoneSize && (0 !== InternalFrontstageManager_1.InternalFrontstageManager.nineZoneSize.height || 0 !== InternalFrontstageManager_1.InternalFrontstageManager.nineZoneSize.width)) {
+    if (InternalFrontstageManager_1.InternalFrontstageManager.nineZoneSize &&
+        (0 !== InternalFrontstageManager_1.InternalFrontstageManager.nineZoneSize.height ||
+            0 !== InternalFrontstageManager_1.InternalFrontstageManager.nineZoneSize.width)) {
         restored = FrameworkStateReducer(restored, {
             type: "RESIZE",
             size: {
@@ -792,7 +825,9 @@ function hideWidget(state, widgetDef) {
     else if (!(0, appui_layout_react_1.isPopoutTabLocation)(location)) {
         const widgetId = location.widgetId;
         const side = (0, appui_layout_react_1.isPanelTabLocation)(location) ? location.side : "left";
-        const widgetIndex = (0, appui_layout_react_1.isPanelTabLocation)(location) ? state.panels[side].widgets.indexOf(widgetId) : 0;
+        const widgetIndex = (0, appui_layout_react_1.isPanelTabLocation)(location)
+            ? state.panels[side].widgets.indexOf(widgetId)
+            : 0;
         const tabIndex = state.widgets[location.widgetId].tabs.indexOf(widgetDef.id);
         widgetDef.tabLocation = {
             side,
@@ -833,8 +868,9 @@ function expandWidget(state, id) {
         if ((0, appui_layout_react_1.isPanelTabLocation)(location)) {
             const panel = draft.panels[location.side];
             panel.splitterPercent =
-                panel.widgets.findIndex((wId) => wId === location.widgetId) === 0 ?
-                    100 : 0;
+                panel.widgets.findIndex((wId) => wId === location.widgetId) === 0
+                    ? 100
+                    : 0;
         }
         widget.minimized = false;
     });
@@ -857,7 +893,9 @@ function useSavedFrontstageState(frontstageDef) {
     const isMountedRef = React.useRef(false);
     React.useEffect(() => {
         isMountedRef.current = true;
-        return () => { isMountedRef.current = false; };
+        return () => {
+            isMountedRef.current = false;
+        };
     }, []);
     React.useEffect(() => {
         uiStateStorageRef.current = uiStateStorage;
@@ -875,7 +913,8 @@ function useSavedFrontstageState(frontstageDef) {
                 return;
             if (isFrontstageStateSettingResult(settingResult)) {
                 const setting = settingResult.setting;
-                if (setting.version >= version && setting.stateVersion >= stateVersion) {
+                if (setting.version >= version &&
+                    setting.stateVersion >= stateVersion) {
                     const restored = restoreNineZoneState(frontstageDef, setting.nineZone);
                     frontstageDef.savedWidgetDefs = setting.widgets;
                     restoreSavedWidgets(frontstageDef);
@@ -1004,7 +1043,8 @@ function useFrontstageManager(frontstageDef, useToolAsToolSettingsLabel) {
             // TODO: track restoring frontstages to support workflows:  i.e. prevent loading frontstage OR saving layout when delete is pending
             void uiSettingsStorage.deleteSetting(exports.FRONTSTAGE_SETTINGS_NAMESPACE, getFrontstageStateSettingName(args.frontstageDef.id));
             if (frontstageDef.id === args.frontstageDef.id) {
-                args.frontstageDef.nineZoneState = initializeNineZoneState(frontstageDef);
+                args.frontstageDef.nineZoneState =
+                    initializeNineZoneState(frontstageDef);
             }
             else {
                 args.frontstageDef.nineZoneState = undefined;
@@ -1032,8 +1072,9 @@ function useFrontstageManager(frontstageDef, useToolAsToolSettingsLabel) {
             var _a;
             const toolId = UiFramework_1.UiFramework.frontstages.activeToolId;
             (0, core_bentley_1.assert)(!!frontstageDef.nineZoneState);
-            const label = useToolAsToolSettingsLabel ?
-                ((_a = core_frontend_1.IModelApp.tools.find(toolId)) === null || _a === void 0 ? void 0 : _a.flyover) || defaultLabel : defaultLabel;
+            const label = useToolAsToolSettingsLabel
+                ? ((_a = core_frontend_1.IModelApp.tools.find(toolId)) === null || _a === void 0 ? void 0 : _a.flyover) || defaultLabel
+                : defaultLabel;
             frontstageDef.nineZoneState = setWidgetLabel(frontstageDef.nineZoneState, appui_layout_react_1.toolSettingsTabId, label);
         });
         // Whenever the frontstageDef or the useTool... changes, keep the label up to date.