@datamoc/mw_games 0.44.2 → 0.46.0

package/dist/ai/search.d.ts

@@ -1,108 +0,0 @@
-import type { AIValue } from './index.ts';
-export interface AlphaBetaGame<State, Move> {
-    /** The side whose turn it is. Alpha-beta assumes a two-player zero-sum game. */
-    readonly currentPlayer: (state: State) => number;
-    /** Legal moves from this state, in the game's preferred stable order. */
-    readonly moves: (state: State) => readonly Move[];
-    /** Apply a move and return the next state. Do not mutate the input state. */
-    readonly apply: (state: State, move: Move) => State;
-    readonly isTerminal: (state: State) => boolean;
-    /** Score from the perspective of the root player. Higher is better. */
-    readonly evaluate: (state: State, rootPlayer: number) => number;
-}
-export interface AlphaBetaOptions {
-    readonly depth: number;
-    readonly maxNodes?: number;
-    readonly signal?: AbortSignal;
-    readonly onNode?: (depth: number, maximizing: boolean) => void;
-}
-export interface AlphaBetaResult<State, Move> {
-    readonly move: Move | null;
-    readonly score: number;
-    readonly depth: number;
-    readonly nodes: number;
-    readonly cutoffs: number;
-    readonly status: 'complete' | 'cancelled' | 'budget-exceeded';
-    readonly state: State;
-}
-/**
- * Deterministic minimax with alpha-beta pruning for a game-owned state adapter.
- *
- * @example
- * ```ts
- * import { alphaBetaSearch } from '@datamoc/mw_games/ai';
- *
- * const result = alphaBetaSearch({
- *   currentPlayer: () => 1,
- *   moves: (state: number) => state < 2 ? [1] : [],
- *   apply: (state: number, move: number) => state + move,
- *   isTerminal: (state: number) => state >= 2,
- *   evaluate: (state: number) => state,
- * }, 0, { depth: 2 });
- * console.log(result.move); // 1
- * ```
- */
-export declare function alphaBetaSearch<State, Move>(game: AlphaBetaGame<State, Move>, state: State, options: AlphaBetaOptions): AlphaBetaResult<State, Move>;
-/**
- * One root move paired with the position it reaches: the unit of work a root-split
- * search hands out. The split itself is synchronous and cheap (legal moves plus one
- * apply each); the expensive part is scoring each child, which is what leaves the
- * caller's thread.
- */
-export interface RootSplit<State, Move> {
-    readonly move: Move;
-    readonly child: State;
-}
-/**
- * Splits a search at the root: every legal move paired with the position it reaches,
- * in the game's own stable order. A child must be plain structured-cloneable data to
- * cross to a worker; a game whose states hold closures or class instances cannot
- * split this way.
- *
- * @example
- * ```ts
- * import { rootSplits } from '@datamoc/mw_games/ai';
- *
- * const game = {
- *   currentPlayer: () => 1,
- *   moves: (state: number) => state < 2 ? [1] : [],
- *   apply: (state: number, move: number) => state + move,
- *   isTerminal: (state: number) => state >= 2,
- *   evaluate: (state: number) => state,
- * };
- * const splits = rootSplits(game, 0);
- * console.log(splits.length, splits[0].child); // 1 1
- * ```
- */
-export declare function rootSplits<State, Move>(game: AlphaBetaGame<State, Move>, state: State): RootSplit<State, Move>[];
-/**
- * First-wins reduction over scored root moves: a strictly better score replaces the
- * leader, a tie keeps the earlier move, so the same scores in the same order always
- * choose the same move - the property that keeps a parallel root split deterministic.
- *
- * @example
- * ```ts
- * import { firstWins } from '@datamoc/mw_games/ai';
- *
- * console.log(firstWins([{ move: 'a', score: 1 }, { move: 'b', score: 1 }], true)); // 'a'
- * console.log(firstWins([{ move: 'a', score: 1 }, { move: 'b', score: 2 }], true)); // 'b'
- * ```
- */
-export declare function firstWins<Move>(scored: readonly {
-    readonly move: Move;
-    readonly score: number;
-}[], maximizing: boolean): Move | null;
-export interface LuaAlphaBetaFunctions {
-    readonly player?: string;
-    readonly moves?: string;
-    readonly apply?: string;
-    readonly terminal?: string;
-    readonly evaluate?: string;
-}
-export interface LuaSearchValueAdapter {
-    readonly toMoves: (value: AIValue) => readonly AIValue[];
-    readonly toBoolean: (value: AIValue) => boolean;
-    readonly toNumber: (value: AIValue) => number;
-    readonly toPlayer: (value: AIValue) => number;
-}
-//# sourceMappingURL=search.d.ts.map

package/dist/ai/search.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/ai/search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,WAAW,aAAa,CAAC,KAAK,EAAE,IAAI;IACzC,gFAAgF;IAChF,QAAQ,CAAC,aAAa,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,MAAM,CAAC;IACjD,yEAAyE;IACzE,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,SAAS,IAAI,EAAE,CAAC;IAClD,6EAA6E;IAC7E,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,KAAK,KAAK,CAAC;IACpD,QAAQ,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC;IAC/C,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,KAAK,MAAM,CAAC;CAChE;AAED,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,KAAK,IAAI,CAAC;CAC/D;AAED,MAAM,WAAW,eAAe,CAAC,KAAK,EAAE,IAAI;IAC3C,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,WAAW,GAAG,iBAAiB,CAAC;IAC9D,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;CACtB;AAID;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,IAAI,EAC1C,IAAI,EAAE,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,EAChC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,gBAAgB,GACvB,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,CAwE9B;AAED;;;;;GAKG;AACH,MAAM,WAAW,SAAS,CAAC,KAAK,EAAE,IAAI;IACrC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAEhH;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAC7B,MAAM,EAAE,SAAS;IAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,EAClE,UAAU,EAAE,OAAO,GACjB,IAAI,GAAG,IAAI,CAUb;AAED,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,SAAS,OAAO,EAAE,CAAC;IACzD,QAAQ,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IAChD,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAC;IAC9C,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAC;CAC9C"}

package/dist/ai/search.js

@@ -1,148 +0,0 @@
-const DEFAULT_MAX_NODES = 100_000;
-/**
- * Deterministic minimax with alpha-beta pruning for a game-owned state adapter.
- *
- * @example
- * ```ts
- * import { alphaBetaSearch } from '@datamoc/mw_games/ai';
- *
- * const result = alphaBetaSearch({
- *   currentPlayer: () => 1,
- *   moves: (state: number) => state < 2 ? [1] : [],
- *   apply: (state: number, move: number) => state + move,
- *   isTerminal: (state: number) => state >= 2,
- *   evaluate: (state: number) => state,
- * }, 0, { depth: 2 });
- * console.log(result.move); // 1
- * ```
- */
-export function alphaBetaSearch(game, state, options) {
-    if (!Number.isInteger(options.depth) || options.depth < 1)
-        throw new RangeError('depth must be a positive integer');
-    const maxNodes = options.maxNodes ?? DEFAULT_MAX_NODES;
-    if (!Number.isInteger(maxNodes) || maxNodes < 1)
-        throw new RangeError('maxNodes must be a positive integer');
-    const rootPlayer = game.currentPlayer(state);
-    let nodes = 0;
-    let cutoffs = 0;
-    let stopped;
-    const visit = (current, remaining, alpha, beta) => {
-        if (options.signal?.aborted) {
-            stopped = 'cancelled';
-            return 0;
-        }
-        if (++nodes > maxNodes) {
-            stopped = 'budget-exceeded';
-            return 0;
-        }
-        const maximizing = game.currentPlayer(current) === rootPlayer;
-        options.onNode?.(remaining, maximizing);
-        if (remaining === 0 || game.isTerminal(current))
-            return game.evaluate(current, rootPlayer);
-        const moves = game.moves(current);
-        if (!moves.length)
-            return game.evaluate(current, rootPlayer);
-        let best = maximizing ? -Infinity : Infinity;
-        for (const move of moves) {
-            const score = visit(game.apply(current, move), remaining - 1, alpha, beta);
-            if (stopped)
-                return score;
-            if (maximizing) {
-                best = Math.max(best, score);
-                alpha = Math.max(alpha, best);
-            }
-            else {
-                best = Math.min(best, score);
-                beta = Math.min(beta, best);
-            }
-            if (beta <= alpha) {
-                cutoffs++;
-                break;
-            }
-        }
-        return best;
-    };
-    const rootMoves = game.moves(state);
-    let chosen = null;
-    let score = game.evaluate(state, rootPlayer);
-    if (!game.isTerminal(state) && rootMoves.length) {
-        const maximizing = game.currentPlayer(state) === rootPlayer;
-        let bestScore = maximizing ? -Infinity : Infinity;
-        let alpha = -Infinity;
-        let beta = Infinity;
-        for (const move of rootMoves) {
-            const child = game.apply(state, move);
-            const candidate = visit(child, options.depth - 1, alpha, beta);
-            if (stopped)
-                break;
-            if (chosen === null || (maximizing ? candidate > bestScore : candidate < bestScore)) {
-                chosen = move;
-                bestScore = candidate;
-            }
-            if (maximizing)
-                alpha = Math.max(alpha, bestScore);
-            else
-                beta = Math.min(beta, bestScore);
-        }
-        if (chosen !== null)
-            score = bestScore;
-    }
-    return {
-        move: stopped ? null : chosen,
-        score,
-        depth: options.depth,
-        nodes,
-        cutoffs,
-        status: stopped ?? 'complete',
-        state,
-    };
-}
-/**
- * Splits a search at the root: every legal move paired with the position it reaches,
- * in the game's own stable order. A child must be plain structured-cloneable data to
- * cross to a worker; a game whose states hold closures or class instances cannot
- * split this way.
- *
- * @example
- * ```ts
- * import { rootSplits } from '@datamoc/mw_games/ai';
- *
- * const game = {
- *   currentPlayer: () => 1,
- *   moves: (state: number) => state < 2 ? [1] : [],
- *   apply: (state: number, move: number) => state + move,
- *   isTerminal: (state: number) => state >= 2,
- *   evaluate: (state: number) => state,
- * };
- * const splits = rootSplits(game, 0);
- * console.log(splits.length, splits[0].child); // 1 1
- * ```
- */
-export function rootSplits(game, state) {
-    return game.moves(state).map((move) => ({ move, child: game.apply(state, move) }));
-}
-/**
- * First-wins reduction over scored root moves: a strictly better score replaces the
- * leader, a tie keeps the earlier move, so the same scores in the same order always
- * choose the same move - the property that keeps a parallel root split deterministic.
- *
- * @example
- * ```ts
- * import { firstWins } from '@datamoc/mw_games/ai';
- *
- * console.log(firstWins([{ move: 'a', score: 1 }, { move: 'b', score: 1 }], true)); // 'a'
- * console.log(firstWins([{ move: 'a', score: 1 }, { move: 'b', score: 2 }], true)); // 'b'
- * ```
- */
-export function firstWins(scored, maximizing) {
-    let chosen = null;
-    let best = maximizing ? -Infinity : Infinity;
-    for (const { move, score } of scored) {
-        if (chosen === null || (maximizing ? score > best : score < best)) {
-            chosen = move;
-            best = score;
-        }
-    }
-    return chosen;
-}
-//# sourceMappingURL=search.js.map

package/dist/ai/search.js.map

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

package/dist/assets/ByteProgress.d.ts

@@ -1,37 +0,0 @@
-/**
- * Real transferred-byte progress for a real origin - a server, a dev server, or a desktop
- * host serving through a virtual origin rather than raw `file://` (see `desktop/`'s own
- * `SetVirtualHostNameToFolderMapping` for why that distinction matters). This is deliberately
- * separate from `load`'s own `AssetProgress`: that one reports a fraction of assets finished
- * because, as its own doc comment says, "Pixi's own loaders do not expose bytes transferred
- * across every asset type uniformly" - reporting a number this project cannot actually back
- * would be exactly the kind of silent-fallback dishonesty this project's own conventions rule
- * out elsewhere. `fetch()` itself is blocked from `file://` entirely, so calling this from a
- * compiled data-URI build throws the same way any other `fetch()` there would; it exists for
- * item 137's "a server or standalone WebView2/Chromium host can stream/cache assets
- * incrementally and report byte progress" capability tier, not the `file://` one.
- */
-export interface ByteProgress {
-    loaded: number;
-    /** null when the server never sent a Content-Length (chunked transfer, some dev servers) - a caller only gets a real fraction when this is known */
-    total: number | null;
-}
-export type OnByteProgress = (progress: ByteProgress) => void;
-/**
- * Fetches `url`, reporting real bytes transferred as they arrive, and resolves to the
- * complete body as a `Blob` - handed to `URL.createObjectURL` to become something
- * `assets.load`'s own texture/audio/JSON decoding can take from there, the same as any other
- * resolved asset URL.
- *
- * @example
- * ```ts
- * import { fetchWithByteProgress } from '@datamoc/mw_games/assets';
- *
- * const blob = await fetchWithByteProgress('https://example.com/big-tileset.png', (progress) => {
- *   if (progress.total) console.log(`${progress.loaded} / ${progress.total} bytes`);
- * });
- * const url = URL.createObjectURL(blob);
- * ```
- */
-export declare function fetchWithByteProgress(url: string, onProgress?: OnByteProgress, fetchFn?: typeof fetch): Promise<Blob>;
-//# sourceMappingURL=ByteProgress.d.ts.map

package/dist/assets/ByteProgress.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ByteProgress.d.ts","sourceRoot":"","sources":["../../src/assets/ByteProgress.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,YAAY;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,oJAAoJ;IACpJ,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,MAAM,MAAM,cAAc,GAAG,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI,CAAC;AAE9D;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,qBAAqB,CAC1C,GAAG,EAAE,MAAM,EACX,UAAU,CAAC,EAAE,cAAc,EAC3B,OAAO,GAAE,OAAO,KAAa,GAC3B,OAAO,CAAC,IAAI,CAAC,CAwBf"}

package/dist/assets/ByteProgress.js

@@ -1,54 +0,0 @@
-/**
- * Real transferred-byte progress for a real origin - a server, a dev server, or a desktop
- * host serving through a virtual origin rather than raw `file://` (see `desktop/`'s own
- * `SetVirtualHostNameToFolderMapping` for why that distinction matters). This is deliberately
- * separate from `load`'s own `AssetProgress`: that one reports a fraction of assets finished
- * because, as its own doc comment says, "Pixi's own loaders do not expose bytes transferred
- * across every asset type uniformly" - reporting a number this project cannot actually back
- * would be exactly the kind of silent-fallback dishonesty this project's own conventions rule
- * out elsewhere. `fetch()` itself is blocked from `file://` entirely, so calling this from a
- * compiled data-URI build throws the same way any other `fetch()` there would; it exists for
- * item 137's "a server or standalone WebView2/Chromium host can stream/cache assets
- * incrementally and report byte progress" capability tier, not the `file://` one.
- */
-/**
- * Fetches `url`, reporting real bytes transferred as they arrive, and resolves to the
- * complete body as a `Blob` - handed to `URL.createObjectURL` to become something
- * `assets.load`'s own texture/audio/JSON decoding can take from there, the same as any other
- * resolved asset URL.
- *
- * @example
- * ```ts
- * import { fetchWithByteProgress } from '@datamoc/mw_games/assets';
- *
- * const blob = await fetchWithByteProgress('https://example.com/big-tileset.png', (progress) => {
- *   if (progress.total) console.log(`${progress.loaded} / ${progress.total} bytes`);
- * });
- * const url = URL.createObjectURL(blob);
- * ```
- */
-export async function fetchWithByteProgress(url, onProgress, fetchFn = fetch) {
-    const response = await fetchFn(url);
-    if (!response.ok)
-        throw new Error(`fetchWithByteProgress: ${url} responded ${response.status}`);
-    const totalHeader = response.headers.get('content-length');
-    const total = totalHeader !== null && totalHeader !== '' ? Number(totalHeader) : null;
-    if (!response.body) {
-        const blob = await response.blob();
-        onProgress?.({ loaded: blob.size, total: total ?? blob.size });
-        return blob;
-    }
-    const reader = response.body.getReader();
-    const chunks = [];
-    let loaded = 0;
-    for (;;) {
-        const { done, value } = await reader.read();
-        if (done)
-            break;
-        chunks.push(value);
-        loaded += value.byteLength;
-        onProgress?.({ loaded, total });
-    }
-    return new Blob(chunks);
-}
-//# sourceMappingURL=ByteProgress.js.map

package/dist/assets/ByteProgress.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ByteProgress.js","sourceRoot":"","sources":["../../src/assets/ByteProgress.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAUH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAC1C,GAAW,EACX,UAA2B,EAC3B,OAAO,GAAiB,KAAK;IAE7B,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,CAAC,QAAQ,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,GAAG,cAAc,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAEhG,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAC3D,MAAM,KAAK,GAAG,WAAW,KAAK,IAAI,IAAI,WAAW,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAEtF,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACpB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnC,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC/D,OAAO,IAAI,CAAC;IACb,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;IACzC,MAAM,MAAM,GAAiB,EAAE,CAAC;IAChC,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,SAAS,CAAC;QACT,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QAC5C,IAAI,IAAI;YAAE,MAAM;QAChB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC;QAC3B,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,IAAI,IAAI,CAAC,MAAoB,CAAC,CAAC;AACvC,CAAC"}

package/dist/assets/Streaming.d.ts

@@ -1,56 +0,0 @@
-import type { AssetProgress } from './paths.ts';
-export interface AssetBundle {
-    id: string;
-    paths: readonly string[];
-    priority?: number;
-    /** caller-supplied estimate, used only for eviction accounting */
-    estimatedBytes?: number;
-}
-export interface AssetStreamOptions {
-    budgetBytes?: number;
-    load?: (paths: string[], onProgress?: AssetProgress) => Promise<void>;
-    release?: (paths: string[]) => Promise<void>;
-}
-/**
- * Game-directed background asset staging with bounded, least-recently-used eviction.
- *
- * It deliberately does not guess a player's next map: the game supplies bundles it considers
- * likely. This works with compiled data URIs as a decode/GPU warm-up and with server or
- * desktop hosts as ordinary asynchronous streaming.
- *
- * @example
- * ```ts
- * import { AssetStream } from '@datamoc/mw_games/assets';
- *
- * const stream = new AssetStream({ budgetBytes: 50_000_000 });
- *
- * // when a player enters a town, a likely-next zone starts loading in the background
- * await stream.preload({ id: 'forest', paths: ['forest-tiles.png'], priority: 1 });
- * ```
- */
-export declare class AssetStream {
-    private readonly entries;
-    private readonly budgetBytes;
-    private readonly loadAssets;
-    private readonly releaseAssets;
-    private clock;
-    constructor(options?: AssetStreamOptions);
-    /** loads one bundle now, then evicts older ready bundles if its budget requires it */
-    preload(bundle: AssetBundle, onProgress?: AssetProgress): Promise<void>;
-    /**
-     * Preloads bundles in highest-priority-first order; callers may intentionally not await it.
-     * `onProgress`, when given, reports overall fraction across every bundle in `bundles` (each
-     * one weighted equally), for a caller that wants one progress figure across the whole list
-     * rather than per-bundle callbacks of its own.
-     */
-    preloadLikely(bundles: readonly AssetBundle[], onProgress?: AssetProgress): Promise<void>;
-    /** marks a ready bundle as recently used at the moment a scene adopts it */
-    use(id: string): boolean;
-    isReady(id: string): boolean;
-    /** explicitly unloads one bundle, even when the configured budget has room */
-    unload(id: string): Promise<void>;
-    get estimatedBytes(): number;
-    private enforceBudget;
-    private isRetained;
-}
-//# sourceMappingURL=Streaming.d.ts.map

package/dist/assets/Streaming.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Streaming.d.ts","sourceRoot":"","sources":["../../src/assets/Streaming.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,WAAW;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,UAAU,CAAC,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7C;AAOD;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,WAAW;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;IACpD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAiE;IAC5F,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqC;IACnE,OAAO,CAAC,KAAK,CAAK;IAElB,YAAY,OAAO,GAAE,kBAAuB,EAK3C;IAED,sFAAsF;IAChF,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAe5E;IAED;;;;;OAKG;IACG,aAAa,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,EAAE,UAAU,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAM9F;IAED,4EAA4E;IAC5E,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAKvB;IAED,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAE3B;IAED,8EAA8E;IACxE,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMtC;IAED,IAAI,cAAc,IAAI,MAAM,CAE3B;YAEa,aAAa;IAU3B,OAAO,CAAC,UAAU;CAGlB"}

package/dist/assets/Streaming.js

@@ -1,100 +0,0 @@
-import { load, release } from './loader.js';
-/**
- * Game-directed background asset staging with bounded, least-recently-used eviction.
- *
- * It deliberately does not guess a player's next map: the game supplies bundles it considers
- * likely. This works with compiled data URIs as a decode/GPU warm-up and with server or
- * desktop hosts as ordinary asynchronous streaming.
- *
- * @example
- * ```ts
- * import { AssetStream } from '@datamoc/mw_games/assets';
- *
- * const stream = new AssetStream({ budgetBytes: 50_000_000 });
- *
- * // when a player enters a town, a likely-next zone starts loading in the background
- * await stream.preload({ id: 'forest', paths: ['forest-tiles.png'], priority: 1 });
- * ```
- */
-export class AssetStream {
-    constructor(options = {}) {
-        this.entries = new Map();
-        this.clock = 0;
-        this.budgetBytes = options.budgetBytes ?? Number.POSITIVE_INFINITY;
-        if (!(this.budgetBytes >= 0))
-            throw new Error('asset stream budget must not be negative');
-        this.loadAssets = options.load ?? load;
-        this.releaseAssets = options.release ?? release;
-    }
-    /** loads one bundle now, then evicts older ready bundles if its budget requires it */
-    async preload(bundle, onProgress) {
-        if (!bundle.id)
-            throw new Error('asset bundle needs an id');
-        if (bundle.estimatedBytes !== undefined && bundle.estimatedBytes < 0)
-            throw new Error('asset bundle size must not be negative');
-        const existing = this.entries.get(bundle.id);
-        if (existing?.ready) {
-            existing.lastUsed = ++this.clock;
-            onProgress?.(1);
-            return;
-        }
-        const paths = bundle.paths.filter((path) => !this.isRetained(path));
-        if (paths.length > 0)
-            await this.loadAssets([...paths], onProgress);
-        else
-            onProgress?.(1);
-        this.entries.set(bundle.id, { ...bundle, lastUsed: ++this.clock, ready: true });
-        await this.enforceBudget(bundle.id);
-    }
-    /**
-     * Preloads bundles in highest-priority-first order; callers may intentionally not await it.
-     * `onProgress`, when given, reports overall fraction across every bundle in `bundles` (each
-     * one weighted equally), for a caller that wants one progress figure across the whole list
-     * rather than per-bundle callbacks of its own.
-     */
-    async preloadLikely(bundles, onProgress) {
-        const ordered = [...bundles].sort((a, b) => (b.priority ?? 0) - (a.priority ?? 0));
-        for (const [index, bundle] of ordered.entries()) {
-            await this.preload(bundle, onProgress && ((fraction) => onProgress((index + fraction) / ordered.length)));
-        }
-        onProgress?.(1);
-    }
-    /** marks a ready bundle as recently used at the moment a scene adopts it */
-    use(id) {
-        const entry = this.entries.get(id);
-        if (!entry?.ready)
-            return false;
-        entry.lastUsed = ++this.clock;
-        return true;
-    }
-    isReady(id) {
-        return this.entries.get(id)?.ready ?? false;
-    }
-    /** explicitly unloads one bundle, even when the configured budget has room */
-    async unload(id) {
-        const entry = this.entries.get(id);
-        if (!entry)
-            return;
-        this.entries.delete(id);
-        const paths = entry.paths.filter((path) => !this.isRetained(path));
-        if (paths.length > 0)
-            await this.releaseAssets(paths);
-    }
-    get estimatedBytes() {
-        return [...this.entries.values()].reduce((sum, entry) => sum + (entry.estimatedBytes ?? 0), 0);
-    }
-    async enforceBudget(protectedId) {
-        while (this.estimatedBytes > this.budgetBytes) {
-            const candidate = [...this.entries.values()]
-                .filter((entry) => entry.id !== protectedId)
-                .sort((a, b) => a.lastUsed - b.lastUsed)[0];
-            if (!candidate)
-                return;
-            await this.unload(candidate.id);
-        }
-    }
-    isRetained(path) {
-        return [...this.entries.values()].some((entry) => entry.ready && entry.paths.includes(path));
-    }
-}
-//# sourceMappingURL=Streaming.js.map

package/dist/assets/Streaming.js.map

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

package/dist/assets/SvgParts.d.ts

@@ -1,31 +0,0 @@
-import type { Texture2D } from '../two-d/render/Types2D.ts';
-export interface SvgPartsOptions {
-    /** Rasterization multiple; logical texture dimensions remain in SVG units. */
-    resolution?: number;
-    /** Only these top-level named groups; unknown names are errors. */
-    groups?: readonly string[];
-}
-/**
- * Slice named SVG groups into cached textures, without game-owned renderer calls.
- * Accepts inert SVG source or an asset path (compiled data URIs work under file://).
- * Shared definitions, styles, group attributes and the full viewBox are retained.
- * The cache belongs to Pixi Assets: consumers borrow textures and release them with
- * releaseSvgParts once no sprite uses them. Different resolutions have separate entries.
- * @example
- * ```ts
- * import { loadSvgParts, releaseSvgParts } from '@datamoc/mw_games/assets';
- * const parts = await loadSvgParts('<svg xmlns="http://www.w3.org/2000/svg" width="20" height="10"><g id="body"><rect width="20" height="10"/></g></svg>', { resolution: 2 });
- * console.log(parts.body.width);
- * await releaseSvgParts(parts);
- * ```
- */
-export declare function loadSvgParts(source: string, options?: SvgPartsOptions): Promise<Readonly<Record<string, Texture2D>>>;
-/** Release borrowed SVG part textures after their sprites have been destroyed.
- * @example
- * ```ts
- * import { releaseSvgParts } from '@datamoc/mw_games/assets';
- * await releaseSvgParts({});
- * ```
- */
-export declare function releaseSvgParts(parts: Readonly<Record<string, Texture2D>>): Promise<void>;
-//# sourceMappingURL=SvgParts.d.ts.map

package/dist/assets/SvgParts.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SvgParts.d.ts","sourceRoot":"","sources":["../../src/assets/SvgParts.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAM5D,MAAM,WAAW,eAAe;IAC/B,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,YAAY,CACjC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,eAAoB,GAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,CAe9C;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ/F"}

package/dist/assets/SvgParts.js

@@ -1,54 +0,0 @@
-import { Assets } from 'pixi.js';
-import { readSvgSource } from './SvgSource.js';
-import { splitSvgGroups, svgDataUri } from './svg.js';
-const aliases = new WeakMap();
-/**
- * Slice named SVG groups into cached textures, without game-owned renderer calls.
- * Accepts inert SVG source or an asset path (compiled data URIs work under file://).
- * Shared definitions, styles, group attributes and the full viewBox are retained.
- * The cache belongs to Pixi Assets: consumers borrow textures and release them with
- * releaseSvgParts once no sprite uses them. Different resolutions have separate entries.
- * @example
- * ```ts
- * import { loadSvgParts, releaseSvgParts } from '@datamoc/mw_games/assets';
- * const parts = await loadSvgParts('<svg xmlns="http://www.w3.org/2000/svg" width="20" height="10"><g id="body"><rect width="20" height="10"/></g></svg>', { resolution: 2 });
- * console.log(parts.body.width);
- * await releaseSvgParts(parts);
- * ```
- */
-export async function loadSvgParts(source, options = {}) {
-    const resolution = options.resolution ?? 1;
-    if (!Number.isFinite(resolution) || resolution <= 0)
-        throw new Error('SVG parts need a positive finite resolution');
-    const svg = await readSvgSource(source);
-    const groups = splitSvgGroups(svg);
-    const names = options.groups ?? Object.keys(groups);
-    for (const name of names)
-        if (!Object.hasOwn(groups, name))
-            throw new Error(`SVG parts unknown group ${name}`);
-    const parts = Object.create(null);
-    for (const name of names) {
-        const src = svgDataUri(groups[name].replace('</svg>', `<!-- mwg-resolution:${resolution} --></svg>`));
-        const alias = `mwg-svg-part:${resolution}:${src}`;
-        parts[name] = await Assets.load({ alias, src, format: 'svg', data: { resolution } });
-        aliases.set(parts[name], alias);
-    }
-    return Object.freeze(parts);
-}
-/** Release borrowed SVG part textures after their sprites have been destroyed.
- * @example
- * ```ts
- * import { releaseSvgParts } from '@datamoc/mw_games/assets';
- * await releaseSvgParts({});
- * ```
- */
-export async function releaseSvgParts(parts) {
-    for (const texture of new Set(Object.values(parts))) {
-        const alias = aliases.get(texture);
-        if (alias) {
-            await Assets.unload(alias);
-            aliases.delete(texture);
-        }
-    }
-}
-//# sourceMappingURL=SvgParts.js.map

package/dist/assets/SvgParts.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"SvgParts.js","sourceRoot":"","sources":["../../src/assets/SvgParts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAqB,CAAC;AASjD;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CACjC,MAAc,EACd,OAAO,GAAoB,EAAE;IAE7B,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,CAAC,CAAC;IAC3C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,UAAU,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACpH,MAAM,GAAG,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IACnC,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACpD,KAAK,MAAM,IAAI,IAAI,KAAK;QAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,IAAI,EAAE,CAAC,CAAC;IAC/G,MAAM,KAAK,GAA8B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC7D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAC1B,MAAM,GAAG,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,uBAAuB,UAAU,YAAY,CAAC,CAAC,CAAC;QACtG,MAAM,KAAK,GAAG,gBAAgB,UAAU,IAAI,GAAG,EAAE,CAAC;QAClD,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,MAAM,CAAC,IAAI,CAAY,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC;QAChG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC7B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,KAA0C;IAC/E,KAAK,MAAM,OAAO,IAAI,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QACrD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACnC,IAAI,KAAK,EAAE,CAAC;YACX,MAAM,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC3B,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACzB,CAAC;IACF,CAAC;AACF,CAAC"}

package/dist/assets/SvgSource.d.ts

@@ -1,3 +0,0 @@
-/** Shared source loading for SVG parts and skeletal artwork, including compiled data URIs. */
-export declare function readSvgSource(source: string): Promise<string>;
-//# sourceMappingURL=SvgSource.d.ts.map

package/dist/assets/SvgSource.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SvgSource.d.ts","sourceRoot":"","sources":["../../src/assets/SvgSource.ts"],"names":[],"mappings":"AAGA,8FAA8F;AAC9F,wBAAsB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAcnE"}