@itwin/ecschema-metadata 5.0.0-dev.9 → 5.0.0-dev.90

package/CHANGELOG.md

@@ -1,6 +1,56 @@
 # Change Log - @itwin/ecschema-metadata
 
-This log was last generated on Thu, 14 Nov 2024 18:13:56 GMT and should not be manually modified.
+This log was last generated on Wed, 19 Mar 2025 15:33:24 GMT and should not be manually modified.
+
+## 4.10.11
+Wed, 19 Mar 2025 15:30:39 GMT
+
+_Version update only_
+
+## 4.10.10
+Tue, 11 Mar 2025 15:25:11 GMT
+
+_Version update only_
+
+## 4.10.9
+Tue, 11 Mar 2025 05:17:33 GMT
+
+_Version update only_
+
+## 4.10.8
+Thu, 06 Mar 2025 14:13:37 GMT
+
+_Version update only_
+
+## 4.10.7
+Tue, 18 Feb 2025 17:27:03 GMT
+
+_Version update only_
+
+## 4.10.6
+Fri, 24 Jan 2025 08:02:40 GMT
+
+_Version update only_
+
+## 4.10.5
+Tue, 21 Jan 2025 21:56:45 GMT
+
+_Version update only_
+
+## 4.10.4
+Mon, 13 Jan 2025 14:06:43 GMT
+
+_Version update only_
+
+## 4.10.3
+Mon, 06 Jan 2025 14:00:13 GMT
+
+_Version update only_
+
+## 4.10.2
+Thu, 21 Nov 2024 15:22:20 GMT
+
+_Version update only_
 
 ## 4.10.1
 Thu, 14 Nov 2024 18:11:00 GMT

package/lib/cjs/Constants.js

@@ -9,26 +9,26 @@ exports.ECStringConstants = void 0;
  * @internal
  */
 class ECStringConstants {
+    // Relationship End
+    static RELATIONSHIP_END_SOURCE = "Source";
+    static RELATIONSHIP_END_TARGET = "Target";
+    // Container Type
+    static CONTAINERTYPE_SCHEMA = "Schema";
+    static CONTAINERTYPE_ENTITYCLASS = "EntityClass";
+    static CONTAINERTYPE_CUSTOMATTRIBUTECLASS = "CustomAttributeClass";
+    static CONTAINERTYPE_STRUCTCLASS = "StructClass";
+    static CONTAINERTYPE_RELATIONSHIPCLASS = "RelationshipClass";
+    static CONTAINERTYPE_ANYCLASS = "AnyClass";
+    static CONTAINERTYPE_PRIMITIVEPROPERTY = "PrimitiveProperty";
+    static CONTAINERTYPE_STRUCTPROPERTY = "StructProperty";
+    static CONTAINERTYPE_PRIMITIVEARRAYPROPERTY = "ArrayProperty";
+    static CONTAINERTYPE_STRUCTARRAYPROPERTY = "StructArrayProperty";
+    static CONTAINERTYPE_NAVIGATIONPROPERTY = "NavigationProperty";
+    static CONTAINERTYPE_ANYPROPERTY = "AnyProperty";
+    static CONTAINERTYPE_SOURCERELATIONSHIPCONSTRAINT = "SourceRelationshipConstraint";
+    static CONTAINERTYPE_TARGETRELATIONSHIPCONSTRAINT = "TargetRelationshipConstraint";
+    static CONTAINERTYPE_ANYRELATIONSHIPCONSTRAINT = "AnyRelationshipConstraint";
+    static CONTAINERTYPE_ANY = "Any";
 }
 exports.ECStringConstants = ECStringConstants;
-// Relationship End
-ECStringConstants.RELATIONSHIP_END_SOURCE = "Source";
-ECStringConstants.RELATIONSHIP_END_TARGET = "Target";
-// Container Type
-ECStringConstants.CONTAINERTYPE_SCHEMA = "Schema";
-ECStringConstants.CONTAINERTYPE_ENTITYCLASS = "EntityClass";
-ECStringConstants.CONTAINERTYPE_CUSTOMATTRIBUTECLASS = "CustomAttributeClass";
-ECStringConstants.CONTAINERTYPE_STRUCTCLASS = "StructClass";
-ECStringConstants.CONTAINERTYPE_RELATIONSHIPCLASS = "RelationshipClass";
-ECStringConstants.CONTAINERTYPE_ANYCLASS = "AnyClass";
-ECStringConstants.CONTAINERTYPE_PRIMITIVEPROPERTY = "PrimitiveProperty";
-ECStringConstants.CONTAINERTYPE_STRUCTPROPERTY = "StructProperty";
-ECStringConstants.CONTAINERTYPE_PRIMITIVEARRAYPROPERTY = "ArrayProperty";
-ECStringConstants.CONTAINERTYPE_STRUCTARRAYPROPERTY = "StructArrayProperty";
-ECStringConstants.CONTAINERTYPE_NAVIGATIONPROPERTY = "NavigationProperty";
-ECStringConstants.CONTAINERTYPE_ANYPROPERTY = "AnyProperty";
-ECStringConstants.CONTAINERTYPE_SOURCERELATIONSHIPCONSTRAINT = "SourceRelationshipConstraint";
-ECStringConstants.CONTAINERTYPE_TARGETRELATIONSHIPCONSTRAINT = "TargetRelationshipConstraint";
-ECStringConstants.CONTAINERTYPE_ANYRELATIONSHIPCONSTRAINT = "AnyRelationshipConstraint";
-ECStringConstants.CONTAINERTYPE_ANY = "Any";
 //# sourceMappingURL=Constants.js.map

package/lib/cjs/Constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"Constants.js","sourceRoot":"","sources":["../../src/Constants.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;;;AAE/F;;GAEG;AACH,MAAa,iBAAiB;;AAA9B,8CAyBC;AAxBC,mBAAmB;AACI,yCAAuB,GAAW,QAAQ,CAAC;AAC3C,yCAAuB,GAAW,QAAQ,CAAC;AAElE,iBAAiB;AACM,sCAAoB,GAAW,QAAQ,CAAC;AACxC,2CAAyB,GAAW,aAAa,CAAC;AAClD,oDAAkC,GAAW,sBAAsB,CAAC;AACpE,2CAAyB,GAAW,aAAa,CAAC;AAClD,iDAA+B,GAAW,mBAAmB,CAAC;AAC9D,wCAAsB,GAAW,UAAU,CAAC;AAE5C,iDAA+B,GAAW,mBAAmB,CAAC;AAC9D,8CAA4B,GAAW,gBAAgB,CAAC;AACxD,sDAAoC,GAAW,eAAe,CAAC;AAC/D,mDAAiC,GAAW,qBAAqB,CAAC;AAClE,kDAAgC,GAAW,oBAAoB,CAAC;AAChE,2CAAyB,GAAW,aAAa,CAAC;AAElD,4DAA0C,GAAW,8BAA8B,CAAC;AACpF,4DAA0C,GAAW,8BAA8B,CAAC;AACpF,yDAAuC,GAAW,2BAA2B,CAAC;AAE9E,mCAAiB,GAAW,KAAK,CAAC","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\r\n/**\r\n * @internal\r\n */\r\nexport class ECStringConstants {\r\n  // Relationship End\r\n  public static readonly RELATIONSHIP_END_SOURCE: string = \"Source\";\r\n  public static readonly RELATIONSHIP_END_TARGET: string = \"Target\";\r\n\r\n  // Container Type\r\n  public static readonly CONTAINERTYPE_SCHEMA: string = \"Schema\";\r\n  public static readonly CONTAINERTYPE_ENTITYCLASS: string = \"EntityClass\";\r\n  public static readonly CONTAINERTYPE_CUSTOMATTRIBUTECLASS: string = \"CustomAttributeClass\";\r\n  public static readonly CONTAINERTYPE_STRUCTCLASS: string = \"StructClass\";\r\n  public static readonly CONTAINERTYPE_RELATIONSHIPCLASS: string = \"RelationshipClass\";\r\n  public static readonly CONTAINERTYPE_ANYCLASS: string = \"AnyClass\";\r\n\r\n  public static readonly CONTAINERTYPE_PRIMITIVEPROPERTY: string = \"PrimitiveProperty\";\r\n  public static readonly CONTAINERTYPE_STRUCTPROPERTY: string = \"StructProperty\";\r\n  public static readonly CONTAINERTYPE_PRIMITIVEARRAYPROPERTY: string = \"ArrayProperty\";\r\n  public static readonly CONTAINERTYPE_STRUCTARRAYPROPERTY: string = \"StructArrayProperty\";\r\n  public static readonly CONTAINERTYPE_NAVIGATIONPROPERTY: string = \"NavigationProperty\";\r\n  public static readonly CONTAINERTYPE_ANYPROPERTY: string = \"AnyProperty\";\r\n\r\n  public static readonly CONTAINERTYPE_SOURCERELATIONSHIPCONSTRAINT: string = \"SourceRelationshipConstraint\";\r\n  public static readonly CONTAINERTYPE_TARGETRELATIONSHIPCONSTRAINT: string = \"TargetRelationshipConstraint\";\r\n  public static readonly CONTAINERTYPE_ANYRELATIONSHIPCONSTRAINT: string = \"AnyRelationshipConstraint\";\r\n\r\n  public static readonly CONTAINERTYPE_ANY: string = \"Any\";\r\n}\r\n"]}
+{"version":3,"file":"Constants.js","sourceRoot":"","sources":["../../src/Constants.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;;;AAE/F;;GAEG;AACH,MAAa,iBAAiB;IAC5B,mBAAmB;IACZ,MAAM,CAAU,uBAAuB,GAAW,QAAQ,CAAC;IAC3D,MAAM,CAAU,uBAAuB,GAAW,QAAQ,CAAC;IAElE,iBAAiB;IACV,MAAM,CAAU,oBAAoB,GAAW,QAAQ,CAAC;IACxD,MAAM,CAAU,yBAAyB,GAAW,aAAa,CAAC;IAClE,MAAM,CAAU,kCAAkC,GAAW,sBAAsB,CAAC;IACpF,MAAM,CAAU,yBAAyB,GAAW,aAAa,CAAC;IAClE,MAAM,CAAU,+BAA+B,GAAW,mBAAmB,CAAC;IAC9E,MAAM,CAAU,sBAAsB,GAAW,UAAU,CAAC;IAE5D,MAAM,CAAU,+BAA+B,GAAW,mBAAmB,CAAC;IAC9E,MAAM,CAAU,4BAA4B,GAAW,gBAAgB,CAAC;IACxE,MAAM,CAAU,oCAAoC,GAAW,eAAe,CAAC;IAC/E,MAAM,CAAU,iCAAiC,GAAW,qBAAqB,CAAC;IAClF,MAAM,CAAU,gCAAgC,GAAW,oBAAoB,CAAC;IAChF,MAAM,CAAU,yBAAyB,GAAW,aAAa,CAAC;IAElE,MAAM,CAAU,0CAA0C,GAAW,8BAA8B,CAAC;IACpG,MAAM,CAAU,0CAA0C,GAAW,8BAA8B,CAAC;IACpG,MAAM,CAAU,uCAAuC,GAAW,2BAA2B,CAAC;IAE9F,MAAM,CAAU,iBAAiB,GAAW,KAAK,CAAC;;AAxB3D,8CAyBC","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/**\n * @internal\n */\nexport class ECStringConstants {\n  // Relationship End\n  public static readonly RELATIONSHIP_END_SOURCE: string = \"Source\";\n  public static readonly RELATIONSHIP_END_TARGET: string = \"Target\";\n\n  // Container Type\n  public static readonly CONTAINERTYPE_SCHEMA: string = \"Schema\";\n  public static readonly CONTAINERTYPE_ENTITYCLASS: string = \"EntityClass\";\n  public static readonly CONTAINERTYPE_CUSTOMATTRIBUTECLASS: string = \"CustomAttributeClass\";\n  public static readonly CONTAINERTYPE_STRUCTCLASS: string = \"StructClass\";\n  public static readonly CONTAINERTYPE_RELATIONSHIPCLASS: string = \"RelationshipClass\";\n  public static readonly CONTAINERTYPE_ANYCLASS: string = \"AnyClass\";\n\n  public static readonly CONTAINERTYPE_PRIMITIVEPROPERTY: string = \"PrimitiveProperty\";\n  public static readonly CONTAINERTYPE_STRUCTPROPERTY: string = \"StructProperty\";\n  public static readonly CONTAINERTYPE_PRIMITIVEARRAYPROPERTY: string = \"ArrayProperty\";\n  public static readonly CONTAINERTYPE_STRUCTARRAYPROPERTY: string = \"StructArrayProperty\";\n  public static readonly CONTAINERTYPE_NAVIGATIONPROPERTY: string = \"NavigationProperty\";\n  public static readonly CONTAINERTYPE_ANYPROPERTY: string = \"AnyProperty\";\n\n  public static readonly CONTAINERTYPE_SOURCERELATIONSHIPCONSTRAINT: string = \"SourceRelationshipConstraint\";\n  public static readonly CONTAINERTYPE_TARGETRELATIONSHIPCONSTRAINT: string = \"TargetRelationshipConstraint\";\n  public static readonly CONTAINERTYPE_ANYRELATIONSHIPCONSTRAINT: string = \"AnyRelationshipConstraint\";\n\n  public static readonly CONTAINERTYPE_ANY: string = \"Any\";\n}\n"]}

package/lib/cjs/Context.d.ts

@@ -19,14 +19,14 @@ export interface ISchemaLocater {
      * @param matchType how to match key against candidate schemas
      * @param context context for loading schema references
      */
-    getSchema<T extends Schema>(schemaKey: Readonly<SchemaKey>, matchType: SchemaMatchType, context: SchemaContext): Promise<T | undefined>;
+    getSchema(schemaKey: SchemaKey, matchType: SchemaMatchType, context: SchemaContext): Promise<Schema | undefined>;
     /**
     * Gets the schema info which matches the provided SchemaKey.  The schema info may be returned before the schema is fully loaded.
     * May return the entire Schema so long as it is completely loaded as it satisfies the SchemaInfo interface.
     * @param schemaKey The SchemaKey describing the schema to get from the cache.
     * @param matchType The match type to use when locating the schema
     */
-    getSchemaInfo(schemaKey: Readonly<SchemaKey>, matchType: SchemaMatchType, context: SchemaContext): Promise<SchemaInfo | undefined>;
+    getSchemaInfo(schemaKey: SchemaKey, matchType: SchemaMatchType, context: SchemaContext): Promise<SchemaInfo | undefined>;
     /**
      * Attempts to get a schema from the locater. Yields undefined if no matching schema is found.
      * For schemas that may have references, construct and call through a SchemaContext instead.
@@ -34,13 +34,7 @@ export interface ISchemaLocater {
      * @param matchType how to match key against candidate schemas
      * @param context context for loading schema references
      */
-    getSchemaSync<T extends Schema>(schemaKey: Readonly<SchemaKey>, matchType: SchemaMatchType, context: SchemaContext): T | undefined;
-}
-/**
- * @beta
- */
-export interface ISchemaItemLocater {
-    getSchemaItem<T extends SchemaItem>(schemaItemKey: SchemaItemKey): Promise<T | undefined>;
+    getSchemaSync(schemaKey: SchemaKey, matchType: SchemaMatchType, context: SchemaContext): Schema | undefined;
 }
 /**
  * @internal
@@ -58,7 +52,7 @@ export declare class SchemaCache implements ISchemaLocater {
      * Returns true if the schema exists in either the schema cache or the promise cache.  SchemaMatchType.Latest used.
      * @param schemaKey The key to search for.
      */
-    schemaExists(schemaKey: Readonly<SchemaKey>): boolean;
+    schemaExists(schemaKey: SchemaKey): boolean;
     /**
      * Adds a promise to load the schema to the cache. Does not allow for duplicate schemas in the cache of schemas or cache of promises, checks using SchemaMatchType.Latest.
      * When the promise completes the schema will be added to the schema cache and the promise will be removed from the promise cache
@@ -71,41 +65,41 @@ export declare class SchemaCache implements ISchemaLocater {
      * Adds a schema to the cache. Does not allow for duplicate schemas, checks using SchemaMatchType.Latest.
      * @param schema The schema to add to the cache.
      */
-    addSchema<T extends Schema>(schema: T): Promise<void>;
+    addSchema(schema: Schema): Promise<void>;
     /**
      * Adds a schema to the cache. Does not allow for duplicate schemas, checks using SchemaMatchType.Latest.
      * @param schema The schema to add to the cache.
      */
-    addSchemaSync<T extends Schema>(schema: T): void;
+    addSchemaSync(schema: Schema): void;
     /**
      * Gets the schema which matches the provided SchemaKey.
      * @param schemaKey The SchemaKey describing the schema to get from the cache.
      * @param matchType The match type to use when locating the schema
      */
-    getSchema<T extends Schema>(schemaKey: Readonly<SchemaKey>, matchType?: SchemaMatchType): Promise<T | undefined>;
+    getSchema(schemaKey: SchemaKey, matchType?: SchemaMatchType): Promise<Schema | undefined>;
     /**
       * Gets the schema info which matches the provided SchemaKey.  The schema info may be returned before the schema is fully loaded.
       * @param schemaKey The SchemaKey describing the schema to get from the cache.
       * @param matchType The match type to use when locating the schema
       */
-    getSchemaInfo(schemaKey: Readonly<SchemaKey>, matchType?: SchemaMatchType): Promise<SchemaInfo | undefined>;
+    getSchemaInfo(schemaKey: SchemaKey, matchType?: SchemaMatchType): Promise<SchemaInfo | undefined>;
     /**
      * Gets the schema which matches the provided SchemaKey.  If the schema is partially loaded an exception will be thrown.
      * @param schemaKey The SchemaKey describing the schema to get from the cache.
      * @param matchType The match type to use when locating the schema
      */
-    getSchemaSync<T extends Schema>(schemaKey: Readonly<SchemaKey>, matchType?: SchemaMatchType): T | undefined;
+    getSchemaSync(schemaKey: SchemaKey, matchType?: SchemaMatchType): Schema | undefined;
     /**
      * Generator function that can iterate through each schema in _schema SchemaMap and items for each Schema.
      * Does not include schema items from schemas that are not completely loaded yet.
      */
-    getSchemaItems(): IterableIterator<SchemaItem>;
+    getSchemaItems(): Iterable<SchemaItem>;
     /**
      * Gets all the schemas from the schema cache.
      * Does not include schemas from schemas that are not completely loaded yet.
      * @returns An array of Schema objects.
      */
-    getAllSchemas(): Schema[];
+    getAllSchemas(): Iterable<Schema>;
 }
 /**
  * The SchemaContext, context object is used to facilitate schema and schema item location.
@@ -115,11 +109,30 @@ export declare class SchemaCache implements ISchemaLocater {
  * The context is made up of a group of Schema Locators.
  * @beta
  */
-export declare class SchemaContext implements ISchemaItemLocater {
+export declare class SchemaContext {
     private _locaters;
     private _knownSchemas;
+    private _fallbackLocaterDefined;
     constructor();
+    get locaters(): ISchemaLocater[];
+    /**
+     * Adds a locater to the context.
+     *
+     * If no locaters are defined or a fallback locater is not defined, the new locater is added at the end of the locaters array.
+     * If a fallback locater is already defined, the new locater is inserted before the fallback locater.
+     *
+     * @param locater - The locater to be added.
+     */
     addLocater(locater: ISchemaLocater): void;
+    /**
+     * Adds a fallback locater to the context.
+     *
+     * If a fallback locater is already defined, it replaces the existing one.
+     * Otherwise, it adds the new locater to the end of the locaters array and marks the fallback locater as defined.
+     *
+     * @param locater - The locater to be added as a fallback.
+     */
+    addFallbackLocater(locater: ISchemaLocater): void;
     /**
      * Adds the schema to this context.  Use addSchemaPromise instead when asynchronously loading schemas.
      * @param schema The schema to add to this context
@@ -140,7 +153,7 @@ export declare class SchemaContext implements ISchemaItemLocater {
      * Returns true if the schema is already in the context.  SchemaMatchType.Latest is used to find a match.
      * @param schemaKey
      */
-    schemaExists(schemaKey: Readonly<SchemaKey>): boolean;
+    schemaExists(schemaKey: SchemaKey): boolean;
     /**
      * Adds a promise to load the schema to the cache. Does not allow for duplicate schemas in the cache of schemas or cache of promises, checks using SchemaMatchType.Latest.
      * When the promise completes the schema will be added to the schema cache and the promise will be removed from the promise cache.
@@ -155,21 +168,21 @@ export declare class SchemaContext implements ISchemaItemLocater {
      * @param matchType Criteria by which to identify potentially matching schemas.
      * @returns the schema matching the input criteria, or `undefined` if no such schema could be located.
      */
-    getSchema<T extends Schema>(schemaKey: Readonly<SchemaKey>, matchType?: SchemaMatchType): Promise<T | undefined>;
+    getSchema(schemaKey: SchemaKey, matchType?: SchemaMatchType): Promise<Schema | undefined>;
     /**
      * Gets the schema info which matches the provided SchemaKey.  The schema info may be returned before the schema is fully loaded.
      * The fully loaded schema can be gotten later from the context using [[getSchema]].
      * @param schemaKey The SchemaKey describing the schema to get from the cache.
      * @param matchType The match type to use when locating the schema
      */
-    getSchemaInfo(schemaKey: Readonly<SchemaKey>, matchType: SchemaMatchType): Promise<SchemaInfo | undefined>;
+    getSchemaInfo(schemaKey: SchemaKey, matchType: SchemaMatchType): Promise<SchemaInfo | undefined>;
     /** Attempts to obtain a schema from this context that matches the specified criteria.
      * Will return undefined if the schema is partially loaded.  Use [[getSchema]] to await until the schema is completely loaded.
      * @param schemaKey Identifies the schema to obtain.
      * @param matchType Criteria by which to identify potentially matching schemas.
      * @returns the schema matching the input criteria, or `undefined` if no such schema could be located.
      */
-    getSchemaSync<T extends Schema>(schemaKey: SchemaKey, matchType?: SchemaMatchType): T | undefined;
+    getSchemaSync(schemaKey: SchemaKey, matchType?: SchemaMatchType): Schema | undefined;
     /**
      * Attempts to get a Schema from the context's cache.
      * Will await a partially loaded schema then return when it is completely loaded.
@@ -177,7 +190,7 @@ export declare class SchemaContext implements ISchemaItemLocater {
      * @param matchType The SchemaMatch type to use. Default is SchemaMatchType.Latest.
      * @internal
      */
-    getCachedSchema<T extends Schema>(schemaKey: Readonly<SchemaKey>, matchType?: SchemaMatchType): Promise<T | undefined>;
+    getCachedSchema(schemaKey: SchemaKey, matchType?: SchemaMatchType): Promise<Schema | undefined>;
     /**
      * Attempts to get a Schema from the context's cache.
      * Will return undefined if the cached schema is partially loaded.  Use [[getCachedSchema]] to await until the schema is completely loaded.
@@ -185,28 +198,64 @@ export declare class SchemaContext implements ISchemaItemLocater {
      * @param matchType The SchemaMatch type to use. Default is SchemaMatchType.Latest.
      * @internal
      */
-    getCachedSchemaSync<T extends Schema>(schemaKey: Readonly<SchemaKey>, matchType?: SchemaMatchType): T | undefined;
+    getCachedSchemaSync(schemaKey: SchemaKey, matchType?: SchemaMatchType): Schema | undefined;
     /**
      * Gets the schema item from the specified schema if it exists in this [[SchemaContext]].
-     * Will await a partially loaded schema then look in it for the requested item
-     * @param schemaItemKey The SchemaItemKey identifying the item to return.  SchemaMatchType.Latest is used to match the schema.
-     * @returns The requested schema item
+     * Will await a partially loaded schema then look in it for the requested item.
+     *
+     * @param schemaNameOrKey - The SchemaItemKey identifying the item to return or the name of the schema or the schema item full name.
+     * @param itemNameOrCtor - The name of the item to return or the constructor of the item to return.
+     * @param itemConstructor - The constructor of the item to return.
+     * @returns The requested schema item, or `undefined` if the item could not be found.
+     *
+     * @examples
+     * ```typescript
+     * const schemaItem = await schemaContext.getSchemaItem(new SchemaItemKey("TestElement", new SchemaKey("TestSchema")));
+     * const schemaItemWithCtor = await schemaContext.getSchemaItem(new SchemaItemKey("TestElement", new SchemaKey("TestSchema")), EntityClass);
+     * const schemaItemByName = await schemaContext.getSchemaItem("TestSchema", "TestElement");
+     * const schemaItemByNameWithCtor = await schemaContext.getSchemaItem("TestSchema", "TestElement", EntityClass);
+     * const schemaItemFullName = await schemaContext.getSchemaItem("TestSchema:TestElement", EntityClass);
+     * const schemaItemFullNameWithCtor = await schemaContext.getSchemaItem("TestSchema:TestElement", EntityClass);
+     * const schemaItemFullNameSep = await schemaContext.getSchemaItem("TestSchema.TestElement", EntityClass);
+     * const schemaItemFullNameSepWithCtor = await schemaContext.getSchemaItem("TestSchema.TestElement", EntityClass);
+     * ```
      */
-    getSchemaItem<T extends SchemaItem>(schemaItemKey: SchemaItemKey): Promise<T | undefined>;
+    getSchemaItem<T extends typeof SchemaItem>(schemaNameOrKey: SchemaItemKey | string, itemNameOrCtor?: T): Promise<InstanceType<T> | undefined>;
+    getSchemaItem<T extends typeof SchemaItem>(schemaNameOrKey: SchemaItemKey | string, itemNameOrCtor?: T): Promise<SchemaItem | undefined>;
+    getSchemaItem<T extends typeof SchemaItem>(schemaNameOrKey: string, itemNameOrCtor: string, itemConstructor?: T): Promise<InstanceType<T> | undefined>;
+    getSchemaItem<T extends typeof SchemaItem>(schemaNameOrKey: string, itemNameOrCtor: string, itemConstructor?: T): Promise<SchemaItem | undefined>;
     /**
      * Gets the schema item from the specified schema if it exists in this [[SchemaContext]].
-     * Will skip a partially loaded schema and return undefined if the item belongs to that schema.  Use the async method to await partially loaded schemas.
-     * @param schemaItemKey The SchemaItemKey identifying the item to return.  SchemaMatchType.Latest is used to match the schema.
-     * @returns The requested schema item
+     * Will return undefined if the cached schema is partially loaded. Use [[getSchemaItem]] to await until the schema is completely loaded.
+     *
+     * @param nameOrKey - The SchemaItemKey identifying the item to return or the name of the schema or the schema item full name.
+     * @param nameOrCtor - The name of the item to return or the constructor of the item to return.
+     * @param ctor - The constructor of the item to return.
+     * @returns The requested schema item, or `undefined` if the item could not be found.
+     *
+     * @example
+     * ```typescript
+     * const schemaItem = schemaContext.getSchemaItemSync(new SchemaItemKey("TestElement", new SchemaKey("TestSchema")));
+     * const schemaItemWithCtor = schemaContext.getSchemaItemSync(new SchemaItemKey("TestElement", new SchemaKey("TestSchema")), EntityClass);
+     * const schemaItemByName = schemaContext.getSchemaItemSync("TestSchema", "TestElement");
+     * const schemaItemByNameWithCtor = schemaContext.getSchemaItemSync("TestSchema", "TestElement", EntityClass);
+     * const schemaItemFullName = schemaContext.getSchemaItemSync("TestSchema:TestElement", EntityClass);
+     * const schemaItemFullNameWithCtor = schemaContext.getSchemaItemSync("TestSchema:TestElement", EntityClass);
+     * const schemaItemFullNameSep = schemaContext.getSchemaItemSync("TestSchema.TestElement", EntityClass);
+     * const schemaItemFullNameSepWithCtor = schemaContext.getSchemaItemSync("TestSchema.TestElement", EntityClass);
+     * ```
      */
-    getSchemaItemSync<T extends SchemaItem>(schemaItemKey: SchemaItemKey): T | undefined;
+    getSchemaItemSync<T extends typeof SchemaItem>(schemaNameOrKey: SchemaItemKey | string, itemNameOrCtor?: T): InstanceType<T> | undefined;
+    getSchemaItemSync<T extends typeof SchemaItem>(schemaNameOrKey: SchemaItemKey | string, itemNameOrCtor?: T): SchemaItem | undefined;
+    getSchemaItemSync<T extends typeof SchemaItem>(schemaNameOrKey: string, itemNameOrCtor: string, itemConstructor?: T): InstanceType<T> | undefined;
+    getSchemaItemSync<T extends typeof SchemaItem>(schemaNameOrKey: string, itemNameOrCtor: string, itemConstructor?: T): SchemaItem | undefined;
     /**
      * Iterates through the items of each schema known to the context.  This includes schemas added to the
      * context using [[SchemaContext.addSchema]]. This does not include schemas that
      * can be located by an ISchemaLocater instance added to the context.
      * Does not include schema items from schemas that are not completely loaded yet.
      */
-    getSchemaItems(): IterableIterator<SchemaItem>;
+    getSchemaItems(): Iterable<SchemaItem>;
     /**
      * Gets all the Schemas known by the context. This includes schemas added to the
      * context using [[SchemaContext.addSchema]]. This does not include schemas that
@@ -214,6 +263,6 @@ export declare class SchemaContext implements ISchemaItemLocater {
      * include schemas that are partially loaded.
      * @returns An array of Schema objects.
      */
-    getKnownSchemas(): Schema[];
+    getKnownSchemas(): Iterable<Schema>;
 }
 //# sourceMappingURL=Context.d.ts.map

package/lib/cjs/Context.d.ts.map

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

package/lib/cjs/Context.js

@@ -1,12 +1,14 @@
 "use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SchemaContext = exports.SchemaCache = void 0;
 /*---------------------------------------------------------------------------------------------
 * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
 * See LICENSE.md in the project root for license terms and full copyright notice.
 *--------------------------------------------------------------------------------------------*/
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SchemaContext = exports.SchemaCache = void 0;
 const ECObjects_1 = require("./ECObjects");
 const Exception_1 = require("./Exception");
+const SchemaItem_1 = require("./Metadata/SchemaItem");
+const SchemaKey_1 = require("./SchemaKey");
 /**
  * @internal
  */
@@ -16,6 +18,7 @@ class SchemaMap extends Array {
  * @internal
  */
 class SchemaCache {
+    _schema;
     constructor() {
         this._schema = new SchemaMap();
     }
@@ -164,13 +167,44 @@ exports.SchemaCache = SchemaCache;
  * @beta
  */
 class SchemaContext {
+    _locaters;
+    _knownSchemas;
+    _fallbackLocaterDefined;
     constructor() {
         this._locaters = [];
         this._knownSchemas = new SchemaCache();
         this._locaters.push(this._knownSchemas);
+        this._fallbackLocaterDefined = false;
     }
+    get locaters() { return this._locaters; }
+    /**
+     * Adds a locater to the context.
+     *
+     * If no locaters are defined or a fallback locater is not defined, the new locater is added at the end of the locaters array.
+     * If a fallback locater is already defined, the new locater is inserted before the fallback locater.
+     *
+     * @param locater - The locater to be added.
+     */
     addLocater(locater) {
-        this._locaters.push(locater);
+        const insertIndex = (this._locaters.length === 0 || !this._fallbackLocaterDefined) ? this._locaters.length : this._locaters.length - 1;
+        this._locaters.splice(insertIndex, 0, locater);
+    }
+    /**
+     * Adds a fallback locater to the context.
+     *
+     * If a fallback locater is already defined, it replaces the existing one.
+     * Otherwise, it adds the new locater to the end of the locaters array and marks the fallback locater as defined.
+     *
+     * @param locater - The locater to be added as a fallback.
+     */
+    addFallbackLocater(locater) {
+        if (this._fallbackLocaterDefined) {
+            this._locaters[this._locaters.length - 1] = locater;
+        }
+        else {
+            this._locaters.push(locater);
+            this._fallbackLocaterDefined = true;
+        }
     }
     /**
      * Adds the schema to this context.  Use addSchemaPromise instead when asynchronously loading schemas.
@@ -278,29 +312,45 @@ class SchemaContext {
     getCachedSchemaSync(schemaKey, matchType = ECObjects_1.SchemaMatchType.Latest) {
         return this._knownSchemas.getSchemaSync(schemaKey, matchType);
     }
-    /**
-     * Gets the schema item from the specified schema if it exists in this [[SchemaContext]].
-     * Will await a partially loaded schema then look in it for the requested item
-     * @param schemaItemKey The SchemaItemKey identifying the item to return.  SchemaMatchType.Latest is used to match the schema.
-     * @returns The requested schema item
-     */
-    async getSchemaItem(schemaItemKey) {
-        const schema = await this.getSchema(schemaItemKey.schemaKey, ECObjects_1.SchemaMatchType.Latest);
-        if (undefined === schema)
+    async getSchemaItem(schemaNameOrKey, itemNameOrCtor, itemConstructor) {
+        let schemaKey;
+        if (typeof schemaNameOrKey === "string") {
+            const [schemaName, itemName] = SchemaItem_1.SchemaItem.parseFullName(schemaNameOrKey);
+            schemaKey = (!schemaName) ? new SchemaKey_1.SchemaKey(itemName) : new SchemaKey_1.SchemaKey(schemaName);
+        }
+        else {
+            schemaKey = schemaNameOrKey.schemaKey;
+        }
+        const schema = await this.getSchema(schemaKey, ECObjects_1.SchemaMatchType.Latest);
+        if (!schema)
             return undefined;
-        return schema.getItem(schemaItemKey.name);
+        if (typeof itemNameOrCtor === "string") // Separate schema and item name arguments with/without an itemConstructor
+            return itemConstructor ? schema.getItem(itemNameOrCtor, itemConstructor) : schema.getItem(itemNameOrCtor);
+        if (typeof schemaNameOrKey === "string") // Single schema item full name argument with/without an itemConstructor
+            return itemNameOrCtor ? schema.lookupItem(schemaNameOrKey, itemNameOrCtor) : schema.lookupItem(schemaNameOrKey);
+        // Schema Item Key with/without an itemConstructor
+        return itemNameOrCtor ? schema.getItem(schemaNameOrKey.name, itemNameOrCtor) : schema.getItem(schemaNameOrKey.name);
     }
-    /**
-     * Gets the schema item from the specified schema if it exists in this [[SchemaContext]].
-     * Will skip a partially loaded schema and return undefined if the item belongs to that schema.  Use the async method to await partially loaded schemas.
-     * @param schemaItemKey The SchemaItemKey identifying the item to return.  SchemaMatchType.Latest is used to match the schema.
-     * @returns The requested schema item
-     */
-    getSchemaItemSync(schemaItemKey) {
-        const schema = this.getSchemaSync(schemaItemKey.schemaKey, ECObjects_1.SchemaMatchType.Latest);
-        if (undefined === schema)
+    getSchemaItemSync(schemaNameOrKey, itemNameOrCtor, itemConstructor) {
+        let schemaKey;
+        if (typeof schemaNameOrKey === "string") {
+            const [schemaName, itemName] = SchemaItem_1.SchemaItem.parseFullName(schemaNameOrKey);
+            schemaKey = (!schemaName) ? new SchemaKey_1.SchemaKey(itemName) : new SchemaKey_1.SchemaKey(schemaName);
+        }
+        else {
+            schemaKey = schemaNameOrKey.schemaKey;
+        }
+        const schema = this.getSchemaSync(schemaKey, ECObjects_1.SchemaMatchType.Latest);
+        if (!schema)
             return undefined;
-        return schema.getItemSync(schemaItemKey.name);
+        // Separate schema and item name arguments with/without an itemConstructor
+        if (typeof itemNameOrCtor === "string") {
+            return itemConstructor ? schema.getItemSync(itemNameOrCtor, itemConstructor) : schema.getItemSync(itemNameOrCtor);
+        }
+        if (typeof schemaNameOrKey === "string") // Single schema item full name argument with/without an itemConstructor
+            return itemNameOrCtor ? schema.lookupItemSync(schemaNameOrKey, itemNameOrCtor) : schema.lookupItemSync(schemaNameOrKey);
+        // Schema Item Key with/without an itemConstructor
+        return itemNameOrCtor ? schema.getItemSync(schemaNameOrKey.name, itemNameOrCtor) : schema.getItemSync(schemaNameOrKey.name);
     }
     /**
      * Iterates through the items of each schema known to the context.  This includes schemas added to the