incanto 0.70.0 → 0.72.0

package/bin/incanto-editor.mjs

@@ -30,7 +30,7 @@
 import { existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from 'node:fs';
 import { createServer } from 'node:http';
 import { basename, dirname, extname, join, normalize, relative, resolve, sep } from 'node:path';
-import { fileURLToPath } from 'node:url';
+import { fileURLToPath, pathToFileURL } from 'node:url';
 import { readJson } from './_read-json.mjs';
 
 const PKG_ROOT = join(dirname(fileURLToPath(import.meta.url)), '..');
@@ -463,7 +463,7 @@ const server = createServer((req, res) => {
       if (!originAllowed(req)) {
         return send(res, 403, JSON.stringify({ error: 'cross-origin write rejected' }));
       }
-      readBody(req, res, (body) => {
+      readBody(req, res, async (body) => {
         // a path with no extension means the usual thing, so `levels/arena` works
         const wanted =
           typeof body?.path === 'string' && body.path && !body.path.endsWith('.json')
@@ -495,14 +495,20 @@ const server = createServer((req, res) => {
          */
         const asked = body?.dimension === '3d' || body?.dimension === '2d' ? body.dimension : null;
         const dimension = asked ?? projectDimension() ?? '2d';
-        const scene = {
-          format: 1,
-          type: 'scene',
-          dimension,
-          name,
-          root: { name, type: dimension === '3d' ? 'Node3D' : 'Node2D' },
-        };
         try {
+          // uid at CREATION, like every node the editor makes: without it the
+          // first save backfills one and the diff carries a line nobody wrote.
+          // Imported here rather than at the top so starting the editor never
+          // pays for `dist` it may not otherwise need — inside the try, so a
+          // missing build is a 400 and not a dead server.
+          const { newUid } = await import(pathToFileURL(join(PKG_ROOT, 'dist', 'index.js')).href);
+          const scene = {
+            format: 1,
+            type: 'scene',
+            dimension,
+            name,
+            root: { name, type: dimension === '3d' ? 'Node3D' : 'Node2D', uid: newUid() },
+          };
           mkdirSync(dirname(abs), { recursive: true });
           writeFileSync(abs, formatSceneJson(scene));
           return send(res, 201, JSON.stringify({ rel: relative(ROOT, abs), abs }));

package/bin/incanto-feel.mjs

@@ -60,7 +60,17 @@ if (args.help || !args.scene) {
                     pushed +x/-y/+y/-x until the player moves)
   --jump ACTION     the button to jump with (default: "jump")
   --json            the report as JSON instead of prose`);
-  process.exit(!args.invalid && args.help && args.scene !== undefined ? 0 : 1);
+  /*
+   * `--help` is a REQUEST, and the answer is the text above.
+   *
+   * The rule used to be "0 only if a scene was also named", so the exact thing
+   * an agent types first — `incanto-playtest --help` — printed the usage and
+   * exited 1, while thirteen sibling bins exited 0 for the same input. A
+   * non-zero exit says "you did it wrong" to someone who did the documented
+   * thing, and under `set -e` it stops the script. A typo still exits 1
+   * (`invalid`), and so does a missing scene when help was not asked for.
+   */
+  process.exit(args.help && !args.invalid ? 0 : 1);
 }
 
 const { facingReport, facingText, feelReport, feelText } = await import(

package/bin/incanto-play.mjs

@@ -69,7 +69,17 @@ if (args.help || !args.scene) {
 
 Headless play: stdin commands (step/press/release/vector/key/mouse/pointer/
 wheel/capture/describe/framing/logs/quit), JSON-line responses on stdout.`);
-  process.exit(!args.invalid && args.help && args.scene !== undefined ? 0 : 1);
+  /*
+   * `--help` is a REQUEST, and the answer is the text above.
+   *
+   * The rule used to be "0 only if a scene was also named", so the exact thing
+   * an agent types first — `incanto-playtest --help` — printed the usage and
+   * exited 1, while thirteen sibling bins exited 0 for the same input. A
+   * non-zero exit says "you did it wrong" to someone who did the documented
+   * thing, and under `set -e` it stops the script. A typo still exits 1
+   * (`invalid`), and so does a missing scene when help was not asked for.
+   */
+  process.exit(args.help && !args.invalid ? 0 : 1);
 }
 
 const out = (obj) => process.stdout.write(`${JSON.stringify(obj)}\n`);

package/bin/incanto-playtest.mjs

@@ -92,7 +92,17 @@ if (args.help || !args.scene) {
 Exits 1 when a run THREW or left the world, or when a win is declared and no
 run reached it. A scene that declares no win, or has nobody to drive, exits 0 —
 the report marks those · rather than ✗, and the exit code says the same.`);
-  process.exit(!args.invalid && args.help && args.scene !== undefined ? 0 : 1);
+  /*
+   * `--help` is a REQUEST, and the answer is the text above.
+   *
+   * The rule used to be "0 only if a scene was also named", so the exact thing
+   * an agent types first — `incanto-playtest --help` — printed the usage and
+   * exited 1, while thirteen sibling bins exited 0 for the same input. A
+   * non-zero exit says "you did it wrong" to someone who did the documented
+   * thing, and under `set -e` it stops the script. A typo still exits 1
+   * (`invalid`), and so does a missing scene when help was not asked for.
+   */
+  process.exit(args.help && !args.invalid ? 0 : 1);
 }
 
 const { playtest, playtestText, playtestFailed, failingReplays } = await import(

package/bin/incanto-verify.mjs

@@ -25,7 +25,7 @@ import { fileURLToPath, pathToFileURL } from 'node:url';
 import { readJson } from './_read-json.mjs';
 
 const PKG = join(dirname(fileURLToPath(import.meta.url)), '..');
-const { firstLine, ladderText, ladderVerdict, saysRung } = await import(
+const { feelsRung, firstLine, ladderText, ladderVerdict, saysRung, unmeasuredPlays } = await import(
   pathToFileURL(join(PKG, 'dist', 'test.js')).href
 );
 
@@ -218,6 +218,9 @@ const rungs = [];
 /** The playtest's JSON, shared by the `plays` and `feels` rungs. */
 let playtestReport = null;
 
+/** Did the bot get the game MOVING? Set by the `plays` rung, read by `feels`. */
+let botPlayed = true;
+
 // ---- plays ---------------------------------------------------------------
 if (rungs[0].status === 'pass') {
   const args = [scene, '--json', '--runs', '8'];
@@ -274,6 +277,8 @@ if (rungs[0].status === 'pass') {
   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;
+  // …and the `feels` rung below asks the same question, so it is answered once.
+  botPlayed = !undrivable;
   const count = (n, word) => n && `${n} ${word}`;
 
   if (total === 0) {
@@ -343,23 +348,10 @@ if (rungs[0].status === 'pass') {
      * match-3, tower defense, cards, point-and-click, RTS, board games — has no
      * character to add, and the advice was to add one anyway.
      */
-    const clicks = (out?.runs ?? []).reduce((n, r) => n + (r.clicks ?? 0), 0);
-    rungs.push({
-      name: 'plays',
-      status: 'unmeasured',
-      summary:
-        clicks > 0
-          ? `played with the MOUSE — ${clicks} click(s) across ${total} runs, and no win to reach`
-          : out?.hasPlayer === false
-            ? `nothing here is drivable — ${total} runs had nobody to move and nothing to click`
-            : `${total} runs went nowhere, and your behaviours were not loaded — that is most of what moves a character`,
-      fix:
-        clicks > 0
-          ? 'a mouse game is played, not walked — emit `won`/`lost` and this rung can pass'
-          : out?.hasPlayer === false
-            ? 'give the player a character controller, the `player` group, or the name Player — or `Clickable` on what the cursor drives'
-            : `name them: \`incanto-verify ${scene} --behaviors src/behaviors.ts\``,
-    });
+    // The wording lives in `verify-ladder.ts` (pure, and tested there) —
+    // this branch owns only the fact that the bot could not WALK.
+    const said = unmeasuredPlays({ ...(out ?? {}), scene });
+    rungs.push({ name: 'plays', status: 'unmeasured', summary: said.summary, fix: said.fix });
   } else if (noGoal) {
     rungs.push({
       name: 'plays',
@@ -403,71 +395,10 @@ if (rungs[0].status === 'pass') {
 // 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 declaredPaths = [...(fb.declaredAudio ?? []), ...(fb.declaredEffects ?? [])];
-    const silent = declaredPaths.filter((path) => !fired.has(path));
-    // Of the nodes this rung is ABOUT, how many fired. `fired` also holds paths
-    // nobody declared — a spawned clone sounds from its own path, a procedural
-    // preset from wherever a behaviour played it — so using its size printed
-    // arithmetic that cannot be true: `✓ feels — 12 of 9 fired`. The number has
-    // to add up with the `silent` list beside it.
-    const firedDeclared = declaredPaths.length - silent.length;
-    /*
-     * A rung that exists because "wired but never triggered plays perfectly and
-     * feels dead, and every other rung here calls it healthy" — and which then
-     * called it healthy itself. `fired.size === 0` failed and ANYTHING else
-     * passed, so the flagship starter reported
-     *
-     *   ✓ feels — 13 of 26 fired — silent: /Game/Ward1/ChimeSfx …
-     *
-     * A tick next to thirteen emitters nobody heard is the same claim the rung
-     * was written to stop.
-     *
-     * It is not a FAILURE either: a random bot does not light three wards, so a
-     * win chime it never reached is not a broken wire. That is exactly what
-     * `unmeasured` means in this ladder — the tool did not get to look — and it
-     * is the one status that cannot be read as approval.
-     */
-    rungs.push({
-      name: 'feels',
-      ...(silent.length === 0
-        ? { status: 'pass', summary: `every one of the ${declared} sound/effect nodes fired` }
-        : {
-            status: 'unmeasured',
-            summary:
-              `${firedDeclared} of ${declared} fired — silent: ${silent.slice(0, 3).join(', ')}` +
-              `${silent.length > 3 ? ` +${silent.length - 3}` : ''}`,
-            fix:
-              'a silent emitter is either a broken wire or a moment random play never ' +
-              'reached — the two look identical from here. Reach it in a scripted run ' +
-              '(`runScript` from `incanto/test`), and this rung can tell you which.',
-          }),
-    });
-  }
-}
+// The wording lives in `verify-ladder.ts` (pure, and tested there).
+// `undrivable` is the plays rung's own "the bot never got it moving", so the
+// two never disagree about whether anything was played.
+rungs.push(feelsRung(playtestReport?.feedback, { played: botPlayed }));
 
 // ---- agrees --------------------------------------------------------------
 // A desync is the purest silent failure this engine has: both clients run,
@@ -544,28 +475,27 @@ if (rungs[0].status === 'pass') {
         ? 'bring the preview window to the front — a hidden tab does not render, and a frame is captured inside a render'
         : 'start your dev server, open the page, and run this again — the pixels are in the browser',
     });
-  } else if (report.hidden) {
+  } else if (report.hidden && report.droveFrames === 0) {
     /*
-     * A hidden page is UNMEASURED, not passed.
-     *
-     * A browser stops animating a page it considers hidden — a window merely
-     * covered by another counts — and the back buffer keeps whatever it last
-     * drew. Measured at one instant, same page:
+     * A hidden page cannot be DRIVEN, and that one is still unmeasured.
      *
-     *   incanto-frame --do   the page is hidden … a frozen game    (exit 1)
-     *   incanto-logs         frame rate not measurable — hidden
-     *   incanto-frame        subject fills 17.5% of frame
-     *   incanto-verify       ✓ draws — subject fills 17.5%
+     * The rung used to refuse any hidden page, on the belief that its pixels
+     * were "whatever it last drew". They are not: `captureFrame` in both
+     * renderers waits ~120 ms for a loop that a hidden tab never runs, and then
+     * draws a frame itself. Measured — hide every node from the console and
+     * capture again: 2D `luminance 0.09 → 0.00 BLACK SCREEN`, 3D `0.64 → 0.96,
+     * subject 44.3% → 22.0%`.
      *
-     * Two of six rungs reported ✓ off a stale buffer while the engine already
-     * knew, and said elsewhere, that the page was drawing nothing. The skills
-     * state the rule: an unmeasured rung is not a failure, and this is exactly
-     * the unmeasured case.
+     * So a plain capture is current and measurable, and the ONLY thing a hidden
+     * page cannot do is advance — which is exactly what a drive needs, and what
+     * `droveFrames: 0` reports. Refusing both cost this rung every measurement
+     * it could have made in the setup the whole toolchain is built for: a
+     * terminal in front and a browser behind it.
      */
     rungs.push({
       name: 'draws',
       status: 'unmeasured',
-      summary: 'the page is HIDDEN — those pixels are whatever it last drew',
+      summary: 'the drive ran on a HIDDEN page — 0 frames drawn, so nothing it did shows here',
       fix: 'bring the window to the front (one covered by another counts as hidden) and run this again',
     });
   } else if (report.black) {
@@ -598,6 +528,14 @@ if (rungs[0].status === 'pass') {
     if (report.uniform) {
       notes.push('one flat colour — the camera may be inside geometry, or only the sky is drawn');
     }
+    // Measured, not refused — but the reader still has to know the world was
+    // not moving while it was drawn.
+    if (report.hidden) {
+      notes.push(
+        'the page is hidden, so the game is PAUSED — this frame was rendered for the ' +
+          'capture, and shows the moment it froze',
+      );
+    }
     rungs.push({
       name: 'draws',
       status: 'pass',

package/dist/2d.d.ts

@@ -1,10 +1,10 @@
-import { c as showBootFailure, i as ParticleSim, o as ParticleView, r as SpatialPose, s as isWebGLAvailable } from "./audio-player-DaMxqfNE.js";
-import { P as Scene$1, S as Scheduler, T as RendererStats, b as Engine, d as PropSchema, jt as Node, n as BehaviorCtor, w as GameStats, x as EngineOptions } from "./behavior-DZExDn9o.js";
+import { c as showBootFailure, i as ParticleSim, o as ParticleView, r as SpatialPose, s as isWebGLAvailable } from "./audio-player-ioZ7VKC6.js";
+import { P as Scene$1, S as Scheduler, T as RendererStats, b as Engine, d as PropSchema, jt as Node, n as BehaviorCtor, w as GameStats, x as EngineOptions } from "./behavior-Bf9P9oB2.js";
 import { t as DiagnosticSink } from "./diagnostics-Cu85N3tL.js";
 import { a as SceneJson, s as JsonObject } from "./rng-Bb-IutXB.js";
 import { t as EditorSwitchOptions } from "./editor-switch-CFU9mCec.js";
 import { r as FrameStats } from "./frame-report-DNxDAb1w.js";
-import { t as LoadSceneOptions } from "./loader-Cff09LMm.js";
+import { t as LoadSceneOptions } from "./loader-CBfQzB6S.js";
 import { n as AnimationEntry } from "./sprite-animation-CMr6f1K2.js";
 import { Group, Mesh, Object3D, Scene, Texture } from "three";
 import * as RapierNs from "@dimforge/rapier2d-compat";
@@ -1151,6 +1151,21 @@ declare class TileMap2D extends Node2D {
   set cells(value: (string | number[])[]);
   get legend(): Record<string, number>;
   set legend(value: Record<string, number>);
+  private _colors;
+  get colors(): Record<string, string>;
+  set colors(value: Record<string, string>);
+  /**
+  * The colours, in declaration order — a cell's tile index is `COLOR_BASE + i`.
+  *
+  * A synthetic index rather than a second grid: everything downstream (the
+  * collider merge, `tileAt`, `setTile`, the editor's paint tool) already
+  * speaks in indices, and one number per cell keeps it that way.
+  */
+  private palette;
+  /** `legend` plus the colour chars, which is what every cell lookup wants. */
+  private allChars;
+  /** `solid` as INDICES: an entry may name the char that painted the cell. */
+  private solidIndices;
   get solid(): number[];
   set solid(value: number[]);
   opacity: number;

package/dist/2d.js

@@ -1,9 +1,9 @@
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as showBootFailure } from "./boot-failure-CKYrEcGF.js";
 import { t as isWebGLAvailable } from "./webgl-unavailable-C8aDbGmR.js";
-import { a as AssetStore2D, i as syncTree2D, r as Renderer2D, t as createGame2D } from "./create-game-Bwvh6q8A.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-Bkk0wSDB.js";
-import { n as enablePhysics2D, t as Physics2D } from "./physics-2d-CE0Qvy3V.js";
+import { a as AssetStore2D, i as syncTree2D, r as Renderer2D, t as createGame2D } from "./create-game-C9rWqqAC.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-C8HuRkOf.js";
+import { n as enablePhysics2D, t as Physics2D } from "./physics-2d-DrIgTlLk.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

@@ -1,10 +1,10 @@
-import { c as showBootFailure, i as ParticleSim, o as ParticleView, r as SpatialPose, s as isWebGLAvailable } from "./audio-player-DaMxqfNE.js";
-import { D as QualityCaps, P as Scene$1, S as Scheduler, T as RendererStats, b as Engine, d as PropSchema, jt as Node, n as BehaviorCtor, w as GameStats, x as EngineOptions } from "./behavior-DZExDn9o.js";
+import { c as showBootFailure, i as ParticleSim, o as ParticleView, r as SpatialPose, s as isWebGLAvailable } from "./audio-player-ioZ7VKC6.js";
+import { D as QualityCaps, P as Scene$1, S as Scheduler, T as RendererStats, b as Engine, d as PropSchema, jt as Node, n as BehaviorCtor, w as GameStats, x as EngineOptions } from "./behavior-Bf9P9oB2.js";
 import { t as DiagnosticSink } from "./diagnostics-Cu85N3tL.js";
 import { a as SceneJson$1, s as JsonObject } from "./rng-Bb-IutXB.js";
 import { t as EditorSwitchOptions } from "./editor-switch-CFU9mCec.js";
 import { a as GridCell, c as diffText, d as frameText, i as FrameStatsOptions, l as frameSignature, n as FrameSignature, o as SIGNATURE_GRID, r as FrameStats, s as diffSignatures, t as FrameDiff, u as frameStats } from "./frame-report-DNxDAb1w.js";
-import { t as LoadSceneOptions } from "./loader-Cff09LMm.js";
+import { t as LoadSceneOptions } from "./loader-CBfQzB6S.js";
 import { n as PathGrid } from "./pathfinding-_fGrCFmH.js";
 import { AnimationClip, AnimationMixer, BufferGeometry, Color, DirectionalLight, Group, InstancedMesh, Mesh, MeshPhysicalMaterial, Object3D, PerspectiveCamera, Scene, ShaderMaterial, Texture, Vector3, WebGLRenderer } from "three";
 import { VRM } from "@pixiv/three-vrm";

package/dist/3d.js

@@ -1,12 +1,12 @@
-import { b as sunDirectionFromElevationAzimuth, v as horizonColorFromSky, x as sunDirectionFromSky, y as parseEnvironment3D } from "./save-slots-BXVg148r.js";
+import { C as sunDirectionFromSky, S as sunDirectionFromElevationAzimuth, b as horizonColorFromSky, x as parseEnvironment3D } from "./save-slots-CEuJPUle.js";
 import { t as showBootFailure } from "./boot-failure-CKYrEcGF.js";
 import { t as isWebGLAvailable } from "./webgl-unavailable-C8aDbGmR.js";
-import { a as frameSignature, n as diffSignatures, o as frameStats, r as diffText, s as frameText, t as SIGNATURE_GRID } from "./frame-report-Dlq13Gyj.js";
-import { B as Area3D, G as Node3D, H as PhysicsBody3D, I as Water3D, J as WATER_MAX_RIPPLES, L as WATER_CUTOUT_MAX, R as WaterCutout3D, U as RigidBody3D, V as CharacterBody3D, W as StaticBody3D } from "./gameplay-BfHkuzVb.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-D6Q5BxeE.js";
-import { a as Environment3D, c as AssetStore3D, i as syncTree, o as applyQualityTier3D, r as Renderer3D, s as setEnvironment3D, t as createGame3D } from "./create-game-C7ffQWW7.js";
+import { a as frameSignature, n as diffSignatures, o as frameStats, r as diffText, s as frameText, t as SIGNATURE_GRID } from "./frame-report-D-_7YF2G.js";
+import { G as StaticBody3D, H as CharacterBody3D, K as Node3D, L as Water3D, R as WATER_CUTOUT_MAX, U as PhysicsBody3D, V as Area3D, W as RigidBody3D, Y as WATER_MAX_RIPPLES, z as WaterCutout3D } from "./gameplay-BlQe-M07.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-BeHoaGhy.js";
+import { a as Environment3D, c as AssetStore3D, i as syncTree, o as applyQualityTier3D, r as Renderer3D, s as setEnvironment3D, t as createGame3D } from "./create-game-CmFAtLZp.js";
 import { n as splatWeights, t as buildHeightmap } from "./heightmap-BYgD5Edk.js";
-import { n as enablePhysics3D, t as Physics3D } from "./physics-3d-CpH-2gn5.js";
+import { n as enablePhysics3D, t as Physics3D } from "./physics-3d-BzOCw1VS.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/{agent8-CmNF01gA.js → agent8-BqZ0_O1u.js}

@@ -1,5 +1,5 @@
 import { o as __exportAll } from "./json-CfTjpvW8.js";
-import { q as diagnose } from "./save-slots-BXVg148r.js";
+import { Y as diagnose } from "./save-slots-CEuJPUle.js";
 //#region src/net/agent8.ts
 var agent8_exports = /* @__PURE__ */ __exportAll({
 	Agent8TransportForTest: () => Agent8Transport,

package/dist/{audio-player-DaMxqfNE.d.ts → audio-player-ioZ7VKC6.d.ts}

@@ -1,4 +1,4 @@
-import { d as PropSchema, dt as Listener, jt as Node } from "./behavior-DZExDn9o.js";
+import { d as PropSchema, dt as Listener, jt as Node } from "./behavior-Bf9P9oB2.js";
 import { t as Rng } from "./rng-Bb-IutXB.js";
 
 //#region src/core/boot-failure.d.ts

package/dist/{behavior-DZExDn9o.d.ts → behavior-Bf9P9oB2.d.ts}

@@ -414,6 +414,17 @@ declare class Node implements NodeLifecycle {
   * SceneTree). Frees immediately when detached from any tree.
   */
   queueFree(): void;
+  /**
+  * Has this node been torn down?
+  *
+  * A scene swap frees the tree it replaces, so the answer is `true` for every
+  * node of the scene you just left — which is exactly the state a behavior is
+  * in when it runs one more line after `goToScene`. Kept as a flag rather than
+  * inferred from `parent`/`tree`, because a DETACHED node (a prefab on a
+  * shelf, a clone waiting to be added) has neither and is perfectly alive.
+  */
+  get freed(): boolean;
+  private _freed;
   /** Immediately detach and tear down this node and its children. */
   free(): void;
   /**
@@ -2286,7 +2297,7 @@ declare class Engine {
   * pass it back. Without that a game using the documented sub-scenes booted
   * fine and threw `UNRESOLVED_INSTANCE` on its first restart.
   */
-  resolveScene?: (path: string) => SceneJson;
+  resolveScene?: (path: string) => SceneJson | null | undefined;
   /**
   * How the current scene was LOADED, for the rebuilds that happen later.
   *

package/dist/{create-game-Bwvh6q8A.js → create-game-C9rWqqAC.js}

@@ -1,15 +1,15 @@
 import { o as __exportAll } from "./json-CfTjpvW8.js";
-import { E as resolveViewport, T as computeViewport, it as registerBehavior, p as loadScene, q as diagnose } from "./save-slots-BXVg148r.js";
-import { C as qualityRendering, _ as AudioPlayer, v as Engine } from "./register-6DYnKZcy.js";
+import { D as computeViewport, O as resolveViewport, R as sceneDimension, Y as diagnose, h as loadScene, ot as registerBehavior } from "./save-slots-CEuJPUle.js";
+import { C as qualityRendering, _ as AudioPlayer, v as Engine } from "./register-5IYfooAN.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { n as attachTouchControls } from "./touch-BnCyPA0G.js";
 import { n as withWebGLContext, r as resolveRendering } from "./webgl-unavailable-C8aDbGmR.js";
-import { a as devServerLibrary, c as applyDriveStep, d as audioErrors, i as crossFade, l as wireDevChannel, n as teardown, o as openBundledEditor, r as pauseWhenHidden, t as nodeFromHits, u as claimCanvasGestures } from "./picking-CQJ_PJKh.js";
-import { o as frameStats } from "./frame-report-Dlq13Gyj.js";
-import { n as registerGameplayBehaviors } from "./gameplay-BfHkuzVb.js";
-import { g as PhysicsBody2D, n as UILayer, t as registerNodes2D, u as Camera2D, y as Node2D } from "./register-Bkk0wSDB.js";
+import { a as devServerLibrary, c as applyDriveStep, d as audioErrors, i as crossFade, l as wireDevChannel, n as teardown, o as openBundledEditor, r as pauseWhenHidden, t as nodeFromHits, u as claimCanvasGestures } from "./picking-C9McVJrO.js";
+import { o as frameStats } from "./frame-report-D-_7YF2G.js";
+import { n as registerGameplayBehaviors } from "./gameplay-BlQe-M07.js";
+import { g as PhysicsBody2D, n as UILayer, t as registerNodes2D, u as Camera2D, y as Node2D } from "./register-C8HuRkOf.js";
 import { t as debugSources } from "./debug-draw-BM3DsvtT.js";
-import { n as enablePhysics2D } from "./physics-2d-CE0Qvy3V.js";
+import { n as enablePhysics2D } from "./physics-2d-DrIgTlLk.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
 /**
@@ -132,6 +132,34 @@ var AssetStore2D = class {
 	}
 };
 //#endregion
+//#region src/2d/debug-lines.ts
+/**
+* Physics debug segments, moved into the space the 2D renderer draws in.
+*
+* Two coordinate systems meet here and they disagree about Y. Engine 2D is
+* y-DOWN (screen pixels, gravity `+980`, and Rapier's world is built the same
+* way — `kcc.setUp({x: 0, y: -1})`). The three.js scene the renderer paints
+* into is y-UP, which is why every node's own sync writes
+* `o.position.set(x, -y, 0)`.
+*
+* `syncDebugLines` copied Rapier's vertices straight across without that
+* negation, so every collider outline was MIRRORED about the world's y=0 line:
+* a crate at y=120 drew its box at −120, the further from the axis the further
+* off, and a tilemap's merged floor at y=384 drew itself off the top of the
+* canvas entirely. The overlay whose whole promise is "the colliders the
+* ENGINE builds… wherever physics actually puts them" was the one thing in the
+* 2D view that was not where physics put it.
+*/
+function debugLinesToScene(px) {
+	const xyz = new Float32Array(px.length / 2 * 3);
+	for (let i = 0, j = 0; i < px.length; i += 2, j += 3) {
+		xyz[j] = px[i];
+		xyz[j + 1] = -px[i + 1];
+		xyz[j + 2] = 0;
+	}
+	return xyz;
+}
+//#endregion
 //#region src/2d/picking.ts
 function screenFromWorld(view, wx, wy) {
 	return {
@@ -547,12 +575,7 @@ var Renderer2D = class {
 		}
 		this.debugLines.visible = vertices !== null;
 		if (!vertices) return;
-		const xyz = new Float32Array(vertices.length / 2 * 3);
-		for (let i = 0, j = 0; i < vertices.length; i += 2, j += 3) {
-			xyz[j] = vertices[i];
-			xyz[j + 1] = vertices[i + 1];
-			xyz[j + 2] = 0;
-		}
+		const xyz = debugLinesToScene(vertices);
 		this.debugLines.geometry.setAttribute("position", new BufferAttribute(xyz, 3));
 	}
 	render() {
@@ -809,6 +832,7 @@ async function createGame2D(opts) {
 		...opts._scheduler ? { scheduler: opts._scheduler } : {}
 	});
 	const sourceJson = cloneSceneJson(opts.scene);
+	if (sceneDimension(sourceJson) === "3d") throw new IncantoError("WRONG_DIMENSION", `createGame2D was given a 3D scene ('${String(sourceJson.name ?? "scene")}'). Its nodes are never drawn by the 2D renderer and never simulated by 2D physics — you get a blank canvas. Boot it with createGame3D instead.`);
 	const scene = loadScene(cloneSceneJson(sourceJson), {
 		resolveScene: opts.resolveScene,
 		engine

package/dist/{create-game-C7ffQWW7.js → create-game-CmFAtLZp.js}

@@ -1,15 +1,15 @@
 import { o as __exportAll } from "./json-CfTjpvW8.js";
-import { it as registerBehavior, p as loadScene, q as diagnose, v as horizonColorFromSky, x as sunDirectionFromSky, y as parseEnvironment3D } from "./save-slots-BXVg148r.js";
-import { C as qualityRendering, S as qualityEnvironment, _ as AudioPlayer, v as Engine, x as qualityCaps } from "./register-6DYnKZcy.js";
+import { C as sunDirectionFromSky, R as sceneDimension, Y as diagnose, b as horizonColorFromSky, h as loadScene, ot as registerBehavior, x as parseEnvironment3D } from "./save-slots-CEuJPUle.js";
+import { C as qualityRendering, S as qualityEnvironment, _ as AudioPlayer, v as Engine, x as qualityCaps } from "./register-5IYfooAN.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { n as attachTouchControls } from "./touch-BnCyPA0G.js";
 import { n as withWebGLContext, r as resolveRendering } from "./webgl-unavailable-C8aDbGmR.js";
-import { a as devServerLibrary, c as applyDriveStep, d as audioErrors, i as crossFade, l as wireDevChannel, n as teardown, o as openBundledEditor, r as pauseWhenHidden, s as poseFromRenderer, t as nodeFromHits, u as claimCanvasGestures } from "./picking-CQJ_PJKh.js";
-import { o as frameStats } from "./frame-report-Dlq13Gyj.js";
-import { G as Node3D, H as PhysicsBody3D, n as registerGameplayBehaviors, q as createCausticsQuad } from "./gameplay-BfHkuzVb.js";
+import { a as devServerLibrary, c as applyDriveStep, d as audioErrors, i as crossFade, l as wireDevChannel, n as teardown, o as openBundledEditor, r as pauseWhenHidden, s as poseFromRenderer, t as nodeFromHits, u as claimCanvasGestures } from "./picking-C9McVJrO.js";
+import { o as frameStats } from "./frame-report-D-_7YF2G.js";
+import { J as createCausticsQuad, K as Node3D, U as PhysicsBody3D, n as registerGameplayBehaviors } from "./gameplay-BlQe-M07.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-D6Q5BxeE.js";
-import { n as enablePhysics3D } from "./physics-3d-CpH-2gn5.js";
+import { E as Camera3D, U as TextureCache3D, g as ModelInstance3D, n as registerNodes3D, t as resolveEnvironmentHdri, v as DirectionalLight3D } from "./environment-presets-BeHoaGhy.js";
+import { n as enablePhysics3D } from "./physics-3d-BzOCw1VS.js";
 import { ACESFilmicToneMapping, AmbientLight, Box3, BufferAttribute, BufferGeometry, Color, DepthTexture, EquirectangularReflectionMapping, FloatType, Fog, HalfFloatType, LineBasicMaterial, LineSegments, LoadingManager, 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";
@@ -2253,6 +2253,7 @@ async function createGame3D(opts) {
 		...opts._scheduler ? { scheduler: opts._scheduler } : {}
 	});
 	const sourceJson = cloneSceneJson(opts.scene);
+	if (sceneDimension(sourceJson) === "2d") throw new IncantoError("WRONG_DIMENSION", `createGame3D was given a 2D scene ('${String(sourceJson.name ?? "scene")}'). Its nodes are never drawn by the 3D renderer and never simulated by 3D physics — you get a blank canvas. Boot it with createGame2D instead.`);
 	const scene = loadScene(cloneSceneJson(sourceJson), {
 		resolveScene: opts.resolveScene,
 		engine

package/dist/debug.d.ts

@@ -1,4 +1,4 @@
-import { Ft as LogLevel, T as RendererStats, b as Engine } from "./behavior-DZExDn9o.js";
+import { Ft as LogLevel, T as RendererStats, b as Engine } from "./behavior-Bf9P9oB2.js";
 
 //#region src/debug/panel.d.ts
 /** Minimal document surface the overlay needs (injectable for tests). */