@forgeax/engine-runtime 0.1.20 → 0.1.23

package/src/__tests__/systems.unit.test.ts

@@ -80,7 +80,13 @@ import {
 } from '@forgeax/engine-render';
 import type { BindGroupEntry, Buffer, Sampler, Texture, TextureView } from '@forgeax/engine-rhi';
 import { ok as rhiOk } from '@forgeax/engine-rhi';
-import { ChildOf, Name, propagateTransforms, Transform } from '@forgeax/engine-scene';
+import {
+  ChildOf,
+  GlobalTransform,
+  Name,
+  propagateTransforms,
+  Transform,
+} from '@forgeax/engine-scene';
 import { TONEMAP_LUMINANCE_EPSILON } from '@forgeax/engine-shader';
 import type { SkinErrorCode } from '@forgeax/engine-skinning';
 import {
@@ -206,11 +212,7 @@ import {
 } from '../../../render/src/instance-buffer-cache';
 import { standardPipeline as urpPipeline } from '../../../render/src/pipeline/standard-pipeline';
 import { ZERO_CAMERA_CLEAR_FALLBACK } from '../../../render/src/record/frame-snapshot';
-import {
-  warnMultiLightDirectional,
-  warnMultiLightPoint,
-  warnMultiLightSpot,
-} from '../../../render/src/record/helpers';
+import { warnMultiLightDirectional } from '../../../render/src/record/helpers';
 import type { CameraSnapshot } from '../../../render/src/render-contract';
 import {
   type ExtractedLights,
@@ -448,9 +450,9 @@ import { makeMockShaderRegistry } from './helpers/mock-shader-registry';
     ];
   }
 
-  describe('Camera schema (19 fields: 17 f32 + clearColor array + autoAspect bool after w9 + tonemap-mvp + fxaa + bloom + clearColor + aspect-sync extensions)', () => {
-    it('Camera.schema has 19 fields (17 f32 + clearColor array + autoAspect bool: perspective quartet + projection + ortho quartet + tonemap trio + antialias + bloom quartet + clearColor + autoAspect)', () => {
-      expect(Object.keys(Camera.fields).length).toBe(20);
+  describe('Camera schema (21 fields: 17 f32 + clearColor array + autoAspect bool + target after render-target extension)', () => {
+    it('Camera.schema has 21 fields (17 f32 + clearColor array + autoAspect bool + target: perspective quartet + projection + ortho quartet + tonemap trio + antialias + bloom quartet + clearColor + autoAspect)', () => {
+      expect(Object.keys(Camera.fields).length).toBe(21);
       expect(componentFieldType(Camera, 'fov')).toBe('f32');
       expect(componentFieldType(Camera, 'aspect')).toBe('f32');
       expect(componentFieldType(Camera, 'near')).toBe('f32');
@@ -476,6 +478,7 @@ import { makeMockShaderRegistry } from './helpers/mock-shader-registry';
       // feat-20260617-host-engine-contract-and-video-cutscene / M3: aspect-sync
       // opt-out flag (bool column tier).
       expect(componentFieldType(Camera, 'autoAspect')).toBe('bool');
+      expect(componentFieldType(Camera, 'target')).toBe('shared<RenderTarget>');
     });
   });
 
@@ -574,6 +577,8 @@ import { makeMockShaderRegistry } from './helpers/mock-shader-registry';
     directionalCount: 0,
     point: [],
     spot: [],
+    rect: [],
+    directionalShadowError: undefined,
     lightSpaceMatrix: undefined,
     shadowMapSize: undefined,
     pointShadow: [],
@@ -688,8 +693,6 @@ import { makeMockShaderRegistry } from './helpers/mock-shader-registry';
       unlitPipelineHdr: null,
       shadowFallbackTextureView: { __label: 'shadow-fallback-view' },
       skylightFallback: null,
-      pointLightsBuffer: { __label: 'point-lights-buf' },
-      spotLightsBuffer: { __label: 'spot-lights-buf' },
       pbrPipelineLayout: { __label: 'pbr-pipeline-layout' },
       defaultNormalTextureView: { __label: 'default-normal-view' },
       perPassResources: {
@@ -767,14 +770,13 @@ import { makeMockShaderRegistry } from './helpers/mock-shader-registry';
           temporalFrameInput: undefined,
           compiledFrameGraph: null,
           compiledFrameGraphTopologyKey: null,
+          compiledFrameGraphGeneration: 0,
           retiredCompiledFrameGraphs: new Set(),
           instanceBuffers: new Map(),
           transientInstanceBuffers: [],
           warnedZeroLightStandard: false,
           warnedShadowDisabled: false,
           warnedMultiLightDirectional: false,
-          warnedMultiLightPoint: false,
-          warnedMultiLightSpot: false,
           warnedSkyboxTonemapNone: false,
           warnedMissingBaseColorTextureHandles: new Set<number>(),
           warnedNineSliceScaleEntities: new Set<number>(),
@@ -787,8 +789,7 @@ import { makeMockShaderRegistry } from './helpers/mock-shader-registry';
           installedPipelineHandle: 0,
           activePipeline: urpPipeline,
           installedPipelineConfig: undefined,
-          isHdrpActive: false,
-          hdrpOncePerFrameFired: new Set(),
+          standardOncePerFrameFired: new Set(),
         },
         { unlit: 0 },
         { createBindGroup: 0, keys: [] },
@@ -824,14 +825,13 @@ import { makeMockShaderRegistry } from './helpers/mock-shader-registry';
           temporalFrameInput: undefined,
           compiledFrameGraph: null,
           compiledFrameGraphTopologyKey: null,
+          compiledFrameGraphGeneration: 0,
           retiredCompiledFrameGraphs: new Set(),
           instanceBuffers: new Map(),
           transientInstanceBuffers: [],
           warnedZeroLightStandard: false,
           warnedShadowDisabled: false,
           warnedMultiLightDirectional: false,
-          warnedMultiLightPoint: false,
-          warnedMultiLightSpot: false,
           warnedSkyboxTonemapNone: false,
           warnedMissingBaseColorTextureHandles: new Set<number>(),
           warnedNineSliceScaleEntities: new Set<number>(),
@@ -844,8 +844,7 @@ import { makeMockShaderRegistry } from './helpers/mock-shader-registry';
           installedPipelineHandle: 0,
           activePipeline: urpPipeline,
           installedPipelineConfig: undefined,
-          isHdrpActive: false,
-          hdrpOncePerFrameFired: new Set(),
+          standardOncePerFrameFired: new Set(),
         },
         { unlit: 0 },
         { createBindGroup: 0, keys: [] },
@@ -914,8 +913,9 @@ import { makeMockShaderRegistry } from './helpers/mock-shader-registry';
   // --- from fxaa-pipeline.test.ts ---
 
   describe('feat-20260528-fxaa-post-processing M2 w8: FXAA pipeline construction (success path)', () => {
-    it('D-2: FXAA BGL has exactly 2 entries: @binding(0) texture_2d<f32> + @binding(1) sampler, no UBO', () => {
-      // plan-strategy D-2 specifies 2-entry BGL with no UBO entry.
+    it('D-2: FXAA BGL has exactly 3 entries: texture + sampler + dither policy UBO', () => {
+      // FXAA owns a per-pass output-policy UBO so pipeline asset config can
+      // disable dither without rebuilding the shader or graph topology.
       // The sampler entry uses { type: 'filtering' } (linear sampling).
       const bglEntries = [
         {
@@ -928,15 +928,21 @@ import { makeMockShaderRegistry } from './helpers/mock-shader-registry';
           visibility: 2, // GPU_SHADER_STAGE_FRAGMENT = 0x2
           sampler: { type: 'filtering' },
         },
+        {
+          binding: 2,
+          visibility: 2,
+          buffer: { type: 'uniform' },
+        },
       ];
-      expect(bglEntries).toHaveLength(2);
+      expect(bglEntries).toHaveLength(3);
       expect(bglEntries[0]?.binding).toBe(0);
       expect(bglEntries[0]?.texture).toBeDefined();
       expect(bglEntries[1]?.binding).toBe(1);
       expect(bglEntries[1]?.sampler).toBeDefined();
-      // D-2 explicitly: no UBO entry (no buffer-type binding).
+      expect(bglEntries[2]?.binding).toBe(2);
+      expect(bglEntries[2]?.buffer).toEqual({ type: 'uniform' });
       const hasBuffer = bglEntries.some((e) => 'buffer' in (e as Record<string, unknown>));
-      expect(hasBuffer).toBe(false);
+      expect(hasBuffer).toBe(true);
     });
 
     it('D-3: FXAA pipeline target format = swap-chain storage format (non-srgb, helper Channel 2 truth)', () => {
@@ -1309,8 +1315,6 @@ import { makeMockShaderRegistry } from './helpers/mock-shader-registry';
   function makeFrameState() {
     return {
       warnedMultiLightDirectional: false,
-      warnedMultiLightPoint: false,
-      warnedMultiLightSpot: false,
     };
   }
 
@@ -1379,151 +1383,6 @@ import { makeMockShaderRegistry } from './helpers/mock-shader-registry';
       }
     });
   });
-
-  describe('warnMultiLightPoint (M3 / AC-04 / AC-05 (c))', () => {
-    let warnSpy: ReturnType<typeof vi.spyOn>;
-
-    beforeEach(() => {
-      warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => {});
-    });
-
-    afterEach(() => {
-      warnSpy.mockRestore();
-    });
-
-    it('first hit fires console.warn (N>4)', () => {
-      const fs = makeFrameState();
-      warnMultiLightPoint(fs, 5);
-      expect(warnSpy).toHaveBeenCalledTimes(1);
-      expect(fs.warnedMultiLightPoint).toBe(true);
-      const call = warnSpy.mock.calls[0];
-      expect(call[1]).toMatchObject({
-        code: 'render-system-multi-light',
-        expected: 'at most 4 point',
-        detail: { type: 'point', got: 5 },
-      });
-    });
-
-    it('no-op when pointCount <= 4', () => {
-      const fs = makeFrameState();
-      warnMultiLightPoint(fs, 4);
-      warnMultiLightPoint(fs, 0);
-      expect(warnSpy).toHaveBeenCalledTimes(0);
-      expect(fs.warnedMultiLightPoint).toBe(false);
-    });
-
-    it('warn-once across 6 frames', () => {
-      const fs = makeFrameState();
-      warnMultiLightPoint(fs, 5);
-      expect(warnSpy).toHaveBeenCalledTimes(1);
-      for (let i = 0; i < 5; i++) {
-        warnMultiLightPoint(fs, 5);
-      }
-      expect(warnSpy).toHaveBeenCalledTimes(1);
-    });
-
-    it('production gate suppresses output but flips latch', () => {
-      const fs = makeFrameState();
-      warnMultiLightPoint(fs, 5, { env: { NODE_ENV: 'production' } });
-      expect(warnSpy).toHaveBeenCalledTimes(0);
-      expect(fs.warnedMultiLightPoint).toBe(true);
-    });
-  });
-
-  describe('warnMultiLightSpot (M3 / AC-04 / AC-05 (c))', () => {
-    let warnSpy: ReturnType<typeof vi.spyOn>;
-
-    beforeEach(() => {
-      warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => {});
-    });
-
-    afterEach(() => {
-      warnSpy.mockRestore();
-    });
-
-    it('first hit fires console.warn (N>4)', () => {
-      const fs = makeFrameState();
-      warnMultiLightSpot(fs, 5);
-      expect(warnSpy).toHaveBeenCalledTimes(1);
-      expect(fs.warnedMultiLightSpot).toBe(true);
-      const call = warnSpy.mock.calls[0];
-      expect(call[1]).toMatchObject({
-        code: 'render-system-multi-light',
-        expected: 'at most 4 spot',
-        detail: { type: 'spot', got: 5 },
-      });
-    });
-
-    it('no-op when spotCount <= 4', () => {
-      const fs = makeFrameState();
-      warnMultiLightSpot(fs, 4);
-      warnMultiLightSpot(fs, 0);
-      expect(warnSpy).toHaveBeenCalledTimes(0);
-      expect(fs.warnedMultiLightSpot).toBe(false);
-    });
-
-    it('warn-once across 6 frames', () => {
-      const fs = makeFrameState();
-      warnMultiLightSpot(fs, 5);
-      expect(warnSpy).toHaveBeenCalledTimes(1);
-      for (let i = 0; i < 5; i++) {
-        warnMultiLightSpot(fs, 5);
-      }
-      expect(warnSpy).toHaveBeenCalledTimes(1);
-    });
-
-    it('production gate suppresses output but flips latch', () => {
-      const fs = makeFrameState();
-      warnMultiLightSpot(fs, 5, { env: { NODE_ENV: 'production' } });
-      expect(warnSpy).toHaveBeenCalledTimes(0);
-      expect(fs.warnedMultiLightSpot).toBe(true);
-    });
-  });
-
-  describe('independent latch isolation (M3 / AC-04 / user Step 5.a)', () => {
-    let warnSpy: ReturnType<typeof vi.spyOn>;
-
-    beforeEach(() => {
-      warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => {});
-    });
-
-    afterEach(() => {
-      warnSpy.mockRestore();
-    });
-
-    it('firing directional does not silence point', () => {
-      const fs = makeFrameState();
-      warnMultiLightDirectional(fs, 2);
-      expect(fs.warnedMultiLightDirectional).toBe(true);
-      expect(fs.warnedMultiLightPoint).toBe(false);
-      expect(fs.warnedMultiLightSpot).toBe(false);
-      expect(warnSpy).toHaveBeenCalledTimes(1);
-      warnMultiLightPoint(fs, 5);
-      expect(warnSpy).toHaveBeenCalledTimes(2);
-      expect(fs.warnedMultiLightPoint).toBe(true);
-    });
-
-    it('firing point does not silence spot', () => {
-      const fs = makeFrameState();
-      warnMultiLightPoint(fs, 5);
-      expect(fs.warnedMultiLightPoint).toBe(true);
-      expect(fs.warnedMultiLightSpot).toBe(false);
-      expect(warnSpy).toHaveBeenCalledTimes(1);
-      warnMultiLightSpot(fs, 5);
-      expect(warnSpy).toHaveBeenCalledTimes(2);
-      expect(fs.warnedMultiLightSpot).toBe(true);
-    });
-
-    it('pre-set directional latch does not prevent point/spot first fire', () => {
-      const fs = makeFrameState();
-      fs.warnedMultiLightDirectional = true;
-      warnMultiLightPoint(fs, 5);
-      warnMultiLightSpot(fs, 5);
-      expect(warnSpy).toHaveBeenCalledTimes(2);
-      expect(fs.warnedMultiLightPoint).toBe(true);
-      expect(fs.warnedMultiLightSpot).toBe(true);
-    });
-  });
 }
 
 {
@@ -1694,6 +1553,7 @@ import { makeMockShaderRegistry } from './helpers/mock-shader-registry';
 
   async function importComponents(): Promise<{
     Transform: unknown;
+    GlobalTransform: unknown;
     MeshFilter: unknown;
     MeshRenderer: unknown;
     Camera: unknown;
@@ -1920,10 +1780,10 @@ import { makeMockShaderRegistry } from './helpers/mock-shader-registry';
             return 'mesh-ssbo-capacity';
           case 'mesh-ssbo-ceiling-reached':
             return 'mesh-ssbo-ceiling';
-          case 'hdrp-light-budget-exceeded':
-            return 'hdrp-budget';
-          case 'hdrp-index-list-overflow':
-            return 'hdrp-overflow';
+          case 'standard-light-budget-exceeded':
+            return 'standard-budget';
+          case 'standard-cluster-index-overflow':
+            return 'standard-overflow';
         }
       }
       expect(exhaustive('skin-joint-count-exceeded')).toBe('joint-count');
@@ -2761,8 +2621,10 @@ import { makeMockShaderRegistry } from './helpers/mock-shader-registry';
       const result = buildPbrPipelineLayouts(device as any, STORAGE_CAPS);
       expect(result.bindGroupLayouts).toHaveLength(4);
       // And the captured pipeline layout descriptor matches.
-      expect(device.capturedPipelineLayouts).toHaveLength(1);
-      const layout = device.capturedPipelineLayouts[0];
+      expect(device.capturedPipelineLayouts).toHaveLength(2);
+      const layout = device.capturedPipelineLayouts.find(
+        (candidate) => candidate.label === 'pbr-pl',
+      );
       expect(layout?.bindGroupLayouts).toHaveLength(4);
       expect(layout?.label).toBe('pbr-pl');
     });
@@ -3186,6 +3048,8 @@ import { makeMockShaderRegistry } from './helpers/mock-shader-registry';
     directionalCount: 0,
     point: [],
     spot: [],
+    rect: [],
+    directionalShadowError: undefined,
     lightSpaceMatrix: undefined,
     shadowMapSize: undefined,
     pointShadow: [],
@@ -3368,11 +3232,12 @@ import { makeMockShaderRegistry } from './helpers/mock-shader-registry';
   }
 
   function makePipelineState(
-    internals: { _fakes: Record<string, unknown> },
+    internals: { _fakes: Record<string, unknown>; device?: unknown },
     hdrAlreadyAllocated: boolean,
   ): unknown {
     const f = internals._fakes;
     return {
+      device: internals.device,
       meshes: new Map(),
       format: 'bgra8unorm',
       colorAttachmentFormat: 'bgra8unorm-srgb',
@@ -3461,14 +3326,13 @@ import { makeMockShaderRegistry } from './helpers/mock-shader-registry';
           temporalFrameInput: undefined,
           compiledFrameGraph: null,
           compiledFrameGraphTopologyKey: null,
+          compiledFrameGraphGeneration: 0,
           retiredCompiledFrameGraphs: new Set(),
           instanceBuffers: new Map(),
           transientInstanceBuffers: [],
           warnedZeroLightStandard: false,
           warnedShadowDisabled: false,
           warnedMultiLightDirectional: false,
-          warnedMultiLightPoint: false,
-          warnedMultiLightSpot: false,
           warnedSkyboxTonemapNone: false,
           warnedMissingBaseColorTextureHandles: new Set<number>(),
           warnedNineSliceScaleEntities: new Set<number>(),
@@ -3481,8 +3345,7 @@ import { makeMockShaderRegistry } from './helpers/mock-shader-registry';
           installedPipelineHandle: 0,
           activePipeline: urpPipeline,
           installedPipelineConfig: undefined,
-          isHdrpActive: false,
-          hdrpOncePerFrameFired: new Set(),
+          standardOncePerFrameFired: new Set(),
         },
         { unlit: 0 },
         { createBindGroup: 0, keys: [] },
@@ -3582,13 +3445,12 @@ import { makeMockShaderRegistry } from './helpers/mock-shader-registry';
           temporalFrameInput: undefined,
           compiledFrameGraph: null,
           compiledFrameGraphTopologyKey: null,
+          compiledFrameGraphGeneration: 0,
           retiredCompiledFrameGraphs: new Set(),
           instanceBuffers,
           warnedZeroLightStandard: false,
           warnedShadowDisabled: false,
           warnedMultiLightDirectional: false,
-          warnedMultiLightPoint: false,
-          warnedMultiLightSpot: false,
           warnedSkyboxTonemapNone: false,
           warnedMissingBaseColorTextureHandles: new Set<number>(),
           warnedNineSliceScaleEntities: new Set<number>(),
@@ -3601,8 +3463,7 @@ import { makeMockShaderRegistry } from './helpers/mock-shader-registry';
           installedPipelineHandle: 0,
           activePipeline: urpPipeline,
           installedPipelineConfig: undefined,
-          isHdrpActive: false,
-          hdrpOncePerFrameFired: new Set(),
+          standardOncePerFrameFired: new Set(),
         },
         { unlit: 0 },
         { createBindGroup: 0, keys: [] },
@@ -3657,13 +3518,12 @@ import { makeMockShaderRegistry } from './helpers/mock-shader-registry';
           temporalFrameInput: undefined,
           compiledFrameGraph: null,
           compiledFrameGraphTopologyKey: null,
+          compiledFrameGraphGeneration: 0,
           retiredCompiledFrameGraphs: new Set(),
           instanceBuffers,
           warnedZeroLightStandard: false,
           warnedShadowDisabled: false,
           warnedMultiLightDirectional: false,
-          warnedMultiLightPoint: false,
-          warnedMultiLightSpot: false,
           warnedSkyboxTonemapNone: false,
           warnedMissingBaseColorTextureHandles: new Set<number>(),
           warnedNineSliceScaleEntities: new Set<number>(),
@@ -3676,8 +3536,7 @@ import { makeMockShaderRegistry } from './helpers/mock-shader-registry';
           installedPipelineHandle: 0,
           activePipeline: urpPipeline,
           installedPipelineConfig: undefined,
-          isHdrpActive: false,
-          hdrpOncePerFrameFired: new Set(),
+          standardOncePerFrameFired: new Set(),
         },
         { unlit: 0 },
         { createBindGroup: 0, keys: [] },
@@ -5137,7 +4996,7 @@ import { makeMockShaderRegistry } from './helpers/mock-shader-registry';
   }
 
   function readWorld(world: World, entity: EntityHandle): Float32Array {
-    return world.get(entity, Transform).unwrap().world as Float32Array;
+    return world.get(entity, GlobalTransform).unwrap().world as Float32Array;
   }
 
   function expectMatClose(actual: Float32Array, expected: Float32Array): void {
@@ -5146,7 +5005,7 @@ import { makeMockShaderRegistry } from './helpers/mock-shader-registry';
     }
   }
 
-  describe('w7 - propagate writes Transform.world mat4 (AC-05 / AC-06)', () => {
+  describe('w7 - propagate writes GlobalTransform.world mat4 (AC-05 / AC-06)', () => {
     it('root: world == compose(local.TRS) element-wise epsilon<=1e-5 (AC-06)', () => {
       const world = new World();
       const local = trs({ pos: [3, 4, 5], scale: [2, 2, 2] });
@@ -5539,17 +5398,17 @@ import { makeMockShaderRegistry } from './helpers/mock-shader-registry';
     });
 
     // feat-20260601 w12/w13: skin joint world matrices now flow from the resolved
-    // `Transform.world` column array view (a raw 16-float `Float32Array`, written
+    // `GlobalTransform.world` column array view (a raw 16-float `Float32Array`, written
     // by propagateTransforms) straight into the allocator's `readonly Mat4[]`
     // jointWorlds parameter -- zero recompose from decomposed TRS. The allocator
-    // contract is unchanged; this guards that a bare Transform.world-shaped
+    // contract is unchanged; this guards that a bare GlobalTransform.world-shaped
     // Float32Array premultiplies against the IBM exactly like a `mat4.create()`.
-    it('accepts a Transform.world-shaped Float32Array as a joint world matrix', () => {
+    it('accepts a GlobalTransform.world-shaped Float32Array as a joint world matrix', () => {
       const { device, written } = mockDevice();
       const alloc = createSkinPaletteAllocator(device, MAX_BINDING);
-      // A Transform.world view is a plain 16-float column-major Float32Array.
+      // A GlobalTransform.world view is a plain 16-float column-major Float32Array.
       // Here: translation (0, 3, 0) -- the shape a `world._getArrayView(joint,
-      // Transform, 'world')` read returns after propagate.
+      // GlobalTransform, 'world')` read returns after propagate.
       const jointWorldView = new Float32Array([1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 3, 0, 1]);
       const ibm = new Float32Array([1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1]);
       const slice = alloc.allocateSlice(1);
@@ -7370,6 +7229,7 @@ import { makeMockShaderRegistry } from './helpers/mock-shader-registry';
 
   async function importComponents(): Promise<{
     Transform: unknown;
+    GlobalTransform: unknown;
     MeshFilter: unknown;
     MeshRenderer: unknown;
     Camera: unknown;
@@ -7687,6 +7547,7 @@ import { makeMockShaderRegistry } from './helpers/mock-shader-registry';
 
   async function importComponents(): Promise<{
     Transform: unknown;
+    GlobalTransform: unknown;
     MeshFilter: unknown;
     MeshRenderer: unknown;
     Camera: unknown;
@@ -8336,10 +8197,10 @@ type ExtractFramesWithPipeline = (
 }
 
 // ── feat-20260612-skin-palette-per-frame-upload M3 / m3-1: record-stage ──
-// dynOffset[1] truth-value + skin BG cache miss=1 + hit=N-1 stats counter.
+// dynOffset[1]/[2] truth-value + skin BG cache miss=1 + hit=N-1 stats counter.
 //
 // Why this block exists:
-//   M3 lifts the record-stage `group2DynamicOffsets` second slot from a
+//   M3 lifts the record-stage `group2DynamicOffsets` palette slots from a
 //   hard-coded `0` (PR #353 stub) to the per-entity `entry.source.skin
 //   .byteOffset` cursor that M2 m2-6 wired into the extract output. The
 //   acceptanceCheck calls for the literal text `group2DynamicOffsets[1]
@@ -8351,8 +8212,8 @@ type ExtractFramesWithPipeline = (
 // What the assertions cover:
 //   (a) The test-local offset oracle mirrors the production main-pass
 //       geometry contract. With skinByteOffset !== undefined the returned
-//       tuple's [1] slot equals the supplied byteOffset (the contract:
-//       `group2DynamicOffsets[1] === byteOffset`); with skinByteOffset ===
+//       tuple's [1] and [2] slots equal the supplied byteOffset (the
+//       temporal contract); with skinByteOffset ===
 //       undefined it returns a length-1 tuple (non-skin paths preserved).
 //   (b) N=3 sequential lookups
 //       against the same `(meshStorageBuffer, skinPaletteAllocator
@@ -8379,7 +8240,9 @@ type ExtractFramesWithPipeline = (
         skinByteOffset: number | undefined,
       ): readonly number[] => {
         const meshOffset = meshSlotIdx * MESH_PER_ENTITY_STRIDE;
-        return skinByteOffset === undefined ? [meshOffset] : [meshOffset, skinByteOffset];
+        return skinByteOffset === undefined
+          ? [meshOffset]
+          : [meshOffset, skinByteOffset, skinByteOffset];
       };
 
       // Skin path: second slot must equal the per-entity byteOffset cursor
@@ -8388,12 +8251,12 @@ type ExtractFramesWithPipeline = (
       // (first allocateSlice), cursor=256 (second 1-joint slice), cursor
       // =16320 (the worst-case 255-joint slice end).
       const skinAt0 = computeSkinGroup2DynOffsets(0, 0);
-      expect(skinAt0).toHaveLength(2);
+      expect(skinAt0).toHaveLength(3);
       // group2DynamicOffsets[1] === byteOffset (literal assertion text per acceptanceCheck)
       expect(skinAt0[1]).toBe(0);
 
       const skinAt256 = computeSkinGroup2DynOffsets(1, 256);
-      expect(skinAt256).toHaveLength(2);
+      expect(skinAt256).toHaveLength(3);
       // group2DynamicOffsets[1] === byteOffset
       expect(skinAt256[1]).toBe(256);
       // mesh slot continues to follow the 256-byte stride: meshSlotIdx * 256.
@@ -8401,7 +8264,7 @@ type ExtractFramesWithPipeline = (
 
       const byteOffsetWorst = 254 * 256;
       const skinAtEnd = computeSkinGroup2DynOffsets(2, byteOffsetWorst);
-      expect(skinAtEnd).toHaveLength(2);
+      expect(skinAtEnd).toHaveLength(3);
       // group2DynamicOffsets[1] === byteOffset
       expect(skinAtEnd[1]).toBe(byteOffsetWorst);
       expect(skinAtEnd[0]).toBe(2 * 256);
@@ -8764,6 +8627,7 @@ type ExtractFramesWithPipeline = (
 
   interface IntegrationComponents {
     Transform: unknown;
+    GlobalTransform: unknown;
     MeshFilter: unknown;
     MeshRenderer: unknown;
     Camera: unknown;