@bldrs-ai/conway 1.530.1503 → 1.534.1505

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.530.1503";
+var versionString = "Conway v1.534.1505";
 
 // compiled/dependencies/conway-geom/interface/conway_geometry.js
 var wasmType = "";

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.530.1503";
+var versionString = "Conway v1.534.1505";
 
 // compiled/dependencies/conway-geom/interface/conway_geometry.js
 function pThreadsAllowed() {
@@ -88456,6 +88456,7 @@ var IfcSceneBuilder = class {
     this.sceneLocalIdMap_ = /* @__PURE__ */ new Map();
     this.geometrySet_ = /* @__PURE__ */ new Set();
     this.sceneStack_ = [];
+    this.geometryNodeVisits_ = 0;
   }
   /**
    *
@@ -88646,37 +88647,118 @@ var IfcSceneBuilder = class {
   isAllSpaces() {
     return this.scene_.every((node) => !(node instanceof IfcSceneGeometry) || node.isSpace);
   }
+  *walk(includeSpaces = false) {
+    for (let index = 0; index < this.scene_.length; ++index) {
+      const resolved = this.resolveGeometryNode_(index, includeSpaces);
+      if (resolved === void 0 || resolved[2] === void 0) {
+        continue;
+      }
+      yield [resolved[0], resolved[1], resolved[2], resolved[3], resolved[4]];
+    }
+  }
   /**
-   * Walk the current scene.
+   * The number of nodes in the scene array. Append-only, so a caller that
+   * remembers this value has a stable cursor into the scene: everything
+   * added after it sits at a higher index.
    *
-   * @yields Raw absolute matrix transform, the native absolute transform, the canonical mesh,
-   * @param includeSpaces
-   * the canonical material and the associated step element as it walks the hierarchy.
-   * @param walkTemporary Include temporary items.
+   * @return {number} The node count.
    */
-  *walk(includeSpaces = false) {
-    for (const node of this.scene_) {
-      if (node instanceof IfcSceneGeometry && (includeSpaces || !node.isSpace)) {
-        const parentIndex = node.parentIndex;
-        const geometry = node.model.geometry?.getByLocalID(node.localID);
-        if (geometry === void 0) {
-          continue;
-        }
-        let parentNode;
-        if (parentIndex !== void 0) {
-          parentNode = this.scene_[parentIndex];
-        }
-        const material = this.materials.getMaterialByGeometryID(node.materialOverideLocalID ?? geometry.localID);
-        yield [
-          parentNode?.absoluteTransform,
-          parentNode?.absoluteNativeTransform,
-          geometry,
-          material !== void 0 ? material[0] : void 0,
-          node.relatedElementLocalId !== void 0 ? this.model.getElementByLocalID(node.relatedElementLocalId) : void 0
-        ];
+  get nodeCount() {
+    return this.scene_.length;
+  }
+  /**
+   * How many times a node has been considered by any walk form since this
+   * scene was built.
+   *
+   * Exists so the *complexity* of an incremental consumer can be asserted
+   * rather than timed: a capture that walks only what the scene gained
+   * visits each node about once for the whole load, where one that
+   * re-walks from zero visits every node once per call. Output parity
+   * cannot distinguish those — both deliver the same meshes — so without
+   * this a regression from O(new nodes) back to O(batches x scene) passes
+   * every correctness test while restoring the cost. See the batch-size
+   * invariance test in ifc_api_deferred_open.test.ts.
+   *
+   * @return {number} The visit count.
+   */
+  get geometryNodeVisits() {
+    return this.geometryNodeVisits_;
+  }
+  /**
+   * Walk only the nodes added at or after `startIndex` — the incremental
+   * form of {@link walk}, for a consumer draining the scene in batches.
+   *
+   * Unlike `walk`, this yields nodes whose geometry does NOT resolve, with
+   * `undefined` in the geometry slot and the node's index last. That is
+   * deliberate: a cursor-based caller passes each index exactly once, so a
+   * node skipped for missing geometry would be lost forever, where the
+   * whole-scene walk would have picked it up on its next pass. Geometry can
+   * appear late — a product that maps geometry a release freed re-extracts
+   * it — so the caller must park those indices and retry them with
+   * {@link walkNode}. Yielding them is what makes that possible.
+   *
+   * @param startIndex First node index to consider.
+   * @param includeSpaces Include space geometry.
+   * @yields The walk tuple plus the node's index.
+   */
+  *walkFrom(startIndex, includeSpaces = false) {
+    for (let index = startIndex; index < this.scene_.length; ++index) {
+      const resolved = this.resolveGeometryNode_(index, includeSpaces);
+      if (resolved === void 0) {
+        continue;
       }
+      yield resolved;
     }
   }
+  /**
+   * Resolve one node by index, for retrying a node {@link walkFrom} yielded
+   * without geometry.
+   *
+   * @param index The node's index in the scene array.
+   * @param includeSpaces Include space geometry.
+   * @return {[...]|undefined} The walk tuple plus the index, or undefined
+   * when the node isn't geometry this walk covers.
+   */
+  walkNode(index, includeSpaces = false) {
+    return this.resolveGeometryNode_(index, includeSpaces);
+  }
+  /**
+   * The shared body of walk/walkFrom/walkNode: one node in, one walk tuple
+   * out. Single-sourced so the incremental walk cannot drift from the whole
+   * -scene one — a drift here would show up as geometry placed differently
+   * depending on batch size.
+   *
+   * @param index The node's index in the scene array.
+   * @param includeSpaces Include space geometry.
+   * @return {[...]|undefined} Undefined when the node isn't a geometry node
+   * this walk covers; otherwise the tuple, whose geometry slot is undefined
+   * if the geometry doesn't currently resolve.
+   */
+  resolveGeometryNode_(index, includeSpaces) {
+    ++this.geometryNodeVisits_;
+    const node = this.scene_[index];
+    if (!(node instanceof IfcSceneGeometry) || !includeSpaces && node.isSpace) {
+      return void 0;
+    }
+    const geometry = node.model.geometry?.getByLocalID(node.localID);
+    if (geometry === void 0) {
+      return [void 0, void 0, void 0, void 0, void 0, index];
+    }
+    const parentIndex = node.parentIndex;
+    let parentNode;
+    if (parentIndex !== void 0) {
+      parentNode = this.scene_[parentIndex];
+    }
+    const material = this.materials.getMaterialByGeometryID(node.materialOverideLocalID ?? geometry.localID);
+    return [
+      parentNode?.absoluteTransform,
+      parentNode?.absoluteNativeTransform,
+      geometry,
+      material !== void 0 ? material[0] : void 0,
+      node.relatedElementLocalId !== void 0 ? this.model.getElementByLocalID(node.relatedElementLocalId) : void 0,
+      index
+    ];
+  }
   /**
    *
    */

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

@@ -15943,7 +15943,7 @@ var ParsingBuffer = class {
 };
 
 // compiled/src/version/version.js
-var versionString = "Conway v1.530.1503";
+var versionString = "Conway v1.534.1505";
 
 // compiled/dependencies/conway-geom/interface/conway_geometry.js
 function pThreadsAllowed() {

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.530.1503";
+var versionString = "Conway v1.534.1505";
 
 // compiled/dependencies/conway-geom/interface/conway_geometry.js
 var wasmType = "";

package/compiled/src/compat/web-ifc/ifc_api_deferred_open.test.js

@@ -277,6 +277,126 @@ describe("OpenModelStreamed + DEFER_GEOMETRY", () => {
         api4.CloseModel(classicID);
         api4.CloseModel(deferredID);
     }, 240000);
+    test("shared representation survives a batch boundary, emitted once", async () => {
+        // data/mapped_shared_representation.ifc: one IfcRepresentationMap
+        // mapped by two products 15 products apart, so a batch size of 4
+        // guarantees they land in DIFFERENT batches. The smoke corpus cannot
+        // produce this shape — there every sharer of a definition falls
+        // inside one batch — so this is the only fixture that exercises the
+        // delta capture across a boundary where geometry is shared.
+        //
+        // It pins the cursor capture from both directions. Lose a parked or
+        // suffix node and the second mapped product goes missing; re-emit a
+        // node the cursor should have passed (the failure a reverted cursor
+        // or a broken watermark produces) and instances duplicate. Both show
+        // up as an instance-count mismatch against classic, which is why the
+        // comparison is against classic rather than a hard-coded number.
+        const api5 = new IfcAPI();
+        await api5.Init();
+        const fixture = new Uint8Array(fs.readFileSync("data/mapped_shared_representation.ifc"));
+        const classicID = api5.OpenModel(fixture, SETTINGS);
+        const classicPlacements = [];
+        api5.StreamAllMeshes(classicID, (mesh) => {
+            for (let where = 0; where < mesh.geometries.size(); ++where) {
+                const placed = mesh.geometries.get(where);
+                classicPlacements.push(`${placed.geometryExpressID}@${[...placed.flatTransformation]
+                    .map((value) => value.toFixed(3)).join(",")}`);
+            }
+        });
+        const deferredID = await api5.OpenModelStreamed(fixture, { ...SETTINGS, DEFER_GEOMETRY: true });
+        const pumpedPlacements = [];
+        let batches = 0;
+        for (;;) {
+            const { extracted, remaining } = api5.ExtractGeometryBatch(deferredID, 4, (mesh) => {
+                for (let where = 0; where < mesh.geometries.size(); ++where) {
+                    const placed = mesh.geometries.get(where);
+                    pumpedPlacements.push(`${placed.geometryExpressID}@${[...placed.flatTransformation]
+                        .map((value) => value.toFixed(3)).join(",")}`);
+                }
+            });
+            ++batches;
+            if (remaining === 0 && extracted === 0) {
+                break;
+            }
+        }
+        // The boundary the fixture exists to create: with 16 products at
+        // batch 4, the two sharers cannot be in the same batch.
+        expect(batches).toBeGreaterThan(2);
+        // Exact multiset equality — placement included, so an instance
+        // delivered at the wrong location fails as loudly as a missing one.
+        expect(pumpedPlacements.slice().sort())
+            .toEqual(classicPlacements.slice().sort());
+        // Emitted once each: a duplicate would survive the multiset check
+        // only if classic duplicated too, but state it directly since
+        // re-emission is the specific failure a broken cursor produces.
+        expect(new Set(pumpedPlacements).size).toBe(pumpedPlacements.length);
+        // Both users of the shared map are present, at their own placements
+        // — the shared SOURCE geometry appears under two distinct transforms.
+        const mappedTransforms = new Set(pumpedPlacements.map((entry) => entry.split("@")[1]));
+        expect(mappedTransforms.size).toBe(pumpedPlacements.length);
+        api5.CloseModel(classicID);
+        api5.CloseModel(deferredID);
+    }, 240000);
+    test("delta capture visits each scene node once, whatever the batch size", async () => {
+        // Output parity cannot see this. The whole-scene walk this replaced
+        // delivered exactly the same meshes; what changed is the COST of
+        // delivering them — it re-resolved every node on every call, so the
+        // capture was O(batches x scene). A revert would pass every
+        // correctness assertion in this file while restoring the 1.47-2.97x
+        // regression the PR description measures, so the complexity gets an
+        // assertion of its own.
+        //
+        // Counting node visits rather than timing: deterministic, and it
+        // fails the same way on a fast machine as a slow one.
+        const api6 = new IfcAPI();
+        await api6.Init();
+        const fixture = new Uint8Array(fs.readFileSync("data/mapped_shared_representation.ifc"));
+        /**
+         * Pump a fresh deferred model to completion and report how much
+         * scene walking it took.
+         *
+         * @param batchSize Products per ExtractGeometryBatch call.
+         * @return {Promise<{visits: number, nodes: number, batches: number}>}
+         * Node visits, final scene size, and calls taken.
+         */
+        async function pump(batchSize) {
+            const modelID = await api6.OpenModelStreamed(fixture, { ...SETTINGS, DEFER_GEOMETRY: true });
+            let batches = 0;
+            for (;;) {
+                const { extracted, remaining } = api6.ExtractGeometryBatch(modelID, batchSize, () => { });
+                ++batches;
+                if (remaining === 0 && extracted === 0) {
+                    break;
+                }
+            }
+            const scene = api6.getPassthrough(modelID)
+                .model[1];
+            // A revert that drops the counter along with the cursor would
+            // otherwise fail as `expected undefined to be less than 68`, which
+            // reads like a broken test rather than the regression it is.
+            expect(typeof scene?.geometryNodeVisits)
+                .toBe("number");
+            const measured = { visits: scene.geometryNodeVisits, nodes: scene.nodeCount, batches };
+            api6.CloseModel(modelID);
+            return measured;
+        }
+        const oneAtATime = await pump(1);
+        const allAtOnce = await pump(64);
+        // The fixture is 16 products, so batch 1 really does take many calls
+        // — otherwise this asserts nothing.
+        expect(oneAtATime.batches).toBeGreaterThan(8);
+        expect(allAtOnce.batches).toBeLessThan(oneAtATime.batches);
+        // The invariant: total walking is a property of the SCENE, not of how
+        // many calls drained it. Allowing 2x the node count leaves room for
+        // the whole-model drain's own pass and for parked-node retries
+        // (DEMAND_PARKED_NODE_RETRIES each, and nothing in this corpus parks
+        // a node at all), while a per-call re-walk would land near
+        // batches x nodes — an order of magnitude clear of the bound.
+        expect(oneAtATime.visits).toBeLessThan(oneAtATime.nodes * 2);
+        // And it must not grow when the batch shrinks, which is the specific
+        // shape of the regression: same scene, ~16x the calls, same work.
+        expect(oneAtATime.visits).toBeLessThan(allAtOnce.visits * 2);
+    }, 240000);
     test("ExtractGeometryBatch is a safe no-op on non-deferred models", async () => {
         const modelID = await api.OpenModelStreamed(buffer, SETTINGS);
         expect(api.ExtractGeometryBatch(modelID, 8))

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

@@ -75,7 +75,38 @@ export declare class IfcApiProxyIfc implements IfcApiModelPassthrough {
      * batches - the watermark makes each instance captured exactly once,
      * in the same order the classic single walk would process it.
      */
-    private readonly demandCapturedCounts_;
+    /**
+     * How much of the scene array the delta capture has consumed. The scene
+     * is append-only, so this is a stable cursor: everything a batch adds
+     * sits above it. Replaces the per-entity walk watermark this used to
+     * keep, which existed only because the capture restarted its walk from
+     * zero every batch — an O(batches x scene) cost that dominated on
+     * instance-dense models (D3D: 562k instances, 1182 batches at size 64).
+     */
+    private demandSceneCursor_;
+    /**
+     * Node indices walkFrom yielded without resolvable geometry, against the
+     * number of times a later capture has re-checked them. Parked because a
+     * cursor passes each index once, where the whole-scene walk this replaced
+     * re-checked every node on every call. See IfcSceneBuilder.walkFrom.
+     *
+     * Bounded by DEMAND_PARKED_NODE_RETRIES because not every unresolved node
+     * is waiting on something: extraction can append a scene node and then
+     * fail to cache geometry for it (extractSweptDiskSolid returns early on a
+     * failed directrix; extractRepresentationItem still calls addGeometry),
+     * and no amount of re-checking makes a deterministic failure resolve.
+     * Retrying those forever would be O(batches x unresolvable) — still under
+     * the O(batches x scene) this replaced, but unbounded in batch count for
+     * no benefit. Expiring after a fixed number of attempts makes the total
+     * retry work O(retries x unresolvable) regardless of batch size.
+     *
+     * Measured at zero on every model available here — the 12-model smoke
+     * corpus, PSB, and D3D (which logs exactly the malformed-geometry errors
+     * that produce this case) all park nothing — so this path is a
+     * correctness guard rather than a hot path, and its constant is chosen to
+     * be generous rather than tuned.
+     */
+    private readonly demandPendingNodes_;
     /** Cursor into demandProducts_ — products before it are extracted. */
     private demandCursor_;
     /** Wall-clock split of the store-backed batch pump (profile script). */

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

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

package/compiled/src/compat/web-ifc/ifc_api_proxy_ifc.js

@@ -30,6 +30,14 @@ import { CanonicalMeshType } from "../../index.js";
 // Batch size used when a whole-model consumer (streamAllMeshes) drains
 // a deferred model's remaining products synchronously.
 const DEFERRED_DRAIN_BATCH = 256;
+/* How many later captures re-check a scene node whose geometry did not
+ * resolve when its index passed the cursor, before giving up on it. See
+ * demandPendingNodes_ for why the bound exists and why the value is
+ * generous rather than tuned: nothing in the corpus, PSB or D3D parks a
+ * node at all, and a node that is waiting on anything real is waiting on
+ * the very next extraction, not the eighth. */
+// eslint-disable-next-line no-magic-numbers
+const DEMAND_PARKED_NODE_RETRIES = 8;
 /* Moving-window size for the streamed columnar parse (matches the
  * ifc_stream_open default; the window bounds parse-time scratch, not
  * the source buffer, which the model keeps resident here). */
@@ -87,7 +95,38 @@ export class IfcApiProxyIfc {
          * batches - the watermark makes each instance captured exactly once,
          * in the same order the classic single walk would process it.
          */
-        this.demandCapturedCounts_ = new Map();
+        /**
+         * How much of the scene array the delta capture has consumed. The scene
+         * is append-only, so this is a stable cursor: everything a batch adds
+         * sits above it. Replaces the per-entity walk watermark this used to
+         * keep, which existed only because the capture restarted its walk from
+         * zero every batch — an O(batches x scene) cost that dominated on
+         * instance-dense models (D3D: 562k instances, 1182 batches at size 64).
+         */
+        this.demandSceneCursor_ = 0;
+        /**
+         * Node indices walkFrom yielded without resolvable geometry, against the
+         * number of times a later capture has re-checked them. Parked because a
+         * cursor passes each index once, where the whole-scene walk this replaced
+         * re-checked every node on every call. See IfcSceneBuilder.walkFrom.
+         *
+         * Bounded by DEMAND_PARKED_NODE_RETRIES because not every unresolved node
+         * is waiting on something: extraction can append a scene node and then
+         * fail to cache geometry for it (extractSweptDiskSolid returns early on a
+         * failed directrix; extractRepresentationItem still calls addGeometry),
+         * and no amount of re-checking makes a deterministic failure resolve.
+         * Retrying those forever would be O(batches x unresolvable) — still under
+         * the O(batches x scene) this replaced, but unbounded in batch count for
+         * no benefit. Expiring after a fixed number of attempts makes the total
+         * retry work O(retries x unresolvable) regardless of batch size.
+         *
+         * Measured at zero on every model available here — the 12-model smoke
+         * corpus, PSB, and D3D (which logs exactly the malformed-geometry errors
+         * that produce this case) all park nothing — so this path is a
+         * correctness guard rather than a hot path, and its constant is chosen to
+         * be generous rather than tuned.
+         */
+        this.demandPendingNodes_ = new Map();
         /** Cursor into demandProducts_ — products before it are extracted. */
         this.demandCursor_ = 0;
         /** Wall-clock split of the store-backed batch pump (profile script). */
@@ -1617,19 +1656,45 @@ export class IfcApiProxyIfc {
         }
         const [model, scene, meshMap, geometryMaterialTransformMap] = this.model;
         let coordinationMatrix = this.demandCoordination_ ?? glmatrix.mat4.create();
-        const seenThisPass = new Map();
         const deltas = new Map();
-        // eslint-disable-next-line no-unused-vars
-        for (const [_, nativeTransform, geometry, material, entity] of scene.walk()) {
-            if (entity?.localID === void 0 || entity.expressID === void 0) {
-                continue;
+        // Everything the scene has gained since the last capture, plus any
+        // node parked earlier for unresolvable geometry. Each node passes
+        // through exactly once, so no watermark is needed to suppress
+        // re-emission - the cursor IS the watermark, one for the whole scene
+        // rather than one per entity.
+        const capturedCursor = this.demandSceneCursor_;
+        const pending = this.demandPendingNodes_;
+        this.demandSceneCursor_ = scene.nodeCount;
+        const candidates = function* () {
+            for (const [index, attempts] of [...pending]) {
+                const retried = scene.walkNode(index);
+                if (retried === void 0 || retried[2] === void 0) {
+                    if (attempts + 1 >= DEMAND_PARKED_NODE_RETRIES) {
+                        pending.delete(index);
+                    }
+                    else {
+                        pending.set(index, attempts + 1);
+                    }
+                    continue;
+                }
+                pending.delete(index);
+                yield retried;
             }
-            // Per-entity walk position vs watermark: instances before the
-            // watermark were captured in an earlier call (append-only walk
-            // order makes the count a stable cursor).
-            const walkIndex = seenThisPass.get(entity.localID) ?? 0;
-            seenThisPass.set(entity.localID, walkIndex + 1);
-            if (walkIndex < (this.demandCapturedCounts_.get(entity.localID) ?? 0)) {
+            for (const candidate of scene.walkFrom(capturedCursor)) {
+                if (candidate[2] === void 0) {
+                    pending.set(candidate[5], 0);
+                    continue;
+                }
+                yield candidate;
+            }
+        };
+        // eslint-disable-next-line no-unused-vars
+        for (const [_, nativeTransform, geometry, material, entity] of candidates()) {
+            // `candidates` never yields an unresolved geometry — the undefined
+            // arm is the parked-node signal, handled there — but the tuple type
+            // allows it, so narrow here rather than asserting at each use.
+            if (geometry === void 0 ||
+                entity?.localID === void 0 || entity.expressID === void 0) {
                 continue;
             }
             if (geometry.type !== CanonicalMeshType.BUFFER_GEOMETRY || geometry.temporary) {
@@ -1718,7 +1783,6 @@ export class IfcApiProxyIfc {
             }
             mesh[0].push(placed);
             mesh[1].geometries = mesh[0];
-            this.demandCapturedCounts_.set(entity.localID, (this.demandCapturedCounts_.get(entity.localID) ?? 0) + 1);
             let delta = deltas.get(entity.expressID);
             if (delta === void 0) {
                 delta = [];

package/compiled/src/ifc/ifc_scene_builder.d.ts

@@ -151,6 +151,7 @@ export declare class IfcSceneBuilder implements WalkableScene<StepEntityBase<Ent
      * the canonical material and the associated step element as it walks the hierarchy.
      * @param walkTemporary Include temporary items.
      */
+    private geometryNodeVisits_;
     walk(includeSpaces?: boolean): IterableIterator<[
         readonly number[] | undefined,
         NativeTransform4x4 | undefined,
@@ -158,6 +159,85 @@ export declare class IfcSceneBuilder implements WalkableScene<StepEntityBase<Ent
         CanonicalMaterial | undefined,
         StepEntityBase<EntityTypesIfc> | undefined
     ]>;
+    /**
+     * The number of nodes in the scene array. Append-only, so a caller that
+     * remembers this value has a stable cursor into the scene: everything
+     * added after it sits at a higher index.
+     *
+     * @return {number} The node count.
+     */
+    get nodeCount(): number;
+    /**
+     * How many times a node has been considered by any walk form since this
+     * scene was built.
+     *
+     * Exists so the *complexity* of an incremental consumer can be asserted
+     * rather than timed: a capture that walks only what the scene gained
+     * visits each node about once for the whole load, where one that
+     * re-walks from zero visits every node once per call. Output parity
+     * cannot distinguish those — both deliver the same meshes — so without
+     * this a regression from O(new nodes) back to O(batches x scene) passes
+     * every correctness test while restoring the cost. See the batch-size
+     * invariance test in ifc_api_deferred_open.test.ts.
+     *
+     * @return {number} The visit count.
+     */
+    get geometryNodeVisits(): number;
+    /**
+     * Walk only the nodes added at or after `startIndex` — the incremental
+     * form of {@link walk}, for a consumer draining the scene in batches.
+     *
+     * Unlike `walk`, this yields nodes whose geometry does NOT resolve, with
+     * `undefined` in the geometry slot and the node's index last. That is
+     * deliberate: a cursor-based caller passes each index exactly once, so a
+     * node skipped for missing geometry would be lost forever, where the
+     * whole-scene walk would have picked it up on its next pass. Geometry can
+     * appear late — a product that maps geometry a release freed re-extracts
+     * it — so the caller must park those indices and retry them with
+     * {@link walkNode}. Yielding them is what makes that possible.
+     *
+     * @param startIndex First node index to consider.
+     * @param includeSpaces Include space geometry.
+     * @yields The walk tuple plus the node's index.
+     */
+    walkFrom(startIndex: number, includeSpaces?: boolean): IterableIterator<[
+        readonly number[] | undefined,
+        NativeTransform4x4 | undefined,
+        CanonicalMesh | undefined,
+        CanonicalMaterial | undefined,
+        StepEntityBase<EntityTypesIfc> | undefined,
+        number
+    ]>;
+    /**
+     * Resolve one node by index, for retrying a node {@link walkFrom} yielded
+     * without geometry.
+     *
+     * @param index The node's index in the scene array.
+     * @param includeSpaces Include space geometry.
+     * @return {[...]|undefined} The walk tuple plus the index, or undefined
+     * when the node isn't geometry this walk covers.
+     */
+    walkNode(index: number, includeSpaces?: boolean): [
+        readonly number[] | undefined,
+        NativeTransform4x4 | undefined,
+        CanonicalMesh | undefined,
+        CanonicalMaterial | undefined,
+        StepEntityBase<EntityTypesIfc> | undefined,
+        number
+    ] | undefined;
+    /**
+     * The shared body of walk/walkFrom/walkNode: one node in, one walk tuple
+     * out. Single-sourced so the incremental walk cannot drift from the whole
+     * -scene one — a drift here would show up as geometry placed differently
+     * depending on batch size.
+     *
+     * @param index The node's index in the scene array.
+     * @param includeSpaces Include space geometry.
+     * @return {[...]|undefined} Undefined when the node isn't a geometry node
+     * this walk covers; otherwise the tuple, whose geometry slot is undefined
+     * if the geometry doesn't currently resolve.
+     */
+    private resolveGeometryNode_;
     /**
      *
      */

package/compiled/src/ifc/ifc_scene_builder.d.ts.map

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