@moku-labs/game 0.13.1 → 0.13.3

package/dist/app/page.d.mts

@@ -1,4 +1,4 @@
-import { m as StartedPage, r as GameConfig, t as AnyGameApp, u as PageOptions } from "../types-DLghaGEy.mjs";
+import { m as StartedPage, r as GameConfig, t as AnyGameApp, u as PageOptions } from "../types-DkO3s9YX.mjs";
 
 //#region src/app/page.d.ts
 /**

package/dist/app/system.d.mts

@@ -1,6 +1,6 @@
-import { tn as PlayerStateProvider } from "../types-ZQLYXo5X.mjs";
-import { ct as PlatformProvider } from "../index-rnOYAriI.mjs";
-import { _ as SystemShellFactory, g as SystemName, h as SystemModules } from "../types-DLghaGEy.mjs";
+import { tn as PlayerStateProvider } from "../types-BSMmnpFm.mjs";
+import { ct as PlatformProvider } from "../index-CjuObHhF.mjs";
+import { _ as SystemShellFactory, g as SystemName, h as SystemModules } from "../types-DkO3s9YX.mjs";
 import { Back, Haptics, KeepAwake, Lifecycle, Store } from "@moku-labs/system";
 
 //#region src/app/system.d.ts

package/dist/app.d.mts

@@ -1,5 +1,5 @@
-import { Xt as Json } from "./types-ZQLYXo5X.mjs";
-import { a as GameHandle, c as MemoryProvider, d as SaveKind, f as Scenario, g as SystemName, i as GameDefinition, l as PageAgent, n as GameApp, o as GamePluginConfigs, p as ScreenSeams, r as GameConfig, s as HeadlessSeams } from "./types-DLghaGEy.mjs";
+import { Xt as Json } from "./types-BSMmnpFm.mjs";
+import { a as GameHandle, c as MemoryProvider, d as SaveKind, f as Scenario, g as SystemName, i as GameDefinition, l as PageAgent, n as GameApp, o as GamePluginConfigs, p as ScreenSeams, r as GameConfig, s as HeadlessSeams } from "./types-DkO3s9YX.mjs";
 import { AnyPluginInstance } from "@moku-labs/core";
 
 //#region src/app/define.d.ts

package/dist/app.mjs

@@ -1,4 +1,4 @@
-import { Ct as effectsPlugin, H as platformPlugin, Nt as audioPlugin, i as screen, t as createApp } from "./src-SmT-XxVf.mjs";
+import { Ct as effectsPlugin, H as platformPlugin, Nt as audioPlugin, i as screen, t as createApp } from "./src-DlyYl_9X.mjs";
 import { t as memory } from "./memory-CWlqhS7l.mjs";
 import { t as fakeClock } from "./fake-MpzwZhIZ.mjs";
 //#region src/app/define.ts

package/dist/assets.d.mts

@@ -1,4 +1,4 @@
-import { u as Manifest } from "./types-ZQLYXo5X.mjs";
+import { u as Manifest } from "./types-BSMmnpFm.mjs";
 
 //#region src/plugins/assets/scan/cli.d.ts
 /**

package/dist/assets.mjs

@@ -1,2 +1,2 @@
-import { a as runCli, c as emitKeys, i as compileStrings, l as emitManifest, n as importStrings, o as scanAssets, r as checkStrings, s as packAssets, t as exportStrings } from "./assets-DYiKxPBX.mjs";
+import { a as runCli, c as emitKeys, i as compileStrings, l as emitManifest, n as importStrings, o as scanAssets, r as checkStrings, s as packAssets, t as exportStrings } from "./assets-BrKSg1O6.mjs";
 export { checkStrings, compileStrings, emitKeys, emitManifest, exportStrings, importStrings, packAssets, runCli, scanAssets };

package/dist/{capture-fpd83Mi5.mjs → capture-D7XvoHdH.mjs}

@@ -197,6 +197,24 @@ function findNode(main, path, contributionsOf = noContributions) {
 	}
 }
 /**
+* Tells whether an entry of a flow is a rest checkpoint: a rest node that carries the checkpoint
+* flag, a place a save may stand on. A sub-flow and a slot are no nodes. A transit node is never
+* one, whatever its flag says: it is a place inside a transition.
+*
+* @param entry - A node, a sub-flow or a slot of a flow.
+* @returns True for a node with both `rest` and `checkpoint`.
+* @example
+* ```ts
+* // `home` rests and is a checkpoint. `boot` is a transit node that carries the flag too.
+* isRestCheckpoint(home); // true
+* isRestCheckpoint(boot); // false
+* isRestCheckpoint(boardFlow); // false: a sub-flow is no node
+* ```
+*/
+function isRestCheckpoint(entry) {
+	return entry.kind === "node" && entry.rest && entry.checkpoint;
+}
+/**
 * Renders an edge target as a string: a node name, `"exit:win"` or `"map:node"`.
 *
 * @param target - The target as the edge table holds it.
@@ -336,6 +354,65 @@ function describeGraph(flows, features) {
 	};
 }
 /**
+* Reads one node of a described flow by name. Own keys only: `nodes.constructor` is defined on
+* every object.
+*
+* @param flow - The described flow, or `undefined` when the graph does not hold it.
+* @param name - Name of the node.
+* @returns The described node, or `undefined` when the flow has none of that name.
+* @example
+* ```ts
+* ownNode({ nodes: {}, start: "home", edges: {} }, "constructor"); // undefined
+* ```
+*/
+function ownNode(flow, name) {
+	return flow !== void 0 && Object.hasOwn(flow.nodes, name) ? flow.nodes[name] : void 0;
+}
+/**
+* Picks the described flow a path continues in after one node: the sub-flow it enters, or, behind
+* a slot, the first contribution in order that has the next segment as a node. The same choice
+* `findNode` makes on the flows themselves.
+*
+* @param graph - Result of `describeGraph`.
+* @param node - The described node the path just passed.
+* @param next - The next segment of the path.
+* @returns The flow to go on in, or `undefined` when the path ends here.
+* @example
+* ```ts
+* // In a graph whose main flow uses the sub-flow "board" as its node "board":
+* describedFlowBehind(graph, graph.flows.main.nodes.board, "awaitIntent")?.start; // "awaitIntent"
+* ```
+*/
+function describedFlowBehind(graph, node, next) {
+	if (node.subFlow !== void 0) return graph.flows[node.subFlow];
+	if (node.slot === void 0) return void 0;
+	return (graph.slots[node.slot] ?? []).map((contribution) => graph.flows[contribution.flow]).find((flow) => ownNode(flow, next) !== void 0);
+}
+/**
+* Finds the node a path names in a described graph, the way `findNode` finds it in the flows: one
+* sub-flow per segment, and through a slot into the contribution that has the next segment. For a
+* caller that holds only `flow.describe()`, such as a headless helper.
+*
+* @param graph - Result of `describeGraph`.
+* @param path - A path as `framePath` renders it.
+* @returns The described node, sub-flow or slot, or `undefined` when the path names nothing.
+* @example
+* ```ts
+* describedNode(app.flow.describe(), "board/awaitIntent")?.rest; // true: a rest node
+* describedNode(app.flow.describe(), "board")?.subFlow; // "board": a sub-flow, no rest node
+* ```
+*/
+function describedNode(graph, path) {
+	const names = path.split("/").filter(Boolean);
+	let flow = graph.flows[graph.main];
+	for (const [step, name] of names.entries()) {
+		const node = ownNode(flow, name);
+		const next = names[step + 1];
+		if (node === void 0 || next === void 0) return node;
+		flow = describedFlowBehind(graph, node, next);
+	}
+}
+/**
 * Compares two object keys without a locale, so the rendering is the same everywhere.
 *
 * @param first - First key.
@@ -1151,4 +1228,4 @@ async function captureFrame(mctx, options) {
 	return shot === void 0 ? void 0 : answerOf(mctx, shot, options.against);
 }
 //#endregion
-export { sheetAlone as a, findNode as c, slotNames as d, compact as f, servePaused as i, framePath as l, captureFrame as n, collectFlows as o, pushEntry as p, serveCaptures as r, describeGraph as s, cancelCaptures as t, graphHash as u };
+export { sheetAlone as a, describedNode as c, graphHash as d, isRestCheckpoint as f, pushEntry as h, servePaused as i, findNode as l, compact as m, captureFrame as n, collectFlows as o, slotNames as p, serveCaptures as r, describeGraph as s, cancelCaptures as t, framePath as u };

package/dist/cli.d.mts

@@ -87,8 +87,9 @@ declare function runCli(argv: readonly string[]): Promise<number>;
  * `dev.ts`, `main.ts` with the scenarios of `tests/scenarios/` (and, with agents, the agents and
  * the game's `.dev` modules), and `bunfig.toml` with the engine's hot plugin. It also writes the
  * first `assets-stamp.ts`, the empty one, when the game has none: `main.ts` imports it, and
- * `watchKeys` rewrites it when an asset file changes. It starts no server and no watcher, and
- * throws the `[game]` errors of `moku-game dev`.
+ * `watchKeys` rewrites it when an asset file changes. The page accepts the new stamp: new bytes
+ * of a file swap in place, a new or removed file reloads the page. It starts no server and no
+ * watcher, and throws the `[game]` errors of `moku-game dev`.
  *
  * @param root - The game folder, relative to the cwd or absolute.
  * @param options - The agents, the preloads and the extra bundler plugins.
@@ -112,9 +113,10 @@ declare function preparePage(root: string, options?: PreparePageOptions): Promis
  * `strings/<locale>.json` scans again, with the same flags, outputs and layers; an output that
  * did not change is not rewritten. On the page a rewritten `generated/strings.<locale>.ts` hot
  * swaps. An asset file that is new, gone or saved again rewrites `.moku/assets-stamp.ts`, which
- * the page imports, so the page reloads and shows the new image or the new bytes of an old one. A
- * failed scan goes to `onError` and the watch goes on, the first scan too. The layers of
- * `config.ts` are read once: a changed layer needs a new `watchKeys`.
+ * the page imports and accepts as a hot swap: the new bytes of a file swap in place in the loaded
+ * bundles, with no reload, and a new or removed file reloads the page. A failed scan goes to
+ * `onError` and the watch goes on, the first scan too. The layers of `config.ts` are read once:
+ * a changed layer needs a new `watchKeys`.
  *
  * @param root - The game folder, relative to the cwd or absolute.
  * @param options - Where the message of a failed scan goes.

package/dist/cli.mjs

@@ -1,12 +1,11 @@
 import { t as resolveConfig } from "./config-CdARrrhU.mjs";
-import { r as watchTree, t as createBatcher, x as isSkippedFolder$1 } from "./watch-CB8IWDBi.mjs";
-import { a as runCli$1, i as compileStrings, n as importStrings, t as exportStrings } from "./assets-DYiKxPBX.mjs";
+import { r as watchTree, t as createBatcher, x as isSkippedFolder$1 } from "./watch-CWI_on4T.mjs";
+import { a as runCli$1, i as compileStrings, n as importStrings, t as exportStrings } from "./assets-BrKSg1O6.mjs";
 import { constants, copyFileSync, existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, rmSync, statSync, watch, writeFileSync } from "node:fs";
 import path from "node:path";
 import { createBrandConsole } from "@moku-labs/common/cli";
 import { parseArgs } from "node:util";
 import { pathToFileURL } from "node:url";
-import { createHash } from "node:crypto";
 //#region src/app/generate.ts
 /** The first line of a generated file a person may open. */
 const WRITTEN = "// Written by moku-game dev. Do not edit.";
@@ -230,6 +229,21 @@ function importLine(binding, specifier) {
 	return `import ${binding} from ${JSON.stringify(specifier)};`;
 }
 /**
+* Orders two texts by their code units, as `toSorted()` does without a comparer.
+*
+* @param first - One text.
+* @param second - The other text.
+* @returns A negative number, zero or a positive number.
+* @example
+* ```ts
+* compareText("a/b.png", "a/c.png"); // -1
+* ```
+*/
+function compareText(first, second) {
+	if (first === second) return 0;
+	return first < second ? -1 : 1;
+}
+/**
 * The path from a page under `.moku/` to `.moku/` itself, where the one stamp of a game lives.
 *
 * @param toRoot - The path from the page to the game folder.
@@ -246,8 +260,9 @@ function toStampFolder(toRoot) {
 * The `main.ts` of the dev page: the dev flag first, then the assets stamp, the page entry, the
 * game, its config, one import per scenario, and, with agents, one per `.dev` module and one per
 * agent. It calls `startPage` with the scenarios by file stem, the shell with the loaders of the
-* named plugins when the game needs it, the agents and the `.dev` modules. The stamp import makes
-* the page reload when the keys watch writes a new stamp: an asset file changed.
+* named plugins when the game needs it, the agents and the `.dev` modules. The stamp import puts
+* the stamp module on the page: when the keys watch writes a new stamp, the hot plugin hands it to
+* the running game.
 *
 * @param settings - The resolved `config.ts`.
 * @param sources - The scenario files, the `.dev` modules and the agents.
@@ -324,20 +339,34 @@ function devFlag() {
 	return `${WRITTEN}\nglobalThis.__MOKU_GAME_DEV__ = true;\n`;
 }
 /**
-* The `assets-stamp.ts` module the dev `main.ts` imports: one string that changes when an asset
-* file of the game changes. The hot plugin takes it for a logic module, so a new stamp reloads the
-* page, and the page shows the new bytes of an image whose key stayed the same. The page starts
-* with the empty stamp; the keys watch writes the hash of the asset files.
+* The `assets-stamp.ts` module the dev `main.ts` imports: the asset files of the game with their
+* stamps, and the ones the last save changed. The hot plugin takes it for a module that swaps, so
+* a new stamp reaches the running game, which reads the changed files again. The page starts with
+* the empty stamp; the keys watch writes the files. Both lists are sorted here, and every path
+* and stamp is written by `JSON.stringify`: a file name may hold a quote or a backslash.
 *
-* @param hash - The hash of the asset files, `""` before the first watch.
+* @param files - Every watched asset file: its path relative to the game with `/`, and its stamp
+*   `<size>:<mtimeMs>`. None before the first watch.
+* @param changed - The paths whose stamp differs from the batch before, the new ones too. None in
+*   the first stamp of a run.
 * @returns The text of `.moku/assets-stamp.ts`.
 * @example
 * ```ts
-* assetsStamp(""); // '// Written by moku-game dev. Do not edit.\nexport default "";\n'
+* assetsStamp([], []); // '// Written by moku-game dev. Do not edit.\nexport default {\n  files: {},\n  changed: []\n};\n'
 * ```
 */
-function assetsStamp(hash) {
-	return `${WRITTEN}\nexport default ${JSON.stringify(hash)};\n`;
+function assetsStamp(files, changed) {
+	const entries = files.toSorted(([first], [second]) => compareText(first, second)).map(([file, stamp]) => `    ${JSON.stringify(file)}: ${JSON.stringify(stamp)}`);
+	const map = entries.length === 0 ? "{}" : `{\n${entries.join(",\n")}\n  }`;
+	const list = changed.toSorted(compareText).map((file) => JSON.stringify(file)).join(", ");
+	return [
+		WRITTEN,
+		"export default {",
+		`  files: ${map},`,
+		`  changed: [${list}]`,
+		"};",
+		""
+	].join("\n");
 }
 /**
 * A TOML array of strings. `JSON.stringify` of a path is a valid TOML basic string, also for a
@@ -623,7 +652,7 @@ function writePage(root, settings, options, resolve, page = ".moku") {
 	];
 	const stamp = path.join(root, ".moku", ASSETS_STAMP);
 	for (const [file, text] of texts) writeIfChanged(file, text);
-	if (!existsSync(stamp)) writeIfChanged(stamp, assetsStamp(""));
+	if (!existsSync(stamp)) writeIfChanged(stamp, assetsStamp([], []));
 	return {
 		html,
 		bunfig
@@ -1797,11 +1826,12 @@ async function runCommand(argv, deps) {
 * events stop for a quiet period, a batch walks the game and reads the size and the time stamp of
 * every asset file and every `strings/<locale>.json`; it runs the scan of `moku-game keys` only
 * when they differ from the batch before. After a scan it writes `.moku/assets-stamp.ts` from the
-* asset files, so the dev page reloads and shows the new bytes of an image. One scan runs at a
-* time, and a failed scan never stops the watch. A batch that scanned is followed by one more
-* walk: the platform reports only the first path of a burst of writes, so a save made in the same
-* instant as the scan's own writes under `generated/` may never be reported. The scan, `fs.watch`
-* and the console come in as seams, so a test drives it. Node and Bun only: the bin bundles it.
+* asset files: every file with its stamp, and the ones this batch found changed, so the dev page
+* reads only those again. One scan runs at a time, and a failed scan never stops the watch. A
+* batch that scanned is followed by one more walk: the platform reports only the first path of a
+* burst of writes, so a save made in the same instant as the scan's own writes under `generated/`
+* may never be reported. The scan, `fs.watch` and the console come in as seams, so a test drives
+* it. Node and Bun only: the bin bundles it.
 */
 /** The quiet period that closes a batch of file events. */
 const QUIET_MS = 100;
@@ -1882,19 +1912,24 @@ function changedPaths(before, after) {
 	return [.../* @__PURE__ */ new Set([...before.keys(), ...after.keys()])].filter((file) => before.get(file) !== after.get(file)).toSorted();
 }
 /**
-* Hashes the asset files of a walk: their paths, sizes and time stamps. The strings files stay
-* out, so a strings save leaves the hash as it is.
+* The text of the stamp module after one batch: every asset file of the walk with its stamp, and
+* the asset files that differ from the batch before. The strings files stay out, so a batch that
+* saved only strings has no stamp to write. A removed file is not listed as changed: it shows by
+* its absence from the files. The first batch of a run has no batch before it, so it lists none.
 *
-* @param inputs - The stamps of a walk.
-* @returns The SHA-1 as 40 hex digits.
+* @param inputs - The stamps of this walk.
+* @param changed - The inputs that differ from the batch before: added, removed, or saved again.
+* @param first - True for the first batch of the watch.
+* @returns The text, or `undefined` when no asset file changed in a later batch.
 * @example
 * ```ts
-* assetsHash(new Map([["features/home/strings/en.json", "9:1"]])); // "da39a3ee5e6b4b0d3255bfef95601890afd80709": no asset file
+* stampText(new Map([["a.png", "4:2"], ["strings/en.json", "9:1"]]), ["a.png", "strings/en.json"], false); // '// Written by moku-game dev. Do not edit.\nexport default {\n  files: {\n    "a.png": "4:2"\n  },\n  changed: ["a.png"]\n};\n'
 * ```
 */
-function assetsHash(inputs) {
-	const assets = [...inputs].filter(([file]) => ASSET_FILE.test(file)).map(([file, stamp]) => `${file}:${stamp}`).toSorted();
-	return createHash("sha1").update(assets.join("\n")).digest("hex");
+function stampText(inputs, changed, first) {
+	const moved = changed.filter((file) => ASSET_FILE.test(file));
+	if (!first && moved.length === 0) return void 0;
+	return assetsStamp([...inputs].filter(([file]) => ASSET_FILE.test(file)), first ? [] : moved.filter((file) => inputs.has(file)));
 }
 /**
 * The line of a later scan that worked: the first changed input, and how many more.
@@ -1984,9 +2019,9 @@ async function scanAndReport(watch, changed, first) {
 }
 /**
 * One batch: walks the game, and scans when an input differs from the batch before; the first
-* batch always scans. Then it writes the stamp of the asset files, asks for one trailing batch,
-* and arms the folder watchers with the folders of the walk. A batch that did not scan asks for
-* nothing, so the trailing batch of a quiet game ends the chain.
+* batch always scans. Then it writes the stamp when an asset file changed, asks for one trailing
+* batch, and arms the folder watchers with the folders of the walk. A batch that did not scan
+* asks for nothing, so the trailing batch of a quiet game ends the chain.
 *
 * @param watch - The watch.
 */
@@ -1997,7 +2032,8 @@ async function runBatch(watch) {
 	watch.inputs = walk.inputs;
 	if (first || changed.length > 0) {
 		await scanAndReport(watch, changed, first);
-		writeIfChanged(path.join(watch.root, ".moku", ASSETS_STAMP), assetsStamp(assetsHash(walk.inputs)));
+		const stamp = stampText(walk.inputs, changed, first);
+		if (stamp !== void 0) writeIfChanged(path.join(watch.root, ".moku", ASSETS_STAMP), stamp);
 		watch.again();
 	}
 	if (!watch.closed) watch.tree.rearm(walk.folders);
@@ -2303,8 +2339,9 @@ async function runCli(argv) {
 * `dev.ts`, `main.ts` with the scenarios of `tests/scenarios/` (and, with agents, the agents and
 * the game's `.dev` modules), and `bunfig.toml` with the engine's hot plugin. It also writes the
 * first `assets-stamp.ts`, the empty one, when the game has none: `main.ts` imports it, and
-* `watchKeys` rewrites it when an asset file changes. It starts no server and no watcher, and
-* throws the `[game]` errors of `moku-game dev`.
+* `watchKeys` rewrites it when an asset file changes. The page accepts the new stamp: new bytes
+* of a file swap in place, a new or removed file reloads the page. It starts no server and no
+* watcher, and throws the `[game]` errors of `moku-game dev`.
 *
 * @param root - The game folder, relative to the cwd or absolute.
 * @param options - The agents, the preloads and the extra bundler plugins.
@@ -2335,9 +2372,10 @@ async function preparePage(root, options = {}) {
 * `strings/<locale>.json` scans again, with the same flags, outputs and layers; an output that
 * did not change is not rewritten. On the page a rewritten `generated/strings.<locale>.ts` hot
 * swaps. An asset file that is new, gone or saved again rewrites `.moku/assets-stamp.ts`, which
-* the page imports, so the page reloads and shows the new image or the new bytes of an old one. A
-* failed scan goes to `onError` and the watch goes on, the first scan too. The layers of
-* `config.ts` are read once: a changed layer needs a new `watchKeys`.
+* the page imports and accepts as a hot swap: the new bytes of a file swap in place in the loaded
+* bundles, with no reload, and a new or removed file reloads the page. A failed scan goes to
+* `onError` and the watch goes on, the first scan too. The layers of `config.ts` are read once:
+* a changed layer needs a new `watchKeys`.
 *
 * @param root - The game folder, relative to the cwd or absolute.
 * @param options - Where the message of a failed scan goes.

package/dist/{commands-DvFr8Uwp.d.mts → commands-DRhJ_LIH.d.mts}

@@ -1,8 +1,8 @@
-import { A as Api$2, E as DebugSwitches, Ot as Bookmark, h as Api$1, jt as FlowState, ln as Api, vn as Time, w as Captured } from "./types-ZQLYXo5X.mjs";
-import { a as AudioApi, r as UiApi, v as ScenesApi, x as AnimApi } from "./types-D_2G6Q68.mjs";
-import { A as InputApi } from "./types-BrTpz9oL.mjs";
-import { t as HeadlessApp } from "./headless-G4nuZ-xz.mjs";
-import { n as Command, r as ControlApp } from "./types-DAdwEJMp.mjs";
+import { A as Api$2, E as DebugSwitches, Ot as Bookmark, h as Api$1, jt as FlowState, ln as Api, vn as Time, w as Captured } from "./types-BSMmnpFm.mjs";
+import { a as AudioApi, r as UiApi, v as ScenesApi, x as AnimApi } from "./types-dJMOXXL3.mjs";
+import { A as InputApi } from "./types-Dm5Oh5bH.mjs";
+import { t as HeadlessApp } from "./headless-CYgYzro0.mjs";
+import { n as Command, r as ControlApp } from "./types-Bonifz5M.mjs";
 
 //#region src/plugins/flow/doors/commands.d.ts
 /**

package/dist/control.d.mts

@@ -1,7 +1,7 @@
-import { t as HeadlessApp } from "./headless-G4nuZ-xz.mjs";
-import { i as InputArguments, n as Command, o as InputSchema, s as Ran } from "./types-DAdwEJMp.mjs";
-import { t as commands } from "./commands-DvFr8Uwp.mjs";
-import { t as defineCommand } from "./define-CCc0ozKe.mjs";
+import { t as HeadlessApp } from "./headless-CYgYzro0.mjs";
+import { i as InputArguments, n as Command, o as InputSchema, s as Ran } from "./types-Bonifz5M.mjs";
+import { t as commands } from "./commands-DRhJ_LIH.mjs";
+import { t as defineCommand } from "./define-Ckp70_GR.mjs";
 
 //#region src/plugins/flow/doors/dev.d.ts
 /**

package/dist/control.mjs

@@ -1,4 +1,4 @@
 import { t as controlRefused } from "./dev-Cc50Dk7H.mjs";
 import { s as defineCommand } from "./session-DgukhR_7.mjs";
-import { n as commands, t as run } from "./run-wYty_Lwo.mjs";
+import { n as commands, t as run } from "./run-BtyrJjmW.mjs";
 export { commands, controlRefused, defineCommand, run };

package/dist/{define-CCc0ozKe.d.mts → define-Ckp70_GR.d.mts}

@@ -1,5 +1,5 @@
-import { t as HeadlessApp } from "./headless-G4nuZ-xz.mjs";
-import { c as Source, n as Command, o as InputSchema } from "./types-DAdwEJMp.mjs";
+import { t as HeadlessApp } from "./headless-CYgYzro0.mjs";
+import { c as Source, n as Command, o as InputSchema } from "./types-Bonifz5M.mjs";
 
 //#region src/plugins/flow/doors/define.d.ts
 /**

package/dist/{headless-BsNdJs9W.mjs → headless-BA6ffzqD.mjs}

@@ -1,4 +1,4 @@
-import { u as graphHash } from "./capture-fpd83Mi5.mjs";
+import { c as describedNode, d as graphHash } from "./capture-D7XvoHdH.mjs";
 //#region src/plugins/flow/headless.ts
 const noPayload = null;
 /** Seed of a repro that pins no rng state, the seed `saveOf` writes. */
@@ -91,29 +91,50 @@ async function createHeadless(app) {
 	};
 }
 /**
-* Reads the rest node a repro starts at: its checkpoint, or the start of the main flow.
+* Names a checkpoint of a described graph, for the message of a refused repro: the first rest
+* node that is one, or the start of the main flow when the graph has none.
+*
+* @param graph - The described graph.
+* @returns The path of a checkpoint to suggest.
+* @example
+* ```ts
+* someCheckpoint({ main: "main", flows: {}, slots: {} }); // "": an empty graph suggests nothing
+* ```
+*/
+function someCheckpoint(graph) {
+	for (const [id, flow] of Object.entries(graph.flows)) for (const [name, node] of Object.entries(flow.nodes)) if (node.rest && node.checkpoint) return id === graph.main ? name : `${id}/${name}`;
+	return graph.flows[graph.main]?.start ?? "";
+}
+/**
+* Reads the rest node a repro starts at: its checkpoint, or the start of the main flow. A repro
+* starts at a rest node only. `flow.restore` also enters a transit node while the graph is
+* unchanged, and a repro carries the hash of the graph that runs now, so the path is checked here.
 *
 * @param app - The started app.
 * @param repro - Starting state, optional checkpoint and the route.
 * @returns The path of the node the repro enters.
-* @throws {Error} When the graph has no main flow to start from.
+* @throws {Error} When the graph has no main flow to start from, and when the path names a node
+*   that is not a rest node.
 */
 function reproPath(app, repro) {
-	if (repro.checkpoint !== void 0) return repro.checkpoint;
 	const graph = app.flow.describe();
-	const start = graph.flows[graph.main]?.start;
-	if (start === void 0) throw new Error(`[game] runRepro() found no flow "${graph.main}" to start from.\n  Name the checkpoint the repro was taken at.`);
-	return start;
+	const path = repro.checkpoint ?? graph.flows[graph.main]?.start;
+	if (path === void 0) throw new Error(`[game] runRepro() found no flow "${graph.main}" to start from.\n  Name the checkpoint the repro was taken at.`);
+	const node = describedNode(graph, path);
+	if (node !== void 0 && !node.rest) throw new Error(`[game] The bookmark "${path}" is not a rest node of the graph.\n  Restore a rest node, for example the checkpoint "${someCheckpoint(graph)}".`);
+	return path;
 }
 /**
 * Builds the bookmark a repro is entered with: its state, its checkpoint and the hash of the
 * graph that runs now, so a checkpoint is accepted and any other rest node is checked. The route
-* is not part of it: the caller walks it after the restore.
+* is not part of it: the caller walks it after the restore. A repro starts at a rest node: a
+* checkpoint that names a transit node is refused here, although `flow.restore` enters one.
 *
 * @param app - The started app.
 * @param repro - Starting state, optional checkpoint and the route.
 * @returns The bookmark to restore.
-* @throws {Error} When the repro names no checkpoint and the graph has no main flow.
+* @throws {Error} When the repro names no checkpoint and the graph has no main flow, and when
+*   the node it starts at is not a rest node.
 * @example
 * ```ts
 * // The game.restore command loads a bug report taken at the "home" checkpoint.

package/dist/{headless-G4nuZ-xz.d.mts → headless-CYgYzro0.d.mts}

@@ -1,4 +1,4 @@
-import { Bt as Answer, Mt as JournalEntry, Pt as RouteStep, Xt as Json, cn as RngState, dt as Api$1, hn as Api, jt as FlowState } from "./types-ZQLYXo5X.mjs";
+import { Bt as Answer, Mt as JournalEntry, Pt as RouteStep, Xt as Json, cn as RngState, dt as Api$1, hn as Api, jt as FlowState } from "./types-BSMmnpFm.mjs";
 
 //#region src/plugins/flow/headless.d.ts
 /**

package/dist/hot.d.mts

@@ -15,9 +15,9 @@ type HotOptions = {
   /**
    * The files that get the footer. Default: `.tsx` files, `styles.ts`, `view.ts`,
    * `animations.ts`, `effects.ts`, any `.ts` directly in a `styles/`, `motion/`, `effects/` or
-   * `views/` folder, and in `world/projections/` or `world/layout/`, and
-   * `generated/strings.<locale>.ts`. Bun runs it as the load filter on the absolute path, so it
-   * should not anchor at the start.
+   * `views/` folder, and in `world/projections/` or `world/layout/`,
+   * `generated/strings.<locale>.ts`, and the stamp module `.moku/assets-stamp.ts`. Bun runs it as
+   * the load filter on the absolute path, so it should not anchor at the start.
    */
   include?: RegExp;
   /**

package/dist/hot.mjs

@@ -6,20 +6,22 @@ import { readFile } from "node:fs/promises";
 * a running game. It appends a footer to every view module it loads: the module accepts its own
 * update and hands the new exports to the running game through `globalThis.__moku_hot`. The `ui`
 * plugin installs that handler in dev builds only. What swaps: styles, components, projections,
-* animations, text styles, emitters and generated strings. A view module is a `.tsx` file, a
-* `styles.ts`, a `view.ts`, an `animations.ts`, an `effects.ts`, any `.ts` directly in a
-* `styles/`, `motion/`, `effects/` or `views/` folder, any `.ts` directly in `world/projections/`
-* or `world/layout/`, or a generated `generated/strings.<locale>.ts`; a logic module never gets
-* the footer (`world/components/` and `world/systems/` included: they are registered at start), so
-* its save reaches the root and the page reloads and restores its state. `moku-game dev` lists the
+* animations, text styles, emitters, generated strings, and the asset files the stamp module of
+* the keys watch names. A view module is a `.tsx` file, a `styles.ts`, a `view.ts`, an
+* `animations.ts`, an `effects.ts`, any `.ts` directly in a `styles/`, `motion/`, `effects/` or
+* `views/` folder, any `.ts` directly in `world/projections/` or `world/layout/`, or a generated
+* `generated/strings.<locale>.ts`. The stamp module `.moku/assets-stamp.ts` gets the footer too:
+* its new exports say which asset files changed. A logic module never gets the footer
+* (`world/components/` and `world/systems/` included: they are registered at start, and
+* `.moku/main.ts` too), so its save reaches the root and the page reloads and restores its state. `moku-game dev` lists the
 * plugin first in `[serve.static]` of the bunfig it writes, `.moku/bunfig.toml`; a game without the
 * shell lists it in its own `bunfig.toml`. The dev server only: `moku-game build` never loads it.
 */
 /**
-* The default view modules: the view files by name or by kind folder. Two literals joined, so
-* each stays readable.
+* The default modules that swap: the view files by name or by kind folder, and the stamp module.
+* Three literals joined, so each stays readable.
 */
-const DEFAULT_INCLUDE = new RegExp(`(${/\.tsx|\/styles\.ts|\/view\.ts|\/animations\.ts|\/effects\.ts|\/generated\/strings\.[\w-]+\.ts/.source}|${/\/(?:styles|motion|effects|views)\/[^/]+\.ts|\/world\/(?:projections|layout)\/[^/]+\.ts/.source})$`);
+const DEFAULT_INCLUDE = new RegExp(`(${/\.tsx|\/styles\.ts|\/view\.ts|\/animations\.ts|\/effects\.ts|\/generated\/strings\.[\w-]+\.ts/.source}|${/\/(?:styles|motion|effects|views)\/[^/]+\.ts|\/world\/(?:projections|layout)\/[^/]+\.ts/.source}|${/\/\.moku\/assets-stamp\.ts/.source})$`);
 /** The generated strings of one locale, the one file under `generated/` that swaps. */
 const STRINGS = /\/generated\/strings\.[\w-]+\.ts$/;
 /** The default folders and test files that never hot swap. The outer group only scopes the `$`. */

package/dist/{index-rnOYAriI.d.mts → index-CjuObHhF.d.mts}

@@ -1,7 +1,7 @@
-import { $ as DescriptionNode, A as Api$6, B as ComponentType, Et as FeatureDescription, Ft as SceneIdOf, G as Mut, Gt as State$2, J as QueryTerm, Jt as Config$5, K as Narrowed, Lt as Descriptor, N as State$8, Qt as State$5, R as ComponentHandle, Rt as GuideOptions, Sn as Require, Ut as Config$2, V as ComponentValue, Vt as Api$1, X as SystemDefinition, Xt as Json, Y as ResourceType, Z as TagType, Zt as Root, _n as State$7, a as Config$1, at as NumericFields, bn as Config$9, c as LoadBundles, d as State$1, dn as Events, dt as Api$2, en as Patch, et as Ease, f as Tier, fn as PauseReason, ft as BundlesOf, g as Config$6, gn as Config$7, gt as GameTypes, h as Api$4, hn as Api$5, ht as FeaturePlugin, i as BundleSpec, j as Config$8, k as ViewportSize, kt as DefineNode, l as LoadReason, ln as Api$3, mt as EmitterIdOf, o as DefineBundles, on as StoreApi, ot as ProjectionMotion, pn as State$4, pt as Config$3, r as BundleMap, sn as RngApi, st as ProjectionSpec, t as Api, un as Config$4, vt as State$3, x as State$6, xn as Events$1, xt as defineFlow, yt as TextStylesOf, zt as Hint } from "./types-ZQLYXo5X.mjs";
-import { A as SfxDescriptor, C as Config$10, D as Target, E as State$9, N as defineAnimation, S as AnimPlayerValue, T as MotionKeyframe, _ as SceneSpec, a as AudioApi, c as MusicDescriptor, d as State$10, g as SceneDefinition, h as LayerMap, j as Step, k as HapticKind, l as MusicOptions, m as DefineScene, n as State$12, p as AnySceneProjection, r as UiApi, s as Config$11, t as Config$12, v as ScenesApi, w as FramesValue, x as AnimApi, y as State$11, z as play } from "./types-D_2G6Q68.mjs";
-import { _ as NoiseValue, c as EmitterValue, d as ColorMatrixValue, f as DisplacementValue, g as GlowValue, h as FilterValueOf, i as State$13, l as AlphaValue, m as FilterSpec, n as EffectsApi, o as EmitterConfig, p as FilterComponent, s as EmitterDefinition, t as Config$13, u as BlurValue, v as OutlineValue, y as UniformDeclaration } from "./types-Bcdo5-2w.mjs";
-import { A as InputApi, B as SpriteOptions, E as TextValue, F as NineSliceValue, G as Argument, J as IntlKit, K as Config$14, O as defineComponent, Q as TypedTr, R as ShapeValue, S as TextBind, T as TextStyles, U as TransformValue, V as SpriteValue, W as sprite, X as Part, Y as Message, Z as State$14, _ as Config$16, b as State$16, et as IsFlags, f as defineTokens, g as BindOptions, h as BindField, it as WhenFlags, j as State$15, k as Config$15, nt as Style, p as IntrinsicElementsFor, q as I18nApi, s as PopupComponent, tt as ResolvedStyle, v as CountdownValue, w as TextStyleInput, x as TextApi, y as Point } from "./types-BrTpz9oL.mjs";
+import { $ as DescriptionNode, A as Api$6, B as ComponentType, Et as FeatureDescription, Ft as SceneIdOf, G as Mut, Gt as State$2, J as QueryTerm, Jt as Config$5, K as Narrowed, Lt as Descriptor, N as State$8, Qt as State$5, R as ComponentHandle, Rt as GuideOptions, Sn as Require, Ut as Config$2, V as ComponentValue, Vt as Api$1, X as SystemDefinition, Xt as Json, Y as ResourceType, Z as TagType, Zt as Root, _n as State$7, a as Config$1, at as NumericFields, bn as Config$9, c as LoadBundles, d as State$1, dn as Events, dt as Api$2, en as Patch, et as Ease, f as Tier, fn as PauseReason, ft as BundlesOf, g as Config$6, gn as Config$7, gt as GameTypes, h as Api$4, hn as Api$5, ht as FeaturePlugin, i as BundleSpec, j as Config$8, k as ViewportSize, kt as DefineNode, l as LoadReason, ln as Api$3, mt as EmitterIdOf, o as DefineBundles, on as StoreApi, ot as ProjectionMotion, pn as State$4, pt as Config$3, r as BundleMap, sn as RngApi, st as ProjectionSpec, t as Api, un as Config$4, vt as State$3, x as State$6, xn as Events$1, xt as defineFlow, yt as TextStylesOf, zt as Hint } from "./types-BSMmnpFm.mjs";
+import { A as SfxDescriptor, C as Config$10, D as Target, E as State$9, N as defineAnimation, S as AnimPlayerValue, T as MotionKeyframe, _ as SceneSpec, a as AudioApi, c as MusicDescriptor, d as State$10, g as SceneDefinition, h as LayerMap, j as Step, k as HapticKind, l as MusicOptions, m as DefineScene, n as State$12, p as AnySceneProjection, r as UiApi, s as Config$11, t as Config$12, v as ScenesApi, w as FramesValue, x as AnimApi, y as State$11, z as play } from "./types-dJMOXXL3.mjs";
+import { _ as NoiseValue, c as EmitterValue, d as ColorMatrixValue, f as DisplacementValue, g as GlowValue, h as FilterValueOf, i as State$13, l as AlphaValue, m as FilterSpec, n as EffectsApi, o as EmitterConfig, p as FilterComponent, s as EmitterDefinition, t as Config$13, u as BlurValue, v as OutlineValue, y as UniformDeclaration } from "./types-B_Bp2tWK.mjs";
+import { A as InputApi, B as SpriteOptions, E as TextValue, F as NineSliceValue, G as Argument, J as IntlKit, K as Config$14, O as defineComponent, Q as TypedTr, R as ShapeValue, S as TextBind, T as TextStyles, U as TransformValue, V as SpriteValue, W as sprite, X as Part, Y as Message, Z as State$14, _ as Config$16, b as State$16, et as IsFlags, f as defineTokens, g as BindOptions, h as BindField, it as WhenFlags, j as State$15, k as Config$15, nt as Style, p as IntrinsicElementsFor, q as I18nApi, s as PopupComponent, tt as ResolvedStyle, v as CountdownValue, w as TextStyleInput, x as TextApi, y as Point } from "./types-Dm5Oh5bH.mjs";
 import { Log } from "@moku-labs/common/browser";
 import { PluginCtx } from "@moku-labs/core";
 
@@ -196,6 +196,10 @@ declare const assetsPlugin: import("@moku-labs/core").PluginInstance<"assets", C
     reason: "budget" | "request";
     keys: readonly string[];
   };
+  "assets:replaced": {
+    bundle: string;
+    keys: readonly string[];
+  };
 }> & Record<never, never>;
 //#endregion
 //#region src/plugins/audio/index.d.ts
@@ -1641,6 +1645,10 @@ declare const screen: readonly [import("@moku-labs/core").PluginInstance<"world"
     reason: "budget" | "request";
     keys: readonly string[];
   };
+  "assets:replaced": {
+    bundle: string;
+    keys: readonly string[];
+  };
 }> & Record<never, never>, import("@moku-labs/core").PluginInstance<"scenes", Record<string, never>, State$11, ScenesApi, {
   "scenes:changed": {
     from: string | undefined;

package/dist/index.d.mts

@@ -1,6 +1,6 @@
-import { $ as DescriptionNode, $t as types_d_exports$9, C as types_d_exports$11, Ct as slot, Kt as types_d_exports$3, P as types_d_exports$16, St as exit, Tt as type, bt as types_d_exports$5, in as SaveUnreadableError, m as types_d_exports$1, mn as types_d_exports$8, wt as to, yn as types_d_exports$14 } from "./types-ZQLYXo5X.mjs";
-import { B as sequence, F as frames, G as stagger, H as sfx, I as haptic, J as wait, K as tween, L as mark, M as HAPTIC_KINDS, N as defineAnimation, O as types_d_exports, P as external, R as parallel, U as spawn, V as set, W as spawned, b as types_d_exports$12, f as types_d_exports$2, i as types_d_exports$15, k as HapticKind, q as use, z as play } from "./types-D_2G6Q68.mjs";
-import { a as types_d_exports$4 } from "./types-Bcdo5-2w.mjs";
-import { $ as types_d_exports$6, C as TextFormat, D as types_d_exports$13, H as Transform, I as Parent, L as Shape, M as types_d_exports$7, N as Display, O as defineComponent, P as NineSlice, W as sprite, d as popup, f as defineTokens, g as BindOptions, l as Box, u as LocalWrite, v as CountdownValue, z as Sprite } from "./types-BrTpz9oL.mjs";
-import { $ as defineFeature, A as Held, B as Traced, C as Animation, Ct as bind, D as load, E as defineBundles, F as Pressed, G as component, H as Layer, I as Swipeable, J as system, K as mut, L as Tappable, M as Pointer, N as PointerOver, O as Draggable, P as Pressable, Q as schedule, R as Touchable, S as AnimPlayer, St as Text, T as defineScene, Tt as label, U as Order, V as Exiting, W as Tree, X as guide, Y as tag, Z as hint, _ as defineStyle, _t as audioPlugin, a as defineEmitter, at as rendererPlugin, b as messageDuration, bt as projection, c as Alpha, ct as PlatformProvider, d as Displacement, dt as lifecyclePlugin, et as worldPlugin, f as Glow, ft as inputPlugin, g as resolve, gt as clockPlugin, h as music, ht as effectsPlugin, i as screen, it as scenesPlugin, j as Hovered, k as DropTarget, l as Blur, lt as types_d_exports$10, m as Outline, mt as flowPlugin, n as createPlugin, nt as timePlugin, o as Emitter, ot as platformPlugin, p as Noise, pt as i18nPlugin, q as resource, r as defineGame, rt as textPlugin, s as defineFilter, st as BackResult, t as createApp, tt as uiPlugin, u as ColorMatrix, ut as modelPlugin, v as tr, vt as assetsPlugin, w as Frames, wt as defineTextStyles, x as defineMotion, xt as Countdown, y as messageArgument, yt as animPlugin, z as Traceable } from "./index-rnOYAriI.mjs";
+import { $ as DescriptionNode, $t as types_d_exports$9, C as types_d_exports$11, Ct as slot, Kt as types_d_exports$3, P as types_d_exports$16, St as exit, Tt as type, bt as types_d_exports$5, in as SaveUnreadableError, m as types_d_exports$1, mn as types_d_exports$8, wt as to, yn as types_d_exports$14 } from "./types-BSMmnpFm.mjs";
+import { B as sequence, F as frames, G as stagger, H as sfx, I as haptic, J as wait, K as tween, L as mark, M as HAPTIC_KINDS, N as defineAnimation, O as types_d_exports, P as external, R as parallel, U as spawn, V as set, W as spawned, b as types_d_exports$12, f as types_d_exports$2, i as types_d_exports$15, k as HapticKind, q as use, z as play } from "./types-dJMOXXL3.mjs";
+import { a as types_d_exports$4 } from "./types-B_Bp2tWK.mjs";
+import { $ as types_d_exports$6, C as TextFormat, D as types_d_exports$13, H as Transform, I as Parent, L as Shape, M as types_d_exports$7, N as Display, O as defineComponent, P as NineSlice, W as sprite, d as popup, f as defineTokens, g as BindOptions, l as Box, u as LocalWrite, v as CountdownValue, z as Sprite } from "./types-Dm5Oh5bH.mjs";
+import { $ as defineFeature, A as Held, B as Traced, C as Animation, Ct as bind, D as load, E as defineBundles, F as Pressed, G as component, H as Layer, I as Swipeable, J as system, K as mut, L as Tappable, M as Pointer, N as PointerOver, O as Draggable, P as Pressable, Q as schedule, R as Touchable, S as AnimPlayer, St as Text, T as defineScene, Tt as label, U as Order, V as Exiting, W as Tree, X as guide, Y as tag, Z as hint, _ as defineStyle, _t as audioPlugin, a as defineEmitter, at as rendererPlugin, b as messageDuration, bt as projection, c as Alpha, ct as PlatformProvider, d as Displacement, dt as lifecyclePlugin, et as worldPlugin, f as Glow, ft as inputPlugin, g as resolve, gt as clockPlugin, h as music, ht as effectsPlugin, i as screen, it as scenesPlugin, j as Hovered, k as DropTarget, l as Blur, lt as types_d_exports$10, m as Outline, mt as flowPlugin, n as createPlugin, nt as timePlugin, o as Emitter, ot as platformPlugin, p as Noise, pt as i18nPlugin, q as resource, r as defineGame, rt as textPlugin, s as defineFilter, st as BackResult, t as createApp, tt as uiPlugin, u as ColorMatrix, ut as modelPlugin, v as tr, vt as assetsPlugin, w as Frames, wt as defineTextStyles, x as defineMotion, xt as Countdown, y as messageArgument, yt as animPlugin, z as Traceable } from "./index-CjuObHhF.mjs";
 export { Alpha, types_d_exports as Anim, AnimPlayer, Animation, types_d_exports$1 as Assets, types_d_exports$2 as Audio, type BackResult, type BindOptions, Blur, Box, types_d_exports$3 as Clock, ColorMatrix, Countdown, type CountdownValue, type DescriptionNode, Displacement, Display, Draggable, DropTarget, types_d_exports$4 as Effects, Emitter, Exiting, types_d_exports$5 as Flow, Frames, Glow, HAPTIC_KINDS, type HapticKind, Held, Hovered, types_d_exports$6 as I18n, types_d_exports$7 as Input, Layer, types_d_exports$8 as Lifecycle, LocalWrite, types_d_exports$9 as Model, NineSlice, Noise, Order, Outline, Parent, types_d_exports$10 as Platform, type PlatformProvider, Pointer, PointerOver, Pressable, Pressed, types_d_exports$11 as Renderer, SaveUnreadableError, types_d_exports$12 as Scenes, Shape, Sprite, Swipeable, Tappable, Text, type TextFormat, types_d_exports$13 as TextTypes, types_d_exports$14 as Time, Touchable, Traceable, Traced, Transform, Tree, types_d_exports$15 as Ui, types_d_exports$16 as World, animPlugin, assetsPlugin, audioPlugin, bind, clockPlugin, component, createApp, createPlugin, defineAnimation, defineBundles, defineComponent, defineEmitter, defineFeature, defineFilter, defineGame, defineMotion, defineScene, defineStyle, defineTextStyles, defineTokens, effectsPlugin, exit, external, flowPlugin, frames, guide, haptic, hint, i18nPlugin, inputPlugin, label, lifecyclePlugin, load, mark, messageArgument, messageDuration, modelPlugin, music, mut, parallel, platformPlugin, play, popup, projection, rendererPlugin, resolve, resource, scenesPlugin, schedule, screen, sequence, set, sfx, slot, spawn, spawned, sprite, stagger, system, tag, textPlugin, timePlugin, to, tr, tween, type, uiPlugin, use, wait, worldPlugin };