incanto 0.5.0 → 0.6.0

package/dist/2d.d.ts

@@ -52,6 +52,8 @@ declare class Node2D extends Node {
   position: number[];
   /** Degrees, clockwise. */
   rotation: number;
+  /** Frozen after first sync — see Node3D.static (same semantics in 2D). */
+  static: boolean;
   scale: number[];
   /** Draw order among 2D drawables (higher = on top); matches 3D `renderOrder`. */
   renderOrder: number;
@@ -636,6 +638,8 @@ declare class Renderer2D {
   private readonly webgl;
   private readonly worldScene;
   private readonly syncScratch;
+  /** Editors set this: keep syncing `static: true` subtrees every frame. */
+  ignoreStatic: boolean;
   private readonly uiScene;
   private readonly worldCam;
   private readonly uiCam;
@@ -705,6 +709,8 @@ interface Sync2DScratch {
   visited: Set<Object3D>;
   cameras: Camera2D[];
 }
-declare function syncTree2D(root: Node, world: Scene, ui: Scene, assets: AssetStore2D | null, uiSize?: UiSize, scratch?: Sync2DScratch): Sync2DResult;
+declare function syncTree2D(root: Node, world: Scene, ui: Scene, assets: AssetStore2D | null, uiSize?: UiSize, scratch?: Sync2DScratch, opts?: {
+  ignoreStatic?: boolean;
+}): Sync2DResult;
 //#endregion
 export { AnimatedSprite2D, type AnimationDef, Area2D, type AssetStatus, AssetStore2D, Camera2D, CharacterBody2D, CharacterController2D, ColorRect2D, type CreateGame2DOptions, type Game2D, Joint2D, type JointType2D, Label, Node2D, Particles2D, Physics2D, type Physics2DOptions, PhysicsBody2D, Renderer2D, type Renderer2DOptions, type ResolvedSpriteTexture, RigidBody2D, type SheetInfo, Sprite2D, type SpriteFromLibraryResult, StaticBody2D, type Sync2DResult, type TextureLoadCallbacks, type UIAnchor, UILayer, createGame2D, enablePhysics2D, registerNodes2D, spriteFromLibraryMeta, syncTree2D };

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-BFESHv1X.js";
-import { a as ColorRect2D, c as AnimatedSprite2D, d as Area2D, f as CharacterBody2D, g as Node2D, h as StaticBody2D, i as Label, l as Sprite2D, m as RigidBody2D, n as UILayer, o as CharacterController2D, p as PhysicsBody2D, r as Particles2D, s as Camera2D, t as registerNodes2D, u as Joint2D } from "./register-D71C4rDC.js";
-import { n as enablePhysics2D, t as Physics2D } from "./physics-2d-KXn1N1jF.js";
+import { a as AssetStore2D, i as syncTree2D, r as Renderer2D, t as createGame2D } from "./create-game-B_sW_eiE.js";
+import { a as ColorRect2D, c as AnimatedSprite2D, d as Area2D, f as CharacterBody2D, g as Node2D, h as StaticBody2D, i as Label, l as Sprite2D, m as RigidBody2D, n as UILayer, o as CharacterController2D, p as PhysicsBody2D, r as Particles2D, s as Camera2D, t as registerNodes2D, u as Joint2D } from "./register-BJCfuuZ2.js";
+import { n as enablePhysics2D, t as Physics2D } from "./physics-2d-Cgli1aju.js";
 //#region src/2d/library-sprite.ts
 /**
 * Turn a library sprite-animation JSON into a scene-ready spritesheet asset

package/dist/3d.d.ts

@@ -137,6 +137,15 @@ declare class Node3D extends Node {
   position: number[];
   /** Euler XYZ in degrees. */
   rotation: number[];
+  /**
+  * This subtree never changes after load: the renderer syncs it ONCE and
+  * skips it every frame after (transforms, materials, animations frozen).
+  * The per-frame walk is O(nodes) — marking terrain/buildings/decor static
+  * removes most of a big scene from it. Set `static = false` to resume
+  * live syncing. Do NOT mark animated nodes (Water3D, Particles3D,
+  * AnimatedSprite3D, ModelInstance3D with clips) or cameras static.
+  */
+  static: boolean;
   scale: number[];
   visible: boolean;
   /** Draw-order priority (higher = drawn later / on top). Only affects TRANSPARENT
@@ -412,6 +421,14 @@ interface ShadowsEnvironment {
   mapSize: 1024 | 2048;
   /** Shadow edge softening radius (PCF blur, default 1). */
   radius: number;
+  /**
+  * `true` = shadow casters never move or animate: the shadow pass renders
+  * ONCE (and again on scene/environment change) instead of every frame —
+  * measured ~42% of a dense-forest frame. Characters under a static-shadow
+  * scene should use blob/sprite shadows. `Renderer3D.refreshShadows()`
+  * forces a re-render after a one-off world edit.
+  */
+  static: boolean;
 }
 interface CloudsEnvironment {
   /** How much of the sky is cloudy, 0..1. */
@@ -1914,6 +1931,8 @@ declare class Renderer3D {
   private compiledScene;
   /** Reused per-frame walk scratch (instance-scoped — never a module global). */
   private readonly syncScratch;
+  /** Editors set this: keep syncing `static: true` subtrees every frame. */
+  ignoreStatic: boolean;
   /** Reused render-hook context — gl/scene are stable, camera reassigned/frame. */
   private renderCtx;
   /** Underwater caustics pass (lazy — only created the first time submerged). */
@@ -2000,6 +2019,11 @@ declare class Renderer3D {
     up: Vector3;
     forward: Vector3;
   };
+  /**
+  * Re-render the shadow pass once (static-shadow scenes,
+  * `environment.shadows.static: true`) after a one-off world edit.
+  */
+  refreshShadows(): void;
   dispose(): void;
 }
 //#endregion
@@ -2043,6 +2067,8 @@ interface SyncScratch {
 }
 interface SyncOptions {
   assets?: AssetStore3D;
+  /** Sync `static: true` subtrees every frame anyway (the editor's edit mode). */
+  ignoreStatic?: boolean;
   /**
   * The environment sky's unit sun direction. Pushed to every
   * `_applySunDirection` node (Water3D, Foliage3D) right after its own sync —
@@ -2079,6 +2105,7 @@ interface WalkState {
   sunDirection: readonly [number, number, number] | null;
   sunLight: DirectionalLight3D | null;
   alpha: number;
+  ignoreStatic: boolean;
 }
 //#endregion
 export { Area3D, AssetStore3D, Billboard3D, type BillboardGroupMode, Camera3D, CharacterBody3D, CharacterController3D, type CreateGame3DOptions, DEFAULT_TERRAIN_TEXTURE_BASE, DirectionalLight3D, Environment3D, type Environment3DConfig, DENSITY_PRESETS as FLOWER_DENSITY_PRESETS, FLOWER_VARIETIES, type FlowerVariety, Flowers3D, type FogEnvironment, Foliage3D, type FoliageKind, type FoliageStyle, type Game3D, type Heightmap, type HeightmapOptions, Joint3D, type JointType3D, LoftMesh3D, type LoftSection, MeshInstance3D, type MeshKind, type MeshMaterialProps, type ModelEntry, ModelInstance3D, Node3D, OmniLight3D, Particles3D, Physics3D, type Physics3DOptions, PhysicsBody3D, QUARTER_PITCH, type RenderContext3D, type RenderHook3D, Renderer3D, type Renderer3DOptions, type RigView, RigidBody3D, type Ripple, type ShadowsEnvironment, type SkyEnvironment, StaticBody3D, type SunConsumer3D, type SyncOptions, type SyncResult, TERRAIN_THEMES, Terrain3D, type TerrainLayer, type TerrainTheme, Tree3D, type TreeTier, type TreeType, VOXEL_PALETTE, type VoxelBlock, VoxelGrid3D, WATER_MAX_RIPPLES, Water3D, buildHeightmap, cameraRelative, createGame3D, enablePhysics3D, horizonColorFromSky, keyboardIntensity, movementState, parseEnvironment3D, registerNodes3D, resolveFlowerDensity, rigPose, splatWeights, sunDirectionFromElevationAzimuth, sunDirectionFromSky, syncTree, terrainThemeLayers };

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-D8UvwXme.js";
-import { A as StaticBody3D, C as TERRAIN_THEMES, D as CharacterBody3D, E as Area3D, F as keyboardIntensity, I as movementState, L as rigPose, N as QUARTER_PITCH, O as PhysicsBody3D, P as cameraRelative, S as DEFAULT_TERRAIN_TEXTURE_BASE, T as Joint3D, _ as FLOWER_VARIETIES, a as VoxelGrid3D, b as Billboard3D, c as ModelInstance3D, d as DirectionalLight3D, f as OmniLight3D, g as resolveFlowerDensity, h as Flowers3D, i as VOXEL_PALETTE, j as Node3D, k as RigidBody3D, l as LoftMesh3D, m as DENSITY_PRESETS, n as Water3D, o as Tree3D, p as Foliage3D, r as WATER_MAX_RIPPLES, s as Particles3D, t as registerNodes3D, u as MeshInstance3D, v as CharacterController3D, w as terrainThemeLayers, x as Terrain3D, y as Camera3D } from "./register-DvPHJdVj.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-DkbZCNaV.js";
+import { A as StaticBody3D, C as TERRAIN_THEMES, D as CharacterBody3D, E as Area3D, F as keyboardIntensity, I as movementState, L as rigPose, N as QUARTER_PITCH, O as PhysicsBody3D, P as cameraRelative, S as DEFAULT_TERRAIN_TEXTURE_BASE, T as Joint3D, _ as FLOWER_VARIETIES, a as VoxelGrid3D, b as Billboard3D, c as ModelInstance3D, d as DirectionalLight3D, f as OmniLight3D, g as resolveFlowerDensity, h as Flowers3D, i as VOXEL_PALETTE, j as Node3D, k as RigidBody3D, l as LoftMesh3D, m as DENSITY_PRESETS, n as Water3D, o as Tree3D, p as Foliage3D, r as WATER_MAX_RIPPLES, s as Particles3D, t as registerNodes3D, u as MeshInstance3D, v as CharacterController3D, w as terrainThemeLayers, x as Terrain3D, y as Camera3D } from "./register-Dd7Juujf.js";
 import { n as splatWeights, t as buildHeightmap } from "./heightmap-CroQPEER.js";
-import { n as enablePhysics3D, t as Physics3D } from "./physics-3d-C58oQzTX.js";
+import { n as enablePhysics3D, t as Physics3D } from "./physics-3d-CBAQ12LY.js";
 export { Area3D, AssetStore3D, Billboard3D, Camera3D, CharacterBody3D, CharacterController3D, DEFAULT_TERRAIN_TEXTURE_BASE, DirectionalLight3D, Environment3D, DENSITY_PRESETS as FLOWER_DENSITY_PRESETS, FLOWER_VARIETIES, Flowers3D, Foliage3D, Joint3D, LoftMesh3D, 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-BFESHv1X.js → create-game-B_sW_eiE.js}

@@ -5,9 +5,9 @@ import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { s as AudioPlayer } from "./register-Dl_ixIJe.js";
 import { i as resolveRendering, n as attachTouchControls } from "./touch-031PxtCR.js";
 import { n as registerGameplayBehaviors } from "./gameplay-CDFgSG6z.js";
-import { g as Node2D, n as UILayer, p as PhysicsBody2D, s as Camera2D, t as registerNodes2D } from "./register-D71C4rDC.js";
+import { g as Node2D, n as UILayer, p as PhysicsBody2D, s as Camera2D, t as registerNodes2D } from "./register-BJCfuuZ2.js";
 import { t as debugSources } from "./debug-draw-CZmOYjL2.js";
-import { n as enablePhysics2D } from "./physics-2d-KXn1N1jF.js";
+import { n as enablePhysics2D } from "./physics-2d-Cgli1aju.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
 /**
@@ -108,11 +108,11 @@ function createSync2DScratch() {
 		cameras: []
 	};
 }
-function syncTree2D(root, world, ui, assets, uiSize, scratch) {
+function syncTree2D(root, world, ui, assets, uiSize, scratch, opts) {
 	const s = scratch ?? createSync2DScratch();
 	s.visited.clear();
 	s.cameras.length = 0;
-	walk(root, world, ui, false, s.visited, s.cameras, assets, uiSize);
+	walk(root, world, ui, false, s.visited, s.cameras, assets, uiSize, opts?.ignoreStatic === true);
 	prune(world, s.visited);
 	prune(ui, s.visited);
 	let current = null;
@@ -126,9 +126,17 @@ function syncTree2D(root, world, ui, assets, uiSize, scratch) {
 	if (!current) current = s.cameras[0] ?? null;
 	return { activeCamera: current };
 }
-function walk(node, parentObj, ui, inUi, visited, cameras, assets, uiSize) {
+function walk(node, parentObj, ui, inUi, visited, cameras, assets, uiSize, ignoreStatic) {
 	let nextParent = parentObj;
 	let nextInUi = inUi;
+	if (node instanceof Node2D && !(node instanceof UILayer)) {
+		const frozen = node._ensureObject2D();
+		if (node.static && !ignoreStatic && frozen.userData.incantoStaticSynced === true) {
+			frozen.userData.incantoStatic = true;
+			visited.add(frozen);
+			return;
+		}
+	}
 	if (node instanceof UILayer) {
 		const group = node._ensureGroup();
 		if (group.parent !== ui) ui.add(group);
@@ -148,14 +156,24 @@ function walk(node, parentObj, ui, inUi, visited, cameras, assets, uiSize) {
 		if (node instanceof Camera2D && !inUi) cameras.push(node);
 		nextParent = obj;
 	}
-	for (const child of node.children) walk(child, nextParent, ui, nextInUi, visited, cameras, assets, uiSize);
+	for (const child of node.children) walk(child, nextParent, ui, nextInUi, visited, cameras, assets, uiSize, ignoreStatic);
+	if (node instanceof Node2D && !(node instanceof UILayer)) {
+		const obj = node._ensureObject2D();
+		if (node.static && !ignoreStatic) {
+			obj.userData.incantoStaticSynced = true;
+			obj.userData.incantoStatic = true;
+		} else if (obj.userData.incantoStaticSynced === true) {
+			obj.userData.incantoStaticSynced = false;
+			obj.userData.incantoStatic = false;
+		}
+	}
 }
 function prune(obj, visited) {
 	const ch = obj.children;
 	for (let i = ch.length - 1; i >= 0; i--) {
 		const child = ch[i];
 		if (child.userData.incantoNode && !visited.has(child)) obj.remove(child);
-		else prune(child, visited);
+		else if (child.userData.incantoStatic !== true) prune(child, visited);
 	}
 }
 //#endregion
@@ -175,6 +193,8 @@ var Renderer2D = class {
 	webgl;
 	worldScene = new Scene();
 	syncScratch = createSync2DScratch();
+	/** Editors set this: keep syncing `static: true` subtrees every frame. */
+	ignoreStatic = false;
 	uiScene = new Scene();
 	worldCam = new OrthographicCamera(-1, 1, 1, -1, -1e3, 1e3);
 	uiCam = new OrthographicCamera(-1, 1, 1, -1, -1e3, 1e3);

package/dist/{create-game-D8UvwXme.js → create-game-DkbZCNaV.js}

@@ -6,8 +6,8 @@ import { s as AudioPlayer } from "./register-Dl_ixIJe.js";
 import { i as resolveRendering, n as attachTouchControls } from "./touch-031PxtCR.js";
 import { n as registerGameplayBehaviors } from "./gameplay-CDFgSG6z.js";
 import { t as debugSources } from "./debug-draw-CZmOYjL2.js";
-import { O as PhysicsBody3D, c as ModelInstance3D, d as DirectionalLight3D, j as Node3D, t as registerNodes3D, y as Camera3D } from "./register-DvPHJdVj.js";
-import { n as enablePhysics3D } from "./physics-3d-C58oQzTX.js";
+import { O as PhysicsBody3D, c as ModelInstance3D, d as DirectionalLight3D, j as Node3D, t as registerNodes3D, y as Camera3D } from "./register-Dd7Juujf.js";
+import { n as enablePhysics3D } from "./physics-3d-CBAQ12LY.js";
 import { ACESFilmicToneMapping, AmbientLight, 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";
@@ -563,7 +563,11 @@ const CLOUD_KEYS = [
 	"scale"
 ];
 const BLOOM_KEYS = ["threshold", "strength"];
-const SHADOW_KEYS = ["mapSize", "radius"];
+const SHADOW_KEYS = [
+	"mapSize",
+	"radius",
+	"static"
+];
 const SHADOW_MAP_SIZES = [1024, 2048];
 const DEFAULT_TURBIDITY = 2;
 const DEFAULT_RAYLEIGH = 1;
@@ -756,7 +760,8 @@ function parseShadows(value) {
 	if (value === false) return false;
 	if (value === true) return {
 		mapSize: 2048,
-		radius: 1
+		radius: 1,
+		static: false
 	};
 	if (typeof value !== "object" || value === null || Array.isArray(value)) throw new IncantoError("BAD_FORMAT", `environment.shadows must be true, false or an object ({ mapSize?, radius? }), got ${JSON.stringify(value)}.`, { prop: "shadows" });
 	const shadows = value;
@@ -771,9 +776,12 @@ function parseShadows(value) {
 	});
 	const radius = numberOr(shadows.radius, 1, "shadows.radius");
 	if (radius < 0) throw new IncantoError("BAD_FORMAT", `environment.shadows.radius must be >= 0, got ${radius}.`, { prop: "shadows" });
+	const staticShadows = shadows.static === void 0 ? false : shadows.static;
+	if (typeof staticShadows !== "boolean") throw new IncantoError("BAD_FORMAT", `environment.shadows.static must be a boolean, got ${JSON.stringify(shadows.static)}.`, { prop: "shadows" });
 	return {
 		mapSize,
-		radius
+		radius,
+		static: staticShadows
 	};
 }
 function numberOr(value, fallback, at) {
@@ -887,6 +895,12 @@ var Environment3D = class {
 		if (gl) {
 			gl.toneMappingExposure = cfg.exposure;
 			gl.shadowMap.enabled = cfg.shadows !== false;
+			if (cfg.shadows !== false && cfg.shadows !== null && cfg.shadows.static) {
+				if (gl.shadowMap.autoUpdate) {
+					gl.shadowMap.autoUpdate = false;
+					gl.shadowMap.needsUpdate = true;
+				}
+			} else if (!gl.shadowMap.autoUpdate) gl.shadowMap.autoUpdate = true;
 		}
 		this.applyHdri(env);
 		this.applySky(cfg.sky, gl);
@@ -1081,7 +1095,8 @@ function createSyncScratch() {
 			assets: void 0,
 			sunDirection: null,
 			sunLight: null,
-			alpha: 1
+			alpha: 1,
+			ignoreStatic: false
 		}
 	};
 }
@@ -1105,6 +1120,7 @@ function syncTree(root, threeScene, assets, opts, scratch) {
 	const state = s.state;
 	state.assets = assets;
 	state.sunDirection = opts?.sunDirection ?? null;
+	state.ignoreStatic = opts?.ignoreStatic === true;
 	state.sunLight = null;
 	state.alpha = opts?.alpha ?? 1;
 	walk(root, threeScene, state);
@@ -1176,6 +1192,11 @@ function walk(node, parentObj, state) {
 	let nextParent = parentObj;
 	if (node instanceof Node3D) {
 		const obj = node._ensureObject3D();
+		if (node.static && !state.ignoreStatic && obj.userData.incantoStaticSynced === true) {
+			obj.userData.incantoStatic = true;
+			state.visited.add(obj);
+			return;
+		}
 		if (obj.parent !== parentObj) parentObj.add(obj);
 		node._syncObject3D(state.alpha);
 		if (state.assets && node instanceof ModelInstance3D) node._syncModel(state.assets);
@@ -1195,13 +1216,37 @@ function walk(node, parentObj, state) {
 		parent: nextParent
 	});
 	for (const child of node.children) walk(child, nextParent, state);
+	if (node instanceof Node3D) {
+		const obj = node._ensureObject3D();
+		if (node.static && !state.ignoreStatic) {
+			obj.userData.incantoStaticSynced = true;
+			obj.userData.incantoStatic = true;
+			warnStaticHazards(node);
+		} else if (obj.userData.incantoStaticSynced === true) {
+			obj.userData.incantoStaticSynced = false;
+			obj.userData.incantoStatic = false;
+		}
+	}
+}
+const warnedStatic = /* @__PURE__ */ new WeakSet();
+/** One-time warning when animated machinery is frozen under a static root. */
+function warnStaticHazards(root) {
+	if (warnedStatic.has(root)) return;
+	warnedStatic.add(root);
+	const hazards = [];
+	const scan = (n) => {
+		if (typeof n._onRender3D === "function" || n instanceof Camera3D) hazards.push(`${n.name} (${n.constructor.typeName ?? "?"})`);
+		for (const c of n.children) scan(c);
+	};
+	scan(root);
+	if (hazards.length > 0) console.warn(`[incanto] static subtree '${root.name}' freezes animated/per-frame nodes: ${hazards.join(", ")} — they will stop updating. Unmark static or move them out.`);
 }
 function prune(obj, visited) {
 	const ch = obj.children;
 	for (let i = ch.length - 1; i >= 0; i--) {
 		const child = ch[i];
 		if (child.userData.incantoNode && !visited.has(child)) obj.remove(child);
-		else prune(child, visited);
+		else if (child.userData.incantoStatic !== true) prune(child, visited);
 	}
 }
 //#endregion
@@ -1348,6 +1393,8 @@ var Renderer3D = class {
 	compiledScene = null;
 	/** Reused per-frame walk scratch (instance-scoped — never a module global). */
 	syncScratch = createSyncScratch();
+	/** Editors set this: keep syncing `static: true` subtrees every frame. */
+	ignoreStatic = false;
 	/** Reused render-hook context — gl/scene are stable, camera reassigned/frame. */
 	renderCtx = null;
 	/** Underwater caustics pass (lazy — only created the first time submerged). */
@@ -1425,7 +1472,8 @@ var Renderer3D = class {
 		this.environment.apply(scene.environment, this.webgl);
 		const { activeCamera: sceneCamera, renderHooks, sunLight } = syncTree(scene.root, this.threeScene, this.assets, {
 			sunDirection: this.environment.sunDirection,
-			alpha: this.engine.interpolationAlpha
+			alpha: this.engine.interpolationAlpha,
+			ignoreStatic: this.ignoreStatic
 		}, this.syncScratch);
 		let activeCamera = sceneCamera;
 		if (this.viewOverride) {
@@ -1763,6 +1811,13 @@ var Renderer3D = class {
 			forward: new Vector3(0, 0, -1).applyQuaternion(q)
 		};
 	}
+	/**
+	* Re-render the shadow pass once (static-shadow scenes,
+	* `environment.shadows.static: true`) after a one-off world edit.
+	*/
+	refreshShadows() {
+		this.webgl.shadowMap.needsUpdate = true;
+	}
 	dispose() {
 		this.disconnect();
 		this.threeScene.traverse((obj) => {

package/dist/index.js

@@ -110,6 +110,6 @@ function newUid() {
 //#endregion
 //#region src/index.ts
 /** Engine version. Kept in sync with package.json by the release pipeline. */
-const VERSION = "0.5.0";
+const VERSION = "0.6.0";
 //#endregion
 export { AudioBuses, AudioPlayer, Behavior, CONST_REF_KEY, Engine, HudLayer, 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, UiBanner, UiBar, UiText, VERSION, WebAudioMusicBackend, applyParticlePreset, assetUrls, attachTouchControls, clearBehaviors, clearRegistry, computeViewport, createNode, createNoise2D, createSaveStore, 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-2d-KXn1N1jF.js → physics-2d-Cgli1aju.js}

@@ -1,6 +1,6 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
-import { _ as validateCollider2D, d as Area2D, f as CharacterBody2D, g as Node2D, m as RigidBody2D, p as PhysicsBody2D, u as Joint2D } from "./register-D71C4rDC.js";
+import { _ as validateCollider2D, d as Area2D, f as CharacterBody2D, g as Node2D, m as RigidBody2D, p as PhysicsBody2D, u as Joint2D } from "./register-BJCfuuZ2.js";
 import { n as registerDebugSource } from "./debug-draw-CZmOYjL2.js";
 //#region src/2d/physics/physics-2d.ts
 var physics_2d_exports = /* @__PURE__ */ __exportAll({

package/dist/{physics-3d-C58oQzTX.js → physics-3d-CBAQ12LY.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 { D as CharacterBody3D, E as Area3D, M as validateCollider3D, O as PhysicsBody3D, T as Joint3D, j as Node3D, k as RigidBody3D, x as Terrain3D } from "./register-DvPHJdVj.js";
+import { D as CharacterBody3D, E as Area3D, M as validateCollider3D, O as PhysicsBody3D, T as Joint3D, j as Node3D, k as RigidBody3D, x as Terrain3D } from "./register-Dd7Juujf.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-D8UvwXme.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-BFESHv1X.js").then((n) => n.n)).createGame2D(o)))(opts);
+			const next = await (_gameFactory ?? (mode === "3d" ? async (o) => (await import("./create-game-DkbZCNaV.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-B_sW_eiE.js").then((n) => n.n)).createGame2D(o)))(opts);
 			if (disposed) {
 				next.dispose();
 				return;

package/dist/{register-D71C4rDC.js → register-BJCfuuZ2.js}

@@ -42,6 +42,7 @@ var Node2D = class extends Node {
 	static props = {
 		position: { default: [0, 0] },
 		rotation: { default: 0 },
+		static: { default: false },
 		scale: { default: [1, 1] },
 		renderOrder: { default: 0 },
 		visible: { default: true }
@@ -54,6 +55,8 @@ var Node2D = class extends Node {
 	position = [0, 0];
 	/** Degrees, clockwise. */
 	rotation = 0;
+	/** Frozen after first sync — see Node3D.static (same semantics in 2D). */
+	static = false;
 	scale = [1, 1];
 	/** Draw order among 2D drawables (higher = on top); matches 3D `renderOrder`. */
 	renderOrder = 0;

package/dist/{register-DvPHJdVj.js → register-Dd7Juujf.js}

@@ -203,6 +203,7 @@ var Node3D = class extends Node {
 			0,
 			0
 		] },
+		static: { default: false },
 		scale: { default: [
 			1,
 			1,
@@ -222,6 +223,15 @@ var Node3D = class extends Node {
 		0,
 		0
 	];
+	/**
+	* This subtree never changes after load: the renderer syncs it ONCE and
+	* skips it every frame after (transforms, materials, animations frozen).
+	* The per-frame walk is O(nodes) — marking terrain/buildings/decor static
+	* removes most of a big scene from it. Set `static = false` to resume
+	* live syncing. Do NOT mark animated nodes (Water3D, Particles3D,
+	* AnimatedSprite3D, ModelInstance3D with clips) or cameras static.
+	*/
+	static = false;
 	scale = [
 		1,
 		1,

package/dist/test.js

@@ -4,8 +4,8 @@ import { t as IncantoError } from "./errors-BpWbnbb_.js";
 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-CDFgSG6z.js";
-import { t as registerNodes2D } from "./register-D71C4rDC.js";
-import { t as registerNodes3D } from "./register-DvPHJdVj.js";
+import { t as registerNodes2D } from "./register-BJCfuuZ2.js";
+import { t as registerNodes3D } from "./register-Dd7Juujf.js";
 import { t as registerNodesNet } from "./register-C35HDZpm.js";
 //#region src/test/index.ts
 /**
@@ -129,10 +129,10 @@ async function runScript(json, opts) {
 	engine.setScene(scene);
 	const physics = opts.physics ?? "auto";
 	if (physics === "2d" || physics === "auto" && scene.dimension === "2d") {
-		const { enablePhysics2D } = await import("./physics-2d-KXn1N1jF.js").then((n) => n.r);
+		const { enablePhysics2D } = await import("./physics-2d-Cgli1aju.js").then((n) => n.r);
 		await enablePhysics2D(engine);
 	} else if (physics === "3d" || physics === "auto" && scene.dimension === "3d") {
-		const { enablePhysics3D } = await import("./physics-3d-C58oQzTX.js").then((n) => n.r);
+		const { enablePhysics3D } = await import("./physics-3d-CBAQ12LY.js").then((n) => n.r);
 		await enablePhysics3D(engine);
 	}
 	const failures = [];
@@ -234,10 +234,10 @@ async function createPlaySession(json, opts = {}) {
 	engine.setScene(scene);
 	const physics = opts.physics ?? "auto";
 	if (physics === "2d" || physics === "auto" && scene.dimension === "2d") {
-		const { enablePhysics2D } = await import("./physics-2d-KXn1N1jF.js").then((n) => n.r);
+		const { enablePhysics2D } = await import("./physics-2d-Cgli1aju.js").then((n) => n.r);
 		await enablePhysics2D(engine);
 	} else if (physics === "3d" || physics === "auto" && scene.dimension === "3d") {
-		const { enablePhysics3D } = await import("./physics-3d-C58oQzTX.js").then((n) => n.r);
+		const { enablePhysics3D } = await import("./physics-3d-CBAQ12LY.js").then((n) => n.r);
 		await enablePhysics3D(engine);
 	}
 	const stepMs = 1e3 / (opts.fixedHz ?? 60);

package/editor/assets/{agent8-DruKhR22.js → agent8-MciFwn0v.js}

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