incanto 0.54.0 → 0.56.0

package/bin/incanto-verify.mjs

@@ -122,12 +122,16 @@ const rungs = [];
   );
 }
 
+/** The playtest's JSON, shared by the `plays` and `feels` rungs. */
+let playtestReport = null;
+
 // ---- plays ---------------------------------------------------------------
 if (rungs[0].status === 'pass') {
   const args = [scene, '--json', '--runs', '8'];
   if (behaviors) args.push('--behaviors', behaviors);
   const r = run('playtest', args);
   const out = safeJson(r.stdout);
+  playtestReport = out;
   const won = out?.runs?.filter((x) => x.outcome === 'won').length ?? 0;
   const total = out?.runs?.length ?? 0;
   // A scene that declares no win is not a scene that cannot be won: a
@@ -158,6 +162,48 @@ if (rungs[0].status === 'pass') {
   rungs.push({ name: 'plays', status: 'skipped', summary: 'not run — the scene does not load' });
 }
 
+// ---- feels ---------------------------------------------------------------
+// Sound and effects, from the same playtest that just ran. A game whose
+// feedback is wired but never triggered plays perfectly and feels dead, and
+// every other rung here calls it healthy.
+{
+  const fb = playtestReport?.feedback;
+  const declared = (fb?.declaredAudio?.length ?? 0) + (fb?.declaredEffects?.length ?? 0);
+  const fired = new Set([...(fb?.heard ?? []), ...(fb?.shown ?? [])]);
+  if (!fb) {
+    rungs.push({
+      name: 'feels',
+      status: 'skipped',
+      summary: 'not run — the playtest did not report',
+    });
+  } else if (declared === 0) {
+    rungs.push({
+      name: 'feels',
+      status: 'skipped',
+      summary: 'this game declares no sound and no effects',
+    });
+  } else if (fired.size === 0) {
+    rungs.push({
+      name: 'feels',
+      status: 'fail',
+      summary: `${declared} sound/effect node(s) declared, and not one fired in any run`,
+      fix: 'connect them — a signal to `play` on an AudioPlayer, or `replay()` on a one-shot; `engine.audio.recent()` and `engine.effects.recent()` say what did fire',
+    });
+  } else {
+    const silent = [...(fb.declaredAudio ?? []), ...(fb.declaredEffects ?? [])].filter(
+      (path) => !fired.has(path),
+    );
+    rungs.push({
+      name: 'feels',
+      status: 'pass',
+      summary:
+        silent.length === 0
+          ? `every one of the ${declared} sound/effect nodes fired`
+          : `${fired.size} of ${declared} fired — silent: ${silent.slice(0, 3).join(', ')}${silent.length > 3 ? ` +${silent.length - 3}` : ''}`,
+    });
+  }
+}
+
 // ---- draws ---------------------------------------------------------------
 {
   const r = run('frame', ['--json']);

package/dist/2d.js

@@ -1,5 +1,5 @@
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
-import { a as AssetStore2D, i as syncTree2D, r as Renderer2D, t as createGame2D } from "./create-game-BRt6XKmP.js";
+import { a as AssetStore2D, i as syncTree2D, r as Renderer2D, t as createGame2D } from "./create-game-YvaNWhe6.js";
 import { _ as RigidBody2D, a as parseCells, c as ColorRect2D, d as AnimatedSprite2D, f as Sprite2D, g as PhysicsBody2D, h as CharacterBody2D, i as mergeSolidRects, l as CharacterController2D, m as Area2D, n as UILayer, o as Particles2D, p as Joint2D, r as TileMap2D, s as Label, t as registerNodes2D, u as Camera2D, v as StaticBody2D, y as Node2D } from "./register-en63AEZO.js";
 import { n as enablePhysics2D, t as Physics2D } from "./physics-2d-CfWAggJ1.js";
 //#region src/2d/library-sprite.ts

package/dist/3d.js

@@ -1,9 +1,9 @@
-import { F as CharacterBody3D, H as WATER_MAX_RIPPLES, I as PhysicsBody3D, L as RigidBody3D, M as WATER_CUTOUT_MAX, N as WaterCutout3D, P as Area3D, R as StaticBody3D, j as Water3D, z as Node3D } from "./gameplay-CZ2yq37J.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-BQ_QsIBY.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-Czzp6ZuE.js";
+import { B as Node3D, F as Area3D, I as CharacterBody3D, L as PhysicsBody3D, M as Water3D, N as WATER_CUTOUT_MAX, P as WaterCutout3D, R as RigidBody3D, U as WATER_MAX_RIPPLES, z as StaticBody3D } from "./gameplay-C_SPzmUe.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-DLHqgNAF.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-CqJkfMzm.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-Bes-GIuR.js";
+import { n as enablePhysics3D, t as Physics3D } from "./physics-3d-NzDwWPrF.js";
 //#region src/3d/model-verdict.ts
 /** Mixamo exports every bone as `mixamorigX`; the retargeter binds by that name. */
 const MIXAMO = /^mixamorig[:_]?/i;

package/dist/{create-game-Czzp6ZuE.js → create-game-CqJkfMzm.js}

@@ -5,11 +5,11 @@ import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { r as parseDrive, t as logReport } from "./log-report-CPFm4OXf.js";
 import { i as resolveRendering, n as attachTouchControls } from "./touch-BnMyy9tr.js";
 import { a as openBundledEditor, c as audioErrors, i as devServerLibrary, n as pauseWhenHidden, o as poseFromRenderer, r as crossFade, s as claimCanvasGestures, t as teardown } from "./teardown-C7uVSJvx.js";
-import { I as PhysicsBody3D, V as createCausticsQuad, n as registerGameplayBehaviors, z as Node3D } from "./gameplay-CZ2yq37J.js";
+import { B as Node3D, H as createCausticsQuad, L as PhysicsBody3D, n as registerGameplayBehaviors } from "./gameplay-C_SPzmUe.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-BQ_QsIBY.js";
+import { E as Camera3D, U as TextureCache3D, g as ModelInstance3D, n as registerNodes3D, t as resolveEnvironmentHdri, v as DirectionalLight3D } from "./environment-presets-DLHqgNAF.js";
 import { a as frameSignature, i as frameImage, o as frameStats } from "./frame-report-njybhZon.js";
-import { n as enablePhysics3D } from "./physics-3d-Bes-GIuR.js";
+import { n as enablePhysics3D } from "./physics-3d-NzDwWPrF.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";
 import { GLTFLoader } from "three/addons/loaders/GLTFLoader.js";

package/dist/{create-game-BRt6XKmP.js → create-game-YvaNWhe6.js}

@@ -4,7 +4,7 @@ import { b as AudioPlayer, x as Engine } from "./register-p48lHE2o.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { i as resolveRendering, n as attachTouchControls } from "./touch-BnMyy9tr.js";
 import { a as openBundledEditor, c as audioErrors, i as devServerLibrary, n as pauseWhenHidden, r as crossFade, s as claimCanvasGestures, t as teardown } from "./teardown-C7uVSJvx.js";
-import { n as registerGameplayBehaviors } from "./gameplay-CZ2yq37J.js";
+import { n as registerGameplayBehaviors } from "./gameplay-C_SPzmUe.js";
 import { g as PhysicsBody2D, n as UILayer, t as registerNodes2D, u as Camera2D, y as Node2D } from "./register-en63AEZO.js";
 import { t as debugSources } from "./debug-draw-BM3DsvtT.js";
 import { n as enablePhysics2D } from "./physics-2d-CfWAggJ1.js";

package/dist/debug.js

@@ -1164,7 +1164,9 @@ var DebugOverlay = class {
 			...gpu.triangles !== void 0 ? [`tris ${compactCount(gpu.triangles)}`] : [],
 			...gpu.drawCalls !== void 0 ? [`calls ${gpu.drawCalls}`] : []
 		].join(" · ");
-		chip.textContent = `${Math.round(stats.fps)} fps · ${stats.frameMs.toFixed(1)} ms\n${line2}`;
+		const p = stats.phases;
+		const line3 = `\nphys ${p.fixedMs.toFixed(1)} · logic ${p.updateMs.toFixed(1)} · draw ${p.renderMs.toFixed(1)} · other ${p.otherMs.toFixed(1)}`;
+		chip.textContent = `${Math.round(stats.fps)} fps · ${stats.frameMs.toFixed(1)} ms\n${line2}${line3}`;
 	}
 	renderExplorer() {
 		const panel = this.panels.get("explorer");

package/dist/editor.js

@@ -1181,6 +1181,13 @@ var kt = {
 				en: "Options are the locales the scene declares in \"strings\", each labeled with its own endonym. Picking one switches the game live and persists it. English is the base: any key a locale omits falls back to it, on purpose.",
 				ko: "옵션은 씬의 \"strings\"가 선언한 로케일이며, 각 언어의 자기 이름으로 표시됩니다. 선택하면 즉시 바뀌고 저장됩니다. 영어가 기준이라 로케일이 빠뜨린 키는 의도적으로 영어로 표시됩니다."
 			}),
+			L("Label3D", {
+				en: "Text standing in the world — a nameplate, a sign, a damage number.",
+				ko: "월드에 서 있는 텍스트 — 이름표, 표지판, 데미지 숫자."
+			}, {
+				en: "height is the cap height in METRES and the quad follows what the text measures, so a sign is as wide as its words. Faces the camera by default (a damage number read from behind is a bug) and carries a dark outline so it stays readable over anything. Everything else a sprite knows — anchor, tint, opacity, renderOrder — it inherits. For a damage number: set text, then float it up and fade opacity to 0 and queueFree().",
+				ko: "height는 글자 높이(미터)이고 가로 폭은 텍스트 실측을 따라갑니다. 기본으로 카메라를 향하며(뒤에서 읽히는 데미지 숫자는 버그니까요) 어두운 외곽선이 있어 어떤 배경에서도 읽힙니다. 앵커·틴트·투명도·renderOrder 등 스프라이트의 나머지 기능은 그대로 상속합니다. 데미지 숫자는 text를 넣고 위로 띄우며 opacity를 0으로 보낸 뒤 queueFree() 하면 됩니다."
+			}),
 			L("UiVolumeSlider", {
 				en: "A volume slider, already wired to a bus.",
 				ko: "볼륨 슬라이더 — 버스에 이미 연결되어 있습니다."

package/dist/{environment-presets-BQ_QsIBY.js → environment-presets-DLHqgNAF.js}

@@ -4,7 +4,7 @@ import { t as Rng } from "./rng-DP-SR7eg.js";
 import { i as getNodeSchema, l as registerNode } from "./registry-C7u42TID.js";
 import { t as createNoise2D } from "./noise-CGUMx44x.js";
 import { i as ParticleSim, n as resolveFrames, o as PARTICLE_PRESET_NAMES, r as validateAnimationAliases, s as applyParticlePreset, t as resolveAnimation } from "./sprite-animation-7qvUxF6Z.js";
-import { F as CharacterBody3D, I as PhysicsBody3D, L as RigidBody3D, N as WaterCutout3D, P as Area3D, R as StaticBody3D, U as colliderFootDrop, j as Water3D, z as Node3D } from "./gameplay-CZ2yq37J.js";
+import { B as Node3D, F as Area3D, I as CharacterBody3D, L as PhysicsBody3D, M as Water3D, P as WaterCutout3D, R as RigidBody3D, W as colliderFootDrop, z as StaticBody3D } from "./gameplay-C_SPzmUe.js";
 import { n as splatWeights, t as buildHeightmap } from "./heightmap-CRK0M4jT.js";
 import { AdditiveBlending, AnimationClip, AnimationMixer, Box3, BoxGeometry, BufferAttribute, BufferGeometry, CanvasTexture, CapsuleGeometry, ClampToEdgeWrapping, Color, ConeGeometry, CylinderGeometry, DataTexture, DirectionalLight, DoubleSide, DynamicDrawUsage, Euler, Group, IcosahedronGeometry, ImageBitmapLoader, InstancedBufferAttribute, InstancedMesh, LinearFilter, LinearMipmapLinearFilter, LoopOnce, LoopRepeat, Matrix4, Mesh, MeshBasicMaterial, MeshDepthMaterial, MeshPhysicalMaterial, MeshStandardMaterial, NearestFilter, NoBlending, NoColorSpace, NormalBlending, PerspectiveCamera, PlaneGeometry, PointLight, Points, PointsMaterial, Quaternion, QuaternionKeyframeTrack, RGBADepthPacking, RGBAFormat, RepeatWrapping, SRGBColorSpace, ShaderChunk, ShaderMaterial, SphereGeometry, Texture, TextureLoader, UniformsLib, UniformsUtils, Vector3, Vector4, VectorKeyframeTrack } from "three";
 import { clone } from "three/addons/utils/SkeletonUtils.js";
@@ -5685,6 +5685,121 @@ const colorScratchB$1 = new Color();
 const colorScratchC$1 = new Color();
 const tuftDryScratch = new Color();
 //#endregion
+//#region src/3d/nodes/label-3d.ts
+/**
+* Text standing in the world — a damage number, a nameplate, a sign.
+*
+* Every action game has these, and the answer used to be a sentence in the 3D
+* skill: *"There is no 3D text node — a nameplate or damage number is a
+* canvas-rendered texture on a child Sprite3D."* True, and a real afternoon of
+* work per game: measure the text, size the canvas, keep the device pixel ratio
+* honest, build the texture, work out the quad's aspect, re-rasterise when the
+* number changes, and dispose the old texture so a damage number does not leak
+* one per hit.
+*
+* It IS a canvas-rendered texture on a Sprite3D — which is exactly why it
+* should be a node. Everything a sprite already knows (billboarding, anchor,
+* tint, opacity, depth, render order) it inherits, so this only adds the text.
+*
+* ```json
+* { "name": "Name", "type": "Label3D",
+*   "props": { "text": "Goblin", "height": 0.25, "position": [0, 2, 0] } }
+* ```
+*
+* A damage number is this plus two lines of behavior: set `text`, then move it
+* up and fade `opacity` to 0 over ~0.6 s and `queueFree()`.
+*/
+var Label3D = class extends Sprite3D {
+	static typeName = "Label3D";
+	static props = {
+		...Sprite3D.props,
+		text: { default: "" },
+		/** Cap height of the text in METRES — the one number a sign is sized by. */
+		height: { default: .3 },
+		color: { default: "#ffffff" },
+		font: { default: "sans-serif" },
+		/** Outline colour; `""` turns it off. On by default: white text over a
+		*  bright wall is unreadable, and a damage number lands anywhere. */
+		outline: { default: "#000000" },
+		/** A damage number read from behind is a bug, so these face the camera. */
+		billboard: {
+			default: "full",
+			options: [
+				"y",
+				"full",
+				"none"
+			]
+		}
+	};
+	text = "";
+	height = .3;
+	color = "#ffffff";
+	font = "sans-serif";
+	outline = "#000000";
+	billboard = "full";
+	/**
+	* A `texture` on a label is a mistake, and a loud one.
+	*
+	* The prop is inherited from `Sprite3D` and cannot be un-inherited (schemas
+	* merge up the chain), so a URL set here would be silently ignored — this
+	* node draws its own text. Silent is the failure mode these rounds keep
+	* finding; naming it costs one check at load.
+	*/
+	static validateJson(node) {
+		const label = node;
+		if (label.texture) throw new IncantoError("BAD_FORMAT", `Label3D '${label.name}' has a "texture" — a label draws its own text, so the image would never be used. Set "text" instead, or use a Sprite3D.`, { prop: "texture" });
+	}
+	canvas = null;
+	/** The rasterised text. Named apart from Sprite3D's `texture` URL prop, which
+	*  this node ignores — the text IS the picture. */
+	canvasTexture = null;
+	lastKey = "";
+	resolveTexture(_assets) {
+		if (this.text === "" || typeof document === "undefined") return null;
+		const key = `${this.text}\0${this.height}\0${this.color}\0${this.font}\0${this.outline}`;
+		if (key !== this.lastKey) {
+			this.lastKey = key;
+			this.rasterize();
+		}
+		return this.canvasTexture;
+	}
+	/** Draw the text once, and size the quad to what it measured. */
+	rasterize() {
+		const fontPx = Math.max(8, Math.round(this.height * 256));
+		this.canvas ??= document.createElement("canvas");
+		const ctx = this.canvas.getContext("2d");
+		if (!ctx) return;
+		const stroke = Math.max(1, Math.round(fontPx * .14));
+		const fontSpec = `bold ${fontPx}px ${this.font}`;
+		ctx.font = fontSpec;
+		const width = Math.max(1, Math.ceil(ctx.measureText(this.text).width) + stroke * 2);
+		const lineHeight = Math.ceil(fontPx * 1.35) + stroke * 2;
+		this.canvas.width = width;
+		this.canvas.height = lineHeight;
+		ctx.font = fontSpec;
+		ctx.textBaseline = "middle";
+		ctx.textAlign = "center";
+		if (this.outline !== "") {
+			ctx.lineWidth = stroke;
+			ctx.lineJoin = "round";
+			ctx.strokeStyle = this.outline;
+			ctx.strokeText(this.text, width / 2, lineHeight / 2);
+		}
+		ctx.fillStyle = this.color;
+		ctx.fillText(this.text, width / 2, lineHeight / 2);
+		this.canvasTexture?.dispose();
+		const texture = new CanvasTexture(this.canvas);
+		texture.colorSpace = SRGBColorSpace;
+		this.canvasTexture = texture;
+		this.size = [width / lineHeight * this.height * 1.35, this.height * 1.35];
+	}
+	free() {
+		this.canvasTexture?.dispose();
+		this.canvasTexture = null;
+		super.free();
+	}
+};
+//#endregion
 //#region src/3d/nodes/lights-3d.ts
 /** Sun-style light. Direction comes from the node's rotation. */
 var DirectionalLight3D = class extends Node3D {
@@ -12436,6 +12551,7 @@ function registerNodes3D() {
 	registerNode(MeshInstance3D);
 	registerNode(LoftMesh3D);
 	registerNode(Sprite3D);
+	registerNode(Label3D);
 	registerNode(AnimatedSprite3D);
 	registerNode(Billboard3D);
 	registerNode(CharacterController3D);

package/dist/{gameplay-CZ2yq37J.js → gameplay-C_SPzmUe.js}

@@ -4891,6 +4891,78 @@ function phaseOf(hour) {
 	return "dusk";
 }
 //#endregion
+//#region src/gameplay/float-away.ts
+/**
+* Rise, fade, and be gone — the second half of a damage number.
+*
+* `Label3D` gave a game text standing in the world; every game then writes the
+* same eight lines to move it up and fade it out, and the interesting part is
+* not the eight lines, it is the three things they all get wrong: the node is
+* freed on the frame it becomes invisible rather than a second later, the fade
+* fights whatever else writes `opacity`, and a hundred numbers a fight each
+* leave a node behind because nothing ever frees them.
+*
+* ```json
+* { "name": "Hit", "type": "Label3D",
+*   "props": { "text": "12", "height": 0.35, "color": "#ff5a5a" },
+*   "script": { "name": "FloatAway", "props": { "rise": 1.2, "seconds": 0.7 } } }
+* ```
+*
+* Spawning one is then `duplicateNode` + set `text` + `position` — no per-frame
+* code of your own, and no cleanup to forget.
+*
+* It writes `opacity` and the node's own `position`, so it composes with
+* anything that does not. Works on any node with those props: a `Label3D`, a
+* `Sprite3D` pickup puff, a 2D `Label`.
+*/
+var FloatAway = class extends Behavior {
+	static props = {
+		/** World units travelled over the whole life (negative sinks). */
+		rise: { default: 1 },
+		/** How long the whole thing takes. */
+		seconds: { default: .7 },
+		/** Fraction of the life spent at full opacity before the fade starts. */
+		hold: { default: .3 },
+		/** Sideways drift, so ten numbers at once do not stack into one. */
+		drift: { default: 0 },
+		/** Free the node when it finishes. Off for something you re-use. */
+		freeOnEnd: { default: true }
+	};
+	rise = 1;
+	seconds = .7;
+	hold = .3;
+	drift = 0;
+	freeOnEnd = true;
+	elapsed = 0;
+	start = [];
+	done = false;
+	onReady() {
+		const node = this.node;
+		this.start = [...node.position ?? []];
+	}
+	update(dt) {
+		if (this.done) return;
+		const node = this.node;
+		if (!node.position) return;
+		this.elapsed += dt;
+		const life = Math.max(.001, this.seconds);
+		const t = Math.min(1, this.elapsed / life);
+		const next = [...this.start];
+		const eased = 1 - (1 - t) * (1 - t);
+		next[1] = (this.start[1] ?? 0) + this.rise * eased;
+		if (this.drift !== 0) next[0] = (this.start[0] ?? 0) + this.drift * eased;
+		node.position = next;
+		if (node.opacity !== void 0) {
+			const holdFor = Math.min(.99, Math.max(0, this.hold));
+			node.opacity = t <= holdFor ? 1 : 1 - (t - holdFor) / (1 - holdFor);
+		}
+		if (t >= 1) {
+			this.done = true;
+			if (this.freeOnEnd) this.node.queueFree();
+		}
+	}
+};
+//#endregion
 //#region src/gameplay/follow-camera.ts
 /**
 * Make the node it sits on chase a target's position — THE camera-follow
@@ -6636,7 +6708,8 @@ const GAMEPLAY_BEHAVIORS = {
 	Spawner,
 	WaveSpawner,
 	Projectile,
-	Buoyancy
+	Buoyancy,
+	FloatAway
 };
 /**
 * Register all built-in gameplay behaviors. Idempotent and hot-reload tolerant
@@ -6648,4 +6721,4 @@ function registerGameplayBehaviors(opts) {
 	for (const [name, ctor] of Object.entries(GAMEPLAY_BEHAVIORS)) registerBehavior(name, ctor, { replace });
 }
 //#endregion
-export { Chase as A, validateCollider3D as B, restartScene as C, DamageOnContact as D, phaseOf as E, CharacterBody3D as F, WATER_MAX_RIPPLES as H, PhysicsBody3D as I, RigidBody3D as L, WATER_CUTOUT_MAX as M, WaterCutout3D as N, Health as O, Area3D as P, StaticBody3D as R, goToScene as S, DayNight as T, colliderFootDrop as U, createCausticsQuad as V, Cooldown as _, Wander as a, Interactable as b, SavePoint as c, Patrol as d, PathFollow as f, CameraShake as g, Lifetime as h, WaveSpawner as i, Water3D as j, Collector as k, Projectile as l, MoveTo as m, registerGameplayBehaviors as n, Spawner as o, Oscillate as p, ZombieAI as r, ScoreKeeper as s, GAMEPLAY_BEHAVIORS as t, Pickup as u, hitStop as v, FollowCamera as w, GameFlow as x, screenFlash as y, Node3D as z };
+export { Collector as A, Node3D as B, restartScene as C, phaseOf as D, DayNight as E, Area3D as F, createCausticsQuad as H, CharacterBody3D as I, PhysicsBody3D as L, Water3D as M, WATER_CUTOUT_MAX as N, DamageOnContact as O, WaterCutout3D as P, RigidBody3D as R, goToScene as S, FloatAway as T, WATER_MAX_RIPPLES as U, validateCollider3D as V, colliderFootDrop as W, Cooldown as _, Wander as a, Interactable as b, SavePoint as c, Patrol as d, PathFollow as f, CameraShake as g, Lifetime as h, WaveSpawner as i, Chase as j, Health as k, Projectile as l, MoveTo as m, registerGameplayBehaviors as n, Spawner as o, Oscillate as p, ZombieAI as r, ScoreKeeper as s, GAMEPLAY_BEHAVIORS as t, Pickup as u, hitStop as v, FollowCamera as w, GameFlow as x, screenFlash as y, StaticBody3D as z };

package/dist/gameplay.d.ts

@@ -678,6 +678,60 @@ declare class DayNight extends Behavior {
 }
 declare function phaseOf(hour: number): DayPhase;
 //#endregion
+//#region src/gameplay/float-away.d.ts
+/**
+* Rise, fade, and be gone — the second half of a damage number.
+*
+* `Label3D` gave a game text standing in the world; every game then writes the
+* same eight lines to move it up and fade it out, and the interesting part is
+* not the eight lines, it is the three things they all get wrong: the node is
+* freed on the frame it becomes invisible rather than a second later, the fade
+* fights whatever else writes `opacity`, and a hundred numbers a fight each
+* leave a node behind because nothing ever frees them.
+*
+* ```json
+* { "name": "Hit", "type": "Label3D",
+*   "props": { "text": "12", "height": 0.35, "color": "#ff5a5a" },
+*   "script": { "name": "FloatAway", "props": { "rise": 1.2, "seconds": 0.7 } } }
+* ```
+*
+* Spawning one is then `duplicateNode` + set `text` + `position` — no per-frame
+* code of your own, and no cleanup to forget.
+*
+* It writes `opacity` and the node's own `position`, so it composes with
+* anything that does not. Works on any node with those props: a `Label3D`, a
+* `Sprite3D` pickup puff, a 2D `Label`.
+*/
+declare class FloatAway extends Behavior {
+  static override readonly props: {
+    /** World units travelled over the whole life (negative sinks). */rise: {
+      default: number;
+    }; /** How long the whole thing takes. */
+    seconds: {
+      default: number;
+    }; /** Fraction of the life spent at full opacity before the fade starts. */
+    hold: {
+      default: number;
+    }; /** Sideways drift, so ten numbers at once do not stack into one. */
+    drift: {
+      default: number;
+    }; /** Free the node when it finishes. Off for something you re-use. */
+    freeOnEnd: {
+      default: boolean;
+    };
+  };
+  rise: number;
+  seconds: number;
+  hold: number;
+  drift: number;
+  freeOnEnd: boolean;
+  private elapsed;
+  private start;
+  private done;
+  override onReady(): void;
+  override update(dt: number): void;
+}
+//#endregion
 //#region src/gameplay/game-flow.d.ts
 /**
 * Reload the CURRENT scene from its source JSON — fresh nodes, reset physics,
@@ -869,4 +923,4 @@ declare function registerGameplayBehaviors(opts?: {
   replace?: boolean;
 }): void;
 //#endregion
-export { CameraShake, Chase, Collector, Cooldown, DamageOnContact, DayNight, type DayPhase, FollowCamera, GAMEPLAY_BEHAVIORS, GameFlow, type GameFlowState, Health, Interactable, Lifetime, MoveTo, Oscillate, PathFollow, Patrol, Pickup, Projectile, SavePoint, ScoreKeeper, Spawner, Wander, WaveSpawner, ZombieAI, goToScene, hitStop, phaseOf, registerGameplayBehaviors, restartScene, screenFlash };
+export { CameraShake, Chase, Collector, Cooldown, DamageOnContact, DayNight, type DayPhase, FloatAway, FollowCamera, GAMEPLAY_BEHAVIORS, GameFlow, type GameFlowState, Health, Interactable, Lifetime, MoveTo, Oscillate, PathFollow, Patrol, Pickup, Projectile, SavePoint, ScoreKeeper, Spawner, Wander, WaveSpawner, ZombieAI, goToScene, hitStop, phaseOf, registerGameplayBehaviors, restartScene, screenFlash };

package/dist/gameplay.js

@@ -1,2 +1,2 @@
-import { A as Chase, C as restartScene, D as DamageOnContact, E as phaseOf, O as Health, S as goToScene, T as DayNight, _ as Cooldown, a as Wander, b as Interactable, c as SavePoint, d as Patrol, f as PathFollow, g as CameraShake, h as Lifetime, i as WaveSpawner, k as Collector, l as Projectile, m as MoveTo, n as registerGameplayBehaviors, o as Spawner, p as Oscillate, r as ZombieAI, s as ScoreKeeper, t as GAMEPLAY_BEHAVIORS, u as Pickup, v as hitStop, w as FollowCamera, x as GameFlow, y as screenFlash } from "./gameplay-CZ2yq37J.js";
-export { CameraShake, Chase, Collector, Cooldown, DamageOnContact, DayNight, FollowCamera, GAMEPLAY_BEHAVIORS, GameFlow, Health, Interactable, Lifetime, MoveTo, Oscillate, PathFollow, Patrol, Pickup, Projectile, SavePoint, ScoreKeeper, Spawner, Wander, WaveSpawner, ZombieAI, goToScene, hitStop, phaseOf, registerGameplayBehaviors, restartScene, screenFlash };
+import { A as Collector, C as restartScene, D as phaseOf, E as DayNight, O as DamageOnContact, S as goToScene, T as FloatAway, _ as Cooldown, a as Wander, b as Interactable, c as SavePoint, d as Patrol, f as PathFollow, g as CameraShake, h as Lifetime, i as WaveSpawner, j as Chase, k as Health, l as Projectile, m as MoveTo, n as registerGameplayBehaviors, o as Spawner, p as Oscillate, r as ZombieAI, s as ScoreKeeper, t as GAMEPLAY_BEHAVIORS, u as Pickup, v as hitStop, w as FollowCamera, x as GameFlow, y as screenFlash } from "./gameplay-C_SPzmUe.js";
+export { CameraShake, Chase, Collector, Cooldown, DamageOnContact, DayNight, FloatAway, FollowCamera, GAMEPLAY_BEHAVIORS, GameFlow, Health, Interactable, Lifetime, MoveTo, Oscillate, PathFollow, Patrol, Pickup, Projectile, SavePoint, ScoreKeeper, Spawner, Wander, WaveSpawner, ZombieAI, goToScene, hitStop, phaseOf, registerGameplayBehaviors, restartScene, screenFlash };

package/dist/index.js

@@ -8,7 +8,7 @@ import { a as nodeRefWarnings, i as describeRefProblem, n as startRecording, o a
 import { n as logText, r as parseDrive, t as logReport } from "./log-report-CPFm4OXf.js";
 import { t as createNoise2D } from "./noise-CGUMx44x.js";
 import { a as PARTICLE_PRESETS, i as ParticleSim, n as resolveFrames, o as PARTICLE_PRESET_NAMES, s as applyParticlePreset, t as resolveAnimation } from "./sprite-animation-7qvUxF6Z.js";
-import { a as findPath, i as preloadUrls, n as newUid, o as gridFromRows, r as assetUrls, t as VERSION } from "./src-vNPQeQ1W.js";
+import { a as findPath, i as preloadUrls, n as newUid, o as gridFromRows, r as assetUrls, t as VERSION } from "./src-51GA-9m-.js";
 import { i as resolveRendering, n as attachTouchControls, r as joystickVector, t as TouchControls } from "./touch-BnMyy9tr.js";
 import { t as duplicateNode } from "./duplicate-MNLMAcbz.js";
 export { AudioBuses, AudioPlayer, BASE_LOCALE, Behavior, CONST_REF_KEY, EffectLog, 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, UiFrameCapSelect, UiImage, UiLanguageSelect, UiMuteToggle, UiPanel, UiQualitySelect, UiRenderScaleSelect, UiSelect, UiSlider, UiText, UiToggle, UiVolumeSlider, VERSION, WebAudioMusicBackend, applyParticlePreset, assetUrls, attachTouchControls, auditScene, behaviorSchema, behaviorSignals, behaviorsWithoutSave, captureBehaviors, clearBehaviors, clearRegistry, computeViewport, createNode, createNoise2D, createSaveStore, crossfadeGains, describeRefProblem, duplicateNode, effectiveOrder, fadeGain, findPath, getBehavior, getNodeSchema, getNodeSignals, getNodeType, gridFromRows, isAudioContextAvailable, isConstRef, joystickVector, jsonClone, jsonEquals, jsonKind, loadScene, logReport, logText, mergeStaticSignals, newUid, nodeRefWarnings, parseDrive, parseNodePath, preloadUrls, qualityEnvironment, readDeviceHints, registerBehavior, registerCoreNodes, registerNode, registeredBehaviors, registeredTypes, replay, resolveAnimation, resolveConstants, resolveFrames, resolveOrderGroups, resolveRefInJson, resolveRendering, resolveViewport, restoreBehaviors, savesWithoutUid, serializeNode, spatialGain, spatialPan, startRecording, suggestLocale, suggestQuality, synthSfx, translationKey };

package/dist/{physics-3d-Bes-GIuR.js → physics-3d-NzDwWPrF.js}

@@ -1,9 +1,9 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
 import { C as diagnose } from "./loader-BTkHYrQn.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
-import { B as validateCollider3D, F as CharacterBody3D, I as PhysicsBody3D, L as RigidBody3D, P as Area3D, z as Node3D } from "./gameplay-CZ2yq37J.js";
+import { B as Node3D, F as Area3D, I as CharacterBody3D, L as PhysicsBody3D, R as RigidBody3D, V as validateCollider3D } from "./gameplay-C_SPzmUe.js";
 import { n as registerDebugSource } from "./debug-draw-BM3DsvtT.js";
-import { A as Terrain3D, F as InstancedMesh3D, L as buildMeshGeometry, P as Joint3D } from "./environment-presets-BQ_QsIBY.js";
+import { A as Terrain3D, F as InstancedMesh3D, L as buildMeshGeometry, P as Joint3D } from "./environment-presets-DLHqgNAF.js";
 import { Euler, Matrix4, Quaternion, Vector3 } from "three";
 //#region src/3d/physics/collider-lines.ts
 /**

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-Czzp6ZuE.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-BRt6XKmP.js").then((n) => n.n)).createGame2D(o)))(opts);
+			const next = await (_gameFactory ?? (mode === "3d" ? async (o) => (await import("./create-game-CqJkfMzm.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-YvaNWhe6.js").then((n) => n.n)).createGame2D(o)))(opts);
 			if (disposed) {
 				next.dispose();
 				return;

package/dist/{src-vNPQeQ1W.js → src-51GA-9m-.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.54.0";
+const VERSION = "0.56.0";
 //#endregion
 export { findPath as a, preloadUrls as i, newUid as n, gridFromRows as o, assetUrls as r, VERSION as t };

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

@@ -4,9 +4,9 @@ import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { n as jsonEquals, t as jsonClone } from "./json-BLk7H2Qa.js";
 import { i as getNodeSchema, s as mergeStaticProps } from "./registry-C7u42TID.js";
 import { n as startRecording } from "./replay-t1pP0gQg.js";
-import { n as registerGameplayBehaviors } from "./gameplay-CZ2yq37J.js";
+import { n as registerGameplayBehaviors } from "./gameplay-C_SPzmUe.js";
 import { t as registerNodes2D } from "./register-en63AEZO.js";
-import { n as registerNodes3D, t as resolveEnvironmentHdri } from "./environment-presets-BQ_QsIBY.js";
+import { n as registerNodes3D, t as resolveEnvironmentHdri } from "./environment-presets-DLHqgNAF.js";
 import { n as registerNodesNet, t as createSplitScreen } from "./split-screen-CSb_uZ6W.js";
 import { Box3, Euler, Matrix4, PerspectiveCamera, Quaternion, Vector3 } from "three";
 //#region src/test/framing.ts
@@ -752,6 +752,8 @@ async function runOnce(json, seed, opts) {
 		}
 	}
 	driver.release();
+	const heard = engine.audio.recent().map((e) => e.from);
+	const shown = engine.effects.recent().map((e) => e.from);
 	const bad = outcome !== "won";
 	const run = {
 		seed,
@@ -762,7 +764,9 @@ async function runOnce(json, seed, opts) {
 		damageTaken: oracle.damage(),
 		errors: engine.stats().errors,
 		replay: bad ? recorder.stop() : null,
-		endedAt: at
+		endedAt: at,
+		heard: [...new Set(heard)],
+		shown: [...new Set(shown)]
 	};
 	if (!bad) recorder.stop();
 	for (const off of offs) off();
@@ -796,6 +800,19 @@ async function playtest(json, opts = {}) {
 		...opts.resolveScene ? { resolveScene: opts.resolveScene } : {}
 	});
 	const actions = probe.engine.input.declaredActions().map((a) => a.name);
+	const feedbackNodes = {
+		audio: [],
+		effects: []
+	};
+	const walkFeedback = (node) => {
+		const type = node.constructor.typeName ?? "";
+		const path = node.getPath();
+		if (type === "AudioPlayer") feedbackNodes.audio.push(path);
+		if (type === "Particles2D" || type === "Particles3D") feedbackNodes.effects.push(path);
+		for (const child of node.children) walkFeedback(child);
+	};
+	const probeRoot = probe.scene.tree.root;
+	if (probeRoot) walkFeedback(probeRoot);
 	probe.dispose();
 	return {
 		runs,
@@ -804,7 +821,13 @@ async function playtest(json, opts = {}) {
 		actions,
 		inertActions: [],
 		declaresWin,
-		seconds: opts.seconds ?? 60
+		seconds: opts.seconds ?? 60,
+		feedback: {
+			declaredAudio: feedbackNodes.audio,
+			declaredEffects: feedbackNodes.effects,
+			heard: [...new Set(runs.flatMap((r) => r.heard))],
+			shown: [...new Set(runs.flatMap((r) => r.shown))]
+		}
 	};
 }
 function pct(n, total) {
@@ -1733,7 +1756,7 @@ async function runScript(json, opts) {
 		const { enablePhysics2D } = await import("./physics-2d-CfWAggJ1.js").then((n) => n.r);
 		await enablePhysics2D(engine);
 	} else if (physics === "3d" || physics === "auto" && scene.dimension === "3d") {
-		const { enablePhysics3D } = await import("./physics-3d-Bes-GIuR.js").then((n) => n.r);
+		const { enablePhysics3D } = await import("./physics-3d-NzDwWPrF.js").then((n) => n.r);
 		await enablePhysics3D(engine);
 	}
 	const failures = [];
@@ -1849,7 +1872,7 @@ async function createPlaySession(json, opts = {}) {
 		const { enablePhysics2D } = await import("./physics-2d-CfWAggJ1.js").then((n) => n.r);
 		await enablePhysics2D(engine);
 	} else if (physics === "3d" || physics === "auto" && scene.dimension === "3d") {
-		const { enablePhysics3D } = await import("./physics-3d-Bes-GIuR.js").then((n) => n.r);
+		const { enablePhysics3D } = await import("./physics-3d-NzDwWPrF.js").then((n) => n.r);
 		await enablePhysics3D(engine);
 	}
 	const stepMs = 1e3 / (opts.fixedHz ?? 60);

package/dist/test.d.ts

@@ -232,6 +232,10 @@ interface PlaytestRun {
   replay: ReplayJson | null;
   /** Where the player ended up, for the fall report. */
   endedAt: [number, number, number];
+  /** Node paths that made a sound during the run. */
+  heard: string[];
+  /** Node paths that fired a visible effect during the run. */
+  shown: string[];
 }
 interface PlaytestReport {
   runs: PlaytestRun[];
@@ -261,6 +265,18 @@ interface PlaytestReport {
   * up to 1s", hiding the very fact it was reporting.
   */
   seconds: number;
+  /**
+  * Sound and effects: what the scene declares, and what actually fired.
+  *
+  * A game whose feedback is wired but never triggered plays perfectly and
+  * feels dead — invisible in every other number in this report.
+  */
+  feedback: {
+    declaredAudio: string[];
+    declaredEffects: string[];
+    heard: string[];
+    shown: string[];
+  };
 }
 /**
 * Who the driver is playing as.

package/dist/test.js

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

package/dist/vite.js

@@ -1,6 +1,6 @@
-import { t as VERSION } from "./src-vNPQeQ1W.js";
+import { t as VERSION } from "./src-51GA-9m-.js";
 import { n as diffSignatures } from "./frame-report-njybhZon.js";
-import { s as validateScene } from "./test-Tnf1nQl3.js";
+import { s as validateScene } from "./test-Bu6SPNsV.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