@itwin/appui-react 4.0.0-dev.12 → 4.0.0-dev.14

package/lib/esm/appui-react/utils/PropsHelper.js

@@ -1,64 +1,64 @@
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-/** @packageDocumentation
- * @module Utilities
- */
-import * as React from "react";
-import { Icon, IconHelper } from "@itwin/core-react";
-import { UiFramework } from "../UiFramework";
-import { ConditionalStringValue } from "@itwin/appui-abstract";
-/** A set of helper methods for various props
- * @public
- */
-export class PropsHelper {
-    /** Get spec for returning a string. Could be a simple string of a 'StringGetter' method used to return the string. */
-    static getStringSpec(explicitValue, stringKey) {
-        if (explicitValue) {
-            return explicitValue;
-        }
-        let outValue = "";
-        if (stringKey)
-            outValue = UiFramework.localization.getLocalizedString(stringKey);
-        return outValue;
-    }
-    /** Get the display string. */
-    static getStringFromSpec(spec) {
-        let label = "";
-        if (typeof spec === "string")
-            label = spec;
-        else if (spec instanceof ConditionalStringValue)
-            label = spec.value;
-        else
-            label = spec();
-        return label;
-    }
-    /** Get JSX element that defines an icon. If iconSpec is a string, then a web-font icon class is used otherwise a ReactNode holding an SVG icon is assumed.  */
-    // eslint-disable-next-line @typescript-eslint/naming-convention
-    static getIcon(iconSpec) {
-        if (iconSpec instanceof ConditionalStringValue)
-            return React.createElement(Icon, { iconSpec: iconSpec.value });
-        return (iconSpec) ? React.createElement(Icon, { iconSpec: iconSpec }) : undefined;
-    }
-    /** returns true if the two objects are the same using a shallow compare of each property */
-    static isShallowEqual(newObj, prevObj) {
-        for (const key in newObj) {
-            if (newObj[key] !== prevObj[key])
-                return false;
-        }
-        return true;
-    }
-    /** @deprecated in 4.0.*/
-    static getAbstractPropsForReactIcon(iconSpec, internalData) {
-        // istanbul ignore else
-        if (!iconSpec || !React.isValidElement(iconSpec))
-            return {};
-        // istanbul ignore else
-        if (!internalData)
-            internalData = new Map();
-        const icon = IconHelper.getIconData(iconSpec, internalData);
-        return (icon === "" ? { icon } : { icon, internalData });
-    }
-}
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Utilities
+ */
+import * as React from "react";
+import { Icon, IconHelper } from "@itwin/core-react";
+import { UiFramework } from "../UiFramework";
+import { ConditionalStringValue } from "@itwin/appui-abstract";
+/** A set of helper methods for various props
+ * @public
+ */
+export class PropsHelper {
+    /** Get spec for returning a string. Could be a simple string of a 'StringGetter' method used to return the string. */
+    static getStringSpec(explicitValue, stringKey) {
+        if (explicitValue) {
+            return explicitValue;
+        }
+        let outValue = "";
+        if (stringKey)
+            outValue = UiFramework.localization.getLocalizedString(stringKey);
+        return outValue;
+    }
+    /** Get the display string. */
+    static getStringFromSpec(spec) {
+        let label = "";
+        if (typeof spec === "string")
+            label = spec;
+        else if (spec instanceof ConditionalStringValue)
+            label = spec.value;
+        else
+            label = spec();
+        return label;
+    }
+    /** Get JSX element that defines an icon. If iconSpec is a string, then a web-font icon class is used otherwise a ReactNode holding an SVG icon is assumed.  */
+    // eslint-disable-next-line @typescript-eslint/naming-convention
+    static getIcon(iconSpec) {
+        if (iconSpec instanceof ConditionalStringValue)
+            return React.createElement(Icon, { iconSpec: iconSpec.value });
+        return (iconSpec) ? React.createElement(Icon, { iconSpec: iconSpec }) : undefined;
+    }
+    /** returns true if the two objects are the same using a shallow compare of each property */
+    static isShallowEqual(newObj, prevObj) {
+        for (const key in newObj) {
+            if (newObj[key] !== prevObj[key])
+                return false;
+        }
+        return true;
+    }
+    /** @deprecated in 4.0 These abstract props types are obsolete. */
+    static getAbstractPropsForReactIcon(iconSpec, internalData) {
+        // istanbul ignore else
+        if (!iconSpec || !React.isValidElement(iconSpec))
+            return {};
+        // istanbul ignore else
+        if (!internalData)
+            internalData = new Map();
+        const icon = IconHelper.getIconData(iconSpec, internalData);
+        return (icon === "" ? { icon } : { icon, internalData });
+    }
+}
 //# sourceMappingURL=PropsHelper.js.map

package/lib/esm/appui-react/utils/PropsHelper.js.map

@@ -1 +1 @@
-{"version":3,"file":"PropsHelper.js","sourceRoot":"","sources":["../../../../src/appui-react/utils/PropsHelper.tsx"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,IAAI,EAAE,UAAU,EAAY,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,sBAAsB,EAAgH,MAAM,uBAAuB,CAAC;AAE7K;;GAEG;AACH,MAAM,OAAO,WAAW;IACtB,sHAAsH;IAC/G,MAAM,CAAC,aAAa,CAAC,aAAyE,EAAE,SAAkB;QACvH,IAAI,aAAa,EAAE;YACjB,OAAO,aAAa,CAAC;SACtB;QAED,IAAI,QAAQ,GAAG,EAAE,CAAC;QAClB,IAAI,SAAS;YACX,QAAQ,GAAG,WAAW,CAAC,YAAY,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;QACpE,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,8BAA8B;IACvB,MAAM,CAAC,iBAAiB,CAAC,IAAoD;QAClF,IAAI,KAAK,GAAG,EAAE,CAAC;QACf,IAAI,OAAO,IAAI,KAAK,QAAQ;YAC1B,KAAK,GAAG,IAAI,CAAC;aACV,IAAI,IAAI,YAAY,sBAAsB;YAC7C,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;;YAEnB,KAAK,GAAG,IAAI,EAAE,CAAC;QACjB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,+JAA+J;IAC/J,gEAAgE;IACzD,MAAM,CAAC,OAAO,CAAC,QAA2D;QAC/E,IAAI,QAAQ,YAAY,sBAAsB;YAC5C,OAAO,oBAAC,IAAI,IAAC,QAAQ,EAAE,QAAQ,CAAC,KAAK,GAAI,CAAC;QAE5C,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,oBAAC,IAAI,IAAC,QAAQ,EAAE,QAAQ,GAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/D,CAAC;IAED,4FAA4F;IACrF,MAAM,CAAC,cAAc,CAAC,MAAW,EAAE,OAAY;QACpD,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE;YACxB,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC;gBAAE,OAAO,KAAK,CAAC;SAChD;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,yBAAyB;IAClB,MAAM,CAAC,4BAA4B,CAAC,QAAkB,EAAE,YAA+B;QAC5F,uBAAuB;QACvB,IAAI,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC;YAC9C,OAAO,EAAE,CAAC;QAEZ,uBAAuB;QACvB,IAAI,CAAC,YAAY;YACf,YAAY,GAAG,IAAI,GAAG,EAAe,CAAC;QAExC,MAAM,IAAI,GAAG,UAAU,CAAC,WAAW,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;QAE5D,OAAO,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;IAC3D,CAAC;CACF","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Utilities\r\n */\r\n\r\nimport * as React from \"react\";\r\nimport { Icon, IconHelper, IconSpec } from \"@itwin/core-react\";\r\nimport { UiFramework } from \"../UiFramework\";\r\nimport { ConditionalStringValue, StringGetter, AbstractWidgetProps as UIA_AbstractWidgetProps, CommonBackstageItem as UIA_CommonBackstageItem } from \"@itwin/appui-abstract\";\r\n\r\n/** A set of helper methods for various props\r\n * @public\r\n */\r\nexport class PropsHelper {\r\n  /** Get spec for returning a string. Could be a simple string of a 'StringGetter' method used to return the string. */\r\n  public static getStringSpec(explicitValue: string | StringGetter | ConditionalStringValue | undefined, stringKey?: string): string | StringGetter | ConditionalStringValue {\r\n    if (explicitValue) {\r\n      return explicitValue;\r\n    }\r\n\r\n    let outValue = \"\";\r\n    if (stringKey)\r\n      outValue = UiFramework.localization.getLocalizedString(stringKey);\r\n    return outValue;\r\n  }\r\n\r\n  /** Get the display string. */\r\n  public static getStringFromSpec(spec: string | StringGetter | ConditionalStringValue): string {\r\n    let label = \"\";\r\n    if (typeof spec === \"string\")\r\n      label = spec;\r\n    else if (spec instanceof ConditionalStringValue)\r\n      label = spec.value;\r\n    else\r\n      label = spec();\r\n    return label;\r\n  }\r\n\r\n  /** Get JSX element that defines an icon. If iconSpec is a string, then a web-font icon class is used otherwise a ReactNode holding an SVG icon is assumed.  */\r\n  // eslint-disable-next-line @typescript-eslint/naming-convention\r\n  public static getIcon(iconSpec: string | ConditionalStringValue | React.ReactNode): JSX.Element | undefined {\r\n    if (iconSpec instanceof ConditionalStringValue)\r\n      return <Icon iconSpec={iconSpec.value} />;\r\n\r\n    return (iconSpec) ? <Icon iconSpec={iconSpec} /> : undefined;\r\n  }\r\n\r\n  /** returns true if the two objects are the same using a shallow compare of each property */\r\n  public static isShallowEqual(newObj: any, prevObj: any) {\r\n    for (const key in newObj) {\r\n      if (newObj[key] !== prevObj[key]) return false;\r\n    }\r\n    return true;\r\n  }\r\n\r\n  /** @deprecated in 4.0.*/\r\n  public static getAbstractPropsForReactIcon(iconSpec: IconSpec, internalData?: Map<string, any>): Partial<UIA_AbstractWidgetProps> | Partial<UIA_CommonBackstageItem> { // eslint-disable-line deprecation/deprecation\r\n    // istanbul ignore else\r\n    if (!iconSpec || !React.isValidElement(iconSpec))\r\n      return {};\r\n\r\n    // istanbul ignore else\r\n    if (!internalData)\r\n      internalData = new Map<string, any>();\r\n\r\n    const icon = IconHelper.getIconData(iconSpec, internalData);\r\n\r\n    return (icon === \"\" ? { icon } : { icon, internalData });\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"PropsHelper.js","sourceRoot":"","sources":["../../../../src/appui-react/utils/PropsHelper.tsx"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,IAAI,EAAE,UAAU,EAAY,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,sBAAsB,EAAgH,MAAM,uBAAuB,CAAC;AAE7K;;GAEG;AACH,MAAM,OAAO,WAAW;IACtB,sHAAsH;IAC/G,MAAM,CAAC,aAAa,CAAC,aAAyE,EAAE,SAAkB;QACvH,IAAI,aAAa,EAAE;YACjB,OAAO,aAAa,CAAC;SACtB;QAED,IAAI,QAAQ,GAAG,EAAE,CAAC;QAClB,IAAI,SAAS;YACX,QAAQ,GAAG,WAAW,CAAC,YAAY,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;QACpE,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,8BAA8B;IACvB,MAAM,CAAC,iBAAiB,CAAC,IAAoD;QAClF,IAAI,KAAK,GAAG,EAAE,CAAC;QACf,IAAI,OAAO,IAAI,KAAK,QAAQ;YAC1B,KAAK,GAAG,IAAI,CAAC;aACV,IAAI,IAAI,YAAY,sBAAsB;YAC7C,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;;YAEnB,KAAK,GAAG,IAAI,EAAE,CAAC;QACjB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,+JAA+J;IAC/J,gEAAgE;IACzD,MAAM,CAAC,OAAO,CAAC,QAA2D;QAC/E,IAAI,QAAQ,YAAY,sBAAsB;YAC5C,OAAO,oBAAC,IAAI,IAAC,QAAQ,EAAE,QAAQ,CAAC,KAAK,GAAI,CAAC;QAE5C,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,oBAAC,IAAI,IAAC,QAAQ,EAAE,QAAQ,GAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/D,CAAC;IAED,4FAA4F;IACrF,MAAM,CAAC,cAAc,CAAC,MAAW,EAAE,OAAY;QACpD,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE;YACxB,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC;gBAAE,OAAO,KAAK,CAAC;SAChD;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,kEAAkE;IAC3D,MAAM,CAAC,4BAA4B,CAAC,QAAkB,EAAE,YAA+B;QAC5F,uBAAuB;QACvB,IAAI,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC;YAC9C,OAAO,EAAE,CAAC;QAEZ,uBAAuB;QACvB,IAAI,CAAC,YAAY;YACf,YAAY,GAAG,IAAI,GAAG,EAAe,CAAC;QAExC,MAAM,IAAI,GAAG,UAAU,CAAC,WAAW,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;QAE5D,OAAO,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;IAC3D,CAAC;CACF","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Utilities\r\n */\r\n\r\nimport * as React from \"react\";\r\nimport { Icon, IconHelper, IconSpec } from \"@itwin/core-react\";\r\nimport { UiFramework } from \"../UiFramework\";\r\nimport { ConditionalStringValue, StringGetter, AbstractWidgetProps as UIA_AbstractWidgetProps, CommonBackstageItem as UIA_CommonBackstageItem } from \"@itwin/appui-abstract\";\r\n\r\n/** A set of helper methods for various props\r\n * @public\r\n */\r\nexport class PropsHelper {\r\n  /** Get spec for returning a string. Could be a simple string of a 'StringGetter' method used to return the string. */\r\n  public static getStringSpec(explicitValue: string | StringGetter | ConditionalStringValue | undefined, stringKey?: string): string | StringGetter | ConditionalStringValue {\r\n    if (explicitValue) {\r\n      return explicitValue;\r\n    }\r\n\r\n    let outValue = \"\";\r\n    if (stringKey)\r\n      outValue = UiFramework.localization.getLocalizedString(stringKey);\r\n    return outValue;\r\n  }\r\n\r\n  /** Get the display string. */\r\n  public static getStringFromSpec(spec: string | StringGetter | ConditionalStringValue): string {\r\n    let label = \"\";\r\n    if (typeof spec === \"string\")\r\n      label = spec;\r\n    else if (spec instanceof ConditionalStringValue)\r\n      label = spec.value;\r\n    else\r\n      label = spec();\r\n    return label;\r\n  }\r\n\r\n  /** Get JSX element that defines an icon. If iconSpec is a string, then a web-font icon class is used otherwise a ReactNode holding an SVG icon is assumed.  */\r\n  // eslint-disable-next-line @typescript-eslint/naming-convention\r\n  public static getIcon(iconSpec: string | ConditionalStringValue | React.ReactNode): JSX.Element | undefined {\r\n    if (iconSpec instanceof ConditionalStringValue)\r\n      return <Icon iconSpec={iconSpec.value} />;\r\n\r\n    return (iconSpec) ? <Icon iconSpec={iconSpec} /> : undefined;\r\n  }\r\n\r\n  /** returns true if the two objects are the same using a shallow compare of each property */\r\n  public static isShallowEqual(newObj: any, prevObj: any) {\r\n    for (const key in newObj) {\r\n      if (newObj[key] !== prevObj[key]) return false;\r\n    }\r\n    return true;\r\n  }\r\n\r\n  /** @deprecated in 4.0 These abstract props types are obsolete. */\r\n  public static getAbstractPropsForReactIcon(iconSpec: IconSpec, internalData?: Map<string, any>): Partial<UIA_AbstractWidgetProps> | Partial<UIA_CommonBackstageItem> { // eslint-disable-line deprecation/deprecation\r\n    // istanbul ignore else\r\n    if (!iconSpec || !React.isValidElement(iconSpec))\r\n      return {};\r\n\r\n    // istanbul ignore else\r\n    if (!internalData)\r\n      internalData = new Map<string, any>();\r\n\r\n    const icon = IconHelper.getIconData(iconSpec, internalData);\r\n\r\n    return (icon === \"\" ? { icon } : { icon, internalData });\r\n  }\r\n}\r\n"]}

package/lib/esm/appui-react/utils/ToolbarButtonHelper.d.ts

@@ -1,18 +1,18 @@
-/** @packageDocumentation
- * @module Utilities
- */
-/** A set of Dom helper methods
- * @public
- */
-export declare class ToolbarButtonHelper {
-    static searchToolbarsByTitle(title: string, horizontal: boolean): HTMLButtonElement | null;
-    /** Search Horizontal Toolbars for button by title. */
-    static searchHorizontalToolbarsByTitle(title: string): HTMLButtonElement | null;
-    /** Search Vertical Toolbars by Title for button by title. */
-    static searchVerticalToolbarsByTitle(title: string): HTMLButtonElement | null;
-    /** Get toolbar button by title. */
-    static getToolbarButtonByTitle(title: string): HTMLButtonElement | null;
-    /** Get App button. */
-    static getAppButton(): HTMLButtonElement | null;
-}
+/** @packageDocumentation
+ * @module Utilities
+ */
+/** A set of Dom helper methods
+ * @public
+ */
+export declare class ToolbarButtonHelper {
+    static searchToolbarsByTitle(title: string, horizontal: boolean): HTMLButtonElement | null;
+    /** Search Horizontal Toolbars for button by title. */
+    static searchHorizontalToolbarsByTitle(title: string): HTMLButtonElement | null;
+    /** Search Vertical Toolbars by Title for button by title. */
+    static searchVerticalToolbarsByTitle(title: string): HTMLButtonElement | null;
+    /** Get toolbar button by title. */
+    static getToolbarButtonByTitle(title: string): HTMLButtonElement | null;
+    /** Get App button. */
+    static getAppButton(): HTMLButtonElement | null;
+}
 //# sourceMappingURL=ToolbarButtonHelper.d.ts.map

package/lib/esm/appui-react/utils/ToolbarButtonHelper.js

@@ -1,57 +1,57 @@
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-/** @packageDocumentation
- * @module Utilities
- */
-/** A set of Dom helper methods
- * @public
- */
-export class ToolbarButtonHelper {
-    static searchToolbarsByTitle(title, horizontal) {
-        // first look for simple tool buttons
-        const nodeList = document.documentElement.querySelectorAll(`div.nz-toolbar-items.nz-${horizontal ? "horizontal" : "vertical"}.nz-items .nz-toolbar-item-item`);
-        // istanbul ignore else
-        if (nodeList && nodeList.length > 0) {
-            for (const node of nodeList) {
-                const button = node;
-                if (button.title === title) {
-                    return button;
-                }
-            }
-        }
-        return null;
-    }
-    /** Search Horizontal Toolbars for button by title. */
-    static searchHorizontalToolbarsByTitle(title) {
-        return ToolbarButtonHelper.searchToolbarsByTitle(title, true);
-    }
-    /** Search Vertical Toolbars by Title for button by title. */
-    static searchVerticalToolbarsByTitle(title) {
-        return ToolbarButtonHelper.searchToolbarsByTitle(title, false);
-    }
-    /** Get toolbar button by title. */
-    static getToolbarButtonByTitle(title) {
-        let button = ToolbarButtonHelper.searchHorizontalToolbarsByTitle(title);
-        // istanbul ignore if
-        if (button)
-            return button;
-        button = ToolbarButtonHelper.searchVerticalToolbarsByTitle(title);
-        // istanbul ignore else
-        if (button)
-            return button;
-        // istanbul ignore next
-        return null;
-    }
-    /** Get App button. */
-    static getAppButton() {
-        const node = document.documentElement.querySelector("div.nz-app-button > button");
-        // istanbul ignore else
-        if (node)
-            return node;
-        // istanbul ignore next
-        return null;
-    }
-}
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Utilities
+ */
+/** A set of Dom helper methods
+ * @public
+ */
+export class ToolbarButtonHelper {
+    static searchToolbarsByTitle(title, horizontal) {
+        // first look for simple tool buttons
+        const nodeList = document.documentElement.querySelectorAll(`div.nz-toolbar-items.nz-${horizontal ? "horizontal" : "vertical"}.nz-items .nz-toolbar-item-item`);
+        // istanbul ignore else
+        if (nodeList && nodeList.length > 0) {
+            for (const node of nodeList) {
+                const button = node;
+                if (button.title === title) {
+                    return button;
+                }
+            }
+        }
+        return null;
+    }
+    /** Search Horizontal Toolbars for button by title. */
+    static searchHorizontalToolbarsByTitle(title) {
+        return ToolbarButtonHelper.searchToolbarsByTitle(title, true);
+    }
+    /** Search Vertical Toolbars by Title for button by title. */
+    static searchVerticalToolbarsByTitle(title) {
+        return ToolbarButtonHelper.searchToolbarsByTitle(title, false);
+    }
+    /** Get toolbar button by title. */
+    static getToolbarButtonByTitle(title) {
+        let button = ToolbarButtonHelper.searchHorizontalToolbarsByTitle(title);
+        // istanbul ignore if
+        if (button)
+            return button;
+        button = ToolbarButtonHelper.searchVerticalToolbarsByTitle(title);
+        // istanbul ignore else
+        if (button)
+            return button;
+        // istanbul ignore next
+        return null;
+    }
+    /** Get App button. */
+    static getAppButton() {
+        const node = document.documentElement.querySelector("div.nz-app-button > button");
+        // istanbul ignore else
+        if (node)
+            return node;
+        // istanbul ignore next
+        return null;
+    }
+}
 //# sourceMappingURL=ToolbarButtonHelper.js.map

package/lib/esm/appui-react/utils/UiShowHideManager.d.ts

@@ -1,54 +1,54 @@
-/** @packageDocumentation
- * @module Utilities
- */
-/// <reference types="react" />
-import { UiShowHideSettingsProvider } from "./InternalUiShowHideManager";
-export { UiShowHideSettingsProvider };
-/** Maintains Ui Show/Hide state. The `Ui` includes widgets, panels and the status bar.
- * @public
- * @deprecated in 3.7. Use `UiFramework.visibility` property.
- */
-export declare class UiShowHideManager {
-    /** Determines if the Ui is visible */
-    static get isUiVisible(): boolean;
-    static set isUiVisible(visible: boolean);
-    /** @internal */
-    static setAutoHideUi(value: boolean): void;
-    /** @internal */
-    static setUseProximityOpacity(value: boolean): void;
-    /** @internal */
-    static setSnapWidgetOpacity(value: boolean): void;
-    /** Determines whether the `auto-hide Ui` feature is on. Defaults to false.
-     * When true, the Ui automatically hides after a few seconds of inactivity.
-     */
-    static get autoHideUi(): boolean;
-    static set autoHideUi(autoHide: boolean);
-    /** Determines whether the widget panels are shown and hidden. Defaults to false. */
-    static get showHidePanels(): boolean;
-    static set showHidePanels(showHide: boolean);
-    /** Determines whether the status bar is shown and hidden. Defaults to false. */
-    static get showHideFooter(): boolean;
-    static set showHideFooter(showHide: boolean);
-    /** Determines the amount of inactivity time before the Ui is hidden. Defaults to 3.5 seconds. */
-    static get inactivityTime(): number;
-    static set inactivityTime(time: number);
-    /** Determines whether the proximity of the mouse should alter the opacity of a toolbar. Defaults to true. */
-    static get useProximityOpacity(): boolean;
-    static set useProximityOpacity(value: boolean);
-    /** Determines whether the opacity of a toolbar should snap. Defaults to false. */
-    static get snapWidgetOpacity(): boolean;
-    static set snapWidgetOpacity(value: boolean);
-    /** Handler for when a Frontstage is ready */
-    static handleFrontstageReady(): void;
-    /** Handler for when the mouse moves over the content area */
-    static handleContentMouseMove(_event?: React.MouseEvent<HTMLElement, MouseEvent>): void;
-    /** Handler for when the mouse enters a widget */
-    static handleWidgetMouseEnter(_event?: React.MouseEvent<HTMLElement, MouseEvent>): void;
-    /** Shows the Ui and resets the inactivity timer */
-    static showUiAndResetTimer(): void;
-    /** Shows the Ui and cancels the inactivity timer */
-    static showUiAndCancelTimer(): void;
-    /** @internal */
-    static terminate(): void;
-}
+/** @packageDocumentation
+ * @module Utilities
+ */
+/// <reference types="react" />
+import { UiShowHideSettingsProvider } from "./InternalUiShowHideManager";
+export { UiShowHideSettingsProvider };
+/** Maintains Ui Show/Hide state. The `Ui` includes widgets, panels and the status bar.
+ * @public
+ * @deprecated in 3.7. Use `UiFramework.visibility` property.
+ */
+export declare class UiShowHideManager {
+    /** Determines if the Ui is visible */
+    static get isUiVisible(): boolean;
+    static set isUiVisible(visible: boolean);
+    /** @internal */
+    static setAutoHideUi(value: boolean): void;
+    /** @internal */
+    static setUseProximityOpacity(value: boolean): void;
+    /** @internal */
+    static setSnapWidgetOpacity(value: boolean): void;
+    /** Determines whether the `auto-hide Ui` feature is on. Defaults to false.
+     * When true, the Ui automatically hides after a few seconds of inactivity.
+     */
+    static get autoHideUi(): boolean;
+    static set autoHideUi(autoHide: boolean);
+    /** Determines whether the widget panels are shown and hidden. Defaults to false. */
+    static get showHidePanels(): boolean;
+    static set showHidePanels(showHide: boolean);
+    /** Determines whether the status bar is shown and hidden. Defaults to false. */
+    static get showHideFooter(): boolean;
+    static set showHideFooter(showHide: boolean);
+    /** Determines the amount of inactivity time before the Ui is hidden. Defaults to 3.5 seconds. */
+    static get inactivityTime(): number;
+    static set inactivityTime(time: number);
+    /** Determines whether the proximity of the mouse should alter the opacity of a toolbar. Defaults to true. */
+    static get useProximityOpacity(): boolean;
+    static set useProximityOpacity(value: boolean);
+    /** Determines whether the opacity of a toolbar should snap. Defaults to false. */
+    static get snapWidgetOpacity(): boolean;
+    static set snapWidgetOpacity(value: boolean);
+    /** Handler for when a Frontstage is ready */
+    static handleFrontstageReady(): void;
+    /** Handler for when the mouse moves over the content area */
+    static handleContentMouseMove(_event?: React.MouseEvent<HTMLElement, MouseEvent>): void;
+    /** Handler for when the mouse enters a widget */
+    static handleWidgetMouseEnter(_event?: React.MouseEvent<HTMLElement, MouseEvent>): void;
+    /** Shows the Ui and resets the inactivity timer */
+    static showUiAndResetTimer(): void;
+    /** Shows the Ui and cancels the inactivity timer */
+    static showUiAndCancelTimer(): void;
+    /** @internal */
+    static terminate(): void;
+}
 //# sourceMappingURL=UiShowHideManager.d.ts.map

package/lib/esm/appui-react/utils/UiShowHideManager.js

@@ -1,105 +1,105 @@
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-/** @packageDocumentation
- * @module Utilities
- */
-import { InternalUiShowHideManager as internal, UiShowHideSettingsProvider } from "./InternalUiShowHideManager";
-// reexporting to ensure no breaking changes in barrel exports, remove when removing deprecated.
-export { UiShowHideSettingsProvider };
-/** Maintains Ui Show/Hide state. The `Ui` includes widgets, panels and the status bar.
- * @public
- * @deprecated in 3.7. Use `UiFramework.visibility` property.
- */
-export class UiShowHideManager {
-    /** Determines if the Ui is visible */
-    static get isUiVisible() {
-        return internal.isUiVisible;
-    }
-    static set isUiVisible(visible) {
-        internal.isUiVisible = visible;
-    }
-    /** @internal */
-    static setAutoHideUi(value) {
-        return internal.setAutoHideUi(value);
-    }
-    /** @internal */
-    static setUseProximityOpacity(value) {
-        return internal.setUseProximityOpacity(value);
-    }
-    /** @internal */
-    static setSnapWidgetOpacity(value) {
-        return internal.setSnapWidgetOpacity(value);
-    }
-    /** Determines whether the `auto-hide Ui` feature is on. Defaults to false.
-     * When true, the Ui automatically hides after a few seconds of inactivity.
-     */
-    static get autoHideUi() {
-        return internal.autoHideUi;
-    }
-    static set autoHideUi(autoHide) {
-        internal.autoHideUi = autoHide;
-    }
-    /** Determines whether the widget panels are shown and hidden. Defaults to false. */
-    static get showHidePanels() {
-        return internal.showHidePanels;
-    }
-    static set showHidePanels(showHide) {
-        internal.showHidePanels = showHide;
-    }
-    /** Determines whether the status bar is shown and hidden. Defaults to false. */
-    static get showHideFooter() {
-        return internal.showHideFooter;
-    }
-    static set showHideFooter(showHide) {
-        internal.showHideFooter = showHide;
-    }
-    /** Determines the amount of inactivity time before the Ui is hidden. Defaults to 3.5 seconds. */
-    static get inactivityTime() {
-        return internal.inactivityTime;
-    }
-    static set inactivityTime(time) {
-        internal.inactivityTime = time;
-    }
-    /** Determines whether the proximity of the mouse should alter the opacity of a toolbar. Defaults to true. */
-    static get useProximityOpacity() {
-        return internal.useProximityOpacity;
-    }
-    static set useProximityOpacity(value) {
-        internal.useProximityOpacity = value;
-    }
-    /** Determines whether the opacity of a toolbar should snap. Defaults to false. */
-    static get snapWidgetOpacity() {
-        return internal.snapWidgetOpacity;
-    }
-    static set snapWidgetOpacity(value) {
-        internal.snapWidgetOpacity = value;
-    }
-    /** Handler for when a Frontstage is ready */
-    static handleFrontstageReady() {
-        // istanbul ignore next
-        return internal.handleFrontstageReady();
-    }
-    /** Handler for when the mouse moves over the content area */
-    static handleContentMouseMove(_event) {
-        return internal.handleContentMouseMove(_event);
-    }
-    /** Handler for when the mouse enters a widget */
-    static handleWidgetMouseEnter(_event) {
-        return internal.handleWidgetMouseEnter(_event);
-    }
-    /** Shows the Ui and resets the inactivity timer */
-    static showUiAndResetTimer() {
-        return internal.showUiAndResetTimer();
-    }
-    /** Shows the Ui and cancels the inactivity timer */
-    static showUiAndCancelTimer() {
-        return internal.showUiAndCancelTimer();
-    }
-    /** @internal */
-    static terminate() {
-        return internal.terminate();
-    }
-}
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Utilities
+ */
+import { InternalUiShowHideManager as internal, UiShowHideSettingsProvider } from "./InternalUiShowHideManager";
+// reexporting to ensure no breaking changes in barrel exports, remove when removing deprecated.
+export { UiShowHideSettingsProvider };
+/** Maintains Ui Show/Hide state. The `Ui` includes widgets, panels and the status bar.
+ * @public
+ * @deprecated in 3.7. Use `UiFramework.visibility` property.
+ */
+export class UiShowHideManager {
+    /** Determines if the Ui is visible */
+    static get isUiVisible() {
+        return internal.isUiVisible;
+    }
+    static set isUiVisible(visible) {
+        internal.isUiVisible = visible;
+    }
+    /** @internal */
+    static setAutoHideUi(value) {
+        return internal.setAutoHideUi(value);
+    }
+    /** @internal */
+    static setUseProximityOpacity(value) {
+        return internal.setUseProximityOpacity(value);
+    }
+    /** @internal */
+    static setSnapWidgetOpacity(value) {
+        return internal.setSnapWidgetOpacity(value);
+    }
+    /** Determines whether the `auto-hide Ui` feature is on. Defaults to false.
+     * When true, the Ui automatically hides after a few seconds of inactivity.
+     */
+    static get autoHideUi() {
+        return internal.autoHideUi;
+    }
+    static set autoHideUi(autoHide) {
+        internal.autoHideUi = autoHide;
+    }
+    /** Determines whether the widget panels are shown and hidden. Defaults to false. */
+    static get showHidePanels() {
+        return internal.showHidePanels;
+    }
+    static set showHidePanels(showHide) {
+        internal.showHidePanels = showHide;
+    }
+    /** Determines whether the status bar is shown and hidden. Defaults to false. */
+    static get showHideFooter() {
+        return internal.showHideFooter;
+    }
+    static set showHideFooter(showHide) {
+        internal.showHideFooter = showHide;
+    }
+    /** Determines the amount of inactivity time before the Ui is hidden. Defaults to 3.5 seconds. */
+    static get inactivityTime() {
+        return internal.inactivityTime;
+    }
+    static set inactivityTime(time) {
+        internal.inactivityTime = time;
+    }
+    /** Determines whether the proximity of the mouse should alter the opacity of a toolbar. Defaults to true. */
+    static get useProximityOpacity() {
+        return internal.useProximityOpacity;
+    }
+    static set useProximityOpacity(value) {
+        internal.useProximityOpacity = value;
+    }
+    /** Determines whether the opacity of a toolbar should snap. Defaults to false. */
+    static get snapWidgetOpacity() {
+        return internal.snapWidgetOpacity;
+    }
+    static set snapWidgetOpacity(value) {
+        internal.snapWidgetOpacity = value;
+    }
+    /** Handler for when a Frontstage is ready */
+    static handleFrontstageReady() {
+        // istanbul ignore next
+        return internal.handleFrontstageReady();
+    }
+    /** Handler for when the mouse moves over the content area */
+    static handleContentMouseMove(_event) {
+        return internal.handleContentMouseMove(_event);
+    }
+    /** Handler for when the mouse enters a widget */
+    static handleWidgetMouseEnter(_event) {
+        return internal.handleWidgetMouseEnter(_event);
+    }
+    /** Shows the Ui and resets the inactivity timer */
+    static showUiAndResetTimer() {
+        return internal.showUiAndResetTimer();
+    }
+    /** Shows the Ui and cancels the inactivity timer */
+    static showUiAndCancelTimer() {
+        return internal.showUiAndCancelTimer();
+    }
+    /** @internal */
+    static terminate() {
+        return internal.terminate();
+    }
+}
 //# sourceMappingURL=UiShowHideManager.js.map