incanto 0.30.0 → 0.32.0

package/dist/{register-BTg0EM7s.js → register-Dzkd6-os.js}

@@ -1,7 +1,7 @@
-import { f as Node, y as Signal } from "./loader-BZqOKfI2.js";
+import { f as Node, h as InputMap, x as Signal } from "./loader-BlaRQGaA.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as Rng } from "./rng-DP-SR7eg.js";
-import { l as registerNode } from "./registry-BVJ2HbCn.js";
+import { l as registerNode } from "./registry-CJdGpT2V.js";
 //#region src/core/audio/buses.ts
 /**
 * Global volume state — `master` × `sfx`/`music` gain (0..1) plus a `muted`
@@ -960,381 +960,6 @@ var FrameStatsRing = class {
 	}
 };
 //#endregion
-//#region src/core/input.ts
-/** Keys typed into editable elements belong to the page UI, not the game. */
-function isEditableTarget(target) {
-	const el = target;
-	return !!el && (el.isContentEditable === true || el.tagName === "INPUT" || el.tagName === "TEXTAREA" || el.tagName === "SELECT");
-}
-/**
-* Declarative input from scene JSON `input{}` — DOM-free logic (feed key state
-* via `handleKey`, or wire a browser with `attachKeyboard(window)`).
-*
-* Convention: vector2 follows the 2D y-down space (up = -y). `justPressed` /
-* `justReleased` are one-frame edges, settled by the Engine each tick.
-*/
-var InputMap = class {
-	actions = /* @__PURE__ */ new Map();
-	down = /* @__PURE__ */ new Set();
-	pressedEdge = /* @__PURE__ */ new Set();
-	releasedEdge = /* @__PURE__ */ new Set();
-	detach = null;
-	/** Load (or extend with) scene-JSON action declarations. Hard-validates shape. */
-	declare(decls) {
-		for (const [name, raw] of Object.entries(decls)) {
-			const decl = raw;
-			if (decl.type === "button") {
-				const keys = decl.keys;
-				if (!Array.isArray(keys) || keys.some((k) => typeof k !== "string")) throw new IncantoError("BAD_FORMAT", `Input action '${name}': button "keys" must be an array of KeyboardEvent.code strings.`);
-				if (decl.touch !== void 0 && decl.touch !== "button") throw new IncantoError("BAD_FORMAT", `Input action '${name}': button "touch" must be 'button', got ${JSON.stringify(decl.touch)}.`);
-				this.actions.set(name, {
-					type: "button",
-					keys: [...keys],
-					...decl.touch === "button" ? { touch: "button" } : {}
-				});
-			} else if (decl.type === "vector2") {
-				const dirs = decl.keys;
-				for (const dir of [
-					"up",
-					"down",
-					"left",
-					"right"
-				]) if (!Array.isArray(dirs?.[dir])) throw new IncantoError("BAD_FORMAT", `Input action '${name}': vector2 "keys" needs arrays for up/down/left/right.`);
-				if (decl.touch !== void 0 && decl.touch !== "joystick") throw new IncantoError("BAD_FORMAT", `Input action '${name}': vector2 "touch" must be 'joystick', got ${JSON.stringify(decl.touch)}.`);
-				const d = dirs;
-				this.actions.set(name, {
-					type: "vector2",
-					keys: {
-						up: [...d.up],
-						down: [...d.down],
-						left: [...d.left],
-						right: [...d.right]
-					},
-					...decl.touch === "joystick" ? { touch: "joystick" } : {}
-				});
-			} else throw new IncantoError("BAD_FORMAT", `Input action '${name}': "type" must be 'button' or 'vector2', got ${JSON.stringify(decl.type)}.`);
-		}
-	}
-	/** Feed a key state change (code = KeyboardEvent.code, e.g. 'Space', 'KeyW'). */
-	handleKey(code, isDown) {
-		if (isDown) {
-			if (!this.down.has(code)) {
-				this.down.add(code);
-				this.pressedEdge.add(code);
-			}
-		} else if (this.down.has(code)) {
-			this.down.delete(code);
-			this.releasedEdge.add(code);
-		}
-	}
-	injectedDown = /* @__PURE__ */ new Set();
-	injectedPressed = /* @__PURE__ */ new Set();
-	injectedReleased = /* @__PURE__ */ new Set();
-	injectedVectors = /* @__PURE__ */ new Map();
-	/**
-	* Press a button ACTION directly — no key codes involved. This is how
-	* scripted gameplay tests and touch buttons drive the game by intent
-	* (`press('jump')`) instead of reverse-engineering keybinds.
-	*/
-	pressAction(action) {
-		this.button(action);
-		if (!this.injectedDown.has(action)) {
-			this.injectedDown.add(action);
-			this.injectedPressed.add(action);
-		}
-	}
-	/** Release an injected button action (yields one justReleased frame). */
-	releaseAction(action) {
-		this.button(action);
-		if (this.injectedDown.delete(action)) this.injectedReleased.add(action);
-	}
-	/**
-	* Feed an analog direction for a vector2 ACTION — virtual joysticks and
-	* scripted runs. Persists until replaced; (0, 0) clears the injection.
-	* Combines with key state in getVector (clamped to unit length).
-	*/
-	setActionVector(action, x, y) {
-		if (this.get(action).type !== "vector2") throw new IncantoError("BAD_FORMAT", `Input action '${action}' is a button — use pressAction/releaseAction, not setActionVector.`);
-		if (!Number.isFinite(x) || !Number.isFinite(y)) throw new IncantoError("BAD_FORMAT", `setActionVector('${action}') needs finite numbers, got (${x}, ${y}).`);
-		if (x === 0 && y === 0) this.injectedVectors.delete(action);
-		else this.injectedVectors.set(action, {
-			x,
-			y
-		});
-	}
-	/**
-	* Actions the scene wants on-screen touch controls for, in declaration
-	* order (`"touch": "joystick"` on vector2, `"touch": "button"` on buttons).
-	* The touch overlay (core/touch.ts) renders these.
-	*/
-	touchControls() {
-		const out = [];
-		for (const [name, def] of this.actions) if (def.touch) out.push({
-			action: name,
-			kind: def.touch
-		});
-		return out;
-	}
-	/** Drop all injected action state (held buttons, vectors, pending edges). */
-	clearInjected() {
-		this.injectedDown.clear();
-		this.injectedPressed.clear();
-		this.injectedReleased.clear();
-		this.injectedVectors.clear();
-	}
-	dx = 0;
-	dy = 0;
-	wheel = 0;
-	/** Mouse buttons feed the same code space as keys: Mouse0/Mouse1/Mouse2. */
-	handleMouseButton(button, isDown) {
-		this.handleKey(`Mouse${button}`, isDown);
-	}
-	/** Accumulate look deltas (movementX/Y under pointer lock, else move deltas). */
-	handlePointerMove(dx, dy) {
-		this.dx += dx;
-		this.dy += dy;
-	}
-	handleWheel(deltaY) {
-		this.wheel += deltaY;
-	}
-	/** Drain the accumulated pointer delta (read once per frame). */
-	pointerDelta() {
-		const d = {
-			x: this.dx,
-			y: this.dy
-		};
-		this.dx = 0;
-		this.dy = 0;
-		return d;
-	}
-	/** Drain the accumulated wheel delta. */
-	wheelDelta() {
-		const w = this.wheel;
-		this.wheel = 0;
-		return w;
-	}
-	/**
-	* Wire browser pointer events on a canvas: buttons → Mouse0/1/2 codes,
-	* movement → pointerDelta (movementX/Y so pointer lock just works),
-	* wheel → wheelDelta. `lockOnClick` requests pointer lock on mousedown
-	* (the FPS pattern).
-	*/
-	padAxesState = {
-		lx: 0,
-		ly: 0,
-		rx: 0,
-		ry: 0
-	};
-	padButtonsDown = 0;
-	/**
-	* Feed one polled gamepad snapshot (standard mapping). Buttons become
-	* codes `Pad0`..`Pad16` in the same space as keys — declare them in input
-	* actions like any key ("jump": ["Space", "Pad0"]). Axes land in
-	* `padAxes()` with a deadzone. Pass null when no pad is connected.
-	*/
-	pollGamepad(pad) {
-		const dead = .15;
-		const shape = (v) => Math.abs(v) < dead ? 0 : v;
-		if (!pad) {
-			for (let i = 0; i < 17; i++) if (this.padButtonsDown & 1 << i) this.handleKey(`Pad${i}`, false);
-			this.padButtonsDown = 0;
-			this.padAxesState.lx = 0;
-			this.padAxesState.ly = 0;
-			this.padAxesState.rx = 0;
-			this.padAxesState.ry = 0;
-			return;
-		}
-		for (let i = 0; i < Math.min(17, pad.buttons.length); i++) {
-			const down = pad.buttons[i]?.pressed === true;
-			if (down !== ((this.padButtonsDown & 1 << i) !== 0)) {
-				this.handleKey(`Pad${i}`, down);
-				this.padButtonsDown = down ? this.padButtonsDown | 1 << i : this.padButtonsDown & ~(1 << i);
-			}
-		}
-		this.padAxesState.lx = shape(pad.axes[0] ?? 0);
-		this.padAxesState.ly = shape(pad.axes[1] ?? 0);
-		this.padAxesState.rx = shape(pad.axes[2] ?? 0);
-		this.padAxesState.ry = shape(pad.axes[3] ?? 0);
-	}
-	/** Deadzoned analog sticks: 0 = left {x,y}, 1 = right. */
-	padAxes(stick = 0) {
-		return stick === 0 ? {
-			x: this.padAxesState.lx,
-			y: this.padAxesState.ly
-		} : {
-			x: this.padAxesState.rx,
-			y: this.padAxesState.ry
-		};
-	}
-	/**
-	* Poll the browser Gamepad API every frame (the first connected pad).
-	* Wire once at boot: `engine.input.attachGamepad(engine)`. Headless no-op.
-	*/
-	attachGamepad(engine) {
-		if (typeof navigator === "undefined" || typeof navigator.getGamepads !== "function") return () => {};
-		const disconnect = engine.updated.connect(() => {
-			const pads = navigator.getGamepads();
-			let pad = null;
-			for (const p of pads) if (p?.connected) {
-				pad = p;
-				break;
-			}
-			this.pollGamepad(pad);
-		});
-		const prev = this.detach;
-		this.detach = () => {
-			prev?.();
-			disconnect();
-		};
-		return disconnect;
-	}
-	attachPointer(target, opts) {
-		let buttonsHeld = 0;
-		const onDown = (e) => {
-			buttonsHeld++;
-			this.handleMouseButton(e.button, true);
-			if (opts?.lockOnClick && document.pointerLockElement !== target) target.requestPointerLock?.();
-		};
-		const onUp = (e) => {
-			buttonsHeld = Math.max(0, buttonsHeld - 1);
-			this.handleMouseButton(e.button, false);
-		};
-		const onMove = (e) => {
-			if (document.pointerLockElement === target || buttonsHeld > 0) this.handlePointerMove(e.movementX, e.movementY);
-		};
-		const onWheel = (e) => {
-			e.preventDefault();
-			this.handleWheel(e.deltaY);
-		};
-		const onContext = (e) => e.preventDefault();
-		target.addEventListener("mousedown", onDown);
-		window.addEventListener("mouseup", onUp);
-		window.addEventListener("mousemove", onMove);
-		target.addEventListener("wheel", onWheel, { passive: false });
-		target.addEventListener("contextmenu", onContext);
-		const detach = () => {
-			target.removeEventListener("mousedown", onDown);
-			window.removeEventListener("mouseup", onUp);
-			window.removeEventListener("mousemove", onMove);
-			target.removeEventListener("wheel", onWheel);
-			target.removeEventListener("contextmenu", onContext);
-		};
-		const prev = this.detach;
-		this.detach = () => {
-			prev?.();
-			detach();
-		};
-		return detach;
-	}
-	/**
-	* Wire browser keyboard events. Returns (and chains into dispose()) a detach
-	* function.
-	*
-	* By default the browser default is prevented for keys BOUND to a declared
-	* action — an embedded game must not scroll its host page on Space/arrows.
-	* Keys typed into editable elements (inputs, textareas, contenteditable)
-	* are ignored entirely so DOM UI overlays keep working.
-	*/
-	attachKeyboard(target, opts) {
-		const mode = opts?.preventDefault ?? "bound";
-		const onDown = (e) => {
-			if (isEditableTarget(e.target)) return;
-			if ((e.ctrlKey || e.metaKey) && !e.code.startsWith("Control") && !e.code.startsWith("Meta")) return;
-			if (mode === "bound" && this.codeIsBound(e.code)) e.preventDefault?.();
-			if (!e.repeat) this.handleKey(e.code, true);
-		};
-		const onUp = (e) => {
-			if (isEditableTarget(e.target)) return;
-			this.handleKey(e.code, false);
-		};
-		target.addEventListener("keydown", onDown);
-		target.addEventListener("keyup", onUp);
-		const detach = () => {
-			target.removeEventListener("keydown", onDown);
-			target.removeEventListener("keyup", onUp);
-		};
-		const prev = this.detach;
-		this.detach = () => {
-			prev?.();
-			detach();
-		};
-		return detach;
-	}
-	/** Whether any declared action binds this key code. */
-	codeIsBound(code) {
-		for (const action of this.actions.values()) if (action.type === "button") {
-			if (action.keys.includes(code)) return true;
-		} else {
-			const k = action.keys;
-			if (k.up.includes(code) || k.down.includes(code) || k.left.includes(code) || k.right.includes(code)) return true;
-		}
-		return false;
-	}
-	dispose() {
-		this.detach?.();
-		this.detach = null;
-	}
-	isPressed(action) {
-		return this.button(action).keys.some((k) => this.down.has(k)) || this.injectedDown.has(action);
-	}
-	justPressed(action) {
-		return this.button(action).keys.some((k) => this.pressedEdge.has(k)) || this.injectedPressed.has(action);
-	}
-	justReleased(action) {
-		return this.button(action).keys.some((k) => this.releasedEdge.has(k)) || this.injectedReleased.has(action);
-	}
-	/** Normalized direction for a vector2 action (y-down: up = -y). */
-	getVector(action) {
-		const def = this.get(action);
-		if (def.type !== "vector2") throw new IncantoError("BAD_FORMAT", `Input action '${action}' is a button — use isPressed/justPressed, not getVector.`);
-		const active = (codes) => codes.some((k) => this.down.has(k)) ? 1 : 0;
-		let x = active(def.keys.right) - active(def.keys.left);
-		let y = active(def.keys.down) - active(def.keys.up);
-		const injected = this.injectedVectors.get(action);
-		if (injected) {
-			x += injected.x;
-			y += injected.y;
-		}
-		const len = Math.hypot(x, y);
-		if (len > 1) {
-			x /= len;
-			y /= len;
-		}
-		return {
-			x,
-			y
-		};
-	}
-	/** Consume one-frame edges. The Engine calls this at the end of every tick. */
-	endFrame() {
-		this.pressedEdge.clear();
-		this.releasedEdge.clear();
-		this.injectedPressed.clear();
-		this.injectedReleased.clear();
-	}
-	/**
-	* Drop all action declarations and injected action state (physical key
-	* state is kept). The Engine calls this on setScene so keybinds never
-	* bleed between scenes.
-	*/
-	clear() {
-		this.actions.clear();
-		this.pressedEdge.clear();
-		this.releasedEdge.clear();
-		this.clearInjected();
-	}
-	get(action) {
-		const def = this.actions.get(action);
-		if (!def) throw new IncantoError("BAD_FORMAT", `Unknown input action '${action}'. Declared actions: [${[...this.actions.keys()].join(", ")}].`);
-		return def;
-	}
-	button(action) {
-		const def = this.get(action);
-		if (def.type !== "button") throw new IncantoError("BAD_FORMAT", `Input action '${action}' is a vector2 — use getVector, not button queries.`);
-		return def;
-	}
-};
-//#endregion
 //#region src/core/log.ts
 /**
 * The engine's log channel (`engine.log`, `this.log` in a Behavior): a ring
@@ -1502,7 +1127,57 @@ var Engine = class {
 	}
 	start() {
 		if (this.disposeScheduler) return;
-		this.disposeScheduler = this.scheduler((now) => this.tick(now));
+		this.disposeScheduler = this.scheduler((now) => {
+			try {
+				this.tick(now);
+			} catch (error) {
+				this.reportFrameError(error);
+			}
+		});
+	}
+	/**
+	* A frame threw somewhere outside a single node (a renderer, physics, a
+	* signal handler). Report the first one and count the rest: a broken frame
+	* repeats sixty times a second, and sixty identical traces a second is how
+	* you lose the first one.
+	*/
+	reportFrameError(error) {
+		this.errorCount += 1;
+		const text = error instanceof Error ? `${error.name}: ${error.message}` : String(error);
+		if (text === this.lastFrameError) return;
+		this.lastFrameError = text;
+		this.log.error("[incanto] a frame threw — the loop keeps running:", error);
+		console.error("[incanto] a frame threw — the loop keeps running:", error);
+	}
+	/** @internal A node quarantined itself; count it for `stats().errors`. */
+	_nodeErrored(_node) {
+		this.errorCount += 1;
+	}
+	errorCount = 0;
+	lastFrameError = null;
+	/**
+	* Every node with something quarantined — its own update, its script, or
+	* both — so a tool can list them and put them back. Walks on demand; there is
+	* no per-frame bookkeeping for this.
+	*/
+	erroredNodes() {
+		const out = [];
+		const walk = (node) => {
+			if (node.errored || node.behaviorErrored) out.push(node);
+			for (const child of node.children) walk(child);
+		};
+		if (this._scene?.root) walk(this._scene.root);
+		return out;
+	}
+	/** Un-skip every quarantined node — the "try again" after you fix the code. */
+	resumeErroredNodes() {
+		const nodes = this.erroredNodes();
+		for (const node of nodes) {
+			node.errored = false;
+			node.behaviorErrored = false;
+		}
+		this.lastFrameError = null;
+		return nodes.length;
 	}
 	stop() {
 		this.disposeScheduler?.();
@@ -1522,7 +1197,8 @@ var Engine = class {
 			fps: this.frameStats.fps(),
 			frameMs: this.frameStats.frameMs(),
 			nodes: this._scene?.tree.root ? countNodes(this._scene.tree.root) : 0,
-			running: this.disposeScheduler !== null
+			running: this.disposeScheduler !== null,
+			errors: this.errorCount
 		};
 	}
 	/**
@@ -2370,4 +2046,4 @@ function registerCoreNodes() {
 	registerNode(UiDialogue);
 }
 //#endregion
-export { crossfadeGains as C, WebAudioMusicBackend as S, AudioBuses as T, spatialPan as _, HudLayer as a, synthSfx as b, UiText as c, LogManager as d, InputMap as f, spatialGain as g, ROLLOFF_MODELS as h, UiDialogue as i, AudioPlayer as l, isAudioContextAvailable as m, Timer as n, UiBanner as o, SfxEngine as p, UiButton as r, UiBar as s, registerCoreNodes as t, Engine as u, SFX_PRESETS as v, fadeGain as w, MusicManager as x, SFX_PRESET_NAMES as y };
+export { fadeGain as C, crossfadeGains as S, SFX_PRESETS as _, HudLayer as a, MusicManager as b, UiText as c, LogManager as d, SfxEngine as f, spatialPan as g, spatialGain as h, UiDialogue as i, AudioPlayer as l, ROLLOFF_MODELS as m, Timer as n, UiBanner as o, isAudioContextAvailable as p, UiButton as r, UiBar as s, registerCoreNodes as t, Engine as u, SFX_PRESET_NAMES as v, AudioBuses as w, WebAudioMusicBackend as x, synthSfx as y };

package/dist/{register-DWcWq4QG.js → register-tkR_8tWg.js}

@@ -1,9 +1,9 @@
-import { f as Node } from "./loader-BZqOKfI2.js";
-import { t as registerCoreNodes } from "./register-BTg0EM7s.js";
+import { f as Node } from "./loader-BlaRQGaA.js";
+import { t as registerCoreNodes } from "./register-Dzkd6-os.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as Rng } from "./rng-DP-SR7eg.js";
-import { i as getNodeSchema, l as registerNode } from "./registry-BVJ2HbCn.js";
-import { r as effectiveOrder } from "./duplicate-BgtFrFo4.js";
+import { i as getNodeSchema, l as registerNode } from "./registry-CJdGpT2V.js";
+import { r as effectiveOrder } from "./duplicate-KRPtUtzl.js";
 import { i as applyParticlePreset, r as PARTICLE_PRESET_NAMES, t as ParticleSim } from "./particle-sim-Bw7hB93B.js";
 import { AdditiveBlending, BufferAttribute, BufferGeometry, CanvasTexture, Color, DynamicDrawUsage, Group, InstancedMesh, MathUtils, Matrix4, Mesh, MeshBasicMaterial, NearestFilter, NormalBlending, Object3D, PlaneGeometry } from "three";
 //#region src/2d/physics/collider-validate.ts

package/dist/{registry-BVJ2HbCn.js → registry-CJdGpT2V.js}

@@ -8,7 +8,11 @@ import { r as jsonKind, t as jsonClone } from "./json-BLk7H2Qa.js";
 * - non-empty default arrays are FIXED templates: same length, element-wise match
 *   (empty default arrays are unconstrained — variable-length lists)
 */
-function validatePropValue(value, def, at) {
+function validatePropValue(value, def, at, options) {
+	if (options && typeof value === "string" && !options.includes(value)) throw new IncantoError("PROP_TYPE_MISMATCH", `Prop '${at}' is ${JSON.stringify(value)}, which is not one of: ${options.map((o) => JSON.stringify(o)).join(", ")}.`, {
+		prop: at,
+		validOptions: [...options]
+	});
 	const expected = jsonKind(def);
 	if (expected === "null") return;
 	const actual = jsonKind(value);
@@ -114,7 +118,7 @@ function applySchemaProps(target, schema, props, label, aliases = {}) {
 				validOptions: valid
 			});
 		}
-		validatePropValue(value, def.default, `${label}.${key}`);
+		validatePropValue(value, def.default, `${label}.${key}`, def.options);
 		target[key] = jsonClone(value);
 	}
 }