incanto 0.30.0 → 0.32.0

package/dist/{create-game-DuBTv2zI.js → create-game-gXI7PYl0.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 resolveRendering, n as attachTouchControls } from "./touch-BoNg_MnF.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-Cfr6aFZ1.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 { T as Camera3D, _ as DirectionalLight3D, h as ModelInstance3D, t as registerNodes3D } from "./register-DJ0SByQg.js";
-import { n as enablePhysics3D } from "./physics-3d-CeRH-Ff_.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,14 +1551,19 @@ 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)
-		}, globalThis.devicePixelRatio ?? 1, { pixelRatio: opts.pixelRatio });
+			pixelRatio: Math.min(globalThis.devicePixelRatio ?? 1, 2),
+			preserveDrawingBuffer: false
+		}, globalThis.devicePixelRatio ?? 1, {
+			pixelRatio: opts.pixelRatio,
+			preserveDrawingBuffer: opts.preserveDrawingBuffer
+		});
 		this.webgl = new WebGLRenderer({
 			canvas: opts.canvas,
-			antialias: rendering.antialias
+			antialias: rendering.antialias,
+			preserveDrawingBuffer: rendering.preserveDrawingBuffer
 		});
 		this.webgl.info.autoReset = false;
 		this.basePixelRatio = rendering.pixelRatio;
@@ -2188,7 +2199,8 @@ async function createGame3D(opts) {
 		canvas: opts.canvas,
 		engine,
 		...opts.pixelRatio !== void 0 ? { pixelRatio: opts.pixelRatio } : {},
-		...opts.adaptiveResolution !== void 0 ? { adaptiveResolution: opts.adaptiveResolution } : {}
+		...opts.adaptiveResolution !== void 0 ? { adaptiveResolution: opts.adaptiveResolution } : {},
+		...opts.preserveDrawingBuffer !== void 0 ? { preserveDrawingBuffer: opts.preserveDrawingBuffer } : {}
 	});
 	await report(.14, "renderer");
 	const wantDebug = opts.debug ?? false;
@@ -2265,6 +2277,9 @@ async function createGame3D(opts) {
 		sourceJson,
 		renderer,
 		physics,
+		assetErrors() {
+			return renderer.assets?.errors() ?? [];
+		},
 		stats() {
 			return {
 				triangles: 0,

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,5 +1,5 @@
 import { t as jsonClone } from "./json-BLk7H2Qa.js";
-import { s as mergeStaticProps } from "./registry-BVJ2HbCn.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. */
@@ -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 };

package/dist/{register-DJ0SByQg.js → environment-presets--DigHNg4.js}

@@ -1,10 +1,10 @@
-import { t as registerCoreNodes } from "./register-BTg0EM7s.js";
+import { t as registerCoreNodes } from "./register-Dzkd6-os.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as Rng } from "./rng-DP-SR7eg.js";
-import { i as getNodeSchema, l as registerNode } from "./registry-BVJ2HbCn.js";
+import { i as getNodeSchema, l as registerNode } from "./registry-CJdGpT2V.js";
 import { t as createNoise2D } from "./noise-CGUMx44x.js";
 import { i as applyParticlePreset, r as PARTICLE_PRESET_NAMES, t as ParticleSim } from "./particle-sim-Bw7hB93B.js";
-import { A as Water3D, F as PhysicsBody3D, H as colliderFootDrop, I as RigidBody3D, L as StaticBody3D, M as WaterCutout3D, N as Area3D, P as CharacterBody3D, R as Node3D } from "./gameplay-Cfr6aFZ1.js";
+import { A as Water3D, F as PhysicsBody3D, H as colliderFootDrop, I as RigidBody3D, L as StaticBody3D, M as WaterCutout3D, N as Area3D, P as CharacterBody3D, R as Node3D } from "./gameplay-BftxM_It.js";
 import { n as splatWeights, t as buildHeightmap } from "./heightmap-CRK0M4jT.js";
 import { AdditiveBlending, AnimationClip, AnimationMixer, Box3, BoxGeometry, BufferAttribute, BufferGeometry, CanvasTexture, CapsuleGeometry, Color, ConeGeometry, CylinderGeometry, DataTexture, DirectionalLight, DoubleSide, DynamicDrawUsage, Euler, Group, IcosahedronGeometry, ImageBitmapLoader, InstancedBufferAttribute, InstancedMesh, LinearFilter, LoopOnce, LoopRepeat, Matrix4, Mesh, MeshBasicMaterial, MeshDepthMaterial, MeshPhysicalMaterial, MeshStandardMaterial, NearestFilter, NoBlending, NormalBlending, PerspectiveCamera, PlaneGeometry, PointLight, Points, PointsMaterial, Quaternion, QuaternionKeyframeTrack, RGBADepthPacking, RGBAFormat, RepeatWrapping, SRGBColorSpace, ShaderChunk, ShaderMaterial, SphereGeometry, Texture, TextureLoader, UniformsLib, UniformsUtils, Vector3, Vector4, VectorKeyframeTrack } from "three";
 import { clone } from "three/addons/utils/SkeletonUtils.js";
@@ -6068,7 +6068,7 @@ var ModelInstance3D = class extends Node3D {
 				if (entry.claimedBy && entry.claimedBy !== this) {
 					if (!this.warnedClaim) {
 						this.warnedClaim = true;
-						console.warn(`incanto: VRM '${this.model}' is already displayed by another node — a VRM asset can back only one ModelInstance3D.`);
+						this.diagnose("warn", `incanto: VRM '${this.model}' is already displayed by another node — a VRM asset can back only one ModelInstance3D.`);
 					}
 					return;
 				}
@@ -6119,7 +6119,7 @@ var ModelInstance3D = class extends Node3D {
 				const scale = size.y > 0 ? this.targetHeight / size.y : prev;
 				if (scale < .05 || scale > 20) {
 					this.fitGroup.scale.setScalar(1);
-					console.warn(`[incanto] ModelInstance3D '${this.name}': targetHeight fit measured an implausible scale (${scale.toFixed(2)}x) — skinned rigs defeat bounding-box measurement. Rendering at the model's authored scale instead.`);
+					this.diagnose("warn", `[incanto] ModelInstance3D '${this.name}': targetHeight fit measured an implausible scale (${scale.toFixed(2)}x) — skinned rigs defeat bounding-box measurement. Rendering at the model's authored scale instead.`);
 				} else this.fitGroup.scale.setScalar(scale);
 			} else this.fitGroup.scale.setScalar(1);
 		}
@@ -6193,7 +6193,7 @@ var ModelInstance3D = class extends Node3D {
 			const cached = this.entry.retargeted.get(ref);
 			if (cached) return cached;
 			const result = retargetClipToVrm(source, anim.scene, this.entry.vrm);
-			if (result.skippedBones.length > 0) console.warn(`incanto: retarget '${ref}' skipped bones: ${result.skippedBones.join(", ")}`);
+			if (result.skippedBones.length > 0) this.diagnose("warn", `incanto: retarget '${ref}' skipped bones: ${result.skippedBones.join(", ")}`);
 			this.entry.retargeted.set(ref, result.clip);
 			return result.clip;
 		}
@@ -6258,7 +6258,7 @@ var ModelInstance3D = class extends Node3D {
 				action.crossFadeFrom(this.currentAction, ANIM_CROSSFADE, warp);
 			}
 			this.currentAction = action;
-		} else console.warn(`incanto: model '${this.model}' has no animation '${this.animation}' — embedded: ${this.entry.animations.map((c) => c.name).join(", ") || "(none)"}; assets: ${assets.animationRefs().join(", ") || "(none)"}`);
+		} else this.diagnose("warn", `incanto: model '${this.model}' has no animation '${this.animation}' — embedded: ${this.entry.animations.map((c) => c.name).join(", ") || "(none)"}; assets: ${assets.animationRefs().join(", ") || "(none)"}`);
 	}
 	/** The upper-body layer: masked clip on the `upperBodyRoot` subtree. */
 	syncUpperAnimation(assets) {
@@ -6272,13 +6272,13 @@ var ModelInstance3D = class extends Node3D {
 		const resolved = this.resolveClip(this.animationUpper, assets);
 		if (resolved === "loading") return;
 		if (!resolved) {
-			console.warn(`incanto: model '${this.model}' has no animation '${this.animationUpper}' for the upper layer.`);
+			this.diagnose("warn", `incanto: model '${this.model}' has no animation '${this.animationUpper}' for the upper layer.`);
 			this.playingUpper = this.animationUpper;
 			return;
 		}
 		const variants = this.layerVariants(resolved);
 		if (!variants) {
-			console.warn(`incanto: upperBodyRoot '${this.upperBodyRoot}' not found in '${this.model}' — upper layer skipped.`);
+			this.diagnose("warn", `incanto: upperBodyRoot '${this.upperBodyRoot}' not found in '${this.model}' — upper layer skipped.`);
 			this.playingUpper = this.animationUpper;
 			return;
 		}
@@ -8306,7 +8306,7 @@ var River3D = class River3D extends Node3D {
 		if (gaps.length * 3 < this.rings.length) return;
 		this.warnedCoverage = true;
 		const worst = gaps.reduce((a, b) => b.wettedHalfWidth - b.carriedHalfWidth > a.wettedHalfWidth - a.carriedHalfWidth ? b : a);
-		console.warn(`[incanto] River3D '${this.name}': the course is too tight for the water it holds — ${gaps.length} of ${this.rings.length} stations leave bare channel beside the ribbon (worst at ${worst.along.toFixed(0)} m: ground wet to ${worst.wettedHalfWidth.toFixed(1)} m from the centre, a bend that can only carry ${worst.carriedHalfWidth.toFixed(1)} m). Fix by EASING THE BENDS in \`path\` (fewer, straighter points), NARROWING \`widths\` there, or placing standing water (a Water3D) if that reach is really a pool.`);
+		this.diagnose("warn", `[incanto] River3D '${this.name}': the course is too tight for the water it holds — ${gaps.length} of ${this.rings.length} stations leave bare channel beside the ribbon (worst at ${worst.along.toFixed(0)} m: ground wet to ${worst.wettedHalfWidth.toFixed(1)} m from the centre, a bend that can only carry ${worst.carriedHalfWidth.toFixed(1)} m). Fix by EASING THE BENDS in \`path\` (fewer, straighter points), NARROWING \`widths\` there, or placing standing water (a Water3D) if that reach is really a pool.`);
 	}
 	warnedCoverage = false;
 	rebuildIfNeeded(mesh) {
@@ -11878,4 +11878,35 @@ function registerNodes3D() {
 	registerNode(CharacterBody3D);
 }
 //#endregion
-export { DEFAULT_TERRAIN_TEXTURE_BASE as A, movementState as B, FLOWER_VARIETIES as C, BoneAttachment3D as D, BoneLookAt3D as E, MeshInstance3D as F, buildMeshGeometry as I, QUARTER_PITCH as L, terrainThemeLayers as M, Joint3D as N, Billboard3D as O, InstancedMesh3D as P, cameraRelative as R, resolveFlowerDensity as S, Camera3D as T, rigPose as V, DirectionalLight3D as _, Trail3D as a, DENSITY_PRESETS as b, findRiverCoverageGaps as c, riverStepFor as d, smoothCourse as f, LoftMesh3D as g, ModelInstance3D as h, Tree3D as i, TERRAIN_THEMES as j, Terrain3D as k, projectToRiver as l, Particles3D as m, VOXEL_PALETTE as n, River3D as o, traceDownhillPath as p, VoxelGrid3D as r, buildRiverRings as s, registerNodes3D as t, riverCarveChannels as u, OmniLight3D as v, CharacterController3D as w, Flowers3D as x, Foliage3D as y, keyboardIntensity as z };
+//#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
+export { Terrain3D as A, keyboardIntensity as B, resolveFlowerDensity as C, BoneLookAt3D as D, Camera3D as E, InstancedMesh3D as F, rigPose as H, MeshInstance3D as I, buildMeshGeometry as L, TERRAIN_THEMES as M, terrainThemeLayers as N, BoneAttachment3D as O, Joint3D as P, QUARTER_PITCH as R, Flowers3D as S, CharacterController3D as T, movementState as V, LoftMesh3D as _, Tree3D as a, Foliage3D as b, buildRiverRings as c, riverCarveChannels as d, riverStepFor as f, ModelInstance3D as g, Particles3D as h, VoxelGrid3D as i, DEFAULT_TERRAIN_TEXTURE_BASE as j, Billboard3D as k, findRiverCoverageGaps as l, traceDownhillPath as m, registerNodes3D as n, Trail3D as o, smoothCourse as p, VOXEL_PALETTE as r, River3D as s, resolveEnvironmentHdri as t, projectToRiver as u, DirectionalLight3D as v, FLOWER_VARIETIES as w, DENSITY_PRESETS as x, OmniLight3D as y, cameraRelative as z };

package/dist/{gameplay-Cfr6aFZ1.js → gameplay-BftxM_It.js}

@@ -1,7 +1,7 @@
-import { _ as registerBehavior, f as Node, m as Behavior, n as loadScene } from "./loader-BZqOKfI2.js";
+import { f as Node, g as Behavior, n as loadScene, y as registerBehavior } from "./loader-BlaRQGaA.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as jsonClone } from "./json-BLk7H2Qa.js";
-import { r as effectiveOrder, t as duplicateNode } from "./duplicate-BgtFrFo4.js";
+import { r as effectiveOrder, t as duplicateNode } from "./duplicate-KRPtUtzl.js";
 import { Color, CubeCamera, DepthTexture, DoubleSide, Euler, FloatType, Frustum, HalfFloatType, LinearMipmapLinearFilter, MathUtils, Matrix4, Mesh, MeshDepthMaterial, Object3D, PerspectiveCamera, Plane, PlaneGeometry, Quaternion, ShaderMaterial, Sphere, Vector2, Vector3, Vector4, WebGLCubeRenderTarget, WebGLRenderTarget } from "three";
 //#region src/3d/frustum.ts
 const scratchFrustum = new Frustum();

package/dist/gameplay.d.ts

@@ -1,5 +1,5 @@
+import { X as Node, l as PropSchema, n as BehaviorCtor, t as Behavior, v as Engine } from "./behavior-D_jMpFh8.js";
 import { c as JsonValue, s as JsonObject } from "./schema-CcoWb32N.js";
-import { $ as Node, l as PropSchema, n as BehaviorCtor, t as Behavior, v as Engine } from "./behavior-BAc0erXF.js";
 
 //#region src/gameplay/chase.d.ts
 /**

package/dist/gameplay.js

@@ -1,2 +1,2 @@
-import { C as FollowCamera, D as Health, E as DamageOnContact, O as Collector, S as restartScene, T as phaseOf, _ as hitStop, a as Wander, b as GameFlow, c as Projectile, d as PathFollow, f as Oscillate, g as Cooldown, h as CameraShake, i as WaveSpawner, k as Chase, l as Pickup, m as Lifetime, n as registerGameplayBehaviors, o as Spawner, p as MoveTo, r as ZombieAI, s as ScoreKeeper, t as GAMEPLAY_BEHAVIORS, u as Patrol, v as screenFlash, w as DayNight, x as goToScene, y as Interactable } from "./gameplay-Cfr6aFZ1.js";
+import { C as FollowCamera, D as Health, E as DamageOnContact, O as Collector, S as restartScene, T as phaseOf, _ as hitStop, a as Wander, b as GameFlow, c as Projectile, d as PathFollow, f as Oscillate, g as Cooldown, h as CameraShake, i as WaveSpawner, k as Chase, l as Pickup, m as Lifetime, n as registerGameplayBehaviors, o as Spawner, p as MoveTo, r as ZombieAI, s as ScoreKeeper, t as GAMEPLAY_BEHAVIORS, u as Patrol, v as screenFlash, w as DayNight, x as goToScene, y as Interactable } from "./gameplay-BftxM_It.js";
 export { CameraShake, Chase, Collector, Cooldown, DamageOnContact, DayNight, FollowCamera, GAMEPLAY_BEHAVIORS, GameFlow, Health, Interactable, Lifetime, MoveTo, Oscillate, PathFollow, Patrol, Pickup, Projectile, ScoreKeeper, Spawner, Wander, WaveSpawner, ZombieAI, goToScene, hitStop, phaseOf, registerGameplayBehaviors, restartScene, screenFlash };

package/dist/index.d.ts

@@ -1,8 +1,8 @@
+import { $ as LogEntry, A as VoicePreset, B as SfxParams, C as RendererStats, D as SfxPlayOptions, E as SfxEngine, F as Vec3, G as MusicManager, H as SynthOptions, I as spatialGain, J as AudioBuses, K as MusicTrack, L as spatialPan, M as ROLLOFF_MODELS, N as RolloffModel, O as isAudioContextAvailable, P as SpatialParams, Q as SceneTree, R as SFX_PRESETS, S as GameStats, T as InputMap, U as synthSfx, V as SfxWave, W as MusicBackend, X as Node, Y as BusName, Z as NodeLifecycle, _ as registeredTypes, a as registerBehavior, b as Scheduler, c as PropDef, d as createNode, et as LogLevel, f as getNodeSchema, g as registerNode, h as mergeStaticSignals, i as getBehavior, j as Listener, k as Voice, l as PropSchema, m as getNodeType, n as BehaviorCtor, nt as Signal, o as registeredBehaviors, p as getNodeSignals, q as PlayMusicOptions, r as clearBehaviors, rt as SignalListener, s as NodeCtor, t as Behavior, tt as LogManager, u as clearRegistry, v as Engine, w as Scene, x as EngineStats, y as EngineOptions, z as SFX_PRESET_NAMES } from "./behavior-D_jMpFh8.js";
 import { a as Rng, c as JsonValue, d as jsonKind, i as SceneJson, l as jsonClone, n as NodeJson, o as JsonKind, r as SCENE_FORMAT, s as JsonObject, t as ConnectionJson, u as jsonEquals } from "./schema-CcoWb32N.js";
-import { $ as Node, A as SfxPlayOptions, B as spatialPan, C as RendererStats, D as LogManager, E as LogLevel, F as ROLLOFF_MODELS, G as SynthOptions, H as SFX_PRESET_NAMES, I as RolloffModel, J as MusicManager, K as synthSfx, L as SpatialParams, M as Voice, N as VoicePreset, O as InputMap, P as Listener, Q as BusName, R as Vec3, S as GameStats, T as LogEntry, U as SfxParams, V as SFX_PRESETS, W as SfxWave, X as PlayMusicOptions, Y as MusicTrack, Z as AudioBuses, _ as registeredTypes, a as registerBehavior, b as Scheduler, c as PropDef, d as createNode, et as NodeLifecycle, f as getNodeSchema, g as registerNode, h as mergeStaticSignals, i as getBehavior, j as isAudioContextAvailable, k as SfxEngine, l as PropSchema, m as getNodeType, n as BehaviorCtor, nt as SignalListener, o as registeredBehaviors, p as getNodeSignals, q as MusicBackend, r as clearBehaviors, rt as SceneTree, s as NodeCtor, t as Behavior, tt as Signal, u as clearRegistry, v as Engine, w as Scene, x as EngineStats, y as EngineOptions, z as spatialGain } from "./behavior-BAc0erXF.js";
-import { n as loadScene, t as LoadSceneOptions } from "./loader-B242FF6N.js";
+import { n as loadScene, t as LoadSceneOptions } from "./loader-BYBrqTxP.js";
 import { n as ParticleSimConfig, r as ParticleView, t as ParticleSim } from "./particle-sim-CwJ5rI_P.js";
-import { a as AudioElementLike, i as gridFromRows, n as PathGrid, o as AudioPlayer, r as findPath, t as FindPathOptions } from "./pathfinding-BwD974Ss.js";
+import { a as AudioElementLike, i as gridFromRows, n as PathGrid, o as AudioPlayer, r as findPath, t as FindPathOptions } from "./pathfinding-BwhqPD3i.js";
 import { i as auditScene, n as IncantoErrorCode, r as IncantoErrorDetails, t as IncantoError } from "./errors-1dXlIwoR.js";
 
 //#region src/core/audio/crossfade.d.ts
@@ -401,10 +401,20 @@ declare function registerCoreNodes(): void;
 interface ResolvedRendering {
   antialias: boolean;
   pixelRatio: number;
+  /**
+  * Keep the drawing buffer readable after a frame (default false).
+  *
+  * WebGL clears it as soon as the frame is composited, so `canvas.toDataURL()`
+  * — and therefore ANY screenshot a driver takes — comes back blank. Turning
+  * this on costs a buffer copy per frame, which is why it is off for games and
+  * on for the run where something is trying to LOOK at the output.
+  */
+  preserveDrawingBuffer: boolean;
 }
 declare function resolveRendering(environment: JsonObject | undefined, fallback: ResolvedRendering, devicePixelRatio: number, explicit?: {
   antialias?: boolean;
   pixelRatio?: number;
+  preserveDrawingBuffer?: boolean;
 }): ResolvedRendering;
 //#endregion
 //#region src/core/replay.d.ts

package/dist/index.js

@@ -1,14 +1,14 @@
-import { _ as registerBehavior, a as SCENE_FORMAT, c as SceneTree, d as resolveConstants, f as Node, g as getBehavior, h as clearBehaviors, i as serializeNode, l as CONST_REF_KEY, m as Behavior, n as loadScene, o as computeViewport, p as parseNodePath, r as Scene, s as resolveViewport, u as isConstRef, v as registeredBehaviors, y as Signal } from "./loader-BZqOKfI2.js";
-import { C as crossfadeGains, S as WebAudioMusicBackend, T as AudioBuses, _ as spatialPan, a as HudLayer, b as synthSfx, c as UiText, d as LogManager, f as InputMap, g as spatialGain, h as ROLLOFF_MODELS, i as UiDialogue, l as AudioPlayer, m as isAudioContextAvailable, n as Timer, o as UiBanner, p as SfxEngine, r as UiButton, s as UiBar, t as registerCoreNodes, u as Engine, v as SFX_PRESETS, w as fadeGain, x as MusicManager, y as SFX_PRESET_NAMES } from "./register-BTg0EM7s.js";
+import { _ as clearBehaviors, a as SCENE_FORMAT, b as registeredBehaviors, c as SceneTree, d as resolveConstants, f as Node, g as Behavior, h as InputMap, i as serializeNode, l as CONST_REF_KEY, n as loadScene, o as computeViewport, p as parseNodePath, r as Scene, s as resolveViewport, u as isConstRef, v as getBehavior, x as Signal, y as registerBehavior } from "./loader-BlaRQGaA.js";
+import { C as fadeGain, S as crossfadeGains, _ as SFX_PRESETS, a as HudLayer, b as MusicManager, c as UiText, d as LogManager, f as SfxEngine, g as spatialPan, h as spatialGain, i as UiDialogue, l as AudioPlayer, m as ROLLOFF_MODELS, n as Timer, o as UiBanner, p as isAudioContextAvailable, r as UiButton, s as UiBar, t as registerCoreNodes, u as Engine, v as SFX_PRESET_NAMES, w as AudioBuses, x as WebAudioMusicBackend, y as synthSfx } from "./register-Dzkd6-os.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as Rng } from "./rng-DP-SR7eg.js";
-import { t as auditScene } from "./audit-C6rMyict.js";
+import { t as auditScene } from "./audit-C4kmDK0o.js";
 import { n as jsonEquals, r as jsonKind, t as jsonClone } from "./json-BLk7H2Qa.js";
-import { a as getNodeSignals, c as mergeStaticSignals, i as getNodeSchema, l as registerNode, n as clearRegistry, o as getNodeType, r as createNode, u as registeredTypes } from "./registry-BVJ2HbCn.js";
+import { a as getNodeSignals, c as mergeStaticSignals, i as getNodeSchema, l as registerNode, n as clearRegistry, o as getNodeType, r as createNode, u as registeredTypes } from "./registry-CJdGpT2V.js";
 import { t as createNoise2D } from "./noise-CGUMx44x.js";
-import { n as ORDER_GROUP_BASE, r as effectiveOrder, t as duplicateNode } from "./duplicate-BgtFrFo4.js";
+import { n as ORDER_GROUP_BASE, r as effectiveOrder, t as duplicateNode } from "./duplicate-KRPtUtzl.js";
 import { i as applyParticlePreset, n as PARTICLE_PRESETS, r as PARTICLE_PRESET_NAMES, t as ParticleSim } from "./particle-sim-Bw7hB93B.js";
-import { i as resolveRendering, n as attachTouchControls, r as joystickVector, t as TouchControls } from "./touch-031PxtCR.js";
+import { i as resolveRendering, n as attachTouchControls, r as joystickVector, t as TouchControls } from "./touch-BoNg_MnF.js";
 //#region src/core/pathfinding.ts
 /**
 * A* from `from` to `to` (inclusive cell coords). Returns the cell path
@@ -295,6 +295,6 @@ function newUid() {
 //#endregion
 //#region src/index.ts
 /** Engine version. Kept in sync with package.json by the release pipeline. */
-const VERSION = "0.30.0";
+const VERSION = "0.32.0";
 //#endregion
 export { AudioBuses, AudioPlayer, Behavior, CONST_REF_KEY, Engine, HudLayer, IncantoError, InputMap, LogManager, MusicManager, Node, ORDER_GROUP_BASE, PARTICLE_PRESETS, PARTICLE_PRESET_NAMES, ParticleSim, ROLLOFF_MODELS, Rng, SCENE_FORMAT, SFX_PRESETS, SFX_PRESET_NAMES, Scene, SceneTree, SfxEngine, Signal, Timer, TouchControls, UiBanner, UiBar, UiButton, UiDialogue, UiText, VERSION, WebAudioMusicBackend, applyParticlePreset, assetUrls, attachTouchControls, auditScene, clearBehaviors, clearRegistry, computeViewport, createNode, createNoise2D, createSaveStore, crossfadeGains, duplicateNode, effectiveOrder, fadeGain, findPath, getBehavior, getNodeSchema, getNodeSignals, getNodeType, gridFromRows, isAudioContextAvailable, isConstRef, joystickVector, jsonClone, jsonEquals, jsonKind, loadScene, mergeStaticSignals, newUid, parseNodePath, preloadUrls, registerBehavior, registerCoreNodes, registerNode, registeredBehaviors, registeredTypes, replay, resolveConstants, resolveRendering, resolveViewport, serializeNode, spatialGain, spatialPan, startRecording, synthSfx };

package/dist/{loader-B242FF6N.d.ts → loader-BYBrqTxP.d.ts}

@@ -1,5 +1,5 @@
+import { v as Engine, w as Scene } from "./behavior-D_jMpFh8.js";
 import { i as SceneJson } from "./schema-CcoWb32N.js";
-import { v as Engine, w as Scene } from "./behavior-BAc0erXF.js";
 
 //#region src/core/scene/loader.d.ts
 interface LoadSceneOptions {