@datamoc/mw_games 0.44.2 → 0.46.0

package/dist/testing/index.js

@@ -1,157 +0,0 @@
-import { MemoryStorage } from '../core/Save.js';
-/**
- * Test doubles for the seams mwg already takes by injection, so a game's tests (and this
- * repository's own) do not each rewrite them: a storage for `SaveSystem`, `Settings`,
- * `Collection` and the stored counters, a `Playable` for `Sound`/`Music`'s `create`, a socket for
- * `LockstepClient`'s `create`, and a `fetch` for every `HttpTransport` client. Renderer-free and
- * dependency-free, and kept off the root barrel, so nothing here reaches a shipped game unless
- * a test imports it.
- *
- * @example
- * ```ts
- * import { SaveSystem } from '@datamoc/mw_games/core';
- * import { memoryStorage } from '@datamoc/mw_games/testing';
- *
- * const saves = new SaveSystem<{ gold: number }>({ namespace: 'test', version: 1, storage: memoryStorage() });
- * saves.save('slot1', { gold: 3 });
- * ```
- */
-export function memoryStorage() {
-    return new MemoryStorage();
-}
-/**
- * A `Playable` for `Sound`/`Music`'s `create` option (`create: fakeAudio` works as is):
- * `play()` counts and unpauses, `pause()` pauses.
- *
- * @example
- * ```ts
- * import { Sound } from '@datamoc/mw_games/audio';
- * import { fakeAudio } from '@datamoc/mw_games/testing';
- *
- * const audio = fakeAudio();
- * const sound = new Sound('hit.wav', { poolSize: 1, create: () => audio });
- * sound.play();
- * console.log(audio.playCount); // 1
- * ```
- */
-export function fakeAudio() {
-    return {
-        playCount: 0,
-        paused: true,
-        volume: 1,
-        currentTime: 0,
-        loop: false,
-        play() {
-            this.playCount++;
-            this.paused = false;
-        },
-        pause() {
-            this.paused = true;
-        },
-    };
-}
-/**
- * `fakeAudio` with an `onended` slot, which is how a backend that reports the end of a track
- * looks to the audio classes; `audio.onended?.(new Event('ended'))` ends it.
- */
-export function fakeAudioWithEnded() {
-    return { ...fakeAudio(), onended: null };
-}
-/**
- * A `WebSocketLike` for `LockstepClient`'s `create` option: `sent` holds what the client sent,
- * `receive(message)` delivers a server message as JSON (`receiveRaw` delivers text as is), and
- * `close()` fires `onclose`.
- *
- * @example
- * ```ts
- * import { LockstepClient } from '@datamoc/mw_games/core';
- * import { FakeSocket } from '@datamoc/mw_games/testing';
- *
- * const socket = new FakeSocket();
- * const client = new LockstepClient({ url: 'wss://example.test', create: () => socket });
- * client.connect();
- * socket.receive({ type: 'welcome', id: 'p1' });
- * ```
- */
-export class FakeSocket {
-    constructor() {
-        this.readyState = 1;
-        this.sent = [];
-        this.onopen = null;
-        this.onclose = null;
-        this.onerror = null;
-        this.onmessage = null;
-    }
-    send(data) {
-        this.sent.push(data);
-    }
-    close() {
-        this.readyState = 3;
-        this.onclose?.(undefined);
-    }
-    receive(message) {
-        this.receiveRaw(JSON.stringify(message));
-    }
-    receiveRaw(data) {
-        this.onmessage?.({ data });
-    }
-}
-/**
- * A `fetch` for any `HttpTransport` client's `fetch` option: `respond` answers each request,
- * with a `Response` or with a plain value sent as a JSON body, and `calls` records them in order.
- *
- * @example
- * ```ts
- * import { NewsClient } from '@datamoc/mw_games/core';
- * import { fakeFetch } from '@datamoc/mw_games/testing';
- *
- * const fetch = fakeFetch(() => [{ id: '1', title: 'Patch notes', body: 'Fixed things.' }]);
- * const news = new NewsClient({ endpoint: 'https://example.test/news', fetch });
- * ```
- */
-export function fakeFetch(respond) {
-    const calls = [];
-    const fetch = async (input, init) => {
-        const url = String(input);
-        calls.push({ url, init });
-        const answer = await respond(url, init);
-        return answer instanceof Response ? answer : new Response(JSON.stringify(answer), { status: 200 });
-    };
-    return Object.assign(fetch, { calls });
-}
-/**
- * A `Gamepad` for `Input`/`PlayerInput` tests: `buttons` are values from 0 to 1 (pressed above
- * 0.5), `axes` from -1 to 1. Hand it to the code under test the way `navigator.getGamepads()`
- * would.
- */
-export function fakeGamepad(index, buttons = [], axes = []) {
-    return {
-        index,
-        buttons: buttons.map((value) => ({ pressed: value > 0.5, touched: value > 0.5, value })),
-        axes,
-    };
-}
-export { createSceneControls } from './SceneControls.js';
-export { FakeAudioContext, FakeBlockSource, FakeBuffer, FakeBufferSource, FakeGain, FakeRetroPlayer, } from './FakeAudio.js';
-/**
- * Publishes a game's inspectable state on `window.__mwg_test__[name]`, where a browser test
- * (`BrowserDriver.evaluate`) can reach it. One fixed place replaces a hook each game invents;
- * a no-op outside a browser.
- *
- * @example
- * ```ts
- * import { exposeForTests } from '@datamoc/mw_games/testing';
- *
- * declare const scene: unknown;
- * declare const hitSound: unknown;
- * exposeForTests('game', { scene, hitSound });
- * // in the test: await driver.evaluate(() => window.__mwg_test__.game.hitSound.plays);
- * ```
- */
-export function exposeForTests(name, value) {
-    const host = globalThis;
-    if (typeof window === 'undefined')
-        return;
-    (host.__mwg_test__ ??= {})[name] = value;
-}
-//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

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

package/dist/threads/index.d.ts

@@ -1,3 +0,0 @@
-export { openWorker, spawn } from './spawn.ts';
-export type { SpawnOptions, WorkerLink, WorkerLinkEvents } from './spawn.ts';
-//# sourceMappingURL=index.d.ts.map

package/dist/threads/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/threads/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAC/C,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/threads/index.js

@@ -1,2 +0,0 @@
-export { openWorker, spawn } from './spawn.js';
-//# sourceMappingURL=index.js.map

package/dist/threads/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/threads/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC"}

package/dist/threads/spawn.d.ts

@@ -1,73 +0,0 @@
-export interface SpawnOptions {
-    /** buffers posted to the task instead of copied: each is detached from this thread when spawn runs */
-    transfer?: Transferable[];
-    /** abandons the task after this many milliseconds; there is no default, because a render can legitimately take minutes */
-    timeout?: number;
-    /** aborting rejects the promise with the signal's reason and terminates the task's worker */
-    signal?: AbortSignal;
-}
-/** one open worker: post to it, terminate it */
-export interface WorkerLink {
-    post(message: unknown, transfer?: Transferable[]): void;
-    terminate(): void;
-}
-export interface WorkerLinkEvents {
-    /** a message the worker posted */
-    message(data: unknown): void;
-    /** the worker failed, died or sent something that could not be read */
-    fail(error: Error): void;
-}
-/**
- * Opens a worker running a classic script, in a browser (a blob worker, which the shipped
- * `file://` page's policy allows) or in Node (`worker_threads` in eval mode), and returns null
- * where neither exists. `spawn` is the one-task-per-worker use of this; a long-lived service
- * such as the audio core host keeps its worker and talks to it with messages.
- *
- * The script must be self-contained for the same reason a `spawn` task must: it runs with
- * nothing but its own text in scope.
- *
- * @example
- * ```ts
- * import { openWorker } from '@datamoc/mw_games/threads';
- *
- * const link = openWorker('globalThis.onmessage = (event) => globalThis.postMessage(event.data * 2);', {
- * 	message: (value) => console.log(value),
- * 	fail: (error) => console.warn(error.message),
- * });
- * link?.post(21);
- * ```
- */
-export declare function openWorker(source: string, events: WorkerLinkEvents): WorkerLink | null;
-/**
- * Runs `fn` on a worker thread and resolves with its value, keeping the caller's thread
- * free: the one synchronous block a game can never get back is the frame it spends waiting.
- *
- * The task is serialized with `Function.prototype.toString` and rehydrated in the worker,
- * so it must be **self-contained** - no closures over module scope, no imports, no bound or
- * native functions. Everything it needs arrives as `args`, structured-cloned in; buffers
- * listed in `options.transfer` are moved instead, detached from the caller's thread. The
- * result comes back structured-cloned, with every ArrayBuffer inside it transferred rather
- * than copied (the worker is finished with them). A task that throws, closes over
- * something the worker cannot see, or exits its worker without answering rejects the
- * promise - it never hangs - and `timeout` or `signal` abandon a task that never returns.
- *
- * One worker per task: construction costs a few milliseconds, which is nothing next to the
- * work worth moving off the main thread (T161 measured break-even at roughly 10 ms per
- * task in a batch, and far less against a dropped frame).
- *
- * @example
- * ```ts
- * import { spawn } from '@datamoc/mw_games/threads';
- *
- * const sum = await spawn((a: number, b: number) => a + b, [40, 2]);
- * console.log(sum); // 42
- *
- * //a task that never returns is abandoned rather than hanging the caller
- * const controller = new AbortController();
- * const pending = spawn(() => new Promise(() => {}), [], { signal: controller.signal });
- * controller.abort();
- * pending.catch((error: Error) => console.log(error.name)); // 'AbortError'
- * ```
- */
-export declare function spawn<Args extends readonly unknown[], Result>(fn: (...args: Args) => Result, args?: Args, options?: SpawnOptions): Promise<Awaited<Result>>;
-//# sourceMappingURL=spawn.d.ts.map

package/dist/threads/spawn.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../src/threads/spawn.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC5B,sGAAsG;IACtG,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;IAC1B,0HAA0H;IAC1H,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6FAA6F;IAC7F,MAAM,CAAC,EAAE,WAAW,CAAC;CACrB;AAED,gDAAgD;AAChD,MAAM,WAAW,UAAU;IAC1B,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;IACxD,SAAS,IAAI,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAChC,kCAAkC;IAClC,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAC7B,uEAAuE;IACvE,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACzB;AAoDD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,UAAU,GAAG,IAAI,CAGtF;AASD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,KAAK,CAAC,IAAI,SAAS,SAAS,OAAO,EAAE,EAAE,MAAM,EAC5D,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,MAAM,EAC7B,IAAI,CAAC,EAAE,IAAI,EACX,OAAO,GAAE,YAAiB,GACxB,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CA0D1B"}

package/dist/threads/spawn.js

@@ -1,167 +0,0 @@
-import { nodeThreads, workerMain } from './worker.js';
-const browserWorker = (source, events) => {
-    if (typeof Worker === 'undefined' ||
-        typeof Blob === 'undefined' ||
-        typeof URL === 'undefined' ||
-        typeof URL.createObjectURL !== 'function') {
-        return null;
-    }
-    //a blob worker, because the shipped file:// page allows worker-src blob: and because a
-    //file:// module worker is blocked by CORS whatever the policy says
-    const url = URL.createObjectURL(new Blob([source], { type: 'text/javascript' }));
-    let worker;
-    try {
-        worker = new Worker(url);
-    }
-    catch (error) {
-        URL.revokeObjectURL(url);
-        throw error;
-    }
-    worker.onmessage = (event) => events.message(event.data);
-    worker.onerror = (event) => events.fail(new Error(event.message || 'the worker failed to run'));
-    worker.onmessageerror = () => events.fail(new Error('the worker sent a reply that could not be deserialized'));
-    return {
-        post: (message, transfer = []) => worker.postMessage(message, transfer),
-        terminate: () => {
-            worker.terminate();
-            URL.revokeObjectURL(url);
-        },
-    };
-};
-const nodeWorker = (source, events) => {
-    const threads = nodeThreads();
-    if (!threads)
-        return null;
-    //the same source string as the browser path, executed as CJS by Node's eval mode
-    const worker = new threads.Worker(source, { eval: true });
-    worker.on('message', (reply) => events.message(reply));
-    worker.on('error', (error) => events.fail(error instanceof Error ? error : new Error(String(error))));
-    worker.on('messageerror', () => events.fail(new Error('the worker sent a reply that could not be deserialized')));
-    //a task that kills its worker without answering must reject rather than hang forever -
-    //the failure the multithreading package's pool never reports (T161)
-    worker.on('exit', (code) => events.fail(new Error(`the worker exited with code ${code} before answering`)));
-    return {
-        post: (message, transfer = []) => worker.postMessage(message, transfer),
-        terminate: () => void worker.terminate(),
-    };
-};
-/**
- * Opens a worker running a classic script, in a browser (a blob worker, which the shipped
- * `file://` page's policy allows) or in Node (`worker_threads` in eval mode), and returns null
- * where neither exists. `spawn` is the one-task-per-worker use of this; a long-lived service
- * such as the audio core host keeps its worker and talks to it with messages.
- *
- * The script must be self-contained for the same reason a `spawn` task must: it runs with
- * nothing but its own text in scope.
- *
- * @example
- * ```ts
- * import { openWorker } from '@datamoc/mw_games/threads';
- *
- * const link = openWorker('globalThis.onmessage = (event) => globalThis.postMessage(event.data * 2);', {
- * 	message: (value) => console.log(value),
- * 	fail: (error) => console.warn(error.message),
- * });
- * link?.post(21);
- * ```
- */
-export function openWorker(source, events) {
-    //each host returns null when its environment is absent, so they are tried in order
-    return browserWorker(source, events) ?? nodeWorker(source, events);
-}
-/** the error a failed reply carries, with the worker-side stack where there was one */
-function taskError(reply) {
-    const error = new Error(reply.message);
-    if (reply.stack)
-        error.stack = reply.stack;
-    return error;
-}
-/**
- * Runs `fn` on a worker thread and resolves with its value, keeping the caller's thread
- * free: the one synchronous block a game can never get back is the frame it spends waiting.
- *
- * The task is serialized with `Function.prototype.toString` and rehydrated in the worker,
- * so it must be **self-contained** - no closures over module scope, no imports, no bound or
- * native functions. Everything it needs arrives as `args`, structured-cloned in; buffers
- * listed in `options.transfer` are moved instead, detached from the caller's thread. The
- * result comes back structured-cloned, with every ArrayBuffer inside it transferred rather
- * than copied (the worker is finished with them). A task that throws, closes over
- * something the worker cannot see, or exits its worker without answering rejects the
- * promise - it never hangs - and `timeout` or `signal` abandon a task that never returns.
- *
- * One worker per task: construction costs a few milliseconds, which is nothing next to the
- * work worth moving off the main thread (T161 measured break-even at roughly 10 ms per
- * task in a batch, and far less against a dropped frame).
- *
- * @example
- * ```ts
- * import { spawn } from '@datamoc/mw_games/threads';
- *
- * const sum = await spawn((a: number, b: number) => a + b, [40, 2]);
- * console.log(sum); // 42
- *
- * //a task that never returns is abandoned rather than hanging the caller
- * const controller = new AbortController();
- * const pending = spawn(() => new Promise(() => {}), [], { signal: controller.signal });
- * controller.abort();
- * pending.catch((error: Error) => console.log(error.name)); // 'AbortError'
- * ```
- */
-export function spawn(fn, args, options = {}) {
-    return new Promise((resolve, reject) => {
-        if (options.signal?.aborted) {
-            reject(options.signal.reason);
-            return;
-        }
-        let settled = false;
-        let timer;
-        let worker;
-        const settle = (finish) => {
-            if (settled)
-                return;
-            settled = true;
-            if (timer !== undefined)
-                clearTimeout(timer);
-            options.signal?.removeEventListener('abort', onAbort);
-            //one worker per task: whatever settled it, the worker is done
-            worker?.terminate();
-            finish();
-        };
-        function onAbort() {
-            settle(() => reject(options.signal.reason));
-        }
-        const events = {
-            message: (data) => settle(() => {
-                const reply = data;
-                if (reply.ok)
-                    resolve(reply.value);
-                else
-                    reject(taskError(reply));
-            }),
-            fail: (error) => settle(() => reject(error)),
-        };
-        try {
-            worker = openWorker(`(${workerMain.toString()})()`, events);
-        }
-        catch (error) {
-            reject(error);
-            return;
-        }
-        if (!worker) {
-            reject(new Error('spawn() needs Web Workers or node:worker_threads, and this environment offers neither'));
-            return;
-        }
-        if (options.timeout !== undefined && options.timeout > 0) {
-            timer = setTimeout(() => settle(() => reject(new Error(`the task did not answer within ${options.timeout} ms`))), options.timeout);
-        }
-        options.signal?.addEventListener('abort', onAbort, { once: true });
-        try {
-            worker.post({ code: fn.toString(), args: args ?? [] }, options.transfer ?? []);
-        }
-        catch (error) {
-            //unclonable arguments, or a transfer list that does not match the message
-            settle(() => reject(error));
-        }
-    });
-}
-//# sourceMappingURL=spawn.js.map

package/dist/threads/spawn.js.map

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

package/dist/threads/worker.d.ts

@@ -1,51 +0,0 @@
-/** what the main thread posts to a fresh worker: the task's source and its arguments */
-export interface WorkerRequest {
-    /** the stringified task function, rehydrated in the worker with `new Function` */
-    code: string;
-    args: readonly unknown[];
-}
-/** what the worker posts back: the value, or the failure that stopped it */
-export type WorkerReply = {
-    ok: true;
-    value: unknown;
-} | {
-    ok: false;
-    message: string;
-    stack?: string;
-};
-/**
- * The slice of `node:worker_threads` this module uses, described structurally: `src/`
- * compiles in a browser-only config (the `@example` fence compiler runs with `types: []`),
- * so nothing here may name `process` or a `node:` type directly.
- */
-export interface NodeThreads {
-    parentPort: {
-        on(event: 'message', listener: (request: WorkerRequest) => void): void;
-        postMessage(message: WorkerReply, transfer?: ArrayBuffer[]): void;
-    } | null;
-    Worker: new (code: string, options: {
-        eval: true;
-    }) => {
-        on(event: 'message', listener: (reply: WorkerReply) => void): void;
-        on(event: 'error', listener: (error: unknown) => void): void;
-        on(event: 'messageerror', listener: () => void): void;
-        on(event: 'exit', listener: (code: number) => void): void;
-        postMessage(message: WorkerRequest, transfer?: readonly unknown[]): void;
-        terminate(): Promise<number> | void;
-    };
-}
-/** `node:worker_threads` reached through `globalThis`, so nothing here needs @types/node */
-export declare function nodeThreads(): NodeThreads | undefined;
-/**
- * The worker half of `threads.spawn`: receives one task, runs it, replies, and goes no
- * further (spawn terminates it as soon as the reply settles).
- *
- * **This function must stay self-contained.** `spawn` ships it to a worker with
- * `workerMain.toString()`, so it may not reference imports, module-scope helpers or any
- * outer binding - everything it needs is either a language global or nested inside it.
- * The same body runs in both transports: a classic blob worker in the browser (where the
- * shipped `file://` CSP allows only `worker-src blob:` and `new Function`, per the T161
- * probe) and an eval'd `node:worker_threads` worker in Node, which has no `self`.
- */
-export declare function workerMain(): void;
-//# sourceMappingURL=worker.d.ts.map

package/dist/threads/worker.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/threads/worker.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,MAAM,WAAW,aAAa;IAC7B,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,OAAO,EAAE,CAAC;CACzB;AAED,4EAA4E;AAC5E,MAAM,MAAM,WAAW,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAExG;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC3B,UAAU,EAAE;QACX,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,GAAG,IAAI,CAAC;QACvE,WAAW,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;KAClE,GAAG,IAAI,CAAC;IACT,MAAM,EAAE,KACP,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;QAAE,IAAI,EAAE,IAAI,CAAA;KAAE,KACnB;QACJ,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,IAAI,CAAC;QACnE,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;QAC7D,EAAE,CAAC,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;QACtD,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;QAC1D,WAAW,CAAC,OAAO,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI,CAAC;QACzE,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;KACpC,CAAC;CACF;AAED,4FAA4F;AAC5F,wBAAgB,WAAW,IAAI,WAAW,GAAG,SAAS,CAMrD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAoEjC"}

package/dist/threads/worker.js

@@ -1,84 +0,0 @@
-/** `node:worker_threads` reached through `globalThis`, so nothing here needs @types/node */
-export function nodeThreads() {
-    return globalThis.process?.getBuiltinModule?.('node:worker_threads');
-}
-/**
- * The worker half of `threads.spawn`: receives one task, runs it, replies, and goes no
- * further (spawn terminates it as soon as the reply settles).
- *
- * **This function must stay self-contained.** `spawn` ships it to a worker with
- * `workerMain.toString()`, so it may not reference imports, module-scope helpers or any
- * outer binding - everything it needs is either a language global or nested inside it.
- * The same body runs in both transports: a classic blob worker in the browser (where the
- * shipped `file://` CSP allows only `worker-src blob:` and `new Function`, per the T161
- * probe) and an eval'd `node:worker_threads` worker in Node, which has no `self`.
- */
-export function workerMain() {
-    //the same chain as nodeThreads(), inlined because workerMain is stringified into the
-    //worker and may not call anything module-scoped; the cast is a type, erased before then
-    const nodePort = globalThis.process?.getBuiltinModule?.('node:worker_threads')?.parentPort ?? null;
-    const scope = globalThis;
-    /** every ArrayBuffer reachable through plain objects and arrays, listed once each */
-    const transferablesOf = (value) => {
-        const out = [];
-        const seen = new Set();
-        const visit = (item) => {
-            if (item === null || typeof item !== 'object')
-                return;
-            if (seen.has(item))
-                return;
-            seen.add(item);
-            if (ArrayBuffer.isView(item)) {
-                //a view transfers its whole buffer; a SharedArrayBuffer cannot transfer, so it
-                //stays a copy (and does not exist in the shipped file:// target at all)
-                const buffer = item.buffer;
-                if (buffer instanceof ArrayBuffer && !out.includes(buffer))
-                    out.push(buffer);
-                return;
-            }
-            if (item instanceof ArrayBuffer) {
-                if (!out.includes(item))
-                    out.push(item);
-                return;
-            }
-            if (Array.isArray(item)) {
-                for (const entry of item)
-                    visit(entry);
-                return;
-            }
-            const prototype = Object.getPrototypeOf(item);
-            if (prototype === Object.prototype || prototype === null) {
-                for (const entry of Object.values(item))
-                    visit(entry);
-            }
-        };
-        visit(value);
-        return out;
-    };
-    const reply = (message, transfer = []) => {
-        if (nodePort)
-            nodePort.postMessage(message, transfer);
-        else
-            scope.postMessage(message, transfer);
-    };
-    const onRequest = async (request) => {
-        try {
-            const task = new Function(`return (${request.code});`)();
-            const value = await task(...request.args);
-            reply({ ok: true, value }, transferablesOf(value));
-        }
-        catch (error) {
-            const failure = error;
-            reply({
-                ok: false,
-                message: String(failure?.message ?? error),
-                stack: typeof failure?.stack === 'string' ? failure.stack : undefined,
-            });
-        }
-    };
-    if (nodePort)
-        nodePort.on('message', (request) => void onRequest(request));
-    else
-        scope.onmessage = (event) => void onRequest(event.data);
-}
-//# sourceMappingURL=worker.js.map

package/dist/threads/worker.js.map

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

package/dist/three-d/Character3D.d.ts

@@ -1,74 +0,0 @@
-import type { AnimationGroup } from '@babylonjs/core/Animations/animationGroup.js';
-import type { AbstractMesh } from '@babylonjs/core/Meshes/abstractMesh.js';
-import { TransformNode } from '@babylonjs/core/Meshes/transformNode.js';
-import type { Scene } from '@babylonjs/core/scene.js';
-/** Options for `Character3D.billboard`. `width` and `height` are world units (1 and 1.5 when omitted). */
-export interface Billboard3DOptions {
-    /**
-     * An asset path (resolved through `mwg/assets`) or an already-resolved `data:`/`blob:`
-     * URI. A `data:` URI must be base64-encoded (`;base64,...`) - Babylon's texture loader
-     * does not decode a percent-encoded one and fails to load it without an error.
-     */
-    texture: string;
-    width?: number;
-    height?: number;
-}
-/**
- * Clamps one frame's intended horizontal move to wherever collision actually allows - the
- * hook `mwg/3d`'s own grid collision (`resolveCapsuleAgainstGrid`) plugs into. `blocked`,
- * when the resolver reports it (`resolveCapsuleAgainstGrid` always does), tells `update`
- * directly whether the move was cut short, rather than `update` re-deriving the same fact by
- * comparing the resolved position against the intended one through separate floating-point
- * arithmetic - two numbers that are conceptually equal are not guaranteed bit-identical.
- */
-export type CollideXZ = (from: {
-    x: number;
-    z: number;
-}, to: {
-    x: number;
-    z: number;
-}) => {
-    x: number;
-    z: number;
-    blocked?: boolean;
-};
-/**
- * Moves either a billboard sprite or imported mesh through continuous 3D world space, and -
- * for an imported mesh - plays back whichever animation clips came baked into it.
- * `loadModel3D` already loads a glTF's own `animationGroups` as part of its import result;
- * this is what turns one of them into something a game can actually trigger, the way a walk
- * cycle baked into a mesh needs to be, rather than leaving them loaded but unreachable.
- */
-export declare class Character3D {
-    readonly node: TransformNode;
-    private target;
-    private speed;
-    private readonly collideXZ?;
-    private readonly animations;
-    private currentClip;
-    /**
-     * @param collideXZ optional, like `rpg.FreeMover` stays unopinionated about collision
-     * until a game wires one in - omitted, `moveTo` interpolates through open space with no
-     * notion of terrain height or collision at all, same as before this existed.
-     */
-    constructor(node: TransformNode, animations?: readonly AnimationGroup[], collideXZ?: CollideXZ);
-    /** true when an animation clip of this name was imported with the model */
-    hasAnimation(name: string): boolean;
-    /**
-     * Plays an imported animation clip by name, stopping whichever one was already playing.
-     * A name the model has no clip for is a no-op, returning `false`, the same
-     * degrade-to-nothing `ActorAnimator`/`GridMover` already use for a missing animation
-     * rather than throwing over what is often just a naming mismatch between assets.
-     */
-    playAnimation(name: string, loop?: boolean): boolean;
-    /** stops whichever imported clip is currently playing, if any */
-    stopAnimation(): void;
-    /** the name of the clip currently playing, or null when none is */
-    get currentAnimation(): string | null;
-    moveTo(x: number, y: number, z: number, speed: number): void;
-    update(deltaSeconds: number): boolean;
-    /** @param animations typically `loadModel3D`'s own `animationGroups` result field */
-    static fromMesh(mesh: AbstractMesh, animations?: readonly AnimationGroup[]): Character3D;
-    static billboard(scene: Scene, options: Billboard3DOptions): Character3D;
-}
-//# sourceMappingURL=Character3D.d.ts.map