@flighthq/scene3d-resources 0.2.1-next.840.857425c

package/dist/resolveScene3DResourcesAndWait.d.ts

@@ -0,0 +1,4 @@
+import type { LoadScene3DResourcesOptions, Node3D, Scene3DResourceResolver } from '@flighthq/types';
+export declare function loadScene3DResources(scene: Readonly<Node3D>, resolver: Scene3DResourceResolver, options?: Readonly<LoadScene3DResourcesOptions>): Promise<void>;
+export declare function waitForScene3DResourceResolver(resolver: Readonly<Scene3DResourceResolver>): Promise<void>;
+//# sourceMappingURL=resolveScene3DResourcesAndWait.d.ts.map

package/dist/resolveScene3DResourcesAndWait.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveScene3DResourcesAndWait.d.ts","sourceRoot":"","sources":["../src/resolveScene3DResourcesAndWait.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,2BAA2B,EAC3B,MAAM,EACN,uBAAuB,EAExB,MAAM,iBAAiB,CAAC;AAYzB,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,EACvB,QAAQ,EAAE,uBAAuB,EACjC,OAAO,CAAC,EAAE,QAAQ,CAAC,2BAA2B,CAAC,GAC9C,OAAO,CAAC,IAAI,CAAC,CAwBf;AAID,wBAAsB,8BAA8B,CAAC,QAAQ,EAAE,QAAQ,CAAC,uBAAuB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAK/G"}

package/dist/resolveScene3DResourcesAndWait.js

@@ -0,0 +1,57 @@
+import { emitSignal } from '@flighthq/signals';
+import { ResourceResolutionState } from '@flighthq/types';
+import { Scene3DResourceResolverRuntimeKey } from '@flighthq/types';
+import { getScene3DResourceTextures } from './getScene3DResourceTextures';
+import { resolveScene3DResources } from './resolveScene3DResources';
+// Eager/deterministic asynchronous load: runs one resolveScene3DResources pass, then awaits every in-flight
+// load it started so the scene is fully resolved (or each ref settled to Failed) on return. The
+// deterministic sibling of the fire-and-forget resolveScene3DResources — for loads, tests, and capture
+// that need the finished scene rather than progressive availability.
+export async function loadScene3DResources(scene, resolver, options) {
+    const refs = getSelectedScene3DResourceReferences(scene, resolver, options);
+    resolveScene3DResources(scene, resolver, options);
+    const runtime = resolver[Scene3DResourceResolverRuntimeKey];
+    const total = refs.size;
+    let loaded = 0;
+    const pending = [];
+    const progress = options?.progress;
+    for (const ref of refs) {
+        if (ref.state === ResourceResolutionState.Resolved || ref.state === ResourceResolutionState.Failed) {
+            loaded++;
+            continue;
+        }
+        const entry = runtime.inFlight.get(ref);
+        if (entry === undefined)
+            continue;
+        pending.push(entry.promise.then(() => {
+            loaded++;
+            if (progress !== undefined)
+                emitSignal(progress, { loaded, total });
+        }));
+    }
+    if (progress !== undefined)
+        emitSignal(progress, { loaded, total });
+    await Promise.allSettled(pending);
+}
+// Waits for the loads that are pending at call time without revealing or exposing the resolver's
+// private request records. New work queued after the snapshot belongs to the caller's next bracket.
+export async function waitForScene3DResourceResolver(resolver) {
+    const runtime = resolver[Scene3DResourceResolverRuntimeKey];
+    const promises = [];
+    for (const entry of runtime.inFlight.values())
+        promises.push(entry.promise);
+    await Promise.allSettled(promises);
+}
+function getSelectedScene3DResourceReferences(scene, resolver, options) {
+    const textures = [];
+    const refs = new Set();
+    getScene3DResourceTextures(scene, resolver.registry, textures);
+    for (const texture of textures) {
+        const ref = texture.resource;
+        if (ref !== null && ref !== undefined && (options?.select === undefined || options.select(texture, ref))) {
+            refs.add(ref);
+        }
+    }
+    return refs;
+}
+//# sourceMappingURL=resolveScene3DResourcesAndWait.js.map

package/dist/resolveScene3DResourcesAndWait.js.map

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

package/dist/revealScene3DResourcesOnResolve.d.ts

@@ -0,0 +1,3 @@
+import type { Node3D, Scene3DResourceResolver, Scene3DResourceRevealOptions, TweenManager } from '@flighthq/types';
+export declare function revealScene3DResourcesOnResolve(resolver: Scene3DResourceResolver, scene: Readonly<Node3D>, tweenManager: TweenManager, options?: Readonly<Scene3DResourceRevealOptions>): () => void;
+//# sourceMappingURL=revealScene3DResourcesOnResolve.d.ts.map

package/dist/revealScene3DResourcesOnResolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"revealScene3DResourcesOnResolve.d.ts","sourceRoot":"","sources":["../src/revealScene3DResourcesOnResolve.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAEV,MAAM,EACN,uBAAuB,EACvB,4BAA4B,EAE5B,YAAY,EACb,MAAM,iBAAiB,CAAC;AAkBzB,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,uBAAuB,EACjC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,EACvB,YAAY,EAAE,YAAY,EAC1B,OAAO,CAAC,EAAE,QAAQ,CAAC,4BAA4B,CAAC,GAC/C,MAAM,IAAI,CAgCZ"}

package/dist/revealScene3DResourcesOnResolve.js

@@ -0,0 +1,95 @@
+import { forEachNodeDescendant } from '@flighthq/node';
+import { isMesh } from '@flighthq/scene3d';
+import { connectSignal, disconnectSignal } from '@flighthq/signals';
+import { createTween } from '@flighthq/tween';
+import { ResourceResolutionState } from '@flighthq/types';
+import { getScene3DMaterialTextures } from './sceneMaterialTextureRegistry';
+import { enableScene3DResourceSignals } from './sceneResourceSignals';
+// The standard streamed-texture fade-in, composed from node opacity (P1/P2) + @flighthq/tween: every
+// object carrying a still-pending texture is hidden to `from` up front, and only after every required
+// texture settles does the recipe fade its owning object's `node.alpha` up to 1 over `fadeSeconds`.
+// Failure counts as settled so the renderer's fallback can be revealed instead of leaving the object
+// permanently hidden. A cancelled load does not settle and remains pending until a later resolution
+// pass re-requests it. The resolver only reports availability; this recipe animates — the app ticks
+// the fade via updateTweens(tweenManager, dt), and a node-opacity-honoring renderer makes it visible.
+//
+// Call BEFORE resolveScene3DResources so objects start hidden rather than popping. Returns a disposer
+// that disconnects the signal listener (the tween manager and any in-flight tweens are the caller's).
+// A texture shared across meshes fades every owning object; an object with several pending textures
+// fades in when the first of them resolves.
+export function revealScene3DResourcesOnResolve(resolver, scene, tweenManager, options) {
+    const fadeSeconds = options?.fadeSeconds ?? 0.4;
+    const from = options?.from ?? 0;
+    const tweenOptions = options?.ease !== undefined ? { ease: options.ease } : undefined;
+    const ownersByTexture = new Map();
+    const owners = [];
+    collectPendingTextureOwners(scene, resolver, ownersByTexture, owners);
+    for (const owner of owners) {
+        owner.node.alpha = from;
+    }
+    const signals = enableScene3DResourceSignals(resolver);
+    const slot = (event) => {
+        const textureOwners = ownersByTexture.get(event.texture);
+        if (textureOwners === undefined)
+            return;
+        // A resource must emit at most one terminal event for a Texture, but deleting here also makes the
+        // reveal atom robust to a caller manually replaying or forwarding the same event.
+        ownersByTexture.delete(event.texture);
+        for (const owner of textureOwners) {
+            owner.pending.delete(event.texture);
+            if (owner.pending.size === 0) {
+                createTween(tweenManager, owner.node, fadeSeconds, { alpha: 1 }, tweenOptions);
+            }
+        }
+    };
+    connectSignal(signals.onResourceResolved, slot);
+    connectSignal(signals.onResourceFailed, slot);
+    return () => {
+        disconnectSignal(signals.onResourceResolved, slot);
+        disconnectSignal(signals.onResourceFailed, slot);
+    };
+}
+// Maps each unresolved/loading texture to its owning Mesh reveal state. Already bound images and
+// previously failed references are settled before this recipe begins, so they must not hide an owner
+// waiting for an event that will never arrive. Repeated texture slots on one owner count only once.
+function collectPendingTextureOwners(scene, resolver, ownersByTexture, owners) {
+    const slots = [];
+    const ownersByNode = new Map();
+    const visit = (node) => {
+        if (!isMesh(node))
+            return;
+        const owner = node;
+        const materials = node.materials;
+        for (let i = 0; i < materials.length; i++) {
+            const material = materials[i];
+            if (material === null)
+                continue;
+            slots.length = 0;
+            getScene3DMaterialTextures(resolver.registry, material, slots);
+            for (let j = 0; j < slots.length; j++) {
+                const texture = slots[j];
+                const ref = texture.resource;
+                if (ref == null || texture.image !== null || ref.state === ResourceResolutionState.Failed)
+                    continue;
+                let ownerState = ownersByNode.get(owner);
+                if (ownerState === undefined) {
+                    ownerState = { node: owner, pending: new Set() };
+                    ownersByNode.set(owner, ownerState);
+                    owners.push(ownerState);
+                }
+                if (ownerState.pending.has(texture))
+                    continue;
+                ownerState.pending.add(texture);
+                let textureOwners = ownersByTexture.get(texture);
+                if (textureOwners === undefined) {
+                    textureOwners = [];
+                    ownersByTexture.set(texture, textureOwners);
+                }
+                textureOwners.push(ownerState);
+            }
+        }
+    };
+    visit(scene);
+    forEachNodeDescendant(scene, (node) => visit(node));
+}
+//# sourceMappingURL=revealScene3DResourcesOnResolve.js.map

package/dist/revealScene3DResourcesOnResolve.js.map

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

package/dist/sceneDocumentSource.d.ts

@@ -0,0 +1,6 @@
+import type { Scene3DDocument, Scene3DDocumentLoadOptions } from '@flighthq/types';
+export declare function getScene3DDocumentBasePathFromUrl(url: string): string | null;
+export declare function loadScene3DDocumentBytesFromUrl(url: string, options?: Readonly<Scene3DDocumentLoadOptions>): Promise<Uint8Array | null>;
+export declare function loadScene3DDocumentTextFromUrl(url: string, options?: Readonly<Scene3DDocumentLoadOptions>): Promise<string | null>;
+export declare function setScene3DDocumentResourceBasePathFromUrl(document: Scene3DDocument, url: string): void;
+//# sourceMappingURL=sceneDocumentSource.d.ts.map

package/dist/sceneDocumentSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sceneDocumentSource.d.ts","sourceRoot":"","sources":["../src/sceneDocumentSource.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAkC,eAAe,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAGnH,wBAAgB,iCAAiC,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK5E;AAMD,wBAAsB,+BAA+B,CACnD,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,QAAQ,CAAC,0BAA0B,CAAC,GAC7C,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAO5B;AAKD,wBAAsB,8BAA8B,CAClD,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,QAAQ,CAAC,0BAA0B,CAAC,GAC7C,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAOxB;AAID,wBAAgB,yCAAyC,CAAC,QAAQ,EAAE,eAAe,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAQtG"}

package/dist/sceneDocumentSource.js

@@ -0,0 +1,55 @@
+import { sendNetRequest } from '@flighthq/net';
+import { connectSignal, createSignal, emitSignal } from '@flighthq/signals';
+import { ImageResourceReferenceKind } from '@flighthq/types';
+export function getScene3DDocumentBasePathFromUrl(url) {
+    const query = url.search(/[?#]/);
+    const source = query >= 0 ? url.slice(0, query) : url;
+    const slash = source.lastIndexOf('/');
+    return slash < 0 ? null : source.slice(0, slash);
+}
+// Fetches a scene file's raw bytes from a URL through the active @flighthq/net backend (responseType
+// 'arraybuffer'), for the binary document loaders (glTF `.glb`, AWD, MD2, 3DS). Returns the bytes on a 2xx
+// response, or null on any expected transport/HTTP failure. No resource resolution or renderer/GPU work
+// happens here; callers compose parsing and later resource acquisition explicitly.
+export async function loadScene3DDocumentBytesFromUrl(url, options) {
+    const response = await sendNetRequest({ method: 'GET', responseType: 'arraybuffer', url }, createScene3DDocumentNetRequestOptions(url, options));
+    if (!response.ok || !(response.body instanceof ArrayBuffer))
+        return null;
+    return new Uint8Array(response.body);
+}
+// Fetches a scene file's text from a URL through the active @flighthq/net backend (responseType 'text'),
+// for the text document loaders (OBJ, MD5). Returns the text on a 2xx response, or null on any expected
+// transport/HTTP failure. Fetches only source text — no parsing, resource realization, or rendering work.
+export async function loadScene3DDocumentTextFromUrl(url, options) {
+    const response = await sendNetRequest({ method: 'GET', responseType: 'text', url }, createScene3DDocumentNetRequestOptions(url, options));
+    if (!response.ok || typeof response.body !== 'string')
+        return null;
+    return response.body;
+}
+// Carries the loaded model's directory onto relative external image references emitted by formats whose
+// parser consumed only in-hand bytes/text. Existing non-null base paths are authoritative and untouched.
+export function setScene3DDocumentResourceBasePathFromUrl(document, url) {
+    const basePath = getScene3DDocumentBasePathFromUrl(url);
+    if (basePath === null)
+        return;
+    for (const resource of document.resources) {
+        if (resource.kind === ImageResourceReferenceKind.External && resource.basePath === null) {
+            resource.basePath = basePath;
+        }
+    }
+}
+function createScene3DDocumentNetRequestOptions(url, options) {
+    if (options === undefined)
+        return undefined;
+    const out = { signal: options.signal };
+    const outputProgress = options.progress;
+    if (outputProgress !== undefined) {
+        const progress = createSignal();
+        connectSignal(progress, (event) => {
+            emitSignal(outputProgress, { loaded: event.loaded, phase: event.phase, total: event.total, url });
+        });
+        out.progress = progress;
+    }
+    return out;
+}
+//# sourceMappingURL=sceneDocumentSource.js.map

package/dist/sceneDocumentSource.js.map

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

package/dist/sceneMaterialTextureRegistry.d.ts

@@ -0,0 +1,6 @@
+import type { Kind, Material, Scene3DMaterialTextureLister, Scene3DMaterialTextureRegistry, Texture } from '@flighthq/types';
+export declare function createScene3DMaterialTextureRegistry(): Scene3DMaterialTextureRegistry;
+export declare function getScene3DMaterialTextures(registry: Readonly<Scene3DMaterialTextureRegistry>, material: Readonly<Material>, out: Texture[]): void;
+export declare function registerBuiltInScene3DMaterialTextures(registry: Scene3DMaterialTextureRegistry): void;
+export declare function registerScene3DMaterialTextures(registry: Scene3DMaterialTextureRegistry, kind: Kind, lister: Scene3DMaterialTextureLister): void;
+//# sourceMappingURL=sceneMaterialTextureRegistry.d.ts.map

package/dist/sceneMaterialTextureRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sceneMaterialTextureRegistry.d.ts","sourceRoot":"","sources":["../src/sceneMaterialTextureRegistry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,IAAI,EACJ,QAAQ,EACR,4BAA4B,EAC5B,8BAA8B,EAE9B,OAAO,EAER,MAAM,iBAAiB,CAAC;AAGzB,wBAAgB,oCAAoC,IAAI,8BAA8B,CAErF;AAKD,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,QAAQ,CAAC,8BAA8B,CAAC,EAClD,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAC5B,GAAG,EAAE,OAAO,EAAE,GACb,IAAI,CAGN;AAID,wBAAgB,sCAAsC,CAAC,QAAQ,EAAE,8BAA8B,GAAG,IAAI,CAGrG;AAID,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,8BAA8B,EACxC,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,4BAA4B,GACnC,IAAI,CAEN"}

package/dist/sceneMaterialTextureRegistry.js

@@ -0,0 +1,43 @@
+import { createEntity } from '@flighthq/entity';
+import { StandardPbrMaterialKind, UnlitMaterialKind } from '@flighthq/types';
+export function createScene3DMaterialTextureRegistry() {
+    return createEntity({ listers: new Map() });
+}
+// Looks up the lister for `material.kind` and, when present, appends the material's non-null Textures
+// to `out`. An unregistered kind appends nothing. Does not clear `out` — it accumulates across the
+// materials of a mesh.
+export function getScene3DMaterialTextures(registry, material, out) {
+    const lister = registry.listers.get(material.kind);
+    if (lister !== undefined)
+        lister(material, out);
+}
+// Registers the built-in surface-material listers (StandardPbrMaterial and UnlitMaterial). Opt-in so
+// it carries no top-level side effect; callers that build their own registry invoke it explicitly.
+export function registerBuiltInScene3DMaterialTextures(registry) {
+    registerScene3DMaterialTextures(registry, StandardPbrMaterialKind, listStandardPbrMaterialTextures);
+    registerScene3DMaterialTextures(registry, UnlitMaterialKind, listUnlitMaterialTextures);
+}
+// Binds `lister` to `kind` (last-write-wins; overriding a built-in with a custom lister is a
+// feature, not an error — no registration guard).
+export function registerScene3DMaterialTextures(registry, kind, lister) {
+    registry.listers.set(kind, lister);
+}
+function listStandardPbrMaterialTextures(material, out) {
+    const pbr = material;
+    if (pbr.baseColorMap !== null)
+        out.push(pbr.baseColorMap);
+    if (pbr.emissiveMap !== null)
+        out.push(pbr.emissiveMap);
+    if (pbr.metallicRoughnessMap !== null)
+        out.push(pbr.metallicRoughnessMap);
+    if (pbr.normalMap !== null)
+        out.push(pbr.normalMap);
+    if (pbr.occlusionMap !== null)
+        out.push(pbr.occlusionMap);
+}
+function listUnlitMaterialTextures(material, out) {
+    const unlit = material;
+    if (unlit.baseColorMap !== null)
+        out.push(unlit.baseColorMap);
+}
+//# sourceMappingURL=sceneMaterialTextureRegistry.js.map

package/dist/sceneMaterialTextureRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sceneMaterialTextureRegistry.js","sourceRoot":"","sources":["../src/sceneMaterialTextureRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAUhD,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAE7E,MAAM,UAAU,oCAAoC;IAClD,OAAO,YAAY,CAAC,EAAE,OAAO,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED,sGAAsG;AACtG,mGAAmG;AACnG,uBAAuB;AACvB,MAAM,UAAU,0BAA0B,CACxC,QAAkD,EAClD,QAA4B,EAC5B,GAAc;IAEd,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACnD,IAAI,MAAM,KAAK,SAAS;QAAE,MAAM,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;AAClD,CAAC;AAED,qGAAqG;AACrG,mGAAmG;AACnG,MAAM,UAAU,sCAAsC,CAAC,QAAwC;IAC7F,+BAA+B,CAAC,QAAQ,EAAE,uBAAuB,EAAE,+BAA+B,CAAC,CAAC;IACpG,+BAA+B,CAAC,QAAQ,EAAE,iBAAiB,EAAE,yBAAyB,CAAC,CAAC;AAC1F,CAAC;AAED,6FAA6F;AAC7F,kDAAkD;AAClD,MAAM,UAAU,+BAA+B,CAC7C,QAAwC,EACxC,IAAU,EACV,MAAoC;IAEpC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AACrC,CAAC;AAED,SAAS,+BAA+B,CAAC,QAA4B,EAAE,GAAc;IACnF,MAAM,GAAG,GAAG,QAAyC,CAAC;IACtD,IAAI,GAAG,CAAC,YAAY,KAAK,IAAI;QAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAC1D,IAAI,GAAG,CAAC,WAAW,KAAK,IAAI;QAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACxD,IAAI,GAAG,CAAC,oBAAoB,KAAK,IAAI;QAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IAC1E,IAAI,GAAG,CAAC,SAAS,KAAK,IAAI;QAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACpD,IAAI,GAAG,CAAC,YAAY,KAAK,IAAI;QAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;AAC5D,CAAC;AAED,SAAS,yBAAyB,CAAC,QAA4B,EAAE,GAAc;IAC7E,MAAM,KAAK,GAAG,QAAmC,CAAC;IAClD,IAAI,KAAK,CAAC,YAAY,KAAK,IAAI;QAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;AAChE,CAAC"}

package/dist/sceneResourceRecovery.d.ts

@@ -0,0 +1,5 @@
+import type { ImageResourceReference, ImageResourceReferenceResolutionExplanation, ResolveScene3DResourcesOptions, Node3D, Scene3DResourceResolver } from '@flighthq/types';
+export declare function explainImageResourceReferenceResolution(ref: Readonly<ImageResourceReference>): ImageResourceReferenceResolutionExplanation;
+export declare function resetFailedImageResourceReference(ref: ImageResourceReference): boolean;
+export declare function retryFailedScene3DResources(scene: Readonly<Node3D>, resolver: Scene3DResourceResolver, options?: Readonly<ResolveScene3DResourcesOptions>): number;
+//# sourceMappingURL=sceneResourceRecovery.d.ts.map

package/dist/sceneResourceRecovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sceneResourceRecovery.d.ts","sourceRoot":"","sources":["../src/sceneResourceRecovery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,2CAA2C,EAC3C,8BAA8B,EAC9B,MAAM,EACN,uBAAuB,EAExB,MAAM,iBAAiB,CAAC;AAQzB,wBAAgB,uCAAuC,CACrD,GAAG,EAAE,QAAQ,CAAC,sBAAsB,CAAC,GACpC,2CAA2C,CAO7C;AAID,wBAAgB,iCAAiC,CAAC,GAAG,EAAE,sBAAsB,GAAG,OAAO,CAKtF;AAKD,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,EACvB,QAAQ,EAAE,uBAAuB,EACjC,OAAO,CAAC,EAAE,QAAQ,CAAC,8BAA8B,CAAC,GACjD,MAAM,CAaR"}

package/dist/sceneResourceRecovery.js

@@ -0,0 +1,43 @@
+import { ResourceResolutionState } from '@flighthq/types';
+import { getScene3DResourceTextures } from './getScene3DResourceTextures';
+import { resolveScene3DResources } from './resolveScene3DResources';
+// Returns a detached plain-data explanation suitable for logs, tools, and serialization. It never
+// throws and exposes no resolver runtime or raw thrown value.
+export function explainImageResourceReferenceResolution(ref) {
+    return {
+        failure: ref.failure === null ? null : { ...ref.failure },
+        kind: ref.kind,
+        retryable: ref.state === ResourceResolutionState.Failed,
+        state: ref.state,
+    };
+}
+// Returns a failed reference to the requestable state. Loading/resolved/unresolved references are
+// unchanged so this atom cannot invalidate live work or a successfully bound resource accidentally.
+export function resetFailedImageResourceReference(ref) {
+    if (ref.state !== ResourceResolutionState.Failed)
+        return false;
+    ref.failure = null;
+    ref.state = ResourceResolutionState.Unresolved;
+    return true;
+}
+// Resets every selected failed identity once, then performs a normal resolver pass under the same
+// selection/priority policy. The normal pass remains authoritative for the working set, including its
+// documented cancellation behavior when visibility selection drops an existing subscriber.
+export function retryFailedScene3DResources(scene, resolver, options) {
+    const textures = [];
+    getScene3DResourceTextures(scene, resolver.registry, textures);
+    const reset = new Set();
+    for (let i = 0; i < textures.length; i++) {
+        const texture = textures[i];
+        const ref = texture.resource;
+        if (ref == null || reset.has(ref))
+            continue;
+        if (options?.select !== undefined && !options.select(texture, ref))
+            continue;
+        if (resetFailedImageResourceReference(ref))
+            reset.add(ref);
+    }
+    resolveScene3DResources(scene, resolver, options);
+    return reset.size;
+}
+//# sourceMappingURL=sceneResourceRecovery.js.map

package/dist/sceneResourceRecovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sceneResourceRecovery.js","sourceRoot":"","sources":["../src/sceneResourceRecovery.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,kGAAkG;AAClG,8DAA8D;AAC9D,MAAM,UAAU,uCAAuC,CACrD,GAAqC;IAErC,OAAO;QACL,OAAO,EAAE,GAAG,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,OAAO,EAAE;QACzD,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,SAAS,EAAE,GAAG,CAAC,KAAK,KAAK,uBAAuB,CAAC,MAAM;QACvD,KAAK,EAAE,GAAG,CAAC,KAAK;KACjB,CAAC;AACJ,CAAC;AAED,kGAAkG;AAClG,oGAAoG;AACpG,MAAM,UAAU,iCAAiC,CAAC,GAA2B;IAC3E,IAAI,GAAG,CAAC,KAAK,KAAK,uBAAuB,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAC/D,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC;IACnB,GAAG,CAAC,KAAK,GAAG,uBAAuB,CAAC,UAAU,CAAC;IAC/C,OAAO,IAAI,CAAC;AACd,CAAC;AAED,kGAAkG;AAClG,sGAAsG;AACtG,2FAA2F;AAC3F,MAAM,UAAU,2BAA2B,CACzC,KAAuB,EACvB,QAAiC,EACjC,OAAkD;IAElD,MAAM,QAAQ,GAAc,EAAE,CAAC;IAC/B,0BAA0B,CAAC,KAAK,EAAE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/D,MAAM,KAAK,GAAG,IAAI,GAAG,EAA0B,CAAC;IAChD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC5B,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC;QAC7B,IAAI,GAAG,IAAI,IAAI,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAC5C,IAAI,OAAO,EAAE,MAAM,KAAK,SAAS,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC;YAAE,SAAS;QAC7E,IAAI,iCAAiC,CAAC,GAAG,CAAC;YAAE,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7D,CAAC;IACD,uBAAuB,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAClD,OAAO,KAAK,CAAC,IAAI,CAAC;AACpB,CAAC"}

package/dist/sceneResourceResolver.d.ts

@@ -0,0 +1,5 @@
+import type { Scene3DResourceResolver, Scene3DResourceResolverOptions } from '@flighthq/types';
+export declare function createBuiltInScene3DResourceResolver(options?: Readonly<Scene3DResourceResolverOptions>): Scene3DResourceResolver;
+export declare function createScene3DResourceResolver(options?: Readonly<Scene3DResourceResolverOptions>): Scene3DResourceResolver;
+export declare function disposeScene3DResourceResolver(resolver: Scene3DResourceResolver): void;
+//# sourceMappingURL=sceneResourceResolver.d.ts.map

package/dist/sceneResourceResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sceneResourceResolver.d.ts","sourceRoot":"","sources":["../src/sceneResourceResolver.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,uBAAuB,EAAE,8BAA8B,EAAE,MAAM,iBAAiB,CAAC;AAY/F,wBAAgB,oCAAoC,CAClD,OAAO,CAAC,EAAE,QAAQ,CAAC,8BAA8B,CAAC,GACjD,uBAAuB,CAIzB;AAED,wBAAgB,6BAA6B,CAC3C,OAAO,CAAC,EAAE,QAAQ,CAAC,8BAA8B,CAAC,GACjD,uBAAuB,CAgBzB;AAID,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,uBAAuB,GAAG,IAAI,CAStF"}

package/dist/sceneResourceResolver.js

@@ -0,0 +1,41 @@
+import { createEntity } from '@flighthq/entity';
+import { cancelResourceLoad, createResourceLoader, disposeResourceLoader, startResourceLoad } from '@flighthq/loader';
+import { Scene3DResourceResolverRuntimeKey } from '@flighthq/types';
+import { fetchWebImageResource } from './imageResourceFetch';
+import { createScene3DMaterialTextureRegistry, registerBuiltInScene3DMaterialTextures, } from './sceneMaterialTextureRegistry';
+// Explicit preconfigured assembly for the common Standard PBR + Unlit path. The primitive constructor
+// above stays empty so importing/creating it cannot silently pull material families into a custom lane.
+export function createBuiltInScene3DResourceResolver(options) {
+    const resolver = createScene3DResourceResolver(options);
+    registerBuiltInScene3DMaterialTextures(resolver.registry);
+    return resolver;
+}
+export function createScene3DResourceResolver(options) {
+    // Streaming so passes can queue after the loader has started; dedupe off since each pending texture
+    // is queued once under a unique auto-assigned key, and disabling it avoids an unbounded dedupe map.
+    const loader = createResourceLoader({ dedupe: false, maxConcurrent: options?.maxConcurrent, streaming: true });
+    startResourceLoad(loader);
+    return createEntity({
+        fetch: options?.fetch ?? fetchWebImageResource,
+        registry: options?.registry ?? createScene3DMaterialTextureRegistry(),
+        [Scene3DResourceResolverRuntimeKey]: {
+            inFlight: new Map(),
+            loader,
+            resolved: new Map(),
+            signals: null,
+        },
+    });
+}
+// Releases the resolver: cancels and disposes the loader, aborts every in-flight controller, and
+// clears the in-flight map. GC-managed teardown (no GPU/native resource), so dispose, not destroy.
+export function disposeScene3DResourceResolver(resolver) {
+    const runtime = resolver[Scene3DResourceResolverRuntimeKey];
+    cancelResourceLoad(runtime.loader);
+    disposeResourceLoader(runtime.loader);
+    for (const entry of runtime.inFlight.values()) {
+        entry.controller.abort();
+    }
+    runtime.inFlight.clear();
+    runtime.resolved.clear();
+}
+//# sourceMappingURL=sceneResourceResolver.js.map

package/dist/sceneResourceResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sceneResourceResolver.js","sourceRoot":"","sources":["../src/sceneResourceResolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAEtH,OAAO,EAAE,iCAAiC,EAAE,MAAM,iBAAiB,CAAC;AAGpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EACL,oCAAoC,EACpC,sCAAsC,GACvC,MAAM,gCAAgC,CAAC;AAExC,sGAAsG;AACtG,wGAAwG;AACxG,MAAM,UAAU,oCAAoC,CAClD,OAAkD;IAElD,MAAM,QAAQ,GAAG,6BAA6B,CAAC,OAAO,CAAC,CAAC;IACxD,sCAAsC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC1D,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,OAAkD;IAElD,oGAAoG;IACpG,oGAAoG;IACpG,MAAM,MAAM,GAAG,oBAAoB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/G,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAE1B,OAAO,YAAY,CAAC;QAClB,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,qBAAqB;QAC9C,QAAQ,EAAE,OAAO,EAAE,QAAQ,IAAI,oCAAoC,EAAE;QACrE,CAAC,iCAAiC,CAAC,EAAE;YACnC,QAAQ,EAAE,IAAI,GAAG,EAAE;YACnB,MAAM;YACN,QAAQ,EAAE,IAAI,GAAG,EAAE;YACnB,OAAO,EAAE,IAAI;SACd;KACF,CAAC,CAAC;AACL,CAAC;AAED,iGAAiG;AACjG,mGAAmG;AACnG,MAAM,UAAU,8BAA8B,CAAC,QAAiC;IAC9E,MAAM,OAAO,GAAI,QAA+C,CAAC,iCAAiC,CAAC,CAAC;IACpG,kBAAkB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACnC,qBAAqB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACtC,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;QAC9C,KAAK,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;IACD,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;AAC3B,CAAC"}

package/dist/sceneResourceSignals.d.ts

@@ -0,0 +1,5 @@
+import type { Scene3DResourceResolver, Scene3DResourceSignals } from '@flighthq/types';
+export declare function createScene3DResourceSignals(): Scene3DResourceSignals;
+export declare function enableScene3DResourceSignals(resolver: Scene3DResourceResolver): Scene3DResourceSignals;
+export declare function getScene3DResourceSignals(resolver: Readonly<Scene3DResourceResolver>): Scene3DResourceSignals | null;
+//# sourceMappingURL=sceneResourceSignals.d.ts.map

package/dist/sceneResourceSignals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sceneResourceSignals.d.ts","sourceRoot":"","sources":["../src/sceneResourceSignals.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAIvF,wBAAgB,4BAA4B,IAAI,sBAAsB,CAErE;AAID,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,uBAAuB,GAAG,sBAAsB,CAMtG;AAGD,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,QAAQ,CAAC,uBAAuB,CAAC,GAAG,sBAAsB,GAAG,IAAI,CAEpH"}

package/dist/sceneResourceSignals.js

@@ -0,0 +1,21 @@
+import { createEntity } from '@flighthq/entity';
+import { createSignal } from '@flighthq/signals';
+import { Scene3DResourceResolverRuntimeKey } from '@flighthq/types';
+export function createScene3DResourceSignals() {
+    return createEntity({ onResourceFailed: createSignal(), onResourceResolved: createSignal() });
+}
+// Enables (once) and returns the resolver's availability signals. Idempotent: repeated calls return
+// the same group so listeners connected earlier stay attached.
+export function enableScene3DResourceSignals(resolver) {
+    const runtime = resolver[Scene3DResourceResolverRuntimeKey];
+    if (runtime.signals !== null)
+        return runtime.signals;
+    const signals = createScene3DResourceSignals();
+    runtime.signals = signals;
+    return signals;
+}
+// Returns the resolver's availability signals, or `null` when they were never enabled.
+export function getScene3DResourceSignals(resolver) {
+    return resolver[Scene3DResourceResolverRuntimeKey].signals;
+}
+//# sourceMappingURL=sceneResourceSignals.js.map

package/dist/sceneResourceSignals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sceneResourceSignals.js","sourceRoot":"","sources":["../src/sceneResourceSignals.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,iCAAiC,EAAE,MAAM,iBAAiB,CAAC;AAGpE,MAAM,UAAU,4BAA4B;IAC1C,OAAO,YAAY,CAAC,EAAE,gBAAgB,EAAE,YAAY,EAAE,EAAE,kBAAkB,EAAE,YAAY,EAAE,EAAE,CAAC,CAAC;AAChG,CAAC;AAED,oGAAoG;AACpG,+DAA+D;AAC/D,MAAM,UAAU,4BAA4B,CAAC,QAAiC;IAC5E,MAAM,OAAO,GAAI,QAA+C,CAAC,iCAAiC,CAAC,CAAC;IACpG,IAAI,OAAO,CAAC,OAAO,KAAK,IAAI;QAAE,OAAO,OAAO,CAAC,OAAO,CAAC;IACrD,MAAM,OAAO,GAAG,4BAA4B,EAAE,CAAC;IAC/C,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC;IAC1B,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,yBAAyB,CAAC,QAA2C;IACnF,OAAQ,QAA+C,CAAC,iCAAiC,CAAC,CAAC,OAAO,CAAC;AACrG,CAAC"}

package/dist/threeDsLoad.d.ts

@@ -0,0 +1,3 @@
+import type { Scene3DDocument, Scene3DDocumentLoadOptions } from '@flighthq/types';
+export declare function loadScene3DDocumentFrom3dsUrl(url: string, options?: Readonly<Scene3DDocumentLoadOptions>): Promise<Scene3DDocument | null>;
+//# sourceMappingURL=threeDsLoad.d.ts.map

package/dist/threeDsLoad.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"threeDsLoad.d.ts","sourceRoot":"","sources":["../src/threeDsLoad.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAOnF,wBAAsB,6BAA6B,CACjD,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,QAAQ,CAAC,0BAA0B,CAAC,GAC7C,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAMjC"}

package/dist/threeDsLoad.js

@@ -0,0 +1,14 @@
+import { parse3ds } from '@flighthq/scene3d-formats';
+import { loadScene3DDocumentBytesFromUrl, setScene3DDocumentResourceBasePathFromUrl } from './sceneDocumentSource';
+// Fetches an Autodesk 3DS binary from a URL and parses it into a format-neutral Scene3DDocument. Fetches only
+// the FILE — the document's texture refs stay unresolved; assemble with createScene3DFromDocument and resolve
+// on your own schedule. Returns null on transport failure; it never creates a renderer or GPU resource.
+export async function loadScene3DDocumentFrom3dsUrl(url, options) {
+    const bytes = await loadScene3DDocumentBytesFromUrl(url, options);
+    if (bytes === null)
+        return null;
+    const document = parse3ds(bytes);
+    setScene3DDocumentResourceBasePathFromUrl(document, url);
+    return document;
+}
+//# sourceMappingURL=threeDsLoad.js.map

package/dist/threeDsLoad.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"threeDsLoad.js","sourceRoot":"","sources":["../src/threeDsLoad.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAGrD,OAAO,EAAE,+BAA+B,EAAE,yCAAyC,EAAE,MAAM,uBAAuB,CAAC;AAEnH,8GAA8G;AAC9G,8GAA8G;AAC9G,wGAAwG;AACxG,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,GAAW,EACX,OAA8C;IAE9C,MAAM,KAAK,GAAG,MAAM,+BAA+B,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAClE,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAChC,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACjC,yCAAyC,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IACzD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@flighthq/scene3d-resources",
+  "version": "0.2.1-next.840.857425c",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/flighthq/flight.git",
+    "directory": "packages/scene3d-resources"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src/**/*.test.ts",
+    "!dist/**/*.test.js",
+    "!dist/**/*.test.d.ts",
+    "!dist/**/*.test.js.map",
+    "!dist/**/*.test.d.ts.map"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "tsc -b --clean",
+    "test": "vitest run --config vitest.config.ts",
+    "test:watch": "vitest --watch --config vitest.config.ts",
+    "prepack": "npm run clean && npm run clean:dist && npm run build",
+    "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
+  },
+  "dependencies": {
+    "@flighthq/entity": "0.2.1-next.840.857425c",
+    "@flighthq/image": "0.2.1-next.840.857425c",
+    "@flighthq/loader": "0.2.1-next.840.857425c",
+    "@flighthq/log": "0.2.1-next.840.857425c",
+    "@flighthq/net": "0.2.1-next.840.857425c",
+    "@flighthq/node": "0.2.1-next.840.857425c",
+    "@flighthq/scene3d": "0.2.1-next.840.857425c",
+    "@flighthq/scene3d-formats": "0.2.1-next.840.857425c",
+    "@flighthq/signals": "0.2.1-next.840.857425c",
+    "@flighthq/tween": "0.2.1-next.840.857425c",
+    "@flighthq/types": "0.2.1-next.840.857425c"
+  },
+  "devDependencies": {
+    "@flighthq/materials": "*",
+    "@flighthq/mesh": "*",
+    "@flighthq/texture": "*",
+    "typescript": "^5.3.0"
+  },
+  "description": "Renderer-neutral scene-document URL acquisition and caller-driven resolution of scene texture references into live ImageResources",
+  "sideEffects": false
+}