incanto 0.50.0 → 0.52.0

package/dist/{environment-presets-XFuqu5jv.js → environment-presets-DSZwsKPs.js}

@@ -1,10 +1,10 @@
-import { t as registerCoreNodes } from "./register-uvaZj1KX.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 { t as createNoise2D } from "./noise-CGUMx44x.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 { A as Water3D, F as PhysicsBody3D, H as colliderFootDrop, I as RigidBody3D, L as StaticBody3D, M as WaterCutout3D, N as Area3D, P as CharacterBody3D, R as Node3D } from "./gameplay-DbaI313d.js";
+import { F as CharacterBody3D, I as PhysicsBody3D, L as RigidBody3D, N as WaterCutout3D, P as Area3D, R as StaticBody3D, U as colliderFootDrop, j as Water3D, z as Node3D } from "./gameplay-B6jqvYeM.js";
 import { n as splatWeights, t as buildHeightmap } from "./heightmap-CRK0M4jT.js";
 import { AdditiveBlending, AnimationClip, AnimationMixer, Box3, BoxGeometry, BufferAttribute, BufferGeometry, CanvasTexture, CapsuleGeometry, ClampToEdgeWrapping, Color, ConeGeometry, CylinderGeometry, DataTexture, DirectionalLight, DoubleSide, DynamicDrawUsage, Euler, Group, IcosahedronGeometry, ImageBitmapLoader, InstancedBufferAttribute, InstancedMesh, LinearFilter, LinearMipmapLinearFilter, LoopOnce, LoopRepeat, Matrix4, Mesh, MeshBasicMaterial, MeshDepthMaterial, MeshPhysicalMaterial, MeshStandardMaterial, NearestFilter, NoBlending, NoColorSpace, NormalBlending, PerspectiveCamera, PlaneGeometry, PointLight, Points, PointsMaterial, Quaternion, QuaternionKeyframeTrack, RGBADepthPacking, RGBAFormat, RepeatWrapping, SRGBColorSpace, ShaderChunk, ShaderMaterial, SphereGeometry, Texture, TextureLoader, UniformsLib, UniformsUtils, Vector3, Vector4, VectorKeyframeTrack } from "three";
 import { clone } from "three/addons/utils/SkeletonUtils.js";

package/dist/{gameplay-DbaI313d.js → gameplay-B6jqvYeM.js}

@@ -1,7 +1,7 @@
-import { f as Node, h as effectiveOrder, n as loadScene, w as registerBehavior, y as Behavior } from "./loader-DwazzlQb.js";
+import { A as registerBehavior, T as Behavior, b as effectiveOrder, f as Node, n as loadScene, p as SaveSlots } from "./loader-B-Gft32x.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as jsonClone } from "./json-BLk7H2Qa.js";
-import { t as duplicateNode } from "./duplicate-CI9WF_bg.js";
+import { t as duplicateNode } from "./duplicate-B-OtSRFL.js";
 import { Color, CubeCamera, DepthTexture, DoubleSide, Euler, FloatType, Frustum, HalfFloatType, LinearMipmapLinearFilter, MathUtils, Matrix4, Mesh, MeshDepthMaterial, Object3D, PerspectiveCamera, Plane, PlaneGeometry, Quaternion, ShaderMaterial, Sphere, Vector2, Vector3, Vector4, WebGLCubeRenderTarget, WebGLRenderTarget } from "three";
 //#region src/3d/frustum.ts
 const scratchFrustum = new Frustum();
@@ -4374,7 +4374,8 @@ var Chase = class extends Behavior {
 		/** NodePath of the node to chase (resolved from THIS behavior's node). */
 		target: {
 			default: "",
-			nodePath: true
+			nodePath: true,
+			required: true
 		},
 		/** Units per second toward the target. */
 		speed: { default: 60 },
@@ -4909,7 +4910,8 @@ var FollowCamera = class extends Behavior {
 		/** NodePath of the node to follow (relative to this node, or absolute). */
 		target: {
 			default: "",
-			nodePath: true
+			nodePath: true,
+			required: true
 		},
 		/** Constant offset added to the target's position ([x,y] or [x,y,z]). */
 		offset: { default: [] },
@@ -5754,8 +5756,8 @@ var Pickup = class extends Behavior {
 		const collector = findCollector(other, this.collectorGroup);
 		if (!collector) return;
 		this.collectedAlready = true;
-		this.emit("collected", this.value, collector);
 		this.node.queueFree();
+		this.emit("collected", this.value, collector);
 	}
 };
 /**
@@ -5856,6 +5858,160 @@ var Projectile = class extends Behavior {
 	}
 };
 //#endregion
+//#region src/gameplay/save-point.ts
+/**
+* The save, as something the scene can point a signal at.
+*
+* Every other common wiring in this engine became declarative — score to
+* screen, damage to health bar, waves, win and lose — and saving stayed the one
+* thing that needed TypeScript. The skill's own autosave example is a
+* connection to `Game.onCheckpoint`, a method the author has to go and write.
+*
+* "*When* to save is a design decision and only your game knows" is right, and
+* it is untouched here: the SCENE still says when, by choosing which signal to
+* wire — a level exit's `triggerEnter`, `won`, a key. What it gets is something
+* to wire TO.
+*
+* ```json
+* { "name": "Save", "type": "Node", "uid": "n_…",
+*   "script": { "name": "SavePoint", "props": { "game": "vault", "slot": "1" } } }
+* ```
+* ```json
+* { "signal": "triggerEnter", "from": "Level/Exit", "to": "Save", "handler": "save" }
+* ```
+*/
+var SavePoint = class extends Behavior {
+	static props = {
+		/** Namespace for this game's slots — keeps two games on one origin apart. */
+		game: { default: "game" },
+		/** Which slot this node writes and reads. */
+		slot: { default: "1" },
+		/** Shown in a load menu. */
+		label: { default: "" },
+		/**
+		* The scene key a load should route back to. Empty = this scene's `name`.
+		* The engine does not route scenes; it records what your loader will need.
+		*/
+		scene: { default: "" },
+		/** Read the slot back as soon as the scene is ready — a "Continue" boot. */
+		restoreOnReady: { default: false },
+		/**
+		* Ask, without loading: on the first frame, emit `hasSave(label, playtime)`
+		* or `noSave`. A title screen needs this and nothing else — the scene can
+		* then wire `noSave → Continue.hide` and `hasSave → SlotInfo.setText`.
+		*/
+		probeOnReady: { default: false }
+	};
+	static signals = [
+		"saved",
+		"restored",
+		"noSave",
+		"hasSave"
+	];
+	game = "game";
+	slot = "1";
+	label = "";
+	scene = "";
+	restoreOnReady = false;
+	probeOnReady = false;
+	/** Seconds this run has been playing — written into the slot as `playtime`. */
+	elapsed = 0;
+	slots = null;
+	store() {
+		this.slots ??= new SaveSlots(this.game);
+		return this.slots;
+	}
+	pendingRestore = false;
+	pendingProbe = false;
+	onReady() {
+		this.pendingRestore = this.restoreOnReady;
+		this.pendingProbe = this.probeOnReady;
+	}
+	update(dt) {
+		if (this.pendingProbe) {
+			this.pendingProbe = false;
+			this.probe();
+		}
+		if (this.pendingRestore) {
+			this.pendingRestore = false;
+			this.restore();
+		}
+		this.elapsed += dt;
+	}
+	/**
+	* Is there anything to continue? Emits `hasSave(label, playtime, scene)` or
+	* `noSave`, and touches nothing.
+	*
+	* The label leads because that is what a menu shows; an unlabelled slot
+	* falls back to its scene key, so `hasSave → SlotInfo.setText` always says
+	* something rather than nothing.
+	*/
+	probe() {
+		const slot = this.store().read(this.slot);
+		if (!slot) {
+			this.emit("noSave");
+			return;
+		}
+		this.emit("hasSave", slot.label || slot.scene, slot.playtime, slot.scene);
+	}
+	/** Seconds this run has been playing, including time carried over a continue. */
+	get playtime() {
+		return Math.round(this.elapsed);
+	}
+	/**
+	* The scene key this slot was saved from — what a loader needs to route.
+	* Null when the slot is empty.
+	*/
+	slotScene() {
+		return this.store().read(this.slot)?.scene ?? null;
+	}
+	/**
+	* Write the run to its slot. Emits `saved(slotId)`.
+	*
+	* Wire it to whatever marks the moment. Extra signal arguments are ignored,
+	* so `triggerEnter → save` works as-is.
+	*/
+	save() {
+		const engine = this.engine;
+		this.store().write(this.slot, {
+			scene: this.scene || (engine.scene?.source.name ?? ""),
+			state: engine.captureState(),
+			label: this.label,
+			savedAt: Date.now(),
+			playtime: Math.round(this.elapsed)
+		});
+		this.emit("saved", this.slot);
+	}
+	/**
+	* Give this scene the slot's state back. Emits `restored(count)`, or
+	* `noSave` when the slot is empty — which is what greys out a Continue button.
+	*
+	* Restoring does NOT route: if the slot names another scene, that is your
+	* loader's business, and `slot.scene` is the key it needs.
+	*/
+	restore() {
+		const slot = this.store().read(this.slot);
+		if (!slot) {
+			this.emit("noSave");
+			return;
+		}
+		const report = this.engine.restoreState(slot.state);
+		this.emit("restored", report.restored);
+	}
+	/** Forget this slot — a "delete save" button. */
+	clear() {
+		this.store().remove(this.slot);
+	}
+	/** The run's own clock survives a save/continue cycle. */
+	serialize() {
+		return { playtime: Math.round(this.elapsed) };
+	}
+	deserialize(data) {
+		const d = data;
+		if (typeof d.playtime === "number" && d.playtime >= 0) this.elapsed = d.playtime;
+	}
+};
+//#endregion
 //#region src/gameplay/score-keeper.ts
 /**
 * The game's state hub — score, lives, and win/lose detection. Put it on the
@@ -6460,6 +6616,7 @@ const GAMEPLAY_BEHAVIORS = {
 	DamageOnContact,
 	Interactable,
 	Clickable,
+	SavePoint,
 	FollowCamera,
 	Patrol,
 	Chase,
@@ -6482,4 +6639,4 @@ function registerGameplayBehaviors(opts) {
 	for (const [name, ctor] of Object.entries(GAMEPLAY_BEHAVIORS)) registerBehavior(name, ctor, { replace });
 }
 //#endregion
-export { Water3D as A, createCausticsQuad as B, FollowCamera as C, Health as D, DamageOnContact as E, PhysicsBody3D as F, colliderFootDrop as H, RigidBody3D as I, StaticBody3D as L, WaterCutout3D as M, Area3D as N, Collector as O, CharacterBody3D as P, Node3D as R, restartScene as S, phaseOf as T, WATER_MAX_RIPPLES as V, hitStop as _, Wander as a, GameFlow as b, Projectile as c, PathFollow as d, Oscillate as f, Cooldown as g, CameraShake as h, WaveSpawner as i, WATER_CUTOUT_MAX as j, Chase as k, Pickup as l, Lifetime as m, registerGameplayBehaviors as n, Spawner as o, MoveTo as p, ZombieAI as r, ScoreKeeper as s, GAMEPLAY_BEHAVIORS as t, Patrol as u, screenFlash as v, DayNight as w, goToScene as x, Interactable as y, validateCollider3D as z };
+export { Chase as A, validateCollider3D as B, restartScene as C, DamageOnContact as D, phaseOf as E, CharacterBody3D as F, WATER_MAX_RIPPLES as H, PhysicsBody3D as I, RigidBody3D as L, WATER_CUTOUT_MAX as M, WaterCutout3D as N, Health as O, Area3D as P, StaticBody3D as R, goToScene as S, DayNight as T, colliderFootDrop as U, createCausticsQuad as V, Cooldown as _, Wander as a, Interactable as b, SavePoint as c, Patrol as d, PathFollow as f, CameraShake as g, Lifetime as h, WaveSpawner as i, Water3D as j, Collector as k, Projectile as l, MoveTo as m, registerGameplayBehaviors as n, Spawner as o, Oscillate as p, ZombieAI as r, ScoreKeeper as s, GAMEPLAY_BEHAVIORS as t, Pickup as u, hitStop as v, FollowCamera as w, GameFlow as x, screenFlash as y, Node3D as z };

package/dist/gameplay.d.ts

@@ -1,4 +1,4 @@
-import { Et as Node, b as Engine, d as PropSchema, n as BehaviorCtor, t as Behavior } from "./behavior-62q0HWBO.js";
+import { Dt as Node, b as Engine, d as PropSchema, n as BehaviorCtor, t as Behavior } from "./behavior-uPEuZrUB.js";
 import { c as JsonValue, s as JsonObject } from "./schema-CFeioQRE.js";
 
 //#region src/gameplay/chase.d.ts
@@ -375,6 +375,83 @@ declare class Projectile extends Behavior {
   private forwardFromRotation;
 }
 //#endregion
+//#region src/gameplay/save-point.d.ts
+/**
+* The save, as something the scene can point a signal at.
+*
+* Every other common wiring in this engine became declarative — score to
+* screen, damage to health bar, waves, win and lose — and saving stayed the one
+* thing that needed TypeScript. The skill's own autosave example is a
+* connection to `Game.onCheckpoint`, a method the author has to go and write.
+*
+* "*When* to save is a design decision and only your game knows" is right, and
+* it is untouched here: the SCENE still says when, by choosing which signal to
+* wire — a level exit's `triggerEnter`, `won`, a key. What it gets is something
+* to wire TO.
+*
+* ```json
+* { "name": "Save", "type": "Node", "uid": "n_…",
+*   "script": { "name": "SavePoint", "props": { "game": "vault", "slot": "1" } } }
+* ```
+* ```json
+* { "signal": "triggerEnter", "from": "Level/Exit", "to": "Save", "handler": "save" }
+* ```
+*/
+declare class SavePoint extends Behavior {
+  static readonly props: PropSchema;
+  static readonly signals: readonly string[];
+  game: string;
+  slot: string;
+  label: string;
+  scene: string;
+  restoreOnReady: boolean;
+  probeOnReady: boolean;
+  /** Seconds this run has been playing — written into the slot as `playtime`. */
+  private elapsed;
+  private slots;
+  private store;
+  private pendingRestore;
+  private pendingProbe;
+  override onReady(): void;
+  override update(dt: number): void;
+  /**
+  * Is there anything to continue? Emits `hasSave(label, playtime, scene)` or
+  * `noSave`, and touches nothing.
+  *
+  * The label leads because that is what a menu shows; an unlabelled slot
+  * falls back to its scene key, so `hasSave → SlotInfo.setText` always says
+  * something rather than nothing.
+  */
+  probe(): void;
+  /** Seconds this run has been playing, including time carried over a continue. */
+  get playtime(): number;
+  /**
+  * The scene key this slot was saved from — what a loader needs to route.
+  * Null when the slot is empty.
+  */
+  slotScene(): string | null;
+  /**
+  * Write the run to its slot. Emits `saved(slotId)`.
+  *
+  * Wire it to whatever marks the moment. Extra signal arguments are ignored,
+  * so `triggerEnter → save` works as-is.
+  */
+  save(): void;
+  /**
+  * Give this scene the slot's state back. Emits `restored(count)`, or
+  * `noSave` when the slot is empty — which is what greys out a Continue button.
+  *
+  * Restoring does NOT route: if the slot names another scene, that is your
+  * loader's business, and `slot.scene` is the key it needs.
+  */
+  restore(): void;
+  /** Forget this slot — a "delete save" button. */
+  clear(): void;
+  /** The run's own clock survives a save/continue cycle. */
+  override serialize(): JsonValue;
+  override deserialize(data: JsonValue): void;
+}
+//#endregion
 //#region src/gameplay/score-keeper.d.ts
 /**
 * The game's state hub — score, lives, and win/lose detection. Put it on the
@@ -787,4 +864,4 @@ declare function registerGameplayBehaviors(opts?: {
   replace?: boolean;
 }): void;
 //#endregion
-export { CameraShake, Chase, Collector, Cooldown, DamageOnContact, DayNight, type DayPhase, FollowCamera, GAMEPLAY_BEHAVIORS, GameFlow, type GameFlowState, Health, Interactable, Lifetime, MoveTo, Oscillate, PathFollow, Patrol, Pickup, Projectile, ScoreKeeper, Spawner, Wander, WaveSpawner, ZombieAI, goToScene, hitStop, phaseOf, registerGameplayBehaviors, restartScene, screenFlash };
+export { CameraShake, Chase, Collector, Cooldown, DamageOnContact, DayNight, type DayPhase, FollowCamera, GAMEPLAY_BEHAVIORS, GameFlow, type GameFlowState, Health, Interactable, Lifetime, MoveTo, Oscillate, PathFollow, Patrol, Pickup, Projectile, SavePoint, ScoreKeeper, Spawner, Wander, WaveSpawner, ZombieAI, goToScene, hitStop, phaseOf, registerGameplayBehaviors, restartScene, screenFlash };

package/dist/gameplay.js

@@ -1,2 +1,2 @@
-import { C as FollowCamera, D as Health, E as DamageOnContact, O as Collector, S as restartScene, T as phaseOf, _ as hitStop, a as Wander, b as GameFlow, c as Projectile, d as PathFollow, f as Oscillate, g as Cooldown, h as CameraShake, i as WaveSpawner, k as Chase, l as Pickup, m as Lifetime, n as registerGameplayBehaviors, o as Spawner, p as MoveTo, r as ZombieAI, s as ScoreKeeper, t as GAMEPLAY_BEHAVIORS, u as Patrol, v as screenFlash, w as DayNight, x as goToScene, y as Interactable } from "./gameplay-DbaI313d.js";
-export { CameraShake, Chase, Collector, Cooldown, DamageOnContact, DayNight, FollowCamera, GAMEPLAY_BEHAVIORS, GameFlow, Health, Interactable, Lifetime, MoveTo, Oscillate, PathFollow, Patrol, Pickup, Projectile, ScoreKeeper, Spawner, Wander, WaveSpawner, ZombieAI, goToScene, hitStop, phaseOf, registerGameplayBehaviors, restartScene, screenFlash };
+import { A as Chase, C as restartScene, D as DamageOnContact, E as phaseOf, O as Health, S as goToScene, T as DayNight, _ as Cooldown, a as Wander, b as Interactable, c as SavePoint, d as Patrol, f as PathFollow, g as CameraShake, h as Lifetime, i as WaveSpawner, k as Collector, l as Projectile, m as MoveTo, n as registerGameplayBehaviors, o as Spawner, p as Oscillate, r as ZombieAI, s as ScoreKeeper, t as GAMEPLAY_BEHAVIORS, u as Pickup, v as hitStop, w as FollowCamera, x as GameFlow, y as screenFlash } from "./gameplay-B6jqvYeM.js";
+export { CameraShake, Chase, Collector, Cooldown, DamageOnContact, DayNight, FollowCamera, GAMEPLAY_BEHAVIORS, GameFlow, Health, Interactable, Lifetime, MoveTo, Oscillate, PathFollow, Patrol, Pickup, Projectile, SavePoint, ScoreKeeper, Spawner, Wander, WaveSpawner, ZombieAI, goToScene, hitStop, phaseOf, registerGameplayBehaviors, restartScene, screenFlash };

package/dist/index.d.ts

@@ -1,10 +1,10 @@
-import { $ as suggestLocale, A as SettingsValues, At as LogLevel, B as captureBehaviors, C as EngineStats, Ct as PlayMusicOptions, Dt as NodeLifecycle, E as DeviceHints, Et as Node, F as BehaviorState, G as OrderGroup, H as SaveStore, I as RestoreReport, J as resolveOrderGroups, K as OrderGroupTable, L as SaveSlot, M as readDeviceHints, Mt as Signal, N as suggestQuality, Nt as SignalListener, O as QualityTier, Ot as SceneTree, P as Scene, Q as T_PREFIX, R as SaveSlots, S as Scheduler, St as MusicTrack, T as RendererStats, Tt as BusName, U as createSaveStore, V as restoreBehaviors, W as ORDER_GROUP_BASE, X as LocaleTables, Y as BASE_LOCALE, Z as Localization, _ as mergeStaticSignals, _t as SfxWave, a as clearBehaviors, at as Voice, b as Engine, bt as MusicBackend, c as registeredBehaviors, ct as ROLLOFF_MODELS, d as PropSchema, dt as Vec3, et as translationKey, f as clearRegistry, ft as spatialGain, g as getNodeType, gt as SfxParams, h as getNodeSignals, ht as SFX_PRESET_NAMES, i as behaviorSignals, it as isAudioContextAvailable, j as qualityEnvironment, jt as LogManager, k as Settings, kt as LogEntry, l as NodeCtor, lt as RolloffModel, m as getNodeSchema, mt as SFX_PRESETS, n as BehaviorCtor, nt as SfxEngine, o as getBehavior, ot as VoicePreset, p as createNode, pt as spatialPan, q as effectiveOrder, r as behaviorSchema, rt as SfxPlayOptions, s as registerBehavior, st as Listener, t as Behavior, tt as InputMap, u as PropDef, ut as SpatialParams, v as registerNode, vt as SynthOptions, w as GameStats, wt as AudioBuses, x as EngineOptions, xt as MusicManager, y as registeredTypes, yt as synthSfx, z as behaviorsWithoutSave } from "./behavior-62q0HWBO.js";
+import { $ as T_PREFIX, A as SettingsValues, At as LogEntry, B as captureBehaviors, C as EngineStats, Ct as MusicTrack, Dt as Node, E as DeviceHints, Et as BusName, F as BehaviorState, G as ORDER_GROUP_BASE, H as savesWithoutUid, I as RestoreReport, J as effectiveOrder, K as OrderGroup, L as SaveSlot, M as readDeviceHints, Mt as LogManager, N as suggestQuality, Nt as Signal, O as QualityTier, Ot as NodeLifecycle, P as Scene, Pt as SignalListener, Q as Localization, R as SaveSlots, S as Scheduler, St as MusicManager, T as RendererStats, Tt as AudioBuses, U as SaveStore, V as restoreBehaviors, W as createSaveStore, X as BASE_LOCALE, Y as resolveOrderGroups, Z as LocaleTables, _ as mergeStaticSignals, _t as SfxParams, a as clearBehaviors, at as isAudioContextAvailable, b as Engine, bt as synthSfx, c as registeredBehaviors, ct as Listener, d as PropSchema, dt as SpatialParams, et as suggestLocale, f as clearRegistry, ft as Vec3, g as getNodeType, gt as SFX_PRESET_NAMES, h as getNodeSignals, ht as SFX_PRESETS, i as behaviorSignals, it as SfxPlayOptions, j as qualityEnvironment, jt as LogLevel, k as Settings, kt as SceneTree, l as NodeCtor, lt as ROLLOFF_MODELS, m as getNodeSchema, mt as spatialPan, n as BehaviorCtor, nt as InputMap, o as getBehavior, ot as Voice, p as createNode, pt as spatialGain, q as OrderGroupTable, r as behaviorSchema, rt as SfxEngine, s as registerBehavior, st as VoicePreset, t as Behavior, tt as translationKey, u as PropDef, ut as RolloffModel, v as registerNode, vt as SfxWave, w as GameStats, wt as PlayMusicOptions, x as EngineOptions, xt as MusicBackend, y as registeredTypes, yt as SynthOptions, z as behaviorsWithoutSave } from "./behavior-uPEuZrUB.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-CeyU_bm1.js";
+import { n as loadScene, t as LoadSceneOptions } from "./loader-B9iTqs27.js";
 import { i as resolveFrames, n as AnimationEntry, r as resolveAnimation, t as AnimationDef } from "./sprite-animation-CMr6f1K2.js";
 import { n as ParticleSimConfig, r as ParticleView, t as ParticleSim } from "./particle-sim-BzJ1yxoE.js";
-import { a as AudioElementLike, i as gridFromRows, n as PathGrid, o as AudioPlayer, r as findPath, t as FindPathOptions } from "./pathfinding-C49JSNNq.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-DYdy1wb0.js";
+import { a as AudioElementLike, i as gridFromRows, n as PathGrid, o as AudioPlayer, r as findPath, t as FindPathOptions } from "./pathfinding-CAR9DjQQ.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-BU1CCM15.js";
 
 //#region src/core/audio/crossfade.d.ts
 /**
@@ -189,6 +189,66 @@ type ParsedNodePath = {
 };
 declare function parseNodePath(path: string): ParsedNodePath;
 //#endregion
+//#region src/core/node-refs.d.ts
+/** The scene-JSON shape this walks. */
+interface RefNode {
+  name?: string;
+  type?: string;
+  props?: JsonObject;
+  script?: {
+    name?: string;
+    props?: JsonObject;
+  };
+  children?: RefNode[];
+}
+/** Why a written path leads nowhere. Structured so callers can localize it. */
+type RefProblem = {
+  kind: "grammar";
+  message: string;
+} | {
+  kind: "noMatch";
+  name: string;
+} | {
+  kind: "ambiguous";
+  name: string;
+  count: number;
+} | {
+  kind: "wrongRoot";
+  first: string;
+  root: string;
+} | {
+  kind: "noChild";
+  parent: string;
+  segment: string;
+} | {
+  kind: "aboveRoot";
+};
+type RefResult = {
+  ok: true;
+  path: number[];
+} | {
+  ok: false;
+  problem: RefProblem;
+};
+/**
+* Resolve `value` from the node at `owner`, the way the engine would.
+*
+* Note the asymmetry with connections, whose paths resolve from the SCENE ROOT:
+* a prop's path resolves from the node holding it, which is why `'../Skin'` is
+* the documented default of `CharacterController3D.skinPath` and would mean
+* nothing in a connection.
+*/
+declare function resolveRefInJson(root: RefNode | undefined, owner: readonly number[], value: string): RefResult;
+/** The problem in English, for `incanto-check` and as the editor's base text. */
+declare function describeRefProblem(problem: RefProblem, value: string): string;
+/**
+* Scene lints for node-path props that point at nothing.
+*
+* An EMPTY value is not reported: `''` is the default of most of these props and
+* means "not set", which is a choice rather than a typo.
+*/
+declare function nodeRefWarnings(scene: JsonObject): string[];
+//#endregion
 //#region src/core/nodes/hud.d.ts
 /**
 * DOM-backed HUD widgets — the layer 18 of 22 example games hand-rolled.
@@ -258,6 +318,15 @@ declare class HudLayer extends Node {
 }
 /** Shared plumbing: mount into the parent HudLayer's anchor slot. */
 declare abstract class HudWidgetBase 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: unknown[]): void;
+  hide(): void;
   static readonly props: PropSchema;
   static readonly signals: readonly string[];
   anchor: HudAnchor;
@@ -848,4 +917,4 @@ declare function computeViewport(canvasW: number, canvasH: number, viewport: {
 /** Engine version. Kept in sync with package.json by the release pipeline. */
 declare const VERSION: string;
 //#endregion
-export { type AnimationDef, type AnimationEntry, type AssetFailure, AudioBuses, type AudioElementLike, AudioPlayer, BASE_LOCALE, Behavior, type BehaviorCtor, type BehaviorState, type BusName, CONST_REF_KEY, type ComputedViewport, type ConnectionJson, type CrossfadeGains, type DebugLineSource, type DeviceHints, type DriveScript, type DriveStep, Engine, type EngineOptions, type EngineStats, type FindPathOptions, type GameStats, type GroupedLog, type HudAnchor, HudLayer, IncantoError, type IncantoErrorCode, type IncantoErrorDetails, InputMap, type JsonKind, type JsonObject, type JsonValue, type Listener, type LiveInput, type LiveReport, type LoadSceneOptions, type LocaleTables, Localization, type LogEntry, type LogLevel, LogManager, type MusicBackend, MusicManager, type MusicTrack, Node, type NodeCtor, type NodeJson, type NodeLifecycle, ORDER_GROUP_BASE, type OrderGroup, type OrderGroupTable, PARTICLE_PRESETS, PARTICLE_PRESET_NAMES, type ParsedNodePath, type ParticlePresetValues, ParticleSim, type ParticleSimConfig, type ParticleView, type PathGrid, type PlayMusicOptions, type PreloadResult, type PropDef, type PropSchema, type QualityTier, ROLLOFF_MODELS, type Recorder, type RendererStats, type ReplayEvent, type ReplayJson, type ResolvedRendering, type ResolvedViewport, type RestoreReport, Rng, type RolloffModel, SCENE_FORMAT, SFX_PRESETS, SFX_PRESET_NAMES, type SaveSlot, SaveSlots, type SaveStore, Scene, type SceneJson, SceneTree, type Scheduler, Settings, type SettingsValues, SfxEngine, type SfxParams, type SfxPlayOptions, type SfxWave, Signal, type SignalListener, type SpatialParams, type SynthOptions, T_PREFIX, Timer, TouchControls, type TouchControlsOptions, UiBanner, UiBar, UiButton, UiDialogue, UiImage, UiPanel, UiSelect, UiSlider, UiText, UiToggle, VERSION, type Vec3, type ViewportFit, type Voice, type VoicePreset, WebAudioMusicBackend, applyParticlePreset, assetUrls, attachTouchControls, auditScene, behaviorSchema, behaviorSignals, behaviorsWithoutSave, captureBehaviors, clearBehaviors, clearRegistry, computeViewport, createNode, createNoise2D, createSaveStore, crossfadeGains, duplicateNode, effectiveOrder, fadeGain, findPath, getBehavior, getNodeSchema, getNodeSignals, getNodeType, gridFromRows, isAudioContextAvailable, isConstRef, joystickVector, jsonClone, jsonEquals, jsonKind, loadScene, logReport, logText, mergeStaticSignals, newUid, parseDrive, parseNodePath, preloadUrls, qualityEnvironment, readDeviceHints, registerBehavior, registerCoreNodes, registerNode, registeredBehaviors, registeredTypes, replay, resolveAnimation, resolveConstants, resolveFrames, resolveOrderGroups, resolveRendering, resolveViewport, restoreBehaviors, serializeNode, spatialGain, spatialPan, startRecording, suggestLocale, suggestQuality, synthSfx, translationKey };
+export { type AnimationDef, type AnimationEntry, type AssetFailure, AudioBuses, type AudioElementLike, AudioPlayer, BASE_LOCALE, Behavior, type BehaviorCtor, type BehaviorState, type BusName, CONST_REF_KEY, type ComputedViewport, type ConnectionJson, type CrossfadeGains, type DebugLineSource, type DeviceHints, type DriveScript, type DriveStep, Engine, type EngineOptions, type EngineStats, type FindPathOptions, type GameStats, type GroupedLog, type HudAnchor, HudLayer, IncantoError, type IncantoErrorCode, type IncantoErrorDetails, InputMap, type JsonKind, type JsonObject, type JsonValue, type Listener, type LiveInput, type LiveReport, type LoadSceneOptions, type LocaleTables, Localization, type LogEntry, type LogLevel, LogManager, type MusicBackend, MusicManager, type MusicTrack, Node, type NodeCtor, type NodeJson, type NodeLifecycle, ORDER_GROUP_BASE, type OrderGroup, type OrderGroupTable, PARTICLE_PRESETS, PARTICLE_PRESET_NAMES, type ParsedNodePath, type ParticlePresetValues, ParticleSim, type ParticleSimConfig, type ParticleView, type PathGrid, type PlayMusicOptions, type PreloadResult, type PropDef, type PropSchema, type QualityTier, ROLLOFF_MODELS, type Recorder, type RefNode, type RefProblem, type RefResult, type RendererStats, type ReplayEvent, type ReplayJson, type ResolvedRendering, type ResolvedViewport, type RestoreReport, Rng, type RolloffModel, SCENE_FORMAT, SFX_PRESETS, SFX_PRESET_NAMES, type SaveSlot, SaveSlots, type SaveStore, Scene, type SceneJson, SceneTree, type Scheduler, Settings, type SettingsValues, SfxEngine, type SfxParams, type SfxPlayOptions, type SfxWave, Signal, type SignalListener, type SpatialParams, type SynthOptions, T_PREFIX, Timer, TouchControls, type TouchControlsOptions, UiBanner, UiBar, UiButton, UiDialogue, UiImage, UiPanel, UiSelect, UiSlider, UiText, UiToggle, VERSION, type Vec3, type ViewportFit, type Voice, type VoicePreset, 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, preloadUrls, qualityEnvironment, readDeviceHints, registerBehavior, registerCoreNodes, registerNode, registeredBehaviors, registeredTypes, replay, resolveAnimation, resolveConstants, resolveFrames, resolveOrderGroups, resolveRefInJson, resolveRendering, resolveViewport, restoreBehaviors, savesWithoutUid, serializeNode, spatialGain, spatialPan, startRecording, suggestLocale, suggestQuality, synthSfx, translationKey };

package/dist/index.js

@@ -1,14 +1,14 @@
-import { C as getBehavior, E as Signal, S as clearBehaviors, T as registeredBehaviors, _ as InputMap, a as SCENE_FORMAT, b as behaviorSchema, c as SceneTree, d as resolveConstants, f as Node, g as resolveOrderGroups, h as effectiveOrder, i as serializeNode, l as CONST_REF_KEY, m as ORDER_GROUP_BASE, n as loadScene, o as computeViewport, p as parseNodePath, r as Scene, s as resolveViewport, u as isConstRef, w as registerBehavior, x as behaviorSignals, y as Behavior } from "./loader-DwazzlQb.js";
-import { A as T_PREFIX, B as synthSfx, C as behaviorsWithoutSave, D as LogManager, E as createSaveStore, F as ROLLOFF_MODELS, G as AudioBuses, H as WebAudioMusicBackend, I as spatialGain, L as spatialPan, M as translationKey, N as SfxEngine, O as BASE_LOCALE, P as isAudioContextAvailable, R as SFX_PRESETS, S as SaveSlots, T as restoreBehaviors, U as crossfadeGains, V as MusicManager, W as fadeGain, a as UiSlider, b as readDeviceHints, c as UiButton, d as UiBanner, f as UiBar, g as Settings, h as Engine, i as UiSelect, j as suggestLocale, k as Localization, l as UiDialogue, m as AudioPlayer, n as UiImage, o as UiToggle, p as UiText, r as UiPanel, s as Timer, t as registerCoreNodes, u as HudLayer, v as qualityEnvironment, w as captureBehaviors, x as suggestQuality, z as SFX_PRESET_NAMES } from "./register-uvaZj1KX.js";
+import { A as registerBehavior, D as behaviorSignals, E as behaviorSchema, M as Signal, O as clearBehaviors, S as InputMap, T as Behavior, _ as savesWithoutUid, a as SCENE_FORMAT, b as effectiveOrder, c as SceneTree, d as resolveConstants, f as Node, g as restoreBehaviors, h as captureBehaviors, i as serializeNode, j as registeredBehaviors, k as getBehavior, l as CONST_REF_KEY, m as behaviorsWithoutSave, n as loadScene, o as computeViewport, p as SaveSlots, r as Scene, s as resolveViewport, u as isConstRef, v as createSaveStore, w as parseNodePath, x as resolveOrderGroups, y as ORDER_GROUP_BASE } from "./loader-B-Gft32x.js";
+import { A as ROLLOFF_MODELS, B as AudioBuses, C as BASE_LOCALE, D as translationKey, E as suggestLocale, F as synthSfx, I as MusicManager, L as WebAudioMusicBackend, M as spatialPan, N as SFX_PRESETS, O as SfxEngine, P as SFX_PRESET_NAMES, R as crossfadeGains, S as LogManager, T as T_PREFIX, a as UiSlider, b as readDeviceHints, c as UiButton, d as UiBanner, f as UiBar, g as Settings, h as Engine, i as UiSelect, j as spatialGain, k as isAudioContextAvailable, l as UiDialogue, m as AudioPlayer, n as UiImage, o as UiToggle, p as UiText, r as UiPanel, s as Timer, t as registerCoreNodes, u as HudLayer, v as qualityEnvironment, w as Localization, x as suggestQuality, z as fadeGain } from "./register-DVwlnZAZ.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as Rng } from "./rng-DP-SR7eg.js";
-import { n as startRecording, r as auditScene, t as replay } from "./replay-j-m6lJ4W.js";
 import { n as jsonEquals, r as jsonKind, t as jsonClone } from "./json-BLk7H2Qa.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-IyWCGe4q.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-C7u42TID.js";
+import { a as nodeRefWarnings, i as describeRefProblem, n as startRecording, o as resolveRefInJson, r as auditScene, t as replay } from "./replay-BicPOMX0.js";
 import { n as logText, r as parseDrive, t as logReport } from "./log-report-lxrQY9cH.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-D_p28jwU.js";
-import { a as findPath, i as preloadUrls, n as newUid, o as gridFromRows, r as assetUrls, t as VERSION } from "./src-B3HrKuAi.js";
+import { a as findPath, i as preloadUrls, n as newUid, o as gridFromRows, r as assetUrls, t as VERSION } from "./src-5gbZO47I.js";
 import { i as resolveRendering, n as attachTouchControls, r as joystickVector, t as TouchControls } from "./touch-BoNg_MnF.js";
-import { t as duplicateNode } from "./duplicate-CI9WF_bg.js";
-export { AudioBuses, AudioPlayer, BASE_LOCALE, Behavior, CONST_REF_KEY, Engine, HudLayer, IncantoError, InputMap, Localization, LogManager, MusicManager, Node, ORDER_GROUP_BASE, PARTICLE_PRESETS, PARTICLE_PRESET_NAMES, ParticleSim, ROLLOFF_MODELS, Rng, SCENE_FORMAT, SFX_PRESETS, SFX_PRESET_NAMES, SaveSlots, Scene, SceneTree, Settings, SfxEngine, Signal, T_PREFIX, Timer, TouchControls, UiBanner, UiBar, UiButton, UiDialogue, UiImage, UiPanel, UiSelect, UiSlider, UiText, UiToggle, VERSION, WebAudioMusicBackend, applyParticlePreset, assetUrls, attachTouchControls, auditScene, behaviorSchema, behaviorSignals, behaviorsWithoutSave, captureBehaviors, clearBehaviors, clearRegistry, computeViewport, createNode, createNoise2D, createSaveStore, crossfadeGains, duplicateNode, effectiveOrder, fadeGain, findPath, getBehavior, getNodeSchema, getNodeSignals, getNodeType, gridFromRows, isAudioContextAvailable, isConstRef, joystickVector, jsonClone, jsonEquals, jsonKind, loadScene, logReport, logText, mergeStaticSignals, newUid, parseDrive, parseNodePath, preloadUrls, qualityEnvironment, readDeviceHints, registerBehavior, registerCoreNodes, registerNode, registeredBehaviors, registeredTypes, replay, resolveAnimation, resolveConstants, resolveFrames, resolveOrderGroups, resolveRendering, resolveViewport, restoreBehaviors, serializeNode, spatialGain, spatialPan, startRecording, suggestLocale, suggestQuality, synthSfx, translationKey };
+import { t as duplicateNode } from "./duplicate-B-OtSRFL.js";
+export { AudioBuses, AudioPlayer, BASE_LOCALE, Behavior, CONST_REF_KEY, Engine, HudLayer, IncantoError, InputMap, Localization, LogManager, MusicManager, Node, ORDER_GROUP_BASE, PARTICLE_PRESETS, PARTICLE_PRESET_NAMES, ParticleSim, ROLLOFF_MODELS, Rng, SCENE_FORMAT, SFX_PRESETS, SFX_PRESET_NAMES, SaveSlots, Scene, SceneTree, Settings, SfxEngine, Signal, T_PREFIX, Timer, TouchControls, UiBanner, UiBar, UiButton, UiDialogue, UiImage, UiPanel, UiSelect, UiSlider, UiText, UiToggle, 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, preloadUrls, qualityEnvironment, readDeviceHints, registerBehavior, registerCoreNodes, registerNode, registeredBehaviors, registeredTypes, replay, resolveAnimation, resolveConstants, resolveFrames, resolveOrderGroups, resolveRefInJson, resolveRendering, resolveViewport, restoreBehaviors, savesWithoutUid, serializeNode, spatialGain, spatialPan, startRecording, suggestLocale, suggestQuality, synthSfx, translationKey };