@forgeax/engine-rhi-debug 0.1.7 → 0.1.19

package/dist/replay/session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/replay/session.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/replay/session.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forgeax/engine-rhi-debug",
-  "version": "0.1.7",
+  "version": "0.1.19",
   "private": false,
   "type": "module",
   "license": "Apache-2.0",
@@ -26,19 +26,19 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@forgeax/engine-rhi": "0.1.7",
-    "@forgeax/engine-types": "0.1.7",
+    "@forgeax/engine-rhi": "0.1.19",
+    "@forgeax/engine-types": "0.1.19",
     "@noble/hashes": "^2.2.0",
     "pako": "^1.0.11"
   },
   "devDependencies": {
-    "@forgeax/engine-rhi-null": "0.1.7",
+    "@forgeax/engine-rhi-null": "0.1.19",
     "@types/node": "^20.14.0",
     "@webgpu/types": "^0.1.71"
   },
   "peerDependencies": {
-    "@forgeax/engine-rhi-webgpu": "0.1.7",
-    "@forgeax/engine-rhi-wgpu": "0.1.7"
+    "@forgeax/engine-rhi-webgpu": "0.1.19",
+    "@forgeax/engine-rhi-wgpu": "0.1.19"
   },
   "forgeax": {
     "metrics": {

package/src/__tests__/replay-session.unit.test.ts

@@ -45,6 +45,57 @@ async function makeBackend(): Promise<ReplayBackend> {
 }
 
 describe('ReplaySession', () => {
+  it('does not require unused recorded optional capabilities', async () => {
+    const result = await openReplay(
+      {
+        ...makeWorkTape(),
+        header: {
+          ...makeWorkTape().header,
+          rhiCaps: {
+            rgba16floatRenderable: true,
+            float32Filterable: true,
+            textureCompressionBc: true,
+            textureCompressionEtc2: true,
+            textureCompressionAstc: true,
+            storageBuffer: true,
+            timestampQuery: true,
+          },
+        },
+      },
+      await makeBackend(),
+    );
+    expect(result.ok).toBe(true);
+  });
+
+  it('requires a recorded compression capability when the tape uses its format', async () => {
+    const result = await openReplay(
+      {
+        header: {
+          formatVersion: 7,
+          rhiCaps: { textureCompressionBc: true },
+          eventCount: 1,
+          blobCount: 0,
+        },
+        bootstrap: [],
+        events: [
+          {
+            kind: 'createTexture',
+            handleId: 'texture:compressed',
+            desc: {
+              size: { width: 4, height: 4, depthOrArrayLayers: 1 },
+              format: 'bc1-rgba-unorm',
+              usage: 0x04,
+            },
+          },
+        ],
+        blobs: [],
+      },
+      await makeBackend(),
+    );
+    expect(result.ok).toBe(false);
+    if (!result.ok) expect(result.error.code).toBe('replay-capability-mismatch');
+  });
+
   it('replays a depth-only render pipeline without requiring a fragment shader', async () => {
     const tape: Tape = {
       header: { formatVersion: 7, rhiCaps: {}, eventCount: 7, blobCount: 0 },

package/src/replay/session.ts

@@ -218,8 +218,13 @@ export async function openReplay(
 
 function checkCapabilities(tape: Tape, device: RhiDevice): RhiDebugError | undefined {
   const recorded = tape.header.rhiCaps;
+  const required = requiredReplayCapabilities(tape);
   const missing = Object.entries(recorded).filter(([key, value]) => {
-    if (value !== true) return false;
+    // A recorder snapshots the device's available capabilities, but replay
+    // only needs to require a capability when the captured workload can use
+    // it. Otherwise a device-wide optional feature (for example ASTC support)
+    // makes an unrelated RGBA tape non-portable.
+    if (value !== true || (!required.has(key) && isKnownReplayCapability(key))) return false;
     const target = device.caps[key as keyof typeof device.caps];
     return target !== true;
   });
@@ -230,6 +235,93 @@ function checkCapabilities(tape: Tape, device: RhiDevice): RhiDebugError | undef
   });
 }
 
+const BC_TEXTURE_FORMATS = new Set([
+  'bc1-rgba-unorm',
+  'bc1-rgba-unorm-srgb',
+  'bc2-rgba-unorm',
+  'bc2-rgba-unorm-srgb',
+  'bc3-rgba-unorm',
+  'bc3-rgba-unorm-srgb',
+  'bc4-r-unorm',
+  'bc4-r-snorm',
+  'bc5-rg-unorm',
+  'bc5-rg-snorm',
+  'bc6h-rgb-ufloat',
+  'bc6h-rgb-sfloat',
+  'bc7-rgba-unorm',
+  'bc7-rgba-unorm-srgb',
+]);
+
+const ETC2_TEXTURE_FORMATS = new Set([
+  'etc2-rgb8unorm',
+  'etc2-rgb8unorm-srgb',
+  'etc2-rgb8a1unorm',
+  'etc2-rgb8a1unorm-srgb',
+  'etc2-rgba8unorm',
+  'etc2-rgba8unorm-srgb',
+  'eac-r11unorm',
+  'eac-r11snorm',
+  'eac-rg11unorm',
+  'eac-rg11snorm',
+]);
+
+const KNOWN_REPLAY_CAPABILITIES = new Set([
+  'rgba16floatRenderable',
+  'float32Filterable',
+  'textureCompressionBc',
+  'textureCompressionEtc2',
+  'textureCompressionAstc',
+  'storageBuffer',
+  'timestampQuery',
+]);
+
+function isKnownReplayCapability(key: string): boolean {
+  return KNOWN_REPLAY_CAPABILITIES.has(key);
+}
+
+function requiredReplayCapabilities(tape: Tape): ReadonlySet<string> {
+  const required = new Set<string>();
+  const events = [
+    ...tape.bootstrap.map((resource) => resource.create as unknown as RhiCallEvent),
+    ...tape.events,
+  ];
+  for (const event of events) {
+    switch (event.kind) {
+      case 'createTexture': {
+        const formats = [event.desc.format, ...(event.desc.viewFormats ?? [])];
+        for (const format of formats) {
+          if (BC_TEXTURE_FORMATS.has(format)) required.add('textureCompressionBc');
+          if (ETC2_TEXTURE_FORMATS.has(format)) required.add('textureCompressionEtc2');
+          if (format.startsWith('astc-')) required.add('textureCompressionAstc');
+          if (format === 'rgba16float') required.add('rgba16floatRenderable');
+          if (format === 'r32float' || format === 'rg32float' || format === 'rgba32float') {
+            required.add('float32Filterable');
+          }
+        }
+        break;
+      }
+      case 'createBindGroupLayout':
+        if (
+          Array.from(event.desc.entries).some(
+            (entry) =>
+              entry.buffer?.type === 'storage' || entry.buffer?.type === 'read-only-storage',
+          )
+        ) {
+          required.add('storageBuffer');
+        }
+        break;
+      case 'createBuffer':
+        // GPUBufferUsage.STORAGE is 0x80 in the WebGPU enum. Keep the replay
+        // package independent of the browser-only global constant.
+        if ((event.desc.usage & 0x80) !== 0) required.add('storageBuffer');
+        break;
+      default:
+        break;
+    }
+  }
+  return required;
+}
+
 async function executeBootstrapResource(
   context: ReplayExecutionContext,
   resource: BootstrapResource,