incanto 0.6.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";
@@ -57,6 +57,10 @@ declare class Node2D extends Node {
   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). */
@@ -507,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;

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-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";
+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";
@@ -152,6 +152,10 @@ declare class Node3D 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: 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
@@ -1291,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;
@@ -1486,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. */

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-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 { 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-CBAQ12LY.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-DkbZCNaV.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-Dd7Juujf.js";
-import { n as enablePhysics3D } from "./physics-3d-CBAQ12LY.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";

package/dist/{create-game-B_sW_eiE.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-BJCfuuZ2.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-Cgli1aju.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
 /**

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.6.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 };

package/dist/{loader-D2u0fVW2.d.ts → loader-y_X4zYO0.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-e3kAmPGC.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 { T as Node, et as Signal, l as PropSchema, v as Engine } from "./behavior-e3kAmPGC.js";
 
 //#region src/net/types.d.ts
 type Unsubscribe = () => void;

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

@@ -1011,6 +1011,21 @@ var Engine = class {
 	* timers, behaviors all breathe together. See `gameplay` `hitStop()`.
 	*/
 	timeScale = 1;
+	_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 +1043,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 +1124,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 +1152,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 +1431,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-DmQ540uR.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-ClKnoILk.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-CDjuhtt_.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-CscQqB7V.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-e3kAmPGC.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-CEFoFN8d.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-X5iRu6pf.js").then((n) => n.n)).createGame2D(o)))(opts);
 			if (disposed) {
 				next.dispose();
 				return;

package/dist/{register-BJCfuuZ2.js → register-ClKnoILk.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-CrTE7c02.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();