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

package/lib/esm/appui-react/backstage/Backstage.d.ts

@@ -0,0 +1,62 @@
+/** @packageDocumentation
+ * @module Backstage
+ */
+import * as React from "react";
+import { CommonProps, IconSpec, UiEvent } from "@itwin/core-react";
+/** [[BackstageEvent]] arguments.
+ * @public
+ * @deprecated in 3.6. Use [[BackstageComposer]] instead.
+ */
+export interface BackstageEventArgs {
+    isVisible: boolean;
+}
+/** Backstage Event class.
+ * @deprecated in 3.6. Use [[BackstageManager.onToggled]] instead.
+ * @public
+ */
+export declare class BackstageEvent extends UiEvent<BackstageEventArgs> {
+}
+/** Properties for the [[Backstage]] React component.
+ * @deprecated in 3.6. Props of a deprecated component.
+ * @public
+ */
+export interface BackstageProps extends CommonProps {
+    isVisible?: boolean;
+    showOverlay?: boolean;
+    onClose?: () => void;
+    header?: React.ReactNode;
+}
+/** State for the [[Backstage]] React component.
+ * @internal
+ */
+interface BackstageState {
+    isVisible: boolean;
+}
+/** Backstage React component.
+ * @deprecated in 3.6. Use [[BackstageComposer]] instead.
+ * @public
+ */
+export declare class Backstage extends React.Component<BackstageProps, BackstageState> {
+    static readonly onBackstageEvent: BackstageEvent;
+    static isBackstageVisible: boolean;
+    /** Shows the Backstage */
+    static show(): void;
+    /** Hides the Backstage */
+    static hide(): void;
+    /** Get CommandItemDef that will toggle display of Backstage and allow iconSpec to be overridden */
+    static getBackstageToggleCommand(overrideIconSpec?: IconSpec): import("../shared/CommandItemDef").CommandItemDef;
+    /** Command that toggles the Backstage */
+    static get backstageToggleCommand(): import("../shared/CommandItemDef").CommandItemDef;
+    /** @internal */
+    readonly state: BackstageState;
+    constructor(props: BackstageProps);
+    componentDidMount(): void;
+    componentWillUnmount(): void;
+    private _handleBackstageEvent;
+    componentDidUpdate(prevProps: BackstageProps): void;
+    private setIsOpen;
+    private _onClose;
+    render(): React.ReactNode;
+}
+export {};
+//# sourceMappingURL=Backstage.d.ts.map

package/lib/esm/appui-react/backstage/Backstage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Backstage.d.ts","sourceRoot":"","sources":["../../../../src/appui-react/backstage/Backstage.tsx"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAQnE;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;GAGG;AACH,qBAAa,cAAe,SAAQ,OAAO,CAAC,kBAAkB,CAAC;CAAI;AAEnE;;;GAGG;AACH,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC1B;AAED;;GAEG;AACH,UAAU,cAAc;IACtB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;GAGG;AACH,qBAAa,SAAU,SAAQ,KAAK,CAAC,SAAS,CAAC,cAAc,EAAE,cAAc,CAAC;IAE5E,gBAAuB,gBAAgB,iBAAwB;IAC/D,OAAc,kBAAkB,EAAE,OAAO,CAAC;IAE1C,0BAA0B;WACZ,IAAI,IAAI,IAAI;IAI1B,0BAA0B;WACZ,IAAI,IAAI,IAAI;IAI1B,mGAAmG;WACrF,yBAAyB,CAAC,gBAAgB,CAAC,EAAE,QAAQ;IAInE,yCAAyC;IACzC,WAAkB,sBAAsB,sDAEvC;IAED,gBAAgB;IAChB,SAAyB,KAAK,EAAE,cAAc,CAAC;gBAEnC,KAAK,EAAE,cAAc;IASjB,iBAAiB;IAIjB,oBAAoB;IAIpC,OAAO,CAAC,qBAAqB,CAE3B;IAEc,kBAAkB,CAAC,SAAS,EAAE,cAAc;IAK5D,OAAO,CAAC,SAAS;IAQjB,OAAO,CAAC,QAAQ,CAMd;IAEc,MAAM,IAAI,KAAK,CAAC,SAAS;CA0B1C"}

package/lib/esm/appui-react/backstage/Backstage.js

@@ -0,0 +1,84 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Backstage
+ */
+import * as React from "react";
+import { UiEvent } from "@itwin/core-react";
+import { Backstage as NZ_Backstage } from "@itwin/appui-layout-react";
+import { SafeAreaContext } from "../safearea/SafeAreaContext";
+import { UiFramework } from "../UiFramework";
+import { BackstageManager } from "./BackstageManager";
+/** Backstage Event class.
+ * @deprecated in 3.6. Use [[BackstageManager.onToggled]] instead.
+ * @public
+ */
+export class BackstageEvent extends UiEvent {
+} // eslint-disable-line deprecation/deprecation
+/** Backstage React component.
+ * @deprecated in 3.6. Use [[BackstageComposer]] instead.
+ * @public
+ */
+export class Backstage extends React.Component {
+    constructor(props) {
+        super(props);
+        this._handleBackstageEvent = (args) => {
+            this.setState({ isVisible: args.isVisible });
+        };
+        this._onClose = () => {
+            Backstage.hide(); // eslint-disable-line deprecation/deprecation
+            /* istanbul ignore else */
+            if (this.props.onClose)
+                this.props.onClose();
+        };
+        this.setIsOpen(!!this.props.isVisible);
+        this.state = {
+            isVisible: UiFramework.backstageManager.isOpen,
+        };
+    }
+    /** Shows the Backstage */
+    static show() {
+        UiFramework.backstageManager.open();
+    }
+    /** Hides the Backstage */
+    static hide() {
+        UiFramework.backstageManager.close();
+    }
+    /** Get CommandItemDef that will toggle display of Backstage and allow iconSpec to be overridden */
+    static getBackstageToggleCommand(overrideIconSpec) {
+        return BackstageManager.getBackstageToggleCommand(overrideIconSpec);
+    }
+    /** Command that toggles the Backstage */
+    static get backstageToggleCommand() {
+        return this.getBackstageToggleCommand();
+    }
+    componentDidMount() {
+        Backstage.onBackstageEvent.addListener(this._handleBackstageEvent); // eslint-disable-line deprecation/deprecation
+    }
+    componentWillUnmount() {
+        Backstage.onBackstageEvent.removeListener(this._handleBackstageEvent); // eslint-disable-line deprecation/deprecation
+    }
+    componentDidUpdate(prevProps) {
+        if (this.props.isVisible !== prevProps.isVisible)
+            this.setIsOpen(!!this.props.isVisible);
+    }
+    setIsOpen(isOpen) {
+        if (isOpen) {
+            UiFramework.backstageManager.open();
+        }
+        else {
+            UiFramework.backstageManager.close();
+        }
+    }
+    render() {
+        Backstage.isBackstageVisible = this.state.isVisible; // eslint-disable-line deprecation/deprecation
+        let header = null;
+        if (this.props.header)
+            header = this.props.header;
+        return (React.createElement(SafeAreaContext.Consumer, null, (safeAreaInsets) => (React.createElement(NZ_Backstage, { className: this.props.className, header: header, isOpen: this.state.isVisible, onClose: this._onClose, safeAreaInsets: safeAreaInsets, showOverlay: this.props.showOverlay, style: this.props.style }, this.props.children))));
+    }
+}
+Backstage.onBackstageEvent = new BackstageEvent(); // eslint-disable-line deprecation/deprecation
+//# sourceMappingURL=Backstage.js.map

package/lib/esm/appui-react/backstage/Backstage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Backstage.js","sourceRoot":"","sources":["../../../../src/appui-react/backstage/Backstage.tsx"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Backstage\r\n */\r\n\r\nimport * as React from \"react\";\r\nimport { CommonProps, IconSpec, UiEvent } from \"@itwin/core-react\";\r\nimport { Backstage as NZ_Backstage } from \"@itwin/appui-layout-react\";\r\nimport { SafeAreaContext } from \"../safearea/SafeAreaContext\";\r\nimport { UiFramework } from \"../UiFramework\";\r\nimport { BackstageManager } from \"./BackstageManager\";\r\n\r\n// cSpell:ignore safearea\r\n\r\n/** [[BackstageEvent]] arguments.\r\n * @public\r\n * @deprecated in 3.6. Use [[BackstageComposer]] instead.\r\n */\r\nexport interface BackstageEventArgs {\r\n  isVisible: boolean;\r\n}\r\n\r\n/** Backstage Event class.\r\n * @deprecated in 3.6. Use [[BackstageManager.onToggled]] instead.\r\n * @public\r\n */\r\nexport class BackstageEvent extends UiEvent<BackstageEventArgs> { } // eslint-disable-line deprecation/deprecation\r\n\r\n/** Properties for the [[Backstage]] React component.\r\n * @deprecated in 3.6. Props of a deprecated component.\r\n * @public\r\n */\r\nexport interface BackstageProps extends CommonProps {\r\n  isVisible?: boolean;\r\n  showOverlay?: boolean;\r\n  onClose?: () => void;\r\n  header?: React.ReactNode;\r\n}\r\n\r\n/** State for the [[Backstage]] React component.\r\n * @internal\r\n */\r\ninterface BackstageState {\r\n  isVisible: boolean;\r\n}\r\n\r\n/** Backstage React component.\r\n * @deprecated in 3.6. Use [[BackstageComposer]] instead.\r\n * @public\r\n */\r\nexport class Backstage extends React.Component<BackstageProps, BackstageState> { // eslint-disable-line deprecation/deprecation\r\n\r\n  public static readonly onBackstageEvent = new BackstageEvent(); // eslint-disable-line deprecation/deprecation\r\n  public static isBackstageVisible: boolean;\r\n\r\n  /** Shows the Backstage */\r\n  public static show(): void {\r\n    UiFramework.backstageManager.open();\r\n  }\r\n\r\n  /** Hides the Backstage */\r\n  public static hide(): void {\r\n    UiFramework.backstageManager.close();\r\n  }\r\n\r\n  /** Get CommandItemDef that will toggle display of Backstage and allow iconSpec to be overridden */\r\n  public static getBackstageToggleCommand(overrideIconSpec?: IconSpec) {\r\n    return BackstageManager.getBackstageToggleCommand(overrideIconSpec);\r\n  }\r\n\r\n  /** Command that toggles the Backstage */\r\n  public static get backstageToggleCommand() {\r\n    return this.getBackstageToggleCommand();\r\n  }\r\n\r\n  /** @internal */\r\n  public override readonly state: BackstageState;\r\n\r\n  constructor(props: BackstageProps) { // eslint-disable-line deprecation/deprecation\r\n    super(props);\r\n\r\n    this.setIsOpen(!!this.props.isVisible);\r\n    this.state = {\r\n      isVisible: UiFramework.backstageManager.isOpen,\r\n    };\r\n  }\r\n\r\n  public override componentDidMount() {\r\n    Backstage.onBackstageEvent.addListener(this._handleBackstageEvent); // eslint-disable-line deprecation/deprecation\r\n  }\r\n\r\n  public override componentWillUnmount() {\r\n    Backstage.onBackstageEvent.removeListener(this._handleBackstageEvent); // eslint-disable-line deprecation/deprecation\r\n  }\r\n\r\n  private _handleBackstageEvent = (args: BackstageEventArgs) => { // eslint-disable-line deprecation/deprecation\r\n    this.setState({ isVisible: args.isVisible });\r\n  };\r\n\r\n  public override componentDidUpdate(prevProps: BackstageProps) { // eslint-disable-line deprecation/deprecation\r\n    if (this.props.isVisible !== prevProps.isVisible)\r\n      this.setIsOpen(!!this.props.isVisible);\r\n  }\r\n\r\n  private setIsOpen(isOpen: boolean) {\r\n    if (isOpen) {\r\n      UiFramework.backstageManager.open();\r\n    } else {\r\n      UiFramework.backstageManager.close();\r\n    }\r\n  }\r\n\r\n  private _onClose = () => {\r\n    Backstage.hide(); // eslint-disable-line deprecation/deprecation\r\n\r\n    /* istanbul ignore else */\r\n    if (this.props.onClose)\r\n      this.props.onClose();\r\n  };\r\n\r\n  public override render(): React.ReactNode {\r\n    Backstage.isBackstageVisible = this.state.isVisible; // eslint-disable-line deprecation/deprecation\r\n\r\n    let header: React.ReactNode = null;\r\n\r\n    if (this.props.header)\r\n      header = this.props.header;\r\n\r\n    return (\r\n      <SafeAreaContext.Consumer>\r\n        {(safeAreaInsets) => (\r\n          <NZ_Backstage\r\n            className={this.props.className}\r\n            header={header}\r\n            isOpen={this.state.isVisible}\r\n            onClose={this._onClose}\r\n            safeAreaInsets={safeAreaInsets}\r\n            showOverlay={this.props.showOverlay}\r\n            style={this.props.style}\r\n          >\r\n            {this.props.children}\r\n          </NZ_Backstage>\r\n        )}\r\n      </SafeAreaContext.Consumer>\r\n    );\r\n  }\r\n}\r\n"]}

package/lib/esm/appui-react/backstage/BackstageComposer.d.ts

@@ -1,28 +1,28 @@
-/** @packageDocumentation
- * @module Backstage
- */
-import * as React from "react";
-import { BackstageItem } from "@itwin/appui-abstract";
-import { CommonProps } from "@itwin/core-react";
-/** @internal */
-export declare type GroupedItems = ReadonlyArray<ReadonlyArray<BackstageItem>>;
-/** @internal */
-export declare const useGroupedItems: (items: ReadonlyArray<BackstageItem>) => GroupedItems;
-/** Props of [[BackstageComposer]] component.
- * @public
- */
-export interface BackstageComposerProps extends CommonProps {
-    /** React node for an optional header item */
-    readonly header?: React.ReactNode;
-    /** Indicates whether to place an overlay over the frontstage when the backstage is displayed */
-    readonly showOverlay?: boolean;
-    /** List of static backstage items to show. Can be undefined in UiItemsProviders are used to populate backstage. */
-    readonly items?: BackstageItem[];
-    /** If true and only one stage launcher item is found, do not show entry in backstage */
-    readonly hideSoloStageEntry?: boolean;
-}
-/** Backstage component composed from [[BackstageManager]] items.
- * @public
- */
-export declare function BackstageComposer(props: BackstageComposerProps): JSX.Element;
+/** @packageDocumentation
+ * @module Backstage
+ */
+import * as React from "react";
+import { BackstageItem } from "@itwin/appui-abstract";
+import { CommonProps } from "@itwin/core-react";
+/** @internal */
+export declare type GroupedItems = ReadonlyArray<ReadonlyArray<BackstageItem>>;
+/** @internal */
+export declare const useGroupedItems: (items: ReadonlyArray<BackstageItem>) => GroupedItems;
+/** Props of [[BackstageComposer]] component.
+ * @public
+ */
+export interface BackstageComposerProps extends CommonProps {
+    /** React node for an optional header item */
+    readonly header?: React.ReactNode;
+    /** Indicates whether to place an overlay over the frontstage when the backstage is displayed */
+    readonly showOverlay?: boolean;
+    /** List of static backstage items to show. Can be undefined in UiItemsProviders are used to populate backstage. */
+    readonly items?: BackstageItem[];
+    /** If true and only one stage launcher item is found, do not show entry in backstage */
+    readonly hideSoloStageEntry?: boolean;
+}
+/** Backstage component composed from [[BackstageManager]] items.
+ * @public
+ */
+export declare function BackstageComposer(props: BackstageComposerProps): JSX.Element;
 //# sourceMappingURL=BackstageComposer.d.ts.map

package/lib/esm/appui-react/backstage/BackstageComposer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BackstageComposer.d.ts","sourceRoot":"","sources":["../../../../src/appui-react/backstage/BackstageComposer.tsx"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,aAAa,EAAoF,MAAM,uBAAuB,CAAC;AACxI,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAuEhD,gBAAgB;AAChB,oBAAY,YAAY,GAAG,aAAa,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,CAAC;AAEvE,gBAAgB;AAChB,eAAO,MAAM,eAAe,UAAW,cAAc,aAAa,CAAC,iBA+BlE,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,WAAW;IACzD,6CAA6C;IAC7C,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAClC,gGAAgG;IAChG,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,mHAAmH;IACnH,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,EAAE,CAAC;IACjC,wFAAwF;IACxF,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;CACvC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,eA0D9D"}
+{"version":3,"file":"BackstageComposer.d.ts","sourceRoot":"","sources":["../../../../src/appui-react/backstage/BackstageComposer.tsx"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,aAAa,EAAoF,MAAM,uBAAuB,CAAC;AACxI,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAwEhD,gBAAgB;AAChB,oBAAY,YAAY,GAAG,aAAa,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,CAAC;AAEvE,gBAAgB;AAChB,eAAO,MAAM,eAAe,UAAW,cAAc,aAAa,CAAC,iBA+BlE,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,WAAW;IACzD,6CAA6C;IAC7C,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAClC,gGAAgG;IAChG,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,mHAAmH;IACnH,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,EAAE,CAAC;IACjC,wFAAwF;IACxF,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;CACvC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,eA0D9D"}

package/lib/esm/appui-react/backstage/BackstageComposer.js

@@ -1,137 +1,137 @@
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-/** @packageDocumentation
- * @module Backstage
- */
-import * as React from "react";
-import { BackstageItemsManager, ConditionalBooleanValue, isStageLauncher } from "@itwin/appui-abstract";
-import { BackstageSeparator, Backstage as NZ_Backstage } from "@itwin/appui-layout-react";
-import { SafeAreaContext } from "../safearea/SafeAreaContext";
-import { SyncUiEventDispatcher } from "../syncui/SyncUiEventDispatcher";
-import { BackstageComposerItem } from "./BackstageComposerItem";
-import { useBackstageManager, useIsBackstageOpen } from "./BackstageManager";
-import { useDefaultBackstageItems } from "./useDefaultBackstageItems";
-import { useUiItemsProviderBackstageItems } from "./useUiItemsProviderBackstageItems";
-import { toLayoutSafeAreaInsets } from "../safearea/SafeAreaHelpers";
-// cSpell:ignore safearea
-/** Private function to set up sync event monitoring of backstage items */
-function useBackstageItemSyncEffect(itemsManager, syncIdsOfInterest) {
-    const isInitialMount = React.useRef(true);
-    React.useEffect(() => {
-        const handleSyncUiEvent = (args) => {
-            if (0 === syncIdsOfInterest.length)
-                return;
-            // istanbul ignore else
-            if (syncIdsOfInterest.some((value) => args.eventIds.has(value.toLowerCase()))) {
-                // process each item that has interest
-                itemsManager.refreshAffectedItems(args.eventIds);
-            }
-        };
-        if (isInitialMount.current) {
-            isInitialMount.current = false;
-            // initialize the display state of any items with syncIds/condition defined
-            itemsManager.refreshAffectedItems(new Set(syncIdsOfInterest));
-        }
-        SyncUiEventDispatcher.onSyncUiEvent.addListener(handleSyncUiEvent);
-        return () => {
-            SyncUiEventDispatcher.onSyncUiEvent.removeListener(handleSyncUiEvent);
-        };
-    }, [itemsManager, itemsManager.items, syncIdsOfInterest]);
-}
-/** local function to combine items from Stage and from Extensions */
-function combineItems(stageItems, addonItems, hideSoloStageEntry) {
-    let items = [];
-    if (stageItems.length) {
-        // Walk through each and ensure no duplicate ids are added.
-        stageItems.forEach((srcItem) => {
-            if (-1 === items.findIndex((item) => item.id === srcItem.id)) {
-                items.push(srcItem);
-            }
-        });
-    }
-    if (addonItems.length) {
-        // Walk through each and ensure no duplicate ids are added.
-        addonItems.forEach((srcItem) => {
-            if (-1 === items.findIndex((item) => item.id === srcItem.id)) {
-                items.push(srcItem);
-            }
-        });
-    }
-    if (hideSoloStageEntry) {
-        // per user request don't show stage launcher if only one stage is available
-        const numberOfFrontstageItems = items.reduce((accumulator, item) => accumulator + (isStageLauncher(item) ? 1 : 0), 0);
-        if (1 === numberOfFrontstageItems)
-            items = items.filter((item) => !isStageLauncher(item));
-    }
-    return items;
-}
-/** @internal */
-export const useGroupedItems = (items) => {
-    return React.useMemo(() => {
-        const grouped = items.reduce((acc, item) => {
-            if (ConditionalBooleanValue.getValue(item.isHidden))
-                return acc;
-            const groupIndex = acc.findIndex((group) => group[0].groupPriority === item.groupPriority);
-            if (groupIndex >= 0)
-                return [
-                    ...acc.slice(0, groupIndex),
-                    [
-                        ...acc[groupIndex],
-                        item,
-                    ],
-                    ...acc.slice(groupIndex + 1),
-                ];
-            return [
-                ...acc,
-                [
-                    item,
-                ],
-            ];
-        }, []);
-        const sortedGroups = grouped.reduce((acc, group) => {
-            const sortedGroup = [...group].sort((a, b) => a.itemPriority - b.itemPriority);
-            return [
-                ...acc,
-                sortedGroup,
-            ];
-        }, []);
-        return [...sortedGroups].sort((a, b) => a[0].groupPriority - b[0].groupPriority);
-    }, [items]);
-};
-/** Backstage component composed from [[BackstageManager]] items.
- * @public
- */
-export function BackstageComposer(props) {
-    const [defaultItemsManager, setDefaultItemsManager] = React.useState(new BackstageItemsManager(props.items));
-    const initialItems = React.useRef(props.items);
-    React.useEffect(() => {
-        if (initialItems.current !== props.items) {
-            initialItems.current = props.items;
-            setDefaultItemsManager(new BackstageItemsManager(props.items));
-        }
-    }, [props.items]);
-    const manager = useBackstageManager();
-    const isOpen = useIsBackstageOpen(manager);
-    const safeAreaInsets = React.useContext(SafeAreaContext);
-    const handleClose = React.useCallback(() => {
-        manager.close();
-    }, [manager]);
-    const defaultItems = useDefaultBackstageItems(defaultItemsManager);
-    const syncIdsOfInterest = React.useMemo(() => BackstageItemsManager.getSyncIdsOfInterest(defaultItems), [defaultItems]);
-    useBackstageItemSyncEffect(defaultItemsManager, syncIdsOfInterest);
-    const [addonItemsManager] = React.useState(new BackstageItemsManager());
-    const addonItems = useUiItemsProviderBackstageItems(addonItemsManager);
-    const addonSyncIdsOfInterest = React.useMemo(() => BackstageItemsManager.getSyncIdsOfInterest(addonItems), [addonItems]);
-    useBackstageItemSyncEffect(addonItemsManager, addonSyncIdsOfInterest);
-    const combinedBackstageItems = React.useMemo(() => combineItems(defaultItems, addonItems, !!props.hideSoloStageEntry), [defaultItems, addonItems, props.hideSoloStageEntry]);
-    const groups = useGroupedItems(combinedBackstageItems);
-    return (React.createElement(NZ_Backstage, { className: props.className, header: props.header, isOpen: isOpen, onClose: handleClose, safeAreaInsets: toLayoutSafeAreaInsets(safeAreaInsets), showOverlay: props.showOverlay, style: props.style }, groups.map((group, groupIndex) => (group.map((item, itemIndex) => {
-        const composerItem = (React.createElement(BackstageComposerItem, { item: item, key: item.id }));
-        return itemIndex === 0 && groupIndex > 0 ? (React.createElement(React.Fragment, { key: groupIndex },
-            React.createElement(BackstageSeparator, null),
-            composerItem)) : composerItem;
-    })))));
-}
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Backstage
+ */
+import * as React from "react";
+import { BackstageItemsManager, ConditionalBooleanValue, isStageLauncher } from "@itwin/appui-abstract";
+import { BackstageSeparator, Backstage as NZ_Backstage } from "@itwin/appui-layout-react";
+import { SafeAreaContext } from "../safearea/SafeAreaContext";
+import { SyncUiEventDispatcher } from "../syncui/SyncUiEventDispatcher";
+import { BackstageComposerItem } from "./BackstageComposerItem";
+import { useBackstageManager, useIsBackstageOpen } from "./BackstageManager";
+import { useDefaultBackstageItems } from "./useDefaultBackstageItems";
+import { useUiItemsProviderBackstageItems } from "./useUiItemsProviderBackstageItems";
+// cSpell:ignore safearea
+/* eslint-disable deprecation/deprecation */
+/** Private function to set up sync event monitoring of backstage items */
+function useBackstageItemSyncEffect(itemsManager, syncIdsOfInterest) {
+    const isInitialMount = React.useRef(true);
+    React.useEffect(() => {
+        const handleSyncUiEvent = (args) => {
+            if (0 === syncIdsOfInterest.length)
+                return;
+            // istanbul ignore else
+            if (syncIdsOfInterest.some((value) => args.eventIds.has(value.toLowerCase()))) {
+                // process each item that has interest
+                itemsManager.refreshAffectedItems(args.eventIds);
+            }
+        };
+        if (isInitialMount.current) {
+            isInitialMount.current = false;
+            // initialize the display state of any items with syncIds/condition defined
+            itemsManager.refreshAffectedItems(new Set(syncIdsOfInterest));
+        }
+        SyncUiEventDispatcher.onSyncUiEvent.addListener(handleSyncUiEvent);
+        return () => {
+            SyncUiEventDispatcher.onSyncUiEvent.removeListener(handleSyncUiEvent);
+        };
+    }, [itemsManager, itemsManager.items, syncIdsOfInterest]);
+}
+/** local function to combine items from Stage and from Extensions */
+function combineItems(stageItems, addonItems, hideSoloStageEntry) {
+    let items = [];
+    if (stageItems.length) {
+        // Walk through each and ensure no duplicate ids are added.
+        stageItems.forEach((srcItem) => {
+            if (-1 === items.findIndex((item) => item.id === srcItem.id)) {
+                items.push(srcItem);
+            }
+        });
+    }
+    if (addonItems.length) {
+        // Walk through each and ensure no duplicate ids are added.
+        addonItems.forEach((srcItem) => {
+            if (-1 === items.findIndex((item) => item.id === srcItem.id)) {
+                items.push(srcItem);
+            }
+        });
+    }
+    if (hideSoloStageEntry) {
+        // per user request don't show stage launcher if only one stage is available
+        const numberOfFrontstageItems = items.reduce((accumulator, item) => accumulator + (isStageLauncher(item) ? 1 : 0), 0);
+        if (1 === numberOfFrontstageItems)
+            items = items.filter((item) => !isStageLauncher(item));
+    }
+    return items;
+}
+/** @internal */
+export const useGroupedItems = (items) => {
+    return React.useMemo(() => {
+        const grouped = items.reduce((acc, item) => {
+            if (ConditionalBooleanValue.getValue(item.isHidden))
+                return acc;
+            const groupIndex = acc.findIndex((group) => group[0].groupPriority === item.groupPriority);
+            if (groupIndex >= 0)
+                return [
+                    ...acc.slice(0, groupIndex),
+                    [
+                        ...acc[groupIndex],
+                        item,
+                    ],
+                    ...acc.slice(groupIndex + 1),
+                ];
+            return [
+                ...acc,
+                [
+                    item,
+                ],
+            ];
+        }, []);
+        const sortedGroups = grouped.reduce((acc, group) => {
+            const sortedGroup = [...group].sort((a, b) => a.itemPriority - b.itemPriority);
+            return [
+                ...acc,
+                sortedGroup,
+            ];
+        }, []);
+        return [...sortedGroups].sort((a, b) => a[0].groupPriority - b[0].groupPriority);
+    }, [items]);
+};
+/** Backstage component composed from [[BackstageManager]] items.
+ * @public
+ */
+export function BackstageComposer(props) {
+    const [defaultItemsManager, setDefaultItemsManager] = React.useState(new BackstageItemsManager(props.items));
+    const initialItems = React.useRef(props.items);
+    React.useEffect(() => {
+        if (initialItems.current !== props.items) {
+            initialItems.current = props.items;
+            setDefaultItemsManager(new BackstageItemsManager(props.items));
+        }
+    }, [props.items]);
+    const manager = useBackstageManager();
+    const isOpen = useIsBackstageOpen(manager);
+    const safeAreaInsets = React.useContext(SafeAreaContext);
+    const handleClose = React.useCallback(() => {
+        manager.close();
+    }, [manager]);
+    const defaultItems = useDefaultBackstageItems(defaultItemsManager);
+    const syncIdsOfInterest = React.useMemo(() => BackstageItemsManager.getSyncIdsOfInterest(defaultItems), [defaultItems]);
+    useBackstageItemSyncEffect(defaultItemsManager, syncIdsOfInterest);
+    const [addonItemsManager] = React.useState(new BackstageItemsManager());
+    const addonItems = useUiItemsProviderBackstageItems(addonItemsManager);
+    const addonSyncIdsOfInterest = React.useMemo(() => BackstageItemsManager.getSyncIdsOfInterest(addonItems), [addonItems]);
+    useBackstageItemSyncEffect(addonItemsManager, addonSyncIdsOfInterest);
+    const combinedBackstageItems = React.useMemo(() => combineItems(defaultItems, addonItems, !!props.hideSoloStageEntry), [defaultItems, addonItems, props.hideSoloStageEntry]);
+    const groups = useGroupedItems(combinedBackstageItems);
+    return (React.createElement(NZ_Backstage, { className: props.className, header: props.header, isOpen: isOpen, onClose: handleClose, safeAreaInsets: safeAreaInsets, showOverlay: props.showOverlay, style: props.style }, groups.map((group, groupIndex) => (group.map((item, itemIndex) => {
+        const composerItem = (React.createElement(BackstageComposerItem, { item: item, key: item.id }));
+        return itemIndex === 0 && groupIndex > 0 ? (React.createElement(React.Fragment, { key: groupIndex },
+            React.createElement(BackstageSeparator, null),
+            composerItem)) : composerItem;
+    })))));
+}
 //# sourceMappingURL=BackstageComposer.js.map

package/lib/esm/appui-react/backstage/BackstageComposer.js.map

@@ -1 +1 @@
-{"version":3,"file":"BackstageComposer.js","sourceRoot":"","sources":["../../../../src/appui-react/backstage/BackstageComposer.tsx"],"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 Backstage\n */\n\nimport * as React from \"react\";\nimport { BackstageItem, BackstageItemsManager, ConditionalBooleanValue, isStageLauncher, UiSyncEventArgs } from \"@itwin/appui-abstract\";\nimport { CommonProps } from \"@itwin/core-react\";\nimport { BackstageSeparator, Backstage as NZ_Backstage } from \"@itwin/appui-layout-react\";\nimport { SafeAreaContext } from \"../safearea/SafeAreaContext\";\nimport { SyncUiEventDispatcher } from \"../syncui/SyncUiEventDispatcher\";\nimport { BackstageComposerItem } from \"./BackstageComposerItem\";\nimport { useBackstageManager, useIsBackstageOpen } from \"./BackstageManager\";\nimport { useDefaultBackstageItems } from \"./useDefaultBackstageItems\";\nimport { useUiItemsProviderBackstageItems } from \"./useUiItemsProviderBackstageItems\";\nimport { toLayoutSafeAreaInsets } from \"../safearea/SafeAreaHelpers\";\n\n// cSpell:ignore safearea\n\n/** Private function to set up sync event monitoring of backstage items */\nfunction useBackstageItemSyncEffect(itemsManager: BackstageItemsManager, syncIdsOfInterest: string[]) {\n  const isInitialMount = React.useRef(true);\n\n  React.useEffect(() => {\n    const handleSyncUiEvent = (args: UiSyncEventArgs) => {\n      if (0 === syncIdsOfInterest.length)\n        return;\n\n      // istanbul ignore else\n      if (syncIdsOfInterest.some((value: string): boolean => args.eventIds.has(value.toLowerCase()))) {\n        // process each item that has interest\n        itemsManager.refreshAffectedItems(args.eventIds);\n      }\n    };\n\n    if (isInitialMount.current) {\n      isInitialMount.current = false;\n      // initialize the display state of any items with syncIds/condition defined\n      itemsManager.refreshAffectedItems(new Set(syncIdsOfInterest));\n    }\n\n    SyncUiEventDispatcher.onSyncUiEvent.addListener(handleSyncUiEvent);\n    return () => {\n      SyncUiEventDispatcher.onSyncUiEvent.removeListener(handleSyncUiEvent);\n    };\n  }, [itemsManager, itemsManager.items, syncIdsOfInterest]);\n}\n\n/** local function to combine items from Stage and from Extensions */\nfunction combineItems(stageItems: ReadonlyArray<BackstageItem>, addonItems: ReadonlyArray<BackstageItem>, hideSoloStageEntry: boolean) {\n  let items: BackstageItem[] = [];\n  if (stageItems.length) {\n    // Walk through each and ensure no duplicate ids are added.\n    stageItems.forEach((srcItem) => {\n      if (-1 === items.findIndex((item) => item.id === srcItem.id)) {\n        items.push(srcItem);\n      }\n    });\n  }\n  if (addonItems.length) {\n    // Walk through each and ensure no duplicate ids are added.\n    addonItems.forEach((srcItem) => {\n      if (-1 === items.findIndex((item) => item.id === srcItem.id)) {\n        items.push(srcItem);\n      }\n    });\n  }\n\n  if (hideSoloStageEntry) {\n    // per user request don't show stage launcher if only one stage is available\n    const numberOfFrontstageItems = items.reduce((accumulator, item) => accumulator + (isStageLauncher(item) ? 1 : 0), 0);\n    if (1 === numberOfFrontstageItems)\n      items = items.filter((item) => !isStageLauncher(item));\n  }\n\n  return items;\n}\n\n/** @internal */\nexport type GroupedItems = ReadonlyArray<ReadonlyArray<BackstageItem>>;\n\n/** @internal */\nexport const useGroupedItems = (items: ReadonlyArray<BackstageItem>): GroupedItems => {\n  return React.useMemo(() => {\n    const grouped = items.reduce<GroupedItems>((acc, item) => {\n      if (ConditionalBooleanValue.getValue(item.isHidden))\n        return acc;\n      const groupIndex = acc.findIndex((group) => group[0].groupPriority === item.groupPriority);\n      if (groupIndex >= 0)\n        return [\n          ...acc.slice(0, groupIndex),\n          [\n            ...acc[groupIndex],\n            item,\n          ],\n          ...acc.slice(groupIndex + 1),\n        ];\n      return [\n        ...acc,\n        [\n          item,\n        ],\n      ];\n    }, []);\n    const sortedGroups = grouped.reduce<GroupedItems>((acc, group) => {\n      const sortedGroup = [...group].sort((a, b) => a.itemPriority - b.itemPriority);\n      return [\n        ...acc,\n        sortedGroup,\n      ];\n    }, []);\n    return [...sortedGroups].sort((a, b) => a[0].groupPriority - b[0].groupPriority);\n  }, [items]);\n};\n\n/** Props of [[BackstageComposer]] component.\n * @public\n */\nexport interface BackstageComposerProps extends CommonProps {\n  /** React node for an optional header item */\n  readonly header?: React.ReactNode;\n  /** Indicates whether to place an overlay over the frontstage when the backstage is displayed */\n  readonly showOverlay?: boolean;\n  /** List of static backstage items to show. Can be undefined in UiItemsProviders are used to populate backstage. */\n  readonly items?: BackstageItem[];\n  /** If true and only one stage launcher item is found, do not show entry in backstage */\n  readonly hideSoloStageEntry?: boolean;\n}\n\n/** Backstage component composed from [[BackstageManager]] items.\n * @public\n */\nexport function BackstageComposer(props: BackstageComposerProps) {\n  const [defaultItemsManager, setDefaultItemsManager] = React.useState(new BackstageItemsManager(props.items));\n  const initialItems = React.useRef(props.items);\n\n  React.useEffect(() => {\n    if (initialItems.current !== props.items) {\n      initialItems.current = props.items;\n      setDefaultItemsManager(new BackstageItemsManager(props.items));\n    }\n  }, [props.items]);\n\n  const manager = useBackstageManager();\n  const isOpen = useIsBackstageOpen(manager);\n  const safeAreaInsets = React.useContext(SafeAreaContext);\n  const handleClose = React.useCallback(() => {\n    manager.close();\n  }, [manager]);\n\n  const defaultItems = useDefaultBackstageItems(defaultItemsManager);\n  const syncIdsOfInterest = React.useMemo(() => BackstageItemsManager.getSyncIdsOfInterest(defaultItems), [defaultItems]);\n  useBackstageItemSyncEffect(defaultItemsManager, syncIdsOfInterest);\n\n  const [addonItemsManager] = React.useState(new BackstageItemsManager());\n  const addonItems = useUiItemsProviderBackstageItems(addonItemsManager);\n  const addonSyncIdsOfInterest = React.useMemo(() => BackstageItemsManager.getSyncIdsOfInterest(addonItems), [addonItems]);\n  useBackstageItemSyncEffect(addonItemsManager, addonSyncIdsOfInterest);\n\n  const combinedBackstageItems = React.useMemo(() => combineItems(defaultItems, addonItems, !!props.hideSoloStageEntry), [defaultItems, addonItems, props.hideSoloStageEntry]);\n  const groups = useGroupedItems(combinedBackstageItems);\n\n  return (\n    <NZ_Backstage\n      className={props.className}\n      header={props.header}\n      isOpen={isOpen}\n      onClose={handleClose}\n      safeAreaInsets={toLayoutSafeAreaInsets(safeAreaInsets)}\n      showOverlay={props.showOverlay}\n      style={props.style}\n    >\n      {groups.map((group, groupIndex) => (\n        group.map((item, itemIndex) => {\n          const composerItem = (\n            <BackstageComposerItem\n              item={item}\n              key={item.id}\n            />\n          );\n          return itemIndex === 0 && groupIndex > 0 ? (\n            <React.Fragment key={groupIndex}>\n              <BackstageSeparator />\n              {composerItem}\n            </React.Fragment>\n          ) : composerItem;\n        })\n      ))}\n    </NZ_Backstage>\n  );\n}\n"]}
+{"version":3,"file":"BackstageComposer.js","sourceRoot":"","sources":["../../../../src/appui-react/backstage/BackstageComposer.tsx"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Backstage\r\n */\r\n\r\nimport * as React from \"react\";\r\nimport { BackstageItem, BackstageItemsManager, ConditionalBooleanValue, isStageLauncher, UiSyncEventArgs } from \"@itwin/appui-abstract\";\r\nimport { CommonProps } from \"@itwin/core-react\";\r\nimport { BackstageSeparator, Backstage as NZ_Backstage } from \"@itwin/appui-layout-react\";\r\nimport { SafeAreaContext } from \"../safearea/SafeAreaContext\";\r\nimport { SyncUiEventDispatcher } from \"../syncui/SyncUiEventDispatcher\";\r\nimport { BackstageComposerItem } from \"./BackstageComposerItem\";\r\nimport { useBackstageManager, useIsBackstageOpen } from \"./BackstageManager\";\r\nimport { useDefaultBackstageItems } from \"./useDefaultBackstageItems\";\r\nimport { useUiItemsProviderBackstageItems } from \"./useUiItemsProviderBackstageItems\";\r\n\r\n// cSpell:ignore safearea\r\n\r\n/* eslint-disable deprecation/deprecation */\r\n\r\n/** Private function to set up sync event monitoring of backstage items */\r\nfunction useBackstageItemSyncEffect(itemsManager: BackstageItemsManager, syncIdsOfInterest: string[]) {\r\n  const isInitialMount = React.useRef(true);\r\n\r\n  React.useEffect(() => {\r\n    const handleSyncUiEvent = (args: UiSyncEventArgs) => {\r\n      if (0 === syncIdsOfInterest.length)\r\n        return;\r\n\r\n      // istanbul ignore else\r\n      if (syncIdsOfInterest.some((value: string): boolean => args.eventIds.has(value.toLowerCase()))) {\r\n        // process each item that has interest\r\n        itemsManager.refreshAffectedItems(args.eventIds);\r\n      }\r\n    };\r\n\r\n    if (isInitialMount.current) {\r\n      isInitialMount.current = false;\r\n      // initialize the display state of any items with syncIds/condition defined\r\n      itemsManager.refreshAffectedItems(new Set(syncIdsOfInterest));\r\n    }\r\n\r\n    SyncUiEventDispatcher.onSyncUiEvent.addListener(handleSyncUiEvent);\r\n    return () => {\r\n      SyncUiEventDispatcher.onSyncUiEvent.removeListener(handleSyncUiEvent);\r\n    };\r\n  }, [itemsManager, itemsManager.items, syncIdsOfInterest]);\r\n}\r\n\r\n/** local function to combine items from Stage and from Extensions */\r\nfunction combineItems(stageItems: ReadonlyArray<BackstageItem>, addonItems: ReadonlyArray<BackstageItem>, hideSoloStageEntry: boolean) {\r\n  let items: BackstageItem[] = [];\r\n  if (stageItems.length) {\r\n    // Walk through each and ensure no duplicate ids are added.\r\n    stageItems.forEach((srcItem) => {\r\n      if (-1 === items.findIndex((item) => item.id === srcItem.id)) {\r\n        items.push(srcItem);\r\n      }\r\n    });\r\n  }\r\n  if (addonItems.length) {\r\n    // Walk through each and ensure no duplicate ids are added.\r\n    addonItems.forEach((srcItem) => {\r\n      if (-1 === items.findIndex((item) => item.id === srcItem.id)) {\r\n        items.push(srcItem);\r\n      }\r\n    });\r\n  }\r\n\r\n  if (hideSoloStageEntry) {\r\n    // per user request don't show stage launcher if only one stage is available\r\n    const numberOfFrontstageItems = items.reduce((accumulator, item) => accumulator + (isStageLauncher(item) ? 1 : 0), 0);\r\n    if (1 === numberOfFrontstageItems)\r\n      items = items.filter((item) => !isStageLauncher(item));\r\n  }\r\n\r\n  return items;\r\n}\r\n\r\n/** @internal */\r\nexport type GroupedItems = ReadonlyArray<ReadonlyArray<BackstageItem>>;\r\n\r\n/** @internal */\r\nexport const useGroupedItems = (items: ReadonlyArray<BackstageItem>): GroupedItems => {\r\n  return React.useMemo(() => {\r\n    const grouped = items.reduce<GroupedItems>((acc, item) => {\r\n      if (ConditionalBooleanValue.getValue(item.isHidden))\r\n        return acc;\r\n      const groupIndex = acc.findIndex((group) => group[0].groupPriority === item.groupPriority);\r\n      if (groupIndex >= 0)\r\n        return [\r\n          ...acc.slice(0, groupIndex),\r\n          [\r\n            ...acc[groupIndex],\r\n            item,\r\n          ],\r\n          ...acc.slice(groupIndex + 1),\r\n        ];\r\n      return [\r\n        ...acc,\r\n        [\r\n          item,\r\n        ],\r\n      ];\r\n    }, []);\r\n    const sortedGroups = grouped.reduce<GroupedItems>((acc, group) => {\r\n      const sortedGroup = [...group].sort((a, b) => a.itemPriority - b.itemPriority);\r\n      return [\r\n        ...acc,\r\n        sortedGroup,\r\n      ];\r\n    }, []);\r\n    return [...sortedGroups].sort((a, b) => a[0].groupPriority - b[0].groupPriority);\r\n  }, [items]);\r\n};\r\n\r\n/** Props of [[BackstageComposer]] component.\r\n * @public\r\n */\r\nexport interface BackstageComposerProps extends CommonProps {\r\n  /** React node for an optional header item */\r\n  readonly header?: React.ReactNode;\r\n  /** Indicates whether to place an overlay over the frontstage when the backstage is displayed */\r\n  readonly showOverlay?: boolean;\r\n  /** List of static backstage items to show. Can be undefined in UiItemsProviders are used to populate backstage. */\r\n  readonly items?: BackstageItem[];\r\n  /** If true and only one stage launcher item is found, do not show entry in backstage */\r\n  readonly hideSoloStageEntry?: boolean;\r\n}\r\n\r\n/** Backstage component composed from [[BackstageManager]] items.\r\n * @public\r\n */\r\nexport function BackstageComposer(props: BackstageComposerProps) {\r\n  const [defaultItemsManager, setDefaultItemsManager] = React.useState(new BackstageItemsManager(props.items));\r\n  const initialItems = React.useRef(props.items);\r\n\r\n  React.useEffect(() => {\r\n    if (initialItems.current !== props.items) {\r\n      initialItems.current = props.items;\r\n      setDefaultItemsManager(new BackstageItemsManager(props.items));\r\n    }\r\n  }, [props.items]);\r\n\r\n  const manager = useBackstageManager();\r\n  const isOpen = useIsBackstageOpen(manager);\r\n  const safeAreaInsets = React.useContext(SafeAreaContext);\r\n  const handleClose = React.useCallback(() => {\r\n    manager.close();\r\n  }, [manager]);\r\n\r\n  const defaultItems = useDefaultBackstageItems(defaultItemsManager);\r\n  const syncIdsOfInterest = React.useMemo(() => BackstageItemsManager.getSyncIdsOfInterest(defaultItems), [defaultItems]);\r\n  useBackstageItemSyncEffect(defaultItemsManager, syncIdsOfInterest);\r\n\r\n  const [addonItemsManager] = React.useState(new BackstageItemsManager());\r\n  const addonItems = useUiItemsProviderBackstageItems(addonItemsManager);\r\n  const addonSyncIdsOfInterest = React.useMemo(() => BackstageItemsManager.getSyncIdsOfInterest(addonItems), [addonItems]);\r\n  useBackstageItemSyncEffect(addonItemsManager, addonSyncIdsOfInterest);\r\n\r\n  const combinedBackstageItems = React.useMemo(() => combineItems(defaultItems, addonItems, !!props.hideSoloStageEntry), [defaultItems, addonItems, props.hideSoloStageEntry]);\r\n  const groups = useGroupedItems(combinedBackstageItems);\r\n\r\n  return (\r\n    <NZ_Backstage\r\n      className={props.className}\r\n      header={props.header}\r\n      isOpen={isOpen}\r\n      onClose={handleClose}\r\n      safeAreaInsets={safeAreaInsets}\r\n      showOverlay={props.showOverlay}\r\n      style={props.style}\r\n    >\r\n      {groups.map((group, groupIndex) => (\r\n        group.map((item, itemIndex) => {\r\n          const composerItem = (\r\n            <BackstageComposerItem\r\n              item={item}\r\n              key={item.id}\r\n            />\r\n          );\r\n          return itemIndex === 0 && groupIndex > 0 ? (\r\n            <React.Fragment key={groupIndex}>\r\n              <BackstageSeparator />\r\n              {composerItem}\r\n            </React.Fragment>\r\n          ) : composerItem;\r\n        })\r\n      ))}\r\n    </NZ_Backstage>\r\n  );\r\n}\r\n"]}

package/lib/esm/appui-react/backstage/BackstageComposerItem.d.ts

@@ -1,30 +1,30 @@
-/** @packageDocumentation
- * @module Backstage
- */
-/// <reference types="react" />
-import { BackstageActionItem, BackstageItem, BackstageStageLauncher } from "@itwin/appui-abstract";
-/** @internal */
-export interface BackstageComposerActionItemProps {
-    readonly item: BackstageActionItem;
-}
-/** @internal */
-export declare function BackstageComposerActionItem({ item }: BackstageComposerActionItemProps): JSX.Element;
-/** @internal */
-export interface BackstageComposerStageLauncherProps {
-    readonly item: BackstageStageLauncher;
-}
-/** @internal */
-export declare function BackstageComposerStageLauncher({ item }: BackstageComposerStageLauncherProps): JSX.Element;
-/** Props of [[BackstageComposerItem]] component.
- * @internal
- */
-export interface BackstageComposerItemProps {
-    /** Backstage item to render */
-    readonly item: BackstageItem;
-    readonly providerId?: string;
-}
-/** Item of [[BackstageComposer]].
- * @internal
- */
-export declare function BackstageComposerItem({ item }: BackstageComposerItemProps): JSX.Element;
+/** @packageDocumentation
+ * @module Backstage
+ */
+/// <reference types="react" />
+import { BackstageActionItem, BackstageItem, BackstageStageLauncher } from "@itwin/appui-abstract";
+/** @internal */
+export interface BackstageComposerActionItemProps {
+    readonly item: BackstageActionItem;
+}
+/** @internal */
+export declare function BackstageComposerActionItem({ item }: BackstageComposerActionItemProps): JSX.Element;
+/** @internal */
+export interface BackstageComposerStageLauncherProps {
+    readonly item: BackstageStageLauncher;
+}
+/** @internal */
+export declare function BackstageComposerStageLauncher({ item }: BackstageComposerStageLauncherProps): JSX.Element;
+/** Props of [[BackstageComposerItem]] component.
+ * @internal
+ */
+export interface BackstageComposerItemProps {
+    /** Backstage item to render */
+    readonly item: BackstageItem;
+    readonly providerId?: string;
+}
+/** Item of [[BackstageComposer]].
+ * @internal
+ */
+export declare function BackstageComposerItem({ item }: BackstageComposerItemProps): JSX.Element;
 //# sourceMappingURL=BackstageComposerItem.d.ts.map