incanto 0.64.1 → 0.66.0

package/dist/{environment-presets-D2vzw583.js → environment-presets-BlPsEmq6.js}

@@ -1,11 +1,11 @@
-import { k as diagnose } from "./loader-zDynoew_.js";
-import { L as translateOn, t as registerCoreNodes } from "./register-Btm7_Emq.js";
+import { k as diagnose } from "./loader-lQDCwNag.js";
+import { L as translateOn, t as registerCoreNodes } from "./register-BmuqYTiY.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as Rng } from "./rng-DP-SR7eg.js";
 import { i as getNodeSchema, l as registerNode } from "./registry-CF70EArN.js";
 import { t as createNoise2D } from "./noise-CGUMx44x.js";
 import { i as ParticleSim, n as resolveFrames, o as PARTICLE_PRESET_NAMES, r as validateAnimationAliases, s as applyParticlePreset, t as resolveAnimation } from "./sprite-animation-CY-mrr1L.js";
-import { B as CharacterBody3D, F as Water3D, H as RigidBody3D, J as colliderFootDrop, L as WaterCutout3D, R as rejectScale, U as StaticBody3D, V as PhysicsBody3D, W as Node3D, w as tolerateUnknownAction, z as Area3D } from "./gameplay-CLgFdkh5.js";
+import { B as rejectScale, G as StaticBody3D, H as CharacterBody3D, K as Node3D, L as Water3D, U as PhysicsBody3D, V as Area3D, W as RigidBody3D, X as colliderFootDrop, w as tolerateUnknownAction, z as WaterCutout3D } from "./gameplay-D1RADWu3.js";
 import { t as checkSheetGrid } from "./sheet-grid-BT6N_Bjs.js";
 import { n as splatWeights, t as buildHeightmap } from "./heightmap-CRK0M4jT.js";
 import { AdditiveBlending, AnimationClip, AnimationMixer, Box3, BoxGeometry, BufferAttribute, BufferGeometry, CanvasTexture, CapsuleGeometry, ClampToEdgeWrapping, Color, ConeGeometry, CylinderGeometry, DataTexture, DirectionalLight, DoubleSide, DynamicDrawUsage, Euler, Group, IcosahedronGeometry, ImageBitmapLoader, InstancedBufferAttribute, InstancedMesh, LinearFilter, LinearMipmapLinearFilter, LoopOnce, LoopRepeat, Matrix4, Mesh, MeshBasicMaterial, MeshDepthMaterial, MeshPhysicalMaterial, MeshStandardMaterial, NearestFilter, NoBlending, NoColorSpace, NormalBlending, PerspectiveCamera, PlaneGeometry, PointLight, Points, PointsMaterial, Quaternion, QuaternionKeyframeTrack, RGBADepthPacking, RGBAFormat, RepeatWrapping, SRGBColorSpace, ShaderChunk, ShaderMaterial, SphereGeometry, Texture, TextureLoader, UniformsLib, UniformsUtils, Vector3, Vector4, VectorKeyframeTrack } from "three";
@@ -742,7 +742,8 @@ var Joint3D = class extends Node3D {
 		] },
 		length: { default: 0 },
 		stiffness: { default: 50 },
-		damping: { default: 5 }
+		damping: { default: 5 },
+		collide: { default: null }
 	};
 	type = "spherical";
 	target = "";
@@ -760,6 +761,31 @@ var Joint3D = class extends Node3D {
 	length = 0;
 	stiffness = 50;
 	damping = 5;
+	/**
+	* Do the two linked bodies still collide with EACH OTHER?
+	*
+	* `null` (default) decides from the joint type, because the two families want
+	* opposite answers:
+	*
+	* - **pivots** (`fixed`, `spherical`, `revolute`) → **off**. A hinge's bodies
+	*   overlap at the pivot by construction, so the contact solver fights the
+	*   joint and flings them. A puzzle builder's first hinge produced a bar that
+	*   spun chaotically forever and threw a 40 kg box thirty metres, and they
+	*   nearly filed "spherical joints inject energy":
+	*
+	*   ```
+	*   t=   0  Plank r=[0,0,0]      Box [ 0.00, 5.50,  2.40]
+	*   t=3000  Plank r=[-66,24,64]  Box [-29.70, 0.40, -4.91]
+	*   ```
+	*
+	* - **tethers** (`rope`, `spring`) → **on**. These anchor a thing to the world,
+	*   and the thing has to rest on what it is tethered to. Defaulting these off
+	*   drops a barrel roped to the floor straight through it — measured, in this
+	*   repo's own conformance room.
+	*
+	* Set `true`/`false` to say it outright.
+	*/
+	collide = null;
 	onEnterTree() {
 		if (!(this.parent instanceof PhysicsBody3D)) throw new IncantoError("TREE_VIOLATION", `Joint3D '${this.name}' must be a child of a physics body (its body A); parent is '${this.parent?.name ?? "none"}'.`);
 		if (this.target === "") throw new IncantoError("BAD_FORMAT", `Joint3D '${this.name}' needs a "target" node path to the body it links to.`);
@@ -2641,6 +2667,7 @@ var CharacterController3D = class extends Node3D {
 		/** Gravity multiplier while falling — >1 is the "snappy" arc. */
 		fallGravity: { default: 2.5 },
 		floatHeight: { default: .01 },
+		stepHeight: { default: .35 },
 		mouseLook: { default: true },
 		zoomMin: { default: 0 },
 		zoomMax: { default: 0 },
@@ -2673,6 +2700,25 @@ var CharacterController3D = class extends Node3D {
 	airControl = .2;
 	fallGravity = 2.5;
 	floatHeight = .01;
+	/**
+	* How high a step the PLAYER walks up without jumping (0 = off).
+	*
+	* The hover spring holds the capsule a fixed distance above whatever is
+	* DIRECTLY below it, so a vertical face stopped the player dead at about
+	* 0.2 m — while `CharacterBody3D.stepHeight` let every enemy climb 0.35 m.
+	* The docs said the player did not need this ("it floats over small ledges
+	* already"); it floats over 18 cm ones.
+	*
+	* This probes just AHEAD of the capsule in the direction of travel: if the
+	* ground there is higher, but by no more than `stepHeight`, the spring aims
+	* at THAT surface and lifts the character onto it. A wall taller than the
+	* step is not a step and still stops you.
+	*
+	* Do not reach for `floatHeight` instead. It does raise the character over
+	* ledges, and it silently makes it WEIGHTLESS: at `floatHeight: 0.28` a
+	* 200 kg character does not move a seesaw a 70 kg crate tips.
+	*/
+	stepHeight = .35;
 	mouseLook = true;
 	zoomMin = 0;
 	zoomMax = 0;
@@ -2803,8 +2849,26 @@ var CharacterController3D = class extends Node3D {
 			0,
 			-vel[2] * DRAG_DAMPING * mass
 		]);
-		if (toi !== null && toi < floatingDis * 2 && !this.jumping) {
-			const spring = SPRING_K * (floatingDis - toi) - vel[1] * SPRING_DAMPING;
+		let springToi = toi;
+		if (this.stepHeight > 0 && moving && toi !== null && !this.jumping && (vel[1] ?? 0) <= .5) {
+			const ahead = radius + .12;
+			const probeTop = originY + this.stepHeight + .05;
+			const stepHit = physics.castRay([
+				pos[0] + mx * ahead,
+				probeTop,
+				pos[2] + mz * ahead
+			], [
+				0,
+				-1,
+				0
+			], this.stepHeight + .05 + rayLen, body);
+			if (stepHit) {
+				const rise = probeTop - stepHit.distance - (originY - toi);
+				if (rise > .02 && rise <= this.stepHeight + .02) springToi = toi - rise;
+			}
+		}
+		if (springToi !== null && springToi < floatingDis * 2 && !this.jumping) {
+			const spring = SPRING_K * (floatingDis - springToi) - vel[1] * SPRING_DAMPING;
 			body.applyImpulse([
 				0,
 				spring * mass,