@forgeax/engine-runtime 0.1.21 → 0.1.24

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-caster-empty-schema.test.ts

@@ -73,7 +73,7 @@ describe('shadow_caster empty schema (M4 w21)', () => {
       'render',
       'src',
       'assembly',
-      'factory.ts',
+      'material-shader-policy.ts',
     );
     const src = readFileSync(createRendererPath, 'utf8');
     const re =

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 24-frame
+// 128x128 target to avoid retaining a large lavapipe command backlog.
+const SHADOW_FIELDS_RENDER_FRAMES = LIGHTWEIGHT_DAWN ? 24 : 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__/shadow-m1.dawn.test.ts

@@ -61,8 +61,8 @@ describe('shadow M1a dawn (w2 RED)', () => {
         mat4.create(),
         -FIXTURE_ORTHO_HALF,
         FIXTURE_ORTHO_HALF,
-        -FIXTURE_ORTHO_HALF,
         FIXTURE_ORTHO_HALF,
+        -FIXTURE_ORTHO_HALF,
         FIXTURE_NEAR,
         FIXTURE_FAR,
       );