incanto 0.35.0 → 0.36.0

package/dist/env.d.ts

@@ -1,4 +1,4 @@
-import { a as Rng, i as SceneJson, n as NodeJson, s as JsonObject } from "./schema-3ywbdlrv.js";
+import { a as Rng, i as SceneJson, n as NodeJson, s as JsonObject } from "./schema-CFeioQRE.js";
 
 //#region src/env/arena.d.ts
 /** Valid `generateArena` themes — drives the catalog options AND validation. */

package/dist/{environment-presets-TAGvmM3z.js → environment-presets-fK9oyrrR.js}

@@ -1,10 +1,10 @@
-import { t as registerCoreNodes } from "./register-BFLg0-_i.js";
+import { t as registerCoreNodes } from "./register-BHAwM4bK.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as Rng } from "./rng-DP-SR7eg.js";
-import { i as getNodeSchema, l as registerNode } from "./registry-CJdGpT2V.js";
+import { i as getNodeSchema, l as registerNode } from "./registry-IyWCGe4q.js";
 import { t as createNoise2D } from "./noise-CGUMx44x.js";
 import { i as applyParticlePreset, r as PARTICLE_PRESET_NAMES, t as ParticleSim } from "./particle-sim-Bw7hB93B.js";
-import { A as Water3D, F as PhysicsBody3D, H as colliderFootDrop, I as RigidBody3D, L as StaticBody3D, M as WaterCutout3D, N as Area3D, P as CharacterBody3D, R as Node3D } from "./gameplay-BvhcQbfJ.js";
+import { A as Water3D, F as PhysicsBody3D, H as colliderFootDrop, I as RigidBody3D, L as StaticBody3D, M as WaterCutout3D, N as Area3D, P as CharacterBody3D, R as Node3D } from "./gameplay-C0MUMSak.js";
 import { n as splatWeights, t as buildHeightmap } from "./heightmap-CRK0M4jT.js";
 import { AdditiveBlending, AnimationClip, AnimationMixer, Box3, BoxGeometry, BufferAttribute, BufferGeometry, CanvasTexture, CapsuleGeometry, ClampToEdgeWrapping, Color, ConeGeometry, CylinderGeometry, DataTexture, DirectionalLight, DoubleSide, DynamicDrawUsage, Euler, Group, IcosahedronGeometry, ImageBitmapLoader, InstancedBufferAttribute, InstancedMesh, LinearFilter, LinearMipmapLinearFilter, LoopOnce, LoopRepeat, Matrix4, Mesh, MeshBasicMaterial, MeshDepthMaterial, MeshPhysicalMaterial, MeshStandardMaterial, NearestFilter, NoBlending, NoColorSpace, NormalBlending, PerspectiveCamera, PlaneGeometry, PointLight, Points, PointsMaterial, Quaternion, QuaternionKeyframeTrack, RGBADepthPacking, RGBAFormat, RepeatWrapping, SRGBColorSpace, ShaderChunk, ShaderMaterial, SphereGeometry, Texture, TextureLoader, UniformsLib, UniformsUtils, Vector3, Vector4, VectorKeyframeTrack } from "three";
 import { clone } from "three/addons/utils/SkeletonUtils.js";

package/dist/{errors-BY2kL0hv.d.ts → errors-DGRtWlSx.d.ts}

@@ -1,4 +1,4 @@
-import { s as JsonObject } from "./schema-3ywbdlrv.js";
+import { s as JsonObject } from "./schema-CFeioQRE.js";
 
 //#region src/core/audit.d.ts
 /** Human-readable warnings (empty = clean). Pure JSON walk, no registry. */

package/dist/{gameplay-BvhcQbfJ.js → gameplay-C0MUMSak.js}

@@ -1,7 +1,7 @@
-import { f as Node, g as Behavior, n as loadScene, x as registerBehavior } from "./loader-Mig5fY4n.js";
+import { f as Node, h as effectiveOrder, n as loadScene, w as registerBehavior, y as Behavior } from "./loader-DAZlgqeC.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as jsonClone } from "./json-BLk7H2Qa.js";
-import { r as effectiveOrder, t as duplicateNode } from "./duplicate-C716f-97.js";
+import { t as duplicateNode } from "./duplicate-Cvb1BSca.js";
 import { Color, CubeCamera, DepthTexture, DoubleSide, Euler, FloatType, Frustum, HalfFloatType, LinearMipmapLinearFilter, MathUtils, Matrix4, Mesh, MeshDepthMaterial, Object3D, PerspectiveCamera, Plane, PlaneGeometry, Quaternion, ShaderMaterial, Sphere, Vector2, Vector3, Vector4, WebGLCubeRenderTarget, WebGLRenderTarget } from "three";
 //#region src/3d/frustum.ts
 const scratchFrustum = new Frustum();
@@ -2315,7 +2315,7 @@ var Node3D = class Node3D extends Node {
 	snapToGround = null;
 	/** What three actually sorts by: band base + renderOrder. */
 	get effectiveRenderOrder() {
-		return effectiveOrder(this.orderGroup, this.renderOrder);
+		return effectiveOrder(this.orderGroup, this.renderOrder, this.tree?.engine?.orderGroups);
 	}
 	_object3D = null;
 	/**

package/dist/gameplay.d.ts

@@ -1,5 +1,5 @@
-import { b as Engine, bt as Node, d as PropSchema, n as BehaviorCtor, t as Behavior } from "./behavior-CGSCWOHB.js";
-import { c as JsonValue, s as JsonObject } from "./schema-3ywbdlrv.js";
+import { Tt as Node, b as Engine, d as PropSchema, n as BehaviorCtor, t as Behavior } from "./behavior-DibCwrW7.js";
+import { c as JsonValue, s as JsonObject } from "./schema-CFeioQRE.js";
 
 //#region src/gameplay/chase.d.ts
 /**

package/dist/gameplay.js

@@ -1,2 +1,2 @@
-import { C as FollowCamera, D as Health, E as DamageOnContact, O as Collector, S as restartScene, T as phaseOf, _ as hitStop, a as Wander, b as GameFlow, c as Projectile, d as PathFollow, f as Oscillate, g as Cooldown, h as CameraShake, i as WaveSpawner, k as Chase, l as Pickup, m as Lifetime, n as registerGameplayBehaviors, o as Spawner, p as MoveTo, r as ZombieAI, s as ScoreKeeper, t as GAMEPLAY_BEHAVIORS, u as Patrol, v as screenFlash, w as DayNight, x as goToScene, y as Interactable } from "./gameplay-BvhcQbfJ.js";
+import { C as FollowCamera, D as Health, E as DamageOnContact, O as Collector, S as restartScene, T as phaseOf, _ as hitStop, a as Wander, b as GameFlow, c as Projectile, d as PathFollow, f as Oscillate, g as Cooldown, h as CameraShake, i as WaveSpawner, k as Chase, l as Pickup, m as Lifetime, n as registerGameplayBehaviors, o as Spawner, p as MoveTo, r as ZombieAI, s as ScoreKeeper, t as GAMEPLAY_BEHAVIORS, u as Patrol, v as screenFlash, w as DayNight, x as goToScene, y as Interactable } from "./gameplay-C0MUMSak.js";
 export { CameraShake, Chase, Collector, Cooldown, DamageOnContact, DayNight, FollowCamera, GAMEPLAY_BEHAVIORS, GameFlow, Health, Interactable, Lifetime, MoveTo, Oscillate, PathFollow, Patrol, Pickup, Projectile, ScoreKeeper, Spawner, Wander, WaveSpawner, ZombieAI, goToScene, hitStop, phaseOf, registerGameplayBehaviors, restartScene, screenFlash };

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-import { $ as Voice, A as qualityEnvironment, B as restoreBehaviors, C as EngineStats, Ct as LogEntry, D as QualityTier, Dt as SignalListener, E as DeviceHints, Et as Signal, F as RestoreReport, G as Localization, H as createSaveStore, I as SaveSlot, J as translationKey, K as T_PREFIX, L as SaveSlots, M as suggestQuality, N as Scene, O as Settings, P as BehaviorState, Q as isAudioContextAvailable, R as behaviorsWithoutSave, S as Scheduler, St as SceneTree, T as RendererStats, Tt as LogManager, U as BASE_LOCALE, V as SaveStore, W as LocaleTables, X as SfxEngine, Y as InputMap, Z as SfxPlayOptions, _ as mergeStaticSignals, _t as PlayMusicOptions, a as clearBehaviors, at as Vec3, b as Engine, bt as Node, c as registeredBehaviors, ct as SFX_PRESETS, d as PropSchema, dt as SfxWave, et as VoicePreset, f as clearRegistry, ft as SynthOptions, g as getNodeType, gt as MusicTrack, h as getNodeSignals, ht as MusicManager, i as behaviorSignals, it as SpatialParams, j as readDeviceHints, k as SettingsValues, l as NodeCtor, lt as SFX_PRESET_NAMES, m as getNodeSchema, mt as MusicBackend, n as BehaviorCtor, nt as ROLLOFF_MODELS, o as getBehavior, ot as spatialGain, p as createNode, pt as synthSfx, q as suggestLocale, r as behaviorSchema, rt as RolloffModel, s as registerBehavior, st as spatialPan, t as Behavior, tt as Listener, u as PropDef, ut as SfxParams, v as registerNode, vt as AudioBuses, w as GameStats, wt as LogLevel, x as EngineOptions, xt as NodeLifecycle, y as registeredTypes, yt as BusName, z as captureBehaviors } from "./behavior-CGSCWOHB.js";
-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-3ywbdlrv.js";
-import { n as loadScene, t as LoadSceneOptions } from "./loader-CUcj00M8.js";
-import { n as ParticleSimConfig, r as ParticleView, t as ParticleSim } from "./particle-sim-B-vZBF5R.js";
-import { a as AudioElementLike, i as gridFromRows, n as PathGrid, o as AudioPlayer, r as findPath, t as FindPathOptions } from "./pathfinding-DgOo2KNF.js";
-import { i as auditScene, n as IncantoErrorCode, r as IncantoErrorDetails, t as IncantoError } from "./errors-BY2kL0hv.js";
+import { $ as translationKey, A as qualityEnvironment, At as LogManager, B as restoreBehaviors, C as EngineStats, Ct as AudioBuses, D as QualityTier, Dt as SceneTree, E as DeviceHints, Et as NodeLifecycle, F as RestoreReport, G as OrderGroupTable, H as createSaveStore, I as SaveSlot, J as BASE_LOCALE, K as effectiveOrder, L as SaveSlots, M as suggestQuality, Mt as SignalListener, N as Scene, O as Settings, Ot as LogEntry, P as BehaviorState, Q as suggestLocale, R as behaviorsWithoutSave, S as Scheduler, St as PlayMusicOptions, T as RendererStats, Tt as Node, U as ORDER_GROUP_BASE, V as SaveStore, W as OrderGroup, X as Localization, Y as LocaleTables, Z as T_PREFIX, _ as mergeStaticSignals, _t as SynthOptions, a as clearBehaviors, at as VoicePreset, b as Engine, bt as MusicManager, c as registeredBehaviors, ct as RolloffModel, d as PropSchema, dt as spatialGain, et as InputMap, f as clearRegistry, ft as spatialPan, g as getNodeType, gt as SfxWave, h as getNodeSignals, ht as SfxParams, i as behaviorSignals, it as Voice, j as readDeviceHints, jt as Signal, k as SettingsValues, kt as LogLevel, l as NodeCtor, lt as SpatialParams, m as getNodeSchema, mt as SFX_PRESET_NAMES, n as BehaviorCtor, nt as SfxPlayOptions, o as getBehavior, ot as Listener, p as createNode, pt as SFX_PRESETS, q as resolveOrderGroups, r as behaviorSchema, rt as isAudioContextAvailable, s as registerBehavior, st as ROLLOFF_MODELS, t as Behavior, tt as SfxEngine, u as PropDef, ut as Vec3, v as registerNode, vt as synthSfx, w as GameStats, wt as BusName, x as EngineOptions, xt as MusicTrack, y as registeredTypes, yt as MusicBackend, z as captureBehaviors } from "./behavior-DibCwrW7.js";
+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-CFeioQRE.js";
+import { n as loadScene, t as LoadSceneOptions } from "./loader-BqigZsfF.js";
+import { n as ParticleSimConfig, r as ParticleView, t as ParticleSim } from "./particle-sim-BzJ1yxoE.js";
+import { a as AudioElementLike, i as gridFromRows, n as PathGrid, o as AudioPlayer, r as findPath, t as FindPathOptions } from "./pathfinding-B3QtdhvZ.js";
+import { i as auditScene, n as IncantoErrorCode, r as IncantoErrorDetails, t as IncantoError } from "./errors-DGRtWlSx.js";
 
 //#region src/core/audio/crossfade.d.ts
 /**
@@ -501,23 +501,6 @@ declare class UiSelect extends HudWidgetBase {
 */
 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
@@ -773,4 +756,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, BASE_LOCALE, Behavior, type BehaviorCtor, type BehaviorState, type BusName, CONST_REF_KEY, type ComputedViewport, type ConnectionJson, type CrossfadeGains, type DebugLineSource, type DeviceHints, Engine, type EngineOptions, type EngineStats, type FindPathOptions, type GameStats, type HudAnchor, HudLayer, IncantoError, type IncantoErrorCode, type IncantoErrorDetails, InputMap, type JsonKind, type JsonObject, type JsonValue, type Listener, type LoadSceneOptions, type LocaleTables, Localization, 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 PathGrid, type PlayMusicOptions, type PreloadResult, type PropDef, type PropSchema, type QualityTier, ROLLOFF_MODELS, type Recorder, type RendererStats, type ReplayEvent, type ReplayJson, type ResolvedRendering, type ResolvedViewport, type RestoreReport, Rng, type RolloffModel, SCENE_FORMAT, SFX_PRESETS, SFX_PRESET_NAMES, type SaveSlot, SaveSlots, type SaveStore, Scene, type SceneJson, SceneTree, type Scheduler, Settings, type SettingsValues, SfxEngine, type SfxParams, type SfxPlayOptions, type SfxWave, Signal, type SignalListener, type SpatialParams, type SynthOptions, T_PREFIX, Timer, TouchControls, type TouchControlsOptions, UiBanner, UiBar, UiButton, UiDialogue, UiImage, UiPanel, UiSelect, UiSlider, UiText, UiToggle, VERSION, type Vec3, type ViewportFit, type Voice, type VoicePreset, WebAudioMusicBackend, applyParticlePreset, assetUrls, attachTouchControls, auditScene, behaviorSchema, behaviorSignals, behaviorsWithoutSave, captureBehaviors, clearBehaviors, clearRegistry, computeViewport, createNode, createNoise2D, createSaveStore, crossfadeGains, duplicateNode, effectiveOrder, fadeGain, findPath, getBehavior, getNodeSchema, getNodeSignals, getNodeType, gridFromRows, isAudioContextAvailable, isConstRef, joystickVector, jsonClone, jsonEquals, jsonKind, loadScene, mergeStaticSignals, newUid, parseNodePath, preloadUrls, qualityEnvironment, readDeviceHints, registerBehavior, registerCoreNodes, registerNode, registeredBehaviors, registeredTypes, replay, resolveConstants, resolveRendering, resolveViewport, restoreBehaviors, serializeNode, spatialGain, spatialPan, startRecording, suggestLocale, suggestQuality, synthSfx, translationKey };
+export { AudioBuses, type AudioElementLike, AudioPlayer, BASE_LOCALE, Behavior, type BehaviorCtor, type BehaviorState, type BusName, CONST_REF_KEY, type ComputedViewport, type ConnectionJson, type CrossfadeGains, type DebugLineSource, type DeviceHints, Engine, type EngineOptions, type EngineStats, type FindPathOptions, type GameStats, type HudAnchor, HudLayer, IncantoError, type IncantoErrorCode, type IncantoErrorDetails, InputMap, type JsonKind, type JsonObject, type JsonValue, type Listener, type LoadSceneOptions, type LocaleTables, Localization, type LogEntry, type LogLevel, LogManager, type MusicBackend, MusicManager, type MusicTrack, Node, type NodeCtor, type NodeJson, type NodeLifecycle, ORDER_GROUP_BASE, type OrderGroup, type OrderGroupTable, PARTICLE_PRESETS, PARTICLE_PRESET_NAMES, type ParsedNodePath, type ParticlePresetValues, ParticleSim, type ParticleSimConfig, type ParticleView, type PathGrid, type PlayMusicOptions, type PreloadResult, type PropDef, type PropSchema, type QualityTier, ROLLOFF_MODELS, type Recorder, type RendererStats, type ReplayEvent, type ReplayJson, type ResolvedRendering, type ResolvedViewport, type RestoreReport, Rng, type RolloffModel, SCENE_FORMAT, SFX_PRESETS, SFX_PRESET_NAMES, type SaveSlot, SaveSlots, type SaveStore, Scene, type SceneJson, SceneTree, type Scheduler, Settings, type SettingsValues, SfxEngine, type SfxParams, type SfxPlayOptions, type SfxWave, Signal, type SignalListener, type SpatialParams, type SynthOptions, T_PREFIX, Timer, TouchControls, type TouchControlsOptions, UiBanner, UiBar, UiButton, UiDialogue, UiImage, UiPanel, UiSelect, UiSlider, UiText, UiToggle, VERSION, type Vec3, type ViewportFit, type Voice, type VoicePreset, WebAudioMusicBackend, applyParticlePreset, assetUrls, attachTouchControls, auditScene, behaviorSchema, behaviorSignals, behaviorsWithoutSave, captureBehaviors, clearBehaviors, clearRegistry, computeViewport, createNode, createNoise2D, createSaveStore, crossfadeGains, duplicateNode, effectiveOrder, fadeGain, findPath, getBehavior, getNodeSchema, getNodeSignals, getNodeType, gridFromRows, isAudioContextAvailable, isConstRef, joystickVector, jsonClone, jsonEquals, jsonKind, loadScene, mergeStaticSignals, newUid, parseNodePath, preloadUrls, qualityEnvironment, readDeviceHints, registerBehavior, registerCoreNodes, registerNode, registeredBehaviors, registeredTypes, replay, resolveConstants, resolveOrderGroups, resolveRendering, resolveViewport, restoreBehaviors, serializeNode, spatialGain, spatialPan, startRecording, suggestLocale, suggestQuality, synthSfx, translationKey };

package/dist/index.js

@@ -1,14 +1,14 @@
-import { C as Signal, S as registeredBehaviors, _ as behaviorSchema, a as SCENE_FORMAT, b as getBehavior, c as SceneTree, d as resolveConstants, f as Node, g as Behavior, i as serializeNode, l as CONST_REF_KEY, m as InputMap, n as loadScene, o as computeViewport, p as parseNodePath, r as Scene, s as resolveViewport, u as isConstRef, v as behaviorSignals, x as registerBehavior, y as clearBehaviors } from "./loader-Mig5fY4n.js";
-import { A as translationKey, B as WebAudioMusicBackend, C as restoreBehaviors, D as Localization, E as BASE_LOCALE, F as spatialPan, H as fadeGain, I as SFX_PRESETS, L as SFX_PRESET_NAMES, M as isAudioContextAvailable, N as ROLLOFF_MODELS, O as T_PREFIX, P as spatialGain, R as synthSfx, S as captureBehaviors, T as LogManager, U as AudioBuses, V as crossfadeGains, _ as qualityEnvironment, a as UiSlider, b as SaveSlots, c as UiButton, d as UiBanner, f as UiBar, g as Settings, h as Engine, i as UiSelect, j as SfxEngine, k as suggestLocale, l as UiDialogue, m as AudioPlayer, n as UiImage, o as UiToggle, p as UiText, r as UiPanel, s as Timer, t as registerCoreNodes, u as HudLayer, v as readDeviceHints, w as createSaveStore, x as behaviorsWithoutSave, y as suggestQuality, z as MusicManager } from "./register-BFLg0-_i.js";
+import { C as getBehavior, E as Signal, S as clearBehaviors, T as registeredBehaviors, _ as InputMap, a as SCENE_FORMAT, b as behaviorSchema, c as SceneTree, d as resolveConstants, f as Node, g as resolveOrderGroups, h as effectiveOrder, i as serializeNode, l as CONST_REF_KEY, m as ORDER_GROUP_BASE, n as loadScene, o as computeViewport, p as parseNodePath, r as Scene, s as resolveViewport, u as isConstRef, w as registerBehavior, x as behaviorSignals, y as Behavior } from "./loader-DAZlgqeC.js";
+import { A as translationKey, B as WebAudioMusicBackend, C as restoreBehaviors, D as Localization, E as BASE_LOCALE, F as spatialPan, H as fadeGain, I as SFX_PRESETS, L as SFX_PRESET_NAMES, M as isAudioContextAvailable, N as ROLLOFF_MODELS, O as T_PREFIX, P as spatialGain, R as synthSfx, S as captureBehaviors, T as LogManager, U as AudioBuses, V as crossfadeGains, _ as qualityEnvironment, a as UiSlider, b as SaveSlots, c as UiButton, d as UiBanner, f as UiBar, g as Settings, h as Engine, i as UiSelect, j as SfxEngine, k as suggestLocale, l as UiDialogue, m as AudioPlayer, n as UiImage, o as UiToggle, p as UiText, r as UiPanel, s as Timer, t as registerCoreNodes, u as HudLayer, v as readDeviceHints, w as createSaveStore, x as behaviorsWithoutSave, y as suggestQuality, z as MusicManager } from "./register-BHAwM4bK.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as Rng } from "./rng-DP-SR7eg.js";
-import { t as auditScene } from "./audit-C5oZGAru.js";
+import { t as auditScene } from "./audit-D7F3n3Nt.js";
 import { n as jsonEquals, r as jsonKind, t as jsonClone } from "./json-BLk7H2Qa.js";
-import { a as getNodeSignals, c as mergeStaticSignals, i as getNodeSchema, l as registerNode, n as clearRegistry, o as getNodeType, r as createNode, u as registeredTypes } from "./registry-CJdGpT2V.js";
+import { a as getNodeSignals, c as mergeStaticSignals, i as getNodeSchema, l as registerNode, n as clearRegistry, o as getNodeType, r as createNode, u as registeredTypes } from "./registry-IyWCGe4q.js";
 import { t as createNoise2D } from "./noise-CGUMx44x.js";
-import { n as ORDER_GROUP_BASE, r as effectiveOrder, t as duplicateNode } from "./duplicate-C716f-97.js";
 import { i as applyParticlePreset, n as PARTICLE_PRESETS, r as PARTICLE_PRESET_NAMES, t as ParticleSim } from "./particle-sim-Bw7hB93B.js";
 import { i as resolveRendering, n as attachTouchControls, r as joystickVector, t as TouchControls } from "./touch-BoNg_MnF.js";
+import { t as duplicateNode } from "./duplicate-Cvb1BSca.js";
 //#region src/core/pathfinding.ts
 /**
 * A* from `from` to `to` (inclusive cell coords). Returns the cell path
@@ -242,6 +242,6 @@ function newUid() {
 //#endregion
 //#region src/index.ts
 /** Engine version. Kept in sync with package.json by the release pipeline. */
-const VERSION = "0.35.0";
+const VERSION = "0.36.0";
 //#endregion
-export { AudioBuses, AudioPlayer, BASE_LOCALE, Behavior, CONST_REF_KEY, Engine, HudLayer, IncantoError, InputMap, Localization, LogManager, MusicManager, Node, ORDER_GROUP_BASE, PARTICLE_PRESETS, PARTICLE_PRESET_NAMES, ParticleSim, ROLLOFF_MODELS, Rng, SCENE_FORMAT, SFX_PRESETS, SFX_PRESET_NAMES, SaveSlots, Scene, SceneTree, Settings, SfxEngine, Signal, T_PREFIX, Timer, TouchControls, UiBanner, UiBar, UiButton, UiDialogue, UiImage, UiPanel, UiSelect, UiSlider, UiText, UiToggle, VERSION, WebAudioMusicBackend, applyParticlePreset, assetUrls, attachTouchControls, auditScene, behaviorSchema, behaviorSignals, behaviorsWithoutSave, captureBehaviors, clearBehaviors, clearRegistry, computeViewport, createNode, createNoise2D, createSaveStore, crossfadeGains, duplicateNode, effectiveOrder, fadeGain, findPath, getBehavior, getNodeSchema, getNodeSignals, getNodeType, gridFromRows, isAudioContextAvailable, isConstRef, joystickVector, jsonClone, jsonEquals, jsonKind, loadScene, mergeStaticSignals, newUid, parseNodePath, preloadUrls, qualityEnvironment, readDeviceHints, registerBehavior, registerCoreNodes, registerNode, registeredBehaviors, registeredTypes, replay, resolveConstants, resolveRendering, resolveViewport, restoreBehaviors, serializeNode, spatialGain, spatialPan, startRecording, suggestLocale, suggestQuality, synthSfx, translationKey };
+export { AudioBuses, AudioPlayer, BASE_LOCALE, Behavior, CONST_REF_KEY, Engine, HudLayer, IncantoError, InputMap, Localization, LogManager, MusicManager, Node, ORDER_GROUP_BASE, PARTICLE_PRESETS, PARTICLE_PRESET_NAMES, ParticleSim, ROLLOFF_MODELS, Rng, SCENE_FORMAT, SFX_PRESETS, SFX_PRESET_NAMES, SaveSlots, Scene, SceneTree, Settings, SfxEngine, Signal, T_PREFIX, Timer, TouchControls, UiBanner, UiBar, UiButton, UiDialogue, UiImage, UiPanel, UiSelect, UiSlider, UiText, UiToggle, VERSION, WebAudioMusicBackend, applyParticlePreset, assetUrls, attachTouchControls, auditScene, behaviorSchema, behaviorSignals, behaviorsWithoutSave, captureBehaviors, clearBehaviors, clearRegistry, computeViewport, createNode, createNoise2D, createSaveStore, crossfadeGains, duplicateNode, effectiveOrder, fadeGain, findPath, getBehavior, getNodeSchema, getNodeSignals, getNodeType, gridFromRows, isAudioContextAvailable, isConstRef, joystickVector, jsonClone, jsonEquals, jsonKind, loadScene, mergeStaticSignals, newUid, parseNodePath, preloadUrls, qualityEnvironment, readDeviceHints, registerBehavior, registerCoreNodes, registerNode, registeredBehaviors, registeredTypes, replay, resolveConstants, resolveOrderGroups, resolveRendering, resolveViewport, restoreBehaviors, serializeNode, spatialGain, spatialPan, startRecording, suggestLocale, suggestQuality, synthSfx, translationKey };

package/dist/{loader-CUcj00M8.d.ts → loader-BqigZsfF.d.ts}

@@ -1,5 +1,5 @@
-import { N as Scene, b as Engine } from "./behavior-CGSCWOHB.js";
-import { i as SceneJson } from "./schema-3ywbdlrv.js";
+import { N as Scene, b as Engine } from "./behavior-DibCwrW7.js";
+import { i as SceneJson } from "./schema-CFeioQRE.js";
 
 //#region src/core/scene/loader.d.ts
 interface LoadSceneOptions {

package/dist/{loader-Mig5fY4n.js → loader-DAZlgqeC.js}

@@ -1,6 +1,6 @@
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { n as jsonEquals, t as jsonClone } from "./json-BLk7H2Qa.js";
-import { c as mergeStaticSignals, i as getNodeSchema, r as createNode, s as mergeStaticProps, t as applySchemaProps } from "./registry-CJdGpT2V.js";
+import { c as mergeStaticSignals, i as getNodeSchema, r as createNode, s as mergeStaticProps, t as applySchemaProps } from "./registry-IyWCGe4q.js";
 //#region src/core/signal.ts
 var Signal = class {
 	connections = [];
@@ -597,6 +597,34 @@ function parseInputDecls(decls) {
 	return out;
 }
 //#endregion
+//#region src/core/order-groups.ts
+const ORDER_GROUP_BASE = {
+	background: -2e3,
+	terrain: -1e3,
+	default: 0,
+	characters: 1e3,
+	effects: 2e3,
+	overlay: 3e3
+};
+/** Built-ins with a scene's declarations layered over them. */
+function resolveOrderGroups(declared) {
+	return declared ? {
+		...ORDER_GROUP_BASE,
+		...declared
+	} : ORDER_GROUP_BASE;
+}
+/**
+* base + fine offset.
+*
+* An unknown name resolves to 0 (`default`) rather than throwing, because this
+* runs per node per frame and a scene that got here has already been validated:
+* `loadScene` hard-fails an `orderGroup` naming a band nothing declares, which
+* is where a typo should be caught.
+*/
+function effectiveOrder(group, renderOrder, table = ORDER_GROUP_BASE) {
+	return (table[group] ?? 0) + renderOrder;
+}
+//#endregion
 //#region src/core/node-path.ts
 function parseNodePath(path) {
 	if (path === "") throw new IncantoError("BAD_NODE_PATH", "Node path must not be empty.");
@@ -1368,6 +1396,8 @@ var Scene = class {
 	input;
 	/** Translations by locale (merged into `Engine.locale` on setScene). */
 	strings;
+	/** Extra draw-order bands (`name → base`), layered over the built-ins. */
+	orderGroups;
 	/** Physics config (gravity etc. — interpreted by the physics modules). */
 	physics;
 	/** Multiplayer config (room etc. — interpreted by incanto/net). */
@@ -1386,6 +1416,7 @@ var Scene = class {
 		this.assets = source.assets ? jsonClone(source.assets) : void 0;
 		this.constants = source.constants ? jsonClone(source.constants) : void 0;
 		this.input = source.input ? jsonClone(source.input) : void 0;
+		this.orderGroups = source.orderGroups ? { ...source.orderGroups } : void 0;
 		this.strings = source.strings ? jsonClone(source.strings) : void 0;
 		this.physics = source.physics ? jsonClone(source.physics) : void 0;
 		this.multiplayer = source.multiplayer ? jsonClone(source.multiplayer) : void 0;
@@ -1403,6 +1434,7 @@ var Scene = class {
 			...this.assets ? { assets: jsonClone(this.assets) } : {},
 			...this.constants ? { constants: jsonClone(this.constants) } : {},
 			...this.input ? { input: jsonClone(this.input) } : {},
+			...this.orderGroups ? { orderGroups: { ...this.orderGroups } } : {},
 			...this.strings ? { strings: jsonClone(this.strings) } : {},
 			...this.physics ? { physics: jsonClone(this.physics) } : {},
 			...this.multiplayer ? { multiplayer: jsonClone(this.multiplayer) } : {},
@@ -1429,7 +1461,7 @@ function loadScene(json, opts) {
 	if (typeof json !== "object" || json === null) throw new IncantoError("BAD_FORMAT", `Scene JSON must be an object, got ${json === null ? "null" : typeof json}.`);
 	const sceneJson = json;
 	validateHeader(sceneJson);
-	const root = buildNode(sceneJson.root, opts, [], "", sceneJson.constants);
+	const root = buildNode(sceneJson.root, opts, [], "", sceneJson.constants, Object.keys(sceneJson.orderGroups ?? {}));
 	validateUniqueUids(root);
 	const tree = new SceneTree();
 	if (opts?.engine) tree._setEngine(opts.engine);
@@ -1454,6 +1486,11 @@ function validateHeader(json) {
 		if (typeof json.input !== "object" || json.input === null || Array.isArray(json.input)) throw new IncantoError("BAD_FORMAT", "Scene \"input\" must be an object of action declarations.");
 		parseInputDecls(json.input);
 	}
+	if (json.orderGroups !== void 0) {
+		const table = json.orderGroups;
+		if (typeof table !== "object" || table === null || Array.isArray(table)) throw new IncantoError("BAD_FORMAT", "Scene \"orderGroups\" must be an object of band name → base offset, e.g. { \"ui-back\": 2500 }.");
+		for (const [name, base] of Object.entries(table)) if (typeof base !== "number" || !Number.isFinite(base)) throw new IncantoError("BAD_FORMAT", `Order group '${name}' must be a finite number (its base draw offset), got ${JSON.stringify(base)}. A band is a NUMBER — a bare name would sort exactly like "default" and mean nothing.`, { prop: name });
+	}
 	if (json.assets !== void 0) {
 		if (typeof json.assets !== "object" || json.assets === null || Array.isArray(json.assets)) throw new IncantoError("BAD_FORMAT", "Scene \"assets\" must be an object of asset declarations.");
 		for (const [key, decl] of Object.entries(json.assets)) {
@@ -1477,22 +1514,22 @@ function withNodeContext(e, path, nj) {
 	});
 	return e;
 }
-function buildNode(nj, opts, stack, parentPath, constants) {
+function buildNode(nj, opts, stack, parentPath, constants, bands = []) {
 	const path = `${parentPath}/${nj.name}`;
 	try {
 		if (nj.instance !== void 0 && nj.type !== void 0) throw new IncantoError("BAD_FORMAT", `Node '${nj.name}' declares both "type" and "instance" — they are mutually exclusive.`);
-		if (nj.instance !== void 0) return buildInstance(nj, opts, stack, path, constants);
+		if (nj.instance !== void 0) return buildInstance(nj, opts, stack, path, constants, bands);
 		if (nj.type === void 0) throw new IncantoError("BAD_FORMAT", `Node '${nj.name}' must declare either "type" or "instance".`);
-		const node = createNode(nj.type, resolveConstants(nj.props, constants));
+		const node = createNode(nj.type, resolveConstants(nj.props, constants), { orderGroup: bands });
 		applyCommon(node, nj, opts);
 		node.constructor.validateJson?.(node);
-		for (const childJson of nj.children ?? []) node.addChild(buildNode(childJson, opts, stack, path, constants));
+		for (const childJson of nj.children ?? []) node.addChild(buildNode(childJson, opts, stack, path, constants, bands));
 		return node;
 	} catch (e) {
 		throw withNodeContext(e, path, nj);
 	}
 }
-function buildInstance(nj, opts, stack, path, constants) {
+function buildInstance(nj, opts, stack, path, constants, bands) {
 	const instancePath = nj.instance;
 	if (!opts?.resolveScene) throw new IncantoError("UNRESOLVED_INSTANCE", `Node '${nj.name}' references instance '${instancePath}' but no resolveScene option was provided.`);
 	if (stack.includes(instancePath)) throw new IncantoError("UNRESOLVED_INSTANCE", `Instance cycle detected: ${[...stack, instancePath].join(" → ")}.`);
@@ -1504,13 +1541,13 @@ function buildInstance(nj, opts, stack, path, constants) {
 		...sub.root,
 		name: nj.name,
 		props: deepMerge(sub.root.props ?? {}, overrides)
-	}, opts, [...stack, instancePath], parentOf(path), sub.constants);
+	}, opts, [...stack, instancePath], parentOf(path), sub.constants, Object.keys(sub.orderGroups ?? {}));
 	applyCommon(node, {
 		...nj,
 		type: void 0,
 		props: void 0
 	}, opts);
-	for (const childJson of nj.children ?? []) node.addChild(buildNode(childJson, opts, stack, path, constants));
+	for (const childJson of nj.children ?? []) node.addChild(buildNode(childJson, opts, stack, path, constants, bands));
 	wireConnections(node, sub.connections ?? [], opts?.declareConnectionSignals);
 	return node;
 }
@@ -1599,4 +1636,4 @@ function validateUniqueUids(root) {
 	walk(root);
 }
 //#endregion
-export { Signal as C, registeredBehaviors as S, behaviorSchema as _, SCENE_FORMAT as a, getBehavior as b, SceneTree as c, resolveConstants as d, Node as f, Behavior as g, diagnose as h, serializeNode as i, CONST_REF_KEY as l, InputMap as m, loadScene as n, computeViewport as o, parseNodePath as p, Scene as r, resolveViewport as s, buildNodeJson as t, isConstRef as u, behaviorSignals as v, registerBehavior as x, clearBehaviors as y };
+export { getBehavior as C, Signal as E, clearBehaviors as S, registeredBehaviors as T, InputMap as _, SCENE_FORMAT as a, behaviorSchema as b, SceneTree as c, resolveConstants as d, Node as f, resolveOrderGroups as g, effectiveOrder as h, serializeNode as i, CONST_REF_KEY as l, ORDER_GROUP_BASE as m, loadScene as n, computeViewport as o, parseNodePath as p, Scene as r, resolveViewport as s, buildNodeJson as t, isConstRef as u, diagnose as v, registerBehavior as w, behaviorSignals as x, Behavior as y };

package/dist/net.d.ts

@@ -1,5 +1,5 @@
-import { Et as Signal, b as Engine, bt as Node, d as PropSchema } from "./behavior-CGSCWOHB.js";
-import { c as JsonValue, i as SceneJson, s as JsonObject } from "./schema-3ywbdlrv.js";
+import { Tt as Node, b as Engine, d as PropSchema, jt as Signal } from "./behavior-DibCwrW7.js";
+import { c as JsonValue, i as SceneJson, s as JsonObject } from "./schema-CFeioQRE.js";
 
 //#region src/net/types.d.ts
 type Unsubscribe = () => void;

package/dist/net.js

@@ -1,9 +1,9 @@
-import { n as loadScene } from "./loader-Mig5fY4n.js";
-import { h as Engine } from "./register-BFLg0-_i.js";
+import { n as loadScene } from "./loader-DAZlgqeC.js";
+import { h as Engine } from "./register-BHAwM4bK.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as jsonClone } from "./json-BLk7H2Qa.js";
 import { n as createAgent8Server } from "./agent8-CvsfVskX.js";
-import { i as applySyncPatch, n as NetworkSpawner, r as NetworkManager, t as registerNodesNet } from "./register-BjbPMA5B.js";
+import { i as applySyncPatch, n as NetworkSpawner, r as NetworkManager, t as registerNodesNet } from "./register-DXwtIVqP.js";
 //#region src/net/loopback.ts
 /**
 * In-memory multiplayer hub implementing the SAME kernel contract as

package/dist/{particle-sim-B-vZBF5R.d.ts → particle-sim-BzJ1yxoE.d.ts}

@@ -1,4 +1,4 @@
-import { a as Rng } from "./schema-3ywbdlrv.js";
+import { a as Rng } from "./schema-CFeioQRE.js";
 
 //#region src/core/particle-sim.d.ts
 /**

package/dist/{pathfinding-DgOo2KNF.d.ts → pathfinding-B3QtdhvZ.d.ts}

@@ -1,4 +1,4 @@
-import { bt as Node, d as PropSchema, tt as Listener } from "./behavior-CGSCWOHB.js";
+import { Tt as Node, d as PropSchema, ot as Listener } from "./behavior-DibCwrW7.js";
 
 //#region src/core/nodes/audio-player.d.ts
 /**

package/dist/{physics-2d-DqAclql-.js → physics-2d-B4v39hca.js}

@@ -1,7 +1,7 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { h as diagnose } from "./loader-Mig5fY4n.js";
+import { v as diagnose } from "./loader-DAZlgqeC.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
-import { _ as RigidBody2D, b as validateCollider2D, g as PhysicsBody2D, h as CharacterBody2D, m as Area2D, p as Joint2D, y as Node2D } from "./register-DSmIRAf7.js";
+import { _ as RigidBody2D, b as validateCollider2D, g as PhysicsBody2D, h as CharacterBody2D, m as Area2D, p as Joint2D, y as Node2D } from "./register-COGCNitr.js";
 import { n as registerDebugSource } from "./debug-draw-BM3DsvtT.js";
 //#region src/2d/physics/physics-2d.ts
 var physics_2d_exports = /* @__PURE__ */ __exportAll({

package/dist/{physics-3d-DxBH4sIF.js → physics-3d-DFJVMYET.js}

@@ -1,9 +1,9 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { h as diagnose } from "./loader-Mig5fY4n.js";
+import { v as diagnose } from "./loader-DAZlgqeC.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
-import { F as PhysicsBody3D, I as RigidBody3D, N as Area3D, P as CharacterBody3D, R as Node3D, z as validateCollider3D } from "./gameplay-BvhcQbfJ.js";
+import { F as PhysicsBody3D, I as RigidBody3D, N as Area3D, P as CharacterBody3D, R as Node3D, z as validateCollider3D } from "./gameplay-C0MUMSak.js";
 import { n as registerDebugSource } from "./debug-draw-BM3DsvtT.js";
-import { A as Terrain3D, F as InstancedMesh3D, L as buildMeshGeometry, P as Joint3D } from "./environment-presets-TAGvmM3z.js";
+import { A as Terrain3D, F as InstancedMesh3D, L as buildMeshGeometry, P as Joint3D } from "./environment-presets-fK9oyrrR.js";
 import { Euler, Matrix4, Quaternion, Vector3 } from "three";
 //#region src/3d/physics/collider-lines.ts
 /**

package/dist/react.d.ts

@@ -1,5 +1,5 @@
-import { N as Scene, b as Engine, n as BehaviorCtor } from "./behavior-CGSCWOHB.js";
-import { c as JsonValue } from "./schema-3ywbdlrv.js";
+import { N as Scene, b as Engine, n as BehaviorCtor } from "./behavior-DibCwrW7.js";
+import { c as JsonValue } from "./schema-CFeioQRE.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-BUD89Kqh.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-B0Wfhi2-.js").then((n) => n.n)).createGame2D(o)))(opts);
+			const next = await (_gameFactory ?? (mode === "3d" ? async (o) => (await import("./create-game-BBD3iUFZ.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-WmNFluFz.js").then((n) => n.n)).createGame2D(o)))(opts);
 			if (disposed) {
 				next.dispose();
 				return;

package/dist/{register-BFLg0-_i.js → register-BHAwM4bK.js}

@@ -1,7 +1,7 @@
-import { C as Signal, _ as behaviorSchema, f as Node, h as diagnose, m as InputMap } from "./loader-Mig5fY4n.js";
+import { E as Signal, _ as InputMap, b as behaviorSchema, f as Node, g as resolveOrderGroups, m as ORDER_GROUP_BASE, v as diagnose } from "./loader-DAZlgqeC.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as Rng } from "./rng-DP-SR7eg.js";
-import { l as registerNode } from "./registry-CJdGpT2V.js";
+import { l as registerNode } from "./registry-IyWCGe4q.js";
 //#region src/core/audio/buses.ts
 /**
 * Global volume state — `master` × `sfx`/`music` gain (0..1) plus a `muted`
@@ -1608,6 +1608,11 @@ var Engine = class {
 	* anything a locale does not declare falls back to it silently.
 	*/
 	locale = new Localization();
+	/**
+	* Draw-order bands in force: the six built in, plus whatever the current
+	* scene declares. Read by `Node2D`/`Node3D.effectiveRenderOrder`.
+	*/
+	orderGroups = ORDER_GROUP_BASE;
 	/** Low-latency procedural-SFX player (WebAudio, headless-safe). AudioPlayer
 	*  presets play through it; games may call `engine.sfx.play(...)` directly. */
 	sfx = new SfxEngine();
@@ -1682,6 +1687,7 @@ var Engine = class {
 		this._unscaledTime = 0;
 		if (scene.input) this.input.declare(scene.input);
 		if (scene.strings) this.locale.load(scene.strings);
+		this.orderGroups = resolveOrderGroups(scene.orderGroups);
 		this.sceneChanged.emit(scene);
 	}
 	start() {

package/dist/{register-DSmIRAf7.js → register-COGCNitr.js}

@@ -1,9 +1,8 @@
-import { f as Node } from "./loader-Mig5fY4n.js";
-import { t as registerCoreNodes } from "./register-BFLg0-_i.js";
+import { f as Node, h as effectiveOrder } from "./loader-DAZlgqeC.js";
+import { t as registerCoreNodes } from "./register-BHAwM4bK.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as Rng } from "./rng-DP-SR7eg.js";
-import { i as getNodeSchema, l as registerNode } from "./registry-CJdGpT2V.js";
-import { r as effectiveOrder } from "./duplicate-C716f-97.js";
+import { i as getNodeSchema, l as registerNode } from "./registry-IyWCGe4q.js";
 import { i as applyParticlePreset, r as PARTICLE_PRESET_NAMES, t as ParticleSim } from "./particle-sim-Bw7hB93B.js";
 import { AdditiveBlending, BufferAttribute, BufferGeometry, CanvasTexture, Color, DynamicDrawUsage, Group, InstancedMesh, MathUtils, Matrix4, Mesh, MeshBasicMaterial, NearestFilter, NormalBlending, Object3D, PlaneGeometry } from "three";
 //#region src/2d/physics/collider-validate.ts
@@ -77,7 +76,7 @@ var Node2D = class extends Node {
 	orderGroup = "default";
 	/** What three actually sorts by: band base + renderOrder. */
 	get effectiveRenderOrder() {
-		return effectiveOrder(this.orderGroup, this.renderOrder);
+		return effectiveOrder(this.orderGroup, this.renderOrder, this.tree?.engine?.orderGroups);
 	}
 	visible = true;
 	_object2D = null;

package/dist/{register-BjbPMA5B.js → register-DXwtIVqP.js}

@@ -1,8 +1,8 @@
-import { C as Signal, f as Node, t as buildNodeJson } from "./loader-Mig5fY4n.js";
-import { t as registerCoreNodes } from "./register-BFLg0-_i.js";
+import { E as Signal, f as Node, t as buildNodeJson } from "./loader-DAZlgqeC.js";
+import { t as registerCoreNodes } from "./register-BHAwM4bK.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { n as jsonEquals, t as jsonClone } from "./json-BLk7H2Qa.js";
-import { l as registerNode } from "./registry-CJdGpT2V.js";
+import { l as registerNode } from "./registry-IyWCGe4q.js";
 //#region src/net/network-manager.ts
 const managers = /* @__PURE__ */ new WeakMap();
 /**

package/dist/{registry-CJdGpT2V.js → registry-IyWCGe4q.js}

@@ -104,7 +104,7 @@ function mergeStaticAliases(ctor) {
 * hard-validating every key and JSON kind. Shared by nodes and behaviors.
 * `aliases` maps legacy keys onto current ones (back-compat for renamed props).
 */
-function applySchemaProps(target, schema, props, label, aliases = {}) {
+function applySchemaProps(target, schema, props, label, aliases = {}, extraOptions = {}) {
 	for (const [key, def] of Object.entries(schema)) target[key] = jsonClone(def.default);
 	if (!props) return;
 	for (const [rawKey, value] of Object.entries(props)) {
@@ -118,7 +118,9 @@ function applySchemaProps(target, schema, props, label, aliases = {}) {
 				validOptions: valid
 			});
 		}
-		validatePropValue(value, def.default, `${label}.${key}`, def.options);
+		const extra = extraOptions[key];
+		const options = def.options && extra && extra.length > 0 ? [...def.options, ...extra] : def.options;
+		validatePropValue(value, def.default, `${label}.${key}`, options);
 		target[key] = jsonClone(value);
 	}
 }
@@ -126,10 +128,10 @@ function applySchemaProps(target, schema, props, label, aliases = {}) {
 * Instantiate a registered type, assign schema defaults (cloned), then the
 * given props — validating every key and its JSON kind against the default.
 */
-function createNode(typeName, props) {
+function createNode(typeName, props, extraOptions) {
 	const ctor = getNodeType(typeName);
 	const node = new ctor();
-	applySchemaProps(node, getNodeSchema(typeName), props, typeName, mergeStaticAliases(ctor));
+	applySchemaProps(node, getNodeSchema(typeName), props, typeName, mergeStaticAliases(ctor), extraOptions);
 	return node;
 }
 //#endregion

package/dist/{schema-3ywbdlrv.d.ts → schema-CFeioQRE.d.ts}

@@ -60,6 +60,16 @@ interface SceneJson {
   * translation would not fit (see core/localization.ts).
   */
   strings?: Record<string, Record<string, string>>;
+  /**
+  * Extra draw-order bands, as `name → base offset`, layered over the six built
+  * in (`background -2000` … `overlay 3000`). A node's effective order is
+  * `base(orderGroup) + renderOrder`, so a band is a NUMBER — declaring a bare
+  * name would sort exactly like `default` and mean nothing.
+  *
+  * `{"orderGroups": {"ui-back": 2500}}` then `"orderGroup": "ui-back"`.
+  * Re-declaring a built-in name re-bases it for this scene.
+  */
+  orderGroups?: Record<string, number>;
   /** Declarative input action map (loaded into Engine.input). */
   input?: JsonObject;
   /** Physics config — `{gravity: [x,y]}` (2D px/s²) or `{gravity: [x,y,z]}` (3D m/s²). */

package/dist/{test-9EokzbRd.js → test-X_xE6Yay.js}

@@ -1,12 +1,12 @@
-import { n as loadScene, x as registerBehavior } from "./loader-Mig5fY4n.js";
-import { h as Engine } from "./register-BFLg0-_i.js";
+import { n as loadScene, w as registerBehavior } from "./loader-DAZlgqeC.js";
+import { h as Engine } from "./register-BHAwM4bK.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { n as jsonEquals, t as jsonClone } from "./json-BLk7H2Qa.js";
-import { i as getNodeSchema, s as mergeStaticProps } from "./registry-CJdGpT2V.js";
-import { n as registerGameplayBehaviors } from "./gameplay-BvhcQbfJ.js";
-import { t as registerNodes2D } from "./register-DSmIRAf7.js";
-import { n as registerNodes3D, t as resolveEnvironmentHdri } from "./environment-presets-TAGvmM3z.js";
-import { t as registerNodesNet } from "./register-BjbPMA5B.js";
+import { i as getNodeSchema, s as mergeStaticProps } from "./registry-IyWCGe4q.js";
+import { n as registerGameplayBehaviors } from "./gameplay-C0MUMSak.js";
+import { t as registerNodes2D } from "./register-COGCNitr.js";
+import { n as registerNodes3D, t as resolveEnvironmentHdri } from "./environment-presets-fK9oyrrR.js";
+import { t as registerNodesNet } from "./register-DXwtIVqP.js";
 import { Box3, Euler, Matrix4, PerspectiveCamera, Quaternion, Vector3 } from "three";
 //#region src/test/framing.ts
 /**
@@ -482,10 +482,10 @@ async function runScript(json, opts) {
 	engine.setScene(scene);
 	const physics = opts.physics ?? "auto";
 	if (physics === "2d" || physics === "auto" && scene.dimension === "2d") {
-		const { enablePhysics2D } = await import("./physics-2d-DqAclql-.js").then((n) => n.r);
+		const { enablePhysics2D } = await import("./physics-2d-B4v39hca.js").then((n) => n.r);
 		await enablePhysics2D(engine);
 	} else if (physics === "3d" || physics === "auto" && scene.dimension === "3d") {
-		const { enablePhysics3D } = await import("./physics-3d-DxBH4sIF.js").then((n) => n.r);
+		const { enablePhysics3D } = await import("./physics-3d-DFJVMYET.js").then((n) => n.r);
 		await enablePhysics3D(engine);
 	}
 	const failures = [];
@@ -598,10 +598,10 @@ async function createPlaySession(json, opts = {}) {
 	engine.setScene(scene);
 	const physics = opts.physics ?? "auto";
 	if (physics === "2d" || physics === "auto" && scene.dimension === "2d") {
-		const { enablePhysics2D } = await import("./physics-2d-DqAclql-.js").then((n) => n.r);
+		const { enablePhysics2D } = await import("./physics-2d-B4v39hca.js").then((n) => n.r);
 		await enablePhysics2D(engine);
 	} else if (physics === "3d" || physics === "auto" && scene.dimension === "3d") {
-		const { enablePhysics3D } = await import("./physics-3d-DxBH4sIF.js").then((n) => n.r);
+		const { enablePhysics3D } = await import("./physics-3d-DFJVMYET.js").then((n) => n.r);
 		await enablePhysics3D(engine);
 	}
 	const stepMs = 1e3 / (opts.fixedHz ?? 60);

package/dist/test.d.ts

@@ -1,7 +1,7 @@
-import { Ct as LogEntry, N as Scene, b as Engine, bt as Node, n as BehaviorCtor } from "./behavior-CGSCWOHB.js";
-import { c as JsonValue, i as SceneJson } from "./schema-3ywbdlrv.js";
-import { t as LoadSceneOptions } from "./loader-CUcj00M8.js";
-import { i as auditScene, t as IncantoError } from "./errors-BY2kL0hv.js";
+import { N as Scene, Ot as LogEntry, Tt as Node, b as Engine, n as BehaviorCtor } from "./behavior-DibCwrW7.js";
+import { c as JsonValue, i as SceneJson } from "./schema-CFeioQRE.js";
+import { t as LoadSceneOptions } from "./loader-BqigZsfF.js";
+import { i as auditScene, t as IncantoError } from "./errors-DGRtWlSx.js";
 
 //#region src/test/framing.d.ts
 /** Where a node's origin sits relative to the current camera. */

package/dist/test.js

@@ -1,3 +1,3 @@
-import { t as auditScene } from "./audit-C5oZGAru.js";
-import { a as registerAllNodes, c as describeFraming, i as findFloatingProps, l as framingText, n as createPlaySession, o as runScript, r as describeCapture, s as validateScene, t as captureScene } from "./test-9EokzbRd.js";
+import { t as auditScene } from "./audit-D7F3n3Nt.js";
+import { a as registerAllNodes, c as describeFraming, i as findFloatingProps, l as framingText, n as createPlaySession, o as runScript, r as describeCapture, s as validateScene, t as captureScene } from "./test-X_xE6Yay.js";
 export { auditScene, captureScene, createPlaySession, describeCapture, describeFraming, findFloatingProps, framingText, registerAllNodes, runScript, validateScene };

package/dist/vite.js

@@ -1,4 +1,4 @@
-import { s as validateScene } from "./test-9EokzbRd.js";
+import { s as validateScene } from "./test-X_xE6Yay.js";
 import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
 import { basename, dirname, join, normalize, relative, resolve, sep } from "node:path";
 //#region src/vite/index.ts

package/editor/assets/{agent8-D3_GWeuh.js → agent8-BfxUNrEe.js}

@@ -1 +1 @@
-import{n as e}from"./index-CMlKFT0C.js";async function t(t){return new n((await e(()=>import(`./GameServer-C56iOUgF.js`),[],import.meta.url)).GameServer,t)}var n=class{raw;active=new Map;reconnecting=!1;disposed=!1;constructor(e,t){this.raw=new e({...t})}get account(){return this.raw.account}get connected(){return this.raw.connected}connect(){return this.raw.connected?Promise.resolve(!0):(this.disposed=!1,this.rawConnect())}rawConnect(){return this.raw.connect({onDisconnect:()=>void this.reconnect()})}disconnect(){this.disposed=!0;for(let e of this.active.values())e.off();return this.active.clear(),this.raw.disconnect()}remoteFunction(e,t,n){return this.raw.remoteFunction(e,t,n)}track(e){let t=Symbol(`sub`),n={make:e,off:e()};return this.active.set(t,n),()=>{n.off(),this.active.delete(t)}}async reconnect(){if(!this.disposed&&!this.reconnecting){this.reconnecting=!0;try{await this.rawConnect();for(let e of this.active.values())e.off(),e.off=e.make()}finally{this.reconnecting=!1}}}subscribeRoomState(e,t){return this.track(()=>this.raw.subscribeRoomState(e,t))}subscribeRoomMyState(e,t){return this.track(()=>this.raw.subscribeRoomMyState(e,t))}subscribeRoomAllUserStates(e,t){return this.track(()=>this.raw.subscribeRoomAllUserStates(e,e=>{let n={};for(let t of e??[]){if(!t||typeof t.account!=`string`||t.__leaved)continue;let{account:e,__updated:r,__leaved:i,...a}=t;n[e]=a}t(n)}))}subscribeRoomCollection(e,t,n){return this.track(()=>this.raw.subscribeRoomCollection(e,t,({items:e})=>{let t={};for(let n of e??[])n&&typeof n.__id==`string`&&(t[n.__id]=n);n(t)}))}onRoomMessage(e,t,n){return this.track(()=>this.raw.onRoomMessage(e,t,n))}onRoomUserJoin(e,t){return this.track(()=>this.raw.onRoomUserJoin(e,t))}onRoomUserLeave(e,t){return this.track(()=>this.raw.onRoomUserLeave(e,t))}subscribeGlobalState(e){return this.track(()=>this.raw.subscribeGlobalState(e))}subscribeGlobalMyState(e){return this.track(()=>this.raw.subscribeGlobalMyState(e))}subscribeGlobalUserState(e,t){return this.track(()=>this.raw.subscribeGlobalUserState(e,t))}subscribeGlobalCollection(e,t){return this.track(()=>this.raw.subscribeGlobalCollection(e,({items:e})=>{let n={};for(let t of e??[])t&&typeof t.__id==`string`&&(n[t.__id]=t);t(n)}))}subscribeAsset(e,t){return this.track(()=>this.raw.subscribeAsset(e,t))}onGlobalMessage(e,t){return this.track(()=>this.raw.onGlobalMessage(e,t))}};export{t as createAgent8Server};
+import{n as e}from"./index-BkIuXIjp.js";async function t(t){return new n((await e(()=>import(`./GameServer-C56iOUgF.js`),[],import.meta.url)).GameServer,t)}var n=class{raw;active=new Map;reconnecting=!1;disposed=!1;constructor(e,t){this.raw=new e({...t})}get account(){return this.raw.account}get connected(){return this.raw.connected}connect(){return this.raw.connected?Promise.resolve(!0):(this.disposed=!1,this.rawConnect())}rawConnect(){return this.raw.connect({onDisconnect:()=>void this.reconnect()})}disconnect(){this.disposed=!0;for(let e of this.active.values())e.off();return this.active.clear(),this.raw.disconnect()}remoteFunction(e,t,n){return this.raw.remoteFunction(e,t,n)}track(e){let t=Symbol(`sub`),n={make:e,off:e()};return this.active.set(t,n),()=>{n.off(),this.active.delete(t)}}async reconnect(){if(!this.disposed&&!this.reconnecting){this.reconnecting=!0;try{await this.rawConnect();for(let e of this.active.values())e.off(),e.off=e.make()}finally{this.reconnecting=!1}}}subscribeRoomState(e,t){return this.track(()=>this.raw.subscribeRoomState(e,t))}subscribeRoomMyState(e,t){return this.track(()=>this.raw.subscribeRoomMyState(e,t))}subscribeRoomAllUserStates(e,t){return this.track(()=>this.raw.subscribeRoomAllUserStates(e,e=>{let n={};for(let t of e??[]){if(!t||typeof t.account!=`string`||t.__leaved)continue;let{account:e,__updated:r,__leaved:i,...a}=t;n[e]=a}t(n)}))}subscribeRoomCollection(e,t,n){return this.track(()=>this.raw.subscribeRoomCollection(e,t,({items:e})=>{let t={};for(let n of e??[])n&&typeof n.__id==`string`&&(t[n.__id]=n);n(t)}))}onRoomMessage(e,t,n){return this.track(()=>this.raw.onRoomMessage(e,t,n))}onRoomUserJoin(e,t){return this.track(()=>this.raw.onRoomUserJoin(e,t))}onRoomUserLeave(e,t){return this.track(()=>this.raw.onRoomUserLeave(e,t))}subscribeGlobalState(e){return this.track(()=>this.raw.subscribeGlobalState(e))}subscribeGlobalMyState(e){return this.track(()=>this.raw.subscribeGlobalMyState(e))}subscribeGlobalUserState(e,t){return this.track(()=>this.raw.subscribeGlobalUserState(e,t))}subscribeGlobalCollection(e,t){return this.track(()=>this.raw.subscribeGlobalCollection(e,({items:e})=>{let n={};for(let t of e??[])t&&typeof t.__id==`string`&&(n[t.__id]=t);t(n)}))}subscribeAsset(e,t){return this.track(()=>this.raw.subscribeAsset(e,t))}onGlobalMessage(e,t){return this.track(()=>this.raw.onGlobalMessage(e,t))}};export{t as createAgent8Server};