@moku-labs/game 0.13.3 → 0.14.1

package/README.md

@@ -9,7 +9,7 @@ You write small nodes and edge tables. The engine runs them, saves on the edges
 [![npm](https://img.shields.io/npm/v/@moku-labs/game?logo=npm&color=cb3837&label=npm)](https://www.npmjs.com/package/@moku-labs/game)
 [![types](https://img.shields.io/badge/types-included-3178c6?logo=typescript&logoColor=white)](#requirements)
 [![node](https://img.shields.io/badge/node-%3E%3D24-339933?logo=node.js&logoColor=white)](#requirements)
-[![bun](https://img.shields.io/badge/bun-%3E%3D1.3.14-2da44e?logo=bun&logoColor=white)](#requirements)
+[![bun](https://img.shields.io/badge/bun-%3E%3D1.4.2-2da44e?logo=bun&logoColor=white)](#requirements)
 [![for @moku-labs/core](https://img.shields.io/badge/for-%40moku--labs%2Fcore-0b7285)](https://github.com/moku-labs/core)
 [![license: MIT](https://img.shields.io/badge/license-MIT-blue)](./LICENSE)
 
@@ -330,7 +330,7 @@ A save of a logic file reloads the page. What swaps and what reloads: [docs/hot-
 
 ## Requirements
 
-- **Node `>= 24`** and **Bun `>= 1.3.14`**. Use `bun` only.
+- **Node `>= 24`** and **Bun `>= 1.4.2`**. Use `bun` only.
 - **TypeScript** in strict mode, with `exactOptionalPropertyTypes` and `noUncheckedIndexedAccess`.
 - **`pixi.js` `^8.0.0`** as a peer dependency. `playwright-core` for visual tests, `sharp` for the asset pack, `typescript` for the project index, `@moku-labs/system` for the system shell and `@moku-labs/native` for the native build are optional peers. `yoga-layout` is loaded lazily by `ui`. The string compiler uses `@formatjs/icu-messageformat-parser` at build time only.
 - **[`@moku-labs/core`](https://github.com/moku-labs/core)** is the kernel. **[`@moku-labs/common`](https://github.com/moku-labs/common)** brings `log` and `env`.

package/dist/app/page.d.mts

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

package/dist/app/system.d.mts

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

package/dist/app.d.mts

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

package/dist/app.mjs

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

package/dist/assets.d.mts

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

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

@@ -1,8 +1,8 @@
-import { A as Api$2, E as DebugSwitches, Ot as Bookmark, h as Api$1, jt as FlowState, ln as Api, vn as Time, w as Captured } from "./types-BSMmnpFm.mjs";
-import { a as AudioApi, r as UiApi, v as ScenesApi, x as AnimApi } from "./types-dJMOXXL3.mjs";
-import { A as InputApi } from "./types-Dm5Oh5bH.mjs";
-import { t as HeadlessApp } from "./headless-CYgYzro0.mjs";
-import { n as Command, r as ControlApp } from "./types-Bonifz5M.mjs";
+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-BWDESfx2.mjs";
+import { a as AudioApi, r as UiApi, v as ScenesApi, x as AnimApi } from "./types-oQoQEj-y.mjs";
+import { A as InputApi } from "./types-BArxen_M.mjs";
+import { t as HeadlessApp } from "./headless-IfD6_JMH.mjs";
+import { n as Command, r as ControlApp } from "./types-InZGjvkI.mjs";
 
 //#region src/plugins/flow/doors/commands.d.ts
 /**

package/dist/control.d.mts

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

package/dist/control.mjs

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

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

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

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

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

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

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

package/dist/index.d.mts

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

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { $ as sfx, A as types_exports$3, At as Noise, B as defineStyle, Bt as rendererPlugin, C as types_exports$10, Ct as effectsPlugin, D as types_exports$6, Dt as ColorMatrix, E as types_exports$7, Et as Blur, F as resolve, Ft as assetsPlugin, G as external, Gt as to, H as platformPlugin, Ht as flowPlugin, I as Box, It as animPlugin, J as mark, Jt as SaveUnreadableError, K as frames, Kt as type, L as LocalWrite, Lt as AnimPlayer, M as types_exports$1, Mt as defineFilter, N as types_exports, Nt as audioPlugin, O as types_exports$5, Ot as Displacement, P as uiPlugin, Pt as scenesPlugin, Q as set, R as popup, Rt as Animation, S as types_exports$11, St as messageDuration, T as types_exports$8, Tt as Alpha, U as HAPTIC_KINDS, Ut as exit, V as textPlugin, Vt as worldPlugin, W as defineAnimation, Wt as slot, 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 Outline, k as types_exports$4, kt as Glow, 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 modelPlugin, 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 Emitter, x as types_exports$12, xt as messageArgument, y as types_exports$14, yt as Traced, z as defineTokens, zt as Frames } from "./src-DlyYl_9X.mjs";
+import { $ as sfx, A as types_exports$3, At as Noise, B as defineStyle, Bt as rendererPlugin, C as types_exports$10, Ct as effectsPlugin, D as types_exports$6, Dt as ColorMatrix, E as types_exports$7, Et as Blur, F as resolve, Ft as assetsPlugin, G as external, Gt as to, H as platformPlugin, Ht as flowPlugin, I as Box, It as animPlugin, J as mark, Jt as SaveUnreadableError, K as frames, Kt as type, L as LocalWrite, Lt as AnimPlayer, M as types_exports$1, Mt as defineFilter, N as types_exports, Nt as audioPlugin, O as types_exports$5, Ot as Displacement, P as uiPlugin, Pt as scenesPlugin, Q as set, R as popup, Rt as Animation, S as types_exports$11, St as messageDuration, T as types_exports$8, Tt as Alpha, U as HAPTIC_KINDS, Ut as exit, V as textPlugin, Vt as worldPlugin, W as defineAnimation, Wt as slot, 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 Outline, k as types_exports$4, kt as Glow, 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 modelPlugin, 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 Emitter, x as types_exports$12, xt as messageArgument, y as types_exports$14, yt as Traced, z as defineTokens, zt as Frames } from "./src-Dgmdzl8R.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, messageArgument, messageDuration, modelPlugin, music, mut, parallel, platformPlugin, play, popup, projection, rendererPlugin, resolve, resource, scenesPlugin, schedule, screen, sequence, set, sfx, slot, spawn, spawned, sprite, stagger, system, tag, textPlugin, timePlugin, to, tr, tween, type, uiPlugin, use, wait, worldPlugin };

package/dist/inspect.d.mts

@@ -1,10 +1,10 @@
-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-BSMmnpFm.mjs";
-import { a as AudioApi, r as UiApi, u as SoundEntry } from "./types-dJMOXXL3.mjs";
-import { n as EffectsApi, r as EffectsStats } from "./types-B_Bp2tWK.mjs";
-import { c as UiNode } from "./types-Dm5Oh5bH.mjs";
-import { t as HeadlessApp } from "./headless-CYgYzro0.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-Bonifz5M.mjs";
-import { n as defineSource } from "./define-Ckp70_GR.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-BWDESfx2.mjs";
+import { a as AudioApi, r as UiApi, u as SoundEntry } from "./types-oQoQEj-y.mjs";
+import { n as EffectsApi, r as EffectsStats } from "./types-D7MGz4c-.mjs";
+import { c as UiNode } from "./types-BArxen_M.mjs";
+import { t as HeadlessApp } from "./headless-IfD6_JMH.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-InZGjvkI.mjs";
+import { n as defineSource } from "./define-Bwp8CNkW.mjs";
 
 //#region src/plugins/flow/doors/read.d.ts
 /**

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-iTxTcukZ.mjs";
+import { a as jsxs, i as jsxDEV, n as JSX, r as jsx, t as Fragment } from "./runtime-CWY6co6m.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-iTxTcukZ.mjs";
+import { a as jsxs, n as JSX, r as jsx, t as Fragment } from "./runtime-CWY6co6m.mjs";
 export { Fragment, type JSX, jsx, jsxs };

package/dist/{memory-DKo9rRWW.d.mts → memory-D1IKoFr1.d.mts}

@@ -1,4 +1,4 @@
-import { Xt as Json, nn as ProviderCall, rn as SaveDoc, tn as PlayerStateProvider } from "./types-BSMmnpFm.mjs";
+import { Xt as Json, nn as ProviderCall, rn as SaveDoc, tn as PlayerStateProvider } from "./types-BWDESfx2.mjs";
 
 //#region src/plugins/model/store/providers/memory.d.ts
 /**

package/dist/{run-BtyrJjmW.mjs → run-Bf2hKyjZ.mjs}

@@ -959,6 +959,26 @@ const fillCommand = defineCommand({
 //#endregion
 //#region src/plugins/flow/control.ts
 /**
+* Restores a bookmark with its `scene` expected first, so the node the restore enters mounts it.
+* A refused restore puts the record back to the mounted scene, when one is mounted: no later
+* node switches to the scene of a bookmark that was never entered. With nothing mounted the
+* record stays, as the scenes API has no way to clear it.
+*
+* @param app - The app; with `scenes`, the bookmark's scene is expected before the restore.
+* @param bookmark - The bookmark to enter.
+* @throws {Error} What `flow.restore` refused the bookmark with, unchanged.
+*/
+async function restoreWithScene(app, bookmark) {
+	const mounted = app.scenes?.current();
+	if (bookmark.scene !== void 0) app.scenes?.expect(bookmark.scene);
+	try {
+		await app.flow.restore(bookmark);
+	} catch (error) {
+		if (mounted !== void 0) app.scenes?.expect(mounted);
+		throw error;
+	}
+}
+/**
 * Enters a bookmark, or a repro's bookmark followed by its route. A bookmark's `scene` is handed
 * to `scenes.expect` first, so a node without a scene of its own mounts it: a rest node, or the
 * transit node of a bookmark taken while an effect that takes answers waited.
@@ -975,9 +995,7 @@ async function restoreFrom(app, input) {
 	const bookmarkOnly = bookmark !== void 0 && repro === void 0;
 	const reproOnly = repro !== void 0 && bookmark === void 0;
 	if (bookmarkOnly) {
-		const read = readBookmark(bookmark);
-		if (read.scene !== void 0) app.scenes?.expect(read.scene);
-		await app.flow.restore(read);
+		await restoreWithScene(app, readBookmark(bookmark));
 		return app.flow.state();
 	}
 	if (reproOnly) {

package/dist/{runtime-iTxTcukZ.d.mts → runtime-CWY6co6m.d.mts}

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

package/dist/{src-DlyYl_9X.mjs → src-Dgmdzl8R.mjs}

@@ -3870,30 +3870,53 @@ async function runLoop(ctx, modules) {
 * Restores a bookmark through the running loop: the active node is aborted with reason
 * `"restore"`, its transaction is discarded, the state is replaced and the node is entered. An
 * edge that was already committed still arrives first, and the rest point it reaches is not the
-* bookmark's: the promise waits for the turn in which the loop takes the bookmark.
+* bookmark's: the promise waits for the turn in which the loop takes the bookmark. A loop that
+* ends before that turn ends the wait too, after a stop or a fatal error. Nothing is entered
+* then, and the bookmark is dropped: the seam outlives the loop, and the next `run()` would enter
+* a bookmark nobody waits for.
 *
 * @param ctx - Domain context of the flow plugin.
 * @param _modules - Injected sibling APIs.
 * @param bookmark - The bookmark to enter.
 * @returns A promise that resolves once the loop entered the bookmark's node, before that node
-*   ran: the rest seam fired.
+*   ran: the rest seam fired. It also resolves when the loop ended first, with nothing entered.
 * @throws {Error} When the loop is not running.
 */
 function restorePosition(ctx, _modules, bookmark) {
 	const state = ctx.state.runner;
-	if (state.running === void 0) throw new Error("[game] flow.restore() needs a running graph.\n  Call flow.run() from the createApp onStart callback first.");
+	const running = state.running;
+	if (running === void 0) throw new Error("[game] flow.restore() needs a running graph.\n  Call flow.run() from the createApp onStart callback first.");
 	const seam = loopSeam(state);
 	const entered = new Promise((resolve) => {
+		/**
+		* Takes the listener off the rest seam.
+		*
+		* @returns True when it was still there, false when it had already left.
+		*/
+		const dropListener = () => {
+			const index = seam.rest.indexOf(listener);
+			if (index === -1) return false;
+			seam.rest.splice(index, 1);
+			return true;
+		};
 		/**
 		* Resolves once, when the loop rests at the restored node.
 		*/
 		const listener = () => {
 			if (seam.restoring !== void 0) return;
-			const index = seam.rest.indexOf(listener);
-			if (index !== -1) seam.rest.splice(index, 1);
+			dropListener();
+			resolve();
+		};
+		/**
+		* Ends the wait when the loop ended, resolved or rejected, before it took the bookmark.
+		*/
+		const finish = () => {
+			if (!dropListener()) return;
+			if (seam.restoring === bookmark) seam.restoring = void 0;
 			resolve();
 		};
 		seam.rest.push(listener);
+		running.then(finish, finish);
 	});
 	seam.restoring = bookmark;
 	state.abort?.abort("restore");
@@ -4115,7 +4138,8 @@ async function reachGate(ctx, seam, ended) {
 * it entered a transit bookmark, so its caller reads a state with the open gate in it. There is no
 * timeout: a node that opens no gate, never rests and never ends keeps the wait pending, as its
 * body would. Call it only after the loop entered the node: a gate opened before that belongs to
-* the node the restore aborted.
+* the node the restore aborted. After a loop that ended before the enter it returns at once: the
+* end of the loop is already there.
 *
 * @param ctx - Domain context of the flow plugin.
 * @returns A promise that resolves at the open gate, at a rest point or at the end of the loop.
@@ -4371,12 +4395,13 @@ function makeBookmark(ctx, modules) {
 * Sends the running loop to a bookmark that passed the check, the short way a walk needs: the
 * promise resolves as soon as the loop stands at the node, before the node ran. It stays an
 * `async` function of its own: the microtask turn it adds lets the loop start the stages of a
-* rest node before the walk goes on and switches to fast mode.
+* rest node before the walk goes on and switches to fast mode. A loop that ends first resolves it
+* too, with nothing entered: the walk then finds its route not reached.
 *
 * @param ctx - Domain context of the flow plugin.
 * @param modules - Injected sibling APIs.
 * @param bookmark - The accepted bookmark.
-* @returns A promise that resolves once the loop entered the node.
+* @returns A promise that resolves once the loop entered the node, or ended first.
 */
 async function enterAccepted(ctx, modules, bookmark) {
 	await restorePosition(ctx, modules, bookmark);
@@ -4413,12 +4438,14 @@ async function walkFrom(ctx, modules, route, from) {
 * enters it. A transit node shows nothing until it ran up to its gate, so for one the promise
 * waits on: for the gate the node opens, or the rest point or the end of the loop it reaches
 * without one. The wait starts only after the loop entered the node, so a gate the aborted old
-* node still opened is not taken for the new one.
+* node still opened is not taken for the new one. A loop that ends before it entered the node
+* ends both waits: nothing is entered, and the wait for the gate returns at once.
 *
 * @param ctx - Domain context of the flow plugin.
 * @param modules - Injected sibling APIs.
 * @param bookmark - The bookmark to enter.
-* @returns A promise that resolves once a rest node is entered, or a transit node waits.
+* @returns A promise that resolves once a rest node is entered, or a transit node waits, or the
+*   loop ended first.
 * @throws {Error} When the bookmark may not be entered, and before `run()`.
 */
 async function restoreBookmark(ctx, modules, bookmark) {
@@ -17546,11 +17573,11 @@ function targetOf(ctx, node, run) {
 	return target;
 }
 /**
-* Reads the scene an `over` node asks for. An over node never switches a mounted scene; it takes
-* the expected scene while nothing is mounted, so a restore at a popup builds the scene under it,
-* whether the popup rests or waits for its answer. In fast mode an over transit node takes
-* nothing and leaves the record alone: a walk builds no scene on the way. A scene the over node
-* names itself is only warned about.
+* Reads the scene an `over` node asks for. An over node takes the expected scene and clears the
+* record, whatever is mounted, so a restore at a popup builds the scene under it, whether the
+* popup rests or waits for its answer. With nothing expected it switches nothing. In fast mode an
+* over transit node takes nothing and leaves the record alone: a walk builds no scene on the way.
+* A scene the over node names itself is only warned about.
 *
 * @param ctx - Domain context of the plugin.
 * @param node - The over node being entered.
@@ -17560,7 +17587,6 @@ function targetOf(ctx, node, run) {
 function overTargetOf(ctx, node, run) {
 	if (node.scene !== void 0) ctx.log.warn("scenes: an over node cannot name a scene", { path: node.path });
 	if (isFastTransit(node, run)) return void 0;
-	if (ctx.state.current !== void 0) return void 0;
 	return takePending(ctx);
 }
 /**
@@ -17588,9 +17614,9 @@ function apply(ctx, scene) {
 	});
 }
 /**
-* The `scene` stage of entering a node: the whole switch. An `over` node never switches a mounted
-* scene, a node without a scene keeps the current one, and an aborted node returns without
-* touching anything.
+* The `scene` stage of entering a node: the whole switch. An `over` node switches only to an
+* expected scene, a node without a scene and with nothing expected keeps the current one, and an
+* aborted node returns without touching anything.
 *
 * @param ctx - Domain context of the plugin.
 * @param node - The node being entered.

package/dist/testing.d.mts

@@ -1,7 +1,7 @@
-import { Dt as AnyFlow, Ht as ClockSource, Nt as NodeTable, Wt as FakeClock, Xt as Json, ht as FeaturePlugin } from "./types-BSMmnpFm.mjs";
-import { t as createApp } from "./index-CjuObHhF.mjs";
-import { n as saveOf, t as memory } from "./memory-DKo9rRWW.mjs";
-import { a as createHeadless, i as ReproResult, n as HeadlessGame, o as runRepro, r as Repro, s as stepFrames, t as HeadlessApp } from "./headless-CYgYzro0.mjs";
+import { Dt as AnyFlow, Ht as ClockSource, Nt as NodeTable, Wt as FakeClock, Xt as Json, ht as FeaturePlugin } from "./types-BWDESfx2.mjs";
+import { t as createApp } from "./index-yUO4Dx2C.mjs";
+import { n as saveOf, t as memory } from "./memory-D1IKoFr1.mjs";
+import { a as createHeadless, i as ReproResult, n as HeadlessGame, o as runRepro, r as Repro, s as stepFrames, t as HeadlessApp } from "./headless-IfD6_JMH.mjs";
 import { AnyPluginInstance } from "@moku-labs/core";
 
 //#region src/plugins/clock/fake.d.ts

package/dist/testing.mjs

@@ -1,4 +1,4 @@
-import { Kt as type, Ut as exit, t as createApp } from "./src-DlyYl_9X.mjs";
+import { Kt as type, Ut as exit, t as createApp } from "./src-Dgmdzl8R.mjs";
 import { n as saveOf, t as memory } from "./memory-CWlqhS7l.mjs";
 import { t as fakeClock } from "./fake-MpzwZhIZ.mjs";
 import { i as stepFrames, r as runRepro, t as createHeadless } from "./headless-BA6ffzqD.mjs";

package/dist/{types-DkO3s9YX.d.mts → types-B98iRBSG.d.mts}

@@ -1,7 +1,7 @@
-import { Dt as AnyFlow, Ht as ClockSource, Jt as Config, Wt as FakeClock, Xt as Json, a as Config$3, g as Config$2, ht as FeaturePlugin, n as AssetsIo, pt as Config$1, tn as PlayerStateProvider, u as Manifest, v as PixiModule } from "./types-BSMmnpFm.mjs";
-import { o as AudioContextLike, s as Config$4 } from "./types-dJMOXXL3.mjs";
-import { _t as audioPlugin, ct as PlatformProvider, ht as effectsPlugin, i as screen, ot as platformPlugin, t as createApp } from "./index-CjuObHhF.mjs";
-import { t as memory } from "./memory-DKo9rRWW.mjs";
+import { Dt as AnyFlow, Ht as ClockSource, Jt as Config, Wt as FakeClock, Xt as Json, a as Config$3, g as Config$2, ht as FeaturePlugin, n as AssetsIo, pt as Config$1, tn as PlayerStateProvider, u as Manifest, v as PixiModule } from "./types-BWDESfx2.mjs";
+import { o as AudioContextLike, s as Config$4 } from "./types-oQoQEj-y.mjs";
+import { _t as audioPlugin, ct as PlatformProvider, ht as effectsPlugin, i as screen, ot as platformPlugin, t as createApp } from "./index-yUO4Dx2C.mjs";
+import { t as memory } from "./memory-D1IKoFr1.mjs";
 import { AnyPluginInstance } from "@moku-labs/core";
 
 //#region src/app/types.d.ts

package/dist/{types-Dm5Oh5bH.d.mts → types-BArxen_M.d.mts}

@@ -1,4 +1,4 @@
-import { A as Api$2, B as ComponentType, F as AnyComponent, H as Entity, I as AnyComponentType, L as AnyComponentValue, Lt as Descriptor, O as Point$2, Q as ChangeHook, Sn as Require, V as ComponentValue, Vt as Api$5, Xt as Json, at as NumericFields, dt as Api$1, h as Api$3, hn as Api, it as MotionHandle, k as ViewportSize, ot as ProjectionMotion, rt as Motion, s as Events$1, t as Api$4, ut as ViewHandle, zt as Hint } from "./types-BSMmnpFm.mjs";
+import { A as Api$2, B as ComponentType, F as AnyComponent, H as Entity, I as AnyComponentType, L as AnyComponentValue, Lt as Descriptor, O as Point$2, Q as ChangeHook, Sn as Require, V as ComponentValue, Vt as Api$5, Xt as Json, at as NumericFields, dt as Api$1, h as Api$3, hn as Api, it as MotionHandle, k as ViewportSize, ot as ProjectionMotion, rt as Motion, s as Events$1, t as Api$4, ut as ViewHandle, zt as Hint } from "./types-BWDESfx2.mjs";
 import { Log } from "@moku-labs/common/browser";
 import { PluginCtx } from "@moku-labs/core";
 

package/dist/{types-BSMmnpFm.d.mts → types-BWDESfx2.d.mts}

@@ -2308,7 +2308,11 @@ type LoopSeam = {
    * Called every time the loop opens a gate: the wait of a rest node, or an effect with answers
    * inside any node. The walk waits on it, and so does `restore` after it entered a transit node.
    */
-  gateOpen: (() => void)[]; /** The bookmark the loop enters at the next turn. */
+  gateOpen: (() => void)[];
+  /**
+   * The bookmark the loop enters at the next turn. The loop clears it when it takes it. A loop
+   * that ends first never takes it, so the restore that waits drops its own.
+   */
   restoring: Bookmark | undefined;
 };
 /**
@@ -2460,9 +2464,14 @@ type RunnerApi = {
    * promise pending. An open gate is not a drawn popup: the popup shows on the next frame. And
    * `setMode` still throws there, since the graph waits inside a transit node.
    *
+   * The promise also resolves when the graph stops before the bookmark was entered: `onStop`
+   * ended the loop, or `run()` rejected. Nothing is entered then and the state is not replaced.
+   * `state()` shows whether it was: its `path` is the node the graph stands at.
+   *
    * @param bookmark - The bookmark to enter.
    * @returns A promise that resolves once a rest node is entered, or a transit node waits at
-   *   its gate.
+   *   its gate. It also resolves when the graph stops first, with nothing entered: read
+   *   `state()` to tell.
    * @throws {Error} When the bookmark names no node of this graph and has no `rest`, when the
    *   graph changed since the bookmark and neither it nor its `rest` point is a rest checkpoint,
    *   and before `run()`.

package/dist/{types-B_Bp2tWK.d.mts → types-D7MGz4c-.d.mts}

@@ -1,5 +1,5 @@
-import { A as Api$1, B as ComponentType, D as FilterSlot, H as Entity, O as Point, R as ComponentHandle, Sn as Require, _ as PixiFilter, b as PixiTexture, dt as Api, h as Api$2, s as Events, t as Api$3, v as PixiModule, xn as Events$1, y as PixiSprite } from "./types-BSMmnpFm.mjs";
-import { x as AnimApi } from "./types-dJMOXXL3.mjs";
+import { A as Api$1, B as ComponentType, D as FilterSlot, H as Entity, O as Point, R as ComponentHandle, Sn as Require, _ as PixiFilter, b as PixiTexture, dt as Api, h as Api$2, s as Events, t as Api$3, v as PixiModule, xn as Events$1, y as PixiSprite } from "./types-BWDESfx2.mjs";
+import { x as AnimApi } from "./types-oQoQEj-y.mjs";
 import { Log } from "@moku-labs/common/browser";
 import { PluginCtx } from "@moku-labs/core";
 

package/dist/{types-Bonifz5M.d.mts → types-InZGjvkI.d.mts}

@@ -1,5 +1,5 @@
-import { Xt as Json, an as Snapshot } from "./types-BSMmnpFm.mjs";
-import { t as HeadlessApp } from "./headless-CYgYzro0.mjs";
+import { Xt as Json, an as Snapshot } from "./types-BWDESfx2.mjs";
+import { t as HeadlessApp } from "./headless-IfD6_JMH.mjs";
 import { Log } from "@moku-labs/common/browser";
 
 //#region src/plugins/flow/doors/types.d.ts

package/dist/{types-dJMOXXL3.d.mts → types-oQoQEj-y.d.mts}

@@ -1,5 +1,5 @@
-import { A as Api$2, B as ComponentType, F as AnyComponent, H as Entity, It as TypeTag, L as AnyComponentValue, Lt as Descriptor, R as ComponentHandle, Sn as Require, Xt as Json, Yt as Events$2, at as NumericFields, ct as TrackOptions, dn as Events$3, dt as Api$1, et as Ease, h as Api$5, hn as Api, it as MotionHandle, lt as TrackSegment, nt as LayerSpec, q as Owner, qt as Api$4, s as Events$4, t as Api$3, tt as LayerSort, xn as Events$5 } from "./types-BSMmnpFm.mjs";
-import { A as InputApi, c as UiNode, i as Finding, n as ElementChange, o as JsxState, q as I18nApi, r as ElementMotion, rt as StylesState, x as TextApi } from "./types-Dm5Oh5bH.mjs";
+import { A as Api$2, B as ComponentType, F as AnyComponent, H as Entity, It as TypeTag, L as AnyComponentValue, Lt as Descriptor, R as ComponentHandle, Sn as Require, Xt as Json, Yt as Events$2, at as NumericFields, ct as TrackOptions, dn as Events$3, dt as Api$1, et as Ease, h as Api$5, hn as Api, it as MotionHandle, lt as TrackSegment, nt as LayerSpec, q as Owner, qt as Api$4, s as Events$4, t as Api$3, tt as LayerSort, xn as Events$5 } from "./types-BWDESfx2.mjs";
+import { A as InputApi, c as UiNode, i as Finding, n as ElementChange, o as JsxState, q as I18nApi, r as ElementMotion, rt as StylesState, x as TextApi } from "./types-BArxen_M.mjs";
 import { Log } from "@moku-labs/common/browser";
 import { PluginCtx } from "@moku-labs/core";
 import { Node, Yoga } from "yoga-layout/load";
@@ -1300,7 +1300,8 @@ type State$2 = {
    * The scene the next node without its own `scene` mounts, at a rest node or at a transit node
    * in live mode: the one a transit node named in fast mode, or the one the restore door expected
    * with `expect`. A rest node clears it; a transit node clears it only when it took it; an over
-   * node takes it only while nothing is mounted.
+   * node takes it and clears it, whatever is mounted, except an over transit node of a fast walk,
+   * which leaves it alone.
    */
   pending: string | undefined;
   owner: SceneOwner; /** The remover of the `onEnter` callback: set in `onStart`, run in `onStop`. */
@@ -1354,8 +1355,10 @@ type ScenesApi = {
    * The restore door calls it with the scene of a bookmark, so a bookmark at a popup comes back
    * with the scene under it, also when the popup is a transit node that waits for its answer:
    * the scene of such a popup is mounted before `flow.restore` resolves.
-   * An over node takes the expected scene only while nothing is mounted; it never switches a
-   * mounted one.
+   * An over node takes the expected scene too, whatever is mounted, so a popup bookmark restored
+   * on a page that shows another scene switches to the scene of the bookmark. With nothing
+   * expected an over node never switches. An over transit node of a fast walk mounts nothing and
+   * keeps the record.
    *
    * @param id - Id of a scene a feature declared.
    * @throws {Error} For an id no feature declared, also before `onStart` filled the registry.

package/dist/visual.d.mts

@@ -1,9 +1,9 @@
-import { A as Api$1, h as Api, ln as Api$3, qt as Api$2 } from "./types-BSMmnpFm.mjs";
-import { r as UiApi, x as AnimApi } from "./types-dJMOXXL3.mjs";
-import { A as InputApi } from "./types-Dm5Oh5bH.mjs";
-import { r as Repro } from "./headless-CYgYzro0.mjs";
-import { a as InputOf, r as ControlApp } from "./types-Bonifz5M.mjs";
-import { t as commands } from "./commands-DRhJ_LIH.mjs";
+import { A as Api$1, h as Api, ln as Api$3, qt as Api$2 } from "./types-BWDESfx2.mjs";
+import { r as UiApi, x as AnimApi } from "./types-oQoQEj-y.mjs";
+import { A as InputApi } from "./types-BArxen_M.mjs";
+import { r as Repro } from "./headless-IfD6_JMH.mjs";
+import { a as InputOf, r as ControlApp } from "./types-InZGjvkI.mjs";
+import { t as commands } from "./commands-Cpn2ga7s.mjs";
 
 //#region src/visual/types.d.ts
 /** The base commands of the `/control` door, keyed by their short names. */

package/dist/visual.mjs

@@ -1,5 +1,5 @@
 import { n as read, t as sources } from "./sources-Duzj6lhV.mjs";
-import { n as commands, t as run } from "./run-BtyrJjmW.mjs";
+import { n as commands, t as run } from "./run-Bf2hKyjZ.mjs";
 import path from "node:path";
 import { createBrandConsole } from "@moku-labs/common/cli";
 import { mkdir, readFile, writeFile } from "node:fs/promises";

package/llms.txt

@@ -2,7 +2,7 @@
 
 > 2D puzzle game engine on TypeScript, built as a Layer-2 framework on @moku-labs/core. The game is a deterministic graph of business logic. State commits only on edges. Position is data. Player input and world events are answers a node waits for. The screen is a projection of committed state. V1 is the logic plugins `time`, `lifecycle`, `model`, `clock`, `flow` and a headless testing entry; V2 adds the screen plugins `world`, `renderer`, `input`, `assets`, `scenes`, a Pixi v8 renderer loaded lazily, and the `@moku-labs/game/assets` entry that generates typed asset keys. V3 adds the interface plugins `anim`, `i18n`, `text`, `ui` (`screen` lists all nine) and the opt-in `audio`: choreographies as data, strings as data, text from MSDF fonts, screens in JSX laid out by Yoga, sound as an effect a node awaits. V4 adds two doors for the editor: `@moku-labs/game/inspect` reads a running game, `@moku-labs/game/control` drives a dev build. V5 adds the opt-in plugin `effects`: particles and WGSL/GLSL filters as components. V6 adds the opt-in plugin `platform`: the Back button, haptics and keep-awake through a provider the game passes. The game shell makes a game a folder of data: `@moku-labs/game/app` (`defineGameApp`, `config.ts` as `GameConfig`), the page `@moku-labs/game/app/page`, the system shell `@moku-labs/game/app/system` and the bin `moku-game` that serves, builds, packages and packs the folder. The package is published on npm as `@moku-labs/game`, and this file ships inside it.
 
-Facts: Bun only. ESM only. `"sideEffects"` lists the root entry `./dist/index.mjs` only, every other entry has none. `pixi.js` `^8.0.0` is a peer dependency, no V1 code imports it. `playwright-core` (visual tests), `sharp` (the asset pack), `typescript` (the project index), `@moku-labs/system` (the system shell and the store save) and `@moku-labs/native` (`moku-game native`) are optional peers. Node >= 24, Bun >= 1.3.14. TypeScript strict with `exactOptionalPropertyTypes` and `noUncheckedIndexedAccess`. The engine ships no genre rules: no merge, no match-3, no physics. A game brings its own pure rule functions.
+Facts: Bun only. ESM only. `"sideEffects"` lists the root entry `./dist/index.mjs` only, every other entry has none. `pixi.js` `^8.0.0` is a peer dependency, no V1 code imports it. `playwright-core` (visual tests), `sharp` (the asset pack), `typescript` (the project index), `@moku-labs/system` (the system shell and the store save) and `@moku-labs/native` (`moku-game native`) are optional peers. Node >= 24, Bun >= 1.4.2. TypeScript strict with `exactOptionalPropertyTypes` and `noUncheckedIndexedAccess`. The engine ships no genre rules: no merge, no match-3, no physics. A game brings its own pure rule functions.
 
 ## Entry points
 
@@ -475,14 +475,14 @@ The graph. Modules `runner`, `gate`, `inbox`, `fx`, `features`. Runner methods s
 - `features.register(name, description)`, `features.all()`, `features.contributions(slotName)`.
 - `FlowState` is `{ running, path, stack, pending: { fx?, gate? }, mode }`.
 - `Bookmark` is `{ path, input, player, session, rng, graph, scene?, rest? }`. Serialisable. `scene` is written by the `game.bookmark` door and read by `game.restore`; `flow.restore` ignores it. `path` names a rest node, or the transit node that waits at the gate for an effect that takes answers (a `popup`, or a hand-written descriptor with `answers`); `rest: { path, input }` then names the rest point before it (left out when the graph started at that node or a restore entered it), and the state is the one committed when that node was entered. `restore` needs a running graph. A rest checkpoint is always accepted. Any other node is accepted only when the graph did not change since the bookmark; with another graph a transit bookmark is entered at `rest` instead when that is a checkpoint, and the log gets `flow:restore-fell-back`.
-- `restore` of a rest node resolves when the node is entered. `restore` of a transit node runs it again from its start, so its effects before the gate play again, and resolves once its gate is open. The open gate is not the draw: the popup shows on the next frame.
+- `restore` of a rest node resolves when the node is entered. `restore` of a transit node runs it again from its start, so its effects before the gate play again, and resolves once its gate is open. The open gate is not the draw: the popup shows on the next frame. `restore` also resolves when the loop ends before the bookmark was entered, after a stop or a fatal error, and nothing is entered then.
 - Events: `flow:edge` `{ flow, node, outcome, payload, next, patches: { doc, session }, index, now }` after the commit of an edge. `flow:rest` `{ path, checkpoint }`. `flow:error` `{ path, error, rolledBackTo, retry }`.
 - Config: `mainFlow` default `undefined` and required before `run()`, `safeNode: string | undefined` default `undefined` which means the main flow's `start`, `retries` default `1`, `settleTimeoutMs` default `2000`, `journalLimit` default `500`.
 
 ### Screen plugins (V2, built)
 
 `world`, `renderer`, `input`, `assets`, `scenes`. Each has a README at `src/plugins/<name>/README.md`; the root README lists their APIs, events and config. Rendering: WebGPU preferred, with Pixi's WebGL fallback.
-- `app.scenes`: `current()` the mounted scene id, `expect(id)` the scene the next node without its own `scene` mounts, a rest node or a transit node in live mode (the restore door calls it; an unknown id throws).
+- `app.scenes`: `current()` the mounted scene id, `expect(id)` the scene the next node without its own `scene` mounts, a rest node or a transit node in live mode (the restore door calls it; an unknown id throws). An `over` node takes it the same way, also over another mounted scene.
 - `resource(name, defaults)` clones plain JSON defaults into every world. `resource(name, () => value)` calls the factory once per world on first read, so the value may hold a `Map` or a function: `const Looks = resource("boardLooks", () => ({ shown: new Map<World.Entity, { look: string }>() }))`. A system keeps its own state there; `snapshot()` leaves a value that is not JSON out.
 - `app.world.projection.replace(spec)` swaps the spec of a registered projection; a mounted one runs its new `view` on the next frame. An unknown name throws. The caller is the dev hot swap.
 
@@ -593,7 +593,7 @@ Two subpaths, neither on the root (V4). An editor, MCP tools and e2e scripts rea
 - `@moku-labs/game/inspect`: `read(app, source, input?)` reads once; `watch(app, source, input, fn)` reads on the `signals` phase when the source changes and returns the stop function; `defineSource`; the frozen catalogue `sources`; the types `Source`, `InputSchema`, `InputOf`. Every source only reads, so the door is safe in a production build. Keys of `sources`: `graph`, `position`, `history`, `tainted`, `cheats`, `model`, `entities`, `projections`, `ui`, `locate`, `render`, `sounds`, `audioMuted`, `effects`, `assets`, `log`, `explain`, `diff`, `schema`, `at`; their ids are `game.<key>`. `locate` takes `{ key }` (a ui element) or `{ target }` (a view by projection key) and answers its box in CSS px, the numbers Playwright clicks. `at` takes `{ x, y }` in CSS px and lists the views under that point, topmost first. `explain` takes `{ entity }` and answers that entity in full, `undefined` for a stale id. `diff` takes `{ from, to }` frames and answers what changed per entity; it throws in a production build and for a frame outside the last 120. `schema` lists every component and tag type the world met, with the JSON kind of each field. `audioMuted` answers whether the master bus is muted. `sounds` throws `[game] The source game.sounds needs audioPlugin.`, `audioMuted` throws `[game] The source game.audioMuted needs audioPlugin.` and `effects` throws `[game] The source game.effects needs effectsPlugin.` when that plugin is not installed; the editor lists such a source as not installed.
 - `@moku-labs/game/control`: `run(app, command, input?)` resolves `{ value, state }`, `state` being `{ path, frame, tainted }`; `defineCommand`; `controlRefused`; the frozen catalogue `commands`; the types `Command`, `Ran`. Keys of `commands`: `answer`, `tap`, `drag`, `key`, `fill`, `walk`, `bookmark`, `restore`, `step`, `pause`, `resume`, `capture`, `debug`, `reducedMotion`, `timeScale`, `mute`, `trace`. `capture` resolves `{ png }`, and `{ png, legend }` with `legend: true`; `undefined` while the renderer is inert. `timeScale` takes `{ scale }`; 0 freezes game time while the frames keep running. `mute` takes `{ muted }`, mutes the master bus and answers the flag. Without `audioPlugin` it throws `[game] The command game.mute needs audioPlugin.` `trace` takes `{ path }`, a list of views by projection key, and answers whether the gate took the answer.
 - Commands run in dev builds only. Only `__MOKU_GAME_DEV__ === true` turns the dev build on: `moku-game dev` defines it `true` and sets the global in `.moku/dev.ts`, `moku-game build` defines it `false`; a game without the shell uses a bundler `define`; a test uses `vi.stubGlobal("__MOKU_GAME_DEV__", true)`. Otherwise `run` throws `[game] Control commands run in dev builds only.`
-- A command's effect is `read`, `route`, `cosmetic`, `cheat` or `raw`. A `cheat` or `raw` command taints the session and is journaled; read it with `sources.tainted` and `sources.cheats`. Of the base commands only `restore` is `raw`. `bookmark` answers `flow.bookmark()` plus `scene`, the mounted scene; `restore` calls `scenes.expect(scene)` before `flow.restore`, so a bookmark at a popup restores the scene under it. A bookmark taken while an effect that takes answers waits names the waiting transit node (`info/show` in the mini game) and carries `rest`; `restore` of it answers once that node's gate is open, with `pending.gate` in its value, and the popup shows on the next frame.
+- A command's effect is `read`, `route`, `cosmetic`, `cheat` or `raw`. A `cheat` or `raw` command taints the session and is journaled; read it with `sources.tainted` and `sources.cheats`. Of the base commands only `restore` is `raw`. `bookmark` answers `flow.bookmark()` plus `scene`, the mounted scene; `restore` calls `scenes.expect(scene)` before `flow.restore`, so a bookmark at a popup restores the scene under it, also on a page that shows another scene. A bookmark taken while an effect that takes answers waits names the waiting transit node (`info/show` in the mini game) and carries `rest`; `restore` of it answers once that node's gate is open, with `pending.gate` in its value, and the popup shows on the next frame.
 - A game's own: `defineSource({ id, title, input, changes, read })` with `changes` `"frame"`, `"commit"` or `"edge"`, and `defineCommand({ id, title, input, effect, run })`. The id is camelCase words joined by dots, at least two: `dice.rolls`. An input schema maps field names to `"string"`, `"number"`, `"boolean"` or `"json"`; a trailing `?` makes one optional. A command body starts with `if (typeof __MOKU_GAME_DEV__ === "undefined" || !__MOKU_GAME_DEV__) throw controlRefused();`. Keep them in `.dev` modules that only the dev page and the tests import: the editor's dev page (`preparePage` with agents) imports every `**/*.dev.ts`, `moku-game build` none.
 
 ## Project index

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moku-labs/game",
-  "version": "0.13.3",
+  "version": "0.14.1",
   "description": "2D puzzle game engine on TypeScript and PixiJS, built on @moku-labs/core.",
   "type": "module",
   "sideEffects": [
@@ -95,7 +95,7 @@
   },
   "engines": {
     "node": ">=24.0.0",
-    "bun": ">=1.3.14"
+    "bun": ">=1.4.2"
   },
   "scripts": {
     "lint": "biome check . && eslint .",
@@ -160,7 +160,7 @@
     "@moku-labs/core": "1.7.1",
     "@moku-labs/native": "0.3.2",
     "@moku-labs/system": "0.3.1",
-    "@types/bun": "1.3.14",
+    "@types/bun": "1.4.2",
     "@vitest/coverage-istanbul": "4.0.18",
     "eslint": "9.39.3",
     "eslint-config-biome": "2.1.3",