@itwin/appui-react 4.0.0-dev.2 → 4.0.0-dev.4

package/lib/cjs/appui-react/widgets/WidgetManager.d.ts

@@ -1,55 +1,57 @@
-/** @packageDocumentation
- * @module Widget
- */
-import { BeUiEvent } from "@itwin/core-bentley";
-import { StagePanelLocation, StagePanelSection } from "@itwin/appui-abstract";
-import { WidgetDef } from "./WidgetDef";
-/** Information about WidgetDefs in the WidgetManager
- * @internal
- */
-export interface WidgetInfo {
-    widgetDef: WidgetDef;
-    stageId?: string;
-    stageUsage?: string;
-    location: StagePanelLocation;
-    section: StagePanelSection;
-}
-/** Arguments of [[this.onWidgetsChanged]] event.
- * @internal
- */
-export interface WidgetsChangedEventArgs {
-    readonly items: ReadonlyArray<WidgetInfo>;
-}
-/** Event class for [[this.onWidgetsChanged]].
- * @internal
- */
-export declare class WidgetsChangedEvent extends BeUiEvent<WidgetsChangedEventArgs> {
-}
-/** Widget Manager class.
- * @beta
- */
-export declare class WidgetManager {
-    private _widgets;
-    /** Event raised when Widgets are changed.
-     * @internal
-     */
-    readonly onWidgetsChanged: WidgetsChangedEvent;
-    /** @internal */
-    get widgetCount(): number;
-    /** @internal */
-    get widgets(): ReadonlyArray<WidgetInfo>;
-    set widgets(w: ReadonlyArray<WidgetInfo>);
-    /** Adds a WidgetDef for use in a Frontstage.
-     * @note Added `widgetDef` must return unique id to correctly save/restore App layout.
-     * Semi-stable id is generated when auto-generated `widgetDef` id is detected,
-     * but correctness of such id depends on `addWidgetDef` call order and widget location.
-     */
-    addWidgetDef(widgetDef: WidgetDef, stageId: string | undefined, stageUsage: string | undefined, location: StagePanelLocation, section?: StagePanelSection): boolean;
-    /** Removes a WidgetDef.
-     */
-    removeWidgetDef(widgetId: string): boolean;
-    /** Gets WidgetDefs for a Frontstage location.
-     */
-    getWidgetDefs(stageId: string, stageUsage: string, location: StagePanelLocation, section?: StagePanelSection): ReadonlyArray<WidgetDef> | undefined;
-}
+/** @packageDocumentation
+ * @module Widget
+ */
+import { BeUiEvent } from "@itwin/core-bentley";
+import { StagePanelLocation, StagePanelSection } from "@itwin/appui-abstract";
+import { ZoneLocation } from "../zones/Zone";
+import { WidgetDef } from "./WidgetDef";
+/** Information about WidgetDefs in the WidgetManager
+ * @internal
+ */
+export interface WidgetInfo {
+    widgetDef: WidgetDef;
+    stageId?: string;
+    stageUsage?: string;
+    location: ZoneLocation | StagePanelLocation;
+    section: StagePanelSection;
+}
+/** Arguments of [[this.onWidgetsChanged]] event.
+ * @internal
+ */
+export interface WidgetsChangedEventArgs {
+    readonly items: ReadonlyArray<WidgetInfo>;
+}
+/** Event class for [[this.onWidgetsChanged]].
+ * @internal
+ */
+export declare class WidgetsChangedEvent extends BeUiEvent<WidgetsChangedEventArgs> {
+}
+/** Widget Manager class.
+ * @beta
+ */
+export declare class WidgetManager {
+    private _widgets;
+    /** Event raised when Widgets are changed.
+     * @internal
+     */
+    readonly onWidgetsChanged: WidgetsChangedEvent;
+    /** @internal */
+    get widgetCount(): number;
+    /** @internal */
+    get widgets(): ReadonlyArray<WidgetInfo>;
+    set widgets(w: ReadonlyArray<WidgetInfo>);
+    /** Adds a WidgetDef for use in a Frontstage.
+     * @note Added `widgetDef` must return unique id to correctly save/restore App layout.
+     * Semi-stable id is generated when auto-generated `widgetDef` id is detected,
+     * but correctness of such id depends on `addWidgetDef` call order and widget location.
+     */
+    addWidgetDef(widgetDef: WidgetDef, stageId: string | undefined, stageUsage: string | undefined, location: ZoneLocation | StagePanelLocation, section?: StagePanelSection): boolean;
+    /** Removes a WidgetDef.
+     */
+    removeWidgetDef(widgetId: string): boolean;
+    private getStagePanelLocationFromZoneLocation;
+    /** Gets WidgetDefs for a Frontstage location.
+     */
+    getWidgetDefs(stageId: string, stageUsage: string, location: ZoneLocation | StagePanelLocation, section?: StagePanelSection, frontstageApplicationData?: any): ReadonlyArray<WidgetDef> | undefined;
+}
 //# sourceMappingURL=WidgetManager.d.ts.map

package/lib/cjs/appui-react/widgets/WidgetManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WidgetManager.d.ts","sourceRoot":"","sources":["../../../../src/appui-react/widgets/WidgetManager.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAU,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAuB,kBAAkB,EAAE,iBAAiB,EAAkB,MAAM,uBAAuB,CAAC;AAEnH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAIxC;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,SAAS,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,OAAO,EAAE,iBAAiB,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;CAC3C;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,SAAS,CAAC,uBAAuB,CAAC;CAAI;AAU/E;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAiC;IAEjD;;OAEG;IACH,SAAgB,gBAAgB,sBAA6B;IAE7D,gBAAgB;IAChB,IAAW,WAAW,IAAI,MAAM,CAE/B;IAED,gBAAgB;IAChB,IAAW,OAAO,IAAI,aAAa,CAAC,UAAU,CAAC,CAA0B;IACzE,IAAW,OAAO,CAAC,CAAC,EAAE,aAAa,CAAC,UAAU,CAAC,EAG9C;IAED;;;;OAIG;IACI,YAAY,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO;IA0B1K;OACG;IACI,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAYjD;OACG;IACI,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,aAAa,CAAC,SAAS,CAAC,GAAG,SAAS;CAsB3J"}
+{"version":3,"file":"WidgetManager.d.ts","sourceRoot":"","sources":["../../../../src/appui-react/widgets/WidgetManager.ts"],"names":[],"mappings":"AAKA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAU,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAA6C,kBAAkB,EAAE,iBAAiB,EAAkB,MAAM,uBAAuB,CAAC;AAEzI,OAAO,EAAwB,YAAY,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,SAAS,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,YAAY,GAAG,kBAAkB,CAAC;IAC5C,OAAO,EAAE,iBAAiB,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;CAC3C;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,SAAS,CAAC,uBAAuB,CAAC;CAAI;AAmB/E;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAiC;IAEjD;;OAEG;IACH,SAAgB,gBAAgB,sBAA6B;IAE7D,gBAAgB;IAChB,IAAW,WAAW,IAAI,MAAM,CAE/B;IAED,gBAAgB;IAChB,IAAW,OAAO,IAAI,aAAa,CAAC,UAAU,CAAC,CAA0B;IACzE,IAAW,OAAO,CAAC,CAAC,EAAE,aAAa,CAAC,UAAU,CAAC,EAG9C;IAED;;;;OAIG;IACI,YAAY,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,YAAY,GAAG,kBAAkB,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO;IA0BzL;OACG;IACI,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAcjD,OAAO,CAAC,qCAAqC;IAgB7C;OACG;IACI,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,kBAAkB,EAAE,OAAO,CAAC,EAAE,iBAAiB,EAChI,yBAAyB,CAAC,EAAE,GAAG,GAAG,aAAa,CAAC,SAAS,CAAC,GAAG,SAAS;CA0CzE"}

package/lib/cjs/appui-react/widgets/WidgetManager.js

@@ -1,118 +1,155 @@
-"use strict";
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-/** @packageDocumentation
- * @module Widget
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.WidgetManager = exports.WidgetsChangedEvent = void 0;
-const core_bentley_1 = require("@itwin/core-bentley");
-const appui_abstract_1 = require("@itwin/appui-abstract");
-const UiFramework_1 = require("../UiFramework");
-const WidgetDef_1 = require("./WidgetDef");
-const StableWidgetDef_1 = require("./StableWidgetDef");
-/** Event class for [[this.onWidgetsChanged]].
- * @internal
- */
-class WidgetsChangedEvent extends core_bentley_1.BeUiEvent {
-}
-exports.WidgetsChangedEvent = WidgetsChangedEvent;
-function getWidgetManagerStableWidgetId(stageUsage, location, section, index) {
-    return `uifw-wm-${stageUsage || ""}-${appui_abstract_1.StagePanelLocation[location]}-${appui_abstract_1.StagePanelSection[section]}-${index}`;
-}
-function getAddonStableWidgetId(stageUsage, location, section, index) {
-    return `uifw-addon-${stageUsage}-${appui_abstract_1.StagePanelLocation[location]}-${appui_abstract_1.StagePanelSection[section]}-${index}`;
-}
-/** Widget Manager class.
- * @beta
- */
-class WidgetManager {
-    constructor() {
-        this._widgets = [];
-        /** Event raised when Widgets are changed.
-         * @internal
-         */
-        this.onWidgetsChanged = new WidgetsChangedEvent();
-    }
-    /** @internal */
-    get widgetCount() {
-        return this._widgets.length;
-    }
-    /** @internal */
-    get widgets() { return this._widgets; }
-    set widgets(w) {
-        this._widgets = w;
-        this.onWidgetsChanged.emit({ items: w });
-    }
-    /** Adds a WidgetDef for use in a Frontstage.
-     * @note Added `widgetDef` must return unique id to correctly save/restore App layout.
-     * Semi-stable id is generated when auto-generated `widgetDef` id is detected,
-     * but correctness of such id depends on `addWidgetDef` call order and widget location.
-     */
-    addWidgetDef(widgetDef, stageId, stageUsage, location, section) {
-        if (stageId === undefined && stageUsage === undefined) {
-            core_bentley_1.Logger.logError(UiFramework_1.UiFramework.loggerCategory(this), `addWidgetDef: stageId or stageUsage param must be specified`);
-            return false;
-        }
-        section = (section !== undefined) ? section : appui_abstract_1.StagePanelSection.Start;
-        const index = this._widgets.reduce((acc, info) => {
-            if (info.stageId === stageId && info.stageUsage === stageUsage && info.location === location && info.section === section)
-                return acc + 1;
-            return acc;
-        }, 0);
-        const stableId = getWidgetManagerStableWidgetId(stageUsage, location, section, index);
-        const stableWidget = (0, StableWidgetDef_1.createStableWidgetDef)(widgetDef, stableId);
-        const newWidget = { widgetDef: stableWidget, stageId, stageUsage, location, section };
-        const oldWidgets = this._widgets.filter((info) => info.widgetDef.id !== newWidget.widgetDef.id);
-        const updatedWidgets = [
-            ...oldWidgets,
-            newWidget,
-        ];
-        this.widgets = updatedWidgets;
-        return true;
-    }
-    /** Removes a WidgetDef.
-     */
-    removeWidgetDef(widgetId) {
-        let result = false;
-        const updatedWidgets = this._widgets.filter((info) => info.widgetDef.id !== widgetId);
-        if (updatedWidgets.length !== this._widgets.length) {
-            this.widgets = updatedWidgets;
-            result = true;
-        }
-        return result;
-    }
-    /** Gets WidgetDefs for a Frontstage location.
-     */
-    getWidgetDefs(stageId, stageUsage, location, section) {
-        const definedSection = section === undefined ? appui_abstract_1.StagePanelSection.Start : section;
-        const widgetInfos = this._widgets.filter((info) => {
-            return (!info.stageId || info.stageId === stageId)
-                && (!info.stageUsage || info.stageUsage === stageUsage)
-                && info.location === location
-                && info.section === definedSection;
-        });
-        const widgetDefs = widgetInfos.map((info) => info.widgetDef);
-        // Consult the UiItemsManager to get any Abstract widgets
-        const widgets = appui_abstract_1.UiItemsManager.getWidgets(stageId, stageUsage, location, definedSection);
-        widgets.forEach((abstractProps, index) => {
-            const stableId = getAddonStableWidgetId(stageUsage, location, definedSection, index);
-            const config = createWidgetConfigFromAbstractProps(abstractProps, stableId);
-            const widgetDef = WidgetDef_1.WidgetDef.create(config);
-            widgetDefs.push(widgetDef);
-        });
-        return widgetDefs.length > 0 ? widgetDefs : undefined;
-    }
-}
-exports.WidgetManager = WidgetManager;
-function createWidgetConfigFromAbstractProps(props, stableId) {
-    const config = {
-        id: props.id ? props.id : stableId,
-        element: props.getWidgetContent(),
-        ...props,
-    };
-    return config;
-}
+"use strict";
+/*---------------------------------------------------------------------------------------------
+* 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 Widget
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WidgetManager = exports.WidgetsChangedEvent = void 0;
+const core_bentley_1 = require("@itwin/core-bentley");
+const appui_abstract_1 = require("@itwin/appui-abstract");
+const UiFramework_1 = require("../UiFramework");
+const Zone_1 = require("../zones/Zone");
+const WidgetDef_1 = require("./WidgetDef");
+const StableWidgetDef_1 = require("./StableWidgetDef");
+/** Event class for [[this.onWidgetsChanged]].
+ * @internal
+ */
+class WidgetsChangedEvent extends core_bentley_1.BeUiEvent {
+}
+exports.WidgetsChangedEvent = WidgetsChangedEvent;
+function isZoneLocation(location) {
+    return location >= Zone_1.ZoneLocation.TopLeft && location <= Zone_1.ZoneLocation.BottomRight;
+}
+function getLocationName(location) {
+    return isZoneLocation(location) ? Zone_1.ZoneLocation[location] : appui_abstract_1.StagePanelLocation[location];
+}
+function getWidgetManagerStableWidgetId(stageUsage, location, section, index) {
+    return `uifw-wm-${stageUsage || ""}-${getLocationName(location)}-${appui_abstract_1.StagePanelSection[section]}-${index}`;
+}
+function getAddonStableWidgetId(stageUsage, location, section, index) {
+    return `uifw-addon-${stageUsage}-${appui_abstract_1.StagePanelLocation[location]}-${appui_abstract_1.StagePanelSection[section]}-${index}`;
+}
+/** Widget Manager class.
+ * @beta
+ */
+class WidgetManager {
+    constructor() {
+        this._widgets = [];
+        /** Event raised when Widgets are changed.
+         * @internal
+         */
+        this.onWidgetsChanged = new WidgetsChangedEvent();
+    }
+    /** @internal */
+    get widgetCount() {
+        return this._widgets.length;
+    }
+    /** @internal */
+    get widgets() { return this._widgets; }
+    set widgets(w) {
+        this._widgets = w;
+        this.onWidgetsChanged.emit({ items: w });
+    }
+    /** Adds a WidgetDef for use in a Frontstage.
+     * @note Added `widgetDef` must return unique id to correctly save/restore App layout.
+     * Semi-stable id is generated when auto-generated `widgetDef` id is detected,
+     * but correctness of such id depends on `addWidgetDef` call order and widget location.
+     */
+    addWidgetDef(widgetDef, stageId, stageUsage, location, section) {
+        if (stageId === undefined && stageUsage === undefined) {
+            core_bentley_1.Logger.logError(UiFramework_1.UiFramework.loggerCategory(this), `addWidgetDef: stageId or stageUsage param must be specified`);
+            return false;
+        }
+        section = (section !== undefined) ? section : appui_abstract_1.StagePanelSection.Start;
+        const index = this._widgets.reduce((acc, info) => {
+            if (info.stageId === stageId && info.stageUsage === stageUsage && info.location === location && info.section === section)
+                return acc + 1;
+            return acc;
+        }, 0);
+        const stableId = getWidgetManagerStableWidgetId(stageUsage, location, section, index);
+        const stableWidget = (0, StableWidgetDef_1.createStableWidgetDef)(widgetDef, stableId);
+        const newWidget = { widgetDef: stableWidget, stageId, stageUsage, location, section };
+        const oldWidgets = this._widgets.filter((info) => info.widgetDef.id !== newWidget.widgetDef.id);
+        const updatedWidgets = [
+            ...oldWidgets,
+            newWidget,
+        ];
+        this.widgets = updatedWidgets;
+        return true;
+    }
+    /** Removes a WidgetDef.
+     */
+    removeWidgetDef(widgetId) {
+        let result = false;
+        const updatedWidgets = this._widgets.filter((info) => info.widgetDef.id !== widgetId);
+        if (updatedWidgets.length !== this._widgets.length) {
+            this.widgets = updatedWidgets;
+            result = true;
+        }
+        return result;
+    }
+    // Used when WidgetDefs are requested from UiItemProviders when uiVersion="1"
+    // istanbul ignore next
+    getStagePanelLocationFromZoneLocation(location) {
+        switch (location) {
+            case Zone_1.ZoneLocation.BottomCenter:
+            case Zone_1.ZoneLocation.TopCenter:
+            case Zone_1.ZoneLocation.TopRight:
+            case Zone_1.ZoneLocation.TopLeft:
+                return undefined; // an existing stage does not support appending widgets to these zones
+            case Zone_1.ZoneLocation.BottomLeft:
+            case Zone_1.ZoneLocation.CenterLeft:
+                return appui_abstract_1.StagePanelLocation.Left;
+            case Zone_1.ZoneLocation.BottomRight:
+            case Zone_1.ZoneLocation.CenterRight:
+                return appui_abstract_1.StagePanelLocation.Right;
+        }
+    }
+    /** Gets WidgetDefs for a Frontstage location.
+     */
+    getWidgetDefs(stageId, stageUsage, location, section, frontstageApplicationData) {
+        const definedSection = section === undefined ? appui_abstract_1.StagePanelSection.Start : section;
+        const widgetInfos = this._widgets.filter((info) => {
+            return (!info.stageId || info.stageId === stageId)
+                && (!info.stageUsage || info.stageUsage === stageUsage)
+                && info.location === location
+                && info.section === definedSection;
+        });
+        const widgetDefs = widgetInfos.map((info) => info.widgetDef);
+        // Consult the UiItemsManager to get any Abstract widgets
+        if (location in appui_abstract_1.StagePanelLocation) {
+            const widgets = appui_abstract_1.UiItemsManager.getWidgets(stageId, stageUsage, location, definedSection, undefined, frontstageApplicationData);
+            widgets.forEach((abstractProps, index) => {
+                const props = WidgetDef_1.WidgetDef.createWidgetPropsFromAbstractProps(abstractProps);
+                const stableId = getAddonStableWidgetId(stageUsage, location, definedSection, index);
+                const stableProps = (0, Zone_1.getStableWidgetProps)(props, stableId);
+                const wd = new WidgetDef_1.WidgetDef(stableProps);
+                widgetDefs.push(wd);
+            });
+        }
+        else {
+            // istanbul ignore else
+            if (location in Zone_1.ZoneLocation) {
+                const panelLocation = this.getStagePanelLocationFromZoneLocation(location);
+                // istanbul ignore else
+                if (panelLocation && location in appui_abstract_1.AbstractZoneLocation) {
+                    const widgets = appui_abstract_1.UiItemsManager.getWidgets(stageId, stageUsage, panelLocation, undefined, location, frontstageApplicationData);
+                    widgets.forEach((abstractProps, index) => {
+                        const props = WidgetDef_1.WidgetDef.createWidgetPropsFromAbstractProps(abstractProps);
+                        const stableId = getAddonStableWidgetId(stageUsage, location, definedSection, index);
+                        const stableProps = (0, Zone_1.getStableWidgetProps)(props, stableId);
+                        const wd = new WidgetDef_1.WidgetDef(stableProps);
+                        widgetDefs.push(wd);
+                    });
+                }
+            }
+        }
+        return widgetDefs.length > 0 ? widgetDefs : undefined;
+    }
+}
+exports.WidgetManager = WidgetManager;
 //# sourceMappingURL=WidgetManager.js.map

package/lib/cjs/appui-react/widgets/WidgetManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"WidgetManager.js","sourceRoot":"","sources":["../../../../src/appui-react/widgets/WidgetManager.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 Widget\n */\n\nimport { BeUiEvent, Logger } from \"@itwin/core-bentley\";\nimport { AbstractWidgetProps, StagePanelLocation, StagePanelSection, UiItemsManager } from \"@itwin/appui-abstract\";\nimport { UiFramework } from \"../UiFramework\";\nimport { WidgetDef } from \"./WidgetDef\";\nimport { createStableWidgetDef } from \"./StableWidgetDef\";\nimport { WidgetConfig } from \"./WidgetConfig\";\n\n/** Information about WidgetDefs in the WidgetManager\n * @internal\n */\nexport interface WidgetInfo {\n  widgetDef: WidgetDef;\n  stageId?: string;\n  stageUsage?: string;\n  location: StagePanelLocation;\n  section: StagePanelSection;\n}\n\n/** Arguments of [[this.onWidgetsChanged]] event.\n * @internal\n */\nexport interface WidgetsChangedEventArgs {\n  readonly items: ReadonlyArray<WidgetInfo>;\n}\n\n/** Event class for [[this.onWidgetsChanged]].\n * @internal\n */\nexport class WidgetsChangedEvent extends BeUiEvent<WidgetsChangedEventArgs> { }\n\nfunction getWidgetManagerStableWidgetId(stageUsage: string | undefined, location: StagePanelLocation, section: StagePanelSection, index: number) {\n  return `uifw-wm-${stageUsage || \"\"}-${StagePanelLocation[location]}-${StagePanelSection[section]}-${index}`;\n}\n\nfunction getAddonStableWidgetId(stageUsage: string, location: StagePanelLocation, section: StagePanelSection, index: number) {\n  return `uifw-addon-${stageUsage}-${StagePanelLocation[location]}-${StagePanelSection[section]}-${index}`;\n}\n\n/** Widget Manager class.\n * @beta\n */\nexport class WidgetManager {\n  private _widgets: ReadonlyArray<WidgetInfo> = [];\n\n  /** Event raised when Widgets are changed.\n   * @internal\n   */\n  public readonly onWidgetsChanged = new WidgetsChangedEvent();\n\n  /** @internal */\n  public get widgetCount(): number {\n    return this._widgets.length;\n  }\n\n  /** @internal */\n  public get widgets(): ReadonlyArray<WidgetInfo> { return this._widgets; }\n  public set widgets(w: ReadonlyArray<WidgetInfo>) {\n    this._widgets = w;\n    this.onWidgetsChanged.emit({ items: w });\n  }\n\n  /** Adds a WidgetDef for use in a Frontstage.\n   * @note Added `widgetDef` must return unique id to correctly save/restore App layout.\n   * Semi-stable id is generated when auto-generated `widgetDef` id is detected,\n   * but correctness of such id depends on `addWidgetDef` call order and widget location.\n   */\n  public addWidgetDef(widgetDef: WidgetDef, stageId: string | undefined, stageUsage: string | undefined, location: StagePanelLocation, section?: StagePanelSection): boolean {\n    if (stageId === undefined && stageUsage === undefined) {\n      Logger.logError(UiFramework.loggerCategory(this), `addWidgetDef: stageId or stageUsage param must be specified`);\n      return false;\n    }\n\n    section = (section !== undefined) ? section : StagePanelSection.Start;\n    const index = this._widgets.reduce((acc, info) => {\n      if (info.stageId === stageId && info.stageUsage === stageUsage && info.location === location && info.section === section)\n        return acc + 1;\n      return acc;\n    }, 0);\n    const stableId = getWidgetManagerStableWidgetId(stageUsage, location, section, index);\n    const stableWidget = createStableWidgetDef(widgetDef, stableId);\n    const newWidget: WidgetInfo = { widgetDef: stableWidget, stageId, stageUsage, location, section };\n\n    const oldWidgets = this._widgets.filter((info) => info.widgetDef.id !== newWidget.widgetDef.id);\n    const updatedWidgets = [\n      ...oldWidgets,\n      newWidget,\n    ];\n    this.widgets = updatedWidgets;\n\n    return true;\n  }\n\n  /** Removes a WidgetDef.\n   */\n  public removeWidgetDef(widgetId: string): boolean {\n    let result = false;\n    const updatedWidgets = this._widgets.filter((info) => info.widgetDef.id !== widgetId);\n\n    if (updatedWidgets.length !== this._widgets.length) {\n      this.widgets = updatedWidgets;\n      result = true;\n    }\n\n    return result;\n  }\n\n  /** Gets WidgetDefs for a Frontstage location.\n   */\n  public getWidgetDefs(stageId: string, stageUsage: string, location: StagePanelLocation, section?: StagePanelSection): ReadonlyArray<WidgetDef> | undefined {\n    const definedSection = section === undefined ? StagePanelSection.Start : section;\n\n    const widgetInfos = this._widgets.filter((info) => {\n      return (!info.stageId || info.stageId === stageId)\n        && (!info.stageUsage || info.stageUsage === stageUsage)\n        && info.location === location\n        && info.section === definedSection;\n    });\n\n    const widgetDefs = widgetInfos.map((info) => info.widgetDef);\n\n    // Consult the UiItemsManager to get any Abstract widgets\n    const widgets = UiItemsManager.getWidgets(stageId, stageUsage, location, definedSection);\n    widgets.forEach((abstractProps: AbstractWidgetProps, index: number) => {\n      const stableId = getAddonStableWidgetId(stageUsage, location, definedSection, index);\n      const config = createWidgetConfigFromAbstractProps(abstractProps, stableId);\n      const widgetDef = WidgetDef.create(config);\n      widgetDefs.push(widgetDef);\n    });\n    return widgetDefs.length > 0 ? widgetDefs : undefined;\n  }\n}\n\nfunction createWidgetConfigFromAbstractProps(props: AbstractWidgetProps, stableId: WidgetConfig[\"id\"]): WidgetConfig {\n  const config: WidgetConfig = {\n    id: props.id ? props.id : stableId,\n    element: props.getWidgetContent(),\n    ...props,\n  };\n  return config;\n}\n"]}
+{"version":3,"file":"WidgetManager.js","sourceRoot":"","sources":["../../../../src/appui-react/widgets/WidgetManager.ts"],"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/* eslint-disable deprecation/deprecation */\r\n/** @packageDocumentation\r\n * @module Widget\r\n */\r\n\r\nimport { BeUiEvent, Logger } from \"@itwin/core-bentley\";\r\nimport { AbstractWidgetProps, AbstractZoneLocation, StagePanelLocation, StagePanelSection, UiItemsManager } from \"@itwin/appui-abstract\";\r\nimport { UiFramework } from \"../UiFramework\";\r\nimport { getStableWidgetProps, ZoneLocation } from \"../zones/Zone\";\r\nimport { WidgetDef } from \"./WidgetDef\";\r\nimport { createStableWidgetDef } from \"./StableWidgetDef\";\r\n\r\n/** Information about WidgetDefs in the WidgetManager\r\n * @internal\r\n */\r\nexport interface WidgetInfo {\r\n  widgetDef: WidgetDef;\r\n  stageId?: string;\r\n  stageUsage?: string;\r\n  location: ZoneLocation | StagePanelLocation;\r\n  section: StagePanelSection;\r\n}\r\n\r\n/** Arguments of [[this.onWidgetsChanged]] event.\r\n * @internal\r\n */\r\nexport interface WidgetsChangedEventArgs {\r\n  readonly items: ReadonlyArray<WidgetInfo>;\r\n}\r\n\r\n/** Event class for [[this.onWidgetsChanged]].\r\n * @internal\r\n */\r\nexport class WidgetsChangedEvent extends BeUiEvent<WidgetsChangedEventArgs> { }\r\n\r\nfunction isZoneLocation(location: ZoneLocation | StagePanelLocation): location is ZoneLocation {\r\n  return location >= ZoneLocation.TopLeft && location <= ZoneLocation.BottomRight;\r\n}\r\n\r\nfunction getLocationName(location: ZoneLocation | StagePanelLocation) {\r\n  return isZoneLocation(location) ? ZoneLocation[location] : StagePanelLocation[location];\r\n}\r\n\r\nfunction getWidgetManagerStableWidgetId(stageUsage: string | undefined, location: ZoneLocation | StagePanelLocation, section: StagePanelSection,\r\n  index: number) {\r\n  return `uifw-wm-${stageUsage || \"\"}-${getLocationName(location)}-${StagePanelSection[section]}-${index}`;\r\n}\r\n\r\nfunction getAddonStableWidgetId(stageUsage: string, location: StagePanelLocation, section: StagePanelSection, index: number) {\r\n  return `uifw-addon-${stageUsage}-${StagePanelLocation[location]}-${StagePanelSection[section]}-${index}`;\r\n}\r\n\r\n/** Widget Manager class.\r\n * @beta\r\n */\r\nexport class WidgetManager {\r\n  private _widgets: ReadonlyArray<WidgetInfo> = [];\r\n\r\n  /** Event raised when Widgets are changed.\r\n   * @internal\r\n   */\r\n  public readonly onWidgetsChanged = new WidgetsChangedEvent();\r\n\r\n  /** @internal */\r\n  public get widgetCount(): number {\r\n    return this._widgets.length;\r\n  }\r\n\r\n  /** @internal */\r\n  public get widgets(): ReadonlyArray<WidgetInfo> { return this._widgets; }\r\n  public set widgets(w: ReadonlyArray<WidgetInfo>) {\r\n    this._widgets = w;\r\n    this.onWidgetsChanged.emit({ items: w });\r\n  }\r\n\r\n  /** Adds a WidgetDef for use in a Frontstage.\r\n   * @note Added `widgetDef` must return unique id to correctly save/restore App layout.\r\n   * Semi-stable id is generated when auto-generated `widgetDef` id is detected,\r\n   * but correctness of such id depends on `addWidgetDef` call order and widget location.\r\n   */\r\n  public addWidgetDef(widgetDef: WidgetDef, stageId: string | undefined, stageUsage: string | undefined, location: ZoneLocation | StagePanelLocation, section?: StagePanelSection): boolean {\r\n    if (stageId === undefined && stageUsage === undefined) {\r\n      Logger.logError(UiFramework.loggerCategory(this), `addWidgetDef: stageId or stageUsage param must be specified`);\r\n      return false;\r\n    }\r\n\r\n    section = (section !== undefined) ? section : StagePanelSection.Start;\r\n    const index = this._widgets.reduce((acc, info) => {\r\n      if (info.stageId === stageId && info.stageUsage === stageUsage && info.location === location && info.section === section)\r\n        return acc + 1;\r\n      return acc;\r\n    }, 0);\r\n    const stableId = getWidgetManagerStableWidgetId(stageUsage, location, section, index);\r\n    const stableWidget = createStableWidgetDef(widgetDef, stableId);\r\n    const newWidget: WidgetInfo = { widgetDef: stableWidget, stageId, stageUsage, location, section };\r\n\r\n    const oldWidgets = this._widgets.filter((info) => info.widgetDef.id !== newWidget.widgetDef.id);\r\n    const updatedWidgets = [\r\n      ...oldWidgets,\r\n      newWidget,\r\n    ];\r\n    this.widgets = updatedWidgets;\r\n\r\n    return true;\r\n  }\r\n\r\n  /** Removes a WidgetDef.\r\n   */\r\n  public removeWidgetDef(widgetId: string): boolean {\r\n    let result = false;\r\n    const updatedWidgets = this._widgets.filter((info) => info.widgetDef.id !== widgetId);\r\n\r\n    if (updatedWidgets.length !== this._widgets.length) {\r\n      this.widgets = updatedWidgets;\r\n      result = true;\r\n    }\r\n\r\n    return result;\r\n  }\r\n\r\n  // Used when WidgetDefs are requested from UiItemProviders when uiVersion=\"1\"\r\n  // istanbul ignore next\r\n  private getStagePanelLocationFromZoneLocation(location: ZoneLocation): StagePanelLocation | undefined {\r\n    switch (location) {\r\n      case ZoneLocation.BottomCenter:\r\n      case ZoneLocation.TopCenter:\r\n      case ZoneLocation.TopRight:\r\n      case ZoneLocation.TopLeft:\r\n        return undefined; // an existing stage does not support appending widgets to these zones\r\n      case ZoneLocation.BottomLeft:\r\n      case ZoneLocation.CenterLeft:\r\n        return StagePanelLocation.Left;\r\n      case ZoneLocation.BottomRight:\r\n      case ZoneLocation.CenterRight:\r\n        return StagePanelLocation.Right;\r\n    }\r\n  }\r\n\r\n  /** Gets WidgetDefs for a Frontstage location.\r\n   */\r\n  public getWidgetDefs(stageId: string, stageUsage: string, location: ZoneLocation | StagePanelLocation, section?: StagePanelSection,\r\n    frontstageApplicationData?: any): ReadonlyArray<WidgetDef> | undefined {\r\n    const definedSection = section === undefined ? StagePanelSection.Start : section;\r\n\r\n    const widgetInfos = this._widgets.filter((info) => {\r\n      return (!info.stageId || info.stageId === stageId)\r\n        && (!info.stageUsage || info.stageUsage === stageUsage)\r\n        && info.location === location\r\n        && info.section === definedSection;\r\n    });\r\n\r\n    const widgetDefs = widgetInfos.map((info) => info.widgetDef);\r\n\r\n    // Consult the UiItemsManager to get any Abstract widgets\r\n    if (location in StagePanelLocation) {\r\n      const widgets = UiItemsManager.getWidgets(stageId, stageUsage, location as StagePanelLocation, definedSection, undefined, frontstageApplicationData);\r\n      widgets.forEach((abstractProps: AbstractWidgetProps, index: number) => {\r\n        const props = WidgetDef.createWidgetPropsFromAbstractProps(abstractProps);\r\n        const stableId = getAddonStableWidgetId(stageUsage, location as StagePanelLocation, definedSection, index);\r\n        const stableProps = getStableWidgetProps(props, stableId);\r\n        const wd = new WidgetDef(stableProps);\r\n        widgetDefs.push(wd);\r\n      });\r\n    } else {\r\n      // istanbul ignore else\r\n      if (location in ZoneLocation) {\r\n        const panelLocation = this.getStagePanelLocationFromZoneLocation(location as ZoneLocation);\r\n        // istanbul ignore else\r\n        if (panelLocation && location in AbstractZoneLocation) {\r\n          const widgets = UiItemsManager.getWidgets(stageId, stageUsage, panelLocation, undefined, location as unknown as AbstractZoneLocation, frontstageApplicationData);\r\n          widgets.forEach((abstractProps: AbstractWidgetProps, index: number) => {\r\n            const props = WidgetDef.createWidgetPropsFromAbstractProps(abstractProps);\r\n            const stableId = getAddonStableWidgetId(stageUsage, location as StagePanelLocation, definedSection, index);\r\n            const stableProps = getStableWidgetProps(props, stableId);\r\n            const wd = new WidgetDef(stableProps);\r\n            widgetDefs.push(wd);\r\n          });\r\n        }\r\n      }\r\n    }\r\n\r\n    return widgetDefs.length > 0 ? widgetDefs : undefined;\r\n  }\r\n}\r\n"]}

package/lib/cjs/appui-react/widgets/WidgetProps.d.ts

@@ -0,0 +1,33 @@
+/** @packageDocumentation
+ * @module Widget
+ */
+import * as React from "react";
+import { AbstractWidgetProps } from "@itwin/appui-abstract";
+import { IconProps } from "@itwin/core-react";
+import { ConfigurableUiControlConstructor } from "../configurableui/ConfigurableUiControl";
+/** Properties for a [[Widget]] component.
+ * @deprecated in 3.5. Props of a deprecated component.
+ * @public
+ */
+export interface WidgetProps extends Omit<AbstractWidgetProps, "getWidgetContent">, IconProps {
+    /** if set, it is used to define a key that is used to look up a localized string. This value is used only if label is not explicitly set. */
+    labelKey?: string;
+    /** if set, it is used to define a key that is used to look up a localized string. This value is used only if tooltip is not explicitly set. */
+    tooltipKey?: string;
+    /** A [[WidgetControl]] providing information about the Widget. */
+    control?: ConfigurableUiControlConstructor;
+    /** A React component for the Widget. */
+    element?: React.ReactNode;
+    /** Control's class id */
+    classId?: string | ConfigurableUiControlConstructor;
+    /** @alpha */
+    preferredPanelSize?: "fit-content";
+}
+/** Properties of a Widget.
+ * @beta
+ */
+export interface CommonWidgetProps extends Readonly<AbstractWidgetProps> {
+    /** Id used to uniquely identify the widget. */
+    readonly id: string;
+}
+//# sourceMappingURL=WidgetProps.d.ts.map

package/lib/cjs/appui-react/widgets/WidgetProps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WidgetProps.d.ts","sourceRoot":"","sources":["../../../../src/appui-react/widgets/WidgetProps.tsx"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,gCAAgC,EAAE,MAAM,yCAAyC,CAAC;AAE3F;;;GAGG;AACH,MAAM,WAAW,WAAY,SAAQ,IAAI,CAAC,mBAAmB,EAAE,kBAAkB,CAAC,EAAE,SAAS;IAC3F,6IAA6I;IAC7I,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+IAA+I;IAC/I,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,OAAO,CAAC,EAAE,gCAAgC,CAAC;IAC3C,wCAAwC;IACxC,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,GAAG,gCAAgC,CAAC;IACpD,aAAa;IACb,kBAAkB,CAAC,EAAE,aAAa,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,QAAQ,CAAC,mBAAmB,CAAC;IACtE,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB"}

package/lib/cjs/appui-react/widgets/WidgetProps.js

@@ -0,0 +1,10 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Widget
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=WidgetProps.js.map

package/lib/cjs/appui-react/widgets/WidgetProps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WidgetProps.js","sourceRoot":"","sources":["../../../../src/appui-react/widgets/WidgetProps.tsx"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG","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/** @packageDocumentation\r\n * @module Widget\r\n */\r\n\r\nimport * as React from \"react\";\r\nimport { AbstractWidgetProps } from \"@itwin/appui-abstract\";\r\nimport { IconProps } from \"@itwin/core-react\";\r\nimport { ConfigurableUiControlConstructor } from \"../configurableui/ConfigurableUiControl\";\r\n\r\n/** Properties for a [[Widget]] component.\r\n * @deprecated in 3.5. Props of a deprecated component.\r\n * @public\r\n */\r\nexport interface WidgetProps extends Omit<AbstractWidgetProps, \"getWidgetContent\">, IconProps { // eslint-disable-line deprecation/deprecation\r\n  /** if set, it is used to define a key that is used to look up a localized string. This value is used only if label is not explicitly set. */\r\n  labelKey?: string;\r\n  /** if set, it is used to define a key that is used to look up a localized string. This value is used only if tooltip is not explicitly set. */\r\n  tooltipKey?: string;\r\n  /** A [[WidgetControl]] providing information about the Widget. */\r\n  control?: ConfigurableUiControlConstructor;\r\n  /** A React component for the Widget. */\r\n  element?: React.ReactNode;\r\n  /** Control's class id */\r\n  classId?: string | ConfigurableUiControlConstructor;\r\n  /** @alpha */\r\n  preferredPanelSize?: \"fit-content\";\r\n}\r\n\r\n/** Properties of a Widget.\r\n * @beta\r\n */\r\nexport interface CommonWidgetProps extends Readonly<AbstractWidgetProps> { // eslint-disable-line deprecation/deprecation\r\n  /** Id used to uniquely identify the widget. */\r\n  readonly id: string;\r\n}\r\n"]}