incanto 0.40.0 → 0.41.0

package/dist/2d.js

@@ -1,7 +1,7 @@
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
-import { a as AssetStore2D, i as syncTree2D, r as Renderer2D, t as createGame2D } from "./create-game-Dc2CEFtD.js";
-import { _ as RigidBody2D, a as parseCells, c as ColorRect2D, d as AnimatedSprite2D, f as Sprite2D, g as PhysicsBody2D, h as CharacterBody2D, i as mergeSolidRects, l as CharacterController2D, m as Area2D, n as UILayer, o as Particles2D, p as Joint2D, r as TileMap2D, s as Label, t as registerNodes2D, u as Camera2D, v as StaticBody2D, y as Node2D } from "./register-CgMO5JBY.js";
-import { n as enablePhysics2D, t as Physics2D } from "./physics-2d-CxIqR1cW.js";
+import { a as AssetStore2D, i as syncTree2D, r as Renderer2D, t as createGame2D } from "./create-game-CZpENyin.js";
+import { _ as RigidBody2D, a as parseCells, c as ColorRect2D, d as AnimatedSprite2D, f as Sprite2D, g as PhysicsBody2D, h as CharacterBody2D, i as mergeSolidRects, l as CharacterController2D, m as Area2D, n as UILayer, o as Particles2D, p as Joint2D, r as TileMap2D, s as Label, t as registerNodes2D, u as Camera2D, v as StaticBody2D, y as Node2D } from "./register-MSZvnHkp.js";
+import { n as enablePhysics2D, t as Physics2D } from "./physics-2d-CEnZFcpM.js";
 //#region src/2d/library-sprite.ts
 /**
 * Turn a library sprite-animation JSON into a scene-ready spritesheet asset

package/dist/3d.d.ts

@@ -1104,6 +1104,8 @@ declare class CharacterController3D extends Node3D {
   private bufferLeft;
   private jumpsUsed;
   private rising;
+  /** Between the jump impulse and the landing — the animation's clock. */
+  private jumping;
   private get body();
   override onEnterTree(): void;
   override fixedUpdate(dt: number): void;

package/dist/3d.js

@@ -1,8 +1,8 @@
-import { A as Water3D, F as PhysicsBody3D, I as RigidBody3D, L as StaticBody3D, M as WaterCutout3D, N as Area3D, P as CharacterBody3D, R as Node3D, V as WATER_MAX_RIPPLES, j as WATER_CUTOUT_MAX } from "./gameplay-CqNfawyn.js";
-import { A as Terrain3D, B as keyboardIntensity, C as resolveFlowerDensity, D as BoneLookAt3D, E as Camera3D, F as InstancedMesh3D, G as acquireTexture, H as rigPose, I as MeshInstance3D, M as TERRAIN_THEMES, N as terrainThemeLayers, O as BoneAttachment3D, P as Joint3D, R as QUARTER_PITCH, S as Flowers3D, T as CharacterController3D, U as TextureCache3D, V as movementState, W as acquireOwnTexture, _ as LoftMesh3D, a as Tree3D, b as Foliage3D, c as buildRiverRings, d as riverCarveChannels, f as riverStepFor, g as ModelInstance3D, h as Particles3D, i as VoxelGrid3D, j as DEFAULT_TERRAIN_TEXTURE_BASE, k as Billboard3D, l as findRiverCoverageGaps, m as traceDownhillPath, n as registerNodes3D, o as Trail3D, p as smoothCourse, r as VOXEL_PALETTE, s as River3D, u as projectToRiver, v as DirectionalLight3D, w as FLOWER_VARIETIES, x as DENSITY_PRESETS, y as OmniLight3D, z as cameraRelative } from "./environment-presets-Z0PkDH62.js";
-import { a as Environment3D, c as parseEnvironment3D, d as AssetStore3D, i as syncTree, l as sunDirectionFromElevationAzimuth, o as setEnvironment3D, r as Renderer3D, s as horizonColorFromSky, t as createGame3D, u as sunDirectionFromSky } from "./create-game-CEKCtnKw.js";
+import { A as Water3D, F as PhysicsBody3D, I as RigidBody3D, L as StaticBody3D, M as WaterCutout3D, N as Area3D, P as CharacterBody3D, R as Node3D, V as WATER_MAX_RIPPLES, j as WATER_CUTOUT_MAX } from "./gameplay-By8mslMc.js";
+import { A as Terrain3D, B as keyboardIntensity, C as resolveFlowerDensity, D as BoneLookAt3D, E as Camera3D, F as InstancedMesh3D, G as acquireTexture, H as rigPose, I as MeshInstance3D, M as TERRAIN_THEMES, N as terrainThemeLayers, O as BoneAttachment3D, P as Joint3D, R as QUARTER_PITCH, S as Flowers3D, T as CharacterController3D, U as TextureCache3D, V as movementState, W as acquireOwnTexture, _ as LoftMesh3D, a as Tree3D, b as Foliage3D, c as buildRiverRings, d as riverCarveChannels, f as riverStepFor, g as ModelInstance3D, h as Particles3D, i as VoxelGrid3D, j as DEFAULT_TERRAIN_TEXTURE_BASE, k as Billboard3D, l as findRiverCoverageGaps, m as traceDownhillPath, n as registerNodes3D, o as Trail3D, p as smoothCourse, r as VOXEL_PALETTE, s as River3D, u as projectToRiver, v as DirectionalLight3D, w as FLOWER_VARIETIES, x as DENSITY_PRESETS, y as OmniLight3D, z as cameraRelative } from "./environment-presets-pGTHb_V4.js";
+import { a as Environment3D, c as parseEnvironment3D, d as AssetStore3D, i as syncTree, l as sunDirectionFromElevationAzimuth, o as setEnvironment3D, r as Renderer3D, s as horizonColorFromSky, t as createGame3D, u as sunDirectionFromSky } from "./create-game-u7TDbvln.js";
 import { n as splatWeights, t as buildHeightmap } from "./heightmap-CRK0M4jT.js";
-import { n as enablePhysics3D, t as Physics3D } from "./physics-3d-CcUaeJXq.js";
+import { n as enablePhysics3D, t as Physics3D } from "./physics-3d-CumBBvQo.js";
 //#region src/3d/terrain-nav.ts
 function buildTerrainNav(terrain, opts) {
 	const cellSize = opts?.cellSize ?? 2;

package/dist/{create-game-Dc2CEFtD.js → create-game-CZpENyin.js}

@@ -1,13 +1,13 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
 import { n as loadScene, o as computeViewport, s as resolveViewport, v as diagnose, w as registerBehavior } from "./loader-r49nDwB4.js";
-import { h as Engine, m as AudioPlayer } from "./register-DMFJI-c_.js";
+import { h as Engine, m as AudioPlayer } from "./register-DuTlY56W.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { i as resolveRendering, n as attachTouchControls } from "./touch-BoNg_MnF.js";
 import { i as openBundledEditor, n as crossFade, r as devServerLibrary, t as teardown } from "./teardown-CCtAMDLB.js";
-import { n as registerGameplayBehaviors } from "./gameplay-CqNfawyn.js";
-import { g as PhysicsBody2D, n as UILayer, t as registerNodes2D, u as Camera2D, y as Node2D } from "./register-CgMO5JBY.js";
+import { n as registerGameplayBehaviors } from "./gameplay-By8mslMc.js";
+import { g as PhysicsBody2D, n as UILayer, t as registerNodes2D, u as Camera2D, y as Node2D } from "./register-MSZvnHkp.js";
 import { t as debugSources } from "./debug-draw-BM3DsvtT.js";
-import { n as enablePhysics2D } from "./physics-2d-CxIqR1cW.js";
+import { n as enablePhysics2D } from "./physics-2d-CEnZFcpM.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-CEKCtnKw.js → create-game-u7TDbvln.js}

@@ -1,13 +1,13 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
 import { n as loadScene, v as diagnose, w as registerBehavior } from "./loader-r49nDwB4.js";
-import { _ as qualityCaps, h as Engine, m as AudioPlayer, y as qualityRendering } from "./register-DMFJI-c_.js";
+import { _ as qualityCaps, h as Engine, m as AudioPlayer, y as qualityRendering } from "./register-DuTlY56W.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.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-CCtAMDLB.js";
-import { B as createCausticsQuad, F as PhysicsBody3D, R as Node3D, n as registerGameplayBehaviors } from "./gameplay-CqNfawyn.js";
+import { B as createCausticsQuad, F as PhysicsBody3D, R as Node3D, n as registerGameplayBehaviors } from "./gameplay-By8mslMc.js";
 import { t as debugSources } from "./debug-draw-BM3DsvtT.js";
-import { E as Camera3D, U as TextureCache3D, g as ModelInstance3D, n as registerNodes3D, t as resolveEnvironmentHdri, v as DirectionalLight3D } from "./environment-presets-Z0PkDH62.js";
-import { n as enablePhysics3D } from "./physics-3d-CcUaeJXq.js";
+import { E as Camera3D, U as TextureCache3D, g as ModelInstance3D, n as registerNodes3D, t as resolveEnvironmentHdri, v as DirectionalLight3D } from "./environment-presets-pGTHb_V4.js";
+import { n as enablePhysics3D } from "./physics-3d-CumBBvQo.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";

package/dist/debug.d.ts

@@ -7,7 +7,7 @@ interface DocumentLike {
 }
 //#endregion
 //#region src/debug/index.d.ts
-type DebugPanelId = "explorer" | "inspector" | "logs" | "stats";
+type DebugPanelId = "explorer" | "inspector" | "logs" | "stats" | "time";
 /** Menu entries that are switches rather than panels. */
 type DebugSwitchId = "colliders";
 /** `all` is every collider in the world; `selected` follows the Explorer. */
@@ -64,6 +64,15 @@ declare class DebugOverlay {
   private editing;
   /** Which bulky values are unfolded, per node ('transforms', 'collider.vertices'). */
   private readonly detailOpen;
+  /**
+  * The scale to come back to when a pause is lifted.
+  *
+  * Captured only from a RUNNING scale: pausing an already-frozen game (a
+  * hit-stop, a previous pause) must not record 0 as the thing to restore, or
+  * Resume does nothing and the game looks hung.
+  */
+  private resumeScale;
+  private timeEls;
   /** Pointer inside the inspector — it stops refreshing under your hand. */
   private hovering;
   constructor(engine: Engine, container: HTMLElement, doc: DocumentLike, statsSource?: (() => Partial<RendererStats>) | undefined, actions?: DebugAction[]);
@@ -107,6 +116,31 @@ declare class DebugOverlay {
   private renderValueRow;
   private trackEditing;
   private pushLog;
+  /**
+  * Set game time, defensively. `timeScale` multiplies every dt in the engine,
+  * so a NaN from a text field would poison physics, timers and animation in
+  * one frame, and a negative would run the simulation backwards through code
+  * that has never been asked to.
+  */
+  setTimeScale(next: number): void;
+  /** Freeze or unfreeze game time. Rendering keeps running — this is a pause,
+  *  not a stop: the camera still moves and the overlay stays interactive. */
+  setPaused(paused: boolean): void;
+  get paused(): boolean;
+  /**
+  * Advance exactly one frame, pausing first.
+  *
+  * Stepping a RUNNING game is meaningless — the next real frame lands a
+  * millisecond later and swamps the step — so this pauses and then steps,
+  * which is also the only way the button is useful twice in a row.
+  */
+  nextFrame(): void;
+  /** Push the engine's current time state into the panel, without rebuilding it. */
+  private syncTime;
+  private renderTime;
+  /** After a committed edit the field must show what the ENGINE took — a
+  *  rejected 'abc' or a clamped -2 has to be visible, not left on screen. */
+  private syncTimeAfterEdit;
   private renderLogs;
 }
 //#endregion

package/dist/debug.js

@@ -192,6 +192,9 @@ function detailText(value, json) {
 function isPlainObject(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
+/** The slider's ceiling. Beyond this the number box is the tool — a 0..8 slider
+*  makes the 0.1-to-1 range, where slow-motion debugging actually lives, unusable. */
+const TIME_SLIDER_MAX = 2;
 /** Attach the overlay; null when no DOM is available (headless). */
 function attachDebugOverlay(engine, opts = {}) {
 	const doc = opts.doc ?? (typeof document !== "undefined" ? document : null);
@@ -235,6 +238,15 @@ var DebugOverlay = class {
 	editing = 0;
 	/** Which bulky values are unfolded, per node ('transforms', 'collider.vertices'). */
 	detailOpen = /* @__PURE__ */ new WeakMap();
+	/**
+	* The scale to come back to when a pause is lifted.
+	*
+	* Captured only from a RUNNING scale: pausing an already-frozen game (a
+	* hit-stop, a previous pause) must not record 0 as the thing to restore, or
+	* Resume does nothing and the game looks hung.
+	*/
+	resumeScale = 1;
+	timeEls = null;
 	/** Pointer inside the inspector — it stops refreshing under your hand. */
 	hovering = false;
 	constructor(engine, container, doc, statsSource, actions = []) {
@@ -282,6 +294,7 @@ var DebugOverlay = class {
 			this.renderExplorer();
 			this.renderStats();
 			if (this.editing === 0 && !this.hovering) this.renderInspector();
+			this.syncTime();
 		}));
 	}
 	isOpen(id) {
@@ -314,11 +327,18 @@ var DebugOverlay = class {
 			this.openStatsChip();
 			return;
 		}
-		if (this.panels.has(id)) return;
+		if (this.panels.has(id)) {
+			if (id === "explorer") this.renderExplorer();
+			if (id === "inspector") this.renderInspector();
+			if (id === "logs") this.renderLogs();
+			if (id === "time") this.renderTime();
+			return;
+		}
 		const panel = new FloatingPanel(this.doc, this.container, {
 			explorer: "Explorer",
 			inspector: "Inspector",
-			logs: "Logs"
+			logs: "Logs",
+			time: "Time"
 		}[id], {
 			explorer: {
 				x: 12,
@@ -337,6 +357,12 @@ var DebugOverlay = class {
 				y: 380,
 				w: 532,
 				h: 200
+			},
+			time: {
+				x: 556,
+				y: 44,
+				w: 260,
+				h: 150
 			}
 		}[id]);
 		panel.onClose = () => this.close(id);
@@ -352,6 +378,7 @@ var DebugOverlay = class {
 		if (id === "explorer") this.renderExplorer();
 		if (id === "inspector") this.renderInspector();
 		if (id === "logs") this.renderLogs();
+		if (id === "time") this.renderTime();
 	}
 	close(id) {
 		if (id === "inspector") this.hovering = false;
@@ -453,6 +480,7 @@ var DebugOverlay = class {
 			["explorer", "Explorer"],
 			["inspector", "Inspector"],
 			["logs", "Logs"],
+			["time", "Time"],
 			["stats", "Stats"],
 			["colliders", "Colliders"]
 		]) {
@@ -849,6 +877,148 @@ var DebugOverlay = class {
 		if (this.logRows.length > MAX_LOG_ROWS) this.logRows.splice(0, this.logRows.length - MAX_LOG_ROWS);
 		this.renderLogs();
 	}
+	/**
+	* Set game time, defensively. `timeScale` multiplies every dt in the engine,
+	* so a NaN from a text field would poison physics, timers and animation in
+	* one frame, and a negative would run the simulation backwards through code
+	* that has never been asked to.
+	*/
+	setTimeScale(next) {
+		if (!Number.isFinite(next)) return;
+		this.engine.timeScale = Math.max(0, next);
+		this.syncTime();
+	}
+	/** Freeze or unfreeze game time. Rendering keeps running — this is a pause,
+	*  not a stop: the camera still moves and the overlay stays interactive. */
+	setPaused(paused) {
+		if (paused) {
+			if (this.engine.timeScale > 0) this.resumeScale = this.engine.timeScale;
+			this.engine.timeScale = 0;
+		} else this.engine.timeScale = this.resumeScale > 0 ? this.resumeScale : 1;
+		this.syncTime();
+	}
+	get paused() {
+		return this.engine.timeScale === 0;
+	}
+	/**
+	* Advance exactly one frame, pausing first.
+	*
+	* Stepping a RUNNING game is meaningless — the next real frame lands a
+	* millisecond later and swamps the step — so this pauses and then steps,
+	* which is also the only way the button is useful twice in a row.
+	*/
+	nextFrame() {
+		if (!this.paused) this.setPaused(true);
+		this.engine.step();
+		this.syncTime();
+	}
+	/** Push the engine's current time state into the panel, without rebuilding it. */
+	syncTime() {
+		const els = this.timeEls;
+		if (!els) return;
+		const scale = this.engine.timeScale;
+		const text = String(Math.round(scale * 1e3) / 1e3);
+		if (this.editing === 0) {
+			els.slider.value = String(Math.min(scale, TIME_SLIDER_MAX));
+			els.box.value = text;
+		}
+		els.readout.textContent = `timeScale ${text}${this.paused ? " · paused" : ""}`;
+		els.pause.textContent = this.paused ? "▶ Resume" : "⏸ Pause";
+	}
+	renderTime() {
+		const panel = this.panels.get("time");
+		if (!panel) return;
+		clear(panel.body);
+		this.timeEls = null;
+		const readout = this.doc.createElement("div");
+		applyStyle(readout, {
+			marginBottom: "6px",
+			opacity: "0.85"
+		});
+		panel.body.appendChild(readout);
+		const slider = this.doc.createElement("input");
+		slider.type = "range";
+		slider.min = "0";
+		slider.max = String(TIME_SLIDER_MAX);
+		slider.step = "0.05";
+		slider.value = String(Math.min(this.engine.timeScale, TIME_SLIDER_MAX));
+		applyStyle(slider, {
+			width: "100%",
+			marginBottom: "6px"
+		});
+		this.trackEditing(slider);
+		slider.addEventListener("input", () => this.setTimeScale(Number(slider.value)));
+		panel.body.appendChild(slider);
+		const row = this.doc.createElement("div");
+		applyStyle(row, {
+			display: "flex",
+			gap: "6px",
+			alignItems: "center",
+			marginBottom: "8px"
+		});
+		const box = this.doc.createElement("input");
+		box.type = "number";
+		box.min = "0";
+		box.step = "0.05";
+		box.value = String(this.engine.timeScale);
+		applyStyle(box, inputStyle("72px"));
+		this.trackEditing(box);
+		box.addEventListener("change", () => {
+			const next = Number(box.value);
+			if (Number.isFinite(next)) this.setTimeScale(next);
+			this.syncTimeAfterEdit();
+		});
+		row.appendChild(box);
+		for (const preset of [
+			.25,
+			.5,
+			1,
+			2
+		]) {
+			const chip = this.doc.createElement("div");
+			chip.textContent = `${preset}×`;
+			applyStyle(chip, {
+				cursor: "pointer",
+				opacity: "0.7",
+				padding: "2px 4px"
+			});
+			chip.addEventListener("click", () => this.setTimeScale(preset));
+			row.appendChild(chip);
+		}
+		panel.body.appendChild(row);
+		const buttons = this.doc.createElement("div");
+		applyStyle(buttons, {
+			display: "flex",
+			gap: "8px"
+		});
+		const pause = this.doc.createElement("div");
+		applyStyle(pause, buttonStyle());
+		pause.addEventListener("click", () => this.setPaused(!this.paused));
+		buttons.appendChild(pause);
+		const step = this.doc.createElement("div");
+		step.textContent = "⏭ Next frame";
+		step.title = "Pauses, then advances one fixed step";
+		applyStyle(step, buttonStyle());
+		step.addEventListener("click", () => this.nextFrame());
+		buttons.appendChild(step);
+		panel.body.appendChild(buttons);
+		this.timeEls = {
+			slider,
+			box,
+			readout,
+			pause
+		};
+		this.syncTime();
+	}
+	/** After a committed edit the field must show what the ENGINE took — a
+	*  rejected 'abc' or a clamped -2 has to be visible, not left on screen. */
+	syncTimeAfterEdit() {
+		const els = this.timeEls;
+		if (!els) return;
+		const scale = this.engine.timeScale;
+		els.slider.value = String(Math.min(scale, TIME_SLIDER_MAX));
+		els.box.value = String(Math.round(scale * 1e3) / 1e3);
+	}
 	renderLogs() {
 		const panel = this.panels.get("logs");
 		if (!panel) return;
@@ -924,6 +1094,17 @@ function stringify(part) {
 		return String(part);
 	}
 }
+/** A clickable chip that reads as a button in the overlay's flat style. */
+function buttonStyle() {
+	return {
+		background: "rgba(255,255,255,0.08)",
+		border: "1px solid rgba(255,255,255,0.2)",
+		borderRadius: "4px",
+		padding: "4px 8px",
+		cursor: "pointer",
+		userSelect: "none"
+	};
+}
 function inputStyle(width) {
 	return {
 		width,

package/dist/{environment-presets-Z0PkDH62.js → environment-presets-pGTHb_V4.js}

@@ -1,10 +1,10 @@
-import { t as registerCoreNodes } from "./register-DMFJI-c_.js";
+import { t as registerCoreNodes } from "./register-DuTlY56W.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-IyWCGe4q.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-CqNfawyn.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-By8mslMc.js";
 import { n as splatWeights, t as buildHeightmap } from "./heightmap-CRK0M4jT.js";
 import { AdditiveBlending, AnimationClip, AnimationMixer, Box3, BoxGeometry, BufferAttribute, BufferGeometry, CanvasTexture, CapsuleGeometry, ClampToEdgeWrapping, Color, ConeGeometry, CylinderGeometry, DataTexture, DirectionalLight, DoubleSide, DynamicDrawUsage, Euler, Group, IcosahedronGeometry, ImageBitmapLoader, InstancedBufferAttribute, InstancedMesh, LinearFilter, LinearMipmapLinearFilter, LoopOnce, LoopRepeat, Matrix4, Mesh, MeshBasicMaterial, MeshDepthMaterial, MeshPhysicalMaterial, MeshStandardMaterial, NearestFilter, NoBlending, NoColorSpace, NormalBlending, PerspectiveCamera, PlaneGeometry, PointLight, Points, PointsMaterial, Quaternion, QuaternionKeyframeTrack, RGBADepthPacking, RGBAFormat, RepeatWrapping, SRGBColorSpace, ShaderChunk, ShaderMaterial, SphereGeometry, Texture, TextureLoader, UniformsLib, UniformsUtils, Vector3, Vector4, VectorKeyframeTrack } from "three";
 import { clone } from "three/addons/utils/SkeletonUtils.js";
@@ -2621,6 +2621,8 @@ var CharacterController3D = class extends Node3D {
 	bufferLeft = 0;
 	jumpsUsed = 0;
 	rising = false;
+	/** Between the jump impulse and the landing — the animation's clock. */
+	jumping = false;
 	get body() {
 		const parent = this.parent;
 		if (!(parent instanceof RigidBody3D)) throw new IncantoError("TREE_VIOLATION", `CharacterController3D '${this.name}' must be a child of a RigidBody3D (parent is '${parent?.name ?? "none"}').`);
@@ -2708,7 +2710,7 @@ var CharacterController3D = class extends Node3D {
 			0,
 			-vel[2] * DRAG_DAMPING * mass
 		]);
-		if (toi !== null && toi < floatingDis * 2) {
+		if (toi !== null && toi < floatingDis * 2 && !this.jumping) {
 			const spring = SPRING_K * (floatingDis - toi) - vel[1] * SPRING_DAMPING;
 			body.applyImpulse([
 				0,
@@ -2720,9 +2722,10 @@ var CharacterController3D = class extends Node3D {
 			this.coyoteLeft = this.coyoteSeconds;
 			this.jumpsUsed = 0;
 			this.rising = false;
+			this.jumping = false;
 		} else {
 			this.coyoteLeft = Math.max(0, this.coyoteLeft - dt);
-			if (this.coyoteLeft <= 0 && this.jumpsUsed === 0) this.jumpsUsed = 1;
+			if (!this.grounded && this.coyoteLeft <= 0 && this.jumpsUsed === 0) this.jumpsUsed = 1;
 		}
 		const pressedJump = safeJustPressed(input, this.jumpAction);
 		if (pressedJump) this.bufferLeft = Math.max(this.jumpBufferSeconds, 0);
@@ -2739,6 +2742,7 @@ var CharacterController3D = class extends Node3D {
 			this.bufferLeft = 0;
 			this.coyoteLeft = 0;
 			this.rising = true;
+			this.jumping = true;
 			vel[1] = jumpVel;
 		}
 		if (this.rising) {
@@ -2762,7 +2766,7 @@ var CharacterController3D = class extends Node3D {
 			body.position[1] ?? 0,
 			0
 		];
-		const next = movementState(footed, moving ? intensity : 0);
+		const next = movementState(!(this.jumping || !this.grounded), moving ? intensity : 0);
 		if (next !== this.state) {
 			this.state = next;
 			const clip = this.animations[next];

package/dist/{gameplay-CqNfawyn.js → gameplay-By8mslMc.js}

@@ -1409,20 +1409,36 @@ void main() {
 
     // The depth texture DELIBERATELY holds above-water geometry too (the
     // depth-completion pass, for cutouts) — so a sample NEARER than this
-    // fragment cannot be a bed, and treating it as "column 0" rendered the
-    // water as clear glass over the bare bed. Behind a tree the half-res
-    // pre-pass smears the canopy across the gaps between its own leaves, and
-    // whole stretches of pond turned to glass — "the water isn't drawn". The
-    // column reads the DEEPEST of the 5-tap neighborhood instead; when even
-    // that is contaminated, depth is UNKNOWN (-1) and the flat-ramp fallback
-    // paints honest murk.
-    float seamL = linearizeDepth(texture2D(uDepthTexture, screenUV - vec2(uScenePassTexel.x, 0.0)).r, uCameraNear, uCameraFar);
-    float seamR = linearizeDepth(texture2D(uDepthTexture, screenUV + vec2(uScenePassTexel.x, 0.0)).r, uCameraNear, uCameraFar);
-    float seamD = linearizeDepth(texture2D(uDepthTexture, screenUV - vec2(0.0, uScenePassTexel.y)).r, uCameraNear, uCameraFar);
-    float seamU = linearizeDepth(texture2D(uDepthTexture, screenUV + vec2(0.0, uScenePassTexel.y)).r, uCameraNear, uCameraFar);
-    float seamFarthest = max(max(seamL, seamR), max(seamD, max(seamU, linearSceneDepth)));
-    if (seamFarthest > linearWaterDepth + 0.02) {
-      waterViewDepth = seamFarthest - linearWaterDepth;
+    // fragment can be a lie: behind a tree the half-res pre-pass smears the
+    // canopy across the gaps between its own leaves, and whole stretches of
+    // pond turned to glass ("the water isn't drawn"). Reading the DEEPEST of
+    // the 5-tap neighborhood repairs that.
+    //
+    // But ONLY where there is something to repair. Applied everywhere, it draws
+    // a dark hairline along every shoreline: in the thin swash the true column
+    // is millimetres while one texel further out the bed has already dropped
+    // away, so the deepest-of-5 hands a shallow fragment a deep-water column.
+    // Reported as "a black line on the beach", and it is gone the moment this
+    // reaches for the neighbourhood only when the centre is genuinely occluded.
+    //
+    // The two cases are told apart by HOW FAR IN FRONT the near sample is:
+    //   a canopy smeared over the water sits well in front  → repair
+    //   a beach meeting the surface sits AT it (a few cm)   → the column really
+    //                                                         is zero; leave it
+    float centreColumn = -depthDiff;
+    if (centreColumn > 0.02) {
+      waterViewDepth = centreColumn;
+    } else if (depthDiff > 0.25) {
+      float seamL = linearizeDepth(texture2D(uDepthTexture, screenUV - vec2(uScenePassTexel.x, 0.0)).r, uCameraNear, uCameraFar);
+      float seamR = linearizeDepth(texture2D(uDepthTexture, screenUV + vec2(uScenePassTexel.x, 0.0)).r, uCameraNear, uCameraFar);
+      float seamD = linearizeDepth(texture2D(uDepthTexture, screenUV - vec2(0.0, uScenePassTexel.y)).r, uCameraNear, uCameraFar);
+      float seamU = linearizeDepth(texture2D(uDepthTexture, screenUV + vec2(0.0, uScenePassTexel.y)).r, uCameraNear, uCameraFar);
+      float seamFarthest = max(max(seamL, seamR), max(seamD, max(seamU, linearSceneDepth)));
+      if (seamFarthest > linearWaterDepth + 0.02) {
+        waterViewDepth = seamFarthest - linearWaterDepth;
+      }
+    } else {
+      waterViewDepth = 0.0;
     }
 
     // waterline dither: on a near-flat beach one half-res depth texel spans a

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-CqNfawyn.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-By8mslMc.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.js

@@ -1,8 +1,8 @@
 import { C as getBehavior, E as Signal, S as clearBehaviors, T as registeredBehaviors, _ as InputMap, a as SCENE_FORMAT, b as behaviorSchema, c as SceneTree, d as resolveConstants, f as Node, g as resolveOrderGroups, h as effectiveOrder, i as serializeNode, l as CONST_REF_KEY, m as ORDER_GROUP_BASE, n as loadScene, o as computeViewport, p as parseNodePath, r as Scene, s as resolveViewport, u as isConstRef, w as registerBehavior, x as behaviorSignals, y as Behavior } from "./loader-r49nDwB4.js";
-import { A as T_PREFIX, B as synthSfx, C as behaviorsWithoutSave, D as LogManager, E as createSaveStore, F as ROLLOFF_MODELS, G as AudioBuses, H as WebAudioMusicBackend, I as spatialGain, L as spatialPan, M as translationKey, N as SfxEngine, O as BASE_LOCALE, P as isAudioContextAvailable, R as SFX_PRESETS, S as SaveSlots, T as restoreBehaviors, U as crossfadeGains, V as MusicManager, W as fadeGain, a as UiSlider, b as readDeviceHints, c as UiButton, d as UiBanner, f as UiBar, g as Settings, h as Engine, i as UiSelect, j as suggestLocale, k as Localization, l as UiDialogue, m as AudioPlayer, n as UiImage, o as UiToggle, p as UiText, r as UiPanel, s as Timer, t as registerCoreNodes, u as HudLayer, v as qualityEnvironment, w as captureBehaviors, x as suggestQuality, z as SFX_PRESET_NAMES } from "./register-DMFJI-c_.js";
+import { A as T_PREFIX, B as synthSfx, C as behaviorsWithoutSave, D as LogManager, E as createSaveStore, F as ROLLOFF_MODELS, G as AudioBuses, H as WebAudioMusicBackend, I as spatialGain, L as spatialPan, M as translationKey, N as SfxEngine, O as BASE_LOCALE, P as isAudioContextAvailable, R as SFX_PRESETS, S as SaveSlots, T as restoreBehaviors, U as crossfadeGains, V as MusicManager, W as fadeGain, a as UiSlider, b as readDeviceHints, c as UiButton, d as UiBanner, f as UiBar, g as Settings, h as Engine, i as UiSelect, j as suggestLocale, k as Localization, l as UiDialogue, m as AudioPlayer, n as UiImage, o as UiToggle, p as UiText, r as UiPanel, s as Timer, t as registerCoreNodes, u as HudLayer, v as qualityEnvironment, w as captureBehaviors, x as suggestQuality, z as SFX_PRESET_NAMES } from "./register-DuTlY56W.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as Rng } from "./rng-DP-SR7eg.js";
-import { n as startRecording, r as auditScene, t as replay } from "./replay-D_QY5Xm3.js";
+import { n as startRecording, r as auditScene, t as replay } from "./replay-DcWg4LT5.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-IyWCGe4q.js";
 import { t as createNoise2D } from "./noise-CGUMx44x.js";
@@ -172,6 +172,6 @@ function newUid() {
 //#endregion
 //#region src/index.ts
 /** Engine version. Kept in sync with package.json by the release pipeline. */
-const VERSION = "0.40.0";
+const VERSION = "0.41.0";
 //#endregion
 export { AudioBuses, AudioPlayer, BASE_LOCALE, Behavior, CONST_REF_KEY, Engine, HudLayer, IncantoError, InputMap, Localization, LogManager, MusicManager, Node, ORDER_GROUP_BASE, PARTICLE_PRESETS, PARTICLE_PRESET_NAMES, ParticleSim, ROLLOFF_MODELS, Rng, SCENE_FORMAT, SFX_PRESETS, SFX_PRESET_NAMES, SaveSlots, Scene, SceneTree, Settings, SfxEngine, Signal, T_PREFIX, Timer, TouchControls, UiBanner, UiBar, UiButton, UiDialogue, UiImage, UiPanel, UiSelect, UiSlider, UiText, UiToggle, VERSION, WebAudioMusicBackend, applyParticlePreset, assetUrls, attachTouchControls, auditScene, behaviorSchema, behaviorSignals, behaviorsWithoutSave, captureBehaviors, 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, qualityEnvironment, readDeviceHints, registerBehavior, registerCoreNodes, registerNode, registeredBehaviors, registeredTypes, replay, resolveConstants, resolveOrderGroups, resolveRendering, resolveViewport, restoreBehaviors, serializeNode, spatialGain, spatialPan, startRecording, suggestLocale, suggestQuality, synthSfx, translationKey };

package/dist/net.js

@@ -1,9 +1,9 @@
 import { n as loadScene } from "./loader-r49nDwB4.js";
-import { h as Engine } from "./register-DMFJI-c_.js";
+import { h as Engine } from "./register-DuTlY56W.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as jsonClone } from "./json-BLk7H2Qa.js";
 import { n as createAgent8Server } from "./agent8-CvsfVskX.js";
-import { i as applySyncPatch, n as NetworkSpawner, r as NetworkManager, t as registerNodesNet } from "./register-D5v8iqjZ.js";
+import { i as applySyncPatch, n as NetworkSpawner, r as NetworkManager, t as registerNodesNet } from "./register-DnycZ91Q.js";
 //#region src/net/loopback.ts
 /**
 * In-memory multiplayer hub implementing the SAME kernel contract as

package/dist/{physics-2d-CxIqR1cW.js → physics-2d-CEnZFcpM.js}

@@ -1,7 +1,7 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
 import { v as diagnose } from "./loader-r49nDwB4.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
-import { _ as RigidBody2D, b as validateCollider2D, g as PhysicsBody2D, h as CharacterBody2D, m as Area2D, p as Joint2D, y as Node2D } from "./register-CgMO5JBY.js";
+import { _ as RigidBody2D, b as validateCollider2D, g as PhysicsBody2D, h as CharacterBody2D, m as Area2D, p as Joint2D, y as Node2D } from "./register-MSZvnHkp.js";
 import { n as registerDebugSource } from "./debug-draw-BM3DsvtT.js";
 //#region src/2d/physics/physics-2d.ts
 var physics_2d_exports = /* @__PURE__ */ __exportAll({

package/dist/{physics-3d-CcUaeJXq.js → physics-3d-CumBBvQo.js}

@@ -1,9 +1,9 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
 import { v as diagnose } from "./loader-r49nDwB4.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
-import { F as PhysicsBody3D, I as RigidBody3D, N as Area3D, P as CharacterBody3D, R as Node3D, z as validateCollider3D } from "./gameplay-CqNfawyn.js";
+import { F as PhysicsBody3D, I as RigidBody3D, N as Area3D, P as CharacterBody3D, R as Node3D, z as validateCollider3D } from "./gameplay-By8mslMc.js";
 import { n as registerDebugSource } from "./debug-draw-BM3DsvtT.js";
-import { A as Terrain3D, F as InstancedMesh3D, L as buildMeshGeometry, P as Joint3D } from "./environment-presets-Z0PkDH62.js";
+import { A as Terrain3D, F as InstancedMesh3D, L as buildMeshGeometry, P as Joint3D } from "./environment-presets-pGTHb_V4.js";
 import { Euler, Matrix4, Quaternion, Vector3 } from "three";
 //#region src/3d/physics/collider-lines.ts
 /**

package/dist/react.js

@@ -156,7 +156,7 @@ function IncantoCanvas(props) {
 				pointer: latest.pointer,
 				...keyboard !== void 0 ? { keyboard } : {}
 			};
-			const next = await (_gameFactory ?? (mode === "3d" ? async (o) => (await import("./create-game-CEKCtnKw.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-Dc2CEFtD.js").then((n) => n.n)).createGame2D(o)))(opts);
+			const next = await (_gameFactory ?? (mode === "3d" ? async (o) => (await import("./create-game-u7TDbvln.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-CZpENyin.js").then((n) => n.n)).createGame2D(o)))(opts);
 			if (disposed) {
 				next.dispose();
 				return;

package/dist/{register-D5v8iqjZ.js → register-DnycZ91Q.js}

@@ -1,5 +1,5 @@
 import { E as Signal, f as Node, t as buildNodeJson } from "./loader-r49nDwB4.js";
-import { t as registerCoreNodes } from "./register-DMFJI-c_.js";
+import { t as registerCoreNodes } from "./register-DuTlY56W.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { n as jsonEquals, t as jsonClone } from "./json-BLk7H2Qa.js";
 import { l as registerNode } from "./registry-IyWCGe4q.js";

package/dist/{register-DMFJI-c_.js → register-DuTlY56W.js}

@@ -1980,6 +1980,8 @@ var Engine = class {
 	step() {
 		const scene = this._scene;
 		if (!scene) return;
+		this._time += this.fixedStep;
+		this._unscaledTime += this.fixedStep;
 		scene.tree.fixedUpdate(this.fixedStep);
 		this.fixedUpdated.emit(this.fixedStep);
 		scene.tree.update(this.fixedStep);

package/dist/{register-CgMO5JBY.js → register-MSZvnHkp.js}

@@ -1,5 +1,5 @@
 import { f as Node, h as effectiveOrder } from "./loader-r49nDwB4.js";
-import { t as registerCoreNodes } from "./register-DMFJI-c_.js";
+import { t as registerCoreNodes } from "./register-DuTlY56W.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-IyWCGe4q.js";

package/dist/{replay-D_QY5Xm3.js → replay-DcWg4LT5.js}

@@ -1,4 +1,4 @@
-import { M as translationKey } from "./register-DMFJI-c_.js";
+import { M as translationKey } from "./register-DuTlY56W.js";
 //#region src/core/audit.ts
 const ANIMATED_TYPES = new Set([
 	"Particles2D",