@aura3d/engine 4.3.6 → 4.5.0

package/dist/rendering/passes/ContactShadowPass.d.ts

@@ -1,4 +1,5 @@
 import { BaseRenderPass, type RenderPassContext } from "../RenderPass.js";
+import type { RenderDevice } from "../RenderDevice.js";
 import type { Texture } from "../Texture.js";
 import type { RenderItem } from "../ForwardPass.js";
 import { type DepthPassOptions } from "../DepthPass.js";
@@ -15,8 +16,15 @@ export interface ContactShadowPassInput {
     readonly camera: {
         readonly viewMatrix: Float32Array;
         readonly projectionMatrix: Float32Array;
+        /**
+         * The combined matrix the forward pass rasterizes with. The production renderer's frame camera carries only this
+         * (its separate view/projection come through as identity), so the pass works from it when present and falls back
+         * to `projectionMatrix * viewMatrix` otherwise.
+         */
+        readonly viewProjectionMatrix?: Float32Array;
         readonly near: number;
         readonly far: number;
+        readonly orthographic?: boolean;
     };
     /** C-07-IN-2: real scene depth when the C-01 prepass is provided. */
     readonly sceneDepth?: {
@@ -33,22 +41,51 @@ export interface ContactShadowPassInput {
     readonly depthPassOptions?: Omit<DepthPassOptions, "casters" | "viewProjectionMatrix">;
     readonly options?: ContactShadowOptions;
 }
+export interface ContactShadowProbe {
+    readonly mask: {
+        readonly width: number;
+        readonly height: number;
+        readonly min: number;
+        readonly mean: number;
+        readonly fractionBelow098: number;
+    } | null;
+    readonly depth: {
+        readonly width: number;
+        readonly height: number;
+        readonly coveredFraction: number;
+        readonly min: number | null;
+        readonly max: number | null;
+    } | null;
+    readonly error?: string;
+}
 /** @internal Contact-mask program sources (GLSL validation in unit tests). */
 export declare const CONTACT_MASK_SHADER_SOURCES: {
     readonly vertex: "#version 300 es\n// @aura3d-shader:prd02_contact_mask\nin vec2 a_position;\nout vec2 v_uv;\nvoid main() { v_uv = a_position * 0.5 + 0.5; gl_Position = vec4(a_position, 0.0, 1.0); }\n";
-    readonly fragment: "#version 300 es\n// @aura3d-shader:prd02_contact_mask\nprecision highp float;\nin vec2 v_uv;\nlayout(location = 0) out vec4 o_vis;\n\nuniform highp sampler2D u_prd02ContactDepth;     // scene depth buffer ([0,1])\nuniform mat4 u_prd02ContactInvProj;              // clip -> view\nuniform mat4 u_prd02ContactProj;                 // view -> clip\nuniform vec3 u_prd02ContactSun;                  // shadowed-light dir, view space\nuniform vec4 u_prd02ContactParams;               // (length_m, thickness_m, steps, jitter)\nuniform vec2 u_prd02ContactNearFar;              // (near, far)\n\nfloat a3d_prd02ContactNoise(vec2 px) {\n  return fract(52.9829189 * fract(0.06711056 * px.x + 0.00583715 * px.y));\n}\n\nfloat a3d_prd02ContactLinear(float z) {\n  float n = u_prd02ContactNearFar.x;\n  float f = u_prd02ContactNearFar.y;\n  return (n * f) / (f - z * (f - n));\n}\n\nfloat a3d_contactShadow(vec2 uv) {\n  float sceneZ = texture(u_prd02ContactDepth, uv).r;\n  vec4 ndc = vec4(uv * 2.0 - 1.0, sceneZ * 2.0 - 1.0, 1.0);\n  vec4 vpos = u_prd02ContactInvProj * ndc;\n  vec3 pos = vpos.xyz / vpos.w;\n  float len = u_prd02ContactParams.x;\n  float thickness = u_prd02ContactParams.y;\n  float steps = max(u_prd02ContactParams.z, 1.0);\n  float jitter = a3d_prd02ContactNoise(gl_FragCoord.xy) * u_prd02ContactParams.w;\n  float occluded = 0.0;\n  for (int i = 1; i <= 16; i++) {\n    if (float(i) > steps) break;\n    float t = (float(i) - jitter) / steps;\n    vec3 p = pos + u_prd02ContactSun * (t * len);\n    vec4 clip = u_prd02ContactProj * vec4(p, 1.0);\n    vec3 r = clip.xyz / clip.w;\n    vec2 suv = r.xy * 0.5 + 0.5;\n    if (suv.x < 0.0 || suv.x > 1.0 || suv.y < 0.0 || suv.y > 1.0) continue;\n    float blocker = a3d_prd02ContactLinear(texture(u_prd02ContactDepth, suv).r);\n    if (blocker < -p.z - thickness) occluded = max(occluded, 1.0 - t);\n  }\n  return 1.0 - occluded;\n}\n\nvoid main() { o_vis = vec4(a3d_contactShadow(v_uv)); }\n";
+    readonly fragment: "#version 300 es\n// @aura3d-shader:prd02_contact_mask\nprecision highp float;\nin vec2 v_uv;\nlayout(location = 0) out vec4 o_vis;\n\nuniform highp sampler2D u_prd02ContactDepth;     // scene depth buffer ([0,1])\nuniform mat4 u_prd02ContactInvViewProj;          // clip -> world\nuniform mat4 u_prd02ContactViewProj;             // world -> clip\nuniform vec3 u_prd02ContactSun;                  // shadowed-light direction TOWARD the light, world space\nuniform vec4 u_prd02ContactParams;               // (length_m, thickness_m, steps, jitter)\nuniform vec3 u_prd02ContactNearFar;              // (near, far, orthographic 0|1); only the orthographic flag is read\n\nfloat a3d_prd02ContactNoise(vec2 px) {\n  return fract(52.9829189 * fract(0.06711056 * px.x + 0.00583715 * px.y));\n}\n\nvec3 a3d_prd02ContactWorld(vec2 uv, float z) {\n  vec4 w = u_prd02ContactInvViewProj * vec4(uv * 2.0 - 1.0, z * 2.0 - 1.0, 1.0);\n  return w.xyz / w.w;\n}\n\n// How far the march point sits behind the visible surface at the same screen position, in world units along the view\n// direction. Perspective: the clip-space w difference (view-space distance). Orthographic: the projection is linear, but the\n// near/far the frame camera reports are not guaranteed to be the ones the projection matrix was built with (the first GPU\n// run of an orthographic scene gave a mask of all ones for that reason), so the gap is measured in world space along the\n// view direction recovered from the inverse view-projection instead.\nfloat a3d_prd02ContactBehind(vec4 clip, vec3 p, vec3 blockerPos, vec2 suv) {\n  if (u_prd02ContactNearFar.z > 0.5) {\n    vec3 viewDir = normalize(a3d_prd02ContactWorld(suv, 1.0) - a3d_prd02ContactWorld(suv, 0.0));\n    return dot(p - blockerPos, viewDir);\n  }\n  return clip.w - (u_prd02ContactViewProj * vec4(blockerPos, 1.0)).w;\n}\n\nfloat a3d_contactShadow(vec2 uv) {\n  float sceneZ = texture(u_prd02ContactDepth, uv).r;\n  vec3 pos = a3d_prd02ContactWorld(uv, sceneZ);\n  float len = u_prd02ContactParams.x;\n  float thickness = u_prd02ContactParams.y;\n  float steps = max(u_prd02ContactParams.z, 1.0);\n  float jitter = a3d_prd02ContactNoise(gl_FragCoord.xy) * u_prd02ContactParams.w;\n  float occluded = 0.0;\n  for (int i = 1; i <= 16; i++) {\n    if (float(i) > steps) break;\n    float t = (float(i) - jitter) / steps;\n    vec3 p = pos + u_prd02ContactSun * (t * len);\n    vec4 clip = u_prd02ContactViewProj * vec4(p, 1.0);\n    if (clip.w <= 0.0) continue;\n    vec3 r = clip.xyz / clip.w;\n    vec2 suv = r.xy * 0.5 + 0.5;\n    if (suv.x < 0.0 || suv.x > 1.0 || suv.y < 0.0 || suv.y > 1.0) continue;\n    float blockerZ = texture(u_prd02ContactDepth, suv).r;\n    vec3 blockerPos = a3d_prd02ContactWorld(suv, blockerZ);\n    // The ray point must sit behind the visible surface by more than the thickness parameter (self-shadow bias) and by less than\n    // twice the march length. The upper bound stops a foreground prop between the camera and the receiver from\n    // \"occluding\" every ray whose screen position lands behind it (ghost shadows), while still letting a solid\n    // caster shade rays that dive up to one march length into its volume.\n    float behind = a3d_prd02ContactBehind(clip, p, blockerPos, suv);\n    if (behind > thickness && behind < len * 2.0) occluded = max(occluded, 1.0 - t);\n  }\n  return 1.0 - occluded;\n}\n\nvoid main() { o_vis = vec4(a3d_contactShadow(v_uv)); }\n";
 };
 export declare class ContactShadowPass extends BaseRenderPass {
-    private readonly input;
+    private input;
     private mask;
     private ownDepth;
     private program;
     private triBuffer;
-    private readonly depthPass;
+    private depthPass;
     private lastMask;
     private lastDepthSource;
     private executed;
     constructor(input: ContactShadowPassInput);
+    /**
+     * Re-point the pass at this frame's camera, light and casters while keeping its
+     * render targets and program (WP-4: the contributor reuses one pass per device
+     * instead of allocating a mask and depth target every frame).
+     */
+    configure(input: ContactShadowPassInput): void;
+    /**
+     * Diagnostics-only readback of the mask and the pass's own depth target (opt-in from the contributor via
+     * `globalThis.__A3D_CONTACT_PROBE__`; never on in production). It exists so a remote GPU run can tell "the mask is all
+     * ones", "the depth pass drew nothing" and "the consumer never sampled it" apart, which pixel deltas alone cannot.
+     */
+    probe(device: RenderDevice): ContactShadowProbe;
     maskTexture(): Texture | null;
     depthSource(): string;
     passExecuted(): boolean;

package/dist/rendering/passes/ContactShadowPass.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ContactShadowPass.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/passes/ContactShadowPass.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,cAAc,EAAE,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAK1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAa,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGhE,eAAO,MAAM,2BAA2B,4BAA4B,CAAC;AAErE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,sBAAsB;IACrC,yEAAyE;IACzE,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACzD,QAAQ,CAAC,MAAM,EAAE;QACf,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAC;QAClC,QAAQ,CAAC,gBAAgB,EAAE,YAAY,CAAC;QACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,qEAAqE;IACrE,QAAQ,CAAC,UAAU,CAAC,EAAE;QACpB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;QACjC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;QAC5B,QAAQ,CAAC,SAAS,EAAE;YAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAA;SAAE,CAAC;KACrG,CAAC;IACF,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IACzC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,SAAS,GAAG,sBAAsB,CAAC,CAAC;IACvF,QAAQ,CAAC,OAAO,CAAC,EAAE,oBAAoB,CAAC;CACzC;AAyBD,8EAA8E;AAC9E,eAAO,MAAM,2BAA2B;;;CAAgE,CAAC;AAEzG,qBAAa,iBAAkB,SAAQ,cAAc;IAUvC,OAAO,CAAC,QAAQ,CAAC,KAAK;IATlC,OAAO,CAAC,IAAI,CAA6B;IACzC,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,OAAO,CAAoC;IACnD,OAAO,CAAC,SAAS,CAA6B;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmB;IAC7C,OAAO,CAAC,QAAQ,CAAwB;IACxC,OAAO,CAAC,eAAe,CAAqC;IAC5D,OAAO,CAAC,QAAQ,CAAS;gBAEI,KAAK,EAAE,sBAAsB;IAe1D,WAAW,IAAI,OAAO,GAAG,IAAI;IAC7B,WAAW,IAAI,MAAM;IACrB,YAAY,IAAI,OAAO;IAEvB,OAAO,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;CAyE1C"}
+{"version":3,"file":"ContactShadowPass.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/passes/ContactShadowPass.ts"],"names":[],"mappings":"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"}

package/dist/rendering/passes/ContactShadowPass.js

@@ -42,17 +42,26 @@ export class ContactShadowPass extends BaseRenderPass {
     ownDepth = null;
     program = null;
     triBuffer = null;
-    depthPass;
+    depthPass = null;
     lastMask = null;
     lastDepthSource = "none";
     executed = false;
     constructor(input) {
         super("prd02-contact-shadows", [MASK_LABEL], [MASK_LABEL]);
+        this.input = input;
+        this.configure(input);
+    }
+    /**
+     * Re-point the pass at this frame's camera, light and casters while keeping its
+     * render targets and program (WP-4: the contributor reuses one pass per device
+     * instead of allocating a mask and depth target every frame).
+     */
+    configure(input) {
         this.input = input;
         if (!input.sceneDepth?.available && input.casters?.length) {
             this.depthPass = new DepthPass({
                 casters: input.casters,
-                viewProjectionMatrix: multiplyMat4(input.camera.projectionMatrix, input.camera.viewMatrix),
+                viewProjectionMatrix: cameraViewProjection(input.camera),
                 ...(input.depthPassOptions ?? {}),
             });
         }
@@ -60,6 +69,60 @@ export class ContactShadowPass extends BaseRenderPass {
             this.depthPass = null;
         }
     }
+    /**
+     * Diagnostics-only readback of the mask and the pass's own depth target (opt-in from the contributor via
+     * `globalThis.__A3D_CONTACT_PROBE__`; never on in production). It exists so a remote GPU run can tell "the mask is all
+     * ones", "the depth pass drew nothing" and "the consumer never sampled it" apart, which pixel deltas alone cannot.
+     */
+    probe(device) {
+        const previous = device.getRenderTarget?.() ?? null;
+        let mask = null;
+        let depth = null;
+        try {
+            if (this.mask && this.executed) {
+                device.setRenderTarget(this.mask);
+                const pixels = device.readPixels(0, 0, this.mask.width, this.mask.height);
+                let min = 255;
+                let sum = 0;
+                let below = 0;
+                const n = this.mask.width * this.mask.height;
+                for (let i = 0; i < n; i += 1) {
+                    const r = pixels[i * 4];
+                    if (r < min)
+                        min = r;
+                    sum += r;
+                    if (r < 250)
+                        below += 1;
+                }
+                mask = { width: this.mask.width, height: this.mask.height, min: min / 255, mean: sum / n / 255, fractionBelow098: below / n };
+            }
+            if (this.ownDepth && device.readDepthPixels) {
+                device.setRenderTarget(this.ownDepth);
+                const values = device.readDepthPixels(0, 0, this.ownDepth.width, this.ownDepth.height);
+                let min = 1;
+                let max = 0;
+                let covered = 0;
+                for (let i = 0; i < values.length; i += 1) {
+                    const v = values[i];
+                    if (v < 0.9999) {
+                        covered += 1;
+                        if (v < min)
+                            min = v;
+                        if (v > max)
+                            max = v;
+                    }
+                }
+                depth = { width: this.ownDepth.width, height: this.ownDepth.height, coveredFraction: covered / values.length, min: covered ? min : null, max: covered ? max : null };
+            }
+        }
+        catch (error) {
+            return { mask, depth, error: error instanceof Error ? error.message : String(error) };
+        }
+        finally {
+            device.setRenderTarget(previous);
+        }
+        return { mask, depth };
+    }
     maskTexture() { return this.lastMask; }
     depthSource() { return this.lastDepthSource; }
     passExecuted() { return this.executed; }
@@ -109,7 +172,8 @@ export class ContactShadowPass extends BaseRenderPass {
         this.triBuffer ??= device.createBuffer("vertex", 24, new Float32Array([-1, -1, 3, -1, -1, 3]));
         const o = this.input.options ?? {};
         const steps = Math.min(16, Math.max(1, o.steps ?? 12));
-        const viewSun = normalize3(transformDirection(this.input.camera.viewMatrix, this.input.sunDirection));
+        const viewProjection = cameraViewProjection(this.input.camera);
+        const sun = normalize3([this.input.sunDirection[0], this.input.sunDirection[1], this.input.sunDirection[2]]);
         device.setRenderTarget(this.mask);
         device.draw({
             label: "prd02-contact-shadow-mask",
@@ -125,11 +189,11 @@ export class ContactShadowPass extends BaseRenderPass {
                         texture: depthTex,
                         sampler: new Sampler({ minFilter: "nearest", magFilter: "nearest", addressU: "clamp-to-edge", addressV: "clamp-to-edge" }),
                     })],
-                ["u_prd02ContactInvProj", invertMat4(this.input.camera.projectionMatrix)],
-                ["u_prd02ContactProj", this.input.camera.projectionMatrix],
-                ["u_prd02ContactSun", viewSun],
+                ["u_prd02ContactInvViewProj", invertMat4(viewProjection)],
+                ["u_prd02ContactViewProj", viewProjection],
+                ["u_prd02ContactSun", sun],
                 ["u_prd02ContactParams", [o.length ?? 0.25, o.thickness ?? 0.05, steps, 0.9]],
-                ["u_prd02ContactNearFar", [this.input.camera.near, this.input.camera.far]],
+                ["u_prd02ContactNearFar", [this.input.camera.near, this.input.camera.far, this.input.camera.orthographic ? 1 : 0]],
             ]),
         });
         this.lastMask = this.mask.colorTexture;
@@ -137,12 +201,8 @@ export class ContactShadowPass extends BaseRenderPass {
         device.setRenderTarget(prevTarget);
     }
 }
-function transformDirection(m, d) {
-    return [
-        m[0] * d[0] + m[4] * d[1] + m[8] * d[2],
-        m[1] * d[0] + m[5] * d[1] + m[9] * d[2],
-        m[2] * d[0] + m[6] * d[1] + m[10] * d[2],
-    ];
+function cameraViewProjection(camera) {
+    return (camera.viewProjectionMatrix ?? multiplyMat4(camera.projectionMatrix, camera.viewMatrix));
 }
 function normalize3(v) {
     const l = Math.hypot(v[0], v[1], v[2]) || 1;

package/dist/rendering/passes/ContactShadowPass.js.map

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

package/dist/rendering/passes/Prd02ContactShadowsContributor.d.ts

@@ -5,12 +5,31 @@ interface ContactShadowsDiagnostics {
     readonly contactShadows: {
         readonly passExecuted: boolean;
         readonly depthSource: string;
+        /**
+         * Set when the scene asked for the mask but nothing can show it this frame (no shadow-casting directional
+         * light, or no drawn program samples the mask). Absent when the mask is working or was not requested.
+         */
+        readonly unavailable?: string;
+        /** Present only when `globalThis.__A3D_CONTACT_PROBE__ === true` (GPU diagnostics runs). */
+        readonly probe?: Readonly<Record<string, unknown>>;
     };
 }
 /** Latest C-31 contact-shadow diagnostics (engine lane reads via rendering barrel). */
 export declare function prd02ContactShadowDiagnostics(): ContactShadowsDiagnostics;
+export declare const CONTACT_SHADOWS_NO_SUN_REASON = "no-shadow-casting-directional-light";
+export declare const CONTACT_SHADOWS_NO_CONSUMER_REASON = "no-drawn-program-samples-the-mask";
 /** C-27 tier + opt-in + sub-flag resolution. Returns null when the pass must not run. */
 export declare function contactShadowRequest(ctx: FrameContributorContext): ContactShadowOptions | null;
+/**
+ * Orthographic cameras do not always say so: the frame camera's `projection` defaults to "perspective" when the scene
+ * camera has no such field (OrthographicCamera has none), which on the first GPU orthographic run left the mask at all
+ * ones. The combined view-projection settles it: an orthographic matrix leaves clip w at exactly 1 (fourth row 0,0,0,1;
+ * column-major elements 3, 7, 11, 15), a perspective one does not.
+ */
+export declare function isOrthographicFrameCamera(camera: {
+    readonly projection: string;
+    readonly viewProjectionMatrix: ArrayLike<number>;
+}): boolean;
 export declare function createPrd02ContactShadowsContributor(): FrameContributor;
 export {};
 //# sourceMappingURL=Prd02ContactShadowsContributor.d.ts.map

package/dist/rendering/passes/Prd02ContactShadowsContributor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Prd02ContactShadowsContributor.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/passes/Prd02ContactShadowsContributor.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AACzF,OAAO,EAAqB,KAAK,oBAAoB,EAA+B,MAAM,qBAAqB,CAAC;AAQhH,eAAO,MAAM,wBAAwB,4BAAmB,CAAC;AAEzD,UAAU,yBAAyB;IACjC,QAAQ,CAAC,cAAc,EAAE;QAAE,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3F;AAMD,uFAAuF;AACvF,wBAAgB,6BAA6B,IAAI,yBAAyB,CAEzE;AAiBD,yFAAyF;AACzF,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,uBAAuB,GAAG,oBAAoB,GAAG,IAAI,CAe9F;AA6DD,wBAAgB,oCAAoC,IAAI,gBAAgB,CAcvE"}
+{"version":3,"file":"Prd02ContactShadowsContributor.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/passes/Prd02ContactShadowsContributor.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AACzF,OAAO,EAAqB,KAAK,oBAAoB,EAA4D,MAAM,qBAAqB,CAAC;AAW7I,eAAO,MAAM,wBAAwB,4BAAmB,CAAC;AAEzD,UAAU,yBAAyB;IACjC,QAAQ,CAAC,cAAc,EAAE;QACvB,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;QAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B;;;WAGG;QACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAC9B,4FAA4F;QAC5F,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;KACpD,CAAC;CACH;AAQD,uFAAuF;AACvF,wBAAgB,6BAA6B,IAAI,yBAAyB,CAOzE;AAUD,eAAO,MAAM,6BAA6B,wCAAwC,CAAC;AACnF,eAAO,MAAM,kCAAkC,sCAAsC,CAAC;AAiBtF,yFAAyF;AACzF,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,uBAAuB,GAAG,oBAAoB,GAAG,IAAI,CAe9F;AAoCD;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE;IAAE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,oBAAoB,EAAE,SAAS,CAAC,MAAM,CAAC,CAAA;CAAE,GAAG,OAAO,CAM5I;AA6HD,wBAAgB,oCAAoC,IAAI,gBAAgB,CAuCvE"}

package/dist/rendering/passes/Prd02ContactShadowsContributor.js

@@ -1,13 +1,22 @@
-// PRD-02 §6.5 — `prd02.contactShadows` frame contributor (phase
-// `after-opaque`, lane flag `A3D_QR_LIGHTING`, feature sub-flag
-// `A3D_QR_LIGHTING_CONTACT`). Runs ContactShadowPass when the scene opted in
-// (`effects.contactShadows` → `source.shadow.prd02Contact`), when the tier
-// allows it (C-27 `shadow.contact`, Ultra only in the frozen table — Q-11-3
-// asks for Medium/High), or when the sub-flag forces it. Opt-in works at any
-// tier except Low. Publishes the mask on the blackboard for the shading side
-// and records `contactShadows.passExecuted` for C-31 diagnostics.
+// PRD-02 §6.5 — `prd02.contactShadows` frame contributor (lane flag
+// `A3D_QR_LIGHTING`, feature sub-flag `A3D_QR_LIGHTING_CONTACT`). Runs
+// ContactShadowPass when the scene opted in (`effects.contactShadows` →
+// `source.shadow.prd02Contact`), when the tier allows it (C-27 `shadow.contact`,
+// Ultra only in the frozen table — Q-11-3 asks for Medium/High), or when the
+// sub-flag forces it. Opt-in works at any tier except Low. Records
+// `contactShadows.passExecuted` for C-31 diagnostics.
+//
+// Two modes, never both in one frame:
+//  - feeds shading (explicit opt-in or sub-flag): phase `shadows`, before the forward pass, renders its own half
+//    resolution depth, and publishes the mask to the forward store. Needs a shadow-casting directional light,
+//    because the mask is marched along that sun and only the sun's visibility term samples it; without one the
+//    pass does not run and a diagnostic says why.
+//  - tier default (Ultra, no opt-in): phase `after-opaque` exactly as before WP-4 (scene depth, no extra depth
+//    pass, nothing published), so that path costs and renders what it always did.
 import { BaseRenderPass } from "../RenderPass.js";
 import { ContactShadowPass, CONTACT_MASK_BLACKBOARD_KEY } from "./ContactShadowPass.js";
+import { contactShadowMask, contactShadowMaskDrawCounters, setContactShadowMask } from "../forward/contactShadowMaskStore.js";
+import { MaterialInstance } from "../MaterialInstance.js";
 import { collectShadowSystemLights } from "../shadows/Prd02ShadowsContributor.js";
 import { resolvePrd02ShadowCasterVariant, prd02DepthFeatures, registerPrd02DepthShader, prd02ShadowCasterEligible } from "../shadows/Prd02DepthShaderLibrary.js";
 import { createLeanCoreShaderLibrary } from "../ShaderLibraryCore.js";
@@ -17,10 +26,27 @@ export const CONTACT_SHADOWS_SUB_FLAG = SUB_FLAG_CONTACT;
 let latestContactDiagnostics = {
     contactShadows: { passExecuted: false, depthSource: "none" }
 };
+let latestContactDevice;
 /** Latest C-31 contact-shadow diagnostics (engine lane reads via rendering barrel). */
 export function prd02ContactShadowDiagnostics() {
-    return latestContactDiagnostics;
+    const probe = latestContactDiagnostics.contactShadows.probe;
+    if (!probe || !latestContactDevice)
+        return latestContactDiagnostics;
+    // Probing runs only: add the forward pass's draw counters, read live so they cover the whole last frame.
+    return {
+        contactShadows: { ...latestContactDiagnostics.contactShadows, probe: { ...probe, drawCounters: { ...contactShadowMaskDrawCounters(latestContactDevice) } } }
+    };
 }
+const warnedOnce = new Set();
+/** One console warning per distinct message per page: a scene that asks for a mask nothing can show should hear about it once. */
+function warnOnce(message) {
+    if (warnedOnce.has(message))
+        return;
+    warnedOnce.add(message);
+    console.warn(`[prd02.contactShadows] ${message}`);
+}
+export const CONTACT_SHADOWS_NO_SUN_REASON = "no-shadow-casting-directional-light";
+export const CONTACT_SHADOWS_NO_CONSUMER_REASON = "no-drawn-program-samples-the-mask";
 /** `ctx.tier` is a settings object — recover its tier name (the ctx carries
  *  the shared QUALITY_TIERS constants; fall back to shadow-shape matching). */
 function tierNameOf(ctx) {
@@ -77,41 +103,145 @@ function depthLibraryFor(device) {
     }
     return lib;
 }
+/**
+ * Depth for the mask is rendered by the pass itself (half resolution, camera space) because the
+ * mask must exist BEFORE the forward pass samples it; the C-01 scene-depth copy only exists
+ * after the opaque pass. Every opaque item writes depth, including receivers authored with
+ * `castShadow: false` (floors): the march needs the receiver surface, not just the casters.
+ */
+function contactDepthEligible(item) {
+    if (item.castShadow !== false)
+        return prd02ShadowCasterEligible(item);
+    const material = item.material;
+    const base = material instanceof MaterialInstance ? material.baseMaterial : material;
+    return base?.renderState.blend !== true;
+}
+/**
+ * Orthographic cameras do not always say so: the frame camera's `projection` defaults to "perspective" when the scene
+ * camera has no such field (OrthographicCamera has none), which on the first GPU orthographic run left the mask at all
+ * ones. The combined view-projection settles it: an orthographic matrix leaves clip w at exactly 1 (fourth row 0,0,0,1;
+ * column-major elements 3, 7, 11, 15), a perspective one does not.
+ */
+export function isOrthographicFrameCamera(camera) {
+    if (camera.projection === "orthographic")
+        return true;
+    const m = camera.viewProjectionMatrix;
+    if (m.length < 16)
+        return false;
+    const eps = 1e-6;
+    return Math.abs(m[3]) < eps && Math.abs(m[7]) < eps && Math.abs(m[11]) < eps && Math.abs(m[15] - 1) < eps;
+}
+// One pass per device: the mask and depth targets are allocated lazily by the pass, so a pass per
+// frame would leak two render targets every frame.
+const contactPasses = new WeakMap();
 class Prd02ContactShadowsRenderPass extends BaseRenderPass {
     ctx;
+    request;
+    mode;
     pass;
-    constructor(ctx, request) {
+    sunTowardLight;
+    casterCount;
+    constructor(ctx, request, mode, sunDirection) {
         super("prd02.contactShadows", [], []);
         this.ctx = ctx;
-        const { sunDirection } = collectShadowSystemLights(ctx);
-        this.pass = new ContactShadowPass({
-            sunDirection: sunDirection ?? [0, -1, 0],
-            camera: ctx.camera ?? {
-                viewMatrix: new Float32Array(16).fill(0),
-                projectionMatrix: new Float32Array(16).fill(0),
-                near: 0.1,
-                far: 100
-            },
-            sceneDepth: ctx.sceneDepth,
-            casters: ctx.items.filter(prd02ShadowCasterEligible),
+        this.request = request;
+        this.mode = mode;
+        const shading = mode === "shading";
+        // `CollectedLight.direction` is the direction the light travels; the march wants the direction
+        // TOWARD the light (the forward shaders use `lightDirection = -direction` the same way).
+        const input = {
+            sunDirection: sunDirection ? [-sunDirection[0], -sunDirection[1], -sunDirection[2]] : [0, 1, 0],
+            camera: ctx.camera
+                ? {
+                    viewMatrix: ctx.camera.viewMatrix,
+                    projectionMatrix: ctx.camera.projectionMatrix,
+                    // The frame camera's separate view/projection can be identity (the production renderer resolves
+                    // cameras that expose only a combined matrix), so the march works from the combined one.
+                    viewProjectionMatrix: ctx.camera.viewProjectionMatrix,
+                    near: ctx.camera.near,
+                    far: ctx.camera.far,
+                    orthographic: isOrthographicFrameCamera(ctx.camera)
+                }
+                : {
+                    viewMatrix: new Float32Array(16).fill(0),
+                    projectionMatrix: new Float32Array(16).fill(0),
+                    near: 0.1,
+                    far: 100
+                },
+            // Shading mode: forward has not run yet in the `shadows` phase, so the pass renders its own depth.
+            // Tier-default mode: the C-01 scene depth copy exists after the opaque pass, as before WP-4.
+            ...(shading ? {} : { sceneDepth: ctx.sceneDepth }),
+            casters: shading ? ctx.items.filter(contactDepthEligible) : ctx.items.filter(prd02ShadowCasterEligible),
             depthPassOptions: {
                 shaderLibrary: depthLibraryFor(ctx.device),
                 variantResolver: (item) => resolvePrd02ShadowCasterVariant(item, ctx.flags, ctx.tier, prd02DepthFeatures()),
                 depthVariantFeatures: prd02DepthFeatures()
             },
             options: request
-        });
+        };
+        let pass = contactPasses.get(ctx.device);
+        if (pass)
+            pass.configure(input);
+        else {
+            pass = new ContactShadowPass(input);
+            contactPasses.set(ctx.device, pass);
+        }
+        this.pass = pass;
+        this.sunTowardLight = input.sunDirection;
+        this.casterCount = input.casters.length;
     }
     execute(context) {
         this.pass.execute(context);
-        this.ctx.blackboard.set(CONTACT_MASK_BLACKBOARD_KEY, this.pass.maskTexture());
+        const mask = this.pass.maskTexture();
+        this.ctx.blackboard.set(CONTACT_MASK_BLACKBOARD_KEY, mask);
+        latestContactDevice = this.ctx.device;
+        let unavailable;
+        if (this.mode === "shading") {
+            // The forward counters still hold the PREVIOUS frame's draws here (they reset on publish): a mask that
+            // was published but that no drawn program sampled means the effect is silently doing nothing.
+            const last = contactShadowMaskDrawCounters(this.ctx.device);
+            if (contactShadowMask(this.ctx.device) !== undefined && last.calls > 0 && last.maskedDraws === 0) {
+                unavailable = CONTACT_SHADOWS_NO_CONSUMER_REASON;
+                warnOnce("effects.contactShadows() has no visible effect: no drawn program samples the mask. The mask darkens the shadow-casting sun's light on materials that receive shadows; textured-PBR materials with glTF extension textures (clearcoat, transmission and similar) do not sample it.");
+            }
+            // Publish only a mask that was actually marched against real depth; the empty fallback mask
+            // (all ones) is harmless but binding it would cost a texture fetch per fragment for nothing.
+            const intensity = this.request.intensity ?? 1;
+            const position = this.ctx.camera?.position ?? [0, 0, 0];
+            setContactShadowMask(this.ctx.device, mask && this.pass.passExecuted() && intensity > 0
+                ? { texture: mask, width: context.width, height: context.height, strength: intensity, cameraPosition: [position[0], position[1], position[2]] }
+                : undefined);
+        }
+        const probing = globalThis.__A3D_CONTACT_PROBE__ === true;
         latestContactDiagnostics = {
             contactShadows: {
                 passExecuted: this.pass.passExecuted(),
-                depthSource: this.pass.depthSource()
+                depthSource: this.pass.depthSource(),
+                ...(unavailable ? { unavailable } : {}),
+                ...(probing ? { probe: this.collectProbe(context) } : {})
             }
         };
     }
+    collectProbe(context) {
+        const camera = this.ctx.camera;
+        return {
+            ...this.pass.probe(context.device),
+            publishedToShading: this.mode === "shading",
+            request: this.request,
+            sunTowardLight: this.sunTowardLight,
+            frameSize: [context.width, context.height],
+            camera: camera
+                ? { view: Array.from(camera.viewMatrix), projection: Array.from(camera.projectionMatrix), viewProjection: Array.from(camera.viewProjectionMatrix), near: camera.near, far: camera.far }
+                : null,
+            casterCount: this.casterCount
+        };
+    }
+}
+/** Records that the scene asked for the mask but this frame cannot produce one, and says so once. */
+function recordUnavailable(ctx, reason, detail) {
+    latestContactDevice = ctx.device;
+    latestContactDiagnostics = { contactShadows: { passExecuted: false, depthSource: "none", unavailable: reason } };
+    warnOnce(detail);
 }
 export function createPrd02ContactShadowsContributor() {
     prd02DepthFeatures();
@@ -119,14 +249,35 @@ export function createPrd02ContactShadowsContributor() {
         id: "prd02.contactShadows",
         owner: "prd02",
         flag: "A3D_QR_LIGHTING",
-        phases: ["after-opaque"],
+        // Feeding shading runs in `shadows`, before the forward pass is queued, so the mask exists when forward
+        // shading samples it (u_contactShadowMask). The tier-default path keeps its pre-WP-4 `after-opaque` slot.
+        phases: ["shadows", "after-opaque"],
         passes: (phase, ctx) => {
+            const request = contactShadowRequest(ctx);
+            const feedsShading = contactShadowOptIn(ctx) !== null || ctx.flags.on(CONTACT_SHADOWS_SUB_FLAG);
+            if (phase === "shadows") {
+                // A frame that does not build a mask clears the previous one; the shading branch publishes in execute()
+                // and leaves the previous frame's mask and draw counters in place until then, so it can check them.
+                if (!request || !ctx.camera || !feedsShading) {
+                    setContactShadowMask(ctx.device, undefined);
+                    return [];
+                }
+                // The mask is marched along the shadow-casting sun and only that light's visibility samples it. With no
+                // such light there is no direction to march and no consumer, so do not guess one.
+                const { sunDirection } = collectShadowSystemLights(ctx);
+                if (!sunDirection) {
+                    setContactShadowMask(ctx.device, undefined);
+                    recordUnavailable(ctx, CONTACT_SHADOWS_NO_SUN_REASON, "effects.contactShadows() has no visible effect: the scene has no shadow-casting directional light. The mask darkens the sun's light only; add a directional light with shadow: true.");
+                    return [];
+                }
+                return [new Prd02ContactShadowsRenderPass(ctx, request, "shading", sunDirection)];
+            }
             if (phase !== "after-opaque")
                 return [];
-            const request = contactShadowRequest(ctx);
-            if (!request || !ctx.camera)
+            if (!request || !ctx.camera || feedsShading)
                 return [];
-            return [new Prd02ContactShadowsRenderPass(ctx, request)];
+            const { sunDirection } = collectShadowSystemLights(ctx);
+            return [new Prd02ContactShadowsRenderPass(ctx, request, "tier-default", sunDirection)];
         }
     };
 }

package/dist/rendering/passes/Prd02ContactShadowsContributor.js.map

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

package/dist/rendering/program/ProgramFeatures.d.ts

@@ -8,6 +8,12 @@
  * passes, warmup) key identically.
  */
 import type { ProgramFeatures, TextureSlotFeature } from "../contracts/program.js";
+/**
+ * Feature bit (in `ProgramFeatures.features`): this forward program writes straight to the canvas (the direct render
+ * path: no post chain, no OutputPass), so it must encode its own output. Set by `ForwardPass` and the warm-up exactly
+ * when the frame's output colour space is `srgb`; absent on every HDR/post-chain program, which stay byte-identical.
+ */
+export declare const PROGRAM_OUTPUT_SRGB_FEATURE = "a3d.output.srgb";
 export declare const DEFAULT_SHADOW_RECEIVE: ProgramFeatures["shadows"];
 export declare const DEFAULT_LIGHTS: ProgramFeatures["lights"];
 export declare const DEFAULT_PROGRAM_FEATURES: ProgramFeatures;

package/dist/rendering/program/ProgramFeatures.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ProgramFeatures.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/program/ProgramFeatures.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAEhF,eAAO,MAAM,sBAAsB,EAAE,eAAe,CAAC,SAAS,CAK7D,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,eAAe,CAAC,QAAQ,CAOpD,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,eAkBtC,CAAC;AAUF,yFAAyF;AACzF,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,SAAS,GAAG,eAAe,CA2BxG;AAED,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC,GAAG,MAAM,CAEzE;AAED,oEAAoE;AACpE,eAAO,MAAM,WAAW,EAAE,SAAS,CAAC,MAAM,eAAe,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,EAMzE,CAAC;AAEF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,kBAAkB,GAAG,SAAS,GAAG,CAAC,GAAG,CAAC,CAEpE"}
+{"version":3,"file":"ProgramFeatures.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/program/ProgramFeatures.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAEhF;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,oBAAoB,CAAC;AAE7D,eAAO,MAAM,sBAAsB,EAAE,eAAe,CAAC,SAAS,CAK7D,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,eAAe,CAAC,QAAQ,CAOpD,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,eAkBtC,CAAC;AAUF,yFAAyF;AACzF,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,SAAS,GAAG,eAAe,CA2BxG;AAED,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC,GAAG,MAAM,CAEzE;AAED,oEAAoE;AACpE,eAAO,MAAM,WAAW,EAAE,SAAS,CAAC,MAAM,eAAe,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,EAMzE,CAAC;AAEF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,kBAAkB,GAAG,SAAS,GAAG,CAAC,GAAG,CAAC,CAEpE"}