@ifc-lite/geometry 3.5.0 → 3.7.1

package/dist/diagnostics.d.ts

@@ -83,4 +83,24 @@ export interface GeometryDiagnostics {
  * count, and is capped. `null` operands pass through so callers can fold a stream.
  */
 export declare function mergeGeometryDiagnostics(a: GeometryDiagnostics | null | undefined, b: GeometryDiagnostics | null | undefined): GeometryDiagnostics | null;
+/** Payload shape of the geometry worker's streaming `complete` message. */
+export interface GeometryWorkerCompleteMessage {
+    type: 'complete';
+    totalMeshes: number;
+    /** CSG / opening diagnostics merged over this worker's batches (the
+     *  GeometryDiagnostics contract). Omitted when none were recorded. */
+    diagnostics?: GeometryDiagnostics;
+}
+/**
+ * Build the streaming `complete` event payload (`geometry.worker.ts`'s
+ * `emitSessionEnd`, the only caller). Extracted so it can be exercised
+ * directly by tests without importing the worker module itself, which
+ * assigns `self.onmessage` at module load time and therefore cannot be
+ * imported outside a Worker/browser-like global (see diagnostics.test.ts).
+ *
+ * `diagnostics` is omitted from the returned object entirely (not sent as
+ * `undefined`) when `null` — callers gate on presence
+ * (`if (event.diagnostics)`), not just truthy counts.
+ */
+export declare function buildGeometryWorkerCompleteMessage(totalMeshes: number, diagnostics: GeometryDiagnostics | null): GeometryWorkerCompleteMessage;
 //# sourceMappingURL=diagnostics.d.ts.map

package/dist/diagnostics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB,qFAAqF;IACrF,gBAAgB,EAAE,MAAM,CAAC;IACzB,8EAA8E;IAC9E,oBAAoB,EAAE,MAAM,CAAC;IAC7B,oEAAoE;IACpE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,yCAAyC;IACzC,cAAc,EAAE;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,cAAc,EAAE,MAAM,CAAC;QACvB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,mEAAmE;IACnE,gBAAgB,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3D;;;;;;OAMG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,QAAQ,EAAE;QACR,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,eAAe,EAAE,MAAM,CAAC;QACxB,eAAe,EAAE,MAAM,CAAC;QACxB,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;QACtB,eAAe,EAAE,MAAM,CAAC;QACxB,iFAAiF;QACjF,oBAAoB,CAAC,EAAE,MAAM,CAAC;KAC/B,CAAC;IACF,qEAAqE;IACrE,UAAU,EAAE,KAAK,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B;6EACqE;QACrE,IAAI,CAAC,EAAE;YAAE,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;YAAC,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;SAAE,CAAC;QACxE;6DACqD;QACrD,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC,CAAC;CACJ;AAKD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,CAAC,EAAE,mBAAmB,GAAG,IAAI,GAAG,SAAS,EACzC,CAAC,EAAE,mBAAmB,GAAG,IAAI,GAAG,SAAS,GACxC,mBAAmB,GAAG,IAAI,CA8D5B"}
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB,qFAAqF;IACrF,gBAAgB,EAAE,MAAM,CAAC;IACzB,8EAA8E;IAC9E,oBAAoB,EAAE,MAAM,CAAC;IAC7B,oEAAoE;IACpE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,yCAAyC;IACzC,cAAc,EAAE;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,cAAc,EAAE,MAAM,CAAC;QACvB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,mEAAmE;IACnE,gBAAgB,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3D;;;;;;OAMG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,QAAQ,EAAE;QACR,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,eAAe,EAAE,MAAM,CAAC;QACxB,eAAe,EAAE,MAAM,CAAC;QACxB,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;QACtB,eAAe,EAAE,MAAM,CAAC;QACxB,iFAAiF;QACjF,oBAAoB,CAAC,EAAE,MAAM,CAAC;KAC/B,CAAC;IACF,qEAAqE;IACrE,UAAU,EAAE,KAAK,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B;6EACqE;QACrE,IAAI,CAAC,EAAE;YAAE,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;YAAC,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;SAAE,CAAC;QACxE;6DACqD;QACrD,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC,CAAC;CACJ;AAKD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,CAAC,EAAE,mBAAmB,GAAG,IAAI,GAAG,SAAS,EACzC,CAAC,EAAE,mBAAmB,GAAG,IAAI,GAAG,SAAS,GACxC,mBAAmB,GAAG,IAAI,CA8D5B;AAED,2EAA2E;AAC3E,MAAM,WAAW,6BAA6B;IAC5C,IAAI,EAAE,UAAU,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB;0EACsE;IACtE,WAAW,CAAC,EAAE,mBAAmB,CAAC;CACnC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kCAAkC,CAChD,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,mBAAmB,GAAG,IAAI,GACtC,6BAA6B,CAM/B"}

package/dist/diagnostics.js

@@ -73,4 +73,22 @@ export function mergeGeometryDiagnostics(a, b) {
         worstHosts,
     };
 }
+/**
+ * Build the streaming `complete` event payload (`geometry.worker.ts`'s
+ * `emitSessionEnd`, the only caller). Extracted so it can be exercised
+ * directly by tests without importing the worker module itself, which
+ * assigns `self.onmessage` at module load time and therefore cannot be
+ * imported outside a Worker/browser-like global (see diagnostics.test.ts).
+ *
+ * `diagnostics` is omitted from the returned object entirely (not sent as
+ * `undefined`) when `null` — callers gate on presence
+ * (`if (event.diagnostics)`), not just truthy counts.
+ */
+export function buildGeometryWorkerCompleteMessage(totalMeshes, diagnostics) {
+    return {
+        type: 'complete',
+        totalMeshes,
+        ...(diagnostics ? { diagnostics } : {}),
+    };
+}
 //# sourceMappingURL=diagnostics.js.map

package/dist/diagnostics.js.map

@@ -1 +1 @@
-{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AA2E/D,sFAAsF;AACtF,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAE7B;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CACtC,CAAyC,EACzC,CAAyC;IAEzC,IAAI,CAAC,CAAC;QAAE,OAAO,CAAC,IAAI,IAAI,CAAC;IACzB,IAAI,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC;IAEjB,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,aAAa,IAAI,CAAC,EAAE,CAAC,CAAC,aAAa,IAAI,CAAC,CAAC,CAAC;IAE3E,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC1C,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,gBAAgB;QAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAClG,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,gBAAgB;QAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAClG,MAAM,gBAAgB,GAAG,CAAC,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;SAC5C,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;SAC7C,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IAEzE,2EAA2E;IAC3E,+EAA+E;IAC/E,+EAA+E;IAC/E,WAAW;IACX,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAqD,CAAC;IAC9E,KAAK,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACvC,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,CAAC,WAAW,IAAI,CAAC,CAAC,WAAW,CAAC;YAClC,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC,QAAQ,CAAC;YAC5B,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,iBAAiB,IAAI,CAAC,CAAC,iBAAiB,CAAC;YACvE,mEAAmE;YACnE,sEAAsE;YACtE,mDAAmD;YACnD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC;YAChC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,IAAI,CAAC,CAAC,aAAa,CAAC;QAC7D,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IACD,MAAM,UAAU,GAAG,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC;SACtC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC;SAC1E,KAAK,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAC;IAE/B,OAAO;QACL,aAAa;QACb,gBAAgB,EAAE,CAAC,CAAC,gBAAgB,GAAG,CAAC,CAAC,gBAAgB;QACzD,oBAAoB,EAAE,CAAC,CAAC,oBAAoB,GAAG,CAAC,CAAC,oBAAoB;QACrE,iBAAiB,EAAE,CAAC,CAAC,iBAAiB,GAAG,CAAC,CAAC,iBAAiB;QAC5D,cAAc,EAAE;YACd,WAAW,EAAE,CAAC,CAAC,cAAc,CAAC,WAAW,GAAG,CAAC,CAAC,cAAc,CAAC,WAAW;YACxE,QAAQ,EAAE,CAAC,CAAC,cAAc,CAAC,QAAQ,GAAG,CAAC,CAAC,cAAc,CAAC,QAAQ;YAC/D,cAAc,EAAE,CAAC,CAAC,cAAc,CAAC,cAAc,GAAG,CAAC,CAAC,cAAc,CAAC,cAAc;YACjF,KAAK,EAAE,CAAC,CAAC,cAAc,CAAC,KAAK,GAAG,CAAC,CAAC,cAAc,CAAC,KAAK;SACvD;QACD,gBAAgB;QAChB,WAAW,EAAE,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW;QAC1C,QAAQ,EAAE;YACR,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,GAAG,CAAC,CAAC,QAAQ,CAAC,KAAK;YAC1C,WAAW,EAAE,CAAC,CAAC,QAAQ,CAAC,WAAW,GAAG,CAAC,CAAC,QAAQ,CAAC,WAAW;YAC5D,eAAe,EAAE,CAAC,CAAC,QAAQ,CAAC,eAAe,GAAG,CAAC,CAAC,QAAQ,CAAC,eAAe;YACxE,eAAe,EAAE,CAAC,CAAC,QAAQ,CAAC,eAAe,GAAG,CAAC,CAAC,QAAQ,CAAC,eAAe;YACxE,YAAY,EAAE,CAAC,CAAC,QAAQ,CAAC,YAAY,GAAG,CAAC,CAAC,QAAQ,CAAC,YAAY;YAC/D,aAAa,EAAE,CAAC,CAAC,QAAQ,CAAC,aAAa,GAAG,CAAC,CAAC,QAAQ,CAAC,aAAa;YAClE,eAAe,EAAE,CAAC,CAAC,QAAQ,CAAC,eAAe,GAAG,CAAC,CAAC,QAAQ,CAAC,eAAe;YACxE,oBAAoB,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,oBAAoB,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,oBAAoB,IAAI,CAAC,CAAC;SACtG;QACD,UAAU;KACX,CAAC;AACJ,CAAC;AAWD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,kCAAkC,CAChD,WAAmB,EACnB,WAAuC;IAEvC,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,WAAW;QACX,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACxC,CAAC;AACJ,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"geometry-coordinate.d.ts","sourceRoot":"","sources":["../src/geometry-coordinate.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAIrD;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,UAAU,EAClB,WAAW,EAAE,MAAM,GAAG,kBAAkB,GACvC,MAAM,CAeR;AAID;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,OAAO,gBAAgB,EAAE,cAAc,GAClD,QAAQ,EAAE,CAwGZ;AAmCD;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,cAAc,EAAE,cAAc,EAC9B,gBAAgB,CAAC,EAAE,MAAM,GACxB,cAAc,CAIhB"}
+{"version":3,"file":"geometry-coordinate.d.ts","sourceRoot":"","sources":["../src/geometry-coordinate.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAQrD;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,UAAU,EAClB,WAAW,EAAE,MAAM,GAAG,kBAAkB,GACvC,MAAM,CAeR;AAID;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,OAAO,gBAAgB,EAAE,cAAc,GAClD,QAAQ,EAAE,CAiHZ;AAID;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,cAAc,EAAE,cAAc,EAC9B,gBAAgB,CAAC,EAAE,MAAM,GACxB,cAAc,CAIhB"}

package/dist/geometry-coordinate.js

@@ -1,6 +1,7 @@
 /* This Source Code Form is subject to the terms of the Mozilla Public
  * License, v. 2.0. If a copy of the MPL was not distributed with this
  * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+import { extractGeometryFingerprints, } from './geometry-fingerprints.js';
 // ── Batch-size heuristics ──
 /**
  * Return a fixed or heuristic batch size for streaming, given the file
@@ -28,11 +29,12 @@ export function getStreamingBatchSize(buffer, batchConfig) {
 export function convertMeshCollectionToBatch(collection) {
     const batch = [];
     try {
-        // Per-entity geometry hashes — only populated when hashing was enabled via
-        // `IfcAPI.setComputeGeometryHashes` (issue #924); otherwise the parallel
-        // arrays are empty and this Map stays empty (zero overhead). Read inside the
-        // try so `collection.free()` in the finally still runs if extraction throws.
-        const geometryHashes = extractGeometryHashes(collection);
+        // Per-entity geometry hashes + world boxes — only populated when hashing
+        // was enabled via `IfcAPI.setComputeGeometryHashes` (issues #924 / #1891);
+        // otherwise the parallel arrays are empty and this Map stays empty (zero
+        // overhead). Read inside the try so `collection.free()` in the finally
+        // still runs if extraction throws.
+        const geometryFingerprints = extractGeometryFingerprints(collection);
         for (let i = 0; i < collection.length; i++) {
             const mesh = collection.get(i);
             if (!mesh)
@@ -48,7 +50,7 @@ export function convertMeshCollectionToBatch(collection) {
                 // Read each WASM copy-to-JS getter once; indexing the getter
                 // directly would copy a fresh Float32Array out of WASM per access.
                 const color = mesh.color;
-                const geometryHash = geometryHashes.get(mesh.expressId);
+                const fingerprint = geometryFingerprints.get(mesh.expressId);
                 // Per-element local-frame origin (world = origin + position); [0,0,0] or
                 // absent getter (older bundle) → absolute positions.
                 const originArr = mesh.origin;
@@ -107,10 +109,17 @@ export function convertMeshCollectionToBatch(collection) {
                         repeatT: mesh.textureRepeatT,
                     };
                 }
-                // #924: attach the per-entity geometry fingerprint (empty Map → no-op
-                // unless geometry hashing was enabled).
-                if (geometryHash !== undefined)
-                    meshData.geometryHash = geometryHash;
+                // #924 / #1891: attach the per-entity geometry fingerprint — hash and,
+                // when the pass produced them, the absolute world box and the proved
+                // enclosed volume (empty Map → no-op unless geometry hashing was
+                // enabled).
+                if (fingerprint) {
+                    meshData.geometryHash = fingerprint.hash;
+                    if (fingerprint.aabb)
+                        meshData.geometryAabb = fingerprint.aabb;
+                    if (fingerprint.volume !== undefined)
+                        meshData.geometryVolume = fingerprint.volume;
+                }
                 batch.push(meshData);
             }
             finally {
@@ -123,30 +132,6 @@ export function convertMeshCollectionToBatch(collection) {
     }
     return batch;
 }
-/**
- * Read the per-entity geometry fingerprints off a WASM MeshCollection into a
- * `Map<expressId, bigint>`. The collection exposes two parallel arrays
- * (`geometryHashIds` ↔ `geometryHashValues`); both are empty unless hashing
- * was enabled via `IfcAPI.setComputeGeometryHashes`. Must be called before
- * `collection.free()`. Tolerates an older WASM build lacking the getters
- * (returns an empty Map) so the geometry path never breaks.
- */
-function extractGeometryHashes(collection) {
-    const map = new Map();
-    const c = collection;
-    const count = c.geometryHashCount ?? 0;
-    if (count === 0)
-        return map;
-    const ids = c.geometryHashIds;
-    const values = c.geometryHashValues;
-    if (!ids || !values)
-        return map;
-    const n = Math.min(ids.length, values.length);
-    for (let i = 0; i < n; i++) {
-        map.set(ids[i], values[i]);
-    }
-    return map;
-}
 // ── Coordinate-info helpers ──
 /**
  * Merge an optional building rotation value into a CoordinateInfo object.

package/dist/geometry-coordinate.js.map

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

package/dist/geometry-fingerprints.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Read the per-entity geometry fingerprints off a WASM `MeshCollection`
+ * (issues #924 / #1891).
+ *
+ * ONE reader for both mesh-extraction paths — the single-threaded converter in
+ * `geometry-coordinate.ts` and the worker's `collectMeshes` — because the
+ * arrays are index-parallel and a second copy of the indexing arithmetic is a
+ * second place for the box and the hash to drift onto different entities.
+ *
+ * The wasm contract (`rust/wasm-bindings/src/zero_copy/mesh_fingerprint.rs`):
+ * `geometryHashIds[i]` ↔ `geometryHashValues[i]` ↔
+ * `geometryAabbValues[6*i .. 6*i+6)` ↔ `geometryVolumeValues[i]`. Every array is
+ * empty unless hashing was enabled via `IfcAPI.setComputeGeometryHashes`, and a
+ * build predating a getter simply omits it — both degrade to "less
+ * information", never to a throw.
+ */
+import type { EntityWorldAabb } from './types.js';
+/**
+ * The fingerprint getters, structurally. Typed here rather than taken as a
+ * `MeshCollection` because the two call sites hold two different nominal types
+ * for the same wasm object, and because every field is optional on an older
+ * wasm build — which is precisely what this module is here to absorb.
+ */
+export interface GeometryFingerprintSource {
+    geometryHashCount?: number;
+    geometryHashIds?: Uint32Array;
+    geometryHashValues?: BigUint64Array;
+    geometryAabbValues?: Float64Array;
+    geometryVolumeValues?: Float64Array;
+}
+/** Everything one hashing pass learned about one entity. */
+export interface EntityGeometryFingerprint {
+    /** The RTC-invariant whole-entity shape hash (#924). */
+    hash: bigint;
+    /**
+     * Absolute world bounding box in the renderer's Y-up frame, or `undefined`
+     * when the pass produced none. The wasm side reserves six `NaN` slots for an
+     * absent box so the arrays stay index-parallel; that sentinel is resolved to
+     * `undefined` HERE, at the boundary, so nothing downstream ever has to ask
+     * whether a box it holds is real (`@ifc-lite/diff`'s contract is that a
+     * missing box is absent, not NaN-bearing).
+     */
+    aabb?: EntityWorldAabb;
+    /**
+     * Enclosed volume in CUBIC METRES, or `undefined` when the pass could not
+     * PROVE one (#1993). Same `NaN`-resolved-at-the-boundary treatment as
+     * {@link aabb}, and for the same reason: the diff engine's contract is that an
+     * absent volume is `undefined`, never a NaN-bearing number that would answer
+     * "different" to every comparison it entered.
+     *
+     * Absent for roughly a third of elements BY DESIGN. The kernel emits a volume
+     * only where the meshed geometry was provably a single closed, orientable,
+     * single-component solid, so an open `SurfaceModel`, a material-layered wall
+     * (open bands by construction) and any multi-item assembly correctly report
+     * nothing rather than a plausible wrong number. A missing volume therefore
+     * means "not proved", NEVER "proved to be zero" or "proved different".
+     */
+    volume?: number;
+}
+/**
+ * Read entry `index` of a six-values-per-id `Float64Array` as a box, or
+ * `undefined` when the span is the absent sentinel (or the array is too short
+ * to hold it).
+ *
+ * ONE guard covers both, deliberately: any non-finite component disqualifies
+ * the whole box, and an out-of-range typed-array read yields `undefined`, which
+ * is not finite. A separate length check would be unreachable — it can never be
+ * the reason a call returns `undefined`, so nothing could ever prove it works.
+ * Half a box is not a usable box anyway: `isUsableAabb` in `@ifc-lite/diff`
+ * would reject it, so better to never build it.
+ *
+ * Exported because the same layout crosses the geometry worker boundary as
+ * `instancedGeometryAabbValues` (the entities that never reach the flat mesh
+ * array), and a consumer decoding that by hand is a second copy of this
+ * indexing arithmetic.
+ */
+export declare function geometryAabbAt(values: Float64Array | undefined, index: number): EntityWorldAabb | undefined;
+/**
+ * Inverse of {@link geometryAabbAt}: write `aabb` into entry `index` of a
+ * six-values-per-id `Float64Array`.
+ *
+ * Paired with the reader here, in one module, because the worker encodes the
+ * instanced-only side-channel and the main thread decodes it: a min/max or
+ * stride disagreement between the two ends is invisible in either half alone
+ * and shows up only as boxes attributed to the wrong element.
+ */
+export declare function writeGeometryAabbAt(values: Float64Array, index: number, aabb: EntityWorldAabb): void;
+/**
+ * Read entry `index` of a one-value-per-id `Float64Array` as a volume, or
+ * `undefined` when the slot is the absent sentinel (or the array is too short).
+ *
+ * The `NaN`-to-`undefined` resolution lives HERE, at the boundary, and nowhere
+ * else — same contract as {@link geometryAabbAt}. `Number.isFinite` covers both
+ * the sentinel and an out-of-range read in one test.
+ *
+ * A non-positive volume is refused as well. The producer emits a value only for
+ * a proved-closed solid, so zero or negative is not a small solid, it is a
+ * degenerate or inside-out one, and a consumer that sums volumes cannot tell
+ * those apart from real numbers. Refusing here keeps "absent means not proved"
+ * true all the way down.
+ *
+ * Exported for the same reason as {@link geometryAabbAt}: the identical layout
+ * crosses the geometry worker boundary as `instancedGeometryVolumeValues`.
+ */
+export declare function geometryVolumeAt(values: Float64Array | undefined, index: number): number | undefined;
+/**
+ * Per-entity geometry fingerprints keyed by express id.
+ *
+ * Empty when hashing is off or the wasm build predates the getters. Must be
+ * called BEFORE `collection.free()`. The result holds plain JS values, so it
+ * outlives the collection and survives a structured-clone `postMessage`.
+ */
+export declare function extractGeometryFingerprints(source: GeometryFingerprintSource): Map<number, EntityGeometryFingerprint>;
+//# sourceMappingURL=geometry-fingerprints.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"geometry-fingerprints.d.ts","sourceRoot":"","sources":["../src/geometry-fingerprints.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAKlD;;;;;GAKG;AACH,MAAM,WAAW,yBAAyB;IACxC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,WAAW,CAAC;IAC9B,kBAAkB,CAAC,EAAE,cAAc,CAAC;IACpC,kBAAkB,CAAC,EAAE,YAAY,CAAC;IAClC,oBAAoB,CAAC,EAAE,YAAY,CAAC;CACrC;AAED,4DAA4D;AAC5D,MAAM,WAAW,yBAAyB;IACxC,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,YAAY,GAAG,SAAS,EAChC,KAAK,EAAE,MAAM,GACZ,eAAe,GAAG,SAAS,CAU7B;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,eAAe,GACpB,IAAI,CAIN;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,YAAY,GAAG,SAAS,EAChC,KAAK,EAAE,MAAM,GACZ,MAAM,GAAG,SAAS,CAIpB;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,yBAAyB,GAChC,GAAG,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAgCxC"}

package/dist/geometry-fingerprints.js

@@ -0,0 +1,114 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+/** Number of `f64` per box in `geometryAabbValues`: min xyz then max xyz. */
+const AABB_STRIDE = 6;
+/**
+ * Read entry `index` of a six-values-per-id `Float64Array` as a box, or
+ * `undefined` when the span is the absent sentinel (or the array is too short
+ * to hold it).
+ *
+ * ONE guard covers both, deliberately: any non-finite component disqualifies
+ * the whole box, and an out-of-range typed-array read yields `undefined`, which
+ * is not finite. A separate length check would be unreachable — it can never be
+ * the reason a call returns `undefined`, so nothing could ever prove it works.
+ * Half a box is not a usable box anyway: `isUsableAabb` in `@ifc-lite/diff`
+ * would reject it, so better to never build it.
+ *
+ * Exported because the same layout crosses the geometry worker boundary as
+ * `instancedGeometryAabbValues` (the entities that never reach the flat mesh
+ * array), and a consumer decoding that by hand is a second copy of this
+ * indexing arithmetic.
+ */
+export function geometryAabbAt(values, index) {
+    if (!values)
+        return undefined;
+    const base = index * AABB_STRIDE;
+    for (let k = 0; k < AABB_STRIDE; k++) {
+        if (!Number.isFinite(values[base + k]))
+            return undefined;
+    }
+    return {
+        min: [values[base], values[base + 1], values[base + 2]],
+        max: [values[base + 3], values[base + 4], values[base + 5]],
+    };
+}
+/**
+ * Inverse of {@link geometryAabbAt}: write `aabb` into entry `index` of a
+ * six-values-per-id `Float64Array`.
+ *
+ * Paired with the reader here, in one module, because the worker encodes the
+ * instanced-only side-channel and the main thread decodes it: a min/max or
+ * stride disagreement between the two ends is invisible in either half alone
+ * and shows up only as boxes attributed to the wrong element.
+ */
+export function writeGeometryAabbAt(values, index, aabb) {
+    const base = index * AABB_STRIDE;
+    values.set(aabb.min, base);
+    values.set(aabb.max, base + 3);
+}
+/**
+ * Read entry `index` of a one-value-per-id `Float64Array` as a volume, or
+ * `undefined` when the slot is the absent sentinel (or the array is too short).
+ *
+ * The `NaN`-to-`undefined` resolution lives HERE, at the boundary, and nowhere
+ * else — same contract as {@link geometryAabbAt}. `Number.isFinite` covers both
+ * the sentinel and an out-of-range read in one test.
+ *
+ * A non-positive volume is refused as well. The producer emits a value only for
+ * a proved-closed solid, so zero or negative is not a small solid, it is a
+ * degenerate or inside-out one, and a consumer that sums volumes cannot tell
+ * those apart from real numbers. Refusing here keeps "absent means not proved"
+ * true all the way down.
+ *
+ * Exported for the same reason as {@link geometryAabbAt}: the identical layout
+ * crosses the geometry worker boundary as `instancedGeometryVolumeValues`.
+ */
+export function geometryVolumeAt(values, index) {
+    if (!values)
+        return undefined;
+    const volume = values[index];
+    return Number.isFinite(volume) && volume > 0 ? volume : undefined;
+}
+/**
+ * Per-entity geometry fingerprints keyed by express id.
+ *
+ * Empty when hashing is off or the wasm build predates the getters. Must be
+ * called BEFORE `collection.free()`. The result holds plain JS values, so it
+ * outlives the collection and survives a structured-clone `postMessage`.
+ */
+export function extractGeometryFingerprints(source) {
+    const map = new Map();
+    // Fast path, not a correctness guard: the checks below already yield an empty
+    // map when hashing is off. It is here so a load with the diff feature OFF —
+    // the default — never touches the three copy-to-JS getters at all, and those
+    // are read once per batch, thousands of times per model.
+    if ((source.geometryHashCount ?? 0) === 0)
+        return map;
+    const ids = source.geometryHashIds;
+    const values = source.geometryHashValues;
+    if (!ids || !values)
+        return map;
+    // Read the copy-to-JS getter ONCE: each access copies a fresh Float64Array
+    // out of wasm, so indexing the getter per entity would copy the whole array
+    // once per entity. Absent on a wasm build predating #1988 → no boxes, hashes
+    // still land, and the diff falls back to its documented bare `moved`.
+    const aabbValues = source.geometryAabbValues;
+    // Same once-only rule, same reason (#1993). Absent on a wasm build predating
+    // the getter → no volumes, and the split/merge detector degrades to its
+    // extent-coverage tier rather than claiming anything it cannot prove.
+    const volumeValues = source.geometryVolumeValues;
+    const n = Math.min(ids.length, values.length);
+    for (let i = 0; i < n; i++) {
+        const fingerprint = { hash: values[i] };
+        const aabb = geometryAabbAt(aabbValues, i);
+        if (aabb)
+            fingerprint.aabb = aabb;
+        const volume = geometryVolumeAt(volumeValues, i);
+        if (volume !== undefined)
+            fingerprint.volume = volume;
+        map.set(ids[i], fingerprint);
+    }
+    return map;
+}
+//# sourceMappingURL=geometry-fingerprints.js.map

package/dist/geometry-fingerprints.js.map

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

package/dist/geometry-native.d.ts

@@ -32,8 +32,30 @@ export declare function enqueueNativeStreamingEvent(queuedEvents: QueuedNativeSt
     coalescedBatchCount: number;
 }): void;
 /**
- * Shared native streaming generator used by both buffer-based and
- * path-based native geometry streaming.
+ * The two behavioural axes on which the buffer-based native route
+ * (`GeometryProcessor.processStreaming`) differs from the path- and
+ * cache-based ones. Everything else about the drain loop — including the
+ * failure handling this module exists to get right — is shared.
+ */
+export interface NativeStreamOptions {
+    /**
+     * Apply native queue back-pressure: coalesce consecutive batch events once
+     * the queue is deep, and yield to the event loop mid-drain so the main
+     * thread keeps breathing. `processStreaming`'s native branch has always used
+     * a plain push-only queue with no mid-drain yield; pass `false` there.
+     */
+    coalesce?: boolean;
+    /**
+     * How streamed meshes are folded into the coordinate handler. Defaults to
+     * `processTrustedMeshesIncremental` (native output is already site-local, so
+     * the generic RTC/outlier scan is skipped). `processStreaming` has always
+     * used the generic `processMeshesIncremental`, so it passes that explicitly.
+     */
+    processMeshes?: (meshes: MeshData[]) => void;
+}
+/**
+ * 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.
@@ -41,11 +63,12 @@ export declare function enqueueNativeStreamingEvent(queuedEvents: QueuedNativeSt
  * @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 declare function streamNativeGeometry(startStream: (options: {
     onBatch: (batch: GeometryBatch) => void;
     onColorUpdate: (updates: Map<number, [number, number, number, number]>) => void;
     onComplete: (stats: PlatformGeometryStats) => void;
     onError: (error: Error) => void;
-}) => Promise<PlatformGeometryStats>, totalEstimate: number, coordinator: CoordinateHandler, setLastNativeStats: (stats: PlatformGeometryStats) => void): AsyncGenerator<StreamingGeometryEvent>;
+}) => Promise<PlatformGeometryStats>, totalEstimate: number, coordinator: CoordinateHandler, setLastNativeStats: (stats: PlatformGeometryStats) => void, options?: NativeStreamOptions): AsyncGenerator<StreamingGeometryEvent>;
 //# sourceMappingURL=geometry-native.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"geometry-native.d.ts","sourceRoot":"","sources":["../src/geometry-native.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,IAAI,qBAAqB,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACxH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAKzD,eAAO,MAAM,8BAA8B,IAAI,CAAC;AAChD,eAAO,MAAM,8BAA8B,QAAQ,CAAC;AACpD,eAAO,MAAM,iCAAiC,IAAI,CAAC;AACnD,eAAO,MAAM,iCAAiC,OAAO,CAAC;AACtD,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAI7C,MAAM,MAAM,0BAA0B,GAClC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,QAAQ,EAAE,CAAC;IAAC,eAAe,CAAC,EAAE,oBAAoB,CAAA;CAAE,GAC7E;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CAAE,CAAC;AAIpF,wBAAgB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAUhD;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,YAAY,EAAE,0BAA0B,EAAE,EAC1C,KAAK,EAAE,0BAA0B,EACjC,UAAU,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,mBAAmB,EAAE,MAAM,CAAA;CAAE,GAChE,IAAI,CA6BN;AAED;;;;;;;;;;GAUG;AACH,wBAAuB,oBAAoB,CACzC,WAAW,EAAE,CAAC,OAAO,EAAE;IACrB,OAAO,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IACxC,aAAa,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,KAAK,IAAI,CAAC;IAChF,UAAU,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,CAAC;IACnD,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACjC,KAAK,OAAO,CAAC,qBAAqB,CAAC,EACpC,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,iBAAiB,EAC9B,kBAAkB,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,GACzD,cAAc,CAAC,sBAAsB,CAAC,CAgIxC"}
+{"version":3,"file":"geometry-native.d.ts","sourceRoot":"","sources":["../src/geometry-native.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,IAAI,qBAAqB,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACxH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAKzD,eAAO,MAAM,8BAA8B,IAAI,CAAC;AAChD,eAAO,MAAM,8BAA8B,QAAQ,CAAC;AACpD,eAAO,MAAM,iCAAiC,IAAI,CAAC;AACnD,eAAO,MAAM,iCAAiC,OAAO,CAAC;AACtD,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAI7C,MAAM,MAAM,0BAA0B,GAClC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,QAAQ,EAAE,CAAC;IAAC,eAAe,CAAC,EAAE,oBAAoB,CAAA;CAAE,GAC7E;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CAAE,CAAC;AAIpF,wBAAgB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAUhD;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,YAAY,EAAE,0BAA0B,EAAE,EAC1C,KAAK,EAAE,0BAA0B,EACjC,UAAU,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,mBAAmB,EAAE,MAAM,CAAA;CAAE,GAChE,IAAI,CA6BN;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,IAAI,CAAC;CAC9C;AAED;;;;;;;;;;;GAWG;AACH,wBAAuB,oBAAoB,CACzC,WAAW,EAAE,CAAC,OAAO,EAAE;IACrB,OAAO,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IACxC,aAAa,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,KAAK,IAAI,CAAC;IAChF,UAAU,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,CAAC;IACnD,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACjC,KAAK,OAAO,CAAC,qBAAqB,CAAC,EACpC,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,iBAAiB,EAC9B,kBAAkB,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,EAC1D,OAAO,GAAE,mBAAwB,GAChC,cAAc,CAAC,sBAAsB,CAAC,CAsMxC"}