@codexo/exojs 0.12.0 → 0.14.0

package/dist/esm/resources/IndexedDbKeyValueStore.js

@@ -0,0 +1,58 @@
+import { IndexedDbStore } from './IndexedDbStore.js';
+
+const defaultDatabaseName = 'exojs-kv-store';
+const defaultStoreName = '__kv_store';
+/**
+ * {@link KeyValueStore} over IndexedDB (via {@link IndexedDbStore}), using the
+ * **structured-clone** algorithm.
+ *
+ * Unlike {@link WebStorageStore}, values are stored *directly* — no
+ * `JSON.stringify`. So `Blob`s, `ArrayBuffer`s, typed arrays and nested objects
+ * round-trip natively, and there is no string-size ceiling beyond the (large)
+ * IndexedDB quota. Use this for binary or large saves; use `WebStorageStore` for
+ * small synchronous JSON.
+ *
+ * @example
+ * ```ts
+ * const store = new IndexedDbKeyValueStore('my-game-saves');
+ * await store.set('autosave', { level: 3, snapshot: pngBlob });
+ * const data = await store.get<{ level: number; snapshot: Blob }>('autosave');
+ * ```
+ */
+class IndexedDbKeyValueStore {
+    _storeName;
+    _store;
+    constructor(nameOrOptions = defaultDatabaseName) {
+        const options = typeof nameOrOptions === 'string' ? { name: nameOrOptions } : nameOrOptions;
+        const storeName = options.storeName ?? defaultStoreName;
+        this._storeName = storeName;
+        this._store = new IndexedDbStore({
+            name: options.name,
+            ...(options.version !== undefined && { version: options.version }),
+            ...(options.migrations !== undefined && { migrations: options.migrations }),
+            storeNames: [storeName],
+        });
+    }
+    async get(key) {
+        return (await this._store.load(this._storeName, key));
+    }
+    async set(key, value) {
+        await this._store.save(this._storeName, key, value);
+    }
+    async has(key) {
+        return (await this._store.load(this._storeName, key)) !== null;
+    }
+    async delete(key) {
+        return this._store.delete(this._storeName, key);
+    }
+    async clear() {
+        return this._store.clear(this._storeName);
+    }
+    /** Synchronously release the underlying database handle. */
+    destroy() {
+        this._store.destroy();
+    }
+}
+
+export { IndexedDbKeyValueStore };
+//# sourceMappingURL=IndexedDbKeyValueStore.js.map

package/dist/esm/resources/IndexedDbKeyValueStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IndexedDbKeyValueStore.js","sources":["../../../../src/resources/IndexedDbKeyValueStore.ts"],"sourcesContent":[null],"names":[],"mappings":";;AASA,MAAM,mBAAmB,GAAG,gBAAgB;AAC5C,MAAM,gBAAgB,GAAG,YAAY;AAErC;;;;;;;;;;;;;;;;AAgBG;MACU,sBAAsB,CAAA;AAChB,IAAA,UAAU;AACV,IAAA,MAAM;AAEvB,IAAA,WAAA,CAAmB,gBAAwD,mBAAmB,EAAA;AAC5F,QAAA,MAAM,OAAO,GAAG,OAAO,aAAa,KAAK,QAAQ,GAAG,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,aAAa;AAC3F,QAAA,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,gBAAgB;AAEvD,QAAA,IAAI,CAAC,UAAU,GAAG,SAAS;AAC3B,QAAA,IAAI,CAAC,MAAM,GAAG,IAAI,cAAc,CAAC;YAC/B,IAAI,EAAE,OAAO,CAAC,IAAI;AAClB,YAAA,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;AAClE,YAAA,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC;YAC3E,UAAU,EAAE,CAAC,SAAS,CAAC;AACxB,SAAA,CAAC;IACJ;IAEO,MAAM,GAAG,CAAI,GAAW,EAAA;AAC7B,QAAA,QAAQ,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,CAAC;IACtD;AAEO,IAAA,MAAM,GAAG,CAAC,GAAW,EAAE,KAAc,EAAA;AAC1C,QAAA,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,EAAE,KAAK,CAAC;IACrD;IAEO,MAAM,GAAG,CAAC,GAAW,EAAA;AAC1B,QAAA,OAAO,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,CAAC,MAAM,IAAI;IAChE;IAEO,MAAM,MAAM,CAAC,GAAW,EAAA;AAC7B,QAAA,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,CAAC;IACjD;AAEO,IAAA,MAAM,KAAK,GAAA;QAChB,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC;IAC3C;;IAGO,OAAO,GAAA;AACZ,QAAA,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE;IACvB;AACD;;;;"}

package/dist/esm/resources/KeyValueStore.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Async key/value store for application data — game saves, settings, profiles,
+ * cached payloads. A single, uniform surface so calling code does not care
+ * whether the backing store is synchronous or asynchronous.
+ *
+ * The backend is the axis you choose by capability, not a flag:
+ * - {@link WebStorageStore} — `localStorage`/`sessionStorage`: small, synchronous,
+ *   JSON-only (no Blobs/ArrayBuffers). The moral successor of the old `JsonStore`.
+ * - {@link IndexedDbKeyValueStore} — IndexedDB: large, structured-clone, so Blobs,
+ *   `ArrayBuffer`s and nested objects round-trip without JSON.
+ * - {@link MemoryStore} — in-memory: ephemeral, holds references directly. For
+ *   tests and throwaway data.
+ *
+ * Pair with {@link Scene.serialize} / {@link Scene.deserialize} for a save
+ * system: `store.set(slot, scene.serialize())` to save, `scene.deserialize(await
+ * store.get(slot))` to restore. Slot naming, profiles and autosave policy are
+ * the game's concern, not the engine's.
+ */
+export interface KeyValueStore {
+    /** Read the value at `key`, or `null` when absent. */
+    get<T>(key: string): Promise<T | null>;
+    /** Write `value` at `key`, replacing any existing entry. */
+    set(key: string, value: unknown): Promise<void>;
+    /** Whether an entry exists at `key`. */
+    has(key: string): Promise<boolean>;
+    /** Remove the entry at `key`. Resolves `true` if one existed and was removed. */
+    delete(key: string): Promise<boolean>;
+    /** Remove every entry owned by this store. Resolves `true` on success. */
+    clear(): Promise<boolean>;
+}
+//# sourceMappingURL=KeyValueStore.d.ts.map

package/dist/esm/resources/KeyValueStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KeyValueStore.d.ts","sourceRoot":"","sources":["../../../src/resources/KeyValueStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,aAAa;IAC5B,sDAAsD;IACtD,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACvC,4DAA4D;IAC5D,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,wCAAwC;IACxC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACnC,iFAAiF;IACjF,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACtC,0EAA0E;IAC1E,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3B"}

package/dist/esm/resources/Loader.d.ts

@@ -15,7 +15,7 @@ import { type BinaryAsset, type CsvAsset, FontAsset, type ImageAsset, type Json,
  * Any abstract or concrete constructor that can be used as an asset type token
  * with {@link Loader.load} and related methods.
  */
-export type Loadable = abstract new (...args: any[]) => any;
+export type Loadable = abstract new (...args: any[]) => unknown;
 /** Maps each key of an `AssetInput` map to its resolved runtime resource type. */
 export type InferLoadedMap<M extends Record<string, AssetInput>> = {
     [K in keyof M]: InferAssetResource<M[K]>;
@@ -56,23 +56,47 @@ type PathExtension<S extends string> = S extends `${string}.${infer E}?${string}
  * compile time; use the token form (`load(MyType, path)`) instead.
  */
 export type LoadByPath<S extends string> = PathExtension<S> extends keyof ExtensionTypeMap ? ExtensionTypeMap[PathExtension<S>] : unknown;
+/**
+ * Additional asset types accepted by the **token form** of {@link Loader.load}
+ * (`load(MyType, 'file.ext')`) for a given file extension, beyond the
+ * path-only type registered in {@link ExtensionTypeMap}.
+ *
+ * Augment via declaration merging when a format package ships an advanced
+ * source-model token that shares a file extension with its common-case
+ * runtime type. The path-only form (`load('file.ext')`) is unaffected and
+ * keeps resolving to the {@link ExtensionTypeMap} entry alone:
+ * ```ts
+ * declare module '@codexo/exojs' {
+ *   interface ExtensionTypeMap { tmj: TileMap }       // load('world.tmj') → TileMap
+ *   interface ExtensionTokenTypeMap { tmj: TiledMap } // load(TiledMap, 'world.tmj') also allowed
+ * }
+ * ```
+ */
+export interface ExtensionTokenTypeMap {
+}
+/** Resolves the additional token types allowed for extension `E`, or `never` when none are registered. */
+type TokenTypesFor<E> = E extends keyof ExtensionTokenTypeMap ? ExtensionTokenTypeMap[E] : never;
 /**
  * Constrains a {@link Loadable} token against the types registered for a
  * given path's extension. When the extension is in {@link ExtensionTypeMap},
- * `T` must produce a value assignable to the registered union — otherwise
- * resolves to `never`, triggering a compile-time error.
+ * `T` must produce a value assignable to the registered union (including any
+ * extra token types from {@link ExtensionTokenTypeMap}) — otherwise resolves
+ * to `never`, triggering a compile-time error.
  *
- * For paths with an unregistered extension the constraint is skipped and any
- * `T` is accepted (runtime behaviour is unchanged).
+ * For paths with an unregistered extension — including non-literal `string`
+ * paths and extension-less paths, where no extension can be derived — the
+ * constraint is skipped and any `T` is accepted (runtime behaviour is
+ * unchanged).
  *
  * ```ts
  * // ExtensionTypeMap: { ogg: Sound | Video }
  * loader.load(Sound, 'effect.ogg')      // ✓ Sound ∈ Sound | Video
  * loader.load(BitmapText, 'effect.ogg') // ✗ BitmapText ∉ Sound | Video
  * loader.load(Sound, 'theme.custom')    // ✓ .custom not in map → unconstrained
+ * loader.load(Sound, dynamicPath)       // ✓ string path → unconstrained
  * ```
  */
-export type ConstrainedLoadable<T extends abstract new (...args: any[]) => any, S extends string> = PathExtension<S> extends keyof ExtensionTypeMap ? (LoadReturn<T> extends ExtensionTypeMap[PathExtension<S>] ? T : never) : T;
+export type ConstrainedLoadable<T extends abstract new (...args: any[]) => any, S extends string> = [PathExtension<S>] extends [never] ? T : PathExtension<S> extends keyof ExtensionTypeMap ? LoadReturn<T> extends ExtensionTypeMap[PathExtension<S>] | TokenTypesFor<PathExtension<S>> ? T : never : T;
 /**
  * Context object passed to custom asset-type load handlers registered via
  * {@link Loader.registerAssetType}.
@@ -130,7 +154,7 @@ export interface LoaderOptions {
  *
  * The `Loader` orchestrates fetching, processing, caching, and retrieval of
  * all engine asset types. It ships with built-in factories for every first-party
- * type (Texture, Sound, Music, Video, FontFace, HTMLImageElement, Json, text,
+ * type (Texture, Sound, AudioStream, Video, FontFace, HTMLImageElement, Json, text,
  * SVG, VTT, binary, and WASM) and allows registering custom factories via
  * {@link register}.
  *
@@ -155,6 +179,7 @@ export declare class Loader {
     private readonly _registry;
     private readonly _assetTypeMap;
     private readonly _resources;
+    private readonly _resourceKeys;
     private readonly _manifest;
     private readonly _bundles;
     private readonly _inFlight;
@@ -286,6 +311,22 @@ export declare class Loader {
      * not been registered.
      */
     loadBundle(name: string, options?: LoadBundleOptions): Promise<void>;
+    /**
+     * Load every asset packed into a binary container (`.exoa`) in a **single
+     * request**. Unlike {@link loadBundle} (one fetch per entry), a container is
+     * one file with an embedded index: its bytes are fetched once (and cached
+     * cross-session like any asset), then each slice is unpacked through its
+     * type's handler and stored under the entry's alias — retrievable with
+     * {@link get} exactly as if it had been loaded individually.
+     *
+     * Each entry's asset type must support byte-source construction
+     * ({@link AssetHandler.createFromBytes}); the factory-backed core types
+     * (textures, audio, JSON, text, binary, …) do. Throws on a malformed
+     * container, an unknown type, or a type that cannot be built from bytes.
+     *
+     * @param url Path to the container file, resolved against the loader base path.
+     */
+    loadContainer(url: string): Promise<void>;
     /**
      * Returns `true` if every asset in the named bundle has been loaded and is
      * currently held in the in-memory resource store.
@@ -378,6 +419,22 @@ export declare class Loader {
     peek<T extends Loadable>(type: T, alias: string): LoadReturn<T> | null;
     /** Returns `true` if the asset is currently held in the in-memory store. */
     has(type: Loadable, alias: string): boolean;
+    /**
+     * Reverse lookup: given a loaded resource object, return the asset type and
+     * source key it was first loaded under, or `null` for runtime-created,
+     * unloaded, or non-object resources.
+     *
+     * When a resource is shared across several aliases, the **first** alias it
+     * was stored under is returned (the canonical key). Primitive results
+     * (parsed JSON, text, CSV rows) are not keyable. Used by scene serialization
+     * to turn a live asset reference back into a portable source key; the
+     * contract is that the same asset is pre-loaded under that key before a
+     * matching deserialize.
+     */
+    keyFor(resource: object): {
+        readonly type: AssetConstructor;
+        readonly source: string;
+    } | null;
     /**
      * Removes a single asset from the in-memory resource store.
      *
@@ -413,13 +470,17 @@ export declare class Loader {
      * Atomically bind all keys for one AssetBinding to a pre-created handler.
      * Validates all keys BEFORE mutating any map. Any already-registered key
      * throws before any mutation (no override in 0.12).
+     *
+     * `Result` and `Options` are inferred from the binding's `AssetBinding<Result, Options>`
+     * contract. A declarative handler's optional `getIdentityKey` is forwarded into
+     * the internal {@link HandlerEntry} so it participates in in-flight deduplication.
      * @internal
      */
-    bindAsset(keys: {
-        type: AssetConstructor;
+    bindAsset<Result = unknown, Options = undefined>(keys: {
+        type: AssetConstructor<Result>;
         typeNames?: readonly string[];
         extensions?: readonly string[];
-    }, handler: AssetHandler): void;
+    }, handler: AssetHandler<Result, Options>): void;
     /**
      * Returns true if a handler or factory is already registered for the given constructor.
      * @advanced
@@ -482,6 +543,13 @@ export declare class Loader {
      * identity function — the cached value is returned unchanged.
      */
     private _contextFetch;
+    /**
+     * Construct an asset from in-memory `bytes` (no fetch) and store it under
+     * `alias`. Uses the type's {@link AssetHandler.createFromBytes} when present,
+     * otherwise a `register()`-style factory; throws if neither can build from
+     * bytes. The backing path for {@link loadContainer}.
+     */
+    private _injectSource;
     private _fetch;
     private _drainBackground;
     private _boostFromQueue;

package/dist/esm/resources/Loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Loader.d.ts","sourceRoot":"","sources":["../../../src/resources/Loader.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Loader.d.ts","sourceRoot":"","sources":["../../../src/resources/Loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,uBAAuB,CAAC;AAC5E,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAErD,OAAO,EAAE,KAAK,EAAa,MAAM,SAAS,CAAC;AAE3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC3F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAExE,OAAO,EAAE,KAAK,MAAM,EAAc,MAAM,UAAU,CAAC;AAEnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,SAAS,EACT,KAAK,UAAU,EACf,KAAK,IAAI,EACT,KAAK,aAAa,EAClB,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,QAAQ,EACd,MAAM,UAAU,CAAC;AAMlB;;;GAGG;AAEH,MAAM,MAAM,QAAQ,GAAG,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC;AAEhE,kFAAkF;AAClF,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,IAAI;KAChE,CAAC,IAAI,MAAM,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACzC,CAAC;AAEF;;;;;;;;GAQG;AAEH,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,CAAC,SAAS,OAAO,IAAI,GAC7C,OAAO,GACP,CAAC,SAAS,OAAO,SAAS,GACxB,MAAM,GACN,CAAC,SAAS,OAAO,QAAQ,GACvB,gBAAgB,GAChB,CAAC,SAAS,OAAO,aAAa,GAC5B,MAAM,EAAE,GACR,CAAC,SAAS,OAAO,QAAQ,GACvB,QAAQ,GACR,CAAC,SAAS,OAAO,QAAQ,GACvB,MAAM,EAAE,EAAE,GACV,CAAC,SAAS,OAAO,UAAU,GACzB,gBAAgB,GAChB,CAAC,SAAS,OAAO,SAAS,GACxB,QAAQ,GACR,CAAC,SAAS,OAAO,WAAW,GAC1B,WAAW,GACX,CAAC,SAAS,OAAO,SAAS,GACxB,WAAW,CAAC,MAAM,GAElB,CAAC,SAAS,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,MAAM,CAAC,GAChD,CAAC,GACD,KAAK,CAAC;AAE9B;;;;;;;;;;GAUG;AACH,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,QAAQ,CAAC;IAChB,GAAG,EAAE,QAAQ,CAAC;IACd,GAAG,EAAE,QAAQ,CAAC;CACf;AAED,KAAK,aAAa,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,GAAG,MAAM,IAAI,MAAM,CAAC,IAAI,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,GAAG,MAAM,IAAI,MAAM,CAAC,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;AAE3J;;;;;GAKG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,MAAM,IAAI,aAAa,CAAC,CAAC,CAAC,SAAS,MAAM,gBAAgB,GAAG,gBAAgB,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC;AAE1I;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,WAAW,qBAAqB;CAAG;AAEzC,0GAA0G;AAC1G,KAAK,aAAa,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,qBAAqB,GAAG,qBAAqB,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;AAEjG;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAAE,CAAC,SAAS,MAAM,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GAClI,CAAC,GACD,aAAa,CAAC,CAAC,CAAC,SAAS,MAAM,gBAAgB,GAC7C,UAAU,CAAC,CAAC,CAAC,SAAS,gBAAgB,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,GACxF,CAAC,GACD,KAAK,GACP,CAAC,CAAC;AAER;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,8EAA8E;IAC9E,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3C,oFAAoF;IACpF,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACvD;;;OAGG;IACH,SAAS,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACpD;AAED;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAEjF;;;;;;;;;GASG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,WAAW,CAAC;IAC3B,KAAK,CAAC,EAAE,UAAU,GAAG,SAAS,UAAU,EAAE,CAAC;IAC3C,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AA+BD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IACnD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAuC;IACrE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqD;IAKhF,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqE;IACnG,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA2D;IACrF,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4C;IACrE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuC;IACjE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2C;IACpE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAqB;IACvD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgB;IAI/C,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAA6B;IAEpE,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAkC;IAExE,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAuC;IAE3E,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA6C;IAE/E,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAuC;IAGrE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAsB;IAErD,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,aAAa,CAAc;IACnC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,WAAW,CAAK;IAExB,OAAO,CAAC,gBAAgB,CAAoB;IAC5C,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,kBAAkB,CAA6B;IAEvD,mGAAmG;IACnG,SAAgB,UAAU,0CAAiD;IAC3E,2EAA2E;IAC3E,SAAgB,gBAAgB,wDAA+D;IAC/F,0EAA0E;IAC1E,SAAgB,QAAQ,qEAA4E;IACpG,kFAAkF;IAClF,SAAgB,OAAO,gEAAuE;gBAE3E,OAAO,GAAE,aAAkB;IAY9C;;;;;;;OAOG;IACI,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI;IAM7E;;;;;;;;;;;;;;;;;;OAkBG;IACI,iBAAiB,CAAC,CAAC,SAAS,MAAM,gBAAgB,EACvD,QAAQ,EAAE,CAAC,EACX,OAAO,EAAE;QACP;;;;;;;;;WASG;QACH,cAAc,CAAC,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC;QAC/D,IAAI,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;KACpH,GACA,IAAI;IAEP;;;;;;OAMG;IACI,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI;IAwChG;;;;;;;;;;;;;OAaG;IACI,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,IAAI;IASnE;;;;;;;;;;;OAWG;IACI,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IACvC,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI;IACnD,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,IAAI;IAsBzE;;;;;;;;OAQG;IACI,gBAAgB,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IAgDtD;;;;;;;;OAQG;IACU,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IA6CrF;;;;;;;;;;;;;;OAcG;IACU,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBtD;;;OAGG;IACI,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAcvC;;;;;;;;;;;;;;;;OAgBG;IACI,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,OAAO,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC;IACtF,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,OAAO,IAAI,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,YAAY,CAAC,CAAC,EAAE,CAAC;IACpG,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE,OAAO,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAMlJ,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC;IACzC,IAAI,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IAC9F,IAAI,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,YAAY,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IAM7F;;;;;;;;;;;;;;;;;;;OAmBG;IAGI,IAAI,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,SAAS,MAAM,gBAAgB,GAAG,CAAC,GAAG,KAAK,GAAG,YAAY,CAAC,CAAC,CAAC;IAE7G,IAAI,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,SAAS,MAAM,gBAAgB,GAAG,CAAC,GAAG,KAAK,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAMtH,IAAI,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IACpI,IAAI,CAAC,CAAC,SAAS,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAClH,IAAI,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAuK7J;;;;;;;;OAQG;IACI,cAAc,IAAI,IAAI;IAwB7B;;;;;;OAMG;IACI,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAY/B;;;OAGG;IACI,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAUtC;;;;;OAKG;IACI,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,OAAO,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC;IACrD,GAAG,CAAC,CAAC,SAAS,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC;IAYrE;;;OAGG;IACI,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,OAAO,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IAC7D,IAAI,CAAC,CAAC,SAAS,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI;IAO7E,4EAA4E;IACrE,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO;IAMlD;;;;;;;;;;;OAWG;IACI,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG;QAAE,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAUpG;;;;;;OAMG;IACI,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI;IAChC,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI;IACrE,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAqDlD,OAAO,CAAC,UAAU;IA4BlB;;;;;OAKG;IACI,SAAS,CAAC,IAAI,CAAC,EAAE,QAAQ,GAAG,IAAI;IAgBvC;;;;OAIG;IACH,IAAW,QAAQ,IAAI,MAAM,CAE5B;IAED,IAAW,QAAQ,CAAC,KAAK,EAAE,MAAM,EAEhC;IAED;;;OAGG;IACH,IAAW,YAAY,IAAI,WAAW,CAErC;IAED,IAAW,YAAY,CAAC,KAAK,EAAE,WAAW,EAEzC;IAMD;;;;;;;;;OASG;IACI,SAAS,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,SAAS,EACpD,IAAI,EAAE;QAAE,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,EACvG,OAAO,EAAE,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,IAAI;IAkFP;;;OAGG;IACI,WAAW,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO;IAInD;;;OAGG;IACI,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAI9C;;;;OAIG;IACI,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAQzC;;;;;;;OAOG;IACI,OAAO,IAAI,IAAI;YAsCR,WAAW;IA2CzB,OAAO,CAAC,qBAAqB;IAoC7B,OAAO,CAAC,mBAAmB;IAwC3B;;;;;;;OAOG;YACW,gBAAgB;IAuE9B;;;;;;OAMG;YACW,iBAAiB;IAmB/B;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB;IAW5B;;;;;;;OAOG;IACH,OAAO,CAAC,aAAa;IAerB;;;;;OAKG;YACW,aAAa;YAeb,MAAM;IAiCpB,OAAO,CAAC,gBAAgB;IAkBxB,OAAO,CAAC,eAAe;IAWvB,OAAO,CAAC,qBAAqB;IAI7B,OAAO,CAAC,uBAAuB;IAqD/B,OAAO,CAAC,qBAAqB;IAW7B,OAAO,CAAC,qBAAqB;IAmB7B,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,mBAAmB;IAY3B,OAAO,CAAC,iBAAiB;IAYzB,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,+BAA+B;IAIvC,OAAO,CAAC,qBAAqB;IAgE7B,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,cAAc;IAuBtB,OAAO,CAAC,UAAU;IAWlB,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,YAAY;IAIpB;;;;;;OAMG;IACH,OAAO,CAAC,wBAAwB;IAOhC,OAAO,CAAC,WAAW;CAOpB"}

package/dist/esm/resources/Loader.js

@@ -1,5 +1,6 @@
 import { Signal } from '../core/Signal.js';
 import { AssetImpl, Asset } from './Asset.js';
+import { parseContainer } from './AssetContainer.js';
 import { defineAssetManifest, BundleLoadError } from './AssetManifest.js';
 import { AssetsImpl } from './Assets.js';
 import { CacheFirstStrategy } from './CacheFirstStrategy.js';
@@ -15,7 +16,7 @@ import { FontAsset } from './tokens.js';
  *
  * The `Loader` orchestrates fetching, processing, caching, and retrieval of
  * all engine asset types. It ships with built-in factories for every first-party
- * type (Texture, Sound, Music, Video, FontFace, HTMLImageElement, Json, text,
+ * type (Texture, Sound, AudioStream, Video, FontFace, HTMLImageElement, Json, text,
  * SVG, VTT, binary, and WASM) and allows registering custom factories via
  * {@link register}.
  *
@@ -40,6 +41,11 @@ class Loader {
     _registry = new FactoryRegistry();
     _assetTypeMap = new Map();
     _resources = new Map();
+    // Reverse lookup: loaded resource object → the (type, source) it was first
+    // stored under. Backs {@link Loader.keyFor} for scene serialization. A
+    // WeakMap so it never retains resources; only object resources participate
+    // (primitive results like parsed JSON/text are not keyable → null).
+    _resourceKeys = new WeakMap();
     _manifest = new Map();
     _bundles = new Map();
     _inFlight = new Map();
@@ -112,9 +118,10 @@ class Loader {
             };
             Object.defineProperty(syntheticCtor, 'name', { value: typeName });
             this._assetTypeMap.set(typeName, syntheticCtor);
+            const boundIdentityKey = ctorOrHandler.getIdentityKey?.bind(ctorOrHandler);
             this._handlerFunctions.set(syntheticCtor, {
                 load: (config, ctx) => ctorOrHandler.load(config, ctx),
-                getIdentityKey: ctorOrHandler.getIdentityKey?.bind(ctorOrHandler),
+                ...(boundIdentityKey !== undefined && { getIdentityKey: boundIdentityKey }),
             });
         }
         return this;
@@ -146,7 +153,10 @@ class Loader {
             this._addManifestEntry(ctor, source, source);
         }
         else if (Array.isArray(source)) {
-            for (const path of source) {
+            // `Array.isArray` narrows the union to `any[]`, dropping the element type;
+            // the only array member of the union is `readonly string[]`.
+            const paths = source;
+            for (const path of paths) {
                 this._addManifestEntry(ctor, path, path);
             }
         }
@@ -246,6 +256,38 @@ class Loader {
             throw new BundleLoadError(name, failures);
         }
     }
+    /**
+     * Load every asset packed into a binary container (`.exoa`) in a **single
+     * request**. Unlike {@link loadBundle} (one fetch per entry), a container is
+     * one file with an embedded index: its bytes are fetched once (and cached
+     * cross-session like any asset), then each slice is unpacked through its
+     * type's handler and stored under the entry's alias — retrievable with
+     * {@link get} exactly as if it had been loaded individually.
+     *
+     * Each entry's asset type must support byte-source construction
+     * ({@link AssetHandler.createFromBytes}); the factory-backed core types
+     * (textures, audio, JSON, text, binary, …) do. Throws on a malformed
+     * container, an unknown type, or a type that cannot be built from bytes.
+     *
+     * @param url Path to the container file, resolved against the loader base path.
+     */
+    async loadContainer(url) {
+        const buffer = await this._contextFetch(url, '__ctx_binary', response => response.arrayBuffer());
+        const { entries, dataStart } = parseContainer(buffer);
+        // Resolve every type up front so an unknown type fails before any asset is stored.
+        const resolved = entries.map(entry => {
+            const type = this._assetTypeMap.get(entry.type);
+            if (!type) {
+                throw new Error(`Container "${url}" references unknown asset type "${entry.type}".`);
+            }
+            return { entry, type };
+        });
+        await Promise.all(resolved.map(({ entry, type }) => {
+            const start = dataStart + entry.offset;
+            const slice = buffer.slice(start, start + entry.length);
+            return this._injectSource(type, entry.alias, slice, entry.options);
+        }));
+    }
     /**
      * Returns `true` if every asset in the named bundle has been loaded and is
      * currently held in the in-memory resource store.
@@ -365,7 +407,7 @@ class Loader {
         const configMap = arg0;
         const items = Object.entries(configMap).map(([alias, value]) => ({
             alias,
-            asset: (value instanceof AssetImpl ? value : new Asset(value)),
+            asset: value instanceof AssetImpl ? value : new Asset(value),
         }));
         return this._createLoadingQueue(items, results => {
             const out = {};
@@ -449,6 +491,23 @@ class Loader {
         const ctor = type;
         return this._resources.get(ctor)?.has(alias) ?? false;
     }
+    /**
+     * Reverse lookup: given a loaded resource object, return the asset type and
+     * source key it was first loaded under, or `null` for runtime-created,
+     * unloaded, or non-object resources.
+     *
+     * When a resource is shared across several aliases, the **first** alias it
+     * was stored under is returned (the canonical key). Primitive results
+     * (parsed JSON, text, CSV rows) are not keyable. Used by scene serialization
+     * to turn a live asset reference back into a portable source key; the
+     * contract is that the same asset is pre-loaded under that key before a
+     * matching deserialize.
+     */
+    keyFor(resource) {
+        // WeakMap.get returns undefined for any non-registered or non-weakly-holdable
+        // key, so primitive/unkeyed inputs safely resolve to null without a guard.
+        return this._resourceKeys.get(resource) ?? null;
+    }
     unload(arg0, arg1) {
         if (arg0 instanceof AssetImpl) {
             const asset = arg0;
@@ -564,6 +623,10 @@ class Loader {
      * Atomically bind all keys for one AssetBinding to a pre-created handler.
      * Validates all keys BEFORE mutating any map. Any already-registered key
      * throws before any mutation (no override in 0.12).
+     *
+     * `Result` and `Options` are inferred from the binding's `AssetBinding<Result, Options>`
+     * contract. A declarative handler's optional `getIdentityKey` is forwarded into
+     * the internal {@link HandlerEntry} so it participates in in-flight deduplication.
      * @internal
      */
     bindAsset(keys, handler) {
@@ -596,17 +659,30 @@ class Loader {
             }
         }
         // All validation passed — install atomically.
-        // Internally the loader builds a flat config `{ source, ...fields }` (the
-        // shape the advanced `registerAssetType` handler form receives). Extension
-        // AssetHandlers are typed against the public `AssetLoadRequest`
-        // (`{ source, options? }`), so reshape the flat config here: pull `source`
-        // out and nest the remaining per-load fields under `options`.
+        //
+        // Localized type-erasure boundary: the internal Loader uses a flat config
+        // `{ source, ...fields }`. The public AssetHandler<Result, Options> interface
+        // uses `AssetLoadRequest<Options> = { source, options? }`. This single `toRequest`
+        // helper is the only place where the erased flat config is cast to the typed
+        // request — justified by the `AssetBinding<Result, Options>` contract that
+        // associates this handler's Options with the registered constructor.
+        //
+        // `options` is intentionally omitted (not set to `undefined`) when the flat
+        // config carries no extra fields, keeping the object compatible with a future
+        // `exactOptionalPropertyTypes` migration.
+        const toRequest = (config) => {
+            const { source, ...rest } = config;
+            if (Object.keys(rest).length === 0) {
+                return { source };
+            }
+            return { source, options: rest };
+        };
+        const boundIdentityKey = handler.getIdentityKey?.bind(handler);
+        const boundCreateFromBytes = handler.createFromBytes?.bind(handler);
         this._handlerFunctions.set(keys.type, {
-            load: (config, ctx) => {
-                const { source, ...rest } = config;
-                const options = Object.keys(rest).length > 0 ? rest : undefined;
-                return handler.load({ source, options }, ctx);
-            },
+            load: (config, ctx) => handler.load(toRequest(config), ctx),
+            ...(boundIdentityKey && { getIdentityKey: (config) => boundIdentityKey(toRequest(config)) }),
+            ...(boundCreateFromBytes && { createFromBytes: (bytes, options) => boundCreateFromBytes(bytes, options) }),
         });
         for (const name of resolvedNames) {
             this._assetTypeMap.set(name, keys.type);
@@ -614,7 +690,9 @@ class Loader {
         for (const ext of normalizedExts) {
             this._extensionMap.set(ext, keys.type);
         }
-        // Own this handler for lifecycle management
+        // Own this handler for lifecycle management.
+        // Cast to the erased AssetHandler for storage; destroy() is the only method
+        // called on entries in this array.
         this._boundHandlers.push(handler);
     }
     /**
@@ -891,6 +969,26 @@ class Loader {
         };
         return this._cacheStrategy.resolve({ storageName, key: source, url, requestOptions: this._fetchOptions, factory, options: undefined }, this._stores);
     }
+    /**
+     * Construct an asset from in-memory `bytes` (no fetch) and store it under
+     * `alias`. Uses the type's {@link AssetHandler.createFromBytes} when present,
+     * otherwise a `register()`-style factory; throws if neither can build from
+     * bytes. The backing path for {@link loadContainer}.
+     */
+    async _injectSource(type, alias, bytes, options) {
+        const handlerEntry = this._handlerFunctions.get(type);
+        let resource;
+        if (handlerEntry?.createFromBytes) {
+            resource = await handlerEntry.createFromBytes(bytes, options);
+        }
+        else if (this._registry.has(type)) {
+            resource = await this._registry.resolve(type).create(bytes, options);
+        }
+        else {
+            throw new Error(`Asset type "${type.name}" cannot be built from container bytes (no createFromBytes handler).`);
+        }
+        this._storeResource(type, alias, resource);
+    }
     async _fetch(type, alias, path, options) {
         const factory = this._registry.resolve(type);
         const url = this._resolveUrl(path);
@@ -936,6 +1034,8 @@ class Loader {
         if (index === -1)
             return;
         const [entry] = this._backgroundQueue.splice(index, 1);
+        if (entry === undefined)
+            return;
         this._startBackgroundEntry(entry);
     }
     _isQueuedInBackground(type, alias) {
@@ -1110,6 +1210,10 @@ class Loader {
             this._resources.set(type, typeResources);
         }
         typeResources.set(alias, resource);
+        // Record the canonical reverse key (first alias wins) for object resources.
+        if (typeof resource === 'object' && resource !== null && !this._resourceKeys.has(resource)) {
+            this._resourceKeys.set(resource, { type, source: alias });
+        }
         this.onLoaded.dispatch(type, alias, resource);
     }
     _getTypeId(type) {