incanto 0.32.0 → 0.33.0

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-CKwTCjfR.js";
 import { a as Rng, c as JsonValue, d as jsonKind, i as SceneJson, l as jsonClone, n as NodeJson, o as JsonKind, r as SCENE_FORMAT, s as JsonObject, t as ConnectionJson, u as jsonEquals } from "./schema-CcoWb32N.js";
-import { n as loadScene, t as LoadSceneOptions } from "./loader-BYBrqTxP.js";
+import { n as loadScene, t as LoadSceneOptions } from "./loader-COn5fS0o.js";
 import { n as ParticleSimConfig, r as ParticleView, t as ParticleSim } from "./particle-sim-CwJ5rI_P.js";
-import { a as AudioElementLike, i as gridFromRows, n as PathGrid, o as AudioPlayer, r as findPath, t as FindPathOptions } from "./pathfinding-BwhqPD3i.js";
+import { a as AudioElementLike, i as gridFromRows, n as PathGrid, o as AudioPlayer, r as findPath, t as FindPathOptions } from "./pathfinding-DUw9mir9.js";
 import { i as auditScene, n as IncantoErrorCode, r as IncantoErrorDetails, t as IncantoError } from "./errors-1dXlIwoR.js";
 
 //#region src/core/audio/crossfade.d.ts
@@ -151,6 +151,18 @@ declare abstract class HudWidgetBase extends Node {
   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;
+  /** The nearest ancestor that holds widgets itself (a UiPanel). */
+  private host;
   override onExitTree(): void;
   override update(_dt: number): void;
   protected _sync(): void;
@@ -305,6 +317,115 @@ 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;
+  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;
+  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;
+  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 +584,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 +708,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-Buk8Bu1h.js";
+import { A as MusicManager, C as isAudioContextAvailable, D as SFX_PRESETS, E as spatialPan, M as crossfadeGains, N as fadeGain, O as SFX_PRESET_NAMES, P as AudioBuses, S as SfxEngine, T as spatialGain, _ as qualityEnvironment, a as UiSlider, b as createSaveStore, c as UiButton, d as UiBanner, f as UiBar, g as Settings, h as Engine, i as UiSelect, j as WebAudioMusicBackend, k as synthSfx, l as UiDialogue, m as AudioPlayer, n as UiImage, o as UiToggle, p as UiText, r as UiPanel, s as Timer, t as registerCoreNodes, u as HudLayer, v as readDeviceHints, w as ROLLOFF_MODELS, x as LogManager, y as suggestQuality } from "./register-CscIzJEO.js";
 import { 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-BgnG1Lqz.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.33.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-Buk8Bu1h.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,23 @@ 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.
+	*/
+	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-COn5fS0o.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-CKwTCjfR.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-CKwTCjfR.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-Buk8Bu1h.js";
+import { h as Engine } from "./register-CscIzJEO.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-CtI-itec.js";
 //#region src/net/loopback.ts
 /**
 * In-memory multiplayer hub implementing the SAME kernel contract as

package/dist/{pathfinding-BwhqPD3i.d.ts → pathfinding-DUw9mir9.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-CKwTCjfR.js";
 
 //#region src/core/nodes/audio-player.d.ts
 /**

package/dist/{physics-2d-D9wquBvK.js → physics-2d-DjXR5DMu.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-Buk8Bu1h.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-FIJtNbub.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-DF8npb1O.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-Buk8Bu1h.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-BpQCbABv.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-CQtEGogB.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-CKwTCjfR.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-sFuTLqjD.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-D2QU5x7S.js").then((n) => n.n)).createGame2D(o)))(opts);
 			if (disposed) {
 				next.dispose();
 				return;