@ifc-lite/geometry 7.3.0 → 7.5.0

package/dist/spatial-reference.js

@@ -0,0 +1,233 @@
+/* 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/. */
+const ZERO_OFFSET = { x: 0, y: 0, z: 0 };
+const EPSILON = 1e-12;
+function finite(values) {
+    return values.every(Number.isFinite);
+}
+function usableFrame(frame) {
+    const horizontal = new Set(frame.axes.filter((axis) => axis !== 'up' && axis !== 'down'));
+    const vertical = frame.axes.filter((axis) => axis === 'up' || axis === 'down');
+    const hasEastWest = [...horizontal].some((axis) => axis === 'east' || axis === 'west');
+    const hasNorthSouth = [...horizontal].some((axis) => axis === 'north' || axis === 'south');
+    return horizontal.size === 2 && hasEastWest && hasNorthSouth && vertical.length === 1
+        && finite([frame.horizontalUnitToMetres, frame.verticalUnitToMetres])
+        // Direction belongs exclusively in `axes`; a unit-to-metre factor cannot
+        // be negative without silently reflecting a source a second time.
+        && frame.horizontalUnitToMetres >= EPSILON
+        && frame.verticalUnitToMetres >= EPSILON;
+}
+/** Convert a source-native point to the renderer's East/Up/South metre frame. */
+function sourceToViewer(frame, point) {
+    if (!usableFrame(frame) || !finite(point))
+        return null;
+    let east;
+    let up;
+    let south;
+    for (let index = 0; index < 3; index++) {
+        const axis = frame.axes[index];
+        const value = point[index];
+        switch (axis) {
+            case 'east':
+                east = value * frame.horizontalUnitToMetres;
+                break;
+            case 'west':
+                east = -value * frame.horizontalUnitToMetres;
+                break;
+            case 'up':
+                up = value * frame.verticalUnitToMetres;
+                break;
+            case 'down':
+                up = -value * frame.verticalUnitToMetres;
+                break;
+            case 'south':
+                south = value * frame.horizontalUnitToMetres;
+                break;
+            case 'north':
+                south = -value * frame.horizontalUnitToMetres;
+                break;
+        }
+    }
+    return east === undefined || up === undefined || south === undefined ? null : [east, up, south];
+}
+/** Convert a renderer East/Up/South metre point to source-native coordinates. */
+function viewerToSource(frame, point) {
+    if (!usableFrame(frame) || !finite(point))
+        return null;
+    const values = frame.axes.map((axis) => {
+        switch (axis) {
+            case 'east': return point[0] / frame.horizontalUnitToMetres;
+            case 'west': return -point[0] / frame.horizontalUnitToMetres;
+            case 'up': return point[1] / frame.verticalUnitToMetres;
+            case 'down': return -point[1] / frame.verticalUnitToMetres;
+            case 'south': return point[2] / frame.horizontalUnitToMetres;
+            case 'north': return -point[2] / frame.horizontalUnitToMetres;
+        }
+    });
+    return finite(values) ? [values[0], values[1], values[2]] : null;
+}
+function normalizedAxis(operation) {
+    const length = Math.hypot(operation.xAxisAbscissa, operation.xAxisOrdinate);
+    if (!(Number.isFinite(length) && length >= EPSILON))
+        return null;
+    return { a: operation.xAxisAbscissa / length, b: operation.xAxisOrdinate / length };
+}
+function usableOperation(operation) {
+    return operation !== undefined
+        && operation.kind === 'local-projected-affine'
+        && finite([
+            operation.eastings, operation.northings, operation.orthogonalHeight,
+            operation.xAxisAbscissa, operation.xAxisOrdinate,
+            operation.scaleX, operation.scaleY, operation.scaleZ,
+        ])
+        && Math.abs(operation.scaleX) >= EPSILON
+        && Math.abs(operation.scaleY) >= EPSILON
+        && Math.abs(operation.scaleZ) >= EPSILON
+        && normalizedAxis(operation) !== null;
+}
+function sameCrs(a, b) {
+    return a !== undefined && b !== undefined && a.id === b.id;
+}
+function verticalCompatible(source, target, policy) {
+    if (source.vertical && target.vertical)
+        return source.vertical.id === target.vertical.id ? null : 'vertical-crs-mismatch';
+    if (policy === 'assume-compatible')
+        return null;
+    return 'vertical-crs-unknown';
+}
+/** Apply a spatial affine transform without narrowing the result. */
+export function applySpatialPlacement(transform, x, y, z) {
+    return [
+        transform.m00 * x + transform.m01 * y + transform.m02 * z + transform.tx,
+        transform.m10 * x + transform.m11 * y + transform.m12 * z + transform.ty,
+        transform.m20 * x + transform.m21 * y + transform.m22 * z + transform.tz,
+    ];
+}
+/** Map a source-native point to projected East/North/height in f64. */
+export function localViewerToProjected(reference, point, frameOffset = ZERO_OFFSET) {
+    if (!usableFrame(reference.source) || !usableOperation(reference.localToProjected)
+        || !finite([point[0], point[1], point[2], frameOffset.x, frameOffset.y, frameOffset.z]))
+        return null;
+    const operation = reference.localToProjected;
+    const axis = normalizedAxis(operation);
+    if (!axis)
+        return null;
+    // Renderer coordinates are East, Up, South. IFC/Y-up geometry's Z is the
+    // negated northing, hence the signs are intentionally asymmetric.
+    const viewer = sourceToViewer(reference.source, point);
+    const viewerOffset = sourceToViewer(reference.source, [frameOffset.x, frameOffset.y, frameOffset.z]);
+    if (!viewer || !viewerOffset)
+        return null;
+    const x = viewer[0] + viewerOffset[0];
+    const y = viewer[1] + viewerOffset[1];
+    const south = viewer[2] + viewerOffset[2];
+    return [
+        operation.eastings + operation.scaleX * axis.a * x + operation.scaleY * axis.b * south,
+        operation.northings + operation.scaleX * axis.b * x - operation.scaleY * axis.a * south,
+        operation.orthogonalHeight + operation.scaleZ * y,
+    ];
+}
+/** Map projected East/North/height to a source-native point in f64. */
+export function projectedToLocalViewer(reference, point, frameOffset = ZERO_OFFSET) {
+    if (!usableFrame(reference.source) || !usableOperation(reference.localToProjected)
+        || !finite([point[0], point[1], point[2], frameOffset.x, frameOffset.y, frameOffset.z]))
+        return null;
+    const operation = reference.localToProjected;
+    const axis = normalizedAxis(operation);
+    if (!axis)
+        return null;
+    const de = point[0] - operation.eastings;
+    const dn = point[1] - operation.northings;
+    const x = (axis.a * de + axis.b * dn) / operation.scaleX;
+    const south = (axis.b * de - axis.a * dn) / operation.scaleY;
+    const y = (point[2] - operation.orthogonalHeight) / operation.scaleZ;
+    const source = viewerToSource(reference.source, [x, y, south]);
+    if (!source)
+        return null;
+    // Frame offsets live in the reference's NATIVE source coordinates, just as
+    // the point this function returns does. Treating the offset as viewer axes
+    // and converting it a second time happened to work for IFC's viewer-shaped
+    // metre frame, but corrupts a feet/North-East-Down adapter's inverse.
+    const result = [
+        source[0] - frameOffset.x, source[1] - frameOffset.y, source[2] - frameOffset.z,
+    ];
+    return finite(result) ? result : null;
+}
+/**
+ * Resolve a same-horizontal-CRS source placement into a target's renderer
+ * frame. Cross-CRS transforms require an explicit operation provider and are
+ * intentionally refused here rather than guessed from matching display names.
+ */
+export function resolveSpatialPlacement(source, target, options = {}) {
+    if (!usableFrame(source.source) || !usableFrame(target.source)
+        || !usableOperation(source.localToProjected) || !usableOperation(target.localToProjected)) {
+        return { ok: false, refusal: 'invalid-axis-or-unit' };
+    }
+    if (!source.horizontal || !target.horizontal)
+        return { ok: false, refusal: 'missing-horizontal-crs' };
+    if (!sameCrs(source.horizontal, target.horizontal))
+        return { ok: false, refusal: 'crs-mismatch' };
+    const vertical = verticalCompatible(source, target, options.unknownVertical ?? 'refuse');
+    if (vertical)
+        return { ok: false, refusal: vertical };
+    const sourceOperation = source.localToProjected;
+    const targetOperation = target.localToProjected;
+    const sourceAxis = normalizedAxis(sourceOperation);
+    const targetAxis = normalizedAxis(targetOperation);
+    const targetOffset = options.targetFrameOffset ?? ZERO_OFFSET;
+    const sourceOffset = options.sourceFrameOffset ?? ZERO_OFFSET;
+    if (!finite([
+        sourceOffset.x, sourceOffset.y, sourceOffset.z,
+        targetOffset.x, targetOffset.y, targetOffset.z,
+    ]))
+        return { ok: false, refusal: 'invalid-axis-or-unit' };
+    // The origin goes through the public f64 map/inverse functions because it
+    // contains both map and frame offsets. The linear columns must NOT be
+    // derived by subtracting two ~million-metre projected points: that loses
+    // meaningful sub-millimetre precision before the target inverse sees them.
+    // Compose just the linear map terms below, then convert the target viewer
+    // deltas back to its native axes/units. This retains the deliberately
+    // asymmetric South axis without finite-differencing large coordinates.
+    const origin = localViewerToProjected(source, [0, 0, 0], sourceOffset);
+    if (!origin)
+        return { ok: false, refusal: 'non-invertible-transform' };
+    const p0 = projectedToLocalViewer(target, origin, targetOffset);
+    if (!p0)
+        return { ok: false, refusal: 'non-invertible-transform' };
+    const sourceToTargetDelta = (sourceNative) => {
+        const sourceViewer = sourceToViewer(source.source, sourceNative);
+        if (!sourceViewer)
+            return null;
+        const [east, up, south] = sourceViewer;
+        const deltaEast = sourceOperation.scaleX * sourceAxis.a * east + sourceOperation.scaleY * sourceAxis.b * south;
+        const deltaNorth = sourceOperation.scaleX * sourceAxis.b * east - sourceOperation.scaleY * sourceAxis.a * south;
+        const deltaHeight = sourceOperation.scaleZ * up;
+        const targetViewer = [
+            (targetAxis.a * deltaEast + targetAxis.b * deltaNorth) / targetOperation.scaleX,
+            deltaHeight / targetOperation.scaleZ,
+            (targetAxis.b * deltaEast - targetAxis.a * deltaNorth) / targetOperation.scaleY,
+        ];
+        return viewerToSource(target.source, targetViewer);
+    };
+    const px = sourceToTargetDelta([1, 0, 0]);
+    const py = sourceToTargetDelta([0, 1, 0]);
+    const pz = sourceToTargetDelta([0, 0, 1]);
+    if (!px || !py || !pz)
+        return { ok: false, refusal: 'non-invertible-transform' };
+    const transform = {
+        m00: px[0], m01: py[0], m02: pz[0], tx: p0[0],
+        m10: px[1], m11: py[1], m12: pz[1], ty: p0[1],
+        m20: px[2], m21: py[2], m22: pz[2], tz: p0[2],
+    };
+    if (!finite(Object.values(transform)))
+        return { ok: false, refusal: 'non-invertible-transform' };
+    const identity = Math.abs(transform.m00 - 1) < 1e-12 && Math.abs(transform.m11 - 1) < 1e-12
+        && Math.abs(transform.m22 - 1) < 1e-12 && Math.abs(transform.m01) < 1e-12
+        && Math.abs(transform.m02) < 1e-12 && Math.abs(transform.m10) < 1e-12
+        && Math.abs(transform.m12) < 1e-12 && Math.abs(transform.m20) < 1e-12
+        && Math.abs(transform.m21) < 1e-12 && Math.abs(transform.tx) < 1e-12
+        && Math.abs(transform.ty) < 1e-12 && Math.abs(transform.tz) < 1e-12;
+    return { ok: true, placement: { status: identity ? 'identity' : 'same-crs', sourceToFederation: transform, source, target } };
+}
+//# sourceMappingURL=spatial-reference.js.map

package/dist/spatial-reference.js.map

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

package/dist/stall-phase.d.ts

@@ -0,0 +1,111 @@
+import type { GeometryDiagnostics } from './diagnostics.js';
+/**
+ * Which pre-worker pipeline phase (#4902) is still outstanding. Production
+ * "Geometry stream stalled... Last rendered meshes: 0" reports (#4884
+ * follow-up) cannot currently be told apart by phase — this is what makes
+ * that possible: read with {@link GateTracker.getStallPhase} at the instant
+ * the consumer's watchdog fires, rather than inferred from elapsed time.
+ */
+export type StallPhase = 'prepass' | 'shard-scan' | 'styles-gate' | 'entity-index-gate' | 'workers';
+/**
+ * Handed in via `ProcessParallelOptions.stallPhaseHandle` (#4902) and filled
+ * in synchronously by the pool with a live `getStallPhase()` reader. Absent
+ * `getStallPhase` (before the pool runs, or on a code path that doesn't wire
+ * one) is the caller's signal that no phase is known yet.
+ */
+export interface StallPhaseHandle {
+    getStallPhase?: () => StallPhase;
+}
+/**
+ * Tracks which pre-worker gate(s) `geometry-parallel.ts` is still waiting on:
+ * the streaming pre-pass itself, the SPIKE sharded entity-index scan
+ * (`scan-shard` / `shardResultsRemaining`), and the two chunk-dispatch gates
+ * (`styles` and `entity-index` — see `dispatchJobsChunk`). A new sibling
+ * module (not `geometry-parallel.ts`, which is size-allowlisted and must not
+ * grow) so the gate state has one place a consumer can read it from.
+ *
+ * Precedence when more than one gate is open at once: the EARLIEST phase in
+ * the pipeline wins, because it is the one actually responsible for every
+ * later phase staying open too (a stuck shard scan means neither the prepass
+ * nor either dispatch gate can ever resolve).
+ */
+export declare class GateTracker {
+    private shardScanOpen;
+    private prepassOpen;
+    private stylesOpen;
+    private entityIndexOpen;
+    /** The SPIKE sharded scan dispatched shard-scan to the workers. */
+    markShardScanStarted(): void;
+    /** Every shard result is in (stitched or fell back to the serial pre-pass). */
+    markShardScanDone(): void;
+    /** The pre-pass worker's `complete` event arrived. */
+    markPrepassDone(): void;
+    /** The `styles` event (serial or the sharded finalize's synthesized one)
+     *  reached `dispatchJobsChunk`'s gate. */
+    markStylesReceived(): void;
+    /** The entity index (prepass or sharded-early) reached the same gate. */
+    markEntityIndexReceived(): void;
+    /** Which phase a consumer's watchdog should attribute a stall to right now. */
+    getStallPhase(): StallPhase;
+}
+/**
+ * A `getStallPhase` reader that returns a fixed `phase` and closes over
+ * NOTHING else (#4979 review). `processParallel`'s `finally` re-seats the
+ * caller-owned `stallPhaseHandle` to one of these on teardown: the LIVE
+ * reader it installed at the start (`() => gateTracker.getStallPhase()`)
+ * closes over `gateTracker`, which — through the rest of that generator's
+ * scope — keeps the per-load `sharedBuffer` reachable for as long as the
+ * caller holds the handle, even after every worker is gone. A snapshot taken
+ * at teardown is exactly as useful for a watchdog that reads it afterwards
+ * (the phase cannot change once nothing is left running) without the retention.
+ */
+export declare function frozenStallPhase(phase: StallPhase): () => StallPhase;
+/** Bound (ms) for one pre-worker single-reply phase, scaled by file size. */
+export declare function preWorkerPhaseBoundMs(fileSizeMB: number): number;
+/**
+ * Registry for the pre-worker phase-bound timers (#4979 review). A plain
+ * `setTimeout` that is never cancelled keeps its own closure — and whatever
+ * it closes over, including the per-load `sharedBuffer` — alive for the FULL
+ * bound even after the load completes, fails, or is superseded; on a large
+ * file that is real memory held for up to 15s + 30ms/MB for no reason. `arm`
+ * tracks the handle and self-removes it once it actually fires; `clearAll` is
+ * for the generator's own teardown (`finally`, which also runs on `.return()`
+ * / abort), which normally fires first.
+ */
+export declare class PhaseBoundTimers {
+    private readonly handles;
+    /**
+     * Arm a bounded wait for a pre-worker phase that depends on a single
+     * worker's reply — shard scan, a style slice, styles finalize (#4902).
+     * Fires `onTimeout` once, only if `isSettled()` is still false when the
+     * bound elapses, so a genuine reply arriving right at the boundary (which
+     * flips the call site's own settled flag before this checks it) always
+     * wins.
+     */
+    arm(fileSizeMB: number, isSettled: () => boolean, onTimeout: () => void): void;
+    /** Cancel every timer still pending — the load exited before its bound. */
+    clearAll(): void;
+}
+/**
+ * The synthetic prepass-stream `styles` event an older engine binary that
+ * never resolves any styles already produces byte-identically (default
+ * per-type colours, no voids). Reused as the #4902 finalize-timeout
+ * fallback: worker[0]'s `styles-final` reply feeds the exact same path
+ * (see `geometry-parallel.ts`'s `msg.type === 'styles-final'` handler), so a
+ * degraded stream degrades to a shape the pool already handles rather than a
+ * new one.
+ */
+export declare function emptyStylesPrepassEvent(): {
+    type: 'prepass-stream';
+    event: Record<string, unknown>;
+};
+/**
+ * A `GeometryDiagnostics` fragment carrying exactly one typed pre-worker-phase
+ * failure (#4902), for `mergeGeometryDiagnostics`. Every counter besides
+ * `failuresByReason` is zero, so merging this in never fabricates CSG
+ * activity that did not happen. `schemaVersion: 0` — this is a host-
+ * synthesized fragment, not a producer-versioned wasm payload, and
+ * `mergeGeometryDiagnostics` takes the max, so it never lowers a real one.
+ */
+export declare function preWorkerPhaseFailureDiagnostics(reason: string): GeometryDiagnostics;
+//# sourceMappingURL=stall-phase.d.ts.map

package/dist/stall-phase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stall-phase.d.ts","sourceRoot":"","sources":["../src/stall-phase.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE5D;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAClB,SAAS,GACT,YAAY,GACZ,aAAa,GACb,mBAAmB,GACnB,SAAS,CAAC;AAEd;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,aAAa,CAAC,EAAE,MAAM,UAAU,CAAC;CAClC;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,eAAe,CAAQ;IAE/B,mEAAmE;IACnE,oBAAoB,IAAI,IAAI;IAI5B,+EAA+E;IAC/E,iBAAiB,IAAI,IAAI;IAIzB,sDAAsD;IACtD,eAAe,IAAI,IAAI;IAIvB;8CAC0C;IAC1C,kBAAkB,IAAI,IAAI;IAI1B,yEAAyE;IACzE,uBAAuB,IAAI,IAAI;IAI/B,+EAA+E;IAC/E,aAAa,IAAI,UAAU;CAO5B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,UAAU,CAEpE;AAUD,6EAA6E;AAC7E,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED;;;;;;;;;GASG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4C;IAEpE;;;;;;;OAOG;IACH,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,GAAG,IAAI;IAQ9E,2EAA2E;IAC3E,QAAQ,IAAI,IAAI;CAIjB;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,IAAI;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CASpG;AAED;;;;;;;GAOG;AACH,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,MAAM,GAAG,mBAAmB,CAoBpF"}

package/dist/stall-phase.js

@@ -0,0 +1,164 @@
+/* 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/. */
+/**
+ * Tracks which pre-worker gate(s) `geometry-parallel.ts` is still waiting on:
+ * the streaming pre-pass itself, the SPIKE sharded entity-index scan
+ * (`scan-shard` / `shardResultsRemaining`), and the two chunk-dispatch gates
+ * (`styles` and `entity-index` — see `dispatchJobsChunk`). A new sibling
+ * module (not `geometry-parallel.ts`, which is size-allowlisted and must not
+ * grow) so the gate state has one place a consumer can read it from.
+ *
+ * Precedence when more than one gate is open at once: the EARLIEST phase in
+ * the pipeline wins, because it is the one actually responsible for every
+ * later phase staying open too (a stuck shard scan means neither the prepass
+ * nor either dispatch gate can ever resolve).
+ */
+export class GateTracker {
+    shardScanOpen = false;
+    prepassOpen = true;
+    stylesOpen = true;
+    entityIndexOpen = true;
+    /** The SPIKE sharded scan dispatched shard-scan to the workers. */
+    markShardScanStarted() {
+        this.shardScanOpen = true;
+    }
+    /** Every shard result is in (stitched or fell back to the serial pre-pass). */
+    markShardScanDone() {
+        this.shardScanOpen = false;
+    }
+    /** The pre-pass worker's `complete` event arrived. */
+    markPrepassDone() {
+        this.prepassOpen = false;
+    }
+    /** The `styles` event (serial or the sharded finalize's synthesized one)
+     *  reached `dispatchJobsChunk`'s gate. */
+    markStylesReceived() {
+        this.stylesOpen = false;
+    }
+    /** The entity index (prepass or sharded-early) reached the same gate. */
+    markEntityIndexReceived() {
+        this.entityIndexOpen = false;
+    }
+    /** Which phase a consumer's watchdog should attribute a stall to right now. */
+    getStallPhase() {
+        if (this.shardScanOpen)
+            return 'shard-scan';
+        if (this.prepassOpen)
+            return 'prepass';
+        if (this.stylesOpen)
+            return 'styles-gate';
+        if (this.entityIndexOpen)
+            return 'entity-index-gate';
+        return 'workers';
+    }
+}
+/**
+ * A `getStallPhase` reader that returns a fixed `phase` and closes over
+ * NOTHING else (#4979 review). `processParallel`'s `finally` re-seats the
+ * caller-owned `stallPhaseHandle` to one of these on teardown: the LIVE
+ * reader it installed at the start (`() => gateTracker.getStallPhase()`)
+ * closes over `gateTracker`, which — through the rest of that generator's
+ * scope — keeps the per-load `sharedBuffer` reachable for as long as the
+ * caller holds the handle, even after every worker is gone. A snapshot taken
+ * at teardown is exactly as useful for a watchdog that reads it afterwards
+ * (the phase cannot change once nothing is left running) without the retention.
+ */
+export function frozenStallPhase(phase) {
+    return () => phase;
+}
+// Bound for a pre-worker phase that waits on a single worker's reply (a shard
+// scan, one style slice, styles finalize). Mirrors the desktop first-batch
+// floor/ramp in watchdog.ts (15_000 + MB*30) rather than the browser one
+// (30_000 + MB*60): several of these bounds can be outstanding in the same
+// load, so each gets the smaller half.
+const PRE_WORKER_PHASE_FLOOR_MS = 15_000;
+const PRE_WORKER_PHASE_PER_MB_MS = 30;
+/** Bound (ms) for one pre-worker single-reply phase, scaled by file size. */
+export function preWorkerPhaseBoundMs(fileSizeMB) {
+    return Math.max(PRE_WORKER_PHASE_FLOOR_MS, Math.round(PRE_WORKER_PHASE_FLOOR_MS + Math.max(0, fileSizeMB) * PRE_WORKER_PHASE_PER_MB_MS));
+}
+/**
+ * Registry for the pre-worker phase-bound timers (#4979 review). A plain
+ * `setTimeout` that is never cancelled keeps its own closure — and whatever
+ * it closes over, including the per-load `sharedBuffer` — alive for the FULL
+ * bound even after the load completes, fails, or is superseded; on a large
+ * file that is real memory held for up to 15s + 30ms/MB for no reason. `arm`
+ * tracks the handle and self-removes it once it actually fires; `clearAll` is
+ * for the generator's own teardown (`finally`, which also runs on `.return()`
+ * / abort), which normally fires first.
+ */
+export class PhaseBoundTimers {
+    handles = new Set();
+    /**
+     * Arm a bounded wait for a pre-worker phase that depends on a single
+     * worker's reply — shard scan, a style slice, styles finalize (#4902).
+     * Fires `onTimeout` once, only if `isSettled()` is still false when the
+     * bound elapses, so a genuine reply arriving right at the boundary (which
+     * flips the call site's own settled flag before this checks it) always
+     * wins.
+     */
+    arm(fileSizeMB, isSettled, onTimeout) {
+        const handle = setTimeout(() => {
+            this.handles.delete(handle);
+            if (!isSettled())
+                onTimeout();
+        }, preWorkerPhaseBoundMs(fileSizeMB));
+        this.handles.add(handle);
+    }
+    /** Cancel every timer still pending — the load exited before its bound. */
+    clearAll() {
+        for (const handle of this.handles)
+            clearTimeout(handle);
+        this.handles.clear();
+    }
+}
+/**
+ * The synthetic prepass-stream `styles` event an older engine binary that
+ * never resolves any styles already produces byte-identically (default
+ * per-type colours, no voids). Reused as the #4902 finalize-timeout
+ * fallback: worker[0]'s `styles-final` reply feeds the exact same path
+ * (see `geometry-parallel.ts`'s `msg.type === 'styles-final'` handler), so a
+ * degraded stream degrades to a shape the pool already handles rather than a
+ * new one.
+ */
+export function emptyStylesPrepassEvent() {
+    return {
+        type: 'prepass-stream',
+        event: {
+            type: 'styles',
+            styleIds: new Uint32Array(0), styleColors: new Uint8Array(0),
+            voidKeys: new Uint32Array(0), voidCounts: new Uint32Array(0), voidValues: new Uint32Array(0),
+        },
+    };
+}
+/**
+ * A `GeometryDiagnostics` fragment carrying exactly one typed pre-worker-phase
+ * failure (#4902), for `mergeGeometryDiagnostics`. Every counter besides
+ * `failuresByReason` is zero, so merging this in never fabricates CSG
+ * activity that did not happen. `schemaVersion: 0` — this is a host-
+ * synthesized fragment, not a producer-versioned wasm payload, and
+ * `mergeGeometryDiagnostics` takes the max, so it never lowers a real one.
+ */
+export function preWorkerPhaseFailureDiagnostics(reason) {
+    return {
+        schemaVersion: 0,
+        totalCsgFailures: 0,
+        productsWithFailures: 0,
+        hostsWithOpenings: 0,
+        classification: { rectangular: 0, diagonal: 0, nonRectangular: 0, total: 0 },
+        failuresByReason: [{ reason, count: 1 }],
+        silentNoOps: 0,
+        rectFast: {
+            fired: 0,
+            openingsCut: 0,
+            deferHostNotBox: 0,
+            deferNotThrough: 0,
+            deferOffFace: 0,
+            deferNearEdge: 0,
+            deferNoOpenings: 0,
+        },
+        worstHosts: [],
+    };
+}
+//# sourceMappingURL=stall-phase.js.map

package/dist/stall-phase.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ifc-lite/geometry",
-  "version": "7.3.0",
+  "version": "7.5.0",
   "description": "Geometry processing bridge for IFC-Lite - exact-arithmetic CSG, streamed across workers",
   "type": "module",
   "main": "./dist/index.js",
@@ -28,8 +28,8 @@
     }
   },
   "dependencies": {
-    "@ifc-lite/data": "^4.5.0",
-    "@ifc-lite/wasm": "^9.1.0",
+    "@ifc-lite/data": "^5.0.0",
+    "@ifc-lite/wasm": "^9.3.0",
     "@ifc-lite/wasm-lifecycle": "^0.2.0"
   },
   "optionalDependencies": {
@@ -38,7 +38,7 @@
   "devDependencies": {
     "@tauri-apps/api": "^2.11.1",
     "typescript": "^6.0.3",
-    "vitest": "^4.1.11"
+    "vitest": "^5.0.1"
   },
   "license": "MPL-2.0",
   "author": "Louis True",