incanto 0.11.0 → 0.13.0

package/dist/3d.js

@@ -1,5 +1,144 @@
-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-DZ_4Nfq8.js";
-import { A as PhysicsBody3D, C as Terrain3D, D as Joint3D, E as terrainThemeLayers, F as QUARTER_PITCH, I as cameraRelative, L as keyboardIntensity, M as StaticBody3D, N as Node3D, O as Area3D, R as movementState, S as Billboard3D, T as TERRAIN_THEMES, _ as resolveFlowerDensity, a as VoxelGrid3D, b as Camera3D, c as Particles3D, d as MeshInstance3D, f as DirectionalLight3D, g as Flowers3D, h as DENSITY_PRESETS, i as VOXEL_PALETTE, j as RigidBody3D, k as CharacterBody3D, l as ModelInstance3D, m as Foliage3D, n as Water3D, o as Tree3D, p as OmniLight3D, r as WATER_MAX_RIPPLES, s as Trail3D, t as registerNodes3D, u as LoftMesh3D, v as FLOWER_VARIETIES, w as DEFAULT_TERRAIN_TEXTURE_BASE, x as BoneAttachment3D, y as CharacterController3D, z as rigPose } from "./register-ysLR3WQS.js";
+import { t as IncantoError } from "./errors-BpWbnbb_.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-J6g4QInv.js";
+import { A as Area3D, B as movementState, C as BoneAttachment3D, D as TERRAIN_THEMES, E as DEFAULT_TERRAIN_TEXTURE_BASE, F as Node3D, L as QUARTER_PITCH, M as PhysicsBody3D, N as RigidBody3D, O as terrainThemeLayers, P as StaticBody3D, R as cameraRelative, S as BoneLookAt3D, T as Terrain3D, V as rigPose, _ as Flowers3D, a as VoxelGrid3D, b as CharacterController3D, c as Particles3D, d as DirectionalLight3D, f as OmniLight3D, g as DENSITY_PRESETS, h as Foliage3D, i as VOXEL_PALETTE, j as CharacterBody3D, k as Joint3D, l as ModelInstance3D, m as MeshInstance3D, n as Water3D, o as Tree3D, p as InstancedMesh3D, r as WATER_MAX_RIPPLES, s as Trail3D, t as registerNodes3D, u as LoftMesh3D, v as resolveFlowerDensity, w as Billboard3D, x as Camera3D, y as FLOWER_VARIETIES, z as keyboardIntensity } from "./register-BFw4c83z.js";
 import { n as splatWeights, t as buildHeightmap } from "./heightmap-CroQPEER.js";
-import { n as enablePhysics3D, t as Physics3D } from "./physics-3d-Br97Ans2.js";
-export { Area3D, AssetStore3D, Billboard3D, BoneAttachment3D, Camera3D, CharacterBody3D, CharacterController3D, DEFAULT_TERRAIN_TEXTURE_BASE, DirectionalLight3D, Environment3D, DENSITY_PRESETS as FLOWER_DENSITY_PRESETS, FLOWER_VARIETIES, Flowers3D, Foliage3D, Joint3D, LoftMesh3D, MeshInstance3D, ModelInstance3D, Node3D, OmniLight3D, Particles3D, Physics3D, PhysicsBody3D, QUARTER_PITCH, Renderer3D, RigidBody3D, StaticBody3D, TERRAIN_THEMES, Terrain3D, Trail3D, Tree3D, VOXEL_PALETTE, VoxelGrid3D, WATER_MAX_RIPPLES, Water3D, buildHeightmap, cameraRelative, createGame3D, enablePhysics3D, horizonColorFromSky, keyboardIntensity, movementState, parseEnvironment3D, registerNodes3D, resolveFlowerDensity, rigPose, splatWeights, sunDirectionFromElevationAzimuth, sunDirectionFromSky, syncTree, terrainThemeLayers };
+import { n as enablePhysics3D, t as Physics3D } from "./physics-3d-DhaAaKJo.js";
+//#region src/3d/environment-runtime.ts
+/**
+* Live environment editing — the renderer re-applies `scene.environment`
+* every frame (cheap when unchanged), so changing the LOOK at runtime is
+* just writing that object. This helper does it safely:
+*
+*   setEnvironment3D(engine, { sky: { elevationDeg: 4 }, exposure: 0.8 });
+*   setEnvironment3D(engine, { fog: null });          // null DELETES a key
+*
+* - one-level deep merge (patching `sky.elevationDeg` keeps the other sky keys)
+* - hard-validates the merged result NOW (in your call stack), so a bad patch
+*   throws where you wrote it — never inside the render loop
+*/
+function setEnvironment3D(engine, patch) {
+	const scene = engine.scene;
+	if (!scene) throw new IncantoError("BAD_FORMAT", "setEnvironment3D: the engine has no scene.");
+	const merged = { ...scene.environment ?? {} };
+	for (const [key, value] of Object.entries(patch)) if (value === null) delete merged[key];
+	else if (typeof value === "object" && !Array.isArray(value) && typeof merged[key] === "object" && merged[key] !== null && !Array.isArray(merged[key])) merged[key] = {
+		...merged[key],
+		...value
+	};
+	else merged[key] = value;
+	parseEnvironment3D(merged);
+	scene.environment = merged;
+}
+//#endregion
+//#region src/3d/terrain-nav.ts
+function buildTerrainNav(terrain, opts) {
+	const cellSize = opts?.cellSize ?? 2;
+	const maxSlopeDeg = opts?.maxSlopeDeg ?? 40;
+	const minHeight = opts?.minHeight ?? Number.NEGATIVE_INFINITY;
+	let ox = 0;
+	let oz = 0;
+	for (let n = terrain; n; n = n.parent) if (n instanceof Node3D) {
+		ox += n.position[0] ?? 0;
+		oz += n.position[2] ?? 0;
+	}
+	const sizeX = terrain.size[0] ?? 200;
+	const sizeZ = terrain.size[1] ?? 200;
+	const width = Math.max(1, Math.round(sizeX / cellSize));
+	const height = Math.max(1, Math.round(sizeZ / cellSize));
+	const minX = ox - sizeX / 2;
+	const minZ = oz - sizeZ / 2;
+	const centerX = (cx) => minX + (cx + .5) * cellSize;
+	const centerZ = (cy) => minZ + (cy + .5) * cellSize;
+	const tanLimit = Math.tan(maxSlopeDeg * Math.PI / 180);
+	const halfDiag = cellSize / 2 * Math.SQRT2;
+	const solidBits = new Uint8Array(width * height);
+	for (let cy = 0; cy < height; cy++) for (let cx = 0; cx < width; cx++) {
+		const i = cy * width + cx;
+		const x = centerX(cx);
+		const z = centerZ(cy);
+		const h = terrain.heightAt(x, z);
+		if (h < minHeight) {
+			solidBits[i] = 1;
+			continue;
+		}
+		const half = cellSize / 2;
+		for (const [dx, dz] of CORNERS) {
+			const hc = terrain.heightAt(x + dx * half, z + dz * half);
+			if (Math.abs(hc - h) / halfDiag > tanLimit) {
+				solidBits[i] = 1;
+				break;
+			}
+		}
+	}
+	return {
+		grid: {
+			width,
+			height,
+			solid: (x, y) => x < 0 || y < 0 || x >= width || y >= height || solidBits[y * width + x] === 1
+		},
+		cellSize,
+		toCell: (x, z) => [Math.floor((x - minX) / cellSize), Math.floor((z - minZ) / cellSize)],
+		toWorld: (cx, cy) => {
+			const x = centerX(cx);
+			const z = centerZ(cy);
+			return [
+				x,
+				terrain.heightAt(x, z),
+				z
+			];
+		},
+		setSolid: (cx, cy) => {
+			if (cx >= 0 && cy >= 0 && cx < width && cy < height) solidBits[cy * width + cx] = 1;
+		}
+	};
+}
+const CORNERS = [
+	[1, 1],
+	[1, -1],
+	[-1, 1],
+	[-1, -1]
+];
+//#endregion
+//#region src/3d/terrain-nav-debug.ts
+/**
+* See what the enemies see: one node that paints every WALKABLE nav cell as a
+* translucent quad hugging the terrain surface. Add it while tuning
+* `cellSize`/`maxSlopeDeg`, drop it when the routes look right:
+*
+*   if (DEBUG_NAV) this.node.addChild(createNavDebugNode(this.nav));
+*
+* One InstancedMesh — a few thousand cells render as a single draw call.
+*/
+function createNavDebugNode(nav, opts) {
+	const node = new InstancedMesh3D(opts?.name ?? "__navDebug");
+	node.mesh = "plane";
+	node.size = [
+		nav.cellSize * .9,
+		1,
+		nav.cellSize * .9
+	];
+	node.material = {
+		color: opts?.color ?? "#37ff8b",
+		emissive: opts?.color ?? "#37ff8b",
+		emissiveIntensity: .5,
+		opacity: opts?.opacity ?? .3,
+		roughness: 1,
+		depthWrite: false
+	};
+	node.renderOrder = 50;
+	const lift = opts?.lift ?? .08;
+	const rows = [];
+	for (let cy = 0; cy < nav.grid.height; cy++) for (let cx = 0; cx < nav.grid.width; cx++) {
+		if (nav.grid.solid(cx, cy)) continue;
+		const [x, y, z] = nav.toWorld(cx, cy);
+		rows.push([
+			x,
+			y + lift,
+			z
+		]);
+	}
+	node.transforms = rows;
+	return node;
+}
+//#endregion
+export { Area3D, AssetStore3D, Billboard3D, BoneAttachment3D, BoneLookAt3D, Camera3D, CharacterBody3D, CharacterController3D, DEFAULT_TERRAIN_TEXTURE_BASE, DirectionalLight3D, Environment3D, DENSITY_PRESETS as FLOWER_DENSITY_PRESETS, FLOWER_VARIETIES, Flowers3D, Foliage3D, InstancedMesh3D, Joint3D, LoftMesh3D, MeshInstance3D, ModelInstance3D, Node3D, OmniLight3D, Particles3D, Physics3D, PhysicsBody3D, QUARTER_PITCH, Renderer3D, RigidBody3D, StaticBody3D, TERRAIN_THEMES, Terrain3D, Trail3D, Tree3D, VOXEL_PALETTE, VoxelGrid3D, WATER_MAX_RIPPLES, Water3D, buildHeightmap, buildTerrainNav, cameraRelative, createGame3D, createNavDebugNode, enablePhysics3D, horizonColorFromSky, keyboardIntensity, movementState, parseEnvironment3D, registerNodes3D, resolveFlowerDensity, rigPose, setEnvironment3D, splatWeights, sunDirectionFromElevationAzimuth, sunDirectionFromSky, syncTree, terrainThemeLayers };

package/dist/{behavior-Bod1AyJS.d.ts → behavior-CPibUfnH.d.ts}

@@ -693,8 +693,10 @@ declare class Scene {
   readonly dimension: "2d" | "3d" | undefined;
   readonly root: Node;
   readonly tree: SceneTree;
-  /** Scene-level rendering environment (read by renderer adapters). */
-  readonly environment: JsonObject | undefined;
+  /** Scene-level rendering environment (read by renderer adapters EVERY
+  *  frame, cheap when unchanged) — mutable so runtime look changes
+  *  (setEnvironment3D, DayNight) are just writes to this object. */
+  environment: JsonObject | undefined;
   /** Asset declarations (consumed by renderer/asset layers, `$key` references). */
   readonly assets: Record<string, JsonObject> | undefined;
   /** Named constant values (`{"@const": "NAME"}` prop references resolve to these). */

package/dist/{create-game-CdWhP6ve.js → create-game-Ct86zczq.js}

@@ -1,12 +1,12 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { _ as registerBehavior, n as loadScene, o as computeViewport, s as resolveViewport } from "./loader-B4OEXDZ8.js";
-import { l as AudioPlayer, u as Engine } from "./register-DJZXxwAn.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-nObreUQR.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { i as resolveRendering, n as attachTouchControls } from "./touch-031PxtCR.js";
-import { n as registerGameplayBehaviors } from "./gameplay-Dn3yidJw.js";
-import { g as PhysicsBody2D, n as UILayer, t as registerNodes2D, u as Camera2D, y as Node2D } from "./register-BD6zgrv_.js";
+import { n as registerGameplayBehaviors } from "./gameplay-sSqrUcnz.js";
+import { g as PhysicsBody2D, n as UILayer, t as registerNodes2D, u as Camera2D, y as Node2D } from "./register-Djwckzgx.js";
 import { t as debugSources } from "./debug-draw-CZmOYjL2.js";
-import { n as enablePhysics2D } from "./physics-2d-DweTURFt.js";
+import { n as enablePhysics2D } from "./physics-2d-BiIdl51r.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-DZ_4Nfq8.js → create-game-J6g4QInv.js}

@@ -1,12 +1,12 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { _ as registerBehavior, n as loadScene } from "./loader-B4OEXDZ8.js";
-import { l as AudioPlayer, u as Engine } from "./register-DJZXxwAn.js";
+import { _ as registerBehavior, n as loadScene } from "./loader-BZqOKfI2.js";
+import { l as AudioPlayer, u as Engine } from "./register-nObreUQR.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { i as resolveRendering, n as attachTouchControls } from "./touch-031PxtCR.js";
-import { n as registerGameplayBehaviors } from "./gameplay-Dn3yidJw.js";
+import { n as registerGameplayBehaviors } from "./gameplay-sSqrUcnz.js";
 import { t as debugSources } from "./debug-draw-CZmOYjL2.js";
-import { A as PhysicsBody3D, N as Node3D, b as Camera3D, f as DirectionalLight3D, l as ModelInstance3D, t as registerNodes3D } from "./register-ysLR3WQS.js";
-import { n as enablePhysics3D } from "./physics-3d-Br97Ans2.js";
+import { F as Node3D, M as PhysicsBody3D, d as DirectionalLight3D, l as ModelInstance3D, t as registerNodes3D, x as Camera3D } from "./register-BFw4c83z.js";
+import { n as enablePhysics3D } from "./physics-3d-DhaAaKJo.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";
@@ -182,6 +182,9 @@ varying vec2 vUv;
 uniform sampler2D tScene;
 uniform sampler2D tBloom;
 uniform float uStrength;
+uniform float uVignette;
+uniform float uSaturation;
+uniform float uContrast;
 void main() {
   vec3 base = texture2D(tScene, vUv).rgb;
   vec3 glow = texture2D(tBloom, vUv).rgb;
@@ -192,6 +195,15 @@ void main() {
   // tail here (ACES then linear→sRGB); without it the frame comes out dark
   // and oversaturated (the volumetric-clouds pipeline bug, root-caused).
   #include <tonemapping_fragment>
+  // color grade AFTER tone mapping (values are display-referred now) and
+  // BEFORE the colorspace transform: saturation → contrast → vignette
+  vec3 graded = gl_FragColor.rgb;
+  float luma = dot(graded, vec3(0.2126, 0.7152, 0.0722));
+  graded = mix(vec3(luma), graded, uSaturation);
+  graded = (graded - 0.5) * uContrast + 0.5;
+  float dist = distance(vUv, vec2(0.5));
+  graded *= 1.0 - uVignette * smoothstep(0.3, 0.78, dist);
+  gl_FragColor.rgb = max(graded, 0.0);
   #include <colorspace_fragment>
 }
 `;
@@ -234,7 +246,10 @@ function createBloomCompositeQuad() {
 	const mesh = quad(COMPOSITE_FRAG, {
 		tScene: { value: null },
 		tBloom: { value: null },
-		uStrength: { value: .85 }
+		uStrength: { value: .85 },
+		uVignette: { value: 0 },
+		uSaturation: { value: 1 },
+		uContrast: { value: 1 }
 	});
 	return {
 		mesh,
@@ -562,6 +577,11 @@ const CLOUD_KEYS = [
 	"scale"
 ];
 const BLOOM_KEYS = ["threshold", "strength"];
+const POST_KEYS = [
+	"vignette",
+	"saturation",
+	"contrast"
+];
 const SHADOW_KEYS = [
 	"mapSize",
 	"radius",
@@ -583,6 +603,7 @@ function parseEnvironment3D(env) {
 		fog: parseFog(env?.fog, env?.sky !== void 0),
 		clouds: parseClouds(env?.clouds),
 		bloom: parseBloom(env?.bloom),
+		post: parsePost(env?.post),
 		shadows: parseShadows(env?.shadows)
 	};
 }
@@ -754,6 +775,26 @@ function parseBloom(value) {
 		strength
 	};
 }
+function parsePost(value) {
+	if (value === void 0) return null;
+	if (typeof value !== "object" || value === null || Array.isArray(value)) throw new IncantoError("BAD_FORMAT", `environment.post must be an object ({ vignette?, saturation?, contrast? }), got ${JSON.stringify(value)}.`, { prop: "post" });
+	const p = value;
+	for (const key of Object.keys(p)) if (!POST_KEYS.includes(key)) throw new IncantoError("BAD_FORMAT", `environment.post has unknown key '${key}'. Valid keys: [${POST_KEYS.join(", ")}].`, {
+		prop: "post",
+		validOptions: POST_KEYS
+	});
+	const vignette = numberOr(p.vignette, 0, "post.vignette");
+	if (vignette < 0 || vignette > 1) throw new IncantoError("BAD_FORMAT", `environment.post.vignette must be in [0, 1], got ${vignette}.`, { prop: "post" });
+	const saturation = numberOr(p.saturation, 1, "post.saturation");
+	if (saturation < 0 || saturation > 4) throw new IncantoError("BAD_FORMAT", `environment.post.saturation must be in [0, 4] (1 = neutral), got ${saturation}.`, { prop: "post" });
+	const contrast = numberOr(p.contrast, 1, "post.contrast");
+	if (contrast < .2 || contrast > 3) throw new IncantoError("BAD_FORMAT", `environment.post.contrast must be in [0.2, 3] (1 = neutral), got ${contrast}.`, { prop: "post" });
+	return {
+		vignette,
+		saturation,
+		contrast
+	};
+}
 function parseShadows(value) {
 	if (value === void 0) return null;
 	if (value === false) return false;
@@ -876,6 +917,10 @@ var Environment3D = class {
 	get bloom() {
 		return this.config.bloom;
 	}
+	/** Parsed color-grade/vignette config, or null when not declared. */
+	get post() {
+		return this.config.post;
+	}
 	/** The live scene fog (color/near/far) the cloud composite fades into, or null. */
 	get sceneFog() {
 		return this.scene.fog instanceof Fog ? this.scene.fog : null;
@@ -1601,9 +1646,10 @@ var Renderer3D = class {
 		this.environment.applyUnderwater(underwater);
 		const clouds = this.environment.clouds;
 		const bloom = this.environment.bloom;
+		const post = this.environment.post;
 		if (underwater?.caustics.enabled) this.renderWithCaustics(activeCamera, underwater);
 		else if (clouds && !underwater) this.renderWithClouds(activeCamera, clouds, threeLight);
-		else if (bloom && !underwater) this.renderWithBloom(activeCamera, bloom);
+		else if ((bloom || post) && !underwater) this.renderWithBloom(activeCamera, bloom, post);
 		else this.webgl.render(this.threeScene, activeCamera);
 	}
 	/**
@@ -1615,7 +1661,7 @@ var Renderer3D = class {
 	*      the scene's tone; the clouds pipeline taught us that lesson)
 	* Caustics/clouds paths take precedence (composite pipelines don't stack yet).
 	*/
-	renderWithBloom(camera, bloom) {
+	renderWithBloom(camera, bloom, post = null) {
 		const buf = this.webgl.getDrawingBufferSize(sizeScratch);
 		const w = Math.max(1, buf.x);
 		const h = Math.max(1, buf.y);
@@ -1652,24 +1698,29 @@ var Renderer3D = class {
 		const blurTarget = this.bloomBlurTarget;
 		this.webgl.setRenderTarget(this.bloomTarget);
 		this.webgl.render(this.threeScene, camera);
-		const bu = this.bloomBrightUniforms;
-		bu.tScene.value = this.bloomTarget.texture;
-		bu.uThreshold.value = bloom.threshold;
-		this.webgl.setRenderTarget(brightTarget);
-		this.webgl.render(this.bloomBrightScene, camera);
-		const blu = this.bloomBlurUniforms;
-		blu.tTex.value = brightTarget.texture;
-		blu.uDir.value.set(1 / hw, 0);
-		this.webgl.setRenderTarget(blurTarget);
-		this.webgl.render(this.bloomBlurScene, camera);
-		blu.tTex.value = blurTarget.texture;
-		blu.uDir.value.set(0, 1 / hh);
-		this.webgl.setRenderTarget(brightTarget);
-		this.webgl.render(this.bloomBlurScene, camera);
+		if (bloom) {
+			const bu = this.bloomBrightUniforms;
+			bu.tScene.value = this.bloomTarget.texture;
+			bu.uThreshold.value = bloom.threshold;
+			this.webgl.setRenderTarget(brightTarget);
+			this.webgl.render(this.bloomBrightScene, camera);
+			const blu = this.bloomBlurUniforms;
+			blu.tTex.value = brightTarget.texture;
+			blu.uDir.value.set(1 / hw, 0);
+			this.webgl.setRenderTarget(blurTarget);
+			this.webgl.render(this.bloomBlurScene, camera);
+			blu.tTex.value = blurTarget.texture;
+			blu.uDir.value.set(0, 1 / hh);
+			this.webgl.setRenderTarget(brightTarget);
+			this.webgl.render(this.bloomBlurScene, camera);
+		}
 		const cu = this.bloomCompositeUniforms;
 		cu.tScene.value = this.bloomTarget.texture;
-		cu.tBloom.value = brightTarget.texture;
-		cu.uStrength.value = bloom.strength;
+		cu.tBloom.value = bloom ? brightTarget.texture : this.bloomTarget.texture;
+		cu.uStrength.value = bloom ? bloom.strength : 0;
+		cu.uVignette.value = post?.vignette ?? 0;
+		cu.uSaturation.value = post?.saturation ?? 1;
+		cu.uContrast.value = post?.contrast ?? 1;
 		this.webgl.setRenderTarget(null);
 		this.webgl.render(this.bloomCompositeScene, camera);
 	}

package/dist/debug.d.ts

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

package/dist/{duplicate-BEvGBtb_.js → duplicate-BINwP0WG.js}

@@ -1,4 +1,4 @@
-import { i as serializeNode, t as buildNodeJson } from "./loader-B4OEXDZ8.js";
+import { i as serializeNode, t as buildNodeJson } from "./loader-BZqOKfI2.js";
 //#region src/core/scene/duplicate.ts
 function stripUids(json) {
 	const { uid: _uid, ...rest } = json;

package/dist/{gameplay-Dn3yidJw.js → gameplay-sSqrUcnz.js}

@@ -1,7 +1,7 @@
-import { _ as registerBehavior, m as Behavior, n as loadScene } from "./loader-B4OEXDZ8.js";
+import { _ as registerBehavior, m as Behavior, n as loadScene } from "./loader-BZqOKfI2.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as jsonClone } from "./json-BLk7H2Qa.js";
-import { t as duplicateNode } from "./duplicate-BEvGBtb_.js";
+import { t as duplicateNode } from "./duplicate-BINwP0WG.js";
 //#region src/gameplay/spatial.ts
 /** Duck-type test: every spatial node (Node2D/Node3D) exposes `position: number[]`. */
 function hasPosition$1(node) {
@@ -428,6 +428,77 @@ function findHealth(node) {
 	return null;
 }
 //#endregion
+//#region src/gameplay/day-night.ts
+var DayNight = class extends Behavior {
+	static signals = ["dayPhaseChanged"];
+	static props = {
+		/** Real seconds for a full 24h cycle. */
+		daySeconds: { default: 240 },
+		/** Clock position at scene start (0-24; 12 = noon). */
+		startHour: { default: 10 },
+		/** Noon sun elevation, degrees. */
+		maxSunElevationDeg: { default: 55 },
+		/** How dark midnight gets: 0 = unchanged, 1 = black. */
+		nightDarkness: { default: .75 },
+		/** Freeze the clock (drive `hour` yourself). */
+		paused: { default: false }
+	};
+	daySeconds = 240;
+	startHour = 10;
+	maxSunElevationDeg = 55;
+	nightDarkness = .75;
+	paused = false;
+	/** Current clock hour (0-24). Write it to jump the time of day. */
+	hour = 0;
+	phase = "";
+	applyClock = 0;
+	baseAmbient = .3;
+	baseExposure = 1;
+	captured = false;
+	onReady() {
+		this.hour = this.startHour;
+	}
+	update(dt) {
+		if (!this.paused) this.hour = (this.hour + dt / this.daySeconds * 24) % 24;
+		this.applyClock -= dt;
+		if (this.applyClock > 0) return;
+		this.applyClock = .2;
+		this.applyHour();
+		const next = phaseOf(this.hour);
+		if (next !== this.phase) {
+			this.phase = next;
+			this.emit("dayPhaseChanged", next);
+		}
+	}
+	applyHour() {
+		const engine = this.node.tree?.engine;
+		const env = engine?.scene?.environment;
+		if (!engine || !env?.sky) return;
+		if (!this.captured) {
+			this.captured = true;
+			this.baseAmbient = env.ambient?.intensity ?? .3;
+			this.baseExposure = env.exposure ?? 1;
+		}
+		const t = (this.hour - 6) / 12 * Math.PI;
+		const sun = Math.sin(t);
+		env.sky.elevationDeg = sun * this.maxSunElevationDeg + (sun < 0 ? sun * 10 : 0);
+		env.sky.azimuthDeg = this.hour / 24 * 360 + 90;
+		const daylight = Math.max(0, sun);
+		const dark = this.nightDarkness;
+		env.ambient = {
+			...env.ambient ?? {},
+			intensity: this.baseAmbient * (1 - dark + dark * daylight)
+		};
+		env.exposure = this.baseExposure * (1 - dark * .55 * (1 - daylight));
+	}
+};
+function phaseOf(hour) {
+	if (hour < 5 || hour >= 20) return "night";
+	if (hour < 7.5) return "dawn";
+	if (hour < 17.5) return "day";
+	return "dusk";
+}
+//#endregion
 //#region src/gameplay/follow-camera.ts
 /**
 * Make the node it sits on chase a target's position — THE camera-follow
@@ -1873,6 +1944,7 @@ var ZombieAI = class extends Behavior {
 /** Every built-in gameplay behavior, keyed by its registration name. */
 const GAMEPLAY_BEHAVIORS = {
 	CameraShake,
+	DayNight,
 	GameFlow,
 	PathFollow,
 	Health,
@@ -1903,4 +1975,4 @@ function registerGameplayBehaviors(opts) {
 	for (const [name, ctor] of Object.entries(GAMEPLAY_BEHAVIORS)) registerBehavior(name, ctor, { replace });
 }
 //#endregion
-export { FollowCamera as C, Chase as D, Collector as E, restartScene as S, Health as T, hitStop as _, Wander as a, GameFlow as b, Projectile as c, PathFollow as d, Oscillate as f, Cooldown as g, CameraShake as h, WaveSpawner as i, Pickup as l, Lifetime as m, registerGameplayBehaviors as n, Spawner as o, MoveTo as p, ZombieAI as r, ScoreKeeper as s, GAMEPLAY_BEHAVIORS as t, Patrol as u, screenFlash as v, DamageOnContact as w, goToScene as x, Interactable as y };
+export { FollowCamera as C, Health as D, DamageOnContact as E, Collector as O, restartScene as S, phaseOf as T, hitStop as _, Wander as a, GameFlow as b, Projectile as c, PathFollow as d, Oscillate as f, Cooldown as g, CameraShake as h, WaveSpawner as i, Chase as k, Pickup as l, Lifetime as m, registerGameplayBehaviors as n, Spawner as o, MoveTo as p, ZombieAI as r, ScoreKeeper as s, GAMEPLAY_BEHAVIORS as t, Patrol as u, screenFlash as v, DayNight as w, goToScene as x, Interactable as y };

package/dist/gameplay.d.ts

@@ -1,5 +1,5 @@
 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-Bod1AyJS.js";
+import { $ as Node, l as PropSchema, n as BehaviorCtor, t as Behavior, v as Engine } from "./behavior-CPibUfnH.js";
 
 //#region src/gameplay/chase.d.ts
 /**
@@ -540,6 +540,41 @@ declare class ZombieAI extends Behavior {
   private pickGoal;
 }
 //#endregion
+//#region src/gameplay/day-night.d.ts
+/**
+* A live day/night cycle — drives the scene's `environment` (sun elevation +
+* azimuth, ambient, exposure) through a full 24-hour loop. Attach anywhere
+* (the scene root is natural); requires a 3D scene with an atmosphere sky.
+*
+*   { "script": { "name": "DayNight", "props": { "daySeconds": 240, "startHour": 9 } } }
+*
+* `hour` (0-24, readable/writable) is the single source of truth — set it to
+* jump to a time of day, or set `paused: true` and animate it yourself.
+* Emits `dayPhaseChanged('dawn'|'day'|'dusk'|'night')` on transitions — hook
+* spawners/lights/music to it.
+*/
+type DayPhase = "dawn" | "day" | "dusk" | "night";
+declare class DayNight extends Behavior {
+  static readonly signals: readonly string[];
+  static readonly props: PropSchema;
+  daySeconds: number;
+  startHour: number;
+  maxSunElevationDeg: number;
+  nightDarkness: number;
+  paused: boolean;
+  /** Current clock hour (0-24). Write it to jump the time of day. */
+  hour: number;
+  private phase;
+  private applyClock;
+  private baseAmbient;
+  private baseExposure;
+  private captured;
+  override onReady(): void;
+  override update(dt: number): void;
+  private applyHour;
+}
+declare function phaseOf(hour: number): DayPhase;
+//#endregion
 //#region src/gameplay/game-flow.d.ts
 /**
 * Reload the CURRENT scene from its source JSON — fresh nodes, reset physics,
@@ -699,4 +734,4 @@ declare function registerGameplayBehaviors(opts?: {
   replace?: boolean;
 }): void;
 //#endregion
-export { CameraShake, Chase, Collector, Cooldown, DamageOnContact, FollowCamera, GAMEPLAY_BEHAVIORS, GameFlow, type GameFlowState, Health, Interactable, Lifetime, MoveTo, Oscillate, PathFollow, Patrol, Pickup, Projectile, ScoreKeeper, Spawner, Wander, WaveSpawner, ZombieAI, goToScene, hitStop, registerGameplayBehaviors, restartScene, screenFlash };
+export { CameraShake, Chase, Collector, Cooldown, DamageOnContact, DayNight, type DayPhase, FollowCamera, GAMEPLAY_BEHAVIORS, GameFlow, type GameFlowState, Health, Interactable, Lifetime, MoveTo, Oscillate, PathFollow, Patrol, Pickup, Projectile, ScoreKeeper, Spawner, Wander, WaveSpawner, ZombieAI, goToScene, hitStop, phaseOf, registerGameplayBehaviors, restartScene, screenFlash };

package/dist/gameplay.js

@@ -1,2 +1,2 @@
-import { C as FollowCamera, D as Chase, E as Collector, S as restartScene, T as Health, _ 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, 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 DamageOnContact, x as goToScene, y as Interactable } from "./gameplay-Dn3yidJw.js";
-export { CameraShake, Chase, Collector, Cooldown, DamageOnContact, FollowCamera, GAMEPLAY_BEHAVIORS, GameFlow, Health, Interactable, Lifetime, MoveTo, Oscillate, PathFollow, Patrol, Pickup, Projectile, ScoreKeeper, Spawner, Wander, WaveSpawner, ZombieAI, goToScene, hitStop, registerGameplayBehaviors, restartScene, screenFlash };
+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-sSqrUcnz.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 { 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-Bod1AyJS.js";
-import { n as loadScene, t as LoadSceneOptions } from "./loader-BcUDfNHn.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-CPibUfnH.js";
+import { n as loadScene, t as LoadSceneOptions } from "./loader-DILt9PGC.js";
 import { n as ParticleSimConfig, r as ParticleView, t as ParticleSim } from "./particle-sim-CwJ5rI_P.js";
-import { n as AudioPlayer, t as AudioElementLike } from "./audio-player-Dyjg5k92.js";
+import { a as AudioElementLike, i as gridFromRows, n as PathGrid, o as AudioPlayer, r as findPath, t as FindPathOptions } from "./pathfinding-RWYkNKx9.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
@@ -336,33 +336,6 @@ declare const PARTICLE_PRESET_NAMES: readonly string[];
 */
 declare function applyParticlePreset(target: Record<string, unknown>, presetName: string, schema: PropSchema): void;
 //#endregion
-//#region src/core/pathfinding.d.ts
-/**
-* Grid A* — the pathfinding every top-down/RPG/tower-defense asks for and
-* agents keep re-inventing badly. Pure and dimension-free: cells in, cells
-* out; the caller maps cells to world units (px, meters, tiles).
-*/
-interface PathGrid {
-  width: number;
-  height: number;
-  /** True = impassable. Out-of-bounds is always solid. */
-  solid(x: number, y: number): boolean;
-}
-interface FindPathOptions {
-  /** Allow diagonal steps (blocked from cutting corners). Default true. */
-  diagonal?: boolean;
-  /** Abort guard for huge/impossible searches. Default 20000 nodes. */
-  maxExpansions?: number;
-}
-/**
-* A* from `from` to `to` (inclusive cell coords). Returns the cell path
-* INCLUDING both endpoints, or null when unreachable. Straight steps cost
-* 1, diagonals √2; the heuristic is octile (admissible for both modes).
-*/
-declare function findPath(grid: PathGrid, from: [number, number], to: [number, number], opts?: FindPathOptions): [number, number][] | null;
-/** Build a PathGrid from row-strings ('#' = solid) — tests and tile games. */
-declare function gridFromRows(rows: readonly string[]): PathGrid;
-//#endregion
 //#region src/core/preload.d.ts
 interface PreloadResult {
   /** Urls whose fetch failed — show an error UI instead of pretending success. */

package/dist/index.js

@@ -1,5 +1,5 @@
-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-B4OEXDZ8.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-DJZXxwAn.js";
+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-nObreUQR.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";
@@ -8,7 +8,7 @@ import { a as getNodeSignals, c as mergeStaticSignals, i as getNodeSchema, l as
 import { t as createNoise2D } from "./noise-CGUMx44x.js";
 import { a as ORDER_GROUP_BASE, i as applyParticlePreset, n as PARTICLE_PRESETS, o as effectiveOrder, r as PARTICLE_PRESET_NAMES, t as ParticleSim } from "./particle-sim-CyUU7HVU.js";
 import { i as resolveRendering, n as attachTouchControls, r as joystickVector, t as TouchControls } from "./touch-031PxtCR.js";
-import { t as duplicateNode } from "./duplicate-BEvGBtb_.js";
+import { t as duplicateNode } from "./duplicate-BINwP0WG.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.11.0";
+const VERSION = "0.13.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-B4OEXDZ8.js → loader-BZqOKfI2.js}

@@ -751,7 +751,9 @@ var Scene = class {
 	dimension;
 	root;
 	tree;
-	/** Scene-level rendering environment (read by renderer adapters). */
+	/** Scene-level rendering environment (read by renderer adapters EVERY
+	*  frame, cheap when unchanged) — mutable so runtime look changes
+	*  (setEnvironment3D, DayNight) are just writes to this object. */
 	environment;
 	/** Asset declarations (consumed by renderer/asset layers, `$key` references). */
 	assets;

package/dist/{loader-BcUDfNHn.d.ts → loader-DILt9PGC.d.ts}

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

package/dist/net.d.ts

@@ -1,5 +1,5 @@
 import { c as JsonValue, i as SceneJson, s as JsonObject } from "./schema-CcoWb32N.js";
-import { $ as Node, l as PropSchema, tt as Signal, v as Engine } from "./behavior-Bod1AyJS.js";
+import { $ as Node, l as PropSchema, tt as Signal, v as Engine } from "./behavior-CPibUfnH.js";
 
 //#region src/net/types.d.ts
 type Unsubscribe = () => void;