@itwin/appui-react 4.15.5 → 4.16.0

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

@@ -7,7 +7,7 @@
  */
 import { ConditionalBooleanValue, ConditionalStringValue, } from "@itwin/appui-abstract";
 import { Logger } from "@itwin/core-bentley";
-import { Badge, Icon } from "@itwin/core-react";
+import { Badge, Icon as CoreIcon } from "@itwin/core-react";
 import * as React from "react";
 import { UiFramework } from "../UiFramework";
 import { useActiveFrontstageId } from "../frontstage/FrontstageDef";
@@ -15,6 +15,7 @@ import { BackstageItem as NZ_BackstageItem } from "../layout/backstage/Item";
 import { isProviderItem } from "../ui-items-provider/isProviderItem";
 import { isBackstageStageLauncher } from "./BackstageItem";
 import { useBackstageManager } from "./BackstageManager";
+import { Icon } from "@itwin/itwinui-react";
 /** @internal */
 export function BackstageComposerActionItem({ item, }) {
     const manager = useBackstageManager();
@@ -22,7 +23,11 @@ export function BackstageComposerActionItem({ item, }) {
         manager.close();
         item.execute();
     }, [manager, item]);
-    return (React.createElement(NZ_BackstageItem, { itemId: item.id, providerId: isProviderItem(item) ? item.providerId : undefined, itemPriority: item.itemPriority, groupPriority: item.groupPriority, icon: React.createElement(Icon, { iconSpec: item.icon }), isActive: ConditionalBooleanValue.getValue(item.isActive), isDisabled: ConditionalBooleanValue.getValue(item.isDisabled), onClick: handleClick, subtitle: ConditionalStringValue.getValue(item.subtitle), badge: React.createElement(Badge, { type: item.badge }) }, ConditionalStringValue.getValue(item.label)));
+    return (React.createElement(NZ_BackstageItem, { itemId: item.id, providerId: isProviderItem(item) ? item.providerId : undefined, itemPriority: item.itemPriority, groupPriority: item.groupPriority, 
+        // eslint-disable-next-line deprecation/deprecation
+        icon: React.createElement(ItemIcon, { iconNode: item.iconNode, icon: item.icon }), isActive: ConditionalBooleanValue.getValue(item.isActive), isDisabled: ConditionalBooleanValue.getValue(item.isDisabled), onClick: handleClick, subtitle: ConditionalStringValue.getValue(item.subtitle), 
+        // eslint-disable-next-line deprecation/deprecation
+        badge: React.createElement(Badge, { type: item.badgeKind || item.badge }) }, ConditionalStringValue.getValue(item.label)));
 }
 /** @internal */
 export function BackstageComposerStageLauncher({ item, }) {
@@ -35,7 +40,11 @@ export function BackstageComposerStageLauncher({ item, }) {
     }, [manager, item.stageId]);
     const activeFrontstageId = useActiveFrontstageId();
     const isActive = ConditionalBooleanValue.getValue(item.isActive ?? item.stageId === activeFrontstageId);
-    return (React.createElement(NZ_BackstageItem, { itemId: item.id, providerId: isProviderItem(item) ? item.providerId : undefined, itemPriority: item.itemPriority, groupPriority: item.groupPriority, icon: React.createElement(Icon, { iconSpec: item.icon }), isActive: isActive, isDisabled: ConditionalBooleanValue.getValue(item.isDisabled), onClick: handleClick, subtitle: ConditionalStringValue.getValue(item.subtitle), badge: React.createElement(Badge, { type: item.badge }) }, ConditionalStringValue.getValue(item.label)));
+    return (React.createElement(NZ_BackstageItem, { itemId: item.id, providerId: isProviderItem(item) ? item.providerId : undefined, itemPriority: item.itemPriority, groupPriority: item.groupPriority, 
+        // eslint-disable-next-line deprecation/deprecation
+        icon: React.createElement(ItemIcon, { iconNode: item.iconNode, icon: item.icon }), isActive: isActive, isDisabled: ConditionalBooleanValue.getValue(item.isDisabled), onClick: handleClick, subtitle: ConditionalStringValue.getValue(item.subtitle), 
+        // eslint-disable-next-line deprecation/deprecation
+        badge: React.createElement(Badge, { type: item.badgeKind || item.badge }) }, ConditionalStringValue.getValue(item.label)));
 }
 /** Item of [[BackstageComposer]].
  * @internal
@@ -46,4 +55,13 @@ export function BackstageComposerItem({ item }) {
     }
     return React.createElement(BackstageComposerActionItem, { item: item });
 }
+function ItemIcon({ 
+// eslint-disable-next-line deprecation/deprecation
+icon, iconNode, }) {
+    if (iconNode) {
+        return React.createElement(Icon, null, iconNode);
+    }
+    // eslint-disable-next-line deprecation/deprecation
+    return React.createElement(CoreIcon, { iconSpec: icon });
+}
 //# sourceMappingURL=BackstageComposerItem.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"BackstageComposerItem.js","sourceRoot":"","sources":["../../../../src/appui-react/backstage/BackstageComposerItem.tsx"],"names":[],"mappings":"AAAA;;;gGAGgG;AAChG;;GAEG;AAEH,OAAO,EACL,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,aAAa,IAAI,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAMrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAOzD,gBAAgB;AAChB,MAAM,UAAU,2BAA2B,CAAC,EAC1C,IAAI,GAC6B;IACjC,MAAM,OAAO,GAAG,mBAAmB,EAAE,CAAC;IACtC,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE;QACzC,OAAO,CAAC,KAAK,EAAE,CAAC;QAChB,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;IACpB,OAAO,CACL,oBAAC,gBAAgB,IACf,MAAM,EAAE,IAAI,CAAC,EAAE,EACf,UAAU,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,EAC9D,YAAY,EAAE,IAAI,CAAC,YAAY,EAC/B,aAAa,EAAE,IAAI,CAAC,aAAa,EACjC,IAAI,EAAE,oBAAC,IAAI,IAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,GAAI,EACnC,QAAQ,EAAE,uBAAuB,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,EACzD,UAAU,EAAE,uBAAuB,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,EAC7D,OAAO,EAAE,WAAW,EACpB,QAAQ,EAAE,sBAAsB,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,EACxD,KAAK,EAAE,oBAAC,KAAK,IAAC,IAAI,EAAE,IAAI,CAAC,KAAK,GAAI,IAEjC,sBAAsB,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAC3B,CACpB,CAAC;AACJ,CAAC;AAOD,gBAAgB;AAChB,MAAM,UAAU,8BAA8B,CAAC,EAC7C,IAAI,GACgC;IACpC,MAAM,OAAO,GAAG,mBAAmB,EAAE,CAAC;IACtC,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE;QACzC,OAAO,CAAC,KAAK,EAAE,CAAC;QAChB,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC;YACtD,OAAO,MAAM,CAAC,QAAQ,CACpB,gCAAgC,EAChC,uBAAuB,IAAI,CAAC,OAAO,aAAa,CACjD,CAAC;QACJ,KAAK,WAAW,CAAC,WAAW,CAAC,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACjE,CAAC,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5B,MAAM,kBAAkB,GAAG,qBAAqB,EAAE,CAAC;IACnD,MAAM,QAAQ,GAAG,uBAAuB,CAAC,QAAQ,CAC/C,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,OAAO,KAAK,kBAAkB,CACrD,CAAC;IACF,OAAO,CACL,oBAAC,gBAAgB,IACf,MAAM,EAAE,IAAI,CAAC,EAAE,EACf,UAAU,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,EAC9D,YAAY,EAAE,IAAI,CAAC,YAAY,EAC/B,aAAa,EAAE,IAAI,CAAC,aAAa,EACjC,IAAI,EAAE,oBAAC,IAAI,IAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,GAAI,EACnC,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,uBAAuB,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,EAC7D,OAAO,EAAE,WAAW,EACpB,QAAQ,EAAE,sBAAsB,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,EACxD,KAAK,EAAE,oBAAC,KAAK,IAAC,IAAI,EAAE,IAAI,CAAC,KAAK,GAAI,IAEjC,sBAAsB,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAC3B,CACpB,CAAC;AACJ,CAAC;AAUD;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,EAAE,IAAI,EAA8B;IACxE,IAAI,wBAAwB,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,OAAO,oBAAC,8BAA8B,IAAC,IAAI,EAAE,IAAI,GAAI,CAAC;IACxD,CAAC;IACD,OAAO,oBAAC,2BAA2B,IAAC,IAAI,EAAE,IAAI,GAAI,CAAC;AACrD,CAAC","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Backstage\n */\n\nimport {\n  ConditionalBooleanValue,\n  ConditionalStringValue,\n} from \"@itwin/appui-abstract\";\nimport { Logger } from \"@itwin/core-bentley\";\nimport { Badge, Icon } from \"@itwin/core-react\";\nimport * as React from \"react\";\nimport { UiFramework } from \"../UiFramework\";\nimport { useActiveFrontstageId } from \"../frontstage/FrontstageDef\";\nimport { BackstageItem as NZ_BackstageItem } from \"../layout/backstage/Item\";\nimport { isProviderItem } from \"../ui-items-provider/isProviderItem\";\nimport type {\n  BackstageActionItem,\n  BackstageItem,\n  BackstageStageLauncher,\n} from \"./BackstageItem\";\nimport { isBackstageStageLauncher } from \"./BackstageItem\";\nimport { useBackstageManager } from \"./BackstageManager\";\n\n/** @internal */\nexport interface BackstageComposerActionItemProps {\n  readonly item: BackstageActionItem;\n}\n\n/** @internal */\nexport function BackstageComposerActionItem({\n  item,\n}: BackstageComposerActionItemProps) {\n  const manager = useBackstageManager();\n  const handleClick = React.useCallback(() => {\n    manager.close();\n    item.execute();\n  }, [manager, item]);\n  return (\n    <NZ_BackstageItem\n      itemId={item.id}\n      providerId={isProviderItem(item) ? item.providerId : undefined}\n      itemPriority={item.itemPriority}\n      groupPriority={item.groupPriority}\n      icon={<Icon iconSpec={item.icon} />}\n      isActive={ConditionalBooleanValue.getValue(item.isActive)}\n      isDisabled={ConditionalBooleanValue.getValue(item.isDisabled)}\n      onClick={handleClick}\n      subtitle={ConditionalStringValue.getValue(item.subtitle)}\n      badge={<Badge type={item.badge} />}\n    >\n      {ConditionalStringValue.getValue(item.label)}\n    </NZ_BackstageItem>\n  );\n}\n\n/** @internal */\nexport interface BackstageComposerStageLauncherProps {\n  readonly item: BackstageStageLauncher;\n}\n\n/** @internal */\nexport function BackstageComposerStageLauncher({\n  item,\n}: BackstageComposerStageLauncherProps) {\n  const manager = useBackstageManager();\n  const handleClick = React.useCallback(() => {\n    manager.close();\n    if (!UiFramework.frontstages.hasFrontstage(item.stageId))\n      return Logger.logError(\n        \"BackstageComposerStageLauncher\",\n        `Frontstage with id '${item.stageId}' not found`\n      );\n    void UiFramework.frontstages.setActiveFrontstage(item.stageId);\n  }, [manager, item.stageId]);\n  const activeFrontstageId = useActiveFrontstageId();\n  const isActive = ConditionalBooleanValue.getValue(\n    item.isActive ?? item.stageId === activeFrontstageId\n  );\n  return (\n    <NZ_BackstageItem\n      itemId={item.id}\n      providerId={isProviderItem(item) ? item.providerId : undefined}\n      itemPriority={item.itemPriority}\n      groupPriority={item.groupPriority}\n      icon={<Icon iconSpec={item.icon} />}\n      isActive={isActive}\n      isDisabled={ConditionalBooleanValue.getValue(item.isDisabled)}\n      onClick={handleClick}\n      subtitle={ConditionalStringValue.getValue(item.subtitle)}\n      badge={<Badge type={item.badge} />}\n    >\n      {ConditionalStringValue.getValue(item.label)}\n    </NZ_BackstageItem>\n  );\n}\n\n/** Props of [[BackstageComposerItem]] component.\n * @internal\n */\nexport interface BackstageComposerItemProps {\n  /** Backstage item to render */\n  readonly item: BackstageItem;\n}\n\n/** Item of [[BackstageComposer]].\n * @internal\n */\nexport function BackstageComposerItem({ item }: BackstageComposerItemProps) {\n  if (isBackstageStageLauncher(item)) {\n    return <BackstageComposerStageLauncher item={item} />;\n  }\n  return <BackstageComposerActionItem item={item} />;\n}\n"]}
+{"version":3,"file":"BackstageComposerItem.js","sourceRoot":"","sources":["../../../../src/appui-react/backstage/BackstageComposerItem.tsx"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Backstage\n */\n\nimport {\n  ConditionalBooleanValue,\n  ConditionalStringValue,\n} from \"@itwin/appui-abstract\";\nimport { Logger } from \"@itwin/core-bentley\";\nimport { Badge, Icon as CoreIcon } from \"@itwin/core-react\";\nimport * as React from \"react\";\nimport { UiFramework } from \"../UiFramework\";\nimport { useActiveFrontstageId } from \"../frontstage/FrontstageDef\";\nimport { BackstageItem as NZ_BackstageItem } from \"../layout/backstage/Item\";\nimport { isProviderItem } from \"../ui-items-provider/isProviderItem\";\nimport type {\n  BackstageActionItem,\n  BackstageItem,\n  BackstageStageLauncher,\n  CommonBackstageItem,\n} from \"./BackstageItem\";\nimport { isBackstageStageLauncher } from \"./BackstageItem\";\nimport { useBackstageManager } from \"./BackstageManager\";\nimport { Icon } from \"@itwin/itwinui-react\";\n\n/** @internal */\nexport interface BackstageComposerActionItemProps {\n  readonly item: BackstageActionItem;\n}\n\n/** @internal */\nexport function BackstageComposerActionItem({\n  item,\n}: BackstageComposerActionItemProps) {\n  const manager = useBackstageManager();\n  const handleClick = React.useCallback(() => {\n    manager.close();\n    item.execute();\n  }, [manager, item]);\n  return (\n    <NZ_BackstageItem\n      itemId={item.id}\n      providerId={isProviderItem(item) ? item.providerId : undefined}\n      itemPriority={item.itemPriority}\n      groupPriority={item.groupPriority}\n      // eslint-disable-next-line deprecation/deprecation\n      icon={<ItemIcon iconNode={item.iconNode} icon={item.icon} />}\n      isActive={ConditionalBooleanValue.getValue(item.isActive)}\n      isDisabled={ConditionalBooleanValue.getValue(item.isDisabled)}\n      onClick={handleClick}\n      subtitle={ConditionalStringValue.getValue(item.subtitle)}\n      // eslint-disable-next-line deprecation/deprecation\n      badge={<Badge type={item.badgeKind || item.badge} />}\n    >\n      {ConditionalStringValue.getValue(item.label)}\n    </NZ_BackstageItem>\n  );\n}\n\n/** @internal */\nexport interface BackstageComposerStageLauncherProps {\n  readonly item: BackstageStageLauncher;\n}\n\n/** @internal */\nexport function BackstageComposerStageLauncher({\n  item,\n}: BackstageComposerStageLauncherProps) {\n  const manager = useBackstageManager();\n  const handleClick = React.useCallback(() => {\n    manager.close();\n    if (!UiFramework.frontstages.hasFrontstage(item.stageId))\n      return Logger.logError(\n        \"BackstageComposerStageLauncher\",\n        `Frontstage with id '${item.stageId}' not found`\n      );\n    void UiFramework.frontstages.setActiveFrontstage(item.stageId);\n  }, [manager, item.stageId]);\n  const activeFrontstageId = useActiveFrontstageId();\n  const isActive = ConditionalBooleanValue.getValue(\n    item.isActive ?? item.stageId === activeFrontstageId\n  );\n  return (\n    <NZ_BackstageItem\n      itemId={item.id}\n      providerId={isProviderItem(item) ? item.providerId : undefined}\n      itemPriority={item.itemPriority}\n      groupPriority={item.groupPriority}\n      // eslint-disable-next-line deprecation/deprecation\n      icon={<ItemIcon iconNode={item.iconNode} icon={item.icon} />}\n      isActive={isActive}\n      isDisabled={ConditionalBooleanValue.getValue(item.isDisabled)}\n      onClick={handleClick}\n      subtitle={ConditionalStringValue.getValue(item.subtitle)}\n      // eslint-disable-next-line deprecation/deprecation\n      badge={<Badge type={item.badgeKind || item.badge} />}\n    >\n      {ConditionalStringValue.getValue(item.label)}\n    </NZ_BackstageItem>\n  );\n}\n\n/** Props of [[BackstageComposerItem]] component.\n * @internal\n */\nexport interface BackstageComposerItemProps {\n  /** Backstage item to render */\n  readonly item: BackstageItem;\n}\n\n/** Item of [[BackstageComposer]].\n * @internal\n */\nexport function BackstageComposerItem({ item }: BackstageComposerItemProps) {\n  if (isBackstageStageLauncher(item)) {\n    return <BackstageComposerStageLauncher item={item} />;\n  }\n  return <BackstageComposerActionItem item={item} />;\n}\n\nfunction ItemIcon({\n  // eslint-disable-next-line deprecation/deprecation\n  icon,\n  iconNode,\n}: {\n  icon: CommonBackstageItem[\"icon\"];\n  iconNode: CommonBackstageItem[\"iconNode\"];\n}) {\n  if (iconNode) {\n    return <Icon>{iconNode}</Icon>;\n  }\n\n  // eslint-disable-next-line deprecation/deprecation\n  return <CoreIcon iconSpec={icon} />;\n}\n"]}

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

@@ -1,23 +1,32 @@
 /** @packageDocumentation
  * @module Backstage
  */
+/// <reference types="react" />
 import type { ConditionalBooleanValue, ConditionalStringValue } from "@itwin/appui-abstract";
-import type { BadgeType, IconSpec } from "@itwin/core-react";
+import type { BadgeKind, BadgeType, IconSpec } from "@itwin/core-react";
 /** Describes the data needed to insert a button into the backstage menu.
  * @public
  */
 export interface CommonBackstageItem {
     /** Required unique id of the item. To ensure uniqueness it is suggested that a namespace prefix of the extension name be used. */
     readonly id: string;
-    /** Describes badge. Renders no badge if not specified. */
+    /** Describes badge. Renders no badge if not specified.
+     * @deprecated in 4.16.0. Use `badgeKind` property instead.
+     */
     readonly badge?: BadgeType;
+    /** Specifies the kind of badge, if any, to be rendered. */
+    readonly badgeKind?: BadgeKind;
     /** Specifies the item's grouping value. Items are sorted by group and then item priority. When
      * group priority changes a separator is inserted. It is recommended using values 10 through 100, incrementing by 10. This
      * allows extensions enough gaps to insert their own groups.
      */
     readonly groupPriority: number;
-    /** Name of icon WebFont entry or if specifying an imported SVG symbol use "webSvg:" prefix to imported symbol Id. */
+    /** Name of icon WebFont entry or if specifying an imported SVG symbol use "webSvg:" prefix to imported symbol Id.
+     * @deprecated in 4.16.0. Use {@link CommonBackstageItem.iconNode} instead.
+     */
     readonly icon?: IconSpec;
+    /** Icon of the backstage item. */
+    readonly iconNode?: React.ReactNode;
     /** Describes if the item is visible or hidden. The default is for the item to be visible. */
     readonly isHidden?: boolean | ConditionalBooleanValue;
     /** Describes if the item is enabled or disabled. The default is for the item to be enabled. */
@@ -43,6 +52,7 @@ export interface BackstageActionItem extends CommonBackstageItem {
  * @public
  */
 export interface BackstageStageLauncher extends CommonBackstageItem {
+    /** Id of a frontstage that this item activates. */
     readonly stageId: string;
 }
 /** Describes the data needed to insert a button into the backstage menu.

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

@@ -1 +1 @@
-{"version":3,"file":"BackstageItem.d.ts","sourceRoot":"","sources":["../../../../src/appui-react/backstage/BackstageItem.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,KAAK,EACV,uBAAuB,EACvB,sBAAsB,EACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,kIAAkI;IAClI,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,qHAAqH;IACrH,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC;IACzB,6FAA6F;IAC7F,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,uBAAuB,CAAC;IACtD,+FAA+F;IAC/F,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,GAAG,uBAAuB,CAAC;IACxD,sEAAsE;IACtE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,aAAa;IACb,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,sBAAsB,CAAC;IAChD,gBAAgB;IAChB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,sBAAsB,CAAC;IACpD,eAAe;IACf,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,sBAAsB,CAAC;IACnD,sHAAsH;IACtH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,uBAAuB,CAAC;CACvD;AAED;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,mBAAmB;IAC9D,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,mBAAmB;IACjE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,mBAAmB,GAAG,sBAAsB,CAAC;AAEzE;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,aAAa,GAClB,IAAI,IAAI,mBAAmB,CAE7B;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,aAAa,GAClB,IAAI,IAAI,sBAAsB,CAEhC"}
+{"version":3,"file":"BackstageItem.d.ts","sourceRoot":"","sources":["../../../../src/appui-react/backstage/BackstageItem.ts"],"names":[],"mappings":"AAIA;;GAEG;;AAEH,OAAO,KAAK,EACV,uBAAuB,EACvB,sBAAsB,EACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAExE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,kIAAkI;IAClI,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB;;OAEG;IAEH,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;IAC3B,2DAA2D;IAC3D,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;IAC/B;;;OAGG;IACH,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B;;OAEG;IAEH,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC;IACzB,kCAAkC;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACpC,6FAA6F;IAC7F,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,uBAAuB,CAAC;IACtD,+FAA+F;IAC/F,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,GAAG,uBAAuB,CAAC;IACxD,sEAAsE;IACtE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,aAAa;IACb,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,sBAAsB,CAAC;IAChD,gBAAgB;IAChB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,sBAAsB,CAAC;IACpD,eAAe;IACf,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,sBAAsB,CAAC;IACnD,sHAAsH;IACtH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,uBAAuB,CAAC;CACvD;AAED;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,mBAAmB;IAC9D,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,mBAAmB;IACjE,mDAAmD;IACnD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,mBAAmB,GAAG,sBAAsB,CAAC;AAEzE;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,aAAa,GAClB,IAAI,IAAI,mBAAmB,CAE7B;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,aAAa,GAClB,IAAI,IAAI,sBAAsB,CAEhC"}

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

@@ -1 +1 @@
-{"version":3,"file":"BackstageItem.js","sourceRoot":"","sources":["../../../../src/appui-react/backstage/BackstageItem.ts"],"names":[],"mappings":"AAAA;;;gGAGgG;AAChG;;GAEG;AA0DH;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,IAAmB;IAEnB,OAAO,SAAS,IAAI,IAAI,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CACtC,IAAmB;IAEnB,OAAO,SAAS,IAAI,IAAI,CAAC;AAC3B,CAAC","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Backstage\n */\n\nimport type {\n  ConditionalBooleanValue,\n  ConditionalStringValue,\n} from \"@itwin/appui-abstract\";\nimport type { BadgeType, IconSpec } from \"@itwin/core-react\";\n\n/** Describes the data needed to insert a button into the backstage menu.\n * @public\n */\nexport interface CommonBackstageItem {\n  /** Required unique id of the item. To ensure uniqueness it is suggested that a namespace prefix of the extension name be used. */\n  readonly id: string;\n  /** Describes badge. Renders no badge if not specified. */\n  readonly badge?: BadgeType;\n  /** Specifies the item's grouping value. Items are sorted by group and then item priority. When\n   * group priority changes a separator is inserted. It is recommended using values 10 through 100, incrementing by 10. This\n   * allows extensions enough gaps to insert their own groups.\n   */\n  readonly groupPriority: number;\n  /** Name of icon WebFont entry or if specifying an imported SVG symbol use \"webSvg:\" prefix to imported symbol Id. */\n  readonly icon?: IconSpec;\n  /** Describes if the item is visible or hidden. The default is for the item to be visible. */\n  readonly isHidden?: boolean | ConditionalBooleanValue;\n  /** Describes if the item is enabled or disabled. The default is for the item to be enabled. */\n  readonly isDisabled?: boolean | ConditionalBooleanValue;\n  /** Priority within a group (recommend using values 1 through 100). */\n  readonly itemPriority: number;\n  /** Label. */\n  readonly label: string | ConditionalStringValue;\n  /** Subtitle. */\n  readonly subtitle?: string | ConditionalStringValue;\n  /** Tooltip. */\n  readonly tooltip?: string | ConditionalStringValue;\n  /** Describes if the item is active. The default is for the item to be active if stageId matches activeFrontstageId */\n  readonly isActive?: boolean | ConditionalBooleanValue;\n}\n\n/** Describes the data needed to insert an action button into the backstage menu.\n * @public\n */\nexport interface BackstageActionItem extends CommonBackstageItem {\n  readonly execute: () => void;\n}\n\n/** Describes the data needed to insert an action button into the backstage menu.\n * @public\n */\nexport interface BackstageStageLauncher extends CommonBackstageItem {\n  readonly stageId: string;\n}\n\n/** Describes the data needed to insert a button into the backstage menu.\n * @public\n */\nexport type BackstageItem = BackstageActionItem | BackstageStageLauncher;\n\n/** BackstageActionItem type guard.\n * @public\n */\nexport function isBackstageActionItem(\n  item: BackstageItem\n): item is BackstageActionItem {\n  return \"execute\" in item;\n}\n\n/** BackstageStageLauncher type guard.\n * @public\n */\nexport function isBackstageStageLauncher(\n  item: BackstageItem\n): item is BackstageStageLauncher {\n  return \"stageId\" in item;\n}\n"]}
+{"version":3,"file":"BackstageItem.js","sourceRoot":"","sources":["../../../../src/appui-react/backstage/BackstageItem.ts"],"names":[],"mappings":"AAAA;;;gGAGgG;AAChG;;GAEG;AAqEH;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,IAAmB;IAEnB,OAAO,SAAS,IAAI,IAAI,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CACtC,IAAmB;IAEnB,OAAO,SAAS,IAAI,IAAI,CAAC;AAC3B,CAAC","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Backstage\n */\n\nimport type {\n  ConditionalBooleanValue,\n  ConditionalStringValue,\n} from \"@itwin/appui-abstract\";\nimport type { BadgeKind, BadgeType, IconSpec } from \"@itwin/core-react\";\n\n/** Describes the data needed to insert a button into the backstage menu.\n * @public\n */\nexport interface CommonBackstageItem {\n  /** Required unique id of the item. To ensure uniqueness it is suggested that a namespace prefix of the extension name be used. */\n  readonly id: string;\n  /** Describes badge. Renders no badge if not specified.\n   * @deprecated in 4.16.0. Use `badgeKind` property instead.\n   */\n  // eslint-disable-next-line deprecation/deprecation\n  readonly badge?: BadgeType;\n  /** Specifies the kind of badge, if any, to be rendered. */\n  readonly badgeKind?: BadgeKind;\n  /** Specifies the item's grouping value. Items are sorted by group and then item priority. When\n   * group priority changes a separator is inserted. It is recommended using values 10 through 100, incrementing by 10. This\n   * allows extensions enough gaps to insert their own groups.\n   */\n  readonly groupPriority: number;\n  /** Name of icon WebFont entry or if specifying an imported SVG symbol use \"webSvg:\" prefix to imported symbol Id.\n   * @deprecated in 4.16.0. Use {@link CommonBackstageItem.iconNode} instead.\n   */\n  // eslint-disable-next-line deprecation/deprecation\n  readonly icon?: IconSpec;\n  /** Icon of the backstage item. */\n  readonly iconNode?: React.ReactNode;\n  /** Describes if the item is visible or hidden. The default is for the item to be visible. */\n  readonly isHidden?: boolean | ConditionalBooleanValue;\n  /** Describes if the item is enabled or disabled. The default is for the item to be enabled. */\n  readonly isDisabled?: boolean | ConditionalBooleanValue;\n  /** Priority within a group (recommend using values 1 through 100). */\n  readonly itemPriority: number;\n  /** Label. */\n  readonly label: string | ConditionalStringValue;\n  /** Subtitle. */\n  readonly subtitle?: string | ConditionalStringValue;\n  /** Tooltip. */\n  readonly tooltip?: string | ConditionalStringValue;\n  /** Describes if the item is active. The default is for the item to be active if stageId matches activeFrontstageId */\n  readonly isActive?: boolean | ConditionalBooleanValue;\n}\n\n/** Describes the data needed to insert an action button into the backstage menu.\n * @public\n */\nexport interface BackstageActionItem extends CommonBackstageItem {\n  readonly execute: () => void;\n}\n\n/** Describes the data needed to insert an action button into the backstage menu.\n * @public\n */\nexport interface BackstageStageLauncher extends CommonBackstageItem {\n  /** Id of a frontstage that this item activates. */\n  readonly stageId: string;\n}\n\n/** Describes the data needed to insert a button into the backstage menu.\n * @public\n */\nexport type BackstageItem = BackstageActionItem | BackstageStageLauncher;\n\n/** BackstageActionItem type guard.\n * @public\n */\nexport function isBackstageActionItem(\n  item: BackstageItem\n): item is BackstageActionItem {\n  return \"execute\" in item;\n}\n\n/** BackstageStageLauncher type guard.\n * @public\n */\nexport function isBackstageStageLauncher(\n  item: BackstageItem\n): item is BackstageStageLauncher {\n  return \"stageId\" in item;\n}\n"]}

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

@@ -4,12 +4,56 @@
 import type { IconSpec } from "@itwin/core-react";
 import type { BackstageActionItem, BackstageStageLauncher } from "./BackstageItem";
 /** Utilities for creating and maintaining backstage items
- * @beta
+ * @public
  */
 export declare namespace BackstageItemUtilities {
+    interface CreateStageLauncherArgs extends Partial<Omit<BackstageStageLauncher, "icon" | "iconNode" | "stageId">>, Pick<BackstageStageLauncher, "stageId"> {
+        icon?: BackstageStageLauncher["iconNode"];
+    }
+    type DeprecatedCreateStageLauncherArgs = [
+        frontstageId: string,
+        groupPriority: number,
+        itemPriority: number,
+        label: string,
+        subtitle?: string,
+        icon?: IconSpec,
+        overrides?: Partial<BackstageStageLauncher>
+    ];
     /** Creates a stage launcher backstage item. */
-    function createStageLauncher(frontstageId: string, groupPriority: number, itemPriority: number, label: string, subtitle?: string, icon?: IconSpec, overrides?: Partial<BackstageStageLauncher>): BackstageStageLauncher;
-    /** Creates an action backstage item. */
-    function createActionItem(itemId: string, groupPriority: number, itemPriority: number, execute: () => void, label: string, subtitle?: string, icon?: IconSpec, overrides?: Partial<BackstageActionItem>): BackstageActionItem;
+    export function createStageLauncher(args: CreateStageLauncherArgs): BackstageStageLauncher;
+    /** Creates a stage launcher backstage item.
+     * @deprecated in 4.16.0. Uses a deprecated {@link @itwin/core-react#IconSpec} type. Use an overload instead.
+     */
+    export function createStageLauncher(...args: DeprecatedCreateStageLauncherArgs): BackstageStageLauncher;
+    interface CreateActionItemArgs extends Partial<Omit<BackstageActionItem, "icon" | "iconNode">> {
+        id: BackstageActionItem["id"];
+        icon?: BackstageActionItem["iconNode"];
+    }
+    type DeprecatedCreateActionItemArgs = [
+        itemId: string,
+        groupPriority: number,
+        itemPriority: number,
+        execute: () => void,
+        label: string,
+        subtitle?: string,
+        icon?: IconSpec,
+        overrides?: Partial<BackstageActionItem>
+    ];
+    /** Creates an action backstage item.
+     * @note `id` defaults to a specified `stageId`.
+     * @note `groupPriority` defaults to `0`.
+     * @note `itemPriority` defaults to `0`.
+     * @note `label` defaults to `""`.
+     */
+    export function createActionItem(args: CreateActionItemArgs): BackstageActionItem;
+    /** Creates an action backstage item.
+     * @deprecated in 4.16.0. Uses a deprecated {@link @itwin/core-react#IconSpec} type. Use an overload instead.
+     */
+    export function createActionItem(...args: DeprecatedCreateActionItemArgs): BackstageActionItem;
+    export {};
 }
+/** Type-guard that returns `true` if specified array has a single object.
+ * @internal
+ */
+export declare function isArgsUtil<TTuple extends any[], TArgs>(args: TTuple | [TArgs]): args is [TArgs];
 //# sourceMappingURL=BackstageItemUtilities.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"BackstageItemUtilities.d.ts","sourceRoot":"","sources":["../../../../src/appui-react/backstage/BackstageItemUtilities.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EACV,mBAAmB,EACnB,sBAAsB,EACvB,MAAM,iBAAiB,CAAC;AAEzB;;GAEG;AACH,yBAAiB,sBAAsB,CAAC;IACtC,+CAA+C;IAC/C,SAAgB,mBAAmB,CACjC,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,QAAQ,EACf,SAAS,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,GAC1C,sBAAsB,CAWxB;IAED,wCAAwC;IACxC,SAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,IAAI,EACnB,KAAK,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,QAAQ,EACf,SAAS,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GACvC,mBAAmB,CAWrB;CACF"}
+{"version":3,"file":"BackstageItemUtilities.d.ts","sourceRoot":"","sources":["../../../../src/appui-react/backstage/BackstageItemUtilities.tsx"],"names":[],"mappings":"AAIA;;GAEG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EACV,mBAAmB,EACnB,sBAAsB,EACvB,MAAM,iBAAiB,CAAC;AAEzB;;GAEG;AACH,yBAAiB,sBAAsB,CAAC;IACtC,UAAU,uBACR,SAAQ,OAAO,CACX,IAAI,CAAC,sBAAsB,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC,CAC9D,EACD,IAAI,CAAC,sBAAsB,EAAE,SAAS,CAAC;QACzC,IAAI,CAAC,EAAE,sBAAsB,CAAC,UAAU,CAAC,CAAC;KAC3C;IAED,KAAK,iCAAiC,GAAG;QACvC,YAAY,EAAE,MAAM;QACpB,aAAa,EAAE,MAAM;QACrB,YAAY,EAAE,MAAM;QACpB,KAAK,EAAE,MAAM;QACb,QAAQ,CAAC,EAAE,MAAM;QAEjB,IAAI,CAAC,EAAE,QAAQ;QACf,SAAS,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC;KAC5C,CAAC;IAyBF,+CAA+C;IAC/C,MAAM,UAAU,mBAAmB,CACjC,IAAI,EAAE,uBAAuB,GAC5B,sBAAsB,CAAC;IAC1B;;OAEG;IACH,MAAM,UAAU,mBAAmB,CACjC,GAAG,IAAI,EAAE,iCAAiC,GACzC,sBAAsB,CAAC;IA6B1B,UAAU,oBACR,SAAQ,OAAO,CAAC,IAAI,CAAC,mBAAmB,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC;QAC/D,EAAE,EAAE,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAC9B,IAAI,CAAC,EAAE,mBAAmB,CAAC,UAAU,CAAC,CAAC;KACxC;IAED,KAAK,8BAA8B,GAAG;QACpC,MAAM,EAAE,MAAM;QACd,aAAa,EAAE,MAAM;QACrB,YAAY,EAAE,MAAM;QACpB,OAAO,EAAE,MAAM,IAAI;QACnB,KAAK,EAAE,MAAM;QACb,QAAQ,CAAC,EAAE,MAAM;QAEjB,IAAI,CAAC,EAAE,QAAQ;QACf,SAAS,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC;KACzC,CAAC;IA0BF;;;;;OAKG;IACH,MAAM,UAAU,gBAAgB,CAC9B,IAAI,EAAE,oBAAoB,GACzB,mBAAmB,CAAC;IACvB;;OAEG;IACH,MAAM,UAAU,gBAAgB,CAC9B,GAAG,IAAI,EAAE,8BAA8B,GACtC,mBAAmB,CAAC;;CA2BxB;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,SAAS,GAAG,EAAE,EAAE,KAAK,EACpD,IAAI,EAAE,MAAM,GAAG,CAAC,KAAK,CAAC,GACrB,IAAI,IAAI,CAAC,KAAK,CAAC,CAEjB"}

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

@@ -5,27 +5,43 @@
 /** @packageDocumentation
  * @module Backstage
  */
+import * as React from "react";
 /** Utilities for creating and maintaining backstage items
- * @beta
+ * @public
  */
 export var BackstageItemUtilities;
 (function (BackstageItemUtilities) {
-    /** Creates a stage launcher backstage item. */
-    function createStageLauncher(frontstageId, groupPriority, itemPriority, label, subtitle, icon, overrides) {
+    function createDeprecatedStageLauncher(...[frontstageId, groupPriority, itemPriority, label, subtitle, icon, overrides,]) {
         return {
+            id: frontstageId,
+            stageId: frontstageId,
             groupPriority,
             icon,
-            id: frontstageId,
             itemPriority,
             label,
-            stageId: frontstageId,
             subtitle,
             ...overrides,
         };
     }
+    /** Creates a stage launcher backstage item. */
+    function createStageLauncher(...args) {
+        if (isArgsUtil(args)) {
+            const { stageId, groupPriority = 0, itemPriority = 0, label = "", icon, ...other } = args[0];
+            return {
+                id: stageId,
+                stageId,
+                groupPriority,
+                itemPriority,
+                label,
+                iconNode: icon,
+                icon: icon ? React.createElement(React.Fragment, null, icon) : undefined,
+                ...other,
+            };
+        }
+        return createDeprecatedStageLauncher(...args);
+    }
     BackstageItemUtilities.createStageLauncher = createStageLauncher;
-    /** Creates an action backstage item. */
-    function createActionItem(itemId, groupPriority, itemPriority, execute, label, subtitle, icon, overrides) {
+    function createDeprecatedActionItem(...[itemId, groupPriority, itemPriority, execute, label, subtitle, icon, overrides,]) {
         return {
             execute,
             groupPriority,
@@ -37,6 +53,28 @@ export var BackstageItemUtilities;
             ...overrides,
         };
     }
+    /** Creates an action backstage item. */
+    function createActionItem(...args) {
+        if (isArgsUtil(args)) {
+            const { groupPriority = 0, itemPriority = 0, execute = () => { }, label = "", icon, ...other } = args[0];
+            return {
+                groupPriority,
+                itemPriority,
+                execute,
+                label,
+                iconNode: icon,
+                icon: icon ? React.createElement(React.Fragment, null, icon) : undefined,
+                ...other,
+            };
+        }
+        return createDeprecatedActionItem(...args);
+    }
     BackstageItemUtilities.createActionItem = createActionItem;
 })(BackstageItemUtilities || (BackstageItemUtilities = {}));
+/** Type-guard that returns `true` if specified array has a single object.
+ * @internal
+ */
+export function isArgsUtil(args) {
+    return args.length === 1 && typeof args[0] === "object";
+}
 //# sourceMappingURL=BackstageItemUtilities.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"BackstageItemUtilities.js","sourceRoot":"","sources":["../../../../src/appui-react/backstage/BackstageItemUtilities.ts"],"names":[],"mappings":"AAAA;;;gGAGgG;AAChG;;GAEG;AAQH;;GAEG;AACH,MAAM,KAAW,sBAAsB,CA6CtC;AA7CD,WAAiB,sBAAsB;IACrC,+CAA+C;IAC/C,SAAgB,mBAAmB,CACjC,YAAoB,EACpB,aAAqB,EACrB,YAAoB,EACpB,KAAa,EACb,QAAiB,EACjB,IAAe,EACf,SAA2C;QAE3C,OAAO;YACL,aAAa;YACb,IAAI;YACJ,EAAE,EAAE,YAAY;YAChB,YAAY;YACZ,KAAK;YACL,OAAO,EAAE,YAAY;YACrB,QAAQ;YACR,GAAG,SAAS;SACb,CAAC;IACJ,CAAC;IAnBe,0CAAmB,sBAmBlC,CAAA;IAED,wCAAwC;IACxC,SAAgB,gBAAgB,CAC9B,MAAc,EACd,aAAqB,EACrB,YAAoB,EACpB,OAAmB,EACnB,KAAa,EACb,QAAiB,EACjB,IAAe,EACf,SAAwC;QAExC,OAAO;YACL,OAAO;YACP,aAAa;YACb,IAAI;YACJ,EAAE,EAAE,MAAM;YACV,YAAY;YACZ,KAAK;YACL,QAAQ;YACR,GAAG,SAAS;SACb,CAAC;IACJ,CAAC;IApBe,uCAAgB,mBAoB/B,CAAA;AACH,CAAC,EA7CgB,sBAAsB,KAAtB,sBAAsB,QA6CtC","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Backstage\n */\n\nimport type { IconSpec } from \"@itwin/core-react\";\nimport type {\n  BackstageActionItem,\n  BackstageStageLauncher,\n} from \"./BackstageItem\";\n\n/** Utilities for creating and maintaining backstage items\n * @beta\n */\nexport namespace BackstageItemUtilities {\n  /** Creates a stage launcher backstage item. */\n  export function createStageLauncher(\n    frontstageId: string,\n    groupPriority: number,\n    itemPriority: number,\n    label: string,\n    subtitle?: string,\n    icon?: IconSpec,\n    overrides?: Partial<BackstageStageLauncher>\n  ): BackstageStageLauncher {\n    return {\n      groupPriority,\n      icon,\n      id: frontstageId,\n      itemPriority,\n      label,\n      stageId: frontstageId,\n      subtitle,\n      ...overrides,\n    };\n  }\n\n  /** Creates an action backstage item. */\n  export function createActionItem(\n    itemId: string,\n    groupPriority: number,\n    itemPriority: number,\n    execute: () => void,\n    label: string,\n    subtitle?: string,\n    icon?: IconSpec,\n    overrides?: Partial<BackstageActionItem>\n  ): BackstageActionItem {\n    return {\n      execute,\n      groupPriority,\n      icon,\n      id: itemId,\n      itemPriority,\n      label,\n      subtitle,\n      ...overrides,\n    };\n  }\n}\n"]}
+{"version":3,"file":"BackstageItemUtilities.js","sourceRoot":"","sources":["../../../../src/appui-react/backstage/BackstageItemUtilities.tsx"],"names":[],"mappings":"AAAA;;;gGAGgG;AAChG;;GAEG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAO/B;;GAEG;AACH,MAAM,KAAW,sBAAsB,CAoKtC;AApKD,WAAiB,sBAAsB;IAoBrC,SAAS,6BAA6B,CACpC,GAAG,CACD,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,KAAK,EACL,QAAQ,EACR,IAAI,EACJ,SAAS,EACyB;QAEpC,OAAO;YACL,EAAE,EAAE,YAAY;YAChB,OAAO,EAAE,YAAY;YACrB,aAAa;YACb,IAAI;YACJ,YAAY;YACZ,KAAK;YACL,QAAQ;YACR,GAAG,SAAS;SACb,CAAC;IACJ,CAAC;IAYD,+CAA+C;IAC/C,SAAgB,mBAAmB,CACjC,GAAG,IAAmE;QAEtE,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACrB,MAAM,EACJ,OAAO,EACP,aAAa,GAAG,CAAC,EACjB,YAAY,GAAG,CAAC,EAChB,KAAK,GAAG,EAAE,EACV,IAAI,EACJ,GAAG,KAAK,EACT,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YACZ,OAAO;gBACL,EAAE,EAAE,OAAO;gBACX,OAAO;gBACP,aAAa;gBACb,YAAY;gBACZ,KAAK;gBACL,QAAQ,EAAE,IAAI;gBACd,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,0CAAG,IAAI,CAAI,CAAC,CAAC,CAAC,SAAS;gBACpC,GAAG,KAAK;aACT,CAAC;QACJ,CAAC;QAED,OAAO,6BAA6B,CAAC,GAAG,IAAI,CAAC,CAAC;IAChD,CAAC;IAzBe,0CAAmB,sBAyBlC,CAAA;IAoBD,SAAS,0BAA0B,CACjC,GAAG,CACD,MAAM,EACN,aAAa,EACb,YAAY,EACZ,OAAO,EACP,KAAK,EACL,QAAQ,EACR,IAAI,EACJ,SAAS,EACsB;QAEjC,OAAO;YACL,OAAO;YACP,aAAa;YACb,IAAI;YACJ,EAAE,EAAE,MAAM;YACV,YAAY;YACZ,KAAK;YACL,QAAQ;YACR,GAAG,SAAS;SACb,CAAC;IACJ,CAAC;IAiBD,wCAAwC;IACxC,SAAgB,gBAAgB,CAC9B,GAAG,IAA6D;QAEhE,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACrB,MAAM,EACJ,aAAa,GAAG,CAAC,EACjB,YAAY,GAAG,CAAC,EAChB,OAAO,GAAG,GAAG,EAAE,GAAE,CAAC,EAClB,KAAK,GAAG,EAAE,EACV,IAAI,EACJ,GAAG,KAAK,EACT,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YACZ,OAAO;gBACL,aAAa;gBACb,YAAY;gBACZ,OAAO;gBACP,KAAK;gBACL,QAAQ,EAAE,IAAI;gBACd,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,0CAAG,IAAI,CAAI,CAAC,CAAC,CAAC,SAAS;gBACpC,GAAG,KAAK;aACT,CAAC;QACJ,CAAC;QAED,OAAO,0BAA0B,CAAC,GAAG,IAAI,CAAC,CAAC;IAC7C,CAAC;IAxBe,uCAAgB,mBAwB/B,CAAA;AACH,CAAC,EApKgB,sBAAsB,KAAtB,sBAAsB,QAoKtC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CACxB,IAAsB;IAEtB,OAAO,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC;AAC1D,CAAC","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Backstage\n */\n\nimport * as React from \"react\";\nimport type { IconSpec } from \"@itwin/core-react\";\nimport type {\n  BackstageActionItem,\n  BackstageStageLauncher,\n} from \"./BackstageItem\";\n\n/** Utilities for creating and maintaining backstage items\n * @public\n */\nexport namespace BackstageItemUtilities {\n  interface CreateStageLauncherArgs\n    extends Partial<\n        Omit<BackstageStageLauncher, \"icon\" | \"iconNode\" | \"stageId\">\n      >,\n      Pick<BackstageStageLauncher, \"stageId\"> {\n    icon?: BackstageStageLauncher[\"iconNode\"];\n  }\n\n  type DeprecatedCreateStageLauncherArgs = [\n    frontstageId: string,\n    groupPriority: number,\n    itemPriority: number,\n    label: string,\n    subtitle?: string,\n    // eslint-disable-next-line deprecation/deprecation\n    icon?: IconSpec,\n    overrides?: Partial<BackstageStageLauncher>\n  ];\n\n  function createDeprecatedStageLauncher(\n    ...[\n      frontstageId,\n      groupPriority,\n      itemPriority,\n      label,\n      subtitle,\n      icon,\n      overrides,\n    ]: DeprecatedCreateStageLauncherArgs\n  ): BackstageStageLauncher {\n    return {\n      id: frontstageId,\n      stageId: frontstageId,\n      groupPriority,\n      icon,\n      itemPriority,\n      label,\n      subtitle,\n      ...overrides,\n    };\n  }\n\n  /** Creates a stage launcher backstage item. */\n  export function createStageLauncher(\n    args: CreateStageLauncherArgs\n  ): BackstageStageLauncher;\n  /** Creates a stage launcher backstage item.\n   * @deprecated in 4.16.0. Uses a deprecated {@link @itwin/core-react#IconSpec} type. Use an overload instead.\n   */\n  export function createStageLauncher(\n    ...args: DeprecatedCreateStageLauncherArgs\n  ): BackstageStageLauncher;\n  /** Creates a stage launcher backstage item. */\n  export function createStageLauncher(\n    ...args: DeprecatedCreateStageLauncherArgs | [CreateStageLauncherArgs]\n  ): BackstageStageLauncher {\n    if (isArgsUtil(args)) {\n      const {\n        stageId,\n        groupPriority = 0,\n        itemPriority = 0,\n        label = \"\",\n        icon,\n        ...other\n      } = args[0];\n      return {\n        id: stageId,\n        stageId,\n        groupPriority,\n        itemPriority,\n        label,\n        iconNode: icon,\n        icon: icon ? <>{icon}</> : undefined,\n        ...other,\n      };\n    }\n\n    return createDeprecatedStageLauncher(...args);\n  }\n\n  interface CreateActionItemArgs\n    extends Partial<Omit<BackstageActionItem, \"icon\" | \"iconNode\">> {\n    id: BackstageActionItem[\"id\"];\n    icon?: BackstageActionItem[\"iconNode\"];\n  }\n\n  type DeprecatedCreateActionItemArgs = [\n    itemId: string,\n    groupPriority: number,\n    itemPriority: number,\n    execute: () => void,\n    label: string,\n    subtitle?: string,\n    // eslint-disable-next-line deprecation/deprecation\n    icon?: IconSpec,\n    overrides?: Partial<BackstageActionItem>\n  ];\n\n  function createDeprecatedActionItem(\n    ...[\n      itemId,\n      groupPriority,\n      itemPriority,\n      execute,\n      label,\n      subtitle,\n      icon,\n      overrides,\n    ]: DeprecatedCreateActionItemArgs\n  ): BackstageActionItem {\n    return {\n      execute,\n      groupPriority,\n      icon,\n      id: itemId,\n      itemPriority,\n      label,\n      subtitle,\n      ...overrides,\n    };\n  }\n\n  /** Creates an action backstage item.\n   * @note `id` defaults to a specified `stageId`.\n   * @note `groupPriority` defaults to `0`.\n   * @note `itemPriority` defaults to `0`.\n   * @note `label` defaults to `\"\"`.\n   */\n  export function createActionItem(\n    args: CreateActionItemArgs\n  ): BackstageActionItem;\n  /** Creates an action backstage item.\n   * @deprecated in 4.16.0. Uses a deprecated {@link @itwin/core-react#IconSpec} type. Use an overload instead.\n   */\n  export function createActionItem(\n    ...args: DeprecatedCreateActionItemArgs\n  ): BackstageActionItem;\n  /** Creates an action backstage item. */\n  export function createActionItem(\n    ...args: DeprecatedCreateActionItemArgs | [CreateActionItemArgs]\n  ): BackstageActionItem {\n    if (isArgsUtil(args)) {\n      const {\n        groupPriority = 0,\n        itemPriority = 0,\n        execute = () => {},\n        label = \"\",\n        icon,\n        ...other\n      } = args[0];\n      return {\n        groupPriority,\n        itemPriority,\n        execute,\n        label,\n        iconNode: icon,\n        icon: icon ? <>{icon}</> : undefined,\n        ...other,\n      };\n    }\n\n    return createDeprecatedActionItem(...args);\n  }\n}\n\n/** Type-guard that returns `true` if specified array has a single object.\n * @internal\n */\nexport function isArgsUtil<TTuple extends any[], TArgs>(\n  args: TTuple | [TArgs]\n): args is [TArgs] {\n  return args.length === 1 && typeof args[0] === \"object\";\n}\n"]}

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

@@ -22,8 +22,7 @@ export declare class BackstageManager {
     close(): void;
     toggle(): void;
     getBackstageToggleCommand(overrideIconSpec?: IconSpec): import("../shared/CommandItemDef").CommandItemDef;
-    /** Get CommandItemDef that will toggle display of Backstage and allow iconSpec to be overridden
-     */
+    /** Get CommandItemDef that will toggle display of Backstage and allow iconSpec to be overridden. */
     static getBackstageToggleCommand(overrideIconSpec?: IconSpec): import("../shared/CommandItemDef").CommandItemDef;
 }
 /** Hook that returns isOpen flag of the backstage.

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

@@ -1 +1 @@
-{"version":3,"file":"BackstageManager.d.ts","sourceRoot":"","sources":["../../../../src/appui-react/backstage/BackstageManager.tsx"],"names":[],"mappings":"AAIA;;GAEG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAEtE;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAkC;IAElD;;;OAGG;IACI,YAAY,CAAC,QAAQ,EAAE,wBAAwB;IAItD,uDAAuD;IACvD,IAAW,SAAS,0HAEnB;IAED,IAAW,MAAM,YAEhB;IAEM,IAAI;IAIJ,KAAK;IAIL,MAAM;IAIN,yBAAyB,CAAC,gBAAgB,CAAC,EAAE,QAAQ;IAI5D;OACG;WACW,yBAAyB,CAAC,gBAAgB,CAAC,EAAE,QAAQ;CAIpE;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,YAAa,kBAAkB,YAS7D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,0BAG/B,CAAC"}
+{"version":3,"file":"BackstageManager.d.ts","sourceRoot":"","sources":["../../../../src/appui-react/backstage/BackstageManager.tsx"],"names":[],"mappings":"AAIA;;GAEG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAEtE;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAkC;IAElD;;;OAGG;IACI,YAAY,CAAC,QAAQ,EAAE,wBAAwB;IAItD,uDAAuD;IACvD,IAAW,SAAS,0HAEnB;IAED,IAAW,MAAM,YAEhB;IAEM,IAAI;IAIJ,KAAK;IAIL,MAAM;IAKN,yBAAyB,CAAC,gBAAgB,CAAC,EAAE,QAAQ;IAI5D,oGAAoG;WAEtF,yBAAyB,CAAC,gBAAgB,CAAC,EAAE,QAAQ;CAIpE;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,YAAa,kBAAkB,YAS7D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,0BAG/B,CAAC"}

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

@@ -39,11 +39,12 @@ export class BackstageManager {
     toggle() {
         return this.internal.toggle();
     }
+    // eslint-disable-next-line deprecation/deprecation
     getBackstageToggleCommand(overrideIconSpec) {
         return this.internal.getBackstageToggleCommand(overrideIconSpec);
     }
-    /** Get CommandItemDef that will toggle display of Backstage and allow iconSpec to be overridden
-     */
+    /** Get CommandItemDef that will toggle display of Backstage and allow iconSpec to be overridden. */
+    // eslint-disable-next-line deprecation/deprecation
     static getBackstageToggleCommand(overrideIconSpec) {
         // eslint-disable-next-line deprecation/deprecation
         return UiFramework.backstage.getBackstageToggleCommand(overrideIconSpec);

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

@@ -1 +1 @@
-{"version":3,"file":"BackstageManager.js","sourceRoot":"","sources":["../../../../src/appui-react/backstage/BackstageManager.tsx"],"names":[],"mappings":"AAAA;;;gGAGgG;AAChG;;GAEG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAEtE;;;GAGG;AACH,MAAM,OAAO,gBAAgB;IAA7B;QACU,aAAQ,GAAG,IAAI,wBAAwB,EAAE,CAAC;IAyCpD,CAAC;IAvCC;;;OAGG;IACI,YAAY,CAAC,QAAkC;QACpD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,uDAAuD;IACvD,IAAW,SAAS;QAClB,OAAO,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;IACjC,CAAC;IAED,IAAW,MAAM;QACf,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;IAC9B,CAAC;IAEM,IAAI;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC9B,CAAC;IAEM,KAAK;QACV,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IAC/B,CAAC;IAEM,MAAM;QACX,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;IAChC,CAAC;IAEM,yBAAyB,CAAC,gBAA2B;QAC1D,OAAO,IAAI,CAAC,QAAQ,CAAC,yBAAyB,CAAC,gBAAgB,CAAC,CAAC;IACnE,CAAC;IAED;OACG;IACI,MAAM,CAAC,yBAAyB,CAAC,gBAA2B;QACjE,mDAAmD;QACnD,OAAO,WAAW,CAAC,SAAS,CAAC,yBAAyB,CAAC,gBAAgB,CAAC,CAAC;IAC3E,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,OAA2B,EAAE,EAAE;IAChE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3D,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC1B,OAAO,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,EAAE;YAC5C,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACzB,CAAC,CAAC,CAAC;IACL,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IACd,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,EAAE;IACtC,MAAM,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;IACxD,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Backstage\n */\n\nimport * as React from \"react\";\nimport type { IconSpec } from \"@itwin/core-react\";\nimport { UiFramework } from \"../UiFramework\";\nimport type { FrameworkBackstage } from \"../framework/FrameworkBackstage\";\nimport { InternalBackstageManager } from \"./InternalBackstageManager\";\n\n/** Controls backstage.\n * @public\n * @deprecated in 4.15.0. Use {@link UiFramework.backstage} instead.\n */\nexport class BackstageManager {\n  private internal = new InternalBackstageManager();\n\n  /**\n   * Override internal implementation for a mock\n   * @internal For tests only.\n   */\n  public mockInternal(internal: InternalBackstageManager) {\n    this.internal = internal;\n  }\n\n  /** Event raised when backstage is opened or closed. */\n  public get onToggled() {\n    return this.internal.onToggled;\n  }\n\n  public get isOpen() {\n    return this.internal.isOpen;\n  }\n\n  public open() {\n    return this.internal.open();\n  }\n\n  public close() {\n    return this.internal.close();\n  }\n\n  public toggle() {\n    return this.internal.toggle();\n  }\n\n  public getBackstageToggleCommand(overrideIconSpec?: IconSpec) {\n    return this.internal.getBackstageToggleCommand(overrideIconSpec);\n  }\n\n  /** Get CommandItemDef that will toggle display of Backstage and allow iconSpec to be overridden\n   */\n  public static getBackstageToggleCommand(overrideIconSpec?: IconSpec) {\n    // eslint-disable-next-line deprecation/deprecation\n    return UiFramework.backstage.getBackstageToggleCommand(overrideIconSpec);\n  }\n}\n\n/** Hook that returns isOpen flag of the backstage.\n * @public\n */\nexport const useIsBackstageOpen = (manager: FrameworkBackstage) => {\n  const [isOpen, setIsOpen] = React.useState(manager.isOpen);\n  React.useEffect(() => {\n    setIsOpen(manager.isOpen);\n    return manager.onToggled.addListener((args) => {\n      setIsOpen(args.isOpen);\n    });\n  }, [manager]);\n  return isOpen;\n};\n\n/** Hook that returns backstage manager.\n * @public\n */\nexport const useBackstageManager = () => {\n  const [manager] = React.useState(UiFramework.backstage);\n  return manager;\n};\n"]}
+{"version":3,"file":"BackstageManager.js","sourceRoot":"","sources":["../../../../src/appui-react/backstage/BackstageManager.tsx"],"names":[],"mappings":"AAAA;;;gGAGgG;AAChG;;GAEG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAEtE;;;GAGG;AACH,MAAM,OAAO,gBAAgB;IAA7B;QACU,aAAQ,GAAG,IAAI,wBAAwB,EAAE,CAAC;IA0CpD,CAAC;IAxCC;;;OAGG;IACI,YAAY,CAAC,QAAkC;QACpD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,uDAAuD;IACvD,IAAW,SAAS;QAClB,OAAO,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;IACjC,CAAC;IAED,IAAW,MAAM;QACf,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;IAC9B,CAAC;IAEM,IAAI;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC9B,CAAC;IAEM,KAAK;QACV,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IAC/B,CAAC;IAEM,MAAM;QACX,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;IAChC,CAAC;IAED,mDAAmD;IAC5C,yBAAyB,CAAC,gBAA2B;QAC1D,OAAO,IAAI,CAAC,QAAQ,CAAC,yBAAyB,CAAC,gBAAgB,CAAC,CAAC;IACnE,CAAC;IAED,oGAAoG;IACpG,mDAAmD;IAC5C,MAAM,CAAC,yBAAyB,CAAC,gBAA2B;QACjE,mDAAmD;QACnD,OAAO,WAAW,CAAC,SAAS,CAAC,yBAAyB,CAAC,gBAAgB,CAAC,CAAC;IAC3E,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,OAA2B,EAAE,EAAE;IAChE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3D,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC1B,OAAO,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,EAAE;YAC5C,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACzB,CAAC,CAAC,CAAC;IACL,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IACd,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,EAAE;IACtC,MAAM,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;IACxD,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Backstage\n */\n\nimport * as React from \"react\";\nimport type { IconSpec } from \"@itwin/core-react\";\nimport { UiFramework } from \"../UiFramework\";\nimport type { FrameworkBackstage } from \"../framework/FrameworkBackstage\";\nimport { InternalBackstageManager } from \"./InternalBackstageManager\";\n\n/** Controls backstage.\n * @public\n * @deprecated in 4.15.0. Use {@link UiFramework.backstage} instead.\n */\nexport class BackstageManager {\n  private internal = new InternalBackstageManager();\n\n  /**\n   * Override internal implementation for a mock\n   * @internal For tests only.\n   */\n  public mockInternal(internal: InternalBackstageManager) {\n    this.internal = internal;\n  }\n\n  /** Event raised when backstage is opened or closed. */\n  public get onToggled() {\n    return this.internal.onToggled;\n  }\n\n  public get isOpen() {\n    return this.internal.isOpen;\n  }\n\n  public open() {\n    return this.internal.open();\n  }\n\n  public close() {\n    return this.internal.close();\n  }\n\n  public toggle() {\n    return this.internal.toggle();\n  }\n\n  // eslint-disable-next-line deprecation/deprecation\n  public getBackstageToggleCommand(overrideIconSpec?: IconSpec) {\n    return this.internal.getBackstageToggleCommand(overrideIconSpec);\n  }\n\n  /** Get CommandItemDef that will toggle display of Backstage and allow iconSpec to be overridden. */\n  // eslint-disable-next-line deprecation/deprecation\n  public static getBackstageToggleCommand(overrideIconSpec?: IconSpec) {\n    // eslint-disable-next-line deprecation/deprecation\n    return UiFramework.backstage.getBackstageToggleCommand(overrideIconSpec);\n  }\n}\n\n/** Hook that returns isOpen flag of the backstage.\n * @public\n */\nexport const useIsBackstageOpen = (manager: FrameworkBackstage) => {\n  const [isOpen, setIsOpen] = React.useState(manager.isOpen);\n  React.useEffect(() => {\n    setIsOpen(manager.isOpen);\n    return manager.onToggled.addListener((args) => {\n      setIsOpen(args.isOpen);\n    });\n  }, [manager]);\n  return isOpen;\n};\n\n/** Hook that returns backstage manager.\n * @public\n */\nexport const useBackstageManager = () => {\n  const [manager] = React.useState(UiFramework.backstage);\n  return manager;\n};\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"InternalBackstageManager.d.ts","sourceRoot":"","sources":["../../../../src/appui-react/backstage/InternalBackstageManager.tsx"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAE5E;;GAEG;AACH,qBAAa,wBAAwB;IACnC,OAAO,CAAC,OAAO,CAAS;IAExB,uDAAuD;IACvD,SAAgB,SAAS,iBAChB,oBAAoB,KAAK,IAAI,EAClC;IAEJ,IAAW,MAAM,YAEhB;IAED,OAAO,CAAC,SAAS;IAQV,IAAI;IAIJ,KAAK;IAIL,MAAM;IAIb,mGAAmG;IAC5F,yBAAyB,CAAC,gBAAgB,CAAC,EAAE,QAAQ;CAW7D"}
+{"version":3,"file":"InternalBackstageManager.d.ts","sourceRoot":"","sources":["../../../../src/appui-react/backstage/InternalBackstageManager.tsx"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAE5E;;GAEG;AACH,qBAAa,wBAAwB;IACnC,OAAO,CAAC,OAAO,CAAS;IAExB,uDAAuD;IACvD,SAAgB,SAAS,iBAChB,oBAAoB,KAAK,IAAI,EAClC;IAEJ,IAAW,MAAM,YAEhB;IAED,OAAO,CAAC,SAAS;IAQV,IAAI;IAIJ,KAAK;IAIL,MAAM;IAIb,mGAAmG;IAE5F,yBAAyB,CAAC,gBAAgB,CAAC,EAAE,QAAQ;CAW7D"}

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

@@ -38,6 +38,7 @@ export class InternalBackstageManager {
         this.setIsOpen(!this.isOpen);
     }
     /** Get CommandItemDef that will toggle display of Backstage and allow iconSpec to be overridden */
+    // eslint-disable-next-line deprecation/deprecation
     getBackstageToggleCommand(overrideIconSpec) {
         // eslint-disable-next-line deprecation/deprecation
         return new CommandItemDef({

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

@@ -1 +1 @@
-{"version":3,"file":"InternalBackstageManager.js","sourceRoot":"","sources":["../../../../src/appui-react/backstage/InternalBackstageManager.tsx"],"names":[],"mappings":"AAAA;;;gGAGgG;AAChG;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAE9C,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG7C;;GAEG;AACH,MAAM,OAAO,wBAAwB;IAArC;QACU,YAAO,GAAG,KAAK,CAAC;QAExB,uDAAuD;QACvC,cAAS,GAAG,IAAI,OAAO,EAEpC,CAAC;IAsCN,CAAC;IApCC,IAAW,MAAM;QACf,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAEO,SAAS,CAAC,MAAe;QAC/B,IAAI,MAAM,KAAK,IAAI,CAAC,OAAO;YAAE,OAAO;QACpC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC;YACxB,MAAM;SACP,CAAC,CAAC;IACL,CAAC;IAEM,IAAI;QACT,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACvB,CAAC;IAEM,KAAK;QACV,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;IAEM,MAAM;QACX,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;IAED,mGAAmG;IAC5F,yBAAyB,CAAC,gBAA2B;QAC1D,mDAAmD;QACnD,OAAO,IAAI,cAAc,CAAC;YACxB,SAAS,EAAE,2BAA2B;YACtC,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,WAAW;YAC3D,QAAQ,EAAE,oCAAoC;YAC9C,OAAO,EAAE,GAAG,EAAE;gBACZ,WAAW,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;YACjC,CAAC;SACF,CAAC,CAAC;IACL,CAAC;CACF","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Backstage\n */\n\nimport { BeEvent } from \"@itwin/core-bentley\";\nimport type { IconSpec } from \"@itwin/core-react\";\nimport { CommandItemDef } from \"../shared/CommandItemDef\";\nimport { UiFramework } from \"../UiFramework\";\nimport type { BackstageToggledArgs } from \"../framework/FrameworkBackstage\";\n\n/** Controls backstage.\n * @internal\n */\nexport class InternalBackstageManager {\n  private _isOpen = false;\n\n  /** Event raised when backstage is opened or closed. */\n  public readonly onToggled = new BeEvent<\n    (args: BackstageToggledArgs) => void\n  >();\n\n  public get isOpen() {\n    return this._isOpen;\n  }\n\n  private setIsOpen(isOpen: boolean) {\n    if (isOpen === this._isOpen) return;\n    this._isOpen = isOpen;\n    this.onToggled.raiseEvent({\n      isOpen,\n    });\n  }\n\n  public open() {\n    this.setIsOpen(true);\n  }\n\n  public close() {\n    this.setIsOpen(false);\n  }\n\n  public toggle() {\n    this.setIsOpen(!this.isOpen);\n  }\n\n  /** Get CommandItemDef that will toggle display of Backstage and allow iconSpec to be overridden */\n  public getBackstageToggleCommand(overrideIconSpec?: IconSpec) {\n    // eslint-disable-next-line deprecation/deprecation\n    return new CommandItemDef({\n      commandId: \"UiFramework.openBackstage\",\n      iconSpec: overrideIconSpec ? overrideIconSpec : \"icon-home\",\n      labelKey: \"UiFramework:commands.openBackstage\",\n      execute: () => {\n        UiFramework.backstage.toggle();\n      },\n    });\n  }\n}\n"]}
+{"version":3,"file":"InternalBackstageManager.js","sourceRoot":"","sources":["../../../../src/appui-react/backstage/InternalBackstageManager.tsx"],"names":[],"mappings":"AAAA;;;gGAGgG;AAChG;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAE9C,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG7C;;GAEG;AACH,MAAM,OAAO,wBAAwB;IAArC;QACU,YAAO,GAAG,KAAK,CAAC;QAExB,uDAAuD;QACvC,cAAS,GAAG,IAAI,OAAO,EAEpC,CAAC;IAuCN,CAAC;IArCC,IAAW,MAAM;QACf,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAEO,SAAS,CAAC,MAAe;QAC/B,IAAI,MAAM,KAAK,IAAI,CAAC,OAAO;YAAE,OAAO;QACpC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC;YACxB,MAAM;SACP,CAAC,CAAC;IACL,CAAC;IAEM,IAAI;QACT,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACvB,CAAC;IAEM,KAAK;QACV,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;IAEM,MAAM;QACX,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;IAED,mGAAmG;IACnG,mDAAmD;IAC5C,yBAAyB,CAAC,gBAA2B;QAC1D,mDAAmD;QACnD,OAAO,IAAI,cAAc,CAAC;YACxB,SAAS,EAAE,2BAA2B;YACtC,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,WAAW;YAC3D,QAAQ,EAAE,oCAAoC;YAC9C,OAAO,EAAE,GAAG,EAAE;gBACZ,WAAW,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;YACjC,CAAC;SACF,CAAC,CAAC;IACL,CAAC;CACF","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Backstage\n */\n\nimport { BeEvent } from \"@itwin/core-bentley\";\nimport type { IconSpec } from \"@itwin/core-react\";\nimport { CommandItemDef } from \"../shared/CommandItemDef\";\nimport { UiFramework } from \"../UiFramework\";\nimport type { BackstageToggledArgs } from \"../framework/FrameworkBackstage\";\n\n/** Controls backstage.\n * @internal\n */\nexport class InternalBackstageManager {\n  private _isOpen = false;\n\n  /** Event raised when backstage is opened or closed. */\n  public readonly onToggled = new BeEvent<\n    (args: BackstageToggledArgs) => void\n  >();\n\n  public get isOpen() {\n    return this._isOpen;\n  }\n\n  private setIsOpen(isOpen: boolean) {\n    if (isOpen === this._isOpen) return;\n    this._isOpen = isOpen;\n    this.onToggled.raiseEvent({\n      isOpen,\n    });\n  }\n\n  public open() {\n    this.setIsOpen(true);\n  }\n\n  public close() {\n    this.setIsOpen(false);\n  }\n\n  public toggle() {\n    this.setIsOpen(!this.isOpen);\n  }\n\n  /** Get CommandItemDef that will toggle display of Backstage and allow iconSpec to be overridden */\n  // eslint-disable-next-line deprecation/deprecation\n  public getBackstageToggleCommand(overrideIconSpec?: IconSpec) {\n    // eslint-disable-next-line deprecation/deprecation\n    return new CommandItemDef({\n      commandId: \"UiFramework.openBackstage\",\n      iconSpec: overrideIconSpec ? overrideIconSpec : \"icon-home\",\n      labelKey: \"UiFramework:commands.openBackstage\",\n      execute: () => {\n        UiFramework.backstage.toggle();\n      },\n    });\n  }\n}\n"]}

package/lib/esm/appui-react/childwindow/CopyStyles.d.ts

@@ -1,7 +1,4 @@
-/**
- * Copies the source CSS into the destination
- * @param targetDoc - target document
- * @param sourceDoc - source document
+/** Copies the CSS style sheets from source document into the target document.
  * @internal
  */
 export declare function copyStyles(targetDoc: Document, sourceDoc?: Document): void;

package/lib/esm/appui-react/childwindow/CopyStyles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CopyStyles.d.ts","sourceRoot":"","sources":["../../../../src/appui-react/childwindow/CopyStyles.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,SAAS,EAAE,QAAQ,EACnB,SAAS,GAAE,QAAmB,QA6B/B"}
+{"version":3,"file":"CopyStyles.d.ts","sourceRoot":"","sources":["../../../../src/appui-react/childwindow/CopyStyles.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,wBAAgB,UAAU,CACxB,SAAS,EAAE,QAAQ,EACnB,SAAS,GAAE,QAAmB,QA2B/B"}

package/lib/esm/appui-react/childwindow/CopyStyles.js

@@ -2,35 +2,31 @@
  * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
  * See LICENSE.md in the project root for license terms and full copyright notice.
  *--------------------------------------------------------------------------------------------*/
-/**
- * Copies the source CSS into the destination
- * @param targetDoc - target document
- * @param sourceDoc - source document
+/** Copies the CSS style sheets from source document into the target document.
  * @internal
  */
 export function copyStyles(targetDoc, sourceDoc = document) {
-    const stylesheets = sourceDoc.adoptedStyleSheets
-        ? Array.from([...sourceDoc.styleSheets, ...sourceDoc.adoptedStyleSheets])
-        : Array.from(sourceDoc.styleSheets);
-    stylesheets.forEach((stylesheet) => {
-        const css = stylesheet;
-        if (stylesheet.href) {
-            const newStyleElement = targetDoc.createElement("link");
-            newStyleElement.rel = "stylesheet";
-            newStyleElement.href = stylesheet.href;
-            targetDoc.head.appendChild(newStyleElement);
-        }
-        else {
-            if (css && css.cssRules && css.cssRules.length > 0) {
-                const newStyleElement = targetDoc.createElement("style");
-                Array.from(css.cssRules).forEach((rule) => {
-                    newStyleElement.appendChild(targetDoc.createTextNode(rule.cssText));
-                });
-                targetDoc.head.appendChild(newStyleElement);
-            }
-        }
+    const styleSheets = Array.from(sourceDoc.styleSheets);
+    styleSheets.forEach(({ ownerNode }) => {
+        // Copy `link` and `style` elements.
+        if (!ownerNode)
+            return;
+        const clonedNode = targetDoc.importNode(ownerNode, true);
+        targetDoc.head.appendChild(clonedNode);
     });
-    // copy sprites
+    const adoptedStyleSheets = Array.from(sourceDoc.adoptedStyleSheets ?? []);
+    adoptedStyleSheets.forEach((styleSheet) => {
+        // Adopted stylesheet have no ownerNode and can't be shared between multiple documents.
+        if (!targetDoc.defaultView)
+            return;
+        const newStyleSheet = new targetDoc.defaultView.CSSStyleSheet();
+        Array.from(styleSheet.cssRules).forEach((rule, index) => {
+            // `cssText` might not serialize complex shorthand properties correctly: https://github.com/iTwin/appui/issues/893
+            newStyleSheet.insertRule(rule.cssText, index);
+        });
+        targetDoc.adoptedStyleSheets.push(newStyleSheet);
+    });
+    // Copy sprites.
     const svgSymbolParent = sourceDoc.getElementById("__SVG_SPRITE_NODE__");
     if (svgSymbolParent) {
         targetDoc.body.appendChild(svgSymbolParent.cloneNode(true));

package/lib/esm/appui-react/childwindow/CopyStyles.js.map

@@ -1 +1 @@
-{"version":3,"file":"CopyStyles.js","sourceRoot":"","sources":["../../../../src/appui-react/childwindow/CopyStyles.ts"],"names":[],"mappings":"AAAA;;;gGAGgG;AAChG;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CACxB,SAAmB,EACnB,YAAsB,QAAQ;IAE9B,MAAM,WAAW,GAAG,SAAS,CAAC,kBAAkB;QAC9C,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC,WAAW,EAAE,GAAG,SAAS,CAAC,kBAAkB,CAAC,CAAC;QACzE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAEtC,WAAW,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE;QACjC,MAAM,GAAG,GAAG,UAAU,CAAC;QACvB,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC;YACpB,MAAM,eAAe,GAAG,SAAS,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;YACxD,eAAe,CAAC,GAAG,GAAG,YAAY,CAAC;YACnC,eAAe,CAAC,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC;YACvC,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;QAC9C,CAAC;aAAM,CAAC;YACN,IAAI,GAAG,IAAI,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACnD,MAAM,eAAe,GAAG,SAAS,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;gBACzD,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;oBACxC,eAAe,CAAC,WAAW,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;gBACtE,CAAC,CAAC,CAAC;gBACH,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;YAC9C,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,eAAe;IACf,MAAM,eAAe,GAAG,SAAS,CAAC,cAAc,CAAC,qBAAqB,CAAC,CAAC;IACxE,IAAI,eAAe,EAAE,CAAC;QACpB,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,eAAe,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9D,CAAC;AACH,CAAC","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n/**\n * Copies the source CSS into the destination\n * @param targetDoc - target document\n * @param sourceDoc - source document\n * @internal\n */\nexport function copyStyles(\n  targetDoc: Document,\n  sourceDoc: Document = document\n) {\n  const stylesheets = sourceDoc.adoptedStyleSheets\n    ? Array.from([...sourceDoc.styleSheets, ...sourceDoc.adoptedStyleSheets])\n    : Array.from(sourceDoc.styleSheets);\n\n  stylesheets.forEach((stylesheet) => {\n    const css = stylesheet;\n    if (stylesheet.href) {\n      const newStyleElement = targetDoc.createElement(\"link\");\n      newStyleElement.rel = \"stylesheet\";\n      newStyleElement.href = stylesheet.href;\n      targetDoc.head.appendChild(newStyleElement);\n    } else {\n      if (css && css.cssRules && css.cssRules.length > 0) {\n        const newStyleElement = targetDoc.createElement(\"style\");\n        Array.from(css.cssRules).forEach((rule) => {\n          newStyleElement.appendChild(targetDoc.createTextNode(rule.cssText));\n        });\n        targetDoc.head.appendChild(newStyleElement);\n      }\n    }\n  });\n\n  // copy sprites\n  const svgSymbolParent = sourceDoc.getElementById(\"__SVG_SPRITE_NODE__\");\n  if (svgSymbolParent) {\n    targetDoc.body.appendChild(svgSymbolParent.cloneNode(true));\n  }\n}\n"]}
+{"version":3,"file":"CopyStyles.js","sourceRoot":"","sources":["../../../../src/appui-react/childwindow/CopyStyles.ts"],"names":[],"mappings":"AAAA;;;gGAGgG;AAEhG;;GAEG;AACH,MAAM,UAAU,UAAU,CACxB,SAAmB,EACnB,YAAsB,QAAQ;IAE9B,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IACtD,WAAW,CAAC,OAAO,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE;QACpC,oCAAoC;QACpC,IAAI,CAAC,SAAS;YAAE,OAAO;QACvB,MAAM,UAAU,GAAG,SAAS,CAAC,UAAU,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QACzD,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,MAAM,kBAAkB,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,kBAAkB,IAAI,EAAE,CAAC,CAAC;IAC1E,kBAAkB,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE;QACxC,uFAAuF;QACvF,IAAI,CAAC,SAAS,CAAC,WAAW;YAAE,OAAO;QACnC,MAAM,aAAa,GAAG,IAAI,SAAS,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC;QAChE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;YACtD,kHAAkH;YAClH,aAAa,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;QACH,SAAS,CAAC,kBAAkB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,gBAAgB;IAChB,MAAM,eAAe,GAAG,SAAS,CAAC,cAAc,CAAC,qBAAqB,CAAC,CAAC;IACxE,IAAI,eAAe,EAAE,CAAC;QACpB,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,eAAe,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9D,CAAC;AACH,CAAC","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n\n/** Copies the CSS style sheets from source document into the target document.\n * @internal\n */\nexport function copyStyles(\n  targetDoc: Document,\n  sourceDoc: Document = document\n) {\n  const styleSheets = Array.from(sourceDoc.styleSheets);\n  styleSheets.forEach(({ ownerNode }) => {\n    // Copy `link` and `style` elements.\n    if (!ownerNode) return;\n    const clonedNode = targetDoc.importNode(ownerNode, true);\n    targetDoc.head.appendChild(clonedNode);\n  });\n\n  const adoptedStyleSheets = Array.from(sourceDoc.adoptedStyleSheets ?? []);\n  adoptedStyleSheets.forEach((styleSheet) => {\n    // Adopted stylesheet have no ownerNode and can't be shared between multiple documents.\n    if (!targetDoc.defaultView) return;\n    const newStyleSheet = new targetDoc.defaultView.CSSStyleSheet();\n    Array.from(styleSheet.cssRules).forEach((rule, index) => {\n      // `cssText` might not serialize complex shorthand properties correctly: https://github.com/iTwin/appui/issues/893\n      newStyleSheet.insertRule(rule.cssText, index);\n    });\n    targetDoc.adoptedStyleSheets.push(newStyleSheet);\n  });\n\n  // Copy sprites.\n  const svgSymbolParent = sourceDoc.getElementById(\"__SVG_SPRITE_NODE__\");\n  if (svgSymbolParent) {\n    targetDoc.body.appendChild(svgSymbolParent.cloneNode(true));\n  }\n}\n"]}

package/lib/esm/appui-react/configurableui/ConfigurableUiContent.d.ts

@@ -12,7 +12,10 @@ export declare const ConfigurableUiContext: React.Context<Pick<ConfigurableUiCon
 export interface ConfigurableUiContentProps extends CommonProps {
     /** React node of the Backstage */
     appBackstage?: React.ReactNode;
-    /** Controls if the view overlay should be displayed. Uses redux store as a fallback. Defaults to `true`. */
+    /** Controls if the view overlay should be displayed. Uses redux store as a fallback. Defaults to `true`.
+     * @note Only used by configurable control APIs. See {@link ContentProps.classId}.
+     * @deprecated in 4.16.0. View overlay visibility should be controlled by the components used in {@link ContentProps.content}.
+     */
     viewOverlay?: boolean;
     /** Describes the opacity of widgets. Uses redux store as a fallback. Defaults to {@link WIDGET_OPACITY_DEFAULT}. */
     widgetOpacity?: number;

package/lib/esm/appui-react/configurableui/ConfigurableUiContent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConfigurableUiContent.d.ts","sourceRoot":"","sources":["../../../../src/appui-react/configurableui/ConfigurableUiContent.tsx"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,8BAA8B,CAAC;AACtC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAwBrD,gBAAgB;AAChB,eAAO,MAAM,qBAAqB,wKAU7B,CAAC;AAEN;;GAEG;AAEH,MAAM,WAAW,0BAA2B,SAAQ,WAAW;IAC7D,kCAAkC;IAClC,YAAY,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC/B,4GAA4G;IAC5G,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,oHAAoH;IACpH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4GAA4G;IAC5G,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,8HAA8H;IAC9H,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,6GAA6G;IAC7G,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,sIAAsI;IACtI,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,sHAAsH;IACtH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,gBAAgB;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,4BAAkD,CAAC;AAE9E;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,0BAA0B,qBAyEtE"}
+{"version":3,"file":"ConfigurableUiContent.d.ts","sourceRoot":"","sources":["../../../../src/appui-react/configurableui/ConfigurableUiContent.tsx"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,8BAA8B,CAAC;AACtC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAyBrD,gBAAgB;AAChB,eAAO,MAAM,qBAAqB,wKAU7B,CAAC;AAEN;;GAEG;AAEH,MAAM,WAAW,0BAA2B,SAAQ,WAAW;IAC7D,kCAAkC;IAClC,YAAY,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC/B;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,oHAAoH;IACpH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4GAA4G;IAC5G,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,8HAA8H;IAC9H,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,6GAA6G;IAC7G,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,sIAAsI;IACtI,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,sHAAsH;IACtH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,gBAAgB;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,4BAAkD,CAAC;AAE9E;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,0BAA0B,qBA2EtE"}

package/lib/esm/appui-react/configurableui/ConfigurableUiContent.js

@@ -58,6 +58,7 @@ export function ConfigurableUiContent(props) {
         CursorInformation.handleMouseMove(point);
     }, []);
     return (React.createElement(ConfigurableUiContext.Provider, { value: {
+            // eslint-disable-next-line deprecation/deprecation
             viewOverlay: props.viewOverlay,
             widgetOpacity: props.widgetOpacity,
             widgetIcon: props.widgetIcon,