incanto 0.21.0 → 0.23.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-DrcEgRup.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
@@ -2274,6 +2285,12 @@ declare class Water3D extends Node3D implements RenderHook3D, SunConsumer3D {
   * render per frame, so it is off by default; a still lake earns it.
   */
   mirror: boolean;
+  /**
+  * Milliseconds between planar-mirror re-renders. A reflection seen through a
+  * rippling surface does not need 60 Hz — 33 ms halves the pass's cost and
+  * nobody can tell. 0 re-renders every frame.
+  */
+  mirrorInterval: number;
   /** ms between reflection (and foam depth) re-renders. */
   reflectionInterval: number;
   /** Depth-texture shoreline foam — rides the always-on fancy scene pass. */
@@ -2367,6 +2384,8 @@ declare class Water3D extends Node3D implements RenderHook3D, SunConsumer3D {
   private readonly _scratchA;
   private readonly _scratchB;
   private readonly _bodies;
+  /** Scratch for the side-pass cull (no per-frame allocation). */
+  private readonly _passHidden;
   private cubeTarget;
   private cubeCamera;
   /** Reflection near plane (max half extent) — recreate the camera on resize. */
@@ -2377,6 +2396,7 @@ declare class Water3D extends Node3D implements RenderHook3D, SunConsumer3D {
   private mirrorTarget;
   private readonly mirrorCamera;
   private readonly mirrorMatrix;
+  private lastMirrorAt;
   protected override _createObject3D(): Object3D;
   override update(dt: number): void;
   override _syncObject3D(): void;
@@ -2418,6 +2438,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-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 { 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-BJ5gXIks.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-OyjhYUL3.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-CpJORtm4.js";
 import { n as splatWeights, t as buildHeightmap } from "./heightmap-CRK0M4jT.js";
-import { n as enablePhysics3D, t as Physics3D } from "./physics-3d-DHTZUrr0.js";
+import { n as enablePhysics3D, t as Physics3D } from "./physics-3d-CpIB9C-F.js";
 //#region src/3d/environment-runtime.ts
 /**
 * Live environment editing — the renderer re-applies `scene.environment`

package/dist/{create-game-Ct86zczq.js → create-game-DrcEgRup.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-BJ5gXIks.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-xbxZRFwR.js → create-game-OyjhYUL3.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-BJ5gXIks.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-BC55Ez6I.js";
-import { n as enablePhysics3D } from "./physics-3d-DHTZUrr0.js";
+import { d as DirectionalLight3D, l as ModelInstance3D, t as registerNodes3D, x as Camera3D } from "./register-CpJORtm4.js";
+import { n as enablePhysics3D } from "./physics-3d-CpIB9C-F.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 };