@itwin/ecschema-metadata 5.12.0-dev.9 → 5.13.0-dev.1

package/lib/cjs/{SchemaView.d.ts → SchemaView/SchemaView.d.ts}

@@ -2,7 +2,8 @@
  * @module Schema
  */
 import { type ClassData, ClassModifier, ClassType, type EnumerationData, type EnumeratorData, type KoqData, type PropCategoryData, type PropertyDef, PropertyKind, type PropertyRef, type RelConstraintData, type SchemaData, SchemaViewPrimitiveType } from "./SchemaViewInterfaces";
-import { StrengthDirection, StrengthType } from "./ECObjects";
+import { SchemaViewMergeContext } from "./SchemaViewBinaryReader";
+import { StrengthDirection, StrengthType } from "../ECObjects";
 declare const _storage: unique symbol;
 /** Internal runtime storage attached to a SchemaView instance. Carries the immutable data
  * tables built by SchemaViewBuilder plus two mutable caches populated lazily at runtime.
@@ -58,11 +59,15 @@ export interface SchemaViewData {
 export declare class SchemaView {
     /** @internal */
     readonly [_storage]: SchemaViewStorage;
-    private _schemaToken;
+    private readonly _schemaToken;
     private _outdated;
+    /** 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`. */
+    private readonly _mergeContext?;
     /** @internal */
-    constructor(data: SchemaViewData, schemaToken?: string);
-    /** SHA3-256 content hash of the ec_ schema tables at the time this view was built.
+    constructor(data: SchemaViewData, schemaToken?: string, mergeContext?: SchemaViewMergeContext);
+    /** 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
      */
@@ -105,14 +110,25 @@ export declare class SchemaView {
     findPropertyCategory(qualifiedName: string): SchemaView.PropertyCategory | undefined;
     /** 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: Uint8Array, schemaToken?: string): SchemaView;
-    /** 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 fromBuilder(builder: SchemaViewBuilder, schemaToken?: string): SchemaView;
+    static createMergeable(schemaToken?: string): SchemaView;
+    /** 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
+     */
+    mergeFragment(blob: Uint8Array): void;
     /** Resolve a qualified "SchemaName:ItemName" (or dot-separated) to an index using the given
      * per-schema name map. Returns undefined if not found. @internal */
     private _resolveSchemaItemIdx;
@@ -566,88 +582,5 @@ export declare namespace SchemaView {
         get constraintClasses(): readonly Class[];
     }
 }
-/** 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
- */
-export declare class SchemaViewBuilder {
-    private readonly _strings;
-    private readonly _lowerStrings;
-    private readonly _stringMap;
-    private readonly _schemas;
-    private readonly _classes;
-    private readonly _classMixins;
-    private readonly _propDefs;
-    private readonly _propertyRefs;
-    private readonly _relConstraints;
-    private readonly _constraintClassRefs;
-    private readonly _enumerations;
-    private readonly _enumerators;
-    private readonly _koqs;
-    private readonly _propCategories;
-    private readonly _propDefMap;
-    /** 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: string | undefined): number;
-    /** Add a schema. Returns its index. */
-    addSchema(data: SchemaData): number;
-    /** Add a class. Returns its index. Must be called after the owning schema. */
-    addClass(data: ClassData): number;
-    /** Add a property definition with deduplication. Returns the def index (possibly existing). */
-    addPropertyDef(data: PropertyDef): number;
-    /** Append a property reference to the flat refs array. */
-    addPropertyRef(ref: PropertyRef): void;
-    /** Add an enumeration. Returns its index. */
-    addEnumeration(data: EnumerationData): number;
-    /** Append an enumerator to the flat enumerators array. */
-    addEnumerator(data: EnumeratorData): void;
-    /** Add a KindOfQuantity. Returns its index. */
-    addKoq(data: KoqData): number;
-    /** Add a PropertyCategory. Returns its index. */
-    addPropertyCategory(data: PropCategoryData): number;
-    /** Add a relationship constraint. Returns its index. */
-    addRelConstraint(data: RelConstraintData): number;
-    /** Append a constraint class reference to the flat array. */
-    addConstraintClassRef(classIdx: number): void;
-    /** Append a mixin class reference to the flat array. */
-    addClassMixin(classIdx: number): void;
-    /** The current count of property refs (used to set ownPropStart on ClassData). */
-    get propertyRefCount(): number;
-    /** The current count of enumerators (used to set enumeratorStart on EnumerationData). */
-    get enumeratorCount(): number;
-    /** The current count of constraint class refs (used to set classRefStart). */
-    get constraintClassRefCount(): number;
-    /** The current count of class mixins (used to set mixinStartIdx). */
-    get classMixinCount(): number;
-    /** Get a string by SID. @internal */
-    getString(sid: number): string;
-    /** Replace class data at the given index (used during deferred cross-ref resolution). @internal */
-    updateClass(classIdx: number, data: ClassData): void;
-    /** Update range fields on a schema (used after all items for a schema are collected). @internal */
-    updateSchemaRanges(schemaIdx: number, ranges: {
-        classRangeStart: number;
-        classCount: number;
-        enumRangeStart: number;
-        enumCount: number;
-        koqRangeStart: number;
-        koqCount: number;
-        catRangeStart: number;
-        catCount: number;
-    }): void;
-    /** Freeze all data and produce an immutable SchemaView. */
-    build(schemaToken?: string): SchemaView;
-    /** 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. */
-    private _propDefSignature;
-}
 export {};
 //# sourceMappingURL=SchemaView.d.ts.map

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

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

package/lib/cjs/{SchemaView.js → SchemaView/SchemaView.js}

@@ -7,7 +7,7 @@
  * @module Schema
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SchemaViewBuilder = exports.SchemaView = void 0;
+exports.SchemaView = void 0;
 const SchemaViewInterfaces_1 = require("./SchemaViewInterfaces");
 const SchemaViewBinaryReader_1 = require("./SchemaViewBinaryReader");
 // Module-local symbol used as the storage key on SchemaView instances. Mirrors the pattern in
@@ -31,16 +31,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
      */
@@ -104,17 +109,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_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 fromBuilder(builder, schemaToken) {
-        return builder.build(schemaToken);
+    static createMergeable(schemaToken) {
+        const ctx = new SchemaViewBinaryReader_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
+     */
+    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
@@ -1010,195 +1035,4 @@ exports.SchemaView = SchemaView;
     }
     SchemaView.RelConstraint = RelConstraint;
 })(SchemaView || (exports.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}`;
-    }
-}
-exports.SchemaViewBuilder = SchemaViewBuilder;
 //# sourceMappingURL=SchemaView.js.map