@itwin/components-react 4.17.6 → 5.0.0-dev.3

package/lib/components-react/converters/HexadecimalTypeConverter.js

@@ -0,0 +1,40 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module TypeConverters
+ */
+import { Id64 } from "@itwin/core-bentley";
+import { TypeConverter } from "./TypeConverter.js";
+/** Hexadecimal Type Converter.
+ * @public
+ */
+export class HexadecimalTypeConverter extends TypeConverter {
+    convertToString(value) {
+        if (value === undefined)
+            return "";
+        // Need to Uppercase without changing 0x part
+        const hexString = value.toString();
+        return `0x${hexString.substring(2, hexString.length).toUpperCase()}`;
+    }
+    convertFromString(value) {
+        if (value.substring(0, 2) !== "0x")
+            value = `0x${value}`;
+        value = Id64.fromString(value);
+        if (Id64.isValidId64(value))
+            return value;
+        return undefined;
+    }
+    sortCompare(a, b) {
+        // Normalize the strings
+        a = Id64.fromString(a);
+        b = Id64.fromString(b);
+        if (a === b)
+            return 0;
+        if (a > b)
+            return 1;
+        return -1;
+    }
+}
+//# sourceMappingURL=HexadecimalTypeConverter.js.map

package/lib/components-react/converters/HexadecimalTypeConverter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HexadecimalTypeConverter.js","sourceRoot":"","sources":["../../../src/components-react/converters/HexadecimalTypeConverter.ts"],"names":[],"mappings":"AAAA;;;gGAGgG;AAChG;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAE3C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;GAEG;AACH,MAAM,OAAO,wBAAyB,SAAQ,aAAa;IACzC,eAAe,CAAC,KAA8B;QAC5D,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,EAAE,CAAC;QAEnC,6CAA6C;QAC7C,MAAM,SAAS,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;QACnC,OAAO,KAAK,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;IACvE,CAAC;IAEe,iBAAiB,CAAC,KAAa;QAC7C,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,IAAI;YAAE,KAAK,GAAG,KAAK,KAAK,EAAE,CAAC;QAEzD,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAC/B,IAAI,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QAE1C,OAAO,SAAS,CAAC;IACnB,CAAC;IAEM,WAAW,CAChB,CAAyB,EACzB,CAAyB;QAEzB,wBAAwB;QACxB,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACvB,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAEvB,IAAI,CAAC,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;QACtB,IAAI,CAAC,GAAG,CAAC;YAAE,OAAO,CAAC,CAAC;QACpB,OAAO,CAAC,CAAC,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 TypeConverters\n */\n\nimport { Id64 } from \"@itwin/core-bentley\";\nimport type { Primitives } from \"@itwin/appui-abstract\";\nimport { TypeConverter } from \"./TypeConverter.js\";\n\n/** Hexadecimal Type Converter.\n * @public\n */\nexport class HexadecimalTypeConverter extends TypeConverter {\n  public override convertToString(value?: Primitives.Hexadecimal) {\n    if (value === undefined) return \"\";\n\n    // Need to Uppercase without changing 0x part\n    const hexString = value.toString();\n    return `0x${hexString.substring(2, hexString.length).toUpperCase()}`;\n  }\n\n  public override convertFromString(value: string) {\n    if (value.substring(0, 2) !== \"0x\") value = `0x${value}`;\n\n    value = Id64.fromString(value);\n    if (Id64.isValidId64(value)) return value;\n\n    return undefined;\n  }\n\n  public sortCompare(\n    a: Primitives.Hexadecimal,\n    b: Primitives.Hexadecimal\n  ): number {\n    // Normalize the strings\n    a = Id64.fromString(a);\n    b = Id64.fromString(b);\n\n    if (a === b) return 0;\n    if (a > b) return 1;\n    return -1;\n  }\n}\n"]}

package/lib/components-react/converters/NavigationPropertyTypeConverter.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @packageDocumentation
+ * @module TypeConverters
+ */
+import type { Primitives, PropertyDescription } from "@itwin/appui-abstract";
+import { TypeConverter } from "./TypeConverter.js";
+/**
+ * Navigation property type converter.
+ * @public
+ */
+export declare class NavigationPropertyTypeConverter extends TypeConverter {
+    convertPropertyToString(propertyDescription: PropertyDescription, value?: Primitives.Value): string;
+    sortCompare(a: Primitives.Value, b: Primitives.Value, ignoreCase?: boolean): number;
+}
+//# sourceMappingURL=NavigationPropertyTypeConverter.d.ts.map

package/lib/components-react/converters/NavigationPropertyTypeConverter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NavigationPropertyTypeConverter.d.ts","sourceRoot":"","sources":["../../../src/components-react/converters/NavigationPropertyTypeConverter.ts"],"names":[],"mappings":"AAIA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE7E,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD;;;GAGG;AACH,qBAAa,+BAAgC,SAAQ,aAAa;IAChD,uBAAuB,CACrC,mBAAmB,EAAE,mBAAmB,EACxC,KAAK,CAAC,EAAE,UAAU,CAAC,KAAK;IAKnB,WAAW,CAChB,CAAC,EAAE,UAAU,CAAC,KAAK,EACnB,CAAC,EAAE,UAAU,CAAC,KAAK,EACnB,UAAU,CAAC,EAAE,OAAO,GACnB,MAAM;CASV"}

package/lib/components-react/converters/NavigationPropertyTypeConverter.js

@@ -0,0 +1,24 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+/**
+ * @packageDocumentation
+ * @module TypeConverters
+ */
+import { StandardTypeNames } from "@itwin/appui-abstract";
+import { TypeConverter } from "./TypeConverter.js";
+import { TypeConverterManager } from "./TypeConverterManager.js";
+/**
+ * Navigation property type converter.
+ * @public
+ */
+export class NavigationPropertyTypeConverter extends TypeConverter {
+    convertPropertyToString(propertyDescription, value) {
+        return value === undefined ? "" : propertyDescription.displayLabel;
+    }
+    sortCompare(a, b, ignoreCase) {
+        return TypeConverterManager.getConverter(StandardTypeNames.Hexadecimal).sortCompare(a.id, b.id, ignoreCase);
+    }
+}
+//# sourceMappingURL=NavigationPropertyTypeConverter.js.map

package/lib/components-react/converters/NavigationPropertyTypeConverter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NavigationPropertyTypeConverter.js","sourceRoot":"","sources":["../../../src/components-react/converters/NavigationPropertyTypeConverter.ts"],"names":[],"mappings":"AAAA;;;gGAGgG;AAChG;;;GAGG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEjE;;;GAGG;AACH,MAAM,OAAO,+BAAgC,SAAQ,aAAa;IAChD,uBAAuB,CACrC,mBAAwC,EACxC,KAAwB;QAExB,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,YAAY,CAAC;IACrE,CAAC;IAEM,WAAW,CAChB,CAAmB,EACnB,CAAmB,EACnB,UAAoB;QAEpB,OAAO,oBAAoB,CAAC,YAAY,CACtC,iBAAiB,CAAC,WAAW,CAC9B,CAAC,WAAW,CACV,CAA4B,CAAC,EAAE,EAC/B,CAA4B,CAAC,EAAE,EAChC,UAAU,CACX,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/**\n * @packageDocumentation\n * @module TypeConverters\n */\n\nimport type { Primitives, PropertyDescription } from \"@itwin/appui-abstract\";\nimport { StandardTypeNames } from \"@itwin/appui-abstract\";\nimport { TypeConverter } from \"./TypeConverter.js\";\nimport { TypeConverterManager } from \"./TypeConverterManager.js\";\n\n/**\n * Navigation property type converter.\n * @public\n */\nexport class NavigationPropertyTypeConverter extends TypeConverter {\n  public override convertPropertyToString(\n    propertyDescription: PropertyDescription,\n    value?: Primitives.Value\n  ) {\n    return value === undefined ? \"\" : propertyDescription.displayLabel;\n  }\n\n  public sortCompare(\n    a: Primitives.Value,\n    b: Primitives.Value,\n    ignoreCase?: boolean\n  ): number {\n    return TypeConverterManager.getConverter(\n      StandardTypeNames.Hexadecimal\n    ).sortCompare(\n      (a as Primitives.InstanceKey).id,\n      (b as Primitives.InstanceKey).id,\n      ignoreCase\n    );\n  }\n}\n"]}

package/lib/components-react/converters/NumericTypeConverter.d.ts

@@ -0,0 +1,37 @@
+/** @packageDocumentation
+ * @module TypeConverters
+ */
+import type { Primitives } from "@itwin/appui-abstract";
+import type { LessGreaterOperatorProcessor } from "./TypeConverter.js";
+import { TypeConverter } from "./TypeConverter.js";
+/**
+ * Base Numeric Type Converter.
+ * @public
+ */
+export declare abstract class NumericTypeConverterBase extends TypeConverter implements LessGreaterOperatorProcessor {
+    get isLessGreaterType(): boolean;
+    isLessThan(a: Primitives.Numeric, b: Primitives.Numeric): boolean;
+    isLessThanOrEqualTo(a: Primitives.Numeric, b: Primitives.Numeric): boolean;
+    isGreaterThan(a: Primitives.Numeric, b: Primitives.Numeric): boolean;
+    isGreaterThanOrEqualTo(a: Primitives.Numeric, b: Primitives.Numeric): boolean;
+    sortCompare(a: Primitives.Numeric, b: Primitives.Numeric, _ignoreCase?: boolean): number;
+}
+/**
+ * Float Type Converter.
+ * @public
+ */
+export declare class FloatTypeConverter extends NumericTypeConverterBase {
+    private static parseString;
+    convertToString(value?: Primitives.Float): string;
+    convertFromString(value: string): number | undefined;
+}
+/**
+ * Int Type Converter.
+ * @public
+ */
+export declare class IntTypeConverter extends NumericTypeConverterBase {
+    private static parseString;
+    convertToString(value?: Primitives.Int): string;
+    convertFromString(value: string): number | undefined;
+}
+//# sourceMappingURL=NumericTypeConverter.d.ts.map

package/lib/components-react/converters/NumericTypeConverter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NumericTypeConverter.d.ts","sourceRoot":"","sources":["../../../src/components-react/converters/NumericTypeConverter.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;;GAGG;AACH,8BAAsB,wBACpB,SAAQ,aACR,YAAW,4BAA4B;IAEvC,IAAoB,iBAAiB,IAAI,OAAO,CAE/C;IAEM,UAAU,CAAC,CAAC,EAAE,UAAU,CAAC,OAAO,EAAE,CAAC,EAAE,UAAU,CAAC,OAAO,GAAG,OAAO;IAIjE,mBAAmB,CACxB,CAAC,EAAE,UAAU,CAAC,OAAO,EACrB,CAAC,EAAE,UAAU,CAAC,OAAO,GACpB,OAAO;IAIH,aAAa,CAAC,CAAC,EAAE,UAAU,CAAC,OAAO,EAAE,CAAC,EAAE,UAAU,CAAC,OAAO,GAAG,OAAO;IAIpE,sBAAsB,CAC3B,CAAC,EAAE,UAAU,CAAC,OAAO,EACrB,CAAC,EAAE,UAAU,CAAC,OAAO,GACpB,OAAO;IAIH,WAAW,CAChB,CAAC,EAAE,UAAU,CAAC,OAAO,EACrB,CAAC,EAAE,UAAU,CAAC,OAAO,EACrB,WAAW,CAAC,EAAE,OAAO,GACpB,MAAM;CAGV;AAED;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,wBAAwB;IAC9D,OAAO,CAAC,MAAM,CAAC,WAAW;IAKV,eAAe,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC,KAAK;IAsBxC,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAGrE;AAED;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,wBAAwB;IAC5D,OAAO,CAAC,MAAM,CAAC,WAAW;IAKV,eAAe,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC,GAAG;IAiBtC,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAGrE"}

package/lib/components-react/converters/NumericTypeConverter.js

@@ -0,0 +1,101 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module TypeConverters
+ */
+import { TypeConverter } from "./TypeConverter.js";
+/**
+ * Base Numeric Type Converter.
+ * @public
+ */
+export class NumericTypeConverterBase extends TypeConverter {
+    get isLessGreaterType() {
+        return true;
+    }
+    isLessThan(a, b) {
+        return a < b;
+    }
+    isLessThanOrEqualTo(a, b) {
+        return a <= b;
+    }
+    isGreaterThan(a, b) {
+        return a > b;
+    }
+    isGreaterThanOrEqualTo(a, b) {
+        return a >= b;
+    }
+    sortCompare(a, b, _ignoreCase) {
+        return +a - +b;
+    }
+}
+/**
+ * Float Type Converter.
+ * @public
+ */
+export class FloatTypeConverter extends NumericTypeConverterBase {
+    static parseString(value) {
+        const parsedValue = parseFloat(value);
+        return Number.isNaN(parsedValue) ? undefined : parsedValue;
+    }
+    convertToString(value) {
+        if (value === undefined)
+            return "";
+        let numericValue = 0;
+        if (typeof value === "string") {
+            if (value === "-" || value === "" || value === "-0.0" || value === "-0") {
+                // handle these semi-valid values as 0
+                numericValue = 0;
+            }
+            else {
+                numericValue = FloatTypeConverter.parseString(value) ?? 0;
+            }
+        }
+        else {
+            numericValue = value;
+        }
+        // this is close to calling `toFixed(2)`, but cuts of any trailing zeros
+        let stringValue = (Math.round(100 * numericValue) / 100).toString();
+        // because this is a _float_ converter, we want to emphasize the number is a float - make
+        // sure there's a decimal part
+        if (stringValue.indexOf(".") === -1)
+            stringValue += ".0";
+        return stringValue;
+    }
+    convertFromString(value) {
+        return FloatTypeConverter.parseString(value);
+    }
+}
+/**
+ * Int Type Converter.
+ * @public
+ */
+export class IntTypeConverter extends NumericTypeConverterBase {
+    static parseString(value) {
+        const parsedValue = parseInt(value, 10);
+        return Number.isNaN(parsedValue) ? undefined : parsedValue;
+    }
+    convertToString(value) {
+        if (value === undefined)
+            return "";
+        let numericValue = 0;
+        if (typeof value === "string") {
+            if (value === "-" || value === "" || value === "-0") {
+                // handle these semi-valid values as 0
+                numericValue = 0;
+            }
+            else {
+                numericValue = IntTypeConverter.parseString(value) ?? 0;
+            }
+        }
+        else {
+            numericValue = value;
+        }
+        return Math.round(numericValue).toString();
+    }
+    convertFromString(value) {
+        return IntTypeConverter.parseString(value);
+    }
+}
+//# sourceMappingURL=NumericTypeConverter.js.map

package/lib/components-react/converters/NumericTypeConverter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NumericTypeConverter.js","sourceRoot":"","sources":["../../../src/components-react/converters/NumericTypeConverter.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 TypeConverters\n */\n\nimport type { Primitives } from \"@itwin/appui-abstract\";\nimport type { LessGreaterOperatorProcessor } from \"./TypeConverter.js\";\nimport { TypeConverter } from \"./TypeConverter.js\";\n\n/**\n * Base Numeric Type Converter.\n * @public\n */\nexport abstract class NumericTypeConverterBase\n  extends TypeConverter\n  implements LessGreaterOperatorProcessor\n{\n  public override get isLessGreaterType(): boolean {\n    return true;\n  }\n\n  public isLessThan(a: Primitives.Numeric, b: Primitives.Numeric): boolean {\n    return a < b;\n  }\n\n  public isLessThanOrEqualTo(\n    a: Primitives.Numeric,\n    b: Primitives.Numeric\n  ): boolean {\n    return a <= b;\n  }\n\n  public isGreaterThan(a: Primitives.Numeric, b: Primitives.Numeric): boolean {\n    return a > b;\n  }\n\n  public isGreaterThanOrEqualTo(\n    a: Primitives.Numeric,\n    b: Primitives.Numeric\n  ): boolean {\n    return a >= b;\n  }\n\n  public sortCompare(\n    a: Primitives.Numeric,\n    b: Primitives.Numeric,\n    _ignoreCase?: boolean\n  ): number {\n    return +a - +b;\n  }\n}\n\n/**\n * Float Type Converter.\n * @public\n */\nexport class FloatTypeConverter extends NumericTypeConverterBase {\n  private static parseString(value: string): number | undefined {\n    const parsedValue = parseFloat(value);\n    return Number.isNaN(parsedValue) ? undefined : parsedValue;\n  }\n\n  public override convertToString(value?: Primitives.Float) {\n    if (value === undefined) return \"\";\n\n    let numericValue = 0;\n    if (typeof value === \"string\") {\n      if (value === \"-\" || value === \"\" || value === \"-0.0\" || value === \"-0\") {\n        // handle these semi-valid values as 0\n        numericValue = 0;\n      } else {\n        numericValue = FloatTypeConverter.parseString(value) ?? 0;\n      }\n    } else {\n      numericValue = value;\n    }\n    // this is close to calling `toFixed(2)`, but cuts of any trailing zeros\n    let stringValue = (Math.round(100 * numericValue) / 100).toString();\n    // because this is a _float_ converter, we want to emphasize the number is a float - make\n    // sure there's a decimal part\n    if (stringValue.indexOf(\".\") === -1) stringValue += \".0\";\n    return stringValue;\n  }\n\n  public override convertFromString(value: string): number | undefined {\n    return FloatTypeConverter.parseString(value);\n  }\n}\n\n/**\n * Int Type Converter.\n * @public\n */\nexport class IntTypeConverter extends NumericTypeConverterBase {\n  private static parseString(value: string): number | undefined {\n    const parsedValue = parseInt(value, 10);\n    return Number.isNaN(parsedValue) ? undefined : parsedValue;\n  }\n\n  public override convertToString(value?: Primitives.Int) {\n    if (value === undefined) return \"\";\n\n    let numericValue = 0;\n    if (typeof value === \"string\") {\n      if (value === \"-\" || value === \"\" || value === \"-0\") {\n        // handle these semi-valid values as 0\n        numericValue = 0;\n      } else {\n        numericValue = IntTypeConverter.parseString(value) ?? 0;\n      }\n    } else {\n      numericValue = value;\n    }\n    return Math.round(numericValue).toString();\n  }\n\n  public override convertFromString(value: string): number | undefined {\n    return IntTypeConverter.parseString(value);\n  }\n}\n"]}

package/lib/components-react/converters/PointTypeConverter.d.ts

@@ -0,0 +1,39 @@
+/** @packageDocumentation
+ * @module TypeConverters
+ */
+import type { Primitives } from "@itwin/appui-abstract";
+import { TypeConverter } from "./TypeConverter.js";
+import type { ConvertedPrimitives } from "./valuetypes/ConvertedTypes.js";
+/**
+ * Point type converter.
+ * @public
+ */
+export declare abstract class BasePointTypeConverter extends TypeConverter {
+    componentConverterName: string;
+    constructor(componentConverterName?: string);
+    private formatValue;
+    convertToString(value?: Primitives.Point): string | Promise<string>;
+    convertFromString(value: string): ConvertedPrimitives.Point | undefined;
+    protected abstract constructPoint(_values: Primitives.Point): ConvertedPrimitives.Point | undefined;
+    protected abstract getVectorLength(point: Primitives.Point): number | undefined;
+    sortCompare(a: Primitives.Point, b: Primitives.Point, _ignoreCase?: boolean): number;
+}
+/**
+ * Point2d type converter.
+ * @public
+ */
+export declare class Point2dTypeConverter extends BasePointTypeConverter {
+    constructor(componentConverterName?: string);
+    protected getVectorLength(point: Primitives.Point): number | undefined;
+    protected constructPoint(values: Primitives.Point): ConvertedPrimitives.Point2d | undefined;
+}
+/**
+ * Point3d type converter.
+ * @public
+ */
+export declare class Point3dTypeConverter extends BasePointTypeConverter {
+    constructor(componentConverterName?: string);
+    protected getVectorLength(point: Primitives.Point): number | undefined;
+    protected constructPoint(values: Primitives.Point): ConvertedPrimitives.Point3d | undefined;
+}
+//# sourceMappingURL=PointTypeConverter.d.ts.map

package/lib/components-react/converters/PointTypeConverter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PointTypeConverter.d.ts","sourceRoot":"","sources":["../../../src/components-react/converters/PointTypeConverter.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAK1E;;;GAGG;AACH,8BAAsB,sBAAuB,SAAQ,aAAa;IACzD,sBAAsB,EAAE,MAAM,CAAC;gBAGpC,sBAAsB,GAAE,MAAiC;IAM3D,OAAO,CAAC,WAAW;IAOH,eAAe,CAC7B,KAAK,CAAC,EAAE,UAAU,CAAC,KAAK,GACvB,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAyBX,iBAAiB,CAAC,KAAK,EAAE,MAAM;IAG/C,SAAS,CAAC,QAAQ,CAAC,cAAc,CAC/B,OAAO,EAAE,UAAU,CAAC,KAAK,GACxB,mBAAmB,CAAC,KAAK,GAAG,SAAS;IAExC,SAAS,CAAC,QAAQ,CAAC,eAAe,CAChC,KAAK,EAAE,UAAU,CAAC,KAAK,GACtB,MAAM,GAAG,SAAS;IAEd,WAAW,CAChB,CAAC,EAAE,UAAU,CAAC,KAAK,EACnB,CAAC,EAAE,UAAU,CAAC,KAAK,EACnB,WAAW,CAAC,EAAE,OAAO,GACpB,MAAM;CAUV;AAED;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,sBAAsB;gBAC3C,sBAAsB,CAAC,EAAE,MAAM;IAIlD,SAAS,CAAC,eAAe,CAAC,KAAK,EAAE,UAAU,CAAC,KAAK,GAAG,MAAM,GAAG,SAAS;IAQtE,SAAS,CAAC,cAAc,CACtB,MAAM,EAAE,UAAU,CAAC,KAAK,GACvB,mBAAmB,CAAC,OAAO,GAAG,SAAS;CAQ3C;AAED;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,sBAAsB;gBAC3C,sBAAsB,CAAC,EAAE,MAAM;IAIlD,SAAS,CAAC,eAAe,CAAC,KAAK,EAAE,UAAU,CAAC,KAAK,GAAG,MAAM,GAAG,SAAS;IAYtE,SAAS,CAAC,cAAc,CACtB,MAAM,EAAE,UAAU,CAAC,KAAK,GACvB,mBAAmB,CAAC,OAAO,GAAG,SAAS;CAc3C"}

package/lib/components-react/converters/PointTypeConverter.js

@@ -0,0 +1,116 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module TypeConverters
+ */
+import { StandardTypeNames } from "@itwin/appui-abstract";
+import { TypeConverter } from "./TypeConverter.js";
+import { TypeConverterManager } from "./TypeConverterManager.js";
+import { isPromiseLike } from "../common/UseAsyncValue.js";
+// cSpell:ignore valuetypes
+/**
+ * Point type converter.
+ * @public
+ */
+export class BasePointTypeConverter extends TypeConverter {
+    constructor(componentConverterName = StandardTypeNames.Double) {
+        super();
+        this.componentConverterName = componentConverterName;
+    }
+    formatValue(value) {
+        if (typeof value === "string")
+            value = parseFloat(value);
+        return TypeConverterManager.getConverter(this.componentConverterName).convertToString(value);
+    }
+    convertToString(value) {
+        if (!value)
+            return "";
+        let components = new Array();
+        if (Array.isArray(value)) {
+            if (value.length === 0)
+                return "";
+            // eslint-disable-next-line @typescript-eslint/no-floating-promises
+            components = value.map((c) => this.formatValue(c));
+        }
+        else {
+            // eslint-disable-next-line @typescript-eslint/no-floating-promises
+            components = [this.formatValue(value.x), this.formatValue(value.y)];
+            if (undefined !== value.z)
+                components.push(this.formatValue(value.z));
+        }
+        const hasAsyncComponents = components.some(isPromiseLike);
+        if (hasAsyncComponents) {
+            return Promise.all(components.map(async (c) => (isPromiseLike(c) ? c : Promise.resolve(c)))).then((c) => c.join(", "));
+        }
+        return components.join(", ");
+    }
+    convertFromString(value) {
+        return this.constructPoint(value.split(","));
+    }
+    sortCompare(a, b, _ignoreCase) {
+        const aLength = this.getVectorLength(a);
+        const bLength = this.getVectorLength(b);
+        if (aLength === bLength)
+            return 0;
+        if (aLength === undefined)
+            return -1;
+        if (bLength === undefined)
+            return 1;
+        return aLength - bLength;
+    }
+}
+/**
+ * Point2d type converter.
+ * @public
+ */
+export class Point2dTypeConverter extends BasePointTypeConverter {
+    constructor(componentConverterName) {
+        super(componentConverterName);
+    }
+    getVectorLength(point) {
+        const derivedPoint = this.constructPoint(point);
+        if (derivedPoint === undefined)
+            return undefined;
+        return Math.sqrt(Math.pow(derivedPoint.x, 2) + Math.pow(derivedPoint.y, 2));
+    }
+    constructPoint(values) {
+        if (Array.isArray(values)) {
+            if (values.length !== 2 || isNaN(+values[0]) || isNaN(+values[1]))
+                return undefined;
+            return { x: +values[0], y: +values[1] };
+        }
+        return values;
+    }
+}
+/**
+ * Point3d type converter.
+ * @public
+ */
+export class Point3dTypeConverter extends BasePointTypeConverter {
+    constructor(componentConverterName) {
+        super(componentConverterName);
+    }
+    getVectorLength(point) {
+        const derivedPoint = this.constructPoint(point);
+        if (derivedPoint === undefined)
+            return undefined;
+        return Math.sqrt(Math.pow(derivedPoint.x, 2) +
+            Math.pow(derivedPoint.y, 2) +
+            Math.pow(derivedPoint.z, 2));
+    }
+    constructPoint(values) {
+        if (Array.isArray(values)) {
+            if (values.length !== 3 ||
+                isNaN(+values[0]) ||
+                isNaN(+values[1]) ||
+                isNaN(+values[2]))
+                return undefined;
+            return { x: +values[0], y: +values[1], z: +values[2] };
+        }
+        const z = values.z;
+        return { ...values, z: z ? z : 0 };
+    }
+}
+//# sourceMappingURL=PointTypeConverter.js.map

package/lib/components-react/converters/PointTypeConverter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PointTypeConverter.js","sourceRoot":"","sources":["../../../src/components-react/converters/PointTypeConverter.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 TypeConverters\n */\n\nimport type { Primitives } from \"@itwin/appui-abstract\";\nimport { StandardTypeNames } from \"@itwin/appui-abstract\";\nimport { TypeConverter } from \"./TypeConverter.js\";\nimport { TypeConverterManager } from \"./TypeConverterManager.js\";\nimport type { ConvertedPrimitives } from \"./valuetypes/ConvertedTypes.js\";\nimport { isPromiseLike } from \"../common/UseAsyncValue.js\";\n\n// cSpell:ignore valuetypes\n\n/**\n * Point type converter.\n * @public\n */\nexport abstract class BasePointTypeConverter extends TypeConverter {\n  public componentConverterName: string;\n\n  public constructor(\n    componentConverterName: string = StandardTypeNames.Double\n  ) {\n    super();\n    this.componentConverterName = componentConverterName;\n  }\n\n  private formatValue(value: number | string): string | Promise<string> {\n    if (typeof value === \"string\") value = parseFloat(value);\n    return TypeConverterManager.getConverter(\n      this.componentConverterName\n    ).convertToString(value);\n  }\n\n  public override convertToString(\n    value?: Primitives.Point\n  ): string | Promise<string> {\n    if (!value) return \"\";\n\n    let components = new Array<string | Promise<string>>();\n    if (Array.isArray(value)) {\n      if (value.length === 0) return \"\";\n      // eslint-disable-next-line @typescript-eslint/no-floating-promises\n      components = (value as Array<string | number>).map(\n        (c): string | Promise<string> => this.formatValue(c)\n      );\n    } else {\n      // eslint-disable-next-line @typescript-eslint/no-floating-promises\n      components = [this.formatValue(value.x), this.formatValue(value.y)];\n      if (undefined !== (value as any).z)\n        components.push(this.formatValue((value as any).z));\n    }\n    const hasAsyncComponents = components.some(isPromiseLike);\n    if (hasAsyncComponents) {\n      return Promise.all(\n        components.map(async (c) => (isPromiseLike(c) ? c : Promise.resolve(c)))\n      ).then((c) => c.join(\", \"));\n    }\n    return components.join(\", \");\n  }\n\n  public override convertFromString(value: string) {\n    return this.constructPoint(value.split(\",\"));\n  }\n  protected abstract constructPoint(\n    _values: Primitives.Point\n  ): ConvertedPrimitives.Point | undefined;\n\n  protected abstract getVectorLength(\n    point: Primitives.Point\n  ): number | undefined;\n\n  public sortCompare(\n    a: Primitives.Point,\n    b: Primitives.Point,\n    _ignoreCase?: boolean\n  ): number {\n    const aLength = this.getVectorLength(a);\n    const bLength = this.getVectorLength(b);\n\n    if (aLength === bLength) return 0;\n    if (aLength === undefined) return -1;\n    if (bLength === undefined) return 1;\n\n    return aLength - bLength;\n  }\n}\n\n/**\n * Point2d type converter.\n * @public\n */\nexport class Point2dTypeConverter extends BasePointTypeConverter {\n  public constructor(componentConverterName?: string) {\n    super(componentConverterName);\n  }\n\n  protected getVectorLength(point: Primitives.Point): number | undefined {\n    const derivedPoint = this.constructPoint(point);\n\n    if (derivedPoint === undefined) return undefined;\n\n    return Math.sqrt(Math.pow(derivedPoint.x, 2) + Math.pow(derivedPoint.y, 2));\n  }\n\n  protected constructPoint(\n    values: Primitives.Point\n  ): ConvertedPrimitives.Point2d | undefined {\n    if (Array.isArray(values)) {\n      if (values.length !== 2 || isNaN(+values[0]) || isNaN(+values[1]))\n        return undefined;\n      return { x: +values[0], y: +values[1] };\n    }\n    return values;\n  }\n}\n\n/**\n * Point3d type converter.\n * @public\n */\nexport class Point3dTypeConverter extends BasePointTypeConverter {\n  public constructor(componentConverterName?: string) {\n    super(componentConverterName);\n  }\n\n  protected getVectorLength(point: Primitives.Point): number | undefined {\n    const derivedPoint = this.constructPoint(point);\n\n    if (derivedPoint === undefined) return undefined;\n\n    return Math.sqrt(\n      Math.pow(derivedPoint.x, 2) +\n        Math.pow(derivedPoint.y, 2) +\n        Math.pow(derivedPoint.z, 2)\n    );\n  }\n\n  protected constructPoint(\n    values: Primitives.Point\n  ): ConvertedPrimitives.Point3d | undefined {\n    if (Array.isArray(values)) {\n      if (\n        values.length !== 3 ||\n        isNaN(+values[0]) ||\n        isNaN(+values[1]) ||\n        isNaN(+values[2])\n      )\n        return undefined;\n      return { x: +values[0], y: +values[1], z: +values[2] };\n    }\n    const z = (values as any).z;\n    return { ...values, z: z ? z : 0 };\n  }\n}\n"]}

package/lib/components-react/converters/StringTypeConverter.d.ts

@@ -0,0 +1,46 @@
+/** @packageDocumentation
+ * @module TypeConverters
+ */
+import type { Primitives } from "@itwin/appui-abstract";
+import { TypeConverter } from "./TypeConverter.js";
+/** Operators for string types
+ * @public
+ */
+export interface StringOperatorProcessor {
+    /** Determines if one string starts with another string */
+    startsWith(a: string, b: string, caseSensitive: boolean): boolean;
+    /** Determines if one string ends with another string */
+    endsWith(a: string, b: string, caseSensitive: boolean): boolean;
+    /** Determines if one string contains another string */
+    contains(a: string, b: string, caseSensitive: boolean): boolean;
+    /** Determines if one string does not contain another string */
+    doesNotContain(a: string, b: string, caseSensitive: boolean): boolean;
+    /** Determines if one string is contained within another string */
+    isContainedIn(a: string, b: string, caseSensitive: boolean): boolean;
+    /** Determines if one string is not contained within another string */
+    isNotContainedIn(a: string, b: string, caseSensitive: boolean): boolean;
+    /** Determines if a string is empty */
+    isEmpty(a: string): boolean;
+    /** Determines if a string is not empty */
+    isNotEmpty(a: string): boolean;
+}
+/**
+ * String Type Converter.
+ * @public
+ */
+export declare class StringTypeConverter extends TypeConverter implements StringOperatorProcessor {
+    convertToString(value?: Primitives.String): string;
+    convertFromString(value: string): string;
+    sortCompare(valueA: Primitives.String, valueB: Primitives.String, ignoreCase?: boolean): number;
+    get isStringType(): boolean;
+    startsWith(valueA: string, valueB: string, caseSensitive: boolean): boolean;
+    endsWith(valueA: string, valueB: string, caseSensitive: boolean): boolean;
+    contains(valueA: string, valueB: string, caseSensitive: boolean): boolean;
+    doesNotContain(valueA: string, valueB: string, caseSensitive: boolean): boolean;
+    isContainedIn(valueA: string, valueB: string, caseSensitive: boolean): boolean;
+    isNotContainedIn(valueA: string, valueB: string, caseSensitive: boolean): boolean;
+    isEmpty(valueA: string): boolean;
+    isNotEmpty(valueA: string): boolean;
+    private checkArgTypes;
+}
+//# sourceMappingURL=StringTypeConverter.d.ts.map

package/lib/components-react/converters/StringTypeConverter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StringTypeConverter.d.ts","sourceRoot":"","sources":["../../../src/components-react/converters/StringTypeConverter.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,0DAA0D;IAC1D,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,GAAG,OAAO,CAAC;IAClE,wDAAwD;IACxD,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,GAAG,OAAO,CAAC;IAChE,uDAAuD;IACvD,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,GAAG,OAAO,CAAC;IAChE,+DAA+D;IAC/D,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,GAAG,OAAO,CAAC;IACtE,kEAAkE;IAClE,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,GAAG,OAAO,CAAC;IACrE,sEAAsE;IACtE,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,GAAG,OAAO,CAAC;IACxE,sCAAsC;IACtC,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC5B,0CAA0C;IAC1C,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CAChC;AAED;;;GAGG;AACH,qBAAa,mBACX,SAAQ,aACR,YAAW,uBAAuB;IAElB,eAAe,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC,MAAM;IAIzC,iBAAiB,CAAC,KAAK,EAAE,MAAM;IAIxC,WAAW,CAChB,MAAM,EAAE,UAAU,CAAC,MAAM,EACzB,MAAM,EAAE,UAAU,CAAC,MAAM,EACzB,UAAU,CAAC,EAAE,OAAO,GACnB,MAAM;IAST,IAAoB,YAAY,IAAI,OAAO,CAE1C;IAEM,UAAU,CACf,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,OAAO,GACrB,OAAO;IAWH,QAAQ,CACb,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,OAAO,GACrB,OAAO;IAgBH,QAAQ,CACb,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,OAAO,GACrB,OAAO;IAYH,cAAc,CACnB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,OAAO,GACrB,OAAO;IAIH,aAAa,CAClB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,OAAO,GACrB,OAAO;IAIH,gBAAgB,CACrB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,OAAO,GACrB,OAAO;IAIH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAKhC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAI1C,OAAO,CAAC,aAAa;CAKtB"}

package/lib/components-react/converters/StringTypeConverter.js

@@ -0,0 +1,93 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module TypeConverters
+ */
+import { TypeConverter } from "./TypeConverter.js";
+/**
+ * String Type Converter.
+ * @public
+ */
+export class StringTypeConverter extends TypeConverter {
+    convertToString(value) {
+        return value ? value.toString() : "";
+    }
+    convertFromString(value) {
+        return value;
+    }
+    sortCompare(valueA, valueB, ignoreCase) {
+        if (!this.checkArgTypes(valueA, valueB))
+            return 0;
+        if (ignoreCase)
+            return valueA
+                .toLocaleLowerCase()
+                .localeCompare(valueB.toLocaleLowerCase());
+        else
+            return valueA.localeCompare(valueB);
+    }
+    get isStringType() {
+        return true;
+    }
+    startsWith(valueA, valueB, caseSensitive) {
+        if (!valueA || !valueB || !this.checkArgTypes(valueA, valueB))
+            return false;
+        if (caseSensitive)
+            return valueA.substring(0, valueB.length) === valueB;
+        return (valueA.toLocaleUpperCase().substring(0, valueB.length) ===
+            valueB.toLocaleUpperCase());
+    }
+    endsWith(valueA, valueB, caseSensitive) {
+        if (!valueA || !valueB || !this.checkArgTypes(valueA, valueB))
+            return false;
+        const position = valueA.length - valueB.length;
+        if (position < 0)
+            return false;
+        let lastIndex;
+        if (caseSensitive)
+            lastIndex = valueA.indexOf(valueB, position);
+        else
+            lastIndex = valueA
+                .toLocaleUpperCase()
+                .indexOf(valueB.toLocaleUpperCase(), position);
+        return lastIndex !== -1 && lastIndex === position;
+    }
+    contains(valueA, valueB, caseSensitive) {
+        if (!valueA || !valueB || !this.checkArgTypes(valueA, valueB))
+            return false;
+        if (valueB.length > valueA.length)
+            return false;
+        if (caseSensitive)
+            return valueA.indexOf(valueB, 0) !== -1;
+        return (valueA.toLocaleUpperCase().indexOf(valueB.toLocaleUpperCase(), 0) !== -1);
+    }
+    doesNotContain(valueA, valueB, caseSensitive) {
+        return !this.contains(valueA, valueB, caseSensitive);
+    }
+    isContainedIn(valueA, valueB, caseSensitive) {
+        return this.contains(valueB, valueA, caseSensitive);
+    }
+    isNotContainedIn(valueA, valueB, caseSensitive) {
+        return this.doesNotContain(valueB, valueA, caseSensitive);
+    }
+    isEmpty(valueA) {
+        if (!this.checkArgTypes(valueA))
+            return true;
+        return valueA.length === 0;
+    }
+    isNotEmpty(valueA) {
+        return !this.isEmpty(valueA);
+    }
+    checkArgTypes(valueA, valueB) {
+        if (typeof valueA !== "string")
+            return false;
+        if (valueB && typeof valueB !== "string")
+            return false;
+        return true;
+    }
+}
+/*
+NOTE: As this is the default type converter, it's registrations are directly in TypeConverterManager file.
+*/
+//# sourceMappingURL=StringTypeConverter.js.map

package/lib/components-react/converters/StringTypeConverter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StringTypeConverter.js","sourceRoot":"","sources":["../../../src/components-react/converters/StringTypeConverter.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 TypeConverters\n */\n\nimport type { Primitives } from \"@itwin/appui-abstract\";\nimport { TypeConverter } from \"./TypeConverter.js\";\n\n/** Operators for string types\n * @public\n */\nexport interface StringOperatorProcessor {\n  /** Determines if one string starts with another string */\n  startsWith(a: string, b: string, caseSensitive: boolean): boolean;\n  /** Determines if one string ends with another string */\n  endsWith(a: string, b: string, caseSensitive: boolean): boolean;\n  /** Determines if one string contains another string */\n  contains(a: string, b: string, caseSensitive: boolean): boolean;\n  /** Determines if one string does not contain another string */\n  doesNotContain(a: string, b: string, caseSensitive: boolean): boolean;\n  /** Determines if one string is contained within another string */\n  isContainedIn(a: string, b: string, caseSensitive: boolean): boolean;\n  /** Determines if one string is not contained within another string */\n  isNotContainedIn(a: string, b: string, caseSensitive: boolean): boolean;\n  /** Determines if a string is empty */\n  isEmpty(a: string): boolean;\n  /** Determines if a string is not empty */\n  isNotEmpty(a: string): boolean;\n}\n\n/**\n * String Type Converter.\n * @public\n */\nexport class StringTypeConverter\n  extends TypeConverter\n  implements StringOperatorProcessor\n{\n  public override convertToString(value?: Primitives.String) {\n    return value ? value.toString() : \"\";\n  }\n\n  public override convertFromString(value: string) {\n    return value;\n  }\n\n  public sortCompare(\n    valueA: Primitives.String,\n    valueB: Primitives.String,\n    ignoreCase?: boolean\n  ): number {\n    if (!this.checkArgTypes(valueA, valueB)) return 0;\n    if (ignoreCase)\n      return valueA\n        .toLocaleLowerCase()\n        .localeCompare(valueB.toLocaleLowerCase());\n    else return valueA.localeCompare(valueB);\n  }\n\n  public override get isStringType(): boolean {\n    return true;\n  }\n\n  public startsWith(\n    valueA: string,\n    valueB: string,\n    caseSensitive: boolean\n  ): boolean {\n    if (!valueA || !valueB || !this.checkArgTypes(valueA, valueB)) return false;\n\n    if (caseSensitive) return valueA.substring(0, valueB.length) === valueB;\n\n    return (\n      valueA.toLocaleUpperCase().substring(0, valueB.length) ===\n      valueB.toLocaleUpperCase()\n    );\n  }\n\n  public endsWith(\n    valueA: string,\n    valueB: string,\n    caseSensitive: boolean\n  ): boolean {\n    if (!valueA || !valueB || !this.checkArgTypes(valueA, valueB)) return false;\n\n    const position = valueA.length - valueB.length;\n    if (position < 0) return false;\n\n    let lastIndex: number;\n    if (caseSensitive) lastIndex = valueA.indexOf(valueB, position);\n    else\n      lastIndex = valueA\n        .toLocaleUpperCase()\n        .indexOf(valueB.toLocaleUpperCase(), position);\n\n    return lastIndex !== -1 && lastIndex === position;\n  }\n\n  public contains(\n    valueA: string,\n    valueB: string,\n    caseSensitive: boolean\n  ): boolean {\n    if (!valueA || !valueB || !this.checkArgTypes(valueA, valueB)) return false;\n\n    if (valueB.length > valueA.length) return false;\n\n    if (caseSensitive) return valueA.indexOf(valueB, 0) !== -1;\n\n    return (\n      valueA.toLocaleUpperCase().indexOf(valueB.toLocaleUpperCase(), 0) !== -1\n    );\n  }\n\n  public doesNotContain(\n    valueA: string,\n    valueB: string,\n    caseSensitive: boolean\n  ): boolean {\n    return !this.contains(valueA, valueB, caseSensitive);\n  }\n\n  public isContainedIn(\n    valueA: string,\n    valueB: string,\n    caseSensitive: boolean\n  ): boolean {\n    return this.contains(valueB, valueA, caseSensitive);\n  }\n\n  public isNotContainedIn(\n    valueA: string,\n    valueB: string,\n    caseSensitive: boolean\n  ): boolean {\n    return this.doesNotContain(valueB, valueA, caseSensitive);\n  }\n\n  public isEmpty(valueA: string): boolean {\n    if (!this.checkArgTypes(valueA)) return true;\n    return valueA.length === 0;\n  }\n\n  public isNotEmpty(valueA: string): boolean {\n    return !this.isEmpty(valueA);\n  }\n\n  private checkArgTypes(valueA: string, valueB?: string): boolean {\n    if (typeof valueA !== \"string\") return false;\n    if (valueB && typeof valueB !== \"string\") return false;\n    return true;\n  }\n}\n\n/*\nNOTE: As this is the default type converter, it's registrations are directly in TypeConverterManager file.\n*/\n"]}