incanto 0.5.0 → 0.7.0

package/dist/2d.d.ts

@@ -1,6 +1,6 @@
 import { s as JsonObject } from "./schema-CcoWb32N.js";
-import { C as RendererStats, S as GameStats, T as Node, b as Scheduler, l as PropSchema, n as BehaviorCtor, v as Engine, w as Scene$1 } from "./behavior-CWhW3oa6.js";
-import { t as LoadSceneOptions } from "./loader-D2u0fVW2.js";
+import { C as RendererStats, S as GameStats, T as Node, b as Scheduler, l as PropSchema, n as BehaviorCtor, v as Engine, w as Scene$1 } from "./behavior-e3kAmPGC.js";
+import { t as LoadSceneOptions } from "./loader-y_X4zYO0.js";
 import { t as ParticleSim } from "./particle-sim-CwJ5rI_P.js";
 import { Group, Mesh, Object3D, Scene, Texture } from "three";
 import * as RapierNs from "@dimforge/rapier2d-compat";
@@ -52,9 +52,15 @@ 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;
+  /** Named draw-order band; `renderOrder` is the fine offset inside it. */
+  orderGroup: string;
+  /** What three actually sorts by: band base + renderOrder. */
+  get effectiveRenderOrder(): number;
   visible: boolean;
   private _object2D;
   /** @internal The backing three object (lazily created). */
@@ -505,6 +511,7 @@ declare class Label extends Node2D {
 * Simulation is deterministic under the engine seed.
 */
 declare class Particles2D extends Node2D {
+  override orderGroup: string;
   static override readonly typeName: string;
   static override readonly signals: readonly string[];
   static override readonly props: PropSchema;
@@ -636,6 +643,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 +714,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-X5iRu6pf.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-ClKnoILk.js";
+import { n as enablePhysics2D, t as Physics2D } from "./physics-2d-DmQ540uR.js";
 //#region src/2d/library-sprite.ts
 /**
 * Turn a library sprite-animation JSON into a scene-ready spritesheet asset

package/dist/3d.d.ts

@@ -1,8 +1,8 @@
 import { s as JsonObject } from "./schema-CcoWb32N.js";
-import { C as RendererStats, S as GameStats, T as Node, b as Scheduler, l as PropSchema, n as BehaviorCtor, v as Engine, w as Scene$1 } from "./behavior-CWhW3oa6.js";
-import { t as LoadSceneOptions } from "./loader-D2u0fVW2.js";
+import { C as RendererStats, S as GameStats, T as Node, b as Scheduler, l as PropSchema, n as BehaviorCtor, v as Engine, w as Scene$1 } from "./behavior-e3kAmPGC.js";
+import { t as LoadSceneOptions } from "./loader-y_X4zYO0.js";
 import { t as ParticleSim } from "./particle-sim-CwJ5rI_P.js";
-import { r as SpatialPose } from "./audio-player-DkBqRTs4.js";
+import { r as SpatialPose } from "./audio-player-VSjk_vG8.js";
 import { AnimationClip, BufferGeometry, Color, DirectionalLight, InstancedMesh, MeshPhysicalMaterial, Object3D, PerspectiveCamera, Scene, Vector3, WebGLRenderer } from "three";
 import { VRM } from "@pixiv/three-vrm";
 import { Sky } from "three/examples/jsm/objects/Sky.js";
@@ -137,12 +137,25 @@ 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
   * materials — three sorts the transparent pass by renderOrder, then depth.
   * Pairs with named scene constants (e.g. `{"@const": "UI"}`) for sorting tiers. */
   renderOrder: number;
+  /** Named draw-order band; `renderOrder` is the fine offset inside it. */
+  orderGroup: string;
+  /** What three actually sorts by: band base + renderOrder. */
+  get effectiveRenderOrder(): number;
   private _object3D;
   /**
   * @internal Fixed-step render interpolation. A physics body fills these with
@@ -412,6 +425,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. */
@@ -1274,6 +1295,7 @@ declare class ModelInstance3D extends Node3D {
 * tilts emission out of the plane too).
 */
 declare class Particles3D extends Node3D {
+  override orderGroup: string;
   static override readonly typeName: string;
   static override readonly signals: readonly string[];
   static override readonly props: PropSchema;
@@ -1469,6 +1491,7 @@ declare function terrainThemeLayers(theme: TerrainTheme, textureBase: string): T
 * real numbers off `heightAt`.
 */
 declare class Terrain3D extends Node3D {
+  override orderGroup: string;
   static override readonly typeName: string;
   static override readonly props: PropSchema;
   /** [width, depth] extent in meters, centered on the node. */
@@ -1914,6 +1937,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 +2025,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 +2073,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 +2111,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-CEFoFN8d.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-CscQqB7V.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-CDjuhtt_.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/{audio-player-DkBqRTs4.d.ts → audio-player-VSjk_vG8.d.ts}

@@ -1,4 +1,4 @@
-import { F as Listener, T as Node, l as PropSchema } from "./behavior-CWhW3oa6.js";
+import { F as Listener, T as Node, l as PropSchema } from "./behavior-e3kAmPGC.js";
 
 //#region src/core/nodes/audio-player.d.ts
 /**

package/dist/{behavior-CWhW3oa6.d.ts → behavior-e3kAmPGC.d.ts}

@@ -773,6 +773,17 @@ declare class Engine {
   * timers, behaviors all breathe together. See `gameplay` `hitStop()`.
   */
   timeScale: number;
+  private _time;
+  private _unscaledTime;
+  /**
+  * Elapsed GAME time in seconds since the scene started — the sum of every
+  * scaled dt (freezes at timeScale 0, crawls in slow motion). Unity's
+  * `Time.time`. Resets on `setScene`.
+  */
+  get time(): number;
+  /** Elapsed REAL time in seconds since the scene started (ignores timeScale) —
+  *  UI animations that must keep moving during slow-mo/pause read this. */
+  get unscaledTime(): number;
   constructor(opts?: EngineOptions);
   get scene(): Scene | null;
   /** Replace the active scene. The previous scene's root is freed. */

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

@@ -1,13 +1,13 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
 import { _ as registerBehavior, n as loadScene } from "./loader-B4OEXDZ8.js";
-import { a as Engine } from "./particle-sim-CFkILGwh.js";
+import { s as Engine } from "./particle-sim-CrTE7c02.js";
 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 { 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-CscQqB7V.js";
+import { n as enablePhysics3D } from "./physics-3d-CDjuhtt_.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/{create-game-BFESHv1X.js → create-game-X5iRu6pf.js}

@@ -1,13 +1,13 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
 import { _ as registerBehavior, n as loadScene, o as computeViewport, s as resolveViewport } from "./loader-B4OEXDZ8.js";
-import { a as Engine } from "./particle-sim-CFkILGwh.js";
+import { s as Engine } from "./particle-sim-CrTE7c02.js";
 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-ClKnoILk.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-DmQ540uR.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/debug.d.ts

@@ -1,4 +1,4 @@
-import { C as RendererStats, k as LogLevel, v as Engine } from "./behavior-CWhW3oa6.js";
+import { C as RendererStats, k as LogLevel, v as Engine } from "./behavior-e3kAmPGC.js";
 
 //#region src/debug/panel.d.ts
 /** Minimal document surface the overlay needs (injectable for tests). */
@@ -32,6 +32,8 @@ declare class DebugOverlay {
   private readonly menuButton;
   private dropdown;
   private selected;
+  /** Explorer subtrees the user collapsed (nodes keep identity across frames). */
+  private readonly collapsedFlags;
   private statsChip;
   private readonly logRows;
   private readonly levelEnabled;

package/dist/debug.js

@@ -178,6 +178,8 @@ var DebugOverlay = class {
 	menuButton;
 	dropdown = null;
 	selected = null;
+	/** Explorer subtrees the user collapsed (nodes keep identity across frames). */
+	collapsedFlags = /* @__PURE__ */ new Map();
 	statsChip = null;
 	logRows = [];
 	levelEnabled = {
@@ -418,26 +420,74 @@ var DebugOverlay = class {
 		clear(panel.body);
 		const root = this.engine.scene?.root;
 		if (!root) return;
-		const renderNode = (node, depth) => {
+		const renderNode = (node, container) => {
 			const ctor = node.constructor;
+			const hasKids = node.children.length > 0;
+			const isCollapsed = this.collapsedFlags.get(node) === true;
 			const row = this.doc.createElement("div");
-			row.textContent = `${"  ".repeat(depth)}${node.name} (${ctor.typeName})`;
 			applyStyle(row, {
-				whiteSpace: "pre",
+				display: "flex",
+				alignItems: "center",
 				cursor: "pointer",
 				padding: "1px 2px",
+				borderRadius: "3px",
 				background: node === this.selected ? "rgba(110,160,255,0.25)" : "transparent"
 			});
+			const chevron = this.doc.createElement("span");
+			chevron.textContent = hasKids ? isCollapsed ? "▸" : "▾" : "·";
+			applyStyle(chevron, {
+				width: "14px",
+				flex: "none",
+				textAlign: "center",
+				opacity: hasKids ? "0.85" : "0.25",
+				userSelect: "none"
+			});
+			if (hasKids) chevron.addEventListener("click", (e) => {
+				e.stopPropagation?.();
+				this.collapsedFlags.set(node, !isCollapsed);
+				this.renderExplorer();
+			});
+			row.appendChild(chevron);
+			const label = this.doc.createElement("span");
+			label.textContent = node.name;
+			applyStyle(label, { whiteSpace: "nowrap" });
+			row.appendChild(label);
+			const type = this.doc.createElement("span");
+			type.textContent = ` ${ctor.typeName}`;
+			applyStyle(type, {
+				opacity: "0.45",
+				whiteSpace: "nowrap",
+				fontSize: "10px"
+			});
+			row.appendChild(type);
+			if (hasKids && isCollapsed) {
+				const count = this.doc.createElement("span");
+				count.textContent = ` (${node.children.length})`;
+				applyStyle(count, {
+					opacity: "0.35",
+					fontSize: "10px"
+				});
+				row.appendChild(count);
+			}
 			row.addEventListener("click", () => {
 				this.selected = node;
 				this.open("inspector");
 				this.renderExplorer();
 				this.renderInspector();
 			});
-			panel.body.appendChild(row);
-			for (const child of node.children) renderNode(child, depth + 1);
+			container.appendChild(row);
+			if (hasKids && !isCollapsed) {
+				const kids = this.doc.createElement("div");
+				applyStyle(kids, {
+					marginLeft: "8px",
+					paddingLeft: "8px",
+					borderLeft: "1px solid rgba(255,255,255,0.14)"
+				});
+				for (const child of node.children) renderNode(child, kids);
+				container.appendChild(kids);
+			}
 		};
-		renderNode(root, 0);
+		renderNode(root, panel.body);
 	}
 	renderInspector() {
 		const panel = this.panels.get("inspector");

package/dist/gameplay.d.ts

@@ -1,5 +1,5 @@
 import { c as JsonValue } from "./schema-CcoWb32N.js";
-import { T as Node, l as PropSchema, n as BehaviorCtor, t as Behavior, v as Engine } from "./behavior-CWhW3oa6.js";
+import { T as Node, l as PropSchema, n as BehaviorCtor, t as Behavior, v as Engine } from "./behavior-e3kAmPGC.js";
 
 //#region src/gameplay/chase.d.ts
 /**

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 import { a as Rng, c as JsonValue, d as jsonKind, i as SceneJson, l as jsonClone, n as NodeJson, o as JsonKind, r as SCENE_FORMAT, s as JsonObject, t as ConnectionJson, u as jsonEquals } from "./schema-CcoWb32N.js";
-import { $ as BusName, A as LogManager, B as spatialGain, C as RendererStats, D as SceneTree, E as NodeLifecycle, F as Listener, G as SfxWave, H as SFX_PRESETS, I as ROLLOFF_MODELS, J as MusicBackend, K as SynthOptions, L as RolloffModel, M as SfxEngine, N as SfxPlayOptions, O as LogEntry, P as isAudioContextAvailable, Q as AudioBuses, R as SpatialParams, S as GameStats, T as Node, U as SFX_PRESET_NAMES, V as spatialPan, W as SfxParams, X as MusicTrack, Y as MusicManager, Z as PlayMusicOptions, _ as registeredTypes, a as registerBehavior, b as Scheduler, c as PropDef, d as createNode, et as Signal, f as getNodeSchema, g as registerNode, h as mergeStaticSignals, i as getBehavior, j as InputMap, k as LogLevel, l as PropSchema, m as getNodeType, n as BehaviorCtor, o as registeredBehaviors, p as getNodeSignals, q as synthSfx, r as clearBehaviors, s as NodeCtor, t as Behavior, tt as SignalListener, u as clearRegistry, v as Engine, w as Scene, x as EngineStats, y as EngineOptions, z as Vec3 } from "./behavior-CWhW3oa6.js";
-import { n as loadScene, t as LoadSceneOptions } from "./loader-D2u0fVW2.js";
+import { $ as BusName, A as LogManager, B as spatialGain, C as RendererStats, D as SceneTree, E as NodeLifecycle, F as Listener, G as SfxWave, H as SFX_PRESETS, I as ROLLOFF_MODELS, J as MusicBackend, K as SynthOptions, L as RolloffModel, M as SfxEngine, N as SfxPlayOptions, O as LogEntry, P as isAudioContextAvailable, Q as AudioBuses, R as SpatialParams, S as GameStats, T as Node, U as SFX_PRESET_NAMES, V as spatialPan, W as SfxParams, X as MusicTrack, Y as MusicManager, Z as PlayMusicOptions, _ as registeredTypes, a as registerBehavior, b as Scheduler, c as PropDef, d as createNode, et as Signal, f as getNodeSchema, g as registerNode, h as mergeStaticSignals, i as getBehavior, j as InputMap, k as LogLevel, l as PropSchema, m as getNodeType, n as BehaviorCtor, o as registeredBehaviors, p as getNodeSignals, q as synthSfx, r as clearBehaviors, s as NodeCtor, t as Behavior, tt as SignalListener, u as clearRegistry, v as Engine, w as Scene, x as EngineStats, y as EngineOptions, z as Vec3 } from "./behavior-e3kAmPGC.js";
+import { n as loadScene, t as LoadSceneOptions } from "./loader-y_X4zYO0.js";
 import { n as ParticleSimConfig, r as ParticleView, t as ParticleSim } from "./particle-sim-CwJ5rI_P.js";
-import { n as AudioPlayer, t as AudioElementLike } from "./audio-player-DkBqRTs4.js";
+import { n as AudioPlayer, t as AudioElementLike } from "./audio-player-VSjk_vG8.js";
 import { n as IncantoErrorCode, r as IncantoErrorDetails, t as IncantoError } from "./errors-BMFaY68Q.js";
 
 //#region src/core/audio/crossfade.d.ts
@@ -218,6 +218,23 @@ declare class Timer extends Node {
 */
 declare function createNoise2D(seed: number): (x: number, y: number) => number;
 //#endregion
+//#region src/core/order-groups.d.ts
+/**
+* Named draw-order bands — Unity's "sorting layers" for both dimensions.
+* A node's effective render order is `base(orderGroup) + renderOrder`, so
+* `renderOrder` stays a FINE offset within its band and whole categories
+* layer correctly without magic numbers:
+*
+*   background < terrain < default < characters < effects < overlay
+*
+* Engine type defaults: particles sit in `effects`, Terrain3D in `terrain`;
+* everything else is `default` (base 0 — identical to pre-band behavior).
+*/
+type OrderGroup = "background" | "terrain" | "default" | "characters" | "effects" | "overlay";
+declare const ORDER_GROUP_BASE: Record<OrderGroup, number>;
+/** base + fine offset (unknown group names fall back to `default`). */
+declare function effectiveOrder(group: string, renderOrder: number): number;
+//#endregion
 //#region src/core/particle-presets.d.ts
 /**
 * Predefined particle looks. A node's `preset` seeds these values UNDER its
@@ -436,4 +453,4 @@ declare function computeViewport(canvasW: number, canvasH: number, viewport: {
 /** Engine version. Kept in sync with package.json by the release pipeline. */
 declare const VERSION: string;
 //#endregion
-export { AudioBuses, type AudioElementLike, AudioPlayer, Behavior, type BehaviorCtor, type BusName, CONST_REF_KEY, type ComputedViewport, type ConnectionJson, type CrossfadeGains, type DebugLineSource, Engine, type EngineOptions, type EngineStats, type GameStats, type HudAnchor, HudLayer, IncantoError, type IncantoErrorCode, type IncantoErrorDetails, InputMap, type JsonKind, type JsonObject, type JsonValue, type Listener, type LoadSceneOptions, type LogEntry, type LogLevel, LogManager, type MusicBackend, MusicManager, type MusicTrack, Node, type NodeCtor, type NodeJson, type NodeLifecycle, PARTICLE_PRESETS, PARTICLE_PRESET_NAMES, type ParsedNodePath, type ParticlePresetValues, ParticleSim, type ParticleSimConfig, type ParticleView, type PlayMusicOptions, type PreloadResult, type PropDef, type PropSchema, ROLLOFF_MODELS, type RendererStats, type ResolvedRendering, type ResolvedViewport, Rng, type RolloffModel, SCENE_FORMAT, SFX_PRESETS, SFX_PRESET_NAMES, type SaveStore, Scene, type SceneJson, SceneTree, type Scheduler, SfxEngine, type SfxParams, type SfxPlayOptions, type SfxWave, Signal, type SignalListener, type SpatialParams, type SynthOptions, Timer, TouchControls, type TouchControlsOptions, UiBanner, UiBar, UiText, VERSION, type Vec3, type ViewportFit, 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 };
+export { AudioBuses, type AudioElementLike, AudioPlayer, Behavior, type BehaviorCtor, type BusName, CONST_REF_KEY, type ComputedViewport, type ConnectionJson, type CrossfadeGains, type DebugLineSource, Engine, type EngineOptions, type EngineStats, type GameStats, type HudAnchor, HudLayer, IncantoError, type IncantoErrorCode, type IncantoErrorDetails, InputMap, type JsonKind, type JsonObject, type JsonValue, type Listener, type LoadSceneOptions, type LogEntry, type LogLevel, LogManager, type MusicBackend, MusicManager, type MusicTrack, Node, type NodeCtor, type NodeJson, type NodeLifecycle, ORDER_GROUP_BASE, type OrderGroup, PARTICLE_PRESETS, PARTICLE_PRESET_NAMES, type ParsedNodePath, type ParticlePresetValues, ParticleSim, type ParticleSimConfig, type ParticleView, type PlayMusicOptions, type PreloadResult, type PropDef, type PropSchema, ROLLOFF_MODELS, type RendererStats, type ResolvedRendering, type ResolvedViewport, Rng, type RolloffModel, SCENE_FORMAT, SFX_PRESETS, SFX_PRESET_NAMES, type SaveStore, Scene, type SceneJson, SceneTree, type Scheduler, SfxEngine, type SfxParams, type SfxPlayOptions, type SfxWave, Signal, type SignalListener, type SpatialParams, type SynthOptions, Timer, TouchControls, type TouchControlsOptions, UiBanner, UiBar, UiText, VERSION, type Vec3, type ViewportFit, WebAudioMusicBackend, applyParticlePreset, assetUrls, attachTouchControls, clearBehaviors, clearRegistry, computeViewport, createNode, createNoise2D, createSaveStore, crossfadeGains, duplicateNode, effectiveOrder, 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/index.js

@@ -1,5 +1,5 @@
 import { _ as registerBehavior, a as SCENE_FORMAT, c as SceneTree, d as resolveConstants, f as Node, g as getBehavior, h as clearBehaviors, i as serializeNode, l as CONST_REF_KEY, m as Behavior, n as loadScene, o as computeViewport, p as parseNodePath, r as Scene, s as resolveViewport, u as isConstRef, v as registeredBehaviors, y as Signal } from "./loader-B4OEXDZ8.js";
-import { a as Engine, c as SfxEngine, d as WebAudioMusicBackend, f as crossfadeGains, i as applyParticlePreset, l as isAudioContextAvailable, m as AudioBuses, n as PARTICLE_PRESETS, o as LogManager, p as fadeGain, r as PARTICLE_PRESET_NAMES, s as InputMap, t as ParticleSim, u as MusicManager } from "./particle-sim-CFkILGwh.js";
+import { a as ORDER_GROUP_BASE, c as LogManager, d as isAudioContextAvailable, f as MusicManager, g as AudioBuses, h as fadeGain, i as applyParticlePreset, l as InputMap, m as crossfadeGains, n as PARTICLE_PRESETS, o as effectiveOrder, p as WebAudioMusicBackend, r as PARTICLE_PRESET_NAMES, s as Engine, t as ParticleSim, u as SfxEngine } from "./particle-sim-CrTE7c02.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as Rng } from "./rng-DP-SR7eg.js";
 import { a as UiBar, c as ROLLOFF_MODELS, d as SFX_PRESETS, f as SFX_PRESET_NAMES, i as UiBanner, l as spatialGain, n as Timer, o as UiText, p as synthSfx, r as HudLayer, s as AudioPlayer, t as registerCoreNodes, u as spatialPan } from "./register-Dl_ixIJe.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.7.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 };
+export { AudioBuses, AudioPlayer, Behavior, CONST_REF_KEY, Engine, HudLayer, IncantoError, InputMap, LogManager, MusicManager, Node, ORDER_GROUP_BASE, 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, effectiveOrder, 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 };