@moku-labs/game 0.9.0 → 0.11.0

package/dist/{commands-DuwCxK5t.d.mts → commands-C4QlqijJ.d.mts}

@@ -1,8 +1,8 @@
-import { At as FlowState, C as Captured, Dt as Bookmark, T as DebugSwitches, Ut as Time, k as Api$2, m as Api$1, sn as Api } from "./types-B0v5VVa3.mjs";
-import { t as HeadlessApp } from "./headless-SCQXJxQf.mjs";
-import { n as Command, r as ControlApp } from "./types-DUMoYPYe.mjs";
-import { H as InputApi } from "./types-xXfyk56Q.mjs";
-import { b as AnimApi, p as ScenesApi, t as AudioApi, v as UiApi } from "./types-VZVWwqCg.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-ZQLYXo5X.mjs";
+import { a as AudioApi, r as UiApi, v as ScenesApi, x as AnimApi } from "./types-BM4shh8K.mjs";
+import { A as InputApi } from "./types-BUwDHKXm.mjs";
+import { t as HeadlessApp } from "./headless-G4nuZ-xz.mjs";
+import { n as Command, r as ControlApp } from "./types-DAdwEJMp.mjs";
 
 //#region src/plugins/flow/doors/commands.d.ts
 /**

package/dist/config-CdARrrhU.mjs

@@ -0,0 +1,81 @@
+//#region src/app/config.ts
+/**
+* The save kinds a config may name.
+*
+* @returns The set of save kinds.
+* @example
+* ```ts
+* saveKinds().has("disk"); // false
+* ```
+*/
+function saveKinds() {
+	return /* @__PURE__ */ new Set([
+		"memory",
+		"local",
+		"store"
+	]);
+}
+/**
+* The system plugins the game shell wires, by their `@moku-labs/system` names.
+*
+* @returns The set of system names.
+* @example
+* ```ts
+* systemNames().has("keepAwake"); // true
+* systemNames().has("tray"); // false
+* ```
+*/
+function systemNames() {
+	return /* @__PURE__ */ new Set([
+		"lifecycle",
+		"back",
+		"haptics",
+		"keepAwake",
+		"store"
+	]);
+}
+/**
+* Throws for the first value of a config that TypeScript would have refused.
+*
+* @param config - The default export of `config.ts`.
+* @throws {Error} When `save` is not a save kind, a `system` name is not wired, or the title is empty.
+*/
+function checkConfig(config) {
+	if (config.save !== void 0 && !saveKinds().has(config.save)) throw new Error(`[game] config.save is "${config.save}".\n  Use "memory", "local" or "store".`);
+	const wired = systemNames();
+	const unwired = config.system?.find((name) => !wired.has(name));
+	if (unwired !== void 0) throw new Error(`[game] config.system names "${unwired}", which the game shell does not wire.\n  Use lifecycle, back, haptics, keepAwake or store.`);
+	if (config.page.title.trim() === "") throw new Error("[game] config.page.title is empty.\n  Give the page a title in config.ts.");
+}
+/**
+* Fills every default of a game's `config.ts`: `lang` `"en"`, `background` `"#000000"`,
+* `orientation` `"portrait"`, no icons, no head tags, no system plugin, the memory save, no asset
+* layers.
+*
+* @param config - The default export of `config.ts`.
+* @returns The config with every field set.
+* @throws {Error} When `save` is not a save kind, a `system` name is not wired, or the title is empty.
+* @example
+* ```ts
+* resolveConfig({ page: { title: "T" } }).save; // "memory"
+* ```
+*/
+function resolveConfig(config) {
+	checkConfig(config);
+	return {
+		page: {
+			title: config.page.title,
+			lang: config.page.lang ?? "en",
+			background: config.page.background ?? "#000000",
+			orientation: config.page.orientation ?? "portrait",
+			icons: config.page.icons ?? {},
+			head: config.page.head ?? []
+		},
+		native: config.native,
+		system: config.system ?? [],
+		save: config.save ?? "memory",
+		assets: { layers: config.assets?.layers ?? {} }
+	};
+}
+//#endregion
+export { resolveConfig as t };

package/dist/control.d.mts

@@ -1,13 +1,14 @@
-import { t as HeadlessApp } from "./headless-SCQXJxQf.mjs";
-import { i as InputArguments, n as Command, o as InputSchema, s as Ran } from "./types-DUMoYPYe.mjs";
-import { t as commands } from "./commands-DuwCxK5t.mjs";
-import { t as defineCommand } from "./define-B6pHpdBi.mjs";
+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-C4QlqijJ.mjs";
+import { t as defineCommand } from "./define-CCc0ozKe.mjs";
 
 //#region src/plugins/flow/doors/dev.d.ts
 /**
  * @file flow/doors — the dev flag and the errors a door throws. `__MOKU_GAME_DEV__` is a global
- * the engine never replaces: a game's dev build defines it `true` (bundler `define`) or sets
- * `globalThis.__MOKU_GAME_DEV__` before the engine runs; undefined means a production build.
+ * the engine never replaces: `moku-game dev` defines it `true` (bunfig `define`) and sets
+ * `globalThis.__MOKU_GAME_DEV__` in `.moku/dev.ts` before the engine runs; `moku-game build`
+ * defines it `false`; undefined means a production build.
  *
  * Bun does not inline `isDev()` across modules (checked on Bun 1.3.14), so a branch that must
  * vanish from a production bundle writes the guard inline:
@@ -16,12 +17,12 @@ import { t as defineCommand } from "./define-B6pHpdBi.mjs";
  */
 declare global {
   /**
-   * The dev flag of a game. A game never re-declares it: it defines it in the bundler, or sets
-   * `globalThis.__MOKU_GAME_DEV__ = true` in its dev entry.
+   * The dev flag of a game. A game never re-declares it: `moku-game dev` sets it, `moku-game
+   * build` defines it `false`, and a test stubs it.
    *
    * @example
    * ```ts
-   * // web/dev.ts, imported first by the dev page: /control commands run from here on.
+   * // .moku/dev.ts, written by moku-game dev, the first import of the dev page: /control commands run from here on.
    * globalThis.__MOKU_GAME_DEV__ = true;
    * ```
    */
@@ -33,7 +34,7 @@ declare global {
  * @returns True only when `__MOKU_GAME_DEV__` is exactly `true`.
  * @example
  * ```ts
- * // The dev page set the flag in web/dev.ts before the engine started.
+ * // The dev page set the flag in .moku/dev.ts before the engine started.
  * globalThis.__MOKU_GAME_DEV__ = true;
  * isDev(); // true
  * ```

package/dist/control.mjs

@@ -1,4 +1,4 @@
-import { t as controlRefused } from "./dev-wKLgOw7c.mjs";
-import { s as defineCommand } from "./input-z_35Jwfn.mjs";
-import { n as commands, t as run } from "./run-CofJEdYx.mjs";
+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";
 export { commands, controlRefused, defineCommand, run };

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

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

package/dist/{dev-wKLgOw7c.mjs → dev-Cc50Dk7H.mjs}

@@ -5,7 +5,7 @@
 * @returns True only when `__MOKU_GAME_DEV__` is exactly `true`.
 * @example
 * ```ts
-* // The dev page set the flag in web/dev.ts before the engine started.
+* // The dev page set the flag in .moku/dev.ts before the engine started.
 * globalThis.__MOKU_GAME_DEV__ = true;
 * isDev(); // true
 * ```

package/dist/drafts-BawpSaVp.mjs

@@ -0,0 +1,156 @@
+import { applyPatches, createDraft, enablePatches, finishDraft } from "immer";
+//#region src/plugins/model/store/drafts.ts
+/** Root order of a commit result, so two commits never report the same roots in another order. */
+const rootOrder = Object.freeze([
+	"player",
+	"session",
+	"rng"
+]);
+/**
+* Turns on Immer's patch recording. Idempotent, and called from the state factory rather than at
+* module scope: a module-scope call would run on import, even when no app is created.
+*
+*/
+function enableDraftPatches() {
+	enablePatches();
+}
+/**
+* Freezes a tree and every branch of it. Immer freezes what it produces; this covers the trees
+* that never went through a draft — the initial trees and the ones handed to `restore()`.
+*
+* @param tree - The tree to freeze, in place.
+* @returns The same reference, now frozen.
+* @example
+* ```ts
+* const tree = deepFreeze({ player: { bag: ["key"] } });
+* Object.isFrozen(tree.player.bag); // true
+* ```
+*/
+function deepFreeze(tree) {
+	if (!tree || typeof tree !== "object") return tree;
+	for (const branch of Object.values(tree)) deepFreeze(branch);
+	return Object.freeze(tree);
+}
+/**
+* Maps one Immer patch to our own structural patch, so no Immer type reaches a public type.
+* A removal carries no value, and `exactOptionalPropertyTypes` forbids an explicit `undefined`.
+*
+* @param patch - The Immer patch.
+* @param path - Path of the patch inside its own tree, without the container segment.
+* @returns The structural patch.
+* @example
+* ```ts
+* toPatch({ op: "remove", path: ["doc", "player", "key"] }, ["player", "key"]);
+* // { op: "remove", path: ["player", "key"] }
+* ```
+*/
+function toPatch(patch, path) {
+	if (patch.op === "remove") return {
+		op: patch.op,
+		path
+	};
+	return {
+		op: patch.op,
+		path,
+		value: patch.value
+	};
+}
+/**
+* Derives the touched roots from the patches of one commit, in a fixed order.
+*
+* @param docPatches - Patches of the save document.
+* @param sessionPatches - Patches of the session tree.
+* @returns The roots a listener has to reconcile.
+* @example
+* ```ts
+* rootsOf([{ op: "add", path: ["rng", "streams", "dice"], value: 7 }], []); // ["rng"]
+* rootsOf([], [{ op: "replace", path: ["rolls"], value: 1 }]); // ["session"]
+* ```
+*/
+function rootsOf(docPatches, sessionPatches) {
+	const touched = /* @__PURE__ */ new Set();
+	for (const patch of docPatches) {
+		const [head] = patch.path;
+		if (head === "player" || head === "rng") touched.add(head);
+	}
+	if (sessionPatches.length > 0) touched.add("session");
+	return rootOrder.filter((root) => touched.has(root));
+}
+/**
+* Opens mutable drafts of the frozen save document and session tree.
+* Both live in one draft container, so one `finishDraft` closes the transaction and the patches
+* arrive in one list, tagged by their container key.
+*
+* @param doc - Frozen save document.
+* @param session - Frozen session tree.
+* @returns The open drafts of one transaction.
+* @example
+* ```ts
+* const pair = openDrafts({ player: { coins: 1 }, rng: { seed: 7, streams: {} } }, { rolls: 0 });
+* pair.session; // a mutable draft of { rolls: 0 }: a write never reaches the frozen input
+* ```
+*/
+function openDrafts(doc, session) {
+	return createDraft({
+		doc,
+		session
+	});
+}
+/**
+* Finishes the drafts: the new frozen trees, the patches per tree and the touched roots.
+* The drafts are revoked, so a draft that leaked into a view throws on the next touch instead of
+* corrupting the committed tree in silence.
+*
+* @param pair - Open drafts of one transaction.
+* @returns The frozen trees, the patches split by tree, and the touched roots.
+*/
+function finishDrafts(pair) {
+	const collected = [];
+	const finished = finishDraft(pair, (patches) => {
+		collected.push(...patches);
+	});
+	const docPatches = [];
+	const sessionPatches = [];
+	for (const patch of collected) {
+		const [container, ...path] = patch.path;
+		(container === "doc" ? docPatches : sessionPatches).push(toPatch(patch, path));
+	}
+	return {
+		doc: finished.doc,
+		session: finished.session,
+		patches: {
+			doc: docPatches,
+			session: sessionPatches
+		},
+		roots: rootsOf(docPatches, sessionPatches)
+	};
+}
+/**
+* Applies the patches of one commit to a document, the way a save seam stores what it was handed.
+* A whole-document patch carries the path `[]` and replaces the document. The input is left as it
+* is: the result is a new frozen document.
+*
+* @param document - The document the patches apply to.
+* @param patches - The patches of one commit, in order.
+* @returns The document after the patches.
+* @throws {Error} When a patch names a path the document does not have.
+* @example
+* ```ts
+* applyTo({ player: { coins: 0 } }, [{ op: "replace", path: ["player", "coins"], value: 4 }]);
+* // { player: { coins: 4 } }
+* ```
+*/
+function applyTo(document, patches) {
+	enablePatches();
+	return applyPatches(document, patches);
+}
+/**
+* Drops the drafts without a result: the base trees stay as they are and the drafts are revoked.
+*
+* @param pair - Open drafts of one transaction.
+*/
+function dropDrafts(pair) {
+	finishDraft(pair);
+}
+//#endregion
+export { finishDrafts as a, enableDraftPatches as i, deepFreeze as n, openDrafts as o, dropDrafts as r, applyTo as t };

package/dist/fake-MpzwZhIZ.mjs

@@ -0,0 +1,87 @@
+//#region src/plugins/clock/fake.ts
+/**
+* Removes and returns the timer that is due first, up to and including `until`.
+* Timers due at the same moment come out in the order they were scheduled.
+*
+* @param state - Innards of the fake clock.
+* @param until - Latest moment that counts as due.
+* @returns The timer to fire, or `undefined` when nothing is due.
+*/
+function takeDue(state, until) {
+	let earliest;
+	for (const timer of state.timers) {
+		if (timer.at > until) continue;
+		if (earliest === void 0 || timer.at < earliest.at) earliest = timer;
+	}
+	if (earliest === void 0) return void 0;
+	const due = earliest;
+	state.timers = state.timers.filter((timer) => timer !== due);
+	return due;
+}
+/**
+* Moves the clock to `until`, firing every timer that falls due on the way, in due order.
+* A timer scheduled inside a callback fires in the same run when it is due before `until`.
+*
+* @param state - Innards of the fake clock.
+* @param until - Moment to stop at.
+*/
+function runDue(state, until) {
+	let due = takeDue(state, until);
+	while (due !== void 0) {
+		state.now = Math.max(state.now, due.at);
+		due.callback();
+		due = takeDue(state, until);
+	}
+	state.now = Math.max(state.now, until);
+}
+/**
+* Creates a fake source for tests. Timers fire synchronously inside `advance`, in due order. A
+* negative delay counts as zero and an unknown handle is ignored.
+*
+* @param start - Starting moment in epoch milliseconds. Defaults to 0.
+* @returns A clock source with the test-only controls `advance` and `set`.
+* @example
+* ```ts
+* // An energy point refills 60 s after it was spent. The test moves the clock, not the minute.
+* const clock = fakeClock(1000);
+* const app = createApp({ pluginConfigs: { clock: { source: clock } } });
+* const seen: number[] = [];
+*
+* app.clock.onElapsed(({ now }) => seen.push(now));
+* app.clock.scheduleAt(61_000);
+* clock.advance(60_000); // the timer fires inside advance, nothing waits
+* seen; // [61000]
+* ```
+*/
+function fakeClock(start = 0) {
+	const state = {
+		now: start,
+		nextId: 1,
+		timers: []
+	};
+	return {
+		now: () => state.now,
+		setTimer: (callback, delayMs) => {
+			const id = state.nextId;
+			state.nextId += 1;
+			state.timers.push({
+				id,
+				at: state.now + Math.max(0, delayMs),
+				callback
+			});
+			return id;
+		},
+		clearTimer: (handle) => {
+			if (typeof handle !== "number") return;
+			state.timers = state.timers.filter((timer) => timer.id !== handle);
+		},
+		advance: (ms) => {
+			runDue(state, state.now + Math.max(0, ms));
+		},
+		set: (moment) => {
+			state.now = moment;
+		}
+	};
+}
+//#endregion
+export { fakeClock as t };

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

@@ -1,4 +1,4 @@
-import { At as FlowState, Bt as Api, Jt as Json, Nt as RouteStep, jt as JournalEntry, on as RngState, ut as Api$1, zt as Answer } from "./types-B0v5VVa3.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-ZQLYXo5X.mjs";
 
 //#region src/plugins/flow/headless.d.ts
 /**

package/dist/hot.d.mts

@@ -72,16 +72,14 @@ type HotPlugin = {
  * @returns The Bun plugin object.
  * @example
  * ```ts
- * // bunfig.toml of a game with the default layout:
- * //   [serve.static]
- * //   plugins = ["@moku-labs/game/hot"]
- * // A game that keeps its views in `look/` folders exports its own plugin from `hot.ts`
- * // and lists `plugins = ["./hot.ts"]` instead:
+ * // `moku-game dev` lists the default plugin in `.moku/bunfig.toml`: a game sets nothing.
+ * // A game with a server of its own and its views in `look/` folders exports its own plugin
+ * // from `hot.ts` and lists `plugins = ["./hot.ts"]` in its own bunfig.toml:
  * export default hot({ include: /\/look\/.*\.ts$/ });
  * ```
  */
 declare function hot(options?: HotOptions): HotPlugin;
-/** The Bun plugin with the default filters, for `plugins = ["@moku-labs/game/hot"]` in `bunfig.toml`. */
+/** The Bun plugin with the default filters: the one `moku-game dev` lists, or `plugins = ["@moku-labs/game/hot"]` in a game's own `bunfig.toml`. */
 declare const _default: HotPlugin;
 //#endregion
 export { HotBuild, HotOptions, HotPlugin, _default as default, hot };

package/dist/hot.mjs

@@ -1,5 +1,5 @@
-import { readFile } from "node:fs/promises";
 import path from "node:path";
+import { readFile } from "node:fs/promises";
 //#region src/hot.ts
 /**
 * @file Hot entry (subpath `./hot`): the Bun plugin of the dev server that hot swaps the views of
@@ -11,8 +11,9 @@ import path from "node:path";
 * `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. The plugin lives in `[serve.static]` of
-* `bunfig.toml`, the dev server only: `Bun.build` of a production build never loads it.
+* 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
@@ -73,11 +74,9 @@ function footerOf(file) {
 * @returns The Bun plugin object.
 * @example
 * ```ts
-* // bunfig.toml of a game with the default layout:
-* //   [serve.static]
-* //   plugins = ["@moku-labs/game/hot"]
-* // A game that keeps its views in `look/` folders exports its own plugin from `hot.ts`
-* // and lists `plugins = ["./hot.ts"]` instead:
+* // `moku-game dev` lists the default plugin in `.moku/bunfig.toml`: a game sets nothing.
+* // A game with a server of its own and its views in `look/` folders exports its own plugin
+* // from `hot.ts` and lists `plugins = ["./hot.ts"]` in its own bunfig.toml:
 * export default hot({ include: /\/look\/.*\.ts$/ });
 * ```
 */
@@ -104,7 +103,7 @@ function hot(options = {}) {
 		}
 	};
 }
-/** The Bun plugin with the default filters, for `plugins = ["@moku-labs/game/hot"]` in `bunfig.toml`. */
+/** The Bun plugin with the default filters: the one `moku-game dev` lists, or `plugins = ["@moku-labs/game/hot"]` in a game's own `bunfig.toml`. */
 var hot_default = hot();
 //#endregion
 export { hot_default as default, hot };

package/dist/{index-BO9kZzY3.d.mts → index-8TiJQjQA.d.mts}

@@ -1,7 +1,7 @@
-import { $ as Ease, A as Config$8, B as ComponentValue, Bt as Api$5, G as Narrowed, Ht as State$7, It as Descriptor, J as ResourceType, Jt as Json, Kt as Config$5, L as ComponentHandle, Lt as GuideOptions, M as State$8, O as ViewportSize, Ot as DefineNode, Pt as SceneIdOf, Q as DescriptionNode, Qt as Patch, Rt as Hint, Tt as FeatureDescription, Vt as Config$7, W as Mut, X as TagType, Xt as State$5, Y as SystemDefinition, Yt as Root, _n as State$2, _t as State$3, a as DefineBundles, an as RngApi, at as ProjectionMotion, b as State$6, bn as Events$1, bt as defineFlow, c as LoadReason, cn as Config$4, d as Tier, dn as State$4, dt as BundlesOf, ft as Config$3, h as Config$6, hn as Config$2, ht as GameTypes, i as Config$1, in as StoreApi, it as NumericFields, k as Api$6, ln as Events, m as Api$4, mt as FeaturePlugin, n as BundleMap, ot as ProjectionSpec, pn as Api$1, pt as EmitterIdOf, q as QueryTerm, r as BundleSpec, s as LoadBundles, sn as Api$3, t as Api, u as State$1, un as PauseReason, ut as Api$2, vt as TextStylesOf, xn as Require, yn as Config$9, z as ComponentType } from "./types-B0v5VVa3.mjs";
-import { $ as SpriteValue, A as TextStyleInput, C as Config$12, D as TextApi, E as State$11, F as Config$10, H as InputApi, I as I18nApi, L as Message, M as TextValue, O as TextBind, P as Argument, Q as SpriteOptions, R as State$9, S as BindOptions, T as Point, U as State$10, V as Config$11, X as ShapeValue, _ as Style, b as defineComponent, f as defineTokens, g as ResolvedStyle, h as IsFlags, j as TextStyles, nt as sprite, p as IntrinsicElementsFor, q as NineSliceValue, s as PopupComponent, tt as TransformValue, w as CountdownValue, x as BindField, y as WhenFlags, z as TypedTr } from "./types-xXfyk56Q.mjs";
-import { A as Step, C as FramesValue, E as Target, M as defineAnimation, O as HapticKind, R as play, S as Config$13, T as State$12, _ as State$15, b as AnimApi, c as AnySceneProjection, d as SceneDefinition, f as SceneSpec, g as Config$15, i as MusicOptions, k as SfxDescriptor, l as DefineScene, m as State$14, n as Config$14, o as State$13, p as ScenesApi, r as MusicDescriptor, t as AudioApi, u as LayerMap, v as UiApi, w as MotionKeyframe, x as AnimPlayerValue } from "./types-VZVWwqCg.mjs";
-import { _ as NoiseValue, c as EmitterValue, d as ColorMatrixValue, f as DisplacementValue, g as GlowValue, h as FilterValueOf, i as State$16, l as AlphaValue, m as FilterSpec, n as EffectsApi, o as EmitterConfig, p as FilterComponent, s as EmitterDefinition, t as Config$16, u as BlurValue, v as OutlineValue, y as UniformDeclaration } from "./types-CQueODzo.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-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-BM4shh8K.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-CefgYzFt.mjs";
+import { $ as ResolvedStyle, A as InputApi, B as SpriteOptions, E as TextValue, F as NineSliceValue, G as Argument, J as Message, K as Config$14, O as defineComponent, Q as IsFlags, R as ShapeValue, S as TextBind, T as TextStyles, U as TransformValue, V as SpriteValue, W as sprite, X as TypedTr, Y as State$14, _ as Config$16, b as State$16, et as Style, f as defineTokens, g as BindOptions, h as BindField, j as State$15, k as Config$15, nt as WhenFlags, p as IntrinsicElementsFor, q as I18nApi, s as PopupComponent, v as CountdownValue, w as TextStyleInput, x as TextApi, y as Point } from "./types-BUwDHKXm.mjs";
 import { Log } from "@moku-labs/common/browser";
 import { PluginCtx } from "@moku-labs/core";
 
@@ -151,7 +151,7 @@ type ProjectionFor<Player, Session> = <const LayerName extends string, const Lif
  * app.anim.play(coinsFly, { from: purse, to: counter }).marks(); // []: the first frame is next
  * ```
  */
-declare const animPlugin: import("@moku-labs/core").PluginInstance<"anim", Config$13, State$12, AnimApi, {
+declare const animPlugin: import("@moku-labs/core").PluginInstance<"anim", Config$10, State$9, AnimApi, {
   "anim:mark": {
     animation: string;
     mark: string;
@@ -212,7 +212,7 @@ declare const assetsPlugin: import("@moku-labs/core").PluginInstance<"assets", C
  * });
  * ```
  */
-declare const audioPlugin: import("@moku-labs/core").PluginInstance<"audio", Config$14, State$13, AudioApi, {}> & Record<never, never>;
+declare const audioPlugin: import("@moku-labs/core").PluginInstance<"audio", Config$11, State$10, AudioApi, {}> & Record<never, never>;
 //#endregion
 //#region src/plugins/clock/index.d.ts
 /**
@@ -244,7 +244,7 @@ declare const clockPlugin: import("@moku-labs/core").PluginInstance<"clock", Con
  * app.effects.stats(); // { particles: 0, emitters: 0, filters: 0, renderPasses: 0 }: nothing runs before start
  * ```
  */
-declare const effectsPlugin: import("@moku-labs/core").PluginInstance<"effects", Config$16, State$16, EffectsApi, {}> & Record<never, never>;
+declare const effectsPlugin: import("@moku-labs/core").PluginInstance<"effects", Config$13, State$13, EffectsApi, {}> & Record<never, never>;
 //#endregion
 //#region src/plugins/flow/index.d.ts
 /**
@@ -302,7 +302,7 @@ declare const flowPlugin: import("@moku-labs/core").PluginInstance<"flow", Confi
  * await app.i18n.setLocale("en"); // text re-resolves every message on i18n:locale-changed
  * ```
  */
-declare const i18nPlugin: import("@moku-labs/core").PluginInstance<"i18n", Config$10, State$9, I18nApi, {
+declare const i18nPlugin: import("@moku-labs/core").PluginInstance<"i18n", Config$14, State$14, I18nApi, {
   "i18n:locale-changed": {
     locale: string;
   };
@@ -327,7 +327,7 @@ declare const i18nPlugin: import("@moku-labs/core").PluginInstance<"i18n", Confi
  * });
  * ```
  */
-declare const inputPlugin: import("@moku-labs/core").PluginInstance<"input", Config$11, State$10, InputApi, {}> & Record<never, never>;
+declare const inputPlugin: import("@moku-labs/core").PluginInstance<"input", Config$15, State$15, InputApi, {}> & Record<never, never>;
 //#endregion
 //#region src/plugins/lifecycle/index.d.ts
 /**
@@ -476,6 +476,19 @@ type PlatformApi = {
    * ```
    */
   back(): BackResult;
+  /**
+   * Leaves the app through the provider, as the last step of `back()` does: no Escape, no intent
+   * `back`. A provider `exit` that throws is logged, never thrown. Without a provider it does
+   * nothing.
+   *
+   * @example
+   * ```ts
+   * // merge-game's exit plugin answers the fx "exit" of the Leave button.
+   * ctx.require(flowPlugin).fx.handle("exit", () => ctx.require(platformPlugin).exit());
+   * // a press of Leave: the provider leaves the app; on the web page without a provider, nothing
+   * ```
+   */
+  exit(): void;
 };
 /**
  * What the kernel context offers the files of the plugin.
@@ -552,7 +565,7 @@ declare const rendererPlugin: import("@moku-labs/core").PluginInstance<"renderer
  * export const awaitIntent = defineNode({ scene: "board", rest: true, outcomes: { merge: type() } });
  * ```
  */
-declare const scenesPlugin: import("@moku-labs/core").PluginInstance<"scenes", Record<string, never>, State$14, ScenesApi, {
+declare const scenesPlugin: import("@moku-labs/core").PluginInstance<"scenes", Record<string, never>, State$11, ScenesApi, {
   "scenes:changed": {
     from: string | undefined;
     to: string;
@@ -577,7 +590,7 @@ declare const scenesPlugin: import("@moku-labs/core").PluginInstance<"scenes", R
  * app.text.styles(); // ["body", "digits", "hud.digits"]
  * ```
  */
-declare const textPlugin: import("@moku-labs/core").PluginInstance<"text", Config$12, State$11, TextApi, {}> & Record<never, never>;
+declare const textPlugin: import("@moku-labs/core").PluginInstance<"text", Config$16, State$16, TextApi, {}> & Record<never, never>;
 //#endregion
 //#region src/plugins/time/index.d.ts
 /**
@@ -609,7 +622,7 @@ declare const timePlugin: import("@moku-labs/core").PluginInstance<"time", Confi
  * app.input.tap(app.ui.find("claim") ?? 0);
  * ```
  */
-declare const uiPlugin: import("@moku-labs/core").PluginInstance<"ui", Config$15, State$15, UiApi, {}> & Record<never, never>;
+declare const uiPlugin: import("@moku-labs/core").PluginInstance<"ui", Config$12, State$12, UiApi, {}> & Record<never, never>;
 //#endregion
 //#region src/plugins/world/index.d.ts
 /**
@@ -1569,7 +1582,7 @@ declare const screen: readonly [import("@moku-labs/core").PluginInstance<"world"
     kind: "webgpu" | "webgl";
     reason: string;
   };
-}> & Record<never, never>, import("@moku-labs/core").PluginInstance<"input", Config$11, State$10, InputApi, {}> & Record<never, never>, import("@moku-labs/core").PluginInstance<"assets", Config$1, State$1, Api, {
+}> & Record<never, never>, import("@moku-labs/core").PluginInstance<"input", Config$15, State$15, InputApi, {}> & Record<never, never>, import("@moku-labs/core").PluginInstance<"assets", Config$1, State$1, Api, {
   "assets:bundle-loaded": {
     bundle: string;
     tier: Tier;
@@ -1588,13 +1601,13 @@ declare const screen: readonly [import("@moku-labs/core").PluginInstance<"world"
     reason: "budget" | "request";
     keys: readonly string[];
   };
-}> & Record<never, never>, import("@moku-labs/core").PluginInstance<"scenes", Record<string, never>, State$14, ScenesApi, {
+}> & Record<never, never>, import("@moku-labs/core").PluginInstance<"scenes", Record<string, never>, State$11, ScenesApi, {
   "scenes:changed": {
     from: string | undefined;
     to: string;
     music: string | undefined;
   };
-}> & Record<never, never>, import("@moku-labs/core").PluginInstance<"anim", Config$13, State$12, AnimApi, {
+}> & Record<never, never>, import("@moku-labs/core").PluginInstance<"anim", Config$10, State$9, AnimApi, {
   "anim:mark": {
     animation: string;
     mark: string;
@@ -1602,10 +1615,10 @@ declare const screen: readonly [import("@moku-labs/core").PluginInstance<"world"
   "anim:finished": {
     animation: string;
   };
-}> & Record<never, never>, import("@moku-labs/core").PluginInstance<"i18n", Config$10, State$9, I18nApi, {
+}> & Record<never, never>, import("@moku-labs/core").PluginInstance<"i18n", Config$14, State$14, I18nApi, {
   "i18n:locale-changed": {
     locale: string;
   };
-}> & Record<never, never>, import("@moku-labs/core").PluginInstance<"text", Config$12, State$11, TextApi, {}> & Record<never, never>, import("@moku-labs/core").PluginInstance<"ui", Config$15, State$15, UiApi, {}> & Record<never, never>];
+}> & Record<never, never>, import("@moku-labs/core").PluginInstance<"text", Config$16, State$16, TextApi, {}> & Record<never, never>, import("@moku-labs/core").PluginInstance<"ui", Config$12, State$12, UiApi, {}> & Record<never, never>];
 //#endregion
 export { uiPlugin as $, Pointer as A, Layer as B, defineScene as C, label as Ct, DropTarget as D, Draggable as E, Tappable as F, resource as G, Tree as H, Touchable as I, guide as J, system as K, Traceable as L, Pressable as M, Pressed as N, Held as O, Swipeable as P, worldPlugin as Q, Traced as R, Frames as S, defineTextStyles as St, load as T, component as U, Order as V, mut as W, schedule as X, hint as Y, defineFeature as Z, defineStyle as _, animPlugin as _t, defineEmitter as a, BackResult as at, AnimPlayer as b, Text as bt, Alpha as c, modelPlugin as ct, Displacement as d, i18nPlugin as dt, timePlugin as et, Glow as f, flowPlugin as ft, resolve as g, assetsPlugin as gt, music as h, audioPlugin as ht, screen as i, platformPlugin as it, PointerOver as j, Hovered as k, Blur as l, lifecyclePlugin as lt, Outline as m, clockPlugin as mt, createPlugin as n, scenesPlugin as nt, Emitter as o, PlatformProvider as ot, Noise as p, effectsPlugin as pt, tag as q, defineGame as r, rendererPlugin as rt, defineFilter as s, types_d_exports as st, createApp as t, textPlugin as tt, ColorMatrix as u, inputPlugin as ut, tr as v, projection as vt, defineBundles as w, Animation as x, bind as xt, defineMotion as y, Countdown as yt, Exiting as z };