incanto 0.60.0 → 0.62.0

package/dist/{replay-BlNuIDdg.js → replay-DlgHItNv.js}

@@ -1,196 +1,6 @@
-import { D as behaviorSchema, T as parseNodePath } from "./loader-D8n7TU8W.js";
-import { L as translationKey, O as HudWidgetBase } from "./register-Da3hXh2H.js";
-import { i as getNodeSchema, o as getNodeType } from "./registry-WWcQcfMr.js";
-//#region src/core/node-refs.ts
-/**
-* Node-path PROPS, resolved against scene JSON.
-*
-* `Chase.target`, `Camera2D.follow`, `Spawner.prefab`, `Joint3D.target`,
-* `CharacterController3D.skinPath`, `Foliage3D.terrain` … each holds a path to
-* another node, and nothing checked any of them. A connection whose end does not
-* resolve is a hard `DANGLING_CONNECTION` at load; a PROP that does not resolve
-* is nothing at all — `getNodeOrNull` returns null, the scene loads, the enemy
-* never chases, and no error is ever printed.
-*
-* That makes it exactly the class `auditScene` exists for: loads fine, plays
-* wrong. The editor uses the same resolver so the two cannot drift.
-*
-* The grammar comes from `parseNodePath` — the loader's own parser — so a path
-* this module accepts is one the engine accepts.
-*/
-function nodeAt(root, path) {
-	let node = root;
-	for (const index of path) {
-		node = node?.children?.[index];
-		if (!node) return null;
-	}
-	return node ?? null;
-}
-function byName(root, name) {
-	const found = [];
-	const walk = (node, at) => {
-		if (node.name === name) found.push(at);
-		(node.children ?? []).forEach((child, i) => {
-			walk(child, [...at, i]);
-		});
-	};
-	walk(root, []);
-	return found;
-}
-/**
-* Resolve `value` from the node at `owner`, the way the engine would.
-*
-* Note the asymmetry with connections, whose paths resolve from the SCENE ROOT:
-* a prop's path resolves from the node holding it, which is why `'../Skin'` is
-* the documented default of `CharacterController3D.skinPath` and would mean
-* nothing in a connection.
-*/
-function resolveRefInJson(root, owner, value) {
-	if (!root) return {
-		ok: false,
-		problem: {
-			kind: "noMatch",
-			name: value
-		}
-	};
-	let parsed;
-	try {
-		parsed = parseNodePath(value);
-	} catch (error) {
-		return {
-			ok: false,
-			problem: {
-				kind: "grammar",
-				message: error instanceof Error ? error.message : String(error)
-			}
-		};
-	}
-	if (parsed.kind === "unique") {
-		const found = byName(root, parsed.name);
-		if (found.length === 1) return {
-			ok: true,
-			path: found[0]
-		};
-		if (found.length === 0) return {
-			ok: false,
-			problem: {
-				kind: "noMatch",
-				name: parsed.name
-			}
-		};
-		return {
-			ok: false,
-			problem: {
-				kind: "ambiguous",
-				name: parsed.name,
-				count: found.length
-			}
-		};
-	}
-	let at;
-	let segments = parsed.segments;
-	if (parsed.kind === "absolute") {
-		const first = segments[0] ?? "";
-		if (first !== root.name && first !== "root") return {
-			ok: false,
-			problem: {
-				kind: "wrongRoot",
-				first,
-				root: String(root.name ?? "")
-			}
-		};
-		at = [];
-		segments = segments.slice(1);
-	} else at = [...owner];
-	for (const segment of segments) {
-		if (segment === "..") {
-			if (at.length === 0) return {
-				ok: false,
-				problem: { kind: "aboveRoot" }
-			};
-			at.pop();
-			continue;
-		}
-		const here = nodeAt(root, at);
-		const index = (here?.children ?? []).findIndex((child) => child.name === segment);
-		if (index < 0) return {
-			ok: false,
-			problem: {
-				kind: "noChild",
-				parent: String(here?.name ?? "?"),
-				segment
-			}
-		};
-		at.push(index);
-	}
-	return {
-		ok: true,
-		path: at
-	};
-}
-/** The problem in English, for `incanto-check` and as the editor's base text. */
-function describeRefProblem(problem, value) {
-	switch (problem.kind) {
-		case "grammar": return problem.message;
-		case "noMatch": return `'%${problem.name}' matches no node in this scene.`;
-		case "ambiguous": return `'%${problem.name}' matches ${problem.count} nodes — a %name must be unique.`;
-		case "wrongRoot": return `'${value}' starts at '${problem.first}', but the scene root is '${problem.root}' (or write '/root/…').`;
-		case "noChild": return `'${value}' leads nowhere — '${problem.parent}' has no child named '${problem.segment}'.`;
-		case "aboveRoot": return `'${value}' walks above the scene root.`;
-	}
-}
-/** Every prop on this node declared `nodePath: true`, per bag. */
-function refProps(node) {
-	const collect = (schema) => Object.entries(schema).filter(([, def]) => def?.nodePath).map(([key]) => key);
-	let props = [];
-	if (node.type) try {
-		props = collect(getNodeSchema(node.type));
-	} catch {}
-	const name = node.script?.name;
-	return {
-		props,
-		script: name ? collect(behaviorSchema(name)) : []
-	};
-}
-/**
-* Scene lints for node-path props that point at nothing.
-*
-* An EMPTY value is not reported: `''` is the default of most of these props and
-* means "not set", which is a choice rather than a typo.
-*/
-function nodeRefWarnings(scene) {
-	const root = scene.root;
-	if (!root) return [];
-	const warnings = [];
-	const walk = (node, at, path) => {
-		const keys = refProps(node);
-		const bags = [[
-			node.props,
-			keys.props,
-			""
-		], [
-			node.script?.props,
-			keys.script,
-			`${node.script?.name ?? "script"}.`
-		]];
-		for (const [bag, propKeys, prefix] of bags) {
-			if (!bag) continue;
-			for (const key of propKeys) {
-				const value = bag[key];
-				if (typeof value !== "string" || value === "") continue;
-				const result = resolveRefInJson(root, at, value);
-				if (result.ok) continue;
-				warnings.push(`${path}: ${prefix}${key} — ${describeRefProblem(result.problem, value)} The scene loads and the prop does nothing.`);
-			}
-		}
-		(node.children ?? []).forEach((child, i) => {
-			walk(child, [...at, i], `${path}/${child.name ?? "?"}`);
-		});
-	};
-	walk(root, [], String(root.name ?? "root"));
-	return warnings;
-}
-//#endregion
+import { D as handlerShadowWarnings, j as nodeRefWarnings } from "./loader-DEe272nY.js";
+import { R as translationKey, k as HudWidgetBase } from "./register-D3yx8D4r.js";
+import { o as getNodeType } from "./registry-CF70EArN.js";
 //#region src/core/audit.ts
 const ANIMATED_TYPES = new Set([
 	"Particles2D",
@@ -244,6 +54,18 @@ const LIGHT_TYPES = new Set([
 	"SpotLight3D"
 ]);
 /**
+* Nodes whose gameplay answer comes from a CPU twin built out of `size`.
+*
+* `Terrain3D.heightAt`, the heightfield collider and `Water3D._waterYAt` all
+* read `size` and compose ancestor POSITIONS only, so an ancestor that scales
+* or rotates them moves the picture and not the answer.
+*/
+const WORLD_QUERY_TYPES = new Set([
+	"Terrain3D",
+	"Water3D",
+	"River3D"
+]);
+/**
 * Built-ins that put something in a save. A save is keyed by node uid, so one
 * of these on a node without one is state that silently goes nowhere: the save
 * comes back `{}` and the load reports a clean bill, because "nothing was
@@ -266,6 +88,22 @@ function isLit(environment) {
 	const ambient = environment.ambient;
 	return typeof ambient?.intensity === "number" && ambient.intensity > 0;
 }
+/**
+* Which of this node's own transforms physics cannot compose, if any.
+*
+* Offsets compose; rotation and scale do not — the body is placed at its WORLD
+* position and given its OWN rotation, so an ancestor's is simply lost.
+*/
+function transformOf(props) {
+	const rot = props.rotation;
+	const scale = props.scale;
+	const turned = typeof rot === "number" ? rot !== 0 : Array.isArray(rot) && rot.some((v) => typeof v === "number" && v !== 0);
+	const scaled = Array.isArray(scale) && scale.some((v) => typeof v === "number" && v !== 1);
+	if (turned && scaled) return "rotation and scale";
+	if (turned) return "rotation";
+	if (scaled) return "scale";
+	return null;
+}
 function auditScene(scene, opts = {}) {
 	const warnings = [];
 	const root = scene.root;
@@ -273,17 +111,29 @@ function auditScene(scene, opts = {}) {
 	let currentCameras = 0;
 	let cameras = 0;
 	let lights = 0;
+	/** Nodes that drive the current camera themselves — see the warning below. */
+	const cameraDrivers = [];
+	const followedCameras = [];
 	const needUid = [];
-	const walk = (node, path, insideHud, staticRoot) => {
+	const walk = (node, path, insideHud, staticRoot, transformed) => {
 		const type = node.type ?? "";
 		const props = node.props ?? {};
 		const script = node.script?.name;
 		if (script && SAVEABLE_SCRIPTS.has(script) && !node.uid) needUid.push(`${path} (${script})`);
+		if (type === "AudioPlayer" && props.spatial === true && scene.dimension === "2d") {
+			const ref = props.refDistance;
+			const max = props.maxDistance;
+			if (ref === void 0 && max === void 0) warnings.push(`${path}: spatial audio in a 2D scene measures distance in PIXELS, and "refDistance"/"maxDistance" default to 1 and 50 — about one sprite, so the sound is at its quietest almost immediately. Set them to your level's scale (e.g. 100 and 900).`);
+		}
 		if (type === "Camera2D" || type === "Camera3D") {
 			cameras += 1;
 			if (props.current === true) currentCameras += 1;
+			if (script === "FollowCamera") followedCameras.push(path);
 		}
+		if (type === "CharacterController3D") cameraDrivers.push(path);
 		if (LIGHT_TYPES.has(type)) lights += 1;
+		if (BODY_TYPES.has(type) && transformed) warnings.push(`${path}: ${type} sits under '${transformed.path}', whose ${transformed.what} physics cannot compose — the collider will not line up with what is drawn. Keep body ancestors untransformed or translation-only, or put the body outside them.`);
+		if (WORLD_QUERY_TYPES.has(type) && transformed) warnings.push(`${path}: ${type} sits under '${transformed.path}', whose ${transformed.what} it cannot compose — the ground (or water) you can see would not be the ground you can stand on. Keep its ancestors untransformed or translation-only.`);
 		if (BODY_TYPES.has(type)) {
 			const collider = props.collider;
 			if (!collider || collider.shape === void 0) warnings.push(`${path}: ${type} has no collider — physics will skip it (add "collider": { "shape": ... }).`);
@@ -292,14 +142,24 @@ function auditScene(scene, opts = {}) {
 		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";
-		for (const child of node.children ?? []) walk(child, `${path}/${child.name ?? "?"}`, nextHud, nextStatic);
+		const own = transformOf(props);
+		const nextTransformed = own ? {
+			path,
+			what: own
+		} : transformed;
+		for (const child of node.children ?? []) walk(child, `${path}/${child.name ?? "?"}`, nextHud, nextStatic, nextTransformed);
 	};
-	walk(root, root.name ?? "root", false, root.props?.static === true ? root.name ?? "root" : null);
+	walk(root, root.name ?? "root", false, root.props?.static === true ? root.name ?? "root" : null, transformOf(root.props ?? {}) ? {
+		path: root.name ?? "root",
+		what: transformOf(root.props ?? {})
+	} : null);
 	if (needUid.length > 0) warnings.push(`these carry state a save keeps and have no uid to key it under, so the save comes back EMPTY and the load reports no problem: ${needUid.join(", ")}. Give each one a "uid" from newUid().`);
+	if (cameraDrivers.length > 0 && followedCameras.length > 0) warnings.push(`${followedCameras.join(", ")}: a FollowCamera writes this camera's position every frame, and so does the CharacterController3D at ${cameraDrivers.join(", ")} — the controller owns the camera in every view it has. Drop one of them: use the controller's own \`view\`/\`camDistance\`, or take the controller off the camera duty.`);
 	if (cameras > 0 && currentCameras === 0) warnings.push("no camera has \"current\": true — the screen renders from a default view, probably not what you framed.");
 	if (currentCameras > 1) warnings.push(`${currentCameras} cameras claim "current": true — only the first found wins.`);
 	if (scene.dimension === "3d" && lights === 0 && !isLit(scene.environment)) warnings.push("nothing lights this 3D scene — no light node, no environment sky/hdri, and no ambient intensity. It will render black. Add a DirectionalLight3D, or an \"environment\": { \"sky\": { \"type\": \"atmosphere\" } } / { \"preset\": \"...\" }.");
 	for (const warning of nodeRefWarnings(scene)) warnings.push(warning);
+	for (const warning of handlerShadowWarnings(scene)) warnings.push(warning);
 	for (const warning of auditStrings(scene, opts.declaredElsewhere)) warnings.push(warning);
 	return warnings;
 }
@@ -458,4 +318,4 @@ function replay(engine, recording, opts) {
 	}
 }
 //#endregion
-export { nodeRefWarnings as a, describeRefProblem as i, startRecording as n, resolveRefInJson as o, auditScene as r, replay as t };
+export { startRecording as n, auditScene as r, replay as t };

package/dist/{split-screen-CL5Yvxse.js → split-screen-CBM9wcMX.js}

@@ -1,8 +1,8 @@
-import { C as Node, N as Signal, n as loadScene, t as buildNodeJson, w as diagnose } from "./loader-D8n7TU8W.js";
-import { _ as Engine, t as registerCoreNodes } from "./register-Da3hXh2H.js";
+import { O as Node, V as Signal, k as diagnose, n as loadScene, t as buildNodeJson } from "./loader-DEe272nY.js";
+import { t as registerCoreNodes, v as Engine } from "./register-D3yx8D4r.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-WWcQcfMr.js";
+import { l as registerNode } from "./registry-CF70EArN.js";
 //#region src/net/loopback.ts
 /**
 * In-memory multiplayer hub implementing the SAME kernel contract as

package/dist/{split-screen-BQ3tAsf-.d.ts → split-screen-D7OopelJ.d.ts}

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

package/dist/{src-DFpXBMJN.js → src-CH00_JsR.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.60.0";
+const VERSION = "0.62.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-CTTwhWSe.js → teardown-C7qP-dcC.js}

@@ -1,4 +1,4 @@
-import { g as AudioPlayer } from "./register-Da3hXh2H.js";
+import { _ as AudioPlayer } from "./register-D3yx8D4r.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

package/dist/{test-BeZ95pqw.js → test-BMkg8zMV.js}

@@ -1,13 +1,13 @@
-import { c as resolveViewport, j as registerBehavior, n as loadScene } from "./loader-D8n7TU8W.js";
-import { _ as Engine } from "./register-Da3hXh2H.js";
+import { f as resolveViewport, n as loadScene, z as registerBehavior } from "./loader-DEe272nY.js";
+import { v as Engine } from "./register-D3yx8D4r.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-WWcQcfMr.js";
-import { n as startRecording } from "./replay-BlNuIDdg.js";
-import { n as registerGameplayBehaviors } from "./gameplay-BBEjPFsR.js";
-import { t as registerNodes2D } from "./register-BSu2dWGC.js";
-import { n as registerNodes3D, t as resolveEnvironmentHdri } from "./environment-presets-8cjF3t6w.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-CL5Yvxse.js";
+import { i as getNodeSchema, s as mergeStaticProps } from "./registry-CF70EArN.js";
+import { n as startRecording } from "./replay-DlgHItNv.js";
+import { n as registerGameplayBehaviors } from "./gameplay-CaHqDiQD.js";
+import { t as registerNodes2D } from "./register-CNh4FlbD.js";
+import { n as registerNodes3D, t as resolveEnvironmentHdri } from "./environment-presets-BAWeOeqf.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-CBM9wcMX.js";
 import { Box3, Euler, Matrix4, PerspectiveCamera, Quaternion, Vector3 } from "three";
 //#region src/test/framing.ts
 /**
@@ -799,7 +799,8 @@ async function runOnce(json, seed, opts) {
 		run,
 		targets,
 		signals,
-		declaresEnd: oracle.declaresEnd()
+		declaresEnd: oracle.declaresEnd(),
+		hasPlayer: player !== null
 	};
 }
 /** Play the scene `runs` times and report what happened. */
@@ -810,12 +811,14 @@ async function playtest(json, opts = {}) {
 	let targets = [];
 	let signals = [];
 	let declaresWin = false;
+	let hasPlayer = false;
 	for (let i = 0; i < count; i++) {
 		const one = await runOnce(json, base + i, opts);
 		runs.push(one.run);
 		targets = one.targets;
 		signals = one.signals;
 		declaresWin = declaresWin || one.declaresEnd;
+		hasPlayer = hasPlayer || one.hasPlayer;
 	}
 	const probe = await createPlaySession(json, {
 		seed: base,
@@ -844,6 +847,7 @@ async function playtest(json, opts = {}) {
 		actions,
 		inertActions: [],
 		declaresWin,
+		hasPlayer,
 		seconds: opts.seconds ?? 60,
 		feedback: {
 			declaredAudio: feedbackNodes.audio,
@@ -876,6 +880,10 @@ function playtestText(report) {
 	const won = runs.filter((r) => r.outcome === "won");
 	if (won.length > 0) lines.push(`  ✓ reached "won" in ${pct(won.length, total)}   median ${Math.round(median(won.map((r) => r.timeMs)) / 1e3)}s`);
 	else lines.push(report.declaresWin ? `  ✗ never reached "won" in ${total} runs — a win IS declared, and no run got to it` : `  · no win declared in this scene — nothing emits won/lost, so there is nothing to reach`);
+	if (!report.hasPlayer) {
+		lines.push("  · nothing here is drivable — no character controller, no node in the `player` group, no node named Player. The runs went nowhere because there was nobody to move, not because anything is wedged.");
+		return lines.join("\n");
+	}
 	for (const bad of [
 		"error",
 		"fell",
@@ -1669,8 +1677,8 @@ async function playMultiplayer(opts) {
 */
 async function joinLate(server, first, opts) {
 	try {
-		const { Engine } = await import("./register-Da3hXh2H.js").then((n) => n.v);
-		const { loadScene } = await import("./loader-D8n7TU8W.js").then((n) => n.r);
+		const { Engine } = await import("./register-D3yx8D4r.js").then((n) => n.y);
+		const { loadScene } = await import("./loader-DEe272nY.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));
@@ -1786,7 +1794,11 @@ function ladderText(v) {
 		].join("\n");
 		return "nothing to verify — no scene was given and none was found";
 	}
-	const lines = v.rungs.map((r) => `${MARK[r.status]} ${r.name} — ${r.summary}`);
+	const lines = [];
+	for (const r of v.rungs) {
+		lines.push(`${MARK[r.status]} ${r.name} — ${r.summary}`);
+		for (const note of r.notes ?? []) lines.push(`    ! ${note}`);
+	}
 	lines.push("");
 	if (!v.ok) lines.push("NOT verified.");
 	else if (v.unmeasured.length > 0) lines.push(`passes what was measured — ${v.unmeasured.join(", ")} not measured.`);
@@ -1998,6 +2010,7 @@ function validateScene(json, opts = {}) {
 		checkEnvironment(json);
 		loadScene(json, {
 			resolveScene: opts.resolveScene,
+			...opts.declaredAssets ? { declaredAssets: opts.declaredAssets } : {},
 			stubMissingBehaviors: !opts.strictBehaviors
 		}).root.free();
 		return { ok: true };
@@ -2027,10 +2040,10 @@ 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-DqdVp1bt.js").then((n) => n.r);
+		const { enablePhysics2D } = await import("./physics-2d-BXmu2i7W.js").then((n) => n.r);
 		await enablePhysics2D(engine);
 	} else if (physics === "3d" || physics === "auto" && scene.dimension === "3d") {
-		const { enablePhysics3D } = await import("./physics-3d-BP0DZb_1.js").then((n) => n.r);
+		const { enablePhysics3D } = await import("./physics-3d-ClxP6Uv7.js").then((n) => n.r);
 		await enablePhysics3D(engine);
 	}
 	const failures = [];
@@ -2143,10 +2156,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-DqdVp1bt.js").then((n) => n.r);
+		const { enablePhysics2D } = await import("./physics-2d-BXmu2i7W.js").then((n) => n.r);
 		await enablePhysics2D(engine);
 	} else if (physics === "3d" || physics === "auto" && scene.dimension === "3d") {
-		const { enablePhysics3D } = await import("./physics-3d-BP0DZb_1.js").then((n) => n.r);
+		const { enablePhysics3D } = await import("./physics-3d-ClxP6Uv7.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-DWKTUzKI.js";
+import { P as Scene, Pt as LogEntry, b as Engine, jt as Node, n as BehaviorCtor } from "./behavior-DsgayMsH.js";
 import { c as JsonValue, i as SceneJson, s as JsonObject } from "./schema-CFeioQRE.js";
-import { t as LoadSceneOptions } from "./loader-TvkRFbyL.js";
-import { l as auditScene, o as IncantoError, r as ReplayJson } from "./replay-BCMK_VRP.js";
-import { l as LocalGameServerOptions, n as SplitScreenPlayer } from "./split-screen-BQ3tAsf-.js";
+import { t as LoadSceneOptions } from "./loader-DolLJWJn.js";
+import { l as auditScene, o as IncantoError, r as ReplayJson } from "./replay-C5x2vPF5.js";
+import { l as LocalGameServerOptions, n as SplitScreenPlayer } from "./split-screen-D7OopelJ.js";
 
 //#region src/test/facing.d.ts
 interface FacingOptions {
@@ -355,6 +355,25 @@ interface PlaytestReport {
   */
   declaresWin: boolean;
   /**
+  * Did `findPlayer` find anyone to drive?
+  *
+  * `findPlayer`'s own comment says a scene it cannot drive "says so rather
+  * than guessing" — and nothing said so. With no player the driver moves
+  * nothing, `wentAsFarAs` stays 0, and every run is reported `✗ stuck in
+  * 8/8`: the word for a character wedged in geometry, used for a scene that
+  * has no character. Measured on the shipped `examples/2d-phaser-basic`,
+  * whose whole tree is a ground, a sprite and a camera:
+  *
+  * ```
+  *   ✗ stuck in 4/4
+  *   danger: the player took damage 0 times in 4 runs — nothing here can hurt you
+  * ```
+  *
+  * Both sentences are about a player that does not exist. The `plays` rung
+  * needs to tell the two apart before it can call `stuck` a defect.
+  */
+  hasPlayer: boolean;
+  /**
   * The per-run clock the caller asked for, in simulated seconds.
   *
   * The header used to read this off the FIRST run's length, which is the one
@@ -426,6 +445,24 @@ interface RungResult {
   summary: string;
   /** What to do about it, when there is something to do. */
   fix?: string;
+  /**
+  * Things the rung's own tool said that are not failures — printed under it.
+  *
+  * The `loads` rung runs `incanto-check`, which returns
+  * `{ok, results:[{file, ok, warnings}]}`, and the rung read `ok` and threw
+  * the warnings away. So a scene `incanto-check` describes as *"nothing lights
+  * this 3D scene … It will render black"* came back from the headline command
+  * as:
+  *
+  * ```
+  * ✓ loads — the scene is legal and its assets resolve
+  * ```
+  *
+  * The ladder's own header table names `incanto-check` as the tool for "the
+  * scene will not load, OR RENDERS BLACK". It ran it, was told, and did not
+  * pass it on.
+  */
+  notes?: string[];
 }
 interface LadderVerdict {
   ok: boolean;
@@ -513,6 +550,10 @@ declare function captureScene(scene: Scene): SceneCapture;
 */
 declare function describeCapture(capture: SceneCapture): string;
 interface ValidateSceneOptions {
+  /** Assets the rest of the PROJECT declares — see `LoadSceneOptions`. */
+  declaredAssets?: Record<string, {
+    type?: unknown;
+  }>;
   /** Real behavior classes to register (hot-replacing) before loading. */
   behaviors?: Record<string, BehaviorCtor>;
   /** Hard-fail on unregistered behaviors instead of stubbing them. */

package/dist/test.js

@@ -1,3 +1,3 @@
-import { r as auditScene } from "./replay-BlNuIDdg.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-BeZ95pqw.js";
+import { r as auditScene } from "./replay-DlgHItNv.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-BMkg8zMV.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 };

package/dist/vite.js

@@ -1,6 +1,6 @@
-import { t as VERSION } from "./src-DFpXBMJN.js";
+import { t as VERSION } from "./src-CH00_JsR.js";
 import { n as diffSignatures } from "./frame-report-BSMny7oe.js";
-import { s as validateScene } from "./test-BeZ95pqw.js";
+import { s as validateScene } from "./test-BMkg8zMV.js";
 import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
 import { basename, dirname, join, normalize, relative, resolve, sep } from "node:path";
 //#region src/vite/frame-endpoint.ts

package/editor/assets/{agent8-DSJries_.js → agent8-m5mtAO_A.js}

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