@ifc-lite/geometry 4.1.0 → 4.2.0

package/README.md

@@ -26,9 +26,11 @@ console.log(`${result.meshes.length} meshes, ${result.totalTriangles} triangles`
 ## Stream geometry (recommended for large models)
 
 ```typescript
+const buffer = new Uint8Array(await file.arrayBuffer());
+
 for await (const event of processor.processStreaming(buffer)) {
   if (event.type === 'batch') {
-    renderer.appendMeshes(event.meshes);
+    renderer.addMeshes(event.meshes, true);
     console.log(`Loaded ${event.totalSoFar} meshes so far`);
   } else if (event.type === 'complete') {
     console.log(`Done: ${event.totalMeshes} meshes`);
@@ -54,8 +56,7 @@ Unset / `'medium'` reproduces the engine's historical densities byte-for-byte. L
 ## Coordinate handling
 
 ```typescript
-import { CoordinateHandler } from '@ifc-lite/geometry';
-
+const buffer = new Uint8Array(await file.arrayBuffer());
 const result = await processor.process(buffer);
 
 // Models with large world coordinates (geo-referenced) get auto-shifted
@@ -92,6 +93,8 @@ If your bundler can't transform
 wasm URLs through the `processAdaptive` / `processParallel` `wasmUrls`
 option:
 
+<!-- Reason: Vite-only `?url` import specifier, unresolvable by tsc. -->
+<!-- docs-check: skip -->
 ```ts
 // Vite's `?url` suffix yields a fully-resolved URL string at build time.
 // `@ifc-lite/wasm` exposes the binary at the `./ifc-lite_bg.wasm` subpath

package/dist/diagnostics.d.ts

@@ -15,9 +15,19 @@
 export interface GeometryDiagnostics {
     /**
      * Contract version handshake (mirrors Rust
-     * `GEOMETRY_DIAGNOSTICS_SCHEMA_VERSION`, currently 1). Bumped on field
-     * renames/removals or count-semantics changes; additive optional fields do
-     * not bump. `0`/absent means a pre-versioned producer.
+     * `GEOMETRY_DIAGNOSTICS_SCHEMA_VERSION`, currently 3 — that constant carries
+     * the per-version changelog and is the single source of truth). Bumped on
+     * field renames, field removals, and count-semantics changes; also on an
+     * additive field whose absence a consumer must tell apart from a real zero,
+     * which is why 2 (removed `guardSaved`) and 3 (added
+     * `totalUnsupportedItems`) both bumped. A purely additive optional field
+     * that no consumer gates on does not bump.
+     *
+     * REQUIRED, not optional: the Rust field is a plain `u32` serialized
+     * unconditionally, so every producer since #1514 writes the key. A value of
+     * `0` is what Rust's `#[serde(default)]` yields when it READS a payload
+     * written before #1514, and is the only "pre-versioned producer" signal a
+     * consumer sees.
      */
     schemaVersion: number;
     /** Total CSG boolean failures (un-cut openings, emptied hosts, kernel fallbacks). */
@@ -58,6 +68,13 @@ export interface GeometryDiagnostics {
         /** Optional: absent on payloads produced before this counter existed (#1649). */
         deferTooManyOpenings?: number;
     };
+    /**
+     * Content-hash references the geometry pass refused because they exceeded
+     * `u32::MAX` (#3421 / #3752). Nonzero means some instancing was skipped, not
+     * that geometry is wrong. Optional: absent on payloads from producers
+     * predating the counter.
+     */
+    oversizedRefDrops?: number;
     /** Bounded top-N worst-failing hosts (opt-in per-product detail). */
     worstHosts: Array<{
         productId: number;
@@ -75,6 +92,28 @@ export interface GeometryDiagnostics {
          *  subtraction ran, otherwise the pre-cut count). */
         triangleCount?: number;
     }>;
+    /**
+     * Representation items dropped from the output: no processor is registered
+     * for the IFC type, or the registered processor errored (degenerate/failed
+     * geometry). Excludes elements with no Body representation at all — those
+     * are correctly absent from the 3D view and never counted here. Absent on
+     * a payload produced before this counter existed (schemaVersion < 3).
+     *
+     * A lower bound on instances: a drop inside a `RepresentationMap` source is
+     * counted once per walking router, not once per `IfcMappedItem` occurrence
+     * that reuses the cached source. That is once model-wide on the wasm batch
+     * path, which uses one router; the native pool builds a router per element,
+     * and a source whose items ALL drop is never published to the shared cache
+     * (it meshes to nothing), so there it contributes once per owning element.
+     * Read it as "these types were dropped", never as a count of affected
+     * elements or of distinct sources.
+     */
+    totalUnsupportedItems?: number;
+    /** `totalUnsupportedItems` broken down by IFC type, sorted desc by count. */
+    unsupportedItemsByType?: Array<{
+        reason: string;
+        count: number;
+    }>;
 }
 /**
  * Merge two GeometryDiagnostics (per-batch -> per-load, or per-worker ->

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;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"}
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;;;;;;;;;;;OAeG;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;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,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;IACH;;;;;;;;;;;;;;;OAeG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,6EAA6E;IAC7E,sBAAsB,CAAC,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnE;AA0BD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,CAAC,EAAE,mBAAmB,GAAG,IAAI,GAAG,SAAS,EACzC,CAAC,EAAE,mBAAmB,GAAG,IAAI,GAAG,SAAS,GACxC,mBAAmB,GAAG,IAAI,CAgF5B;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

@@ -3,6 +3,24 @@
  * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
 /** Cap on the merged worst-hosts detail list (matches the Rust WORST_HOSTS_LIMIT). */
 const WORST_HOSTS_LIMIT = 16;
+/**
+ * Sum two reason-keyed lists by key, count-desc then reason-asc. The tie-break
+ * is load-bearing, not cosmetic: without it equal counts come out in Map
+ * insertion order, so the same model could render a different string on two
+ * runs. Shared by `failuresByReason` and `unsupportedItemsByType` so the two
+ * cannot order themselves differently. Agrees with the Rust `summarize` for the
+ * ASCII `Ifc*` type names and reason labels that actually reach here; the two
+ * are not identical orderings in general, since Rust ties break on byte order
+ * and `localeCompare` does not.
+ */
+function mergeReasonCounts(a, b) {
+    const byKey = new Map();
+    for (const r of [...a, ...b])
+        byKey.set(r.reason, (byKey.get(r.reason) ?? 0) + r.count);
+    return [...byKey.entries()]
+        .map(([reason, count]) => ({ reason, count }))
+        .sort((x, y) => y.count - x.count || x.reason.localeCompare(y.reason));
+}
 /**
  * Merge two GeometryDiagnostics (per-batch -> per-load, or per-worker ->
  * per-model). Scalars sum; classification + rectFast sum field-wise;
@@ -15,14 +33,7 @@ export function mergeGeometryDiagnostics(a, b) {
     if (!b)
         return a;
     const schemaVersion = Math.max(a.schemaVersion ?? 0, b.schemaVersion ?? 0);
-    const reasons = new Map();
-    for (const r of a.failuresByReason)
-        reasons.set(r.reason, (reasons.get(r.reason) ?? 0) + r.count);
-    for (const r of b.failuresByReason)
-        reasons.set(r.reason, (reasons.get(r.reason) ?? 0) + r.count);
-    const failuresByReason = [...reasons.entries()]
-        .map(([reason, count]) => ({ reason, count }))
-        .sort((x, y) => y.count - x.count || x.reason.localeCompare(y.reason));
+    const failuresByReason = mergeReasonCounts(a.failuresByReason, b.failuresByReason);
     // Fold by productId first (a host whose geometry spans batches/workers can
     // appear in both operands' lists) before re-ranking and capping, mirroring the
     // failuresByReason merge-by-key above. Copy each entry so the operands are not
@@ -47,6 +58,22 @@ export function mergeGeometryDiagnostics(a, b) {
     const worstHosts = [...hostById.values()]
         .sort((x, y) => y.csgFailures - x.csgFailures || x.productId - y.productId)
         .slice(0, WORST_HOSTS_LIMIT);
+    // Whether EITHER operand actually carried the counter. Folding an absent field
+    // to 0 here would hand back `totalUnsupportedItems: 0` on a payload still
+    // labelled `schemaVersion: 2` — "we counted, and nothing was dropped" built out
+    // of "this producer never counted". That is the precise confusion the v3 bump
+    // exists to prevent, so absence has to survive the merge: the fields are
+    // omitted unless at least one side supplied one.
+    const countedUnsupported = a.totalUnsupportedItems !== undefined ||
+        b.totalUnsupportedItems !== undefined ||
+        a.unsupportedItemsByType !== undefined ||
+        b.unsupportedItemsByType !== undefined;
+    const unsupportedFields = countedUnsupported
+        ? {
+            totalUnsupportedItems: (a.totalUnsupportedItems ?? 0) + (b.totalUnsupportedItems ?? 0),
+            unsupportedItemsByType: mergeReasonCounts(a.unsupportedItemsByType ?? [], b.unsupportedItemsByType ?? []),
+        }
+        : {};
     return {
         schemaVersion,
         totalCsgFailures: a.totalCsgFailures + b.totalCsgFailures,
@@ -70,7 +97,9 @@ export function mergeGeometryDiagnostics(a, b) {
             deferNoOpenings: a.rectFast.deferNoOpenings + b.rectFast.deferNoOpenings,
             deferTooManyOpenings: (a.rectFast.deferTooManyOpenings ?? 0) + (b.rectFast.deferTooManyOpenings ?? 0),
         },
+        oversizedRefDrops: (a.oversizedRefDrops ?? 0) + (b.oversizedRefDrops ?? 0),
         worstHosts,
+        ...unsupportedFields,
     };
 }
 /**

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":"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"}

package/dist/energy-export-bridge.d.ts

@@ -0,0 +1,35 @@
+/**
+ * HBJSON / DFJSON `IfcAPI` call sites for `IfcLiteBridge`, split out to keep
+ * `ifc-lite-bridge.ts` under the module-size ratchet (`scripts/check-module-size.mjs`).
+ * Pure functions over an already-initialized `IfcAPI` handle — no bridge state, so
+ * `IfcLiteBridge` just forwards into these through its existing `runExport` error
+ * wrapper (init guard + structured error logging + fatal-wasm-error marking stay
+ * there, not duplicated here).
+ */
+import type { IfcAPI } from '@ifc-lite/wasm';
+import type { HbjsonStats } from './hbjson-stats.js';
+/**
+ * Export the `IfcSpace` volumes in `content` as a Honeybee HBJSON string
+ * (Ladybug Tools energy/daylight model). Rooms are built analytically from
+ * extruded-area profiles (watertight by construction).
+ */
+export declare function callExportHbjson(api: IfcAPI, content: Uint8Array, name: string): Uint8Array;
+/**
+ * Like {@link callExportHbjson}, but also returns the export's coverage stats
+ * (`HbjsonStats`: spaces seen, rooms emitted, spaces skipped as degenerate, plus
+ * apertures / doors / shades / constructions / interior adjacencies) so a caller
+ * can tell whether a "successful" export silently dropped `IfcSpace` volumes.
+ * Runs the export once — `content` and `stats` come from the same wasm call.
+ */
+export declare function callExportHbjsonWithStats(api: IfcAPI, content: Uint8Array, name: string): {
+    content: Uint8Array;
+    stats: HbjsonStats;
+};
+/**
+ * Export the `IfcSpace` volumes in `content` as a Dragonfly DFJSON string
+ * (Ladybug Tools energy model). Each space becomes an extruded `Room2D`
+ * (floor polygon + height) grouped into stories — the simpler target for
+ * mostly-vertical-wall models.
+ */
+export declare function callExportDfjson(api: IfcAPI, content: Uint8Array, name: string): string;
+//# sourceMappingURL=energy-export-bridge.d.ts.map

package/dist/energy-export-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"energy-export-bridge.d.ts","sourceRoot":"","sources":["../src/energy-export-bridge.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,CAE3F;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,UAAU,EACnB,IAAI,EAAE,MAAM,GACX;IAAE,OAAO,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,WAAW,CAAA;CAAE,CAE7C;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvF"}

package/dist/energy-export-bridge.js

@@ -0,0 +1,31 @@
+/* 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/. */
+/**
+ * Export the `IfcSpace` volumes in `content` as a Honeybee HBJSON string
+ * (Ladybug Tools energy/daylight model). Rooms are built analytically from
+ * extruded-area profiles (watertight by construction).
+ */
+export function callExportHbjson(api, content, name) {
+    return api.exportHbjson(content, name);
+}
+/**
+ * Like {@link callExportHbjson}, but also returns the export's coverage stats
+ * (`HbjsonStats`: spaces seen, rooms emitted, spaces skipped as degenerate, plus
+ * apertures / doors / shades / constructions / interior adjacencies) so a caller
+ * can tell whether a "successful" export silently dropped `IfcSpace` volumes.
+ * Runs the export once — `content` and `stats` come from the same wasm call.
+ */
+export function callExportHbjsonWithStats(api, content, name) {
+    return api.exportHbjsonWithStats(content, name);
+}
+/**
+ * Export the `IfcSpace` volumes in `content` as a Dragonfly DFJSON string
+ * (Ladybug Tools energy model). Each space becomes an extruded `Room2D`
+ * (floor polygon + height) grouped into stories — the simpler target for
+ * mostly-vertical-wall models.
+ */
+export function callExportDfjson(api, content, name) {
+    return api.exportDfjson(content, name);
+}
+//# sourceMappingURL=energy-export-bridge.js.map

package/dist/energy-export-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"energy-export-bridge.js","sourceRoot":"","sources":["../src/energy-export-bridge.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAc/D;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW,EAAE,OAAmB,EAAE,IAAY;IAC7E,OAAO,GAAG,CAAC,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AACzC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CACvC,GAAW,EACX,OAAmB,EACnB,IAAY;IAEZ,OAAO,GAAG,CAAC,qBAAqB,CAAC,OAAO,EAAE,IAAI,CAAgD,CAAC;AACjG,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW,EAAE,OAAmB,EAAE,IAAY;IAC7E,OAAO,GAAG,CAAC,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AACzC,CAAC"}

package/dist/geometry-parallel.d.ts

@@ -78,7 +78,8 @@ export interface ProcessParallelOptions {
      * `scanEntitiesFastBytes` call (~10 s on 1 GB files under WASM
      * contention with the geometry workers).
      */
-    onEntityIndex?: (ids: Uint32Array, starts: Uint32Array, lengths: Uint32Array) => void;
+    onEntityIndex?: (ids: Uint32Array, starts: Uint32Array, lengths: Uint32Array, oversizedIdCount?: number, // #3395 refused records
+    malformedRecordCount?: number) => void;
     /**
      * Issue #540 — "Merge Multilayer Walls" load-time toggle. When
      * `true`, the geometry workers' IfcAPI receive

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;AAQ3D;;;;;;;;;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,CA2xCxC"}
+{"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;AAS3D;;;;;;;;;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;AAyED,MAAM,WAAW,sBAAsB;IACrC;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,CACd,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,WAAW,EAAE,gBAAgB,CAAC,EAAE,MAAM,EAAE,wBAAwB;IACzE,oBAAoB,CAAC,EAAE,MAAM,KAC1B,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,CAszCxC"}

package/dist/geometry-parallel.js

@@ -9,6 +9,7 @@ import { restashWasmPanicLocation } from './wasm-panic-forward.js';
 // `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';
+import { stitchShards } from './shard-stitch.js';
 /**
  * Prepass class-byte layout, mirroring the `PREPASS_CLASS_*` definitions in
  * `rust/processing/src/shard_classes.rs` (the source of truth — these are
@@ -158,84 +159,6 @@ function terminateWorkerQuietly(worker, label) {
         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
- * `parallel_scan::stitch`: shard 0 is authoritative (header-aware start); for
- * shard i>0 the previous shard's validated `handoff` is a real entity start, so
- * binary-search shard i's `starts` for it and drop the speculative prefix before
- * it. Concatenates the validated slices in shard order (= file order), so
- * last-wins on a duplicate id is preserved when the worker rebuilds its map.
- *
- * Returns null on the rare "handoff not found" case (speculative overshoot / a
- * record spanning a whole shard), which needs the serial-rescan fallback the JS
- * spike doesn't implement — the caller falls back to the pre-pass's own index.
- */
-function stitchShards(shards) {
-    const n = shards.length;
-    // Phase 1 — locate each shard's validated slice (binary-search the previous
-    // shard's handoff) WITHOUT copying, so the output size is exact before any
-    // allocation. Exactness matters: the id/start/length columns are allocated
-    // SAB-backed below and handed to every worker as full-buffer views, so a
-    // cap-sized buffer would let consumers read past the last real record.
-    const sliceFrom = new Array(n).fill(0);
-    let used = 1;
-    let w = shards[0].ids.length; // shard 0 is authoritative, take every record
-    let expectedStart = shards[0].handoff; // -1 => no more real entities
-    for (let i = 1; i < n; i++) {
-        if (expectedStart < 0)
-            break;
-        // starts is strictly increasing → binary-search for expectedStart.
-        const starts = shards[i].starts;
-        let lo = 0;
-        let hi = starts.length - 1;
-        let p = -1;
-        while (lo <= hi) {
-            const mid = (lo + hi) >>> 1;
-            const v = starts[mid];
-            if (v === expectedStart) {
-                p = mid;
-                break;
-            }
-            if (v < expectedStart)
-                lo = mid + 1;
-            else
-                hi = mid - 1;
-        }
-        if (p < 0) {
-            // Handoff not present in this shard — fallback path (not implemented here).
-            return null;
-        }
-        sliceFrom[i] = p;
-        w += starts.length - p;
-        expectedStart = shards[i].handoff;
-        used = i + 1;
-    }
-    // Phase 2 — single concatenation copy, straight into SharedArrayBuffer-backed
-    // columns. The stitched index used to be copied THREE times per column on the
-    // main thread (cap-array stitch → `.slice()` to contiguous → `.set()` into
-    // fresh SABs in deliverEntityIndex); writing the stitch output into SABs
-    // directly makes index delivery zero-copy (~450 MB of critical-path memcpy
-    // saved on a 19M-entity file). `classes` stays plain: its only consumer past
-    // the span-extraction loop is the pre-pass worker, which takes it by transfer.
-    const sabAvailable = typeof SharedArrayBuffer !== 'undefined';
-    const u32Column = (len) => new Uint32Array(sabAvailable ? new SharedArrayBuffer(len * 4) : new ArrayBuffer(len * 4));
-    const outIds = u32Column(w);
-    const outStarts = u32Column(w);
-    const outLengths = u32Column(w);
-    const outClasses = new Uint8Array(w);
-    let o = 0;
-    for (let i = 0; i < used; i++) {
-        const s = shards[i];
-        const p = sliceFrom[i];
-        outIds.set(p === 0 ? s.ids : s.ids.subarray(p), o);
-        outStarts.set(p === 0 ? s.starts : s.starts.subarray(p), o);
-        outLengths.set(p === 0 ? s.lengths : s.lengths.subarray(p), o);
-        outClasses.set(p === 0 ? s.classes : s.classes.subarray(p), o);
-        o += s.ids.length - p;
-    }
-    return { ids: outIds, starts: outStarts, lengths: outLengths, classes: outClasses };
-}
 export async function* processParallel(buffer, coordinator, sharedRtcOffset, 
 /** Optional pre-allocated SAB the caller already shares with another worker. */
 existingSab, options) {
@@ -367,6 +290,11 @@ existingSab, options) {
                     lengths: msg.lengths,
                     classes: msg.classes,
                     handoff: msg.handoff,
+                    // Absent on an older wasm build: "does not report", which is not the
+                    // same claim as zero, but zero is all a host with no offsets can say.
+                    oversizedIdStarts: msg.oversizedIdStarts ?? new Uint32Array(0),
+                    // Absent = "no stop reported". TODO(#3699): no wasm build sets it yet.
+                    malformedStart: msg.malformedStart,
                 };
                 shardResultsRemaining--;
                 console.log(`[stream][shard] worker[${workerIndex}] shard ${si} done @ ${elapsed()}ms (${msg.ids.length} entities, remaining=${shardResultsRemaining})`);
@@ -810,7 +738,14 @@ existingSab, options) {
      * gate and drain. Shared by the pre-pass path and the SPIKE sharded-early
      * path so both distribute the index identically.
      */
-    const deliverEntityIndex = (ids, starts, lengths, source) => {
+    const deliverEntityIndex = (ids, starts, lengths, source, 
+    // #3395: the parser worker builds the model from these columns alone, so
+    // without the count it reports a clean load that is short by that many.
+    oversizedIdCount, 
+    // #3790: 1, or undefined when nothing reported (never coerced to 0 -- no
+    // producer can say "I ran clean" yet). Worse than a refusal: not "one
+    // record the parser will not find" but "every record after it is missing".
+    malformedRecordCount) => {
         console.log(`[stream] entity-index (${source}) @ ${elapsed()}ms (${ids.length} entries)`);
         if (typeof SharedArrayBuffer !== 'undefined') {
             // Sharded-stitch columns arrive already SAB-backed (stitchShards writes
@@ -850,7 +785,7 @@ existingSab, options) {
             }
             if (options?.onEntityIndex) {
                 try {
-                    options.onEntityIndex(new Uint32Array(sabIds), new Uint32Array(sabStarts), new Uint32Array(sabLengths));
+                    options.onEntityIndex(new Uint32Array(sabIds), new Uint32Array(sabStarts), new Uint32Array(sabLengths), oversizedIdCount, malformedRecordCount);
                 }
                 catch (err) {
                     console.warn('[stream] onEntityIndex callback failed:', err);
@@ -871,7 +806,7 @@ existingSab, options) {
             }
             if (options?.onEntityIndex) {
                 try {
-                    options.onEntityIndex(ids.slice(), starts.slice(), lengths.slice());
+                    options.onEntityIndex(ids.slice(), starts.slice(), lengths.slice(), oversizedIdCount, malformedRecordCount);
                 }
                 catch (err) {
                     console.warn('[stream] onEntityIndex callback failed:', err);
@@ -904,9 +839,16 @@ existingSab, options) {
         const starts = stitched.starts;
         const lengths = stitched.lengths;
         entityIndexDeliveredEarly = true;
+        // The stitch's attributed count, NOT the per-shard sum. Summing reports
+        // refusals a discarded speculative prefix invented, which on a file with
+        // nothing oversized in it is a warning about a file that is fine (#3430).
+        const oversizedIdCount = stitched.oversizedIdCount;
+        // Attributed by the stitch for the same reason (#3790): a shard that began
+        // inside a quoted value reports a stop the file does not contain.
+        const malformedRecordCount = stitched.malformedRecordCount;
         // set-entity-index reaches every worker FIRST (FIFO), so the style-shard
         // messages below always find the index installed.
-        deliverEntityIndex(ids, starts, lengths, 'sharded');
+        deliverEntityIndex(ids, starts, lengths, 'sharded', oversizedIdCount, malformedRecordCount);
         // Extract the styled-item span triples (class 4) in FILE ORDER from the
         // stitched columns, split into one contiguous slice per worker, and
         // resolve them in parallel while everyone waits on the pre-pass scan.
@@ -1185,7 +1127,9 @@ existingSab, options) {
                         console.log(`[stream] pre-pass entity-index arrived @ ${elapsed()}ms (already delivered via shards; ignoring)`);
                     }
                     else {
-                        deliverEntityIndex(ids, starts, lengths, 'prepass');
+                        // TODO(#3699): the Rust pre-pass emits no malformed count yet, so
+                        // this is undefined ("nothing reported"), carried as such.
+                        deliverEntityIndex(ids, starts, lengths, 'prepass', evt.oversizedIdCount ?? 0, evt.malformedRecordCount);
                     }
                 }
                 else if (evt.type === 'prepass-columns') {
@@ -1442,8 +1386,8 @@ existingSab, options) {
         const loadDiagnostics = diagnostics;
         if (loadDiagnostics && loadDiagnostics.totalCsgFailures > 0) {
             console.warn(`[ifc-lite] ${loadDiagnostics.totalCsgFailures} CSG failure(s) across ` +
-                `${loadDiagnostics.productsWithFailures} product(s) this load - some ` +
-                `openings/voids may be left uncut`);
+                `${loadDiagnostics.productsWithFailures} product(s) this load - see ` +
+                `diagnostics.failuresByReason; not every reason leaves an opening/void uncut`);
         }
         yield {
             type: 'complete',