@ifc-lite/renderer 3.1.0 → 4.2.0

package/dist/relative-to-eye.js

@@ -0,0 +1,326 @@
+/* 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 renderer's relative-to-eye (RTE) coordinate contract.
+ *
+ * IFC source coordinates are JavaScript numbers (IEEE-754 f64).  They must
+ * stay that way through placement, bounds, picking and measurement.  A GPU
+ * vertex, however, is f32; at a national-grid offset its least significant
+ * bit is much larger than an edge or a cursor snap tolerance.  The only
+ * f32 conversion allowed at the render boundary is therefore this split:
+ *
+ *   drawableMinusCamera = deltaHigh + deltaLow
+ *   eyeRelative = (local + deltaHigh) + deltaLow
+ *
+ * The delta is formed in CPU f64 before either lane is rounded. This avoids
+ * losing a source residual when two independently rounded large origins are
+ * subtracted in f32.
+ *
+ * This module deliberately owns both the CPU packing layout and the matching
+ * WGSL declarations (in `shaders/relative-to-eye.wgsl.ts`).  Pass migrations
+ * must consume this frame; no render path may create a competing camera
+ * rebase.  `worldToRelative` is also the CPU counterpart for ray, snap and
+ * measure code: it uses f64 subtraction and never round-trips through a GPU
+ * buffer.
+ */
+import { MathUtils } from './math.js';
+import { relativeToEyeWgsl } from './shaders/relative-to-eye.wgsl.js';
+/** Two f32 vec4 lanes holding one f64-like origin.  The w components are 0. */
+export const RTE_ORIGIN_FLOATS = 8;
+/** Translation-free `mat4x4 viewProj`; camera position stays CPU f64 only. */
+export const RTE_FRAME_FLOATS = 16;
+/** Largest supported source/world coordinate component, in canonical Y-up metres. */
+export const MAX_RTE_SOURCE_ABS_METRES = 1_000_000_000;
+/** Largest source-origin delta accepted by a single camera RTE frame. */
+export const MAX_RTE_EYE_RELATIVE_METRES = 1_000_000;
+/**
+ * Largest local-coordinate magnitude accepted for a precision-sensitive
+ * drawable. At 8,192 m an f32 ULP remains below one millimetre; larger
+ * extents must be partitioned into separate anchors rather than silently
+ * turning centimetre geometry into coarse local floats.
+ */
+export const MAX_RTE_LOCAL_METRES = 8_192;
+/** Exact byte layout shared by the CPU writer and the WGSL RTE structs. */
+export const RTE_UNIFORM_LAYOUT = {
+    frame: [
+        { name: 'viewProj', type: 'mat4x4<f32>', byteOffset: 0, byteSize: 64 },
+    ],
+    drawable: [
+        { name: 'drawableDeltaHigh', type: 'vec4<f32>', byteOffset: 0, byteSize: 16 },
+        { name: 'drawableDeltaLow', type: 'vec4<f32>', byteOffset: 16, byteSize: 16 },
+    ],
+};
+/**
+ * Reflect the deliberately small RTE WGSL ABI. The production source has no
+ * nested structs or arrays here, so accepting either would conceal inserted
+ * padding. Unsupported syntax is a contract failure, not a parser fallback.
+ */
+export function reflectRteUniformStruct(source, structName) {
+    const match = new RegExp(`struct\\s+${structName}\\s*\\{([\\s\\S]*?)\\}`).exec(source);
+    if (!match)
+        throw new Error(`RTE WGSL struct ${structName} is missing.`);
+    const fields = [];
+    let byteOffset = 0;
+    for (const rawLine of match[1].split('\n')) {
+        const line = rawLine.replace(/\/\/.*$/, '').trim();
+        if (!line)
+            continue;
+        const field = /^(\w+)\s*:\s*(mat4x4<f32>|vec4<f32>)\s*,?$/.exec(line);
+        if (!field)
+            throw new Error(`Unsupported RTE WGSL field: ${line}`);
+        const name = field[1];
+        const type = field[2];
+        if (!name || (type !== 'mat4x4<f32>' && type !== 'vec4<f32>')) {
+            throw new Error(`Invalid RTE WGSL field: ${line}`);
+        }
+        const byteSize = type === 'mat4x4<f32>' ? 64 : 16;
+        byteOffset = Math.ceil(byteOffset / 16) * 16;
+        fields.push({ name, type, byteOffset, byteSize });
+        byteOffset += byteSize;
+    }
+    return fields;
+}
+/** Fail loudly if source edits drift from the CPU writer's exact ABI. */
+export function assertRteUniformAbi(source = relativeToEyeWgsl) {
+    for (const [structName, expected] of [
+        ['RteFrameUniform', RTE_UNIFORM_LAYOUT.frame],
+        ['RteDrawableUniform', RTE_UNIFORM_LAYOUT.drawable],
+    ]) {
+        const actual = reflectRteUniformStruct(source, structName);
+        if (actual.length !== expected.length || actual.some((field, index) => {
+            const want = expected[index];
+            return field.name !== want.name || field.type !== want.type
+                || field.byteOffset !== want.byteOffset || field.byteSize !== want.byteSize;
+        })) {
+            throw new Error(`RTE WGSL ${structName} does not match the CPU uniform ABI.`);
+        }
+    }
+    // Layout reflection alone cannot prove floating-point association. This is
+    // an executable shader-source invariant, separate from ABI reflection.
+    if (!source.includes('(local + highDelta) + lowDelta')
+        || source.includes('local + (highDelta + lowDelta)')) {
+        throw new Error('RTE WGSL must evaluate (local + highDelta) + lowDelta.');
+    }
+}
+/**
+ * Split one finite f64 coordinate into two f32 values.  The residual is also
+ * rounded to f32 because it is consumed by WGSL, and the pair is returned as
+ * ordinary numbers so callers cannot accidentally retain a mutable buffer.
+ */
+export function splitFloat64ForRte(value) {
+    if (!Number.isFinite(value)) {
+        throw new RangeError(`RTE origins must be finite f64 coordinates; received ${value}.`);
+    }
+    if (Math.abs(value) > MAX_RTE_SOURCE_ABS_METRES) {
+        throw new RangeError(`RTE origin ${value} exceeds the supported ±${MAX_RTE_SOURCE_ABS_METRES} m source envelope.`);
+    }
+    const high = Math.fround(value);
+    if (!Number.isFinite(high)) {
+        throw new RangeError(`RTE origin ${value} exceeds the finite f32 GPU range.`);
+    }
+    return [high, Math.fround(value - high)];
+}
+/** Validate a source/world f64 point before any subtraction changes its meaning. */
+function validateRteSourcePoint(point) {
+    for (let axis = 0; axis < 3; axis++)
+        splitFloat64ForRte(point[axis]);
+}
+/**
+ * Pack a drawable origin relative to a source f64 camera position.  Shadow
+ * submissions use this same boundary check/packing as colour and pick paths.
+ */
+export function packRteDrawableDelta(origin, cameraWorld, out, floatOffset) {
+    validateRteSourcePoint(origin);
+    // A finite delta alone is not enough: without validating the camera in the
+    // same source envelope, two equally invalid large coordinates could cancel.
+    validateRteSourcePoint(cameraWorld);
+    const delta = [0, 0, 0];
+    for (let axis = 0; axis < 3; axis++) {
+        delta[axis] = origin[axis] - cameraWorld[axis];
+        if (!Number.isFinite(delta[axis]) || Math.abs(delta[axis]) > MAX_RTE_EYE_RELATIVE_METRES) {
+            throw new RangeError(`RTE drawable origin exceeds the ±${MAX_RTE_EYE_RELATIVE_METRES} m camera-relative envelope on axis ${axis}.`);
+        }
+    }
+    packRteOrigin(delta, out, floatOffset);
+}
+/**
+ * Pack an f64 world origin as two vec4<f32>s at `floatOffset`.  The empty w
+ * lanes are explicitly cleared so a reused uniform scratch buffer cannot
+ * leak unrelated data into a future WGSL struct revision.
+ */
+export function packRteOrigin(origin, out, floatOffset = 0) {
+    if (out.length < floatOffset + RTE_ORIGIN_FLOATS) {
+        throw new RangeError(`RTE origin needs ${RTE_ORIGIN_FLOATS} floats at offset ${floatOffset}.`);
+    }
+    for (let axis = 0; axis < 3; axis++) {
+        const [high, low] = splitFloat64ForRte(origin[axis]);
+        out[floatOffset + axis] = high;
+        out[floatOffset + 4 + axis] = low;
+    }
+    out[floatOffset + 3] = 0;
+    out[floatOffset + 7] = 0;
+}
+/** Read back the f64 approximation represented by a packed RTE origin. */
+export function unpackRteOrigin(packed, floatOffset = 0) {
+    if (packed.length < floatOffset + RTE_ORIGIN_FLOATS) {
+        throw new RangeError(`RTE origin needs ${RTE_ORIGIN_FLOATS} floats at offset ${floatOffset}.`);
+    }
+    return [
+        packed[floatOffset] + packed[floatOffset + 4],
+        packed[floatOffset + 1] + packed[floatOffset + 5],
+        packed[floatOffset + 2] + packed[floatOffset + 6],
+    ];
+}
+/**
+ * Remove only the camera translation from a view matrix.  Projection remains
+ * untouched (including its depth translation); "translation-free" means no
+ * world/eye translation is baked into `viewProj`, not a projection with its
+ * near-plane term removed.
+ */
+export function translationFreeViewProjection(projection, view) {
+    const orientationOnly = new Float32Array(view.m);
+    orientationOnly[12] = 0;
+    orientationOnly[13] = 0;
+    orientationOnly[14] = 0;
+    return MathUtils.multiply(projection, { m: orientationOnly });
+}
+/**
+ * The one camera-owned RTE frame. It carries f64 camera source coordinates and
+ * a translation-free view-projection that consumes eye-relative positions. It
+ * intentionally has no model/drawable state: each
+ * draw packs an f64 camera-relative delta through `packDrawableOrigin`.
+ */
+export class RelativeToEyeFrame {
+    cameraWorld = [0, 0, 0];
+    viewProj = MathUtils.identity();
+    renderEpoch = 0;
+    available = true;
+    /** Unsupported camera poses must never expose a previous frame as current. */
+    invalidate() { this.available = false; this.renderEpoch++; }
+    isAvailable() { return this.available; }
+    requireAvailable() {
+        if (!this.available)
+            throw new RangeError('RTE camera frame is outside the supported envelope.');
+    }
+    /** Update the frame from the f64 camera pose and the normal camera matrices. */
+    update(camera, projection, view) {
+        const cameraWorld = [camera.x, camera.y, camera.z];
+        validateRteSourcePoint(cameraWorld);
+        const viewProj = translationFreeViewProjection(projection, view);
+        if (!viewProj.m.every(Number.isFinite))
+            throw new RangeError('RTE matrix must be finite.');
+        // Publish atomically: a rejected update changes neither epoch nor inputs.
+        this.cameraWorld = cameraWorld;
+        this.viewProj = viewProj;
+        this.available = true;
+        this.renderEpoch++;
+    }
+    /** f64 source camera position; copied so an external caller cannot mutate it. */
+    getCameraWorld() {
+        this.requireAvailable();
+        return [...this.cameraWorld];
+    }
+    /** The projection to use after WGSL has made a vertex relative to this eye. */
+    getViewProjection() {
+        this.requireAvailable();
+        return { m: new Float32Array(this.viewProj.m) };
+    }
+    /** Monotonic snapshot identity for asynchronous GPU work and readback. */
+    getRenderEpoch() {
+        return this.renderEpoch;
+    }
+    /**
+     * Capture immutable frame inputs before queuing asynchronous GPU work.
+     * A later camera update mutates this frame but cannot rewrite the captured
+     * camera origin or matrix used to decode that work's readback.
+     */
+    snapshot() {
+        this.requireAvailable();
+        return new RelativeToEyeSnapshot(this.renderEpoch, this.cameraWorld, this.viewProj);
+    }
+    /**
+     * Pack the translation-free `viewProj`, matching `RteFrameUniform` in WGSL.
+     * The camera stays CPU f64 only; each drawable supplies its already-split
+     * f64 camera-relative delta through the separate per-draw uniform.
+     */
+    packUniforms(out, floatOffset = 0) {
+        this.requireAvailable();
+        if (out.length < floatOffset + RTE_FRAME_FLOATS) {
+            throw new RangeError(`RTE frame needs ${RTE_FRAME_FLOATS} floats at offset ${floatOffset}.`);
+        }
+        out.set(this.viewProj.m, floatOffset + RTE_UNIFORM_LAYOUT.frame[0].byteOffset / 4);
+    }
+    /**
+     * Pack a drawable's f64 camera-relative origin into the per-draw layout.
+     * The GPU must never subtract independently rounded absolute origins again.
+     * This payload is camera-dependent and is invalid after any camera reframe.
+     */
+    packDrawableOrigin(origin, out, floatOffset = 0) {
+        this.requireAvailable();
+        // Validate the original source origin before subtraction: a camera at the
+        // boundary could otherwise make an out-of-range drawable look harmless.
+        packRteDrawableDelta(origin, this.cameraWorld, out, floatOffset);
+    }
+    /**
+     * CPU side of the contract for ray casting, snapping and measurement.
+     * Keep this f64 subtraction separate from the f32 emulation helper below:
+     * callers that are not writing a GPU uniform should retain all source
+     * precision.
+     */
+    worldToRelative(world) {
+        this.requireAvailable();
+        return [
+            world[0] - this.cameraWorld[0],
+            world[1] - this.cameraWorld[1],
+            world[2] - this.cameraWorld[2],
+        ];
+    }
+}
+/** An immutable RTE frame captured for one render submission/readback. */
+export class RelativeToEyeSnapshot {
+    renderEpoch;
+    cameraWorld;
+    viewProj;
+    constructor(renderEpoch, cameraWorld, viewProj) {
+        this.renderEpoch = renderEpoch;
+        this.cameraWorld = [...cameraWorld];
+        this.viewProj = { m: new Float32Array(viewProj.m) };
+    }
+    getCameraWorld() {
+        return [...this.cameraWorld];
+    }
+    getViewProjection() {
+        return { m: new Float32Array(this.viewProj.m) };
+    }
+    packDrawableOrigin(origin, out, floatOffset = 0) {
+        packRteDrawableDelta(origin, this.cameraWorld, out, floatOffset);
+    }
+    worldToRelative(world) {
+        return [
+            world[0] - this.cameraWorld[0],
+            world[1] - this.cameraWorld[1],
+            world[2] - this.cameraWorld[2],
+        ];
+    }
+}
+/**
+ * f32-faithful reference for the WGSL origin subtraction.  Tests use it to
+ * prove the actual GPU arithmetic order rather than merely checking that the
+ * high/low arrays contain plausible values.
+ */
+export function rteRelativePositionF32(local, drawableDeltaPacked) {
+    if (drawableDeltaPacked.length < RTE_ORIGIN_FLOATS) {
+        throw new RangeError('RTE relative position requires one packed drawable-camera delta.');
+    }
+    const result = [0, 0, 0];
+    for (let axis = 0; axis < 3; axis++) {
+        const highDelta = drawableDeltaPacked[axis];
+        const lowDelta = drawableDeltaPacked[axis + 4];
+        // Match WGSL exactly: a local template may span kilometres, so folding
+        // low into high before adding local can lose the low residual.
+        result[axis] = Math.fround(Math.fround(Math.fround(local[axis]) + highDelta) + lowDelta);
+    }
+    return result;
+}
+//# sourceMappingURL=relative-to-eye.js.map

package/dist/relative-to-eye.js.map

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

package/dist/render-section-draw.d.ts

@@ -20,6 +20,7 @@
  */
 import type { SectionPlaneRenderer } from './section-plane.js';
 import type { Section2DOverlayRenderer } from './section-2d-overlay.js';
+import type { RelativeToEyeFrame } from './relative-to-eye.js';
 import type { RenderOptions } from './types.js';
 /** World-space AABB in the renderer's Y-up frame. */
 export type ModelBounds = {
@@ -38,8 +39,18 @@ export type ModelBounds = {
 export interface SectionDrawContext {
     options: RenderOptions;
     viewProj: Float32Array;
+    /** The camera-owned f64/RTE frame used by the preview gizmo. */
+    relativeToEyeFrame?: RelativeToEyeFrame;
+    rteViewProj?: Float32Array;
+    rteCamera?: readonly [number, number, number];
     /** The bounds this frame resolved the section slider against. */
     modelBounds: ModelBounds | null;
+    /**
+     * Drawing-buffer px per CSS px (default 1). The cap hatch is laid out in
+     * fragment coordinates, so its CSS-px spacing and width scale by this to
+     * look the same on a HiDPI buffer (#5383).
+     */
+    pixelRatio?: number;
 }
 /**
  * Draw the section-plane gizmo and, when the section is active, the cut cap.

package/dist/render-section-draw.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render-section-draw.d.ts","sourceRoot":"","sources":["../src/render-section-draw.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAExE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,qDAAqD;AACrD,MAAM,MAAM,WAAW,GAAG;IACtB,GAAG,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,GAAG,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5C,CAAC;AAEF,oEAAoE;AACpE,MAAM,WAAW,kBAAkB;IAC/B,OAAO,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE,YAAY,CAAC;IACvB,iEAAiE;IACjE,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;CACnC;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAC/B,IAAI,EAAE,oBAAoB,EAC1B,KAAK,EAAE,oBAAoB,GAAG,IAAI,EAClC,GAAG,EAAE,wBAAwB,GAAG,IAAI,EACpC,GAAG,EAAE,kBAAkB,GACxB,IAAI,CA+DN"}
+{"version":3,"file":"render-section-draw.d.ts","sourceRoot":"","sources":["../src/render-section-draw.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAExE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,qDAAqD;AACrD,MAAM,MAAM,WAAW,GAAG;IACtB,GAAG,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,GAAG,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5C,CAAC;AAEF,oEAAoE;AACpE,MAAM,WAAW,kBAAkB;IAC/B,OAAO,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE,YAAY,CAAC;IACvB,gEAAgE;IAChE,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC,WAAW,CAAC,EAAE,YAAY,CAAC;IAC3B,SAAS,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9C,iEAAiE;IACjE,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IAChC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAC/B,IAAI,EAAE,oBAAoB,EAC1B,KAAK,EAAE,oBAAoB,GAAG,IAAI,EAClC,GAAG,EAAE,wBAAwB,GAAG,IAAI,EACpC,GAAG,EAAE,kBAAkB,GACxB,IAAI,CAkEN"}

package/dist/render-section-draw.js

@@ -17,6 +17,7 @@ export function drawSectionOverlays(pass, gizmo, cap, ctx) {
             axis: options.sectionPlane.axis,
             position: options.sectionPlane.position,
             bounds: modelBounds,
+            relativeToEyeFrame: ctx.relativeToEyeFrame,
             viewProj,
             isPreview: !options.sectionPlane.enabled, // Preview mode when not enabled
             min: options.sectionPlane.min,
@@ -40,12 +41,14 @@ export function drawSectionOverlays(pass, gizmo, cap, ctx) {
             const o = options.sectionPlane;
             const showFills = o.showCap !== false;
             const showOutlines = o.showOutlines !== false;
-            const style = { ...DEFAULT_CAP_STYLE, ...(o.capStyle ?? {}) };
+            const style = { ...DEFAULT_CAP_STYLE, ...o.capStyle };
             cap.draw(pass, {
                 axis: o.axis,
                 position: o.position,
                 bounds: modelBounds,
                 viewProj,
+                rteViewProj: ctx.rteViewProj,
+                rteCamera: ctx.rteCamera,
                 min: o.min,
                 max: o.max,
                 showFills,
@@ -54,9 +57,9 @@ export function drawSectionOverlays(pass, gizmo, cap, ctx) {
                     fillColor: style.fillColor,
                     strokeColor: style.strokeColor,
                     patternId: HATCH_PATTERN_IDS[style.pattern],
-                    spacingPx: style.spacingPx,
+                    spacingPx: style.spacingPx * (ctx.pixelRatio ?? 1),
                     angleRad: style.angleRad,
-                    widthPx: style.widthPx,
+                    widthPx: style.widthPx * (ctx.pixelRatio ?? 1),
                     secondaryAngleRad: style.secondaryAngleRad,
                 } : undefined,
             });

package/dist/render-section-draw.js.map

@@ -1 +1 @@
-{"version":3,"file":"render-section-draw.js","sourceRoot":"","sources":["../src/render-section-draw.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAyB/D,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAiB9E;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAC/B,IAA0B,EAC1B,KAAkC,EAClC,GAAoC,EACpC,GAAuB;IAEvB,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,GAAG,CAAC;IAE/C,6EAA6E;IAC7E,kFAAkF;IAClF,IAAI,OAAO,CAAC,YAAY,IAAI,KAAK,IAAI,WAAW,EAAE,CAAC;QAC/C,KAAK,CAAC,IAAI,CACN,IAAI,EACJ;YACI,IAAI,EAAE,OAAO,CAAC,YAAY,CAAC,IAAI;YAC/B,QAAQ,EAAE,OAAO,CAAC,YAAY,CAAC,QAAQ;YACvC,MAAM,EAAE,WAAW;YACnB,QAAQ;YACR,SAAS,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,OAAO,EAAE,gCAAgC;YAC1E,GAAG,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG;YAC7B,GAAG,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG;YAC7B,sDAAsD;YACtD,oDAAoD;YACpD,yDAAyD;YACzD,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,MAAM;YACnC,QAAQ,EAAE,OAAO,CAAC,YAAY,CAAC,QAAQ;SAC1C,CACJ,CAAC;QAEF,gEAAgE;QAChE,gEAAgE;QAChE,+DAA+D;QAC/D,2DAA2D;QAC3D,uDAAuD;QACvD,4DAA4D;QAC5D,2DAA2D;QAC3D,2DAA2D;QAC3D,6CAA6C;QAC7C,IAAI,OAAO,CAAC,YAAY,CAAC,OAAO,IAAI,GAAG,EAAE,WAAW,EAAE,EAAE,CAAC;YACrD,MAAM,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC;YAC/B,MAAM,SAAS,GAAM,CAAC,CAAC,OAAO,KAAK,KAAK,CAAC;YACzC,MAAM,YAAY,GAAG,CAAC,CAAC,YAAY,KAAK,KAAK,CAAC;YAC9C,MAAM,KAAK,GAAG,EAAE,GAAG,iBAAiB,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,CAAC;YAC9D,GAAG,CAAC,IAAI,CACJ,IAAI,EACJ;gBACI,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,MAAM,EAAE,WAAW;gBACnB,QAAQ;gBACR,GAAG,EAAE,CAAC,CAAC,GAAG;gBACV,GAAG,EAAE,CAAC,CAAC,GAAG;gBACV,SAAS;gBACT,YAAY;gBACZ,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC;oBAClB,SAAS,EAAI,KAAK,CAAC,SAAS;oBAC5B,WAAW,EAAE,KAAK,CAAC,WAAW;oBAC9B,SAAS,EAAI,iBAAiB,CAAC,KAAK,CAAC,OAAO,CAAC;oBAC7C,SAAS,EAAI,KAAK,CAAC,SAAS;oBAC5B,QAAQ,EAAK,KAAK,CAAC,QAAQ;oBAC3B,OAAO,EAAM,KAAK,CAAC,OAAO;oBAC1B,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;iBAC7C,CAAC,CAAC,CAAC,SAAS;aAChB,CACJ,CAAC;QACN,CAAC;IAEL,CAAC;AACL,CAAC"}
+{"version":3,"file":"render-section-draw.js","sourceRoot":"","sources":["../src/render-section-draw.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAyB/D,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AA4B9E;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAC/B,IAA0B,EAC1B,KAAkC,EAClC,GAAoC,EACpC,GAAuB;IAEvB,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,GAAG,CAAC;IAE/C,6EAA6E;IAC7E,kFAAkF;IAClF,IAAI,OAAO,CAAC,YAAY,IAAI,KAAK,IAAI,WAAW,EAAE,CAAC;QAC/C,KAAK,CAAC,IAAI,CACN,IAAI,EACJ;YACI,IAAI,EAAE,OAAO,CAAC,YAAY,CAAC,IAAI;YAC/B,QAAQ,EAAE,OAAO,CAAC,YAAY,CAAC,QAAQ;YACvC,MAAM,EAAE,WAAW;YACnB,kBAAkB,EAAE,GAAG,CAAC,kBAAkB;YAC1C,QAAQ;YACR,SAAS,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,OAAO,EAAE,gCAAgC;YAC1E,GAAG,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG;YAC7B,GAAG,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG;YAC7B,sDAAsD;YACtD,oDAAoD;YACpD,yDAAyD;YACzD,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,MAAM;YACnC,QAAQ,EAAE,OAAO,CAAC,YAAY,CAAC,QAAQ;SAC1C,CACJ,CAAC;QAEF,gEAAgE;QAChE,gEAAgE;QAChE,+DAA+D;QAC/D,2DAA2D;QAC3D,uDAAuD;QACvD,4DAA4D;QAC5D,2DAA2D;QAC3D,2DAA2D;QAC3D,6CAA6C;QAC7C,IAAI,OAAO,CAAC,YAAY,CAAC,OAAO,IAAI,GAAG,EAAE,WAAW,EAAE,EAAE,CAAC;YACrD,MAAM,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC;YAC/B,MAAM,SAAS,GAAM,CAAC,CAAC,OAAO,KAAK,KAAK,CAAC;YACzC,MAAM,YAAY,GAAG,CAAC,CAAC,YAAY,KAAK,KAAK,CAAC;YAC9C,MAAM,KAAK,GAAG,EAAE,GAAG,iBAAiB,EAAE,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC;YACtD,GAAG,CAAC,IAAI,CACJ,IAAI,EACJ;gBACI,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,MAAM,EAAE,WAAW;gBACnB,QAAQ;gBACR,WAAW,EAAE,GAAG,CAAC,WAAW;gBAC5B,SAAS,EAAE,GAAG,CAAC,SAAS;gBACxB,GAAG,EAAE,CAAC,CAAC,GAAG;gBACV,GAAG,EAAE,CAAC,CAAC,GAAG;gBACV,SAAS;gBACT,YAAY;gBACZ,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC;oBAClB,SAAS,EAAI,KAAK,CAAC,SAAS;oBAC5B,WAAW,EAAE,KAAK,CAAC,WAAW;oBAC9B,SAAS,EAAI,iBAAiB,CAAC,KAAK,CAAC,OAAO,CAAC;oBAC7C,SAAS,EAAI,KAAK,CAAC,SAAS,GAAG,CAAC,GAAG,CAAC,UAAU,IAAI,CAAC,CAAC;oBACpD,QAAQ,EAAK,KAAK,CAAC,QAAQ;oBAC3B,OAAO,EAAM,KAAK,CAAC,OAAO,GAAG,CAAC,GAAG,CAAC,UAAU,IAAI,CAAC,CAAC;oBAClD,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;iBAC7C,CAAC,CAAC,CAAC,SAAS;aAChB,CACJ,CAAC;QACN,CAAC;IAEL,CAAC;AACL,CAAC"}

package/dist/renderer-color-readback.d.ts

@@ -0,0 +1,50 @@
+/** Bounded, post-pass color-frame readback used by strict hardware witnesses. */
+/** A central, actual-color crop copied from the presented production color target. */
+export interface RendererColorFrame {
+    width: number;
+    height: number;
+    rgba: Uint8ClampedArray;
+}
+interface ColorFrameCopy {
+    buffer: GPUBuffer;
+    width: number;
+    height: number;
+    bytesPerRow: number;
+    bgra: boolean;
+}
+interface PendingRendererColorFrame {
+    encoded: boolean;
+    skippedFrames: number;
+    promise: Promise<RendererColorFrame | null>;
+    resolve: (frame: RendererColorFrame | null) => void;
+}
+export interface RendererColorFrameCapture {
+    pending: PendingRendererColorFrame;
+    sourceTexture: GPUTexture;
+    width: number;
+    height: number;
+    format: GPUTextureFormat;
+}
+/**
+ * Appends a color copy after every production pass, so the bytes describe the
+ * exact submitted frame instead of compositor or scene-residency state.
+ */
+export declare function encodeRendererColorFrameReadback(device: GPUDevice, encoder: GPUCommandEncoder, texture: GPUTexture, frameWidth: number, frameHeight: number, format: GPUTextureFormat): ColorFrameCopy;
+/** Maps and normalizes an encoded color copy. Call only after its command buffer submitted. */
+export declare function resolveRendererColorFrameReadback(copy: ColorFrameCopy): Promise<RendererColorFrame | null>;
+/** Queue one bounded readback for a renderer host, coalescing concurrent callers. */
+export declare function requestRendererColorFrame(host: object, available: boolean, requestRender: () => void): Promise<RendererColorFrame | null>;
+/** Cancels on terminal device loss, render error, or renderer teardown. */
+export declare function cancelRendererColorFrame(host: object): void;
+/** Re-request up to three transient context/resize skips, never an endless frame loop. */
+export declare function retryRendererColorFrame(host: object, requestRender: () => void): void;
+/** Binds one pending request to the copy-capable production canvas texture. */
+export declare function beginRendererColorFrameCapture(host: object, sourceTexture: GPUTexture, width: number, height: number, format: GPUTextureFormat): RendererColorFrameCapture | null;
+/** Encodes a color copy before the frame command buffer is submitted. */
+export declare function encodeRendererColorFrameCapture(device: GPUDevice, encoder: GPUCommandEncoder, capture: RendererColorFrameCapture): ColorFrameCopy;
+/** Settles the requester once its submitted canvas copy maps. */
+export declare function settleRendererColorFrameCapture(host: object, capture: RendererColorFrameCapture, copy: ColorFrameCopy): void;
+/** Frees a copy whose command buffer could not be submitted. */
+export declare function discardRendererColorFrameReadback(copy: ColorFrameCopy | null): void;
+export {};
+//# sourceMappingURL=renderer-color-readback.d.ts.map

package/dist/renderer-color-readback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer-color-readback.d.ts","sourceRoot":"","sources":["../src/renderer-color-readback.ts"],"names":[],"mappings":"AAIA,iFAAiF;AAEjF,sFAAsF;AACtF,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,iBAAiB,CAAC;CACzB;AAED,UAAU,cAAc;IACtB,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,UAAU,yBAAyB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;IAC5C,OAAO,EAAE,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI,KAAK,IAAI,CAAC;CACrD;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,yBAAyB,CAAC;IACnC,aAAa,EAAE,UAAU,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,gBAAgB,CAAC;CAC1B;AAoBD;;;GAGG;AACH,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,UAAU,EACnB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,gBAAgB,GACvB,cAAc,CAkBhB;AAED,+FAA+F;AAC/F,wBAAsB,iCAAiC,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAyBhH;AAED,qFAAqF;AACrF,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,OAAO,EAClB,aAAa,EAAE,MAAM,IAAI,GACxB,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAiBpC;AAED,2EAA2E;AAC3E,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAK3D;AAED,0FAA0F;AAC1F,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,IAAI,GAAG,IAAI,CASrF;AAED,+EAA+E;AAC/E,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,UAAU,EACzB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,gBAAgB,GACvB,yBAAyB,GAAG,IAAI,CAUlC;AAED,yEAAyE;AACzE,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,yBAAyB,GACjC,cAAc,CAMhB;AAED,iEAAiE;AACjE,wBAAgB,+BAA+B,CAC7C,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,yBAAyB,EAClC,IAAI,EAAE,cAAc,GACnB,IAAI,CAMN;AAED,gEAAgE;AAChE,wBAAgB,iCAAiC,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,GAAG,IAAI,CAEnF"}

package/dist/renderer-color-readback.js

@@ -0,0 +1,145 @@
+/* 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/. */
+/** Keep debug/readback work bounded even for a full-screen 8K production viewport. */
+const MAX_COLOR_FRAME_DIMENSION = 512;
+const PIXEL_BYTES = 4;
+const COPY_ROW_ALIGNMENT = 256;
+const MAX_COLOR_FRAME_CAPTURE_SKIPS = 3;
+const pendingCaptures = new WeakMap();
+function captureDimensions(width, height) {
+    const capturedWidth = Math.min(width, MAX_COLOR_FRAME_DIMENSION);
+    const capturedHeight = Math.min(height, MAX_COLOR_FRAME_DIMENSION);
+    return {
+        x: Math.floor((width - capturedWidth) / 2),
+        y: Math.floor((height - capturedHeight) / 2),
+        width: capturedWidth,
+        height: capturedHeight,
+    };
+}
+/**
+ * Appends a color copy after every production pass, so the bytes describe the
+ * exact submitted frame instead of compositor or scene-residency state.
+ */
+export function encodeRendererColorFrameReadback(device, encoder, texture, frameWidth, frameHeight, format) {
+    const region = captureDimensions(frameWidth, frameHeight);
+    const bytesPerRow = Math.ceil((region.width * PIXEL_BYTES) / COPY_ROW_ALIGNMENT) * COPY_ROW_ALIGNMENT;
+    const buffer = device.createBuffer({
+        size: bytesPerRow * region.height,
+        usage: GPUBufferUsage.COPY_DST | GPUBufferUsage.MAP_READ,
+    });
+    try {
+        encoder.copyTextureToBuffer({ texture, origin: { x: region.x, y: region.y, z: 0 } }, { buffer, bytesPerRow, rowsPerImage: region.height }, { width: region.width, height: region.height, depthOrArrayLayers: 1 });
+    }
+    catch (error) {
+        buffer.destroy();
+        throw error;
+    }
+    return { buffer, width: region.width, height: region.height, bytesPerRow, bgra: format.startsWith('bgra') };
+}
+/** Maps and normalizes an encoded color copy. Call only after its command buffer submitted. */
+export async function resolveRendererColorFrameReadback(copy) {
+    let mapped = false;
+    try {
+        // GPUMapMode.READ = 1. The package's browser typings intentionally do not
+        // require the runtime global to exist in Node-only renderer tests.
+        await copy.buffer.mapAsync(1);
+        mapped = true;
+        const source = new Uint8Array(copy.buffer.getMappedRange());
+        const rgba = new Uint8ClampedArray(copy.width * copy.height * PIXEL_BYTES);
+        for (let row = 0; row < copy.height; row++)
+            for (let column = 0; column < copy.width; column++) {
+                const from = row * copy.bytesPerRow + column * PIXEL_BYTES;
+                const to = (row * copy.width + column) * PIXEL_BYTES;
+                rgba[to] = copy.bgra ? source[from + 2] : source[from];
+                rgba[to + 1] = source[from + 1];
+                rgba[to + 2] = copy.bgra ? source[from] : source[from + 2];
+                rgba[to + 3] = source[from + 3];
+            }
+        return { width: copy.width, height: copy.height, rgba };
+    }
+    catch (error) {
+        console.warn('[Renderer] Color-frame readback failed:', error);
+        return null;
+    }
+    finally {
+        if (mapped)
+            copy.buffer.unmap();
+        copy.buffer.destroy();
+    }
+}
+/** Queue one bounded readback for a renderer host, coalescing concurrent callers. */
+export function requestRendererColorFrame(host, available, requestRender) {
+    if (!available)
+        return Promise.resolve(null);
+    const existing = pendingCaptures.get(host);
+    if (existing)
+        return existing.promise;
+    let resolve;
+    const promise = new Promise((finish) => { resolve = finish; });
+    pendingCaptures.set(host, { encoded: false, skippedFrames: 0, promise, resolve });
+    try {
+        requestRender();
+    }
+    catch (error) {
+        // A synchronous host failure must not strand the coalescing entry: a
+        // later caller needs to be able to request a fresh frame.
+        pendingCaptures.delete(host);
+        resolve(null);
+        return Promise.reject(error);
+    }
+    return promise;
+}
+/** Cancels on terminal device loss, render error, or renderer teardown. */
+export function cancelRendererColorFrame(host) {
+    const pending = pendingCaptures.get(host);
+    if (!pending)
+        return;
+    pendingCaptures.delete(host);
+    pending.resolve(null);
+}
+/** Re-request up to three transient context/resize skips, never an endless frame loop. */
+export function retryRendererColorFrame(host, requestRender) {
+    const pending = pendingCaptures.get(host);
+    if (!pending || pending.encoded)
+        return;
+    if (pending.skippedFrames >= MAX_COLOR_FRAME_CAPTURE_SKIPS) {
+        cancelRendererColorFrame(host);
+        return;
+    }
+    pending.skippedFrames++;
+    requestRender();
+}
+/** Binds one pending request to the copy-capable production canvas texture. */
+export function beginRendererColorFrameCapture(host, sourceTexture, width, height, format) {
+    const pending = pendingCaptures.get(host);
+    if (!pending || pending.encoded)
+        return null;
+    return {
+        pending,
+        sourceTexture,
+        width,
+        height,
+        format,
+    };
+}
+/** Encodes a color copy before the frame command buffer is submitted. */
+export function encodeRendererColorFrameCapture(device, encoder, capture) {
+    const copy = encodeRendererColorFrameReadback(device, encoder, capture.sourceTexture, capture.width, capture.height, capture.format);
+    capture.pending.encoded = true;
+    return copy;
+}
+/** Settles the requester once its submitted canvas copy maps. */
+export function settleRendererColorFrameCapture(host, capture, copy) {
+    void resolveRendererColorFrameReadback(copy).then((frame) => {
+        if (pendingCaptures.get(host) !== capture.pending)
+            return;
+        pendingCaptures.delete(host);
+        capture.pending.resolve(frame);
+    });
+}
+/** Frees a copy whose command buffer could not be submitted. */
+export function discardRendererColorFrameReadback(copy) {
+    copy?.buffer.destroy();
+}
+//# sourceMappingURL=renderer-color-readback.js.map

package/dist/renderer-color-readback.js.map

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