incanto 0.66.0 → 0.68.0

package/dist/gameplay.d.ts

@@ -1,5 +1,5 @@
-import { b as Engine, d as PropSchema, jt as Node, n as BehaviorCtor, t as Behavior } from "./behavior-BXNLfIJk.js";
-import { c as JsonValue, s as JsonObject } from "./schema-CFeioQRE.js";
+import { b as Engine, d as PropSchema, jt as Node, n as BehaviorCtor, t as Behavior } from "./behavior-DoFPYrgo.js";
+import { c as JsonValue, s as JsonObject } from "./schema-B6ugCV1Q.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;
   /**
@@ -537,6 +558,20 @@ declare class SavePoint extends Behavior {
   private elapsed;
   private slots;
   private store;
+  /**
+  * Has this run already said the saves are going nowhere?
+  *
+  * `saved(slot)` is the engine's own instrument for "it saved", and it fired
+  * identically in a private window where the write landed in a Map that dies
+  * with the tab. In-session everything looked healthy — the slot read back,
+  * `slotScene()` answered — and across the reload the score went 5 to 0 and
+  * `list()` went `["1"]` to `[]`, with `engine.log.entries().length = 0` and
+  * `stats().errors = 0` in every phase. Byte-identical to a healthy control.
+  *
+  * So it goes through `engine.log`, not just the console: that is what
+  * `incanto-logs` reads and what the `says` rung reports.
+  */
+  private warnedVolatile;
   private pendingRestore;
   private pendingProbe;
   override onReady(): void;
@@ -1050,6 +1085,40 @@ declare class PathFollow extends Behavior {
   override update(dt: number): void;
 }
 //#endregion
+//#region src/gameplay/spatial.d.ts
+/**
+* A node's position with every spatial ancestor's added in.
+*
+* The tree composes transforms for DRAWING — three does it for free — and every
+* piece of engine logic that reads `node.position` gets the LOCAL number
+* instead. Physics already knew (`worldPosition2D`/`worldPosition3D` in the
+* adapters); the camera did not, and neither did anything that chases a target.
+*
+* A camera parented to the player is the Godot and Phaser idiom, and the
+* authoring skill explicitly permits it — *"EVERY node type can hold children …
+* any node works as a grouping container"*. Measured on exactly that scene:
+*
+* ```
+* player world position : [1400, 900]
+* renderer view centre  : {"x":0,"y":0}
+* framing               : camera /Level/Player/Cam centred [1400, 900]
+*                         1 in view, 0 outside it
+* ```
+*
+* The renderer drew empty world 1600 px from the player while `framing` — the
+* instrument the skills tell you to trust before handing a game back —
+* certified the player on screen.
+*
+* Arity comes from the node itself: a 2D node has two components, a 3D node
+* three, and an ancestor that is neither contributes nothing.
+*/
+declare function worldPosition(node: Node): number[];
+/**
+* Turn a world position into the local one `node.position` has to hold for the
+* node to END UP there — the inverse of `worldPosition` for its parent chain.
+*/
+declare function localFromWorld(node: Node, world: readonly number[]): number[];
+//#endregion
 //#region src/gameplay/index.d.ts
 /** Every built-in gameplay behavior, keyed by its registration name. */
 declare const GAMEPLAY_BEHAVIORS: Readonly<Record<string, BehaviorCtor>>;
@@ -1062,4 +1131,4 @@ declare function registerGameplayBehaviors(opts?: {
   replace?: boolean;
 }): void;
 //#endregion
-export { CameraShake, Chase, Collector, Cooldown, Currency, DamageOnContact, DayNight, type DayPhase, FaceTarget, FloatAway, FollowCamera, GAMEPLAY_BEHAVIORS, GameFlow, type GameFlowState, Health, Interactable, Lifetime, MoveTo, Oscillate, PathFollow, Patrol, Pickup, Projectile, SavePoint, ScoreKeeper, Spawner, Wander, WaveSpawner, ZombieAI, goToScene, hitStop, phaseOf, registerGameplayBehaviors, restartScene, screenFlash };
+export { CameraShake, Chase, Collector, Cooldown, Currency, DamageOnContact, DayNight, type DayPhase, FaceTarget, FloatAway, FollowCamera, GAMEPLAY_BEHAVIORS, GameFlow, type GameFlowState, Health, Interactable, Lifetime, MoveTo, Oscillate, PathFollow, Patrol, Pickup, Projectile, SavePoint, ScoreKeeper, Spawner, Wander, WaveSpawner, ZombieAI, goToScene, hitStop, localFromWorld, phaseOf, registerGameplayBehaviors, restartScene, screenFlash, worldPosition };

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";
-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 };
+import { A as DamageOnContact, C as restartScene, D as FaceTarget, E as FloatAway, F as localFromWorld, I as worldPosition, 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-DM1eu_cV.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, localFromWorld, phaseOf, registerGameplayBehaviors, restartScene, screenFlash, worldPosition };

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 { 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 { a as ParticleSimConfig, c as showBootFailure, i as ParticleSim, n as AudioPlayer, o as ParticleView, s as isWebGLAvailable, t as AudioElementLike } from "./audio-player-DOrq7sP-.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-DoFPYrgo.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-B6ugCV1Q.js";
+import { n as loadScene, t as LoadSceneOptions } from "./loader-CcB533FR.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 { 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-Dvn8aeBd.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`).
   */
@@ -1265,4 +1309,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 { type AnimationDef, type AnimationEntry, type AssetFailure, 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, type DriveScript, type DriveStep, type EffectEvent, type EffectKind, EffectLog, Engine, type EngineOptions, type EngineStats, type FindPathOptions, type GameStats, type GroupedLog, type HudAnchor, HudLayer, IncantoError, type IncantoErrorCode, type IncantoErrorDetails, InputMap, type JsonKind, type JsonObject, type JsonValue, type Listener, type LiveInput, type LiveReport, 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, type OrderGroupTable, 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 RefNode, type RefProblem, type RefResult, type RendererStats, type ReplayEvent, type ReplayJson, type ResolvedRendering, type ResolvedViewport, Respawn, 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, UiFrameCapSelect, UiImage, UiLanguageSelect, UiMuteToggle, UiPanel, UiQualitySelect, UiRenderScaleSelect, UiSelect, UiSlider, UiText, UiToggle, UiVolumeSlider, 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, 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 };
+export { type AnimationDef, type AnimationEntry, type AssetFailure, 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, type DriveScript, type DriveStep, type EffectEvent, type EffectKind, EffectLog, Engine, type EngineOptions, type EngineStats, type FindPathOptions, type GameStats, type GroupedLog, type HudAnchor, HudLayer, IncantoError, type IncantoErrorCode, type IncantoErrorDetails, InputMap, type JsonKind, type JsonObject, type JsonValue, type Listener, type LiveInput, type LiveReport, 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, type OrderGroupTable, 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 RefNode, type RefProblem, type RefResult, type RendererStats, type ReplayEvent, type ReplayJson, type ResolvedRendering, type ResolvedViewport, Respawn, 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, UiFrameCapSelect, UiImage, UiLanguageSelect, UiMuteToggle, UiPanel, UiQualitySelect, UiRenderScaleSelect, UiSelect, UiSlider, UiText, UiToggle, UiVolumeSlider, 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, describeRefProblem, duplicateNode, effectiveOrder, fadeGain, findPath, getBehavior, getNodeSchema, getNodeSignals, getNodeType, gridFromRows, isAudioContextAvailable, isConstRef, isWebGLAvailable, 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, showBootFailure, spatialGain, spatialPan, startRecording, suggestLocale, suggestQuality, synthSfx, translationKey };

package/dist/index.js

@@ -1,13 +1,15 @@
-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-BC4PNtJX.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-3ta-2Xig.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-CYvhVHHN.js";
+import { t as showBootFailure } from "./boot-failure-CKYrEcGF.js";
+import { a as logText, i as logReport, o as parseDrive, r as resolveRendering, t as isWebGLAvailable } from "./webgl-unavailable-N9nQqesw.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";
-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 };
+import { a as preloadUrls, i as preloadSceneAssets, n as newUid, o as findPath, r as assetUrls, s as gridFromRows, t as VERSION } from "./src-D7RIqXYF.js";
+import { t as duplicateNode } from "./duplicate-IWIqk0HJ.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, isWebGLAvailable, 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, showBootFailure, spatialGain, spatialPan, startRecording, suggestLocale, suggestQuality, synthSfx, translationKey };

package/dist/{loader-lQDCwNag.js → loader-BC4PNtJX.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);
@@ -1549,10 +1570,16 @@ function effectiveOrder(group, renderOrder, table = ORDER_GROUP_BASE) {
 //#endregion
 //#region src/core/save.ts
 const memoryStores = /* @__PURE__ */ new Map();
+/** Namespaces already warned about, so a per-frame save cannot spam the console. */
+const warnedVolatile = /* @__PURE__ */ new Set();
 function createSaveStore(namespace) {
 	const prefix = `incanto:${namespace}:`;
 	const local = storageOrNull();
 	if (!local) {
+		if (typeof localStorage !== "undefined" && !warnedVolatile.has(namespace)) {
+			warnedVolatile.add(namespace);
+			console.warn(`[incanto] this browser refused localStorage, so saves for '${namespace}' live in memory and are lost when the page closes (private window, storage disabled, or quota exhausted). Check \`store.persistent\` and tell the player.`);
+		}
 		let mem = memoryStores.get(namespace);
 		if (!mem) {
 			mem = /* @__PURE__ */ new Map();
@@ -1560,6 +1587,7 @@ function createSaveStore(namespace) {
 		}
 		const backing = mem;
 		return {
+			persistent: false,
 			get: (key, fallback) => parse(backing.get(key), fallback),
 			set: (key, value) => void backing.set(key, JSON.stringify(value)),
 			remove: (key) => void backing.delete(key),
@@ -1567,6 +1595,7 @@ function createSaveStore(namespace) {
 		};
 	}
 	return {
+		persistent: true,
 		get: (key, fallback) => parse(local.getItem(prefix + key) ?? void 0, fallback),
 		set: (key, value) => local.setItem(prefix + key, JSON.stringify(value)),
 		remove: (key) => local.removeItem(prefix + key),
@@ -1674,6 +1703,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,13 +1728,46 @@ 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) {
 	const out = [];
@@ -1779,6 +1842,17 @@ var SaveSlots = class {
 	constructor(namespace = "saves", store) {
 		this.store = store ?? createSaveStore(namespace);
 	}
+	/**
+	* Will these slots survive the page closing?
+	*
+	* `false` in a private window, with storage disabled, or headless — every
+	* write still succeeds and every read still answers, for as long as the tab
+	* lives. A load menu should say so instead of offering a slot that will not
+	* be there tomorrow.
+	*/
+	get persistent() {
+		return this.store.persistent !== false;
+	}
 	/** Slot ids that have a save, newest first. */
 	list() {
 		const rows = this.store.get(INDEX_KEY, []).map((id) => ({
@@ -2795,6 +2869,8 @@ var Scene = class {
 	orderGroups;
 	/** Physics config (gravity etc. — interpreted by the physics modules). */
 	physics;
+	/** Declared piece of another scene — see `SceneJson.fragment`. */
+	fragment;
 	/** Multiplayer config (room etc. — interpreted by incanto/net). */
 	multiplayer;
 	/** Design-resolution viewport (consumed by renderers via resolveViewport). */
@@ -2814,6 +2890,7 @@ var Scene = class {
 		this.orderGroups = source.orderGroups ? { ...source.orderGroups } : void 0;
 		this.strings = source.strings ? jsonClone(source.strings) : void 0;
 		this.physics = source.physics ? jsonClone(source.physics) : void 0;
+		this.fragment = source.fragment === true ? true : void 0;
 		this.multiplayer = source.multiplayer ? jsonClone(source.multiplayer) : void 0;
 		this.environment = source.environment ? jsonClone(source.environment) : void 0;
 		this.viewport = source.viewport ? jsonClone(source.viewport) : void 0;
@@ -2832,6 +2909,7 @@ var Scene = class {
 			...this.orderGroups ? { orderGroups: { ...this.orderGroups } } : {},
 			...this.strings ? { strings: jsonClone(this.strings) } : {},
 			...this.physics ? { physics: jsonClone(this.physics) } : {},
+			...this.fragment ? { fragment: true } : {},
 			...this.multiplayer ? { multiplayer: jsonClone(this.multiplayer) } : {},
 			...this.environment ? { environment: jsonClone(this.environment) } : {},
 			...this.viewport ? { viewport: jsonClone(this.viewport) } : {},
@@ -3004,9 +3082,11 @@ 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.");
+	if (json.fragment !== void 0 && typeof json.fragment !== "boolean") throw new IncantoError("BAD_FORMAT", `Scene "fragment" must be true or false, got ${JSON.stringify(json.fragment)}.`);
 	if (json.dimension !== void 0 && json.dimension !== "2d" && json.dimension !== "3d") throw new IncantoError("BAD_FORMAT", `Scene "dimension" must be "2d" or "3d", got ${JSON.stringify(json.dimension)}.`);
 	if (typeof json.root !== "object" || json.root === null) throw new IncantoError("BAD_FORMAT", "Scene \"root\" must be a node object.");
 	resolveViewport(json.viewport);
@@ -3042,9 +3122,101 @@ 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",
+	"fragment",
+	"root",
+	"connections"
+];
+/** Closest known key by edit distance — only a genuinely near 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/{loader-Cga7FVP4.d.ts → loader-CcB533FR.d.ts}

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

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-DoFPYrgo.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-DhrSzZIB.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-CYwDkbLF.js";
 export { LocalGameServer, LocalGameServerTransport, LoopbackHub, LoopbackTransport, NetworkManager, NetworkSpawner, applySyncPatch, createAgent8Server, createLocalGameServer, createSplitScreen, registerNodesNet };

package/dist/{physics-2d-Cji5A6sX.js → physics-2d-B7Y6dPZO.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-BC4PNtJX.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-ibCjm-wH.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;
 			}
 		}