incanto 0.46.0 → 0.47.0

package/dist/3d.js

@@ -1,9 +1,96 @@
 import { A as Water3D, F as PhysicsBody3D, I as RigidBody3D, L as StaticBody3D, M as WaterCutout3D, N as Area3D, P as CharacterBody3D, R as Node3D, V as WATER_MAX_RIPPLES, j as WATER_CUTOUT_MAX } from "./gameplay-BQOeAid6.js";
 import { A as Terrain3D, B as keyboardIntensity, C as resolveFlowerDensity, D as BoneLookAt3D, E as Camera3D, F as InstancedMesh3D, G as acquireTexture, H as rigPose, I as MeshInstance3D, M as TERRAIN_THEMES, N as terrainThemeLayers, O as BoneAttachment3D, P as Joint3D, R as QUARTER_PITCH, S as Flowers3D, T as CharacterController3D, U as TextureCache3D, V as movementState, W as acquireOwnTexture, _ as LoftMesh3D, a as Tree3D, b as Foliage3D, c as buildRiverRings, d as riverCarveChannels, f as riverStepFor, g as ModelInstance3D, h as Particles3D, i as VoxelGrid3D, j as DEFAULT_TERRAIN_TEXTURE_BASE, k as Billboard3D, l as findRiverCoverageGaps, m as traceDownhillPath, n as registerNodes3D, o as Trail3D, p as smoothCourse, r as VOXEL_PALETTE, s as River3D, u as projectToRiver, v as DirectionalLight3D, w as FLOWER_VARIETIES, x as DENSITY_PRESETS, y as OmniLight3D, z as cameraRelative } from "./environment-presets-D1b0ydTS.js";
-import { a as Environment3D, c as parseEnvironment3D, d as AssetStore3D, i as syncTree, l as sunDirectionFromElevationAzimuth, o as setEnvironment3D, r as Renderer3D, s as horizonColorFromSky, t as createGame3D, u as sunDirectionFromSky } from "./create-game-BtCNdkjI.js";
-import { a as frameStats, i as frameSignature, n as diffSignatures, o as frameText, r as diffText, t as SIGNATURE_GRID } from "./frame-report-Lr3VO24R.js";
+import { a as Environment3D, c as parseEnvironment3D, d as AssetStore3D, i as syncTree, l as sunDirectionFromElevationAzimuth, o as setEnvironment3D, r as Renderer3D, s as horizonColorFromSky, t as createGame3D, u as sunDirectionFromSky } from "./create-game-D16MVIPO.js";
+import { a as frameSignature, n as diffSignatures, o as frameStats, r as diffText, s as frameText, t as SIGNATURE_GRID } from "./frame-report-njybhZon.js";
 import { n as splatWeights, t as buildHeightmap } from "./heightmap-CRK0M4jT.js";
 import { n as enablePhysics3D, t as Physics3D } from "./physics-3d-CSoGjM8P.js";
+//#region src/3d/model-verdict.ts
+/** Mixamo exports every bone as `mixamorigX`; the retargeter binds by that name. */
+const MIXAMO = /^mixamorig[:_]?/i;
+/**
+* Anything outside this is not a character at this scale, and the fix is one
+* prop. Wide on purpose: a 2.4m ogre is a design choice, a 40m one is
+* centimetres.
+*/
+const CHARACTER_HEIGHT = {
+	min: .4,
+	max: 4
+};
+/** What `targetHeight` gets set to when a model is plainly the wrong scale. */
+const DEFAULT_TARGET_HEIGHT = 1.7;
+/** Fraction of the model's own height that its origin may drift before it matters. */
+const ORIGIN_TOLERANCE = .25;
+function rigOf(facts) {
+	if (facts.vrm && facts.vrm.humanBones > 0) return "vrm-humanoid";
+	if (facts.nodes.some((n) => MIXAMO.test(n.name))) return "mixamorig";
+	return facts.skins > 0 ? "other" : "none";
+}
+function modelVerdict(facts, target) {
+	const rig = rigOf(facts);
+	const kind = facts.meshes === 0 && facts.animations.length > 0 ? "animation" : "model";
+	const height = facts.bbox ? facts.bbox.size[1] : 0;
+	const offset = facts.bbox ? [
+		facts.bbox.center[0],
+		facts.bbox.min[1],
+		facts.bbox.center[2]
+	] : [
+		0,
+		0,
+		0
+	];
+	const slack = Math.max(height * ORIGIN_TOLERANCE, .05);
+	const grounded = !facts.bbox || Math.abs(offset[0]) <= slack && Math.abs(offset[1]) <= slack && Math.abs(offset[2]) <= slack;
+	const oddSize = height > 0 && (height < CHARACTER_HEIGHT.min || height > CHARACTER_HEIGHT.max);
+	const props = { model: `$${target?.key ?? "model"}` };
+	if (oddSize) props.targetHeight = DEFAULT_TARGET_HEIGHT;
+	return {
+		kind,
+		rig,
+		takesLibraryClips: kind === "model" && (rig === "mixamorig" || rig === "vrm-humanoid"),
+		height,
+		originOffset: offset,
+		groundedAtOrigin: grounded,
+		embeddedClips: facts.animations.map((a) => a.name),
+		sceneJson: target ? {
+			assets: { [target.key]: {
+				type: kind,
+				url: target.url
+			} },
+			node: kind === "animation" ? null : {
+				name: titleCase(target.key),
+				type: "ModelInstance3D",
+				props
+			}
+		} : null
+	};
+}
+const titleCase = (key) => key.split(/[-_\s]+/).filter(Boolean).map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join("") || "Model";
+const round = (n) => String(Math.round(n * 100) / 100);
+/** The verdict as sentences: what to do, and what will bite if you do not. */
+function verdictText(v) {
+	const lines = [];
+	if (v.kind === "animation") {
+		lines.push("an animation CLIP — no mesh of its own. It plays ON a character: declare it as {\"type\":\"animation\"} and point a ModelInstance3D's `animation` at it. Used as a `model` it draws nothing at all, with no error");
+		if (v.embeddedClips.length > 0) lines.push(`clip: ${v.embeddedClips.join(", ")}`);
+		return lines.join("\n");
+	}
+	if (v.rig === "mixamorig") lines.push("mixamorig rig — the 3d/animations clips play on this as they are");
+	else if (v.rig === "vrm-humanoid") lines.push("VRM humanoid — clips are retargeted onto it automatically");
+	else if (v.rig === "other") lines.push("skinned, but NOT a mixamorig rig — the 3d/animations clips will not bind to it (bones are matched by name; a mismatch keeps the bind pose and only warns)");
+	else lines.push("no skeleton — a prop, not a character; `animation` does nothing here");
+	if (v.height > 0) {
+		const odd = v.height < CHARACTER_HEIGHT.min || v.height > CHARACTER_HEIGHT.max;
+		lines.push(`stands ${round(v.height)} units tall` + (odd ? ` — not a character's size; set targetHeight (${DEFAULT_TARGET_HEIGHT}) to fix it` : ""));
+	}
+	if (!v.groundedAtOrigin) {
+		const [x, y, z] = v.originOffset;
+		const where = Math.abs(y) > Math.abs(x) && Math.abs(y) > Math.abs(z) ? `${round(Math.abs(y))} units ${y > 0 ? "above" : "below"} the origin` : `off-centre by [${round(x)}, ${round(y)}, ${round(z)}]`;
+		lines.push(`does NOT stand on its own origin — it sits ${where}. A node at [0,0,0] puts it there too; offset the node, or expect an empty-looking frame`);
+	}
+	if (v.embeddedClips.length > 0) lines.push(`clips in the file: ${v.embeddedClips.join(", ")} (play by name, no asset needed)`);
+	return lines.join("\n");
+}
+//#endregion
 //#region src/3d/terrain-nav.ts
 function buildTerrainNav(terrain, opts) {
 	const cellSize = opts?.cellSize ?? 2;
@@ -115,4 +202,4 @@ function createNavDebugNode(nav, opts) {
 	return node;
 }
 //#endregion
-export { Area3D, AssetStore3D, Billboard3D, BoneAttachment3D, BoneLookAt3D, Camera3D, CharacterBody3D, CharacterController3D, DEFAULT_TERRAIN_TEXTURE_BASE, DirectionalLight3D, Environment3D, DENSITY_PRESETS as FLOWER_DENSITY_PRESETS, FLOWER_VARIETIES, Flowers3D, Foliage3D, InstancedMesh3D, Joint3D, LoftMesh3D, MeshInstance3D, ModelInstance3D, Node3D, OmniLight3D, Particles3D, Physics3D, PhysicsBody3D, QUARTER_PITCH, Renderer3D, RigidBody3D, River3D, SIGNATURE_GRID, StaticBody3D, TERRAIN_THEMES, Terrain3D, TextureCache3D, Trail3D, Tree3D, VOXEL_PALETTE, VoxelGrid3D, WATER_CUTOUT_MAX, WATER_MAX_RIPPLES, Water3D, WaterCutout3D, acquireOwnTexture, acquireTexture, buildHeightmap, buildRiverRings, buildTerrainNav, cameraRelative, createGame3D, createNavDebugNode, diffSignatures, diffText, enablePhysics3D, findRiverCoverageGaps, frameSignature, frameStats, frameText, horizonColorFromSky, keyboardIntensity, movementState, parseEnvironment3D, projectToRiver, registerNodes3D, resolveFlowerDensity, rigPose, riverCarveChannels, riverStepFor, setEnvironment3D, smoothCourse, splatWeights, sunDirectionFromElevationAzimuth, sunDirectionFromSky, syncTree, terrainThemeLayers, traceDownhillPath };
+export { Area3D, AssetStore3D, Billboard3D, BoneAttachment3D, BoneLookAt3D, Camera3D, CharacterBody3D, CharacterController3D, DEFAULT_TERRAIN_TEXTURE_BASE, DirectionalLight3D, Environment3D, DENSITY_PRESETS as FLOWER_DENSITY_PRESETS, FLOWER_VARIETIES, Flowers3D, Foliage3D, InstancedMesh3D, Joint3D, LoftMesh3D, MeshInstance3D, ModelInstance3D, Node3D, OmniLight3D, Particles3D, Physics3D, PhysicsBody3D, QUARTER_PITCH, Renderer3D, RigidBody3D, River3D, SIGNATURE_GRID, StaticBody3D, TERRAIN_THEMES, Terrain3D, TextureCache3D, Trail3D, Tree3D, VOXEL_PALETTE, VoxelGrid3D, WATER_CUTOUT_MAX, WATER_MAX_RIPPLES, Water3D, WaterCutout3D, acquireOwnTexture, acquireTexture, buildHeightmap, buildRiverRings, buildTerrainNav, cameraRelative, createGame3D, createNavDebugNode, diffSignatures, diffText, enablePhysics3D, findRiverCoverageGaps, frameSignature, frameStats, frameText, horizonColorFromSky, keyboardIntensity, modelVerdict, movementState, parseEnvironment3D, projectToRiver, registerNodes3D, resolveFlowerDensity, rigPose, riverCarveChannels, riverStepFor, setEnvironment3D, smoothCourse, splatWeights, sunDirectionFromElevationAzimuth, sunDirectionFromSky, syncTree, terrainThemeLayers, traceDownhillPath, verdictText };

package/dist/{create-game-BtCNdkjI.js → create-game-D16MVIPO.js}

@@ -7,7 +7,7 @@ import { a as openBundledEditor, i as devServerLibrary, n as pauseWhenHidden, o
 import { B as createCausticsQuad, F as PhysicsBody3D, R as Node3D, n as registerGameplayBehaviors } from "./gameplay-BQOeAid6.js";
 import { t as debugSources } from "./debug-draw-BM3DsvtT.js";
 import { E as Camera3D, U as TextureCache3D, g as ModelInstance3D, n as registerNodes3D, t as resolveEnvironmentHdri, v as DirectionalLight3D } from "./environment-presets-D1b0ydTS.js";
-import { a as frameStats, i as frameSignature } from "./frame-report-Lr3VO24R.js";
+import { a as frameSignature, i as frameImage, o as frameStats } from "./frame-report-njybhZon.js";
 import { n as enablePhysics3D } from "./physics-3d-CSoGjM8P.js";
 import { ACESFilmicToneMapping, AmbientLight, Box3, BufferAttribute, BufferGeometry, Color, DepthTexture, EquirectangularReflectionMapping, FloatType, Fog, HalfFloatType, LineBasicMaterial, LineSegments, Matrix4, Mesh, PCFShadowMap, PMREMGenerator, PerspectiveCamera, PlaneGeometry, Quaternion, Raycaster, Scene, ShaderMaterial, Vector2, Vector3, WebGLRenderTarget, WebGLRenderer } from "three";
 import { VRMLoaderPlugin, VRMUtils } from "@pixiv/three-vrm";
@@ -1545,6 +1545,12 @@ function prune(obj, visited) {
 //#endregion
 //#region src/3d/renderer.ts
 /**
+* How long a capture waits for the game's own loop before drawing its own
+* frame. Long enough that a running game answers from its normal loop (16ms),
+* short enough that a paused or occluded tab still answers promptly.
+*/
+const CAPTURE_NUDGE_MS = 120;
+/**
 * WebGL presentation layer: subscribes to `engine.updated`, mirrors the active
 * scene's node tree onto a three.js scene, applies the scene `environment`
 * header (ambient/background/sky/fog/shadows/exposure — see Environment3D),
@@ -1890,6 +1896,14 @@ var Renderer3D = class {
 				resolve,
 				reject
 			});
+			setTimeout(() => {
+				if (this.pendingCaptures.length > 0) try {
+					this.render();
+				} catch (error) {
+					const e = error instanceof Error ? error : new Error(String(error));
+					for (const w of this.pendingCaptures.splice(0)) w.reject(e);
+				}
+			}, CAPTURE_NUDGE_MS);
 		});
 	}
 	pendingCaptures = [];
@@ -2446,11 +2460,16 @@ async function createGame3D(opts) {
 		const onFrameRequest = (data) => {
 			const request = data;
 			const id = request?.id;
+			hot.send("incanto:frame-ack", { id });
 			captureFramePixels().then((shot) => hot.send("incanto:frame-report", {
 				id,
 				report: {
 					...frameStats(shot.pixels, shot.width, shot.height, { grid: request?.grid }),
-					signature: frameSignature(shot.pixels, shot.width, shot.height)
+					signature: frameSignature(shot.pixels, shot.width, shot.height),
+					...request?.image ? { image: frameImage(shot.pixels, shot.width, shot.height, (w, h) => Object.assign(document.createElement("canvas"), {
+						width: w,
+						height: h
+					}), request.image) } : {}
 				}
 			})).catch((error) => hot.send("incanto:frame-report", {
 				id,

package/dist/{frame-report-Ct8XgsmV.d.ts → frame-report-DZ70IY26.d.ts}

@@ -28,6 +28,31 @@ interface FrameStats {
   meanLuma: number;
   /** Coarse mean colour per cell, rows top to bottom. */
   grid: GridCell[][];
+  /** What the frame is OF, or null when it is all background. */
+  subject: Subject | null;
+}
+/**
+* The thing in the shot: everything that is not the background.
+*
+* `black` and `uniform` answer "did anything render at all". They do not answer
+* the question that actually goes wrong — "is the thing IN the shot, and can
+* you see it" — and every visual defect reported against the editor's model
+* previews walked straight past them. A white square with a faint sky gradient
+* is neither black nor uniform; a character drawn as a speck in the corner has
+* a perfectly ordinary mean luminance.
+*/
+interface Subject {
+  /** Bounding box in pixels, origin top-left. */
+  box: {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+  };
+  /** Share of the frame's pixels that are subject, 0..1. */
+  coverage: number;
+  /** Touching an edge — the shot is a crop, and something is outside it. */
+  clipped: boolean;
 }
 interface FrameStatsOptions {
   /** Cells across and down. Default 16x9 — 144 cells, printable. */

package/dist/{frame-report-Lr3VO24R.js → frame-report-njybhZon.js}

@@ -44,6 +44,98 @@ function cellMeans(pixels, width, height, cols, rows) {
 	}
 	return out;
 }
+/**
+* How far a pixel must sit from the background colour to count as subject.
+* Chosen above the banding in a sky gradient and well below any real material.
+*/
+const SUBJECT_DELTA = 24;
+/** Subject smaller than this is present but not visible — say so differently. */
+const TINY_COVERAGE = .01;
+/**
+* The background colour, read off the BORDER rather than voted for.
+*
+* A subject filling most of the shot would win a popularity contest and the
+* report would invert — the sky would become "the thing", and a well-framed
+* character would read as an empty frame. The edge of a frame is background in
+* every shot this is asked about; where it is not, the subject is clipped, and
+* that gets reported too.
+*/
+function borderColour(pixels, width, height) {
+	let r = 0;
+	let g = 0;
+	let b = 0;
+	let n = 0;
+	const take = (x, y) => {
+		const o = (y * width + x) * 4;
+		r += pixels[o];
+		g += pixels[o + 1];
+		b += pixels[o + 2];
+		n += 1;
+	};
+	for (let x = 0; x < width; x++) {
+		take(x, 0);
+		take(x, height - 1);
+	}
+	for (let y = 1; y < height - 1; y++) {
+		take(0, y);
+		take(width - 1, y);
+	}
+	return n === 0 ? [
+		0,
+		0,
+		0
+	] : [
+		r / n,
+		g / n,
+		b / n
+	];
+}
+/** Where the non-background pixels are, or null when there are none worth it. */
+function findSubject(pixels, width, height) {
+	const global = borderColour(pixels, width, height);
+	const at = (x, y) => {
+		const o = (y * width + x) * 4;
+		return [
+			pixels[o],
+			pixels[o + 1],
+			pixels[o + 2]
+		];
+	};
+	const dist = (a, b) => Math.abs(a[0] - b[0]) + Math.abs(a[1] - b[1]) + Math.abs(a[2] - b[2]);
+	let minX = width;
+	let minY = height;
+	let maxX = -1;
+	let maxY = -1;
+	let count = 0;
+	for (let y = 0; y < height; y++) {
+		const left = at(0, y);
+		const right = at(width - 1, y);
+		const row = dist(left, right) > SUBJECT_DELTA ? dist(left, global) <= dist(right, global) ? left : right : [
+			(left[0] + right[0]) / 2,
+			(left[1] + right[1]) / 2,
+			(left[2] + right[2]) / 2
+		];
+		for (let x = 0; x < width; x++) {
+			if (dist(at(x, y), row) < SUBJECT_DELTA) continue;
+			count += 1;
+			if (x < minX) minX = x;
+			if (x > maxX) maxX = x;
+			if (y < minY) minY = y;
+			if (y > maxY) maxY = y;
+		}
+	}
+	if (maxX < 0) return null;
+	return {
+		box: {
+			x: minX,
+			y: minY,
+			w: maxX - minX + 1,
+			h: maxY - minY + 1
+		},
+		coverage: count / (width * height),
+		clipped: minX === 0 || minY === 0 || maxX === width - 1 || maxY === height - 1
+	};
+}
 function frameStats(pixels, width, height, opts = {}) {
 	const [cols, rows] = opts.grid ?? [16, 9];
 	const means = cellMeans(pixels, width, height, cols, rows);
@@ -70,21 +162,30 @@ function frameStats(pixels, width, height, opts = {}) {
 	}
 	const cells = cols * rows;
 	const meanLuma = total / cells;
+	const black = maxLuma <= BLACK_LEVEL;
 	return {
 		width,
 		height,
-		black: maxLuma <= BLACK_LEVEL,
+		black,
 		uniform: maxLuma - minLuma < UNIFORM_EPSILON,
 		meanLuma: Math.round(meanLuma * 1e3) / 1e3,
-		grid
+		grid,
+		subject: black ? null : findSubject(pixels, width, height)
 	};
 }
+const pct = (v) => `${(v * 100).toFixed(1)}%`;
 /** The report a person or an agent reads. Verdict first, numbers after. */
 function frameText(stats) {
 	const lines = [];
 	if (stats.black) lines.push("BLACK SCREEN — nothing was drawn (no light, no camera, or nothing in view)");
 	else if (stats.uniform) lines.push("one flat colour — the camera may be inside geometry, or only the sky is drawn");
+	else if (!stats.subject) lines.push("nothing but background — the camera is pointed away from everything in the scene");
+	else if (stats.subject.coverage < TINY_COVERAGE) lines.push(`the subject fills almost nothing (${pct(stats.subject.coverage)}) — the camera is too far back, or what you meant to see is not what got drawn`);
 	lines.push(`frame ${stats.width}×${stats.height} · luminance ${stats.meanLuma.toFixed(2)}`);
+	if (stats.subject) {
+		const { box, coverage, clipped } = stats.subject;
+		lines.push(`subject ${box.w}×${box.h} at ${box.x},${box.y} · fills ${pct(coverage)} of frame` + (clipped ? " · CLIPPED by the frame edge" : ""));
+	}
 	return lines.join("\n");
 }
 /**
@@ -193,5 +294,31 @@ function fromBase64(text) {
 	for (let i = 0; i < binary.length; i++) out[i] = binary.charCodeAt(i);
 	return out;
 }
+/**
+* A `data:` PNG of the frame, scaled to fit `maxSide`.
+*
+* Rows are taken as they come, TOP-DOWN. `gl.readPixels` is bottom-up, which
+* is why this wants flipping — but `Renderer3D.captureFrame` already flipped
+* once, "rather than in each of" its consumers, and this is one of them.
+* Flipping again shipped an upside-down picture that the unit test happily
+* confirmed, because the test asserted the belief instead of the boundary.
+*/
+function frameImage(pixels, width, height, makeCanvas, maxSide = 512) {
+	const full = makeCanvas(width, height);
+	const ctx = full.getContext("2d");
+	if (!ctx) return null;
+	const image = ctx.createImageData(width, height);
+	image.data.set(pixels.subarray(0, width * height * 4));
+	ctx.putImageData(image, 0, 0);
+	const scale = Math.min(1, maxSide / Math.max(width, height));
+	if (scale >= 1) return full.toDataURL("image/png");
+	const w = Math.max(1, Math.round(width * scale));
+	const h = Math.max(1, Math.round(height * scale));
+	const small = makeCanvas(w, h);
+	const sctx = small.getContext("2d");
+	if (!sctx) return full.toDataURL("image/png");
+	sctx.drawImage(full, 0, 0, w, h);
+	return small.toDataURL("image/png");
+}
 //#endregion
-export { frameStats as a, frameSignature as i, diffSignatures as n, frameText as o, diffText as r, SIGNATURE_GRID as t };
+export { frameSignature as a, frameImage as i, diffSignatures as n, frameStats as o, diffText as r, frameText as s, SIGNATURE_GRID as t };

package/dist/index.js

@@ -7,7 +7,7 @@ import { n as jsonEquals, r as jsonKind, t as jsonClone } from "./json-BLk7H2Qa.
 import { a as getNodeSignals, c as mergeStaticSignals, i as getNodeSchema, l as registerNode, n as clearRegistry, o as getNodeType, r as createNode, u as registeredTypes } from "./registry-IyWCGe4q.js";
 import { t as createNoise2D } from "./noise-CGUMx44x.js";
 import { i as applyParticlePreset, n as PARTICLE_PRESETS, r as PARTICLE_PRESET_NAMES, t as ParticleSim } from "./particle-sim-Bw7hB93B.js";
-import { a as findPath, i as preloadUrls, n as newUid, o as gridFromRows, r as assetUrls, t as VERSION } from "./src-B43b6bZo.js";
+import { a as findPath, i as preloadUrls, n as newUid, o as gridFromRows, r as assetUrls, t as VERSION } from "./src-Ca3oV1fe.js";
 import { i as resolveRendering, n as attachTouchControls, r as joystickVector, t as TouchControls } from "./touch-BoNg_MnF.js";
 import { t as duplicateNode } from "./duplicate-CRtihGmC.js";
 export { AudioBuses, AudioPlayer, BASE_LOCALE, Behavior, CONST_REF_KEY, Engine, HudLayer, IncantoError, InputMap, Localization, LogManager, MusicManager, Node, ORDER_GROUP_BASE, PARTICLE_PRESETS, PARTICLE_PRESET_NAMES, ParticleSim, ROLLOFF_MODELS, Rng, SCENE_FORMAT, SFX_PRESETS, SFX_PRESET_NAMES, SaveSlots, Scene, SceneTree, Settings, SfxEngine, Signal, T_PREFIX, Timer, TouchControls, UiBanner, UiBar, UiButton, UiDialogue, UiImage, UiPanel, UiSelect, UiSlider, UiText, UiToggle, VERSION, WebAudioMusicBackend, applyParticlePreset, assetUrls, attachTouchControls, auditScene, behaviorSchema, behaviorSignals, behaviorsWithoutSave, captureBehaviors, clearBehaviors, clearRegistry, computeViewport, createNode, createNoise2D, createSaveStore, crossfadeGains, duplicateNode, effectiveOrder, fadeGain, findPath, getBehavior, getNodeSchema, getNodeSignals, getNodeType, gridFromRows, isAudioContextAvailable, isConstRef, joystickVector, jsonClone, jsonEquals, jsonKind, loadScene, mergeStaticSignals, newUid, parseNodePath, preloadUrls, qualityEnvironment, readDeviceHints, registerBehavior, registerCoreNodes, registerNode, registeredBehaviors, registeredTypes, replay, resolveConstants, resolveOrderGroups, resolveRendering, resolveViewport, restoreBehaviors, serializeNode, spatialGain, spatialPan, startRecording, suggestLocale, suggestQuality, synthSfx, translationKey };

package/dist/react.js

@@ -156,7 +156,7 @@ function IncantoCanvas(props) {
 				pointer: latest.pointer,
 				...keyboard !== void 0 ? { keyboard } : {}
 			};
-			const next = await (_gameFactory ?? (mode === "3d" ? async (o) => (await import("./create-game-BtCNdkjI.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-CniOiWzN.js").then((n) => n.n)).createGame2D(o)))(opts);
+			const next = await (_gameFactory ?? (mode === "3d" ? async (o) => (await import("./create-game-D16MVIPO.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-CniOiWzN.js").then((n) => n.n)).createGame2D(o)))(opts);
 			if (disposed) {
 				next.dispose();
 				return;

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

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

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

@@ -345,12 +345,14 @@ function makeOracle(engine, player) {
 	let outcome = null;
 	let damage = 0;
 	const offs = [];
+	let declaresEnd = false;
 	/** First verdict wins — a run ends at its first conclusion, not its last. */
 	const settle = (verdict) => {
 		if (outcome === null) outcome = verdict;
 	};
 	const walk = (node) => {
 		if (node.behavior) for (const signal of node.declaredSignalNames()) {
+			if (signal === "won" || signal === "lost" || signal === "flowChanged") declaresEnd = true;
 			if (signal === "won") offs.push(node.on(signal, () => settle("won")));
 			if (signal === "lost") offs.push(node.on(signal, () => settle("lost")));
 			if (signal === "died" && node === player) offs.push(node.on(signal, () => settle("lost")));
@@ -368,6 +370,7 @@ function makeOracle(engine, player) {
 	if (root) walk(root);
 	return {
 		outcome: () => outcome,
+		declaresEnd: () => declaresEnd,
 		damage: () => damage,
 		dispose: () => {
 			for (const off of offs) off();
@@ -549,7 +552,8 @@ async function runOnce(json, seed, opts) {
 	return {
 		run,
 		targets,
-		signals
+		signals,
+		declaresEnd: oracle.declaresEnd()
 	};
 }
 /** Play the scene `runs` times and report what happened. */
@@ -559,11 +563,13 @@ async function playtest(json, opts = {}) {
 	const runs = [];
 	let targets = [];
 	let signals = [];
+	let declaresWin = 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;
 	}
 	const probe = await createPlaySession(json, {
 		seed: base,
@@ -577,7 +583,8 @@ async function playtest(json, opts = {}) {
 		targets,
 		signals: [...new Set(signals)],
 		actions,
-		inertActions: []
+		inertActions: [],
+		declaresWin
 	};
 }
 function pct(n, total) {
@@ -603,7 +610,7 @@ function playtestText(report) {
 	lines.push("");
 	const won = runs.filter((r) => r.outcome === "won");
 	if (won.length > 0) lines.push(`  ✓ reached "won" in ${pct(won.length, total)}   median ${Math.round(median(won.map((r) => r.timeMs)) / 1e3)}s`);
-	else lines.push(`  ✗ never reached "won" in ${total} runs — nothing in this scene declares a win, or it cannot be reached`);
+	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`);
 	for (const bad of [
 		"error",
 		"fell",
@@ -1139,6 +1146,46 @@ function feelText(report) {
 	return lines.join("\n");
 }
 //#endregion
+//#region src/test/verify-ladder.ts
+const MARK = {
+	pass: "✓",
+	fail: "✗",
+	unmeasured: "?",
+	skipped: "·"
+};
+function ladderVerdict(rungs, ctx = {}) {
+	const failed = rungs.find((r) => r.status === "fail");
+	const unmeasured = rungs.filter((r) => r.status === "unmeasured");
+	const next = failed ? failed.fix ?? failed.summary : unmeasured[0]?.fix ?? unmeasured[0]?.summary ?? null;
+	const ambiguous = rungs.length === 0 && (ctx.candidates?.length ?? 0) > 1;
+	return {
+		ok: !failed,
+		rungs,
+		unmeasured: unmeasured.map((r) => r.name),
+		next: ambiguous ? "name the one you mean: `incanto-verify <scene.json>`" : next ?? null,
+		candidates: ctx.candidates ?? []
+	};
+}
+/** The ladder as a person or an agent reads it: every rung, then the one action. */
+function ladderText(v) {
+	if (v.rungs.length === 0) {
+		if (v.candidates.length > 1) return [
+			`${v.candidates.length} scenes here, and guessing between them would verify the wrong one:`,
+			...v.candidates.map((c) => `  ${c}`),
+			"",
+			`next: ${v.next}`
+		].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}`);
+	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.`);
+	else lines.push("verified: it loads, it plays, and it draws.");
+	if (v.next) lines.push(`next: ${v.next}`);
+	return lines.join("\n");
+}
+//#endregion
 //#region src/test/index.ts
 /**
 * incanto/test — the browserless verification harness.
@@ -1524,4 +1571,4 @@ async function createPlaySession(json, opts = {}) {
 	};
 }
 //#endregion
-export { framingText as _, registerAllNodes as a, feelReport as c, facingText as d, failingReplays as f, describeFraming as g, playtestText as h, findFloatingProps as i, feelText as l, playtest as m, createPlaySession as n, runScript as o, findPlayer as p, describeCapture as r, validateScene as s, captureScene as t, facingReport as u };
+export { playtestText as _, registerAllNodes as a, ladderText as c, feelText as d, facingReport as f, playtest as g, findPlayer as h, findFloatingProps as i, ladderVerdict as l, failingReplays as m, createPlaySession as n, runScript as o, facingText as p, describeCapture as r, validateScene as s, captureScene as t, feelReport as u, describeFraming as v, framingText as y };

package/dist/test.d.ts

@@ -165,6 +165,15 @@ interface PlaytestReport {
   actions: string[];
   /** Actions that never changed the world in any run. */
   inertActions: string[];
+  /**
+  * Does anything in this scene declare an END?
+  *
+  * "No run reached a win" has two causes that need opposite fixes: a goal
+  * that cannot be reached, and a scene with no goal in it. A walkabout
+  * template is not a broken game, and reporting one as a failure sends its
+  * author looking for a bug that was never there.
+  */
+  declaresWin: boolean;
 }
 /**
 * Who the driver is playing as.
@@ -190,6 +199,51 @@ declare function failingReplays(report: PlaytestReport): Array<{
   replay: JsonValue;
 }>;
 //#endregion
+//#region src/test/verify-ladder.d.ts
+/**
+* The verification ladder, as one answer.
+*
+* The rungs already exist — `incanto-check` says the scene loads,
+* `incanto-playtest` says it can be finished, `incanto-frame` says something
+* was drawn. They are documented together and used apart, because using them
+* together means knowing three things nobody writes down:
+*
+*   the ORDER (a scene that does not load cannot be played or drawn, so the
+*     first red rung is the only one worth reading)
+*   that an unmeasured rung is not a failing one — "no dev server" means the
+*     question was never asked, and answering it "fail" sends an agent editing
+*     a scene that is fine
+*   what to do NEXT, which is one sentence and never the whole report
+*
+* Pure: the rungs are run by the CLI, this decides what they add up to.
+*/
+type RungStatus = "pass" | "fail" | "unmeasured" | "skipped";
+interface RungResult {
+  name: string;
+  status: RungStatus;
+  /** One line: what this rung found. */
+  summary: string;
+  /** What to do about it, when there is something to do. */
+  fix?: string;
+}
+interface LadderVerdict {
+  ok: boolean;
+  rungs: RungResult[];
+  /** Rungs that could not be measured — questions unasked, not answers. */
+  unmeasured: string[];
+  /** The single next action, or null when there is nothing to do. */
+  next: string | null;
+  /** Scenes found when none was named (empty once one is being verified). */
+  candidates: string[];
+}
+interface LadderContext {
+  /** Scenes found when none was named — none, or more than one to choose from. */
+  candidates?: string[];
+}
+declare function ladderVerdict(rungs: RungResult[], ctx?: LadderContext): LadderVerdict;
+/** The ladder as a person or an agent reads it: every rung, then the one action. */
+declare function ladderText(v: LadderVerdict): string;
+//#endregion
 //#region src/test/index.d.ts
 /** One thing that is not standing where it should be. */
 interface GroundingIssue {
@@ -371,4 +425,4 @@ interface PlaySession {
 */
 declare function createPlaySession(json: unknown, opts?: PlaySessionOptions): Promise<PlaySession>;
 //#endregion
-export { type FacingOptions, type FacingReport, type FeelOptions, type FeelReport, type FramingEntry, type FramingOptions, type FramingReport, GroundingIssue, GroundingOptions, NodeCapture, type Outcome, PlaySession, PlaySessionOptions, type PlaytestOptions, type PlaytestReport, type PlaytestRun, RunContext, RunFailure, RunResult, RunScriptOptions, SceneCapture, ScriptStep, ValidateSceneOptions, ValidationResult, type Where, auditScene, captureScene, createPlaySession, describeCapture, describeFraming, facingReport, facingText, failingReplays, feelReport, feelText, findFloatingProps, findPlayer, framingText, playtest, playtestText, registerAllNodes, runScript, validateScene };
+export { type FacingOptions, type FacingReport, type FeelOptions, type FeelReport, type FramingEntry, type FramingOptions, type FramingReport, GroundingIssue, GroundingOptions, type LadderVerdict, 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, auditScene, captureScene, createPlaySession, describeCapture, describeFraming, facingReport, facingText, failingReplays, feelReport, feelText, findFloatingProps, findPlayer, framingText, ladderText, ladderVerdict, playtest, playtestText, registerAllNodes, runScript, validateScene };

package/dist/test.js

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

package/dist/vite.d.ts

@@ -1,4 +1,4 @@
-import { n as FrameSignature } from "./frame-report-Ct8XgsmV.js";
+import { n as FrameSignature } from "./frame-report-DZ70IY26.js";
 
 //#region src/vite/discover.d.ts
 /**
@@ -29,9 +29,20 @@ interface FrameHost {
   middlewares: {
     use(path: string, handler: (req: FrameReq, res: FrameRes) => void): void;
   };
-  /** Vite's HMR channel. `ws` on v5, `hot` on v6+ — both are accepted. */
+  /**
+  * Vite's HMR channel, which has moved twice. `ws` on v5, `hot` on v6+, and
+  * since the Environment API the one that actually reaches the BROWSER is
+  * `environments.client.hot` — on v8 the top-level `hot` still exists and
+  * still accepts `send()` without error, it simply arrives nowhere. Every
+  * candidate is used, because a silent no-op is the worst of the three.
+  */
   ws?: FrameChannel;
   hot?: FrameChannel;
+  environments?: {
+    client?: {
+      hot?: FrameChannel;
+    };
+  };
 }
 interface FrameChannel {
   send(payload: {