@forgeax/engine-runtime 0.1.20 → 0.1.23

package/src/__tests__/shadow-fields-observable.dawn.test.ts

@@ -1,8 +1,8 @@
 // shadow-fields-observable.dawn.test.ts
 // feat-20260621-merge-directionallightshadow-into-directionallight M6
 //
-// Observability gate: proves depthBias, normalBias, pcfKernelSize --
-// three merged DirectionalLight shadow fields -- produce real pixel A/B diffs.
+// Observability gate: proves depthBias, normalBias, and the directional filter
+// carrier -- three merged DirectionalLight shadow fields -- produce real pixel A/B diffs.
 //
 // Root cause of prior "0 diff everywhere" failure: (a) materials without
 // ShadowCaster pass (nothing written into shadow depth atlas), (b) floor
@@ -29,11 +29,18 @@ import { validateDirectionalLightData } from '../../../render/src/components/lig
 import { constructRuntimeRendererHost } from '../renderer-host';
 import { drawPublished } from './draw-published';
 
-const WIDTH = 256;
-const HEIGHT = 256;
+const LIGHTWEIGHT_DAWN = process.env.FORGEAX_DAWN_LIGHTWEIGHT === '1';
+// The CI observability lane only needs enough settled frames to prove the
+// field-owned pixel/UBO deltas. Keep the full 300-frame, 256x256 window for
+// local and nightly runs, while the isolated PR process uses a bounded 60-frame
+// 128x128 target to avoid retaining a large lavapipe command backlog.
+const SHADOW_FIELDS_RENDER_FRAMES = LIGHTWEIGHT_DAWN ? 60 : 300;
+const WIDTH = LIGHTWEIGHT_DAWN ? 128 : 256;
+const HEIGHT = LIGHTWEIGHT_DAWN ? 128 : 256;
 const BPR = Math.ceil((WIDTH * 4) / 256) * 256;
 
-// Each falsifier performs four fresh 256x256 Dawn readbacks. Windows' Dawn
+// Each falsifier performs four fresh Dawn readbacks at the active target size
+// (256x256 by default, 128x128 in the lightweight CI lane). Windows' Dawn
 // prebuild can exceed Vitest's 90-second bound for that sequence while still
 // completing well inside the nightly platform job's 45-minute budget.
 const SHADOW_FIELDS_FALSIFIER_TIMEOUT_MS = 300_000;
@@ -44,6 +51,59 @@ const ENGINE_MANIFEST = await (async () => {
 })();
 const ENGINE_MANIFEST_URL = `data:application/json,${encodeURIComponent(JSON.stringify(ENGINE_MANIFEST))}`;
 
+describe('M3 Dawn candidate admission', () => {
+  it('requires accepted production candidate to preserve the requested PCSS profile', async () => {
+    const module = (await import('../../../render/src/render-pipeline')) as Record<string, unknown>;
+    const resolver = module.resolveDirectionalShadowBackendAdmission;
+    expect(typeof resolver).toBe('function');
+    const result = (
+      resolver as (input: {
+        backendKind: 'webgpu';
+        requested: 'pcssMedium' | 'pcssHigh';
+        candidate: 'accepted' | 'failed';
+      }) => { effective: string; status: string; pixelEvidence: string }
+    )({ backendKind: 'webgpu', requested: 'pcssHigh', candidate: 'accepted' });
+    expect(result).toMatchObject({
+      effective: 'pcssHigh',
+      status: 'accepted',
+      pixelEvidence: 'available',
+    });
+  });
+
+  it('requires the same bounded Directional inspection projection used by Dawn', async () => {
+    const module = (await import(
+      '../../../render/src/assembly/directional-shadow-inspection'
+    )) as Record<string, unknown>;
+    const project = module.projectDirectionalShadowInspection;
+    expect(typeof project).toBe('function');
+    const result = (project as (input: Record<string, unknown>) => Record<string, unknown>)({
+      admission: {
+        requested: 'pcssMedium',
+        effective: 'pcssMedium',
+        status: 'accepted',
+        pixelEvidence: 'available',
+      },
+      cascadeCount: 4,
+      mapSize: 1024,
+      atlasBytes: 16_777_216,
+      writerPasses: 4,
+      blockerTaps: 8,
+      filterTapUpperBound: 16,
+      seamTapUpperBound: 48,
+      deviceGeneration: 1,
+      graphGeneration: 3,
+    });
+    expect(result).toMatchObject({
+      requested: 'pcssMedium',
+      effective: 'pcssMedium',
+      blockerTaps: 8,
+      filterTapUpperBound: 16,
+      seamTapUpperBound: 48,
+    });
+    expect(Object.keys(result)).not.toContain('perPixel');
+  });
+});
+
 // Helper types
 interface WriteCapture {
   f32: Float32Array;
@@ -177,7 +237,9 @@ function spawnScene(
       depthBias,
       normalBias,
       shadowDistance: 50,
-      pcfKernelSize: pcf,
+      shadowFilter: pcf === 1 ? 1 : pcf === 3 ? 2 : 3,
+      shadowAngularRadius: 0.00465,
+      maxPenumbraTexels: 32,
     },
   });
   world.spawn(
@@ -300,9 +362,13 @@ async function renderConfig(
     const w = new World();
     spawnScene(w, castShadow, depthBias, normalBias, pcf, mapSize);
     let de = 0;
-    for (let i = 0; i < 300; i++) {
+    for (let i = 0; i < SHADOW_FIELDS_RENDER_FRAMES; i++) {
       const r = drawPublished(renderer, w);
       if (!r.ok) de++;
+      // Keep the native Dawn carrier paced like a real frame loop. Without a
+      // bounded drain, a long shadow-map leg can retain an unbounded lavapipe
+      // command/resource backlog before the final fence below.
+      if (i % 16 === 15) await dev.queue.onSubmittedWorkDone();
     }
     if (de > 0) throw new Error(`draw errors: ${de}`);
     // rt is created lazily by the canvas configure()/getCurrentTexture path during
@@ -437,15 +503,15 @@ async function renderConfigWithSpy(
 
 describe('M6 shadow fields observability', () => {
   // --- Gate A: structural WGSL check ---
-  it('composed default-standard-pbr WGSL reads view.depthBias, view.normalBias, view.pcfKernelSize', () => {
+  it('composed default-standard-pbr WGSL reads view.depthBias, view.normalBias, and directionalShadowFilter', () => {
     const wgsl = composedStandardPbr();
     expect(wgsl).toContain('depthBias');
     expect(wgsl).toContain('normalBias');
-    expect(wgsl).toContain('pcfKernelSize');
+    expect(wgsl).toContain('directionalShadowFilter');
   });
 
-  // --- Gate B: UBO spy — slots [126]=depthBias, [127]=normalBias, [128]=pcfKernelSize ---
-  it('View UBO slots [126]=depthBias, [127]=normalBias, [128]=pcfKernelSize', async () => {
+  // --- Gate B: UBO spy — slots [126]=depthBias, [127]=normalBias, [128]=filter profile ---
+  it('View UBO slots [126]=depthBias, [127]=normalBias, [128]=filter profile', async () => {
     if (typeof globalThis.navigator?.gpu?.requestAdapter !== 'function') return;
     const { captured } = await renderConfigWithSpy(true, 0.123, 0.456, 3);
     const vw = captured.filter((c) => c.f32.length >= 148);
@@ -455,22 +521,22 @@ describe('M6 shadow fields observability', () => {
     const f32 = last.f32;
     expect(Math.abs((f32[126] ?? Number.NaN) - 0.123)).toBeLessThan(0.001);
     expect(Math.abs((f32[127] ?? Number.NaN) - 0.456)).toBeLessThan(0.001);
-    expect(f32[128]).toBe(3);
+    expect(f32[128]).toBe(2);
   }, 60000);
 
-  // --- Gate D: pcfKernelSize clamp (9 -> 5; cap matches WGSL MAX_PCF_HALF=2) ---
-  it('pcfKernelSize=9 clamped to 5 in View UBO[128]', async () => {
+  // --- Gate D: pcf5 maps to the accepted profile carrier ---
+  it('pcf5 maps to profile 3 in View UBO[128]', async () => {
     if (typeof globalThis.navigator?.gpu?.requestAdapter !== 'function') return;
-    const { captured } = await renderConfigWithSpy(true, 0.005, 0.05, 9);
+    const { captured } = await renderConfigWithSpy(true, 0.005, 0.05, 5);
     const vw9 = captured.filter((c) => c.f32.length >= 148);
     expect(vw9.length).toBeGreaterThan(0);
     const last9 = vw9[vw9.length - 1];
     if (last9 === undefined) throw new Error('no view UBO write captured');
-    expect(last9.f32[128]).toBe(5);
+    expect(last9.f32[128]).toBe(3);
   }, 60000);
 
-  // --- Gate D: validate() rejections ---
-  it('validate() accepts pcfKernelSize=9 (odd), rejects 2 (even) and 0', () => {
+  // --- Gate D: Directional filter validation ---
+  it('validate() accepts pcf5 and rejects an unknown directional filter', () => {
     const valid = validateDirectionalLightData({
       direction: [0, -1, 0],
       castShadow: true,
@@ -479,7 +545,7 @@ describe('M6 shadow fields observability', () => {
       cascadeBlend: 0.2,
       mapSize: 2048,
       shadowDistance: 50,
-      pcfKernelSize: 9,
+      shadowFilter: 3,
     });
     expect(valid.ok).toBe(true);
 
@@ -491,7 +557,7 @@ describe('M6 shadow fields observability', () => {
       cascadeBlend: 0.2,
       mapSize: 2048,
       shadowDistance: 50,
-      pcfKernelSize: 2,
+      shadowFilter: 99,
     });
     expect(even.ok).toBe(false);
     if (!even.ok) expect(even.error.code).toBe('shadow-invalid-config');
@@ -504,7 +570,7 @@ describe('M6 shadow fields observability', () => {
       cascadeBlend: 0.2,
       mapSize: 2048,
       shadowDistance: 50,
-      pcfKernelSize: 0,
+      shadowFilter: 0,
     });
     expect(zero.ok).toBe(false);
     if (!zero.ok) expect(zero.error.code).toBe('shadow-invalid-config');
@@ -519,6 +585,16 @@ describe('M6 shadow fields observability', () => {
     expect(d.diff).toBeGreaterThan(0);
   }, 60000);
 
+  it('castShadow=false emits a zero directional cascade count in the View UBO', async () => {
+    if (typeof globalThis.navigator?.gpu?.requestAdapter !== 'function') return;
+    const { captured } = await renderConfigWithSpy(false, 0.005, 0.05, 3);
+    const viewWrites = captured.filter((capture) => capture.f32.length >= 148);
+    expect(viewWrites.length).toBeGreaterThan(0);
+    const last = viewWrites[viewWrites.length - 1];
+    if (last === undefined) throw new Error('no view UBO write captured');
+    expect(last.f32[124]).toBe(0);
+  }, 60000);
+
   // --- Gate C: pixel A/B — depthBias 0.0 vs 0.5 ---
   it('pixel A/B: depthBias 0.0 vs 0.5', async () => {
     if (typeof globalThis.navigator?.gpu?.requestAdapter !== 'function') return;
@@ -537,8 +613,8 @@ describe('M6 shadow fields observability', () => {
     expect(d.diff).toBeGreaterThan(0);
   }, 60000);
 
-  // --- Gate C: pixel A/B — pcfKernelSize 1 vs 5 (cap; MAX_PCF_HALF=2) ---
-  it('pixel A/B: pcfKernelSize 1 vs 5', async () => {
+  // --- Gate C: pixel A/B — directional filter profile 1 vs 3 ---
+  it('pixel A/B: directional filter profile 1 vs 3', async () => {
     if (typeof globalThis.navigator?.gpu?.requestAdapter !== 'function') return;
     const pxA = await renderConfig(true, 0.005, 0.05, 1);
     const pxB = await renderConfig(true, 0.005, 0.05, 5);
@@ -624,7 +700,7 @@ describe('M6 shadow fields observability', () => {
   );
 
   it(
-    'falsification: pcfKernelSize varied differs, held does not',
+    'falsification: directional filter varied differs, held does not',
     async () => {
       if (typeof globalThis.navigator?.gpu?.requestAdapter !== 'function') return;
       const varied = diff(

package/src/__tests__/skin-extract-getarrayview-count.unit.test.ts

@@ -15,7 +15,7 @@ const extractPath = (() => {
 describe('_getArrayView count (AC-03 gate)', () => {
   it('keeps skin and instance hot fields on column views', () => {
     const src = readFileSync(extractPath, 'utf8');
-    expect(src).toContain("_getArrayView(jointEntity, Transform, 'world')");
+    expect(src).toContain("_getArrayView(jointEntity, GlobalTransform, 'world')");
     expect(src).toContain("_getArrayView(entity, Instances, 'transforms')");
     expect(src).toContain("_getArrayView(entity, SpriteInstances, 'transforms')");
     expect(src).toContain("_getArrayView(entity, SpriteInstances, 'regions')");

package/src/__tests__/skin-parented-double-transform.test.ts

@@ -34,7 +34,7 @@ import { fileURLToPath } from 'node:url';
 import { World } from '@forgeax/engine-ecs';
 import type { Mat4, Vec3 } from '@forgeax/engine-math';
 import { mat4, vec3 } from '@forgeax/engine-math';
-import { ChildOf, propagateTransforms, Transform } from '@forgeax/engine-scene';
+import { ChildOf, GlobalTransform, propagateTransforms, Transform } from '@forgeax/engine-scene';
 import { Skin } from '@forgeax/engine-skinning';
 import { describe, expect, it } from 'vitest';
 
@@ -125,13 +125,13 @@ describe('skin parented double transform (AC-01)', () => {
     const r = propagateTransforms(world);
     expect(r.ok).toBe(true);
 
-    // Read Transform.world for skin entity and joint entity.
-    const st = world.get(skinEntity, Transform);
+    // Read derived GlobalTransform.world for skin entity and joint entity.
+    const st = world.get(skinEntity, GlobalTransform);
     expect(st.ok).toBe(true);
     if (!st.ok) return;
     const meshWorldMat = mat4FromFloat32Array(st.value.world as unknown as Float32Array);
 
-    const jt = world.get(jointEntity, Transform);
+    const jt = world.get(jointEntity, GlobalTransform);
     expect(jt.ok).toBe(true);
     if (!jt.ok) return;
     const jointWorldMat = mat4FromFloat32Array(jt.value.world as unknown as Float32Array);
@@ -202,7 +202,7 @@ describe('skin parented double transform (AC-01)', () => {
     const r = propagateTransforms(world);
     expect(r.ok).toBe(true);
 
-    const jt = world.get(jointEntity, Transform);
+    const jt = world.get(jointEntity, GlobalTransform);
     expect(jt.ok).toBe(true);
     if (!jt.ok) return;
     const jointWorldMat = mat4FromFloat32Array(jt.value.world as unknown as Float32Array);

package/src/__tests__/skinned-shadow-mixed.dawn.test.ts

@@ -203,7 +203,9 @@ function spawnMixedScene(world: World, castShadow: boolean): void {
       depthBias: 0.005,
       normalBias: 0.05,
       shadowDistance: 50,
-      pcfKernelSize: 3,
+      shadowFilter: 2,
+      shadowAngularRadius: 0.00465,
+      maxPenumbraTexels: 32,
     },
   });
 
@@ -216,12 +218,7 @@ function spawnMixedScene(world: World, castShadow: boolean): void {
   };
   // Entity order is intentional: static A -> skinned B -> static C.
   spawnStaticCaster(-3);
-  const joint = world
-    .spawn({
-      component: Transform,
-      data: identityTransform([0, 7, 5]),
-    })
-    .unwrap();
+  const joint = world.spawn({ component: Transform, data: identityTransform([0, 7, 5]) }).unwrap();
   world.spawn(
     { component: Transform, data: identityTransform() },
     { component: MeshFilter, data: { assetHandle: skinMesh } },

package/src/__tests__/skylight-lazy-projection.test.ts

@@ -260,10 +260,10 @@ describe('driveLazyEquirectProjection — lazy projection state machine (M3 / w2
     const world = new World();
     const handle = catalogEquirect(world, equirectPod());
     const reg = new RhiErrorListenerRegistry();
-    const fired: Array<{ code: string; handle: number | undefined }> = [];
+    const fired: Array<{ code: string; handle: number | undefined; hint?: string }> = [];
     reg.add((e) => {
       if (e.code === 'equirect-projection-failed') {
-        fired.push({ code: e.code, handle: e.detail.handle });
+        fired.push({ code: e.code, handle: e.detail.handle, hint: e.hint });
       } else {
         fired.push({ code: e.code, handle: undefined });
       }
@@ -281,9 +281,12 @@ describe('driveLazyEquirectProjection — lazy projection state machine (M3 / w2
 
     // Frame 2: status:'failed' observed -> fire the structured error ONCE.
     driveLazyEquirectProjection(internals, world, frameState, handle as unknown as number);
-    expect(fired).toEqual([
-      { code: 'equirect-projection-failed', handle: handle as unknown as number },
-    ]);
+    expect(fired).toHaveLength(1);
+    expect(fired[0]).toMatchObject({
+      code: 'equirect-projection-failed',
+      handle: handle as unknown as number,
+    });
+    expect(fired[0]?.hint).toContain('declare Skylight');
 
     // Frame 3+: the latch keeps the channel quiet -- no re-fire, no retry
     // (the store's status:'failed' short-circuit + the frameState latch).

package/src/__tests__/sprite-lit-bgl-byte-identical.test.ts

@@ -46,22 +46,22 @@ function makeSpec(shaderId: string): PipelineSpec {
 }
 
 describe('sprite-lit BGL byte-identical to sprite (AC-07, w4/w5 close)', () => {
-  describe('pbr-view BGL (light buffers; binding 1+2)', () => {
-    it('sprite-lit vs sprite share the same 12-entry pbr-view BGL under storage-buffer caps', () => {
+  describe('pbr-view BGL (Cluster lights live in group(2))', () => {
+    it('sprite-lit vs sprite share the same 10-entry pbr-view BGL under storage-buffer caps', () => {
       const spriteSpec = makeSpec('forgeax::sprite');
       const spriteLitSpec = makeSpec('forgeax::sprite-lit');
       const sprite = buildBindGroupLayoutDescriptor(spriteSpec, {
         kind: 'pbr-view',
-        caps: { storageBuffer: true },
+        caps: { storageBuffer: true, extendedLighting: false },
       });
       const spriteLit = buildBindGroupLayoutDescriptor(spriteLitSpec, {
         kind: 'pbr-view',
-        caps: { storageBuffer: true },
+        caps: { storageBuffer: true, extendedLighting: false },
       });
       expect(JSON.stringify(spriteLit)).toBe(JSON.stringify(sprite));
       // binding 10 is the shared Points/Lines view UBO; bindings 11/12 are the
       // optional SpotLight projector texture and sampler on capable devices.
-      expect(spriteLit.entries.length).toBe(12);
+      expect(spriteLit.entries.length).toBe(10);
     });
 
     it('sprite-lit vs sprite share the same 10-entry pbr-view BGL under uniform fallback caps (AC-10)', () => {
@@ -69,25 +69,23 @@ describe('sprite-lit BGL byte-identical to sprite (AC-07, w4/w5 close)', () => {
       const spriteLitSpec = makeSpec('forgeax::sprite-lit');
       const sprite = buildBindGroupLayoutDescriptor(spriteSpec, {
         kind: 'pbr-view',
-        caps: { storageBuffer: false },
+        caps: { storageBuffer: false, extendedLighting: false },
       });
       const spriteLit = buildBindGroupLayoutDescriptor(spriteLitSpec, {
         kind: 'pbr-view',
-        caps: { storageBuffer: false },
+        caps: { storageBuffer: false, extendedLighting: false },
       });
       expect(JSON.stringify(spriteLit)).toBe(JSON.stringify(sprite));
     });
 
-    it('binding 1 + 2 are read-only-storage on storageBuffer=true (point/spot light buffers)', () => {
+    it('does not expose point/spot light bindings on storageBuffer=true', () => {
       const entries = buildPbrViewBglEntries({ storageBuffer: true });
-      expect(entries[1]?.buffer?.type).toBe('read-only-storage');
-      expect(entries[2]?.buffer?.type).toBe('read-only-storage');
+      expect(entries.some((entry) => entry.binding === 1 || entry.binding === 2)).toBe(false);
     });
 
-    it('binding 1 + 2 fall back to uniform on storageBuffer=false (AC-10 fallback)', () => {
+    it('does not expose point/spot light bindings on storageBuffer=false', () => {
       const entries = buildPbrViewBglEntries({ storageBuffer: false });
-      expect(entries[1]?.buffer?.type).toBe('uniform');
-      expect(entries[2]?.buffer?.type).toBe('uniform');
+      expect(entries.some((entry) => entry.binding === 1 || entry.binding === 2)).toBe(false);
     });
   });
 

package/src/__tests__/ssao-bgl.test.ts

@@ -39,6 +39,7 @@ import {
   getOrCreateSsaoFallbackTexture,
   packClusterUniform,
 } from '../../../render/src/hdrp-buffers';
+import { BYTES_PER_DIRECT_LIGHT_SLOT } from '../../../render/src/light-buffer-layout';
 import { createHdrpBindGroupLayoutDescriptor } from '../../../render/src/pipeline-spec';
 import type { RenderSystemRuntime } from '../../../render/src/render-system';
 
@@ -131,9 +132,9 @@ function makeMockRuntime(capsOverride: Partial<RhiCaps> = {}): {
 
 function fakeHdrpBuffers(): HdrpBuffers {
   return {
-    storageBuffer: true,
+    device: {} as HdrpBuffers['device'],
     lightDataBuffer: mockBuffer('hdrp-light-data'),
-    lightDataBytes: 16384,
+    lightDataBytes: 256 * BYTES_PER_DIRECT_LIGHT_SLOT,
     clusterGridBuffer: mockBuffer('hdrp-cluster-grid'),
     clusterGridBytes: 1024,
     lightIndexListBuffer: mockBuffer('hdrp-light-index-list'),
@@ -150,15 +151,9 @@ function fakeHdrpBuffers(): HdrpBuffers {
 }
 
 describe('HDRP GPU membership producer bind-group contract', () => {
-  it('preserves the 256-light storage count while keeping the 128-light uniform default', () => {
-    const uniformPayload = new Uint32Array(
-      packClusterUniform({ x: 16, y: 9, z: 24 }, 0.1, 50, 0, 256),
-    );
-    const storagePayload = new Uint32Array(
-      packClusterUniform({ x: 16, y: 9, z: 24 }, 0.1, 50, 0, 256, 256),
-    );
-    expect(uniformPayload[3]).toBe(128);
-    expect(storagePayload[3]).toBe(256);
+  it('preserves the full 256-light Standard count in the cluster UBO', () => {
+    const payload = new Uint32Array(packClusterUniform({ x: 16, y: 9, z: 24 }, 0.1, 50, 0, 256));
+    expect(payload[3]).toBe(256);
   });
 
   it('keeps enabled SSAO intensity in the zero-punctual-light uniform path', () => {
@@ -209,12 +204,12 @@ describe('HDRP GPU membership producer bind-group contract', () => {
 
 describe('w28 — HDRP unified BGL SSAO entries (binding 7/8)', () => {
   it('descriptor entries.length === 7 (5 cluster + 2 ssao)', () => {
-    const desc = createHdrpBindGroupLayoutDescriptor(true);
+    const desc = createHdrpBindGroupLayoutDescriptor();
     expect(desc.entries?.length).toBe(7);
   });
 
   it('binding 7 is texture_2d<f32> with FRAGMENT visibility (ssaoBlurred)', () => {
-    const desc = createHdrpBindGroupLayoutDescriptor(true);
+    const desc = createHdrpBindGroupLayoutDescriptor();
     const b7 = desc.entries?.find((e) => e.binding === 7);
     expect(b7).toBeDefined();
     expect(b7?.visibility).toBe(FRAGMENT_VISIBILITY);
@@ -223,7 +218,7 @@ describe('w28 — HDRP unified BGL SSAO entries (binding 7/8)', () => {
   });
 
   it('binding 8 is sampler with FRAGMENT visibility (ssaoSampler)', () => {
-    const desc = createHdrpBindGroupLayoutDescriptor(true);
+    const desc = createHdrpBindGroupLayoutDescriptor();
     const b8 = desc.entries?.find((e) => e.binding === 8);
     expect(b8).toBeDefined();
     expect(b8?.visibility).toBe(FRAGMENT_VISIBILITY);
@@ -231,13 +226,13 @@ describe('w28 — HDRP unified BGL SSAO entries (binding 7/8)', () => {
   });
 
   it('binding 9 is absent (scope-amend-webgl2-ubo: intensity folded into binding 6)', () => {
-    const desc = createHdrpBindGroupLayoutDescriptor(true);
+    const desc = createHdrpBindGroupLayoutDescriptor();
     const bindings = desc.entries?.map((e) => e.binding) ?? [];
     expect(bindings).not.toContain(9);
   });
 
   it('existing bindings 0/3/4/5/6 remain unchanged', () => {
-    const desc = createHdrpBindGroupLayoutDescriptor(true);
+    const desc = createHdrpBindGroupLayoutDescriptor();
     const b0 = desc.entries?.find((e) => e.binding === 0);
     expect(b0?.buffer?.hasDynamicOffset).toBe(true);
     for (const b of [3, 4, 5, 6]) {
@@ -247,7 +242,7 @@ describe('w28 — HDRP unified BGL SSAO entries (binding 7/8)', () => {
   });
 
   it('all bindings exactly { 0, 3, 4, 5, 6, 7, 8 }', () => {
-    const desc = createHdrpBindGroupLayoutDescriptor(true);
+    const desc = createHdrpBindGroupLayoutDescriptor();
     const bindings = new Set(desc.entries?.map((e) => e.binding));
     expect(bindings).toEqual(new Set([0, 3, 4, 5, 6, 7, 8]));
   });

package/src/__tests__/ssao-passes.test.ts

@@ -63,7 +63,14 @@ interface SpyCtx {
 }
 
 function makeDispatchSpyCtx(
-  opts: { ssaoCalcPipeline?: unknown; ssaoBlurPipeline?: unknown; ssaoBgl?: unknown } = {},
+  opts: {
+    ssaoCalcPipeline?: unknown;
+    ssaoBlurPipeline?: unknown;
+    ssaoBgl?: unknown;
+    fxaaPipeline?: unknown;
+    fxaaBindGroupLayout?: unknown;
+    fxaaSampler?: unknown;
+  } = {},
 ): SpyCtx {
   const spy: DispatchSpy = {
     beginRenderPassCalls: [],
@@ -138,10 +145,12 @@ function makeDispatchSpyCtx(
     removeEventListener: vi.fn(),
   };
 
+  const fxaaParamsBuffer = { __label: 'fxaa-params' };
   const runtime = {
     device,
     errorRegistry,
     shaderCache: { get: vi.fn() },
+    getPostProcessParamsBuffer: vi.fn(() => fxaaParamsBuffer),
   } as unknown as RenderSystemRuntime;
 
   // Pre-seed ssao-buffers cache so the record closure resolves a stable
@@ -162,6 +171,13 @@ function makeDispatchSpyCtx(
       ssaoFilteringSampler: null,
       ssaoDepthSampler: null,
       ssaoFallbackRawView: null,
+      // FXAA is part of the same Standard post chain. Keep the fixture's
+      // fullscreen resources complete so recordAll exercises the real FXAA
+      // bind-group path instead of returning early at its capability gate.
+      fxaaPipeline: 'fxaaPipeline' in opts ? opts.fxaaPipeline : { __label: 'fxaa-pipeline' },
+      fxaaBindGroupLayout:
+        'fxaaBindGroupLayout' in opts ? opts.fxaaBindGroupLayout : { __label: 'fxaa-bgl' },
+      fxaaSampler: 'fxaaSampler' in opts ? opts.fxaaSampler : { __label: 'fxaa-sampler' },
     },
   };
 
@@ -215,7 +231,6 @@ function makeDispatchSpyCtx(
     meshBindGroup: null,
     frameState: {
       perFrameGraph: mockPerFrameGraph,
-      isHdrpActive: true,
       installedPipelineConfig: { ssao: { enabled: true, intensity: 1.0 } },
       // Post-process bind group identity cache (bloom / fxaa / ssao). Keyed on
       // the graph-resolved views so resize rebuilds automatically.
@@ -673,6 +688,7 @@ function makePostProcessRecordCtx(): {
     draw: vi.fn(),
     end: vi.fn(),
   };
+  const fxaaParamsBuffer = { label: 'fxaa-params' };
   const device = {
     createBindGroup: vi.fn((desc: PostProcessBindGroupCreate) => {
       bindGroupCreates.push(desc);
@@ -711,6 +727,7 @@ function makePostProcessRecordCtx(): {
     runtime: {
       device: { ...device, caps: { storageBuffer: true } },
       errorRegistry: { fire: vi.fn() },
+      getPostProcessParamsBuffer: vi.fn(() => fxaaParamsBuffer),
     },
     store: { getCubemapGpuView: vi.fn() },
     encoder: {