@itwin/core-react 4.17.1 → 5.0.0-dev.2

package/lib/core-react/focus/ItemKeyboardNavigator.js

@@ -0,0 +1,173 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Focus
+ */
+import { Key } from "ts-key-enum";
+import { Orientation } from "../enums/Orientation.js";
+/** Keyboard Navigator for parent components
+ * @internal
+ */
+export class ItemKeyboardNavigator {
+    constructor(onFocusItem, onActivateItem) {
+        this.onFocusItem = onFocusItem;
+        this.onActivateItem = onActivateItem;
+        this._itemCount = 0;
+        this._orientation = Orientation.Horizontal;
+        this._allowWrap = true;
+        this._direction = new Map([
+            [Key.ArrowLeft, -1],
+            [Key.ArrowUp, -1],
+            [Key.ArrowRight, 1],
+            [Key.ArrowDown, 1],
+        ]);
+    }
+    /** The item count */
+    get itemCount() {
+        return this._itemCount;
+    }
+    set itemCount(count) {
+        this._itemCount = count;
+    }
+    /** The primary orientation */
+    get orientation() {
+        return this._orientation;
+    }
+    set orientation(orientation) {
+        this._orientation = orientation;
+    }
+    /** The allow wrap property controls whether the movement will stop at the first and last items or wrap  */
+    get allowWrap() {
+        return this._allowWrap;
+    }
+    set allowWrap(v) {
+        this._allowWrap = v;
+    }
+    /** Called when the arrow keys that run perpendicular to the primary orientation are pressed */
+    get crossAxisArrowKeyHandler() {
+        return this._crossAxisArrowKeyHandler;
+    }
+    set crossAxisArrowKeyHandler(v) {
+        this._crossAxisArrowKeyHandler = v;
+    }
+    /** Handle KeyDown on items */
+    handleKeyDownEvent(event, index) {
+        const key = event.key;
+        switch (key) {
+            case Key.Home.valueOf():
+                event.preventDefault();
+                // Activate first item
+                this.focusFirstItem();
+                break;
+            case Key.End.valueOf():
+                event.preventDefault();
+                // Activate last item
+                this.focusLastItem();
+                break;
+            // Up and down are in keydown
+            // because we need to prevent page scroll >:)
+            case Key.ArrowUp.valueOf():
+            case Key.ArrowDown.valueOf():
+                this.determineOrientation(event, index);
+                break;
+            case Key.Enter.valueOf():
+            case " ":
+                this.activateItem(index);
+                break;
+        }
+    }
+    /** Handle KeyUp on items */
+    handleKeyUpEvent(event, index) {
+        const key = event.key;
+        switch (key) {
+            case Key.ArrowLeft.valueOf():
+            case Key.ArrowRight.valueOf():
+                this.determineOrientation(event, index);
+                break;
+        }
+    }
+    focusFirstItem() {
+        this.onFocusItem(0);
+    }
+    focusLastItem() {
+        const index = this._itemCount - 1;
+        this.onFocusItem(index);
+    }
+    /** When an item list's orientation is set to vertical,
+     * only up and down arrow should function.
+     * In all other cases only left and right arrow function.
+     */
+    determineOrientation(event, index) {
+        const key = event.key;
+        const vertical = this._orientation === Orientation.Vertical;
+        let proceed = false;
+        if (vertical) {
+            if (key === Key.ArrowUp.valueOf() || key === Key.ArrowDown.valueOf()) {
+                event.preventDefault();
+                proceed = true;
+            }
+            else if (this.crossAxisArrowKeyHandler &&
+                (key === Key.ArrowLeft.valueOf() || key === Key.ArrowRight.valueOf())) {
+                this.crossAxisArrowKeyHandler(key === Key.ArrowRight.valueOf());
+            }
+        }
+        else {
+            if (key === Key.ArrowLeft.valueOf() || key === Key.ArrowRight.valueOf()) {
+                proceed = true;
+            }
+            else if (this.crossAxisArrowKeyHandler &&
+                (key === Key.ArrowUp.valueOf() || key === Key.ArrowDown.valueOf())) {
+                this.crossAxisArrowKeyHandler(key === Key.ArrowDown.valueOf());
+            }
+        }
+        if (proceed) {
+            this.switchItemOnArrowPress(event, index);
+        }
+    }
+    /** Either focus the next, previous, first, or last item depending on key pressed
+     */
+    switchItemOnArrowPress(event, index) {
+        // Add or subtract depending on key pressed
+        const pressed = event.key;
+        const targetDirection = this._direction.get(pressed);
+        if (targetDirection) {
+            const newIndex = index + targetDirection;
+            if (0 <= newIndex && newIndex < this._itemCount) {
+                this.onFocusItem(newIndex);
+            }
+            else {
+                if (this._allowWrap) {
+                    if (pressed === Key.ArrowLeft.valueOf() ||
+                        pressed === Key.ArrowUp.valueOf()) {
+                        this.focusLastItem();
+                    }
+                    else {
+                        this.focusFirstItem();
+                    }
+                }
+            }
+        }
+    }
+    activateItem(index) {
+        this.onActivateItem(index);
+    }
+}
+/** Determines if a KeyboardEvent.key is an Item Navigation key
+ * @internal
+ */
+export function isNavigationKey(key) {
+    return (isArrowKey(key) ||
+        key === Key.Home.valueOf() ||
+        key === Key.End.valueOf() ||
+        key === " " ||
+        key === Key.Enter.valueOf());
+}
+function isArrowKey(key) {
+    return (key === Key.ArrowLeft.valueOf() ||
+        key === Key.ArrowRight.valueOf() ||
+        key === Key.ArrowUp.valueOf() ||
+        key === Key.ArrowDown.valueOf());
+}
+//# sourceMappingURL=ItemKeyboardNavigator.js.map

package/lib/core-react/focus/ItemKeyboardNavigator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ItemKeyboardNavigator.js","sourceRoot":"","sources":["../../../src/core-react/focus/ItemKeyboardNavigator.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 Focus\n */\n\nimport { Key } from \"ts-key-enum\";\nimport { Orientation } from \"../enums/Orientation.js\";\n\n/* eslint-disable deprecation/deprecation */\n\n/** Cross-Axis Arrow Key Callback\n * @internal\n */\nexport type CrossAxisArrowKeyFunc = (forward: boolean) => void;\n\n/** Keyboard Navigator for parent components\n * @internal\n */\nexport class ItemKeyboardNavigator {\n  private _direction: Map<string, number>;\n  private _itemCount = 0;\n  private _orientation = Orientation.Horizontal;\n  private _allowWrap = true;\n  private _crossAxisArrowKeyHandler?: CrossAxisArrowKeyFunc;\n\n  constructor(\n    public onFocusItem: (index: number) => void,\n    public onActivateItem: (index: number) => void\n  ) {\n    this._direction = new Map<string, number>([\n      [Key.ArrowLeft, -1],\n      [Key.ArrowUp, -1],\n      [Key.ArrowRight, 1],\n      [Key.ArrowDown, 1],\n    ]);\n  }\n\n  /** The item count */\n  public get itemCount(): number {\n    return this._itemCount;\n  }\n  public set itemCount(count: number) {\n    this._itemCount = count;\n  }\n\n  /** The primary orientation */\n  public get orientation(): Orientation {\n    return this._orientation;\n  }\n  public set orientation(orientation: Orientation) {\n    this._orientation = orientation;\n  }\n\n  /** The allow wrap property controls whether the movement will stop at the first and last items or wrap  */\n  public get allowWrap(): boolean {\n    return this._allowWrap;\n  }\n  public set allowWrap(v: boolean) {\n    this._allowWrap = v;\n  }\n\n  /** Called when the arrow keys that run perpendicular to the primary orientation are pressed */\n  public get crossAxisArrowKeyHandler(): CrossAxisArrowKeyFunc | undefined {\n    return this._crossAxisArrowKeyHandler;\n  }\n  public set crossAxisArrowKeyHandler(v: CrossAxisArrowKeyFunc | undefined) {\n    this._crossAxisArrowKeyHandler = v;\n  }\n\n  /** Handle KeyDown on items */\n  public handleKeyDownEvent(event: React.KeyboardEvent, index: number): void {\n    const key = event.key;\n\n    switch (key) {\n      case Key.Home.valueOf():\n        event.preventDefault();\n        // Activate first item\n        this.focusFirstItem();\n        break;\n      case Key.End.valueOf():\n        event.preventDefault();\n        // Activate last item\n        this.focusLastItem();\n        break;\n\n      // Up and down are in keydown\n      // because we need to prevent page scroll >:)\n      case Key.ArrowUp.valueOf():\n      case Key.ArrowDown.valueOf():\n        this.determineOrientation(event, index);\n        break;\n\n      case Key.Enter.valueOf():\n      case \" \":\n        this.activateItem(index);\n        break;\n    }\n  }\n\n  /** Handle KeyUp on items */\n  public handleKeyUpEvent(event: React.KeyboardEvent, index: number): void {\n    const key = event.key;\n\n    switch (key) {\n      case Key.ArrowLeft.valueOf():\n      case Key.ArrowRight.valueOf():\n        this.determineOrientation(event, index);\n        break;\n    }\n  }\n\n  private focusFirstItem(): void {\n    this.onFocusItem(0);\n  }\n\n  private focusLastItem(): void {\n    const index = this._itemCount - 1;\n    this.onFocusItem(index);\n  }\n\n  /** When an item list's orientation is set to vertical,\n   * only up and down arrow should function.\n   * In all other cases only left and right arrow function.\n   */\n  private determineOrientation(\n    event: React.KeyboardEvent,\n    index: number\n  ): void {\n    const key = event.key;\n    const vertical = this._orientation === Orientation.Vertical;\n    let proceed = false;\n\n    if (vertical) {\n      if (key === Key.ArrowUp.valueOf() || key === Key.ArrowDown.valueOf()) {\n        event.preventDefault();\n        proceed = true;\n      } else if (\n        this.crossAxisArrowKeyHandler &&\n        (key === Key.ArrowLeft.valueOf() || key === Key.ArrowRight.valueOf())\n      ) {\n        this.crossAxisArrowKeyHandler(key === Key.ArrowRight.valueOf());\n      }\n    } else {\n      if (key === Key.ArrowLeft.valueOf() || key === Key.ArrowRight.valueOf()) {\n        proceed = true;\n      } else if (\n        this.crossAxisArrowKeyHandler &&\n        (key === Key.ArrowUp.valueOf() || key === Key.ArrowDown.valueOf())\n      ) {\n        this.crossAxisArrowKeyHandler(key === Key.ArrowDown.valueOf());\n      }\n    }\n\n    if (proceed) {\n      this.switchItemOnArrowPress(event, index);\n    }\n  }\n\n  /** Either focus the next, previous, first, or last item depending on key pressed\n   */\n  private switchItemOnArrowPress(\n    event: React.KeyboardEvent,\n    index: number\n  ): void {\n    // Add or subtract depending on key pressed\n    const pressed = event.key;\n    const targetDirection = this._direction.get(pressed);\n\n    if (targetDirection) {\n      const newIndex = index + targetDirection;\n\n      if (0 <= newIndex && newIndex < this._itemCount) {\n        this.onFocusItem(newIndex);\n      } else {\n        if (this._allowWrap) {\n          if (\n            pressed === Key.ArrowLeft.valueOf() ||\n            pressed === Key.ArrowUp.valueOf()\n          ) {\n            this.focusLastItem();\n          } else {\n            this.focusFirstItem();\n          }\n        }\n      }\n    }\n  }\n\n  private activateItem(index: number): void {\n    this.onActivateItem(index);\n  }\n}\n\n/** Determines if a KeyboardEvent.key is an Item Navigation key\n * @internal\n */\nexport function isNavigationKey(key: string): boolean {\n  return (\n    isArrowKey(key) ||\n    key === Key.Home.valueOf() ||\n    key === Key.End.valueOf() ||\n    key === \" \" ||\n    key === Key.Enter.valueOf()\n  );\n}\n\nfunction isArrowKey(key: string): boolean {\n  return (\n    key === Key.ArrowLeft.valueOf() ||\n    key === Key.ArrowRight.valueOf() ||\n    key === Key.ArrowUp.valueOf() ||\n    key === Key.ArrowDown.valueOf()\n  );\n}\n"]}

package/lib/core-react/focustrap/FocusTrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FocusTrap.d.ts","sourceRoot":"","sources":["../../../src/core-react/focustrap/FocusTrap.tsx"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AA0H/B;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,cAAc,EAAE,cAAc,EAC9B,mBAAmB,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,GAAG,MAAM,GAC1D,OAAO,CAcT;AAED;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,KAAK,CAAC,iBAAiB,CAAC,GAAG,CAAC;IAClE,uBAAuB;IACvB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,oEAAoE;IACpE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,wEAAwE;IACxE,uBAAuB,EAAE,OAAO,CAAC;IACjC;;;OAGG;IACH,mBAAmB,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,GAAG,MAAM,CAAC;CAC7D;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,4BA0G9C"}

package/lib/core-react/focustrap/FocusTrap.js

@@ -0,0 +1,196 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Popup
+ */
+import * as React from "react";
+import { Logger } from "@itwin/core-bentley";
+import { UiCore } from "../UiCore.js";
+/* eslint-disable deprecation/deprecation */
+function isFocusable(element) {
+    if (!element || element.tabIndex < 0)
+        return false;
+    if (element.classList &&
+        element.classList.contains("core-focus-trap-ignore-initial"))
+        return false;
+    if (element.getAttribute &&
+        typeof element.getAttribute === "function" &&
+        element.getAttribute("disabled") !== null)
+        return false;
+    if (element.tabIndex > 0 ||
+        (element.tabIndex === 0 && element.getAttribute("tabIndex") !== null))
+        return true;
+    switch (element.nodeName) {
+        case "A":
+            const anchorElement = element;
+            return !!anchorElement.href && anchorElement.rel !== "ignore";
+        case "INPUT":
+            const inputElement = element;
+            return inputElement.type !== "hidden" && inputElement.type !== "file";
+        case "BUTTON":
+        case "SELECT":
+        case "TEXTAREA":
+            return true;
+        default:
+            return false;
+    }
+}
+function processFindFocusableDescendant(element) {
+    if (!element)
+        return null;
+    for (const child of element.childNodes) {
+        if (isFocusable(child))
+            return child;
+        const focusable = processFindFocusableDescendant(child);
+        if (focusable)
+            return focusable;
+    }
+    return null;
+}
+function findFirstFocusableDescendant(focusContainer) {
+    return processFindFocusableDescendant(focusContainer);
+}
+function processFindLastFocusableDescendant(element) {
+    for (let i = element.childNodes.length - 1; i >= 0; i--) {
+        const child = element.childNodes[i];
+        const focusable = processFindLastFocusableDescendant(child);
+        if (focusable)
+            return focusable;
+        if (isFocusable(child))
+            return child;
+    }
+    return null;
+}
+function findLastFocusableDescendant(focusContainer) {
+    return processFindLastFocusableDescendant(focusContainer);
+}
+function getInitialFocusElement(focusContainer, initialFocusSpec) {
+    if (!focusContainer)
+        return null;
+    if (initialFocusSpec) {
+        if (typeof initialFocusSpec === "string") {
+            const node = focusContainer.querySelector(initialFocusSpec);
+            if (node) {
+                return node;
+            }
+            else {
+                Logger.logError(`${UiCore.packageName}.FocusTrap`, `Unable to locate element via selector ${initialFocusSpec}`);
+            }
+        }
+        else {
+            return initialFocusSpec.current;
+        }
+    }
+    return findFirstFocusableDescendant(focusContainer);
+}
+function attemptFocus(element, preventScroll) {
+    if (!isFocusable(element))
+        return false;
+    try {
+        if (document.activeElement !== element)
+            element.focus({
+                preventScroll: preventScroll ? true : false,
+            });
+    }
+    catch (e) {
+        return false;
+    }
+    return document.activeElement === element;
+} // end attemptFocus
+/** Focus into first focusable element of a container.
+ * @internal
+ */
+export function focusIntoContainer(focusContainer, initialFocusElement) {
+    let result = false;
+    const focusElement = getInitialFocusElement(focusContainer, initialFocusElement);
+    if (focusElement) {
+        // delay setting focus immediately because in some browsers other focus events happen when popup is initially opened.
+        setTimeout(() => {
+            attemptFocus(focusElement, true);
+        }, 60);
+        result = true;
+    }
+    return result;
+}
+/** Trap Focus in container while trap is active.
+ * @internal
+ */
+export function FocusTrap(props) {
+    const restoreFocusElement = React.useRef(null);
+    const initialFocusElement = React.useRef(null);
+    const focusContainer = React.useRef(null);
+    const isInitialMount = React.useRef(true);
+    const timeoutRef = React.useRef();
+    // Run on initial mount and when dependencies change. which could happen often.
+    React.useEffect(() => {
+        if (isInitialMount.current) {
+            isInitialMount.current = false;
+            if (props.active) {
+                if (props.returnFocusOnDeactivate) {
+                    restoreFocusElement.current = document.activeElement;
+                }
+                initialFocusElement.current = getInitialFocusElement(focusContainer.current, props.initialFocusElement);
+                if (initialFocusElement.current) {
+                    // delay setting focus immediately because in some browsers other focus events happen when popup is initially opened.
+                    timeoutRef.current = window.setTimeout(() => {
+                        attemptFocus(initialFocusElement.current, true);
+                    }, 60);
+                }
+            }
+        }
+    }, [
+        props.children,
+        props.initialFocusElement,
+        props.active,
+        props.returnFocusOnDeactivate,
+    ]);
+    // Return function to run only when FocusTrap is unmounted to restore focus
+    React.useEffect(() => {
+        return () => {
+            window.clearTimeout(timeoutRef.current);
+            if (restoreFocusElement.current)
+                restoreFocusElement.current.focus({
+                    preventScroll: true,
+                });
+        };
+    }, []);
+    // this is hit if Shift tab is used.
+    const cycleFocusToEnd = React.useCallback((event) => {
+        if (!props.active)
+            return;
+        if (focusContainer.current && event.target === focusContainer.current) {
+            event.stopPropagation();
+            event.preventDefault();
+            const focusable = findLastFocusableDescendant(focusContainer.current);
+            if (focusable) {
+                focusable.focus();
+            }
+            else {
+                if (initialFocusElement.current &&
+                    initialFocusElement.current !== document.activeElement)
+                    attemptFocus(initialFocusElement.current, true);
+            }
+        }
+    }, [props.active]);
+    // this is hit if tab is used on last focusable item in child container.
+    const cycleFocusToStart = React.useCallback((event) => {
+        if (!props.active)
+            return;
+        event.stopPropagation();
+        if (initialFocusElement.current &&
+            initialFocusElement.current !== document.activeElement)
+            initialFocusElement.current.focus();
+    }, [props.active]);
+    if (!props.children)
+        return null;
+    return (React.createElement(React.Fragment, null,
+        React.createElement("div", { "data-testid": "focus-trap-div", onFocus: cycleFocusToEnd, ref: focusContainer, 
+            /* eslint-disable-next-line jsx-a11y/no-noninteractive-tabindex */
+            tabIndex: 0, style: { outline: "none", WebkitTapHighlightColor: "rgba(0,0,0,0)" } }, props.children),
+        React.createElement("div", { "data-testid": "focus-trap-limit-div", onFocus: cycleFocusToStart, 
+            /* eslint-disable-next-line jsx-a11y/no-noninteractive-tabindex */
+            tabIndex: 0 })));
+}
+//# sourceMappingURL=FocusTrap.js.map

package/lib/core-react/focustrap/FocusTrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FocusTrap.js","sourceRoot":"","sources":["../../../src/core-react/focustrap/FocusTrap.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 Popup\n */\n\nimport * as React from \"react\";\nimport { Logger } from \"@itwin/core-bentley\";\nimport { UiCore } from \"../UiCore.js\";\n\n/* eslint-disable deprecation/deprecation */\n\nfunction isFocusable(element: HTMLElement): boolean {\n  if (!element || element.tabIndex < 0) return false;\n\n  if (\n    element.classList &&\n    element.classList.contains(\"core-focus-trap-ignore-initial\")\n  )\n    return false;\n\n  if (\n    element.getAttribute &&\n    typeof element.getAttribute === \"function\" &&\n    element.getAttribute(\"disabled\") !== null\n  )\n    return false;\n\n  if (\n    element.tabIndex > 0 ||\n    (element.tabIndex === 0 && element.getAttribute(\"tabIndex\") !== null)\n  )\n    return true;\n\n  switch (element.nodeName) {\n    case \"A\":\n      const anchorElement = element as HTMLAnchorElement;\n      return !!anchorElement.href && anchorElement.rel !== \"ignore\";\n    case \"INPUT\":\n      const inputElement = element as HTMLInputElement;\n      return inputElement.type !== \"hidden\" && inputElement.type !== \"file\";\n    case \"BUTTON\":\n    case \"SELECT\":\n    case \"TEXTAREA\":\n      return true;\n    default:\n      return false;\n  }\n}\n\nfunction processFindFocusableDescendant(\n  element: HTMLElement | null\n): HTMLElement | null {\n  if (!element) return null;\n\n  for (const child of element.childNodes) {\n    if (isFocusable(child as HTMLElement)) return child as HTMLElement;\n\n    const focusable = processFindFocusableDescendant(child as HTMLElement);\n    if (focusable) return focusable;\n  }\n  return null;\n}\n\nfunction findFirstFocusableDescendant(\n  focusContainer: HTMLDivElement | null\n): HTMLElement | null {\n  return processFindFocusableDescendant(focusContainer);\n}\n\nfunction processFindLastFocusableDescendant(\n  element: HTMLElement\n): HTMLElement | null {\n  for (let i = element.childNodes.length - 1; i >= 0; i--) {\n    const child = element.childNodes[i] as HTMLElement;\n\n    const focusable = processFindLastFocusableDescendant(child);\n    if (focusable) return focusable;\n\n    if (isFocusable(child)) return child;\n  }\n  return null;\n}\n\nfunction findLastFocusableDescendant(\n  focusContainer: HTMLDivElement\n): HTMLElement | null {\n  return processFindLastFocusableDescendant(focusContainer);\n}\n\nfunction getInitialFocusElement(\n  focusContainer: HTMLDivElement | null,\n  initialFocusSpec: React.RefObject<HTMLElement> | string | undefined\n): HTMLElement | null {\n  if (!focusContainer) return null;\n\n  if (initialFocusSpec) {\n    if (typeof initialFocusSpec === \"string\") {\n      const node = focusContainer.querySelector(initialFocusSpec);\n      if (node) {\n        return node as HTMLElement;\n      } else {\n        Logger.logError(\n          `${UiCore.packageName}.FocusTrap`,\n          `Unable to locate element via selector ${initialFocusSpec}`\n        );\n      }\n    } else {\n      return initialFocusSpec.current;\n    }\n  }\n  return findFirstFocusableDescendant(focusContainer);\n}\n\nfunction attemptFocus(element: HTMLElement, preventScroll: boolean): boolean {\n  if (!isFocusable(element)) return false;\n\n  try {\n    if (document.activeElement !== element)\n      element.focus({\n        preventScroll: preventScroll ? true : false,\n      });\n  } catch (e) {\n    return false;\n  }\n  return document.activeElement === element;\n} // end attemptFocus\n\n/** Focus into first focusable element of a container.\n * @internal\n */\nexport function focusIntoContainer(\n  focusContainer: HTMLDivElement,\n  initialFocusElement?: React.RefObject<HTMLElement> | string\n): boolean {\n  let result = false;\n  const focusElement = getInitialFocusElement(\n    focusContainer,\n    initialFocusElement\n  );\n  if (focusElement) {\n    // delay setting focus immediately because in some browsers other focus events happen when popup is initially opened.\n    setTimeout(() => {\n      attemptFocus(focusElement, true);\n    }, 60);\n    result = true;\n  }\n  return result;\n}\n\n/** Properties supported by [[FocusTrap]] component.\n * @internal\n */\nexport interface FocusTrapProps extends React.AllHTMLAttributes<any> {\n  /** child components */\n  children: React.ReactNode;\n  /** if active is not true then no trapping of focus is attempted. */\n  active?: boolean;\n  /** restore focus to element that had focus before trap was activated */\n  returnFocusOnDeactivate: boolean;\n  /** Optional reference to element to receive focus when trap is activated. Optionally a CSS Selector\n   * string can be supplied to locate an element in the FocusTrap container. If no specification is defined\n   * the first focusable element is used.\n   */\n  initialFocusElement?: React.RefObject<HTMLElement> | string;\n}\n\n/** Trap Focus in container while trap is active.\n * @internal\n */\nexport function FocusTrap(props: FocusTrapProps) {\n  const restoreFocusElement = React.useRef<Element | null>(null);\n  const initialFocusElement = React.useRef<Element | null>(null);\n  const focusContainer = React.useRef<HTMLDivElement | null>(null);\n  const isInitialMount = React.useRef(true);\n  const timeoutRef = React.useRef<number | undefined>();\n\n  // Run on initial mount and when dependencies change. which could happen often.\n  React.useEffect(() => {\n    if (isInitialMount.current) {\n      isInitialMount.current = false;\n      if (props.active) {\n        if (props.returnFocusOnDeactivate) {\n          restoreFocusElement.current = document.activeElement;\n        }\n\n        initialFocusElement.current = getInitialFocusElement(\n          focusContainer.current,\n          props.initialFocusElement\n        );\n        if (initialFocusElement.current) {\n          // delay setting focus immediately because in some browsers other focus events happen when popup is initially opened.\n          timeoutRef.current = window.setTimeout(() => {\n            attemptFocus(initialFocusElement.current as HTMLElement, true);\n          }, 60);\n        }\n      }\n    }\n  }, [\n    props.children,\n    props.initialFocusElement,\n    props.active,\n    props.returnFocusOnDeactivate,\n  ]);\n\n  // Return function to run only when FocusTrap is unmounted to restore focus\n  React.useEffect(() => {\n    return () => {\n      window.clearTimeout(timeoutRef.current);\n      if (restoreFocusElement.current)\n        (restoreFocusElement.current as HTMLElement).focus({\n          preventScroll: true,\n        });\n    };\n  }, []);\n\n  // this is hit if Shift tab is used.\n  const cycleFocusToEnd = React.useCallback(\n    (event: React.FocusEvent<HTMLDivElement>) => {\n      if (!props.active) return;\n\n      if (focusContainer.current && event.target === focusContainer.current) {\n        event.stopPropagation();\n        event.preventDefault();\n        const focusable = findLastFocusableDescendant(focusContainer.current);\n\n        if (focusable) {\n          focusable.focus();\n        } else {\n          if (\n            initialFocusElement.current &&\n            initialFocusElement.current !== document.activeElement\n          )\n            attemptFocus(initialFocusElement.current as HTMLElement, true);\n        }\n      }\n    },\n    [props.active]\n  );\n\n  // this is hit if tab is used on last focusable item in child container.\n  const cycleFocusToStart = React.useCallback(\n    (event: React.FocusEvent<HTMLDivElement>) => {\n      if (!props.active) return;\n\n      event.stopPropagation();\n      if (\n        initialFocusElement.current &&\n        initialFocusElement.current !== document.activeElement\n      )\n        (initialFocusElement.current as HTMLElement).focus();\n    },\n    [props.active]\n  );\n\n  if (!props.children) return null;\n  return (\n    <>\n      <div\n        data-testid=\"focus-trap-div\"\n        onFocus={cycleFocusToEnd}\n        ref={focusContainer}\n        /* eslint-disable-next-line jsx-a11y/no-noninteractive-tabindex */\n        tabIndex={0}\n        style={{ outline: \"none\", WebkitTapHighlightColor: \"rgba(0,0,0,0)\" }}\n      >\n        {props.children}\n      </div>\n      <div\n        data-testid=\"focus-trap-limit-div\"\n        onFocus={cycleFocusToStart}\n        /* eslint-disable-next-line jsx-a11y/no-noninteractive-tabindex */\n        tabIndex={0}\n      />\n    </>\n  );\n}\n"]}

package/lib/core-react/hocs/withIsPressed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"withIsPressed.d.ts","sourceRoot":"","sources":["../../../src/core-react/hocs/withIsPressed.tsx"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,uCAAuC;IACvC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,+CAA+C;IAC/C,iBAAiB,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,CAAC;CAClD;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa;;;;;qCAkBe,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;qCAAP,OAAO;;;;;;;;;;;;;;;;;;;;;;;;CAuB/C,CAAC"}

package/lib/core-react/hocs/withIsPressed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"withIsPressed.js","sourceRoot":"","sources":["../../../src/core-react/hocs/withIsPressed.tsx"],"names":[],"mappings":"AAAA;;;gGAGgG;AAChG;;GAEG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAa/B;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,SAA8C,EAC9C,EAAE;IACF,OAAO,MAAM,aAAc,SAAQ,KAAK,CAAC,aAExC;QAFM;;YAGE,wBAAmB,GAAG,GAAG,EAAE;gBAChC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;YAC7B,CAAC,CAAC;YAEK,sBAAiB,GAAG,GAAG,EAAE;gBAC9B,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;YAC9B,CAAC,CAAC;YAEK,uBAAkB,GAAG,GAAG,EAAE;gBAC/B,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;YAC9B,CAAC,CAAC;YAEK,oBAAe,GAAG,CAAC,SAAkB,EAAE,EAAE;gBAC9C,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,KAAK,SAAS;oBAAE,OAAO;gBAE/C,IAAI,CAAC,KAAK,CAAC,iBAAiB,IAAI,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;YAC1E,CAAC,CAAC;QAkBJ,CAAC;QAhBiB,MAAM;YACpB,MAAM,EAAE,SAAS,EAAE,iBAAiB,EAAE,GAAG,KAAK,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,2DAA2D;YAC1H,OAAO;YACL,mEAAmE;YACnE,6BACE,SAAS,EAAC,uBAAuB,EACjC,WAAW,EAAE,IAAI,CAAC,mBAAmB,EACrC,SAAS,EAAE,IAAI,CAAC,iBAAiB,EACjC,YAAY,EAAE,IAAI,CAAC,mBAAmB,EACtC,UAAU,EAAE,IAAI,CAAC,iBAAiB,EAClC,YAAY,EAAE,IAAI,CAAC,kBAAkB;gBAErC,oBAAC,SAAS,OAAM,KAAwB,KAAM,IAAI,CAAC,KAAK,GAAI,CACxD,CACP,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC,CAAC","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Common\n */\n\nimport * as React from \"react\";\n\n/** Properties for [[withIsPressed]] React higher-order component\n * @public\n * @deprecated in 4.15.0. Props of deprecated {@link withIsPressed} HOC.\n */\nexport interface WithIsPressedProps {\n  /** initial value for pressed status */\n  isPressed?: boolean;\n  /** callback function for [isPressed] change */\n  onIsPressedChange?: (isPressed: boolean) => void;\n}\n\n/** withIsPressed is a React higher-order component that adds pointer and mouse events.\n * @public\n * @deprecated in 4.15.0. Not used by AppUI.\n */\nexport const withIsPressed = <ComponentProps extends {}>(\n  Component: React.ComponentType<ComponentProps>\n) => {\n  return class WithIsPressed extends React.PureComponent<\n    ComponentProps & WithIsPressedProps // eslint-disable-line deprecation/deprecation\n  > {\n    public handleOnPointerDown = () => {\n      this.changeIsPressed(true);\n    };\n\n    public handleOnPointerUp = () => {\n      this.changeIsPressed(false);\n    };\n\n    public handleOnMouseLeave = () => {\n      this.changeIsPressed(false);\n    };\n\n    public changeIsPressed = (isPressed: boolean) => {\n      if (this.props.isPressed === isPressed) return;\n\n      this.props.onIsPressedChange && this.props.onIsPressedChange(isPressed);\n    };\n\n    public override render() {\n      const { isPressed, onIsPressedChange, ...props } = this.props; // todo: better solution to rest object of intersected type\n      return (\n        // eslint-disable-next-line jsx-a11y/no-static-element-interactions\n        <div\n          className=\"withispressed-wrapper\"\n          onMouseDown={this.handleOnPointerDown}\n          onMouseUp={this.handleOnPointerUp}\n          onTouchStart={this.handleOnPointerDown}\n          onTouchEnd={this.handleOnPointerUp}\n          onMouseLeave={this.handleOnMouseLeave}\n        >\n          <Component {...(props as ComponentProps)} {...this.state} />\n        </div>\n      );\n    }\n  };\n};\n"]}

package/lib/core-react/hocs/withOnOutsideClick.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"withOnOutsideClick.d.ts","sourceRoot":"","sources":["../../../src/core-react/hocs/withOnOutsideClick.tsx"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,sCAAsC;IACtC,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,GAAG,CAAC;IAC5C,8HAA8H;IAC9H,8BAA8B,CAAC,EAAE,OAAO,CAAC;CAC1C;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB,+GAEG,UAAU,KAAK,GAAG,4BACtC,OAAO,qBACD,OAAO;;QAKvB,gBAAgB;;QAEhB,gBAAgB;;QAGhB,gBAAgB;+BACc,WAAW,GAAG,OAAO;QAanD,gBAAgB;0BACS,UAAU;QAanC,gBAAgB;iCACiB,UAAU;QAW3C,gBAAgB;uCACuB,YAAY;QAUnD,gBAAgB;qCACqB,YAAY;sEAerB,cAAc,GAAG,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;QAxEjD,gBAAgB;;QAEhB,gBAAgB;;QAGhB,gBAAgB;+BACc,WAAW,GAAG,OAAO;QAanD,gBAAgB;0BACS,UAAU;QAanC,gBAAgB;iCACiB,UAAU;QAW3C,gBAAgB;uCACuB,YAAY;QAUnD,gBAAgB;qCACqB,YAAY;sEAerB,cAAc,GAAG,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;CA6DpD,CAAC"}

package/lib/core-react/hocs/withOnOutsideClick.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"withOnOutsideClick.js","sourceRoot":"","sources":["../../../src/core-react/hocs/withOnOutsideClick.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 Common\n */\n\nimport * as React from \"react\";\n\n/** Properties for [[withOnOutsideClick]] React higher-order component\n * @public\n * @deprecated in 4.15.0. Props of deprecated {@link withOnOutsideClick} HOC.\n */\nexport interface WithOnOutsideClickProps {\n  /** Outside click callback function */\n  onOutsideClick?: (event: MouseEvent) => any;\n  /** If false outside click processing and closing are skipped if click occurs in another Popup component, default to false. */\n  closeOnNestedPopupOutsideClick?: boolean;\n}\n\n/** withOnOutsideClick is a React higher-order component that adds outside click support.\n * @public\n * @deprecated in 4.15.0. Used internally.\n */\nexport const withOnOutsideClick = <ComponentProps extends {}>(\n  Component: React.ComponentType<ComponentProps>,\n  defaultOnOutsideClick?: (event: MouseEvent) => any,\n  useCapture: boolean = true,\n  usePointerEvents: boolean = true\n) => {\n  return class WithOnOutsideClick extends React.PureComponent<\n    ComponentProps & WithOnOutsideClickProps // eslint-disable-line deprecation/deprecation\n  > {\n    /** @internal */\n    public outsideClickContainerDiv?: HTMLDivElement | null = null;\n    /** @internal */\n    public isDownOutside = false;\n\n    /** @internal */\n    public isInCorePopup(element: HTMLElement): boolean {\n      if (element.nodeName === \"DIV\") {\n        if (element.classList && element.classList.contains(\"core-popup\"))\n          return true;\n        if (element.parentElement && this.isInCorePopup(element.parentElement))\n          return true;\n      } else {\n        if (element.parentElement && this.isInCorePopup(element.parentElement))\n          return true;\n      }\n      return false;\n    }\n\n    /** @internal */\n    public onOutsideClick(e: MouseEvent) {\n      if (e.target instanceof Node && e.target.nodeType === Node.ELEMENT_NODE) {\n        if (\n          !this.props.closeOnNestedPopupOutsideClick &&\n          this.isInCorePopup(e.target as HTMLElement)\n        )\n          return;\n      }\n\n      if (this.props.onOutsideClick) return this.props.onOutsideClick(e);\n      else if (defaultOnOutsideClick) return defaultOnOutsideClick(e);\n    }\n\n    /** @internal */\n    public handleDocumentClick = (e: MouseEvent) => {\n      if (\n        !this.outsideClickContainerDiv ||\n        !(e.target instanceof Node) ||\n        this.outsideClickContainerDiv.contains(e.target)\n      )\n        return;\n\n      return this.onOutsideClick(e);\n    };\n\n    /** @internal */\n    public handleDocumentPointerDown = (e: PointerEvent) => {\n      this.isDownOutside = true;\n      if (this.outsideClickContainerDiv) {\n        // typically e.target test for instance of Node, but this is not working from pop out windows\n        this.isDownOutside =\n          !!e.target &&\n          !this.outsideClickContainerDiv.contains(e.target as any);\n      }\n    };\n\n    /** @internal */\n    public handleDocumentPointerUp = (e: PointerEvent) => {\n      let isUpOutside = true;\n      if (this.outsideClickContainerDiv) {\n        // typically e.target test for instance of Node, but this is not working from pop out windows\n        isUpOutside =\n          !!e.target &&\n          !this.outsideClickContainerDiv.contains(e.target as any);\n      }\n\n      const isOutsideClick = isUpOutside && this.isDownOutside;\n      this.isDownOutside = false;\n      isOutsideClick && this.onOutsideClick(e);\n    };\n\n    public handleOutsideClickContainerDivSet = (\n      outsideClickContainerDiv: HTMLDivElement | null\n    ) => {\n      this.outsideClickContainerDiv = outsideClickContainerDiv;\n    };\n\n    public getParentDocument() {\n      return this.outsideClickContainerDiv?.ownerDocument ?? document;\n    }\n\n    public override componentDidMount() {\n      const outsideClickParentDocument = this.getParentDocument();\n      if (usePointerEvents) {\n        outsideClickParentDocument.addEventListener(\n          \"pointerdown\",\n          this.handleDocumentPointerDown,\n          useCapture\n        );\n        outsideClickParentDocument.addEventListener(\n          \"pointerup\",\n          this.handleDocumentPointerUp,\n          useCapture\n        );\n      } else\n        outsideClickParentDocument.addEventListener(\n          \"click\",\n          this.handleDocumentClick,\n          useCapture\n        );\n    }\n\n    public override componentWillUnmount() {\n      const outsideClickParentDocument = this.getParentDocument();\n      if (usePointerEvents) {\n        outsideClickParentDocument.removeEventListener(\n          \"pointerdown\",\n          this.handleDocumentPointerDown,\n          useCapture\n        );\n        outsideClickParentDocument.removeEventListener(\n          \"pointerup\",\n          this.handleDocumentPointerUp,\n          useCapture\n        );\n      } else\n        outsideClickParentDocument.removeEventListener(\n          \"click\",\n          this.handleDocumentClick,\n          useCapture\n        );\n    }\n\n    public override render() {\n      const { onOutsideClick, closeOnNestedPopupOutsideClick, ...props } =\n        this.props;\n      return (\n        <div ref={this.handleOutsideClickContainerDivSet}>\n          <Component {...(props as ComponentProps)} />\n        </div>\n      );\n    }\n  };\n};\n"]}

package/lib/core-react/hocs/withTimeout.d.ts

@@ -0,0 +1,73 @@
+/** @packageDocumentation
+ * @module Common
+ */
+import * as React from "react";
+import { Timer } from "../utils/Timer.js";
+/** Properties for [[withTimeout]] React higher-order component
+ * @public
+ * @deprecated in 4.15.0. Props of deprecated {@link withTimeout} HOC.
+ */
+export interface WithTimeoutProps {
+    /** Timeout duration in milliseconds */
+    timeout: number;
+    /** Callback function for timeout */
+    onTimeout?: () => void;
+}
+/** withTimeout is a React higher-order component that adds timeout support.
+ * @public
+ * @deprecated in 4.15.0. Not used by AppUI.
+ */
+export declare const withTimeout: <ComponentProps extends {}>(Component: React.ComponentType<ComponentProps>) => {
+    new (props: ComponentProps & WithTimeoutProps): {
+        timer: Timer;
+        componentDidMount(): void;
+        componentDidUpdate(_prevProps: Readonly<ComponentProps & WithTimeoutProps>): void;
+        componentWillUnmount(): void;
+        render(): React.JSX.Element;
+        startTimer(timeout: number): void;
+        context: unknown;
+        setState<K extends never>(state: {} | ((prevState: Readonly<{}>, props: Readonly<ComponentProps & WithTimeoutProps>) => {} | Pick<{}, K> | null) | Pick<{}, K> | null, callback?: (() => void) | undefined): void;
+        forceUpdate(callback?: (() => void) | undefined): void;
+        readonly props: Readonly<ComponentProps & WithTimeoutProps>;
+        state: Readonly<{}>;
+        refs: {
+            [key: string]: React.ReactInstance;
+        };
+        shouldComponentUpdate?(nextProps: Readonly<ComponentProps & WithTimeoutProps>, nextState: Readonly<{}>, nextContext: any): boolean;
+        componentDidCatch?(error: Error, errorInfo: React.ErrorInfo): void;
+        getSnapshotBeforeUpdate?(prevProps: Readonly<ComponentProps & WithTimeoutProps>, prevState: Readonly<{}>): any;
+        componentWillMount?(): void;
+        UNSAFE_componentWillMount?(): void;
+        componentWillReceiveProps?(nextProps: Readonly<ComponentProps & WithTimeoutProps>, nextContext: any): void;
+        UNSAFE_componentWillReceiveProps?(nextProps: Readonly<ComponentProps & WithTimeoutProps>, nextContext: any): void;
+        componentWillUpdate?(nextProps: Readonly<ComponentProps & WithTimeoutProps>, nextState: Readonly<{}>, nextContext: any): void;
+        UNSAFE_componentWillUpdate?(nextProps: Readonly<ComponentProps & WithTimeoutProps>, nextState: Readonly<{}>, nextContext: any): void;
+    };
+    new (props: ComponentProps & WithTimeoutProps, context: any): {
+        timer: Timer;
+        componentDidMount(): void;
+        componentDidUpdate(_prevProps: Readonly<ComponentProps & WithTimeoutProps>): void;
+        componentWillUnmount(): void;
+        render(): React.JSX.Element;
+        startTimer(timeout: number): void;
+        context: unknown;
+        setState<K extends never>(state: {} | ((prevState: Readonly<{}>, props: Readonly<ComponentProps & WithTimeoutProps>) => {} | Pick<{}, K> | null) | Pick<{}, K> | null, callback?: (() => void) | undefined): void;
+        forceUpdate(callback?: (() => void) | undefined): void;
+        readonly props: Readonly<ComponentProps & WithTimeoutProps>;
+        state: Readonly<{}>;
+        refs: {
+            [key: string]: React.ReactInstance;
+        };
+        shouldComponentUpdate?(nextProps: Readonly<ComponentProps & WithTimeoutProps>, nextState: Readonly<{}>, nextContext: any): boolean;
+        componentDidCatch?(error: Error, errorInfo: React.ErrorInfo): void;
+        getSnapshotBeforeUpdate?(prevProps: Readonly<ComponentProps & WithTimeoutProps>, prevState: Readonly<{}>): any;
+        componentWillMount?(): void;
+        UNSAFE_componentWillMount?(): void;
+        componentWillReceiveProps?(nextProps: Readonly<ComponentProps & WithTimeoutProps>, nextContext: any): void;
+        UNSAFE_componentWillReceiveProps?(nextProps: Readonly<ComponentProps & WithTimeoutProps>, nextContext: any): void;
+        componentWillUpdate?(nextProps: Readonly<ComponentProps & WithTimeoutProps>, nextState: Readonly<{}>, nextContext: any): void;
+        UNSAFE_componentWillUpdate?(nextProps: Readonly<ComponentProps & WithTimeoutProps>, nextState: Readonly<{}>, nextContext: any): void;
+    };
+    contextType?: React.Context<any> | undefined;
+};
+//# sourceMappingURL=withTimeout.d.ts.map

package/lib/core-react/hocs/withTimeout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"withTimeout.d.ts","sourceRoot":"","sources":["../../../src/core-react/hocs/withTimeout.tsx"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE1C;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW;;eAON,KAAK;6BAEkB,IAAI;qFAStC,IAAI;gCAIiC,IAAI;;4BASjB,MAAM;;;;;;;;;;;;;;;;;;;;eAxBnB,KAAK;6BAEkB,IAAI;qFAStC,IAAI;gCAIiC,IAAI;;4BASjB,MAAM;;;;;;;;;;;;;;;;;;;;CAOpC,CAAC"}

package/lib/core-react/hocs/withTimeout.js

@@ -0,0 +1,44 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Common
+ */
+import * as React from "react";
+import { Timer } from "../utils/Timer.js";
+/** withTimeout is a React higher-order component that adds timeout support.
+ * @public
+ * @deprecated in 4.15.0. Not used by AppUI.
+ */
+export const withTimeout = (Component) => {
+    return class WithTimeout extends React.PureComponent {
+        constructor() {
+            super(...arguments);
+            // eslint-disable-next-line deprecation/deprecation
+            this.timer = new Timer(0);
+        }
+        componentDidMount() {
+            this.timer.setOnExecute(() => this.props.onTimeout && this.props.onTimeout());
+            this.startTimer(this.props.timeout);
+        }
+        componentDidUpdate(_prevProps // eslint-disable-line deprecation/deprecation
+        ) {
+            this.startTimer(this.props.timeout);
+        }
+        componentWillUnmount() {
+            this.timer.stop();
+        }
+        render() {
+            const { timeout, onTimeout, ...props } = this.props;
+            return React.createElement(Component, { ...props, ...this.state });
+        }
+        startTimer(timeout) {
+            if (this.timer.isRunning)
+                return;
+            this.timer.delay = timeout;
+            this.timer.start();
+        }
+    };
+};
+//# sourceMappingURL=withTimeout.js.map

package/lib/core-react/hocs/withTimeout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"withTimeout.js","sourceRoot":"","sources":["../../../src/core-react/hocs/withTimeout.tsx"],"names":[],"mappings":"AAAA;;;gGAGgG;AAChG;;GAEG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAa1C;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,SAA8C,EAC9C,EAAE;IACF,OAAO,MAAM,WAAY,SAAQ,KAAK,CAAC,aAEtC;QAFM;;YAGL,mDAAmD;YAC5C,UAAK,GAAU,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC;QA8BrC,CAAC;QA5BiB,iBAAiB;YAC/B,IAAI,CAAC,KAAK,CAAC,YAAY,CACrB,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CACrD,CAAC;YACF,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACtC,CAAC;QAEe,kBAAkB,CAChC,UAAuD,CAAC,8CAA8C;;YAEtG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACtC,CAAC;QAEe,oBAAoB;YAClC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QACpB,CAAC;QAEe,MAAM;YACpB,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;YACpD,OAAO,oBAAC,SAAS,OAAM,KAAa,KAAM,IAAI,CAAC,KAAK,GAAI,CAAC;QAC3D,CAAC;QAEM,UAAU,CAAC,OAAe;YAC/B,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS;gBAAE,OAAO;YAEjC,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,OAAO,CAAC;YAC3B,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACrB,CAAC;KACF,CAAC;AACJ,CAAC,CAAC","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Common\n */\n\nimport * as React from \"react\";\nimport { Timer } from \"../utils/Timer.js\";\n\n/** Properties for [[withTimeout]] React higher-order component\n * @public\n * @deprecated in 4.15.0. Props of deprecated {@link withTimeout} HOC.\n */\nexport interface WithTimeoutProps {\n  /** Timeout duration in milliseconds */\n  timeout: number;\n  /** Callback function for timeout */\n  onTimeout?: () => void;\n}\n\n/** withTimeout is a React higher-order component that adds timeout support.\n * @public\n * @deprecated in 4.15.0. Not used by AppUI.\n */\nexport const withTimeout = <ComponentProps extends {}>(\n  Component: React.ComponentType<ComponentProps>\n) => {\n  return class WithTimeout extends React.PureComponent<\n    ComponentProps & WithTimeoutProps // eslint-disable-line deprecation/deprecation\n  > {\n    // eslint-disable-next-line deprecation/deprecation\n    public timer: Timer = new Timer(0);\n\n    public override componentDidMount(): void {\n      this.timer.setOnExecute(\n        () => this.props.onTimeout && this.props.onTimeout()\n      );\n      this.startTimer(this.props.timeout);\n    }\n\n    public override componentDidUpdate(\n      _prevProps: Readonly<ComponentProps & WithTimeoutProps> // eslint-disable-line deprecation/deprecation\n    ): void {\n      this.startTimer(this.props.timeout);\n    }\n\n    public override componentWillUnmount(): void {\n      this.timer.stop();\n    }\n\n    public override render() {\n      const { timeout, onTimeout, ...props } = this.props;\n      return <Component {...(props as any)} {...this.state} />;\n    }\n\n    public startTimer(timeout: number) {\n      if (this.timer.isRunning) return;\n\n      this.timer.delay = timeout;\n      this.timer.start();\n    }\n  };\n};\n"]}

package/lib/core-react/icons/ConditionalIconItem.d.ts

@@ -0,0 +1,28 @@
+/** @packageDocumentation
+ * @module Icon
+ */
+import type { IconSpec } from "./IconComponent.js";
+/** Class used to return an icon. The icon is variable and can be changed in response to subscribed event ids.
+ * @public
+ * @deprecated in 4.16.0. Uses a deprecated {@link IconSpec} type. Use conditional rendering to render different icons.
+ */
+export declare class ConditionalIconItem {
+    readonly iconGetter: () => IconSpec;
+    readonly syncEventIds: string[];
+    private _value?;
+    /** Constructor for ConditionalIconItem
+     * @param iconGetter Function to retrieve the icon that matches the condition. Returns an IconSpec.
+     * @param syncEventIds The array of event ids to be monitored. These events are triggered when the condition(s) that control the icon change.
+     * @param value The default IconSpec. If this is not specified, the function is run to get the initial value.
+     */
+    constructor(iconGetter: () => IconSpec, syncEventIds: string[], value?: IconSpec);
+    /** The current IconSpec according to conditions */
+    get value(): IconSpec;
+    /** Called to update the value by running the iconGetter */
+    refresh(): boolean;
+    /** A helper function that updates the IconSpec value when the specified events are triggered */
+    static refreshValue(conditionalValue: ConditionalIconItem | string | undefined, eventIds: Set<string>): boolean;
+    /** helper function to get the iconSpec from a ConditionIconItem as IconSpec | undefined*/
+    static getValue(conditionalValue: ConditionalIconItem | string | undefined): IconSpec | undefined;
+}
+//# sourceMappingURL=ConditionalIconItem.d.ts.map

package/lib/core-react/icons/ConditionalIconItem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConditionalIconItem.d.ts","sourceRoot":"","sources":["../../../src/core-react/icons/ConditionalIconItem.tsx"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAInD;;;GAGG;AACH,qBAAa,mBAAmB;aASZ,UAAU,EAAE,MAAM,QAAQ;aAC1B,YAAY,EAAE,MAAM,EAAE;IATxC,OAAO,CAAC,MAAM,CAAC,CAAW;IAE1B;;;;OAIG;gBAEe,UAAU,EAAE,MAAM,QAAQ,EAC1B,YAAY,EAAE,MAAM,EAAE,EACtC,KAAK,CAAC,EAAE,QAAQ;IAKlB,mDAAmD;IACnD,IAAW,KAAK,IAAI,QAAQ,CAI3B;IAED,2DAA2D;IACpD,OAAO,IAAI,OAAO;IAUzB,gGAAgG;WAClF,YAAY,CACxB,gBAAgB,EAAE,mBAAmB,GAAG,MAAM,GAAG,SAAS,EAC1D,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,GACpB,OAAO;IAkBV,0FAA0F;WAC5E,QAAQ,CACpB,gBAAgB,EAAE,mBAAmB,GAAG,MAAM,GAAG,SAAS,GACzD,QAAQ,GAAG,SAAS;CAUxB"}