@itwin/ecschema-metadata 5.0.0-dev.98 → 5.1.0-dev.0

package/lib/esm/Metadata/Enumeration.js

@@ -7,15 +7,16 @@
  */
 import { SchemaReadHelper } from "../Deserialization/Helper";
 import { PrimitiveType, primitiveTypeToString, SchemaItemType } from "../ECObjects";
-import { ECObjectsError, ECObjectsStatus } from "../Exception";
+import { ECSchemaError, ECSchemaStatus } from "../Exception";
 import { ECName } from "../ECName";
 import { SchemaItem } from "./SchemaItem";
 /**
  * A Typescript class representation of an ECEnumeration.
- * @beta
+ * @public @preview
  */
 export class Enumeration extends SchemaItem {
     schemaItemType = Enumeration.schemaItemType;
+    /** @internal */
     static get schemaItemType() { return SchemaItemType.Enumeration; }
     _type;
     _isStrict;
@@ -23,6 +24,7 @@ export class Enumeration extends SchemaItem {
     get enumerators() { return this._enumerators; }
     get type() { return this._type; }
     get isStrict() { return this._isStrict; }
+    /** @internal */
     constructor(schema, name, primitiveType) {
         super(schema, name);
         this._type = primitiveType;
@@ -50,9 +52,9 @@ export class Enumeration extends SchemaItem {
     findDuplicateEnumerators(name, value) {
         this._enumerators.forEach((element) => {
             if (element.name.toLowerCase() === name.toLowerCase())
-                throw new ECObjectsError(ECObjectsStatus.InvalidECJson, `The Enumeration ${this.name} has a duplicate Enumerator with name '${name}'.`);
+                throw new ECSchemaError(ECSchemaStatus.InvalidECJson, `The Enumeration ${this.name} has a duplicate Enumerator with name '${name}'.`);
             if (element.value === value)
-                throw new ECObjectsError(ECObjectsStatus.InvalidECJson, `The Enumeration ${this.name} has a duplicate Enumerator with value '${value}'.`);
+                throw new ECSchemaError(ECSchemaStatus.InvalidECJson, `The Enumeration ${this.name} has a duplicate Enumerator with value '${value}'.`);
         });
     }
     /**
@@ -62,23 +64,25 @@ export class Enumeration extends SchemaItem {
      * @param label A localized display label that is used instead of the name in a GUI.
      * @param description A localized description for the enumerator.
      * @return AnyEnumerator object
+     * @internal
      */
     createEnumerator(name, value, label, description) {
         if (this.isInt && typeof (value) === "string") // throws if backing type is int and value is string
-            throw new ECObjectsError(ECObjectsStatus.InvalidECJson, `The Enumeration ${this.name} has a backing type 'integer' and an enumerator with value of type 'string'.`);
+            throw new ECSchemaError(ECSchemaStatus.InvalidECJson, `The Enumeration ${this.name} has a backing type 'integer' and an enumerator with value of type 'string'.`);
         if (!this.isInt && typeof (value) === "number") // also throws if backing type is string and value is number
-            throw new ECObjectsError(ECObjectsStatus.InvalidECJson, `The Enumeration ${this.name} has a backing type 'string' and an enumerator with value of type 'integer'.`);
+            throw new ECSchemaError(ECSchemaStatus.InvalidECJson, `The Enumeration ${this.name} has a backing type 'string' and an enumerator with value of type 'integer'.`);
         this.findDuplicateEnumerators(name, value); // check for duplicates; throw if there are any
         if (!ECName.validate(name))
-            throw new ECObjectsError(ECObjectsStatus.InvalidECName, `The Enumeration ${this.name} has an enumerator with an invalid 'name' attribute. ${name} is not a valid ECName.`);
+            throw new ECSchemaError(ECSchemaStatus.InvalidECName, `The Enumeration ${this.name} has an enumerator with an invalid 'name' attribute. ${name} is not a valid ECName.`);
         return { name, value, label, description };
     }
     /**
      * Adds enumerator to list of enumerators on this Enumeration
      * @param enumerator The enumerator to add
+     * @internal
      */
     addEnumerator(enumerator) {
-        this.enumerators.push(enumerator);
+        this._enumerators.push(enumerator);
     }
     /**
      * Save this Enumeration's properties to an object for serializing to JSON.
@@ -131,19 +135,19 @@ export class Enumeration extends SchemaItem {
                 if (SchemaReadHelper.isECSpecVersionNewer({ readVersion: enumerationProps.originalECSpecMajorVersion, writeVersion: enumerationProps.originalECSpecMinorVersion }))
                     this._type = PrimitiveType.String;
                 else
-                    throw new ECObjectsError(ECObjectsStatus.InvalidECJson, `The Enumeration ${this.name} has an invalid 'type' attribute. It should be either "int" or "string".`);
+                    throw new ECSchemaError(ECSchemaStatus.InvalidECJson, `The Enumeration ${this.name} has an invalid 'type' attribute. It should be either "int" or "string".`);
             }
         }
         else {
             const primitiveTypePattern = (this.isInt) ? /int/i : /string/i;
             if (!primitiveTypePattern.test(enumerationProps.type))
-                throw new ECObjectsError(ECObjectsStatus.InvalidECJson, `The Enumeration ${this.name} has an incompatible type. It must be "${(this.isInt) ? "int" : "string"}", not "${(this.isInt) ? "string" : "int"}".`);
+                throw new ECSchemaError(ECSchemaStatus.InvalidECJson, `The Enumeration ${this.name} has an incompatible type. It must be "${(this.isInt) ? "int" : "string"}", not "${(this.isInt) ? "string" : "int"}".`);
         }
         this._isStrict = enumerationProps.isStrict;
         if (undefined !== enumerationProps.enumerators) {
             enumerationProps.enumerators.forEach((enumerator) => {
                 // Creates a new enumerator (with the specified name, value, label and description- label and description are optional) and adds to the list of enumerators.
-                // Throws ECObjectsError if there are duplicate names or values present in the enumeration
+                // Throws ECSchemaError if there are duplicate names or values present in the enumeration
                 this.addEnumerator(this.createEnumerator(enumerator.name, enumerator.value, enumerator.label, enumerator.description));
             });
         }
@@ -152,7 +156,7 @@ export class Enumeration extends SchemaItem {
         this.fromJSONSync(enumerationProps);
     }
     /**
-     * @alpha Used in schema editing.
+     * @internal
      */
     setIsStrict(isStrict) {
         this._isStrict = isStrict;
@@ -169,14 +173,17 @@ export class Enumeration extends SchemaItem {
      * Type assertion to check if the SchemaItem is of type Enumeration.
      * @param item The SchemaItem to check.
      * @returns The item cast to Enumeration if it is an Enumeration, undefined otherwise.
+     * @internal
      */
     static assertIsEnumeration(item) {
         if (!this.isEnumeration(item))
-            throw new ECObjectsError(ECObjectsStatus.InvalidSchemaItemType, `Expected '${SchemaItemType.Enumeration}' (Enumeration)`);
+            throw new ECSchemaError(ECSchemaStatus.InvalidSchemaItemType, `Expected '${SchemaItemType.Enumeration}' (Enumeration)`);
     }
 }
-/** @internal
+/**
  * An abstract class used for schema editing.
+ *
+ * @internal
  */
 export class MutableEnumeration extends Enumeration {
 }

package/lib/esm/Metadata/Enumeration.js.map

@@ -1 +1 @@
-{"version":3,"file":"Enumeration.js","sourceRoot":"","sources":["../../../src/Metadata/Enumeration.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 { ECSpecVersion, SchemaReadHelper } from \"../Deserialization/Helper\";\nimport { EnumerationProps, EnumeratorProps } from \"../Deserialization/JsonProps\";\nimport { PrimitiveType, primitiveTypeToString, SchemaItemType } from \"../ECObjects\";\nimport { ECObjectsError, ECObjectsStatus } from \"../Exception\";\nimport { ECName } from \"../ECName\";\nimport { Schema } from \"./Schema\";\nimport { SchemaItem } from \"./SchemaItem\";\n\n/** @beta */\nexport interface Enumerator<T> {\n  readonly name: string;\n  readonly value: T;\n  readonly label?: string;\n  readonly description?: string;\n}\n\n/** @beta */\nexport type AnyEnumerator = Enumerator<string | number>;\n\n/**\n * A Typescript class representation of an ECEnumeration.\n * @beta\n */\nexport class Enumeration extends SchemaItem {\n  public override readonly schemaItemType = Enumeration.schemaItemType;\n  public static override get schemaItemType() { return SchemaItemType.Enumeration; }\n  protected _type?: PrimitiveType.Integer | PrimitiveType.String;\n  protected _isStrict: boolean;\n  protected _enumerators: AnyEnumerator[];\n\n  public get enumerators() { return this._enumerators; }\n  public get type() { return this._type; }\n  public get isStrict() { return this._isStrict; }\n\n  constructor(schema: Schema, name: string, primitiveType?: PrimitiveType.Integer | PrimitiveType.String) {\n    super(schema, name);\n    this._type = primitiveType;\n    this._isStrict = true;\n    this._enumerators = [];\n  }\n\n  public get isInt(): boolean { return this._type === PrimitiveType.Integer; }\n  public get isString(): boolean { return this._type === PrimitiveType.String; }\n\n  /**\n   * Gets an enumerator that matches the name provided.\n   * @param name The ECName of the Enumerator to find.\n   */\n  public getEnumeratorByName(name: string): AnyEnumerator | undefined {\n    return this.enumerators.find((item) => item.name.toLowerCase() === name.toLowerCase());\n  }\n\n  /**\n   * Gets an enumerator that matches the value provided.\n   * @param value The value of the Enumerator to find.\n   */\n  public getEnumerator(value: string): Enumerator<string> | undefined;\n  public getEnumerator(value: number): Enumerator<number> | undefined;\n  public getEnumerator(value: string | number): AnyEnumerator | undefined {\n    return this.enumerators.find((item) => item.value === value);\n  }\n\n  /**\n   * Checks whether there already exists an enumerator with this name or this value\n   * @param name The name of the enumerator we are trying to create\n   * @param value The value of the enumerator we are trying to create\n   * @internal\n   */\n  private findDuplicateEnumerators(name: string, value: string | number) {\n    this._enumerators.forEach((element: AnyEnumerator) => { // Name and value must be unique within the ECEnumerations\n      if (element.name.toLowerCase() === name.toLowerCase())\n        throw new ECObjectsError(ECObjectsStatus.InvalidECJson, `The Enumeration ${this.name} has a duplicate Enumerator with name '${name}'.`);\n      if (element.value === value)\n        throw new ECObjectsError(ECObjectsStatus.InvalidECJson, `The Enumeration ${this.name} has a duplicate Enumerator with value '${value}'.`);\n    });\n  }\n\n  /**\n   * Creates an Enumerator with the provided name and value as well as optional parameters label and description\n   * @param name The name of the enumerator\n   * @param value The value of the enumerator. The type of this value is dependent on the backing type of the this Enumeration.\n   * @param label A localized display label that is used instead of the name in a GUI.\n   * @param description A localized description for the enumerator.\n   * @return AnyEnumerator object\n   */\n  public createEnumerator(name: string, value: string | number, label?: string, description?: string): AnyEnumerator {\n    if (this.isInt && typeof (value) === \"string\") // throws if backing type is int and value is string\n      throw new ECObjectsError(ECObjectsStatus.InvalidECJson, `The Enumeration ${this.name} has a backing type 'integer' and an enumerator with value of type 'string'.`);\n    if (!this.isInt && typeof (value) === \"number\") // also throws if backing type is string and value is number\n      throw new ECObjectsError(ECObjectsStatus.InvalidECJson, `The Enumeration ${this.name} has a backing type 'string' and an enumerator with value of type 'integer'.`);\n    this.findDuplicateEnumerators(name, value); // check for duplicates; throw if there are any\n    if (!ECName.validate(name))\n      throw new ECObjectsError(ECObjectsStatus.InvalidECName, `The Enumeration ${this.name} has an enumerator with an invalid 'name' attribute. ${name} is not a valid ECName.`);\n    return { name, value, label, description };\n  }\n\n  /**\n   * Adds enumerator to list of enumerators on this Enumeration\n   * @param enumerator The enumerator to add\n   */\n  protected addEnumerator(enumerator: AnyEnumerator) {\n    this.enumerators.push(enumerator);\n  }\n\n  /**\n   * Save this Enumeration's properties to an object for serializing to JSON.\n   * @param standalone Serialization includes only this object (as opposed to the full schema).\n   * @param includeSchemaVersion Include the Schema's version information in the serialized object.\n   */\n  public override toJSON(standalone: boolean = false, includeSchemaVersion: boolean = false): EnumerationProps {\n    const schemaJson = super.toJSON(standalone, includeSchemaVersion) as any;\n    schemaJson.type = (this.isInt) ? \"int\" : \"string\";\n    schemaJson.isStrict = this.isStrict;\n    schemaJson.enumerators = this._enumerators.map(({ name, label, value, description }) => {\n      const enumJson: any = { name, value };\n      if (undefined !== label)\n        enumJson.label = label;\n      if (undefined !== description)\n        enumJson.description = description;\n      return enumJson;\n    });\n    return schemaJson;\n  }\n\n  /** @internal */\n  public override async toXml(schemaXml: Document): Promise<Element> {\n    const itemElement = await super.toXml(schemaXml);\n    if (undefined !== this.type)\n      itemElement.setAttribute(\"backingTypeName\", primitiveTypeToString(this.type));\n    itemElement.setAttribute(\"isStrict\", String(this.isStrict));\n\n    for (const enumerator of this.enumerators) {\n      const enumElement = schemaXml.createElement(\"ECEnumerator\");\n      enumElement.setAttribute(\"name\", enumerator.name);\n      const enumValue = typeof enumerator.value === \"string\" ? enumerator.value : enumerator.value.toString();\n      enumElement.setAttribute(\"value\", enumValue);\n      if (undefined !== enumerator.label)\n        enumElement.setAttribute(\"displayLabel\", enumerator.label);\n      if (undefined !== enumerator.description)\n        enumElement.setAttribute(\"description\", enumerator.description);\n      itemElement.appendChild(enumElement);\n    }\n\n    return itemElement;\n  }\n\n  public override fromJSONSync(enumerationProps: EnumerationProps) {\n    super.fromJSONSync(enumerationProps);\n    if (undefined === this._type) {\n      if (/int/i.test(enumerationProps.type)) {\n        this._type = PrimitiveType.Integer;\n      } else if (/string/i.test(enumerationProps.type)) {\n        this._type = PrimitiveType.String;\n      } else {\n        if (SchemaReadHelper.isECSpecVersionNewer({readVersion: enumerationProps.originalECSpecMajorVersion, writeVersion: enumerationProps.originalECSpecMinorVersion} as ECSpecVersion))\n          this._type = PrimitiveType.String;\n        else\n          throw new ECObjectsError(ECObjectsStatus.InvalidECJson, `The Enumeration ${this.name} has an invalid 'type' attribute. It should be either \"int\" or \"string\".`);\n      }\n    } else {\n      const primitiveTypePattern = (this.isInt) ? /int/i : /string/i;\n      if (!primitiveTypePattern.test(enumerationProps.type))\n        throw new ECObjectsError(ECObjectsStatus.InvalidECJson, `The Enumeration ${this.name} has an incompatible type. It must be \"${(this.isInt) ? \"int\" : \"string\"}\", not \"${(this.isInt) ? \"string\" : \"int\"}\".`);\n    }\n    this._isStrict = enumerationProps.isStrict;\n\n    if (undefined !== enumerationProps.enumerators) {\n      enumerationProps.enumerators.forEach((enumerator: EnumeratorProps) => {\n        // Creates a new enumerator (with the specified name, value, label and description- label and description are optional) and adds to the list of enumerators.\n        // Throws ECObjectsError if there are duplicate names or values present in the enumeration\n        this.addEnumerator(this.createEnumerator(enumerator.name, enumerator.value, enumerator.label, enumerator.description));\n      });\n    }\n  }\n\n  public override async fromJSON(enumerationProps: EnumerationProps) {\n    this.fromJSONSync(enumerationProps);\n  }\n\n  /**\n   * @alpha Used in schema editing.\n   */\n  protected setIsStrict(isStrict: boolean) {\n    this._isStrict = isStrict;\n  }\n\n  /**\n   * Type guard to check if the SchemaItem is of type Enumeration.\n   * @param item The SchemaItem to check.\n   * @returns True if the item is an Enumeration, false otherwise.\n   */\n  public static isEnumeration(item?: SchemaItem): item is Enumeration {\n    return item?.schemaItemType === SchemaItemType.Enumeration;\n  }\n\n  /**\n   * Type assertion to check if the SchemaItem is of type Enumeration.\n   * @param item The SchemaItem to check.\n   * @returns The item cast to Enumeration if it is an Enumeration, undefined otherwise.\n   */\n  public static assertIsEnumeration(item?: SchemaItem): asserts item is Enumeration {\n    if (!this.isEnumeration(item))\n      throw new ECObjectsError(ECObjectsStatus.InvalidSchemaItemType, `Expected '${SchemaItemType.Enumeration}' (Enumeration)`);\n  }\n}\n\n/** @internal\n * An abstract class used for schema editing.\n */\nexport abstract class MutableEnumeration extends Enumeration {\n  public abstract override addEnumerator(enumerator: AnyEnumerator): void;\n  public abstract override setIsStrict(isStrict: boolean): void;\n  public abstract override setDisplayLabel(displayLabel: string): void;\n}\n"]}
+{"version":3,"file":"Enumeration.js","sourceRoot":"","sources":["../../../src/Metadata/Enumeration.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 { ECSpecVersion, SchemaReadHelper } from \"../Deserialization/Helper\";\r\nimport { EnumerationProps, EnumeratorProps } from \"../Deserialization/JsonProps\";\r\nimport { PrimitiveType, primitiveTypeToString, SchemaItemType } from \"../ECObjects\";\r\nimport { ECSchemaError, ECSchemaStatus } from \"../Exception\";\r\nimport { ECName } from \"../ECName\";\r\nimport { Schema } from \"./Schema\";\r\nimport { SchemaItem } from \"./SchemaItem\";\r\n\r\n/** @public @preview */\r\nexport interface Enumerator<T> {\r\n  readonly name: string;\r\n  readonly value: T;\r\n  readonly label?: string;\r\n  readonly description?: string;\r\n}\r\n\r\n/** @public @preview */\r\nexport type AnyEnumerator = Enumerator<string | number>;\r\n\r\n/**\r\n * A Typescript class representation of an ECEnumeration.\r\n * @public @preview\r\n */\r\nexport class Enumeration extends SchemaItem {\r\n  public override readonly schemaItemType = Enumeration.schemaItemType;\r\n  /** @internal */\r\n  public static override get schemaItemType() { return SchemaItemType.Enumeration; }\r\n  private _type?: PrimitiveType.Integer | PrimitiveType.String;\r\n  private _isStrict: boolean;\r\n  private _enumerators: AnyEnumerator[];\r\n\r\n  public get enumerators(): ReadonlyArray<AnyEnumerator> { return this._enumerators; }\r\n  public get type() { return this._type; }\r\n  public get isStrict() { return this._isStrict; }\r\n\r\n  /** @internal */\r\n  constructor(schema: Schema, name: string, primitiveType?: PrimitiveType.Integer | PrimitiveType.String) {\r\n    super(schema, name);\r\n    this._type = primitiveType;\r\n    this._isStrict = true;\r\n    this._enumerators = [];\r\n  }\r\n\r\n  public get isInt(): boolean { return this._type === PrimitiveType.Integer; }\r\n  public get isString(): boolean { return this._type === PrimitiveType.String; }\r\n\r\n  /**\r\n   * Gets an enumerator that matches the name provided.\r\n   * @param name The ECName of the Enumerator to find.\r\n   */\r\n  public getEnumeratorByName(name: string): AnyEnumerator | undefined {\r\n    return this.enumerators.find((item) => item.name.toLowerCase() === name.toLowerCase());\r\n  }\r\n\r\n  /**\r\n   * Gets an enumerator that matches the value provided.\r\n   * @param value The value of the Enumerator to find.\r\n   */\r\n  public getEnumerator(value: string): Enumerator<string> | undefined;\r\n  public getEnumerator(value: number): Enumerator<number> | undefined;\r\n  public getEnumerator(value: string | number): AnyEnumerator | undefined {\r\n    return this.enumerators.find((item) => item.value === value);\r\n  }\r\n\r\n  /**\r\n   * Checks whether there already exists an enumerator with this name or this value\r\n   * @param name The name of the enumerator we are trying to create\r\n   * @param value The value of the enumerator we are trying to create\r\n   * @internal\r\n   */\r\n  private findDuplicateEnumerators(name: string, value: string | number) {\r\n    this._enumerators.forEach((element: AnyEnumerator) => { // Name and value must be unique within the ECEnumerations\r\n      if (element.name.toLowerCase() === name.toLowerCase())\r\n        throw new ECSchemaError(ECSchemaStatus.InvalidECJson, `The Enumeration ${this.name} has a duplicate Enumerator with name '${name}'.`);\r\n      if (element.value === value)\r\n        throw new ECSchemaError(ECSchemaStatus.InvalidECJson, `The Enumeration ${this.name} has a duplicate Enumerator with value '${value}'.`);\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Creates an Enumerator with the provided name and value as well as optional parameters label and description\r\n   * @param name The name of the enumerator\r\n   * @param value The value of the enumerator. The type of this value is dependent on the backing type of the this Enumeration.\r\n   * @param label A localized display label that is used instead of the name in a GUI.\r\n   * @param description A localized description for the enumerator.\r\n   * @return AnyEnumerator object\r\n   * @internal\r\n   */\r\n  public createEnumerator(name: string, value: string | number, label?: string, description?: string): AnyEnumerator {\r\n    if (this.isInt && typeof (value) === \"string\") // throws if backing type is int and value is string\r\n      throw new ECSchemaError(ECSchemaStatus.InvalidECJson, `The Enumeration ${this.name} has a backing type 'integer' and an enumerator with value of type 'string'.`);\r\n    if (!this.isInt && typeof (value) === \"number\") // also throws if backing type is string and value is number\r\n      throw new ECSchemaError(ECSchemaStatus.InvalidECJson, `The Enumeration ${this.name} has a backing type 'string' and an enumerator with value of type 'integer'.`);\r\n    this.findDuplicateEnumerators(name, value); // check for duplicates; throw if there are any\r\n    if (!ECName.validate(name))\r\n      throw new ECSchemaError(ECSchemaStatus.InvalidECName, `The Enumeration ${this.name} has an enumerator with an invalid 'name' attribute. ${name} is not a valid ECName.`);\r\n    return { name, value, label, description };\r\n  }\r\n\r\n  /**\r\n   * Adds enumerator to list of enumerators on this Enumeration\r\n   * @param enumerator The enumerator to add\r\n   * @internal\r\n   */\r\n  protected addEnumerator(enumerator: AnyEnumerator) {\r\n    this._enumerators.push(enumerator);\r\n  }\r\n\r\n  /**\r\n   * Save this Enumeration's properties to an object for serializing to JSON.\r\n   * @param standalone Serialization includes only this object (as opposed to the full schema).\r\n   * @param includeSchemaVersion Include the Schema's version information in the serialized object.\r\n   */\r\n  public override toJSON(standalone: boolean = false, includeSchemaVersion: boolean = false): EnumerationProps {\r\n    const schemaJson = super.toJSON(standalone, includeSchemaVersion) as any;\r\n    schemaJson.type = (this.isInt) ? \"int\" : \"string\";\r\n    schemaJson.isStrict = this.isStrict;\r\n    schemaJson.enumerators = this._enumerators.map(({ name, label, value, description }) => {\r\n      const enumJson: any = { name, value };\r\n      if (undefined !== label)\r\n        enumJson.label = label;\r\n      if (undefined !== description)\r\n        enumJson.description = description;\r\n      return enumJson;\r\n    });\r\n    return schemaJson;\r\n  }\r\n\r\n  /** @internal */\r\n  public override async toXml(schemaXml: Document): Promise<Element> {\r\n    const itemElement = await super.toXml(schemaXml);\r\n    if (undefined !== this.type)\r\n      itemElement.setAttribute(\"backingTypeName\", primitiveTypeToString(this.type));\r\n    itemElement.setAttribute(\"isStrict\", String(this.isStrict));\r\n\r\n    for (const enumerator of this.enumerators) {\r\n      const enumElement = schemaXml.createElement(\"ECEnumerator\");\r\n      enumElement.setAttribute(\"name\", enumerator.name);\r\n      const enumValue = typeof enumerator.value === \"string\" ? enumerator.value : enumerator.value.toString();\r\n      enumElement.setAttribute(\"value\", enumValue);\r\n      if (undefined !== enumerator.label)\r\n        enumElement.setAttribute(\"displayLabel\", enumerator.label);\r\n      if (undefined !== enumerator.description)\r\n        enumElement.setAttribute(\"description\", enumerator.description);\r\n      itemElement.appendChild(enumElement);\r\n    }\r\n\r\n    return itemElement;\r\n  }\r\n\r\n  public override fromJSONSync(enumerationProps: EnumerationProps) {\r\n    super.fromJSONSync(enumerationProps);\r\n    if (undefined === this._type) {\r\n      if (/int/i.test(enumerationProps.type)) {\r\n        this._type = PrimitiveType.Integer;\r\n      } else if (/string/i.test(enumerationProps.type)) {\r\n        this._type = PrimitiveType.String;\r\n      } else {\r\n        if (SchemaReadHelper.isECSpecVersionNewer({ readVersion: enumerationProps.originalECSpecMajorVersion, writeVersion: enumerationProps.originalECSpecMinorVersion } as ECSpecVersion))\r\n          this._type = PrimitiveType.String;\r\n        else\r\n          throw new ECSchemaError(ECSchemaStatus.InvalidECJson, `The Enumeration ${this.name} has an invalid 'type' attribute. It should be either \"int\" or \"string\".`);\r\n      }\r\n    } else {\r\n      const primitiveTypePattern = (this.isInt) ? /int/i : /string/i;\r\n      if (!primitiveTypePattern.test(enumerationProps.type))\r\n        throw new ECSchemaError(ECSchemaStatus.InvalidECJson, `The Enumeration ${this.name} has an incompatible type. It must be \"${(this.isInt) ? \"int\" : \"string\"}\", not \"${(this.isInt) ? \"string\" : \"int\"}\".`);\r\n    }\r\n    this._isStrict = enumerationProps.isStrict;\r\n\r\n    if (undefined !== enumerationProps.enumerators) {\r\n      enumerationProps.enumerators.forEach((enumerator: EnumeratorProps) => {\r\n        // Creates a new enumerator (with the specified name, value, label and description- label and description are optional) and adds to the list of enumerators.\r\n        // Throws ECSchemaError if there are duplicate names or values present in the enumeration\r\n        this.addEnumerator(this.createEnumerator(enumerator.name, enumerator.value, enumerator.label, enumerator.description));\r\n      });\r\n    }\r\n  }\r\n\r\n  public override async fromJSON(enumerationProps: EnumerationProps) {\r\n    this.fromJSONSync(enumerationProps);\r\n  }\r\n\r\n  /**\r\n   * @internal\r\n   */\r\n  protected setIsStrict(isStrict: boolean) {\r\n    this._isStrict = isStrict;\r\n  }\r\n\r\n  /**\r\n   * Type guard to check if the SchemaItem is of type Enumeration.\r\n   * @param item The SchemaItem to check.\r\n   * @returns True if the item is an Enumeration, false otherwise.\r\n   */\r\n  public static isEnumeration(item?: SchemaItem): item is Enumeration {\r\n    return item?.schemaItemType === SchemaItemType.Enumeration;\r\n  }\r\n\r\n  /**\r\n   * Type assertion to check if the SchemaItem is of type Enumeration.\r\n   * @param item The SchemaItem to check.\r\n   * @returns The item cast to Enumeration if it is an Enumeration, undefined otherwise.\r\n   * @internal\r\n   */\r\n  public static assertIsEnumeration(item?: SchemaItem): asserts item is Enumeration {\r\n    if (!this.isEnumeration(item))\r\n      throw new ECSchemaError(ECSchemaStatus.InvalidSchemaItemType, `Expected '${SchemaItemType.Enumeration}' (Enumeration)`);\r\n  }\r\n}\r\n\r\n/**\r\n * An abstract class used for schema editing.\r\n *\r\n * @internal\r\n */\r\nexport abstract class MutableEnumeration extends Enumeration {\r\n  public abstract override addEnumerator(enumerator: AnyEnumerator): void;\r\n  public abstract override setIsStrict(isStrict: boolean): void;\r\n  public abstract override setDisplayLabel(displayLabel: string): void;\r\n}\r\n"]}

package/lib/esm/Metadata/Format.d.ts

@@ -3,19 +3,20 @@
  */
 import { SchemaItemFormatProps } from "../Deserialization/JsonProps";
 import { SchemaItemType } from "../ECObjects";
-import { BaseFormat, DecimalPrecision, FormatTraits, FormatType, FractionalPrecision, ScientificType, ShowSignOption } from "@itwin/core-quantity";
-import { InvertedUnit } from "./InvertedUnit";
+import { DecimalPrecision, FormatTraits, FormatType, FractionalPrecision, ScientificType, ShowSignOption } from "@itwin/core-quantity";
 import { Schema } from "./Schema";
 import { SchemaItem } from "./SchemaItem";
-import { Unit } from "./Unit";
+import { LazyLoadedInvertedUnit, LazyLoadedUnit } from "../Interfaces";
 /**
- * @beta
+ * @public @preview
  */
 export declare class Format extends SchemaItem {
     readonly schemaItemType: SchemaItemType;
+    /** @internal */
     static get schemaItemType(): SchemaItemType;
-    protected _base: BaseFormat;
-    protected _units?: Array<[Unit | InvertedUnit, string | undefined]>;
+    private _base;
+    private _units?;
+    /** @internal */
     constructor(schema: Schema, name: string);
     get roundFactor(): number;
     get type(): FormatType;
@@ -31,15 +32,21 @@ export declare class Format extends SchemaItem {
     get formatTraits(): FormatTraits;
     get spacer(): string | undefined;
     get includeZero(): boolean | undefined;
-    get units(): Array<[Unit | InvertedUnit, string | undefined]> | undefined;
+    get units(): ReadonlyArray<[LazyLoadedUnit | LazyLoadedInvertedUnit, string | undefined]> | undefined;
     private parseFormatTraits;
     hasFormatTrait(formatTrait: FormatTraits): boolean;
     /**
      * Adds a Unit, or InvertedUnit, with an optional label override.
      * @param unit The Unit, or InvertedUnit, to add to this Format.
      * @param label A label that overrides the label defined within the Unit when a value is formatted.
+     * @internal
+     */
+    protected addUnit(unit: LazyLoadedUnit | LazyLoadedInvertedUnit, label?: string): void;
+    /**
+     *
+     * @param precision
+     * @internal
      */
-    protected addUnit(unit: Unit | InvertedUnit, label?: string): void;
     protected setPrecision(precision: number): void;
     private typecheck;
     fromJSONSync(formatProps: SchemaItemFormatProps): void;
@@ -53,61 +60,61 @@ export declare class Format extends SchemaItem {
     /** @internal */
     toXml(schemaXml: Document): Promise<Element>;
     /**
-     * @alpha Used in schema editing.
+     * @internal
      */
     protected setFormatType(formatType: FormatType): void;
     /**
-     * @alpha Used in schema editing.
+     * @internal
      */
     protected setRoundFactor(roundFactor: number): void;
     /**
-     * @alpha Used in schema editing.
+     * @internal
      */
     protected setShowSignOption(signOption: ShowSignOption): void;
     /**
-     * @alpha Used in schema editing.
+     * @internal
      */
     protected setDecimalSeparator(separator: string): void;
     /**
-     * @alpha Used in schema editing.
+     * @internal
      */
     protected setThousandSeparator(separator: string): void;
     /**
-     * @alpha Used in schema editing.
+     * @internal
      */
     protected setUomSeparator(separator: string): void;
     /**
-     * @alpha Used in schema editing.
+     * @internal
      */
     protected setStationSeparator(separator: string): void;
     /**
-     * @alpha Used in schema editing.
+     * @internal
      */
     protected setStationOffsetSize(stationOffsetSize: number): void;
     /**
-     * @alpha Used in schema editing.
+     * @internal
      */
     protected setScientificType(scientificType: ScientificType): void;
     /**
-     * @alpha Used in schema editing.
+     * @internal
      */
     protected setMinWidth(minWidth: number): void;
     /**
-     * @alpha Used in schema editing.
+     * @internal
      */
     protected setSpacer(spacer: string): void;
     /**
-     * @alpha Used in schema editing.
+     * @internal
      */
     protected setIncludeZero(includeZero: boolean): void;
     /**
-     * @alpha Used in schema editing.
+     * @internal
      */
     protected setFormatTraits(formatTraits: FormatTraits): void;
     /**
-     * @alpha Used in schema editing.
+     * @internal
      */
-    protected setUnits(units: Array<[Unit | InvertedUnit, string | undefined]>): void;
+    protected setUnits(units: Array<[LazyLoadedUnit | LazyLoadedInvertedUnit, string | undefined]>): void;
     /** Type guard to check if the SchemaItem is of type Format.
      * @param item The SchemaItem to check.
      * @returns True if the item is a Format, false otherwise.
@@ -117,6 +124,7 @@ export declare class Format extends SchemaItem {
      * Type assertion to check if the SchemaItem is of type Format.
      * @param item The SchemaItem to check.
      * @returns The item cast to Format if it is a Format, undefined otherwise.
+     * @internal
      */
     static assertIsFormat(item?: SchemaItem): asserts item is Format;
 }
@@ -125,7 +133,7 @@ export declare class Format extends SchemaItem {
  * An abstract class used for schema editing.
  */
 export declare abstract class MutableFormat extends Format {
-    abstract addUnit(unit: Unit | InvertedUnit, label?: string): void;
+    abstract addUnit(unit: LazyLoadedUnit | LazyLoadedInvertedUnit, label?: string): void;
     abstract setPrecision(precision: number): void;
     abstract setFormatType(formatType: FormatType): void;
     abstract setRoundFactor(roundFactor: number): void;

package/lib/esm/Metadata/Format.d.ts.map

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

package/lib/esm/Metadata/Format.js

@@ -7,19 +7,22 @@
  */
 import { XmlSerializationUtils } from "../Deserialization/XmlSerializationUtils";
 import { SchemaItemType } from "../ECObjects";
-import { ECObjectsError, ECObjectsStatus } from "../Exception";
+import { ECSchemaError, ECSchemaStatus } from "../Exception";
 import { BaseFormat, FormatTraits, formatTraitsToArray, FormatType, ShowSignOption, } from "@itwin/core-quantity";
 import { InvertedUnit } from "./InvertedUnit";
 import { SchemaItem } from "./SchemaItem";
 import { Unit } from "./Unit";
+import { DelayedPromiseWithProps } from "../DelayedPromise";
 /**
- * @beta
+ * @public @preview
  */
 export class Format extends SchemaItem {
     schemaItemType = Format.schemaItemType;
+    /** @internal */
     static get schemaItemType() { return SchemaItemType.Format; }
     _base;
     _units;
+    /** @internal */
     constructor(schema, name) {
         super(schema, name);
         this._base = new BaseFormat(name);
@@ -38,7 +41,9 @@ export class Format extends SchemaItem {
     get formatTraits() { return this._base.formatTraits; }
     get spacer() { return this._base.spacer; }
     get includeZero() { return this._base.includeZero; }
-    get units() { return this._units; }
+    get units() {
+        return this._units;
+    }
     parseFormatTraits(formatTraitsFromJson) {
         return this._base.parseFormatTraits(formatTraitsFromJson);
     }
@@ -49,6 +54,7 @@ export class Format extends SchemaItem {
      * Adds a Unit, or InvertedUnit, with an optional label override.
      * @param unit The Unit, or InvertedUnit, to add to this Format.
      * @param label A label that overrides the label defined within the Unit when a value is formatted.
+     * @internal
      */
     addUnit(unit, label) {
         if (undefined === this._units)
@@ -56,11 +62,16 @@ export class Format extends SchemaItem {
         else { // Validate that a duplicate is not added.
             for (const existingUnit of this._units) {
                 if (unit.fullName.toLowerCase() === existingUnit[0].fullName.toLowerCase())
-                    throw new ECObjectsError(ECObjectsStatus.InvalidECJson, `The Format ${this.fullName} has duplicate units, '${unit.fullName}'.`); // TODO: Validation - this should be a validation error not a hard failure.
+                    throw new ECSchemaError(ECSchemaStatus.InvalidECJson, `The Format ${this.fullName} has duplicate units, '${unit.fullName}'.`); // TODO: Validation - this should be a validation error not a hard failure.
             }
         }
         this._units.push([unit, label]);
     }
+    /**
+     *
+     * @param precision
+     * @internal
+     */
     setPrecision(precision) { this._base.precision = precision; }
     typecheck(formatProps) {
         this._base.loadFormatProperties(formatProps);
@@ -69,12 +80,12 @@ export class Format extends SchemaItem {
                 this._base.includeZero = formatProps.composite.includeZero;
             if (undefined !== formatProps.composite.spacer) {
                 if (formatProps.composite.spacer.length > 1)
-                    throw new ECObjectsError(ECObjectsStatus.InvalidECJson, `The Format ${this.fullName} has a composite with an invalid 'spacer' attribute. It should be an empty or one character string.`);
+                    throw new ECSchemaError(ECSchemaStatus.InvalidECJson, `The Format ${this.fullName} has a composite with an invalid 'spacer' attribute. It should be an empty or one character string.`);
                 this._base.spacer = formatProps.composite.spacer;
             }
             // Composite requires 1-4 units
             if (formatProps.composite.units.length <= 0 || formatProps.composite.units.length > 4)
-                throw new ECObjectsError(ECObjectsStatus.InvalidECJson, `The Format ${this.fullName} has an invalid 'Composite' attribute. It should have 1-4 units.`);
+                throw new ECSchemaError(ECSchemaStatus.InvalidECJson, `The Format ${this.fullName} has an invalid 'Composite' attribute. It should have 1-4 units.`);
         }
     }
     fromJSONSync(formatProps) {
@@ -86,8 +97,11 @@ export class Format extends SchemaItem {
         for (const unit of formatProps.composite.units) {
             const newUnit = this.schema.lookupItemSync(unit.name);
             if (undefined === newUnit || (!Unit.isUnit(newUnit) && !InvertedUnit.isInvertedUnit(newUnit)))
-                throw new ECObjectsError(ECObjectsStatus.InvalidECJson, ``);
-            this.addUnit(newUnit, unit.label);
+                throw new ECSchemaError(ECSchemaStatus.InvalidECJson, ``);
+            if (Unit.isUnit(newUnit))
+                this.addUnit(new DelayedPromiseWithProps(newUnit.key, async () => newUnit), unit.label);
+            else if (InvertedUnit.isInvertedUnit(newUnit))
+                this.addUnit(new DelayedPromiseWithProps(newUnit.key, async () => newUnit), unit.label);
         }
     }
     async fromJSON(formatProps) {
@@ -99,8 +113,11 @@ export class Format extends SchemaItem {
         for (const unit of formatProps.composite.units) {
             const newUnit = await this.schema.lookupItem(unit.name);
             if (undefined === newUnit || (!Unit.isUnit(newUnit) && !InvertedUnit.isInvertedUnit(newUnit)))
-                throw new ECObjectsError(ECObjectsStatus.InvalidECJson, ``);
-            this.addUnit(newUnit, unit.label);
+                throw new ECSchemaError(ECSchemaStatus.InvalidECJson, ``);
+            if (Unit.isUnit(newUnit))
+                this.addUnit(new DelayedPromiseWithProps(newUnit.key, async () => newUnit), unit.label);
+            else if (InvertedUnit.isInvertedUnit(newUnit))
+                this.addUnit(new DelayedPromiseWithProps(newUnit.key, async () => newUnit), unit.label);
         }
     }
     /**
@@ -179,98 +196,100 @@ export class Format extends SchemaItem {
                 compositeElement.setAttribute("spacer", this.spacer);
             if (undefined !== this.includeZero)
                 compositeElement.setAttribute("includeZero", this.includeZero.toString());
-            this.units.forEach(([unit, label]) => {
+            for (const [unit, label] of this.units) {
+                const resolvedUnit = await unit;
                 const unitElement = schemaXml.createElement("Unit");
                 if (undefined !== label)
                     unitElement.setAttribute("label", label);
-                const unitName = XmlSerializationUtils.createXmlTypedName(this.schema, unit.schema, unit.name);
+                const unitName = XmlSerializationUtils.createXmlTypedName(this.schema, resolvedUnit.schema, resolvedUnit.name);
                 unitElement.textContent = unitName;
                 compositeElement.appendChild(unitElement);
-            });
+            }
+            ;
             itemElement.appendChild(compositeElement);
         }
         return itemElement;
     }
     /**
-     * @alpha Used in schema editing.
+     * @internal
      */
     setFormatType(formatType) {
         this._base.type = formatType;
     }
     /**
-     * @alpha Used in schema editing.
+     * @internal
      */
     setRoundFactor(roundFactor) {
         this._base.roundFactor = roundFactor;
     }
     /**
-     * @alpha Used in schema editing.
+     * @internal
      */
     setShowSignOption(signOption) {
         this._base.showSignOption = signOption;
     }
     /**
-     * @alpha Used in schema editing.
+     * @internal
      */
     setDecimalSeparator(separator) {
         this._base.decimalSeparator = separator;
     }
     /**
-     * @alpha Used in schema editing.
+     * @internal
      */
     setThousandSeparator(separator) {
         this._base.thousandSeparator = separator;
     }
     /**
-     * @alpha Used in schema editing.
+     * @internal
      */
     setUomSeparator(separator) {
         this._base.uomSeparator = separator;
     }
     /**
-     * @alpha Used in schema editing.
+     * @internal
      */
     setStationSeparator(separator) {
         this._base.stationSeparator = separator;
     }
     /**
-     * @alpha Used in schema editing.
+     * @internal
      */
     setStationOffsetSize(stationOffsetSize) {
         this._base.stationOffsetSize = stationOffsetSize;
     }
     /**
-     * @alpha Used in schema editing.
+     * @internal
      */
     setScientificType(scientificType) {
         this._base.scientificType = scientificType;
     }
     /**
-     * @alpha Used in schema editing.
+     * @internal
      */
     setMinWidth(minWidth) {
         this._base.minWidth = minWidth;
     }
     /**
-     * @alpha Used in schema editing.
+     * @internal
      */
     setSpacer(spacer) {
         this._base.spacer = spacer;
     }
     /**
-     * @alpha Used in schema editing.
+     * @internal
      */
     setIncludeZero(includeZero) {
         this._base.includeZero = includeZero;
     }
     /**
-     * @alpha Used in schema editing.
+     * @internal
      */
     setFormatTraits(formatTraits) {
         this._base.formatTraits = formatTraits;
     }
     /**
-     * @alpha Used in schema editing.
+     * @internal
      */
     setUnits(units) {
         this._units = units;
@@ -288,10 +307,11 @@ export class Format extends SchemaItem {
      * Type assertion to check if the SchemaItem is of type Format.
      * @param item The SchemaItem to check.
      * @returns The item cast to Format if it is a Format, undefined otherwise.
+     * @internal
      */
     static assertIsFormat(item) {
         if (!this.isFormat(item))
-            throw new ECObjectsError(ECObjectsStatus.InvalidSchemaItemType, `Expected '${SchemaItemType.Format}' (Format)`);
+            throw new ECSchemaError(ECSchemaStatus.InvalidSchemaItemType, `Expected '${SchemaItemType.Format}' (Format)`);
     }
 }
 /**