incanto 0.70.0 → 0.71.0

package/dist/{register-6DYnKZcy.js → register-DuVdzxbq.js}

@@ -1,5 +1,5 @@
 import { o as __exportAll } from "./json-CfTjpvW8.js";
-import { B as TAPPABLE, G as requireText, H as UiBar, K as Node, L as FITS, N as resolveOrderGroups, P as InputMap, R as HudLayer, U as UiText, V as UiBanner, a as restoreBehaviors, i as captureBehaviors, j as ORDER_GROUP_BASE, k as createSaveStore, ot as Signal, q as diagnose, t as ENGINE_STATE_KEY, z as HudWidgetBase } from "./save-slots-BXVg148r.js";
+import { B as HudLayer, F as resolveOrderGroups, G as UiText, H as TAPPABLE, I as InputMap, J as Node, N as ORDER_GROUP_BASE, U as UiBanner, V as HudWidgetBase, W as UiBar, Y as diagnose, a as restoreBehaviors, ct as Signal, i as captureBehaviors, j as createSaveStore, q as requireText, t as ENGINE_STATE_KEY, z as FITS } from "./save-slots-Bvuh2p_r.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as Rng } from "./rng-CDOMybym.js";
 import { p as registerNode } from "./touch-BnCyPA0G.js";
@@ -2470,7 +2470,11 @@ var Engine = class {
 			this._scene.root.free();
 			this._scene.tree._setEngine(null);
 			this._scene = null;
-			this.sceneChanged.emit(null);
+			try {
+				this.sceneChanged.emit(null);
+			} catch (error) {
+				diagnose(this, "warn", "[incanto] teardown: a `sceneChanged` listener threw (continuing) — it fires with NULL here, so a handler that reads the scene has to check for it", error);
+			}
 		}
 		this.input.dispose();
 		this.input.clear();
@@ -3612,7 +3616,20 @@ var UiSlider = class extends HudWidgetBase {
 	/** Left/right nudge by one step — the only sane thing a d-pad can mean here. */
 	_activate(dir) {
 		if (dir === 0) return;
-		const next = Math.min(this.max, Math.max(this.min, this.value + dir * this.step));
+		this.choose(this.value + dir * this.step);
+	}
+	/**
+	* Move it as a PERSON would: set the value and say so.
+	*
+	* `UiButton` has `press()` and the value widgets had nothing, because
+	* assigning `.value` deliberately does not emit (restoring a saved setting
+	* must not fire the handler that saved it). So a harness — or a game driving
+	* its own menu: a preset button, "reset to defaults", a tutorial that moves a
+	* slider for you — had one route to "the player changed this", and it was
+	* `_activate`, which is internal and takes a direction rather than a value.
+	*/
+	choose(value) {
+		const next = Math.min(this.max, Math.max(this.min, value));
 		if (next === this.value) return;
 		this.value = next;
 		this.last = next;
@@ -3670,12 +3687,15 @@ var UiToggle = class extends HudWidgetBase {
 	focusable = true;
 	/** Confirm flips it; left/right set it explicitly, which reads better on a pad. */
 	_activate(dir) {
-		const next = dir === 0 ? !this.value : dir > 0;
-		if (next === this.value) return;
-		this.value = next;
-		this.last = next;
-		if (this.input) this.input.checked = next;
-		this.emit("changed", next);
+		this.choose(dir === 0 ? !this.value : dir > 0);
+	}
+	/** Flip it as a PERSON would: set the value and say so. See `UiSlider.choose`. */
+	choose(value) {
+		if (value === this.value) return;
+		this.value = value;
+		this.last = value;
+		if (this.input) this.input.checked = value;
+		this.emit("changed", value);
 	}
 	input = null;
 	last = null;
@@ -3754,14 +3774,28 @@ var UiSelect = class extends HudWidgetBase {
 	}
 	/** Left/right (and confirm) walk the list — a select has no other gesture. */
 	_activate(dir) {
-		const choices = this.options.split(",").map((o) => o.trim()).filter(Boolean);
+		const choices = this.choices();
 		if (choices.length === 0) return;
 		const next = choices[(Math.max(0, choices.indexOf(this.value)) + (dir === 0 ? 1 : dir) + choices.length) % choices.length];
-		if (!next || next === this.value) return;
-		this.value = next;
-		this.last = next;
-		if (this.select) this.select.value = next;
-		this.emit("changed", next);
+		if (next) this.choose(next);
+	}
+	/**
+	* Pick an option as a PERSON would: set the value and say so. See
+	* `UiSlider.choose`.
+	*
+	* An option the list does not offer is refused, for the reason
+	* `validateJson` refuses it in the file: the browser would show the first one
+	* while the node kept answering with what it was given, and nothing would
+	* ever reconcile them.
+	*/
+	choose(value) {
+		const choices = this.choices();
+		if (choices.length > 0 && !choices.includes(value)) throw new IncantoError("PROP_TYPE_MISMATCH", `UiSelect '${this.name}': choose('${value}') is not one of its options [${choices.join(", ")}].`, { prop: "value" });
+		if (value === this.value) return;
+		this.value = value;
+		this.last = value;
+		if (this.select) this.select.value = value;
+		this.emit("changed", value);
 	}
 	select = null;
 	labelEl = null;

package/dist/{replay-DjAkAzMq.js → replay-DEvp3kyV.js}

@@ -1,5 +1,5 @@
-import { F as handlerShadowWarnings, I as sceneDimension, Y as nodeRefWarnings, z as HudWidgetBase } from "./save-slots-BXVg148r.js";
-import { N as translationKey } from "./register-6DYnKZcy.js";
+import { L as handlerShadowWarnings, R as sceneDimension, V as HudWidgetBase, Z as nodeRefWarnings } from "./save-slots-Bvuh2p_r.js";
+import { N as translationKey } from "./register-DuVdzxbq.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { u as getNodeType } from "./touch-BnCyPA0G.js";
 //#region src/core/audit.ts

package/dist/{replay-Dmw-PKQu.d.ts → replay-F7IZHdFR.d.ts}

@@ -1,4 +1,4 @@
-import { b as Engine } from "./behavior-DZExDn9o.js";
+import { b as Engine } from "./behavior-Dcz0fr1S.js";
 import { s as JsonObject } from "./rng-Bb-IutXB.js";
 
 //#region src/core/audit.d.ts

package/dist/{save-slots-BXVg148r.js → save-slots-Bvuh2p_r.js}

@@ -113,7 +113,10 @@ var Behavior = class {
 	*/
 	get engine() {
 		const engine = this.node?.tree?.engine;
-		if (!engine) throw new IncantoError("TREE_VIOLATION", `Behavior on '${this.node?.name ?? "?"}' is not attached to a running engine. If this came from \`onReady\` during a load, the scene does not know its engine yet: pass it — \`loadScene(json, { engine })\` — which is what createGame2D/3D and runScript do. Otherwise the node is not in a scene set on an Engine.`);
+		if (!engine) {
+			if (this.node?.freed) throw new IncantoError("TREE_VIOLATION", `Behavior on '${this.node.name}' has been FREED — a scene swap frees the tree it replaces, so \`this.engine\` (which reads \`this.node.tree\`) is gone with it. Hold it BEFORE the swap: \`const engine = this.engine; goToScene(engine, next);\` and use that afterwards.`);
+			throw new IncantoError("TREE_VIOLATION", `Behavior on '${this.node?.name ?? "?"}' is not attached to a running engine. If this came from \`onReady\` during a load, the scene does not know its engine yet: pass it — \`loadScene(json, { engine })\` — which is what createGame2D/3D and runScript do. Otherwise the node is not in a scene set on an Engine.`);
+		}
 		return engine;
 	}
 	/** Shortcut for `this.engine.input`. */
@@ -669,7 +672,11 @@ var Node = class {
 	*/
 	wiringPath() {
 		const parts = [];
-		for (let n = this; n; n = n._parent) parts.unshift(n._cloneOf ?? n._name);
+		for (let n = this; n; n = n._parent) {
+			const authored = n._authoredPath;
+			if (authored !== void 0) return parts.length === 0 ? authored : `${authored}/${parts.join("/")}`;
+			parts.unshift(n._cloneOf ?? n._name);
+		}
 		return `/${parts.join("/")}`;
 	}
 	getNode(path) {
@@ -874,9 +881,23 @@ var Node = class {
 		if (this._tree) this._tree._queueFree(this);
 		else this.free();
 	}
+	/**
+	* Has this node been torn down?
+	*
+	* A scene swap frees the tree it replaces, so the answer is `true` for every
+	* node of the scene you just left — which is exactly the state a behavior is
+	* in when it runs one more line after `goToScene`. Kept as a flag rather than
+	* inferred from `parent`/`tree`, because a DETACHED node (a prefab on a
+	* shelf, a clone waiting to be added) has neither and is perfectly alive.
+	*/
+	get freed() {
+		return this._freed;
+	}
+	_freed = false;
 	/** Immediately detach and tear down this node and its children. */
 	free() {
 		const tree = this._tree;
+		this._freed = true;
 		for (const child of [...this._children]) child.free();
 		this._parent?.removeChild(this);
 		if (this._tree) this._propagateExitTree();
@@ -5145,6 +5166,7 @@ function duplicateNode(node, opts) {
 	const clone = buildNodeJson(stripUids(serializeNode(node)), opts ?? rebuildOptions(node));
 	markCloned(clone);
 	markTemplateName(clone);
+	markTemplateOrigin(clone, node);
 	return clone;
 }
 /**
@@ -5196,6 +5218,37 @@ function markCloned(node) {
 function markTemplateName(node) {
 	node._cloneOf = node.name;
 }
+/**
+* @internal Where the template this clone came from was AUTHORED.
+*
+* `_cloneOf` (the name) is enough only while clones land where the template
+* was authored — the `Spawner` case (`/Waves/Grunt` template, `/Waves/Grunt2`
+* clone) and no other. A game that clones from a SHELF authors the template at
+* `/Game/Prefabs/Tower` and adds the clone under `/Game/Towers`, so its audio
+* was logged at `/Game/Towers/Tower/Thud`: a path no scene file contains, and
+* one no report that reads the file can ever match. Recording the address
+* itself is what lets `wiringPath` answer with the authored node wherever the
+* clone ends up — including a clone OF a clone, which carries it forward.
+*
+* Taken while the source is still in a tree; a template detached before the
+* first clone (`PrefabShelf`, `SpawnSource`) records its own on the way out.
+*/
+function markTemplateOrigin(clone, source) {
+	const origin = source._authoredPath ?? (source.tree ? source.getPath() : null);
+	if (origin) clone._authoredPath = origin;
+}
+/**
+* @internal Remember where a node was authored, before it leaves the tree.
+*
+* A shelf or a spawner lifts its templates out at enter; from then on the
+* template cannot say where it came from, and neither can anything cloned from
+* it. Called on the way out, while the answer is still there.
+*/
+function rememberAuthoredPath(node) {
+	const at = node;
+	if (at._authoredPath !== void 0) return;
+	if (node.tree || node.parent?.tree) at._authoredPath = node.getPath();
+}
 /** @internal Was this node made at runtime rather than loaded from a file? */
 function isCloned(node) {
 	return node._cloned === true;
@@ -5648,4 +5701,4 @@ function savesWithoutUid(root) {
 	return out;
 }
 //#endregion
-export { StubBehavior as $, resetMemorySaves as A, TAPPABLE as B, isConstRef as C, newUid as D, resolveViewport as E, handlerShadowWarnings as F, requireText as G, UiBar as H, sceneDimension as I, describeRefProblem as J, Node as K, FITS$1 as L, effectiveOrder as M, resolveOrderGroups as N, SceneTree as O, InputMap as P, Behavior as Q, HudLayer as R, CONST_REF_KEY as S, computeViewport as T, UiText as U, UiBanner as V, requireNumber as W, resolveRefInJson as X, nodeRefWarnings as Y, parseNodePath as Z, SCENE_FORMAT as _, restoreBehaviors as a, registeredBehaviors as at, sunDirectionFromElevationAzimuth as b, markCloned as c, stripUids as d, behaviorSchema as et, buildSceneSubtree as f, serializeNode as g, Scene as h, captureBehaviors as i, registerBehavior as it, ORDER_GROUP_BASE as j, createSaveStore as k, markTemplateName as l, loader_exports as m, SaveSlots as n, clearBehaviors as nt, savesWithoutUid as o, Signal as ot, loadScene as p, diagnose as q, behaviorsWithoutSave as r, getBehavior as rt, duplicateNode as s, ENGINE_STATE_KEY as t, behaviorSignals as tt, rebuildOptions as u, horizonColorFromSky as v, resolveConstants as w, sunDirectionFromSky as x, parseEnvironment3D as y, HudWidgetBase as z };
+export { parseNodePath as $, SceneTree as A, HudLayer as B, sunDirectionFromSky as C, computeViewport as D, resolveConstants as E, resolveOrderGroups as F, UiText as G, TAPPABLE as H, InputMap as I, Node as J, requireNumber as K, handlerShadowWarnings as L, resetMemorySaves as M, ORDER_GROUP_BASE as N, resolveViewport as O, effectiveOrder as P, resolveRefInJson as Q, sceneDimension as R, sunDirectionFromElevationAzimuth as S, isConstRef as T, UiBanner as U, HudWidgetBase as V, UiBar as W, describeRefProblem as X, diagnose as Y, nodeRefWarnings as Z, Scene as _, restoreBehaviors as a, getBehavior as at, horizonColorFromSky as b, isCloned as c, Signal as ct, rebuildOptions as d, Behavior as et, rememberAuthoredPath as f, loader_exports as g, loadScene as h, captureBehaviors as i, clearBehaviors as it, createSaveStore as j, newUid as k, markCloned as l, buildSceneSubtree as m, SaveSlots as n, behaviorSchema as nt, savesWithoutUid as o, registerBehavior as ot, stripUids as p, requireText as q, behaviorsWithoutSave as r, behaviorSignals as rt, duplicateNode as s, registeredBehaviors as st, ENGINE_STATE_KEY as t, StubBehavior as tt, markTemplateName as u, serializeNode as v, CONST_REF_KEY as w, parseEnvironment3D as x, SCENE_FORMAT as y, FITS$1 as z };

package/dist/{split-screen--k-XpBjr.d.ts → split-screen-CIYf1zSf.d.ts}

@@ -1,7 +1,7 @@
-import { Lt as Signal, b as Engine, jt as Node } from "./behavior-DZExDn9o.js";
+import { Lt as Signal, b as Engine, jt as Node } from "./behavior-Dcz0fr1S.js";
 import { t as DiagnosticSink } from "./diagnostics-Cu85N3tL.js";
 import { a as SceneJson, c as JsonValue, s as JsonObject } from "./rng-Bb-IutXB.js";
-import { t as LoadSceneOptions } from "./loader-Cff09LMm.js";
+import { t as LoadSceneOptions } from "./loader-8-IHvbKD.js";
 
 //#region src/net/types.d.ts
 type Unsubscribe = () => void;

package/dist/{split-screen-PL78oVXP.js → split-screen-eULetcg-.js}

@@ -1,6 +1,6 @@
 import { n as jsonEquals, t as jsonClone } from "./json-CfTjpvW8.js";
-import { K as Node, c as markCloned, d as stripUids, f as buildSceneSubtree, l as markTemplateName, ot as Signal, p as loadScene, q as diagnose, u as rebuildOptions } from "./save-slots-BXVg148r.js";
-import { t as registerCoreNodes, v as Engine } from "./register-6DYnKZcy.js";
+import { J as Node, Y as diagnose, ct as Signal, d as rebuildOptions, h as loadScene, l as markCloned, m as buildSceneSubtree, p as stripUids, u as markTemplateName } from "./save-slots-Bvuh2p_r.js";
+import { t as registerCoreNodes, v as Engine } from "./register-DuVdzxbq.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { p as registerNode } from "./touch-BnCyPA0G.js";
 //#region src/net/loopback.ts
@@ -1150,7 +1150,7 @@ function applySyncPatch(root, patch, setProp, onMissingNode) {
 	}
 }
 async function createDefaultTransport(config, diagnostics) {
-	const { createAgent8Server } = await import("./agent8-CmNF01gA.js").then((n) => n.t);
+	const { createAgent8Server } = await import("./agent8-Cfmd3ar_.js").then((n) => n.t);
 	return createAgent8Server(config, diagnostics);
 }
 //#endregion

package/dist/{src-Cxfiv1Hg.js → src-_jk0qLsS.js}

@@ -199,6 +199,6 @@ async function preloadSceneAssets(assets, title) {
 //#endregion
 //#region src/index.ts
 /** Engine version. Kept in sync with package.json by the release pipeline. */
-const VERSION = "0.70.0";
+const VERSION = "0.71.0";
 //#endregion
 export { findPath as a, preloadUrls as i, assetUrls as n, gridFromRows as o, preloadSceneAssets as r, VERSION as t };