@flighthq/scene3d-wgpu 0.3.0-next.1692.f1a7a9a → 0.3.0-next.1702.8973fda

package/dist/contract.d.ts

@@ -1,3 +1,4 @@
+export * from './explainWgpuScene3DCoverage';
 export * from './blinnPhongWgpuMeshMaterialRenderer';
 export * from './customShaderWgpuMeshMaterialRenderer';
 export * from './depthWgpuMeshMaterialRenderer';

package/dist/contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,sCAAsC,CAAC;AACrD,cAAc,wCAAwC,CAAC;AACvD,cAAc,iCAAiC,CAAC;AAChD,cAAc,mBAAmB,CAAC;AAClC,cAAc,gDAAgD,CAAC;AAC/D,cAAc,uCAAuC,CAAC;AACtD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,oCAAoC,CAAC;AACnD,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mCAAmC,CAAC;AAClD,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAChD,cAAc,mCAAmC,CAAC;AAClD,cAAc,mCAAmC,CAAC;AAClD,cAAc,kCAAkC,CAAC;AACjD,cAAc,iDAAiD,CAAC;AAChE,cAAc,uCAAuC,CAAC;AACtD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAChD,cAAc,uCAAuC,CAAC;AACtD,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qCAAqC,CAAC"}
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sCAAsC,CAAC;AACrD,cAAc,wCAAwC,CAAC;AACvD,cAAc,iCAAiC,CAAC;AAChD,cAAc,mBAAmB,CAAC;AAClC,cAAc,gDAAgD,CAAC;AAC/D,cAAc,uCAAuC,CAAC;AACtD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,oCAAoC,CAAC;AACnD,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mCAAmC,CAAC;AAClD,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAChD,cAAc,mCAAmC,CAAC;AAClD,cAAc,mCAAmC,CAAC;AAClD,cAAc,kCAAkC,CAAC;AACjD,cAAc,iDAAiD,CAAC;AAChE,cAAc,uCAAuC,CAAC;AACtD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAChD,cAAc,uCAAuC,CAAC;AACtD,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qCAAqC,CAAC"}

package/dist/contract.js

@@ -1,3 +1,4 @@
+export * from './explainWgpuScene3DCoverage';
 export * from './blinnPhongWgpuMeshMaterialRenderer';
 export * from './customShaderWgpuMeshMaterialRenderer';
 export * from './depthWgpuMeshMaterialRenderer';

package/dist/contract.js.map

@@ -1 +1 @@
-{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,sCAAsC,CAAC;AACrD,cAAc,wCAAwC,CAAC;AACvD,cAAc,iCAAiC,CAAC;AAChD,cAAc,mBAAmB,CAAC;AAClC,cAAc,gDAAgD,CAAC;AAC/D,cAAc,uCAAuC,CAAC;AACtD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,oCAAoC,CAAC;AACnD,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mCAAmC,CAAC;AAClD,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAChD,cAAc,mCAAmC,CAAC;AAClD,cAAc,mCAAmC,CAAC;AAClD,cAAc,kCAAkC,CAAC;AACjD,cAAc,iDAAiD,CAAC;AAChE,cAAc,uCAAuC,CAAC;AACtD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAChD,cAAc,uCAAuC,CAAC;AACtD,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qCAAqC,CAAC"}
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sCAAsC,CAAC;AACrD,cAAc,wCAAwC,CAAC;AACvD,cAAc,iCAAiC,CAAC;AAChD,cAAc,mBAAmB,CAAC;AAClC,cAAc,gDAAgD,CAAC;AAC/D,cAAc,uCAAuC,CAAC;AACtD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,oCAAoC,CAAC;AACnD,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mCAAmC,CAAC;AAClD,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAChD,cAAc,mCAAmC,CAAC;AAClD,cAAc,mCAAmC,CAAC;AAClD,cAAc,kCAAkC,CAAC;AACjD,cAAc,iDAAiD,CAAC;AAChE,cAAc,uCAAuC,CAAC;AACtD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAChD,cAAc,uCAAuC,CAAC;AACtD,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qCAAqC,CAAC"}

package/dist/explainWgpuScene3DCoverage.d.ts

@@ -0,0 +1,4 @@
+import type { Scene3DKindUsage, SceneCoverageEntry, WgpuRenderState } from '@flighthq/types/contract';
+export declare function explainWgpuScene3DCoverage(out: SceneCoverageEntry[], state: WgpuRenderState, usage: Readonly<Scene3DKindUsage>): void;
+export declare function hasWgpuScene3DCoverage(state: WgpuRenderState, usage: Readonly<Scene3DKindUsage>): boolean;
+//# sourceMappingURL=explainWgpuScene3DCoverage.d.ts.map

package/dist/explainWgpuScene3DCoverage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explainWgpuScene3DCoverage.d.ts","sourceRoot":"","sources":["../src/explainWgpuScene3DCoverage.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAYtG,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,kBAAkB,EAAE,EACzB,KAAK,EAAE,eAAe,EACtB,KAAK,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAChC,IAAI,CAGN;AAID,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAAG,OAAO,CAEzG"}

package/dist/explainWgpuScene3DCoverage.js

@@ -0,0 +1,81 @@
+import { getWgpuRenderStateRuntime } from '@flighthq/render-wgpu/contract';
+import { resolveModifier } from '@flighthq/shading/contract';
+import { RenderRegistry, SceneCoverage, StandardMaterialKind } from '@flighthq/types/contract';
+import { getWgpuScene3DRuntime } from './wgpuScene3DRuntime';
+// Clears `out`, then reports every kind in `usage` with how well this state is wired for it — satisfied
+// ones included, so one call is a complete manifest. The WebGPU twin of explainGlScene3DCoverage, and
+// the answering half of the scene↔render seam: @flighthq/scene3d says what a document uses, and this —
+// the package that owns the WebGPU registries — says which of those it can serve.
+//
+// Proactive, unlike explainRenderRegistryMisses, which reports what already missed during a frame. Ask
+// this after loading a document and before the first draw, while the answer is still actionable.
+export function explainWgpuScene3DCoverage(out, state, usage) {
+    out.length = 0;
+    collectWgpuScene3DCoverageGaps(out, state, usage, false);
+}
+// Whether this state can draw every kind `usage` names, counting a fallback as a shortfall — the
+// authored material is not what would appear. Stops at the first shortfall and never allocates.
+export function hasWgpuScene3DCoverage(state, usage) {
+    return !collectWgpuScene3DCoverageGaps(null, state, usage, true);
+}
+// The single implementation both tiers read, so the boolean can never disagree with the explanation.
+// `found` counts only real shortfalls, so appending satisfied entries never flips the predicate.
+function collectWgpuScene3DCoverageGaps(out, state, usage, stopAtFirst) {
+    let found = false;
+    // drawScene3D resolves a subset's material by kind, then falls back to whatever is registered for
+    // StandardMaterialKind, then skips the subset. So an unregistered kind may still draw — as the
+    // standard material — which is a downgrade worth naming rather than a silence.
+    const materials = getWgpuScene3DRuntime(state).materialRegistry;
+    const hasStandard = materials.has(StandardMaterialKind);
+    for (let i = 0; i < usage.materialKinds.length; i++) {
+        const kind = usage.materialKinds[i];
+        if (materials.has(kind)) {
+            out?.push({ coverage: SceneCoverage.Satisfied, kind, registry: RenderRegistry.MaterialRenderer });
+            continue;
+        }
+        found = true;
+        if (stopAtFirst)
+            return true;
+        out?.push({
+            coverage: hasStandard ? SceneCoverage.Fallback : SceneCoverage.Missing,
+            kind,
+            registry: RenderRegistry.MaterialRenderer,
+        });
+    }
+    // A texture whose source kind has no resolver samples nothing, so the map is simply absent from the
+    // draw — the untextured-model failure this seam exists to surface before it reaches a frame.
+    const resolvers = getWgpuRenderStateRuntime(state).wgpuTextureResolverRegistry;
+    for (let i = 0; i < usage.textureSourceKinds.length; i++) {
+        const kind = usage.textureSourceKinds[i];
+        if (resolvers?.has(kind) === true) {
+            out?.push({ coverage: SceneCoverage.Satisfied, kind, registry: RenderRegistry.TextureResolver });
+            continue;
+        }
+        found = true;
+        if (stopAtFirst)
+            return true;
+        out?.push({ coverage: SceneCoverage.Missing, kind, registry: RenderRegistry.TextureResolver });
+    }
+    // The shaded compiler assembles base + ordered modifiers into ONE program, so an unregistered snippet
+    // does not fail a single lookup — it fails the whole material. A modifier kind is therefore always
+    // Missing, never a fallback.
+    const snippets = getWgpuScene3DRuntime(state).modifierSnippetRegistry;
+    for (let i = 0; i < usage.modifierKinds.length; i++) {
+        const kind = usage.modifierKinds[i];
+        if (snippets !== null && resolveModifier(snippets, kind) !== null) {
+            out?.push({ coverage: SceneCoverage.Satisfied, kind, registry: RenderRegistry.ModifierSnippet });
+            continue;
+        }
+        found = true;
+        if (stopAtFirst)
+            return true;
+        out?.push({ coverage: SceneCoverage.Missing, kind, registry: RenderRegistry.ModifierSnippet });
+    }
+    // usage.nodeKinds is deliberately NOT checked. The 3D pipeline collects meshes structurally
+    // (`geometry != null` in collectVisibleMeshes) rather than through the node-renderer registry, so no
+    // 3D node kind is registered against anything and reporting one would send a caller looking for a
+    // registrar that does not exist. That the scene reports node kinds anyway is correct — deciding they
+    // need nothing is this layer's call, not the scene's.
+    return found;
+}
+//# sourceMappingURL=explainWgpuScene3DCoverage.js.map

package/dist/explainWgpuScene3DCoverage.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flighthq/scene3d-wgpu",
-  "version": "0.3.0-next.1692.f1a7a9a",
+  "version": "0.3.0-next.1702.8973fda",
   "repository": {
     "type": "git",
     "url": "https://github.com/flighthq/flight.git",
@@ -36,20 +36,20 @@
     "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
   },
   "dependencies": {
-    "@flighthq/camera": "0.3.0-next.1692.f1a7a9a",
-    "@flighthq/color": "0.3.0-next.1692.f1a7a9a",
-    "@flighthq/geometry": "0.3.0-next.1692.f1a7a9a",
-    "@flighthq/image": "0.3.0-next.1692.f1a7a9a",
-    "@flighthq/lighting": "0.3.0-next.1692.f1a7a9a",
-    "@flighthq/log": "0.3.0-next.1692.f1a7a9a",
-    "@flighthq/materials": "0.3.0-next.1692.f1a7a9a",
-    "@flighthq/node": "0.3.0-next.1692.f1a7a9a",
-    "@flighthq/render": "0.3.0-next.1692.f1a7a9a",
-    "@flighthq/render-wgpu": "0.3.0-next.1692.f1a7a9a",
-    "@flighthq/scene3d": "0.3.0-next.1692.f1a7a9a",
-    "@flighthq/shading": "0.3.0-next.1692.f1a7a9a",
-    "@flighthq/texture": "0.3.0-next.1692.f1a7a9a",
-    "@flighthq/types": "0.3.0-next.1692.f1a7a9a"
+    "@flighthq/camera": "0.3.0-next.1702.8973fda",
+    "@flighthq/color": "0.3.0-next.1702.8973fda",
+    "@flighthq/geometry": "0.3.0-next.1702.8973fda",
+    "@flighthq/image": "0.3.0-next.1702.8973fda",
+    "@flighthq/lighting": "0.3.0-next.1702.8973fda",
+    "@flighthq/log": "0.3.0-next.1702.8973fda",
+    "@flighthq/materials": "0.3.0-next.1702.8973fda",
+    "@flighthq/node": "0.3.0-next.1702.8973fda",
+    "@flighthq/render": "0.3.0-next.1702.8973fda",
+    "@flighthq/render-wgpu": "0.3.0-next.1702.8973fda",
+    "@flighthq/scene3d": "0.3.0-next.1702.8973fda",
+    "@flighthq/shading": "0.3.0-next.1702.8973fda",
+    "@flighthq/texture": "0.3.0-next.1702.8973fda",
+    "@flighthq/types": "0.3.0-next.1702.8973fda"
   },
   "devDependencies": {
     "@flighthq/mesh": "*",

package/src/explainWgpuScene3DCoverage.test.ts

@@ -0,0 +1,137 @@
+import { createBoxMeshGeometry } from '@flighthq/mesh/contract';
+import { addNodeChild } from '@flighthq/node/contract';
+import { createMesh, createScene3D, createScene3DKindUsage, getScene3DKindUsage } from '@flighthq/scene3d/contract';
+import { createRimModifier, createShadedMaterial } from '@flighthq/shading/contract';
+import { createTexture } from '@flighthq/texture/contract';
+import type {
+  ImageResourceReference,
+  Scene3DKindUsage,
+  SceneCoverageEntry,
+  WgpuRenderState,
+} from '@flighthq/types/contract';
+import {
+  ImageResourceReferenceKind,
+  RenderRegistry,
+  ResourceResolutionState,
+  SceneCoverage,
+  StandardMaterialKind,
+} from '@flighthq/types/contract';
+import { describe, expect, it } from 'vitest';
+
+import { explainWgpuScene3DCoverage, hasWgpuScene3DCoverage } from './explainWgpuScene3DCoverage';
+import { registerWgpuMeshMaterialRenderer } from './wgpuMeshMaterialRegistry';
+import { makeWgpuScene3DState } from './wgpuScene3DTestHelper';
+
+function shadedUsage(withModifier = false): Scene3DKindUsage {
+  const ref: ImageResourceReference = {
+    bytes: new Uint8Array([1, 2, 3]),
+    failure: null,
+    kind: ImageResourceReferenceKind.Embedded,
+    mimeType: 'image/png',
+    state: ResourceResolutionState.Unresolved,
+  };
+  const material = createShadedMaterial({ diffuseMap: createTexture({ resource: ref }) });
+  if (withModifier) material.modifiers = [createRimModifier({ color: 0x49d8ffff, intensity: 0.7, power: 2.4 })];
+  const scene = createScene3D();
+  scene.resources.push(ref);
+  addNodeChild(scene.root, createMesh(createBoxMeshGeometry(), [material]));
+  const usage = createScene3DKindUsage();
+  getScene3DKindUsage(usage, scene);
+  return usage;
+}
+
+function entries(state: WgpuRenderState, withModifier = false): SceneCoverageEntry[] {
+  const out: SceneCoverageEntry[] = [];
+  explainWgpuScene3DCoverage(out, state, shadedUsage(withModifier));
+  return out;
+}
+
+const renderer = { bind() {}, draw() {} } as never;
+
+describe('explainWgpuScene3DCoverage', () => {
+  it('reports a bare state as missing both the material renderer and the texture resolver', () => {
+    const found = entries(makeWgpuScene3DState().state);
+    expect(found).toContainEqual({
+      coverage: SceneCoverage.Missing,
+      kind: 'ShadedMaterial',
+      registry: RenderRegistry.MaterialRenderer,
+    });
+    expect(found).toContainEqual({
+      coverage: SceneCoverage.Missing,
+      kind: 'image',
+      registry: RenderRegistry.TextureResolver,
+    });
+  });
+
+  it('downgrades the material gap to Fallback once a standard renderer can absorb it', () => {
+    const { state } = makeWgpuScene3DState();
+    registerWgpuMeshMaterialRenderer(state, StandardMaterialKind, renderer);
+    expect(entries(state)).toContainEqual({
+      coverage: SceneCoverage.Fallback,
+      kind: 'ShadedMaterial',
+      registry: RenderRegistry.MaterialRenderer,
+    });
+  });
+
+  it('reports the material as Satisfied once its own renderer is registered', () => {
+    const { state } = makeWgpuScene3DState();
+    registerWgpuMeshMaterialRenderer(state, 'ShadedMaterial', renderer);
+    expect(entries(state)).toContainEqual({
+      coverage: SceneCoverage.Satisfied,
+      kind: 'ShadedMaterial',
+      registry: RenderRegistry.MaterialRenderer,
+    });
+  });
+
+  it('reports an unregistered modifier snippet as Missing, never a fallback', () => {
+    // The shaded compiler assembles base + modifiers into one program, so an absent snippet fails the
+    // whole material rather than degrading it.
+    expect(entries(makeWgpuScene3DState().state, true)).toContainEqual({
+      coverage: SceneCoverage.Missing,
+      kind: 'RimModifier',
+      registry: RenderRegistry.ModifierSnippet,
+    });
+  });
+
+  it('never reports a node-kind entry, since 3D collects meshes structurally', () => {
+    expect(entries(makeWgpuScene3DState().state).some((e) => e.registry === RenderRegistry.NodeRenderer)).toBe(false);
+  });
+
+  it('clears out, so a repeated call does not accumulate', () => {
+    const { state } = makeWgpuScene3DState();
+    const usage = shadedUsage();
+    const out: SceneCoverageEntry[] = [];
+    explainWgpuScene3DCoverage(out, state, usage);
+    const first = out.length;
+    explainWgpuScene3DCoverage(out, state, usage);
+    expect(out).toHaveLength(first);
+  });
+});
+
+describe('hasWgpuScene3DCoverage', () => {
+  it('is false for a bare state and stays false while any kind is unserved', () => {
+    expect(hasWgpuScene3DCoverage(makeWgpuScene3DState().state, shadedUsage())).toBe(false);
+  });
+
+  it('counts a standard-material fallback as uncovered, since the authored material would not appear', () => {
+    const { state } = makeWgpuScene3DState();
+    registerWgpuMeshMaterialRenderer(state, StandardMaterialKind, renderer);
+    expect(hasWgpuScene3DCoverage(state, shadedUsage())).toBe(false);
+  });
+
+  it('agrees with the explain tier on the same state, so the two can never disagree', () => {
+    const { state } = makeWgpuScene3DState();
+    registerWgpuMeshMaterialRenderer(state, 'ShadedMaterial', renderer);
+    const usage = shadedUsage();
+    const out: SceneCoverageEntry[] = [];
+    explainWgpuScene3DCoverage(out, state, usage);
+    const gaps = out.filter((e) => e.coverage !== SceneCoverage.Satisfied);
+    expect(hasWgpuScene3DCoverage(state, usage)).toBe(gaps.length === 0);
+  });
+
+  it('is true once nothing in the usage is unserved', () => {
+    const usage = createScene3DKindUsage();
+    getScene3DKindUsage(usage, createScene3D());
+    expect(hasWgpuScene3DCoverage(makeWgpuScene3DState().state, usage)).toBe(true);
+  });
+});