incanto 0.70.0 → 0.71.0

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-L8yccdMP.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-Dcz0fr1S.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-8-IHvbKD.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-CH4kt78v.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-BYQCBySi.js";
+import { n as enablePhysics2D, t as Physics2D } from "./physics-2d-FhrXUc6B.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-L8yccdMP.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-Dcz0fr1S.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-8-IHvbKD.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-Bvuh2p_r.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-CNULJvwh.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-99BzP_L-.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-LCHBLfA4.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-CFEGxBXZ.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-Cfmd3ar_.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-Bvuh2p_r.js";
 //#region src/net/agent8.ts
 var agent8_exports = /* @__PURE__ */ __exportAll({
 	Agent8TransportForTest: () => Agent8Transport,

package/dist/{audio-player-DaMxqfNE.d.ts → audio-player-L8yccdMP.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-Dcz0fr1S.js";
 import { t as Rng } from "./rng-Bb-IutXB.js";
 
 //#region src/core/boot-failure.d.ts

package/dist/{behavior-DZExDn9o.d.ts → behavior-Dcz0fr1S.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;
   /**

package/dist/{create-game-Bwvh6q8A.js → create-game-CH4kt78v.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, Y as diagnose, h as loadScene, ot as registerBehavior } from "./save-slots-Bvuh2p_r.js";
+import { C as qualityRendering, _ as AudioPlayer, v as Engine } from "./register-DuVdzxbq.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-DVo7fI13.js";
+import { o as frameStats } from "./frame-report-D-_7YF2G.js";
+import { n as registerGameplayBehaviors } from "./gameplay-CNULJvwh.js";
+import { g as PhysicsBody2D, n as UILayer, t as registerNodes2D, u as Camera2D, y as Node2D } from "./register-BYQCBySi.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-FhrXUc6B.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
 /**

package/dist/{create-game-C7ffQWW7.js → create-game-LCHBLfA4.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, Y as diagnose, b as horizonColorFromSky, h as loadScene, ot as registerBehavior, x as parseEnvironment3D } from "./save-slots-Bvuh2p_r.js";
+import { C as qualityRendering, S as qualityEnvironment, _ as AudioPlayer, v as Engine, x as qualityCaps } from "./register-DuVdzxbq.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-DVo7fI13.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-CNULJvwh.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-99BzP_L-.js";
+import { n as enablePhysics3D } from "./physics-3d-CFEGxBXZ.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";

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-Dcz0fr1S.js";
 
 //#region src/debug/panel.d.ts
 /** Minimal document surface the overlay needs (injectable for tests). */

package/dist/editor.js

@@ -5,18 +5,21 @@ import { registerGameplayBehaviors as A } from "incanto/gameplay";
 import { registerNodesNet as ee } from "incanto/net";
 import { GENERATORS as te, runGenerator as j } from "incanto/env";
 //#region src/format-json.ts
-var ne = 80, re = "  ";
+var ne = 100, re = "  ";
 function M(e) {
-	return `${ie(e, 0)}\n`;
+	return `${ie(e, 0, 0)}\n`;
 }
-function ie(e, t) {
+function ie(e, t, n) {
 	if (typeof e != "object" || !e) return JSON.stringify(e);
-	let n = N(e);
-	if (t * 2 + n.length <= ne) return n;
-	let r = re.repeat(t + 1), i = re.repeat(t);
-	if (Array.isArray(e)) return e.length === 0 ? "[]" : `[\n${e.map((e) => r + ie(e, t + 1)).join(",\n")}\n${i}]`;
-	let a = Object.entries(e);
-	return a.length === 0 ? "{}" : `{\n${a.map(([e, n]) => `${r}${JSON.stringify(e)}: ${ie(n, t + 1)}`).join(",\n")}\n${i}}`;
+	let r = N(e);
+	if (n + r.length + 1 <= ne) return r;
+	let i = re.repeat(t + 1), a = re.repeat(t), o = (t + 1) * 2;
+	if (Array.isArray(e)) return e.length === 0 ? "[]" : `[\n${e.map((e) => i + ie(e, t + 1, o)).join(",\n")}\n${a}]`;
+	let s = Object.entries(e);
+	return s.length === 0 ? "{}" : `{\n${s.map(([e, n]) => {
+		let r = `${JSON.stringify(e)}: `;
+		return `${i}${r}${ie(n, t + 1, o + r.length)}`;
+	}).join(",\n")}\n${a}}`;
 }
 function N(e) {
 	if (typeof e != "object" || !e) return JSON.stringify(e);
@@ -1289,8 +1292,8 @@ var kt = {
 				en: "A whole tile level as ONE node — grid render + merged static colliders.",
 				ko: "타일 레벨 전체를 노드 하나로 — 그리드 렌더 + 병합된 정적 콜라이더."
 			}, {
-				en: "Author cells as rows of characters: \".\" / space = empty, digits 0-9 = atlas tile index, other chars map through legend ({\"G\": 12}). texture is a \"$atlas\" asset read left-to-right top-to-bottom in tileSize squares (columns: 0 derives from the texture width). Tile indices listed in solid become static colliders, greedy-merged into a few rectangles. Cell (0,0) hangs its top-left on the node origin.",
-				ko: "cells를 문자 행으로 작성합니다: \".\"/공백 = 빈 칸, 숫자 0-9 = 아틀라스 타일 번호, 그 외 문자는 legend({\"G\": 12})로 매핑. texture는 tileSize 정사각형을 좌→우, 상→하로 읽는 \"$아틀라스\" 에셋입니다(columns: 0이면 텍스처 폭에서 유도). solid에 나열된 타일 번호는 정적 콜라이더가 되며 소수의 직사각형으로 탐욕 병합됩니다. (0,0) 칸의 좌상단이 노드 원점에 걸립니다."
+				en: "Author cells as rows of characters: \".\" / space = empty, digits 0-9 = atlas tile index, other chars map through legend ({\"G\": 12}) or colors ({\"#\": \"#3a4356\"}), which paints a flat colour and needs no atlas at all — use it to block out a level before the art arrives (exclusive with texture). texture is a \"$atlas\" asset read left-to-right top-to-bottom in tileSize squares (columns: 0 derives from the texture width). solid becomes static colliders, greedy-merged into a few rectangles, and takes the CHAR you painted as well as a tile index. Cell (0,0) hangs its top-left on the node origin.",
+				ko: "cells를 문자 행으로 작성합니다: \".\"/공백 = 빈 칸, 숫자 0-9 = 아틀라스 타일 번호, 그 외 문자는 legend({\"G\": 12}) 또는 colors({\"#\": \"#3a4356\"})로 매핑합니다. colors는 아틀라스 없이 단색 칸을 그려서 아트가 오기 전에 레벨을 잡을 때 씁니다(texture와 동시 사용 불가). texture는 tileSize 정사각형을 좌→우, 상→하로 읽는 \"$아틀라스\" 에셋입니다(columns: 0이면 텍스처 폭에서 유도). solid는 정적 콜라이더가 되며(타일 번호뿐 아니라 칠한 문자도 받습니다) 소수의 직사각형으로 탐욕 병합됩니다. (0,0) 칸의 좌상단이 노드 원점에 걸립니다."
 			}),
 			L("AnimatedSprite2D", {
 				en: "Spritesheet animation player.",
@@ -2374,15 +2377,16 @@ function In(e, t, n, r) {
 	}
 	return s;
 }
-function Ln(e, t) {
-	let n = new Set([
+function Ln(e, t, n = {}) {
+	let r = new Set([
 		".",
 		"0",
 		"1"
 	]);
-	for (let t of e) if (typeof t == "string") for (let e of t) e !== " " && n.add(e);
-	for (let e of Object.keys(t)) n.add(e);
-	return [...n];
+	for (let t of e) if (typeof t == "string") for (let e of t) e !== " " && r.add(e);
+	for (let e of Object.keys(t)) r.add(e);
+	for (let e of Object.keys(n)) r.add(e);
+	return [...r];
 }
 //#endregion
 //#region src/inspector.ts
@@ -3536,17 +3540,17 @@ function Ir(e, t) {
 	r.type = "button", r.className = t.active() ? "paint-toggle on" : "paint-toggle", r.textContent = t.active() ? "🖌 painting — click the canvas" : "🖌 paint tiles", r.addEventListener("click", () => t.toggle()), n.appendChild(r);
 	let i = document.createElement("div");
 	i.className = "paint-palette";
-	let a = e.props?.cells ?? [], o = e.props?.legend ?? {};
-	for (let e of Ln(a, o)) {
+	let a = e.props?.cells ?? [], o = e.props?.legend ?? {}, s = e.props?.colors ?? {};
+	for (let e of Ln(a, o, s)) {
 		let n = document.createElement("button");
-		n.type = "button", n.className = t.brush() === e ? "paint-chip on" : "paint-chip", n.textContent = e === "." ? "␡" : e, n.title = e === "." ? "eraser (empty cell)" : `tile '${e}'`, n.addEventListener("click", () => t.setBrush(e)), i.appendChild(n);
+		n.type = "button", n.className = t.brush() === e ? "paint-chip on" : "paint-chip", n.textContent = e === "." ? "␡" : e, n.title = e === "." ? "eraser (empty cell)" : s[e] ? `tile '${e}' — ${s[e]}` : `tile '${e}'`, s[e] && (n.style.borderColor = s[e]), n.addEventListener("click", () => t.setBrush(e)), i.appendChild(n);
 	}
-	let s = document.createElement("input");
-	s.type = "text", s.maxLength = 1, s.className = "paint-brush-input", s.value = t.brush(), s.title = "brush char (digit or a legend char)", s.addEventListener("change", () => {
-		s.value.length === 1 && t.setBrush(s.value);
-	}), i.appendChild(s), n.appendChild(i);
-	let c = document.createElement("div");
-	return c.className = "paint-hint", c.textContent = "grid grows right/down; digits map to atlas tiles, others need legend", n.appendChild(c), n;
+	let c = document.createElement("input");
+	c.type = "text", c.maxLength = 1, c.className = "paint-brush-input", c.value = t.brush(), c.title = "brush char (a digit, or a char from legend/colors)", c.addEventListener("change", () => {
+		c.value.length === 1 && t.setBrush(c.value);
+	}), i.appendChild(c), n.appendChild(i);
+	let l = document.createElement("div");
+	return l.className = "paint-hint", l.textContent = "grid grows right/down; digits map to atlas tiles, others need legend or colors", n.appendChild(l), n;
 }
 function Lr(e, t, n, r = "", i) {
 	let a = document.createElement("textarea");

package/dist/{environment-presets-D6Q5BxeE.js → environment-presets-99BzP_L-.js}

@@ -1,11 +1,11 @@
-import { q as diagnose } from "./save-slots-BXVg148r.js";
-import { M as translateOn, t as registerCoreNodes } from "./register-6DYnKZcy.js";
+import { Y as diagnose } from "./save-slots-Bvuh2p_r.js";
+import { M as translateOn, t as registerCoreNodes } from "./register-DuVdzxbq.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as Rng } from "./rng-CDOMybym.js";
 import { c as getNodeSchema, h as didYouMean, p as registerNode } from "./touch-BnCyPA0G.js";
 import { t as createNoise2D } from "./noise-D3nPpmFg.js";
 import { i as ParticleSim, n as resolveFrames, o as PARTICLE_PRESET_NAMES, r as validateAnimations, s as applyParticlePreset, t as resolveAnimation } from "./sprite-animation-CqR2o3SA.js";
-import { B as Area3D, E as effectRng, G as Node3D, H as PhysicsBody3D, I as Water3D, R as WaterCutout3D, U as RigidBody3D, V as CharacterBody3D, W as StaticBody3D, Y as colliderFootDrop, Z as worldPosition, w as tolerateUnknownAction, z as rejectScale } from "./gameplay-BfHkuzVb.js";
+import { B as rejectScale, D as effectRng, G as StaticBody3D, H as CharacterBody3D, K as Node3D, L as Water3D, Q as worldPosition, T as tolerateUnknownAction, U as PhysicsBody3D, V as Area3D, W as RigidBody3D, X as colliderFootDrop, z as WaterCutout3D } from "./gameplay-CNULJvwh.js";
 import { t as checkSheetGrid } from "./sheet-grid-Cea343VO.js";
 import { n as splatWeights, t as buildHeightmap } from "./heightmap-BYgD5Edk.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";

package/dist/{frame-report-Dlq13Gyj.js → frame-report-D-_7YF2G.js}

@@ -177,7 +177,7 @@ const pct = (v) => `${(v * 100).toFixed(1)}%`;
 /** The report a person or an agent reads. Verdict first, numbers after. */
 function frameText(stats) {
 	const lines = [];
-	if (stats.hidden) lines.push("THE PAGE IS HIDDEN — a browser stops animating a window covered by another, so these pixels are whatever it last drew. Bring it to the front and capture again.");
+	if (stats.hidden) lines.push("the page is hidden, so the game is PAUSED — these pixels were rendered for this capture (current), but nothing is moving. A `--do` drive needs the window in front.");
 	if (stats.black) lines.push("BLACK SCREEN — nothing was drawn (no light, no camera, or nothing in view)");
 	else if (stats.uniform) lines.push("one flat colour — the camera may be inside geometry, or only the sky is drawn");
 	else if (!stats.subject) lines.push("nothing but background — the camera is pointed away from everything in the scene");