incanto 0.29.0 → 0.31.0

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-CNKXGfpr.js → create-game-DqOjMBUS.js}

@@ -1,13 +1,13 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { _ as registerBehavior, n as loadScene } from "./loader-BZqOKfI2.js";
-import { l as AudioPlayer, u as Engine } from "./register-BTg0EM7s.js";
+import { m as diagnose, n as loadScene, 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 poseFromRenderer, n as devServerLibrary, r as openBundledEditor, t as crossFade } from "./editor-switch-CAKlJMIY.js";
-import { B as createCausticsQuad, F as PhysicsBody3D, R as Node3D, n as registerGameplayBehaviors } from "./gameplay-L05WgWd1.js";
-import { t as debugSources } from "./debug-draw-CZmOYjL2.js";
-import { T as Camera3D, _ as DirectionalLight3D, h as ModelInstance3D, t as registerNodes3D } from "./register-C44aSduO.js";
-import { n as enablePhysics3D } from "./physics-3d-BZZLtwJu.js";
+import { a as poseFromRenderer, i as openBundledEditor, n as crossFade, r as devServerLibrary, t as teardown } from "./teardown-ByzfDPyu.js";
+import { B as createCausticsQuad, F as PhysicsBody3D, R as Node3D, n as registerGameplayBehaviors } from "./gameplay-BftxM_It.js";
+import { t as debugSources } from "./debug-draw-BM3DsvtT.js";
+import { E as Camera3D, g as ModelInstance3D, n as registerNodes3D, t as resolveEnvironmentHdri, v as DirectionalLight3D } from "./environment-presets--DigHNg4.js";
+import { n as enablePhysics3D } from "./physics-3d-CnPygVGo.js";
 import { ACESFilmicToneMapping, AmbientLight, Box3, BufferAttribute, BufferGeometry, Color, DepthTexture, EquirectangularReflectionMapping, FloatType, Fog, HalfFloatType, LineBasicMaterial, LineSegments, Matrix4, Mesh, PCFShadowMap, PMREMGenerator, PerspectiveCamera, PlaneGeometry, Quaternion, Raycaster, Scene, ShaderMaterial, Vector2, Vector3, WebGLRenderTarget, WebGLRenderer } from "three";
 import { VRMLoaderPlugin, VRMUtils } from "@pixiv/three-vrm";
 import { GLTFLoader } from "three/addons/loaders/GLTFLoader.js";
@@ -25,15 +25,47 @@ import { Sky } from "three/examples/jsm/objects/Sky.js";
 * @pixiv/three-vrm (VRM 0.x facing fixed via rotateVRM0).
 */
 var AssetStore3D = class {
+	engine;
 	models = /* @__PURE__ */ new Map();
 	animations = /* @__PURE__ */ new Map();
 	modelKeys = /* @__PURE__ */ new Map();
 	animationKeys = /* @__PURE__ */ new Map();
 	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 = null) {
+		this.engine = engine;
 		this.loader = new GLTFLoader();
 		this.loader.register((parser) => new VRMLoaderPlugin(parser));
 	}
+	/**
+	* Every asset that failed, with the reason — the answer to "why is my model
+	* not there". Empty is the healthy case.
+	*/
+	errors() {
+		const out = [];
+		for (const [ref, url] of this.modelKeys) {
+			const entry = this.models.get(url);
+			if (entry?.error) out.push({
+				ref,
+				url,
+				error: String(entry.error)
+			});
+		}
+		for (const [ref, decl] of this.animationKeys) {
+			const entry = this.animations.get(decl.url);
+			if (entry?.error) out.push({
+				ref,
+				url: decl.url,
+				error: String(entry.error)
+			});
+		}
+		return out;
+	}
 	/** Map a scene's `assets` header. */
 	load(assets) {
 		for (const [key, def] of Object.entries(assets)) {
@@ -83,7 +115,7 @@ var AssetStore3D = class {
 		}, void 0, (error) => {
 			entry.status = "error";
 			entry.error = error instanceof Error ? error.message : String(error);
-			console.error(`incanto: failed to load model '${url}':`, error);
+			diagnose(this.engine, "error", `incanto: failed to load model '${url}':`, error);
 		});
 		return entry;
 	}
@@ -103,11 +135,11 @@ var AssetStore3D = class {
 			entry.clips = gltf.animations ?? [];
 			entry.scene = gltf.scene;
 			entry.status = "ready";
-			if (entry.clips.length === 0) console.warn(`incanto: animation asset '${def.url}' contains no clips`);
+			if (entry.clips.length === 0) diagnose(this.engine, "warn", `incanto: animation asset '${def.url}' contains no clips`);
 		}, void 0, (error) => {
 			entry.status = "error";
 			entry.error = error instanceof Error ? error.message : String(error);
-			console.error(`incanto: failed to load animation '${def.url}':`, error);
+			diagnose(this.engine, "error", `incanto: failed to load animation '${def.url}':`, error);
 		});
 		return entry;
 	}
@@ -884,37 +916,6 @@ function lerp(a, b, t) {
 	return a + (b - a) * t;
 }
 //#endregion
-//#region src/3d/environment-presets.ts
-/**
-* drei-compatible environment presets: each name maps to a 1k HDRI (the exact
-* Poly Haven CC0 files @react-three/drei ships), so `preset="sunset"` lights the
-* same here. Served from the agent8 CDN (the only sanctioned external host, same
-* as the terrain splat) — set `environment.hdri` to override with your own URL.
-*/
-const CDN = "https://agent8-games.verse8.io/assets/3D/default/textures/hdri";
-const ENVIRONMENT_PRESETS = {
-	apartment: "lebombo_1k.hdr",
-	city: "potsdamer_platz_1k.hdr",
-	dawn: "kiara_1_dawn_1k.hdr",
-	forest: "forest_slope_1k.hdr",
-	lobby: "st_fagans_interior_1k.hdr",
-	night: "dikhololo_night_1k.hdr",
-	park: "rooitou_park_1k.hdr",
-	studio: "studio_small_03_1k.hdr",
-	sunset: "venice_sunset_1k.hdr",
-	warehouse: "empty_warehouse_01_1k.hdr"
-};
-/** Resolve `environment.preset` / `environment.hdri` to the HDR url (or null). */
-function resolveEnvironmentHdri(env) {
-	if (typeof env.hdri === "string" && env.hdri !== "") return env.hdri;
-	if (typeof env.preset === "string") {
-		const file = ENVIRONMENT_PRESETS[env.preset];
-		if (!file) throw new Error(`Unknown environment preset '${env.preset}'. Available: ${Object.keys(ENVIRONMENT_PRESETS).join(", ")}.`);
-		return `${CDN}/${file}`;
-	}
-	return null;
-}
-//#endregion
 //#region src/3d/environment-3d.ts
 /** Shadow ortho half-extent when the env header forces a light to cast and the
 * light node configured nothing itself. One static box around the origin — no
@@ -1499,6 +1500,11 @@ var Renderer3D = class {
 	engine;
 	disconnect;
 	canvas;
+	/**
+	* 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.
+	*/
 	assets;
 	ownsAssets;
 	loadedAssetScenes = /* @__PURE__ */ new WeakSet();
@@ -1545,7 +1551,7 @@ var Renderer3D = class {
 		this.canvas = opts.canvas;
 		this.engine = opts.engine;
 		this.ownsAssets = !opts.assets;
-		this.assets = opts.assets ?? new AssetStore3D();
+		this.assets = opts.assets ?? new AssetStore3D(this.engine);
 		const rendering = resolveRendering(opts.engine.scene?.environment, {
 			antialias: true,
 			pixelRatio: Math.min(globalThis.devicePixelRatio ?? 1, 2)
@@ -1601,7 +1607,7 @@ var Renderer3D = class {
 	}
 	syncDebugLines() {
 		let vertices = null;
-		for (const source of debugSources("3d")) {
+		for (const source of debugSources("3d", this.engine)) {
 			vertices = source.debugLines();
 			if (vertices) break;
 		}
@@ -2250,10 +2256,14 @@ async function createGame3D(opts) {
 	} catch {}
 	await report(1, "ready");
 	function disposeGame() {
-		renderer.dispose();
-		physics?.dispose();
-		for (const cleanup of cleanups) cleanup();
-		engine.dispose();
+		teardown([
+			physics ? ["physics", () => physics?.dispose()] : null,
+			["app cleanups", () => {
+				for (const cleanup of cleanups) cleanup();
+			}],
+			["engine", () => engine.dispose()],
+			["renderer", () => renderer.dispose()]
+		]);
 	}
 	return {
 		engine,
@@ -2261,6 +2271,9 @@ async function createGame3D(opts) {
 		sourceJson,
 		renderer,
 		physics,
+		assetErrors() {
+			return renderer.assets?.errors() ?? [];
+		},
 		stats() {
 			return {
 				triangles: 0,

package/dist/{create-game-CbuLWorm.js → create-game-z5XaB1p5.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 { n as devServerLibrary, r as openBundledEditor, t as crossFade } from "./editor-switch-CAKlJMIY.js";
-import { n as registerGameplayBehaviors } from "./gameplay-L05WgWd1.js";
-import { g as PhysicsBody2D, n as UILayer, t as registerNodes2D, u as Camera2D, y as Node2D } from "./register-DWcWq4QG.js";
-import { t as debugSources } from "./debug-draw-CZmOYjL2.js";
-import { n as enablePhysics2D } from "./physics-2d-CCVTrKOd.js";
+import { i as openBundledEditor, n as crossFade, r as devServerLibrary, t as teardown } from "./teardown-ByzfDPyu.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-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,7 +266,7 @@ 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
@@ -310,7 +318,7 @@ var Renderer2D = class {
 	}
 	syncDebugLines() {
 		let vertices = null;
-		for (const source of debugSources("2d")) {
+		for (const source of debugSources("2d", this.engine)) {
 			vertices = source.debugLines();
 			if (vertices) break;
 		}
@@ -603,10 +611,14 @@ async function createGame2D(opts) {
 	}
 	engine.start();
 	function disposeGame() {
-		renderer.dispose();
-		physics?.dispose();
-		for (const cleanup of cleanups) cleanup();
-		engine.dispose();
+		teardown([
+			physics ? ["physics", () => physics?.dispose()] : null,
+			["app cleanups", () => {
+				for (const cleanup of cleanups) cleanup();
+			}],
+			["engine", () => engine.dispose()],
+			["renderer", () => renderer.dispose()]
+		]);
 	}
 	return {
 		engine,

package/dist/debug-draw-BM3DsvtT.js

@@ -0,0 +1,18 @@
+//#region src/core/debug-draw.ts
+const sources = /* @__PURE__ */ new Set();
+/** @internal physics runtimes self-register on enable. */
+function registerDebugSource(source) {
+	sources.add(source);
+	return () => sources.delete(source);
+}
+/**
+* @internal renderers pull their OWN engine's sources for their dimension.
+*
+* `engine` is optional only so a caller with nothing to scope by still works;
+* every renderer passes one, and should.
+*/
+function debugSources(dimension, engine) {
+	return [...sources].filter((s) => s.dimension === dimension && (engine === void 0 || s.engine === engine));
+}
+//#endregion
+export { registerDebugSource as n, debugSources as t };

package/dist/debug.d.ts

@@ -1,4 +1,4 @@
-import { C as RendererStats, E as LogLevel, v as Engine } from "./behavior-BAc0erXF.js";
+import { C as RendererStats, et as LogLevel, v as Engine } from "./behavior-D_jMpFh8.js";
 
 //#region src/debug/panel.d.ts
 /** Minimal document surface the overlay needs (injectable for tests). */

package/dist/debug.js

@@ -1,6 +1,6 @@
 import { t as jsonClone } from "./json-BLk7H2Qa.js";
-import { s as mergeStaticProps } from "./registry-BVJ2HbCn.js";
-import { t as debugSources } from "./debug-draw-CZmOYjL2.js";
+import { s as mergeStaticProps } from "./registry-CJdGpT2V.js";
+import { t as debugSources } from "./debug-draw-BM3DsvtT.js";
 //#region src/debug/panel.ts
 /** Keep a panel rect on screen and above the minimum usable size. */
 function clampPanelRect(x, y, w, h, viewW, viewH, minW = 180, minH = 120) {
@@ -913,8 +913,13 @@ function compactCount(n) {
 }
 function stringify(part) {
 	if (typeof part === "string") return part;
+	if (part instanceof Error) {
+		const first = part.stack?.split("\n")[1]?.trim();
+		return `${part.name}: ${part.message}${first ? ` (${first})` : ""}`;
+	}
 	try {
-		return JSON.stringify(part);
+		const text = JSON.stringify(part);
+		return text === "{}" || text === void 0 ? String(part) : text;
 	} catch {
 		return String(part);
 	}

package/dist/{duplicate-BgtFrFo4.js → duplicate-KRPtUtzl.js}

@@ -1,4 +1,4 @@
-import { i as serializeNode, t as buildNodeJson } from "./loader-BZqOKfI2.js";
+import { i as serializeNode, t as buildNodeJson } from "./loader-BlaRQGaA.js";
 //#region src/core/order-groups.ts
 const ORDER_GROUP_BASE = {
 	background: -2e3,

package/dist/{editor-switch-B0wB_DSr.d.ts → editor-switch-BJb-CWfA.d.ts}

@@ -1,5 +1,16 @@
 import { s as JsonObject } from "./schema-CcoWb32N.js";
 
+//#region src/core/diagnostics.d.ts
+/** The minimum an engine has to look like to receive a diagnostic. */
+interface DiagnosticSink {
+  log: {
+    warn(...parts: unknown[]): void;
+    error(...parts: unknown[]): void;
+    info(...parts: unknown[]): void;
+    debug(...parts: unknown[]): void;
+  };
+}
+//#endregion
 //#region src/core/editor-switch.d.ts
 /** Where a camera is and what it looks at, in world space. */
 interface CameraPose {
@@ -56,4 +67,4 @@ type LibrarySearch = (query: {
   total?: number;
 }>;
 //#endregion
-export { EditorSwitchOptions as t };
+export { DiagnosticSink as n, EditorSwitchOptions as t };