@ifc-lite/geometry 3.5.0 → 3.7.1

package/dist/geometry-native.js

@@ -49,8 +49,8 @@ export function enqueueNativeStreamingEvent(queuedEvents, event, queueState) {
     queueState.queuedMeshes += event.meshes.length;
 }
 /**
- * Shared native streaming generator used by both buffer-based and
- * path-based native geometry streaming.
+ * Shared native streaming generator used by every native geometry route:
+ * buffer-based (`processStreaming`), path-based and cache-based.
  *
  * @param startStream  Callback that kicks off the native stream and
  *                     returns a promise resolving when it finishes.
@@ -58,8 +58,11 @@ export function enqueueNativeStreamingEvent(queuedEvents, event, queueState) {
  * @param coordinator    CoordinateHandler for incremental bounds.
  * @param setLastNativeStats  Callback to persist the latest stats on
  *                            the owning GeometryProcessor instance.
+ * @param options  Per-route queue/coordinate behaviour; see NativeStreamOptions.
  */
-export async function* streamNativeGeometry(startStream, totalEstimate, coordinator, setLastNativeStats) {
+export async function* streamNativeGeometry(startStream, totalEstimate, coordinator, setLastNativeStats, options = {}) {
+    const coalesce = options.coalesce !== false;
+    const processMeshes = options.processMeshes ?? ((meshes) => coordinator.processTrustedMeshesIncremental(meshes));
     coordinator.reset();
     yield { type: 'start', totalEstimate };
     await yieldToEventLoop();
@@ -78,13 +81,21 @@ export async function* streamNativeGeometry(startStream, totalEstimate, coordina
             resolvePending = null;
         }
     };
+    const enqueue = (event) => {
+        if (coalesce) {
+            enqueueNativeStreamingEvent(queuedEvents, event, queueState);
+        }
+        else {
+            queuedEvents.push(event);
+        }
+    };
     const streamingPromise = startStream({
         onBatch: (batch) => {
-            enqueueNativeStreamingEvent(queuedEvents, { type: 'batch', meshes: batch.meshes, nativeTelemetry: batch.nativeTelemetry }, queueState);
+            enqueue({ type: 'batch', meshes: batch.meshes, nativeTelemetry: batch.nativeTelemetry });
             wake();
         },
         onColorUpdate: (updates) => {
-            enqueueNativeStreamingEvent(queuedEvents, { type: 'colorUpdate', updates: new Map(updates) }, queueState);
+            enqueue({ type: 'colorUpdate', updates: new Map(updates) });
             wake();
         },
         onComplete: (stats) => {
@@ -100,6 +111,35 @@ export async function* streamNativeGeometry(startStream, totalEstimate, coordina
             wake();
         },
     });
+    // A `startStream` rejection that never reached `onError` used to strand this
+    // generator: `completed` stays false, so the drain loop parks on the wake
+    // promise below and nothing ever resolves it — the load hangs forever and the
+    // failure surfaces only as an unhandled rejection. That is reachable today,
+    // because the bridge only routes throws through `onError` from inside its own
+    // try/catch: `NativeBridge.processGeometryStreamingPath` has none at all (the
+    // missing-cache-key throw, and every failure of the packed-shard stream it
+    // delegates to — including the Rust-reported `failed` status and the 60 s
+    // stall guard — reject straight out), and its siblings can still reject from
+    // the `init()` / `listen()` calls that precede their try. Treat a rejected
+    // stream promise as a stream error so the caller sees the real message.
+    //
+    // Only while the stream is still running, though. A rejection that arrives
+    // AFTER `onComplete`/`onError` has settled the stream is teardown fallout,
+    // not the load's outcome: `NativeBridge.processGeometryStreaming` runs its
+    // three `unlisten()` calls in a `finally`, which executes after `onComplete`,
+    // so a throwing `unlisten` rejects the promise of a load that fully
+    // succeeded. Failing it here would discard every mesh already delivered.
+    // Post-completion rejections are logged by the `finally` below instead.
+    void streamingPromise.catch((error) => {
+        if (completed)
+            return;
+        // `??=` rather than `=`: `onError` sets `streamError` and `completed`
+        // together, so the guard above already covers it, but this keeps the
+        // "never shadow a richer onError message" property local to the assignment.
+        streamError ??= error instanceof Error ? error : new Error(String(error));
+        completed = true;
+        wake();
+    });
     try {
         while (!completed || queuedEvents.length > 0) {
             let drainedEventCount = 0;
@@ -112,9 +152,7 @@ export async function* streamNativeGeometry(startStream, totalEstimate, coordina
                     continue;
                 }
                 queueState.queuedMeshes = Math.max(0, queueState.queuedMeshes - event.meshes.length);
-                // Native desktop streaming already produces site-local geometry, so
-                // avoid the generic JS RTC/outlier scan on every streamed batch.
-                coordinator.processTrustedMeshesIncremental(event.meshes);
+                processMeshes(event.meshes);
                 totalMeshes += event.meshes.length;
                 const coordinateInfo = coordinator.getCurrentCoordinateInfo();
                 yield {
@@ -126,7 +164,7 @@ export async function* streamNativeGeometry(startStream, totalEstimate, coordina
                 };
                 drainedEventCount += 1;
                 drainedMeshCount += event.meshes.length;
-                if (queuedEvents.length > 0) {
+                if (coalesce && queuedEvents.length > 0) {
                     const shouldYield = drainedEventCount >= MAX_NATIVE_STREAM_EVENTS_PER_TURN ||
                         drainedMeshCount >= MAX_NATIVE_STREAM_MESHES_PER_TURN ||
                         performance.now() - drainStartedAt >= MAX_NATIVE_STREAM_DRAIN_MS;
@@ -147,6 +185,14 @@ export async function* streamNativeGeometry(startStream, totalEstimate, coordina
                 });
             }
         }
+        // The in-loop check above only runs while the loop still has a reason to
+        // spin. `onError` sets `completed` AND leaves the queue empty, so the wake
+        // it triggers falls straight out of the loop past that check — and this
+        // generator then reported `complete` for a stream that failed. Re-check on
+        // the way out so the error reaches the caller.
+        if (streamError) {
+            throw streamError;
+        }
     }
     finally {
         // Ensure the native stream and its Tauri listeners are torn down
@@ -155,10 +201,35 @@ export async function* streamNativeGeometry(startStream, totalEstimate, coordina
         try {
             await streamingPromise;
         }
-        catch {
-            /* cleanup — safe to ignore */
+        catch (err) {
+            // Two ways to land here, neither of which the caller learns anything new
+            // from: the rejection arrived while the stream was still running, in which
+            // case the handler above already recorded it as `streamError` and the
+            // drain loop threw it — this is the same error a second time; or it
+            // arrived after the stream had already completed, in which case it is
+            // teardown fallout that must NOT retro-fail a finished load. Debug level,
+            // because this is the only place that kind is reported at all — a real
+            // failure reported through `onError` (rather than only this bare
+            // rejection) is not swallowed here: it sets `streamError` unconditionally
+            // and the recheck right after this `finally` still throws it below.
+            console.debug('[GeometryProcessor] native stream teardown rejected:', err);
         }
     }
+    // Defense in depth, matching the shape of the two exit-guard checks above:
+    // `onError` is never gated on `completed` — a bridge that reports a genuine
+    // failure must win regardless of when that report arrives — so it can still
+    // fire after both of those checks already ran clean (streamError was null
+    // at both), while this generator sits in the `finally` above awaiting
+    // `streamingPromise`. Nothing rechecked `streamError` after that point, so
+    // a failure signalled that late was recorded and then never read: the
+    // caller got `complete` for a stream that, per its own `onError` call,
+    // failed. This does NOT reopen the post-complete teardown case just above —
+    // a rejection that only ever reaches the detached `.catch()` (never
+    // `onError`) is still gated on `!completed` there and leaves `streamError`
+    // null, so that case still falls through to `complete` unchanged.
+    if (streamError) {
+        throw streamError;
+    }
     if (queueState.coalescedBatchCount > 0) {
         console.info(`[GeometryProcessor] Coalesced ${queueState.coalescedBatchCount} native batches while JS drained the queue`);
     }

package/dist/geometry-native.js.map

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

package/dist/geometry-parallel.d.ts

@@ -23,6 +23,40 @@ import type { CoordinateHandler } from './coordinate-handler.js';
 import type { TessellationQuality } from './types.js';
 import type { StreamingGeometryEvent } from './index.js';
 import type { BatchSizingConfig } from './batch-sizing.js';
+/**
+ * Prepass class-byte layout, mirroring the `PREPASS_CLASS_*` definitions in
+ * `rust/processing/src/shard_classes.rs` (the source of truth — these are
+ * pinned to it by `prepass-class-spans.test.ts`).
+ *
+ * The producer packs a named code in the LOW bits and composes FLAG bits on
+ * top (`PREPASS_CLASS_FLAG_GEOMETRY_JOB` 0x80, `..._FLAG_TYPE_CANDIDATE`
+ * 0x40), so a consumer must mask before comparing — the Rust consumer does
+ * (`gpu_meshes/prepass_discovery.rs`), and so does {@link extractPrepassSpanLists}.
+ */
+export declare const PREPASS_CLASS_CODE_MASK = 63;
+/** `IFCSTYLEDITEM`. */
+export declare const PREPASS_CLASS_STYLED_ITEM = 4;
+/** `IFCINDEXEDCOLOURMAP`. */
+export declare const PREPASS_CLASS_INDEXED_COLOUR_MAP = 5;
+/** `IFCMATERIALDEFINITIONREPRESENTATION`. */
+export declare const PREPASS_CLASS_MATERIAL_DEF_REPR = 6;
+/** `IFCRELASSOCIATESMATERIAL`. */
+export declare const PREPASS_CLASS_REL_ASSOCIATES_MATERIAL = 7;
+/** `IFCRELVOIDSELEMENT`. */
+export declare const PREPASS_CLASS_REL_VOIDS = 8;
+/** `IFCRELFILLSELEMENT`. */
+export declare const PREPASS_CLASS_REL_FILLS = 9;
+/** `IFCRELAGGREGATES`. */
+export declare const PREPASS_CLASS_REL_AGGREGATES = 10;
+/**
+ * Build one `(id, start, length)` span list per host-consumed prepass class
+ * from the stitched shard columns, in FILE ORDER. Every comparison goes
+ * through {@link PREPASS_CLASS_CODE_MASK}, so a record that carries a flag bit
+ * alongside its named code still lands in its list instead of being dropped.
+ * Returns exact-size arrays (one entry per class in `HOST_SPAN_CLASSES`,
+ * empty when the file has none).
+ */
+export declare function extractPrepassSpanLists(classes: Uint8Array, ids: Uint32Array, starts: Uint32Array, lengths: Uint32Array): Map<number, Uint32Array>;
 /**
  * Plan content-affinity routing for one chunk: assign each job (by index) to a
  * worker bucket so that every job sharing an affinity key lands on the SAME

package/dist/geometry-parallel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"geometry-parallel.d.ts","sourceRoot":"","sources":["../src/geometry-parallel.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,EAAY,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAGzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAO3D;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,WAAW,EACrB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAChC,WAAW,EAAE,MAAM,GAClB;IAAE,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAc7C;AA6ID,MAAM,WAAW,sBAAsB;IACrC;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,CACd,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,WAAW,KACjB,IAAI,CAAC;IACV;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;;;;OAMG;IACH,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACjD;;;;;OAKG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,EAAE;QACT,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACzC;;;;;;;OAOG;IACH,gBAAgB,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC5E;;;;;;;OAOG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,wBAAuB,eAAe,CACpC,MAAM,EAAE,UAAU,EAClB,WAAW,EAAE,iBAAiB,EAC9B,eAAe,CAAC,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE;AACrD,gFAAgF;AAChF,WAAW,CAAC,EAAE,iBAAiB,EAC/B,OAAO,CAAC,EAAE,sBAAsB,GAC/B,cAAc,CAAC,sBAAsB,CAAC,CAivCxC"}
+{"version":3,"file":"geometry-parallel.d.ts","sourceRoot":"","sources":["../src/geometry-parallel.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,EAAY,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAGzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAO3D;;;;;;;;;GASG;AACH,eAAO,MAAM,uBAAuB,KAAO,CAAC;AAC5C,uBAAuB;AACvB,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAC3C,6BAA6B;AAC7B,eAAO,MAAM,gCAAgC,IAAI,CAAC;AAClD,6CAA6C;AAC7C,eAAO,MAAM,+BAA+B,IAAI,CAAC;AACjD,kCAAkC;AAClC,eAAO,MAAM,qCAAqC,IAAI,CAAC;AACvD,4BAA4B;AAC5B,eAAO,MAAM,uBAAuB,IAAI,CAAC;AACzC,4BAA4B;AAC5B,eAAO,MAAM,uBAAuB,IAAI,CAAC;AACzC,0BAA0B;AAC1B,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAa/C;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,UAAU,EACnB,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,WAAW,GACnB,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAmB1B;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,WAAW,EACrB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAChC,WAAW,EAAE,MAAM,GAClB;IAAE,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAc7C;AAiKD,MAAM,WAAW,sBAAsB;IACrC;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,CACd,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,WAAW,KACjB,IAAI,CAAC;IACV;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;;;;OAMG;IACH,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACjD;;;;;OAKG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,EAAE;QACT,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACzC;;;;;;;OAOG;IACH,gBAAgB,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC5E;;;;;;;OAOG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,wBAAuB,eAAe,CACpC,MAAM,EAAE,UAAU,EAClB,WAAW,EAAE,iBAAiB,EAC9B,eAAe,CAAC,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE;AACrD,gFAAgF;AAChF,WAAW,CAAC,EAAE,iBAAiB,EAC/B,OAAO,CAAC,EAAE,sBAAsB,GAC/B,cAAc,CAAC,sBAAsB,CAAC,CAkwCxC"}

package/dist/geometry-parallel.js

@@ -8,6 +8,73 @@ import { notifyIfWasmAssetUnavailable, notifyIfWorkerScriptUnavailable } from '.
 // `IfcLiteBridge.init()` path can reuse whatever this pool already compiled
 // (and vice versa) instead of fetching the same binary a second time.
 import { compileSharedWasmModule } from './wasm-shared-module.js';
+/**
+ * Prepass class-byte layout, mirroring the `PREPASS_CLASS_*` definitions in
+ * `rust/processing/src/shard_classes.rs` (the source of truth — these are
+ * pinned to it by `prepass-class-spans.test.ts`).
+ *
+ * The producer packs a named code in the LOW bits and composes FLAG bits on
+ * top (`PREPASS_CLASS_FLAG_GEOMETRY_JOB` 0x80, `..._FLAG_TYPE_CANDIDATE`
+ * 0x40), so a consumer must mask before comparing — the Rust consumer does
+ * (`gpu_meshes/prepass_discovery.rs`), and so does {@link extractPrepassSpanLists}.
+ */
+export const PREPASS_CLASS_CODE_MASK = 0x3f;
+/** `IFCSTYLEDITEM`. */
+export const PREPASS_CLASS_STYLED_ITEM = 4;
+/** `IFCINDEXEDCOLOURMAP`. */
+export const PREPASS_CLASS_INDEXED_COLOUR_MAP = 5;
+/** `IFCMATERIALDEFINITIONREPRESENTATION`. */
+export const PREPASS_CLASS_MATERIAL_DEF_REPR = 6;
+/** `IFCRELASSOCIATESMATERIAL`. */
+export const PREPASS_CLASS_REL_ASSOCIATES_MATERIAL = 7;
+/** `IFCRELVOIDSELEMENT`. */
+export const PREPASS_CLASS_REL_VOIDS = 8;
+/** `IFCRELFILLSELEMENT`. */
+export const PREPASS_CLASS_REL_FILLS = 9;
+/** `IFCRELAGGREGATES`. */
+export const PREPASS_CLASS_REL_AGGREGATES = 10;
+/** The classes the host builds span lists for (every other code is ignored). */
+const HOST_SPAN_CLASSES = [
+    PREPASS_CLASS_STYLED_ITEM,
+    PREPASS_CLASS_INDEXED_COLOUR_MAP,
+    PREPASS_CLASS_MATERIAL_DEF_REPR,
+    PREPASS_CLASS_REL_ASSOCIATES_MATERIAL,
+    PREPASS_CLASS_REL_VOIDS,
+    PREPASS_CLASS_REL_FILLS,
+    PREPASS_CLASS_REL_AGGREGATES,
+];
+/**
+ * Build one `(id, start, length)` span list per host-consumed prepass class
+ * from the stitched shard columns, in FILE ORDER. Every comparison goes
+ * through {@link PREPASS_CLASS_CODE_MASK}, so a record that carries a flag bit
+ * alongside its named code still lands in its list instead of being dropped.
+ * Returns exact-size arrays (one entry per class in `HOST_SPAN_CLASSES`,
+ * empty when the file has none).
+ */
+export function extractPrepassSpanLists(classes, ids, starts, lengths) {
+    // Sized by the code mask rather than by the highest class the host consumes:
+    // a masked code is always < 64, so a class added on the Rust side cannot
+    // write out of bounds here (typed arrays discard such writes silently).
+    const counts = new Uint32Array(PREPASS_CLASS_CODE_MASK + 1);
+    for (let i = 0; i < classes.length; i++)
+        counts[classes[i] & PREPASS_CLASS_CODE_MASK]++;
+    const slots = new Map();
+    for (const k of HOST_SPAN_CLASSES)
+        slots.set(k, { arr: new Uint32Array(counts[k] * 3), w: 0 });
+    for (let i = 0; i < classes.length; i++) {
+        const slot = slots.get(classes[i] & PREPASS_CLASS_CODE_MASK);
+        if (!slot)
+            continue;
+        slot.arr[slot.w] = ids[i];
+        slot.arr[slot.w + 1] = starts[i];
+        slot.arr[slot.w + 2] = lengths[i];
+        slot.w += 3;
+    }
+    const spans = new Map();
+    for (const [k, slot] of slots)
+        spans.set(k, slot.arr);
+    return spans;
+}
 /**
  * Plan content-affinity routing for one chunk: assign each job (by index) to a
  * worker bucket so that every job sharing an affinity key lands on the SAME
@@ -70,6 +137,26 @@ function readShardScanFlag() {
         return false;
     return true;
 }
+/**
+ * Terminate a pool worker on a teardown path that is already unwinding.
+ *
+ * `Worker.terminate()` is specified never to throw, and is a no-op on a worker
+ * that is already gone — so every one of these teardown calls is expected to
+ * succeed and a throw means something unexpected about the host, not a
+ * double-terminate. Worth one line; never worth failing a teardown that runs
+ * while a real error is on its way to the caller.
+ *
+ * Bounded by construction: each caller terminates the pool once and then
+ * throws, returns, or leaves the generator.
+ */
+function terminateWorkerQuietly(worker, label) {
+    try {
+        worker.terminate();
+    }
+    catch (err) {
+        console.warn(`[stream] ${label} terminate failed:`, err);
+    }
+}
 /**
  * SPIKE: stitch N speculative shard scans into the full entity index —
  * byte-identical to the single-threaded scan. Port of the native
@@ -354,6 +441,13 @@ existingSab, options) {
                 // (no flat mesh carries them). Forward straight through to the consumer.
                 const instancedGeometryHashIds = msg.instancedGeometryHashIds;
                 const instancedGeometryHashValues = msg.instancedGeometryHashValues;
+                // #1891: the world boxes for those same ids, six values per id. Travels
+                // with the ids, never on its own — an aabb array without its id array
+                // indexes nothing.
+                const instancedGeometryAabbValues = msg.instancedGeometryAabbValues;
+                // #1993: and their proved volumes, one per id. Same rule as the boxes —
+                // it travels with the ids or not at all.
+                const instancedGeometryVolumeValues = msg.instancedGeometryVolumeValues;
                 if (meshes.length > 0 ||
                     (instancedShards && instancedShards.length > 0) ||
                     (instancedGeometryHashIds && instancedGeometryHashIds.length > 0)) {
@@ -376,7 +470,12 @@ existingSab, options) {
                         coordinateInfo: coordinateInfo || undefined,
                         ...(instancedShards && instancedShards.length > 0 ? { instancedShards } : {}),
                         ...(instancedGeometryHashIds && instancedGeometryHashIds.length > 0
-                            ? { instancedGeometryHashIds, instancedGeometryHashValues }
+                            ? {
+                                instancedGeometryHashIds,
+                                instancedGeometryHashValues,
+                                ...(instancedGeometryAabbValues ? { instancedGeometryAabbValues } : {}),
+                                ...(instancedGeometryVolumeValues ? { instancedGeometryVolumeValues } : {}),
+                            }
                             : {}),
                     });
                     wake();
@@ -519,7 +618,23 @@ existingSab, options) {
             try {
                 w.postMessage({ type: 'stream-end' });
             }
-            catch { /* worker terminated already — safe to ignore */ }
+            catch (err) {
+                // A structured-clonable payload posted to a terminated worker is a
+                // no-op, not a throw — so this means the port is in a state we did
+                // not expect. That worker will never flush its tail: `complete` is
+                // posted ONLY from `emitSessionEnd` in geometry.worker.js, which
+                // fires ONLY in response to `stream-end`. The drain loop below waits
+                // for a `complete` from every worker (`workersCompleted >=
+                // workers.length`), so leaving this as a log would make the load
+                // hang forever instead of failing loudly — the same "swallowed
+                // failure" shape as the fixes already on this branch, just a stall
+                // instead of a false success. Surface it as a load error and
+                // terminate the unreachable worker so it isn't left dangling.
+                console.warn('[stream] stream-end postMessage failed; failing the load instead of hanging on that worker:', err);
+                workerError = workerError ?? new Error(`Geometry worker failed: stream-end could not be delivered (${err instanceof Error ? err.message : String(err)})`);
+                terminateWorkerQuietly(w, 'process worker');
+                wake();
+            }
         }
     };
     const sendStreamStartIfReady = () => {
@@ -777,35 +892,17 @@ existingSab, options) {
         // stitched columns, split into one contiguous slice per worker, and
         // resolve them in parallel while everyone waits on the pre-pass scan.
         const classes = stitched.classes;
-        // Class codes (see Rust PREPASS_CLASS_*): 4 styled, 5 colour map,
-        // 6 material def repr, 7 rel-associates-material, 8 voids, 9 fills,
-        // 10 aggregates. Extract each list in FILE ORDER.
-        const counts = new Uint32Array(11);
-        for (let i = 0; i < classes.length; i++)
-            counts[classes[i]]++;
-        const kinds = [4, 5, 6, 7, 8, 9, 10];
-        const spanLists = new Map();
-        for (const k of kinds)
-            spanLists.set(k, { arr: new Uint32Array(counts[k] * 3), w: 0 });
-        for (let i = 0; i < classes.length; i++) {
-            const slot = spanLists.get(classes[i]);
-            if (!slot)
-                continue;
-            slot.arr[slot.w] = ids[i];
-            slot.arr[slot.w + 1] = starts[i];
-            slot.arr[slot.w + 2] = lengths[i];
-            slot.w += 3;
-        }
+        const spanLists = extractPrepassSpanLists(classes, ids, starts, lengths);
         supportSpans = {
-            colourMapSpans: spanLists.get(5).arr,
-            materialDefSpans: spanLists.get(6).arr,
-            relMaterialSpans: spanLists.get(7).arr,
-            voidSpans: spanLists.get(8).arr,
-            fillsSpans: spanLists.get(9).arr,
-            aggregateSpans: spanLists.get(10).arr,
+            colourMapSpans: spanLists.get(PREPASS_CLASS_INDEXED_COLOUR_MAP),
+            materialDefSpans: spanLists.get(PREPASS_CLASS_MATERIAL_DEF_REPR),
+            relMaterialSpans: spanLists.get(PREPASS_CLASS_REL_ASSOCIATES_MATERIAL),
+            voidSpans: spanLists.get(PREPASS_CLASS_REL_VOIDS),
+            fillsSpans: spanLists.get(PREPASS_CLASS_REL_FILLS),
+            aggregateSpans: spanLists.get(PREPASS_CLASS_REL_AGGREGATES),
         };
-        const styledCount = counts[4];
-        const styledSpans = spanLists.get(4).arr;
+        const styledSpans = spanLists.get(PREPASS_CLASS_STYLED_ITEM);
+        const styledCount = styledSpans.length / 3;
         // 2 slices per worker (round-robin): the tail is set by the SLOWEST
         // worker, and macOS occasionally schedules one onto a slow core — halving
         // the slice size halves the damage a slow core can do to the tail.
@@ -1276,23 +1373,14 @@ existingSab, options) {
             }
             if (workerError) {
                 for (const w of workers) {
-                    try {
-                        w.terminate();
-                    }
-                    catch { /* cleanup — safe to ignore */ }
-                }
-                try {
-                    prepassWorker.terminate();
+                    terminateWorkerQuietly(w, 'process worker');
                 }
-                catch { /* cleanup — safe to ignore */ }
+                terminateWorkerQuietly(prepassWorker, 'pre-pass worker');
                 throw workerError;
             }
             if (prepassError) {
                 for (const w of workers) {
-                    try {
-                        w.terminate();
-                    }
-                    catch { /* cleanup — safe to ignore */ }
+                    terminateWorkerQuietly(w, 'process worker');
                 }
                 throw prepassError;
             }
@@ -1303,10 +1391,7 @@ existingSab, options) {
             // explicit terminate to exit.
             if (prepassDone && !streamStartSentToWorkers && prepassJobsTotal === 0) {
                 for (const w of workers) {
-                    try {
-                        w.terminate();
-                    }
-                    catch { /* cleanup — safe to ignore */ }
+                    terminateWorkerQuietly(w, 'process worker');
                 }
                 const coordinateInfo = coordinator.getFinalCoordinateInfo();
                 yield { type: 'complete', totalMeshes: 0, coordinateInfo };
@@ -1341,15 +1426,9 @@ existingSab, options) {
     }
     finally {
         for (const w of workers) {
-            try {
-                w.terminate();
-            }
-            catch { /* cleanup — safe to ignore */ }
-        }
-        try {
-            prepassWorker.terminate();
+            terminateWorkerQuietly(w, 'process worker');
         }
-        catch { /* cleanup — safe to ignore */ }
+        terminateWorkerQuietly(prepassWorker, 'pre-pass worker');
     }
 }
 //# sourceMappingURL=geometry-parallel.js.map