@forgeax/engine-runtime 0.1.20 → 0.1.21

package/src/__tests__/view-ubo-layout.browser.test.ts

@@ -1,6 +1,7 @@
 // view-ubo-layout.browser.test.ts - feat-20260518-pbr-direct-lighting-mvp
-// feat-20260531-skybox-env-background M2 / w4 (TDD red): VIEW_UBO_BYTES
-// 112 -> 176 -> 240 layout (worldViewProj 64 B + lightDir 16 B + lightColor
+// feat-20260827-directional-csm-pcss-quality M1: VIEW_UBO_BYTES remains 960
+// while the View slot remains 1024 B. The prefix layout is unchanged and the
+// directional shadow carrier reuses the existing tail pad.
 // 16 B + cameraPos 16 B + lightSpaceMatrix 64 B + inverseViewProj 64 B;
 // std140 vec3 padded to 16-byte boundaries).
 //
@@ -44,14 +45,16 @@ const VIEW_UBO_OFFSETS = {
   lightSpaceMatrix: 112,
   inverseViewProj: 176,
 } as const;
-const VIEW_UBO_BYTES = 240;
+const VIEW_UBO_BYTES = 960;
+const DIRECTIONAL_FILTER_OFFSET = 512;
+const SPOT_LIGHT_VIEW_PROJ_OFFSET = 528;
 
 describe('w4 view UBO 240 B std140 layout (AC-06, browser)', () => {
-  it.skipIf(!browserReady)('host write payload is exactly 240 bytes (60 floats)', () => {
-    // The host (render-system-record.ts) builds a Float32Array(60) and
+  it.skipIf(!browserReady)('host write payload is exactly 960 bytes (240 floats)', () => {
+    // The host (view-ubo.ts) builds a Float32Array(240) and
     // emits a single queue.writeBuffer. Asserting the size lock here keeps
     // the host shape and shader ABI in agreement before the GPU sees it.
-    const payload = new Float32Array(60);
+    const payload = new Float32Array(240);
     expect(payload.byteLength).toBe(VIEW_UBO_BYTES);
   });
 
@@ -63,17 +66,17 @@ describe('w4 view UBO 240 B std140 layout (AC-06, browser)', () => {
     expect(VIEW_UBO_OFFSETS.lightSpaceMatrix).toBe(112);
     expect(VIEW_UBO_OFFSETS.inverseViewProj).toBe(176);
     // Buffer total = inverseViewProj offset + mat4 (64 B) = 240.
-    expect(VIEW_UBO_OFFSETS.inverseViewProj + 64).toBe(VIEW_UBO_BYTES);
+    expect(VIEW_UBO_OFFSETS.inverseViewProj + 64).toBe(240);
   });
 
   it.skipIf(!browserReady)(
     'host packs lightDir / lightColor / cameraPos at canonical std140 slots',
     () => {
       // Canonical packing order documented in plan-strategy D-4: the host
-      // builds a 60-float buffer mirroring the shader-side `View` struct
+      // builds a 240-float buffer mirroring the shader-side `View` struct
       // field order. AC-06: existing field offsets unchanged -- tail append
       // only.
-      const payload = new Float32Array(60);
+      const payload = new Float32Array(240);
       // worldViewProj = identity for this assertion (mat4 in [0..16))
       payload[0] = 1; // m00
       payload[5] = 1; // m11
@@ -133,7 +136,7 @@ describe('w4 view UBO 240 B std140 layout (AC-06, browser)', () => {
     // calculation.
     const inverseProjF32Index = VIEW_UBO_OFFSETS.inverseViewProj / 4;
     expect(inverseProjF32Index).toBe(44);
-    const payload = new Float32Array(60);
+    const payload = new Float32Array(240);
     // Place an identity mat4 at inverseViewProj slot [44..59]
     payload[44] = 1;
     payload[49] = 1;
@@ -145,6 +148,13 @@ describe('w4 view UBO 240 B std140 layout (AC-06, browser)', () => {
     expect(payload[59]).toBe(1);
   });
 
+  it.skipIf(!browserReady)('shadow tail keeps the directional carrier before spot matrices', () => {
+    expect(DIRECTIONAL_FILTER_OFFSET).toBe(126 * 4 + 8);
+    expect(SPOT_LIGHT_VIEW_PROJ_OFFSET).toBe(132 * 4);
+    expect(SPOT_LIGHT_VIEW_PROJ_OFFSET - DIRECTIONAL_FILTER_OFFSET).toBe(16);
+    expect(SPOT_LIGHT_VIEW_PROJ_OFFSET + 4 * 4 * 16).toBe(VIEW_UBO_BYTES - 176);
+  });
+
   it.skipIf(!browserReady)(
     'existing field offsets unchanged by tail append (AC-06 rear-append guarantee)',
     () => {

package/src/createRenderer.ts

@@ -39,6 +39,7 @@ export async function createRenderer(
           ...(options.standardProfile === undefined
             ? {}
             : { standardProfile: options.standardProfile }),
+          ...(options.gpuPassTiming === undefined ? {} : { gpuPassTiming: options.gpuPassTiming }),
         };
   try {
     const constructed = await constructRuntimeRendererHost(canvas, rendererOptions, bundler);

package/src/index.ts

@@ -340,8 +340,7 @@ export {
 // never rendered). One barrel entry => one module copy => one registry shared by
 // createDebugDrawOnReady (the writer) and attachDebugOverlayPass (the reader).
 // feat-20260704-runtime-tier1-decomposition M2 / w10 (D-3): the third error
-// re-export block (HdrpCapsInsufficientError / HdrpIndexListOverflowError /
-// HdrpLightBudgetExceededError) is folded into the render-cluster class
+// re-export block (Standard Cluster error classes) is folded into the render-cluster class
 // re-export block above -- they are render-cluster members sourced from
 // ./errors/render.
 // feat-20260608-cluster-lighting M2 / w10 + verify F-1/F-2: HDRP cluster-forward