incanto 0.50.0 → 0.52.0

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

@@ -1,4 +1,4 @@
-import { Et as Node, d as PropSchema, st as Listener } from "./behavior-62q0HWBO.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-_9VBOHn6.js → physics-2d-Dns-oZlE.js}

@@ -1,7 +1,7 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { v as diagnose } from "./loader-DwazzlQb.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-BNPZYJmd.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({
@@ -39,6 +39,7 @@ var Physics2D = class {
 	world;
 	events;
 	kcc;
+	disconnectScene;
 	disconnect;
 	lastDt = 1 / 60;
 	optsGravity;
@@ -63,6 +64,9 @@ var Physics2D = class {
 		this.events = new R.EventQueue(true);
 		this.unregisterDebug = registerDebugSource(this);
 		this.disconnect = engine.fixedUpdated.connect((dt) => this.step(dt));
+		this.disconnectScene = engine.sceneChanged.connect(() => {
+			if (engine.scene) this.syncBodies();
+		});
 		this.syncBodies();
 	}
 	/** @internal Driven by engine.fixedUpdated. */
@@ -305,6 +309,7 @@ var Physics2D = class {
 	}
 	dispose() {
 		this.disconnect();
+		this.disconnectScene();
 		this.unregisterDebug();
 		this.world.free();
 	}

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

@@ -1,9 +1,9 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { v as diagnose } from "./loader-DwazzlQb.js";
+import { C as diagnose } from "./loader-B-Gft32x.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-DbaI313d.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-XFuqu5jv.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
 /**
@@ -234,6 +234,7 @@ var Physics3D = class {
 	world;
 	events;
 	kcc;
+	disconnectScene;
 	disconnect;
 	lastDt = 1 / 60;
 	optsGravity;
@@ -259,6 +260,9 @@ var Physics3D = class {
 		this.events = new R.EventQueue(true);
 		this.unregisterDebug = registerDebugSource(this);
 		this.disconnect = engine.fixedUpdated.connect((dt) => this.step(dt));
+		this.disconnectScene = engine.sceneChanged.connect(() => {
+			if (engine.scene) this.syncBodies();
+		});
 		this.syncBodies();
 	}
 	/** Whether the solver runs at all. False = collider outlines only. */
@@ -460,6 +464,7 @@ var Physics3D = class {
 	}
 	dispose() {
 		this.disconnect();
+		this.disconnectScene();
 		this.unregisterDebug();
 		this.world.free();
 	}

package/dist/react.d.ts

@@ -1,4 +1,4 @@
-import { P as Scene, b as Engine, n as BehaviorCtor } from "./behavior-62q0HWBO.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-DqqxEax1.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-BLDjy_PW.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-uvaZj1KX.js → register-DVwlnZAZ.js}

@@ -1,7 +1,7 @@
-import { E as Signal, _ as InputMap, b as behaviorSchema, f as Node, g as resolveOrderGroups, m as ORDER_GROUP_BASE, v as diagnose } from "./loader-DwazzlQb.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`
@@ -1134,267 +1134,6 @@ var LogManager = class {
 	}
 };
 //#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/save-slots.ts
-/**
-* Save slots — "continue where you left off", which no game on this engine could
-* do.
-*
-* `createSaveStore` has been here a long time and `Scene.toJSON()` round-trips a
-* live tree, so two thirds of the work existed. The missing third was that
-* BEHAVIOR state had nowhere to go: `Behavior` declared `onEnterTree`, `onReady`,
-* `onExitTree`, `update` and `fixedUpdate` and nothing for "write yourself down",
-* so `Health.current`, `ScoreKeeper.score` and every quest flag were
-* unrecoverable. Both quest templates this repo ships were RPGs you could not
-* resume.
-*
-* ## What a save is, and what it deliberately is NOT
-*
-* A save is **which scene, plus every behavior's state, keyed by node uid**. It
-* is not a snapshot of the live tree.
-*
-* That is a design decision, not a shortcut. Restoring a live tree by walking
-* paths breaks on this engine specifically:
-*
-* - `Spawner.onReady` DETACHES its prefab template from the tree (see
-*   `SpawnSource.resolveTemplate`), so a captured tree and a freshly booted one
-*   legitimately disagree about which nodes exist, every time.
-*   Every scene with a spawner would report phantom removals.
-* - A spawned enemy carrying its own spawner has already lost ITS template, so
-*   re-adding that subtree runs `onReady` against a node that is not there and
-*   throws — and `onReady` is not quarantined, so it kills the whole load.
-* - Prop deltas cannot be applied with `applySchemaProps`, which resets every
-*   prop to its default before writing.
-*
-* Reloading the scene from source sidesteps all three: the structure comes from
-* the file (which is authoritative and already validated), and the save carries
-* only what the file cannot know. A fresh boot detaches the same templates the
-* captured one did, so there is nothing to reconcile.
-*
-* The cost, stated plainly so nobody discovers it: **spawned enemies and
-* mid-level positions are not restored.** You resume at the scene's start with
-* your stats, inventory, unlocks and quest flags intact. That is what a
-* checkpoint save is, and it is what both quest templates need. A game that
-* wants a position saves it — `serialize()` can return anything.
-*
-* Node uids are the join key because they are the one identifier the engine
-* already promises survives a rename or a reparent.
-*/
-/**
-* Every behavior in the tree that has something to say, by uid.
-*
-* A behavior with no `serialize` contributes nothing — the hook is optional in
-* exactly the way the other five are, so adding save support to a game is
-* additive and a game that never saves pays nothing.
-*
-* A node with no `uid` is skipped and reported, because state keyed by nothing
-* cannot be given back. The editor assigns a uid to every node it touches; a
-* hand-written scene may not have.
-*/
-function captureBehaviors(root) {
-	const state = {};
-	const unaddressable = [];
-	const walk = (node) => {
-		const behavior = node.behavior;
-		if (behavior && typeof behavior.serialize === "function") {
-			const value = behavior.serialize();
-			if (value !== void 0) if (node.uid) state[node.uid] = value;
-			else unaddressable.push(node.getPath());
-		}
-		for (const child of node.children) walk(child);
-	};
-	walk(root);
-	return {
-		state,
-		unaddressable
-	};
-}
-/**
-* Hand each behavior its state back.
-*
-* Call this AFTER the scene has loaded and `onReady` has run: `onReady` is where
-* a behavior sets its starting values, so restoring first would be overwritten
-* by the fresh start.
-*
-* Never throws on a mismatch. A save from an older build of the game will name
-* uids that no longer exist, and refusing to load it would mean a patch that
-* moves one node deletes everyone's progress. It reports instead.
-*/
-function restoreBehaviors(root, state) {
-	const report = {
-		missing: [],
-		skipped: [],
-		restored: 0
-	};
-	for (const [uid, value] of Object.entries(state)) {
-		const node = root.getNodeByUid(uid);
-		if (!node) {
-			report.missing.push(uid);
-			continue;
-		}
-		const behavior = node.behavior;
-		if (!behavior || typeof behavior.deserialize !== "function") {
-			report.skipped.push(uid);
-			continue;
-		}
-		try {
-			behavior.deserialize(value);
-			report.restored += 1;
-		} catch {
-			report.skipped.push(uid);
-		}
-	}
-	return report;
-}
-/** Slot ids, so a "3 save slots" menu is a list and not a naming convention. */
-const INDEX_KEY = "slots";
-/**
-* The slot layer: a named list of saves over the existing store.
-*
-* Slot ids are yours (`'auto'`, `'1'`, `'2'`, `'3'`) — the engine does not
-* decide how many you have or whether one of them autosaves.
-*/
-var SaveSlots = class {
-	store;
-	constructor(namespace = "saves", store) {
-		this.store = store ?? createSaveStore(namespace);
-	}
-	/** Slot ids that have a save, newest first. */
-	list() {
-		const rows = this.store.get(INDEX_KEY, []).map((id) => ({
-			id,
-			slot: this.read(id)
-		})).filter((row) => row.slot !== null);
-		rows.sort((a, b) => b.slot.savedAt - a.slot.savedAt);
-		return rows.map((row) => row.id);
-	}
-	/** Every slot with its contents — what a load menu actually renders. */
-	all() {
-		return this.list().map((id) => ({
-			id,
-			...this.read(id)
-		}));
-	}
-	read(id) {
-		const raw = this.store.get(key(id), null);
-		if (raw === null || typeof raw !== "object" || Array.isArray(raw)) return null;
-		const slot = raw;
-		if (typeof slot.scene !== "string" || typeof slot.state !== "object" || slot.state === null) return null;
-		return {
-			scene: slot.scene,
-			state: slot.state,
-			label: typeof slot.label === "string" ? slot.label : "",
-			savedAt: typeof slot.savedAt === "number" ? slot.savedAt : 0,
-			playtime: typeof slot.playtime === "number" ? slot.playtime : 0,
-			data: slot.data ?? {}
-		};
-	}
-	/**
-	* Write a slot.
-	*
-	* `savedAt` is a parameter rather than `Date.now()` so a test can assert an
-	* ordering without sleeping, and so a game that wants server time can use it.
-	*/
-	write(id, slot) {
-		const full = {
-			scene: slot.scene,
-			state: slot.state,
-			label: slot.label ?? "",
-			savedAt: slot.savedAt ?? 0,
-			playtime: slot.playtime ?? 0,
-			data: slot.data ?? {}
-		};
-		this.store.set(key(id), full);
-		const ids = this.store.get(INDEX_KEY, []);
-		if (!ids.includes(id)) this.store.set(INDEX_KEY, [...ids, id]);
-	}
-	remove(id) {
-		this.store.remove(key(id));
-		this.store.set(INDEX_KEY, this.store.get(INDEX_KEY, []).filter((other) => other !== id));
-	}
-	/** Wipe every slot — a "delete all data" button, and test isolation. */
-	clear() {
-		for (const id of this.store.get(INDEX_KEY, [])) this.store.remove(key(id));
-		this.store.set(INDEX_KEY, []);
-	}
-};
-function key(id) {
-	return `slot:${id}`;
-}
-/**
-* Behaviors in this tree that hold state and cannot save it — the audit's
-* question, answerable before a player loses an hour.
-*
-* A behavior with props but no `serialize` is not necessarily wrong (an
-* `Oscillate` derives everything from time), so this reports rather than warns,
-* and the caller decides.
-*/
-function behaviorsWithoutSave(root) {
-	const out = [];
-	const walk = (node) => {
-		const behavior = node.behavior;
-		const name = node.script?.name;
-		if (behavior && typeof name === "string" && typeof behavior.serialize !== "function") {
-			if (Object.keys(behaviorSchema(name)).length > 0) out.push(`${node.getPath()} (${name})`);
-		}
-		for (const child of node.children) walk(child);
-	};
-	walk(root);
-	return out;
-}
-//#endregion
 //#region src/core/settings.ts
 const DEFAULTS = {
 	master: 1,
@@ -1890,7 +1629,7 @@ var Engine = class {
 	captureState() {
 		const root = this.scene?.root;
 		if (!root) return {};
-		const { state, unaddressable } = captureBehaviors(root);
+		const { state, unaddressable } = captureBehaviors(root, this.scene?.source);
 		for (const path of unaddressable) diagnose(this, "warn", `save: ${path} has state to save and no uid to key it under.`);
 		return state;
 	}
@@ -1900,7 +1639,9 @@ var Engine = class {
 		if (!root) return {
 			missing: Object.keys(state),
 			skipped: [],
-			restored: 0
+			restored: 0,
+			expected: 0,
+			freed: 0
 		};
 		return restoreBehaviors(root, state);
 	}
@@ -2399,6 +2140,19 @@ function widgetFromElement(el) {
 let dragging = null;
 /** Shared plumbing: mount into the parent HudLayer's anchor slot. */
 var HudWidgetBase = class extends Node {
+	/**
+	* Wireable visibility: `noSave → Continue.hide`.
+	*
+	* `visible` is a prop, and a `connections[]` handler has to be a METHOD — the
+	* same wall that kept a score off the screen until widgets grew `setText`. A
+	* title screen greying out its own Continue button is the case that asked.
+	*/
+	show(..._args) {
+		this.visible = true;
+	}
+	hide() {
+		this.visible = false;
+	}
 	static props = {
 		anchor: {
 			default: "topLeft",
@@ -3630,4 +3384,4 @@ function registerCoreNodes() {
 	registerNode(UiRenderScaleSelect);
 }
 //#endregion
-export { T_PREFIX as A, synthSfx as B, behaviorsWithoutSave as C, LogManager as D, createSaveStore as E, ROLLOFF_MODELS as F, AudioBuses as G, WebAudioMusicBackend as H, spatialGain as I, spatialPan as L, translationKey as M, SfxEngine as N, BASE_LOCALE as O, isAudioContextAvailable as P, SFX_PRESETS as R, SaveSlots as S, restoreBehaviors as T, crossfadeGains as U, MusicManager as V, fadeGain as W, qualityCaps as _, UiSlider as a, readDeviceHints as b, UiButton as c, UiBanner as d, UiBar as f, Settings as g, Engine as h, UiSelect as i, suggestLocale as j, Localization as k, UiDialogue as l, AudioPlayer as m, UiImage as n, UiToggle as o, UiText as p, UiPanel as r, Timer as s, registerCoreNodes as t, HudLayer as u, qualityEnvironment as v, captureBehaviors as w, suggestQuality as x, qualityRendering as y, SFX_PRESET_NAMES as z };
+export { ROLLOFF_MODELS as A, AudioBuses as B, BASE_LOCALE as C, translationKey as D, suggestLocale as E, synthSfx as F, MusicManager as I, WebAudioMusicBackend as L, spatialPan as M, SFX_PRESETS as N, SfxEngine as O, SFX_PRESET_NAMES as P, crossfadeGains as R, LogManager as S, T_PREFIX as T, qualityCaps as _, UiSlider as a, readDeviceHints as b, UiButton as c, UiBanner as d, UiBar as f, Settings as g, Engine as h, UiSelect as i, spatialGain as j, isAudioContextAvailable as k, UiDialogue as l, AudioPlayer as m, UiImage as n, UiToggle as o, UiText as p, UiPanel as r, Timer as s, registerCoreNodes as t, HudLayer as u, qualityEnvironment as v, Localization as w, suggestQuality as x, qualityRendering as y, fadeGain as z };

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

@@ -1,8 +1,8 @@
-import { f as Node, h as effectiveOrder } from "./loader-DwazzlQb.js";
-import { t as registerCoreNodes } from "./register-uvaZj1KX.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-DYdy1wb0.d.ts → replay-BU1CCM15.d.ts}

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