incanto 0.20.0 → 0.22.0

package/dist/2d.js

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

package/dist/3d.d.ts

@@ -532,6 +532,15 @@ interface CausticsConfig {
   /** Animation speed multiplier. */
   speed: number;
 }
+/**
+* God rays: the shafts of sunlight the surface's own ripples focus into the
+* water column. Caustics light what the beams LAND on; this is the beam itself.
+*/
+interface LightShaftConfig {
+  enabled: boolean;
+  /** Brightness of the accumulated shafts. */
+  strength: number;
+}
 /** Resolved underwater look: fog color, view distance, and the caustics layer. */
 interface UnderwaterConfig {
   enabled: boolean;
@@ -541,6 +550,8 @@ interface UnderwaterConfig {
   visibility: number;
   /** Caustics projected onto submerged surfaces (the floor especially). */
   caustics: CausticsConfig;
+  /** Sunlight shafts hanging in the water column. */
+  rays: LightShaftConfig;
 }
 //#endregion
 //#region src/3d/environment-3d.d.ts
@@ -1598,6 +1609,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 +1705,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 +1733,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 +1763,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 +2329,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;
@@ -2369,6 +2429,14 @@ declare class Water3D extends Node3D implements RenderHook3D, SunConsumer3D {
   private resolvePalette;
   private syncSimple;
   private stepInteraction;
+  /**
+  * Surface height at WORLD (x, z) — the CPU twin of the shader's own waves,
+  * so gameplay can float a raft, bob a buoy or place a jetty on the sea state
+  * the player is actually looking at. Interaction ripples are excluded (a
+  * splash must not re-trigger itself); outside the footprint it still answers
+  * the still-water level, which is what a caller comparing heights wants.
+  */
+  heightAt(x: number, z: number): number;
   /** Base wave height at world (x, z) — the CPU twin of the active shader.
   * Ripples are excluded on purpose: a splash must not re-trigger itself. */
   private waveOffsetAt;

package/dist/3d.js

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

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

@@ -3,10 +3,10 @@ import { _ as registerBehavior, n as loadScene, o as computeViewport, s as resol
 import { l as AudioPlayer, u as Engine } from "./register-nObreUQR.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { i as resolveRendering, n as attachTouchControls } from "./touch-031PxtCR.js";
-import { n as registerGameplayBehaviors } from "./gameplay-sSqrUcnz.js";
-import { g as PhysicsBody2D, n as UILayer, t as registerNodes2D, u as Camera2D, y as Node2D } from "./register-Djwckzgx.js";
+import { n as registerGameplayBehaviors } from "./gameplay-Dib5mNFD.js";
+import { g as PhysicsBody2D, n as UILayer, t as registerNodes2D, u as Camera2D, y as Node2D } from "./register-CvpSUU3O.js";
 import { t as debugSources } from "./debug-draw-CZmOYjL2.js";
-import { n as enablePhysics2D } from "./physics-2d-BiIdl51r.js";
+import { n as enablePhysics2D } from "./physics-2d-DiVFFlH3.js";
 import { Box3, BufferAttribute, BufferGeometry, Color, LineBasicMaterial, LineSegments, LinearFilter, NearestFilter, OrthographicCamera, Raycaster, SRGBColorSpace, Scene, TextureLoader, Vector2, Vector3, WebGLRenderer } from "three";
 //#region src/2d/assets.ts
 /**

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

@@ -3,10 +3,10 @@ import { _ as registerBehavior, n as loadScene } from "./loader-BZqOKfI2.js";
 import { l as AudioPlayer, u as Engine } from "./register-nObreUQR.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { i as resolveRendering, n as attachTouchControls } from "./touch-031PxtCR.js";
-import { n as registerGameplayBehaviors } from "./gameplay-sSqrUcnz.js";
+import { I as Node3D, N as PhysicsBody3D, R as createCausticsQuad, n as registerGameplayBehaviors } from "./gameplay-Dib5mNFD.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 { d as DirectionalLight3D, l as ModelInstance3D, t as registerNodes3D, x as Camera3D } from "./register-CHgVdSbp.js";
+import { n as enablePhysics3D } from "./physics-3d-DLPPRNu4.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";
@@ -1762,6 +1762,9 @@ var Renderer3D = class {
 		u.uCausticIntensity.value = underwater.caustics.intensity;
 		u.uCausticScale.value = underwater.caustics.scale;
 		u.uMaxDist.value = underwater.visibility;
+		const sunDir = this.environment.sunDirection;
+		if (sunDir) u.uSunDirection.value.set(sunDir[0], sunDir[1], sunDir[2]);
+		u.uRayStrength.value = underwater.rays.enabled ? underwater.rays.strength : 0;
 		this.webgl.render(this.causticsScene, camera);
 	}
 	/**

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

@@ -1,4 +1,18 @@
 import { i as serializeNode, t as buildNodeJson } from "./loader-BZqOKfI2.js";
+//#region src/core/order-groups.ts
+const ORDER_GROUP_BASE = {
+	background: -2e3,
+	terrain: -1e3,
+	default: 0,
+	characters: 1e3,
+	effects: 2e3,
+	overlay: 3e3
+};
+/** base + fine offset (unknown group names fall back to `default`). */
+function effectiveOrder(group, renderOrder) {
+	return (ORDER_GROUP_BASE[group] ?? 0) + renderOrder;
+}
+//#endregion
 //#region src/core/scene/duplicate.ts
 function stripUids(json) {
 	const { uid: _uid, ...rest } = json;
@@ -19,4 +33,4 @@ function duplicateNode(node) {
 	return buildNodeJson(stripUids(serializeNode(node)));
 }
 //#endregion
-export { duplicateNode as t };
+export { ORDER_GROUP_BASE as n, effectiveOrder as r, duplicateNode as t };