incanto 0.47.0 → 0.49.0

package/dist/{particle-sim-Bw7hB93B.js → sprite-animation-D_p28jwU.js}

@@ -1,3 +1,4 @@
+import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { n as jsonEquals } from "./json-BLk7H2Qa.js";
 //#region src/core/particle-presets.ts
 const PARTICLE_PRESETS = {
@@ -264,4 +265,65 @@ var ParticleSim = class {
 	}
 };
 //#endregion
-export { applyParticlePreset as i, PARTICLE_PRESETS as n, PARTICLE_PRESET_NAMES as r, ParticleSim as t };
+//#region src/core/sprite-animation.ts
+/**
+* The animation MAP a spritesheet node is driven by — shared by 2D and 3D.
+*
+* Core, not an adapter: no three.js, and the two sprite nodes had grown
+* byte-identical copies of the frame reader.
+*/
+/**
+* Follow aliases to the clip that actually plays.
+*
+* Chains are allowed (`fall → jump → idle`) because they are how a fallback
+* ladder reads, and a cycle is a hard error rather than a hang.
+*/
+function resolveAnimation(animations, name, owner) {
+	const seen = [];
+	let key = name;
+	for (;;) {
+		const entry = animations[key];
+		if (entry === void 0) {
+			const via = seen.length > 0 ? ` (via ${seen.join(" → ")})` : "";
+			throw new IncantoError("UNKNOWN_ANIMATION", `No animation '${key}' on '${owner}'${via}. Available: [${Object.keys(animations).join(", ")}].`);
+		}
+		if (typeof entry !== "string") return {
+			name: key,
+			def: entry
+		};
+		if (seen.includes(key)) throw new IncantoError("UNKNOWN_ANIMATION", `Animation aliases on '${owner}' point in a circle: ${[...seen, key].join(" → ")}.`);
+		seen.push(key);
+		key = entry;
+	}
+}
+/**
+* Every alias resolves — checked once, at ready, rather than on the frame the
+* character first jumps.
+*
+* A cosmetic map that only fails the moment a state is first entered is the
+* shape of bug that reaches players: the game loads, plays, and dies on a
+* ledge twenty minutes in.
+*/
+function validateAnimationAliases(animations, owner) {
+	for (const [name, entry] of Object.entries(animations)) if (typeof entry === "string") resolveAnimation(animations, name, owner);
+}
+/**
+* `[start, end]` is a RANGE; anything else is an explicit list.
+*
+* Two ascending numbers are overwhelmingly a range in every sheet format, and
+* a two-frame flip-book is spelled `[3, 3, 4, 4]` or a descending pair.
+*/
+function resolveFrames(frames, name) {
+	if (!Array.isArray(frames) || frames.length === 0) throw new IncantoError("BAD_FORMAT", `Animation '${name}': "frames" must be a non-empty array.`);
+	if (frames.length === 2) {
+		const [start, end] = frames;
+		if (end >= start) {
+			const out = [];
+			for (let f = start; f <= end; f++) out.push(f);
+			return out;
+		}
+	}
+	return [...frames];
+}
+//#endregion
+export { PARTICLE_PRESETS as a, ParticleSim as i, resolveFrames as n, PARTICLE_PRESET_NAMES as o, validateAnimationAliases as r, applyParticlePreset as s, resolveAnimation as t };

package/dist/{src-Ca3oV1fe.js → src-DF4gCsqO.js}

@@ -161,6 +161,6 @@ function newUid() {
 //#endregion
 //#region src/index.ts
 /** Engine version. Kept in sync with package.json by the release pipeline. */
-const VERSION = "0.47.0";
+const VERSION = "0.49.0";
 //#endregion
 export { findPath as a, preloadUrls as i, newUid as n, gridFromRows as o, assetUrls as r, VERSION as t };

package/dist/{test-E4-otKqK.js → test-DRna_BQU.js}

@@ -1,13 +1,13 @@
-import { n as loadScene, w as registerBehavior } from "./loader-r49nDwB4.js";
-import { h as Engine } from "./register-BSXV8T9F.js";
+import { n as loadScene, s as resolveViewport, w as registerBehavior } from "./loader-DwazzlQb.js";
+import { h as Engine } from "./register-uvaZj1KX.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
-import { n as startRecording } from "./replay-DilbZgQI.js";
+import { n as startRecording } from "./replay-C0XJIsO7.js";
 import { n as jsonEquals, t as jsonClone } from "./json-BLk7H2Qa.js";
 import { i as getNodeSchema, s as mergeStaticProps } from "./registry-IyWCGe4q.js";
-import { n as registerGameplayBehaviors } from "./gameplay-BQOeAid6.js";
-import { t as registerNodes2D } from "./register-R2JTnIMw.js";
-import { n as registerNodes3D, t as resolveEnvironmentHdri } from "./environment-presets-D1b0ydTS.js";
-import { t as registerNodesNet } from "./register-D651it1J.js";
+import { n as registerGameplayBehaviors } from "./gameplay-02Btmmjn.js";
+import { t as registerNodes2D } from "./register-BNPZYJmd.js";
+import { n as registerNodes3D, t as resolveEnvironmentHdri } from "./environment-presets-CZOH5TY5.js";
+import { t as registerNodesNet } from "./register-CB11yp21.js";
 import { Box3, Euler, Matrix4, PerspectiveCamera, Quaternion, Vector3 } from "three";
 //#region src/test/framing.ts
 /**
@@ -38,6 +38,13 @@ const LIGHT_TYPES = new Set([
 	"OmniLight3D",
 	"SpotLight3D"
 ]);
+/** Screen-space subtrees: they ignore the camera, so framing has nothing to say. */
+const SCREEN_SPACE = new Set(["UILayer", "HudLayer"]);
+/** How far two colliders must actually interpenetrate to be a finding. */
+const TOUCH_EPS_2D = 1;
+const TOUCH_EPS_3D = .01;
+/** What a 2D scene shows when it declares neither a viewport nor a canvas. */
+const DEFAULT_VIEW_2D = [960, 540];
 /**
 * World transform for every node, composed from the tree.
 *
@@ -50,7 +57,11 @@ function place(scene) {
 		const type = node.constructor.typeName ?? "Node";
 		const n = node;
 		const local = new Matrix4();
-		if (Array.isArray(n.position)) local.compose(new Vector3(n.position[0] ?? 0, n.position[1] ?? 0, n.position[2] ?? 0), new Quaternion().setFromEuler(new Euler((n.rotation?.[0] ?? 0) * DEG, (n.rotation?.[1] ?? 0) * DEG, (n.rotation?.[2] ?? 0) * DEG, "XYZ")), new Vector3(n.scale?.[0] ?? 1, n.scale?.[1] ?? 1, n.scale?.[2] ?? 1));
+		if (Array.isArray(n.position)) {
+			const r = n.rotation;
+			const euler = typeof r === "number" ? new Euler(0, 0, r * DEG) : new Euler((r?.[0] ?? 0) * DEG, (r?.[1] ?? 0) * DEG, (r?.[2] ?? 0) * DEG, "XYZ");
+			local.compose(new Vector3(n.position[0] ?? 0, n.position[1] ?? 0, n.position[2] ?? 0), new Quaternion().setFromEuler(euler), new Vector3(n.scale?.[0] ?? 1, n.scale?.[1] ?? 1, n.scale?.[2] ?? 1));
+		}
 		const matrix = new Matrix4().multiplyMatrices(parent, local);
 		out.push({
 			node,
@@ -58,6 +69,7 @@ function place(scene) {
 			matrix,
 			position: new Vector3().setFromMatrixPosition(matrix)
 		});
+		if (SCREEN_SPACE.has(type)) return;
 		for (const child of node.children) walk(child, matrix);
 	};
 	walk(scene.root, new Matrix4());
@@ -74,6 +86,54 @@ function draws(node) {
 	return proto._createObject3D !== base._createObject3D;
 }
 /**
+* A 2D node draws something if its class puts pixels on its backing object.
+*
+* NOT `_createObject2D` — the 3D test's counterpart, and wrong here. 2D
+* drawables all inherit the plain container and hang a quad off it in
+* `_syncObject2D`, so the create hook is identical for a sprite and for a bare
+* `Node2D`, and testing it reports a scene full of sprites as drawing nothing.
+*/
+function draws2D(node) {
+	const proto = Object.getPrototypeOf(node);
+	let base = proto;
+	while (base && base.constructor?.typeName !== "Node2D") {
+		base = Object.getPrototypeOf(base);
+		if (!base) return false;
+	}
+	return proto._syncObject2D !== base._syncObject2D;
+}
+/**
+* A 2D node's half-size in pixels, and where its box hangs off the origin.
+*
+* Most 2D nodes are centred on their origin, but a `TileMap2D` hangs cell (0,0)
+* by its TOP-LEFT corner — a whole level reported as a point at its corner is
+* how you conclude the map is off screen when you are standing on it.
+*/
+function box2D(node) {
+	if ((node.constructor.typeName ?? "") === "TileMap2D") {
+		const map = node;
+		const rows = Array.isArray(map.cells) ? map.cells : [];
+		const cols = rows.reduce((n, r) => Math.max(n, String(r).length), 0);
+		const ts = map.tileSize ?? 32;
+		if (rows.length === 0 || cols === 0) return null;
+		const half = [cols * ts / 2, rows.length * ts / 2];
+		return {
+			half,
+			centre: half
+		};
+	}
+	const size = node.size;
+	if (Array.isArray(size) && typeof size[0] === "number" && typeof size[1] === "number") return {
+		half: [Math.abs(size[0]) / 2, Math.abs(size[1]) / 2],
+		centre: [0, 0]
+	};
+	const half = halfExtents(node);
+	return half ? {
+		half: [half.x, half.y],
+		centre: [0, 0]
+	} : null;
+}
+/**
 * How big the node is on screen, from whatever it declares.
 *
 * `size` first (a MeshInstance3D's box, a Terrain3D's ground), then a collider.
@@ -118,10 +178,110 @@ function halfExtents(node) {
 		const r = collider.radius ?? .5;
 		return new Vector3(r, (collider.height ?? 1) / 2 + r, r);
 	}
+	if (shape === "rect") {
+		const size = collider.size ?? [1, 1];
+		return new Vector3((size[0] ?? 1) / 2, (size[1] ?? 1) / 2, .5);
+	}
+	if (shape === "circle") {
+		const r = collider.radius ?? .5;
+		return new Vector3(r, r, .5);
+	}
 	return null;
 }
+/**
+* The same question in 2D: an orthographic window of design pixels, centred on
+* the Camera2D and CLAMPED by its limits.
+*
+* The clamp is not a detail — it is the whole point of `limits`, and a report
+* that skips it describes a view the renderer never draws. A following camera
+* sits at the player's y, which in a 544 px world is hundreds of pixels past
+* anything a 540 px window can show.
+*
+* With no camera at all a 2D scene still draws: the documented default view is
+* `(0,0)`–`(w,h)`, so "no camera" is not "nothing is framed" the way it is in 3D.
+*/
+function describeFraming2D(scene, placed, opts) {
+	const design = resolveViewport(scene.viewport)?.design;
+	const [vw, vh] = opts.viewport ?? design ?? DEFAULT_VIEW_2D;
+	const cameras = placed.filter((p) => p.type === "Camera2D");
+	const chosen = cameras.find((p) => p.node.current === true) ?? cameras[0] ?? null;
+	let camera = null;
+	let view = {
+		minX: 0,
+		minY: 0,
+		maxX: vw,
+		maxY: vh
+	};
+	if (chosen) {
+		const cam = chosen.node;
+		const zoom = Math.max(.01, cam.zoom ?? 1);
+		const halfW = vw / (2 * zoom);
+		const halfH = vh / (2 * zoom);
+		let cx = chosen.position.x;
+		let cy = chosen.position.y;
+		const limits = cam.limits ?? [];
+		if (limits.length === 4) {
+			const [minX, minY, maxX, maxY] = limits;
+			cx = clampCentred(cx, minX + halfW, maxX - halfW);
+			cy = clampCentred(cy, minY + halfH, maxY - halfH);
+		}
+		view = {
+			minX: cx - halfW,
+			minY: cy - halfH,
+			maxX: cx + halfW,
+			maxY: cy + halfH
+		};
+		camera = {
+			path: chosen.node.getPath(),
+			at: [
+				round(cx),
+				round(cy),
+				0
+			],
+			view: [vw, vh],
+			zoom
+		};
+	}
+	const wanted = opts.types ? new Set(opts.types) : null;
+	const centre = [(view.minX + view.maxX) / 2, (view.minY + view.maxY) / 2];
+	const entries = [];
+	for (const p of placed) {
+		if (p.type === "Camera2D") continue;
+		if (!(wanted ? wanted.has(p.type) : draws2D(p.node))) continue;
+		const b = box2D(p.node);
+		const cx = p.position.x + (b?.centre[0] ?? 0);
+		const cy = p.position.y + (b?.centre[1] ?? 0);
+		const hx = b?.half[0] ?? 0;
+		const hy = b?.half[1] ?? 0;
+		const onScreen = cx + hx >= view.minX && cx - hx <= view.maxX && cy + hy >= view.minY && cy - hy <= view.maxY;
+		entries.push({
+			path: p.node.getPath(),
+			type: p.type,
+			at: [
+				round(p.position.x),
+				round(p.position.y),
+				0
+			],
+			where: onScreen ? "onScreen" : "offscreen",
+			screen: [round((cx - centre[0]) / ((view.maxX - view.minX) / 2)), round((cy - centre[1]) / ((view.maxY - view.minY) / 2))],
+			distance: round(Math.hypot(cx - centre[0], cy - centre[1]))
+		});
+	}
+	return {
+		dimension: "2d",
+		camera,
+		entries,
+		lights: [],
+		overlaps: findOverlaps(placed, TOUCH_EPS_2D)
+	};
+}
+function clampCentred(v, lo, hi) {
+	if (lo > hi) return (lo + hi) / 2;
+	return Math.min(hi, Math.max(lo, v));
+}
 function describeFraming(scene, opts = {}) {
 	const placed = place(scene);
+	if (scene.dimension === "2d") return describeFraming2D(scene, placed, opts);
 	const cameras = placed.filter((p) => CAMERA_TYPES.has(p.type));
 	const chosen = cameras.find((p) => p.node.current === true) ?? cameras[0] ?? null;
 	const lights = [];
@@ -185,10 +345,11 @@ function describeFraming(scene, opts = {}) {
 		}
 	}
 	return {
+		dimension: "3d",
 		camera,
 		entries,
 		lights,
-		overlaps: findOverlaps(placed)
+		overlaps: findOverlaps(placed, TOUCH_EPS_3D)
 	};
 }
 function cornersOnScreen(box, cam) {
@@ -207,14 +368,16 @@ function cornersOnScreen(box, cam) {
 * no loaded model — and a prop buried inside a platform is the thing you were
 * trying to see anyway.
 */
-function findOverlaps(placed) {
+function findOverlaps(placed, epsilon) {
 	const boxes = [];
 	for (const p of placed) {
 		const half = halfExtents(p.node);
 		if (!half) continue;
+		const shrunk = half.clone().multiplyScalar(2).addScalar(-2 * epsilon);
 		boxes.push({
 			path: p.node.getPath(),
-			box: new Box3().setFromCenterAndSize(p.position, half.clone().multiplyScalar(2))
+			internal: p.node.name.startsWith("__"),
+			box: new Box3().setFromCenterAndSize(p.position, shrunk.max(new Vector3(0, 0, 0)))
 		});
 	}
 	const out = [];
@@ -223,6 +386,7 @@ function findOverlaps(placed) {
 		const b = boxes[j];
 		if (!a || !b) continue;
 		if (a.path.startsWith(`${b.path}/`) || b.path.startsWith(`${a.path}/`)) continue;
+		if (a.internal && b.internal) continue;
 		if (a.box.intersectsBox(b.box)) out.push({
 			a: a.path,
 			b: b.path
@@ -236,26 +400,41 @@ function round(n) {
 /** The report as something to read in a terminal. */
 function framingText(report) {
 	const lines = [];
-	if (!report.camera) lines.push("camera: NONE — this scene frames nothing (no Camera3D)");
-	else {
-		const c = report.camera;
-		lines.push(`camera ${c.path} at [${c.at.map(round).join(", ")}] looking [${c.forward.join(", ")}] fov ${c.fovDeg}`);
-	}
-	lines.push(report.lights.length ? `lit by: ${report.lights.join(", ")}` : "lit by: NOTHING — this scene renders black");
+	const is2d = report.dimension === "2d";
+	const unit = is2d ? "px" : "m";
+	const c = report.camera;
+	if (c && is2d) {
+		const [vw = 0, vh = 0] = c.view ?? [];
+		const zoom = c.zoom === 1 ? "" : ` zoom ${c.zoom}`;
+		lines.push(`camera ${c.path} centred [${c.at[0]}, ${c.at[1]}] showing ${vw}×${vh}px${zoom}`);
+	} else if (c) lines.push(`camera ${c.path} at [${c.at.map(round).join(", ")}] looking [${(c.forward ?? []).join(", ")}] fov ${c.fovDeg}`);
+	else if (is2d) lines.push("camera: NONE — the view is (0,0)–(design), which may be intentional");
+	else lines.push("camera: NONE — this scene frames nothing (no Camera3D)");
+	if (!is2d) lines.push(report.lights.length ? `lit by: ${report.lights.join(", ")}` : "lit by: NOTHING — this scene renders black");
 	const on = report.entries.filter((e) => e.where === "onScreen");
 	const off = report.entries.filter((e) => e.where === "offscreen");
 	const behind = report.entries.filter((e) => e.where === "behind");
-	lines.push(`${on.length} on screen, ${off.length} off screen, ${behind.length} behind the camera`);
+	lines.push(is2d ? `${on.length} in view, ${off.length} outside it` : `${on.length} on screen, ${off.length} off screen, ${behind.length} behind the camera`);
 	for (const e of report.entries) {
-		const at = `[${e.at.map(round).join(", ")}]`;
+		const at = `[${(is2d ? e.at.slice(0, 2) : e.at).map(round).join(", ")}]`;
 		const screen = e.screen ? ` screen [${e.screen.join(", ")}]` : "";
-		lines.push(`  ${e.where.padEnd(9)} ${e.path} (${e.type}) ${at}${screen} ${e.distance}m`);
+		lines.push(`  ${e.where.padEnd(9)} ${e.path} (${e.type}) ${at}${screen} ${e.distance}${unit}`);
 	}
 	for (const o of report.overlaps) lines.push(`  overlap  ${o.a} ∩ ${o.b}`);
 	return lines.join("\n");
 }
 //#endregion
 //#region src/test/playtest.ts
+/**
+* Out of the world, in pixels — about two screens under the spawn.
+*
+* Generous on purpose: a player who has actually left the level is falling
+* forever, so a far line costs a few frames and never mistakes a long drop
+* down a shaft for one.
+*/
+const FALL_2D_PX = 1e3;
+/** "Reached it", in pixels — one 32 px tile, next to a ~34 px character. */
+const REACH_2D_PX = 32;
 const CONTROLLERS = new Set(["CharacterController2D", "CharacterController3D"]);
 /**
 * Who the driver is playing as.
@@ -499,8 +678,9 @@ async function runOnce(json, seed, opts) {
 		0,
 		0
 	];
-	const floor = opts.fallBelow ?? start[1] - 50;
-	const radius = opts.reachRadius ?? 2;
+	const down = scene.dimension === "2d" ? 1 : -1;
+	const floor = opts.fallBelow ?? start[1] + down * (down > 0 ? FALL_2D_PX : 50);
+	const radius = opts.reachRadius ?? (down > 0 ? REACH_2D_PX : 2);
 	const recorder = startRecording(engine);
 	const rand = () => engine.rng.next();
 	const driver = new Driver(engine, rand);
@@ -527,7 +707,7 @@ async function runOnce(json, seed, opts) {
 			outcome = "error";
 			break;
 		}
-		if (player && at[1] < floor) {
+		if (player && (at[1] - floor) * down > 0) {
 			outcome = "fell";
 			break;
 		}
@@ -584,7 +764,8 @@ async function playtest(json, opts = {}) {
 		signals: [...new Set(signals)],
 		actions,
 		inertActions: [],
-		declaresWin
+		declaresWin,
+		seconds: opts.seconds ?? 60
 	};
 }
 function pct(n, total) {
@@ -605,8 +786,7 @@ function playtestText(report) {
 	const { runs, targets, signals } = report;
 	const total = runs.length;
 	const lines = [];
-	const secs = Math.round((runs[0]?.timeMs ?? 0) / 1e3);
-	lines.push(`${total} runs × up to ${secs}s`);
+	lines.push(`${total} runs × up to ${report.seconds}s`);
 	lines.push("");
 	const won = runs.filter((r) => r.outcome === "won");
 	if (won.length > 0) lines.push(`  ✓ reached "won" in ${pct(won.length, total)}   median ${Math.round(median(won.map((r) => r.timeMs)) / 1e3)}s`);
@@ -1414,10 +1594,10 @@ async function runScript(json, opts) {
 	engine.setScene(scene);
 	const physics = opts.physics ?? "auto";
 	if (physics === "2d" || physics === "auto" && scene.dimension === "2d") {
-		const { enablePhysics2D } = await import("./physics-2d-BmgXBNDB.js").then((n) => n.r);
+		const { enablePhysics2D } = await import("./physics-2d-vyCBfACH.js").then((n) => n.r);
 		await enablePhysics2D(engine);
 	} else if (physics === "3d" || physics === "auto" && scene.dimension === "3d") {
-		const { enablePhysics3D } = await import("./physics-3d-CSoGjM8P.js").then((n) => n.r);
+		const { enablePhysics3D } = await import("./physics-3d-DpRqw8Mz.js").then((n) => n.r);
 		await enablePhysics3D(engine);
 	}
 	const failures = [];
@@ -1530,10 +1710,10 @@ async function createPlaySession(json, opts = {}) {
 	engine.setScene(scene);
 	const physics = opts.physics ?? "auto";
 	if (physics === "2d" || physics === "auto" && scene.dimension === "2d") {
-		const { enablePhysics2D } = await import("./physics-2d-BmgXBNDB.js").then((n) => n.r);
+		const { enablePhysics2D } = await import("./physics-2d-vyCBfACH.js").then((n) => n.r);
 		await enablePhysics2D(engine);
 	} else if (physics === "3d" || physics === "auto" && scene.dimension === "3d") {
-		const { enablePhysics3D } = await import("./physics-3d-CSoGjM8P.js").then((n) => n.r);
+		const { enablePhysics3D } = await import("./physics-3d-DpRqw8Mz.js").then((n) => n.r);
 		await enablePhysics3D(engine);
 	}
 	const stepMs = 1e3 / (opts.fixedHz ?? 60);

package/dist/test.d.ts

@@ -52,12 +52,23 @@ interface FramingEntry {
   distance: number;
 }
 interface FramingReport {
-  /** Null when the scene declares no 3D camera — nothing frames anything. */
+  /**
+  * Which report this is. The question is the same — can the camera see it —
+  * but the machinery and the UNITS are not: 3D projects a perspective frustum
+  * and measures metres, 2D clips an orthographic window and measures pixels.
+  */
+  dimension: "2d" | "3d";
+  /**
+  * 3D: null when the scene declares no camera — nothing frames anything.
+  * 2D: null means the documented default view, `(0,0)`–`(design)`.
+  */
   camera: {
     path: string;
-    at: [number, number, number]; /** Unit vector the camera points along. */
-    forward: [number, number, number];
-    fovDeg: number;
+    at: [number, number, number]; /** 3D: the unit vector it points along. Absent in 2D. */
+    forward?: [number, number, number]; /** 3D only. */
+    fovDeg?: number; /** 2D only: world pixels visible, after `zoom`. */
+    view?: [number, number]; /** 2D only. */
+    zoom?: number;
   } | null;
   entries: FramingEntry[];
   /**
@@ -76,6 +87,11 @@ interface FramingOptions {
   aspect?: number;
   /** Report only these node types (default: everything that draws). */
   types?: readonly string[];
+  /**
+  * 2D only: the window in world pixels. Defaults to the scene's
+  * `viewport.design`, then 960×540 — headless there is no canvas to ask.
+  */
+  viewport?: readonly [number, number];
 }
 declare function describeFraming(scene: Scene, opts?: FramingOptions): FramingReport;
 /** The report as something to read in a terminal. */
@@ -133,9 +149,16 @@ interface PlaytestOptions {
   behaviors?: Record<string, BehaviorCtor>;
   stubMissingBehaviors?: boolean;
   resolveScene?: LoadSceneOptions["resolveScene"];
-  /** Y below which the player has left the world. Default: 50 under the start. */
+  /**
+  * The y past which the player has left the world, in the SCENE's own
+  * direction: 3D counts down (−y), 2D counts down the screen (+y).
+  * Default: 50 m under the start in 3D, 1000 px under it in 2D.
+  */
   fallBelow?: number;
-  /** How close counts as "reached", in world units. Default 2. */
+  /**
+  * How close counts as "reached", in the scene's own units. Default 2 (metres)
+  * in 3D, 32 (pixels — one tile) in 2D.
+  */
   reachRadius?: number;
 }
 interface PlaytestRun {
@@ -174,6 +197,15 @@ interface PlaytestReport {
   * author looking for a bug that was never there.
   */
   declaresWin: boolean;
+  /**
+  * The per-run clock the caller asked for, in simulated seconds.
+  *
+  * The header used to read this off the FIRST run's length, which is the one
+  * number guaranteed to be wrong when something ends runs early: a 60-second
+  * playtest whose every run died at a second announced itself as "20 runs ×
+  * up to 1s", hiding the very fact it was reporting.
+  */
+  seconds: number;
 }
 /**
 * Who the driver is playing as.

package/dist/test.js

@@ -1,3 +1,3 @@
-import { r as auditScene } from "./replay-DilbZgQI.js";
-import { _ as playtestText, a as registerAllNodes, c as ladderText, d as feelText, f as facingReport, g as playtest, h as findPlayer, i as findFloatingProps, l as ladderVerdict, m as failingReplays, n as createPlaySession, o as runScript, p as facingText, r as describeCapture, s as validateScene, t as captureScene, u as feelReport, v as describeFraming, y as framingText } from "./test-E4-otKqK.js";
+import { r as auditScene } from "./replay-C0XJIsO7.js";
+import { _ as playtestText, a as registerAllNodes, c as ladderText, d as feelText, f as facingReport, g as playtest, h as findPlayer, i as findFloatingProps, l as ladderVerdict, m as failingReplays, n as createPlaySession, o as runScript, p as facingText, r as describeCapture, s as validateScene, t as captureScene, u as feelReport, v as describeFraming, y as framingText } from "./test-DRna_BQU.js";
 export { auditScene, captureScene, createPlaySession, describeCapture, describeFraming, facingReport, facingText, failingReplays, feelReport, feelText, findFloatingProps, findPlayer, framingText, ladderText, ladderVerdict, playtest, playtestText, registerAllNodes, runScript, validateScene };

package/dist/vite.js

@@ -1,6 +1,6 @@
-import { t as VERSION } from "./src-Ca3oV1fe.js";
+import { t as VERSION } from "./src-DF4gCsqO.js";
 import { n as diffSignatures } from "./frame-report-njybhZon.js";
-import { s as validateScene } from "./test-E4-otKqK.js";
+import { s as validateScene } from "./test-DRna_BQU.js";
 import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
 import { basename, dirname, join, normalize, relative, resolve, sep } from "node:path";
 //#region src/vite/frame-endpoint.ts
@@ -60,6 +60,7 @@ function serveFrameEndpoints(host, version, opts = {}) {
 	for (const c of channels) {
 		c.on("incanto:frame-report", onReport);
 		c.on("incanto:frame-ack", onAck);
+		c.on("incanto:logs-report", onReport);
 	}
 	host.middlewares.use("/__incanto/ping", (_req, res) => {
 		json$1(res, 200, {
@@ -67,6 +68,7 @@ function serveFrameEndpoints(host, version, opts = {}) {
 			frame: Boolean(channel)
 		});
 	});
+	serveLogs(host, channels, waiting, () => nextId++, timeoutMs);
 	host.middlewares.use("/__incanto/frame", (req, res) => {
 		if (!channel) {
 			json$1(res, 503, { error: "no-hmr-channel" });
@@ -78,11 +80,13 @@ function serveFrameEndpoints(host, version, opts = {}) {
 		const threshold = Number(params.get("threshold"));
 		const grid = parseGrid(params.get("grid"));
 		const image = Math.max(0, Math.min(2048, Number(params.get("image")) || 0));
+		const drive = params.get("drive") ?? "";
+		const driveMs = Math.max(0, Math.min(12e4, Number(params.get("driveMs")) || 0));
 		const id = nextId++;
 		const timer = setTimeout(() => {
 			waiting.delete(id);
 			json$1(res, 504, { error: acked.delete(id) ? "page-not-drawing" : "no-page-connected" });
-		}, timeoutMs);
+		}, timeoutMs + (driveMs > 0 ? driveMs * 2 + 2e3 : 0));
 		waiting.set(id, (value) => {
 			clearTimeout(timer);
 			acked.delete(id);
@@ -113,11 +117,44 @@ function serveFrameEndpoints(host, version, opts = {}) {
 			data: {
 				id,
 				grid,
-				image
+				image,
+				...drive ? { drive } : {}
 			}
 		});
 	});
 }
+/**
+* `/__incanto/logs` — what the game is SAYING, not what it looks like.
+*
+* Same round trip as a frame and a different question. It needs no render, so
+* unlike a frame it answers from a tab the browser has stopped drawing.
+*/
+function serveLogs(host, channels, waiting, nextId, timeoutMs) {
+	host.middlewares.use("/__incanto/logs", (_req, res) => {
+		if (channels.length === 0) {
+			json$1(res, 503, { error: "no-hmr-channel" });
+			return;
+		}
+		const id = nextId();
+		const timer = setTimeout(() => {
+			waiting.delete(id);
+			json$1(res, 504, { error: "no-page-connected" });
+		}, timeoutMs);
+		waiting.set(id, (value) => {
+			clearTimeout(timer);
+			if (!value.ok) {
+				json$1(res, 500, { error: "report-failed" });
+				return;
+			}
+			json$1(res, 200, { report: value.report });
+		});
+		for (const c of channels) c.send({
+			type: "custom",
+			event: "incanto:logs-request",
+			data: { id }
+		});
+	});
+}
 function query(req) {
 	const url = req?.originalUrl ?? req?.url ?? "";
 	const q = url.indexOf("?");

package/editor/assets/{agent8-_007gPF8.js → agent8-DCW4TgDt.js}

@@ -1 +1 @@
-import{n as e}from"./index-B-6eYZEi.js";async function t(t){return new n((await e(()=>import(`./GameServer-C56iOUgF.js`),[],import.meta.url)).GameServer,t)}var n=class{raw;active=new Map;reconnecting=!1;disposed=!1;constructor(e,t){this.raw=new e({...t})}get account(){return this.raw.account}get connected(){return this.raw.connected}connect(){return this.raw.connected?Promise.resolve(!0):(this.disposed=!1,this.rawConnect())}rawConnect(){return this.raw.connect({onDisconnect:()=>void this.reconnect()})}disconnect(){this.disposed=!0;for(let e of this.active.values())e.off();return this.active.clear(),this.raw.disconnect()}remoteFunction(e,t,n){return this.raw.remoteFunction(e,t,n)}track(e){let t=Symbol(`sub`),n={make:e,off:e()};return this.active.set(t,n),()=>{n.off(),this.active.delete(t)}}async reconnect(){if(!this.disposed&&!this.reconnecting){this.reconnecting=!0;try{await this.rawConnect();for(let e of this.active.values())e.off(),e.off=e.make()}finally{this.reconnecting=!1}}}subscribeRoomState(e,t){return this.track(()=>this.raw.subscribeRoomState(e,t))}subscribeRoomMyState(e,t){return this.track(()=>this.raw.subscribeRoomMyState(e,t))}subscribeRoomAllUserStates(e,t){return this.track(()=>this.raw.subscribeRoomAllUserStates(e,e=>{let n={};for(let t of e??[]){if(!t||typeof t.account!=`string`||t.__leaved)continue;let{account:e,__updated:r,__leaved:i,...a}=t;n[e]=a}t(n)}))}subscribeRoomCollection(e,t,n){return this.track(()=>this.raw.subscribeRoomCollection(e,t,({items:e})=>{let t={};for(let n of e??[])n&&typeof n.__id==`string`&&(t[n.__id]=n);n(t)}))}onRoomMessage(e,t,n){return this.track(()=>this.raw.onRoomMessage(e,t,n))}onRoomUserJoin(e,t){return this.track(()=>this.raw.onRoomUserJoin(e,t))}onRoomUserLeave(e,t){return this.track(()=>this.raw.onRoomUserLeave(e,t))}subscribeGlobalState(e){return this.track(()=>this.raw.subscribeGlobalState(e))}subscribeGlobalMyState(e){return this.track(()=>this.raw.subscribeGlobalMyState(e))}subscribeGlobalUserState(e,t){return this.track(()=>this.raw.subscribeGlobalUserState(e,t))}subscribeGlobalCollection(e,t){return this.track(()=>this.raw.subscribeGlobalCollection(e,({items:e})=>{let n={};for(let t of e??[])t&&typeof t.__id==`string`&&(n[t.__id]=t);t(n)}))}subscribeAsset(e,t){return this.track(()=>this.raw.subscribeAsset(e,t))}onGlobalMessage(e,t){return this.track(()=>this.raw.onGlobalMessage(e,t))}};export{t as createAgent8Server};
+import{n as e}from"./index-5dEIhvsf.js";async function t(t){return new n((await e(()=>import(`./GameServer-C56iOUgF.js`),[],import.meta.url)).GameServer,t)}var n=class{raw;active=new Map;reconnecting=!1;disposed=!1;constructor(e,t){this.raw=new e({...t})}get account(){return this.raw.account}get connected(){return this.raw.connected}connect(){return this.raw.connected?Promise.resolve(!0):(this.disposed=!1,this.rawConnect())}rawConnect(){return this.raw.connect({onDisconnect:()=>void this.reconnect()})}disconnect(){this.disposed=!0;for(let e of this.active.values())e.off();return this.active.clear(),this.raw.disconnect()}remoteFunction(e,t,n){return this.raw.remoteFunction(e,t,n)}track(e){let t=Symbol(`sub`),n={make:e,off:e()};return this.active.set(t,n),()=>{n.off(),this.active.delete(t)}}async reconnect(){if(!this.disposed&&!this.reconnecting){this.reconnecting=!0;try{await this.rawConnect();for(let e of this.active.values())e.off(),e.off=e.make()}finally{this.reconnecting=!1}}}subscribeRoomState(e,t){return this.track(()=>this.raw.subscribeRoomState(e,t))}subscribeRoomMyState(e,t){return this.track(()=>this.raw.subscribeRoomMyState(e,t))}subscribeRoomAllUserStates(e,t){return this.track(()=>this.raw.subscribeRoomAllUserStates(e,e=>{let n={};for(let t of e??[]){if(!t||typeof t.account!=`string`||t.__leaved)continue;let{account:e,__updated:r,__leaved:i,...a}=t;n[e]=a}t(n)}))}subscribeRoomCollection(e,t,n){return this.track(()=>this.raw.subscribeRoomCollection(e,t,({items:e})=>{let t={};for(let n of e??[])n&&typeof n.__id==`string`&&(t[n.__id]=n);n(t)}))}onRoomMessage(e,t,n){return this.track(()=>this.raw.onRoomMessage(e,t,n))}onRoomUserJoin(e,t){return this.track(()=>this.raw.onRoomUserJoin(e,t))}onRoomUserLeave(e,t){return this.track(()=>this.raw.onRoomUserLeave(e,t))}subscribeGlobalState(e){return this.track(()=>this.raw.subscribeGlobalState(e))}subscribeGlobalMyState(e){return this.track(()=>this.raw.subscribeGlobalMyState(e))}subscribeGlobalUserState(e,t){return this.track(()=>this.raw.subscribeGlobalUserState(e,t))}subscribeGlobalCollection(e,t){return this.track(()=>this.raw.subscribeGlobalCollection(e,({items:e})=>{let n={};for(let t of e??[])t&&typeof t.__id==`string`&&(n[t.__id]=t);t(n)}))}subscribeAsset(e,t){return this.track(()=>this.raw.subscribeAsset(e,t))}onGlobalMessage(e,t){return this.track(()=>this.raw.onGlobalMessage(e,t))}};export{t as createAgent8Server};