@aura3d/engine 3.0.0 → 4.0.0

package/dist/rendering/forward/Transmission.d.ts

@@ -0,0 +1,62 @@
+import { BaseRenderPass, type RenderPassContext } from "../RenderPass.js";
+import { type FrameContributor, type FrameContributorContext } from "../contracts/frameGraph.js";
+import type { RenderItem } from "../contracts/renderItem.js";
+import { TransmissionRenderTarget } from "../TransmissionRenderTarget.js";
+export declare const TRANSMISSION_PHASE: "transmission";
+export declare const TRANSMISSION_BLACKBOARD_KEY = "prd04.transmissionTarget";
+export declare const TRANSMISSION_LANE_RESOURCE = "prd04.transmission.color";
+/** Same predicate ForwardPass uses for the transmissive queue (blend materials never count). */
+export declare function itemReportsTransmissionLobe(item: RenderItem): boolean;
+export interface Prd04TransmissionDiagnostics {
+    readonly targetActive: boolean;
+    readonly format: "rgba16f" | "rgba8" | null;
+    readonly mipCount: number;
+    readonly scale: number | null;
+    readonly sourceCopied: boolean;
+    /** C-28: texture readbacks performed by the capture pass (must stay 0). */
+    readonly readbacks: number;
+    readonly issues: readonly string[];
+}
+/** Observed state for the C-31 `materials` diagnostics section. */
+export declare function prd04TransmissionDiagnostics(): Prd04TransmissionDiagnostics;
+/**
+ * GPU-side copy pass: draws the resolved scene colour into the lane target
+ * with a fullscreen triangle, then publishes the target on the blackboard.
+ * The mip chain contract lives on `TransmissionRenderTarget` (the device
+ * allocates mip storage when the target is sampled); no readback is
+ * performed (C-28).
+ *
+ * The pass instance is cached per device by the contributor (T0-18e): the
+ * copy vertex buffer and shader program are allocated once in
+ * `ensureCopyResources` instead of leaking one pair per frame. `configure`
+ * re-points the pass at the current contributor context before the graph
+ * executes it.
+ */
+declare class TransmissionCapturePass extends BaseRenderPass {
+    private readonly target;
+    private readonly format;
+    private buffer;
+    private program;
+    private frame;
+    private scale;
+    constructor(target: TransmissionRenderTarget, format: "rgba16f" | "rgba8", reads: readonly string[]);
+    /** Re-point at this frame's contributor context + scale (one pass per device/mode). */
+    configure(frame: FrameContributorContext, scale: number): void;
+    execute(context: RenderPassContext): void;
+    private ensureCopyResources;
+    dispose(): void;
+}
+export declare class TransmissionFrameContributor implements FrameContributor {
+    readonly id = "prd04.transmission";
+    readonly owner: "prd04";
+    readonly flag: "A3D_QR_MATERIALS_TRANSMISSION";
+    readonly phases: readonly ["transmission"];
+    private readonly devices;
+    passes(phase: string, ctx: FrameContributorContext): readonly TransmissionCapturePass[];
+    dispose(): void;
+}
+export declare const transmissionFrameContributor: FrameContributor;
+/** Idempotent registration for the lane barrel (import-time). */
+export declare function registerPrd04TransmissionContributor(): void;
+export {};
+//# sourceMappingURL=Transmission.d.ts.map

package/dist/rendering/forward/Transmission.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Transmission.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/forward/Transmission.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,cAAc,EAAE,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC7B,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAM7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAU1E,eAAO,MAAM,kBAAkB,EAAG,cAAuB,CAAC;AAC1D,eAAO,MAAM,2BAA2B,6BAA6B,CAAC;AACtE,eAAO,MAAM,0BAA0B,6BAA6B,CAAC;AA4CrE,gGAAgG;AAChG,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CASrE;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,IAAI,CAAC;IAC5C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,2EAA2E;IAC3E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAcD,mEAAmE;AACnE,wBAAgB,4BAA4B,IAAI,4BAA4B,CAE3E;AAYD;;;;;;;;;;;;GAYG;AACH,cAAM,uBAAwB,SAAQ,cAAc;IAOhD,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAPzB,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,OAAO,CAAoC;IACnD,OAAO,CAAC,KAAK,CAAwC;IACrD,OAAO,CAAC,KAAK,CAAK;gBAGC,MAAM,EAAE,wBAAwB,EAChC,MAAM,EAAE,SAAS,GAAG,OAAO,EAC5C,KAAK,EAAE,SAAS,MAAM,EAAE;IAU1B,uFAAuF;IACvF,SAAS,CAAC,KAAK,EAAE,uBAAuB,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAK9D,OAAO,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IA4DzC,OAAO,CAAC,mBAAmB;IAS3B,OAAO,IAAI,IAAI;CAMhB;AAmBD,qBAAa,4BAA6B,YAAW,gBAAgB;IACnE,QAAQ,CAAC,EAAE,wBAAwB;IACnC,QAAQ,CAAC,KAAK,EAAG,OAAO,CAAU;IAClC,QAAQ,CAAC,IAAI,EAAG,+BAA+B,CAAU;IACzD,QAAQ,CAAC,MAAM,4BAAiC;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoD;IAE5E,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,uBAAuB,GAAG,SAAS,uBAAuB,EAAE;IA2CvF,OAAO,IAAI,IAAI;CAWhB;AAED,eAAO,MAAM,4BAA4B,EAAE,gBAAqD,CAAC;AAIjG,iEAAiE;AACjE,wBAAgB,oCAAoC,IAAI,IAAI,CAI3D"}

package/dist/rendering/forward/Transmission.js

@@ -0,0 +1,299 @@
+// PRD-04 §9.1 transmission capture contributor (P4-1). The contributor owns one
+// lane resource: a mipmapped scene-colour copy that generated programs sample
+// for KHR_materials_transmission/volume refraction.
+//
+// Behaviour (all behind A3D_QR_MATERIALS_TRANSMISSION on the registry):
+//   - `passes("transmission", ctx)` returns one copy pass when any
+//     `ctx.items` entry's material reports the transmission lobe; `[]`
+//     otherwise (including on the Low tier — no target is allocated).
+//   - Reads the produced colour resource (`aura.scene.color.opaque` on the v2
+//     path, `color` on the legacy path — T0-18(c)), writes
+//     `prd04.transmission.color` (lane-named, so no RenderGraph write
+//     conflict) and publishes the target on the blackboard under
+//     `prd04.transmissionTarget`.
+//   - Format: RGBA16F when `device.probe?.halfFloatColorBuffer`, else RGBA8
+//     with issue `transmission-ldr-capture` (C-28). No readback: the copy is a
+//     GPU-side fullscreen draw sourcing the `prd01.forwardTarget` RenderTarget
+//     published on the blackboard.
+//   - Scale: 0.5 on Medium, 1 on High/Ultra, none on Low (C-27 tier).
+//
+// Back-to-front transmissive ordering is the integrated-pass order (C-01 real);
+// against the stub the contributor still captures and publishes — the lane
+// scenes prove ordering standalone.
+import { BaseRenderPass } from "../RenderPass.js";
+import {} from "../contracts/frameGraph.js";
+import { QUALITY_TIERS } from "../contracts/quality.js";
+import { registerFrameContributor } from "../contracts/frameGraph.js";
+import { TextureBinding } from "../TextureBinding.js";
+import { MaterialInstance } from "../MaterialInstance.js";
+import { TransmissionRenderTarget } from "../TransmissionRenderTarget.js";
+import { setCapturedTransmissionTarget } from "./transmissionTargetStore.js";
+import { PRD01_FORWARD_TARGET } from "../renderer/FrameGraph.js";
+import { qrCoreOutputOn } from "../renderer/qrSubFlags.js";
+import { TRANSMISSION_COPY_FRAGMENT, TRANSMISSION_COPY_MARKER, TRANSMISSION_COPY_VERTEX } from "../shaders/physical/transmission_copy.glsl.js";
+export const TRANSMISSION_PHASE = "transmission";
+export const TRANSMISSION_BLACKBOARD_KEY = "prd04.transmissionTarget";
+export const TRANSMISSION_LANE_RESOURCE = "prd04.transmission.color";
+/** Scale of the capture relative to the frame buffer, per C-27 tier (`none` on Low). */
+const TRANSMISSION_TIER_SCALE = {
+    low: null,
+    medium: 0.5,
+    high: 1,
+    ultra: 1
+};
+/**
+ * The tier settings object carries no tier name — resolve by matching
+ * QUALITY_TIERS. Field comparison (no JSON.stringify): `resolveTierSettings`
+ * returns fresh objects, so identity alone misses override-free copies.
+ */
+function tierSettingsEqual(a, b) {
+    for (const key of Object.keys(a)) {
+        if (key === "shadow") {
+            const sa = a.shadow, sb = b.shadow;
+            if (sa.mapSize !== sb.mapSize || sa.cascades !== sb.cascades || sa.filter !== sb.filter
+                || sa.localShadowLights !== sb.localShadowLights || sa.contact !== sb.contact)
+                return false;
+        }
+        else if (key === "froxelGrid") {
+            const ga = a.froxelGrid, gb = b.froxelGrid;
+            if ((ga === null) !== (gb === null))
+                return false;
+            if (ga && gb && (ga[0] !== gb[0] || ga[1] !== gb[1] || ga[2] !== gb[2]))
+                return false;
+        }
+        else if (a[key] !== b[key]) {
+            return false;
+        }
+    }
+    return true;
+}
+function resolveTierName(tier) {
+    for (const name of ["low", "medium", "high", "ultra"]) {
+        if (tier === QUALITY_TIERS[name] || tierSettingsEqual(tier, QUALITY_TIERS[name]))
+            return name;
+    }
+    return "high";
+}
+function numericParameter(material, name) {
+    const value = material.getParameter(name);
+    return typeof value === "number" && Number.isFinite(value) ? value : 0;
+}
+/** Same predicate ForwardPass uses for the transmissive queue (blend materials never count). */
+export function itemReportsTransmissionLobe(item) {
+    const material = item.material;
+    if (!material)
+        return false;
+    const base = material instanceof MaterialInstance ? material.baseMaterial : material;
+    if (!base)
+        return false;
+    if (base.renderState?.blend)
+        return false;
+    return numericParameter(base, "u_transmissionFactor") > 0.001
+        || numericParameter(base, "u_diffuseTransmissionFactor") > 0.001
+        || numericParameter(base, "u_volumeThicknessFactor") > 0.001;
+}
+const INACTIVE_DIAGNOSTICS = {
+    targetActive: false,
+    format: null,
+    mipCount: 0,
+    scale: null,
+    sourceCopied: false,
+    readbacks: 0,
+    issues: []
+};
+let lastDiagnostics = INACTIVE_DIAGNOSTICS;
+/** Observed state for the C-31 `materials` diagnostics section. */
+export function prd04TransmissionDiagnostics() {
+    return { ...lastDiagnostics, issues: [...lastDiagnostics.issues] };
+}
+// The device requires `marker` to appear verbatim in both GLSL stages.
+// GLSL lives in `shaders/physical/transmission_copy.glsl.ts` (glsl-location
+// arch-gate allows `#version` strings only in chunk/post/output locations).
+const COPY_SHADER = {
+    label: "a3d-prd04-transmission-copy",
+    marker: TRANSMISSION_COPY_MARKER,
+    vertex: TRANSMISSION_COPY_VERTEX,
+    fragment: TRANSMISSION_COPY_FRAGMENT
+};
+/**
+ * GPU-side copy pass: draws the resolved scene colour into the lane target
+ * with a fullscreen triangle, then publishes the target on the blackboard.
+ * The mip chain contract lives on `TransmissionRenderTarget` (the device
+ * allocates mip storage when the target is sampled); no readback is
+ * performed (C-28).
+ *
+ * The pass instance is cached per device by the contributor (T0-18e): the
+ * copy vertex buffer and shader program are allocated once in
+ * `ensureCopyResources` instead of leaking one pair per frame. `configure`
+ * re-points the pass at the current contributor context before the graph
+ * executes it.
+ */
+class TransmissionCapturePass extends BaseRenderPass {
+    target;
+    format;
+    buffer = null;
+    program = null;
+    frame = null;
+    scale = 1;
+    constructor(target, format, reads) {
+        // T0-18(c): the copy reads the colour resource the graph actually
+        // produces — `aura.scene.color.opaque` on the v2 path (written by
+        // `prd01.opaque`, before `prd01.transmission` draws transmissives on top)
+        // or `color` on the legacy path. Declaring `reads: []` hid the ordering
+        // and let the copy run against an unproduced target.
+        super("prd04.transmission.capture", reads, [TRANSMISSION_LANE_RESOURCE]);
+        this.target = target;
+        this.format = format;
+    }
+    /** Re-point at this frame's contributor context + scale (one pass per device/mode). */
+    configure(frame, scale) {
+        this.frame = frame;
+        this.scale = scale;
+    }
+    execute(context) {
+        if (!this.frame)
+            return;
+        const frame = this.frame;
+        const width = Math.max(1, Math.round(context.width * this.scale));
+        const height = Math.max(1, Math.round(context.height * this.scale));
+        this.target.resize(width, height);
+        const texture = this.target.texture;
+        const issues = [];
+        if (this.format === "rgba8") {
+            // C-28: no half-float color buffer → the capture degrades to LDR.
+            issues.push("transmission-ldr-capture");
+        }
+        if (texture) {
+            frame.blackboard.set(TRANSMISSION_BLACKBOARD_KEY, texture);
+            // T0-05: per-draw bindUniforms has no blackboard; see transmissionTargetStore.
+            setCapturedTransmissionTarget({ texture: texture.colorTexture, width, height });
+        }
+        else {
+            // 04-S10 / T0-18(d): never leave a previous frame's target bound.
+            setCapturedTransmissionTarget(undefined);
+        }
+        // The producer publishes its RenderTarget under PRD01_FORWARD_TARGET once
+        // the forward target exists (HDR path and postprocess path both do); on
+        // paths without one the copy is skipped (no readback fallback — that
+        // would violate C-28 `readbacks === 0`).
+        const source = frame.blackboard.get(PRD01_FORWARD_TARGET);
+        let copied = false;
+        if (source && texture) {
+            this.ensureCopyResources(context.device);
+            if (this.buffer && this.program) {
+                // T0-18(d): restore the bound target — the forward target must still
+                // be bound when the transmissive forward pass runs after us.
+                const previous = context.device.getRenderTarget?.() ?? null;
+                context.device.setRenderTarget(texture);
+                context.device.draw({
+                    label: "prd04-transmission-scene-color-copy",
+                    topology: "triangles",
+                    vertexBuffer: this.buffer,
+                    vertexCount: 3,
+                    shader: this.program,
+                    uniforms: new Map([
+                        ["u_source", new TextureBinding({ name: "u_source", texture: source.colorTexture })]
+                    ])
+                });
+                context.device.setRenderTarget(previous);
+                copied = true;
+            }
+        }
+        lastDiagnostics = {
+            targetActive: texture !== undefined,
+            format: this.format,
+            mipCount: this.target.mipCount,
+            scale: this.scale,
+            sourceCopied: copied,
+            // The copy is device-to-device (setRenderTarget + draw); no readPixels
+            // or mapped-readback call exists on this path (C-28).
+            readbacks: 0,
+            issues
+        };
+    }
+    ensureCopyResources(device) {
+        if (!this.buffer) {
+            this.buffer = device.createBuffer("vertex", 3 * 2 * 4, new Float32Array(6));
+        }
+        if (!this.program) {
+            this.program = device.createShaderProgram(COPY_SHADER);
+        }
+    }
+    dispose() {
+        this.buffer?.dispose();
+        this.buffer = null;
+        this.program?.dispose();
+        this.program = null;
+    }
+}
+/** Colour resource written by the v2 `prd01.opaque` ForwardPass (Renderer.ts). */
+const V2_OPAQUE_COLOR_RESOURCE = "aura.scene.color.opaque";
+/** Colour resource written by the legacy-path ForwardPass default (`writes: ["color"]`). */
+const LEGACY_COLOR_RESOURCE = "color";
+export class TransmissionFrameContributor {
+    id = "prd04.transmission";
+    owner = "prd04";
+    flag = "A3D_QR_MATERIALS_TRANSMISSION";
+    phases = [TRANSMISSION_PHASE];
+    devices = new Map();
+    passes(phase, ctx) {
+        if (phase !== TRANSMISSION_PHASE)
+            return [];
+        const scale = TRANSMISSION_TIER_SCALE[resolveTierName(ctx.tier)];
+        if (scale === null || scale === undefined) {
+            lastDiagnostics = INACTIVE_DIAGNOSTICS;
+            // 04-S10: no capture this frame -> the store must not keep last frame's target.
+            setCapturedTransmissionTarget(undefined);
+            return [];
+        }
+        if (!ctx.items.some(itemReportsTransmissionLobe)) {
+            lastDiagnostics = INACTIVE_DIAGNOSTICS;
+            // 04-S10: no capture this frame -> the store must not keep last frame's target.
+            setCapturedTransmissionTarget(undefined);
+            return [];
+        }
+        let state = this.devices.get(ctx.device);
+        if (!state) {
+            const format = ctx.device.probe?.halfFloatColorBuffer ? "rgba16f" : "rgba8";
+            state = {
+                target: new TransmissionRenderTarget(ctx.device, { width: 1, height: 1 }, { format }),
+                format,
+                passes: {}
+            };
+            this.devices.set(ctx.device, state);
+        }
+        // v2 graphs order the capture after `aura.scene.color.opaque`; legacy
+        // graphs after `color` (the ForwardPass default write). Both are produced
+        // by passes that exist on every graph that runs this phase.
+        const v2 = ctx.flags !== undefined && qrCoreOutputOn(ctx.flags);
+        const key = v2 ? "v2" : "legacy";
+        let pass = state.passes[key];
+        if (!pass) {
+            pass = new TransmissionCapturePass(state.target, state.format, [v2 ? V2_OPAQUE_COLOR_RESOURCE : LEGACY_COLOR_RESOURCE]);
+            state.passes[key] = pass;
+        }
+        pass.configure(ctx, scale);
+        return [pass];
+    }
+    dispose() {
+        for (const state of this.devices.values()) {
+            state.passes.v2?.dispose();
+            state.passes.legacy?.dispose();
+            state.target.dispose();
+        }
+        this.devices.clear();
+        lastDiagnostics = INACTIVE_DIAGNOSTICS;
+        // T0-18(d): the disposed targets' textures must not stay reachable from the store.
+        setCapturedTransmissionTarget(undefined);
+    }
+}
+export const transmissionFrameContributor = new TransmissionFrameContributor();
+let contributorRegistered = false;
+/** Idempotent registration for the lane barrel (import-time). */
+export function registerPrd04TransmissionContributor() {
+    if (contributorRegistered)
+        return;
+    contributorRegistered = true;
+    registerFrameContributor(transmissionFrameContributor);
+}
+//# sourceMappingURL=Transmission.js.map

package/dist/rendering/forward/Transmission.js.map

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

package/dist/rendering/forward/Velocity.d.ts

@@ -0,0 +1,47 @@
+import { type TemporalHistoryLike } from "../contracts/velocity.js";
+import type { RenderItem } from "../contracts/renderItem.js";
+import type { UniformValue } from "../RenderDevice.js";
+export type VelocityUniformBinder = (item: RenderItem, uniforms: Map<string, UniformValue>) => void;
+export declare let bindVelocityUniforms: VelocityUniformBinder | undefined;
+/** Called once from the PRD 03 lane barrel when the real binder exists. */
+export declare function setVelocityUniformBinder(binder: VelocityUniformBinder | undefined): void;
+/**
+ * Camera-level history for the C-14 velocity MRT (S1 camera velocity). The
+ * contract `TemporalHistoryLike` is per-frame: it returns the jittered,
+ * unjittered and previous clip-space view-projection for the current frame.
+ * Per-item `previousModelMatrix` stays on `RenderItem` (C-14 fields).
+ */
+export declare class VelocityHistory implements TemporalHistoryLike {
+    private previousViewProjection;
+    private frame;
+    prepare(viewProjection: Float32Array, jitter: readonly [number, number]): {
+        readonly jittered: Float32Array;
+        readonly unjittered: Float32Array;
+        readonly previous: Float32Array;
+    };
+    jitter(width: number, height: number): readonly [number, number];
+    reset(_reason: "camera-cut" | "resize" | "tier-change" | "scene-swap"): void;
+}
+/** Live read for `diagnostics().post.velocityCoverage` + the AA resolve. */
+export declare function postVelocityCoverage(): {
+    readonly items: number;
+    readonly withVelocity: number;
+    readonly moving: number;
+    readonly movingWithHistory: number;
+};
+/**
+ * C-14 surface: `history` is the camera-level `TemporalHistoryLike` impl the
+ * velocity MRT prepares with; `kind` marks stub vs real for conformance.
+ */
+export interface VelocitySurface {
+    readonly kind: "legacy" | "v2";
+    readonly history: TemporalHistoryLike;
+}
+export declare const velocityHistorySlot: import("@aura3d/engine/rendering").ContractSlot<VelocitySurface>;
+/**
+ * Called once from `lanes/prd03.ts` (PR 0a barrel). Registers the real history
+ * as the C-14 `TemporalHistoryLike` impl — additive today: nothing else calls
+ * `setTemporalHistoryImpl`, and `resetTemporalHistory` previously no-oped.
+ */
+export declare function provideVelocityHistory(): void;
+//# sourceMappingURL=Velocity.d.ts.map

package/dist/rendering/forward/Velocity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Velocity.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/forward/Velocity.ts"],"names":[],"mappings":"AAKA,OAAO,EAA0B,KAAK,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC5F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,MAAM,qBAAqB,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,KAAK,IAAI,CAAC;AAEpG,eAAO,IAAI,oBAAoB,EAAE,qBAAqB,GAAG,SAAS,CAAC;AAEnE,2EAA2E;AAC3E,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,qBAAqB,GAAG,SAAS,GAAG,IAAI,CAExF;AA+BD;;;;;GAKG;AACH,qBAAa,eAAgB,YAAW,mBAAmB;IACzD,OAAO,CAAC,sBAAsB,CAA2B;IACzD,OAAO,CAAC,KAAK,CAAK;IAElB,OAAO,CAAC,cAAc,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG;QAAE,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;QAAC,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAA;KAAE;IAuBjL,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;IAIhE,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,QAAQ,GAAG,aAAa,GAAG,YAAY,GAAG,IAAI;CAQ7E;AAkBD,4EAA4E;AAC5E,wBAAgB,oBAAoB,IAAI;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;CAAE,CAE7J;AAoCD;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;CACvC;AAWD,eAAO,MAAM,mBAAmB,kEAK/B,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAK7C"}

package/dist/rendering/forward/Velocity.js

@@ -0,0 +1,153 @@
+// PR 0b-2 seam (CONTRACTS.md §3.3) — velocity-MRT uniform binding hook (C-14),
+// owned by PRD 03. No-op until PRD 03 registers a binder; the ForwardPass calls
+// `bindVelocityUniforms?.(item, uniforms)` once per draw.
+import { defineContractSlot } from "../contracts/core.js";
+import { setTemporalHistoryImpl } from "../contracts/velocity.js";
+export let bindVelocityUniforms;
+/** Called once from the PRD 03 lane barrel when the real binder exists. */
+export function setVelocityUniformBinder(binder) {
+    bindVelocityUniforms = binder;
+}
+/* ------------------------------------------------------------------------- */
+/* C-14 real: camera-level temporal history + velocity-MRT uniform binding.   */
+/* ------------------------------------------------------------------------- */
+/**
+ * Per-frame camera matrices the velocity-MRT chunk needs, captured by
+ * `VelocityHistory.prepare`. The binder reads them here because the seam's
+ * signature (`item, uniforms`) carries no camera — module state is the only
+ * channel that stays inside `forward/`.
+ */
+let cameraMatrices;
+/**
+ * Aperiodic jitter shared with `TemporalHistory.jitter`: base-2 Halton would
+ * lock coverage to an object's motion phase, so the same irrational
+ * increments are used. Zero on the seed frame — nothing previous exists.
+ */
+function jitterOffset(frame, valid, width, height) {
+    if (!valid)
+        return [0, 0];
+    return [
+        (((0.5 + frame * ((Math.sqrt(5) - 1) / 2)) % 1) - 0.5) * 2 / width,
+        (((0.5 + frame * ((Math.sqrt(2) - 1)) % 1) - 0.5) * 2) / height
+    ];
+}
+/**
+ * Camera-level history for the C-14 velocity MRT (S1 camera velocity). The
+ * contract `TemporalHistoryLike` is per-frame: it returns the jittered,
+ * unjittered and previous clip-space view-projection for the current frame.
+ * Per-item `previousModelMatrix` stays on `RenderItem` (C-14 fields).
+ */
+export class VelocityHistory {
+    previousViewProjection;
+    frame = 0;
+    prepare(viewProjection, jitter) {
+        const unjittered = new Float32Array(viewProjection);
+        // Jitter in clip space: column 3 offset scaled by w — same convention as
+        // TemporalHistory.prepare (`current[col*4] += jitter * current[col*4+3]`).
+        const jittered = new Float32Array(unjittered);
+        if (jitter[0] !== 0 || jitter[1] !== 0) {
+            for (let col = 0; col < 4; col += 1) {
+                jittered[col * 4] = jittered[col * 4] + jitter[0] * jittered[col * 4 + 3];
+                jittered[col * 4 + 1] = jittered[col * 4 + 1] + jitter[1] * jittered[col * 4 + 3];
+            }
+        }
+        const previous = this.previousViewProjection ?? unjittered;
+        this.previousViewProjection = unjittered;
+        this.frame += 1;
+        // Frame boundary for the rigid item cache: what the binder collects
+        // during this frame's draws becomes "previous" at the next prepare.
+        previousModels = pendingModels;
+        pendingModels = new Map();
+        coverage = { items: 0, withVelocity: 0, moving: 0, movingWithHistory: 0 };
+        cameraMatrices = { jittered, unjittered, previous };
+        return cameraMatrices;
+    }
+    jitter(width, height) {
+        return jitterOffset(this.frame, this.previousViewProjection !== undefined, width, height);
+    }
+    reset(_reason) {
+        this.previousViewProjection = undefined;
+        this.frame = 0;
+        previousModels = new Map();
+        pendingModels = new Map();
+        coverage = { items: 0, withVelocity: 0, moving: 0, movingWithHistory: 0 };
+        cameraMatrices = undefined;
+    }
+}
+/* ---------------------------------------------------------------------- */
+/* Rigid previous-model cache + coverage accounting (PRD-03 Phase 4).        */
+/* ---------------------------------------------------------------------- */
+/** Label → last frame's model matrix, committed at each VelocityHistory.prepare. */
+let previousModels = new Map();
+let pendingModels = new Map();
+/**
+ * C-14 → `post.velocityCoverage`: items tracked this frame, how many carry a
+ * previous matrix, and of the movers how many have history. `moving < 0`
+ * never happens: an item with no stored baseline counts as uncovered motion
+ * (conservative — its velocity would be wrong).
+ */
+let coverage = { items: 0, withVelocity: 0, moving: 0, movingWithHistory: 0 };
+/** Live read for `diagnostics().post.velocityCoverage` + the AA resolve. */
+export function postVelocityCoverage() {
+    return coverage;
+}
+function matEqual(a, b) {
+    if (b.length !== 16 || a.length !== 16)
+        return false;
+    for (let i = 0; i < 16; i += 1)
+        if (a[i] !== b[i])
+            return false;
+    return true;
+}
+/**
+ * The C-14 seam binder. Writes only when a velocity frame was prepared this
+ * frame (`cameraMatrices` set) — otherwise the map is untouched, so flag-off
+ * and non-MRT draws pay nothing and bind nothing.
+ */
+const velocityMrtBinder = (item, uniforms) => {
+    if (!cameraMatrices)
+        return;
+    uniforms.set("u_previousViewProjection", cameraMatrices.previous);
+    uniforms.set("u_unjitteredViewProjection", cameraMatrices.unjittered);
+    const label = item.label;
+    const model = item.modelMatrix ? Float32Array.from(item.modelMatrix) : undefined;
+    const previousModel = item.previousModelMatrix
+        ? Float32Array.from(item.previousModelMatrix)
+        : (label ? previousModels.get(label) : undefined) ?? model;
+    if (previousModel)
+        uniforms.set("u_previousModel", previousModel);
+    if (label && model) {
+        pendingModels.set(label, model);
+        const baseline = previousModels.get(label);
+        coverage = { ...coverage, items: coverage.items + 1 };
+        if (baseline !== undefined)
+            coverage = { ...coverage, withVelocity: coverage.withVelocity + 1 };
+        const moved = baseline === undefined || !matEqual(baseline, model);
+        if (moved) {
+            coverage = { ...coverage, moving: coverage.moving + 1 };
+            if (baseline !== undefined)
+                coverage = { ...coverage, movingWithHistory: coverage.movingWithHistory + 1 };
+        }
+    }
+};
+/** C-14 stub: identity history — previous == current every frame. */
+class LegacyVelocityHistoryStub {
+    prepare(viewProjection, _jitter) {
+        const copy = new Float32Array(viewProjection);
+        return { jittered: copy, unjittered: copy, previous: copy };
+    }
+    reset(_reason) { }
+}
+export const velocityHistorySlot = defineContractSlot("C-14", "prd03", "A3D_QR_POST", { kind: "legacy", history: new LegacyVelocityHistoryStub() });
+/**
+ * Called once from `lanes/prd03.ts` (PR 0a barrel). Registers the real history
+ * as the C-14 `TemporalHistoryLike` impl — additive today: nothing else calls
+ * `setTemporalHistoryImpl`, and `resetTemporalHistory` previously no-oped.
+ */
+export function provideVelocityHistory() {
+    const history = new VelocityHistory();
+    velocityHistorySlot.provide({ kind: "v2", history });
+    setTemporalHistoryImpl(history);
+    setVelocityUniformBinder(velocityMrtBinder);
+}
+//# sourceMappingURL=Velocity.js.map

package/dist/rendering/forward/Velocity.js.map

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

package/dist/rendering/forward/transmissionTargetStore.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Latest captured transmission target (PRD-04 P4-2, T0-05 review).
+ *
+ * The capture pass publishes the opaque-scene copy on the frame blackboard
+ * under `prd04.transmissionTarget`. Per-draw C-02 `bindUniforms` gets no frame
+ * context, so the capture also records it here and the
+ * `prd04.transmissionTarget` feature binds it as
+ * `a3d_prd04_transmissionSampler` / `a3d_prd04_transmissionSamplerSize`.
+ * Module store: the last captured frame wins, which matches the single
+ * renderer per page that lane 04 targets today (same pattern as the prd07
+ * wetness store). A material that pins `u_prd04TransmissionTarget` still wins.
+ */
+import type { Texture } from "../Texture.js";
+export interface CapturedTransmissionTarget {
+    readonly texture: Texture;
+    readonly width: number;
+    readonly height: number;
+}
+export declare function setCapturedTransmissionTarget(target: CapturedTransmissionTarget | undefined): void;
+export declare function capturedTransmissionTarget(): CapturedTransmissionTarget | undefined;
+//# sourceMappingURL=transmissionTargetStore.d.ts.map

package/dist/rendering/forward/transmissionTargetStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transmissionTargetStore.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/forward/transmissionTargetStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAID,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,0BAA0B,GAAG,SAAS,GAAG,IAAI,CAElG;AAED,wBAAgB,0BAA0B,IAAI,0BAA0B,GAAG,SAAS,CAEnF"}

package/dist/rendering/forward/transmissionTargetStore.js

@@ -0,0 +1,8 @@
+let latest;
+export function setCapturedTransmissionTarget(target) {
+    latest = target;
+}
+export function capturedTransmissionTarget() {
+    return latest;
+}
+//# sourceMappingURL=transmissionTargetStore.js.map

package/dist/rendering/forward/transmissionTargetStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transmissionTargetStore.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/forward/transmissionTargetStore.ts"],"names":[],"mappings":"AAoBA,IAAI,MAA8C,CAAC;AAEnD,MAAM,UAAU,6BAA6B,CAAC,MAA8C;IAC1F,MAAM,GAAG,MAAM,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,0BAA0B;IACxC,OAAO,MAAM,CAAC;AAChB,CAAC"}