@itwin/ecschema-rpcinterface-tests 5.12.0-dev.16 → 5.12.0-dev.18

package/lib/dist/bundled-tests.js

@@ -75576,20 +75576,160 @@ class SchemaPartVisitorDelegate {
 
 /***/ },
 
-/***/ "../../core/ecschema-metadata/lib/esm/SchemaView.js"
-/*!**********************************************************!*\
-  !*** ../../core/ecschema-metadata/lib/esm/SchemaView.js ***!
-  \**********************************************************/
+/***/ "../../core/ecschema-metadata/lib/esm/SchemaView/SchemaManifest.js"
+/*!*************************************************************************!*\
+  !*** ../../core/ecschema-metadata/lib/esm/SchemaView/SchemaManifest.js ***!
+  \*************************************************************************/
 (__unused_webpack_module, __webpack_exports__, __webpack_require__) {
 
 "use strict";
 __webpack_require__.r(__webpack_exports__);
 /* harmony export */ __webpack_require__.d(__webpack_exports__, {
-/* harmony export */   SchemaView: () => (/* binding */ SchemaView),
-/* harmony export */   SchemaViewBuilder: () => (/* binding */ SchemaViewBuilder)
+/* harmony export */   SchemaManifest: () => (/* binding */ SchemaManifest)
 /* harmony export */ });
-/* harmony import */ var _SchemaViewInterfaces__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./SchemaViewInterfaces */ "../../core/ecschema-metadata/lib/esm/SchemaViewInterfaces.js");
-/* harmony import */ var _SchemaViewBinaryReader__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ./SchemaViewBinaryReader */ "../../core/ecschema-metadata/lib/esm/SchemaViewBinaryReader.js");
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Schema
+ */
+/** The reference graph of every schema in one iModel - names, versions and reference edges, without
+ * any schema data. A {@link (SchemaView:class)} husk loads it up front to answer which schemas exist
+ * and which dependency-ordered set it must load to satisfy a request.
+ *
+ * A `SchemaViewDataProvider` builds the manifest from ECDbMeta rows via {@link SchemaManifest.fromRows}.
+ * The entries are a flat array with no iModel or platform dependency; even the largest iModels hold
+ * on the order of a hundred schemas, so the closure and topological walks are plain recursion.
+ * @note The manifest does not track which schemas are already loaded. `SchemaViewManager` does that
+ * and filters the result of {@link SchemaManifest.getSchemaClosure} itself.
+ * @internal
+ */
+class SchemaManifest {
+    _entries;
+    _byLowerName;
+    /** Wraps a set of entries whose references are already wired to one another. */
+    constructor(entries) {
+        this._entries = entries;
+        const byLowerName = new Map();
+        for (const entry of entries)
+            byLowerName.set(entry.name.toLowerCase(), entry);
+        this._byLowerName = byLowerName;
+    }
+    /** Build a manifest from raw ECDbMeta query rows, so a `SchemaViewDataProvider` only has to run
+     * the two queries and hand the rows over. Reference rows whose endpoints are unknown or
+     * self-referential are skipped; that cannot happen for a well-formed iModel.
+     * @internal
+     */
+    static fromRows(schemaRows, referenceRows) {
+        const entries = [];
+        const entryByECInstanceId = new Map();
+        for (const row of schemaRows) {
+            const entry = {
+                name: row.name,
+                readVersion: row.versionMajor,
+                writeVersion: row.versionWrite,
+                minorVersion: row.versionMinor,
+                references: [],
+            };
+            entries.push(entry);
+            entryByECInstanceId.set(row.ecInstanceId, entry);
+        }
+        for (const row of referenceRows) {
+            const source = entryByECInstanceId.get(row.sourceECInstanceId);
+            const target = entryByECInstanceId.get(row.targetECInstanceId);
+            if (source === undefined || target === undefined || source === target || source.references.includes(target))
+                continue;
+            source.references.push(target);
+        }
+        return new SchemaManifest(entries);
+    }
+    /** The number of schemas in the iModel. */
+    get schemaCount() { return this._entries.length; }
+    /** The names of every schema in the iModel, in manifest order. */
+    getAvailableSchemaNames() {
+        return this._entries.map((entry) => entry.name);
+    }
+    get entries() {
+        return this._entries;
+    }
+    /** The entry for a schema by name (case-insensitive), or `undefined` if the iModel has no such schema. */
+    findByName(name) {
+        return this._byLowerName.get(name.toLowerCase());
+    }
+    /** The transitive reference closure of the requested schemas, as a flat, duplicate-free list of
+     * names: the full set that must be present to use them. The order is unspecified - run
+     * {@link SchemaManifest.sortInDependencyOrder} on the result when a load order is needed.
+     * @note Requested names the iModel does not contain are ignored; check
+     * {@link SchemaManifest.findByName} first to detect them.
+     */
+    getSchemaClosure(requestedNames) {
+        const result = [];
+        const visited = new Set();
+        const visit = (entry) => {
+            if (visited.has(entry))
+                return;
+            visited.add(entry);
+            result.push(entry.name);
+            for (const reference of entry.references)
+                visit(reference);
+        };
+        for (const name of requestedNames) {
+            const entry = this._byLowerName.get(name.toLowerCase());
+            if (entry !== undefined)
+                visit(entry);
+        }
+        return result;
+    }
+    /** Orders the given schema names so each appears after every schema it references, directly or
+     * transitively. References through schemas not in `schemaNames` are still honored, so the order is
+     * correct even when an intermediate schema is left out. Names the iModel does not contain are
+     * ignored, and reference cycles - which EC forbids - are broken arbitrarily rather than looping.
+     * @internal
+     */
+    sortInDependencyOrder(schemaNames) {
+        const requested = new Set();
+        for (const name of schemaNames) {
+            const entry = this._byLowerName.get(name.toLowerCase());
+            if (entry !== undefined)
+                requested.add(entry);
+        }
+        const result = [];
+        const visited = new Set();
+        const visiting = new Set();
+        const visit = (entry) => {
+            if (visited.has(entry) || visiting.has(entry))
+                return;
+            visiting.add(entry);
+            for (const reference of entry.references)
+                visit(reference);
+            visiting.delete(entry);
+            visited.add(entry);
+            if (requested.has(entry))
+                result.push(entry.name);
+        };
+        for (const entry of requested)
+            visit(entry);
+        return result;
+    }
+}
+
+
+/***/ },
+
+/***/ "../../core/ecschema-metadata/lib/esm/SchemaView/SchemaView.js"
+/*!*********************************************************************!*\
+  !*** ../../core/ecschema-metadata/lib/esm/SchemaView/SchemaView.js ***!
+  \*********************************************************************/
+(__unused_webpack_module, __webpack_exports__, __webpack_require__) {
+
+"use strict";
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   SchemaView: () => (/* binding */ SchemaView)
+/* harmony export */ });
+/* harmony import */ var _SchemaViewInterfaces__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./SchemaViewInterfaces */ "../../core/ecschema-metadata/lib/esm/SchemaView/SchemaViewInterfaces.js");
+/* harmony import */ var _SchemaViewBinaryReader__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ./SchemaViewBinaryReader */ "../../core/ecschema-metadata/lib/esm/SchemaView/SchemaViewBinaryReader.js");
 /*---------------------------------------------------------------------------------------------
 * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
 * See LICENSE.md in the project root for license terms and full copyright notice.
@@ -75620,16 +75760,21 @@ class SchemaView {
     [_storage];
     _schemaToken;
     _outdated = false;
+    /** When present, this view is a *husk*: it retains the live builder and cross-reference maps, so
+     * `mergeFragment` can append further fragment blobs. Undefined for one-shot views from `fromBinary`. */
+    _mergeContext;
     /** @internal */
-    constructor(data, schemaToken) {
+    constructor(data, schemaToken, mergeContext) {
         this[_storage] = {
             ...data,
             transitiveBaseCache: new Map(),
             derivedClassMap: undefined,
         };
         this._schemaToken = schemaToken ?? "";
+        this._mergeContext = mergeContext;
     }
-    /** SHA3-256 content hash of the ec_ schema tables at the time this view was built.
+    /** Cache-invalidation token identifying the schemas this view was built from: a hash of every
+     * schema's name and version (see `PRAGMA checksum(schema_token)`), not of their full contents.
      * Empty string if not set (e.g., when built from a builder without a token).
      * @beta
      */
@@ -75693,17 +75838,37 @@ class SchemaView {
     }
     /** Parse a binary blob into a SchemaView. Synchronous.
      * @param blob - The binary blob from `PRAGMA schema_view`.
-     * @param schemaToken - Optional SHA3-256 content hash for cache invalidation.
+     * @param schemaToken - Optional cache-invalidation token (schema name+version hash; see `PRAGMA checksum(schema_token)`).
      * @beta
      */
     static fromBinary(blob, schemaToken) {
         return (0,_SchemaViewBinaryReader__WEBPACK_IMPORTED_MODULE_1__.parseSchemaViewBlob)(blob, schemaToken);
     }
-    /** Build from a pre-populated builder (used by the binary parser).
+    /** Create an empty, *mergeable* view (a "husk"). It contains no schemas until `mergeFragment` is
+     * called. Each merged fragment is appended into the same instance, so flyweights and cached
+     * cross-references obtained earlier stay valid - indices are append-only and never reordered.
+     * @note Fragments must be merged in dependency order: a fragment may only reference schemas from
+     * fragments already merged.
+     * @internal
+     */
+    static createMergeable(schemaToken) {
+        const ctx = new _SchemaViewBinaryReader__WEBPACK_IMPORTED_MODULE_1__.SchemaViewMergeContext();
+        return new SchemaView(ctx.builder.assembleData(), schemaToken, ctx);
+    }
+    /** Merge one fragment blob into this view. Only valid on a view created via `createMergeable`.
+     * Synchronous. Any flyweight or cached index obtained before the call remains valid.
+     * @note If the merge throws (e.g. on a malformed blob), the view may be left partially extended
+     * and must be discarded by the host.
      * @internal
      */
-    static fromBuilder(builder, schemaToken) {
-        return builder.build(schemaToken);
+    mergeFragment(blob) {
+        if (this._mergeContext === undefined)
+            throw new Error("SchemaView is not mergeable: create it via SchemaView.createMergeable to merge fragments.");
+        this._mergeContext.mergeBlob(blob);
+        // A new fragment can add subclasses to an already-present base class, so the derived-class map
+        // must be rebuilt. transitiveBaseCache stays valid: a class's ancestors are always merged
+        // before it (dependency order), so an append never adds an ancestor to an already-cached class.
+        this[_storage].derivedClassMap = undefined;
     }
     // --- Internal helpers used by view objects ---
     /** Resolve a qualified "SchemaName:ItemName" (or dot-separated) to an index using the given
@@ -76598,215 +76763,26 @@ class SchemaView {
     }
     SchemaView.RelConstraint = RelConstraint;
 })(SchemaView || (SchemaView = {}));
-// =====================================================================================
-// SchemaViewBuilder
-// =====================================================================================
-/** Builder for constructing an immutable `SchemaView`.
- *
- * Collects data during binary blob parsing, then freezes it into a view.
- * Handles string interning and property definition deduplication.
- *
- * Consumers should not use this directly - read views via `IModelDb.getSchemaView`
- * / `IModelConnection.getSchemaView` (or `SchemaView.fromBinary` if you have a raw blob).
- * @internal
- */
-class SchemaViewBuilder {
-    _strings = [""]; // SID 0 = empty string
-    _lowerStrings = [""];
-    _stringMap = new Map(); // original value -> SID
-    _schemas = [];
-    _classes = [];
-    _classMixins = [];
-    _propDefs = [];
-    _propertyRefs = [];
-    _relConstraints = [];
-    _constraintClassRefs = [];
-    _enumerations = [];
-    _enumerators = [];
-    _koqs = [];
-    _propCategories = [];
-    // For PropertyDef dedup
-    _propDefMap = new Map(); // signature string -> defIdx
-    /** Intern a string, returning its SID. Empty/undefined strings return 0.
-     * Interning is case-sensitive - "MyLabel" and "MYLABEL" get distinct SIDs.
-     * The `lowerStrings` array provides case-insensitive lookup without mutating display values.
-     */
-    internString(value) {
-        if (value === undefined || value === "")
-            return 0;
-        const existing = this._stringMap.get(value);
-        if (existing !== undefined)
-            return existing;
-        const sid = this._strings.length;
-        this._strings.push(value);
-        this._lowerStrings.push(value.toLowerCase());
-        this._stringMap.set(value, sid);
-        return sid;
-    }
-    /** Add a schema. Returns its index. */
-    addSchema(data) {
-        const idx = this._schemas.length;
-        this._schemas.push(data);
-        return idx;
-    }
-    /** Add a class. Returns its index. Must be called after the owning schema. */
-    addClass(data) {
-        const idx = this._classes.length;
-        this._classes.push(data);
-        return idx;
-    }
-    /** Add a property definition with deduplication. Returns the def index (possibly existing). */
-    addPropertyDef(data) {
-        const sig = this._propDefSignature(data);
-        const existing = this._propDefMap.get(sig);
-        if (existing !== undefined)
-            return existing;
-        const idx = this._propDefs.length;
-        this._propDefs.push(data);
-        this._propDefMap.set(sig, idx);
-        return idx;
-    }
-    /** Append a property reference to the flat refs array. */
-    addPropertyRef(ref) {
-        this._propertyRefs.push(ref);
-    }
-    /** Add an enumeration. Returns its index. */
-    addEnumeration(data) {
-        const idx = this._enumerations.length;
-        this._enumerations.push(data);
-        return idx;
-    }
-    /** Append an enumerator to the flat enumerators array. */
-    addEnumerator(data) {
-        this._enumerators.push(data);
-    }
-    /** Add a KindOfQuantity. Returns its index. */
-    addKoq(data) {
-        const idx = this._koqs.length;
-        this._koqs.push(data);
-        return idx;
-    }
-    /** Add a PropertyCategory. Returns its index. */
-    addPropertyCategory(data) {
-        const idx = this._propCategories.length;
-        this._propCategories.push(data);
-        return idx;
-    }
-    /** Add a relationship constraint. Returns its index. */
-    addRelConstraint(data) {
-        const idx = this._relConstraints.length;
-        this._relConstraints.push(data);
-        return idx;
-    }
-    /** Append a constraint class reference to the flat array. */
-    addConstraintClassRef(classIdx) {
-        this._constraintClassRefs.push(classIdx);
-    }
-    /** Append a mixin class reference to the flat array. */
-    addClassMixin(classIdx) {
-        this._classMixins.push(classIdx);
-    }
-    /** The current count of property refs (used to set ownPropStart on ClassData). */
-    get propertyRefCount() { return this._propertyRefs.length; }
-    /** The current count of enumerators (used to set enumeratorStart on EnumerationData). */
-    get enumeratorCount() { return this._enumerators.length; }
-    /** The current count of constraint class refs (used to set classRefStart). */
-    get constraintClassRefCount() { return this._constraintClassRefs.length; }
-    /** The current count of class mixins (used to set mixinStartIdx). */
-    get classMixinCount() { return this._classMixins.length; }
-    /** Get a string by SID. @internal */
-    getString(sid) { return this._strings[sid]; }
-    /** Replace class data at the given index (used during deferred cross-ref resolution). @internal */
-    updateClass(classIdx, data) { this._classes[classIdx] = data; }
-    /** Update range fields on a schema (used after all items for a schema are collected). @internal */
-    updateSchemaRanges(schemaIdx, ranges) {
-        const s = this._schemas[schemaIdx];
-        this._schemas[schemaIdx] = { ...s, ...ranges };
-    }
-    /** Freeze all data and produce an immutable SchemaView. */
-    build(schemaToken) {
-        const schemaByName = new Map();
-        const schemaByAlias = new Map();
-        const classByName = new Map();
-        const enumByName = new Map();
-        const koqByName = new Map();
-        const catByName = new Map();
-        // Build schema lookup maps
-        for (let i = 0; i < this._schemas.length; i++) {
-            const s = this._schemas[i];
-            schemaByName.set(this._lowerStrings[s.nameStringIdx], i);
-            if (s.aliasStringIdx !== 0)
-                schemaByAlias.set(this._lowerStrings[s.aliasStringIdx], i);
-            // Build class-by-name map for this schema
-            const classMap = new Map();
-            for (let c = s.classRangeStart; c < s.classRangeStart + s.classCount; c++)
-                classMap.set(this._lowerStrings[this._classes[c].nameStringIdx], c);
-            classByName.set(i, classMap);
-            // Build enum-by-name map for this schema
-            const eMap = new Map();
-            for (let e = s.enumRangeStart; e < s.enumRangeStart + s.enumCount; e++)
-                eMap.set(this._lowerStrings[this._enumerations[e].nameStringIdx], e);
-            enumByName.set(i, eMap);
-            // Build koq-by-name map for this schema
-            const kMap = new Map();
-            for (let k = s.koqRangeStart; k < s.koqRangeStart + s.koqCount; k++)
-                kMap.set(this._lowerStrings[this._koqs[k].nameStringIdx], k);
-            koqByName.set(i, kMap);
-            // Build category-by-name map for this schema
-            const cMap = new Map();
-            for (let p = s.catRangeStart; p < s.catRangeStart + s.catCount; p++)
-                cMap.set(this._lowerStrings[this._propCategories[p].nameStringIdx], p);
-            catByName.set(i, cMap);
-        }
-        return new SchemaView({
-            strings: this._strings,
-            lowerStrings: this._lowerStrings,
-            schemas: this._schemas,
-            classes: this._classes,
-            classMixins: this._classMixins,
-            propDefs: this._propDefs,
-            propertyRefs: this._propertyRefs,
-            relConstraints: this._relConstraints,
-            constraintClassRefs: this._constraintClassRefs,
-            enumerations: this._enumerations,
-            enumerators: this._enumerators,
-            koqs: this._koqs,
-            propCategories: this._propCategories,
-            schemaByName,
-            schemaByAlias,
-            classByName,
-            enumByName,
-            koqByName,
-            catByName,
-        }, schemaToken);
-    }
-    /** Produce a dedup signature for a PropertyDef. Label and priority are excluded because
-     * they are per-PropertyRef overrides, not part of the structural definition.
-     * Uses SIDs (not lowercase strings) for name/description so that case-preserving names
-     * stay distinct - matching the C++ writer's dedup behavior. */
-    _propDefSignature(def) {
-        return `${def.nameStringIdx}|${def.kind}|${def.primitiveType}|${def.extTypeStringIdx}|${def.enumIdx}|${def.koqIdx}|${def.structClassIdx}|${def.navRelClassIdx}|${def.navDirection}|${def.categoryIdx}|${def.isReadOnly ? 1 : 0}|${def.isHidden ? 1 : 0}|${def.arrayMinOccurs}|${def.arrayMaxOccurs}|${def.descriptionStringIdx}`;
-    }
-}
 
 
 /***/ },
 
-/***/ "../../core/ecschema-metadata/lib/esm/SchemaViewBinaryReader.js"
-/*!**********************************************************************!*\
-  !*** ../../core/ecschema-metadata/lib/esm/SchemaViewBinaryReader.js ***!
-  \**********************************************************************/
+/***/ "../../core/ecschema-metadata/lib/esm/SchemaView/SchemaViewBinaryReader.js"
+/*!*********************************************************************************!*\
+  !*** ../../core/ecschema-metadata/lib/esm/SchemaView/SchemaViewBinaryReader.js ***!
+  \*********************************************************************************/
 (__unused_webpack_module, __webpack_exports__, __webpack_require__) {
 
 "use strict";
 __webpack_require__.r(__webpack_exports__);
 /* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   SchemaViewMergeContext: () => (/* binding */ SchemaViewMergeContext),
 /* harmony export */   parseSchemaViewBlob: () => (/* binding */ parseSchemaViewBlob)
 /* harmony export */ });
 /* harmony import */ var _itwin_core_bentley__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! @itwin/core-bentley */ "../../core/bentley/lib/esm/core-bentley.js");
-/* harmony import */ var _SchemaView__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ./SchemaView */ "../../core/ecschema-metadata/lib/esm/SchemaView.js");
-/* harmony import */ var _ECObjects__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(/*! ./ECObjects */ "../../core/ecschema-metadata/lib/esm/ECObjects.js");
-/* harmony import */ var _SchemaViewInterfaces__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(/*! ./SchemaViewInterfaces */ "../../core/ecschema-metadata/lib/esm/SchemaViewInterfaces.js");
+/* harmony import */ var _SchemaViewBuilder__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ./SchemaViewBuilder */ "../../core/ecschema-metadata/lib/esm/SchemaView/SchemaViewBuilder.js");
+/* harmony import */ var _ECObjects__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(/*! ../ECObjects */ "../../core/ecschema-metadata/lib/esm/ECObjects.js");
+/* harmony import */ var _SchemaViewInterfaces__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(/*! ./SchemaViewInterfaces */ "../../core/ecschema-metadata/lib/esm/SchemaView/SchemaViewInterfaces.js");
 /*---------------------------------------------------------------------------------------------
 * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
 * See LICENSE.md in the project root for license terms and full copyright notice.
@@ -76907,7 +76883,34 @@ function expectTag(reader, expected) {
     if (tag !== expected)
         throw new Error(`Expected tag 0x${expected.toString(16)} but found 0x${tag.toString(16)} at offset ${reader.pos - 1}`);
 }
-/** Parse a schema view blob (binary format) into a `SchemaView`.
+/** Reusable parse/merge context for SchemaView blobs. Holds the live `SchemaViewBuilder` plus the
+ * cross-reference maps that must persist across fragment merges. Each `mergeBlob` appends one blob's
+ * schemas into the shared builder and resolves cross-references - including cross-fragment ones -
+ * against the accumulated maps. A whole-iModel blob is the degenerate case of a single fragment.
+ * @note Fragments must be merged in dependency order, so a fragment only references schemas already
+ * merged by an earlier one (or excluded schemas, which resolve to "not present").
+ * @internal
+ */
+class SchemaViewMergeContext {
+    builder = new _SchemaViewBuilder__WEBPACK_IMPORTED_MODULE_1__.SchemaViewBuilder();
+    // Cross-reference maps. Persist across fragments: a row id / name from a later fragment resolves
+    // against a class, enum, koq, or category merged by an earlier fragment.
+    schemaECIdToIdx = new Map();
+    enumRowIdToIdx = new Map();
+    koqRowIdToIdx = new Map();
+    catRowIdToIdx = new Map();
+    classRowIdToIdx = new Map();
+    // "schemaname:classname" (both lowercased) -> global class index. Resolves base/mixin/constraint
+    // refs, which the blob encodes as schema+class name pairs, across fragment boundaries.
+    classResolver = new Map();
+    // global schemaIdx -> schema name, for building resolver keys and dangling-ref diagnostics.
+    schemaNames = [];
+    /** Parse one fragment blob and append its schemas into the shared builder. Synchronous. */
+    mergeBlob(data) {
+        mergeFragmentBlob(this, data);
+    }
+}
+/** Parse a schema view blob (binary format) into a fresh `SchemaView`.
  *
  * Layout: Header, PropertyDefTable, SchemaTable, EnumTable, KoQTable, PropCatTable, ClassTable, StringTable.
  * Each table is count-prefixed. Schema items carry their schema's ecInstanceId for ownership resolution.
@@ -76918,6 +76921,16 @@ function expectTag(reader, expected) {
  * @internal
  */
 function parseSchemaViewBlob(data, schemaToken) {
+    const ctx = new SchemaViewMergeContext();
+    ctx.mergeBlob(data);
+    return ctx.builder.build(schemaToken);
+}
+/** Parse one fragment blob and append it into the context's builder, resolving cross-references
+ * against the context's accumulated global maps. Per-fragment scratch state stays local; everything
+ * that must outlive the fragment lives on `ctx`.
+ */
+function mergeFragmentBlob(ctx, data) {
+    const builder = ctx.builder;
     const reader = new BinaryReader(data);
     // Header: magic(4) + version(1) + stringTableOffset(4)
     const magic = reader.readU32();
@@ -76928,16 +76941,10 @@ function parseSchemaViewBlob(data, schemaToken) {
         throw new Error(`Unsupported schema view format version: ${version}, expected ${_SchemaViewInterfaces__WEBPACK_IMPORTED_MODULE_3__.schemaViewFormatVersion}`);
     const stOffset = reader.readU32();
     reader.parseStringTable(stOffset);
-    const builder = new _SchemaView__WEBPACK_IMPORTED_MODULE_1__.SchemaViewBuilder();
-    // Cross-reference maps (ecInstanceId -> builder array index)
-    const schemaEcIdToIdx = new Map();
-    const enumRowIdToIdx = new Map();
-    const koqRowIdToIdx = new Map();
-    const catRowIdToIdx = new Map();
-    const classRowIdToIdx = new Map();
-    // Per-schema metadata for name-based class resolution
-    const schemaInfos = [];
-    // Per-schema item range tracking (indexed by schemaIdx)
+    // Global index of the first schema this fragment adds. Local schema index = global - base.
+    const schemaBaseIdx = builder.schemaCount;
+    const { schemaECIdToIdx: schemaEcIdToIdx, enumRowIdToIdx, koqRowIdToIdx, catRowIdToIdx, classRowIdToIdx, classResolver } = ctx;
+    // Per-schema item range tracking, indexed by LOCAL schema index (0-based within this fragment).
     const schemaEnumStarts = [];
     const schemaEnumCounts = [];
     const schemaKoqStarts = [];
@@ -76946,14 +76953,14 @@ function parseSchemaViewBlob(data, schemaToken) {
     const schemaCatCounts = [];
     const schemaClassStarts = [];
     const schemaClassCounts = [];
-    // Deferred class data for cross-reference resolution
+    // Deferred class data for cross-reference resolution (local to this fragment).
     const pendingClasses = [];
     // ---- PropertyDefTable ----
     expectTag(reader, Tag.PropertyDefTable);
     const defCount = reader.readU32();
-    // Each PreParsedDef consumes at least ~30 bytes (mix of u8/u16/u32 fields + string refs).
-    // Use a conservative lower bound of 8 bytes to catch wildly oversized counts on malformed blobs.
-    reader.validateCount(defCount, 8, "PropertyDefTable");
+    // Each PreParsedDef is a fixed 46 bytes (10x u32 + 1x u16 + 4x u8). The bound is deliberately
+    // about half that, so a valid blob never trips the check.
+    reader.validateCount(defCount, 23, "PropertyDefTable");
     const preParsedDefs = new Array(defCount);
     for (let i = 0; i < defCount; i++) {
         preParsedDefs[i] = {
@@ -76977,7 +76984,8 @@ function parseSchemaViewBlob(data, schemaToken) {
     // ---- SchemaTable ----
     expectTag(reader, Tag.SchemaTable);
     const schemaCount = reader.readU32();
-    reader.validateCount(schemaCount, 8, "SchemaTable");
+    // Fixed 27 bytes per record (4x SRef + 3x u16 + u32 + u8).
+    reader.validateCount(schemaCount, 13, "SchemaTable");
     for (let i = 0; i < schemaCount; i++) {
         const name = reader.readSRef();
         const vRead = reader.readU16();
@@ -77004,7 +77012,7 @@ function parseSchemaViewBlob(data, schemaToken) {
             isHidden,
         });
         schemaEcIdToIdx.set(ecInstanceId, schemaIdx);
-        schemaInfos.push({ name, schemaIdx, classNameToIdx: new Map() });
+        ctx.schemaNames[schemaIdx] = name;
         schemaEnumStarts.push(0);
         schemaEnumCounts.push(0);
         schemaKoqStarts.push(0);
@@ -77014,25 +77022,31 @@ function parseSchemaViewBlob(data, schemaToken) {
         schemaClassStarts.push(0);
         schemaClassCounts.push(0);
     }
-    /** Track an item's schema ownership and update range counters. */
+    /** Track an item's schema ownership and update its owning schema's range counters. `globalIdx`
+     * is the item's global index in the builder; `starts`/`counts` are indexed by LOCAL schema index.
+     * An item must be owned by a schema in its own fragment, so a foreign owner is a malformed blob. */
     function trackItem(schemaEcId, globalIdx, starts, counts) {
         const schemaIdx = schemaEcIdToIdx.get(schemaEcId);
         if (schemaIdx === undefined)
             throw new Error(`SchemaView blob: unknown schema ecInstanceId ${schemaEcId}`);
-        if (counts[schemaIdx] === 0)
-            starts[schemaIdx] = globalIdx;
-        counts[schemaIdx]++;
+        const localIdx = schemaIdx - schemaBaseIdx;
+        if (localIdx < 0 || localIdx >= schemaCount)
+            throw new Error(`SchemaView fragment: item references schema ecInstanceId ${schemaEcId} not present in this fragment`);
+        if (counts[localIdx] === 0)
+            starts[localIdx] = globalIdx;
+        counts[localIdx]++;
         return schemaIdx;
     }
     // ---- EnumTable ----
     expectTag(reader, Tag.EnumTable);
     const enumTotalCount = reader.readU32();
-    reader.validateCount(enumTotalCount, 8, "EnumTable");
+    // Fixed 27 bytes per record (4x SRef + 2x u32 + u16 + u8); enumerators live inside a JSON SRef.
+    reader.validateCount(enumTotalCount, 13, "EnumTable");
     for (let i = 0; i < enumTotalCount; i++) {
         const schemaEcId = reader.readU32();
-        const schemaIdx = trackItem(schemaEcId, i, schemaEnumStarts, schemaEnumCounts);
+        const schemaIdx = trackItem(schemaEcId, builder.enumerationCount, schemaEnumStarts, schemaEnumCounts);
         const eName = reader.readSRef();
-        const ePrimType = reader.readU8();
+        const ePrimType = reader.readU16();
         const eIsStrict = reader.readU8() !== 0;
         const eLabel = reader.readSRef();
         const eDesc = reader.readSRef();
@@ -77076,10 +77090,11 @@ function parseSchemaViewBlob(data, schemaToken) {
     // ---- KoQTable ----
     expectTag(reader, Tag.KoQTable);
     const koqTotalCount = reader.readU32();
-    reader.validateCount(koqTotalCount, 8, "KoQTable");
+    // Fixed 36 bytes per record (6x SRef + f64 + u32).
+    reader.validateCount(koqTotalCount, 18, "KoQTable");
     for (let i = 0; i < koqTotalCount; i++) {
         const schemaEcId = reader.readU32();
-        const schemaIdx = trackItem(schemaEcId, i, schemaKoqStarts, schemaKoqCounts);
+        const schemaIdx = trackItem(schemaEcId, builder.koqCount, schemaKoqStarts, schemaKoqCounts);
         const kName = reader.readSRef();
         const kLabel = reader.readSRef();
         const kDesc = reader.readSRef();
@@ -77102,10 +77117,11 @@ function parseSchemaViewBlob(data, schemaToken) {
     // ---- PropCatTable ----
     expectTag(reader, Tag.PropCatTable);
     const catTotalCount = reader.readU32();
-    reader.validateCount(catTotalCount, 8, "PropCatTable");
+    // Fixed 24 bytes per record (4x SRef + i32 + u32).
+    reader.validateCount(catTotalCount, 12, "PropCatTable");
     for (let i = 0; i < catTotalCount; i++) {
         const schemaEcId = reader.readU32();
-        const schemaIdx = trackItem(schemaEcId, i, schemaCatStarts, schemaCatCounts);
+        const schemaIdx = trackItem(schemaEcId, builder.propCategoryCount, schemaCatStarts, schemaCatCounts);
         const pcName = reader.readSRef();
         const pcLabel = reader.readSRef();
         const pcDesc = reader.readSRef();
@@ -77124,11 +77140,13 @@ function parseSchemaViewBlob(data, schemaToken) {
     // ---- ClassTable ----
     expectTag(reader, Tag.ClassTable);
     const classTotalCount = reader.readU32();
-    reader.validateCount(classTotalCount, 8, "ClassTable");
+    // Minimum 27 bytes per record (3x SRef + 3x u8 + u32 + 2x u16 count prefixes); records grow with
+    // relationship strength/direction and the base-class, prop-ref, and constraint sub-lists.
+    reader.validateCount(classTotalCount, 13, "ClassTable");
     for (let i = 0; i < classTotalCount; i++) {
         const schemaEcId = reader.readU32();
-        const schemaIdx = trackItem(schemaEcId, i, schemaClassStarts, schemaClassCounts);
-        const schemaInfo = schemaInfos[schemaIdx];
+        const schemaIdx = trackItem(schemaEcId, builder.classCount, schemaClassStarts, schemaClassCounts);
+        const schemaName = ctx.schemaNames[schemaIdx];
         const cName = reader.readSRef();
         const cType = reader.readU8();
         const cModifier = reader.readU8();
@@ -77218,7 +77236,7 @@ function parseSchemaViewBlob(data, schemaToken) {
             targetConstraintIdx: -1,
             isHidden: cIsHidden,
         });
-        schemaInfo.classNameToIdx.set(cName.toLowerCase(), classIdx);
+        classResolver.set(`${schemaName.toLowerCase()}:${cName.toLowerCase()}`, classIdx);
         classRowIdToIdx.set(cEcInstanceId, classIdx);
         pendingClasses.push({
             schemaIdx,
@@ -77234,13 +77252,14 @@ function parseSchemaViewBlob(data, schemaToken) {
             baseClasses,
             propRefs,
             constraints,
-            schemaName: schemaInfo.name,
+            schemaName,
             isHidden: cIsHidden,
         });
     }
     // ---- Finalize per-schema item ranges ----
+    // Local index i maps to global schema index schemaBaseIdx + i; range starts are already global.
     for (let i = 0; i < schemaCount; i++) {
-        builder.updateSchemaRanges(i, {
+        builder.updateSchemaRanges(schemaBaseIdx + i, {
             classRangeStart: schemaClassStarts[i] ?? 0,
             classCount: schemaClassCounts[i] ?? 0,
             enumRangeStart: schemaEnumStarts[i] ?? 0,
@@ -77251,12 +77270,6 @@ function parseSchemaViewBlob(data, schemaToken) {
             catCount: schemaCatCounts[i] ?? 0,
         });
     }
-    // Build a global name resolver: "SchemaName:ClassName" -> classIdx
-    const classResolver = new Map();
-    for (const s of schemaInfos) {
-        for (const [lowerName, idx] of s.classNameToIdx)
-            classResolver.set(`${s.name.toLowerCase()}:${lowerName}`, idx);
-    }
     // Resolve pre-parsed defs to PropertyDef objects. Maps preParsedDef index -> builder defIdx.
     const danglingRefs = [];
     const resolvedDefMap = new Map();
@@ -77411,16 +77424,259 @@ function parseSchemaViewBlob(data, schemaToken) {
         const lines = danglingRefs.length <= cap ? danglingRefs : [...danglingRefs.slice(0, cap), `... and ${danglingRefs.length - cap} more`];
         _itwin_core_bentley__WEBPACK_IMPORTED_MODULE_0__.Logger.logWarning("ecschema-metadata.SchemaView", `${danglingRefs.length} unresolved cross-reference(s) in schema view blob (likely from excluded schemas):\n  ${lines.join("\n  ")}`);
     }
-    return builder.build(schemaToken);
+    // Bring the builder's lookup maps up to date for the schemas this fragment added. Their item
+    // ranges were finalized above, so the per-schema name maps build correctly.
+    builder.extendLookupMaps();
 }
 
 
 /***/ },
 
-/***/ "../../core/ecschema-metadata/lib/esm/SchemaViewInterfaces.js"
-/*!********************************************************************!*\
-  !*** ../../core/ecschema-metadata/lib/esm/SchemaViewInterfaces.js ***!
-  \********************************************************************/
+/***/ "../../core/ecschema-metadata/lib/esm/SchemaView/SchemaViewBuilder.js"
+/*!****************************************************************************!*\
+  !*** ../../core/ecschema-metadata/lib/esm/SchemaView/SchemaViewBuilder.js ***!
+  \****************************************************************************/
+(__unused_webpack_module, __webpack_exports__, __webpack_require__) {
+
+"use strict";
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   SchemaViewBuilder: () => (/* binding */ SchemaViewBuilder)
+/* harmony export */ });
+/* harmony import */ var _SchemaView__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./SchemaView */ "../../core/ecschema-metadata/lib/esm/SchemaView/SchemaView.js");
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Schema
+ */
+
+/** Builder for constructing an immutable `SchemaView`.
+ *
+ * Collects data during binary blob parsing, then freezes it into a view.
+ * Handles string interning and property definition deduplication.
+ *
+ * Consumers should not use this directly - read views via `IModelDb.getSchemaView`
+ * / `IModelConnection.getSchemaView` (or `SchemaView.fromBinary` if you have a raw blob).
+ * @internal
+ */
+class SchemaViewBuilder {
+    _strings = [""]; // SID 0 = empty string
+    _lowerStrings = [""];
+    _stringMap = new Map(); // original value -> SID
+    _schemas = [];
+    _classes = [];
+    _classMixins = [];
+    _propDefs = [];
+    _propertyRefs = [];
+    _relConstraints = [];
+    _constraintClassRefs = [];
+    _enumerations = [];
+    _enumerators = [];
+    _koqs = [];
+    _propCategories = [];
+    // For PropertyDef dedup
+    _propDefMap = new Map(); // signature string -> defIdx
+    // Lookup maps - owned by the builder so a husk can share and extend them across fragment merges.
+    // `build()` and each merge call `extendLookupMaps()`; the view receives these same Map objects
+    // via `assembleData()`, so in-place growth is visible.
+    _schemaByName = new Map();
+    _schemaByAlias = new Map();
+    _classByName = new Map();
+    _enumByName = new Map();
+    _koqByName = new Map();
+    _catByName = new Map();
+    _lookupMapsBuiltUpto = 0; // number of schemas whose lookup entries are already built
+    /** Intern a string, returning its SID. Empty/undefined strings return 0.
+     * Interning is case-sensitive - "MyLabel" and "MYLABEL" get distinct SIDs.
+     * The `lowerStrings` array provides case-insensitive lookup without mutating display values.
+     */
+    internString(value) {
+        if (value === undefined || value === "")
+            return 0;
+        const existing = this._stringMap.get(value);
+        if (existing !== undefined)
+            return existing;
+        const sid = this._strings.length;
+        this._strings.push(value);
+        this._lowerStrings.push(value.toLowerCase());
+        this._stringMap.set(value, sid);
+        return sid;
+    }
+    /** Add a schema. Returns its index. */
+    addSchema(data) {
+        const idx = this._schemas.length;
+        this._schemas.push(data);
+        return idx;
+    }
+    /** Add a class. Returns its index. Must be called after the owning schema. */
+    addClass(data) {
+        const idx = this._classes.length;
+        this._classes.push(data);
+        return idx;
+    }
+    /** Add a property definition with deduplication. Returns the def index (possibly existing). */
+    addPropertyDef(data) {
+        const sig = this._propDefSignature(data);
+        const existing = this._propDefMap.get(sig);
+        if (existing !== undefined)
+            return existing;
+        const idx = this._propDefs.length;
+        this._propDefs.push(data);
+        this._propDefMap.set(sig, idx);
+        return idx;
+    }
+    /** Append a property reference to the flat refs array. */
+    addPropertyRef(ref) {
+        this._propertyRefs.push(ref);
+    }
+    /** Add an enumeration. Returns its index. */
+    addEnumeration(data) {
+        const idx = this._enumerations.length;
+        this._enumerations.push(data);
+        return idx;
+    }
+    /** Append an enumerator to the flat enumerators array. */
+    addEnumerator(data) {
+        this._enumerators.push(data);
+    }
+    /** Add a KindOfQuantity. Returns its index. */
+    addKoq(data) {
+        const idx = this._koqs.length;
+        this._koqs.push(data);
+        return idx;
+    }
+    /** Add a PropertyCategory. Returns its index. */
+    addPropertyCategory(data) {
+        const idx = this._propCategories.length;
+        this._propCategories.push(data);
+        return idx;
+    }
+    /** Add a relationship constraint. Returns its index. */
+    addRelConstraint(data) {
+        const idx = this._relConstraints.length;
+        this._relConstraints.push(data);
+        return idx;
+    }
+    /** Append a constraint class reference to the flat array. */
+    addConstraintClassRef(classIdx) {
+        this._constraintClassRefs.push(classIdx);
+    }
+    /** Append a mixin class reference to the flat array. */
+    addClassMixin(classIdx) {
+        this._classMixins.push(classIdx);
+    }
+    /** The current count of property refs (used to set ownPropStart on ClassData). */
+    get propertyRefCount() { return this._propertyRefs.length; }
+    /** The current count of enumerators (used to set enumeratorStart on EnumerationData). */
+    get enumeratorCount() { return this._enumerators.length; }
+    /** The current count of constraint class refs (used to set classRefStart). */
+    get constraintClassRefCount() { return this._constraintClassRefs.length; }
+    /** The current count of class mixins (used to set mixinStartIdx). */
+    get classMixinCount() { return this._classMixins.length; }
+    // The counts below are the base indices fragment merging uses to translate a fragment's local
+    // indices into global ones.
+    /** The current count of schemas. @internal */
+    get schemaCount() { return this._schemas.length; }
+    /** The current count of classes. @internal */
+    get classCount() { return this._classes.length; }
+    /** The current count of enumerations. @internal */
+    get enumerationCount() { return this._enumerations.length; }
+    /** The current count of KindOfQuantities. @internal */
+    get koqCount() { return this._koqs.length; }
+    /** The current count of property categories. @internal */
+    get propCategoryCount() { return this._propCategories.length; }
+    /** Get a string by SID. @internal */
+    getString(sid) { return this._strings[sid]; }
+    /** Replace class data at the given index (used during deferred cross-ref resolution). @internal */
+    updateClass(classIdx, data) { this._classes[classIdx] = data; }
+    /** Update range fields on a schema (used after all items for a schema are collected). @internal */
+    updateSchemaRanges(schemaIdx, ranges) {
+        const s = this._schemas[schemaIdx];
+        this._schemas[schemaIdx] = { ...s, ...ranges };
+    }
+    /** Freeze all data and produce an immutable SchemaView. */
+    build(schemaToken) {
+        this.extendLookupMaps();
+        return new _SchemaView__WEBPACK_IMPORTED_MODULE_0__.SchemaView(this.assembleData(), schemaToken);
+    }
+    /** Build lookup-map entries for any schemas added since the last call. Idempotent and
+     * append-only, so it is safe to call after each fragment merge. A schema's item ranges must
+     * already be finalized (via `updateSchemaRanges`) before it is processed.
+     * @internal */
+    extendLookupMaps() {
+        for (let i = this._lookupMapsBuiltUpto; i < this._schemas.length; i++) {
+            const s = this._schemas[i];
+            this._schemaByName.set(this._lowerStrings[s.nameStringIdx], i);
+            if (s.aliasStringIdx !== 0)
+                this._schemaByAlias.set(this._lowerStrings[s.aliasStringIdx], i);
+            // Build class-by-name map for this schema
+            const classMap = new Map();
+            for (let c = s.classRangeStart; c < s.classRangeStart + s.classCount; c++)
+                classMap.set(this._lowerStrings[this._classes[c].nameStringIdx], c);
+            this._classByName.set(i, classMap);
+            // Build enum-by-name map for this schema
+            const eMap = new Map();
+            for (let e = s.enumRangeStart; e < s.enumRangeStart + s.enumCount; e++)
+                eMap.set(this._lowerStrings[this._enumerations[e].nameStringIdx], e);
+            this._enumByName.set(i, eMap);
+            // Build koq-by-name map for this schema
+            const kMap = new Map();
+            for (let k = s.koqRangeStart; k < s.koqRangeStart + s.koqCount; k++)
+                kMap.set(this._lowerStrings[this._koqs[k].nameStringIdx], k);
+            this._koqByName.set(i, kMap);
+            // Build category-by-name map for this schema
+            const cMap = new Map();
+            for (let p = s.catRangeStart; p < s.catRangeStart + s.catCount; p++)
+                cMap.set(this._lowerStrings[this._propCategories[p].nameStringIdx], p);
+            this._catByName.set(i, cMap);
+        }
+        this._lookupMapsBuiltUpto = this._schemas.length;
+    }
+    /** Assemble a {@link SchemaViewData} bag that references this builder's live arrays and lookup
+     * maps. Continued building - fragment merges that append to the arrays and extend the maps in
+     * place - is visible through the shared references, so a husk holding this data sees merged
+     * schemas without rebuilding. @internal */
+    assembleData() {
+        return {
+            strings: this._strings,
+            lowerStrings: this._lowerStrings,
+            schemas: this._schemas,
+            classes: this._classes,
+            classMixins: this._classMixins,
+            propDefs: this._propDefs,
+            propertyRefs: this._propertyRefs,
+            relConstraints: this._relConstraints,
+            constraintClassRefs: this._constraintClassRefs,
+            enumerations: this._enumerations,
+            enumerators: this._enumerators,
+            koqs: this._koqs,
+            propCategories: this._propCategories,
+            schemaByName: this._schemaByName,
+            schemaByAlias: this._schemaByAlias,
+            classByName: this._classByName,
+            enumByName: this._enumByName,
+            koqByName: this._koqByName,
+            catByName: this._catByName,
+        };
+    }
+    /** Produce a dedup signature for a PropertyDef. Label and priority are excluded because
+     * they are per-PropertyRef overrides, not part of the structural definition.
+     * Uses SIDs (not lowercase strings) for name/description so that case-preserving names
+     * stay distinct - matching the C++ writer's dedup behavior. */
+    _propDefSignature(def) {
+        return `${def.nameStringIdx}|${def.kind}|${def.primitiveType}|${def.extTypeStringIdx}|${def.enumIdx}|${def.koqIdx}|${def.structClassIdx}|${def.navRelClassIdx}|${def.navDirection}|${def.categoryIdx}|${def.isReadOnly ? 1 : 0}|${def.isHidden ? 1 : 0}|${def.arrayMinOccurs}|${def.arrayMaxOccurs}|${def.descriptionStringIdx}`;
+    }
+}
+
+
+/***/ },
+
+/***/ "../../core/ecschema-metadata/lib/esm/SchemaView/SchemaViewInterfaces.js"
+/*!*******************************************************************************!*\
+  !*** ../../core/ecschema-metadata/lib/esm/SchemaView/SchemaViewInterfaces.js ***!
+  \*******************************************************************************/
 (__unused_webpack_module, __webpack_exports__, __webpack_require__) {
 
 "use strict";
@@ -77499,6 +77755,201 @@ var SchemaViewPrimitiveType;
 })(SchemaViewPrimitiveType || (SchemaViewPrimitiveType = {}));
 
 
+/***/ },
+
+/***/ "../../core/ecschema-metadata/lib/esm/SchemaView/SchemaViewManager.js"
+/*!****************************************************************************!*\
+  !*** ../../core/ecschema-metadata/lib/esm/SchemaView/SchemaViewManager.js ***!
+  \****************************************************************************/
+(__unused_webpack_module, __webpack_exports__, __webpack_require__) {
+
+"use strict";
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   SchemaViewManager: () => (/* binding */ SchemaViewManager)
+/* harmony export */ });
+/* harmony import */ var _SchemaView__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./SchemaView */ "../../core/ecschema-metadata/lib/esm/SchemaView/SchemaView.js");
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Schema
+ */
+
+/** Owns the lifetime of one iModel's {@link (SchemaView:class)}: lazy loading, incremental (filtered)
+ * hydration, serialization of concurrent requests, and invalidation. Hosts (`IModelDb`,
+ * `IModelConnection`) hold one instance and delegate to it; all data access goes through the
+ * host-implemented {@link SchemaViewDataProvider}.
+ * @internal
+ */
+class SchemaViewManager {
+    _dataProvider;
+    /** The single accumulating view, held as a promise so all requests chain onto it and never overlap.
+     * Undefined (or resolving to undefined) means nothing is loaded. */
+    _viewPromise;
+    /** Reference graph for incremental loading; undefined when the view is (or will be) fully loaded. */
+    _manifest;
+    /** Schema-identity token the manifest - and thus every fragment merged under it - belongs to. */
+    _manifestToken;
+    /** Lower-cased names already merged into the view (incremental mode only). */
+    _loadedSchemaNames = new Set();
+    constructor(dataProvider) {
+        this._dataProvider = dataProvider;
+    }
+    /** Get the schema view, loading whatever the request needs that is not present yet. See
+     * {@link GetSchemaViewArgs} for filtering and reload semantics; hosts document the full
+     * user-facing contract on their `getSchemaView` methods.
+     */
+    async getSchemaView(args) {
+        const previous = this._viewPromise;
+        const next = this._loadSchemaView(previous, args?.schemas, args?.forceReload === true);
+        this._viewPromise = next;
+        return next;
+    }
+    /** Throw away the current schema view. Called by the host when schemas may have changed (e.g.
+     * `IModelDb.clearCaches` after a schema import). Chains behind any in-flight load and marks the
+     * discarded view outdated; the next getSchemaView starts over.
+     */
+    reset() {
+        if (this._viewPromise) {
+            this._viewPromise = this._viewPromise.then((view) => { view?.markOutdated(); this._resetIncrementalState(); return undefined; }, () => { this._resetIncrementalState(); return undefined; });
+        }
+    }
+    /** Check whether the iModel's schemas have changed since the current view was built, and discard
+     * the view only if they have. For hosts that *cannot* determine whether an operation actually
+     * modified schemas - e.g. `BriefcaseConnection.pullChanges` on the frontend, whose IPC response
+     * carries only the new changeset id, not the applied changesets' types. Discarding after every
+     * such operation would reload unnecessarily in the common case where schemas are unchanged, so
+     * this compares the cheap schema-identity token instead.
+     * @note If the token cannot be fetched, the view is discarded rather than risking stale metadata.
+     */
+    async invalidateIfChanged() {
+        const previous = this._viewPromise;
+        if (previous === undefined)
+            return;
+        // Queue the check on the same chain as loading, so a getSchemaView arriving while the token is
+        // in flight cannot swap in a new promise for the same stale view and hide the schema change.
+        const next = this._invalidateIfChanged(previous);
+        this._viewPromise = next;
+        await next;
+    }
+    /** Serialized body of {@link SchemaViewManager.invalidateIfChanged}. Resolves to the view to keep,
+     * or to `undefined` when it was discarded and the next getSchemaView has to start over.
+     */
+    async _invalidateIfChanged(previous) {
+        let existing;
+        try {
+            existing = await previous;
+        }
+        catch {
+            return undefined;
+        }
+        if (existing === undefined)
+            return undefined;
+        // A view without a token (e.g. built directly from a SchemaViewBuilder) cannot be verified by
+        // token; views loaded through this manager always carry one.
+        if (existing.schemaToken === "")
+            return existing;
+        try {
+            if (await this._dataProvider.fetchSchemaToken() === existing.schemaToken)
+                return existing;
+        }
+        catch {
+            // Cannot verify the cached view: drop it rather than risk stale metadata.
+        }
+        existing.markOutdated();
+        this._resetIncrementalState();
+        return undefined;
+    }
+    /** Serialized body of {@link SchemaViewManager.getSchemaView}. On failure it resets and rejects,
+     * so the next call starts over.
+     */
+    async _loadSchemaView(previous, schemas, forceReload) {
+        let currentView;
+        if (previous !== undefined) {
+            try {
+                currentView = await previous;
+            }
+            catch {
+                currentView = undefined; // the failed load already reset; start over
+            }
+        }
+        if (forceReload) {
+            currentView?.markOutdated();
+            currentView = undefined;
+            this._resetIncrementalState();
+        }
+        try {
+            return await this._ensureSchemasLoaded(currentView, schemas);
+        }
+        catch (err) {
+            // A failed merge may have left the view partially extended - discard everything.
+            currentView?.markOutdated();
+            this._resetIncrementalState();
+            throw err;
+        }
+    }
+    /** Clear the incremental schema-view bookkeeping. */
+    _resetIncrementalState() {
+        this._manifest = undefined;
+        this._manifestToken = undefined;
+        this._loadedSchemaNames.clear();
+    }
+    /** Ensures the requested schemas (or all schemas, when no filter is given) are present in
+     * `currentView` (or a freshly created view) and returns it. The first load fixes the strategy:
+     * no filter fetches everything as one full blob; a filter fetches fragments and keeps the
+     * manifest and loaded-name set so later calls extend the same view. Once every schema is loaded
+     * the incremental state is dropped, collapsing back to full mode.
+     */
+    async _ensureSchemasLoaded(currentView, schemas, isRetry = false) {
+        const isFirstLoad = currentView === undefined;
+        // No manifest means everything is loaded; in incremental mode a filtered request is satisfied as
+        // soon as every requested name is present.
+        if (!isFirstLoad &&
+            (this._manifest === undefined ||
+                (schemas !== undefined && schemas.every((name) => this._loadedSchemaNames.has(name.toLowerCase())))))
+            return currentView;
+        if (isFirstLoad && schemas === undefined) {
+            const blob = await this._dataProvider.fetchFullBlob();
+            const schemaView = _SchemaView__WEBPACK_IMPORTED_MODULE_0__.SchemaView.fromBinary(blob.data, blob.schemaToken);
+            this._resetIncrementalState();
+            return schemaView;
+        }
+        if (this._manifest === undefined) {
+            // Token first: any schema change after this point shows up as a token mismatch below.
+            this._manifestToken = await this._dataProvider.fetchSchemaToken();
+            this._manifest = await this._dataProvider.fetchManifest();
+        }
+        const manifest = this._manifest;
+        const requested = schemas ?? manifest.getAvailableSchemaNames();
+        const namesToLoad = manifest.getSchemaClosure(requested).filter((name) => !this._loadedSchemaNames.has(name.toLowerCase()));
+        const husk = currentView ?? _SchemaView__WEBPACK_IMPORTED_MODULE_0__.SchemaView.createMergeable(this._manifestToken);
+        if (namesToLoad.length > 0) {
+            const blob = await this._dataProvider.fetchFragmentBlob(namesToLoad);
+            if (blob.schemaToken !== this._manifestToken) {
+                // Schemas changed between the manifest and fragment fetches. Everything loaded so far
+                // belongs to the old revision - discard it and start over, once.
+                currentView?.markOutdated();
+                this._resetIncrementalState();
+                if (isRetry)
+                    throw new Error("The iModel's schemas changed while the schema view was loading.");
+                return this._ensureSchemasLoaded(undefined, schemas, true);
+            }
+            husk.mergeFragment(blob.data);
+            // Record the whole closure as loaded, including *excluded* schemas (e.g. CoreCustomAttributes)
+            // the writer emits no rows for, so later requests prune them instead of re-fetching.
+            for (const name of namesToLoad)
+                this._loadedSchemaNames.add(name.toLowerCase());
+        }
+        // Once every schema is loaded, collapse back to full mode (the size check is just a fast path).
+        if (schemas === undefined || (this._loadedSchemaNames.size >= manifest.schemaCount && manifest.entries.every((entry) => this._loadedSchemaNames.has(entry.name.toLowerCase()))))
+            this._resetIncrementalState();
+        return husk;
+    }
+}
+
+
 /***/ },
 
 /***/ "../../core/ecschema-metadata/lib/esm/UnitConversion/UnitConverter.js"
@@ -78209,8 +78660,8 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */ __webpack_require__.d(__webpack_exports__, {
 /* harmony export */   AbstractSchemaItemType: () => (/* reexport safe */ _ECObjects__WEBPACK_IMPORTED_MODULE_8__.AbstractSchemaItemType),
 /* harmony export */   ArrayProperty: () => (/* reexport safe */ _Metadata_Property__WEBPACK_IMPORTED_MODULE_22__.ArrayProperty),
-/* harmony export */   ClassModifier: () => (/* reexport safe */ _SchemaViewInterfaces__WEBPACK_IMPORTED_MODULE_44__.ClassModifier),
-/* harmony export */   ClassType: () => (/* reexport safe */ _SchemaViewInterfaces__WEBPACK_IMPORTED_MODULE_44__.ClassType),
+/* harmony export */   ClassModifier: () => (/* reexport safe */ _SchemaView_SchemaViewInterfaces__WEBPACK_IMPORTED_MODULE_45__.ClassModifier),
+/* harmony export */   ClassType: () => (/* reexport safe */ _SchemaView_SchemaViewInterfaces__WEBPACK_IMPORTED_MODULE_45__.ClassType),
 /* harmony export */   Constant: () => (/* reexport safe */ _Metadata_Constant__WEBPACK_IMPORTED_MODULE_12__.Constant),
 /* harmony export */   CustomAttributeClass: () => (/* reexport safe */ _Metadata_CustomAttributeClass__WEBPACK_IMPORTED_MODULE_13__.CustomAttributeClass),
 /* harmony export */   CustomAttributeContainerType: () => (/* reexport safe */ _ECObjects__WEBPACK_IMPORTED_MODULE_8__.CustomAttributeContainerType),
@@ -78234,7 +78685,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   IncrementalSchemaLocater: () => (/* reexport safe */ _IncrementalLoading_IncrementalSchemaLocater__WEBPACK_IMPORTED_MODULE_40__.IncrementalSchemaLocater),
 /* harmony export */   InvertedUnit: () => (/* reexport safe */ _Metadata_InvertedUnit__WEBPACK_IMPORTED_MODULE_17__.InvertedUnit),
 /* harmony export */   KindOfQuantity: () => (/* reexport safe */ _Metadata_KindOfQuantity__WEBPACK_IMPORTED_MODULE_18__.KindOfQuantity),
-/* harmony export */   LocalizationProvider: () => (/* reexport safe */ _Localization_LocalizationProvider__WEBPACK_IMPORTED_MODULE_46__.LocalizationProvider),
+/* harmony export */   LocalizationProvider: () => (/* reexport safe */ _Localization_LocalizationProvider__WEBPACK_IMPORTED_MODULE_49__.LocalizationProvider),
 /* harmony export */   Mixin: () => (/* reexport safe */ _Metadata_Mixin__WEBPACK_IMPORTED_MODULE_19__.Mixin),
 /* harmony export */   NavigationProperty: () => (/* reexport safe */ _Metadata_Property__WEBPACK_IMPORTED_MODULE_22__.NavigationProperty),
 /* harmony export */   OverrideFormat: () => (/* reexport safe */ _Metadata_OverrideFormat__WEBPACK_IMPORTED_MODULE_20__.OverrideFormat),
@@ -78245,7 +78696,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   PrimitiveType: () => (/* reexport safe */ _ECObjects__WEBPACK_IMPORTED_MODULE_8__.PrimitiveType),
 /* harmony export */   Property: () => (/* reexport safe */ _Metadata_Property__WEBPACK_IMPORTED_MODULE_22__.Property),
 /* harmony export */   PropertyCategory: () => (/* reexport safe */ _Metadata_PropertyCategory__WEBPACK_IMPORTED_MODULE_23__.PropertyCategory),
-/* harmony export */   PropertyKind: () => (/* reexport safe */ _SchemaViewInterfaces__WEBPACK_IMPORTED_MODULE_44__.PropertyKind),
+/* harmony export */   PropertyKind: () => (/* reexport safe */ _SchemaView_SchemaViewInterfaces__WEBPACK_IMPORTED_MODULE_45__.PropertyKind),
 /* harmony export */   PropertyType: () => (/* reexport safe */ _ECObjects__WEBPACK_IMPORTED_MODULE_8__.PropertyType),
 /* harmony export */   PropertyTypeUtils: () => (/* reexport safe */ _PropertyTypes__WEBPACK_IMPORTED_MODULE_29__.PropertyTypeUtils),
 /* harmony export */   RelationshipClass: () => (/* reexport safe */ _Metadata_RelationshipClass__WEBPACK_IMPORTED_MODULE_24__.RelationshipClass),
@@ -78264,14 +78715,17 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   SchemaJsonLocater: () => (/* reexport safe */ _SchemaJsonLocater__WEBPACK_IMPORTED_MODULE_30__.SchemaJsonLocater),
 /* harmony export */   SchemaKey: () => (/* reexport safe */ _SchemaKey__WEBPACK_IMPORTED_MODULE_31__.SchemaKey),
 /* harmony export */   SchemaLoader: () => (/* reexport safe */ _SchemaLoader__WEBPACK_IMPORTED_MODULE_32__.SchemaLoader),
-/* harmony export */   SchemaLocalization: () => (/* reexport safe */ _Localization_SchemaLocalization__WEBPACK_IMPORTED_MODULE_47__.SchemaLocalization),
+/* harmony export */   SchemaLocalization: () => (/* reexport safe */ _Localization_SchemaLocalization__WEBPACK_IMPORTED_MODULE_50__.SchemaLocalization),
+/* harmony export */   SchemaManifest: () => (/* reexport safe */ _SchemaView_SchemaManifest__WEBPACK_IMPORTED_MODULE_46__.SchemaManifest),
 /* harmony export */   SchemaMatchType: () => (/* reexport safe */ _ECObjects__WEBPACK_IMPORTED_MODULE_8__.SchemaMatchType),
 /* harmony export */   SchemaPartVisitorDelegate: () => (/* reexport safe */ _SchemaPartVisitorDelegate__WEBPACK_IMPORTED_MODULE_36__.SchemaPartVisitorDelegate),
 /* harmony export */   SchemaReadHelper: () => (/* reexport safe */ _Deserialization_Helper__WEBPACK_IMPORTED_MODULE_5__.SchemaReadHelper),
 /* harmony export */   SchemaUnitProvider: () => (/* reexport safe */ _UnitProvider_SchemaUnitProvider__WEBPACK_IMPORTED_MODULE_34__.SchemaUnitProvider),
-/* harmony export */   SchemaView: () => (/* reexport safe */ _SchemaView__WEBPACK_IMPORTED_MODULE_43__.SchemaView),
-/* harmony export */   SchemaViewBuilder: () => (/* reexport safe */ _SchemaView__WEBPACK_IMPORTED_MODULE_43__.SchemaViewBuilder),
-/* harmony export */   SchemaViewPrimitiveType: () => (/* reexport safe */ _SchemaViewInterfaces__WEBPACK_IMPORTED_MODULE_44__.SchemaViewPrimitiveType),
+/* harmony export */   SchemaView: () => (/* reexport safe */ _SchemaView_SchemaView__WEBPACK_IMPORTED_MODULE_43__.SchemaView),
+/* harmony export */   SchemaViewBuilder: () => (/* reexport safe */ _SchemaView_SchemaViewBuilder__WEBPACK_IMPORTED_MODULE_44__.SchemaViewBuilder),
+/* harmony export */   SchemaViewManager: () => (/* reexport safe */ _SchemaView_SchemaViewManager__WEBPACK_IMPORTED_MODULE_47__.SchemaViewManager),
+/* harmony export */   SchemaViewMergeContext: () => (/* reexport safe */ _SchemaView_SchemaViewBinaryReader__WEBPACK_IMPORTED_MODULE_42__.SchemaViewMergeContext),
+/* harmony export */   SchemaViewPrimitiveType: () => (/* reexport safe */ _SchemaView_SchemaViewInterfaces__WEBPACK_IMPORTED_MODULE_45__.SchemaViewPrimitiveType),
 /* harmony export */   SchemaWalker: () => (/* reexport safe */ _Validation_SchemaWalker__WEBPACK_IMPORTED_MODULE_35__.SchemaWalker),
 /* harmony export */   StrengthDirection: () => (/* reexport safe */ _ECObjects__WEBPACK_IMPORTED_MODULE_8__.StrengthDirection),
 /* harmony export */   StrengthType: () => (/* reexport safe */ _ECObjects__WEBPACK_IMPORTED_MODULE_8__.StrengthType),
@@ -78291,7 +78745,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   parsePrimitiveType: () => (/* reexport safe */ _ECObjects__WEBPACK_IMPORTED_MODULE_8__.parsePrimitiveType),
 /* harmony export */   parseRelationshipEnd: () => (/* reexport safe */ _ECObjects__WEBPACK_IMPORTED_MODULE_8__.parseRelationshipEnd),
 /* harmony export */   parseSchemaItemType: () => (/* reexport safe */ _ECObjects__WEBPACK_IMPORTED_MODULE_8__.parseSchemaItemType),
-/* harmony export */   parseSchemaViewBlob: () => (/* reexport safe */ _SchemaViewBinaryReader__WEBPACK_IMPORTED_MODULE_42__.parseSchemaViewBlob),
+/* harmony export */   parseSchemaViewBlob: () => (/* reexport safe */ _SchemaView_SchemaViewBinaryReader__WEBPACK_IMPORTED_MODULE_42__.parseSchemaViewBlob),
 /* harmony export */   parseStrength: () => (/* reexport safe */ _ECObjects__WEBPACK_IMPORTED_MODULE_8__.parseStrength),
 /* harmony export */   parseStrengthDirection: () => (/* reexport safe */ _ECObjects__WEBPACK_IMPORTED_MODULE_8__.parseStrengthDirection),
 /* harmony export */   primitiveTypeToString: () => (/* reexport safe */ _ECObjects__WEBPACK_IMPORTED_MODULE_8__.primitiveTypeToString),
@@ -78299,7 +78753,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   relationshipEndToString: () => (/* reexport safe */ _ECObjects__WEBPACK_IMPORTED_MODULE_8__.relationshipEndToString),
 /* harmony export */   schemaItemTypeToString: () => (/* reexport safe */ _ECObjects__WEBPACK_IMPORTED_MODULE_8__.schemaItemTypeToString),
 /* harmony export */   schemaItemTypeToXmlString: () => (/* reexport safe */ _ECObjects__WEBPACK_IMPORTED_MODULE_8__.schemaItemTypeToXmlString),
-/* harmony export */   schemaViewFormatVersion: () => (/* reexport safe */ _SchemaViewInterfaces__WEBPACK_IMPORTED_MODULE_44__.schemaViewFormatVersion),
+/* harmony export */   schemaViewFormatVersion: () => (/* reexport safe */ _SchemaView_SchemaViewInterfaces__WEBPACK_IMPORTED_MODULE_45__.schemaViewFormatVersion),
 /* harmony export */   strengthDirectionToString: () => (/* reexport safe */ _ECObjects__WEBPACK_IMPORTED_MODULE_8__.strengthDirectionToString),
 /* harmony export */   strengthToString: () => (/* reexport safe */ _ECObjects__WEBPACK_IMPORTED_MODULE_8__.strengthToString)
 /* harmony export */ });
@@ -78345,12 +78799,15 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony import */ var _IncrementalLoading_ECSqlSchemaLocater__WEBPACK_IMPORTED_MODULE_39__ = __webpack_require__(/*! ./IncrementalLoading/ECSqlSchemaLocater */ "../../core/ecschema-metadata/lib/esm/IncrementalLoading/ECSqlSchemaLocater.js");
 /* harmony import */ var _IncrementalLoading_IncrementalSchemaLocater__WEBPACK_IMPORTED_MODULE_40__ = __webpack_require__(/*! ./IncrementalLoading/IncrementalSchemaLocater */ "../../core/ecschema-metadata/lib/esm/IncrementalLoading/IncrementalSchemaLocater.js");
 /* harmony import */ var _utils_SchemaGraph__WEBPACK_IMPORTED_MODULE_41__ = __webpack_require__(/*! ./utils/SchemaGraph */ "../../core/ecschema-metadata/lib/esm/utils/SchemaGraph.js");
-/* harmony import */ var _SchemaViewBinaryReader__WEBPACK_IMPORTED_MODULE_42__ = __webpack_require__(/*! ./SchemaViewBinaryReader */ "../../core/ecschema-metadata/lib/esm/SchemaViewBinaryReader.js");
-/* harmony import */ var _SchemaView__WEBPACK_IMPORTED_MODULE_43__ = __webpack_require__(/*! ./SchemaView */ "../../core/ecschema-metadata/lib/esm/SchemaView.js");
-/* harmony import */ var _SchemaViewInterfaces__WEBPACK_IMPORTED_MODULE_44__ = __webpack_require__(/*! ./SchemaViewInterfaces */ "../../core/ecschema-metadata/lib/esm/SchemaViewInterfaces.js");
-/* harmony import */ var _Localization_LocalizationTypes__WEBPACK_IMPORTED_MODULE_45__ = __webpack_require__(/*! ./Localization/LocalizationTypes */ "../../core/ecschema-metadata/lib/esm/Localization/LocalizationTypes.js");
-/* harmony import */ var _Localization_LocalizationProvider__WEBPACK_IMPORTED_MODULE_46__ = __webpack_require__(/*! ./Localization/LocalizationProvider */ "../../core/ecschema-metadata/lib/esm/Localization/LocalizationProvider.js");
-/* harmony import */ var _Localization_SchemaLocalization__WEBPACK_IMPORTED_MODULE_47__ = __webpack_require__(/*! ./Localization/SchemaLocalization */ "../../core/ecschema-metadata/lib/esm/Localization/SchemaLocalization.js");
+/* harmony import */ var _SchemaView_SchemaViewBinaryReader__WEBPACK_IMPORTED_MODULE_42__ = __webpack_require__(/*! ./SchemaView/SchemaViewBinaryReader */ "../../core/ecschema-metadata/lib/esm/SchemaView/SchemaViewBinaryReader.js");
+/* harmony import */ var _SchemaView_SchemaView__WEBPACK_IMPORTED_MODULE_43__ = __webpack_require__(/*! ./SchemaView/SchemaView */ "../../core/ecschema-metadata/lib/esm/SchemaView/SchemaView.js");
+/* harmony import */ var _SchemaView_SchemaViewBuilder__WEBPACK_IMPORTED_MODULE_44__ = __webpack_require__(/*! ./SchemaView/SchemaViewBuilder */ "../../core/ecschema-metadata/lib/esm/SchemaView/SchemaViewBuilder.js");
+/* harmony import */ var _SchemaView_SchemaViewInterfaces__WEBPACK_IMPORTED_MODULE_45__ = __webpack_require__(/*! ./SchemaView/SchemaViewInterfaces */ "../../core/ecschema-metadata/lib/esm/SchemaView/SchemaViewInterfaces.js");
+/* harmony import */ var _SchemaView_SchemaManifest__WEBPACK_IMPORTED_MODULE_46__ = __webpack_require__(/*! ./SchemaView/SchemaManifest */ "../../core/ecschema-metadata/lib/esm/SchemaView/SchemaManifest.js");
+/* harmony import */ var _SchemaView_SchemaViewManager__WEBPACK_IMPORTED_MODULE_47__ = __webpack_require__(/*! ./SchemaView/SchemaViewManager */ "../../core/ecschema-metadata/lib/esm/SchemaView/SchemaViewManager.js");
+/* harmony import */ var _Localization_LocalizationTypes__WEBPACK_IMPORTED_MODULE_48__ = __webpack_require__(/*! ./Localization/LocalizationTypes */ "../../core/ecschema-metadata/lib/esm/Localization/LocalizationTypes.js");
+/* harmony import */ var _Localization_LocalizationProvider__WEBPACK_IMPORTED_MODULE_49__ = __webpack_require__(/*! ./Localization/LocalizationProvider */ "../../core/ecschema-metadata/lib/esm/Localization/LocalizationProvider.js");
+/* harmony import */ var _Localization_SchemaLocalization__WEBPACK_IMPORTED_MODULE_50__ = __webpack_require__(/*! ./Localization/SchemaLocalization */ "../../core/ecschema-metadata/lib/esm/Localization/SchemaLocalization.js");
 /*---------------------------------------------------------------------------------------------
 * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
 * See LICENSE.md in the project root for license terms and full copyright notice.
@@ -78399,6 +78856,9 @@ __webpack_require__.r(__webpack_exports__);
 
 
 
+
+
+
 
 
 
@@ -84866,7 +85326,7 @@ class BriefcaseConnection extends _IModelConnection__WEBPACK_IMPORTED_MODULE_5__
      */
     async pushChanges(description) {
         this.requireTimeline();
-        return _IpcApp__WEBPACK_IMPORTED_MODULE_6__.IpcApp.appFunctionIpc.pushChanges(this.key, description);
+        return this.changeset = await _IpcApp__WEBPACK_IMPORTED_MODULE_6__.IpcApp.appFunctionIpc.pushChanges(this.key, description);
     }
     /** The current graphical editing scope, if one is in progress.
      * @see [[enterEditingScope]] to begin graphical editing.
@@ -91663,7 +92123,9 @@ class IModelConnection extends _itwin_core_common__WEBPACK_IMPORTED_MODULE_1__.I
      */
     fontMap; // eslint-disable-line @typescript-eslint/no-deprecated
     _schemaContext;
-    _schemasPromise;
+    // Created lazily on the first getSchemaView call. Owns the SchemaView's lifetime and does all its
+    // data access through the SchemaViewDataProvider implemented below.
+    _schemaViewManager;
     /** Load the FontMap for this IModelConnection.
      * @returns Returns a Promise<FontMap> that is fulfilled when the FontMap member of this IModelConnection is valid.
      * @deprecated in 5.0.0 - might be removed in next major version. If you need font Ids on the front-end for some reason, write an Ipc method that queries [IModelDb.fonts]($backend).
@@ -92091,33 +92553,23 @@ class IModelConnection extends _itwin_core_common__WEBPACK_IMPORTED_MODULE_1__.I
     }
     /** Get the schema view for this iModel. The view is built lazily on
      * first call by fetching compact binary schema data via `PRAGMA schema_view` through
-     * the existing queryRows RPC (ConcurrentQuery). Subsequent calls return the cached view.
-     * Multiple concurrent callers share a single in-flight fetch.
+     * the existing queryRows RPC (ConcurrentQuery).
      *
      * The returned `SchemaView` is a lightweight, read-only, synchronous API for
      * navigating schema metadata - classes, properties, relationships, enumerations, etc.
      * It is the recommended default for runtime read-only metadata access and is significantly
      * faster and lower-memory than [[schemaContext]]. Use [[schemaContext]] for custom-attribute
      * deserialization or anywhere you need the full ecschema-metadata object graph.
+     *
+     * Every call shares one accumulating view instance and concurrent calls are serialized, so a
+     * caller never observes a partially loaded view. The instance is discarded once the connection
+     * detects that schemas changed, for example after [[BriefcaseConnection.pullChanges]]; the next
+     * call builds a new one. See [GetSchemaViewArgs]($ecschema-metadata) for the arguments.
      * @beta
      */
-    async getSchemaView() {
-        if (this._schemasPromise) {
-            const ctx = await this._schemasPromise;
-            if (!ctx.isOutdated)
-                return ctx;
-        }
-        // Capture the in-flight promise locally so the rejection handler only clears
-        // `_schemasPromise` if it still points at this build. A concurrent invalidation +
-        // re-fetch could otherwise replace the field before our fetch fails, and a naive
-        // `_schemasPromise = undefined` would clobber that newer reference.
-        const inflight = this._fetchSchemas();
-        this._schemasPromise = inflight;
-        inflight.catch(() => {
-            if (this._schemasPromise === inflight)
-                this._schemasPromise = undefined;
-        });
-        return inflight;
+    async getSchemaView(args) {
+        this._schemaViewManager ??= new _itwin_ecschema_metadata__WEBPACK_IMPORTED_MODULE_14__.SchemaViewManager(this._createSchemaViewDataProvider());
+        return this._schemaViewManager.getSchemaView(args);
     }
     /**
      * Checks whether the iModel's schemas have changed since the current cached [[SchemaView]] was
@@ -92129,7 +92581,7 @@ class IModelConnection extends _itwin_core_common__WEBPACK_IMPORTED_MODULE_1__.I
      * returns only the new changeset id, not the list of applied changesets with their types.
      * Unconditionally discarding the cached [[SchemaView]] after every such operation would cause
      * unnecessary reloads in the common case where schemas are unchanged. This method avoids that
-     * cost by fetching a lightweight schema checksum via `PRAGMA checksum(ecdb_schema)` and
+     * cost by fetching a lightweight schema token via `PRAGMA checksum(schema_token)` and
      * comparing it against the token stored in the cached view. Only when the token differs is the
      * cache discarded.
      *
@@ -92138,61 +92590,59 @@ class IModelConnection extends _itwin_core_common__WEBPACK_IMPORTED_MODULE_1__.I
      * @internal
      */
     async invalidateSchemaViewIfChanged() {
-        if (!this._schemasPromise)
-            return;
-        const existingPromise = this._schemasPromise;
-        let existing;
-        try {
-            existing = await existingPromise;
-        }
-        catch {
-            // The cached promise itself failed; drop it so the next getSchemaView() retries.
-            if (this._schemasPromise === existingPromise)
-                this._schemasPromise = undefined;
-            return;
-        }
-        if (!existing.schemaToken)
-            return;
-        try {
-            const reader = this.createQueryReader("PRAGMA checksum(ecdb_schema)");
-            const result = await reader.next();
-            if (result.done)
-                throw new Error("PRAGMA checksum(ecdb_schema) returned no rows");
-            const liveToken = result.value.sha3_256;
-            if (liveToken !== existing.schemaToken) {
-                if (this._schemasPromise === existingPromise)
-                    this._schemasPromise = undefined;
-                existing.markOutdated();
-            }
-        }
-        catch {
-            // The checksum check is called right after operations that may have changed schemas
-            // (e.g., pullChanges). If we cannot verify the cached view is still current, drop it
-            // rather than risk returning stale metadata indefinitely. The next getSchemaView() call
-            // will reload. We also mark the existing view outdated so any retained references can
-            // observe the invalidation.
-            if (this._schemasPromise === existingPromise) {
-                this._schemasPromise = undefined;
-                existing.markOutdated();
-            }
-        }
-    }
-    async _fetchSchemas() {
-        // PRAGMA returns exactly one row with format, formatVersion, data (binary), schemaToken.
-        // Important: only call reader.next() once - do NOT use `for await` on PRAGMA results.
-        // ConcurrentQuery wraps regular ECSQL in LIMIT/OFFSET for pagination but skips this for
-        // PRAGMAs. If the serialized result exceeds the memory threshold, the response is marked
-        // "Partial", and a `for await` loop would re-issue the same PRAGMA forever since PRAGMAs
-        // don't support OFFSET-based pagination.
-        const reader = this.createQueryReader(`PRAGMA schema_view(${_itwin_ecschema_metadata__WEBPACK_IMPORTED_MODULE_14__.schemaViewFormatVersion})`);
+        await this._schemaViewManager?.invalidateIfChanged();
+    }
+    /** The [SchemaViewDataProvider]($ecschema-metadata) backing this iModel's [[getSchemaView]]: the
+     * transport-specific half of schema-view loading, issued through the queryRows RPC
+     * (ConcurrentQuery). The frontend *pins* the blob format version in both pragmas, because the
+     * backend it talks to can be older or newer; the pin makes it return a blob this code can parse,
+     * or fail cleanly.
+     */
+    _createSchemaViewDataProvider() {
+        return {
+            fetchFullBlob: async () => this._fetchSchemaBlob(`PRAGMA schema_view(${_itwin_ecschema_metadata__WEBPACK_IMPORTED_MODULE_14__.schemaViewFormatVersion})`),
+            // Names are ECNames, so a comma can never occur in one. Native re-validates each token as an
+            // ECName and fails the pragma on an unknown name. The `v<N>;` prefix pins the format version.
+            fetchFragmentBlob: async (schemaNames) => this._fetchSchemaBlob(`PRAGMA schema_view_fragment('v${_itwin_ecschema_metadata__WEBPACK_IMPORTED_MODULE_14__.schemaViewFormatVersion};${schemaNames.join(",")}')`),
+            fetchManifest: async () => {
+                const schemaRows = [];
+                const schemaSql = "SELECT ECInstanceId, Name, VersionMajor, VersionWrite, VersionMinor FROM meta.ECSchemaDef";
+                for await (const row of this.createQueryReader(schemaSql)) {
+                    // ECInstanceId arrives as a hex Id64String. `ec_` metadata rowids carry no briefcase
+                    // prefix, so the local id is the full value.
+                    schemaRows.push({ ecInstanceId: _itwin_core_bentley__WEBPACK_IMPORTED_MODULE_0__.Id64.getLocalId(row[0]), name: row[1], versionMajor: row[2], versionWrite: row[3], versionMinor: row[4] });
+                }
+                const referenceRows = [];
+                const referenceSql = "SELECT SourceECInstanceId, TargetECInstanceId FROM meta.SchemaHasSchemaReferences";
+                for await (const row of this.createQueryReader(referenceSql))
+                    referenceRows.push({ sourceECInstanceId: _itwin_core_bentley__WEBPACK_IMPORTED_MODULE_0__.Id64.getLocalId(row[0]), targetECInstanceId: _itwin_core_bentley__WEBPACK_IMPORTED_MODULE_0__.Id64.getLocalId(row[1]) });
+                return _itwin_ecschema_metadata__WEBPACK_IMPORTED_MODULE_14__.SchemaManifest.fromRows(schemaRows, referenceRows);
+            },
+            fetchSchemaToken: async () => {
+                const reader = this.createQueryReader("PRAGMA checksum(schema_token)");
+                const result = await reader.next();
+                if (result.done)
+                    throw new _itwin_core_common__WEBPACK_IMPORTED_MODULE_1__.IModelError(_itwin_core_bentley__WEBPACK_IMPORTED_MODULE_0__.IModelStatus.BadRequest, "PRAGMA checksum(schema_token) returned no rows");
+                return result.value.sha3_256;
+            },
+        };
+    }
+    /** Fetch one schema-view blob (full or fragment). Both `PRAGMA schema_view` and
+     * `PRAGMA schema_view_fragment` return a single row with the same columns. */
+    async _fetchSchemaBlob(pragma) {
+        // Only call reader.next() once - do NOT use `for await` on PRAGMA results. ConcurrentQuery wraps
+        // regular ECSQL in LIMIT/OFFSET for pagination but skips this for PRAGMAs; if the serialized
+        // result exceeds the memory threshold, the response is marked "Partial", and a `for await` loop
+        // would re-issue the same PRAGMA forever since PRAGMAs don't support OFFSET-based pagination.
+        const reader = this.createQueryReader(pragma);
         const result = await reader.next();
         if (result.done)
-            throw new _itwin_core_common__WEBPACK_IMPORTED_MODULE_1__.IModelError(_itwin_core_bentley__WEBPACK_IMPORTED_MODULE_0__.IModelStatus.BadRequest, "PRAGMA schema_view returned no rows");
+            throw new _itwin_core_common__WEBPACK_IMPORTED_MODULE_1__.IModelError(_itwin_core_bentley__WEBPACK_IMPORTED_MODULE_0__.IModelStatus.BadRequest, `${pragma} returned no rows`);
         const data = result.value.data;
         const token = result.value.schemaToken;
         if (data === undefined || data === null)
-            throw new _itwin_core_common__WEBPACK_IMPORTED_MODULE_1__.IModelError(_itwin_core_bentley__WEBPACK_IMPORTED_MODULE_0__.IModelStatus.BadRequest, "PRAGMA schema_view returned null data column");
-        return _itwin_ecschema_metadata__WEBPACK_IMPORTED_MODULE_14__.SchemaView.fromBinary(data, token ?? "");
+            throw new _itwin_core_common__WEBPACK_IMPORTED_MODULE_1__.IModelError(_itwin_core_bentley__WEBPACK_IMPORTED_MODULE_0__.IModelStatus.BadRequest, `${pragma} returned null data column`);
+        return { data, schemaToken: token ?? "" };
     }
 }
 /** A connection that exists without an iModel. Useful for connecting to Reality Data services.
@@ -321418,10 +321868,10 @@ class Settings {
         });
     }
     toString() {
-        return `Configurations:
-      oidc client id: ${this.oidcClientId},
-      oidc scopes: ${this.oidcScopes},
-      applicationId: ${this.gprid},
+        return `Configurations:
+      oidc client id: ${this.oidcClientId},
+      oidc scopes: ${this.oidcScopes},
+      applicationId: ${this.gprid},
       log level: ${this.logLevel}`;
     }
 }
@@ -333379,7 +333829,7 @@ var loadLanguages = instance.loadLanguages;
 (module) {
 
 "use strict";
-module.exports = /*#__PURE__*/JSON.parse('{"name":"@itwin/core-frontend","version":"5.12.0-dev.16","description":"iTwin.js frontend components","main":"lib/cjs/core-frontend.js","module":"lib/esm/core-frontend.js","typings":"lib/cjs/core-frontend","license":"MIT","scripts":{"build":"npm run -s copy:public && npm run -s build:cjs && npm run -s build:esm && npm run -s webpackWorkers && npm run -s copy:workers && npm run -s copy:draco","build:cjs":"npm run -s copy:js:cjs && tsc 1>&2 --outDir lib/cjs","build:esm":"npm run -s copy:js:esm && tsc 1>&2 --module ES2022 --outDir lib/esm","clean":"rimraf -g lib .rush/temp/package-deps*.json","copy:public":"cpx \\"./src/public/**/*\\" ./lib/public","copy:js:cjs":"cpx \\"./src/**/*.js\\" ./lib/cjs","copy:js:esm":"cpx \\"./src/**/*.js\\" ./lib/esm","copy:workers":"cpx \\"./lib/workers/webpack/parse-imdl-worker.js\\" ./lib/public/scripts","copy:draco":"cpx \\"./node_modules/@loaders.gl/draco/dist/libs/*\\" ./lib/public/scripts","docs":"betools docs --json=../../generated-docs/core/core-frontend/file.json --tsIndexFile=./core-frontend.ts --onlyJson --excludes=webgl/**/*,**/map/*.d.ts,**/tile/*.d.ts,**/*-css.ts && npm run -s extract","extract":"betools extract --fileExt=ts --extractFrom=./src/test/example-code --recursive --out=../../generated-docs/extract","extract-api":"betools extract-api --entry=core-frontend && npm run extract-extension-api","extract-extension-api":"eslint --no-inline-config -c extraction.eslint.config.js  \\"./src/**/*.ts\\" 1>&2","lint":"eslint \\"./src/**/*.ts\\" 1>&2","lint-fix":"eslint --fix -f visualstudio \\"./src/**/*.ts\\" 1>&2","lint-deprecation":"eslint --fix -f visualstudio --no-inline-config -c ../../common/config/eslint/eslint.config.deprecation-policy.js \\"./src/**/*.ts\\"","pseudolocalize":"betools pseudolocalize --englishDir ./src/public/locales/en --out ./public/locales/en-PSEUDO","test":"npm run webpackTestWorker && vitest --run","cover":"npm run webpackTestWorker && vitest --run","webpackTests":"webpack --config ./src/test/utils/webpack.config.js 1>&2 && npm run -s webpackTestWorker","webpackTestWorker":"webpack --config ./src/test/worker/webpack.config.js 1>&2 && cpx \\"./lib/test/test-worker.js\\" ./lib/test","webpackWorkers":"webpack --config ./src/workers/ImdlParser/webpack.config.js 1>&2"},"repository":{"type":"git","url":"https://github.com/iTwin/itwinjs-core.git","directory":"core/frontend"},"keywords":["Bentley","BIM","iModel","digital-twin","iTwin"],"author":{"name":"Bentley Systems, Inc.","url":"http://www.bentley.com"},"peerDependencies":{"@itwin/appui-abstract":"workspace:*","@itwin/core-bentley":"workspace:*","@itwin/core-common":"workspace:*","@itwin/core-geometry":"workspace:*","@itwin/core-orbitgt":"workspace:*","@itwin/core-quantity":"workspace:*","@itwin/ecschema-metadata":"workspace:*","@itwin/ecschema-rpcinterface-common":"workspace:*"},"//devDependencies":["NOTE: All peerDependencies should also be listed as devDependencies since peerDependencies are not considered by npm install","NOTE: All tools used by scripts in this package must be listed as devDependencies"],"devDependencies":{"@bentley/aec-units-schema":"^1.0.3","@bentley/formats-schema":"^1.0.0","@bentley/units-schema":"^1.0.10","@itwin/appui-abstract":"workspace:*","@itwin/build-tools":"workspace:*","@itwin/core-bentley":"workspace:*","@itwin/core-common":"workspace:*","@itwin/core-geometry":"workspace:*","@itwin/core-orbitgt":"workspace:*","@itwin/core-quantity":"workspace:*","@itwin/ecschema-metadata":"workspace:*","@itwin/ecschema-rpcinterface-common":"workspace:*","@itwin/object-storage-core":"^3.0.4","@itwin/eslint-plugin":"^6.0.0","@types/chai-as-promised":"^7","@types/draco3d":"^1.4.10","@types/node":"~20.17.0","@types/sinon":"^17.0.2","@vitest/browser-playwright":"^4.1.10","@vitest/coverage-v8":"^4.1.10","cpx2":"^8.0.0","eslint":"^9.31.0","glob":"^10.5.0","playwright":"~1.56.1","rimraf":"^6.0.1","sinon":"^17.0.2","source-map-loader":"^5.0.0","typescript":"~5.6.2","vitest":"^4.1.10","vite-multiple-assets":"^1.3.1","vite-plugin-static-copy":"2.2.0","webpack":"^5.97.1"},"//dependencies":["NOTE: these dependencies should be only for things that DO NOT APPEAR IN THE API","NOTE: core-frontend should remain UI technology agnostic, so no react/angular dependencies are allowed"],"dependencies":{"@itwin/core-i18n":"workspace:*","@itwin/webgl-compatibility":"workspace:*","@loaders.gl/core":"~4.3.4","@loaders.gl/draco":"~4.3.4","fuse.js":"^3.3.0","wms-capabilities":"0.4.0"}}');
+module.exports = /*#__PURE__*/JSON.parse('{"name":"@itwin/core-frontend","version":"5.12.0-dev.18","description":"iTwin.js frontend components","main":"lib/cjs/core-frontend.js","module":"lib/esm/core-frontend.js","typings":"lib/cjs/core-frontend","license":"MIT","scripts":{"build":"npm run -s copy:public && npm run -s build:cjs && npm run -s build:esm && npm run -s webpackWorkers && npm run -s copy:workers && npm run -s copy:draco","build:cjs":"npm run -s copy:js:cjs && tsc 1>&2 --outDir lib/cjs","build:esm":"npm run -s copy:js:esm && tsc 1>&2 --module ES2022 --outDir lib/esm","clean":"rimraf -g lib .rush/temp/package-deps*.json","copy:public":"cpx \\"./src/public/**/*\\" ./lib/public","copy:js:cjs":"cpx \\"./src/**/*.js\\" ./lib/cjs","copy:js:esm":"cpx \\"./src/**/*.js\\" ./lib/esm","copy:workers":"cpx \\"./lib/workers/webpack/parse-imdl-worker.js\\" ./lib/public/scripts","copy:draco":"cpx \\"./node_modules/@loaders.gl/draco/dist/libs/*\\" ./lib/public/scripts","docs":"betools docs --json=../../generated-docs/core/core-frontend/file.json --tsIndexFile=./core-frontend.ts --onlyJson --excludes=webgl/**/*,**/map/*.d.ts,**/tile/*.d.ts,**/*-css.ts && npm run -s extract","extract":"betools extract --fileExt=ts --extractFrom=./src/test/example-code --recursive --out=../../generated-docs/extract","extract-api":"betools extract-api --entry=core-frontend && npm run extract-extension-api","extract-extension-api":"eslint --no-inline-config -c extraction.eslint.config.js  \\"./src/**/*.ts\\" 1>&2","lint":"eslint \\"./src/**/*.ts\\" 1>&2","lint-fix":"eslint --fix -f visualstudio \\"./src/**/*.ts\\" 1>&2","lint-deprecation":"eslint --fix -f visualstudio --no-inline-config -c ../../common/config/eslint/eslint.config.deprecation-policy.js \\"./src/**/*.ts\\"","pseudolocalize":"betools pseudolocalize --englishDir ./src/public/locales/en --out ./public/locales/en-PSEUDO","test":"npm run webpackTestWorker && vitest --run","cover":"npm run webpackTestWorker && vitest --run","webpackTests":"webpack --config ./src/test/utils/webpack.config.js 1>&2 && npm run -s webpackTestWorker","webpackTestWorker":"webpack --config ./src/test/worker/webpack.config.js 1>&2 && cpx \\"./lib/test/test-worker.js\\" ./lib/test","webpackWorkers":"webpack --config ./src/workers/ImdlParser/webpack.config.js 1>&2"},"repository":{"type":"git","url":"https://github.com/iTwin/itwinjs-core.git","directory":"core/frontend"},"keywords":["Bentley","BIM","iModel","digital-twin","iTwin"],"author":{"name":"Bentley Systems, Inc.","url":"http://www.bentley.com"},"peerDependencies":{"@itwin/appui-abstract":"workspace:*","@itwin/core-bentley":"workspace:*","@itwin/core-common":"workspace:*","@itwin/core-geometry":"workspace:*","@itwin/core-orbitgt":"workspace:*","@itwin/core-quantity":"workspace:*","@itwin/ecschema-metadata":"workspace:*","@itwin/ecschema-rpcinterface-common":"workspace:*"},"//devDependencies":["NOTE: All peerDependencies should also be listed as devDependencies since peerDependencies are not considered by npm install","NOTE: All tools used by scripts in this package must be listed as devDependencies"],"devDependencies":{"@bentley/aec-units-schema":"^1.0.3","@bentley/formats-schema":"^1.0.0","@bentley/units-schema":"^1.0.10","@itwin/appui-abstract":"workspace:*","@itwin/build-tools":"workspace:*","@itwin/core-bentley":"workspace:*","@itwin/core-common":"workspace:*","@itwin/core-geometry":"workspace:*","@itwin/core-orbitgt":"workspace:*","@itwin/core-quantity":"workspace:*","@itwin/ecschema-metadata":"workspace:*","@itwin/ecschema-rpcinterface-common":"workspace:*","@itwin/object-storage-core":"^3.0.4","@itwin/eslint-plugin":"^6.0.0","@types/chai-as-promised":"^7","@types/draco3d":"^1.4.10","@types/node":"~20.17.0","@types/sinon":"^17.0.2","@vitest/browser-playwright":"^4.1.10","@vitest/coverage-v8":"^4.1.10","cpx2":"^8.0.0","eslint":"^9.31.0","glob":"^13.0.6","playwright":"~1.56.1","rimraf":"^6.0.1","sinon":"^17.0.2","source-map-loader":"^5.0.0","typescript":"~5.6.2","vitest":"^4.1.10","vite-multiple-assets":"^1.3.1","vite-plugin-static-copy":"2.2.0","webpack":"^5.97.1"},"//dependencies":["NOTE: these dependencies should be only for things that DO NOT APPEAR IN THE API","NOTE: core-frontend should remain UI technology agnostic, so no react/angular dependencies are allowed"],"dependencies":{"@itwin/core-i18n":"workspace:*","@itwin/webgl-compatibility":"workspace:*","@loaders.gl/core":"~4.3.4","@loaders.gl/draco":"~4.3.4","fuse.js":"^3.3.0","wms-capabilities":"0.4.0"}}');
 
 /***/ }