incanto 0.20.0 → 0.21.0

package/dist/3d.d.ts

@@ -1598,6 +1598,24 @@ interface RiverHit {
   speed: number;
   halfWidth: number;
 }
+/** A place where the river stops flowing and starts falling. */
+interface RiverFall {
+  /** Where the water LANDS (local frame) — the plunge point. */
+  x: number;
+  z: number;
+  /** Water surface at the lip and at the base. */
+  topY: number;
+  baseY: number;
+  /** Vertical drop in meters. */
+  drop: number;
+  /** Channel half-width at the base — how wide the curtain is. */
+  halfWidth: number;
+  /** Downstream direction at the base (a fall keeps carrying the water). */
+  dirX: number;
+  dirZ: number;
+  /** Current speed at the base. */
+  speed: number;
+}
 interface DownhillTraceOptions {
   /** Where the water starts (local frame, same as the sampler). */
   x: number;
@@ -1676,9 +1694,17 @@ declare class River3D extends Node3D implements SunConsumer3D {
   terrain: string;
   /** How hard the current sweeps bodies downstream (0 = visual only). */
   flowForce: number;
+  /**
+  * Mist at the foot of every waterfall the course contains: the node finds
+  * the drops itself (see {@link detectFalls}) and hangs a Particles3D plume
+  * on each, sized by how far the water falls. 0 = off.
+  */
+  spray: number;
   override renderOrder: number;
   private time;
   private rings;
+  private falls;
+  private sprayKey;
   private courseKey;
   private bedAt;
   private world;
@@ -1696,6 +1722,16 @@ declare class River3D extends Node3D implements SunConsumer3D {
   sampleAt(x: number, z: number): (RiverHit & {
     surfaceY: number;
   }) | null;
+  /**
+  * The waterfalls on this course — where the water stops flowing and starts
+  * falling, with the drop height and the plunge point in WORLD coordinates.
+  * Hang your own effects (sound, a rainbow, a hidden cave) on these.
+  */
+  fallsAt(): (RiverFall & {
+    worldX: number;
+    worldY: number;
+    worldZ: number;
+  })[];
   /** @internal The derived centerline stations (surface, grade, current). */
   _rings(): readonly RiverRing[];
   /**
@@ -1716,6 +1752,12 @@ declare class River3D extends Node3D implements SunConsumer3D {
   private buildMaterial;
   private syncUniforms;
   /**
+  * Hang a mist plume on every fall. Runtime children (`__spray*`), rebuilt
+  * only when the course or the dial changes — a plume is a Particles3D, so it
+  * carries its own budget, culling and editor visibility for free.
+  */
+  private syncSpray;
+  /**
   * Drag every body floating in the channel toward the water's own velocity.
   * Drag rather than thrust: a raft accelerates until it matches the current
   * and then coasts, and a swimmer can still fight across a slow ford.
@@ -2276,6 +2318,13 @@ declare class Water3D extends Node3D implements RenderHook3D, SunConsumer3D {
   swellDirectionDeg: number;
   /** Primary swell wavelength in meters (the two crossing trains derive). */
   swellWavelength: number;
+  /**
+  * GERSTNER pinch on the swell: 0 keeps the legacy height-only trains, 1 is
+  * maximum trochoid (crests narrow to a peak, troughs go broad). It also
+  * decides where whitecaps break — the surface's Jacobian collapses on a
+  * folding crest, and that is where foam belongs.
+  */
+  swellSteepness: number;
   /** Open-water whitecap foam on the tallest crests, 0–1 (fancy only). Works
   * best with `swell` — the caps ride the swell's crest lines. */
   whitecaps: number;

package/dist/3d.js

@@ -1,8 +1,8 @@
 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-pNf3sI-Q.js";
-import { A as TERRAIN_THEMES, B as QUARTER_PITCH, C as CharacterController3D, D as Billboard3D, E as BoneAttachment3D, F as PhysicsBody3D, H as keyboardIntensity, I as RigidBody3D, L as StaticBody3D, M as Joint3D, N as Area3D, O as Terrain3D, P as CharacterBody3D, R as Node3D, S as FLOWER_VARIETIES, T as BoneLookAt3D, U as movementState, V as cameraRelative, W as rigPose, _ as MeshInstance3D, a as VoxelGrid3D, b as Flowers3D, c as River3D, d as Particles3D, f as ModelInstance3D, g as InstancedMesh3D, h as OmniLight3D, i as VOXEL_PALETTE, j as terrainThemeLayers, k as DEFAULT_TERRAIN_TEXTURE_BASE, l as traceDownhillPath, m as DirectionalLight3D, n as Water3D, o as Tree3D, p as LoftMesh3D, s as Trail3D, t as registerNodes3D, u as WATER_MAX_RIPPLES, v as Foliage3D, w as Camera3D, x as resolveFlowerDensity, y as DENSITY_PRESETS } from "./register-BWFgsGra.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-xbxZRFwR.js";
+import { A as TERRAIN_THEMES, B as QUARTER_PITCH, C as CharacterController3D, D as Billboard3D, E as BoneAttachment3D, F as PhysicsBody3D, H as keyboardIntensity, I as RigidBody3D, L as StaticBody3D, M as Joint3D, N as Area3D, O as Terrain3D, P as CharacterBody3D, R as Node3D, S as FLOWER_VARIETIES, T as BoneLookAt3D, U as movementState, V as cameraRelative, W as rigPose, _ as MeshInstance3D, a as VoxelGrid3D, b as Flowers3D, c as River3D, d as Particles3D, f as ModelInstance3D, g as InstancedMesh3D, h as OmniLight3D, i as VOXEL_PALETTE, j as terrainThemeLayers, k as DEFAULT_TERRAIN_TEXTURE_BASE, l as traceDownhillPath, m as DirectionalLight3D, n as Water3D, o as Tree3D, p as LoftMesh3D, s as Trail3D, t as registerNodes3D, u as WATER_MAX_RIPPLES, v as Foliage3D, w as Camera3D, x as resolveFlowerDensity, y as DENSITY_PRESETS } from "./register-BC55Ez6I.js";
 import { n as splatWeights, t as buildHeightmap } from "./heightmap-CRK0M4jT.js";
-import { n as enablePhysics3D, t as Physics3D } from "./physics-3d-DxFDfUey.js";
+import { n as enablePhysics3D, t as Physics3D } from "./physics-3d-DHTZUrr0.js";
 //#region src/3d/environment-runtime.ts
 /**
 * Live environment editing — the renderer re-applies `scene.environment`

package/dist/{create-game-pNf3sI-Q.js → create-game-xbxZRFwR.js}

@@ -5,8 +5,8 @@ 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-sSqrUcnz.js";
 import { t as debugSources } from "./debug-draw-CZmOYjL2.js";
-import { F as PhysicsBody3D, R as Node3D, f as ModelInstance3D, m as DirectionalLight3D, r as createCausticsQuad, t as registerNodes3D, w as Camera3D } from "./register-BWFgsGra.js";
-import { n as enablePhysics3D } from "./physics-3d-DxFDfUey.js";
+import { F as PhysicsBody3D, R as Node3D, f as ModelInstance3D, m as DirectionalLight3D, r as createCausticsQuad, t as registerNodes3D, w as Camera3D } from "./register-BC55Ez6I.js";
+import { n as enablePhysics3D } from "./physics-3d-DHTZUrr0.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/index.js

@@ -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.20.0";
+const VERSION = "0.21.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/{physics-3d-DxFDfUey.js → physics-3d-DHTZUrr0.js}

@@ -1,7 +1,7 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { n as registerDebugSource } from "./debug-draw-CZmOYjL2.js";
-import { F as PhysicsBody3D, I as RigidBody3D, M as Joint3D, N as Area3D, O as Terrain3D, P as CharacterBody3D, R as Node3D, z as validateCollider3D } from "./register-BWFgsGra.js";
+import { F as PhysicsBody3D, I as RigidBody3D, M as Joint3D, N as Area3D, O as Terrain3D, P as CharacterBody3D, R as Node3D, z as validateCollider3D } from "./register-BC55Ez6I.js";
 import { Euler, Quaternion } from "three";
 //#region src/3d/physics/physics-3d.ts
 var physics_3d_exports = /* @__PURE__ */ __exportAll({

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-pNf3sI-Q.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-Ct86zczq.js").then((n) => n.n)).createGame2D(o)))(opts);
+			const next = await (_gameFactory ?? (mode === "3d" ? async (o) => (await import("./create-game-xbxZRFwR.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-Ct86zczq.js").then((n) => n.n)).createGame2D(o)))(opts);
 			if (disposed) {
 				next.dispose();
 				return;

package/dist/{register-BWFgsGra.js → register-BC55Ez6I.js}

@@ -6910,15 +6910,17 @@ function buildRiverRings(opts) {
 		const raw = bed[i];
 		descending[i] = i === 0 ? raw : Math.min(raw, descending[i - 1]);
 	}
-	const smoothed = descending.map((_, i) => {
+	const keep = Math.max(.5, opts.depth * 1.5);
+	const smoothed = descending.map((center, i) => {
 		let sum = 0;
 		let n = 0;
 		for (let k = -3; k <= PROFILE_SMOOTH; k++) {
-			const j = Math.min(Math.max(i + k, 0), descending.length - 1);
-			sum += descending[j];
+			const h = descending[Math.min(Math.max(i + k, 0), descending.length - 1)];
+			if (Math.abs(h - center) > keep) continue;
+			sum += h;
 			n++;
 		}
-		return sum / n;
+		return n > 0 ? sum / n : center;
 	});
 	const profile = new Array(smoothed.length);
 	for (let i = 0; i < smoothed.length; i++) {
@@ -7079,6 +7081,39 @@ function hitFrom(a, b, t, x, z, capped) {
 	};
 }
 /**
+* Find the waterfalls in a course: maximal runs of steep stations, reported at
+* the station where the water lands. Callers hang spray on these, and the
+* shader aerates the curtain from the same grade the detector reads — one
+* source of truth for "this is falling, not flowing".
+*/
+function detectFalls(rings, opts = {}) {
+	const minGrade = opts.minGrade ?? .45;
+	const minDrop = opts.minDrop ?? 1.2;
+	const out = [];
+	let start = -1;
+	for (let i = 0; i <= rings.length; i++) {
+		const steep = i < rings.length && rings[i].slope >= minGrade;
+		if (steep && start < 0) start = i;
+		if (steep || start < 0) continue;
+		const lip = rings[Math.max(0, start - 1)];
+		const base = rings[Math.min(rings.length - 1, i)];
+		const drop = lip.surfaceY - base.surfaceY;
+		if (drop >= minDrop) out.push({
+			x: base.x,
+			z: base.z,
+			topY: lip.surfaceY,
+			baseY: base.surfaceY,
+			drop,
+			halfWidth: base.halfWidth,
+			dirX: base.tx,
+			dirZ: base.tz,
+			speed: base.speed
+		});
+		start = -1;
+	}
+	return out;
+}
+/**
 * Trace where water would actually run from a point: repeated steepest descent
 * with momentum, so the line follows a valley floor instead of rattling between
 * its walls. Ends when the ground goes flat (a pool), the trace leaves the play
@@ -7225,7 +7260,10 @@ void main() {
 
   // hydraulic jump: in a chute the wave train stands still in the world (phase
   // on the downstream coordinate, NEVER scrolled) and only breathes in time
-  float chute = smoothstep(0.035, 0.16, grade) * smoothstep(0.6, 2.4, speed);
+  // standing waves belong to a RAPID: past ~20° the water has left the bed and
+  // a wave train on a falling curtain reads as a rippling flag
+  float chute = smoothstep(0.035, 0.16, grade) * smoothstep(0.6, 2.4, speed) *
+                (1.0 - smoothstep(0.35, 0.7, grade));
   float standing =
     sin(aFlowUv.x * 1.9 + sin(uTime * 0.7) * 0.35) * 0.6 +
     sin(aFlowUv.x * 3.6 + sin(uTime * 0.9) * 0.5) * 0.4;
@@ -7329,8 +7367,11 @@ void main() {
   vec3 ripB = riverRipple(base - vec2(travel * pB, 0.0));
   vec3 ripple = mix(ripA, ripB, blend);
 
-  float streakA = riverStreak(base * 0.55 - vec2(travel * pA * 0.55, 0.0));
-  float streakB = riverStreak(base * 0.55 - vec2(travel * pB * 0.55, 0.0));
+  // on a curtain the pattern stretches into strands: the same field, sampled
+  // with the downstream axis squeezed hard, is what reads as falling water
+  float streakScale = mix(0.55, 0.16, smoothstep(0.35, 0.9, grade));
+  float streakA = riverStreak(base * streakScale - vec2(travel * pA * streakScale, 0.0));
+  float streakB = riverStreak(base * streakScale - vec2(travel * pB * streakScale, 0.0));
   float streak = mix(streakA, streakB, blend);
 
   // ripples flatten out where the water thins to a film over the bed
@@ -7356,14 +7397,25 @@ void main() {
   // shallow is RELATIVE to this river: a hand's depth is a riffle in a brook
   // and nothing at all in a millrace, so the thresholds ride uMaxDepth
   float shallowT = column / max(uMaxDepth, 0.05);
-  float riffle = (1.0 - smoothstep(0.12, 0.42, shallowT)) * smoothstep(0.7, 2.2, speed);
-  float drive = clamp(rapids * 1.0 + bankShear * 0.35 + riffle * 0.5, 0.0, 1.3) * uFoam;
+  // a riffle needs water to break OVER something — a centimetres-thin film on
+  // a drying bar is a wet rock, and painting it white is what turns the tail of
+  // a creek into a bright sheet
+  float riffle =
+    smoothstep(0.04, 0.13, column) *
+    (1.0 - smoothstep(0.12, 0.42, shallowT)) *
+    smoothstep(0.7, 2.2, speed);
+  // FALLING, not flowing: past ~20° the sheet leaves the bed, shatters and
+  // aerates. Aerated water is a white DIFFUSE body — it stops mirroring the
+  // sky (that is the tell that separates a waterfall from a steep chute).
+  float fall = smoothstep(0.35, 0.9, grade);
+  float drive = clamp(rapids * 1.0 + bankShear * 0.35 + riffle * 0.5 + fall * 1.6, 0.0, 2.0) * uFoam;
   // COVERAGE is the thing to be strict about: whitewater is where the surface
   // has actually broken, and a river that fizzes everywhere reads as milk
   float foam = smoothstep(0.74 - 0.45 * drive, 1.02 - 0.24 * drive, streak) * min(drive, 1.0);
   // crest froth: the tops of standing waves in a real rapid always carry white
   foam = max(foam, smoothstep(0.68, 0.96, ripple.x) * smoothstep(0.4, 1.0, rapids) * uFoam * 0.5);
-  foam = clamp(foam, 0.0, 1.0);
+  // froth can never be more present than the water carrying it
+  foam = clamp(foam, 0.0, 1.0) * smoothstep(0.02, 0.14, column);
 
   // ── body ────────────────────────────────────────────────────────────────
   float depthT = clamp(column / max(uMaxDepth, 0.01), 0.0, 1.0);
@@ -7413,10 +7465,16 @@ void main() {
   spec *= 0.45 + 0.55 * glint * uSparkle;
   spec *= 1.0 - foam * 0.85; // froth is rough — it kills the mirror
 
+  fresnel *= 1.0 - 0.85 * fall; // froth scatters; it does not reflect
   vec3 color = mix(body, sky, fresnel);
   color += uSunColor * spec * 1.6;
   color = mix(color, uFoamColor, foam * 0.88);
 
+  // the LIP reads glassy-dark for a moment before the sheet breaks — the
+  // contrast against the white curtain below is most of the drop's drama
+  float lip = smoothstep(0.12, 0.32, grade) * (1.0 - smoothstep(0.32, 0.55, grade));
+  color = mix(color, color * 0.72, lip * 0.6);
+
   // ── edges ───────────────────────────────────────────────────────────────
   // the ribbon is built wider than the channel; what makes its outline is the
   // water running out, so bars and boulders cut it exactly like the ground does
@@ -7521,7 +7579,8 @@ var River3D = class River3D extends Node3D {
 		sunColor: { default: "#fff6e0" },
 		sunIntensity: { default: 1 },
 		terrain: { default: "" },
-		flowForce: { default: 1 }
+		flowForce: { default: 1 },
+		spray: { default: 1 }
 	};
 	/** Centerline control points `[[x, z], …]` in the node's local frame. */
 	path = [];
@@ -7557,9 +7616,17 @@ var River3D = class River3D extends Node3D {
 	terrain = "";
 	/** How hard the current sweeps bodies downstream (0 = visual only). */
 	flowForce = 1;
+	/**
+	* Mist at the foot of every waterfall the course contains: the node finds
+	* the drops itself (see {@link detectFalls}) and hangs a Particles3D plume
+	* on each, sized by how far the water falls. 0 = off.
+	*/
+	spray = 1;
 	renderOrder = 1;
 	time = 0;
 	rings = [];
+	falls = [];
+	sprayKey = "";
 	courseKey = "";
 	bedAt = null;
 	world = [
@@ -7585,6 +7652,7 @@ var River3D = class River3D extends Node3D {
 			"foam",
 			"ripples",
 			"flowForce",
+			"spray",
 			"sunIntensity"
 		]) {
 			const v = r[key];
@@ -7604,6 +7672,7 @@ var River3D = class River3D extends Node3D {
 	update(dt) {
 		this.time += dt;
 		this.ensureCourse();
+		this.syncSpray();
 		if (this.flowForce > 0 && this.rings.length > 1) this.sweepBodies(dt);
 	}
 	_syncObject3D() {
@@ -7627,6 +7696,21 @@ var River3D = class River3D extends Node3D {
 			surfaceY: hit.surfaceY + wy
 		} : null;
 	}
+	/**
+	* The waterfalls on this course — where the water stops flowing and starts
+	* falling, with the drop height and the plunge point in WORLD coordinates.
+	* Hang your own effects (sound, a rainbow, a hidden cave) on these.
+	*/
+	fallsAt() {
+		this.ensureCourse();
+		const [wx, wy, wz] = this.world;
+		return this.falls.map((f) => ({
+			...f,
+			worldX: f.x + wx,
+			worldY: f.baseY + wy,
+			worldZ: f.z + wz
+		}));
+	}
 	/** @internal The derived centerline stations (surface, grade, current). */
 	_rings() {
 		return this.rings;
@@ -7677,6 +7761,7 @@ var River3D = class River3D extends Node3D {
 		this.bedAt = null;
 		if (this.path.length < 2) {
 			this.rings = [];
+			this.falls = [];
 			return true;
 		}
 		const [wx, wy, wz] = world;
@@ -7691,6 +7776,7 @@ var River3D = class River3D extends Node3D {
 			step: Math.min(Math.max(narrow * STEP_PER_WIDTH, STEP_MIN), STEP_MAX),
 			bedAt: this.bedAt
 		});
+		this.falls = detectFalls(this.rings);
 		return true;
 	}
 	rebuildIfNeeded(mesh) {
@@ -7790,6 +7876,48 @@ var River3D = class River3D extends Node3D {
 		set("uSparkle", this.ripples);
 	}
 	/**
+	* Hang a mist plume on every fall. Runtime children (`__spray*`), rebuilt
+	* only when the course or the dial changes — a plume is a Particles3D, so it
+	* carries its own budget, culling and editor visibility for free.
+	*/
+	syncSpray() {
+		const key = this.spray > 0 ? `${this.spray}|${JSON.stringify(this.falls)}` : "";
+		if (key === this.sprayKey) return;
+		this.sprayKey = key;
+		for (const child of [...this.children]) if (child.name.startsWith("__spray")) child.free();
+		if (this.spray <= 0) return;
+		this.falls.forEach((fall, i) => {
+			const plume = new Particles3D(`__spray${i}`);
+			plume.position = [
+				fall.x + fall.dirX * .6,
+				fall.baseY + .15,
+				fall.z + fall.dirZ * .6
+			];
+			const power = Math.min(1.6, .4 + fall.drop * .12) * this.spray;
+			plume.rate = Math.round(Math.min(46, 10 + fall.drop * 3) * this.spray);
+			plume.maxParticles = 160;
+			plume.lifetime = [1, 2.1];
+			plume.speed = [55 * power, 170 * power];
+			plume.directionDeg = -90;
+			plume.spreadDeg = 58;
+			plume.gravity = [
+				0,
+				-240,
+				0
+			];
+			plume.drag = 1.2;
+			plume.sizeStart = 16 * power;
+			plume.sizeEnd = 80 * power;
+			plume.colorStart = "#ffffff";
+			plume.colorEnd = "#dfe9ec";
+			plume.alphaStart = .2;
+			plume.alphaEnd = 0;
+			plume.blend = "normal";
+			plume.depthTest = true;
+			this.addChild(plume);
+		});
+	}
+	/**
 	* Drag every body floating in the channel toward the water's own velocity.
 	* Drag rather than thrust: a raft accelerates until it matches the current
 	* and then coasts, and a swimmer can still fight across a slow ford.
@@ -11569,6 +11697,9 @@ uniform vec4 uRipples[8];
 uniform float uSwellAmplitude;
 uniform vec2 uSwellDir;
 uniform float uSwellWavelength;
+// incanto GERSTNER: 0 = the legacy height-only swell, 1 = maximum trochoid
+// pinch (crests narrow to a peak). Physical steepness, capped per train.
+uniform float uSwellSteepness;
 // incanto shore: the SWASH SURGE shares the shore-waves dial — a very long
 // slow bulge marching shoreward; ±9 cm of water height walks the waterline
 // meters up and down a gentle beach (the lapping runup).
@@ -11581,6 +11712,8 @@ uniform float uEdgeFadeOn;
 varying vec3 vNormal;
 varying vec3 vWorldPosition;
 varying vec4 vScreenPosition;
+// incanto GERSTNER: how far the surface has folded here (whitecap seed)
+varying float vFold;
 
 //	Simplex 3D Noise
 //	by Ian McEwan, Stefan Gustavson (https://github.com/stegu/webgl-noise)
@@ -11683,6 +11816,43 @@ float getSwell(vec2 p) {
        + swellWave(p, d3, uSwellWavelength * 0.31, uSwellAmplitude * 0.16, 1.8);
 }
 
+// incanto GERSTNER: the horizontal half of a swell. A height field can only
+// raise and lower water; a real wave train also DRAGS it toward the crest,
+// which is what makes crests narrow and troughs broad — the single strongest
+// tell of open ocean. The same derivatives give the JACOBIAN of the surface
+// map, and where that collapses the water is folding over itself: whitecaps
+// belong exactly there, not wherever the height happens to be high.
+//
+// Returns (pinch.x, pinch.z, fold) — fold is 1 where the surface folds.
+vec3 getSwellPinch(vec2 p) {
+  if (uSwellAmplitude <= 0.0 || uSwellSteepness <= 0.0) return vec3(0.0);
+  vec2 d1 = uSwellDir;
+  vec2 d2 = normalize(vec2(d1.x * 0.906 - d1.y * 0.423, d1.x * 0.423 + d1.y * 0.906));
+  vec2 d3 = normalize(vec2(d1.x * 0.946 + d1.y * 0.326, -d1.x * 0.326 + d1.y * 0.946));
+  vec2 pinch = vec2(0.0);
+  float jxx = 1.0;
+  float jzz = 1.0;
+  float jxz = 0.0;
+  // (direction, wavelength, amplitude) — the same three trains as getSwell
+  for (int i = 0; i < 3; i++) {
+    vec2 d = i == 0 ? d1 : (i == 1 ? d2 : d3);
+    float lambda = uSwellWavelength * (i == 0 ? 1.0 : (i == 1 ? 0.53 : 0.31));
+    float amp = uSwellAmplitude * (i == 0 ? 0.60 : (i == 1 ? 0.27 : 0.16));
+    float k = 6.2831853 / max(lambda, 1.0);
+    float c = sqrt(9.8 / k);
+    float phase = dot(p, d) * k - uTime * c * k;
+    // steepness per train, capped so the trochoid never loops back on itself
+    float q = min(uSwellSteepness / max(k * amp * 3.0, 1e-4), 1.0);
+    pinch -= d * (q * amp * cos(phase));
+    float f = q * amp * k * sin(phase);
+    jxx -= d.x * d.x * f;
+    jzz -= d.y * d.y * f;
+    jxz -= d.x * d.y * f;
+  }
+  float jacobian = jxx * jzz - jxz * jxz;
+  return vec3(pinch, 1.0 - smoothstep(0.15, 0.75, jacobian));
+}
+
 // incanto: waves + swell + ripples — used for displacement AND the normal
 // samples so every layer catches the light like real waves.
 // incanto shore: two incommensurate long surges — the waterline breathes in
@@ -11704,6 +11874,13 @@ void main() {
 
   float elevation = getHeight(modelPosition.x, modelPosition.z);
   modelPosition.y += elevation;
+  // Gerstner pinch: the height field is sampled at the UNDISPLACED position
+  // (so the analytic finite-difference normals below stay consistent), then
+  // the surface is dragged horizontally toward its crests. At the steepness
+  // this ships the normal error is far under the detail-normal layers.
+  vec3 pinch = getSwellPinch(modelPosition.xz);
+  modelPosition.xz += pinch.xy;
+  vFold = pinch.z;
 
   // Height adjustment to smooth water edges
   // Lower water height as it approaches scale boundaries
@@ -11836,6 +12013,8 @@ uniform float uEdgeWidth;
 varying vec3 vNormal;
 varying vec3 vWorldPosition;
 varying vec4 vScreenPosition;
+// incanto GERSTNER: how far the surface has folded here (whitecap seed)
+varying float vFold;
 
 uniform samplerCube uEnvironmentMap;
 // incanto MIRROR: a planar reflection rendered from the camera mirrored across
@@ -12493,6 +12672,10 @@ void main() {
     float capNoise = noise(capUV * 2.2 + uTime * vec2(0.10, 0.06)) * 0.65
                    + noise(capUV * 6.5 - uTime * vec2(0.05, 0.14)) * 0.35;
     float capFade = 1.0 - smoothstep(220.0, 640.0, camDist);
+    // height says WHERE the crest is; the Jacobian says where it is actually
+    // breaking. Taking the max keeps the tuned height-based caps and adds the
+    // ones physics insists on — the pinched crest faces about to spill.
+    cap = max(cap, vFold);
     float whitecap = uWhitecaps * cap * smoothstep(0.42, 0.78, capNoise) * capFade;
     foamAmount = max(foamAmount, whitecap);
   }
@@ -13009,6 +13192,7 @@ var Water3D = class Water3D extends Node3D {
 		reflection: { default: true },
 		reflectionInterval: { default: 1e3 },
 		mirror: { default: false },
+		swellSteepness: { default: .35 },
 		foam: { default: true },
 		interaction: { default: true },
 		splash: { default: true },
@@ -13107,6 +13291,13 @@ var Water3D = class Water3D extends Node3D {
 	swellDirectionDeg = 0;
 	/** Primary swell wavelength in meters (the two crossing trains derive). */
 	swellWavelength = 30;
+	/**
+	* GERSTNER pinch on the swell: 0 keeps the legacy height-only trains, 1 is
+	* maximum trochoid (crests narrow to a peak, troughs go broad). It also
+	* decides where whitecaps break — the surface's Jacobian collapses on a
+	* folding crest, and that is where foam belongs.
+	*/
+	swellSteepness = .35;
 	/** Open-water whitecap foam on the tallest crests, 0–1 (fancy only). Works
 	* best with `swell` — the caps ride the swell's crest lines. */
 	whitecaps = 0;
@@ -13509,6 +13700,7 @@ var Water3D = class Water3D extends Node3D {
 				uSwellAmplitude: { value: this.rp("swell") },
 				uSwellDir: { value: new Vector2(0, 1) },
 				uSwellWavelength: { value: this.rp("swellWavelength") },
+				uSwellSteepness: { value: this.rp("swellSteepness") },
 				uWhitecaps: { value: this.rp("whitecaps") },
 				uWaveEnvelope: { value: 0 },
 				uCausticsAbove: { value: this.rp("causticsAbove") },
@@ -13578,6 +13770,7 @@ var Water3D = class Water3D extends Node3D {
 		if (u.uAbsorption) u.uAbsorption.value = this.rp("absorption");
 		if (u.uSwellAmplitude) u.uSwellAmplitude.value = this.rp("swell");
 		if (u.uSwellWavelength) u.uSwellWavelength.value = this.rp("swellWavelength");
+		if (u.uSwellSteepness) u.uSwellSteepness.value = this.rp("swellSteepness");
 		if (u.uWhitecaps) u.uWhitecaps.value = this.rp("whitecaps");
 		if (u.uCausticsAbove) u.uCausticsAbove.value = this.rp("causticsAbove");
 		if (u.uShoreWaves) u.uShoreWaves.value = this.rp("shoreWaves");

package/dist/test.js

@@ -6,7 +6,7 @@ import { n as jsonEquals, t as jsonClone } from "./json-BLk7H2Qa.js";
 import { i as getNodeSchema, s as mergeStaticProps } from "./registry-BVJ2HbCn.js";
 import { n as registerGameplayBehaviors } from "./gameplay-sSqrUcnz.js";
 import { t as registerNodes2D } from "./register-Djwckzgx.js";
-import { t as registerNodes3D } from "./register-BWFgsGra.js";
+import { t as registerNodes3D } from "./register-BC55Ez6I.js";
 import { t as registerNodesNet } from "./register-BFFE1Mh1.js";
 //#region src/test/index.ts
 /**
@@ -127,7 +127,7 @@ async function runScript(json, opts) {
 		const { enablePhysics2D } = await import("./physics-2d-BiIdl51r.js").then((n) => n.r);
 		await enablePhysics2D(engine);
 	} else if (physics === "3d" || physics === "auto" && scene.dimension === "3d") {
-		const { enablePhysics3D } = await import("./physics-3d-DxFDfUey.js").then((n) => n.r);
+		const { enablePhysics3D } = await import("./physics-3d-DHTZUrr0.js").then((n) => n.r);
 		await enablePhysics3D(engine);
 	}
 	const failures = [];
@@ -232,7 +232,7 @@ async function createPlaySession(json, opts = {}) {
 		const { enablePhysics2D } = await import("./physics-2d-BiIdl51r.js").then((n) => n.r);
 		await enablePhysics2D(engine);
 	} else if (physics === "3d" || physics === "auto" && scene.dimension === "3d") {
-		const { enablePhysics3D } = await import("./physics-3d-DxFDfUey.js").then((n) => n.r);
+		const { enablePhysics3D } = await import("./physics-3d-DHTZUrr0.js").then((n) => n.r);
 		await enablePhysics3D(engine);
 	}
 	const stepMs = 1e3 / (opts.fixedHz ?? 60);

package/editor/assets/{agent8-BZX7dF4f.js → agent8-Cdd8g6w6.js}

@@ -1 +1 @@
-import{t as e}from"./index-CXdpxO_B.js";async function t(t){return new n((await e(()=>import(`./GameServer-C56iOUgF.js`),[],import.meta.url)).GameServer,t)}var n=class{raw;active=new Map;reconnecting=!1;disposed=!1;constructor(e,t){this.raw=new e({...t})}get account(){return this.raw.account}get connected(){return this.raw.connected}connect(){return this.raw.connected?Promise.resolve(!0):(this.disposed=!1,this.rawConnect())}rawConnect(){return this.raw.connect({onDisconnect:()=>void this.reconnect()})}disconnect(){this.disposed=!0;for(let e of this.active.values())e.off();return this.active.clear(),this.raw.disconnect()}remoteFunction(e,t,n){return this.raw.remoteFunction(e,t,n)}track(e){let t=Symbol(`sub`),n={make:e,off:e()};return this.active.set(t,n),()=>{n.off(),this.active.delete(t)}}async reconnect(){if(!this.disposed&&!this.reconnecting){this.reconnecting=!0;try{await this.rawConnect();for(let e of this.active.values())e.off(),e.off=e.make()}finally{this.reconnecting=!1}}}subscribeRoomState(e,t){return this.track(()=>this.raw.subscribeRoomState(e,t))}subscribeRoomMyState(e,t){return this.track(()=>this.raw.subscribeRoomMyState(e,t))}subscribeRoomAllUserStates(e,t){return this.track(()=>this.raw.subscribeRoomAllUserStates(e,e=>{let n={};for(let t of e??[]){if(!t||typeof t.account!=`string`||t.__leaved)continue;let{account:e,__updated:r,__leaved:i,...a}=t;n[e]=a}t(n)}))}subscribeRoomCollection(e,t,n){return this.track(()=>this.raw.subscribeRoomCollection(e,t,({items:e})=>{let t={};for(let n of e??[])n&&typeof n.__id==`string`&&(t[n.__id]=n);n(t)}))}onRoomMessage(e,t,n){return this.track(()=>this.raw.onRoomMessage(e,t,n))}onRoomUserJoin(e,t){return this.track(()=>this.raw.onRoomUserJoin(e,t))}onRoomUserLeave(e,t){return this.track(()=>this.raw.onRoomUserLeave(e,t))}subscribeGlobalState(e){return this.track(()=>this.raw.subscribeGlobalState(e))}subscribeGlobalMyState(e){return this.track(()=>this.raw.subscribeGlobalMyState(e))}subscribeGlobalUserState(e,t){return this.track(()=>this.raw.subscribeGlobalUserState(e,t))}subscribeGlobalCollection(e,t){return this.track(()=>this.raw.subscribeGlobalCollection(e,({items:e})=>{let n={};for(let t of e??[])t&&typeof t.__id==`string`&&(n[t.__id]=t);t(n)}))}subscribeAsset(e,t){return this.track(()=>this.raw.subscribeAsset(e,t))}onGlobalMessage(e,t){return this.track(()=>this.raw.onGlobalMessage(e,t))}};export{t as createAgent8Server};
+import{t as e}from"./index-Dt44Z9ka.js";async function t(t){return new n((await e(()=>import(`./GameServer-C56iOUgF.js`),[],import.meta.url)).GameServer,t)}var n=class{raw;active=new Map;reconnecting=!1;disposed=!1;constructor(e,t){this.raw=new e({...t})}get account(){return this.raw.account}get connected(){return this.raw.connected}connect(){return this.raw.connected?Promise.resolve(!0):(this.disposed=!1,this.rawConnect())}rawConnect(){return this.raw.connect({onDisconnect:()=>void this.reconnect()})}disconnect(){this.disposed=!0;for(let e of this.active.values())e.off();return this.active.clear(),this.raw.disconnect()}remoteFunction(e,t,n){return this.raw.remoteFunction(e,t,n)}track(e){let t=Symbol(`sub`),n={make:e,off:e()};return this.active.set(t,n),()=>{n.off(),this.active.delete(t)}}async reconnect(){if(!this.disposed&&!this.reconnecting){this.reconnecting=!0;try{await this.rawConnect();for(let e of this.active.values())e.off(),e.off=e.make()}finally{this.reconnecting=!1}}}subscribeRoomState(e,t){return this.track(()=>this.raw.subscribeRoomState(e,t))}subscribeRoomMyState(e,t){return this.track(()=>this.raw.subscribeRoomMyState(e,t))}subscribeRoomAllUserStates(e,t){return this.track(()=>this.raw.subscribeRoomAllUserStates(e,e=>{let n={};for(let t of e??[]){if(!t||typeof t.account!=`string`||t.__leaved)continue;let{account:e,__updated:r,__leaved:i,...a}=t;n[e]=a}t(n)}))}subscribeRoomCollection(e,t,n){return this.track(()=>this.raw.subscribeRoomCollection(e,t,({items:e})=>{let t={};for(let n of e??[])n&&typeof n.__id==`string`&&(t[n.__id]=n);n(t)}))}onRoomMessage(e,t,n){return this.track(()=>this.raw.onRoomMessage(e,t,n))}onRoomUserJoin(e,t){return this.track(()=>this.raw.onRoomUserJoin(e,t))}onRoomUserLeave(e,t){return this.track(()=>this.raw.onRoomUserLeave(e,t))}subscribeGlobalState(e){return this.track(()=>this.raw.subscribeGlobalState(e))}subscribeGlobalMyState(e){return this.track(()=>this.raw.subscribeGlobalMyState(e))}subscribeGlobalUserState(e,t){return this.track(()=>this.raw.subscribeGlobalUserState(e,t))}subscribeGlobalCollection(e,t){return this.track(()=>this.raw.subscribeGlobalCollection(e,({items:e})=>{let n={};for(let t of e??[])t&&typeof t.__id==`string`&&(n[t.__id]=t);t(n)}))}subscribeAsset(e,t){return this.track(()=>this.raw.subscribeAsset(e,t))}onGlobalMessage(e,t){return this.track(()=>this.raw.onGlobalMessage(e,t))}};export{t as createAgent8Server};