@flighthq/render 0.5.1-next.1019.1274ec5 → 0.5.1-next.1050.0bd43cc

package/README.md

@@ -13,5 +13,5 @@ Import the supported application-facing API from `@flighthq/render`. The `@fligh
 This package is part of the locked-version Flight SDK graph. Applications may instead install and import `@flighthq/sdk` when package-level tree shaking is sufficient.
 
 - [Flight project](https://github.com/flighthq/flight)
-- [Source for @flighthq/render@0.5.1-next.1019.1274ec5](https://github.com/flighthq/flight/tree/1274ec5c923947dc64d5ffedcbd8169fc758cd9f/packages/render)
-- [License](https://github.com/flighthq/flight/blob/1274ec5c923947dc64d5ffedcbd8169fc758cd9f/LICENSE.md)
+- [Source for @flighthq/render@0.5.1-next.1050.0bd43cc](https://github.com/flighthq/flight/tree/0bd43ccdf62d9977512bf6c0fd6dc3ec177a8c8f/packages/render)
+- [License](https://github.com/flighthq/flight/blob/0bd43ccdf62d9977512bf6c0fd6dc3ec177a8c8f/LICENSE.md)

package/dist/contract.d.ts

@@ -13,6 +13,7 @@ export * from './renderQueue';
 export * from './raster2DSurface';
 export * from './explainScene2DCoverage';
 export * from './explainScene2DPipelineCoverage';
+export * from './explainScene3DPipelineCoverage';
 export * from './renderRegistryGuards';
 export * from './renderRegistrySignals';
 export * from './renderState';

package/dist/contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,kCAAkC,CAAC;AACjD,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,4BAA4B,EAAE,MAAM,eAAe,CAAC;AACpF,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,4BAA4B,EAAE,MAAM,eAAe,CAAC;AACpF,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC"}

package/dist/contract.js

@@ -13,6 +13,7 @@ export * from './renderQueue';
 export * from './raster2DSurface';
 export * from './explainScene2DCoverage';
 export * from './explainScene2DPipelineCoverage';
+export * from './explainScene3DPipelineCoverage';
 export * from './renderRegistryGuards';
 export * from './renderRegistrySignals';
 export * from './renderState';

package/dist/contract.js.map

@@ -1 +1 @@
-{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,kCAAkC,CAAC;AACjD,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,4BAA4B,EAAE,MAAM,eAAe,CAAC;AACpF,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,4BAA4B,EAAE,MAAM,eAAe,CAAC;AACpF,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC"}

package/dist/explainScene3DPipelineCoverage.d.ts

@@ -0,0 +1,3 @@
+import type { NodeAny, RegistryTable, RenderState, Scene3DPipelineCoverageExplanation } from '@flighthq/types/contract';
+export declare function explainScene3DPipelineCoverage(state: RenderState, scene: Readonly<NodeAny>, materialRenderers: Readonly<RegistryTable<unknown>> | null): Scene3DPipelineCoverageExplanation;
+//# sourceMappingURL=explainScene3DPipelineCoverage.d.ts.map

package/dist/explainScene3DPipelineCoverage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explainScene3DPipelineCoverage.d.ts","sourceRoot":"","sources":["../src/explainScene3DPipelineCoverage.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAGV,OAAO,EACP,aAAa,EACb,WAAW,EACX,kCAAkC,EACnC,MAAM,0BAA0B,CAAC;AAOlC,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,EACxB,iBAAiB,EAAE,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,GAAG,IAAI,GACzD,kCAAkC,CAmDpC"}

package/dist/explainScene3DPipelineCoverage.js

@@ -0,0 +1,74 @@
+import { getNodeRuntime } from '@flighthq/node/contract';
+import { getRegistryTableKeys } from '@flighthq/registry/contract';
+import { StandardMaterialKind } from '@flighthq/types/contract';
+import { getRenderStateRuntime } from './renderState';
+// Material renderers live on backend-specific registries (GlRenderRegistries, WgpuRenderRegistries),
+// not on the base RenderRegistries, so the caller passes them explicitly.
+export function explainScene3DPipelineCoverage(state, scene, materialRenderers) {
+    const usedKindSet = new Set();
+    const usedMaterialKindSet = new Set();
+    collectUsed3DKinds(usedKindSet, usedMaterialKindSet, scene);
+    const registeredKinds = [];
+    getRegistryTableKeys(registeredKinds, getRenderStateRuntime(state).registries.renderers);
+    registeredKinds.sort();
+    const registeredMaterialKinds = [];
+    if (materialRenderers !== null) {
+        getRegistryTableKeys(registeredMaterialKinds, materialRenderers);
+    }
+    registeredMaterialKinds.sort();
+    const usedKinds = Array.from(usedKindSet).sort();
+    const usedMaterialKinds = Array.from(usedMaterialKindSet).sort();
+    const registeredKindSet = new Set(registeredKinds);
+    const registeredMaterialKindSet = new Set(registeredMaterialKinds);
+    const uncoveredKinds = [];
+    for (const kind of usedKinds) {
+        if (!registeredKindSet.has(kind))
+            uncoveredKinds.push(kind);
+    }
+    const unusedRegistrations = [];
+    for (const kind of registeredKinds) {
+        if (!usedKindSet.has(kind))
+            unusedRegistrations.push(kind);
+    }
+    const uncoveredMaterialKinds = [];
+    for (const kind of usedMaterialKinds) {
+        if (!registeredMaterialKindSet.has(kind))
+            uncoveredMaterialKinds.push(kind);
+    }
+    const unusedMaterialRegistrations = [];
+    for (const kind of registeredMaterialKinds) {
+        if (!usedMaterialKindSet.has(kind))
+            unusedMaterialRegistrations.push(kind);
+    }
+    return {
+        registeredKinds,
+        registeredMaterialKinds,
+        uncoveredKinds,
+        uncoveredMaterialKinds,
+        unusedMaterialRegistrations,
+        unusedRegistrations,
+        usedKinds,
+        usedMaterialKinds,
+    };
+}
+function collectUsed3DKinds(outKinds, outMaterialKinds, root) {
+    const stack = [root];
+    while (stack.length > 0) {
+        const current = stack.pop();
+        outKinds.add(current.kind);
+        if ('materials' in current) {
+            const materials = current.materials;
+            for (let i = 0; i < materials.length; i++) {
+                const mat = materials[i];
+                outMaterialKinds.add(mat !== null ? mat.kind : StandardMaterialKind);
+            }
+        }
+        const children = getNodeRuntime(current).children;
+        if (children !== null) {
+            for (let i = children.length - 1; i >= 0; i--) {
+                stack.push(children[i]);
+            }
+        }
+    }
+}
+//# sourceMappingURL=explainScene3DPipelineCoverage.js.map

package/dist/explainScene3DPipelineCoverage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explainScene3DPipelineCoverage.js","sourceRoot":"","sources":["../src/explainScene3DPipelineCoverage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AASnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEhE,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAEtD,qGAAqG;AACrG,0EAA0E;AAC1E,MAAM,UAAU,8BAA8B,CAC5C,KAAkB,EAClB,KAAwB,EACxB,iBAA0D;IAE1D,MAAM,WAAW,GAAG,IAAI,GAAG,EAAQ,CAAC;IACpC,MAAM,mBAAmB,GAAG,IAAI,GAAG,EAAQ,CAAC;IAC5C,kBAAkB,CAAC,WAAW,EAAE,mBAAmB,EAAE,KAAK,CAAC,CAAC;IAE5D,MAAM,eAAe,GAAW,EAAE,CAAC;IACnC,oBAAoB,CAAC,eAAe,EAAE,qBAAqB,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IACzF,eAAe,CAAC,IAAI,EAAE,CAAC;IAEvB,MAAM,uBAAuB,GAAW,EAAE,CAAC;IAC3C,IAAI,iBAAiB,KAAK,IAAI,EAAE,CAAC;QAC/B,oBAAoB,CAAC,uBAAuB,EAAE,iBAAiB,CAAC,CAAC;IACnE,CAAC;IACD,uBAAuB,CAAC,IAAI,EAAE,CAAC;IAE/B,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,CAAC;IACjD,MAAM,iBAAiB,GAAG,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,IAAI,EAAE,CAAC;IAEjE,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC,eAAe,CAAC,CAAC;IACnD,MAAM,yBAAyB,GAAG,IAAI,GAAG,CAAC,uBAAuB,CAAC,CAAC;IAEnE,MAAM,cAAc,GAAW,EAAE,CAAC;IAClC,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9D,CAAC;IAED,MAAM,mBAAmB,GAAW,EAAE,CAAC;IACvC,KAAK,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC;QACnC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7D,CAAC;IAED,MAAM,sBAAsB,GAAW,EAAE,CAAC;IAC1C,KAAK,MAAM,IAAI,IAAI,iBAAiB,EAAE,CAAC;QACrC,IAAI,CAAC,yBAAyB,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9E,CAAC;IAED,MAAM,2BAA2B,GAAW,EAAE,CAAC;IAC/C,KAAK,MAAM,IAAI,IAAI,uBAAuB,EAAE,CAAC;QAC3C,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,2BAA2B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7E,CAAC;IAED,OAAO;QACL,eAAe;QACf,uBAAuB;QACvB,cAAc;QACd,sBAAsB;QACtB,2BAA2B;QAC3B,mBAAmB;QACnB,SAAS;QACT,iBAAiB;KAClB,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,QAAmB,EAAE,gBAA2B,EAAE,IAAuB;IACnG,MAAM,KAAK,GAAwB,CAAC,IAAI,CAAC,CAAC;IAC1C,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,EAAG,CAAC;QAC7B,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC3B,IAAI,WAAW,IAAI,OAAO,EAAE,CAAC;YAC3B,MAAM,SAAS,GAAG,OAAO,CAAC,SAAgC,CAAC;YAC3D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC1C,MAAM,GAAG,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;gBACzB,gBAAgB,CAAC,GAAG,CAAC,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC;YACvE,CAAC;QACH,CAAC;QACD,MAAM,QAAQ,GAAG,cAAc,CAAC,OAAkB,CAAC,CAAC,QAAQ,CAAC;QAC7D,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtB,KAAK,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC9C,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -1,3 +1,3 @@
-export { areColorAdjustmentsEnabled, createRaster2DSurface, destroyRaster2DSurface, disableSceneRenderGuards, enableColorAdjustments, enableSceneRenderGuards, createRenderCache, destroyRenderState, disposeScene2DRender, enableRenderRegistryGuards, enableRenderRegistrySignals, explainRenderRegistryMisses, explainScene2DPipelineCoverage, packScene3DLightBlock, prepareScene2DRender, prepareScene3DRender, registerRenderer, useRenderCache, } from './contract';
+export { areColorAdjustmentsEnabled, createRaster2DSurface, destroyRaster2DSurface, disableSceneRenderGuards, enableColorAdjustments, enableSceneRenderGuards, createRenderCache, destroyRenderState, disposeScene2DRender, enableRenderRegistryGuards, enableRenderRegistrySignals, explainRenderRegistryMisses, explainScene2DPipelineCoverage, explainScene3DPipelineCoverage, packScene3DLightBlock, prepareScene2DRender, prepareScene3DRender, registerRenderer, useRenderCache, } from './contract';
 export { SCENE2D_WORKING_COLOR_SPACE } from './scene2dWorkingColorSpace';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,0BAA0B,EAC1B,2BAA2B,EAC3B,2BAA2B,EAC3B,8BAA8B,EAC9B,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,0BAA0B,EAC1B,2BAA2B,EAC3B,2BAA2B,EAC3B,8BAA8B,EAC9B,8BAA8B,EAC9B,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/index.js

@@ -1,3 +1,3 @@
-export { areColorAdjustmentsEnabled, createRaster2DSurface, destroyRaster2DSurface, disableSceneRenderGuards, enableColorAdjustments, enableSceneRenderGuards, createRenderCache, destroyRenderState, disposeScene2DRender, enableRenderRegistryGuards, enableRenderRegistrySignals, explainRenderRegistryMisses, explainScene2DPipelineCoverage, packScene3DLightBlock, prepareScene2DRender, prepareScene3DRender, registerRenderer, useRenderCache, } from './contract';
+export { areColorAdjustmentsEnabled, createRaster2DSurface, destroyRaster2DSurface, disableSceneRenderGuards, enableColorAdjustments, enableSceneRenderGuards, createRenderCache, destroyRenderState, disposeScene2DRender, enableRenderRegistryGuards, enableRenderRegistrySignals, explainRenderRegistryMisses, explainScene2DPipelineCoverage, explainScene3DPipelineCoverage, packScene3DLightBlock, prepareScene2DRender, prepareScene3DRender, registerRenderer, useRenderCache, } from './contract';
 export { SCENE2D_WORKING_COLOR_SPACE } from './scene2dWorkingColorSpace';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,0BAA0B,EAC1B,2BAA2B,EAC3B,2BAA2B,EAC3B,8BAA8B,EAC9B,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,0BAA0B,EAC1B,2BAA2B,EAC3B,2BAA2B,EAC3B,8BAA8B,EAC9B,8BAA8B,EAC9B,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flighthq/render",
-  "version": "0.5.1-next.1019.1274ec5",
+  "version": "0.5.1-next.1050.0bd43cc",
   "author": "Joshua Granick and other contributors",
   "license": "MIT",
   "repository": {
@@ -38,17 +38,17 @@
     "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
   },
   "dependencies": {
-    "@flighthq/adjustments": "0.5.1-next.1019.1274ec5",
-    "@flighthq/color": "0.5.1-next.1019.1274ec5",
-    "@flighthq/entity": "0.5.1-next.1019.1274ec5",
-    "@flighthq/geometry": "0.5.1-next.1019.1274ec5",
-    "@flighthq/log": "0.5.1-next.1019.1274ec5",
-    "@flighthq/materials": "0.5.1-next.1019.1274ec5",
-    "@flighthq/mesh": "0.5.1-next.1019.1274ec5",
-    "@flighthq/node": "0.5.1-next.1019.1274ec5",
-    "@flighthq/registry": "0.5.1-next.1019.1274ec5",
-    "@flighthq/signals": "0.5.1-next.1019.1274ec5",
-    "@flighthq/types": "0.5.1-next.1019.1274ec5"
+    "@flighthq/adjustments": "0.5.1-next.1050.0bd43cc",
+    "@flighthq/color": "0.5.1-next.1050.0bd43cc",
+    "@flighthq/entity": "0.5.1-next.1050.0bd43cc",
+    "@flighthq/geometry": "0.5.1-next.1050.0bd43cc",
+    "@flighthq/log": "0.5.1-next.1050.0bd43cc",
+    "@flighthq/materials": "0.5.1-next.1050.0bd43cc",
+    "@flighthq/mesh": "0.5.1-next.1050.0bd43cc",
+    "@flighthq/node": "0.5.1-next.1050.0bd43cc",
+    "@flighthq/registry": "0.5.1-next.1050.0bd43cc",
+    "@flighthq/signals": "0.5.1-next.1050.0bd43cc",
+    "@flighthq/types": "0.5.1-next.1050.0bd43cc"
   },
   "devDependencies": {
     "@flighthq/camera": "*",

package/src/explainScene3DPipelineCoverage.test.ts

@@ -0,0 +1,113 @@
+import { createMaterial } from '@flighthq/materials/contract';
+import { createBoxMeshGeometry } from '@flighthq/mesh/contract';
+import { addNodeChild } from '@flighthq/node/contract';
+import { createKeyedTable, withRegistryTableEntry } from '@flighthq/registry/contract';
+import { createMesh, createNode3D } from '@flighthq/scene3d/contract';
+import type { KeyedTable, Renderer } from '@flighthq/types/contract';
+import { Node3DKind, StandardMaterialKind } from '@flighthq/types/contract';
+import { describe, expect, it } from 'vitest';
+
+import { explainScene3DPipelineCoverage } from './explainScene3DPipelineCoverage';
+import { registerRenderer } from './renderer';
+import { createRenderState } from './renderState';
+
+const renderer: Renderer = { createData: () => null, submit: () => {} } as unknown as Renderer;
+
+function box() {
+  return createBoxMeshGeometry(1, 1, 1);
+}
+
+function materialTable(...kinds: string[]): KeyedTable<unknown> {
+  let table = createKeyedTable<unknown>('MaterialRenderer', 'Unregistered');
+  for (const kind of kinds) {
+    table = withRegistryTableEntry(table, kind, {});
+  }
+  return table;
+}
+
+describe('explainScene3DPipelineCoverage', () => {
+  it('reports StandardMaterial as used when a mesh has only null material slots', () => {
+    const state = createRenderState();
+    registerRenderer(state, 'Mesh', renderer);
+    const matTable = materialTable(StandardMaterialKind);
+    const root = createMesh(box(), [null]);
+    const result = explainScene3DPipelineCoverage(state, root, matTable);
+    expect(result.usedMaterialKinds).toEqual([StandardMaterialKind]);
+    expect(result.registeredMaterialKinds).toEqual([StandardMaterialKind]);
+    expect(result.uncoveredMaterialKinds).toEqual([]);
+    expect(result.unusedMaterialRegistrations).toEqual([]);
+  });
+
+  it('reports uncovered material kinds when a custom material has no registered renderer', () => {
+    const state = createRenderState();
+    registerRenderer(state, 'Mesh', renderer);
+    const matTable = materialTable(StandardMaterialKind);
+    const customMat = createMaterial('PhongMaterial');
+    const root = createMesh(box(), [customMat]);
+    const result = explainScene3DPipelineCoverage(state, root, matTable);
+    expect(result.usedMaterialKinds).toEqual(['PhongMaterial']);
+    expect(result.uncoveredMaterialKinds).toEqual(['PhongMaterial']);
+    expect(result.unusedMaterialRegistrations).toEqual([StandardMaterialKind]);
+  });
+
+  it('returns empty material dimension when materialRenderers is null', () => {
+    const state = createRenderState();
+    const root = createMesh(box(), [null]);
+    const result = explainScene3DPipelineCoverage(state, root, null);
+    expect(result.usedMaterialKinds).toEqual([StandardMaterialKind]);
+    expect(result.registeredMaterialKinds).toEqual([]);
+    expect(result.uncoveredMaterialKinds).toEqual([StandardMaterialKind]);
+    expect(result.unusedMaterialRegistrations).toEqual([]);
+  });
+
+  it('reports unused node registrations for an empty scene', () => {
+    const state = createRenderState();
+    registerRenderer(state, 'Mesh', renderer);
+    registerRenderer(state, 'InstancedMesh', renderer);
+    const matTable = materialTable(StandardMaterialKind);
+    const root = createNode3D(Node3DKind);
+    const result = explainScene3DPipelineCoverage(state, root, matTable);
+    expect(result.usedKinds).toEqual([Node3DKind]);
+    expect(result.uncoveredKinds).toEqual([Node3DKind]);
+    expect(result.unusedRegistrations).toEqual(['InstancedMesh', 'Mesh']);
+    expect(result.usedMaterialKinds).toEqual([]);
+    expect(result.unusedMaterialRegistrations).toEqual([StandardMaterialKind]);
+  });
+
+  it('collects both node and material kinds across a mixed scene tree', () => {
+    const state = createRenderState();
+    registerRenderer(state, 'Mesh', renderer);
+    registerRenderer(state, Node3DKind, renderer);
+    const matTable = materialTable(StandardMaterialKind, 'PhongMaterial');
+    const root = createNode3D(Node3DKind);
+    const child1 = createMesh(box(), [null]);
+    const child2 = createMesh(box(), [createMaterial('PhongMaterial')]);
+    addNodeChild(root, child1);
+    addNodeChild(root, child2);
+    const result = explainScene3DPipelineCoverage(state, root, matTable);
+    expect(result.usedKinds).toEqual(['Mesh', Node3DKind]);
+    expect(result.uncoveredKinds).toEqual([]);
+    expect(result.unusedRegistrations).toEqual([]);
+    expect(result.usedMaterialKinds).toEqual(['PhongMaterial', StandardMaterialKind]);
+    expect(result.uncoveredMaterialKinds).toEqual([]);
+    expect(result.unusedMaterialRegistrations).toEqual([]);
+  });
+
+  it('returns sorted, stable arrays for both dimensions', () => {
+    const state = createRenderState();
+    registerRenderer(state, 'Mesh', renderer);
+    registerRenderer(state, 'InstancedMesh', renderer);
+    registerRenderer(state, Node3DKind, renderer);
+    const matTable = materialTable('ZebraMaterial', 'AlphaMaterial', StandardMaterialKind);
+    const root = createNode3D(Node3DKind);
+    const child = createMesh(box(), [createMaterial('ZebraMaterial'), null]);
+    addNodeChild(root, child);
+    const result = explainScene3DPipelineCoverage(state, root, matTable);
+    expect(result.registeredKinds).toEqual(['InstancedMesh', 'Mesh', Node3DKind]);
+    expect(result.registeredMaterialKinds).toEqual(['AlphaMaterial', StandardMaterialKind, 'ZebraMaterial']);
+    expect(result.usedKinds).toEqual(['Mesh', Node3DKind]);
+    expect(result.usedMaterialKinds).toEqual([StandardMaterialKind, 'ZebraMaterial']);
+    expect(result.unusedRegistrations).toEqual(['InstancedMesh']);
+    expect(result.unusedMaterialRegistrations).toEqual(['AlphaMaterial']);
+  });
+});