incanto 0.51.0 → 0.52.0

package/dist/{pathfinding-Bz34pvQD.d.ts → pathfinding-CAR9DjQQ.d.ts}

@@ -1,4 +1,4 @@
-import { Dt as Node, ct as Listener, d as PropSchema } from "./behavior-rZNfzVbH.js";
+import { Dt as Node, ct as Listener, d as PropSchema } from "./behavior-uPEuZrUB.js";
 
 //#region src/core/nodes/audio-player.d.ts
 /**

package/dist/{physics-2d-Ccq2L9R0.js → physics-2d-Dns-oZlE.js}

@@ -1,7 +1,7 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { w as diagnose } from "./loader-B2asghWa.js";
+import { C as diagnose } from "./loader-B-Gft32x.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-B_BaaGx-.js";
+import { _ as RigidBody2D, b as validateCollider2D, g as PhysicsBody2D, h as CharacterBody2D, m as Area2D, p as Joint2D, y as Node2D } from "./register-Trx7WHnD.js";
 import { n as registerDebugSource } from "./debug-draw-BM3DsvtT.js";
 //#region src/2d/physics/physics-2d.ts
 var physics_2d_exports = /* @__PURE__ */ __exportAll({

package/dist/{physics-3d-B2c5KNYh.js → physics-3d-BhI0ehpe.js}

@@ -1,9 +1,9 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { w as diagnose } from "./loader-B2asghWa.js";
+import { C as diagnose } from "./loader-B-Gft32x.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
-import { B as validateCollider3D, F as CharacterBody3D, I as PhysicsBody3D, L as RigidBody3D, P as Area3D, z as Node3D } from "./gameplay-bStgtZBV.js";
+import { B as validateCollider3D, F as CharacterBody3D, I as PhysicsBody3D, L as RigidBody3D, P as Area3D, z as Node3D } from "./gameplay-B6jqvYeM.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-C08pOC6H.js";
+import { A as Terrain3D, F as InstancedMesh3D, L as buildMeshGeometry, P as Joint3D } from "./environment-presets-DSZwsKPs.js";
 import { Euler, Matrix4, Quaternion, Vector3 } from "three";
 //#region src/3d/physics/collider-lines.ts
 /**

package/dist/react.d.ts

@@ -1,4 +1,4 @@
-import { P as Scene, b as Engine, n as BehaviorCtor } from "./behavior-rZNfzVbH.js";
+import { P as Scene, b as Engine, n as BehaviorCtor } from "./behavior-uPEuZrUB.js";
 import { c as JsonValue } from "./schema-CFeioQRE.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-BNaOC3Px.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-CkzKZ4v5.js").then((n) => n.n)).createGame2D(o)))(opts);
+			const next = await (_gameFactory ?? (mode === "3d" ? async (o) => (await import("./create-game-CGnoypjL.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-B_e9hJf7.js").then((n) => n.n)).createGame2D(o)))(opts);
 			if (disposed) {
 				next.dispose();
 				return;

package/dist/{register-CGq-Hee8.js → register-DVwlnZAZ.js}

@@ -1,7 +1,7 @@
-import { C as InputMap, M as Signal, S as resolveOrderGroups, _ as restoreBehaviors, b as ORDER_GROUP_BASE, f as Node, g as captureBehaviors, w as diagnose, y as createSaveStore } from "./loader-B2asghWa.js";
+import { C as diagnose, M as Signal, S as InputMap, f as Node, g as restoreBehaviors, h as captureBehaviors, v as createSaveStore, x as resolveOrderGroups, y as ORDER_GROUP_BASE } from "./loader-B-Gft32x.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as Rng } from "./rng-DP-SR7eg.js";
-import { l as registerNode } from "./registry-IyWCGe4q.js";
+import { l as registerNode } from "./registry-C7u42TID.js";
 //#region src/core/audio/buses.ts
 /**
 * Global volume state — `master` × `sfx`/`music` gain (0..1) plus a `muted`

package/dist/{register-B_BaaGx-.js → register-Trx7WHnD.js}

@@ -1,8 +1,8 @@
-import { f as Node, x as effectiveOrder } from "./loader-B2asghWa.js";
-import { t as registerCoreNodes } from "./register-CGq-Hee8.js";
+import { b as effectiveOrder, f as Node } from "./loader-B-Gft32x.js";
+import { t as registerCoreNodes } from "./register-DVwlnZAZ.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-IyWCGe4q.js";
+import { i as getNodeSchema, l as registerNode } from "./registry-C7u42TID.js";
 import { i as ParticleSim, n as resolveFrames, o as PARTICLE_PRESET_NAMES, r as validateAnimationAliases, s as applyParticlePreset, t as resolveAnimation } from "./sprite-animation-D_p28jwU.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-IyWCGe4q.js → registry-C7u42TID.js}

@@ -39,13 +39,27 @@ function getNodeType(typeName) {
 	const ctor = types.get(typeName);
 	if (!ctor) {
 		const registered = [...types.keys()];
-		throw new IncantoError("UNKNOWN_NODE_TYPE", `Unknown node type '${typeName}'. Registered types: [${registered.join(", ")}].`, {
+		throw new IncantoError("UNKNOWN_NODE_TYPE", `Unknown node type '${typeName}'. Registered types: [${registered.join(", ")}].` + missingRegistrarHint(typeName), {
 			nodeType: typeName,
 			validOptions: registered
 		});
 	}
 	return ctor;
 }
+/**
+* "Unknown node type 'Node2D'" next to a list with no 2D types in it is the
+* most confusing error this engine can produce: the type is not misspelled and
+* not missing — a REGISTRAR was never called. Say which one.
+*
+* The case that produced this: the multiplayer boot registers `registerNodesNet()`
+* and loads a 2D scene, which dies on its own root node.
+*/
+function missingRegistrarHint(typeName) {
+	const suffix = typeName.endsWith("2D") ? "2D" : typeName.endsWith("3D") ? "3D" : "";
+	if (!suffix || types.has(`Node${suffix}`)) return "";
+	const dim = suffix.toLowerCase();
+	return ` '${typeName}' is a ${dim} node and no ${dim} type is registered: call registerNodes${suffix}() (from 'incanto/${dim}') before loading the scene — createGame${suffix}() does it for you. Registrars compose: a multiplayer game calls registerNodes${suffix}() AND registerNodesNet().`;
+}
 function registeredTypes() {
 	return [...types.keys()];
 }
@@ -123,6 +137,14 @@ function applySchemaProps(target, schema, props, label, aliases = {}, extraOptio
 		validatePropValue(value, def.default, `${label}.${key}`, options);
 		target[key] = jsonClone(value);
 	}
+	for (const [key, def] of Object.entries(schema)) {
+		if (!def.required) continue;
+		const value = target[key];
+		if (value === "" || value === void 0 || value === null) throw new IncantoError("PROP_TYPE_MISMATCH", `'${label}' needs a "${key}" — it is empty.`, {
+			prop: key,
+			nodeType: label
+		});
+	}
 }
 /**
 * Instantiate a registered type, assign schema defaults (cloned), then the

package/dist/{replay-DIP2_as4.d.ts → replay-BU1CCM15.d.ts}

@@ -1,4 +1,4 @@
-import { b as Engine } from "./behavior-rZNfzVbH.js";
+import { b as Engine } from "./behavior-uPEuZrUB.js";
 import { s as JsonObject } from "./schema-CFeioQRE.js";
 
 //#region src/core/audit.d.ts

package/dist/{replay-BgKxGcXH.js → replay-BicPOMX0.js}

@@ -1,4 +1,196 @@
-import { D as translationKey } from "./register-CGq-Hee8.js";
+import { E as behaviorSchema, w as parseNodePath } from "./loader-B-Gft32x.js";
+import { D as translationKey } from "./register-DVwlnZAZ.js";
+import { i as getNodeSchema } from "./registry-C7u42TID.js";
+//#region src/core/node-refs.ts
+/**
+* Node-path PROPS, resolved against scene JSON.
+*
+* `Chase.target`, `Camera2D.follow`, `Spawner.prefab`, `Joint3D.target`,
+* `CharacterController3D.skinPath`, `Foliage3D.terrain` … each holds a path to
+* another node, and nothing checked any of them. A connection whose end does not
+* resolve is a hard `DANGLING_CONNECTION` at load; a PROP that does not resolve
+* is nothing at all — `getNodeOrNull` returns null, the scene loads, the enemy
+* never chases, and no error is ever printed.
+*
+* That makes it exactly the class `auditScene` exists for: loads fine, plays
+* wrong. The editor uses the same resolver so the two cannot drift.
+*
+* The grammar comes from `parseNodePath` — the loader's own parser — so a path
+* this module accepts is one the engine accepts.
+*/
+function nodeAt(root, path) {
+	let node = root;
+	for (const index of path) {
+		node = node?.children?.[index];
+		if (!node) return null;
+	}
+	return node ?? null;
+}
+function byName(root, name) {
+	const found = [];
+	const walk = (node, at) => {
+		if (node.name === name) found.push(at);
+		(node.children ?? []).forEach((child, i) => {
+			walk(child, [...at, i]);
+		});
+	};
+	walk(root, []);
+	return found;
+}
+/**
+* Resolve `value` from the node at `owner`, the way the engine would.
+*
+* Note the asymmetry with connections, whose paths resolve from the SCENE ROOT:
+* a prop's path resolves from the node holding it, which is why `'../Skin'` is
+* the documented default of `CharacterController3D.skinPath` and would mean
+* nothing in a connection.
+*/
+function resolveRefInJson(root, owner, value) {
+	if (!root) return {
+		ok: false,
+		problem: {
+			kind: "noMatch",
+			name: value
+		}
+	};
+	let parsed;
+	try {
+		parsed = parseNodePath(value);
+	} catch (error) {
+		return {
+			ok: false,
+			problem: {
+				kind: "grammar",
+				message: error instanceof Error ? error.message : String(error)
+			}
+		};
+	}
+	if (parsed.kind === "unique") {
+		const found = byName(root, parsed.name);
+		if (found.length === 1) return {
+			ok: true,
+			path: found[0]
+		};
+		if (found.length === 0) return {
+			ok: false,
+			problem: {
+				kind: "noMatch",
+				name: parsed.name
+			}
+		};
+		return {
+			ok: false,
+			problem: {
+				kind: "ambiguous",
+				name: parsed.name,
+				count: found.length
+			}
+		};
+	}
+	let at;
+	let segments = parsed.segments;
+	if (parsed.kind === "absolute") {
+		const first = segments[0] ?? "";
+		if (first !== root.name && first !== "root") return {
+			ok: false,
+			problem: {
+				kind: "wrongRoot",
+				first,
+				root: String(root.name ?? "")
+			}
+		};
+		at = [];
+		segments = segments.slice(1);
+	} else at = [...owner];
+	for (const segment of segments) {
+		if (segment === "..") {
+			if (at.length === 0) return {
+				ok: false,
+				problem: { kind: "aboveRoot" }
+			};
+			at.pop();
+			continue;
+		}
+		const here = nodeAt(root, at);
+		const index = (here?.children ?? []).findIndex((child) => child.name === segment);
+		if (index < 0) return {
+			ok: false,
+			problem: {
+				kind: "noChild",
+				parent: String(here?.name ?? "?"),
+				segment
+			}
+		};
+		at.push(index);
+	}
+	return {
+		ok: true,
+		path: at
+	};
+}
+/** The problem in English, for `incanto-check` and as the editor's base text. */
+function describeRefProblem(problem, value) {
+	switch (problem.kind) {
+		case "grammar": return problem.message;
+		case "noMatch": return `'%${problem.name}' matches no node in this scene.`;
+		case "ambiguous": return `'%${problem.name}' matches ${problem.count} nodes — a %name must be unique.`;
+		case "wrongRoot": return `'${value}' starts at '${problem.first}', but the scene root is '${problem.root}' (or write '/root/…').`;
+		case "noChild": return `'${value}' leads nowhere — '${problem.parent}' has no child named '${problem.segment}'.`;
+		case "aboveRoot": return `'${value}' walks above the scene root.`;
+	}
+}
+/** Every prop on this node declared `nodePath: true`, per bag. */
+function refProps(node) {
+	const collect = (schema) => Object.entries(schema).filter(([, def]) => def?.nodePath).map(([key]) => key);
+	let props = [];
+	if (node.type) try {
+		props = collect(getNodeSchema(node.type));
+	} catch {}
+	const name = node.script?.name;
+	return {
+		props,
+		script: name ? collect(behaviorSchema(name)) : []
+	};
+}
+/**
+* Scene lints for node-path props that point at nothing.
+*
+* An EMPTY value is not reported: `''` is the default of most of these props and
+* means "not set", which is a choice rather than a typo.
+*/
+function nodeRefWarnings(scene) {
+	const root = scene.root;
+	if (!root) return [];
+	const warnings = [];
+	const walk = (node, at, path) => {
+		const keys = refProps(node);
+		const bags = [[
+			node.props,
+			keys.props,
+			""
+		], [
+			node.script?.props,
+			keys.script,
+			`${node.script?.name ?? "script"}.`
+		]];
+		for (const [bag, propKeys, prefix] of bags) {
+			if (!bag) continue;
+			for (const key of propKeys) {
+				const value = bag[key];
+				if (typeof value !== "string" || value === "") continue;
+				const result = resolveRefInJson(root, at, value);
+				if (result.ok) continue;
+				warnings.push(`${path}: ${prefix}${key} — ${describeRefProblem(result.problem, value)} The scene loads and the prop does nothing.`);
+			}
+		}
+		(node.children ?? []).forEach((child, i) => {
+			walk(child, [...at, i], `${path}/${child.name ?? "?"}`);
+		});
+	};
+	walk(root, [], String(root.name ?? "root"));
+	return warnings;
+}
+//#endregion
 //#region src/core/audit.ts
 const ANIMATED_TYPES = new Set([
 	"Particles2D",
@@ -88,6 +280,7 @@ function auditScene(scene) {
 	if (cameras > 0 && currentCameras === 0) warnings.push("no camera has \"current\": true — the screen renders from a default view, probably not what you framed.");
 	if (currentCameras > 1) warnings.push(`${currentCameras} cameras claim "current": true — only the first found wins.`);
 	if (scene.dimension === "3d" && lights === 0 && !isLit(scene.environment)) warnings.push("nothing lights this 3D scene — no light node, no environment sky/hdri, and no ambient intensity. It will render black. Add a DirectionalLight3D, or an \"environment\": { \"sky\": { \"type\": \"atmosphere\" } } / { \"preset\": \"...\" }.");
+	for (const warning of nodeRefWarnings(scene)) warnings.push(warning);
 	for (const warning of auditStrings(scene)) warnings.push(warning);
 	return warnings;
 }
@@ -217,4 +410,4 @@ function replay(engine, recording, opts) {
 	}
 }
 //#endregion
-export { startRecording as n, auditScene as r, replay as t };
+export { nodeRefWarnings as a, describeRefProblem as i, startRecording as n, resolveRefInJson as o, auditScene as r, replay as t };