@itwin/appui-react 3.0.0-extension.0 → 3.1.0-dev.11

package/lib/esm/appui-react/widget-panels/Frontstage.d.ts

@@ -4,7 +4,7 @@
 import "./Frontstage.scss";
 import * as React from "react";
 import { WidgetState } from "@itwin/appui-abstract";
-import { UiSettingsResult, UiSettingsStatus } from "@itwin/core-react";
+import { UiStateStorageResult, UiStateStorageStatus } from "@itwin/core-react";
 import { NineZoneDispatch, NineZoneLabels, NineZoneState, PanelSide, TabState } from "@itwin/appui-layout-react";
 import { FrontstageDef } from "../frontstage/FrontstageDef";
 import { StagePanelState, StagePanelZoneDefKeys } from "../stagepanels/StagePanelDef";
@@ -46,8 +46,8 @@ export declare function getPanelZoneWidgets(frontstageDef: FrontstageDef, panelZ
 /** @internal */
 export declare function addPanelWidgets(state: NineZoneState, frontstageDef: FrontstageDef, side: PanelSide): NineZoneState;
 /** @internal */
-export declare function isFrontstageStateSettingResult(settingsResult: UiSettingsResult): settingsResult is {
-    status: UiSettingsStatus.Success;
+export declare function isFrontstageStateSettingResult(settingsResult: UiStateStorageResult): settingsResult is {
+    status: UiStateStorageStatus.Success;
     setting: WidgetPanelsFrontstageState;
 };
 /** @internal */
@@ -62,13 +62,13 @@ export declare function initializeNineZoneState(frontstageDef: FrontstageDef): N
 export declare function restoreNineZoneState(frontstageDef: FrontstageDef, saved: SavedNineZoneState): NineZoneState;
 /** Prepares NineZoneState to be saved.
  * @note Removes toolSettings tab.
- * @note Removes tab labels.
+ * @note Removes tab labels and iconSpec.
  * @internal
  */
 export declare function packNineZoneState(state: NineZoneState): SavedNineZoneState;
 /** @internal */
 export declare function isPanelCollapsed(zoneStates: ReadonlyArray<ZoneState | undefined>, panelStates: ReadonlyArray<StagePanelState | undefined>): boolean;
-/** FrontstageState is saved in UiSettings.
+/** FrontstageState is saved in UiStateStorage.
  * @internal
  */
 export interface WidgetPanelsFrontstageState {
@@ -77,7 +77,7 @@ export interface WidgetPanelsFrontstageState {
     version: number;
     stateVersion: number;
 }
-declare type SavedTabState = Omit<TabState, "label" | "canPopout" | "isFloatingStateWindowResizable">;
+declare type SavedTabState = Omit<TabState, "label" | "canPopout" | "isFloatingStateWindowResizable" | "iconSpec">;
 interface SavedTabsState {
     readonly [id: string]: SavedTabState;
 }
@@ -193,6 +193,29 @@ export declare const setWidgetState: (base: {
         readonly [x: string]: {
             readonly id: string;
             readonly label: string;
+            readonly iconSpec?: boolean | React.ReactText | {
+                readonly type: string | React.JSXElementConstructor<any>;
+                readonly props: any;
+                readonly key: React.Key | null;
+            } | {} | {
+                readonly [Symbol.iterator]: () => Iterator<React.ReactNode, any, undefined>;
+            } | {
+                readonly key: React.Key | null;
+                readonly children: boolean | React.ReactText | {
+                    readonly type: string | React.JSXElementConstructor<any>;
+                    readonly props: any;
+                    readonly key: React.Key | null;
+                } | {} | {
+                    readonly [Symbol.iterator]: () => Iterator<React.ReactNode, any, undefined>;
+                } | any | null | undefined;
+                readonly type: string | React.JSXElementConstructor<any>;
+                readonly props: any;
+            } | {
+                readonly stringGetter: () => string;
+                readonly syncEventIds: readonly string[];
+                readonly value: string;
+                readonly refresh: () => boolean;
+            } | null | undefined;
             readonly preferredFloatingWidgetSize?: {
                 readonly width: number;
                 readonly height: number;
@@ -338,6 +361,29 @@ export declare const showWidget: (base: {
         readonly [x: string]: {
             readonly id: string;
             readonly label: string;
+            readonly iconSpec?: boolean | React.ReactText | {
+                readonly type: string | React.JSXElementConstructor<any>;
+                readonly props: any;
+                readonly key: React.Key | null;
+            } | {} | {
+                readonly [Symbol.iterator]: () => Iterator<React.ReactNode, any, undefined>;
+            } | {
+                readonly key: React.Key | null;
+                readonly children: boolean | React.ReactText | {
+                    readonly type: string | React.JSXElementConstructor<any>;
+                    readonly props: any;
+                    readonly key: React.Key | null;
+                } | {} | {
+                    readonly [Symbol.iterator]: () => Iterator<React.ReactNode, any, undefined>;
+                } | any | null | undefined;
+                readonly type: string | React.JSXElementConstructor<any>;
+                readonly props: any;
+            } | {
+                readonly stringGetter: () => string;
+                readonly syncEventIds: readonly string[];
+                readonly value: string;
+                readonly refresh: () => boolean;
+            } | null | undefined;
             readonly preferredFloatingWidgetSize?: {
                 readonly width: number;
                 readonly height: number;
@@ -483,6 +529,29 @@ export declare const expandWidget: (base: {
         readonly [x: string]: {
             readonly id: string;
             readonly label: string;
+            readonly iconSpec?: boolean | React.ReactText | {
+                readonly type: string | React.JSXElementConstructor<any>;
+                readonly props: any;
+                readonly key: React.Key | null;
+            } | {} | {
+                readonly [Symbol.iterator]: () => Iterator<React.ReactNode, any, undefined>;
+            } | {
+                readonly key: React.Key | null;
+                readonly children: boolean | React.ReactText | {
+                    readonly type: string | React.JSXElementConstructor<any>;
+                    readonly props: any;
+                    readonly key: React.Key | null;
+                } | {} | {
+                    readonly [Symbol.iterator]: () => Iterator<React.ReactNode, any, undefined>;
+                } | any | null | undefined;
+                readonly type: string | React.JSXElementConstructor<any>;
+                readonly props: any;
+            } | {
+                readonly stringGetter: () => string;
+                readonly syncEventIds: readonly string[];
+                readonly value: string;
+                readonly refresh: () => boolean;
+            } | null | undefined;
             readonly preferredFloatingWidgetSize?: {
                 readonly width: number;
                 readonly height: number;
@@ -628,6 +697,29 @@ export declare const setWidgetLabel: (base: {
         readonly [x: string]: {
             readonly id: string;
             readonly label: string;
+            readonly iconSpec?: boolean | React.ReactText | {
+                readonly type: string | React.JSXElementConstructor<any>;
+                readonly props: any;
+                readonly key: React.Key | null;
+            } | {} | {
+                readonly [Symbol.iterator]: () => Iterator<React.ReactNode, any, undefined>;
+            } | {
+                readonly key: React.Key | null;
+                readonly children: boolean | React.ReactText | {
+                    readonly type: string | React.JSXElementConstructor<any>;
+                    readonly props: any;
+                    readonly key: React.Key | null;
+                } | {} | {
+                    readonly [Symbol.iterator]: () => Iterator<React.ReactNode, any, undefined>;
+                } | any | null | undefined;
+                readonly type: string | React.JSXElementConstructor<any>;
+                readonly props: any;
+            } | {
+                readonly stringGetter: () => string;
+                readonly syncEventIds: readonly string[];
+                readonly value: string;
+                readonly refresh: () => boolean;
+            } | null | undefined;
             readonly preferredFloatingWidgetSize?: {
                 readonly width: number;
                 readonly height: number;
@@ -677,8 +769,6 @@ export declare function useFrontstageManager(frontstageDef: FrontstageDef): void
 /** @internal */
 export declare function useItemsManager(frontstageDef: FrontstageDef): void;
 /** @internal */
-export declare function useSyncDefinitions(frontstageDef: FrontstageDef): void;
-/** @internal */
 export declare function saveFrontstagePopoutWidgetSizeAndPosition(state: NineZoneState, stageId: string, stageVersion: number, childWindowId: string, childWindow: Window): Promise<NineZoneState>;
 export {};
 //# sourceMappingURL=Frontstage.d.ts.map

package/lib/esm/appui-react/widget-panels/Frontstage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Frontstage.d.ts","sourceRoot":"","sources":["../../../../src/appui-react/widget-panels/Frontstage.tsx"],"names":[],"mappings":"AAKA;;GAEG;AAIH,OAAO,mBAAmB,CAAC;AAE3B,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAsC,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACxF,OAAO,EAAmB,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACxF,OAAO,EAGiD,gBAAgB,EAAE,cAAc,EAAE,aAAa,EAC/E,SAAS,EAAqC,QAAQ,EAC7E,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,aAAa,EAAgE,MAAM,6BAA6B,CAAC;AAG1H,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAGtF,OAAO,EAAE,SAAS,EAAgD,MAAM,sBAAsB,CAAC;AAC/F,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAmC7C,gBAAgB;AAChB,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,aAAa,6BAmB5D;AAcD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,aAAa,QAejE;AAsBD,gBAAgB;AAChB,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,aAAa,oBA8B/D;AAED,gBAAgB;AAChB,eAAO,MAAM,sBAAsB,oCAqBjC,CAAC;AAKH,gBAAgB;AAChB,wBAAgB,2BAA2B,CAAC,EAAE,aAAa,EAAE,EAAE;IAAE,aAAa,EAAE,aAAa,CAAA;CAAE,eA8B9F;AAED,gBAAgB;AAChB,wBAAgB,SAAS,mBAYxB;AAED,gBAAgB;AAChB,wBAAgB,UAAU,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,aAAa,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,GAAG,aAAa,CAwB3I;AAED,gBAAgB;AAEhB,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,aAAa,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,GAAG,aAAa,CAyDtJ;AAoBD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,GAAG,aAAa,CA4B1G;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,GAAG,aAAa,CAY7G;AAMD,aAAK,aAAa,GAChB,WAAW,GACX,YAAY,GACZ,SAAS,GACT,YAAY,GACZ,aAAa,GACb,UAAU,GACV,UAAU,GACV,QAAQ,GACR,aAAa,GACb,WAAW,CAAC;AAed,gBAAgB;AAChB,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,qBAAqB,GAAG,aAAa,CA8BtF;AAUD,gBAAgB;AAChB,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,aAAa,EAAE,SAAS,EAAE,aAAa,GAAG,SAAS,EAAE,CA+DvG;AAED,gBAAgB;AAChB,wBAAgB,eAAe,CAC7B,KAAK,EAAE,aAAa,EACpB,aAAa,EAAE,aAAa,EAC5B,IAAI,EAAE,SAAS,GACd,aAAa,CAef;AAED,gBAAgB;AAChB,wBAAgB,8BAA8B,CAAC,cAAc,EAAE,gBAAgB,GAAG,cAAc,IAAI;IAClG,MAAM,EAAE,gBAAgB,CAAC,OAAO,CAAC;IACjC,OAAO,EAAE,2BAA2B,CAAC;CACtC,CAIA;AAED,gBAAgB;AAChB,wBAAgB,eAAe,CAAC,QAAQ,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,iBAe1G;AAYD,gBAAgB;AAChB,wBAAgB,uBAAuB,CAAC,aAAa,EAAE,aAAa,GAAG,aAAa,CAgDnF;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,aAAa,EAAE,KAAK,EAAE,kBAAkB,GAAG,aAAa,CAmC3G;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,GAAG,kBAAkB,CAmB1E;AAED,gBAAgB;AAChB,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,aAAa,CAAC,SAAS,GAAG,SAAS,CAAC,EAAE,WAAW,EAAE,aAAa,CAAC,eAAe,GAAG,SAAS,CAAC,WAIzI;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,EAAE,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;CACtB;AAGD,aAAK,aAAa,GAAG,IAAI,CAAC,QAAQ,EAAE,OAAO,GAAG,WAAW,GAAG,gCAAgC,CAAC,CAAC;AAE9F,UAAU,cAAc;IACtB,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,aAAa,CAAC;CACtC;AASD,UAAU,kBAAmB,SAAQ,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC;IAC9D,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;CAE/B;AAgCD,gBAAgB;AAChB,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0GAoDzB,CAAC;AAEH,gBAAgB;AAChB,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4EAerB,CAAC;AAEH,gBAAgB;AAChB,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4EAgBvB,CAAC;AAEH,gBAAgB;AAChB,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2FAMzB,CAAC;AAEH,gBAAgB;AAChB,wBAAgB,uBAAuB,CAAC,aAAa,EAAE,aAAa,QA6BnE;AAED,gBAAgB;AAChB,wBAAgB,yBAAyB,CAAC,aAAa,EAAE,aAAa,QAuBrE;AAED,gBAAgB;AAChB,eAAO,MAAM,6BAA6B,4BAA4B,CAAC;AAEvE,gBAAgB;AAChB,wBAAgB,6BAA6B,CAAC,YAAY,EAAE,2BAA2B,CAAC,IAAI,CAAC,UAE5F;AA2BD,gBAAgB;AAChB,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,aAAa,QA4DhE;AAED,gBAAgB;AAEhB,wBAAgB,eAAe,CAAC,aAAa,EAAE,aAAa,QAqB3D;AAkBD,gBAAgB;AAChB,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,aAAa,QA4C9D;AAED,gBAAgB;AAChB,wBAAsB,yCAAyC,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,0BA4BtK"}
+{"version":3,"file":"Frontstage.d.ts","sourceRoot":"","sources":["../../../../src/appui-react/widget-panels/Frontstage.tsx"],"names":[],"mappings":"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"}

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

@@ -2,6 +2,7 @@
 * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
 * See LICENSE.md in the project root for license terms and full copyright notice.
 *--------------------------------------------------------------------------------------------*/
+/* eslint-disable deprecation/deprecation */
 /** @packageDocumentation
  * @module Frontstage
  */
@@ -11,13 +12,13 @@ import produce, { castDraft } from "immer";
 import * as React from "react";
 import { assert, Logger, ProcessDetector } from "@itwin/core-bentley";
 import { StagePanelLocation, UiItemsManager, WidgetState } from "@itwin/appui-abstract";
-import { Size, UiSettingsStatus } from "@itwin/core-react";
+import { Size, UiStateStorageStatus } from "@itwin/core-react";
 import { addPanelWidget, addTab, addWidgetTabToFloatingPanel, convertAllPopupWidgetContainersToFloating, createNineZoneState, createTabsState, createTabState, createWidgetState, findTab, findWidget, floatingWidgetBringToFront, FloatingWidgets, getUniqueId, isFloatingLocation, isHorizontalPanelSide, NineZone, NineZoneStateReducer, panelSides, removeTab, toolSettingsTabId, WidgetPanels, } from "@itwin/appui-layout-react";
 import { useActiveFrontstageDef } from "../frontstage/Frontstage";
 import { FrontstageManager } from "../frontstage/FrontstageManager";
 import { StagePanelState } from "../stagepanels/StagePanelDef";
 import { UiFramework } from "../UiFramework";
-import { useUiSettingsStorageContext } from "../uisettings/useUiSettings";
+import { useUiStateStorageHandler } from "../uistate/useUiStateStorage";
 import { ZoneState } from "../zones/ZoneDef";
 import { WidgetContent } from "./Content";
 import { WidgetPanelsFrontstageContent } from "./FrontstageContent";
@@ -27,6 +28,7 @@ import { WidgetPanelsTab } from "./Tab";
 import { WidgetPanelsToolbars } from "./Toolbars";
 import { ToolSettingsContent, WidgetPanelsToolSettings } from "./ToolSettings";
 import { useEscapeSetFocusToHome } from "../hooks/useEscapeSetFocusToHome";
+import { useSelector } from "react-redux";
 const panelZoneKeys = ["start", "middle", "end"];
 // istanbul ignore next
 const WidgetPanelsFrontstageComponent = React.memo(function WidgetPanelsFrontstageComponent() {
@@ -56,10 +58,7 @@ export function useNineZoneState(frontstageDef) {
                 return;
             setNineZone(args.state);
         };
-        FrontstageManager.onFrontstageNineZoneStateChangedEvent.addListener(listener);
-        return () => {
-            FrontstageManager.onFrontstageNineZoneStateChangedEvent.removeListener(listener);
-        };
+        return FrontstageManager.onFrontstageNineZoneStateChangedEvent.addListener(listener);
     }, [frontstageDef]);
     return lastFrontstageDef.current === frontstageDef ? nineZone : frontstageDef.nineZoneState;
 }
@@ -173,11 +172,14 @@ export function ActiveFrontstageDefProvider({ frontstageDef }) {
     useSaveFrontstageSettings(frontstageDef);
     useFrontstageManager(frontstageDef);
     useItemsManager(frontstageDef);
-    useSyncDefinitions(frontstageDef);
     const labels = useLabels();
+    const showWidgetIcon = useSelector((state) => {
+        const frameworkState = state[UiFramework.frameworkStateKey];
+        return !!frameworkState.configurableUiState.showWidgetIcon;
+    });
     const handleKeyDown = useEscapeSetFocusToHome();
     return (React.createElement("div", { className: "uifw-widgetPanels-frontstage", onKeyDown: handleKeyDown, role: "presentation" },
-        React.createElement(NineZone, { dispatch: dispatch, labels: labels, state: nineZone, tab: tabElement, toolSettingsContent: toolSettingsContent, widgetContent: widgetContent }, widgetPanelsFrontstage)));
+        React.createElement(NineZone, { dispatch: dispatch, labels: labels, state: nineZone, tab: tabElement, showWidgetIcon: showWidgetIcon, toolSettingsContent: toolSettingsContent, widgetContent: widgetContent }, widgetPanelsFrontstage)));
 }
 /** @internal */
 export function useLabels() {
@@ -195,25 +197,29 @@ export function useLabels() {
 }
 /** @internal */
 export function addWidgets(state, widgets, side, widgetId) {
-    if (widgets.length === 0)
+    const visibleWidgets = widgets.filter((w) => w.isVisible && (w.defaultState !== WidgetState.Floating));
+    if (visibleWidgets.length === 0)
         return state;
     const tabs = new Array();
-    for (const widget of widgets) {
+    for (const widget of visibleWidgets) {
         const label = getWidgetLabel(widget.label);
         state = addTab(state, widget.id, {
             label,
+            iconSpec: widget.iconSpec,
             preferredPanelWidgetSize: widget.preferredPanelSize,
             canPopout: widget.canPopout,
             isFloatingStateWindowResizable: widget.isFloatingStateWindowResizable,
         });
         tabs.push(widget.id);
     }
-    const activeWidget = widgets.find((widget) => widget.isActive);
+    const activeWidget = visibleWidgets.find((widget) => widget.isActive);
     const minimized = !activeWidget;
-    state = addPanelWidget(state, side, widgetId, tabs, {
-        activeTabId: activeWidget ? activeWidget.id : tabs[0],
-        minimized,
-    });
+    if ((activeWidget === null || activeWidget === void 0 ? void 0 : activeWidget.defaultState) !== WidgetState.Floating) {
+        state = addPanelWidget(state, side, widgetId, tabs, {
+            activeTabId: activeWidget ? activeWidget.id : tabs[0],
+            minimized,
+        });
+    }
     return state;
 }
 /** @internal */
@@ -233,6 +239,7 @@ export function appendWidgets(state, widgetDefs, side, preferredWidgetIndex) {
         const userSized = saveTab ? saveTab.userSized : undefined;
         state = addTab(state, widgetDef.id, {
             label,
+            iconSpec: widgetDef.iconSpec,
             canPopout: widgetDef.canPopout,
             preferredPanelWidgetSize,
             preferredFloatingWidgetSize,
@@ -318,6 +325,21 @@ export function addMissingWidgets(frontstageDef, initialState) {
     state = appendWidgets(state, determineNewWidgets((_v = frontstageDef.bottomPanel) === null || _v === void 0 ? void 0 : _v.panelZones.end.widgetDefs, initialState), "bottom", 1);
     return state;
 }
+/** Removes widgets with Hidden defaultState. */
+function removeHiddenWidgets(state, frontstageDef) {
+    const tabs = Object.values(state.tabs);
+    for (const tab of tabs) {
+        const widgetDef = frontstageDef.findWidgetDef(tab.id);
+        if (!widgetDef)
+            continue;
+        if (widgetDef.defaultState === WidgetState.Hidden) {
+            state = produce(state, (draft) => {
+                hideWidget(draft, widgetDef);
+            });
+        }
+    }
+    return state;
+}
 /** Removes NineZoneState widgets that are missing in frontstageDef.
  * @internal
  */
@@ -472,7 +494,7 @@ export function addPanelWidgets(state, frontstageDef, side) {
 }
 /** @internal */
 export function isFrontstageStateSettingResult(settingsResult) {
-    if (settingsResult.status === UiSettingsStatus.Success)
+    if (settingsResult.status === UiStateStorageStatus.Success)
         return true;
     return false;
 }
@@ -549,6 +571,9 @@ export function initializeNineZoneState(frontstageDef) {
             toolSettingsTab.preferredPanelWidgetSize = toolSettingsWidgetDef.preferredPanelSize;
         }
     });
+    nineZone = addMissingWidgets(frontstageDef, nineZone);
+    nineZone = removeHiddenWidgets(nineZone, frontstageDef);
+    nineZone = processPopoutWidgets(nineZone, frontstageDef);
     return nineZone;
 }
 /** Converts from saved NineZoneState to NineZoneState.
@@ -576,13 +601,14 @@ export function restoreNineZoneState(frontstageDef, saved) {
             draft.tabs[tab.id] = {
                 ...tab,
                 label: getWidgetLabel((_a = widgetDef === null || widgetDef === void 0 ? void 0 : widgetDef.label) !== null && _a !== void 0 ? _a : "undefined"),
+                iconSpec: widgetDef === null || widgetDef === void 0 ? void 0 : widgetDef.iconSpec,
                 canPopout: widgetDef === null || widgetDef === void 0 ? void 0 : widgetDef.canPopout,
                 isFloatingStateWindowResizable: widgetDef === null || widgetDef === void 0 ? void 0 : widgetDef.isFloatingStateWindowResizable,
             };
         }
         return;
     });
-    if (FrontstageManager.nineZoneSize) {
+    if (FrontstageManager.nineZoneSize && (0 !== FrontstageManager.nineZoneSize.height || 0 !== FrontstageManager.nineZoneSize.width)) {
         restored = FrameworkStateReducer(restored, {
             type: "RESIZE",
             size: {
@@ -595,7 +621,7 @@ export function restoreNineZoneState(frontstageDef, saved) {
 }
 /** Prepares NineZoneState to be saved.
  * @note Removes toolSettings tab.
- * @note Removes tab labels.
+ * @note Removes tab labels and iconSpec.
  * @internal
  */
 export function packNineZoneState(state) {
@@ -657,9 +683,9 @@ function addRemovedTab(nineZone, widgetDef) {
 }
 /** @internal */
 export const setWidgetState = produce((nineZone, widgetDef, state) => {
-    const id = widgetDef.id;
-    let location = findTab(nineZone, id);
     if (state === WidgetState.Open) {
+        const id = widgetDef.id;
+        let location = findTab(nineZone, id);
         if (!location) {
             addRemovedTab(nineZone, widgetDef);
             location = findTab(nineZone, id);
@@ -670,6 +696,8 @@ export const setWidgetState = produce((nineZone, widgetDef, state) => {
         widget.activeTabId = id;
     }
     else if (state === WidgetState.Closed) {
+        const id = widgetDef.id;
+        let location = findTab(nineZone, id);
         if (!location) {
             addRemovedTab(nineZone, widgetDef);
             location = findTab(nineZone, id);
@@ -692,21 +720,26 @@ export const setWidgetState = produce((nineZone, widgetDef, state) => {
         }
     }
     else if (state === WidgetState.Hidden) {
-        if (!location)
-            return;
-        const widgetId = location.widgetId;
-        const side = "side" in location ? location.side : "left";
-        const widgetIndex = "side" in location ? nineZone.panels[side].widgets.indexOf(widgetId) : 0;
-        const tabIndex = nineZone.widgets[location.widgetId].tabs.indexOf(id);
-        widgetDef.tabLocation = {
-            side,
-            tabIndex,
-            widgetId,
-            widgetIndex,
-        };
-        removeTab(nineZone, id);
+        hideWidget(nineZone, widgetDef);
     }
 });
+/** Stores widget location and hides it in the UI. */
+function hideWidget(state, widgetDef) {
+    const location = findTab(state, widgetDef.id);
+    if (!location)
+        return;
+    const widgetId = location.widgetId;
+    const side = "side" in location ? location.side : "left";
+    const widgetIndex = "side" in location ? state.panels[side].widgets.indexOf(widgetId) : 0;
+    const tabIndex = state.widgets[location.widgetId].tabs.indexOf(widgetDef.id);
+    widgetDef.tabLocation = {
+        side,
+        tabIndex,
+        widgetId,
+        widgetIndex,
+    };
+    removeTab(state, widgetDef.id);
+}
 /** @internal */
 export const showWidget = produce((nineZone, id) => {
     const location = findTab(nineZone, id);
@@ -751,11 +784,16 @@ export const setWidgetLabel = produce((nineZone, id, label) => {
 });
 /** @internal */
 export function useSavedFrontstageState(frontstageDef) {
-    const uiSettingsStorage = useUiSettingsStorageContext();
-    const uiSettingsRef = React.useRef(uiSettingsStorage);
+    const uiStateStorage = useUiStateStorageHandler();
+    const uiStateStorageRef = React.useRef(uiStateStorage);
+    const isMountedRef = React.useRef(false);
+    React.useEffect(() => {
+        isMountedRef.current = true;
+        return () => { isMountedRef.current = false; };
+    }, []);
     React.useEffect(() => {
-        uiSettingsRef.current = uiSettingsStorage;
-    }, [uiSettingsStorage]);
+        uiStateStorageRef.current = uiStateStorage;
+    }, [uiStateStorage]);
     React.useEffect(() => {
         async function fetchFrontstageState() {
             if (frontstageDef.nineZoneState) {
@@ -764,17 +802,20 @@ export function useSavedFrontstageState(frontstageDef) {
             }
             const id = frontstageDef.id;
             const version = frontstageDef.version;
-            const settingsResult = await uiSettingsRef.current.getSetting(FRONTSTAGE_SETTINGS_NAMESPACE, getFrontstageStateSettingName(id));
-            if (isFrontstageStateSettingResult(settingsResult) &&
-                settingsResult.setting.version >= version &&
-                settingsResult.setting.stateVersion >= stateVersion) {
-                const restored = restoreNineZoneState(frontstageDef, settingsResult.setting.nineZone);
-                let state = addMissingWidgets(frontstageDef, restored);
-                state = processPopoutWidgets(state, frontstageDef);
-                frontstageDef.nineZoneState = state;
-                return;
+            const settingsResult = await uiStateStorageRef.current.getSetting(FRONTSTAGE_SETTINGS_NAMESPACE, getFrontstageStateSettingName(id));
+            if (isMountedRef.current) {
+                if (isFrontstageStateSettingResult(settingsResult) &&
+                    settingsResult.setting.version >= version &&
+                    settingsResult.setting.stateVersion >= stateVersion) {
+                    const restored = restoreNineZoneState(frontstageDef, settingsResult.setting.nineZone);
+                    let state = addMissingWidgets(frontstageDef, restored);
+                    state = removeHiddenWidgets(state, frontstageDef);
+                    state = processPopoutWidgets(state, frontstageDef);
+                    frontstageDef.nineZoneState = state;
+                    return;
+                }
+                frontstageDef.nineZoneState = initializeNineZoneState(frontstageDef);
             }
-            frontstageDef.nineZoneState = initializeNineZoneState(frontstageDef);
         }
         fetchFrontstageState(); // eslint-disable-line @typescript-eslint/no-floating-promises
     }, [frontstageDef]);
@@ -782,7 +823,7 @@ export function useSavedFrontstageState(frontstageDef) {
 /** @internal */
 export function useSaveFrontstageSettings(frontstageDef) {
     const nineZone = useNineZoneState(frontstageDef);
-    const uiSettingsStorage = useUiSettingsStorageContext();
+    const uiSettingsStorage = useUiStateStorageHandler();
     // eslint-disable-next-line react-hooks/exhaustive-deps
     const saveSetting = React.useCallback(debounce(async (id, version, state) => {
         const setting = {
@@ -867,7 +908,7 @@ export function useFrontstageManager(frontstageDef) {
             FrontstageManager.onWidgetExpandEvent.removeListener(listener);
         };
     }, [frontstageDef]);
-    const uiSettingsStorage = useUiSettingsStorageContext();
+    const uiSettingsStorage = useUiStateStorageHandler();
     React.useEffect(() => {
         const listener = (args) => {
             // TODO: track restoring frontstages to support workflows:  i.e. prevent loading frontstage OR saving layout when delete is pending
@@ -907,6 +948,7 @@ export function useItemsManager(frontstageDef) {
             return;
         state = addMissingWidgets(def, state);
         state = removeMissingWidgets(def, state);
+        state = removeHiddenWidgets(state, def); // TODO: should only apply to widgets provided by registered provider in onUiProviderRegisteredEvent.
         def.nineZoneState = state;
     };
     React.useEffect(() => {
@@ -934,52 +976,6 @@ function determineNewWidgets(defs, state) {
     return (defs || []).filter((def) => !(def.id in state.tabs) || !tabShownInCurrentWidget(def, state));
 }
 /** @internal */
-export function useSyncDefinitions(frontstageDef) {
-    const nineZone = useNineZoneState(frontstageDef);
-    React.useEffect(() => {
-        if (!nineZone)
-            return;
-        for (const panelSide of panelSides) {
-            const panel = nineZone.panels[panelSide];
-            const location = toStagePanelLocation(panelSide);
-            const panelDef = frontstageDef.getStagePanelDef(location);
-            if (panelDef) {
-                panelDef.size = panel.size;
-                let newState = panel.collapsed ? StagePanelState.Minimized : StagePanelState.Open;
-                if (panelDef.panelState === StagePanelState.Off && newState === StagePanelState.Minimized)
-                    newState = StagePanelState.Off;
-                panelDef.panelState = newState;
-            }
-            for (const widgetId of panel.widgets) {
-                const widget = nineZone.widgets[widgetId];
-                // istanbul ignore else
-                if (widget) {
-                    for (const tabId of widget.tabs) {
-                        const widgetDef = frontstageDef.findWidgetDef(tabId);
-                        let widgetState = WidgetState.Open;
-                        if (widget.minimized || tabId !== widget.activeTabId)
-                            widgetState = WidgetState.Closed;
-                        widgetDef && widgetDef.setWidgetState(widgetState);
-                    }
-                }
-            }
-        }
-        for (const widgetId of nineZone.floatingWidgets.allIds) {
-            const widget = nineZone.widgets[widgetId];
-            // istanbul ignore else
-            if (widget) {
-                for (const tabId of widget.tabs) {
-                    const widgetDef = frontstageDef.findWidgetDef(tabId);
-                    let widgetState = WidgetState.Open;
-                    if (widget.minimized || tabId !== widget.activeTabId)
-                        widgetState = WidgetState.Closed;
-                    widgetDef && widgetDef.setWidgetState(widgetState);
-                }
-            }
-        }
-    }, [nineZone, frontstageDef]);
-}
-/** @internal */
 export async function saveFrontstagePopoutWidgetSizeAndPosition(state, stageId, stageVersion, childWindowId, childWindow) {
     const location = findWidget(state, childWindowId);
     // istanbul ignore else
@@ -1002,7 +998,7 @@ export async function saveFrontstagePopoutWidgetSizeAndPosition(state, stageId,
             stateVersion,
             version: stageVersion,
         };
-        await UiFramework.getUiSettingsStorage().saveSetting(FRONTSTAGE_SETTINGS_NAMESPACE, getFrontstageStateSettingName(stageId), setting);
+        await UiFramework.getUiStateStorage().saveSetting(FRONTSTAGE_SETTINGS_NAMESPACE, getFrontstageStateSettingName(stageId), setting);
         return newState;
     }
     // istanbul ignore next