@forgeax/engine-runtime 0.1.23 → 0.1.25

package/src/__tests__/shadow-caster-empty-schema.test.ts

@@ -1,16 +1,13 @@
 // @ts-nocheck — node:fs / node:path / node:url imports outside @types/node
 // coverage in runtime tsconfig (mirrors pipeline.unit.test.ts header).
-// shadow-caster-empty-schema.test.ts -- M4 / w21 explicit empty-schema gate.
+// shadow-caster-surface-schema.test.ts -- shared Surface shadow contract.
 //
 // feat-20260613-material-paramschema-driven-binding M4 / w21.
 //
 // Decision anchors (plan-strategy §2 + §3.4):
-//   - D-12  empty schema is graceful: derive([]) -> bglEntries=[],
-//           totalBytes=0, textureFieldNames=empty, samplerForTexture=empty,
-//           userRegionBindingEnd=0. The shadow_caster shader has zero
-//           @group(1) bindings and registers under an empty paramSchema.
-//   - the shadow-caster module has no authored material parameter sidecar;
-//           its empty MaterialAsset parameter list is derived at runtime.
+//   - derive([]) remains a valid generic empty-schema path.
+//   - the shadow-caster module has no authored sidecar; its generated
+//           MaterialParameters contract is the Standard pipeline schema.
 //
 // What this test asserts:
 //   (a) derive([]) produces all-empty / zero output -- the graceful path.
@@ -18,14 +15,13 @@
 //   (c) appendInjection over the empty user-region starts injected
 //       bindings at binding 0 (covered also in append-injection.test.ts;
 //       this test pins the empty-schema path explicitly).
-//   (d) The runtime registers `forgeax::default-shadow-caster` with
-//       paramSchema=[] (createRenderer.ts:3172) -- structural assertion that
-//       no static literal in createRenderer hardcodes a non-empty schema
-//       for this identifier.
+//   (d) The runtime fallback registers `forgeax::default-shadow-caster` with
+//       the shared Standard pipeline schema.
 
 import { existsSync, readFileSync } from 'node:fs';
 import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { STANDARD_PIPELINE_PARAM_SCHEMA } from '@forgeax/engine-shader';
 import { derive } from '@forgeax/engine-types';
 import { describe, expect, it } from 'vitest';
 import { appendInjection } from '../../../render/src/pbr-pipeline';
@@ -36,7 +32,7 @@ const repoRoot = (() => {
   return join(here, '..', '..', '..', '..');
 })();
 
-describe('shadow_caster empty schema (M4 w21)', () => {
+describe('shadow_caster shared Surface schema', () => {
   it('(a) derive([]) returns all-empty/zero output (D-12 graceful path)', () => {
     const out = derive([]);
     expect(out.bglEntries.length).toBe(0);
@@ -66,18 +62,19 @@ describe('shadow_caster empty schema (M4 w21)', () => {
     expect(injected[0]?.binding).toBe(0);
   });
 
-  it('(d) shadow_caster register call site carries paramSchema: []', () => {
+  it('(d) shadow_caster fallback register call carries the Standard schema', () => {
     const createRendererPath = join(
       repoRoot,
       'packages',
       'render',
       'src',
       'assembly',
-      'factory.ts',
+      'material-shader-policy.ts',
     );
     const src = readFileSync(createRendererPath, 'utf8');
     const re =
-      /installMaterialArtifact\(\s*shadowCasterIdentifier\s*,\s*\{[^}]*paramSchema\s*:\s*\[\s*\][^}]*\}\s*\)/s;
+      /installMaterialArtifact\(\s*shadowCasterIdentifier\s*,\s*\{[^}]*paramSchema\s*:\s*STANDARD_PIPELINE_PARAM_SCHEMA[^}]*\}\s*\)/s;
     expect(src).toMatch(re);
+    expect(STANDARD_PIPELINE_PARAM_SCHEMA.length).toBeGreaterThan(0);
   });
 });

package/src/__tests__/shadow-csm-runtime-vary.dawn.test.ts

@@ -83,6 +83,11 @@ describe('M3 RhiNull structural admission', () => {
 
 const WIDTH = 320;
 const HEIGHT = 240;
+const LIGHTWEIGHT_DAWN = process.env.FORGEAX_DAWN_LIGHTWEIGHT === '1';
+// The variation gate only needs to observe graph rebuilds. Keep the full
+// 2048 atlas for local/nightly diagnostics, while avoiding a 4-cascade 16MiB
+// allocation on the overloaded PR lane.
+const LARGE_MAP_SIZE = LIGHTWEIGHT_DAWN ? 1024 : 2048;
 
 interface MockCanvas {
   width: number;
@@ -182,19 +187,19 @@ describe('CSM runtime cascade + mapSize variation (M5/w26)', () => {
     if (!host.ok) throw host.error;
     const { renderer } = host.value;
     expect(renderer.inspect().state).toBe('alive');
-    const { world, shadowEntity } = buildScene(4, 2048);
+    const { world, shadowEntity } = buildScene(4, LARGE_MAP_SIZE);
 
     expect(drawPublished(renderer, world).ok).toBe(true);
 
     world.set(shadowEntity, DirectionalLight, {
-      mapSize: 2048,
+      mapSize: LARGE_MAP_SIZE,
       shadowDistance: 50,
       cascadeCount: 2,
     });
     expect(drawPublished(renderer, world).ok).toBe(true);
 
     world.set(shadowEntity, DirectionalLight, {
-      mapSize: 2048,
+      mapSize: LARGE_MAP_SIZE,
       shadowDistance: 50,
       cascadeCount: 4,
     });
@@ -213,7 +218,7 @@ describe('CSM runtime cascade + mapSize variation (M5/w26)', () => {
     if (!host.ok) throw host.error;
     const { renderer } = host.value;
     expect(renderer.inspect().state).toBe('alive');
-    const { world, shadowEntity } = buildScene(4, 2048);
+    const { world, shadowEntity } = buildScene(4, LARGE_MAP_SIZE);
 
     expect(drawPublished(renderer, world).ok).toBe(true);
 
@@ -225,7 +230,7 @@ describe('CSM runtime cascade + mapSize variation (M5/w26)', () => {
     expect(drawPublished(renderer, world).ok).toBe(true);
 
     world.set(shadowEntity, DirectionalLight, {
-      mapSize: 2048,
+      mapSize: LARGE_MAP_SIZE,
       shadowDistance: 50,
       cascadeCount: 4,
     });

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

@@ -32,9 +32,9 @@ import { drawPublished } from './draw-published';
 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
+// local and nightly runs, while the isolated PR process uses a bounded 12-frame
 // 128x128 target to avoid retaining a large lavapipe command backlog.
-const SHADOW_FIELDS_RENDER_FRAMES = LIGHTWEIGHT_DAWN ? 60 : 300;
+const SHADOW_FIELDS_RENDER_FRAMES = LIGHTWEIGHT_DAWN ? 12 : 300;
 const WIDTH = LIGHTWEIGHT_DAWN ? 128 : 256;
 const HEIGHT = LIGHTWEIGHT_DAWN ? 128 : 256;
 const BPR = Math.ceil((WIDTH * 4) / 256) * 256;

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,
       );