@itwin/appui-react 4.9.0-dev.1 → 4.9.0

package/lib/esm/appui-react/layout/state/internal/TabStateHelpers.js

@@ -0,0 +1,184 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Base
+ */
+import produce, { castDraft } from "immer";
+import { UiError } from "@itwin/appui-abstract";
+import { category } from "./NineZoneStateHelpers";
+import { getTabLocation } from "../TabLocation";
+import { addFloatingWidget, assertWidgetState, getWidgetState, removeWidget, setWidgetActiveTabId, updateWidgetState, } from "./WidgetStateHelpers";
+import { isFloatingWidgetRestoreState } from "../WidgetRestoreState";
+import { Rectangle } from "@itwin/core-react";
+import { getUniqueId } from "../../base/NineZone";
+import { insertPanelWidget } from "./PanelStateHelpers";
+/** @internal */
+export function createTabState(id, args) {
+    return {
+        label: "",
+        ...args,
+        id,
+        unloaded: false,
+    };
+}
+/** @internal */
+export function createDraggedTabState(tabId, args) {
+    return {
+        home: {
+            side: "left",
+            widgetId: "",
+            widgetIndex: 0,
+        },
+        position: { x: 0, y: 0 },
+        ...args,
+        tabId,
+    };
+}
+/** @internal */
+export function updateTabState(state, id, update) {
+    // eslint-disable-next-line deprecation/deprecation
+    if (!(id in state.tabs))
+        throw new UiError(category, "Tab does not exist");
+    return produce(state, (draft) => {
+        const tab = draft.tabs[id];
+        update(tab);
+    });
+}
+/** @internal */
+export function updateSavedTabState(state, id, update) {
+    return produce(state, (draft) => {
+        const allIds = draft.savedTabs.allIds;
+        const byId = draft.savedTabs.byId;
+        let tab = byId[id];
+        if (!tab) {
+            allIds.push(id);
+            tab = byId[id] = { id };
+        }
+        else {
+            const index = allIds.indexOf(id);
+            allIds.splice(index, 1);
+            allIds.push(id);
+        }
+        update(tab);
+    });
+}
+/** Adds a new `tab`.
+ * @internal
+ */
+export function addTab(state, id, tabArgs) {
+    if (id in state.tabs)
+        throw new UiError(category, "Tab already exists");
+    const tab = {
+        ...createTabState(id),
+        ...tabArgs,
+    };
+    return produce(state, (stateDraft) => {
+        stateDraft.tabs[id] = castDraft(tab);
+    });
+}
+/** Adds an existing `tab` to a specified `widget`.
+ * @internal
+ */
+export function addTabToWidget(state, tabId, widgetId) {
+    return insertTabToWidget(state, tabId, widgetId, Infinity);
+}
+/** Inserts an existing `tab` to a specified `widget` at a specified `tabIndex`.
+ * @internal
+ */
+export function insertTabToWidget(state, tabId, widgetId, tabIndex) {
+    if (!(tabId in state.tabs))
+        throw new UiError(category, "Tab does not exist", undefined, () => ({
+            tabId,
+        }));
+    assertWidgetState(state, widgetId);
+    const location = getTabLocation(state, tabId);
+    if (location)
+        throw new UiError(category, "Tab is already in a widget", undefined, () => ({ tabId, widgetId: location.widgetId }));
+    return produce(state, (draft) => {
+        const widget = getWidgetState(draft, widgetId);
+        widget.tabs.splice(tabIndex, 0, tabId);
+    });
+}
+/** Removes tab from the UI, but keeps the tab state.
+ * @internal
+ */
+export function removeTabFromWidget(state, tabId) {
+    const location = getTabLocation(state, tabId);
+    if (!location)
+        return state;
+    const widgetId = location.widgetId;
+    const widget = getWidgetState(state, widgetId);
+    const tabs = [...widget.tabs];
+    const tabIndex = tabs.indexOf(tabId);
+    tabs.splice(tabIndex, 1);
+    if (tabs.length === 0) {
+        return removeWidget(state, widgetId);
+    }
+    if (tabId === widget.activeTabId) {
+        state = setWidgetActiveTabId(state, widget.id, tabs[0]);
+    }
+    return updateWidgetState(state, widgetId, {
+        tabs,
+    });
+}
+/** Removes tab from the UI and deletes the tab state.
+ * @internal
+ */
+export function removeTab(state, tabId) {
+    if (!(tabId in state.tabs))
+        throw new UiError(category, "Tab does not exist");
+    state = removeTabFromWidget(state, tabId);
+    return produce(state, (draft) => {
+        var _a;
+        delete draft.tabs[tabId];
+        if (((_a = draft.toolSettings) === null || _a === void 0 ? void 0 : _a.tabId) === tabId) {
+            draft.toolSettings = undefined;
+        }
+    });
+}
+const defaultHomeState = {
+    side: "left",
+    widgetId: "",
+    widgetIndex: 0,
+    tabIndex: 0,
+};
+/** Adds removed tab to the UI.
+ * @internal
+ */
+export function addRemovedTab(state, tabId) {
+    if (!(tabId in state.tabs))
+        throw new UiError(category, "Tab does not exist", undefined, () => ({
+            tabId,
+        }));
+    const savedTab = state.savedTabs.byId[tabId];
+    const home = (savedTab === null || savedTab === void 0 ? void 0 : savedTab.home) || defaultHomeState;
+    const { tabIndex, widgetId } = home;
+    // Add to an existing widget (by widget id).
+    if (widgetId in state.widgets) {
+        return insertTabToWidget(state, tabId, widgetId, tabIndex);
+    }
+    // Add to a floating widget.
+    if (isFloatingWidgetRestoreState(home)) {
+        // Add to a new floating widget.
+        const nzBounds = Rectangle.createFromSize(state.size);
+        const bounds = Rectangle.create(home.floatingWidget.bounds).containIn(nzBounds);
+        return addFloatingWidget(state, widgetId, [tabId], {
+            ...home.floatingWidget,
+            bounds: bounds.toProps(),
+        });
+    }
+    // Add to a panel section.
+    const panel = state.panels[home.side];
+    // Add to existing panel section.
+    if (panel.widgets.length >= panel.maxWidgetCount) {
+        const sectionIndex = Math.min(panel.maxWidgetCount - 1, home.widgetIndex);
+        const sectionId = panel.widgets[sectionIndex];
+        return insertTabToWidget(state, tabId, sectionId, home.tabIndex);
+    }
+    // Create a new panel section.
+    const newSectionId = getUniqueId();
+    return insertPanelWidget(state, panel.side, newSectionId, [tabId], home.widgetIndex);
+}
+//# sourceMappingURL=TabStateHelpers.js.map

package/lib/esm/appui-react/layout/state/internal/TabStateHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TabStateHelpers.js","sourceRoot":"","sources":["../../../../../../src/appui-react/layout/state/internal/TabStateHelpers.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Base\n */\n\nimport produce, { castDraft } from \"immer\";\nimport { UiError } from \"@itwin/appui-abstract\";\nimport type { NineZoneState } from \"../NineZoneState\";\nimport type { DraggedTabState, TabState } from \"../TabState\";\nimport { category } from \"./NineZoneStateHelpers\";\nimport type { SavedTabState, TabHomeState } from \"../SavedTabState\";\nimport type { WritableDraft } from \"immer/dist/internal\";\nimport { getTabLocation } from \"../TabLocation\";\nimport {\n  addFloatingWidget,\n  assertWidgetState,\n  getWidgetState,\n  removeWidget,\n  setWidgetActiveTabId,\n  updateWidgetState,\n} from \"./WidgetStateHelpers\";\nimport type { WidgetState } from \"../WidgetState\";\nimport { isFloatingWidgetRestoreState } from \"../WidgetRestoreState\";\nimport { Rectangle } from \"@itwin/core-react\";\nimport { getUniqueId } from \"../../base/NineZone\";\nimport { insertPanelWidget } from \"./PanelStateHelpers\";\n\n/** @internal */\nexport function createTabState(\n  id: TabState[\"id\"],\n  args?: Partial<TabState>\n): TabState {\n  return {\n    label: \"\",\n    ...args,\n    id,\n    unloaded: false,\n  };\n}\n\n/** @internal */\nexport function createDraggedTabState(\n  tabId: DraggedTabState[\"tabId\"],\n  args?: Partial<DraggedTabState>\n): DraggedTabState {\n  return {\n    home: {\n      side: \"left\",\n      widgetId: \"\",\n      widgetIndex: 0,\n    },\n    position: { x: 0, y: 0 },\n    ...args,\n    tabId,\n  };\n}\n\n/** @internal */\nexport function updateTabState(\n  state: NineZoneState,\n  id: TabState[\"id\"],\n  update: (draft: WritableDraft<TabState>) => void\n) {\n  // eslint-disable-next-line deprecation/deprecation\n  if (!(id in state.tabs)) throw new UiError(category, \"Tab does not exist\");\n\n  return produce(state, (draft) => {\n    const tab = draft.tabs[id];\n    update(tab);\n  });\n}\n\n/** @internal */\nexport function updateSavedTabState(\n  state: NineZoneState,\n  id: TabState[\"id\"],\n  update: (draft: WritableDraft<SavedTabState>) => void\n) {\n  return produce(state, (draft) => {\n    const allIds = draft.savedTabs.allIds;\n    const byId = draft.savedTabs.byId;\n    let tab = byId[id];\n    if (!tab) {\n      allIds.push(id);\n      tab = byId[id] = { id };\n    } else {\n      const index = allIds.indexOf(id);\n      allIds.splice(index, 1);\n      allIds.push(id);\n    }\n\n    update(tab);\n  });\n}\n\n/** Adds a new `tab`.\n * @internal\n */\nexport function addTab(\n  state: NineZoneState,\n  id: TabState[\"id\"],\n  tabArgs?: Partial<TabState>\n): NineZoneState {\n  if (id in state.tabs) throw new UiError(category, \"Tab already exists\");\n  const tab = {\n    ...createTabState(id),\n    ...tabArgs,\n  };\n  return produce(state, (stateDraft) => {\n    stateDraft.tabs[id] = castDraft(tab);\n  });\n}\n\n/** Adds an existing `tab` to a specified `widget`.\n * @internal\n */\nexport function addTabToWidget(\n  state: NineZoneState,\n  tabId: TabState[\"id\"],\n  widgetId: WidgetState[\"id\"]\n): NineZoneState {\n  return insertTabToWidget(state, tabId, widgetId, Infinity);\n}\n\n/** Inserts an existing `tab` to a specified `widget` at a specified `tabIndex`.\n * @internal\n */\nexport function insertTabToWidget(\n  state: NineZoneState,\n  tabId: TabState[\"id\"],\n  widgetId: WidgetState[\"id\"],\n  tabIndex: number\n): NineZoneState {\n  if (!(tabId in state.tabs))\n    throw new UiError(category, \"Tab does not exist\", undefined, () => ({\n      tabId,\n    }));\n  assertWidgetState(state, widgetId);\n  const location = getTabLocation(state, tabId);\n  if (location)\n    throw new UiError(\n      category,\n      \"Tab is already in a widget\",\n      undefined,\n      () => ({ tabId, widgetId: location.widgetId })\n    );\n\n  return produce(state, (draft) => {\n    const widget = getWidgetState(draft, widgetId);\n    widget.tabs.splice(tabIndex, 0, tabId);\n  });\n}\n\n/** Removes tab from the UI, but keeps the tab state.\n * @internal\n */\nexport function removeTabFromWidget(\n  state: NineZoneState,\n  tabId: TabState[\"id\"]\n): NineZoneState {\n  const location = getTabLocation(state, tabId);\n  if (!location) return state;\n\n  const widgetId = location.widgetId;\n  const widget = getWidgetState(state, widgetId);\n  const tabs = [...widget.tabs];\n  const tabIndex = tabs.indexOf(tabId);\n  tabs.splice(tabIndex, 1);\n\n  if (tabs.length === 0) {\n    return removeWidget(state, widgetId);\n  }\n\n  if (tabId === widget.activeTabId) {\n    state = setWidgetActiveTabId(state, widget.id, tabs[0]);\n  }\n\n  return updateWidgetState(state, widgetId, {\n    tabs,\n  });\n}\n\n/** Removes tab from the UI and deletes the tab state.\n * @internal\n */\nexport function removeTab(\n  state: NineZoneState,\n  tabId: TabState[\"id\"]\n): NineZoneState {\n  if (!(tabId in state.tabs)) throw new UiError(category, \"Tab does not exist\");\n\n  state = removeTabFromWidget(state, tabId);\n  return produce(state, (draft) => {\n    delete draft.tabs[tabId];\n\n    if (draft.toolSettings?.tabId === tabId) {\n      draft.toolSettings = undefined;\n    }\n  });\n}\n\nconst defaultHomeState: TabHomeState = {\n  side: \"left\",\n  widgetId: \"\",\n  widgetIndex: 0,\n  tabIndex: 0,\n};\n\n/** Adds removed tab to the UI.\n * @internal\n */\nexport function addRemovedTab(\n  state: NineZoneState,\n  tabId: TabState[\"id\"]\n): NineZoneState {\n  if (!(tabId in state.tabs))\n    throw new UiError(category, \"Tab does not exist\", undefined, () => ({\n      tabId,\n    }));\n\n  const savedTab = state.savedTabs.byId[tabId];\n  const home = savedTab?.home || defaultHomeState;\n  const { tabIndex, widgetId } = home;\n\n  // Add to an existing widget (by widget id).\n  if (widgetId in state.widgets) {\n    return insertTabToWidget(state, tabId, widgetId, tabIndex);\n  }\n\n  // Add to a floating widget.\n  if (isFloatingWidgetRestoreState(home)) {\n    // Add to a new floating widget.\n    const nzBounds = Rectangle.createFromSize(state.size);\n    const bounds = Rectangle.create(home.floatingWidget.bounds).containIn(\n      nzBounds\n    );\n    return addFloatingWidget(state, widgetId, [tabId], {\n      ...home.floatingWidget,\n      bounds: bounds.toProps(),\n    });\n  }\n\n  // Add to a panel section.\n  const panel = state.panels[home.side];\n\n  // Add to existing panel section.\n  if (panel.widgets.length >= panel.maxWidgetCount) {\n    const sectionIndex = Math.min(panel.maxWidgetCount - 1, home.widgetIndex);\n    const sectionId = panel.widgets[sectionIndex];\n    return insertTabToWidget(state, tabId, sectionId, home.tabIndex);\n  }\n\n  // Create a new panel section.\n  const newSectionId = getUniqueId();\n  return insertPanelWidget(\n    state,\n    panel.side,\n    newSectionId,\n    [tabId],\n    home.widgetIndex\n  );\n}\n"]}

package/lib/esm/appui-react/layout/state/internal/ToolSettingsStateHelpers.d.ts

@@ -0,0 +1,14 @@
+/** @packageDocumentation
+ * @module Base
+ */
+import type { NineZoneState } from "../NineZoneState";
+import type { TabState } from "../TabState";
+/** Adds a docked tool settings.
+ * @internal
+ */
+export declare function addDockedToolSettings(state: NineZoneState, tabId: TabState["id"], hidden?: boolean): NineZoneState;
+/** Adds a widget tool settings.
+ * @internal
+ */
+export declare function addWidgetToolSettings(state: NineZoneState, tabId: TabState["id"]): NineZoneState;
+//# sourceMappingURL=ToolSettingsStateHelpers.d.ts.map

package/lib/esm/appui-react/layout/state/internal/ToolSettingsStateHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolSettingsStateHelpers.d.ts","sourceRoot":"","sources":["../../../../../../src/appui-react/layout/state/internal/ToolSettingsStateHelpers.ts"],"names":[],"mappings":"AAIA;;GAEG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,EACrB,MAAM,UAAQ,GACb,aAAa,CAuBf;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,GACpB,aAAa,CAmBf"}

package/lib/esm/appui-react/layout/state/internal/ToolSettingsStateHelpers.js

@@ -0,0 +1,55 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Base
+ */
+import produce from "immer";
+import { UiError } from "@itwin/appui-abstract";
+import { category } from "./NineZoneStateHelpers";
+import { getTabLocation } from "../TabLocation";
+/** Adds a docked tool settings.
+ * @internal
+ */
+export function addDockedToolSettings(state, tabId, hidden = false) {
+    if (state.toolSettings)
+        throw new UiError(category, "Tool settings already exist");
+    if (!(tabId in state.tabs))
+        throw new UiError(category, "Tab does not exist", undefined, () => ({
+            tabId,
+        }));
+    const location = getTabLocation(state, tabId);
+    if (location)
+        throw new UiError(category, "Tab is already in a widget", undefined, () => ({ tabId, widgetId: location.widgetId }));
+    return produce(state, (stateDraft) => {
+        stateDraft.toolSettings = {
+            tabId,
+            type: "docked",
+            hidden,
+        };
+    });
+}
+/** Adds a widget tool settings.
+ * @internal
+ */
+export function addWidgetToolSettings(state, tabId) {
+    if (state.toolSettings)
+        throw new UiError(category, "Tool settings already exist");
+    if (!(tabId in state.tabs))
+        throw new UiError(category, "Tab does not exist", undefined, () => ({
+            tabId,
+        }));
+    const location = getTabLocation(state, tabId);
+    if (!location)
+        throw new UiError(category, "Tab is not in a widget", undefined, () => ({
+            tabId,
+        }));
+    return produce(state, (stateDraft) => {
+        stateDraft.toolSettings = {
+            tabId,
+            type: "widget",
+        };
+    });
+}
+//# sourceMappingURL=ToolSettingsStateHelpers.js.map

package/lib/esm/appui-react/layout/state/internal/ToolSettingsStateHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolSettingsStateHelpers.js","sourceRoot":"","sources":["../../../../../../src/appui-react/layout/state/internal/ToolSettingsStateHelpers.ts"],"names":[],"mappings":"AAAA;;;gGAGgG;AAChG;;GAEG;AAEH,OAAO,OAAO,MAAM,OAAO,CAAC;AAC5B,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAEhD,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGhD;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,KAAoB,EACpB,KAAqB,EACrB,MAAM,GAAG,KAAK;IAEd,IAAI,KAAK,CAAC,YAAY;QACpB,MAAM,IAAI,OAAO,CAAC,QAAQ,EAAE,6BAA6B,CAAC,CAAC;IAC7D,IAAI,CAAC,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC;QACxB,MAAM,IAAI,OAAO,CAAC,QAAQ,EAAE,oBAAoB,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;YAClE,KAAK;SACN,CAAC,CAAC,CAAC;IACN,MAAM,QAAQ,GAAG,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAC9C,IAAI,QAAQ;QACV,MAAM,IAAI,OAAO,CACf,QAAQ,EACR,4BAA4B,EAC5B,SAAS,EACT,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAC/C,CAAC;IAEJ,OAAO,OAAO,CAAC,KAAK,EAAE,CAAC,UAAU,EAAE,EAAE;QACnC,UAAU,CAAC,YAAY,GAAG;YACxB,KAAK;YACL,IAAI,EAAE,QAAQ;YACd,MAAM;SACP,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,KAAoB,EACpB,KAAqB;IAErB,IAAI,KAAK,CAAC,YAAY;QACpB,MAAM,IAAI,OAAO,CAAC,QAAQ,EAAE,6BAA6B,CAAC,CAAC;IAC7D,IAAI,CAAC,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC;QACxB,MAAM,IAAI,OAAO,CAAC,QAAQ,EAAE,oBAAoB,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;YAClE,KAAK;SACN,CAAC,CAAC,CAAC;IACN,MAAM,QAAQ,GAAG,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAC9C,IAAI,CAAC,QAAQ;QACX,MAAM,IAAI,OAAO,CAAC,QAAQ,EAAE,wBAAwB,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;YACtE,KAAK;SACN,CAAC,CAAC,CAAC;IAEN,OAAO,OAAO,CAAC,KAAK,EAAE,CAAC,UAAU,EAAE,EAAE;QACnC,UAAU,CAAC,YAAY,GAAG;YACxB,KAAK;YACL,IAAI,EAAE,QAAQ;SACf,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Base\n */\n\nimport produce from \"immer\";\nimport { UiError } from \"@itwin/appui-abstract\";\nimport type { NineZoneState } from \"../NineZoneState\";\nimport { category } from \"./NineZoneStateHelpers\";\nimport { getTabLocation } from \"../TabLocation\";\nimport type { TabState } from \"../TabState\";\n\n/** Adds a docked tool settings.\n * @internal\n */\nexport function addDockedToolSettings(\n  state: NineZoneState,\n  tabId: TabState[\"id\"],\n  hidden = false\n): NineZoneState {\n  if (state.toolSettings)\n    throw new UiError(category, \"Tool settings already exist\");\n  if (!(tabId in state.tabs))\n    throw new UiError(category, \"Tab does not exist\", undefined, () => ({\n      tabId,\n    }));\n  const location = getTabLocation(state, tabId);\n  if (location)\n    throw new UiError(\n      category,\n      \"Tab is already in a widget\",\n      undefined,\n      () => ({ tabId, widgetId: location.widgetId })\n    );\n\n  return produce(state, (stateDraft) => {\n    stateDraft.toolSettings = {\n      tabId,\n      type: \"docked\",\n      hidden,\n    };\n  });\n}\n\n/** Adds a widget tool settings.\n * @internal\n */\nexport function addWidgetToolSettings(\n  state: NineZoneState,\n  tabId: TabState[\"id\"]\n): NineZoneState {\n  if (state.toolSettings)\n    throw new UiError(category, \"Tool settings already exist\");\n  if (!(tabId in state.tabs))\n    throw new UiError(category, \"Tab does not exist\", undefined, () => ({\n      tabId,\n    }));\n  const location = getTabLocation(state, tabId);\n  if (!location)\n    throw new UiError(category, \"Tab is not in a widget\", undefined, () => ({\n      tabId,\n    }));\n\n  return produce(state, (stateDraft) => {\n    stateDraft.toolSettings = {\n      tabId,\n      type: \"widget\",\n    };\n  });\n}\n"]}

package/lib/esm/appui-react/layout/state/internal/WidgetStateHelpers.d.ts

@@ -0,0 +1,48 @@
+/** @packageDocumentation
+ * @module Base
+ */
+import type { RectangleProps } from "@itwin/core-react";
+import type { NineZoneState } from "../NineZoneState";
+import type { FloatingWidgetState, PopoutWidgetState, WidgetState } from "../WidgetState";
+import type { PanelWidgetLocation } from "../WidgetLocation";
+/** @internal */
+export declare function createWidgetState(id: WidgetState["id"], tabs: WidgetState["tabs"], args?: Partial<WidgetState>): WidgetState;
+/** @internal */
+export declare function updateWidgetState(state: NineZoneState, id: WidgetState["id"], args: Partial<WidgetState>): NineZoneState;
+/** @internal */
+export declare function addWidgetState(state: NineZoneState, id: WidgetState["id"], tabs: WidgetState["tabs"], args?: Partial<WidgetState>): NineZoneState;
+/** @internal */
+export declare function removeWidget(state: NineZoneState, id: WidgetState["id"]): NineZoneState;
+/** @internal */
+export declare function removeWidgetState(state: NineZoneState, id: WidgetState["id"]): NineZoneState;
+/** @internal */
+export declare function createFloatingWidgetState(id: FloatingWidgetState["id"], args?: Partial<FloatingWidgetState>): FloatingWidgetState;
+/** @internal */
+export declare function createPopoutWidgetState(id: PopoutWidgetState["id"], args?: Partial<PopoutWidgetState>): PopoutWidgetState;
+/** @internal */
+export declare function updateFloatingWidgetState(state: NineZoneState, id: FloatingWidgetState["id"], args: Partial<FloatingWidgetState>): NineZoneState;
+/** Removes floating widget from the UI and deletes the widget state.
+ * @internal
+ */
+export declare function removeFloatingWidget(state: NineZoneState, id: FloatingWidgetState["id"]): NineZoneState;
+/** Removes popout widget from the UI and deletes the widget state.
+ * @internal
+ */
+export declare function removePopoutWidget(state: NineZoneState, id: PopoutWidgetState["id"]): NineZoneState;
+/** @internal */
+export declare function removePanelWidget(state: NineZoneState, id: WidgetState["id"], location?: PanelWidgetLocation): NineZoneState;
+/** @internal */
+export declare function assertWidgetState(state: NineZoneState, id: WidgetState["id"]): void;
+/** @internal */
+export declare function getWidgetState<T extends NineZoneState>(state: T, id: WidgetState["id"]): T["widgets"][0];
+/** @internal */
+export declare function setWidgetActiveTabId(state: NineZoneState, widgetId: WidgetState["id"], tabId: WidgetState["activeTabId"]): NineZoneState;
+/** @internal */
+export declare function getNewFloatingWidgetBounds(state: NineZoneState): RectangleProps;
+/** @internal */
+export declare function addFloatingWidget(state: NineZoneState, id: FloatingWidgetState["id"], tabs: WidgetState["tabs"], floatingWidgetArgs?: Partial<FloatingWidgetState>, widgetArgs?: Partial<WidgetState>): NineZoneState;
+/** @internal */
+export declare function addPopoutWidget(state: NineZoneState, id: PopoutWidgetState["id"], tabs: WidgetState["tabs"], popoutWidgetArgs?: Partial<PopoutWidgetState>, widgetArgs?: Partial<WidgetState>): NineZoneState;
+/** @internal */
+export declare function floatingWidgetBringToFront(state: NineZoneState, floatingWidgetId: FloatingWidgetState["id"]): NineZoneState;
+//# sourceMappingURL=WidgetStateHelpers.d.ts.map

package/lib/esm/appui-react/layout/state/internal/WidgetStateHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WidgetStateHelpers.d.ts","sourceRoot":"","sources":["../../../../../../src/appui-react/layout/state/internal/WidgetStateHelpers.ts"],"names":[],"mappings":"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"}

package/lib/esm/appui-react/layout/state/internal/WidgetStateHelpers.js

@@ -0,0 +1,298 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Base
+ */
+import { castDraft, produce } from "immer";
+import { UiError } from "@itwin/appui-abstract";
+import { assert } from "@itwin/core-bentley";
+import { Point, Rectangle } from "@itwin/core-react";
+import { getTabLocation } from "../TabLocation";
+import { getWidgetLocation, isFloatingWidgetLocation, isPanelWidgetLocation, isPopoutWidgetLocation, } from "../WidgetLocation";
+import { category, initSizeProps, setRectangleProps, toRectangleProps, } from "./NineZoneStateHelpers";
+import { updatePanelState } from "./PanelStateHelpers";
+import { updateTabState } from "./TabStateHelpers";
+/** @internal */
+export function createWidgetState(id, tabs, args) {
+    if (tabs.length === 0)
+        // eslint-disable-next-line deprecation/deprecation
+        throw new UiError(category, "Widget must contain tabs");
+    return {
+        activeTabId: tabs[0],
+        minimized: false,
+        ...args,
+        id,
+        tabs,
+    };
+}
+/** @internal */
+export function updateWidgetState(state, id, args) {
+    return produce(state, (draft) => {
+        const widget = getWidgetState(draft, id);
+        draft.widgets[id] = {
+            ...widget,
+            ...castDraft(args),
+        };
+    });
+}
+/** @internal */
+export function addWidgetState(state, id, tabs, args) {
+    // eslint-disable-next-line deprecation/deprecation
+    if (id in state.widgets)
+        throw new UiError(category, "Widget already exists");
+    const widget = createWidgetState(id, tabs, args);
+    for (const tabId of widget.tabs) {
+        if (!(tabId in state.tabs))
+            // eslint-disable-next-line deprecation/deprecation
+            throw new UiError(category, "Tab does not exist", undefined, () => ({
+                tabId,
+            }));
+        const location = getTabLocation(state, tabId);
+        if (location)
+            // eslint-disable-next-line deprecation/deprecation
+            throw new UiError(category, "Tab is already in a widget", undefined, () => ({ tabId, widgetId: location.widgetId }));
+    }
+    return produce(state, (draft) => {
+        draft.widgets[id] = castDraft(widget);
+    });
+}
+/** @internal */
+export function removeWidget(state, id) {
+    const location = getWidgetLocation(state, id);
+    // eslint-disable-next-line deprecation/deprecation
+    if (!location)
+        throw new UiError(category, "Widget not found");
+    if (isFloatingWidgetLocation(location))
+        return removeFloatingWidget(state, id);
+    if (isPopoutWidgetLocation(location))
+        return removePopoutWidget(state, id);
+    return removePanelWidget(state, id, location);
+}
+/** @internal */
+export function removeWidgetState(state, id) {
+    assertWidgetState(state, id);
+    return produce(state, (draft) => {
+        delete draft.widgets[id];
+    });
+}
+/** @internal */
+export function createFloatingWidgetState(id, args) {
+    const bounds = toRectangleProps(args === null || args === void 0 ? void 0 : args.bounds);
+    return {
+        home: {
+            side: "left",
+            widgetId: "",
+            widgetIndex: 0,
+        },
+        ...args,
+        bounds,
+        id,
+    };
+}
+/** @internal */
+export function createPopoutWidgetState(id, args) {
+    const bounds = toRectangleProps(args === null || args === void 0 ? void 0 : args.bounds);
+    const home = (args === null || args === void 0 ? void 0 : args.home)
+        ? args.home
+        : {
+            side: "left",
+            widgetId: "",
+            widgetIndex: 0,
+        };
+    return {
+        ...args,
+        home,
+        bounds,
+        id,
+    };
+}
+/** @internal */
+export function updateFloatingWidgetState(state, id, args) {
+    if (!(id in state.floatingWidgets.byId))
+        // eslint-disable-next-line deprecation/deprecation
+        throw new UiError(category, "Floating widget does not exist");
+    return produce(state, (draft) => {
+        const floatingWidget = draft.floatingWidgets.byId[id];
+        const { bounds, ...other } = args;
+        draft.floatingWidgets.byId[id] = {
+            ...floatingWidget,
+            ...other,
+        };
+        if (bounds)
+            setRectangleProps(floatingWidget.bounds, bounds);
+    });
+}
+/** Removes floating widget from the UI and deletes the widget state.
+ * @internal
+ */
+export function removeFloatingWidget(state, id) {
+    if (!(id in state.floatingWidgets.byId))
+        // eslint-disable-next-line deprecation/deprecation
+        throw new UiError(category, "Floating widget does not exist");
+    state = produce(state, (draft) => {
+        delete draft.floatingWidgets.byId[id];
+        const idIndex = draft.floatingWidgets.allIds.indexOf(id);
+        draft.floatingWidgets.allIds.splice(idIndex, 1);
+    });
+    return removeWidgetState(state, id);
+}
+/** Removes popout widget from the UI and deletes the widget state.
+ * @internal
+ */
+export function removePopoutWidget(state, id) {
+    if (!(id in state.popoutWidgets.byId))
+        // eslint-disable-next-line deprecation/deprecation
+        throw new UiError(category, "Popout widget does not exist");
+    state = produce(state, (draft) => {
+        delete draft.popoutWidgets.byId[id];
+        const index = state.popoutWidgets.allIds.indexOf(id);
+        draft.popoutWidgets.allIds.splice(index, 1);
+    });
+    return removeWidgetState(state, id);
+}
+/** @internal */
+export function removePanelWidget(state, id, location) {
+    location = location || findPanelWidget(state, id);
+    // eslint-disable-next-line deprecation/deprecation
+    if (!location)
+        throw new UiError(category, "Panel widget not found");
+    state = updatePanelState(state, location.side, (draft) => {
+        assert(!!location);
+        draft.widgets.splice(location.index, 1);
+    });
+    const widgets = state.panels[location.side].widgets;
+    const expandedWidget = widgets.find((widgetId) => {
+        const widget = getWidgetState(state, widgetId);
+        return !widget.minimized;
+    });
+    if (!expandedWidget && widgets.length > 0) {
+        const firstWidgetId = widgets[0];
+        state = updateWidgetState(state, firstWidgetId, {
+            minimized: false,
+        });
+    }
+    return removeWidgetState(state, id);
+}
+function findPanelWidget(state, id) {
+    const location = getWidgetLocation(state, id);
+    if (location && isPanelWidgetLocation(location))
+        return location;
+    return undefined;
+}
+/** @internal */
+export function assertWidgetState(state, id) {
+    if (!(id in state.widgets))
+        // eslint-disable-next-line deprecation/deprecation
+        throw new UiError(category, "Widget does not exist", undefined, () => ({
+            id,
+        }));
+}
+/** @internal */
+export function getWidgetState(state, id) {
+    assertWidgetState(state, id);
+    return state.widgets[id];
+}
+/** @internal */
+export function setWidgetActiveTabId(state, widgetId, tabId) {
+    const widget = getWidgetState(state, widgetId);
+    if (!widget.tabs.includes(tabId))
+        // eslint-disable-next-line deprecation/deprecation
+        throw new UiError(category, "Tab is not in a widget");
+    state = updateWidgetState(state, widgetId, {
+        activeTabId: tabId,
+    });
+    const floatingWidget = state.floatingWidgets.byId[widgetId];
+    if (floatingWidget) {
+        const activeTab = state.tabs[tabId];
+        const preferredFloatingWidgetSize = Rectangle.create(floatingWidget.bounds).getSize();
+        state = updateTabState(state, activeTab.id, (draft) => {
+            initSizeProps(draft, "preferredFloatingWidgetSize", preferredFloatingWidgetSize);
+        });
+    }
+    return state;
+}
+/** @internal */
+export function getNewFloatingWidgetBounds(state) {
+    // Matches min size (to handle auto-sized floating widgets correctly).
+    const size = { height: 120, width: 200 };
+    const initialPosition = new Point(360, 340);
+    const nzBounds = Rectangle.createFromSize(state.size);
+    const widgetsBounds = nzBounds.inset(20, 20, 20, 20);
+    const offset = new Point(40, 40);
+    let bounds = Rectangle.createFromSize(size);
+    if (state.floatingWidgets.allIds.length === 0) {
+        // Initial floating widget position.
+        bounds = bounds.offset(initialPosition);
+    }
+    else {
+        // Position is relative to last floating widget if available.
+        const widgetId = state.floatingWidgets.allIds[state.floatingWidgets.allIds.length - 1];
+        const widget = state.floatingWidgets.byId[widgetId];
+        const widgetBounds = Rectangle.create(widget.bounds);
+        // Bounds relative to top left of a last floating widget.
+        const topLeft = widgetBounds.topLeft().offset(offset);
+        bounds = bounds.offset(topLeft);
+        // Bottom right of new bounds should also be outside of a floating widget.
+        const widgetBottomRight = new Point(widgetBounds.right, widgetBounds.bottom);
+        const minBottomRight = widgetBottomRight.offset(offset);
+        const x = Math.max(0, minBottomRight.x - bounds.right);
+        const y = Math.max(0, minBottomRight.y - bounds.bottom);
+        bounds = bounds.offset({ x, y });
+    }
+    // TODO: might still end up with a bunch of overlapping widgets.
+    if (bounds.bottom >= widgetsBounds.bottom) {
+        bounds = bounds.setPosition({ x: bounds.left, y: widgetsBounds.top });
+    }
+    if (bounds.right >= widgetsBounds.right) {
+        bounds = bounds.setPosition({
+            x: widgetsBounds.left,
+            y: widgetsBounds.top,
+        });
+    }
+    bounds = bounds.containIn(widgetsBounds);
+    return bounds.toProps();
+}
+/** @internal */
+export function addFloatingWidget(state, id, tabs, floatingWidgetArgs, widgetArgs) {
+    if (id in state.floatingWidgets.byId)
+        throw new UiError(category, "Floating widget already exists");
+    state = addWidgetState(state, id, tabs, widgetArgs);
+    let bounds = floatingWidgetArgs === null || floatingWidgetArgs === void 0 ? void 0 : floatingWidgetArgs.bounds;
+    if (!bounds) {
+        bounds = getNewFloatingWidgetBounds(state);
+    }
+    const tabId = tabs[0];
+    const tab = state.tabs[tabId];
+    const resizable = tab.isFloatingWidgetResizable;
+    const floatingWidget = createFloatingWidgetState(id, {
+        bounds,
+        resizable,
+        ...floatingWidgetArgs,
+    });
+    return produce(state, (stateDraft) => {
+        stateDraft.floatingWidgets.byId[id] = floatingWidget;
+        stateDraft.floatingWidgets.allIds.push(id);
+    });
+}
+/** @internal */
+export function addPopoutWidget(state, id, tabs, popoutWidgetArgs, widgetArgs) {
+    if (tabs.length !== 1)
+        throw new UiError(category, "Popout widget should contain one tab only", undefined, () => ({ tabs }));
+    const popoutWidget = createPopoutWidgetState(id, popoutWidgetArgs);
+    state = addWidgetState(state, id, tabs, widgetArgs);
+    return produce(state, (stateDraft) => {
+        stateDraft.popoutWidgets.byId[id] = popoutWidget;
+        stateDraft.popoutWidgets.allIds.push(id);
+    });
+}
+/** @internal */
+export function floatingWidgetBringToFront(state, floatingWidgetId) {
+    return produce(state, (draft) => {
+        const idIndex = draft.floatingWidgets.allIds.indexOf(floatingWidgetId);
+        const spliced = draft.floatingWidgets.allIds.splice(idIndex, 1);
+        draft.floatingWidgets.allIds.push(spliced[0]);
+    });
+}
+//# sourceMappingURL=WidgetStateHelpers.js.map