@itwin/appui-react 4.14.1 → 4.15.0

package/lib/esm/appui-react/theme/ThemeId.js

@@ -0,0 +1,38 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module State
+ */
+/** System preferred color theme.
+ * @public
+ */
+export const SYSTEM_PREFERRED_COLOR_THEME = "SYSTEM_PREFERRED";
+/** Enum for the Color Theme string.
+ * @public
+ */
+export var ColorTheme;
+(function (ColorTheme) {
+    /** Will use iTwinUI `light` theme. */
+    ColorTheme["Light"] = "light";
+    /** Will use iTwinUI `dark` theme. */
+    ColorTheme["Dark"] = "dark";
+    /** Will use iTwinUI `os` theme. */
+    ColorTheme["System"] = "SYSTEM_PREFERRED";
+    /** Will use iTwinUI wrapping `ThemeProvider` if provided, or default to 'Light' */
+    ColorTheme["Inherit"] = "inherit";
+    /** Will use iTwinUI `light` theme with `highContrast` set to `true` */
+    ColorTheme["HighContrastLight"] = "high-contrast-light";
+    /** Will use iTwinUI `dark` theme with `highContrast` set to `true` */
+    ColorTheme["HighContrastDark"] = "high-contrast-dark";
+})(ColorTheme || (ColorTheme = {}));
+/** The default widget opacity.
+ * @public
+ */
+export const WIDGET_OPACITY_DEFAULT = 0.9;
+/** The default widget opacity.
+ * @public
+ */
+export const TOOLBAR_OPACITY_DEFAULT = 0.5;
+//# sourceMappingURL=ThemeId.js.map

package/lib/esm/appui-react/theme/ThemeId.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThemeId.js","sourceRoot":"","sources":["../../../../src/appui-react/theme/ThemeId.ts"],"names":[],"mappings":"AAAA;;;gGAGgG;AAChG;;GAEG;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,kBAAkB,CAAC;AAE/D;;GAEG;AACH,MAAM,CAAN,IAAY,UAaX;AAbD,WAAY,UAAU;IACpB,sCAAsC;IACtC,6BAAe,CAAA;IACf,qCAAqC;IACrC,2BAAa,CAAA;IACb,mCAAmC;IACnC,yCAAqC,CAAA;IACrC,mFAAmF;IACnF,iCAAmB,CAAA;IACnB,uEAAuE;IACvE,uDAAyC,CAAA;IACzC,sEAAsE;IACtE,qDAAuC,CAAA;AACzC,CAAC,EAbW,UAAU,KAAV,UAAU,QAarB;AAQD;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAC;AAE1C;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,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 State\n */\n\nimport type { ThemeManager } from \"./ThemeManager\";\n\n/** System preferred color theme.\n * @public\n */\nexport const SYSTEM_PREFERRED_COLOR_THEME = \"SYSTEM_PREFERRED\";\n\n/** Enum for the Color Theme string.\n * @public\n */\nexport enum ColorTheme {\n  /** Will use iTwinUI `light` theme. */\n  Light = \"light\",\n  /** Will use iTwinUI `dark` theme. */\n  Dark = \"dark\",\n  /** Will use iTwinUI `os` theme. */\n  System = SYSTEM_PREFERRED_COLOR_THEME,\n  /** Will use iTwinUI wrapping `ThemeProvider` if provided, or default to 'Light' */\n  Inherit = \"inherit\",\n  /** Will use iTwinUI `light` theme with `highContrast` set to `true` */\n  HighContrastLight = \"high-contrast-light\",\n  /** Will use iTwinUI `dark` theme with `highContrast` set to `true` */\n  HighContrastDark = \"high-contrast-dark\",\n}\n\n/** Describe valid themes.\n * See {@link ThemeManager} for more information.\n * @public\n */\nexport type ThemeId = `${ColorTheme}` | (string & {});\n\n/** The default widget opacity.\n * @public\n */\nexport const WIDGET_OPACITY_DEFAULT = 0.9;\n\n/** The default widget opacity.\n * @public\n */\nexport const TOOLBAR_OPACITY_DEFAULT = 0.5;\n"]}

package/lib/esm/appui-react/theme/ThemeManager.d.ts

@@ -3,59 +3,11 @@
  */
 import "./ThemeManager.scss";
 import * as React from "react";
-/** System preferred color theme.
- * @public
- */
-export declare const SYSTEM_PREFERRED_COLOR_THEME = "SYSTEM_PREFERRED";
-/** Enum for the Color Theme string.
- * @public
- */
-export declare enum ColorTheme {
-    /** Will use iTwinUI `light` theme. */
-    Light = "light",
-    /** Will use iTwinUI `dark` theme. */
-    Dark = "dark",
-    /** Will use iTwinUI `os` theme. */
-    System = "SYSTEM_PREFERRED",
-    /** Will use iTwinUI wrapping `ThemeProvider` if provided, or default to 'Light' */
-    Inherit = "inherit",
-    /** Will use iTwinUI `light` theme with `highContrast` set to `true` */
-    HighContrastLight = "high-contrast-light",
-    /** Will use iTwinUI `dark` theme with `highContrast` set to `true` */
-    HighContrastDark = "high-contrast-dark"
-}
-/**
- * Describe valid themes.
- * See [[ThemeManager]] for more information.
- * @public
- */
-export type ThemeId = `${ColorTheme}` | (string & {});
-/** The default widget opacity.
- * @public
- */
-export declare const WIDGET_OPACITY_DEFAULT = 0.9;
-/** The default widget opacity.
- * @public
- */
-export declare const TOOLBAR_OPACITY_DEFAULT = 0.5;
-/** Properties of [[ThemeManagerComponent]].
- */
+import type { ThemeId } from "./ThemeId";
 interface ThemeManagerProps {
-    /** theme ("light", "dark", etc.) */
-    theme: ThemeId;
-    widgetOpacity: number;
     children?: React.ReactNode;
-    toolbarOpacity: number;
-}
-/** ThemeManagerComponent handles setting themes.
- */
-declare class ThemeManagerComponent extends React.Component<ThemeManagerProps> {
-    componentDidMount(): void;
-    componentDidUpdate(prevProps: ThemeManagerProps): void;
-    private _setTheme;
-    private _setWidgetOpacity;
-    private _setToolbarOpacity;
-    render(): React.ReactNode;
+    /** Uses redux store as a fallback. Defaults to {@link SYSTEM_PREFERRED_COLOR_THEME}. */
+    theme?: ThemeId;
 }
 /** ThemeManager handles setting color themes and element opacity management. Note that this component will
  * affect the entire application by setting the data-theme attribute to the html element.
@@ -66,17 +18,15 @@ declare class ThemeManagerComponent extends React.Component<ThemeManagerProps> {
  * and `ThemeProvider` theme will be set to `inherit`, in this case the application is
  * responsible for setting the theme by overriding iTwinUI css variables.
  *
- * This React component is Redux connected and should wrap [[ConfigurableUiContent]].
+ * This React component should wrap {@link ConfigurableUiContent}.
  *
  * ```tsx
- * <Provider store={UiFramework.store}>
- *   <ThemeManager>
- *     <ConfigurableUiContent />
- *   </ThemeManager>
- * </Provider>
+ * <ThemeManager>
+ *   <ConfigurableUiContent />
+ * </ThemeManager>
  * ```
  * @public
  */
-export declare const ThemeManager: import("react-redux").ConnectedComponent<typeof ThemeManagerComponent, import("react-redux").Omit<React.ClassAttributes<ThemeManagerComponent> & ThemeManagerProps, "theme" | "widgetOpacity" | "toolbarOpacity">>;
+export declare function ThemeManager({ children, ...props }: ThemeManagerProps): React.JSX.Element;
 export {};
 //# sourceMappingURL=ThemeManager.d.ts.map

package/lib/esm/appui-react/theme/ThemeManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ThemeManager.d.ts","sourceRoot":"","sources":["../../../../src/appui-react/theme/ThemeManager.tsx"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,qBAAqB,CAAC;AAC7B,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAQ/B;;GAEG;AACH,eAAO,MAAM,4BAA4B,qBAAqB,CAAC;AAE/D;;GAEG;AACH,oBAAY,UAAU;IACpB,sCAAsC;IACtC,KAAK,UAAU;IACf,qCAAqC;IACrC,IAAI,SAAS;IACb,mCAAmC;IACnC,MAAM,qBAA+B;IACrC,mFAAmF;IACnF,OAAO,YAAY;IACnB,uEAAuE;IACvE,iBAAiB,wBAAwB;IACzC,sEAAsE;IACtE,gBAAgB,uBAAuB;CACxC;AAED;;;;GAIG;AACH,MAAM,MAAM,OAAO,GAAG,GAAG,UAAU,EAAE,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAsBtD;;GAEG;AACH,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAE1C;;GAEG;AACH,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAE3C;GACG;AACH,UAAU,iBAAiB;IACzB,oCAAoC;IACpC,KAAK,EAAE,OAAO,CAAC;IAEf,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;CACxB;AAaD;GACG;AACH,cAAM,qBAAsB,SAAQ,KAAK,CAAC,SAAS,CAAC,iBAAiB,CAAC;IACpD,iBAAiB;IAMjB,kBAAkB,CAAC,SAAS,EAAE,iBAAiB;IAQ/D,OAAO,CAAC,SAAS,CAOf;IAEF,OAAO,CAAC,iBAAiB,CAWvB;IAEF,OAAO,CAAC,kBAAkB,CAWxB;IAEc,MAAM,IAAI,KAAK,CAAC,SAAS;CAsB1C;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,YAAY,oNAAkD,CAAC"}
+{"version":3,"file":"ThemeManager.d.ts","sourceRoot":"","sources":["../../../../src/appui-react/theme/ThemeManager.tsx"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,qBAAqB,CAAC;AAC7B,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqBzC,UAAU,iBAAiB;IACzB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,wFAAwF;IACxF,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAAC,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAE,EAAE,iBAAiB,qBAoCrE"}

package/lib/esm/appui-react/theme/ThemeManager.js

@@ -7,35 +7,11 @@
  */
 import "./ThemeManager.scss";
 import * as React from "react";
-import { connect } from "react-redux";
 import { ThemeProvider } from "@itwin/itwinui-react";
 import { ThemeProvider as ThemeProviderV2 } from "@itwin/itwinui-react-v2";
-import { UiFramework } from "../UiFramework";
-/** System preferred color theme.
- * @public
- */
-export const SYSTEM_PREFERRED_COLOR_THEME = "SYSTEM_PREFERRED";
-/** Enum for the Color Theme string.
- * @public
- */
-export var ColorTheme;
-(function (ColorTheme) {
-    /** Will use iTwinUI `light` theme. */
-    ColorTheme["Light"] = "light";
-    /** Will use iTwinUI `dark` theme. */
-    ColorTheme["Dark"] = "dark";
-    /** Will use iTwinUI `os` theme. */
-    ColorTheme["System"] = "SYSTEM_PREFERRED";
-    /** Will use iTwinUI wrapping `ThemeProvider` if provided, or default to 'Light' */
-    ColorTheme["Inherit"] = "inherit";
-    /** Will use iTwinUI `light` theme with `highContrast` set to `true` */
-    ColorTheme["HighContrastLight"] = "high-contrast-light";
-    /** Will use iTwinUI `dark` theme with `highContrast` set to `true` */
-    ColorTheme["HighContrastDark"] = "high-contrast-dark";
-})(ColorTheme || (ColorTheme = {}));
-/**
- * Map of ColorTheme to ThemeType
- */
+import { ColorTheme, SYSTEM_PREFERRED_COLOR_THEME } from "./ThemeId";
+import { useReduxFrameworkState } from "../uistate/useReduxFrameworkState";
+/** Map of ColorTheme to ThemeType. */
 const colorThemeToThemeTypeMap = {
     [ColorTheme.Light]: "light",
     [ColorTheme.HighContrastLight]: "light",
@@ -44,76 +20,11 @@ const colorThemeToThemeTypeMap = {
     [ColorTheme.System]: "os",
     os: "os", // handle "os" for backwards compatibility
 };
-/**
- * List of high contrast color themes
- */
+/** List of high contrast color themes. */
 const highContrastColorThemes = [
     ColorTheme.HighContrastDark,
     ColorTheme.HighContrastLight,
 ];
-/** The default widget opacity.
- * @public
- */
-export const WIDGET_OPACITY_DEFAULT = 0.9;
-/** The default widget opacity.
- * @public
- */
-export const TOOLBAR_OPACITY_DEFAULT = 0.5;
-function mapStateToProps(state) {
-    const frameworkState = state[UiFramework.frameworkStateKey]; // since app sets up key, don't hard-code name
-    if (!frameworkState)
-        return undefined;
-    return {
-        theme: frameworkState.configurableUiState.theme,
-        widgetOpacity: frameworkState.configurableUiState.widgetOpacity,
-        toolbarOpacity: frameworkState.configurableUiState.toolbarOpacity,
-    };
-}
-/** ThemeManagerComponent handles setting themes.
- */
-class ThemeManagerComponent extends React.Component {
-    constructor() {
-        super(...arguments);
-        this._setTheme = (theme) => {
-            document.documentElement.classList.add("theme-transition");
-            document.documentElement.setAttribute("data-theme", theme);
-            window.setTimeout(() => document.documentElement.classList.remove("theme-transition"), 1000);
-        };
-        this._setWidgetOpacity = (opacity) => {
-            const currentWidgetOpacity = document.documentElement.style.getPropertyValue("--buic-widget-opacity");
-            if (currentWidgetOpacity !== opacity.toString()) {
-                setTimeout(() => document.documentElement.style.setProperty("--buic-widget-opacity", opacity.toString()));
-            }
-        };
-        this._setToolbarOpacity = (opacity) => {
-            const currentToolbarOpacity = document.documentElement.style.getPropertyValue("--buic-toolbar-opacity");
-            if (currentToolbarOpacity !== opacity.toString()) {
-                setTimeout(() => {
-                    document.documentElement.style.setProperty("--buic-toolbar-opacity", opacity.toString());
-                });
-            }
-        };
-    }
-    componentDidMount() {
-        this._setTheme(this.props.theme);
-        this._setWidgetOpacity(this.props.widgetOpacity);
-        this._setToolbarOpacity(this.props.toolbarOpacity);
-    }
-    componentDidUpdate(prevProps) {
-        if (this.props.theme !== prevProps.theme)
-            this._setTheme(this.props.theme);
-        if (this.props.widgetOpacity !== prevProps.widgetOpacity)
-            this._setWidgetOpacity(this.props.widgetOpacity);
-        if (this.props.toolbarOpacity !== prevProps.toolbarOpacity)
-            this._setToolbarOpacity(this.props.toolbarOpacity);
-    }
-    render() {
-        const theme = colorThemeToThemeTypeMap[this.props.theme];
-        const highContrast = highContrastColorThemes.includes(this.props.theme);
-        return (React.createElement(ThemeProvider, { className: "uifw-root", theme: theme ?? "inherit", themeOptions: { highContrast }, "data-root-container": "appui-root-id", includeCss: true },
-            React.createElement(ThemeProviderV2 /* v2 ThemeProvider is required to fix popup styling issues in widget popouts. */, { style: { height: "100%" }, theme: theme ?? "inherit", themeOptions: { highContrast } }, this.props.children)));
-    }
-}
 /** ThemeManager handles setting color themes and element opacity management. Note that this component will
  * affect the entire application by setting the data-theme attribute to the html element.
  * It also sets an iTwinUI `ThemeProvider` element locally, so all elements
@@ -123,16 +34,29 @@ class ThemeManagerComponent extends React.Component {
  * and `ThemeProvider` theme will be set to `inherit`, in this case the application is
  * responsible for setting the theme by overriding iTwinUI css variables.
  *
- * This React component is Redux connected and should wrap [[ConfigurableUiContent]].
+ * This React component should wrap {@link ConfigurableUiContent}.
  *
  * ```tsx
- * <Provider store={UiFramework.store}>
- *   <ThemeManager>
- *     <ConfigurableUiContent />
- *   </ThemeManager>
- * </Provider>
+ * <ThemeManager>
+ *   <ConfigurableUiContent />
+ * </ThemeManager>
  * ```
  * @public
  */
-export const ThemeManager = connect(mapStateToProps)(ThemeManagerComponent);
+export function ThemeManager({ children, ...props }) {
+    const reduxTheme = useReduxFrameworkState((state) => {
+        // eslint-disable-next-line deprecation/deprecation
+        return state?.configurableUiState.theme;
+    });
+    const theme = props.theme ?? reduxTheme ?? SYSTEM_PREFERRED_COLOR_THEME;
+    React.useEffect(() => {
+        document.documentElement.classList.add("theme-transition");
+        document.documentElement.setAttribute("data-theme", theme);
+        setTimeout(() => document.documentElement.classList.remove("theme-transition"), 1000);
+    }, [theme]);
+    const providerTheme = colorThemeToThemeTypeMap[theme];
+    const highContrast = highContrastColorThemes.includes(theme);
+    return (React.createElement(ThemeProvider, { className: "uifw-root", theme: providerTheme ?? "inherit", themeOptions: { highContrast }, "data-root-container": "appui-root-id", includeCss: true },
+        React.createElement(ThemeProviderV2 /* v2 ThemeProvider is required to fix popup styling issues in widget popouts. */, { style: { height: "100%" }, theme: providerTheme ?? "inherit", themeOptions: { highContrast } }, children)));
+}
 //# sourceMappingURL=ThemeManager.js.map

package/lib/esm/appui-react/theme/ThemeManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"ThemeManager.js","sourceRoot":"","sources":["../../../../src/appui-react/theme/ThemeManager.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 State\n */\n\nimport \"./ThemeManager.scss\";\nimport * as React from \"react\";\nimport { connect } from \"react-redux\";\nimport type { ThemeType } from \"@itwin/itwinui-react\";\nimport { ThemeProvider } from \"@itwin/itwinui-react\";\nimport { ThemeProvider as ThemeProviderV2 } from \"@itwin/itwinui-react-v2\";\nimport type { FrameworkState } from \"../redux/FrameworkState\";\nimport { UiFramework } from \"../UiFramework\";\n\n/** System preferred color theme.\n * @public\n */\nexport const SYSTEM_PREFERRED_COLOR_THEME = \"SYSTEM_PREFERRED\";\n\n/** Enum for the Color Theme string.\n * @public\n */\nexport enum ColorTheme {\n  /** Will use iTwinUI `light` theme. */\n  Light = \"light\",\n  /** Will use iTwinUI `dark` theme. */\n  Dark = \"dark\",\n  /** Will use iTwinUI `os` theme. */\n  System = SYSTEM_PREFERRED_COLOR_THEME,\n  /** Will use iTwinUI wrapping `ThemeProvider` if provided, or default to 'Light' */\n  Inherit = \"inherit\",\n  /** Will use iTwinUI `light` theme with `highContrast` set to `true` */\n  HighContrastLight = \"high-contrast-light\",\n  /** Will use iTwinUI `dark` theme with `highContrast` set to `true` */\n  HighContrastDark = \"high-contrast-dark\",\n}\n\n/**\n * Describe valid themes.\n * See [[ThemeManager]] for more information.\n * @public\n */\nexport type ThemeId = `${ColorTheme}` | (string & {});\n\n/**\n * Map of ColorTheme to ThemeType\n */\nconst colorThemeToThemeTypeMap: { [x: string]: ThemeType } = {\n  [ColorTheme.Light]: \"light\",\n  [ColorTheme.HighContrastLight]: \"light\",\n  [ColorTheme.Dark]: \"dark\",\n  [ColorTheme.HighContrastDark]: \"dark\",\n  [ColorTheme.System]: \"os\",\n  os: \"os\", // handle \"os\" for backwards compatibility\n};\n\n/**\n * List of high contrast color themes\n */\nconst highContrastColorThemes: string[] = [\n  ColorTheme.HighContrastDark,\n  ColorTheme.HighContrastLight,\n];\n\n/** The default widget opacity.\n * @public\n */\nexport const WIDGET_OPACITY_DEFAULT = 0.9;\n\n/** The default widget opacity.\n * @public\n */\nexport const TOOLBAR_OPACITY_DEFAULT = 0.5;\n\n/** Properties of [[ThemeManagerComponent]].\n */\ninterface ThemeManagerProps {\n  /** theme (\"light\", \"dark\", etc.) */\n  theme: ThemeId;\n  /* Widget Opacity */\n  widgetOpacity: number;\n  children?: React.ReactNode;\n  toolbarOpacity: number;\n}\n\nfunction mapStateToProps(state: any) {\n  const frameworkState = state[UiFramework.frameworkStateKey] as FrameworkState; // since app sets up key, don't hard-code name\n  if (!frameworkState) return undefined;\n\n  return {\n    theme: frameworkState.configurableUiState.theme,\n    widgetOpacity: frameworkState.configurableUiState.widgetOpacity,\n    toolbarOpacity: frameworkState.configurableUiState.toolbarOpacity,\n  };\n}\n\n/** ThemeManagerComponent handles setting themes.\n */\nclass ThemeManagerComponent extends React.Component<ThemeManagerProps> {\n  public override componentDidMount() {\n    this._setTheme(this.props.theme);\n    this._setWidgetOpacity(this.props.widgetOpacity);\n    this._setToolbarOpacity(this.props.toolbarOpacity);\n  }\n\n  public override componentDidUpdate(prevProps: ThemeManagerProps) {\n    if (this.props.theme !== prevProps.theme) this._setTheme(this.props.theme);\n    if (this.props.widgetOpacity !== prevProps.widgetOpacity)\n      this._setWidgetOpacity(this.props.widgetOpacity);\n    if (this.props.toolbarOpacity !== prevProps.toolbarOpacity)\n      this._setToolbarOpacity(this.props.toolbarOpacity);\n  }\n\n  private _setTheme = (theme: string) => {\n    document.documentElement.classList.add(\"theme-transition\");\n    document.documentElement.setAttribute(\"data-theme\", theme);\n    window.setTimeout(\n      () => document.documentElement.classList.remove(\"theme-transition\"),\n      1000\n    );\n  };\n\n  private _setWidgetOpacity = (opacity: number) => {\n    const currentWidgetOpacity =\n      document.documentElement.style.getPropertyValue(\"--buic-widget-opacity\");\n    if (currentWidgetOpacity !== opacity.toString()) {\n      setTimeout(() =>\n        document.documentElement.style.setProperty(\n          \"--buic-widget-opacity\",\n          opacity.toString()\n        )\n      );\n    }\n  };\n\n  private _setToolbarOpacity = (opacity: number) => {\n    const currentToolbarOpacity =\n      document.documentElement.style.getPropertyValue(\"--buic-toolbar-opacity\");\n    if (currentToolbarOpacity !== opacity.toString()) {\n      setTimeout(() => {\n        document.documentElement.style.setProperty(\n          \"--buic-toolbar-opacity\",\n          opacity.toString()\n        );\n      });\n    }\n  };\n\n  public override render(): React.ReactNode {\n    const theme = colorThemeToThemeTypeMap[this.props.theme];\n    const highContrast = highContrastColorThemes.includes(this.props.theme);\n\n    return (\n      <ThemeProvider\n        className=\"uifw-root\"\n        theme={theme ?? \"inherit\"}\n        themeOptions={{ highContrast }}\n        data-root-container=\"appui-root-id\"\n        includeCss={true}\n      >\n        <ThemeProviderV2 /* v2 ThemeProvider is required to fix popup styling issues in widget popouts. */\n          style={{ height: \"100%\" }}\n          theme={theme ?? \"inherit\"}\n          themeOptions={{ highContrast }}\n        >\n          {this.props.children}\n        </ThemeProviderV2>\n      </ThemeProvider>\n    );\n  }\n}\n\n/** ThemeManager handles setting color themes and element opacity management. Note that this component will\n * affect the entire application by setting the data-theme attribute to the html element.\n * It also sets an iTwinUI `ThemeProvider` element locally, so all elements\n * within the AppUI tree will have the same theme, and should be using iTwinUI 2.x or later.\n * A `ColorTheme` enum values will configure iTwinUI `ThemeProvider` accordingly.\n * Any other string will only apply the `data-theme` attribute to the `html` element\n * and `ThemeProvider` theme will be set to `inherit`, in this case the application is\n * responsible for setting the theme by overriding iTwinUI css variables.\n *\n * This React component is Redux connected and should wrap [[ConfigurableUiContent]].\n *\n * ```tsx\n * <Provider store={UiFramework.store}>\n *   <ThemeManager>\n *     <ConfigurableUiContent />\n *   </ThemeManager>\n * </Provider>\n * ```\n * @public\n */\nexport const ThemeManager = connect(mapStateToProps)(ThemeManagerComponent);\n"]}
+{"version":3,"file":"ThemeManager.js","sourceRoot":"","sources":["../../../../src/appui-react/theme/ThemeManager.tsx"],"names":[],"mappings":"AAAA;;;gGAGgG;AAChG;;GAEG;AAEH,OAAO,qBAAqB,CAAC;AAC7B,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,IAAI,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE3E,OAAO,EAAE,UAAU,EAAE,4BAA4B,EAAE,MAAM,WAAW,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAG3E,sCAAsC;AACtC,MAAM,wBAAwB,GAA+B;IAC3D,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,OAAO;IAC3B,CAAC,UAAU,CAAC,iBAAiB,CAAC,EAAE,OAAO;IACvC,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM;IACzB,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,MAAM;IACrC,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,IAAI;IACzB,EAAE,EAAE,IAAI,EAAE,0CAA0C;CACrD,CAAC;AAEF,0CAA0C;AAC1C,MAAM,uBAAuB,GAAa;IACxC,UAAU,CAAC,gBAAgB;IAC3B,UAAU,CAAC,iBAAiB;CAC7B,CAAC;AAQF;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,YAAY,CAAC,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAqB;IACpE,MAAM,UAAU,GAAG,sBAAsB,CAAC,CAAC,KAAK,EAAE,EAAE;QAClD,mDAAmD;QACnD,OAAO,KAAK,EAAE,mBAAmB,CAAC,KAAK,CAAC;IAC1C,CAAC,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,UAAU,IAAI,4BAA4B,CAAC;IAExE,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,QAAQ,CAAC,eAAe,CAAC,SAAS,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;QAC3D,QAAQ,CAAC,eAAe,CAAC,YAAY,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;QAC3D,UAAU,CACR,GAAG,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC,SAAS,CAAC,MAAM,CAAC,kBAAkB,CAAC,EACnE,IAAI,CACL,CAAC;IACJ,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAEZ,MAAM,aAAa,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAAC;IACtD,MAAM,YAAY,GAAG,uBAAuB,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAE7D,OAAO,CACL,oBAAC,aAAa,IACZ,SAAS,EAAC,WAAW,EACrB,KAAK,EAAE,aAAa,IAAI,SAAS,EACjC,YAAY,EAAE,EAAE,YAAY,EAAE,yBACV,eAAe,EACnC,UAAU,EAAE,IAAI;QAEhB,oBAAC,eAAe,CAAC,iFAAiF,IAChG,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,EACzB,KAAK,EAAE,aAAa,IAAI,SAAS,EACjC,YAAY,EAAE,EAAE,YAAY,EAAE,IAE7B,QAAQ,CACO,CACJ,CACjB,CAAC;AACJ,CAAC","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module State\n */\n\nimport \"./ThemeManager.scss\";\nimport * as React from \"react\";\nimport type { ThemeType } from \"@itwin/itwinui-react\";\nimport { ThemeProvider } from \"@itwin/itwinui-react\";\nimport { ThemeProvider as ThemeProviderV2 } from \"@itwin/itwinui-react-v2\";\nimport type { ThemeId } from \"./ThemeId\";\nimport { ColorTheme, SYSTEM_PREFERRED_COLOR_THEME } from \"./ThemeId\";\nimport { useReduxFrameworkState } from \"../uistate/useReduxFrameworkState\";\nimport type { ConfigurableUiContent } from \"../configurableui/ConfigurableUiContent\";\n\n/** Map of ColorTheme to ThemeType. */\nconst colorThemeToThemeTypeMap: { [x: string]: ThemeType } = {\n  [ColorTheme.Light]: \"light\",\n  [ColorTheme.HighContrastLight]: \"light\",\n  [ColorTheme.Dark]: \"dark\",\n  [ColorTheme.HighContrastDark]: \"dark\",\n  [ColorTheme.System]: \"os\",\n  os: \"os\", // handle \"os\" for backwards compatibility\n};\n\n/** List of high contrast color themes. */\nconst highContrastColorThemes: string[] = [\n  ColorTheme.HighContrastDark,\n  ColorTheme.HighContrastLight,\n];\n\ninterface ThemeManagerProps {\n  children?: React.ReactNode;\n  /** Uses redux store as a fallback. Defaults to {@link SYSTEM_PREFERRED_COLOR_THEME}. */\n  theme?: ThemeId;\n}\n\n/** ThemeManager handles setting color themes and element opacity management. Note that this component will\n * affect the entire application by setting the data-theme attribute to the html element.\n * It also sets an iTwinUI `ThemeProvider` element locally, so all elements\n * within the AppUI tree will have the same theme, and should be using iTwinUI 2.x or later.\n * A `ColorTheme` enum values will configure iTwinUI `ThemeProvider` accordingly.\n * Any other string will only apply the `data-theme` attribute to the `html` element\n * and `ThemeProvider` theme will be set to `inherit`, in this case the application is\n * responsible for setting the theme by overriding iTwinUI css variables.\n *\n * This React component should wrap {@link ConfigurableUiContent}.\n *\n * ```tsx\n * <ThemeManager>\n *   <ConfigurableUiContent />\n * </ThemeManager>\n * ```\n * @public\n */\nexport function ThemeManager({ children, ...props }: ThemeManagerProps) {\n  const reduxTheme = useReduxFrameworkState((state) => {\n    // eslint-disable-next-line deprecation/deprecation\n    return state?.configurableUiState.theme;\n  });\n  const theme = props.theme ?? reduxTheme ?? SYSTEM_PREFERRED_COLOR_THEME;\n\n  React.useEffect(() => {\n    document.documentElement.classList.add(\"theme-transition\");\n    document.documentElement.setAttribute(\"data-theme\", theme);\n    setTimeout(\n      () => document.documentElement.classList.remove(\"theme-transition\"),\n      1000\n    );\n  }, [theme]);\n\n  const providerTheme = colorThemeToThemeTypeMap[theme];\n  const highContrast = highContrastColorThemes.includes(theme);\n\n  return (\n    <ThemeProvider\n      className=\"uifw-root\"\n      theme={providerTheme ?? \"inherit\"}\n      themeOptions={{ highContrast }}\n      data-root-container=\"appui-root-id\"\n      includeCss={true}\n    >\n      <ThemeProviderV2 /* v2 ThemeProvider is required to fix popup styling issues in widget popouts. */\n        style={{ height: \"100%\" }}\n        theme={providerTheme ?? \"inherit\"}\n        themeOptions={{ highContrast }}\n      >\n        {children}\n      </ThemeProviderV2>\n    </ThemeProvider>\n  );\n}\n"]}

package/lib/esm/appui-react/toolbar/GroupItem.d.ts

@@ -8,6 +8,7 @@ import type { GroupItemProps } from "../shared/GroupItemProps";
 import type { ItemDefBase } from "../shared/ItemDefBase";
 /** An Item that opens a group of items.
  * @public
+ * @deprecated in 4.15.0. Use specific item types instead, i.e. {@link ToolbarGroupItem}.
  */
 export declare class GroupItemDef extends ActionButtonItemDef {
     private static _sId;

package/lib/esm/appui-react/toolbar/GroupItem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GroupItem.d.ts","sourceRoot":"","sources":["../../../../src/appui-react/toolbar/GroupItem.tsx"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,KAAK,EACV,sBAAsB,EACtB,kBAAkB,EAClB,YAAY,EACb,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAQzD;;GAEG;AACH,qBAAa,YAAa,SAAQ,mBAAmB;IACnD,OAAO,CAAC,MAAM,CAAC,IAAI,CAAK;IACxB,OAAc,aAAa,SAAY;IAEhC,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAEpC,gBAAgB;IACT,QAAQ,EAAE,OAAO,CAAS;IAEjC,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,WAAW,CAAsD;gBAGvE,cAAc,EAAE,cAAc,EAC9B,cAAc,CAAC,EAAE,kBAAkB;IAwBrC,IAAW,EAAE,IAAI,MAAM,CAEtB;IAED,gCAAgC;IAChC,IAAW,UAAU,IAAI,MAAM,CAE9B;IAED;;OAEG;IACI,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,sBAAsB;IAI/D,YAAY,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI;IAanC,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIhD,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAI7D,IAAW,SAAS,IAAI,MAAM,CAE7B;IAEe,OAAO,IAAI,IAAI;CAChC"}
+{"version":3,"file":"GroupItem.d.ts","sourceRoot":"","sources":["../../../../src/appui-react/toolbar/GroupItem.tsx"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,KAAK,EACV,sBAAsB,EACtB,kBAAkB,EAClB,YAAY,EACb,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAOzD;;;GAGG;AACH,qBAAa,YAAa,SAAQ,mBAAmB;IACnD,OAAO,CAAC,MAAM,CAAC,IAAI,CAAK;IACxB,OAAc,aAAa,SAAY;IAEhC,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAEpC,gBAAgB;IACT,QAAQ,EAAE,OAAO,CAAS;IAEjC,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,WAAW,CAAsD;gBAGvE,cAAc,EAAE,cAAc,EAC9B,cAAc,CAAC,EAAE,kBAAkB;IAwBrC,IAAW,EAAE,IAAI,MAAM,CAEtB;IAED,gCAAgC;IAChC,IAAW,UAAU,IAAI,MAAM,CAE9B;IAED;;OAEG;IACI,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,sBAAsB;IAI/D,YAAY,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI;IAanC,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIhD,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAI7D,IAAW,SAAS,IAAI,MAAM,CAE7B;IAEe,OAAO,IAAI,IAAI;CAChC"}

package/lib/esm/appui-react/toolbar/GroupItem.js

@@ -8,11 +8,10 @@
 import { ActionButtonItemDef } from "../shared/ActionButtonItemDef";
 import { ItemList, ItemMap } from "../shared/ItemMap";
 import { PropsHelper } from "../utils/PropsHelper";
-// -----------------------------------------------------------------------------
-// GroupItemDef class
-// -----------------------------------------------------------------------------
+/* eslint-disable deprecation/deprecation */
 /** An Item that opens a group of items.
  * @public
+ * @deprecated in 4.15.0. Use specific item types instead, i.e. {@link ToolbarGroupItem}.
  */
 export class GroupItemDef extends ActionButtonItemDef {
     constructor(groupItemProps, onItemExecuted) {

package/lib/esm/appui-react/toolbar/GroupItem.js.map

@@ -1 +1 @@
-{"version":3,"file":"GroupItem.js","sourceRoot":"","sources":["../../../../src/appui-react/toolbar/GroupItem.tsx"],"names":[],"mappings":"AAAA;;;gGAGgG;AAChG;;GAEG;AAOH,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAIpE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,gFAAgF;AAChF,qBAAqB;AACrB,gFAAgF;AAEhF;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,mBAAmB;IAgBnD,YACE,cAA8B,EAC9B,cAAmC;QAEnC,KAAK,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC;QAXxC,gBAAgB;QACT,aAAQ,GAAY,KAAK,CAAC;QAIzB,gBAAW,GAAmD,EAAE,CAAC;QAQvE,IAAI,CAAC,OAAO;YACV,cAAc,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QACrE,IAAI,cAAc,CAAC,OAAO;YAAE,IAAI,CAAC,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC;aAC7D,CAAC;YACJ,YAAY,CAAC,IAAI,EAAE,CAAC;YACpB,IAAI,CAAC,OAAO,GAAG,YAAY,CAAC,aAAa,GAAG,YAAY,CAAC,IAAI,CAAC;QAChE,CAAC;QAED,IAAI,CAAC,aAAa;YAChB,cAAc,CAAC,aAAa,KAAK,SAAS;gBACxC,CAAC,CAAC,cAAc,CAAC,aAAa;gBAC9B,CAAC,CAAC,CAAC,CAAC;QACR,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC,aAAa,CAC1C,cAAc,CAAC,UAAU,EACzB,cAAc,CAAC,aAAa,CAC7B,CAAC;QACF,IAAI,CAAC,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC;QAClC,IAAI,CAAC,mBAAmB,GAAG,cAAc,CAAC,mBAAmB,CAAC;IAChE,CAAC;IAED,IAAW,EAAE;QACX,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,gCAAgC;IAChC,IAAW,UAAU;QACnB,OAAO,WAAW,CAAC,iBAAiB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACzD,CAAC;IAED;;OAEG;IACI,aAAa,CAAC,CAAiD;QACpE,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC;IACvB,CAAC;IAEM,YAAY,CAAC,KAAe;QACjC,IAAI,IAAI,CAAC,SAAS,IAAI,CAAC,KAAK;YAAE,OAAO;QAErC,IAAI,CAAC,SAAS,GAAG,IAAI,QAAQ,EAAE,CAAC;QAChC,IAAI,CAAC,QAAQ,GAAG,IAAI,OAAO,EAAE,CAAC;QAE9B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAgB,EAAE,EAAE;YAClC,MAAM,EAAE,GAAW,IAAI,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC7B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QAC9B,CAAC,CAAC,CAAC;IACL,CAAC;IAEM,WAAW,CAAC,EAAU;QAC3B,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC/B,CAAC;IAEM,cAAc,CAAC,KAAa;QACjC,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;IAED,IAAW,SAAS;QAClB,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC;IACrC,CAAC;IAEe,OAAO,KAAU,CAAC;;AAlFnB,iBAAI,GAAG,CAAC,AAAJ,CAAK;AACV,0BAAa,GAAG,QAAQ,AAAX,CAAY","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 Item\n */\n\nimport type {\n  ConditionalStringValue,\n  OnItemExecutedFunc,\n  StringGetter,\n} from \"@itwin/appui-abstract\";\nimport { ActionButtonItemDef } from \"../shared/ActionButtonItemDef\";\nimport type { AnyItemDef } from \"../shared/AnyItemDef\";\nimport type { GroupItemProps } from \"../shared/GroupItemProps\";\nimport type { ItemDefBase } from \"../shared/ItemDefBase\";\nimport { ItemList, ItemMap } from \"../shared/ItemMap\";\nimport { PropsHelper } from \"../utils/PropsHelper\";\n\n// -----------------------------------------------------------------------------\n// GroupItemDef class\n// -----------------------------------------------------------------------------\n\n/** An Item that opens a group of items.\n * @public\n */\nexport class GroupItemDef extends ActionButtonItemDef {\n  private static _sId = 0;\n  public static groupIdPrefix = \"Group-\";\n\n  public groupId: string;\n  public itemsInColumn: number;\n  public items: AnyItemDef[];\n  public defaultActiveItemId?: string;\n\n  /** @internal */\n  public overflow: boolean = false;\n\n  private _itemList!: ItemList;\n  private _itemMap!: ItemMap;\n  private _panelLabel: string | StringGetter | ConditionalStringValue = \"\";\n\n  constructor(\n    groupItemProps: GroupItemProps,\n    onItemExecuted?: OnItemExecutedFunc\n  ) {\n    super(groupItemProps, onItemExecuted);\n\n    this.groupId =\n      groupItemProps.groupId !== undefined ? groupItemProps.groupId : \"\";\n    if (groupItemProps.groupId) this.groupId = groupItemProps.groupId;\n    else {\n      GroupItemDef._sId++;\n      this.groupId = GroupItemDef.groupIdPrefix + GroupItemDef._sId;\n    }\n\n    this.itemsInColumn =\n      groupItemProps.itemsInColumn !== undefined\n        ? groupItemProps.itemsInColumn\n        : 7;\n    this._panelLabel = PropsHelper.getStringSpec(\n      groupItemProps.panelLabel,\n      groupItemProps.panelLabelKey\n    );\n    this.items = groupItemProps.items;\n    this.defaultActiveItemId = groupItemProps.defaultActiveItemId;\n  }\n\n  public get id(): string {\n    return this.groupId;\n  }\n\n  /** Get the panelLabel string */\n  public get panelLabel(): string {\n    return PropsHelper.getStringFromSpec(this._panelLabel);\n  }\n\n  /** Set the panelLabel.\n   * @param v A string or a function to get the string.\n   */\n  public setPanelLabel(v: string | StringGetter | ConditionalStringValue) {\n    this._panelLabel = v;\n  }\n\n  public resolveItems(force?: boolean): void {\n    if (this._itemList && !force) return;\n\n    this._itemList = new ItemList();\n    this._itemMap = new ItemMap();\n\n    this.items.map((item: AnyItemDef) => {\n      const id: string = item.id;\n      this._itemList.addItem(item);\n      this._itemMap.set(id, item);\n    });\n  }\n\n  public getItemById(id: string): ItemDefBase | undefined {\n    return this._itemMap.get(id);\n  }\n\n  public getItemByIndex(index: number): ItemDefBase | undefined {\n    return this._itemList.items[index];\n  }\n\n  public get itemCount(): number {\n    return this._itemList.items.length;\n  }\n\n  public override execute(): void {}\n}\n"]}
+{"version":3,"file":"GroupItem.js","sourceRoot":"","sources":["../../../../src/appui-react/toolbar/GroupItem.tsx"],"names":[],"mappings":"AAAA;;;gGAGgG;AAChG;;GAEG;AAOH,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAIpE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGnD,4CAA4C;AAE5C;;;GAGG;AACH,MAAM,OAAO,YAAa,SAAQ,mBAAmB;IAgBnD,YACE,cAA8B,EAC9B,cAAmC;QAEnC,KAAK,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC;QAXxC,gBAAgB;QACT,aAAQ,GAAY,KAAK,CAAC;QAIzB,gBAAW,GAAmD,EAAE,CAAC;QAQvE,IAAI,CAAC,OAAO;YACV,cAAc,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QACrE,IAAI,cAAc,CAAC,OAAO;YAAE,IAAI,CAAC,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC;aAC7D,CAAC;YACJ,YAAY,CAAC,IAAI,EAAE,CAAC;YACpB,IAAI,CAAC,OAAO,GAAG,YAAY,CAAC,aAAa,GAAG,YAAY,CAAC,IAAI,CAAC;QAChE,CAAC;QAED,IAAI,CAAC,aAAa;YAChB,cAAc,CAAC,aAAa,KAAK,SAAS;gBACxC,CAAC,CAAC,cAAc,CAAC,aAAa;gBAC9B,CAAC,CAAC,CAAC,CAAC;QACR,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC,aAAa,CAC1C,cAAc,CAAC,UAAU,EACzB,cAAc,CAAC,aAAa,CAC7B,CAAC;QACF,IAAI,CAAC,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC;QAClC,IAAI,CAAC,mBAAmB,GAAG,cAAc,CAAC,mBAAmB,CAAC;IAChE,CAAC;IAED,IAAW,EAAE;QACX,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,gCAAgC;IAChC,IAAW,UAAU;QACnB,OAAO,WAAW,CAAC,iBAAiB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACzD,CAAC;IAED;;OAEG;IACI,aAAa,CAAC,CAAiD;QACpE,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC;IACvB,CAAC;IAEM,YAAY,CAAC,KAAe;QACjC,IAAI,IAAI,CAAC,SAAS,IAAI,CAAC,KAAK;YAAE,OAAO;QAErC,IAAI,CAAC,SAAS,GAAG,IAAI,QAAQ,EAAE,CAAC;QAChC,IAAI,CAAC,QAAQ,GAAG,IAAI,OAAO,EAAE,CAAC;QAE9B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAgB,EAAE,EAAE;YAClC,MAAM,EAAE,GAAW,IAAI,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC7B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QAC9B,CAAC,CAAC,CAAC;IACL,CAAC;IAEM,WAAW,CAAC,EAAU;QAC3B,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC/B,CAAC;IAEM,cAAc,CAAC,KAAa;QACjC,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;IAED,IAAW,SAAS;QAClB,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC;IACrC,CAAC;IAEe,OAAO,KAAU,CAAC;;AAlFnB,iBAAI,GAAG,CAAC,AAAJ,CAAK;AACV,0BAAa,GAAG,QAAQ,AAAX,CAAY","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 Item\n */\n\nimport type {\n  ConditionalStringValue,\n  OnItemExecutedFunc,\n  StringGetter,\n} from \"@itwin/appui-abstract\";\nimport { ActionButtonItemDef } from \"../shared/ActionButtonItemDef\";\nimport type { AnyItemDef } from \"../shared/AnyItemDef\";\nimport type { GroupItemProps } from \"../shared/GroupItemProps\";\nimport type { ItemDefBase } from \"../shared/ItemDefBase\";\nimport { ItemList, ItemMap } from \"../shared/ItemMap\";\nimport { PropsHelper } from \"../utils/PropsHelper\";\nimport type { ToolbarGroupItem } from \"./ToolbarItem\";\n\n/* eslint-disable deprecation/deprecation */\n\n/** An Item that opens a group of items.\n * @public\n * @deprecated in 4.15.0. Use specific item types instead, i.e. {@link ToolbarGroupItem}.\n */\nexport class GroupItemDef extends ActionButtonItemDef {\n  private static _sId = 0;\n  public static groupIdPrefix = \"Group-\";\n\n  public groupId: string;\n  public itemsInColumn: number;\n  public items: AnyItemDef[];\n  public defaultActiveItemId?: string;\n\n  /** @internal */\n  public overflow: boolean = false;\n\n  private _itemList!: ItemList;\n  private _itemMap!: ItemMap;\n  private _panelLabel: string | StringGetter | ConditionalStringValue = \"\";\n\n  constructor(\n    groupItemProps: GroupItemProps,\n    onItemExecuted?: OnItemExecutedFunc\n  ) {\n    super(groupItemProps, onItemExecuted);\n\n    this.groupId =\n      groupItemProps.groupId !== undefined ? groupItemProps.groupId : \"\";\n    if (groupItemProps.groupId) this.groupId = groupItemProps.groupId;\n    else {\n      GroupItemDef._sId++;\n      this.groupId = GroupItemDef.groupIdPrefix + GroupItemDef._sId;\n    }\n\n    this.itemsInColumn =\n      groupItemProps.itemsInColumn !== undefined\n        ? groupItemProps.itemsInColumn\n        : 7;\n    this._panelLabel = PropsHelper.getStringSpec(\n      groupItemProps.panelLabel,\n      groupItemProps.panelLabelKey\n    );\n    this.items = groupItemProps.items;\n    this.defaultActiveItemId = groupItemProps.defaultActiveItemId;\n  }\n\n  public get id(): string {\n    return this.groupId;\n  }\n\n  /** Get the panelLabel string */\n  public get panelLabel(): string {\n    return PropsHelper.getStringFromSpec(this._panelLabel);\n  }\n\n  /** Set the panelLabel.\n   * @param v A string or a function to get the string.\n   */\n  public setPanelLabel(v: string | StringGetter | ConditionalStringValue) {\n    this._panelLabel = v;\n  }\n\n  public resolveItems(force?: boolean): void {\n    if (this._itemList && !force) return;\n\n    this._itemList = new ItemList();\n    this._itemMap = new ItemMap();\n\n    this.items.map((item: AnyItemDef) => {\n      const id: string = item.id;\n      this._itemList.addItem(item);\n      this._itemMap.set(id, item);\n    });\n  }\n\n  public getItemById(id: string): ItemDefBase | undefined {\n    return this._itemMap.get(id);\n  }\n\n  public getItemByIndex(index: number): ItemDefBase | undefined {\n    return this._itemList.items[index];\n  }\n\n  public get itemCount(): number {\n    return this._itemList.items.length;\n  }\n\n  public override execute(): void {}\n}\n"]}

package/lib/esm/appui-react/toolbar/Toolbar.d.ts

@@ -27,7 +27,7 @@ export interface ToolbarProps extends CommonProps, NoChildrenProps {
     items: ToolbarItem[];
     /** Describes how expanded panels are aligned. Defaults to: [[ToolbarPanelAlignment.Start]] */
     panelAlignment?: ToolbarPanelAlignment;
-    /** Use Drag Interaction to open popups with nest action buttons */
+    /** Use drag interaction to open popups with nested toolbar buttons. */
     useDragInteraction?: boolean;
     /** Determines whether to use mouse proximity to alter the opacity of the toolbar */
     toolbarOpacitySetting?: ToolbarOpacitySetting;

package/lib/esm/appui-react/toolbar/Toolbar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Toolbar.d.ts","sourceRoot":"","sources":["../../../../src/appui-react/toolbar/Toolbar.tsx"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EAEL,SAAS,EACT,qBAAqB,EACtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAMjD;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,mIAAmI;IACnI,iBAAiB,CAAC,EAAE,SAAS,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,WAAW,EAAE,eAAe;IAChE,2OAA2O;IAC3O,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,gHAAgH;IAChH,cAAc,CAAC,EAAE,OAAO,GAAG,sBAAsB,CAAC;IAClD,uGAAuG;IACvG,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,8FAA8F;IAC9F,cAAc,CAAC,EAAE,qBAAqB,CAAC;IACvC,mEAAmE;IACnE,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,oFAAoF;IACpF,qBAAqB,CAAC,EAAE,qBAAqB,CAAC;IAC9C,sDAAsD;IACtD,cAAc,CAAC,EAAE,kBAAkB,CAAC;IACpC,2EAA2E;IAC3E,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,aAAa,KAAK,IAAI,CAAC;CAC9C;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,YAAY,qBAM1C"}
+{"version":3,"file":"Toolbar.d.ts","sourceRoot":"","sources":["../../../../src/appui-react/toolbar/Toolbar.tsx"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EAEL,SAAS,EACT,qBAAqB,EACtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAMjD;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,mIAAmI;IACnI,iBAAiB,CAAC,EAAE,SAAS,CAAC;CAC/B;AAED;;GAEG;AAEH,MAAM,WAAW,YAAa,SAAQ,WAAW,EAAE,eAAe;IAChE,2OAA2O;IAC3O,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,gHAAgH;IAChH,cAAc,CAAC,EAAE,OAAO,GAAG,sBAAsB,CAAC;IAClD,uGAAuG;IACvG,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,8FAA8F;IAC9F,cAAc,CAAC,EAAE,qBAAqB,CAAC;IACvC,uEAAuE;IACvE,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,oFAAoF;IACpF,qBAAqB,CAAC,EAAE,qBAAqB,CAAC;IAC9C,sDAAsD;IACtD,cAAc,CAAC,EAAE,kBAAkB,CAAC;IACpC,2EAA2E;IAC3E,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,aAAa,KAAK,IAAI,CAAC;CAC9C;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,YAAY,qBAM1C"}

package/lib/esm/appui-react/toolbar/Toolbar.js.map

@@ -1 +1 @@
-{"version":3,"file":"Toolbar.js","sourceRoot":"","sources":["../../../../src/appui-react/toolbar/Toolbar.tsx"],"names":[],"mappings":"AAAA;;;gGAGgG;AAChG;;GAEG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,EACL,wBAAwB,IAAI,UAAU,EACtC,SAAS,EACT,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAiC9E;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,KAAmB;IACzC,MAAM,eAAe,GAAG,kBAAkB,EAAE,CAAC;IAC7C,IAAI,eAAe,CAAC,WAAW,EAAE,CAAC;QAChC,OAAO,oBAAC,UAAU,OAAK,KAAK,GAAI,CAAC;IACnC,CAAC;IACD,OAAO,oBAAC,eAAe,OAAK,KAAK,GAAI,CAAC;AACxC,CAAC;AAED,SAAS,UAAU,CAAC,KAAmB;IACrC,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC/C,MAAM,cAAc,GAAG,gBAAgB,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IAC9D,OAAO,CACL,oBAAC,gBAAgB,IACf,SAAS,EAAE,SAAS,EACpB,cAAc,EAAE,cAAc,EAC9B,KAAK,EAAE,KAAK,CAAC,KAAK,GAClB,CACH,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,KAAmB;IAC1C,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,GAAG,KAAK,CAAC;IAClC,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE;QAClC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;IACrD,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IACZ,OAAO,CACL,oBAAC,UAAU,IACT,KAAK,EAAE,QAAQ,EACf,WAAW,EAAE,qBAAqB,CAAC,aAAa,KAC5C,KAAK,GACT,CACH,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,SAAoC;IACvD,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,SAAS,CAAC,MAAM;YACnB,OAAO,QAAQ,CAAC;QAClB,KAAK,SAAS,CAAC,IAAI;YACjB,OAAO,MAAM,CAAC;QAChB,KAAK,SAAS,CAAC,KAAK;YAClB,OAAO,OAAO,CAAC;QACjB,KAAK,SAAS,CAAC,GAAG;YAChB,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,gBAAgB,CAAC,SAAyC;IACjE,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,qBAAqB,CAAC,GAAG;YAC5B,OAAO,KAAK,CAAC;QACf,KAAK,qBAAqB,CAAC,KAAK;YAC9B,OAAO,OAAO,CAAC;IACnB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,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 Toolbar\n */\n\nimport * as React from \"react\";\nimport type { OnItemExecutedFunc } from \"@itwin/appui-abstract\";\nimport type { CommonProps, NoChildrenProps } from \"@itwin/core-react\";\nimport type { ToolbarOpacitySetting } from \"@itwin/components-react\";\nimport {\n  InternalToolbarComponent as CR_Toolbar,\n  Direction,\n  ToolbarPanelAlignment,\n} from \"@itwin/components-react\";\nimport type { ToolbarItem } from \"./ToolbarItem\";\nimport { toUIAToolbarItem } from \"./toUIAToolbarItem\";\nimport { SyncUiEventDispatcher } from \"../syncui/SyncUiEventDispatcher\";\nimport { usePreviewFeatures } from \"../preview/PreviewFeatures\";\nimport { Toolbar as ToolGroupToolbar } from \"../preview/new-toolbars/Toolbar\";\n\n/**\n * Properties of [[Toolbar.enableOverflow]] component.\n * @public\n */\nexport interface OverflowToolbarOptions {\n  /** Describes to which direction the overflow popup panels are expanded if overflow is enabled. Defaults to: [[Direction.Right]] */\n  overflowExpandsTo?: Direction;\n}\n\n/** Properties of [[Toolbar]] component.\n * @public\n */\nexport interface ToolbarProps extends CommonProps, NoChildrenProps {\n  /** Describes to which direction the popup panels are expanded, also defines the orientation of the toolbar (Top/Bottom will create an horizontal toolbar, Left/Right will create a vertical toolbar). Defaults to: [[Direction.Bottom]] */\n  expandsTo?: Direction;\n  /** Describes if items that do not fit available space should move to an expandable panel. Defaults to: false */\n  enableOverflow?: boolean | OverflowToolbarOptions;\n  /** Definitions for items of the toolbar. Items are expected to be already sorted by group and item. */\n  items: ToolbarItem[];\n  /** Describes how expanded panels are aligned. Defaults to: [[ToolbarPanelAlignment.Start]] */\n  panelAlignment?: ToolbarPanelAlignment;\n  /** Use Drag Interaction to open popups with nest action buttons */\n  useDragInteraction?: boolean;\n  /** Determines whether to use mouse proximity to alter the opacity of the toolbar */\n  toolbarOpacitySetting?: ToolbarOpacitySetting;\n  /** Optional function to call on any item execution */\n  onItemExecuted?: OnItemExecutedFunc;\n  /** Optional function to call on any KeyDown events processed by toolbar */\n  onKeyDown?: (e: React.KeyboardEvent) => void;\n}\n\n/** Component that displays toolbar items.\n * @beta\n */\nexport function Toolbar(props: ToolbarProps) {\n  const previewFeatures = usePreviewFeatures();\n  if (previewFeatures.newToolbars) {\n    return <NewToolbar {...props} />;\n  }\n  return <OriginalToolbar {...props} />;\n}\n\nfunction NewToolbar(props: ToolbarProps) {\n  const expandsTo = toDirection(props.expandsTo);\n  const panelAlignment = toPanelAlignment(props.panelAlignment);\n  return (\n    <ToolGroupToolbar\n      expandsTo={expandsTo}\n      panelAlignment={panelAlignment}\n      items={props.items}\n    />\n  );\n}\n\nfunction OriginalToolbar(props: ToolbarProps) {\n  const { items, ...other } = props;\n  const uiaItems = React.useMemo(() => {\n    return items.map((item) => toUIAToolbarItem(item));\n  }, [items]);\n  return (\n    <CR_Toolbar\n      items={uiaItems}\n      syncUiEvent={SyncUiEventDispatcher.onSyncUiEvent}\n      {...other}\n    />\n  );\n}\n\nfunction toDirection(direction: ToolbarProps[\"expandsTo\"]) {\n  switch (direction) {\n    case Direction.Bottom:\n      return \"bottom\";\n    case Direction.Left:\n      return \"left\";\n    case Direction.Right:\n      return \"right\";\n    case Direction.Top:\n      return \"top\";\n  }\n  return undefined;\n}\n\nfunction toPanelAlignment(alignment: ToolbarProps[\"panelAlignment\"]) {\n  switch (alignment) {\n    case ToolbarPanelAlignment.End:\n      return \"end\";\n    case ToolbarPanelAlignment.Start:\n      return \"start\";\n  }\n  return undefined;\n}\n"]}
+{"version":3,"file":"Toolbar.js","sourceRoot":"","sources":["../../../../src/appui-react/toolbar/Toolbar.tsx"],"names":[],"mappings":"AAAA;;;gGAGgG;AAChG;;GAEG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,EACL,wBAAwB,IAAI,UAAU,EACtC,SAAS,EACT,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAkC9E;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,KAAmB;IACzC,MAAM,eAAe,GAAG,kBAAkB,EAAE,CAAC;IAC7C,IAAI,eAAe,CAAC,WAAW,EAAE,CAAC;QAChC,OAAO,oBAAC,UAAU,OAAK,KAAK,GAAI,CAAC;IACnC,CAAC;IACD,OAAO,oBAAC,eAAe,OAAK,KAAK,GAAI,CAAC;AACxC,CAAC;AAED,SAAS,UAAU,CAAC,KAAmB;IACrC,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC/C,MAAM,cAAc,GAAG,gBAAgB,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IAC9D,OAAO,CACL,oBAAC,gBAAgB,IACf,SAAS,EAAE,SAAS,EACpB,cAAc,EAAE,cAAc,EAC9B,KAAK,EAAE,KAAK,CAAC,KAAK,GAClB,CACH,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,KAAmB;IAC1C,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,GAAG,KAAK,CAAC;IAClC,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE;QAClC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;IACrD,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IACZ,OAAO,CACL,oBAAC,UAAU,IACT,KAAK,EAAE,QAAQ,EACf,WAAW,EAAE,qBAAqB,CAAC,aAAa,KAC5C,KAAK,GACT,CACH,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,SAAoC;IACvD,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,SAAS,CAAC,MAAM;YACnB,OAAO,QAAQ,CAAC;QAClB,KAAK,SAAS,CAAC,IAAI;YACjB,OAAO,MAAM,CAAC;QAChB,KAAK,SAAS,CAAC,KAAK;YAClB,OAAO,OAAO,CAAC;QACjB,KAAK,SAAS,CAAC,GAAG;YAChB,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,gBAAgB,CAAC,SAAyC;IACjE,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,qBAAqB,CAAC,GAAG;YAC5B,OAAO,KAAK,CAAC;QACf,KAAK,qBAAqB,CAAC,KAAK;YAC9B,OAAO,OAAO,CAAC;IACnB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,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 Toolbar\n */\n\nimport * as React from \"react\";\nimport type { OnItemExecutedFunc } from \"@itwin/appui-abstract\";\nimport type { CommonProps, NoChildrenProps } from \"@itwin/core-react\";\nimport type { ToolbarOpacitySetting } from \"@itwin/components-react\";\nimport {\n  InternalToolbarComponent as CR_Toolbar,\n  Direction,\n  ToolbarPanelAlignment,\n} from \"@itwin/components-react\";\nimport type { ToolbarItem } from \"./ToolbarItem\";\nimport { toUIAToolbarItem } from \"./toUIAToolbarItem\";\nimport { SyncUiEventDispatcher } from \"../syncui/SyncUiEventDispatcher\";\nimport { usePreviewFeatures } from \"../preview/PreviewFeatures\";\nimport { Toolbar as ToolGroupToolbar } from \"../preview/new-toolbars/Toolbar\";\n\n/**\n * Properties of [[Toolbar.enableOverflow]] component.\n * @public\n */\nexport interface OverflowToolbarOptions {\n  /** Describes to which direction the overflow popup panels are expanded if overflow is enabled. Defaults to: [[Direction.Right]] */\n  overflowExpandsTo?: Direction;\n}\n\n/** Properties of [[Toolbar]] component.\n * @public\n */\n// eslint-disable-next-line deprecation/deprecation\nexport interface ToolbarProps extends CommonProps, NoChildrenProps {\n  /** Describes to which direction the popup panels are expanded, also defines the orientation of the toolbar (Top/Bottom will create an horizontal toolbar, Left/Right will create a vertical toolbar). Defaults to: [[Direction.Bottom]] */\n  expandsTo?: Direction;\n  /** Describes if items that do not fit available space should move to an expandable panel. Defaults to: false */\n  enableOverflow?: boolean | OverflowToolbarOptions;\n  /** Definitions for items of the toolbar. Items are expected to be already sorted by group and item. */\n  items: ToolbarItem[];\n  /** Describes how expanded panels are aligned. Defaults to: [[ToolbarPanelAlignment.Start]] */\n  panelAlignment?: ToolbarPanelAlignment;\n  /** Use drag interaction to open popups with nested toolbar buttons. */\n  useDragInteraction?: boolean;\n  /** Determines whether to use mouse proximity to alter the opacity of the toolbar */\n  toolbarOpacitySetting?: ToolbarOpacitySetting;\n  /** Optional function to call on any item execution */\n  onItemExecuted?: OnItemExecutedFunc;\n  /** Optional function to call on any KeyDown events processed by toolbar */\n  onKeyDown?: (e: React.KeyboardEvent) => void;\n}\n\n/** Component that displays toolbar items.\n * @beta\n */\nexport function Toolbar(props: ToolbarProps) {\n  const previewFeatures = usePreviewFeatures();\n  if (previewFeatures.newToolbars) {\n    return <NewToolbar {...props} />;\n  }\n  return <OriginalToolbar {...props} />;\n}\n\nfunction NewToolbar(props: ToolbarProps) {\n  const expandsTo = toDirection(props.expandsTo);\n  const panelAlignment = toPanelAlignment(props.panelAlignment);\n  return (\n    <ToolGroupToolbar\n      expandsTo={expandsTo}\n      panelAlignment={panelAlignment}\n      items={props.items}\n    />\n  );\n}\n\nfunction OriginalToolbar(props: ToolbarProps) {\n  const { items, ...other } = props;\n  const uiaItems = React.useMemo(() => {\n    return items.map((item) => toUIAToolbarItem(item));\n  }, [items]);\n  return (\n    <CR_Toolbar\n      items={uiaItems}\n      syncUiEvent={SyncUiEventDispatcher.onSyncUiEvent}\n      {...other}\n    />\n  );\n}\n\nfunction toDirection(direction: ToolbarProps[\"expandsTo\"]) {\n  switch (direction) {\n    case Direction.Bottom:\n      return \"bottom\";\n    case Direction.Left:\n      return \"left\";\n    case Direction.Right:\n      return \"right\";\n    case Direction.Top:\n      return \"top\";\n  }\n  return undefined;\n}\n\nfunction toPanelAlignment(alignment: ToolbarProps[\"panelAlignment\"]) {\n  switch (alignment) {\n    case ToolbarPanelAlignment.End:\n      return \"end\";\n    case ToolbarPanelAlignment.Start:\n      return \"start\";\n  }\n  return undefined;\n}\n"]}

package/lib/esm/appui-react/toolbar/ToolbarHelper.d.ts

@@ -4,23 +4,38 @@
 import type * as React from "react";
 import type { ActionButton, CommonToolbarItem, CustomButtonDefinition, GroupButton } from "@itwin/appui-abstract";
 import type { AnyItemDef } from "../shared/AnyItemDef";
+import { CommandItemDef } from "../shared/CommandItemDef";
 import { CustomItemDef } from "../shared/CustomItemDef";
+import { ToolItemDef } from "../shared/ToolItemDef";
+import { GroupItemDef } from "./GroupItem";
 import type { ToolbarActionItem, ToolbarCustomItem, ToolbarGroupItem, ToolbarItem } from "./ToolbarItem";
 /** Helper functions for defining a Toolbar items used in `Toolbar`, `ToolbarComposer` and `UiItemsProvider`.
  * @public
+ * @deprecated in 4.15.0. Use {@link ToolbarItemUtilities} instead.
  */
 export declare class ToolbarHelper {
-    /** Construct ToolbarCustomItem definitions given a CustomItemDef. */
+    /** Construct ToolbarCustomItem definitions given a CustomItemDef.
+     * @deprecated in 4.15.0. Use {@link ToolbarItemUtilities.createCustomItem} instead.
+     */
     static createCustomDefinitionToolbarItem(itemPriority: number, itemDef: CustomItemDef, overrides?: Partial<CustomButtonDefinition>): ToolbarCustomItem;
-    /** Construct ToolbarActionItem and ToolbarGroupItem definitions given an array of ItemDefs. */
+    /** Construct ToolbarActionItem and ToolbarGroupItem definitions given an array of ItemDefs.
+     * @deprecated in 4.15.0. Use {@link ToolbarItemUtilities} instead.
+     */
     static constructChildToolbarItems(itemDefs: AnyItemDef[]): Array<ToolbarActionItem | ToolbarGroupItem>;
     private static getStringOrConditionalString;
+    /** @deprecated in 4.15.0. Use {@link @itwin/core-react#IconHelper} instead. */
     static getIconReactNode(item: ActionButton | GroupButton): React.ReactNode;
-    /** Helper method to creates a generic toolbar item entry */
+    /** Helper method to creates a generic toolbar item entry.
+     * @deprecated in 4.15.0. Use {@link ToolbarItemUtilities} instead.
+     */
     static createToolbarItemFromItemDef(itemPriority: number, itemDef: AnyItemDef, overrides?: Partial<CommonToolbarItem>): ToolbarItem;
-    /**
-     * Helper method to creates a generic toolbar item entry list.
+    /** Helper method to creates a generic toolbar item entry list.
+     * @deprecated in 4.15.0. Use {@link ToolbarItemUtilities} instead.
      */
     static createToolbarItemsFromItemDefs(itemDefs: AnyItemDef[], startingItemPriority?: number, overrides?: Partial<CommonToolbarItem>): ToolbarItem[];
 }
+/** @internal */
+export declare function itemDefToToolbarActionItem(itemDef: ToolItemDef | CommandItemDef, overrides?: Partial<ToolbarActionItem>): ToolbarActionItem;
+/** @internal */
+export declare function itemDefToToolbarGroupItem(itemDef: GroupItemDef, overrides?: Partial<ToolbarGroupItem>): ToolbarGroupItem;
 //# sourceMappingURL=ToolbarHelper.d.ts.map

package/lib/esm/appui-react/toolbar/ToolbarHelper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ToolbarHelper.d.ts","sourceRoot":"","sources":["../../../../src/appui-react/toolbar/ToolbarHelper.tsx"],"names":[],"mappings":"AAIA;;GAEG;AACH,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AACpC,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,sBAAsB,EACtB,WAAW,EAEZ,MAAM,uBAAuB,CAAC;AAG/B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAGxD,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EACZ,MAAM,eAAe,CAAC;AAkCvB;;GAEG;AACH,qBAAa,aAAa;IACxB,qEAAqE;WACvD,iCAAiC,CAC7C,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,aAAa,EACtB,SAAS,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,GAC1C,iBAAiB;IAIpB,+FAA+F;WACjF,0BAA0B,CACtC,QAAQ,EAAE,UAAU,EAAE,GACrB,KAAK,CAAC,iBAAiB,GAAG,gBAAgB,CAAC;IAI9C,OAAO,CAAC,MAAM,CAAC,4BAA4B;WAY7B,gBAAgB,CAC5B,IAAI,EAAE,YAAY,GAAG,WAAW,GAC/B,KAAK,CAAC,SAAS;IAIlB,4DAA4D;WAC9C,4BAA4B,CACxC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,UAAU,EACnB,SAAS,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GACrC,WAAW;IA4Cd;;OAEG;WACW,8BAA8B,CAC1C,QAAQ,EAAE,UAAU,EAAE,EACtB,oBAAoB,SAAK,EACzB,SAAS,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GACrC,WAAW,EAAE;CAQjB"}
+{"version":3,"file":"ToolbarHelper.d.ts","sourceRoot":"","sources":["../../../../src/appui-react/toolbar/ToolbarHelper.tsx"],"names":[],"mappings":"AAIA;;GAEG;AACH,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AACpC,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,sBAAsB,EACtB,WAAW,EAEZ,MAAM,uBAAuB,CAAC;AAI/B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EACZ,MAAM,eAAe,CAAC;AAqCvB;;;GAGG;AACH,qBAAa,aAAa;IACxB;;OAEG;WACW,iCAAiC,CAC7C,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,aAAa,EACtB,SAAS,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,GAC1C,iBAAiB;IAIpB;;OAEG;WACW,0BAA0B,CACtC,QAAQ,EAAE,UAAU,EAAE,GACrB,KAAK,CAAC,iBAAiB,GAAG,gBAAgB,CAAC;IAI9C,OAAO,CAAC,MAAM,CAAC,4BAA4B;IAY3C,+EAA+E;WACjE,gBAAgB,CAC5B,IAAI,EAAE,YAAY,GAAG,WAAW,GAC/B,KAAK,CAAC,SAAS;IAKlB;;OAEG;WACW,4BAA4B,CACxC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,UAAU,EACnB,SAAS,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GACrC,WAAW;IA4Cd;;OAEG;WACW,8BAA8B,CAC1C,QAAQ,EAAE,UAAU,EAAE,EACtB,oBAAoB,SAAK,EACzB,SAAS,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GACrC,WAAW,EAAE;CAQjB;AAED,gBAAgB;AAChB,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,WAAW,GAAG,cAAc,EACrC,SAAS,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GACrC,iBAAiB,CAOnB;AAED,gBAAgB;AAChB,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,YAAY,EACrB,SAAS,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GACpC,gBAAgB,CAOlB"}

package/lib/esm/appui-react/toolbar/ToolbarHelper.js

@@ -1,10 +1,12 @@
 import { ConditionalStringValue } from "@itwin/appui-abstract";
+import { assert } from "@itwin/core-bentley";
 import { IconHelper } from "@itwin/core-react";
 import { CommandItemDef } from "../shared/CommandItemDef";
 import { CustomItemDef } from "../shared/CustomItemDef";
 import { ToolItemDef } from "../shared/ToolItemDef";
 import { GroupItemDef } from "./GroupItem";
 import { isToolbarActionItem, isToolbarGroupItem } from "./ToolbarItem";
+/* eslint-disable deprecation/deprecation */
 /**
  * Common implementation for `constructChildToolbarItems` and `createToolbarItemsFromItemDefs`.
  * @param itemDefs List of itemDefs to convert.
@@ -26,13 +28,18 @@ function constructToolbarItemArray(itemDefs, allowCustom, startingItemPriority =
 }
 /** Helper functions for defining a Toolbar items used in `Toolbar`, `ToolbarComposer` and `UiItemsProvider`.
  * @public
+ * @deprecated in 4.15.0. Use {@link ToolbarItemUtilities} instead.
  */
 export class ToolbarHelper {
-    /** Construct ToolbarCustomItem definitions given a CustomItemDef. */
+    /** Construct ToolbarCustomItem definitions given a CustomItemDef.
+     * @deprecated in 4.15.0. Use {@link ToolbarItemUtilities.createCustomItem} instead.
+     */
     static createCustomDefinitionToolbarItem(itemPriority, itemDef, overrides) {
         return this.createToolbarItemFromItemDef(itemPriority, itemDef, overrides);
     }
-    /** Construct ToolbarActionItem and ToolbarGroupItem definitions given an array of ItemDefs. */
+    /** Construct ToolbarActionItem and ToolbarGroupItem definitions given an array of ItemDefs.
+     * @deprecated in 4.15.0. Use {@link ToolbarItemUtilities} instead.
+     */
     static constructChildToolbarItems(itemDefs) {
         return constructToolbarItemArray(itemDefs, false);
     }
@@ -42,10 +49,14 @@ export class ToolbarHelper {
             return inString;
         return inString();
     }
+    /** @deprecated in 4.15.0. Use {@link @itwin/core-react#IconHelper} instead. */
     static getIconReactNode(item) {
+        // eslint-disable-next-line deprecation/deprecation
         return IconHelper.getIconReactNode(item.icon, item.internalData);
     }
-    /** Helper method to creates a generic toolbar item entry */
+    /** Helper method to creates a generic toolbar item entry.
+     * @deprecated in 4.15.0. Use {@link ToolbarItemUtilities} instead.
+     */
     static createToolbarItemFromItemDef(itemPriority, itemDef, overrides) {
         const { badgeType, description, icon, internalData, ...itemOverrides } = overrides ?? {};
         const itemBase = {
@@ -54,8 +65,8 @@ export class ToolbarHelper {
             isActive: itemDef.isActive,
             isHidden: itemDef.isHidden,
             isDisabled: itemDef.isDisabled,
-            icon: internalData?.get(IconHelper.reactIconKey) ??
-                internalData?.get(IconHelper.conditionalIconItemKey) ??
+            icon: internalData?.get(IconHelper.reactIconKey) ?? // eslint-disable-line deprecation/deprecation
+                internalData?.get(IconHelper.conditionalIconItemKey) ?? // eslint-disable-line deprecation/deprecation
                 icon ??
                 itemDef.iconSpec,
             label: this.getStringOrConditionalString(itemDef.rawLabel),
@@ -89,11 +100,29 @@ export class ToolbarHelper {
             throw new Error(`Invalid Item type encountered, item id=${itemDef.id}`);
         }
     }
-    /**
-     * Helper method to creates a generic toolbar item entry list.
+    /** Helper method to creates a generic toolbar item entry list.
+     * @deprecated in 4.15.0. Use {@link ToolbarItemUtilities} instead.
      */
     static createToolbarItemsFromItemDefs(itemDefs, startingItemPriority = 10, overrides) {
         return constructToolbarItemArray(itemDefs, true, startingItemPriority, overrides);
     }
 }
+/** @internal */
+export function itemDefToToolbarActionItem(itemDef, overrides) {
+    const item = ToolbarHelper.createToolbarItemFromItemDef(0, itemDef);
+    assert(isToolbarActionItem(item));
+    return {
+        ...item,
+        ...overrides,
+    };
+}
+/** @internal */
+export function itemDefToToolbarGroupItem(itemDef, overrides) {
+    const item = ToolbarHelper.createToolbarItemFromItemDef(0, itemDef);
+    assert(isToolbarGroupItem(item));
+    return {
+        ...item,
+        ...overrides,
+    };
+}
 //# sourceMappingURL=ToolbarHelper.js.map