@moku-labs/game 0.9.0 → 0.10.0

package/dist/index.d.mts

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

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { $ as sfx, A as types_exports$3, At as defineFilter, B as defineStyle, Bt as flowPlugin, C as types_exports$10, Ct as Alpha, D as types_exports$6, Dt as Glow, E as types_exports$7, Et as Displacement, F as resolve, Ft as AnimPlayer, G as external, Gt as modelPlugin, H as platformPlugin, Ht as slot, I as Box, It as Animation, J as mark, K as frames, Kt as SaveUnreadableError, L as LocalWrite, Lt as Frames, M as types_exports$1, Mt as scenesPlugin, N as types_exports, Nt as assetsPlugin, O as types_exports$5, Ot as Noise, P as uiPlugin, Pt as animPlugin, Q as set, R as popup, Rt as rendererPlugin, S as types_exports$11, St as Emitter, T as types_exports$8, Tt as ColorMatrix, U as HAPTIC_KINDS, Ut as to, V as textPlugin, Vt as exit, W as defineAnimation, Wt as type, X as play, Xt as timePlugin, Y as parallel, Yt as lifecyclePlugin, Z as sequence, Zt as clockPlugin, _ as types_exports$16, _t as Touchable, a as defineMotion, at as wait, b as types_exports$13, bt as i18nPlugin, c as schedule, ct as DropTarget, d as tr, dt as Pointer, et as spawn, f as defineFeature, ft as PointerOver, g as load, gt as Tappable, h as defineBundles, ht as Swipeable, i as screen, it as use, j as types_exports$2, jt as audioPlugin, k as types_exports$4, kt as Outline, l as projection, lt as Held, m as music, mt as Pressed, n as createPlugin, nt as stagger, o as guide, ot as inputPlugin, p as defineEmitter, pt as Pressable, q as haptic, r as defineGame, rt as tween, s as hint, st as Draggable, t as createApp, tt as spawned, u as defineScene, ut as Hovered, v as types_exports$15, vt as Traceable, w as types_exports$9, wt as Blur, x as types_exports$12, xt as effectsPlugin, y as types_exports$14, yt as Traced, z as defineTokens, zt as worldPlugin } from "./src-536arXjV.mjs";
+import { $ as sfx, A as types_exports$3, At as defineFilter, B as defineStyle, Bt as flowPlugin, C as types_exports$10, Ct as Alpha, D as types_exports$6, Dt as Glow, E as types_exports$7, Et as Displacement, F as resolve, Ft as AnimPlayer, G as external, Gt as modelPlugin, H as platformPlugin, Ht as slot, I as Box, It as Animation, J as mark, Jt as timePlugin, K as frames, Kt as SaveUnreadableError, L as LocalWrite, Lt as Frames, M as types_exports$1, Mt as scenesPlugin, N as types_exports, Nt as assetsPlugin, O as types_exports$5, Ot as Noise, P as uiPlugin, Pt as animPlugin, Q as set, R as popup, Rt as rendererPlugin, S as types_exports$11, St as Emitter, T as types_exports$8, Tt as ColorMatrix, U as HAPTIC_KINDS, Ut as to, V as textPlugin, Vt as exit, W as defineAnimation, Wt as type, X as play, Y as parallel, Yt as clockPlugin, Z as sequence, _ as types_exports$16, _t as Touchable, a as defineMotion, at as wait, b as types_exports$13, bt as i18nPlugin, c as schedule, ct as DropTarget, d as tr, dt as Pointer, et as spawn, f as defineFeature, ft as PointerOver, g as load, gt as Tappable, h as defineBundles, ht as Swipeable, i as screen, it as use, j as types_exports$2, jt as audioPlugin, k as types_exports$4, kt as Outline, l as projection, lt as Held, m as music, mt as Pressed, n as createPlugin, nt as stagger, o as guide, ot as inputPlugin, p as defineEmitter, pt as Pressable, q as haptic, qt as lifecyclePlugin, r as defineGame, rt as tween, s as hint, st as Draggable, t as createApp, tt as spawned, u as defineScene, ut as Hovered, v as types_exports$15, vt as Traceable, w as types_exports$9, wt as Blur, x as types_exports$12, xt as effectsPlugin, y as types_exports$14, yt as Traced, z as defineTokens, zt as worldPlugin } from "./src-DSl1eNB1.mjs";
 import { A as system, C as Exiting, D as component, E as Tree, O as mut, S as sprite, T as Order, _ as Parent, b as Transform, c as Text, d as defineTextStyles, f as label, g as NineSlice, h as Display, j as tag, k as resource, l as bind, s as Countdown, v as Shape, w as Layer, y as Sprite } from "./visual-dMW8iqAE.mjs";
 import { r as defineComponent } from "./flatten-BkXuscAV.mjs";
 export { Alpha, types_exports as Anim, AnimPlayer, Animation, types_exports$1 as Assets, types_exports$2 as Audio, Blur, Box, types_exports$3 as Clock, ColorMatrix, Countdown, Displacement, Display, Draggable, DropTarget, types_exports$4 as Effects, Emitter, Exiting, types_exports$5 as Flow, Frames, Glow, HAPTIC_KINDS, Held, Hovered, types_exports$6 as I18n, types_exports$7 as Input, Layer, types_exports$8 as Lifecycle, LocalWrite, types_exports$9 as Model, NineSlice, Noise, Order, Outline, Parent, types_exports$10 as Platform, Pointer, PointerOver, Pressable, Pressed, types_exports$11 as Renderer, SaveUnreadableError, types_exports$12 as Scenes, Shape, Sprite, Swipeable, Tappable, Text, types_exports$13 as TextTypes, types_exports$14 as Time, Touchable, Traceable, Traced, Transform, Tree, types_exports$15 as Ui, types_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, 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 };

package/dist/inspect-la_KkjCS.mjs

@@ -0,0 +1 @@
+export {};

package/dist/inspect.d.mts

@@ -1,10 +1,10 @@
-import { Gt as Api, H as EntitySnapshot, R as ComponentSchema, U as FrameDiff, f as Usage, gt as Position, j as Explained, jt as JournalEntry, k as Api$1, kt as FlowGraph, m as Api$2, rn as Snapshot, t as Api$3, w as RenderStats, x as Under } from "./types-B0v5VVa3.mjs";
-import { t as HeadlessApp } from "./headless-SCQXJxQf.mjs";
-import { a as InputOf, c as Source, i as InputArguments, l as WatchApp, o as InputSchema, t as CheatEntry, u as WatchInput } from "./types-DUMoYPYe.mjs";
-import { c as UiNode } from "./types-xXfyk56Q.mjs";
-import { a as SoundEntry, t as AudioApi, v as UiApi } from "./types-VZVWwqCg.mjs";
-import { n as defineSource } from "./define-B6pHpdBi.mjs";
-import { n as EffectsApi, r as EffectsStats } from "./types-CQueODzo.mjs";
+import { A as Api$1, At as FlowGraph, M as Explained, Mt as JournalEntry, S as Under, T as RenderStats, U as EntitySnapshot, W as FrameDiff, _t as Position, an as Snapshot, h as Api$2, p as Usage, qt as Api, t as Api$3, z as ComponentSchema } from "./types-ZQLYXo5X.mjs";
+import { a as AudioApi, r as UiApi, u as SoundEntry } from "./types-BM4shh8K.mjs";
+import { n as EffectsApi, r as EffectsStats } from "./types-CefgYzFt.mjs";
+import { c as UiNode } from "./types-BUwDHKXm.mjs";
+import { t as HeadlessApp } from "./headless-G4nuZ-xz.mjs";
+import { a as InputOf, c as Source, i as InputArguments, l as WatchApp, o as InputSchema, t as CheatEntry, u as WatchInput } from "./types-DAdwEJMp.mjs";
+import { n as defineSource } from "./define-CCc0ozKe.mjs";
 
 //#region src/plugins/flow/doors/read.d.ts
 /**

package/dist/inspect.mjs

@@ -1,3 +1,4 @@
-import { c as defineSource } from "./input-z_35Jwfn.mjs";
-import { n as read, r as watch, t as sources } from "./sources-DNnzyCYf.mjs";
+import { c as defineSource } from "./session-DgukhR_7.mjs";
+import { n as read, r as watch, t as sources } from "./sources-Duzj6lhV.mjs";
+import "./inspect-la_KkjCS.mjs";
 export { defineSource, read, sources, watch };

package/dist/jsx-dev-runtime.d.mts

@@ -1,2 +1,2 @@
-import { a as jsxs, i as jsxDEV, n as JSX, r as jsx, t as Fragment } from "./runtime-CdNJ0UBm.mjs";
+import { a as jsxs, i as jsxDEV, n as JSX, r as jsx, t as Fragment } from "./runtime-DOBYM6g4.mjs";
 export { Fragment, type JSX, jsx, jsxDEV, jsxs };

package/dist/jsx-runtime.d.mts

@@ -1,2 +1,2 @@
-import { a as jsxs, n as JSX, r as jsx, t as Fragment } from "./runtime-CdNJ0UBm.mjs";
+import { a as jsxs, n as JSX, r as jsx, t as Fragment } from "./runtime-DOBYM6g4.mjs";
 export { Fragment, type JSX, jsx, jsxs };

package/dist/lint.mjs

@@ -1,5 +1,5 @@
-import path from "node:path";
 import { readFileSync, statSync } from "node:fs";
+import path from "node:path";
 //#region src/lint.ts
 /**
 * @file The lint door of the engine (subpath `./lint`): an oxlint JS plugin named `moku-game` with
@@ -20,10 +20,12 @@ const TESTS = [
 /** Dev modules: a `.dev` module is wired into the editor only. */
 const DEV_MODULES = ["**/*.dev.{ts,tsx}"];
 /**
-* The logic of a game: state, tables, the root flow in game.ts, core, nodes, flows, rules,
-* features, shared. `**` so `src/` matches too.
+* The logic of a game: state, tables, the game in the root index.ts, the root flow in game.ts,
+* core, nodes, flows, rules, features, shared. `**` so `src/` matches too; `index.ts` is the root
+* file only.
 */
 const LOGIC = [
+	"index.ts",
 	"**/state.ts",
 	"**/tables.ts",
 	"**/game.ts",
@@ -425,22 +427,24 @@ const lazyImports = importRule("No static import of pixi.js or yoga-layout; impo
 	pattern: /^yoga-layout(?:\/|$)/,
 	message: "L2: the ui plugin loads Yoga lazily. Use import() or import type."
 }], true);
-/** L13: native packages stay out of the engine-facing layers. */
-const nativeImports = importRule("No @moku-labs/system, @moku-labs/native or @tauri-apps/* in the engine-facing layers.", {
+/** L13: a game imports no native package; config.ts names the capability, the engine page wires it. */
+const nativeImports = importRule("No @moku-labs/system, @moku-labs/native or @tauri-apps/* in a game: the engine page wires them.", {
 	files: [
 		...LOGIC,
+		"config.ts",
 		"**/kit.ts",
 		"**/plugins/**"
 	],
 	ignores: [...DEV_MODULES, ...TESTS]
 }, [{
 	pattern: /^(?:@moku-labs\/(?:system|native)(?:\/|$)|@tauri-apps\/)/,
-	message: "L13: a native package is imported only where the platform is wired: platform-bridge.ts, native.ts or web/. Pass a PlatformProvider."
+	message: "L13: a game imports no native package. Name the capability in config.ts system; the engine page wires it."
 }]);
 /** Dev only: the editor and the control door stay in dev files. */
 const developmentImports = importRule("@moku-labs/editor and @moku-labs/game/control only in dev files and tests.", {
 	files: ["**"],
 	ignores: [
+		".moku/**",
 		"web/main.ts",
 		"web/dev*.ts",
 		"web/editor*.ts",

package/dist/memory-CWlqhS7l.mjs

@@ -0,0 +1,136 @@
+import { t as applyTo } from "./drafts-BawpSaVp.mjs";
+//#region src/plugins/clock/system.ts
+/**
+* Tells whether a handle was produced by this source.
+*
+* @param handle - Handle given back to `clearTimer`.
+* @returns `true` when the handle carries a platform timer.
+* @example
+* ```ts
+* isSystemTimer({ timer: 7 }); // true
+* isSystemTimer(7); // false: a handle of another source is ignored
+* ```
+*/
+function isSystemTimer(handle) {
+	return typeof handle === "object" && handle !== null && "timer" in handle;
+}
+/**
+* Creates the system source: epoch milliseconds from the device clock and real timers.
+*
+* @returns A source reading `Date.now` and scheduling with `setTimeout`.
+*/
+function systemSource() {
+	return {
+		now: () => Date.now(),
+		setTimer: (callback, delayMs) => ({ timer: setTimeout(callback, delayMs) }),
+		clearTimer: (handle) => {
+			if (!isSystemTimer(handle)) return;
+			clearTimeout(handle.timer);
+		}
+	};
+}
+//#endregion
+//#region src/plugins/model/store/providers/memory.ts
+/** Seed of a save built by `saveOf` when the caller does not pin one. */
+const defaultSeed = 1;
+/** The base a patch applies to when the provider was never handed a document. */
+const noDocument = {};
+/**
+* Creates an in-memory provider that keeps what it was committed and records every call.
+* It is the default when a game configures no `playerProvider`, and the double every test uses:
+* `provider.calls` is the whole persistence protocol of one run, in order. The document lives as
+* long as the provider does, so a second app over the same instance reads what the first one
+* wrote, and nothing survives the process.
+*
+* `load()` reads the fixture, or everything committed since; without either, the player is new.
+* `commitDurable()` resolves at once: there is no disk behind it.
+*
+* @param fixture - The save `load()` starts from. Omitted: a new player.
+* @param fixture.state - The saved document.
+* @param fixture.version - Schema version of the saved document.
+* @returns A provider that keeps its document and records its calls.
+* @example
+* ```ts
+* // A new player is saved at once. One roll reaches the provider at the next rest node.
+* const provider = memory();
+* const game = await createHeadless(createGame(provider));
+*
+* await game.walk([{ at: "home", intent: "roll" }]);
+* provider.calls.map(call => call.method); // ["load", "commit", "commit"]
+* ```
+*/
+function memory(fixture) {
+	const calls = [];
+	const held = {
+		document: fixture?.state,
+		version: fixture?.version ?? 0
+	};
+	/**
+	* Applies the patches of one commit to the held document.
+	*
+	* @param patches - Doc patches since the last commit.
+	* @param version - Schema version this build writes.
+	* @throws {Error} When a patch names a path the held document does not have.
+	*/
+	const hold = (patches, version) => {
+		held.document = applyTo(held.document ?? noDocument, patches);
+		held.version = version;
+	};
+	return {
+		calls,
+		load: async () => {
+			calls.push({ method: "load" });
+			const document = held.document;
+			if (document === void 0) return null;
+			return {
+				state: document,
+				version: held.version
+			};
+		},
+		commit: (patches, version) => {
+			calls.push({
+				method: "commit",
+				patches,
+				version
+			});
+			hold(patches, version);
+		},
+		commitDurable: async (patches, txId, version) => {
+			calls.push({
+				method: "commitDurable",
+				patches,
+				txId,
+				version
+			});
+			hold(patches, version);
+		},
+		flush: async () => {
+			calls.push({ method: "flush" });
+		}
+	};
+}
+/**
+* Builds a save document from a player tree, with no rng streams drawn yet.
+* Short fixtures in tests read as `saveOf({ coins: 5 })` instead of spelling out the rng branch.
+*
+* @param player - Player tree of the save.
+* @param seed - Rng seed of the save.
+* @returns The save document.
+* @example
+* ```ts
+* // A returning player with 5 coins. The test starts from this save, not from `initialPlayer`.
+* saveOf({ coins: 5 }, 42); // { player: { coins: 5 }, rng: { seed: 42, streams: {} } }
+* const provider = memory({ state: saveOf({ coins: 5 }, 42), version: 1 });
+* ```
+*/
+function saveOf(player, seed = defaultSeed) {
+	return {
+		player,
+		rng: {
+			seed,
+			streams: {}
+		}
+	};
+}
+//#endregion
+export { saveOf as n, systemSource as r, memory as t };

package/dist/memory-DwDhfFWK.d.mts

@@ -0,0 +1,50 @@
+import { Xt as Json, nn as ProviderCall, rn as SaveDoc, tn as PlayerStateProvider } from "./types-ZQLYXo5X.mjs";
+
+//#region src/plugins/model/store/providers/memory.d.ts
+/**
+ * Creates an in-memory provider that keeps what it was committed and records every call.
+ * It is the default when a game configures no `playerProvider`, and the double every test uses:
+ * `provider.calls` is the whole persistence protocol of one run, in order. The document lives as
+ * long as the provider does, so a second app over the same instance reads what the first one
+ * wrote, and nothing survives the process.
+ *
+ * `load()` reads the fixture, or everything committed since; without either, the player is new.
+ * `commitDurable()` resolves at once: there is no disk behind it.
+ *
+ * @param fixture - The save `load()` starts from. Omitted: a new player.
+ * @param fixture.state - The saved document.
+ * @param fixture.version - Schema version of the saved document.
+ * @returns A provider that keeps its document and records its calls.
+ * @example
+ * ```ts
+ * // A new player is saved at once. One roll reaches the provider at the next rest node.
+ * const provider = memory();
+ * const game = await createHeadless(createGame(provider));
+ *
+ * await game.walk([{ at: "home", intent: "roll" }]);
+ * provider.calls.map(call => call.method); // ["load", "commit", "commit"]
+ * ```
+ */
+declare function memory(fixture?: {
+  state: SaveDoc;
+  version: number;
+}): PlayerStateProvider & {
+  calls: ProviderCall[];
+};
+/**
+ * Builds a save document from a player tree, with no rng streams drawn yet.
+ * Short fixtures in tests read as `saveOf({ coins: 5 })` instead of spelling out the rng branch.
+ *
+ * @param player - Player tree of the save.
+ * @param seed - Rng seed of the save.
+ * @returns The save document.
+ * @example
+ * ```ts
+ * // A returning player with 5 coins. The test starts from this save, not from `initialPlayer`.
+ * saveOf({ coins: 5 }, 42); // { player: { coins: 5 }, rng: { seed: 42, streams: {} } }
+ * const provider = memory({ state: saveOf({ coins: 5 }, 42), version: 1 });
+ * ```
+ */
+declare function saveOf(player: Json, seed?: number): SaveDoc;
+//#endregion
+export { saveOf as n, memory as t };

package/dist/project.mjs

@@ -1,8 +1,8 @@
-import { createBrandConsole } from "@moku-labs/common/cli";
-import { readFile, readdir, realpath, stat } from "node:fs/promises";
+import { watch } from "node:fs";
 import path from "node:path";
+import { createBrandConsole } from "@moku-labs/common/cli";
 import { createHash } from "node:crypto";
-import { watch } from "node:fs";
+import { readFile, readdir, realpath, stat } from "node:fs/promises";
 //#region src/project/extract/scope.ts
 /**
 * Unwraps the expressions that change no value: parentheses, `as`, `satisfies`, `!` and `<T>`.

package/dist/{run-CofJEdYx.mjs → run-wYty_Lwo.mjs}

@@ -1,7 +1,7 @@
 import { a as sheetAlone } from "./capture-fpd83Mi5.mjs";
-import { n as isDev, r as notInstalled, t as controlRefused } from "./dev-wKLgOw7c.mjs";
+import { n as isDev, r as notInstalled, t as controlRefused } from "./dev-Cc50Dk7H.mjs";
 import { n as reproBookmark } from "./headless-BsNdJs9W.mjs";
-import { a as isProjectionTarget, i as recordCheat, o as readTarget, r as isTainted, s as defineCommand, t as inputOrEmpty } from "./input-z_35Jwfn.mjs";
+import { a as readTarget, i as isProjectionTarget, n as isTainted, o as inputOrEmpty, r as recordCheat, s as defineCommand } from "./session-DgukhR_7.mjs";
 //#region src/plugins/anim/control.ts
 /**
 * @file anim plugin — the anim command of the `/control` door: switch reduced motion. Dev builds

package/dist/{runtime-CdNJ0UBm.d.mts → runtime-DOBYM6g4.d.mts}

@@ -1,4 +1,4 @@
-import { a as JsxChild, m as UiIntrinsicElements, t as DescriptionNode } from "./types-xXfyk56Q.mjs";
+import { a as JsxChild, m as UiIntrinsicElements, t as DescriptionNode } from "./types-BUwDHKXm.mjs";
 
 //#region src/plugins/ui/jsx/runtime.d.ts
 /** What the compiler passes as props: the children plus whatever the tag declared. */

package/dist/{input-z_35Jwfn.mjs → session-DgukhR_7.mjs}

@@ -67,6 +67,25 @@ function defineCommand(command) {
 	return Object.freeze(command);
 }
 //#endregion
+//#region src/plugins/flow/doors/input.ts
+/** The input of a call that passed none. */
+const noInput = Object.freeze({});
+/**
+* Hands the given input on, or an empty one. `InputArguments` and `WatchInput` let a call leave
+* the input out only when every field of the schema is optional, so `{}` is an input of that
+* schema.
+*
+* @param input - The input of the call, if any.
+* @returns The input to pass to the descriptor.
+* @example
+* ```ts
+* inputOrEmpty<{ last: "number?" }>(undefined); // {}
+* ```
+*/
+function inputOrEmpty(input) {
+	return input ?? noInput;
+}
+//#endregion
 //#region src/plugins/input/target.ts
 /**
 * Tells whether the JSON a command got names a view by its projection key.
@@ -152,23 +171,4 @@ function recordCheat(app, id, input, frame) {
 	sessions.set(app, session);
 }
 //#endregion
-//#region src/plugins/flow/doors/input.ts
-/** The input of a call that passed none. */
-const noInput = Object.freeze({});
-/**
-* Hands the given input on, or an empty one. `InputArguments` and `WatchInput` let a call leave
-* the input out only when every field of the schema is optional, so `{}` is an input of that
-* schema.
-*
-* @param input - The input of the call, if any.
-* @returns The input to pass to the descriptor.
-* @example
-* ```ts
-* inputOrEmpty<{ last: "number?" }>(undefined); // {}
-* ```
-*/
-function inputOrEmpty(input) {
-	return input ?? noInput;
-}
-//#endregion
-export { isProjectionTarget as a, defineSource as c, recordCheat as i, cheatsOf as n, readTarget as o, isTainted as r, defineCommand as s, inputOrEmpty as t };
+export { readTarget as a, defineSource as c, isProjectionTarget as i, isTainted as n, inputOrEmpty as o, recordCheat as r, defineCommand as s, cheatsOf as t };

package/dist/{sources-DNnzyCYf.mjs → sources-Duzj6lhV.mjs}

@@ -1,6 +1,6 @@
 import { i as scaleByFits, w as Layer } from "./visual-dMW8iqAE.mjs";
-import { r as notInstalled } from "./dev-wKLgOw7c.mjs";
-import { c as defineSource, n as cheatsOf, o as readTarget, r as isTainted, t as inputOrEmpty } from "./input-z_35Jwfn.mjs";
+import { r as notInstalled } from "./dev-Cc50Dk7H.mjs";
+import { a as readTarget, c as defineSource, n as isTainted, o as inputOrEmpty, t as cheatsOf } from "./session-DgukhR_7.mjs";
 //#region src/plugins/flow/doors/read.ts
 /**
 * @file flow/doors — `read` and `watch`, the `/inspect` side. Neither changes the game.