@ifc-lite/renderer 3.2.0 → 5.0.0

package/dist/federation-registry.d.ts

@@ -12,6 +12,8 @@ export interface ModelRange {
     modelId: string;
     offset: number;
     maxExpressId: number;
+    reservedMaxExpressId: number;
+    publishedStart: number | null;
 }
 export interface GlobalIdLookup {
     modelId: string;
@@ -34,6 +36,19 @@ export declare class FederationRegistry {
      * @returns The offset to add to all expressIds for this model
      */
     registerModel(modelId: string, maxExpressId: number): number;
+    /** Reserve a fixed local-ID envelope before progressive publication. */
+    reserveModel(modelId: string, reservedMaxExpressId: number): number;
+    /** Publish the next contiguous owned local range inside a reservation. */
+    publishRange(modelId: string, start: number, end: number): void;
+    /** Publish derived/overlay IDs from the separately reserved headroom. */
+    publishOverlayRange(modelId: string, start: number, end: number): void;
+    /**
+     * Resolve an owned overlay range while it is still detached from its
+     * mutation transaction. This validates the exact range that will be
+     * publishable, but deliberately does not make it pickable or owned yet.
+     * Callers must publish it only after the backing records commit.
+     */
+    previewOverlayGlobalId(modelId: string, start: number, end: number, expressId: number): number;
     /**
      * Unregister a model (when removed from viewer)
      * Note: The offset space is NOT reclaimed to avoid invalidating any
@@ -88,6 +103,7 @@ export declare class FederationRegistry {
      * Clear all registrations (for full reset)
      */
     clear(): void;
+    private isPublished;
     /**
      * Binary search to find the range that could contain a globalId
      * Returns the range with the largest offset that is <= globalId

package/dist/federation-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"federation-registry.d.ts","sourceRoot":"","sources":["../src/federation-registry.ts"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AAEH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAsBD;;;GAGG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,WAAW,CAAsC;IACzD,OAAO,CAAC,YAAY,CAAoB;IACxC,OAAO,CAAC,UAAU,CAAa;IAE/B;;;;;;;OAOG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM;IAyC5D;;;;OAIG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAYtC;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;IAQtD;;;OAGG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAwBrD;;;OAGG;IACH,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAKpD;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAIzC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAIlC;;OAEG;IACH,WAAW,IAAI,MAAM,EAAE;IAIvB;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;;OAGG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IASxE;;;OAGG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAOrD;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;;OAGG;IACH,OAAO,CAAC,iBAAiB;CAsB1B;AAID,eAAO,MAAM,kBAAkB,oBAA2B,CAAC"}
+{"version":3,"file":"federation-registry.d.ts","sourceRoot":"","sources":["../src/federation-registry.ts"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AAEH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAsBD;;;GAGG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,WAAW,CAAsC;IACzD,OAAO,CAAC,YAAY,CAAoB;IACxC,OAAO,CAAC,UAAU,CAAa;IAE/B;;;;;;;OAOG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM;IAQ5D,wEAAwE;IACxE,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,GAAG,MAAM;IAyCnE,0EAA0E;IAC1E,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAc/D,yEAAyE;IACzE,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAatE;;;;;OAKG;IACH,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;IAe9F;;;;OAIG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAYtC;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;IAWtD;;;OAGG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAwBrD;;;OAGG;IACH,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAKpD;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAIzC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAIlC;;OAEG;IACH,WAAW,IAAI,MAAM,EAAE;IAIvB;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;;OAGG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAUxE;;;OAGG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAOrD;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb,OAAO,CAAC,WAAW;IAOnB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;CAsB1B;AAID,eAAO,MAAM,kBAAkB,oBAA2B,CAAC"}

package/dist/federation-registry.js

@@ -36,12 +36,21 @@ export class FederationRegistry {
      * @returns The offset to add to all expressIds for this model
      */
     registerModel(modelId, maxExpressId) {
+        const existing = this.modelRanges.get(modelId);
+        if (existing)
+            return existing.offset;
+        const offset = this.reserveModel(modelId, maxExpressId);
+        this.publishRange(modelId, 0, maxExpressId);
+        return offset;
+    }
+    /** Reserve a fixed local-ID envelope before progressive publication. */
+    reserveModel(modelId, reservedMaxExpressId) {
         // Validate inputs
         if (!modelId || typeof modelId !== 'string') {
             throw new Error(`[FederationRegistry] Invalid modelId: ${modelId}`);
         }
-        if (typeof maxExpressId !== 'number' || !Number.isFinite(maxExpressId) || maxExpressId < 0) {
-            throw new Error(`[FederationRegistry] Invalid maxExpressId: ${maxExpressId} for model ${modelId}`);
+        if (typeof reservedMaxExpressId !== 'number' || !Number.isFinite(reservedMaxExpressId) || reservedMaxExpressId < 0) {
+            throw new Error(`[FederationRegistry] Invalid reservedMaxExpressId: ${reservedMaxExpressId} for model ${modelId}`);
         }
         // Check for duplicate registration
         if (this.modelRanges.has(modelId)) {
@@ -50,13 +59,13 @@ export class FederationRegistry {
             return existing.offset;
         }
         // Check for overflow
-        if (this.nextOffset + maxExpressId > MAX_SAFE_OFFSET) {
+        if (this.nextOffset + reservedMaxExpressId > MAX_SAFE_OFFSET) {
             throw new Error(`[FederationRegistry] Cannot register model: would exceed safe ID limit. ` +
-                `Current offset: ${this.nextOffset}, model max ID: ${maxExpressId}. ` +
+                `Current offset: ${this.nextOffset}, reserved model max ID: ${reservedMaxExpressId}. ` +
                 `Please unload some models first.`);
         }
         const offset = this.nextOffset;
-        const range = { modelId, offset, maxExpressId };
+        const range = { modelId, offset, maxExpressId: -1, reservedMaxExpressId, publishedStart: null };
         this.modelRanges.set(modelId, range);
         this.sortedRanges.push(range);
         // Keep sorted by offset for binary search
@@ -64,9 +73,60 @@ export class FederationRegistry {
         // Next model starts after this model's range (+1 gap for safety), plus
         // reserved headroom for mutation-overlay ids allocated into this model's
         // own space after load (see OVERLAY_ID_HEADROOM above).
-        this.nextOffset = offset + maxExpressId + 1 + OVERLAY_ID_HEADROOM;
+        this.nextOffset = offset + reservedMaxExpressId + 1 + OVERLAY_ID_HEADROOM;
         return offset;
     }
+    /** Publish the next contiguous owned local range inside a reservation. */
+    publishRange(modelId, start, end) {
+        const range = this.modelRanges.get(modelId);
+        if (!range)
+            throw new Error(`[FederationRegistry] Cannot publish unknown model ${modelId}`);
+        if (!Number.isInteger(start) || !Number.isInteger(end) || start < 0 || end < start || end > range.reservedMaxExpressId) {
+            throw new Error(`[FederationRegistry] Invalid published range ${start}..${end} for ${modelId}`);
+        }
+        if (range.publishedStart === null) {
+            range.publishedStart = start;
+        }
+        else if (start !== range.maxExpressId + 1) {
+            throw new Error(`[FederationRegistry] Published IDs for ${modelId} must be contiguous and source ordered`);
+        }
+        range.maxExpressId = end;
+    }
+    /** Publish derived/overlay IDs from the separately reserved headroom. */
+    publishOverlayRange(modelId, start, end) {
+        const range = this.modelRanges.get(modelId);
+        if (!range)
+            throw new Error(`[FederationRegistry] Cannot publish unknown model ${modelId}`);
+        const overlayEnd = range.reservedMaxExpressId + OVERLAY_ID_HEADROOM;
+        if (!Number.isInteger(start) || !Number.isInteger(end) || start < range.reservedMaxExpressId + 1 || end < start || end > overlayEnd) {
+            throw new Error(`[FederationRegistry] Invalid overlay range ${start}..${end} for ${modelId}`);
+        }
+        if (start !== range.maxExpressId + 1) {
+            throw new Error(`[FederationRegistry] Overlay IDs for ${modelId} must extend published ownership contiguously`);
+        }
+        range.maxExpressId = end;
+    }
+    /**
+     * Resolve an owned overlay range while it is still detached from its
+     * mutation transaction. This validates the exact range that will be
+     * publishable, but deliberately does not make it pickable or owned yet.
+     * Callers must publish it only after the backing records commit.
+     */
+    previewOverlayGlobalId(modelId, start, end, expressId) {
+        const range = this.modelRanges.get(modelId);
+        if (!range)
+            throw new Error(`[FederationRegistry] Cannot preview unknown model ${modelId}`);
+        const overlayEnd = range.reservedMaxExpressId + OVERLAY_ID_HEADROOM;
+        if (!Number.isInteger(start) || !Number.isInteger(end) || !Number.isInteger(expressId)
+            || start < range.reservedMaxExpressId + 1 || end < start || end > overlayEnd
+            || expressId < start || expressId > end) {
+            throw new Error(`[FederationRegistry] Invalid overlay preview ${start}..${end} for ${modelId}`);
+        }
+        if (start !== range.maxExpressId + 1) {
+            throw new Error(`[FederationRegistry] Overlay preview for ${modelId} must extend published ownership contiguously`);
+        }
+        return range.offset + expressId;
+    }
     /**
      * Unregister a model (when removed from viewer)
      * Note: The offset space is NOT reclaimed to avoid invalidating any
@@ -91,6 +151,9 @@ export class FederationRegistry {
         if (!range) {
             return expressId;
         }
+        if (!this.isPublished(range, expressId)) {
+            throw new Error(`[FederationRegistry] Local ID ${expressId} is not published for model ${modelId}`);
+        }
         return expressId + range.offset;
     }
     /**
@@ -108,7 +171,7 @@ export class FederationRegistry {
         }
         // Verify the globalId is actually within this model's range
         const localId = globalId - range.offset;
-        if (localId < 0 || localId > range.maxExpressId) {
+        if (!this.isPublished(range, localId)) {
             // globalId is in the gap between models
             return null;
         }
@@ -157,8 +220,10 @@ export class FederationRegistry {
         const range = this.modelRanges.get(modelId);
         if (!range)
             return null;
+        if (range.publishedStart === null)
+            return null;
         return {
-            start: range.offset,
+            start: range.offset + range.publishedStart,
             end: range.offset + range.maxExpressId,
         };
     }
@@ -171,7 +236,7 @@ export class FederationRegistry {
         if (!range)
             return false;
         const localId = globalId - range.offset;
-        return localId >= 0 && localId <= range.maxExpressId;
+        return this.isPublished(range, localId);
     }
     /**
      * Clear all registrations (for full reset)
@@ -181,6 +246,12 @@ export class FederationRegistry {
         this.sortedRanges = [];
         this.nextOffset = 0;
     }
+    isPublished(range, localId) {
+        return range.publishedStart !== null
+            && Number.isInteger(localId)
+            && localId >= range.publishedStart
+            && localId <= range.maxExpressId;
+    }
     /**
      * Binary search to find the range that could contain a globalId
      * Returns the range with the largest offset that is <= globalId

package/dist/federation-registry.js.map

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

package/dist/gpu-static-upload.d.ts

@@ -0,0 +1,39 @@
+/**
+ * The ONE way the renderer creates a GPU buffer pre-filled with static
+ * geometry (vertex, index and per-instance data) — issue #5429.
+ *
+ * Why `queue.writeBuffer` and never `createBuffer({ mappedAtCreation: true })`:
+ * on Chromium (Chrome / Edge / WebView2, D3D12), a mapped-at-creation buffer
+ * keeps a shared-memory copy of its FULL contents mapped into both the
+ * renderer and the GPU process for as long as the buffer lives, even after
+ * `unmap()`. That region is charged to system commit but appears in neither
+ * process's private bytes, so a loaded scene carried an invisible second copy
+ * of all its resident geometry (≈1.1 GB per 1 GiB uploaded in the issue's
+ * standalone repro; ~6 GB for a 50-file federation). `writeBuffer` into a
+ * plain `COPY_DST` buffer stages through a transient transfer allocation and
+ * keeps nothing alive afterwards.
+ *
+ * It also removes this path's synchronous `RangeError` ("createBuffer failed,
+ * size (…) is too large for the implementation when mappedAtCreation ==
+ * true"): Chromium throws that only when it cannot back the mapping, and a
+ * buffer created without `mappedAtCreation` has no mapping to back. A real
+ * GPU out-of-memory still reports the way it always did for the device-side
+ * allocation — asynchronously, as a `GPUOutOfMemoryError` through the
+ * device's error scopes / `uncapturederror`.
+ *
+ * Alignment is this helper's job, not the caller's. `writeBuffer` throws an
+ * `OperationError` DOMException when the byte count is not a multiple of 4,
+ * and `gpu-upload-guard.ts`'s `isDeviceLossThrow` classifies EVERY
+ * DOMException as a device loss — so one odd-length upload (a u16 index list
+ * with an odd count, say) would falsely latch the whole session as lost.
+ * The buffer size is therefore rounded up to 4 bytes (minimum 4), and an
+ * unaligned payload is copied into a zero-padded staging array first. The
+ * padding lies past every `indexCount` / vertex count the caller draws with,
+ * so it is never read.
+ *
+ * `writeBuffer` copies `data` before it returns (WebGPU spec: the contents
+ * are captured at call time), so callers may reuse or drop their CPU array
+ * immediately, exactly as they could after `unmap()`.
+ */
+export declare function createStaticGpuBuffer(device: GPUDevice, data: ArrayBufferView | ArrayBuffer, usage: GPUBufferUsageFlags): GPUBuffer;
+//# sourceMappingURL=gpu-static-upload.d.ts.map

package/dist/gpu-static-upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gpu-static-upload.d.ts","sourceRoot":"","sources":["../src/gpu-static-upload.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,eAAe,GAAG,WAAW,EACnC,KAAK,EAAE,mBAAmB,GACzB,SAAS,CAiBX"}

package/dist/gpu-static-upload.js

@@ -0,0 +1,70 @@
+/* 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/. */
+/**
+ * The ONE way the renderer creates a GPU buffer pre-filled with static
+ * geometry (vertex, index and per-instance data) — issue #5429.
+ *
+ * Why `queue.writeBuffer` and never `createBuffer({ mappedAtCreation: true })`:
+ * on Chromium (Chrome / Edge / WebView2, D3D12), a mapped-at-creation buffer
+ * keeps a shared-memory copy of its FULL contents mapped into both the
+ * renderer and the GPU process for as long as the buffer lives, even after
+ * `unmap()`. That region is charged to system commit but appears in neither
+ * process's private bytes, so a loaded scene carried an invisible second copy
+ * of all its resident geometry (≈1.1 GB per 1 GiB uploaded in the issue's
+ * standalone repro; ~6 GB for a 50-file federation). `writeBuffer` into a
+ * plain `COPY_DST` buffer stages through a transient transfer allocation and
+ * keeps nothing alive afterwards.
+ *
+ * It also removes this path's synchronous `RangeError` ("createBuffer failed,
+ * size (…) is too large for the implementation when mappedAtCreation ==
+ * true"): Chromium throws that only when it cannot back the mapping, and a
+ * buffer created without `mappedAtCreation` has no mapping to back. A real
+ * GPU out-of-memory still reports the way it always did for the device-side
+ * allocation — asynchronously, as a `GPUOutOfMemoryError` through the
+ * device's error scopes / `uncapturederror`.
+ *
+ * Alignment is this helper's job, not the caller's. `writeBuffer` throws an
+ * `OperationError` DOMException when the byte count is not a multiple of 4,
+ * and `gpu-upload-guard.ts`'s `isDeviceLossThrow` classifies EVERY
+ * DOMException as a device loss — so one odd-length upload (a u16 index list
+ * with an odd count, say) would falsely latch the whole session as lost.
+ * The buffer size is therefore rounded up to 4 bytes (minimum 4), and an
+ * unaligned payload is copied into a zero-padded staging array first. The
+ * padding lies past every `indexCount` / vertex count the caller draws with,
+ * so it is never read.
+ *
+ * `writeBuffer` copies `data` before it returns (WebGPU spec: the contents
+ * are captured at call time), so callers may reuse or drop their CPU array
+ * immediately, exactly as they could after `unmap()`.
+ */
+export function createStaticGpuBuffer(device, data, usage) {
+    const bytes = ArrayBuffer.isView(data)
+        ? new Uint8Array(data.buffer, data.byteOffset, data.byteLength)
+        : new Uint8Array(data);
+    const size = alignedUploadSize(bytes.byteLength);
+    const buffer = device.createBuffer({ size, usage: usage | GPUBufferUsage.COPY_DST });
+    if (bytes.byteLength === 0)
+        return buffer;
+    try {
+        const payload = bytes.byteLength === size ? bytes : padTo(bytes, size);
+        device.queue.writeBuffer(buffer, 0, payload);
+    }
+    catch (error) {
+        // Never orphan the allocation: the caller only learns about buffers this
+        // function RETURNS, so one that failed to fill is ours to release.
+        buffer.destroy();
+        throw error;
+    }
+    return buffer;
+}
+/** Byte size allocated for a payload of `byteLength`: 4-aligned, never 0. */
+function alignedUploadSize(byteLength) {
+    return Math.max(4, Math.ceil(byteLength / 4) * 4);
+}
+function padTo(bytes, size) {
+    const padded = new Uint8Array(size);
+    padded.set(bytes);
+    return padded;
+}
+//# sourceMappingURL=gpu-static-upload.js.map

package/dist/gpu-static-upload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gpu-static-upload.js","sourceRoot":"","sources":["../src/gpu-static-upload.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,UAAU,qBAAqB,CACnC,MAAiB,EACjB,IAAmC,EACnC,KAA0B;IAE1B,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC;QACpC,CAAC,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC;QAC/D,CAAC,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IACzB,MAAM,IAAI,GAAG,iBAAiB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,GAAG,cAAc,CAAC,QAAQ,EAAE,CAAC,CAAC;IACrF,IAAI,KAAK,CAAC,UAAU,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IAC1C,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACvE,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,yEAAyE;QACzE,mEAAmE;QACnE,MAAM,CAAC,OAAO,EAAE,CAAC;QACjB,MAAM,KAAK,CAAC;IACd,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,6EAA6E;AAC7E,SAAS,iBAAiB,CAAC,UAAkB;IAC3C,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AACpD,CAAC;AAED,SAAS,KAAK,CAAC,KAAiB,EAAE,IAAY;IAC5C,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAClB,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/gpu-upload-guard.d.ts

@@ -21,15 +21,22 @@
  * draws exactly that line:
  *  - a call on a dead / invalid-state device throws a `DOMException`
  *    (`InvalidStateError` in Safari 26.5 — the whole of issue #2229);
- *  - a buffer allocation the host cannot back throws a plain `RangeError`
- *    ("createBuffer failed, size (…) is too large … when mappedAtCreation ==
- *    true"), which `isMappedCreateBufferOverflow` below documents happening
- *    on a HEALTHY device under memory pressure.
+ *  - host memory pressure on a HEALTHY device throws a plain `RangeError` —
+ *    today from the CPU side of an upload (typed-array allocation while
+ *    merging geometry: "Array buffer allocation failed"). Until #5429 the
+ *    upload's own `createBuffer({ mappedAtCreation: true })` was a second
+ *    source ("createBuffer failed, size (…) is too large … when
+ *    mappedAtCreation == true", at sizes as small as 672 B); static geometry
+ *    now uploads through `gpu-static-upload.ts`'s `createStaticGpuBuffer`,
+ *    which never maps at creation and so cannot raise it.
  *
  * Treating the second as a device loss is a false positive that costs the
  * whole session — see `runGuardedGpuUpload`'s doc for how a caught RangeError
  * is instead checked against `isDeviceLost()`, not this classifier, to tell
- * loss fallout from real memory pressure.
+ * loss fallout from real memory pressure. The one healthy-device
+ * `DOMException` an upload could raise — `writeBuffer`'s `OperationError` for
+ * a byte count that is not a multiple of 4 — is ruled out by construction:
+ * `createStaticGpuBuffer` pads every payload.
  *
  * Shared by `index.ts`'s frame-level `containFrameThrow` (the ONE throw class
  * that latches mid-frame) and this module's `runGuardedGpuUpload` (the same
@@ -64,24 +71,6 @@ export type GpuUploadOutcome<T> = {
     error: unknown;
     deviceLostAtTime: boolean;
 };
-/**
- * Chromium's wording for a `createBuffer({ mappedAtCreation: true })` the
- * host could not back:
- *
- *   RangeError: Failed to execute 'createBuffer' on 'GPUDevice': createBuffer
- *   failed, size (672) is too large for the implementation when
- *   mappedAtCreation == true
- *
- * — at sizes (672 B, 5.5 KB, 15 KB) nowhere near any real device limit. This
- * is the same string `packages/renderer/src/index.ts`'s `isDeviceLossThrow`
- * deliberately does NOT latch on inside a frame (see that function's doc: a
- * RangeError there is genuine, frame-scoped memory pressure on a device that
- * IS still alive). This matcher answers a different question for a DIFFERENT
- * caller — one that sits outside the frame's own containment and wants to
- * know whether a RangeError it just caught is fallout from a loss that has
- * already happened, not a fresh probe of a healthy device.
- */
-export declare function isMappedCreateBufferOverflow(error: unknown): boolean;
 /**
  * Run one GPU upload, gated on device loss.
  *

package/dist/gpu-upload-guard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gpu-upload-guard.d.ts","sourceRoot":"","sources":["../src/gpu-upload-guard.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;GAeG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEzD;AAED,8CAA8C;AAC9C,MAAM,MAAM,gBAAgB,CAAC,CAAC,IACxB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE;AACxB,mEAAmE;GACjE;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,aAAa,CAAA;CAAE;AACtC;;;;;;;GAOG;GACD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,gBAAgB,EAAE,OAAO,CAAA;CAAE,CAAC;AAEhF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAGpE;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EACjC,YAAY,EAAE,MAAM,OAAO,EAC3B,GAAG,EAAE,MAAM,CAAC,EACZ,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAC1C,gBAAgB,CAAC,CAAC,CAAC,CAUrB"}
+{"version":3,"file":"gpu-upload-guard.d.ts","sourceRoot":"","sources":["../src/gpu-upload-guard.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;GAeG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEzD;AAED,8CAA8C;AAC9C,MAAM,MAAM,gBAAgB,CAAC,CAAC,IACxB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE;AACxB,mEAAmE;GACjE;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,aAAa,CAAA;CAAE;AACtC;;;;;;;GAOG;GACD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,gBAAgB,EAAE,OAAO,CAAA;CAAE,CAAC;AAEhF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EACjC,YAAY,EAAE,MAAM,OAAO,EAC3B,GAAG,EAAE,MAAM,CAAC,EACZ,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAC1C,gBAAgB,CAAC,CAAC,CAAC,CAUrB"}

package/dist/gpu-upload-guard.js

@@ -24,15 +24,22 @@
  * draws exactly that line:
  *  - a call on a dead / invalid-state device throws a `DOMException`
  *    (`InvalidStateError` in Safari 26.5 — the whole of issue #2229);
- *  - a buffer allocation the host cannot back throws a plain `RangeError`
- *    ("createBuffer failed, size (…) is too large … when mappedAtCreation ==
- *    true"), which `isMappedCreateBufferOverflow` below documents happening
- *    on a HEALTHY device under memory pressure.
+ *  - host memory pressure on a HEALTHY device throws a plain `RangeError` —
+ *    today from the CPU side of an upload (typed-array allocation while
+ *    merging geometry: "Array buffer allocation failed"). Until #5429 the
+ *    upload's own `createBuffer({ mappedAtCreation: true })` was a second
+ *    source ("createBuffer failed, size (…) is too large … when
+ *    mappedAtCreation == true", at sizes as small as 672 B); static geometry
+ *    now uploads through `gpu-static-upload.ts`'s `createStaticGpuBuffer`,
+ *    which never maps at creation and so cannot raise it.
  *
  * Treating the second as a device loss is a false positive that costs the
  * whole session — see `runGuardedGpuUpload`'s doc for how a caught RangeError
  * is instead checked against `isDeviceLost()`, not this classifier, to tell
- * loss fallout from real memory pressure.
+ * loss fallout from real memory pressure. The one healthy-device
+ * `DOMException` an upload could raise — `writeBuffer`'s `OperationError` for
+ * a byte count that is not a multiple of 4 — is ruled out by construction:
+ * `createStaticGpuBuffer` pads every payload.
  *
  * Shared by `index.ts`'s frame-level `containFrameThrow` (the ONE throw class
  * that latches mid-frame) and this module's `runGuardedGpuUpload` (the same
@@ -45,27 +52,6 @@
 export function isDeviceLossThrow(error) {
     return typeof DOMException !== 'undefined' && error instanceof DOMException;
 }
-/**
- * Chromium's wording for a `createBuffer({ mappedAtCreation: true })` the
- * host could not back:
- *
- *   RangeError: Failed to execute 'createBuffer' on 'GPUDevice': createBuffer
- *   failed, size (672) is too large for the implementation when
- *   mappedAtCreation == true
- *
- * — at sizes (672 B, 5.5 KB, 15 KB) nowhere near any real device limit. This
- * is the same string `packages/renderer/src/index.ts`'s `isDeviceLossThrow`
- * deliberately does NOT latch on inside a frame (see that function's doc: a
- * RangeError there is genuine, frame-scoped memory pressure on a device that
- * IS still alive). This matcher answers a different question for a DIFFERENT
- * caller — one that sits outside the frame's own containment and wants to
- * know whether a RangeError it just caught is fallout from a loss that has
- * already happened, not a fresh probe of a healthy device.
- */
-export function isMappedCreateBufferOverflow(error) {
-    return error instanceof RangeError
-        && /createbuffer failed.*mappedatcreation/i.test(error.message);
-}
 /**
  * Run one GPU upload, gated on device loss.
  *

package/dist/gpu-upload-guard.js.map

@@ -1 +1 @@
-{"version":3,"file":"gpu-upload-guard.js","sourceRoot":"","sources":["../src/gpu-upload-guard.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D;;;;;;;;;;;;;;;GAeG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC5C,OAAO,OAAO,YAAY,KAAK,WAAW,IAAI,KAAK,YAAY,YAAY,CAAC;AAChF,CAAC;AAiBD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,4BAA4B,CAAC,KAAc;IACvD,OAAO,KAAK,YAAY,UAAU;WAC3B,wCAAwC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AACxE,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,mBAAmB,CAC/B,YAA2B,EAC3B,GAAY,EACZ,cAAyC;IAEzC,IAAI,YAAY,EAAE,EAAE,CAAC;QACjB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;IAChD,CAAC;IACD,IAAI,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC;IACtC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,IAAI,iBAAiB,CAAC,KAAK,CAAC;YAAE,cAAc,EAAE,CAAC,KAAK,CAAC,CAAC;QACtD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,EAAE,CAAC;IACnF,CAAC;AACL,CAAC"}
+{"version":3,"file":"gpu-upload-guard.js","sourceRoot":"","sources":["../src/gpu-upload-guard.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D;;;;;;;;;;;;;;;GAeG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC5C,OAAO,OAAO,YAAY,KAAK,WAAW,IAAI,KAAK,YAAY,YAAY,CAAC;AAChF,CAAC;AAiBD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,mBAAmB,CAC/B,YAA2B,EAC3B,GAAY,EACZ,cAAyC;IAEzC,IAAI,YAAY,EAAE,EAAE,CAAC;QACjB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;IAChD,CAAC;IACD,IAAI,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC;IACtC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,IAAI,iBAAiB,CAAC,KAAK,CAAC;YAAE,cAAc,EAAE,CAAC,KAAK,CAAC,CAAC;QACtD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,EAAE,CAAC;IACnF,CAAC;AACL,CAAC"}