@flighthq/scene2d-resources 0.3.0-edge.1458.0c01b63

package/dist/builtInScene2DDocumentImporters.d.ts

@@ -0,0 +1,4 @@
+import type { Scene2DDocumentImporterRegistry } from '@flighthq/types/contract';
+export declare function registerLottieScene2DDocumentImporter(registry: Scene2DDocumentImporterRegistry): void;
+export declare function registerSvgScene2DDocumentImporter(registry: Scene2DDocumentImporterRegistry): void;
+//# sourceMappingURL=builtInScene2DDocumentImporters.d.ts.map

package/dist/builtInScene2DDocumentImporters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtInScene2DDocumentImporters.d.ts","sourceRoot":"","sources":["../src/builtInScene2DDocumentImporters.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAIV,+BAA+B,EAChC,MAAM,0BAA0B,CAAC;AAMlC,wBAAgB,qCAAqC,CAAC,QAAQ,EAAE,+BAA+B,GAAG,IAAI,CAErG;AAED,wBAAgB,kCAAkC,CAAC,QAAQ,EAAE,+BAA+B,GAAG,IAAI,CAElG"}

package/dist/builtInScene2DDocumentImporters.js

@@ -0,0 +1,43 @@
+import { createScene2DFromLottieDocument, createScene2DFromSvgDocument } from '@flighthq/scene2d-formats/contract';
+import { ImportDiagnosticSeverity } from '@flighthq/types/contract';
+import { createScene2DDocument } from './scene2DDocument';
+import { registerScene2DDocumentImporter } from './scene2DDocumentImporterRegistry';
+export function registerLottieScene2DDocumentImporter(registry) {
+    registerScene2DDocumentImporter(registry, 'lottie', matchesLottieDocument, importLottieDocument);
+}
+export function registerSvgScene2DDocumentImporter(registry) {
+    registerScene2DDocumentImporter(registry, 'svg', matchesSvgDocument, importSvgDocument);
+}
+function importLottieDocument(source, _context) {
+    const diagnostics = [];
+    const result = createScene2DFromLottieDocument(decodeText(source), diagnostics);
+    if (isInvalidDocument(diagnostics, 'lottie.invalid-document'))
+        return null;
+    return createScene2DDocument(result.root, [], 'lottie');
+}
+function importSvgDocument(source, _context) {
+    const diagnostics = [];
+    const root = createScene2DFromSvgDocument(decodeText(source), diagnostics);
+    if (isInvalidDocument(diagnostics, 'svg.invalid-document'))
+        return null;
+    return createScene2DDocument(root, [], 'svg');
+}
+function matchesLottieDocument(source, context) {
+    if (context.mimeType === 'application/lottie+json')
+        return true;
+    const text = decodeText(source).trimStart();
+    return text.startsWith('{') && text.includes('"layers"') && text.includes('"fr"');
+}
+function matchesSvgDocument(source, context) {
+    if (context.mimeType === 'image/svg+xml')
+        return true;
+    return /^(?:<\?xml[^>]*>\s*)?<svg(?:\s|>)/i.test(decodeText(source).trimStart());
+}
+function decodeText(source) {
+    return _decoder.decode(source);
+}
+function isInvalidDocument(diagnostics, kind) {
+    return diagnostics.some((diagnostic) => diagnostic.kind === kind && diagnostic.severity === ImportDiagnosticSeverity.Reject);
+}
+const _decoder = new TextDecoder();
+//# sourceMappingURL=builtInScene2DDocumentImporters.js.map

package/dist/builtInScene2DDocumentImporters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtInScene2DDocumentImporters.js","sourceRoot":"","sources":["../src/builtInScene2DDocumentImporters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,+BAA+B,EAAE,4BAA4B,EAAE,MAAM,oCAAoC,CAAC;AAOnH,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAEpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,+BAA+B,EAAE,MAAM,mCAAmC,CAAC;AAEpF,MAAM,UAAU,qCAAqC,CAAC,QAAyC;IAC7F,+BAA+B,CAAC,QAAQ,EAAE,QAAQ,EAAE,qBAAqB,EAAE,oBAAoB,CAAC,CAAC;AACnG,CAAC;AAED,MAAM,UAAU,kCAAkC,CAAC,QAAyC;IAC1F,+BAA+B,CAAC,QAAQ,EAAE,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,CAAC,CAAC;AAC1F,CAAC;AAED,SAAS,oBAAoB,CAC3B,MAAkB,EAClB,QAAgD;IAEhD,MAAM,WAAW,GAAuB,EAAE,CAAC;IAC3C,MAAM,MAAM,GAAG,+BAA+B,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC,CAAC;IAChF,IAAI,iBAAiB,CAAC,WAAW,EAAE,yBAAyB,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3E,OAAO,qBAAqB,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,QAAQ,CAAC,CAAC;AAC1D,CAAC;AAED,SAAS,iBAAiB,CACxB,MAAkB,EAClB,QAAgD;IAEhD,MAAM,WAAW,GAAuB,EAAE,CAAC;IAC3C,MAAM,IAAI,GAAG,4BAA4B,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC,CAAC;IAC3E,IAAI,iBAAiB,CAAC,WAAW,EAAE,sBAAsB,CAAC;QAAE,OAAO,IAAI,CAAC;IACxE,OAAO,qBAAqB,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,qBAAqB,CAAC,MAAkB,EAAE,OAA+C;IAChG,IAAI,OAAO,CAAC,QAAQ,KAAK,yBAAyB;QAAE,OAAO,IAAI,CAAC;IAChE,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,CAAC;IAC5C,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AACpF,CAAC;AAED,SAAS,kBAAkB,CAAC,MAAkB,EAAE,OAA+C;IAC7F,IAAI,OAAO,CAAC,QAAQ,KAAK,eAAe;QAAE,OAAO,IAAI,CAAC;IACtD,OAAO,oCAAoC,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;AACnF,CAAC;AAED,SAAS,UAAU,CAAC,MAAkB;IACpC,OAAO,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AACjC,CAAC;AAED,SAAS,iBAAiB,CAAC,WAAyC,EAAE,IAAY;IAChF,OAAO,WAAW,CAAC,IAAI,CACrB,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,KAAK,IAAI,IAAI,UAAU,CAAC,QAAQ,KAAK,wBAAwB,CAAC,MAAM,CACpG,CAAC;AACJ,CAAC;AAED,MAAM,QAAQ,GAAG,IAAI,WAAW,EAAE,CAAC"}

package/dist/contract.d.ts

@@ -0,0 +1,7 @@
+export * from './builtInScene2DDocumentImporters';
+export * from './loadScene2DResources';
+export * from './resolveScene2DResources';
+export * from './scene2DDocument';
+export * from './scene2DDocumentImporterRegistry';
+export * from './scene2DDocumentSource';
+//# sourceMappingURL=contract.d.ts.map

package/dist/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,mCAAmC,CAAC;AAClD,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,mCAAmC,CAAC;AAClD,cAAc,yBAAyB,CAAC"}

package/dist/contract.js

@@ -0,0 +1,7 @@
+export * from './builtInScene2DDocumentImporters';
+export * from './loadScene2DResources';
+export * from './resolveScene2DResources';
+export * from './scene2DDocument';
+export * from './scene2DDocumentImporterRegistry';
+export * from './scene2DDocumentSource';
+//# sourceMappingURL=contract.js.map

package/dist/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,mCAAmC,CAAC;AAClD,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,mCAAmC,CAAC;AAClD,cAAc,yBAAyB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { createScene2DAssetReference, createScene2DDocument, createScene2DDocumentFromBytes, createScene2DDocumentImporterRegistry, createScene2DSlotReference, loadScene2DDocumentFromUrl, loadScene2DResources, registerLottieScene2DDocumentImporter, registerScene2DDocumentImporter, registerSvgScene2DDocumentImporter, resolveScene2DResources, unregisterScene2DDocumentImporter, } from './contract';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,qBAAqB,EACrB,8BAA8B,EAC9B,qCAAqC,EACrC,0BAA0B,EAC1B,0BAA0B,EAC1B,oBAAoB,EACpB,qCAAqC,EACrC,+BAA+B,EAC/B,kCAAkC,EAClC,uBAAuB,EACvB,iCAAiC,GAClC,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { createScene2DAssetReference, createScene2DDocument, createScene2DDocumentFromBytes, createScene2DDocumentImporterRegistry, createScene2DSlotReference, loadScene2DDocumentFromUrl, loadScene2DResources, registerLottieScene2DDocumentImporter, registerScene2DDocumentImporter, registerSvgScene2DDocumentImporter, resolveScene2DResources, unregisterScene2DDocumentImporter, } from './contract';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,qBAAqB,EACrB,8BAA8B,EAC9B,qCAAqC,EACrC,0BAA0B,EAC1B,0BAA0B,EAC1B,oBAAoB,EACpB,qCAAqC,EACrC,+BAA+B,EAC/B,kCAAkC,EAClC,uBAAuB,EACvB,iCAAiC,GAClC,MAAM,YAAY,CAAC"}

package/dist/loadScene2DResources.d.ts

@@ -0,0 +1,3 @@
+import type { LoadScene2DResourcesOptions, Scene2DDocument, Scene2DResources } from '@flighthq/types/contract';
+export declare function loadScene2DResources(document: Scene2DDocument, options: Readonly<LoadScene2DResourcesOptions>): Promise<Scene2DResources>;
+//# sourceMappingURL=loadScene2DResources.d.ts.map

package/dist/loadScene2DResources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadScene2DResources.d.ts","sourceRoot":"","sources":["../src/loadScene2DResources.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,2BAA2B,EAG3B,eAAe,EAEf,gBAAgB,EACjB,MAAM,0BAA0B,CAAC;AAOlC,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,QAAQ,CAAC,2BAA2B,CAAC,GAC7C,OAAO,CAAC,gBAAgB,CAAC,CAuB3B"}

package/dist/loadScene2DResources.js

@@ -0,0 +1,47 @@
+import { emitSignal } from '@flighthq/signals/contract';
+import { Scene2DContentReferenceKind } from '@flighthq/types/contract';
+import { setScene2DContentReferenceContent } from './scene2DContentReference';
+// Operation-scoped asynchronous boundary. Slot fills remain synchronous and code-driven; only asset
+// references cross the caller-supplied Promise seam. No resolver state survives this call.
+export async function loadScene2DResources(document, options) {
+    const selected = document.references.filter((reference) => options.select === undefined || options.select(reference));
+    const signal = options.signal ?? new AbortController().signal;
+    let loaded = 0;
+    const loads = selected.map(async (reference) => {
+        try {
+            if (reference.kind === Scene2DContentReferenceKind.Slot) {
+                return options.resolveSlotContent?.(reference.name, reference.linkage) ?? null;
+            }
+            return await options.loadAssetContent(reference.name, reference.uri, signal);
+        }
+        finally {
+            loaded++;
+            emitScene2DResourceLoadProgress(options, loaded, selected.length, reference);
+        }
+    });
+    const contents = await Promise.all(loads);
+    const resolved = [];
+    const unresolved = [];
+    for (let i = 0; i < selected.length; i++) {
+        reconcileLoadedScene2DContent(selected[i], contents[i], resolved, unresolved);
+    }
+    return { document, resolved, root: document.root, unresolved };
+}
+function emitScene2DResourceLoadProgress(options, loaded, total, reference) {
+    if (options.progress === undefined)
+        return;
+    emitSignal(options.progress, {
+        kind: reference.kind,
+        loaded,
+        name: reference.name,
+        total,
+    });
+}
+function reconcileLoadedScene2DContent(reference, content, resolved, unresolved) {
+    setScene2DContentReferenceContent(reference, content);
+    if (content === null)
+        unresolved.push(reference);
+    else
+        resolved.push({ content, reference });
+}
+//# sourceMappingURL=loadScene2DResources.js.map

package/dist/loadScene2DResources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadScene2DResources.js","sourceRoot":"","sources":["../src/loadScene2DResources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AASxD,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAEvE,OAAO,EAAE,iCAAiC,EAAE,MAAM,2BAA2B,CAAC;AAE9E,oGAAoG;AACpG,2FAA2F;AAC3F,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,QAAyB,EACzB,OAA8C;IAE9C,MAAM,QAAQ,GAAG,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;IACtH,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC,MAAM,CAAC;IAC9D,IAAI,MAAM,GAAG,CAAC,CAAC;IAEf,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,EAA0B,EAAE;QACrE,IAAI,CAAC;YACH,IAAI,SAAS,CAAC,IAAI,KAAK,2BAA2B,CAAC,IAAI,EAAE,CAAC;gBACxD,OAAO,OAAO,CAAC,kBAAkB,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;YACjF,CAAC;YACD,OAAO,MAAM,OAAO,CAAC,gBAAgB,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC/E,CAAC;gBAAS,CAAC;YACT,MAAM,EAAE,CAAC;YACT,+BAA+B,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAgC,EAAE,CAAC;IACjD,MAAM,UAAU,GAA8B,EAAE,CAAC;IACjD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,6BAA6B,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;IAChF,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC;AACjE,CAAC;AAED,SAAS,+BAA+B,CACtC,OAA8C,EAC9C,MAAc,EACd,KAAa,EACb,SAA4C;IAE5C,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS;QAAE,OAAO;IAC3C,UAAU,CAAC,OAAO,CAAC,QAAQ,EAAE;QAC3B,IAAI,EAAE,SAAS,CAAC,IAAI;QACpB,MAAM;QACN,IAAI,EAAE,SAAS,CAAC,IAAI;QACpB,KAAK;KACN,CAAC,CAAC;AACL,CAAC;AAED,SAAS,6BAA6B,CACpC,SAAkC,EAClC,OAAsB,EACtB,QAAqC,EACrC,UAAqC;IAErC,iCAAiC,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACtD,IAAI,OAAO,KAAK,IAAI;QAAE,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;;QAC5C,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;AAC7C,CAAC"}

package/dist/resolveScene2DResources.d.ts

@@ -0,0 +1,3 @@
+import type { ResolveScene2DResourcesOptions, Scene2DDocument, Scene2DResources } from '@flighthq/types/contract';
+export declare function resolveScene2DResources(document: Scene2DDocument, options?: Readonly<ResolveScene2DResourcesOptions>): Scene2DResources;
+//# sourceMappingURL=resolveScene2DResources.d.ts.map

package/dist/resolveScene2DResources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveScene2DResources.d.ts","sourceRoot":"","sources":["../src/resolveScene2DResources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,8BAA8B,EAE9B,eAAe,EACf,gBAAgB,EACjB,MAAM,0BAA0B,CAAC;AAQlC,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,eAAe,EACzB,OAAO,CAAC,EAAE,QAAQ,CAAC,8BAA8B,CAAC,GACjD,gBAAgB,CAgBlB"}

package/dist/resolveScene2DResources.js

@@ -0,0 +1,31 @@
+import { Scene2DContentReferenceKind } from '@flighthq/types/contract';
+import { setScene2DContentReferenceContent } from './scene2DContentReference';
+// Reconciles one caller-selected working set entirely synchronously. Asset content must already be
+// available through resolveAssetContent; application slots resolve by name/linkage. This function performs
+// no fetch, decode, Promise scheduling, or registry dispatch.
+export function resolveScene2DResources(document, options) {
+    const resolved = [];
+    const unresolved = [];
+    for (let i = 0; i < document.references.length; i++) {
+        const reference = document.references[i];
+        if (options?.select !== undefined && !options.select(reference))
+            continue;
+        const content = resolveScene2DContentReference(reference, options);
+        if (content === null) {
+            setScene2DContentReferenceContent(reference, null);
+            unresolved.push(reference);
+        }
+        else {
+            setScene2DContentReferenceContent(reference, content);
+            resolved.push({ content, reference });
+        }
+    }
+    return { document, resolved, root: document.root, unresolved };
+}
+function resolveScene2DContentReference(reference, options) {
+    if (reference.kind === Scene2DContentReferenceKind.Asset) {
+        return options?.resolveAssetContent?.(reference.name, reference.uri) ?? null;
+    }
+    return options?.resolveSlotContent?.(reference.name, reference.linkage) ?? null;
+}
+//# sourceMappingURL=resolveScene2DResources.js.map

package/dist/resolveScene2DResources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveScene2DResources.js","sourceRoot":"","sources":["../src/resolveScene2DResources.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAEvE,OAAO,EAAE,iCAAiC,EAAE,MAAM,2BAA2B,CAAC;AAE9E,mGAAmG;AACnG,2GAA2G;AAC3G,8DAA8D;AAC9D,MAAM,UAAU,uBAAuB,CACrC,QAAyB,EACzB,OAAkD;IAElD,MAAM,QAAQ,GAAiC,EAAE,CAAC;IAClD,MAAM,UAAU,GAA8B,EAAE,CAAC;IACjD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpD,MAAM,SAAS,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACzC,IAAI,OAAO,EAAE,MAAM,KAAK,SAAS,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC;YAAE,SAAS;QAC1E,MAAM,OAAO,GAAG,8BAA8B,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACnE,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,iCAAiC,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;YACnD,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC7B,CAAC;aAAM,CAAC;YACN,iCAAiC,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACtD,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC;AACjE,CAAC;AAED,SAAS,8BAA8B,CACrC,SAA4C,EAC5C,OAA6D;IAE7D,IAAI,SAAS,CAAC,IAAI,KAAK,2BAA2B,CAAC,KAAK,EAAE,CAAC;QACzD,OAAO,OAAO,EAAE,mBAAmB,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;IAC/E,CAAC;IACD,OAAO,OAAO,EAAE,kBAAkB,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;AAClF,CAAC"}

package/dist/scene2DContentReference.d.ts

@@ -0,0 +1,3 @@
+import type { Node2D, Scene2DContentReference } from '@flighthq/types/contract';
+export declare function setScene2DContentReferenceContent(reference: Scene2DContentReference, content: Node2D | null): void;
+//# sourceMappingURL=scene2DContentReference.d.ts.map

package/dist/scene2DContentReference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene2DContentReference.d.ts","sourceRoot":"","sources":["../src/scene2DContentReference.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAEhF,wBAAgB,iCAAiC,CAAC,SAAS,EAAE,uBAAuB,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAQlH"}

package/dist/scene2DContentReference.js

@@ -0,0 +1,13 @@
+import { addNodeChild, getNodeParent, removeNodeChild } from '@flighthq/node/contract';
+export function setScene2DContentReferenceContent(reference, content) {
+    const previous = reference.content;
+    if (previous === content && (content === null || getNodeParent(content) === reference.target))
+        return;
+    if (previous !== null && getNodeParent(previous) === reference.target) {
+        removeNodeChild(reference.target, previous);
+    }
+    reference.content = content;
+    if (content !== null)
+        addNodeChild(reference.target, content);
+}
+//# sourceMappingURL=scene2DContentReference.js.map

package/dist/scene2DContentReference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene2DContentReference.js","sourceRoot":"","sources":["../src/scene2DContentReference.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAGvF,MAAM,UAAU,iCAAiC,CAAC,SAAkC,EAAE,OAAsB;IAC1G,MAAM,QAAQ,GAAG,SAAS,CAAC,OAAO,CAAC;IACnC,IAAI,QAAQ,KAAK,OAAO,IAAI,CAAC,OAAO,KAAK,IAAI,IAAI,aAAa,CAAC,OAAO,CAAC,KAAK,SAAS,CAAC,MAAM,CAAC;QAAE,OAAO;IACtG,IAAI,QAAQ,KAAK,IAAI,IAAI,aAAa,CAAC,QAAQ,CAAC,KAAK,SAAS,CAAC,MAAM,EAAE,CAAC;QACtE,eAAe,CAAC,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC9C,CAAC;IACD,SAAS,CAAC,OAAO,GAAG,OAAO,CAAC;IAC5B,IAAI,OAAO,KAAK,IAAI;QAAE,YAAY,CAAC,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAChE,CAAC"}

package/dist/scene2DDocument.d.ts

@@ -0,0 +1,5 @@
+import type { Node2D, Scene2DAssetReference, Scene2DContentReference, Scene2DDocument, Scene2DSlotReference } from '@flighthq/types/contract';
+export declare function createScene2DAssetReference(name: string, uri: string, target: Node2D, required?: boolean): Scene2DAssetReference;
+export declare function createScene2DDocument(root: Node2D, references?: Scene2DContentReference[], sourceKind?: string | null): Scene2DDocument;
+export declare function createScene2DSlotReference(name: string, target: Node2D, linkage?: string | null, required?: boolean): Scene2DSlotReference;
+//# sourceMappingURL=scene2DDocument.d.ts.map

package/dist/scene2DDocument.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene2DDocument.d.ts","sourceRoot":"","sources":["../src/scene2DDocument.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,MAAM,EACN,qBAAqB,EACrB,uBAAuB,EACvB,eAAe,EACf,oBAAoB,EACrB,MAAM,0BAA0B,CAAC;AAGlC,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,QAAQ,UAAO,GACd,qBAAqB,CAGvB;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,uBAAuB,EAAO,EAC1C,UAAU,GAAE,MAAM,GAAG,IAAW,GAC/B,eAAe,CAEjB;AAED,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,MAAM,GAAG,IAAW,EAC7B,QAAQ,UAAO,GACd,oBAAoB,CAGtB"}

package/dist/scene2DDocument.js

@@ -0,0 +1,13 @@
+import { Scene2DContentReferenceKind } from '@flighthq/types/contract';
+export function createScene2DAssetReference(name, uri, target, required = true) {
+    target.name = name;
+    return { content: null, kind: Scene2DContentReferenceKind.Asset, name, required, target, uri };
+}
+export function createScene2DDocument(root, references = [], sourceKind = null) {
+    return { references, root, sourceKind };
+}
+export function createScene2DSlotReference(name, target, linkage = null, required = true) {
+    target.name = name;
+    return { content: null, kind: Scene2DContentReferenceKind.Slot, linkage, name, required, target };
+}
+//# sourceMappingURL=scene2DDocument.js.map

package/dist/scene2DDocument.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene2DDocument.js","sourceRoot":"","sources":["../src/scene2DDocument.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAEvE,MAAM,UAAU,2BAA2B,CACzC,IAAY,EACZ,GAAW,EACX,MAAc,EACd,QAAQ,GAAG,IAAI;IAEf,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,2BAA2B,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;AACjG,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,IAAY,EACZ,aAAwC,EAAE,EAC1C,aAA4B,IAAI;IAEhC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,IAAY,EACZ,MAAc,EACd,UAAyB,IAAI,EAC7B,QAAQ,GAAG,IAAI;IAEf,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,2BAA2B,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;AACpG,CAAC"}

package/dist/scene2DDocumentImporterRegistry.d.ts

@@ -0,0 +1,6 @@
+import type { Scene2DDocument, Scene2DDocumentImportContext, Scene2DDocumentImporter, Scene2DDocumentImporterMatcher, Scene2DDocumentImporterRegistry } from '@flighthq/types/contract';
+export declare function createScene2DDocumentFromBytes(source: Uint8Array, registry: Readonly<Scene2DDocumentImporterRegistry>, context?: Readonly<Scene2DDocumentImportContext>): Scene2DDocument | null;
+export declare function createScene2DDocumentImporterRegistry(): Scene2DDocumentImporterRegistry;
+export declare function registerScene2DDocumentImporter(registry: Scene2DDocumentImporterRegistry, kind: string, matches: Scene2DDocumentImporterMatcher, importDocument: Scene2DDocumentImporter): void;
+export declare function unregisterScene2DDocumentImporter(registry: Scene2DDocumentImporterRegistry, kind: string): boolean;
+//# sourceMappingURL=scene2DDocumentImporterRegistry.d.ts.map

package/dist/scene2DDocumentImporterRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene2DDocumentImporterRegistry.d.ts","sourceRoot":"","sources":["../src/scene2DDocumentImporterRegistry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,eAAe,EACf,4BAA4B,EAC5B,uBAAuB,EACvB,8BAA8B,EAC9B,+BAA+B,EAChC,MAAM,0BAA0B,CAAC;AAElC,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,QAAQ,CAAC,+BAA+B,CAAC,EACnD,OAAO,GAAE,QAAQ,CAAC,4BAA4B,CAAiC,GAC9E,eAAe,GAAG,IAAI,CASxB;AAED,wBAAgB,qCAAqC,IAAI,+BAA+B,CAEvF;AAED,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,+BAA+B,EACzC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,8BAA8B,EACvC,cAAc,EAAE,uBAAuB,GACtC,IAAI,CAKN;AAED,wBAAgB,iCAAiC,CAAC,QAAQ,EAAE,+BAA+B,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAKlH"}

package/dist/scene2DDocumentImporterRegistry.js

@@ -0,0 +1,32 @@
+import { createEntity } from '@flighthq/entity/contract';
+export function createScene2DDocumentFromBytes(source, registry, context = { mimeType: null, url: null }) {
+    for (let i = 0; i < registry.entries.length; i++) {
+        const entry = registry.entries[i];
+        if (!entry.matches(source, context))
+            continue;
+        const document = entry.importDocument(source, context);
+        if (document !== null && document.sourceKind === null)
+            document.sourceKind = entry.kind;
+        return document;
+    }
+    return null;
+}
+export function createScene2DDocumentImporterRegistry() {
+    return createEntity({ entries: [] });
+}
+export function registerScene2DDocumentImporter(registry, kind, matches, importDocument) {
+    const index = registry.entries.findIndex((entry) => entry.kind === kind);
+    const entry = { importDocument, kind, matches };
+    if (index === -1)
+        registry.entries.push(entry);
+    else
+        registry.entries[index] = entry;
+}
+export function unregisterScene2DDocumentImporter(registry, kind) {
+    const index = registry.entries.findIndex((entry) => entry.kind === kind);
+    if (index === -1)
+        return false;
+    registry.entries.splice(index, 1);
+    return true;
+}
+//# sourceMappingURL=scene2DDocumentImporterRegistry.js.map

package/dist/scene2DDocumentImporterRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene2DDocumentImporterRegistry.js","sourceRoot":"","sources":["../src/scene2DDocumentImporterRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AASzD,MAAM,UAAU,8BAA8B,CAC5C,MAAkB,EAClB,QAAmD,EACnD,UAAkD,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE;IAE/E,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACjD,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC;YAAE,SAAS;QAC9C,MAAM,QAAQ,GAAG,KAAK,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACvD,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,CAAC,UAAU,KAAK,IAAI;YAAE,QAAQ,CAAC,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC;QACxF,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,qCAAqC;IACnD,OAAO,YAAY,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,+BAA+B,CAC7C,QAAyC,EACzC,IAAY,EACZ,OAAuC,EACvC,cAAuC;IAEvC,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IACzE,MAAM,KAAK,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAChD,IAAI,KAAK,KAAK,CAAC,CAAC;QAAE,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;;QAC1C,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,iCAAiC,CAAC,QAAyC,EAAE,IAAY;IACvG,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IACzE,IAAI,KAAK,KAAK,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAC/B,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAClC,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/scene2DDocumentSource.d.ts

@@ -0,0 +1,3 @@
+import type { Scene2DDocument, Scene2DDocumentFetcher, Scene2DDocumentImporterRegistry, Scene2DDocumentLoadOptions } from '@flighthq/types/contract';
+export declare function loadScene2DDocumentFromUrl(url: string, registry: Readonly<Scene2DDocumentImporterRegistry>, fetchDocument: Scene2DDocumentFetcher, options?: Readonly<Scene2DDocumentLoadOptions>): Promise<Scene2DDocument | null>;
+//# sourceMappingURL=scene2DDocumentSource.d.ts.map

package/dist/scene2DDocumentSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene2DDocumentSource.d.ts","sourceRoot":"","sources":["../src/scene2DDocumentSource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,sBAAsB,EACtB,+BAA+B,EAC/B,0BAA0B,EAC3B,MAAM,0BAA0B,CAAC;AAIlC,wBAAsB,0BAA0B,CAC9C,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,QAAQ,CAAC,+BAA+B,CAAC,EACnD,aAAa,EAAE,sBAAsB,EACrC,OAAO,CAAC,EAAE,QAAQ,CAAC,0BAA0B,CAAC,GAC7C,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAQjC"}

package/dist/scene2DDocumentSource.js

@@ -0,0 +1,12 @@
+import { createScene2DDocumentFromBytes } from './scene2DDocumentImporterRegistry';
+export async function loadScene2DDocumentFromUrl(url, registry, fetchDocument, options) {
+    const signal = options?.signal ?? new AbortController().signal;
+    const source = await fetchDocument(url, signal, options?.progress ?? null);
+    if (source === null)
+        return null;
+    return createScene2DDocumentFromBytes(source, registry, {
+        mimeType: options?.mimeType ?? null,
+        url,
+    });
+}
+//# sourceMappingURL=scene2DDocumentSource.js.map

package/dist/scene2DDocumentSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene2DDocumentSource.js","sourceRoot":"","sources":["../src/scene2DDocumentSource.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,8BAA8B,EAAE,MAAM,mCAAmC,CAAC;AAEnF,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,GAAW,EACX,QAAmD,EACnD,aAAqC,EACrC,OAA8C;IAE9C,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC,MAAM,CAAC;IAC/D,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,IAAI,IAAI,CAAC,CAAC;IAC3E,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACjC,OAAO,8BAA8B,CAAC,MAAM,EAAE,QAAQ,EAAE;QACtD,QAAQ,EAAE,OAAO,EAAE,QAAQ,IAAI,IAAI;QACnC,GAAG;KACJ,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@flighthq/scene2d-resources",
+  "version": "0.3.0-edge.1458.0c01b63",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/flighthq/flight.git",
+    "directory": "packages/scene2d-resources"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./contract": {
+      "types": "./dist/contract.d.ts",
+      "default": "./dist/contract.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.3.0-edge.1458.0c01b63",
+    "@flighthq/node": "0.3.0-edge.1458.0c01b63",
+    "@flighthq/scene2d": "0.3.0-edge.1458.0c01b63",
+    "@flighthq/scene2d-formats": "0.3.0-edge.1458.0c01b63",
+    "@flighthq/signals": "0.3.0-edge.1458.0c01b63",
+    "@flighthq/types": "0.3.0-edge.1458.0c01b63"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0"
+  },
+  "description": "Renderer-neutral Scene2D documents with explicit named asset and application slot resolution",
+  "sideEffects": false
+}

package/src/builtInScene2DDocumentImporters.test.ts

@@ -0,0 +1,59 @@
+import { getNodeChildCount } from '@flighthq/node/contract';
+
+import {
+  registerLottieScene2DDocumentImporter,
+  registerSvgScene2DDocumentImporter,
+} from './builtInScene2DDocumentImporters';
+import {
+  createScene2DDocumentFromBytes,
+  createScene2DDocumentImporterRegistry,
+} from './scene2DDocumentImporterRegistry';
+
+const encode = (source: string) => new TextEncoder().encode(source);
+
+describe('registerLottieScene2DDocumentImporter', () => {
+  it('adds an opt-in Bodymovin codec without global registration', () => {
+    const registry = createScene2DDocumentImporterRegistry();
+    registerLottieScene2DDocumentImporter(registry);
+    const document = createScene2DDocumentFromBytes(
+      encode('{"v":"5.7.0","fr":30,"ip":0,"op":30,"w":100,"h":100,"layers":[]}'),
+      registry,
+    );
+    expect(document?.sourceKind).toBe('lottie');
+  });
+
+  it('preserves the null sentinel when the format importer rejects a document', () => {
+    const registry = createScene2DDocumentImporterRegistry();
+    registerLottieScene2DDocumentImporter(registry);
+    expect(
+      createScene2DDocumentFromBytes(encode('{invalid'), registry, {
+        mimeType: 'application/lottie+json',
+        url: null,
+      }),
+    ).toBeNull();
+  });
+});
+
+describe('registerSvgScene2DDocumentImporter', () => {
+  it('adds an opt-in SVG codec that produces a document root', () => {
+    const registry = createScene2DDocumentImporterRegistry();
+    registerSvgScene2DDocumentImporter(registry);
+    const document = createScene2DDocumentFromBytes(
+      encode('<svg xmlns="http://www.w3.org/2000/svg"><rect width="10" height="20"/></svg>'),
+      registry,
+    );
+    expect(document?.sourceKind).toBe('svg');
+    expect(getNodeChildCount(document!.root)).toBe(1);
+  });
+
+  it('preserves the null sentinel when the format importer rejects a document', () => {
+    const registry = createScene2DDocumentImporterRegistry();
+    registerSvgScene2DDocumentImporter(registry);
+    expect(
+      createScene2DDocumentFromBytes(encode('<not-svg/>'), registry, {
+        mimeType: 'image/svg+xml',
+        url: null,
+      }),
+    ).toBeNull();
+  });
+});

package/src/loadScene2DResources.test.ts

@@ -0,0 +1,81 @@
+import { getNodeParent } from '@flighthq/node/contract';
+import { createDisplayObject } from '@flighthq/scene2d/contract';
+import { connectSignal, createSignal } from '@flighthq/signals/contract';
+import type { Scene2DResourceLoadProgress } from '@flighthq/types/contract';
+
+import { loadScene2DResources } from './loadScene2DResources';
+import { createScene2DAssetReference, createScene2DDocument, createScene2DSlotReference } from './scene2DDocument';
+
+describe('loadScene2DResources', () => {
+  it('brackets async assets and synchronous slots in one result', async () => {
+    const assetTarget = createDisplayObject();
+    const slotTarget = createDisplayObject();
+    const assetContent = createDisplayObject();
+    const slotContent = createDisplayObject();
+    const document = createScene2DDocument(createDisplayObject(), [
+      createScene2DAssetReference('background', 'bg.png', assetTarget),
+      createScene2DSlotReference('avatar', slotTarget, 'Game.Avatar'),
+    ]);
+
+    const resources = await loadScene2DResources(document, {
+      loadAssetContent: async (name, uri) => (name === 'background' && uri === 'bg.png' ? assetContent : null),
+      resolveSlotContent: () => slotContent,
+    });
+
+    expect(resources.resolved).toHaveLength(2);
+    expect(getNodeParent(assetContent)).toBe(assetTarget);
+    expect(getNodeParent(slotContent)).toBe(slotTarget);
+  });
+
+  it('reports operation-scoped completion progress', async () => {
+    const progress = createSignal<(event: Readonly<Scene2DResourceLoadProgress>) => void>();
+    const events: Scene2DResourceLoadProgress[] = [];
+    connectSignal(progress, (event) => events.push({ ...event }));
+    const document = createScene2DDocument(createDisplayObject(), [
+      createScene2DAssetReference('a', 'a.png', createDisplayObject()),
+      createScene2DAssetReference('b', 'b.png', createDisplayObject()),
+    ]);
+    await loadScene2DResources(document, {
+      loadAssetContent: async () => createDisplayObject(),
+      progress,
+    });
+    expect(events.map((event) => event.loaded).sort()).toEqual([1, 2]);
+    expect(events.every((event) => event.total === 2)).toBe(true);
+  });
+
+  it('returns resolutions in manifest order when assets settle out of order', async () => {
+    let releaseFirst: (content: ReturnType<typeof createDisplayObject>) => void = () => {};
+    const first = new Promise<ReturnType<typeof createDisplayObject>>((resolve) => {
+      releaseFirst = resolve;
+    });
+    const secondContent = createDisplayObject();
+    const document = createScene2DDocument(createDisplayObject(), [
+      createScene2DAssetReference('first', 'first.png', createDisplayObject()),
+      createScene2DAssetReference('second', 'second.png', createDisplayObject()),
+    ]);
+    const operation = loadScene2DResources(document, {
+      loadAssetContent: (name) => (name === 'first' ? first : Promise.resolve(secondContent)),
+    });
+    releaseFirst(createDisplayObject());
+    const resources = await operation;
+    expect(resources.resolved.map((entry) => entry.reference.name)).toEqual(['first', 'second']);
+  });
+
+  it('relays caller cancellation into the asset loader', async () => {
+    const controller = new AbortController();
+    controller.abort('stop');
+    const received: AbortSignal[] = [];
+    const document = createScene2DDocument(createDisplayObject(), [
+      createScene2DAssetReference('a', 'a.png', createDisplayObject()),
+    ]);
+    await loadScene2DResources(document, {
+      loadAssetContent: async (_name, _uri, signal) => {
+        received.push(signal);
+        return null;
+      },
+      signal: controller.signal,
+    });
+    expect(received[0].aborted).toBe(true);
+    expect(received[0].reason).toBe('stop');
+  });
+});

package/src/resolveScene2DResources.test.ts

@@ -0,0 +1,57 @@
+import { addNodeChild, getNodeParent } from '@flighthq/node/contract';
+import { createDisplayObject } from '@flighthq/scene2d/contract';
+
+import { resolveScene2DResources } from './resolveScene2DResources';
+import { createScene2DAssetReference, createScene2DDocument, createScene2DSlotReference } from './scene2DDocument';
+
+describe('resolveScene2DResources', () => {
+  it('reconciles asset and application slot content synchronously', () => {
+    const root = createDisplayObject();
+    const assetTarget = createDisplayObject();
+    const slotTarget = createDisplayObject();
+    const assetContent = createDisplayObject();
+    const slotContent = createDisplayObject();
+    const document = createScene2DDocument(root, [
+      createScene2DAssetReference('background', 'bg.png', assetTarget),
+      createScene2DSlotReference('avatar', slotTarget, 'Game.Avatar'),
+    ]);
+
+    const resources = resolveScene2DResources(document, {
+      resolveAssetContent: (name, uri) => (name === 'background' && uri === 'bg.png' ? assetContent : null),
+      resolveSlotContent: (name, linkage) => (name === 'avatar' && linkage === 'Game.Avatar' ? slotContent : null),
+    });
+
+    expect(resources.resolved.map((entry) => entry.content)).toEqual([assetContent, slotContent]);
+    expect(resources.unresolved).toEqual([]);
+    expect(document.references[0].content).toBe(assetContent);
+    expect(document.references[1].content).toBe(slotContent);
+    expect(getNodeParent(assetContent)).toBe(assetTarget);
+    expect(getNodeParent(slotContent)).toBe(slotTarget);
+  });
+
+  it('clears stale managed content when a selected reference is unresolved', () => {
+    const target = createDisplayObject();
+    const stale = createDisplayObject();
+    const reference = createScene2DSlotReference('missing', target);
+    reference.content = stale;
+    addNodeChild(target, stale);
+    const resources = resolveScene2DResources(createScene2DDocument(createDisplayObject(), [reference]));
+    expect(resources.unresolved).toEqual([reference]);
+    expect(reference.content).toBeNull();
+    expect(getNodeParent(stale)).toBeNull();
+  });
+
+  it('leaves references outside the selected working set untouched', () => {
+    const target = createDisplayObject();
+    const existing = createDisplayObject();
+    const reference = createScene2DSlotReference('deferred', target);
+    reference.content = existing;
+    addNodeChild(target, existing);
+    const resources = resolveScene2DResources(createScene2DDocument(createDisplayObject(), [reference]), {
+      select: () => false,
+    });
+    expect(resources.resolved).toEqual([]);
+    expect(resources.unresolved).toEqual([]);
+    expect(reference.content).toBe(existing);
+  });
+});

package/src/scene2DContentReference.test.ts

@@ -0,0 +1,38 @@
+import { addNodeChild, getNodeChildAt, getNodeParent } from '@flighthq/node/contract';
+import { createDisplayObject } from '@flighthq/scene2d/contract';
+
+import { setScene2DContentReferenceContent } from './scene2DContentReference';
+import { createScene2DSlotReference } from './scene2DDocument';
+
+describe('setScene2DContentReferenceContent', () => {
+  it('keeps child order stable when a resolve pass retains the same content', () => {
+    const target = createDisplayObject();
+    const content = createDisplayObject();
+    const overlay = createDisplayObject();
+    const reference = createScene2DSlotReference('slot', target);
+    setScene2DContentReferenceContent(reference, content);
+    addNodeChild(target, overlay);
+
+    setScene2DContentReferenceContent(reference, content);
+
+    expect(getNodeChildAt(target, 0)).toBe(content);
+    expect(getNodeChildAt(target, 1)).toBe(overlay);
+  });
+
+  it('replaces only the content retained by the manifest reference', () => {
+    const target = createDisplayObject();
+    const authored = createDisplayObject();
+    const first = createDisplayObject();
+    const second = createDisplayObject();
+    addNodeChild(target, authored);
+    const reference = createScene2DSlotReference('slot', target);
+
+    setScene2DContentReferenceContent(reference, first);
+    setScene2DContentReferenceContent(reference, second);
+
+    expect(reference.content).toBe(second);
+    expect(getNodeParent(authored)).toBe(target);
+    expect(getNodeParent(first)).toBeNull();
+    expect(getNodeParent(second)).toBe(target);
+  });
+});

package/src/scene2DDocument.test.ts

@@ -0,0 +1,44 @@
+import { createDisplayObject } from '@flighthq/scene2d/contract';
+import { Scene2DContentReferenceKind } from '@flighthq/types/contract';
+
+import { createScene2DAssetReference, createScene2DDocument, createScene2DSlotReference } from './scene2DDocument';
+
+describe('createScene2DAssetReference', () => {
+  it('creates an enumerable named asset target', () => {
+    const target = createDisplayObject();
+    const reference = createScene2DAssetReference('heroImage', 'hero.png', target);
+    expect(reference).toEqual({
+      content: null,
+      kind: Scene2DContentReferenceKind.Asset,
+      name: 'heroImage',
+      required: true,
+      target,
+      uri: 'hero.png',
+    });
+    expect(target.name).toBe('heroImage');
+  });
+});
+
+describe('createScene2DDocument', () => {
+  it('retains the unattached root and an independent manifest', () => {
+    const root = createDisplayObject();
+    const references = [createScene2DAssetReference('bg', 'bg.png', createDisplayObject())];
+    expect(createScene2DDocument(root, references, 'acme')).toEqual({
+      references,
+      root,
+      sourceKind: 'acme',
+    });
+  });
+});
+
+describe('createScene2DSlotReference', () => {
+  it('retains instance and linkage identity in the manifest', () => {
+    const target = createDisplayObject();
+    const reference = createScene2DSlotReference('avatarSlot', target, 'Game.Avatar', false);
+    expect(reference.content).toBeNull();
+    expect(reference.kind).toBe(Scene2DContentReferenceKind.Slot);
+    expect(reference.linkage).toBe('Game.Avatar');
+    expect(reference.required).toBe(false);
+    expect(target.name).toBe('avatarSlot');
+  });
+});

package/src/scene2DDocumentImporterRegistry.test.ts

@@ -0,0 +1,62 @@
+import { createDisplayObject } from '@flighthq/scene2d/contract';
+
+import { createScene2DDocument } from './scene2DDocument';
+import {
+  createScene2DDocumentFromBytes,
+  createScene2DDocumentImporterRegistry,
+  registerScene2DDocumentImporter,
+  unregisterScene2DDocumentImporter,
+} from './scene2DDocumentImporterRegistry';
+
+describe('createScene2DDocumentFromBytes', () => {
+  it('dispatches to the first matching registered importer', () => {
+    const registry = createScene2DDocumentImporterRegistry();
+    registerScene2DDocumentImporter(
+      registry,
+      'acme',
+      (source) => source[0] === 42,
+      () => createScene2DDocument(createDisplayObject()),
+    );
+    const document = createScene2DDocumentFromBytes(new Uint8Array([42]), registry);
+    expect(document?.sourceKind).toBe('acme');
+  });
+
+  it('returns null when no importer matches', () => {
+    expect(createScene2DDocumentFromBytes(new Uint8Array([0]), createScene2DDocumentImporterRegistry())).toBeNull();
+  });
+});
+
+describe('createScene2DDocumentImporterRegistry', () => {
+  it('creates isolated registries with no implicit codecs', () => {
+    const first = createScene2DDocumentImporterRegistry();
+    const second = createScene2DDocumentImporterRegistry();
+    expect(first.entries).toEqual([]);
+    expect(second.entries).not.toBe(first.entries);
+  });
+});
+
+describe('registerScene2DDocumentImporter', () => {
+  it('replaces a kind in place with last-write-wins behavior', () => {
+    const registry = createScene2DDocumentImporterRegistry();
+    const first = () => null;
+    const second = () => createScene2DDocument(createDisplayObject());
+    registerScene2DDocumentImporter(registry, 'acme', () => true, first);
+    registerScene2DDocumentImporter(registry, 'acme', () => true, second);
+    expect(registry.entries).toHaveLength(1);
+    expect(registry.entries[0].importDocument).toBe(second);
+  });
+});
+
+describe('unregisterScene2DDocumentImporter', () => {
+  it('removes an existing kind and reports absence', () => {
+    const registry = createScene2DDocumentImporterRegistry();
+    registerScene2DDocumentImporter(
+      registry,
+      'acme',
+      () => true,
+      () => null,
+    );
+    expect(unregisterScene2DDocumentImporter(registry, 'acme')).toBe(true);
+    expect(unregisterScene2DDocumentImporter(registry, 'acme')).toBe(false);
+  });
+});

package/src/scene2DDocumentSource.test.ts

@@ -0,0 +1,32 @@
+import { createDisplayObject } from '@flighthq/scene2d/contract';
+
+import { createScene2DDocument } from './scene2DDocument';
+import {
+  createScene2DDocumentImporterRegistry,
+  registerScene2DDocumentImporter,
+} from './scene2DDocumentImporterRegistry';
+import { loadScene2DDocumentFromUrl } from './scene2DDocumentSource';
+
+describe('loadScene2DDocumentFromUrl', () => {
+  it('acquires bytes then stops at the renderer-neutral document', async () => {
+    const registry = createScene2DDocumentImporterRegistry();
+    registerScene2DDocumentImporter(
+      registry,
+      'acme',
+      (_source, context) => context.url === 'scene.acme',
+      () => createScene2DDocument(createDisplayObject()),
+    );
+    const document = await loadScene2DDocumentFromUrl(
+      'scene.acme',
+      registry,
+      async (_url, _signal, _progress) => new Uint8Array([1]),
+    );
+    expect(document?.sourceKind).toBe('acme');
+  });
+
+  it('returns null when acquisition reports an expected failure', async () => {
+    await expect(
+      loadScene2DDocumentFromUrl('missing.acme', createScene2DDocumentImporterRegistry(), async () => null),
+    ).resolves.toBeNull();
+  });
+});