incanto 0.56.0 → 0.58.0

package/dist/{replay-ePMz26jw.d.ts → replay-Dw6gMlYA.d.ts}

@@ -1,4 +1,4 @@
-import { b as Engine } from "./behavior-CyQoSu4n.js";
+import { b as Engine } from "./behavior-l08AEbq9.js";
 import { s as JsonObject } from "./schema-CFeioQRE.js";
 
 //#region src/core/audit.d.ts

package/dist/{replay-t1pP0gQg.js → replay-s7I2GstT.js}

@@ -1,6 +1,6 @@
-import { E as behaviorSchema, w as parseNodePath } from "./loader-BTkHYrQn.js";
-import { P as translationKey } from "./register-p48lHE2o.js";
-import { i as getNodeSchema } from "./registry-C7u42TID.js";
+import { E as behaviorSchema, w as parseNodePath } from "./loader-BcrRSjxB.js";
+import { D as HudWidgetBase, F as translationKey } from "./register-Ch70uByv.js";
+import { i as getNodeSchema, o as getNodeType } from "./registry-C7u42TID.js";
 //#region src/core/node-refs.ts
 /**
 * Node-path PROPS, resolved against scene JSON.
@@ -211,13 +211,33 @@ const BODY_TYPES = new Set([
 	"Area3D",
 	"CharacterBody3D"
 ]);
-const HUD_WIDGETS = new Set([
-	"UiText",
-	"UiBar",
-	"UiBanner",
-	"UiButton",
-	"UiDialogue"
-]);
+/**
+* Is this node type a HUD widget — one that renders NOTHING outside a HudLayer?
+*
+* This used to be a hand-written list of five, and the kit has sixteen. It went
+* stale the moment UiPanel landed, so the settings menu in the performance
+* skill and the volume menu in the audio skill — both bare `UiPanel`s of
+* uncovered widgets — drew a blank screen while `incanto-check` printed `ok`.
+* The runtime is silent by design (`hud.ts`: `if (!host) return;`), which is
+* exactly why the lint has to be right.
+*
+* Derived from the class hierarchy instead: anything descending from
+* `HudWidgetBase` is one, whatever it is called and whenever it was added.
+*/
+function isHudWidget(type) {
+	if (type.startsWith("Ui")) return true;
+	let ctor;
+	try {
+		ctor = getNodeType(type);
+	} catch {
+		return false;
+	}
+	for (let c = ctor; c; c = Object.getPrototypeOf(c)) {
+		if (c.typeName === "HudWidgetBase") return true;
+		if (c === HudWidgetBase) return true;
+	}
+	return false;
+}
 const LIGHT_TYPES = new Set([
 	"DirectionalLight3D",
 	"OmniLight3D",
@@ -269,7 +289,7 @@ function auditScene(scene) {
 			const collider = props.collider;
 			if (!collider || collider.shape === void 0) warnings.push(`${path}: ${type} has no collider — physics will skip it (add "collider": { "shape": ... }).`);
 		}
-		if (HUD_WIDGETS.has(type) && !insideHud) warnings.push(`${path}: ${type} works only as a descendant of a HudLayer — it will not render.`);
+		if (isHudWidget(type) && !insideHud) warnings.push(`${path}: ${type} works only as a descendant of a HudLayer — it will not render.`);
 		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";

package/dist/sheet-grid-BT6N_Bjs.js

@@ -0,0 +1,59 @@
+//#region src/core/sheet-grid.ts
+/**
+* Does this spritesheet's grid actually fit the image?
+*
+* `frameWidth`/`frameHeight` are taken on trust, and the frame math floors the
+* division — so a frame size that does not divide the sheet slices every row a
+* little further off, and an animation naming a frame past the end of the grid
+* reads whatever texels are there. Both draw WRONG ART with no error anywhere,
+* which is the one symptom an author cannot tell apart from having picked the
+* wrong sheet in the first place.
+*
+* Pure arithmetic on numbers that are known the moment the image loads, so it
+* costs nothing and it is exact.
+*
+* It lives in core because THREE nodes do this division — AnimatedSprite2D,
+* AnimatedSprite3D and TileMap2D — and for a while the checker sat in `2d/`
+* where only one of them could see it. A checker one directory away from the
+* bug it catches is the same as no checker.
+*/
+/**
+* Frame sizes that divide `total` cleanly, biggest first.
+*
+* Bounded to grids of 2–32 cells so the suggestion is a frame size someone
+* might actually have meant, not every factor of the number.
+*/
+function divisors(total) {
+	const out = [];
+	for (let cells = 2; cells <= 32; cells++) if (total % cells === 0) out.push(total / cells);
+	return out.sort((a, b) => b - a).slice(0, 6);
+}
+/**
+* The problem with this grid, or null when there is none.
+*
+* `highestFrame` is the largest frame index the scene asks for, when it is
+* known — an animation range that runs off the end is the other half of the
+* same mistake.
+*/
+function checkSheetGrid(key, frameWidth, frameHeight, imageWidth, imageHeight, highestFrame) {
+	if (!imageWidth || !imageHeight || !frameWidth || !frameHeight) return null;
+	if (imageWidth % frameWidth !== 0 || imageHeight % frameHeight !== 0) {
+		const parts = [];
+		if (imageWidth % frameWidth !== 0) {
+			const fits = divisors(imageWidth);
+			parts.push(`${imageWidth} px wide is not a whole number of ${frameWidth} px frames` + (fits.length > 0 ? ` (${fits.join(", ")} would divide it)` : ""));
+		}
+		if (imageHeight % frameHeight !== 0) {
+			const fits = divisors(imageHeight);
+			parts.push(`${imageHeight} px tall is not a whole number of ${frameHeight} px frames` + (fits.length > 0 ? ` (${fits.join(", ")} would divide it)` : ""));
+		}
+		return `[incanto] spritesheet '${key}' does not fit its frame size: ${parts.join("; ")}. Every row after the first is cut off centre.`;
+	}
+	if (highestFrame !== void 0) {
+		const frames = imageWidth / frameWidth * (imageHeight / frameHeight);
+		if (highestFrame >= frames) return `[incanto] spritesheet '${key}' has ${frames} frames (0–${frames - 1}), and an animation asks for frame ${highestFrame}. Those frames draw whatever is at the wrong end of the sheet.`;
+	}
+	return null;
+}
+//#endregion
+export { checkSheetGrid as t };

package/dist/{split-screen-BsdOHbzP.d.ts → split-screen-B0baBwxI.d.ts}

@@ -1,4 +1,4 @@
-import { At as Node, It as Signal, b as Engine } from "./behavior-CyQoSu4n.js";
+import { At as Node, It as Signal, b as Engine } from "./behavior-l08AEbq9.js";
 import { c as JsonValue, i as SceneJson, s as JsonObject } from "./schema-CFeioQRE.js";
 
 //#region src/net/types.d.ts
@@ -317,6 +317,10 @@ declare class NetworkManager {
   private readonly latestGlobalCollections;
   private readonly scenes;
   private readonly lastSent;
+  /** Sync keys already reported unreadable, so a per-frame send says it once. */
+  private readonly reportedDeadKeys;
+  /** Name a sync key the owner cannot read — a typo in the prop or the path. */
+  private reportDeadSyncKey;
   private sendAccumulator;
   private detachReplication;
   private lastOwner;

package/dist/{split-screen-CSb_uZ6W.js → split-screen-DLsUrleX.js}

@@ -1,5 +1,5 @@
-import { C as diagnose, M as Signal, f as Node, n as loadScene, t as buildNodeJson } from "./loader-BTkHYrQn.js";
-import { t as registerCoreNodes, x as Engine } from "./register-p48lHE2o.js";
+import { C as diagnose, M as Signal, S as Node, n as loadScene, t as buildNodeJson } from "./loader-BcrRSjxB.js";
+import { _ as Engine, t as registerCoreNodes } from "./register-Ch70uByv.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { n as jsonEquals, t as jsonClone } from "./json-BLk7H2Qa.js";
 import { l as registerNode } from "./registry-C7u42TID.js";
@@ -811,6 +811,14 @@ var NetworkManager = class NetworkManager {
 	latestGlobalCollections = /* @__PURE__ */ new Map();
 	scenes = /* @__PURE__ */ new Map();
 	lastSent = /* @__PURE__ */ new Map();
+	/** Sync keys already reported unreadable, so a per-frame send says it once. */
+	reportedDeadKeys = /* @__PURE__ */ new Set();
+	/** Name a sync key the owner cannot read — a typo in the prop or the path. */
+	reportDeadSyncKey(owner, key) {
+		if (this.reportedDeadKeys.has(key)) return;
+		this.reportedDeadKeys.add(key);
+		diagnose(owner.tree?.engine ?? null, "error", `[incanto] ${owner.getPath()}: sync key '${key}' reads as undefined — it is never sent, so remote players never see it change. Check the prop name and the node path.`);
+	}
 	sendAccumulator = 0;
 	detachReplication = null;
 	lastOwner = null;
@@ -1000,7 +1008,10 @@ var NetworkManager = class NetworkManager {
 		const patch = {};
 		for (const key of syncKeys) {
 			const value = readSyncKey(owner, key);
-			if (value === void 0) continue;
+			if (value === void 0) {
+				this.reportDeadSyncKey(owner, key);
+				continue;
+			}
 			if (!jsonEquals(this.lastSent.get(key) ?? null, value)) patch[key] = jsonClone(value);
 		}
 		if (this.sendAccumulator < window) return;

package/dist/{sprite-animation-7qvUxF6Z.js → sprite-animation-C0wXLBZJ.js}

@@ -306,10 +306,14 @@ function resolveAnimation(animations, name, owner) {
 			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 (typeof entry !== "string") {
+			const frames = resolveFrames(entry.frames, key);
+			if (frames.length > 1 && !(Number.isFinite(entry.fps) && entry.fps > 0)) throw new IncantoError("BAD_FORMAT", `Animation '${key}' on '${owner}' has ${frames.length} frames and no "fps" — it would sit on the first one forever. Add "fps" (the field is fps, not frameRate or speed).`);
+			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;

package/dist/{src-51GA-9m-.js → src-C1J09Op6.js}

@@ -143,6 +143,59 @@ async function preloadUrls(urls, onProgress) {
 function assetUrls(assets) {
 	return Object.values(assets ?? {}).map((a) => a.url).filter((u) => typeof u === "string" && !u.startsWith("data:"));
 }
+/**
+* The standard boot screen every template hand-rolled (~125 identical lines
+* of HTML+CSS): black overlay, "Loading" title, progress track + percent.
+* Headless it returns inert no-ops.
+*/
+function createLoadingOverlay(title = "Loading") {
+	if (typeof document === "undefined") return {
+		setProgress: () => {},
+		remove: () => {}
+	};
+	const wrap = document.createElement("div");
+	wrap.style.cssText = "position:fixed;inset:0;z-index:10000;display:flex;flex-direction:column;align-items:center;justify-content:center;background:#000;color:#fff;font:600 15px system-ui, -apple-system, 'Segoe UI', sans-serif;transition:opacity .3s;";
+	const h = document.createElement("div");
+	h.textContent = title;
+	h.style.cssText = "font-size:1.5rem;font-weight:700;margin-bottom:1rem;";
+	const track = document.createElement("div");
+	track.style.cssText = "width:256px;height:8px;background:#374151;border-radius:9999px;overflow:hidden;";
+	const fill = document.createElement("div");
+	fill.style.cssText = "width:0%;height:100%;background:#3b82f6;transition:width .3s;";
+	track.appendChild(fill);
+	const pct = document.createElement("div");
+	pct.textContent = "0%";
+	pct.style.cssText = "margin-top:.5rem;font-size:.9rem;";
+	wrap.append(h, track, pct);
+	document.body.appendChild(wrap);
+	let removed = false;
+	return {
+		setProgress(done, total) {
+			const p = total > 0 ? Math.min(100, Math.round(done / total * 100)) : 100;
+			fill.style.width = `${p}%`;
+			pct.textContent = `${p}%`;
+		},
+		remove() {
+			if (removed) return;
+			removed = true;
+			wrap.style.opacity = "0";
+			setTimeout(() => wrap.remove(), 320);
+		}
+	};
+}
+/**
+* Preload every scene-asset URL behind the standard overlay, then remove it:
+*
+*   await preloadSceneAssets(sceneJson.assets);
+*/
+async function preloadSceneAssets(assets, title) {
+	const overlay = createLoadingOverlay(title);
+	try {
+		await preloadUrls(assetUrls(assets), (done, total) => overlay.setProgress(done, total));
+	} finally {
+		overlay.remove();
+	}
+}
 //#endregion
 //#region src/core/uid-gen.ts
 /**
@@ -161,6 +214,6 @@ function newUid() {
 //#endregion
 //#region src/index.ts
 /** Engine version. Kept in sync with package.json by the release pipeline. */
-const VERSION = "0.56.0";
+const VERSION = "0.58.0";
 //#endregion
-export { findPath as a, preloadUrls as i, newUid as n, gridFromRows as o, assetUrls as r, VERSION as t };
+export { preloadUrls as a, preloadSceneAssets as i, newUid as n, findPath as o, assetUrls as r, gridFromRows as s, VERSION as t };

package/dist/{teardown-C7uVSJvx.js → teardown-Cs113S9F.js}

@@ -1,4 +1,6 @@
-import { b as AudioPlayer } from "./register-p48lHE2o.js";
+import { g as AudioPlayer } from "./register-Ch70uByv.js";
+import { a as logReport, s as parseDrive } from "./touch-DESwnpOc.js";
+import { a as frameSignature, i as frameImage, o as frameStats } from "./frame-report-BSMny7oe.js";
 //#region src/core/audio-errors.ts
 /** Every AudioPlayer under `root` whose source could not be played. */
 function audioErrors(root) {
@@ -27,6 +29,76 @@ function claimCanvasGestures(canvas) {
 	style.webkitTapHighlightColor = "transparent";
 }
 //#endregion
+//#region src/core/dev-channel.ts
+/**
+* Answer the dev server's frame/log requests. Returns the unsubscribes, or an
+* empty list outside a dev server.
+*/
+function wireDevChannel(opts) {
+	const hot = import.meta.hot;
+	const cleanups = [];
+	if (!hot) return cleanups;
+	const onFrameRequest = (data) => {
+		const request = data;
+		const id = request?.id;
+		hot.send("incanto:frame-ack", { id });
+		const drive = request?.drive ? parseDrive(request.drive) : null;
+		if (drive?.error) {
+			hot.send("incanto:frame-report", {
+				id,
+				report: { error: drive.error }
+			});
+			return;
+		}
+		let droveFrames = null;
+		(drive ? opts.applyDrive(drive.steps) : Promise.resolve(null)).then((frames) => {
+			droveFrames = frames;
+			return opts.captureFramePixels();
+		}).then((shot) => hot.send("incanto:frame-report", {
+			id,
+			report: {
+				...frameStats(shot.pixels, shot.width, shot.height, { grid: request?.grid }),
+				signature: frameSignature(shot.pixels, shot.width, shot.height),
+				...droveFrames === null ? {} : { droveFrames },
+				...request?.image ? { image: frameImage(shot.pixels, shot.width, shot.height, (w, h) => Object.assign(document.createElement("canvas"), {
+					width: w,
+					height: h
+				}), request.image) } : {}
+			}
+		})).catch((error) => hot.send("incanto:frame-report", {
+			id,
+			report: { error: error instanceof Error ? error.message : String(error) }
+		}));
+	};
+	hot.on("incanto:frame-request", onFrameRequest);
+	cleanups.push(() => hot.off?.("incanto:frame-request", onFrameRequest));
+	const onLogsRequest = (data) => {
+		const id = data?.id;
+		try {
+			hot.send("incanto:logs-report", {
+				id,
+				report: logReport({
+					entries: opts.engine.log.entries(),
+					stats: {
+						...opts.engine.stats(),
+						...opts.rendererStats?.() ?? {}
+					},
+					assetErrors: opts.assetErrors?.() ?? [],
+					hidden: typeof document !== "undefined" && document.hidden
+				})
+			});
+		} catch (error) {
+			hot.send("incanto:logs-report", {
+				id,
+				report: { error: error instanceof Error ? error.message : String(error) }
+			});
+		}
+	};
+	hot.on("incanto:logs-request", onLogsRequest);
+	cleanups.push(() => hot.off?.("incanto:logs-request", onLogsRequest));
+	return cleanups;
+}
+//#endregion
 //#region src/core/editor-switch.ts
 /**
 * Cover the page while it changes what it is.
@@ -324,4 +396,4 @@ function defaultReport(what, error) {
 	console.error(`[incanto] teardown: ${what} failed (continuing)`, error);
 }
 //#endregion
-export { openBundledEditor as a, audioErrors as c, devServerLibrary as i, pauseWhenHidden as n, poseFromRenderer as o, crossFade as r, claimCanvasGestures as s, teardown as t };
+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 };

package/dist/{test-Bu6SPNsV.js → test-ZBga8kQ9.js}

@@ -1,13 +1,13 @@
-import { A as registerBehavior, n as loadScene, s as resolveViewport } from "./loader-BTkHYrQn.js";
-import { x as Engine } from "./register-p48lHE2o.js";
+import { A as registerBehavior, n as loadScene, s as resolveViewport } from "./loader-BcrRSjxB.js";
+import { _ as Engine } from "./register-Ch70uByv.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { n as jsonEquals, t as jsonClone } from "./json-BLk7H2Qa.js";
 import { i as getNodeSchema, s as mergeStaticProps } from "./registry-C7u42TID.js";
-import { n as startRecording } from "./replay-t1pP0gQg.js";
-import { n as registerGameplayBehaviors } from "./gameplay-C_SPzmUe.js";
-import { t as registerNodes2D } from "./register-en63AEZO.js";
-import { n as registerNodes3D, t as resolveEnvironmentHdri } from "./environment-presets-DLHqgNAF.js";
-import { n as registerNodesNet, t as createSplitScreen } from "./split-screen-CSb_uZ6W.js";
+import { n as startRecording } from "./replay-s7I2GstT.js";
+import { n as registerGameplayBehaviors } from "./gameplay-BVphcxmE.js";
+import { t as registerNodes2D } from "./register-C6ZBFRjd.js";
+import { n as registerNodes3D, t as resolveEnvironmentHdri } from "./environment-presets-CvvQr_bJ.js";
+import { n as registerNodesNet, t as createSplitScreen } from "./split-screen-DLsUrleX.js";
 import { Box3, Euler, Matrix4, PerspectiveCamera, Quaternion, Vector3 } from "three";
 //#region src/test/framing.ts
 /**
@@ -474,6 +474,24 @@ function framingText(report) {
 const FALL_2D_PX = 1e3;
 /** "Reached it", in pixels — one 32 px tile, next to a ~34 px character. */
 const REACH_2D_PX = 32;
+/**
+* How hard this scene pulls, in its own units — 0 only for a scene that says so.
+*
+* Gravity is what makes "left the world downward" mean anything, and a
+* top-down game has none. But ABSENT is not ZERO: the physics adapters default
+* an undeclared scene to [0, 980] px/s² in 2D and [0, -9.81, 0] m/s² in 3D, so
+* a platformer that never wrote a physics header still falls, and reading
+* absent as zero would have stopped reporting the pit it fell into.
+*/
+function gravityMagnitude(physics) {
+	const g = physics?.gravity;
+	if (g === void 0) return 1;
+	if (!Array.isArray(g)) return 1;
+	return g.reduce((sum, v) => sum + (typeof v === "number" ? Math.abs(v) : 0), 0);
+}
+/** Furthest the player ever got from its spawn, below which it went nowhere. */
+const STUCK_3D_M = 3;
+const STUCK_2D_PX = 96;
 const CONTROLLERS = new Set(["CharacterController2D", "CharacterController3D"]);
 /**
 * Who the driver is playing as.
@@ -718,7 +736,8 @@ async function runOnce(json, seed, opts) {
 		0
 	];
 	const down = scene.dimension === "2d" ? 1 : -1;
-	const floor = opts.fallBelow ?? start[1] + down * (down > 0 ? FALL_2D_PX : 50);
+	const pull = gravityMagnitude(scene.physics);
+	const floor = opts.fallBelow ?? (pull > 0 ? start[1] + down * (down > 0 ? FALL_2D_PX : 50) : null);
 	const radius = opts.reachRadius ?? (down > 0 ? REACH_2D_PX : 2);
 	const recorder = startRecording(engine);
 	const rand = () => engine.rng.next();
@@ -726,10 +745,12 @@ async function runOnce(json, seed, opts) {
 	const reached = /* @__PURE__ */ new Set();
 	const stepMs = 1e3 / 60;
 	const deadline = (opts.seconds ?? 60) * 1e3;
-	let outcome = "stuck";
+	let outcome = null;
 	let at = start;
+	let wentAsFarAs = 0;
 	while (session.timeMs < deadline) {
 		at = player ? worldOf(player) : start;
+		wentAsFarAs = Math.max(wentAsFarAs, Math.hypot(at[0] - start[0], at[2] - start[2]));
 		driver.step(stepMs / 1e3, at);
 		session.step(stepMs);
 		if (player) for (const [path, node] of targetNodes) {
@@ -746,15 +767,17 @@ async function runOnce(json, seed, opts) {
 			outcome = "error";
 			break;
 		}
-		if (player && (at[1] - floor) * down > 0) {
+		if (player && floor !== null && (at[1] - floor) * down > 0) {
 			outcome = "fell";
 			break;
 		}
 	}
 	driver.release();
+	const WENT_NOWHERE = scene.dimension === "2d" ? STUCK_2D_PX : STUCK_3D_M;
+	outcome ??= wentAsFarAs > WENT_NOWHERE ? "unfinished" : "stuck";
 	const heard = engine.audio.recent().map((e) => e.from);
 	const shown = engine.effects.recent().map((e) => e.from);
-	const bad = outcome !== "won";
+	const bad = outcome !== "won" && outcome !== "unfinished";
 	const run = {
 		seed,
 		outcome,
@@ -857,12 +880,15 @@ function playtestText(report) {
 		"error",
 		"fell",
 		"lost",
-		"stuck"
+		"stuck",
+		"unfinished"
 	]) {
 		const hits = runs.filter((r) => r.outcome === bad);
 		if (hits.length === 0) continue;
 		const where = bad === "fell" ? ` (last at y=${hits[0].endedAt[1].toFixed(1)})` : "";
-		lines.push(`  ✗ ${bad} in ${pct(hits.length, total)}${where}`);
+		const mark = bad === "unfinished" ? "·" : "✗";
+		const what = bad === "unfinished" ? "ran out of time still playing" : `${bad} in ${pct(hits.length, total)}`;
+		lines.push(bad === "unfinished" ? `  ${mark} ${pct(hits.length, total)} ${what}` : `  ${mark} ${what}${where}`);
 	}
 	const everReached = new Set(runs.flatMap((r) => r.reached));
 	const missed = targets.filter((path) => !everReached.has(path));
@@ -1016,6 +1042,10 @@ function facingText(report) {
 const STEP_MS = 1e3 / 60;
 /** Drop height for the buffer probe — long enough to outlast a coyote window. */
 const DROP = 12;
+/** Metres a 3D probe is lifted/dropped from. */
+const UNIT_LIFT = 40;
+/** Pixels a 2D probe is lifted/dropped from — a 2D world is ~30x the numbers. */
+const PX_LIFT = 1200;
 function positionOf(node) {
 	const p = node.position;
 	return [
@@ -1062,11 +1092,14 @@ async function makeProbe(json, opts) {
 			jump
 		};
 	}
+	const is2d = session.scene.dimension === "2d";
 	return {
 		probe: {
 			session,
 			engine: session.engine,
 			player,
+			up: is2d ? -1 : 1,
+			lift: is2d ? PX_LIFT : UNIT_LIFT,
 			step: (frames = 1) => session.step(frames * STEP_MS),
 			pos: () => positionOf(player),
 			vel: () => velocityOf(player),
@@ -1159,7 +1192,7 @@ function jumpShape(probe, jump) {
 	let airtime = null;
 	for (let f = 2; f <= 600; f++) {
 		probe.step();
-		const h = probe.pos()[1] - floor;
+		const h = (probe.pos()[1] - floor) * probe.up;
 		if (h > apex) {
 			apex = h;
 			toApex = f;
@@ -1169,7 +1202,8 @@ function jumpShape(probe, jump) {
 			break;
 		}
 	}
-	if (apex <= .02) return {
+	const noise = probe.up > 0 ? .02 : 2;
+	if (apex <= noise) return {
 		apex: null,
 		toApexMs: null,
 		airtimeMs: null
@@ -1197,7 +1231,7 @@ async function measureCoyote(json, opts, jump) {
 		const p = probe.pos();
 		probe.player.position = [
 			p[0],
-			p[1] + 40,
+			p[1] + probe.lift * probe.up,
 			p[2]
 		];
 		probe.step(delayFrames);
@@ -1206,7 +1240,7 @@ async function measureCoyote(json, opts, jump) {
 		probe.step();
 		const after = probe.vel()[1];
 		probe.session.dispose();
-		return after - before > 1;
+		return (after - before) * probe.up > 1;
 	};
 	if (!await fired(1)) return 0;
 	let lo = 1;
@@ -1231,13 +1265,14 @@ async function measureBuffer(json, opts, jump) {
 		if (!probe) return false;
 		settle$1(probe);
 		const floor = probe.pos()[1];
+		const drop = (probe.up > 0 ? DROP : probe.lift / 3) * probe.up;
 		probe.player.position = [
 			probe.pos()[0],
-			floor + DROP,
+			floor + drop,
 			probe.pos()[2]
 		];
 		let frames = 0;
-		while (probe.pos()[1] > floor + .05 && frames < 200) {
+		while ((probe.pos()[1] - floor) * probe.up > .05 && frames < 200) {
 			probe.step();
 			frames += 1;
 		}
@@ -1249,7 +1284,7 @@ async function measureBuffer(json, opts, jump) {
 		settle$1(p2);
 		p2.player.position = [
 			p2.pos()[0],
-			floor + DROP,
+			floor + drop,
 			p2.pos()[2]
 		];
 		p2.step(Math.max(0, fallFrames - earlyFrames));
@@ -1259,7 +1294,7 @@ async function measureBuffer(json, opts, jump) {
 		let rose = false;
 		for (let f = 0; f < 40; f++) {
 			p2.step();
-			if (p2.vel()[1] > 1) rose = true;
+			if (p2.vel()[1] * p2.up > 1) rose = true;
 		}
 		p2.session.dispose();
 		return rose;
@@ -1753,10 +1788,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-CfWAggJ1.js").then((n) => n.r);
+		const { enablePhysics2D } = await import("./physics-2d-EqA-jddf.js").then((n) => n.r);
 		await enablePhysics2D(engine);
 	} else if (physics === "3d" || physics === "auto" && scene.dimension === "3d") {
-		const { enablePhysics3D } = await import("./physics-3d-NzDwWPrF.js").then((n) => n.r);
+		const { enablePhysics3D } = await import("./physics-3d-Dnz4fsXX.js").then((n) => n.r);
 		await enablePhysics3D(engine);
 	}
 	const failures = [];
@@ -1869,10 +1904,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-CfWAggJ1.js").then((n) => n.r);
+		const { enablePhysics2D } = await import("./physics-2d-EqA-jddf.js").then((n) => n.r);
 		await enablePhysics2D(engine);
 	} else if (physics === "3d" || physics === "auto" && scene.dimension === "3d") {
-		const { enablePhysics3D } = await import("./physics-3d-NzDwWPrF.js").then((n) => n.r);
+		const { enablePhysics3D } = await import("./physics-3d-Dnz4fsXX.js").then((n) => n.r);
 		await enablePhysics3D(engine);
 	}
 	const stepMs = 1e3 / (opts.fixedHz ?? 60);

package/dist/test.d.ts

@@ -1,8 +1,8 @@
-import { At as Node, Nt as LogEntry, P as Scene, b as Engine, n as BehaviorCtor } from "./behavior-CyQoSu4n.js";
+import { At as Node, Nt as LogEntry, P as Scene, b as Engine, n as BehaviorCtor } from "./behavior-l08AEbq9.js";
 import { c as JsonValue, i as SceneJson, s as JsonObject } from "./schema-CFeioQRE.js";
-import { t as LoadSceneOptions } from "./loader-DhI1jFW_.js";
-import { l as auditScene, o as IncantoError, r as ReplayJson } from "./replay-ePMz26jw.js";
-import { l as LocalGameServerOptions, n as SplitScreenPlayer } from "./split-screen-BsdOHbzP.js";
+import { t as LoadSceneOptions } from "./loader-BbEMTuWg.js";
+import { l as auditScene, o as IncantoError, r as ReplayJson } from "./replay-Dw6gMlYA.js";
+import { l as LocalGameServerOptions, n as SplitScreenPlayer } from "./split-screen-B0baBwxI.js";
 
 //#region src/test/facing.d.ts
 interface FacingOptions {
@@ -193,7 +193,7 @@ declare function multiplayProblems(detail: MultiplayPlayer[], rooms: string[]):
 declare function multiplayText(report: MultiplayReport): string;
 //#endregion
 //#region src/test/playtest.d.ts
-type Outcome = "won" | "lost" | "fell" | "error" | "stuck";
+type Outcome = "won" | "lost" | "fell" | "error" | "stuck" | "unfinished";
 interface PlaytestOptions {
   /** How many independent runs. Each gets its own seed. Default 20. */
   runs?: number;

package/dist/test.js

@@ -1,3 +1,3 @@
-import { r as auditScene } from "./replay-t1pP0gQg.js";
-import { S as framingText, _ as failingReplays, a as registerAllNodes, b as playtestText, c as ladderText, d as multiplayText, f as playMultiplayer, g as facingText, h as facingReport, i as findFloatingProps, l as ladderVerdict, m as feelText, n as createPlaySession, o as runScript, p as feelReport, r as describeCapture, s as validateScene, t as captureScene, u as multiplayProblems, v as findPlayer, x as describeFraming, y as playtest } from "./test-Bu6SPNsV.js";
+import { r as auditScene } from "./replay-s7I2GstT.js";
+import { S as framingText, _ as failingReplays, a as registerAllNodes, b as playtestText, c as ladderText, d as multiplayText, f as playMultiplayer, g as facingText, h as facingReport, i as findFloatingProps, l as ladderVerdict, m as feelText, n as createPlaySession, o as runScript, p as feelReport, r as describeCapture, s as validateScene, t as captureScene, u as multiplayProblems, v as findPlayer, x as describeFraming, y as playtest } from "./test-ZBga8kQ9.js";
 export { auditScene, captureScene, createPlaySession, describeCapture, describeFraming, facingReport, facingText, failingReplays, feelReport, feelText, findFloatingProps, findPlayer, framingText, ladderText, ladderVerdict, multiplayProblems, multiplayText, playMultiplayer, playtest, playtestText, registerAllNodes, runScript, validateScene };