@itwin/appui-react 3.0.0-extension.1 → 3.1.0-dev.6

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

@@ -10,7 +10,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.BackstageComposer = exports.useGroupedItems = void 0;
 const React = require("react");
 const appui_abstract_1 = require("@itwin/appui-abstract");
-const appui_layout_react_1 = require("@itwin/appui-layout-react"); // eslint-disable-line sort-imports
+const appui_layout_react_1 = require("@itwin/appui-layout-react");
 const SafeAreaContext_1 = require("../safearea/SafeAreaContext");
 const SyncUiEventDispatcher_1 = require("../syncui/SyncUiEventDispatcher");
 const BackstageComposerItem_1 = require("./BackstageComposerItem");
@@ -43,12 +43,30 @@ function useBackstageItemSyncEffect(itemsManager, syncIdsOfInterest) {
     }, [itemsManager, itemsManager.items, syncIdsOfInterest]);
 }
 /** local function to combine items from Stage and from Extensions */
-function combineItems(stageItems, addonItems) {
-    const items = [];
-    if (stageItems.length)
-        items.push(...stageItems);
-    if (addonItems.length)
-        items.push(...addonItems);
+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 + ((0, appui_abstract_1.isStageLauncher)(item) ? 1 : 0), 0);
+        if (1 === numberOfFrontstageItems)
+            items = items.filter((item) => !(0, appui_abstract_1.isStageLauncher)(item));
+    }
     return items;
 }
 /** @internal */
@@ -110,7 +128,7 @@ function BackstageComposer(props) {
     const addonItems = (0, useUiItemsProviderBackstageItems_1.useUiItemsProviderBackstageItems)(addonItemsManager);
     const addonSyncIdsOfInterest = React.useMemo(() => appui_abstract_1.BackstageItemsManager.getSyncIdsOfInterest(addonItems), [addonItems]);
     useBackstageItemSyncEffect(addonItemsManager, addonSyncIdsOfInterest);
-    const combinedBackstageItems = React.useMemo(() => combineItems(defaultItems, addonItems), [defaultItems, addonItems]);
+    const combinedBackstageItems = React.useMemo(() => combineItems(defaultItems, addonItems, !!props.hideSoloStageEntry), [defaultItems, addonItems, props.hideSoloStageEntry]);
     const groups = (0, exports.useGroupedItems)(combinedBackstageItems);
     return (React.createElement(appui_layout_react_1.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_1.BackstageComposerItem, { item: item, key: item.id }));

package/lib/cjs/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":["/*---------------------------------------------------------------------------------------------\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 } from \"@itwin/appui-abstract\";\r\nimport { CommonProps } from \"@itwin/core-react\";\r\nimport { Backstage as NZ_Backstage, BackstageSeparator } from \"@itwin/appui-layout-react\"; // eslint-disable-line sort-imports\r\nimport { SafeAreaContext } from \"../safearea/SafeAreaContext\";\r\nimport { SyncUiEventArgs, 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/** 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: SyncUiEventArgs) => {\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>) {\r\n  const items: BackstageItem[] = [];\r\n  if (stageItems.length)\r\n    items.push(...stageItems);\r\n  if (addonItems.length)\r\n    items.push(...addonItems);\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 backstage items to show */\r\n  readonly items: BackstageItem[];\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), [defaultItems, addonItems]);\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"]}
+{"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/** 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 backstage items to show */\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/cjs/appui-react/backstage/BackstageComposerItem.d.ts

@@ -16,14 +16,14 @@ export interface BackstageComposerStageLauncherProps {
 /** @internal */
 export declare function BackstageComposerStageLauncher({ item }: BackstageComposerStageLauncherProps): JSX.Element;
 /** Props of [[BackstageComposerItem]] component.
- * @beta
+ * @internal
  */
 export interface BackstageComposerItemProps {
     /** Backstage item to render */
     readonly item: BackstageItem;
 }
 /** Item of [[BackstageComposer]].
- * @beta
+ * @internal
  */
 export declare function BackstageComposerItem({ item }: BackstageComposerItemProps): JSX.Element;
 //# sourceMappingURL=BackstageComposerItem.d.ts.map

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

@@ -42,7 +42,7 @@ function BackstageComposerStageLauncher({ item }) {
 }
 exports.BackstageComposerStageLauncher = BackstageComposerStageLauncher;
 /** Item of [[BackstageComposer]].
- * @beta
+ * @internal
  */
 function BackstageComposerItem({ item }) {
     if ((0, appui_abstract_1.isStageLauncher)(item)) {

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

@@ -1 +1 @@
-{"version":3,"file":"BackstageComposerItem.js","sourceRoot":"","sources":["../../../../src/appui-react/backstage/BackstageComposerItem.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 { Logger } from \"@itwin/core-bentley\";\r\nimport {\r\n  BackstageActionItem, BackstageItem, BackstageStageLauncher, ConditionalBooleanValue, ConditionalStringValue, isStageLauncher,\r\n} from \"@itwin/appui-abstract\";\r\nimport { BadgeUtilities, Icon } from \"@itwin/core-react\";\r\nimport { BackstageItem as NZ_BackstageItem } from \"@itwin/appui-layout-react\";\r\nimport { useActiveFrontstageId } from \"../frontstage/Frontstage\";\r\nimport { FrontstageManager } from \"../frontstage/FrontstageManager\";\r\nimport { useBackstageManager } from \"./BackstageManager\";\r\n\r\n/** @internal */\r\nexport interface BackstageComposerActionItemProps {\r\n  readonly item: BackstageActionItem;\r\n}\r\n\r\n/** @internal */\r\nexport function BackstageComposerActionItem({ item }: BackstageComposerActionItemProps) {\r\n  const manager = useBackstageManager();\r\n  const handleClick = React.useCallback(() => {\r\n    manager.close();\r\n    item.execute();\r\n  }, [manager, item]);\r\n  return (\r\n    <NZ_BackstageItem\r\n      itemId={item.id}\r\n      icon={<Icon iconSpec={ConditionalStringValue.getValue(item.icon)} />}\r\n      isActive={ConditionalBooleanValue.getValue(item.isActive)}\r\n      isDisabled={ConditionalBooleanValue.getValue(item.isDisabled)}\r\n      onClick={handleClick}\r\n      subtitle={ConditionalStringValue.getValue(item.subtitle)}\r\n      badge={BadgeUtilities.getComponentForBadgeType(item.badgeType)}\r\n    >\r\n      {ConditionalStringValue.getValue(item.label)}\r\n    </NZ_BackstageItem>\r\n  );\r\n}\r\n\r\n/** @internal */\r\nexport interface BackstageComposerStageLauncherProps {\r\n  readonly item: BackstageStageLauncher;\r\n}\r\n\r\n/** @internal */\r\nexport function BackstageComposerStageLauncher({ item }: BackstageComposerStageLauncherProps) {\r\n  const manager = useBackstageManager();\r\n  const handleClick = React.useCallback(() => {\r\n    manager.close();\r\n    if (!FrontstageManager.hasFrontstage(item.stageId))\r\n      return Logger.logError(\"BackstageComposerStageLauncher\", `Frontstage with id '${item.stageId}' not found`);\r\n    void FrontstageManager.setActiveFrontstage(item.stageId);\r\n  }, [manager, item.stageId]);\r\n  const activeFrontstageId = useActiveFrontstageId();\r\n  const isActive = ConditionalBooleanValue.getValue(item.isActive ?? item.stageId === activeFrontstageId);\r\n  return (\r\n    <NZ_BackstageItem\r\n      itemId={item.id}\r\n      icon={<Icon iconSpec={ConditionalStringValue.getValue(item.icon)} />}\r\n      isActive={isActive}\r\n      isDisabled={ConditionalBooleanValue.getValue(item.isDisabled)}\r\n      onClick={handleClick}\r\n      subtitle={ConditionalStringValue.getValue(item.subtitle)}\r\n      badge={BadgeUtilities.getComponentForBadgeType(item.badgeType)}\r\n    >\r\n      {ConditionalStringValue.getValue(item.label)}\r\n    </NZ_BackstageItem>\r\n  );\r\n}\r\n\r\n/** Props of [[BackstageComposerItem]] component.\r\n * @beta\r\n */\r\nexport interface BackstageComposerItemProps {\r\n  /** Backstage item to render */\r\n  readonly item: BackstageItem;\r\n}\r\n\r\n/** Item of [[BackstageComposer]].\r\n * @beta\r\n */\r\nexport function BackstageComposerItem({ item }: BackstageComposerItemProps) {\r\n  if (isStageLauncher(item)) {\r\n    return (\r\n      <BackstageComposerStageLauncher\r\n        item={item}\r\n      />\r\n    );\r\n  }\r\n  return (\r\n    <BackstageComposerActionItem\r\n      item={item}\r\n    />\r\n  );\r\n}\r\n"]}
+{"version":3,"file":"BackstageComposerItem.js","sourceRoot":"","sources":["../../../../src/appui-react/backstage/BackstageComposerItem.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 { Logger } from \"@itwin/core-bentley\";\r\nimport {\r\n  BackstageActionItem, BackstageItem, BackstageStageLauncher, ConditionalBooleanValue, ConditionalStringValue, isStageLauncher,\r\n} from \"@itwin/appui-abstract\";\r\nimport { BadgeUtilities, Icon } from \"@itwin/core-react\";\r\nimport { BackstageItem as NZ_BackstageItem } from \"@itwin/appui-layout-react\";\r\nimport { useActiveFrontstageId } from \"../frontstage/Frontstage\";\r\nimport { FrontstageManager } from \"../frontstage/FrontstageManager\";\r\nimport { useBackstageManager } from \"./BackstageManager\";\r\n\r\n/** @internal */\r\nexport interface BackstageComposerActionItemProps {\r\n  readonly item: BackstageActionItem;\r\n}\r\n\r\n/** @internal */\r\nexport function BackstageComposerActionItem({ item }: BackstageComposerActionItemProps) {\r\n  const manager = useBackstageManager();\r\n  const handleClick = React.useCallback(() => {\r\n    manager.close();\r\n    item.execute();\r\n  }, [manager, item]);\r\n  return (\r\n    <NZ_BackstageItem\r\n      itemId={item.id}\r\n      icon={<Icon iconSpec={ConditionalStringValue.getValue(item.icon)} />}\r\n      isActive={ConditionalBooleanValue.getValue(item.isActive)}\r\n      isDisabled={ConditionalBooleanValue.getValue(item.isDisabled)}\r\n      onClick={handleClick}\r\n      subtitle={ConditionalStringValue.getValue(item.subtitle)}\r\n      badge={BadgeUtilities.getComponentForBadgeType(item.badgeType)}\r\n    >\r\n      {ConditionalStringValue.getValue(item.label)}\r\n    </NZ_BackstageItem>\r\n  );\r\n}\r\n\r\n/** @internal */\r\nexport interface BackstageComposerStageLauncherProps {\r\n  readonly item: BackstageStageLauncher;\r\n}\r\n\r\n/** @internal */\r\nexport function BackstageComposerStageLauncher({ item }: BackstageComposerStageLauncherProps) {\r\n  const manager = useBackstageManager();\r\n  const handleClick = React.useCallback(() => {\r\n    manager.close();\r\n    if (!FrontstageManager.hasFrontstage(item.stageId))\r\n      return Logger.logError(\"BackstageComposerStageLauncher\", `Frontstage with id '${item.stageId}' not found`);\r\n    void FrontstageManager.setActiveFrontstage(item.stageId);\r\n  }, [manager, item.stageId]);\r\n  const activeFrontstageId = useActiveFrontstageId();\r\n  const isActive = ConditionalBooleanValue.getValue(item.isActive ?? item.stageId === activeFrontstageId);\r\n  return (\r\n    <NZ_BackstageItem\r\n      itemId={item.id}\r\n      icon={<Icon iconSpec={ConditionalStringValue.getValue(item.icon)} />}\r\n      isActive={isActive}\r\n      isDisabled={ConditionalBooleanValue.getValue(item.isDisabled)}\r\n      onClick={handleClick}\r\n      subtitle={ConditionalStringValue.getValue(item.subtitle)}\r\n      badge={BadgeUtilities.getComponentForBadgeType(item.badgeType)}\r\n    >\r\n      {ConditionalStringValue.getValue(item.label)}\r\n    </NZ_BackstageItem>\r\n  );\r\n}\r\n\r\n/** Props of [[BackstageComposerItem]] component.\r\n * @internal\r\n */\r\nexport interface BackstageComposerItemProps {\r\n  /** Backstage item to render */\r\n  readonly item: BackstageItem;\r\n}\r\n\r\n/** Item of [[BackstageComposer]].\r\n * @internal\r\n */\r\nexport function BackstageComposerItem({ item }: BackstageComposerItemProps) {\r\n  if (isStageLauncher(item)) {\r\n    return (\r\n      <BackstageComposerStageLauncher\r\n        item={item}\r\n      />\r\n    );\r\n  }\r\n  return (\r\n    <BackstageComposerActionItem\r\n      item={item}\r\n    />\r\n  );\r\n}\r\n"]}

package/lib/cjs/appui-react/backstage/BackstageItemProps.d.ts

@@ -5,7 +5,7 @@ import { StringGetter } from "@itwin/appui-abstract";
 import { IconProps, IconSpec } from "@itwin/core-react";
 /** Base properties for a [[Backstage]] item.
  * @public
- * @deprecated - use [BackstageItem]($appui-abstract) in bentley/appui-abstract instead
+ * @deprecated Use [BackstageItem]($appui-abstract) instead
  */
 export interface BackstageItemProps extends IconProps {
     /** if set, component will be enabled - defaults to true */
@@ -31,7 +31,7 @@ export interface BackstageItemProps extends IconProps {
 }
 /** Properties that define the state of a Backstage items.
  * @public
- * @deprecated - use [BackstageItem]($appui-abstract) in bentley/appui-abstract instead
+ * @deprecated Use [BackstageItem]($appui-abstract) instead
  */
 export interface BackstageItemState {
     isEnabled: boolean;
@@ -43,7 +43,7 @@ export interface BackstageItemState {
 }
 /** Helper method to set backstage item state from props.
  * @public
- * @deprecated - use [BackstageItem]($appui-abstract) in bentley/appui-abstract instead
+ * @deprecated Use [BackstageItem]($appui-abstract) instead
  */
 export declare const getBackstageItemStateFromProps: (props: BackstageItemProps) => BackstageItemState;
 //# sourceMappingURL=BackstageItemProps.d.ts.map

package/lib/cjs/appui-react/backstage/BackstageItemProps.js

@@ -11,7 +11,7 @@ exports.getBackstageItemStateFromProps = void 0;
 const BackstageItemUtilities_1 = require("./BackstageItemUtilities");
 /** Helper method to set backstage item state from props.
  * @public
- * @deprecated - use [BackstageItem]($appui-abstract) in bentley/appui-abstract instead
+ * @deprecated Use [BackstageItem]($appui-abstract) instead
  */
 // istanbul ignore next
 const getBackstageItemStateFromProps = (props) => {

package/lib/cjs/appui-react/backstage/BackstageItemProps.js.map

@@ -1 +1 @@
-{"version":3,"file":"BackstageItemProps.js","sourceRoot":"","sources":["../../../../src/appui-react/backstage/BackstageItemProps.tsx"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAIH,qEAAkE;AA0ClE;;;GAGG;AACH,uBAAuB;AAChB,MAAM,8BAA8B,GAAG,CAAC,KAAyB,EAAsB,EAAE;IAC9F,mDAAmD;IACnD,OAAO,+CAAsB,CAAC,8BAA8B,CAAC,KAAK,CAAC,CAAC;AACtE,CAAC,CAAC;AAHW,QAAA,8BAA8B,kCAGzC","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 { StringGetter } from \"@itwin/appui-abstract\";\r\nimport { IconProps, IconSpec } from \"@itwin/core-react\";\r\nimport { BackstageItemUtilities } from \"./BackstageItemUtilities\";\r\n\r\n/** Base properties for a [[Backstage]] item.\r\n * @public\r\n * @deprecated - use [BackstageItem]($appui-abstract) in bentley/appui-abstract instead\r\n */\r\nexport interface BackstageItemProps extends IconProps {\r\n  /** if set, component will be enabled - defaults to true */\r\n  isEnabled?: boolean;\r\n  /** if set, component will be shown with as the active item - defaults to false */\r\n  isActive?: boolean;\r\n  /** optional function to set state of backstage item */\r\n  stateFunc?: (state: Readonly<BackstageItemState>) => BackstageItemState; // eslint-disable-line deprecation/deprecation\r\n  /** optional SyncUi event ids that will trigger the state function to run. */\r\n  stateSyncIds?: string[];\r\n  /** if set, it is used to explicitly set the label shown by a component. */\r\n  label?: string | StringGetter;\r\n  /** if set, it is used to define a key that is used to look up a localized string. This value is used only if label is not explicitly set. */\r\n  labelKey?: string;\r\n  /** if set, it is used to explicitly set the description shown by a component. */\r\n  description?: string | StringGetter;\r\n  /** if set, it is used to define a key that is used to look up a localized string. This value is used only if description is not explicitly set. */\r\n  descriptionKey?: string;\r\n  /** used to explicitly set the tooltip shown by a component. */\r\n  tooltip?: string | StringGetter;\r\n  /** if set, it is used to define a key that is used to look up a localized string. This value is used only if label is not explicitly set. */\r\n  tooltipKey?: string;\r\n}\r\n\r\n/** Properties that define the state of a Backstage items.\r\n * @public\r\n * @deprecated - use [BackstageItem]($appui-abstract) in bentley/appui-abstract instead\r\n */\r\nexport interface BackstageItemState {\r\n  isEnabled: boolean;\r\n  label: string;\r\n  subtitle: string;\r\n  tooltip: string;\r\n  iconSpec: IconSpec;\r\n  isActive?: boolean;\r\n}\r\n\r\n/** Helper method to set backstage item state from props.\r\n * @public\r\n * @deprecated - use [BackstageItem]($appui-abstract) in bentley/appui-abstract instead\r\n */\r\n// istanbul ignore next\r\nexport const getBackstageItemStateFromProps = (props: BackstageItemProps): BackstageItemState => { // eslint-disable-line deprecation/deprecation\r\n  // eslint-disable-next-line deprecation/deprecation\r\n  return BackstageItemUtilities.getBackstageItemStateFromProps(props);\r\n};\r\n"]}
+{"version":3,"file":"BackstageItemProps.js","sourceRoot":"","sources":["../../../../src/appui-react/backstage/BackstageItemProps.tsx"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAIH,qEAAkE;AA0ClE;;;GAGG;AACH,uBAAuB;AAChB,MAAM,8BAA8B,GAAG,CAAC,KAAyB,EAAsB,EAAE;IAC9F,mDAAmD;IACnD,OAAO,+CAAsB,CAAC,8BAA8B,CAAC,KAAK,CAAC,CAAC;AACtE,CAAC,CAAC;AAHW,QAAA,8BAA8B,kCAGzC","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 { StringGetter } from \"@itwin/appui-abstract\";\r\nimport { IconProps, IconSpec } from \"@itwin/core-react\";\r\nimport { BackstageItemUtilities } from \"./BackstageItemUtilities\";\r\n\r\n/** Base properties for a [[Backstage]] item.\r\n * @public\r\n * @deprecated Use [BackstageItem]($appui-abstract) instead\r\n */\r\nexport interface BackstageItemProps extends IconProps {\r\n  /** if set, component will be enabled - defaults to true */\r\n  isEnabled?: boolean;\r\n  /** if set, component will be shown with as the active item - defaults to false */\r\n  isActive?: boolean;\r\n  /** optional function to set state of backstage item */\r\n  stateFunc?: (state: Readonly<BackstageItemState>) => BackstageItemState; // eslint-disable-line deprecation/deprecation\r\n  /** optional SyncUi event ids that will trigger the state function to run. */\r\n  stateSyncIds?: string[];\r\n  /** if set, it is used to explicitly set the label shown by a component. */\r\n  label?: string | StringGetter;\r\n  /** if set, it is used to define a key that is used to look up a localized string. This value is used only if label is not explicitly set. */\r\n  labelKey?: string;\r\n  /** if set, it is used to explicitly set the description shown by a component. */\r\n  description?: string | StringGetter;\r\n  /** if set, it is used to define a key that is used to look up a localized string. This value is used only if description is not explicitly set. */\r\n  descriptionKey?: string;\r\n  /** used to explicitly set the tooltip shown by a component. */\r\n  tooltip?: string | StringGetter;\r\n  /** if set, it is used to define a key that is used to look up a localized string. This value is used only if label is not explicitly set. */\r\n  tooltipKey?: string;\r\n}\r\n\r\n/** Properties that define the state of a Backstage items.\r\n * @public\r\n * @deprecated Use [BackstageItem]($appui-abstract) instead\r\n */\r\nexport interface BackstageItemState {\r\n  isEnabled: boolean;\r\n  label: string;\r\n  subtitle: string;\r\n  tooltip: string;\r\n  iconSpec: IconSpec;\r\n  isActive?: boolean;\r\n}\r\n\r\n/** Helper method to set backstage item state from props.\r\n * @public\r\n * @deprecated Use [BackstageItem]($appui-abstract) instead\r\n */\r\n// istanbul ignore next\r\nexport const getBackstageItemStateFromProps = (props: BackstageItemProps): BackstageItemState => { // eslint-disable-line deprecation/deprecation\r\n  // eslint-disable-next-line deprecation/deprecation\r\n  return BackstageItemUtilities.getBackstageItemStateFromProps(props);\r\n};\r\n"]}

package/lib/cjs/appui-react/backstage/BackstageItemUtilities.d.ts

@@ -5,7 +5,7 @@ import { BackstageActionItem as UIA_BackstageActionItem, BackstageStageLauncher
 import { BackstageItemProps, BackstageItemState } from "./BackstageItemProps";
 /** Used to specify the item type added to the backstage menu.
  * @beta
- * @deprecated Use [BackstageItemType]($appui-abstract) in bentley/appui-abstract instead
+ * @deprecated Use [BackstageItemType]($appui-abstract) instead
  */
 export declare enum BackstageItemType {
     /** Item that executes an action function */
@@ -15,14 +15,14 @@ export declare enum BackstageItemType {
 }
 /** Describes the data needed to insert an action button into the backstage menu.
  * @beta
- * @deprecated Use [BackstageActionItem]($appui-abstract) in bentley/appui-abstract instead
+ * @deprecated Use [BackstageActionItem]($appui-abstract) instead
  */
 export interface BackstageActionItem extends UIA_BackstageActionItem {
     readonly type: BackstageItemType.ActionItem;
 }
 /** Describes the data needed to insert an action button into the backstage menu.
  * @beta
- * @deprecated Use [BackstageStageLauncher]($appui-abstract) in bentley/appui-abstract instead
+ * @deprecated Use [BackstageStageLauncher]($appui-abstract) instead
  */
 export interface BackstageStageLauncher extends UIA_BackstageStageLauncher {
     readonly type: BackstageItemType.StageLauncher;
@@ -33,12 +33,12 @@ export interface BackstageStageLauncher extends UIA_BackstageStageLauncher {
 export declare class BackstageItemUtilities {
     /** Creates a stage launcher backstage item
      * @beta
-     * @deprecated Use BackstageItemUtilities.createStageLauncher in bentley/appui-abstract instead
+     * @deprecated Use [BackstageItemUtilities.createStageLauncher]($appui-abstract) instead
      */
     static createStageLauncher: (frontstageId: string, groupPriority: number, itemPriority: number, label: string, subtitle?: string | undefined, iconSpec?: string | undefined, overrides?: Partial<BackstageStageLauncher> | undefined) => BackstageStageLauncher;
     /** Creates an action backstage item
      * @beta
-     * @deprecated Use BackstageItemUtilities.createActionItem in bentley/appui-abstract instead
+     * @deprecated Use [BackstageItemUtilities.createActionItem]($appui-abstract) instead
      */
     static createActionItem: (itemId: string, groupPriority: number, itemPriority: number, execute: () => void, label: string, subtitle?: string | undefined, iconSpec?: string | undefined, overrides?: Partial<BackstageActionItem> | undefined) => BackstageActionItem;
     /** Helper method to set backstage item state from props */

package/lib/cjs/appui-react/backstage/BackstageItemUtilities.js

@@ -11,7 +11,7 @@ exports.BackstageItemUtilities = exports.BackstageItemType = void 0;
 const PropsHelper_1 = require("../utils/PropsHelper");
 /** Used to specify the item type added to the backstage menu.
  * @beta
- * @deprecated Use [BackstageItemType]($appui-abstract) in bentley/appui-abstract instead
+ * @deprecated Use [BackstageItemType]($appui-abstract) instead
  */
 var BackstageItemType;
 (function (BackstageItemType) {
@@ -28,7 +28,7 @@ class BackstageItemUtilities {
 exports.BackstageItemUtilities = BackstageItemUtilities;
 /** Creates a stage launcher backstage item
  * @beta
- * @deprecated Use BackstageItemUtilities.createStageLauncher in bentley/appui-abstract instead
+ * @deprecated Use [BackstageItemUtilities.createStageLauncher]($appui-abstract) instead
  */
 BackstageItemUtilities.createStageLauncher = (frontstageId, groupPriority, itemPriority, label, subtitle, iconSpec, overrides) => ({
     groupPriority,
@@ -43,7 +43,7 @@ BackstageItemUtilities.createStageLauncher = (frontstageId, groupPriority, itemP
 });
 /** Creates an action backstage item
  * @beta
- * @deprecated Use BackstageItemUtilities.createActionItem in bentley/appui-abstract instead
+ * @deprecated Use [BackstageItemUtilities.createActionItem]($appui-abstract) instead
  */
 BackstageItemUtilities.createActionItem = (itemId, groupPriority, itemPriority, execute, label, subtitle, iconSpec, overrides) => ({
     execute,

package/lib/cjs/appui-react/backstage/BackstageItemUtilities.js.map

@@ -1 +1 @@
-{"version":3,"file":"BackstageItemUtilities.js","sourceRoot":"","sources":["../../../../src/appui-react/backstage/BackstageItemUtilities.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAGH,sDAAmD;AAGnD;;;GAGG;AACH,IAAY,iBAKX;AALD,WAAY,iBAAiB;IAC3B,4CAA4C;IAC5C,qEAAc,CAAA;IACd,kCAAkC;IAClC,2EAAiB,CAAA;AACnB,CAAC,EALW,iBAAiB,GAAjB,yBAAiB,KAAjB,yBAAiB,QAK5B;AAkBD;;GAEG;AACH,MAAa,sBAAsB;;AAAnC,wDAgDC;AA/CC;;;GAGG;AACW,0CAAmB,GAAG,CAAC,YAAoB,EAAE,aAAqB,EAAE,YAAoB,EAAE,KAAa,EAAE,QAAiB,EAAE,QAAiB,EAAE,SAA2C,EAA0B,EAAE,CAAC,CAAC;IACpO,aAAa;IACb,IAAI,EAAE,QAAQ;IACd,EAAE,EAAE,YAAY;IAChB,YAAY;IACZ,IAAI,EAAE,iBAAiB,CAAC,aAAa;IACrC,KAAK;IACL,OAAO,EAAE,YAAY;IACrB,QAAQ;IACR,GAAG,SAAS;CACb,CAAC,CAAC;AAEH;;;GAGG;AACW,uCAAgB,GAAG,CAAC,MAAc,EAAE,aAAqB,EAAE,YAAoB,EAAE,OAAmB,EAAE,KAAa,EAAE,QAAiB,EAAE,QAAiB,EAAE,SAAwC,EAAuB,EAAE,CAAC,CAAC;IAC1O,OAAO;IACP,aAAa;IACb,IAAI,EAAE,QAAQ;IACd,EAAE,EAAE,MAAM;IACV,YAAY;IACZ,IAAI,EAAE,iBAAiB,CAAC,UAAU;IAClC,KAAK;IACL,QAAQ;IACR,GAAG,SAAS;CACb,CAAC,CAAC;AAEH,2DAA2D;AAC7C,qDAA8B,GAAG,CAAC,KAAyB,EAAsB,EAAE;IAC/F,MAAM,SAAS,GAAG,yBAAW,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IACzE,MAAM,YAAY,GAAG,yBAAW,CAAC,aAAa,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IACxF,MAAM,WAAW,GAAG,yBAAW,CAAC,aAAa,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IAE/E,OAAO;QACL,SAAS,EAAE,SAAS,KAAK,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,0BAA0B,CAAA,KAAK;QAC5F,KAAK,EAAE,yBAAW,CAAC,iBAAiB,CAAC,SAAS,CAAC;QAC/C,QAAQ,EAAE,yBAAW,CAAC,iBAAiB,CAAC,YAAY,CAAC;QACrD,OAAO,EAAE,yBAAW,CAAC,iBAAiB,CAAC,WAAW,CAAC;QACnD,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,QAAQ,EAAE,SAAS,KAAK,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK;KAChE,CAAC;AACJ,CAAC,CAAC","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 { BackstageActionItem as UIA_BackstageActionItem, BackstageStageLauncher as UIA_BackstageStageLauncher } from \"@itwin/appui-abstract\";\r\nimport { PropsHelper } from \"../utils/PropsHelper\";\r\nimport { BackstageItemProps, BackstageItemState } from \"./BackstageItemProps\";\r\n\r\n/** Used to specify the item type added to the backstage menu.\r\n * @beta\r\n * @deprecated Use [BackstageItemType]($appui-abstract) in bentley/appui-abstract instead\r\n */\r\nexport enum BackstageItemType {\r\n  /** Item that executes an action function */\r\n  ActionItem = 1,\r\n  /** Item that activate a stage. */\r\n  StageLauncher = 2,\r\n}\r\n\r\n/** Describes the data needed to insert an action button into the backstage menu.\r\n * @beta\r\n * @deprecated Use [BackstageActionItem]($appui-abstract) in bentley/appui-abstract instead\r\n */\r\nexport interface BackstageActionItem extends UIA_BackstageActionItem {\r\n  readonly type: BackstageItemType.ActionItem; // eslint-disable-line deprecation/deprecation\r\n}\r\n\r\n/** Describes the data needed to insert an action button into the backstage menu.\r\n * @beta\r\n * @deprecated Use [BackstageStageLauncher]($appui-abstract) in bentley/appui-abstract instead\r\n */\r\nexport interface BackstageStageLauncher extends UIA_BackstageStageLauncher {\r\n  readonly type: BackstageItemType.StageLauncher; // eslint-disable-line deprecation/deprecation\r\n}\r\n\r\n/** Utilities for creating and maintaining backstage items\r\n * @beta @deprecated\r\n */\r\nexport class BackstageItemUtilities {\r\n  /** Creates a stage launcher backstage item\r\n   * @beta\r\n   * @deprecated Use BackstageItemUtilities.createStageLauncher in bentley/appui-abstract instead\r\n   */\r\n  public static createStageLauncher = (frontstageId: string, groupPriority: number, itemPriority: number, label: string, subtitle?: string, iconSpec?: string, overrides?: Partial<BackstageStageLauncher>): BackstageStageLauncher => ({ // eslint-disable-line deprecation/deprecation\r\n    groupPriority,\r\n    icon: iconSpec,\r\n    id: frontstageId,\r\n    itemPriority,\r\n    type: BackstageItemType.StageLauncher, // eslint-disable-line deprecation/deprecation\r\n    label,\r\n    stageId: frontstageId,\r\n    subtitle,\r\n    ...overrides,\r\n  });\r\n\r\n  /** Creates an action backstage item\r\n   * @beta\r\n   * @deprecated Use BackstageItemUtilities.createActionItem in bentley/appui-abstract instead\r\n   */\r\n  public static createActionItem = (itemId: string, groupPriority: number, itemPriority: number, execute: () => void, label: string, subtitle?: string, iconSpec?: string, overrides?: Partial<BackstageActionItem>): BackstageActionItem => ({ // eslint-disable-line deprecation/deprecation\r\n    execute,\r\n    groupPriority,\r\n    icon: iconSpec,\r\n    id: itemId,\r\n    itemPriority,\r\n    type: BackstageItemType.ActionItem, // eslint-disable-line deprecation/deprecation\r\n    label,\r\n    subtitle,\r\n    ...overrides,\r\n  });\r\n\r\n  /** Helper method to set backstage item state from props */\r\n  public static getBackstageItemStateFromProps = (props: BackstageItemProps): BackstageItemState => { // eslint-disable-line deprecation/deprecation\r\n    const labelSpec = PropsHelper.getStringSpec(props.label, props.labelKey);\r\n    const subtitleSpec = PropsHelper.getStringSpec(props.description, props.descriptionKey);\r\n    const tooltipSpec = PropsHelper.getStringSpec(props.tooltip, props.tooltipKey);\r\n\r\n    return {\r\n      isEnabled: undefined !== props.isEnabled ? props.isEnabled : /* istanbul ignore next */false,\r\n      label: PropsHelper.getStringFromSpec(labelSpec),\r\n      subtitle: PropsHelper.getStringFromSpec(subtitleSpec),\r\n      tooltip: PropsHelper.getStringFromSpec(tooltipSpec),\r\n      iconSpec: props.iconSpec,\r\n      isActive: undefined !== props.isActive ? props.isActive : false,\r\n    };\r\n  };\r\n}\r\n"]}
+{"version":3,"file":"BackstageItemUtilities.js","sourceRoot":"","sources":["../../../../src/appui-react/backstage/BackstageItemUtilities.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAGH,sDAAmD;AAGnD;;;GAGG;AACH,IAAY,iBAKX;AALD,WAAY,iBAAiB;IAC3B,4CAA4C;IAC5C,qEAAc,CAAA;IACd,kCAAkC;IAClC,2EAAiB,CAAA;AACnB,CAAC,EALW,iBAAiB,GAAjB,yBAAiB,KAAjB,yBAAiB,QAK5B;AAkBD;;GAEG;AACH,MAAa,sBAAsB;;AAAnC,wDAgDC;AA/CC;;;GAGG;AACW,0CAAmB,GAAG,CAAC,YAAoB,EAAE,aAAqB,EAAE,YAAoB,EAAE,KAAa,EAAE,QAAiB,EAAE,QAAiB,EAAE,SAA2C,EAA0B,EAAE,CAAC,CAAC;IACpO,aAAa;IACb,IAAI,EAAE,QAAQ;IACd,EAAE,EAAE,YAAY;IAChB,YAAY;IACZ,IAAI,EAAE,iBAAiB,CAAC,aAAa;IACrC,KAAK;IACL,OAAO,EAAE,YAAY;IACrB,QAAQ;IACR,GAAG,SAAS;CACb,CAAC,CAAC;AAEH;;;GAGG;AACW,uCAAgB,GAAG,CAAC,MAAc,EAAE,aAAqB,EAAE,YAAoB,EAAE,OAAmB,EAAE,KAAa,EAAE,QAAiB,EAAE,QAAiB,EAAE,SAAwC,EAAuB,EAAE,CAAC,CAAC;IAC1O,OAAO;IACP,aAAa;IACb,IAAI,EAAE,QAAQ;IACd,EAAE,EAAE,MAAM;IACV,YAAY;IACZ,IAAI,EAAE,iBAAiB,CAAC,UAAU;IAClC,KAAK;IACL,QAAQ;IACR,GAAG,SAAS;CACb,CAAC,CAAC;AAEH,2DAA2D;AAC7C,qDAA8B,GAAG,CAAC,KAAyB,EAAsB,EAAE;IAC/F,MAAM,SAAS,GAAG,yBAAW,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IACzE,MAAM,YAAY,GAAG,yBAAW,CAAC,aAAa,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IACxF,MAAM,WAAW,GAAG,yBAAW,CAAC,aAAa,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IAE/E,OAAO;QACL,SAAS,EAAE,SAAS,KAAK,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,0BAA0B,CAAA,KAAK;QAC5F,KAAK,EAAE,yBAAW,CAAC,iBAAiB,CAAC,SAAS,CAAC;QAC/C,QAAQ,EAAE,yBAAW,CAAC,iBAAiB,CAAC,YAAY,CAAC;QACrD,OAAO,EAAE,yBAAW,CAAC,iBAAiB,CAAC,WAAW,CAAC;QACnD,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,QAAQ,EAAE,SAAS,KAAK,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK;KAChE,CAAC;AACJ,CAAC,CAAC","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 { BackstageActionItem as UIA_BackstageActionItem, BackstageStageLauncher as UIA_BackstageStageLauncher } from \"@itwin/appui-abstract\";\r\nimport { PropsHelper } from \"../utils/PropsHelper\";\r\nimport { BackstageItemProps, BackstageItemState } from \"./BackstageItemProps\";\r\n\r\n/** Used to specify the item type added to the backstage menu.\r\n * @beta\r\n * @deprecated Use [BackstageItemType]($appui-abstract) instead\r\n */\r\nexport enum BackstageItemType {\r\n  /** Item that executes an action function */\r\n  ActionItem = 1,\r\n  /** Item that activate a stage. */\r\n  StageLauncher = 2,\r\n}\r\n\r\n/** Describes the data needed to insert an action button into the backstage menu.\r\n * @beta\r\n * @deprecated Use [BackstageActionItem]($appui-abstract) instead\r\n */\r\nexport interface BackstageActionItem extends UIA_BackstageActionItem {\r\n  readonly type: BackstageItemType.ActionItem; // eslint-disable-line deprecation/deprecation\r\n}\r\n\r\n/** Describes the data needed to insert an action button into the backstage menu.\r\n * @beta\r\n * @deprecated Use [BackstageStageLauncher]($appui-abstract) instead\r\n */\r\nexport interface BackstageStageLauncher extends UIA_BackstageStageLauncher {\r\n  readonly type: BackstageItemType.StageLauncher; // eslint-disable-line deprecation/deprecation\r\n}\r\n\r\n/** Utilities for creating and maintaining backstage items\r\n * @beta @deprecated\r\n */\r\nexport class BackstageItemUtilities {\r\n  /** Creates a stage launcher backstage item\r\n   * @beta\r\n   * @deprecated Use [BackstageItemUtilities.createStageLauncher]($appui-abstract) instead\r\n   */\r\n  public static createStageLauncher = (frontstageId: string, groupPriority: number, itemPriority: number, label: string, subtitle?: string, iconSpec?: string, overrides?: Partial<BackstageStageLauncher>): BackstageStageLauncher => ({ // eslint-disable-line deprecation/deprecation\r\n    groupPriority,\r\n    icon: iconSpec,\r\n    id: frontstageId,\r\n    itemPriority,\r\n    type: BackstageItemType.StageLauncher, // eslint-disable-line deprecation/deprecation\r\n    label,\r\n    stageId: frontstageId,\r\n    subtitle,\r\n    ...overrides,\r\n  });\r\n\r\n  /** Creates an action backstage item\r\n   * @beta\r\n   * @deprecated Use [BackstageItemUtilities.createActionItem]($appui-abstract) instead\r\n   */\r\n  public static createActionItem = (itemId: string, groupPriority: number, itemPriority: number, execute: () => void, label: string, subtitle?: string, iconSpec?: string, overrides?: Partial<BackstageActionItem>): BackstageActionItem => ({ // eslint-disable-line deprecation/deprecation\r\n    execute,\r\n    groupPriority,\r\n    icon: iconSpec,\r\n    id: itemId,\r\n    itemPriority,\r\n    type: BackstageItemType.ActionItem, // eslint-disable-line deprecation/deprecation\r\n    label,\r\n    subtitle,\r\n    ...overrides,\r\n  });\r\n\r\n  /** Helper method to set backstage item state from props */\r\n  public static getBackstageItemStateFromProps = (props: BackstageItemProps): BackstageItemState => { // eslint-disable-line deprecation/deprecation\r\n    const labelSpec = PropsHelper.getStringSpec(props.label, props.labelKey);\r\n    const subtitleSpec = PropsHelper.getStringSpec(props.description, props.descriptionKey);\r\n    const tooltipSpec = PropsHelper.getStringSpec(props.tooltip, props.tooltipKey);\r\n\r\n    return {\r\n      isEnabled: undefined !== props.isEnabled ? props.isEnabled : /* istanbul ignore next */false,\r\n      label: PropsHelper.getStringFromSpec(labelSpec),\r\n      subtitle: PropsHelper.getStringFromSpec(subtitleSpec),\r\n      tooltip: PropsHelper.getStringFromSpec(tooltipSpec),\r\n      iconSpec: props.iconSpec,\r\n      isActive: undefined !== props.isActive ? props.isActive : false,\r\n    };\r\n  };\r\n}\r\n"]}

package/lib/cjs/appui-react/backstage/CommandLaunch.d.ts

@@ -6,6 +6,7 @@ import { CommandHandler } from "@itwin/appui-abstract";
 import { BackstageItemProps, BackstageItemState } from "./BackstageItemProps";
 /** Properties for a [[CommandLaunchBackstageItem]] component
  * @public
+ * @deprecated Use [BackstageActionItem]($appui-abstract) instead.
  */
 export interface CommandLaunchBackstageItemProps extends BackstageItemProps, CommandHandler {
     /** Unique Id for this backstage item. */
@@ -13,6 +14,7 @@ export interface CommandLaunchBackstageItemProps extends BackstageItemProps, Com
 }
 /** Backstage item that launches a Command
  * @public
+ * @deprecated Use [BackstageActionItem]($appui-abstract) instead.
  */
 export declare class CommandLaunchBackstageItem extends React.PureComponent<CommandLaunchBackstageItemProps, BackstageItemState> {
     /** @internal */

package/lib/cjs/appui-react/backstage/CommandLaunch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CommandLaunch.d.ts","sourceRoot":"","sources":["../../../../src/appui-react/backstage/CommandLaunch.tsx"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAOvD,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAQ9E;;GAEG;AACH,MAAM,WAAW,+BAAgC,SAAQ,kBAAkB,EAAE,cAAc;IACzF,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,qBAAa,0BAA2B,SAAQ,KAAK,CAAC,aAAa,CAAC,+BAA+B,EAAE,kBAAkB,CAAC;IAEtH,gBAAgB;IAChB,SAAyB,KAAK,EAAE,QAAQ,CAAC,kBAAkB,CAAC,CAAC;IAC7D,OAAO,CAAC,oBAAoB,CAAS;IACrC,OAAO,CAAC,aAAa,CAAgB;gBAEzB,KAAK,EAAE,+BAA+B;IAUlC,iBAAiB;IAKjB,oBAAoB;IAOpC,OAAO,CAAC,kBAAkB,CAexB;IAEK,OAAO,QAAO,IAAI,CAUvB;IAIc,kBAAkB,CAAC,UAAU,EAAE,+BAA+B;IAQ9D,MAAM,IAAI,KAAK,CAAC,SAAS;CAa1C"}
+{"version":3,"file":"CommandLaunch.d.ts","sourceRoot":"","sources":["../../../../src/appui-react/backstage/CommandLaunch.tsx"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAE,cAAc,EAAmB,MAAM,uBAAuB,CAAC;AAOxE,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAQ9E;;;GAGG;AACH,MAAM,WAAW,+BAAgC,SAAQ,kBAAkB,EAAE,cAAc;IACzF,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,qBAAa,0BAA2B,SAAQ,KAAK,CAAC,aAAa,CAAC,+BAA+B,EAAE,kBAAkB,CAAC;IAEtH,gBAAgB;IAChB,SAAyB,KAAK,EAAE,QAAQ,CAAC,kBAAkB,CAAC,CAAC;IAC7D,OAAO,CAAC,oBAAoB,CAAS;IACrC,OAAO,CAAC,aAAa,CAAgB;gBAEzB,KAAK,EAAE,+BAA+B;IAUlC,iBAAiB;IAKjB,oBAAoB;IAOpC,OAAO,CAAC,kBAAkB,CAexB;IAEK,OAAO,QAAO,IAAI,CAUvB;IAIc,kBAAkB,CAAC,UAAU,EAAE,+BAA+B;IAQ9D,MAAM,IAAI,KAAK,CAAC,SAAS;CAa1C"}

package/lib/cjs/appui-react/backstage/CommandLaunch.js

@@ -22,6 +22,7 @@ const BackstageItemUtilities_1 = require("./BackstageItemUtilities");
 const BackstageItem = (0, SafeAreaContext_1.withSafeArea)(appui_layout_react_1.BackstageItem);
 /** Backstage item that launches a Command
  * @public
+ * @deprecated Use [BackstageActionItem]($appui-abstract) instead.
  */
 class CommandLaunchBackstageItem extends React.PureComponent {
     constructor(props) {

package/lib/cjs/appui-react/backstage/CommandLaunch.js.map

@@ -1 +1 @@
-{"version":3,"file":"CommandLaunch.js","sourceRoot":"","sources":["../../../../src/appui-react/backstage/CommandLaunch.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 { Logger } from \"@itwin/core-bentley\";\r\nimport { CommandHandler } from \"@itwin/appui-abstract\";\r\nimport { BackstageItem as NZ_BackstageItem } from \"@itwin/appui-layout-react\";\r\nimport { withSafeArea } from \"../safearea/SafeAreaContext\";\r\nimport { SyncUiEventArgs, SyncUiEventDispatcher } from \"../syncui/SyncUiEventDispatcher\";\r\nimport { UiFramework } from \"../UiFramework\";\r\nimport { PropsHelper } from \"../utils/PropsHelper\";\r\nimport { Backstage } from \"./Backstage\";\r\nimport { BackstageItemProps, BackstageItemState } from \"./BackstageItemProps\";\r\nimport { BackstageItemUtilities } from \"./BackstageItemUtilities\";\r\n\r\n// cspell:ignore safearea\r\n\r\n// eslint-disable-next-line @typescript-eslint/naming-convention\r\nconst BackstageItem = withSafeArea(NZ_BackstageItem);\r\n\r\n/** Properties for a [[CommandLaunchBackstageItem]] component\r\n * @public\r\n */\r\nexport interface CommandLaunchBackstageItemProps extends BackstageItemProps, CommandHandler { // eslint-disable-line deprecation/deprecation\r\n  /** Unique Id for this backstage item. */\r\n  commandId: string;\r\n}\r\n\r\n/** Backstage item that launches a Command\r\n * @public\r\n */\r\nexport class CommandLaunchBackstageItem extends React.PureComponent<CommandLaunchBackstageItemProps, BackstageItemState> { // eslint-disable-line deprecation/deprecation\r\n\r\n  /** @internal */\r\n  public override readonly state: Readonly<BackstageItemState>; // eslint-disable-line deprecation/deprecation\r\n  private _componentUnmounting = false;  // used to ensure _handleSyncUiEvent callback is not processed after componentWillUnmount is called\r\n  private _stateSyncIds: string[] = [];  // local version of syncId that are lower cased\r\n\r\n  constructor(props: CommandLaunchBackstageItemProps) {\r\n    super(props);\r\n\r\n    if (props.stateSyncIds)\r\n      this._stateSyncIds = props.stateSyncIds.map((value) => value.toLowerCase());\r\n\r\n    // eslint-disable-next-line deprecation/deprecation\r\n    this.state = BackstageItemUtilities.getBackstageItemStateFromProps(props);\r\n  }\r\n\r\n  public override componentDidMount() {\r\n    if (this.props.stateFunc && this._stateSyncIds.length > 0)\r\n      SyncUiEventDispatcher.onSyncUiEvent.addListener(this._handleSyncUiEvent);\r\n  }\r\n\r\n  public override componentWillUnmount() {\r\n    this._componentUnmounting = true;\r\n    /* istanbul ignore else */\r\n    if (this.props.stateFunc && this._stateSyncIds.length > 0)\r\n      SyncUiEventDispatcher.onSyncUiEvent.removeListener(this._handleSyncUiEvent);\r\n  }\r\n\r\n  private _handleSyncUiEvent = (args: SyncUiEventArgs): void => {\r\n    /* istanbul ignore next */\r\n    if (this._componentUnmounting)\r\n      return;\r\n\r\n    /* istanbul ignore else */\r\n    if (SyncUiEventDispatcher.hasEventOfInterest(args.eventIds, this._stateSyncIds)) {\r\n      /* istanbul ignore else */\r\n      if (this.props.stateFunc) {\r\n        const newState = this.props.stateFunc(this.state);\r\n        /* istanbul ignore next */\r\n        if (!PropsHelper.isShallowEqual(newState, this.state))\r\n          this.setState((_prevState) => newState);\r\n      }\r\n    }\r\n  };\r\n\r\n  public execute = (): void => {\r\n    Backstage.hide(); // eslint-disable-line deprecation/deprecation\r\n\r\n    if (this.props.execute) {\r\n      if (this.props.getCommandArgs)\r\n        this.props.execute(this.props.getCommandArgs());\r\n      else\r\n        this.props.execute(this.props.parameters);\r\n    } else\r\n      Logger.logError(UiFramework.loggerCategory(this), `'${this.props.commandId}' has no execute() function`);\r\n  };\r\n\r\n  // deprecated class\r\n  // istanbul ignore next\r\n  public override componentDidUpdate(_prevProps: CommandLaunchBackstageItemProps) {\r\n    // eslint-disable-next-line deprecation/deprecation\r\n    const updatedState = BackstageItemUtilities.getBackstageItemStateFromProps(this.props);\r\n    if (!PropsHelper.isShallowEqual(updatedState, this.state))\r\n      this.setState((_prevState) => updatedState);\r\n  }\r\n\r\n  // TODO: add tooltip, subtitle, aria-label? to NZ_BackstageItem\r\n  public override render(): React.ReactNode {\r\n    return (\r\n      <BackstageItem\r\n        icon={PropsHelper.getIcon(this.state.iconSpec)}\r\n        isActive={this.state.isActive}\r\n        isDisabled={!this.state.isEnabled}\r\n        key={this.props.commandId}\r\n        onClick={this.execute}\r\n      >\r\n        {this.state.label}\r\n      </BackstageItem>\r\n    );\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"CommandLaunch.js","sourceRoot":"","sources":["../../../../src/appui-react/backstage/CommandLaunch.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 { Logger } from \"@itwin/core-bentley\";\r\nimport { CommandHandler, UiSyncEventArgs } from \"@itwin/appui-abstract\";\r\nimport { BackstageItem as NZ_BackstageItem } from \"@itwin/appui-layout-react\";\r\nimport { withSafeArea } from \"../safearea/SafeAreaContext\";\r\nimport { SyncUiEventDispatcher } from \"../syncui/SyncUiEventDispatcher\";\r\nimport { UiFramework } from \"../UiFramework\";\r\nimport { PropsHelper } from \"../utils/PropsHelper\";\r\nimport { Backstage } from \"./Backstage\";\r\nimport { BackstageItemProps, BackstageItemState } from \"./BackstageItemProps\";\r\nimport { BackstageItemUtilities } from \"./BackstageItemUtilities\";\r\n\r\n// cspell:ignore safearea\r\n\r\n// eslint-disable-next-line @typescript-eslint/naming-convention\r\nconst BackstageItem = withSafeArea(NZ_BackstageItem);\r\n\r\n/** Properties for a [[CommandLaunchBackstageItem]] component\r\n * @public\r\n * @deprecated Use [BackstageActionItem]($appui-abstract) instead.\r\n */\r\nexport interface CommandLaunchBackstageItemProps extends BackstageItemProps, CommandHandler { // eslint-disable-line deprecation/deprecation\r\n  /** Unique Id for this backstage item. */\r\n  commandId: string;\r\n}\r\n\r\n/** Backstage item that launches a Command\r\n * @public\r\n * @deprecated Use [BackstageActionItem]($appui-abstract) instead.\r\n */\r\nexport class CommandLaunchBackstageItem extends React.PureComponent<CommandLaunchBackstageItemProps, BackstageItemState> { // eslint-disable-line deprecation/deprecation\r\n\r\n  /** @internal */\r\n  public override readonly state: Readonly<BackstageItemState>; // eslint-disable-line deprecation/deprecation\r\n  private _componentUnmounting = false;  // used to ensure _handleSyncUiEvent callback is not processed after componentWillUnmount is called\r\n  private _stateSyncIds: string[] = [];  // local version of syncId that are lower cased\r\n\r\n  constructor(props: CommandLaunchBackstageItemProps) { // eslint-disable-line deprecation/deprecation\r\n    super(props);\r\n\r\n    if (props.stateSyncIds)\r\n      this._stateSyncIds = props.stateSyncIds.map((value) => value.toLowerCase());\r\n\r\n    // eslint-disable-next-line deprecation/deprecation\r\n    this.state = BackstageItemUtilities.getBackstageItemStateFromProps(props);\r\n  }\r\n\r\n  public override componentDidMount() {\r\n    if (this.props.stateFunc && this._stateSyncIds.length > 0)\r\n      SyncUiEventDispatcher.onSyncUiEvent.addListener(this._handleSyncUiEvent);\r\n  }\r\n\r\n  public override componentWillUnmount() {\r\n    this._componentUnmounting = true;\r\n    /* istanbul ignore else */\r\n    if (this.props.stateFunc && this._stateSyncIds.length > 0)\r\n      SyncUiEventDispatcher.onSyncUiEvent.removeListener(this._handleSyncUiEvent);\r\n  }\r\n\r\n  private _handleSyncUiEvent = (args: UiSyncEventArgs): void => {\r\n    /* istanbul ignore next */\r\n    if (this._componentUnmounting)\r\n      return;\r\n\r\n    /* istanbul ignore else */\r\n    if (SyncUiEventDispatcher.hasEventOfInterest(args.eventIds, this._stateSyncIds)) {\r\n      /* istanbul ignore else */\r\n      if (this.props.stateFunc) {\r\n        const newState = this.props.stateFunc(this.state);\r\n        /* istanbul ignore next */\r\n        if (!PropsHelper.isShallowEqual(newState, this.state))\r\n          this.setState((_prevState) => newState);\r\n      }\r\n    }\r\n  };\r\n\r\n  public execute = (): void => {\r\n    Backstage.hide(); // eslint-disable-line deprecation/deprecation\r\n\r\n    if (this.props.execute) {\r\n      if (this.props.getCommandArgs)\r\n        this.props.execute(this.props.getCommandArgs());\r\n      else\r\n        this.props.execute(this.props.parameters);\r\n    } else\r\n      Logger.logError(UiFramework.loggerCategory(this), `'${this.props.commandId}' has no execute() function`);\r\n  };\r\n\r\n  // deprecated class\r\n  // istanbul ignore next\r\n  public override componentDidUpdate(_prevProps: CommandLaunchBackstageItemProps) { // eslint-disable-line deprecation/deprecation\r\n    // eslint-disable-next-line deprecation/deprecation\r\n    const updatedState = BackstageItemUtilities.getBackstageItemStateFromProps(this.props);\r\n    if (!PropsHelper.isShallowEqual(updatedState, this.state))\r\n      this.setState((_prevState) => updatedState);\r\n  }\r\n\r\n  // TODO: add tooltip, subtitle, aria-label? to NZ_BackstageItem\r\n  public override render(): React.ReactNode {\r\n    return (\r\n      <BackstageItem\r\n        icon={PropsHelper.getIcon(this.state.iconSpec)}\r\n        isActive={this.state.isActive}\r\n        isDisabled={!this.state.isEnabled}\r\n        key={this.props.commandId}\r\n        onClick={this.execute}\r\n      >\r\n        {this.state.label}\r\n      </BackstageItem>\r\n    );\r\n  }\r\n}\r\n"]}

package/lib/cjs/appui-react/backstage/FrontstageLaunch.d.ts

@@ -5,6 +5,7 @@ import * as React from "react";
 import { BackstageItemProps, BackstageItemState } from "./BackstageItemProps";
 /** Properties for a [[FrontstageLaunchBackstageItem]] component
  * @public
+ * @deprecated Use [BackstageStageLauncher]($appui-abstract) instead.
  */
 export interface FrontstageLaunchBackstageItemProps extends BackstageItemProps {
     /** id of the frontstage */
@@ -12,12 +13,15 @@ export interface FrontstageLaunchBackstageItemProps extends BackstageItemProps {
 }
 /** Backstage item that activates a Frontstage
  * @public
+ * @deprecated Use [BackstageStageLauncher]($appui-abstract) instead.
  */
 export declare class FrontstageLaunchBackstageItem extends React.PureComponent<FrontstageLaunchBackstageItemProps, BackstageItemState> {
     /** @internal */
     readonly state: Readonly<BackstageItemState>;
     private _componentUnmounting;
     private _stateSyncIds;
+    private _removeSyncUiEventListener?;
+    private _removeFrontstageActivatedEventListener?;
     constructor(props: FrontstageLaunchBackstageItemProps);
     componentDidMount(): void;
     componentWillUnmount(): void;

package/lib/cjs/appui-react/backstage/FrontstageLaunch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FrontstageLaunch.d.ts","sourceRoot":"","sources":["../../../../src/appui-react/backstage/FrontstageLaunch.tsx"],"names":[],"mappings":"AAKA;;GAEG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAS/B,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAQ9E;;GAEG;AACH,MAAM,WAAW,kCAAmC,SAAQ,kBAAkB;IAC5E,2BAA2B;IAC3B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,qBAAa,6BAA8B,SAAQ,KAAK,CAAC,aAAa,CAAC,kCAAkC,EAAE,kBAAkB,CAAC;IAC5H,gBAAgB;IAChB,SAAyB,KAAK,EAAE,QAAQ,CAAC,kBAAkB,CAAC,CAAC;IAC7D,OAAO,CAAC,oBAAoB,CAAS;IACrC,OAAO,CAAC,aAAa,CAAgB;gBAEzB,KAAK,EAAE,kCAAkC;IAarC,iBAAiB;IAMjB,oBAAoB;IAQpC,OAAO,CAAC,kBAAkB,CAexB;IAEK,OAAO,sBAQZ;IAEc,kBAAkB,CAAC,UAAU,EAAE,kCAAkC;IAOjF,OAAO,CAAC,+BAA+B,CAKrC;IAGc,MAAM,IAAI,KAAK,CAAC,SAAS;CAc1C"}
+{"version":3,"file":"FrontstageLaunch.d.ts","sourceRoot":"","sources":["../../../../src/appui-react/backstage/FrontstageLaunch.tsx"],"names":[],"mappings":"AAKA;;GAEG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAS/B,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAQ9E;;;GAGG;AACH,MAAM,WAAW,kCAAmC,SAAQ,kBAAkB;IAC5E,2BAA2B;IAC3B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,qBAAa,6BAA8B,SAAQ,KAAK,CAAC,aAAa,CAAC,kCAAkC,EAAE,kBAAkB,CAAC;IAC5H,gBAAgB;IAChB,SAAyB,KAAK,EAAE,QAAQ,CAAC,kBAAkB,CAAC,CAAC;IAC7D,OAAO,CAAC,oBAAoB,CAAS;IACrC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,0BAA0B,CAAC,CAAa;IAChD,OAAO,CAAC,uCAAuC,CAAC,CAAa;gBACjD,KAAK,EAAE,kCAAkC;IAarC,iBAAiB;IAMjB,oBAAoB;IAMpC,OAAO,CAAC,kBAAkB,CAexB;IAEK,OAAO,sBAQZ;IAEc,kBAAkB,CAAC,UAAU,EAAE,kCAAkC;IAOjF,OAAO,CAAC,+BAA+B,CAKrC;IAGc,MAAM,IAAI,KAAK,CAAC,SAAS;CAc1C"}

package/lib/cjs/appui-react/backstage/FrontstageLaunch.js

@@ -24,6 +24,7 @@ const BackstageItemUtilities_1 = require("./BackstageItemUtilities");
 const BackstageItem = (0, SafeAreaContext_1.withSafeArea)(appui_layout_react_1.BackstageItem);
 /** Backstage item that activates a Frontstage
  * @public
+ * @deprecated Use [BackstageStageLauncher]($appui-abstract) instead.
  */
 class FrontstageLaunchBackstageItem extends React.PureComponent {
     constructor(props) {
@@ -69,15 +70,13 @@ class FrontstageLaunchBackstageItem extends React.PureComponent {
     }
     componentDidMount() {
         if (this.props.stateFunc && this._stateSyncIds.length > 0)
-            SyncUiEventDispatcher_1.SyncUiEventDispatcher.onSyncUiEvent.addListener(this._handleSyncUiEvent);
-        FrontstageManager_1.FrontstageManager.onFrontstageActivatedEvent.addListener(this._handleFrontstageActivatedEvent);
+            this._removeSyncUiEventListener = SyncUiEventDispatcher_1.SyncUiEventDispatcher.onSyncUiEvent.addListener(this._handleSyncUiEvent);
+        this._removeFrontstageActivatedEventListener = FrontstageManager_1.FrontstageManager.onFrontstageActivatedEvent.addListener(this._handleFrontstageActivatedEvent);
     }
     componentWillUnmount() {
         this._componentUnmounting = true;
-        /* istanbul ignore else */
-        if (this.props.stateFunc && this._stateSyncIds.length > 0)
-            SyncUiEventDispatcher_1.SyncUiEventDispatcher.onSyncUiEvent.removeListener(this._handleSyncUiEvent);
-        FrontstageManager_1.FrontstageManager.onFrontstageActivatedEvent.removeListener(this._handleFrontstageActivatedEvent);
+        this._removeSyncUiEventListener && this._removeSyncUiEventListener();
+        this._removeFrontstageActivatedEventListener && this._removeFrontstageActivatedEventListener();
     }
     componentDidUpdate(_prevProps) {
         const updatedState = BackstageItemUtilities_1.BackstageItemUtilities.getBackstageItemStateFromProps(this.props);

package/lib/cjs/appui-react/backstage/FrontstageLaunch.js.map

@@ -1 +1 @@
-{"version":3,"file":"FrontstageLaunch.js","sourceRoot":"","sources":["../../../../src/appui-react/backstage/FrontstageLaunch.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/* eslint-disable deprecation/deprecation */\r\n/** @packageDocumentation\r\n * @module Backstage\r\n */\r\n\r\nimport * as React from \"react\";\r\nimport { Logger } from \"@itwin/core-bentley\";\r\nimport { BackstageItem as NZ_BackstageItem } from \"@itwin/appui-layout-react\";\r\nimport { FrontstageActivatedEventArgs, FrontstageManager } from \"../frontstage/FrontstageManager\";\r\nimport { withSafeArea } from \"../safearea/SafeAreaContext\";\r\nimport { SyncUiEventArgs, SyncUiEventDispatcher } from \"../syncui/SyncUiEventDispatcher\";\r\nimport { UiFramework } from \"../UiFramework\";\r\nimport { PropsHelper } from \"../utils/PropsHelper\";\r\nimport { Backstage } from \"./Backstage\";\r\nimport { BackstageItemProps, BackstageItemState } from \"./BackstageItemProps\";\r\nimport { BackstageItemUtilities } from \"./BackstageItemUtilities\";\r\n\r\n// cspell:ignore safearea\r\n\r\n// eslint-disable-next-line @typescript-eslint/naming-convention\r\nconst BackstageItem = withSafeArea(NZ_BackstageItem);\r\n\r\n/** Properties for a [[FrontstageLaunchBackstageItem]] component\r\n * @public\r\n */\r\nexport interface FrontstageLaunchBackstageItemProps extends BackstageItemProps { // eslint-disable-line deprecation/deprecation\r\n  /** id of the frontstage */\r\n  frontstageId: string;\r\n}\r\n\r\n/** Backstage item that activates a Frontstage\r\n * @public\r\n */\r\nexport class FrontstageLaunchBackstageItem extends React.PureComponent<FrontstageLaunchBackstageItemProps, BackstageItemState> { // eslint-disable-line deprecation/deprecation\r\n  /** @internal */\r\n  public override readonly state: Readonly<BackstageItemState>; // eslint-disable-line deprecation/deprecation\r\n  private _componentUnmounting = false;  // used to ensure _handleSyncUiEvent callback is not processed after componentWillUnmount is called\r\n  private _stateSyncIds: string[] = [];  // local version of syncId that are lower cased\r\n\r\n  constructor(props: FrontstageLaunchBackstageItemProps) {\r\n    super(props);\r\n\r\n    if (props.stateSyncIds)\r\n      this._stateSyncIds = props.stateSyncIds.map((value) => value.toLowerCase());\r\n\r\n    const state = BackstageItemUtilities.getBackstageItemStateFromProps(props);\r\n    /* istanbul ignore else */\r\n    if (this.props.isActive === undefined)\r\n      state.isActive = FrontstageManager.activeFrontstageId === this.props.frontstageId;\r\n    this.state = state;\r\n  }\r\n\r\n  public override componentDidMount() {\r\n    if (this.props.stateFunc && this._stateSyncIds.length > 0)\r\n      SyncUiEventDispatcher.onSyncUiEvent.addListener(this._handleSyncUiEvent);\r\n    FrontstageManager.onFrontstageActivatedEvent.addListener(this._handleFrontstageActivatedEvent);\r\n  }\r\n\r\n  public override componentWillUnmount() {\r\n    this._componentUnmounting = true;\r\n    /* istanbul ignore else */\r\n    if (this.props.stateFunc && this._stateSyncIds.length > 0)\r\n      SyncUiEventDispatcher.onSyncUiEvent.removeListener(this._handleSyncUiEvent);\r\n    FrontstageManager.onFrontstageActivatedEvent.removeListener(this._handleFrontstageActivatedEvent);\r\n  }\r\n\r\n  private _handleSyncUiEvent = (args: SyncUiEventArgs): void => {\r\n    /* istanbul ignore next */\r\n    if (this._componentUnmounting)\r\n      return;\r\n\r\n    /* istanbul ignore else */\r\n    if (SyncUiEventDispatcher.hasEventOfInterest(args.eventIds, this._stateSyncIds)) {\r\n      /* istanbul ignore else */\r\n      if (this.props.stateFunc) {\r\n        const newState = this.props.stateFunc(this.state);\r\n        /* istanbul ignore else */\r\n        if (!PropsHelper.isShallowEqual(newState, this.state))\r\n          this.setState((_prevState) => newState);\r\n      }\r\n    }\r\n  };\r\n\r\n  public execute = async () => {\r\n    Backstage.hide(); // eslint-disable-line deprecation/deprecation\r\n\r\n    const frontstageDef = await FrontstageManager.getFrontstageDef(this.props.frontstageId);\r\n    if (frontstageDef)\r\n      await FrontstageManager.setActiveFrontstageDef(frontstageDef);\r\n    else\r\n      Logger.logError(UiFramework.loggerCategory(this), `Frontstage with id '${this.props.frontstageId}' not found`);\r\n  };\r\n\r\n  public override componentDidUpdate(_prevProps: FrontstageLaunchBackstageItemProps) {\r\n    const updatedState = BackstageItemUtilities.getBackstageItemStateFromProps(this.props);\r\n    updatedState.isActive = FrontstageManager.activeFrontstageId === this.props.frontstageId;\r\n    if (!PropsHelper.isShallowEqual(updatedState, this.state))\r\n      this.setState((_prevState) => updatedState);\r\n  }\r\n\r\n  private _handleFrontstageActivatedEvent = (args: FrontstageActivatedEventArgs) => {\r\n    const isActive = args.activatedFrontstageDef.id === this.props.frontstageId;\r\n    /* istanbul ignore else */\r\n    if (isActive !== this.state.isActive)\r\n      this.setState({ isActive });\r\n  };\r\n\r\n  // TODO: add tooltip, aria-label? to NZ_BackstageItem\r\n  public override render(): React.ReactNode {\r\n    return (\r\n      <BackstageItem\r\n        icon={PropsHelper.getIcon(this.state.iconSpec)}\r\n        isActive={this.state.isActive}\r\n        isDisabled={!this.state.isEnabled}\r\n        key={this.props.frontstageId}\r\n        onClick={this.execute}\r\n        subtitle={this.state.subtitle}\r\n      >\r\n        {this.state.label}\r\n      </BackstageItem>\r\n    );\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"FrontstageLaunch.js","sourceRoot":"","sources":["../../../../src/appui-react/backstage/FrontstageLaunch.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/* eslint-disable deprecation/deprecation */\r\n/** @packageDocumentation\r\n * @module Backstage\r\n */\r\n\r\nimport * as React from \"react\";\r\nimport { Logger } from \"@itwin/core-bentley\";\r\nimport { BackstageItem as NZ_BackstageItem } from \"@itwin/appui-layout-react\";\r\nimport { FrontstageActivatedEventArgs, FrontstageManager } from \"../frontstage/FrontstageManager\";\r\nimport { withSafeArea } from \"../safearea/SafeAreaContext\";\r\nimport { SyncUiEventArgs, SyncUiEventDispatcher } from \"../syncui/SyncUiEventDispatcher\";\r\nimport { UiFramework } from \"../UiFramework\";\r\nimport { PropsHelper } from \"../utils/PropsHelper\";\r\nimport { Backstage } from \"./Backstage\";\r\nimport { BackstageItemProps, BackstageItemState } from \"./BackstageItemProps\";\r\nimport { BackstageItemUtilities } from \"./BackstageItemUtilities\";\r\n\r\n// cspell:ignore safearea\r\n\r\n// eslint-disable-next-line @typescript-eslint/naming-convention\r\nconst BackstageItem = withSafeArea(NZ_BackstageItem);\r\n\r\n/** Properties for a [[FrontstageLaunchBackstageItem]] component\r\n * @public\r\n * @deprecated Use [BackstageStageLauncher]($appui-abstract) instead.\r\n */\r\nexport interface FrontstageLaunchBackstageItemProps extends BackstageItemProps { // eslint-disable-line deprecation/deprecation\r\n  /** id of the frontstage */\r\n  frontstageId: string;\r\n}\r\n\r\n/** Backstage item that activates a Frontstage\r\n * @public\r\n * @deprecated Use [BackstageStageLauncher]($appui-abstract) instead.\r\n */\r\nexport class FrontstageLaunchBackstageItem extends React.PureComponent<FrontstageLaunchBackstageItemProps, BackstageItemState> { // eslint-disable-line deprecation/deprecation\r\n  /** @internal */\r\n  public override readonly state: Readonly<BackstageItemState>; // eslint-disable-line deprecation/deprecation\r\n  private _componentUnmounting = false;  // used to ensure _handleSyncUiEvent callback is not processed after componentWillUnmount is called\r\n  private _stateSyncIds: string[] = [];  // local version of syncId that are lower cased\r\n  private _removeSyncUiEventListener?: () => void;\r\n  private _removeFrontstageActivatedEventListener?: () => void;\r\n  constructor(props: FrontstageLaunchBackstageItemProps) {\r\n    super(props);\r\n\r\n    if (props.stateSyncIds)\r\n      this._stateSyncIds = props.stateSyncIds.map((value) => value.toLowerCase());\r\n\r\n    const state = BackstageItemUtilities.getBackstageItemStateFromProps(props);\r\n    /* istanbul ignore else */\r\n    if (this.props.isActive === undefined)\r\n      state.isActive = FrontstageManager.activeFrontstageId === this.props.frontstageId;\r\n    this.state = state;\r\n  }\r\n\r\n  public override componentDidMount() {\r\n    if (this.props.stateFunc && this._stateSyncIds.length > 0)\r\n      this._removeSyncUiEventListener = SyncUiEventDispatcher.onSyncUiEvent.addListener(this._handleSyncUiEvent);\r\n    this._removeFrontstageActivatedEventListener = FrontstageManager.onFrontstageActivatedEvent.addListener(this._handleFrontstageActivatedEvent);\r\n  }\r\n\r\n  public override componentWillUnmount() {\r\n    this._componentUnmounting = true;\r\n    this._removeSyncUiEventListener && this._removeSyncUiEventListener();\r\n    this._removeFrontstageActivatedEventListener && this._removeFrontstageActivatedEventListener();\r\n  }\r\n\r\n  private _handleSyncUiEvent = (args: SyncUiEventArgs): void => {\r\n    /* istanbul ignore next */\r\n    if (this._componentUnmounting)\r\n      return;\r\n\r\n    /* istanbul ignore else */\r\n    if (SyncUiEventDispatcher.hasEventOfInterest(args.eventIds, this._stateSyncIds)) {\r\n      /* istanbul ignore else */\r\n      if (this.props.stateFunc) {\r\n        const newState = this.props.stateFunc(this.state);\r\n        /* istanbul ignore else */\r\n        if (!PropsHelper.isShallowEqual(newState, this.state))\r\n          this.setState((_prevState) => newState);\r\n      }\r\n    }\r\n  };\r\n\r\n  public execute = async () => {\r\n    Backstage.hide(); // eslint-disable-line deprecation/deprecation\r\n\r\n    const frontstageDef = await FrontstageManager.getFrontstageDef(this.props.frontstageId);\r\n    if (frontstageDef)\r\n      await FrontstageManager.setActiveFrontstageDef(frontstageDef);\r\n    else\r\n      Logger.logError(UiFramework.loggerCategory(this), `Frontstage with id '${this.props.frontstageId}' not found`);\r\n  };\r\n\r\n  public override componentDidUpdate(_prevProps: FrontstageLaunchBackstageItemProps) {\r\n    const updatedState = BackstageItemUtilities.getBackstageItemStateFromProps(this.props);\r\n    updatedState.isActive = FrontstageManager.activeFrontstageId === this.props.frontstageId;\r\n    if (!PropsHelper.isShallowEqual(updatedState, this.state))\r\n      this.setState((_prevState) => updatedState);\r\n  }\r\n\r\n  private _handleFrontstageActivatedEvent = (args: FrontstageActivatedEventArgs) => {\r\n    const isActive = args.activatedFrontstageDef.id === this.props.frontstageId;\r\n    /* istanbul ignore else */\r\n    if (isActive !== this.state.isActive)\r\n      this.setState({ isActive });\r\n  };\r\n\r\n  // TODO: add tooltip, aria-label? to NZ_BackstageItem\r\n  public override render(): React.ReactNode {\r\n    return (\r\n      <BackstageItem\r\n        icon={PropsHelper.getIcon(this.state.iconSpec)}\r\n        isActive={this.state.isActive}\r\n        isDisabled={!this.state.isEnabled}\r\n        key={this.props.frontstageId}\r\n        onClick={this.execute}\r\n        subtitle={this.state.subtitle}\r\n      >\r\n        {this.state.label}\r\n      </BackstageItem>\r\n    );\r\n  }\r\n}\r\n"]}

package/lib/cjs/appui-react/backstage/Separator.d.ts

@@ -5,6 +5,7 @@ import * as React from "react";
 import { BackstageItemProps } from "./BackstageItemProps";
 /** Separator Backstage item.
  * @public
+ * @deprecated
  */
 export declare class SeparatorBackstageItem extends React.PureComponent<BackstageItemProps> {
     private static _sSeparatorBackstageItemKey;

package/lib/cjs/appui-react/backstage/Separator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Separator.d.ts","sourceRoot":"","sources":["../../../../src/appui-react/backstage/Separator.tsx"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,KAAK,CAAC,aAAa,CAAC,kBAAkB,CAAC;IACjF,OAAO,CAAC,MAAM,CAAC,2BAA2B,CAAS;IACnD,OAAO,CAAC,IAAI,CAAS;gBAET,yBAAyB,EAAE,kBAAkB;IAOzC,MAAM,IAAI,KAAK,CAAC,SAAS;CAK1C"}
+{"version":3,"file":"Separator.d.ts","sourceRoot":"","sources":["../../../../src/appui-react/backstage/Separator.tsx"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D;;;GAGG;AACH,qBAAa,sBAAuB,SAAQ,KAAK,CAAC,aAAa,CAAC,kBAAkB,CAAC;IACjF,OAAO,CAAC,MAAM,CAAC,2BAA2B,CAAS;IACnD,OAAO,CAAC,IAAI,CAAS;gBAET,yBAAyB,EAAE,kBAAkB;IAOzC,MAAM,IAAI,KAAK,CAAC,SAAS;CAK1C"}

package/lib/cjs/appui-react/backstage/Separator.js

@@ -12,12 +12,13 @@ const React = require("react");
 const appui_layout_react_1 = require("@itwin/appui-layout-react");
 /** Separator Backstage item.
  * @public
+ * @deprecated
  */
 class SeparatorBackstageItem extends React.PureComponent {
     constructor(separatorBackstageItemDef) {
         super(separatorBackstageItemDef);
-        SeparatorBackstageItem._sSeparatorBackstageItemKey++;
-        this._key = SeparatorBackstageItem._sSeparatorBackstageItemKey;
+        SeparatorBackstageItem._sSeparatorBackstageItemKey++; // eslint-disable-line deprecation/deprecation
+        this._key = SeparatorBackstageItem._sSeparatorBackstageItemKey; // eslint-disable-line deprecation/deprecation
     }
     render() {
         return (React.createElement(appui_layout_react_1.BackstageSeparator, { key: this._key }));

package/lib/cjs/appui-react/backstage/Separator.js.map

@@ -1 +1 @@
-{"version":3,"file":"Separator.js","sourceRoot":"","sources":["../../../../src/appui-react/backstage/Separator.tsx"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAEH,+BAA+B;AAC/B,kEAAwF;AAGxF;;GAEG;AACH,MAAa,sBAAuB,SAAQ,KAAK,CAAC,aAAiC;IAIjF,YAAY,yBAA6C;QACvD,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAEjC,sBAAsB,CAAC,2BAA2B,EAAE,CAAC;QACrD,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC,2BAA2B,CAAC;IACjE,CAAC;IAEe,MAAM;QACpB,OAAO,CACL,oBAAC,uCAAqB,IAAC,GAAG,EAAE,IAAI,CAAC,IAAI,GAAI,CAC1C,CAAC;IACJ,CAAC;CACF;AAhBD,wDAgBC","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 { BackstageSeparator as NZ_BackstageSeparator } from \"@itwin/appui-layout-react\";\r\nimport { BackstageItemProps } from \"./BackstageItemProps\";\r\n\r\n/** Separator Backstage item.\r\n * @public\r\n */\r\nexport class SeparatorBackstageItem extends React.PureComponent<BackstageItemProps> { // eslint-disable-line deprecation/deprecation\r\n  private static _sSeparatorBackstageItemKey: number;\r\n  private _key: number;\r\n\r\n  constructor(separatorBackstageItemDef: BackstageItemProps) { // eslint-disable-line deprecation/deprecation\r\n    super(separatorBackstageItemDef);\r\n\r\n    SeparatorBackstageItem._sSeparatorBackstageItemKey++;\r\n    this._key = SeparatorBackstageItem._sSeparatorBackstageItemKey;\r\n  }\r\n\r\n  public override render(): React.ReactNode {\r\n    return (\r\n      <NZ_BackstageSeparator key={this._key} />\r\n    );\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"Separator.js","sourceRoot":"","sources":["../../../../src/appui-react/backstage/Separator.tsx"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAEH,+BAA+B;AAC/B,kEAAwF;AAGxF;;;GAGG;AACH,MAAa,sBAAuB,SAAQ,KAAK,CAAC,aAAiC;IAIjF,YAAY,yBAA6C;QACvD,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAEjC,sBAAsB,CAAC,2BAA2B,EAAE,CAAC,CAAC,8CAA8C;QACpG,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC,2BAA2B,CAAC,CAAC,8CAA8C;IAChH,CAAC;IAEe,MAAM;QACpB,OAAO,CACL,oBAAC,uCAAqB,IAAC,GAAG,EAAE,IAAI,CAAC,IAAI,GAAI,CAC1C,CAAC;IACJ,CAAC;CACF;AAhBD,wDAgBC","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 { BackstageSeparator as NZ_BackstageSeparator } from \"@itwin/appui-layout-react\";\r\nimport { BackstageItemProps } from \"./BackstageItemProps\";\r\n\r\n/** Separator Backstage item.\r\n * @public\r\n * @deprecated\r\n */\r\nexport class SeparatorBackstageItem extends React.PureComponent<BackstageItemProps> { // eslint-disable-line deprecation/deprecation\r\n  private static _sSeparatorBackstageItemKey: number;\r\n  private _key: number;\r\n\r\n  constructor(separatorBackstageItemDef: BackstageItemProps) { // eslint-disable-line deprecation/deprecation\r\n    super(separatorBackstageItemDef);\r\n\r\n    SeparatorBackstageItem._sSeparatorBackstageItemKey++; // eslint-disable-line deprecation/deprecation\r\n    this._key = SeparatorBackstageItem._sSeparatorBackstageItemKey; // eslint-disable-line deprecation/deprecation\r\n  }\r\n\r\n  public override render(): React.ReactNode {\r\n    return (\r\n      <NZ_BackstageSeparator key={this._key} />\r\n    );\r\n  }\r\n}\r\n"]}

package/lib/cjs/appui-react/childwindow/ChildWindowManager.d.ts

@@ -18,7 +18,7 @@ export interface ChildWindowLocationProps {
 }
 /** Supports opening a child browser window from the main application window. The child window is managed by the main application
  * and is running in the same security context. The application must deliver the html file iTwinPopup.html along side its index.html.
- * See also: [Child Window Manager]($docs/learning/ui/framework/ChildWindows.md)
+ * See also: [Child Window Manager]($docs/learning/ui/appui-react/ChildWindows.md)
  * @public */
 export declare class ChildWindowManager {
     private _openChildWindows;

package/lib/cjs/appui-react/childwindow/ChildWindowManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChildWindowManager.d.ts","sourceRoot":"","sources":["../../../../src/appui-react/childwindow/ChildWindowManager.tsx"],"names":[],"mappings":"AAKA;;GAEG;AAEH,OAAO,2BAA2B,CAAC;AACnC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAsC/B,cAAc;AACd,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,cAAc;AACd,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;aAGa;AACb,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,iBAAiB,CAA6B;IAEtD,IAAW,gBAAgB,0BAE1B;IAEM,eAAe,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,GAAG,mBAAmB,GAAG,SAAS;IAOnF,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,SAAS;IAStF,OAAO,CAAC,yBAAyB;IA+CjC,gGAAgG;IACzF,oBAAoB;IAMpB,gBAAgB,kBAAmB,MAAM,2CAc9C;IAGF,OAAO,CAAC,mBAAmB;IAuBpB,eAAe,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,SAAS,EAAE,QAAQ,EAAE,wBAAwB,EAAE,mBAAmB,CAAC,EAAE,OAAO;CA8BzJ"}
+{"version":3,"file":"ChildWindowManager.d.ts","sourceRoot":"","sources":["../../../../src/appui-react/childwindow/ChildWindowManager.tsx"],"names":[],"mappings":"AAKA;;GAEG;AAEH,OAAO,2BAA2B,CAAC;AACnC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAqC/B,cAAc;AACd,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,cAAc;AACd,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;aAGa;AACb,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,iBAAiB,CAA6B;IAEtD,IAAW,gBAAgB,0BAE1B;IAEM,eAAe,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,GAAG,mBAAmB,GAAG,SAAS;IAOnF,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,SAAS;IAStF,OAAO,CAAC,yBAAyB;IA+CjC,gGAAgG;IACzF,oBAAoB;IAMpB,gBAAgB,kBAAmB,MAAM,2CAc9C;IAGF,OAAO,CAAC,mBAAmB;IAuBpB,eAAe,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,SAAS,EAAE,QAAQ,EAAE,wBAAwB,EAAE,mBAAmB,CAAC,EAAE,OAAO;CA8BzJ"}