@aura3d/engine 4.6.1 → 4.7.0

package/dist/rendering/post/v2Stages.d.ts

@@ -34,7 +34,35 @@ import type { RenderItem } from "../ForwardPass.js";
 import type { Texture } from "../Texture.js";
 import type { TemporalGpuBindings } from "../TemporalHistory.js";
 import { vignetteColorRgb } from "./vignetteColor.js";
+import { type HdrGradeUniforms } from "./shaders/hdrGrade.glsl.js";
+import { type DofOptions, type LutTexture3D } from "./PostGraph.js";
 export { vignetteColorRgb };
+/**
+ * GU47 E-C (EC-2): the `pipeline.lut` bag. The engine bridge emits it once the
+ * `.cube` text has loaded (`source` = the served URL); hosts may pass parsed
+ * `data` instead of `cube`. `intensity` (0..1, default 1) blends the LUT over
+ * the ungraded colour in the shader, so animating it never re-uploads.
+ */
+export interface PostLutBag {
+    readonly source: string;
+    readonly cube?: string;
+    readonly data?: LutTexture3D;
+    readonly intensity?: number;
+    /** Set by the bridge while the `.cube` is loading or after it failed (no `cube` then). */
+    readonly status?: "pending" | "failed";
+}
+/** A resolved S10b LUT: the TEXTURE_3D and the `u_lutBypass` (1 − intensity) value. */
+export interface PostLutBinding {
+    readonly texture: WebGLTexture;
+    readonly bypass: number;
+}
+/**
+ * Uploads a user `.cube` (lattice domain, sampled with `u_lutLattice = 1`) as
+ * an RGBA8 TEXTURE_3D, red-fastest like the file. WebGL2 rejects 3-D uploads
+ * from an ArrayBufferView while the FLIP_Y / PREMULTIPLY unpack flags are set,
+ * so both are cleared first.
+ */
+export declare function uploadCubeLutTexture(gl: WebGL2RenderingContext, lut: LutTexture3D): WebGLTexture;
 /**
  * God-ray tint as an RGB triple. The engine bridge compiles
  * `effects.volumetricFog({ color })` to a `{ r, g, b }` object, while direct
@@ -45,6 +73,29 @@ export { vignetteColorRgb };
  * the default warm tint.
  */
 export declare function godRayColor(color: unknown): [number, number, number];
+/**
+ * GU47 E-C (EC-6): S3 options from `pipeline.ssr`: `intensity` (default
+ * 0.9, [0, 2]), `maxDistance` metres (18, [0.5, 200]), `roughness` hint
+ * (0; the trace fades out between 0.35 and the 0.5 cutoff), `thickness`
+ * metres (0.25) and march `steps` snapped to 16 | 24 | 32 (24).
+ */
+export declare function resolveSsrOptions(ssr: unknown): {
+    readonly intensity: number;
+    readonly maxDistance: number;
+    readonly roughness: number;
+    readonly thickness: number;
+    readonly steps: 16 | 24 | 32;
+};
+/** GU47 E-C (EC-8): S4 `u_density` — the authored god-ray density clamped to [0.05, 1]; omitted or invalid = 1 (full march). */
+export declare function godRayDensity(density: unknown): number;
+/** GU47 phase 2: S4 `u_medium` — the shaft medium per metre clamped to [0, 1]; omitted or invalid = 0 (no depth scaling). */
+export declare function godRayMedium(medium: unknown): number;
+/**
+ * GU47 E-C (EC-8): S6 `u_tiltShift` = [bandCenter, bandWidth, angle (rad), 1]
+ * for a valid band (centre and width clamped to [0, 1]), else all zeros
+ * (the thin-lens CoC).
+ */
+export declare function dofTiltShiftUniform(tilt: DofOptions["tiltShift"] | undefined): [number, number, number, number];
 /**
  * Inserts `#define` lines after the `#version` directive. GLSL ES 3.00
  * requires `#version 300 es` to be the first line, so prepending defines (as
@@ -54,6 +105,8 @@ export declare function godRayColor(color: unknown): [number, number, number];
  * post-quality 38138763970).
  */
 export declare function withDefines(source: string, defines: Readonly<Record<string, string | number>>): string;
+/** The S10 grade uniform writer (`u_whiteBalance` … `u_highlights`). Exported for the mock-GL unit gate. */
+export declare function writeHdrGradeUniforms(g: WebGL2RenderingContext, prog: WebGLProgram, grade: HdrGradeUniforms): void;
 /**
  * §6.12: a custom pass's `fragment.glsl` is appended after the engine
  * prelude (version, precision, the `v_uv` input, `outColor`, and the

package/dist/rendering/post/v2Stages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"v2Stages.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/post/v2Stages.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"v2Stages.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/post/v2Stages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAqB,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAGvE,OAAO,EAGL,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,WAAW,EAA2B,MAAM,yBAAyB,CAAC;AACpF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAgB9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAMtD,OAAO,EAA+D,KAAK,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAIhI,OAAO,EAAmD,KAAK,UAAU,EAAwC,KAAK,YAAY,EAA2C,MAAM,aAAa,CAAC;AAIjM,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAyD5B;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,0FAA0F;IAC1F,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;CACxC;AAED,uFAAuF;AACvF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,sBAAsB,EAAE,GAAG,EAAE,YAAY,GAAG,YAAY,CAqBhG;AAqGD;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAUpE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG;IAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAA;CAAE,CAclM;AAED,gIAAgI;AAChI,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAEtD;AAED,6HAA6H;AAC7H,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAEpD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,UAAU,CAAC,WAAW,CAAC,GAAG,SAAS,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAI/G;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,GAAG,MAAM,CAItG;AA+HD,4GAA4G;AAC5G,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,sBAAsB,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAWlH;AAYD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAW7D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,SAAS,kBAAkB,EAAE,CAe/F;AAWD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,kBAAkB,EAAE,EAAE,MAAM,EAAE,kBAAkB,CAAC,UAAU,CAAC,GAAG,SAAS,kBAAkB,EAAE,CAErJ;AAgDD,mGAAmG;AACnG,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAyDD;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,CAAC;IACtC,QAAQ,CAAC,UAAU,EAAE;QACnB,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;CACH;AAUD;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAEnD;AA+CD,MAAM,WAAW,qBAAqB;IACpC;;;;;;OAMG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;CACvC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,cAAc,CAAC;IACxD,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,gBAAgB,EACtB,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,mBAAmB,EAC7B,MAAM,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS;AACtC;;8DAE8D;AAC9D,QAAQ,CAAC,EAAE,mBAAmB;AAC9B,qFAAqF;AACrF,YAAY,CAAC,EAAE,mBAAmB,EAClC,OAAO,CAAC,EAAE,qBAAqB,GAC9B;IAAE,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,uBAAuB,CAAA;CAAE,CAunBpJ;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAE5C,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAGvE;AAED,2EAA2E;AAC3E,wBAAgB,cAAc,CAAC,QAAQ,EAAE,mBAAmB,GAAG,OAAO,CAIrE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,gBAAgB,EACtB,GAAG,EAAE,YAAY,EACjB,QAAQ,EAAE,mBAAmB,EAC7B,SAAS,EAAE,YAAY,GAAG,SAAS;AACnC,qFAAqF;AACrF,YAAY,CAAC,EAAE,mBAAmB,GACjC,IAAI,CA+KN;AAwDD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAElF;AAED,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,IAAI,EAAE,gBAAgB,EAAE,GAAG,EAAE;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,YAAY,CAEvJ"}

package/dist/rendering/post/v2Stages.js

@@ -31,7 +31,7 @@ import { reportShaderFailure } from "../ShaderFailures.js";
 import { invertMat4, multiplyMat4 } from "../../scene/index.js";
 import { registeredPostPasses, validatePostPassSpace } from "../contracts/post.js";
 import { rendererQrFlags } from "../renderer/FrameGraph.js";
-import { beginPostStageTrace, markTaaHistoryWritten, recordPostSkipped, recordPostStage } from "../renderer/postSkipped.js";
+import { beginPostStageTrace, clearPostSkipped, markTaaHistoryWritten, recordPostSkipped, recordPostStage } from "../renderer/postSkipped.js";
 import { PostResources } from "./PostResources.js";
 import { QUALITY_TIERS } from "../contracts/quality.js";
 import { CAMERA_VELOCITY_GLSL, DEPTH_LINEARIZE_GLSL, DEPTH_MINMAX_HALF_GLSL } from "./shaders/depthDownsample.glsl.js";
@@ -47,9 +47,13 @@ import { TAA_RESOLVE_GLSL, TAA_UPSCALE_GLSL } from "./shaders/taa.glsl.js";
 import { DOF_COMPOSITE_GLSL, DOF_GATHER_GLSL, DOF_NEAR_TILE_GLSL, DOF_PREFILTER_GLSL } from "./shaders/dof.glsl.js";
 import { MB_NEIGHBOR_GLSL, MB_RECONSTRUCT_GLSL, MB_TILE_MAX_GLSL } from "./shaders/motionBlur.glsl.js";
 import { EXPOSURE_ADAPT_GLSL, EXPOSURE_LUMA_LOG_GLSL, EXPOSURE_MUL_GLSL, EXPOSURE_REDUCE_GLSL } from "./shaders/exposure.glsl.js";
+import { HDR_GRADE_GLSL, resolveHdrGradeUniforms } from "./shaders/hdrGrade.glsl.js";
+import { SSR_COMPOSITE_GLSL, SSR_DEFAULT_STEPS, SSR_DEFAULT_THICKNESS, SSR_TRACE_GLSL } from "./shaders/ssr.glsl.js";
 import { SMAA_BLEND_GLSL, SMAA_EDGES_GLSL, SMAA_WEIGHTS_GLSL } from "./shaders/smaa.glsl.js";
 import { FXAA_185_FRAGMENT_GLSL } from "./shaders/fxaa.glsl.js";
 import { POST_INSERT_ANCHORS } from "./PostGraph.js";
+import { DisplayLutCache } from "./DisplayLutCache.js";
+import { parseCubeLut } from "./CubeLut.js";
 export { vignetteColorRgb };
 /** Identity for the folded camera-velocity reprojection (S1-C). */
 const IDENTITY_MAT4_F32 = new Float32Array([1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1]);
@@ -68,6 +72,78 @@ function asGlTarget(target) {
     }
     return t;
 }
+/**
+ * Uploads a user `.cube` (lattice domain, sampled with `u_lutLattice = 1`) as
+ * an RGBA8 TEXTURE_3D, red-fastest like the file. WebGL2 rejects 3-D uploads
+ * from an ArrayBufferView while the FLIP_Y / PREMULTIPLY unpack flags are set,
+ * so both are cleared first.
+ */
+export function uploadCubeLutTexture(gl, lut) {
+    const texture = gl.createTexture();
+    if (!texture)
+        throw new RenderDeviceError("LUT texture allocation failed.", "POST_GRAPH_V2_UNSUPPORTED");
+    const n = lut.size;
+    const bytes = new Uint8Array(n * n * n * 4);
+    for (let i = 0; i < bytes.length; i += 1) {
+        const v = lut.data[i] ?? 1;
+        bytes[i] = Math.round(Math.min(1, Math.max(0, Number.isFinite(v) ? v : 0)) * 255);
+    }
+    gl.bindTexture(gl.TEXTURE_3D, texture);
+    gl.pixelStorei(gl.UNPACK_FLIP_Y_WEBGL, false);
+    gl.pixelStorei(gl.UNPACK_PREMULTIPLY_ALPHA_WEBGL, false);
+    gl.pixelStorei(gl.UNPACK_ALIGNMENT, 4);
+    gl.texImage3D(gl.TEXTURE_3D, 0, gl.RGBA8, n, n, n, 0, gl.RGBA, gl.UNSIGNED_BYTE, bytes);
+    gl.texParameteri(gl.TEXTURE_3D, gl.TEXTURE_MIN_FILTER, gl.LINEAR);
+    gl.texParameteri(gl.TEXTURE_3D, gl.TEXTURE_MAG_FILTER, gl.LINEAR);
+    gl.texParameteri(gl.TEXTURE_3D, gl.TEXTURE_WRAP_S, gl.CLAMP_TO_EDGE);
+    gl.texParameteri(gl.TEXTURE_3D, gl.TEXTURE_WRAP_T, gl.CLAMP_TO_EDGE);
+    gl.texParameteri(gl.TEXTURE_3D, gl.TEXTURE_WRAP_R, gl.CLAMP_TO_EDGE);
+    gl.bindTexture(gl.TEXTURE_3D, null);
+    return texture;
+}
+/**
+ * GU47 E-C (EC-2): resolves `pipeline.lut` to a bound TEXTURE_3D through the
+ * per-host `DisplayLutCache` (one parse + upload per source; the key holds the
+ * source with contrast/saturation/vibrance/intensity at identity because those
+ * run in the fused present and the shader). A bag without text/data records
+ * `LUT_PENDING`; a `.cube` the parser rejects records `LUT_INVALID` once and
+ * renders the identity grade.
+ */
+function displayLutBinding(host, state, lut) {
+    if (!lut || typeof lut !== "object")
+        return null;
+    const bag = lut;
+    if (typeof bag.source !== "string" || (typeof bag.cube !== "string" && !bag.data)) {
+        if (bag.status === "failed")
+            clearPostSkipped(`LUT_PENDING:${String(bag.source)}`);
+        recordPostSkipped(`${bag.status === "failed" ? "LUT_UNAVAILABLE" : "LUT_PENDING"}:${String(bag.source)}`);
+        return null;
+    }
+    // The load settled: the first frames' `LUT_PENDING` no longer describes it.
+    clearPostSkipped(`LUT_PENDING:${bag.source}`);
+    if (state.lutFailed.has(bag.source))
+        return null;
+    const gl = host.gl;
+    state.lutCache ??= new DisplayLutCache(() => {
+        const baking = state.lutBaking;
+        return uploadCubeLutTexture(gl, baking.data ?? parseCubeLut(baking.cube));
+    }, (texture) => gl.deleteTexture(texture), { maxEntries: 4 });
+    state.lutBaking = bag;
+    try {
+        const texture = state.lutCache.acquire({ contrast: 1, saturation: 1, vibrance: 0, lutIntensity: 1, userLut: bag.source });
+        const intensity = typeof bag.intensity === "number" && Number.isFinite(bag.intensity) ? Math.min(1, Math.max(0, bag.intensity)) : 1;
+        return { texture, bypass: 1 - intensity };
+    }
+    catch (error) {
+        state.lutFailed.add(bag.source);
+        const code = error instanceof Error ? /^[A-Z0-9_]+/.exec(error.message)?.[0] ?? "LUT_UPLOAD_FAILED" : "LUT_UPLOAD_FAILED";
+        recordPostSkipped(`LUT_INVALID:${bag.source}:${code}`);
+        return null;
+    }
+    finally {
+        state.lutBaking = undefined;
+    }
+}
 const states = new WeakMap();
 function v2State(host) {
     const gl = host.gl;
@@ -117,7 +193,8 @@ function v2State(host) {
             evTargets: [undefined, undefined],
             evIndex: 0,
             evValid: false,
-            smaa: { area: null, search: null, requested: false }
+            smaa: { area: null, search: null, requested: false },
+            lutFailed: new Set()
         };
         states.set(host, state);
     }
@@ -145,6 +222,46 @@ export function godRayColor(color) {
         return fallback;
     return [0, 1, 2].map((i) => (typeof rgb[i] === "number" && Number.isFinite(rgb[i]) ? rgb[i] : fallback[i]));
 }
+/**
+ * GU47 E-C (EC-6): S3 options from `pipeline.ssr`: `intensity` (default
+ * 0.9, [0, 2]), `maxDistance` metres (18, [0.5, 200]), `roughness` hint
+ * (0; the trace fades out between 0.35 and the 0.5 cutoff), `thickness`
+ * metres (0.25) and march `steps` snapped to 16 | 24 | 32 (24).
+ */
+export function resolveSsrOptions(ssr) {
+    const bag = (ssr && typeof ssr === "object" ? ssr : {});
+    const num = (key, fallback, min, max) => {
+        const value = bag[key];
+        return typeof value === "number" && Number.isFinite(value) ? Math.min(max, Math.max(min, value)) : fallback;
+    };
+    const steps = num("steps", SSR_DEFAULT_STEPS, 1, 64);
+    return {
+        intensity: num("intensity", 0.9, 0, 2),
+        maxDistance: num("maxDistance", 18, 0.5, 200),
+        roughness: num("roughness", 0, 0, 1),
+        thickness: num("thickness", SSR_DEFAULT_THICKNESS, 0.01, 10),
+        steps: steps <= 16 ? 16 : steps <= 24 ? 24 : 32
+    };
+}
+/** GU47 E-C (EC-8): S4 `u_density` — the authored god-ray density clamped to [0.05, 1]; omitted or invalid = 1 (full march). */
+export function godRayDensity(density) {
+    return typeof density === "number" && Number.isFinite(density) ? Math.min(1, Math.max(0.05, density)) : 1;
+}
+/** GU47 phase 2: S4 `u_medium` — the shaft medium per metre clamped to [0, 1]; omitted or invalid = 0 (no depth scaling). */
+export function godRayMedium(medium) {
+    return typeof medium === "number" && Number.isFinite(medium) ? Math.min(1, Math.max(0, medium)) : 0;
+}
+/**
+ * GU47 E-C (EC-8): S6 `u_tiltShift` = [bandCenter, bandWidth, angle (rad), 1]
+ * for a valid band (centre and width clamped to [0, 1]), else all zeros
+ * (the thin-lens CoC).
+ */
+export function dofTiltShiftUniform(tilt) {
+    if (!tilt || !Number.isFinite(tilt.bandCenter) || !Number.isFinite(tilt.bandWidth))
+        return [0, 0, 0, 0];
+    const angle = typeof tilt.angleDeg === "number" && Number.isFinite(tilt.angleDeg) ? tilt.angleDeg : 0;
+    return [Math.min(1, Math.max(0, tilt.bandCenter)), Math.min(1, Math.max(0, tilt.bandWidth)), angle * Math.PI / 180, 1];
+}
 /**
  * Inserts `#define` lines after the `#version` directive. GLSL ES 3.00
  * requires `#version 300 es` to be the first line, so prepending defines (as
@@ -234,6 +351,51 @@ function draw(host, state, prog, target, textures, uniforms) {
 }
 /** §6.3 multi-bounce ρ and AO metadata shared by the apply draw. */
 const AO_RHO = 0.5;
+/**
+ * GU47 E-C: one fullscreen draw for S8's `exp2(ev)` multiply and/or the S10
+ * linear grade. AE-only frames keep the original `EXPOSURE_MUL_GLSL` program
+ * (byte-identical); a non-identity grade runs `HDR_GRADE_GLSL`, with the EV
+ * multiply folded in when S8 is active (`ev` non-null).
+ */
+function runHdrGradeDraw(host, state, target, input, ev, grade) {
+    const gl = host.gl;
+    if (!grade) {
+        if (!ev)
+            return;
+        const mulProg = program(state, gl, "exposure-mul", EXPOSURE_MUL_GLSL);
+        draw(host, state, mulProg, asGlTarget(target), [asGlTarget(input).colorHandle, asGlTarget(ev).colorHandle], (g) => {
+            g.uniform1i(g.getUniformLocation(mulProg, "u_hdr"), 0);
+            g.uniform1i(g.getUniformLocation(mulProg, "u_ev"), 1);
+        });
+        return;
+    }
+    const prog = program(state, gl, "hdr-grade", HDR_GRADE_GLSL);
+    draw(host, state, prog, asGlTarget(target), [asGlTarget(input).colorHandle, ev ? asGlTarget(ev).colorHandle : state.blankTex], (g) => {
+        g.uniform1i(g.getUniformLocation(prog, "u_hdr"), 0);
+        g.uniform1i(g.getUniformLocation(prog, "u_ev"), 1);
+        g.uniform1i(g.getUniformLocation(prog, "u_hasEv"), ev ? 1 : 0);
+        g.uniform1i(g.getUniformLocation(prog, "u_hasGrade"), 1);
+        writeHdrGradeUniforms(g, prog, grade);
+    });
+}
+/** The S10 grade uniform writer (`u_whiteBalance` … `u_highlights`). Exported for the mock-GL unit gate. */
+export function writeHdrGradeUniforms(g, prog, grade) {
+    const v3 = (name, value) => {
+        g.uniform3f(g.getUniformLocation(prog, name), value[0], value[1], value[2]);
+    };
+    v3("u_whiteBalance", grade.whiteBalance);
+    v3("u_lift", grade.lift);
+    v3("u_gamma", grade.gamma);
+    v3("u_gain", grade.gain);
+    v3("u_shadows", grade.shadows);
+    v3("u_midtones", grade.midtones);
+    v3("u_highlights", grade.highlights);
+}
+/** Stage-trace suffix for S9: the authored mip count when the bag carries one. */
+function bloomMipsTag(bloom) {
+    const mips = bloom && typeof bloom === "object" ? bloom.mips : undefined;
+    return typeof mips === "number" && Number.isFinite(mips) ? `-${mips}mips` : "";
+}
 /* ------------------------------------------------------------------------ */
 /* Phase 6 — C-13 custom passes, S8 auto-exposure, S11 SMAA                   */
 /* ------------------------------------------------------------------------ */
@@ -458,10 +620,16 @@ frameContext, options) {
     const wantsTaa = pipeline.antiAliasing === "taa" || Boolean(pipeline.taa);
     const wantsDof = Boolean(pipeline.dof);
     const wantsMb = Boolean(pipeline.motionBlur);
+    // GU47 E-C (EC-6): S3 SSR runs only for an authored screenSpaceReflections node.
+    const wantsSsr = Boolean(pipeline.ssr);
     // Phase 6: S8 auto-exposure + C-13 HDR-domain custom passes at their §6.1
     // insertion anchors (`after-tonemap` runs in the LDR tail instead).
     const autoExposure = pipeline.autoExposure;
     const wantsAutoExposure = autoExposure !== undefined && autoExposure !== false;
+    // GU47 E-C: the linear grade (white balance, lift/gamma/gain, shadows/
+    // midtones/highlights). Identity → null → no draw (byte-identical frames).
+    const gradeUniforms = resolveHdrGradeUniforms(pipeline.grade);
+    const wantsGrade = gradeUniforms !== null;
     const customs = mergedCustomPasses(pipeline);
     const customsAt = (anchor) => sortCustomPassesAtAnchor(customs, anchor);
     const hdrCustoms = customs.filter((pass) => pass.insertAt !== "after-tonemap");
@@ -473,6 +641,12 @@ frameContext, options) {
     const mbActive = wantsMb && temporalOk;
     beginPostStageTrace();
     recordPostStage(`enter:taa=${String(wantsTaa)}:mb=${String(wantsMb)}:temporal=${String(temporalOk)}`);
+    // GU47 E-C stage trace: S9 bloom executes inside the fused present right
+    // after this driver returns. The executor sets `deferBeforeTonemap` exactly
+    // when its pass list carries an HDR bloom pass (LegacyPost
+    // `executePostGraphWebGL2`), so that flag — not the authored bag — records it.
+    if (options?.deferBeforeTonemap)
+        recordPostStage(`S9:bloom${bloomMipsTag(pipeline.bloom)}`);
     if (wantsTaa && !temporalOk) {
         skipped.push("TAA_VELOCITY_COVERAGE");
         recordPostSkipped("TAA_VELOCITY_COVERAGE:v2-hdr-stages");
@@ -481,11 +655,11 @@ frameContext, options) {
         skipped.push("S7_VELOCITY_UNAVAILABLE");
         recordPostSkipped("S7_VELOCITY_UNAVAILABLE:v2-hdr-stages");
     }
-    const needsLinZ = wantsAo || wantsGodRays || wantsDof || taaActive || mbActive
+    const needsLinZ = wantsAo || wantsGodRays || wantsDof || taaActive || mbActive || wantsSsr
         || hdrCustoms.some((pass) => pass.inputs.includes("depth"));
     const needsVelocity = ((taaActive || mbActive) && temporalOk)
         || (hdrCustoms.some((pass) => pass.inputs.includes("velocity")) && temporalOk);
-    if (!wantsAo && !wantsGodRays && !wantsCa && !taaActive && !wantsDof && !mbActive && !wantsAutoExposure && hdrCustoms.length === 0)
+    if (!wantsAo && !wantsGodRays && !wantsCa && !taaActive && !wantsDof && !mbActive && !wantsSsr && !wantsAutoExposure && !wantsGrade && hdrCustoms.length === 0)
         return { target: source, aoPending: false, skipped };
     // T0-15: the forward HDR target is multisampled by default (`sampleCount` 4
     // in `Renderer`), so its `colorHandle`/`depthTextureHandle` only contain
@@ -502,7 +676,7 @@ frameContext, options) {
         recordPostSkipped("WEBGL_LDR_POSTPROCESS_DEPTH_REQUIRED:v2-hdr-stages");
         return { target: source, aoPending: false, skipped: [...skipped, "V2_DEPTH_UNAVAILABLE"] };
     }
-    if ((wantsAo || wantsGodRays || needsVelocity) && !camera) {
+    if ((wantsAo || wantsGodRays || wantsSsr || needsVelocity) && !camera) {
         recordPostSkipped("POST_GRAPH_V2_CAMERA_REQUIRED:v2-hdr-stages");
         return { target: source, aoPending: false, skipped: [...skipped, "V2_CAMERA_UNAVAILABLE"] };
     }
@@ -518,6 +692,7 @@ frameContext, options) {
     let minmaxHalf = null;
     let linZOwnedByPool = false;
     if (needsLinZ) {
+        recordPostStage("S1:depth-prep");
         // Temporal frames write this frame's linear Z into the history ping-pong's
         // `linZOutput` slot so commit() promotes it for next frame's disocclusion.
         linZFull = temporal?.v2?.linZOutput
@@ -648,6 +823,43 @@ frameContext, options) {
         state.pool.release(aoHalf);
         void AO_RHO;
     }
+    // ── S3: GU47 E-C screen-space reflections (half-res trace + composite) ───
+    if (wantsSsr && camera && linZFull) {
+        const ssr = resolveSsrOptions(pipeline.ssr);
+        // Reprojected previous colour: the TAA history (last frame's resolved
+        // HDR) through prevViewProj · inv(view); without TAA history the trace
+        // samples this frame's HDR at the hit.
+        const history = taaActive && temporal?.historyValid && temporal.v2 ? temporal : undefined;
+        const viewToPrevClip = history
+            ? Float32Array.from(multiplyMat4(Array.from(history.v2.previous), invertMat4(Array.from(camera.viewMatrix))))
+            : IDENTITY_MAT4_F32;
+        const trace = state.pool.acquire({ width: hw, height: hh, format: "rgba16f", samples: 1, depth: false });
+        const traceProg = program(state, gl, `ssr-trace-${ssr.steps}`, withDefines(SSR_TRACE_GLSL, { AURA_SSR_STEPS: ssr.steps }));
+        recordPostStage(`S3:ssr-${ssr.steps}${history ? ":history" : ""}`);
+        draw(host, state, traceProg, asGlTarget(trace), [asGlTarget(history ? history.history : hdr).colorHandle, asGlTarget(linZFull).colorHandle], (g) => {
+            g.uniform1i(g.getUniformLocation(traceProg, "u_color"), 0);
+            g.uniform1i(g.getUniformLocation(traceProg, "u_linearDepth"), 1);
+            g.uniformMatrix4fv(g.getUniformLocation(traceProg, "u_projection"), false, camera.projectionMatrix);
+            g.uniformMatrix4fv(g.getUniformLocation(traceProg, "u_viewToPrevClip"), false, viewToPrevClip);
+            g.uniform1i(g.getUniformLocation(traceProg, "u_reproject"), history ? 1 : 0);
+            g.uniform1i(g.getUniformLocation(traceProg, "u_ortho"), ortho ? 1 : 0);
+            g.uniform1f(g.getUniformLocation(traceProg, "u_far"), far);
+            g.uniform1f(g.getUniformLocation(traceProg, "u_maxDistance"), ssr.maxDistance);
+            g.uniform1f(g.getUniformLocation(traceProg, "u_thickness"), ssr.thickness);
+            g.uniform1f(g.getUniformLocation(traceProg, "u_roughness"), ssr.roughness);
+        });
+        const composited = state.pool.acquire({ width: w, height: h, format: "rgba16f", samples: 1, depth: false });
+        const ssrCompProg = program(state, gl, "ssr-composite", SSR_COMPOSITE_GLSL);
+        draw(host, state, ssrCompProg, asGlTarget(composited), [asGlTarget(hdr).colorHandle, asGlTarget(trace).colorHandle], (g) => {
+            g.uniform1i(g.getUniformLocation(ssrCompProg, "u_color"), 0);
+            g.uniform1i(g.getUniformLocation(ssrCompProg, "u_reflection"), 1);
+            g.uniform1f(g.getUniformLocation(ssrCompProg, "u_intensity"), ssr.intensity);
+        });
+        state.pool.release(trace);
+        if (hdr !== source)
+            state.pool.release(hdr);
+        hdr = composited;
+    }
     // ── S4: god rays, half-res radial march → additive onto HDR ─────────────
     if (wantsGodRays && camera && minmaxHalf) {
         const god = pipeline.godRays;
@@ -674,6 +886,7 @@ frameContext, options) {
             : [0.5, 0.5];
         const godSrc = withDefines(GODRAYS_GLSL, { AURA_GODRAY_SAMPLES: samples });
         const godProg = program(state, gl, `godrays-${samples}`, godSrc);
+        recordPostStage(`S4:god-rays-${samples}`);
         draw(host, state, godProg, asGlTarget(godTarget), [asGlTarget(hdr).colorHandle, asGlTarget(minmaxHalf).colorHandle], (g) => {
             g.uniform1i(g.getUniformLocation(godProg, "u_hdr"), 0);
             g.uniform1i(g.getUniformLocation(godProg, "u_depthHalf"), 1);
@@ -687,6 +900,10 @@ frameContext, options) {
             g.uniform1f(g.getUniformLocation(godProg, "u_weight"), god.weight ?? god.intensity ?? 0.7);
             g.uniform1f(g.getUniformLocation(godProg, "u_diskOuter"), 0.08);
             g.uniform1f(g.getUniformLocation(godProg, "u_diskInner"), 0.02);
+            // GU47 E-C (EC-8): `godRayDensity`; omitted keeps the full march (1).
+            g.uniform1f(g.getUniformLocation(godProg, "u_density"), godRayDensity(god.density));
+            // GU47 phase 2: distance-scaled shaft medium; omitted (0) keeps the unscaled shaft.
+            g.uniform1f(g.getUniformLocation(godProg, "u_medium"), godRayMedium(god.medium));
         });
         // Additive blend onto the working HDR target.
         const blended = state.pool.acquire({ width: w, height: h, format: "rgba16f", samples: 1, depth: false });
@@ -721,6 +938,7 @@ frameContext, options) {
         const ca = pipeline.chromaticAberration;
         const caTarget = state.pool.acquire({ width: w, height: h, format: "rgba16f", samples: 1, depth: false });
         const caProg = program(state, gl, "ca-pass", CA_PASS_GLSL);
+        recordPostStage("CA:chromatic-aberration");
         draw(host, state, caProg, asGlTarget(caTarget), [asGlTarget(hdr).colorHandle], (g) => {
             g.uniform1i(g.getUniformLocation(caProg, "u_hdr"), 0);
             g.uniform1f(g.getUniformLocation(caProg, "u_caIntensity"), ca.intensity ?? 0.0015);
@@ -808,6 +1026,9 @@ frameContext, options) {
         const dw = Math.max(1, Math.round(w / 2)), dh = Math.max(1, Math.round(h / 2));
         const prefilter = state.pool.acquire({ width: dw, height: dh, format: "rgba16f", samples: 1, depth: false });
         const prefilterProg = program(state, gl, "dof-prefilter", DOF_PREFILTER_GLSL);
+        // GU47 E-C (EC-8): the tilt-shift band replaces the thin-lens CoC.
+        const tilt = dofTiltShiftUniform(dof.tiltShift);
+        recordPostStage(tilt[3] > 0 ? `S6:dof-tilt-shift-rings${rings}` : `S6:dof-rings${rings}`);
         draw(host, state, prefilterProg, asGlTarget(prefilter), [asGlTarget(hdr).colorHandle, asGlTarget(linZFull).colorHandle], (g) => {
             g.uniform1i(g.getUniformLocation(prefilterProg, "u_color"), 0);
             g.uniform1i(g.getUniformLocation(prefilterProg, "u_linearDepth"), 1);
@@ -817,6 +1038,7 @@ frameContext, options) {
             g.uniform1f(g.getUniformLocation(prefilterProg, "u_sensorHeightMm"), dof.sensorHeightMm ?? 24);
             g.uniform1f(g.getUniformLocation(prefilterProg, "u_frameHeightPx"), h);
             g.uniform1f(g.getUniformLocation(prefilterProg, "u_maxBlurPx"), maxBlur);
+            g.uniform4f(g.getUniformLocation(prefilterProg, "u_tiltShift"), tilt[0], tilt[1], tilt[2], tilt[3]);
         });
         const tileW = Math.max(1, Math.ceil(dw / 8)), tileH = Math.max(1, Math.ceil(dh / 8));
         const nearTile = state.pool.acquire({ width: tileW, height: tileH, format: "rgba16f", samples: 1, depth: false });
@@ -851,6 +1073,7 @@ frameContext, options) {
         const tile = mb.tileSize ?? 16;
         const samples = mb.samples ?? 12;
         const tw = Math.max(1, Math.ceil(w / tile)), th = Math.max(1, Math.ceil(h / tile));
+        recordPostStage(`S7:motion-blur-${samples}x${tile}`);
         const tileMax = state.pool.acquire({ width: tw, height: th, format: "rgba16f", samples: 1, depth: false });
         const tileProg = program(state, gl, `mb-tile-${tile}`, withDefines(MB_TILE_MAX_GLSL, { MB_TILE_SIZE: tile }));
         draw(host, state, tileProg, asGlTarget(tileMax), [asGlTarget(dilatedVelocity).colorHandle], (g) => {
@@ -944,18 +1167,28 @@ frameContext, options) {
         state.pool.release(luma);
         if (reduceTmp)
             state.pool.release(reduceTmp);
+        recordPostStage("S8:auto-exposure");
         // Apply: hdr *= exp2(ev) — the composite's autoExp factor, ahead of the
-        // fused present's own §6.4 exposure (linear multipliers commute).
+        // fused present's own §6.4 exposure (linear multipliers commute). GU47
+        // E-C: the S10 linear grade folds into this same draw (one fullscreen
+        // pass for AE + grade).
         const multiplied = state.pool.acquire({ width: w, height: h, format: "rgba16f", samples: 1, depth: false });
-        const mulProg = program(state, gl, "exposure-mul", EXPOSURE_MUL_GLSL);
-        draw(host, state, mulProg, asGlTarget(multiplied), [asGlTarget(hdr).colorHandle, asGlTarget(evWrite).colorHandle], (g) => {
-            g.uniform1i(g.getUniformLocation(mulProg, "u_hdr"), 0);
-            g.uniform1i(g.getUniformLocation(mulProg, "u_ev"), 1);
-        });
+        runHdrGradeDraw(host, state, multiplied, hdr, evWrite, gradeUniforms);
+        if (gradeUniforms)
+            recordPostStage("S10:hdr-grade:folded-s8");
         if (hdr !== source)
             state.pool.release(hdr);
         hdr = multiplied;
     }
+    else if (gradeUniforms) {
+        // ── S10 linear grade (no S8 this frame): one fullscreen draw ─────────────
+        const graded = state.pool.acquire({ width: w, height: h, format: "rgba16f", samples: 1, depth: false });
+        runHdrGradeDraw(host, state, graded, hdr, null, gradeUniforms);
+        recordPostStage("S10:hdr-grade");
+        if (hdr !== source)
+            state.pool.release(hdr);
+        hdr = graded;
+    }
     // ── §6.1 insertion "before-tonemap" (linear HDR, exposure applied) ────────
     const beforeTonemapPasses = customsAt("before-tonemap");
     let afterBloom;
@@ -1073,10 +1306,37 @@ frameContext) {
     const aaSmaa = pipeline.antiAliasing === "smaa";
     const displayCustoms = sortCustomPassesAtAnchor(mergedCustomPasses(pipeline), "after-tonemap");
     const rcas = (pipeline.renderScale ?? 1) < 1 ? 0.2 : 0;
+    // GU47 E-C (EC-2): the user `.cube` LUT, uploaded once per source.
+    const lut = displayLutBinding(host, state, pipeline.lut);
+    const bindLut = (g, prog) => {
+        g.activeTexture(g.TEXTURE1);
+        g.bindTexture(g.TEXTURE_3D, lut?.texture ?? state.identityLut);
+        // GU47 phase 2 (receipt effects-lut, LUT frame all black): the forward pass
+        // leaves material sampler objects bound on low units (webgl2/Samplers.ts);
+        // a mipmapped one overrides the LUT's LINEAR filter, the mip-less
+        // TEXTURE_3D is then incomplete and every fetch returns black. The
+        // identity LUT is never fetched (u_hasLut 0), so only LUT frames change.
+        g.bindSampler(1, null);
+        g.uniform1i(g.getUniformLocation(prog, "u_lut3d"), 1);
+        g.uniform1i(g.getUniformLocation(prog, "u_hasLut"), lut ? 1 : 0);
+        g.uniform1i(g.getUniformLocation(prog, "u_lutLattice"), lut ? 1 : 0);
+        g.uniform1f(g.getUniformLocation(prog, "u_lutBypass"), lut?.bypass ?? 0);
+    };
+    // GU47 E-C stage trace: the display stages that draw this frame.
+    const vignetteOn = (vignette?.intensity ?? 0) > 0;
+    const grainOn = (grain?.intensity ?? 0) > 0;
+    const traceDisplayStages = (fused) => {
+        if (vignetteOn || lut)
+            recordPostStage(`S10b:display-grade${vignetteOn ? ":vignette" : ""}${lut ? ":lut" : ""}${fused ? ":fused-fxaa" : ""}`);
+        if (grainOn)
+            recordPostStage(`S12:film-grain${fused ? ":fused-fxaa" : ""}`);
+    };
     // §6.1 fuse: FXAA + S10b + S12 in a single draw — only when nothing sits
     // between the stages (an after-tonemap custom pass splices S10b→S11).
     if (aaFxaa && displayCustoms.length === 0) {
         const prog = program(state, gl, "finalize-fxaa-fused", FINALIZE_FXAA_FUSED_GLSL);
+        traceDisplayStages(true);
+        recordPostStage("S11:fxaa:fused");
         bindOut(host, outTarget, w, h);
         gl.useProgram(prog);
         gl.bindVertexArray(state.vao);
@@ -1085,11 +1345,8 @@ frameContext) {
         gl.disable(gl.BLEND);
         gl.activeTexture(gl.TEXTURE0);
         gl.bindTexture(gl.TEXTURE_2D, ldrGl.colorHandle);
-        gl.activeTexture(gl.TEXTURE1);
-        gl.bindTexture(gl.TEXTURE_3D, state.identityLut);
+        bindLut(gl, prog);
         gl.uniform1i(gl.getUniformLocation(prog, "u_source"), 0);
-        gl.uniform1i(gl.getUniformLocation(prog, "u_lut3d"), 1);
-        gl.uniform1i(gl.getUniformLocation(prog, "u_hasLut"), 0);
         gl.uniform2f(gl.getUniformLocation(prog, "u_texelSize"), 1 / w, 1 / h);
         gl.uniform2f(gl.getUniformLocation(prog, "u_outputTexel"), 1 / w, 1 / h);
         gl.uniform1f(gl.getUniformLocation(prog, "u_frame"), state.frameIndex);
@@ -1110,17 +1367,15 @@ frameContext) {
         return;
     }
     let current = ldr;
-    // S10b — display grade (vignette; the .cube LUT bakes in with S10b's real
-    // bake pass — until then u_hasLut stays 0 and the identity 3D tex binds).
+    traceDisplayStages(false);
+    // S10b — display grade: vignette plus the user `.cube` (GU47 E-C, EC-2;
+    // the identity 3-D texture binds with u_hasLut 0 while no LUT resolved).
     if (vignette || pipeline.lut) {
         const graded = state.pool.acquire({ width: w, height: h, format: "rgba8", samples: 1, depth: false });
         const prog = program(state, gl, "display-grade", DISPLAY_GRADE_GLSL);
         draw(host, state, prog, asGlTarget(graded), [ldrGl.colorHandle], (g) => {
             g.uniform1i(g.getUniformLocation(prog, "u_source"), 0);
-            gl.activeTexture(gl.TEXTURE1);
-            gl.bindTexture(gl.TEXTURE_3D, state.identityLut);
-            g.uniform1i(g.getUniformLocation(prog, "u_lut3d"), 1);
-            g.uniform1i(g.getUniformLocation(prog, "u_hasLut"), 0);
+            bindLut(g, prog);
             g.uniform1f(g.getUniformLocation(prog, "u_vignetteIntensity"), vignette?.intensity ?? 0);
             g.uniform1f(g.getUniformLocation(prog, "u_vignetteSmoothness"), vignette?.smoothness ?? 1);
             g.uniform1f(g.getUniformLocation(prog, "u_vignetteRoundness"), vignette?.roundness ?? 1);
@@ -1130,19 +1385,25 @@ frameContext) {
         });
         current = graded;
     }
-    // §6.1 insertion "after-tonemap" (display-referred RGBA8 customs).
+    // §6.1 insertion "after-tonemap" (display-referred RGBA8 customs). GU47 E-E
+    // handoff H2: a display custom declaring `inputs` "depth" reads the frame's
+    // scene depth, linearised once per tail (the HDR stages' linZ is gone by now).
+    const tailLinZ = displayCustomLinearDepth(host, state, displayCustoms, frameContext, w, h);
     for (const pass of displayCustoms) {
-        const out = runCustomPass(host, state, pass, current, {}, null, frameContext);
+        const out = runCustomPass(host, state, pass, current, tailLinZ ? { linZ: tailLinZ } : {}, null, frameContext);
         if (out !== current) {
             if (current !== ldr)
                 state.pool.release(current);
             current = out;
         }
     }
+    if (tailLinZ)
+        state.pool.release(tailLinZ);
     // S11 — SMAA 1x three-pass (§8.14). The lazy textures warm on first use;
     // until both land, the stage skips (same first-frames window as three's
     // async Image load — never a silent FXAA substitution).
     if (aaSmaa && smaaTexturesReady(host, state)) {
+        recordPostStage("S11:smaa");
         const edges = state.pool.acquire({ width: w, height: h, format: "rgba8", samples: 1, depth: false });
         const edgesProg = program(state, gl, "smaa-edges", SMAA_EDGES_GLSL);
         draw(host, state, edgesProg, asGlTarget(edges), [asGlTarget(current).colorHandle], (g) => {
@@ -1176,6 +1437,7 @@ frameContext) {
     }
     else if (aaFxaa && displayCustoms.length > 0) {
         // FXAA unfused: an after-tonemap custom already consumed the fused slot.
+        recordPostStage("S11:fxaa");
         const aa = state.pool.acquire({ width: w, height: h, format: "rgba8", samples: 1, depth: false });
         const fxaaProg = program(state, gl, "fxaa-standalone-nodither", FXAA_185_FRAGMENT_GLSL.replace("#version 300 es", "#version 300 es\n#define AURA_FXAA_NO_DITHER"));
         draw(host, state, fxaaProg, asGlTarget(aa), [asGlTarget(current).colorHandle], (g) => {
@@ -1212,6 +1474,35 @@ frameContext) {
     if (current !== ldr)
         state.pool.release(current);
 }
+/**
+ * GU47 E-E handoff H2: linear depth (RGBA32F `.r` = view-space metres, the S1
+ * pass A program) for the LDR tail's `after-tonemap` customs that declare
+ * `inputs` "depth", from the C-13 `sceneDepth` (the forward target's depth
+ * texture; the present already resolved it). `null` — the pass keeps the 1×1
+ * blank, as before — when no display custom reads depth or the frame has no
+ * scene depth. The caller releases the target after the custom loop.
+ */
+function displayCustomLinearDepth(host, state, passes, frameContext, width, height) {
+    if (!passes.some((pass) => pass.inputs.includes("depth")))
+        return null;
+    const sceneDepth = frameContext?.sceneDepth;
+    if (!sceneDepth?.available || !sceneDepth.texture)
+        return null;
+    const depthHandle = host.textureRegistry?.textures.get(sceneDepth.texture);
+    if (!depthHandle)
+        return null;
+    const gl = host.gl;
+    recordPostStage("S1:depth-prep:after-tonemap");
+    const linZ = state.pool.acquire({ width, height, format: "rgba32f", samples: 1, depth: false });
+    const linProg = program(state, gl, "depth-linearize", DEPTH_LINEARIZE_GLSL);
+    draw(host, state, linProg, asGlTarget(linZ), [depthHandle], (g) => {
+        g.uniform1i(g.getUniformLocation(linProg, "u_depth"), 0);
+        g.uniform1f(g.getUniformLocation(linProg, "u_near"), sceneDepth.linearize.near);
+        g.uniform1f(g.getUniformLocation(linProg, "u_far"), sceneDepth.linearize.far);
+        g.uniform1i(g.getUniformLocation(linProg, "u_ortho"), sceneDepth.linearize.orthographic ? 1 : 0);
+    });
+    return linZ;
+}
 function bindOut(host, outTarget, w, h) {
     const gl = host.gl;
     if (outTarget) {