@flighthq/scene3d-resources 0.3.0 → 0.3.1-next.1041.35b950c

package/dist/explainScene3DResourceCoverage.d.ts

@@ -1,4 +1,4 @@
-import type { SceneCoverageEntry, Scene3DKindUsage, Scene3DResourceResolver } from '@flighthq/types/contract';
-export declare function explainScene3DResourceCoverage(out: SceneCoverageEntry[], resolver: Readonly<Scene3DResourceResolver>, usage: Readonly<Scene3DKindUsage>): void;
+import type { Scene3DKindUsage, Scene3DResourceResolver, SceneCoverageCatalog, SceneCoverageEntry } from '@flighthq/types/contract';
+export declare function explainScene3DResourceCoverage(out: SceneCoverageEntry[], resolver: Readonly<Scene3DResourceResolver>, usage: Readonly<Scene3DKindUsage>, catalog: SceneCoverageCatalog): void;
 export declare function hasScene3DResourceCoverage(resolver: Readonly<Scene3DResourceResolver>, usage: Readonly<Scene3DKindUsage>): boolean;
 //# sourceMappingURL=explainScene3DResourceCoverage.d.ts.map

package/dist/explainScene3DResourceCoverage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"explainScene3DResourceCoverage.d.ts","sourceRoot":"","sources":["../src/explainScene3DResourceCoverage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAkB9G,wBAAgB,8BAA8B,CAC5C,GAAG,EAAE,kBAAkB,EAAE,EACzB,QAAQ,EAAE,QAAQ,CAAC,uBAAuB,CAAC,EAC3C,KAAK,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAChC,IAAI,CAGN;AAID,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,QAAQ,CAAC,uBAAuB,CAAC,EAC3C,KAAK,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAChC,OAAO,CAET"}
+{"version":3,"file":"explainScene3DResourceCoverage.d.ts","sourceRoot":"","sources":["../src/explainScene3DResourceCoverage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,gBAAgB,EAChB,uBAAuB,EACvB,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,0BAA0B,CAAC;AAoBlC,wBAAgB,8BAA8B,CAC5C,GAAG,EAAE,kBAAkB,EAAE,EACzB,QAAQ,EAAE,QAAQ,CAAC,uBAAuB,CAAC,EAC3C,KAAK,EAAE,QAAQ,CAAC,gBAAgB,CAAC,EACjC,OAAO,EAAE,oBAAoB,GAC5B,IAAI,CAGN;AAID,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,QAAQ,CAAC,uBAAuB,CAAC,EAC3C,KAAK,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAChC,OAAO,CAET"}

package/dist/explainScene3DResourceCoverage.js

@@ -1,42 +1,74 @@
-import { RenderRegistry, SceneCoverage } from '@flighthq/types/contract';
+import { RenderRegistry, RequirementFacet, SceneCoverage } from '@flighthq/types/contract';
 import { hasScene3DMaterialTextureLister } from './sceneMaterialTextureRegistry';
 // Clears `out`, then reports EVERY material kind in `usage` with how well this resolver describes it —
 // satisfied ones included, so one call is a complete manifest rather than only a list of complaints. The resource
 // layer's half of the scene↔consumer seam: @flighthq/scene3d says what a document uses, each holder of a
-// registry answers for its own. It reads the registry rather than a table of names, so it cannot go
-// stale against a registrar rename.
+// registry answers for its own. The verdict reads the live registry; `catalog`, the caller's complete
+// resource inventory, supplies the primary remedy only for a shortfall.
 //
 // Ask it after parsing and before loading, while the answer is still actionable.
 //
-// A gap here is always Missing, never Fallback: the registry has no default lister, so an unlisted kind
-// contributes nothing rather than something approximate. Note this no longer affects which images get
-// fetched — getScene3DResourceTextures reads the resource back-edge and is registry-free — so the cost
-// of a gap is confined to consumers that need mesh→texture ownership, chiefly the reveal-on-resolve
-// recipe, whose meshes would wait for an event that never names them.
-export function explainScene3DResourceCoverage(out, resolver, usage) {
+// A gap here is always a total absence, never a fallback: the registry has no default lister, so an unlisted kind
+// contributes nothing rather than something approximate. Image acquisition is unaffected because
+// getScene3DResourceTextures reads the resource back-edge without consulting this registry. Consumers
+// that need mesh→texture ownership see only listed families. When every material on a mesh is unlisted,
+// reveal-on-resolve leaves its starting alpha unchanged and installs no fade. When a listed sibling has
+// pending textures, the recipe hides the mesh but waits only for those listed textures; it can reveal the
+// mesh while an unlisted material's texture is still pending, so that texture may pop in later.
+export function explainScene3DResourceCoverage(out, resolver, usage, catalog) {
     out.length = 0;
-    collectScene3DResourceCoverageGaps(out, resolver, usage, false);
+    collectScene3DResourceCoverageGaps(out, resolver, usage, false, catalog);
 }
 // Whether this resolver can describe every material kind `usage` names. Stops at the first gap and
 // never allocates, so it is cheap enough to call per load. Use the explain form to find out WHICH kind.
 export function hasScene3DResourceCoverage(resolver, usage) {
-    return !collectScene3DResourceCoverageGaps(null, resolver, usage, true);
+    return !collectScene3DResourceCoverageGaps(null, resolver, usage, true, null);
 }
 // The single implementation both tiers read, so the boolean can never disagree with the explanation.
 // `found` counts only real shortfalls, so appending satisfied entries to `out` never flips the predicate.
-function collectScene3DResourceCoverageGaps(out, resolver, usage, stopAtFirst) {
+function collectScene3DResourceCoverageGaps(out, resolver, usage, stopAtFirst, catalog) {
     let found = false;
     for (let i = 0; i < usage.materialKinds.length; i++) {
         const kind = usage.materialKinds[i];
         if (hasScene3DMaterialTextureLister(resolver.registry, kind)) {
-            out?.push({ coverage: SceneCoverage.Satisfied, kind, registry: RenderRegistry.MaterialTextureLister });
+            out?.push({
+                coverage: SceneCoverage.Satisfied,
+                facet: RequirementFacet.SceneMaterialKind,
+                kind,
+                registry: RenderRegistry.MaterialTextureLister,
+            });
             continue;
         }
         found = true;
         if (stopAtFirst)
             return true;
-        out?.push({ coverage: SceneCoverage.Missing, kind, registry: RenderRegistry.MaterialTextureLister });
+        out?.push(createShortfallEntry(catalog, false, RequirementFacet.SceneMaterialKind, kind, RenderRegistry.MaterialTextureLister));
     }
     return found;
 }
+function createShortfallEntry(catalog, fallback, facet, kind, registry) {
+    const registration = findCatalogRegistration(catalog, kind, registry);
+    const base = { facet, kind, registry };
+    if (registration === null) {
+        return {
+            ...base,
+            coverage: fallback ? SceneCoverage.FallbackUnavailable : SceneCoverage.Unavailable,
+        };
+    }
+    return {
+        ...base,
+        coverage: fallback ? SceneCoverage.FallbackRemediable : SceneCoverage.Unregistered,
+        module: registration.module,
+        registrar: registration.registrar,
+    };
+}
+function findCatalogRegistration(catalog, kind, registry) {
+    if (catalog === null)
+        return null;
+    for (const entry of catalog) {
+        if (entry.kind === kind && entry.registry === registry)
+            return entry.registrations[0] ?? null;
+    }
+    return null;
+}
 //# sourceMappingURL=explainScene3DResourceCoverage.js.map

package/dist/explainScene3DResourceCoverage.js.map

@@ -1 +1 @@
-{"version":3,"file":"explainScene3DResourceCoverage.js","sourceRoot":"","sources":["../src/explainScene3DResourceCoverage.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzE,OAAO,EAAE,+BAA+B,EAAE,MAAM,gCAAgC,CAAC;AAEjF,uGAAuG;AACvG,kHAAkH;AAClH,yGAAyG;AACzG,oGAAoG;AACpG,oCAAoC;AACpC,EAAE;AACF,iFAAiF;AACjF,EAAE;AACF,wGAAwG;AACxG,sGAAsG;AACtG,uGAAuG;AACvG,oGAAoG;AACpG,sEAAsE;AACtE,MAAM,UAAU,8BAA8B,CAC5C,GAAyB,EACzB,QAA2C,EAC3C,KAAiC;IAEjC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC;IACf,kCAAkC,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;AAClE,CAAC;AAED,mGAAmG;AACnG,wGAAwG;AACxG,MAAM,UAAU,0BAA0B,CACxC,QAA2C,EAC3C,KAAiC;IAEjC,OAAO,CAAC,kCAAkC,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;AAC1E,CAAC;AAED,qGAAqG;AACrG,0GAA0G;AAC1G,SAAS,kCAAkC,CACzC,GAAgC,EAChC,QAA2C,EAC3C,KAAiC,EACjC,WAAoB;IAEpB,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpD,MAAM,IAAI,GAAG,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;QACpC,IAAI,+BAA+B,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,CAAC;YAC7D,GAAG,EAAE,IAAI,CAAC,EAAE,QAAQ,EAAE,aAAa,CAAC,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,cAAc,CAAC,qBAAqB,EAAE,CAAC,CAAC;YACvG,SAAS;QACX,CAAC;QACD,KAAK,GAAG,IAAI,CAAC;QACb,IAAI,WAAW;YAAE,OAAO,IAAI,CAAC;QAC7B,GAAG,EAAE,IAAI,CAAC,EAAE,QAAQ,EAAE,aAAa,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,cAAc,CAAC,qBAAqB,EAAE,CAAC,CAAC;IACvG,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"explainScene3DResourceCoverage.js","sourceRoot":"","sources":["../src/explainScene3DResourceCoverage.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE3F,OAAO,EAAE,+BAA+B,EAAE,MAAM,gCAAgC,CAAC;AAEjF,uGAAuG;AACvG,kHAAkH;AAClH,yGAAyG;AACzG,sGAAsG;AACtG,wEAAwE;AACxE,EAAE;AACF,iFAAiF;AACjF,EAAE;AACF,kHAAkH;AAClH,iGAAiG;AACjG,sGAAsG;AACtG,wGAAwG;AACxG,wGAAwG;AACxG,0GAA0G;AAC1G,gGAAgG;AAChG,MAAM,UAAU,8BAA8B,CAC5C,GAAyB,EACzB,QAA2C,EAC3C,KAAiC,EACjC,OAA6B;IAE7B,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC;IACf,kCAAkC,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;AAC3E,CAAC;AAED,mGAAmG;AACnG,wGAAwG;AACxG,MAAM,UAAU,0BAA0B,CACxC,QAA2C,EAC3C,KAAiC;IAEjC,OAAO,CAAC,kCAAkC,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAChF,CAAC;AAED,qGAAqG;AACrG,0GAA0G;AAC1G,SAAS,kCAAkC,CACzC,GAAgC,EAChC,QAA2C,EAC3C,KAAiC,EACjC,WAAoB,EACpB,OAAoC;IAEpC,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpD,MAAM,IAAI,GAAG,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;QACpC,IAAI,+BAA+B,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,CAAC;YAC7D,GAAG,EAAE,IAAI,CAAC;gBACR,QAAQ,EAAE,aAAa,CAAC,SAAS;gBACjC,KAAK,EAAE,gBAAgB,CAAC,iBAAiB;gBACzC,IAAI;gBACJ,QAAQ,EAAE,cAAc,CAAC,qBAAqB;aAC/C,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QACD,KAAK,GAAG,IAAI,CAAC;QACb,IAAI,WAAW;YAAE,OAAO,IAAI,CAAC;QAC7B,GAAG,EAAE,IAAI,CACP,oBAAoB,CAClB,OAAO,EACP,KAAK,EACL,gBAAgB,CAAC,iBAAiB,EAClC,IAAI,EACJ,cAAc,CAAC,qBAAqB,CACrC,CACF,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,oBAAoB,CAC3B,OAAoC,EACpC,QAAiB,EACjB,KAAkC,EAClC,IAAU,EACV,QAAwC;IAExC,MAAM,YAAY,GAAG,uBAAuB,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;IACtE,MAAM,IAAI,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IACvC,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;QAC1B,OAAO;YACL,GAAG,IAAI;YACP,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,mBAAmB,CAAC,CAAC,CAAC,aAAa,CAAC,WAAW;SACnF,CAAC;IACJ,CAAC;IACD,OAAO;QACL,GAAG,IAAI;QACP,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,kBAAkB,CAAC,CAAC,CAAC,aAAa,CAAC,YAAY;QAClF,MAAM,EAAE,YAAY,CAAC,MAAM;QAC3B,SAAS,EAAE,YAAY,CAAC,SAAS;KAClC,CAAC;AACJ,CAAC;AAED,SAAS,uBAAuB,CAC9B,OAAoC,EACpC,IAAU,EACV,QAAwC;IAExC,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAClC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,IAAI,KAAK,CAAC,QAAQ,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;IAChG,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-export { areScene3DResourceFailureGuardsEnabled, createBuiltInScene3DResourceResolver, createScene3DResourceResolver, disableScene3DResourceFailureGuards, disposeScene3DResourceResolver, enableScene3DResourceFailureGuards, enableScene3DResourceSignals, fetchWebImageResource, getScene3DDocumentBasePathFromUrl, getScene3DResourceSignals, getScene3DResourceTextures, loadScene3DDocumentBytesFromUrl, loadScene3DDocumentFrom3dsUrl, loadScene3DDocumentFromAwd2Url, loadScene3DDocumentFromGlbUrl, loadScene3DDocumentFromGltfUrl, loadScene3DDocumentFromMd2Url, loadScene3DDocumentFromMd5MeshUrl, loadScene3DDocumentFromObjUrl, loadScene3DDocumentTextFromUrl, loadScene3DResources, resolveImageResourceUri, resolveOneScene3DResourceTexture, resolveScene3DResources, retryFailedScene3DResources, revealScene3DResourcesOnResolve, setScene3DDocumentResourceBasePathFromUrl, updateScene3DResourceStreaming, waitForScene3DResourceResolver, } from './contract';
+export { areScene3DResourceFailureGuardsEnabled, createBuiltInScene3DResourceResolver, createScene3DResourceResolver, disableScene3DResourceFailureGuards, disposeScene3DResourceResolver, enableScene3DResourceFailureGuards, enableScene3DResourceSignals, explainScene3DResourceCoverage, fetchWebImageResource, getScene3DDocumentBasePathFromUrl, getScene3DResourceSignals, getScene3DResourceTextures, loadScene3DDocumentBytesFromUrl, loadScene3DDocumentFrom3dsUrl, loadScene3DDocumentFromAwd2Url, loadScene3DDocumentFromGlbUrl, loadScene3DDocumentFromGltfUrl, loadScene3DDocumentFromMd2Url, loadScene3DDocumentFromMd5MeshUrl, loadScene3DDocumentFromObjUrl, loadScene3DDocumentTextFromUrl, loadScene3DResources, resolveImageResourceUri, resolveOneScene3DResourceTexture, resolveScene3DResources, retryFailedScene3DResources, revealScene3DResourcesOnResolve, setScene3DDocumentResourceBasePathFromUrl, updateScene3DResourceStreaming, waitForScene3DResourceResolver, } from './contract';
 //# 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,sCAAsC,EACtC,oCAAoC,EACpC,6BAA6B,EAC7B,mCAAmC,EACnC,8BAA8B,EAC9B,kCAAkC,EAClC,4BAA4B,EAC5B,qBAAqB,EACrB,iCAAiC,EACjC,yBAAyB,EACzB,0BAA0B,EAC1B,+BAA+B,EAC/B,6BAA6B,EAC7B,8BAA8B,EAC9B,6BAA6B,EAC7B,8BAA8B,EAC9B,6BAA6B,EAC7B,iCAAiC,EACjC,6BAA6B,EAC7B,8BAA8B,EAC9B,oBAAoB,EACpB,uBAAuB,EACvB,gCAAgC,EAChC,uBAAuB,EACvB,2BAA2B,EAC3B,+BAA+B,EAC/B,yCAAyC,EACzC,8BAA8B,EAC9B,8BAA8B,GAC/B,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sCAAsC,EACtC,oCAAoC,EACpC,6BAA6B,EAC7B,mCAAmC,EACnC,8BAA8B,EAC9B,kCAAkC,EAClC,4BAA4B,EAC5B,8BAA8B,EAC9B,qBAAqB,EACrB,iCAAiC,EACjC,yBAAyB,EACzB,0BAA0B,EAC1B,+BAA+B,EAC/B,6BAA6B,EAC7B,8BAA8B,EAC9B,6BAA6B,EAC7B,8BAA8B,EAC9B,6BAA6B,EAC7B,iCAAiC,EACjC,6BAA6B,EAC7B,8BAA8B,EAC9B,oBAAoB,EACpB,uBAAuB,EACvB,gCAAgC,EAChC,uBAAuB,EACvB,2BAA2B,EAC3B,+BAA+B,EAC/B,yCAAyC,EACzC,8BAA8B,EAC9B,8BAA8B,GAC/B,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,2 +1,2 @@
-export { areScene3DResourceFailureGuardsEnabled, createBuiltInScene3DResourceResolver, createScene3DResourceResolver, disableScene3DResourceFailureGuards, disposeScene3DResourceResolver, enableScene3DResourceFailureGuards, enableScene3DResourceSignals, fetchWebImageResource, getScene3DDocumentBasePathFromUrl, getScene3DResourceSignals, getScene3DResourceTextures, loadScene3DDocumentBytesFromUrl, loadScene3DDocumentFrom3dsUrl, loadScene3DDocumentFromAwd2Url, loadScene3DDocumentFromGlbUrl, loadScene3DDocumentFromGltfUrl, loadScene3DDocumentFromMd2Url, loadScene3DDocumentFromMd5MeshUrl, loadScene3DDocumentFromObjUrl, loadScene3DDocumentTextFromUrl, loadScene3DResources, resolveImageResourceUri, resolveOneScene3DResourceTexture, resolveScene3DResources, retryFailedScene3DResources, revealScene3DResourcesOnResolve, setScene3DDocumentResourceBasePathFromUrl, updateScene3DResourceStreaming, waitForScene3DResourceResolver, } from './contract';
+export { areScene3DResourceFailureGuardsEnabled, createBuiltInScene3DResourceResolver, createScene3DResourceResolver, disableScene3DResourceFailureGuards, disposeScene3DResourceResolver, enableScene3DResourceFailureGuards, enableScene3DResourceSignals, explainScene3DResourceCoverage, fetchWebImageResource, getScene3DDocumentBasePathFromUrl, getScene3DResourceSignals, getScene3DResourceTextures, loadScene3DDocumentBytesFromUrl, loadScene3DDocumentFrom3dsUrl, loadScene3DDocumentFromAwd2Url, loadScene3DDocumentFromGlbUrl, loadScene3DDocumentFromGltfUrl, loadScene3DDocumentFromMd2Url, loadScene3DDocumentFromMd5MeshUrl, loadScene3DDocumentFromObjUrl, loadScene3DDocumentTextFromUrl, loadScene3DResources, resolveImageResourceUri, resolveOneScene3DResourceTexture, resolveScene3DResources, retryFailedScene3DResources, revealScene3DResourcesOnResolve, setScene3DDocumentResourceBasePathFromUrl, updateScene3DResourceStreaming, waitForScene3DResourceResolver, } from './contract';
 //# 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,sCAAsC,EACtC,oCAAoC,EACpC,6BAA6B,EAC7B,mCAAmC,EACnC,8BAA8B,EAC9B,kCAAkC,EAClC,4BAA4B,EAC5B,qBAAqB,EACrB,iCAAiC,EACjC,yBAAyB,EACzB,0BAA0B,EAC1B,+BAA+B,EAC/B,6BAA6B,EAC7B,8BAA8B,EAC9B,6BAA6B,EAC7B,8BAA8B,EAC9B,6BAA6B,EAC7B,iCAAiC,EACjC,6BAA6B,EAC7B,8BAA8B,EAC9B,oBAAoB,EACpB,uBAAuB,EACvB,gCAAgC,EAChC,uBAAuB,EACvB,2BAA2B,EAC3B,+BAA+B,EAC/B,yCAAyC,EACzC,8BAA8B,EAC9B,8BAA8B,GAC/B,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sCAAsC,EACtC,oCAAoC,EACpC,6BAA6B,EAC7B,mCAAmC,EACnC,8BAA8B,EAC9B,kCAAkC,EAClC,4BAA4B,EAC5B,8BAA8B,EAC9B,qBAAqB,EACrB,iCAAiC,EACjC,yBAAyB,EACzB,0BAA0B,EAC1B,+BAA+B,EAC/B,6BAA6B,EAC7B,8BAA8B,EAC9B,6BAA6B,EAC7B,8BAA8B,EAC9B,6BAA6B,EAC7B,iCAAiC,EACjC,6BAA6B,EAC7B,8BAA8B,EAC9B,oBAAoB,EACpB,uBAAuB,EACvB,gCAAgC,EAChC,uBAAuB,EACvB,2BAA2B,EAC3B,+BAA+B,EAC/B,yCAAyC,EACzC,8BAA8B,EAC9B,8BAA8B,GAC/B,MAAM,YAAY,CAAC"}

package/dist/resolveScene3DResources.d.ts

@@ -1,5 +1,5 @@
-import type { Image, Scene3D, ImageResourceReference, ResolveScene3DResourcesOptions, Scene3DResources, Scene3DResourceResolver, UpdateScene3DResourceStreamingOptions } from '@flighthq/types/contract';
-export declare function resolveOneScene3DResourceTexture(resolver: Readonly<Scene3DResourceResolver>, ref: Readonly<ImageResourceReference>, signal: AbortSignal): Promise<Image | null>;
+import type { ImageResourceReference, ResolveScene3DResourcesOptions, Scene3D, Scene3DResources, Scene3DResourceResolver, TextureSource, UpdateScene3DResourceStreamingOptions } from '@flighthq/types/contract';
+export declare function resolveOneScene3DResourceTexture(resolver: Readonly<Scene3DResourceResolver>, ref: ImageResourceReference, signal: AbortSignal): Promise<TextureSource | null>;
 export declare function resolveScene3DResources(scene: Readonly<Scene3D>, resolver: Scene3DResourceResolver, options?: Readonly<ResolveScene3DResourcesOptions>): Scene3DResources;
 export declare function updateScene3DResourceStreaming(scene: Readonly<Scene3D>, resolver: Scene3DResourceResolver, options?: Readonly<UpdateScene3DResourceStreamingOptions>): Scene3DResources;
 //# sourceMappingURL=resolveScene3DResources.d.ts.map

package/dist/resolveScene3DResources.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolveScene3DResources.d.ts","sourceRoot":"","sources":["../src/resolveScene3DResources.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,KAAK,EACL,OAAO,EACP,sBAAsB,EACtB,8BAA8B,EAC9B,gBAAgB,EAChB,uBAAuB,EAGvB,qCAAqC,EACtC,MAAM,0BAA0B,CAAC;AAelC,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,QAAQ,CAAC,uBAAuB,CAAC,EAC3C,GAAG,EAAE,QAAQ,CAAC,sBAAsB,CAAC,EACrC,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAKvB;AAMD,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,EACxB,QAAQ,EAAE,uBAAuB,EACjC,OAAO,CAAC,EAAE,QAAQ,CAAC,8BAA8B,CAAC,GACjD,gBAAgB,CA0ClB;AAID,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,EACxB,QAAQ,EAAE,uBAAuB,EACjC,OAAO,CAAC,EAAE,QAAQ,CAAC,qCAAqC,CAAC,GACxD,gBAAgB,CAQlB"}
+{"version":3,"file":"resolveScene3DResources.d.ts","sourceRoot":"","sources":["../src/resolveScene3DResources.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,sBAAsB,EACtB,8BAA8B,EAC9B,OAAO,EACP,gBAAgB,EAChB,uBAAuB,EAGvB,aAAa,EACb,qCAAqC,EACtC,MAAM,0BAA0B,CAAC;AAUlC,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,QAAQ,CAAC,uBAAuB,CAAC,EAC3C,GAAG,EAAE,sBAAsB,EAC3B,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAE/B;AAMD,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,EACxB,QAAQ,EAAE,uBAAuB,EACjC,OAAO,CAAC,EAAE,QAAQ,CAAC,8BAA8B,CAAC,GACjD,gBAAgB,CA0ClB;AAID,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,EACxB,QAAQ,EAAE,uBAAuB,EACjC,OAAO,CAAC,EAAE,QAAQ,CAAC,qCAAqC,CAAC,GACxD,gBAAgB,CAQlB"}

package/dist/resolveScene3DResources.js

@@ -1,20 +1,17 @@
-import { createImageResourceFailure, loadImageResourceFromBytes } from '@flighthq/image/contract';
+import { createImageResourceFailure, resolveImageResourceReference } from '@flighthq/image/contract';
 import { queueResourceLoad } from '@flighthq/loader/contract';
 import { emitSignal } from '@flighthq/signals/contract';
-import { ImageResourceFailureKind, ImageTextureSourceKind, ResourceResolutionState, ImageResourceReferenceKind, } from '@flighthq/types/contract';
+import { ImageResourceFailureKind, ResourceResolutionState } from '@flighthq/types/contract';
 import { Scene3DResourceResolverRuntimeKey } from '@flighthq/types/contract';
 import { getScene3DResourceTextures, getScene3DTextureResourceReference } from './getScene3DResourceTextures';
-// Resolves one texture's ref to an Image (or null for an expected failure): Embedded bytes
+// Resolves one texture's ref to a TextureSource (or null for an expected failure): Embedded bytes
 // decode through @flighthq/image; External URIs go through the resolver's fetch seam. Cancellation is
 // carried by `signal` (both paths reject on abort). Exported for direct testing of the two ref kinds.
 export function resolveOneScene3DResourceTexture(resolver, ref, signal) {
-    if (ref.kind === ImageResourceReferenceKind.Embedded) {
-        return loadImageResourceFromBytes(ref.bytes, ref.mimeType ?? undefined, signal);
-    }
-    return resolver.fetch(ref, signal);
+    return resolveImageResourceReference(ref, resolver.fetch, signal);
 }
 // Reconciles the selected working set entirely synchronously. It groups shared references, recognizes
-// content already present on a texture, and binds resolver-cached images to every selected subscriber.
+// content already present on a texture, and binds resolver-cached sources to every selected subscriber.
 // Acquisition, cancellation, Promise scheduling, and priority policy belong to the explicit update/load
 // operations.
 export function resolveScene3DResources(scene, resolver, options) {
@@ -27,9 +24,9 @@ export function resolveScene3DResources(scene, resolver, options) {
         const ref = getScene3DTextureResourceReference(scene, texture);
         if (ref == null)
             continue;
-        const image = texture.dimension === '2d' ? texture.source : null;
-        if (image?.kind === ImageTextureSourceKind) {
-            runtime.resolved.set(ref, image);
+        const source = texture.dimension === '2d' ? texture.source : null;
+        if (source !== null) {
+            runtime.resolved.set(ref, source);
             ref.failure = null;
             ref.state = ResourceResolutionState.Resolved;
         }
@@ -45,8 +42,8 @@ export function resolveScene3DResources(scene, resolver, options) {
     const resolved = [];
     const unresolved = [];
     for (const [ref, subscribers] of working) {
-        const image = runtime.resolved.get(ref);
-        if (image === undefined) {
+        const source = runtime.resolved.get(ref);
+        if (source === undefined) {
             if (ref.state === ResourceResolutionState.Resolved)
                 ref.state = ResourceResolutionState.Unresolved;
             unresolved.push({ ref, textures: subscribers });
@@ -55,9 +52,9 @@ export function resolveScene3DResources(scene, resolver, options) {
         ref.failure = null;
         ref.state = ResourceResolutionState.Resolved;
         for (let i = 0; i < subscribers.length; i++) {
-            bindResolvedScene3DResource(resolver, subscribers[i], ref, image);
+            bindResolvedScene3DResource(resolver, subscribers[i], ref, source);
         }
-        resolved.push({ image, ref, textures: subscribers });
+        resolved.push({ ref, source, textures: subscribers });
     }
     return { resolved, scene, unresolved };
 }
@@ -95,16 +92,16 @@ function cancelDroppedResolutions(resolver, working) {
         }
     }
 }
-function finishScene3DResourceResolution(resolver, ref, entry, image) {
+function finishScene3DResourceResolution(resolver, ref, entry, source) {
     const runtime = resolver[Scene3DResourceResolverRuntimeKey];
     // Ignore a late settle whose entry was already cancelled or replaced by a newer request.
     if (runtime.inFlight.get(ref) !== entry)
         return;
     runtime.inFlight.delete(ref);
-    if (image === null) {
-        ref.failure = {
+    if (source === null) {
+        ref.failure ??= {
             kind: ImageResourceFailureKind.Unavailable,
-            message: 'Image resource resolution returned no image',
+            message: 'Image resource resolution returned no source',
             name: null,
         };
         ref.state = ResourceResolutionState.Failed;
@@ -112,11 +109,11 @@ function finishScene3DResourceResolution(resolver, ref, entry, image) {
             emitScene3DResourceEvent(resolver, texture, ref, false);
         return;
     }
-    runtime.resolved.set(ref, image);
+    runtime.resolved.set(ref, source);
     ref.failure = null;
     ref.state = ResourceResolutionState.Resolved;
     for (const texture of entry.subscribers)
-        bindResolvedScene3DResource(resolver, texture, ref, image);
+        bindResolvedScene3DResource(resolver, texture, ref, source);
 }
 function failScene3DResourceResolution(resolver, ref, entry, cause) {
     const runtime = resolver[Scene3DResourceResolverRuntimeKey];
@@ -131,12 +128,12 @@ function failScene3DResourceResolution(resolver, ref, entry, cause) {
     for (const texture of entry.subscribers)
         emitScene3DResourceEvent(resolver, texture, ref, false);
 }
-function bindResolvedScene3DResource(resolver, texture, ref, image) {
+function bindResolvedScene3DResource(resolver, texture, ref, source) {
     if (texture.dimension !== '2d')
         return;
-    if (texture.source === image)
+    if (texture.source === source)
         return;
-    texture.source = image;
+    texture.source = source;
     texture.version = (texture.version + 1) >>> 0;
     emitScene3DResourceEvent(resolver, texture, ref, true);
 }
@@ -191,7 +188,7 @@ function requestWorkingResolutions(resolver, working, options) {
             promise: _resolvedVoid,
             subscribers: new Set(subscribers),
         };
-        entry.promise = handle.promise.then((image) => finishScene3DResourceResolution(resolver, ref, entry, image), (cause) => failScene3DResourceResolution(resolver, ref, entry, cause));
+        entry.promise = handle.promise.then((source) => finishScene3DResourceResolution(resolver, ref, entry, source), (cause) => failScene3DResourceResolution(resolver, ref, entry, cause));
         runtime.inFlight.set(ref, entry);
     }
 }

package/dist/resolveScene3DResources.js.map

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

package/dist/shadedScene3DMaterialTextures.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shadedScene3DMaterialTextures.d.ts","sourceRoot":"","sources":["../src/shadedScene3DMaterialTextures.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,8BAA8B,EAAkB,MAAM,0BAA0B,CAAC;AAqB/F,wBAAgB,qCAAqC,CAAC,QAAQ,EAAE,8BAA8B,GAAG,IAAI,CAOpG"}
+{"version":3,"file":"shadedScene3DMaterialTextures.d.ts","sourceRoot":"","sources":["../src/shadedScene3DMaterialTextures.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,8BAA8B,EAAkB,MAAM,0BAA0B,CAAC;AAoB/F,wBAAgB,qCAAqC,CAAC,QAAQ,EAAE,8BAA8B,GAAG,IAAI,CAOpG"}

package/dist/shadedScene3DMaterialTextures.js

@@ -3,14 +3,13 @@ import { registerScene3DMaterialTextures } from './sceneMaterialTextureRegistry'
 // Lists the ShadedMaterial base maps. Registered separately from the surface-material listers'
 // PBR/unlit set so an app that never uses the shaded base pays nothing for it.
 //
-// Registering it is an optimization, not a prerequisite: resolution falls back to every resource-backed
-// texture when a material kind has no lister (see getScene3DResourceTextures), so the cost of omitting
-// it is a texture fetched that no mesh-attached material needed — not an unresolved map. It IS a
-// prerequisite for revealScene3DResourcesOnResolve, which needs texture→owning-node and has no other
-// way to get it; without the lister a ShadedMaterial node is simply never faded in.
+// Registration is a prerequisite for revealScene3DResourcesOnResolve to wait for these maps. Without the
+// lister, an all-unlisted mesh keeps its starting alpha and gets no fade. A mixed mesh with a listed
+// material carrying pending textures is hidden, but it can reveal when only those listed textures settle
+// while a ShadedMaterial map is still pending, so the shaded map may pop in later.
 //
-// `getScene3DRequirements` reports this registration for every material kind in a document that carries
-// image resources, which is how a caller finds it without knowing the registry exists.
+// The requirement-set successor is documented in agents/registration-lifecycle.md; see its status header
+// for the program authorization this registration builds under.
 //
 // The base maps only. A modifier in `material.modifiers` may carry its own textures (AnimatedNormal,
 // VertexDisplace, Dissolve, Emissive), and those need a per-modifier lister registry of their own — the

package/dist/shadedScene3DMaterialTextures.js.map

@@ -1 +1 @@
-{"version":3,"file":"shadedScene3DMaterialTextures.js","sourceRoot":"","sources":["../src/shadedScene3DMaterialTextures.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,OAAO,EAAE,+BAA+B,EAAE,MAAM,gCAAgC,CAAC;AAEjF,+FAA+F;AAC/F,+EAA+E;AAC/E,EAAE;AACF,wGAAwG;AACxG,uGAAuG;AACvG,iGAAiG;AACjG,qGAAqG;AACrG,oFAAoF;AACpF,EAAE;AACF,wGAAwG;AACxG,uFAAuF;AACvF,EAAE;AACF,qGAAqG;AACrG,wGAAwG;AACxG,oGAAoG;AACpG,iDAAiD;AACjD,MAAM,UAAU,qCAAqC,CAAC,QAAwC;IAC5F,+BAA+B,CAAC,QAAQ,EAAE,kBAAkB,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAQ,EAAE;QACpF,MAAM,MAAM,GAAG,QAAoC,CAAC;QACpD,IAAI,MAAM,CAAC,UAAU,KAAK,IAAI;YAAE,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC5D,IAAI,MAAM,CAAC,SAAS,KAAK,IAAI;YAAE,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC1D,IAAI,MAAM,CAAC,WAAW,KAAK,IAAI;YAAE,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"shadedScene3DMaterialTextures.js","sourceRoot":"","sources":["../src/shadedScene3DMaterialTextures.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,OAAO,EAAE,+BAA+B,EAAE,MAAM,gCAAgC,CAAC;AAEjF,+FAA+F;AAC/F,+EAA+E;AAC/E,EAAE;AACF,yGAAyG;AACzG,qGAAqG;AACrG,yGAAyG;AACzG,mFAAmF;AACnF,EAAE;AACF,yGAAyG;AACzG,gEAAgE;AAChE,EAAE;AACF,qGAAqG;AACrG,wGAAwG;AACxG,oGAAoG;AACpG,iDAAiD;AACjD,MAAM,UAAU,qCAAqC,CAAC,QAAwC;IAC5F,+BAA+B,CAAC,QAAQ,EAAE,kBAAkB,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAQ,EAAE;QACpF,MAAM,MAAM,GAAG,QAAoC,CAAC;QACpD,IAAI,MAAM,CAAC,UAAU,KAAK,IAAI;YAAE,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC5D,IAAI,MAAM,CAAC,SAAS,KAAK,IAAI;YAAE,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC1D,IAAI,MAAM,CAAC,WAAW,KAAK,IAAI;YAAE,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flighthq/scene3d-resources",
-  "version": "0.3.0",
+  "version": "0.3.1-next.1041.35b950c",
   "author": "Joshua Granick and other contributors",
   "license": "MIT",
   "repository": {
@@ -38,18 +38,18 @@
     "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
   },
   "dependencies": {
-    "@flighthq/entity": "0.3.0",
-    "@flighthq/image": "0.3.0",
-    "@flighthq/loader": "0.3.0",
-    "@flighthq/log": "0.3.0",
-    "@flighthq/net": "0.3.0",
-    "@flighthq/node": "0.3.0",
-    "@flighthq/scene3d": "0.3.0",
-    "@flighthq/scene3d-formats": "0.3.0",
-    "@flighthq/signals": "0.3.0",
-    "@flighthq/texture": "0.3.0",
-    "@flighthq/tween": "0.3.0",
-    "@flighthq/types": "0.3.0"
+    "@flighthq/entity": "0.3.1-next.1041.35b950c",
+    "@flighthq/image": "0.3.1-next.1041.35b950c",
+    "@flighthq/loader": "0.3.1-next.1041.35b950c",
+    "@flighthq/log": "0.3.1-next.1041.35b950c",
+    "@flighthq/net": "0.3.1-next.1041.35b950c",
+    "@flighthq/node": "0.3.1-next.1041.35b950c",
+    "@flighthq/scene3d": "0.3.1-next.1041.35b950c",
+    "@flighthq/scene3d-formats": "0.3.1-next.1041.35b950c",
+    "@flighthq/signals": "0.3.1-next.1041.35b950c",
+    "@flighthq/texture": "0.3.1-next.1041.35b950c",
+    "@flighthq/tween": "0.3.1-next.1041.35b950c",
+    "@flighthq/types": "0.3.1-next.1041.35b950c"
   },
   "devDependencies": {
     "@flighthq/materials": "*",

package/src/explainScene3DResourceCoverage.test.ts

@@ -3,14 +3,27 @@ import { createBoxMeshGeometry } from '@flighthq/mesh/contract';
 import { addNodeChild } from '@flighthq/node/contract';
 import { createMesh, createScene3D, createScene3DKindUsage, getScene3DKindUsage } from '@flighthq/scene3d/contract';
 import { createShadedMaterial } from '@flighthq/shading/contract';
-import type { Material, SceneCoverageEntry, Scene3DKindUsage } from '@flighthq/types/contract';
-import { RenderRegistry, SceneCoverage } from '@flighthq/types/contract';
+import type { Material, Scene3DKindUsage, SceneCoverageCatalog, SceneCoverageEntry } from '@flighthq/types/contract';
+import { RenderRegistry, RequirementFacet, SceneCoverage } from '@flighthq/types/contract';
 import { describe, expect, it } from 'vitest';
 
 import { explainScene3DResourceCoverage, hasScene3DResourceCoverage } from './explainScene3DResourceCoverage';
 import { createBuiltInScene3DResourceResolver, createScene3DResourceResolver } from './sceneResourceResolver';
 import { registerShadedScene3DMaterialTextures } from './shadedScene3DMaterialTextures';
 
+const coverageCatalog: SceneCoverageCatalog = [
+  {
+    kind: 'UnlitMaterial',
+    registrations: [{ module: '@flighthq/scene3d-resources', registrar: 'registerUnlitScene3DMaterialTextures' }],
+    registry: RenderRegistry.MaterialTextureLister,
+  },
+  {
+    kind: 'ShadedMaterial',
+    registrations: [{ module: '@flighthq/scene3d-resources', registrar: 'registerShadedScene3DMaterialTextures' }],
+    registry: RenderRegistry.MaterialTextureLister,
+  },
+];
+
 function usageOf(...materials: Material[]): Scene3DKindUsage {
   const scene = createScene3D();
   for (const material of materials) {
@@ -21,17 +34,28 @@ function usageOf(...materials: Material[]): Scene3DKindUsage {
   return usage;
 }
 
-function gaps(resolver: Parameters<typeof explainScene3DResourceCoverage>[1], usage: Scene3DKindUsage) {
+function gaps(
+  resolver: Parameters<typeof explainScene3DResourceCoverage>[1],
+  usage: Scene3DKindUsage,
+  catalog: SceneCoverageCatalog = coverageCatalog,
+) {
   const out: SceneCoverageEntry[] = [];
-  explainScene3DResourceCoverage(out, resolver, usage);
+  explainScene3DResourceCoverage(out, resolver, usage, catalog);
   return out;
 }
 
 describe('explainScene3DResourceCoverage', () => {
-  it('reports a bare resolver as missing every material kind, since its registry starts empty', () => {
+  it('reports a bare resolver with the call that registers the material lister', () => {
     const found = gaps(createScene3DResourceResolver(), usageOf(createUnlitMaterial()));
     expect(found).toEqual([
-      { coverage: SceneCoverage.Missing, kind: 'UnlitMaterial', registry: RenderRegistry.MaterialTextureLister },
+      {
+        coverage: SceneCoverage.Unregistered,
+        facet: RequirementFacet.SceneMaterialKind,
+        kind: 'UnlitMaterial',
+        module: '@flighthq/scene3d-resources',
+        registrar: 'registerUnlitScene3DMaterialTextures',
+        registry: RenderRegistry.MaterialTextureLister,
+      },
     ]);
   });
 
@@ -39,17 +63,25 @@ describe('explainScene3DResourceCoverage', () => {
     // The manifest lists every requirement, so a caller can render a checklist and tell "covered" from
     // "never asked about". Omitting covered kinds would make those two indistinguishable.
     expect(gaps(createBuiltInScene3DResourceResolver(), usageOf(createUnlitMaterial()))).toEqual([
-      { coverage: SceneCoverage.Satisfied, kind: 'UnlitMaterial', registry: RenderRegistry.MaterialTextureLister },
+      {
+        coverage: SceneCoverage.Satisfied,
+        facet: RequirementFacet.SceneMaterialKind,
+        kind: 'UnlitMaterial',
+        registry: RenderRegistry.MaterialTextureLister,
+      },
     ]);
   });
 
   it('reports ShadedMaterial against the built-in assembly, which does not wire its lister', () => {
-    // The gap this query exists to surface: shading ships registerShadedScene3DMaterialTextures, but
+    // The opt-in boundary this query makes explicit: shading ships registerShadedScene3DMaterialTextures, but
     // createBuiltInScene3DResourceResolver covers only the surface-PBR families, so an AWD2 document
     // loaded through the built-in assembly has no lister for its materials.
     expect(gaps(createBuiltInScene3DResourceResolver(), usageOf(createShadedMaterial()))).toContainEqual({
-      coverage: SceneCoverage.Missing,
+      coverage: SceneCoverage.Unregistered,
+      facet: RequirementFacet.SceneMaterialKind,
       kind: 'ShadedMaterial',
+      module: '@flighthq/scene3d-resources',
+      registrar: 'registerShadedScene3DMaterialTextures',
       registry: RenderRegistry.MaterialTextureLister,
     });
   });
@@ -58,14 +90,20 @@ describe('explainScene3DResourceCoverage', () => {
     const resolver = createBuiltInScene3DResourceResolver();
     registerShadedScene3DMaterialTextures(resolver.registry);
     expect(gaps(resolver, usageOf(createShadedMaterial()))).toEqual([
-      { coverage: SceneCoverage.Satisfied, kind: 'ShadedMaterial', registry: RenderRegistry.MaterialTextureLister },
+      {
+        coverage: SceneCoverage.Satisfied,
+        facet: RequirementFacet.SceneMaterialKind,
+        kind: 'ShadedMaterial',
+        registry: RenderRegistry.MaterialTextureLister,
+      },
     ]);
   });
 
   it('reports a family that ships no lister at all, so the omission is visible rather than inferred', () => {
     // BlinnPhongMaterial carries four texture slots and has no lister anywhere in the SDK.
     expect(gaps(createBuiltInScene3DResourceResolver(), usageOf(createBlinnPhongMaterial()))).toContainEqual({
-      coverage: SceneCoverage.Missing,
+      coverage: SceneCoverage.Unavailable,
+      facet: RequirementFacet.SceneMaterialKind,
       kind: 'BlinnPhongMaterial',
       registry: RenderRegistry.MaterialTextureLister,
     });
@@ -75,9 +113,9 @@ describe('explainScene3DResourceCoverage', () => {
     const resolver = createScene3DResourceResolver();
     const usage = usageOf(createUnlitMaterial());
     const out: SceneCoverageEntry[] = [];
-    explainScene3DResourceCoverage(out, resolver, usage);
+    explainScene3DResourceCoverage(out, resolver, usage, coverageCatalog);
     const first = out.length;
-    explainScene3DResourceCoverage(out, resolver, usage);
+    explainScene3DResourceCoverage(out, resolver, usage, coverageCatalog);
     expect(out).toHaveLength(first);
   });
 });
@@ -91,7 +129,7 @@ describe('hasScene3DResourceCoverage', () => {
     const resolver = createBuiltInScene3DResourceResolver();
     const usage = usageOf(createUnlitMaterial(), createShadedMaterial());
     const out: SceneCoverageEntry[] = [];
-    explainScene3DResourceCoverage(out, resolver, usage);
+    explainScene3DResourceCoverage(out, resolver, usage, coverageCatalog);
     expect(hasScene3DResourceCoverage(resolver, usage)).toBe(out.length === 0);
   });
 
@@ -101,7 +139,7 @@ describe('hasScene3DResourceCoverage', () => {
     const resolver = createBuiltInScene3DResourceResolver();
     const usage = usageOf(createUnlitMaterial());
     const out: SceneCoverageEntry[] = [];
-    explainScene3DResourceCoverage(out, resolver, usage);
+    explainScene3DResourceCoverage(out, resolver, usage, coverageCatalog);
     expect(out.length).toBeGreaterThan(0);
     expect(out.every((e) => e.coverage === SceneCoverage.Satisfied)).toBe(true);
     expect(hasScene3DResourceCoverage(resolver, usage)).toBe(true);

package/src/getScene3DResourceTextures.test.ts

@@ -11,6 +11,7 @@ import { getScene3DResourceTextures, getScene3DTextureResourceReference } from '
 
 function embeddedRef(state: ResourceResolutionState = ResourceResolutionState.Unresolved): ImageResourceReference {
   return {
+    alphaType: 'straight',
     bytes: new Uint8Array([1, 2, 3]),
     failure: null,
     kind: ImageResourceReferenceKind.Embedded,

package/src/resolveScene3DResources.test.ts

@@ -21,12 +21,12 @@ import type * as Scene3DResourceResolverModule from './sceneResourceResolver';
 import type * as Scene3DResourceSignalsModule from './sceneResourceSignals';
 
 const fakeImage = { height: 2, kind: ImageTextureSourceKind, width: 2 } as unknown as Image;
-type LoadImageResourceFromBytes = typeof ImageModule.loadImageResourceFromBytes;
+type ResolveImageResourceReference = typeof ImageModule.resolveImageResourceReference;
 
 let createBuiltInScene3DResourceResolver: typeof Scene3DResourceResolverModule.createBuiltInScene3DResourceResolver;
 let disposeScene3DResourceResolver: typeof Scene3DResourceResolverModule.disposeScene3DResourceResolver;
 let enableScene3DResourceSignals: typeof Scene3DResourceSignalsModule.enableScene3DResourceSignals;
-let loadFromBytes: Mock<LoadImageResourceFromBytes>;
+let resolveReference: Mock<ResolveImageResourceReference>;
 let resolveOneScene3DResourceTexture: typeof ResolveScene3DResourcesModule.resolveOneScene3DResourceTexture;
 let resolveScene3DResources: typeof ResolveScene3DResourcesModule.resolveScene3DResources;
 let updateScene3DResourceStreaming: typeof ResolveScene3DResourcesModule.updateScene3DResourceStreaming;
@@ -37,6 +37,7 @@ let sceneResources: ImageResourceReference[] = [];
 function embeddedRef(mimeType: string | null = 'image/png'): ImageResourceReference {
   const ref: ImageResourceReference = {
     bytes: new Uint8Array([9, 9]),
+    alphaType: 'straight',
     failure: null,
     kind: ImageResourceReferenceKind.Embedded,
     mimeType,
@@ -86,13 +87,12 @@ async function settle(resolver: Scene3DResourceResolver): Promise<void> {
 
 beforeAll(async () => {
   vi.resetModules();
-  loadFromBytes = vi.fn<LoadImageResourceFromBytes>();
-  // Override only the two loaders; the rest of the module stays real, so growing @flighthq/image cannot
+  resolveReference = vi.fn<ResolveImageResourceReference>();
+  // Override only the resource atom; the rest of the module stays real, so growing @flighthq/image cannot
   // silently blank out a code path under test.
   vi.doMock('@flighthq/image/contract', async (importOriginal) => ({
     ...(await importOriginal<typeof ImageModule>()),
-    loadImageResourceFromBytes: loadFromBytes,
-    loadImageResourceFromUrl: vi.fn(),
+    resolveImageResourceReference: resolveReference,
   }));
   ({ resolveOneScene3DResourceTexture, resolveScene3DResources, updateScene3DResourceStreaming } =
     await import('./resolveScene3DResources'));
@@ -107,31 +107,36 @@ afterAll(() => {
 });
 
 afterEach(() => {
-  loadFromBytes.mockReset();
+  resolveReference.mockReset();
 });
 
 describe('resolveOneScene3DResourceTexture', () => {
   it('decodes embedded bytes through @flighthq/image', async () => {
-    loadFromBytes.mockResolvedValue(fakeImage);
+    resolveReference.mockResolvedValue(fakeImage);
     const resolver = createBuiltInScene3DResourceResolver();
     const ref = embeddedRef('image/jpeg');
     const signal = new AbortController().signal;
     const result = await resolveOneScene3DResourceTexture(resolver, ref, signal);
-    expect(loadFromBytes).toHaveBeenCalledWith((ref as { bytes: Uint8Array }).bytes, 'image/jpeg', signal);
+    expect(resolveReference).toHaveBeenCalledWith(ref, resolver.fetch, signal);
     expect(result).toBe(fakeImage);
     disposeScene3DResourceResolver(resolver);
   });
 
-  it('passes undefined for a null embedded mimeType', async () => {
-    loadFromBytes.mockResolvedValue(fakeImage);
+  it('passes the complete plain embedded reference to the shared resource atom', async () => {
+    resolveReference.mockResolvedValue(fakeImage);
     const resolver = createBuiltInScene3DResourceResolver();
-    await resolveOneScene3DResourceTexture(resolver, embeddedRef(null), new AbortController().signal);
-    expect(loadFromBytes).toHaveBeenCalledWith(expect.anything(), undefined, expect.anything());
+    const ref = embeddedRef(null);
+    const signal = new AbortController().signal;
+    await resolveOneScene3DResourceTexture(resolver, ref, signal);
+    expect(resolveReference).toHaveBeenCalledWith(ref, resolver.fetch, signal);
     disposeScene3DResourceResolver(resolver);
   });
 
   it('routes external refs through the resolver fetch seam', async () => {
     const fetch = vi.fn(async () => fakeImage);
+    resolveReference.mockImplementation((ref, resolveFetch, signal) =>
+      ref.kind === ImageResourceReferenceKind.External ? resolveFetch(ref, signal) : Promise.resolve(null),
+    );
     const resolver = createBuiltInScene3DResourceResolver({ fetch });
     const ref = externalRef();
     const signal = new AbortController().signal;
@@ -145,8 +150,8 @@ describe('resolveOneScene3DResourceTexture', () => {
 describe('resolveScene3DResources', () => {
   it('does not cancel acquisition owned by a streaming update', async () => {
     let loadSignal: AbortSignal | undefined;
-    loadFromBytes.mockImplementation(
-      (_bytes, _mime, signal) =>
+    resolveReference.mockImplementation(
+      (_ref, _fetch, signal) =>
         new Promise<Image>((_resolve, reject) => {
           loadSignal = signal;
           signal?.addEventListener('abort', () => reject(signal.reason));
@@ -168,7 +173,7 @@ describe('resolveScene3DResources', () => {
   });
 
   it('returns the selected unresolved working set without starting acquisition', () => {
-    loadFromBytes.mockResolvedValue(fakeImage);
+    resolveReference.mockResolvedValue(fakeImage);
     const ref = embeddedRef();
     const a = createTexture({ resource: ref });
     const b = createTexture({ resource: ref });
@@ -181,7 +186,7 @@ describe('resolveScene3DResources', () => {
     expect(resources.resolved).toEqual([]);
     expect(resources.unresolved).toEqual([{ ref, textures: [a, b] }]);
     expect(ref.state).toBe(ResourceResolutionState.Unresolved);
-    expect(loadFromBytes).not.toHaveBeenCalled();
+    expect(resolveReference).not.toHaveBeenCalled();
     disposeScene3DResourceResolver(resolver);
   });
 
@@ -197,7 +202,7 @@ describe('resolveScene3DResources', () => {
     const resources = resolveScene3DResources(scene, resolver);
 
     expect(resources.unresolved).toEqual([]);
-    expect(resources.resolved).toEqual([{ image: fakeImage, ref, textures: [a, b] }]);
+    expect(resources.resolved).toEqual([{ ref, source: fakeImage, textures: [a, b] }]);
     expect(getTextureSource(b)).toBe(fakeImage);
     expect(ref.state).toBe(ResourceResolutionState.Resolved);
     disposeScene3DResourceResolver(resolver);
@@ -206,7 +211,7 @@ describe('resolveScene3DResources', () => {
 
 describe('updateScene3DResourceStreaming', () => {
   it('resolves every pending texture, binding the image and advancing state', async () => {
-    loadFromBytes.mockResolvedValue(fakeImage);
+    resolveReference.mockResolvedValue(fakeImage);
     const a = pendingTexture();
     const b = pendingTexture();
     const scene = meshScene3D(a, b);
@@ -224,7 +229,7 @@ describe('updateScene3DResourceStreaming', () => {
   });
 
   it('fetches and decodes one shared resource once, then binds every subscribed texture', async () => {
-    loadFromBytes.mockResolvedValue(fakeImage);
+    resolveReference.mockResolvedValue(fakeImage);
     const ref = embeddedRef();
     const a = createTexture({ resource: ref });
     const b = createTexture({ resource: ref });
@@ -234,7 +239,7 @@ describe('updateScene3DResourceStreaming', () => {
     updateScene3DResourceStreaming(scene, resolver);
     await settle(resolver);
 
-    expect(loadFromBytes).toHaveBeenCalledTimes(1);
+    expect(resolveReference).toHaveBeenCalledTimes(1);
     expect(getTextureSource(a)).toBe(fakeImage);
     expect(getTextureSource(b)).toBe(fakeImage);
     expect(ref.state).toBe(ResourceResolutionState.Resolved);
@@ -243,8 +248,8 @@ describe('updateScene3DResourceStreaming', () => {
 
   it('keeps a shared load alive until its final subscriber leaves the working set', async () => {
     let loadSignal: AbortSignal | undefined;
-    loadFromBytes.mockImplementation(
-      (_bytes, _mime, signal) =>
+    resolveReference.mockImplementation(
+      (_ref, _fetch, signal) =>
         new Promise<Image>((_resolve, reject) => {
           loadSignal = signal;
           signal?.addEventListener('abort', () => reject(signal.reason));
@@ -269,7 +274,7 @@ describe('updateScene3DResourceStreaming', () => {
   });
 
   it('binds a later subscriber from the resolved resource cache without decoding again', async () => {
-    loadFromBytes.mockResolvedValue(fakeImage);
+    resolveReference.mockResolvedValue(fakeImage);
     const ref = embeddedRef();
     const a = createTexture({ resource: ref });
     const b = createTexture({ resource: ref });
@@ -283,12 +288,12 @@ describe('updateScene3DResourceStreaming', () => {
 
     updateScene3DResourceStreaming(scene, resolver, { select: (texture) => texture === b });
     expect(getTextureSource(b)).toBe(fakeImage);
-    expect(loadFromBytes).toHaveBeenCalledTimes(1);
+    expect(resolveReference).toHaveBeenCalledTimes(1);
     disposeScene3DResourceResolver(resolver);
   });
 
   it('limits the working set to textures the select predicate accepts', async () => {
-    loadFromBytes.mockResolvedValue(fakeImage);
+    resolveReference.mockResolvedValue(fakeImage);
     const wanted = pendingTexture();
     const skipped = pendingTexture();
     const scene = meshScene3D(wanted, skipped);
@@ -304,6 +309,19 @@ describe('updateScene3DResourceStreaming', () => {
   });
 
   it('fails a texture whose external fetch returns null', async () => {
+    resolveReference.mockImplementation(async (ref, fetch, signal) => {
+      if (ref.kind !== ImageResourceReferenceKind.External) return null;
+      const source = await fetch(ref, signal);
+      if (source === null) {
+        ref.failure = {
+          kind: ImageResourceFailureKind.Unavailable,
+          message: 'Image resource unavailable',
+          name: null,
+        };
+        ref.state = ResourceResolutionState.Failed;
+      }
+      return source;
+    });
     const texture = createTexture({ resource: externalRef() });
     const scene = meshScene3D(texture);
     const resolver = createBuiltInScene3DResourceResolver({ fetch: async () => null });
@@ -315,14 +333,14 @@ describe('updateScene3DResourceStreaming', () => {
     expect(resourceOf(texture)?.state).toBe(ResourceResolutionState.Failed);
     expect(resourceOf(texture)?.failure).toEqual({
       kind: ImageResourceFailureKind.Unavailable,
-      message: 'Image resource resolution returned no image',
+      message: 'Image resource unavailable',
       name: null,
     });
     disposeScene3DResourceResolver(resolver);
   });
 
   it('fails a texture whose decode throws', async () => {
-    loadFromBytes.mockRejectedValue(new Error('bad image'));
+    resolveReference.mockRejectedValue(new Error('bad image'));
     const texture = pendingTexture();
     const scene = meshScene3D(texture);
     const resolver = createBuiltInScene3DResourceResolver();
@@ -342,8 +360,8 @@ describe('updateScene3DResourceStreaming', () => {
   it('cancels and reverts a load dropped from the working set, then re-requests on re-entry', async () => {
     const loadSignals: AbortSignal[] = [];
     // A load that hangs until its signal aborts, so we can drop it mid-flight.
-    loadFromBytes.mockImplementation(
-      (_bytes, _mime, signal) =>
+    resolveReference.mockImplementation(
+      (_ref, _fetch, signal) =>
         new Promise<Image>((_resolve, reject) => {
           if (signal !== undefined) loadSignals.push(signal);
           signal?.addEventListener('abort', () => reject(signal.reason));
@@ -372,21 +390,21 @@ describe('updateScene3DResourceStreaming', () => {
   });
 
   it('does not re-request a texture already in flight', async () => {
-    loadFromBytes.mockImplementation(() => new Promise<Image>(() => {}));
+    resolveReference.mockImplementation(() => new Promise<Image>(() => {}));
     const texture = pendingTexture();
     const scene = meshScene3D(texture);
     const resolver = createBuiltInScene3DResourceResolver();
 
     updateScene3DResourceStreaming(scene, resolver);
-    await vi.waitFor(() => expect(loadFromBytes).toHaveBeenCalledTimes(1));
+    await vi.waitFor(() => expect(resolveReference).toHaveBeenCalledTimes(1));
     updateScene3DResourceStreaming(scene, resolver);
-    expect(loadFromBytes).toHaveBeenCalledTimes(1);
+    expect(resolveReference).toHaveBeenCalledTimes(1);
 
     disposeScene3DResourceResolver(resolver);
   });
 
   it('emits onResourceResolved when signals are enabled', async () => {
-    loadFromBytes.mockResolvedValue(fakeImage);
+    resolveReference.mockResolvedValue(fakeImage);
     const texture = pendingTexture();
     const scene = meshScene3D(texture);
     const resolver = createBuiltInScene3DResourceResolver();
@@ -405,7 +423,7 @@ describe('updateScene3DResourceStreaming', () => {
   });
 
   it('emits onResourceFailed when a decode throws', async () => {
-    loadFromBytes.mockRejectedValue(new Error('bad image'));
+    resolveReference.mockRejectedValue(new Error('bad image'));
     const texture = pendingTexture();
     const scene = meshScene3D(texture);
     const resolver = createBuiltInScene3DResourceResolver();

package/src/revealScene3DResourcesOnResolve.test.ts

@@ -2,6 +2,7 @@ import { createStandardPbrMaterial } from '@flighthq/materials/contract';
 import { createBoxMeshGeometry } from '@flighthq/mesh/contract';
 import { addNodeChild } from '@flighthq/node/contract';
 import { createMesh, createScene3D } from '@flighthq/scene3d/contract';
+import { createShadedMaterial } from '@flighthq/shading/contract';
 import { emitSignal } from '@flighthq/signals/contract';
 import { createTexture } from '@flighthq/texture/contract';
 import { createTweenManager, hasTweensOf, updateTweens } from '@flighthq/tween/contract';
@@ -23,6 +24,7 @@ const testResources: EmbeddedImageResourceReference[] = [];
 
 function pendingRef(): EmbeddedImageResourceReference {
   const ref: EmbeddedImageResourceReference = {
+    alphaType: 'straight',
     bytes: new Uint8Array([0x89, 0x50, 0x4e, 0x47]),
     failure: null,
     kind: 'Embedded',
@@ -141,6 +143,52 @@ describe('revealScene3DResourcesOnResolve', () => {
     expect(mesh.alpha).toBe(1);
   });
 
+  it('leaves an all-unlisted mesh unchanged and installs no fade', () => {
+    const diffuseMap = createTexture({ resource: pendingRef() });
+    const mesh = createMesh(createBoxMeshGeometry(), [createShadedMaterial({ diffuseMap })]);
+    mesh.alpha = 0.6;
+    const scene = createScene3D();
+    configureResources(scene);
+    addNodeChild(scene.root, mesh);
+    const resolver = createBuiltInScene3DResourceResolver();
+    const manager = createTweenManager();
+
+    revealScene3DResourcesOnResolve(resolver, scene, manager, { fadeSeconds: 0.5 });
+    expect(mesh.alpha).toBeCloseTo(0.6);
+
+    emitSignal(enableScene3DResourceSignals(resolver).onResourceResolved, {
+      ref: resourceOf(diffuseMap),
+      texture: diffuseMap,
+    });
+    expect(hasTweensOf(manager, mesh)).toBe(false);
+  });
+
+  it('reveals a mixed mesh after its listed textures settle without waiting for an unlisted sibling', () => {
+    const shadedMap = createTexture({ resource: pendingRef() });
+    const pbrMap = createTexture({ resource: pendingRef() });
+    const mesh = createMesh(createBoxMeshGeometry(), [
+      createShadedMaterial({ diffuseMap: shadedMap }),
+      createStandardPbrMaterial({ baseColorMap: pbrMap }),
+    ]);
+    const scene = createScene3D();
+    configureResources(scene);
+    addNodeChild(scene.root, mesh);
+    const resolver = createBuiltInScene3DResourceResolver();
+    const manager = createTweenManager();
+
+    revealScene3DResourcesOnResolve(resolver, scene, manager, { fadeSeconds: 0.5 });
+    expect(mesh.alpha).toBe(0);
+
+    emitSignal(enableScene3DResourceSignals(resolver).onResourceResolved, {
+      ref: resourceOf(pbrMap),
+      texture: pbrMap,
+    });
+    expect(hasTweensOf(manager, mesh)).toBe(true);
+    updateTweens(manager, 0.5);
+    expect(mesh.alpha).toBeCloseTo(1);
+    expect(resourceOf(shadedMap).state).toBe(ResourceResolutionState.Unresolved);
+  });
+
   it('reveals every owner of one shared texture when that texture settles', () => {
     const texture = createTexture({ resource: pendingRef() });
     const a = createMesh(createBoxMeshGeometry(), [createStandardPbrMaterial({ baseColorMap: texture })]);

package/src/sceneResourceResolver.test.ts

@@ -61,6 +61,7 @@ describe('disposeScene3DResourceResolver', () => {
     const resolver = createScene3DResourceResolver();
     const controller = new AbortController();
     const ref = {
+      alphaType: 'straight',
       bytes: new Uint8Array(0),
       failure: null,
       kind: ImageResourceReferenceKind.Embedded,

package/src/sceneResourceSignals.test.ts

@@ -11,6 +11,7 @@ import {
 } from './sceneResourceSignals';
 
 const ref: ImageResourceReference = {
+  alphaType: 'straight',
   bytes: new Uint8Array(),
   failure: null,
   kind: ImageResourceReferenceKind.Embedded,