@itwin/appui-react 5.31.0 → 5.32.1

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

@@ -0,0 +1,88 @@
+/*---------------------------------------------------------------------------------------------
+ * 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 "./Backstage.scss";
+import * as React from "react";
+import classnames from "classnames";
+import { ConditionalBooleanValue, ConditionalStringValue, } from "@itwin/appui-abstract";
+import { Logger } from "@itwin/core-bentley";
+import { Icon as CoreIcon } from "@itwin/core-react";
+import { Badge } from "@itwin/core-react/internal";
+import { Dialog, Divider, Icon, List, ListItem } from "@itwin/itwinui-react";
+import { UiFramework } from "../UiFramework.js";
+import { useActiveFrontstageId } from "../frontstage/FrontstageDef.js";
+import { isProviderItem } from "../ui-items-provider/isProviderItem.js";
+import { useBackstageManager } from "./BackstageManager.js";
+import { useTranslation } from "../hooks/useTranslation.js";
+/** @internal */
+export function Backstage(props) {
+    const { isOpen, onClose, showOverlay, ...rest } = props;
+    const { translate } = useTranslation();
+    return (React.createElement(Dialog, { className: "uifw-backstage-backstage_wrapper", placement: "top-left", isOpen: isOpen, onClose: onClose, closeOnExternalClick: true, preventDocumentScroll: true, trapFocus: true, setFocus: false },
+        React.createElement(Dialog.Backdrop, { className: classnames("uifw-backstage-backstage_backdrop", !showOverlay && "uifw-transparent") }),
+        React.createElement(Dialog.Main, { "aria-label": translate("backstage.label"), ...rest, className: classnames("uifw-backstage-backstage", props.className) },
+            React.createElement(Dialog.Content, { className: "uifw-backstage-backstage_content" }, props.children))));
+}
+function BackstageDivider() {
+    return React.createElement(Divider, { className: "uifw-backstage-backstage_divider" });
+}
+/** @internal */
+export function BackstageGroup(props) {
+    const { index, ...rest } = props;
+    return (React.createElement(React.Fragment, null,
+        index > 0 ? React.createElement(BackstageDivider, null) : null,
+        React.createElement(List, { ...rest }, props.children)));
+}
+function ItemIcon({ icon, iconNode, }) {
+    if (iconNode) {
+        return React.createElement(Icon, { "aria-hidden": "true" }, iconNode);
+    }
+    // eslint-disable-next-line @typescript-eslint/no-deprecated
+    return React.createElement(CoreIcon, { iconSpec: icon });
+}
+function BackstageItem(props) {
+    const { item, active, onClick, autoFocus, ...rest } = props;
+    const descriptionId = React.useId();
+    const description = ConditionalStringValue.getValue(item.subtitle);
+    const label = ConditionalStringValue.getValue(item.label);
+    const disabled = ConditionalBooleanValue.getValue(item.isDisabled);
+    return (React.createElement(ListItem, { "data-item-id": item.id, "data-item-type": "backstage-item", "data-item-group-priority": item.groupPriority, "data-item-priority": item.itemPriority, "data-item-provider-id": isProviderItem(item) ? item.providerId : undefined, disabled: disabled, size: "large", active: active, actionable: true, ...rest },
+        React.createElement("div", { className: "uifw-backstage-backstage_badge" },
+            React.createElement(Badge, { type: item.badgeKind || item.badge })),
+        React.createElement(ListItem.Icon, null,
+            React.createElement(ItemIcon, { iconNode: item.iconNode, icon: item.icon })),
+        React.createElement(ListItem.Content, null,
+            React.createElement(ListItem.Action, { onClick: onClick, "aria-describedby": descriptionId, 
+                // eslint-disable-next-line jsx-a11y/no-autofocus
+                autoFocus: autoFocus, "aria-current": active ? "true" : undefined }, label),
+            React.createElement(ListItem.Description, { id: descriptionId }, description))));
+}
+/** @internal */
+export function BackstageActionItem(props) {
+    const { item, ...rest } = props;
+    const manager = useBackstageManager();
+    const handleClick = React.useCallback(() => {
+        manager.close();
+        item.execute();
+    }, [manager, item]);
+    return React.createElement(BackstageItem, { item: item, onClick: handleClick, ...rest });
+}
+/** @internal */
+export function BackstageStageLauncher(props) {
+    const { item, ...rest } = props;
+    const manager = useBackstageManager();
+    const handleClick = React.useCallback(() => {
+        manager.close();
+        if (!UiFramework.frontstages.hasFrontstage(item.stageId))
+            return Logger.logError("BackstageStageLauncher", `Frontstage with id '${item.stageId}' not found`);
+        void UiFramework.frontstages.setActiveFrontstage(item.stageId);
+    }, [manager, item.stageId]);
+    const activeFrontstageId = useActiveFrontstageId();
+    const isActive = ConditionalBooleanValue.getValue(item.isActive ?? item.stageId === activeFrontstageId);
+    return (React.createElement(BackstageItem, { item: item, active: isActive, onClick: handleClick, ...rest }));
+}
+//# sourceMappingURL=Backstage.js.map

package/lib/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":["/*---------------------------------------------------------------------------------------------\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 \"./Backstage.scss\";\nimport * as React from \"react\";\nimport classnames from \"classnames\";\nimport {\n  ConditionalBooleanValue,\n  ConditionalStringValue,\n} from \"@itwin/appui-abstract\";\nimport { Logger } from \"@itwin/core-bentley\";\nimport { Icon as CoreIcon } from \"@itwin/core-react\";\nimport { Badge } from \"@itwin/core-react/internal\";\nimport { Dialog, Divider, Icon, List, ListItem } from \"@itwin/itwinui-react\";\nimport { UiFramework } from \"../UiFramework.js\";\nimport { useActiveFrontstageId } from \"../frontstage/FrontstageDef.js\";\nimport { isProviderItem } from \"../ui-items-provider/isProviderItem.js\";\nimport { useBackstageManager } from \"./BackstageManager.js\";\nimport { useTranslation } from \"../hooks/useTranslation.js\";\n\nimport type {\n  BackstageActionItem as BackstageActionItemDef,\n  BackstageItem as BackstageItemDef,\n  BackstageStageLauncher as BackstageStageLauncherDef,\n  CommonBackstageItem,\n} from \"./BackstageItem.js\";\n\ninterface BackstageProps extends React.ComponentProps<\"div\"> {\n  isOpen: boolean;\n  onClose: () => void;\n  showOverlay: boolean;\n}\n\n/** @internal */\nexport function Backstage(props: BackstageProps) {\n  const { isOpen, onClose, showOverlay, ...rest } = props;\n\n  const { translate } = useTranslation();\n\n  return (\n    <Dialog\n      className=\"uifw-backstage-backstage_wrapper\"\n      placement=\"top-left\"\n      isOpen={isOpen}\n      onClose={onClose}\n      closeOnExternalClick\n      preventDocumentScroll\n      trapFocus\n      setFocus={false}\n    >\n      <Dialog.Backdrop\n        className={classnames(\n          \"uifw-backstage-backstage_backdrop\",\n          !showOverlay && \"uifw-transparent\"\n        )}\n      />\n      <Dialog.Main\n        aria-label={translate(\"backstage.label\")}\n        {...rest}\n        className={classnames(\"uifw-backstage-backstage\", props.className)}\n      >\n        <Dialog.Content className=\"uifw-backstage-backstage_content\">\n          {props.children}\n        </Dialog.Content>\n      </Dialog.Main>\n    </Dialog>\n  );\n}\n\nfunction BackstageDivider() {\n  return <Divider className=\"uifw-backstage-backstage_divider\" />;\n}\n\ninterface BackstageGroupProps {\n  children?: React.ReactNode;\n  index: number;\n}\n\n/** @internal */\nexport function BackstageGroup(props: BackstageGroupProps) {\n  const { index, ...rest } = props;\n  return (\n    <>\n      {index > 0 ? <BackstageDivider /> : null}\n      <List {...rest}>{props.children}</List>\n    </>\n  );\n}\n\nfunction ItemIcon({\n  icon,\n  iconNode,\n}: {\n  icon: CommonBackstageItem[\"icon\"];\n  iconNode: CommonBackstageItem[\"iconNode\"];\n}) {\n  if (iconNode) {\n    return <Icon aria-hidden=\"true\">{iconNode}</Icon>;\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-deprecated\n  return <CoreIcon iconSpec={icon} />;\n}\n\ntype ListItemProps = React.ComponentProps<typeof ListItem>;\n\ninterface BackstageItemProps\n  extends Pick<ListItemProps, \"active\" | \"onClick\" | \"autoFocus\"> {\n  item: BackstageItemDef;\n  onClick?: () => void;\n}\n\nfunction BackstageItem(props: BackstageItemProps) {\n  const { item, active, onClick, autoFocus, ...rest } = props;\n\n  const descriptionId = React.useId();\n\n  const description = ConditionalStringValue.getValue(item.subtitle);\n  const label = ConditionalStringValue.getValue(item.label);\n  const disabled = ConditionalBooleanValue.getValue(item.isDisabled);\n  return (\n    <ListItem\n      data-item-id={item.id}\n      data-item-type=\"backstage-item\"\n      data-item-group-priority={item.groupPriority}\n      data-item-priority={item.itemPriority}\n      data-item-provider-id={isProviderItem(item) ? item.providerId : undefined}\n      disabled={disabled}\n      size=\"large\"\n      active={active}\n      actionable\n      {...rest}\n    >\n      <div className=\"uifw-backstage-backstage_badge\">\n        {/* eslint-disable-next-line @typescript-eslint/no-deprecated */}\n        <Badge type={item.badgeKind || item.badge} />\n      </div>\n      <ListItem.Icon>\n        {/* eslint-disable-next-line @typescript-eslint/no-deprecated */}\n        <ItemIcon iconNode={item.iconNode} icon={item.icon} />\n      </ListItem.Icon>\n      <ListItem.Content>\n        <ListItem.Action\n          onClick={onClick}\n          aria-describedby={descriptionId}\n          // eslint-disable-next-line jsx-a11y/no-autofocus\n          autoFocus={autoFocus}\n          aria-current={active ? \"true\" : undefined}\n        >\n          {label}\n        </ListItem.Action>\n        <ListItem.Description id={descriptionId}>\n          {description}\n        </ListItem.Description>\n      </ListItem.Content>\n    </ListItem>\n  );\n}\n\ninterface BackstageActionItemProps extends Pick<ListItemProps, \"autoFocus\"> {\n  readonly item: BackstageActionItemDef;\n}\n\n/** @internal */\nexport function BackstageActionItem(props: BackstageActionItemProps) {\n  const { item, ...rest } = props;\n\n  const manager = useBackstageManager();\n  const handleClick = React.useCallback(() => {\n    manager.close();\n    item.execute();\n  }, [manager, item]);\n  return <BackstageItem item={item} onClick={handleClick} {...rest} />;\n}\n\ninterface BackstageStageLauncherProps extends Pick<ListItemProps, \"autoFocus\"> {\n  readonly item: BackstageStageLauncherDef;\n}\n\n/** @internal */\nexport function BackstageStageLauncher(props: BackstageStageLauncherProps) {\n  const { item, ...rest } = props;\n\n  const manager = useBackstageManager();\n  const handleClick = React.useCallback(() => {\n    manager.close();\n    if (!UiFramework.frontstages.hasFrontstage(item.stageId))\n      return Logger.logError(\n        \"BackstageStageLauncher\",\n        `Frontstage with id '${item.stageId}' not found`\n      );\n    void UiFramework.frontstages.setActiveFrontstage(item.stageId);\n  }, [manager, item.stageId]);\n  const activeFrontstageId = useActiveFrontstageId();\n  const isActive = ConditionalBooleanValue.getValue(\n    item.isActive ?? item.stageId === activeFrontstageId\n  );\n  return (\n    <BackstageItem\n      item={item}\n      active={isActive}\n      onClick={handleClick}\n      {...rest}\n    />\n  );\n}\n"]}

package/lib/appui-react/backstage/Backstage.scss

@@ -0,0 +1,42 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+@use "~@itwin/core-react/lib/core-react/z-index" as zIndex;
+
+.uifw-backstage-backstage_wrapper {
+  @include zIndex.uicore-z-index(backstage);
+}
+
+.uifw-backstage-backstage {
+  inset-block-end: 0;
+  border-radius: 0;
+  margin-block-start: 0;
+  margin-inline-start: 0;
+}
+
+.uifw-backstage-backstage_backdrop {
+  &:where(.uifw-transparent) {
+    background-color: transparent;
+  }
+}
+
+.uifw-backstage-backstage_content {
+  padding-inline: var(--iui-size-xs);
+}
+
+.uifw-backstage-backstage_divider {
+  $margin-block: var(--iui-size-2xs);
+  $margin-inline: calc(-1 * var(--iui-size-xs));
+
+  margin-block-start: $margin-block;
+  margin-block-end: $margin-block;
+  margin-inline-start: $margin-inline;
+  margin-inline-end: $margin-inline;
+}
+
+.uifw-backstage-backstage_badge {
+  position: absolute;
+  inset-block-start: 0;
+  inset-inline-start: 0;
+}

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

@@ -4,8 +4,7 @@
 import * as React from "react";
 import type { CommonProps } from "@itwin/core-react";
 import type { BackstageItem } from "./BackstageItem.js";
-/** @internal */
-export type GroupedItems = ReadonlyArray<ReadonlyArray<BackstageItem>>;
+type GroupedItems = ReadonlyArray<ReadonlyArray<BackstageItem>>;
 /** @internal */
 export declare const useGroupedItems: (items: ReadonlyArray<BackstageItem>) => GroupedItems;
 /** Props of [[BackstageComposer]] component.
@@ -26,4 +25,5 @@ export interface BackstageComposerProps extends CommonProps {
  * @public
  */
 export declare function BackstageComposer(props: BackstageComposerProps): React.JSX.Element;
+export {};
 //# sourceMappingURL=BackstageComposer.d.ts.map

package/lib/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;AAGH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAY/B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAqExD,gBAAgB;AAChB,MAAM,MAAM,YAAY,GAAG,aAAa,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,CAAC;AAEvE,gBAAgB;AAChB,eAAO,MAAM,eAAe,UACnB,aAAa,CAAC,aAAa,CAAC,KAClC,YAyBF,CAAC;AAEF;;;GAGG;AAEH,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;AAEH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,qBAoE9D"}
+{"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;AAe/B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAqExD,KAAK,YAAY,GAAG,aAAa,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,CAAC;AAEhE,gBAAgB;AAChB,eAAO,MAAM,eAAe,UACnB,aAAa,CAAC,aAAa,CAAC,KAClC,YAyBF,CAAC;AAEF;;;GAGG;AAEH,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;AAEH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,qBAsF9D"}

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

@@ -5,13 +5,10 @@
 /** @packageDocumentation
  * @module Backstage
  */
-import { ConditionalBooleanValue } from "@itwin/appui-abstract";
 import * as React from "react";
-import { Backstage as NZ_Backstage } from "../layout/backstage/Backstage.js";
-import { BackstageSeparator } from "../layout/backstage/Separator.js";
-import { SafeAreaContext } from "../safearea/SafeAreaContext.js";
+import { ConditionalBooleanValue } from "@itwin/appui-abstract";
 import { SyncUiEventDispatcher } from "../syncui/SyncUiEventDispatcher.js";
-import { BackstageComposerItem } from "./BackstageComposerItem.js";
+import { Backstage, BackstageActionItem, BackstageGroup, BackstageStageLauncher, } from "./Backstage.js";
 import { isBackstageStageLauncher } from "./BackstageItem.js";
 import { BackstageItemsManager } from "./BackstageItemsManager.js";
 import { useBackstageManager, useIsBackstageOpen } from "./BackstageManager.js";
@@ -90,17 +87,17 @@ export const useGroupedItems = (items) => {
  */
 // eslint-disable-next-line @typescript-eslint/no-deprecated
 export function BackstageComposer(props) {
-    const [defaultItemsManager, setDefaultItemsManager] = React.useState(new BackstageItemsManager(props.items));
-    const initialItems = React.useRef(props.items);
+    const { header, showOverlay = true, items, hideSoloStageEntry, itemId, ...rest } = props;
+    const [defaultItemsManager, setDefaultItemsManager] = React.useState(new BackstageItemsManager(items));
+    const initialItems = React.useRef(items);
     React.useEffect(() => {
-        if (initialItems.current !== props.items) {
-            initialItems.current = props.items;
-            setDefaultItemsManager(new BackstageItemsManager(props.items));
+        if (initialItems.current !== items) {
+            initialItems.current = items;
+            setDefaultItemsManager(new BackstageItemsManager(items));
         }
-    }, [props.items]);
+    }, [items]);
     const manager = useBackstageManager();
     const isOpen = useIsBackstageOpen(manager);
-    const safeAreaInsets = React.useContext(SafeAreaContext);
     const handleClose = React.useCallback(() => {
         manager.close();
     }, [manager]);
@@ -112,13 +109,22 @@ export function BackstageComposer(props) {
     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 combinedBackstageItems = React.useMemo(() => combineItems(defaultItems, addonItems, !!hideSoloStageEntry), [defaultItems, addonItems, 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);
-    }))));
+    return (React.createElement(Backstage, { isOpen: isOpen, onClose: handleClose, showOverlay: showOverlay, ...rest },
+        header,
+        groups.map((groupItems, groupIndex) => {
+            return (React.createElement(BackstageGroup, { key: groupIndex, index: groupIndex }, groupItems.map((item, itemIndex) => {
+                const autoFocus = groupIndex === 0 && itemIndex === 0;
+                if (isBackstageStageLauncher(item)) {
+                    return (React.createElement(BackstageStageLauncher, { key: item.id, item: item, 
+                        // eslint-disable-next-line jsx-a11y/no-autofocus -- autoFocus first item in the dialog
+                        autoFocus: autoFocus }));
+                }
+                return (React.createElement(BackstageActionItem, { key: item.id, item: item, 
+                    // eslint-disable-next-line jsx-a11y/no-autofocus -- autoFocus first item in the dialog
+                    autoFocus: autoFocus }));
+            })));
+        })));
 }
 //# sourceMappingURL=BackstageComposer.js.map

package/lib/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 { ConditionalBooleanValue } from \"@itwin/appui-abstract\";\nimport * as React from \"react\";\nimport { Backstage as NZ_Backstage } from \"../layout/backstage/Backstage.js\";\nimport { BackstageSeparator } from \"../layout/backstage/Separator.js\";\nimport { SafeAreaContext } from \"../safearea/SafeAreaContext.js\";\nimport { SyncUiEventDispatcher } from \"../syncui/SyncUiEventDispatcher.js\";\nimport { BackstageComposerItem } from \"./BackstageComposerItem.js\";\nimport { isBackstageStageLauncher } from \"./BackstageItem.js\";\nimport { BackstageItemsManager } from \"./BackstageItemsManager.js\";\nimport { useBackstageManager, useIsBackstageOpen } from \"./BackstageManager.js\";\nimport { useDefaultBackstageItems } from \"./useDefaultBackstageItems.js\";\nimport { useUiItemsProviderBackstageItems } from \"./useUiItemsProviderBackstageItems.js\";\n\nimport type { CommonProps } from \"@itwin/core-react\";\nimport type { BackstageItem } from \"./BackstageItem.js\";\n\n/** Private function to set up sync event monitoring of backstage items */\nfunction useBackstageItemSyncEffect(\n  itemsManager: BackstageItemsManager,\n  syncIdsOfInterest: string[]\n) {\n  const isInitialMount = React.useRef(true);\n\n  React.useEffect(() => {\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    return SyncUiEventDispatcher.onSyncUiEvent.addListener((args) => {\n      if (0 === syncIdsOfInterest.length) return;\n\n      if (\n        syncIdsOfInterest.some((value: string): boolean =>\n          args.eventIds.has(value.toLowerCase())\n        )\n      ) {\n        // process each item that has interest\n        itemsManager.refreshAffectedItems(args.eventIds);\n      }\n    });\n  }, [itemsManager, itemsManager.items, syncIdsOfInterest]);\n}\n\n/** local function to combine items from Stage and from Extensions */\nfunction combineItems(\n  stageItems: ReadonlyArray<BackstageItem>,\n  addonItems: ReadonlyArray<BackstageItem>,\n  hideSoloStageEntry: boolean\n): ReadonlyArray<BackstageItem> {\n  let items: Array<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(\n      (accumulator, item) =>\n        accumulator + (isBackstageStageLauncher(item) ? 1 : 0),\n      0\n    );\n    if (1 === numberOfFrontstageItems)\n      items = items.filter((item) => !isBackstageStageLauncher(item));\n  }\n\n  return items;\n}\n\n/** @internal */\nexport type GroupedItems = ReadonlyArray<ReadonlyArray<BackstageItem>>;\n\n/** @internal */\nexport const useGroupedItems = (\n  items: ReadonlyArray<BackstageItem>\n): GroupedItems => {\n  return React.useMemo(() => {\n    const grouped = items.reduce<GroupedItems>((acc, item) => {\n      if (ConditionalBooleanValue.getValue(item.isHidden)) return acc;\n      const groupIndex = acc.findIndex(\n        (group) => group[0].groupPriority === item.groupPriority\n      );\n      if (groupIndex >= 0)\n        return [\n          ...acc.slice(0, groupIndex),\n          [...acc[groupIndex], item],\n          ...acc.slice(groupIndex + 1),\n        ];\n      return [...acc, [item]];\n    }, []);\n    const sortedGroups = grouped.reduce<GroupedItems>((acc, group) => {\n      const sortedGroup = [...group].sort(\n        (a, b) => a.itemPriority - b.itemPriority\n      );\n      return [...acc, sortedGroup];\n    }, []);\n    return [...sortedGroups].sort(\n      (a, b) => a[0].groupPriority - b[0].groupPriority\n    );\n  }, [items]);\n};\n\n/** Props of [[BackstageComposer]] component.\n * @public\n * @deprecated in 4.17.0. Use `React.ComponentProps<typeof BackstageComposer>`\n */\n// eslint-disable-next-line @typescript-eslint/no-deprecated\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 [[UiFramework.backstage]] items.\n * @public\n */\n// eslint-disable-next-line @typescript-eslint/no-deprecated\nexport function BackstageComposer(props: BackstageComposerProps) {\n  const [defaultItemsManager, setDefaultItemsManager] = React.useState(\n    new BackstageItemsManager(props.items)\n  );\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(\n    () => BackstageItemsManager.getSyncIdsOfInterest(defaultItems),\n    [defaultItems]\n  );\n  useBackstageItemSyncEffect(defaultItemsManager, syncIdsOfInterest);\n\n  const [addonItemsManager] = React.useState(new BackstageItemsManager());\n  // eslint-disable-next-line @typescript-eslint/no-deprecated\n  const addonItems = useUiItemsProviderBackstageItems(addonItemsManager);\n  const addonSyncIdsOfInterest = React.useMemo(\n    () => BackstageItemsManager.getSyncIdsOfInterest(addonItems),\n    [addonItems]\n  );\n  useBackstageItemSyncEffect(addonItemsManager, addonSyncIdsOfInterest);\n\n  const combinedBackstageItems = React.useMemo(\n    () => combineItems(defaultItems, addonItems, !!props.hideSoloStageEntry),\n    [defaultItems, addonItems, props.hideSoloStageEntry]\n  );\n  const groups = useGroupedItems(combinedBackstageItems);\n  return (\n    <NZ_Backstage\n      className={props.className}\n      header={props.header}\n      isOpen={isOpen}\n      onClose={handleClose}\n      safeAreaInsets={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 item={item} key={item.id} />\n          );\n          return itemIndex === 0 && groupIndex > 0 ? (\n            <React.Fragment key={groupIndex}>\n              <BackstageSeparator />\n              {composerItem}\n            </React.Fragment>\n          ) : (\n            composerItem\n          );\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":["/*---------------------------------------------------------------------------------------------\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 { ConditionalBooleanValue } from \"@itwin/appui-abstract\";\nimport { SyncUiEventDispatcher } from \"../syncui/SyncUiEventDispatcher.js\";\nimport {\n  Backstage,\n  BackstageActionItem,\n  BackstageGroup,\n  BackstageStageLauncher,\n} from \"./Backstage.js\";\nimport { isBackstageStageLauncher } from \"./BackstageItem.js\";\nimport { BackstageItemsManager } from \"./BackstageItemsManager.js\";\nimport { useBackstageManager, useIsBackstageOpen } from \"./BackstageManager.js\";\nimport { useDefaultBackstageItems } from \"./useDefaultBackstageItems.js\";\nimport { useUiItemsProviderBackstageItems } from \"./useUiItemsProviderBackstageItems.js\";\n\nimport type { CommonProps } from \"@itwin/core-react\";\nimport type { BackstageItem } from \"./BackstageItem.js\";\n\n/** Private function to set up sync event monitoring of backstage items */\nfunction useBackstageItemSyncEffect(\n  itemsManager: BackstageItemsManager,\n  syncIdsOfInterest: string[]\n) {\n  const isInitialMount = React.useRef(true);\n\n  React.useEffect(() => {\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    return SyncUiEventDispatcher.onSyncUiEvent.addListener((args) => {\n      if (0 === syncIdsOfInterest.length) return;\n\n      if (\n        syncIdsOfInterest.some((value: string): boolean =>\n          args.eventIds.has(value.toLowerCase())\n        )\n      ) {\n        // process each item that has interest\n        itemsManager.refreshAffectedItems(args.eventIds);\n      }\n    });\n  }, [itemsManager, itemsManager.items, syncIdsOfInterest]);\n}\n\n/** local function to combine items from Stage and from Extensions */\nfunction combineItems(\n  stageItems: ReadonlyArray<BackstageItem>,\n  addonItems: ReadonlyArray<BackstageItem>,\n  hideSoloStageEntry: boolean\n): ReadonlyArray<BackstageItem> {\n  let items: Array<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(\n      (accumulator, item) =>\n        accumulator + (isBackstageStageLauncher(item) ? 1 : 0),\n      0\n    );\n    if (1 === numberOfFrontstageItems)\n      items = items.filter((item) => !isBackstageStageLauncher(item));\n  }\n\n  return items;\n}\n\ntype GroupedItems = ReadonlyArray<ReadonlyArray<BackstageItem>>;\n\n/** @internal */\nexport const useGroupedItems = (\n  items: ReadonlyArray<BackstageItem>\n): GroupedItems => {\n  return React.useMemo(() => {\n    const grouped = items.reduce<GroupedItems>((acc, item) => {\n      if (ConditionalBooleanValue.getValue(item.isHidden)) return acc;\n      const groupIndex = acc.findIndex(\n        (group) => group[0].groupPriority === item.groupPriority\n      );\n      if (groupIndex >= 0)\n        return [\n          ...acc.slice(0, groupIndex),\n          [...acc[groupIndex], item],\n          ...acc.slice(groupIndex + 1),\n        ];\n      return [...acc, [item]];\n    }, []);\n    const sortedGroups = grouped.reduce<GroupedItems>((acc, group) => {\n      const sortedGroup = [...group].sort(\n        (a, b) => a.itemPriority - b.itemPriority\n      );\n      return [...acc, sortedGroup];\n    }, []);\n    return [...sortedGroups].sort(\n      (a, b) => a[0].groupPriority - b[0].groupPriority\n    );\n  }, [items]);\n};\n\n/** Props of [[BackstageComposer]] component.\n * @public\n * @deprecated in 4.17.0. Use `React.ComponentProps<typeof BackstageComposer>`\n */\n// eslint-disable-next-line @typescript-eslint/no-deprecated\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 [[UiFramework.backstage]] items.\n * @public\n */\n// eslint-disable-next-line @typescript-eslint/no-deprecated\nexport function BackstageComposer(props: BackstageComposerProps) {\n  const {\n    header,\n    showOverlay = true,\n    items,\n    hideSoloStageEntry,\n    itemId,\n    ...rest\n  } = props;\n\n  const [defaultItemsManager, setDefaultItemsManager] = React.useState(\n    new BackstageItemsManager(items)\n  );\n  const initialItems = React.useRef(items);\n\n  React.useEffect(() => {\n    if (initialItems.current !== items) {\n      initialItems.current = items;\n      setDefaultItemsManager(new BackstageItemsManager(items));\n    }\n  }, [items]);\n\n  const manager = useBackstageManager();\n  const isOpen = useIsBackstageOpen(manager);\n  const handleClose = React.useCallback(() => {\n    manager.close();\n  }, [manager]);\n\n  const defaultItems = useDefaultBackstageItems(defaultItemsManager);\n  const syncIdsOfInterest = React.useMemo(\n    () => BackstageItemsManager.getSyncIdsOfInterest(defaultItems),\n    [defaultItems]\n  );\n  useBackstageItemSyncEffect(defaultItemsManager, syncIdsOfInterest);\n\n  const [addonItemsManager] = React.useState(new BackstageItemsManager());\n  // eslint-disable-next-line @typescript-eslint/no-deprecated\n  const addonItems = useUiItemsProviderBackstageItems(addonItemsManager);\n  const addonSyncIdsOfInterest = React.useMemo(\n    () => BackstageItemsManager.getSyncIdsOfInterest(addonItems),\n    [addonItems]\n  );\n  useBackstageItemSyncEffect(addonItemsManager, addonSyncIdsOfInterest);\n\n  const combinedBackstageItems = React.useMemo(\n    () => combineItems(defaultItems, addonItems, !!hideSoloStageEntry),\n    [defaultItems, addonItems, hideSoloStageEntry]\n  );\n  const groups = useGroupedItems(combinedBackstageItems);\n  return (\n    <Backstage\n      isOpen={isOpen}\n      onClose={handleClose}\n      showOverlay={showOverlay}\n      {...rest}\n    >\n      {header}\n      {groups.map((groupItems, groupIndex) => {\n        return (\n          <BackstageGroup key={groupIndex} index={groupIndex}>\n            {groupItems.map((item, itemIndex) => {\n              const autoFocus = groupIndex === 0 && itemIndex === 0;\n              if (isBackstageStageLauncher(item)) {\n                return (\n                  <BackstageStageLauncher\n                    key={item.id}\n                    item={item}\n                    // eslint-disable-next-line jsx-a11y/no-autofocus -- autoFocus first item in the dialog\n                    autoFocus={autoFocus}\n                  />\n                );\n              }\n              return (\n                <BackstageActionItem\n                  key={item.id}\n                  item={item}\n                  // eslint-disable-next-line jsx-a11y/no-autofocus -- autoFocus first item in the dialog\n                  autoFocus={autoFocus}\n                />\n              );\n            })}\n          </BackstageGroup>\n        );\n      })}\n    </Backstage>\n  );\n}\n"]}

package/lib/appui-react/frontstage/ModalFrontstage.d.ts

@@ -32,7 +32,7 @@ export interface ModalFrontstageProps extends CommonProps {
 interface Props extends Omit<ModalFrontstageProps, "closeModal"> {
     /**
      * Callback for closing the modal Frontstage.
-     * @deprecated in 5.31.0. Use {@link navigateBack} instead.
+     * @deprecated in 5.31.0. Use `navigateBack` prop instead.
      */
     closeModal?: () => void;
 }

package/lib/appui-react/frontstage/ModalFrontstage.js.map

@@ -1 +1 @@
-{"version":3,"file":"ModalFrontstage.js","sourceRoot":"","sources":["../../../src/appui-react/frontstage/ModalFrontstage.tsx"],"names":[],"mappings":"AAAA;;;gGAGgG;AAChG;;GAEG;AAEH,OAAO,wBAAwB,CAAC;AAChC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,UAAU,MAAM,YAAY,CAAC;AAEpC,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAC5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAuCnE;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,KAAY;IAC1C,MAAM,EACJ,MAAM,EACN,YAAY;IACZ,4DAA4D;IAC5D,UAAU,EACV,UAAU,EACV,KAAK,EACL,WAAW,EACX,UAAU,EACV,GAAG,IAAI,EACR,GAAG,KAAK,CAAC;IAEV,MAAM,UAAU,GAAG,GAAG,EAAE;QACtB,YAAY,EAAE,EAAE,CAAC;QACjB,UAAU,EAAE,EAAE,CAAC;IACjB,CAAC,CAAC;IAEF,OAAO,CACL,gCACM,IAAI,EACR,SAAS,EAAE,UAAU,CACnB,uBAAuB,EACvB,MAAM,IAAI,iBAAiB,EAC3B,UAAU,IAAI,gBAAgB,EAC9B,KAAK,CAAC,SAAS,CAChB,IAEA,UAAU,CAAC,CAAC,CAAC,CACZ,KAAK,CAAC,QAAQ,CACf,CAAC,CAAC,CAAC,CACF;QACE,6BAAK,SAAS,EAAC,oBAAoB;YAChC,UAAU,CAAC,CAAC,CAAC,CACZ,UAAU,CACX,CAAC,CAAC,CAAC,CACF,oBAAC,qBAAqB,IAAC,OAAO,EAAE,UAAU,GAAI,CAC/C;YACD,oBAAC,IAAI,IAAC,OAAO,EAAC,UAAU,EAAC,SAAS,EAAC,eAAe,IAC/C,KAAK,CACD;YACN,WAAW,IAAI,CACd,8BAAM,SAAS,EAAC,0BAA0B,IAAE,WAAW,CAAQ,CAChE,CACG;QACN,6BAAK,SAAS,EAAC,0BAA0B,IAAE,KAAK,CAAC,QAAQ,CAAO,CAC/D,CACJ,CACG,CACP,CAAC;AACJ,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 Frontstage\n */\n\nimport \"./ModalFrontstage.scss\";\nimport * as React from \"react\";\nimport classnames from \"classnames\";\nimport type { CommonProps } from \"@itwin/core-react\";\nimport { Text } from \"@itwin/itwinui-react\";\nimport { ModalFrontstageButton } from \"./ModalFrontstageButton.js\";\nimport type { ConfigurableUiContent } from \"../configurableui/ConfigurableUiContent.js\";\n\n/** Properties for the [[ModalFrontstage]] React component\n * @public\n * @deprecated in 5.31.0. Use `React.ComponentProps<typeof ModalFrontstage>` instead.\n */\n// eslint-disable-next-line @typescript-eslint/no-deprecated\nexport interface ModalFrontstageProps extends CommonProps {\n  /** Title displayed at the top of the modal frontstage. */\n  title: string;\n  /** Indicates whether the modal frontstage is open. */\n  isOpen?: boolean;\n  /** Callback for navigating back from the modal frontstage. */\n  navigateBack?: () => void;\n  /** Callback for closing the modal frontstage. */\n  closeModal: () => void;\n  /** Optional content displayed in the upper right of the modal frontstage. */\n  appBarRight?: React.ReactNode;\n  /** If specified overrides the default {@link ModalFrontstageButton}. */\n  backButton?: React.ReactNode;\n  /** Content of the modal frontstage. */\n  children?: React.ReactNode;\n  /**\n   * If `true`, hides the header of the modal frontstage and renders the `children` prop in the root element.\n   * @note When set to `true`, the `title`, `navigateBack`, `closeModal`, `appBarRight`, and `backButton` props are ignored.\n   */\n  hideHeader?: boolean;\n}\n\n// eslint-disable-next-line @typescript-eslint/no-deprecated\ninterface Props extends Omit<ModalFrontstageProps, \"closeModal\"> {\n  /**\n   * Callback for closing the modal Frontstage.\n   * @deprecated in 5.31.0. Use {@link navigateBack} instead.\n   */\n  closeModal?: () => void;\n}\n\n/**\n * The default layout used for modal frontstages.\n * Use `renderModalFrontstage` prop of {@link ConfigurableUiContent} to override the modal frontstage layout.\n * @public\n */\nexport function ModalFrontstage(props: Props) {\n  const {\n    isOpen,\n    navigateBack,\n    // eslint-disable-next-line @typescript-eslint/no-deprecated\n    closeModal,\n    backButton,\n    title,\n    appBarRight,\n    hideHeader,\n    ...rest\n  } = props;\n\n  const handleBack = () => {\n    navigateBack?.();\n    closeModal?.();\n  };\n\n  return (\n    <div\n      {...rest}\n      className={classnames(\n        \"uifw-modal-frontstage\",\n        isOpen && \"uifw-modal-open\",\n        hideHeader && \"uifw-no-header\",\n        props.className\n      )}\n    >\n      {hideHeader ? (\n        props.children\n      ) : (\n        <>\n          <div className=\"uifw-modal-app-bar\">\n            {backButton ? (\n              backButton\n            ) : (\n              <ModalFrontstageButton onClick={handleBack} />\n            )}\n            <Text variant=\"headline\" className=\"uifw-headline\">\n              {title}\n            </Text>\n            {appBarRight && (\n              <span className=\"uifw-modal-app-bar-right\">{appBarRight}</span>\n            )}\n          </div>\n          <div className=\"uifw-modal-stage-content\">{props.children}</div>\n        </>\n      )}\n    </div>\n  );\n}\n"]}
+{"version":3,"file":"ModalFrontstage.js","sourceRoot":"","sources":["../../../src/appui-react/frontstage/ModalFrontstage.tsx"],"names":[],"mappings":"AAAA;;;gGAGgG;AAChG;;GAEG;AAEH,OAAO,wBAAwB,CAAC;AAChC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,UAAU,MAAM,YAAY,CAAC;AAEpC,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAC5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAuCnE;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,KAAY;IAC1C,MAAM,EACJ,MAAM,EACN,YAAY;IACZ,4DAA4D;IAC5D,UAAU,EACV,UAAU,EACV,KAAK,EACL,WAAW,EACX,UAAU,EACV,GAAG,IAAI,EACR,GAAG,KAAK,CAAC;IAEV,MAAM,UAAU,GAAG,GAAG,EAAE;QACtB,YAAY,EAAE,EAAE,CAAC;QACjB,UAAU,EAAE,EAAE,CAAC;IACjB,CAAC,CAAC;IAEF,OAAO,CACL,gCACM,IAAI,EACR,SAAS,EAAE,UAAU,CACnB,uBAAuB,EACvB,MAAM,IAAI,iBAAiB,EAC3B,UAAU,IAAI,gBAAgB,EAC9B,KAAK,CAAC,SAAS,CAChB,IAEA,UAAU,CAAC,CAAC,CAAC,CACZ,KAAK,CAAC,QAAQ,CACf,CAAC,CAAC,CAAC,CACF;QACE,6BAAK,SAAS,EAAC,oBAAoB;YAChC,UAAU,CAAC,CAAC,CAAC,CACZ,UAAU,CACX,CAAC,CAAC,CAAC,CACF,oBAAC,qBAAqB,IAAC,OAAO,EAAE,UAAU,GAAI,CAC/C;YACD,oBAAC,IAAI,IAAC,OAAO,EAAC,UAAU,EAAC,SAAS,EAAC,eAAe,IAC/C,KAAK,CACD;YACN,WAAW,IAAI,CACd,8BAAM,SAAS,EAAC,0BAA0B,IAAE,WAAW,CAAQ,CAChE,CACG;QACN,6BAAK,SAAS,EAAC,0BAA0B,IAAE,KAAK,CAAC,QAAQ,CAAO,CAC/D,CACJ,CACG,CACP,CAAC;AACJ,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 Frontstage\n */\n\nimport \"./ModalFrontstage.scss\";\nimport * as React from \"react\";\nimport classnames from \"classnames\";\nimport type { CommonProps } from \"@itwin/core-react\";\nimport { Text } from \"@itwin/itwinui-react\";\nimport { ModalFrontstageButton } from \"./ModalFrontstageButton.js\";\nimport type { ConfigurableUiContent } from \"../configurableui/ConfigurableUiContent.js\";\n\n/** Properties for the [[ModalFrontstage]] React component\n * @public\n * @deprecated in 5.31.0. Use `React.ComponentProps<typeof ModalFrontstage>` instead.\n */\n// eslint-disable-next-line @typescript-eslint/no-deprecated\nexport interface ModalFrontstageProps extends CommonProps {\n  /** Title displayed at the top of the modal frontstage. */\n  title: string;\n  /** Indicates whether the modal frontstage is open. */\n  isOpen?: boolean;\n  /** Callback for navigating back from the modal frontstage. */\n  navigateBack?: () => void;\n  /** Callback for closing the modal frontstage. */\n  closeModal: () => void;\n  /** Optional content displayed in the upper right of the modal frontstage. */\n  appBarRight?: React.ReactNode;\n  /** If specified overrides the default {@link ModalFrontstageButton}. */\n  backButton?: React.ReactNode;\n  /** Content of the modal frontstage. */\n  children?: React.ReactNode;\n  /**\n   * If `true`, hides the header of the modal frontstage and renders the `children` prop in the root element.\n   * @note When set to `true`, the `title`, `navigateBack`, `closeModal`, `appBarRight`, and `backButton` props are ignored.\n   */\n  hideHeader?: boolean;\n}\n\n// eslint-disable-next-line @typescript-eslint/no-deprecated\ninterface Props extends Omit<ModalFrontstageProps, \"closeModal\"> {\n  /**\n   * Callback for closing the modal Frontstage.\n   * @deprecated in 5.31.0. Use `navigateBack` prop instead.\n   */\n  closeModal?: () => void;\n}\n\n/**\n * The default layout used for modal frontstages.\n * Use `renderModalFrontstage` prop of {@link ConfigurableUiContent} to override the modal frontstage layout.\n * @public\n */\nexport function ModalFrontstage(props: Props) {\n  const {\n    isOpen,\n    navigateBack,\n    // eslint-disable-next-line @typescript-eslint/no-deprecated\n    closeModal,\n    backButton,\n    title,\n    appBarRight,\n    hideHeader,\n    ...rest\n  } = props;\n\n  const handleBack = () => {\n    navigateBack?.();\n    closeModal?.();\n  };\n\n  return (\n    <div\n      {...rest}\n      className={classnames(\n        \"uifw-modal-frontstage\",\n        isOpen && \"uifw-modal-open\",\n        hideHeader && \"uifw-no-header\",\n        props.className\n      )}\n    >\n      {hideHeader ? (\n        props.children\n      ) : (\n        <>\n          <div className=\"uifw-modal-app-bar\">\n            {backButton ? (\n              backButton\n            ) : (\n              <ModalFrontstageButton onClick={handleBack} />\n            )}\n            <Text variant=\"headline\" className=\"uifw-headline\">\n              {title}\n            </Text>\n            {appBarRight && (\n              <span className=\"uifw-modal-app-bar-right\">{appBarRight}</span>\n            )}\n          </div>\n          <div className=\"uifw-modal-stage-content\">{props.children}</div>\n        </>\n      )}\n    </div>\n  );\n}\n"]}

package/lib/cjs/appui-react/backstage/Backstage.scss

@@ -0,0 +1,42 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+@use "~@itwin/core-react/lib/core-react/z-index" as zIndex;
+
+.uifw-backstage-backstage_wrapper {
+  @include zIndex.uicore-z-index(backstage);
+}
+
+.uifw-backstage-backstage {
+  inset-block-end: 0;
+  border-radius: 0;
+  margin-block-start: 0;
+  margin-inline-start: 0;
+}
+
+.uifw-backstage-backstage_backdrop {
+  &:where(.uifw-transparent) {
+    background-color: transparent;
+  }
+}
+
+.uifw-backstage-backstage_content {
+  padding-inline: var(--iui-size-xs);
+}
+
+.uifw-backstage-backstage_divider {
+  $margin-block: var(--iui-size-2xs);
+  $margin-inline: calc(-1 * var(--iui-size-xs));
+
+  margin-block-start: $margin-block;
+  margin-block-end: $margin-block;
+  margin-inline-start: $margin-inline;
+  margin-inline-end: $margin-inline;
+}
+
+.uifw-backstage-backstage_badge {
+  position: absolute;
+  inset-block-start: 0;
+  inset-inline-start: 0;
+}

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

@@ -0,0 +1,42 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+@use "~@itwin/core-react/lib/core-react/z-index" as zIndex;
+
+.uifw-backstage-backstage_wrapper {
+  @include zIndex.uicore-z-index(backstage);
+}
+
+.uifw-backstage-backstage {
+  inset-block-end: 0;
+  border-radius: 0;
+  margin-block-start: 0;
+  margin-inline-start: 0;
+}
+
+.uifw-backstage-backstage_backdrop {
+  &:where(.uifw-transparent) {
+    background-color: transparent;
+  }
+}
+
+.uifw-backstage-backstage_content {
+  padding-inline: var(--iui-size-xs);
+}
+
+.uifw-backstage-backstage_divider {
+  $margin-block: var(--iui-size-2xs);
+  $margin-inline: calc(-1 * var(--iui-size-xs));
+
+  margin-block-start: $margin-block;
+  margin-block-end: $margin-block;
+  margin-inline-start: $margin-inline;
+  margin-inline-end: $margin-inline;
+}
+
+.uifw-backstage-backstage_badge {
+  position: absolute;
+  inset-block-start: 0;
+  inset-inline-start: 0;
+}

package/lib/public/locales/en/UiFramework.json

@@ -1,4 +1,7 @@
 {
+  "backstage": {
+    "label": "Backstage"
+  },
   "iModelPanelHeader": {
     "projects": "Projects"
   },
@@ -124,7 +127,7 @@
     "yes": "Yes",
     "no": "No",
     "clearSelection": "Clear Selection",
-    "openBackstageMenu": "Open backstage menu"
+    "openBackstageMenu": "Open backstage"
   },
   "navigationAid": {
     "sheetsModalFrontstage": "Sheet Views"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@itwin/appui-react",
-  "version": "5.31.0",
+  "version": "5.32.1",
   "description": "A react component library for AppUI framework",
   "type": "module",
   "types": "./lib/appui-react.d.ts",
@@ -45,9 +45,9 @@
     "react-dom": "^18.0.0 || ^19.0.0",
     "react-redux": "^7.2.2 || ^8.0.0 || ^9.0.0",
     "redux": "^4.1.0 || ^5.0.0",
-    "@itwin/components-react": "5.31.0",
-    "@itwin/core-react": "5.31.0",
-    "@itwin/imodel-components-react": "5.31.0"
+    "@itwin/components-react": "5.32.1",
+    "@itwin/core-react": "5.32.1",
+    "@itwin/imodel-components-react": "5.32.1"
   },
   "devDependencies": {
     "@itwin/appui-abstract": "^5.8.1",
@@ -89,9 +89,9 @@
     "typescript": "~5.6.3",
     "upath": "^2.0.1",
     "vitest": "^3.2.4",
-    "@itwin/components-react": "5.31.0",
-    "@itwin/imodel-components-react": "5.31.0",
-    "@itwin/core-react": "5.31.0"
+    "@itwin/components-react": "5.32.1",
+    "@itwin/core-react": "5.32.1",
+    "@itwin/imodel-components-react": "5.32.1"
   },
   "dependencies": {
     "@itwin/itwinui-icons-react": "^2.11.0",

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

@@ -1,29 +0,0 @@
-/** @packageDocumentation
- * @module Backstage
- */
-import * as React from "react";
-import type { BackstageActionItem, BackstageItem, BackstageStageLauncher } from "./BackstageItem.js";
-/** @internal */
-export interface BackstageComposerActionItemProps {
-    readonly item: BackstageActionItem;
-}
-/** @internal */
-export declare function BackstageComposerActionItem({ item, }: BackstageComposerActionItemProps): React.JSX.Element;
-/** @internal */
-export interface BackstageComposerStageLauncherProps {
-    readonly item: BackstageStageLauncher;
-}
-/** @internal */
-export declare function BackstageComposerStageLauncher({ item, }: BackstageComposerStageLauncherProps): React.JSX.Element;
-/** Props of [[BackstageComposerItem]] component.
- * @internal
- */
-export interface BackstageComposerItemProps {
-    /** Backstage item to render */
-    readonly item: BackstageItem;
-}
-/** Item of [[BackstageComposer]].
- * @internal
- */
-export declare function BackstageComposerItem({ item }: BackstageComposerItemProps): React.JSX.Element;
-//# sourceMappingURL=BackstageComposerItem.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"BackstageComposerItem.d.ts","sourceRoot":"","sources":["../../../src/appui-react/backstage/BackstageComposerItem.tsx"],"names":[],"mappings":"AAIA;;GAEG;AASH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B,OAAO,KAAK,EACV,mBAAmB,EACnB,aAAa,EACb,sBAAsB,EAEvB,MAAM,oBAAoB,CAAC;AAK5B,gBAAgB;AAChB,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;CACpC;AAED,gBAAgB;AAChB,wBAAgB,2BAA2B,CAAC,EAC1C,IAAI,GACL,EAAE,gCAAgC,qBAwBlC;AAED,gBAAgB;AAChB,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;CACvC;AAED,gBAAgB;AAChB,wBAAgB,8BAA8B,CAAC,EAC7C,IAAI,GACL,EAAE,mCAAmC,qBAiCrC;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,+BAA+B;IAC/B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;CAC9B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,IAAI,EAAE,EAAE,0BAA0B,qBAKzE"}

package/lib/appui-react/backstage/BackstageComposerItem.js

@@ -1,66 +0,0 @@
-/*---------------------------------------------------------------------------------------------
- * 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 { ConditionalBooleanValue, ConditionalStringValue, } from "@itwin/appui-abstract";
-import { Logger } from "@itwin/core-bentley";
-import { Icon as CoreIcon } from "@itwin/core-react";
-import { Badge } from "@itwin/core-react/internal";
-import * as React from "react";
-import { UiFramework } from "../UiFramework.js";
-import { useActiveFrontstageId } from "../frontstage/FrontstageDef.js";
-import { BackstageItem as NZ_BackstageItem } from "../layout/backstage/Item.js";
-import { isProviderItem } from "../ui-items-provider/isProviderItem.js";
-import { isBackstageStageLauncher } from "./BackstageItem.js";
-import { useBackstageManager } from "./BackstageManager.js";
-import { Icon } from "@itwin/itwinui-react";
-/** @internal */
-export function BackstageComposerActionItem({ item, }) {
-    const manager = useBackstageManager();
-    const handleClick = React.useCallback(() => {
-        manager.close();
-        item.execute();
-    }, [manager, item]);
-    return (React.createElement(NZ_BackstageItem, { itemId: item.id, providerId: isProviderItem(item) ? item.providerId : undefined, itemPriority: item.itemPriority, groupPriority: item.groupPriority, 
-        // eslint-disable-next-line @typescript-eslint/no-deprecated
-        icon: React.createElement(ItemIcon, { iconNode: item.iconNode, icon: item.icon }), isActive: ConditionalBooleanValue.getValue(item.isActive), isDisabled: ConditionalBooleanValue.getValue(item.isDisabled), onClick: handleClick, subtitle: ConditionalStringValue.getValue(item.subtitle), 
-        // eslint-disable-next-line @typescript-eslint/no-deprecated
-        badge: React.createElement(Badge, { type: item.badgeKind || item.badge }) }, ConditionalStringValue.getValue(item.label)));
-}
-/** @internal */
-export function BackstageComposerStageLauncher({ item, }) {
-    const manager = useBackstageManager();
-    const handleClick = React.useCallback(() => {
-        manager.close();
-        if (!UiFramework.frontstages.hasFrontstage(item.stageId))
-            return Logger.logError("BackstageComposerStageLauncher", `Frontstage with id '${item.stageId}' not found`);
-        void UiFramework.frontstages.setActiveFrontstage(item.stageId);
-    }, [manager, item.stageId]);
-    const activeFrontstageId = useActiveFrontstageId();
-    const isActive = ConditionalBooleanValue.getValue(item.isActive ?? item.stageId === activeFrontstageId);
-    return (React.createElement(NZ_BackstageItem, { itemId: item.id, providerId: isProviderItem(item) ? item.providerId : undefined, itemPriority: item.itemPriority, groupPriority: item.groupPriority, 
-        // eslint-disable-next-line @typescript-eslint/no-deprecated
-        icon: React.createElement(ItemIcon, { iconNode: item.iconNode, icon: item.icon }), isActive: isActive, isDisabled: ConditionalBooleanValue.getValue(item.isDisabled), onClick: handleClick, subtitle: ConditionalStringValue.getValue(item.subtitle), 
-        // eslint-disable-next-line @typescript-eslint/no-deprecated
-        badge: React.createElement(Badge, { type: item.badgeKind || item.badge }) }, ConditionalStringValue.getValue(item.label)));
-}
-/** Item of [[BackstageComposer]].
- * @internal
- */
-export function BackstageComposerItem({ item }) {
-    if (isBackstageStageLauncher(item)) {
-        return React.createElement(BackstageComposerStageLauncher, { item: item });
-    }
-    return React.createElement(BackstageComposerActionItem, { item: item });
-}
-function ItemIcon({ icon, iconNode, }) {
-    if (iconNode) {
-        return React.createElement(Icon, null, iconNode);
-    }
-    // eslint-disable-next-line @typescript-eslint/no-deprecated
-    return React.createElement(CoreIcon, { iconSpec: icon });
-}
-//# sourceMappingURL=BackstageComposerItem.js.map

package/lib/appui-react/backstage/BackstageComposerItem.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"BackstageComposerItem.js","sourceRoot":"","sources":["../../../src/appui-react/backstage/BackstageComposerItem.tsx"],"names":[],"mappings":"AAAA;;;gGAGgG;AAChG;;GAEG;AAEH,OAAO,EACL,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,IAAI,IAAI,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAC;AACnD,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAE,aAAa,IAAI,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAOxE,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAO5C,gBAAgB;AAChB,MAAM,UAAU,2BAA2B,CAAC,EAC1C,IAAI,GAC6B;IACjC,MAAM,OAAO,GAAG,mBAAmB,EAAE,CAAC;IACtC,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE;QACzC,OAAO,CAAC,KAAK,EAAE,CAAC;QAChB,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;IACpB,OAAO,CACL,oBAAC,gBAAgB,IACf,MAAM,EAAE,IAAI,CAAC,EAAE,EACf,UAAU,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,EAC9D,YAAY,EAAE,IAAI,CAAC,YAAY,EAC/B,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,4DAA4D;QAC5D,IAAI,EAAE,oBAAC,QAAQ,IAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,GAAI,EAC5D,QAAQ,EAAE,uBAAuB,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,EACzD,UAAU,EAAE,uBAAuB,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,EAC7D,OAAO,EAAE,WAAW,EACpB,QAAQ,EAAE,sBAAsB,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC;QACxD,4DAA4D;QAC5D,KAAK,EAAE,oBAAC,KAAK,IAAC,IAAI,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,KAAK,GAAI,IAEnD,sBAAsB,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAC3B,CACpB,CAAC;AACJ,CAAC;AAOD,gBAAgB;AAChB,MAAM,UAAU,8BAA8B,CAAC,EAC7C,IAAI,GACgC;IACpC,MAAM,OAAO,GAAG,mBAAmB,EAAE,CAAC;IACtC,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE;QACzC,OAAO,CAAC,KAAK,EAAE,CAAC;QAChB,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC;YACtD,OAAO,MAAM,CAAC,QAAQ,CACpB,gCAAgC,EAChC,uBAAuB,IAAI,CAAC,OAAO,aAAa,CACjD,CAAC;QACJ,KAAK,WAAW,CAAC,WAAW,CAAC,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACjE,CAAC,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5B,MAAM,kBAAkB,GAAG,qBAAqB,EAAE,CAAC;IACnD,MAAM,QAAQ,GAAG,uBAAuB,CAAC,QAAQ,CAC/C,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,OAAO,KAAK,kBAAkB,CACrD,CAAC;IACF,OAAO,CACL,oBAAC,gBAAgB,IACf,MAAM,EAAE,IAAI,CAAC,EAAE,EACf,UAAU,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,EAC9D,YAAY,EAAE,IAAI,CAAC,YAAY,EAC/B,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,4DAA4D;QAC5D,IAAI,EAAE,oBAAC,QAAQ,IAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,GAAI,EAC5D,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,uBAAuB,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,EAC7D,OAAO,EAAE,WAAW,EACpB,QAAQ,EAAE,sBAAsB,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC;QACxD,4DAA4D;QAC5D,KAAK,EAAE,oBAAC,KAAK,IAAC,IAAI,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,KAAK,GAAI,IAEnD,sBAAsB,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAC3B,CACpB,CAAC;AACJ,CAAC;AAUD;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,EAAE,IAAI,EAA8B;IACxE,IAAI,wBAAwB,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,OAAO,oBAAC,8BAA8B,IAAC,IAAI,EAAE,IAAI,GAAI,CAAC;IACxD,CAAC;IACD,OAAO,oBAAC,2BAA2B,IAAC,IAAI,EAAE,IAAI,GAAI,CAAC;AACrD,CAAC;AAED,SAAS,QAAQ,CAAC,EAChB,IAAI,EACJ,QAAQ,GAIT;IACC,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,oBAAC,IAAI,QAAE,QAAQ,CAAQ,CAAC;IACjC,CAAC;IAED,4DAA4D;IAC5D,OAAO,oBAAC,QAAQ,IAAC,QAAQ,EAAE,IAAI,GAAI,CAAC;AACtC,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 Backstage\n */\n\nimport {\n  ConditionalBooleanValue,\n  ConditionalStringValue,\n} from \"@itwin/appui-abstract\";\nimport { Logger } from \"@itwin/core-bentley\";\nimport { Icon as CoreIcon } from \"@itwin/core-react\";\nimport { Badge } from \"@itwin/core-react/internal\";\nimport * as React from \"react\";\nimport { UiFramework } from \"../UiFramework.js\";\nimport { useActiveFrontstageId } from \"../frontstage/FrontstageDef.js\";\nimport { BackstageItem as NZ_BackstageItem } from \"../layout/backstage/Item.js\";\nimport { isProviderItem } from \"../ui-items-provider/isProviderItem.js\";\nimport type {\n  BackstageActionItem,\n  BackstageItem,\n  BackstageStageLauncher,\n  CommonBackstageItem,\n} from \"./BackstageItem.js\";\nimport { isBackstageStageLauncher } from \"./BackstageItem.js\";\nimport { useBackstageManager } from \"./BackstageManager.js\";\nimport { Icon } from \"@itwin/itwinui-react\";\n\n/** @internal */\nexport interface BackstageComposerActionItemProps {\n  readonly item: BackstageActionItem;\n}\n\n/** @internal */\nexport function BackstageComposerActionItem({\n  item,\n}: BackstageComposerActionItemProps) {\n  const manager = useBackstageManager();\n  const handleClick = React.useCallback(() => {\n    manager.close();\n    item.execute();\n  }, [manager, item]);\n  return (\n    <NZ_BackstageItem\n      itemId={item.id}\n      providerId={isProviderItem(item) ? item.providerId : undefined}\n      itemPriority={item.itemPriority}\n      groupPriority={item.groupPriority}\n      // eslint-disable-next-line @typescript-eslint/no-deprecated\n      icon={<ItemIcon iconNode={item.iconNode} icon={item.icon} />}\n      isActive={ConditionalBooleanValue.getValue(item.isActive)}\n      isDisabled={ConditionalBooleanValue.getValue(item.isDisabled)}\n      onClick={handleClick}\n      subtitle={ConditionalStringValue.getValue(item.subtitle)}\n      // eslint-disable-next-line @typescript-eslint/no-deprecated\n      badge={<Badge type={item.badgeKind || item.badge} />}\n    >\n      {ConditionalStringValue.getValue(item.label)}\n    </NZ_BackstageItem>\n  );\n}\n\n/** @internal */\nexport interface BackstageComposerStageLauncherProps {\n  readonly item: BackstageStageLauncher;\n}\n\n/** @internal */\nexport function BackstageComposerStageLauncher({\n  item,\n}: BackstageComposerStageLauncherProps) {\n  const manager = useBackstageManager();\n  const handleClick = React.useCallback(() => {\n    manager.close();\n    if (!UiFramework.frontstages.hasFrontstage(item.stageId))\n      return Logger.logError(\n        \"BackstageComposerStageLauncher\",\n        `Frontstage with id '${item.stageId}' not found`\n      );\n    void UiFramework.frontstages.setActiveFrontstage(item.stageId);\n  }, [manager, item.stageId]);\n  const activeFrontstageId = useActiveFrontstageId();\n  const isActive = ConditionalBooleanValue.getValue(\n    item.isActive ?? item.stageId === activeFrontstageId\n  );\n  return (\n    <NZ_BackstageItem\n      itemId={item.id}\n      providerId={isProviderItem(item) ? item.providerId : undefined}\n      itemPriority={item.itemPriority}\n      groupPriority={item.groupPriority}\n      // eslint-disable-next-line @typescript-eslint/no-deprecated\n      icon={<ItemIcon iconNode={item.iconNode} icon={item.icon} />}\n      isActive={isActive}\n      isDisabled={ConditionalBooleanValue.getValue(item.isDisabled)}\n      onClick={handleClick}\n      subtitle={ConditionalStringValue.getValue(item.subtitle)}\n      // eslint-disable-next-line @typescript-eslint/no-deprecated\n      badge={<Badge type={item.badgeKind || item.badge} />}\n    >\n      {ConditionalStringValue.getValue(item.label)}\n    </NZ_BackstageItem>\n  );\n}\n\n/** Props of [[BackstageComposerItem]] component.\n * @internal\n */\nexport interface BackstageComposerItemProps {\n  /** Backstage item to render */\n  readonly item: BackstageItem;\n}\n\n/** Item of [[BackstageComposer]].\n * @internal\n */\nexport function BackstageComposerItem({ item }: BackstageComposerItemProps) {\n  if (isBackstageStageLauncher(item)) {\n    return <BackstageComposerStageLauncher item={item} />;\n  }\n  return <BackstageComposerActionItem item={item} />;\n}\n\nfunction ItemIcon({\n  icon,\n  iconNode,\n}: {\n  icon: CommonBackstageItem[\"icon\"];\n  iconNode: CommonBackstageItem[\"iconNode\"];\n}) {\n  if (iconNode) {\n    return <Icon>{iconNode}</Icon>;\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-deprecated\n  return <CoreIcon iconSpec={icon} />;\n}\n"]}