incanto 0.67.0 → 0.69.0

package/dist/{replay-D0GcEHYU.d.ts → replay-BQfkX4x7.d.ts}

@@ -1,5 +1,5 @@
-import { b as Engine } from "./behavior-ZnfzKDo3.js";
-import { s as JsonObject } from "./schema-CFeioQRE.js";
+import { b as Engine } from "./behavior-rm8vVzu_.js";
+import { s as JsonObject } from "./schema-B6ugCV1Q.js";
 
 //#region src/core/audit.d.ts
 /** Human-readable warnings (empty = clean). Pure JSON walk, no registry. */
@@ -15,7 +15,41 @@ interface AuditOptions {
   * has one.
   */
   declaredElsewhere?: Record<string, Record<string, string>>;
+  /**
+  * Another scene in this project embeds this file with `instance`.
+  *
+  * That, and only that, makes a scene a FRAGMENT — a thing lit and framed by
+  * whatever drops it in, which must not be told it will render black.
+  *
+  * The discriminator used to be "it has no camera", which is the same shape a
+  * beginner's FIRST 3D scene has. Measured on a ground plane and a capsule
+  * with no camera and no light — a guaranteed black screen:
+  *
+  *   $ incanto-check
+  *     ok  src/game.scene.json
+  *   1/1 scene(s) valid
+  *
+  * Not the lighting warning, and not the camera one either. The checker walks
+  * the whole project already (it unions `strings` and `assets` the same way),
+  * so it can answer this by looking instead of guessing.
+  */
+  instanced?: boolean;
 }
+/**
+* Which files in a corpus some OTHER scene embeds with `instance`.
+*
+* A fragment cannot be recognised by looking at itself — `enemy.scene.json` and
+* a broken first level are the same file shape. It is recognised by the project
+* around it, which every tool that audits more than one scene already walks.
+*
+* `resolveRef(fromFile, ref)` turns a scene-relative `instance` path into the
+* same spelling the corpus uses for that file, so the caller owns all path
+* logic and this stays runnable in a browser.
+*/
+declare function instancedScenes(corpus: {
+  path: string;
+  json: JsonObject;
+}[], resolveRef: (fromFile: string, ref: string) => string): Set<string>;
 declare function auditScene(scene: JsonObject, opts?: AuditOptions): string[];
 //#endregion
 //#region src/core/errors.d.ts
@@ -25,7 +59,7 @@ declare function auditScene(scene: JsonObject, opts?: AuditOptions): string[];
 * Incanto fails loudly with machine-readable codes and messages that list valid
 * alternatives — AI agents self-correct on hard failures, not warnings.
 */
-type IncantoErrorCode = "AMBIGUOUS_HANDLER" | "BAD_FORMAT" | "BAD_NODE_PATH" | "DANGLING_CONNECTION" | "DUPLICATE_BEHAVIOR" | "DUPLICATE_NODE_TYPE" | "DUPLICATE_UNIQUE_NAME" | "DUPLICATE_UID" | "NODE_NOT_FOUND" | "PROP_TYPE_MISMATCH" | "TREE_VIOLATION" | "UNKNOWN_ANIMATION" | "UNKNOWN_ASSET" | "UNKNOWN_CONSTANT" | "UNKNOWN_BEHAVIOR" | "UNKNOWN_HANDLER" | "UNKNOWN_NODE_TYPE" | "UNKNOWN_PROP" | "UNKNOWN_SIGNAL" | "UNRESOLVED_INSTANCE";
+type IncantoErrorCode = "AMBIGUOUS_HANDLER" | "BAD_FORMAT" | "BAD_NODE_PATH" | "DANGLING_CONNECTION" | "DUPLICATE_BEHAVIOR" | "DUPLICATE_NODE_TYPE" | "DUPLICATE_UNIQUE_NAME" | "DUPLICATE_UID" | "NODE_NOT_FOUND" | "PROP_TYPE_MISMATCH" | "TREE_VIOLATION" | "UNKNOWN_ANIMATION" | "UNKNOWN_ASSET" | "UNKNOWN_CONSTANT" | "UNKNOWN_BEHAVIOR" | "UNKNOWN_HANDLER" | "UNKNOWN_NODE_TYPE" | "UNKNOWN_PROP" | "UNKNOWN_SIGNAL" | "UNRESOLVED_INSTANCE" | "WEBGL_UNAVAILABLE";
 /**
 * Structured context mirrored from the prose message — tools and agents parse
 * THESE instead of regexing the message (which is for humans and may reword).
@@ -100,4 +134,4 @@ declare function replay(engine: Engine, recording: ReplayJson, opts?: {
   onTick?: (index: number) => void;
 }): void;
 //#endregion
-export { startRecording as a, IncantoErrorDetails as c, replay as i, auditScene as l, ReplayEvent as n, IncantoError as o, ReplayJson as r, IncantoErrorCode as s, Recorder as t };
+export { startRecording as a, IncantoErrorDetails as c, replay as i, auditScene as l, ReplayEvent as n, IncantoError as o, ReplayJson as r, IncantoErrorCode as s, Recorder as t, instancedScenes as u };

package/dist/{schema-CFeioQRE.d.ts → schema-B6ugCV1Q.d.ts}

@@ -74,6 +74,17 @@ interface SceneJson {
   input?: JsonObject;
   /** Physics config — `{gravity: [x,y]}` (2D px/s²) or `{gravity: [x,y,z]}` (3D m/s²). */
   physics?: JsonObject;
+  /**
+  * This scene is a PIECE of another one — a spawner's prefab, an instanced
+  * sub-scene — and is never rendered on its own.
+  *
+  * It exists because no tool can tell a prefab from a broken first level by
+  * looking at the file: both are a small tree with no camera and no light. The
+  * audit used to guess ("no camera means fragment") and so went silent on the
+  * commonest beginner mistake there is. One key, written by the author who
+  * knows, is the honest version. It changes nothing at runtime.
+  */
+  fragment?: boolean;
   /** Multiplayer config (interpreted in M6; preserved verbatim until then). */
   multiplayer?: JsonObject;
   /** Scene-level rendering environment (ambient light, background — interpreted by renderers). */

package/dist/{sheet-grid-BT6N_Bjs.js → sheet-grid-Cea343VO.js}

@@ -35,7 +35,7 @@ function divisors(total) {
 * 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) {
+function checkSheetGrid(key, frameWidth, frameHeight, imageWidth, imageHeight, highestFrame, unit = "frame") {
 	if (!imageWidth || !imageHeight || !frameWidth || !frameHeight) return null;
 	if (imageWidth % frameWidth !== 0 || imageHeight % frameHeight !== 0) {
 		const parts = [];
@@ -51,7 +51,11 @@ function checkSheetGrid(key, frameWidth, frameHeight, imageWidth, imageHeight, h
 	}
 	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.`;
+		if (highestFrame >= frames) {
+			const sheet = unit === "tile" ? "tile atlas" : "spritesheet";
+			const asks = unit === "tile" ? "a cell asks for tile" : "an animation asks for frame";
+			return `[incanto] ${sheet} '${key}' has ${frames} ${unit}s (0–${frames - 1}), and ${asks} ${highestFrame}. Those ${unit}s draw whatever is at the wrong end of the sheet.`;
+		}
 	}
 	return null;
 }

package/dist/{split-screen-DS8RaUV_.js → split-screen-CauMwu6y.js}

@@ -1,5 +1,5 @@
-import { O as Node, V as Signal, k as diagnose, n as loadScene, t as buildNodeJson } from "./loader-KZESOZmE.js";
-import { t as registerCoreNodes, v as Engine } from "./register-Cs53CY7s.js";
+import { O as Node, V as Signal, k as diagnose, n as loadScene, t as buildNodeJson } from "./loader-DZE7B07H.js";
+import { t as registerCoreNodes, v as Engine } from "./register-mmfugpaQ.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { n as jsonEquals, t as jsonClone } from "./json-CwwhxQgb.js";
 import { l as registerNode } from "./registry-CF70EArN.js";

package/dist/{split-screen-DD5eYIgW.d.ts → split-screen-Cg76MCV5.d.ts}

@@ -1,6 +1,6 @@
-import { Lt as Signal, b as Engine, jt as Node } from "./behavior-ZnfzKDo3.js";
-import { c as JsonValue, i as SceneJson, s as JsonObject } from "./schema-CFeioQRE.js";
-import { t as LoadSceneOptions } from "./loader-DyT30ArB.js";
+import { Lt as Signal, b as Engine, jt as Node } from "./behavior-rm8vVzu_.js";
+import { c as JsonValue, i as SceneJson, s as JsonObject } from "./schema-B6ugCV1Q.js";
+import { t as LoadSceneOptions } from "./loader-DadV2QCT.js";
 
 //#region src/net/types.d.ts
 type Unsubscribe = () => void;

package/dist/{src-BLlsGJW9.js → src-CYEu-_S9.js}

@@ -214,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.67.0";
+const VERSION = "0.69.0";
 //#endregion
 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-LB9cTnXJ.js → teardown-CMqFVxO9.js}

@@ -1,6 +1,6 @@
-import { _ as AudioPlayer } from "./register-Cs53CY7s.js";
-import { i as parseDrive, n as logReport } from "./rendering-options-ByAdi8PF.js";
-import { a as frameSignature, i as frameImage, o as frameStats } from "./frame-report-BSMny7oe.js";
+import { _ as AudioPlayer } from "./register-mmfugpaQ.js";
+import { i as logReport, o as parseDrive } from "./webgl-unavailable-Z5_g8x9H.js";
+import { a as frameSignature, i as frameImage, o as frameStats } from "./frame-report-Dlq13Gyj.js";
 //#region src/core/audio-errors.ts
 /** Every AudioPlayer under `root` whose source could not be played. */
 function audioErrors(root) {
@@ -35,7 +35,7 @@ function claimCanvasGestures(canvas) {
 * empty list outside a dev server.
 */
 function wireDevChannel(opts) {
-	const hot = import.meta.hot;
+	const hot = import.meta.hot ?? globalThis.__incantoInspect;
 	const cleanups = [];
 	if (!hot) return cleanups;
 	const onFrameRequest = (data) => {
@@ -59,6 +59,7 @@ function wireDevChannel(opts) {
 			report: {
 				...frameStats(shot.pixels, shot.width, shot.height, { grid: request?.grid }),
 				signature: frameSignature(shot.pixels, shot.width, shot.height),
+				hidden: typeof document !== "undefined" && document.hidden,
 				...droveFrames === null ? {} : { droveFrames },
 				...request?.image ? { image: frameImage(shot.pixels, shot.width, shot.height, (w, h) => Object.assign(document.createElement("canvas"), {
 					width: w,

package/dist/{test-81uZ967a.js → test-D6ISmuFE.js}

@@ -1,13 +1,13 @@
-import { f as resolveViewport, n as loadScene, z as registerBehavior } from "./loader-KZESOZmE.js";
-import { v as Engine } from "./register-Cs53CY7s.js";
+import { f as resolveViewport, n as loadScene, z as registerBehavior } from "./loader-DZE7B07H.js";
+import { v as Engine } from "./register-mmfugpaQ.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { n as jsonEquals, t as jsonClone } from "./json-CwwhxQgb.js";
 import { i as getNodeSchema, s as mergeStaticProps } from "./registry-CF70EArN.js";
-import { n as startRecording } from "./replay-BkpDV51O.js";
-import { n as registerGameplayBehaviors } from "./gameplay-CGSv-9XR.js";
-import { t as registerNodes2D } from "./register-vIxU3Xbv.js";
-import { n as registerNodes3D, t as resolveEnvironmentHdri } from "./environment-presets-C-5g2pMh.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-DS8RaUV_.js";
+import { n as startRecording } from "./replay-BEHLDcQV.js";
+import { n as registerGameplayBehaviors } from "./gameplay-D1KixWK8.js";
+import { t as registerNodes2D } from "./register-DbVArsns.js";
+import { n as registerNodes3D, t as resolveEnvironmentHdri } from "./environment-presets-BO-7XoFV.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-CauMwu6y.js";
 import { Box3, Euler, Matrix4, PerspectiveCamera, Quaternion, Vector3 } from "three";
 //#region src/test/framing.ts
 /**
@@ -252,7 +252,7 @@ function describeFraming2D(scene, placed, opts) {
 				round(cy),
 				0
 			],
-			view: [vw, vh],
+			view: [round(vw / zoom), round(vh / zoom)],
 			zoom
 		};
 	}
@@ -630,6 +630,23 @@ var Driver = class {
 	headingLeft = 0;
 	visits = /* @__PURE__ */ new Map();
 	buttons;
+	/**
+	* Buttons the bot pressed and will never press again, because pressing them
+	* STOPPED THE CLOCK.
+	*
+	* It drove every declared button action, and `incanto-your-first-game.md`
+	* tells you to declare `pause`. Measured on one losable scene: 0/10 losses
+	* with `pause` declared, 10/10 without it, same seed, same everything else.
+	* A frozen game cannot hurt you, so the run also reported the game as having
+	* no way to lose.
+	*
+	* This is OBSERVED, not guessed from the name — a game is free to call it
+	* `menu`, `escape`, `halt` or nothing at all, and the bot notices the same
+	* way a player would: the world stopped moving.
+	*/
+	frozeTheGame = /* @__PURE__ */ new Set();
+	/** What was pressed most recently, so a freeze can be attributed to it. */
+	lastPressed = null;
 	moveAction;
 	held = /* @__PURE__ */ new Map();
 	/**
@@ -680,7 +697,20 @@ var Driver = class {
 	cell(p) {
 		return `${Math.round(p[0] / 4)},${Math.round(p[2] / 4)}`;
 	}
+	/** Actions this run avoided after they stopped the clock. */
+	paused() {
+		return [...this.frozeTheGame];
+	}
 	step(dt, at) {
+		if (this.engine.timeScale === 0) {
+			if (this.lastPressed) this.frozeTheGame.add(this.lastPressed);
+			for (const button of this.buttons) {
+				this.engine.input.releaseAction(button);
+				this.held.set(button, -1);
+			}
+			this.engine.timeScale = 1;
+			this.lastPressed = null;
+		}
 		this.visits.set(this.cell(at), (this.visits.get(this.cell(at)) ?? 0) + 1);
 		this.headingLeft -= dt;
 		if (this.headingLeft <= 0) {
@@ -689,6 +719,7 @@ var Driver = class {
 		}
 		if (this.moveAction) this.engine.input.setActionVector(this.moveAction, Math.cos(this.heading), Math.sin(this.heading));
 		for (const button of this.buttons) {
+			if (this.frozeTheGame.has(button)) continue;
 			const left = (this.held.get(button) ?? 0) - dt;
 			if (left > 0) {
 				this.held.set(button, left);
@@ -702,6 +733,7 @@ var Driver = class {
 			const chance = button === "jump" ? .06 : .02;
 			if (this.rand() < chance) {
 				this.engine.input.pressAction(button);
+				this.lastPressed = button;
 				this.held.set(button, .08 + this.rand() * .12);
 			}
 		}
@@ -820,9 +852,10 @@ async function runOnce(json, seed, opts) {
 	});
 	let at = start;
 	let wentAsFarAs = 0;
+	const travelled = (a, b) => scene.dimension === "2d" ? Math.hypot((a[0] ?? 0) - (b[0] ?? 0), (a[1] ?? 0) - (b[1] ?? 0)) : Math.hypot((a[0] ?? 0) - (b[0] ?? 0), (a[2] ?? 0) - (b[2] ?? 0));
 	while (session.timeMs < deadline) {
 		at = player ? worldOf(player) : start;
-		wentAsFarAs = Math.max(wentAsFarAs, Math.hypot(at[0] - start[0], at[2] - start[2]));
+		wentAsFarAs = Math.max(wentAsFarAs, travelled(at, start));
 		driver.step(stepMs / 1e3, at);
 		session.step(stepMs);
 		if (player) for (const [path, node] of targetNodes) {
@@ -878,7 +911,8 @@ async function runOnce(json, seed, opts) {
 		signals,
 		declaresEnd: oracle.declaresEnd(),
 		hazards,
-		hasPlayer: player !== null
+		hasPlayer: player !== null,
+		froze: driver.paused()
 	};
 }
 /**
@@ -908,6 +942,7 @@ async function playtest(json, opts = {}) {
 	let declaresWin = false;
 	let hasPlayer = false;
 	let hazards = 0;
+	const froze = /* @__PURE__ */ new Set();
 	for (let i = 0; i < count; i++) {
 		const one = await runOnce(json, base + i, opts);
 		runs.push(one.run);
@@ -916,6 +951,7 @@ async function playtest(json, opts = {}) {
 		declaresWin = declaresWin || one.declaresEnd;
 		hasPlayer = hasPlayer || one.hasPlayer;
 		hazards = one.hazards;
+		for (const action of one.froze) froze.add(action);
 	}
 	const probe = await createPlaySession(json, {
 		seed: base,
@@ -946,6 +982,7 @@ async function playtest(json, opts = {}) {
 		declaresWin,
 		hasPlayer,
 		hazards,
+		froze: [...froze],
 		seconds: opts.seconds ?? 60,
 		feedback: {
 			declaredAudio: feedbackNodes.audio,
@@ -1016,8 +1053,14 @@ function playtestText(report) {
 		if (silent.length > 12) lines.push(`    …and ${silent.length - 12} more`);
 	}
 	const damage = runs.reduce((n, r) => n + r.damageTaken, 0);
+	const lost = runs.filter((r) => r.outcome === "lost").length;
+	if (report.froze.length > 0) {
+		lines.push("");
+		lines.push(`  · the bot stopped pressing ${report.froze.map((a) => `\`${a}\``).join(", ")} — pressing it stopped the clock, and a run spent inside a pause menu measures nothing. Your game is fine; this is the bot getting out of its own way.`);
+	}
 	lines.push("");
 	if (damage > 0) lines.push(`  danger: ${damage} hits across ${total} runs (${(damage / total).toFixed(1)} per run)`);
+	else if (hazards === 0 && lost > 0) lines.push(`  danger: nothing DEALT DAMAGE — no DamageOnContact, no hazard group — and yet ${lost} of ${total} runs were lost. The loss comes from something else: a fall, a timer, a trigger, or running out of lives.`);
 	else if (hazards === 0) lines.push("  danger: nothing in this scene can hurt the player — no DamageOnContact, no hazard group. A game with no way to lose is a walkabout.");
 	else lines.push(`  danger: ${hazards} hazard(s) are wired and none of them landed a hit in ${total} runs. They may be unreachable — or the bot may simply have outrun them, which a real player would not. Judge it with a scripted run.`);
 	return lines.join("\n");
@@ -1812,8 +1855,8 @@ async function playMultiplayer(opts) {
 */
 async function joinLate(server, first, opts) {
 	try {
-		const { Engine } = await import("./register-Cs53CY7s.js").then((n) => n.y);
-		const { loadScene } = await import("./loader-KZESOZmE.js").then((n) => n.r);
+		const { Engine } = await import("./register-mmfugpaQ.js").then((n) => n.y);
+		const { loadScene } = await import("./loader-DZE7B07H.js").then((n) => n.r);
 		const { jsonClone } = await import("./json-CwwhxQgb.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));
@@ -2175,20 +2218,23 @@ 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-_B6zj3zU.js").then((n) => n.r);
+		const { enablePhysics2D } = await import("./physics-2d-CF5yyjbj.js").then((n) => n.r);
 		await enablePhysics2D(engine);
 	} else if (physics === "3d" || physics === "auto" && scene.dimension === "3d") {
-		const { enablePhysics3D } = await import("./physics-3d-i1IeAY0F.js").then((n) => n.r);
+		const { enablePhysics3D } = await import("./physics-3d-DbYaEcZy.js").then((n) => n.r);
 		await enablePhysics3D(engine);
 	}
 	const failures = [];
 	const snapshots = [];
+	const live = () => engine.scene ?? scene;
 	const ctx = {
 		engine,
-		scene,
+		get scene() {
+			return live();
+		},
 		timeMs: 0,
-		getNode: (path) => scene.root.getNode(path),
-		capture: () => captureScene(scene)
+		getNode: (path) => live().root.getNode(path),
+		capture: () => captureScene(live())
 	};
 	const applyStep = (step) => {
 		if (step.press) engine.input.pressAction(step.press);
@@ -2226,7 +2272,7 @@ async function runScript(json, opts) {
 		if (t >= nextSnapshot - 1e-6) {
 			snapshots.push({
 				atMs: Math.round(t),
-				capture: captureScene(scene)
+				capture: captureScene(live())
 			});
 			nextSnapshot += opts.snapshotEveryMs;
 		}
@@ -2239,7 +2285,7 @@ async function runScript(json, opts) {
 			message: `step never executed — atMs ${missed.atMs} is beyond the ${opts.durationMs}ms run`
 		});
 	}
-	const finalCapture = captureScene(scene);
+	const finalCapture = captureScene(live());
 	const logs = [...engine.log.entries()];
 	const swallowed = engine.stats().errors;
 	if (swallowed > 0) failures.push({
@@ -2291,10 +2337,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-_B6zj3zU.js").then((n) => n.r);
+		const { enablePhysics2D } = await import("./physics-2d-CF5yyjbj.js").then((n) => n.r);
 		await enablePhysics2D(engine);
 	} else if (physics === "3d" || physics === "auto" && scene.dimension === "3d") {
-		const { enablePhysics3D } = await import("./physics-3d-i1IeAY0F.js").then((n) => n.r);
+		const { enablePhysics3D } = await import("./physics-3d-DbYaEcZy.js").then((n) => n.r);
 		await enablePhysics3D(engine);
 	}
 	const stepMs = 1e3 / (opts.fixedHz ?? 60);
@@ -2302,7 +2348,9 @@ async function createPlaySession(json, opts = {}) {
 	let logCursor = 0;
 	return {
 		engine,
-		scene,
+		get scene() {
+			return engine.scene ?? scene;
+		},
 		get timeMs() {
 			return timeMs;
 		},
@@ -2312,13 +2360,13 @@ async function createPlaySession(json, opts = {}) {
 			timeMs += ticks * stepMs;
 		},
 		capture() {
-			return scene.toJSON();
+			return (engine.scene ?? scene).toJSON();
 		},
 		describe() {
-			return describeCapture(captureScene(scene));
+			return describeCapture(captureScene(engine.scene ?? scene));
 		},
 		framing() {
-			return framingText(describeFraming(scene));
+			return framingText(describeFraming(engine.scene ?? scene));
 		},
 		drainLogs() {
 			const all = engine.log.entries();

package/dist/test.d.ts

@@ -1,8 +1,8 @@
-import { P as Scene, Pt as LogEntry, b as Engine, jt as Node, n as BehaviorCtor } from "./behavior-ZnfzKDo3.js";
-import { c as JsonValue, i as SceneJson, s as JsonObject } from "./schema-CFeioQRE.js";
-import { t as LoadSceneOptions } from "./loader-DyT30ArB.js";
-import { l as auditScene, o as IncantoError, r as ReplayJson } from "./replay-D0GcEHYU.js";
-import { l as LocalGameServerOptions, n as SplitScreenPlayer } from "./split-screen-DD5eYIgW.js";
+import { P as Scene, Pt as LogEntry, b as Engine, jt as Node, n as BehaviorCtor } from "./behavior-rm8vVzu_.js";
+import { c as JsonValue, i as SceneJson, s as JsonObject } from "./schema-B6ugCV1Q.js";
+import { t as LoadSceneOptions } from "./loader-DadV2QCT.js";
+import { l as auditScene, o as IncantoError, r as ReplayJson, u as instancedScenes } from "./replay-BQfkX4x7.js";
+import { l as LocalGameServerOptions, n as SplitScreenPlayer } from "./split-screen-Cg76MCV5.js";
 
 //#region src/test/facing.d.ts
 interface FacingOptions {
@@ -361,6 +361,17 @@ interface PlaytestReport {
   /** How many nodes are wired to hurt the player — see the `danger:` line. */
   hazards: number;
   /**
+  * Actions the bot stopped pressing because they STOPPED THE CLOCK.
+  *
+  * It drove every declared button, and `incanto-your-first-game.md` tells you
+  * to declare `pause`. Measured on one losable scene: 0/10 losses with `pause`
+  * declared, 10/10 without, everything else identical — a frozen game cannot
+  * hurt you, so the same run also reported the game as having no way to lose.
+  * Named here rather than guessed from the word "pause": a game may call it
+  * `menu` or `escape`, and the bot notices the way a player would.
+  */
+  froze: string[];
+  /**
   * Did `findPlayer` find anyone to drive?
   *
   * `findPlayer`'s own comment says a scene it cannot drive "says so rather
@@ -689,4 +700,4 @@ interface PlaySession {
 */
 declare function createPlaySession(json: unknown, opts?: PlaySessionOptions): Promise<PlaySession>;
 //#endregion
-export { type AgreementSnapshot, 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, PlaySession, PlaySessionOptions, type PlaytestOptions, type PlaytestReport, type PlaytestRun, RunContext, RunFailure, RunResult, RunScriptOptions, type RungResult, type RungStatus, SceneCapture, ScriptStep, ValidateSceneOptions, ValidationResult, type Where, agreementProblems, auditScene, captureScene, createPlaySession, describeCapture, describeFraming, facingReport, facingText, failingReplays, feelReport, feelText, findFloatingProps, findPlayer, framingText, ladderText, ladderVerdict, multiplayProblems, multiplayText, playMultiplayer, playtest, playtestText, registerAllNodes, runScript, takeAgreementSnapshots, validateScene };
+export { type AgreementSnapshot, 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, PlaySession, PlaySessionOptions, type PlaytestOptions, type PlaytestReport, type PlaytestRun, RunContext, RunFailure, RunResult, RunScriptOptions, type RungResult, type RungStatus, SceneCapture, ScriptStep, ValidateSceneOptions, ValidationResult, type Where, agreementProblems, auditScene, captureScene, createPlaySession, describeCapture, describeFraming, facingReport, facingText, failingReplays, feelReport, feelText, findFloatingProps, findPlayer, framingText, instancedScenes, ladderText, ladderVerdict, multiplayProblems, multiplayText, playMultiplayer, playtest, playtestText, registerAllNodes, runScript, takeAgreementSnapshots, validateScene };

package/dist/test.js

@@ -1,3 +1,3 @@
-import { r as auditScene } from "./replay-BkpDV51O.js";
-import { C as describeFraming, S as playtestText, _ as facingReport, a as registerAllNodes, b as findPlayer, c as ladderText, d as multiplayText, f as playMultiplayer, g as agreementProblems, h as takeAgreementSnapshots, 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 facingText, w as framingText, x as playtest, y as failingReplays } from "./test-81uZ967a.js";
-export { agreementProblems, auditScene, captureScene, createPlaySession, describeCapture, describeFraming, facingReport, facingText, failingReplays, feelReport, feelText, findFloatingProps, findPlayer, framingText, ladderText, ladderVerdict, multiplayProblems, multiplayText, playMultiplayer, playtest, playtestText, registerAllNodes, runScript, takeAgreementSnapshots, validateScene };
+import { i as instancedScenes, r as auditScene } from "./replay-BEHLDcQV.js";
+import { C as describeFraming, S as playtestText, _ as facingReport, a as registerAllNodes, b as findPlayer, c as ladderText, d as multiplayText, f as playMultiplayer, g as agreementProblems, h as takeAgreementSnapshots, 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 facingText, w as framingText, x as playtest, y as failingReplays } from "./test-D6ISmuFE.js";
+export { agreementProblems, auditScene, captureScene, createPlaySession, describeCapture, describeFraming, facingReport, facingText, failingReplays, feelReport, feelText, findFloatingProps, findPlayer, framingText, instancedScenes, ladderText, ladderVerdict, multiplayProblems, multiplayText, playMultiplayer, playtest, playtestText, registerAllNodes, runScript, takeAgreementSnapshots, validateScene };

package/dist/vite.d.ts

@@ -1,4 +1,4 @@
-import { n as FrameSignature } from "./frame-report-DCnHFmto.js";
+import { n as FrameSignature } from "./frame-report-DNxDAb1w.js";
 
 //#region src/vite/discover.d.ts
 /**
@@ -76,6 +76,74 @@ interface FrameEndpointOptions {
 }
 declare function serveFrameEndpoints(host: FrameHost, version: string, opts?: FrameEndpointOptions): void;
 //#endregion
+//#region src/vite/static-inspect.d.ts
+interface StaticInspectHost extends FrameHost {
+  /** Handle `/__incanto/pull` and `/__incanto/push`; returns false if not ours. */
+  handleInspect(req: FrameReq, res: FrameRes): boolean;
+  /** The `<script>` to inject ahead of the game, as page source. */
+  clientScript(): string;
+}
+/**
+* Build a `FrameHost` whose channel is a long poll.
+*
+* `use(path, handler)` records middleware the caller dispatches; `hot` is a
+* channel that queues outgoing requests and delivers the page's replies.
+*/
+declare function createStaticInspectHost(root: string): StaticInspectHost;
+//#endregion
+//#region src/vite/trim.d.ts
+/**
+* Leave out of the BUILD what this game can never run.
+*
+* A 2D game's `dist/` contains the 3D adapter and rapier3d. Measured on the
+* shipped `platformer-2d` flagship:
+*
+* ```
+* 2236503  assets/rapier-*.js    # rapier3d
+* 1692150  assets/rapier-*.js    # rapier2d — the one it uses
+*  471186  assets/3d-*.js        # the 3D adapter
+* ─────────
+* 5942650  total  →  45.6% of it can never execute
+* ```
+*
+* Nothing is wrong at RUNTIME: the chunks are lazy and never requested. This is
+* deploy weight — a CDN, a jam upload, an agent8 zip — and the only path that
+* drags them in is the live game⇄editor switch: `createGame*` imports
+* `incanto/editor`, and the editor imports `incanto/3d` so it can offer 3D node
+* types.
+*
+* `editor: false` on `createGame*` is a RUNTIME option and cannot remove bytes
+* from a bundle; it changed the artifact by 10 bytes while the docs said it
+* "opts out". A build-time decision needs a build-time lever, which is this.
+*
+* ```ts
+* import { incantoScenes, incantoTrim } from 'incanto/vite';
+* export default defineConfig({
+*   plugins: [incantoScenes(), incantoTrim({ editor: false })],
+* });
+* ```
+*
+* Build only — the dev server keeps the editor, so `☰ debug ▸ ✎ edit this
+* scene` works while you are building the game and is simply absent from what
+* you ship.
+*/
+interface IncantoTrimOptions {
+  /**
+  * Keep the in-game scene editor in the build. Default `false` when this
+  * plugin is used at all — using it is the request.
+  */
+  editor?: boolean;
+}
+/** Minimal plugin shape, so this file needs no vite types. */
+interface TrimPlugin {
+  name: string;
+  apply: "build";
+  enforce: "pre";
+  resolveId(id: string): string | null;
+  load(id: string): string | null;
+}
+declare function incantoTrim(opts?: IncantoTrimOptions): TrimPlugin;
+//#endregion
 //#region src/vite/index.d.ts
 interface HotUpdateContext {
   file: string;
@@ -259,4 +327,4 @@ declare function serveDeviceAuth(req: LibraryReq, res: LibraryRes, opts?: Incant
 /** @internal Exported for tests — the whole request/response behaviour. */
 declare function serveLibrary(req: LibraryReq, res: LibraryRes, opts?: IncantoLibraryOptions, doFetch?: typeof fetch): Promise<void>;
 //#endregion
-export { type FrameHost, IncantoLibraryOptions, IncantoScenesOptions, ProjectFileEntry, discoverScenes, incantoLibrary, incantoScenes, listeningPorts, maskToken, parseProcNetTcp, resolveSceneFile, sceneFacts, serveDeviceAuth, serveFrameEndpoints, serveLibrary, serveSceneFile, serveSceneList, serveTokenStatus };
+export { type FrameHost, type FrameReq, type FrameRes, IncantoLibraryOptions, IncantoScenesOptions, type IncantoTrimOptions, ProjectFileEntry, type StaticInspectHost, createStaticInspectHost, discoverScenes, incantoLibrary, incantoScenes, incantoTrim, listeningPorts, maskToken, parseProcNetTcp, resolveSceneFile, sceneFacts, serveDeviceAuth, serveFrameEndpoints, serveLibrary, serveSceneFile, serveSceneList, serveTokenStatus };