incanto 0.61.0 → 0.62.0

package/dist/{gameplay-Dtzd2itW.js → gameplay-CaHqDiQD.js}

@@ -1,7 +1,7 @@
-import { O as Node, P as Behavior, _ as SaveSlots, k as diagnose, n as loadScene, w as effectiveOrder, z as registerBehavior } from "./loader-D7jTvDQv.js";
+import { O as Node, P as Behavior, _ as SaveSlots, k as diagnose, n as loadScene, w as effectiveOrder, z as registerBehavior } from "./loader-DEe272nY.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as jsonClone } from "./json-CwwhxQgb.js";
-import { t as duplicateNode } from "./duplicate-CGqAmK2h.js";
+import { t as duplicateNode } from "./duplicate-E4FUs5Bn.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();
@@ -2625,6 +2625,51 @@ var CharacterBody3D = class extends PhysicsBody3D {
 	}
 };
 //#endregion
+//#region src/3d/nodes/unscalable.ts
+/**
+* Refuse `scale` on a node that keeps a CPU twin of itself.
+*
+* `scale` is a plain `Node3D` prop and the 3D skill actively recommends it —
+* *"resize with `scale`, not `size` — resizing a mesh rebuilds its geometry
+* every call, scaling is free"*. On a mesh that is true. On `Terrain3D`,
+* `Water3D` and `River3D` it resizes only the PICTURE: everything the gameplay
+* layer reads is scale-blind, because it reads `size`.
+*
+* - `Terrain3D.heightAt` indexes a heightmap built from `size` and composes
+*   ancestor POSITIONS only
+* - `buildHeightfieldDesc3D` passes `{x: hm.width, y: 1, z: hm.depth}` with no
+*   scale term
+* - `Water3D._waterYAt` rejects anything outside `size / 2` of the node
+*
+* Measured on `size: [100, 100]` at `scale: [2, 1, 2]`:
+*
+* ```
+* terrain rendered X extent = [-100.0, 100.0]   (was [-50, 50])
+* terrain heightAt(70, 0)   = -50.000           (unchanged: the island floor)
+* water rendered X extent   = [-40.0, 40.0]
+* water _waterYAt(30, 0)    = null              (unchanged)
+* ```
+*
+* So the player walks off an invisible cliff at ±50 m onto ground that is
+* visibly there for another 50; drape, spawn placement and terrain-nav all
+* agree with the collider and disagree with the picture; a scaled water's
+* underwater fog, splash and `avoidWater` culling stop at half the visible
+* shoreline. `incanto check` called the scene valid and `auditScene` said
+* nothing.
+*
+* A hard load error rather than a warning, per the engine's own guardrail: the
+* dial the author wanted exists and is one word away.
+*/
+function rejectScale(node, reads) {
+	const scale = node.scale;
+	if (!Array.isArray(scale)) return;
+	if (scale.every((v) => Math.abs((v ?? 1) - 1) < 1e-4)) return;
+	const type = node.constructor.typeName ?? "node";
+	const size = node.size;
+	const suggestion = Array.isArray(size) ? `size: [${size.map((v, i) => (v ?? 0) * (scale[i === 1 ? 2 : i] ?? 1)).join(", ")}]` : "size";
+	throw new IncantoError("BAD_FORMAT", `${type} '${node.name}' has scale ${JSON.stringify(scale)}. On this node scale resizes only the MESH — ${reads} read "size" — so the ground you can see would reach past the ground you can stand on. Resize with "${suggestion}" instead.`, { prop: "scale" });
+}
+//#endregion
 //#region src/3d/nodes/water-cutout-3d.ts
 /**
 * A box the water does not enter.
@@ -3155,6 +3200,7 @@ var Water3D = class Water3D extends Node3D {
 	}
 	/** Loader hook: degenerate planes and bad enums fail at LOAD, not at render. */
 	static validateJson(node) {
+		rejectScale(node, "the water surface query, underwater fog, splashes and buoyancy all");
 		const w = node;
 		if (!((w.size[0] ?? 0) > 0) || !((w.size[1] ?? 0) > 0)) throw new IncantoError("BAD_FORMAT", `Water3D '${node.name}' size must be positive [width, depth] meters, got ${JSON.stringify(w.size)}.`, { prop: "size" });
 		if (!WATER_QUALITIES.includes(w.quality)) throw new IncantoError("BAD_FORMAT", `Water3D '${node.name}' quality must be one of [${WATER_QUALITIES.join(", ")}], got '${w.quality}'.`, {
@@ -4388,6 +4434,56 @@ function smoothingFactor(smoothing, dt) {
 	const s = Math.min(Math.max(smoothing, 0), .99);
 	return s <= 0 ? 1 : 1 - s ** (dt * 60);
 }
+/**
+* A node's position with every spatial ancestor's added in.
+*
+* The tree composes transforms for DRAWING — three does it for free — and every
+* piece of engine logic that reads `node.position` gets the LOCAL number
+* instead. Physics already knew (`worldPosition2D`/`worldPosition3D` in the
+* adapters); the camera did not, and neither did anything that chases a target.
+*
+* A camera parented to the player is the Godot and Phaser idiom, and the
+* authoring skill explicitly permits it — *"EVERY node type can hold children …
+* any node works as a grouping container"*. Measured on exactly that scene:
+*
+* ```
+* player world position : [1400, 900]
+* renderer view centre  : {"x":0,"y":0}
+* framing               : camera /Level/Player/Cam centred [1400, 900]
+*                         1 in view, 0 outside it
+* ```
+*
+* The renderer drew empty world 1600 px from the player while `framing` — the
+* instrument the skills tell you to trust before handing a game back —
+* certified the player on screen.
+*
+* Arity comes from the node itself: a 2D node has two components, a 3D node
+* three, and an ancestor that is neither contributes nothing.
+*/
+function worldPosition(node) {
+	const own = node.position;
+	if (!Array.isArray(own)) return [];
+	const out = own.slice();
+	for (let at = node.parent; at; at = at.parent) {
+		const p = at.position;
+		if (!Array.isArray(p)) continue;
+		for (let i = 0; i < out.length; i++) out[i] = (out[i] ?? 0) + (p[i] ?? 0);
+	}
+	return out;
+}
+/**
+* Turn a world position into the local one `node.position` has to hold for the
+* node to END UP there — the inverse of `worldPosition` for its parent chain.
+*/
+function localFromWorld(node, world) {
+	const out = world.slice();
+	for (let at = node.parent; at; at = at.parent) {
+		const p = at.position;
+		if (!Array.isArray(p)) continue;
+		for (let i = 0; i < out.length; i++) out[i] = (out[i] ?? 0) - (p[i] ?? 0);
+	}
+	return out;
+}
 //#endregion
 //#region src/gameplay/chase.ts
 /**
@@ -5062,11 +5158,12 @@ var FollowCamera = class extends Behavior {
 		if (!hasPosition$1(cam)) return;
 		const target = cam.getNodeOrNull(this.target);
 		if (!target || !hasPosition$1(target)) return;
-		const desired = add(target.position, this.offset);
-		if (!(this.deadzone > 0 && distance$1(cam.position, desired) <= this.deadzone)) {
+		const here = worldPosition(cam);
+		const desired = add(worldPosition(target), this.offset);
+		if (!(this.deadzone > 0 && distance$1(here, desired) <= this.deadzone)) {
 			const f = smoothingFactor(this.smoothing, dt);
-			if (f >= 1) cam.position = [...desired];
-			else cam.position = cam.position.map((c, i) => c + ((desired[i] ?? c) - c) * f);
+			if (f >= 1) cam.position = localFromWorld(cam, desired);
+			else cam.position = localFromWorld(cam, here.map((c, i) => c + ((desired[i] ?? c) - c) * f));
 		}
 		if (this.shakeT > 0) {
 			this.shakeT -= dt;
@@ -6069,12 +6166,12 @@ var Projectile = class extends Behavior {
 			return [Math.cos(rad), Math.sin(rad)];
 		}
 		if (Array.isArray(rot)) {
-			const yaw = (rot[1] ?? 0) * Math.PI / 180;
-			const pitch = (rot[0] ?? 0) * Math.PI / 180;
+			const ry = (rot[1] ?? 0) * Math.PI / 180;
+			const rx = (rot[0] ?? 0) * Math.PI / 180;
 			return normalize([
-				-Math.sin(yaw) * Math.cos(pitch),
-				Math.sin(pitch),
-				-Math.cos(yaw) * Math.cos(pitch)
+				Math.sin(ry),
+				-Math.sin(rx) * Math.cos(ry),
+				Math.cos(rx) * Math.cos(ry)
 			]);
 		}
 		return [1, 0];
@@ -6360,13 +6457,27 @@ var SpawnSource = class {
 	* spawner's node), and return the clone.
 	*
 	* Placement: with no `at`, the clone keeps the template's authored position;
-	* with `at`, it spawns at the spawner's position plus `at` (a non-spatial
-	* spawner like a plain Node treats `at` as absolute).
+	* with `at`, it ends up at the spawner's position plus `at`.
+	*
+	* `at` is written as the clone's LOCAL position, because the clone is added
+	* as a CHILD of the spawner's node and that parent's transform already
+	* contributes the spawner's own position. This used to add the two, so the
+	* spawner's position was applied twice and the further from the origin you
+	* put the nest, the further away its enemies appeared. Measured on a spawner
+	* at [820, 240] with `"at": [0, -50]`:
+	*
+	* ```
+	* expected world       = [820, 190]
+	* clone WORLD position = [1640, 430]   error = [820, 240]
+	* ```
+	*
+	* The scene loads, the spawner spawns, the clone is alive and visible — it is
+	* just somewhere else in the level, and nothing has anything to report.
 	*/
 	spawn(template, opts) {
 		const clone = duplicateNode(template);
 		const at = opts?.at;
-		if (at && at.length > 0 && hasPosition$1(clone)) clone.position = add(hasPosition$1(this.behavior.node) ? this.behavior.node.position : [], at);
+		if (at && at.length > 0 && hasPosition$1(clone)) clone.position = add((opts?.parent ?? this.behavior.node) === this.behavior.node || !hasPosition$1(this.behavior.node) ? [] : this.behavior.node.position, at);
 		if (typeof clone.visible === "boolean") clone.visible = true;
 		(opts?.parent ?? this.behavior.node).addChild(clone);
 		return clone;
@@ -6867,4 +6978,4 @@ function registerGameplayBehaviors(opts) {
 	for (const [name, ctor] of Object.entries(GAMEPLAY_BEHAVIORS)) registerBehavior(name, ctor, { replace });
 }
 //#endregion
-export { Health as A, StaticBody3D as B, restartScene as C, DayNight as D, FloatAway as E, WaterCutout3D as F, colliderFootDrop as G, validateCollider3D as H, Area3D as I, CharacterBody3D as L, Chase as M, Water3D as N, phaseOf as O, WATER_CUTOUT_MAX as P, PhysicsBody3D as R, goToScene as S, FollowCamera as T, createCausticsQuad as U, Node3D as V, WATER_MAX_RIPPLES as W, 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, Collector as j, DamageOnContact 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, tolerateUnknownAction as w, GameFlow as x, screenFlash as y, RigidBody3D as z };
+export { Health as A, CharacterBody3D as B, restartScene as C, DayNight as D, FloatAway as E, Water3D as F, validateCollider3D as G, RigidBody3D as H, WATER_CUTOUT_MAX as I, colliderFootDrop as J, createCausticsQuad as K, WaterCutout3D as L, Chase as M, localFromWorld as N, phaseOf as O, worldPosition as P, rejectScale as R, goToScene as S, FollowCamera as T, StaticBody3D as U, PhysicsBody3D as V, Node3D as W, 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, Collector as j, DamageOnContact as k, Projectile as l, MoveTo as m, registerGameplayBehaviors as n, Spawner as o, Oscillate as p, WATER_MAX_RIPPLES as q, ZombieAI as r, ScoreKeeper as s, GAMEPLAY_BEHAVIORS as t, Pickup as u, hitStop as v, tolerateUnknownAction as w, GameFlow as x, screenFlash as y, Area3D as z };

package/dist/gameplay.js

@@ -1,2 +1,2 @@
-import { A as Health, C as restartScene, D as DayNight, E as FloatAway, M as Chase, O as phaseOf, S as goToScene, T as FollowCamera, _ 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, j as Collector, k as DamageOnContact, 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, x as GameFlow, y as screenFlash } from "./gameplay-Dtzd2itW.js";
+import { A as Health, C as restartScene, D as DayNight, E as FloatAway, M as Chase, O as phaseOf, S as goToScene, T as FollowCamera, _ 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, j as Collector, k as DamageOnContact, 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, x as GameFlow, y as screenFlash } from "./gameplay-CaHqDiQD.js";
 export { CameraShake, Chase, Collector, Cooldown, DamageOnContact, DayNight, FloatAway, 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

@@ -624,6 +624,97 @@ declare class UiDialogue extends HudWidgetBase {
   override update(dt: number): void;
 }
 //#endregion
+//#region src/core/nodes/respawn.d.ts
+/**
+* Catch whatever this node hangs off when it leaves the world, and put it back.
+*
+* Nothing in the engine did this. Not a node, not a behavior, not a scene
+* header — and the shipped examples prove what that costs: with the `plays`
+* rung finally counting defects, `basic-3d-sideview` fails 8 seeded runs out of
+* 8, `water-lake-3d` 7, `water-ocean-3d` 5, `water-pool-3d` 4,
+* `water-river-3d` 1. Every one of them the same way — the player walks off the
+* edge of the terrain and falls forever, and the only fix available was a
+* per-frame `y` check hand-written in TypeScript, which is exactly the kind of
+* thing this engine exists to keep out of TypeScript.
+*
+* A CHILD NODE rather than a Behavior, deliberately: a node holds one behavior
+* and the player's is already spoken for (`PlayerControl`, `Health`, the game's
+* own script). Children stack, the way `CharacterController3D` already hangs
+* off its body.
+*
+* ```jsonc
+* { "name": "Player", "type": "RigidBody3D", "props": { … },
+*   "children": [
+*     { "name": "Ctl", "type": "CharacterController3D" },
+*     { "name": "Catch", "type": "Respawn" }            // that is the whole thing
+*   ] }
+* ```
+*
+* With no props it guards its parent, uses the same line the playtest's fall
+* detector uses (50 m under the spawn in 3D, 1000 px in 2D), and puts the node
+* back where it started. `respawned` fires each time, so a life can be taken
+* off a `ScoreKeeper` or a `Health` with an ordinary connection — this node
+* does not decide what falling COSTS, which is a game-design question and not
+* a physics one.
+*/
+declare class Respawn extends Node {
+  static override readonly typeName: string;
+  static override readonly signals: readonly string[];
+  static readonly props: PropSchema;
+  /**
+  * Who is being caught. Defaults to the parent, which is the whole point of
+  * hanging this off the thing it guards.
+  */
+  target: string;
+  /**
+  * The line past which the target has left the world, in the scene's own
+  * down: 3D counts down (−y), 2D counts down the screen (+y).
+  *
+  * `null` is AUTO — the spawn position offset by the same distance the
+  * playtest's own fall detector uses, so "the level says it fell" and "the
+  * ladder says it fell" cannot disagree. Author a number when the level has a
+  * real floor to name; leave it alone otherwise.
+  */
+  below: number | null;
+  /** Where to put it back. Empty = wherever it started. */
+  to: number[];
+  /**
+  * Zero the body's velocity on the way back.
+  *
+  * On by default because the alternative is invisible: a body respawned with
+  * 40 m/s of accumulated fall still in it drops straight back through the
+  * line on the next frame, and the level flickers instead of resuming.
+  */
+  resetVelocity: boolean;
+  /** How many times this has caught the target — for HUDs and tests. */
+  falls: number;
+  private home;
+  private line;
+  /** +1 when "out" means y greater (2D screen-down), −1 when smaller (3D). */
+  private down;
+  override onReady(): void;
+  private spawnY;
+  /**
+  * Which way is out, and where the line is.
+  *
+  * Resolved on the first `update` rather than in `onReady`, because
+  * `onReady` runs inside `loadScene` — BEFORE `setScene` attaches the engine —
+  * so the scene's `dimension` is not readable there yet. Reading it there
+  * silently gives every 2D scene the 3D answer, and a line above a falling
+  * player fires on frame one, forever.
+  *
+  * Not called `resolve`: `Node` has a private method by that name and
+  * `getNodeOrNull` calls it, so a subclass method with the same name
+  * overrides it on the prototype — `private` is a TypeScript fiction that
+  * costs nothing at runtime — and every path lookup this node made returned a
+  * number. `node-method-shadowing.test.ts` refuses the whole family now.
+  */
+  private fallLine;
+  /** The node this guards, or itself if the path no longer resolves. */
+  private guarded;
+  override update(_dt: number): void;
+}
+//#endregion
 //#region src/core/nodes/timer.d.ts
 /**
 * The canonical serializable game clock — never `setTimeout` in game logic.
@@ -1174,4 +1265,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, type EffectEvent, type EffectKind, EffectLog, 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, UiFrameCapSelect, UiImage, UiLanguageSelect, UiMuteToggle, UiPanel, UiQualitySelect, UiRenderScaleSelect, UiSelect, UiSlider, UiText, UiToggle, UiVolumeSlider, 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, 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 };
+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, type EffectEvent, type EffectKind, EffectLog, 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, Respawn, 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, UiFrameCapSelect, UiImage, UiLanguageSelect, UiMuteToggle, UiPanel, UiQualitySelect, UiRenderScaleSelect, UiSelect, UiSlider, UiText, UiToggle, UiVolumeSlider, 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, 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/index.js

@@ -1,13 +1,13 @@
-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-D7jTvDQv.js";
-import { A as UiBar, B as ROLLOFF_MODELS, C as readDeviceHints, D as HudLayer, E as EffectLog, F as suggestLocale, G as sfxDuration, H as spatialPan, J as WebAudioMusicBackend, K as synthSfx, L as translationKey, M as BASE_LOCALE, N as Localization, P as T_PREFIX, R as SfxEngine, T as LogManager, U as SFX_PRESETS, V as spatialGain, W as SFX_PRESET_NAMES, X as fadeGain, Y as crossfadeGains, Z as AudioBuses, _ as Engine, a as UiMuteToggle, c as UiRenderScaleSelect, d as UiToggle, f as UiVolumeSlider, g as AudioPlayer, h as UiDialogue, i as UiLanguageSelect, j as UiText, k as UiBanner, l as UiSelect, m as UiButton, n as UiFrameCapSelect, o as UiPanel, p as Timer, q as MusicManager, r as UiImage, s as UiQualitySelect, t as registerCoreNodes, u as UiSlider, w as suggestQuality, x as qualityEnvironment, y as Settings, z as isAudioContextAvailable } from "./register-xuSRyD6b.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-DEe272nY.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-D3yx8D4r.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-D7-yle3s.js";
+import { n as startRecording, r as auditScene, t as replay } from "./replay-DlgHItNv.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 { 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-DozXvyZS.js";
-import { t as duplicateNode } from "./duplicate-CGqAmK2h.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, 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 };
+import { a as preloadUrls, i as preloadSceneAssets, n as newUid, o as findPath, r as assetUrls, s as gridFromRows, t as VERSION } from "./src-CH00_JsR.js";
+import { t as duplicateNode } from "./duplicate-E4FUs5Bn.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-D7jTvDQv.js → loader-DEe272nY.js}

@@ -854,6 +854,92 @@ function nodeTypeMethods(type) {
 	return out;
 }
 const methodCache = /* @__PURE__ */ new Map();
+/** Every code the engine can ever receive, keyboard + mouse + gamepad. */
+const INPUT_CODES = new Set([
+	...[..."ABCDEFGHIJKLMNOPQRSTUVWXYZ"].map((c) => `Key${c}`),
+	...Array.from({ length: 10 }, (_, i) => `Digit${i}`),
+	...Array.from({ length: 10 }, (_, i) => `Numpad${i}`),
+	"NumpadAdd",
+	"NumpadSubtract",
+	"NumpadMultiply",
+	"NumpadDivide",
+	"NumpadDecimal",
+	"NumpadEnter",
+	...Array.from({ length: 12 }, (_, i) => `F${i + 1}`),
+	"ArrowUp",
+	"ArrowDown",
+	"ArrowLeft",
+	"ArrowRight",
+	"Space",
+	"Enter",
+	"Escape",
+	"Tab",
+	"Backspace",
+	"Delete",
+	"Insert",
+	"Home",
+	"End",
+	"PageUp",
+	"PageDown",
+	"CapsLock",
+	"ShiftLeft",
+	"ShiftRight",
+	"ControlLeft",
+	"ControlRight",
+	"AltLeft",
+	"AltRight",
+	"MetaLeft",
+	"MetaRight",
+	"ContextMenu",
+	"Backquote",
+	"Minus",
+	"Equal",
+	"BracketLeft",
+	"BracketRight",
+	"Backslash",
+	"Semicolon",
+	"Quote",
+	"Comma",
+	"Period",
+	"Slash",
+	"IntlBackslash",
+	"IntlRo",
+	"IntlYen",
+	...Array.from({ length: 5 }, (_, i) => `Mouse${i}`),
+	...Array.from({ length: 17 }, (_, i) => `Pad${i}`)
+]);
+/** The one a typo probably meant, or null when nothing is close enough. */
+function nearestCode(written) {
+	const lower = written.toLowerCase();
+	if (/^[a-z]$/.test(lower)) return `Key${lower.toUpperCase()}`;
+	if (/^[0-9]$/.test(written)) return `Digit${written}`;
+	if (lower === "shift" || lower === "ctrl" || lower === "control" || lower === "alt") {
+		const side = lower === "ctrl" ? "Control" : lower[0]?.toUpperCase() + lower.slice(1);
+		return `${side}Left" or "${side}Right`;
+	}
+	if (lower === "esc") return "Escape";
+	if (lower === "return") return "Enter";
+	if (lower === "up" || lower === "down" || lower === "left" || lower === "right") return `Arrow${lower[0]?.toUpperCase()}${lower.slice(1)}`;
+	let best = null;
+	let bestScore = 3;
+	for (const code of INPUT_CODES) {
+		const d = distance$1(lower, code.toLowerCase());
+		if (d < bestScore) {
+			bestScore = d;
+			best = code;
+		}
+	}
+	return best;
+}
+function distance$1(a, b) {
+	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);
+	}
+	return rows[a.length][b.length];
+}
 //#endregion
 //#region src/core/input.ts
 /** Keys typed into editable elements belong to the page UI, not the game. */
@@ -1322,6 +1408,21 @@ const DIRECTIONS = [
 	"left",
 	"right"
 ];
+/**
+* Refuse a key code the engine can never receive.
+*
+* The map is looked up by EXACT string against what the browser hands us, so
+* `"W"`, `"space"` and `"Shift"` — the three most natural things to write — bind
+* to nothing at all. They loaded clean, passed `incanto check`, and left the
+* player without that control, with nothing anywhere to say so.
+*/
+function checkCodes(action, where, keys) {
+	for (const key of keys) {
+		if (typeof key !== "string" || INPUT_CODES.has(key)) continue;
+		const guess = nearestCode(key);
+		throw new IncantoError("BAD_FORMAT", `Input action '${action}'${where}: '${key}' is not a key code, so nothing can ever press it${guess ? ` — did you mean "${guess}"?` : ""}. Codes are KeyboardEvent.code values (KeyW, Space, ArrowLeft, ShiftLeft), plus Mouse0..4 and Pad0..16.`, { prop: "keys" });
+	}
+}
 function parseInputDecls(decls) {
 	const out = /* @__PURE__ */ new Map();
 	for (const [name, raw] of Object.entries(decls)) {
@@ -1330,6 +1431,7 @@ function parseInputDecls(decls) {
 			const keys = decl.keys;
 			if (!Array.isArray(keys) || keys.some((k) => typeof k !== "string")) throw new IncantoError("BAD_FORMAT", `Input action '${name}': button "keys" must be an array of KeyboardEvent.code strings.`);
 			if (decl.touch !== void 0 && decl.touch !== "button") throw new IncantoError("BAD_FORMAT", `Input action '${name}': button "touch" must be 'button', got ${JSON.stringify(decl.touch)}.`);
+			checkCodes(name, "", keys);
 			out.set(name, {
 				type: "button",
 				keys: [...keys],
@@ -1345,6 +1447,7 @@ function parseInputDecls(decls) {
 			}
 			if (decl.touch !== void 0 && decl.touch !== "joystick") throw new IncantoError("BAD_FORMAT", `Input action '${name}': vector2 "touch" must be 'joystick', got ${JSON.stringify(decl.touch)}.`);
 			const d = dirs;
+			for (const dir of DIRECTIONS) checkCodes(name, ` (${dir})`, d[dir]);
 			out.set(name, {
 				type: "vector2",
 				keys: {

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-5Ban4q4n.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-CBM9wcMX.js";
 export { LocalGameServer, LocalGameServerTransport, LoopbackHub, LoopbackTransport, NetworkManager, NetworkSpawner, applySyncPatch, createAgent8Server, createLocalGameServer, createSplitScreen, registerNodesNet };

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

@@ -1,7 +1,7 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { k as diagnose } from "./loader-D7jTvDQv.js";
+import { k as diagnose } from "./loader-DEe272nY.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-DL3izw8j.js";
+import { _ as RigidBody2D, b as validateCollider2D, g as PhysicsBody2D, h as CharacterBody2D, m as Area2D, p as Joint2D, y as Node2D } from "./register-CNh4FlbD.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
@@ -100,7 +100,10 @@ var Physics2D = class {
 				node.position = [t.x * SCALE - ox, t.y * SCALE - oy];
 			}
 			if (node instanceof RigidBody2D) {
-				if (!node.fixedRotation) node.rotation = e.body.rotation() / DEG;
+				if (!node.fixedRotation) {
+					node.rotation = e.body.rotation() / DEG;
+					e.lastRot = node.rotation;
+				}
 				const lv = e.body.linvel();
 				node.linearVelocity = [lv.x * SCALE, lv.y * SCALE];
 				e.lastVX = node.linearVelocity[0] ?? 0;
@@ -428,6 +431,7 @@ var Physics2D = class {
 				collider,
 				lastX: wx,
 				lastY: wy,
+				lastRot: node.rotation,
 				lastVX: 0,
 				lastVY: 0
 			};
@@ -456,6 +460,10 @@ var Physics2D = class {
 			e.lastX = px;
 			e.lastY = py;
 		}
+		if (node.rotation !== e.lastRot) {
+			e.body.setRotation(node.rotation * DEG, true);
+			e.lastRot = node.rotation;
+		}
 		if (node instanceof RigidBody2D) {
 			const vx = node.linearVelocity[0] ?? 0;
 			const vy = node.linearVelocity[1] ?? 0;