@ifc-lite/parser 5.1.0 → 6.1.0

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;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"}
+{"version":3,"file":"wasm-init-retry.d.ts","sourceRoot":"","sources":["../src/wasm-init-retry.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,KAAK,oBAAoB,GAC1B,MAAM,0BAA0B,CAAC"}

package/dist/wasm-init-retry.js

@@ -2,105 +2,12 @@
  * 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/. */
 /**
- * Resilient one-shot retry around wasm-bindgen's `init()`.
+ * Re-export of the shared WASM load-retry classification (issue #4247).
  *
- * wasm-bindgen's streaming loader rethrows on a non-OK HTTP status or a failed
- * fetch of `ifc-lite_bg.wasm` (it only falls back to `arrayBuffer`+`instantiate`
- * for the wrong-MIME case), surfacing as `TypeError: Failed to execute
- * 'compile' on 'WebAssembly': HTTP status code is not ok`. A transient blip — a
- * cold CDN edge, a mid-deploy race, a flaky proxy/antivirus — can produce a
- * one-off failure that a second attempt recovers.
- *
- * Extracted from the worker so it is unit-testable without a real wasm bundle.
- */
-/**
- * True when `message` looks like a transient transport/download failure of the
- * engine binary (worth one retry) rather than a genuine corrupt-module or
- * validation error (which must propagate immediately so real bugs aren't
- * masked).
- *
- * Per the WebAssembly Web API, the streaming loader validates the HTTP response
- * (status, MIME, CORS) and rejects with a `TypeError` BEFORE compiling, so only
- * those transport failures are retry-worthy. Invalid bytes (corrupt module,
- * wrong magic header) reject with a `CompileError` — retrying just refetches
- * the same bad bytes, so those fail fast.
- */
-export function isTransientWasmLoadError(message) {
-    // Fail fast on genuine module-validation errors even if a transport-ish word
-    // somehow appears in the message.
-    if (/compileerror|validation error|magic (?:word|number)|invalid (?:wasm|module)/i.test(message)) {
-        return false;
-    }
-    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 — 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).
+ * The real implementation lives in `@ifc-lite/wasm-lifecycle` so
+ * `@ifc-lite/geometry` and `@ifc-lite/parser` share exactly one copy of the
+ * transient-vs-fatal WASM load-failure logic instead of maintaining two
+ * independently-editable "twin" files.
  */
-export async function initWasmWithRetry(init, options = {}) {
-    const { retryDelayMs = 300, sleep = defaultSleep, warn = console.warn, label = 'wasm' } = options;
-    try {
-        await init();
-        return;
-    }
-    catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
-        if (!isTransientWasmLoadError(msg))
-            throw err;
-        warn(`[${label}] WASM engine load failed (${msg}); retrying once`);
-        await sleep(retryDelayMs);
-        try {
-            await init();
-        }
-        catch (retryErr) {
-            throw attributeEngineLoadFailure(retryErr, label);
-        }
-    }
-}
+export { initWasmWithRetry, isTransientWasmLoadError, } from '@ifc-lite/wasm-lifecycle';
 //# 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;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"}
+{"version":3,"file":"wasm-init-retry.js","sourceRoot":"","sources":["../src/wasm-init-retry.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D;;;;;;;GAOG;AACH,OAAO,EACL,iBAAiB,EACjB,wBAAwB,GAEzB,MAAM,0BAA0B,CAAC"}

package/dist/wasm-panic-forward.d.ts

@@ -1,67 +1,11 @@
 /**
- * Forward a worker realm's wasm panic-location stash to the main thread
- * (#2527 follow-up).
+ * Re-export of the shared worker-to-main-thread wasm panic-location forwarder
+ * (issue #4247).
  *
- * The Rust panic hook (`rust/wasm-bindings/src/utils.rs`) stashes
- * `{ location, at }` on whichever realm's JS global it runs in — `self` in a
- * worker, `window` on the main thread. #2527 taught the main thread to read
- * its OWN global's stash and attach it to a trap's exception event
- * (`apps/viewer/src/lib/analytics-scrub.ts`'s `attachWasmPanicLocation`), but
- * a worker-realm trap leaves that stash stranded in the worker's global,
- * which the main thread can never see across the realm boundary.
- *
- * `takeWasmPanicStash` reads + consumes the stash worker-side so it can ride
- * the worker's own `{type:'error'}` message; `restashWasmPanicLocation`
- * re-plants it on the main thread's global so the EXISTING #2527 gate (same
- * key, same TTL, same consume-once semantics) picks it up unmodified.
- *
- * Location only, never the panic's message — the message can embed
- * model-derived text (see `utils.rs`'s privacy contract); the location alone
- * travels on the error message and through this module.
- *
- * NOTE: this file is intentionally byte-identical to
- * `packages/geometry/src/wasm-panic-forward.ts` — both `@ifc-lite/geometry`
- * and `@ifc-lite/parser` need the exact same realm-forwarding contract, and
- * neither package depends on the other (nor is `@ifc-lite/wasm`, the one
- * package both DO depend on, a safe home: it ships only the wasm-pack build
- * output, with no TypeScript build step of its own, and `test`/`typecheck`
- * for either consumer already runs its build via turbo's `^build` — adding a
- * hand-written TS module there would make every geometry/parser test run
- * gate on a full Rust→wasm rebuild). Keep any change to one copy in lockstep
- * with the other; `wasm-panic-forward.test.ts` is duplicated the same way.
- */
-/** Kept in lockstep with `PANIC_STASH_KEY` in `rust/wasm-bindings/src/utils.rs`,
- *  `WASM_PANIC_STASH_KEY` in `apps/viewer/src/lib/analytics-scrub.ts`, and this
- *  module's twin at `packages/geometry/src/wasm-panic-forward.ts`. */
-export declare const WASM_PANIC_STASH_KEY = "__ifclite_wasm_panic";
-export interface WasmPanicStash {
-    location: string;
-    at: number;
-}
-/**
- * Worker-side: read and CONSUME this realm's panic stash so it can be
- * forwarded on the worker's own error message. Consume-once regardless of
- * shape validity — an unconsumed malformed stash must not linger to
- * mislabel a later trap, mirroring the main-thread gate's own rule.
- */
-export declare function takeWasmPanicStash(realm: object): WasmPanicStash | undefined;
-/**
- * Main-side: re-plant a worker-forwarded stash on this realm's global so the
- * existing #2527 `attachWasmPanicLocation` gate consumes it unmodified.
- *
- * Gated on `errorMessage` looking like a wasm trap: the worker forwards
- * `wasmPanicLocation`/`wasmPanicAt` on ANY `{type:'error'}` message (a stale
- * stash from an earlier suppressed panic can ride out on an ordinary,
- * non-trap worker error), and re-planting unconditionally would let that
- * stale location sit on `globalThis` until an unrelated trap-shaped
- * exception consumed it — mislabeling that trap. Only a message that itself
- * looks like a wasm trap is allowed to re-plant.
- *
- * Never clobbers an existing, unconsumed stash — a genuine main-thread trap
- * that hasn't been captured yet must win over a worker trap that merely
- * arrived first (the older-looking stash, if stale, is simply dropped later
- * by the TTL check at attach time; this function never overwrites either
- * way).
+ * The real implementation lives in `@ifc-lite/wasm-lifecycle` so
+ * `@ifc-lite/geometry` and `@ifc-lite/parser` share exactly one copy of the
+ * #2527 realm-forwarding contract instead of maintaining two
+ * independently-editable "twin" files.
  */
-export declare function restashWasmPanicLocation(realm: object, location: unknown, at: unknown, errorMessage: string): void;
+export { WASM_PANIC_STASH_KEY, takeWasmPanicStash, restashWasmPanicLocation, type WasmPanicStash, } from '@ifc-lite/wasm-lifecycle';
 //# sourceMappingURL=wasm-panic-forward.d.ts.map

package/dist/wasm-panic-forward.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wasm-panic-forward.d.ts","sourceRoot":"","sources":["../src/wasm-panic-forward.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH;;sEAEsE;AACtE,eAAO,MAAM,oBAAoB,yBAAyB,CAAC;AAgB3D,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;CACZ;AAeD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAK5E;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,OAAO,EACjB,EAAE,EAAE,OAAO,EACX,YAAY,EAAE,MAAM,GACnB,IAAI,CAON"}
+{"version":3,"file":"wasm-panic-forward.d.ts","sourceRoot":"","sources":["../src/wasm-panic-forward.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AACH,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,wBAAwB,EACxB,KAAK,cAAc,GACpB,MAAM,0BAA0B,CAAC"}

package/dist/wasm-panic-forward.js

@@ -2,106 +2,13 @@
  * 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/. */
 /**
- * Forward a worker realm's wasm panic-location stash to the main thread
- * (#2527 follow-up).
+ * Re-export of the shared worker-to-main-thread wasm panic-location forwarder
+ * (issue #4247).
  *
- * The Rust panic hook (`rust/wasm-bindings/src/utils.rs`) stashes
- * `{ location, at }` on whichever realm's JS global it runs in — `self` in a
- * worker, `window` on the main thread. #2527 taught the main thread to read
- * its OWN global's stash and attach it to a trap's exception event
- * (`apps/viewer/src/lib/analytics-scrub.ts`'s `attachWasmPanicLocation`), but
- * a worker-realm trap leaves that stash stranded in the worker's global,
- * which the main thread can never see across the realm boundary.
- *
- * `takeWasmPanicStash` reads + consumes the stash worker-side so it can ride
- * the worker's own `{type:'error'}` message; `restashWasmPanicLocation`
- * re-plants it on the main thread's global so the EXISTING #2527 gate (same
- * key, same TTL, same consume-once semantics) picks it up unmodified.
- *
- * Location only, never the panic's message — the message can embed
- * model-derived text (see `utils.rs`'s privacy contract); the location alone
- * travels on the error message and through this module.
- *
- * NOTE: this file is intentionally byte-identical to
- * `packages/geometry/src/wasm-panic-forward.ts` — both `@ifc-lite/geometry`
- * and `@ifc-lite/parser` need the exact same realm-forwarding contract, and
- * neither package depends on the other (nor is `@ifc-lite/wasm`, the one
- * package both DO depend on, a safe home: it ships only the wasm-pack build
- * output, with no TypeScript build step of its own, and `test`/`typecheck`
- * for either consumer already runs its build via turbo's `^build` — adding a
- * hand-written TS module there would make every geometry/parser test run
- * gate on a full Rust→wasm rebuild). Keep any change to one copy in lockstep
- * with the other; `wasm-panic-forward.test.ts` is duplicated the same way.
- */
-/** Kept in lockstep with `PANIC_STASH_KEY` in `rust/wasm-bindings/src/utils.rs`,
- *  `WASM_PANIC_STASH_KEY` in `apps/viewer/src/lib/analytics-scrub.ts`, and this
- *  module's twin at `packages/geometry/src/wasm-panic-forward.ts`. */
-export const WASM_PANIC_STASH_KEY = '__ifclite_wasm_panic';
-/**
- * Trap-shape text match, kept in lockstep with `WASM_TRAP_TEXT` in
- * `apps/viewer/src/lib/analytics-scrub.ts` and this module's twin at
- * `packages/geometry/src/wasm-panic-forward.ts`. Deliberately excludes bare
- * "unreachable" inside network-failure phrasing ("network is unreachable",
- * "host unreachable") — those are not wasm traps.
- */
-const WASM_TRAP_TEXT = /(?<!network is |host |destination |address )\bunreachable\b|\bRuntimeError\b|memory access out of bounds|index out of bounds|indirect call to null|integer (?:overflow|divide by zero)|call stack exhausted/i;
-function looksLikeWasmTrap(message) {
-    return WASM_TRAP_TEXT.test(message);
-}
-/** Validate + narrow an unknown stash value read off a realm global. */
-function readStashShape(value) {
-    if (typeof value !== 'object' || value === null)
-        return undefined;
-    const { location, at } = value;
-    if (typeof location !== 'string' || location === '')
-        return undefined;
-    // Reject non-finite (`NaN`/`Infinity`) and future timestamps — both pass
-    // the analytics TTL gate's `Date.now() - at <= TTL` check trivially
-    // (`Infinity` makes the delta `-Infinity`; a future `at` makes it
-    // negative), which would let a malformed stash label a later trap.
-    if (typeof at !== 'number' || !Number.isFinite(at) || at > Date.now())
-        return undefined;
-    return { location, at };
-}
-/**
- * Worker-side: read and CONSUME this realm's panic stash so it can be
- * forwarded on the worker's own error message. Consume-once regardless of
- * shape validity — an unconsumed malformed stash must not linger to
- * mislabel a later trap, mirroring the main-thread gate's own rule.
- */
-export function takeWasmPanicStash(realm) {
-    const g = realm;
-    const raw = g[WASM_PANIC_STASH_KEY];
-    delete g[WASM_PANIC_STASH_KEY];
-    return readStashShape(raw);
-}
-/**
- * Main-side: re-plant a worker-forwarded stash on this realm's global so the
- * existing #2527 `attachWasmPanicLocation` gate consumes it unmodified.
- *
- * Gated on `errorMessage` looking like a wasm trap: the worker forwards
- * `wasmPanicLocation`/`wasmPanicAt` on ANY `{type:'error'}` message (a stale
- * stash from an earlier suppressed panic can ride out on an ordinary,
- * non-trap worker error), and re-planting unconditionally would let that
- * stale location sit on `globalThis` until an unrelated trap-shaped
- * exception consumed it — mislabeling that trap. Only a message that itself
- * looks like a wasm trap is allowed to re-plant.
- *
- * Never clobbers an existing, unconsumed stash — a genuine main-thread trap
- * that hasn't been captured yet must win over a worker trap that merely
- * arrived first (the older-looking stash, if stale, is simply dropped later
- * by the TTL check at attach time; this function never overwrites either
- * way).
+ * The real implementation lives in `@ifc-lite/wasm-lifecycle` so
+ * `@ifc-lite/geometry` and `@ifc-lite/parser` share exactly one copy of the
+ * #2527 realm-forwarding contract instead of maintaining two
+ * independently-editable "twin" files.
  */
-export function restashWasmPanicLocation(realm, location, at, errorMessage) {
-    const stash = readStashShape({ location, at });
-    if (!stash)
-        return;
-    if (!looksLikeWasmTrap(errorMessage))
-        return;
-    const g = realm;
-    if (g[WASM_PANIC_STASH_KEY] !== undefined)
-        return;
-    g[WASM_PANIC_STASH_KEY] = stash;
-}
+export { WASM_PANIC_STASH_KEY, takeWasmPanicStash, restashWasmPanicLocation, } from '@ifc-lite/wasm-lifecycle';
 //# sourceMappingURL=wasm-panic-forward.js.map

package/dist/wasm-panic-forward.js.map

@@ -1 +1 @@
-{"version":3,"file":"wasm-panic-forward.js","sourceRoot":"","sources":["../src/wasm-panic-forward.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH;;sEAEsE;AACtE,MAAM,CAAC,MAAM,oBAAoB,GAAG,sBAAsB,CAAC;AAE3D;;;;;;GAMG;AACH,MAAM,cAAc,GAClB,8MAA8M,CAAC;AAEjN,SAAS,iBAAiB,CAAC,OAAe;IACxC,OAAO,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACtC,CAAC;AAOD,wEAAwE;AACxE,SAAS,cAAc,CAAC,KAAc;IACpC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAClE,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE,GAAG,KAA6C,CAAC;IACvE,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IACtE,yEAAyE;IACzE,oEAAoE;IACpE,kEAAkE;IAClE,mEAAmE;IACnE,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE;QAAE,OAAO,SAAS,CAAC;IACxF,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;AAC1B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,MAAM,GAAG,GAAG,CAAC,CAAC,oBAAoB,CAAC,CAAC;IACpC,OAAO,CAAC,CAAC,oBAAoB,CAAC,CAAC;IAC/B,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC;AAC7B,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,wBAAwB,CACtC,KAAa,EACb,QAAiB,EACjB,EAAW,EACX,YAAoB;IAEpB,MAAM,KAAK,GAAG,cAAc,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;IAC/C,IAAI,CAAC,KAAK;QAAE,OAAO;IACnB,IAAI,CAAC,iBAAiB,CAAC,YAAY,CAAC;QAAE,OAAO;IAC7C,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,IAAI,CAAC,CAAC,oBAAoB,CAAC,KAAK,SAAS;QAAE,OAAO;IAClD,CAAC,CAAC,oBAAoB,CAAC,GAAG,KAAK,CAAC;AAClC,CAAC"}
+{"version":3,"file":"wasm-panic-forward.js","sourceRoot":"","sources":["../src/wasm-panic-forward.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D;;;;;;;;GAQG;AACH,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,wBAAwB,GAEzB,MAAM,0BAA0B,CAAC"}

package/dist/worker-index-publication.d.ts

@@ -0,0 +1,43 @@
+import type { IfcDataStore } from './columnar-parser.js';
+import { type CompactEntityIndexColumns } from './compact-entity-index-transport.js';
+import { type DataStoreTransport } from './data-store-transport.js';
+import type { IfcSourceBytes } from './source-bytes.js';
+interface PackedIndex {
+    format: 'packed-index-v1';
+    byId: CompactEntityIndexColumns;
+    names: string[];
+    offsets: Uint32Array;
+    ids: Uint32Array | Float64Array;
+}
+interface IndexReference {
+    format: 'published-index-v1';
+}
+export type WorkerStorePayload = Omit<DataStoreTransport, 'entityIndex'> & {
+    entityIndex: DataStoreTransport['entityIndex'] | PackedIndex | IndexReference;
+};
+/** #3985: canonical parser primary columns/byType are immutable after the
+ * spatial callback. Deferred atoms get a separate final index. This publisher
+ * must not be used by a producer that edits published numeric columns in place.
+ * Public receiver arrays and LRU entries are never the retained wire seed.
+ */
+export declare class WorkerIndexPublisher {
+    private readonly enabled;
+    private published?;
+    constructor(enabled: boolean);
+    serialize(store: IfcDataStore, final: boolean): {
+        payload: WorkerStorePayload;
+        transfers: Transferable[];
+        transportBytes: number;
+    };
+    /** Call only after the partial postMessage succeeds. */
+    publishedPartial(store: IfcDataStore): void;
+}
+/** One instance per parse request, never a federation/global cache. */
+export declare class WorkerIndexReceiver {
+    private seed?;
+    capturePartial(payload: WorkerStorePayload): void;
+    hydrate(payload: WorkerStorePayload, source: IfcSourceBytes): IfcDataStore;
+    clear(): void;
+}
+export {};
+//# sourceMappingURL=worker-index-publication.d.ts.map

package/dist/worker-index-publication.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-index-publication.d.ts","sourceRoot":"","sources":["../src/worker-index-publication.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,OAAO,EAA+B,KAAK,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AAClH,OAAO,EAAiD,KAAK,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACnH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,UAAU,WAAW;IACnB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,IAAI,EAAE,yBAAyB,CAAC;IAChC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,WAAW,CAAC;IACrB,GAAG,EAAE,WAAW,GAAG,YAAY,CAAC;CACjC;AACD,UAAU,cAAc;IAAG,MAAM,EAAE,oBAAoB,CAAA;CAAE;AACzD,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,kBAAkB,EAAE,aAAa,CAAC,GAAG;IACzE,WAAW,EAAE,kBAAkB,CAAC,aAAa,CAAC,GAAG,WAAW,GAAG,cAAc,CAAC;CAC/E,CAAC;AA2BF;;;;GAIG;AACH,qBAAa,oBAAoB;IAOnB,OAAO,CAAC,QAAQ,CAAC,OAAO;IANpC,OAAO,CAAC,SAAS,CAAC,CAIhB;gBAE2B,OAAO,EAAE,OAAO;IAE7C,SAAS,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,GAAG;QAAE,OAAO,EAAE,kBAAkB,CAAC;QAAC,SAAS,EAAE,YAAY,EAAE,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE;IAwClI,wDAAwD;IACxD,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;CAQ5C;AAED,uEAAuE;AACvE,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,IAAI,CAAC,CAAc;IAE3B,cAAc,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAMjD,OAAO,CAAC,OAAO,EAAE,kBAAkB,EAAE,MAAM,EAAE,cAAc,GAAG,YAAY;IAsB1E,KAAK,IAAI,IAAI;CACd"}

package/dist/worker-index-publication.js

@@ -0,0 +1,129 @@
+/* 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 { CompactEntityIndex } from './compact-entity-index.js';
+import { compactEntityIndexToColumns } from './compact-entity-index-transport.js';
+import { fromTransport, toTransport, transportByteSize } from './data-store-transport.js';
+function packIndex(store, byId) {
+    const entries = [...store.entityIndex.byType];
+    let count = 0;
+    let u32 = true;
+    for (const [, values] of entries) {
+        count += values.length;
+        for (const id of values) {
+            if (!Number.isInteger(id) || id < 0 || id > 0xffffffff || Object.is(id, -0))
+                u32 = false;
+        }
+    }
+    if (count > 0xffffffff)
+        throw new Error('Packed byType index exceeds u32 offset capacity');
+    // Arbitrary number[] producers retain their numbers, including NaN/-0 and
+    // IDs above u32. Canonical parser IDs use the compact representation.
+    const ids = u32 ? new Uint32Array(count) : new Float64Array(count);
+    const offsets = new Uint32Array(entries.length + 1);
+    let offset = 0;
+    for (let i = 0; i < entries.length; i++) {
+        offsets[i] = offset;
+        ids.set(entries[i][1], offset);
+        offset += entries[i][1].length;
+    }
+    offsets[entries.length] = offset;
+    return { format: 'packed-index-v1', byId, names: entries.map(([name]) => name), offsets, ids };
+}
+/** #3985: canonical parser primary columns/byType are immutable after the
+ * spatial callback. Deferred atoms get a separate final index. This publisher
+ * must not be used by a producer that edits published numeric columns in place.
+ * Public receiver arrays and LRU entries are never the retained wire seed.
+ */
+export class WorkerIndexPublisher {
+    enabled;
+    published;
+    constructor(enabled) {
+        this.enabled = enabled;
+    }
+    serialize(store, final) {
+        // TODO(remove-by: all supported parser-worker clients negotiate packed-index-v1, parser maintainers), #3985.
+        if (!this.enabled) {
+            const envelope = toTransport(store);
+            return { ...envelope, transfers: final ? envelope.transfers : [], transportBytes: transportByteSize(envelope.payload) };
+        }
+        if (!(store.entityIndex.byId instanceof CompactEntityIndex)) {
+            throw new Error('Worker publication requires CompactEntityIndex');
+        }
+        const byId = compactEntityIndexToColumns(store.entityIndex.byId);
+        const previous = this.published;
+        const entries = [...store.entityIndex.byType];
+        const reference = final && previous && previous.index === store.entityIndex
+            && previous.columns.expressIds === byId.expressIds
+            && previous.columns.byteOffsets === byId.byteOffsets
+            && previous.columns.byteLengths === byId.byteLengths
+            && previous.columns.typeIndices === byId.typeIndices
+            && previous.columns.typeStrings.length === byId.typeStrings.length
+            && previous.columns.typeStrings.every((name, i) => name === byId.typeStrings[i])
+            && previous.entries.length === store.entityIndex.byType.size
+            && previous.entries.every(([name, values, length], i) => entries[i][0] === name && entries[i][1] === values && values.length === length);
+        const envelope = toTransport(store, { byId, byType: [] });
+        const entityIndex = reference
+            ? { format: 'published-index-v1' } : packIndex(store, byId);
+        const primaryBuffers = new Set([
+            byId.expressIds.buffer, byId.byteOffsets.buffer, byId.byteLengths.buffer, byId.typeIndices.buffer,
+        ]);
+        // #3985: even a referenced index keeps its original ABs in this final
+        // transfer list. Unreachable transfers detach/dispose worker ownership at
+        // successful publication, without adding another main-thread index.
+        // This does not promise when the browser reclaims physical backing.
+        const transfers = final ? envelope.transfers : [];
+        if (entityIndex.format === 'packed-index-v1')
+            transfers.push(entityIndex.ids.buffer, entityIndex.offsets.buffer);
+        // Count reachable payload bytes, excluding detached disposal-only backing.
+        const transportBytes = transportByteSize(envelope.payload)
+            - (reference ? [...primaryBuffers].reduce((sum, buffer) => sum + (buffer instanceof ArrayBuffer ? buffer.byteLength : 0), 0) : 0)
+            + (entityIndex.format === 'packed-index-v1' ? entityIndex.ids.byteLength + entityIndex.offsets.byteLength : 0);
+        return { payload: { ...envelope.payload, entityIndex }, transfers, transportBytes };
+    }
+    /** Call only after the partial postMessage succeeds. */
+    publishedPartial(store) {
+        if (!this.enabled || !(store.entityIndex.byId instanceof CompactEntityIndex))
+            return;
+        this.published = {
+            index: store.entityIndex,
+            columns: compactEntityIndexToColumns(store.entityIndex.byId),
+            entries: [...store.entityIndex.byType].map(([name, values]) => [name, values, values.length]),
+        };
+    }
+}
+/** One instance per parse request, never a federation/global cache. */
+export class WorkerIndexReceiver {
+    seed;
+    capturePartial(payload) {
+        if ('format' in payload.entityIndex && payload.entityIndex.format === 'packed-index-v1') {
+            this.seed = payload.entityIndex;
+        }
+    }
+    hydrate(payload, source) {
+        const index = payload.entityIndex;
+        if (!('format' in index))
+            return fromTransport({ ...payload, entityIndex: index }, source);
+        const packed = index.format === 'published-index-v1' ? this.seed : index;
+        if (!packed)
+            throw new Error('Final parser index references a missing partial publication');
+        if (packed.offsets.length !== packed.names.length + 1 || packed.offsets[0] !== 0
+            || packed.offsets[packed.names.length] !== packed.ids.length) {
+            throw new Error('Invalid packed parser index offsets');
+        }
+        const byType = new Map();
+        for (let i = 0; i < packed.names.length; i++) {
+            const start = packed.offsets[i], end = packed.offsets[i + 1];
+            if (end < start || end > packed.ids.length || byType.has(packed.names[i])) {
+                throw new Error('Invalid packed parser index range or duplicate type');
+            }
+            const values = new Array(end - start);
+            for (let row = start; row < end; row++)
+                values[row - start] = packed.ids[row];
+            byType.set(packed.names[i], values);
+        }
+        return fromTransport({ ...payload, entityIndex: { byId: packed.byId, byType: [] } }, source, byType);
+    }
+    clear() { this.seed = undefined; }
+}
+//# sourceMappingURL=worker-index-publication.js.map

package/dist/worker-index-publication.js.map

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

package/dist/worker-parser.d.ts

@@ -8,7 +8,8 @@
  *   2. Caller constructs a `WorkerParser` and calls `parseColumnar(sab, …)`.
  *   3. The worker emits `progress`, `diagnostic`, optional `partial-store`,
  *      then `complete` (or `error`). This wrapper resolves the returned
- *      Promise on `complete` and self-terminates afterward.
+ *      Promise after receiving `complete` and hydrating the result. The
+ *      completed worker is terminated before receiver reconstruction.
  *
  * On `partial-store` the wrapper invokes `options.onSpatialReady` so the
  * viewer can render the spatial-hierarchy panel before the full parse
@@ -16,8 +17,10 @@
  */
 import type { IfcDataStore } from './columnar-parser.js';
 import type { ParseOptions } from './index.js';
-import { type ParserMemorySnapshot } from './data-store-transport.js';
+import type { ParserMemorySnapshot } from './data-store-transport.js';
 export interface WorkerParserOptions extends ParseOptions {
+    /** Fresh per-request 16-byte prepass fingerprint cell; never awaited. */
+    sourceFingerprint?: SharedArrayBuffer;
     /** Override the worker URL. Default: bundler-resolved `parser.worker.ts`. */
     workerUrl?: URL | string;
     /** Optional callback receiving the per-parse memory snapshot at completion. */

package/dist/worker-parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"worker-parser.d.ts","sourceRoot":"","sources":["../src/worker-parser.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,2BAA2B,CAAC;AAQnC,MAAM,WAAW,mBAAoB,SAAQ,YAAY;IACvD,6EAA6E;IAC7E,SAAS,CAAC,EAAE,GAAG,GAAG,MAAM,CAAC;IACzB,+EAA+E;IAC/E,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,oBAAoB,KAAK,IAAI,CAAC;IAC5D;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsB;IAChD;;;;OAIG;IACH,OAAO,CAAC,iBAAiB,CAMT;IAEhB;;;;;;;OAOG;IACH,MAAM,CAAC,WAAW,IAAI,OAAO;gBAOjB,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,GAAG,GAAG,MAAM,CAAA;KAAO;IAQtD;;;;;;OAMG;IACH,aAAa,CAAC,MAAM,EAAE,iBAAiB,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,YAAY,CAAC;IAoKlG;;;;;;;;;;;;;;;OAeG;IACH,cAAc,CACZ,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,WAAW,EACpB,gBAAgB,CAAC,EAAE,MAAM,EACzB,oBAAoB,CAAC,EAAE,MAAM,GAC5B,IAAI;IAmBP,gEAAgE;IAChE,SAAS,IAAI,IAAI;CAMlB"}
+{"version":3,"file":"worker-parser.d.ts","sourceRoot":"","sources":["../src/worker-parser.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAQtE,MAAM,WAAW,mBAAoB,SAAQ,YAAY;IACvD,yEAAyE;IACzE,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,6EAA6E;IAC7E,SAAS,CAAC,EAAE,GAAG,GAAG,MAAM,CAAC;IACzB,+EAA+E;IAC/E,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,oBAAoB,KAAK,IAAI,CAAC;IAC5D;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsB;IAChD;;;;OAIG;IACH,OAAO,CAAC,iBAAiB,CAMT;IAEhB;;;;;;;OAOG;IACH,MAAM,CAAC,WAAW,IAAI,OAAO;gBAOjB,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,GAAG,GAAG,MAAM,CAAA;KAAO;IAQtD;;;;;;OAMG;IACH,aAAa,CAAC,MAAM,EAAE,iBAAiB,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,YAAY,CAAC;IA0KlG;;;;;;;;;;;;;;;OAeG;IACH,cAAc,CACZ,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,WAAW,EACpB,gBAAgB,CAAC,EAAE,MAAM,EACzB,oBAAoB,CAAC,EAAE,MAAM,GAC5B,IAAI;IAmBP,gEAAgE;IAChE,SAAS,IAAI,IAAI;CAUlB"}

package/dist/worker-parser.js

@@ -1,7 +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 { fromTransport, } from './data-store-transport.js';
+import { WorkerIndexReceiver } from './worker-index-publication.js';
 import { contiguousSourceBytes } from './source-bytes.js';
 import { restashWasmPanicLocation } from './wasm-panic-forward.js';
 export class WorkerParser {
@@ -71,13 +71,15 @@ export class WorkerParser {
             // memoising on the shared Uint8Array; sharing the accessor is the same
             // guarantee without the side table.
             let sourceBytes;
+            const indexReceiver = new WorkerIndexReceiver();
             const hydrate = (payload) => {
                 // #3983: the worker hashes the source before the first UI publication.
                 // Retain one accessor across partial/full stores and compression swaps.
                 sourceBytes ??= contiguousSourceBytes(new Uint8Array(source), payload.sourceContentKey ?? undefined);
-                return fromTransport(payload, sourceBytes);
+                return indexReceiver.hydrate(payload, sourceBytes);
             };
             const settle = (cleanup) => {
+                indexReceiver.clear();
                 worker.onmessage = null;
                 worker.onerror = null;
                 worker.onmessageerror = null;
@@ -95,9 +97,10 @@ export class WorkerParser {
                         options.onDiagnostic?.(msg.message);
                         return;
                     case 'partial-store': {
-                        if (!options.onSpatialReady)
-                            return;
                         try {
+                            indexReceiver.capturePartial(msg.payload);
+                            if (!options.onSpatialReady)
+                                return;
                             const partial = hydrate(msg.payload);
                             options.onSpatialReady(partial);
                         }
@@ -110,18 +113,21 @@ export class WorkerParser {
                     }
                     case 'complete': {
                         try {
+                            // #3985: the received message owns its transferred columns. Stop
+                            // the completed sender before allocating receiver collections;
+                            // retain indexReceiver's partial seed until hydration completes.
+                            worker.terminate();
+                            if (this.worker === worker)
+                                this.worker = null;
                             const dataStore = hydrate(msg.payload);
                             options.onMemorySnapshot?.(msg.memory);
-                            settle(() => {
-                                worker.terminate();
-                                this.worker = null;
-                            });
+                            settle(() => { });
                             resolve(dataStore);
                         }
                         catch (err) {
                             settle(() => {
-                                worker.terminate();
-                                this.worker = null;
+                                if (this.worker === worker)
+                                    this.worker = null;
                             });
                             reject(new Error(`complete hydrate failed: ${err instanceof Error ? err.message : String(err)}`));
                         }
@@ -178,6 +184,8 @@ export class WorkerParser {
             }
             const input = {
                 type: 'parse',
+                sourceFingerprint: options.sourceFingerprint,
+                indexTransport: 'packed-index-v1',
                 id,
                 source,
                 yieldIntervalMs: options.yieldIntervalMs,
@@ -240,6 +248,10 @@ export class WorkerParser {
     /** Terminate the worker if running. Safe to call repeatedly. */
     terminate() {
         if (this.worker) {
+            // Drop the per-request hydration closure, including its packed index seed.
+            this.worker.onmessage = null;
+            this.worker.onerror = null;
+            this.worker.onmessageerror = null;
             this.worker.terminate();
             this.worker = null;
         }