@itwin/core-react 3.0.0-dev.77 → 3.0.0-dev.81

package/lib/esm/core-react/uisettings/UiSetting.d.ts

@@ -0,0 +1,31 @@
+/** @packageDocumentation
+ * @module UiSettings
+ */
+import { UiSettingsResult, UiSettingsStorage } from "./UiSettingsStorage";
+/** A Ui Setting with namespace and setting name.
+ * @public
+ */
+export declare class UiSetting<T> {
+    settingNamespace: string;
+    settingName: string;
+    getValue: () => T;
+    applyValue?: ((v: T) => void) | undefined;
+    defaultValue?: T | undefined;
+    /** Constructor
+     * @param settingNamespace  Namespace for the setting, passed to UiSettings.
+     * @param settingName       Name for the setting, passed to UiSettings.
+     * @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: string, settingName: string, getValue: () => T, applyValue?: ((v: T) => void) | undefined, defaultValue?: T | undefined);
+    /** Gets the setting from [[UiSettingsStorage]] */
+    getSetting(storage: UiSettingsStorage): Promise<UiSettingsResult>;
+    /** Saves the setting value from the `getValue` function to UiSettings */
+    saveSetting(storage: UiSettingsStorage): Promise<UiSettingsResult>;
+    /** Deletes the setting from UiSettings */
+    deleteSetting(storage: UiSettingsStorage): Promise<UiSettingsResult>;
+    /** Gets the setting from UiSettings and applies the value using the `applyValue` function */
+    getSettingAndApplyValue(storage: UiSettingsStorage): Promise<UiSettingsResult>;
+}
+//# sourceMappingURL=UiSetting.d.ts.map

package/lib/esm/core-react/uisettings/UiSetting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UiSetting.d.ts","sourceRoot":"","sources":["../../../../src/core-react/uisettings/UiSetting.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAoB,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE5F;;GAEG;AACH,qBAAa,SAAS,CAAC,CAAC;IAQI,gBAAgB,EAAE,MAAM;IAAS,WAAW,EAAE,MAAM;IAAS,QAAQ,EAAE,MAAM,CAAC;IAAS,UAAU,CAAC,OAAM,CAAC,KAAK,IAAI;IAAS,YAAY,CAAC;IAPlK;;;;;;OAMG;gBACuB,gBAAgB,EAAE,MAAM,EAAS,WAAW,EAAE,MAAM,EAAS,QAAQ,EAAE,MAAM,CAAC,EAAS,UAAU,CAAC,OAAM,CAAC,KAAK,IAAI,aAAA,EAAS,YAAY,CAAC,eAAG;IAGrK,kDAAkD;IACrC,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAI9E,yEAAyE;IAC5D,WAAW,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAI/E,0CAA0C;IAC7B,aAAa,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAIjF,6FAA6F;IAChF,uBAAuB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAc5F"}

package/lib/esm/core-react/uisettings/UiSetting.js

@@ -0,0 +1,56 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module UiSettings
+ */
+import { UiSettingsStatus } from "./UiSettingsStorage";
+/** A Ui Setting with namespace and setting name.
+ * @public
+ */
+export class UiSetting {
+    /** Constructor
+     * @param settingNamespace  Namespace for the setting, passed to UiSettings.
+     * @param settingName       Name for the setting, passed to UiSettings.
+     * @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 [[UiSettingsStorage]] */
+    async getSetting(storage) {
+        return storage.getSetting(this.settingNamespace, this.settingName);
+    }
+    /** Saves the setting value from the `getValue` function to UiSettings */
+    async saveSetting(storage) {
+        return storage.saveSetting(this.settingNamespace, this.settingName, this.getValue());
+    }
+    /** Deletes the setting from UiSettings */
+    async deleteSetting(storage) {
+        return storage.deleteSetting(this.settingNamespace, this.settingName);
+    }
+    /** Gets the setting from UiSettings and applies the value using the `applyValue` function */
+    async getSettingAndApplyValue(storage) {
+        if (this.applyValue) {
+            const result = await this.getSetting(storage);
+            if (result.status === UiSettingsStatus.Success) {
+                this.applyValue(result.setting);
+            }
+            else if (undefined !== this.defaultValue) {
+                this.applyValue(this.defaultValue);
+                result.setting = this.defaultValue;
+                result.status = UiSettingsStatus.Success;
+            }
+            return result;
+        }
+        return { status: UiSettingsStatus.Uninitialized };
+    }
+}
+//# sourceMappingURL=UiSetting.js.map

package/lib/esm/core-react/uisettings/UiSetting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UiSetting.js","sourceRoot":"","sources":["../../../../src/core-react/uisettings/UiSetting.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAEH,OAAO,EAAoB,gBAAgB,EAAqB,MAAM,qBAAqB,CAAC;AAE5F;;GAEG;AACH,MAAM,OAAO,SAAS;IACpB;;;;;;OAMG;IACH,YAA0B,gBAAwB,EAAS,WAAmB,EAAS,QAAiB,EAAS,UAA2B,EAAS,YAAgB;QAA3I,qBAAgB,GAAhB,gBAAgB,CAAQ;QAAS,gBAAW,GAAX,WAAW,CAAQ;QAAS,aAAQ,GAAR,QAAQ,CAAS;QAAS,eAAU,GAAV,UAAU,CAAiB;QAAS,iBAAY,GAAZ,YAAY,CAAI;IACrK,CAAC;IAED,kDAAkD;IAC3C,KAAK,CAAC,UAAU,CAAC,OAA0B;QAChD,OAAO,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,gBAAgB,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IACrE,CAAC;IAED,yEAAyE;IAClE,KAAK,CAAC,WAAW,CAAC,OAA0B;QACjD,OAAO,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,gBAAgB,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IACvF,CAAC;IAED,0CAA0C;IACnC,KAAK,CAAC,aAAa,CAAC,OAA0B;QACnD,OAAO,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,gBAAgB,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IACxE,CAAC;IAED,6FAA6F;IACtF,KAAK,CAAC,uBAAuB,CAAC,OAA0B;QAC7D,IAAI,IAAI,CAAC,UAAU,EAAE;YACnB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;YAC9C,IAAI,MAAM,CAAC,MAAM,KAAK,gBAAgB,CAAC,OAAO,EAAE;gBAC9C,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;aACjC;iBAAM,IAAI,SAAS,KAAK,IAAI,CAAC,YAAY,EAAE;gBAC1C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;gBACnC,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC;gBACnC,MAAM,CAAC,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC;aAC1C;YACD,OAAO,MAAM,CAAC;SACf;QACD,OAAO,EAAE,MAAM,EAAE,gBAAgB,CAAC,aAAa,EAAE,CAAC;IACpD,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 UiSettings\n */\n\nimport { UiSettingsResult, UiSettingsStatus, UiSettingsStorage } from \"./UiSettingsStorage\";\n\n/** A Ui Setting with namespace and setting name.\n * @public\n */\nexport class UiSetting<T> {\n  /** Constructor\n   * @param settingNamespace  Namespace for the setting, passed to UiSettings.\n   * @param settingName       Name for the setting, passed to UiSettings.\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(public settingNamespace: string, public settingName: string, public getValue: () => T, public applyValue?: (v: T) => void, public defaultValue?: T) {\n  }\n\n  /** Gets the setting from [[UiSettingsStorage]] */\n  public async getSetting(storage: UiSettingsStorage): Promise<UiSettingsResult> {\n    return storage.getSetting(this.settingNamespace, this.settingName);\n  }\n\n  /** Saves the setting value from the `getValue` function to UiSettings */\n  public async saveSetting(storage: UiSettingsStorage): Promise<UiSettingsResult> {\n    return storage.saveSetting(this.settingNamespace, this.settingName, this.getValue());\n  }\n\n  /** Deletes the setting from UiSettings */\n  public async deleteSetting(storage: UiSettingsStorage): Promise<UiSettingsResult> {\n    return storage.deleteSetting(this.settingNamespace, this.settingName);\n  }\n\n  /** Gets the setting from UiSettings and applies the value using the `applyValue` function */\n  public async getSettingAndApplyValue(storage: UiSettingsStorage): Promise<UiSettingsResult> {\n    if (this.applyValue) {\n      const result = await this.getSetting(storage);\n      if (result.status === UiSettingsStatus.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 = UiSettingsStatus.Success;\n      }\n      return result;\n    }\n    return { status: UiSettingsStatus.Uninitialized };\n  }\n}\n"]}

package/lib/esm/core-react/uisettings/UiSettingsStorage.d.ts

@@ -0,0 +1,33 @@
+/** @packageDocumentation
+ * @module UiSettings
+ */
+/** Interface for getting, saving and deleting settings.
+ * @public
+ */
+export interface UiSettingsStorage {
+    getSetting(settingNamespace: string, settingName: string): Promise<UiSettingsResult>;
+    saveSetting(settingNamespace: string, settingName: string, setting: any): Promise<UiSettingsResult>;
+    deleteSetting(settingNamespace: string, settingName: string): Promise<UiSettingsResult>;
+}
+/** Alias for [[UiSettingsStorage]]
+ * @public
+ */
+export declare type UiSettings = UiSettingsStorage;
+/** Enum for [[UiSettingsStorage]] status.
+ * @public
+ */
+export declare enum UiSettingsStatus {
+    Success = 0,
+    NotFound = 1,
+    UnknownError = 2,
+    Uninitialized = 3,
+    AuthorizationError = 4
+}
+/** Interface for result of accessing setting in [[UiSettingsStorage]].
+ * @public
+ */
+export interface UiSettingsResult {
+    status: UiSettingsStatus;
+    setting?: any;
+}
+//# sourceMappingURL=UiSettingsStorage.d.ts.map

package/lib/esm/core-react/uisettings/UiSettingsStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UiSettingsStorage.d.ts","sourceRoot":"","sources":["../../../../src/core-react/uisettings/UiSettingsStorage.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,UAAU,CAAC,gBAAgB,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACrF,WAAW,CAAC,gBAAgB,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACpG,aAAa,CAAC,gBAAgB,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACzF;AAED;;GAEG;AACH,oBAAY,UAAU,GAAG,iBAAiB,CAAC;AAE3C;;GAEG;AACH,oBAAY,gBAAgB;IAC1B,OAAO,IAAI;IACX,QAAQ,IAAI;IACZ,YAAY,IAAI;IAChB,aAAa,IAAI;IACjB,kBAAkB,IAAI;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,gBAAgB,CAAC;IACzB,OAAO,CAAC,EAAE,GAAG,CAAC;CACf"}

package/lib/esm/core-react/uisettings/UiSettingsStorage.js

@@ -0,0 +1,19 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module UiSettings
+ */
+/** Enum for [[UiSettingsStorage]] status.
+ * @public
+ */
+export var UiSettingsStatus;
+(function (UiSettingsStatus) {
+    UiSettingsStatus[UiSettingsStatus["Success"] = 0] = "Success";
+    UiSettingsStatus[UiSettingsStatus["NotFound"] = 1] = "NotFound";
+    UiSettingsStatus[UiSettingsStatus["UnknownError"] = 2] = "UnknownError";
+    UiSettingsStatus[UiSettingsStatus["Uninitialized"] = 3] = "Uninitialized";
+    UiSettingsStatus[UiSettingsStatus["AuthorizationError"] = 4] = "AuthorizationError";
+})(UiSettingsStatus || (UiSettingsStatus = {}));
+//# sourceMappingURL=UiSettingsStorage.js.map

package/lib/esm/core-react/uisettings/UiSettingsStorage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UiSettingsStorage.js","sourceRoot":"","sources":["../../../../src/core-react/uisettings/UiSettingsStorage.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAgBH;;GAEG;AACH,MAAM,CAAN,IAAY,gBAMX;AAND,WAAY,gBAAgB;IAC1B,6DAAW,CAAA;IACX,+DAAY,CAAA;IACZ,uEAAgB,CAAA;IAChB,yEAAiB,CAAA;IACjB,mFAAsB,CAAA;AACxB,CAAC,EANW,gBAAgB,KAAhB,gBAAgB,QAM3B","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 UiSettings\n */\n\n/** Interface for getting, saving and deleting settings.\n * @public\n */\nexport interface UiSettingsStorage {\n  getSetting(settingNamespace: string, settingName: string): Promise<UiSettingsResult>;\n  saveSetting(settingNamespace: string, settingName: string, setting: any): Promise<UiSettingsResult>;\n  deleteSetting(settingNamespace: string, settingName: string): Promise<UiSettingsResult>;\n}\n\n/** Alias for [[UiSettingsStorage]]\n * @public\n */\nexport type UiSettings = UiSettingsStorage;\n\n/** Enum for [[UiSettingsStorage]] status.\n * @public\n */\nexport enum UiSettingsStatus {\n  Success = 0,\n  NotFound = 1,\n  UnknownError = 2,\n  Uninitialized = 3,\n  AuthorizationError = 4,\n}\n\n/** Interface for result of accessing setting in [[UiSettingsStorage]].\n * @public\n */\nexport interface UiSettingsResult {\n  status: UiSettingsStatus;\n  setting?: any;\n}\n"]}

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

@@ -0,0 +1,23 @@
+/** @packageDocumentation
+ * @module Utilities
+ */
+import * as React from "react";
+import { ConditionalStringValue } from "@itwin/appui-abstract";
+/** Icon Helper Class used to store the data needed to generate an <Icon> for use in any control that shows an icon.
+ * @public
+ */
+export declare class IconHelper {
+    static get reactIconKey(): 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, 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: string | ConditionalStringValue | React.ReactNode, internalData?: Map<string, any>): string | ConditionalStringValue;
+}
+//# sourceMappingURL=IconHelper.d.ts.map

package/lib/esm/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;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAG/D;;GAEG;AACH,qBAAa,UAAU;IACrB,WAAkB,YAAY,IAAI,MAAM,CAEvC;IAED;;;OAGG;WACW,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,sBAAsB,GAAG,KAAK,CAAC,SAAS,EAAE,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC,SAAS;IA4BzI;;;;OAIG;WACW,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,sBAAsB,GAAG,KAAK,CAAC,SAAS,EAAE,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,GAAG,sBAAsB;CAYzJ"}

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

@@ -0,0 +1,59 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Utilities
+ */
+import * as React from "react";
+import { ConditionalStringValue } from "@itwin/appui-abstract";
+import { Icon } from "../icons/IconComponent";
+/** Icon Helper Class used to store the data needed to generate an <Icon> for use in any control that shows an icon.
+ * @public
+ */
+export class IconHelper {
+    static get reactIconKey() {
+        return "#-react-iconspec-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) {
+        // istanbul ignore else
+        if (!icon)
+            return null;
+        // istanbul ignore else
+        if (React.isValidElement(icon))
+            return React.createElement(Icon, { iconSpec: icon });
+        // istanbul ignore if
+        if (!(icon instanceof ConditionalStringValue) && typeof icon !== "string")
+            return null;
+        const iconString = ConditionalStringValue.getValue(icon);
+        if (!iconString)
+            return null;
+        // istanbul ignore else
+        if (iconString === IconHelper.reactIconKey) {
+            // istanbul ignore else
+            if (internalData)
+                return React.createElement(Icon, { iconSpec: internalData.get(IconHelper.reactIconKey) });
+            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) {
+        const 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/esm/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;;;+FAG+F;AAC/F;;GAEG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAE9C;;GAEG;AACH,MAAM,OAAO,UAAU;IACd,MAAM,KAAK,YAAY;QAC5B,OAAO,yBAAyB,CAAC;IACnC,CAAC;IAED;;;OAGG;IACI,MAAM,CAAC,gBAAgB,CAAC,IAAuD,EAAE,YAA+B;QACrH,uBAAuB;QACvB,IAAI,CAAC,IAAI;YACP,OAAO,IAAI,CAAC;QAEd,uBAAuB;QACvB,IAAI,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC;YAC5B,OAAO,oBAAC,IAAI,IAAC,QAAQ,EAAE,IAAI,GAAI,CAAC;QAElC,qBAAqB;QACrB,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;YACb,OAAO,IAAI,CAAC;QAEd,uBAAuB;QACvB,IAAI,UAAU,KAAK,UAAU,CAAC,YAAY,EAAE;YAC1C,uBAAuB;YACvB,IAAI,YAAY;gBACd,OAAO,oBAAC,IAAI,IAAC,QAAQ,EAAE,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,YAAY,CAAoB,GAAI,CAAC;YAC1F,OAAO,IAAI,CAAC;SACb;QAED,OAAO,oBAAC,IAAI,IAAC,QAAQ,EAAE,UAAU,GAAI,CAAC;IACxC,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,WAAW,CAAC,QAA2D,EAAE,YAA+B;QACpH,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC;QAEnF,IAAI,YAAY,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,UAAU,CAAC,YAAY,EAAE;YAChF,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;SACrD;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\nimport * as React from \"react\";\nimport { ConditionalStringValue } from \"@itwin/appui-abstract\";\nimport { Icon } from \"../icons/IconComponent\";\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 */\nexport class IconHelper {\n  public static get reactIconKey(): string {\n    return \"#-react-iconspec-node-#\";\n  }\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(icon: string | ConditionalStringValue | React.ReactNode, internalData?: Map<string, any>): React.ReactNode {\n    // istanbul ignore else\n    if (!icon)\n      return null;\n\n    // istanbul ignore else\n    if (React.isValidElement(icon))\n      return <Icon iconSpec={icon} />;\n\n    // istanbul ignore if\n    if (!(icon instanceof ConditionalStringValue) && typeof icon !== \"string\")\n      return null;\n\n    const iconString = ConditionalStringValue.getValue(icon);\n    if (!iconString)\n      return null;\n\n    // istanbul ignore else\n    if (iconString === IconHelper.reactIconKey) {\n      // istanbul ignore else\n      if (internalData)\n        return <Icon iconSpec={internalData.get(IconHelper.reactIconKey) as React.ReactNode} />;\n      return null;\n    }\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(iconSpec: string | ConditionalStringValue | React.ReactNode, internalData?: Map<string, any>): string | ConditionalStringValue {\n    const icon = (React.isValidElement(iconSpec)) ? IconHelper.reactIconKey : iconSpec;\n\n    if (internalData && typeof icon === \"string\" && icon === IconHelper.reactIconKey) {\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/esm/core-react/utils/Point.d.ts

@@ -0,0 +1,38 @@
+/** @packageDocumentation
+ * @module Utilities
+ */
+import { PointProps } from "@itwin/appui-abstract";
+/** 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;
+    /** Calculates grid-like distance to other point. */
+    getManhattanDistanceTo(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/esm/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,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEnD;;GAEG;AACH,qBAAa,KAAM,YAAW,UAAU;aAOH,CAAC;aAAsB,CAAC;IAN3D,yCAAyC;WAC3B,MAAM,CAAC,UAAU,EAAE,UAAU;IAI3C,2BAA2B;gBACQ,CAAC,SAAI,EAAkB,CAAC,SAAI;IAG/D,oDAAoD;IAC7C,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM;IAK/C,oDAAoD;IAC7C,sBAAsB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM;IAIxD,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,qDAAqD;IAC9C,OAAO,IAAI,UAAU;CAM7B"}

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

@@ -0,0 +1,70 @@
+/*---------------------------------------------------------------------------------------------
+* 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 a new point. */
+    constructor(x = 0, y = 0) {
+        this.x = x;
+        this.y = y;
+    }
+    /** Creates point from [[PointProps]]. */
+    static create(pointProps) {
+        return new Point(pointProps.x, pointProps.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));
+    }
+    /** Calculates grid-like distance to other point. */
+    getManhattanDistanceTo(other) {
+        return Math.abs(this.x - other.x) + Math.abs(this.y - other.y);
+    }
+    /** 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/esm/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;;;+FAG+F;AAC/F;;GAEG;AAIH;;GAEG;AACH,MAAM,OAAO,KAAK;IAMhB,2BAA2B;IAC3B,YAAmC,IAAI,CAAC,EAAkB,IAAI,CAAC;QAA5B,MAAC,GAAD,CAAC,CAAI;QAAkB,MAAC,GAAD,CAAC,CAAI;IAC/D,CAAC;IAPD,yCAAyC;IAClC,MAAM,CAAC,MAAM,CAAC,UAAsB;QACzC,OAAO,IAAI,KAAK,CAAC,UAAU,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC;IAMD,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,oDAAoD;IAC7C,sBAAsB,CAAC,KAAiB;QAC7C,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACjE,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,qDAAqD;IAC9C,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 { PointProps } from \"@itwin/appui-abstract\";\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\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  /** Calculates grid-like distance to other point. */\n  public getManhattanDistanceTo(other: PointProps): number {\n    return Math.abs(this.x - other.x) + Math.abs(this.y - other.y);\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/esm/core-react/utils/PointProps.d.ts

@@ -0,0 +1,12 @@
+/** @packageDocumentation
+ * @module Utilities
+ */
+/** Describes 2d points.
+ * @public
+ * @deprecated Use [PointProps]($appui-abstract) instead
+ */
+export interface PointProps {
+    readonly x: number;
+    readonly y: number;
+}
+//# sourceMappingURL=PointProps.d.ts.map

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

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

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

@@ -0,0 +1,9 @@
+/*---------------------------------------------------------------------------------------------
+* 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
+ */
+export {};
+//# sourceMappingURL=PointProps.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PointProps.js","sourceRoot":"","sources":["../../../../src/core-react/utils/PointProps.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;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\n/** Describes 2d points.\n * @public\n * @deprecated Use [PointProps]($appui-abstract) instead\n */\nexport interface PointProps {\n  readonly x: number;\n  readonly y: number;\n}\n"]}

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

@@ -0,0 +1,39 @@
+/** @packageDocumentation
+ * @module Utilities
+ */
+import * as React from "react";
+import { Omit } from "./typeUtils";
+/** Props used by components that expect class name to be passed in.
+ * @public
+ */
+export interface ClassNameProps {
+    /** Custom CSS class name */
+    className?: string;
+}
+/** Common props used by components.
+ * @public
+ */
+export interface CommonProps extends ClassNameProps {
+    /** Custom CSS style properties */
+    style?: React.CSSProperties;
+    /** Optional unique identifier for item. If defined it will be added to DOM Element attribute as data-item-id */
+    itemId?: string;
+}
+/** Common properties using a div element.
+ * @public
+ */
+export interface CommonDivProps extends React.AllHTMLAttributes<HTMLDivElement>, CommonProps {
+}
+/** Props used by components that do not expect children to be passed in.
+ * @public
+ */
+export interface NoChildrenProps {
+    children?: undefined;
+}
+/** Omit children property from T.
+ * @public
+ */
+export declare type OmitChildrenProp<T extends {
+    children?: React.ReactNode;
+}> = Omit<T, "children">;
+//# sourceMappingURL=Props.d.ts.map

package/lib/esm/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,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAEnC;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,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;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,KAAK,CAAC,iBAAiB,CAAC,cAAc,CAAC,EAAE,WAAW;CAAI;AAEhG;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED;;GAEG;AACH,oBAAY,gBAAgB,CAAC,CAAC,SAAS;IAAE,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,IAAI,IAAI,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC"}

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

@@ -0,0 +1,9 @@
+/*---------------------------------------------------------------------------------------------
+* 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
+ */
+export {};
+//# sourceMappingURL=Props.js.map

package/lib/esm/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;;;+FAG+F;AAC/F;;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 * as React from \"react\";\nimport { Omit } from \"./typeUtils\";\n\n/** Props used by components that expect class name to be passed in.\n * @public\n */\nexport interface ClassNameProps {\n  /** Custom CSS class name */\n  className?: string;\n}\n\n/** Common props used by components.\n * @public\n */\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 */\nexport interface CommonDivProps extends React.AllHTMLAttributes<HTMLDivElement>, CommonProps { }\n\n/** Props used by components that do not expect children to be passed in.\n * @public\n */\nexport interface NoChildrenProps {\n  children?: undefined;\n}\n\n/** Omit children property from T.\n * @public\n */\nexport type OmitChildrenProp<T extends { children?: React.ReactNode }> = Omit<T, \"children\">;\n"]}

package/lib/esm/core-react/utils/Rectangle.d.ts

@@ -0,0 +1,145 @@
+/** @packageDocumentation
+ * @module Utilities
+ */
+import { PointProps } from "@itwin/appui-abstract";
+import { Point } from "./Point";
+import { Size, SizeProps } from "./Size";
+/** Describes 2d bounds.
+ * @public
+ */
+export interface RectangleProps {
+    readonly left: number;
+    readonly top: number;
+    readonly right: number;
+    readonly bottom: number;
+}
+/** Available corners of [[Rectangle]].
+ * @internal
+ */
+export declare enum Corner {
+    TopLeft = 0,
+    TopRight = 1,
+    BottomRight = 2,
+    BottomLeft = 3
+}
+/** Describes and provides methods to work with 2d bounds.
+ * @internal
+ */
+export declare class Rectangle implements RectangleProps {
+    readonly left: number;
+    readonly top: number;
+    readonly right: number;
+    readonly bottom: number;
+    /** Creates rectangle from [[RectangleProps]]. */
+    static create(props: RectangleProps): Rectangle;
+    /** Creates rectangle from [[SizeProps]]. */
+    static createFromSize(size: SizeProps): Rectangle;
+    /** Create a rectangle with 2 pairs of xy candidates. Theses are compared and shuffled as needed for the rectangle. */
+    static createXYXY(xA: number, yA: number, xB: number, yB: number): Rectangle;
+    /** Creates rectangle with specified bounds. */
+    constructor(left?: number, top?: number, right?: number, bottom?: number);
+    /** @returns Size of this rectangle. */
+    getSize(): Size;
+    /** @returns Width of this rectangle. */
+    getWidth(): number;
+    /** @returns Height of this rectangle. */
+    getHeight(): number;
+    /** @returns Position of specified corner. */
+    getCorner(corner: Corner): Point;
+    /**
+     * Inset the bounds of this rectangle.
+     * @note Negative arguments will increase the size of rectangle.
+     * @returns New [[Rectangle]] with modified bounds.
+     */
+    inset(left: number, top: number, right: number, bottom: number): Rectangle;
+    /**
+     * Offsets the rectangle along the X and Y axes.
+     * @returns New [[Rectangle]] with modified position.
+     */
+    offset(offset: PointProps): Rectangle;
+    /**
+     * Offsets the rectangle along the X axis.
+     * @returns New [[Rectangle]] with modified position along X axis.
+     */
+    offsetX(offset: number): Rectangle;
+    /**
+     * Offsets the rectangle along the Y axis.
+     * @returns New [[Rectangle]] with modified position along Y axis.
+     */
+    offsetY(offset: number): Rectangle;
+    /**
+     * Moves the top left corner of rectangle to specified point.
+     * @returns New [[Rectangle]] with modified position.
+     */
+    setPosition(position: PointProps): Rectangle;
+    /**
+     * Sets the height of the rectangle.
+     * @note Only [[Edge.Bottom]] is subject to change.
+     * @returns New [[Rectangle]] with modified height.
+     */
+    setHeight(height: number): Rectangle;
+    /**
+     * Sets the width of the rectangle.
+     * @note Only [[Edge.Right]] is subject to change.
+     * @returns New [[Rectangle]] with modified width.
+     */
+    setWidth(width: number): Rectangle;
+    /**
+     * Sets the height and width of the rectangle.
+     * @note Only [[Edge.Bottom]] and [[Edge.Right]] are subjects to change.
+     * @returns New [[Rectangle]] with modified height.
+     */
+    setSize(size: SizeProps): Rectangle;
+    /** Checks if bounds of two rectangles match. */
+    equals(other: RectangleProps): boolean;
+    /**
+     * Checks if point is within bounds of the rectangle.
+     * @note Inclusive.
+     */
+    containsPoint(point: PointProps): boolean;
+    /**
+     * Checks if a point given as x,y is within the rectangle.
+     * @note Inclusive.
+     */
+    containsXY(x: number, y: number): boolean;
+    /**
+     * @returns true if this rectangle contains other rectangle.
+     * @note Inclusive.
+     */
+    contains(other: RectangleProps): boolean;
+    /** @returns New [[Rectangle]] which is contained in other rectangle. */
+    containIn(other: RectangleProps): Rectangle;
+    /** @returns New [[Rectangle]] which is vertically contained in other rectangle. */
+    containVerticallyIn(other: RectangleProps): Rectangle;
+    /** @returns New [[Rectangle]] which is horizontally contained in other rectangle. */
+    containHorizontallyIn(other: RectangleProps): Rectangle;
+    /** @returns [[Corner.TopLeft]] position of this rectangle. */
+    topLeft(): Point;
+    /** @returns Center point position of this rectangle. */
+    center(): Point;
+    /** @returns true if this rectangle intersects other rectangle. */
+    intersects(other: RectangleProps): boolean;
+    /**
+     * Merges outer edges of this and other rectangles.
+     * @returns New [[Rectangle]] with merged bounds.
+     */
+    outerMergeWith(other: RectangleProps): Rectangle;
+    /**
+     * Vertically divides this rectangle into specified number of equal height segments.
+     * @returns Vertical rectangle segment.
+     */
+    getVerticalSegmentBounds(segmentId: number, numberOfSegments: number): Rectangle;
+    /**
+     * Horizontally divides this rectangle into specified number of equal width segments.
+     * @returns Horizontal rectangle segment.
+     */
+    getHorizontalSegmentBounds(segmentId: number, numberOfSegments: number): Rectangle;
+    /**
+     * Calculates the shortest distance between this rectangle and a given point.
+     * @returns The shortest distance to a point.
+     */
+    getShortestDistanceToPoint(point: PointProps): number;
+    /** @returns [[RectangleProps]] object for this rectangle. */
+    toProps(): RectangleProps;
+}
+//# sourceMappingURL=Rectangle.d.ts.map

package/lib/esm/core-react/utils/Rectangle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Rectangle.d.ts","sourceRoot":"","sources":["../../../../src/core-react/utils/Rectangle.ts"],"names":[],"mappings":"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"}