incanto 0.30.0 → 0.32.0

package/bin/incanto-play.mjs

@@ -17,6 +17,7 @@ import { dirname, join, resolve } from 'node:path';
  *   pointer <dx> <dy>        look deltas               wheel <dy>
  *   capture [file]           current state as scene JSON (stdout or file)
  *   describe                 one line per node, non-default props only
+ *   framing                  what the camera SEES: on/off screen, lights, overlaps
  *   logs                     engine.log entries since the last call
  *   quit
  *
@@ -56,7 +57,7 @@ if (args.help || !args.scene) {
   console.error(`Usage: incanto-play <scene.json> [--behaviors <file.ts|.js>] [--seed N] [--fixed-hz 60] [--commands <file>]
 
 Headless play: stdin commands (step/press/release/vector/key/mouse/pointer/
-wheel/capture/describe/logs/quit), JSON-line responses on stdout.`);
+wheel/capture/describe/framing/logs/quit), JSON-line responses on stdout.`);
   process.exit(args.help && args.scene !== undefined ? 0 : 1);
 }
 
@@ -175,6 +176,10 @@ function handle(line) {
       case 'describe':
         out({ ok: true, cmd, text: session.describe() });
         break;
+      case 'framing':
+        // what the camera can SEE — on/off screen, lit or black, overlaps
+        out({ ok: true, cmd, text: session.framing() });
+        break;
       case 'logs':
         out({ ok: true, cmd, entries: session.drainLogs() });
         break;
@@ -188,7 +193,7 @@ function handle(line) {
           cmd,
           error: {
             code: 'UNKNOWN_COMMAND',
-            message: `unknown command '${cmd}'. Commands: step press release vector key mouse pointer wheel capture describe logs quit`,
+            message: `unknown command '${cmd}'. Commands: step press release vector key mouse pointer wheel capture describe framing logs quit`,
           },
         });
     }

package/dist/2d.d.ts

@@ -1,7 +1,7 @@
+import { C as RendererStats, S as GameStats, X as Node, b as Scheduler, l as PropSchema, n as BehaviorCtor, v as Engine, w as Scene$1 } from "./behavior-D_jMpFh8.js";
+import { n as DiagnosticSink, t as EditorSwitchOptions } from "./editor-switch-BJb-CWfA.js";
 import { i as SceneJson, s as JsonObject } from "./schema-CcoWb32N.js";
-import { $ as Node, C as RendererStats, S as GameStats, b as Scheduler, l as PropSchema, n as BehaviorCtor, v as Engine, w as Scene$1 } from "./behavior-BAc0erXF.js";
-import { t as EditorSwitchOptions } from "./editor-switch-B0wB_DSr.js";
-import { t as LoadSceneOptions } from "./loader-B242FF6N.js";
+import { t as LoadSceneOptions } from "./loader-BYBrqTxP.js";
 import { t as ParticleSim } from "./particle-sim-CwJ5rI_P.js";
 import { Group, Mesh, Object3D, Scene, Texture } from "three";
 import * as RapierNs from "@dimforge/rapier2d-compat";
@@ -24,9 +24,15 @@ interface SheetInfo {
 * `"$key"`. The texture loader is injectable so tests run headless.
 */
 declare class AssetStore2D {
+  private readonly engine;
   private readonly entries;
   private readonly loader;
-  constructor(loader?: (url: string, callbacks?: TextureLoadCallbacks) => Texture);
+  /**
+  * `engine` is optional so a bare store still constructs in tests. Given one,
+  * a texture that fails to load lands in `engine.log` — where the overlay and
+  * `runScript()` can see it — instead of only in the browser console.
+  */
+  constructor(loader?: (url: string, callbacks?: TextureLoadCallbacks) => Texture, engine?: DiagnosticSink | null);
   /** Load (or extend with) a scene's `assets` declarations. Hard-validates each entry. */
   load(assets: Record<string, JsonObject>): void;
   /** Load status of a declared asset KEY (no '$'), or undefined if unknown. */
@@ -757,7 +763,8 @@ declare class Renderer2D {
   private readonly worldCam;
   private readonly uiCam;
   private readonly engine;
-  private readonly assets;
+  /** The texture store. Public so `renderer.assets.status(key)` is reachable. */
+  readonly assets: AssetStore2D;
   private readonly loadedAssetScenes;
   private readonly disconnect;
   private readonly canvas;

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-5z_QVtLx.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-DWcWq4QG.js";
-import { n as enablePhysics2D, t as Physics2D } from "./physics-2d-3kOQCtgd.js";
+import { a as AssetStore2D, i as syncTree2D, r as Renderer2D, t as createGame2D } from "./create-game-bKHgHcsZ.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-tkR_8tWg.js";
+import { n as enablePhysics2D, t as Physics2D } from "./physics-2d-D9wquBvK.js";
 //#region src/2d/library-sprite.ts
 /**
 * Turn a library sprite-animation JSON into a scene-ready spritesheet asset

package/dist/3d.d.ts

@@ -1,9 +1,9 @@
+import { C as RendererStats, S as GameStats, X as Node, b as Scheduler, l as PropSchema, n as BehaviorCtor, v as Engine, w as Scene$1 } from "./behavior-D_jMpFh8.js";
+import { n as DiagnosticSink, t as EditorSwitchOptions } from "./editor-switch-BJb-CWfA.js";
 import { i as SceneJson, s as JsonObject } from "./schema-CcoWb32N.js";
-import { $ as Node, C as RendererStats, S as GameStats, b as Scheduler, l as PropSchema, n as BehaviorCtor, v as Engine, w as Scene$1 } from "./behavior-BAc0erXF.js";
-import { t as EditorSwitchOptions } from "./editor-switch-B0wB_DSr.js";
-import { t as LoadSceneOptions } from "./loader-B242FF6N.js";
+import { t as LoadSceneOptions } from "./loader-BYBrqTxP.js";
 import { t as ParticleSim } from "./particle-sim-CwJ5rI_P.js";
-import { n as PathGrid, s as SpatialPose } from "./pathfinding-BwD974Ss.js";
+import { n as PathGrid, s as SpatialPose } from "./pathfinding-BwhqPD3i.js";
 import { AnimationClip, AnimationMixer, BufferGeometry, Color, DirectionalLight, Group, InstancedMesh, Mesh, MeshPhysicalMaterial, Object3D, PerspectiveCamera, Scene, ShaderMaterial, Vector3, WebGLRenderer } from "three";
 import { VRM } from "@pixiv/three-vrm";
 import { Sky } from "three/examples/jsm/objects/Sky.js";
@@ -44,12 +44,28 @@ interface AnimationEntry {
 * @pixiv/three-vrm (VRM 0.x facing fixed via rotateVRM0).
 */
 declare class AssetStore3D {
+  private readonly engine;
   private readonly models;
   private readonly animations;
   private readonly modelKeys;
   private readonly animationKeys;
   private readonly loader;
-  constructor();
+  /**
+  * `engine` is optional only so a bare store still constructs in tests. Give it
+  * one and every load failure lands in `engine.log` — where the debug overlay,
+  * `runScript()` and any agent tool can see it. Without it a 404'd GLB was a
+  * console line and an invisible model.
+  */
+  constructor(engine?: DiagnosticSink | null);
+  /**
+  * Every asset that failed, with the reason — the answer to "why is my model
+  * not there". Empty is the healthy case.
+  */
+  errors(): Array<{
+    ref: string;
+    url: string;
+    error: string;
+  }>;
   /** Map a scene's `assets` header. */
   load(assets: JsonObject): void;
   /** Animation `$key`s declared by the scene (editor dropdowns). */
@@ -472,6 +488,16 @@ interface CreateGame3DOptions {
   /** Keep the frame rate by rendering fewer pixels while frames run slow
   * (default ON). `false` pins the resolution — screenshots, capture, tests. */
   adaptiveResolution?: boolean;
+  /**
+  * Keep the drawing buffer readable so the canvas can be screenshot.
+  *
+  * WebGL clears it the instant a frame composites, so `toDataURL()` — and every
+  * screenshot built on it — is BLANK without this. Off by default: it costs a
+  * buffer copy per frame and only a run that means to look at the output should
+  * pay for it. `environment.rendering.preserveDrawingBuffer` does the same from
+  * the scene.
+  */
+  preserveDrawingBuffer?: boolean;
   resolveScene?: LoadSceneOptions["resolveScene"];
   /**
   * Boot progress, for the loading screen an app already has.
@@ -495,6 +521,14 @@ interface CreateGame3DOptions {
 interface GameRenderer {
   dispose(): void;
   stats?(): RendererStats;
+  /** Loaded models/animations — `assets.errors()` answers "why is my model missing". */
+  assets?: {
+    errors(): Array<{
+      ref: string;
+      url: string;
+      error: string;
+    }>;
+  };
 }
 interface Game3D {
   engine: Engine;
@@ -513,6 +547,18 @@ interface Game3D {
   /** Engine + renderer perf counters in one read (fps/nodes/triangles/…). */
   stats(): GameStats;
   /**
+  * Assets that failed to load, with the reason.
+  *
+  * "The model just never appeared" used to be unanswerable from outside: the
+  * store was private on the renderer and the 404 went to the console only.
+  * Check this — and `stats().errors` — before assuming a scene is fine.
+  */
+  assetErrors(): Array<{
+    ref: string;
+    url: string;
+    error: string;
+  }>;
+  /**
   * Turn this page into the scene editor, right where the player is standing —
   * what the ☰ debug menu's "edit this scene" calls. Bind it to your own key or
   * button if you want the switch without the overlay.
@@ -2962,6 +3008,16 @@ interface Renderer3DOptions {
   * the resolution — for screenshots, video capture and pixel-diff tests.
   */
   adaptiveResolution?: boolean;
+  /**
+  * Keep the drawing buffer readable so the canvas can be SCREENSHOT.
+  *
+  * WebGL clears it the moment a frame composites, so `canvas.toDataURL()` and
+  * anything built on it (a Playwright screenshot, a pixel-diff test) comes
+  * back blank without this. Off by default — it costs a buffer copy per frame
+  * and only a run that intends to look at the output should pay it. The scene
+  * can ask for it too: `environment.rendering.preserveDrawingBuffer`.
+  */
+  preserveDrawingBuffer?: boolean;
 }
 /**
 * WebGL presentation layer: subscribes to `engine.updated`, mirrors the active
@@ -2991,7 +3047,12 @@ declare class Renderer3D {
   private readonly engine;
   private readonly disconnect;
   private readonly canvas;
-  private readonly assets;
+  /**
+  * The model/animation store. Public so a game (and an agent's tool) can ask
+  * `renderer.assets.errors()` why a model is not there — it used to be private,
+  * so a 404'd GLB was unanswerable from outside.
+  */
+  readonly assets: AssetStore3D;
   private readonly ownsAssets;
   private readonly loadedAssetScenes;
   /** The scene whose GPU programs have been pre-compiled (warm-up, see render). */

package/dist/3d.js

@@ -1,9 +1,9 @@
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
-import { A as Water3D, F as PhysicsBody3D, I as RigidBody3D, L as StaticBody3D, M as WaterCutout3D, N as Area3D, P as CharacterBody3D, R as Node3D, V as WATER_MAX_RIPPLES, j as WATER_CUTOUT_MAX } from "./gameplay-Cfr6aFZ1.js";
-import { a as Environment3D, c as sunDirectionFromElevationAzimuth, i as syncTree, l as sunDirectionFromSky, o as horizonColorFromSky, r as Renderer3D, s as parseEnvironment3D, t as createGame3D, u as AssetStore3D } from "./create-game-DuBTv2zI.js";
-import { A as DEFAULT_TERRAIN_TEXTURE_BASE, B as movementState, C as FLOWER_VARIETIES, D as BoneAttachment3D, E as BoneLookAt3D, F as MeshInstance3D, L as QUARTER_PITCH, M as terrainThemeLayers, N as Joint3D, O as Billboard3D, P as InstancedMesh3D, R as cameraRelative, S as resolveFlowerDensity, T as Camera3D, V as rigPose, _ as DirectionalLight3D, a as Trail3D, b as DENSITY_PRESETS, c as findRiverCoverageGaps, d as riverStepFor, f as smoothCourse, g as LoftMesh3D, h as ModelInstance3D, i as Tree3D, j as TERRAIN_THEMES, k as Terrain3D, l as projectToRiver, m as Particles3D, n as VOXEL_PALETTE, o as River3D, p as traceDownhillPath, r as VoxelGrid3D, s as buildRiverRings, t as registerNodes3D, u as riverCarveChannels, v as OmniLight3D, w as CharacterController3D, x as Flowers3D, y as Foliage3D, z as keyboardIntensity } from "./register-DJ0SByQg.js";
+import { A as Water3D, F as PhysicsBody3D, I as RigidBody3D, L as StaticBody3D, M as WaterCutout3D, N as Area3D, P as CharacterBody3D, R as Node3D, V as WATER_MAX_RIPPLES, j as WATER_CUTOUT_MAX } from "./gameplay-BftxM_It.js";
+import { a as Environment3D, c as sunDirectionFromElevationAzimuth, i as syncTree, l as sunDirectionFromSky, o as horizonColorFromSky, r as Renderer3D, s as parseEnvironment3D, t as createGame3D, u as AssetStore3D } from "./create-game-gXI7PYl0.js";
+import { A as Terrain3D, B as keyboardIntensity, C as resolveFlowerDensity, D as BoneLookAt3D, E as Camera3D, F as InstancedMesh3D, 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, V as movementState, _ 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--DigHNg4.js";
 import { n as splatWeights, t as buildHeightmap } from "./heightmap-CRK0M4jT.js";
-import { n as enablePhysics3D, t as Physics3D } from "./physics-3d-CeRH-Ff_.js";
+import { n as enablePhysics3D, t as Physics3D } from "./physics-3d-CnPygVGo.js";
 //#region src/3d/environment-runtime.ts
 /**
 * Live environment editing — the renderer re-applies `scene.environment`

package/dist/{audit-C6rMyict.js → audit-C4kmDK0o.js}

@@ -25,6 +25,19 @@ const HUD_WIDGETS = new Set([
 	"UiButton",
 	"UiDialogue"
 ]);
+const LIGHT_TYPES = new Set([
+	"DirectionalLight3D",
+	"OmniLight3D",
+	"SpotLight3D"
+]);
+/** Does the scene header light anything by itself (sky, hdri, ambient, preset)? */
+function isLit(environment) {
+	if (!environment) return false;
+	if (environment.preset !== void 0 || environment.sky !== void 0) return true;
+	if (environment.hdri !== void 0) return true;
+	const ambient = environment.ambient;
+	return typeof ambient?.intensity === "number" && ambient.intensity > 0;
+}
 /** Human-readable warnings (empty = clean). Pure JSON walk, no registry. */
 function auditScene(scene) {
 	const warnings = [];
@@ -32,6 +45,7 @@ function auditScene(scene) {
 	if (!root) return warnings;
 	let currentCameras = 0;
 	let cameras = 0;
+	let lights = 0;
 	const walk = (node, path, insideHud, staticRoot) => {
 		const type = node.type ?? "";
 		const props = node.props ?? {};
@@ -39,6 +53,7 @@ function auditScene(scene) {
 			cameras += 1;
 			if (props.current === true) currentCameras += 1;
 		}
+		if (LIGHT_TYPES.has(type)) lights += 1;
 		if (BODY_TYPES.has(type)) {
 			const collider = props.collider;
 			if (!collider || collider.shape === void 0) warnings.push(`${path}: ${type} has no collider — physics will skip it (add "collider": { "shape": ... }).`);
@@ -52,6 +67,7 @@ function auditScene(scene) {
 	walk(root, root.name ?? "root", false, root.props?.static === true ? root.name ?? "root" : null);
 	if (cameras > 0 && currentCameras === 0) warnings.push("no camera has \"current\": true — the screen renders from a default view, probably not what you framed.");
 	if (currentCameras > 1) warnings.push(`${currentCameras} cameras claim "current": true — only the first found wins.`);
+	if (scene.dimension === "3d" && lights === 0 && !isLit(scene.environment)) warnings.push("nothing lights this 3D scene — no light node, no environment sky/hdri, and no ambient intensity. It will render black. Add a DirectionalLight3D, or an \"environment\": { \"sky\": { \"type\": \"atmosphere\" } } / { \"preset\": \"...\" }.");
 	return warnings;
 }
 //#endregion

package/dist/{behavior-BAc0erXF.d.ts → behavior-D_jMpFh8.d.ts}

@@ -1,5 +1,59 @@
 import { a as Rng, c as JsonValue, i as SceneJson, s as JsonObject } from "./schema-CcoWb32N.js";
 
+//#region src/core/signal.d.ts
+/**
+* Minimal typed observer used for every engine event (Godot signal semantics).
+*
+* Emission is snapshot-based: listeners added during an emit do not fire in that
+* emit, and listeners removed during an emit are skipped.
+*/
+type SignalListener<Args extends unknown[]> = (...args: Args) => void;
+declare class Signal<Args extends unknown[] = unknown[]> {
+  private connections;
+  /** Connect a listener. Returns a disposer. Connecting the same fn twice is a no-op. */
+  connect(fn: SignalListener<Args>, opts?: {
+    once?: boolean;
+  }): () => void;
+  disconnect(fn: SignalListener<Args>): void;
+  disconnectAll(): void;
+  emit(...args: Args): void;
+  get connectionCount(): number;
+}
+//#endregion
+//#region src/core/log.d.ts
+type LogLevel = "debug" | "info" | "warn" | "error";
+interface LogEntry {
+  /** Monotonic per-manager sequence number (1-based). */
+  readonly seq: number;
+  /** Wall-clock-ish timestamp (performance.now when available) — diagnostics only. */
+  readonly timeMs: number;
+  readonly level: LogLevel;
+  /** The raw logged values, untouched — consumers format. */
+  readonly parts: readonly unknown[];
+}
+/**
+* The engine's log channel (`engine.log`, `this.log` in a Behavior): a ring
+* buffer plus a live `added` signal, so debug overlays and headless test
+* harnesses can tail game logs without scraping the browser console.
+*/
+declare class LogManager {
+  /** Fires once per entry, after it is buffered. */
+  readonly added: Signal<[LogEntry]>;
+  private readonly buffer;
+  private readonly capacity;
+  private seq;
+  constructor(capacity?: number);
+  debug(...parts: unknown[]): void;
+  info(...parts: unknown[]): void;
+  warn(...parts: unknown[]): void;
+  error(...parts: unknown[]): void;
+  /** Buffered entries, oldest first (capped at capacity). */
+  entries(): readonly LogEntry[];
+  /** Empty the buffer. The sequence keeps counting (entries stay unique). */
+  clear(): void;
+  private push;
+}
+//#endregion
 //#region src/core/scene-tree.d.ts
 /**
 * Owns a node tree and drives its lifecycle:
@@ -63,26 +117,6 @@ declare class SceneTree {
   private flushFreeQueue;
 }
 //#endregion
-//#region src/core/signal.d.ts
-/**
-* Minimal typed observer used for every engine event (Godot signal semantics).
-*
-* Emission is snapshot-based: listeners added during an emit do not fire in that
-* emit, and listeners removed during an emit are skipped.
-*/
-type SignalListener<Args extends unknown[]> = (...args: Args) => void;
-declare class Signal<Args extends unknown[] = unknown[]> {
-  private connections;
-  /** Connect a listener. Returns a disposer. Connecting the same fn twice is a no-op. */
-  connect(fn: SignalListener<Args>, opts?: {
-    once?: boolean;
-  }): () => void;
-  disconnect(fn: SignalListener<Args>): void;
-  disconnectAll(): void;
-  emit(...args: Args): void;
-  get connectionCount(): number;
-}
-//#endregion
 //#region src/core/node.d.ts
 /** Lifecycle hooks a SceneTree drives. Wired in scene-tree.ts. */
 interface NodeLifecycle {
@@ -186,6 +220,42 @@ declare class Node implements NodeLifecycle {
   _propagateUpdate(dt: number): void;
   /** @internal */
   _propagateFixedUpdate(dt: number): void;
+  /**
+  * Report an engine-level problem about THIS node.
+  *
+  * Goes to `engine.log` (what the debug overlay, `runScript()` and any agent
+  * tool read) as well as the console. A `console.warn` alone is invisible to
+  * every channel except a human with devtools open.
+  */
+  protected diagnose(level: "warn" | "error", ...parts: unknown[]): void;
+  /**
+  * This node threw and is being skipped. Its CHILDREN still run.
+  *
+  * The alternative is what used to happen: the exception escaped into the rAF
+  * callback, the loop was never rescheduled, and the game froze — permanently,
+  * silently, with `stats().running` still reporting true. In a vibe-coded
+  * project the least-tested code in the repo is a behavior's `update`, so this
+  * is not an edge case; it is Tuesday.
+  *
+  * Set it back to false to try the node again (the debug overlay's "resume").
+  */
+  errored: boolean;
+  /**
+  * This node's SCRIPT threw and is being skipped — the node itself still runs.
+  *
+  * A behavior is your code; the node is the engine's. A typo in the first must
+  * not switch off the second, or breaking a sword script stops the character
+  * from walking.
+  */
+  behaviorErrored: boolean;
+  /**
+  * Report ONCE and stop running this node's own update.
+  *
+  * Once, because a behavior that throws throws every frame: sixty identical
+  * stack traces a second buries the one line that matters and costs more than
+  * the game did.
+  */
+  private _quarantine;
   onEnterTree(): void;
   onReady(): void;
   onExitTree(): void;
@@ -646,40 +716,6 @@ declare class InputMap {
   private button;
 }
 //#endregion
-//#region src/core/log.d.ts
-type LogLevel = "debug" | "info" | "warn" | "error";
-interface LogEntry {
-  /** Monotonic per-manager sequence number (1-based). */
-  readonly seq: number;
-  /** Wall-clock-ish timestamp (performance.now when available) — diagnostics only. */
-  readonly timeMs: number;
-  readonly level: LogLevel;
-  /** The raw logged values, untouched — consumers format. */
-  readonly parts: readonly unknown[];
-}
-/**
-* The engine's log channel (`engine.log`, `this.log` in a Behavior): a ring
-* buffer plus a live `added` signal, so debug overlays and headless test
-* harnesses can tail game logs without scraping the browser console.
-*/
-declare class LogManager {
-  /** Fires once per entry, after it is buffered. */
-  readonly added: Signal<[LogEntry]>;
-  private readonly buffer;
-  private readonly capacity;
-  private seq;
-  constructor(capacity?: number);
-  debug(...parts: unknown[]): void;
-  info(...parts: unknown[]): void;
-  warn(...parts: unknown[]): void;
-  error(...parts: unknown[]): void;
-  /** Buffered entries, oldest first (capped at capacity). */
-  entries(): readonly LogEntry[];
-  /** Empty the buffer. The sequence keeps counting (entries stay unique). */
-  clear(): void;
-  private push;
-}
-//#endregion
 //#region src/core/scene/scene.d.ts
 /**
 * A loaded, live scene: the node tree plus everything needed to round-trip
@@ -733,6 +769,13 @@ interface EngineStats {
   nodes: number;
   /** Whether the loop is scheduled (start() without stop()/dispose()). */
   running: boolean;
+  /**
+  * Errors swallowed to keep the game alive since start: nodes that quarantined
+  * themselves plus frames that threw. Non-zero means something IS broken and
+  * `engine.log` says what — a green-looking game with `errors: 7` is the case
+  * this counter exists for.
+  */
+  errors: number;
 }
 /** GPU-side counters from `renderer.stats()` — the LAST rendered frame. */
 interface RendererStats {
@@ -838,6 +881,25 @@ declare class Engine {
   /** Replace the active scene. The previous scene's root is freed. */
   setScene(scene: Scene): void;
   start(): void;
+  /**
+  * A frame threw somewhere outside a single node (a renderer, physics, a
+  * signal handler). Report the first one and count the rest: a broken frame
+  * repeats sixty times a second, and sixty identical traces a second is how
+  * you lose the first one.
+  */
+  private reportFrameError;
+  /** @internal A node quarantined itself; count it for `stats().errors`. */
+  _nodeErrored(_node: unknown): void;
+  private errorCount;
+  private lastFrameError;
+  /**
+  * Every node with something quarantined — its own update, its script, or
+  * both — so a tool can list them and put them back. Walks on demand; there is
+  * no per-frame bookkeeping for this.
+  */
+  erroredNodes(): Node[];
+  /** Un-skip every quarantined node — the "try again" after you fix the code. */
+  resumeErroredNodes(): number;
   stop(): void;
   /**
   * Live performance counters, queryable at ANY time. fps/frameMs come from a
@@ -973,4 +1035,4 @@ declare function registeredBehaviors(): string[];
 /** Test isolation helper. */
 declare function clearBehaviors(): void;
 //#endregion
-export { Node as $, SfxPlayOptions as A, spatialPan as B, RendererStats as C, LogManager as D, LogLevel as E, ROLLOFF_MODELS as F, SynthOptions as G, SFX_PRESET_NAMES as H, RolloffModel as I, MusicManager as J, synthSfx as K, SpatialParams as L, Voice as M, VoicePreset as N, InputMap as O, Listener as P, BusName as Q, Vec3 as R, GameStats as S, LogEntry as T, SfxParams as U, SFX_PRESETS as V, SfxWave as W, PlayMusicOptions as X, MusicTrack as Y, AudioBuses as Z, registeredTypes as _, registerBehavior as a, Scheduler as b, PropDef as c, createNode as d, NodeLifecycle as et, getNodeSchema as f, registerNode as g, mergeStaticSignals as h, getBehavior as i, isAudioContextAvailable as j, SfxEngine as k, PropSchema as l, getNodeType as m, BehaviorCtor as n, SignalListener as nt, registeredBehaviors as o, getNodeSignals as p, MusicBackend as q, clearBehaviors as r, SceneTree as rt, NodeCtor as s, Behavior as t, Signal as tt, clearRegistry as u, Engine as v, Scene as w, EngineStats as x, EngineOptions as y, spatialGain as z };
+export { LogEntry as $, VoicePreset as A, SfxParams as B, RendererStats as C, SfxPlayOptions as D, SfxEngine as E, Vec3 as F, MusicManager as G, SynthOptions as H, spatialGain as I, AudioBuses as J, MusicTrack as K, spatialPan as L, ROLLOFF_MODELS as M, RolloffModel as N, isAudioContextAvailable as O, SpatialParams as P, SceneTree as Q, SFX_PRESETS as R, GameStats as S, InputMap as T, synthSfx as U, SfxWave as V, MusicBackend as W, Node as X, BusName as Y, NodeLifecycle as Z, registeredTypes as _, registerBehavior as a, Scheduler as b, PropDef as c, createNode as d, LogLevel as et, getNodeSchema as f, registerNode as g, mergeStaticSignals as h, getBehavior as i, Listener as j, Voice as k, PropSchema as l, getNodeType as m, BehaviorCtor as n, Signal as nt, registeredBehaviors as o, getNodeSignals as p, PlayMusicOptions as q, clearBehaviors as r, SignalListener as rt, NodeCtor as s, Behavior as t, LogManager as tt, clearRegistry as u, Engine as v, Scene as w, EngineStats as x, EngineOptions as y, SFX_PRESET_NAMES as z };

package/dist/{create-game-5z_QVtLx.js → create-game-bKHgHcsZ.js}

@@ -1,13 +1,13 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { _ as registerBehavior, n as loadScene, o as computeViewport, s as resolveViewport } from "./loader-BZqOKfI2.js";
-import { l as AudioPlayer, u as Engine } from "./register-BTg0EM7s.js";
+import { m as diagnose, n as loadScene, o as computeViewport, s as resolveViewport, y as registerBehavior } from "./loader-BlaRQGaA.js";
+import { l as AudioPlayer, u as Engine } from "./register-Dzkd6-os.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
-import { i as resolveRendering, n as attachTouchControls } from "./touch-031PxtCR.js";
+import { i as resolveRendering, n as attachTouchControls } from "./touch-BoNg_MnF.js";
 import { i as openBundledEditor, n as crossFade, r as devServerLibrary, t as teardown } from "./teardown-ByzfDPyu.js";
-import { n as registerGameplayBehaviors } from "./gameplay-Cfr6aFZ1.js";
-import { g as PhysicsBody2D, n as UILayer, t as registerNodes2D, u as Camera2D, y as Node2D } from "./register-DWcWq4QG.js";
+import { n as registerGameplayBehaviors } from "./gameplay-BftxM_It.js";
+import { g as PhysicsBody2D, n as UILayer, t as registerNodes2D, u as Camera2D, y as Node2D } from "./register-tkR_8tWg.js";
 import { t as debugSources } from "./debug-draw-BM3DsvtT.js";
-import { n as enablePhysics2D } from "./physics-2d-3kOQCtgd.js";
+import { n as enablePhysics2D } from "./physics-2d-D9wquBvK.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
 /**
@@ -17,9 +17,16 @@ import { Box3, BufferAttribute, BufferGeometry, Color, LineBasicMaterial, LineSe
 * `"$key"`. The texture loader is injectable so tests run headless.
 */
 var AssetStore2D = class {
+	engine;
 	entries = /* @__PURE__ */ new Map();
 	loader;
-	constructor(loader) {
+	/**
+	* `engine` is optional so a bare store still constructs in tests. Given one,
+	* a texture that fails to load lands in `engine.log` — where the overlay and
+	* `runScript()` can see it — instead of only in the browser console.
+	*/
+	constructor(loader, engine = null) {
+		this.engine = engine;
 		this.loader = loader ?? ((url, callbacks) => new TextureLoader().load(url, () => callbacks?.onLoad?.(), void 0, (err) => callbacks?.onError?.(err)));
 	}
 	/** Load (or extend with) a scene's `assets` declarations. Hard-validates each entry. */
@@ -43,7 +50,7 @@ var AssetStore2D = class {
 				},
 				onError: (err) => {
 					state.status = "error";
-					console.error(`[incanto] failed to load texture '${key}' (${decl.url}):`, err);
+					diagnose(this.engine, "error", `[incanto] failed to load texture '${key}' (${decl.url}):`, err);
 				}
 			});
 			if (previous && previous.texture !== texture) previous.texture.dispose();
@@ -251,6 +258,7 @@ var Renderer2D = class {
 	worldCam = new OrthographicCamera(-1, 1, 1, -1, -1e3, 1e3);
 	uiCam = new OrthographicCamera(-1, 1, 1, -1, -1e3, 1e3);
 	engine;
+	/** The texture store. Public so `renderer.assets.status(key)` is reachable. */
 	assets;
 	loadedAssetScenes = /* @__PURE__ */ new WeakSet();
 	disconnect;
@@ -258,10 +266,11 @@ var Renderer2D = class {
 	constructor(opts) {
 		this.canvas = opts.canvas;
 		this.engine = opts.engine;
-		this.assets = opts.assets ?? new AssetStore2D();
+		this.assets = opts.assets ?? new AssetStore2D(void 0, this.engine);
 		const rendering = resolveRendering(opts.engine.scene?.environment, {
 			antialias: true,
-			pixelRatio: 1
+			pixelRatio: 1,
+			preserveDrawingBuffer: false
 		}, globalThis.devicePixelRatio ?? 1, opts);
 		this.webgl = new WebGLRenderer({
 			canvas: opts.canvas,