@forgeax/engine-runtime 0.1.27 → 0.1.29

package/src/__tests__/transient-fields-collect.test.ts

@@ -49,7 +49,7 @@ describe('w1 — AC-07 transient exclusion (SpriteAnimation, VideoPlayer)', () =
     expect(collected.ok).toBe(true);
     if (!collected.ok) return;
 
-    const entity = collected.value.entities[0];
+    const entity = Object.values(collected.value.entities)[0];
     expect(entity).toBeDefined();
     if (!entity) return;
 
@@ -80,7 +80,7 @@ describe('w1 — AC-07 transient exclusion (SpriteAnimation, VideoPlayer)', () =
     expect(collected.ok).toBe(true);
     if (!collected.ok) return;
 
-    const entity = collected.value.entities[0];
+    const entity = Object.values(collected.value.entities)[0];
     expect(entity).toBeDefined();
     if (!entity) return;
 
@@ -117,7 +117,7 @@ describe('w2 — AC-08 round-trip tests (SpriteAnimation, VideoPlayer)', () => {
     expect(collected.ok).toBe(true);
     if (!collected.ok) return;
 
-    const entity = collected.value.entities[0];
+    const entity = Object.values(collected.value.entities)[0];
     expect(entity).toBeDefined();
     if (!entity) return;
 
@@ -173,7 +173,7 @@ describe('w2 — AC-08 round-trip tests (SpriteAnimation, VideoPlayer)', () => {
     expect(collected.ok).toBe(true);
     if (!collected.ok) return;
 
-    const entity = collected.value.entities[0];
+    const entity = Object.values(collected.value.entities)[0];
     expect(entity).toBeDefined();
     if (!entity) return;
 

package/src/__tests__/transient-runtime-behavior.test.ts

@@ -41,7 +41,7 @@ function makeWorld(): World {
   return world;
 }
 
-function localId(n: number): LocalEntityId {
+function _localId(n: number): LocalEntityId {
   return n as LocalEntityId;
 }
 
@@ -74,7 +74,7 @@ describe('m3t2 — transient runtime behavior (AC-07)', () => {
     // touches the manually-spawned entity
     const asset: SceneAsset = {
       kind: 'scene',
-      entities: [{ localId: localId(0), components: {} }],
+      entities: { 'entity-0': { components: {} } },
     };
     cat(reg, '00000000-0000-4000-8000-000000000000', asset);
     const inst = reg.instantiate(rs(world, asset), world);
@@ -112,7 +112,7 @@ describe('m3t2 — transient runtime behavior (AC-07)', () => {
     // Collect an unrelated scene to exercise the collect code path
     const asset: SceneAsset = {
       kind: 'scene',
-      entities: [{ localId: localId(0), components: {} }],
+      entities: { 'entity-0': { components: {} } },
     };
     cat(reg, '11111111-1111-4111-8111-111111111111', asset);
     const inst = reg.instantiate(rs(world, asset), world);
@@ -134,7 +134,7 @@ describe('m3t2 — transient runtime behavior (AC-07)', () => {
 
     const child: SceneAsset = {
       kind: 'scene',
-      entities: [{ localId: localId(0), components: {} }],
+      entities: { 'entity-0': { components: {} } },
     };
     cat(reg, '22222222-2222-4222-8222-222222222222', child);
     const inst = reg.instantiate(rs(world, child), world);
@@ -171,7 +171,7 @@ describe('m3t2 — transient runtime behavior (AC-07)', () => {
     // Collect an unrelated scene
     const asset: SceneAsset = {
       kind: 'scene',
-      entities: [{ localId: localId(0), components: {} }],
+      entities: { 'entity-0': { components: {} } },
     };
     cat(reg, '33333333-3333-4333-8333-333333333333', asset);
     const inst = reg.instantiate(rs(world, asset), world);
@@ -195,10 +195,10 @@ describe('m3t2 — transient runtime behavior (AC-07)', () => {
     // The mirror hook should populate Children on entity at localId 0.
     const asset: SceneAsset = {
       kind: 'scene',
-      entities: [
-        { localId: localId(0), components: { Transform: {} } },
-        { localId: localId(1), components: { Transform: {}, ChildOf: { parent: localId(0) } } },
-      ],
+      entities: {
+        'entity-0': { components: { Transform: {} } },
+        'entity-1': { components: { Transform: {}, ChildOf: { parent: 'entity-0' } } },
+      },
     };
     cat(reg, '44444444-4444-4444-8444-444444444444', asset);
     const inst = reg.instantiate(rs(world, asset), world);

package/src/__tests__/vfx-depth-material.dawn.test.ts

@@ -0,0 +1,42 @@
+import { it } from 'vitest';
+import { particleDepthLayouts, verifyFeatureDepthMaterial } from './feature-depth-material.fixture';
+
+// Separate from the synthetic layout suite so each renderer/manifest batch
+// has a bounded process lifetime under the Dawn runner's file isolation.
+const layouts = [
+  { ...particleDepthLayouts[0], particleKind: 'billboard' },
+  ...(['ribbon', 'trail', 'beam'] as const).map((particleKind) => ({
+    ...particleDepthLayouts[1],
+    particleKind,
+  })),
+  { ...particleDepthLayouts[2], particleKind: 'mesh' },
+] as const;
+it.each(
+  layouts.flatMap((layout) =>
+    (['none', 'material', 'depth'] as const).map((missing) => ({ ...layout, view: true, missing })),
+  ),
+)(
+  'cooks and submits $particleKind with material/depth/input: missing=$missing',
+  verifyFeatureDepthMaterial,
+  120_000,
+);
+it.each(
+  layouts.map((layout) => ({ ...layout, view: true, missing: 'none' as const, inputLane: 3 })),
+)(
+  'renders sparse material lane 3 through cooked $particleKind instances',
+  verifyFeatureDepthMaterial,
+  120_000,
+);
+it.each(
+  layouts.map((layout) => ({
+    ...layout,
+    view: true,
+    missing: 'none' as const,
+    inputLane: 3,
+    allInputs: true,
+  })),
+)(
+  'reads all four distinct material lanes through cooked $particleKind instances',
+  verifyFeatureDepthMaterial,
+  120_000,
+);

package/src/__tests__/vfx-mesh-lighting.browser.test.ts

@@ -0,0 +1,16 @@
+import { it } from 'vitest';
+import { commands } from 'vitest/browser';
+import { type CookMeshLightingFixture, verifyVfxMeshLighting } from './vfx-mesh-lighting.fixture';
+
+declare module 'vitest/browser' {
+  interface BrowserCommands {
+    cookVfxMeshLighting: CookMeshLightingFixture;
+  }
+}
+
+it('verifies Mesh Point/IBL parity and depth-dependent shadow latency on WebGPU', async () => {
+  await verifyVfxMeshLighting({
+    shaderManifestUrl: '/shaders/manifest.json',
+    cook: commands.cookVfxMeshLighting,
+  });
+}, 120_000);

package/src/__tests__/vfx-mesh-lighting.commands.ts

@@ -0,0 +1,14 @@
+import { ok } from '@forgeax/engine-types';
+import { cookParticleCodeEffect, type ParticleCodeModuleSet } from '@forgeax/engine-vfx-compiler';
+
+/** Test-host cooking only; no compiler or source evaluation enters the player. */
+export const vfxMeshLightingCommands = {
+  async cookVfxMeshLighting(
+    _context: unknown,
+    source: unknown,
+    modules: Readonly<Record<string, ParticleCodeModuleSet>>,
+  ) {
+    const cooked = await cookParticleCodeEffect(source, modules);
+    return cooked.ok ? ok({ asset: cooked.value.asset }) : cooked;
+  },
+};

package/src/__tests__/vfx-mesh-lighting.dawn.test.ts

@@ -0,0 +1,16 @@
+import { writeFileSync } from 'node:fs';
+import { env } from 'node:process';
+import { cookParticleCodeEffect } from '@forgeax/engine-vfx-compiler';
+import { buildEngineShaderManifest } from '@forgeax/engine-vite-plugin-shader';
+import { it } from 'vitest';
+import { verifyVfxMeshLighting } from './vfx-mesh-lighting.fixture';
+
+it('verifies Mesh Point/IBL parity and depth-dependent shadow latency on Dawn', async () => {
+  const manifest = await buildEngineShaderManifest({ pointShadows: true });
+  await verifyVfxMeshLighting({
+    shaderManifestUrl: `data:application/json,${encodeURIComponent(JSON.stringify(manifest))}`,
+    cook: cookParticleCodeEffect,
+    tapePaths: env,
+    saveTape: writeFileSync,
+  });
+}, 120_000);