@forgeax/engine-runtime 0.1.28 → 0.1.29

package/src/__tests__/asset-registry-scene.cases.unit.test.ts

@@ -407,10 +407,7 @@ type __MergedKeep =
   function makeSceneAsset(): SceneAsset {
     return {
       kind: 'scene',
-      entities: [
-        { localId: 0 as LocalEntityId, components: {} },
-        { localId: 1 as LocalEntityId, components: {} },
-      ],
+      entities: { 'entity-0': { components: {} }, 'entity-1': { components: {} } },
     };
   }
 
@@ -424,7 +421,7 @@ type __MergedKeep =
       expect(looked).toBeDefined();
       if (looked === undefined) return;
       expect(looked.kind).toBe('scene');
-      expect(looked.entities.length).toBe(2);
+      expect(Object.keys(looked.entities)).toHaveLength(2);
     });
 
     it('inspect() reports kind `scene` for a catalogued scene', () => {
@@ -478,24 +475,18 @@ type __MergedKeep =
       };
       const fn = internal.parseAssetPayload.bind(reg);
       const payload = {
-        entities: [
-          { localId: 0, components: { Transform: { pos: [1, 2, 3] } } },
-          { localId: 1, components: { ChildOf: { parent: 0 } } },
-        ],
+        entities: {
+          'entity-0': { components: { Transform: { pos: [1, 2, 3] } } },
+          'entity-1': { components: { ChildOf: { parent: 'entity-0' } } },
+        },
       };
       const asset = fn('scene', payload) as SceneAsset | undefined;
       expect(asset).toBeDefined();
       if (!asset) return;
       expect(asset.kind).toBe('scene');
-      expect(asset.entities.length).toBe(2);
-      // LocalEntityId extends number, so widening is implicit at the
-      // structural layer; explicit annotation keeps the assertion intent
-      // readable.
-      const firstLocalId: number = asset.entities[0]?.localId ?? -1;
-      expect(firstLocalId).toBe(0);
-      expect(
-        (asset.entities[1]?.components as Record<string, Record<string, unknown>>).ChildOf?.parent,
-      ).toBe(0);
+      expect(Object.keys(asset.entities)).toHaveLength(2);
+      expect(asset.entities['entity-0']).toBeDefined();
+      expect(asset.entities['entity-1']?.components.ChildOf?.parent).toBe('entity-0');
     });
   });
 }

package/src/__tests__/asset-registry.recursive.spec.ts

@@ -50,7 +50,7 @@ function parseGuid(s: string): AssetGuid {
   return r.value;
 }
 
-function localId(n: number): LocalEntityId {
+function _localId(n: number): LocalEntityId {
   return n as LocalEntityId;
 }
 
@@ -90,16 +90,15 @@ function makeMaterialAsset(): MaterialAsset {
 function makeTestSceneAsset(subRefs: { meshGuid: string; materialGuids: string[] }): SceneAsset {
   return {
     kind: 'scene',
-    entities: [
-      {
-        localId: localId(0),
+    entities: {
+      'entity-0': {
         components: {
           Transform: { pos: [0, 0, 0] },
           MeshFilter: { assetHandle: subRefs.meshGuid },
           MeshRenderer: { materials: subRefs.materialGuids },
         },
       },
-    ],
+    },
   };
 }
 
@@ -256,16 +255,15 @@ describe('AC-07 — transitive failure attribution', () => {
           guid: SCENE_GUID,
           kind: 'scene',
           payload: {
-            entities: [
-              {
-                localId: 0,
+            entities: {
+              'entity-0': {
                 components: {
                   Transform: { pos: [0, 0, 0] },
                   MeshFilter: { assetHandle: 0 },
                   MeshRenderer: { materials: [1] },
                 },
               },
-            ],
+            },
           },
           refs: [MESH_GUID, MISSING_SUB_GUID],
         },
@@ -334,7 +332,7 @@ describe('AC-07 — transitive failure attribution', () => {
         // (4-segment chain: scene → entity → component.field → sub-asset).
         expect(err.hint).toContain(MISSING_SUB_GUID);
         expect(err.hint).toContain(SCENE_GUID);
-        expect(err.hint).toContain('entity 0');
+        expect(err.hint).toContain('entity entity-0');
         expect(err.hint).toContain('MeshRenderer.materials');
         // feat-20260622 verify r1: the breadcrumb provenance is ALSO exposed in
         // structured form on `.detail` so an AI user locates the broken edge by
@@ -345,7 +343,7 @@ describe('AC-07 — transitive failure attribution', () => {
           | {
               referencedByGuid?: string;
               subAssetGuid?: string;
-              sceneEntityId?: number;
+              sceneEntityKey?: string;
               sourceField?: { componentName?: string; fieldName?: string; arrayIndex?: number };
             }
           | undefined;
@@ -354,7 +352,7 @@ describe('AC-07 — transitive failure attribution', () => {
         // pass vacuously if the provenance silently regressed to hint-only.
         expect(detail?.referencedByGuid?.toLowerCase()).toBe(SCENE_GUID.toLowerCase());
         expect(detail?.subAssetGuid?.toLowerCase()).toBe(MISSING_SUB_GUID.toLowerCase());
-        expect(detail?.sceneEntityId).toBe(0);
+        expect(detail?.sceneEntityKey).toBe('entity-0');
         expect(detail?.sourceField?.componentName).toBe('MeshRenderer');
         expect(detail?.sourceField?.fieldName).toBe('materials');
       }
@@ -656,15 +654,14 @@ describe('AC-08 — in-flight dedup + cycle', () => {
           guid: CYCLE_A_GUID,
           kind: 'scene',
           payload: {
-            entities: [
-              {
-                localId: 0,
+            entities: {
+              'entity-0': {
                 components: {
                   Transform: { pos: [0, 0, 0] },
                   SceneCycler: { refScene: 0 },
                 },
               },
-            ],
+            },
           },
           refs: [CYCLE_B_GUID],
         },
@@ -679,15 +676,14 @@ describe('AC-08 — in-flight dedup + cycle', () => {
           guid: CYCLE_B_GUID,
           kind: 'scene',
           payload: {
-            entities: [
-              {
-                localId: 0,
+            entities: {
+              'entity-0': {
                 components: {
                   Transform: { pos: [0, 0, 0] },
                   SceneCycler: { refScene: 0 },
                 },
               },
-            ],
+            },
           },
           refs: [CYCLE_A_GUID],
         },
@@ -926,16 +922,15 @@ describe('AC-03 — gltf-shaped scene composite (via SceneAsset, D-9)', () => {
           guid: SCENE_GLTF_GUID,
           kind: 'scene',
           payload: {
-            entities: [
-              {
-                localId: 0,
+            entities: {
+              'entity-0': {
                 components: {
                   Transform: { pos: [0, 0, 0] },
                   MeshFilter: { assetHandle: 0 },
                   MeshRenderer: { materials: [1] },
                 },
               },
-            ],
+            },
           },
           // feat-20260622 M4 / w14: refs[] is the recursion SSOT (D-5).
           // MESH_GUID -> refs[0], MATERIAL_A_GUID -> refs[1].
@@ -1294,15 +1289,14 @@ describe('feat-20260612 M2 fixup — SceneAsset.skinGuids cross-edge', () => {
           guid: SKIN_FIXUP_SCENE_GUID,
           kind: 'scene',
           payload: {
-            entities: [
-              {
-                localId: 0,
+            entities: {
+              'entity-0': {
                 components: {
                   Transform: { pos: [0, 0, 0] },
                   Skin: { skeleton: 0 },
                 },
               },
-            ],
+            },
             // refs[]-index form (browser JSON-roundtrip shape)
             skinGuids: [1],
           },
@@ -1377,7 +1371,7 @@ describe('feat-20260612 M2 fixup — SceneAsset.skinGuids cross-edge', () => {
     // Build a SceneAsset POD with inline skinGuids (no refs[] indices).
     const scene: SceneAsset = {
       kind: 'scene',
-      entities: [{ localId: localId(0), components: { Transform: { pos: [0, 0, 0] } } }],
+      entities: { 'entity-0': { components: { Transform: { pos: [0, 0, 0] } } } },
       skinGuids: [SKIN_FIXUP_SKIN_GUID],
     };
     reg.catalog(parseGuid(SKIN_FIXUP_SCENE_GUID), scene);

package/src/__tests__/camera-ortho.cases.unit.test.ts

@@ -365,9 +365,9 @@ type __MergedKeep =
     ];
   }
 
-  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(21);
+  describe('Camera schema (29 fields: projection, exposure, color grading, post-process, target, clearColor, and aspect-sync)', () => {
+    it('Camera.schema has 29 fields including auto exposure and color grading state', () => {
+      expect(Object.keys(Camera.fields).length).toBe(29);
       expect(componentFieldType(Camera, 'fov')).toBe('f32');
       expect(componentFieldType(Camera, 'aspect')).toBe('f32');
       expect(componentFieldType(Camera, 'near')).toBe('f32');
@@ -380,7 +380,16 @@ type __MergedKeep =
       // feat-20260519-tonemap-reinhard-mvp / M1 / T-M1.2 (AC-01 + D-1).
       expect(componentFieldType(Camera, 'tonemap')).toBe('f32');
       expect(componentFieldType(Camera, 'exposure')).toBe('f32');
+      // feat-20260827-auto-exposure-hdr-color-grading: exposure control state.
+      expect(componentFieldType(Camera, 'exposureMode')).toBe('f32');
+      expect(componentFieldType(Camera, 'compensationEv')).toBe('f32');
+      expect(componentFieldType(Camera, 'rangeEv')).toBe('array<f32, 2>');
+      expect(componentFieldType(Camera, 'rates')).toBe('array<f32, 2>');
       expect(componentFieldType(Camera, 'whitePoint')).toBe('f32');
+      expect(componentFieldType(Camera, 'temperature')).toBe('f32');
+      expect(componentFieldType(Camera, 'tint')).toBe('f32');
+      expect(componentFieldType(Camera, 'colorLut')).toBe('shared<TextureAsset>');
+      expect(componentFieldType(Camera, 'colorLutStrength')).toBe('f32');
       expect(componentFieldType(Camera, 'antialias')).toBe('f32');
       expect(componentFieldType(Camera, 'historyVersion')).toBe('u32');
       // feat-20260531-bloom-first-declarative-render-graph-pass / w2.