@forgeax/engine-runtime 0.1.19 → 0.1.21

package/src/__tests__/loadbyguid-texture-intern.unit.test.ts

@@ -64,13 +64,12 @@ function registerQuadMesh(world: World): Handle<'MeshAsset', 'shared'> {
 function textureAsset(red = 255): TextureAsset {
   return {
     kind: 'texture',
-    width: 1,
-    height: 1,
+    shape: { viewDimension: '2d', extent: { width: 1, height: 1 } },
     format: 'rgba8unorm',
     data: new Uint8Array([red, 255, 255, 255]),
     colorSpace: 'linear',
-    mipmap: false,
-  } as unknown as TextureAsset;
+    mips: { kind: 'none' },
+  };
 }
 
 // Build a loadByGuid-shaped scene: the material's baseColorTexture paramValue is

package/src/__tests__/loader-name-survival.test.ts

@@ -77,11 +77,10 @@ function makeSharedPack(): unknown {
 
 const TEX_METADATA = {
   kind: 'texture',
-  width: 1,
-  height: 1,
+  shape: { viewDimension: '2d', extent: { width: 1, height: 1 } },
   format: 'rgba8unorm',
   colorSpace: 'srgb',
-  mipmap: false,
+  mips: { kind: 'none' },
 };
 
 // `includeNames=false` is the FALSIFY variant (entry.name stripped).

package/src/__tests__/material-texture-dimension-mismatch.unit.test.ts

@@ -0,0 +1,18 @@
+import { derive } from '@forgeax/engine-types';
+import { describe, expect, it } from 'vitest';
+
+describe('material texture dimension mismatch contract', () => {
+  it('carries the authored array view dimension into the material binding interface', () => {
+    const derived = derive([{ name: 'layers', type: 'texture2d_array' }]);
+
+    expect(derived.coordinateRecords[0]?.parameter).toBe('layers');
+    expect(derived.bglEntries[2]?.texture?.viewDimension).toBe('2d-array');
+  });
+
+  it('carries the authored volume view dimension without changing the submit boundary', () => {
+    const derived = derive([{ name: 'volume', type: 'texture3d' }]);
+
+    expect(derived.bglEntries[2]?.texture?.viewDimension).toBe('3d');
+    expect(derived.resourceBindings).toHaveLength(2);
+  });
+});

package/src/__tests__/material-texture-uv-scale.unit.test.ts

@@ -10,7 +10,10 @@ import {
 
 describe('material texture UV scale [w37]', () => {
   it('maps a non-aligned BC7 logical edge below padded physical storage', () => {
-    const scale = materialTextureUvScale({ width: 2085, height: 1573, format: 'bc7-rgba-unorm' });
+    const scale = materialTextureUvScale({
+      shape: { viewDimension: '2d', extent: { width: 2085, height: 1573 } },
+      format: 'bc7-rgba-unorm',
+    });
     expect(scale).toEqual([2085 / 2088, 1573 / 1576]);
     expect(scale[0]).toBeLessThan(1);
     expect(scale[1]).toBeLessThan(1);
@@ -18,7 +21,12 @@ describe('material texture UV scale [w37]', () => {
 
   it('uses identity scale for uncompressed and fallback texture bindings', () => {
     expect(materialTextureUvScale(undefined)).toEqual([1, 1]);
-    expect(materialTextureUvScale({ width: 17, height: 9, format: 'rgba8unorm' })).toEqual([1, 1]);
+    expect(
+      materialTextureUvScale({
+        shape: { viewDimension: '2d', extent: { width: 17, height: 9 } },
+        format: 'rgba8unorm',
+      }),
+    ).toEqual([1, 1]);
   });
 
   it('keeps compatibility param schemas compact when they have no textures', () => {

package/src/__tests__/mip-gate.unit.test.ts

@@ -27,19 +27,20 @@ import { deriveRenderDataTexture } from '../../../render/src/render-data';
 function tex(overrides: Partial<TextureAsset>): TextureAsset {
   return {
     kind: 'texture',
-    width: 8,
-    height: 8,
+    shape: { viewDimension: '2d', extent: { width: 8, height: 8 } },
     format: 'rgba8unorm',
     data: new Uint8Array(8 * 8 * 4),
     colorSpace: 'linear',
-    mipmap: false,
+    mips: { kind: 'none' },
     ...overrides,
   };
 }
 
 describe('deriveRenderDataTexture -- mip gate on compressed formats (w30, AC-09)', () => {
   it('compressed format + mipmap:true (runtime mip-gen requested) -> error', () => {
-    const res = deriveRenderDataTexture(tex({ format: 'bc7-rgba-unorm', mipmap: true }));
+    const res = deriveRenderDataTexture(
+      tex({ format: 'bc7-rgba-unorm', mips: { kind: 'generate' } }),
+    );
     expect(res.ok).toBe(false);
     if (!res.ok) {
       expect(res.error.code).toBe('mipgen-unsupported-compressed-format');
@@ -50,7 +51,9 @@ describe('deriveRenderDataTexture -- mip gate on compressed formats (w30, AC-09)
   });
 
   it('mip-gate error fires for an ETC2 compressed format too', () => {
-    const res = deriveRenderDataTexture(tex({ format: 'etc2-rgba8unorm', mipmap: true }));
+    const res = deriveRenderDataTexture(
+      tex({ format: 'etc2-rgba8unorm', mips: { kind: 'generate' } }),
+    );
     expect(res.ok).toBe(false);
     if (!res.ok) expect(res.error.code).toBe('mipgen-unsupported-compressed-format');
   });
@@ -59,20 +62,20 @@ describe('deriveRenderDataTexture -- mip gate on compressed formats (w30, AC-09)
     // The KTX2 loader baked the mip chain offline; this is the normal
     // compressed-upload path and must NOT trip the runtime-mip-gen gate.
     const res = deriveRenderDataTexture(
-      tex({ format: 'bc7-rgba-unorm', mipmap: true, mipLevelCount: 4 }),
+      tex({ format: 'bc7-rgba-unorm', mips: { kind: 'packed', levelCount: 4 } }),
     );
     expect(res.ok).toBe(true);
     if (res.ok) expect(res.value.mipLevelCount).toBe(4);
   });
 
   it('compressed format + mipmap:false -> ok (single level)', () => {
-    const res = deriveRenderDataTexture(tex({ format: 'bc7-rgba-unorm', mipmap: false }));
+    const res = deriveRenderDataTexture(tex({ format: 'bc7-rgba-unorm', mips: { kind: 'none' } }));
     expect(res.ok).toBe(true);
     if (res.ok) expect(res.value.mipLevelCount).toBe(1);
   });
 
   it('uncompressed format + mipmap:true -> ok (existing runtime mip-gen path unchanged)', () => {
-    const res = deriveRenderDataTexture(tex({ format: 'rgba8unorm', mipmap: true }));
+    const res = deriveRenderDataTexture(tex({ format: 'rgba8unorm', mips: { kind: 'generate' } }));
     expect(res.ok).toBe(true);
     if (res.ok) expect(res.value.mipLevelCount).toBeGreaterThan(1);
   });

package/src/__tests__/msaa-sprite-pixel-diff.dawn.test.ts

@@ -260,12 +260,11 @@ describe('feat-20260604-msaa M2 w9 [F-1]: LDR sprite + MSAA split sub-pass cover
     const synth = buildSyntheticRgba();
     const synthPod = {
       kind: 'texture' as const,
-      width: synth.width,
-      height: synth.height,
+      shape: { viewDimension: '2d' as const, extent: { width: synth.width, height: synth.height } },
       format: 'rgba8unorm-srgb' as const,
       data: synth.data,
       colorSpace: 'srgb' as const,
-      mipmap: false,
+      mips: { kind: 'none' as const },
     };
     const TEX_GUID = '00000000-0000-7000-8000-0000000005a1';
     const SAMPLER_GUID = '00000000-0000-7000-8000-0000000005a2';

package/src/__tests__/new-kind-refs-contract.test.ts

@@ -62,12 +62,11 @@ describe('AC-07 — a new reference appears in the load graph via envelope.refs'
     // new reference field whose GUID it dropped into refs[]".
     reg.catalog(parseGuid(EXTRA_REF_GUID), {
       kind: 'texture',
-      width: 1,
-      height: 1,
+      shape: { viewDimension: '2d', extent: { width: 1, height: 1 } },
       format: 'rgba8unorm',
       data: new Uint8Array(4),
       colorSpace: 'srgb',
-      mipmap: false,
+      mips: { kind: 'none' },
     });
 
     const packIndex = [

package/src/__tests__/pbr-pipeline.unit.test.ts

@@ -44,7 +44,7 @@ function makeSpec(): PipelineSpec {
 
 describe('buildBindGroupLayoutDescriptor — pbr-pipeline 6 sites byte-equiv', () => {
   describe('pbr-view', () => {
-    it('storageBuffer=true: 10 entries with read-only-storage on bindings 1+2', () => {
+    it('storageBuffer=true: 12 entries with read-only-storage on bindings 1+2 and projector bindings 11+12', () => {
       const spec = makeSpec();
       const out = buildBindGroupLayoutDescriptor(spec, {
         kind: 'pbr-view',
@@ -60,11 +60,15 @@ describe('buildBindGroupLayoutDescriptor — pbr-pipeline 6 sites byte-equiv', (
       // Points/Lines viewport UBO occupies binding 10, while w25 (scope-amend
       // webkit-fallback) folded the former binding 9 spotLightViewProj matrices
       // UBO into the View UBO (`view.spotLightViewProj`), so the BGL stays at 9
-      // entries (bindings 0..8 plus binding 10) — keeping the WebGL2 fallback fragment uniform-
-      // buffer count <= 11 (GLES 3.0).
-      expect(out.entries.length).toBe(10);
+      // entries (bindings 0..8 plus optional projector 11+12 and binding 10)
+      // — keeping the WebGL2 fallback fragment uniform-buffer count <= 11
+      // (GLES 3.0), while the projector remains available on the default
+      // WebGPU path.
+      expect(out.entries.length).toBe(12);
       expect(out.entries.find((entry) => entry.binding === 9)).toBeUndefined();
       expect(out.entries.find((entry) => entry.binding === 10)?.buffer?.type).toBe('uniform');
+      expect(out.entries.find((entry) => entry.binding === 11)?.texture?.viewDimension).toBe('2d');
+      expect(out.entries.find((entry) => entry.binding === 12)?.sampler?.type).toBe('filtering');
     });
 
     it('storageBuffer=false: bindings 1+2 fall back to uniform', () => {
@@ -79,6 +83,21 @@ describe('buildBindGroupLayoutDescriptor — pbr-pipeline 6 sites byte-equiv', (
       };
       expect(out).toEqual(expected);
     });
+
+    it('projectorAvailable=false: omits optional projector bindings for the 16-texture limit', () => {
+      const spec = makeSpec();
+      const out = buildBindGroupLayoutDescriptor(spec, {
+        kind: 'pbr-view',
+        caps: { storageBuffer: true, projectorAvailable: false },
+      });
+      expect(out).toEqual({
+        label: 'pbr-view-bgl',
+        entries: buildPbrViewBglEntries({ storageBuffer: true, projectorAvailable: false }),
+      });
+      expect(out.entries.find((entry) => entry.binding === 11)).toBeUndefined();
+      expect(out.entries.find((entry) => entry.binding === 12)).toBeUndefined();
+      expect(out.entries.find((entry) => entry.binding === 10)?.buffer?.type).toBe('uniform');
+    });
   });
 
   describe('pbr-material-merged', () => {
@@ -160,7 +179,7 @@ describe('buildBindGroupLayoutDescriptor — pbr-pipeline 6 sites byte-equiv', (
   });
 
   describe('pbr-skin-mesh-array', () => {
-    it('storageBuffer=true: 2 entries, both dynamic offset', () => {
+    it('storageBuffer=true: 3 entries, all dynamic offset', () => {
       const spec = makeSpec();
       const out = buildBindGroupLayoutDescriptor(spec, {
         kind: 'pbr-skin-mesh-array',
@@ -179,6 +198,11 @@ describe('buildBindGroupLayoutDescriptor — pbr-pipeline 6 sites byte-equiv', (
             visibility: 0x1,
             buffer: { type: 'read-only-storage', hasDynamicOffset: true },
           },
+          {
+            binding: 2,
+            visibility: 0x1,
+            buffer: { type: 'read-only-storage', hasDynamicOffset: true },
+          },
         ],
       });
     });