incanto 0.32.0 → 0.34.0

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-BftxM_It.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-BxFtmfSe.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,8 +1,8 @@
-import { $ as LogEntry, A as VoicePreset, B as SfxParams, C as RendererStats, D as SfxPlayOptions, E as SfxEngine, F as Vec3, G as MusicManager, H as SynthOptions, I as spatialGain, J as AudioBuses, K as MusicTrack, L as spatialPan, M as ROLLOFF_MODELS, N as RolloffModel, O as isAudioContextAvailable, P as SpatialParams, Q as SceneTree, R as SFX_PRESETS, S as GameStats, T as InputMap, U as synthSfx, V as SfxWave, W as MusicBackend, X as Node, Y as BusName, Z as NodeLifecycle, _ as registeredTypes, a as registerBehavior, b as Scheduler, c as PropDef, d as createNode, et as LogLevel, f as getNodeSchema, g as registerNode, h as mergeStaticSignals, i as getBehavior, j as Listener, k as Voice, l as PropSchema, m as getNodeType, n as BehaviorCtor, nt as Signal, o as registeredBehaviors, p as getNodeSignals, q as PlayMusicOptions, r as clearBehaviors, rt as SignalListener, s as NodeCtor, t as Behavior, tt as LogManager, u as clearRegistry, v as Engine, w as Scene, x as EngineStats, y as EngineOptions, z as SFX_PRESET_NAMES } from "./behavior-D_jMpFh8.js";
+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-CtPScDMo.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-BYBrqTxP.js";
+import { n as loadScene, t as LoadSceneOptions } from "./loader-DmXfj6Uv.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-BwhqPD3i.js";
+import { a as AudioElementLike, i as gridFromRows, n as PathGrid, o as AudioPlayer, r as findPath, t as FindPathOptions } from "./pathfinding-DRCe89SI.js";
 import { i as auditScene, n as IncantoErrorCode, r as IncantoErrorDetails, t as IncantoError } from "./errors-1dXlIwoR.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,19 +139,68 @@ 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;
   private layer;
   override onReady(): void;
+  /**
+  * @internal Build and attach, once a host exists.
+  *
+  * A widget inside a UiPanel mounts into the PANEL, not the layer's anchor
+  * slot — that is what turns structure in the tree into structure on screen,
+  * and it is what a menu is. Ready order does not decide it: the panel builds
+  * on demand when a child asks (`_container`), and `update` retries for
+  * 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;
@@ -232,6 +282,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;
@@ -305,6 +358,124 @@ declare class Timer extends Node {
   override update(dt: number): void;
 }
 //#endregion
+//#region src/core/nodes/ui-kit.d.ts
+/**
+* A box that holds other widgets — the thing a menu actually is.
+*
+* Widgets normally mount into their HudLayer's anchor slot, which is why a
+* "menu" used to be a flat pile of anchored items with no way to sit them in a
+* panel, space them, or lay them out in a grid. A `UiPanel` becomes the parent
+* for every widget under it, so structure in the TREE is structure on SCREEN.
+*
+* ```json
+* { "name": "Pause", "type": "UiPanel", "props": { "anchor": "center", "layout": "column", "gap": 12 },
+*   "children": [
+*     { "name": "Title", "type": "UiText", "props": { "text": "PAUSED", "size": 28 } },
+*     { "name": "Resume", "type": "UiButton", "props": { "label": "Resume" } }
+*   ] }
+* ```
+*/
+declare class UiPanel extends HudWidgetBase {
+  static override readonly typeName: string;
+  static override readonly props: PropSchema;
+  layout: "column" | "row" | "grid";
+  columns: number;
+  gap: number;
+  padding: number;
+  background: string;
+  radius: number;
+  width: number;
+  height: number;
+  border: string;
+  private lastKey;
+  protected _build(): HTMLElement;
+  /**
+  * @internal Children mount HERE, not in the layer's anchor slot.
+  *
+  * Builds on demand: a child asking for its host must not depend on whose
+  * `onReady` the tree happened to run first.
+  */
+  _container(): HTMLElement | null;
+  private css;
+  protected override _sync(): void;
+}
+/** A picture: an item icon, a portrait, a logo. `src` takes a url or `$assetKey`. */
+declare class UiImage extends HudWidgetBase {
+  static override readonly typeName: string;
+  static override readonly props: PropSchema;
+  src: string;
+  width: number;
+  height: number;
+  fit: "contain" | "cover" | "fill";
+  tint: string;
+  opacity: number;
+  private last;
+  protected _build(): HTMLElement;
+  private resolved;
+  private key;
+  private css;
+  protected override _sync(): void;
+}
+/**
+* A value the player sets — volume, sensitivity, difficulty.
+*
+* Emits `changed(value)`. `incanto-audio.md` promised "a settings slider needs
+* no extra wiring" while no slider existed; this is that slider.
+*/
+declare class UiSlider extends HudWidgetBase {
+  static override readonly typeName: string;
+  static override readonly props: PropSchema;
+  static override readonly signals: readonly string[];
+  label: string;
+  value: number;
+  min: number;
+  max: number;
+  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;
+  protected _build(): HTMLElement;
+  protected override _sync(): void;
+}
+/** An on/off switch — mute, invert-Y, fullscreen. Emits `changed(boolean)`. */
+declare class UiToggle extends HudWidgetBase {
+  static override readonly typeName: string;
+  static override readonly props: PropSchema;
+  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;
+  protected override _sync(): void;
+}
+/** One of several — quality, resolution, language. Emits `changed(value)`. */
+declare class UiSelect extends HudWidgetBase {
+  static override readonly typeName: string;
+  static override readonly props: PropSchema;
+  static override readonly signals: readonly string[];
+  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 lastOptions;
+  private last;
+  protected _build(): HTMLElement;
+  private fillOptions;
+  protected override _sync(): void;
+}
+//#endregion
 //#region src/core/noise.d.ts
 /**
 * Seeded 2D simplex noise (Ken Perlin's simplex, Gustavson's reference
@@ -463,25 +634,6 @@ declare function replay(engine: Engine, recording: ReplayJson, opts?: {
   onTick?: (index: number) => void;
 }): void;
 //#endregion
-//#region src/core/save.d.ts
-/**
-* Namespaced game persistence — high scores, unlocks, settings. localStorage
-* in the browser, in-memory headless (tests and SSR stay green). Values are
-* JSON round-tripped, so what you get back is what you saved.
-*
-*   const save = createSaveStore('my-game');
-*   save.set('highScore', 4200);
-*   const best = save.get('highScore', 0);
-*/
-interface SaveStore {
-  get<T extends JsonValue>(key: string, fallback: T): T;
-  set(key: string, value: JsonValue): void;
-  remove(key: string): void;
-  /** Wipe THIS namespace only. */
-  clear(): void;
-}
-declare function createSaveStore(namespace: string): SaveStore;
-//#endregion
 //#region src/core/scene/constants.d.ts
 /** The single reserved key marking a prop value as a constant reference. */
 declare const CONST_REF_KEY = "@const";
@@ -606,4 +758,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, 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, 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, SfxEngine, type SfxParams, type SfxPlayOptions, type SfxWave, Signal, type SignalListener, type SpatialParams, type SynthOptions, Timer, TouchControls, type TouchControlsOptions, UiBanner, UiBar, UiButton, UiDialogue, UiText, 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, registerBehavior, registerCoreNodes, registerNode, registeredBehaviors, registeredTypes, replay, resolveConstants, resolveRendering, resolveViewport, serializeNode, spatialGain, spatialPan, startRecording, synthSfx };
+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 };

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-BlaRQGaA.js";
-import { C as fadeGain, S as crossfadeGains, _ as SFX_PRESETS, a as HudLayer, b as MusicManager, c as UiText, d as LogManager, f as SfxEngine, g as spatialPan, h as spatialGain, i as UiDialogue, l as AudioPlayer, m as ROLLOFF_MODELS, n as Timer, o as UiBanner, p as isAudioContextAvailable, r as UiButton, s as UiBar, t as registerCoreNodes, u as Engine, v as SFX_PRESET_NAMES, w as AudioBuses, x as WebAudioMusicBackend, y as synthSfx } from "./register-Dzkd6-os.js";
+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-BwR0DxeM.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-G3edsjJ2.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 { 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-KRPtUtzl.js";
+import { n as ORDER_GROUP_BASE, r as effectiveOrder, t as duplicateNode } from "./duplicate-DlOvknDO.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
@@ -225,59 +225,6 @@ function replay(engine, recording, opts) {
 	}
 }
 //#endregion
-//#region src/core/save.ts
-const memoryStores = /* @__PURE__ */ new Map();
-function createSaveStore(namespace) {
-	const prefix = `incanto:${namespace}:`;
-	const local = storageOrNull();
-	if (!local) {
-		let mem = memoryStores.get(namespace);
-		if (!mem) {
-			mem = /* @__PURE__ */ new Map();
-			memoryStores.set(namespace, mem);
-		}
-		const backing = mem;
-		return {
-			get: (key, fallback) => parse(backing.get(key), fallback),
-			set: (key, value) => void backing.set(key, JSON.stringify(value)),
-			remove: (key) => void backing.delete(key),
-			clear: () => backing.clear()
-		};
-	}
-	return {
-		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),
-		clear: () => {
-			const doomed = [];
-			for (let i = 0; i < local.length; i++) {
-				const k = local.key(i);
-				if (k?.startsWith(prefix)) doomed.push(k);
-			}
-			for (const k of doomed) local.removeItem(k);
-		}
-	};
-}
-function parse(raw, fallback) {
-	if (raw === void 0 || raw === null) return fallback;
-	try {
-		return JSON.parse(raw);
-	} catch {
-		return fallback;
-	}
-}
-function storageOrNull() {
-	try {
-		if (typeof localStorage === "undefined") return null;
-		const probe = "__incanto_probe__";
-		localStorage.setItem(probe, "1");
-		localStorage.removeItem(probe);
-		return localStorage;
-	} catch {
-		return null;
-	}
-}
-//#endregion
 //#region src/core/uid-gen.ts
 /**
 * The ONE way to mint a node uid: crypto-strength, `n_` + 16 base36 chars
@@ -295,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.32.0";
+const VERSION = "0.34.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, SfxEngine, Signal, Timer, TouchControls, UiBanner, UiBar, UiButton, UiDialogue, UiText, 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, registerBehavior, registerCoreNodes, registerNode, registeredBehaviors, registeredTypes, replay, resolveConstants, resolveRendering, resolveViewport, serializeNode, spatialGain, spatialPan, startRecording, synthSfx };
+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 };

package/dist/{loader-BlaRQGaA.js → loader-BwR0DxeM.js}

@@ -141,6 +141,40 @@ var InputMap = class {
 	declare(decls) {
 		for (const [name, action] of parseInputDecls(decls)) this.actions.set(name, action);
 	}
+	/**
+	* Where the pointer is, in CANVAS pixels (top-left origin), or null when it
+	* has never been over the canvas.
+	*
+	* This is what a click-driven game asks for. `pointerDelta()` answers "how far
+	* did the mouse move" — the mouse-look question — and for a whole class of
+	* genres that is the wrong question and the only one the engine could answer.
+	* Pair it with `renderer.pick(x, y)` to get the node under the cursor.
+	*/
+	pointerPosition() {
+		return this.pointerPos ? { ...this.pointerPos } : null;
+	}
+	/**
+	* @internal Feed a pointer position. `target` scales client → canvas pixels
+	* so a CSS-stretched canvas still reports coordinates its renderer can use.
+	*/
+	setPointerPosition(clientX, clientY, target) {
+		const rect = target?.getBoundingClientRect?.();
+		if (!rect || rect.width === 0 || rect.height === 0) {
+			this.pointerPos = {
+				x: clientX,
+				y: clientY
+			};
+			return;
+		}
+		const el = target;
+		const scaleX = typeof el.width === "number" && el.width > 0 ? el.width / rect.width : 1;
+		const scaleY = typeof el.height === "number" && el.height > 0 ? el.height / rect.height : 1;
+		this.pointerPos = {
+			x: (clientX - rect.left) * scaleX,
+			y: (clientY - rect.top) * scaleY
+		};
+	}
+	pointerPos = null;
 	/** Feed a key state change (code = KeyboardEvent.code, e.g. 'Space', 'KeyW'). */
 	handleKey(code, isDown) {
 		if (isDown) {
@@ -318,6 +352,7 @@ var InputMap = class {
 		let buttonsHeld = 0;
 		const onDown = (e) => {
 			buttonsHeld++;
+			this.setPointerPosition(e.clientX, e.clientY, target);
 			this.handleMouseButton(e.button, true);
 			if (opts?.lockOnClick && document.pointerLockElement !== target) target.requestPointerLock?.();
 		};
@@ -326,6 +361,7 @@ var InputMap = class {
 			this.handleMouseButton(e.button, false);
 		};
 		const onMove = (e) => {
+			this.setPointerPosition(e.clientX, e.clientY, target);
 			if (document.pointerLockElement === target || buttonsHeld > 0) this.handlePointerMove(e.movementX, e.movementY);
 		};
 		const onWheel = (e) => {
@@ -409,6 +445,36 @@ var InputMap = class {
 	justReleased(action) {
 		return this.button(action).keys.some((k) => this.releasedEdge.has(k)) || this.injectedReleased.has(action);
 	}
+	/**
+	* Mouse button state WITHOUT declaring an action for it.
+	*
+	* A click on a tile is not a bindable action — there is no key to remap, and
+	* asking a match-3 to declare `"click": { "keys": ["Mouse0"] }` in every scene
+	* 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}`);
+	}
+	mouseJustPressed(button = 0) {
+		return this.pressedEdge.has(`Mouse${button}`);
+	}
+	mouseJustReleased(button = 0) {
+		return this.releasedEdge.has(`Mouse${button}`);
+	}
 	/** Normalized direction for a vector2 action (y-down: up = -y). */
 	getVector(action) {
 		const def = this.get(action);

package/dist/{loader-BYBrqTxP.d.ts → loader-DmXfj6Uv.d.ts}

@@ -1,4 +1,4 @@
-import { v as Engine, w as Scene } from "./behavior-D_jMpFh8.js";
+import { N as Scene, v as Engine } from "./behavior-CtPScDMo.js";
 import { i as SceneJson } from "./schema-CcoWb32N.js";
 
 //#region src/core/scene/loader.d.ts

package/dist/net.d.ts

@@ -1,4 +1,4 @@
-import { X as Node, l as PropSchema, nt as Signal, v as Engine } from "./behavior-D_jMpFh8.js";
+import { at as Node, dt as Signal, l as PropSchema, v as Engine } from "./behavior-CtPScDMo.js";
 import { c as JsonValue, i as SceneJson, s as JsonObject } from "./schema-CcoWb32N.js";
 
 //#region src/net/types.d.ts

package/dist/net.js

@@ -1,9 +1,9 @@
-import { n as loadScene } from "./loader-BlaRQGaA.js";
-import { u as Engine } from "./register-Dzkd6-os.js";
+import { n as loadScene } from "./loader-BwR0DxeM.js";
+import { h as Engine } from "./register-G3edsjJ2.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-CUY284Is.js";
+import { i as applySyncPatch, n as NetworkSpawner, r as NetworkManager, t as registerNodesNet } from "./register-OodmuUMK.js";
 //#region src/net/loopback.ts
 /**
 * In-memory multiplayer hub implementing the SAME kernel contract as

package/dist/{pathfinding-BwhqPD3i.d.ts → pathfinding-DRCe89SI.d.ts}

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

package/dist/{physics-2d-D9wquBvK.js → physics-2d-BuyAwsW5.js}

@@ -1,7 +1,7 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { m as diagnose } from "./loader-BlaRQGaA.js";
+import { m as diagnose } from "./loader-BwR0DxeM.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-tkR_8tWg.js";
+import { _ as RigidBody2D, b as validateCollider2D, g as PhysicsBody2D, h as CharacterBody2D, m as Area2D, p as Joint2D, y as Node2D } from "./register-BLPC10Mj.js";
 import { n as registerDebugSource } from "./debug-draw-BM3DsvtT.js";
 //#region src/2d/physics/physics-2d.ts
 var physics_2d_exports = /* @__PURE__ */ __exportAll({
@@ -153,6 +153,16 @@ var Physics2D = class {
 			y: t.y + corrected.y
 		});
 		node._grounded = this.kcc.computedGrounded();
+		node._onWall = 0;
+		node._onCeiling = false;
+		const hits = this.kcc.numComputedCollisions();
+		for (let i = 0; i < hits; i++) {
+			const n = this.kcc.computedCollision(i)?.normal1;
+			if (!n) continue;
+			if (Math.abs(n.y) > .7) {
+				if (!node._grounded) node._onCeiling = true;
+			} else if (Math.abs(n.x) > .7) node._onWall = n.x > 0 ? -1 : 1;
+		}
 		if (node._grounded) {
 			const footX = (t.x + corrected.x) * SCALE;
 			const footY = (t.y + corrected.y) * SCALE + charHalfHeight(node) - 2;

package/dist/{physics-3d-CnPygVGo.js → physics-3d-C8Kn_Nyb.js}

@@ -1,9 +1,9 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { m as diagnose } from "./loader-BlaRQGaA.js";
+import { m as diagnose } from "./loader-BwR0DxeM.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
-import { F as PhysicsBody3D, I as RigidBody3D, N as Area3D, P as CharacterBody3D, R as Node3D, z as validateCollider3D } from "./gameplay-BftxM_It.js";
+import { F as PhysicsBody3D, I as RigidBody3D, N as Area3D, P as CharacterBody3D, R as Node3D, z as validateCollider3D } from "./gameplay-BxFtmfSe.js";
 import { n as registerDebugSource } from "./debug-draw-BM3DsvtT.js";
-import { A as Terrain3D, F as InstancedMesh3D, L as buildMeshGeometry, P as Joint3D } from "./environment-presets--DigHNg4.js";
+import { A as Terrain3D, F as InstancedMesh3D, L as buildMeshGeometry, P as Joint3D } from "./environment-presets-B6WiUsaO.js";
 import { Euler, Matrix4, Quaternion, Vector3 } from "three";
 //#region src/3d/physics/collider-lines.ts
 /**
@@ -376,20 +376,53 @@ var Physics3D = class {
 		if (node.snapToGround && vy <= 0) this.kcc.enableSnapToGround(.1);
 		else this.kcc.disableSnapToGround();
 		this.kcc.setMaxSlopeClimbAngle(node.slopeLimitDeg * DEG);
+		let carryX = 0;
+		let carryY = 0;
+		let carryZ = 0;
+		if (e.ground && e.ground._physics === this && e.groundAt) {
+			const [gx, gy, gz] = worldPosition3D(e.ground);
+			carryX = gx - e.groundAt[0];
+			carryY = gy - e.groundAt[1];
+			carryZ = gz - e.groundAt[2];
+		} else e.ground = null;
 		const desired = {
-			x: (node.velocity[0] ?? 0) * this.lastDt,
-			y: vy * this.lastDt,
-			z: (node.velocity[2] ?? 0) * this.lastDt
+			x: (node.velocity[0] ?? 0) * this.lastDt + carryX,
+			y: vy * this.lastDt + carryY,
+			z: (node.velocity[2] ?? 0) * this.lastDt + carryZ
 		};
 		this.kcc.computeColliderMovement(e.collider, desired, this.R.QueryFilterFlags.EXCLUDE_SENSORS);
 		const c = this.kcc.computedMovement();
 		const t = e.body.translation();
+		const nx = t.x + c.x;
+		const ny = t.y + c.y;
+		const nz = t.z + c.z;
 		e.body.setNextKinematicTranslation({
-			x: t.x + c.x,
-			y: t.y + c.y,
-			z: t.z + c.z
+			x: nx,
+			y: ny,
+			z: nz
 		});
 		node._grounded = this.kcc.computedGrounded();
+		if (node._grounded) {
+			const half = characterHalfHeight(node);
+			const hit = this.castRay([
+				nx,
+				ny - half + .05,
+				nz
+			], [
+				0,
+				-1,
+				0
+			], .4, node);
+			if (hit?.node && !(hit.node instanceof CharacterBody3D)) {
+				e.ground = hit.node;
+				const at = worldPosition3D(hit.node);
+				e.groundAt = [
+					at[0],
+					at[1],
+					at[2]
+				];
+			} else e.ground = null;
+		} else e.ground = null;
 	}
 	/** Rapier debug segments (meters). Null while debugDraw is off. */
 	debugLines() {
@@ -900,6 +933,19 @@ const posScratch = [
 	0
 ];
 /** Writes into the shared scratch — consume before the next call. */
+/**
+* Half the character's own height, for placing a ground probe just inside its
+* feet. Falls back to a metre — a probe an inch out of place misses a platform,
+* and a body with no declared size is not a case worth guessing hard about.
+*/
+function characterHalfHeight(node) {
+	const collider = node.collider;
+	if (!collider) return 1;
+	if (collider.shape === "capsule" && typeof collider.height === "number") return collider.height / 2 + (collider.radius ?? 0);
+	if (collider.shape === "box" && Array.isArray(collider.size)) return (collider.size[1] ?? 2) / 2;
+	if (collider.shape === "sphere" && typeof collider.radius === "number") return collider.radius;
+	return 1;
+}
 function worldPosition3D(node) {
 	let x = 0;
 	let y = 0;

package/dist/react.d.ts

@@ -1,4 +1,4 @@
-import { n as BehaviorCtor, v as Engine, w as Scene } from "./behavior-D_jMpFh8.js";
+import { N as Scene, n as BehaviorCtor, v as Engine } from "./behavior-CtPScDMo.js";
 import { c as JsonValue } from "./schema-CcoWb32N.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-gXI7PYl0.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-bKHgHcsZ.js").then((n) => n.n)).createGame2D(o)))(opts);
+			const next = await (_gameFactory ?? (mode === "3d" ? async (o) => (await import("./create-game-QTfghzwM.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-CFNqoqOX.js").then((n) => n.n)).createGame2D(o)))(opts);
 			if (disposed) {
 				next.dispose();
 				return;