@datamoc/mw_games 0.44.2 → 0.46.0

package/dist/core/Multiplayer.d.ts

@@ -1,101 +0,0 @@
-import { Signal } from './Signal.ts';
-/** the subset of the DOM/Node `WebSocket` this needs - injectable so a test never opens a real socket */
-export interface WebSocketLike {
-    readyState: number;
-    send(data: string): void;
-    close(): void;
-    onopen: ((event: unknown) => void) | null;
-    onclose: ((event: unknown) => void) | null;
-    onerror: ((event: unknown) => void) | null;
-    onmessage: ((event: {
-        data: string;
-    }) => void) | null;
-}
-export interface LockstepClientOptions {
-    url: string;
-    /** defaults to the global `WebSocket`; inject a fake in tests, or `ws`'s own client in Node */
-    create?: (url: string) => WebSocketLike;
-    /** Optional client-side command contract. Returning a string rejects with that reason. */
-    validateInput?: (payload: unknown) => boolean | string;
-    /** largest server message accepted, in bytes; defaults to 1 MB */
-    maxMessageBytes?: number;
-    /** accept `ws://` to a host other than this machine; off by default */
-    allowInsecure?: boolean;
-}
-export interface LockstepWelcome {
-    id: string;
-    /** The room seed, when the server configured one. */
-    seed?: number;
-    /** The JSON-safe state from which every peer must start, when configured. */
-    initialState?: unknown;
-}
-export interface TickEvent {
-    tick: number;
-    /** this room's every client id mapped to its input for `tick`, or `null` if it missed the deadline */
-    inputs: Record<string, unknown>;
-    /** state checksums reported by peers after applying this tick, when supplied */
-    checksums?: Record<string, number>;
-}
-/**
- * A client for this project's own reference lockstep server (`tools/multiplayer-server.mjs`):
- * the transport, identity, and tick-authority piece item 129 asked for, without `mwg`
- * inventing a full prediction/rollback netcode a real game would likely want to replace
- * anyway. Every connected client submits at most one input per tick; the server broadcasts a
- * `tick` message once every client in its room has submitted for that tick, or once a
- * configured timeout elapses, substituting `null` for whoever is still missing - lockstep,
- * the model turn-driven and RTS-shaped games have used for this for decades, chosen because
- * it needs no client-side prediction to already be correct. A game wanting prediction or
- * interpolation on top of this still can: `onTick` hands over the same ordered, authoritative
- * input stream a prediction layer would reconcile against.
- *
- * This is deliberately the only network surface in `mwg` that assumes a server exists rather
- * than a game's own endpoint - `FeedbackClient`/`NewsClient`/`SaveSyncClient` all assume the
- * opposite, a one-shot request/response a game points at its own backend. Real-time
- * multiplayer has no one-shot shape to hide a server behind, which is why `mwg` ships a
- * reference one (`tools/multiplayer-server.mjs`) rather than assuming a game brings its own,
- * the same reasoning that decided this the moment the item was sized.
- *
- * @example
- * ```ts
- * import { LockstepClient } from '@datamoc/mw_games/core';
- *
- * const client = new LockstepClient({ url: 'wss://example.com/room/1' });
- * client.onTick.add(({ tick, inputs }) => console.log('tick', tick, inputs));
- * client.connect();
- *
- * // each frame this client has an input for:
- * client.submitInput({ move: 'left' });
- * ```
- */
-export declare class LockstepClient {
-    readonly onWelcome: Signal<LockstepWelcome>;
-    readonly onTick: Signal<TickEvent>;
-    readonly onReject: Signal<{
-        reason: string;
-    }>;
-    readonly onDesync: Signal<{
-        tick: number;
-        checksums: Record<string, number>;
-    }>;
-    readonly onClose: Signal<void>;
-    /** a server message that was oversized, not JSON, or not a well-formed protocol message; it is dropped */
-    readonly onProtocolError: Signal<{
-        reason: string;
-    }>;
-    private socket;
-    private readonly url;
-    private readonly createSocket;
-    private readonly validateInput?;
-    private readonly maxMessageBytes;
-    private _id;
-    constructor(options: LockstepClientOptions);
-    /** this client's own id, assigned by the server's `welcome` message; `null` before it arrives */
-    get id(): string | null;
-    get connected(): boolean;
-    connect(): void;
-    /** submits this client's input for the current tick; a no-op before the connection is open */
-    submitInput(payload: unknown, checksum?: number): void;
-    close(): void;
-    private handleMessage;
-}
-//# sourceMappingURL=Multiplayer.d.ts.map

package/dist/core/Multiplayer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Multiplayer.d.ts","sourceRoot":"","sources":["../../src/core/Multiplayer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,yGAAyG;AACzG,MAAM,WAAW,aAAa;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,IAAI,IAAI,CAAC;IACd,MAAM,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IAC1C,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IAC3C,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IAC3C,SAAS,EAAE,CAAC,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;CACtD;AAID,MAAM,WAAW,qBAAqB;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,+FAA+F;IAC/F,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,aAAa,CAAC;IACxC,0FAA0F;IAC1F,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,GAAG,MAAM,CAAC;IACvD,kEAAkE;IAClE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uEAAuE;IACvE,aAAa,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,YAAY,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,SAAS;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,sGAAsG;IACtG,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,cAAc;IAC1B,QAAQ,CAAC,SAAS,0BAAiC;IACnD,QAAQ,CAAC,MAAM,oBAA2B;IAC1C,QAAQ,CAAC,QAAQ;gBAAwB,MAAM;OAAM;IACrD,QAAQ,CAAC,QAAQ;cAAsB,MAAM;mBAAa,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;OAAM;IACtF,QAAQ,CAAC,OAAO,eAAsB;IACtC,0GAA0G;IAC1G,QAAQ,CAAC,eAAe;gBAAwB,MAAM;OAAM;IAE5D,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAiC;IAC9D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAyC;IACxE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,GAAG,CAAuB;IAElC,YAAY,OAAO,EAAE,qBAAqB,EAOzC;IAED,iGAAiG;IACjG,IAAI,EAAE,IAAI,MAAM,GAAG,IAAI,CAEtB;IAED,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,OAAO,IAAI,IAAI,CAUd;IAED,8FAA8F;IAC9F,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAUrD;IAED,KAAK,IAAI,IAAI,CAEZ;IAED,OAAO,CAAC,aAAa;CAkCrB"}

package/dist/core/Multiplayer.js

@@ -1,156 +0,0 @@
-import { assertSecureUrl } from './HttpTransport.js';
-import { parseInbound } from './Sanitize.js';
-import { Signal } from './Signal.js';
-const OPEN = 1; //WebSocket.OPEN, kept as a literal so this file needs no DOM/Node WebSocket type import
-/**
- * A client for this project's own reference lockstep server (`tools/multiplayer-server.mjs`):
- * the transport, identity, and tick-authority piece item 129 asked for, without `mwg`
- * inventing a full prediction/rollback netcode a real game would likely want to replace
- * anyway. Every connected client submits at most one input per tick; the server broadcasts a
- * `tick` message once every client in its room has submitted for that tick, or once a
- * configured timeout elapses, substituting `null` for whoever is still missing - lockstep,
- * the model turn-driven and RTS-shaped games have used for this for decades, chosen because
- * it needs no client-side prediction to already be correct. A game wanting prediction or
- * interpolation on top of this still can: `onTick` hands over the same ordered, authoritative
- * input stream a prediction layer would reconcile against.
- *
- * This is deliberately the only network surface in `mwg` that assumes a server exists rather
- * than a game's own endpoint - `FeedbackClient`/`NewsClient`/`SaveSyncClient` all assume the
- * opposite, a one-shot request/response a game points at its own backend. Real-time
- * multiplayer has no one-shot shape to hide a server behind, which is why `mwg` ships a
- * reference one (`tools/multiplayer-server.mjs`) rather than assuming a game brings its own,
- * the same reasoning that decided this the moment the item was sized.
- *
- * @example
- * ```ts
- * import { LockstepClient } from '@datamoc/mw_games/core';
- *
- * const client = new LockstepClient({ url: 'wss://example.com/room/1' });
- * client.onTick.add(({ tick, inputs }) => console.log('tick', tick, inputs));
- * client.connect();
- *
- * // each frame this client has an input for:
- * client.submitInput({ move: 'left' });
- * ```
- */
-export class LockstepClient {
-    constructor(options) {
-        this.onWelcome = new Signal();
-        this.onTick = new Signal();
-        this.onReject = new Signal();
-        this.onDesync = new Signal();
-        this.onClose = new Signal();
-        /** a server message that was oversized, not JSON, or not a well-formed protocol message; it is dropped */
-        this.onProtocolError = new Signal();
-        this.socket = null;
-        this._id = null;
-        if (!options.url)
-            throw new Error('lockstep client url is required');
-        assertSecureUrl(options.url, 'lockstep client', options.allowInsecure);
-        this.url = options.url;
-        this.createSocket = options.create ?? ((url) => new WebSocket(url));
-        this.validateInput = options.validateInput;
-        this.maxMessageBytes = options.maxMessageBytes ?? 1024 * 1024;
-    }
-    /** this client's own id, assigned by the server's `welcome` message; `null` before it arrives */
-    get id() {
-        return this._id;
-    }
-    get connected() {
-        return this.socket !== null && this.socket.readyState === OPEN;
-    }
-    connect() {
-        if (this.socket)
-            throw new Error('lockstep client is already connected');
-        const socket = this.createSocket(this.url);
-        socket.onmessage = (event) => this.handleMessage(event.data);
-        socket.onclose = () => {
-            this.socket = null;
-            this._id = null;
-            this.onClose.dispatch();
-        };
-        this.socket = socket;
-    }
-    /** submits this client's input for the current tick; a no-op before the connection is open */
-    submitInput(payload, checksum) {
-        if (!this.connected)
-            return;
-        const validation = this.validateInput?.(payload);
-        if (validation === false || typeof validation === 'string') {
-            this.onReject.dispatch({
-                reason: validation === false ? 'input rejected by client validation' : validation,
-            });
-            return;
-        }
-        this.socket?.send(JSON.stringify({ type: 'input', payload, ...(checksum === undefined ? {} : { checksum }) }));
-    }
-    close() {
-        this.socket?.close();
-    }
-    handleMessage(raw) {
-        let message;
-        try {
-            if (typeof raw !== 'string')
-                throw new Error('lockstep message is not text');
-            message = readServerMessage(parseInbound(raw, { maxBytes: this.maxMessageBytes, label: 'lockstep message' }));
-        }
-        catch (error) {
-            this.onProtocolError.dispatch({ reason: error instanceof Error ? error.message : String(error) });
-            return;
-        }
-        if (message.type === 'welcome') {
-            this._id = message.id;
-            this.onWelcome.dispatch({
-                id: message.id,
-                ...(message.seed === undefined ? {} : { seed: message.seed }),
-                ...(message.initialState === undefined ? {} : { initialState: message.initialState }),
-            });
-        }
-        else if (message.type === 'tick') {
-            const event = {
-                tick: message.tick,
-                inputs: message.inputs,
-                ...(message.checksums === undefined ? {} : { checksums: message.checksums }),
-            };
-            this.onTick.dispatch(event);
-            if (message.checksums) {
-                const checksums = Object.values(message.checksums);
-                if (checksums.some((checksum) => checksum !== checksums[0]))
-                    this.onDesync.dispatch({ tick: message.tick, checksums: message.checksums });
-            }
-        }
-        else {
-            this.onReject.dispatch({ reason: message.reason ?? 'input rejected by server' });
-        }
-    }
-}
-const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
-/** checks the three server messages' field types, so a listener only ever sees the documented shapes */
-function readServerMessage(value) {
-    if (!isRecord(value) || typeof value.type !== 'string')
-        throw new Error('lockstep message has no type');
-    switch (value.type) {
-        case 'welcome':
-            if (typeof value.id !== 'string' || value.id === '')
-                throw new Error('welcome needs a string id');
-            if (value.seed !== undefined && !Number.isSafeInteger(value.seed))
-                throw new Error('welcome seed must be an integer');
-            return value;
-        case 'tick':
-            if (!Number.isSafeInteger(value.tick) || value.tick < 0)
-                throw new Error('tick needs a non-negative integer tick');
-            if (!isRecord(value.inputs))
-                throw new Error('tick needs an inputs object');
-            if (value.checksums !== undefined &&
-                (!isRecord(value.checksums) || Object.values(value.checksums).some((sum) => typeof sum !== 'number')))
-                throw new Error('tick checksums must map ids to numbers');
-            return value;
-        case 'rejected':
-            if (value.reason !== undefined && typeof value.reason !== 'string')
-                throw new Error('rejected reason must be a string');
-            return value;
-        default:
-            throw new Error(`unknown lockstep message type "${value.type}"`);
-    }
-}
-//# sourceMappingURL=Multiplayer.js.map

package/dist/core/Multiplayer.js.map

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

package/dist/core/News.d.ts

@@ -1,51 +0,0 @@
-import { type SaveStorage } from './Save.ts';
-import { HttpTransport, type HttpTransportOptions } from './HttpTransport.ts';
-/**
- * Fetches a game's own news/announcements feed - the inbound counterpart to
- * `FeedbackClient`, built on the shared `HttpTransport` like every other client here
- * (a game's own HTTPS endpoint, no backend shipped or assumed).
- *
- * @example
- * ```ts
- * import { NewsClient, NewsSeenTracker } from '@datamoc/mw_games/core';
- *
- * const news = new NewsClient({ endpoint: 'https://example.com/api/news' });
- * const seen = new NewsSeenTracker({ namespace: 'my-game' });
- *
- * const items = await news.fetchItems();
- * const unread = items.filter((item) => !seen.isSeen(item.id));
- * for (const item of unread) seen.markSeen(item.id);
- * ```
- */
-export interface NewsItem {
-    id: string;
-    title: string;
-    body: string;
-    publishedAt?: number;
-}
-export type NewsOptions = HttpTransportOptions;
-export declare class NewsClient extends HttpTransport {
-    constructor(options: NewsOptions);
-    /**
-     * Fetches and validates the feed; a malformed item throws rather than reaching a game as
-     * trusted data. The response is read as text and run through `sanitizeInboundText`
-     * (a size cap, no embedded control characters) before `JSON.parse` ever sees it, ahead of
-     * `normalizeItem`'s own per-field shape check below.
-     */
-    fetchItems(): Promise<NewsItem[]>;
-}
-export interface NewsSeenOptions {
-    namespace: string;
-    storage?: SaveStorage;
-}
-/** which news items a player has already dismissed, so a returning player is not shown the same announcement forever */
-export declare class NewsSeenTracker {
-    private readonly store;
-    constructor(options: NewsSeenOptions);
-    private readSeen;
-    isSeen(id: string): boolean;
-    markSeen(id: string): void;
-    /** `items` filtered down to whichever have not been marked seen yet */
-    unseen(items: readonly NewsItem[]): NewsItem[];
-}
-//# sourceMappingURL=News.d.ts.map

package/dist/core/News.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"News.d.ts","sourceRoot":"","sources":["../../src/core/News.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7D,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE9E;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,QAAQ;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,WAAW,GAAG,oBAAoB,CAAC;AAE/C,qBAAa,UAAW,SAAQ,aAAa;IAC5C,YAAY,OAAO,EAAE,WAAW,EAE/B;IAED;;;;;OAKG;IACG,UAAU,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,CAQtC;CACD;AAgBD,MAAM,WAAW,eAAe;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,wHAAwH;AACxH,qBAAa,eAAe;IAC3B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAwB;IAE9C,YAAY,OAAO,EAAE,eAAe,EAKnC;IAED,OAAO,CAAC,QAAQ;IAIhB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAE1B;IAED,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAIzB;IAED,uEAAuE;IACvE,MAAM,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,GAAG,QAAQ,EAAE,CAG7C;CACD"}

package/dist/core/News.js

@@ -1,65 +0,0 @@
-import { defaultStorage } from './Save.js';
-import { StoredValue } from './StoredValue.js';
-import { HttpTransport } from './HttpTransport.js';
-export class NewsClient extends HttpTransport {
-    constructor(options) {
-        super(options, 'news');
-    }
-    /**
-     * Fetches and validates the feed; a malformed item throws rather than reaching a game as
-     * trusted data. The response is read as text and run through `sanitizeInboundText`
-     * (a size cap, no embedded control characters) before `JSON.parse` ever sees it, ahead of
-     * `normalizeItem`'s own per-field shape check below.
-     */
-    async fetchItems() {
-        return this.withTimeout(async (signal) => {
-            const response = await this.fetchFn(this.endpoint, { signal });
-            if (!response.ok)
-                throw new Error(`news request failed with HTTP ${response.status}`);
-            const data = await this.readJson(response, 'response');
-            if (!Array.isArray(data))
-                throw new Error('news response was not an array');
-            return data.map((raw, index) => normalizeItem(raw, index));
-        });
-    }
-}
-function normalizeItem(raw, index) {
-    if (typeof raw !== 'object' || raw === null)
-        throw new Error(`news item ${index} was not an object`);
-    const item = raw;
-    if (typeof item.id !== 'string' || !item.id)
-        throw new Error(`news item ${index} is missing a string id`);
-    if (typeof item.title !== 'string')
-        throw new Error(`news item ${index} is missing a string title`);
-    if (typeof item.body !== 'string')
-        throw new Error(`news item ${index} is missing a string body`);
-    return {
-        id: item.id,
-        title: item.title,
-        body: item.body,
-        publishedAt: typeof item.publishedAt === 'number' ? item.publishedAt : undefined,
-    };
-}
-/** which news items a player has already dismissed, so a returning player is not shown the same announcement forever */
-export class NewsSeenTracker {
-    constructor(options) {
-        this.store = new StoredValue(options.storage ?? defaultStorage(), `mwg-news-seen:${options.namespace}`);
-    }
-    readSeen() {
-        return new Set(this.store.read([]));
-    }
-    isSeen(id) {
-        return this.readSeen().has(id);
-    }
-    markSeen(id) {
-        const seen = this.readSeen();
-        seen.add(id);
-        this.store.write([...seen]);
-    }
-    /** `items` filtered down to whichever have not been marked seen yet */
-    unseen(items) {
-        const seen = this.readSeen();
-        return items.filter((item) => !seen.has(item.id));
-    }
-}
-//# sourceMappingURL=News.js.map

package/dist/core/News.js.map

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

package/dist/core/Pathfinding.d.ts

@@ -1,41 +0,0 @@
-/** A cell reached by a weighted flood. */
-export interface WeightedCell<T> {
-    readonly cell: T;
-    readonly cost: number;
-}
-export interface WeightedFloodOptions<T, K> {
-    /** Stable identity for a cell; it may be a string, number, or object key. */
-    key: (cell: T) => K;
-    /** Adjacent cells, in whatever topology the game uses. */
-    neighbors: (cell: T) => Iterable<T>;
-    /** Cost of entering `to` from `from`; non-finite or negative costs are ignored. */
-    cost: (from: T, to: T) => number;
-    /** Maximum accumulated cost, inclusive. */
-    maxCost: number;
-    /** Optional game rule that rejects a candidate before it is reached. */
-    canEnter?: (cell: T, from: T, cost: number) => boolean;
-    /** Optional game rule that keeps a reached cell from expanding further. */
-    stop?: (cell: T, cost: number) => boolean;
-}
-/**
- * Dijkstra-style weighted flood fill, independent of a particular board or game rule.
- *
- * @example
- * ```ts
- * import { weightedFlood } from '@datamoc/mw_games/core';
- *
- * const cells = weightedFlood(0, {
- *   key: (cell) => cell,
- *   neighbors: (cell) => cell < 3 ? [cell + 1] : [],
- *   cost: () => 1,
- *   maxCost: 2,
- * });
- * console.log(cells.get(2)?.cost); // 2
- * ```
- *
- * The returned map includes `start` at cost 0. A game can use `canEnter` for blockers and
- * `stop` for rules such as a zone-of-control boundary; neither callback is interpreted here.
- * Equal-cost revisits are discarded, and the input cells are never mutated.
- */
-export declare function weightedFlood<T, K>(start: T, options: WeightedFloodOptions<T, K>): Map<K, WeightedCell<T>>;
-//# sourceMappingURL=Pathfinding.d.ts.map

package/dist/core/Pathfinding.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Pathfinding.d.ts","sourceRoot":"","sources":["../../src/core/Pathfinding.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,MAAM,WAAW,YAAY,CAAC,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACjB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB,CAAC,CAAC,EAAE,CAAC;IACzC,6EAA6E;IAC7E,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC;IACpB,0DAA0D;IAC1D,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC;IACpC,mFAAmF;IACnF,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,MAAM,CAAC;IACjC,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACvD,2EAA2E;IAC3E,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;CAC1C;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CA6B1G"}

package/dist/core/Pathfinding.js

@@ -1,86 +0,0 @@
-/**
- * Dijkstra-style weighted flood fill, independent of a particular board or game rule.
- *
- * @example
- * ```ts
- * import { weightedFlood } from '@datamoc/mw_games/core';
- *
- * const cells = weightedFlood(0, {
- *   key: (cell) => cell,
- *   neighbors: (cell) => cell < 3 ? [cell + 1] : [],
- *   cost: () => 1,
- *   maxCost: 2,
- * });
- * console.log(cells.get(2)?.cost); // 2
- * ```
- *
- * The returned map includes `start` at cost 0. A game can use `canEnter` for blockers and
- * `stop` for rules such as a zone-of-control boundary; neither callback is interpreted here.
- * Equal-cost revisits are discarded, and the input cells are never mutated.
- */
-export function weightedFlood(start, options) {
-    if (!Number.isFinite(options.maxCost) || options.maxCost < 0)
-        return new Map();
-    const startKey = options.key(start);
-    const reached = new Map([[startKey, { cell: start, cost: 0 }]]);
-    const queue = [{ cell: start, key: startKey, cost: 0 }];
-    while (queue.length > 0) {
-        const current = pop(queue);
-        const known = reached.get(current.key);
-        if (!known || current.cost !== known.cost)
-            continue;
-        if (options.stop?.(current.cell, current.cost))
-            continue;
-        for (const next of options.neighbors(current.cell)) {
-            const step = options.cost(current.cell, next);
-            if (!Number.isFinite(step) || step < 0)
-                continue;
-            const total = current.cost + step;
-            if (total > options.maxCost)
-                continue;
-            if (options.canEnter && !options.canEnter(next, current.cell, total))
-                continue;
-            const key = options.key(next);
-            if (total >= (reached.get(key)?.cost ?? Infinity))
-                continue;
-            const entry = { cell: next, key, cost: total };
-            reached.set(key, entry);
-            push(queue, entry);
-        }
-    }
-    return reached;
-}
-function push(queue, entry) {
-    queue.push(entry);
-    let index = queue.length - 1;
-    while (index > 0) {
-        const parent = Math.floor((index - 1) / 2);
-        if (queue[parent].cost <= queue[index].cost)
-            break;
-        [queue[parent], queue[index]] = [queue[index], queue[parent]];
-        index = parent;
-    }
-}
-function pop(queue) {
-    const first = queue[0];
-    const last = queue.pop();
-    if (!first || !last || queue.length === 0)
-        return first;
-    queue[0] = last;
-    let index = 0;
-    while (true) {
-        const left = index * 2 + 1;
-        const right = left + 1;
-        let smallest = index;
-        if (left < queue.length && queue[left].cost < queue[smallest].cost)
-            smallest = left;
-        if (right < queue.length && queue[right].cost < queue[smallest].cost)
-            smallest = right;
-        if (smallest === index)
-            break;
-        [queue[index], queue[smallest]] = [queue[smallest], queue[index]];
-        index = smallest;
-    }
-    return first;
-}
-//# sourceMappingURL=Pathfinding.js.map

package/dist/core/Pathfinding.js.map

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

package/dist/core/PlayerInput.d.ts

@@ -1,57 +0,0 @@
-import type { Action } from './Input.ts';
-export interface PlayerInputOptions {
-    /** this player's own gamepad, when they have one; omit for a keyboard-only player */
-    padIndex?: number;
-}
-/**
- * A player-scoped view over `mwg/core`'s `Input` module for same-screen local multiplayer.
- *
- * `Input` has no concept of a player: `Action` is a bare string, and its `bindings`/`held`/
- * `onAction` all live at module scope. Binding the same action name to two pads directly -
- * `Input.bindButton('confirm', 0, [0])` and `Input.bindButton('confirm', 1, [0])` - does not
- * give two independent "confirm"s; both bindings land in the very same action's key set, so
- * either pad pressing it fires the one shared `onAction`, with no way to tell which pad did.
- *
- * This does not change `Input` itself - it is a thin, purely additive naming convention:
- * every action a `PlayerInput` binds or queries is transparently prefixed with this
- * player's own `id`, so two players' "confirm" become two distinct actions
- * (`"p1:confirm"`, `"p2:confirm"`) that never collide. A single-player game using `Input`'s
- * bare action names directly is entirely unaffected.
- *
- * @example
- * ```ts
- * import { PlayerInput } from '@datamoc/mw_games/core';
- *
- * const player1 = new PlayerInput('p1', { padIndex: 0 });
- * const player2 = new PlayerInput('p2', { padIndex: 1 });
- *
- * player1.bind('confirm', ['Enter']);
- * player2.bind('confirm', ['Space']);
- *
- * // each player's "confirm" fires independently, even though both call it "confirm"
- * if (player1.justPressed('confirm')) console.log('player 1 confirmed');
- * ```
- */
-export declare class PlayerInput {
-    readonly id: string;
-    readonly padIndex?: number;
-    constructor(id: string, options?: PlayerInputOptions);
-    private scoped;
-    /** binds this player's own action to keyboard keys, independent of any other player's binding for the same action name */
-    bind(action: Action, keys: readonly string[]): void;
-    /** binds this player's own action to a button on their own `padIndex` */
-    bindButton(action: Action, buttons: readonly number[]): void;
-    /** binds this player's own action to an axis direction on their own `padIndex` */
-    bindAxis(action: Action, axis: number, direction: 1 | -1): void;
-    /** binds this player's own action to an on-screen touch control, independent of any other player's binding for the same action name */
-    bindTouch(action: Action, id?: string): void;
-    /** presses this player's own touch control, bound previously with `bindTouch` */
-    pressTouch(id: string): void;
-    releaseTouch(id: string): void;
-    isDown(action: Action): boolean;
-    justPressed(action: Action): boolean;
-    justReleased(action: Action): boolean;
-    /** every key/pad binding for this player's own action, in the same shape `Input.exportBindings` uses */
-    keysFor(action: Action): string[];
-}
-//# sourceMappingURL=PlayerInput.d.ts.map

package/dist/core/PlayerInput.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"PlayerInput.d.ts","sourceRoot":"","sources":["../../src/core/PlayerInput.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,MAAM,WAAW,kBAAkB;IAClC,qFAAqF;IACrF,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,WAAW;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAE3B,YAAY,EAAE,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,EAIvD;IAED,OAAO,CAAC,MAAM;IAId,0HAA0H;IAC1H,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAElD;IAED,yEAAyE;IACzE,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAI3D;IAED,kFAAkF;IAClF,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAI9D;IAED,uIAAuI;IACvI,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,GAAE,MAAe,GAAG,IAAI,CAEnD;IAED,iFAAiF;IACjF,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAE3B;IAED,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAE7B;IAED,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE9B;IAED,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEnC;IAED,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEpC;IAED,wGAAwG;IACxG,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAEhC;CACD"}