incanto 0.6.0 → 0.7.1

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

@@ -1,14 +1,14 @@
 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-m3CdTGSl.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-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 { O as PhysicsBody3D, c as ModelInstance3D, d as DirectionalLight3D, j as Node3D, t as registerNodes3D, y as Camera3D } from "./register-CpXcMiEk.js";
+import { n as enablePhysics3D } from "./physics-3d-DT5e8izo.js";
+import { ACESFilmicToneMapping, AmbientLight, Box3, BufferAttribute, BufferGeometry, Color, DepthTexture, EquirectangularReflectionMapping, FloatType, Fog, HalfFloatType, LineBasicMaterial, LineSegments, Matrix4, Mesh, PCFShadowMap, PMREMGenerator, PerspectiveCamera, PlaneGeometry, Quaternion, Raycaster, Scene, ShaderMaterial, Vector2, Vector3, WebGLRenderTarget, WebGLRenderer } from "three";
 import { VRMLoaderPlugin, VRMUtils } from "@pixiv/three-vrm";
 import { GLTFLoader } from "three/addons/loaders/GLTFLoader.js";
 import { RGBELoader } from "three/examples/jsm/loaders/RGBELoader.js";
@@ -1073,6 +1073,54 @@ function parseIblIntensity(value) {
 	return value;
 }
 //#endregion
+//#region src/3d/selection-outline.ts
+/**
+* Where IS the node the dev-overlay selected? — world-space outline segments
+* for the renderer's highlight pass. A renderable node gets its actual
+* bounding box (children included); a node with no visual extent gets a
+* small marker cube at its world position so it is still findable.
+*/
+const box = new Box3();
+const size = new Vector3();
+const MARKER_HALF = .4;
+/** 12 box edges = 24 points × xyz. */
+const OUT = new Float32Array(72);
+function selectionOutline3D(node) {
+	if (!(node instanceof Node3D)) return null;
+	const obj = node._ensureObject3D();
+	obj.updateWorldMatrix(true, true);
+	box.setFromObject(obj);
+	box.getSize(size);
+	if (!Number.isFinite(size.x) || size.x === 0 && size.y === 0 && size.z === 0) {
+		const p = new Vector3().setFromMatrixPosition(obj.matrixWorld);
+		box.min.set(p.x - MARKER_HALF, p.y - MARKER_HALF, p.z - MARKER_HALF);
+		box.max.set(p.x + MARKER_HALF, p.y + MARKER_HALF, p.z + MARKER_HALF);
+	} else box.expandByScalar(.02);
+	const { min, max } = box;
+	let i = 0;
+	const seg = (x1, y1, z1, x2, y2, z2) => {
+		OUT[i++] = x1;
+		OUT[i++] = y1;
+		OUT[i++] = z1;
+		OUT[i++] = x2;
+		OUT[i++] = y2;
+		OUT[i++] = z2;
+	};
+	seg(min.x, min.y, min.z, max.x, min.y, min.z);
+	seg(max.x, min.y, min.z, max.x, min.y, max.z);
+	seg(max.x, min.y, max.z, min.x, min.y, max.z);
+	seg(min.x, min.y, max.z, min.x, min.y, min.z);
+	seg(min.x, max.y, min.z, max.x, max.y, min.z);
+	seg(max.x, max.y, min.z, max.x, max.y, max.z);
+	seg(max.x, max.y, max.z, min.x, max.y, max.z);
+	seg(min.x, max.y, max.z, min.x, max.y, min.z);
+	seg(min.x, min.y, min.z, min.x, max.y, min.z);
+	seg(max.x, min.y, min.z, max.x, max.y, min.z);
+	seg(max.x, min.y, max.z, max.x, max.y, max.z);
+	seg(min.x, min.y, max.z, min.x, max.y, max.z);
+	return OUT;
+}
+//#endregion
 //#region src/3d/sync.ts
 function isSpatialConsumer(node) {
 	return node.spatial === true && typeof node._setSpatialPose === "function";
@@ -1449,9 +1497,31 @@ var Renderer3D = class {
 		this.debugLines.renderOrder = 9999;
 		this.debugLines.visible = false;
 		this.threeScene.add(this.debugLines);
+		this.selectionLines = new LineSegments(new BufferGeometry(), new LineBasicMaterial({
+			color: "#ffb020",
+			transparent: true,
+			depthTest: false
+		}));
+		this.selectionLines.frustumCulled = false;
+		this.selectionLines.renderOrder = 1e4;
+		this.selectionLines.visible = false;
+		this.threeScene.add(this.selectionLines);
 		this.disconnect = this.engine.updated.connect(() => this.render());
 	}
 	debugLines;
+	selectionLines;
+	syncSelectionOutline() {
+		const node = this.engine.debugSelection;
+		if (node && node.tree !== this.engine.scene?.tree) this.engine.debugSelection = null;
+		const current = this.engine.debugSelection;
+		const vertices = current ? selectionOutline3D(current) : null;
+		this.selectionLines.visible = vertices !== null;
+		if (vertices) {
+			this.selectionLines.geometry.setAttribute("position", new BufferAttribute(vertices, 3));
+			const attr = this.selectionLines.geometry.getAttribute("position");
+			attr.needsUpdate = true;
+		}
+	}
 	syncDebugLines() {
 		let vertices = null;
 		for (const source of debugSources("3d")) {
@@ -1465,6 +1535,7 @@ var Renderer3D = class {
 		const scene = this.engine.scene;
 		if (!scene) return;
 		this.syncDebugLines();
+		this.syncSelectionOutline();
 		if (scene.assets && !this.loadedAssetScenes.has(scene)) {
 			this.assets.load(scene.assets);
 			this.loadedAssetScenes.add(scene);

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, E as LogLevel, v as Engine } from "./behavior-q3cejJgs.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 = {
@@ -326,6 +328,7 @@ var DebugOverlay = class {
 		}
 	}
 	dispose() {
+		this.engine.debugSelection = null;
 		this.setConsoleCapture(false);
 		for (const cleanup of this.cleanups) cleanup();
 		for (const id of [...this.panels.keys()]) this.close(id);
@@ -418,26 +421,75 @@ 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.engine.debugSelection = 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");
@@ -446,6 +498,7 @@ var DebugOverlay = class {
 		let node = this.selected;
 		if (node && node.tree === null) {
 			this.selected = null;
+			this.engine.debugSelection = null;
 			node = null;
 		}
 		if (!node) {

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 { Z as Node, l as PropSchema, n as BehaviorCtor, t as Behavior, v as Engine } from "./behavior-q3cejJgs.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 Signal, A as SfxPlayOptions, B as SFX_PRESET_NAMES, C as RendererStats, D as LogManager, E as LogLevel, F as SpatialParams, G as MusicBackend, H as SfxWave, I as Vec3, J as PlayMusicOptions, K as MusicManager, L as spatialGain, M as Listener, N as ROLLOFF_MODELS, O as InputMap, P as RolloffModel, Q as NodeLifecycle, R as spatialPan, S as GameStats, T as LogEntry, U as SynthOptions, V as SfxParams, W as synthSfx, X as BusName, Y as AudioBuses, Z as Node, _ as registeredTypes, a as registerBehavior, b as Scheduler, c as PropDef, d as createNode, et as SignalListener, f as getNodeSchema, g as registerNode, h as mergeStaticSignals, i as getBehavior, j as isAudioContextAvailable, k as SfxEngine, l as PropSchema, m as getNodeType, n as BehaviorCtor, o as registeredBehaviors, p as getNodeSignals, q as MusicTrack, r as clearBehaviors, s as NodeCtor, t as Behavior, tt as SceneTree, u as clearRegistry, v as Engine, w as Scene, x as EngineStats, y as EngineOptions, z as SFX_PRESETS } from "./behavior-q3cejJgs.js";
+import { n as loadScene, t as LoadSceneOptions } from "./loader-DnLMMRy8.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-C3bH_eZ5.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-m3CdTGSl.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.6.0";
+const VERSION = "0.7.1";
 //#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 };

package/dist/{loader-D2u0fVW2.d.ts → loader-DnLMMRy8.d.ts}

@@ -1,5 +1,5 @@
 import { i as SceneJson } from "./schema-CcoWb32N.js";
-import { v as Engine, w as Scene } from "./behavior-CWhW3oa6.js";
+import { v as Engine, w as Scene } from "./behavior-q3cejJgs.js";
 
 //#region src/core/scene/loader.d.ts
 interface LoadSceneOptions {

package/dist/net.d.ts

@@ -1,5 +1,5 @@
 import { c as JsonValue, i as SceneJson, s as JsonObject } from "./schema-CcoWb32N.js";
-import { T as Node, et as Signal, l as PropSchema, v as Engine } from "./behavior-CWhW3oa6.js";
+import { $ as Signal, Z as Node, l as PropSchema, v as Engine } from "./behavior-q3cejJgs.js";
 
 //#region src/net/types.d.ts
 type Unsubscribe = () => void;

package/dist/{particle-sim-CFkILGwh.js → particle-sim-m3CdTGSl.js}

@@ -1011,6 +1011,28 @@ var Engine = class {
 	* timers, behaviors all breathe together. See `gameplay` `hitStop()`.
 	*/
 	timeScale = 1;
+	/**
+	* The node the dev overlay has selected (renderers draw its bounding box
+	* as an orange outline in the game view so you can SEE what you picked).
+	* Null when nothing is selected; cleared automatically when it leaves the
+	* tree. Set by the debug overlay — games normally never touch this.
+	*/
+	debugSelection = null;
+	_time = 0;
+	_unscaledTime = 0;
+	/**
+	* 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() {
+		return this._time;
+	}
+	/** 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() {
+		return this._unscaledTime;
+	}
 	constructor(opts = {}) {
 		this.fixedStep = 1 / (opts.fixedHz ?? 60);
 		this.maxFixedSteps = opts.maxFixedStepsPerTick ?? 5;
@@ -1028,6 +1050,8 @@ var Engine = class {
 		this._scene = scene;
 		scene.tree._setEngine(this);
 		this.input.clear();
+		this._time = 0;
+		this._unscaledTime = 0;
 		if (scene.input) this.input.declare(scene.input);
 		this.sceneChanged.emit(scene);
 	}
@@ -1107,7 +1131,10 @@ var Engine = class {
 			this.lastMs = nowMs;
 			return;
 		}
-		const dt = Math.min((nowMs - this.lastMs) / 1e3, MAX_DT_SECONDS) * this.timeScale;
+		const rawDt = Math.min((nowMs - this.lastMs) / 1e3, MAX_DT_SECONDS);
+		const dt = rawDt * this.timeScale;
+		this._time += dt;
+		this._unscaledTime += rawDt;
 		this.lastMs = nowMs;
 		const scene = this._scene;
 		if (!scene) return;
@@ -1132,6 +1159,20 @@ function countNodes(root) {
 	return n;
 }
 //#endregion
+//#region src/core/order-groups.ts
+const ORDER_GROUP_BASE = {
+	background: -2e3,
+	terrain: -1e3,
+	default: 0,
+	characters: 1e3,
+	effects: 2e3,
+	overlay: 3e3
+};
+/** base + fine offset (unknown group names fall back to `default`). */
+function effectiveOrder(group, renderOrder) {
+	return (ORDER_GROUP_BASE[group] ?? 0) + renderOrder;
+}
+//#endregion
 //#region src/core/particle-presets.ts
 const PARTICLE_PRESETS = {
 	fire: {
@@ -1397,4 +1438,4 @@ var ParticleSim = class {
 	}
 };
 //#endregion
-export { Engine as a, SfxEngine as c, WebAudioMusicBackend as d, crossfadeGains as f, applyParticlePreset as i, isAudioContextAvailable as l, AudioBuses as m, PARTICLE_PRESETS as n, LogManager as o, fadeGain as p, PARTICLE_PRESET_NAMES as r, InputMap as s, ParticleSim as t, MusicManager as u };
+export { ORDER_GROUP_BASE as a, LogManager as c, isAudioContextAvailable as d, MusicManager as f, AudioBuses as g, fadeGain as h, applyParticlePreset as i, InputMap as l, crossfadeGains as m, PARTICLE_PRESETS as n, effectiveOrder as o, WebAudioMusicBackend as p, PARTICLE_PRESET_NAMES as r, Engine as s, ParticleSim as t, SfxEngine as u };

package/dist/{physics-2d-Cgli1aju.js → physics-2d-CZM5Y90X.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-BJCfuuZ2.js";
+import { _ as validateCollider2D, d as Area2D, f as CharacterBody2D, g as Node2D, m as RigidBody2D, p as PhysicsBody2D, u as Joint2D } from "./register-Cl3pAxX-.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-CBAQ12LY.js → physics-3d-DT5e8izo.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-Dd7Juujf.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-CpXcMiEk.js";
 import { Euler, Quaternion } from "three";
 //#region src/3d/physics/physics-3d.ts
 var physics_3d_exports = /* @__PURE__ */ __exportAll({

package/dist/react.d.ts

@@ -1,5 +1,5 @@
 import { c as JsonValue } from "./schema-CcoWb32N.js";
-import { n as BehaviorCtor, v as Engine, w as Scene } from "./behavior-CWhW3oa6.js";
+import { n as BehaviorCtor, v as Engine, w as Scene } from "./behavior-q3cejJgs.js";
 import { CSSProperties, ReactNode } from "react";
 
 //#region src/react/index.d.ts

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-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);
+			const next = await (_gameFactory ?? (mode === "3d" ? async (o) => (await import("./create-game-rFulaS3s.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-DuDkqnjl.js").then((n) => n.n)).createGame2D(o)))(opts);
 			if (disposed) {
 				next.dispose();
 				return;

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

@@ -1,5 +1,5 @@
 import { f as Node } from "./loader-B4OEXDZ8.js";
-import { i as applyParticlePreset, r as PARTICLE_PRESET_NAMES, t as ParticleSim } from "./particle-sim-CFkILGwh.js";
+import { i as applyParticlePreset, o as effectiveOrder, r as PARTICLE_PRESET_NAMES, t as ParticleSim } from "./particle-sim-m3CdTGSl.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as Rng } from "./rng-DP-SR7eg.js";
 import { t as registerCoreNodes } from "./register-Dl_ixIJe.js";
@@ -45,6 +45,17 @@ var Node2D = class extends Node {
 		static: { default: false },
 		scale: { default: [1, 1] },
 		renderOrder: { default: 0 },
+		orderGroup: {
+			default: "default",
+			options: [
+				"background",
+				"terrain",
+				"default",
+				"characters",
+				"effects",
+				"overlay"
+			]
+		},
 		visible: { default: true }
 	};
 	/** Legacy alias: old 2D scenes (and `zIndex`-trained agents) keep loading —
@@ -60,6 +71,12 @@ var Node2D = class extends Node {
 	scale = [1, 1];
 	/** Draw order among 2D drawables (higher = on top); matches 3D `renderOrder`. */
 	renderOrder = 0;
+	/** Named draw-order band; `renderOrder` is the fine offset inside it. */
+	orderGroup = "default";
+	/** What three actually sorts by: band base + renderOrder. */
+	get effectiveRenderOrder() {
+		return effectiveOrder(this.orderGroup, this.renderOrder);
+	}
 	visible = true;
 	_object2D = null;
 	/** @internal The backing three object (lazily created). */
@@ -308,7 +325,7 @@ var Sprite2D = class extends Node2D {
 		const ax = this.anchor[0] ?? .5;
 		const ay = this.anchor[1] ?? .5;
 		quad.position.set((.5 - ax) * w, (ay - .5) * h, 0);
-		quad.renderOrder = this.renderOrder;
+		quad.renderOrder = this.effectiveRenderOrder;
 		mat.color.set(this.tint);
 		mat.opacity = this.opacity;
 	}
@@ -571,7 +588,7 @@ var ColorRect2D = class extends Node2D {
 		const ax = this.anchor[0] ?? .5;
 		const ay = this.anchor[1] ?? .5;
 		quad.position.set((.5 - ax) * w, (ay - .5) * h, 0);
-		quad.renderOrder = this.renderOrder;
+		quad.renderOrder = this.effectiveRenderOrder;
 		const mat = quad.material;
 		mat.color.set(this.color);
 		mat.opacity = this.opacity;
@@ -627,7 +644,7 @@ var Label = class extends Node2D {
 			this.rasterize();
 		}
 		quad.visible = true;
-		quad.renderOrder = this.renderOrder;
+		quad.renderOrder = this.effectiveRenderOrder;
 	}
 	rasterize() {
 		const dpr = Math.min(globalThis.devicePixelRatio ?? 1, 2);
@@ -669,9 +686,21 @@ const UNIT_PLANE = new PlaneGeometry(1, 1);
 * Simulation is deterministic under the engine seed.
 */
 var Particles2D = class Particles2D extends Node2D {
+	orderGroup = "effects";
 	static typeName = "Particles2D";
 	static signals = ["finished"];
 	static props = {
+		orderGroup: {
+			default: "effects",
+			options: [
+				"background",
+				"terrain",
+				"default",
+				"characters",
+				"effects",
+				"overlay"
+			]
+		},
 		preset: {
 			default: "custom",
 			options: ["custom", ...PARTICLE_PRESET_NAMES]
@@ -837,7 +866,7 @@ var Particles2D = class Particles2D extends Node2D {
 		mesh.count = index;
 		mesh.instanceMatrix.needsUpdate = true;
 		if (mesh.instanceColor) mesh.instanceColor.needsUpdate = true;
-		mesh.renderOrder = this.renderOrder;
+		mesh.renderOrder = this.effectiveRenderOrder;
 	}
 };
 const matrixScratch = new Matrix4();

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

@@ -1,5 +1,5 @@
 import { f as Node } from "./loader-B4OEXDZ8.js";
-import { i as applyParticlePreset, r as PARTICLE_PRESET_NAMES, t as ParticleSim } from "./particle-sim-CFkILGwh.js";
+import { i as applyParticlePreset, o as effectiveOrder, r as PARTICLE_PRESET_NAMES, t as ParticleSim } from "./particle-sim-m3CdTGSl.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as Rng } from "./rng-DP-SR7eg.js";
 import { t as registerCoreNodes } from "./register-Dl_ixIJe.js";
@@ -210,7 +210,18 @@ var Node3D = class extends Node {
 			1
 		] },
 		visible: { default: true },
-		renderOrder: { default: 0 }
+		renderOrder: { default: 0 },
+		orderGroup: {
+			default: "default",
+			options: [
+				"background",
+				"terrain",
+				"default",
+				"characters",
+				"effects",
+				"overlay"
+			]
+		}
 	};
 	position = [
 		0,
@@ -242,6 +253,12 @@ var Node3D = class extends Node {
 	* materials — three sorts the transparent pass by renderOrder, then depth.
 	* Pairs with named scene constants (e.g. `{"@const": "UI"}`) for sorting tiers. */
 	renderOrder = 0;
+	/** Named draw-order band; `renderOrder` is the fine offset inside it. */
+	orderGroup = "default";
+	/** What three actually sorts by: band base + renderOrder. */
+	get effectiveRenderOrder() {
+		return effectiveOrder(this.orderGroup, this.renderOrder);
+	}
 	_object3D = null;
 	/**
 	* @internal Fixed-step render interpolation. A physics body fills these with
@@ -275,7 +292,7 @@ var Node3D = class extends Node {
 		o.rotation.set(MathUtils.degToRad(this.rotation[0] ?? 0), MathUtils.degToRad(this.rotation[1] ?? 0), MathUtils.degToRad(this.rotation[2] ?? 0));
 		o.scale.set(this.scale[0] ?? 1, this.scale[1] ?? 1, this.scale[2] ?? 1);
 		o.visible = this.visible;
-		o.renderOrder = this.renderOrder;
+		o.renderOrder = this.effectiveRenderOrder;
 	}
 	free() {
 		super.free();
@@ -1139,8 +1156,20 @@ const MAX_RESOLUTION = 128;
 * real numbers off `heightAt`.
 */
 var Terrain3D = class extends Node3D {
+	orderGroup = "terrain";
 	static typeName = "Terrain3D";
 	static props = {
+		orderGroup: {
+			default: "terrain",
+			options: [
+				"background",
+				"terrain",
+				"default",
+				"characters",
+				"effects",
+				"overlay"
+			]
+		},
 		size: { default: [200, 200] },
 		maxHeight: { default: 28 },
 		seed: { default: 1 },
@@ -5820,9 +5849,21 @@ const PX_TO_M = .01;
 * tilts emission out of the plane too).
 */
 var Particles3D = class Particles3D extends Node3D {
+	orderGroup = "effects";
 	static typeName = "Particles3D";
 	static signals = ["finished"];
 	static props = {
+		orderGroup: {
+			default: "effects",
+			options: [
+				"background",
+				"terrain",
+				"default",
+				"characters",
+				"effects",
+				"overlay"
+			]
+		},
 		preset: {
 			default: "custom",
 			options: ["custom", ...PARTICLE_PRESET_NAMES]

package/dist/test.d.ts

@@ -1,6 +1,6 @@
 import { c as JsonValue, i as SceneJson } from "./schema-CcoWb32N.js";
-import { O as LogEntry, T as Node, n as BehaviorCtor, v as Engine, w as Scene } from "./behavior-CWhW3oa6.js";
-import { t as LoadSceneOptions } from "./loader-D2u0fVW2.js";
+import { T as LogEntry, Z as Node, n as BehaviorCtor, v as Engine, w as Scene } from "./behavior-q3cejJgs.js";
+import { t as LoadSceneOptions } from "./loader-DnLMMRy8.js";
 import { t as IncantoError } from "./errors-BMFaY68Q.js";
 
 //#region src/test/index.d.ts