@datamoc/mw_games 0.16.0 → 0.17.1

package/dist/simulation/Runtime.js

@@ -1,5 +1,6 @@
 import { Generator } from '../core/Random.js';
 import { ActionJournal } from '../core/ActionJournal.js';
+import { cloneData } from '../core/Clone.js';
 import { stateChecksum } from '../core/SyncGuard.js';
 import { UndoHistory } from '../core/UndoHistory.js';
 import { Scheduler } from '../roguelike/Scheduler.js';
@@ -85,6 +86,15 @@ export function validateSimulationReplay(initial, entries, options) {
  * automatic-actor loop and fixed-command replay respectively; a game composes both against
  * the same `scheduler` rather than choosing one over the other.
  *
+ * Every command and event batch is journalled, and with `history` every committed state is
+ * checkpointed, all through `structuredClone`: `Command`, `Event` and `State` must be plain data.
+ * A command naming its target as a live actor object (one that owns a `ReactionTable`, or any
+ * other callback) cannot be copied, so carry the actor's id and resolve it in the rule. A
+ * `dispatch` whose command, events or checkpoint cannot be copied throws a `TypeError` naming
+ * the offending path and commits nothing: state, scheduler, random stream and journal stay as
+ * they were before the call. The type system cannot enforce this, since a class instance with
+ * methods is perfectly cloneable while a plain object with one function field is not.
+ *
  * @example
  * ```ts
  * import { SimulationRuntime, type SimulationRuntimeRule } from '@datamoc/mw_games/simulation';
@@ -142,13 +152,23 @@ export class SimulationRuntime {
     /** Runs one command through the rule, commits the resulting state, and charges its cost
      * to the scheduler's current actor when one is given. */
     dispatch(command) {
+        const random = this.random.getState();
         const outcome = this.rule(this._state, command, { random: this.random, scheduler: this._scheduler });
+        let checkpoint;
+        try {
+            checkpoint = this.history ? cloneData(outcome.state, 'state') : null;
+            // Last fallible step, so a refused command or event batch leaves the journal unchanged.
+            this.journal.append(command, outcome.events);
+        }
+        catch (error) {
+            this.random.setState(random);
+            throw error;
+        }
         this._state = outcome.state;
         if (outcome.cost != null)
             this._scheduler.spend(outcome.cost);
-        this.journal.append(command, outcome.events);
         if (this.history)
-            this.history.push(this.historySnapshot());
+            this.history.push(this.historySnapshot(checkpoint));
         return outcome;
     }
     get canUndo() {
@@ -204,8 +224,9 @@ export class SimulationRuntime {
             actorId: options.actorId,
         });
     }
-    historySnapshot() {
-        return structuredClone(this.snapshot());
+    /** `snapshot()` already copies the scheduler, random state and journal; only state is live. */
+    historySnapshot(state = cloneData(this._state, 'state')) {
+        return { ...this.snapshot(), state };
     }
     restoreCheckpoint(snapshot) {
         if (!this.actorOf)

package/dist/simulation/Runtime.js.map

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

package/dist/testing/index.d.ts

@@ -0,0 +1,105 @@
+import { type SaveStorage } from '../core/Save.ts';
+import type { WebSocketLike } from '../core/Multiplayer.ts';
+import type { Playable } from '../audio/Playable.ts';
+/**
+ * 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 declare function memoryStorage(): SaveStorage;
+/** a `Playable` that records how often it was played */
+export interface FakePlayable extends Playable {
+    playCount: number;
+    paused: boolean;
+}
+/**
+ * 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 declare function fakeAudio(): FakePlayable;
+/**
+ * `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 declare function fakeAudioWithEnded(): FakePlayable;
+/**
+ * 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 declare class FakeSocket implements WebSocketLike {
+    readyState: number;
+    readonly sent: string[];
+    onopen: ((event: unknown) => void) | null;
+    onclose: ((event: unknown) => void) | null;
+    onerror: ((event: unknown) => void) | null;
+    onmessage: ((event: {
+        data: string;
+    }) => void) | null;
+    send(data: string): void;
+    close(): void;
+    receive(message: unknown): void;
+    receiveRaw(data: string): void;
+}
+/** one request a `fakeFetch` received */
+export interface FakeFetchCall {
+    url: string;
+    init?: RequestInit;
+}
+/**
+ * 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 declare function fakeFetch(respond: (url: string, init?: RequestInit) => unknown): typeof globalThis.fetch & {
+    calls: FakeFetchCall[];
+};
+/**
+ * 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 declare function fakeGamepad(index: number, buttons?: number[], axes?: number[]): Gamepad;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,IAAI,WAAW,CAE3C;AAED,wDAAwD;AACxD,MAAM,WAAW,YAAa,SAAQ,QAAQ;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,IAAI,YAAY,CAexC;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,YAAY,CAEjD;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,UAAW,YAAW,aAAa;IAC/C,UAAU,SAAK;IACf,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAM;IAC7B,MAAM,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,IAAI,CAAQ;IACjD,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,IAAI,CAAQ;IAClD,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,IAAI,CAAQ;IAClD,SAAS,EAAE,CAAC,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC,GAAG,IAAI,CAAQ;IAE7D,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEvB;IAED,KAAK,IAAI,IAAI,CAGZ;IAED,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAE9B;IAED,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE7B;CACD;AAED,yCAAyC;AACzC,MAAM,WAAW,aAAa;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,WAAW,CAAC;CACnB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CACxB,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,GACnD,OAAO,UAAU,CAAC,KAAK,GAAG;IAAE,KAAK,EAAE,aAAa,EAAE,CAAA;CAAE,CAStD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,EAAO,EAAE,IAAI,GAAE,MAAM,EAAO,GAAG,OAAO,CAM/F"}

package/dist/testing/index.js

@@ -0,0 +1,134 @@
+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,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAoB,MAAM,iBAAiB,CAAC;AAIlE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,aAAa;IAC5B,OAAO,IAAI,aAAa,EAAE,CAAC;AAC5B,CAAC;AAQD;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,SAAS;IACxB,OAAO;QACN,SAAS,EAAE,CAAC;QACZ,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,CAAC;QACT,WAAW,EAAE,CAAC;QACd,IAAI,EAAE,KAAK;QACX,IAAI;YACH,IAAI,CAAC,SAAS,EAAE,CAAC;YACjB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACrB,CAAC;QACD,KAAK;YACJ,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACpB,CAAC;KACD,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB;IACjC,OAAO,EAAE,GAAG,SAAS,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC1C,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,UAAU;IAAvB;QACC,eAAU,GAAG,CAAC,CAAC;QACN,SAAI,GAAa,EAAE,CAAC;QAC7B,WAAM,GAAsC,IAAI,CAAC;QACjD,YAAO,GAAsC,IAAI,CAAC;QAClD,YAAO,GAAsC,IAAI,CAAC;QAClD,cAAS,GAA+C,IAAI,CAAC;IAkB9D,CAAC;IAhBA,IAAI,CAAC,IAAY;QAChB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;IAED,KAAK;QACJ,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC;QACpB,IAAI,CAAC,OAAO,EAAE,CAAC,SAAS,CAAC,CAAC;IAC3B,CAAC;IAED,OAAO,CAAC,OAAgB;QACvB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED,UAAU,CAAC,IAAY;QACtB,IAAI,CAAC,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5B,CAAC;CACD;AAQD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,SAAS,CACxB,OAAqD;IAErD,MAAM,KAAK,GAAoB,EAAE,CAAC;IAClC,MAAM,KAAK,GAAG,KAAK,EAAE,KAAwB,EAAE,IAAkB,EAAE,EAAE;QACpE,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1B,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACxC,OAAO,MAAM,YAAY,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;IACpG,CAAC,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAAC,KAAgC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;AACnE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa,EAAE,OAAO,GAAa,EAAE,EAAE,IAAI,GAAa,EAAE;IACrF,OAAO;QACN,KAAK;QACL,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,GAAG,GAAG,EAAE,OAAO,EAAE,KAAK,GAAG,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;QACxF,IAAI;KACkB,CAAC;AACzB,CAAC"}

package/dist/version.d.ts

@@ -9,5 +9,5 @@
  * this from `package.json` automatically, chosen because this project's own build already
  * has no step before `tsc`/`vite` that this would need to run ahead of.
  */
-export declare const version = "0.16.0";
+export declare const version = "0.17.1";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -9,5 +9,5 @@
  * this from `package.json` automatically, chosen because this project's own build already
  * has no step before `tsc`/`vite` that this would need to run ahead of.
  */
-export const version = '0.16.0';
+export const version = '0.17.1';
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@datamoc/mw_games",
-	"version": "0.16.0",
+	"version": "0.17.1",
 	"description": "A local-file game framework: renderer-free game logic, drawn through PixiJS in 2D or Babylon.js in 3D, with mobile and desktop packaging.",
 	"license": "MPL-2.0",
 	"repository": {
@@ -33,6 +33,18 @@
 		"./dist/three-d/TileGrid3D.js",
 		"./dist/two-d/render/TintedSprite.js"
 	],
+	"bin": {
+		"mwg-bench": "tools/benchmark-browser.mjs",
+		"mwg-emit": "tools/emit-page.mjs",
+		"mwg-extract-rgssad": "tools/extract-rgssad.mjs",
+		"mwg-i18n": "tools/i18n-edit.mjs",
+		"mwg-lockstep-server": "tools/multiplayer-server.mjs",
+		"mwg-mwl": "tools/mwl.mjs",
+		"mwg-placeholder-assets": "tools/make-example-assets.mjs",
+		"mwg-sbom": "tools/sbom.mjs",
+		"mwg-size": "tools/bundle-size.mjs",
+		"mwg-smoke": "tools/browser-smoke.mjs"
+	},
 	"publishConfig": {
 		"access": "public"
 	},
@@ -48,9 +60,37 @@
 		"tools/compress-dist.d.mts",
 		"tools/classic-html.mjs",
 		"tools/classic-html.d.mts",
+		"tools/sbom.mjs",
+		"tools/sbom.d.mts",
+		"sbom.cdx.json",
 		"tools/single-file.mjs",
 		"tools/single-file.d.mts",
+		"tools/make-example-assets.mjs",
+		"tools/make-example-assets.d.mts",
+		"tools/multiplayer-server.mjs",
+		"tools/multiplayer-server.d.mts",
 		"tools/mwl.mjs",
+		"tools/benchmark-browser.mjs",
+		"tools/benchmark-browser.d.mts",
+		"tools/benchmark-history.mjs",
+		"tools/benchmark-history.d.mts",
+		"tools/browser-smoke.mjs",
+		"tools/bundle-size.mjs",
+		"tools/bundle-size.d.mts",
+		"tools/browser-smoke.d.mts",
+		"tools/csp.mjs",
+		"tools/csp.d.mts",
+		"tools/emit-page.mjs",
+		"tools/emit-page.d.mts",
+		"tools/extract-rgssad.mjs",
+		"tools/extract-rgssad.d.mts",
+		"tools/vendored/rgssad-wasm",
+		"tools/find-chrome.mjs",
+		"tools/i18n-edit.mjs",
+		"tools/i18n-edit.d.mts",
+		"tools/find-chrome.d.mts",
+		"tools/vite.mjs",
+		"tools/vite.d.mts",
 		"LICENSE",
 		"CHANGELOG.md",
 		"README.md",
@@ -134,11 +174,28 @@
 			"types": "./dist/ai/lua.d.ts",
 			"import": "./dist/ai/lua.js"
 		},
+		"./testing": {
+			"types": "./dist/testing/index.d.ts",
+			"import": "./dist/testing/index.js"
+		},
+		"./tools/benchmark-browser": "./tools/benchmark-browser.mjs",
+		"./tools/benchmark-history": "./tools/benchmark-history.mjs",
+		"./tools/browser-smoke": "./tools/browser-smoke.mjs",
+		"./tools/bundle-size": "./tools/bundle-size.mjs",
 		"./tools/classic-html": "./tools/classic-html.mjs",
 		"./tools/compile-resources": "./tools/compile-resources.mjs",
 		"./tools/compress-dist": "./tools/compress-dist.mjs",
+		"./tools/csp": "./tools/csp.mjs",
+		"./tools/emit-page": "./tools/emit-page.mjs",
 		"./tools/extract-html": "./tools/extract-html.mjs",
+		"./tools/extract-rgssad": "./tools/extract-rgssad.mjs",
+		"./tools/find-chrome": "./tools/find-chrome.mjs",
+		"./tools/i18n-edit": "./tools/i18n-edit.mjs",
+		"./tools/sbom": "./tools/sbom.mjs",
+		"./tools/make-example-assets": "./tools/make-example-assets.mjs",
+		"./tools/multiplayer-server": "./tools/multiplayer-server.mjs",
 		"./tools/single-file": "./tools/single-file.mjs",
+		"./tools/vite": "./tools/vite.mjs",
 		"./tools/webp-convert": "./tools/webp-convert.mjs",
 		"./two-d": {
 			"types": "./dist/two-d/index.d.ts",
@@ -184,7 +241,7 @@
 		"sbom:check": "node tools/sbom.mjs --check",
 		"ci:status": "node tools/ci-status.mjs",
 		"example": "vite --config examples/colour-transform/vite.config.ts",
-		"example:build": "vite build --config examples/colour-transform/vite.config.ts && node tools/emit-page.mjs examples/colour-transform",
+		"example:build": "vite build --config examples/colour-transform/vite.config.ts && node tools/emit-page.mjs examples/colour-transform --assets=examples/assets",
 		"test": "node --test \"tests/**/*.test.ts\"",
 		"coverage": "node --test --experimental-test-coverage --test-coverage-exclude=src/two-d/Game.ts --test-coverage-exclude=src/two-d/render/ColorTransformBatcher.ts --test-coverage-exclude=src/two-d/render/Minimap.ts --test-coverage-exclude=src/three-d/Vox.ts --test-coverage-exclude=src/two-d/stage/DialogueStage.ts --test-coverage-exclude=src/two-d/stage/EventDialogue.ts --test-coverage-exclude=src/two-d/ui/** --test-coverage-exclude=tools/** \"tests/**/*.test.ts\"",
 		"coverage:check": "node --test --experimental-test-coverage --test-coverage-lines=88 --test-coverage-branches=89 --test-coverage-functions=82 --test-coverage-exclude=src/two-d/Game.ts --test-coverage-exclude=src/two-d/render/ColorTransformBatcher.ts --test-coverage-exclude=src/two-d/render/Minimap.ts --test-coverage-exclude=src/three-d/Vox.ts --test-coverage-exclude=src/two-d/stage/DialogueStage.ts --test-coverage-exclude=src/two-d/stage/EventDialogue.ts --test-coverage-exclude=src/two-d/ui/** --test-coverage-exclude=tools/** \"tests/**/*.test.ts\"",
@@ -195,47 +252,47 @@
 		"i18n:edit": "node tools/i18n-edit.mjs",
 		"i18n:check": "node tools/i18n-edit.mjs --check",
 		"example:ui": "vite --config examples/interface/vite.config.ts",
-		"example:ui:build": "vite build --config examples/interface/vite.config.ts && node tools/emit-page.mjs examples/interface",
+		"example:ui:build": "vite build --config examples/interface/vite.config.ts && node tools/emit-page.mjs examples/interface --assets=examples/assets",
 		"example:dialogue": "vite --config examples/dialogue/vite.config.ts",
-		"example:dialogue:build": "vite build --config examples/dialogue/vite.config.ts && node tools/emit-page.mjs examples/dialogue",
+		"example:dialogue:build": "vite build --config examples/dialogue/vite.config.ts && node tools/emit-page.mjs examples/dialogue --assets=examples/assets",
 		"example:dungeon": "vite --config examples/dungeon/vite.config.ts",
-		"example:dungeon:build": "vite build --config examples/dungeon/vite.config.ts && node tools/emit-page.mjs examples/dungeon",
+		"example:dungeon:build": "vite build --config examples/dungeon/vite.config.ts && node tools/emit-page.mjs examples/dungeon --assets=examples/assets",
 		"example:village": "vite --config examples/village/vite.config.ts",
-		"example:village:build": "vite build --config examples/village/vite.config.ts && node tools/emit-page.mjs examples/village",
+		"example:village:build": "vite build --config examples/village/vite.config.ts && node tools/emit-page.mjs examples/village --assets=examples/assets",
 		"example:battle": "vite --config examples/battle/vite.config.ts",
-		"example:battle:build": "npm run mwl -- build examples/battle/content -o examples/battle/generated && vite build --config examples/battle/vite.config.ts && node tools/emit-page.mjs examples/battle",
+		"example:battle:build": "npm run mwl -- build examples/battle/content -o examples/battle/generated && vite build --config examples/battle/vite.config.ts && node tools/emit-page.mjs examples/battle --assets=examples/assets",
 		"example:minigame": "vite --config examples/minigame/vite.config.ts",
-		"example:minigame:build": "vite build --config examples/minigame/vite.config.ts && node tools/emit-page.mjs examples/minigame",
+		"example:minigame:build": "vite build --config examples/minigame/vite.config.ts && node tools/emit-page.mjs examples/minigame --assets=examples/assets",
 		"example:multi-turn-beam": "vite --config examples/multi-turn-beam/vite.config.ts",
-		"example:multi-turn-beam:build": "vite build --config examples/multi-turn-beam/vite.config.ts && node tools/emit-page.mjs examples/multi-turn-beam",
+		"example:multi-turn-beam:build": "vite build --config examples/multi-turn-beam/vite.config.ts && node tools/emit-page.mjs examples/multi-turn-beam --assets=examples/assets",
 		"example:chess": "vite --config examples/chess/vite.config.ts",
-		"example:chess:build": "vite build --config examples/chess/vite.config.ts && node tools/emit-page.mjs examples/chess",
+		"example:chess:build": "vite build --config examples/chess/vite.config.ts && node tools/emit-page.mjs examples/chess --assets=examples/assets",
 		"example:tower-defense": "vite --config examples/tower-defense/vite.config.ts",
-		"example:tower-defense:build": "vite build --config examples/tower-defense/vite.config.ts && node tools/emit-page.mjs examples/tower-defense",
+		"example:tower-defense:build": "vite build --config examples/tower-defense/vite.config.ts && node tools/emit-page.mjs examples/tower-defense --assets=examples/assets",
 		"example:3d": "vite --config examples/three-d/vite.config.ts",
-		"example:3d:build": "vite build --config examples/three-d/vite.config.ts && node tools/emit-page.mjs examples/three-d",
+		"example:3d:build": "vite build --config examples/three-d/vite.config.ts && node tools/emit-page.mjs examples/three-d --assets=examples/assets",
 		"example:loading": "vite --config examples/loading/vite.config.ts",
-		"example:loading:build": "vite build --config examples/loading/vite.config.ts && node tools/emit-page.mjs examples/loading",
+		"example:loading:build": "vite build --config examples/loading/vite.config.ts && node tools/emit-page.mjs examples/loading --assets=examples/assets",
 		"example:hello-world": "vite --config examples/hello-world/vite.config.ts",
-		"example:hello-world:build": "vite build --config examples/hello-world/vite.config.ts && node tools/emit-page.mjs examples/hello-world",
+		"example:hello-world:build": "vite build --config examples/hello-world/vite.config.ts && node tools/emit-page.mjs examples/hello-world --assets=examples/assets",
 		"example:movement": "vite --config examples/movement/vite.config.ts",
-		"example:movement:build": "vite build --config examples/movement/vite.config.ts && node tools/emit-page.mjs examples/movement",
+		"example:movement:build": "vite build --config examples/movement/vite.config.ts && node tools/emit-page.mjs examples/movement --assets=examples/assets",
 		"example:save-load": "vite --config examples/save-load/vite.config.ts",
-		"example:save-load:build": "vite build --config examples/save-load/vite.config.ts && node tools/emit-page.mjs examples/save-load",
+		"example:save-load:build": "vite build --config examples/save-load/vite.config.ts && node tools/emit-page.mjs examples/save-load --assets=examples/assets",
 		"example:audio": "vite --config examples/audio/vite.config.ts",
-		"example:audio:build": "vite build --config examples/audio/vite.config.ts && node tools/emit-page.mjs examples/audio",
+		"example:audio:build": "vite build --config examples/audio/vite.config.ts && node tools/emit-page.mjs examples/audio --assets=examples/assets",
 		"example:i18n": "vite --config examples/i18n/vite.config.ts",
-		"example:i18n:build": "vite build --config examples/i18n/vite.config.ts && node tools/emit-page.mjs examples/i18n",
+		"example:i18n:build": "vite build --config examples/i18n/vite.config.ts && node tools/emit-page.mjs examples/i18n --assets=examples/assets",
 		"example:string-editor": "vite --config examples/string-editor/vite.config.ts",
-		"example:string-editor:build": "vite build --config examples/string-editor/vite.config.ts && node tools/emit-page.mjs examples/string-editor",
+		"example:string-editor:build": "vite build --config examples/string-editor/vite.config.ts && node tools/emit-page.mjs examples/string-editor --assets=examples/assets",
 		"example:world-transition": "vite --config examples/world-transition/vite.config.ts",
-		"example:world-transition:build": "vite build --config examples/world-transition/vite.config.ts && node tools/emit-page.mjs examples/world-transition",
+		"example:world-transition:build": "vite build --config examples/world-transition/vite.config.ts && node tools/emit-page.mjs examples/world-transition --assets=examples/assets",
 		"example:event-system": "vite --config examples/event-system/vite.config.ts",
-		"example:event-system:build": "vite build --config examples/event-system/vite.config.ts && node tools/emit-page.mjs examples/event-system",
+		"example:event-system:build": "vite build --config examples/event-system/vite.config.ts && node tools/emit-page.mjs examples/event-system --assets=examples/assets",
 		"example:headless": "vite --config examples/headless/vite.config.ts",
-		"example:headless:build": "vite build --config examples/headless/vite.config.ts && node tools/emit-page.mjs examples/headless",
+		"example:headless:build": "vite build --config examples/headless/vite.config.ts && node tools/emit-page.mjs examples/headless --assets=examples/assets",
 		"example:mwl-content": "vite --config examples/mwl-content/vite.config.ts",
-		"example:mwl-content:build": "npm run mwl -- build examples/mwl-content/content -o examples/mwl-content/generated && vite build --config examples/mwl-content/vite.config.ts && node tools/emit-page.mjs examples/mwl-content",
+		"example:mwl-content:build": "npm run mwl -- build examples/mwl-content/content -o examples/mwl-content/generated && vite build --config examples/mwl-content/vite.config.ts && node tools/emit-page.mjs examples/mwl-content --assets=examples/assets",
 		"benchmark:browser": "npm run example:dungeon:build && node tools/benchmark-browser.mjs",
 		"benchmark:3d": "npm run example:3d:build && node tools/benchmark-browser.mjs examples/three-d/dist/index.html",
 		"benchmark:tower-defense": "npm run example:tower-defense:build && node tools/benchmark-browser.mjs examples/tower-defense/dist/index.html",
@@ -250,7 +307,7 @@
 		"webpage:examples": "node tools/build-webpage-examples.mjs",
 		"webpage:docs": "node tools/build-webpage-docs.mjs",
 		"webpage:diagrams": "node tools/make-example-diagrams.mjs && node tools/make-architecture-diagrams.mjs",
-		"mobile:build": "vite build --config examples/tower-defense/vite.config.ts && node tools/emit-page.mjs examples/tower-defense --no-compress",
+		"mobile:build": "vite build --config examples/tower-defense/vite.config.ts && node tools/emit-page.mjs examples/tower-defense --assets=examples/assets --no-compress",
 		"cap:cli": "node --require ./tools/capacitor-node-workaround.cjs ./node_modules/@capacitor/cli/bin/capacitor",
 		"cap:add:android": "npm run mobile:build && npm run cap:cli -- add android",
 		"cap:add:ios": "npm run mobile:build && npm run cap:cli -- add ios",
@@ -271,7 +328,9 @@
 		"@babylonjs/core": "^9.25.0",
 		"@babylonjs/loaders": "^9.25.0",
 		"@capacitor/core": "^7.4.4",
-		"pixi.js": "^8.20.1"
+		"pixi.js": "^8.20.1",
+		"playwright-core": "^1.62.1",
+		"ws": "^8.21.3"
 	},
 	"peerDependenciesMeta": {
 		"@babylonjs/core": {
@@ -285,6 +344,12 @@
 		},
 		"pixi.js": {
 			"optional": true
+		},
+		"playwright-core": {
+			"optional": true
+		},
+		"ws": {
+			"optional": true
 		}
 	},
 	"devDependencies": {