incanto 0.33.0 → 0.35.0

package/dist/gameplay.d.ts

@@ -1,5 +1,5 @@
-import { at as Node, l as PropSchema, n as BehaviorCtor, t as Behavior, v as Engine } from "./behavior-CKwTCjfR.js";
-import { c as JsonValue, s as JsonObject } from "./schema-CcoWb32N.js";
+import { b as Engine, bt as Node, d as PropSchema, n as BehaviorCtor, t as Behavior } from "./behavior-CGSCWOHB.js";
+import { c as JsonValue, s as JsonObject } from "./schema-3ywbdlrv.js";
 
 //#region src/gameplay/chase.d.ts
 /**
@@ -51,6 +51,9 @@ declare class Collector extends Behavior {
   override onReady(): void;
   /** Add `value` to the tally and emit `totalChanged`. */
   collect(value: number): void;
+  /** How many have been picked up so far. */
+  override serialize(): JsonValue;
+  override deserialize(data: JsonValue): void;
 }
 //#endregion
 //#region src/gameplay/health.d.ts
@@ -96,6 +99,9 @@ declare class Health extends Behavior {
   kill(): void;
   private setCurrent;
   private die;
+  /** Current HP and whether death already fired — `max` comes back from JSON. */
+  override serialize(): JsonValue;
+  override deserialize(data: JsonValue): void;
 }
 //#endregion
 //#region src/gameplay/damage-on-contact.d.ts
@@ -377,6 +383,9 @@ declare class ScoreKeeper extends Behavior {
   setScore(value: number): void;
   /** Lose one life (no-op when lives disabled or already lost). Emits `lifeLost`, then `lost` at 0. */
   loseLife(): void;
+  /** The run's progress. `scoreToWin` is balance and comes back from JSON. */
+  override serialize(): JsonValue;
+  override deserialize(data: JsonValue): void;
 }
 //#endregion
 //#region src/gameplay/spawner.d.ts
@@ -606,9 +615,7 @@ declare function goToScene(engine: Engine, sceneJson: JsonObject, opts?: {
 */
 declare class GameFlow extends Behavior {
   static readonly signals: readonly string[];
-  static readonly props: Record<string, {
-    default: string | boolean;
-  }>;
+  static readonly props: PropSchema;
   /** Input action that restarts from gameover/won (declare it in `input{}`). */
   restartAction: string;
   /** Freeze `engine.timeScale` on gameover/won (banner UI keeps rendering). */

package/dist/gameplay.js

@@ -1,2 +1,2 @@
-import { C as FollowCamera, D as Health, E as DamageOnContact, O as Collector, S as restartScene, T as phaseOf, _ as hitStop, a as Wander, b as GameFlow, c as Projectile, d as PathFollow, f as Oscillate, g as Cooldown, h as CameraShake, i as WaveSpawner, k as Chase, l as Pickup, m as Lifetime, n as registerGameplayBehaviors, o as Spawner, p as MoveTo, r as ZombieAI, s as ScoreKeeper, t as GAMEPLAY_BEHAVIORS, u as Patrol, v as screenFlash, w as DayNight, x as goToScene, y as Interactable } from "./gameplay-BpQCbABv.js";
+import { C as FollowCamera, D as Health, E as DamageOnContact, O as Collector, S as restartScene, T as phaseOf, _ as hitStop, a as Wander, b as GameFlow, c as Projectile, d as PathFollow, f as Oscillate, g as Cooldown, h as CameraShake, i as WaveSpawner, k as Chase, l as Pickup, m as Lifetime, n as registerGameplayBehaviors, o as Spawner, p as MoveTo, r as ZombieAI, s as ScoreKeeper, t as GAMEPLAY_BEHAVIORS, u as Patrol, v as screenFlash, w as DayNight, x as goToScene, y as Interactable } from "./gameplay-BvhcQbfJ.js";
 export { CameraShake, Chase, Collector, Cooldown, DamageOnContact, DayNight, FollowCamera, GAMEPLAY_BEHAVIORS, GameFlow, Health, Interactable, Lifetime, MoveTo, Oscillate, PathFollow, Patrol, Pickup, Projectile, ScoreKeeper, Spawner, Wander, WaveSpawner, ZombieAI, goToScene, hitStop, phaseOf, registerGameplayBehaviors, restartScene, screenFlash };

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-import { $ as MusicBackend, A as suggestQuality, B as Listener, C as RendererStats, D as SettingsValues, E as Settings, F as SfxEngine, G as spatialGain, H as RolloffModel, I as SfxPlayOptions, J as SFX_PRESET_NAMES, K as spatialPan, L as isAudioContextAvailable, M as createSaveStore, N as Scene, O as qualityEnvironment, P as InputMap, Q as synthSfx, R as Voice, S as GameStats, T as QualityTier, U as SpatialParams, V as ROLLOFF_MODELS, W as Vec3, X as SfxWave, Y as SfxParams, Z as SynthOptions, _ as registeredTypes, a as registerBehavior, at as Node, b as Scheduler, c as PropDef, ct as LogEntry, d as createNode, dt as Signal, et as MusicManager, f as getNodeSchema, ft as SignalListener, g as registerNode, h as mergeStaticSignals, i as getBehavior, it as BusName, j as SaveStore, k as readDeviceHints, l as PropSchema, lt as LogLevel, m as getNodeType, n as BehaviorCtor, nt as PlayMusicOptions, o as registeredBehaviors, ot as NodeLifecycle, p as getNodeSignals, q as SFX_PRESETS, r as clearBehaviors, rt as AudioBuses, s as NodeCtor, st as SceneTree, t as Behavior, tt as MusicTrack, u as clearRegistry, ut as LogManager, v as Engine, w as DeviceHints, x as EngineStats, y as EngineOptions, z as VoicePreset } from "./behavior-CKwTCjfR.js";
-import { a as Rng, c as JsonValue, d as jsonKind, i as SceneJson, l as jsonClone, n as NodeJson, o as JsonKind, r as SCENE_FORMAT, s as JsonObject, t as ConnectionJson, u as jsonEquals } from "./schema-CcoWb32N.js";
-import { n as loadScene, t as LoadSceneOptions } from "./loader-COn5fS0o.js";
-import { n as ParticleSimConfig, r as ParticleView, t as ParticleSim } from "./particle-sim-CwJ5rI_P.js";
-import { a as AudioElementLike, i as gridFromRows, n as PathGrid, o as AudioPlayer, r as findPath, t as FindPathOptions } from "./pathfinding-DUw9mir9.js";
-import { i as auditScene, n as IncantoErrorCode, r as IncantoErrorDetails, t as IncantoError } from "./errors-1dXlIwoR.js";
+import { $ as Voice, A as qualityEnvironment, B as restoreBehaviors, C as EngineStats, Ct as LogEntry, D as QualityTier, Dt as SignalListener, E as DeviceHints, Et as Signal, F as RestoreReport, G as Localization, H as createSaveStore, I as SaveSlot, J as translationKey, K as T_PREFIX, L as SaveSlots, M as suggestQuality, N as Scene, O as Settings, P as BehaviorState, Q as isAudioContextAvailable, R as behaviorsWithoutSave, S as Scheduler, St as SceneTree, T as RendererStats, Tt as LogManager, U as BASE_LOCALE, V as SaveStore, W as LocaleTables, X as SfxEngine, Y as InputMap, Z as SfxPlayOptions, _ as mergeStaticSignals, _t as PlayMusicOptions, a as clearBehaviors, at as Vec3, b as Engine, bt as Node, c as registeredBehaviors, ct as SFX_PRESETS, d as PropSchema, dt as SfxWave, et as VoicePreset, f as clearRegistry, ft as SynthOptions, g as getNodeType, gt as MusicTrack, h as getNodeSignals, ht as MusicManager, i as behaviorSignals, it as SpatialParams, j as readDeviceHints, k as SettingsValues, l as NodeCtor, lt as SFX_PRESET_NAMES, m as getNodeSchema, mt as MusicBackend, n as BehaviorCtor, nt as ROLLOFF_MODELS, o as getBehavior, ot as spatialGain, p as createNode, pt as synthSfx, q as suggestLocale, r as behaviorSchema, rt as RolloffModel, s as registerBehavior, st as spatialPan, t as Behavior, tt as Listener, u as PropDef, ut as SfxParams, v as registerNode, vt as AudioBuses, w as GameStats, wt as LogLevel, x as EngineOptions, xt as NodeLifecycle, y as registeredTypes, yt as BusName, z as captureBehaviors } from "./behavior-CGSCWOHB.js";
+import { a as Rng, c as JsonValue, d as jsonKind, i as SceneJson, l as jsonClone, n as NodeJson, o as JsonKind, r as SCENE_FORMAT, s as JsonObject, t as ConnectionJson, u as jsonEquals } from "./schema-3ywbdlrv.js";
+import { n as loadScene, t as LoadSceneOptions } from "./loader-CUcj00M8.js";
+import { n as ParticleSimConfig, r as ParticleView, t as ParticleSim } from "./particle-sim-B-vZBF5R.js";
+import { a as AudioElementLike, i as gridFromRows, n as PathGrid, o as AudioPlayer, r as findPath, t as FindPathOptions } from "./pathfinding-DgOo2KNF.js";
+import { i as auditScene, n as IncantoErrorCode, r as IncantoErrorDetails, t as IncantoError } from "./errors-BY2kL0hv.js";
 
 //#region src/core/audio/crossfade.d.ts
 /**
@@ -120,6 +120,7 @@ declare class HudLayer extends Node {
   static readonly props: PropSchema;
   zIndex: number;
   visible: boolean;
+  focusNavigation: boolean;
   /** @internal root overlay element (null headless). */
   _element: HTMLElement | null;
   private readonly slots;
@@ -138,14 +139,40 @@ declare class HudLayer extends Node {
   private _mount;
   override onExitTree(): void;
   override update(): void;
+  /**
+  * Arrow keys / d-pad move the focus, Enter / A activates it.
+  *
+  * Off by default: a game whose HUD has a button must not lose its arrow keys
+  * to a menu the moment one exists. Turn it on for the screens that ARE menus
+  * (`"focusNavigation": true` on the pause panel's layer), and off again when
+  * play resumes.
+  */
+  private stepFocus;
+  /** Focusable widgets under this layer, in tree order. */
+  private focusables;
+  /** Move focus to a widget by hand — opening a menu should start somewhere. */
+  focus(widget: HudWidgetBase | null): void;
   /** @internal Widgets mount into per-anchor flex columns. */
   _slot(anchor: HudAnchor): HTMLElement | null;
 }
 /** Shared plumbing: mount into the parent HudLayer's anchor slot. */
 declare abstract class HudWidgetBase extends Node {
   static readonly props: PropSchema;
+  static readonly signals: readonly string[];
   anchor: HudAnchor;
   visible: boolean;
+  focusable: boolean;
+  draggable: boolean;
+  dropTarget: boolean;
+  /** @internal Set by the owning HudLayer while this widget has focus. */
+  _focused: boolean;
+  /**
+  * @internal Confirm (`dir` 0) or nudge (-1 left / +1 right) — what pressing
+  * A or an arrow ON this widget means. Default: nothing.
+  */
+  _activate(_dir: number): void;
+  /** @internal Draw the focus ring. Overridable if a widget wants its own. */
+  _paintFocus(): void;
   /** @internal */
   _element: HTMLElement | null;
   protected abstract _build(): HTMLElement;
@@ -161,11 +188,31 @@ declare abstract class HudWidgetBase extends Node {
   * anything attached at runtime before its host existed.
   */
   _mountWidget(): void;
+  /**
+  * Drag and drop, on the DOM the engine already builds.
+  *
+  * An inventory is the one screen where "click it" is not enough, and every
+  * game that wanted one dropped out of scene JSON to hand-roll pointer
+  * handlers. The whole gesture is four signals and no new node type: a
+  * `draggable` widget emits `dragStarted` and, if it lands on one,
+  * `droppedOn(target)`; a `dropTarget` emits `dropped(source)`. Who owns the
+  * ITEM is the game's business — this reports the gesture, not a model.
+  */
+  private _wireDrag;
   /** The nearest ancestor that holds widgets itself (a UiPanel). */
   private host;
   override onExitTree(): void;
   override update(_dt: number): void;
   protected _sync(): void;
+  /**
+  * Resolve a text prop through the engine's locale.
+  *
+  * Called every frame from `_sync`, which is what makes switching language
+  * repaint with nothing to invalidate: widgets already re-read their props, so
+  * the new string simply appears on the next frame. A plain string costs one
+  * `startsWith` and is returned untouched.
+  */
+  protected _t(value: string): string;
 }
 /** A text line (score, timer, hints). Set `.text` from behaviors. */
 declare class UiText extends HudWidgetBase {
@@ -193,6 +240,8 @@ declare class UiBar extends HudWidgetBase {
   background: string;
   label: string;
   private fill;
+  private tag;
+  private lastLabel;
   private lastRatio;
   /** Current fill ratio 0..1 (what the bar shows). */
   get ratio(): number;
@@ -244,6 +293,9 @@ declare class UiButton extends HudWidgetBase {
   color: string;
   background: string;
   disabled: boolean;
+  override focusable: boolean;
+  /** Enter / A on a focused button is a press. */
+  override _activate(_dir: number): void;
   private lastText;
   /** Programmatic press — same path as a click (tests, gamepad menus). */
   press(): void;
@@ -392,6 +444,9 @@ declare class UiSlider extends HudWidgetBase {
   step: number;
   width: number;
   color: string;
+  override focusable: boolean;
+  /** Left/right nudge by one step — the only sane thing a d-pad can mean here. */
+  override _activate(dir: number): void;
   private input;
   private text;
   private last;
@@ -405,6 +460,9 @@ declare class UiToggle extends HudWidgetBase {
   static override readonly signals: readonly string[];
   label: string;
   value: boolean;
+  override focusable: boolean;
+  /** Confirm flips it; left/right set it explicitly, which reads better on a pad. */
+  override _activate(dir: number): void;
   private input;
   private last;
   protected _build(): HTMLElement;
@@ -418,10 +476,17 @@ declare class UiSelect extends HudWidgetBase {
   label: string;
   options: string;
   value: string;
+  override focusable: boolean;
+  /** Left/right (and confirm) walk the list — a select has no other gesture. */
+  override _activate(dir: number): void;
   private select;
+  private labelEl;
+  private lastLabel;
   private lastOptions;
   private last;
   protected _build(): HTMLElement;
+  /** Override point: what an option READS as, when it differs from its value. */
+  protected _optionLabel(value: string): string;
   private fillOptions;
   protected override _sync(): void;
 }
@@ -708,4 +773,4 @@ declare function computeViewport(canvasW: number, canvasH: number, viewport: {
 /** Engine version. Kept in sync with package.json by the release pipeline. */
 declare const VERSION: string;
 //#endregion
-export { AudioBuses, type AudioElementLike, AudioPlayer, Behavior, type BehaviorCtor, type BusName, CONST_REF_KEY, type ComputedViewport, type ConnectionJson, type CrossfadeGains, type DebugLineSource, type DeviceHints, Engine, type EngineOptions, type EngineStats, type FindPathOptions, type GameStats, type HudAnchor, HudLayer, IncantoError, type IncantoErrorCode, type IncantoErrorDetails, InputMap, type JsonKind, type JsonObject, type JsonValue, type Listener, type LoadSceneOptions, type LogEntry, type LogLevel, LogManager, type MusicBackend, MusicManager, type MusicTrack, Node, type NodeCtor, type NodeJson, type NodeLifecycle, ORDER_GROUP_BASE, type OrderGroup, PARTICLE_PRESETS, PARTICLE_PRESET_NAMES, type ParsedNodePath, type ParticlePresetValues, ParticleSim, type ParticleSimConfig, type ParticleView, type PathGrid, type PlayMusicOptions, type PreloadResult, type PropDef, type PropSchema, type QualityTier, ROLLOFF_MODELS, type Recorder, type RendererStats, type ReplayEvent, type ReplayJson, type ResolvedRendering, type ResolvedViewport, Rng, type RolloffModel, SCENE_FORMAT, SFX_PRESETS, SFX_PRESET_NAMES, type SaveStore, Scene, type SceneJson, SceneTree, type Scheduler, Settings, type SettingsValues, SfxEngine, type SfxParams, type SfxPlayOptions, type SfxWave, Signal, type SignalListener, type SpatialParams, type SynthOptions, Timer, TouchControls, type TouchControlsOptions, UiBanner, UiBar, UiButton, UiDialogue, UiImage, UiPanel, UiSelect, UiSlider, UiText, UiToggle, VERSION, type Vec3, type ViewportFit, type Voice, type VoicePreset, WebAudioMusicBackend, applyParticlePreset, assetUrls, attachTouchControls, auditScene, clearBehaviors, clearRegistry, computeViewport, createNode, createNoise2D, createSaveStore, crossfadeGains, duplicateNode, effectiveOrder, fadeGain, findPath, getBehavior, getNodeSchema, getNodeSignals, getNodeType, gridFromRows, isAudioContextAvailable, isConstRef, joystickVector, jsonClone, jsonEquals, jsonKind, loadScene, mergeStaticSignals, newUid, parseNodePath, preloadUrls, qualityEnvironment, readDeviceHints, registerBehavior, registerCoreNodes, registerNode, registeredBehaviors, registeredTypes, replay, resolveConstants, resolveRendering, resolveViewport, serializeNode, spatialGain, spatialPan, startRecording, suggestQuality, synthSfx };
+export { AudioBuses, type AudioElementLike, AudioPlayer, BASE_LOCALE, Behavior, type BehaviorCtor, type BehaviorState, type BusName, CONST_REF_KEY, type ComputedViewport, type ConnectionJson, type CrossfadeGains, type DebugLineSource, type DeviceHints, Engine, type EngineOptions, type EngineStats, type FindPathOptions, type GameStats, type HudAnchor, HudLayer, IncantoError, type IncantoErrorCode, type IncantoErrorDetails, InputMap, type JsonKind, type JsonObject, type JsonValue, type Listener, type LoadSceneOptions, type LocaleTables, Localization, type LogEntry, type LogLevel, LogManager, type MusicBackend, MusicManager, type MusicTrack, Node, type NodeCtor, type NodeJson, type NodeLifecycle, ORDER_GROUP_BASE, type OrderGroup, PARTICLE_PRESETS, PARTICLE_PRESET_NAMES, type ParsedNodePath, type ParticlePresetValues, ParticleSim, type ParticleSimConfig, type ParticleView, type PathGrid, type PlayMusicOptions, type PreloadResult, type PropDef, type PropSchema, type QualityTier, ROLLOFF_MODELS, type Recorder, type RendererStats, type ReplayEvent, type ReplayJson, type ResolvedRendering, type ResolvedViewport, type RestoreReport, Rng, type RolloffModel, SCENE_FORMAT, SFX_PRESETS, SFX_PRESET_NAMES, type SaveSlot, SaveSlots, type SaveStore, Scene, type SceneJson, SceneTree, type Scheduler, Settings, type SettingsValues, SfxEngine, type SfxParams, type SfxPlayOptions, type SfxWave, Signal, type SignalListener, type SpatialParams, type SynthOptions, T_PREFIX, Timer, TouchControls, type TouchControlsOptions, UiBanner, UiBar, UiButton, UiDialogue, UiImage, UiPanel, UiSelect, UiSlider, UiText, UiToggle, VERSION, type Vec3, type ViewportFit, type Voice, type VoicePreset, WebAudioMusicBackend, applyParticlePreset, assetUrls, attachTouchControls, auditScene, behaviorSchema, behaviorSignals, behaviorsWithoutSave, captureBehaviors, clearBehaviors, clearRegistry, computeViewport, createNode, createNoise2D, createSaveStore, crossfadeGains, duplicateNode, effectiveOrder, fadeGain, findPath, getBehavior, getNodeSchema, getNodeSignals, getNodeType, gridFromRows, isAudioContextAvailable, isConstRef, joystickVector, jsonClone, jsonEquals, jsonKind, loadScene, mergeStaticSignals, newUid, parseNodePath, preloadUrls, qualityEnvironment, readDeviceHints, registerBehavior, registerCoreNodes, registerNode, registeredBehaviors, registeredTypes, replay, resolveConstants, resolveRendering, resolveViewport, restoreBehaviors, serializeNode, spatialGain, spatialPan, startRecording, suggestLocale, suggestQuality, synthSfx, translationKey };

package/dist/index.js

@@ -1,12 +1,12 @@
-import { _ as clearBehaviors, a as SCENE_FORMAT, b as registeredBehaviors, c as SceneTree, d as resolveConstants, f as Node, g as Behavior, h as InputMap, i as serializeNode, l as CONST_REF_KEY, n as loadScene, o as computeViewport, p as parseNodePath, r as Scene, s as resolveViewport, u as isConstRef, v as getBehavior, x as Signal, y as registerBehavior } from "./loader-Buk8Bu1h.js";
-import { A as MusicManager, C as isAudioContextAvailable, D as SFX_PRESETS, E as spatialPan, M as crossfadeGains, N as fadeGain, O as SFX_PRESET_NAMES, P as AudioBuses, S as SfxEngine, T as spatialGain, _ as qualityEnvironment, a as UiSlider, b as createSaveStore, c as UiButton, d as UiBanner, f as UiBar, g as Settings, h as Engine, i as UiSelect, j as WebAudioMusicBackend, k as synthSfx, l as UiDialogue, m as AudioPlayer, n as UiImage, o as UiToggle, p as UiText, r as UiPanel, s as Timer, t as registerCoreNodes, u as HudLayer, v as readDeviceHints, w as ROLLOFF_MODELS, x as LogManager, y as suggestQuality } from "./register-CscIzJEO.js";
+import { C as Signal, S as registeredBehaviors, _ as behaviorSchema, a as SCENE_FORMAT, b as getBehavior, c as SceneTree, d as resolveConstants, f as Node, g as Behavior, i as serializeNode, l as CONST_REF_KEY, m as InputMap, n as loadScene, o as computeViewport, p as parseNodePath, r as Scene, s as resolveViewport, u as isConstRef, v as behaviorSignals, x as registerBehavior, y as clearBehaviors } from "./loader-Mig5fY4n.js";
+import { A as translationKey, B as WebAudioMusicBackend, C as restoreBehaviors, D as Localization, E as BASE_LOCALE, F as spatialPan, H as fadeGain, I as SFX_PRESETS, L as SFX_PRESET_NAMES, M as isAudioContextAvailable, N as ROLLOFF_MODELS, O as T_PREFIX, P as spatialGain, R as synthSfx, S as captureBehaviors, T as LogManager, U as AudioBuses, V as crossfadeGains, _ as qualityEnvironment, a as UiSlider, b as SaveSlots, c as UiButton, d as UiBanner, f as UiBar, g as Settings, h as Engine, i as UiSelect, j as SfxEngine, k as suggestLocale, l as UiDialogue, m as AudioPlayer, n as UiImage, o as UiToggle, p as UiText, r as UiPanel, s as Timer, t as registerCoreNodes, u as HudLayer, v as readDeviceHints, w as createSaveStore, x as behaviorsWithoutSave, y as suggestQuality, z as MusicManager } from "./register-BFLg0-_i.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as Rng } from "./rng-DP-SR7eg.js";
-import { t as auditScene } from "./audit-C4kmDK0o.js";
+import { t as auditScene } from "./audit-C5oZGAru.js";
 import { n as jsonEquals, r as jsonKind, t as jsonClone } from "./json-BLk7H2Qa.js";
 import { a as getNodeSignals, c as mergeStaticSignals, i as getNodeSchema, l as registerNode, n as clearRegistry, o as getNodeType, r as createNode, u as registeredTypes } from "./registry-CJdGpT2V.js";
 import { t as createNoise2D } from "./noise-CGUMx44x.js";
-import { n as ORDER_GROUP_BASE, r as effectiveOrder, t as duplicateNode } from "./duplicate-BgnG1Lqz.js";
+import { n as ORDER_GROUP_BASE, r as effectiveOrder, t as duplicateNode } from "./duplicate-C716f-97.js";
 import { i as applyParticlePreset, n as PARTICLE_PRESETS, r as PARTICLE_PRESET_NAMES, t as ParticleSim } from "./particle-sim-Bw7hB93B.js";
 import { i as resolveRendering, n as attachTouchControls, r as joystickVector, t as TouchControls } from "./touch-BoNg_MnF.js";
 //#region src/core/pathfinding.ts
@@ -242,6 +242,6 @@ function newUid() {
 //#endregion
 //#region src/index.ts
 /** Engine version. Kept in sync with package.json by the release pipeline. */
-const VERSION = "0.33.0";
+const VERSION = "0.35.0";
 //#endregion
-export { AudioBuses, AudioPlayer, Behavior, CONST_REF_KEY, Engine, HudLayer, IncantoError, InputMap, LogManager, MusicManager, Node, ORDER_GROUP_BASE, PARTICLE_PRESETS, PARTICLE_PRESET_NAMES, ParticleSim, ROLLOFF_MODELS, Rng, SCENE_FORMAT, SFX_PRESETS, SFX_PRESET_NAMES, Scene, SceneTree, Settings, SfxEngine, Signal, Timer, TouchControls, UiBanner, UiBar, UiButton, UiDialogue, UiImage, UiPanel, UiSelect, UiSlider, UiText, UiToggle, VERSION, WebAudioMusicBackend, applyParticlePreset, assetUrls, attachTouchControls, auditScene, clearBehaviors, clearRegistry, computeViewport, createNode, createNoise2D, createSaveStore, crossfadeGains, duplicateNode, effectiveOrder, fadeGain, findPath, getBehavior, getNodeSchema, getNodeSignals, getNodeType, gridFromRows, isAudioContextAvailable, isConstRef, joystickVector, jsonClone, jsonEquals, jsonKind, loadScene, mergeStaticSignals, newUid, parseNodePath, preloadUrls, qualityEnvironment, readDeviceHints, registerBehavior, registerCoreNodes, registerNode, registeredBehaviors, registeredTypes, replay, resolveConstants, resolveRendering, resolveViewport, serializeNode, spatialGain, spatialPan, startRecording, suggestQuality, synthSfx };
+export { AudioBuses, AudioPlayer, BASE_LOCALE, Behavior, CONST_REF_KEY, Engine, HudLayer, IncantoError, InputMap, Localization, LogManager, MusicManager, Node, ORDER_GROUP_BASE, PARTICLE_PRESETS, PARTICLE_PRESET_NAMES, ParticleSim, ROLLOFF_MODELS, Rng, SCENE_FORMAT, SFX_PRESETS, SFX_PRESET_NAMES, SaveSlots, Scene, SceneTree, Settings, SfxEngine, Signal, T_PREFIX, Timer, TouchControls, UiBanner, UiBar, UiButton, UiDialogue, UiImage, UiPanel, UiSelect, UiSlider, UiText, UiToggle, VERSION, WebAudioMusicBackend, applyParticlePreset, assetUrls, attachTouchControls, auditScene, behaviorSchema, behaviorSignals, behaviorsWithoutSave, captureBehaviors, clearBehaviors, clearRegistry, computeViewport, createNode, createNoise2D, createSaveStore, crossfadeGains, duplicateNode, effectiveOrder, fadeGain, findPath, getBehavior, getNodeSchema, getNodeSignals, getNodeType, gridFromRows, isAudioContextAvailable, isConstRef, joystickVector, jsonClone, jsonEquals, jsonKind, loadScene, mergeStaticSignals, newUid, parseNodePath, preloadUrls, qualityEnvironment, readDeviceHints, registerBehavior, registerCoreNodes, registerNode, registeredBehaviors, registeredTypes, replay, resolveConstants, resolveRendering, resolveViewport, restoreBehaviors, serializeNode, spatialGain, spatialPan, startRecording, suggestLocale, suggestQuality, synthSfx, translationKey };

package/dist/{loader-COn5fS0o.d.ts → loader-CUcj00M8.d.ts}

@@ -1,5 +1,5 @@
-import { N as Scene, v as Engine } from "./behavior-CKwTCjfR.js";
-import { i as SceneJson } from "./schema-CcoWb32N.js";
+import { N as Scene, b as Engine } from "./behavior-CGSCWOHB.js";
+import { i as SceneJson } from "./schema-3ywbdlrv.js";
 
 //#region src/core/scene/loader.d.ts
 interface LoadSceneOptions {
@@ -20,6 +20,23 @@ interface LoadSceneOptions {
   */
   stubMissingBehaviors?: boolean;
   /**
+  * Editor mode: EVERY script becomes a no-op stub, registered or not.
+  *
+  * The editor must not run the game while you edit it — a behavior's `onReady`
+  * moving the player, or `update` walking it off the terrain, is not something
+  * an edit view should do. It used to get that by deleting `script` outright,
+  * which also meant deleting `connections` (a behavior handler cannot resolve
+  * on a node with no behavior) — so the editor validated a scene the game
+  * would reject, and reported green.
+  *
+  * Stubbing instead keeps connections loadable and hard-validated: endpoints
+  * must still resolve, so DANGLING_CONNECTION fires in the editor exactly
+  * where it fires in the game. Handlers are accepted (they live in the game's
+  * TypeScript, which the editor does not load) and props are not applied.
+  * Games should NOT set this.
+  */
+  stubAllBehaviors?: boolean;
+  /**
   * Attach the engine BEFORE onEnterTree/onReady fire, so behaviors can use
   * `this.engine` / `this.rng` / `this.log` in onReady. `createGame` does
   * this for you; pair it with `engine.setScene(scene)` afterwards.

package/dist/{loader-Buk8Bu1h.js → loader-Mig5fY4n.js}

@@ -103,6 +103,23 @@ function getBehavior(name) {
 	}
 	return ctor;
 }
+/**
+* A registered behavior's merged prop schema, `{}` for one nobody registered.
+*
+* The node side has had `getNodeSchema` for a long time; a behavior's props were
+* reachable only by whoever already held the class, which a tool reading scene
+* JSON never does. Deliberately non-throwing: a tool inspecting a scene that
+* names a behavior from a game it did not load should degrade, not blow up.
+*/
+function behaviorSchema(name) {
+	const ctor = behaviors.get(name);
+	return ctor ? mergeStaticProps(ctor) : {};
+}
+/** A registered behavior's signals (own + inherited), `[]` for an unknown one. */
+function behaviorSignals(name) {
+	const ctor = behaviors.get(name);
+	return ctor ? mergeStaticSignals(ctor) : [];
+}
 function registeredBehaviors() {
 	return [...behaviors.keys()];
 }
@@ -118,6 +135,14 @@ function createBehavior(name, props) {
 	return behavior;
 }
 //#endregion
+//#region src/core/diagnostics.ts
+function diagnose(engine, level, ...parts) {
+	engine?.log[level](...parts);
+	if (level === "error") console.error(...parts);
+	else if (level === "warn") console.warn(...parts);
+	else console.info(...parts);
+}
+//#endregion
 //#region src/core/input.ts
 /** Keys typed into editable elements belong to the page UI, not the game. */
 function isEditableTarget(target) {
@@ -453,6 +478,19 @@ var InputMap = class {
 	* is ceremony. Buttons already live in the key set as `Mouse0`/`Mouse1`/…;
 	* these read them directly. 0 left, 1 middle, 2 right.
 	*/
+	/**
+	* Is this raw CODE down / just pressed? (`'ArrowUp'`, `'Enter'`, `'Pad12'`…)
+	*
+	* Menu navigation is not a bindable action — there is no key to remap, and
+	* asking every scene to declare `"menuUp": { "keys": ["ArrowUp", "Pad12"] }`
+	* is ceremony for something every menu on every platform does the same way.
+	*/
+	keyPressed(code) {
+		return this.down.has(code);
+	}
+	keyJustPressed(code) {
+		return this.pressedEdge.has(code);
+	}
 	mousePressed(button = 0) {
 		return this.down.has(`Mouse${button}`);
 	}
@@ -559,14 +597,6 @@ function parseInputDecls(decls) {
 	return out;
 }
 //#endregion
-//#region src/core/diagnostics.ts
-function diagnose(engine, level, ...parts) {
-	engine?.log[level](...parts);
-	if (level === "error") console.error(...parts);
-	else if (level === "warn") console.warn(...parts);
-	else console.info(...parts);
-}
-//#endregion
 //#region src/core/node-path.ts
 function parseNodePath(path) {
 	if (path === "") throw new IncantoError("BAD_NODE_PATH", "Node path must not be empty.");
@@ -644,10 +674,7 @@ var Node = class {
 		const old = this._name;
 		if (this._parent) this._name = uniqueSiblingName(value, this._parent._children, this);
 		else this._name = value;
-		if (this._tree && this._name !== old) {
-			this._tree._unindexName(this, old);
-			this._tree._indexName(this);
-		}
+		if (this._tree && this._name !== old) this._tree._reindexName(this, old);
 	}
 	get parent() {
 		return this._parent;
@@ -1042,7 +1069,7 @@ function resolveConstants(value, constants) {
 *
 * Headless by design — tests step it manually; the render loop (M2) calls it.
 */
-var SceneTree = class {
+var SceneTree = class SceneTree {
 	_root = null;
 	_engine = null;
 	freeQueue = /* @__PURE__ */ new Set();
@@ -1058,6 +1085,47 @@ var SceneTree = class {
 	* change shape?" check for per-step body gathers and similar caches.
 	*/
 	_structureVersion = 0;
+	/**
+	* WHAT changed, not just that something did.
+	*
+	* The version alone forces every consumer into a full-tree re-walk, and the
+	* physics step is gated on it: one bullet spawned per frame means
+	* `collectBodies` + `collectJoints` + `syncScatters` walk the entire scene at
+	* 60 Hz. A bullet-hell or a survivors-like does nothing else all game.
+	*
+	* This log lets a consumer replay just the attaches and detaches it has not
+	* seen. It is bounded — a scene load appends thousands of entries and nobody
+	* benefits from replaying those — so a consumer that falls behind
+	* `_structureLogBase` takes the full walk, exactly as before. Correctness does
+	* not depend on the log; only the fast path does.
+	*/
+	_structureLog = [];
+	/** The `_structureVersion` the first entry in the log corresponds to. */
+	_structureLogBase = 0;
+	static STRUCTURE_LOG_MAX = 2048;
+	/**
+	* Attaches and detaches since `sinceVersion`, or null when the log no longer
+	* reaches back that far (take the full walk).
+	*
+	* The returned array is the live buffer's tail — do not hold it across frames.
+	*/
+	_structureSince(sinceVersion) {
+		if (sinceVersion > this._structureVersion) return null;
+		if (sinceVersion < this._structureLogBase) return null;
+		return this._structureLog.slice(sinceVersion - this._structureLogBase);
+	}
+	_logStructure(node, added) {
+		this._structureVersion++;
+		this._structureLog.push({
+			node,
+			added
+		});
+		const overflow = this._structureLog.length - SceneTree.STRUCTURE_LOG_MAX;
+		if (overflow > 0) {
+			this._structureLog.splice(0, overflow);
+			this._structureLogBase += overflow;
+		}
+	}
 	_frameId = 0;
 	/**
 	* Monotonic update-frame counter — bumped once per `update()`. Per-frame
@@ -1069,7 +1137,7 @@ var SceneTree = class {
 	}
 	/** @internal Node attach hook. */
 	_indexName(node) {
-		this._structureVersion++;
+		this._logStructure(node, true);
 		let set = this._nameIndex.get(node.name);
 		if (!set) {
 			set = /* @__PURE__ */ new Set();
@@ -1077,9 +1145,29 @@ var SceneTree = class {
 		}
 		set.add(node);
 	}
-	/** @internal Node detach/rename hook (`name` = the entry to remove). */
+	/**
+	* @internal A RENAME: same node, same place, different key in the name index.
+	*
+	* Deliberately not logged as a detach + attach. It is not a structural change,
+	* and treating it as one would make the physics step tear down and rebuild the
+	* node's Rapier body for a name edit.
+	*/
+	_reindexName(node, oldName) {
+		const set = this._nameIndex.get(oldName);
+		if (set) {
+			set.delete(node);
+			if (set.size === 0) this._nameIndex.delete(oldName);
+		}
+		let next = this._nameIndex.get(node.name);
+		if (!next) {
+			next = /* @__PURE__ */ new Set();
+			this._nameIndex.set(node.name, next);
+		}
+		next.add(node);
+	}
+	/** @internal Node detach hook (`name` = the entry to remove). */
 	_unindexName(node, name = node.name) {
-		this._structureVersion++;
+		this._logStructure(node, false);
 		const set = this._nameIndex.get(name);
 		if (set) {
 			set.delete(node);
@@ -1278,6 +1366,8 @@ var Scene = class {
 	constants;
 	/** Input action declarations (loaded into `Engine.input` on setScene). */
 	input;
+	/** Translations by locale (merged into `Engine.locale` on setScene). */
+	strings;
 	/** Physics config (gravity etc. — interpreted by the physics modules). */
 	physics;
 	/** Multiplayer config (room etc. — interpreted by incanto/net). */
@@ -1296,6 +1386,7 @@ var Scene = class {
 		this.assets = source.assets ? jsonClone(source.assets) : void 0;
 		this.constants = source.constants ? jsonClone(source.constants) : void 0;
 		this.input = source.input ? jsonClone(source.input) : void 0;
+		this.strings = source.strings ? jsonClone(source.strings) : void 0;
 		this.physics = source.physics ? jsonClone(source.physics) : void 0;
 		this.multiplayer = source.multiplayer ? jsonClone(source.multiplayer) : void 0;
 		this.environment = source.environment ? jsonClone(source.environment) : void 0;
@@ -1312,6 +1403,7 @@ var Scene = class {
 			...this.assets ? { assets: jsonClone(this.assets) } : {},
 			...this.constants ? { constants: jsonClone(this.constants) } : {},
 			...this.input ? { input: jsonClone(this.input) } : {},
+			...this.strings ? { strings: jsonClone(this.strings) } : {},
 			...this.physics ? { physics: jsonClone(this.physics) } : {},
 			...this.multiplayer ? { multiplayer: jsonClone(this.multiplayer) } : {},
 			...this.environment ? { environment: jsonClone(this.environment) } : {},
@@ -1435,7 +1527,7 @@ function applyCommon(node, nj, opts) {
 		node.script = jsonClone(nj.script);
 		const name = nj.script.name;
 		if (typeof name !== "string" || name === "") throw new IncantoError("BAD_FORMAT", `Node '${nj.name}': "script" needs a non-empty "name" (a registered behavior).`);
-		const behavior = opts?.stubMissingBehaviors && !hasBehavior(name) ? new class extends StubBehavior {}() : createBehavior(name, nj.script.props);
+		const behavior = opts?.stubAllBehaviors || opts?.stubMissingBehaviors && !hasBehavior(name) ? new class extends StubBehavior {}() : createBehavior(name, nj.script.props);
 		behavior.node = node;
 		node.behavior = behavior;
 		for (const s of mergeStaticSignals(behavior.constructor)) node.declareSignal(s);
@@ -1507,4 +1599,4 @@ function validateUniqueUids(root) {
 	walk(root);
 }
 //#endregion
-export { clearBehaviors as _, SCENE_FORMAT as a, registeredBehaviors as b, SceneTree as c, resolveConstants as d, Node as f, Behavior as g, InputMap as h, serializeNode as i, CONST_REF_KEY as l, diagnose as m, loadScene as n, computeViewport as o, parseNodePath as p, Scene as r, resolveViewport as s, buildNodeJson as t, isConstRef as u, getBehavior as v, Signal as x, registerBehavior as y };
+export { Signal as C, registeredBehaviors as S, behaviorSchema as _, SCENE_FORMAT as a, getBehavior as b, SceneTree as c, resolveConstants as d, Node as f, Behavior as g, diagnose as h, serializeNode as i, CONST_REF_KEY as l, InputMap as m, loadScene as n, computeViewport as o, parseNodePath as p, Scene as r, resolveViewport as s, buildNodeJson as t, isConstRef as u, behaviorSignals as v, registerBehavior as x, clearBehaviors as y };

package/dist/net.d.ts

@@ -1,5 +1,5 @@
-import { at as Node, dt as Signal, l as PropSchema, v as Engine } from "./behavior-CKwTCjfR.js";
-import { c as JsonValue, i as SceneJson, s as JsonObject } from "./schema-CcoWb32N.js";
+import { Et as Signal, b as Engine, bt as Node, d as PropSchema } from "./behavior-CGSCWOHB.js";
+import { c as JsonValue, i as SceneJson, s as JsonObject } from "./schema-3ywbdlrv.js";
 
 //#region src/net/types.d.ts
 type Unsubscribe = () => void;

package/dist/net.js

@@ -1,9 +1,9 @@
-import { n as loadScene } from "./loader-Buk8Bu1h.js";
-import { h as Engine } from "./register-CscIzJEO.js";
+import { n as loadScene } from "./loader-Mig5fY4n.js";
+import { h as Engine } from "./register-BFLg0-_i.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as jsonClone } from "./json-BLk7H2Qa.js";
 import { n as createAgent8Server } from "./agent8-CvsfVskX.js";
-import { i as applySyncPatch, n as NetworkSpawner, r as NetworkManager, t as registerNodesNet } from "./register-CtI-itec.js";
+import { i as applySyncPatch, n as NetworkSpawner, r as NetworkManager, t as registerNodesNet } from "./register-BjbPMA5B.js";
 //#region src/net/loopback.ts
 /**
 * In-memory multiplayer hub implementing the SAME kernel contract as

package/dist/{particle-sim-CwJ5rI_P.d.ts → particle-sim-B-vZBF5R.d.ts}

@@ -1,4 +1,4 @@
-import { a as Rng } from "./schema-CcoWb32N.js";
+import { a as Rng } from "./schema-3ywbdlrv.js";
 
 //#region src/core/particle-sim.d.ts
 /**

package/dist/{pathfinding-DUw9mir9.d.ts → pathfinding-DgOo2KNF.d.ts}

@@ -1,4 +1,4 @@
-import { B as Listener, at as Node, l as PropSchema } from "./behavior-CKwTCjfR.js";
+import { bt as Node, d as PropSchema, tt as Listener } from "./behavior-CGSCWOHB.js";
 
 //#region src/core/nodes/audio-player.d.ts
 /**

package/dist/{physics-2d-DjXR5DMu.js → physics-2d-DqAclql-.js}

@@ -1,7 +1,7 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { m as diagnose } from "./loader-Buk8Bu1h.js";
+import { h as diagnose } from "./loader-Mig5fY4n.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
-import { _ as RigidBody2D, b as validateCollider2D, g as PhysicsBody2D, h as CharacterBody2D, m as Area2D, p as Joint2D, y as Node2D } from "./register-FIJtNbub.js";
+import { _ as RigidBody2D, b as validateCollider2D, g as PhysicsBody2D, h as CharacterBody2D, m as Area2D, p as Joint2D, y as Node2D } from "./register-DSmIRAf7.js";
 import { n as registerDebugSource } from "./debug-draw-BM3DsvtT.js";
 //#region src/2d/physics/physics-2d.ts
 var physics_2d_exports = /* @__PURE__ */ __exportAll({
@@ -334,16 +334,29 @@ var Physics2D = class {
 		const scene = this.engine.scene;
 		if (!scene) return;
 		const version = scene.tree._structureVersion;
-		const structureChanged = version !== this.lastStructure || scene.root !== this.lastRoot;
+		const sameRoot = scene.root === this.lastRoot;
+		const structureChanged = version !== this.lastStructure || !sameRoot;
 		if (structureChanged) {
+			const delta = sameRoot ? scene.tree._structureSince(this.lastStructure) : null;
 			this.lastStructure = version;
 			this.lastRoot = scene.root;
-			this.bodySet.clear();
-			collectBodies(scene.root, this.bodySet);
-		}
-		if (structureChanged) {
-			this.jointSet.clear();
-			collectJoints(scene.root, this.jointSet);
+			if (delta) {
+				let joints = false;
+				for (const { node, added } of delta) {
+					if (node instanceof PhysicsBody2D) if (added) this.bodySet.add(node);
+					else this.bodySet.delete(node);
+					if (node instanceof Joint2D) joints = true;
+				}
+				if (joints) {
+					this.jointSet.clear();
+					collectJoints(scene.root, this.jointSet);
+				}
+			} else {
+				this.bodySet.clear();
+				collectBodies(scene.root, this.bodySet);
+				this.jointSet.clear();
+				collectJoints(scene.root, this.jointSet);
+			}
 		}
 		const seen = this.bodySet;
 		for (const node of seen) {