incanto 0.17.3 → 0.19.0

package/dist/3d.d.ts

@@ -1552,6 +1552,7 @@ interface BasinSpec {
   x: number;
   z: number;
   radius: number;
+  /** > 0 carves a bowl; < 0 RAISES a smooth dome mound of that height. */
   depth: number;
 }
 interface HeightmapOptions {
@@ -1705,8 +1706,21 @@ declare class Terrain3D extends Node3D {
   /** CDN base for theme textures: `<base>/<name>.png` (+`_normal`). */
   textureBase: string;
   /** Lake/pond bowls carved into the surface — smooth radial depressions the
-  * collider + heightAt + dressing all see (place a Water3D in each). */
+  * collider + heightAt + dressing all see (place a Water3D in each).
+  * NEGATIVE depth raises a smooth dome MOUND instead (a hill, an islet). */
   basins: BasinSpec[];
+  /**
+  * WET SAND band: `{ y, band? }` darkens + glosses the splat in a noisy,
+  * breathing band just above height `y` (a waterline) — the trace of the
+  * last swash runup. `band` is the max height above `y` that reads wet
+  * (default 1.1 m). null (default) = off.
+  */
+  wetline: JsonObject | null;
+  private splatUniforms;
+  /** Per-frame wetline clock + prop write — lives in update() so a `static`
+  * subtree keeps the wet edge breathing (the frozen-sync lesson). */
+  private wetTime;
+  override update(dt: number): void;
   /** Loader hook: bad themes/layers/grids fail at LOAD, not at render. */
   static validateJson(node: Node): void;
   private heightmap;

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

package/dist/{create-game-BLcN2mt4.js → create-game-Ct6RC4LF.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 { I as Node3D, N as PhysicsBody3D, S as Camera3D, f as DirectionalLight3D, r as createCausticsQuad, t as registerNodes3D, u as ModelInstance3D } from "./register-DCbeSC2t.js";
-import { n as enablePhysics3D } from "./physics-3d-CO4HLs-q.js";
+import { I as Node3D, N as PhysicsBody3D, S as Camera3D, f as DirectionalLight3D, r as createCausticsQuad, t as registerNodes3D, u as ModelInstance3D } from "./register-Cv5GNiVo.js";
+import { n as enablePhysics3D } from "./physics-3d-JPdedRAB.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/env.js

@@ -1,7 +1,7 @@
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as Rng } from "./rng-DP-SR7eg.js";
 import { t as createNoise2D } from "./noise-CGUMx44x.js";
-import { t as buildHeightmap } from "./heightmap-CroQPEER.js";
+import { t as buildHeightmap } from "./heightmap-DgX-Opav.js";
 //#region src/env/round.ts
 /** 2-decimal rounding — keeps generated JSON readable without hurting determinism. */
 function round2(value) {

package/dist/{heightmap-CroQPEER.js → heightmap-DgX-Opav.js}

@@ -64,14 +64,17 @@ function buildHeightmap(opts) {
 		if (Math.abs(final - flatHeight) < FLAT_RANGE) final = flatHeight;
 		if (basins.length > 0) {
 			let carve = 0;
+			let lift = 0;
 			for (const b of basins) {
 				const d = Math.hypot(x - b.cx, z - b.cz);
 				if (d < b.radius) {
 					const t = d / b.radius;
-					carve = Math.max(carve, b.depth * (1 - t * t * (3 - 2 * t)));
+					const s = 1 - t * t * (3 - 2 * t);
+					if (b.depth >= 0) carve = Math.max(carve, b.depth * s);
+					else lift = Math.max(lift, -b.depth * s);
 				}
 			}
-			final -= carve;
+			final += lift - carve;
 		}
 		return final;
 	};

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.17.3";
+const VERSION = "0.19.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-CO4HLs-q.js → physics-3d-JPdedRAB.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 Joint3D, E as Terrain3D, I as Node3D, L as validateCollider3D, M as CharacterBody3D, N as PhysicsBody3D, P as RigidBody3D, j as Area3D } from "./register-DCbeSC2t.js";
+import { A as Joint3D, E as Terrain3D, I as Node3D, L as validateCollider3D, M as CharacterBody3D, N as PhysicsBody3D, P as RigidBody3D, j as Area3D } from "./register-Cv5GNiVo.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-BLcN2mt4.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-Ct6RC4LF.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-DCbeSC2t.js → register-Cv5GNiVo.js}

@@ -5,7 +5,7 @@ import { t as Rng } from "./rng-DP-SR7eg.js";
 import { i as getNodeSchema, l as registerNode } from "./registry-BVJ2HbCn.js";
 import { t as createNoise2D } from "./noise-CGUMx44x.js";
 import { i as applyParticlePreset, o as effectiveOrder, r as PARTICLE_PRESET_NAMES, t as ParticleSim } from "./particle-sim-CyUU7HVU.js";
-import { n as splatWeights, t as buildHeightmap } from "./heightmap-CroQPEER.js";
+import { n as splatWeights, t as buildHeightmap } from "./heightmap-DgX-Opav.js";
 import { AdditiveBlending, AnimationClip, AnimationMixer, Box3, BoxGeometry, BufferAttribute, BufferGeometry, CanvasTexture, CapsuleGeometry, Color, ConeGeometry, CubeCamera, CylinderGeometry, DataTexture, DepthTexture, DirectionalLight, DoubleSide, DynamicDrawUsage, Euler, FloatType, Frustum, Group, HalfFloatType, IcosahedronGeometry, ImageBitmapLoader, InstancedBufferAttribute, InstancedMesh, LinearFilter, LinearMipmapLinearFilter, LoopOnce, LoopRepeat, MathUtils, Matrix4, Mesh, MeshBasicMaterial, MeshDepthMaterial, MeshPhysicalMaterial, MeshStandardMaterial, NearestFilter, NoBlending, NormalBlending, Object3D, PerspectiveCamera, Plane, PlaneGeometry, PointLight, Points, PointsMaterial, Quaternion, QuaternionKeyframeTrack, RGBADepthPacking, RGBAFormat, RepeatWrapping, SRGBColorSpace, ShaderChunk, ShaderMaterial, Sphere, SphereGeometry, Texture, TextureLoader, UniformsLib, UniformsUtils, Vector2, Vector3, Vector4, VectorKeyframeTrack, WebGLCubeRenderTarget, WebGLRenderTarget } from "three";
 import { clone } from "three/addons/utils/SkeletonUtils.js";
 //#region src/3d/camera-rig.ts
@@ -546,6 +546,13 @@ varying vec3 vWorldPosition;
 varying vec2 vUvSplat;
 
 // Noise functions - for naturalizing tiling patterns
+// incanto wetline: WET SAND — a darkened, slightly glossy band hugging the
+// waterline (uWetlineY), its upper edge noisy and breathing with the swash.
+// uWetlineY <= -1e8 disables (the default).
+uniform float uWetlineY;
+uniform float uWetlineBand;
+uniform float uWetTime;
+
 float splatHash(vec2 p) {
     return fract(sin(dot(p, vec2(127.1, 311.7))) * 43758.5453);
 }
@@ -709,6 +716,22 @@ if(splatTextureCount > 1.0) blendedMetalness += splatMetalness2 * smoothWeight2;
 if(splatTextureCount > 2.0) blendedMetalness += splatMetalness3 * smoothWeight3;
 if(splatTextureCount > 3.0) blendedMetalness += splatMetalness4 * smoothWeight4;
 
+// incanto wetline: darken + gloss the sand just above the waterline. The
+// upper edge is fbm-ragged and BREATHES (slow sin synced roughly to the
+// water's swash cadence) so the wet band reads as the trace of the last
+// runup, not a painted stripe.
+if (uWetlineY > -1.0e8) {
+  float above = vWorldPosition.y - uWetlineY;
+  float breathe = 0.5 + 0.5 * sin(uWetTime * 0.42 + vWorldPosition.x * 0.03 + vWorldPosition.z * 0.021);
+  float top = uWetlineBand * (0.5 + 0.5 * breathe);
+  float ragged = top + (fbm(vec2(vWorldPosition.x, vWorldPosition.z) * 0.35) - 0.5) * uWetlineBand * 0.8;
+  float wet = smoothstep(ragged, ragged * 0.25, above) * smoothstep(-uWetlineBand, -uWetlineBand * 0.2, above);
+  // wet sand is first and foremost DARKER; the gleam is mild — a hard
+  // roughness cut mirrored the sky and read as white glare from the air
+  splatColor.rgb *= 1.0 - wet * 0.38;
+  blendedRoughness = mix(blendedRoughness, blendedRoughness * 0.78, wet);
+}
+
 diffuseColor = vec4(splatColor.rgb, diffuseColor.a);
 `;
 const FRAG_ROUGHNESS = `
@@ -793,6 +816,9 @@ function injectTerrainSplatShader(shader, cfg) {
 		shader.uniforms[`uvNoiseIntensity${n}`] = { value: cfg.uvNoiseIntensity[i] ?? .15 };
 	}
 	shader.uniforms.splatTextureCount = { value: Math.min(4, cfg.layerCount) };
+	shader.uniforms.uWetlineY = { value: -1e9 };
+	shader.uniforms.uWetlineBand = { value: 1.1 };
+	shader.uniforms.uWetTime = { value: 0 };
 	shader.uniforms.splatEnvCut = { value: cfg.envCut };
 	shader.vertexShader = injectAfter(shader.vertexShader, "#include <common>", VERT_COMMON);
 	shader.vertexShader = injectAfter(shader.vertexShader, "#include <begin_vertex>", VERT_BEGIN);
@@ -1184,7 +1210,8 @@ var Terrain3D = class extends Node3D {
 		islandEdge: { default: null },
 		layers: { default: [] },
 		textureBase: { default: DEFAULT_TERRAIN_TEXTURE_BASE },
-		basins: { default: [] }
+		basins: { default: [] },
+		wetline: { default: null }
 	};
 	/** [width, depth] extent in meters, centered on the node. */
 	size = [200, 200];
@@ -1209,8 +1236,29 @@ var Terrain3D = class extends Node3D {
 	/** CDN base for theme textures: `<base>/<name>.png` (+`_normal`). */
 	textureBase = DEFAULT_TERRAIN_TEXTURE_BASE;
 	/** Lake/pond bowls carved into the surface — smooth radial depressions the
-	* collider + heightAt + dressing all see (place a Water3D in each). */
+	* collider + heightAt + dressing all see (place a Water3D in each).
+	* NEGATIVE depth raises a smooth dome MOUND instead (a hill, an islet). */
 	basins = [];
+	/**
+	* WET SAND band: `{ y, band? }` darkens + glosses the splat in a noisy,
+	* breathing band just above height `y` (a waterline) — the trace of the
+	* last swash runup. `band` is the max height above `y` that reads wet
+	* (default 1.1 m). null (default) = off.
+	*/
+	wetline = null;
+	splatUniforms = null;
+	/** Per-frame wetline clock + prop write — lives in update() so a `static`
+	* subtree keeps the wet edge breathing (the frozen-sync lesson). */
+	wetTime = 0;
+	update(dt) {
+		this.wetTime += dt;
+		const u = this.splatUniforms;
+		if (!u) return;
+		const w = this.wetline;
+		if (u.uWetlineY) u.uWetlineY.value = typeof w?.y === "number" ? w.y : -1e9;
+		if (u.uWetlineBand) u.uWetlineBand.value = typeof w?.band === "number" ? w.band : 1.1;
+		if (u.uWetTime) u.uWetTime.value = this.wetTime;
+	}
 	/** Loader hook: bad themes/layers/grids fail at LOAD, not at render. */
 	static validateJson(node) {
 		const t = node;
@@ -1225,9 +1273,14 @@ var Terrain3D = class extends Node3D {
 		if (!Number.isInteger(t.detail) || t.detail < 0) throw new IncantoError("BAD_FORMAT", `Terrain3D '${node.name}' detail must be an integer ≥ 0 (octave count), got ${t.detail}.`, { prop: "detail" });
 		if (!(t.flatThreshold >= 0) || !Number.isFinite(t.flatThreshold)) throw new IncantoError("BAD_FORMAT", `Terrain3D '${node.name}' flatThreshold must be a finite number ≥ 0, got ${t.flatThreshold}.`, { prop: "flatThreshold" });
 		if (t.islandEdge !== null && typeof t.islandEdge !== "boolean") throw new IncantoError("BAD_FORMAT", `Terrain3D '${node.name}' islandEdge must be true, false or null (null = theme default), got ${JSON.stringify(t.islandEdge)}.`, { prop: "islandEdge" });
+		const wl = t.wetline;
+		if (wl !== null) {
+			if (typeof wl !== "object" || Array.isArray(wl) || !Number.isFinite(wl.y)) throw new IncantoError("BAD_FORMAT", `Terrain3D '${node.name}' wetline must be null or { y, band? } with a finite y, got ${JSON.stringify(t.wetline)}.`, { prop: "wetline" });
+			if (wl.band !== void 0 && !(wl.band > 0)) throw new IncantoError("BAD_FORMAT", `Terrain3D '${node.name}' wetline.band must be > 0 meters, got ${JSON.stringify(wl.band)}.`, { prop: "wetline" });
+		}
 		if (!Array.isArray(t.basins)) throw new IncantoError("BAD_FORMAT", `Terrain3D '${node.name}' basins must be an array of { x, z, radius, depth }, got ${JSON.stringify(t.basins)}.`, { prop: "basins" });
 		t.basins.forEach((b, i) => {
-			if (!b || typeof b !== "object" || !Number.isFinite(b.x) || !Number.isFinite(b.z) || !(b.radius > 0) || !(b.depth > 0)) throw new IncantoError("BAD_FORMAT", `Terrain3D '${node.name}' basins[${i}] needs finite x, z and positive radius, depth, got ${JSON.stringify(b)}.`, { prop: "basins" });
+			if (!b || typeof b !== "object" || !Number.isFinite(b.x) || !Number.isFinite(b.z) || !(b.radius > 0) || !Number.isFinite(b.depth) || b.depth === 0) throw new IncantoError("BAD_FORMAT", `Terrain3D '${node.name}' basins[${i}] needs finite x, z, positive radius and nonzero depth (negative = mound), got ${JSON.stringify(b)}.`, { prop: "basins" });
 		});
 		if (t.theme === "custom") {
 			if (!Array.isArray(t.layers) || t.layers.length < 1 || t.layers.length > 4) throw new IncantoError("BAD_FORMAT", `Terrain3D '${node.name}' theme 'custom' needs 1–4 layers, got ${Array.isArray(t.layers) ? t.layers.length : typeof t.layers}.`, { prop: "layers" });
@@ -1397,6 +1450,7 @@ var Terrain3D = class extends Node3D {
 		};
 		material.onBeforeCompile = (shader) => {
 			injectTerrainSplatShader(shader, cfg);
+			this.splatUniforms = shader.uniforms;
 		};
 		material.customProgramCacheKey = () => `incanto-terrain-splat:${hasNormalMaps ? 1 : 0}`;
 		return material;
@@ -11028,15 +11082,24 @@ void main() {
     float depthDiff = linearWaterDepth - linearSceneDepth;
     waterViewDepth = max(-depthDiff, 0.0);
 
+    // waterline dither: on a near-flat beach one half-res depth texel spans a
+    // wide screen block at grazing view, so these thresholds cut staircase
+    // notches along the swash edge — jitter the boundary with world noise and
+    // the seam breaks organic. Two octaves at LOW amplitude: a flat slope
+    // multiplies vertical jitter into horizontal metres, so a single strong
+    // octave carved angular value-noise chunks (the diced-radish waterline bug).
+    float seamJitter =
+      (noise(vWorldPosition.xz * 3.1) * 0.65 + noise(vWorldPosition.xz * 8.7) * 0.35 - 0.5) * 0.035;
+
     // 🎯 Two-step approach
     // Step 1: Discard completely overlapping parts
-    float hardDiscardThreshold = 0.1;
+    float hardDiscardThreshold = 0.1 + seamJitter;
     if (depthDiff > hardDiscardThreshold) {
       discard; // Completely remove definitively overlapping pixels
     }
 
     // Step 2: Gradual transparency for border parts
-    float softDiscardStart = -0.05; // Start fade slightly ahead
+    float softDiscardStart = -0.05 + seamJitter; // Start fade slightly ahead
     float softDiscardEnd = hardDiscardThreshold;
 
     if (depthDiff > softDiscardStart) {
@@ -11193,15 +11256,16 @@ void main() {
       vec3 sceneColor = texture2D(uSceneColor, refractedUV, 1.75).rgb;
       // incanto presets: above-water caustics — reconstruct the sampled
       // bottom's world position along the view ray and light it with the
-      // shared caustic web. Strongest through the first meters of water
-      // (a pool floor dances, the deep sea does not), distance-faded so far
-      // shallows never shimmer-alias.
+      // shared caustic web. Needs a focusing column of water (a centimeters-
+      // deep swash film shows no web) and a close viewer: past ~30m each
+      // pixel integrates many caustic cells and the additive web averages
+      // into a solid white sheet over any flat shallow (aerial sandbar bug).
       if (uCausticsAbove > 0.0) {
         vec3 bottomWorld = cameraPosition + viewDirection * refrT;
         float below = uWaterCenter.y - bottomWorld.y;
         if (below > 0.05) {
-          float reach = 1.0 - smoothstep(0.2, 9.0, below);
-          float causticFade = 1.0 - smoothstep(60.0, 200.0, camDist);
+          float reach = smoothstep(0.05, 0.5, below) * (1.0 - smoothstep(0.2, 9.0, below));
+          float causticFade = 1.0 - smoothstep(28.0, 90.0, camDist);
           float cw = caustic(bottomWorld.xz * 0.42, uTime * 0.7) * 0.65
                    + caustic(bottomWorld.xz * 0.72 + 30.0, uTime * 0.55) * 0.35;
           sceneColor += vec3(0.87, 0.96, 1.0) * (cw * uCausticsAbove * reach * causticFade);
@@ -11319,13 +11383,18 @@ void main() {
       float breakup = noise(vWorldPosition.xz * 0.3 + uTime * vec2(0.06, 0.04));
       float lace = noise(vWorldPosition.xz * 2.2 - uTime * vec2(0.18, 0.1));
       front *= (0.45 + 0.55 * breakup) * (0.55 + 0.45 * lace) * (0.35 + 0.65 * sets);
-      float zone = smoothstep(3.4, 1.2, vertDepth) * smoothstep(0.02, 0.2, vertDepth);
+      // no fronts in the centimeters-deep SHEET-FLOW film (an enclosed flat
+      // fizzed solid white from the air) — breakers need ~knee depth to form
+      float zone = smoothstep(3.4, 1.2, vertDepth) * smoothstep(0.12, 0.38, vertDepth);
       foamAmount = max(foamAmount, clamp(uShoreWaves * front * zone * 1.5, 0.0, 1.0));
-      // waterline LACE — the fizzing white edge where the runup meets sand,
-      // dissolving fast like real swash bubbles
-      float lace2 = smoothstep(0.32, 0.02, vertDepth) *
+      // waterline LACE — fizzing bubbles where the runup meets sand. On a
+      // near-FLAT bar the 0–30 cm depth band is tens of meters wide, so an
+      // ungated lace carpeted whole flats in white — a slow patch gate keeps
+      // it as drifting foam streaks instead (real tidal-flat scum lines).
+      float lacePatch = smoothstep(0.4, 0.8, noise(vWorldPosition.xz * 0.5 + uTime * vec2(0.06, 0.045)));
+      float lace2 = smoothstep(0.24, 0.02, vertDepth) *
         (0.35 + 0.65 * noise(vWorldPosition.xz * 3.1 + uTime * vec2(0.5, 0.35)));
-      foamAmount = max(foamAmount, clamp(uShoreWaves * lace2 * 0.85, 0.0, 1.0));
+      foamAmount = max(foamAmount, clamp(uShoreWaves * lace2 * lacePatch * 0.4, 0.0, 1.0));
     }
   }
   // incanto swell: whitecaps — foam eats the TOPS of the tallest crests in
@@ -11648,7 +11717,7 @@ const WATER_PRESETS = {
 		_look: {
 			fresnelScale: 1.15,
 			reflectivityMax: .93,
-			foamRangeScale: 1.15,
+			foamRangeScale: .35,
 			foamIntensity: .55
 		}
 	},

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

package/editor/assets/{agent8-GDZPslB-.js → agent8-CcfBcssq.js}

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