incanto 0.72.0 → 0.74.0

package/dist/{split-screen-DkqLng6q.d.ts → split-screen-D6sx8z3Z.d.ts}

@@ -1,7 +1,7 @@
-import { Lt as Signal, b as Engine, jt as Node } from "./behavior-Bf9P9oB2.js";
+import { Lt as Signal, b as Engine, jt as Node } from "./behavior-J1cmVah0.js";
 import { t as DiagnosticSink } from "./diagnostics-Cu85N3tL.js";
 import { a as SceneJson, c as JsonValue, s as JsonObject } from "./rng-Bb-IutXB.js";
-import { t as LoadSceneOptions } from "./loader-CBfQzB6S.js";
+import { t as LoadSceneOptions } from "./loader-BAeWMYfF.js";
 
 //#region src/net/types.d.ts
 type Unsubscribe = () => void;

package/dist/{sprite-animation-CqR2o3SA.js → sprite-animation-Bz3DHD_4.js}

@@ -1,6 +1,6 @@
 import { n as jsonEquals } from "./json-CfTjpvW8.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
-import { h as didYouMean } from "./touch-BnCyPA0G.js";
+import { h as didYouMean } from "./touch-CioTZB-y.js";
 //#region src/core/particle-presets.ts
 const PARTICLE_PRESETS = {
 	fire: {

package/dist/{src-DRSsRleD.js → src-CqtvYtSN.js}

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

package/dist/{test-Djuq3Vhq.js → test-CEl0y2Sw.js}

@@ -1,14 +1,14 @@
 import { n as jsonEquals, t as jsonClone } from "./json-CfTjpvW8.js";
-import { B as HudLayer, M as resetMemorySaves, O as resolveViewport, V as HudWidgetBase, c as isCloned, h as loadScene, ot as registerBehavior, tt as StubBehavior } from "./save-slots-CEuJPUle.js";
-import { v as Engine } from "./register-5IYfooAN.js";
+import { B as HudLayer, M as resetMemorySaves, O as resolveViewport, V as HudWidgetBase, c as isCloned, h as loadScene, ot as registerBehavior, tt as StubBehavior } from "./save-slots-CEUGeLuB.js";
+import { v as Engine } from "./register-CjociOtt.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as Rng } from "./rng-CDOMybym.js";
-import { c as getNodeSchema, d as mergeStaticProps, u as getNodeType } from "./touch-BnCyPA0G.js";
-import { n as startRecording } from "./replay-datiAE-b.js";
-import { Q as worldPosition, n as registerGameplayBehaviors } from "./gameplay-BlQe-M07.js";
-import { t as registerNodes2D } from "./register-C8HuRkOf.js";
-import { n as registerNodes3D, t as resolveEnvironmentHdri } from "./environment-presets-BeHoaGhy.js";
-import { a as NetworkManager, c as readSyncKey, i as sanitizeName, n as registerNodesNet, r as NetworkSpawner, s as findOwnerNode, t as createSplitScreen } from "./split-screen-Bm5DTElG.js";
+import { a as LIGHT_NODE_TYPES, n as startRecording } from "./replay-B6BbgGM_.js";
+import { c as getNodeSchema, d as mergeStaticProps, u as getNodeType } from "./touch-CioTZB-y.js";
+import { et as worldPosition, n as registerGameplayBehaviors } from "./gameplay-Bxe1sMVT.js";
+import { t as registerNodes2D } from "./register-DRQyZKGU.js";
+import { n as registerNodes3D, t as resolveEnvironmentHdri } from "./environment-presets-BkqlWewf.js";
+import { a as NetworkManager, c as readSyncKey, i as sanitizeName, n as registerNodesNet, r as NetworkSpawner, s as findOwnerNode, t as createSplitScreen } from "./split-screen-BxZ5rBe7.js";
 import { Box3, Euler, Frustum, Matrix4, PerspectiveCamera, Quaternion, Ray, Vector3 } from "three";
 //#region src/core/asset-urls.ts
 /** Keys inside a `material` object that hold a texture URL. */
@@ -90,7 +90,7 @@ function sceneAssetUrls(json) {
 */
 const DEG = Math.PI / 180;
 const CAMERA_TYPES = new Set(["Camera3D"]);
-const LIGHT_TYPES = new Set(["DirectionalLight3D", "OmniLight3D"]);
+const LIGHT_TYPES = LIGHT_NODE_TYPES;
 /** Screen-space subtrees: they ignore the camera, so framing has nothing to say. */
 const SCREEN_SPACE$1 = new Set(["UILayer", "HudLayer"]);
 /** Depth a 2D collider is given on the axis it does not have. */
@@ -846,7 +846,7 @@ function framingText(report) {
 //#region src/test/picker.ts
 const DEFAULT_VIEW = [960, 540];
 const CAMERAS = new Set(["Camera3D"]);
-const LIGHTS = new Set(["DirectionalLight3D", "OmniLight3D"]);
+const LIGHTS = LIGHT_NODE_TYPES;
 /**
 * A picker over `scene`, in the scene's own units.
 *
@@ -2759,12 +2759,14 @@ async function makeProbe(json, opts) {
 	};
 	const move = opts.moveAction ?? named("moveAction", "vector2") ?? moveOptions[0] ?? null;
 	const jump = opts.jumpAction ?? named("jumpAction", "button") ?? (declared.some((a) => a.name === "jump" && a.type === "button") ? "jump" : null);
+	const sprint = named("sprintAction", "button") ?? (declared.some((a) => a.name === "sprint" && a.type === "button") ? "sprint" : null);
 	if (!player) {
 		session.dispose();
 		return {
 			probe: null,
 			move,
 			jump,
+			sprint,
 			moveOptions
 		};
 	}
@@ -2783,10 +2785,15 @@ async function makeProbe(json, opts) {
 			speed: () => {
 				const v = velocityOf(player);
 				return Math.hypot(v[0], v[2]);
+			},
+			onFloor: () => {
+				const body = player;
+				return typeof body.isOnFloor === "function" ? body.isOnFloor() : null;
 			}
 		},
 		move,
 		jump,
+		sprint,
 		moveOptions
 	};
 }
@@ -2951,6 +2958,42 @@ function jumpShape(probe, jump, hold = false) {
 		airtimeMs: airtime
 	};
 }
+/** Frames between presses in a multi-jump probe — long enough for the rise to slow. */
+const BETWEEN_PRESSES = 15;
+/**
+* How high the character goes with EVERY jump spent: press, let the rise slow,
+* press again, as many times as `maxJumps` allows.
+*
+* The presses are spaced because a second press taken at launch speed re-sets
+* the same velocity and reads as nothing having happened.
+*/
+function multiJumpShape(probe, jump, jumps) {
+	settle$1(probe);
+	const floor = probe.pos()[1];
+	let apex = 0;
+	let airtime = null;
+	let pressesLeft = jumps;
+	for (let f = 1; f <= 900; f++) {
+		if (pressesLeft > 0 && (f - 1) % BETWEEN_PRESSES === 0) {
+			probe.engine.input.pressAction(jump);
+			probe.step();
+			probe.engine.input.releaseAction(jump);
+			pressesLeft -= 1;
+		} else probe.step();
+		const h = (probe.pos()[1] - floor) * probe.up;
+		if (h > apex) apex = h;
+		if (pressesLeft === 0 && apex > .02 && h <= .02) {
+			airtime = Math.round(f * STEP_MS);
+			break;
+		}
+	}
+	const noise = probe.up > 0 ? .02 : 2;
+	if (apex <= noise) return null;
+	return {
+		apex: Number(apex.toFixed(3)),
+		airtimeMs: airtime
+	};
+}
 /**
 * How long after leaving the ground a jump still fires — measured, not read.
 *
@@ -2960,7 +3003,7 @@ function jumpShape(probe, jump, hold = false) {
 * which is the whole point — that was a real bug in this engine's 3D controller
 * until 0.37 and the schema looked correct the entire time.
 */
-async function measureCoyote(json, opts, jump) {
+async function measureCoyote(json, opts, jump, jumps = 1) {
 	const fired = async (delayFrames) => {
 		const { probe } = await makeProbe(json, opts);
 		if (!probe) return false;
@@ -2971,16 +3014,26 @@ async function measureCoyote(json, opts, jump) {
 			p[1] + probe.lift * probe.up,
 			p[2]
 		];
+		for (let f = 0; f < 4 && probe.onFloor() === true; f++) probe.step();
 		probe.step(delayFrames);
-		const before = probe.vel()[1];
-		probe.engine.input.pressAction(jump);
-		probe.step();
-		const after = probe.vel()[1];
+		const pressFires = () => {
+			const before = probe.vel()[1];
+			probe.engine.input.pressAction(jump);
+			probe.step();
+			probe.engine.input.releaseAction(jump);
+			const after = probe.vel()[1];
+			return after * probe.up > 1 && (after - before) * probe.up > 1;
+		};
+		let all = pressFires();
+		for (let extra = 1; all && extra < jumps; extra++) {
+			probe.step(BETWEEN_PRESSES);
+			all = pressFires();
+		}
 		probe.session.dispose();
-		return (after - before) * probe.up > 1;
+		return all;
 	};
-	if (!await fired(1)) return 0;
-	let lo = 1;
+	if (!await fired(0)) return 0;
+	let lo = 0;
 	let hi = 60;
 	if (await fired(hi)) return null;
 	while (hi - lo > 1) {
@@ -2988,7 +3041,7 @@ async function measureCoyote(json, opts, jump) {
 		if (await fired(mid)) lo = mid;
 		else hi = mid;
 	}
-	return Math.round(lo * STEP_MS);
+	return Math.round((lo + 1) * STEP_MS);
 }
 /**
 * `coyoteSeconds` as written in the scene, in ms — for CONTRAST, never instead.
@@ -3012,13 +3065,36 @@ function declaredCoyote(json) {
 	walk(json?.root);
 	return found;
 }
+/** `maxJumps` as written in the scene; 1 when it says nothing. */
+function declaredMaxJumps(json) {
+	let found = 1;
+	const walk = (node) => {
+		if (!node || typeof node !== "object") return;
+		const n = node;
+		if (typeof n.type === "string" && /^CharacterController[23]D$/.test(n.type)) {
+			const value = n.props?.maxJumps;
+			if (typeof value === "number" && value > 1) found = Math.floor(value);
+		}
+		for (const child of n.children ?? []) walk(child);
+	};
+	walk(json?.root);
+	return found;
+}
 /**
 * How long BEFORE landing a press still survives.
 *
 * Same shape: drop the character, press at T frames before it would touch down,
 * and check whether it left the ground again afterwards.
 */
-async function measureBuffer(json, opts, jump) {
+async function measureBuffer(json, opts, jump, jumps = 1) {
+	const exhaust = (probe) => {
+		for (let i = 0; i < jumps; i++) {
+			probe.step(BETWEEN_PRESSES);
+			probe.engine.input.pressAction(jump);
+			probe.step();
+			probe.engine.input.releaseAction(jump);
+		}
+	};
 	const survived = async (earlyFrames) => {
 		const { probe } = await makeProbe(json, opts);
 		if (!probe) return false;
@@ -3030,8 +3106,9 @@ async function measureBuffer(json, opts, jump) {
 			floor + drop,
 			probe.pos()[2]
 		];
+		if (jumps > 1) exhaust(probe);
 		let frames = 0;
-		while ((probe.pos()[1] - floor) * probe.up > .05 && frames < 200) {
+		while ((probe.pos()[1] - floor) * probe.up > .05 && frames < 400) {
 			probe.step();
 			frames += 1;
 		}
@@ -3046,6 +3123,7 @@ async function measureBuffer(json, opts, jump) {
 			floor + drop,
 			p2.pos()[2]
 		];
+		if (jumps > 1) exhaust(p2);
 		p2.step(Math.max(0, fallFrames - earlyFrames));
 		p2.engine.input.pressAction(jump);
 		p2.step();
@@ -3073,6 +3151,7 @@ async function feelReport(json, opts = {}) {
 	const first = await makeProbe(json, opts);
 	const move = first.move;
 	const jump = first.jump;
+	const sprintAction = first.sprint;
 	if (!first.probe) return {
 		player: null,
 		moveAction: move,
@@ -3084,12 +3163,16 @@ async function feelReport(json, opts = {}) {
 		turnaroundMs: null,
 		jumpApex: null,
 		heldJumpApex: null,
+		walkingJumpApex: null,
+		sprintJumpApex: null,
 		heldAirtimeMs: null,
 		timeToApexMs: null,
 		airtimeMs: null,
 		coyoteMs: null,
 		jumpsInMidair: false,
 		declaredCoyoteMs: null,
+		declaredMaxJumps: 1,
+		doubleJump: null,
 		jumpBufferMs: null,
 		inputToMotionFrames: null,
 		moveAxis: null,
@@ -3188,8 +3271,12 @@ async function feelReport(json, opts = {}) {
 	};
 	let shape = NO_SHAPE;
 	let held = NO_SHAPE;
+	let walking = NO_SHAPE;
+	let sprinting = NO_SHAPE;
 	let coyote = null;
 	let buffer = null;
+	const jumps = declaredMaxJumps(json);
+	let doubleJump = null;
 	if (jump) {
 		const d = await fresh();
 		if (d) {
@@ -3203,8 +3290,33 @@ async function feelReport(json, opts = {}) {
 			collect(h);
 			h.session.dispose();
 		}
-		coyote = await measureCoyote(json, opts, jump);
-		buffer = await measureBuffer(json, opts, jump);
+		if (action) {
+			const w = await fresh();
+			if (w) {
+				w.engine.input.setActionVector(action, 1, 0);
+				walking = jumpShape(w, jump, true);
+				w.session.dispose();
+			}
+			if (sprintAction) {
+				const sp = await fresh();
+				if (sp) {
+					sp.engine.input.setActionVector(action, 1, 0);
+					sp.engine.input.pressAction(sprintAction);
+					sprinting = jumpShape(sp, jump, true);
+					sp.session.dispose();
+				}
+			}
+		}
+		if (jumps > 1) {
+			const m = await fresh();
+			if (m) {
+				doubleJump = multiJumpShape(m, jump, jumps);
+				collect(m);
+				m.session.dispose();
+			}
+		}
+		coyote = await measureCoyote(json, opts, jump, jumps);
+		buffer = await measureBuffer(json, opts, jump, jumps);
 	}
 	return {
 		player: playerPath,
@@ -3218,6 +3330,8 @@ async function feelReport(json, opts = {}) {
 		jumpApex: shape.apex,
 		heldJumpApex: held.apex,
 		heldAirtimeMs: held.airtimeMs,
+		walkingJumpApex: walking.apex,
+		sprintJumpApex: sprinting.apex,
 		timeToApexMs: shape.toApexMs,
 		airtimeMs: shape.airtimeMs,
 		coyoteMs: coyote,
@@ -3225,6 +3339,8 @@ async function feelReport(json, opts = {}) {
 		declaredCoyoteMs: declaredCoyote(json),
 		jumpBufferMs: buffer,
 		inputToMotionFrames: latency,
+		declaredMaxJumps: jumps,
+		doubleJump,
 		moveAxis: axis,
 		moveTried: tried,
 		errorMessages: [...said.errors],
@@ -3260,7 +3376,12 @@ function feelText(report) {
 		lines.push("");
 		lines.push(`  jump apex        ${report.jumpApex === null ? "— (nothing left the ground)" : `${report.jumpApex} u   (tapped)`}`);
 		const cut = report.heldJumpApex !== null && report.jumpApex !== null && Math.abs(report.heldJumpApex - report.jumpApex) > .02;
-		if (cut) lines.push(`  held apex        ${report.heldJumpApex} u   ← size your level against THIS`);
+		if (cut) lines.push(`  held apex        ${report.heldJumpApex} u   (standing)`);
+		if (report.walkingJumpApex !== null || report.sprintJumpApex !== null) {
+			const parts = [report.walkingJumpApex !== null ? `${report.walkingJumpApex} u walking` : null, report.sprintJumpApex !== null ? `${report.sprintJumpApex} u sprinting` : null].filter((x) => x !== null);
+			lines.push(`  moving apex      ${parts.join(" · ")}   ← size your level against the LARGEST`);
+		} else if (cut) lines.push("  (size your level against the held apex — this scene declares no move action)");
+		if (report.doubleJump) lines.push(`  ${report.declaredMaxJumps === 2 ? "double jump" : `${report.declaredMaxJumps} jumps`}      ${report.doubleJump.apex} u   (${report.declaredMaxJumps} TAPS, maxJumps ${report.declaredMaxJumps}${report.doubleJump.airtimeMs !== null ? `, ${ms(report.doubleJump.airtimeMs)} airtime` : ""})`);
 		lines.push(`  time to apex     ${ms(report.timeToApexMs)}`);
 		lines.push(`  airtime          ${ms(report.airtimeMs)}${cut && report.heldAirtimeMs !== null ? `   (${ms(report.heldAirtimeMs)} held)` : ""}`);
 		lines.push(`  coyote window    ${report.jumpsInMidair ? "not measurable — this character jumps in MID-AIR" : report.coyoteMs === null ? "always (no window)" : ms(report.coyoteMs)}`);
@@ -3389,8 +3510,8 @@ async function playMultiplayer(opts) {
 */
 async function joinLate(server, first, opts) {
 	try {
-		const { Engine } = await import("./register-5IYfooAN.js").then((n) => n.y);
-		const { loadScene } = await import("./save-slots-CEuJPUle.js").then((n) => n.g);
+		const { Engine } = await import("./register-CjociOtt.js").then((n) => n.y);
+		const { loadScene } = await import("./save-slots-CEUGeLuB.js").then((n) => n.g);
 		const { jsonClone } = await import("./json-CfTjpvW8.js").then((n) => n.i);
 		const engine = new Engine(opts.seed !== void 0 ? { seed: opts.seed + 999 } : {});
 		engine.setScene(loadScene(jsonClone(opts.scene), opts.load));
@@ -3988,13 +4109,14 @@ async function runScript(json, opts) {
 	if (opts.locale) engine.locale.locale = opts.locale;
 	const physics = opts.physics ?? "auto";
 	if (physics === "2d" || physics === "auto" && scene.dimension === "2d") {
-		const { enablePhysics2D } = await import("./physics-2d-DrIgTlLk.js").then((n) => n.r);
+		const { enablePhysics2D } = await import("./physics-2d-C-SfvjzH.js").then((n) => n.r);
 		await enablePhysics2D(engine);
 	} else if (physics === "3d" || physics === "auto" && scene.dimension === "3d") {
-		const { enablePhysics3D } = await import("./physics-3d-BzOCw1VS.js").then((n) => n.r);
+		const { enablePhysics3D } = await import("./physics-3d-rOzeg890.js").then((n) => n.r);
 		await enablePhysics3D(engine);
 	}
 	const failures = [];
+	const stalled = [];
 	const snapshots = [];
 	const live = () => engine.scene ?? scene;
 	const ctx = {
@@ -4004,6 +4126,7 @@ async function runScript(json, opts) {
 		},
 		timeMs: 0,
 		getNode: (path) => live().root.getNode(path),
+		getNodeOrNull: (path) => live().root.getNodeOrNull(path),
 		capture: () => captureScene(live())
 	};
 	/** Is `hit` the node we aimed at, or something of its own? */
@@ -4111,6 +4234,7 @@ async function runScript(json, opts) {
 			engine.input.handleMouseButton(releaseButton, true);
 			releaseAt = tick + 1;
 		}
+		const frozenBefore = engine.timeScale === 0;
 		step.do?.(ctx);
 		if (step.assert) try {
 			const verdict = assertVerdict(step.assert(ctx));
@@ -4126,6 +4250,11 @@ async function runScript(json, opts) {
 				message: e instanceof Error ? e.message : String(e)
 			});
 		}
+		if ((step.do || step.assert) && (frozenBefore || engine.timeScale === 0)) stalled.push({
+			atMs: step.atMs,
+			label: step.label,
+			before: frozenBefore
+		});
 	};
 	const stepMs = 1e3 / (opts.fixedHz ?? 60);
 	const totalTicks = Math.round(opts.durationMs / stepMs);
@@ -4178,6 +4307,7 @@ async function runScript(json, opts) {
 	return {
 		ok,
 		failures,
+		stalled,
 		snapshots,
 		logs,
 		finalCapture,
@@ -4186,10 +4316,12 @@ async function runScript(json, opts) {
 			const budget = Math.abs(simulatedMs - opts.durationMs) > Math.max(50, opts.durationMs * .02) ? ` (of ${opts.durationMs}ms of steps — the game clock ran slower, or stopped)` : "";
 			const head = `run ${ok ? "OK" : "FAILED"} — ${simulatedMs}ms simulated${budget}, ${failures.length} failure(s), ${logs.length} log(s)`;
 			const fails = failures.map((f) => `  ✗ at ${f.atMs}ms${f.label ? ` [${f.label}]` : ""}: ${f.message}`);
+			const stopped = stalled.map((s) => `  ! at ${s.atMs}ms${s.label ? ` [${s.label}]` : ""}: the clock was stopped ${s.before ? "when this step ran" : "by the time this step finished"} (timeScale 0 — a terminal GameFlow state or a pause holds it), so engine.step() advanced nothing and every value read here is the last one before it stopped. Restart the flow, or measure before the game ends.`);
 			const noisy = engineWarnings.map((l) => `  ! ${l.level}: ${l.parts.map((p) => typeof p === "string" ? p : String(p)).join(" ")}`);
 			return [
 				head,
 				...fails,
+				...stopped,
 				...noisy,
 				describeCapture(finalCapture)
 			].join("\n");
@@ -4218,10 +4350,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-DrIgTlLk.js").then((n) => n.r);
+		const { enablePhysics2D } = await import("./physics-2d-C-SfvjzH.js").then((n) => n.r);
 		await enablePhysics2D(engine);
 	} else if (physics === "3d" || physics === "auto" && scene.dimension === "3d") {
-		const { enablePhysics3D } = await import("./physics-3d-BzOCw1VS.js").then((n) => n.r);
+		const { enablePhysics3D } = await import("./physics-3d-rOzeg890.js").then((n) => n.r);
 		await enablePhysics3D(engine);
 	}
 	const stepMs = 1e3 / (opts.fixedHz ?? 60);

package/dist/test.d.ts

@@ -1,8 +1,8 @@
-import { P as Scene$1, Pt as LogEntry, b as Engine, jt as Node, n as BehaviorCtor } from "./behavior-Bf9P9oB2.js";
+import { P as Scene$1, Pt as LogEntry, b as Engine, jt as Node, n as BehaviorCtor } from "./behavior-J1cmVah0.js";
 import { a as SceneJson, c as JsonValue, s as JsonObject } from "./rng-Bb-IutXB.js";
-import { t as LoadSceneOptions } from "./loader-CBfQzB6S.js";
-import { l as auditScene, o as IncantoError, r as ReplayJson, u as instancedScenes } from "./replay-CBEChqXq.js";
-import { l as LocalGameServerOptions, n as SplitScreenPlayer } from "./split-screen-DkqLng6q.js";
+import { t as LoadSceneOptions } from "./loader-BAeWMYfF.js";
+import { l as auditScene, o as IncantoError, r as ReplayJson, u as instancedScenes } from "./replay-wZK5Ok5c.js";
+import { l as LocalGameServerOptions, n as SplitScreenPlayer } from "./split-screen-D6sx8z3Z.js";
 import { Matrix4, Vector3 } from "three";
 
 //#region src/core/asset-urls.d.ts
@@ -453,6 +453,16 @@ interface FeelReport {
   heldJumpApex: number | null;
   /** Airtime with the button held. */
   heldAirtimeMs: number | null;
+  /**
+  * The held apex while WALKING and while SPRINTING. `sprintJumpMultiplier`
+  * scales with the keyboard's intensity (0.6 for any move key, 1 with sprint),
+  * so a moving jump is higher than the standing one the other rows measure —
+  * +26% walking, +44% sprinting at the defaults — and a ledge sized against
+  * the standing apex is cleared by anyone holding a direction. Null when the
+  * scene declares no move (or sprint) action.
+  */
+  walkingJumpApex: number | null;
+  sprintJumpApex: number | null;
   timeToApexMs: number | null;
   /** Launch → back on the ground. */
   airtimeMs: number | null;
@@ -492,6 +502,27 @@ interface FeelReport {
   jumpBufferMs: number | null;
   /** Frames between the press and the first movement. */
   inputToMotionFrames: number | null;
+  /**
+  * `maxJumps` as the scene declares it (1 when it says nothing) — read, like
+  * `declaredCoyoteMs`, and for the same reason: the probes below have to know
+  * how many presses a character has before they can tell a coyote jump from
+  * an air jump.
+  */
+  declaredMaxJumps: number;
+  /**
+  * MEASURED: the apex and airtime with EVERY declared jump spent — press,
+  * rise, press again. Null when the controller declares one jump.
+  *
+  * The moment a scene wrote `maxJumps: 2`, this report gave up on two of its
+  * numbers ("not measurable — this character jumps in MID-AIR") and called a
+  * third suspect, while the scene said exactly why in the line above. A
+  * double jump is the 3D character skill's own recommendation; the instrument
+  * has to survive it.
+  */
+  doubleJump: {
+    apex: number;
+    airtimeMs: number | null;
+  } | null;
 }
 declare function feelReport(json: unknown, opts?: FeelOptions): Promise<FeelReport>;
 /** Numbers, not grades. What "good" means here is a genre decision. */
@@ -1144,6 +1175,8 @@ interface RunContext {
   timeMs: number;
   /** Resolve a node path relative to the scene root. */
   getNode(path: string): Node;
+  /** The same lookup, null for a node that is not there — a gem already taken, a foe already dead. */
+  getNodeOrNull(path: string): Node | null;
   /** Snapshot the scene right now. */
   capture(): SceneCapture;
 }
@@ -1225,6 +1258,22 @@ interface RunFailure {
   label?: string;
   message: string;
 }
+/**
+* A `do:`/`assert:` step that ran with the game clock STOPPED.
+*
+* `GameFlow` sets `timeScale = 0` on a win or a loss (and a pause menu does the
+* same), after which `engine.step()` advances nothing. A harness that lost its
+* player three times inside one step then measured `0.00` for everything
+* after — the position it had just teleported to, no travel, no apex — and
+* the run was `ok` with nothing said beside the zeros. `before` is whether the
+* clock was already stopped when the step began (every read in it was stale)
+* or stopped by the time it finished (the step itself ended the game).
+*/
+interface RunStalled {
+  atMs: number;
+  label?: string;
+  before: boolean;
+}
 interface RunScriptOptions {
   /** Total simulated duration in ms. */
   durationMs: number;
@@ -1253,6 +1302,8 @@ interface RunResult {
   /** True when no step assertion failed. */
   ok: boolean;
   failures: RunFailure[];
+  /** Steps that ran with the clock stopped — see `RunStalled`. Not failures. */
+  stalled: RunStalled[];
   snapshots: Array<{
     atMs: number;
     capture: SceneCapture;
@@ -1309,4 +1360,4 @@ interface PlaySession {
 */
 declare function createPlaySession(json: unknown, opts?: PlaySessionOptions): Promise<PlaySession>;
 //#endregion
-export { type AgreementSnapshot, type CollectionSnapshot, type Disagreement, type DisagreementKind, type FacingOptions, type FacingReport, type FeelOptions, type FeelReport, type FramingEntry, type FramingOptions, type FramingReport, GroundingIssue, GroundingOptions, type LadderVerdict, type MultiplayOptions, type MultiplayPlayer, type MultiplayReport, NodeCapture, type Outcome, type PickerOptions, PlaySession, PlaySessionOptions, type PlaytestOptions, type PlaytestReport, type PlaytestRun, RunContext, RunFailure, RunResult, RunScriptOptions, type RungResult, type RungStatus, type SceneAssetUrl, SceneCapture, ScriptStep, ValidateSceneOptions, ValidationResult, type Where, agreementProblems, auditScene, captureScene, collectionProblems, createPlaySession, describeCapture, describeFraming, facingReport, facingText, failingReplays, feelReport, feelText, feelsRung, findFloatingProps, findPlayer, firstLine, framingText, geometricPicker, geometricView, instancedScenes, ladderText, ladderVerdict, multiplayProblems, multiplayText, playMultiplayer, playtest, playtestFailed, playtestText, pointAtNode, registerAllNodes, runScript, saysRung, sceneAssetUrls, takeAgreementSnapshots, takeCollectionSnapshots, unmeasuredPlays, validateScene };
+export { type AgreementSnapshot, type CollectionSnapshot, type Disagreement, type DisagreementKind, type FacingOptions, type FacingReport, type FeelOptions, type FeelReport, type FramingEntry, type FramingOptions, type FramingReport, GroundingIssue, GroundingOptions, type LadderVerdict, type MultiplayOptions, type MultiplayPlayer, type MultiplayReport, NodeCapture, type Outcome, type PickerOptions, PlaySession, PlaySessionOptions, type PlaytestOptions, type PlaytestReport, type PlaytestRun, RunContext, RunFailure, RunResult, RunScriptOptions, RunStalled, type RungResult, type RungStatus, type SceneAssetUrl, SceneCapture, ScriptStep, ValidateSceneOptions, ValidationResult, type Where, agreementProblems, auditScene, captureScene, collectionProblems, createPlaySession, describeCapture, describeFraming, facingReport, facingText, failingReplays, feelReport, feelText, feelsRung, findFloatingProps, findPlayer, firstLine, framingText, geometricPicker, geometricView, instancedScenes, ladderText, ladderVerdict, multiplayProblems, multiplayText, playMultiplayer, playtest, playtestFailed, playtestText, pointAtNode, registerAllNodes, runScript, saysRung, sceneAssetUrls, takeAgreementSnapshots, takeCollectionSnapshots, unmeasuredPlays, validateScene };

package/dist/test.js

@@ -1,3 +1,3 @@
-import { i as instancedScenes, r as auditScene } from "./replay-datiAE-b.js";
-import { A as geometricPicker, C as facingReport, D as playtest, E as findPlayer, F as sceneAssetUrls, M as pointAtNode, N as describeFraming, O as playtestFailed, P as framingText, S as collectionProblems, T as failingReplays, _ as feelReport, a as registerAllNodes, b as takeCollectionSnapshots, c as feelsRung, d as ladderVerdict, f as saysRung, g as playMultiplayer, h as multiplayText, i as findFloatingProps, j as geometricView, k as playtestText, l as firstLine, m as multiplayProblems, n as createPlaySession, o as runScript, p as unmeasuredPlays, r as describeCapture, s as validateScene, t as captureScene, u as ladderText, v as feelText, w as facingText, x as agreementProblems, y as takeAgreementSnapshots } from "./test-Djuq3Vhq.js";
+import { i as instancedScenes, r as auditScene } from "./replay-B6BbgGM_.js";
+import { A as geometricPicker, C as facingReport, D as playtest, E as findPlayer, F as sceneAssetUrls, M as pointAtNode, N as describeFraming, O as playtestFailed, P as framingText, S as collectionProblems, T as failingReplays, _ as feelReport, a as registerAllNodes, b as takeCollectionSnapshots, c as feelsRung, d as ladderVerdict, f as saysRung, g as playMultiplayer, h as multiplayText, i as findFloatingProps, j as geometricView, k as playtestText, l as firstLine, m as multiplayProblems, n as createPlaySession, o as runScript, p as unmeasuredPlays, r as describeCapture, s as validateScene, t as captureScene, u as ladderText, v as feelText, w as facingText, x as agreementProblems, y as takeAgreementSnapshots } from "./test-CEl0y2Sw.js";
 export { agreementProblems, auditScene, captureScene, collectionProblems, createPlaySession, describeCapture, describeFraming, facingReport, facingText, failingReplays, feelReport, feelText, feelsRung, findFloatingProps, findPlayer, firstLine, framingText, geometricPicker, geometricView, instancedScenes, ladderText, ladderVerdict, multiplayProblems, multiplayText, playMultiplayer, playtest, playtestFailed, playtestText, pointAtNode, registerAllNodes, runScript, saysRung, sceneAssetUrls, takeAgreementSnapshots, takeCollectionSnapshots, unmeasuredPlays, validateScene };

package/dist/{touch-BnCyPA0G.js → touch-CioTZB-y.js}

@@ -116,7 +116,7 @@ function validatePropValue(value, def, at, options, kinds) {
 		validOptions: [...options]
 	});
 	const expected = jsonKind(def);
-	if (expected === "null") return;
+	if (expected === "null" && !kinds) return;
 	const actual = jsonKind(value);
 	const accepted = kinds ?? [expected];
 	if (!accepted.includes(actual)) throw new IncantoError("PROP_TYPE_MISMATCH", `Prop '${at}' expects ${listKinds(accepted)} (default ${JSON.stringify(def)}), got ${actual} (${JSON.stringify(value)}).`, { prop: at });

package/dist/vite.js

@@ -1,9 +1,9 @@
 import { a as parseJsonText } from "./json-CfTjpvW8.js";
-import { k as newUid } from "./save-slots-CEuJPUle.js";
+import { k as newUid } from "./save-slots-CEUGeLuB.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
-import { t as VERSION } from "./src-DRSsRleD.js";
+import { t as VERSION } from "./src-CqtvYtSN.js";
 import { n as diffSignatures } from "./frame-report-D-_7YF2G.js";
-import { s as validateScene } from "./test-Djuq3Vhq.js";
+import { s as validateScene } from "./test-CEl0y2Sw.js";
 import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
 import { basename, dirname, extname, join, normalize, relative, resolve, sep } from "node:path";
 import { fileURLToPath } from "node:url";

package/editor/assets/{agent8-CMKz2cax.js → agent8-BlzturGi.js}

@@ -1 +1 @@
-import{i as e,n as t}from"./index-BEKuxYcE.js";async function n(e,n){return new a((await t(()=>import(`./GameServer-C56iOUgF.js`),[],import.meta.url)).GameServer,e,{diagnostics:n})}var r=[500,1e3,2e3,4e3,8e3],i=8,a=class{raw;active=new Map;reconnecting=!1;disposed=!1;diagnostics;wait;constructor(e,t,n){this.diagnostics=n?.diagnostics??null,this.wait=n?.wait??(e=>new Promise(t=>{setTimeout(t,e)})),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{for(let t=0;t<i;t++){let n=!1,i=null;try{n=await this.rawConnect()!==!1}catch(e){i=e}if(this.disposed)return;if(n){for(let e of this.active.values())e.off(),e.off=e.make();t>0&&e(this.diagnostics,`info`,`[incanto] multiplayer reconnected after ${t+1} attempts.`);return}t===0&&e(this.diagnostics,`warn`,`[incanto] the multiplayer connection dropped and the server would not take it back${i?` (${i instanceof Error?i.message:String(i)})`:``}. Retrying — other players cannot see this one until it comes back.`);let a=r[Math.min(t,r.length-1)]??8e3;if(await this.wait(a),this.disposed)return}e(this.diagnostics,`error`,`[incanto] multiplayer gave up after ${i} reconnect attempts — this client is offline and the others cannot see it. Call connect() again to retry.`)}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{n as createAgent8Server};
+import{i as e,n as t}from"./index-CrUCQoaB.js";async function n(e,n){return new a((await t(()=>import(`./GameServer-C56iOUgF.js`),[],import.meta.url)).GameServer,e,{diagnostics:n})}var r=[500,1e3,2e3,4e3,8e3],i=8,a=class{raw;active=new Map;reconnecting=!1;disposed=!1;diagnostics;wait;constructor(e,t,n){this.diagnostics=n?.diagnostics??null,this.wait=n?.wait??(e=>new Promise(t=>{setTimeout(t,e)})),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{for(let t=0;t<i;t++){let n=!1,i=null;try{n=await this.rawConnect()!==!1}catch(e){i=e}if(this.disposed)return;if(n){for(let e of this.active.values())e.off(),e.off=e.make();t>0&&e(this.diagnostics,`info`,`[incanto] multiplayer reconnected after ${t+1} attempts.`);return}t===0&&e(this.diagnostics,`warn`,`[incanto] the multiplayer connection dropped and the server would not take it back${i?` (${i instanceof Error?i.message:String(i)})`:``}. Retrying — other players cannot see this one until it comes back.`);let a=r[Math.min(t,r.length-1)]??8e3;if(await this.wait(a),this.disposed)return}e(this.diagnostics,`error`,`[incanto] multiplayer gave up after ${i} reconnect attempts — this client is offline and the others cannot see it. Call connect() again to retry.`)}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{n as createAgent8Server};