incanto 0.72.0 → 0.74.0

package/dist/{physics-3d-BzOCw1VS.js → physics-3d-rOzeg890.js}

@@ -1,10 +1,10 @@
 import { o as __exportAll } from "./json-CfTjpvW8.js";
-import { Y as diagnose } from "./save-slots-CEuJPUle.js";
+import { Y as diagnose } from "./save-slots-CEUGeLuB.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
-import { H as CharacterBody3D, K as Node3D, U as PhysicsBody3D, V as Area3D, W as RigidBody3D, q as validateCollider3D } from "./gameplay-BlQe-M07.js";
+import { G as PhysicsBody3D, J as Node3D, K as RigidBody3D, U as Area3D, W as CharacterBody3D, Y as validateCollider3D, q as StaticBody3D } from "./gameplay-Bxe1sMVT.js";
 import { n as registerDebugSource } from "./debug-draw-BM3DsvtT.js";
 import { n as jointContacts, t as withoutRapierInitNoise } from "./quiet-rapier-C6fW4zcW.js";
-import { A as Terrain3D, F as InstancedMesh3D, L as buildMeshGeometry, P as Joint3D } from "./environment-presets-BeHoaGhy.js";
+import { F as Joint3D, I as InstancedMesh3D, R as buildMeshGeometry, j as Terrain3D } from "./environment-presets-BkqlWewf.js";
 import { Euler, Matrix4, Quaternion, Vector3 } from "three";
 //#region src/3d/physics/collider-lines.ts
 /**
@@ -348,6 +348,7 @@ var Physics3D = class {
 			const b = this.byColliderHandle.get(h2);
 			if (!a || !b) return;
 			const sig = started ? "triggerEnter" : "triggerExit";
+			if (started === (this.overlaps.get(a)?.has(b) ?? false)) return;
 			this.trackOverlap(a, b, started);
 			this.trackOverlap(b, a, started);
 			try {
@@ -424,7 +425,8 @@ var Physics3D = class {
 			y: vy * this.lastDt + carryY,
 			z: (node.velocity[2] ?? 0) * this.lastDt + carryZ
 		};
-		this.kcc.computeColliderMovement(e.collider, desired, this.R.QueryFilterFlags.EXCLUDE_SENSORS);
+		const others = node.collideWithCharacters ? void 0 : (c) => !(this.byColliderHandle.get(c.handle) instanceof CharacterBody3D);
+		this.kcc.computeColliderMovement(e.collider, desired, this.R.QueryFilterFlags.EXCLUDE_SENSORS, void 0, others);
 		const c = this.kcc.computedMovement();
 		const t = e.body.translation();
 		const nx = t.x + c.x;
@@ -528,7 +530,12 @@ var Physics3D = class {
 	* off ONE fixed body — they never move, so there is nothing to step — and the
 	* whole set is rebuilt only when the tree's shape changes.
 	*/
-	/** Where each live scatter field was when its colliders were built. */
+	/**
+	* Where each live scatter field was when its colliders were built — and what
+	* they were built FROM. Rows and place were remembered from the start; the
+	* stone itself (`mesh`, `size`, the `collider` spec) was not, so a field
+	* grown at runtime, or resized in the inspector, collided as the old stones.
+	*/
 	scatterState = /* @__PURE__ */ new Map();
 	/**
 	* Has any scatter field moved, or had its rows replaced, since the build?
@@ -543,6 +550,9 @@ var Physics3D = class {
 			const [x, y, z] = worldPosition3D(field);
 			if (!was) return true;
 			if (was.rows !== field.transforms || was.x !== x || was.y !== y || was.z !== z) return true;
+			const [sx, sy, sz] = field.size;
+			if (was.mesh !== field.mesh || was.sx !== sx || was.sy !== sy || was.sz !== sz) return true;
+			if (was.spec !== field.collider) return true;
 		}
 		return false;
 	}
@@ -595,7 +605,12 @@ var Physics3D = class {
 				rows: field.transforms,
 				x: ox,
 				y: oy,
-				z: oz
+				z: oz,
+				mesh: field.mesh,
+				sx,
+				sy,
+				sz,
+				spec: field.collider
 			});
 		}
 	}
@@ -650,7 +665,7 @@ var Physics3D = class {
 				continue;
 			}
 			const existing = this.entries.get(node);
-			if (existing && node._colliderChanged) {
+			if (existing && (node._colliderChanged || this.heightfieldReshaped(node, existing) || this.autoReshaped(node, existing))) {
 				this.byColliderHandle.delete(existing.collider.handle);
 				this.world.removeRigidBody(existing.body);
 				this.entries.delete(node);
@@ -672,6 +687,84 @@ var Physics3D = class {
 		}
 	}
 	/**
+	* The stamp an auto body is compared against, reused across every body and
+	* step: the walk writes here instead of returning an object, because it runs
+	* once per auto body per step and a village of crates must not allocate.
+	*/
+	stamp = {
+		kind: "",
+		model: null,
+		nums: new Float64Array(12)
+	};
+	/** An auto body whose carried mesh (or mounted model) is not what it was built from. */
+	autoReshaped(node, e) {
+		const was = e.autoShape;
+		if (!was || node.collider.shape !== "auto") return false;
+		this.stampAutoShape(node);
+		const now = this.stamp;
+		if (now.kind !== was.kind) return true;
+		if ((now.model?._mountedObject3D() ?? null) !== was.mounted) return true;
+		for (let i = 0; i < 12; i++) if (now.nums[i] !== was.nums[i]) return true;
+		return false;
+	}
+	rememberAutoShape(node) {
+		this.stampAutoShape(node);
+		return {
+			kind: this.stamp.kind,
+			nums: Float64Array.from(this.stamp.nums),
+			mounted: this.stamp.model?._mountedObject3D() ?? null
+		};
+	}
+	/**
+	* The same choice `meshesUnder` makes — the FIRST carried mesh in tree
+	* order, else the first mounted model — reduced to the numbers the collider
+	* was built from, so a change in any of them is visible without a rebuild.
+	*/
+	stampAutoShape(node) {
+		this.stamp.kind = "";
+		this.stamp.model = null;
+		this.stamp.nums.fill(0);
+		this.walkAutoShape(node, 0, 0, 0, 0, 0, 0, 1, 1, 1);
+	}
+	walkAutoShape(node, ax, ay, az, rx, ry, rz, sx, sy, sz) {
+		const stamp = this.stamp;
+		if (isMountedModel(node)) {
+			if (!stamp.model) stamp.model = node;
+		} else if (stamp.kind === "") {
+			const self = node;
+			if (typeof self.mesh === "string" && Array.isArray(self.size)) {
+				const size = self.size;
+				stamp.kind = self.mesh;
+				const n = stamp.nums;
+				n[0] = size[0] ?? 0;
+				n[1] = size[1] ?? 0;
+				n[2] = size[2] ?? 0;
+				n[3] = ax;
+				n[4] = ay;
+				n[5] = az;
+				n[6] = rx;
+				n[7] = ry;
+				n[8] = rz;
+				n[9] = sx;
+				n[10] = sy;
+				n[11] = sz;
+			}
+		}
+		for (const child of node.children) {
+			const t = child;
+			const p = Array.isArray(t.position) ? t.position : void 0;
+			const r = Array.isArray(t.rotation) ? t.rotation : void 0;
+			const c = Array.isArray(t.scale) ? t.scale : void 0;
+			this.walkAutoShape(child, ax + (p?.[0] ?? 0) * sx, ay + (p?.[1] ?? 0) * sy, az + (p?.[2] ?? 0) * sz, rx + (r?.[0] ?? 0), ry + (r?.[1] ?? 0), rz + (r?.[2] ?? 0), sx * (c?.[0] ?? 1), sy * (c?.[1] ?? 1), sz * (c?.[2] ?? 1));
+		}
+	}
+	/** A heightfield body whose Terrain3D regenerated its grid since the build. */
+	heightfieldReshaped(node, e) {
+		if (node.collider.shape !== "heightfield") return false;
+		const terrain = heightfieldSource(node);
+		return terrain !== void 0 && terrain._heightmap() !== e.heightmap;
+	}
+	/**
 	* Null while a `{"shape":"auto"}` body is waiting on its model — the shape
 	* lives in the model's triangles, and there is nothing honest to guess in the
 	* meantime. syncBodies runs every step, so the body appears the moment the
@@ -698,6 +791,7 @@ var Physics3D = class {
 			});
 			if (node instanceof RigidBody3D) {
 				desc.setGravityScale(node.gravityScale);
+				desc.setLinearDamping(node.linearDamping).setAngularDamping(node.angularDamping);
 				desc.setLinvel(node.linearVelocity[0] ?? 0, node.linearVelocity[1] ?? 0, node.linearVelocity[2] ?? 0);
 				const locked = node.fixedRotation;
 				desc.setAngvel({
@@ -711,7 +805,8 @@ var Physics3D = class {
 			colDesc.setActiveEvents(R.ActiveEvents.COLLISION_EVENTS);
 			colDesc.setActiveCollisionTypes(R.ActiveCollisionTypes.ALL);
 			if (node instanceof Area3D) colDesc.setSensor(true);
-			if (node instanceof RigidBody3D) colDesc.setMass(node.mass).setFriction(node.friction).setRestitution(node.restitution);
+			if (node instanceof RigidBody3D) colDesc.setMass(node.mass);
+			if (node instanceof RigidBody3D || node instanceof StaticBody3D) applySurface(R, colDesc, node);
 			const collider = this.world.createCollider(colDesc, body);
 			e = {
 				body,
@@ -732,9 +827,13 @@ var Physics3D = class {
 					0
 				],
 				lastMass: node instanceof RigidBody3D ? node.mass : 1,
-				lastFriction: node instanceof RigidBody3D ? node.friction : .5,
-				lastRestitution: node instanceof RigidBody3D ? node.restitution : 0
+				lastFriction: node.friction ?? .5,
+				lastRestitution: node.restitution ?? 0,
+				lastLinDamp: node instanceof RigidBody3D ? node.linearDamping : 0,
+				lastAngDamp: node instanceof RigidBody3D ? node.angularDamping : 0
 			};
+			if (node.collider.shape === "heightfield") e.heightmap = heightfieldSource(node)?._heightmap();
+			if (node.collider.shape === "auto") e.autoShape = this.rememberAutoShape(node);
 			this.entries.set(node, e);
 			this.byColliderHandle.set(collider.handle, node);
 			if (!node.enabled) {
@@ -748,9 +847,11 @@ var Physics3D = class {
 			return e;
 		}
 		if (node._enabledChanged) {
+			if (!node.enabled) this.releaseOverlaps(node);
 			e.collider.setEnabled(node.enabled);
 			e.body.setEnabled(node.enabled);
 			node._enabledChanged = false;
+			if (node.enabled) this.armOverlaps(node, e.collider);
 		}
 		const p = worldPosition3D(node);
 		if (p[0] !== e.last[0] || p[1] !== e.last[1] || p[2] !== e.last[2]) {
@@ -798,12 +899,23 @@ var Physics3D = class {
 				e.collider.setMass(node.mass);
 				e.lastMass = node.mass;
 			}
-			if (node.friction !== e.lastFriction) {
-				e.collider.setFriction(node.friction);
+			if (node.friction !== e.lastFriction || node.restitution !== e.lastRestitution) {
+				applySurface(this.R, e.collider, node);
 				e.lastFriction = node.friction;
+				e.lastRestitution = node.restitution;
+			}
+			if (node.linearDamping !== e.lastLinDamp) {
+				e.body.setLinearDamping(node.linearDamping);
+				e.lastLinDamp = node.linearDamping;
 			}
-			if (node.restitution !== e.lastRestitution) {
-				e.collider.setRestitution(node.restitution);
+			if (node.angularDamping !== e.lastAngDamp) {
+				e.body.setAngularDamping(node.angularDamping);
+				e.lastAngDamp = node.angularDamping;
+			}
+		} else if (node instanceof StaticBody3D) {
+			if (node.friction !== e.lastFriction || node.restitution !== e.lastRestitution) {
+				applySurface(this.R, e.collider, node);
+				e.lastFriction = node.friction;
 				e.lastRestitution = node.restitution;
 			}
 		}
@@ -911,6 +1023,52 @@ var Physics3D = class {
 			if (others.size === 0) this.overlaps.delete(self);
 		}
 	}
+	/** Every overlap `node` is in ends now — the exits Rapier does not send for a disabled collider. */
+	releaseOverlaps(node) {
+		const set = this.overlaps.get(node);
+		if (!set || set.size === 0) return;
+		for (const other of [...set]) {
+			this.trackOverlap(node, other, false);
+			this.trackOverlap(other, node, false);
+			try {
+				node.emit("triggerExit", other);
+				other.emit("triggerExit", node);
+			} catch (error) {
+				diagnose(this.engine, "error", `incanto: error in a 'triggerExit' handler (${node.name} ↔ ${other.name}):`, error);
+			}
+		}
+	}
+	/** Every body the armed sensor is inside of RIGHT NOW enters it — the starts Rapier does not send for a re-enabled collider. */
+	armOverlaps(node, collider) {
+		const found = [];
+		const t = collider.translation();
+		const r = collider.rotation();
+		this.world.intersectionsWithShape({
+			x: t.x,
+			y: t.y,
+			z: t.z
+		}, {
+			x: r.x,
+			y: r.y,
+			z: r.z,
+			w: r.w
+		}, collider.shape, (hit) => {
+			const other = this.byColliderHandle.get(hit.handle);
+			if (other && other !== node && hit.isEnabled()) found.push(other);
+			return true;
+		}, void 0, void 0, collider);
+		for (const other of found) {
+			if (this.overlaps.get(node)?.has(other)) continue;
+			this.trackOverlap(node, other, true);
+			this.trackOverlap(other, node, true);
+			try {
+				node.emit("triggerEnter", other);
+				other.emit("triggerEnter", node);
+			} catch (error) {
+				diagnose(this.engine, "error", `incanto: error in a 'triggerEnter' handler (${node.name} ↔ ${other.name}):`, error);
+			}
+		}
+	}
 	pruneOverlaps() {
 		for (const [self, others] of this.overlaps) {
 			if (self.tree === null) {
@@ -1273,8 +1431,12 @@ function parseCollider3D(R, node) {
 * body — no duplicated data in the collider prop, terrain and collider can
 * never drift apart.
 */
+/** The Terrain3D child a heightfield body reads its grid from. */
+function heightfieldSource(node) {
+	return node.children.find((c) => c instanceof Terrain3D);
+}
 function buildHeightfieldDesc3D(R, node) {
-	const terrain = node.children.find((c) => c instanceof Terrain3D);
+	const terrain = heightfieldSource(node);
 	if (!terrain) throw new IncantoError("BAD_FORMAT", `Collider on '${node.name}': heightfield needs a Terrain3D CHILD of this body — add { "type": "Terrain3D" } under the StaticBody3D; the collider reads its height grid.`, { prop: "collider" });
 	const hm = terrain._heightmap();
 	const nrows = hm.segsZ;
@@ -1348,5 +1510,30 @@ function buildColliderDesc3D(R, collider, nodeName, node) {
 	}
 	throw new IncantoError("BAD_FORMAT", `Collider on '${nodeName}': "shape" must be 'auto', 'box', 'sphere', 'capsule', 'trimesh', or 'heightfield', got ${JSON.stringify(shape)}.`);
 }
+/**
+* A static body's authored surface, and the rule that makes it WIN the pair.
+*
+* Rapier combines two colliders' coefficients by the higher-priority rule of
+* the two (Max > Multiply > Min > Average) and defaults to Average, which is
+* why a 0.75 ball on a fixed-0 floor kept 37% of its speed. The surface an
+* author writes on a floor is an intent about whatever touches it: a
+* trampoline launches a dead ball (Max), an ice patch slides a grippy crate
+* (Min), glue stops a slick one (Max). At the defaults nothing is set, so a
+* scene that says nothing pairs exactly as it always did.
+*
+* The same rule on the MOVING body, because the character skill had said for
+* a year "set `friction: 0` on the body" and nothing honoured it: a
+* RigidBody's 0 met the floor's unwritten 0.5 under Average and became 0.25,
+* and every 3D character walked at 3.7 where the skill promised 4.0. An
+* authored value wins the pair whichever side wrote it; when both sides
+* speak, Rapier's priority order (Max > Multiply > Min > Average) decides.
+*/
+function applySurface(R, target, node) {
+	const Rule = R.CoefficientCombineRule;
+	target.setFriction(node.friction);
+	target.setFrictionCombineRule(node.friction === .5 ? Rule.Average : node.friction < .5 ? Rule.Min : Rule.Max);
+	target.setRestitution(node.restitution);
+	target.setRestitutionCombineRule(node.restitution > 0 ? Rule.Max : Rule.Average);
+}
 //#endregion
 export { enablePhysics3D as n, physics_3d_exports as r, Physics3D as t };

package/dist/{picking-C9McVJrO.js → picking-BMV34Pjl.js}

@@ -1,7 +1,7 @@
-import { _ as AudioPlayer } from "./register-5IYfooAN.js";
+import { _ as AudioPlayer } from "./register-CjociOtt.js";
 import { i as logReport, o as parseDrive } from "./webgl-unavailable-C8aDbGmR.js";
 import { a as frameSignature, i as frameImage, o as frameStats } from "./frame-report-D-_7YF2G.js";
-import { Q as worldPosition } from "./gameplay-BlQe-M07.js";
+import { et as worldPosition } from "./gameplay-Bxe1sMVT.js";
 //#region src/core/audio-errors.ts
 /** Every AudioPlayer under `root` whose source could not be played. */
 function audioErrors(root) {

package/dist/react.d.ts

@@ -1,4 +1,4 @@
-import { P as Scene, b as Engine, n as BehaviorCtor } from "./behavior-Bf9P9oB2.js";
+import { P as Scene, b as Engine, n as BehaviorCtor } from "./behavior-J1cmVah0.js";
 import { c as JsonValue } from "./rng-Bb-IutXB.js";
 import { CSSProperties, ReactNode } from "react";
 

package/dist/react.js

@@ -156,7 +156,7 @@ function IncantoCanvas(props) {
 				pointer: latest.pointer,
 				...keyboard !== void 0 ? { keyboard } : {}
 			};
-			const next = await (_gameFactory ?? (mode === "3d" ? async (o) => (await import("./create-game-CmFAtLZp.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-C9rWqqAC.js").then((n) => n.n)).createGame2D(o)))(opts);
+			const next = await (_gameFactory ?? (mode === "3d" ? async (o) => (await import("./create-game-BAiA-FjP.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-ssvGvP7W.js").then((n) => n.n)).createGame2D(o)))(opts);
 			if (disposed) {
 				next.dispose();
 				return;

package/dist/{register-5IYfooAN.js → register-CjociOtt.js}

@@ -1,8 +1,8 @@
 import { o as __exportAll } from "./json-CfTjpvW8.js";
-import { B as HudLayer, F as resolveOrderGroups, G as UiText, H as TAPPABLE, I as InputMap, J as Node, N as ORDER_GROUP_BASE, U as UiBanner, V as HudWidgetBase, W as UiBar, Y as diagnose, a as restoreBehaviors, ct as Signal, i as captureBehaviors, j as createSaveStore, q as requireText, t as ENGINE_STATE_KEY, z as FITS } from "./save-slots-CEuJPUle.js";
+import { B as HudLayer, F as resolveOrderGroups, G as UiText, H as TAPPABLE, I as InputMap, J as Node, N as ORDER_GROUP_BASE, U as UiBanner, V as HudWidgetBase, W as UiBar, Y as diagnose, a as restoreBehaviors, ct as Signal, i as captureBehaviors, j as createSaveStore, q as requireText, t as ENGINE_STATE_KEY, z as FITS } from "./save-slots-CEUGeLuB.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as Rng } from "./rng-CDOMybym.js";
-import { p as registerNode } from "./touch-BnCyPA0G.js";
+import { p as registerNode } from "./touch-CioTZB-y.js";
 //#region src/core/audio/buses.ts
 const AUDIO_LOG_LIMIT = 200;
 var AudioBuses = class {
@@ -1366,6 +1366,14 @@ var EffectLog = class {
 	countOf(name) {
 		return this.events.reduce((n, e) => e.name === name ? n + 1 : n, 0);
 	}
+	/**
+	* How many effects of this KIND fired (`shake`, `hitstop`, `burst`, `sfx`).
+	* A shake has no name, so `countOf('shake')` answered 0 for a boss whose
+	* every slam shook the camera — the harness that asked reached for the kind.
+	*/
+	countKind(kind) {
+		return this.events.reduce((n, e) => e.kind === kind ? n + 1 : n, 0);
+	}
 	/** How many effects this node fired — the question a wiring check has. */
 	countFrom(path) {
 		return this.events.reduce((n, e) => e.from === path ? n + 1 : n, 0);
@@ -3259,7 +3267,10 @@ var Respawn = class extends Node {
 			default: "..",
 			nodePath: true
 		},
-		below: { default: null },
+		below: {
+			default: null,
+			kinds: ["null", "number"]
+		},
 		to: { default: [] },
 		resetVelocity: { default: true }
 	};
@@ -3333,7 +3344,7 @@ var Respawn = class extends Node {
 		const y = worldY(target);
 		if ((y - line) * this.down <= 0) return;
 		this.falls += 1;
-		setPosition(target, this.home);
+		setPosition(target, this.to.length > 0 ? this.to : this.home);
 		if (this.resetVelocity) zeroVelocity(target);
 		this.emit("respawned", target, y);
 	}
@@ -3389,6 +3400,10 @@ var Timer = class extends Node {
 	autostart = false;
 	running = false;
 	remaining = 0;
+	/** Seconds until the next `timeout` — a countdown a HUD can draw. `0` when stopped. */
+	get timeLeft() {
+		return this.running ? Math.max(0, this.remaining) : 0;
+	}
 	start(time = this.waitTime) {
 		this.waitTime = time;
 		this.remaining = this.waitTime;

package/dist/{register-C8HuRkOf.js → register-DRQyZKGU.js}

@@ -1,9 +1,9 @@
-import { J as Node, P as effectiveOrder, Y as diagnose } from "./save-slots-CEuJPUle.js";
-import { M as translateOn, t as registerCoreNodes } from "./register-5IYfooAN.js";
+import { J as Node, P as effectiveOrder, Y as diagnose } from "./save-slots-CEUGeLuB.js";
+import { M as translateOn, t as registerCoreNodes } from "./register-CjociOtt.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
-import { c as getNodeSchema, h as didYouMean, p as registerNode } from "./touch-BnCyPA0G.js";
-import { i as ParticleSim, n as resolveFrames, o as PARTICLE_PRESET_NAMES, r as validateAnimations, s as applyParticlePreset, t as resolveAnimation } from "./sprite-animation-CqR2o3SA.js";
-import { D as effectRng, Q as worldPosition, T as tolerateUnknownAction, Z as localFromWorld } from "./gameplay-BlQe-M07.js";
+import { c as getNodeSchema, h as didYouMean, p as registerNode } from "./touch-CioTZB-y.js";
+import { i as ParticleSim, n as resolveFrames, o as PARTICLE_PRESET_NAMES, r as validateAnimations, s as applyParticlePreset, t as resolveAnimation } from "./sprite-animation-Bz3DHD_4.js";
+import { $ as localFromWorld, E as tolerateUnknownAction, O as effectRng, et as worldPosition } from "./gameplay-Bxe1sMVT.js";
 import { t as checkSheetGrid } from "./sheet-grid-Cea343VO.js";
 import { AdditiveBlending, BufferAttribute, BufferGeometry, CanvasTexture, Color, DynamicDrawUsage, Group, InstancedMesh, MathUtils, Matrix4, Mesh, MeshBasicMaterial, NearestFilter, NormalBlending, Object3D, PlaneGeometry, SRGBColorSpace } from "three";
 //#region src/2d/physics/collider-validate.ts
@@ -235,9 +235,27 @@ var PhysicsBody2D = class extends Node2D {
 	/** @internal Set by Physics2D when the body is created. */
 	_physics = null;
 };
-/** Immovable collider (ground, walls, platforms). */
+/**
+* Immovable collider (ground, walls, platforms).
+*
+* It also carries the SURFACE it is: `friction` and `restitution` used to
+* live on `RigidBody2D` alone, so a trampoline, an ice patch or a sticky
+* landing could not be written in scene JSON, and Rapier's AVERAGE rule
+* halved whatever a ball brought to a plain floor. A static body's authored
+* value WINS the pair — restitution above 0 combines by Max, friction below
+* the default by Min and above it by Max — so the pad decides, whatever lands
+* on it. Left at the defaults, nothing changes for any existing scene.
+*/
 var StaticBody2D = class extends PhysicsBody2D {
 	static typeName = "StaticBody2D";
+	static props = {
+		friction: { default: .5 },
+		restitution: { default: 0 }
+	};
+	/** 0.5 plain · 0 ice (slides on and on) · 1+ glue. Away from 0.5 it wins the pair. */
+	friction = .5;
+	/** 0 dead · 1 trampoline. Above 0 it wins the pair: a dead ball still bounces. */
+	restitution = 0;
 };
 /**
 * Sensor volume. Emits `triggerEnter(other)` / `triggerExit(other)` — the
@@ -264,13 +282,25 @@ var RigidBody2D = class extends PhysicsBody2D {
 		friction: { default: .5 },
 		restitution: { default: 0 },
 		linearVelocity: { default: [0, 0] },
-		angularVelocity: { default: 0 }
+		angularVelocity: { default: 0 },
+		linearDamping: {
+			default: 0,
+			range: { min: 0 }
+		},
+		angularDamping: {
+			default: 0,
+			range: { min: 0 }
+		}
 	};
 	mass = 1;
 	gravityScale = 1;
 	fixedRotation = false;
 	friction = .5;
 	restitution = 0;
+	/** Drag, per second: velocity decays by `e^(-linearDamping·t)`. `0` = none. */
+	linearDamping = 0;
+	/** Rolling resistance, per second, on the spin — see `RigidBody3D.angularDamping`. */
+	angularDamping = 0;
 	/** px/s, y-down. Read back every step; write to launch. */
 	linearVelocity = [0, 0];
 	/**
@@ -326,7 +356,8 @@ var CharacterBody2D = class extends PhysicsBody2D {
 		stepHeight: {
 			default: 35,
 			range: { min: 0 }
-		}
+		},
+		collideWithCharacters: { default: true }
 	};
 	/**
 	* Renamed to match the 3D body, where `snapToGround` had to give the name
@@ -351,6 +382,8 @@ var CharacterBody2D = class extends PhysicsBody2D {
 	* `0` restores the old behaviour.
 	*/
 	stepHeight = 35;
+	/** See CharacterBody3D.collideWithCharacters — off, a crowd ignores itself and costs nothing. */
+	collideWithCharacters = true;
 	/** @internal Updated by Physics2D.moveAndSlide. */
 	_grounded = false;
 	moveAndSlide() {
@@ -419,7 +452,10 @@ var Joint2D = class extends Node2D {
 		length: { default: 0 },
 		stiffness: { default: 50 },
 		damping: { default: 5 },
-		collide: { default: null }
+		collide: {
+			default: null,
+			kinds: ["null", "boolean"]
+		}
 	};
 	type = "revolute";
 	target = "";

package/dist/{replay-datiAE-b.js → replay-B6BbgGM_.js}

@@ -1,7 +1,25 @@
-import { L as handlerShadowWarnings, R as sceneDimension, V as HudWidgetBase, Z as nodeRefWarnings } from "./save-slots-CEuJPUle.js";
-import { N as translationKey } from "./register-5IYfooAN.js";
+import { L as handlerShadowWarnings, R as sceneDimension, V as HudWidgetBase, Z as nodeRefWarnings } from "./save-slots-CEUGeLuB.js";
+import { N as translationKey } from "./register-CjociOtt.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
-import { u as getNodeType } from "./touch-BnCyPA0G.js";
+import { u as getNodeType } from "./touch-CioTZB-y.js";
+//#region src/core/light-types.ts
+/**
+* The node types that are LIGHTS — one set, read by everything that has to
+* decide.
+*
+* `auditScene` counts them (a 3D scene with none is a warning), `framing`
+* leaves them out of the bounds (a sun at y 100 is not "the game"), and the
+* picker never lets a click land on one. Three files each kept their own copy
+* of this set, and the day a third light arrived every copy would have been a
+* place to forget. The test beside `SpotLight3D` asks the registry for every
+* `*Light3D` and checks it is here.
+*/
+const LIGHT_NODE_TYPES = new Set([
+	"DirectionalLight3D",
+	"OmniLight3D",
+	"SpotLight3D"
+]);
+//#endregion
 //#region src/core/audit.ts
 /**
 * Behaviours whose ENTIRE observable effect is the signals they emit.
@@ -71,7 +89,7 @@ const DRAPERS = new Set([
 	"Tree3D",
 	"River3D"
 ]);
-const LIGHT_TYPES = new Set(["DirectionalLight3D", "OmniLight3D"]);
+const LIGHT_TYPES = LIGHT_NODE_TYPES;
 /**
 * Nodes whose gameplay answer comes from a CPU twin built out of `size`.
 *
@@ -124,6 +142,13 @@ function isLit(environment) {
 * Offsets compose; rotation and scale do not — the body is placed at its WORLD
 * position and given its OWN rotation, so an ancestor's is simply lost.
 */
+/**
+* Node types the engine ROTATES at runtime — a skin, yawed by
+* `CharacterController3D.skinPath` and `Chase`/`Patrol.facePath`. Billboards
+* and sprites turn too, toward the CAMERA, and a collider that does not follow
+* that is the right collider, so they are not listed.
+*/
+const TURNED_AT_RUNTIME = new Set(["ModelInstance3D"]);
 function transformOf(props) {
 	const rot = props.rotation;
 	const scale = props.scale;
@@ -194,6 +219,17 @@ function auditScene(scene, opts = {}) {
 			const colours = props.colors ?? {};
 			if (cells.length > 0 && (props.texture ?? "") === "" && Object.keys(colours).length === 0) warnings.push(`${path}: TileMap2D has ${cells.length} row(s) and neither "texture" nor "colors", so nothing of it is drawn. Give it a "colors" entry per legend char to see the level before the art arrives. (If it is meant to be an invisible collision map over scenery you drew yourself, this warning is the price of saying so.)`);
 		}
+		if (!onShelf && props.visible !== false) {
+			const art = {
+				ModelInstance3D: ["model", "a `$model` asset ref"],
+				Sprite3D: ["texture", "an image URL"],
+				AnimatedSprite3D: ["sheet", "a spritesheet URL (with frameWidth/frameHeight)"]
+			}[type];
+			if (art && ((props[art[0]] ?? "") === "" || props[art[0]] === void 0)) warnings.push(`${path}: ${type} has no "${art[0]}", so nothing of it is drawn — it loads, validates and takes up a row in the tree, and puts no pixel on screen. Give it ${art[1]}.`);
+			if (type === "InstancedMesh3D") {
+				if ((Array.isArray(props.transforms) ? props.transforms : []).length === 0) warnings.push(`${path}: InstancedMesh3D has no "transforms", so it draws nothing — a scatter with no rows. Add [x, y, z, yawDeg?, scale?] rows, or fill them from a behaviour and say so.`);
+			}
+		}
 		if (type === "CharacterController3D") cameraDrivers.push(path);
 		if (type === "Terrain3D") terrains.push(path);
 		if (DRAPERS.has(type) && (props.terrain ?? "") === "") autoDrapers.push(path);
@@ -228,7 +264,7 @@ function auditScene(scene, opts = {}) {
 		if (staticRoot && ANIMATED_TYPES.has(type)) warnings.push(`${path}: ${type} is frozen inside static subtree '${staticRoot}' — it will not animate/update on screen.`);
 		const nextStatic = staticRoot ?? (props.static === true ? node.name ?? path : null);
 		const nextHud = insideHud || type === "HudLayer";
-		const own = transformOf(props);
+		const own = transformOf(props) ?? (TURNED_AT_RUNTIME.has(type) ? `runtime yaw (a ${type} is what the controller and Chase turn)` : null);
 		const nextTransformed = own ? {
 			path,
 			what: own
@@ -599,4 +635,4 @@ function replay(engine, recording, opts) {
 	}
 }
 //#endregion
-export { instancedScenes as i, startRecording as n, auditScene as r, replay as t };
+export { LIGHT_NODE_TYPES as a, instancedScenes as i, startRecording as n, auditScene as r, replay as t };

package/dist/{replay-CBEChqXq.d.ts → replay-wZK5Ok5c.d.ts}

@@ -1,4 +1,4 @@
-import { b as Engine } from "./behavior-Bf9P9oB2.js";
+import { b as Engine } from "./behavior-J1cmVah0.js";
 import { s as JsonObject } from "./rng-Bb-IutXB.js";
 
 //#region src/core/audit.d.ts

package/dist/{save-slots-CEuJPUle.js → save-slots-CEUGeLuB.js}

@@ -1,6 +1,6 @@
 import { n as jsonEquals, o as __exportAll, t as jsonClone } from "./json-CfTjpvW8.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
-import { a as applySchemaProps, c as getNodeSchema, d as mergeStaticProps, f as mergeStaticSignals, g as nearestName, h as didYouMean, r as capturePointer, s as createNode, u as getNodeType } from "./touch-BnCyPA0G.js";
+import { a as applySchemaProps, c as getNodeSchema, d as mergeStaticProps, f as mergeStaticSignals, g as nearestName, h as didYouMean, r as capturePointer, s as createNode, u as getNodeType } from "./touch-CioTZB-y.js";
 //#region src/core/signal.ts
 var Signal = class {
 	connections = [];
@@ -150,6 +150,10 @@ var Behavior = class {
 	getNode(path) {
 		return this.node.getNode(path);
 	}
+	/** The node's `getNodeOrNull`, for the same reason `getNode` is here. */
+	getNodeOrNull(path) {
+		return this.node.getNodeOrNull(path);
+	}
 	emit(signal, ...args) {
 		this.node.emit(signal, ...args);
 	}
@@ -4505,7 +4509,12 @@ function loadScene(json, opts) {
 	} : sceneJson, collected), broughtAssets), broughtInput), broughtBands);
 	if (opts?.engine && full.strings) opts.engine.locale.load(full.strings);
 	wireConnections(root, sceneJson.connections ?? [], opts?.declareConnectionSignals);
-	tree.setRoot(root);
+	try {
+		tree.setRoot(root);
+	} catch (error) {
+		root.free();
+		throw error;
+	}
 	loadingAssets = null;
 	return new Scene(full, root, tree);
 }

package/dist/{split-screen-Bm5DTElG.js → split-screen-BxZ5rBe7.js}

@@ -1,8 +1,8 @@
 import { n as jsonEquals, t as jsonClone } from "./json-CfTjpvW8.js";
-import { J as Node, Y as diagnose, ct as Signal, d as rebuildOptions, h as loadScene, l as markCloned, m as buildSceneSubtree, p as stripUids, u as markTemplateName } from "./save-slots-CEuJPUle.js";
-import { t as registerCoreNodes, v as Engine } from "./register-5IYfooAN.js";
+import { J as Node, Y as diagnose, ct as Signal, d as rebuildOptions, h as loadScene, l as markCloned, m as buildSceneSubtree, p as stripUids, u as markTemplateName } from "./save-slots-CEUGeLuB.js";
+import { t as registerCoreNodes, v as Engine } from "./register-CjociOtt.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
-import { p as registerNode } from "./touch-BnCyPA0G.js";
+import { p as registerNode } from "./touch-CioTZB-y.js";
 //#region src/net/loopback.ts
 /**
 * In-memory multiplayer hub implementing the SAME kernel contract as
@@ -1150,7 +1150,7 @@ function applySyncPatch(root, patch, setProp, onMissingNode) {
 	}
 }
 async function createDefaultTransport(config, diagnostics) {
-	const { createAgent8Server } = await import("./agent8-BqZ0_O1u.js").then((n) => n.t);
+	const { createAgent8Server } = await import("./agent8-CHTT4unP.js").then((n) => n.t);
 	return createAgent8Server(config, diagnostics);
 }
 //#endregion