@itwin/ecschema-rpcinterface-tests 4.0.0-dev.103 → 4.0.0-dev.105

package/lib/dist/bundled-tests.js

@@ -59083,40 +59083,82 @@ exports.ECStringConstants = ECStringConstants;
 * See LICENSE.md in the project root for license terms and full copyright notice.
 *--------------------------------------------------------------------------------------------*/
 Object.defineProperty(exports, "__esModule", ({ value: true }));
-exports.SchemaContext = exports.SchemaCache = exports.SchemaMap = void 0;
+exports.SchemaContext = exports.SchemaCache = void 0;
 const ECObjects_1 = __webpack_require__(/*! ./ECObjects */ "../../core/ecschema-metadata/lib/cjs/ECObjects.js");
 const Exception_1 = __webpack_require__(/*! ./Exception */ "../../core/ecschema-metadata/lib/cjs/Exception.js");
 /**
- * @beta
+ * @internal
  */
 class SchemaMap extends Array {
 }
-exports.SchemaMap = SchemaMap;
 /**
- * @beta
+ * @internal
  */
 class SchemaCache {
     constructor() {
         this._schema = new SchemaMap();
     }
     get count() { return this._schema.length; }
+    loadedSchemaExists(schemaKey) {
+        return undefined !== this._schema.find((entry) => entry.schemaInfo.schemaKey.matches(schemaKey, ECObjects_1.SchemaMatchType.Latest) && !entry.schemaPromise);
+    }
+    schemaPromiseExists(schemaKey) {
+        return undefined !== this._schema.find((entry) => entry.schemaInfo.schemaKey.matches(schemaKey, ECObjects_1.SchemaMatchType.Latest) && undefined !== entry.schemaPromise);
+    }
+    findEntry(schemaKey, matchType) {
+        return this._schema.find((entry) => entry.schemaInfo.schemaKey.matches(schemaKey, matchType));
+    }
+    removeSchemaPromise(schemaKey) {
+        const entry = this.findEntry(schemaKey, ECObjects_1.SchemaMatchType.Latest);
+        if (entry)
+            entry.schemaPromise = undefined;
+    }
+    removeEntry(schemaKey) {
+        this._schema = this._schema.filter((entry) => !entry.schemaInfo.schemaKey.matches(schemaKey));
+    }
+    /**
+     * 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) {
+        return this.loadedSchemaExists(schemaKey) || this.schemaPromiseExists(schemaKey);
+    }
+    /**
+     * 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
+     * @param schemaInfo An object with the schema key for the schema being loaded and it's references
+     * @param schema The partially loaded schema that the promise will fulfill
+     * @param schemaPromise The schema promise to add to the cache.
+     */
+    async addSchemaPromise(schemaInfo, schema, schemaPromise) {
+        if (this.schemaExists(schemaInfo.schemaKey))
+            throw new Exception_1.ECObjectsError(Exception_1.ECObjectsStatus.DuplicateSchema, `The schema, ${schemaPromise.toString()}, already exists within this cache.`);
+        this._schema.push({ schemaInfo, schema, schemaPromise });
+        // This promise is cached and will be awaited when the user requests the full schema.
+        // If the promise competes successfully before the user requests the schema it will be removed from the cache
+        // If it fails it will remain in the cache until the user awaits it and handles the error
+        // eslint-disable-next-line @typescript-eslint/no-floating-promises
+        schemaPromise.then(() => {
+            this.removeSchemaPromise(schemaInfo.schemaKey);
+        });
+    }
     /**
      * 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.
      */
     async addSchema(schema) {
-        if (await this.getSchema(schema.schemaKey))
+        if (this.schemaExists(schema.schemaKey))
             throw new Exception_1.ECObjectsError(Exception_1.ECObjectsStatus.DuplicateSchema, `The schema, ${schema.schemaKey.toString()}, already exists within this cache.`);
-        this._schema.push(schema);
+        this._schema.push({ schemaInfo: schema, schema });
     }
     /**
      * 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(schema) {
-        if (this.getSchemaSync(schema.schemaKey))
+        if (this.schemaExists(schema.schemaKey))
             throw new Exception_1.ECObjectsError(Exception_1.ECObjectsStatus.DuplicateSchema, `The schema, ${schema.schemaKey.toString()}, already exists within this cache.`);
-        this._schema.push(schema);
+        this._schema.push({ schemaInfo: schema, schema });
     }
     /**
      * Gets the schema which matches the provided SchemaKey.
@@ -59126,46 +59168,69 @@ class SchemaCache {
     async getSchema(schemaKey, matchType = ECObjects_1.SchemaMatchType.Latest) {
         if (this.count === 0)
             return undefined;
-        const findFunc = (schema) => {
-            return schema.schemaKey.matches(schemaKey, matchType);
-        };
-        const foundSchema = this._schema.find(findFunc);
-        if (!foundSchema)
+        const entry = this.findEntry(schemaKey, matchType);
+        if (!entry)
             return undefined;
-        return foundSchema;
+        if (entry.schemaPromise) {
+            try {
+                const schema = await entry.schemaPromise;
+                return schema;
+            }
+            catch (e) {
+                this.removeEntry(schemaKey);
+                throw e;
+            }
+        }
+        return entry.schema;
     }
     /**
-     *
-     * @param schemaKey
-     * @param matchType
+      * 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
+      */
+    async getSchemaInfo(schemaKey, matchType = ECObjects_1.SchemaMatchType.Latest) {
+        if (this.count === 0)
+            return undefined;
+        const entry = this.findEntry(schemaKey, matchType);
+        if (entry)
+            return entry.schemaInfo;
+        return 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(schemaKey, matchType = ECObjects_1.SchemaMatchType.Latest) {
         if (this.count === 0)
             return undefined;
-        const findFunc = (schema) => {
-            return schema.schemaKey.matches(schemaKey, matchType);
-        };
-        const foundSchema = this._schema.find(findFunc);
-        if (!foundSchema)
-            return foundSchema;
-        return foundSchema;
+        const entry = this.findEntry(schemaKey, matchType);
+        if (entry) {
+            if (entry.schemaPromise) {
+                throw new Exception_1.ECObjectsError(Exception_1.ECObjectsStatus.UnableToLoadSchema, `The Schema ${schemaKey.toString()} is partially loaded so cannot be loaded synchronously.`);
+            }
+            return entry.schema;
+        }
+        return undefined;
     }
     /**
-     * Generator function that can iterate through each schema in _schema SchemaMap and items for each Schema
+     * 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() {
-        for (const schema of this._schema) {
-            for (const schemaItem of schema.getItems()) {
+        for (const entry of this._schema) {
+            for (const schemaItem of entry.schema.getItems()) {
                 yield 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() {
-        return this._schema;
+        return this._schema.map((entry) => entry.schema);
     }
 }
 exports.SchemaCache = SchemaCache;
@@ -59187,7 +59252,7 @@ class SchemaContext {
         this._locaters.push(locater);
     }
     /**
-     * Adds the schema to this context
+     * Adds the schema to this context.  Use addSchemaPromise instead when asynchronously loading schemas.
      * @param schema The schema to add to this context
      */
     async addSchema(schema) {
@@ -59203,6 +59268,7 @@ class SchemaContext {
     /**
      * Adds the given SchemaItem to the the SchemaContext by locating the schema, with the best match of SchemaMatchType.Exact, and
      * @param schemaItem The SchemaItem to add
+     * @deprecated in 4.0 use ecschema-editing package
      */
     async addSchemaItem(schemaItem) {
         const schema = await this.getSchema(schemaItem.key.schemaKey, ECObjects_1.SchemaMatchType.Exact);
@@ -59210,6 +59276,24 @@ class SchemaContext {
             throw new Exception_1.ECObjectsError(Exception_1.ECObjectsStatus.UnableToLocateSchema, `Unable to add the schema item ${schemaItem.name} to the schema ${schemaItem.key.schemaKey.toString()} because the schema could not be located.`);
         schema.addItem(schemaItem);
     }
+    /**
+     * Returns true if the schema is already in the context.  SchemaMatchType.Latest is used to find a match.
+     * @param schemaKey
+     */
+    schemaExists(schemaKey) {
+        return this._knownSchemas.schemaExists(schemaKey);
+    }
+    /**
+     * 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.
+     * Use this method over addSchema when asynchronously loading schemas
+     * @param schemaInfo An object with the schema key for the schema being loaded and it's references
+     * @param schema The partially loaded schema that the promise will fulfill
+     * @param schemaPromise The schema promise to add to the cache.
+     */
+    async addSchemaPromise(schemaInfo, schema, schemaPromise) {
+        return this._knownSchemas.addSchemaPromise(schemaInfo, schema, schemaPromise);
+    }
     /**
      *
      * @param schemaKey
@@ -59223,6 +59307,20 @@ class SchemaContext {
         }
         return 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 the getCachedSchema method.
+     * @param schemaKey The SchemaKey describing the schema to get from the cache.
+     * @param matchType The match type to use when locating the schema
+     */
+    async getSchemaInfo(schemaKey, matchType) {
+        for (const locater of this._locaters) {
+            const schemaInfo = await locater.getSchemaInfo(schemaKey, matchType, this);
+            if (undefined !== schemaInfo)
+                return schemaInfo;
+        }
+        return undefined;
+    }
     /**
      *
      * @param schemaKey
@@ -59238,42 +59336,62 @@ class SchemaContext {
     }
     /**
      * Attempts to get a Schema from the context's cache.
+     * Will await a partially loaded schema then return when it is completely loaded.
      * @param schemaKey The SchemaKey to identify the Schema.
      * @param matchType The SchemaMatch type to use. Default is SchemaMatchType.Latest.
      * @internal
      */
     async getCachedSchema(schemaKey, matchType = ECObjects_1.SchemaMatchType.Latest) {
-        return this.getCachedSchemaSync(schemaKey, matchType);
+        return this._knownSchemas.getSchema(schemaKey, matchType);
     }
     /**
      * Attempts to get a Schema from the context's cache.
+     * Will return undefined if the cached schema is partially loaded.  Use the async method to await partially loaded schemas.
      * @param schemaKey The SchemaKey to identify the Schema.
      * @param matchType The SchemaMatch type to use. Default is SchemaMatchType.Latest.
      * @internal
      */
     getCachedSchemaSync(schemaKey, matchType = ECObjects_1.SchemaMatchType.Latest) {
-        const schema = this._knownSchemas.getSchemaSync(schemaKey, matchType);
-        return schema;
+        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)
             return undefined;
         return schema.getItem(schemaItemKey.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)
             return undefined;
         return schema.getItemSync(schemaItemKey.name);
     }
+    /**
+     * 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() {
         return this._knownSchemas.getSchemaItems();
     }
     /**
      * Gets all the Schemas known by 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.
+     * can be located by an ISchemaLocater instance added to the context.  Does not
+     * include schemas that are partially loaded.
      * @returns An array of Schema objects.
      */
     getKnownSchemas() {
@@ -59443,11 +59561,13 @@ class SchemaReadHelper {
         this._parserType = parserType;
     }
     /**
-     * Populates the given Schema from a serialized representation.
+     * Creates a complete SchemaInfo and starts parsing the schema from a serialized representation.
+     * The info and schema promise will be registered with the SchemaContext.  The complete schema can be retrieved by
+     * calling getCachedSchema on the context.
      * @param schema The Schema to populate
      * @param rawSchema The serialized data to use to populate the Schema.
      */
-    async readSchema(schema, rawSchema) {
+    async readSchemaInfo(schema, rawSchema) {
         // Ensure context matches schema context
         if (schema.context) {
             if (this._context !== schema.context)
@@ -59460,12 +59580,38 @@ class SchemaReadHelper {
         // Loads all of the properties on the Schema object
         await schema.fromJSON(this._parser.parseSchema());
         this._schema = schema;
-        // Need to add this schema to the context to be able to locate schemaItems within the context.
-        await this._context.addSchema(schema);
-        // Load schema references first
-        // Need to figure out if other schemas are present.
+        const schemaInfo = { schemaKey: schema.schemaKey, references: [] };
         for (const reference of this._parser.getReferences()) {
-            await this.loadSchemaReference(reference);
+            const refKey = new SchemaKey_1.SchemaKey(reference.name, SchemaKey_1.ECVersion.fromString(reference.version));
+            schemaInfo.references.push({ schemaKey: refKey });
+        }
+        this._schemaInfo = schemaInfo;
+        // Need to add this schema to the context to be able to locate schemaItems within the context.
+        if (!this._context.schemaExists(schema.schemaKey)) {
+            await this._context.addSchemaPromise(schemaInfo, schema, this.loadSchema(schemaInfo, schema));
+        }
+        return schemaInfo;
+    }
+    /**
+     * Populates the given Schema from a serialized representation.
+     * @param schema The Schema to populate
+     * @param rawSchema The serialized data to use to populate the Schema.
+     */
+    async readSchema(schema, rawSchema) {
+        if (!this._schemaInfo) {
+            await this.readSchemaInfo(schema, rawSchema);
+        }
+        const cachedSchema = await this._context.getCachedSchema(this._schemaInfo.schemaKey, ECObjects_1.SchemaMatchType.Latest);
+        if (undefined === cachedSchema)
+            throw new Exception_1.ECObjectsError(Exception_1.ECObjectsStatus.UnableToLoadSchema, `Could not load schema ${schema.schemaKey.toString()}`);
+        return cachedSchema;
+    }
+    /* Finish loading the rest of the schema */
+    async loadSchema(schemaInfo, schema) {
+        // Verify that there are no schema reference cycles, this will start schema loading by loading their headers
+        (await SchemaGraph_1.SchemaGraph.generateGraph(schemaInfo, this._context)).throwIfCycles();
+        for (const reference of schemaInfo.references) {
+            await this.loadSchemaReference(schemaInfo, reference.schemaKey);
         }
         if (this._visitorHelper)
             await this._visitorHelper.visitSchema(schema, false);
@@ -59524,11 +59670,10 @@ class SchemaReadHelper {
      * Ensures that the schema references can be located and adds them to the schema.
      * @param ref The object to read the SchemaReference's props from.
      */
-    async loadSchemaReference(ref) {
-        const schemaKey = new SchemaKey_1.SchemaKey(ref.name, SchemaKey_1.ECVersion.fromString(ref.version));
-        const refSchema = await this._context.getSchema(schemaKey, ECObjects_1.SchemaMatchType.LatestWriteCompatible);
+    async loadSchemaReference(schemaInfo, refKey) {
+        const refSchema = await this._context.getSchema(refKey, ECObjects_1.SchemaMatchType.LatestWriteCompatible);
         if (undefined === refSchema)
-            throw new Exception_1.ECObjectsError(Exception_1.ECObjectsStatus.UnableToLocateSchema, `Could not locate the referenced schema, ${ref.name}.${ref.version}, of ${this._schema.schemaKey.name}`);
+            throw new Exception_1.ECObjectsError(Exception_1.ECObjectsStatus.UnableToLocateSchema, `Could not locate the referenced schema, ${refKey.name}.${refKey.version.toString()}, of ${schemaInfo.schemaKey.name}`);
         await this._schema.addReference(refSchema);
         const results = this.validateSchemaReferences(this._schema);
         let errorMessage = "";
@@ -59549,6 +59694,7 @@ class SchemaReadHelper {
         if (!refSchema)
             throw new Exception_1.ECObjectsError(Exception_1.ECObjectsStatus.UnableToLocateSchema, `Could not locate the referenced schema, ${ref.name}.${ref.version}, of ${this._schema.schemaKey.name}`);
         this._schema.addReferenceSync(refSchema);
+        SchemaGraph_1.SchemaGraph.generateGraphSync(this._schema).throwIfCycles();
         const results = this.validateSchemaReferences(this._schema);
         let errorMessage = "";
         for (const result of results) {
@@ -59577,12 +59723,6 @@ class SchemaReadHelper {
                 aliases.set(schemaRef.alias, schemaRef);
             }
         }
-        const graph = new SchemaGraph_1.SchemaGraph(schema);
-        const cycles = graph.detectCycles();
-        if (cycles) {
-            const result = cycles.map((cycle) => `${cycle.schema.name} --> ${cycle.refSchema.name}`).join(", ");
-            yield `Schema '${schema.name}' has reference cycles: ${result}`;
-        }
     }
     /**
      * Given the schema item object, the anticipated type and the name a schema item is created and loaded into the schema provided.
@@ -59767,7 +59907,10 @@ class SchemaReadHelper {
         const isInThisSchema = (this._schema && this._schema.name.toLowerCase() === schemaName.toLowerCase());
         if (undefined === schemaName || 0 === schemaName.length)
             throw new Exception_1.ECObjectsError(Exception_1.ECObjectsStatus.InvalidECJson, `The SchemaItem ${name} is invalid without a schema name`);
-        if (isInThisSchema && undefined === await this._schema.getItem(itemName)) {
+        if (isInThisSchema) {
+            schemaItem = await this._schema.getItem(itemName);
+            if (schemaItem)
+                return schemaItem;
             const foundItem = this._parser.findItem(itemName);
             if (foundItem) {
                 schemaItem = await this.loadSchemaItem(this._schema, ...foundItem);
@@ -62841,6 +62984,7 @@ var ECObjectsStatus;
     ECObjectsStatus[ECObjectsStatus["InvalidSchemaComparisonArgument"] = 35077] = "InvalidSchemaComparisonArgument";
     ECObjectsStatus[ECObjectsStatus["InvalidSchemaAlias"] = 35078] = "InvalidSchemaAlias";
     ECObjectsStatus[ECObjectsStatus["InvalidSchemaKey"] = 35079] = "InvalidSchemaKey";
+    ECObjectsStatus[ECObjectsStatus["UnableToLoadSchema"] = 35080] = "UnableToLoadSchema";
 })(ECObjectsStatus = exports.ECObjectsStatus || (exports.ECObjectsStatus = {}));
 /** @internal */
 class ECObjectsError extends core_bentley_1.BentleyError {
@@ -66466,6 +66610,9 @@ class Schema {
         schemaXml.appendChild(schemaMetadata);
         return schemaXml;
     }
+    /**
+     * Loads the schema header (name, version alias, label and description) from the input SchemaProps
+     */
     fromJSONSync(schemaProps) {
         if (undefined === this._schemaKey) {
             const schemaName = schemaProps.name;
@@ -66491,9 +66638,22 @@ class Schema {
         if (undefined !== schemaProps.description)
             this._description = schemaProps.description;
     }
+    /**
+     * Loads the schema header (name, version alias, label and description) from the input SchemaProps
+     */
     async fromJSON(schemaProps) {
         this.fromJSONSync(schemaProps);
     }
+    /**
+     * Completely loads the SchemaInfo from the input json and starts loading the entire schema.  The complete schema can be retrieved from the
+     * schema context using the getCachedSchema method
+     */
+    static async startLoadingFromJson(jsonObj, context) {
+        const schema = new Schema(context);
+        const reader = new Helper_1.SchemaReadHelper(JsonParser_1.JsonParser, context);
+        const rawSchema = typeof jsonObj === "string" ? JSON.parse(jsonObj) : jsonObj;
+        return reader.readSchemaInfo(schema, rawSchema);
+    }
     static async fromJson(jsonObj, context) {
         let schema = new Schema(context);
         const reader = new Helper_1.SchemaReadHelper(JsonParser_1.JsonParser, context);
@@ -66501,6 +66661,9 @@ class Schema {
         schema = await reader.readSchema(schema, rawSchema);
         return schema;
     }
+    /**
+     * Completely loads the Schema from the input json. The schema is cached in the schema context.
+     */
     static fromJsonSync(jsonObj, context) {
         let schema = new Schema(context);
         const reader = new Helper_1.SchemaReadHelper(JsonParser_1.JsonParser, context);
@@ -67026,6 +67189,14 @@ class SchemaJsonLocater {
     async getSchema(schemaKey, matchType, context) {
         return this.getSchemaSync(schemaKey, matchType, context);
     }
+    /**
+     * 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
+     */
+    async getSchemaInfo(schemaKey, matchType, context) {
+        return this.getSchema(schemaKey, matchType, context);
+    }
     /** Get a schema by [SchemaKey] synchronously.
      * @param schemaKey The [SchemaKey] that identifies the schema.
      * * @param matchType The [SchemaMatchType] to used for comparing schema versions.
@@ -68522,7 +68693,7 @@ Object.defineProperty(exports, "SchemaGraph", ({ enumerable: true, get: function
 /*!*****************************************************************!*\
   !*** ../../core/ecschema-metadata/lib/cjs/utils/SchemaGraph.js ***!
   \*****************************************************************/
-/***/ ((__unused_webpack_module, exports) => {
+/***/ ((__unused_webpack_module, exports, __webpack_require__) => {
 
 "use strict";
 
@@ -68532,22 +68703,32 @@ Object.defineProperty(exports, "SchemaGraph", ({ enumerable: true, get: function
 *--------------------------------------------------------------------------------------------*/
 Object.defineProperty(exports, "__esModule", ({ value: true }));
 exports.SchemaGraph = void 0;
+const ECObjects_1 = __webpack_require__(/*! ../ECObjects */ "../../core/ecschema-metadata/lib/cjs/ECObjects.js");
+const Exception_1 = __webpack_require__(/*! ../Exception */ "../../core/ecschema-metadata/lib/cjs/Exception.js");
 /**
  * Utility class for detecting cyclic references in a Schema graph.
- * @beta
+ * @internal
  */
 class SchemaGraph {
+    constructor() {
+        this._schemas = [];
+    }
+    find(schemaKey) {
+        return this._schemas.find((info) => info.schemaKey.matches(schemaKey, ECObjects_1.SchemaMatchType.Latest));
+    }
     /**
-     * Initializes a new SchemaGraph instance.
-     * @param schema The schema to analyze.
+     * Detected cyclic references in a schema and throw an exception if a cycle is found.
      */
-    constructor(schema) {
-        this._schemas = [];
-        this.populateGraph(schema);
+    throwIfCycles() {
+        const cycles = this.detectCycles();
+        if (cycles) {
+            const result = cycles.map((cycle) => `${cycle.schema.schemaKey.name} --> ${cycle.refSchema.schemaKey.name}`).join(", ");
+            throw new Exception_1.ECObjectsError(Exception_1.ECObjectsStatus.InvalidECJson, `Schema '${this._schemas[0].schemaKey.name}' has reference cycles: ${result}`);
+        }
     }
     /**
      * Detected cyclic references in a schema.
-     * @returns True if a cycle is found.
+     * @returns An array describing the cycle if there is a cycle or undefined if no cycles found.
      */
     detectCycles() {
         const visited = {};
@@ -68562,31 +68743,70 @@ class SchemaGraph {
     }
     detectCycleUtil(schema, visited, recStack, cycles) {
         let cycleFound = false;
-        if (!visited[schema.name]) {
-            visited[schema.name] = true;
-            recStack[schema.name] = true;
-            for (const refSchema of schema.references) {
-                if (!visited[refSchema.name] && this.detectCycleUtil(refSchema, visited, recStack, cycles)) {
+        if (!visited[schema.schemaKey.name]) {
+            visited[schema.schemaKey.name] = true;
+            recStack[schema.schemaKey.name] = true;
+            for (const refKey of schema.references) {
+                const refSchema = this.find(refKey.schemaKey);
+                if (undefined === refSchema)
+                    throw new Exception_1.ECObjectsError(Exception_1.ECObjectsStatus.UnableToLoadSchema, `Could not find the schema info for ref schema ${refKey.schemaKey.toString()} for schema ${schema.schemaKey.toString()}`);
+                if (!visited[refKey.schemaKey.name] && this.detectCycleUtil(refSchema, visited, recStack, cycles)) {
                     cycles.push({ schema, refSchema });
                     cycleFound = true;
                 }
-                else if (recStack[refSchema.name]) {
+                else if (recStack[refKey.schemaKey.name]) {
                     cycles.push({ schema, refSchema });
                     cycleFound = true;
                 }
             }
         }
         if (!cycleFound)
-            recStack[schema.name] = false;
+            recStack[schema.schemaKey.name] = false;
         return cycleFound;
     }
-    populateGraph(schema) {
-        if (this._schemas.includes(schema))
-            return;
-        this._schemas.push(schema);
-        for (const refSchema of schema.references) {
-            this.populateGraph(refSchema);
-        }
+    /**
+     * Generates a SchemaGraph for the input schema using the context to find info on referenced schemas.  Use the generateGraphSync if you have the fully loaded Schema.
+     * @param schema The SchemaInfo to build the graph from
+     * @param context The SchemaContext used to locate info on the referenced schemas
+     * @returns A SchemaGraph that can be used to detect schema cycles
+     */
+    static async generateGraph(schema, context) {
+        const graph = new SchemaGraph();
+        const genGraph = async (s) => {
+            if (graph.find(s.schemaKey))
+                return;
+            graph._schemas.push(s);
+            for (const refSchema of s.references) {
+                if (!graph.find(refSchema.schemaKey)) {
+                    const refInfo = await context.getSchemaInfo(refSchema.schemaKey, ECObjects_1.SchemaMatchType.LatestWriteCompatible);
+                    if (undefined === refInfo) {
+                        throw new Exception_1.ECObjectsError(Exception_1.ECObjectsStatus.UnableToLocateSchema, `Could not locate the referenced schema, ${refSchema.schemaKey.name}.${refSchema.schemaKey.version.toString()}, of ${s.schemaKey.name} when populating the graph for ${schema.schemaKey.name}`);
+                    }
+                    await genGraph(refInfo);
+                }
+            }
+        };
+        await genGraph(schema);
+        return graph;
+    }
+    /**
+     * Generates a SchemaGraph for the input schema.  Use the generateGraph if you just have schema info.
+     * @param schema The Schema to build the graph from.
+     * @returns A SchemaGraph that can be used to detect schema cycles
+     */
+    static generateGraphSync(schema) {
+        const graph = new SchemaGraph();
+        const genGraph = (s) => {
+            if (graph.find(s.schemaKey))
+                return;
+            graph._schemas.push(s);
+            for (const refSchema of s.references) {
+                if (!graph.find(refSchema.schemaKey))
+                    genGraph(refSchema);
+            }
+        };
+        genGraph(schema);
+        return graph;
     }
 }
 exports.SchemaGraph = SchemaGraph;
@@ -68690,10 +68910,21 @@ class ECSchemaRpcLocater {
      * @param context The SchemaContext that will control the lifetime of the schema and holds the schema's references, if they exist.
     */
     async getSchema(schemaKey, matchType, context) {
+        await this.getSchemaInfo(schemaKey, matchType, context);
+        const schema = await context.getCachedSchema(schemaKey, matchType);
+        return schema;
+    }
+    /**
+      * 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 accessed via the schema context using the getCachedSchema method.
+      * @param schemaKey The SchemaKey describing the schema to get from the cache.
+      * @param matchType The match type to use when locating the schema
+      */
+    async getSchemaInfo(schemaKey, matchType, context) {
         const schemaJson = await ECSchemaRpcInterface_1.ECSchemaRpcInterface.getClient().getSchemaJSON(this.token, schemaKey.name);
-        const schema = await ecschema_metadata_1.Schema.fromJson(schemaJson, context || new ecschema_metadata_1.SchemaContext());
-        if (schema !== undefined && schema.schemaKey.matches(schemaKey, matchType)) {
-            return schema;
+        const schemaInfo = await ecschema_metadata_1.Schema.startLoadingFromJson(schemaJson, context || new ecschema_metadata_1.SchemaContext());
+        if (schemaInfo !== undefined && schemaInfo.schemaKey.matches(schemaKey, matchType)) {
+            return schemaInfo;
         }
         return undefined;
     }
@@ -72561,9 +72792,13 @@ class AccuSnap {
                 this.aSnapHits.removeCurrentHit();
                 hit = await this.getAccuSnapDetail(this.aSnapHits, out);
             }
+            if (!this._doSnapping)
+                hit = undefined; // Snap no longer requested...
         }
         else if (this.isLocateEnabled) {
             hit = await this.findLocatableHit(ev, false, out); // get next AccuSnap path (or undefined)
+            if (!this.isLocateEnabled)
+                hit = undefined; // Hit no longer requested...
         }
         // set the current hit
         if (hit || this.currHit)
@@ -72584,9 +72819,13 @@ class AccuSnap {
             if (this._doSnapping) {
                 out.snapStatus = this.findHits(ev);
                 hit = (_ElementLocateManager__WEBPACK_IMPORTED_MODULE_2__.SnapStatus.Success !== out.snapStatus) ? undefined : await this.getAccuSnapDetail(this.aSnapHits, out);
+                if (!this._doSnapping)
+                    hit = undefined; // Snap no longer requested...
             }
             else if (this.isLocateEnabled) {
                 hit = await this.findLocatableHit(ev, true, out);
+                if (!this.isLocateEnabled)
+                    hit = undefined; // Hit no longer requested...
             }
         }
         // set the current hit and display the sprite (based on snap's KeypointType)
@@ -282299,7 +282538,7 @@ module.exports = JSON.parse('{"name":"axios","version":"0.21.4","description":"P
 /***/ ((module) => {
 
 "use strict";
-module.exports = JSON.parse('{"name":"@itwin/core-frontend","version":"4.0.0-dev.103","description":"iTwin.js frontend components","main":"lib/cjs/core-frontend.js","module":"lib/esm/core-frontend.js","typings":"lib/cjs/core-frontend","license":"MIT","scripts":{"build":"npm run -s copy:public && npm run -s build:cjs && npm run -s build:esm","build:cjs":"npm run -s copy:js:cjs && tsc 1>&2 --outDir lib/cjs","build:esm":"npm run -s copy:js:esm && tsc 1>&2 --module ES2020 --outDir lib/esm","clean":"rimraf lib .rush/temp/package-deps*.json","copy:public":"cpx \\"./src/public/**/*\\" ./lib/public","copy:js:cjs":"cpx \\"./src/**/*.js\\" ./lib/cjs","copy:js:esm":"cpx \\"./src/**/*.js\\" ./lib/esm","docs":"betools docs --includes=../../generated-docs/extract --json=../../generated-docs/core/core-frontend/file.json --tsIndexFile=./core-frontend.ts --onlyJson --excludes=webgl/**/*,**/primitives,**/map/*.d.ts,**/tile/*.d.ts,**/*-css.ts","extract-api":"betools extract-api --entry=core-frontend && npm run extract-extension-api","extract-extension-api":"eslint --no-eslintrc -c \\"./node_modules/@itwin/eslint-plugin/dist/configs/extension-exports-config.js\\" \\"./src/**/*.ts\\" 1>&2","lint":"eslint -f visualstudio \\"./src/**/*.ts\\" 1>&2","pseudolocalize":"betools pseudolocalize --englishDir ./src/public/locales/en --out ./public/locales/en-PSEUDO","test":"npm run -s webpackTests && certa -r chrome","cover":"npm -s test","test:debug":"certa -r chrome --debug","webpackTests":"webpack --config ./src/test/utils/webpack.config.js 1>&2"},"repository":{"type":"git","url":"https://github.com/iTwin/itwinjs-core.git","directory":"core/frontend"},"keywords":["Bentley","BIM","iModel","digital-twin","iTwin"],"author":{"name":"Bentley Systems, Inc.","url":"http://www.bentley.com"},"peerDependencies":{"@itwin/appui-abstract":"workspace:^4.0.0-dev.103","@itwin/core-bentley":"workspace:^4.0.0-dev.103","@itwin/core-common":"workspace:^4.0.0-dev.103","@itwin/core-geometry":"workspace:^4.0.0-dev.103","@itwin/core-orbitgt":"workspace:^4.0.0-dev.103","@itwin/core-quantity":"workspace:^4.0.0-dev.103"},"//devDependencies":["NOTE: All peerDependencies should also be listed as devDependencies since peerDependencies are not considered by npm install","NOTE: All tools used by scripts in this package must be listed as devDependencies"],"devDependencies":{"@itwin/appui-abstract":"workspace:*","@itwin/build-tools":"workspace:*","@itwin/core-bentley":"workspace:*","@itwin/core-common":"workspace:*","@itwin/core-geometry":"workspace:*","@itwin/core-orbitgt":"workspace:*","@itwin/core-quantity":"workspace:*","@itwin/certa":"workspace:*","@itwin/eslint-plugin":"^4.0.0-dev.33","@types/chai":"4.3.1","@types/chai-as-promised":"^7","@types/mocha":"^8.2.2","@types/node":"^18.11.5","@types/sinon":"^9.0.0","babel-loader":"~8.2.5","babel-plugin-istanbul":"~6.1.1","chai":"^4.1.2","chai-as-promised":"^7","cpx2":"^3.0.0","eslint":"^8.36.0","glob":"^7.1.2","mocha":"^10.0.0","nyc":"^15.1.0","rimraf":"^3.0.2","sinon":"^9.0.2","source-map-loader":"^4.0.0","typescript":"~5.0.2","webpack":"^5.76.0"},"//dependencies":["NOTE: these dependencies should be only for things that DO NOT APPEAR IN THE API","NOTE: core-frontend should remain UI technology agnostic, so no react/angular dependencies are allowed"],"dependencies":{"@itwin/object-storage-azure":"^1.5.0","@itwin/cloud-agnostic-core":"^1.5.0","@itwin/object-storage-core":"^1.5.0","@itwin/core-i18n":"workspace:*","@itwin/core-telemetry":"workspace:*","@itwin/webgl-compatibility":"workspace:*","@loaders.gl/core":"^3.1.6","@loaders.gl/draco":"^3.1.6","fuse.js":"^3.3.0","wms-capabilities":"0.4.0","reflect-metadata":"0.1.13"},"nyc":{"extends":"./node_modules/@itwin/build-tools/.nycrc"},"eslintConfig":{"plugins":["@itwin"],"extends":"plugin:@itwin/itwinjs-recommended","rules":{"@itwin/no-internal-barrel-imports":["error",{"required-barrel-modules":["./src/tile/internal.ts"]}],"@itwin/public-extension-exports":["error",{"releaseTags":["public","preview"],"outputApiFile":false}]},"overrides":[{"files":["*.test.ts","*.test.tsx","**/test/**/*.ts"],"rules":{"@itwin/no-internal-barrel-imports":"off"}}]}}');
+module.exports = JSON.parse('{"name":"@itwin/core-frontend","version":"4.0.0-dev.105","description":"iTwin.js frontend components","main":"lib/cjs/core-frontend.js","module":"lib/esm/core-frontend.js","typings":"lib/cjs/core-frontend","license":"MIT","scripts":{"build":"npm run -s copy:public && npm run -s build:cjs && npm run -s build:esm","build:cjs":"npm run -s copy:js:cjs && tsc 1>&2 --outDir lib/cjs","build:esm":"npm run -s copy:js:esm && tsc 1>&2 --module ES2020 --outDir lib/esm","clean":"rimraf lib .rush/temp/package-deps*.json","copy:public":"cpx \\"./src/public/**/*\\" ./lib/public","copy:js:cjs":"cpx \\"./src/**/*.js\\" ./lib/cjs","copy:js:esm":"cpx \\"./src/**/*.js\\" ./lib/esm","docs":"betools docs --includes=../../generated-docs/extract --json=../../generated-docs/core/core-frontend/file.json --tsIndexFile=./core-frontend.ts --onlyJson --excludes=webgl/**/*,**/primitives,**/map/*.d.ts,**/tile/*.d.ts,**/*-css.ts","extract-api":"betools extract-api --entry=core-frontend && npm run extract-extension-api","extract-extension-api":"eslint --no-eslintrc -c \\"./node_modules/@itwin/eslint-plugin/dist/configs/extension-exports-config.js\\" \\"./src/**/*.ts\\" 1>&2","lint":"eslint -f visualstudio \\"./src/**/*.ts\\" 1>&2","pseudolocalize":"betools pseudolocalize --englishDir ./src/public/locales/en --out ./public/locales/en-PSEUDO","test":"npm run -s webpackTests && certa -r chrome","cover":"npm -s test","test:debug":"certa -r chrome --debug","webpackTests":"webpack --config ./src/test/utils/webpack.config.js 1>&2"},"repository":{"type":"git","url":"https://github.com/iTwin/itwinjs-core.git","directory":"core/frontend"},"keywords":["Bentley","BIM","iModel","digital-twin","iTwin"],"author":{"name":"Bentley Systems, Inc.","url":"http://www.bentley.com"},"peerDependencies":{"@itwin/appui-abstract":"workspace:^4.0.0-dev.105","@itwin/core-bentley":"workspace:^4.0.0-dev.105","@itwin/core-common":"workspace:^4.0.0-dev.105","@itwin/core-geometry":"workspace:^4.0.0-dev.105","@itwin/core-orbitgt":"workspace:^4.0.0-dev.105","@itwin/core-quantity":"workspace:^4.0.0-dev.105"},"//devDependencies":["NOTE: All peerDependencies should also be listed as devDependencies since peerDependencies are not considered by npm install","NOTE: All tools used by scripts in this package must be listed as devDependencies"],"devDependencies":{"@itwin/appui-abstract":"workspace:*","@itwin/build-tools":"workspace:*","@itwin/core-bentley":"workspace:*","@itwin/core-common":"workspace:*","@itwin/core-geometry":"workspace:*","@itwin/core-orbitgt":"workspace:*","@itwin/core-quantity":"workspace:*","@itwin/certa":"workspace:*","@itwin/eslint-plugin":"^4.0.0-dev.33","@types/chai":"4.3.1","@types/chai-as-promised":"^7","@types/mocha":"^8.2.2","@types/node":"^18.11.5","@types/sinon":"^9.0.0","babel-loader":"~8.2.5","babel-plugin-istanbul":"~6.1.1","chai":"^4.1.2","chai-as-promised":"^7","cpx2":"^3.0.0","eslint":"^8.36.0","glob":"^7.1.2","mocha":"^10.0.0","nyc":"^15.1.0","rimraf":"^3.0.2","sinon":"^9.0.2","source-map-loader":"^4.0.0","typescript":"~5.0.2","webpack":"^5.76.0"},"//dependencies":["NOTE: these dependencies should be only for things that DO NOT APPEAR IN THE API","NOTE: core-frontend should remain UI technology agnostic, so no react/angular dependencies are allowed"],"dependencies":{"@itwin/object-storage-azure":"^1.5.0","@itwin/cloud-agnostic-core":"^1.5.0","@itwin/object-storage-core":"^1.5.0","@itwin/core-i18n":"workspace:*","@itwin/core-telemetry":"workspace:*","@itwin/webgl-compatibility":"workspace:*","@loaders.gl/core":"^3.1.6","@loaders.gl/draco":"^3.1.6","fuse.js":"^3.3.0","wms-capabilities":"0.4.0","reflect-metadata":"0.1.13"},"nyc":{"extends":"./node_modules/@itwin/build-tools/.nycrc"},"eslintConfig":{"plugins":["@itwin"],"extends":"plugin:@itwin/itwinjs-recommended","rules":{"@itwin/no-internal-barrel-imports":["error",{"required-barrel-modules":["./src/tile/internal.ts"]}],"@itwin/public-extension-exports":["error",{"releaseTags":["public","preview"],"outputApiFile":false}]},"overrides":[{"files":["*.test.ts","*.test.tsx","**/test/**/*.ts"],"rules":{"@itwin/no-internal-barrel-imports":"off"}}]}}');
 
 /***/ })