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

package/lib/core-react/uistate/UiStateEntry.js

@@ -0,0 +1,58 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module UiStateStorage
+ */
+import { UiStateStorageStatus } from "./UiStateStorage.js";
+/* eslint-disable deprecation/deprecation */
+/** A single UI State entry that is identified by namespace and setting name.
+ * @public
+ * @deprecated in 4.16.0. Use {@link UiStateStorage} APIs instead.
+ */
+export class UiStateEntry {
+    /** Constructor
+     * @param settingNamespace  Namespace for the setting, passed to UiStateStorage.
+     * @param settingName       Name for the setting, passed to UiStateStorage.
+     * @param getValue          Function for getting the value from the application.
+     * @param applyValue        Function for applying the setting value to the application.
+     * @param defaultValue      Optional default value if not already stored.
+     */
+    constructor(settingNamespace, settingName, getValue, applyValue, defaultValue) {
+        this.settingNamespace = settingNamespace;
+        this.settingName = settingName;
+        this.getValue = getValue;
+        this.applyValue = applyValue;
+        this.defaultValue = defaultValue;
+    }
+    /** Gets the setting from [[UiStateStorage]] */
+    async getSetting(storage) {
+        return storage.getSetting(this.settingNamespace, this.settingName);
+    }
+    /** Saves the setting value from the `getValue` function to UiStateStorage */
+    async saveSetting(storage) {
+        return storage.saveSetting(this.settingNamespace, this.settingName, this.getValue());
+    }
+    /** Deletes the setting from UiStateStorage */
+    async deleteSetting(storage) {
+        return storage.deleteSetting(this.settingNamespace, this.settingName);
+    }
+    /** Gets the setting from UiStateStorage and applies the value using the `applyValue` function */
+    async getSettingAndApplyValue(storage) {
+        if (this.applyValue) {
+            const result = await this.getSetting(storage);
+            if (result.status === UiStateStorageStatus.Success) {
+                this.applyValue(result.setting);
+            }
+            else if (undefined !== this.defaultValue) {
+                this.applyValue(this.defaultValue);
+                result.setting = this.defaultValue;
+                result.status = UiStateStorageStatus.Success;
+            }
+            return result;
+        }
+        return { status: UiStateStorageStatus.Uninitialized };
+    }
+}
+//# sourceMappingURL=UiStateEntry.js.map

package/lib/core-react/uistate/UiStateEntry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UiStateEntry.js","sourceRoot":"","sources":["../../../src/core-react/uistate/UiStateEntry.ts"],"names":[],"mappings":"AAAA;;;gGAGgG;AAChG;;GAEG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3D,4CAA4C;AAE5C;;;GAGG;AACH,MAAM,OAAO,YAAY;IACvB;;;;;;OAMG;IACH,YACS,gBAAwB,EACxB,WAAmB,EACnB,QAAiB,EACjB,UAA2B,EAC3B,YAAgB;QAJhB,qBAAgB,GAAhB,gBAAgB,CAAQ;QACxB,gBAAW,GAAX,WAAW,CAAQ;QACnB,aAAQ,GAAR,QAAQ,CAAS;QACjB,eAAU,GAAV,UAAU,CAAiB;QAC3B,iBAAY,GAAZ,YAAY,CAAI;IACtB,CAAC;IAEJ,+CAA+C;IACxC,KAAK,CAAC,UAAU,CACrB,OAAuB;QAEvB,OAAO,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,gBAAgB,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IACrE,CAAC;IAED,6EAA6E;IACtE,KAAK,CAAC,WAAW,CACtB,OAAuB;QAEvB,OAAO,OAAO,CAAC,WAAW,CACxB,IAAI,CAAC,gBAAgB,EACrB,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,QAAQ,EAAE,CAChB,CAAC;IACJ,CAAC;IAED,8CAA8C;IACvC,KAAK,CAAC,aAAa,CACxB,OAAuB;QAEvB,OAAO,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,gBAAgB,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IACxE,CAAC;IAED,iGAAiG;IAC1F,KAAK,CAAC,uBAAuB,CAClC,OAAuB;QAEvB,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;YAC9C,IAAI,MAAM,CAAC,MAAM,KAAK,oBAAoB,CAAC,OAAO,EAAE,CAAC;gBACnD,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAClC,CAAC;iBAAM,IAAI,SAAS,KAAK,IAAI,CAAC,YAAY,EAAE,CAAC;gBAC3C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;gBACnC,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC;gBACnC,MAAM,CAAC,MAAM,GAAG,oBAAoB,CAAC,OAAO,CAAC;YAC/C,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,oBAAoB,CAAC,aAAa,EAAE,CAAC;IACxD,CAAC;CACF","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module UiStateStorage\n */\n\nimport type { UiStateStorage, UiStateStorageResult } from \"./UiStateStorage.js\";\nimport { UiStateStorageStatus } from \"./UiStateStorage.js\";\n\n/* eslint-disable deprecation/deprecation */\n\n/** A single UI State entry that is identified by namespace and setting name.\n * @public\n * @deprecated in 4.16.0. Use {@link UiStateStorage} APIs instead.\n */\nexport class UiStateEntry<T> {\n  /** Constructor\n   * @param settingNamespace  Namespace for the setting, passed to UiStateStorage.\n   * @param settingName       Name for the setting, passed to UiStateStorage.\n   * @param getValue          Function for getting the value from the application.\n   * @param applyValue        Function for applying the setting value to the application.\n   * @param defaultValue      Optional default value if not already stored.\n   */\n  public constructor(\n    public settingNamespace: string,\n    public settingName: string,\n    public getValue: () => T,\n    public applyValue?: (v: T) => void,\n    public defaultValue?: T\n  ) {}\n\n  /** Gets the setting from [[UiStateStorage]] */\n  public async getSetting(\n    storage: UiStateStorage\n  ): Promise<UiStateStorageResult> {\n    return storage.getSetting(this.settingNamespace, this.settingName);\n  }\n\n  /** Saves the setting value from the `getValue` function to UiStateStorage */\n  public async saveSetting(\n    storage: UiStateStorage\n  ): Promise<UiStateStorageResult> {\n    return storage.saveSetting(\n      this.settingNamespace,\n      this.settingName,\n      this.getValue()\n    );\n  }\n\n  /** Deletes the setting from UiStateStorage */\n  public async deleteSetting(\n    storage: UiStateStorage\n  ): Promise<UiStateStorageResult> {\n    return storage.deleteSetting(this.settingNamespace, this.settingName);\n  }\n\n  /** Gets the setting from UiStateStorage and applies the value using the `applyValue` function */\n  public async getSettingAndApplyValue(\n    storage: UiStateStorage\n  ): Promise<UiStateStorageResult> {\n    if (this.applyValue) {\n      const result = await this.getSetting(storage);\n      if (result.status === UiStateStorageStatus.Success) {\n        this.applyValue(result.setting);\n      } else if (undefined !== this.defaultValue) {\n        this.applyValue(this.defaultValue);\n        result.setting = this.defaultValue;\n        result.status = UiStateStorageStatus.Success;\n      }\n      return result;\n    }\n    return { status: UiStateStorageStatus.Uninitialized };\n  }\n}\n"]}

package/lib/core-react/uistate/UiStateStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UiStateStorage.d.ts","sourceRoot":"","sources":["../../../src/core-react/uistate/UiStateStorage.ts"],"names":[],"mappings":"AAIA;;GAEG;AAIH;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,UAAU,CACR,gBAAgB,EAAE,MAAM,EACxB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACjC,WAAW,CACT,gBAAgB,EAAE,MAAM,EACxB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,GAAG,GACX,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACjC,aAAa,CACX,gBAAgB,EAAE,MAAM,EACxB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,oBAAoB,CAAC,CAAC;CAClC;AAED;;;GAGG;AACH,oBAAY,oBAAoB;IAC9B,OAAO,IAAI;IACX,QAAQ,IAAI;IACZ,YAAY,IAAI;IAChB,aAAa,IAAI;IACjB,kBAAkB,IAAI;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,oBAAoB,CAAC;IAC7B,OAAO,CAAC,EAAE,GAAG,CAAC;CACf"}

package/lib/core-react/uistate/UiStateStorage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UiStateStorage.js","sourceRoot":"","sources":["../../../src/core-react/uistate/UiStateStorage.ts"],"names":[],"mappings":"AAAA;;;gGAGgG;AAChG;;GAEG;AAwBH;;;GAGG;AACH,MAAM,CAAN,IAAY,oBAMX;AAND,WAAY,oBAAoB;IAC9B,qEAAW,CAAA;IACX,uEAAY,CAAA;IACZ,+EAAgB,CAAA;IAChB,iFAAiB,CAAA;IACjB,2FAAsB,CAAA;AACxB,CAAC,EANW,oBAAoB,KAApB,oBAAoB,QAM/B","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 UiStateStorage\n */\n\n/* eslint-disable deprecation/deprecation */\n\n/** Interface for getting, saving and deleting settings.\n * @public\n * @deprecated in 4.16.0. Use {@link @itwin/appui-react#UiStateStorage} instead.\n */\nexport interface UiStateStorage {\n  getSetting(\n    settingNamespace: string,\n    settingName: string\n  ): Promise<UiStateStorageResult>;\n  saveSetting(\n    settingNamespace: string,\n    settingName: string,\n    setting: any\n  ): Promise<UiStateStorageResult>;\n  deleteSetting(\n    settingNamespace: string,\n    settingName: string\n  ): Promise<UiStateStorageResult>;\n}\n\n/** Enum for [[UiStateStorage]] status.\n * @public\n * @deprecated in 4.16.0. Use {@link @itwin/appui-react#UiStateStorageStatus} instead.\n */\nexport enum UiStateStorageStatus {\n  Success = 0,\n  NotFound = 1,\n  UnknownError = 2,\n  Uninitialized = 3,\n  AuthorizationError = 4,\n}\n\n/** Interface for result of accessing UI state setting in [[UiStateStorage]].\n * @public\n * @deprecated in 4.16.0. Use {@link @itwin/appui-react#UiStateStorageResult} instead.\n */\nexport interface UiStateStorageResult {\n  status: UiStateStorageStatus;\n  setting?: any;\n}\n"]}

package/lib/core-react/utils/IconHelper.d.ts

@@ -0,0 +1,27 @@
+/** @packageDocumentation
+ * @module Utilities
+ */
+import * as React from "react";
+import { ConditionalStringValue } from "@itwin/appui-abstract";
+import type { IconSpec } from "../icons/IconComponent.js";
+import { ConditionalIconItem } from "../icons/ConditionalIconItem.js";
+/** Icon Helper Class used to store the data needed to generate an <Icon> for use in any control that shows an icon.
+ * @public
+ * @deprecated in 4.15.0. Used internally.
+ */
+export declare class IconHelper {
+    static get reactIconKey(): string;
+    static get conditionalIconItemKey(): string;
+    /** Returns an <Icon> ReactNode from the many ways an icon can be specified.
+     * @param icon abstract icon specification.
+     * @param internalData a map that may hold a React.ReactNode stored in an abstract item definition.
+     */
+    static getIconReactNode(icon: string | ConditionalStringValue | React.ReactNode | ConditionalIconItem, internalData?: Map<string, any>): React.ReactNode;
+    /** Returns an icon definition that can be stored in an abstract item definition. If the iconSpec specifies a ReactNode
+     * then the react data is stored in the internalData map and the key to the react data is returned.
+     * @param iconSpec any supported variations of how an icon can be defined in an abstract item or IconProps.
+     * @param internalData a map supplied by the caller to store away react element if React.ReactNode
+     */
+    static getIconData(iconSpec: IconSpec, internalData?: Map<string, any>): string | ConditionalStringValue;
+}
+//# sourceMappingURL=IconHelper.d.ts.map

package/lib/core-react/utils/IconHelper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IconHelper.d.ts","sourceRoot":"","sources":["../../../src/core-react/utils/IconHelper.tsx"],"names":[],"mappings":"AAIA;;GAEG;AAIH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAE1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAEtE;;;GAGG;AACH,qBAAa,UAAU;IACrB,WAAkB,YAAY,IAAI,MAAM,CAEvC;IACD,WAAkB,sBAAsB,IAAI,MAAM,CAEjD;IACD;;;OAGG;WACW,gBAAgB,CAC5B,IAAI,EACA,MAAM,GACN,sBAAsB,GACtB,KAAK,CAAC,SAAS,GACf,mBAAmB,EACvB,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,GAC9B,KAAK,CAAC,SAAS;IAmClB;;;;OAIG;WACW,WAAW,CACvB,QAAQ,EAAE,QAAQ,EAClB,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,GAC9B,MAAM,GAAG,sBAAsB;CA0BnC"}

package/lib/core-react/utils/IconHelper.js

@@ -0,0 +1,82 @@
+/*---------------------------------------------------------------------------------------------
+ * 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
+ */
+/* eslint-disable deprecation/deprecation */
+import * as React from "react";
+import { ConditionalStringValue } from "@itwin/appui-abstract";
+import { Icon } from "../icons/IconComponent.js";
+import { ConditionalIconItem } from "../icons/ConditionalIconItem.js";
+/** Icon Helper Class used to store the data needed to generate an <Icon> for use in any control that shows an icon.
+ * @public
+ * @deprecated in 4.15.0. Used internally.
+ */
+export class IconHelper {
+    static get reactIconKey() {
+        return "#-react-iconspec-node-#";
+    }
+    static get conditionalIconItemKey() {
+        return "#-conditional-icon-item-node-#";
+    }
+    /** Returns an <Icon> ReactNode from the many ways an icon can be specified.
+     * @param icon abstract icon specification.
+     * @param internalData a map that may hold a React.ReactNode stored in an abstract item definition.
+     */
+    static getIconReactNode(icon, internalData) {
+        if (!icon)
+            return null;
+        if (icon instanceof ConditionalIconItem)
+            return React.createElement(Icon, { iconSpec: ConditionalIconItem.getValue(icon) });
+        if (React.isValidElement(icon))
+            return React.createElement(Icon, { iconSpec: icon });
+        if (!(icon instanceof ConditionalStringValue) && typeof icon !== "string")
+            return null;
+        const iconString = ConditionalStringValue.getValue(icon);
+        if (!iconString)
+            return null;
+        if (iconString === IconHelper.reactIconKey) {
+            if (internalData)
+                return (React.createElement(Icon, { iconSpec: internalData.get(IconHelper.reactIconKey) }));
+            return null;
+        }
+        else if (iconString === IconHelper.conditionalIconItemKey) {
+            if (internalData) {
+                const iconItem = internalData.get(IconHelper.conditionalIconItemKey);
+                return React.createElement(Icon, { iconSpec: ConditionalIconItem.getValue(iconItem) });
+            }
+            return null;
+        }
+        return React.createElement(Icon, { iconSpec: iconString });
+    }
+    /** Returns an icon definition that can be stored in an abstract item definition. If the iconSpec specifies a ReactNode
+     * then the react data is stored in the internalData map and the key to the react data is returned.
+     * @param iconSpec any supported variations of how an icon can be defined in an abstract item or IconProps.
+     * @param internalData a map supplied by the caller to store away react element if React.ReactNode
+     */
+    static getIconData(iconSpec, internalData) {
+        let icon;
+        if (iconSpec instanceof ConditionalIconItem) {
+            icon = IconHelper.conditionalIconItemKey;
+            if (internalData)
+                internalData.set(IconHelper.conditionalIconItemKey, iconSpec);
+            return icon;
+        }
+        else {
+            icon = React.isValidElement(iconSpec)
+                ? IconHelper.reactIconKey
+                : iconSpec;
+        }
+        if (internalData &&
+            typeof icon === "string" &&
+            icon === IconHelper.reactIconKey) {
+            internalData.set(IconHelper.reactIconKey, iconSpec);
+        }
+        if (typeof icon === "string" || icon instanceof ConditionalStringValue)
+            return icon;
+        return "";
+    }
+}
+//# sourceMappingURL=IconHelper.js.map

package/lib/core-react/utils/IconHelper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IconHelper.js","sourceRoot":"","sources":["../../../src/core-react/utils/IconHelper.tsx"],"names":[],"mappings":"AAAA;;;gGAGgG;AAChG;;GAEG;AAEH,4CAA4C;AAE5C,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,OAAO,EAAE,IAAI,EAAE,MAAM,2BAA2B,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAEtE;;;GAGG;AACH,MAAM,OAAO,UAAU;IACd,MAAM,KAAK,YAAY;QAC5B,OAAO,yBAAyB,CAAC;IACnC,CAAC;IACM,MAAM,KAAK,sBAAsB;QACtC,OAAO,gCAAgC,CAAC;IAC1C,CAAC;IACD;;;OAGG;IACI,MAAM,CAAC,gBAAgB,CAC5B,IAIuB,EACvB,YAA+B;QAE/B,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC;QAEvB,IAAI,IAAI,YAAY,mBAAmB;YACrC,OAAO,oBAAC,IAAI,IAAC,QAAQ,EAAE,mBAAmB,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAI,CAAC;QAChE,IAAI,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC;YAAE,OAAO,oBAAC,IAAI,IAAC,QAAQ,EAAE,IAAI,GAAI,CAAC;QAEhE,IAAI,CAAC,CAAC,IAAI,YAAY,sBAAsB,CAAC,IAAI,OAAO,IAAI,KAAK,QAAQ;YACvE,OAAO,IAAI,CAAC;QAEd,MAAM,UAAU,GAAG,sBAAsB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACzD,IAAI,CAAC,UAAU;YAAE,OAAO,IAAI,CAAC;QAE7B,IAAI,UAAU,KAAK,UAAU,CAAC,YAAY,EAAE,CAAC;YAC3C,IAAI,YAAY;gBACd,OAAO,CACL,oBAAC,IAAI,IACH,QAAQ,EACN,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,YAAY,CAAoB,GAE9D,CACH,CAAC;YACJ,OAAO,IAAI,CAAC;QACd,CAAC;aAAM,IAAI,UAAU,KAAK,UAAU,CAAC,sBAAsB,EAAE,CAAC;YAC5D,IAAI,YAAY,EAAE,CAAC;gBACjB,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAC/B,UAAU,CAAC,sBAAsB,CACX,CAAC;gBACzB,OAAO,oBAAC,IAAI,IAAC,QAAQ,EAAE,mBAAmB,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAI,CAAC;YACpE,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,oBAAC,IAAI,IAAC,QAAQ,EAAE,UAAU,GAAI,CAAC;IACxC,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,WAAW,CACvB,QAAkB,EAClB,YAA+B;QAE/B,IAAI,IAAI,CAAC;QACT,IAAI,QAAQ,YAAY,mBAAmB,EAAE,CAAC;YAC5C,IAAI,GAAG,UAAU,CAAC,sBAAsB,CAAC;YACzC,IAAI,YAAY;gBACd,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,sBAAsB,EAAE,QAAQ,CAAC,CAAC;YAChE,OAAO,IAAI,CAAC;QACd,CAAC;aAAM,CAAC;YACN,IAAI,GAAG,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC;gBACnC,CAAC,CAAC,UAAU,CAAC,YAAY;gBACzB,CAAC,CAAC,QAAQ,CAAC;QACf,CAAC;QAED,IACE,YAAY;YACZ,OAAO,IAAI,KAAK,QAAQ;YACxB,IAAI,KAAK,UAAU,CAAC,YAAY,EAChC,CAAC;YACD,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;QACtD,CAAC;QAED,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,YAAY,sBAAsB;YACpE,OAAO,IAAI,CAAC;QAEd,OAAO,EAAE,CAAC;IACZ,CAAC;CACF","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Utilities\n */\n\n/* eslint-disable deprecation/deprecation */\n\nimport * as React from \"react\";\nimport { ConditionalStringValue } from \"@itwin/appui-abstract\";\nimport type { IconSpec } from \"../icons/IconComponent.js\";\nimport { Icon } from \"../icons/IconComponent.js\";\nimport { ConditionalIconItem } from \"../icons/ConditionalIconItem.js\";\n\n/** Icon Helper Class used to store the data needed to generate an <Icon> for use in any control that shows an icon.\n * @public\n * @deprecated in 4.15.0. Used internally.\n */\nexport class IconHelper {\n  public static get reactIconKey(): string {\n    return \"#-react-iconspec-node-#\";\n  }\n  public static get conditionalIconItemKey(): string {\n    return \"#-conditional-icon-item-node-#\";\n  }\n  /** Returns an <Icon> ReactNode from the many ways an icon can be specified.\n   * @param icon abstract icon specification.\n   * @param internalData a map that may hold a React.ReactNode stored in an abstract item definition.\n   */\n  public static getIconReactNode(\n    icon:\n      | string\n      | ConditionalStringValue\n      | React.ReactNode\n      | ConditionalIconItem,\n    internalData?: Map<string, any>\n  ): React.ReactNode {\n    if (!icon) return null;\n\n    if (icon instanceof ConditionalIconItem)\n      return <Icon iconSpec={ConditionalIconItem.getValue(icon)} />;\n    if (React.isValidElement(icon)) return <Icon iconSpec={icon} />;\n\n    if (!(icon instanceof ConditionalStringValue) && typeof icon !== \"string\")\n      return null;\n\n    const iconString = ConditionalStringValue.getValue(icon);\n    if (!iconString) return null;\n\n    if (iconString === IconHelper.reactIconKey) {\n      if (internalData)\n        return (\n          <Icon\n            iconSpec={\n              internalData.get(IconHelper.reactIconKey) as React.ReactNode\n            }\n          />\n        );\n      return null;\n    } else if (iconString === IconHelper.conditionalIconItemKey) {\n      if (internalData) {\n        const iconItem = internalData.get(\n          IconHelper.conditionalIconItemKey\n        ) as ConditionalIconItem;\n        return <Icon iconSpec={ConditionalIconItem.getValue(iconItem)} />;\n      }\n      return null;\n    }\n    return <Icon iconSpec={iconString} />;\n  }\n\n  /** Returns an icon definition that can be stored in an abstract item definition. If the iconSpec specifies a ReactNode\n   * then the react data is stored in the internalData map and the key to the react data is returned.\n   * @param iconSpec any supported variations of how an icon can be defined in an abstract item or IconProps.\n   * @param internalData a map supplied by the caller to store away react element if React.ReactNode\n   */\n  public static getIconData(\n    iconSpec: IconSpec,\n    internalData?: Map<string, any>\n  ): string | ConditionalStringValue {\n    let icon;\n    if (iconSpec instanceof ConditionalIconItem) {\n      icon = IconHelper.conditionalIconItemKey;\n      if (internalData)\n        internalData.set(IconHelper.conditionalIconItemKey, iconSpec);\n      return icon;\n    } else {\n      icon = React.isValidElement(iconSpec)\n        ? IconHelper.reactIconKey\n        : iconSpec;\n    }\n\n    if (\n      internalData &&\n      typeof icon === \"string\" &&\n      icon === IconHelper.reactIconKey\n    ) {\n      internalData.set(IconHelper.reactIconKey, iconSpec);\n    }\n\n    if (typeof icon === \"string\" || icon instanceof ConditionalStringValue)\n      return icon;\n\n    return \"\";\n  }\n}\n"]}

package/lib/core-react/utils/IconWebComponent.d.ts

@@ -0,0 +1,13 @@
+/** @packageDocumentation
+ * @module Utilities
+ */
+/** IconWebComponent loads icon from an svg path
+ * @internal
+ */
+export declare class IconWebComponent extends HTMLElement {
+    connectedCallback(): Promise<void>;
+    private loadSvg;
+}
+/** @internal */
+export declare function registerIconWebComponent(): void;
+//# sourceMappingURL=IconWebComponent.d.ts.map

package/lib/core-react/utils/IconWebComponent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IconWebComponent.d.ts","sourceRoot":"","sources":["../../../src/core-react/utils/IconWebComponent.ts"],"names":[],"mappings":"AAIA;;GAEG;AA+FH;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,WAAW;IAClC,iBAAiB;YAKhB,OAAO;CAetB;AAED,gBAAgB;AAChB,wBAAgB,wBAAwB,SAGvC"}

package/lib/core-react/utils/IconWebComponent.js

@@ -0,0 +1,112 @@
+/*---------------------------------------------------------------------------------------------
+ * 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 { UiError } from "@itwin/appui-abstract";
+import { Logger } from "@itwin/core-bentley";
+import { UiCore } from "../UiCore.js";
+import DOMPurify, * as DOMPurifyNS from "dompurify";
+import { reuseOrCreatePromise } from "./reuseOrCreatePromise.js";
+/* eslint-disable deprecation/deprecation */
+/**
+ * "getSvg" list
+ * (if multiple icon require the same thing,
+ * only do the fetch once, and have all icon use the same result)
+ */
+const cache = new Map();
+/**
+ * Parse 'data:' uri to retrieve the Svg component within it.
+ * @param src data:image/svg+xml;base64 or data:image/svg+xml
+ * @param element Element for logging purpose.
+ * @returns HTMLElement (svg)
+ */
+function parseSvgFromDataUri(src, element) {
+    const dataUriParts = src.split(",");
+    if ((dataUriParts.length !== 2 &&
+        "data:image/svg+xml;base64" === dataUriParts[0]) ||
+        ("data:image/svg+xml;base64" !== dataUriParts[0] &&
+            "data:image/svg+xml" !== dataUriParts[0])) {
+        Logger.logError(UiCore.loggerCategory(element), "Unable to load icon.");
+        return;
+    }
+    let rawSvg = "";
+    if ("data:image/svg+xml;base64" === dataUriParts[0]) {
+        rawSvg = window.atob(dataUriParts[1]);
+    }
+    else {
+        // `,` is valid character in data when not in base64, rebuild the data correctly
+        rawSvg = decodeURIComponent(dataUriParts.slice(1).join(","));
+    }
+    // the esm build of dompurify has a default import but the cjs build does not
+    // if there is a default export, use it (likely esm), otherwise use the namespace
+    const sanitizer = DOMPurify ?? DOMPurifyNS;
+    const sanitizedSvg = sanitizer.sanitize(rawSvg);
+    const parsedSvg = new window.DOMParser().parseFromString(sanitizedSvg, "text/xml");
+    const errorNode = parsedSvg.querySelector("parsererror");
+    if (errorNode || "svg" !== parsedSvg.documentElement.nodeName.toLowerCase()) {
+        throw new UiError(UiCore.loggerCategory(element), "Unable to load icon.");
+    }
+    return parsedSvg.documentElement;
+}
+/**
+ * Fetch the src from the network and return the SVG element.
+ * @param src URL representing a .svg file
+ * @param element Element for logging purpose
+ * @returns HTMLElement (svg)
+ */
+async function fetchSvg(src, element) {
+    const response = await fetch(src).catch((_error) => {
+        Logger.logError(UiCore.loggerCategory(element), "Unable to load icon.");
+    });
+    if (!response || !response.ok) {
+        throw new UiError(UiCore.loggerCategory(element), "Unable to load icon.");
+    }
+    const str = await response.text();
+    if (str === undefined) {
+        throw new UiError(UiCore.loggerCategory(element), "Unable to load icon.");
+    }
+    const data = new window.DOMParser().parseFromString(str, "text/xml");
+    return data.documentElement;
+}
+/**
+ * Get the svg (fetch and parse for url, or decode and parse for data: url)
+ * @param src URL of the content to download/parse
+ * @param element Element for logging purpose.
+ * @returns HTMLElement (svg)
+ */
+async function getSvg(src, element) {
+    if (src.startsWith("data:")) {
+        return parseSvgFromDataUri(src, element);
+    }
+    return fetchSvg(src, element);
+}
+/** IconWebComponent loads icon from an svg path
+ * @internal
+ */
+export class IconWebComponent extends HTMLElement {
+    async connectedCallback() {
+        await this.loadSvg();
+        this.dispatchEvent(new CustomEvent("load"));
+    }
+    async loadSvg() {
+        // if svg was already appended don't request it again
+        if (this.childNodes.length)
+            return;
+        const src = this.getAttribute("src") || "";
+        if (!src)
+            return;
+        const svg = await reuseOrCreatePromise(src, async () => getSvg(src, this), cache);
+        if (svg && !this.childNodes.length) {
+            this.append(svg.cloneNode(true));
+        }
+    }
+}
+/** @internal */
+export function registerIconWebComponent() {
+    if (window.customElements.get("svg-loader") === undefined)
+        window.customElements.define("svg-loader", IconWebComponent);
+}
+//# sourceMappingURL=IconWebComponent.js.map

package/lib/core-react/utils/IconWebComponent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IconWebComponent.js","sourceRoot":"","sources":["../../../src/core-react/utils/IconWebComponent.ts"],"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 Utilities\n */\n\nimport { UiError } from \"@itwin/appui-abstract\";\nimport { Logger } from \"@itwin/core-bentley\";\nimport { UiCore } from \"../UiCore.js\";\nimport DOMPurify, * as DOMPurifyNS from \"dompurify\";\nimport { reuseOrCreatePromise } from \"./reuseOrCreatePromise.js\";\n\n/* eslint-disable deprecation/deprecation */\n\n/**\n * \"getSvg\" list\n * (if multiple icon require the same thing,\n * only do the fetch once, and have all icon use the same result)\n */\nconst cache = new Map<string, Promise<any>>();\n\n/**\n * Parse 'data:' uri to retrieve the Svg component within it.\n * @param src data:image/svg+xml;base64 or data:image/svg+xml\n * @param element Element for logging purpose.\n * @returns HTMLElement (svg)\n */\nfunction parseSvgFromDataUri(src: string, element: any) {\n  const dataUriParts = src.split(\",\");\n\n  if (\n    (dataUriParts.length !== 2 &&\n      \"data:image/svg+xml;base64\" === dataUriParts[0]) ||\n    (\"data:image/svg+xml;base64\" !== dataUriParts[0] &&\n      \"data:image/svg+xml\" !== dataUriParts[0])\n  ) {\n    Logger.logError(UiCore.loggerCategory(element), \"Unable to load icon.\");\n    return;\n  }\n\n  let rawSvg = \"\";\n  if (\"data:image/svg+xml;base64\" === dataUriParts[0]) {\n    rawSvg = window.atob(dataUriParts[1]);\n  } else {\n    // `,` is valid character in data when not in base64, rebuild the data correctly\n    rawSvg = decodeURIComponent(dataUriParts.slice(1).join(\",\"));\n  }\n\n  // the esm build of dompurify has a default import but the cjs build does not\n  // if there is a default export, use it (likely esm), otherwise use the namespace\n  const sanitizer = DOMPurify ?? DOMPurifyNS;\n  const sanitizedSvg = sanitizer.sanitize(rawSvg);\n\n  const parsedSvg = new window.DOMParser().parseFromString(\n    sanitizedSvg,\n    \"text/xml\"\n  );\n  const errorNode = parsedSvg.querySelector(\"parsererror\");\n  if (errorNode || \"svg\" !== parsedSvg.documentElement.nodeName.toLowerCase()) {\n    throw new UiError(UiCore.loggerCategory(element), \"Unable to load icon.\");\n  }\n\n  return parsedSvg.documentElement;\n}\n\n/**\n * Fetch the src from the network and return the SVG element.\n * @param src URL representing a .svg file\n * @param element Element for logging purpose\n * @returns HTMLElement (svg)\n */\nasync function fetchSvg(src: string, element: any) {\n  const response = await fetch(src).catch((_error) => {\n    Logger.logError(UiCore.loggerCategory(element), \"Unable to load icon.\");\n  });\n  if (!response || !response.ok) {\n    throw new UiError(UiCore.loggerCategory(element), \"Unable to load icon.\");\n  }\n  const str = await response.text();\n  if (str === undefined) {\n    throw new UiError(UiCore.loggerCategory(element), \"Unable to load icon.\");\n  }\n  const data = new window.DOMParser().parseFromString(str, \"text/xml\");\n  return data.documentElement;\n}\n\n/**\n * Get the svg (fetch and parse for url, or decode and parse for data: url)\n * @param src URL of the content to download/parse\n * @param element Element for logging purpose.\n * @returns HTMLElement (svg)\n */\nasync function getSvg(src: string, element: any) {\n  if (src.startsWith(\"data:\")) {\n    return parseSvgFromDataUri(src, element);\n  }\n  return fetchSvg(src, element);\n}\n\n/** IconWebComponent loads icon from an svg path\n * @internal\n */\nexport class IconWebComponent extends HTMLElement {\n  public async connectedCallback() {\n    await this.loadSvg();\n    this.dispatchEvent(new CustomEvent(\"load\"));\n  }\n\n  private async loadSvg() {\n    // if svg was already appended don't request it again\n    if (this.childNodes.length) return;\n    const src = this.getAttribute(\"src\") || \"\";\n    if (!src) return;\n\n    const svg = await reuseOrCreatePromise(\n      src,\n      async () => getSvg(src, this),\n      cache\n    );\n    if (svg && !this.childNodes.length) {\n      this.append(svg.cloneNode(true));\n    }\n  }\n}\n\n/** @internal */\nexport function registerIconWebComponent() {\n  if (window.customElements.get(\"svg-loader\") === undefined)\n    window.customElements.define(\"svg-loader\", IconWebComponent);\n}\n"]}

package/lib/core-react/utils/ListenerType.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ListenerType.d.ts","sourceRoot":"","sources":["../../../src/core-react/utils/ListenerType.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;;;GAIG;AACH,MAAM,MAAM,YAAY,CACtB,MAAM,SAAS;IACb,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,IAAI,CAAC;CAC7C,IACC,MAAM,SAAS;IACjB,WAAW,CAAC,QAAQ,EAAE,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC;CACpD,GACG,SAAS,GACT,KAAK,CAAC"}

package/lib/core-react/utils/ListenerType.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ListenerType.js","sourceRoot":"","sources":["../../../src/core-react/utils/ListenerType.ts"],"names":[],"mappings":"","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 Utilities\n */\nimport type { Listener } from \"@itwin/core-bentley\";\n\n/**\n * Retrieves the type of the callback function for an event type like `BeEvent`.\n * @note `ListenerType` is available in `@itwin/core-bentley@^4.8.0`\n * @internal\n */\nexport type ListenerType<\n  TEvent extends {\n    addListener(listener: Listener): () => void;\n  }\n> = TEvent extends {\n  addListener(listener: infer TListener): () => void;\n}\n  ? TListener\n  : never;\n"]}

package/lib/core-react/utils/Point.d.ts

@@ -0,0 +1,36 @@
+/** @packageDocumentation
+ * @module Utilities
+ */
+import type { PointProps } from "./PointProps.js";
+/** Describes and provides methods to work with 2d points.
+ * @internal
+ */
+export declare class Point implements PointProps {
+    readonly x: number;
+    readonly y: number;
+    /** Creates point from PointProps */
+    static create(pointProps: PointProps): Point;
+    /** Creates a new point. */
+    constructor(x?: number, y?: number);
+    /** Calculates Euclidean distance to other point. */
+    getDistanceTo(other: PointProps): number;
+    /** Gets offset to other point. */
+    getOffsetTo(other: PointProps): Point;
+    /** @returns New [[Point]] that is offset along the X and Y axes. */
+    offset(offset: PointProps): Point;
+    /** @returns New [[Point]] that is offset along the X axis. */
+    offsetX(offset: number): Point;
+    /** @returns New [[Point]] that is offset along the Y axis. */
+    offsetY(offset: number): Point;
+    /** @returns True if position of this and other points are equal. */
+    equals(other: PointProps): boolean;
+    /** @returns New [[Point]] with modified x value. */
+    setX(x: number): Point;
+    /** @returns New [[Point]] with modified y value. */
+    setY(y: number): Point;
+    /** @returns New [[Point]] with coordinates multiplied by specified factor. */
+    multiply(factor: number): Point;
+    /** @returns PointProps object for this point. */
+    toProps(): PointProps;
+}
+//# sourceMappingURL=Point.d.ts.map

package/lib/core-react/utils/Point.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Point.d.ts","sourceRoot":"","sources":["../../../src/core-react/utils/Point.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD;;GAEG;AACH,qBAAa,KAAM,YAAW,UAAU;aAOH,CAAC;aAAsB,CAAC;IAN3D,oCAAoC;WACtB,MAAM,CAAC,UAAU,EAAE,UAAU;IAI3C,2BAA2B;gBACQ,CAAC,SAAI,EAAkB,CAAC,SAAI;IAE/D,oDAAoD;IAC7C,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM;IAK/C,kCAAkC;IAC3B,WAAW,CAAC,KAAK,EAAE,UAAU;IAIpC,oEAAoE;IAC7D,MAAM,CAAC,MAAM,EAAE,UAAU;IAIhC,8DAA8D;IACvD,OAAO,CAAC,MAAM,EAAE,MAAM;IAI7B,8DAA8D;IACvD,OAAO,CAAC,MAAM,EAAE,MAAM;IAI7B,oEAAoE;IAC7D,MAAM,CAAC,KAAK,EAAE,UAAU;IAI/B,oDAAoD;IAC7C,IAAI,CAAC,CAAC,EAAE,MAAM;IAIrB,oDAAoD;IAC7C,IAAI,CAAC,CAAC,EAAE,MAAM;IAIrB,8EAA8E;IACvE,QAAQ,CAAC,MAAM,EAAE,MAAM;IAI9B,iDAAiD;IAC1C,OAAO,IAAI,UAAU;CAM7B"}

package/lib/core-react/utils/Point.js

@@ -0,0 +1,66 @@
+/*---------------------------------------------------------------------------------------------
+ * 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
+ */
+/** Describes and provides methods to work with 2d points.
+ * @internal
+ */
+export class Point {
+    /** Creates point from PointProps */
+    static create(pointProps) {
+        return new Point(pointProps.x, pointProps.y);
+    }
+    /** Creates a new point. */
+    constructor(x = 0, y = 0) {
+        this.x = x;
+        this.y = y;
+    }
+    /** Calculates Euclidean distance to other point. */
+    getDistanceTo(other) {
+        const offset = this.getOffsetTo(other);
+        return Math.sqrt(Math.pow(offset.x, 2) + Math.pow(offset.y, 2));
+    }
+    /** Gets offset to other point. */
+    getOffsetTo(other) {
+        return new Point(other.x - this.x, other.y - this.y);
+    }
+    /** @returns New [[Point]] that is offset along the X and Y axes. */
+    offset(offset) {
+        return new Point(this.x + offset.x, this.y + offset.y);
+    }
+    /** @returns New [[Point]] that is offset along the X axis. */
+    offsetX(offset) {
+        return new Point(this.x + offset, this.y);
+    }
+    /** @returns New [[Point]] that is offset along the Y axis. */
+    offsetY(offset) {
+        return new Point(this.x, this.y + offset);
+    }
+    /** @returns True if position of this and other points are equal. */
+    equals(other) {
+        return other.x === this.x && other.y === this.y;
+    }
+    /** @returns New [[Point]] with modified x value. */
+    setX(x) {
+        return new Point(x, this.y);
+    }
+    /** @returns New [[Point]] with modified y value. */
+    setY(y) {
+        return new Point(this.x, y);
+    }
+    /** @returns New [[Point]] with coordinates multiplied by specified factor. */
+    multiply(factor) {
+        return new Point(this.x * factor, this.y * factor);
+    }
+    /** @returns PointProps object for this point. */
+    toProps() {
+        return {
+            x: this.x,
+            y: this.y,
+        };
+    }
+}
+//# sourceMappingURL=Point.js.map

package/lib/core-react/utils/Point.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Point.js","sourceRoot":"","sources":["../../../src/core-react/utils/Point.ts"],"names":[],"mappings":"AAAA;;;gGAGgG;AAChG;;GAEG;AAIH;;GAEG;AACH,MAAM,OAAO,KAAK;IAChB,oCAAoC;IAC7B,MAAM,CAAC,MAAM,CAAC,UAAsB;QACzC,OAAO,IAAI,KAAK,CAAC,UAAU,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC;IAED,2BAA2B;IAC3B,YAAmC,IAAI,CAAC,EAAkB,IAAI,CAAC;QAA5B,MAAC,GAAD,CAAC,CAAI;QAAkB,MAAC,GAAD,CAAC,CAAI;IAAG,CAAC;IAEnE,oDAAoD;IAC7C,aAAa,CAAC,KAAiB;QACpC,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACvC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAClE,CAAC;IAED,kCAAkC;IAC3B,WAAW,CAAC,KAAiB;QAClC,OAAO,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACvD,CAAC;IAED,oEAAoE;IAC7D,MAAM,CAAC,MAAkB;QAC9B,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACzD,CAAC;IAED,8DAA8D;IACvD,OAAO,CAAC,MAAc;QAC3B,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAC5C,CAAC;IAED,8DAA8D;IACvD,OAAO,CAAC,MAAc;QAC3B,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC;IAC5C,CAAC;IAED,oEAAoE;IAC7D,MAAM,CAAC,KAAiB;QAC7B,OAAO,KAAK,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;IAClD,CAAC;IAED,oDAAoD;IAC7C,IAAI,CAAC,CAAS;QACnB,OAAO,IAAI,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAC9B,CAAC;IAED,oDAAoD;IAC7C,IAAI,CAAC,CAAS;QACnB,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9B,CAAC;IAED,8EAA8E;IACvE,QAAQ,CAAC,MAAc;QAC5B,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,MAAM,EAAE,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC;IACrD,CAAC;IAED,iDAAiD;IAC1C,OAAO;QACZ,OAAO;YACL,CAAC,EAAE,IAAI,CAAC,CAAC;YACT,CAAC,EAAE,IAAI,CAAC,CAAC;SACV,CAAC;IACJ,CAAC;CACF","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Utilities\n */\n\nimport type { PointProps } from \"./PointProps.js\";\n\n/** Describes and provides methods to work with 2d points.\n * @internal\n */\nexport class Point implements PointProps {\n  /** Creates point from PointProps */\n  public static create(pointProps: PointProps) {\n    return new Point(pointProps.x, pointProps.y);\n  }\n\n  /** Creates a new point. */\n  public constructor(public readonly x = 0, public readonly y = 0) {}\n\n  /** Calculates Euclidean distance to other point. */\n  public getDistanceTo(other: PointProps): number {\n    const offset = this.getOffsetTo(other);\n    return Math.sqrt(Math.pow(offset.x, 2) + Math.pow(offset.y, 2));\n  }\n\n  /** Gets offset to other point. */\n  public getOffsetTo(other: PointProps) {\n    return new Point(other.x - this.x, other.y - this.y);\n  }\n\n  /** @returns New [[Point]] that is offset along the X and Y axes. */\n  public offset(offset: PointProps) {\n    return new Point(this.x + offset.x, this.y + offset.y);\n  }\n\n  /** @returns New [[Point]] that is offset along the X axis. */\n  public offsetX(offset: number) {\n    return new Point(this.x + offset, this.y);\n  }\n\n  /** @returns New [[Point]] that is offset along the Y axis. */\n  public offsetY(offset: number) {\n    return new Point(this.x, this.y + offset);\n  }\n\n  /** @returns True if position of this and other points are equal. */\n  public equals(other: PointProps) {\n    return other.x === this.x && other.y === this.y;\n  }\n\n  /** @returns New [[Point]] with modified x value. */\n  public setX(x: number) {\n    return new Point(x, this.y);\n  }\n\n  /** @returns New [[Point]] with modified y value. */\n  public setY(y: number) {\n    return new Point(this.x, y);\n  }\n\n  /** @returns New [[Point]] with coordinates multiplied by specified factor. */\n  public multiply(factor: number) {\n    return new Point(this.x * factor, this.y * factor);\n  }\n\n  /** @returns PointProps object for this point. */\n  public toProps(): PointProps {\n    return {\n      x: this.x,\n      y: this.y,\n    };\n  }\n}\n"]}

package/lib/core-react/utils/PointProps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PointProps.d.ts","sourceRoot":"","sources":["../../../src/core-react/utils/PointProps.tsx"],"names":[],"mappings":"AAIA;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/lib/core-react/utils/PointProps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PointProps.js","sourceRoot":"","sources":["../../../src/core-react/utils/PointProps.tsx"],"names":[],"mappings":"","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n/**\n * PointProps is identical to XAndY in @core/geometry, but\n * @internal\n */\nexport interface PointProps {\n  readonly x: number;\n  readonly y: number;\n}\n"]}

package/lib/core-react/utils/Props.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Props.d.ts","sourceRoot":"","sources":["../../../src/core-react/utils/Props.tsx"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAEpC;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AAEH,MAAM,WAAW,WAAY,SAAQ,cAAc;IACjD,kCAAkC;IAClC,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,gHAAgH;IAChH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,cACf,SAAQ,KAAK,CAAC,iBAAiB,CAAC,cAAc,CAAC,EAC7C,WAAW;CAAG;AAElB;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS;IAAE,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,IAAI,IAAI,CAC3E,CAAC,EACD,UAAU,CACX,CAAC"}

package/lib/core-react/utils/Props.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Props.js","sourceRoot":"","sources":["../../../src/core-react/utils/Props.tsx"],"names":[],"mappings":"AAAA;;;gGAGgG;AAChG;;GAEG","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 Utilities\n */\n\nimport type * as React from \"react\";\n\n/** Props used by components that expect class name to be passed in.\n * @public\n * @deprecated in 4.15.0. Used internally.\n */\nexport interface ClassNameProps {\n  /** Custom CSS class name */\n  className?: string;\n}\n\n/** Common props used by components.\n * @public\n * @deprecated in 4.15.0. Used internally.\n */\n// eslint-disable-next-line deprecation/deprecation\nexport interface CommonProps extends ClassNameProps {\n  /** Custom CSS style properties */\n  style?: React.CSSProperties;\n  /** Optional unique identifier for item. If defined it will be added to DOM Element attribute as data-item-id */\n  itemId?: string;\n}\n\n/** Common properties using a div element.\n * @public\n * @deprecated in 4.15.0. Used internally.\n */\nexport interface CommonDivProps\n  extends React.AllHTMLAttributes<HTMLDivElement>,\n    CommonProps {} // eslint-disable-line deprecation/deprecation\n\n/** Props used by components that do not expect children to be passed in.\n * @public\n * @deprecated in 4.15.0. Used internally.\n */\nexport interface NoChildrenProps {\n  children?: undefined;\n}\n\n/** Omit children property from T.\n * @public\n * @deprecated in 4.15.0. Used internally.\n */\nexport type OmitChildrenProp<T extends { children?: React.ReactNode }> = Omit<\n  T,\n  \"children\"\n>;\n"]}