@forgeax/engine-runtime 0.1.28 → 0.1.29

package/dist/scene-utils/mount-override-fold.d.ts

@@ -1,9 +1,11 @@
 import { type EntityHandle, type World } from '@forgeax/engine-ecs';
-import type { Handle, LocalEntityId, MountOverride } from '@forgeax/engine-types';
+import type { MountOverride } from '@forgeax/engine-scene';
+import type { Handle, LocalEntityId } from '@forgeax/engine-types';
 /** Minimal structural view of a SceneInstanceState the fold reads (D-4 boundary:
  * `world.getSceneInstanceState(root).value` is structurally assignable). */
 export interface FoldSceneInstanceState {
     readonly source: Handle<'SceneAsset', 'shared'>;
+    readonly keyByLocalId: Map<number, string>;
     readonly entityToLocalId: Map<EntityHandle, LocalEntityId>;
 }
 /**

package/dist/scene-utils/mount-override-fold.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mount-override-fold.d.ts","sourceRoot":"","sources":["../../src/scene-utils/mount-override-fold.ts"],"names":[],"mappings":"AA2CA,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,KAAK,EACX,MAAM,qBAAqB,CAAC;AAG7B,OAAO,KAAK,EACV,MAAM,EACN,aAAa,EACb,aAAa,EAGd,MAAM,uBAAuB,CAAC;AAE/B;4EAC4E;AAC5E,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IAChD,QAAQ,CAAC,eAAe,EAAE,GAAG,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;CAC5D;AA4ED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,sBAAsB,GAAG,aAAa,EAAE,CAmE/F"}
+{"version":3,"file":"mount-override-fold.d.ts","sourceRoot":"","sources":["../../src/scene-utils/mount-override-fold.ts"],"names":[],"mappings":"AA2CA,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,KAAK,EACX,MAAM,qBAAqB,CAAC;AAG7B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAc,MAAM,uBAAuB,CAAC;AAE/E;4EAC4E;AAC5E,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IAChD,QAAQ,CAAC,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,QAAQ,CAAC,eAAe,EAAE,GAAG,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;CAC5D;AA4ED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,sBAAsB,GAAG,aAAa,EAAE,CA8D/F"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forgeax/engine-runtime",
-  "version": "0.1.28",
+  "version": "0.1.29",
   "private": false,
   "type": "module",
   "license": "Apache-2.0",
@@ -26,39 +26,44 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@forgeax/engine-animation": "0.1.28",
-    "@forgeax/engine-assets-runtime": "0.1.28",
-    "@forgeax/engine-audio-webaudio": "0.1.28",
-    "@forgeax/engine-codec": "0.1.28",
-    "@forgeax/engine-debug-draw": "0.1.28",
-    "@forgeax/engine-ecs": "0.1.28",
-    "@forgeax/engine-font": "0.1.28",
-    "@forgeax/engine-geometry": "0.1.28",
-    "@forgeax/engine-graphics-extras": "0.1.28",
-    "@forgeax/engine-image": "0.1.28",
-    "@forgeax/engine-input": "0.1.28",
-    "@forgeax/engine-math": "0.1.28",
-    "@forgeax/engine-pack": "0.1.28",
-    "@forgeax/engine-profiler": "0.1.28",
-    "@forgeax/engine-render": "0.1.28",
-    "@forgeax/engine-render-graph": "0.1.28",
-    "@forgeax/engine-rhi": "0.1.28",
-    "@forgeax/engine-rhi-null": "0.1.28",
-    "@forgeax/engine-rhi-webgpu": "0.1.28",
-    "@forgeax/engine-rhi-wgpu": "0.1.28",
-    "@forgeax/engine-scene": "0.1.28",
-    "@forgeax/engine-shader": "0.1.28",
-    "@forgeax/engine-skinning": "0.1.28",
-    "@forgeax/engine-types": "0.1.28",
-    "@forgeax/engine-vfx": "0.1.28"
+    "@forgeax/engine-animation": "0.1.29",
+    "@forgeax/engine-assets-runtime": "0.1.29",
+    "@forgeax/engine-audio-webaudio": "0.1.29",
+    "@forgeax/engine-codec": "0.1.29",
+    "@forgeax/engine-debug-draw": "0.1.29",
+    "@forgeax/engine-ecs": "0.1.29",
+    "@forgeax/engine-font": "0.1.29",
+    "@forgeax/engine-geometry": "0.1.29",
+    "@forgeax/engine-graphics-extras": "0.1.29",
+    "@forgeax/engine-image": "0.1.29",
+    "@forgeax/engine-input": "0.1.29",
+    "@forgeax/engine-math": "0.1.29",
+    "@forgeax/engine-pack": "0.1.29",
+    "@forgeax/engine-profiler": "0.1.29",
+    "@forgeax/engine-render": "0.1.29",
+    "@forgeax/engine-render-graph": "0.1.29",
+    "@forgeax/engine-rhi": "0.1.29",
+    "@forgeax/engine-rhi-null": "0.1.29",
+    "@forgeax/engine-rhi-webgpu": "0.1.29",
+    "@forgeax/engine-rhi-wgpu": "0.1.29",
+    "@forgeax/engine-scene": "0.1.29",
+    "@forgeax/engine-shader": "0.1.29",
+    "@forgeax/engine-skinning": "0.1.29",
+    "@forgeax/engine-types": "0.1.29",
+    "@forgeax/engine-vfx": "0.1.29"
   },
   "devDependencies": {
-    "@forgeax/engine-import": "0.1.28",
-    "@forgeax/engine-naga": "0.1.28",
-    "@forgeax/engine-physics": "0.1.28",
-    "@forgeax/engine-physics-rapier3d": "0.1.28",
-    "@forgeax/engine-state": "0.1.28",
-    "@forgeax/engine-vite-plugin-shader": "0.1.28",
+    "@forgeax/engine-import": "0.1.29",
+    "@forgeax/engine-naga": "0.1.29",
+    "@forgeax/engine-physics": "0.1.29",
+    "@forgeax/engine-physics-rapier3d": "0.1.29",
+    "@forgeax/engine-rhi-debug": "0.1.29",
+    "@forgeax/engine-shader-compiler": "0.1.29",
+    "@forgeax/engine-state": "0.1.29",
+    "@forgeax/engine-vfx-compiler": "0.1.29",
+    "@forgeax/engine-vfx-render": "0.1.29",
+    "@forgeax/engine-vite-plugin-pack": "0.1.29",
+    "@forgeax/engine-vite-plugin-shader": "0.1.29",
     "@types/node": "^20.14.0"
   },
   "forgeax": {

package/src/__tests__/animation-graph-collect-roundtrip.test.ts

@@ -74,8 +74,10 @@ function registerGraph(
   return { handle, guid: AssetGuid.format(parsed.value) };
 }
 
-function apOf(scene: { entities: readonly unknown[] }): Record<string, unknown> | undefined {
-  for (const e of scene.entities) {
+function apOf(scene: {
+  entities: Readonly<Record<string, unknown>>;
+}): Record<string, unknown> | undefined {
+  for (const e of Object.values(scene.entities)) {
     const comps = (e as { components: Record<string, Record<string, unknown>> }).components;
     if (comps.AnimationPlayer !== undefined) return comps.AnimationPlayer;
   }

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

@@ -75,6 +75,7 @@ import {
 import { audioLoader } from '@forgeax/engine-audio-webaudio';
 import { defineComponent, World } from '@forgeax/engine-ecs';
 import {
+  buildMeshAttributeMapForUvSets,
   createBoxGeometry,
   createPlaneGeometry,
   meshFromInterleaved,
@@ -462,7 +463,7 @@ type __MergedKeep =
         kind: 'mesh',
         vertices,
         indices: new Uint16Array([0, 1, 2, 2, 3, 0]),
-        attributes: { position: positions },
+        attributes: { ...buildMeshAttributeMapForUvSets(1), position: positions },
         aabb: new Float32Array(6),
         materialSlots: [{ slotName: 'Default' }],
         submeshes: [
@@ -502,7 +503,7 @@ type __MergedKeep =
         kind: 'mesh',
         vertices,
         indices: new Uint16Array([0, 1, 2]),
-        attributes: { position: positionBuf },
+        attributes: { ...buildMeshAttributeMapForUvSets(1), position: positionBuf },
         aabb: new Float32Array(6),
         materialSlots: [{ slotName: 'Default' }],
         submeshes: [
@@ -600,7 +601,7 @@ type __MergedKeep =
         kind: 'mesh',
         vertices,
         indices: new Uint16Array([0]),
-        attributes: { position: positions },
+        attributes: { ...buildMeshAttributeMapForUvSets(1), position: positions },
         aabb: new Float32Array(6),
         materialSlots: [{ slotName: 'Default' }],
         submeshes: [
@@ -638,7 +639,7 @@ type __MergedKeep =
         kind: 'mesh',
         vertices,
         indices: new Uint16Array([0, 1]),
-        attributes: { position: positions },
+        attributes: { ...buildMeshAttributeMapForUvSets(1), position: positions },
         aabb: new Float32Array(6),
         materialSlots: [{ slotName: 'Default' }],
         submeshes: [

package/src/__tests__/asset-registry-guid-reverse.test.ts

@@ -80,7 +80,7 @@ function firstLiveMaterialHandle(world: World, root: Handle<string, 'shared'>):
 function makeScene(entities?: SceneAsset['entities']): SceneAsset {
   return {
     kind: 'scene',
-    entities: entities ?? [{ localId: 0 as never, components: { Transform: {} } }],
+    entities: entities ?? { 'entity-0': { components: { Transform: {} } } },
   };
 }
 
@@ -167,15 +167,14 @@ describe('m1-t2 — uncatalogued scene MISS path', () => {
     const meshHandle = world.allocSharedRef('MeshAsset', mesh);
     const asset: SceneAsset = {
       kind: 'scene',
-      entities: [
-        {
-          localId: 0 as never,
+      entities: {
+        'entity-0': {
           components: {
             MeshFilter: { assetHandle: meshHandle as never },
             Transform: {},
           },
         },
-      ],
+      },
     };
 
     // Allocate shared ref for the scene and instantiate.
@@ -213,15 +212,14 @@ describe('builtin reverse lookup ownership', () => {
     prepareWorld(world);
     const scene: SceneAsset = {
       kind: 'scene',
-      entities: [
-        {
-          localId: 0 as never,
+      entities: {
+        'entity-0': {
           components: {
             Transform: {},
             MeshFilter: { assetHandle: HANDLE_CUBE as never },
           },
         },
-      ],
+      },
     };
     const sceneHandle = world.allocSharedRef<'SceneAsset', SceneAsset>('SceneAsset', scene);
     const instantiated = SceneOwner.worldInstantiateScene(world, sceneHandle);
@@ -231,7 +229,7 @@ describe('builtin reverse lookup ownership', () => {
     const collected = rootsToSceneAsset(registry, world, [instantiated.value.root]);
     expect(collected.ok).toBe(true);
     if (!collected.ok) return;
-    const meshEntity = collected.value.entities.find(
+    const meshEntity = Object.values(collected.value.entities).find(
       (entity) => entity.components.MeshFilter !== undefined,
     );
     expect(meshEntity?.components.MeshFilter?.assetHandle).toBe(GUID_A);
@@ -316,16 +314,15 @@ describe('w14 M4 probe — owned payload identity anchor', () => {
     const newHandle = world.allocSharedRef<'MeshAsset', MeshAsset>('MeshAsset', repeated.value);
     const scene: SceneAsset = {
       kind: 'scene',
-      entities: [
-        {
-          localId: 0 as never,
+      entities: {
+        'entity-0': {
           components: {
             Transform: {},
             MeshFilter: { assetHandle: newHandle as never },
             MeshRenderer: { materials: [] },
           },
         },
-      ],
+      },
     };
     const sceneHandle = world.allocSharedRef<'SceneAsset', SceneAsset>('SceneAsset', scene);
     const instantiated = SceneOwner.worldInstantiateScene(world, sceneHandle);
@@ -334,7 +331,7 @@ describe('w14 M4 probe — owned payload identity anchor', () => {
     const collected = rootsToSceneAsset(reg, world, [instantiated.value.root]);
     expect(collected.ok).toBe(true);
     if (!collected.ok) return;
-    expect(collected.value.entities).toContainEqual(
+    expect(Object.values(collected.value.entities)).toContainEqual(
       expect.objectContaining({
         components: expect.objectContaining({
           MeshFilter: expect.objectContaining({ assetHandle: MESH_GUID }),
@@ -357,25 +354,24 @@ describe('w14 M4 probe — owned payload identity anchor', () => {
     // GUID string (post-parse intermediate shape), catalogued with refs edges.
     const child: SceneAsset = {
       kind: 'scene',
-      entities: [
-        {
-          localId: 0 as never,
+      entities: {
+        'entity-0': {
           components: {
             Transform: {},
             MeshFilter: { assetHandle: MESH_GUID as never },
             MeshRenderer: { materials: [MAT_GUID] as never },
           },
         },
-      ],
+      },
     };
     reg.catalog(parseGuid(CHILD_GUID), child as Asset, [{ guid: MESH_GUID }, { guid: MAT_GUID }]);
 
     const parent: SceneAsset = {
       kind: 'scene',
-      entities: [{ localId: 0 as never, components: { Transform: {} } }],
-      mounts: [
-        { localId: 1 as never, source: CHILD_GUID, memberFirst: 2 as never, memberCount: 1 },
-      ],
+      entities: {
+        'entity-0': { components: { Transform: {} } },
+        child: { components: {}, instance: { source: CHILD_GUID } },
+      },
     };
     reg.catalog(parseGuid(PARENT_GUID), parent as Asset);
 
@@ -583,16 +579,15 @@ describe('w16 M4 — AC-08 reverse-lookup hit across kinds', () => {
     );
     const scene: SceneAsset = {
       kind: 'scene',
-      entities: [
-        {
-          localId: 0 as never,
+      entities: {
+        'entity-0': {
           components: {
             Transform: {},
             MeshFilter: { assetHandle: meshHandle as never },
             MeshRenderer: { materials: [matHandle] as never },
           },
         },
-      ],
+      },
     };
     const sceneHandle = world.allocSharedRef<'SceneAsset', SceneAsset>('SceneAsset', scene);
     const instRes = SceneOwner.worldInstantiateScene(world, sceneHandle);