@bldrs-ai/conway 1.510.1439 → 1.512.1444

package/compiled/examples/browser-bundled.cjs

@@ -30,7 +30,7 @@ var import_node_process = require("node:process");
 var readline = __toESM(require("node:readline"), 1);
 
 // compiled/src/version/version.js
-var versionString = "Conway v1.510.1439";
+var versionString = "Conway v1.512.1444";
 
 // compiled/dependencies/conway-geom/interface/conway_geometry.js
 var wasmType = "";
@@ -2910,7 +2910,10 @@ var StepParser = class extends StepHeaderParser {
         if (!charws(SEMICOLON)) {
           return syntaxError();
         }
-        onRecordIndexed?.(topLevelCount, expressID, 0);
+        {
+          const recordLen = input2.address - startElement2;
+          onRecordIndexed?.(topLevelCount, expressID, 0, input2.buffer.subarray(input2.cursor - recordLen, input2.cursor));
+        }
         ++topLevelCount;
         pushEntry({
           address: startElement2,
@@ -3000,7 +3003,10 @@ var StepParser = class extends StepHeaderParser {
       if (!charws(SEMICOLON)) {
         return syntaxError();
       }
-      onRecordIndexed?.(topLevelCount, expressID, foundItem);
+      {
+        const recordLen = input2.address - startElement;
+        onRecordIndexed?.(topLevelCount, expressID, foundItem, input2.buffer.subarray(input2.cursor - recordLen, input2.cursor));
+      }
       ++topLevelCount;
       pushEntry({
         address: startElement,
@@ -5767,6 +5773,35 @@ var StepModelBase = class {
     }
     this.bufferProvider_.unpinRange?.(this.address_[localID], this.length_[localID]);
   }
+  /**
+   * Drop captured source-window views on `localIDs` so the LRU can
+   * evict those chunks. Vtables stay — `acquire` of the same
+   * `(address, length)` is at a stable base. The next
+   * `ensureResident` + field read rematerialises the view.
+   *
+   * @param localIDs Records whose `buffer` views to drop.
+   */
+  releaseSourceViews(localIDs) {
+    if (!this.isSourceExternal) {
+      return;
+    }
+    for (const localID of localIDs) {
+      if (localID >= this.count_) {
+        continue;
+      }
+      const item = this.complexEntries_?.get(localID) ?? this.descriptorCache_[localID];
+      if (item === void 0) {
+        continue;
+      }
+      item.buffer = void 0;
+      if (item.multiMapping !== void 0) {
+        for (const mapped of item.multiMapping) {
+          mapped.buffer = void 0;
+        }
+      }
+    }
+    releaseScratchParsingBuffer();
+  }
   /**
    * Unpin every local ID in `localIDs` (best-effort; missing IDs are
    * ignored). Use after {@link ensureResidentClosureByLocalID}, which
@@ -5797,6 +5832,17 @@ var StepModelBase = class {
     }
     return this.ensureResidentClosureByLocalID(localID, extraLocalIDs, seen);
   }
+  /**
+   * Express IDs referenced by a resident record (`#<id>` tokens in its
+   * text, including multi-mapped class records). The record itself
+   * must already be resident.
+   *
+   * @param localID The record to scan.
+   * @return {number[]} Distinct referenced express IDs.
+   */
+  referencedExpressIDs(localID) {
+    return this.scanRecordRefs_(localID);
+  }
   /**
    * Scan a resident record's bytes for `#<expressID>` references.
    *
@@ -10982,6 +11028,38 @@ var StepEntityBase = class {
     }
     return value;
   }
+  /**
+   * Resolve a single reference field to its local ID without
+   * constructing the target entity. Prep maps that only store
+   * `Item.localID` (IfcStyledItem → faceset) must not hydrate the
+   * target: on a windowed source that would pin the faceset record
+   * (often megabytes) for every styled item at once.
+   *
+   * @param offset The offset in the vtable to extract from.
+   * @param baseOffset The base offset of the class in the vtable.
+   * @param depth The depth in the inheritance hierarchy.
+   * @param optional Is this an optional field?
+   * @return {number | null} The referenced local ID, or null if the
+   * field is unset/optional-null.
+   */
+  extractReferenceLocalID(offset, baseOffset, depth, optional) {
+    const [cursor, endCursor, buffer] = this.getOffsetAndEndCursor(offset, baseOffset, depth);
+    const expressID = stepExtractReference(buffer, cursor, endCursor);
+    if (expressID !== void 0) {
+      return this.model.resolveExpressID(expressID) ?? null;
+    }
+    const inline = this.model.getInlineElementByAddress(extractInlineElementAddress(buffer, cursor, endCursor));
+    if (inline !== void 0) {
+      return inline.localID;
+    }
+    if (!optional) {
+      throw new Error("Value in STEP was incorrectly typed");
+    }
+    if (!this.model.nullOnErrors && stepExtractOptional(buffer, cursor, endCursor) !== null) {
+      throw new Error("Value in STEP was incorrectly typed");
+    }
+    return null;
+  }
   /**
    *
    * @param buffer
@@ -11299,6 +11377,7 @@ var StepEntityBase = class {
    * @return {Uint8Array} The buffer for this.
    */
   get buffer() {
+    this.guaranteeBuffer();
     return this.internalReference_.buffer;
   }
   /**

package/compiled/examples/cli-bundled.cjs

@@ -14965,7 +14965,7 @@ ${t5.join("\n")}` : "";
 var import_process = require("process");
 
 // compiled/src/version/version.js
-var versionString = "Conway v1.510.1439";
+var versionString = "Conway v1.512.1444";
 
 // compiled/dependencies/conway-geom/interface/conway_geometry.js
 function pThreadsAllowed() {
@@ -16397,13 +16397,15 @@ var ProgressTracker = class {
    * Report progress within the current phase; throttled.
    *
    * @param completed Units completed so far.
+   * @param extras Optional extras (window residency) merged into the event.
    */
-  update(completed) {
+  update(completed, extras) {
+    this.extras_ = extras;
     const now = Date.now();
     if (now - this.lastEmitTime < this.minIntervalMs) {
       return;
     }
-    this.emit(completed, now);
+    this.emit(completed, now, extras);
   }
   /**
    * End the current phase, emitting an unthrottled final event with
@@ -16412,16 +16414,18 @@ var ProgressTracker = class {
    * @param completed Final completed units (defaults to the phase total).
    */
   endPhase(completed) {
-    this.emit(completed ?? this.total_ ?? 0);
+    this.emit(completed ?? this.total_ ?? 0, Date.now(), this.extras_);
     this.phase_ = void 0;
+    this.extras_ = void 0;
   }
   /**
    * Materialize and forward an event now, bypassing the throttle.
    *
    * @param completed Units completed so far.
    * @param now Current time in ms (defaults to Date.now()).
+   * @param extras Optional extras merged into the event.
    */
-  emit(completed, now = Date.now()) {
+  emit(completed, now = Date.now(), extras) {
     if (this.phase_ === void 0) {
       return;
     }
@@ -16433,7 +16437,8 @@ var ProgressTracker = class {
       total,
       unit: this.unit_,
       elapsedMs: now - this.startTime,
-      memoryMb: Memory.usedHeapMb()
+      memoryMb: Memory.usedHeapMb(),
+      residentSourceMb: extras?.residentSourceMb
     });
   }
 };
@@ -18741,7 +18746,10 @@ var StepParser = class extends StepHeaderParser {
         if (!charws(SEMICOLON)) {
           return syntaxError();
         }
-        onRecordIndexed?.(topLevelCount, expressID, 0);
+        {
+          const recordLen = input.address - startElement2;
+          onRecordIndexed?.(topLevelCount, expressID, 0, input.buffer.subarray(input.cursor - recordLen, input.cursor));
+        }
         ++topLevelCount;
         pushEntry({
           address: startElement2,
@@ -18831,7 +18839,10 @@ var StepParser = class extends StepHeaderParser {
       if (!charws(SEMICOLON)) {
         return syntaxError();
       }
-      onRecordIndexed?.(topLevelCount, expressID, foundItem);
+      {
+        const recordLen = input.address - startElement;
+        onRecordIndexed?.(topLevelCount, expressID, foundItem, input.buffer.subarray(input.cursor - recordLen, input.cursor));
+      }
       ++topLevelCount;
       pushEntry({
         address: startElement,
@@ -21645,6 +21656,35 @@ var StepModelBase = class {
     }
     this.bufferProvider_.unpinRange?.(this.address_[localID], this.length_[localID]);
   }
+  /**
+   * Drop captured source-window views on `localIDs` so the LRU can
+   * evict those chunks. Vtables stay — `acquire` of the same
+   * `(address, length)` is at a stable base. The next
+   * `ensureResident` + field read rematerialises the view.
+   *
+   * @param localIDs Records whose `buffer` views to drop.
+   */
+  releaseSourceViews(localIDs) {
+    if (!this.isSourceExternal) {
+      return;
+    }
+    for (const localID of localIDs) {
+      if (localID >= this.count_) {
+        continue;
+      }
+      const item = this.complexEntries_?.get(localID) ?? this.descriptorCache_[localID];
+      if (item === void 0) {
+        continue;
+      }
+      item.buffer = void 0;
+      if (item.multiMapping !== void 0) {
+        for (const mapped of item.multiMapping) {
+          mapped.buffer = void 0;
+        }
+      }
+    }
+    releaseScratchParsingBuffer();
+  }
   /**
    * Unpin every local ID in `localIDs` (best-effort; missing IDs are
    * ignored). Use after {@link ensureResidentClosureByLocalID}, which
@@ -21675,6 +21715,17 @@ var StepModelBase = class {
     }
     return this.ensureResidentClosureByLocalID(localID, extraLocalIDs, seen);
   }
+  /**
+   * Express IDs referenced by a resident record (`#<id>` tokens in its
+   * text, including multi-mapped class records). The record itself
+   * must already be resident.
+   *
+   * @param localID The record to scan.
+   * @return {number[]} Distinct referenced express IDs.
+   */
+  referencedExpressIDs(localID) {
+    return this.scanRecordRefs_(localID);
+  }
   /**
    * Scan a resident record's bytes for `#<expressID>` references.
    *
@@ -26860,6 +26911,38 @@ var StepEntityBase = class {
     }
     return value;
   }
+  /**
+   * Resolve a single reference field to its local ID without
+   * constructing the target entity. Prep maps that only store
+   * `Item.localID` (IfcStyledItem → faceset) must not hydrate the
+   * target: on a windowed source that would pin the faceset record
+   * (often megabytes) for every styled item at once.
+   *
+   * @param offset The offset in the vtable to extract from.
+   * @param baseOffset The base offset of the class in the vtable.
+   * @param depth The depth in the inheritance hierarchy.
+   * @param optional Is this an optional field?
+   * @return {number | null} The referenced local ID, or null if the
+   * field is unset/optional-null.
+   */
+  extractReferenceLocalID(offset, baseOffset, depth, optional) {
+    const [cursor, endCursor, buffer] = this.getOffsetAndEndCursor(offset, baseOffset, depth);
+    const expressID = stepExtractReference(buffer, cursor, endCursor);
+    if (expressID !== void 0) {
+      return this.model.resolveExpressID(expressID) ?? null;
+    }
+    const inline = this.model.getInlineElementByAddress(extractInlineElementAddress(buffer, cursor, endCursor));
+    if (inline !== void 0) {
+      return inline.localID;
+    }
+    if (!optional) {
+      throw new Error("Value in STEP was incorrectly typed");
+    }
+    if (!this.model.nullOnErrors && stepExtractOptional(buffer, cursor, endCursor) !== null) {
+      throw new Error("Value in STEP was incorrectly typed");
+    }
+    return null;
+  }
   /**
    *
    * @param buffer
@@ -27177,6 +27260,7 @@ var StepEntityBase = class {
    * @return {Uint8Array} The buffer for this.
    */
   get buffer() {
+    this.guaranteeBuffer();
     return this.internalReference_.buffer;
   }
   /**
@@ -92297,8 +92381,9 @@ var IfcGeometryExtraction = class _IfcGeometryExtraction {
     const styledItems = this.model.types(IfcStyledItem);
     for (const styledItem of styledItems) {
       try {
-        if (styledItem.Item !== null) {
-          this.materials.styledItemMap.set(styledItem.Item.localID, styledItem.localID);
+        const itemLocalID = styledItem.extractReferenceLocalID(0, 0, 1, true);
+        if (itemLocalID !== null) {
+          this.materials.styledItemMap.set(itemLocalID, styledItem.localID);
         }
       } catch (ex) {
         this.handleMapPrepError_("IfcStyledItem", styledItem.expressID, ex);
@@ -92559,6 +92644,12 @@ var IfcGeometryExtraction = class _IfcGeometryExtraction {
    * the relationship sweeps succeed on a windowed source. Call before
    * the first prepare on a model whose source is external.
    *
+   * Pins the prep-type records themselves (and a 1-hop of product /
+   * material records the relationship getters hydrate). Does **not**
+   * BFS-pin styled-item Item closures — those are facesets, and
+   * walking them here pulled most of the file into the windowed LRU
+   * before the first product extract.
+   *
    * @return {Promise<Set<number>>} Pinned local IDs — caller must
    * {@link StepModelBase.unpinLocalIDs} after prepare/extract.
    */
@@ -92567,17 +92658,48 @@ var IfcGeometryExtraction = class _IfcGeometryExtraction {
     if (!this.model.isSourceExternal) {
       return pinned;
     }
-    const prepTypes = [
-      IfcProject,
+    for (const type of [IfcProject, IfcMaterialDefinitionRepresentation]) {
+      for (const expressID of this.model.expressIDsOfTypes(type)) {
+        await this.model.ensureResidentClosureByExpressID(expressID, void 0, pinned);
+      }
+    }
+    const recordOnlyTypes = [
       IfcRelAssociatesMaterial,
-      IfcMaterialDefinitionRepresentation,
       IfcRelVoidsElement,
       IfcStyledItem,
       IfcRelAggregates
     ];
-    for (const type of prepTypes) {
+    for (const type of recordOnlyTypes) {
       for (const expressID of this.model.expressIDsOfTypes(type)) {
-        await this.model.ensureResidentClosureByExpressID(expressID, void 0, pinned);
+        const localID = this.model.resolveExpressID(expressID);
+        if (localID === void 0 || pinned.has(localID)) {
+          continue;
+        }
+        await this.model.ensureResidentByLocalID(localID);
+        this.model.pinByLocalID(localID);
+        pinned.add(localID);
+      }
+    }
+    const oneHopTypes = [
+      IfcRelAssociatesMaterial,
+      IfcRelVoidsElement,
+      IfcRelAggregates
+    ];
+    for (const type of oneHopTypes) {
+      for (const expressID of this.model.expressIDsOfTypes(type)) {
+        const localID = this.model.resolveExpressID(expressID);
+        if (localID === void 0) {
+          continue;
+        }
+        for (const refExpressID of this.model.referencedExpressIDs(localID)) {
+          const refLocalID = this.model.resolveExpressID(refExpressID);
+          if (refLocalID === void 0 || pinned.has(refLocalID)) {
+            continue;
+          }
+          await this.model.ensureResidentByLocalID(refLocalID);
+          this.model.pinByLocalID(refLocalID);
+          pinned.add(refLocalID);
+        }
       }
     }
     return pinned;
@@ -93304,12 +93426,13 @@ function heapDeltaSuffix(state) {
 function formatStageLine(state, final) {
   const duration = state.lastElapsedMs - state.startElapsedMs;
   const heap = heapDeltaSuffix(state);
+  const window2 = state.residentSourceMb !== void 0 ? `, window=${formatMb(state.residentSourceMb)} MB` : "";
   const determinate = state.percent !== void 0;
   if (final && !(determinate && state.percent < PERCENT)) {
-    return `${state.label}: ${formatSeconds(duration)}${heap}`;
+    return `${state.label}: ${formatSeconds(duration)}${heap}${window2}`;
   }
   const bar = formatBar(determinate ? state.percent : void 0);
-  return `${state.label} ${bar} ${formatSeconds(duration)}${heap}`;
+  return `${state.label} ${bar} ${formatSeconds(duration)}${heap}${window2}`;
 }
 var LoadLogAccumulator = class {
   constructor() {
@@ -93358,6 +93481,9 @@ var LoadLogAccumulator = class {
       current.startHeapMb ??= event.memoryMb;
       current.lastHeapMb = event.memoryMb;
     }
+    if (event.residentSourceMb !== void 0) {
+      current.residentSourceMb = event.residentSourceMb;
+    }
     if (event.total !== void 0 && event.total > 0) {
       current.percent = event.completed / event.total * PERCENT;
     }

package/compiled/examples/cli-step-bundled.cjs

@@ -15943,7 +15943,7 @@ var ParsingBuffer = class {
 };
 
 // compiled/src/version/version.js
-var versionString = "Conway v1.510.1439";
+var versionString = "Conway v1.512.1444";
 
 // compiled/dependencies/conway-geom/interface/conway_geometry.js
 function pThreadsAllowed() {
@@ -18649,7 +18649,10 @@ var StepParser = class extends StepHeaderParser {
         if (!charws(SEMICOLON)) {
           return syntaxError();
         }
-        onRecordIndexed?.(topLevelCount, expressID, 0);
+        {
+          const recordLen = input.address - startElement2;
+          onRecordIndexed?.(topLevelCount, expressID, 0, input.buffer.subarray(input.cursor - recordLen, input.cursor));
+        }
         ++topLevelCount;
         pushEntry({
           address: startElement2,
@@ -18739,7 +18742,10 @@ var StepParser = class extends StepHeaderParser {
       if (!charws(SEMICOLON)) {
         return syntaxError();
       }
-      onRecordIndexed?.(topLevelCount, expressID, foundItem);
+      {
+        const recordLen = input.address - startElement;
+        onRecordIndexed?.(topLevelCount, expressID, foundItem, input.buffer.subarray(input.cursor - recordLen, input.cursor));
+      }
       ++topLevelCount;
       pushEntry({
         address: startElement,
@@ -21389,6 +21395,35 @@ var StepModelBase = class {
     }
     this.bufferProvider_.unpinRange?.(this.address_[localID], this.length_[localID]);
   }
+  /**
+   * Drop captured source-window views on `localIDs` so the LRU can
+   * evict those chunks. Vtables stay — `acquire` of the same
+   * `(address, length)` is at a stable base. The next
+   * `ensureResident` + field read rematerialises the view.
+   *
+   * @param localIDs Records whose `buffer` views to drop.
+   */
+  releaseSourceViews(localIDs) {
+    if (!this.isSourceExternal) {
+      return;
+    }
+    for (const localID of localIDs) {
+      if (localID >= this.count_) {
+        continue;
+      }
+      const item = this.complexEntries_?.get(localID) ?? this.descriptorCache_[localID];
+      if (item === void 0) {
+        continue;
+      }
+      item.buffer = void 0;
+      if (item.multiMapping !== void 0) {
+        for (const mapped of item.multiMapping) {
+          mapped.buffer = void 0;
+        }
+      }
+    }
+    releaseScratchParsingBuffer();
+  }
   /**
    * Unpin every local ID in `localIDs` (best-effort; missing IDs are
    * ignored). Use after {@link ensureResidentClosureByLocalID}, which
@@ -21419,6 +21454,17 @@ var StepModelBase = class {
     }
     return this.ensureResidentClosureByLocalID(localID, extraLocalIDs, seen);
   }
+  /**
+   * Express IDs referenced by a resident record (`#<id>` tokens in its
+   * text, including multi-mapped class records). The record itself
+   * must already be resident.
+   *
+   * @param localID The record to scan.
+   * @return {number[]} Distinct referenced express IDs.
+   */
+  referencedExpressIDs(localID) {
+    return this.scanRecordRefs_(localID);
+  }
   /**
    * Scan a resident record's bytes for `#<expressID>` references.
    *
@@ -22787,6 +22833,38 @@ var StepEntityBase = class {
     }
     return value;
   }
+  /**
+   * Resolve a single reference field to its local ID without
+   * constructing the target entity. Prep maps that only store
+   * `Item.localID` (IfcStyledItem → faceset) must not hydrate the
+   * target: on a windowed source that would pin the faceset record
+   * (often megabytes) for every styled item at once.
+   *
+   * @param offset The offset in the vtable to extract from.
+   * @param baseOffset The base offset of the class in the vtable.
+   * @param depth The depth in the inheritance hierarchy.
+   * @param optional Is this an optional field?
+   * @return {number | null} The referenced local ID, or null if the
+   * field is unset/optional-null.
+   */
+  extractReferenceLocalID(offset, baseOffset, depth, optional) {
+    const [cursor, endCursor, buffer] = this.getOffsetAndEndCursor(offset, baseOffset, depth);
+    const expressID = stepExtractReference(buffer, cursor, endCursor);
+    if (expressID !== void 0) {
+      return this.model.resolveExpressID(expressID) ?? null;
+    }
+    const inline = this.model.getInlineElementByAddress(extractInlineElementAddress(buffer, cursor, endCursor));
+    if (inline !== void 0) {
+      return inline.localID;
+    }
+    if (!optional) {
+      throw new Error("Value in STEP was incorrectly typed");
+    }
+    if (!this.model.nullOnErrors && stepExtractOptional(buffer, cursor, endCursor) !== null) {
+      throw new Error("Value in STEP was incorrectly typed");
+    }
+    return null;
+  }
   /**
    *
    * @param buffer
@@ -23104,6 +23182,7 @@ var StepEntityBase = class {
    * @return {Uint8Array} The buffer for this.
    */
   get buffer() {
+    this.guaranteeBuffer();
     return this.internalReference_.buffer;
   }
   /**

package/compiled/examples/validator-bundled.cjs

@@ -944,7 +944,7 @@ var EntityTypesIfcCount = 909;
 var entity_types_ifc_gen_default = EntityTypesIfc;
 
 // compiled/src/version/version.js
-var versionString = "Conway v1.510.1439";
+var versionString = "Conway v1.512.1444";
 
 // compiled/dependencies/conway-geom/interface/conway_geometry.js
 var wasmType = "";
@@ -3824,7 +3824,10 @@ var StepParser = class extends StepHeaderParser {
         if (!charws(SEMICOLON)) {
           return syntaxError();
         }
-        onRecordIndexed?.(topLevelCount, expressID, 0);
+        {
+          const recordLen = input.address - startElement2;
+          onRecordIndexed?.(topLevelCount, expressID, 0, input.buffer.subarray(input.cursor - recordLen, input.cursor));
+        }
         ++topLevelCount;
         pushEntry({
           address: startElement2,
@@ -3914,7 +3917,10 @@ var StepParser = class extends StepHeaderParser {
       if (!charws(SEMICOLON)) {
         return syntaxError();
       }
-      onRecordIndexed?.(topLevelCount, expressID, foundItem);
+      {
+        const recordLen = input.address - startElement;
+        onRecordIndexed?.(topLevelCount, expressID, foundItem, input.buffer.subarray(input.cursor - recordLen, input.cursor));
+      }
       ++topLevelCount;
       pushEntry({
         address: startElement,
@@ -5765,6 +5771,35 @@ var StepModelBase = class {
     }
     this.bufferProvider_.unpinRange?.(this.address_[localID], this.length_[localID]);
   }
+  /**
+   * Drop captured source-window views on `localIDs` so the LRU can
+   * evict those chunks. Vtables stay — `acquire` of the same
+   * `(address, length)` is at a stable base. The next
+   * `ensureResident` + field read rematerialises the view.
+   *
+   * @param localIDs Records whose `buffer` views to drop.
+   */
+  releaseSourceViews(localIDs) {
+    if (!this.isSourceExternal) {
+      return;
+    }
+    for (const localID of localIDs) {
+      if (localID >= this.count_) {
+        continue;
+      }
+      const item = this.complexEntries_?.get(localID) ?? this.descriptorCache_[localID];
+      if (item === void 0) {
+        continue;
+      }
+      item.buffer = void 0;
+      if (item.multiMapping !== void 0) {
+        for (const mapped of item.multiMapping) {
+          mapped.buffer = void 0;
+        }
+      }
+    }
+    releaseScratchParsingBuffer();
+  }
   /**
    * Unpin every local ID in `localIDs` (best-effort; missing IDs are
    * ignored). Use after {@link ensureResidentClosureByLocalID}, which
@@ -5795,6 +5830,17 @@ var StepModelBase = class {
     }
     return this.ensureResidentClosureByLocalID(localID, extraLocalIDs, seen);
   }
+  /**
+   * Express IDs referenced by a resident record (`#<id>` tokens in its
+   * text, including multi-mapped class records). The record itself
+   * must already be resident.
+   *
+   * @param localID The record to scan.
+   * @return {number[]} Distinct referenced express IDs.
+   */
+  referencedExpressIDs(localID) {
+    return this.scanRecordRefs_(localID);
+  }
   /**
    * Scan a resident record's bytes for `#<expressID>` references.
    *
@@ -10980,6 +11026,38 @@ var StepEntityBase = class {
     }
     return value;
   }
+  /**
+   * Resolve a single reference field to its local ID without
+   * constructing the target entity. Prep maps that only store
+   * `Item.localID` (IfcStyledItem → faceset) must not hydrate the
+   * target: on a windowed source that would pin the faceset record
+   * (often megabytes) for every styled item at once.
+   *
+   * @param offset The offset in the vtable to extract from.
+   * @param baseOffset The base offset of the class in the vtable.
+   * @param depth The depth in the inheritance hierarchy.
+   * @param optional Is this an optional field?
+   * @return {number | null} The referenced local ID, or null if the
+   * field is unset/optional-null.
+   */
+  extractReferenceLocalID(offset, baseOffset, depth, optional) {
+    const [cursor, endCursor, buffer] = this.getOffsetAndEndCursor(offset, baseOffset, depth);
+    const expressID = stepExtractReference(buffer, cursor, endCursor);
+    if (expressID !== void 0) {
+      return this.model.resolveExpressID(expressID) ?? null;
+    }
+    const inline = this.model.getInlineElementByAddress(extractInlineElementAddress(buffer, cursor, endCursor));
+    if (inline !== void 0) {
+      return inline.localID;
+    }
+    if (!optional) {
+      throw new Error("Value in STEP was incorrectly typed");
+    }
+    if (!this.model.nullOnErrors && stepExtractOptional(buffer, cursor, endCursor) !== null) {
+      throw new Error("Value in STEP was incorrectly typed");
+    }
+    return null;
+  }
   /**
    *
    * @param buffer
@@ -11297,6 +11375,7 @@ var StepEntityBase = class {
    * @return {Uint8Array} The buffer for this.
    */
   get buffer() {
+    this.guaranteeBuffer();
     return this.internalReference_.buffer;
   }
   /**

package/compiled/src/compat/web-ifc/ifc_api_proxy_ifc.d.ts

@@ -253,8 +253,9 @@ export declare class IfcApiProxyIfc implements IfcApiModelPassthrough {
     /**
      * Windowed-from-birth twin of parseColumnarAndExtractAsync: the
      * source stays in `store`, parse windows are filled through it, and
-     * the model never holds a resident copy. Preview-during-parse is
-     * skipped (that channel needs a resident prefix). Deferred opens
+     * the model never holds a resident copy. The full prefix-extract
+     * preview channel is skipped (it needs a resident prefix); a sparse
+     * AABB imposter rides onRecordIndexed instead. Deferred opens
      * page prep closures before prepareDemandExtraction; non-deferred
      * opens drain the demand pump with per-product residency.
      *