@itwin/ecschema-metadata 5.11.0-dev.3 → 5.11.0-dev.5

package/CHANGELOG.md

@@ -1,6 +1,16 @@
 # Change Log - @itwin/ecschema-metadata
 
-This log was last generated on Mon, 01 Jun 2026 17:37:05 GMT and should not be manually modified.
+This log was last generated on Wed, 03 Jun 2026 20:21:39 GMT and should not be manually modified.
+
+## 5.10.0
+Wed, 03 Jun 2026 20:19:46 GMT
+
+### Updates
+
+- UnitConversion, parseDefinition, and Graph now re-exported from @itwin/core-quantity. UnitConversion.from() signature uses UnitConversionSource interface (structural typing — no consumer changes needed). No public API changes.
+- Use units schema 01.00.10
+- Add a SchemaView layer
+- Document the units schema update for volume-per-length conversion metadata.
 
 ## 5.9.5
 Mon, 01 Jun 2026 17:34:00 GMT

package/lib/cjs/Localization/LocalizationProvider.d.ts

@@ -0,0 +1,31 @@
+import { SchemaLocalizationJson } from "./LocalizationTypes";
+/**
+ * Interface for providing localization JSON files for schemas.
+ * @beta
+ */
+export interface ILocalizationProvider {
+    /**
+     * Load localization JSON for a given schema and locale.
+     * @param schemaName The name of the schema
+     * @param locale The locale identifier (e.g., "de", "fr", "es-CO")
+     * @returns Promise resolving to the localization JSON, or undefined if not found
+     */
+    getLocalization(schemaName: string, locale: string): Promise<SchemaLocalizationJson | undefined>;
+}
+/**
+ * The provider to load the localization JSON files.
+ * @beta
+ */
+export declare class LocalizationProvider implements ILocalizationProvider {
+    private _loader;
+    /**
+     * Constructs a LocalizationProvider.
+     * @param _loader Function that loads JSON content given a schema name and locale
+     */
+    constructor(_loader: (schemaName: string, locale: string) => Promise<SchemaLocalizationJson | undefined>);
+    /**
+     * Load localization JSON for a given schema and locale.
+     */
+    getLocalization(schemaName: string, locale: string): Promise<SchemaLocalizationJson | undefined>;
+}
+//# sourceMappingURL=LocalizationProvider.d.ts.map

package/lib/cjs/Localization/LocalizationProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalizationProvider.d.ts","sourceRoot":"","sources":["../../../src/Localization/LocalizationProvider.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAE7D;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;OAKG;IACH,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAC,CAAC;CAClG;AAED;;;GAGG;AACH,qBAAa,oBAAqB,YAAW,qBAAqB;IAMpD,OAAO,CAAC,OAAO;IAJ3B;;;OAGG;gBACiB,OAAO,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAC;IAGhH;;OAEG;IACU,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAC;CAmB9G"}

package/lib/cjs/Localization/LocalizationProvider.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalizationProvider = void 0;
+/**
+ * The provider to load the localization JSON files.
+ * @beta
+ */
+class LocalizationProvider {
+    _loader;
+    /**
+     * Constructs a LocalizationProvider.
+     * @param _loader Function that loads JSON content given a schema name and locale
+     */
+    constructor(_loader) {
+        this._loader = _loader;
+    }
+    /**
+     * Load localization JSON for a given schema and locale.
+     */
+    async getLocalization(schemaName, locale) {
+        const localizationData = await this._loader(schemaName, locale);
+        if (localizationData) {
+            if (!localizationData.name || !localizationData.locale) {
+                throw new Error(`Invalid localization JSON for ${schemaName}:${locale} - missing schema name or locale`);
+            }
+            if (localizationData.name !== schemaName) {
+                throw new Error(`Localization JSON mismatch for ${schemaName}:${locale} - expected schema name "${schemaName}" but got "${localizationData.name}"`);
+            }
+            if (localizationData.locale !== locale) {
+                throw new Error(`Localization JSON mismatch for ${schemaName}:${locale} - expected locale "${locale}" but got "${localizationData.locale}"`);
+            }
+        }
+        return localizationData;
+    }
+}
+exports.LocalizationProvider = LocalizationProvider;
+//# sourceMappingURL=LocalizationProvider.js.map

package/lib/cjs/Localization/LocalizationProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalizationProvider.js","sourceRoot":"","sources":["../../../src/Localization/LocalizationProvider.ts"],"names":[],"mappings":";;;AAoBA;;;GAGG;AACH,MAAa,oBAAoB;IAMX;IAJpB;;;OAGG;IACH,YAAoB,OAA4F;QAA5F,YAAO,GAAP,OAAO,CAAqF;IAChH,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,eAAe,CAAC,UAAkB,EAAE,MAAc;QAC7D,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAEhE,IAAI,gBAAgB,EAAE,CAAC;YACrB,IAAI,CAAC,gBAAgB,CAAC,IAAI,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,CAAC;gBACvD,MAAM,IAAI,KAAK,CAAC,iCAAiC,UAAU,IAAI,MAAM,kCAAkC,CAAC,CAAC;YAC3G,CAAC;YAED,IAAI,gBAAgB,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;gBACzC,MAAM,IAAI,KAAK,CAAC,kCAAkC,UAAU,IAAI,MAAM,4BAA4B,UAAU,cAAc,gBAAgB,CAAC,IAAI,GAAG,CAAC,CAAC;YACtJ,CAAC;YAED,IAAI,gBAAgB,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;gBACvC,MAAM,IAAI,KAAK,CAAC,kCAAkC,UAAU,IAAI,MAAM,uBAAuB,MAAM,cAAc,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC;YAC/I,CAAC;QACH,CAAC;QAED,OAAO,gBAAgB,CAAC;IAC1B,CAAC;CACF;AA/BD,oDA+BC","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\nimport { SchemaLocalizationJson } from \"./LocalizationTypes\";\r\n\r\n/**\r\n * Interface for providing localization JSON files for schemas.\r\n * @beta\r\n */\r\nexport interface ILocalizationProvider {\r\n  /**\r\n   * Load localization JSON for a given schema and locale.\r\n   * @param schemaName The name of the schema\r\n   * @param locale The locale identifier (e.g., \"de\", \"fr\", \"es-CO\")\r\n   * @returns Promise resolving to the localization JSON, or undefined if not found\r\n   */\r\n  getLocalization(schemaName: string, locale: string): Promise<SchemaLocalizationJson | undefined>;\r\n}\r\n\r\n/**\r\n * The provider to load the localization JSON files.\r\n * @beta\r\n */\r\nexport class LocalizationProvider implements ILocalizationProvider {\r\n\r\n  /**\r\n   * Constructs a LocalizationProvider.\r\n   * @param _loader Function that loads JSON content given a schema name and locale\r\n   */\r\n  constructor(private _loader: (schemaName: string, locale: string) => Promise<SchemaLocalizationJson | undefined>) {\r\n  }\r\n\r\n  /**\r\n   * Load localization JSON for a given schema and locale.\r\n   */\r\n  public async getLocalization(schemaName: string, locale: string): Promise<SchemaLocalizationJson | undefined> {\r\n    const localizationData = await this._loader(schemaName, locale);\r\n\r\n    if (localizationData) {\r\n      if (!localizationData.name || !localizationData.locale) {\r\n        throw new Error(`Invalid localization JSON for ${schemaName}:${locale} - missing schema name or locale`);\r\n      }\r\n\r\n      if (localizationData.name !== schemaName) {\r\n        throw new Error(`Localization JSON mismatch for ${schemaName}:${locale} - expected schema name \"${schemaName}\" but got \"${localizationData.name}\"`);\r\n      }\r\n\r\n      if (localizationData.locale !== locale) {\r\n        throw new Error(`Localization JSON mismatch for ${schemaName}:${locale} - expected locale \"${locale}\" but got \"${localizationData.locale}\"`);\r\n      }\r\n    }\r\n\r\n    return localizationData;\r\n  }\r\n}\r\n"]}

package/lib/cjs/Localization/LocalizationTypes.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Represents localized label and description for a schema element.
+ * @beta
+ */
+export interface LocalizedText {
+    label?: string;
+    description?: string;
+}
+/**
+ * Localized text for a schema item
+ * @beta
+ */
+export interface LocalizedItemText extends LocalizedText {
+    /** Localized members keyed by member name */
+    members?: {
+        [memberName: string]: LocalizedText;
+    };
+}
+/**
+ * JSON structure for schema localization file.
+ * @beta
+ */
+export interface SchemaLocalizationJson {
+    /** Schema version identifier */
+    $schema: string;
+    /** Name of the schema this localization applies to */
+    name: string;
+    /** Version of the schema */
+    version: string;
+    /** Locale identifier (e.g., "de", "fr", "es-CO") */
+    locale: string;
+    /** Localized schema label */
+    label?: string;
+    /** Localized schema description */
+    description?: string;
+    /** Localized schema items, keyed by item name */
+    items?: {
+        [itemName: string]: LocalizedItemText;
+    };
+}
+//# sourceMappingURL=LocalizationTypes.d.ts.map

package/lib/cjs/Localization/LocalizationTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalizationTypes.d.ts","sourceRoot":"","sources":["../../../src/Localization/LocalizationTypes.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAkB,SAAQ,aAAa;IACtD,6CAA6C;IAC7C,OAAO,CAAC,EAAE;QAAE,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,CAAA;KAAE,CAAC;CACnD;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,KAAK,CAAC,EAAE;QAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CAAA;KAAE,CAAC;CACnD"}

package/lib/cjs/Localization/LocalizationTypes.js

@@ -0,0 +1,7 @@
+"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 });
+//# sourceMappingURL=LocalizationTypes.js.map

package/lib/cjs/Localization/LocalizationTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalizationTypes.js","sourceRoot":"","sources":["../../../src/Localization/LocalizationTypes.ts"],"names":[],"mappings":";AAAA;;;+FAG+F","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 * Represents localized label and description for a schema element.\r\n * @beta\r\n */\r\nexport interface LocalizedText {\r\n  label?: string;\r\n  description?: string;\r\n}\r\n\r\n/**\r\n * Localized text for a schema item\r\n * @beta\r\n */\r\nexport interface LocalizedItemText extends LocalizedText {\r\n  /** Localized members keyed by member name */\r\n  members?: { [memberName: string]: LocalizedText };\r\n}\r\n\r\n/**\r\n * JSON structure for schema localization file.\r\n * @beta\r\n */\r\nexport interface SchemaLocalizationJson {\r\n  /** Schema version identifier */\r\n  $schema: string;\r\n  /** Name of the schema this localization applies to */\r\n  name: string;\r\n  /** Version of the schema */\r\n  version: string;\r\n  /** Locale identifier (e.g., \"de\", \"fr\", \"es-CO\") */\r\n  locale: string;\r\n  /** Localized schema label */\r\n  label?: string;\r\n  /** Localized schema description */\r\n  description?: string;\r\n  /** Localized schema items, keyed by item name */\r\n  items?: { [itemName: string]: LocalizedItemText };\r\n}\r\n"]}

package/lib/cjs/Localization/SchemaLocalization.d.ts

@@ -0,0 +1,94 @@
+import { SchemaKey } from "../SchemaKey";
+import { SchemaView } from "../SchemaView";
+import { Schema } from "../Metadata/Schema";
+import { ECClass } from "../Metadata/Class";
+import { Property } from "../Metadata/Property";
+import { SchemaItem } from "../Metadata/SchemaItem";
+import { ILocalizationProvider } from "./LocalizationProvider";
+import { AnyEnumerator, Enumeration } from "../Metadata/Enumeration";
+import { LocalizedText } from "./LocalizationTypes";
+type SchemaViewItem = SchemaView.Class | SchemaView.Enumeration | SchemaView.KindOfQuantity | SchemaView.PropertyCategory;
+/**
+ * Manages schema localization to provide localized labels and descriptions.
+ * @beta
+ */
+export declare class SchemaLocalization {
+    private _provider;
+    private _locale;
+    private _cache;
+    private constructor();
+    private get _baseLocale();
+    private cacheKey;
+    /**
+     * Create a SchemaLocalization instance and pre-load localization files for the given schemas.
+     * @param provider The localization provider to use for loading localization files
+     * @param locale The target locale (e.g., "de", "fr", "es-CO")
+     * @param schemas The schemas whose localization should be pre-loaded
+     */
+    static create(provider: ILocalizationProvider, locale: string, schemaKeys: Iterable<SchemaKey>): Promise<SchemaLocalization>;
+    get locale(): string;
+    setLocale(locale: string): void;
+    /**
+     * Get localization provider.
+     */
+    get provider(): ILocalizationProvider;
+    /**
+     * Load localizations for the given schema keys.
+     * @param schemaKeys The schema keys to load localization for
+     */
+    loadLocalizations(schemaKeys: Iterable<SchemaKey>): Promise<void>;
+    /**
+     * Get a localized label for a schema, schema item, or member.
+     */
+    getLabel(schemaName: string, itemName?: string, memberName?: string): string | undefined;
+    /**
+     * Get a localized description for a schema, schema item, or member.
+     */
+    getDescription(schemaName: string, itemName?: string, memberName?: string): string | undefined;
+    /**
+     * Get localized label and description of a schema.
+     * Label fallback: localized label → base locale label → original label → schema name
+     * Description fallback: localized description → base locale description → original description
+     */
+    getLocalizedSchema(schema: Schema | SchemaView.Schema): LocalizedText;
+    /**
+     * Get localized label and description of a schema item (class, enumeration, unit, etc.).
+     * Label fallback: localized label → base locale label → original label → item name
+     * Description fallback: localized description → base locale description → original description
+     */
+    getLocalizedSchemaItem(item: SchemaItem | SchemaViewItem): LocalizedText;
+    /**
+     * Get localized label and description of a property.
+     * Label fallback: localized label → base locale label → original label → property name
+     * Description fallback: localized description → base locale description → original description
+     */
+    getLocalizedProperty(ecClass: ECClass | SchemaView.Class, property: Property | SchemaView.Property): LocalizedText;
+    /**
+     * Get localized label and description of an enumerator.
+     * Label fallback: localized label → base locale label → original label → enumerator name
+     * Description fallback: localized description → base locale description → original description
+     */
+    getLocalizedEnumerator(enumeration: Enumeration | SchemaView.Enumeration, enumerator: AnyEnumerator | SchemaView.Enumerator): LocalizedText;
+    /**
+     * Load localization information for a specific schema and locale.
+     */
+    private loadLocalizationInfo;
+    /**
+     * Get major version from version string
+     */
+    private getMajorVersion;
+    /**
+     * Retrieve the cached localization for a locale
+     */
+    private getCachedLocalization;
+    /**
+     * Resolve a label from a localization object by item and optional member path.
+     */
+    private resolveLabel;
+    /**
+     * Resolve a description from a localization object by item and optional member path.
+     */
+    private resolveDescription;
+}
+export {};
+//# sourceMappingURL=SchemaLocalization.d.ts.map

package/lib/cjs/Localization/SchemaLocalization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaLocalization.d.ts","sourceRoot":"","sources":["../../../src/Localization/SchemaLocalization.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EAAE,aAAa,EAA0B,MAAM,qBAAqB,CAAC;AAI5E,KAAK,cAAc,GAAG,UAAU,CAAC,KAAK,GAAG,UAAU,CAAC,WAAW,GAAG,UAAU,CAAC,cAAc,GAAG,UAAU,CAAC,gBAAgB,CAAC;AAE1H;;;GAGG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,SAAS,CAAwB;IACzC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAA8D;IAE5E,OAAO;IAKP,OAAO,KAAK,WAAW,GAEtB;IAED,OAAO,CAAC,QAAQ;IAIhB;;;;;OAKG;WACiB,MAAM,CAAC,QAAQ,EAAE,qBAAqB,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAMzI,IAAW,MAAM,IAAI,MAAM,CAE1B;IAEM,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAKtC;;OAEG;IACH,IAAW,QAAQ,IAAI,qBAAqB,CAE3C;IAED;;;OAGG;IACU,iBAAiB,CAAC,UAAU,EAAE,QAAQ,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAU9E;;OAEG;IACI,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAc/F;;OAEG;IACI,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAcrG;;;;OAIG;IACI,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAAC,MAAM,GAAG,aAAa;IAM5E;;;;OAIG;IACI,sBAAsB,CAAC,IAAI,EAAE,UAAU,GAAG,cAAc,GAAG,aAAa;IAM/E;;;;OAIG;IACI,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,GAAG,UAAU,CAAC,QAAQ,GAAG,aAAa;IAMzH;;;;OAIG;IACI,sBAAsB,CAAC,WAAW,EAAE,WAAW,GAAG,UAAU,CAAC,WAAW,EAAE,UAAU,EAAE,aAAa,GAAG,UAAU,CAAC,UAAU,GAAG,aAAa;IAMlJ;;OAEG;YACW,oBAAoB;IAkBlC;;OAEG;IACH,OAAO,CAAC,eAAe;IASvB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAK7B;;OAEG;IACH,OAAO,CAAC,YAAY;IAWpB;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAU3B"}

package/lib/cjs/Localization/SchemaLocalization.js

@@ -0,0 +1,197 @@
+"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.SchemaLocalization = void 0;
+const core_bentley_1 = require("@itwin/core-bentley");
+const loggerCategory = "SchemaLocalization";
+/**
+ * Manages schema localization to provide localized labels and descriptions.
+ * @beta
+ */
+class SchemaLocalization {
+    _provider;
+    _locale;
+    _cache = new Map();
+    constructor(provider, locale) {
+        this._provider = provider;
+        this._locale = locale;
+    }
+    get _baseLocale() {
+        return this._locale.includes("-") ? this._locale.split("-")[0] : undefined;
+    }
+    cacheKey(schemaName, locale) {
+        return `${schemaName}:${locale}`;
+    }
+    /**
+     * Create a SchemaLocalization instance and pre-load localization files for the given schemas.
+     * @param provider The localization provider to use for loading localization files
+     * @param locale The target locale (e.g., "de", "fr", "es-CO")
+     * @param schemas The schemas whose localization should be pre-loaded
+     */
+    static async create(provider, locale, schemaKeys) {
+        const localization = new SchemaLocalization(provider, locale);
+        await localization.loadLocalizations(schemaKeys);
+        return localization;
+    }
+    get locale() {
+        return this._locale;
+    }
+    setLocale(locale) {
+        this._locale = locale;
+        this._cache.clear();
+    }
+    /**
+     * Get localization provider.
+     */
+    get provider() {
+        return this._provider;
+    }
+    /**
+     * Load localizations for the given schema keys.
+     * @param schemaKeys The schema keys to load localization for
+     */
+    async loadLocalizations(schemaKeys) {
+        const promises = [];
+        for (const key of schemaKeys) {
+            promises.push(this.loadLocalizationInfo(key.name, key.readVersion, this._locale));
+            if (this._baseLocale !== undefined)
+                promises.push(this.loadLocalizationInfo(key.name, key.readVersion, this._baseLocale));
+        }
+        await Promise.all(promises);
+    }
+    /**
+     * Get a localized label for a schema, schema item, or member.
+     */
+    getLabel(schemaName, itemName, memberName) {
+        const localization = this.getCachedLocalization(schemaName, this._locale);
+        const label = this.resolveLabel(localization, itemName, memberName);
+        if (label)
+            return label;
+        if (this._baseLocale) {
+            const baseLocalization = this.getCachedLocalization(schemaName, this._baseLocale);
+            return this.resolveLabel(baseLocalization, itemName, memberName);
+        }
+        return undefined;
+    }
+    /**
+     * Get a localized description for a schema, schema item, or member.
+     */
+    getDescription(schemaName, itemName, memberName) {
+        const localization = this.getCachedLocalization(schemaName, this._locale);
+        const description = this.resolveDescription(localization, itemName, memberName);
+        if (description)
+            return description;
+        if (this._baseLocale) {
+            const baseLocalization = this.getCachedLocalization(schemaName, this._baseLocale);
+            return this.resolveDescription(baseLocalization, itemName, memberName);
+        }
+        return undefined;
+    }
+    /**
+     * Get localized label and description of a schema.
+     * Label fallback: localized label → base locale label → original label → schema name
+     * Description fallback: localized description → base locale description → original description
+     */
+    getLocalizedSchema(schema) {
+        const label = this.getLabel(schema.name) ?? (schema.label || schema.name);
+        const description = this.getDescription(schema.name) ?? schema.description;
+        return { label, description };
+    }
+    /**
+     * Get localized label and description of a schema item (class, enumeration, unit, etc.).
+     * Label fallback: localized label → base locale label → original label → item name
+     * Description fallback: localized description → base locale description → original description
+     */
+    getLocalizedSchemaItem(item) {
+        const label = this.getLabel(item.schema.name, item.name) ?? (item.label || item.name);
+        const description = this.getDescription(item.schema.name, item.name) ?? item.description;
+        return { label, description };
+    }
+    /**
+     * Get localized label and description of a property.
+     * Label fallback: localized label → base locale label → original label → property name
+     * Description fallback: localized description → base locale description → original description
+     */
+    getLocalizedProperty(ecClass, property) {
+        const label = this.getLabel(ecClass.schema.name, ecClass.name, property.name) ?? (property.label || property.name);
+        const description = this.getDescription(ecClass.schema.name, ecClass.name, property.name) ?? property.description;
+        return { label, description };
+    }
+    /**
+     * Get localized label and description of an enumerator.
+     * Label fallback: localized label → base locale label → original label → enumerator name
+     * Description fallback: localized description → base locale description → original description
+     */
+    getLocalizedEnumerator(enumeration, enumerator) {
+        const label = this.getLabel(enumeration.schema.name, enumeration.name, enumerator.name) ?? (enumerator.label || enumerator.name);
+        const description = this.getDescription(enumeration.schema.name, enumeration.name, enumerator.name) ?? enumerator.description;
+        return { label, description };
+    }
+    /**
+     * Load localization information for a specific schema and locale.
+     */
+    async loadLocalizationInfo(schemaName, readVersion, locale) {
+        const cacheKey = this.cacheKey(schemaName, locale);
+        if (this._cache.has(cacheKey))
+            return;
+        const localization = await this._provider.getLocalization(schemaName, locale);
+        if (localization?.version) {
+            const localizationMajor = this.getMajorVersion(localization.version);
+            if (localizationMajor === undefined || readVersion !== localizationMajor) {
+                core_bentley_1.Logger.logWarning(loggerCategory, `Localization version mismatch for schema "${schemaName}". Schema major version is ${readVersion.toString()}, but localization is for major version ${localizationMajor?.toString() ?? "undefined"}.`);
+                this._cache.set(cacheKey, undefined);
+                return;
+            }
+        }
+        this._cache.set(cacheKey, localization);
+    }
+    /**
+     * Get major version from version string
+     */
+    getMajorVersion(version) {
+        const rawVersion = version.split(".");
+        if (rawVersion.length > 0) {
+            const majorVersion = parseInt(rawVersion[0], 10);
+            return isNaN(majorVersion) ? undefined : majorVersion;
+        }
+        return undefined;
+    }
+    /**
+     * Retrieve the cached localization for a locale
+     */
+    getCachedLocalization(schemaName, locale) {
+        const cacheKey = this.cacheKey(schemaName, locale);
+        return this._cache.get(cacheKey);
+    }
+    /**
+     * Resolve a label from a localization object by item and optional member path.
+     */
+    resolveLabel(localization, itemName, memberName) {
+        if (!localization)
+            return undefined;
+        if (!itemName)
+            return localization.label;
+        const item = localization.items?.[itemName];
+        if (!memberName)
+            return item?.label;
+        return item?.members?.[memberName]?.label;
+    }
+    /**
+     * Resolve a description from a localization object by item and optional member path.
+     */
+    resolveDescription(localization, itemName, memberName) {
+        if (!localization)
+            return undefined;
+        if (!itemName)
+            return localization.description;
+        const item = localization.items?.[itemName];
+        if (!memberName)
+            return item?.description;
+        return item?.members?.[memberName]?.description;
+    }
+}
+exports.SchemaLocalization = SchemaLocalization;
+//# sourceMappingURL=SchemaLocalization.js.map

package/lib/cjs/Localization/SchemaLocalization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaLocalization.js","sourceRoot":"","sources":["../../../src/Localization/SchemaLocalization.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n\r\nimport { SchemaKey } from \"../SchemaKey\";\r\nimport { SchemaView } from \"../SchemaView\";\r\nimport { Schema } from \"../Metadata/Schema\";\r\nimport { ECClass } from \"../Metadata/Class\";\r\nimport { Logger } from \"@itwin/core-bentley\";\r\nimport { Property } from \"../Metadata/Property\";\r\nimport { SchemaItem } from \"../Metadata/SchemaItem\";\r\nimport { ILocalizationProvider } from \"./LocalizationProvider\";\r\nimport { AnyEnumerator, Enumeration } from \"../Metadata/Enumeration\";\r\nimport { LocalizedText, SchemaLocalizationJson } from \"./LocalizationTypes\";\r\n\r\nconst loggerCategory = \"SchemaLocalization\";\r\n\r\ntype SchemaViewItem = SchemaView.Class | SchemaView.Enumeration | SchemaView.KindOfQuantity | SchemaView.PropertyCategory;\r\n\r\n/**\r\n * Manages schema localization to provide localized labels and descriptions.\r\n * @beta\r\n */\r\nexport class SchemaLocalization {\r\n  private _provider: ILocalizationProvider;\r\n  private _locale: string;\r\n  private _cache: Map<string, SchemaLocalizationJson | undefined> = new Map();\r\n\r\n  private constructor(provider: ILocalizationProvider, locale: string) {\r\n    this._provider = provider;\r\n    this._locale = locale;\r\n  }\r\n\r\n  private get _baseLocale(): string | undefined {\r\n    return this._locale.includes(\"-\") ? this._locale.split(\"-\")[0] : undefined;\r\n  }\r\n\r\n  private cacheKey(schemaName: string, locale: string): string {\r\n    return `${schemaName}:${locale}`;\r\n  }\r\n\r\n  /**\r\n   * Create a SchemaLocalization instance and pre-load localization files for the given schemas.\r\n   * @param provider The localization provider to use for loading localization files\r\n   * @param locale The target locale (e.g., \"de\", \"fr\", \"es-CO\")\r\n   * @param schemas The schemas whose localization should be pre-loaded\r\n   */\r\n  public static async create(provider: ILocalizationProvider, locale: string, schemaKeys: Iterable<SchemaKey>): Promise<SchemaLocalization> {\r\n    const localization = new SchemaLocalization(provider, locale);\r\n    await localization.loadLocalizations(schemaKeys);\r\n    return localization;\r\n  }\r\n\r\n  public get locale(): string {\r\n    return this._locale;\r\n  }\r\n\r\n  public setLocale(locale: string): void {\r\n    this._locale = locale;\r\n    this._cache.clear();\r\n  }\r\n\r\n  /**\r\n   * Get localization provider.\r\n   */\r\n  public get provider(): ILocalizationProvider {\r\n    return this._provider;\r\n  }\r\n\r\n  /**\r\n   * Load localizations for the given schema keys.\r\n   * @param schemaKeys The schema keys to load localization for\r\n   */\r\n  public async loadLocalizations(schemaKeys: Iterable<SchemaKey>): Promise<void> {\r\n    const promises: Promise<void>[] = [];\r\n    for (const key of schemaKeys) {\r\n      promises.push(this.loadLocalizationInfo(key.name, key.readVersion, this._locale));\r\n      if (this._baseLocale !== undefined)\r\n        promises.push(this.loadLocalizationInfo(key.name, key.readVersion, this._baseLocale));\r\n    }\r\n    await Promise.all(promises);\r\n  }\r\n\r\n  /**\r\n   * Get a localized label for a schema, schema item, or member.\r\n   */\r\n  public getLabel(schemaName: string, itemName?: string, memberName?: string): string | undefined {\r\n    const localization = this.getCachedLocalization(schemaName, this._locale);\r\n    const label = this.resolveLabel(localization, itemName, memberName);\r\n    if (label)\r\n      return label;\r\n\r\n    if (this._baseLocale) {\r\n      const baseLocalization = this.getCachedLocalization(schemaName, this._baseLocale);\r\n      return this.resolveLabel(baseLocalization, itemName, memberName);\r\n    }\r\n\r\n    return undefined;\r\n  }\r\n\r\n  /**\r\n   * Get a localized description for a schema, schema item, or member.\r\n   */\r\n  public getDescription(schemaName: string, itemName?: string, memberName?: string): string | undefined {\r\n    const localization = this.getCachedLocalization(schemaName, this._locale);\r\n    const description = this.resolveDescription(localization, itemName, memberName);\r\n    if (description)\r\n      return description;\r\n\r\n    if (this._baseLocale) {\r\n      const baseLocalization = this.getCachedLocalization(schemaName, this._baseLocale);\r\n      return this.resolveDescription(baseLocalization, itemName, memberName);\r\n    }\r\n\r\n    return undefined;\r\n  }\r\n\r\n  /**\r\n   * Get localized label and description of a schema.\r\n   * Label fallback: localized label → base locale label → original label → schema name\r\n   * Description fallback: localized description → base locale description → original description\r\n   */\r\n  public getLocalizedSchema(schema: Schema | SchemaView.Schema): LocalizedText {\r\n    const label = this.getLabel(schema.name) ?? (schema.label || schema.name);\r\n    const description = this.getDescription(schema.name) ?? schema.description;\r\n    return { label, description };\r\n  }\r\n\r\n  /**\r\n   * Get localized label and description of a schema item (class, enumeration, unit, etc.).\r\n   * Label fallback: localized label → base locale label → original label → item name\r\n   * Description fallback: localized description → base locale description → original description\r\n   */\r\n  public getLocalizedSchemaItem(item: SchemaItem | SchemaViewItem): LocalizedText {\r\n    const label = this.getLabel(item.schema.name, item.name) ?? (item.label || item.name);\r\n    const description = this.getDescription(item.schema.name, item.name) ?? item.description;\r\n    return { label, description };\r\n  }\r\n\r\n  /**\r\n   * Get localized label and description of a property.\r\n   * Label fallback: localized label → base locale label → original label → property name\r\n   * Description fallback: localized description → base locale description → original description\r\n   */\r\n  public getLocalizedProperty(ecClass: ECClass | SchemaView.Class, property: Property | SchemaView.Property): LocalizedText {\r\n    const label = this.getLabel(ecClass.schema.name, ecClass.name, property.name) ?? (property.label || property.name);\r\n    const description = this.getDescription(ecClass.schema.name, ecClass.name, property.name) ?? property.description;\r\n    return { label, description };\r\n  }\r\n\r\n  /**\r\n   * Get localized label and description of an enumerator.\r\n   * Label fallback: localized label → base locale label → original label → enumerator name\r\n   * Description fallback: localized description → base locale description → original description\r\n   */\r\n  public getLocalizedEnumerator(enumeration: Enumeration | SchemaView.Enumeration, enumerator: AnyEnumerator | SchemaView.Enumerator): LocalizedText {\r\n    const label = this.getLabel(enumeration.schema.name, enumeration.name, enumerator.name) ?? (enumerator.label || enumerator.name);\r\n    const description = this.getDescription(enumeration.schema.name, enumeration.name, enumerator.name) ?? enumerator.description;\r\n    return { label, description };\r\n  }\r\n\r\n  /**\r\n   * Load localization information for a specific schema and locale.\r\n   */\r\n  private async loadLocalizationInfo(schemaName: string, readVersion: number, locale: string): Promise<void> {\r\n    const cacheKey = this.cacheKey(schemaName, locale);\r\n    if (this._cache.has(cacheKey))\r\n      return;\r\n\r\n    const localization = await this._provider.getLocalization(schemaName, locale);\r\n    if (localization?.version) {\r\n      const localizationMajor = this.getMajorVersion(localization.version);\r\n      if (localizationMajor === undefined || readVersion !== localizationMajor) {\r\n        Logger.logWarning(loggerCategory, `Localization version mismatch for schema \"${schemaName}\". Schema major version is ${readVersion.toString()}, but localization is for major version ${localizationMajor?.toString() ?? \"undefined\"}.`);\r\n        this._cache.set(cacheKey, undefined);\r\n        return;\r\n      }\r\n    }\r\n\r\n    this._cache.set(cacheKey, localization);\r\n  }\r\n\r\n  /**\r\n   * Get major version from version string\r\n   */\r\n  private getMajorVersion(version: string): number | undefined {\r\n    const rawVersion = version.split(\".\");\r\n    if (rawVersion.length > 0) {\r\n      const majorVersion = parseInt(rawVersion[0], 10);\r\n      return isNaN(majorVersion) ? undefined : majorVersion;\r\n    }\r\n    return undefined;\r\n  }\r\n\r\n  /**\r\n   * Retrieve the cached localization for a locale\r\n   */\r\n  private getCachedLocalization(schemaName: string, locale: string): SchemaLocalizationJson | undefined {\r\n    const cacheKey = this.cacheKey(schemaName, locale);\r\n    return this._cache.get(cacheKey);\r\n  }\r\n\r\n  /**\r\n   * Resolve a label from a localization object by item and optional member path.\r\n   */\r\n  private resolveLabel(localization: SchemaLocalizationJson | undefined, itemName?: string, memberName?: string): string | undefined {\r\n    if (!localization)\r\n      return undefined;\r\n    if (!itemName)\r\n      return localization.label;\r\n    const item = localization.items?.[itemName];\r\n    if (!memberName)\r\n      return item?.label;\r\n    return item?.members?.[memberName]?.label;\r\n  }\r\n\r\n  /**\r\n   * Resolve a description from a localization object by item and optional member path.\r\n   */\r\n  private resolveDescription(localization: SchemaLocalizationJson | undefined, itemName?: string, memberName?: string): string | undefined {\r\n    if (!localization)\r\n      return undefined;\r\n    if (!itemName)\r\n      return localization.description;\r\n    const item = localization.items?.[itemName];\r\n    if (!memberName)\r\n      return item?.description;\r\n    return item?.members?.[memberName]?.description;\r\n  }\r\n}\r\n"]}

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

@@ -44,6 +44,9 @@ export { SchemaGraph } from "./utils/SchemaGraph";
 export * from "./SchemaViewBinaryReader";
 export * from "./SchemaView";
 export * from "./SchemaViewInterfaces";
+export * from "./Localization/LocalizationTypes";
+export * from "./Localization/LocalizationProvider";
+export * from "./Localization/SchemaLocalization";
 /** @docs-package-description
  * The ecschema-metadata package contains classes for working with ECSchemas that can be used in both [frontend]($docs/learning/frontend/index.md) and [backend]($docs/learning/backend/index.md).
  */

package/lib/cjs/ecschema-metadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ecschema-metadata.d.ts","sourceRoot":"","sources":["../../src/ecschema-metadata.ts"],"names":[],"mappings":"AAKA,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,mCAAmC,CAAC;AAClD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EACL,QAAQ,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,cAAc,EACxF,mBAAmB,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,sBAAsB,EAC3G,oBAAoB,EAAE,WAAW,EAAE,iBAAiB,EAAE,aAAa,EAAE,2BAA2B,GACjG,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACnH,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gCAAgC,CAAC;AAC/C,cAAc,mCAAmC,CAAC;AAClD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oCAAoC,CAAC;AACnD,cAAc,uCAAuC,CAAC;AACtD,cAAc,yCAAyC,CAAC;AACxD,cAAc,+CAA+C,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,6BAA6B,EAAE,MAAM,4BAA4B,CAAC;AAC5F,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,cAAc,0BAA0B,CAAC;AACzC,cAAc,cAAc,CAAC;AAC7B,cAAc,wBAAwB,CAAC;AAEvC;;GAEG;AACH;;;GAGG;AACH;;;GAGG"}
+{"version":3,"file":"ecschema-metadata.d.ts","sourceRoot":"","sources":["../../src/ecschema-metadata.ts"],"names":[],"mappings":"AAKA,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,mCAAmC,CAAC;AAClD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EACL,QAAQ,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,cAAc,EACxF,mBAAmB,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,sBAAsB,EAC3G,oBAAoB,EAAE,WAAW,EAAE,iBAAiB,EAAE,aAAa,EAAE,2BAA2B,GACjG,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACnH,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gCAAgC,CAAC;AAC/C,cAAc,mCAAmC,CAAC;AAClD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oCAAoC,CAAC;AACnD,cAAc,uCAAuC,CAAC;AACtD,cAAc,yCAAyC,CAAC;AACxD,cAAc,+CAA+C,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,6BAA6B,EAAE,MAAM,4BAA4B,CAAC;AAC5F,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,cAAc,0BAA0B,CAAC;AACzC,cAAc,cAAc,CAAC;AAC7B,cAAc,wBAAwB,CAAC;AACvC,cAAc,kCAAkC,CAAC;AACjD,cAAc,qCAAqC,CAAC;AACpD,cAAc,mCAAmC,CAAC;AAElD;;GAEG;AACH;;;GAGG;AACH;;;GAGG"}

package/lib/cjs/ecschema-metadata.js

@@ -93,6 +93,9 @@ Object.defineProperty(exports, "SchemaGraph", { enumerable: true, get: function
 __exportStar(require("./SchemaViewBinaryReader"), exports);
 __exportStar(require("./SchemaView"), exports);
 __exportStar(require("./SchemaViewInterfaces"), exports);
+__exportStar(require("./Localization/LocalizationTypes"), exports);
+__exportStar(require("./Localization/LocalizationProvider"), exports);
+__exportStar(require("./Localization/SchemaLocalization"), exports);
 /** @docs-package-description
  * The ecschema-metadata package contains classes for working with ECSchemas that can be used in both [frontend]($docs/learning/frontend/index.md) and [backend]($docs/learning/backend/index.md).
  */

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

@@ -1 +1 @@
-{"version":3,"file":"ecschema-metadata.js","sourceRoot":"","sources":["../../src/ecschema-metadata.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;;;;;;;;;;;;;;;;;AAE/F,8CAA4B;AAC5B,4CAA0B;AAC1B,mDAAiC;AACjC,oEAAkD;AAClD,8DAA4C;AAC5C,2DAAyC;AACzC,8DAA4C;AAC5C,2CAAyB;AACzB,8CAA4B;AAC5B,8CAA4B;AAC5B,+CAA6B;AAC7B,0CAAwD;AAA/C,gGAAA,OAAO,OAAA;AAAE,oGAAA,WAAW,OAAA;AAC7B,gDAA+C;AAAtC,oGAAA,QAAQ,OAAA;AACjB,wEAAuE;AAA9D,4HAAA,oBAAoB,OAAA;AAC7B,sDAAqD;AAA5C,0GAAA,WAAW,OAAA;AACpB,sDAAgF;AAAxD,0GAAA,WAAW,OAAA;AACnC,4CAA2C;AAAlC,gGAAA,MAAM,OAAA;AACf,wDAAuD;AAA9C,4GAAA,YAAY,OAAA;AACrB,4DAA2D;AAAlD,gHAAA,cAAc,OAAA;AACvB,0CAAyC;AAAhC,8FAAA,KAAK,OAAA;AACd,4DAA0C;AAC1C,oDAAmD;AAA1C,wGAAA,UAAU,OAAA;AACnB,gDAI6B;AAH3B,oGAAA,QAAQ,OAAA;AAAE,6GAAA,iBAAiB,OAAA;AAAE,kHAAA,sBAAsB,OAAA;AAAE,+GAAA,mBAAmB,OAAA;AAAE,0GAAA,cAAc,OAAA;AACxF,+GAAA,mBAAmB,OAAA;AAAE,oHAAA,wBAAwB,OAAA;AAAE,8GAAA,kBAAkB,OAAA;AACX,yGAAA,aAAa,OAAA;AAAE,uHAAA,2BAA2B,OAAA;AAElG,gEAA+D;AAAtD,oHAAA,gBAAgB,OAAA;AACzB,kEAAmH;AAA1G,sHAAA,iBAAiB,OAAA;AAAE,2HAAA,sBAAsB,OAAA;AAAE,6HAAA,wBAAwB,OAAA;AAC5E,4CAA2C;AAAlC,gGAAA,MAAM,OAAA;AACf,wDAAsC;AACtC,wCAAuC;AAA9B,4FAAA,IAAI,OAAA;AACb,oDAAmD;AAA1C,wGAAA,UAAU,OAAA;AACnB,kDAAgC;AAChC,sDAAoC;AACpC,8CAA4B;AAC5B,iDAA+B;AAC/B,iEAA+C;AAC/C,oEAAkD;AAClD,4DAA0C;AAC1C,8DAA4C;AAC5C,qEAAmD;AACnD,wEAAsD;AACtD,0EAAwD;AACxD,gFAA8D;AAE9D,mDAAkD;AAAzC,0GAAA,WAAW,OAAA;AACpB,2DAAyC;AACzC,+CAA6B;AAC7B,yDAAuC;AAEvC;;GAEG;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 \"./Constants\";\r\nexport * from \"./Context\";\r\nexport * from \"./DelayedPromise\";\r\nexport * from \"./Deserialization/SchemaGraphUtil\";\r\nexport * from \"./Deserialization/JsonProps\";\r\nexport * from \"./Deserialization/Helper\";\r\nexport * from \"./Deserialization/XmlParser\";\r\nexport * from \"./ECName\";\r\nexport * from \"./ECObjects\";\r\nexport * from \"./Exception\";\r\nexport * from \"./Interfaces\";\r\nexport { ECClass, StructClass } from \"./Metadata/Class\";\r\nexport { Constant } from \"./Metadata/Constant\";\r\nexport { CustomAttributeClass } from \"./Metadata/CustomAttributeClass\";\r\nexport { EntityClass } from \"./Metadata/EntityClass\";\r\nexport { AnyEnumerator, Enumeration, Enumerator } from \"./Metadata/Enumeration\";\r\nexport { Format } from \"./Metadata/Format\";\r\nexport { InvertedUnit } from \"./Metadata/InvertedUnit\";\r\nexport { KindOfQuantity } from \"./Metadata/KindOfQuantity\";\r\nexport { Mixin } from \"./Metadata/Mixin\";\r\nexport * from \"./Metadata/OverrideFormat\";\r\nexport { Phenomenon } from \"./Metadata/Phenomenon\";\r\nexport {\r\n  Property, PrimitiveProperty, PrimitiveArrayProperty, EnumerationProperty, StructProperty,\r\n  StructArrayProperty, EnumerationArrayProperty, NavigationProperty, AnyArrayProperty, AnyEnumerationProperty,\r\n  AnyPrimitiveProperty, AnyProperty, AnyStructProperty, ArrayProperty, PrimitiveOrEnumPropertyBase,\r\n} from \"./Metadata/Property\";\r\nexport { PropertyCategory } from \"./Metadata/PropertyCategory\";\r\nexport { RelationshipClass, RelationshipConstraint, RelationshipMultiplicity } from \"./Metadata/RelationshipClass\";\r\nexport { Schema } from \"./Metadata/Schema\";\r\nexport * from \"./Metadata/SchemaItem\";\r\nexport { Unit } from \"./Metadata/Unit\";\r\nexport { UnitSystem } from \"./Metadata/UnitSystem\";\r\nexport * from \"./PropertyTypes\";\r\nexport * from \"./SchemaJsonLocater\";\r\nexport * from \"./SchemaKey\";\r\nexport * from \"./SchemaLoader\";\r\nexport * from \"./UnitConversion/UnitConverter\";\r\nexport * from \"./UnitProvider/SchemaUnitProvider\";\r\nexport * from \"./Validation/SchemaWalker\";\r\nexport * from \"./SchemaPartVisitorDelegate\";\r\nexport * from \"./Formatting/SchemaFormatsProvider\";\r\nexport * from \"./Formatting/FormatSetFormatsProvider\";\r\nexport * from \"./IncrementalLoading/ECSqlSchemaLocater\";\r\nexport * from \"./IncrementalLoading/IncrementalSchemaLocater\";\r\nexport { CustomAttribute, CustomAttributeContainerProps } from \"./Metadata/CustomAttribute\";\r\nexport { SchemaGraph } from \"./utils/SchemaGraph\";\r\nexport * from \"./SchemaViewBinaryReader\";\r\nexport * from \"./SchemaView\";\r\nexport * from \"./SchemaViewInterfaces\";\r\n\r\n/** @docs-package-description\r\n * The ecschema-metadata package contains classes for working with ECSchemas that can be used in both [frontend]($docs/learning/frontend/index.md) and [backend]($docs/learning/backend/index.md).\r\n */\r\n/**\r\n * @docs-group-description Metadata\r\n * Definitions of classes and interfaces that represent all [EC elements]($docs/bis/ec/index.md).\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-metadata.js","sourceRoot":"","sources":["../../src/ecschema-metadata.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;;;;;;;;;;;;;;;;;AAE/F,8CAA4B;AAC5B,4CAA0B;AAC1B,mDAAiC;AACjC,oEAAkD;AAClD,8DAA4C;AAC5C,2DAAyC;AACzC,8DAA4C;AAC5C,2CAAyB;AACzB,8CAA4B;AAC5B,8CAA4B;AAC5B,+CAA6B;AAC7B,0CAAwD;AAA/C,gGAAA,OAAO,OAAA;AAAE,oGAAA,WAAW,OAAA;AAC7B,gDAA+C;AAAtC,oGAAA,QAAQ,OAAA;AACjB,wEAAuE;AAA9D,4HAAA,oBAAoB,OAAA;AAC7B,sDAAqD;AAA5C,0GAAA,WAAW,OAAA;AACpB,sDAAgF;AAAxD,0GAAA,WAAW,OAAA;AACnC,4CAA2C;AAAlC,gGAAA,MAAM,OAAA;AACf,wDAAuD;AAA9C,4GAAA,YAAY,OAAA;AACrB,4DAA2D;AAAlD,gHAAA,cAAc,OAAA;AACvB,0CAAyC;AAAhC,8FAAA,KAAK,OAAA;AACd,4DAA0C;AAC1C,oDAAmD;AAA1C,wGAAA,UAAU,OAAA;AACnB,gDAI6B;AAH3B,oGAAA,QAAQ,OAAA;AAAE,6GAAA,iBAAiB,OAAA;AAAE,kHAAA,sBAAsB,OAAA;AAAE,+GAAA,mBAAmB,OAAA;AAAE,0GAAA,cAAc,OAAA;AACxF,+GAAA,mBAAmB,OAAA;AAAE,oHAAA,wBAAwB,OAAA;AAAE,8GAAA,kBAAkB,OAAA;AACX,yGAAA,aAAa,OAAA;AAAE,uHAAA,2BAA2B,OAAA;AAElG,gEAA+D;AAAtD,oHAAA,gBAAgB,OAAA;AACzB,kEAAmH;AAA1G,sHAAA,iBAAiB,OAAA;AAAE,2HAAA,sBAAsB,OAAA;AAAE,6HAAA,wBAAwB,OAAA;AAC5E,4CAA2C;AAAlC,gGAAA,MAAM,OAAA;AACf,wDAAsC;AACtC,wCAAuC;AAA9B,4FAAA,IAAI,OAAA;AACb,oDAAmD;AAA1C,wGAAA,UAAU,OAAA;AACnB,kDAAgC;AAChC,sDAAoC;AACpC,8CAA4B;AAC5B,iDAA+B;AAC/B,iEAA+C;AAC/C,oEAAkD;AAClD,4DAA0C;AAC1C,8DAA4C;AAC5C,qEAAmD;AACnD,wEAAsD;AACtD,0EAAwD;AACxD,gFAA8D;AAE9D,mDAAkD;AAAzC,0GAAA,WAAW,OAAA;AACpB,2DAAyC;AACzC,+CAA6B;AAC7B,yDAAuC;AACvC,mEAAiD;AACjD,sEAAoD;AACpD,oEAAkD;AAElD;;GAEG;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 \"./Constants\";\r\nexport * from \"./Context\";\r\nexport * from \"./DelayedPromise\";\r\nexport * from \"./Deserialization/SchemaGraphUtil\";\r\nexport * from \"./Deserialization/JsonProps\";\r\nexport * from \"./Deserialization/Helper\";\r\nexport * from \"./Deserialization/XmlParser\";\r\nexport * from \"./ECName\";\r\nexport * from \"./ECObjects\";\r\nexport * from \"./Exception\";\r\nexport * from \"./Interfaces\";\r\nexport { ECClass, StructClass } from \"./Metadata/Class\";\r\nexport { Constant } from \"./Metadata/Constant\";\r\nexport { CustomAttributeClass } from \"./Metadata/CustomAttributeClass\";\r\nexport { EntityClass } from \"./Metadata/EntityClass\";\r\nexport { AnyEnumerator, Enumeration, Enumerator } from \"./Metadata/Enumeration\";\r\nexport { Format } from \"./Metadata/Format\";\r\nexport { InvertedUnit } from \"./Metadata/InvertedUnit\";\r\nexport { KindOfQuantity } from \"./Metadata/KindOfQuantity\";\r\nexport { Mixin } from \"./Metadata/Mixin\";\r\nexport * from \"./Metadata/OverrideFormat\";\r\nexport { Phenomenon } from \"./Metadata/Phenomenon\";\r\nexport {\r\n  Property, PrimitiveProperty, PrimitiveArrayProperty, EnumerationProperty, StructProperty,\r\n  StructArrayProperty, EnumerationArrayProperty, NavigationProperty, AnyArrayProperty, AnyEnumerationProperty,\r\n  AnyPrimitiveProperty, AnyProperty, AnyStructProperty, ArrayProperty, PrimitiveOrEnumPropertyBase,\r\n} from \"./Metadata/Property\";\r\nexport { PropertyCategory } from \"./Metadata/PropertyCategory\";\r\nexport { RelationshipClass, RelationshipConstraint, RelationshipMultiplicity } from \"./Metadata/RelationshipClass\";\r\nexport { Schema } from \"./Metadata/Schema\";\r\nexport * from \"./Metadata/SchemaItem\";\r\nexport { Unit } from \"./Metadata/Unit\";\r\nexport { UnitSystem } from \"./Metadata/UnitSystem\";\r\nexport * from \"./PropertyTypes\";\r\nexport * from \"./SchemaJsonLocater\";\r\nexport * from \"./SchemaKey\";\r\nexport * from \"./SchemaLoader\";\r\nexport * from \"./UnitConversion/UnitConverter\";\r\nexport * from \"./UnitProvider/SchemaUnitProvider\";\r\nexport * from \"./Validation/SchemaWalker\";\r\nexport * from \"./SchemaPartVisitorDelegate\";\r\nexport * from \"./Formatting/SchemaFormatsProvider\";\r\nexport * from \"./Formatting/FormatSetFormatsProvider\";\r\nexport * from \"./IncrementalLoading/ECSqlSchemaLocater\";\r\nexport * from \"./IncrementalLoading/IncrementalSchemaLocater\";\r\nexport { CustomAttribute, CustomAttributeContainerProps } from \"./Metadata/CustomAttribute\";\r\nexport { SchemaGraph } from \"./utils/SchemaGraph\";\r\nexport * from \"./SchemaViewBinaryReader\";\r\nexport * from \"./SchemaView\";\r\nexport * from \"./SchemaViewInterfaces\";\r\nexport * from \"./Localization/LocalizationTypes\";\r\nexport * from \"./Localization/LocalizationProvider\";\r\nexport * from \"./Localization/SchemaLocalization\";\r\n\r\n/** @docs-package-description\r\n * The ecschema-metadata package contains classes for working with ECSchemas that can be used in both [frontend]($docs/learning/frontend/index.md) and [backend]($docs/learning/backend/index.md).\r\n */\r\n/**\r\n * @docs-group-description Metadata\r\n * Definitions of classes and interfaces that represent all [EC elements]($docs/bis/ec/index.md).\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/esm/Localization/LocalizationProvider.d.ts

@@ -0,0 +1,31 @@
+import { SchemaLocalizationJson } from "./LocalizationTypes";
+/**
+ * Interface for providing localization JSON files for schemas.
+ * @beta
+ */
+export interface ILocalizationProvider {
+    /**
+     * Load localization JSON for a given schema and locale.
+     * @param schemaName The name of the schema
+     * @param locale The locale identifier (e.g., "de", "fr", "es-CO")
+     * @returns Promise resolving to the localization JSON, or undefined if not found
+     */
+    getLocalization(schemaName: string, locale: string): Promise<SchemaLocalizationJson | undefined>;
+}
+/**
+ * The provider to load the localization JSON files.
+ * @beta
+ */
+export declare class LocalizationProvider implements ILocalizationProvider {
+    private _loader;
+    /**
+     * Constructs a LocalizationProvider.
+     * @param _loader Function that loads JSON content given a schema name and locale
+     */
+    constructor(_loader: (schemaName: string, locale: string) => Promise<SchemaLocalizationJson | undefined>);
+    /**
+     * Load localization JSON for a given schema and locale.
+     */
+    getLocalization(schemaName: string, locale: string): Promise<SchemaLocalizationJson | undefined>;
+}
+//# sourceMappingURL=LocalizationProvider.d.ts.map

package/lib/esm/Localization/LocalizationProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalizationProvider.d.ts","sourceRoot":"","sources":["../../../src/Localization/LocalizationProvider.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAE7D;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;OAKG;IACH,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAC,CAAC;CAClG;AAED;;;GAGG;AACH,qBAAa,oBAAqB,YAAW,qBAAqB;IAMpD,OAAO,CAAC,OAAO;IAJ3B;;;OAGG;gBACiB,OAAO,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAC;IAGhH;;OAEG;IACU,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAC;CAmB9G"}

package/lib/esm/Localization/LocalizationProvider.js

@@ -0,0 +1,33 @@
+/**
+ * The provider to load the localization JSON files.
+ * @beta
+ */
+export class LocalizationProvider {
+    _loader;
+    /**
+     * Constructs a LocalizationProvider.
+     * @param _loader Function that loads JSON content given a schema name and locale
+     */
+    constructor(_loader) {
+        this._loader = _loader;
+    }
+    /**
+     * Load localization JSON for a given schema and locale.
+     */
+    async getLocalization(schemaName, locale) {
+        const localizationData = await this._loader(schemaName, locale);
+        if (localizationData) {
+            if (!localizationData.name || !localizationData.locale) {
+                throw new Error(`Invalid localization JSON for ${schemaName}:${locale} - missing schema name or locale`);
+            }
+            if (localizationData.name !== schemaName) {
+                throw new Error(`Localization JSON mismatch for ${schemaName}:${locale} - expected schema name "${schemaName}" but got "${localizationData.name}"`);
+            }
+            if (localizationData.locale !== locale) {
+                throw new Error(`Localization JSON mismatch for ${schemaName}:${locale} - expected locale "${locale}" but got "${localizationData.locale}"`);
+            }
+        }
+        return localizationData;
+    }
+}
+//# sourceMappingURL=LocalizationProvider.js.map

package/lib/esm/Localization/LocalizationProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalizationProvider.js","sourceRoot":"","sources":["../../../src/Localization/LocalizationProvider.ts"],"names":[],"mappings":"AAoBA;;;GAGG;AACH,MAAM,OAAO,oBAAoB;IAMX;IAJpB;;;OAGG;IACH,YAAoB,OAA4F;QAA5F,YAAO,GAAP,OAAO,CAAqF;IAChH,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,eAAe,CAAC,UAAkB,EAAE,MAAc;QAC7D,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAEhE,IAAI,gBAAgB,EAAE,CAAC;YACrB,IAAI,CAAC,gBAAgB,CAAC,IAAI,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,CAAC;gBACvD,MAAM,IAAI,KAAK,CAAC,iCAAiC,UAAU,IAAI,MAAM,kCAAkC,CAAC,CAAC;YAC3G,CAAC;YAED,IAAI,gBAAgB,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;gBACzC,MAAM,IAAI,KAAK,CAAC,kCAAkC,UAAU,IAAI,MAAM,4BAA4B,UAAU,cAAc,gBAAgB,CAAC,IAAI,GAAG,CAAC,CAAC;YACtJ,CAAC;YAED,IAAI,gBAAgB,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;gBACvC,MAAM,IAAI,KAAK,CAAC,kCAAkC,UAAU,IAAI,MAAM,uBAAuB,MAAM,cAAc,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC;YAC/I,CAAC;QACH,CAAC;QAED,OAAO,gBAAgB,CAAC;IAC1B,CAAC;CACF","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\nimport { SchemaLocalizationJson } from \"./LocalizationTypes\";\r\n\r\n/**\r\n * Interface for providing localization JSON files for schemas.\r\n * @beta\r\n */\r\nexport interface ILocalizationProvider {\r\n  /**\r\n   * Load localization JSON for a given schema and locale.\r\n   * @param schemaName The name of the schema\r\n   * @param locale The locale identifier (e.g., \"de\", \"fr\", \"es-CO\")\r\n   * @returns Promise resolving to the localization JSON, or undefined if not found\r\n   */\r\n  getLocalization(schemaName: string, locale: string): Promise<SchemaLocalizationJson | undefined>;\r\n}\r\n\r\n/**\r\n * The provider to load the localization JSON files.\r\n * @beta\r\n */\r\nexport class LocalizationProvider implements ILocalizationProvider {\r\n\r\n  /**\r\n   * Constructs a LocalizationProvider.\r\n   * @param _loader Function that loads JSON content given a schema name and locale\r\n   */\r\n  constructor(private _loader: (schemaName: string, locale: string) => Promise<SchemaLocalizationJson | undefined>) {\r\n  }\r\n\r\n  /**\r\n   * Load localization JSON for a given schema and locale.\r\n   */\r\n  public async getLocalization(schemaName: string, locale: string): Promise<SchemaLocalizationJson | undefined> {\r\n    const localizationData = await this._loader(schemaName, locale);\r\n\r\n    if (localizationData) {\r\n      if (!localizationData.name || !localizationData.locale) {\r\n        throw new Error(`Invalid localization JSON for ${schemaName}:${locale} - missing schema name or locale`);\r\n      }\r\n\r\n      if (localizationData.name !== schemaName) {\r\n        throw new Error(`Localization JSON mismatch for ${schemaName}:${locale} - expected schema name \"${schemaName}\" but got \"${localizationData.name}\"`);\r\n      }\r\n\r\n      if (localizationData.locale !== locale) {\r\n        throw new Error(`Localization JSON mismatch for ${schemaName}:${locale} - expected locale \"${locale}\" but got \"${localizationData.locale}\"`);\r\n      }\r\n    }\r\n\r\n    return localizationData;\r\n  }\r\n}\r\n"]}

package/lib/esm/Localization/LocalizationTypes.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Represents localized label and description for a schema element.
+ * @beta
+ */
+export interface LocalizedText {
+    label?: string;
+    description?: string;
+}
+/**
+ * Localized text for a schema item
+ * @beta
+ */
+export interface LocalizedItemText extends LocalizedText {
+    /** Localized members keyed by member name */
+    members?: {
+        [memberName: string]: LocalizedText;
+    };
+}
+/**
+ * JSON structure for schema localization file.
+ * @beta
+ */
+export interface SchemaLocalizationJson {
+    /** Schema version identifier */
+    $schema: string;
+    /** Name of the schema this localization applies to */
+    name: string;
+    /** Version of the schema */
+    version: string;
+    /** Locale identifier (e.g., "de", "fr", "es-CO") */
+    locale: string;
+    /** Localized schema label */
+    label?: string;
+    /** Localized schema description */
+    description?: string;
+    /** Localized schema items, keyed by item name */
+    items?: {
+        [itemName: string]: LocalizedItemText;
+    };
+}
+//# sourceMappingURL=LocalizationTypes.d.ts.map

package/lib/esm/Localization/LocalizationTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalizationTypes.d.ts","sourceRoot":"","sources":["../../../src/Localization/LocalizationTypes.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAkB,SAAQ,aAAa;IACtD,6CAA6C;IAC7C,OAAO,CAAC,EAAE;QAAE,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,CAAA;KAAE,CAAC;CACnD;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,KAAK,CAAC,EAAE;QAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CAAA;KAAE,CAAC;CACnD"}

package/lib/esm/Localization/LocalizationTypes.js

@@ -0,0 +1,6 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+export {};
+//# sourceMappingURL=LocalizationTypes.js.map

package/lib/esm/Localization/LocalizationTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalizationTypes.js","sourceRoot":"","sources":["../../../src/Localization/LocalizationTypes.ts"],"names":[],"mappings":"AAAA;;;+FAG+F","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 * Represents localized label and description for a schema element.\r\n * @beta\r\n */\r\nexport interface LocalizedText {\r\n  label?: string;\r\n  description?: string;\r\n}\r\n\r\n/**\r\n * Localized text for a schema item\r\n * @beta\r\n */\r\nexport interface LocalizedItemText extends LocalizedText {\r\n  /** Localized members keyed by member name */\r\n  members?: { [memberName: string]: LocalizedText };\r\n}\r\n\r\n/**\r\n * JSON structure for schema localization file.\r\n * @beta\r\n */\r\nexport interface SchemaLocalizationJson {\r\n  /** Schema version identifier */\r\n  $schema: string;\r\n  /** Name of the schema this localization applies to */\r\n  name: string;\r\n  /** Version of the schema */\r\n  version: string;\r\n  /** Locale identifier (e.g., \"de\", \"fr\", \"es-CO\") */\r\n  locale: string;\r\n  /** Localized schema label */\r\n  label?: string;\r\n  /** Localized schema description */\r\n  description?: string;\r\n  /** Localized schema items, keyed by item name */\r\n  items?: { [itemName: string]: LocalizedItemText };\r\n}\r\n"]}

package/lib/esm/Localization/SchemaLocalization.d.ts

@@ -0,0 +1,94 @@
+import { SchemaKey } from "../SchemaKey";
+import { SchemaView } from "../SchemaView";
+import { Schema } from "../Metadata/Schema";
+import { ECClass } from "../Metadata/Class";
+import { Property } from "../Metadata/Property";
+import { SchemaItem } from "../Metadata/SchemaItem";
+import { ILocalizationProvider } from "./LocalizationProvider";
+import { AnyEnumerator, Enumeration } from "../Metadata/Enumeration";
+import { LocalizedText } from "./LocalizationTypes";
+type SchemaViewItem = SchemaView.Class | SchemaView.Enumeration | SchemaView.KindOfQuantity | SchemaView.PropertyCategory;
+/**
+ * Manages schema localization to provide localized labels and descriptions.
+ * @beta
+ */
+export declare class SchemaLocalization {
+    private _provider;
+    private _locale;
+    private _cache;
+    private constructor();
+    private get _baseLocale();
+    private cacheKey;
+    /**
+     * Create a SchemaLocalization instance and pre-load localization files for the given schemas.
+     * @param provider The localization provider to use for loading localization files
+     * @param locale The target locale (e.g., "de", "fr", "es-CO")
+     * @param schemas The schemas whose localization should be pre-loaded
+     */
+    static create(provider: ILocalizationProvider, locale: string, schemaKeys: Iterable<SchemaKey>): Promise<SchemaLocalization>;
+    get locale(): string;
+    setLocale(locale: string): void;
+    /**
+     * Get localization provider.
+     */
+    get provider(): ILocalizationProvider;
+    /**
+     * Load localizations for the given schema keys.
+     * @param schemaKeys The schema keys to load localization for
+     */
+    loadLocalizations(schemaKeys: Iterable<SchemaKey>): Promise<void>;
+    /**
+     * Get a localized label for a schema, schema item, or member.
+     */
+    getLabel(schemaName: string, itemName?: string, memberName?: string): string | undefined;
+    /**
+     * Get a localized description for a schema, schema item, or member.
+     */
+    getDescription(schemaName: string, itemName?: string, memberName?: string): string | undefined;
+    /**
+     * Get localized label and description of a schema.
+     * Label fallback: localized label → base locale label → original label → schema name
+     * Description fallback: localized description → base locale description → original description
+     */
+    getLocalizedSchema(schema: Schema | SchemaView.Schema): LocalizedText;
+    /**
+     * Get localized label and description of a schema item (class, enumeration, unit, etc.).
+     * Label fallback: localized label → base locale label → original label → item name
+     * Description fallback: localized description → base locale description → original description
+     */
+    getLocalizedSchemaItem(item: SchemaItem | SchemaViewItem): LocalizedText;
+    /**
+     * Get localized label and description of a property.
+     * Label fallback: localized label → base locale label → original label → property name
+     * Description fallback: localized description → base locale description → original description
+     */
+    getLocalizedProperty(ecClass: ECClass | SchemaView.Class, property: Property | SchemaView.Property): LocalizedText;
+    /**
+     * Get localized label and description of an enumerator.
+     * Label fallback: localized label → base locale label → original label → enumerator name
+     * Description fallback: localized description → base locale description → original description
+     */
+    getLocalizedEnumerator(enumeration: Enumeration | SchemaView.Enumeration, enumerator: AnyEnumerator | SchemaView.Enumerator): LocalizedText;
+    /**
+     * Load localization information for a specific schema and locale.
+     */
+    private loadLocalizationInfo;
+    /**
+     * Get major version from version string
+     */
+    private getMajorVersion;
+    /**
+     * Retrieve the cached localization for a locale
+     */
+    private getCachedLocalization;
+    /**
+     * Resolve a label from a localization object by item and optional member path.
+     */
+    private resolveLabel;
+    /**
+     * Resolve a description from a localization object by item and optional member path.
+     */
+    private resolveDescription;
+}
+export {};
+//# sourceMappingURL=SchemaLocalization.d.ts.map

package/lib/esm/Localization/SchemaLocalization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaLocalization.d.ts","sourceRoot":"","sources":["../../../src/Localization/SchemaLocalization.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EAAE,aAAa,EAA0B,MAAM,qBAAqB,CAAC;AAI5E,KAAK,cAAc,GAAG,UAAU,CAAC,KAAK,GAAG,UAAU,CAAC,WAAW,GAAG,UAAU,CAAC,cAAc,GAAG,UAAU,CAAC,gBAAgB,CAAC;AAE1H;;;GAGG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,SAAS,CAAwB;IACzC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAA8D;IAE5E,OAAO;IAKP,OAAO,KAAK,WAAW,GAEtB;IAED,OAAO,CAAC,QAAQ;IAIhB;;;;;OAKG;WACiB,MAAM,CAAC,QAAQ,EAAE,qBAAqB,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAMzI,IAAW,MAAM,IAAI,MAAM,CAE1B;IAEM,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAKtC;;OAEG;IACH,IAAW,QAAQ,IAAI,qBAAqB,CAE3C;IAED;;;OAGG;IACU,iBAAiB,CAAC,UAAU,EAAE,QAAQ,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAU9E;;OAEG;IACI,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAc/F;;OAEG;IACI,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAcrG;;;;OAIG;IACI,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAAC,MAAM,GAAG,aAAa;IAM5E;;;;OAIG;IACI,sBAAsB,CAAC,IAAI,EAAE,UAAU,GAAG,cAAc,GAAG,aAAa;IAM/E;;;;OAIG;IACI,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,GAAG,UAAU,CAAC,QAAQ,GAAG,aAAa;IAMzH;;;;OAIG;IACI,sBAAsB,CAAC,WAAW,EAAE,WAAW,GAAG,UAAU,CAAC,WAAW,EAAE,UAAU,EAAE,aAAa,GAAG,UAAU,CAAC,UAAU,GAAG,aAAa;IAMlJ;;OAEG;YACW,oBAAoB;IAkBlC;;OAEG;IACH,OAAO,CAAC,eAAe;IASvB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAK7B;;OAEG;IACH,OAAO,CAAC,YAAY;IAWpB;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAU3B"}

package/lib/esm/Localization/SchemaLocalization.js

@@ -0,0 +1,193 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+import { Logger } from "@itwin/core-bentley";
+const loggerCategory = "SchemaLocalization";
+/**
+ * Manages schema localization to provide localized labels and descriptions.
+ * @beta
+ */
+export class SchemaLocalization {
+    _provider;
+    _locale;
+    _cache = new Map();
+    constructor(provider, locale) {
+        this._provider = provider;
+        this._locale = locale;
+    }
+    get _baseLocale() {
+        return this._locale.includes("-") ? this._locale.split("-")[0] : undefined;
+    }
+    cacheKey(schemaName, locale) {
+        return `${schemaName}:${locale}`;
+    }
+    /**
+     * Create a SchemaLocalization instance and pre-load localization files for the given schemas.
+     * @param provider The localization provider to use for loading localization files
+     * @param locale The target locale (e.g., "de", "fr", "es-CO")
+     * @param schemas The schemas whose localization should be pre-loaded
+     */
+    static async create(provider, locale, schemaKeys) {
+        const localization = new SchemaLocalization(provider, locale);
+        await localization.loadLocalizations(schemaKeys);
+        return localization;
+    }
+    get locale() {
+        return this._locale;
+    }
+    setLocale(locale) {
+        this._locale = locale;
+        this._cache.clear();
+    }
+    /**
+     * Get localization provider.
+     */
+    get provider() {
+        return this._provider;
+    }
+    /**
+     * Load localizations for the given schema keys.
+     * @param schemaKeys The schema keys to load localization for
+     */
+    async loadLocalizations(schemaKeys) {
+        const promises = [];
+        for (const key of schemaKeys) {
+            promises.push(this.loadLocalizationInfo(key.name, key.readVersion, this._locale));
+            if (this._baseLocale !== undefined)
+                promises.push(this.loadLocalizationInfo(key.name, key.readVersion, this._baseLocale));
+        }
+        await Promise.all(promises);
+    }
+    /**
+     * Get a localized label for a schema, schema item, or member.
+     */
+    getLabel(schemaName, itemName, memberName) {
+        const localization = this.getCachedLocalization(schemaName, this._locale);
+        const label = this.resolveLabel(localization, itemName, memberName);
+        if (label)
+            return label;
+        if (this._baseLocale) {
+            const baseLocalization = this.getCachedLocalization(schemaName, this._baseLocale);
+            return this.resolveLabel(baseLocalization, itemName, memberName);
+        }
+        return undefined;
+    }
+    /**
+     * Get a localized description for a schema, schema item, or member.
+     */
+    getDescription(schemaName, itemName, memberName) {
+        const localization = this.getCachedLocalization(schemaName, this._locale);
+        const description = this.resolveDescription(localization, itemName, memberName);
+        if (description)
+            return description;
+        if (this._baseLocale) {
+            const baseLocalization = this.getCachedLocalization(schemaName, this._baseLocale);
+            return this.resolveDescription(baseLocalization, itemName, memberName);
+        }
+        return undefined;
+    }
+    /**
+     * Get localized label and description of a schema.
+     * Label fallback: localized label → base locale label → original label → schema name
+     * Description fallback: localized description → base locale description → original description
+     */
+    getLocalizedSchema(schema) {
+        const label = this.getLabel(schema.name) ?? (schema.label || schema.name);
+        const description = this.getDescription(schema.name) ?? schema.description;
+        return { label, description };
+    }
+    /**
+     * Get localized label and description of a schema item (class, enumeration, unit, etc.).
+     * Label fallback: localized label → base locale label → original label → item name
+     * Description fallback: localized description → base locale description → original description
+     */
+    getLocalizedSchemaItem(item) {
+        const label = this.getLabel(item.schema.name, item.name) ?? (item.label || item.name);
+        const description = this.getDescription(item.schema.name, item.name) ?? item.description;
+        return { label, description };
+    }
+    /**
+     * Get localized label and description of a property.
+     * Label fallback: localized label → base locale label → original label → property name
+     * Description fallback: localized description → base locale description → original description
+     */
+    getLocalizedProperty(ecClass, property) {
+        const label = this.getLabel(ecClass.schema.name, ecClass.name, property.name) ?? (property.label || property.name);
+        const description = this.getDescription(ecClass.schema.name, ecClass.name, property.name) ?? property.description;
+        return { label, description };
+    }
+    /**
+     * Get localized label and description of an enumerator.
+     * Label fallback: localized label → base locale label → original label → enumerator name
+     * Description fallback: localized description → base locale description → original description
+     */
+    getLocalizedEnumerator(enumeration, enumerator) {
+        const label = this.getLabel(enumeration.schema.name, enumeration.name, enumerator.name) ?? (enumerator.label || enumerator.name);
+        const description = this.getDescription(enumeration.schema.name, enumeration.name, enumerator.name) ?? enumerator.description;
+        return { label, description };
+    }
+    /**
+     * Load localization information for a specific schema and locale.
+     */
+    async loadLocalizationInfo(schemaName, readVersion, locale) {
+        const cacheKey = this.cacheKey(schemaName, locale);
+        if (this._cache.has(cacheKey))
+            return;
+        const localization = await this._provider.getLocalization(schemaName, locale);
+        if (localization?.version) {
+            const localizationMajor = this.getMajorVersion(localization.version);
+            if (localizationMajor === undefined || readVersion !== localizationMajor) {
+                Logger.logWarning(loggerCategory, `Localization version mismatch for schema "${schemaName}". Schema major version is ${readVersion.toString()}, but localization is for major version ${localizationMajor?.toString() ?? "undefined"}.`);
+                this._cache.set(cacheKey, undefined);
+                return;
+            }
+        }
+        this._cache.set(cacheKey, localization);
+    }
+    /**
+     * Get major version from version string
+     */
+    getMajorVersion(version) {
+        const rawVersion = version.split(".");
+        if (rawVersion.length > 0) {
+            const majorVersion = parseInt(rawVersion[0], 10);
+            return isNaN(majorVersion) ? undefined : majorVersion;
+        }
+        return undefined;
+    }
+    /**
+     * Retrieve the cached localization for a locale
+     */
+    getCachedLocalization(schemaName, locale) {
+        const cacheKey = this.cacheKey(schemaName, locale);
+        return this._cache.get(cacheKey);
+    }
+    /**
+     * Resolve a label from a localization object by item and optional member path.
+     */
+    resolveLabel(localization, itemName, memberName) {
+        if (!localization)
+            return undefined;
+        if (!itemName)
+            return localization.label;
+        const item = localization.items?.[itemName];
+        if (!memberName)
+            return item?.label;
+        return item?.members?.[memberName]?.label;
+    }
+    /**
+     * Resolve a description from a localization object by item and optional member path.
+     */
+    resolveDescription(localization, itemName, memberName) {
+        if (!localization)
+            return undefined;
+        if (!itemName)
+            return localization.description;
+        const item = localization.items?.[itemName];
+        if (!memberName)
+            return item?.description;
+        return item?.members?.[memberName]?.description;
+    }
+}
+//# sourceMappingURL=SchemaLocalization.js.map

package/lib/esm/Localization/SchemaLocalization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaLocalization.js","sourceRoot":"","sources":["../../../src/Localization/SchemaLocalization.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n\r\nimport { SchemaKey } from \"../SchemaKey\";\r\nimport { SchemaView } from \"../SchemaView\";\r\nimport { Schema } from \"../Metadata/Schema\";\r\nimport { ECClass } from \"../Metadata/Class\";\r\nimport { Logger } from \"@itwin/core-bentley\";\r\nimport { Property } from \"../Metadata/Property\";\r\nimport { SchemaItem } from \"../Metadata/SchemaItem\";\r\nimport { ILocalizationProvider } from \"./LocalizationProvider\";\r\nimport { AnyEnumerator, Enumeration } from \"../Metadata/Enumeration\";\r\nimport { LocalizedText, SchemaLocalizationJson } from \"./LocalizationTypes\";\r\n\r\nconst loggerCategory = \"SchemaLocalization\";\r\n\r\ntype SchemaViewItem = SchemaView.Class | SchemaView.Enumeration | SchemaView.KindOfQuantity | SchemaView.PropertyCategory;\r\n\r\n/**\r\n * Manages schema localization to provide localized labels and descriptions.\r\n * @beta\r\n */\r\nexport class SchemaLocalization {\r\n  private _provider: ILocalizationProvider;\r\n  private _locale: string;\r\n  private _cache: Map<string, SchemaLocalizationJson | undefined> = new Map();\r\n\r\n  private constructor(provider: ILocalizationProvider, locale: string) {\r\n    this._provider = provider;\r\n    this._locale = locale;\r\n  }\r\n\r\n  private get _baseLocale(): string | undefined {\r\n    return this._locale.includes(\"-\") ? this._locale.split(\"-\")[0] : undefined;\r\n  }\r\n\r\n  private cacheKey(schemaName: string, locale: string): string {\r\n    return `${schemaName}:${locale}`;\r\n  }\r\n\r\n  /**\r\n   * Create a SchemaLocalization instance and pre-load localization files for the given schemas.\r\n   * @param provider The localization provider to use for loading localization files\r\n   * @param locale The target locale (e.g., \"de\", \"fr\", \"es-CO\")\r\n   * @param schemas The schemas whose localization should be pre-loaded\r\n   */\r\n  public static async create(provider: ILocalizationProvider, locale: string, schemaKeys: Iterable<SchemaKey>): Promise<SchemaLocalization> {\r\n    const localization = new SchemaLocalization(provider, locale);\r\n    await localization.loadLocalizations(schemaKeys);\r\n    return localization;\r\n  }\r\n\r\n  public get locale(): string {\r\n    return this._locale;\r\n  }\r\n\r\n  public setLocale(locale: string): void {\r\n    this._locale = locale;\r\n    this._cache.clear();\r\n  }\r\n\r\n  /**\r\n   * Get localization provider.\r\n   */\r\n  public get provider(): ILocalizationProvider {\r\n    return this._provider;\r\n  }\r\n\r\n  /**\r\n   * Load localizations for the given schema keys.\r\n   * @param schemaKeys The schema keys to load localization for\r\n   */\r\n  public async loadLocalizations(schemaKeys: Iterable<SchemaKey>): Promise<void> {\r\n    const promises: Promise<void>[] = [];\r\n    for (const key of schemaKeys) {\r\n      promises.push(this.loadLocalizationInfo(key.name, key.readVersion, this._locale));\r\n      if (this._baseLocale !== undefined)\r\n        promises.push(this.loadLocalizationInfo(key.name, key.readVersion, this._baseLocale));\r\n    }\r\n    await Promise.all(promises);\r\n  }\r\n\r\n  /**\r\n   * Get a localized label for a schema, schema item, or member.\r\n   */\r\n  public getLabel(schemaName: string, itemName?: string, memberName?: string): string | undefined {\r\n    const localization = this.getCachedLocalization(schemaName, this._locale);\r\n    const label = this.resolveLabel(localization, itemName, memberName);\r\n    if (label)\r\n      return label;\r\n\r\n    if (this._baseLocale) {\r\n      const baseLocalization = this.getCachedLocalization(schemaName, this._baseLocale);\r\n      return this.resolveLabel(baseLocalization, itemName, memberName);\r\n    }\r\n\r\n    return undefined;\r\n  }\r\n\r\n  /**\r\n   * Get a localized description for a schema, schema item, or member.\r\n   */\r\n  public getDescription(schemaName: string, itemName?: string, memberName?: string): string | undefined {\r\n    const localization = this.getCachedLocalization(schemaName, this._locale);\r\n    const description = this.resolveDescription(localization, itemName, memberName);\r\n    if (description)\r\n      return description;\r\n\r\n    if (this._baseLocale) {\r\n      const baseLocalization = this.getCachedLocalization(schemaName, this._baseLocale);\r\n      return this.resolveDescription(baseLocalization, itemName, memberName);\r\n    }\r\n\r\n    return undefined;\r\n  }\r\n\r\n  /**\r\n   * Get localized label and description of a schema.\r\n   * Label fallback: localized label → base locale label → original label → schema name\r\n   * Description fallback: localized description → base locale description → original description\r\n   */\r\n  public getLocalizedSchema(schema: Schema | SchemaView.Schema): LocalizedText {\r\n    const label = this.getLabel(schema.name) ?? (schema.label || schema.name);\r\n    const description = this.getDescription(schema.name) ?? schema.description;\r\n    return { label, description };\r\n  }\r\n\r\n  /**\r\n   * Get localized label and description of a schema item (class, enumeration, unit, etc.).\r\n   * Label fallback: localized label → base locale label → original label → item name\r\n   * Description fallback: localized description → base locale description → original description\r\n   */\r\n  public getLocalizedSchemaItem(item: SchemaItem | SchemaViewItem): LocalizedText {\r\n    const label = this.getLabel(item.schema.name, item.name) ?? (item.label || item.name);\r\n    const description = this.getDescription(item.schema.name, item.name) ?? item.description;\r\n    return { label, description };\r\n  }\r\n\r\n  /**\r\n   * Get localized label and description of a property.\r\n   * Label fallback: localized label → base locale label → original label → property name\r\n   * Description fallback: localized description → base locale description → original description\r\n   */\r\n  public getLocalizedProperty(ecClass: ECClass | SchemaView.Class, property: Property | SchemaView.Property): LocalizedText {\r\n    const label = this.getLabel(ecClass.schema.name, ecClass.name, property.name) ?? (property.label || property.name);\r\n    const description = this.getDescription(ecClass.schema.name, ecClass.name, property.name) ?? property.description;\r\n    return { label, description };\r\n  }\r\n\r\n  /**\r\n   * Get localized label and description of an enumerator.\r\n   * Label fallback: localized label → base locale label → original label → enumerator name\r\n   * Description fallback: localized description → base locale description → original description\r\n   */\r\n  public getLocalizedEnumerator(enumeration: Enumeration | SchemaView.Enumeration, enumerator: AnyEnumerator | SchemaView.Enumerator): LocalizedText {\r\n    const label = this.getLabel(enumeration.schema.name, enumeration.name, enumerator.name) ?? (enumerator.label || enumerator.name);\r\n    const description = this.getDescription(enumeration.schema.name, enumeration.name, enumerator.name) ?? enumerator.description;\r\n    return { label, description };\r\n  }\r\n\r\n  /**\r\n   * Load localization information for a specific schema and locale.\r\n   */\r\n  private async loadLocalizationInfo(schemaName: string, readVersion: number, locale: string): Promise<void> {\r\n    const cacheKey = this.cacheKey(schemaName, locale);\r\n    if (this._cache.has(cacheKey))\r\n      return;\r\n\r\n    const localization = await this._provider.getLocalization(schemaName, locale);\r\n    if (localization?.version) {\r\n      const localizationMajor = this.getMajorVersion(localization.version);\r\n      if (localizationMajor === undefined || readVersion !== localizationMajor) {\r\n        Logger.logWarning(loggerCategory, `Localization version mismatch for schema \"${schemaName}\". Schema major version is ${readVersion.toString()}, but localization is for major version ${localizationMajor?.toString() ?? \"undefined\"}.`);\r\n        this._cache.set(cacheKey, undefined);\r\n        return;\r\n      }\r\n    }\r\n\r\n    this._cache.set(cacheKey, localization);\r\n  }\r\n\r\n  /**\r\n   * Get major version from version string\r\n   */\r\n  private getMajorVersion(version: string): number | undefined {\r\n    const rawVersion = version.split(\".\");\r\n    if (rawVersion.length > 0) {\r\n      const majorVersion = parseInt(rawVersion[0], 10);\r\n      return isNaN(majorVersion) ? undefined : majorVersion;\r\n    }\r\n    return undefined;\r\n  }\r\n\r\n  /**\r\n   * Retrieve the cached localization for a locale\r\n   */\r\n  private getCachedLocalization(schemaName: string, locale: string): SchemaLocalizationJson | undefined {\r\n    const cacheKey = this.cacheKey(schemaName, locale);\r\n    return this._cache.get(cacheKey);\r\n  }\r\n\r\n  /**\r\n   * Resolve a label from a localization object by item and optional member path.\r\n   */\r\n  private resolveLabel(localization: SchemaLocalizationJson | undefined, itemName?: string, memberName?: string): string | undefined {\r\n    if (!localization)\r\n      return undefined;\r\n    if (!itemName)\r\n      return localization.label;\r\n    const item = localization.items?.[itemName];\r\n    if (!memberName)\r\n      return item?.label;\r\n    return item?.members?.[memberName]?.label;\r\n  }\r\n\r\n  /**\r\n   * Resolve a description from a localization object by item and optional member path.\r\n   */\r\n  private resolveDescription(localization: SchemaLocalizationJson | undefined, itemName?: string, memberName?: string): string | undefined {\r\n    if (!localization)\r\n      return undefined;\r\n    if (!itemName)\r\n      return localization.description;\r\n    const item = localization.items?.[itemName];\r\n    if (!memberName)\r\n      return item?.description;\r\n    return item?.members?.[memberName]?.description;\r\n  }\r\n}\r\n"]}

package/lib/esm/ecschema-metadata.d.ts

@@ -44,6 +44,9 @@ export { SchemaGraph } from "./utils/SchemaGraph";
 export * from "./SchemaViewBinaryReader";
 export * from "./SchemaView";
 export * from "./SchemaViewInterfaces";
+export * from "./Localization/LocalizationTypes";
+export * from "./Localization/LocalizationProvider";
+export * from "./Localization/SchemaLocalization";
 /** @docs-package-description
  * The ecschema-metadata package contains classes for working with ECSchemas that can be used in both [frontend]($docs/learning/frontend/index.md) and [backend]($docs/learning/backend/index.md).
  */

package/lib/esm/ecschema-metadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ecschema-metadata.d.ts","sourceRoot":"","sources":["../../src/ecschema-metadata.ts"],"names":[],"mappings":"AAKA,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,mCAAmC,CAAC;AAClD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EACL,QAAQ,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,cAAc,EACxF,mBAAmB,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,sBAAsB,EAC3G,oBAAoB,EAAE,WAAW,EAAE,iBAAiB,EAAE,aAAa,EAAE,2BAA2B,GACjG,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACnH,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gCAAgC,CAAC;AAC/C,cAAc,mCAAmC,CAAC;AAClD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oCAAoC,CAAC;AACnD,cAAc,uCAAuC,CAAC;AACtD,cAAc,yCAAyC,CAAC;AACxD,cAAc,+CAA+C,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,6BAA6B,EAAE,MAAM,4BAA4B,CAAC;AAC5F,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,cAAc,0BAA0B,CAAC;AACzC,cAAc,cAAc,CAAC;AAC7B,cAAc,wBAAwB,CAAC;AAEvC;;GAEG;AACH;;;GAGG;AACH;;;GAGG"}
+{"version":3,"file":"ecschema-metadata.d.ts","sourceRoot":"","sources":["../../src/ecschema-metadata.ts"],"names":[],"mappings":"AAKA,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,mCAAmC,CAAC;AAClD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EACL,QAAQ,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,cAAc,EACxF,mBAAmB,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,sBAAsB,EAC3G,oBAAoB,EAAE,WAAW,EAAE,iBAAiB,EAAE,aAAa,EAAE,2BAA2B,GACjG,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACnH,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gCAAgC,CAAC;AAC/C,cAAc,mCAAmC,CAAC;AAClD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oCAAoC,CAAC;AACnD,cAAc,uCAAuC,CAAC;AACtD,cAAc,yCAAyC,CAAC;AACxD,cAAc,+CAA+C,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,6BAA6B,EAAE,MAAM,4BAA4B,CAAC;AAC5F,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,cAAc,0BAA0B,CAAC;AACzC,cAAc,cAAc,CAAC;AAC7B,cAAc,wBAAwB,CAAC;AACvC,cAAc,kCAAkC,CAAC;AACjD,cAAc,qCAAqC,CAAC;AACpD,cAAc,mCAAmC,CAAC;AAElD;;GAEG;AACH;;;GAGG;AACH;;;GAGG"}

package/lib/esm/ecschema-metadata.js

@@ -47,6 +47,9 @@ export { SchemaGraph } from "./utils/SchemaGraph";
 export * from "./SchemaViewBinaryReader";
 export * from "./SchemaView";
 export * from "./SchemaViewInterfaces";
+export * from "./Localization/LocalizationTypes";
+export * from "./Localization/LocalizationProvider";
+export * from "./Localization/SchemaLocalization";
 /** @docs-package-description
  * The ecschema-metadata package contains classes for working with ECSchemas that can be used in both [frontend]($docs/learning/frontend/index.md) and [backend]($docs/learning/backend/index.md).
  */

package/lib/esm/ecschema-metadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"ecschema-metadata.js","sourceRoot":"","sources":["../../src/ecschema-metadata.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAE/F,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,mCAAmC,CAAC;AAClD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAiB,WAAW,EAAc,MAAM,wBAAwB,CAAC;AAChF,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EACL,QAAQ,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,cAAc,EACxF,mBAAmB,EAAE,wBAAwB,EAAE,kBAAkB,EACX,aAAa,EAAE,2BAA2B,GACjG,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACnH,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gCAAgC,CAAC;AAC/C,cAAc,mCAAmC,CAAC;AAClD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oCAAoC,CAAC;AACnD,cAAc,uCAAuC,CAAC;AACtD,cAAc,yCAAyC,CAAC;AACxD,cAAc,+CAA+C,CAAC;AAE9D,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,cAAc,0BAA0B,CAAC;AACzC,cAAc,cAAc,CAAC;AAC7B,cAAc,wBAAwB,CAAC;AAEvC;;GAEG;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 \"./Constants\";\r\nexport * from \"./Context\";\r\nexport * from \"./DelayedPromise\";\r\nexport * from \"./Deserialization/SchemaGraphUtil\";\r\nexport * from \"./Deserialization/JsonProps\";\r\nexport * from \"./Deserialization/Helper\";\r\nexport * from \"./Deserialization/XmlParser\";\r\nexport * from \"./ECName\";\r\nexport * from \"./ECObjects\";\r\nexport * from \"./Exception\";\r\nexport * from \"./Interfaces\";\r\nexport { ECClass, StructClass } from \"./Metadata/Class\";\r\nexport { Constant } from \"./Metadata/Constant\";\r\nexport { CustomAttributeClass } from \"./Metadata/CustomAttributeClass\";\r\nexport { EntityClass } from \"./Metadata/EntityClass\";\r\nexport { AnyEnumerator, Enumeration, Enumerator } from \"./Metadata/Enumeration\";\r\nexport { Format } from \"./Metadata/Format\";\r\nexport { InvertedUnit } from \"./Metadata/InvertedUnit\";\r\nexport { KindOfQuantity } from \"./Metadata/KindOfQuantity\";\r\nexport { Mixin } from \"./Metadata/Mixin\";\r\nexport * from \"./Metadata/OverrideFormat\";\r\nexport { Phenomenon } from \"./Metadata/Phenomenon\";\r\nexport {\r\n  Property, PrimitiveProperty, PrimitiveArrayProperty, EnumerationProperty, StructProperty,\r\n  StructArrayProperty, EnumerationArrayProperty, NavigationProperty, AnyArrayProperty, AnyEnumerationProperty,\r\n  AnyPrimitiveProperty, AnyProperty, AnyStructProperty, ArrayProperty, PrimitiveOrEnumPropertyBase,\r\n} from \"./Metadata/Property\";\r\nexport { PropertyCategory } from \"./Metadata/PropertyCategory\";\r\nexport { RelationshipClass, RelationshipConstraint, RelationshipMultiplicity } from \"./Metadata/RelationshipClass\";\r\nexport { Schema } from \"./Metadata/Schema\";\r\nexport * from \"./Metadata/SchemaItem\";\r\nexport { Unit } from \"./Metadata/Unit\";\r\nexport { UnitSystem } from \"./Metadata/UnitSystem\";\r\nexport * from \"./PropertyTypes\";\r\nexport * from \"./SchemaJsonLocater\";\r\nexport * from \"./SchemaKey\";\r\nexport * from \"./SchemaLoader\";\r\nexport * from \"./UnitConversion/UnitConverter\";\r\nexport * from \"./UnitProvider/SchemaUnitProvider\";\r\nexport * from \"./Validation/SchemaWalker\";\r\nexport * from \"./SchemaPartVisitorDelegate\";\r\nexport * from \"./Formatting/SchemaFormatsProvider\";\r\nexport * from \"./Formatting/FormatSetFormatsProvider\";\r\nexport * from \"./IncrementalLoading/ECSqlSchemaLocater\";\r\nexport * from \"./IncrementalLoading/IncrementalSchemaLocater\";\r\nexport { CustomAttribute, CustomAttributeContainerProps } from \"./Metadata/CustomAttribute\";\r\nexport { SchemaGraph } from \"./utils/SchemaGraph\";\r\nexport * from \"./SchemaViewBinaryReader\";\r\nexport * from \"./SchemaView\";\r\nexport * from \"./SchemaViewInterfaces\";\r\n\r\n/** @docs-package-description\r\n * The ecschema-metadata package contains classes for working with ECSchemas that can be used in both [frontend]($docs/learning/frontend/index.md) and [backend]($docs/learning/backend/index.md).\r\n */\r\n/**\r\n * @docs-group-description Metadata\r\n * Definitions of classes and interfaces that represent all [EC elements]($docs/bis/ec/index.md).\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-metadata.js","sourceRoot":"","sources":["../../src/ecschema-metadata.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAE/F,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,mCAAmC,CAAC;AAClD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAiB,WAAW,EAAc,MAAM,wBAAwB,CAAC;AAChF,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EACL,QAAQ,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,cAAc,EACxF,mBAAmB,EAAE,wBAAwB,EAAE,kBAAkB,EACX,aAAa,EAAE,2BAA2B,GACjG,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACnH,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gCAAgC,CAAC;AAC/C,cAAc,mCAAmC,CAAC;AAClD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oCAAoC,CAAC;AACnD,cAAc,uCAAuC,CAAC;AACtD,cAAc,yCAAyC,CAAC;AACxD,cAAc,+CAA+C,CAAC;AAE9D,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,cAAc,0BAA0B,CAAC;AACzC,cAAc,cAAc,CAAC;AAC7B,cAAc,wBAAwB,CAAC;AACvC,cAAc,kCAAkC,CAAC;AACjD,cAAc,qCAAqC,CAAC;AACpD,cAAc,mCAAmC,CAAC;AAElD;;GAEG;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 \"./Constants\";\r\nexport * from \"./Context\";\r\nexport * from \"./DelayedPromise\";\r\nexport * from \"./Deserialization/SchemaGraphUtil\";\r\nexport * from \"./Deserialization/JsonProps\";\r\nexport * from \"./Deserialization/Helper\";\r\nexport * from \"./Deserialization/XmlParser\";\r\nexport * from \"./ECName\";\r\nexport * from \"./ECObjects\";\r\nexport * from \"./Exception\";\r\nexport * from \"./Interfaces\";\r\nexport { ECClass, StructClass } from \"./Metadata/Class\";\r\nexport { Constant } from \"./Metadata/Constant\";\r\nexport { CustomAttributeClass } from \"./Metadata/CustomAttributeClass\";\r\nexport { EntityClass } from \"./Metadata/EntityClass\";\r\nexport { AnyEnumerator, Enumeration, Enumerator } from \"./Metadata/Enumeration\";\r\nexport { Format } from \"./Metadata/Format\";\r\nexport { InvertedUnit } from \"./Metadata/InvertedUnit\";\r\nexport { KindOfQuantity } from \"./Metadata/KindOfQuantity\";\r\nexport { Mixin } from \"./Metadata/Mixin\";\r\nexport * from \"./Metadata/OverrideFormat\";\r\nexport { Phenomenon } from \"./Metadata/Phenomenon\";\r\nexport {\r\n  Property, PrimitiveProperty, PrimitiveArrayProperty, EnumerationProperty, StructProperty,\r\n  StructArrayProperty, EnumerationArrayProperty, NavigationProperty, AnyArrayProperty, AnyEnumerationProperty,\r\n  AnyPrimitiveProperty, AnyProperty, AnyStructProperty, ArrayProperty, PrimitiveOrEnumPropertyBase,\r\n} from \"./Metadata/Property\";\r\nexport { PropertyCategory } from \"./Metadata/PropertyCategory\";\r\nexport { RelationshipClass, RelationshipConstraint, RelationshipMultiplicity } from \"./Metadata/RelationshipClass\";\r\nexport { Schema } from \"./Metadata/Schema\";\r\nexport * from \"./Metadata/SchemaItem\";\r\nexport { Unit } from \"./Metadata/Unit\";\r\nexport { UnitSystem } from \"./Metadata/UnitSystem\";\r\nexport * from \"./PropertyTypes\";\r\nexport * from \"./SchemaJsonLocater\";\r\nexport * from \"./SchemaKey\";\r\nexport * from \"./SchemaLoader\";\r\nexport * from \"./UnitConversion/UnitConverter\";\r\nexport * from \"./UnitProvider/SchemaUnitProvider\";\r\nexport * from \"./Validation/SchemaWalker\";\r\nexport * from \"./SchemaPartVisitorDelegate\";\r\nexport * from \"./Formatting/SchemaFormatsProvider\";\r\nexport * from \"./Formatting/FormatSetFormatsProvider\";\r\nexport * from \"./IncrementalLoading/ECSqlSchemaLocater\";\r\nexport * from \"./IncrementalLoading/IncrementalSchemaLocater\";\r\nexport { CustomAttribute, CustomAttributeContainerProps } from \"./Metadata/CustomAttribute\";\r\nexport { SchemaGraph } from \"./utils/SchemaGraph\";\r\nexport * from \"./SchemaViewBinaryReader\";\r\nexport * from \"./SchemaView\";\r\nexport * from \"./SchemaViewInterfaces\";\r\nexport * from \"./Localization/LocalizationTypes\";\r\nexport * from \"./Localization/LocalizationProvider\";\r\nexport * from \"./Localization/SchemaLocalization\";\r\n\r\n/** @docs-package-description\r\n * The ecschema-metadata package contains classes for working with ECSchemas that can be used in both [frontend]($docs/learning/frontend/index.md) and [backend]($docs/learning/backend/index.md).\r\n */\r\n/**\r\n * @docs-group-description Metadata\r\n * Definitions of classes and interfaces that represent all [EC elements]($docs/bis/ec/index.md).\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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@itwin/ecschema-metadata",
-  "version": "5.11.0-dev.3",
+  "version": "5.11.0-dev.5",
   "description": "ECObjects core concepts in typescript",
   "license": "MIT",
   "main": "lib/cjs/ecschema-metadata.js",
@@ -41,13 +41,13 @@
     "rimraf": "^6.0.1",
     "typescript": "~5.6.2",
     "vitest": "^3.0.6",
-    "@itwin/build-tools": "5.11.0-dev.3",
-    "@itwin/core-bentley": "5.11.0-dev.3",
-    "@itwin/core-quantity": "5.11.0-dev.3"
+    "@itwin/build-tools": "5.11.0-dev.5",
+    "@itwin/core-bentley": "5.11.0-dev.5",
+    "@itwin/core-quantity": "5.11.0-dev.5"
   },
   "peerDependencies": {
-    "@itwin/core-bentley": "5.11.0-dev.3",
-    "@itwin/core-quantity": "5.11.0-dev.3"
+    "@itwin/core-bentley": "5.11.0-dev.5",
+    "@itwin/core-quantity": "5.11.0-dev.5"
   },
   "scripts": {
     "build": "npm run -s build:cjs && npm run -s build:esm",