@moku-labs/game 0.2.0 → 0.3.0

package/dist/flatten-BkXuscAV.mjs

@@ -0,0 +1,100 @@
+//#region src/plugins/ui/jsx/component.ts
+/** The local state a component that declares none starts every instance with. */
+const noLocal = {};
+/**
+* Tells a component definition from a plain function component, which JSX calls at build time.
+*
+* @param type - What stood in the tag position.
+* @returns True when `defineComponent` built it.
+* @example
+* ```ts
+* isComponentDefinition(() => ({ type: "row", props: {}, children: [] })); // false
+* ```
+*/
+function isComponentDefinition(type) {
+	return typeof type === "function" && type.isUiComponent === true;
+}
+/**
+* The one implementation behind the two overloads.
+*
+* @param name - Component name.
+* @param spec - What the game declared.
+* @returns The callable definition.
+*/
+function defineComponent(name, spec) {
+	const local = spec.local ?? noLocal;
+	const call = (props) => ({
+		type: name,
+		props,
+		children: []
+	});
+	const definition = Object.assign(call, {
+		outcomes: spec.outcomes,
+		local,
+		view: spec.view,
+		isUiComponent: true
+	});
+	Object.defineProperty(definition, "name", {
+		value: name,
+		configurable: true
+	});
+	return definition;
+}
+//#endregion
+//#region src/plugins/ui/jsx/flatten.ts
+/** The type of the node `Fragment` builds. It never reaches a reconcile: `flatten` lifts it. */
+const FRAGMENT = "#fragment";
+/**
+* Builds the node a bare string or number child becomes.
+*
+* @param content - What stood between the tags.
+* @returns A text node carrying it.
+* @example
+* ```ts
+* textNode(5); // { type: "text", props: { content: "5" }, children: [] }
+* ```
+*/
+function textNode(content) {
+	return {
+		type: "text",
+		props: { content: String(content) },
+		children: []
+	};
+}
+/**
+* Tells a description node from the other things a child may be.
+*
+* @param child - One child of a tag.
+* @returns True when it is a node.
+* @example
+* ```ts
+* isNode({ type: "row", props: {}, children: [] }); // true
+* ```
+*/
+function isNode(child) {
+	return typeof child === "object" && child !== null && !Array.isArray(child) && "type" in child;
+}
+/**
+* Turns whatever stood between two tags into the children of that tag.
+*
+* @param child - One child, an array of children, or nothing.
+* @returns The children as nodes, fragments lifted and empty values dropped.
+* @example
+* ```ts
+* flatten(["a", undefined, 2]).map(node => node.props.content); // ["a", "2"]
+* ```
+*/
+function flatten(child) {
+	if (child === null || child === void 0 || typeof child === "boolean") return [];
+	if (typeof child === "string" || typeof child === "number") return [textNode(child)];
+	if (Array.isArray(child)) {
+		const nodes = [];
+		for (const item of child) nodes.push(...flatten(item));
+		return nodes;
+	}
+	if (!isNode(child)) return [];
+	if (child.type === "#fragment") return [...child.children];
+	return [child];
+}
+//#endregion
+export { isComponentDefinition as i, flatten as n, defineComponent as r, FRAGMENT as t };

package/dist/index.d.mts

@@ -1,8 +1,7 @@
-import { $t as types_d_exports$3, At as Json, B as Mut, Bt as StoreApi, Ct as Config$6, D as ProjectionMotion, E as NumericFields, Et as types_d_exports$14, F as ComponentHandle, G as SystemDefinition, Gt as Events, I as ComponentType, J as BundlesOf, Jt as types_d_exports$8, K as TagType, Kt as PauseReason, L as ComponentValue, Mt as State$4, Nt as types_d_exports$9, O as ProjectionSpec, Ot as Config$4, Pt as Patch, Q as GameTypes, Qt as State$1, Rt as SaveUnreadableError, St as Api$4, U as QueryTerm, Ut as Api$2, V as Narrowed, Vt as RngApi, W as ResourceType, Wt as Config$3, X as EmitterIdOf, Xt as Config$1, Y as Config$2, Yt as Api, Z as FeaturePlugin, _ as State$7, at as slot, b as DescriptionNode, bt as Hint, c as types_d_exports$11, ct as FeatureDescription, en as Config$8, et as State$2, g as Config$7, gt as SceneIdOf, h as Api$5, it as exit, jt as Root, m as ViewportSize, n as Config$5, nn as Require, nt as types_d_exports$5, ot as to, q as Api$1, qt as State$3, rt as defineFlow, s as State$5, st as type, t as Api$3, tn as Events$1, tt as TextStylesOf, ut as DefineNode, v as types_d_exports$16, vt as Descriptor, wt as State$6, x as Ease, yt as GuideOptions } from "./types-BZ1OLf24.mjs";
-import { a as DefineBundles, c as LoadReason, d as Tier, i as Config$9, n as BundleMap, p as types_d_exports$1, r as BundleSpec, s as LoadBundles, t as Api$6, u as State$8 } from "./types-C47fKNcn.mjs";
-import { A as Transform, B as types_d_exports$6, C as NineSliceValue, D as Sprite, E as ShapeValue, H as InputApi, I as I18nApi, L as Message, M as sprite, N as Argument, O as SpriteOptions, P as Config$10, R as State$9, S as NineSlice, T as Shape, U as State$10, V as Config$11, W as types_d_exports$7, _ as Style, b as defineComponent, d as popup, f as defineTokens, g as ResolvedStyle, h as IsFlags, j as TransformValue, k as SpriteValue, l as Box, p as IntrinsicElementsFor, s as PopupComponent, u as LocalWrite, w as Parent, x as Display, y as WhenFlags, z as TypedTr } from "./types-X9jXjka3.mjs";
-import { A as UiApi, C as spawned, D as wait, E as use, F as TextApi, I as TextStyleInput, L as TextStyles, M as Config$13, N as Point, O as Config$14, P as State$12, R as TextValue, S as spawn, T as tween, _ as parallel, a as State$11, b as set, c as HapticKind, d as HAPTIC_KINDS, f as defineAnimation, g as mark, h as haptic, i as MotionKeyframe, j as types_d_exports$15, k as State$13, l as SfxDescriptor, m as frames, n as Config$12, o as Target, p as external, r as FramesValue, s as types_d_exports, t as AnimApi, u as Step, v as play, w as stagger, x as sfx, y as sequence, z as types_d_exports$13 } from "./types-CqkrEY06.mjs";
-import { A as FilterValueOf, C as EmitterValue, D as DisplacementValue, E as ColorMatrixValue, M as NoiseValue, N as OutlineValue, O as FilterComponent, P as UniformDeclaration, S as EmitterDefinition, T as BlurValue, _ as EffectsApi, b as types_d_exports$4, c as AnySceneProjection, d as SceneDefinition, f as SceneSpec, g as Config$16, h as types_d_exports$12, i as MusicOptions, j as GlowValue, k as FilterSpec, l as DefineScene, m as State$16, n as Config$15, o as State$14, p as ScenesApi, r as MusicDescriptor, s as types_d_exports$2, t as AudioApi, u as LayerMap, w as AlphaValue, x as EmitterConfig, y as State$15 } from "./types-CxZy7Pi4.mjs";
+import { $ as Ease, A as Config$8, B as ComponentValue, Bt as State$7, Ct as to, Dt as DefineNode, Ft as GuideOptions, G as Narrowed, Ht as types_d_exports$14, It as Hint, J as ResourceType, Jt as State$5, Kt as Json, L as ComponentHandle, M as State$8, Mt as SceneIdOf, N as types_d_exports$16, O as ViewportSize, Pt as Descriptor, Q as DescriptionNode, Rt as Api$5, S as types_d_exports$11, St as slot, Tt as FeatureDescription, W as Mut, Wt as Config$5, X as TagType, Xt as Patch, Y as SystemDefinition, Yt as types_d_exports$9, _n as Events$1, _t as State$3, a as DefineBundles, an as Api$3, at as ProjectionMotion, b as State$6, bt as defineFlow, c as LoadReason, cn as PauseReason, d as Tier, dn as Api$1, dt as BundlesOf, en as SaveUnreadableError, fn as Config$2, ft as Config$3, gn as Config$9, h as Config$6, hn as types_d_exports$3, ht as GameTypes, i as Config$1, it as NumericFields, k as Api$6, ln as State$4, m as Api$4, mn as State$2, mt as FeaturePlugin, n as BundleMap, nn as StoreApi, on as Config$4, ot as ProjectionSpec, p as types_d_exports$1, pt as EmitterIdOf, q as QueryTerm, qt as Root, r as BundleSpec, rn as RngApi, s as LoadBundles, sn as Events, t as Api, u as State$1, un as types_d_exports$8, ut as Api$2, vn as Require, vt as TextStylesOf, wt as type, xt as exit, yt as types_d_exports$5, z as ComponentType, zt as Config$7 } from "./types-Dy1xB68L.mjs";
+import { $ as SpriteValue, A as TextStyleInput, B as types_d_exports$6, C as Config$12, D as TextApi, E as State$11, F as Config$10, G as Display, H as InputApi, I as I18nApi, J as Parent, K as NineSlice, L as Message, M as TextValue, N as types_d_exports$13, 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, W as types_d_exports$7, X as ShapeValue, Y as Shape, Z as Sprite, _ as Style, b as defineComponent, d as popup, et as Transform, f as defineTokens, g as ResolvedStyle, h as IsFlags, j as TextStyles, k as TextFormat, l as Box, nt as sprite, p as IntrinsicElementsFor, q as NineSliceValue, s as PopupComponent, tt as TransformValue, u as LocalWrite, w as CountdownValue, x as BindField, y as WhenFlags, z as TypedTr } from "./types-VErbiEXy.mjs";
+import { A as UiApi, C as spawned, D as wait, E as use, O as Config$14, S as spawn, T as tween, _ as parallel, a as State$12, b as set, c as HapticKind, d as HAPTIC_KINDS, f as defineAnimation, g as mark, h as haptic, i as MotionKeyframe, j as types_d_exports$15, k as State$13, l as SfxDescriptor, m as frames, n as Config$13, o as Target, p as external, r as FramesValue, s as types_d_exports, t as AnimApi, u as Step, v as play, w as stagger, x as sfx, y as sequence } from "./types-CVUHPvMB.mjs";
+import { A as FilterValueOf, C as EmitterValue, D as DisplacementValue, E as ColorMatrixValue, M as NoiseValue, N as OutlineValue, O as FilterComponent, P as UniformDeclaration, S as EmitterDefinition, T as BlurValue, _ as EffectsApi, b as types_d_exports$4, c as AnySceneProjection, d as SceneDefinition, f as SceneSpec, g as Config$16, h as types_d_exports$12, i as MusicOptions, j as GlowValue, k as FilterSpec, l as DefineScene, m as State$16, n as Config$15, o as State$14, p as ScenesApi, r as MusicDescriptor, s as types_d_exports$2, t as AudioApi, u as LayerMap, w as AlphaValue, x as EmitterConfig, y as State$15 } from "./types-BnWH-75b.mjs";
 import { Log } from "@moku-labs/common/browser";
 import { PluginCtx } from "@moku-labs/core";
 
@@ -14,6 +13,45 @@ import { PluginCtx } from "@moku-labs/core";
  * is patched in place, so a tween on it rebuilds nothing.
  */
 declare const Text: ComponentType<TextValue>;
+/**
+ * Shows a numeric component field of the label's own entity: read every frame, written to
+ * `Text.resolved` only when the shown string changes. The field must hold a number; the format
+ * is `"int"` (rounded) unless named. Reads the component's own name, so a renamed component
+ * cannot drift from its label.
+ *
+ * @param component - The component whose field the label shows.
+ * @param field - A numeric field of that component.
+ * @param options - How the number is shown.
+ * @returns The bind a `Text` carries.
+ * @example
+ * ```ts
+ * const Counter = component("Counter", { value: 0 });
+ *
+ * bind(Counter, "value"); // { component: "Counter", field: "value", format: "int" }
+ *
+ * // The chest timer: the time left, as minutes and seconds.
+ * Text({ style: "digits", bind: bind(Countdown, "left", { format: "mm:ss" }) });
+ * // bind is { component: "Countdown", field: "left", format: "mm:ss" }; 95 s left shows "01:35"
+ * ```
+ */
+declare function bind<Value extends object>(component: ComponentHandle<Value>, field: BindField<Value>, options?: BindOptions): TextBind;
+/**
+ * A moment to count down to. A game writes `until`, a moment of `clock` in epoch milliseconds;
+ * `text` keeps `left` at the time that is left, computed from one `clock.now()` per frame on the
+ * render side, and writes it only when the label bound to it changes. At zero both stay at zero.
+ * Nothing of it reaches the save.
+ *
+ * @example
+ * ```ts
+ * // The chest of the board opens at a moment of the save; clock.now() is 1_790_000_000_000.
+ * view: chest => [
+ *   Countdown({ until: chest.opensAt }), // opensAt: 1_790_000_095_000
+ *   Text({ style: "digits", bind: bind(Countdown, "left", { format: "mm:ss" }) })
+ * ]
+ * // after the frame that spawns it: Text.resolved is "01:35", Countdown.left is 95000
+ * ```
+ */
+declare const Countdown: ComponentType<CountdownValue>;
 /**
  * What `label` takes: the two things every label needs, and the anchor that has a default.
  *
@@ -113,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$12, State$11, AnimApi, {
+declare const animPlugin: import("@moku-labs/core").PluginInstance<"anim", Config$13, State$12, AnimApi, {
   "anim:mark": {
     animation: string;
     mark: string;
@@ -139,7 +177,7 @@ declare const animPlugin: import("@moku-labs/core").PluginInstance<"anim", Confi
  * app.assets.usage().textureMb; // 0.188, the boot tier
  * ```
  */
-declare const assetsPlugin: import("@moku-labs/core").PluginInstance<"assets", Config$9, State$8, Api$6, {
+declare const assetsPlugin: import("@moku-labs/core").PluginInstance<"assets", Config$1, State$1, Api, {
   "assets:bundle-loaded": {
     bundle: string;
     tier: Tier;
@@ -189,7 +227,7 @@ declare const audioPlugin: import("@moku-labs/core").PluginInstance<"audio", Con
  * });
  * ```
  */
-declare const clockPlugin: import("@moku-labs/core").PluginInstance<"clock", Config$1, State$1, Api, {}> & Record<never, never>;
+declare const clockPlugin: import("@moku-labs/core").PluginInstance<"clock", Config$2, State$2, Api$1, {}> & Record<never, never>;
 //#endregion
 //#region src/plugins/effects/index.d.ts
 /**
@@ -223,7 +261,7 @@ declare const effectsPlugin: import("@moku-labs/core").PluginInstance<"effects",
  * });
  * ```
  */
-declare const flowPlugin: import("@moku-labs/core").PluginInstance<"flow", Config$2, State$2, Api$1, {
+declare const flowPlugin: import("@moku-labs/core").PluginInstance<"flow", Config$3, State$3, Api$2, {
   "flow:edge": {
     flow: string;
     node: string;
@@ -304,7 +342,7 @@ declare const inputPlugin: import("@moku-labs/core").PluginInstance<"input", Con
  * });
  * ```
  */
-declare const lifecyclePlugin: import("@moku-labs/core").PluginInstance<"lifecycle", Config$3, State$3, Api$2, {
+declare const lifecyclePlugin: import("@moku-labs/core").PluginInstance<"lifecycle", Config$4, State$4, Api$3, {
   "lifecycle:changed": {
     reason: PauseReason;
     action: "push" | "pop";
@@ -329,7 +367,7 @@ declare const lifecyclePlugin: import("@moku-labs/core").PluginInstance<"lifecyc
  * });
  * ```
  */
-declare const modelPlugin: import("@moku-labs/core").PluginInstance<"model", Config$4, State$4, {
+declare const modelPlugin: import("@moku-labs/core").PluginInstance<"model", Config$5, State$5, {
   store: StoreApi;
   rng: RngApi;
 }, {
@@ -491,7 +529,7 @@ declare const platformPlugin: import("@moku-labs/core").PluginInstance<"platform
  * app.renderer.host.kind(); // "webgpu" in Chrome, "webgl" on an older device
  * ```
  */
-declare const rendererPlugin: import("@moku-labs/core").PluginInstance<"renderer", Config$5, State$5, Api$3, {
+declare const rendererPlugin: import("@moku-labs/core").PluginInstance<"renderer", Config$6, State$6, Api$4, {
   "renderer:device-lost": {
     kind: "webgpu" | "webgl";
     reason: string;
@@ -539,7 +577,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$13, State$12, TextApi, {}> & Record<never, never>;
+declare const textPlugin: import("@moku-labs/core").PluginInstance<"text", Config$12, State$11, TextApi, {}> & Record<never, never>;
 //#endregion
 //#region src/plugins/time/index.d.ts
 /**
@@ -554,7 +592,7 @@ declare const textPlugin: import("@moku-labs/core").PluginInstance<"text", Confi
  * });
  * ```
  */
-declare const timePlugin: import("@moku-labs/core").PluginInstance<"time", Config$6, State$6, Api$4, {}> & Record<never, never>;
+declare const timePlugin: import("@moku-labs/core").PluginInstance<"time", Config$7, State$7, Api$5, {}> & Record<never, never>;
 //#endregion
 //#region src/plugins/ui/index.d.ts
 /**
@@ -587,7 +625,7 @@ declare const uiPlugin: import("@moku-labs/core").PluginInstance<"ui", Config$14
  * app.world.projection.entityOf("board.items", "i7"); // 1048576
  * ```
  */
-declare const worldPlugin: import("@moku-labs/core").PluginInstance<"world", Config$7, State$7, Api$5, {
+declare const worldPlugin: import("@moku-labs/core").PluginInstance<"world", Config$8, State$8, Api$6, {
   "world:reconciled": {
     mode: "play" | "direct";
     projections: number;
@@ -798,15 +836,18 @@ type IntentValue = {
   payload: Json;
 };
 /**
- * A view that can be carried. It names no intent: the drop target does.
+ * A view that can be carried. It names no intent: the drop target does. `carry` lists the
+ * projection keys of views of the same projection that ride along on top of it, such as the cards
+ * that lie on a solitaire card.
  *
  * @example
  * ```ts
- * const value: CarryValue = { payload: { from: "c2" } };
+ * const value: CarryValue = { payload: { from: "c7" }, carry: ["c8", "c9"] };
  * ```
  */
 type CarryValue = {
   payload: Json;
+  carry: readonly string[];
 };
 /**
  * Where the one pointer is, in reference units. `justPressed` and `justReleased` are true for
@@ -835,7 +876,8 @@ declare const Tappable: ComponentType<IntentValue>;
  */
 declare const Pressable: ComponentType<IntentValue>;
 /**
- * This view can be carried by the finger. It names no intent; the drop target does.
+ * This view can be carried by the finger. It names no intent; the drop target does. The views
+ * whose keys `carry` lists hang under it from the grab to the release and fly home with it.
  */
 declare const Draggable: ComponentType<CarryValue>;
 /**
@@ -846,6 +888,13 @@ declare const DropTarget: ComponentType<IntentValue>;
  * A swipe on this view answers `{ intent, payload: { ...payload, direction } }`.
  */
 declare const Swipeable: ComponentType<IntentValue>;
+/**
+ * A finger drawn through views that carry this answers once, on the release:
+ * `{ intent, payload: { path } }`, the payloads of the cells in the order the finger went through
+ * them. Going back to the cell before the last takes the last one off. It wins over every other
+ * gesture component on the same view.
+ */
+declare const Traceable: ComponentType<IntentValue>;
 /**
  * Takes a press without naming a gesture: the hit test accepts a view that carries only this tag,
  * and a tap on it runs the `onTap` listeners and answers nothing. `ui` tags the buttons that
@@ -860,6 +909,11 @@ declare const Held: TagType;
  * On the topmost drop target under the finger during a drag. At most one, never the held view.
  */
 declare const Hovered: TagType;
+/**
+ * On every view of the trace in progress, from the moment the finger reaches it until it backs
+ * off it or the trace ends. A game system draws the line through them.
+ */
+declare const Traced: TagType;
 /**
  * On the pressed view, from pointer down until a tap, a long press, a grab, a swipe or a cancel.
  */
@@ -1302,7 +1356,7 @@ declare function defineEmitter(id: string, config: EmitterConfig): EmitterDefini
  * });
  * ```
  */
-declare const createApp: <const ExtraPlugins extends readonly import("@moku-labs/core").AnyPluginInstance[] = readonly []>(options?: import("@moku-labs/core").CreateAppOptions<Config$8, Events$1, (import("@moku-labs/core").PluginInstance<"time", Config$6, State$6, Api$4, {}> & Record<never, never>) | (import("@moku-labs/core").PluginInstance<"lifecycle", Config$3, State$3, Api$2, {
+declare const createApp: <const ExtraPlugins extends readonly import("@moku-labs/core").AnyPluginInstance[] = readonly []>(options?: import("@moku-labs/core").CreateAppOptions<Config$9, Events$1, (import("@moku-labs/core").PluginInstance<"time", Config$7, State$7, Api$5, {}> & Record<never, never>) | (import("@moku-labs/core").PluginInstance<"lifecycle", Config$4, State$4, Api$3, {
   "lifecycle:changed": {
     reason: PauseReason;
     action: "push" | "pop";
@@ -1310,7 +1364,7 @@ declare const createApp: <const ExtraPlugins extends readonly import("@moku-labs
     paused: boolean;
     resumed: boolean;
   };
-}> & Record<never, never>) | (import("@moku-labs/core").PluginInstance<"model", Config$4, State$4, {
+}> & Record<never, never>) | (import("@moku-labs/core").PluginInstance<"model", Config$5, State$5, {
   store: StoreApi;
   rng: RngApi;
 }, {
@@ -1318,7 +1372,7 @@ declare const createApp: <const ExtraPlugins extends readonly import("@moku-labs
     roots: readonly Root[];
     cause: "edge" | "rollback" | "restore" | "load";
   };
-}> & Record<never, never>) | (import("@moku-labs/core").PluginInstance<"clock", Config$1, State$1, Api, {}> & Record<never, never>) | (import("@moku-labs/core").PluginInstance<"flow", Config$2, State$2, Api$1, {
+}> & Record<never, never>) | (import("@moku-labs/core").PluginInstance<"clock", Config$2, State$2, Api$1, {}> & Record<never, never>) | (import("@moku-labs/core").PluginInstance<"flow", Config$3, State$3, Api$2, {
   "flow:edge": {
     flow: string;
     node: string;
@@ -1342,7 +1396,7 @@ declare const createApp: <const ExtraPlugins extends readonly import("@moku-labs
     rolledBackTo: string;
     retry: boolean;
   };
-}> & Record<never, never>) | ExtraPlugins[number], [...ExtraPlugins], import("@moku-labs/core").CoreApisFromTuple<[import("@moku-labs/core").CorePluginInstance<"log", import("@moku-labs/common/browser").LogConfig, import("@moku-labs/common/browser").LogState, import("@moku-labs/common/browser").LogApi>, import("@moku-labs/core").CorePluginInstance<"env", import("@moku-labs/common/browser").EnvConfig, import("@moku-labs/common/browser").EnvState, import("@moku-labs/common/browser").EnvApi>]>> | undefined) => import("@moku-labs/core").App<Config$8, Events$1, (import("@moku-labs/core").PluginInstance<"time", Config$6, State$6, Api$4, {}> & Record<never, never>) | (import("@moku-labs/core").PluginInstance<"lifecycle", Config$3, State$3, Api$2, {
+}> & Record<never, never>) | ExtraPlugins[number], [...ExtraPlugins], import("@moku-labs/core").CoreApisFromTuple<[import("@moku-labs/core").CorePluginInstance<"log", import("@moku-labs/common/browser").LogConfig, import("@moku-labs/common/browser").LogState, import("@moku-labs/common/browser").LogApi>, import("@moku-labs/core").CorePluginInstance<"env", import("@moku-labs/common/browser").EnvConfig, import("@moku-labs/common/browser").EnvState, import("@moku-labs/common/browser").EnvApi>]>> | undefined) => import("@moku-labs/core").App<Config$9, Events$1, (import("@moku-labs/core").PluginInstance<"time", Config$7, State$7, Api$5, {}> & Record<never, never>) | (import("@moku-labs/core").PluginInstance<"lifecycle", Config$4, State$4, Api$3, {
   "lifecycle:changed": {
     reason: PauseReason;
     action: "push" | "pop";
@@ -1350,7 +1404,7 @@ declare const createApp: <const ExtraPlugins extends readonly import("@moku-labs
     paused: boolean;
     resumed: boolean;
   };
-}> & Record<never, never>) | (import("@moku-labs/core").PluginInstance<"model", Config$4, State$4, {
+}> & Record<never, never>) | (import("@moku-labs/core").PluginInstance<"model", Config$5, State$5, {
   store: StoreApi;
   rng: RngApi;
 }, {
@@ -1358,7 +1412,7 @@ declare const createApp: <const ExtraPlugins extends readonly import("@moku-labs
     roots: readonly Root[];
     cause: "edge" | "rollback" | "restore" | "load";
   };
-}> & Record<never, never>) | (import("@moku-labs/core").PluginInstance<"clock", Config$1, State$1, Api, {}> & Record<never, never>) | (import("@moku-labs/core").PluginInstance<"flow", Config$2, State$2, Api$1, {
+}> & Record<never, never>) | (import("@moku-labs/core").PluginInstance<"clock", Config$2, State$2, Api$1, {}> & Record<never, never>) | (import("@moku-labs/core").PluginInstance<"flow", Config$3, State$3, Api$2, {
   "flow:edge": {
     flow: string;
     node: string;
@@ -1395,7 +1449,7 @@ declare const createApp: <const ExtraPlugins extends readonly import("@moku-labs
  * });
  * ```
  */
-declare const createPlugin: import("@moku-labs/core").BoundCreatePluginFunction<Config$8, Events$1, import("@moku-labs/core").CoreApisFromTuple<[import("@moku-labs/core").CorePluginInstance<"log", import("@moku-labs/common/browser").LogConfig, import("@moku-labs/common/browser").LogState, import("@moku-labs/common/browser").LogApi>, import("@moku-labs/core").CorePluginInstance<"env", import("@moku-labs/common/browser").EnvConfig, import("@moku-labs/common/browser").EnvState, import("@moku-labs/common/browser").EnvApi>]>>;
+declare const createPlugin: import("@moku-labs/core").BoundCreatePluginFunction<Config$9, Events$1, import("@moku-labs/core").CoreApisFromTuple<[import("@moku-labs/core").CorePluginInstance<"log", import("@moku-labs/common/browser").LogConfig, import("@moku-labs/common/browser").LogState, import("@moku-labs/common/browser").LogApi>, import("@moku-labs/core").CorePluginInstance<"env", import("@moku-labs/common/browser").EnvConfig, import("@moku-labs/common/browser").EnvState, import("@moku-labs/common/browser").EnvApi>]>>;
 /**
  * Binds the authoring helpers to the types of one game: "createApp for a game". Each plugin binds
  * its own helpers (`flowFor`, `projectionFor`, `componentsFor`, `bundlesFor`, `scenesFor`); this
@@ -1483,7 +1537,7 @@ declare function defineGame<Types extends GameTypes>(): {
  * createApp({ plugins: [...screen, boardFeature], pluginConfigs: { renderer: { mount: "#game" } } });
  * ```
  */
-declare const screen: readonly [import("@moku-labs/core").PluginInstance<"world", Config$7, State$7, Api$5, {
+declare const screen: readonly [import("@moku-labs/core").PluginInstance<"world", Config$8, State$8, Api$6, {
   "world:reconciled": {
     mode: "play" | "direct";
     projections: number;
@@ -1495,12 +1549,12 @@ declare const screen: readonly [import("@moku-labs/core").PluginInstance<"world"
     hintsRouted: number;
     hintsDropped: number;
   };
-}> & Record<never, never>, import("@moku-labs/core").PluginInstance<"renderer", Config$5, State$5, Api$3, {
+}> & Record<never, never>, import("@moku-labs/core").PluginInstance<"renderer", Config$6, State$6, Api$4, {
   "renderer:device-lost": {
     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$9, State$8, Api$6, {
+}> & 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, {
   "assets:bundle-loaded": {
     bundle: string;
     tier: Tier;
@@ -1525,7 +1579,7 @@ declare const screen: readonly [import("@moku-labs/core").PluginInstance<"world"
     to: string;
     music: string | undefined;
   };
-}> & Record<never, never>, import("@moku-labs/core").PluginInstance<"anim", Config$12, State$11, AnimApi, {
+}> & Record<never, never>, import("@moku-labs/core").PluginInstance<"anim", Config$13, State$12, AnimApi, {
   "anim:mark": {
     animation: string;
     mark: string;
@@ -1537,6 +1591,6 @@ declare const screen: readonly [import("@moku-labs/core").PluginInstance<"world"
   "i18n:locale-changed": {
     locale: string;
   };
-}> & Record<never, never>, import("@moku-labs/core").PluginInstance<"text", Config$13, State$12, TextApi, {}> & Record<never, never>, import("@moku-labs/core").PluginInstance<"ui", Config$14, State$13, UiApi, {}> & Record<never, never>];
+}> & Record<never, never>, import("@moku-labs/core").PluginInstance<"text", Config$12, State$11, TextApi, {}> & Record<never, never>, import("@moku-labs/core").PluginInstance<"ui", Config$14, State$13, UiApi, {}> & Record<never, never>];
 //#endregion
-export { Alpha, types_d_exports as Anim, Animation, types_d_exports$1 as Assets, types_d_exports$2 as Audio, type BackResult, Blur, Box, types_d_exports$3 as Clock, ColorMatrix, 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, types_d_exports$13 as TextTypes, types_d_exports$14 as Time, Touchable, Transform, Tree, types_d_exports$15 as Ui, types_d_exports$16 as World, animPlugin, assetsPlugin, audioPlugin, 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 };
+export { Alpha, types_d_exports as Anim, 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 };