incanto 0.13.0 → 0.15.0

package/dist/3d.d.ts

@@ -888,9 +888,13 @@ declare class Flowers3D extends Node3D {
   clustering: number;
   /** Gentle head-bob wind strength — 0 holds still. */
   sway: number;
-  /** Drape each plant onto a Terrain3D's surface so flowers root on the ground
-  * instead of a flat plane (lets ONE bed cover rolling terrain). */
-  drape: boolean;
+  /**
+  * null (the default) is AUTO: whenever the scene has a Terrain3D, instances
+  * root on it — flat ground behaves as before, rolling terrain just works.
+  * true forces it (keeps retrying until a terrain appears), false disables
+  * draping entirely.
+  */
+  drape: boolean | null;
   /** Drape target: a node path to the Terrain3D. Empty = auto-find the first
   * Terrain3D in the tree (the zero-config default when `drape` is on). */
   terrain: string;
@@ -1025,9 +1029,14 @@ declare class Foliage3D extends Node3D implements SunConsumer3D {
   flowers: number;
   /** Placement seed — the field is identical across runs and machines. */
   seed: number;
-  /** Drape each instance onto a Terrain3D's surface so blades root on the
-  * ground instead of a flat plane (lets ONE field cover rolling terrain). */
-  drape: boolean;
+  /**
+  * Drape each instance onto a Terrain3D's surface so blades root on the
+  * ground instead of a flat plane. null (the default) is AUTO: whenever the
+  * scene has a Terrain3D, instances root on it — flat ground behaves as
+  * before, rolling terrain just works. true forces it (keeps retrying until
+  * a terrain appears), false disables draping entirely.
+  */
+  drape: boolean | null;
   /** Drape target: a node path to the Terrain3D. Empty = auto-find the first
   * Terrain3D in the tree (the zero-config default when `drape` is on). */
   terrain: string;
@@ -1061,6 +1070,8 @@ declare class Foliage3D extends Node3D implements SunConsumer3D {
   /** @internal Every InstancedMesh of the field: [quads] or [quads, quads90°]. */
   _fields(): InstancedMesh[];
   override update(dt: number): void;
+  /** Wind time/strength + the ≤4 character-bend slots (no-op before first build). */
+  private writeAnimationUniforms;
   override _syncObject3D(): void;
   /**
   * @internal Environment-sky sun hand-off (see {@link SunConsumer3D}): the
@@ -1821,11 +1832,14 @@ declare class Tree3D extends Node3D {
   /** Let leaves cast shadows. false keeps trunk/branch shadows but drops the
   * expensive alpha-cutout leaf shadow pass (the dappled floor) for big FPS. */
   leafShadows: boolean;
-  /** Drape the grove over a Terrain3D: each scattered instance roots at the
-  * ground height under it (not the node's single Y), so a patch on rolling or
-  * carved terrain never floats/buries. No effect on a count:1 tree placed by
-  * hand unless it sits off the ground. */
-  drape: boolean;
+  /**
+  * Drape the grove over a Terrain3D: each scattered instance roots at the
+  * ground height under it (not the node's single Y), so a patch on rolling
+  * or carved terrain never floats/buries. null (the default) is AUTO:
+  * whenever the scene has a Terrain3D the grove drapes onto it. true forces
+  * it (keeps retrying until a terrain appears), false disables draping.
+  */
+  drape: boolean | null;
   /** Node path to the Terrain3D to drape onto ('' = auto-find the first one). */
   terrain: string;
   /** Resolved drape target + the grove's world position, set per rebuild. */
@@ -2029,6 +2043,21 @@ declare class Water3D extends Node3D implements RenderHook3D, SunConsumer3D {
   * `{ color?, visibility? }` overrides the fog hue / view distance (meters).
   */
   underwater: boolean | JsonObject;
+  /**
+  * Directional traveling SWELL amplitude in meters (fancy only; 0 = off, the
+  * legacy isotropic look). Three peaked wave trains march across the surface
+  * at real deep-water speeds — THE open-ocean dial: 0.15 = lively lake chop,
+  * 0.4 = coastal sea, 0.8 = heavy weather. Crests feed the color ramp,
+  * `whitecaps` and the shore foam automatically.
+  */
+  swell: number;
+  /** Compass direction the swell TRAVELS toward, degrees (0 = +z, 90 = +x). */
+  swellDirectionDeg: number;
+  /** Primary swell wavelength in meters (the two crossing trains derive). */
+  swellWavelength: 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;
   /** Loader hook: degenerate planes and bad enums fail at LOAD, not at render. */
   static validateJson(node: Node): void;
   private time;

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-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 { 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-BS-K-GY1.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-Bh_3Z39N.js";
 import { n as splatWeights, t as buildHeightmap } from "./heightmap-CroQPEER.js";
-import { n as enablePhysics3D, t as Physics3D } from "./physics-3d-DhaAaKJo.js";
+import { n as enablePhysics3D, t as Physics3D } from "./physics-3d-TmOuCy7J.js";
 //#region src/3d/environment-runtime.ts
 /**
 * Live environment editing — the renderer re-applies `scene.environment`

package/dist/{create-game-J6g4QInv.js → create-game-BS-K-GY1.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 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 { F as Node3D, M as PhysicsBody3D, d as DirectionalLight3D, l as ModelInstance3D, t as registerNodes3D, x as Camera3D } from "./register-Bh_3Z39N.js";
+import { n as enablePhysics3D } from "./physics-3d-TmOuCy7J.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.13.0";
+const VERSION = "0.15.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-DhaAaKJo.js → physics-3d-TmOuCy7J.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 { A as Area3D, F as Node3D, I as validateCollider3D, M as PhysicsBody3D, N as RigidBody3D, T as Terrain3D, j as CharacterBody3D, k as Joint3D } from "./register-BFw4c83z.js";
+import { A as Area3D, F as Node3D, I as validateCollider3D, M as PhysicsBody3D, N as RigidBody3D, T as Terrain3D, j as CharacterBody3D, k as Joint3D } from "./register-Bh_3Z39N.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-J6g4QInv.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-BS-K-GY1.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-BFw4c83z.js → register-Bh_3Z39N.js}

@@ -3066,7 +3066,7 @@ var Flowers3D = class extends Node3D {
 		height: { default: .45 },
 		clustering: { default: .6 },
 		sway: { default: .5 },
-		drape: { default: false },
+		drape: { default: null },
 		terrain: { default: "" }
 	};
 	/** 'lush' | 'sparse' | 'none' | plants per m² (load-time check + budget). */
@@ -3087,9 +3087,13 @@ var Flowers3D = class extends Node3D {
 	clustering = .6;
 	/** Gentle head-bob wind strength — 0 holds still. */
 	sway = .5;
-	/** Drape each plant onto a Terrain3D's surface so flowers root on the ground
-	* instead of a flat plane (lets ONE bed cover rolling terrain). */
-	drape = false;
+	/**
+	* null (the default) is AUTO: whenever the scene has a Terrain3D, instances
+	* root on it — flat ground behaves as before, rolling terrain just works.
+	* true forces it (keeps retrying until a terrain appears), false disables
+	* draping entirely.
+	*/
+	drape = null;
 	/** Drape target: a node path to the Terrain3D. Empty = auto-find the first
 	* Terrain3D in the tree (the zero-config default when `drape` is on). */
 	terrain = "";
@@ -3119,7 +3123,7 @@ var Flowers3D = class extends Node3D {
 		if (!(f.height > 0)) throw new IncantoError("BAD_FORMAT", `Flowers3D '${node.name}' height must be > 0 meters, got ${f.height}.`, { prop: "height" });
 		if (!(f.clustering >= 0) || !(f.clustering <= 1)) throw new IncantoError("BAD_FORMAT", `Flowers3D '${node.name}' clustering must be in [0, 1] (0 uniform … 1 tight patches), got ${f.clustering}.`, { prop: "clustering" });
 		if (!(f.sway >= 0)) throw new IncantoError("BAD_FORMAT", `Flowers3D '${node.name}' sway must be >= 0, got ${f.sway}.`, { prop: "sway" });
-		if (typeof f.drape !== "boolean") throw new IncantoError("BAD_FORMAT", `Flowers3D '${node.name}' drape must be a boolean, got ${JSON.stringify(f.drape)}.`, { prop: "drape" });
+		if (f.drape !== null && typeof f.drape !== "boolean") throw new IncantoError("BAD_FORMAT", `Flowers3D '${node.name}' drape must be true, false or null (null = auto: drape whenever the scene has a Terrain3D), got ${JSON.stringify(f.drape)}.`, { prop: "drape" });
 		if (typeof f.terrain !== "string") throw new IncantoError("BAD_FORMAT", `Flowers3D '${node.name}' terrain must be a node-path string (empty = auto-find), got ${JSON.stringify(f.terrain)}.`, { prop: "terrain" });
 	}
 	time = 0;
@@ -3172,7 +3176,7 @@ var Flowers3D = class extends Node3D {
 	/** Resolve the drape target + cache the bed's world position for `bedY`. */
 	resolveDrape() {
 		this.drapeTerrain = null;
-		if (!this.drape) return;
+		if (this.drape === false) return;
 		const terrain = findDrapeTerrain(this, this.terrain);
 		if (terrain) {
 			this.drapeTerrain = terrain;
@@ -4449,7 +4453,7 @@ var Foliage3D = class Foliage3D extends Node3D {
 		coverage: { default: .85 },
 		flowers: { default: 0 },
 		seed: { default: 1 },
-		drape: { default: false },
+		drape: { default: null },
 		terrain: { default: "" },
 		renderOrder: { default: 2 }
 	};
@@ -4508,9 +4512,14 @@ var Foliage3D = class Foliage3D extends Node3D {
 	flowers = 0;
 	/** Placement seed — the field is identical across runs and machines. */
 	seed = 1;
-	/** Drape each instance onto a Terrain3D's surface so blades root on the
-	* ground instead of a flat plane (lets ONE field cover rolling terrain). */
-	drape = false;
+	/**
+	* Drape each instance onto a Terrain3D's surface so blades root on the
+	* ground instead of a flat plane. null (the default) is AUTO: whenever the
+	* scene has a Terrain3D, instances root on it — flat ground behaves as
+	* before, rolling terrain just works. true forces it (keeps retrying until
+	* a terrain appears), false disables draping entirely.
+	*/
+	drape = null;
 	/** Drape target: a node path to the Terrain3D. Empty = auto-find the first
 	* Terrain3D in the tree (the zero-config default when `drape` is on). */
 	terrain = "";
@@ -4544,7 +4553,7 @@ var Foliage3D = class Foliage3D extends Node3D {
 		if (!Array.isArray(sun) || sun.length !== 3 || !sun.every((v) => Number.isFinite(v)) || Math.hypot(sun[0] ?? 0, sun[1] ?? 0, sun[2] ?? 0) === 0) throw new IncantoError("BAD_FORMAT", `Foliage3D '${node.name}' sunDirection must be a non-zero [x, y, z] vector, got ${JSON.stringify(sun)}.`, { prop: "sunDirection" });
 		if (!(f.coverage > 0) || !(f.coverage <= 1)) throw new IncantoError("BAD_FORMAT", `Foliage3D '${node.name}' coverage must be in (0, 1] (carpet fill — 1 is solid, lower carves dirt patches), got ${f.coverage}.`, { prop: "coverage" });
 		if (!(f.flowers >= 0) || !(f.flowers <= .2)) throw new IncantoError("BAD_FORMAT", `Foliage3D '${node.name}' flowers must be in [0, 0.2] (fraction of instances rendered as flower heads — for a whole flower FIELD use kind: 'flowers'), got ${f.flowers}.`, { prop: "flowers" });
-		if (typeof f.drape !== "boolean") throw new IncantoError("BAD_FORMAT", `Foliage3D '${node.name}' drape must be a boolean, got ${JSON.stringify(f.drape)}.`, { prop: "drape" });
+		if (f.drape !== null && typeof f.drape !== "boolean") throw new IncantoError("BAD_FORMAT", `Foliage3D '${node.name}' drape must be true, false or null (null = auto: drape whenever the scene has a Terrain3D), got ${JSON.stringify(f.drape)}.`, { prop: "drape" });
 		if (typeof f.terrain !== "string") throw new IncantoError("BAD_FORMAT", `Foliage3D '${node.name}' terrain must be a node-path string (empty = auto-find), got ${JSON.stringify(f.terrain)}.`, { prop: "terrain" });
 	}
 	time = 0;
@@ -4590,16 +4599,33 @@ var Foliage3D = class Foliage3D extends Node3D {
 	update(dt) {
 		this.time += dt;
 		this.pickedBenders = this.computeBenders();
+		this.writeAnimationUniforms();
+	}
+	/** Wind time/strength + the ≤4 character-bend slots (no-op before first build). */
+	writeAnimationUniforms() {
+		if (this.isShaderField && this.bladesMaterial) {
+			const u = this.bladesMaterial.uniforms;
+			if (u.time) u.time.value = this.time;
+			if (u.windStrength) u.windStrength.value = this.sway * (this.isMesh ? MESH_SWAY_TO_WIND : SWAY_TO_WIND);
+			const slots = this.benderSlots;
+			if (slots) for (let i = 0; i < 4; i++) {
+				const b = this.pickedBenders[i];
+				if (b) slots[i]?.set(b.x, b.y, b.z, b.radius);
+				else slots[i]?.set(0, 0, 0, 0);
+			}
+		} else if (this.isTufts) {
+			if (this.tuftTime) this.tuftTime.value = this.time;
+			if (this.tuftStrength) this.tuftStrength.value = this.sway * TUFT_SWAY_TO_WIND;
+		}
 	}
 	_syncObject3D() {
 		super._syncObject3D();
 		this.rebuildIfNeeded();
 		const pivot = this.pivot;
+		this.writeAnimationUniforms();
 		if (this.isShaderField) {
 			pivot.matrix.identity();
 			const u = this.bladesMaterial.uniforms;
-			if (u.time) u.time.value = this.time;
-			if (u.windStrength) u.windStrength.value = this.sway * (this.isMesh ? MESH_SWAY_TO_WIND : SWAY_TO_WIND);
 			(u.bottomColor?.value).set(this.colorA);
 			(u.topColor?.value).set(this.colorB);
 			if (this.isMesh) {
@@ -4608,17 +4634,8 @@ var Foliage3D = class Foliage3D extends Node3D {
 				if (u.fadeStart) u.fadeStart.value = this.fadeStart;
 				if (u.fadeEnd) u.fadeEnd.value = this.fadeEnd;
 			}
-			const slots = this.benderSlots;
-			for (let i = 0; i < 4; i++) {
-				const b = this.pickedBenders[i];
-				if (b) slots[i]?.set(b.x, b.y, b.z, b.radius);
-				else slots[i]?.set(0, 0, 0, 0);
-			}
-		} else if (this.isTufts) {
-			pivot.matrix.identity();
-			if (this.tuftTime) this.tuftTime.value = this.time;
-			if (this.tuftStrength) this.tuftStrength.value = this.sway * TUFT_SWAY_TO_WIND;
-		} else if (this.sway > 0) {
+		} else if (this.isTufts) pivot.matrix.identity();
+		else if (this.sway > 0) {
 			const leanX = Math.sin(this.time * 1.7) * SWAY_LEAN * this.sway;
 			const leanZ = Math.sin(this.time * 1.3 + 1.7) * SWAY_LEAN * this.sway * .6;
 			pivot.matrix.makeShear(0, 0, leanX, leanZ, 0, 0);
@@ -4645,7 +4662,7 @@ var Foliage3D = class Foliage3D extends Node3D {
 	computeBenders() {
 		if (!this.interaction || !this.isShaderField) return [];
 		const [fx, fy, fz] = worldXZY(this);
-		if (this.drape && !this.drapeTerrain) this.resolveDrape();
+		if (this.drape === true && !this.drapeTerrain) this.resolveDrape();
 		const terrain = this.drapeTerrain;
 		const candidates = [];
 		for (const b of movingBodiesFor(this)) {
@@ -4706,7 +4723,7 @@ var Foliage3D = class Foliage3D extends Node3D {
 	/** Resolve the drape target + cache the field's world position for `bedY`. */
 	resolveDrape() {
 		this.drapeTerrain = null;
-		if (!this.drape) return;
+		if (this.drape === false) return;
 		const terrain = findDrapeTerrain(this, this.terrain);
 		if (terrain) {
 			this.drapeTerrain = terrain;
@@ -8411,7 +8428,7 @@ var Tree3D = class Tree3D extends Node3D {
 		leafFadeStart: { default: 0 },
 		leafFadeEnd: { default: 0 },
 		leafShadows: { default: true },
-		drape: { default: false },
+		drape: { default: null },
 		terrain: { default: "" }
 	};
 	/** 'simple' (primitive low-poly) | 'medium' (light ez-trees) | 'high' (full). */
@@ -8440,11 +8457,14 @@ var Tree3D = class Tree3D extends Node3D {
 	/** Let leaves cast shadows. false keeps trunk/branch shadows but drops the
 	* expensive alpha-cutout leaf shadow pass (the dappled floor) for big FPS. */
 	leafShadows = true;
-	/** Drape the grove over a Terrain3D: each scattered instance roots at the
-	* ground height under it (not the node's single Y), so a patch on rolling or
-	* carved terrain never floats/buries. No effect on a count:1 tree placed by
-	* hand unless it sits off the ground. */
-	drape = false;
+	/**
+	* Drape the grove over a Terrain3D: each scattered instance roots at the
+	* ground height under it (not the node's single Y), so a patch on rolling
+	* or carved terrain never floats/buries. null (the default) is AUTO:
+	* whenever the scene has a Terrain3D the grove drapes onto it. true forces
+	* it (keeps retrying until a terrain appears), false disables draping.
+	*/
+	drape = null;
 	/** Node path to the Terrain3D to drape onto ('' = auto-find the first one). */
 	terrain = "";
 	/** Resolved drape target + the grove's world position, set per rebuild. */
@@ -8463,7 +8483,7 @@ var Tree3D = class Tree3D extends Node3D {
 		if (!((t.area[0] ?? 0) > 0) || !((t.area[1] ?? 0) > 0)) throw new IncantoError("BAD_FORMAT", `Tree3D '${node.name}' area must be positive [x, z] meters, got ${JSON.stringify(t.area)}.`, { prop: "area" });
 		if (t.leafFadeEnd !== 0 && !(t.leafFadeEnd > t.leafFadeStart && t.leafFadeStart >= 0)) throw new IncantoError("BAD_FORMAT", `Tree3D '${node.name}' needs leafFadeEnd > leafFadeStart >= 0 (the leaf LOD window) or 0/0 to disable, got start ${t.leafFadeStart}, end ${t.leafFadeEnd}.`, { prop: "leafFadeStart" });
 		if (typeof t.leafShadows !== "boolean") throw new IncantoError("BAD_FORMAT", `Tree3D '${node.name}' leafShadows must be a boolean, got ${JSON.stringify(t.leafShadows)}.`, { prop: "leafShadows" });
-		if (typeof t.drape !== "boolean") throw new IncantoError("BAD_FORMAT", `Tree3D '${node.name}' drape must be a boolean, got ${JSON.stringify(t.drape)}.`, { prop: "drape" });
+		if (t.drape !== null && typeof t.drape !== "boolean") throw new IncantoError("BAD_FORMAT", `Tree3D '${node.name}' drape must be true, false or null (null = auto: drape whenever the scene has a Terrain3D), got ${JSON.stringify(t.drape)}.`, { prop: "drape" });
 		if (typeof t.terrain !== "string") throw new IncantoError("BAD_FORMAT", `Tree3D '${node.name}' terrain must be a node-path string (empty = auto-find), got ${JSON.stringify(t.terrain)}.`, { prop: "terrain" });
 		if (t.tier === "simple") return;
 		const perTree = maxVariantTriangles(t.tier, t.type);
@@ -8540,7 +8560,7 @@ var Tree3D = class Tree3D extends Node3D {
 	/** Resolve the drape target + cache the grove's world position for `bedY`. */
 	resolveDrape() {
 		this.drapeTerrain = null;
-		if (!this.drape) return;
+		if (this.drape === false) return;
 		const terrain = findDrapeTerrain(this, this.terrain);
 		if (terrain) {
 			this.drapeTerrain = terrain;
@@ -10324,6 +10344,11 @@ uniform vec3 uScale;
 // incanto: world-anchor + interaction ripples (x, z, age, amplitude)
 uniform vec3 uWaterCenter;
 uniform vec4 uRipples[8];
+// incanto swell: directional traveling wave trains (0 = off — legacy look).
+// uSwellDir is a unit XZ vector; amplitude in meters; wavelength in meters.
+uniform float uSwellAmplitude;
+uniform vec2 uSwellDir;
+uniform float uSwellWavelength;
 
 varying vec3 vNormal;
 varying vec3 vWorldPosition;
@@ -10406,10 +10431,34 @@ float getRippleHeight(vec2 p) {
   return h;
 }
 
-// incanto: waves + ripples — used for displacement AND the normal samples
-// so interaction rings catch the light like real waves.
+// incanto swell: one peaked traveling wave train. Deep-water dispersion
+// (c = sqrt(g/k)) gives each wavelength its REAL speed, so short chop
+// overtakes long swell exactly like the open sea. The pow-shaped profile
+// sharpens crests and flattens troughs (a height-only Gerstner stand-in —
+// no XZ pinch, so the analytic finite-difference normals stay exact).
+float swellWave(vec2 p, vec2 dir, float lambda, float amp, float sharp) {
+  float k = 6.2831853 / max(lambda, 1.0);
+  float c = sqrt(9.8 / k);
+  float s = 0.5 + 0.5 * sin(dot(p, dir) * k - uTime * c * k);
+  return amp * (pow(s, sharp) * 2.0 - 1.0);
+}
+
+// incanto swell: three trains — the primary + two shorter crossing sets
+// (+25° / −19°) so crest lines stay broken and organic, never a zebra field.
+float getSwell(vec2 p) {
+  if (uSwellAmplitude <= 0.0) return 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));
+  return swellWave(p, d1, uSwellWavelength,        uSwellAmplitude * 0.60, 2.6)
+       + swellWave(p, d2, uSwellWavelength * 0.53, uSwellAmplitude * 0.27, 2.2)
+       + swellWave(p, d3, uSwellWavelength * 0.31, uSwellAmplitude * 0.16, 1.8);
+}
+
+// incanto: waves + swell + ripples — used for displacement AND the normal
+// samples so every layer catches the light like real waves.
 float getHeight(float x, float z) {
-  return getElevation(x, z) + getRippleHeight(vec2(x, z));
+  return getElevation(x, z) + getSwell(vec2(x, z)) + getRippleHeight(vec2(x, z));
 }
 
 void main() {
@@ -10518,6 +10567,15 @@ uniform vec4 uRipples[8];
 uniform float uRippleFoam[8];
 uniform float uSplashFoam;
 
+// incanto swell: open-water WHITECAPS — foam breaking on the highest crests,
+// independent of the shoreline depth mask. uWaveEnvelope is the JS-computed
+// total wave amplitude (FBM + swell) so the crest mask normalizes by the
+// actual sea state, not the surface's extent. uSwellAmplitude gates the
+// swell-only color work (crest banding + wave-face shading).
+uniform float uWhitecaps;
+uniform float uWaveEnvelope;
+uniform float uSwellAmplitude;
+
 // 🎨 Contact surface color customization uniforms
 uniform vec3 uEdgeColor;
 uniform float uEdgeIntensity;
@@ -10904,6 +10962,24 @@ void main() {
   // Mix between surface and peak colors based on peak transition
   vec3 mixedColor2 = mix(mixedColor1, uPeakColor, peakFactor);
 
+  // incanto swell: the legacy ramp normalizes elevation by the surface's
+  // HALF-EXTENT — on a real ocean plane that's hundreds of meters, so the
+  // ramp never sees a wave. When swell is on, re-read the crest height
+  // against the actual sea state (uWaveEnvelope) and (a) lighten crest tops
+  // toward the peak color, (b) shade the wave FACES with a gentle N·L off
+  // the distance-smoothed geometry normal — the lit/shadow lanes are what
+  // make open-ocean swell READ at any distance. Both gated: swell 0 keeps
+  // the legacy look byte-identical.
+  if (uSwellAmplitude > 0.0) {
+    float crestBand = smoothstep(0.3, 0.9,
+      (vWorldPosition.y - uWaterCenter.y) / max(uWaveEnvelope, 0.001));
+    mixedColor2 = mix(mixedColor2, uPeakColor, crestBand * 0.45);
+    float faceShade = clamp(dot(normalize(mix(vec3(0.0, 1.0, 0.0), normalize(vNormal),
+      1.0 - 0.9 * smoothstep(150.0, 600.0, length(vWorldPosition - cameraPosition)))),
+      normalize(uSunDirection)), 0.0, 1.0);
+    mixedColor2 *= 0.80 + 0.32 * faceShade;
+  }
+
   // incanto v2: Beer's-law depth absorption + screen-space refraction.
   // Shallow water transmits the (refracted) scene almost untouched; depth
   // exponentially absorbs it into the ramp color — clear turquoise edges,
@@ -11040,6 +11116,22 @@ void main() {
   if (uEnableFoam > 0.5) {
     foamAmount = calculateFoam();
   }
+  // incanto swell: whitecaps — foam eats the TOPS of the tallest crests in
+  // open water. The crest mask normalizes elevation by the real wave envelope
+  // (uScale.y is the surface's half-extent — useless as a sea-state yardstick
+  // on a big ocean plane), and a two-octave noise breaks the caps into
+  // patches that live and die with the crests. Distance-faded: far whitecaps
+  // subtend under a pixel and would alias into horizon speckle.
+  if (uWhitecaps > 0.0 && uWaveEnvelope > 0.001) {
+    float crestN = (vWorldPosition.y - uWaterCenter.y) / uWaveEnvelope;
+    float cap = smoothstep(0.5, 0.85, crestN);
+    vec2 capUV = vWorldPosition.xz * 0.3;
+    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);
+    float whitecap = uWhitecaps * cap * smoothstep(0.42, 0.78, capNoise) * capFade;
+    foamAmount = max(foamAmount, whitecap);
+  }
   // incanto: splash/wake whitewater rides the ripple buffer, INDEPENDENT of the
   // depth-foam gate so it works even on shallow ponds / before the first pre-pass
   float splashFoam = rippleFoam(vWorldPosition.xz);
@@ -11449,7 +11541,11 @@ var Water3D = class Water3D extends Node3D {
 		detailStrength: { default: .26 },
 		absorption: { default: .15 },
 		refraction: { default: true },
-		underwater: { default: true }
+		underwater: { default: true },
+		swell: { default: 0 },
+		swellDirectionDeg: { default: 0 },
+		swellWavelength: { default: 30 },
+		whitecaps: { default: 0 }
 	};
 	/** [width, depth] in meters (the surface lies on XZ). */
 	size = [40, 40];
@@ -11504,6 +11600,21 @@ var Water3D = class Water3D extends Node3D {
 	* `{ color?, visibility? }` overrides the fog hue / view distance (meters).
 	*/
 	underwater = true;
+	/**
+	* Directional traveling SWELL amplitude in meters (fancy only; 0 = off, the
+	* legacy isotropic look). Three peaked wave trains march across the surface
+	* at real deep-water speeds — THE open-ocean dial: 0.15 = lively lake chop,
+	* 0.4 = coastal sea, 0.8 = heavy weather. Crests feed the color ramp,
+	* `whitecaps` and the shore foam automatically.
+	*/
+	swell = 0;
+	/** Compass direction the swell TRAVELS toward, degrees (0 = +z, 90 = +x). */
+	swellDirectionDeg = 0;
+	/** Primary swell wavelength in meters (the two crossing trains derive). */
+	swellWavelength = 30;
+	/** 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;
 	/** Loader hook: degenerate planes and bad enums fail at LOAD, not at render. */
 	static validateJson(node) {
 		const w = node;
@@ -11525,6 +11636,9 @@ var Water3D = class Water3D extends Node3D {
 		if (!(w.sunIntensity >= 0)) throw new IncantoError("BAD_FORMAT", `Water3D '${node.name}' sunIntensity must be >= 0, got ${w.sunIntensity}.`, { prop: "sunIntensity" });
 		if (!(w.detailStrength >= 0)) throw new IncantoError("BAD_FORMAT", `Water3D '${node.name}' detailStrength must be >= 0, got ${w.detailStrength}.`, { prop: "detailStrength" });
 		if (!(w.absorption >= 0)) throw new IncantoError("BAD_FORMAT", `Water3D '${node.name}' absorption must be >= 0 (per-meter Beer's-law constant), got ${w.absorption}.`, { prop: "absorption" });
+		if (!(w.swell >= 0) || !Number.isFinite(w.swell)) throw new IncantoError("BAD_FORMAT", `Water3D '${node.name}' swell must be >= 0 meters (0 = off), got ${JSON.stringify(w.swell)}.`, { prop: "swell" });
+		if (!(w.swellWavelength >= 2)) throw new IncantoError("BAD_FORMAT", `Water3D '${node.name}' swellWavelength must be >= 2 meters, got ${JSON.stringify(w.swellWavelength)}.`, { prop: "swellWavelength" });
+		if (!(w.whitecaps >= 0) || !(w.whitecaps <= 1)) throw new IncantoError("BAD_FORMAT", `Water3D '${node.name}' whitecaps must be in [0, 1], got ${JSON.stringify(w.whitecaps)}.`, { prop: "whitecaps" });
 		const uw = w.underwater;
 		if (typeof uw !== "boolean") {
 			if (typeof uw !== "object" || uw === null || Array.isArray(uw)) throw new IncantoError("BAD_FORMAT", `Water3D '${node.name}' underwater must be true, false or an object ({ color?, visibility? }), got ${JSON.stringify(uw)}.`, { prop: "underwater" });
@@ -11778,7 +11892,12 @@ var Water3D = class Water3D extends Node3D {
 				uCameraFar: { value: 1e3 },
 				uEdgeColor: { value: new Color(FOAM_LOOK.edgeColor) },
 				uEdgeIntensity: { value: FOAM_LOOK.edgeIntensity },
-				uEdgeWidth: { value: FOAM_LOOK.edgeWidth }
+				uEdgeWidth: { value: FOAM_LOOK.edgeWidth },
+				uSwellAmplitude: { value: this.swell },
+				uSwellDir: { value: new Vector2(0, 1) },
+				uSwellWavelength: { value: this.swellWavelength },
+				uWhitecaps: { value: this.whitecaps },
+				uWaveEnvelope: { value: 0 }
 			},
 			transparent: true,
 			depthTest: true,
@@ -11840,6 +11959,12 @@ var Water3D = class Water3D extends Node3D {
 		if (u.uSunIntensity) u.uSunIntensity.value = this.sunIntensity;
 		if (u.uDetailStrength) u.uDetailStrength.value = this.detailStrength;
 		if (u.uAbsorption) u.uAbsorption.value = this.absorption;
+		if (u.uSwellAmplitude) u.uSwellAmplitude.value = this.swell;
+		if (u.uSwellWavelength) u.uSwellWavelength.value = this.swellWavelength;
+		if (u.uWhitecaps) u.uWhitecaps.value = this.whitecaps;
+		const swellRad = this.swellDirectionDeg * Math.PI / 180;
+		(u.uSwellDir?.value)?.set(Math.sin(swellRad), Math.cos(swellRad));
+		if (u.uWaveEnvelope) u.uWaveEnvelope.value = this.waveHeight * AMPLITUDE_PER_WAVE_HEIGHT * 1.5 + this.swell * 1.03;
 		if (!this.reflection && u.uUseEnvironmentMap) u.uUseEnvironmentMap.value = 0;
 		if (!this.foam && u.uEnableFoam) u.uEnableFoam.value = 0;
 		if (!this.refraction && u.uUseRefraction) u.uUseRefraction.value = 0;

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-BFw4c83z.js";
+import { t as registerNodes3D } from "./register-Bh_3Z39N.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-DhaAaKJo.js").then((n) => n.r);
+		const { enablePhysics3D } = await import("./physics-3d-TmOuCy7J.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-DhaAaKJo.js").then((n) => n.r);
+		const { enablePhysics3D } = await import("./physics-3d-TmOuCy7J.js").then((n) => n.r);
 		await enablePhysics3D(engine);
 	}
 	const stepMs = 1e3 / (opts.fixedHz ?? 60);

package/editor/assets/{agent8-BF8Jfbkl.js → agent8-DqQ2CQ5A.js}

@@ -1 +1 @@
-import{t as e}from"./index-DSq0gdhE.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-CofH0yGY.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};