@ifc-lite/geometry 3.4.0 → 3.6.0

package/dist/types.d.ts

@@ -1,6 +1,19 @@
 /**
  * Geometry types for IFC-Lite
  */
+/**
+ * An entity's world-space axis-aligned bounding box, in the renderer frame
+ * (WebGL Y-up, metres) and in ABSOLUTE world coordinates — the RTC offset and
+ * the per-element {@link MeshData.origin} are already folded in.
+ *
+ * Distinct from {@link MeshData.localBounds}, which is the pre-placement
+ * object-space box of one submesh, and from `origin`, which is a translation
+ * carried purely for f32 precision. Do not conflate the three.
+ */
+export interface EntityWorldAabb {
+    min: [number, number, number];
+    max: [number, number, number];
+}
 /**
  * Mesh data for a single geometric representation of an IFC element.
  *
@@ -60,6 +73,41 @@ export interface MeshData {
      *  share the same value (it is the whole-entity hash). Consumed by the
      *  model-diff / compare feature (issue #924); renderers ignore it. */
     geometryHash?: bigint;
+    /** Whole-entity world bounding box from the SAME hashing pass as
+     *  {@link MeshData.geometryHash} (`MeshCollection.geometryAabbValues`),
+     *  populated only when geometry hashing is enabled
+     *  (`GeometryProcessor.enableGeometryHashes()`). Like the hash, all submeshes
+     *  of one entity carry the same box — it spans the entity, not this submesh.
+     *
+     *  ABSOLUTE world, unlike `positions`: the RTC offset and the per-element
+     *  {@link MeshData.origin} are already folded in, so two revisions that chose
+     *  different RTC offsets report the same box. Do NOT add `origin` to it.
+     *
+     *  Absent when the pass produced no box for the entity (the wasm side writes
+     *  six `NaN`s there; the extractor drops them rather than passing a
+     *  NaN-bearing object on), when hashing is off, or on a wasm build predating
+     *  the getter. Consumed by the model-diff / compare feature to tell a move
+     *  from a reshape (#1891); renderers ignore it. */
+    geometryAabb?: EntityWorldAabb;
+    /** Whole-entity enclosed volume in CUBIC METRES, from the SAME hashing pass
+     *  as {@link MeshData.geometryHash} (`MeshCollection.geometryVolumeValues`,
+     *  #1993). Like the hash and the box, all submeshes of one entity carry the
+     *  identical value — it is the volume of the entity, not of this submesh, so
+     *  summing it across submeshes would multiply it.
+     *
+     *  Present only when the meshed geometry was PROVABLY a single closed,
+     *  orientable, single-component solid (measured coverage on a real corpus:
+     *  71.4%, 24,073 of 33,701 elements). Absent means the kernel could not prove
+     *  a volume — an open shell, a material-layered wall, a multi-item assembly —
+     *  and NEVER that the volume is zero or that it differs. The wasm side writes
+     *  `NaN` there; the extractor drops it rather than passing a NaN-bearing
+     *  number on.
+     *
+     *  It is the volume of what was actually meshed, AFTER opening cuts, so it is
+     *  not an IFC `BaseQuantities` `GrossVolume` and must not be compared with
+     *  one. Consumed by the model-diff split/merge detector (#1891); renderers
+     *  ignore it. */
+    geometryVolume?: number;
     /** Geometry provenance for rendering and the viewer's Model/Types view switch:
      *  - 0 = occurrence (placed IfcProduct). RENDER THIS in normal/Model views.
      *  - 1 = orphan type geometry (an IfcTypeProduct RepresentationMap with no
@@ -283,6 +331,25 @@ export interface GeometryResult {
      * geometry hashing is off or no entity was fully instanced.
      */
     instancedGeometryHashes?: Map<number, bigint>;
+    /**
+     * World bounding boxes for the SAME instanced-only entities as
+     * {@link GeometryResult.instancedGeometryHashes}, keyed the same way. A
+     * separate map rather than a field on the hash entry because an entity can
+     * have a hash and no box (the wasm side writes six `NaN`s there); a key
+     * missing here means exactly that. Absent when geometry hashing is off,
+     * nothing was fully instanced, or the wasm build predates the getter.
+     */
+    instancedGeometryAabbs?: Map<number, EntityWorldAabb>;
+    /**
+     * Enclosed volumes (m³) for the SAME instanced-only entities, keyed the same
+     * way (#1993). A third map for the same reason the boxes are a second one: an
+     * entity can be hashed and boxed with no PROVED volume, so a key missing here
+     * means exactly "not proved", and folding it into the hash entry would make
+     * absence indistinguishable from an entity that has no fingerprint at all.
+     * Absent when geometry hashing is off, nothing was fully instanced, or the
+     * wasm build predates the getter.
+     */
+    instancedGeometryVolumes?: Map<number, number>;
 }
 /**
  * Representation identifier types for symbolic representations

package/dist/types.d.ts.map

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

package/dist/wasm-init-retry.d.ts

@@ -36,7 +36,8 @@ export interface InitWasmRetryOptions {
 /**
  * Run `init` once; on a transient-looking failure, wait and retry exactly once.
  * Non-transient failures propagate without a retry. The second failure (if any)
- * propagates to the caller.
+ * propagates to the caller — attributed to the engine binary when the browser's
+ * own wording identifies nothing (see {@link attributeEngineLoadFailure}).
  *
  * @param init Thunk that performs the actual `init(...)` call (so callers can
  *   bind their own wasm URL / arguments).

package/dist/wasm-init-retry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wasm-init-retry.d.ts","sourceRoot":"","sources":["../src/wasm-init-retry.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;GAWG;AAEH;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAOjE;AAED,MAAM,WAAW,oBAAoB;IACnC,qEAAqE;IACrE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,oDAAoD;IACpD,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAKD;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,EAC5B,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,IAAI,CAAC,CAYf"}
+{"version":3,"file":"wasm-init-retry.d.ts","sourceRoot":"","sources":["../src/wasm-init-retry.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;GAWG;AAEH;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAOjE;AA6CD,MAAM,WAAW,oBAAoB;IACnC,qEAAqE;IACrE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,oDAAoD;IACpD,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAKD;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,EAC5B,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,IAAI,CAAC,CAgBf"}

package/dist/wasm-init-retry.js

@@ -33,11 +33,52 @@ export function isTransientWasmLoadError(message) {
     }
     return /HTTP status code is not ok|failed to fetch|network ?error|load failed/i.test(message);
 }
+/**
+ * A message that already names the thing that failed to load, so re-throwing it
+ * with an attribution prefix would only add noise. Deliberately includes
+ * `WebAssembly` (the `'compile' on 'WebAssembly'` phrasings) — those are exactly
+ * the signatures `isWasmAssetUnavailableError` (wasm-asset-error.ts) matches to
+ * drive the #1363 stale-deploy reload, and they must reach it byte-for-byte.
+ */
+const SELF_IDENTIFYING = /wasm|webassembly/i;
+/**
+ * A failed *module* load already carries its own specifier. Prefixing one with
+ * `ifc-lite_bg.wasm` would make it look to that same #1363 matcher like a
+ * rotated ENGINE BINARY (`/\.wasm/` + "dynamically imported module") and
+ * trigger a spurious page reload, so those are passed through untouched.
+ */
+const MODULE_LOAD_FAILURE = /dynamically imported module|module script/i;
+/**
+ * Name the engine binary in a transport failure that names nothing (issue #1903).
+ *
+ * wasm-bindgen's generated loader `await`s the `fetch()` it starts, so a
+ * network-level rejection propagates RAW: WebKit words it `TypeError: Load
+ * failed`, Chromium `TypeError: Failed to fetch`, and because the rejection
+ * originates inside the fetch rather than in our frames it carries an EMPTY
+ * stack. Two words and no frames is unattributable by construction — the toast,
+ * `classifyLoadError` in the viewer, and error tracking all see a bare
+ * `TypeError` that could have come from anywhere in the load.
+ *
+ * So when the final failure identifies nothing, re-throw it naming the binary
+ * and the call site, preserving the original as `.cause`. Anything that already
+ * identifies itself is returned unchanged.
+ */
+function attributeEngineLoadFailure(error, label) {
+    if (!(error instanceof Error))
+        return error;
+    const msg = error.message;
+    if (!isTransientWasmLoadError(msg))
+        return error;
+    if (SELF_IDENTIFYING.test(msg) || MODULE_LOAD_FAILURE.test(msg))
+        return error;
+    return new Error(`Failed to load the WASM engine binary (ifc-lite_bg.wasm) in ${label}: ${msg}`, { cause: error });
+}
 const defaultSleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 /**
  * Run `init` once; on a transient-looking failure, wait and retry exactly once.
  * Non-transient failures propagate without a retry. The second failure (if any)
- * propagates to the caller.
+ * propagates to the caller — attributed to the engine binary when the browser's
+ * own wording identifies nothing (see {@link attributeEngineLoadFailure}).
  *
  * @param init Thunk that performs the actual `init(...)` call (so callers can
  *   bind their own wasm URL / arguments).
@@ -54,7 +95,12 @@ export async function initWasmWithRetry(init, options = {}) {
             throw err;
         warn(`[${label}] WASM engine load failed (${msg}); retrying once`);
         await sleep(retryDelayMs);
-        await init();
+        try {
+            await init();
+        }
+        catch (retryErr) {
+            throw attributeEngineLoadFailure(retryErr, label);
+        }
     }
 }
 //# sourceMappingURL=wasm-init-retry.js.map

package/dist/wasm-init-retry.js.map

@@ -1 +1 @@
-{"version":3,"file":"wasm-init-retry.js","sourceRoot":"","sources":["../src/wasm-init-retry.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D;;;;;;;;;;;GAWG;AAEH;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,wBAAwB,CAAC,OAAe;IACtD,6EAA6E;IAC7E,kCAAkC;IAClC,IAAI,8EAA8E,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACjG,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,wEAAwE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAChG,CAAC;AAaD,MAAM,YAAY,GAAG,CAAC,EAAU,EAAiB,EAAE,CACjD,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAEpD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,IAA4B,EAC5B,UAAgC,EAAE;IAElC,MAAM,EAAE,YAAY,GAAG,GAAG,EAAE,KAAK,GAAG,YAAY,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,KAAK,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC;IAClG,IAAI,CAAC;QACH,MAAM,IAAI,EAAE,CAAC;QACb,OAAO;IACT,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,IAAI,CAAC,wBAAwB,CAAC,GAAG,CAAC;YAAE,MAAM,GAAG,CAAC;QAC9C,IAAI,CAAC,IAAI,KAAK,8BAA8B,GAAG,kBAAkB,CAAC,CAAC;QACnE,MAAM,KAAK,CAAC,YAAY,CAAC,CAAC;QAC1B,MAAM,IAAI,EAAE,CAAC;IACf,CAAC;AACH,CAAC"}
+{"version":3,"file":"wasm-init-retry.js","sourceRoot":"","sources":["../src/wasm-init-retry.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D;;;;;;;;;;;GAWG;AAEH;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,wBAAwB,CAAC,OAAe;IACtD,6EAA6E;IAC7E,kCAAkC;IAClC,IAAI,8EAA8E,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACjG,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,wEAAwE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAChG,CAAC;AAED;;;;;;GAMG;AACH,MAAM,gBAAgB,GAAG,mBAAmB,CAAC;AAE7C;;;;;GAKG;AACH,MAAM,mBAAmB,GAAG,4CAA4C,CAAC;AAEzE;;;;;;;;;;;;;;GAcG;AACH,SAAS,0BAA0B,CAAC,KAAc,EAAE,KAAa;IAC/D,IAAI,CAAC,CAAC,KAAK,YAAY,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5C,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC;IAC1B,IAAI,CAAC,wBAAwB,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACjD,IAAI,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,mBAAmB,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9E,OAAO,IAAI,KAAK,CACd,+DAA+D,KAAK,KAAK,GAAG,EAAE,EAC9E,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;AACJ,CAAC;AAaD,MAAM,YAAY,GAAG,CAAC,EAAU,EAAiB,EAAE,CACjD,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAEpD;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,IAA4B,EAC5B,UAAgC,EAAE;IAElC,MAAM,EAAE,YAAY,GAAG,GAAG,EAAE,KAAK,GAAG,YAAY,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,KAAK,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC;IAClG,IAAI,CAAC;QACH,MAAM,IAAI,EAAE,CAAC;QACb,OAAO;IACT,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,IAAI,CAAC,wBAAwB,CAAC,GAAG,CAAC;YAAE,MAAM,GAAG,CAAC;QAC9C,IAAI,CAAC,IAAI,KAAK,8BAA8B,GAAG,kBAAkB,CAAC,CAAC;QACnE,MAAM,KAAK,CAAC,YAAY,CAAC,CAAC;QAC1B,IAAI,CAAC;YACH,MAAM,IAAI,EAAE,CAAC;QACf,CAAC;QAAC,OAAO,QAAQ,EAAE,CAAC;YAClB,MAAM,0BAA0B,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/wasm-runtime-trap.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Classify WebAssembly runtime traps and, for the one case that genuinely
+ * cannot be recovered in-document, broadcast it so the host can offer a reload
+ * (#1898).
+ *
+ * A trap is what reaches JS when the engine executes `unreachable`: with
+ * `panic = "abort"` (rust/Cargo.toml) a Rust panic, a failed `assert!` and an
+ * allocator abort are ALL indistinguishable from here — see the same caveat in
+ * `huge-file-error.ts`. What a trap can damage is bounded: the wasm instance's
+ * linear memory keeps whatever the aborted call leaked, and any Rust state the
+ * call was mutating is left mid-flight. It does NOT invalidate the module, and
+ * it says nothing about other engine handles in the realm, let alone about
+ * other realms (each Worker instantiates its own `@ifc-lite/wasm`).
+ *
+ * So the recovery contract is:
+ *
+ *  - a trap taken inside an *operation* is the caller's failure. The bridge
+ *    that took it drops (and frees) its `IfcAPI` handle — that is where the
+ *    wedgeable per-load caches live — and the original trap propagates
+ *    unchanged. A later `init()`, on that bridge or any other, builds a fresh
+ *    handle and works.
+ *  - a trap taken while *initializing* means this realm could not produce a
+ *    working engine at all, and neither half of that is retryable in practice:
+ *    if the trap came from `new IfcAPI()` the module singleton is already built
+ *    and wasm-bindgen's `init()` will keep returning it, and if it came from
+ *    instantiation itself it is a deterministic module-level failure that
+ *    recurs. That is the only case that earns
+ *    {@link WASM_RUNTIME_UNRECOVERABLE_EVENT} — the user is told to reload,
+ *    which is the one thing that really does get a new instance.
+ *
+ * Even then nothing is latched: a later `init()` still tries, so the
+ * "unrecoverable" verdict is a diagnosis for the user, never a lock that could
+ * disable an unrelated consumer. Recovery is lazy — it happens on the next
+ * `init()` a consumer asks for — so there is no retry loop to bound either.
+ *
+ * Detection lives here as a pure, unit-testable predicate; the host app owns
+ * the reload policy and subscribes to the event. This library never reloads
+ * the page on its own — same division of labour as `wasm-asset-error.ts`.
+ */
+/**
+ * Stable marker in the message of the error thrown when the engine cannot be
+ * initialized after a trap. Kept in the message (not only in a field) so it
+ * survives the string-only round trip through error tracking, and so the host
+ * app can classify it without importing this package.
+ */
+export declare const WASM_RUNTIME_UNRECOVERABLE_CODE = "WASM_RUNTIME_UNRECOVERABLE";
+/**
+ * Dispatched on `globalThis` when the WebAssembly geometry engine trapped
+ * while initializing and therefore cannot be rebuilt in this document.
+ * `detail.message` carries the originating trap text. Hosts that opt in tell
+ * the user to reload; unlike the version-skew event this must NOT trigger an
+ * automatic reload — a crash mid-session would discard the user's work.
+ */
+export declare const WASM_RUNTIME_UNRECOVERABLE_EVENT = "ifclite:wasm-runtime-unrecoverable";
+/**
+ * True when `err` is a WebAssembly runtime trap.
+ *
+ * `instanceof WebAssembly.RuntimeError` alone is not enough: an error thrown
+ * inside a Worker/iframe realm and re-raised here fails the identity check
+ * because each realm has its own `WebAssembly.RuntimeError` constructor. The
+ * `.name` fallback is the cross-realm-safe half — `RuntimeError` is the class
+ * name the spec fixes for wasm traps, and structured-cloned errors keep it.
+ */
+export declare function isWasmRuntimeTrap(err: unknown): boolean;
+/**
+ * True for the typed error {@link wasmRuntimeUnrecoverableError} produces —
+ * matched on the message marker so it also works on an error that only
+ * survived as text (an analytics payload, a `postMessage` hop).
+ */
+export declare function isWasmRuntimeUnrecoverableError(err: unknown): boolean;
+/**
+ * Build the error thrown when the engine trapped while initializing.
+ *
+ * Constructed FRESH at every throw site on purpose. The bug this replaces
+ * stored one Error object in a module global and rethrew it forever, so the
+ * stack shipped to error tracking pointed at whichever call first trapped —
+ * the production report for #1898 showed a `exportGlb` stack captured under a
+ * model-load context, which made it undiagnosable. The underlying trap is kept
+ * verbatim in the message tail (for triage from text alone) and as `.cause`
+ * (for programmatic inspection), mirroring `largeFilePrepassError`.
+ */
+export declare function wasmRuntimeUnrecoverableError(cause: unknown, operation: string): Error;
+/**
+ * Broadcast {@link WASM_RUNTIME_UNRECOVERABLE_EVENT} on `globalThis` so an
+ * opted-in host can tell the user the engine is gone and offer a reload.
+ * No-op in non-DOM hosts such as Node (CLI/MCP), where the thrown error is the
+ * whole story.
+ */
+export declare function notifyWasmRuntimeUnrecoverable(err: unknown): void;
+//# sourceMappingURL=wasm-runtime-trap.d.ts.map

package/dist/wasm-runtime-trap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wasm-runtime-trap.d.ts","sourceRoot":"","sources":["../src/wasm-runtime-trap.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,+BAA+B,+BAA+B,CAAC;AAE5E;;;;;;GAMG;AACH,eAAO,MAAM,gCAAgC,uCAAuC,CAAC;AAYrF;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAIvD;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAErE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,KAAK,CAQtF;AAaD;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAUjE"}

package/dist/wasm-runtime-trap.js

@@ -0,0 +1,134 @@
+/* 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/. */
+/**
+ * Classify WebAssembly runtime traps and, for the one case that genuinely
+ * cannot be recovered in-document, broadcast it so the host can offer a reload
+ * (#1898).
+ *
+ * A trap is what reaches JS when the engine executes `unreachable`: with
+ * `panic = "abort"` (rust/Cargo.toml) a Rust panic, a failed `assert!` and an
+ * allocator abort are ALL indistinguishable from here — see the same caveat in
+ * `huge-file-error.ts`. What a trap can damage is bounded: the wasm instance's
+ * linear memory keeps whatever the aborted call leaked, and any Rust state the
+ * call was mutating is left mid-flight. It does NOT invalidate the module, and
+ * it says nothing about other engine handles in the realm, let alone about
+ * other realms (each Worker instantiates its own `@ifc-lite/wasm`).
+ *
+ * So the recovery contract is:
+ *
+ *  - a trap taken inside an *operation* is the caller's failure. The bridge
+ *    that took it drops (and frees) its `IfcAPI` handle — that is where the
+ *    wedgeable per-load caches live — and the original trap propagates
+ *    unchanged. A later `init()`, on that bridge or any other, builds a fresh
+ *    handle and works.
+ *  - a trap taken while *initializing* means this realm could not produce a
+ *    working engine at all, and neither half of that is retryable in practice:
+ *    if the trap came from `new IfcAPI()` the module singleton is already built
+ *    and wasm-bindgen's `init()` will keep returning it, and if it came from
+ *    instantiation itself it is a deterministic module-level failure that
+ *    recurs. That is the only case that earns
+ *    {@link WASM_RUNTIME_UNRECOVERABLE_EVENT} — the user is told to reload,
+ *    which is the one thing that really does get a new instance.
+ *
+ * Even then nothing is latched: a later `init()` still tries, so the
+ * "unrecoverable" verdict is a diagnosis for the user, never a lock that could
+ * disable an unrelated consumer. Recovery is lazy — it happens on the next
+ * `init()` a consumer asks for — so there is no retry loop to bound either.
+ *
+ * Detection lives here as a pure, unit-testable predicate; the host app owns
+ * the reload policy and subscribes to the event. This library never reloads
+ * the page on its own — same division of labour as `wasm-asset-error.ts`.
+ */
+/**
+ * Stable marker in the message of the error thrown when the engine cannot be
+ * initialized after a trap. Kept in the message (not only in a field) so it
+ * survives the string-only round trip through error tracking, and so the host
+ * app can classify it without importing this package.
+ */
+export const WASM_RUNTIME_UNRECOVERABLE_CODE = 'WASM_RUNTIME_UNRECOVERABLE';
+/**
+ * Dispatched on `globalThis` when the WebAssembly geometry engine trapped
+ * while initializing and therefore cannot be rebuilt in this document.
+ * `detail.message` carries the originating trap text. Hosts that opt in tell
+ * the user to reload; unlike the version-skew event this must NOT trigger an
+ * automatic reload — a crash mid-session would discard the user's work.
+ */
+export const WASM_RUNTIME_UNRECOVERABLE_EVENT = 'ifclite:wasm-runtime-unrecoverable';
+function messageOf(err) {
+    if (err == null)
+        return '';
+    if (typeof err === 'string')
+        return err;
+    if (typeof err === 'object' && 'message' in err) {
+        const m = err.message;
+        if (typeof m === 'string')
+            return m;
+    }
+    return String(err);
+}
+/**
+ * True when `err` is a WebAssembly runtime trap.
+ *
+ * `instanceof WebAssembly.RuntimeError` alone is not enough: an error thrown
+ * inside a Worker/iframe realm and re-raised here fails the identity check
+ * because each realm has its own `WebAssembly.RuntimeError` constructor. The
+ * `.name` fallback is the cross-realm-safe half — `RuntimeError` is the class
+ * name the spec fixes for wasm traps, and structured-cloned errors keep it.
+ */
+export function isWasmRuntimeTrap(err) {
+    if (typeof WebAssembly !== 'undefined' && err instanceof WebAssembly.RuntimeError)
+        return true;
+    if (typeof err !== 'object' || err === null)
+        return false;
+    return err.name === 'RuntimeError';
+}
+/**
+ * True for the typed error {@link wasmRuntimeUnrecoverableError} produces —
+ * matched on the message marker so it also works on an error that only
+ * survived as text (an analytics payload, a `postMessage` hop).
+ */
+export function isWasmRuntimeUnrecoverableError(err) {
+    return messageOf(err).includes(WASM_RUNTIME_UNRECOVERABLE_CODE);
+}
+/**
+ * Build the error thrown when the engine trapped while initializing.
+ *
+ * Constructed FRESH at every throw site on purpose. The bug this replaces
+ * stored one Error object in a module global and rethrew it forever, so the
+ * stack shipped to error tracking pointed at whichever call first trapped —
+ * the production report for #1898 showed a `exportGlb` stack captured under a
+ * model-load context, which made it undiagnosable. The underlying trap is kept
+ * verbatim in the message tail (for triage from text alone) and as `.cause`
+ * (for programmatic inspection), mirroring `largeFilePrepassError`.
+ */
+export function wasmRuntimeUnrecoverableError(cause, operation) {
+    const raw = messageOf(cause) || String(cause);
+    return new Error(`${WASM_RUNTIME_UNRECOVERABLE_CODE}: the IFC-Lite WebAssembly geometry engine trapped during ` +
+        `${operation}, so this document has no working engine instance. Reload the page to get a ` +
+        `fresh one. (underlying wasm trap: ${raw})`, { cause });
+}
+function domDispatcher() {
+    const g = globalThis;
+    return typeof g.dispatchEvent === 'function' && typeof g.CustomEvent === 'function'
+        ? g
+        : null;
+}
+/**
+ * Broadcast {@link WASM_RUNTIME_UNRECOVERABLE_EVENT} on `globalThis` so an
+ * opted-in host can tell the user the engine is gone and offer a reload.
+ * No-op in non-DOM hosts such as Node (CLI/MCP), where the thrown error is the
+ * whole story.
+ */
+export function notifyWasmRuntimeUnrecoverable(err) {
+    const target = domDispatcher();
+    if (!target)
+        return;
+    try {
+        target.dispatchEvent(new CustomEvent(WASM_RUNTIME_UNRECOVERABLE_EVENT, { detail: { message: messageOf(err) } }));
+    }
+    catch {
+        /* CustomEvent unavailable — best effort, nothing more to do */
+    }
+}
+//# sourceMappingURL=wasm-runtime-trap.js.map

package/dist/wasm-runtime-trap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wasm-runtime-trap.js","sourceRoot":"","sources":["../src/wasm-runtime-trap.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,4BAA4B,CAAC;AAE5E;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,oCAAoC,CAAC;AAErF,SAAS,SAAS,CAAC,GAAY;IAC7B,IAAI,GAAG,IAAI,IAAI;QAAE,OAAO,EAAE,CAAC;IAC3B,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IACxC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,SAAS,IAAI,GAAG,EAAE,CAAC;QAChD,MAAM,CAAC,GAAI,GAA6B,CAAC,OAAO,CAAC;QACjD,IAAI,OAAO,CAAC,KAAK,QAAQ;YAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;AACrB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAY;IAC5C,IAAI,OAAO,WAAW,KAAK,WAAW,IAAI,GAAG,YAAY,WAAW,CAAC,YAAY;QAAE,OAAO,IAAI,CAAC;IAC/F,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC1D,OAAQ,GAA0B,CAAC,IAAI,KAAK,cAAc,CAAC;AAC7D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,+BAA+B,CAAC,GAAY;IAC1D,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,+BAA+B,CAAC,CAAC;AAClE,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,6BAA6B,CAAC,KAAc,EAAE,SAAiB;IAC7E,MAAM,GAAG,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9C,OAAO,IAAI,KAAK,CACd,GAAG,+BAA+B,4DAA4D;QAC5F,GAAG,SAAS,8EAA8E;QAC1F,qCAAqC,GAAG,GAAG,EAC7C,EAAE,KAAK,EAAE,CACV,CAAC;AACJ,CAAC;AAMD,SAAS,aAAa;IACpB,MAAM,CAAC,GAAG,UAA2E,CAAC;IACtF,OAAO,OAAO,CAAC,CAAC,aAAa,KAAK,UAAU,IAAI,OAAO,CAAC,CAAC,WAAW,KAAK,UAAU;QACjF,CAAC,CAAE,CAAmB;QACtB,CAAC,CAAC,IAAI,CAAC;AACX,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,8BAA8B,CAAC,GAAY;IACzD,MAAM,MAAM,GAAG,aAAa,EAAE,CAAC;IAC/B,IAAI,CAAC,MAAM;QAAE,OAAO;IACpB,IAAI,CAAC;QACH,MAAM,CAAC,aAAa,CAClB,IAAI,WAAW,CAAC,gCAAgC,EAAE,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAC3F,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,+DAA+D;IACjE,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ifc-lite/geometry",
-  "version": "3.4.0",
+  "version": "3.6.0",
   "description": "Geometry processing bridge for IFC-Lite - exact-arithmetic CSG, streamed across workers",
   "type": "module",
   "main": "./dist/index.js",
@@ -13,8 +13,8 @@
     }
   },
   "dependencies": {
-    "@ifc-lite/data": "^2.8.0",
-    "@ifc-lite/wasm": "^4.1.4"
+    "@ifc-lite/data": "^3.2.0",
+    "@ifc-lite/wasm": "^4.3.0"
   },
   "optionalDependencies": {
     "@tauri-apps/api": "^2.11.1"