@codexo/exojs 0.6.12 → 0.7.12

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

@@ -1,17 +1,44 @@
 import type { Loadable } from './Loader';
+/**
+ * A single asset declaration inside an {@link AssetManifest} bundle.
+ *
+ * `type` is the loadable class token (e.g. `Texture`, `Sound`), `alias` is
+ * the key used to retrieve the asset from the {@link Loader}, and `path` is
+ * the URL or relative path used to fetch it.
+ */
 export interface AssetEntry<T extends Loadable = Loadable> {
     readonly type: T;
     readonly alias: string;
     readonly path: string;
     readonly options?: unknown;
 }
+/**
+ * Static description of all asset bundles in an application.
+ *
+ * Pass to {@link Loader.registerManifest} and then load individual bundles on
+ * demand with {@link Loader.loadBundle}. Use {@link defineAssetManifest} to
+ * construct a validated, type-safe manifest at authoring time.
+ */
 export interface AssetManifest {
     readonly bundles: Readonly<Record<string, ReadonlyArray<AssetEntry>>>;
 }
+/**
+ * Options controlling how a bundle is loaded by {@link Loader.loadBundle}.
+ *
+ * Set `background` to `true` to load the bundle through the low-priority
+ * background queue, and supply `onProgress` for per-bundle progress updates.
+ */
 export interface LoadBundleOptions {
     background?: boolean;
     onProgress?: (loaded: number, total: number) => void;
 }
+/**
+ * Thrown by {@link Loader.loadBundle} when one or more assets in the bundle
+ * fail to load.
+ *
+ * The `failures` array contains every entry that errored, letting callers
+ * distinguish individual per-asset failures from a wholesale network outage.
+ */
 export declare class BundleLoadError extends Error {
     readonly bundle: string;
     readonly failures: Array<{
@@ -25,4 +52,22 @@ export declare class BundleLoadError extends Error {
         error: Error;
     }>);
 }
+/**
+ * Validates and returns a strongly-typed {@link AssetManifest}.
+ *
+ * Validates the manifest shape at runtime (non-empty bundle names, valid entry
+ * fields, no duplicate aliases per type/bundle) and preserves the literal
+ * types of the input for downstream type inference. Throws a descriptive
+ * `Error` on any validation failure.
+ *
+ * @example
+ * ```ts
+ * const manifest = defineAssetManifest({
+ *   bundles: {
+ *     ui: [{ type: Texture, alias: 'button', path: 'assets/button.png' }],
+ *   },
+ * });
+ * loader.registerManifest(manifest);
+ * ```
+ */
 export declare function defineAssetManifest<const M extends AssetManifest>(manifest: M): M;

package/dist/esm/resources/AssetManifest.js

@@ -1,3 +1,10 @@
+/**
+ * Thrown by {@link Loader.loadBundle} when one or more assets in the bundle
+ * fail to load.
+ *
+ * The `failures` array contains every entry that errored, letting callers
+ * distinguish individual per-asset failures from a wholesale network outage.
+ */
 class BundleLoadError extends Error {
     bundle;
     failures;
@@ -8,6 +15,24 @@ class BundleLoadError extends Error {
         this.failures = failures;
     }
 }
+/**
+ * Validates and returns a strongly-typed {@link AssetManifest}.
+ *
+ * Validates the manifest shape at runtime (non-empty bundle names, valid entry
+ * fields, no duplicate aliases per type/bundle) and preserves the literal
+ * types of the input for downstream type inference. Throws a descriptive
+ * `Error` on any validation failure.
+ *
+ * @example
+ * ```ts
+ * const manifest = defineAssetManifest({
+ *   bundles: {
+ *     ui: [{ type: Texture, alias: 'button', path: 'assets/button.png' }],
+ *   },
+ * });
+ * loader.registerManifest(manifest);
+ * ```
+ */
 function defineAssetManifest(manifest) {
     validateAssetManifest(manifest);
     return manifest;

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

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

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

@@ -1,5 +1,17 @@
 import type { CacheRequest, CacheStrategy } from './CacheStrategy';
 import type { CacheStore } from './CacheStore';
+/**
+ * {@link CacheStrategy} that checks every provided {@link CacheStore} before
+ * falling back to the network.
+ *
+ * On a cache hit the stored value is validated by calling
+ * {@link AssetFactory.create | factory.create}; if that throws (stale or
+ * corrupt entry) the entry is deleted and the next store is tried. Only once
+ * all stores miss does the strategy fetch from the network and write the
+ * result back to every store. Quota or serialisation errors during write are
+ * swallowed silently so that a full storage can never prevent an asset from
+ * loading.
+ */
 export declare class CacheFirstStrategy implements CacheStrategy {
     resolve(request: CacheRequest, stores: ReadonlyArray<CacheStore>): Promise<unknown>;
 }

package/dist/esm/resources/CacheFirstStrategy.js

@@ -1,3 +1,15 @@
+/**
+ * {@link CacheStrategy} that checks every provided {@link CacheStore} before
+ * falling back to the network.
+ *
+ * On a cache hit the stored value is validated by calling
+ * {@link AssetFactory.create | factory.create}; if that throws (stale or
+ * corrupt entry) the entry is deleted and the next store is tried. Only once
+ * all stores miss does the strategy fetch from the network and write the
+ * result back to every store. Quota or serialisation errors during write are
+ * swallowed silently so that a full storage can never prevent an asset from
+ * loading.
+ */
 class CacheFirstStrategy {
     async resolve(request, stores) {
         const { storageName, key, url, requestOptions, factory } = request;

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

@@ -1 +1 @@
-{"version":3,"file":"CacheFirstStrategy.js","sources":["../../../../src/resources/CacheFirstStrategy.ts"],"sourcesContent":[null],"names":[],"mappings":"MAGa,kBAAkB,CAAA;AAEpB,IAAA,MAAM,OAAO,CAAC,OAAqB,EAAE,MAAiC,EAAA;AACzE,QAAA,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,GAAG,EAAE,cAAc,EAAE,OAAO,EAAE,GAAG,OAAO;AAElE,QAAA,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE;YACxB,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC;YAEjD,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS,EAAE;AACzC,gBAAA,IAAI;AACA,oBAAA,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC;AAC5B,oBAAA,OAAO,MAAM;gBACjB;AAAE,gBAAA,MAAM;oBACJ,MAAM,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,GAAG,CAAC;gBACxC;YACJ;QACJ;QAEA,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,cAAc,CAAC;AAEjD,QAAA,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE;AACd,YAAA,MAAM,IAAI,KAAK,CAAC,CAAA,iBAAA,EAAoB,GAAG,CAAA,GAAA,EAAM,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,CAAA,EAAA,CAAI,CAAC;QAC5F;QAEA,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC;AAE9C,QAAA,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE;AACxB,YAAA,IAAI;gBACA,MAAM,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE,MAAM,CAAC;YAC9C;AAAE,YAAA,MAAM;;YAER;QACJ;AAEA,QAAA,OAAO,MAAM;IACjB;AACH;;;;"}
+{"version":3,"file":"CacheFirstStrategy.js","sources":["../../../../src/resources/CacheFirstStrategy.ts"],"sourcesContent":[null],"names":[],"mappings":"AAGA;;;;;;;;;;;AAWG;MACU,kBAAkB,CAAA;AAEpB,IAAA,MAAM,OAAO,CAAC,OAAqB,EAAE,MAAiC,EAAA;AACzE,QAAA,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,GAAG,EAAE,cAAc,EAAE,OAAO,EAAE,GAAG,OAAO;AAElE,QAAA,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE;YACxB,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC;YAEjD,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS,EAAE;AACzC,gBAAA,IAAI;AACA,oBAAA,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC;AAC5B,oBAAA,OAAO,MAAM;gBACjB;AAAE,gBAAA,MAAM;oBACJ,MAAM,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,GAAG,CAAC;gBACxC;YACJ;QACJ;QAEA,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,cAAc,CAAC;AAEjD,QAAA,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE;AACd,YAAA,MAAM,IAAI,KAAK,CAAC,CAAA,iBAAA,EAAoB,GAAG,CAAA,GAAA,EAAM,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,CAAA,EAAA,CAAI,CAAC;QAC5F;QAEA,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC;AAE9C,QAAA,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE;AACxB,YAAA,IAAI;gBACA,MAAM,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE,MAAM,CAAC;YAC9C;AAAE,YAAA,MAAM;;YAER;QACJ;AAEA,QAAA,OAAO,MAAM;IACjB;AACH;;;;"}

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

@@ -1,7 +1,30 @@
+/**
+ * Persistent storage backend used by the {@link Loader} to cache processed
+ * asset data between sessions.
+ *
+ * Each method accepts a `storageName` namespace (sourced from
+ * {@link AssetFactory.storageName}) and a per-asset `key`, allowing a single
+ * store to hold data for multiple asset types. {@link IndexedDbStore} is the
+ * built-in implementation backed by the browser's IndexedDB API.
+ */
 export interface CacheStore {
+    /**
+     * Loads a previously saved value, or `null` if the entry does not exist.
+     */
     load(storageName: string, key: string): Promise<unknown | null>;
+    /**
+     * Persists `data` under the given namespace and key.
+     * Implementations must tolerate failures silently when storage is full.
+     */
     save(storageName: string, key: string, data: unknown): Promise<void>;
+    /**
+     * Removes a single entry. Returns `true` if the entry existed and was removed.
+     */
     delete(storageName: string, key: string): Promise<boolean>;
+    /**
+     * Removes all entries within `storageName`. Returns `true` on success.
+     */
     clear(storageName: string): Promise<boolean>;
+    /** Synchronously releases any open handles held by the store. */
     destroy(): void;
 }

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

@@ -1,12 +1,32 @@
 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, and the fetch
+ * parameters 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;
 }
+/**
+ * Strategy interface that decides how assets are fetched and cached.
+ *
+ * Implement this interface to control the caching policy — for example,
+ * {@link CacheFirstStrategy} checks persistent stores before hitting the
+ * network, while {@link NetworkOnlyStrategy} always goes to the network.
+ */
 export interface CacheStrategy {
+    /**
+     * Resolves a single asset according to the strategy's caching policy and
+     * returns the processed intermediate value ready for {@link AssetFactory.create}.
+     */
     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;;;;"}