incanto 0.66.0 → 0.67.0

package/dist/{gameplay-D1RADWu3.js → gameplay-CGSv-9XR.js}

@@ -1,7 +1,7 @@
-import { O as Node, P as Behavior, _ as SaveSlots, k as diagnose, n as loadScene, w as effectiveOrder, z as registerBehavior } from "./loader-lQDCwNag.js";
+import { O as Node, P as Behavior, _ as SaveSlots, k as diagnose, n as loadScene, w as effectiveOrder, z as registerBehavior } from "./loader-KZESOZmE.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as jsonClone } from "./json-CwwhxQgb.js";
-import { t as duplicateNode } from "./duplicate-CqSAtdrh.js";
+import { t as duplicateNode } from "./duplicate-B8QnX2-r.js";
 import { Color, CubeCamera, DepthTexture, DoubleSide, Euler, FloatType, Frustum, HalfFloatType, LinearMipmapLinearFilter, MathUtils, Matrix4, Mesh, MeshDepthMaterial, Object3D, PerspectiveCamera, Plane, PlaneGeometry, Quaternion, ShaderMaterial, Sphere, Vector2, Vector3, Vector4, WebGLCubeRenderTarget, WebGLRenderTarget } from "three";
 //#region src/3d/frustum.ts
 const scratchFrustum = new Frustum();
@@ -5016,11 +5016,19 @@ var Health = class extends Behavior {
 	* unlosable. Every checker was green on it, and `incanto-playtest` even
 	* reported `lost in 19/20` because a single `died` reads as a loss.
 	*
-	* Wire it where the life is spent:
+	* **Wire `reviveFull`, not this, to `lifeLost`.** `ScoreKeeper.loseLife()`
+	* emits `lifeLost` WITH the remaining life count, and this method's first
+	* parameter is the HP to come back at — so the documented recipe revived at
+	* 2 HP, then 1, then 0, and nothing warned (the wire-arity guard fires only
+	* when a handler is UNDER-fed, and `hp` is optional):
 	*
-	* ```json
-	* { "signal": "lifeLost", "from": "Score", "to": "Player", "handler": "revive" }
 	* ```
+	* death 1: lives=2  hp=2
+	* death 2: lives=1  hp=1
+	* death 3: lives=0  hp=0  dead=false   <- alive at zero HP
+	* ```
+	*
+	* Reach for `revive(hp)` when your game genuinely wants a partial comeback.
 	*
 	* A no-op on the living — reviving someone who never died would silently
 	* refill their health, which is a different feature and not this one.
@@ -5033,6 +5041,21 @@ var Health = class extends Behavior {
 		this.invulnTimer = this.invulnerableFor;
 		this.emit("revived", this.current);
 	}
+	/**
+	* Bring a dead one back at FULL health — the handler a life-lost wire wants.
+	*
+	* It exists because `revive` takes an optional `hp` and `lifeLost` carries the
+	* life count, so wiring the two silently made "you have 2 lives left" mean
+	* "come back at 2 HP". This takes no arguments, so no signal's payload can
+	* ever change what it means.
+	*
+	* ```json
+	* { "signal": "lifeLost", "from": "Score", "to": "Player", "handler": "reviveFull" }
+	* ```
+	*/
+	reviveFull() {
+		this.revive();
+	}
 	/** Drop to 0 and die immediately (ignores i-frames). */
 	kill() {
 		if (this.dead) return;

package/dist/gameplay.d.ts

@@ -1,4 +1,4 @@
-import { b as Engine, d as PropSchema, jt as Node, n as BehaviorCtor, t as Behavior } from "./behavior-BXNLfIJk.js";
+import { b as Engine, d as PropSchema, jt as Node, n as BehaviorCtor, t as Behavior } from "./behavior-ZnfzKDo3.js";
 import { c as JsonValue, s as JsonObject } from "./schema-CFeioQRE.js";
 
 //#region src/gameplay/chase.d.ts
@@ -143,16 +143,37 @@ declare class Health extends Behavior {
   * unlosable. Every checker was green on it, and `incanto-playtest` even
   * reported `lost in 19/20` because a single `died` reads as a loss.
   *
-  * Wire it where the life is spent:
+  * **Wire `reviveFull`, not this, to `lifeLost`.** `ScoreKeeper.loseLife()`
+  * emits `lifeLost` WITH the remaining life count, and this method's first
+  * parameter is the HP to come back at — so the documented recipe revived at
+  * 2 HP, then 1, then 0, and nothing warned (the wire-arity guard fires only
+  * when a handler is UNDER-fed, and `hp` is optional):
   *
-  * ```json
-  * { "signal": "lifeLost", "from": "Score", "to": "Player", "handler": "revive" }
   * ```
+  * death 1: lives=2  hp=2
+  * death 2: lives=1  hp=1
+  * death 3: lives=0  hp=0  dead=false   <- alive at zero HP
+  * ```
+  *
+  * Reach for `revive(hp)` when your game genuinely wants a partial comeback.
   *
   * A no-op on the living — reviving someone who never died would silently
   * refill their health, which is a different feature and not this one.
   */
   revive(hp?: number): void;
+  /**
+  * Bring a dead one back at FULL health — the handler a life-lost wire wants.
+  *
+  * It exists because `revive` takes an optional `hp` and `lifeLost` carries the
+  * life count, so wiring the two silently made "you have 2 lives left" mean
+  * "come back at 2 HP". This takes no arguments, so no signal's payload can
+  * ever change what it means.
+  *
+  * ```json
+  * { "signal": "lifeLost", "from": "Score", "to": "Player", "handler": "reviveFull" }
+  * ```
+  */
+  reviveFull(): void;
   /** Drop to 0 and die immediately (ignores i-frames). */
   kill(): void;
   /**

package/dist/gameplay.js

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

package/dist/index.d.ts

@@ -1,10 +1,10 @@
-import { $ as T_PREFIX, A as SettingsValues, At as BusName, B as captureBehaviors, C as EngineStats, Ct as sfxDuration, Dt as MusicTrack, E as DeviceHints, Et as MusicManager, F as BehaviorState, Ft as LogLevel, G as ORDER_GROUP_BASE, H as savesWithoutUid, I as RestoreReport, It as LogManager, J as effectiveOrder, K as OrderGroup, L as SaveSlot, Lt as Signal, M as readDeviceHints, Mt as NodeLifecycle, N as suggestQuality, Nt as SceneTree, O as QualityTier, Ot as PlayMusicOptions, P as Scene, Pt as LogEntry, Q as Localization, R as SaveSlots, Rt as SignalListener, S as Scheduler, St as SynthOptions, T as RendererStats, Tt as MusicBackend, U as SaveStore, V as restoreBehaviors, W as createSaveStore, X as BASE_LOCALE, Y as resolveOrderGroups, Z as LocaleTables, _ as mergeStaticSignals, _t as spatialPan, a as clearBehaviors, at as EffectLog, b as Engine, bt as SfxParams, c as registeredBehaviors, ct as isAudioContextAvailable, d as PropSchema, dt as Listener, et as suggestLocale, f as clearRegistry, ft as ROLLOFF_MODELS, g as getNodeType, gt as spatialGain, h as getNodeSignals, ht as Vec3, i as behaviorSignals, it as EffectKind, j as qualityEnvironment, jt as Node, k as Settings, kt as AudioBuses, l as NodeCtor, lt as Voice, m as getNodeSchema, mt as SpatialParams, n as BehaviorCtor, nt as InputMap, o as getBehavior, ot as SfxEngine, p as createNode, pt as RolloffModel, q as OrderGroupTable, r as behaviorSchema, rt as EffectEvent, s as registerBehavior, st as SfxPlayOptions, t as Behavior, tt as translationKey, u as PropDef, ut as VoicePreset, v as registerNode, vt as SFX_PRESETS, w as GameStats, wt as synthSfx, x as EngineOptions, xt as SfxWave, y as registeredTypes, yt as SFX_PRESET_NAMES, z as behaviorsWithoutSave } from "./behavior-BXNLfIJk.js";
+import { $ as T_PREFIX, A as SettingsValues, At as BusName, B as captureBehaviors, C as EngineStats, Ct as sfxDuration, Dt as MusicTrack, E as DeviceHints, Et as MusicManager, F as BehaviorState, Ft as LogLevel, G as ORDER_GROUP_BASE, H as savesWithoutUid, I as RestoreReport, It as LogManager, J as effectiveOrder, K as OrderGroup, L as SaveSlot, Lt as Signal, M as readDeviceHints, Mt as NodeLifecycle, N as suggestQuality, Nt as SceneTree, O as QualityTier, Ot as PlayMusicOptions, P as Scene, Pt as LogEntry, Q as Localization, R as SaveSlots, Rt as SignalListener, S as Scheduler, St as SynthOptions, T as RendererStats, Tt as MusicBackend, U as SaveStore, V as restoreBehaviors, W as createSaveStore, X as BASE_LOCALE, Y as resolveOrderGroups, Z as LocaleTables, _ as mergeStaticSignals, _t as spatialPan, a as clearBehaviors, at as EffectLog, b as Engine, bt as SfxParams, c as registeredBehaviors, ct as isAudioContextAvailable, d as PropSchema, dt as Listener, et as suggestLocale, f as clearRegistry, ft as ROLLOFF_MODELS, g as getNodeType, gt as spatialGain, h as getNodeSignals, ht as Vec3, i as behaviorSignals, it as EffectKind, j as qualityEnvironment, jt as Node, k as Settings, kt as AudioBuses, l as NodeCtor, lt as Voice, m as getNodeSchema, mt as SpatialParams, n as BehaviorCtor, nt as InputMap, o as getBehavior, ot as SfxEngine, p as createNode, pt as RolloffModel, q as OrderGroupTable, r as behaviorSchema, rt as EffectEvent, s as registerBehavior, st as SfxPlayOptions, t as Behavior, tt as translationKey, u as PropDef, ut as VoicePreset, v as registerNode, vt as SFX_PRESETS, w as GameStats, wt as synthSfx, x as EngineOptions, xt as SfxWave, y as registeredTypes, yt as SFX_PRESET_NAMES, z as behaviorsWithoutSave } from "./behavior-ZnfzKDo3.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-CFeioQRE.js";
-import { n as loadScene, t as LoadSceneOptions } from "./loader-Cga7FVP4.js";
+import { n as loadScene, t as LoadSceneOptions } from "./loader-DyT30ArB.js";
 import { i as resolveFrames, n as AnimationEntry, r as resolveAnimation, t as AnimationDef } from "./sprite-animation-CMr6f1K2.js";
-import { a as ParticleSimConfig, i as ParticleSim, n as AudioPlayer, o as ParticleView, t as AudioElementLike } from "./audio-player-_UAcHxnC.js";
+import { a as ParticleSimConfig, i as ParticleSim, n as AudioPlayer, o as ParticleView, t as AudioElementLike } from "./audio-player-BNUHo0JF.js";
 import { i as gridFromRows, n as PathGrid, r as findPath, t as FindPathOptions } from "./pathfinding-_fGrCFmH.js";
-import { a as startRecording, c as IncantoErrorDetails, i as replay, l as auditScene, n as ReplayEvent, o as IncantoError, r as ReplayJson, s as IncantoErrorCode, t as Recorder } from "./replay-BHoB6fCU.js";
+import { a as startRecording, c as IncantoErrorDetails, i as replay, l as auditScene, n as ReplayEvent, o as IncantoError, r as ReplayJson, s as IncantoErrorCode, t as Recorder } from "./replay-D0GcEHYU.js";
 
 //#region src/core/audio/crossfade.d.ts
 /**
@@ -313,8 +313,24 @@ declare class HudLayer extends Node {
   * play resumes.
   */
   private stepFocus;
-  /** Focusable widgets under this layer, in tree order. */
-  private focusables;
+  /**
+  * Focusable widgets under this layer, in tree order — **on screen only**.
+  *
+  * This filtered on each widget's OWN `visible` and recursed into hidden
+  * containers anyway, so arrow-keys walked into closed panels and Enter really
+  * pressed what it found. Measured on a title screen: 23 focus stops, 21 of
+  * them under an ancestor with `visible = false`, and
+  *
+  *   gold before = 150 -> Enter on the hidden Shop/Row0/Buy -> gold 120,
+  *   screen still 'title'
+  *
+  * The layer's own visibility was not a gate either. It is now: a HUD nobody
+  * can see has no ring, and a subtree nobody can see is not walked.
+  *
+  * PUBLIC, because a game that wants to know what its ring contains could not
+  * ask — and "why is focus on that" is exactly the question this answers.
+  */
+  focusables(): HudWidgetBase[];
   /** 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. */
@@ -377,6 +393,11 @@ declare abstract class HudWidgetBase extends Node {
   private host;
   override onExitTree(): void;
   override update(_dt: number): void;
+  /**
+  * The display this widget's own css asks for while shown — `grid` for a grid
+  * panel, `flex` for a row, `''` for a widget that never says.
+  */
+  private _shownDisplay;
   /** Which anchor slot this widget was mounted into. */
   private mountedAnchor;
   /**
@@ -607,6 +628,29 @@ declare class UiDialogue extends HudWidgetBase {
   /** Queue a line; optional `choices` renders buttons after the line types out. */
   say(speaker: string, text: string, choices?: string[]): void;
   /**
+  * A dialogue takes focus while it is up.
+  *
+  * It paints a focus ring and the generated reference advertises the prop, and
+  * it was inert: choices are raw DOM buttons inside the widget, so
+  * `HudLayer.focusables()` can never see them, and this class — unlike
+  * `UiButton` a hundred lines above it — never overrode `_activate`. Eleven
+  * keys and eight pad codes did nothing to a waiting choice while the same
+  * Enter pressed a sibling button. Native Tab worked, and is closed by any
+  * game that binds Tab; a pad has no Tab at all.
+  */
+  override focusable: boolean;
+  /** Which choice the keyboard/pad is on. Reset by every new line. */
+  private cursor;
+  /**
+  * Enter / A, and left / right between the options.
+  *
+  * `dir` is 0 for "activate" and ±1 for a nudge, the same shape `UiSelect`
+  * uses — so one key layout drives a menu, a slider and a conversation.
+  */
+  override _activate(dir: number): void;
+  /** Show which option the keyboard is on — a ring nobody can see is not one. */
+  private paintCursor;
+  /**
   * Player pressed "next": mid-typing reveals the whole line; a fully-typed
   * line without choices advances (choice lines wait for `choose`).
   */

package/dist/index.js

@@ -1,13 +1,14 @@
-import { A as describeRefProblem, B as registeredBehaviors, C as ORDER_GROUP_BASE, E as InputMap, F as behaviorSchema, I as behaviorSignals, L as clearBehaviors, M as resolveRefInJson, N as parseNodePath, O as Node, P as Behavior, R as getBehavior, S as createSaveStore, T as resolveOrderGroups, V as Signal, _ as SaveSlots, a as serializeNode, b as restoreBehaviors, d as computeViewport, f as resolveViewport, g as resolveConstants, h as isConstRef, i as Scene, j as nodeRefWarnings, m as CONST_REF_KEY, n as loadScene, o as SCENE_FORMAT, p as SceneTree, v as behaviorsWithoutSave, w as effectiveOrder, x as savesWithoutUid, y as captureBehaviors, z as registerBehavior } from "./loader-lQDCwNag.js";
-import { A as UiBanner, B as isAudioContextAvailable, D as EffectLog, E as LogManager, F as T_PREFIX, G as SFX_PRESET_NAMES, H as spatialGain, I as suggestLocale, J as MusicManager, K as sfxDuration, M as UiText, N as BASE_LOCALE, O as HudLayer, P as Localization, Q as AudioBuses, R as translationKey, S as qualityEnvironment, T as suggestQuality, U as spatialPan, V as ROLLOFF_MODELS, W as SFX_PRESETS, X as crossfadeGains, Y as WebAudioMusicBackend, Z as fadeGain, _ as AudioPlayer, a as UiMuteToggle, b as Settings, c as UiRenderScaleSelect, d as UiToggle, f as UiVolumeSlider, g as UiDialogue, h as UiButton, i as UiLanguageSelect, j as UiBar, l as UiSelect, m as Respawn, n as UiFrameCapSelect, o as UiPanel, p as Timer, q as synthSfx, r as UiImage, s as UiQualitySelect, t as registerCoreNodes, u as UiSlider, v as Engine, w as readDeviceHints, z as SfxEngine } from "./register-BmuqYTiY.js";
+import { A as describeRefProblem, B as registeredBehaviors, C as ORDER_GROUP_BASE, E as InputMap, F as behaviorSchema, I as behaviorSignals, L as clearBehaviors, M as resolveRefInJson, N as parseNodePath, O as Node, P as Behavior, R as getBehavior, S as createSaveStore, T as resolveOrderGroups, V as Signal, _ as SaveSlots, a as serializeNode, b as restoreBehaviors, d as computeViewport, f as resolveViewport, g as resolveConstants, h as isConstRef, i as Scene, j as nodeRefWarnings, m as CONST_REF_KEY, n as loadScene, o as SCENE_FORMAT, p as SceneTree, v as behaviorsWithoutSave, w as effectiveOrder, x as savesWithoutUid, y as captureBehaviors, z as registerBehavior } from "./loader-KZESOZmE.js";
+import { A as UiBanner, B as isAudioContextAvailable, D as EffectLog, E as LogManager, F as T_PREFIX, G as SFX_PRESET_NAMES, H as spatialGain, I as suggestLocale, J as MusicManager, K as sfxDuration, M as UiText, N as BASE_LOCALE, O as HudLayer, P as Localization, Q as AudioBuses, R as translationKey, S as qualityEnvironment, T as suggestQuality, U as spatialPan, V as ROLLOFF_MODELS, W as SFX_PRESETS, X as crossfadeGains, Y as WebAudioMusicBackend, Z as fadeGain, _ as AudioPlayer, a as UiMuteToggle, b as Settings, c as UiRenderScaleSelect, d as UiToggle, f as UiVolumeSlider, g as UiDialogue, h as UiButton, i as UiLanguageSelect, j as UiBar, l as UiSelect, m as Respawn, n as UiFrameCapSelect, o as UiPanel, p as Timer, q as synthSfx, r as UiImage, s as UiQualitySelect, t as registerCoreNodes, u as UiSlider, v as Engine, w as readDeviceHints, z as SfxEngine } from "./register-Cs53CY7s.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as Rng } from "./rng-DP-SR7eg.js";
 import { n as jsonEquals, r as jsonKind, t as jsonClone } from "./json-CwwhxQgb.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-CF70EArN.js";
-import { n as startRecording, r as auditScene, t as replay } from "./replay-IsZbNu6d.js";
-import { a as logReport, i as resolveRendering, n as attachTouchControls, o as logText, r as joystickVector, s as parseDrive, t as TouchControls } from "./touch-DESwnpOc.js";
+import { i as joystickVector, n as attachTouchControls, t as TouchControls } from "./touch-DEAmqGdf.js";
+import { n as startRecording, r as auditScene, t as replay } from "./replay-BkpDV51O.js";
+import { i as parseDrive, n as logReport, r as logText, t as resolveRendering } from "./rendering-options-ByAdi8PF.js";
 import { t as createNoise2D } from "./noise-CGUMx44x.js";
 import { a as PARTICLE_PRESETS, i as ParticleSim, n as resolveFrames, o as PARTICLE_PRESET_NAMES, s as applyParticlePreset, t as resolveAnimation } from "./sprite-animation-CY-mrr1L.js";
-import { a as preloadUrls, i as preloadSceneAssets, n as newUid, o as findPath, r as assetUrls, s as gridFromRows, t as VERSION } from "./src-BTLbXFPZ.js";
-import { t as duplicateNode } from "./duplicate-CqSAtdrh.js";
+import { a as preloadUrls, i as preloadSceneAssets, n as newUid, o as findPath, r as assetUrls, s as gridFromRows, t as VERSION } from "./src-BLlsGJW9.js";
+import { t as duplicateNode } from "./duplicate-B8QnX2-r.js";
 export { AudioBuses, AudioPlayer, BASE_LOCALE, Behavior, CONST_REF_KEY, EffectLog, Engine, HudLayer, IncantoError, InputMap, Localization, LogManager, MusicManager, Node, ORDER_GROUP_BASE, PARTICLE_PRESETS, PARTICLE_PRESET_NAMES, ParticleSim, ROLLOFF_MODELS, Respawn, Rng, SCENE_FORMAT, SFX_PRESETS, SFX_PRESET_NAMES, SaveSlots, Scene, SceneTree, Settings, SfxEngine, Signal, T_PREFIX, Timer, TouchControls, UiBanner, UiBar, UiButton, UiDialogue, UiFrameCapSelect, UiImage, UiLanguageSelect, UiMuteToggle, UiPanel, UiQualitySelect, UiRenderScaleSelect, UiSelect, UiSlider, UiText, UiToggle, UiVolumeSlider, VERSION, WebAudioMusicBackend, applyParticlePreset, assetUrls, attachTouchControls, auditScene, behaviorSchema, behaviorSignals, behaviorsWithoutSave, captureBehaviors, clearBehaviors, clearRegistry, computeViewport, createNode, createNoise2D, createSaveStore, crossfadeGains, describeRefProblem, duplicateNode, effectiveOrder, fadeGain, findPath, getBehavior, getNodeSchema, getNodeSignals, getNodeType, gridFromRows, isAudioContextAvailable, isConstRef, joystickVector, jsonClone, jsonEquals, jsonKind, loadScene, logReport, logText, mergeStaticSignals, newUid, nodeRefWarnings, parseDrive, parseNodePath, preloadSceneAssets, preloadUrls, qualityEnvironment, readDeviceHints, registerBehavior, registerCoreNodes, registerNode, registeredBehaviors, registeredTypes, replay, resolveAnimation, resolveConstants, resolveFrames, resolveOrderGroups, resolveRefInJson, resolveRendering, resolveViewport, restoreBehaviors, savesWithoutUid, serializeNode, sfxDuration, spatialGain, spatialPan, startRecording, suggestLocale, suggestQuality, synthSfx, translationKey };

package/dist/{loader-Cga7FVP4.d.ts → loader-DyT30ArB.d.ts}

@@ -1,4 +1,4 @@
-import { P as Scene, b as Engine } from "./behavior-BXNLfIJk.js";
+import { P as Scene, b as Engine } from "./behavior-ZnfzKDo3.js";
 import { i as SceneJson } from "./schema-CFeioQRE.js";
 
 //#region src/core/scene/loader.d.ts

package/dist/{loader-lQDCwNag.js → loader-KZESOZmE.js}

@@ -20,6 +20,17 @@ var Signal = class {
 	disconnectAll() {
 		this.connections.length = 0;
 	}
+	/**
+	* How many listeners are attached.
+	*
+	* A leak is a SLOPE, and a game had no way to see one: every check in this
+	* engine is a snapshot. A handler connected per frame and never disconnected,
+	* or a `once` that armed and never fired, accumulates invisibly and is
+	* perfectly healthy for the first thirty seconds of every playthrough.
+	*/
+	get count() {
+		return this.connections.length;
+	}
 	emit(...args) {
 		const snapshot = [...this.connections];
 		for (const conn of snapshot) {
@@ -652,6 +663,16 @@ var Node = class {
 	off(signal, fn) {
 		this._signals.get(signal)?.disconnect(fn);
 	}
+	/**
+	* How many listeners this node has on `signal` — 0 for one nobody watches.
+	*
+	* The engine's own leak test reads it, and so can a game: a handler connected
+	* every frame and never disconnected is invisible to every other check here,
+	* because every other check is a snapshot and a leak is a slope.
+	*/
+	listenerCount(signal) {
+		return this._signals.get(signal)?.count ?? 0;
+	}
 	emit(signal, ...args) {
 		this.assertDeclared(signal);
 		this._signals.get(signal)?.emit(...args);
@@ -1674,6 +1695,7 @@ const FREED_KEY = "#freed";
 function captureBehaviors(root, source) {
 	const state = {};
 	const unaddressable = [];
+	const unrecordable = [];
 	let saveable = 0;
 	const walk = (node) => {
 		const behavior = node.behavior;
@@ -1698,12 +1720,45 @@ function captureBehaviors(root, source) {
 		mark(root);
 		const freed = authoredUids(source).filter((uid) => !alive.has(uid));
 		if (freed.length > 0) state[FREED_KEY] = freed;
+		unrecordable.push(...goneWithoutUid(source, root));
 	}
 	return {
 		state,
 		unaddressable,
-		saveable
+		saveable,
+		unrecordable
+	};
+}
+/**
+* Authored nodes this run CONSUMED that the ledger cannot record.
+*
+* `#freed` is authored uids minus alive uids, so a node with no uid can never
+* enter it — it is silently omitted, and on load it comes back. Every collected
+* coin in a scene without uids returns, while the score that counted it does
+* not, and nothing says a word.
+*
+* A uid is the only stable handle (it survives a rename and a reparent), so the
+* engine must not guess a replacement — a saved PATH would point at whatever
+* node moved into that slot after the next edit. What it can do is notice, by
+* walking the authored tree and asking the live one whether each node is still
+* there. Reported, not repaired.
+*/
+function goneWithoutUid(source, root) {
+	const out = [];
+	const walk = (node, path) => {
+		if (typeof node !== "object" || node === null) return;
+		const n = node;
+		const name = typeof n.name === "string" ? n.name : "";
+		const here = path === "" ? name : `${path}/${name}`;
+		if (!(typeof n.uid === "string" && n.uid !== "") && here !== "" && path !== "") {
+			const live = root.getNodeOrNull(here.slice(here.indexOf("/") + 1));
+			const leaving = live ? live.tree?._isQueuedFree(live) ?? false : false;
+			if (!live || leaving) out.push(here);
+		}
+		if (Array.isArray(n.children)) for (const child of n.children) walk(child, here);
 	};
+	walk(source.root, "");
+	return out;
 }
 /** Every uid the scene FILE declares, in document order. */
 function authoredUids(source) {
@@ -3004,6 +3059,7 @@ function buildNodeJson(json, opts) {
 	return buildNode(json, opts, [], "", void 0);
 }
 function validateHeader(json) {
+	rejectUnknownKeys(json, SCENE_KEYS, "the scene", "");
 	if (json.format !== 1) throw new IncantoError("BAD_FORMAT", `Unsupported scene format ${JSON.stringify(json.format)}; this engine reads format 1.`);
 	if (json.type !== "scene") throw new IncantoError("BAD_FORMAT", `Expected "type": "scene", got ${JSON.stringify(json.type)}.`);
 	if (typeof json.name !== "string" || json.name === "") throw new IncantoError("BAD_FORMAT", "Scene \"name\" must be a non-empty string.");
@@ -3042,9 +3098,100 @@ function withNodeContext(e, path, nj) {
 	});
 	return e;
 }
+/**
+* Every key a node object may carry.
+*
+* The node object was an OPEN dictionary sitting between a dozen closed ones —
+* `props`, `environment`, `material`, `network` and the environment's own
+* sub-blocks all reject an unknown key with a did-you-mean. A node accepted
+* anything, and the one that costs an author a day is `connections`:
+*
+* ```jsonc
+* { "name": "Room", "type": "Node3D",
+*   "connections": [ … ],        // <- silently nothing
+*   "children": [ … ] }
+* ```
+*
+* `wireConnections` is reached from the scene header and from a sub-scene's own
+* header, and NOTHING reads `nodeJson.connections`. Measured on two scenes
+* differing only in which brace the same wire sits inside:
+*
+* ```
+* inside   Dst.n=0   validateScene.ok=true   auditWarnings=0
+* beside   Dst.n=1   validateScene.ok=true   auditWarnings=0
+* none     Dst.n=0   validateScene.ok=true   auditWarnings=0
+* ```
+*
+* The misplaced wire is bit-for-bit indistinguishable from deleting it. A
+* builder moved 28 of them into `root`, got `1/1 scene(s) valid` with zero
+* warnings, and found out sixty seconds later from `incanto-playtest`.
+*/
+const NODE_KEYS = [
+	"name",
+	"uid",
+	"type",
+	"instance",
+	"overrides",
+	"groups",
+	"tags",
+	"props",
+	"script",
+	"network",
+	"children"
+];
+/** Every key the scene HEADER may carry — closed for the same reason. */
+const SCENE_KEYS = [
+	"format",
+	"type",
+	"name",
+	"dimension",
+	"viewport",
+	"assets",
+	"constants",
+	"orderGroups",
+	"input",
+	"multiplayer",
+	"environment",
+	"strings",
+	"physics",
+	"root",
+	"connections"
+];
+/** Closest known key by edit distance — only a genuinely близкая one. */
+function nearestKey(key, known) {
+	const lower = key.toLowerCase();
+	let best = null;
+	let bestScore = 3;
+	for (const candidate of known) {
+		let d = 0;
+		const a = lower;
+		const b = candidate.toLowerCase();
+		const rows = Array.from({ length: a.length + 1 }, (_, i) => [i, ...Array(b.length).fill(0)]);
+		for (let j = 0; j <= b.length; j++) rows[0][j] = j;
+		for (let i = 1; i <= a.length; i++) for (let j = 1; j <= b.length; j++) {
+			const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+			rows[i][j] = Math.min(rows[i - 1][j] + 1, rows[i][j - 1] + 1, rows[i - 1][j - 1] + cost);
+		}
+		d = rows[a.length][b.length];
+		if (d < bestScore) {
+			bestScore = d;
+			best = candidate;
+		}
+	}
+	return best;
+}
+/** Reject a key the shape does not have, the way `props` already does. */
+function rejectUnknownKeys(obj, known, what, where) {
+	for (const key of Object.keys(obj)) {
+		if (known.includes(key)) continue;
+		const guess = nearestKey(key, known);
+		throw new IncantoError("BAD_FORMAT", `Unknown key "${key}" on ${what}${where ? ` '${where}'` : ""}.` + (guess ? ` Did you mean "${guess}"?` : "") + ` Valid keys: [${known.join(", ")}].` + (key === "connections" ? " Connections live on the SCENE, beside \"root\" — a node cannot carry them, and one placed here does exactly nothing." : ""), { validOptions: [...known] });
+	}
+}
 function buildNode(nj, opts, stack, parentPath, constants, bands = []) {
 	const path = `${parentPath}/${nj.name}`;
 	try {
+		rejectUnknownKeys(nj, NODE_KEYS, "node", nj.name ?? "");
 		if (nj.instance !== void 0 && nj.type !== void 0) throw new IncantoError("BAD_FORMAT", `Node '${nj.name}' declares both "type" and "instance" — they are mutually exclusive.`);
 		if (nj.instance !== void 0) return buildInstance(nj, opts, stack, path, constants, bands);
 		if (nj.type === void 0) throw new IncantoError("BAD_FORMAT", `Node '${nj.name}' must declare either "type" or "instance".`);

package/dist/net.d.ts

@@ -1,5 +1,5 @@
-import { d as PropSchema, jt as Node } from "./behavior-BXNLfIJk.js";
-import { a as NetworkManagerOptions, c as LocalGameServer, d as ServerClass, f as createLocalGameServer, g as Unsubscribe, h as NetworkTransport, i as NetworkManager, l as LocalGameServerOptions, m as LoopbackTransport, n as SplitScreenPlayer, o as applySyncPatch, p as LoopbackHub, r as createSplitScreen, s as CollectionOptions, t as SplitScreenOptions, u as LocalGameServerTransport } from "./split-screen-eJUFjhi1.js";
+import { d as PropSchema, jt as Node } from "./behavior-ZnfzKDo3.js";
+import { a as NetworkManagerOptions, c as LocalGameServer, d as ServerClass, f as createLocalGameServer, g as Unsubscribe, h as NetworkTransport, i as NetworkManager, l as LocalGameServerOptions, m as LoopbackTransport, n as SplitScreenPlayer, o as applySyncPatch, p as LoopbackHub, r as createSplitScreen, s as CollectionOptions, t as SplitScreenOptions, u as LocalGameServerTransport } from "./split-screen-DD5eYIgW.js";
 
 //#region src/net/agent8.d.ts
 /**

package/dist/net.js

@@ -1,3 +1,3 @@
 import { n as createAgent8Server } from "./agent8-CvsfVskX.js";
-import { a as NetworkManager, d as createLocalGameServer, f as LoopbackHub, l as LocalGameServer, n as registerNodesNet, o as applySyncPatch, p as LoopbackTransport, r as NetworkSpawner, t as createSplitScreen, u as LocalGameServerTransport } from "./split-screen-D_i7GRcY.js";
+import { a as NetworkManager, d as createLocalGameServer, f as LoopbackHub, l as LocalGameServer, n as registerNodesNet, o as applySyncPatch, p as LoopbackTransport, r as NetworkSpawner, t as createSplitScreen, u as LocalGameServerTransport } from "./split-screen-DS8RaUV_.js";
 export { LocalGameServer, LocalGameServerTransport, LoopbackHub, LoopbackTransport, NetworkManager, NetworkSpawner, applySyncPatch, createAgent8Server, createLocalGameServer, createSplitScreen, registerNodesNet };

package/dist/{physics-2d-Cji5A6sX.js → physics-2d-_B6zj3zU.js}

@@ -1,7 +1,7 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { k as diagnose } from "./loader-lQDCwNag.js";
+import { k as diagnose } from "./loader-KZESOZmE.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-D0CxCveZ.js";
+import { _ as RigidBody2D, b as validateCollider2D, g as PhysicsBody2D, h as CharacterBody2D, m as Area2D, p as Joint2D, y as Node2D } from "./register-vIxU3Xbv.js";
 import { n as registerDebugSource } from "./debug-draw-BM3DsvtT.js";
 import { n as jointContacts, t as withoutRapierInitNoise } from "./quiet-rapier-C6fW4zcW.js";
 //#region src/2d/physics/physics-2d.ts
@@ -66,6 +66,7 @@ var Physics2D = class {
 		this.unregisterDebug = registerDebugSource(this);
 		this.disconnect = engine.fixedUpdated.connect((dt) => this.step(dt));
 		this.disconnectScene = engine.sceneChanged.connect(() => {
+			this.pruneOverlaps();
 			if (engine.scene) this.syncBodies();
 		});
 		engine.physics = this;
@@ -306,6 +307,31 @@ var Physics2D = class {
 			if (set.size === 0) this.overlaps.delete(self);
 		}
 	}
+	/**
+	* Forget every overlap whose node has left the tree.
+	*
+	* The lazy drop inside `overlapping()` only cleans the SETS of a key someone
+	* asks about, and only when they ask. This clears the KEYS, which is where the
+	* dead nodes were pinned.
+	*/
+	/** Drop one node from the overlap map, both as a key and as a member. */
+	forgetOverlaps(node) {
+		this.overlaps.delete(node);
+		for (const [self, others] of this.overlaps) {
+			others.delete(node);
+			if (others.size === 0) this.overlaps.delete(self);
+		}
+	}
+	pruneOverlaps() {
+		for (const [self, others] of this.overlaps) {
+			if (self.tree === null) {
+				this.overlaps.delete(self);
+				continue;
+			}
+			for (const other of others) if (other.tree === null) others.delete(other);
+			if (others.size === 0) this.overlaps.delete(self);
+		}
+	}
 	/** The bodies currently overlapping `node`. Freed nodes are dropped on read. */
 	overlapping(node) {
 		const set = this.overlaps.get(node);
@@ -426,6 +452,7 @@ var Physics2D = class {
 				this.byColliderHandle.delete(e.collider.handle);
 				this.world.removeRigidBody(e.body);
 				this.entries.delete(node);
+				this.forgetOverlaps(node);
 				node._physics = null;
 			}
 		}

package/dist/{physics-3d-BkHjwJgI.js → physics-3d-i1IeAY0F.js}

@@ -1,10 +1,10 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { k as diagnose } from "./loader-lQDCwNag.js";
+import { k as diagnose } from "./loader-KZESOZmE.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
-import { H as CharacterBody3D, K as Node3D, U as PhysicsBody3D, V as Area3D, W as RigidBody3D, q as validateCollider3D } from "./gameplay-D1RADWu3.js";
+import { H as CharacterBody3D, K as Node3D, U as PhysicsBody3D, V as Area3D, W as RigidBody3D, q as validateCollider3D } from "./gameplay-CGSv-9XR.js";
 import { n as registerDebugSource } from "./debug-draw-BM3DsvtT.js";
 import { n as jointContacts, t as withoutRapierInitNoise } from "./quiet-rapier-C6fW4zcW.js";
-import { A as Terrain3D, F as InstancedMesh3D, L as buildMeshGeometry, P as Joint3D } from "./environment-presets-BlPsEmq6.js";
+import { A as Terrain3D, F as InstancedMesh3D, L as buildMeshGeometry, P as Joint3D } from "./environment-presets-C-5g2pMh.js";
 import { Euler, Matrix4, Quaternion, Vector3 } from "three";
 //#region src/3d/physics/collider-lines.ts
 /**
@@ -262,6 +262,7 @@ var Physics3D = class {
 		this.unregisterDebug = registerDebugSource(this);
 		this.disconnect = engine.fixedUpdated.connect((dt) => this.step(dt));
 		this.disconnectScene = engine.sceneChanged.connect(() => {
+			this.pruneOverlaps();
 			if (engine.scene) this.syncBodies();
 		});
 		engine.physics = this;
@@ -609,6 +610,7 @@ var Physics3D = class {
 				this.byColliderHandle.delete(e.collider.handle);
 				this.world.removeRigidBody(e.body);
 				this.entries.delete(node);
+				this.forgetOverlaps(node);
 				node._physics = null;
 				node._interpPrev = node._interpCurr = null;
 			}
@@ -824,6 +826,31 @@ var Physics3D = class {
 		}
 	}
 	/**
+	* Forget every overlap whose node has left the tree.
+	*
+	* The lazy drop inside `overlapping()` only cleans the SETS of a key someone
+	* asks about, and only when they ask. This clears the KEYS, which is where the
+	* dead nodes were pinned.
+	*/
+	/** Drop one node from the overlap map, both as a key and as a member. */
+	forgetOverlaps(node) {
+		this.overlaps.delete(node);
+		for (const [self, others] of this.overlaps) {
+			others.delete(node);
+			if (others.size === 0) this.overlaps.delete(self);
+		}
+	}
+	pruneOverlaps() {
+		for (const [self, others] of this.overlaps) {
+			if (self.tree === null) {
+				this.overlaps.delete(self);
+				continue;
+			}
+			for (const other of others) if (other.tree === null) others.delete(other);
+			if (others.size === 0) this.overlaps.delete(self);
+		}
+	}
+	/**
 	* The bodies currently overlapping `node` — the standing answer behind
 	* `triggerEnter`/`triggerExit`.
 	*

package/dist/react.d.ts

@@ -1,4 +1,4 @@
-import { P as Scene, b as Engine, n as BehaviorCtor } from "./behavior-BXNLfIJk.js";
+import { P as Scene, b as Engine, n as BehaviorCtor } from "./behavior-ZnfzKDo3.js";
 import { c as JsonValue } from "./schema-CFeioQRE.js";
 import { CSSProperties, ReactNode } from "react";
 

package/dist/react.js

@@ -156,7 +156,7 @@ function IncantoCanvas(props) {
 				pointer: latest.pointer,
 				...keyboard !== void 0 ? { keyboard } : {}
 			};
-			const next = await (_gameFactory ?? (mode === "3d" ? async (o) => (await import("./create-game-DYJCIzO0.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-Dd7H4bJV.js").then((n) => n.n)).createGame2D(o)))(opts);
+			const next = await (_gameFactory ?? (mode === "3d" ? async (o) => (await import("./create-game-FAXdHta3.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-DMetd3vR.js").then((n) => n.n)).createGame2D(o)))(opts);
 			if (disposed) {
 				next.dispose();
 				return;