incanto 0.69.0 → 0.70.0

package/dist/{physics-3d-DbYaEcZy.js → physics-3d-CpH-2gn5.js}

@@ -1,10 +1,10 @@
-import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { k as diagnose } from "./loader-DZE7B07H.js";
+import { o as __exportAll } from "./json-CfTjpvW8.js";
+import { q as diagnose } from "./save-slots-BXVg148r.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-D1KixWK8.js";
+import { B as Area3D, G as Node3D, H as PhysicsBody3D, K as validateCollider3D, U as RigidBody3D, V as CharacterBody3D } from "./gameplay-BfHkuzVb.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-BO-7XoFV.js";
+import { A as Terrain3D, F as InstancedMesh3D, L as buildMeshGeometry, P as Joint3D } from "./environment-presets-D6Q5BxeE.js";
 import { Euler, Matrix4, Quaternion, Vector3 } from "three";
 //#region src/3d/physics/collider-lines.ts
 /**
@@ -386,6 +386,21 @@ var Physics3D = class {
 		this.world.propagateModifiedBodyPositionsToColliders();
 	}
 	/** @internal Called by CharacterBody3D.moveAndSlide (during tree fixedUpdate). */
+	/**
+	* May `candidate` carry `rider`? — see the 2D twin.
+	*
+	* "Never a CharacterBody3D" is the whole CLASS, and a CharacterBody3D
+	* animated by position writes is the documented moving-platform path. What
+	* the guard was really for is a carry CYCLE, so that is what it tests.
+	*/
+	canCarry(rider, candidate) {
+		let at = candidate;
+		for (let depth = 0; depth < 8 && at; depth++) {
+			if (at === rider) return false;
+			at = this.entries.get(at)?.ground ?? null;
+		}
+		return true;
+	}
 	moveAndSlide(node) {
 		const e = this.ensureEntry(node);
 		if (!e) return;
@@ -421,6 +436,20 @@ var Physics3D = class {
 			z: nz
 		});
 		node._grounded = this.kcc.computedGrounded();
+		node._onWall = null;
+		node._onCeiling = false;
+		const touches = this.kcc.numComputedCollisions();
+		for (let i = 0; i < touches; i++) {
+			const normal = this.kcc.computedCollision(i)?.normal1;
+			if (!normal) continue;
+			if (normal.y < -.7) {
+				if (!node._grounded) node._onCeiling = true;
+			} else if (Math.hypot(normal.x, normal.z) > .7) node._onWall = [
+				normal.x,
+				normal.y,
+				normal.z
+			];
+		}
 		if (node._grounded) {
 			const half = characterHalfHeight(node);
 			const hit = this.castRay([
@@ -432,7 +461,7 @@ var Physics3D = class {
 				-1,
 				0
 			], .4, node);
-			if (hit?.node && !(hit.node instanceof CharacterBody3D)) {
+			if (hit?.node && this.canCarry(node, hit.node)) {
 				e.ground = hit.node;
 				const at = worldPosition3D(hit.node);
 				e.groundAt = [
@@ -499,9 +528,28 @@ 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. */
+	scatterState = /* @__PURE__ */ new Map();
+	/**
+	* Has any scatter field moved, or had its rows replaced, since the build?
+	*
+	* `transforms` is compared by IDENTITY, which is the operation the skill
+	* teaches ("replace the whole array"); the world position catches the field
+	* itself or an ancestor being moved.
+	*/
+	scattersMoved() {
+		for (const [field] of this.scatterBodies) {
+			const was = this.scatterState.get(field);
+			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;
+		}
+		return false;
+	}
 	syncScatters(root) {
 		for (const [, entry] of this.scatterBodies) this.world.removeRigidBody(entry);
 		this.scatterBodies.clear();
+		this.scatterState.clear();
 		const fields = /* @__PURE__ */ new Set();
 		collectScatters(root, fields);
 		for (const field of fields) {
@@ -543,6 +591,12 @@ var Physics3D = class {
 				this.world.createCollider(desc, body);
 			}
 			this.scatterBodies.set(field, body);
+			this.scatterState.set(field, {
+				rows: field.transforms,
+				x: ox,
+				y: oy,
+				z: oz
+			});
 		}
 	}
 	syncBodies() {
@@ -577,6 +631,7 @@ var Physics3D = class {
 				this.syncScatters(scene.root);
 			}
 		}
+		if (this.scatterBodies.size > 0 && this.scattersMoved()) this.syncScatters(scene.root);
 		const seen = this.bodySet;
 		for (const node of seen) {
 			if (node.collider.shape === void 0) {
@@ -644,12 +699,13 @@ var Physics3D = class {
 			if (node instanceof RigidBody3D) {
 				desc.setGravityScale(node.gravityScale);
 				desc.setLinvel(node.linearVelocity[0] ?? 0, node.linearVelocity[1] ?? 0, node.linearVelocity[2] ?? 0);
+				const locked = node.fixedRotation;
 				desc.setAngvel({
-					x: node.angularVelocity[0] ?? 0,
-					y: node.angularVelocity[1] ?? 0,
-					z: node.angularVelocity[2] ?? 0
+					x: locked ? 0 : node.angularVelocity[0] ?? 0,
+					y: locked ? 0 : node.angularVelocity[1] ?? 0,
+					z: locked ? 0 : node.angularVelocity[2] ?? 0
 				});
-				if (node.fixedRotation) desc.lockRotations();
+				if (locked) desc.lockRotations();
 			}
 			const body = this.world.createRigidBody(desc);
 			colDesc.setActiveEvents(R.ActiveEvents.COLLISION_EVENTS);
@@ -674,7 +730,10 @@ var Physics3D = class {
 					0,
 					0,
 					0
-				]
+				],
+				lastMass: node instanceof RigidBody3D ? node.mass : 1,
+				lastFriction: node instanceof RigidBody3D ? node.friction : .5,
+				lastRestitution: node instanceof RigidBody3D ? node.restitution : 0
 			};
 			this.entries.set(node, e);
 			this.byColliderHandle.set(collider.handle, node);
@@ -735,6 +794,18 @@ var Physics3D = class {
 				e.lastV = v;
 			}
 			if (node.gravityScale !== e.body.gravityScale()) e.body.setGravityScale(node.gravityScale, true);
+			if (node.mass !== e.lastMass) {
+				e.collider.setMass(node.mass);
+				e.lastMass = node.mass;
+			}
+			if (node.friction !== e.lastFriction) {
+				e.collider.setFriction(node.friction);
+				e.lastFriction = node.friction;
+			}
+			if (node.restitution !== e.lastRestitution) {
+				e.collider.setRestitution(node.restitution);
+				e.lastRestitution = node.restitution;
+			}
 		}
 		return e;
 	}
@@ -864,21 +935,24 @@ var Physics3D = class {
 		return [...set];
 	}
 	/**
-	* World-space raycast (meters). `exclude` skips that body's collider —
+	* World-space raycast (meters). `dir` may be any length (it is normalized),
+	* so `distance` and `maxLen` are metres. `exclude` skips that body's collider —
 	* ground probes from inside a capsule need it. `opts.staticOnly` hits ONLY the
 	* fixed/static world (excludes both dynamic AND kinematic bodies): the camera
 	* spring arm uses it so neither a dynamic projectile nor a KINEMATIC enemy
 	* (CharacterBody3D) passing behind the player yanks the camera in.
 	*/
 	castRay(origin, dir, maxLen, exclude, opts) {
+		const len = Math.hypot(dir[0], dir[1], dir[2]);
+		if (!(len > 0)) return null;
 		const ray = new this.R.Ray({
 			x: origin[0],
 			y: origin[1],
 			z: origin[2]
 		}, {
-			x: dir[0],
-			y: dir[1],
-			z: dir[2]
+			x: dir[0] / len,
+			y: dir[1] / len,
+			z: dir[2] / len
 		});
 		const excludeCollider = exclude ? this.entries.get(exclude)?.collider : void 0;
 		const flags = opts?.staticOnly ? this.R.QueryFilterFlags.EXCLUDE_DYNAMIC | this.R.QueryFilterFlags.EXCLUDE_KINEMATIC : void 0;
@@ -891,7 +965,12 @@ var Physics3D = class {
 				hit.normal.y,
 				hit.normal.z
 			],
-			node: this.byColliderHandle.get(hit.collider.handle) ?? null
+			node: this.byColliderHandle.get(hit.collider.handle) ?? null,
+			point: [
+				origin[0] + dir[0] / len * hit.timeOfImpact,
+				origin[1] + dir[1] / len * hit.timeOfImpact,
+				origin[2] + dir[2] / len * hit.timeOfImpact
+			]
 		};
 	}
 	/**
@@ -906,6 +985,8 @@ var Physics3D = class {
 		const R = this.R;
 		const excludeEntry = exclude ? this.entries.get(exclude) : void 0;
 		const flags = opts?.staticOnly ? R.QueryFilterFlags.EXCLUDE_DYNAMIC | R.QueryFilterFlags.EXCLUDE_KINEMATIC : void 0;
+		const len = Math.hypot(dir[0], dir[1], dir[2]);
+		if (!(len > 0)) return null;
 		const hit = this.world.castShape({
 			x: origin[0],
 			y: origin[1],
@@ -916,9 +997,9 @@ var Physics3D = class {
 			z: 0,
 			w: 1
 		}, {
-			x: dir[0],
-			y: dir[1],
-			z: dir[2]
+			x: dir[0] / len,
+			y: dir[1] / len,
+			z: dir[2] / len
 		}, new R.Ball(radius), 0, maxLen, true, flags, void 0, excludeEntry?.collider, excludeEntry?.body, (collider) => !collider.isSensor());
 		if (!hit) return null;
 		return {
@@ -950,7 +1031,7 @@ function collectBodies(node, out) {
 * Convex, always: a hull is a few planes to test against, where a triangle
 * mesh is a tree of them, and nothing scattered across a map needs concavity.
 */
-function meshShapedDesc(R, kind, size, scale, who) {
+function meshShapedDesc(R, kind, size, scale, who, engine) {
 	const sx = scale[0] ?? 1;
 	const sy = scale[1] ?? 1;
 	const sz = scale[2] ?? 1;
@@ -958,7 +1039,7 @@ function meshShapedDesc(R, kind, size, scale, who) {
 	const y = (size[1] ?? 1) * sy;
 	const z = (size[2] ?? 1) * sz;
 	const radial = Math.max(Math.abs(sx), Math.abs(sz));
-	if (who && kind !== "box" && kind !== "plane" && Math.abs(sx - sz) > 1e-6) console.warn(`[incanto] Collider on '${who}': shape 'auto' fits a ${kind} to a mesh scaled [${sx}, ${sy}, ${sz}]. A ${kind} has one radius, so the widest of x/z (${radial}) is used. Use a box, or scale x and z the same.`);
+	if (who && kind !== "box" && kind !== "plane" && Math.abs(sx - sz) > 1e-6) diagnose(engine ?? null, "warn", `[incanto] Collider on '${who}': shape 'auto' fits a ${kind} to a mesh scaled [${sx}, ${sy}, ${sz}]. A ${kind} has one radius, so the widest of x/z (${radial}) is used. Use a box, or scale x and z the same.`);
 	switch (kind) {
 		case "box": return R.ColliderDesc.cuboid(x / 2, y / 2, z / 2);
 		case "sphere": return R.ColliderDesc.ball((size[0] ?? 1) * Math.max(radial, Math.abs(sy)));
@@ -1233,9 +1314,9 @@ function buildColliderDesc3D(R, collider, nodeName, node) {
 		const model = models[0];
 		if (!mesh && !model) throw new IncantoError("BAD_FORMAT", `Collider on '${nodeName}': shape 'auto' needs a MeshInstance3D or ModelInstance3D on the body (or as a child) to take its shape from.`);
 		const parts = meshes.length + models.length;
-		if (parts > 1) console.warn(`[incanto] Collider on '${nodeName}': shape 'auto' fits ONE mesh and took '${(mesh ?? model)?.name}'; ${parts - 1} other mesh(es) here are not solid. Give each part its own body.`);
+		if (parts > 1) diagnose(node?.tree?.engine ?? null, "warn", `[incanto] Collider on '${nodeName}': shape 'auto' fits ONE mesh and took '${(mesh ?? model)?.name}'; ${parts - 1} other mesh(es) here are not solid. Give each part its own body.`);
 		if (mesh) {
-			const desc = meshShapedDesc(R, mesh.mesh, mesh.size, mesh.scale, nodeName);
+			const desc = meshShapedDesc(R, mesh.mesh, mesh.size, mesh.scale, nodeName, node?.tree?.engine);
 			if (desc) {
 				desc.setTranslation(mesh.at[0], mesh.at[1], mesh.at[2]);
 				if (mesh.turn[0] !== 0 || mesh.turn[1] !== 0 || mesh.turn[2] !== 0) {
@@ -1253,7 +1334,7 @@ function buildColliderDesc3D(R, collider, nodeName, node) {
 			const tri = modelTriangles(node, model);
 			if (!tri) return null;
 			if (isStaticShape(node)) {
-				if (tri.triangles > TRIMESH_BUDGET) console.warn(`[incanto] Collider on '${nodeName}': shape 'auto' built a ${tri.triangles}-triangle mesh from '${model.name}'. Consider a low-poly collision model or an explicit box.`);
+				if (tri.triangles > TRIMESH_BUDGET) diagnose(node?.tree?.engine ?? null, "warn", `[incanto] Collider on '${nodeName}': shape 'auto' built a ${tri.triangles}-triangle mesh from '${model.name}'. Consider a low-poly collision model or an explicit box.`);
 				return R.ColliderDesc.trimesh(tri.vertices, tri.indices);
 			}
 			return R.ColliderDesc.convexHull(tri.vertices);

package/dist/{teardown-CMqFVxO9.js → picking-CQJ_PJKh.js}

@@ -1,6 +1,7 @@
-import { _ as AudioPlayer } from "./register-mmfugpaQ.js";
-import { i as logReport, o as parseDrive } from "./webgl-unavailable-Z5_g8x9H.js";
+import { _ as AudioPlayer } from "./register-6DYnKZcy.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-Dlq13Gyj.js";
+import { Z as worldPosition } from "./gameplay-BfHkuzVb.js";
 //#region src/core/audio-errors.ts
 /** Every AudioPlayer under `root` whose source could not be played. */
 function audioErrors(root) {
@@ -100,6 +101,74 @@ function wireDevChannel(opts) {
 	return cleanups;
 }
 //#endregion
+//#region src/core/drive-apply.ts
+/**
+* Long enough for the page to draw a frame between the press and the release.
+*
+* Both edges in one tick would still FIRE — the input settles them together and
+* `Clickable` reads press then release in the same update — but no real cursor
+* does that, and everything a game shows for a held button (a pressed state, a
+* hover tint, the sound) would never be on screen. Two frames at 60 Hz.
+*/
+const FRAME_MS = 34;
+/** Apply one step of a drive script to a running game. */
+async function applyDriveStep(target, step) {
+	const { engine } = target;
+	switch (step.kind) {
+		case "press":
+			engine.input.pressAction(step.action);
+			return;
+		case "release":
+			engine.input.releaseAction(step.action);
+			return;
+		case "vector":
+			engine.input.setActionVector(step.action, step.x, step.y);
+			return;
+		case "key":
+			engine.input.handleKey(step.code, step.down);
+			return;
+		case "pointer":
+			engine.input.handlePointerMove(step.dx, step.dy);
+			return;
+		case "at":
+			engine.input.setPointerPosition(step.x, step.y);
+			return;
+		case "atNode": {
+			const node = engine.scene?.root.getNodeOrNull(step.path);
+			const at = node ? worldPosition(node) : [];
+			if (at.length === 0) {
+				engine.log.error(`[incanto] drive: at '${step.path}' — no such node, so the cursor did not move.`);
+				return;
+			}
+			const screen = target.project(at[0] ?? 0, at[1] ?? 0, at[2] ?? 0);
+			if (!screen) {
+				engine.log.error(`[incanto] drive: at '${step.path}' — this renderer cannot say where a world point is on screen, so the cursor did not move.`);
+				return;
+			}
+			if (screen.behind === true) {
+				engine.log.error(`[incanto] drive: at '${step.path}' — it is BEHIND the camera, so there is no pixel to put the cursor on.`);
+				return;
+			}
+			engine.input.setPointerPosition(screen.x, screen.y);
+			return;
+		}
+		case "click":
+			engine.input.handleMouseButton(step.button, true);
+			await target.wait(FRAME_MS);
+			engine.input.handleMouseButton(step.button, false);
+			await target.wait(FRAME_MS);
+			return;
+		case "mouse":
+			engine.input.handleMouseButton(step.button, step.down);
+			await target.wait(FRAME_MS);
+			return;
+		case "step":
+			await target.wait(step.ms);
+			return;
+		default: return;
+	}
+}
+//#endregion
 //#region src/core/editor-switch.ts
 /**
 * Cover the page while it changes what it is.
@@ -347,27 +416,20 @@ function pauseWhenHidden(engine, doc = typeof document === "undefined" ? null :
 	if (!doc) return () => {};
 	/** The scale to come back to — null when we did not pause anything. */
 	let heldScale = null;
-	let mutedByUs = false;
 	const onChange = () => {
 		if (doc.hidden) {
 			if (heldScale === null && engine.timeScale > 0) {
 				heldScale = engine.timeScale;
 				engine.timeScale = 0;
 			}
-			if (!engine.audio.muted) {
-				engine.audio.muted = true;
-				mutedByUs = true;
-			}
+			engine.audio.suspend(true);
 			return;
 		}
 		if (heldScale !== null) {
 			if (engine.timeScale === 0) engine.timeScale = heldScale;
 			heldScale = null;
 		}
-		if (mutedByUs) {
-			engine.audio.muted = false;
-			mutedByUs = false;
-		}
+		engine.audio.suspend(false);
 	};
 	doc.addEventListener("visibilitychange", onChange);
 	return () => doc.removeEventListener("visibilitychange", onChange);
@@ -397,4 +459,33 @@ function defaultReport(what, error) {
 	console.error(`[incanto] teardown: ${what} failed (continuing)`, error);
 }
 //#endregion
-export { openBundledEditor as a, claimCanvasGestures as c, devServerLibrary as i, audioErrors as l, pauseWhenHidden as n, poseFromRenderer as o, crossFade as r, wireDevChannel as s, teardown as t };
+//#region src/core/picking.ts
+/** Is this object, and every ancestor up to the scene, drawn? */
+function drawn(object) {
+	for (let at = object; at; at = at.parent) if (!at.visible) return false;
+	return true;
+}
+/**
+* The `incantoNode` under a set of raycast hits, or null.
+*
+* Hits are expected in the order three produces them: nearest first.
+*/
+function nodeFromHits(hits, opts = {}) {
+	let best = null;
+	for (const hit of hits) {
+		if (!drawn(hit.object)) continue;
+		let obj = hit.object;
+		while (obj && !obj.userData?.incantoNode) obj = obj.parent;
+		const node = obj?.userData?.incantoNode;
+		if (node === void 0) continue;
+		if (!opts.byRenderOrder) return node;
+		const order = hit.object.renderOrder ?? 0;
+		if (!best || order >= best.order) best = {
+			node,
+			order
+		};
+	}
+	return best?.node ?? null;
+}
+//#endregion
+export { devServerLibrary as a, applyDriveStep as c, audioErrors as d, crossFade as i, wireDevChannel as l, teardown as n, openBundledEditor as o, pauseWhenHidden as r, poseFromRenderer as s, nodeFromHits as t, claimCanvasGestures as u };

package/dist/react.d.ts

@@ -1,5 +1,5 @@
-import { P as Scene, b as Engine, n as BehaviorCtor } from "./behavior-rm8vVzu_.js";
-import { c as JsonValue } from "./schema-B6ugCV1Q.js";
+import { P as Scene, b as Engine, n as BehaviorCtor } from "./behavior-DZExDn9o.js";
+import { c as JsonValue } from "./rng-Bb-IutXB.js";
 import { CSSProperties, ReactNode } from "react";
 
 //#region src/react/index.d.ts

package/dist/react.js

@@ -1,4 +1,4 @@
-import { n as jsonEquals, t as jsonClone } from "./json-CwwhxQgb.js";
+import { n as jsonEquals, t as jsonClone } from "./json-CfTjpvW8.js";
 import { createContext, useContext, useEffect, useRef, useState } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 //#region src/react/index.tsx
@@ -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-CvJ1wSRP.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-CwxEDlCm.js").then((n) => n.n)).createGame2D(o)))(opts);
+			const next = await (_gameFactory ?? (mode === "3d" ? async (o) => (await import("./create-game-C7ffQWW7.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-Bwvh6q8A.js").then((n) => n.n)).createGame2D(o)))(opts);
 			if (disposed) {
 				next.dispose();
 				return;