@itwin/ecschema-metadata 3.5.0-dev.13 → 3.5.0-dev.16

package/lib/cjs/ECName.js

@@ -1,86 +1,86 @@
-"use strict";
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-/** @packageDocumentation
- * @module Metadata
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ECName = void 0;
-const core_bentley_1 = require("@itwin/core-bentley");
-const Exception_1 = require("./Exception");
-const validECNameRegex = /^([a-zA-Z_]+[a-zA-Z0-9_]*)$/i;
-const ecNameReplacerRegex = /__x([0-9a-fA-F]{4})__/g;
-const leadingDigits = ["0000", "000", "00", "0", ""];
-function isDigit(character) {
-    (0, core_bentley_1.assert)(1 === character.length);
-    return character >= "0" && character <= "9";
-}
-function isValidAlphaNumericCharacter(c) {
-    (0, core_bentley_1.assert)(1 === c.length);
-    return (((c >= "0" && c <= "9") || (c >= "A" && c <= "Z") || (c >= "a" && c <= "z") || c === "_"));
-}
-/** The name of an item in a [[Schema]], encoded to meet restrictions on the characters usable in such names.
- * An ECName meets the following criteria:
- *  - Contains at least one character.
- *  - Does not begin with a digit.
- *  - Consists entirely of characters in the ASCII ranges A-Z, a-z, and 0-9; and the underscore ("_") character.
- *
- * All characters not meeting the above criteria are encoded as "__x####__" where "####" is the UTF-16 character code.
- * Such names are often automatically generated from the item's display label, which is unrestricted in the characters it may contain.
- * @public
- */
-class ECName {
-    /** Construct a new ECName from a valid EC name.
-     * throws ECObjectsError if `name` does not meet the criteria for a valid EC name.
-     */
-    constructor(name) {
-        if (!ECName.validate(name))
-            throw new Exception_1.ECObjectsError(Exception_1.ECObjectsStatus.InvalidECName);
-        this._name = name;
-    }
-    /** Returns true if a string meets the criteria of a valid EC name. */
-    static validate(name) {
-        return validECNameRegex.test(name);
-    }
-    /** The underlying name as a string. */
-    get name() {
-        return this._name;
-    }
-    /** Create an ECName from an arbitrary string, encoding any special characters as "__x####__" where "####" is the UTF-16 character code.
-     * @throws ECObjectsError if `input` is an empty string.
-     */
-    static encode(input) {
-        if (0 === input.length)
-            throw new Exception_1.ECObjectsError(Exception_1.ECObjectsStatus.InvalidECName);
-        if (ECName.validate(input)) {
-            // It's already a valid EC name.
-            return new ECName(input);
-        }
-        let output = "";
-        function appendEncodedCharacter(index) {
-            const hex = input.charCodeAt(index).toString(16).toUpperCase();
-            (0, core_bentley_1.assert)(hex.length > 0 && hex.length < 5);
-            output += `__x${leadingDigits[hex.length]}${hex}__`;
-        }
-        // First character cannot be a digit.
-        const firstCharIsDigit = isDigit(input[0]);
-        if (firstCharIsDigit)
-            appendEncodedCharacter(0);
-        for (let i = firstCharIsDigit ? 1 : 0; i < input.length; i++) {
-            const char = input[i];
-            if (!isValidAlphaNumericCharacter(char))
-                appendEncodedCharacter(i);
-            else
-                output += char;
-        }
-        return new ECName(output);
-    }
-    /** Decode this ECName, replacing encoded special characters with the characters they encode. */
-    decode() {
-        return this.name.replace(ecNameReplacerRegex, (_match, hex) => String.fromCharCode(Number.parseInt(hex, 16)));
-    }
-}
-exports.ECName = ECName;
+"use strict";
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Metadata
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ECName = void 0;
+const core_bentley_1 = require("@itwin/core-bentley");
+const Exception_1 = require("./Exception");
+const validECNameRegex = /^([a-zA-Z_]+[a-zA-Z0-9_]*)$/i;
+const ecNameReplacerRegex = /__x([0-9a-fA-F]{4})__/g;
+const leadingDigits = ["0000", "000", "00", "0", ""];
+function isDigit(character) {
+    (0, core_bentley_1.assert)(1 === character.length);
+    return character >= "0" && character <= "9";
+}
+function isValidAlphaNumericCharacter(c) {
+    (0, core_bentley_1.assert)(1 === c.length);
+    return (((c >= "0" && c <= "9") || (c >= "A" && c <= "Z") || (c >= "a" && c <= "z") || c === "_"));
+}
+/** The name of an item in a [[Schema]], encoded to meet restrictions on the characters usable in such names.
+ * An ECName meets the following criteria:
+ *  - Contains at least one character.
+ *  - Does not begin with a digit.
+ *  - Consists entirely of characters in the ASCII ranges A-Z, a-z, and 0-9; and the underscore ("_") character.
+ *
+ * All characters not meeting the above criteria are encoded as "__x####__" where "####" is the UTF-16 character code.
+ * Such names are often automatically generated from the item's display label, which is unrestricted in the characters it may contain.
+ * @public
+ */
+class ECName {
+    /** Construct a new ECName from a valid EC name.
+     * throws ECObjectsError if `name` does not meet the criteria for a valid EC name.
+     */
+    constructor(name) {
+        if (!ECName.validate(name))
+            throw new Exception_1.ECObjectsError(Exception_1.ECObjectsStatus.InvalidECName);
+        this._name = name;
+    }
+    /** Returns true if a string meets the criteria of a valid EC name. */
+    static validate(name) {
+        return validECNameRegex.test(name);
+    }
+    /** The underlying name as a string. */
+    get name() {
+        return this._name;
+    }
+    /** Create an ECName from an arbitrary string, encoding any special characters as "__x####__" where "####" is the UTF-16 character code.
+     * @throws ECObjectsError if `input` is an empty string.
+     */
+    static encode(input) {
+        if (0 === input.length)
+            throw new Exception_1.ECObjectsError(Exception_1.ECObjectsStatus.InvalidECName);
+        if (ECName.validate(input)) {
+            // It's already a valid EC name.
+            return new ECName(input);
+        }
+        let output = "";
+        function appendEncodedCharacter(index) {
+            const hex = input.charCodeAt(index).toString(16).toUpperCase();
+            (0, core_bentley_1.assert)(hex.length > 0 && hex.length < 5);
+            output += `__x${leadingDigits[hex.length]}${hex}__`;
+        }
+        // First character cannot be a digit.
+        const firstCharIsDigit = isDigit(input[0]);
+        if (firstCharIsDigit)
+            appendEncodedCharacter(0);
+        for (let i = firstCharIsDigit ? 1 : 0; i < input.length; i++) {
+            const char = input[i];
+            if (!isValidAlphaNumericCharacter(char))
+                appendEncodedCharacter(i);
+            else
+                output += char;
+        }
+        return new ECName(output);
+    }
+    /** Decode this ECName, replacing encoded special characters with the characters they encode. */
+    decode() {
+        return this.name.replace(ecNameReplacerRegex, (_match, hex) => String.fromCharCode(Number.parseInt(hex, 16)));
+    }
+}
+exports.ECName = ECName;
 //# sourceMappingURL=ECName.js.map

package/lib/cjs/ECName.js.map

@@ -1 +1 @@
-{"version":3,"file":"ECName.js","sourceRoot":"","sources":["../../src/ECName.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 Metadata\n */\n\nimport { assert } from \"@itwin/core-bentley\";\nimport { ECObjectsError, ECObjectsStatus } from \"./Exception\";\n\nconst validECNameRegex = /^([a-zA-Z_]+[a-zA-Z0-9_]*)$/i;\nconst ecNameReplacerRegex = /__x([0-9a-fA-F]{4})__/g;\nconst leadingDigits = [\"0000\", \"000\", \"00\", \"0\", \"\"];\n\nfunction isDigit(character: string): boolean {\n  assert(1 === character.length);\n  return character >= \"0\" && character <= \"9\";\n}\n\nfunction isValidAlphaNumericCharacter(c: string): boolean {\n  assert(1 === c.length);\n  return (((c >= \"0\" && c <= \"9\") || (c >= \"A\" && c <= \"Z\") || (c >= \"a\" && c <= \"z\") || c === \"_\"));\n}\n\n/** The name of an item in a [[Schema]], encoded to meet restrictions on the characters usable in such names.\n * An ECName meets the following criteria:\n *  - Contains at least one character.\n *  - Does not begin with a digit.\n *  - Consists entirely of characters in the ASCII ranges A-Z, a-z, and 0-9; and the underscore (\"_\") character.\n *\n * All characters not meeting the above criteria are encoded as \"__x####__\" where \"####\" is the UTF-16 character code.\n * Such names are often automatically generated from the item's display label, which is unrestricted in the characters it may contain.\n * @public\n */\nexport class ECName {\n  private _name: string;\n\n  /** Construct a new ECName from a valid EC name.\n   * throws ECObjectsError if `name` does not meet the criteria for a valid EC name.\n   */\n  constructor(name: string) {\n    if (!ECName.validate(name))\n      throw new ECObjectsError(ECObjectsStatus.InvalidECName);\n\n    this._name = name;\n  }\n\n  /** Returns true if a string meets the criteria of a valid EC name. */\n  public static validate(name: string): boolean {\n    return validECNameRegex.test(name);\n  }\n\n  /** The underlying name as a string. */\n  public get name(): string {\n    return this._name;\n  }\n\n  /** Create an ECName from an arbitrary string, encoding any special characters as \"__x####__\" where \"####\" is the UTF-16 character code.\n   * @throws ECObjectsError if `input` is an empty string.\n   */\n  public static encode(input: string): ECName {\n    if (0 === input.length)\n      throw new ECObjectsError(ECObjectsStatus.InvalidECName);\n\n    if (ECName.validate(input)) {\n      // It's already a valid EC name.\n      return new ECName(input);\n    }\n\n    let output = \"\";\n\n    function appendEncodedCharacter(index: number): void {\n      const hex = input.charCodeAt(index).toString(16).toUpperCase();\n      assert(hex.length > 0 && hex.length < 5);\n      output += `__x${leadingDigits[hex.length]}${hex}__`;\n    }\n\n    // First character cannot be a digit.\n    const firstCharIsDigit = isDigit(input[0]);\n    if (firstCharIsDigit)\n      appendEncodedCharacter(0);\n\n    for (let i = firstCharIsDigit ? 1 : 0; i < input.length; i++) {\n      const char = input[i];\n      if (!isValidAlphaNumericCharacter(char))\n        appendEncodedCharacter(i);\n      else\n        output += char;\n    }\n\n    return new ECName(output);\n  }\n\n  /** Decode this ECName, replacing encoded special characters with the characters they encode. */\n  public decode(): string {\n    return this.name.replace(ecNameReplacerRegex, (_match, hex) => String.fromCharCode(Number.parseInt(hex, 16)));\n  }\n}\n"]}
+{"version":3,"file":"ECName.js","sourceRoot":"","sources":["../../src/ECName.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Metadata\r\n */\r\n\r\nimport { assert } from \"@itwin/core-bentley\";\r\nimport { ECObjectsError, ECObjectsStatus } from \"./Exception\";\r\n\r\nconst validECNameRegex = /^([a-zA-Z_]+[a-zA-Z0-9_]*)$/i;\r\nconst ecNameReplacerRegex = /__x([0-9a-fA-F]{4})__/g;\r\nconst leadingDigits = [\"0000\", \"000\", \"00\", \"0\", \"\"];\r\n\r\nfunction isDigit(character: string): boolean {\r\n  assert(1 === character.length);\r\n  return character >= \"0\" && character <= \"9\";\r\n}\r\n\r\nfunction isValidAlphaNumericCharacter(c: string): boolean {\r\n  assert(1 === c.length);\r\n  return (((c >= \"0\" && c <= \"9\") || (c >= \"A\" && c <= \"Z\") || (c >= \"a\" && c <= \"z\") || c === \"_\"));\r\n}\r\n\r\n/** The name of an item in a [[Schema]], encoded to meet restrictions on the characters usable in such names.\r\n * An ECName meets the following criteria:\r\n *  - Contains at least one character.\r\n *  - Does not begin with a digit.\r\n *  - Consists entirely of characters in the ASCII ranges A-Z, a-z, and 0-9; and the underscore (\"_\") character.\r\n *\r\n * All characters not meeting the above criteria are encoded as \"__x####__\" where \"####\" is the UTF-16 character code.\r\n * Such names are often automatically generated from the item's display label, which is unrestricted in the characters it may contain.\r\n * @public\r\n */\r\nexport class ECName {\r\n  private _name: string;\r\n\r\n  /** Construct a new ECName from a valid EC name.\r\n   * throws ECObjectsError if `name` does not meet the criteria for a valid EC name.\r\n   */\r\n  constructor(name: string) {\r\n    if (!ECName.validate(name))\r\n      throw new ECObjectsError(ECObjectsStatus.InvalidECName);\r\n\r\n    this._name = name;\r\n  }\r\n\r\n  /** Returns true if a string meets the criteria of a valid EC name. */\r\n  public static validate(name: string): boolean {\r\n    return validECNameRegex.test(name);\r\n  }\r\n\r\n  /** The underlying name as a string. */\r\n  public get name(): string {\r\n    return this._name;\r\n  }\r\n\r\n  /** Create an ECName from an arbitrary string, encoding any special characters as \"__x####__\" where \"####\" is the UTF-16 character code.\r\n   * @throws ECObjectsError if `input` is an empty string.\r\n   */\r\n  public static encode(input: string): ECName {\r\n    if (0 === input.length)\r\n      throw new ECObjectsError(ECObjectsStatus.InvalidECName);\r\n\r\n    if (ECName.validate(input)) {\r\n      // It's already a valid EC name.\r\n      return new ECName(input);\r\n    }\r\n\r\n    let output = \"\";\r\n\r\n    function appendEncodedCharacter(index: number): void {\r\n      const hex = input.charCodeAt(index).toString(16).toUpperCase();\r\n      assert(hex.length > 0 && hex.length < 5);\r\n      output += `__x${leadingDigits[hex.length]}${hex}__`;\r\n    }\r\n\r\n    // First character cannot be a digit.\r\n    const firstCharIsDigit = isDigit(input[0]);\r\n    if (firstCharIsDigit)\r\n      appendEncodedCharacter(0);\r\n\r\n    for (let i = firstCharIsDigit ? 1 : 0; i < input.length; i++) {\r\n      const char = input[i];\r\n      if (!isValidAlphaNumericCharacter(char))\r\n        appendEncodedCharacter(i);\r\n      else\r\n        output += char;\r\n    }\r\n\r\n    return new ECName(output);\r\n  }\r\n\r\n  /** Decode this ECName, replacing encoded special characters with the characters they encode. */\r\n  public decode(): string {\r\n    return this.name.replace(ecNameReplacerRegex, (_match, hex) => String.fromCharCode(Number.parseInt(hex, 16)));\r\n  }\r\n}\r\n"]}

package/lib/cjs/ECObjects.d.ts

@@ -1,163 +1,163 @@
-/** @packageDocumentation
- * @module Metadata
- */
-export { PropertyType } from "./PropertyTypes";
-/** @beta */
-export declare enum ECClassModifier {
-    None = 0,
-    Abstract = 1,
-    Sealed = 2
-}
-/** @beta */
-export declare enum SchemaItemType {
-    EntityClass = 0,
-    Mixin = 1,
-    StructClass = 2,
-    CustomAttributeClass = 3,
-    RelationshipClass = 4,
-    Enumeration = 5,
-    KindOfQuantity = 6,
-    PropertyCategory = 7,
-    Unit = 8,
-    InvertedUnit = 9,
-    Constant = 10,
-    Phenomenon = 11,
-    UnitSystem = 12,
-    Format = 13
-}
-/**
- * Primitive data types for ECProperties.
- * @beta
- */
-export declare enum PrimitiveType {
-    Uninitialized = 0,
-    Binary = 257,
-    Boolean = 513,
-    DateTime = 769,
-    Double = 1025,
-    Integer = 1281,
-    Long = 1537,
-    Point2d = 1793,
-    Point3d = 2049,
-    String = 2305,
-    IGeometry = 2561
-}
-/**
- * Defines the valid CustomAttribute container types.
- * @beta
- */
-export declare enum CustomAttributeContainerType {
-    Schema = 1,
-    EntityClass = 2,
-    CustomAttributeClass = 4,
-    StructClass = 8,
-    RelationshipClass = 16,
-    AnyClass = 30,
-    PrimitiveProperty = 32,
-    StructProperty = 64,
-    PrimitiveArrayProperty = 128,
-    StructArrayProperty = 256,
-    NavigationProperty = 512,
-    AnyProperty = 992,
-    SourceRelationshipConstraint = 1024,
-    TargetRelationshipConstraint = 2048,
-    AnyRelationshipConstraint = 3072,
-    Any = 4095
-}
-/**
- * Defines what sort of match should be used when locating a schema.
- * @beta
- */
-export declare enum SchemaMatchType {
-    Identical = 0,
-    Exact = 1,
-    LatestWriteCompatible = 2,
-    Latest = 3,
-    LatestReadCompatible = 4
-}
-/**
- * Identifer for an ECRelationshipConstraint. Used to determine the side of the relationship the constraint is representing.
- * @beta
- */
-export declare enum RelationshipEnd {
-    Source = 0,
-    Target = 1
-}
-/** @beta */
-export declare enum StrengthType {
-    Referencing = 0,
-    Holding = 1,
-    Embedding = 2
-}
-/** @beta */
-export declare enum StrengthDirection {
-    Forward = 1,
-    Backward = 2
-}
-/**
- * Parses the provided string into an ECClassModifier if the string is a valid modifier.
- * @param modifier The modifier string to parse.
- * @beta
- */
-export declare function parseClassModifier(modifier: string): ECClassModifier | undefined;
-/**
- * @return A string representing the provided ECClassModifier. If the modifier is not valid, an empty string is returned.
- * @beta
- */
-export declare function classModifierToString(modifier: ECClassModifier): string;
-/**
- * Tries to parse the given string as one of the 8 schema item types.
- * @param type The schema item type string to parse.
- * @returns A valid SchemaItemType if successfully parsed. Otherwise, undefined if the provided string is not a valid SchemaItemType.
- * @beta
- */
-export declare function parseSchemaItemType(type: string): SchemaItemType | undefined;
-/**
- * Converts a valid SchemaItemType to a display string.
- * @param value The SchemaItemType to stringify.
- * @return A string representing the provided SchemaItemType. If the type is not valid, an empty string is returned.
- * @beta
- */
-export declare function schemaItemTypeToString(value: SchemaItemType): string;
-/** @internal */
-export declare function schemaItemTypeToXmlString(value: SchemaItemType): string;
-/**
- * Tries to parse the given string as one of the 10 primitive types.
- * @param type The primitive type string to parse.
- * @returns A valid PrimitiveType if successfully parsed, or undefined if the provided string is not a valid PrimitiveType.
- * @beta
- */
-export declare function parsePrimitiveType(type: string): PrimitiveType | undefined;
-/** @beta */
-export declare function primitiveTypeToString(type: PrimitiveType): string;
-/**
- * Parses the given string into the appropriate CustomAttributeContainerType if the string is valid.
- * @param type The container type string to parse.
- * @beta
- */
-export declare function parseCustomAttributeContainerType(type: string): CustomAttributeContainerType | undefined;
-/**
- * Creates a string representing a valid CustomAttributeContainerType.
- * @param value The CustomAttributeContainerType to stringify.
- * @return A string representing the provided CustomAttributeContainerType. If the type is not valid, an empty string is returned.
- * @beta
- */
-export declare function containerTypeToString(type: CustomAttributeContainerType): string;
-/** @beta */
-export declare function parseRelationshipEnd(end: string): RelationshipEnd | undefined;
-/** @beta */
-export declare function relationshipEndToString(end: RelationshipEnd): string;
-/**
- * Takes a string representing a StrengthType, will parse it and return the corresponding StrengthType.
- * @throws ECObjectsStatus.InvalidStrength if the provided string that is not valid
- * @param strength
- * @beta
- */
-export declare function parseStrength(strength: string): StrengthType | undefined;
-/** @beta */
-export declare function strengthToString(strength: StrengthType): string;
-/** @beta */
-export declare function parseStrengthDirection(direction: string): StrengthDirection | undefined;
-/** @beta */
-export declare function strengthDirectionToString(direction: StrengthDirection): string;
+/** @packageDocumentation
+ * @module Metadata
+ */
+export { PropertyType } from "./PropertyTypes";
+/** @beta */
+export declare enum ECClassModifier {
+    None = 0,
+    Abstract = 1,
+    Sealed = 2
+}
+/** @beta */
+export declare enum SchemaItemType {
+    EntityClass = 0,
+    Mixin = 1,
+    StructClass = 2,
+    CustomAttributeClass = 3,
+    RelationshipClass = 4,
+    Enumeration = 5,
+    KindOfQuantity = 6,
+    PropertyCategory = 7,
+    Unit = 8,
+    InvertedUnit = 9,
+    Constant = 10,
+    Phenomenon = 11,
+    UnitSystem = 12,
+    Format = 13
+}
+/**
+ * Primitive data types for ECProperties.
+ * @beta
+ */
+export declare enum PrimitiveType {
+    Uninitialized = 0,
+    Binary = 257,
+    Boolean = 513,
+    DateTime = 769,
+    Double = 1025,
+    Integer = 1281,
+    Long = 1537,
+    Point2d = 1793,
+    Point3d = 2049,
+    String = 2305,
+    IGeometry = 2561
+}
+/**
+ * Defines the valid CustomAttribute container types.
+ * @beta
+ */
+export declare enum CustomAttributeContainerType {
+    Schema = 1,
+    EntityClass = 2,
+    CustomAttributeClass = 4,
+    StructClass = 8,
+    RelationshipClass = 16,
+    AnyClass = 30,
+    PrimitiveProperty = 32,
+    StructProperty = 64,
+    PrimitiveArrayProperty = 128,
+    StructArrayProperty = 256,
+    NavigationProperty = 512,
+    AnyProperty = 992,
+    SourceRelationshipConstraint = 1024,
+    TargetRelationshipConstraint = 2048,
+    AnyRelationshipConstraint = 3072,
+    Any = 4095
+}
+/**
+ * Defines what sort of match should be used when locating a schema.
+ * @beta
+ */
+export declare enum SchemaMatchType {
+    Identical = 0,
+    Exact = 1,
+    LatestWriteCompatible = 2,
+    Latest = 3,
+    LatestReadCompatible = 4
+}
+/**
+ * Identifer for an ECRelationshipConstraint. Used to determine the side of the relationship the constraint is representing.
+ * @beta
+ */
+export declare enum RelationshipEnd {
+    Source = 0,
+    Target = 1
+}
+/** @beta */
+export declare enum StrengthType {
+    Referencing = 0,
+    Holding = 1,
+    Embedding = 2
+}
+/** @beta */
+export declare enum StrengthDirection {
+    Forward = 1,
+    Backward = 2
+}
+/**
+ * Parses the provided string into an ECClassModifier if the string is a valid modifier.
+ * @param modifier The modifier string to parse.
+ * @beta
+ */
+export declare function parseClassModifier(modifier: string): ECClassModifier | undefined;
+/**
+ * @return A string representing the provided ECClassModifier. If the modifier is not valid, an empty string is returned.
+ * @beta
+ */
+export declare function classModifierToString(modifier: ECClassModifier): string;
+/**
+ * Tries to parse the given string as one of the 8 schema item types.
+ * @param type The schema item type string to parse.
+ * @returns A valid SchemaItemType if successfully parsed. Otherwise, undefined if the provided string is not a valid SchemaItemType.
+ * @beta
+ */
+export declare function parseSchemaItemType(type: string): SchemaItemType | undefined;
+/**
+ * Converts a valid SchemaItemType to a display string.
+ * @param value The SchemaItemType to stringify.
+ * @return A string representing the provided SchemaItemType. If the type is not valid, an empty string is returned.
+ * @beta
+ */
+export declare function schemaItemTypeToString(value: SchemaItemType): string;
+/** @internal */
+export declare function schemaItemTypeToXmlString(value: SchemaItemType): string;
+/**
+ * Tries to parse the given string as one of the 10 primitive types.
+ * @param type The primitive type string to parse.
+ * @returns A valid PrimitiveType if successfully parsed, or undefined if the provided string is not a valid PrimitiveType.
+ * @beta
+ */
+export declare function parsePrimitiveType(type: string): PrimitiveType | undefined;
+/** @beta */
+export declare function primitiveTypeToString(type: PrimitiveType): string;
+/**
+ * Parses the given string into the appropriate CustomAttributeContainerType if the string is valid.
+ * @param type The container type string to parse.
+ * @beta
+ */
+export declare function parseCustomAttributeContainerType(type: string): CustomAttributeContainerType | undefined;
+/**
+ * Creates a string representing a valid CustomAttributeContainerType.
+ * @param value The CustomAttributeContainerType to stringify.
+ * @return A string representing the provided CustomAttributeContainerType. If the type is not valid, an empty string is returned.
+ * @beta
+ */
+export declare function containerTypeToString(type: CustomAttributeContainerType): string;
+/** @beta */
+export declare function parseRelationshipEnd(end: string): RelationshipEnd | undefined;
+/** @beta */
+export declare function relationshipEndToString(end: RelationshipEnd): string;
+/**
+ * Takes a string representing a StrengthType, will parse it and return the corresponding StrengthType.
+ * @throws ECObjectsStatus.InvalidStrength if the provided string that is not valid
+ * @param strength
+ * @beta
+ */
+export declare function parseStrength(strength: string): StrengthType | undefined;
+/** @beta */
+export declare function strengthToString(strength: StrengthType): string;
+/** @beta */
+export declare function parseStrengthDirection(direction: string): StrengthDirection | undefined;
+/** @beta */
+export declare function strengthDirectionToString(direction: StrengthDirection): string;
 //# sourceMappingURL=ECObjects.d.ts.map