incanto 0.61.0 → 0.63.0

package/bin/incanto-verify.mjs

@@ -147,9 +147,24 @@ const rungs = [];
   // the legal values sitting one key away in the same object.
   const broke = out?.results?.find((entry) => entry && entry.ok === false);
   const detail = broke && (broke.message || broke.code) ? `[${broke.code}] ${broke.message}` : null;
+  // What `incanto-check` SAID, beyond whether it passed. The rung read `ok` and
+  // dropped `warnings` on the floor, so a scene the child describes as "nothing
+  // lights this 3D scene … It will render black" was reported by the headline
+  // command as "✓ loads — the scene is legal and its assets resolve". The
+  // ladder's own header table names this tool as the one for "the scene will
+  // not load, OR RENDERS BLACK".
+  const notes = (out?.results ?? []).flatMap((entry) => entry?.warnings ?? []);
+  // "and its assets resolve" is a claim, and `missing art` is the check saying
+  // it does not. Do not make the claim when the child just contradicted it.
+  const missingArt = notes.some((n) => /is not in the project|missing|not found/i.test(String(n)));
   rungs.push(
     r.status === 0
-      ? { name: 'loads', status: 'pass', summary: 'the scene is legal and its assets resolve' }
+      ? {
+          name: 'loads',
+          status: 'pass',
+          summary: missingArt ? 'the scene is legal' : 'the scene is legal and its assets resolve',
+          ...(notes.length > 0 ? { notes, fix: `incanto-check ${scene}` } : {}),
+        }
       : {
           name: 'loads',
           status: 'fail',
@@ -175,62 +190,126 @@ if (rungs[0].status === 'pass') {
   // walkabout template has no end, and calling that a failure sends its author
   // hunting a bug that was never there.
   const noGoal = out && out.declaresWin === false;
-  // A quest — talk to the NPC, clear the enemies, light the wards — cannot be
-  // finished by a random walker, ever. Reporting that as a FAILED rung means
-  // the headline command permanently says NOT verified about a correct game,
-  // which teaches its author to stop reading it. If every run played to the
-  // end of its budget without erroring, falling or wedging, the rung has not
-  // failed: it has not measured, and the author's own scripted harness is what
-  // can judge this game.
-  // Three of the five outcomes are GAMEPLAY, not defects. `won`, `lost` and
+  // Three of the six outcomes are GAMEPLAY, not defects. `won`, `lost` and
   // `unfinished` all mean the game ran; a random player dying half the time in
-  // a platformer is the hazards working. The defects are `error` (a behaviour
-  // threw), `fell` (left the world) and `stuck` (went nowhere), and those are
-  // what this rung is for.
-  const PLAYED = new Set(['won', 'lost', 'unfinished']);
-  const playedOut =
-    out && (out.runs?.length ?? 0) > 0 && out.runs.every((x) => PLAYED.has(x.outcome));
+  // a platformer is the hazards working, and a quest cannot be finished by a
+  // random walker ever — reporting that as a FAILED rung means the headline
+  // command permanently says NOT verified about a correct game, which teaches
+  // its author to stop reading it.
+  //
+  // The other three are DEFECTS: `error` (a behaviour threw), `fell` (left the
+  // world) and `stuck` (went nowhere). They are counted BEFORE a branch is
+  // chosen, and they used to be counted after — only on the path where a win
+  // existed to miss. A scene that declares no win took the `noGoal` branch for
+  // ANY mix of outcomes, and that branch's summary was the hard-coded phrase
+  // "N runs played without error": an assumption wearing the clothes of a
+  // measurement. Measured on the shipped `basic-3d-sideview`, whose player
+  // walks off the edge on every seeded run:
+  //
+  // They used to be counted after, and only on the path where a win existed to
+  // miss. A scene that declares no win took the `noGoal` branch for ANY mix of
+  // outcomes, and that branch's summary was the hard-coded phrase "N runs
+  // played without error" — an assumption wearing the clothes of a
+  // measurement. Measured on the shipped `basic-3d-sideview`, whose player
+  // walks off the edge on every seeded run:
+  //
+  //   incanto-playtest → ✗ fell in 4/4 (last at y=-48.4)
+  //   incanto-verify   → ? plays — nothing declares a win — 8 runs played
+  //                      without error, and there was no end to reach
+  //   passes what was measured … VERIFY EXIT=0
+  //
+  // The child had just printed the defect; the parent reported the opposite of
+  // it and exited 0. The three outcomes this rung exists to catch were the
+  // three it could not report.
+  //
+  // `stuck` is the one that needs a fair chance before it counts. It means the
+  // player went nowhere, and the player goes nowhere for three different
+  // reasons: it is wedged (a defect), there IS no player (`2d-phaser-basic` is
+  // a ground, a sprite and a camera — the driver had nobody to move), or the
+  // game's own behaviours were never loaded, which is most of what makes a
+  // character move. Only the first is this rung's business.
   const tally = (name) => out?.runs?.filter((x) => x.outcome === name).length ?? 0;
-  rungs.push(
-    r.status === 0
-      ? { name: 'plays', status: 'pass', summary: `${won} of ${total} seeded runs finished it` }
-      : playedOut
-        ? {
-            name: 'plays',
-            status: 'unmeasured',
-            summary:
-              `${total} runs played without reaching a win` +
-              ` (${[
-                tally('lost') && `${tally('lost')} lost`,
-                tally('unfinished') && `${tally('unfinished')} ran out the clock`,
-              ]
-                .filter(Boolean)
-                .join(', ')})`,
-            fix: 'nothing here is broken — a win that takes skill or a sequence is out of reach of random play. Judge it with a scripted run: `bun run verify`, or `runScript` from `incanto/test`',
-          }
-        : noGoal
-          ? {
-              name: 'plays',
-              status: 'unmeasured',
-              summary: `nothing declares a win — ${total} runs played without error, and there was no end to reach`,
-              fix: 'if it is meant to be finishable, emit `won` (GameFlow, ScoreKeeper, or your own behaviour)',
-            }
-          : {
-              name: 'plays',
-              status: 'fail',
-              summary:
-                total > 0
-                  ? `no run finished it (${total} tried)`
-                  : // "could not run" with no reason is the tool doing to its
-                    // reader exactly what this whole ladder exists to prevent:
-                    // reporting a failure it already knows the cause of. The
-                    // child printed one; pass it on.
-                    `the playtest could not run — ${firstLine(r.stderr) || `exit ${r.status}`}`,
-              fix: behaviors
-                ? `see which runs stalled and where: \`incanto-playtest ${scene} --behaviors ${behaviors}\``
-                : `run it with your behaviours — without them the structure plays and your game logic does not: \`incanto-playtest ${scene} --behaviors src/behaviors.ts\``,
-            },
-  );
+  const stuckCounts = out?.hasPlayer !== false && Boolean(behaviors);
+  const DEFECT = new Set(stuckCounts ? ['error', 'fell', 'stuck'] : ['error', 'fell']);
+  const defects = out?.runs?.filter((x) => DEFECT.has(x.outcome)) ?? [];
+  const undrivable = total > 0 && defects.length === 0 && tally('stuck') === total;
+  const count = (n, word) => n && `${n} ${word}`;
+
+  if (total === 0) {
+    rungs.push({
+      name: 'plays',
+      status: 'fail',
+      // "could not run" with no reason is the tool doing to its reader exactly
+      // what this whole ladder exists to prevent: reporting a failure it
+      // already knows the cause of. The child printed one; pass it on.
+      summary: `the playtest could not run — ${firstLine(r.stderr) || `exit ${r.status}`}`,
+      fix: behaviors
+        ? `see it directly: \`incanto-playtest ${scene} --behaviors ${behaviors}\``
+        : `run it with your behaviours: \`incanto-playtest ${scene} --behaviors src/behaviors.ts\``,
+    });
+  } else if (defects.length > 0) {
+    rungs.push({
+      name: 'plays',
+      status: 'fail',
+      summary:
+        `${defects.length} of ${total} runs ended in a defect (` +
+        [
+          count(tally('fell'), 'fell out of the world'),
+          count(tally('error'), 'errored'),
+          count(tally('stuck'), 'went nowhere'),
+        ]
+          .filter(Boolean)
+          .join(', ') +
+        ')' +
+        (won > 0 ? ` — ${won} did finish it` : ''),
+      fix:
+        tally('error') > 0
+          ? `read the throw: \`incanto-playtest ${scene}${behaviors ? ` --behaviors ${behaviors}` : ''}\`, and \`engine.stats().errors\` in your own harness`
+          : tally('fell') > 0
+            ? `the player left the world with nothing catching them — give the level a floor, walls, or a respawn (\`incanto-playtest ${scene}${behaviors ? ` --behaviors ${behaviors}` : ''}\` prints where)`
+            : `nothing moved — check the input map and the controller: \`incanto-playtest ${scene}${behaviors ? ` --behaviors ${behaviors}` : ''}\``,
+    });
+  } else if (r.status === 0) {
+    rungs.push({
+      name: 'plays',
+      status: 'pass',
+      summary: `${won} of ${total} seeded runs finished it`,
+    });
+  } else if (undrivable) {
+    rungs.push({
+      name: 'plays',
+      status: 'unmeasured',
+      summary:
+        out?.hasPlayer === false
+          ? `nothing here is drivable — ${total} runs had nobody to move`
+          : `${total} runs went nowhere, and your behaviours were not loaded — that is most of what moves a character`,
+      fix:
+        out?.hasPlayer === false
+          ? 'give the player a character controller, the `player` group, or the name Player — otherwise no seeded run can play this'
+          : `name them: \`incanto-verify ${scene} --behaviors src/behaviors.ts\``,
+    });
+  } else if (noGoal) {
+    rungs.push({
+      name: 'plays',
+      status: 'unmeasured',
+      // Now this phrase IS measured: `defects.length === 0` got us here.
+      summary: `nothing declares a win — ${total} runs played without a defect, and there was no end to reach`,
+      fix: 'if it is meant to be finishable, emit `won` (GameFlow, ScoreKeeper, or your own behaviour)',
+    });
+  } else {
+    // A quest — talk to the NPC, clear the enemies, light the wards — cannot be
+    // finished by a random walker, ever. Reporting that as a FAILED rung means
+    // the headline command permanently says NOT verified about a correct game,
+    // which teaches its author to stop reading it.
+    rungs.push({
+      name: 'plays',
+      status: 'unmeasured',
+      summary:
+        `${total} runs played without reaching a win` +
+        ` (${[count(tally('lost'), 'lost'), count(tally('unfinished'), 'ran out the clock')].filter(Boolean).join(', ')})`,
+      fix: 'nothing here is broken — a win that takes skill or a sequence is out of reach of random play. Judge it with a scripted run: `bun run verify`, or `runScript` from `incanto/test`',
+    });
+  }
 } else {
   rungs.push({ name: 'plays', status: 'skipped', summary: 'not run — the scene does not load' });
 }

package/dist/2d.d.ts

@@ -90,6 +90,28 @@ declare class Node2D extends Node {
   /** @internal Override point. */
   protected _createObject2D(): Object3D;
   /** @internal Push JSON props onto the backing object. Called every frame. */
+  /**
+  * Has this node produced the thing `static: true` is about to freeze?
+  *
+  * `static` latches after the first sync, and a textured node's first sync
+  * happens BEFORE its texture has decoded — `TextureLoader.load()` returns a
+  * `Texture` with `image === undefined` and fills it asynchronously, while
+  * `Renderer2D.render()` calls `assets.load()` and `syncTree2D()` in the same
+  * frame. So the state frozen was `visible = false`, forever. Measured on two
+  * identical sprites differing only in `static`:
+  *
+  * ```
+  * frame 1            Backdrop(static) visible: false   Control visible: false
+  * 600 frames later   Backdrop(static) visible: false width 1
+  *                    Control          visible: true  width 64
+  * ```
+  *
+  * Nothing throws: the texture loaded fine, so `assetErrors()` is empty,
+  * `stats().errors` is 0, and `framing` reads props rather than pixels and
+  * still calls the node on-screen. Overridden by the nodes that wait on an
+  * image; a node with nothing to wait for is ready by definition.
+  */
+  _staticReady(_assets: AssetStore2D | null): boolean;
   _syncObject2D(_assets: AssetStore2D | null): void;
   override free(): void;
 }
@@ -498,6 +520,7 @@ declare class Sprite2D extends Node2D {
   protected override _createObject2D(): Object3D;
   /** Override point: AnimatedSprite2D substitutes its frame window here. */
   protected resolveTexture(assets: AssetStore2D | null): ResolvedSpriteTexture | null;
+  override _staticReady(assets: AssetStore2D | null): boolean;
   override _syncObject2D(assets: AssetStore2D | null): void;
 }
 //#endregion
@@ -568,6 +591,24 @@ declare class Camera2D extends Node2D {
   get effectiveZoom(): number;
   override update(dt: number): void;
   /** View center after clamping the (vw×vh)/zoom view rect inside `limits`. */
+  /**
+  * The view centre the renderer draws around, in WORLD space.
+  *
+  * It used to read `this.position` raw — the LOCAL prop — while every other
+  * 2D node gets its ancestors composed for free by the three scene graph. So a
+  * camera parented to the player, the Godot/Phaser idiom the authoring skill
+  * explicitly permits, framed the world origin:
+  *
+  * ```
+  * player world position : [1400, 900]
+  * renderer view centre  : {"x":0,"y":0}
+  * framing               : camera /Level/Player/Cam centred [1400, 900]
+  *                         1 in view, 0 outside it
+  * ```
+  *
+  * `framing` composes full world matrices, so the instrument the skills tell
+  * you to trust certified a view the renderer never drew.
+  */
   clampedCenter(vw: number, vh: number): {
     x: number;
     y: number;
@@ -882,6 +923,7 @@ declare class TileMap2D extends Node2D {
   private rebuildColliders;
   /** @internal The drawable mesh (lazily created under the backing object). */
   _mesh(): Mesh;
+  override _staticReady(assets: AssetStore2D | null): boolean;
   override _syncObject2D(assets: AssetStore2D | null): void;
   /** One quad per visible tile, atlas UVs — a single draw call for the level. */
   private buildGeometry;

package/dist/2d.js

@@ -1,7 +1,7 @@
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
-import { a as AssetStore2D, i as syncTree2D, r as Renderer2D, t as createGame2D } from "./create-game-DH7JI5xx.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-DL3izw8j.js";
-import { n as enablePhysics2D, t as Physics2D } from "./physics-2d-CBnor8Zf.js";
+import { a as AssetStore2D, i as syncTree2D, r as Renderer2D, t as createGame2D } from "./create-game-lLeITaZ5.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-1cKM8DEj.js";
+import { n as enablePhysics2D, t as Physics2D } from "./physics-2d-CllJXlic.js";
 //#region src/2d/library-sprite.ts
 /**
 * What a `CharacterController2D`/`3D` will ask a skin to play, and the clip in

package/dist/3d.d.ts

@@ -399,6 +399,28 @@ declare class CharacterBody3D extends PhysicsBody3D {
   /** Max climbable slope angle. */
   slopeLimitDeg: number;
   /**
+  * How high a step this body walks UP without jumping (0 = none).
+  *
+  * Rapier's character controller does not autostep unless asked, and nothing
+  * asked — so every `CharacterBody3D` was stopped dead by any ledge at all.
+  * The player never showed it, because `CharacterController3D` rides a hover
+  * spring rather than the KCC; enemies are the ones that walk.
+  *
+  * Measured on the shipped `tps-3d` template, whose arena has a 0.6 m `Ramp`
+  * between the spawn and the player. Standing still for 45 seconds:
+  *
+  * ```
+  * hits=0  hp=100  closest an enemy ever got = 33.91m
+  * ```
+  *
+  * They chase at the right speed the whole time and pile up against the near
+  * face of a knee-high box, because a chaser walks a straight line and cannot
+  * climb. The template's own playtest had been printing
+  * `danger: the player took damage 0 times in 4 runs — nothing here can hurt
+  * you` all along, and no rung failed on it.
+  */
+  stepHeight: number;
+  /**
   * `snapToGround` on a character body is ambiguous, so it is refused.
   *
   * A boolean here used to mean the ground-stick, and as placement it means

package/dist/3d.js

@@ -1,10 +1,10 @@
-import { c as parseEnvironment3D, l as sunDirectionFromElevationAzimuth, s as horizonColorFromSky, u as sunDirectionFromSky } from "./loader-D7jTvDQv.js";
+import { c as parseEnvironment3D, l as sunDirectionFromElevationAzimuth, s as horizonColorFromSky, u as sunDirectionFromSky } from "./loader-zDynoew_.js";
 import { a as frameSignature, n as diffSignatures, o as frameStats, r as diffText, s as frameText, t as SIGNATURE_GRID } from "./frame-report-BSMny7oe.js";
-import { B as StaticBody3D, F as WaterCutout3D, I as Area3D, L as CharacterBody3D, N as Water3D, P as WATER_CUTOUT_MAX, R as PhysicsBody3D, V as Node3D, W as WATER_MAX_RIPPLES, z as RigidBody3D } from "./gameplay-Dtzd2itW.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-CNxCuhZF.js";
-import { a as Environment3D, i as syncTree, o as setEnvironment3D, r as Renderer3D, s as AssetStore3D, t as createGame3D } from "./create-game-IX5lEH0P.js";
+import { B as CharacterBody3D, F as Water3D, H as RigidBody3D, I as WATER_CUTOUT_MAX, L as WaterCutout3D, U as StaticBody3D, V as PhysicsBody3D, W as Node3D, q as WATER_MAX_RIPPLES, z as Area3D } from "./gameplay-CuqoHHUB.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-QR7_75KJ.js";
+import { a as Environment3D, i as syncTree, o as setEnvironment3D, r as Renderer3D, s as AssetStore3D, t as createGame3D } from "./create-game-viBqXUoZ.js";
 import { n as splatWeights, t as buildHeightmap } from "./heightmap-CRK0M4jT.js";
-import { n as enablePhysics3D, t as Physics3D } from "./physics-3d-BTUfUSWO.js";
+import { n as enablePhysics3D, t as Physics3D } from "./physics-3d-BL_pFJ19.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-DH7JI5xx.js → create-game-lLeITaZ5.js}

@@ -1,14 +1,14 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { d as computeViewport, f as resolveViewport, k as diagnose, n as loadScene, z as registerBehavior } from "./loader-D7jTvDQv.js";
-import { _ as Engine, g as AudioPlayer } from "./register-xuSRyD6b.js";
+import { d as computeViewport, f as resolveViewport, k as diagnose, n as loadScene, z as registerBehavior } from "./loader-zDynoew_.js";
+import { _ as AudioPlayer, v as Engine } from "./register-Btm7_Emq.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { i as resolveRendering, n as attachTouchControls } from "./touch-DESwnpOc.js";
-import { a as openBundledEditor, c as claimCanvasGestures, i as devServerLibrary, l as audioErrors, n as pauseWhenHidden, r as crossFade, s as wireDevChannel, t as teardown } from "./teardown-B6rwJOyS.js";
+import { a as openBundledEditor, c as claimCanvasGestures, i as devServerLibrary, l as audioErrors, n as pauseWhenHidden, r as crossFade, s as wireDevChannel, t as teardown } from "./teardown-BwhkcNt8.js";
 import { o as frameStats } from "./frame-report-BSMny7oe.js";
-import { n as registerGameplayBehaviors } from "./gameplay-Dtzd2itW.js";
-import { g as PhysicsBody2D, n as UILayer, t as registerNodes2D, u as Camera2D, y as Node2D } from "./register-DL3izw8j.js";
+import { n as registerGameplayBehaviors } from "./gameplay-CuqoHHUB.js";
+import { g as PhysicsBody2D, n as UILayer, t as registerNodes2D, u as Camera2D, y as Node2D } from "./register-1cKM8DEj.js";
 import { t as debugSources } from "./debug-draw-BM3DsvtT.js";
-import { n as enablePhysics2D } from "./physics-2d-CBnor8Zf.js";
+import { n as enablePhysics2D } from "./physics-2d-CllJXlic.js";
 import { Box3, BufferAttribute, BufferGeometry, Color, LineBasicMaterial, LineSegments, LinearFilter, NearestFilter, OrthographicCamera, Raycaster, SRGBColorSpace, Scene, TextureLoader, Vector2, Vector3, WebGLRenderer } from "three";
 //#region src/2d/assets.ts
 /**
@@ -318,7 +318,7 @@ function walk(node, parentObj, ui, inUi, visited, cameras, emitters, assets, uiS
 	for (const child of node.children) walk(child, nextParent, ui, nextInUi, visited, cameras, emitters, assets, uiSize, ignoreStatic);
 	if (node instanceof Node2D && !(node instanceof UILayer)) {
 		const obj = node._ensureObject2D();
-		if (node.static && !ignoreStatic) {
+		if (node.static && !ignoreStatic && node._staticReady(assets)) {
 			obj.userData.incantoStaticSynced = true;
 			obj.userData.incantoStatic = true;
 		} else if (obj.userData.incantoStaticSynced === true) {
@@ -539,7 +539,7 @@ var Renderer2D = class {
 		const { activeCamera } = syncTree2D(scene.root, this.worldScene, this.uiScene, this.assets, {
 			width: uiW,
 			height: uiH
-		}, this.syncScratch);
+		}, this.syncScratch, { ignoreStatic: this.ignoreStatic });
 		let center = vp ? {
 			x: vp.design[0] / 2,
 			y: vp.design[1] / 2

package/dist/{create-game-IX5lEH0P.js → create-game-viBqXUoZ.js}

@@ -1,14 +1,14 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { c as parseEnvironment3D, k as diagnose, n as loadScene, s as horizonColorFromSky, u as sunDirectionFromSky, z as registerBehavior } from "./loader-D7jTvDQv.js";
-import { S as qualityRendering, _ as Engine, b as qualityCaps, g as AudioPlayer } from "./register-xuSRyD6b.js";
+import { c as parseEnvironment3D, k as diagnose, n as loadScene, s as horizonColorFromSky, u as sunDirectionFromSky, z as registerBehavior } from "./loader-zDynoew_.js";
+import { C as qualityRendering, _ as AudioPlayer, v as Engine, x as qualityCaps } from "./register-Btm7_Emq.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { i as resolveRendering, n as attachTouchControls } from "./touch-DESwnpOc.js";
-import { a as openBundledEditor, c as claimCanvasGestures, i as devServerLibrary, l as audioErrors, n as pauseWhenHidden, o as poseFromRenderer, r as crossFade, s as wireDevChannel, t as teardown } from "./teardown-B6rwJOyS.js";
+import { a as openBundledEditor, c as claimCanvasGestures, i as devServerLibrary, l as audioErrors, n as pauseWhenHidden, o as poseFromRenderer, r as crossFade, s as wireDevChannel, t as teardown } from "./teardown-BwhkcNt8.js";
 import { o as frameStats } from "./frame-report-BSMny7oe.js";
-import { R as PhysicsBody3D, U as createCausticsQuad, V as Node3D, n as registerGameplayBehaviors } from "./gameplay-Dtzd2itW.js";
+import { K as createCausticsQuad, V as PhysicsBody3D, W as Node3D, n as registerGameplayBehaviors } from "./gameplay-CuqoHHUB.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-CNxCuhZF.js";
-import { n as enablePhysics3D } from "./physics-3d-BTUfUSWO.js";
+import { E as Camera3D, U as TextureCache3D, g as ModelInstance3D, n as registerNodes3D, t as resolveEnvironmentHdri, v as DirectionalLight3D } from "./environment-presets-QR7_75KJ.js";
+import { n as enablePhysics3D } from "./physics-3d-BL_pFJ19.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/{duplicate-CGqAmK2h.js → duplicate-BOOKmkQ7.js}

@@ -1,4 +1,4 @@
-import { a as serializeNode, t as buildNodeJson } from "./loader-D7jTvDQv.js";
+import { a as serializeNode, t as buildNodeJson } from "./loader-zDynoew_.js";
 //#region src/core/scene/duplicate.ts
 function stripUids(json) {
 	const { uid: _uid, ...rest } = json;

package/dist/editor.js

@@ -1111,6 +1111,13 @@ var kt = {
 				en: "Set waitTime (seconds), optionally autostart or oneShot, and connect its timeout signal to any handler. Because it is a node, the whole timing setup lives in the scene file — agents can read and tune it.",
 				ko: "waitTime(초)을 정하고 autostart·oneShot을 선택한 뒤 timeout 시그널을 핸들러에 연결하세요. 노드이기 때문에 타이밍 설정 전체가 씬 파일에 남아 에이전트가 읽고 조정할 수 있습니다."
 			}),
+			L("Respawn", {
+				en: "Catches whatever it hangs off when it leaves the world, and puts it back.",
+				ko: "부모가 월드 밖으로 떨어지면 붙잡아 원래 자리로 되돌립니다."
+			}, {
+				en: "Make it a child of the player. With no props it catches its parent 50 m under the spawn (1000 px in 2D — the same line incanto-playtest calls \"fell\"), returns it to where it started and zeroes the velocity the fall built up. below names the line, to names the landing, target picks a different node. It emits respawned, and deliberately does not decide what falling COSTS — wire that to a ScoreKeeper or a Health if it should hurt.",
+				ko: "플레이어의 자식으로 두세요. 프롭 없이도 스폰 50 m 아래(2D는 1000 px — incanto-playtest가 \"fell\"로 부르는 그 선)에서 부모를 붙잡아 처음 위치로 되돌리고, 낙하로 쌓인 속도를 0으로 만듭니다. below는 그 선, to는 착지 지점, target은 다른 노드를 지정합니다. respawned 시그널을 쏘며, 추락의 \"대가\"는 일부러 정하지 않습니다 — 피해를 주려면 ScoreKeeper나 Health에 연결하세요."
+			}),
 			L("HudLayer", {
 				en: "Screen-space HUD overlay above the canvas — parent for UiText/UiBar/UiBanner.",
 				ko: "캔버스 위 화면 고정 HUD 오버레이 — UiText/UiBar/UiBanner의 부모."
@@ -9292,8 +9299,15 @@ function yc(e) {
 	let t = e.assets;
 	if (t) for (let e of Object.values(t)) typeof e?.url == "string" && !e.url.includes("/") && !e.url.includes(".") && (e.url = vc());
 }
+//#endregion
+//#region src/main.ts
+var bc = new Set([
+	"Terrain3D",
+	"Water3D",
+	"River3D"
+]);
 m(), b(), k(), ee(), A();
-async function bc(e = {}) {
+async function xc(e = {}) {
 	let t = e.api ?? ze, n = [], r = document.createElement("style");
 	r.dataset.incantoEditor = "true", r.textContent = vs, document.head.appendChild(r), n.push(() => r.remove());
 	let i = document.createElement("div");
@@ -9390,11 +9404,18 @@ async function bc(e = {}) {
 			0,
 			0
 		]),
-		onNodeScaled3D: (e, t) => de(e, "scale", t, [
-			1,
-			1,
-			1
-		]),
+		onNodeScaled3D: (e, t) => {
+			let n = u.nodeAt(e);
+			if (n && bc.has(String(n.type))) {
+				O(`${n.type} '${n.name}' cannot be scaled — scale would move only the mesh. Resize it with its "size" prop in the inspector.`);
+				return;
+			}
+			de(e, "scale", t, [
+				1,
+				1,
+				1
+			]);
+		},
 		onNodeRotated2D: (e, t) => ue(e, "rotation", t, 0),
 		onNodeRotated3D: (e, t) => de(e, "rotation", t, [
 			0,
@@ -9480,15 +9501,15 @@ async function bc(e = {}) {
 		...e.shelf ? { shelf: e.shelf } : {},
 		...e.assetType ? { assetType: e.assetType } : {},
 		...e.onProps ? { onProps: e.onProps } : {},
-		...e.asAsset ? { onAsset: (e, t, n) => wc(u, n, t) } : {}
+		...e.asAsset ? { onAsset: (e, t, n) => Tc(u, n, t) } : {}
 	}) : void 0, le = !1, F = () => {
 		if (!E) return;
 		js(d, u), rt(a("#asset-tree"), u), f.textContent = "", it(f, u, Ce, ce) || Bn(f, u, {
-			modelRefs: () => Sc(u, "model"),
+			modelRefs: () => Cc(u, "model"),
 			animationsForSelection: () => u.selection ? P.modelAnimationsAt(u.selection) : [],
 			bonesForSelection: (e) => u.selection ? P.boneNamesAt(u.selection, e) : [],
-			assetRefs: (e) => Cc(u, e),
-			addAsset: (e, t) => wc(u, e, t),
+			assetRefs: (e) => wc(u, e),
+			addAsset: (e, t) => Tc(u, e, t),
 			...ce ? { openLibrary: ce } : {},
 			confirm: Ce,
 			paint: {
@@ -9600,7 +9621,7 @@ async function bc(e = {}) {
 		if (e.length === 0) {
 			let e = u.working.root;
 			if (!e) return;
-			let t = xc(e);
+			let t = Sc(e);
 			Ce(`This deletes the ROOT '${String(e.name ?? "")}'${t > 0 ? ` AND its ${t} descendant node${t === 1 ? "" : "s"}` : ""} — the scene goes empty, and the next node you add becomes the new root.`, "delete root", () => u.deleteRoot());
 			return;
 		}
@@ -9608,7 +9629,7 @@ async function bc(e = {}) {
 		if (n.length === 0) {
 			let n = e.reduce((e, t) => {
 				let n = u.nodeAt(t);
-				return e + (n ? xc(n) : 0);
+				return e + (n ? Sc(n) : 0);
 			}, 0);
 			if (n > 0) {
 				Ce(`This deletes ${e.length > 1 ? `${e.length} nodes` : `'${String(u.nodeAt(e[0] ?? [])?.name ?? "")}'`} AND ${n} descendant node${n === 1 ? "" : "s"}.`, `delete ${e.length + n} nodes`, () => {
@@ -9784,20 +9805,20 @@ async function bc(e = {}) {
 		}
 	};
 }
-function xc(e) {
+function Sc(e) {
 	let t = 0;
-	for (let n of e.children ?? []) t += 1 + xc(n);
+	for (let n of e.children ?? []) t += 1 + Sc(n);
 	return t;
 }
-function Sc(e, t) {
+function Cc(e, t) {
 	let n = e.working.assets;
 	return n ? Object.entries(n).filter(([, e]) => e?.type === t).map(([e]) => `$${e}`) : [];
 }
-function Cc(e, t) {
+function wc(e, t) {
 	let n = e.working.assets;
 	return n ? Object.entries(n).filter(([, e]) => !t || e?.type !== void 0 && t.includes(e.type)).map(([e]) => `$${e}`) : [];
 }
-function wc(e, t, n) {
+function Tc(e, t, n) {
 	let r = e.working.assets ?? {};
 	for (let [e, t] of Object.entries(r)) if (t?.url === n.url) return `$${e}`;
 	let i = t;
@@ -9807,4 +9828,4 @@ function wc(e, t, n) {
 	}), `$${i}`;
 }
 //#endregion
-export { N as formatSceneJson, ze as httpEditorApi, bc as mountEditor };
+export { N as formatSceneJson, ze as httpEditorApi, xc as mountEditor };

package/dist/{environment-presets-CNxCuhZF.js → environment-presets-QR7_75KJ.js}

@@ -1,11 +1,11 @@
-import { k as diagnose } from "./loader-D7jTvDQv.js";
-import { I as translateOn, t as registerCoreNodes } from "./register-xuSRyD6b.js";
+import { k as diagnose } from "./loader-zDynoew_.js";
+import { L as translateOn, t as registerCoreNodes } from "./register-Btm7_Emq.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as Rng } from "./rng-DP-SR7eg.js";
 import { i as getNodeSchema, l as registerNode } from "./registry-CF70EArN.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-CY-mrr1L.js";
-import { B as StaticBody3D, F as WaterCutout3D, G as colliderFootDrop, I as Area3D, L as CharacterBody3D, N as Water3D, R as PhysicsBody3D, V as Node3D, w as tolerateUnknownAction, z as RigidBody3D } from "./gameplay-Dtzd2itW.js";
+import { B as CharacterBody3D, F as Water3D, H as RigidBody3D, J as colliderFootDrop, L as WaterCutout3D, R as rejectScale, U as StaticBody3D, V as PhysicsBody3D, W as Node3D, w as tolerateUnknownAction, z as Area3D } from "./gameplay-CuqoHHUB.js";
 import { t as checkSheetGrid } from "./sheet-grid-BT6N_Bjs.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";
@@ -1575,6 +1575,7 @@ var Terrain3D = class extends Node3D {
 	}
 	/** Loader hook: bad themes/layers/grids fail at LOAD, not at render. */
 	static validateJson(node) {
+		rejectScale(node, "heightAt(), the heightfield collider, drape and terrain-nav all");
 		const t = node;
 		if (!TERRAIN_THEMES.includes(t.theme)) throw new IncantoError("BAD_FORMAT", `Terrain3D '${node.name}' theme must be one of [${TERRAIN_THEMES.join(", ")}], got '${t.theme}'.`, {
 			prop: "theme",
@@ -8805,6 +8806,7 @@ var River3D = class River3D extends Node3D {
 	_bodies = [];
 	/** Loader hook: a malformed river fails at LOAD, not as an invisible ribbon. */
 	static validateJson(node) {
+		rejectScale(node, "the flow query and its collider both");
 		const r = node;
 		if (!Array.isArray(r.path)) throw new IncantoError("BAD_FORMAT", `River3D '${node.name}' path must be an array of [x, z] points, got ${JSON.stringify(r.path)}.`, { prop: "path" });
 		if (r.path.length > 0 && r.path.length < 2) throw new IncantoError("BAD_FORMAT", `River3D '${node.name}' path needs at least 2 points (source → mouth), got ${r.path.length}.`, { prop: "path" });