incanto 0.59.0 → 0.61.0

package/dist/{loader-TvkRFbyL.d.ts → loader-DolLJWJn.d.ts}

@@ -1,4 +1,4 @@
-import { P as Scene, b as Engine } from "./behavior-DWKTUzKI.js";
+import { P as Scene, b as Engine } from "./behavior-DsgayMsH.js";
 import { i as SceneJson } from "./schema-CFeioQRE.js";
 
 //#region src/core/scene/loader.d.ts
@@ -6,6 +6,18 @@ interface LoadSceneOptions {
   /** Resolve a sub-scene path referenced by `{instance: '<path>'}`. */
   resolveScene?: (path: string) => SceneJson;
   /**
+  * Assets declared ELSEWHERE in the project, for `$ref` validation.
+  *
+  * A scene a `NetworkSpawner` spawns resolves its refs against the HOST's
+  * `assets{}` — `remote-player.scene.json` names `$characters/base` and
+  * declares nothing itself, which is correct and cannot be checked from that
+  * one file. A tool with the whole project passes the union in; loading the
+  * file alone still fails, because alone it really cannot resolve.
+  */
+  declaredAssets?: Record<string, {
+    type?: unknown;
+  }>;
+  /**
   * Tool/preview mode (the editor's ▶ play strips behaviors — and their
   * `static signals` with them): declare each connection's signal on its
   * from-node instead of hard-failing with UNKNOWN_SIGNAL. Games should

package/dist/net.d.ts

@@ -1,5 +1,5 @@
-import { At as Node, d as PropSchema } from "./behavior-DWKTUzKI.js";
-import { a as NetworkManagerOptions, c as LocalGameServer, d as ServerClass, f as createLocalGameServer, g as Unsubscribe, h as NetworkTransport, i as NetworkManager, l as LocalGameServerOptions, m as LoopbackTransport, n as SplitScreenPlayer, o as applySyncPatch, p as LoopbackHub, r as createSplitScreen, s as CollectionOptions, t as SplitScreenOptions, u as LocalGameServerTransport } from "./split-screen-BQ3tAsf-.js";
+import { d as PropSchema, jt as Node } from "./behavior-DsgayMsH.js";
+import { a as NetworkManagerOptions, c as LocalGameServer, d as ServerClass, f as createLocalGameServer, g as Unsubscribe, h as NetworkTransport, i as NetworkManager, l as LocalGameServerOptions, m as LoopbackTransport, n as SplitScreenPlayer, o as applySyncPatch, p as LoopbackHub, r as createSplitScreen, s as CollectionOptions, t as SplitScreenOptions, u as LocalGameServerTransport } from "./split-screen-D7OopelJ.js";
 
 //#region src/net/agent8.d.ts
 /**

package/dist/net.js

@@ -1,3 +1,3 @@
 import { n as createAgent8Server } from "./agent8-CvsfVskX.js";
-import { a as NetworkManager, d as createLocalGameServer, f as LoopbackHub, l as LocalGameServer, n as registerNodesNet, o as applySyncPatch, p as LoopbackTransport, r as NetworkSpawner, t as createSplitScreen, u as LocalGameServerTransport } from "./split-screen-DDMZutQ6.js";
+import { a as NetworkManager, d as createLocalGameServer, f as LoopbackHub, l as LocalGameServer, n as registerNodesNet, o as applySyncPatch, p as LoopbackTransport, r as NetworkSpawner, t as createSplitScreen, u as LocalGameServerTransport } from "./split-screen-5Ban4q4n.js";
 export { LocalGameServer, LocalGameServerTransport, LoopbackHub, LoopbackTransport, NetworkManager, NetworkSpawner, applySyncPatch, createAgent8Server, createLocalGameServer, createSplitScreen, registerNodesNet };

package/dist/pathfinding-_fGrCFmH.d.ts

@@ -0,0 +1,28 @@
+//#region src/core/pathfinding.d.ts
+/**
+* Grid A* — the pathfinding every top-down/RPG/tower-defense asks for and
+* agents keep re-inventing badly. Pure and dimension-free: cells in, cells
+* out; the caller maps cells to world units (px, meters, tiles).
+*/
+interface PathGrid {
+  width: number;
+  height: number;
+  /** True = impassable. Out-of-bounds is always solid. */
+  solid(x: number, y: number): boolean;
+}
+interface FindPathOptions {
+  /** Allow diagonal steps (blocked from cutting corners). Default true. */
+  diagonal?: boolean;
+  /** Abort guard for huge/impossible searches. Default 20000 nodes. */
+  maxExpansions?: number;
+}
+/**
+* A* from `from` to `to` (inclusive cell coords). Returns the cell path
+* INCLUDING both endpoints, or null when unreachable. Straight steps cost
+* 1, diagonals √2; the heuristic is octile (admissible for both modes).
+*/
+declare function findPath(grid: PathGrid, from: [number, number], to: [number, number], opts?: FindPathOptions): [number, number][] | null;
+/** Build a PathGrid from row-strings ('#' = solid) — tests and tile games. */
+declare function gridFromRows(rows: readonly string[]): PathGrid;
+//#endregion
+export { gridFromRows as i, PathGrid as n, findPath as r, FindPathOptions as t };

package/dist/{physics-2d-BaRSRrrZ.js → physics-2d-CBnor8Zf.js}

@@ -1,7 +1,7 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { w as diagnose } from "./loader-D8n7TU8W.js";
+import { k as diagnose } from "./loader-D7jTvDQv.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-BpFcgdcL.js";
+import { _ as RigidBody2D, b as validateCollider2D, g as PhysicsBody2D, h as CharacterBody2D, m as Area2D, p as Joint2D, y as Node2D } from "./register-DL3izw8j.js";
 import { n as registerDebugSource } from "./debug-draw-BM3DsvtT.js";
 import { t as withoutRapierInitNoise } from "./quiet-rapier-BAJ4K94N.js";
 //#region src/2d/physics/physics-2d.ts

package/dist/{physics-3d-CYxjh-HW.js → physics-3d-BTUfUSWO.js}

@@ -1,10 +1,10 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { w as diagnose } from "./loader-D8n7TU8W.js";
+import { k as diagnose } from "./loader-D7jTvDQv.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
-import { H as validateCollider3D, I as Area3D, L as CharacterBody3D, R as PhysicsBody3D, V as Node3D, z as RigidBody3D } from "./gameplay-BBEjPFsR.js";
+import { H as validateCollider3D, I as Area3D, L as CharacterBody3D, R as PhysicsBody3D, V as Node3D, z as RigidBody3D } from "./gameplay-Dtzd2itW.js";
 import { n as registerDebugSource } from "./debug-draw-BM3DsvtT.js";
 import { t as withoutRapierInitNoise } from "./quiet-rapier-BAJ4K94N.js";
-import { A as Terrain3D, F as InstancedMesh3D, L as buildMeshGeometry, P as Joint3D } from "./environment-presets-DRAz5EV9.js";
+import { A as Terrain3D, F as InstancedMesh3D, L as buildMeshGeometry, P as Joint3D } from "./environment-presets-CNxCuhZF.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-DWKTUzKI.js";
+import { P as Scene, b as Engine, n as BehaviorCtor } from "./behavior-DsgayMsH.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-BiW8Men_.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-CHDLDQsQ.js").then((n) => n.n)).createGame2D(o)))(opts);
+			const next = await (_gameFactory ?? (mode === "3d" ? async (o) => (await import("./create-game-IX5lEH0P.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-DH7JI5xx.js").then((n) => n.n)).createGame2D(o)))(opts);
 			if (disposed) {
 				next.dispose();
 				return;

package/dist/{register-BpFcgdcL.js → register-DL3izw8j.js}

@@ -1,8 +1,8 @@
-import { C as Node, b as effectiveOrder, w as diagnose } from "./loader-D8n7TU8W.js";
-import { I as translateOn, t as registerCoreNodes } from "./register-CDrAQqPp.js";
+import { O as Node, k as diagnose, w as effectiveOrder } from "./loader-D7jTvDQv.js";
+import { I as translateOn, t as registerCoreNodes } from "./register-xuSRyD6b.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-WWcQcfMr.js";
+import { i as getNodeSchema, l as registerNode } from "./registry-CF70EArN.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-CY-mrr1L.js";
 import { t as checkSheetGrid } from "./sheet-grid-BT6N_Bjs.js";
 import { AdditiveBlending, BufferAttribute, BufferGeometry, CanvasTexture, Color, DynamicDrawUsage, Group, InstancedMesh, MathUtils, Matrix4, Mesh, MeshBasicMaterial, NearestFilter, NormalBlending, Object3D, PlaneGeometry, SRGBColorSpace } from "three";
@@ -302,7 +302,8 @@ var Joint2D = class extends Node2D {
 		},
 		target: {
 			default: "",
-			nodePath: true
+			nodePath: true,
+			required: true
 		},
 		anchor: { default: [0, 0] },
 		targetAnchor: { default: [0, 0] },
@@ -344,7 +345,13 @@ const UNIT_PLANE$2 = new PlaneGeometry(1, 1);
 var Sprite2D = class extends Node2D {
 	static typeName = "Sprite2D";
 	static props = {
-		texture: { default: "" },
+		texture: {
+			default: "",
+			asset: {
+				kind: "texture",
+				refOnly: true
+			}
+		},
 		anchor: { default: [.5, .5] },
 		flipX: { default: false },
 		flipY: { default: false },
@@ -422,7 +429,13 @@ var AnimatedSprite2D = class extends Sprite2D {
 	static typeName = "AnimatedSprite2D";
 	static signals = ["animationFinished"];
 	static props = {
-		sheet: { default: "" },
+		sheet: {
+			default: "",
+			asset: {
+				kind: "spritesheet",
+				refOnly: true
+			}
+		},
 		animations: { default: {} },
 		autoplay: { default: "" }
 	};
@@ -828,7 +841,14 @@ var Label = class extends Node2D {
 		fontSize: { default: 16 },
 		color: { default: "#ffffff" },
 		font: { default: "monospace" },
-		align: { default: "left" }
+		align: { default: "left" },
+		opacity: {
+			default: 1,
+			range: {
+				min: 0,
+				max: 1
+			}
+		}
 	};
 	text = "";
 	fontSize = 16;
@@ -836,6 +856,16 @@ var Label = class extends Node2D {
 	font = "monospace";
 	/** 'left' | 'center' | 'right' — anchor of the text block on the node origin. */
 	align = "left";
+	/**
+	* 0..1, like `Sprite2D` and `ColorRect2D`.
+	*
+	* Label was the one 2D drawable without it, and the gap showed up through
+	* `FloatAway` — whose own doc names "a 2D `Label`" as a node it works on.
+	* `FloatAway` writes `opacity` when the node has one, so on a Label the
+	* number rose to full height at FULL opacity and then vanished in a single
+	* frame: the pop that behavior exists to avoid.
+	*/
+	opacity = 1;
 	quadMesh = null;
 	canvas = null;
 	lastKey = "";
@@ -863,7 +893,8 @@ var Label = class extends Node2D {
 			this.lastKey = key;
 			this.rasterize();
 		}
-		quad.visible = true;
+		quad.visible = this.opacity > 0;
+		quad.material.opacity = this.opacity;
 		quad.renderOrder = this.effectiveRenderOrder;
 	}
 	rasterize() {
@@ -1306,7 +1337,13 @@ var TileMap2D = class extends Node2D {
 	static typeName = "TileMap2D";
 	static props = {
 		/** Atlas texture asset ref; tiles are tileSize×tileSize squares in it. */
-		texture: { default: "" },
+		texture: {
+			default: "",
+			asset: {
+				kind: "texture",
+				refOnly: true
+			}
+		},
 		tileSize: { default: 32 },
 		/** Atlas columns; 0 = derive from the texture width. */
 		columns: { default: 0 },

package/dist/{register-CDrAQqPp.js → register-xuSRyD6b.js}

@@ -1,8 +1,8 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { C as Node, N as Signal, S as InputMap, g as restoreBehaviors, h as captureBehaviors, v as createSaveStore, w as diagnose, x as resolveOrderGroups, y as ORDER_GROUP_BASE } from "./loader-D8n7TU8W.js";
+import { C as ORDER_GROUP_BASE, E as InputMap, O as Node, S as createSaveStore, T as resolveOrderGroups, V as Signal, b as restoreBehaviors, k as diagnose, y as captureBehaviors } from "./loader-D7jTvDQv.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as Rng } from "./rng-DP-SR7eg.js";
-import { l as registerNode } from "./registry-WWcQcfMr.js";
+import { l as registerNode } from "./registry-CF70EArN.js";
 //#region src/core/audio/buses.ts
 const AUDIO_LOG_LIMIT = 200;
 var AudioBuses = class {
@@ -612,6 +612,16 @@ const SFX_PRESETS = {
 	}
 };
 const SFX_PRESET_NAMES = Object.keys(SFX_PRESETS);
+/**
+* How long a preset lasts, in seconds — the same `attack + sustain + decay`
+* `synthSfx` uses to size its buffer.
+*
+* `pitch` deliberately does not enter into it: it is a frequency multiplier,
+* not a playback rate, so a preset played an octave up is the same length.
+*/
+function sfxDuration(params) {
+	return params.attack + params.sustain + params.decay;
+}
 const TWO_PI = Math.PI * 2;
 /**
 * Render a preset to mono PCM in [-1, 1]. PURE: identical inputs → identical
@@ -1369,6 +1379,14 @@ var HudLayer = class extends Node {
 * widget (an icon inside a slot), so the walk upward is the point.
 */
 const widgetOf = /* @__PURE__ */ new WeakMap();
+/** The nearest ancestor widget that actually accepts a drop. */
+function dropTargetFromElement(el) {
+	for (let n = el; n; n = n.parentElement) {
+		const found = widgetOf.get(n);
+		if (found?.dropTarget) return found;
+	}
+	return null;
+}
 function widgetFromElement(el) {
 	for (let n = el; n; n = n.parentElement) {
 		const found = widgetOf.get(n);
@@ -1378,6 +1396,8 @@ function widgetFromElement(el) {
 }
 /** The drag in flight, if any. One pointer, one drag. */
 let dragging = null;
+/** The drop target the dragged widget came OUT of — putting it back is a no-op. */
+let draggingFrom = null;
 /** Shared plumbing: mount into the parent HudLayer's anchor slot. */
 var HudWidgetBase = class extends Node {
 	/**
@@ -1495,6 +1515,7 @@ var HudWidgetBase = class extends Node {
 				event.preventDefault();
 				el.setPointerCapture?.(event.pointerId);
 				dragging = this;
+				draggingFrom = dropTargetFromElement(el.parentElement);
 				el.style.opacity = "0.6";
 				this.emit("dragStarted", this);
 			});
@@ -1502,9 +1523,12 @@ var HudWidgetBase = class extends Node {
 				if (dragging !== this) return;
 				el.style.opacity = "";
 				el.releasePointerCapture?.(event.pointerId);
-				const target = widgetFromElement(document.elementFromPoint?.(event.clientX, event.clientY) ?? null);
+				const under = document.elementFromPoint?.(event.clientX, event.clientY) ?? null;
+				const target = dropTargetFromElement(under) ?? widgetFromElement(under);
+				const origin = draggingFrom;
 				dragging = null;
-				if (target && target !== this && target.dropTarget) {
+				draggingFrom = null;
+				if (target && target !== this && target !== origin && target.dropTarget) {
 					this.emit("droppedOn", target);
 					target.emit("dropped", this);
 				} else this.emit("dragCancelled", this);
@@ -1584,6 +1608,18 @@ var HudWidgetBase = class extends Node {
 	* was empty at bake time and the English was permanent even for a game that
 	* boots in another language.
 	*/
+	/**
+	* What this widget actually PAINTS, when that differs from its props.
+	*
+	* A headless capture printed `text="@t:menu.start"` — byte-identical in
+	* every language — so a passing capture proved nothing about localization
+	* and a broken translation was invisible to every check the engine has.
+	* `incanto-frame` reads the WebGL buffer and cannot read DOM text at all.
+	*
+	* `undefined` when the painted words ARE the prop: recording it twice would
+	* be noise on every widget in a game that never localizes anything.
+	*/
+	_paintedText() {}
 	_labelText() {
 		const label = this.label;
 		return typeof label === "string" ? this._t(label) : "";
@@ -1642,6 +1678,10 @@ var UiText = class extends HudWidgetBase {
 		if (this.format && this.slot !== null) return this._t(this.format).replace("{}", this.slot);
 		return this._t(this.text);
 	}
+	_paintedText() {
+		const painted = this.shown;
+		return painted === this.text ? void 0 : painted;
+	}
 	_build() {
 		const el = document.createElement("div");
 		el.style.cssText = this.look();
@@ -1812,6 +1852,7 @@ var UiBanner = class extends HudWidgetBase {
 	show(text, opts) {
 		this.queue.push({
 			text,
+			source: text,
 			color: opts?.color ?? "#ffffff",
 			seconds: opts?.seconds ?? this.seconds
 		});
@@ -1844,6 +1885,11 @@ var UiBanner = class extends HudWidgetBase {
 			this._element.style.opacity = opacity;
 		}
 		if (this.current) {
+			const next = this._t(this.current.source);
+			if (next !== this.current.text) {
+				this.current.text = next;
+				if (this._element) this._element.textContent = next;
+			}
 			if (this.current.seconds > 0) {
 				this.remaining -= dt;
 				if (this.remaining <= 0) {
@@ -1854,7 +1900,7 @@ var UiBanner = class extends HudWidgetBase {
 		}
 		if (!this.current && this.queue.length > 0) {
 			this.current = this.queue.shift();
-			this.current.text = this._t(this.current.text);
+			this.current.text = this._t(this.current.source);
 			this.remaining = this.current.seconds;
 			if (this._element) {
 				this._element.textContent = this.current.text;
@@ -2441,6 +2487,7 @@ var Engine = class {
 		this.input.clear();
 		this._time = 0;
 		this._unscaledTime = 0;
+		this.timeScale = 1;
 		if (scene.input) this.input.declare(scene.input);
 		if (scene.strings) this.locale.load(scene.strings);
 		this.orderGroups = resolveOrderGroups(scene.orderGroups);
@@ -2722,7 +2769,7 @@ function createElement() {
 }
 /**
 * One sound. `play()` (or `autoplay: true`) starts it; `finished` fires when
-* it ends. Browsers block audio before the first user gesture — a blocked
+* it ends — for a procedural preset as well as a `src` clip. Browsers block audio before the first user gesture — a blocked
 * play marks `pendingGesture`; `createGame` retries pending players on the
 * first pointer/key gesture automatically.
 *
@@ -2779,10 +2826,12 @@ var AudioPlayer = class extends Node {
 	/** Start on the first frame in the tree (subject to the gesture policy). */
 	autoplay = false;
 	/**
-	* 3D positional audio: in a 3D scene the sound pans + attenuates by the
-	* emitter's world position relative to the active Camera3D (the listener).
-	* Default false → identical non-spatial behavior (back-compat). In a 2D scene
-	* spatial is currently ignored (the adapter feeds no pose) — see incanto-audio.
+	* Positional audio: the sound pans + attenuates by the emitter's world
+	* position relative to the active camera (the listener). Default false →
+	* identical non-spatial behavior.
+	*
+	* Both dimensions. A 2D scene measures in PIXELS, so the distances below —
+	* metre-shaped defaults — need setting there; `auditScene` says so.
 	*/
 	spatial = false;
 	/** Distance at which spatial gain is full; closer never gets louder. */
@@ -2816,6 +2865,21 @@ var AudioPlayer = class extends Node {
 	loadError = null;
 	element = null;
 	_playing = false;
+	/**
+	* `engine.unscaledTime` at which the preset currently sounding ends.
+	*
+	* A preset used to be fire-and-forget: `playing` stayed false through a sound
+	* that was audibly playing, and `finished` — a signal this node DECLARES, so
+	* a connection to it loads clean — never fired at all. Wiring "when the coin
+	* chime ends, free the pickup" to a preset player produced a wire that is
+	* dead for the life of the game and says nothing.
+	*
+	* The end is known exactly: `attack + sustain + decay` is the length
+	* `synthSfx` sizes its buffer to. Measured on the UNSCALED clock because a
+	* sound does not slow down when the game does, and a paused game still hears
+	* the tail of the hit that paused it.
+	*/
+	presetEndsAt = null;
 	autoplayed = false;
 	/** Last spatial pose pushed by the 3D adapter (null until/unless spatial). */
 	_spatialPose = null;
@@ -2918,15 +2982,18 @@ var AudioPlayer = class extends Node {
 	}
 	/**
 	* Procedural-SFX path: synthesize the preset and fire it through WebAudio
-	* (low-latency, overlap-friendly). Fire-and-forget — no `finished`/`playing`
-	* tracking (these are short one-shots, not the element-driven `src` clip).
-	* Headless (no AudioContext) → silent no-op. WebAudio also needs a gesture;
-	* a suspended context is resumed by the same unlock listener as `src` players.
+	* (low-latency, overlap-friendly). Headless (no AudioContext) plays nothing —
+	* but still reports `playing` and still emits `finished` on schedule, because
+	* the length is arithmetic, not a device. WebAudio needs a gesture; a
+	* suspended context is resumed by the same unlock listener as `src` players.
 	*/
 	playPreset() {
 		const params = SFX_PRESETS[this.preset];
 		if (!params) return;
-		const sfx = this.tree?.engine?.sfx;
+		const engine = this.tree?.engine;
+		this._playing = true;
+		this.presetEndsAt = (engine?.unscaledTime ?? 0) + sfxDuration(params);
+		const sfx = engine?.sfx;
 		if (!sfx) return;
 		sfx.play(params, this.gain(), {
 			pitch: this.pitch,
@@ -2952,6 +3019,7 @@ var AudioPlayer = class extends Node {
 			this.element.pause();
 			this.element.currentTime = 0;
 		}
+		this.presetEndsAt = null;
 		this._playing = false;
 		this.pendingGesture = false;
 	}
@@ -2964,6 +3032,13 @@ var AudioPlayer = class extends Node {
 			this.autoplayed = true;
 			this.play();
 		}
+		if (this.presetEndsAt !== null) {
+			if ((this.tree?.engine?.unscaledTime ?? 0) >= this.presetEndsAt) {
+				this.presetEndsAt = null;
+				this._playing = false;
+				this.emit("finished");
+			}
+		}
 		if (this.element && this._playing) {
 			this.element.volume = this.gain() * this.spatialElementGain();
 			this.element.loop = this.loop;
@@ -3107,10 +3182,14 @@ var UiDialogue = class extends HudWidgetBase {
 	}
 	/** Queue a line; optional `choices` renders buttons after the line types out. */
 	say(speaker, text, choices) {
-		this.queue.push({
+		const source = {
 			speaker,
 			text,
 			choices: choices ?? null
+		};
+		this.queue.push({
+			...source,
+			source
 		});
 	}
 	/**
@@ -3164,13 +3243,22 @@ var UiDialogue = class extends HudWidgetBase {
 		box.addEventListener("click", () => this.advance());
 		return box;
 	}
+	/** The locale `current` was resolved in, so a switch is one compare away. */
+	resolvedIn = "\0";
+	/** Re-read the live line from its untouched source. */
+	resolveCurrent() {
+		const line = this.current;
+		if (!line) return;
+		line.text = this._t(line.source.text);
+		line.speaker = this._t(line.source.speaker);
+		line.choices = line.source.choices ? line.source.choices.map((c) => this._t(c)) : null;
+		this.resolvedIn = this.tree?.engine?.locale.locale ?? "";
+	}
 	update(dt) {
 		super.update(dt);
 		if (!this.current && this.queue.length > 0) {
 			this.current = this.queue.shift();
-			this.current.text = this._t(this.current.text);
-			this.current.speaker = this._t(this.current.speaker);
-			if (this.current.choices) this.current.choices = this.current.choices.map((c) => this._t(c));
+			this.resolveCurrent();
 			this.revealed = this.charsPerSecond <= 0 ? this.current.text.length : 0;
 			this.emit("lineShown", this.current.text);
 			if (this._element) {
@@ -3180,6 +3268,13 @@ var UiDialogue = class extends HudWidgetBase {
 		}
 		if (this._element) this._element.style.display = this.visible && this.current ? "block" : "none";
 		if (!this.current) return;
+		if ((this.tree?.engine?.locale.locale ?? "") !== this.resolvedIn) {
+			const before = this.current.text.length;
+			const progress = before > 0 ? this.revealed / before : 1;
+			this.resolveCurrent();
+			this.revealed = Math.round(progress * this.current.text.length);
+			if (this.speakerEl) this.speakerEl.textContent = this.current.speaker;
+		}
 		const wasTyping = this.revealed < this.current.text.length;
 		if (wasTyping) this.revealed = Math.min(this.current.text.length, this.revealed + this.charsPerSecond * dt);
 		const doneTyping = this.revealed >= this.current.text.length;
@@ -3330,7 +3425,10 @@ var UiImage = class extends HudWidgetBase {
 	static typeName = "UiImage";
 	static props = {
 		...HudWidgetBase.props,
-		src: { default: "" },
+		src: {
+			default: "",
+			asset: { kind: "texture" }
+		},
 		width: { default: 48 },
 		height: { default: 48 },
 		/** How the picture fills its box — `contain` never crops. */
@@ -3943,4 +4041,4 @@ function registerCoreNodes() {
 	registerNode(UiMuteToggle);
 }
 //#endregion
-export { UiBar as A, ROLLOFF_MODELS as B, readDeviceHints as C, HudLayer as D, EffectLog as E, suggestLocale as F, synthSfx as G, spatialPan as H, translateOn as I, crossfadeGains as J, MusicManager as K, translationKey as L, BASE_LOCALE as M, Localization as N, HudWidgetBase as O, T_PREFIX as P, SfxEngine as R, qualityRendering as S, LogManager as T, SFX_PRESETS as U, spatialGain as V, SFX_PRESET_NAMES as W, AudioBuses as X, fadeGain as Y, Engine as _, UiMuteToggle as a, qualityCaps as b, UiRenderScaleSelect as c, UiToggle as d, UiVolumeSlider as f, AudioPlayer as g, UiDialogue as h, UiLanguageSelect as i, UiText as j, UiBanner as k, UiSelect as l, UiButton as m, UiFrameCapSelect as n, UiPanel as o, Timer as p, WebAudioMusicBackend as q, UiImage as r, UiQualitySelect as s, registerCoreNodes as t, UiSlider as u, engine_exports as v, suggestQuality as w, qualityEnvironment as x, Settings as y, isAudioContextAvailable as z };
+export { UiBar as A, ROLLOFF_MODELS as B, readDeviceHints as C, HudLayer as D, EffectLog as E, suggestLocale as F, sfxDuration as G, spatialPan as H, translateOn as I, WebAudioMusicBackend as J, synthSfx as K, translationKey as L, BASE_LOCALE as M, Localization as N, HudWidgetBase as O, T_PREFIX as P, SfxEngine as R, qualityRendering as S, LogManager as T, SFX_PRESETS as U, spatialGain as V, SFX_PRESET_NAMES as W, fadeGain as X, crossfadeGains as Y, AudioBuses as Z, Engine as _, UiMuteToggle as a, qualityCaps as b, UiRenderScaleSelect as c, UiToggle as d, UiVolumeSlider as f, AudioPlayer as g, UiDialogue as h, UiLanguageSelect as i, UiText as j, UiBanner as k, UiSelect as l, UiButton as m, UiFrameCapSelect as n, UiPanel as o, Timer as p, MusicManager as q, UiImage as r, UiQualitySelect as s, registerCoreNodes as t, UiSlider as u, engine_exports as v, suggestQuality as w, qualityEnvironment as x, Settings as y, isAudioContextAvailable as z };

package/dist/{registry-WWcQcfMr.js → registry-CF70EArN.js}

@@ -1,5 +1,35 @@
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { r as jsonKind, t as jsonClone } from "./json-CwwhxQgb.js";
+//#region src/core/prop-range.ts
+function describe(range) {
+	const { min, max, exclusiveMin, allow } = range;
+	let body;
+	if (min !== void 0 && max !== void 0) body = `${min}..${max}`;
+	else if (min !== void 0) body = exclusiveMin ? `greater than ${min}` : `at least ${min}`;
+	else if (max !== void 0) body = `at most ${max}`;
+	else body = "a finite number";
+	return allow && allow.length > 0 ? `${body} (or ${allow.join(", ")})` : body;
+}
+/**
+* Throws `PROP_TYPE_MISMATCH` when a number falls outside its documented range.
+*
+* A non-number is ignored: the kind check has already run and reporting the
+* same value twice, under two codes, tells its reader nothing new.
+*
+* @param value the authored value
+* @param label `Type.prop`, for the message
+* @param range what the prop documents
+*/
+function validatePropRange(value, label, range) {
+	if (typeof value !== "number") return;
+	if (range.allow?.includes(value)) return;
+	if (!Number.isFinite(value)) throw new IncantoError("PROP_TYPE_MISMATCH", `Prop '${label}' must be a finite number, got ${value}.`, { prop: label });
+	const belowMin = range.min !== void 0 && (range.exclusiveMin ? value <= range.min : value < range.min);
+	const aboveMax = range.max !== void 0 && value > range.max;
+	if (!belowMin && !aboveMax) return;
+	throw new IncantoError("PROP_TYPE_MISMATCH", `Prop '${label}' must be ${describe(range)}, got ${value}.`, { prop: label });
+}
+//#endregion
 //#region src/core/registry.ts
 /**
 * Validate a prop value against its schema default:
@@ -120,7 +150,10 @@ function mergeStaticAliases(ctor) {
 */
 function applySchemaProps(target, schema, props, label, aliases = {}, extraOptions = {}) {
 	for (const [key, def] of Object.entries(schema)) target[key] = jsonClone(def.default);
-	if (!props) return;
+	if (props) applyGivenProps(target, schema, props, label, aliases, extraOptions);
+	requireNonEmpty(target, schema, label);
+}
+function applyGivenProps(target, schema, props, label, aliases, extraOptions) {
 	for (const [rawKey, value] of Object.entries(props)) {
 		const key = schema[rawKey] ? rawKey : aliases[rawKey] ?? rawKey;
 		const def = schema[key];
@@ -135,18 +168,37 @@ function applySchemaProps(target, schema, props, label, aliases = {}, extraOptio
 		const extra = extraOptions[key];
 		const options = def.options && extra && extra.length > 0 ? [...def.options, ...extra] : def.options;
 		validatePropValue(value, def.default, `${label}.${key}`, options);
+		if (def.range) validatePropRange(value, `${label}.${key}`, def.range);
 		target[key] = jsonClone(value);
 	}
+}
+function requireNonEmpty(target, schema, label) {
 	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.`, {
+		if (!isEmptyValue(target[key])) continue;
+		throw new IncantoError("PROP_TYPE_MISMATCH", `'${label}' needs a "${key}" — it is empty.`, {
 			prop: key,
 			nodeType: label
 		});
 	}
 }
 /**
+* "Not a configuration" — what `required` refuses.
+*
+* The first cut only knew about `''`, which is what the two props that
+* introduced the flag hold. Three of the ones declared since default to an
+* ARRAY — `MoveTo.to`, `Patrol.points`, `WaveSpawner.waves` — and for those the
+* flag was inert: a `MoveTo` with no `to` loaded clean and moved nowhere, which
+* is exactly the failure the flag was added to stop. Found by running the
+* shipped package as a consumer instead of trusting the declaration.
+*/
+function isEmptyValue(value) {
+	if (value === "" || value === void 0 || value === null) return true;
+	if (Array.isArray(value)) return value.length === 0;
+	if (typeof value === "object") return Object.keys(value).length === 0;
+	return false;
+}
+/**
 * Instantiate a registered type, assign schema defaults (cloned), then the
 * given props — validating every key and its JSON kind against the default.
 */

package/dist/{replay-O-yAGM76.d.ts → replay-C5x2vPF5.d.ts}

@@ -1,9 +1,22 @@
-import { b as Engine } from "./behavior-DWKTUzKI.js";
+import { b as Engine } from "./behavior-DsgayMsH.js";
 import { s as JsonObject } from "./schema-CFeioQRE.js";
 
 //#region src/core/audit.d.ts
 /** Human-readable warnings (empty = clean). Pure JSON walk, no registry. */
-declare function auditScene(scene: JsonObject): string[];
+interface AuditOptions {
+  /**
+  * Every locale table the whole PROJECT declares, unioned.
+  *
+  * Localization tables MERGE across scenes — a game's shared UI strings live
+  * in the scene it boots from, and a level that adds three lines of its own
+  * does not wipe them. Auditing one file in isolation therefore reported a key
+  * declared in the boot scene as "nothing declares" it, and told its author to
+  * add a string they already have. The checker passes the corpus in when it
+  * has one.
+  */
+  declaredElsewhere?: Record<string, Record<string, string>>;
+}
+declare function auditScene(scene: JsonObject, opts?: AuditOptions): string[];
 //#endregion
 //#region src/core/errors.d.ts
 /**
@@ -12,7 +25,7 @@ declare function auditScene(scene: JsonObject): string[];
 * Incanto fails loudly with machine-readable codes and messages that list valid
 * alternatives — AI agents self-correct on hard failures, not warnings.
 */
-type IncantoErrorCode = "BAD_FORMAT" | "BAD_NODE_PATH" | "DANGLING_CONNECTION" | "DUPLICATE_BEHAVIOR" | "DUPLICATE_NODE_TYPE" | "DUPLICATE_UNIQUE_NAME" | "DUPLICATE_UID" | "NODE_NOT_FOUND" | "PROP_TYPE_MISMATCH" | "TREE_VIOLATION" | "UNKNOWN_ANIMATION" | "UNKNOWN_ASSET" | "UNKNOWN_CONSTANT" | "UNKNOWN_BEHAVIOR" | "UNKNOWN_HANDLER" | "UNKNOWN_NODE_TYPE" | "UNKNOWN_PROP" | "UNKNOWN_SIGNAL" | "UNRESOLVED_INSTANCE";
+type IncantoErrorCode = "AMBIGUOUS_HANDLER" | "BAD_FORMAT" | "BAD_NODE_PATH" | "DANGLING_CONNECTION" | "DUPLICATE_BEHAVIOR" | "DUPLICATE_NODE_TYPE" | "DUPLICATE_UNIQUE_NAME" | "DUPLICATE_UID" | "NODE_NOT_FOUND" | "PROP_TYPE_MISMATCH" | "TREE_VIOLATION" | "UNKNOWN_ANIMATION" | "UNKNOWN_ASSET" | "UNKNOWN_CONSTANT" | "UNKNOWN_BEHAVIOR" | "UNKNOWN_HANDLER" | "UNKNOWN_NODE_TYPE" | "UNKNOWN_PROP" | "UNKNOWN_SIGNAL" | "UNRESOLVED_INSTANCE";
 /**
 * Structured context mirrored from the prose message — tools and agents parse
 * THESE instead of regexing the message (which is for humans and may reword).