incanto 0.60.0 → 0.62.0

package/dist/editor.js

@@ -1111,6 +1111,13 @@ var kt = {
 				en: "Set waitTime (seconds), optionally autostart or oneShot, and connect its timeout signal to any handler. Because it is a node, the whole timing setup lives in the scene file — agents can read and tune it.",
 				ko: "waitTime(초)을 정하고 autostart·oneShot을 선택한 뒤 timeout 시그널을 핸들러에 연결하세요. 노드이기 때문에 타이밍 설정 전체가 씬 파일에 남아 에이전트가 읽고 조정할 수 있습니다."
 			}),
+			L("Respawn", {
+				en: "Catches whatever it hangs off when it leaves the world, and puts it back.",
+				ko: "부모가 월드 밖으로 떨어지면 붙잡아 원래 자리로 되돌립니다."
+			}, {
+				en: "Make it a child of the player. With no props it catches its parent 50 m under the spawn (1000 px in 2D — the same line incanto-playtest calls \"fell\"), returns it to where it started and zeroes the velocity the fall built up. below names the line, to names the landing, target picks a different node. It emits respawned, and deliberately does not decide what falling COSTS — wire that to a ScoreKeeper or a Health if it should hurt.",
+				ko: "플레이어의 자식으로 두세요. 프롭 없이도 스폰 50 m 아래(2D는 1000 px — incanto-playtest가 \"fell\"로 부르는 그 선)에서 부모를 붙잡아 처음 위치로 되돌리고, 낙하로 쌓인 속도를 0으로 만듭니다. below는 그 선, to는 착지 지점, target은 다른 노드를 지정합니다. respawned 시그널을 쏘며, 추락의 \"대가\"는 일부러 정하지 않습니다 — 피해를 주려면 ScoreKeeper나 Health에 연결하세요."
+			}),
 			L("HudLayer", {
 				en: "Screen-space HUD overlay above the canvas — parent for UiText/UiBar/UiBanner.",
 				ko: "캔버스 위 화면 고정 HUD 오버레이 — UiText/UiBar/UiBanner의 부모."
@@ -2372,7 +2379,8 @@ function Bn(e, t, n) {
 var Vn = [
 	"connections",
 	"input",
-	"multiplayer"
+	"multiplayer",
+	"strings"
 ];
 function Hn(e, t, n) {
 	e.appendChild(Tr("scene")), e.appendChild(Ar("name", String(t.working.name ?? ""), (e) => {
@@ -9291,8 +9299,15 @@ function yc(e) {
 	let t = e.assets;
 	if (t) for (let e of Object.values(t)) typeof e?.url == "string" && !e.url.includes("/") && !e.url.includes(".") && (e.url = vc());
 }
+//#endregion
+//#region src/main.ts
+var bc = new Set([
+	"Terrain3D",
+	"Water3D",
+	"River3D"
+]);
 m(), b(), k(), ee(), A();
-async function bc(e = {}) {
+async function xc(e = {}) {
 	let t = e.api ?? ze, n = [], r = document.createElement("style");
 	r.dataset.incantoEditor = "true", r.textContent = vs, document.head.appendChild(r), n.push(() => r.remove());
 	let i = document.createElement("div");
@@ -9389,11 +9404,18 @@ async function bc(e = {}) {
 			0,
 			0
 		]),
-		onNodeScaled3D: (e, t) => de(e, "scale", t, [
-			1,
-			1,
-			1
-		]),
+		onNodeScaled3D: (e, t) => {
+			let n = u.nodeAt(e);
+			if (n && bc.has(String(n.type))) {
+				O(`${n.type} '${n.name}' cannot be scaled — scale would move only the mesh. Resize it with its "size" prop in the inspector.`);
+				return;
+			}
+			de(e, "scale", t, [
+				1,
+				1,
+				1
+			]);
+		},
 		onNodeRotated2D: (e, t) => ue(e, "rotation", t, 0),
 		onNodeRotated3D: (e, t) => de(e, "rotation", t, [
 			0,
@@ -9479,15 +9501,15 @@ async function bc(e = {}) {
 		...e.shelf ? { shelf: e.shelf } : {},
 		...e.assetType ? { assetType: e.assetType } : {},
 		...e.onProps ? { onProps: e.onProps } : {},
-		...e.asAsset ? { onAsset: (e, t, n) => wc(u, n, t) } : {}
+		...e.asAsset ? { onAsset: (e, t, n) => Tc(u, n, t) } : {}
 	}) : void 0, le = !1, F = () => {
 		if (!E) return;
 		js(d, u), rt(a("#asset-tree"), u), f.textContent = "", it(f, u, Ce, ce) || Bn(f, u, {
-			modelRefs: () => Sc(u, "model"),
+			modelRefs: () => Cc(u, "model"),
 			animationsForSelection: () => u.selection ? P.modelAnimationsAt(u.selection) : [],
 			bonesForSelection: (e) => u.selection ? P.boneNamesAt(u.selection, e) : [],
-			assetRefs: (e) => Cc(u, e),
-			addAsset: (e, t) => wc(u, e, t),
+			assetRefs: (e) => wc(u, e),
+			addAsset: (e, t) => Tc(u, e, t),
 			...ce ? { openLibrary: ce } : {},
 			confirm: Ce,
 			paint: {
@@ -9599,7 +9621,7 @@ async function bc(e = {}) {
 		if (e.length === 0) {
 			let e = u.working.root;
 			if (!e) return;
-			let t = xc(e);
+			let t = Sc(e);
 			Ce(`This deletes the ROOT '${String(e.name ?? "")}'${t > 0 ? ` AND its ${t} descendant node${t === 1 ? "" : "s"}` : ""} — the scene goes empty, and the next node you add becomes the new root.`, "delete root", () => u.deleteRoot());
 			return;
 		}
@@ -9607,7 +9629,7 @@ async function bc(e = {}) {
 		if (n.length === 0) {
 			let n = e.reduce((e, t) => {
 				let n = u.nodeAt(t);
-				return e + (n ? xc(n) : 0);
+				return e + (n ? Sc(n) : 0);
 			}, 0);
 			if (n > 0) {
 				Ce(`This deletes ${e.length > 1 ? `${e.length} nodes` : `'${String(u.nodeAt(e[0] ?? [])?.name ?? "")}'`} AND ${n} descendant node${n === 1 ? "" : "s"}.`, `delete ${e.length + n} nodes`, () => {
@@ -9783,20 +9805,20 @@ async function bc(e = {}) {
 		}
 	};
 }
-function xc(e) {
+function Sc(e) {
 	let t = 0;
-	for (let n of e.children ?? []) t += 1 + xc(n);
+	for (let n of e.children ?? []) t += 1 + Sc(n);
 	return t;
 }
-function Sc(e, t) {
+function Cc(e, t) {
 	let n = e.working.assets;
 	return n ? Object.entries(n).filter(([, e]) => e?.type === t).map(([e]) => `$${e}`) : [];
 }
-function Cc(e, t) {
+function wc(e, t) {
 	let n = e.working.assets;
 	return n ? Object.entries(n).filter(([, e]) => !t || e?.type !== void 0 && t.includes(e.type)).map(([e]) => `$${e}`) : [];
 }
-function wc(e, t, n) {
+function Tc(e, t, n) {
 	let r = e.working.assets ?? {};
 	for (let [e, t] of Object.entries(r)) if (t?.url === n.url) return `$${e}`;
 	let i = t;
@@ -9806,4 +9828,4 @@ function wc(e, t, n) {
 	}), `$${i}`;
 }
 //#endregion
-export { N as formatSceneJson, ze as httpEditorApi, bc as mountEditor };
+export { N as formatSceneJson, ze as httpEditorApi, xc as mountEditor };

package/dist/{environment-presets-8cjF3t6w.js → environment-presets-BAWeOeqf.js}

@@ -1,11 +1,11 @@
-import { w as diagnose } from "./loader-D8n7TU8W.js";
-import { I as translateOn, t as registerCoreNodes } from "./register-Da3hXh2H.js";
+import { k as diagnose } from "./loader-DEe272nY.js";
+import { L as translateOn, t as registerCoreNodes } from "./register-D3yx8D4r.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as Rng } from "./rng-DP-SR7eg.js";
-import { i as getNodeSchema, l as registerNode } from "./registry-WWcQcfMr.js";
+import { i as getNodeSchema, l as registerNode } from "./registry-CF70EArN.js";
 import { 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-CY-mrr1L.js";
-import { B as StaticBody3D, F as WaterCutout3D, G as colliderFootDrop, I as Area3D, L as CharacterBody3D, N as Water3D, R as PhysicsBody3D, V as Node3D, w as tolerateUnknownAction, z as RigidBody3D } from "./gameplay-BBEjPFsR.js";
+import { B as CharacterBody3D, F as Water3D, H as RigidBody3D, J as colliderFootDrop, L as WaterCutout3D, R as rejectScale, U as StaticBody3D, V as PhysicsBody3D, W as Node3D, w as tolerateUnknownAction, z as Area3D } from "./gameplay-CaHqDiQD.js";
 import { t as checkSheetGrid } from "./sheet-grid-BT6N_Bjs.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";
@@ -727,7 +727,8 @@ var Joint3D = class extends Node3D {
 		},
 		target: {
 			default: "",
-			nodePath: true
+			nodePath: true,
+			required: true
 		},
 		anchor: { default: [
 			0,
@@ -1574,6 +1575,7 @@ var Terrain3D = class extends Node3D {
 	}
 	/** Loader hook: bad themes/layers/grids fail at LOAD, not at render. */
 	static validateJson(node) {
+		rejectScale(node, "heightAt(), the heightfield collider, drape and terrain-nav all");
 		const t = node;
 		if (!TERRAIN_THEMES.includes(t.theme)) throw new IncantoError("BAD_FORMAT", `Terrain3D '${node.name}' theme must be one of [${TERRAIN_THEMES.join(", ")}], got '${t.theme}'.`, {
 			prop: "theme",
@@ -2335,7 +2337,8 @@ var BoneAttachment3D = class extends Node3D {
 		/** Node path to the ModelInstance3D whose skeleton to ride. */
 		target: {
 			default: "",
-			nodePath: true
+			nodePath: true,
+			required: true
 		},
 		/** Bone name ("RightHand", "Head", …). Empty = inert. */
 		bone: { default: "" }
@@ -2428,7 +2431,8 @@ var BoneLookAt3D = class extends Node3D {
 		/** Node path to the ModelInstance3D whose bone to steer. */
 		target: {
 			default: "",
-			nodePath: true
+			nodePath: true,
+			required: true
 		},
 		/** Bone name ("Head", "Neck", "Spine2" — Mixamo spellings matched). */
 		bone: { default: "Head" },
@@ -2440,7 +2444,13 @@ var BoneLookAt3D = class extends Node3D {
 		/** Comfort cone half-angle, degrees — beyond it the head returns to the anim. */
 		maxAngleDeg: { default: 75 },
 		/** Blend weight 0..1 (how far toward the target the bone turns). */
-		weight: { default: .85 },
+		weight: {
+			default: .85,
+			range: {
+				min: 0,
+				max: 1
+			}
+		},
 		/** The bone's local facing axis. */
 		forwardAxis: {
 			default: "+z",
@@ -6449,9 +6459,21 @@ var ModelInstance3D = class extends Node3D {
 	static signals = ["animationFinished"];
 	static props = {
 		...Node3D.props,
-		model: { default: "" },
-		animation: { default: "" },
-		targetHeight: { default: 0 },
+		model: {
+			default: "",
+			asset: {
+				kind: "model",
+				refOnly: true
+			}
+		},
+		animation: {
+			default: "",
+			asset: { kind: "animation" }
+		},
+		targetHeight: {
+			default: 0,
+			range: { min: 0 }
+		},
 		castShadow: { default: false },
 		animationLoop: { default: true },
 		/** Playback rate: 1 = authored speed, 0.5 = half, 2 = double. */
@@ -6466,8 +6488,22 @@ var ModelInstance3D = class extends Node3D {
 		upperBodyRoot: { default: "Spine" },
 		receiveShadow: { default: false },
 		tint: { default: "" },
-		metalness: { default: -1 },
-		roughness: { default: -1 }
+		metalness: {
+			default: -1,
+			range: {
+				min: 0,
+				max: 1,
+				allow: [-1]
+			}
+		},
+		roughness: {
+			default: -1,
+			range: {
+				min: 0,
+				max: 1,
+				allow: [-1]
+			}
+		}
 	};
 	model = "";
 	animation = "";
@@ -8770,6 +8806,7 @@ var River3D = class River3D extends Node3D {
 	_bodies = [];
 	/** Loader hook: a malformed river fails at LOAD, not as an invisible ribbon. */
 	static validateJson(node) {
+		rejectScale(node, "the flow query and its collider both");
 		const r = node;
 		if (!Array.isArray(r.path)) throw new IncantoError("BAD_FORMAT", `River3D '${node.name}' path must be an array of [x, z] points, got ${JSON.stringify(r.path)}.`, { prop: "path" });
 		if (r.path.length > 0 && r.path.length < 2) throw new IncantoError("BAD_FORMAT", `River3D '${node.name}' path needs at least 2 points (source → mouth), got ${r.path.length}.`, { prop: "path" });

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

@@ -1,7 +1,7 @@
-import { C as Node, E as Behavior, b as effectiveOrder, j as registerBehavior, n as loadScene, p as SaveSlots, w as diagnose } from "./loader-D8n7TU8W.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-DJQd44CD.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
 /**
@@ -4975,6 +5071,7 @@ var FloatAway = class extends Behavior {
 	onReady() {
 		const node = this.node;
 		this.start = [...node.position ?? []];
+		if (node.opacity === void 0) diagnose(this.node.tree?.engine, "warn", `[incanto] FloatAway on '${this.node.getPath()}' will not fade — ${this.node.constructor.name} has no "opacity" prop, so it pops out at full brightness instead. Use a node that has one (Label, Label3D, Sprite2D, Sprite3D).`);
 	}
 	update(dt) {
 		if (this.done) return;
@@ -5024,9 +5121,18 @@ var FollowCamera = class extends Behavior {
 		/** Constant offset added to the target's position ([x,y] or [x,y,z]). */
 		offset: { default: [] },
 		/** 0..1 retention factor: 0 = snap, higher = smoother chase. */
-		smoothing: { default: 0 },
+		smoothing: {
+			default: 0,
+			range: {
+				min: 0,
+				max: 1
+			}
+		},
 		/** Don't move until the target is at least this far from the desired point. */
-		deadzone: { default: 0 }
+		deadzone: {
+			default: 0,
+			range: { min: 0 }
+		}
 	};
 	static signals = [];
 	target = "";
@@ -5052,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;
@@ -5109,7 +5216,6 @@ function tolerateUnknownAction(ctx, action, read, fallback) {
 function restartScene(engine) {
 	const source = engine.scene?.source;
 	if (!source) return;
-	engine.timeScale = 1;
 	engine.setScene(loadScene(jsonClone(source)));
 }
 /**
@@ -5119,7 +5225,6 @@ function restartScene(engine) {
 function goToScene(engine, sceneJson, opts) {
 	const fade = opts?.fadeSeconds ?? .4;
 	const swap = () => {
-		engine.timeScale = 1;
 		engine.setScene(loadScene(jsonClone(sceneJson)));
 	};
 	if (typeof document === "undefined" || fade <= 0) {
@@ -5500,13 +5605,14 @@ function screenFlash(engine, color = "#ffffff", opacity = .35, seconds = .25) {
 */
 function hitStop(engine, seconds = .08) {
 	recordEffect(engine, "hitstop", "", "engine", seconds);
-	const state = hitStops.get(engine);
+	const state = liveHitStop(engine);
 	if (state) {
 		state.until = Math.max(state.until, engine.unscaledTime + seconds);
 		return;
 	}
 	const restore = engine.timeScale;
 	const entry = {
+		startedAt: engine.unscaledTime,
 		until: engine.unscaledTime + seconds,
 		restore,
 		release: () => {}
@@ -5514,12 +5620,35 @@ function hitStop(engine, seconds = .08) {
 	hitStops.set(engine, entry);
 	engine.timeScale = 0;
 	entry.release = engine.updated.connect(() => {
+		if (!liveHitStop(engine)) return;
 		if (engine.unscaledTime < entry.until) return;
 		engine.timeScale = entry.restore;
 		entry.release();
 		hitStops.delete(engine);
 	});
 }
+/**
+* The engine's pending freeze, if the clock it was measured against still runs.
+*
+* `setScene` resets `unscaledTime` to 0, and a freeze deadline is an ABSOLUTE
+* reading of that clock — so a hit-stop taken on the killing blow, two minutes
+* into a level, survived the restart as a deadline two minutes in the future.
+* Measured: `hitStop(engine, 0.08)`, then the restart, then five real seconds
+* of ticks — 2.08 of them frozen, and a level that long freezes that long. The
+* quieter half is the next scene's OWN hit-stop: it found the stale entry,
+* extended a deadline nobody was waiting on, and never froze anything.
+*
+* A clock that reads earlier than the freeze began cannot be the clock the
+* freeze was scheduled on. `setScene` already put `timeScale` back to 1, so
+* there is nothing to restore — just let go.
+*/
+function liveHitStop(engine) {
+	const entry = hitStops.get(engine);
+	if (!entry) return void 0;
+	if (engine.unscaledTime >= entry.startedAt) return entry;
+	entry.release();
+	hitStops.delete(engine);
+}
 const hitStops = /* @__PURE__ */ new Map();
 //#endregion
 //#region src/gameplay/lifetime.ts
@@ -5605,7 +5734,10 @@ function ease(curve, t) {
 var MoveTo = class extends Behavior {
 	static props = {
 		/** Destination position ([x,y] or [x,y,z]). */
-		to: { default: [] },
+		to: {
+			default: [],
+			required: true
+		},
 		/** Seconds the move takes. */
 		duration: { default: 1 },
 		/** Easing curve. */
@@ -5819,7 +5951,10 @@ function distanceBetween(a, b) {
 var Patrol = class extends Behavior {
 	static props = {
 		/** Waypoints: array of position arrays OR node-path strings to read. */
-		points: { default: [] },
+		points: {
+			default: [],
+			required: true
+		},
 		/** Units per second along the path. */
 		speed: { default: 60 },
 		/** Wrap to the first point after the last (ignored in pingpong). */
@@ -6031,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];
@@ -6322,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;
@@ -6355,7 +6504,8 @@ var Spawner = class extends Behavior {
 		/** Node path of the template to clone. */
 		prefab: {
 			default: "",
-			nodePath: true
+			nodePath: true,
+			required: true
 		},
 		/** Seconds between spawns. */
 		interval: { default: 1 },
@@ -6508,7 +6658,10 @@ var Wander = class extends Behavior {
 var WaveSpawner = class extends Behavior {
 	static props = {
 		/** Array of { prefab, count, interval, delayBefore }. */
-		waves: { default: [] },
+		waves: {
+			default: [],
+			required: true
+		},
 		/** Begin the first wave's countdown at ready. */
 		autoStart: { default: true }
 	};
@@ -6825,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.d.ts

@@ -1,4 +1,4 @@
-import { At as Node, b as Engine, d as PropSchema, n as BehaviorCtor, t as Behavior } from "./behavior-DWKTUzKI.js";
+import { b as Engine, d as PropSchema, jt as Node, n as BehaviorCtor, t as Behavior } from "./behavior-DsgayMsH.js";
 import { c as JsonValue, s as JsonObject } from "./schema-CFeioQRE.js";
 
 //#region src/gameplay/chase.d.ts

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-BBEjPFsR.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 };