incanto 0.65.0 → 0.67.0

package/dist/index.d.ts

@@ -1,10 +1,10 @@
-import { $ as T_PREFIX, A as SettingsValues, At as BusName, B as captureBehaviors, C as EngineStats, Ct as sfxDuration, Dt as MusicTrack, E as DeviceHints, Et as MusicManager, F as BehaviorState, Ft as LogLevel, G as ORDER_GROUP_BASE, H as savesWithoutUid, I as RestoreReport, It as LogManager, J as effectiveOrder, K as OrderGroup, L as SaveSlot, Lt as Signal, M as readDeviceHints, Mt as NodeLifecycle, N as suggestQuality, Nt as SceneTree, O as QualityTier, Ot as PlayMusicOptions, P as Scene, Pt as LogEntry, Q as Localization, R as SaveSlots, Rt as SignalListener, S as Scheduler, St as SynthOptions, T as RendererStats, Tt as MusicBackend, U as SaveStore, V as restoreBehaviors, W as createSaveStore, X as BASE_LOCALE, Y as resolveOrderGroups, Z as LocaleTables, _ as mergeStaticSignals, _t as spatialPan, a as clearBehaviors, at as EffectLog, b as Engine, bt as SfxParams, c as registeredBehaviors, ct as isAudioContextAvailable, d as PropSchema, dt as Listener, et as suggestLocale, f as clearRegistry, ft as ROLLOFF_MODELS, g as getNodeType, gt as spatialGain, h as getNodeSignals, ht as Vec3, i as behaviorSignals, it as EffectKind, j as qualityEnvironment, jt as Node, k as Settings, kt as AudioBuses, l as NodeCtor, lt as Voice, m as getNodeSchema, mt as SpatialParams, n as BehaviorCtor, nt as InputMap, o as getBehavior, ot as SfxEngine, p as createNode, pt as RolloffModel, q as OrderGroupTable, r as behaviorSchema, rt as EffectEvent, s as registerBehavior, st as SfxPlayOptions, t as Behavior, tt as translationKey, u as PropDef, ut as VoicePreset, v as registerNode, vt as SFX_PRESETS, w as GameStats, wt as synthSfx, x as EngineOptions, xt as SfxWave, y as registeredTypes, yt as SFX_PRESET_NAMES, z as behaviorsWithoutSave } from "./behavior-CmMuQ6CL.js";
+import { $ as T_PREFIX, A as SettingsValues, At as BusName, B as captureBehaviors, C as EngineStats, Ct as sfxDuration, Dt as MusicTrack, E as DeviceHints, Et as MusicManager, F as BehaviorState, Ft as LogLevel, G as ORDER_GROUP_BASE, H as savesWithoutUid, I as RestoreReport, It as LogManager, J as effectiveOrder, K as OrderGroup, L as SaveSlot, Lt as Signal, M as readDeviceHints, Mt as NodeLifecycle, N as suggestQuality, Nt as SceneTree, O as QualityTier, Ot as PlayMusicOptions, P as Scene, Pt as LogEntry, Q as Localization, R as SaveSlots, Rt as SignalListener, S as Scheduler, St as SynthOptions, T as RendererStats, Tt as MusicBackend, U as SaveStore, V as restoreBehaviors, W as createSaveStore, X as BASE_LOCALE, Y as resolveOrderGroups, Z as LocaleTables, _ as mergeStaticSignals, _t as spatialPan, a as clearBehaviors, at as EffectLog, b as Engine, bt as SfxParams, c as registeredBehaviors, ct as isAudioContextAvailable, d as PropSchema, dt as Listener, et as suggestLocale, f as clearRegistry, ft as ROLLOFF_MODELS, g as getNodeType, gt as spatialGain, h as getNodeSignals, ht as Vec3, i as behaviorSignals, it as EffectKind, j as qualityEnvironment, jt as Node, k as Settings, kt as AudioBuses, l as NodeCtor, lt as Voice, m as getNodeSchema, mt as SpatialParams, n as BehaviorCtor, nt as InputMap, o as getBehavior, ot as SfxEngine, p as createNode, pt as RolloffModel, q as OrderGroupTable, r as behaviorSchema, rt as EffectEvent, s as registerBehavior, st as SfxPlayOptions, t as Behavior, tt as translationKey, u as PropDef, ut as VoicePreset, v as registerNode, vt as SFX_PRESETS, w as GameStats, wt as synthSfx, x as EngineOptions, xt as SfxWave, y as registeredTypes, yt as SFX_PRESET_NAMES, z as behaviorsWithoutSave } from "./behavior-ZnfzKDo3.js";
 import { a as Rng, c as JsonValue, d as jsonKind, i as SceneJson, l as jsonClone, n as NodeJson, o as JsonKind, r as SCENE_FORMAT, s as JsonObject, t as ConnectionJson, u as jsonEquals } from "./schema-CFeioQRE.js";
-import { n as loadScene, t as LoadSceneOptions } from "./loader-CTB441z4.js";
+import { n as loadScene, t as LoadSceneOptions } from "./loader-DyT30ArB.js";
 import { i as resolveFrames, n as AnimationEntry, r as resolveAnimation, t as AnimationDef } from "./sprite-animation-CMr6f1K2.js";
-import { a as ParticleSimConfig, i as ParticleSim, n as AudioPlayer, o as ParticleView, t as AudioElementLike } from "./audio-player-BrEHwbK1.js";
+import { a as ParticleSimConfig, i as ParticleSim, n as AudioPlayer, o as ParticleView, t as AudioElementLike } from "./audio-player-BNUHo0JF.js";
 import { i as gridFromRows, n as PathGrid, r as findPath, t as FindPathOptions } from "./pathfinding-_fGrCFmH.js";
-import { a as startRecording, c as IncantoErrorDetails, i as replay, l as auditScene, n as ReplayEvent, o as IncantoError, r as ReplayJson, s as IncantoErrorCode, t as Recorder } from "./replay-CThvwkcQ.js";
+import { a as startRecording, c as IncantoErrorDetails, i as replay, l as auditScene, n as ReplayEvent, o as IncantoError, r as ReplayJson, s as IncantoErrorCode, t as Recorder } from "./replay-D0GcEHYU.js";
 
 //#region src/core/audio/crossfade.d.ts
 /**
@@ -313,8 +313,24 @@ declare class HudLayer extends Node {
   * play resumes.
   */
   private stepFocus;
-  /** Focusable widgets under this layer, in tree order. */
-  private focusables;
+  /**
+  * Focusable widgets under this layer, in tree order — **on screen only**.
+  *
+  * This filtered on each widget's OWN `visible` and recursed into hidden
+  * containers anyway, so arrow-keys walked into closed panels and Enter really
+  * pressed what it found. Measured on a title screen: 23 focus stops, 21 of
+  * them under an ancestor with `visible = false`, and
+  *
+  *   gold before = 150 -> Enter on the hidden Shop/Row0/Buy -> gold 120,
+  *   screen still 'title'
+  *
+  * The layer's own visibility was not a gate either. It is now: a HUD nobody
+  * can see has no ring, and a subtree nobody can see is not walked.
+  *
+  * PUBLIC, because a game that wants to know what its ring contains could not
+  * ask — and "why is focus on that" is exactly the question this answers.
+  */
+  focusables(): HudWidgetBase[];
   /** Move focus to a widget by hand — opening a menu should start somewhere. */
   focus(widget: HudWidgetBase | null): void;
   /** @internal Widgets mount into per-anchor flex columns. */
@@ -377,6 +393,11 @@ declare abstract class HudWidgetBase extends Node {
   private host;
   override onExitTree(): void;
   override update(_dt: number): void;
+  /**
+  * The display this widget's own css asks for while shown — `grid` for a grid
+  * panel, `flex` for a row, `''` for a widget that never says.
+  */
+  private _shownDisplay;
   /** Which anchor slot this widget was mounted into. */
   private mountedAnchor;
   /**
@@ -607,6 +628,29 @@ declare class UiDialogue extends HudWidgetBase {
   /** Queue a line; optional `choices` renders buttons after the line types out. */
   say(speaker: string, text: string, choices?: string[]): void;
   /**
+  * A dialogue takes focus while it is up.
+  *
+  * It paints a focus ring and the generated reference advertises the prop, and
+  * it was inert: choices are raw DOM buttons inside the widget, so
+  * `HudLayer.focusables()` can never see them, and this class — unlike
+  * `UiButton` a hundred lines above it — never overrode `_activate`. Eleven
+  * keys and eight pad codes did nothing to a waiting choice while the same
+  * Enter pressed a sibling button. Native Tab worked, and is closed by any
+  * game that binds Tab; a pad has no Tab at all.
+  */
+  override focusable: boolean;
+  /** Which choice the keyboard/pad is on. Reset by every new line. */
+  private cursor;
+  /**
+  * Enter / A, and left / right between the options.
+  *
+  * `dir` is 0 for "activate" and ±1 for a nudge, the same shape `UiSelect`
+  * uses — so one key layout drives a menu, a slider and a conversation.
+  */
+  override _activate(dir: number): void;
+  /** Show which option the keyboard is on — a ring nobody can see is not one. */
+  private paintCursor;
+  /**
   * Player pressed "next": mid-typing reveals the whole line; a fully-typed
   * line without choices advances (choice lines wait for `choose`).
   */

package/dist/index.js

@@ -1,13 +1,14 @@
-import { A as describeRefProblem, B as registeredBehaviors, C as ORDER_GROUP_BASE, E as InputMap, F as behaviorSchema, I as behaviorSignals, L as clearBehaviors, M as resolveRefInJson, N as parseNodePath, O as Node, P as Behavior, R as getBehavior, S as createSaveStore, T as resolveOrderGroups, V as Signal, _ as SaveSlots, a as serializeNode, b as restoreBehaviors, d as computeViewport, f as resolveViewport, g as resolveConstants, h as isConstRef, i as Scene, j as nodeRefWarnings, m as CONST_REF_KEY, n as loadScene, o as SCENE_FORMAT, p as SceneTree, v as behaviorsWithoutSave, w as effectiveOrder, x as savesWithoutUid, y as captureBehaviors, z as registerBehavior } from "./loader-lQDCwNag.js";
-import { A as UiBanner, B as isAudioContextAvailable, D as EffectLog, E as LogManager, F as T_PREFIX, G as SFX_PRESET_NAMES, H as spatialGain, I as suggestLocale, J as MusicManager, K as sfxDuration, M as UiText, N as BASE_LOCALE, O as HudLayer, P as Localization, Q as AudioBuses, R as translationKey, S as qualityEnvironment, T as suggestQuality, U as spatialPan, V as ROLLOFF_MODELS, W as SFX_PRESETS, X as crossfadeGains, Y as WebAudioMusicBackend, Z as fadeGain, _ as AudioPlayer, a as UiMuteToggle, b as Settings, c as UiRenderScaleSelect, d as UiToggle, f as UiVolumeSlider, g as UiDialogue, h as UiButton, i as UiLanguageSelect, j as UiBar, l as UiSelect, m as Respawn, n as UiFrameCapSelect, o as UiPanel, p as Timer, q as synthSfx, r as UiImage, s as UiQualitySelect, t as registerCoreNodes, u as UiSlider, v as Engine, w as readDeviceHints, z as SfxEngine } from "./register-CgeR4ckF.js";
+import { A as describeRefProblem, B as registeredBehaviors, C as ORDER_GROUP_BASE, E as InputMap, F as behaviorSchema, I as behaviorSignals, L as clearBehaviors, M as resolveRefInJson, N as parseNodePath, O as Node, P as Behavior, R as getBehavior, S as createSaveStore, T as resolveOrderGroups, V as Signal, _ as SaveSlots, a as serializeNode, b as restoreBehaviors, d as computeViewport, f as resolveViewport, g as resolveConstants, h as isConstRef, i as Scene, j as nodeRefWarnings, m as CONST_REF_KEY, n as loadScene, o as SCENE_FORMAT, p as SceneTree, v as behaviorsWithoutSave, w as effectiveOrder, x as savesWithoutUid, y as captureBehaviors, z as registerBehavior } from "./loader-KZESOZmE.js";
+import { A as UiBanner, B as isAudioContextAvailable, D as EffectLog, E as LogManager, F as T_PREFIX, G as SFX_PRESET_NAMES, H as spatialGain, I as suggestLocale, J as MusicManager, K as sfxDuration, M as UiText, N as BASE_LOCALE, O as HudLayer, P as Localization, Q as AudioBuses, R as translationKey, S as qualityEnvironment, T as suggestQuality, U as spatialPan, V as ROLLOFF_MODELS, W as SFX_PRESETS, X as crossfadeGains, Y as WebAudioMusicBackend, Z as fadeGain, _ as AudioPlayer, a as UiMuteToggle, b as Settings, c as UiRenderScaleSelect, d as UiToggle, f as UiVolumeSlider, g as UiDialogue, h as UiButton, i as UiLanguageSelect, j as UiBar, l as UiSelect, m as Respawn, n as UiFrameCapSelect, o as UiPanel, p as Timer, q as synthSfx, r as UiImage, s as UiQualitySelect, t as registerCoreNodes, u as UiSlider, v as Engine, w as readDeviceHints, z as SfxEngine } from "./register-Cs53CY7s.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as Rng } from "./rng-DP-SR7eg.js";
 import { n as jsonEquals, r as jsonKind, t as jsonClone } from "./json-CwwhxQgb.js";
 import { a as getNodeSignals, c as mergeStaticSignals, i as getNodeSchema, l as registerNode, n as clearRegistry, o as getNodeType, r as createNode, u as registeredTypes } from "./registry-CF70EArN.js";
-import { n as startRecording, r as auditScene, t as replay } from "./replay-CEw2xAhG.js";
-import { a as logReport, i as resolveRendering, n as attachTouchControls, o as logText, r as joystickVector, s as parseDrive, t as TouchControls } from "./touch-DESwnpOc.js";
+import { i as joystickVector, n as attachTouchControls, t as TouchControls } from "./touch-DEAmqGdf.js";
+import { n as startRecording, r as auditScene, t as replay } from "./replay-BkpDV51O.js";
+import { i as parseDrive, n as logReport, r as logText, t as resolveRendering } from "./rendering-options-ByAdi8PF.js";
 import { t as createNoise2D } from "./noise-CGUMx44x.js";
 import { a as PARTICLE_PRESETS, i as ParticleSim, n as resolveFrames, o as PARTICLE_PRESET_NAMES, s as applyParticlePreset, t as resolveAnimation } from "./sprite-animation-CY-mrr1L.js";
-import { a as preloadUrls, i as preloadSceneAssets, n as newUid, o as findPath, r as assetUrls, s as gridFromRows, t as VERSION } from "./src-DYffzHbd.js";
-import { t as duplicateNode } from "./duplicate-CqSAtdrh.js";
+import { a as preloadUrls, i as preloadSceneAssets, n as newUid, o as findPath, r as assetUrls, s as gridFromRows, t as VERSION } from "./src-BLlsGJW9.js";
+import { t as duplicateNode } from "./duplicate-B8QnX2-r.js";
 export { AudioBuses, AudioPlayer, BASE_LOCALE, Behavior, CONST_REF_KEY, EffectLog, Engine, HudLayer, IncantoError, InputMap, Localization, LogManager, MusicManager, Node, ORDER_GROUP_BASE, PARTICLE_PRESETS, PARTICLE_PRESET_NAMES, ParticleSim, ROLLOFF_MODELS, Respawn, Rng, SCENE_FORMAT, SFX_PRESETS, SFX_PRESET_NAMES, SaveSlots, Scene, SceneTree, Settings, SfxEngine, Signal, T_PREFIX, Timer, TouchControls, UiBanner, UiBar, UiButton, UiDialogue, UiFrameCapSelect, UiImage, UiLanguageSelect, UiMuteToggle, UiPanel, UiQualitySelect, UiRenderScaleSelect, UiSelect, UiSlider, UiText, UiToggle, UiVolumeSlider, VERSION, WebAudioMusicBackend, applyParticlePreset, assetUrls, attachTouchControls, auditScene, behaviorSchema, behaviorSignals, behaviorsWithoutSave, captureBehaviors, clearBehaviors, clearRegistry, computeViewport, createNode, createNoise2D, createSaveStore, crossfadeGains, describeRefProblem, duplicateNode, effectiveOrder, fadeGain, findPath, getBehavior, getNodeSchema, getNodeSignals, getNodeType, gridFromRows, isAudioContextAvailable, isConstRef, joystickVector, jsonClone, jsonEquals, jsonKind, loadScene, logReport, logText, mergeStaticSignals, newUid, nodeRefWarnings, parseDrive, parseNodePath, preloadSceneAssets, preloadUrls, qualityEnvironment, readDeviceHints, registerBehavior, registerCoreNodes, registerNode, registeredBehaviors, registeredTypes, replay, resolveAnimation, resolveConstants, resolveFrames, resolveOrderGroups, resolveRefInJson, resolveRendering, resolveViewport, restoreBehaviors, savesWithoutUid, serializeNode, sfxDuration, spatialGain, spatialPan, startRecording, suggestLocale, suggestQuality, synthSfx, translationKey };

package/dist/{loader-CTB441z4.d.ts → loader-DyT30ArB.d.ts}

@@ -1,4 +1,4 @@
-import { P as Scene, b as Engine } from "./behavior-CmMuQ6CL.js";
+import { P as Scene, b as Engine } from "./behavior-ZnfzKDo3.js";
 import { i as SceneJson } from "./schema-CFeioQRE.js";
 
 //#region src/core/scene/loader.d.ts

package/dist/{loader-lQDCwNag.js → loader-KZESOZmE.js}

@@ -20,6 +20,17 @@ var Signal = class {
 	disconnectAll() {
 		this.connections.length = 0;
 	}
+	/**
+	* How many listeners are attached.
+	*
+	* A leak is a SLOPE, and a game had no way to see one: every check in this
+	* engine is a snapshot. A handler connected per frame and never disconnected,
+	* or a `once` that armed and never fired, accumulates invisibly and is
+	* perfectly healthy for the first thirty seconds of every playthrough.
+	*/
+	get count() {
+		return this.connections.length;
+	}
 	emit(...args) {
 		const snapshot = [...this.connections];
 		for (const conn of snapshot) {
@@ -652,6 +663,16 @@ var Node = class {
 	off(signal, fn) {
 		this._signals.get(signal)?.disconnect(fn);
 	}
+	/**
+	* How many listeners this node has on `signal` — 0 for one nobody watches.
+	*
+	* The engine's own leak test reads it, and so can a game: a handler connected
+	* every frame and never disconnected is invisible to every other check here,
+	* because every other check is a snapshot and a leak is a slope.
+	*/
+	listenerCount(signal) {
+		return this._signals.get(signal)?.count ?? 0;
+	}
 	emit(signal, ...args) {
 		this.assertDeclared(signal);
 		this._signals.get(signal)?.emit(...args);
@@ -1674,6 +1695,7 @@ const FREED_KEY = "#freed";
 function captureBehaviors(root, source) {
 	const state = {};
 	const unaddressable = [];
+	const unrecordable = [];
 	let saveable = 0;
 	const walk = (node) => {
 		const behavior = node.behavior;
@@ -1698,12 +1720,45 @@ function captureBehaviors(root, source) {
 		mark(root);
 		const freed = authoredUids(source).filter((uid) => !alive.has(uid));
 		if (freed.length > 0) state[FREED_KEY] = freed;
+		unrecordable.push(...goneWithoutUid(source, root));
 	}
 	return {
 		state,
 		unaddressable,
-		saveable
+		saveable,
+		unrecordable
+	};
+}
+/**
+* Authored nodes this run CONSUMED that the ledger cannot record.
+*
+* `#freed` is authored uids minus alive uids, so a node with no uid can never
+* enter it — it is silently omitted, and on load it comes back. Every collected
+* coin in a scene without uids returns, while the score that counted it does
+* not, and nothing says a word.
+*
+* A uid is the only stable handle (it survives a rename and a reparent), so the
+* engine must not guess a replacement — a saved PATH would point at whatever
+* node moved into that slot after the next edit. What it can do is notice, by
+* walking the authored tree and asking the live one whether each node is still
+* there. Reported, not repaired.
+*/
+function goneWithoutUid(source, root) {
+	const out = [];
+	const walk = (node, path) => {
+		if (typeof node !== "object" || node === null) return;
+		const n = node;
+		const name = typeof n.name === "string" ? n.name : "";
+		const here = path === "" ? name : `${path}/${name}`;
+		if (!(typeof n.uid === "string" && n.uid !== "") && here !== "" && path !== "") {
+			const live = root.getNodeOrNull(here.slice(here.indexOf("/") + 1));
+			const leaving = live ? live.tree?._isQueuedFree(live) ?? false : false;
+			if (!live || leaving) out.push(here);
+		}
+		if (Array.isArray(n.children)) for (const child of n.children) walk(child, here);
 	};
+	walk(source.root, "");
+	return out;
 }
 /** Every uid the scene FILE declares, in document order. */
 function authoredUids(source) {
@@ -3004,6 +3059,7 @@ function buildNodeJson(json, opts) {
 	return buildNode(json, opts, [], "", void 0);
 }
 function validateHeader(json) {
+	rejectUnknownKeys(json, SCENE_KEYS, "the scene", "");
 	if (json.format !== 1) throw new IncantoError("BAD_FORMAT", `Unsupported scene format ${JSON.stringify(json.format)}; this engine reads format 1.`);
 	if (json.type !== "scene") throw new IncantoError("BAD_FORMAT", `Expected "type": "scene", got ${JSON.stringify(json.type)}.`);
 	if (typeof json.name !== "string" || json.name === "") throw new IncantoError("BAD_FORMAT", "Scene \"name\" must be a non-empty string.");
@@ -3042,9 +3098,100 @@ function withNodeContext(e, path, nj) {
 	});
 	return e;
 }
+/**
+* Every key a node object may carry.
+*
+* The node object was an OPEN dictionary sitting between a dozen closed ones —
+* `props`, `environment`, `material`, `network` and the environment's own
+* sub-blocks all reject an unknown key with a did-you-mean. A node accepted
+* anything, and the one that costs an author a day is `connections`:
+*
+* ```jsonc
+* { "name": "Room", "type": "Node3D",
+*   "connections": [ … ],        // <- silently nothing
+*   "children": [ … ] }
+* ```
+*
+* `wireConnections` is reached from the scene header and from a sub-scene's own
+* header, and NOTHING reads `nodeJson.connections`. Measured on two scenes
+* differing only in which brace the same wire sits inside:
+*
+* ```
+* inside   Dst.n=0   validateScene.ok=true   auditWarnings=0
+* beside   Dst.n=1   validateScene.ok=true   auditWarnings=0
+* none     Dst.n=0   validateScene.ok=true   auditWarnings=0
+* ```
+*
+* The misplaced wire is bit-for-bit indistinguishable from deleting it. A
+* builder moved 28 of them into `root`, got `1/1 scene(s) valid` with zero
+* warnings, and found out sixty seconds later from `incanto-playtest`.
+*/
+const NODE_KEYS = [
+	"name",
+	"uid",
+	"type",
+	"instance",
+	"overrides",
+	"groups",
+	"tags",
+	"props",
+	"script",
+	"network",
+	"children"
+];
+/** Every key the scene HEADER may carry — closed for the same reason. */
+const SCENE_KEYS = [
+	"format",
+	"type",
+	"name",
+	"dimension",
+	"viewport",
+	"assets",
+	"constants",
+	"orderGroups",
+	"input",
+	"multiplayer",
+	"environment",
+	"strings",
+	"physics",
+	"root",
+	"connections"
+];
+/** Closest known key by edit distance — only a genuinely близкая one. */
+function nearestKey(key, known) {
+	const lower = key.toLowerCase();
+	let best = null;
+	let bestScore = 3;
+	for (const candidate of known) {
+		let d = 0;
+		const a = lower;
+		const b = candidate.toLowerCase();
+		const rows = Array.from({ length: a.length + 1 }, (_, i) => [i, ...Array(b.length).fill(0)]);
+		for (let j = 0; j <= b.length; j++) rows[0][j] = j;
+		for (let i = 1; i <= a.length; i++) for (let j = 1; j <= b.length; j++) {
+			const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+			rows[i][j] = Math.min(rows[i - 1][j] + 1, rows[i][j - 1] + 1, rows[i - 1][j - 1] + cost);
+		}
+		d = rows[a.length][b.length];
+		if (d < bestScore) {
+			bestScore = d;
+			best = candidate;
+		}
+	}
+	return best;
+}
+/** Reject a key the shape does not have, the way `props` already does. */
+function rejectUnknownKeys(obj, known, what, where) {
+	for (const key of Object.keys(obj)) {
+		if (known.includes(key)) continue;
+		const guess = nearestKey(key, known);
+		throw new IncantoError("BAD_FORMAT", `Unknown key "${key}" on ${what}${where ? ` '${where}'` : ""}.` + (guess ? ` Did you mean "${guess}"?` : "") + ` Valid keys: [${known.join(", ")}].` + (key === "connections" ? " Connections live on the SCENE, beside \"root\" — a node cannot carry them, and one placed here does exactly nothing." : ""), { validOptions: [...known] });
+	}
+}
 function buildNode(nj, opts, stack, parentPath, constants, bands = []) {
 	const path = `${parentPath}/${nj.name}`;
 	try {
+		rejectUnknownKeys(nj, NODE_KEYS, "node", nj.name ?? "");
 		if (nj.instance !== void 0 && nj.type !== void 0) throw new IncantoError("BAD_FORMAT", `Node '${nj.name}' declares both "type" and "instance" — they are mutually exclusive.`);
 		if (nj.instance !== void 0) return buildInstance(nj, opts, stack, path, constants, bands);
 		if (nj.type === void 0) throw new IncantoError("BAD_FORMAT", `Node '${nj.name}' must declare either "type" or "instance".`);

package/dist/net.d.ts

@@ -1,5 +1,5 @@
-import { d as PropSchema, jt as Node } from "./behavior-CmMuQ6CL.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-DxZzC1nm.js";
+import { d as PropSchema, jt as Node } from "./behavior-ZnfzKDo3.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-DD5eYIgW.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-gb0c3xdb.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-DS8RaUV_.js";
 export { LocalGameServer, LocalGameServerTransport, LoopbackHub, LoopbackTransport, NetworkManager, NetworkSpawner, applySyncPatch, createAgent8Server, createLocalGameServer, createSplitScreen, registerNodesNet };

package/dist/{physics-2d-CmnunaR2.js → physics-2d-_B6zj3zU.js}

@@ -1,9 +1,9 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { k as diagnose } from "./loader-lQDCwNag.js";
+import { k as diagnose } from "./loader-KZESOZmE.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-DO5_Qp0Q.js";
+import { _ as RigidBody2D, b as validateCollider2D, g as PhysicsBody2D, h as CharacterBody2D, m as Area2D, p as Joint2D, y as Node2D } from "./register-vIxU3Xbv.js";
 import { n as registerDebugSource } from "./debug-draw-BM3DsvtT.js";
-import { t as withoutRapierInitNoise } from "./quiet-rapier-BAJ4K94N.js";
+import { n as jointContacts, t as withoutRapierInitNoise } from "./quiet-rapier-C6fW4zcW.js";
 //#region src/2d/physics/physics-2d.ts
 var physics_2d_exports = /* @__PURE__ */ __exportAll({
 	Physics2D: () => Physics2D,
@@ -66,6 +66,7 @@ var Physics2D = class {
 		this.unregisterDebug = registerDebugSource(this);
 		this.disconnect = engine.fixedUpdated.connect((dt) => this.step(dt));
 		this.disconnectScene = engine.sceneChanged.connect(() => {
+			this.pruneOverlaps();
 			if (engine.scene) this.syncBodies();
 		});
 		engine.physics = this;
@@ -119,6 +120,8 @@ var Physics2D = class {
 			const b = this.byColliderHandle.get(h2);
 			if (!a || !b) return;
 			const sig = started ? "triggerEnter" : "triggerExit";
+			this.trackOverlap(a, b, started);
+			this.trackOverlap(b, a, started);
 			try {
 				a.emit(sig, b);
 				b.emit(sig, a);
@@ -284,9 +287,58 @@ var Physics2D = class {
 			else if (joint.type === "rope") data = R.JointData.rope(length, a1, a2);
 			else if (joint.type === "spring") data = R.JointData.spring(length, joint.stiffness, joint.damping, a1, a2);
 			else data = R.JointData.revolute(a1, a2);
-			this.joints.set(joint, this.world.createImpulseJoint(data, ea.body, eb.body, true));
+			const made = this.world.createImpulseJoint(data, ea.body, eb.body, true);
+			made.setContactsEnabled(jointContacts(joint.type, joint.collide));
+			this.joints.set(joint, made);
 		}
 	}
+	/** Who is currently inside each sensor/body, maintained from the event drain. */
+	overlaps = /* @__PURE__ */ new Map();
+	trackOverlap(self, other, started) {
+		let set = this.overlaps.get(self);
+		if (started) {
+			if (!set) {
+				set = /* @__PURE__ */ new Set();
+				this.overlaps.set(self, set);
+			}
+			set.add(other);
+		} else if (set) {
+			set.delete(other);
+			if (set.size === 0) this.overlaps.delete(self);
+		}
+	}
+	/**
+	* Forget every overlap whose node has left the tree.
+	*
+	* The lazy drop inside `overlapping()` only cleans the SETS of a key someone
+	* asks about, and only when they ask. This clears the KEYS, which is where the
+	* dead nodes were pinned.
+	*/
+	/** Drop one node from the overlap map, both as a key and as a member. */
+	forgetOverlaps(node) {
+		this.overlaps.delete(node);
+		for (const [self, others] of this.overlaps) {
+			others.delete(node);
+			if (others.size === 0) this.overlaps.delete(self);
+		}
+	}
+	pruneOverlaps() {
+		for (const [self, others] of this.overlaps) {
+			if (self.tree === null) {
+				this.overlaps.delete(self);
+				continue;
+			}
+			for (const other of others) if (other.tree === null) others.delete(other);
+			if (others.size === 0) this.overlaps.delete(self);
+		}
+	}
+	/** The bodies currently overlapping `node`. Freed nodes are dropped on read. */
+	overlapping(node) {
+		const set = this.overlaps.get(node);
+		if (!set) return [];
+		for (const other of set) if (other.tree === null) set.delete(other);
+		return [...set];
+	}
 	/**
 	* World-space raycast in PIXELS (y-down). `exclude` skips that body — a
 	* shooter probing from inside its own collider needs it. Sensors (Area2D)
@@ -400,6 +452,7 @@ var Physics2D = class {
 				this.byColliderHandle.delete(e.collider.handle);
 				this.world.removeRigidBody(e.body);
 				this.entries.delete(node);
+				this.forgetOverlaps(node);
 				node._physics = null;
 			}
 		}

package/dist/{physics-3d-DULB1lD1.js → physics-3d-i1IeAY0F.js}

@@ -1,10 +1,10 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { k as diagnose } from "./loader-lQDCwNag.js";
+import { k as diagnose } from "./loader-KZESOZmE.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
-import { B as CharacterBody3D, G as validateCollider3D, H as RigidBody3D, V as PhysicsBody3D, W as Node3D, z as Area3D } from "./gameplay-D-H986A4.js";
+import { H as CharacterBody3D, K as Node3D, U as PhysicsBody3D, V as Area3D, W as RigidBody3D, q as validateCollider3D } from "./gameplay-CGSv-9XR.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-BvHs6HEk.js";
+import { n as jointContacts, t as withoutRapierInitNoise } from "./quiet-rapier-C6fW4zcW.js";
+import { A as Terrain3D, F as InstancedMesh3D, L as buildMeshGeometry, P as Joint3D } from "./environment-presets-C-5g2pMh.js";
 import { Euler, Matrix4, Quaternion, Vector3 } from "three";
 //#region src/3d/physics/collider-lines.ts
 /**
@@ -262,6 +262,7 @@ var Physics3D = class {
 		this.unregisterDebug = registerDebugSource(this);
 		this.disconnect = engine.fixedUpdated.connect((dt) => this.step(dt));
 		this.disconnectScene = engine.sceneChanged.connect(() => {
+			this.pruneOverlaps();
 			if (engine.scene) this.syncBodies();
 		});
 		engine.physics = this;
@@ -328,6 +329,11 @@ var Physics3D = class {
 				nv[0] = lv.x;
 				nv[1] = lv.y;
 				nv[2] = lv.z;
+				const av = e.body.angvel();
+				const na = node.angularVelocity;
+				na[0] = av.x;
+				na[1] = av.y;
+				na[2] = av.z;
 				e.lastV[0] = lv.x;
 				e.lastV[1] = lv.y;
 				e.lastV[2] = lv.z;
@@ -342,6 +348,8 @@ var Physics3D = class {
 			const b = this.byColliderHandle.get(h2);
 			if (!a || !b) return;
 			const sig = started ? "triggerEnter" : "triggerExit";
+			this.trackOverlap(a, b, started);
+			this.trackOverlap(b, a, started);
 			try {
 				a.emit(sig, b);
 				b.emit(sig, a);
@@ -602,6 +610,7 @@ var Physics3D = class {
 				this.byColliderHandle.delete(e.collider.handle);
 				this.world.removeRigidBody(e.body);
 				this.entries.delete(node);
+				this.forgetOverlaps(node);
 				node._physics = null;
 				node._interpPrev = node._interpCurr = null;
 			}
@@ -635,6 +644,11 @@ var Physics3D = class {
 			if (node instanceof RigidBody3D) {
 				desc.setGravityScale(node.gravityScale);
 				desc.setLinvel(node.linearVelocity[0] ?? 0, node.linearVelocity[1] ?? 0, node.linearVelocity[2] ?? 0);
+				desc.setAngvel({
+					x: node.angularVelocity[0] ?? 0,
+					y: node.angularVelocity[1] ?? 0,
+					z: node.angularVelocity[2] ?? 0
+				});
 				if (node.fixedRotation) desc.lockRotations();
 			}
 			const body = this.world.createRigidBody(desc);
@@ -791,9 +805,64 @@ var Physics3D = class {
 			else if (joint.type === "rope") data = R.JointData.rope(length, a1, a2);
 			else if (joint.type === "spring") data = R.JointData.spring(length, joint.stiffness, joint.damping, a1, a2);
 			else data = R.JointData.spherical(a1, a2);
-			this.joints.set(joint, this.world.createImpulseJoint(data, ea.body, eb.body, true));
+			const made = this.world.createImpulseJoint(data, ea.body, eb.body, true);
+			made.setContactsEnabled(jointContacts(joint.type, joint.collide));
+			this.joints.set(joint, made);
+		}
+	}
+	/** Who is currently inside each sensor/body, maintained from the event drain. */
+	overlaps = /* @__PURE__ */ new Map();
+	trackOverlap(self, other, started) {
+		let set = this.overlaps.get(self);
+		if (started) {
+			if (!set) {
+				set = /* @__PURE__ */ new Set();
+				this.overlaps.set(self, set);
+			}
+			set.add(other);
+		} else if (set) {
+			set.delete(other);
+			if (set.size === 0) this.overlaps.delete(self);
+		}
+	}
+	/**
+	* Forget every overlap whose node has left the tree.
+	*
+	* The lazy drop inside `overlapping()` only cleans the SETS of a key someone
+	* asks about, and only when they ask. This clears the KEYS, which is where the
+	* dead nodes were pinned.
+	*/
+	/** Drop one node from the overlap map, both as a key and as a member. */
+	forgetOverlaps(node) {
+		this.overlaps.delete(node);
+		for (const [self, others] of this.overlaps) {
+			others.delete(node);
+			if (others.size === 0) this.overlaps.delete(self);
 		}
 	}
+	pruneOverlaps() {
+		for (const [self, others] of this.overlaps) {
+			if (self.tree === null) {
+				this.overlaps.delete(self);
+				continue;
+			}
+			for (const other of others) if (other.tree === null) others.delete(other);
+			if (others.size === 0) this.overlaps.delete(self);
+		}
+	}
+	/**
+	* The bodies currently overlapping `node` — the standing answer behind
+	* `triggerEnter`/`triggerExit`.
+	*
+	* Freed nodes are dropped on read rather than tracked, so a hazard that
+	* despawns inside a plate cannot leave a ghost holding a door open.
+	*/
+	overlapping(node) {
+		const set = this.overlaps.get(node);
+		if (!set) return [];
+		for (const other of set) if (other.tree === null) set.delete(other);
+		return [...set];
+	}
 	/**
 	* World-space raycast (meters). `exclude` skips that body's collider —
 	* ground probes from inside a capsule need it. `opts.staticOnly` hits ONLY the

package/dist/{quiet-rapier-BAJ4K94N.js → quiet-rapier-C6fW4zcW.js}

@@ -1,3 +1,16 @@
+//#region src/core/joint-contacts.ts
+/**
+* Should these two jointed bodies collide with each other?
+*
+* `null` means "decide from the type": a PIVOT wants its bodies overlapping and
+* must not let the contact solver fight the joint; a TETHER anchors something to
+* the world and that something still has to rest on it.
+*/
+function jointContacts(type, collide) {
+	if (collide !== null) return collide;
+	return type === "rope" || type === "spring";
+}
+//#endregion
 //#region src/core/quiet-rapier.ts
 /**
 * Swallow one wrong warning that rapier prints about itself.
@@ -43,4 +56,4 @@ async function withoutRapierInitNoise(boot, out = console) {
 	}
 }
 //#endregion
-export { withoutRapierInitNoise as t };
+export { jointContacts as n, withoutRapierInitNoise as t };

package/dist/react.d.ts

@@ -1,4 +1,4 @@
-import { P as Scene, b as Engine, n as BehaviorCtor } from "./behavior-CmMuQ6CL.js";
+import { P as Scene, b as Engine, n as BehaviorCtor } from "./behavior-ZnfzKDo3.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-W2xzTJhs.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-DIyh5Zy9.js").then((n) => n.n)).createGame2D(o)))(opts);
+			const next = await (_gameFactory ?? (mode === "3d" ? async (o) => (await import("./create-game-FAXdHta3.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-DMetd3vR.js").then((n) => n.n)).createGame2D(o)))(opts);
 			if (disposed) {
 				next.dispose();
 				return;