incanto 0.3.2 → 0.3.4

package/dist/3d.d.ts

@@ -962,6 +962,14 @@ interface MeshMaterialProps {
   flatShading?: boolean;
   /** 0..1 surface opacity; below 1 turns on transparency (glassy gems, etc.). */
   opacity?: number;
+  /** Depth-test against the scene (default true). Set false so the mesh ALWAYS
+  * draws on top of geometry behind it — the standard trick for flat ground
+  * decals (AoE telegraphs, selection rings) that must never z-fight with or be
+  * occluded by bumpy terrain. Pair with a high `renderOrder`. */
+  depthTest?: boolean;
+  /** Write to the depth buffer (default true). Set false for additive/overlay
+  * decals so they don't occlude effects drawn after them. */
+  depthWrite?: boolean;
   /** Color texture URL (sampled sRGB, tinted by `color`). */
   map?: string;
   /** Tangent-space normal map URL (sampled linear). */
@@ -978,10 +986,12 @@ interface MeshMaterialProps {
 * - `size [x,y,z]`: box extents; sphere/gem radius = x; capsule radius = x,
 *   height = y; plane = x·z ground plane (laid flat); cylinder radius = x, height = y
 * - `material`: `{color, metalness, roughness, wireframe, flatShading, opacity,
-*   emissive, emissiveIntensity, map, normalMap, repeat}` — `map`/`normalMap` are
-*   texture URLs loaded lazily (headless-safe: geometry and physics never
-*   wait on them), tiled by `repeat: [u, v]`. `gem` + `flatShading: true` + a low
-*   `roughness` reads as a sparkling faceted jewel (spin it for the sparkle).
+*   depthTest, depthWrite, emissive, emissiveIntensity, map, normalMap, repeat}` —
+*   `map`/`normalMap` are texture URLs loaded lazily (headless-safe: geometry and
+*   physics never wait on them), tiled by `repeat: [u, v]`. `gem` + `flatShading:
+*   true` + a low `roughness` reads as a sparkling faceted jewel (spin it for the
+*   sparkle). `depthTest: false` makes a flat `plane`/`cylinder` an always-on-top
+*   ground decal (AoE telegraph, selection ring) — no z-fighting with terrain.
 */
 declare class MeshInstance3D extends Node3D {
   static override readonly typeName: string;

package/dist/3d.js

@@ -1,5 +1,5 @@
-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-BM7BffzK.js";
-import { A as QUARTER_PITCH, C as Area3D, D as StaticBody3D, E as RigidBody3D, M as keyboardIntensity, N as movementState, O as Node3D, P as rigPose, S as terrainThemeLayers, T as PhysicsBody3D, _ as CharacterController3D, a as VoxelGrid3D, b as DEFAULT_TERRAIN_TEXTURE_BASE, c as ModelInstance3D, d as OmniLight3D, f as Foliage3D, g as FLOWER_VARIETIES, h as resolveFlowerDensity, i as VOXEL_PALETTE, j as cameraRelative, l as MeshInstance3D, m as Flowers3D, n as Water3D, o as Tree3D, p as DENSITY_PRESETS, r as WATER_MAX_RIPPLES, s as Particles3D, t as registerNodes3D, u as DirectionalLight3D, v as Camera3D, w as CharacterBody3D, x as TERRAIN_THEMES, y as Terrain3D } from "./register-QFuyOugX.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-BNFl50Kg.js";
+import { A as QUARTER_PITCH, C as Area3D, D as StaticBody3D, E as RigidBody3D, M as keyboardIntensity, N as movementState, O as Node3D, P as rigPose, S as terrainThemeLayers, T as PhysicsBody3D, _ as CharacterController3D, a as VoxelGrid3D, b as DEFAULT_TERRAIN_TEXTURE_BASE, c as ModelInstance3D, d as OmniLight3D, f as Foliage3D, g as FLOWER_VARIETIES, h as resolveFlowerDensity, i as VOXEL_PALETTE, j as cameraRelative, l as MeshInstance3D, m as Flowers3D, n as Water3D, o as Tree3D, p as DENSITY_PRESETS, r as WATER_MAX_RIPPLES, s as Particles3D, t as registerNodes3D, u as DirectionalLight3D, v as Camera3D, w as CharacterBody3D, x as TERRAIN_THEMES, y as Terrain3D } from "./register-BMFZKPOq.js";
 import { n as splatWeights, t as buildHeightmap } from "./heightmap-CroQPEER.js";
-import { n as enablePhysics3D, t as Physics3D } from "./physics-3d-DNYm3rQz.js";
+import { n as enablePhysics3D, t as Physics3D } from "./physics-3d-B4L2IlFd.js";
 export { Area3D, AssetStore3D, Camera3D, CharacterBody3D, CharacterController3D, DEFAULT_TERRAIN_TEXTURE_BASE, DirectionalLight3D, Environment3D, DENSITY_PRESETS as FLOWER_DENSITY_PRESETS, FLOWER_VARIETIES, Flowers3D, Foliage3D, MeshInstance3D, ModelInstance3D, Node3D, OmniLight3D, Particles3D, Physics3D, PhysicsBody3D, QUARTER_PITCH, Renderer3D, RigidBody3D, StaticBody3D, TERRAIN_THEMES, Terrain3D, Tree3D, VOXEL_PALETTE, VoxelGrid3D, WATER_MAX_RIPPLES, Water3D, buildHeightmap, cameraRelative, createGame3D, enablePhysics3D, horizonColorFromSky, keyboardIntensity, movementState, parseEnvironment3D, registerNodes3D, resolveFlowerDensity, rigPose, splatWeights, sunDirectionFromElevationAzimuth, sunDirectionFromSky, syncTree, terrainThemeLayers };

package/dist/{create-game-BM7BffzK.js → create-game-BNFl50Kg.js}

@@ -6,8 +6,8 @@ import { r as AudioPlayer } from "./register-BuUV1_KB.js";
 import { i as resolveRendering, n as attachTouchControls } from "./touch-031PxtCR.js";
 import { n as registerGameplayBehaviors } from "./gameplay-Ccruc3Wd.js";
 import { t as debugSources } from "./debug-draw-CZmOYjL2.js";
-import { O as Node3D, T as PhysicsBody3D, c as ModelInstance3D, t as registerNodes3D, u as DirectionalLight3D, v as Camera3D } from "./register-QFuyOugX.js";
-import { n as enablePhysics3D } from "./physics-3d-DNYm3rQz.js";
+import { O as Node3D, T as PhysicsBody3D, c as ModelInstance3D, t as registerNodes3D, u as DirectionalLight3D, v as Camera3D } from "./register-BMFZKPOq.js";
+import { n as enablePhysics3D } from "./physics-3d-B4L2IlFd.js";
 import { ACESFilmicToneMapping, AmbientLight, BufferAttribute, BufferGeometry, Color, DepthTexture, EquirectangularReflectionMapping, FloatType, Fog, 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

@@ -57,6 +57,6 @@ function newUid() {
 //#endregion
 //#region src/index.ts
 /** Engine version. Kept in sync with package.json by the release pipeline. */
-const VERSION = "0.3.2";
+const VERSION = "0.3.4";
 //#endregion
 export { AudioBuses, AudioPlayer, Behavior, CONST_REF_KEY, Engine, IncantoError, InputMap, LogManager, MusicManager, Node, PARTICLE_PRESETS, PARTICLE_PRESET_NAMES, ParticleSim, ROLLOFF_MODELS, Rng, SCENE_FORMAT, SFX_PRESETS, SFX_PRESET_NAMES, Scene, SceneTree, SfxEngine, Signal, Timer, TouchControls, VERSION, WebAudioMusicBackend, applyParticlePreset, assetUrls, attachTouchControls, clearBehaviors, clearRegistry, computeViewport, createNode, createNoise2D, crossfadeGains, duplicateNode, fadeGain, getBehavior, getNodeSchema, getNodeSignals, getNodeType, isAudioContextAvailable, isConstRef, joystickVector, jsonClone, jsonEquals, jsonKind, loadScene, mergeStaticSignals, newUid, parseNodePath, preloadUrls, registerBehavior, registerCoreNodes, registerNode, registeredBehaviors, registeredTypes, resolveConstants, resolveRendering, resolveViewport, serializeNode, spatialGain, spatialPan, synthSfx };

package/dist/{physics-3d-DNYm3rQz.js → physics-3d-B4L2IlFd.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 { C as Area3D, E as RigidBody3D, O as Node3D, T as PhysicsBody3D, k as validateCollider3D, w as CharacterBody3D, y as Terrain3D } from "./register-QFuyOugX.js";
+import { C as Area3D, E as RigidBody3D, O as Node3D, T as PhysicsBody3D, k as validateCollider3D, w as CharacterBody3D, y as Terrain3D } from "./register-BMFZKPOq.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-BM7BffzK.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-CZHROKcT.js").then((n) => n.n)).createGame2D(o)))(opts);
+			const next = await (_gameFactory ?? (mode === "3d" ? async (o) => (await import("./create-game-BNFl50Kg.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-CZHROKcT.js").then((n) => n.n)).createGame2D(o)))(opts);
 			if (disposed) {
 				next.dispose();
 				return;

package/dist/{register-QFuyOugX.js → register-BMFZKPOq.js}

@@ -1344,6 +1344,15 @@ const _spritePos = new Vector3();
 const _dir = new Vector3();
 const _target = new Quaternion();
 const _parent = new Quaternion();
+const _sunLocal = new Vector3();
+/** Slide the silhouette shadow caster this many world-units TOWARD the light,
+*  ALONG the light direction. Moving along the light is projection-invariant
+*  (the shadow's shape/position is unchanged), but it lowers the caster's depth
+*  in the shadow map — so the light's anti-acne bias can no longer eat the
+*  near-ground contact (feet/legs). The terrain keeps its own bias untouched, so
+*  terrain self-shadow acne prevention is unaffected. Tune if the foot still
+*  detaches (raise) or over-darkens (lower). */
+const SHADOW_CONTACT_PUSH = .5;
 /**
 * Sprite3D — a 2D texture drawn as a camera-facing billboard quad inside a 3D
 * scene (the 2.5D look: Octopath, Don't Starve). The visual is an inner quad
@@ -1530,7 +1539,13 @@ var Sprite3D = class extends Node3D {
 	*  plain trees pay nothing. */
 	_onRender3D(ctx) {
 		if (this.billboard !== "none") this._faceToward(this._quad(), ctx.camera.position);
-		if (this.shadowMesh?.castShadow && ctx.sunDir) this._faceDir(this.shadowMesh, ctx.sunDir);
+		const caster = this.shadowMesh;
+		if (caster?.castShadow && ctx.sunDir) {
+			this._faceDir(caster, ctx.sunDir);
+			caster.parent?.getWorldQuaternion(_parent);
+			_sunLocal.copy(ctx.sunDir).applyQuaternion(_parent.invert());
+			caster.position.addScaledVector(_sunLocal, SHADOW_CONTACT_PUSH);
+		}
 	}
 	/** @internal Aim the quad's +Z at a world point, honoring billboard mode. */
 	_faceToward(quad, targetWorld) {
@@ -4782,6 +4797,8 @@ const MATERIAL_KEYS = [
 	"wireframe",
 	"flatShading",
 	"opacity",
+	"depthTest",
+	"depthWrite",
 	"map",
 	"normalMap",
 	"repeat"
@@ -4792,10 +4809,12 @@ const MATERIAL_KEYS = [
 * - `size [x,y,z]`: box extents; sphere/gem radius = x; capsule radius = x,
 *   height = y; plane = x·z ground plane (laid flat); cylinder radius = x, height = y
 * - `material`: `{color, metalness, roughness, wireframe, flatShading, opacity,
-*   emissive, emissiveIntensity, map, normalMap, repeat}` — `map`/`normalMap` are
-*   texture URLs loaded lazily (headless-safe: geometry and physics never
-*   wait on them), tiled by `repeat: [u, v]`. `gem` + `flatShading: true` + a low
-*   `roughness` reads as a sparkling faceted jewel (spin it for the sparkle).
+*   depthTest, depthWrite, emissive, emissiveIntensity, map, normalMap, repeat}` —
+*   `map`/`normalMap` are texture URLs loaded lazily (headless-safe: geometry and
+*   physics never wait on them), tiled by `repeat: [u, v]`. `gem` + `flatShading:
+*   true` + a low `roughness` reads as a sparkling faceted jewel (spin it for the
+*   sparkle). `depthTest: false` makes a flat `plane`/`cylinder` an always-on-top
+*   ground decal (AoE telegraph, selection ring) — no z-fighting with terrain.
 */
 var MeshInstance3D = class extends Node3D {
 	static typeName = "MeshInstance3D";
@@ -4858,6 +4877,8 @@ var MeshInstance3D = class extends Node3D {
 		const opacity = this.material.opacity ?? 1;
 		mat.opacity = opacity;
 		mat.transparent = opacity < 1;
+		mat.depthTest = this.material.depthTest ?? true;
+		mat.depthWrite = this.material.depthWrite ?? true;
 		const flat = this.material.flatShading ?? false;
 		if (mat.flatShading !== flat) {
 			mat.flatShading = flat;
@@ -4933,7 +4954,12 @@ function validateMaterial(material, name) {
 		const value = material[key];
 		if (value !== void 0 && !(typeof value === "number" && value >= 0 && value <= 1)) fail(`material.${key} must be a number in 0..1, got ${JSON.stringify(value)}.`);
 	}
-	for (const key of ["wireframe", "flatShading"]) {
+	for (const key of [
+		"wireframe",
+		"flatShading",
+		"depthTest",
+		"depthWrite"
+	]) {
 		const value = material[key];
 		if (value !== void 0 && typeof value !== "boolean") fail(`material.${key} must be a boolean, got ${JSON.stringify(value)}.`);
 	}

package/dist/test.js

@@ -5,7 +5,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-Ccruc3Wd.js";
 import { t as registerNodes2D } from "./register-DPEV9_9t.js";
-import { t as registerNodes3D } from "./register-QFuyOugX.js";
+import { t as registerNodes3D } from "./register-BMFZKPOq.js";
 import { t as registerNodesNet } from "./register-Dasmnurl.js";
 //#region src/test/index.ts
 /**
@@ -132,7 +132,7 @@ async function runScript(json, opts) {
 		const { enablePhysics2D } = await import("./physics-2d-KuMWPTf6.js").then((n) => n.r);
 		await enablePhysics2D(engine);
 	} else if (physics === "3d" || physics === "auto" && scene.dimension === "3d") {
-		const { enablePhysics3D } = await import("./physics-3d-DNYm3rQz.js").then((n) => n.r);
+		const { enablePhysics3D } = await import("./physics-3d-B4L2IlFd.js").then((n) => n.r);
 		await enablePhysics3D(engine);
 	}
 	const failures = [];
@@ -237,7 +237,7 @@ async function createPlaySession(json, opts = {}) {
 		const { enablePhysics2D } = await import("./physics-2d-KuMWPTf6.js").then((n) => n.r);
 		await enablePhysics2D(engine);
 	} else if (physics === "3d" || physics === "auto" && scene.dimension === "3d") {
-		const { enablePhysics3D } = await import("./physics-3d-DNYm3rQz.js").then((n) => n.r);
+		const { enablePhysics3D } = await import("./physics-3d-B4L2IlFd.js").then((n) => n.r);
 		await enablePhysics3D(engine);
 	}
 	const stepMs = 1e3 / (opts.fixedHz ?? 60);

package/editor/assets/{agent8-DFidGSJ6.js → agent8-BYKz0ufn.js}

@@ -1 +1 @@
-import{t as e}from"./index-CXElxUZa.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;constructor(e,t){this.raw=new e({...t})}get account(){return this.raw.account}get connected(){return this.raw.connected}connect(){return this.rawConnect()}rawConnect(){return this.raw.connect({onDisconnect:()=>void this.reconnect()})}disconnect(){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(){await this.rawConnect();for(let e of this.active.values())e.off(),e.off=e.make()}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-BfXcog9m.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;constructor(e,t){this.raw=new e({...t})}get account(){return this.raw.account}get connected(){return this.raw.connected}connect(){return this.rawConnect()}rawConnect(){return this.raw.connect({onDisconnect:()=>void this.reconnect()})}disconnect(){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(){await this.rawConnect();for(let e of this.active.values())e.off(),e.off=e.make()}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};