@itwin/ecschema-locaters 4.0.0-dev.8 → 4.0.0-dev.80

package/lib/cjs/StubSchemaXmlFileLocater.d.ts

@@ -1,70 +1,70 @@
-import { ISchemaLocater, Schema, SchemaContext, SchemaKey, SchemaMatchType } from "@itwin/ecschema-metadata";
-import { SchemaFileLocater } from "./SchemaFileLocater";
-/**
- * A SchemaLocater implementation for locating XML Schema files
- * from the file system using configurable search paths. Returns only
- * Schemas from XML files with their keys populated.
- * @internal
- */
-export declare class StubSchemaXmlFileLocater extends SchemaFileLocater implements ISchemaLocater {
-    /**
-     * Loads a Schema from an XML file on the file system.
-     * @param schemaPath The path to the Schema file.
-     * @param schemaText Optionally pass in the schema text read from the schema file. If undefined,
-     * the schema will be read from the provided schemaPath.
-     */
-    loadSchema(schemaPath: string, schemaText?: string): Schema;
-    /**
-     * Attempts to retrieve a Schema with the given SchemaKey by using the configured search paths
-     * to locate the XML Schema file from the file system. Returns only Schemas from XML files with
-     * their keys populated.
-     * @param key The SchemaKey of the Schema to retrieve.
-     * @param matchType The SchemaMatchType.
-     * @param context The SchemaContext that will control the lifetime of the schema.
-     */
-    getSchema<T extends Schema>(key: SchemaKey, matchType: SchemaMatchType, context: SchemaContext): Promise<T | undefined>;
-    /**
-     * Attempts to retrieve a Schema with the given SchemaKey by using the configured search paths
-     * to locate the XML Schema file from the file system. Returns only Schemas from XML files with
-     * their keys populated.
-     * @param key The SchemaKey of the Schema to retrieve.
-     * @param matchType The SchemaMatchType.
-     * @param context The SchemaContext that will control the lifetime of the schema.
-     */
-    getSchemaSync<T extends Schema>(key: SchemaKey, matchType: SchemaMatchType, context: SchemaContext): T | undefined;
-    /**
-     * Constructs a SchemaKey based on the information in the Schema XML.
-     * @param schemaXml The Schema XML as a string.
-     */
-    getSchemaKey(schemaXml: string): SchemaKey;
-    /**
-     * Gets an array of SchemaKeys of the Schemas referenced by the given Schema.
-     * @param xmlSchemaKey The SchemaKey of the parent Schema containing the references.
-     */
-    private getSchemaReferenceKeys;
-    /**
-     * Adds schemas to the references collection for the given Schema by locating
-     * the referenced schemas.
-     * @param schema The schema for which to add the references.
-     * @param context The SchemaContext that will control the lifetime of the schema.
-     * @param refMatchType The SchemaMatchType to use when locating schema references.
-     */
-    private addSchemaReferences;
-    /**
-     * Gets an array of SchemaKeys of the Schemas referenced by the given Schema.
-     * @param data The Schema XML string.
-     */
-    private _getSchemaReferenceKeys;
-    /**
-     * Gets the Schema alias from the Schema XML.
-     * @param data The Schema XML as a string.
-     */
-    private getSchemaAlias;
-    /**
-     * Parses a valid EC 2.0 version string and returns an ECVersion object. The second digit becomes the minor version,
-     * and a zero is inserted as the 'write' digit. Example: "1.1" -> "1.0.1".
-     * @param versionString A valid EC 2.0 version string of the format, 'RR.mm'.
-     */
-    private fromECv2String;
-}
+import { ISchemaLocater, Schema, SchemaContext, SchemaKey, SchemaMatchType } from "@itwin/ecschema-metadata";
+import { SchemaFileLocater } from "./SchemaFileLocater";
+/**
+ * A SchemaLocater implementation for locating XML Schema files
+ * from the file system using configurable search paths. Returns only
+ * Schemas from XML files with their keys populated.
+ * @internal
+ */
+export declare class StubSchemaXmlFileLocater extends SchemaFileLocater implements ISchemaLocater {
+    /**
+     * Loads a Schema from an XML file on the file system.
+     * @param schemaPath The path to the Schema file.
+     * @param schemaText Optionally pass in the schema text read from the schema file. If undefined,
+     * the schema will be read from the provided schemaPath.
+     */
+    loadSchema(schemaPath: string, schemaText?: string): Schema;
+    /**
+     * Attempts to retrieve a Schema with the given SchemaKey by using the configured search paths
+     * to locate the XML Schema file from the file system. Returns only Schemas from XML files with
+     * their keys populated.
+     * @param key The SchemaKey of the Schema to retrieve.
+     * @param matchType The SchemaMatchType.
+     * @param context The SchemaContext that will control the lifetime of the schema.
+     */
+    getSchema<T extends Schema>(key: SchemaKey, matchType: SchemaMatchType, context: SchemaContext): Promise<T | undefined>;
+    /**
+     * Attempts to retrieve a Schema with the given SchemaKey by using the configured search paths
+     * to locate the XML Schema file from the file system. Returns only Schemas from XML files with
+     * their keys populated.
+     * @param key The SchemaKey of the Schema to retrieve.
+     * @param matchType The SchemaMatchType.
+     * @param context The SchemaContext that will control the lifetime of the schema.
+     */
+    getSchemaSync<T extends Schema>(key: SchemaKey, matchType: SchemaMatchType, context: SchemaContext): T | undefined;
+    /**
+     * Constructs a SchemaKey based on the information in the Schema XML.
+     * @param schemaXml The Schema XML as a string.
+     */
+    getSchemaKey(schemaXml: string): SchemaKey;
+    /**
+     * Gets an array of SchemaKeys of the Schemas referenced by the given Schema.
+     * @param xmlSchemaKey The SchemaKey of the parent Schema containing the references.
+     */
+    private getSchemaReferenceKeys;
+    /**
+     * Adds schemas to the references collection for the given Schema by locating
+     * the referenced schemas.
+     * @param schema The schema for which to add the references.
+     * @param context The SchemaContext that will control the lifetime of the schema.
+     * @param refMatchType The SchemaMatchType to use when locating schema references.
+     */
+    private addSchemaReferences;
+    /**
+     * Gets an array of SchemaKeys of the Schemas referenced by the given Schema.
+     * @param data The Schema XML string.
+     */
+    private _getSchemaReferenceKeys;
+    /**
+     * Gets the Schema alias from the Schema XML.
+     * @param data The Schema XML as a string.
+     */
+    private getSchemaAlias;
+    /**
+     * Parses a valid EC 2.0 version string and returns an ECVersion object. The second digit becomes the minor version,
+     * and a zero is inserted as the 'write' digit. Example: "1.1" -> "1.0.1".
+     * @param versionString A valid EC 2.0 version string of the format, 'RR.mm'.
+     */
+    private fromECv2String;
+}
 //# sourceMappingURL=StubSchemaXmlFileLocater.d.ts.map

package/lib/cjs/StubSchemaXmlFileLocater.js

@@ -1,178 +1,178 @@
-"use strict";
-/*---------------------------------------------------------------------------------------------
-* 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.StubSchemaXmlFileLocater = void 0;
-const path = require("path");
-const ecschema_metadata_1 = require("@itwin/ecschema-metadata");
-const SchemaFileLocater_1 = require("./SchemaFileLocater");
-/** @packageDocumentation
- * @module Locaters
- */
-function isECv2Schema(schemaText) {
-    return /<ECSchema[^>]*xmlns=".*ECXML.2.0"/.test(schemaText);
-}
-/**
- * A SchemaLocater implementation for locating XML Schema files
- * from the file system using configurable search paths. Returns only
- * Schemas from XML files with their keys populated.
- * @internal
- */
-class StubSchemaXmlFileLocater extends SchemaFileLocater_1.SchemaFileLocater {
-    /**
-     * Loads a Schema from an XML file on the file system.
-     * @param schemaPath The path to the Schema file.
-     * @param schemaText Optionally pass in the schema text read from the schema file. If undefined,
-     * the schema will be read from the provided schemaPath.
-     */
-    loadSchema(schemaPath, schemaText) {
-        schemaText = schemaText || this.readUtf8FileToStringSync(schemaPath);
-        if (!schemaText)
-            throw new ecschema_metadata_1.ECObjectsError(ecschema_metadata_1.ECObjectsStatus.UnableToLocateSchema, `Unable to locate schema XML file at ${schemaPath}`);
-        this.addSchemaSearchPaths([path.dirname(schemaPath)]);
-        const key = this.getSchemaKey(schemaText);
-        const alias = this.getSchemaAlias(schemaText);
-        const context = new ecschema_metadata_1.SchemaContext();
-        context.addLocater(this);
-        // Load the schema and return it
-        const schema = new ecschema_metadata_1.Schema(context, new SchemaFileLocater_1.FileSchemaKey(key, schemaPath, schemaText), alias);
-        this.addSchemaReferences(schema, context, ecschema_metadata_1.SchemaMatchType.LatestWriteCompatible);
-        return schema;
-    }
-    /**
-     * Attempts to retrieve a Schema with the given SchemaKey by using the configured search paths
-     * to locate the XML Schema file from the file system. Returns only Schemas from XML files with
-     * their keys populated.
-     * @param key The SchemaKey of the Schema to retrieve.
-     * @param matchType The SchemaMatchType.
-     * @param context The SchemaContext that will control the lifetime of the schema.
-     */
-    async getSchema(key, matchType, context) {
-        return this.getSchemaSync(key, matchType, context);
-    }
-    /**
-     * Attempts to retrieve a Schema with the given SchemaKey by using the configured search paths
-     * to locate the XML Schema file from the file system. Returns only Schemas from XML files with
-     * their keys populated.
-     * @param key The SchemaKey of the Schema to retrieve.
-     * @param matchType The SchemaMatchType.
-     * @param context The SchemaContext that will control the lifetime of the schema.
-     */
-    getSchemaSync(key, matchType, context) {
-        const candidates = this.findEligibleSchemaKeys(key, matchType, "xml");
-        if (!candidates || candidates.length === 0)
-            return undefined;
-        const maxCandidate = candidates.sort(this.compareSchemaKeyByVersion)[candidates.length - 1]; // eslint-disable-line @typescript-eslint/unbound-method
-        const alias = this.getSchemaAlias(maxCandidate.schemaText);
-        const schema = new ecschema_metadata_1.Schema(context, maxCandidate, alias);
-        context.addSchemaSync(schema);
-        this.addSchemaReferences(schema, context, ecschema_metadata_1.SchemaMatchType.LatestWriteCompatible);
-        return schema;
-    }
-    /**
-     * Constructs a SchemaKey based on the information in the Schema XML.
-     * @param schemaXml The Schema XML as a string.
-     */
-    getSchemaKey(schemaXml) {
-        const matches = schemaXml.match(/<ECSchema ([^]+?)>/g);
-        if (!matches || matches.length !== 1)
-            throw new ecschema_metadata_1.ECObjectsError(ecschema_metadata_1.ECObjectsStatus.InvalidSchemaXML, `Could not find '<ECSchema>' tag in the given file`);
-        const name = matches[0].match(/schemaName="(.+?)"/);
-        const version = matches[0].match(/version="(.+?)"/);
-        if (!name || name.length !== 2 || !version || version.length !== 2)
-            throw new ecschema_metadata_1.ECObjectsError(ecschema_metadata_1.ECObjectsStatus.InvalidSchemaXML, `Could not find the ECSchema 'schemaName' or 'version' tag in the given file`);
-        let ecVersion;
-        if (isECv2Schema(schemaXml))
-            ecVersion = this.fromECv2String(version[1]);
-        else
-            ecVersion = ecschema_metadata_1.ECVersion.fromString(version[1]);
-        const key = new ecschema_metadata_1.SchemaKey(name[1], ecVersion);
-        return key;
-    }
-    /**
-     * Gets an array of SchemaKeys of the Schemas referenced by the given Schema.
-     * @param xmlSchemaKey The SchemaKey of the parent Schema containing the references.
-     */
-    getSchemaReferenceKeys(schemaKey) {
-        return this._getSchemaReferenceKeys(schemaKey);
-    }
-    /**
-     * Adds schemas to the references collection for the given Schema by locating
-     * the referenced schemas.
-     * @param schema The schema for which to add the references.
-     * @param context The SchemaContext that will control the lifetime of the schema.
-     * @param refMatchType The SchemaMatchType to use when locating schema references.
-     */
-    addSchemaReferences(schema, context, refMatchType) {
-        const refKeys = this.getSchemaReferenceKeys(schema.schemaKey);
-        for (const key of refKeys) {
-            const refSchema = context ? context.getSchemaSync(key, refMatchType) : undefined;
-            if (!refSchema)
-                throw new ecschema_metadata_1.ECObjectsError(ecschema_metadata_1.ECObjectsStatus.UnableToLocateSchema, `Unable to locate referenced schema: ${key.name}.${key.readVersion}.${key.writeVersion}.${key.minorVersion}`);
-            schema.references.push(refSchema);
-        }
-    }
-    /**
-     * Gets an array of SchemaKeys of the Schemas referenced by the given Schema.
-     * @param data The Schema XML string.
-     */
-    _getSchemaReferenceKeys(xmlSchemaKey) {
-        const file = xmlSchemaKey.schemaText;
-        if (!file)
-            throw new ecschema_metadata_1.ECObjectsError(ecschema_metadata_1.ECObjectsStatus.UnableToLocateSchema, `Could not locate the schema file, ${xmlSchemaKey.fileName}, for the schema ${xmlSchemaKey.name}`);
-        const data = file.toString().replace(/(\s*)<!--.*?-->/g, ""); // ignore any comments in the XML file when getting the array of SchemaKeys
-        const keys = [];
-        const matches = data.match(/<ECSchemaReference ([^]+?)\/>/g);
-        if (!matches)
-            return keys;
-        for (const match of matches) {
-            const name = match.match(/name="(.+?)"/);
-            const versionMatch = match.match(/version="(.+?)"/);
-            if (!name || name.length !== 2 || !versionMatch || versionMatch.length !== 2)
-                throw new ecschema_metadata_1.ECObjectsError(ecschema_metadata_1.ECObjectsStatus.InvalidSchemaXML, `Invalid ECSchemaReference xml encountered in the schema file`);
-            // write version maybe missing, so insert "0"
-            let versionString = versionMatch[1];
-            const versionParts = versionString.split(".");
-            if (versionParts.length === 2)
-                versionParts.splice(1, 0, "0");
-            versionString = versionParts.join(".");
-            const key = new ecschema_metadata_1.SchemaKey(name[1], ecschema_metadata_1.ECVersion.fromString(versionString));
-            keys.push(key);
-        }
-        return keys;
-    }
-    /**
-     * Gets the Schema alias from the Schema XML.
-     * @param data The Schema XML as a string.
-     */
-    getSchemaAlias(schemaXml) {
-        let match;
-        if (isECv2Schema(schemaXml)) {
-            match = schemaXml.match(/<ECSchema.*nameSpacePrefix="(?<alias>\w+)"/);
-        }
-        else {
-            match = schemaXml.match(/<ECSchema.*alias="(?<alias>\w+)"/);
-        }
-        if (!match || !match.groups.alias) {
-            throw new ecschema_metadata_1.ECObjectsError(ecschema_metadata_1.ECObjectsStatus.InvalidSchemaXML, `Could not find the ECSchema 'alias' tag in the given file.`);
-        }
-        return match.groups.alias;
-    }
-    /**
-     * Parses a valid EC 2.0 version string and returns an ECVersion object. The second digit becomes the minor version,
-     * and a zero is inserted as the 'write' digit. Example: "1.1" -> "1.0.1".
-     * @param versionString A valid EC 2.0 version string of the format, 'RR.mm'.
-     */
-    fromECv2String(versionString) {
-        const [read, minor] = versionString.split(".");
-        if (!read)
-            throw new ecschema_metadata_1.ECObjectsError(ecschema_metadata_1.ECObjectsStatus.InvalidECVersion, `The read version is missing from version string, ${versionString}`);
-        if (!minor)
-            throw new ecschema_metadata_1.ECObjectsError(ecschema_metadata_1.ECObjectsStatus.InvalidECVersion, `The minor version is missing from version string, ${versionString}`);
-        return new ecschema_metadata_1.ECVersion(+read, 0, +minor);
-    }
-}
-exports.StubSchemaXmlFileLocater = StubSchemaXmlFileLocater;
+"use strict";
+/*---------------------------------------------------------------------------------------------
+* 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.StubSchemaXmlFileLocater = void 0;
+const path = require("path");
+const ecschema_metadata_1 = require("@itwin/ecschema-metadata");
+const SchemaFileLocater_1 = require("./SchemaFileLocater");
+/** @packageDocumentation
+ * @module Locaters
+ */
+function isECv2Schema(schemaText) {
+    return /<ECSchema[^>]*xmlns=".*ECXML.2.0"/.test(schemaText);
+}
+/**
+ * A SchemaLocater implementation for locating XML Schema files
+ * from the file system using configurable search paths. Returns only
+ * Schemas from XML files with their keys populated.
+ * @internal
+ */
+class StubSchemaXmlFileLocater extends SchemaFileLocater_1.SchemaFileLocater {
+    /**
+     * Loads a Schema from an XML file on the file system.
+     * @param schemaPath The path to the Schema file.
+     * @param schemaText Optionally pass in the schema text read from the schema file. If undefined,
+     * the schema will be read from the provided schemaPath.
+     */
+    loadSchema(schemaPath, schemaText) {
+        schemaText = schemaText || this.readUtf8FileToStringSync(schemaPath);
+        if (!schemaText)
+            throw new ecschema_metadata_1.ECObjectsError(ecschema_metadata_1.ECObjectsStatus.UnableToLocateSchema, `Unable to locate schema XML file at ${schemaPath}`);
+        this.addSchemaSearchPaths([path.dirname(schemaPath)]);
+        const key = this.getSchemaKey(schemaText);
+        const alias = this.getSchemaAlias(schemaText);
+        const context = new ecschema_metadata_1.SchemaContext();
+        context.addLocater(this);
+        // Load the schema and return it
+        const schema = new ecschema_metadata_1.Schema(context, new SchemaFileLocater_1.FileSchemaKey(key, schemaPath, schemaText), alias);
+        this.addSchemaReferences(schema, context, ecschema_metadata_1.SchemaMatchType.LatestWriteCompatible);
+        return schema;
+    }
+    /**
+     * Attempts to retrieve a Schema with the given SchemaKey by using the configured search paths
+     * to locate the XML Schema file from the file system. Returns only Schemas from XML files with
+     * their keys populated.
+     * @param key The SchemaKey of the Schema to retrieve.
+     * @param matchType The SchemaMatchType.
+     * @param context The SchemaContext that will control the lifetime of the schema.
+     */
+    async getSchema(key, matchType, context) {
+        return this.getSchemaSync(key, matchType, context);
+    }
+    /**
+     * Attempts to retrieve a Schema with the given SchemaKey by using the configured search paths
+     * to locate the XML Schema file from the file system. Returns only Schemas from XML files with
+     * their keys populated.
+     * @param key The SchemaKey of the Schema to retrieve.
+     * @param matchType The SchemaMatchType.
+     * @param context The SchemaContext that will control the lifetime of the schema.
+     */
+    getSchemaSync(key, matchType, context) {
+        const candidates = this.findEligibleSchemaKeys(key, matchType, "xml");
+        if (!candidates || candidates.length === 0)
+            return undefined;
+        const maxCandidate = candidates.sort(this.compareSchemaKeyByVersion)[candidates.length - 1]; // eslint-disable-line @typescript-eslint/unbound-method
+        const alias = this.getSchemaAlias(maxCandidate.schemaText);
+        const schema = new ecschema_metadata_1.Schema(context, maxCandidate, alias);
+        context.addSchemaSync(schema);
+        this.addSchemaReferences(schema, context, ecschema_metadata_1.SchemaMatchType.LatestWriteCompatible);
+        return schema;
+    }
+    /**
+     * Constructs a SchemaKey based on the information in the Schema XML.
+     * @param schemaXml The Schema XML as a string.
+     */
+    getSchemaKey(schemaXml) {
+        const matches = schemaXml.match(/<ECSchema ([^]+?)>/g);
+        if (!matches || matches.length !== 1)
+            throw new ecschema_metadata_1.ECObjectsError(ecschema_metadata_1.ECObjectsStatus.InvalidSchemaXML, `Could not find '<ECSchema>' tag in the given file`);
+        const name = matches[0].match(/schemaName="(.+?)"/);
+        const version = matches[0].match(/version="(.+?)"/);
+        if (!name || name.length !== 2 || !version || version.length !== 2)
+            throw new ecschema_metadata_1.ECObjectsError(ecschema_metadata_1.ECObjectsStatus.InvalidSchemaXML, `Could not find the ECSchema 'schemaName' or 'version' tag in the given file`);
+        let ecVersion;
+        if (isECv2Schema(schemaXml))
+            ecVersion = this.fromECv2String(version[1]);
+        else
+            ecVersion = ecschema_metadata_1.ECVersion.fromString(version[1]);
+        const key = new ecschema_metadata_1.SchemaKey(name[1], ecVersion);
+        return key;
+    }
+    /**
+     * Gets an array of SchemaKeys of the Schemas referenced by the given Schema.
+     * @param xmlSchemaKey The SchemaKey of the parent Schema containing the references.
+     */
+    getSchemaReferenceKeys(schemaKey) {
+        return this._getSchemaReferenceKeys(schemaKey);
+    }
+    /**
+     * Adds schemas to the references collection for the given Schema by locating
+     * the referenced schemas.
+     * @param schema The schema for which to add the references.
+     * @param context The SchemaContext that will control the lifetime of the schema.
+     * @param refMatchType The SchemaMatchType to use when locating schema references.
+     */
+    addSchemaReferences(schema, context, refMatchType) {
+        const refKeys = this.getSchemaReferenceKeys(schema.schemaKey);
+        for (const key of refKeys) {
+            const refSchema = context ? context.getSchemaSync(key, refMatchType) : undefined;
+            if (!refSchema)
+                throw new ecschema_metadata_1.ECObjectsError(ecschema_metadata_1.ECObjectsStatus.UnableToLocateSchema, `Unable to locate referenced schema: ${key.name}.${key.readVersion}.${key.writeVersion}.${key.minorVersion}`);
+            schema.references.push(refSchema);
+        }
+    }
+    /**
+     * Gets an array of SchemaKeys of the Schemas referenced by the given Schema.
+     * @param data The Schema XML string.
+     */
+    _getSchemaReferenceKeys(xmlSchemaKey) {
+        const file = xmlSchemaKey.schemaText;
+        if (!file)
+            throw new ecschema_metadata_1.ECObjectsError(ecschema_metadata_1.ECObjectsStatus.UnableToLocateSchema, `Could not locate the schema file, ${xmlSchemaKey.fileName}, for the schema ${xmlSchemaKey.name}`);
+        const data = file.toString().replace(/(\s*)<!--.*?-->/g, ""); // ignore any comments in the XML file when getting the array of SchemaKeys
+        const keys = [];
+        const matches = data.match(/<ECSchemaReference ([^]+?)\/>/g);
+        if (!matches)
+            return keys;
+        for (const match of matches) {
+            const name = match.match(/name="(.+?)"/);
+            const versionMatch = match.match(/version="(.+?)"/);
+            if (!name || name.length !== 2 || !versionMatch || versionMatch.length !== 2)
+                throw new ecschema_metadata_1.ECObjectsError(ecschema_metadata_1.ECObjectsStatus.InvalidSchemaXML, `Invalid ECSchemaReference xml encountered in the schema file`);
+            // write version maybe missing, so insert "0"
+            let versionString = versionMatch[1];
+            const versionParts = versionString.split(".");
+            if (versionParts.length === 2)
+                versionParts.splice(1, 0, "0");
+            versionString = versionParts.join(".");
+            const key = new ecschema_metadata_1.SchemaKey(name[1], ecschema_metadata_1.ECVersion.fromString(versionString));
+            keys.push(key);
+        }
+        return keys;
+    }
+    /**
+     * Gets the Schema alias from the Schema XML.
+     * @param data The Schema XML as a string.
+     */
+    getSchemaAlias(schemaXml) {
+        let match;
+        if (isECv2Schema(schemaXml)) {
+            match = schemaXml.match(/<ECSchema.*nameSpacePrefix="(?<alias>\w+)"/);
+        }
+        else {
+            match = schemaXml.match(/<ECSchema.*alias="(?<alias>\w+)"/);
+        }
+        if (!match || !match.groups.alias) {
+            throw new ecschema_metadata_1.ECObjectsError(ecschema_metadata_1.ECObjectsStatus.InvalidSchemaXML, `Could not find the ECSchema 'alias' tag in the given file.`);
+        }
+        return match.groups.alias;
+    }
+    /**
+     * Parses a valid EC 2.0 version string and returns an ECVersion object. The second digit becomes the minor version,
+     * and a zero is inserted as the 'write' digit. Example: "1.1" -> "1.0.1".
+     * @param versionString A valid EC 2.0 version string of the format, 'RR.mm'.
+     */
+    fromECv2String(versionString) {
+        const [read, minor] = versionString.split(".");
+        if (!read)
+            throw new ecschema_metadata_1.ECObjectsError(ecschema_metadata_1.ECObjectsStatus.InvalidECVersion, `The read version is missing from version string, ${versionString}`);
+        if (!minor)
+            throw new ecschema_metadata_1.ECObjectsError(ecschema_metadata_1.ECObjectsStatus.InvalidECVersion, `The minor version is missing from version string, ${versionString}`);
+        return new ecschema_metadata_1.ECVersion(+read, 0, +minor);
+    }
+}
+exports.StubSchemaXmlFileLocater = StubSchemaXmlFileLocater;
 //# sourceMappingURL=StubSchemaXmlFileLocater.js.map

package/lib/cjs/ecschema-locaters.d.ts

@@ -1,18 +1,18 @@
-export * from "./SchemaFileLocater";
-export * from "./SchemaJsonFileLocater";
-export * from "./SchemaXmlFileLocater";
-export * from "./StubSchemaXmlFileLocater";
-/** @docs-package-description
- * The ecschema-locaters package contains classes for locating ECSchemas within a given
- * [SchemaContext](https://www.itwinjs.org/reference/ecschema-metadata/context/schemacontext). Each locater
- * implements the [ISchemaLocater interface](https://www.itwinjs.org/reference/ecschema-metadata/context/ischemalocater/).
- */
-/**
- * @docs-group-description Locaters
- * ISchemaLocater implementations used to locate schemas in a given [SchemaContext](https://www.itwinjs.org/reference/ecschema-metadata/context/schemacontext).
- */
-/**
- * @docs-group-description Utils
- * A set of utility classes used throughout the package.
- */
+export * from "./SchemaFileLocater";
+export * from "./SchemaJsonFileLocater";
+export * from "./SchemaXmlFileLocater";
+export * from "./StubSchemaXmlFileLocater";
+/** @docs-package-description
+ * The ecschema-locaters package contains classes for locating ECSchemas within a given
+ * [SchemaContext](https://www.itwinjs.org/reference/ecschema-metadata/context/schemacontext). Each locater
+ * implements the [ISchemaLocater interface](https://www.itwinjs.org/reference/ecschema-metadata/context/ischemalocater/).
+ */
+/**
+ * @docs-group-description Locaters
+ * ISchemaLocater implementations used to locate schemas in a given [SchemaContext](https://www.itwinjs.org/reference/ecschema-metadata/context/schemacontext).
+ */
+/**
+ * @docs-group-description Utils
+ * A set of utility classes used throughout the package.
+ */
 //# sourceMappingURL=ecschema-locaters.d.ts.map

package/lib/cjs/ecschema-locaters.js

@@ -1,34 +1,38 @@
-"use strict";
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./SchemaFileLocater"), exports);
-__exportStar(require("./SchemaJsonFileLocater"), exports);
-__exportStar(require("./SchemaXmlFileLocater"), exports);
-__exportStar(require("./StubSchemaXmlFileLocater"), exports);
-/** @docs-package-description
- * The ecschema-locaters package contains classes for locating ECSchemas within a given
- * [SchemaContext](https://www.itwinjs.org/reference/ecschema-metadata/context/schemacontext). Each locater
- * implements the [ISchemaLocater interface](https://www.itwinjs.org/reference/ecschema-metadata/context/ischemalocater/).
- */
-/**
- * @docs-group-description Locaters
- * ISchemaLocater implementations used to locate schemas in a given [SchemaContext](https://www.itwinjs.org/reference/ecschema-metadata/context/schemacontext).
- */
-/**
- * @docs-group-description Utils
- * A set of utility classes used throughout the package.
- */
+"use strict";
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./SchemaFileLocater"), exports);
+__exportStar(require("./SchemaJsonFileLocater"), exports);
+__exportStar(require("./SchemaXmlFileLocater"), exports);
+__exportStar(require("./StubSchemaXmlFileLocater"), exports);
+/** @docs-package-description
+ * The ecschema-locaters package contains classes for locating ECSchemas within a given
+ * [SchemaContext](https://www.itwinjs.org/reference/ecschema-metadata/context/schemacontext). Each locater
+ * implements the [ISchemaLocater interface](https://www.itwinjs.org/reference/ecschema-metadata/context/ischemalocater/).
+ */
+/**
+ * @docs-group-description Locaters
+ * ISchemaLocater implementations used to locate schemas in a given [SchemaContext](https://www.itwinjs.org/reference/ecschema-metadata/context/schemacontext).
+ */
+/**
+ * @docs-group-description Utils
+ * A set of utility classes used throughout the package.
+ */
 //# sourceMappingURL=ecschema-locaters.js.map

package/lib/cjs/ecschema-locaters.js.map

@@ -1 +1 @@
-{"version":3,"file":"ecschema-locaters.js","sourceRoot":"","sources":["../../src/ecschema-locaters.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;;;;;;;;;;;;AAE/F,sDAAoC;AACpC,0DAAwC;AACxC,yDAAuC;AACvC,6DAA2C;AAE3C;;;;GAIG;AACH;;;GAGG;AACH;;;GAGG","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\nexport * from \"./SchemaFileLocater\";\r\nexport * from \"./SchemaJsonFileLocater\";\r\nexport * from \"./SchemaXmlFileLocater\";\r\nexport * from \"./StubSchemaXmlFileLocater\";\r\n\r\n/** @docs-package-description\r\n * The ecschema-locaters package contains classes for locating ECSchemas within a given\r\n * [SchemaContext](https://www.itwinjs.org/reference/ecschema-metadata/context/schemacontext). Each locater\r\n * implements the [ISchemaLocater interface](https://www.itwinjs.org/reference/ecschema-metadata/context/ischemalocater/).\r\n */\r\n/**\r\n * @docs-group-description Locaters\r\n * ISchemaLocater implementations used to locate schemas in a given [SchemaContext](https://www.itwinjs.org/reference/ecschema-metadata/context/schemacontext).\r\n */\r\n/**\r\n * @docs-group-description Utils\r\n * A set of utility classes used throughout the package.\r\n */\r\n"]}
+{"version":3,"file":"ecschema-locaters.js","sourceRoot":"","sources":["../../src/ecschema-locaters.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;;;;;;;;;;;;;;;;AAE/F,sDAAoC;AACpC,0DAAwC;AACxC,yDAAuC;AACvC,6DAA2C;AAE3C;;;;GAIG;AACH;;;GAGG;AACH;;;GAGG","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\nexport * from \"./SchemaFileLocater\";\r\nexport * from \"./SchemaJsonFileLocater\";\r\nexport * from \"./SchemaXmlFileLocater\";\r\nexport * from \"./StubSchemaXmlFileLocater\";\r\n\r\n/** @docs-package-description\r\n * The ecschema-locaters package contains classes for locating ECSchemas within a given\r\n * [SchemaContext](https://www.itwinjs.org/reference/ecschema-metadata/context/schemacontext). Each locater\r\n * implements the [ISchemaLocater interface](https://www.itwinjs.org/reference/ecschema-metadata/context/ischemalocater/).\r\n */\r\n/**\r\n * @docs-group-description Locaters\r\n * ISchemaLocater implementations used to locate schemas in a given [SchemaContext](https://www.itwinjs.org/reference/ecschema-metadata/context/schemacontext).\r\n */\r\n/**\r\n * @docs-group-description Utils\r\n * A set of utility classes used throughout the package.\r\n */\r\n"]}

package/lib/cjs/test/SchemaFileUtility.test.d.ts

@@ -1,2 +1,2 @@
-export {};
+export {};
 //# sourceMappingURL=SchemaFileUtility.test.d.ts.map