incanto 0.30.0 → 0.31.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);
 	}
 }

package/dist/test.d.ts

@@ -1,6 +1,6 @@
+import { $ as LogEntry, X as Node, n as BehaviorCtor, v as Engine, w as Scene } from "./behavior-D_jMpFh8.js";
 import { c as JsonValue, i as SceneJson } from "./schema-CcoWb32N.js";
-import { $ as Node, T as LogEntry, n as BehaviorCtor, v as Engine, w as Scene } from "./behavior-BAc0erXF.js";
-import { t as LoadSceneOptions } from "./loader-B242FF6N.js";
+import { t as LoadSceneOptions } from "./loader-BYBrqTxP.js";
 import { i as auditScene, t as IncantoError } from "./errors-1dXlIwoR.js";
 
 //#region src/test/index.d.ts
@@ -74,11 +74,6 @@ interface ValidationResult {
   /** The hard load error, when ok is false — `details` is machine-readable. */
   error?: IncantoError;
 }
-/**
-* Run every hard load-time check headlessly. Unregistered behaviors are
-* stubbed by default (structure-only validation, no TypeScript needed) —
-* pass the real classes via `behaviors` to validate script props too.
-*/
 declare function validateScene(json: unknown, opts?: ValidateSceneOptions): ValidationResult;
 interface RunContext {
   engine: Engine;

package/dist/test.js

@@ -1,13 +1,13 @@
-import { _ as registerBehavior, n as loadScene } from "./loader-BZqOKfI2.js";
-import { u as Engine } from "./register-BTg0EM7s.js";
+import { n as loadScene, y as registerBehavior } from "./loader-BlaRQGaA.js";
+import { u as Engine } from "./register-Dzkd6-os.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
-import { t as auditScene } from "./audit-C6rMyict.js";
+import { t as auditScene } from "./audit-C4kmDK0o.js";
 import { n as jsonEquals, t as jsonClone } from "./json-BLk7H2Qa.js";
-import { i as getNodeSchema, s as mergeStaticProps } from "./registry-BVJ2HbCn.js";
-import { n as registerGameplayBehaviors } from "./gameplay-Cfr6aFZ1.js";
-import { t as registerNodes2D } from "./register-DWcWq4QG.js";
-import { t as registerNodes3D } from "./register-DJ0SByQg.js";
-import { t as registerNodesNet } from "./register-MelqEdza.js";
+import { i as getNodeSchema, s as mergeStaticProps } from "./registry-CJdGpT2V.js";
+import { n as registerGameplayBehaviors } from "./gameplay-BftxM_It.js";
+import { t as registerNodes2D } from "./register-tkR_8tWg.js";
+import { n as registerNodes3D, t as resolveEnvironmentHdri } from "./environment-presets--DigHNg4.js";
+import { t as registerNodesNet } from "./register-CUY284Is.js";
 //#region src/test/index.ts
 /**
 * incanto/test — the browserless verification harness.
@@ -184,10 +184,28 @@ function defaultsFor(typeName) {
 * stubbed by default (structure-only validation, no TypeScript needed) —
 * pass the real classes via `behaviors` to validate script props too.
 */
+/**
+* `environment.preset` is resolved deep inside Renderer3D, which no headless
+* tool reaches — so a typo there passed `incanto-check` and hard-failed at boot.
+* It cannot live in the core loader (core must never import 3d), but it belongs
+* exactly here: the test entry already registers the 3D nodes.
+*/
+function checkEnvironment(json) {
+	const env = json?.environment;
+	if (!env || typeof env !== "object") return;
+	if (env.preset === void 0) return;
+	if (typeof env.preset !== "string") throw new IncantoError("BAD_FORMAT", `Scene "environment.preset" must be a string, got ${JSON.stringify(env.preset)}.`);
+	try {
+		resolveEnvironmentHdri(env);
+	} catch (error) {
+		throw new IncantoError("BAD_FORMAT", error instanceof Error ? error.message : String(error));
+	}
+}
 function validateScene(json, opts = {}) {
 	registerAllNodes();
 	for (const [name, ctor] of Object.entries(opts.behaviors ?? {})) registerBehavior(name, ctor, { replace: true });
 	try {
+		checkEnvironment(json);
 		loadScene(json, {
 			resolveScene: opts.resolveScene,
 			stubMissingBehaviors: !opts.strictBehaviors
@@ -218,10 +236,10 @@ async function runScript(json, opts) {
 	engine.setScene(scene);
 	const physics = opts.physics ?? "auto";
 	if (physics === "2d" || physics === "auto" && scene.dimension === "2d") {
-		const { enablePhysics2D } = await import("./physics-2d-3kOQCtgd.js").then((n) => n.r);
+		const { enablePhysics2D } = await import("./physics-2d-D9wquBvK.js").then((n) => n.r);
 		await enablePhysics2D(engine);
 	} else if (physics === "3d" || physics === "auto" && scene.dimension === "3d") {
-		const { enablePhysics3D } = await import("./physics-3d-CeRH-Ff_.js").then((n) => n.r);
+		const { enablePhysics3D } = await import("./physics-3d-CnPygVGo.js").then((n) => n.r);
 		await enablePhysics3D(engine);
 	}
 	const failures = [];
@@ -284,6 +302,12 @@ async function runScript(json, opts) {
 	}
 	const finalCapture = captureScene(scene);
 	const logs = [...engine.log.entries()];
+	const swallowed = engine.stats().errors;
+	if (swallowed > 0) failures.push({
+		atMs: opts.durationMs,
+		label: "engine",
+		message: `${swallowed} error(s) were swallowed to keep the loop alive — the logs above name the node, the behavior and the phase`
+	});
 	engine.dispose();
 	const ok = failures.length === 0;
 	return {
@@ -293,9 +317,14 @@ async function runScript(json, opts) {
 		logs,
 		finalCapture,
 		describe: () => {
+			const engineWarnings = logs.filter((l) => l.level === "warn" || l.level === "error");
+			const head = `run ${ok ? "OK" : "FAILED"} — ${opts.durationMs}ms simulated, ${failures.length} failure(s), ${logs.length} log(s)`;
+			const fails = failures.map((f) => `  ✗ at ${f.atMs}ms${f.label ? ` [${f.label}]` : ""}: ${f.message}`);
+			const noisy = engineWarnings.map((l) => `  ! ${l.level}: ${l.parts.map((p) => typeof p === "string" ? p : String(p)).join(" ")}`);
 			return [
-				`run ${ok ? "OK" : "FAILED"} — ${opts.durationMs}ms simulated, ${failures.length} failure(s), ${logs.length} log(s)`,
-				...failures.map((f) => `  ✗ at ${f.atMs}ms${f.label ? ` [${f.label}]` : ""}: ${f.message}`),
+				head,
+				...fails,
+				...noisy,
 				describeCapture(finalCapture)
 			].join("\n");
 		}
@@ -323,10 +352,10 @@ async function createPlaySession(json, opts = {}) {
 	engine.setScene(scene);
 	const physics = opts.physics ?? "auto";
 	if (physics === "2d" || physics === "auto" && scene.dimension === "2d") {
-		const { enablePhysics2D } = await import("./physics-2d-3kOQCtgd.js").then((n) => n.r);
+		const { enablePhysics2D } = await import("./physics-2d-D9wquBvK.js").then((n) => n.r);
 		await enablePhysics2D(engine);
 	} else if (physics === "3d" || physics === "auto" && scene.dimension === "3d") {
-		const { enablePhysics3D } = await import("./physics-3d-CeRH-Ff_.js").then((n) => n.r);
+		const { enablePhysics3D } = await import("./physics-3d-CnPygVGo.js").then((n) => n.r);
 		await enablePhysics3D(engine);
 	}
 	const stepMs = 1e3 / (opts.fixedHz ?? 60);

package/editor/assets/{agent8-CAp0i5qn.js → agent8-o27_Y1xN.js}

@@ -1 +1 @@
-import{n as e}from"./index-BO6WU8by.js";async function t(t){return new n((await e(()=>import(`./GameServer-C56iOUgF.js`),[],import.meta.url)).GameServer,t)}var n=class{raw;active=new Map;reconnecting=!1;disposed=!1;constructor(e,t){this.raw=new e({...t})}get account(){return this.raw.account}get connected(){return this.raw.connected}connect(){return this.raw.connected?Promise.resolve(!0):(this.disposed=!1,this.rawConnect())}rawConnect(){return this.raw.connect({onDisconnect:()=>void this.reconnect()})}disconnect(){this.disposed=!0;for(let e of this.active.values())e.off();return this.active.clear(),this.raw.disconnect()}remoteFunction(e,t,n){return this.raw.remoteFunction(e,t,n)}track(e){let t=Symbol(`sub`),n={make:e,off:e()};return this.active.set(t,n),()=>{n.off(),this.active.delete(t)}}async reconnect(){if(!this.disposed&&!this.reconnecting){this.reconnecting=!0;try{await this.rawConnect();for(let e of this.active.values())e.off(),e.off=e.make()}finally{this.reconnecting=!1}}}subscribeRoomState(e,t){return this.track(()=>this.raw.subscribeRoomState(e,t))}subscribeRoomMyState(e,t){return this.track(()=>this.raw.subscribeRoomMyState(e,t))}subscribeRoomAllUserStates(e,t){return this.track(()=>this.raw.subscribeRoomAllUserStates(e,e=>{let n={};for(let t of e??[]){if(!t||typeof t.account!=`string`||t.__leaved)continue;let{account:e,__updated:r,__leaved:i,...a}=t;n[e]=a}t(n)}))}subscribeRoomCollection(e,t,n){return this.track(()=>this.raw.subscribeRoomCollection(e,t,({items:e})=>{let t={};for(let n of e??[])n&&typeof n.__id==`string`&&(t[n.__id]=n);n(t)}))}onRoomMessage(e,t,n){return this.track(()=>this.raw.onRoomMessage(e,t,n))}onRoomUserJoin(e,t){return this.track(()=>this.raw.onRoomUserJoin(e,t))}onRoomUserLeave(e,t){return this.track(()=>this.raw.onRoomUserLeave(e,t))}subscribeGlobalState(e){return this.track(()=>this.raw.subscribeGlobalState(e))}subscribeGlobalMyState(e){return this.track(()=>this.raw.subscribeGlobalMyState(e))}subscribeGlobalUserState(e,t){return this.track(()=>this.raw.subscribeGlobalUserState(e,t))}subscribeGlobalCollection(e,t){return this.track(()=>this.raw.subscribeGlobalCollection(e,({items:e})=>{let n={};for(let t of e??[])t&&typeof t.__id==`string`&&(n[t.__id]=t);t(n)}))}subscribeAsset(e,t){return this.track(()=>this.raw.subscribeAsset(e,t))}onGlobalMessage(e,t){return this.track(()=>this.raw.onGlobalMessage(e,t))}};export{t as createAgent8Server};
+import{n as e}from"./index-C9fb5QcT.js";async function t(t){return new n((await e(()=>import(`./GameServer-C56iOUgF.js`),[],import.meta.url)).GameServer,t)}var n=class{raw;active=new Map;reconnecting=!1;disposed=!1;constructor(e,t){this.raw=new e({...t})}get account(){return this.raw.account}get connected(){return this.raw.connected}connect(){return this.raw.connected?Promise.resolve(!0):(this.disposed=!1,this.rawConnect())}rawConnect(){return this.raw.connect({onDisconnect:()=>void this.reconnect()})}disconnect(){this.disposed=!0;for(let e of this.active.values())e.off();return this.active.clear(),this.raw.disconnect()}remoteFunction(e,t,n){return this.raw.remoteFunction(e,t,n)}track(e){let t=Symbol(`sub`),n={make:e,off:e()};return this.active.set(t,n),()=>{n.off(),this.active.delete(t)}}async reconnect(){if(!this.disposed&&!this.reconnecting){this.reconnecting=!0;try{await this.rawConnect();for(let e of this.active.values())e.off(),e.off=e.make()}finally{this.reconnecting=!1}}}subscribeRoomState(e,t){return this.track(()=>this.raw.subscribeRoomState(e,t))}subscribeRoomMyState(e,t){return this.track(()=>this.raw.subscribeRoomMyState(e,t))}subscribeRoomAllUserStates(e,t){return this.track(()=>this.raw.subscribeRoomAllUserStates(e,e=>{let n={};for(let t of e??[]){if(!t||typeof t.account!=`string`||t.__leaved)continue;let{account:e,__updated:r,__leaved:i,...a}=t;n[e]=a}t(n)}))}subscribeRoomCollection(e,t,n){return this.track(()=>this.raw.subscribeRoomCollection(e,t,({items:e})=>{let t={};for(let n of e??[])n&&typeof n.__id==`string`&&(t[n.__id]=n);n(t)}))}onRoomMessage(e,t,n){return this.track(()=>this.raw.onRoomMessage(e,t,n))}onRoomUserJoin(e,t){return this.track(()=>this.raw.onRoomUserJoin(e,t))}onRoomUserLeave(e,t){return this.track(()=>this.raw.onRoomUserLeave(e,t))}subscribeGlobalState(e){return this.track(()=>this.raw.subscribeGlobalState(e))}subscribeGlobalMyState(e){return this.track(()=>this.raw.subscribeGlobalMyState(e))}subscribeGlobalUserState(e,t){return this.track(()=>this.raw.subscribeGlobalUserState(e,t))}subscribeGlobalCollection(e,t){return this.track(()=>this.raw.subscribeGlobalCollection(e,({items:e})=>{let n={};for(let t of e??[])t&&typeof t.__id==`string`&&(n[t.__id]=t);t(n)}))}subscribeAsset(e,t){return this.track(()=>this.raw.subscribeAsset(e,t))}onGlobalMessage(e,t){return this.track(()=>this.raw.onGlobalMessage(e,t))}};export{t as createAgent8Server};