@codexo/exojs 0.7.11 → 0.7.13

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

@@ -1,12 +1,40 @@
 import type { AssetFactory } from './AssetFactory';
 import type { CacheStore } from './CacheStore';
+/**
+ * All the information a {@link CacheStrategy} needs to resolve a single asset.
+ *
+ * Bundles the target factory, cache namespace, lookup key, the fetch
+ * parameters, and any factory-specific options into one value so strategies
+ * remain stateless.
+ */
 export interface CacheRequest {
+    /** The {@link AssetFactory.storageName} used as the cache namespace. */
     readonly storageName: string;
+    /** The per-asset lookup key (typically the alias). */
     readonly key: string;
+    /** The fully resolved URL to fetch from the network if the cache misses. */
     readonly url: string;
     readonly requestOptions: RequestInit;
     readonly factory: AssetFactory;
+    /** Factory-specific options forwarded to {@link AssetFactory.create}. */
+    readonly options?: unknown;
 }
+/**
+ * Strategy interface that decides how assets are fetched and cached.
+ *
+ * Implementations own the full pipeline: cache check (if applicable) →
+ * network fetch (if needed) → factory.process → factory.create → cache
+ * write (if applicable). The returned value is the fully constructed
+ * resource (post-{@link AssetFactory.create}), not the intermediate source.
+ *
+ * ExoJS ships {@link CacheFirstStrategy} (default) and {@link NetworkOnlyStrategy};
+ * implement this interface to add custom policies such as network-first,
+ * stale-while-revalidate, or cache-only / offline-first.
+ */
 export interface CacheStrategy {
+    /**
+     * Resolves a single asset according to the strategy's caching policy and
+     * returns the fully constructed resource.
+     */
     resolve(request: CacheRequest, stores: ReadonlyArray<CacheStore>): Promise<unknown>;
 }

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

@@ -1,13 +1,58 @@
+/**
+ * Low-level key/value database abstraction used by {@link CacheStore}
+ * implementations.
+ *
+ * Data is organised into named object stores (`type`) that act as namespaces,
+ * each holding entries keyed by `name`. {@link IndexedDbDatabase} is the
+ * built-in implementation; custom backends can be provided by implementing
+ * this interface and wrapping it in a {@link CacheStore}.
+ */
 export interface Database {
+    /** Human-readable database identifier, typically an application name. */
     readonly name: string;
+    /** Schema version used during `upgradeneeded` migrations. */
     readonly version: number;
+    /** Whether a live connection to the underlying database is open. */
     readonly connected: boolean;
+    /**
+     * Opens the database connection, running any pending schema migrations.
+     * Resolves to `true` when the connection is ready; rejects on error.
+     * Calling this when already connected is a no-op that resolves `true`.
+     */
     connect(): Promise<boolean>;
+    /**
+     * Closes the live database connection and resets the connected state.
+     * Always resolves `true`; safe to call when not connected.
+     */
     disconnect(): Promise<boolean>;
+    /**
+     * Retrieves the entry with the given `name` from the `type` object store,
+     * or `null` if no such entry exists.
+     */
     load<T = unknown>(type: string, name: string): Promise<T | null>;
+    /**
+     * Persists `data` under `name` within the `type` object store, replacing
+     * any existing entry with the same name.
+     */
     save(type: string, name: string, data: unknown): Promise<void>;
+    /**
+     * Deletes the entry with the given `name` from the `type` object store.
+     * Resolves `true` on success.
+     */
     delete(type: string, name: string): Promise<boolean>;
+    /**
+     * Removes all entries from the `type` object store without dropping the
+     * store itself. Resolves `true` on success.
+     */
     clearStorage(type: string): Promise<boolean>;
+    /**
+     * Disconnects and then permanently deletes the entire database.
+     * Resolves `true` on success.
+     */
     deleteStorage(): Promise<boolean>;
+    /**
+     * Synchronously closes any open handles without waiting for pending
+     * transactions to complete. Prefer {@link disconnect} for graceful teardown.
+     */
     destroy(): void;
 }

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

@@ -1,9 +1,37 @@
 import type { AssetFactory } from './AssetFactory';
+/**
+ * Any abstract or concrete constructor whose instances are the asset type
+ * produced by a factory (e.g. `typeof Texture`, `typeof Sound`).
+ */
 export type AssetConstructor<T = unknown> = abstract new (...args: Array<any>) => T;
+/**
+ * Maps {@link AssetConstructor} tokens to their corresponding
+ * {@link AssetFactory} instances.
+ *
+ * Resolution is prototype-chain aware: if no factory is registered for the
+ * exact constructor, the registry walks up the prototype chain and returns the
+ * first ancestor match. This means registering a factory for a base class
+ * automatically handles all subclasses.
+ *
+ * @internal Used by {@link Loader}; consumers interact through `loader.register()`.
+ */
 export declare class FactoryRegistry {
     private readonly _factories;
+    /** Registers `factory` as the handler for `type` and its subclasses. */
     register<T>(type: AssetConstructor<T>, factory: AssetFactory<T>): void;
+    /**
+     * Returns the factory registered for `type`, walking up the prototype
+     * chain if necessary. Throws if no matching factory is found.
+     */
     resolve<T>(type: AssetConstructor<T>): AssetFactory<T>;
+    /**
+     * Returns `true` if a factory is registered for `type` or any of its
+     * prototype-chain ancestors.
+     */
     has(type: AssetConstructor): boolean;
+    /**
+     * Calls {@link AssetFactory.destroy} on every registered factory and
+     * clears the registry.
+     */
     destroy(): void;
 }

package/dist/esm/resources/FactoryRegistry.js

@@ -1,8 +1,24 @@
+/**
+ * Maps {@link AssetConstructor} tokens to their corresponding
+ * {@link AssetFactory} instances.
+ *
+ * Resolution is prototype-chain aware: if no factory is registered for the
+ * exact constructor, the registry walks up the prototype chain and returns the
+ * first ancestor match. This means registering a factory for a base class
+ * automatically handles all subclasses.
+ *
+ * @internal Used by {@link Loader}; consumers interact through `loader.register()`.
+ */
 class FactoryRegistry {
     _factories = new Map();
+    /** Registers `factory` as the handler for `type` and its subclasses. */
     register(type, factory) {
         this._factories.set(type, factory);
     }
+    /**
+     * Returns the factory registered for `type`, walking up the prototype
+     * chain if necessary. Throws if no matching factory is found.
+     */
     resolve(type) {
         let constructor = type;
         let factory = undefined;
@@ -19,6 +35,10 @@ class FactoryRegistry {
         }
         return factory;
     }
+    /**
+     * Returns `true` if a factory is registered for `type` or any of its
+     * prototype-chain ancestors.
+     */
     has(type) {
         let constructor = type;
         while (constructor !== null) {
@@ -30,6 +50,10 @@ class FactoryRegistry {
         }
         return false;
     }
+    /**
+     * Calls {@link AssetFactory.destroy} on every registered factory and
+     * clears the registry.
+     */
     destroy() {
         for (const factory of this._factories.values()) {
             factory.destroy();

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

@@ -1 +1 @@
-{"version":3,"file":"FactoryRegistry.js","sources":["../../../../src/resources/FactoryRegistry.ts"],"sourcesContent":[null],"names":[],"mappings":"MAKa,eAAe,CAAA;AAEP,IAAA,UAAU,GAAG,IAAI,GAAG,EAAkC;IAEhE,QAAQ,CAAI,IAAyB,EAAE,OAAwB,EAAA;QAClE,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,OAAuB,CAAC;IACtD;AAEO,IAAA,OAAO,CAAI,IAAyB,EAAA;QACvC,IAAI,WAAW,GAA4B,IAAI;QAC/C,IAAI,OAAO,GAA6B,SAAS;AAEjD,QAAA,OAAO,WAAW,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE;YACrC,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC;YAE1C,IAAI,CAAC,OAAO,EAAE;gBACV,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,WAAW,CAAC,SAAS,CAA8C;AAE3G,gBAAA,WAAW,GAAG,SAAS,EAAE,WAAW,IAAI,IAAI;YAChD;QACJ;QAEA,IAAI,CAAC,OAAO,EAAE;AACV,YAAA,MAAM,IAAI,KAAK,CACX,6BAA6B,IAAI,CAAC,IAAI,CAAA,EAAA;AACpC,kBAAA,qDAAqD,CAC1D;QACL;AAEA,QAAA,OAAO,OAA0B;IACrC;AAEO,IAAA,GAAG,CAAC,IAAsB,EAAA;QAC7B,IAAI,WAAW,GAA4B,IAAI;AAE/C,QAAA,OAAO,WAAW,KAAK,IAAI,EAAE;YACzB,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE;AAClC,gBAAA,OAAO,IAAI;YACf;YAEA,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,WAAW,CAAC,SAAS,CAA8C;AAE3G,YAAA,WAAW,GAAG,SAAS,EAAE,WAAW,IAAI,IAAI;QAChD;AAEA,QAAA,OAAO,KAAK;IAChB;IAEO,OAAO,GAAA;QACV,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE;YAC5C,OAAO,CAAC,OAAO,EAAE;QACrB;AAEA,QAAA,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE;IAC3B;AACH;;;;"}
+{"version":3,"file":"FactoryRegistry.js","sources":["../../../../src/resources/FactoryRegistry.ts"],"sourcesContent":[null],"names":[],"mappings":"AASA;;;;;;;;;;AAUG;MACU,eAAe,CAAA;AAEP,IAAA,UAAU,GAAG,IAAI,GAAG,EAAkC;;IAGhE,QAAQ,CAAI,IAAyB,EAAE,OAAwB,EAAA;QAClE,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,OAAuB,CAAC;IACtD;AAEA;;;AAGG;AACI,IAAA,OAAO,CAAI,IAAyB,EAAA;QACvC,IAAI,WAAW,GAA4B,IAAI;QAC/C,IAAI,OAAO,GAA6B,SAAS;AAEjD,QAAA,OAAO,WAAW,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE;YACrC,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC;YAE1C,IAAI,CAAC,OAAO,EAAE;gBACV,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,WAAW,CAAC,SAAS,CAA8C;AAE3G,gBAAA,WAAW,GAAG,SAAS,EAAE,WAAW,IAAI,IAAI;YAChD;QACJ;QAEA,IAAI,CAAC,OAAO,EAAE;AACV,YAAA,MAAM,IAAI,KAAK,CACX,6BAA6B,IAAI,CAAC,IAAI,CAAA,EAAA;AACpC,kBAAA,qDAAqD,CAC1D;QACL;AAEA,QAAA,OAAO,OAA0B;IACrC;AAEA;;;AAGG;AACI,IAAA,GAAG,CAAC,IAAsB,EAAA;QAC7B,IAAI,WAAW,GAA4B,IAAI;AAE/C,QAAA,OAAO,WAAW,KAAK,IAAI,EAAE;YACzB,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE;AAClC,gBAAA,OAAO,IAAI;YACf;YAEA,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,WAAW,CAAC,SAAS,CAA8C;AAE3G,YAAA,WAAW,GAAG,SAAS,EAAE,WAAW,IAAI,IAAI;QAChD;AAEA,QAAA,OAAO,KAAK;IAChB;AAEA;;;AAGG;IACI,OAAO,GAAA;QACV,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE;YAC5C,OAAO,CAAC,OAAO,EAAE;QACrB;AAEA,QAAA,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE;IAC3B;AACH;;;;"}

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

@@ -1,4 +1,19 @@
 import type { Database } from '@/resources/Database';
+/**
+ * {@link Database} implementation backed by the browser's IndexedDB API.
+ *
+ * Each object store is created with a `keyPath` of `"name"`, so records are
+ * stored as `{ name, data }` objects. By default the database is initialised
+ * with stores for every built-in asset type (font, image, sound, etc.); pass
+ * a custom `storeNames` list to restrict or extend the set.
+ *
+ * Schema migrations are handled in two modes:
+ * - **Default** — the constructor-supplied `storeNames` list is diff'd
+ *   against the existing stores and objects stores added/deleted accordingly.
+ * - **Explicit** — a `migrations` map keyed by target version runs the
+ *   corresponding callback for each version between `oldVersion` and
+ *   `newVersion`, allowing precise schema evolution.
+ */
 export declare class IndexedDbDatabase implements Database {
     readonly name: string;
     readonly version: number;
@@ -9,7 +24,13 @@ export declare class IndexedDbDatabase implements Database {
     private _database;
     get connected(): boolean;
     constructor(name: string, version?: number, storeNames?: ReadonlyArray<string>, migrations?: Record<number, (db: IDBDatabase, transaction: IDBTransaction) => boolean>);
-    getObjectStore(type: string, transactionMode?: IDBTransactionMode): Promise<IDBObjectStore>;
+    /**
+     * Opens (or re-uses) an IDBObjectStore for `type` in the given
+     * `transactionMode`. Calls {@link connect} automatically if the database
+     * is not yet open. Used internally by the load/save/delete methods;
+     * `protected` so subclasses can extend with custom transaction shapes.
+     */
+    protected getObjectStore(type: string, transactionMode?: IDBTransactionMode): Promise<IDBObjectStore>;
     connect(): Promise<boolean>;
     disconnect(): Promise<boolean>;
     load<T = unknown>(type: string, name: string): Promise<T | null>;

package/dist/esm/resources/IndexedDbDatabase.js

@@ -4,6 +4,21 @@ const defaultStoreNames = [
     'font', 'video', 'music', 'sound', 'image', 'texture',
     'text', 'svg', 'json', 'binary', 'wasm', 'vtt',
 ];
+/**
+ * {@link Database} implementation backed by the browser's IndexedDB API.
+ *
+ * Each object store is created with a `keyPath` of `"name"`, so records are
+ * stored as `{ name, data }` objects. By default the database is initialised
+ * with stores for every built-in asset type (font, image, sound, etc.); pass
+ * a custom `storeNames` list to restrict or extend the set.
+ *
+ * Schema migrations are handled in two modes:
+ * - **Default** — the constructor-supplied `storeNames` list is diff'd
+ *   against the existing stores and objects stores added/deleted accordingly.
+ * - **Explicit** — a `migrations` map keyed by target version runs the
+ *   corresponding callback for each version between `oldVersion` and
+ *   `newVersion`, allowing precise schema evolution.
+ */
 class IndexedDbDatabase {
     name;
     version;
@@ -24,6 +39,12 @@ class IndexedDbDatabase {
         this._storeNames = storeNames;
         this._migrations = migrations;
     }
+    /**
+     * Opens (or re-uses) an IDBObjectStore for `type` in the given
+     * `transactionMode`. Calls {@link connect} automatically if the database
+     * is not yet open. Used internally by the load/save/delete methods;
+     * `protected` so subclasses can extend with custom transaction shapes.
+     */
     async getObjectStore(type, transactionMode = 'readonly') {
         await this.connect();
         return this._database.transaction([type], transactionMode).objectStore(type);

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

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

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

@@ -1,10 +1,30 @@
 import type { CacheStore } from './CacheStore';
+/**
+ * Configuration options for {@link IndexedDbStore}.
+ *
+ * `name` is the IndexedDB database name; `version` defaults to `1`.
+ * `storeNames` overrides the default asset-type object stores, and
+ * `migrations` provides explicit per-version schema callbacks (see
+ * {@link IndexedDbDatabase} for migration semantics).
+ */
 export interface IndexedDbStoreOptions {
     name: string;
     version?: number;
     storeNames?: ReadonlyArray<string>;
     migrations?: Record<number, (db: IDBDatabase, transaction: IDBTransaction) => boolean>;
 }
+/**
+ * {@link CacheStore} implementation that persists processed asset data in an
+ * IndexedDB database via {@link IndexedDbDatabase}.
+ *
+ * Pass an instance to {@link LoaderOptions.cache} to enable cross-session
+ * asset caching with no additional configuration beyond a database name.
+ *
+ * @example
+ * ```ts
+ * const loader = new Loader({ cache: new IndexedDbStore('my-game-assets') });
+ * ```
+ */
 export declare class IndexedDbStore implements CacheStore {
     private readonly _db;
     constructor(nameOrOptions: string | IndexedDbStoreOptions);

package/dist/esm/resources/IndexedDbStore.js

@@ -1,5 +1,17 @@
 import { IndexedDbDatabase } from './IndexedDbDatabase.js';
 
+/**
+ * {@link CacheStore} implementation that persists processed asset data in an
+ * IndexedDB database via {@link IndexedDbDatabase}.
+ *
+ * Pass an instance to {@link LoaderOptions.cache} to enable cross-session
+ * asset caching with no additional configuration beyond a database name.
+ *
+ * @example
+ * ```ts
+ * const loader = new Loader({ cache: new IndexedDbStore('my-game-assets') });
+ * ```
+ */
 class IndexedDbStore {
     _db;
     constructor(nameOrOptions) {

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

@@ -1 +1 @@
-{"version":3,"file":"IndexedDbStore.js","sources":["../../../../src/resources/IndexedDbStore.ts"],"sourcesContent":[null],"names":[],"mappings":";;MAUa,cAAc,CAAA;AAEN,IAAA,GAAG;AAEpB,IAAA,WAAA,CAAmB,aAA6C,EAAA;AAC5D,QAAA,MAAM,OAAO,GAAG,OAAO,aAAa,KAAK;AACrC,cAAE,EAAE,IAAI,EAAE,aAAa;cACrB,aAAa;AAEnB,QAAA,IAAI,CAAC,GAAG,GAAG,IAAI,iBAAiB,CAC5B,OAAO,CAAC,IAAI,EACZ,OAAO,CAAC,OAAO,IAAI,CAAC,EACpB,OAAO,CAAC,UAAU,IAAI;YAClB,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS;YACrD,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK;AACjD,SAAA,EACD,OAAO,CAAC,UAAU,CACrB;IACL;AAEO,IAAA,MAAM,IAAI,CAAC,WAAmB,EAAE,GAAW,EAAA;QAC9C,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC;IAC1C;AAEO,IAAA,MAAM,IAAI,CAAC,WAAmB,EAAE,GAAW,EAAE,IAAa,EAAA;AAC7D,QAAA,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE,IAAI,CAAC;IAChD;AAEO,IAAA,MAAM,MAAM,CAAC,WAAmB,EAAE,GAAW,EAAA;QAChD,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,GAAG,CAAC;IAC5C;IAEO,MAAM,KAAK,CAAC,WAAmB,EAAA;QAClC,OAAO,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,WAAW,CAAC;IAC7C;IAEO,OAAO,GAAA;AACV,QAAA,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE;IACtB;AACH;;;;"}
+{"version":3,"file":"IndexedDbStore.js","sources":["../../../../src/resources/IndexedDbStore.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAkBA;;;;;;;;;;;AAWG;MACU,cAAc,CAAA;AAEN,IAAA,GAAG;AAEpB,IAAA,WAAA,CAAmB,aAA6C,EAAA;AAC5D,QAAA,MAAM,OAAO,GAAG,OAAO,aAAa,KAAK;AACrC,cAAE,EAAE,IAAI,EAAE,aAAa;cACrB,aAAa;AAEnB,QAAA,IAAI,CAAC,GAAG,GAAG,IAAI,iBAAiB,CAC5B,OAAO,CAAC,IAAI,EACZ,OAAO,CAAC,OAAO,IAAI,CAAC,EACpB,OAAO,CAAC,UAAU,IAAI;YAClB,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS;YACrD,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK;AACjD,SAAA,EACD,OAAO,CAAC,UAAU,CACrB;IACL;AAEO,IAAA,MAAM,IAAI,CAAC,WAAmB,EAAE,GAAW,EAAA;QAC9C,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC;IAC1C;AAEO,IAAA,MAAM,IAAI,CAAC,WAAmB,EAAE,GAAW,EAAE,IAAa,EAAA;AAC7D,QAAA,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE,IAAI,CAAC;IAChD;AAEO,IAAA,MAAM,MAAM,CAAC,WAAmB,EAAE,GAAW,EAAA;QAChD,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,GAAG,CAAC;IAC5C;IAEO,MAAM,KAAK,CAAC,WAAmB,EAAA;QAClC,OAAO,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,WAAW,CAAC;IAC7C;IAEO,OAAO,GAAA;AACV,QAAA,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE;IACtB;AACH;;;;"}

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

@@ -3,15 +3,66 @@ import { Json, TextAsset, SvgAsset, VttAsset } from './tokens';
 import type { AssetFactory } from './AssetFactory';
 import type { AssetConstructor } from './FactoryRegistry';
 import type { CacheStore } from './CacheStore';
+import type { CacheStrategy } from './CacheStrategy';
 import type { AssetManifest, LoadBundleOptions } from './AssetManifest';
+/**
+ * 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: Array<any>) => any;
+/**
+ * Maps a {@link Loadable} constructor to the concrete type returned by
+ * {@link Loader.load}.
+ *
+ * Token classes ({@link Json}, {@link TextAsset}, {@link SvgAsset},
+ * {@link VttAsset}) are special-cased because their return types do not match
+ * their constructor type. All other loadables return the instance type inferred
+ * from the constructor.
+ */
 export type LoadReturn<T> = T extends typeof Json ? unknown : T extends typeof TextAsset ? string : T extends typeof SvgAsset ? HTMLImageElement : T extends typeof VttAsset ? Array<VTTCue> : T extends abstract new (...args: Array<any>) => infer R ? R : never;
+/**
+ * Construction options for {@link Loader}.
+ *
+ * `resourcePath` is prepended to relative asset paths at fetch time.
+ * `cache` accepts one or more {@link CacheStore} instances. `cacheStrategy`
+ * picks the policy used to consult them — defaults to
+ * {@link CacheFirstStrategy} (check stores → network → write back).
+ * `concurrency` caps the number of simultaneous background-queue fetches
+ * (default `6`).
+ */
 export interface LoaderOptions {
     resourcePath?: string;
     requestOptions?: RequestInit;
     cache?: CacheStore | ReadonlyArray<CacheStore>;
+    cacheStrategy?: CacheStrategy;
     concurrency?: number;
 }
+/**
+ * Central asset management hub for ExoJS applications.
+ *
+ * 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,
+ * SVG, VTT, binary, and WASM) and allows registering custom factories via
+ * {@link register}.
+ *
+ * Assets can be loaded in three ways:
+ * - **Direct** — `loader.load(Texture, 'hero.png')` fetches immediately and
+ *   resolves to the finished asset.
+ * - **Bundle** — declare assets in a manifest with {@link registerManifest},
+ *   then call {@link loadBundle} to load groups on demand.
+ * - **Background** — call {@link backgroundLoad} or {@link loadAll} to
+ *   pre-warm everything registered in the manifest at low priority.
+ *
+ * Once loaded, assets are stored in memory and returned from cache on
+ * subsequent `load` or {@link get} calls without re-fetching.
+ *
+ * @example
+ * ```ts
+ * const loader = new Loader({ resourcePath: '/assets/', cache: new IndexedDbStore('game') });
+ * const texture = await loader.load(Texture, 'hero.png');
+ * ```
+ */
 export declare class Loader {
     private readonly _registry;
     private readonly _resources;
@@ -21,6 +72,7 @@ export declare class Loader {
     private readonly _typeIds;
     private readonly _preventStoreKeys;
     private readonly _stores;
+    private readonly _cacheStrategy;
     private _resourcePath;
     private _requestOptions;
     private _concurrency;
@@ -30,38 +82,158 @@ export declare class Loader {
     private _backgroundTotal;
     private _backgroundLoaded;
     private _backgroundResolve;
+    /** Dispatched after each background-queue item completes, with the running loaded/total counts. */
     readonly onProgress: Signal<[loaded: number, total: number]>;
+    /** Dispatched after each asset within a named bundle completes loading. */
     readonly onBundleProgress: Signal<[name: string, loaded: number, total: number]>;
+    /** Dispatched when any asset finishes loading and is stored in memory. */
     readonly onLoaded: Signal<[type: AssetConstructor, alias: string, resource: unknown]>;
+    /** Dispatched when an asset fails to load during background or bundle loading. */
     readonly onError: Signal<[type: AssetConstructor, alias: string, error: Error]>;
     constructor(options?: LoaderOptions);
+    /**
+     * Registers a custom {@link AssetFactory} for `type`.
+     *
+     * Registration is prototype-chain aware: the factory will also handle any
+     * subclass of `type` that does not have its own explicit registration.
+     * Built-in types can be overridden by registering a replacement factory
+     * for the same constructor.
+     */
     register<T>(type: AssetConstructor<T>, factory: AssetFactory<T>): this;
+    /**
+     * Registers one or more asset aliases in the manifest without immediately
+     * loading them.
+     *
+     * - Single path: the path is used as both the alias and the URL.
+     * - Array of paths: each path becomes its own alias.
+     * - Record: keys are aliases, values are URLs.
+     *
+     * Assets pre-registered here can later be loaded by alias, included in
+     * background loads via {@link backgroundLoad}, or used as the source of
+     * truth when resolving conflicts in {@link registerManifest}.
+     */
     add(type: Loadable, path: string): this;
     add(type: Loadable, paths: ReadonlyArray<string>): this;
     add(type: Loadable, items: Readonly<Record<string, string>>): this;
+    /**
+     * Validates and registers an {@link AssetManifest}, making its bundles
+     * available to {@link loadBundle}.
+     *
+     * Throws if any bundle name is already registered or if two entries for
+     * the same (type, alias) pair have conflicting paths or options.
+     * Equivalent definitions (same path, deeply-equal options) are allowed
+     * and de-duplicated silently.
+     */
     registerManifest(manifest: AssetManifest): this;
+    /**
+     * Loads all assets declared in the named bundle concurrently.
+     *
+     * Dispatches {@link onBundleProgress} (and the optional `onProgress`
+     * callback) after each asset completes. If any assets fail, a
+     * {@link BundleLoadError} is thrown after all assets have settled,
+     * containing every individual failure. Throws immediately if `name` has
+     * not been registered.
+     */
     loadBundle(name: string, options?: LoadBundleOptions): Promise<void>;
+    /**
+     * Returns `true` if every asset in the named bundle has been loaded and is
+     * currently held in the in-memory resource store.
+     */
     hasBundle(name: string): boolean;
+    /**
+     * Fetches and processes one or more assets of the given type.
+     *
+     * - **Single path** — resolves with the finished asset.
+     * - **Array of paths** — resolves with an ordered array of assets.
+     * - **Record** — resolves with a record whose keys match the input keys.
+     *
+     * In-flight and already-loaded assets are de-duplicated: calling `load`
+     * for the same (type, alias) pair while a fetch is in progress attaches
+     * to the existing promise rather than issuing a second request.
+     *
+     * Supply a custom `options` object to pass factory-specific configuration
+     * (e.g. audio decoding hints or image format overrides).
+     */
     load<T = unknown>(type: typeof Json, path: string, options?: unknown): Promise<T>;
     load<T = unknown>(type: typeof Json, paths: ReadonlyArray<string>, options?: unknown): Promise<Array<T>>;
     load<T = unknown, K extends string = string>(type: typeof Json, items: Readonly<Record<K, string>>, options?: unknown): Promise<Record<K, T>>;
     load<T extends Loadable>(type: T, path: string, options?: unknown): Promise<LoadReturn<T>>;
     load<T extends Loadable>(type: T, paths: ReadonlyArray<string>, options?: unknown): Promise<Array<LoadReturn<T>>>;
     load<T extends Loadable, K extends string>(type: T, items: Readonly<Record<K, string>>, options?: unknown): Promise<Record<K, LoadReturn<T>>>;
+    /**
+     * Enqueues all manifest-registered assets that have not yet been loaded
+     * into the background fetch queue and begins draining the queue up to
+     * {@link setConcurrency | concurrency} simultaneous connections.
+     *
+     * Progress is reported via {@link onProgress}. In-flight assets and
+     * already-loaded assets are skipped automatically. Call {@link loadAll}
+     * instead if you need to await completion.
+     */
     backgroundLoad(): void;
+    /**
+     * Starts {@link backgroundLoad} and returns a promise that resolves when
+     * every queued background asset has finished loading (successfully or not).
+     *
+     * Individual asset errors are reported via {@link onError} but do not
+     * reject the returned promise.
+     */
     loadAll(): Promise<void>;
+    /**
+     * Sets the maximum number of simultaneous background-queue fetches.
+     * Takes effect on the next {@link backgroundLoad} or {@link loadAll} call.
+     */
     setConcurrency(n: number): this;
+    /**
+     * Retrieves a previously loaded asset by type and alias.
+     *
+     * Throws if the asset has not been loaded. Use {@link peek} for a
+     * non-throwing alternative, or {@link has} to guard the call.
+     */
     get<T = unknown>(type: typeof Json, alias: string): T;
     get<T extends Loadable>(type: T, alias: string): LoadReturn<T>;
+    /**
+     * Returns the loaded asset for `alias`, or `null` if it has not been
+     * loaded yet. Non-throwing alternative to {@link get}.
+     */
     peek<T = unknown>(type: typeof Json, alias: string): T | null;
     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;
+    /**
+     * Removes a single asset from the in-memory resource store.
+     *
+     * If a fetch for this asset is still in flight, the result will be
+     * discarded once it arrives rather than written to the store, preventing
+     * a stale value from being committed after an explicit unload.
+     */
     unload(type: Loadable, alias: string): this;
+    /**
+     * Removes all loaded assets from the in-memory store.
+     *
+     * If `type` is provided, only that type's assets are cleared; otherwise
+     * all types are flushed. Does not cancel in-flight fetches.
+     */
     unloadAll(type?: Loadable): this;
+    /**
+     * Base path prepended to every relative asset URL at fetch time.
+     * Absolute URLs (starting with `http://`, `https://`, or `//`) are
+     * passed through unchanged.
+     */
     get resourcePath(): string;
     set resourcePath(value: string);
+    /**
+     * Default `RequestInit` options merged into every `fetch` call.
+     * Override per-load with the `options` argument of {@link load}.
+     */
     get requestOptions(): RequestInit;
     set requestOptions(value: RequestInit);
+    /**
+     * Tears down the loader and all resources it owns.
+     *
+     * Destroys the factory registry (releasing object URLs), destroys every
+     * cache store, clears all in-memory assets, manifest entries, bundle
+     * definitions, and in-flight tracking, and disconnects all signals.
+     */
     destroy(): void;
     private _loadSingle;
     private _loadSingleBackground;