@forgeax/engine-runtime 0.1.21 → 0.1.23

package/src/__tests__/resolveName-unified-entry.test.ts

@@ -2,7 +2,7 @@
 //
 // resolveName is the one runtime name-truth function and it delegates to the
 // stateless deriveAssetName pure function (D-6). Every other name consumer reads
-// resolveName or that same deriveAssetName -- none re-implements the XOR rule.
+// resolveName or that same deriveAssetName -- none re-implements the display-name rule.
 //
 // This is a grep/fixture test, not a pure runtime assertion: it reads the source
 // trees and asserts structural unification.
@@ -27,11 +27,11 @@ const buildCatalogSrc = readFileSync(
 );
 
 describe('unified name resolution (AC-04)', () => {
-  it('deriveAssetName is the single XOR rule definition', () => {
+  it('deriveAssetName is the single display-name rule definition', () => {
     expect(deriveSrc).toContain('export function deriveAssetName');
   });
 
-  it('resolveName delegates to deriveAssetName (no inline XOR re-implementation)', () => {
+  it('resolveName delegates to deriveAssetName (no inline re-implementation)', () => {
     expect(registrySrc).toContain("import { deriveAssetName } from '@forgeax/engine-pack/name'");
     // resolveName returns the result of deriveAssetName, not a hand-rolled rule.
     const body = registrySrc.slice(
@@ -55,11 +55,11 @@ describe('unified name resolution (AC-04)', () => {
   });
 
   // M4 expansion (w22 landed): catalog-builder routes through deriveAssetName
-  it('catalog-builder imports and calls deriveAssetName (no inline XOR)', () => {
+  it('catalog-builder imports and calls deriveAssetName (no inline display-name rule)', () => {
     expect(buildCatalogSrc).toContain("import { deriveAssetName } from './deriveAssetName.js'");
     expect(buildCatalogSrc).toContain('deriveAssetName(');
-    // No inline re-implementation of the XOR rule (no hand-rolled basename)
-    // The single deriveAssetName pure function handles all branches.
+    // No inline re-implementation (no hand-rolled basename); the single
+    // deriveAssetName pure function handles the display-name rule.
     expect(buildCatalogSrc.match(/deriveAssetName\(/g)?.length ?? 0).toBeGreaterThanOrEqual(2);
   });
 });

package/src/__tests__/resolveName.test.ts

@@ -4,8 +4,8 @@
 // state directly through registerPackage (Risk-2: no pack-index fetch needed).
 //
 // Coverage:
-//   AC-01 — single-asset package: resolveName === basename(path); the stored
-//           Asset POD carries no `name` property (name is never on the payload).
+//   AC-01 — single-asset package: an explicit stored name wins; basename(path)
+//           remains the fallback. The Asset POD carries no `name` property.
 //   AC-02 — multi-asset package: resolveName returns each entry's stored name.
 
 import { AssetRegistry } from '@forgeax/engine-assets-runtime';
@@ -42,6 +42,18 @@ describe('resolveName single-asset package (AC-01)', () => {
     expect(stored).toBeDefined();
     expect(Object.hasOwn(stored as object, 'name')).toBe(false);
   });
+
+  it('preserves an explicit authored name for a single-member pack', () => {
+    const reg = makeRegistry();
+    reg.catalog(parseGuid(SINGLE_GUID), sampler);
+    reg._registerPackage(
+      'assets/Materials.pack.json',
+      [SINGLE_GUID],
+      new Map([[SINGLE_GUID, 'NewMaterial']]),
+    );
+
+    expect(reg.resolveName(SINGLE_GUID)).toBe('NewMaterial');
+  });
 });
 
 describe('resolveName multi-asset package (AC-02)', () => {

package/src/__tests__/shadow-csm-cascade-loadop.test.ts

@@ -215,6 +215,7 @@ async function importEcs(): Promise<{ World: new () => unknown }> {
 
 async function importComponents(): Promise<{
   Transform: unknown;
+  GlobalTransform: unknown;
   MeshFilter: unknown;
   MeshRenderer: unknown;
   Camera: unknown;

package/src/__tests__/shadow-csm-tile-consistency.test.ts

@@ -225,6 +225,7 @@ async function importEcs(): Promise<{ World: new () => unknown }> {
 
 async function importComponents(): Promise<{
   Transform: unknown;
+  GlobalTransform: unknown;
   MeshFilter: unknown;
   MeshRenderer: unknown;
   Camera: unknown;

package/src/__tests__/shadow-csm-ubo.test.ts

@@ -269,6 +269,8 @@ describe('directional filter carrier tail-pad wiring (M1-T05)', () => {
 
   it('keeps one View binding and removes the retired spot matrix binding', () => {
     expect(wgslSrc.match(/@group\(0\) @binding\(0\) var<uniform> view/g)).toHaveLength(1);
-    expect(wgslSrc).not.toMatch(/@group\(0\)\s*@binding\(9\)/);
+    expect(wgslSrc).not.toMatch(
+      /@group\(0\)\s*@binding\(9\)\s*var<uniform>\s+spotLightViewProj\s*:/,
+    );
   });
 });

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

@@ -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;
@@ -355,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

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

@@ -218,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__/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';
 
@@ -133,7 +134,7 @@ function fakeHdrpBuffers(): HdrpBuffers {
   return {
     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'),

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,
@@ -575,6 +577,7 @@ import { makeMockShaderRegistry } from './helpers/mock-shader-registry';
     directionalCount: 0,
     point: [],
     spot: [],
+    rect: [],
     directionalShadowError: undefined,
     lightSpaceMatrix: undefined,
     shadowMapSize: undefined,
@@ -690,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: {
@@ -776,8 +777,6 @@ import { makeMockShaderRegistry } from './helpers/mock-shader-registry';
           warnedZeroLightStandard: false,
           warnedShadowDisabled: false,
           warnedMultiLightDirectional: false,
-          warnedMultiLightPoint: false,
-          warnedMultiLightSpot: false,
           warnedSkyboxTonemapNone: false,
           warnedMissingBaseColorTextureHandles: new Set<number>(),
           warnedNineSliceScaleEntities: new Set<number>(),
@@ -833,8 +832,6 @@ import { makeMockShaderRegistry } from './helpers/mock-shader-registry';
           warnedZeroLightStandard: false,
           warnedShadowDisabled: false,
           warnedMultiLightDirectional: false,
-          warnedMultiLightPoint: false,
-          warnedMultiLightSpot: false,
           warnedSkyboxTonemapNone: false,
           warnedMissingBaseColorTextureHandles: new Set<number>(),
           warnedNineSliceScaleEntities: new Set<number>(),
@@ -1318,8 +1315,6 @@ import { makeMockShaderRegistry } from './helpers/mock-shader-registry';
   function makeFrameState() {
     return {
       warnedMultiLightDirectional: false,
-      warnedMultiLightPoint: false,
-      warnedMultiLightSpot: false,
     };
   }
 
@@ -1388,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);
-    });
-  });
 }
 
 {
@@ -1703,6 +1553,7 @@ import { makeMockShaderRegistry } from './helpers/mock-shader-registry';
 
   async function importComponents(): Promise<{
     Transform: unknown;
+    GlobalTransform: unknown;
     MeshFilter: unknown;
     MeshRenderer: unknown;
     Camera: unknown;
@@ -2770,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');
     });
@@ -3195,6 +3048,7 @@ import { makeMockShaderRegistry } from './helpers/mock-shader-registry';
     directionalCount: 0,
     point: [],
     spot: [],
+    rect: [],
     directionalShadowError: undefined,
     lightSpaceMatrix: undefined,
     shadowMapSize: undefined,
@@ -3479,8 +3333,6 @@ import { makeMockShaderRegistry } from './helpers/mock-shader-registry';
           warnedZeroLightStandard: false,
           warnedShadowDisabled: false,
           warnedMultiLightDirectional: false,
-          warnedMultiLightPoint: false,
-          warnedMultiLightSpot: false,
           warnedSkyboxTonemapNone: false,
           warnedMissingBaseColorTextureHandles: new Set<number>(),
           warnedNineSliceScaleEntities: new Set<number>(),
@@ -3599,8 +3451,6 @@ import { makeMockShaderRegistry } from './helpers/mock-shader-registry';
           warnedZeroLightStandard: false,
           warnedShadowDisabled: false,
           warnedMultiLightDirectional: false,
-          warnedMultiLightPoint: false,
-          warnedMultiLightSpot: false,
           warnedSkyboxTonemapNone: false,
           warnedMissingBaseColorTextureHandles: new Set<number>(),
           warnedNineSliceScaleEntities: new Set<number>(),
@@ -3674,8 +3524,6 @@ import { makeMockShaderRegistry } from './helpers/mock-shader-registry';
           warnedZeroLightStandard: false,
           warnedShadowDisabled: false,
           warnedMultiLightDirectional: false,
-          warnedMultiLightPoint: false,
-          warnedMultiLightSpot: false,
           warnedSkyboxTonemapNone: false,
           warnedMissingBaseColorTextureHandles: new Set<number>(),
           warnedNineSliceScaleEntities: new Set<number>(),
@@ -5148,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 {
@@ -5157,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] });
@@ -5550,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);
@@ -7381,6 +7229,7 @@ import { makeMockShaderRegistry } from './helpers/mock-shader-registry';
 
   async function importComponents(): Promise<{
     Transform: unknown;
+    GlobalTransform: unknown;
     MeshFilter: unknown;
     MeshRenderer: unknown;
     Camera: unknown;
@@ -7698,6 +7547,7 @@ import { makeMockShaderRegistry } from './helpers/mock-shader-registry';
 
   async function importComponents(): Promise<{
     Transform: unknown;
+    GlobalTransform: unknown;
     MeshFilter: unknown;
     MeshRenderer: unknown;
     Camera: unknown;
@@ -8777,6 +8627,7 @@ type ExtractFramesWithPipeline = (
 
   interface IntegrationComponents {
     Transform: unknown;
+    GlobalTransform: unknown;
     MeshFilter: unknown;
     MeshRenderer: unknown;
     Camera: unknown;