incanto 0.35.0 → 0.36.0

package/dist/2d.d.ts

@@ -1,8 +1,8 @@
-import { N as Scene$1, S as Scheduler, T as RendererStats, b as Engine, bt as Node, d as PropSchema, n as BehaviorCtor, w as GameStats } from "./behavior-CGSCWOHB.js";
-import { n as DiagnosticSink, t as EditorSwitchOptions } from "./editor-switch-DyXEtH36.js";
-import { i as SceneJson, s as JsonObject } from "./schema-3ywbdlrv.js";
-import { t as LoadSceneOptions } from "./loader-CUcj00M8.js";
-import { t as ParticleSim } from "./particle-sim-B-vZBF5R.js";
+import { N as Scene$1, S as Scheduler, T as RendererStats, Tt as Node, b as Engine, d as PropSchema, n as BehaviorCtor, w as GameStats } from "./behavior-DibCwrW7.js";
+import { n as DiagnosticSink, t as EditorSwitchOptions } from "./editor-switch-DVwIGZdK.js";
+import { i as SceneJson, s as JsonObject } from "./schema-CFeioQRE.js";
+import { t as LoadSceneOptions } from "./loader-BqigZsfF.js";
+import { t as ParticleSim } from "./particle-sim-BzJ1yxoE.js";
 import { Group, Mesh, Object3D, Scene, Texture } from "three";
 import * as RapierNs from "@dimforge/rapier2d-compat";
 

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-B0Wfhi2-.js";
-import { _ as RigidBody2D, a as parseCells, c as ColorRect2D, d as AnimatedSprite2D, f as Sprite2D, g as PhysicsBody2D, h as CharacterBody2D, i as mergeSolidRects, l as CharacterController2D, m as Area2D, n as UILayer, o as Particles2D, p as Joint2D, r as TileMap2D, s as Label, t as registerNodes2D, u as Camera2D, v as StaticBody2D, y as Node2D } from "./register-DSmIRAf7.js";
-import { n as enablePhysics2D, t as Physics2D } from "./physics-2d-DqAclql-.js";
+import { a as AssetStore2D, i as syncTree2D, r as Renderer2D, t as createGame2D } from "./create-game-WmNFluFz.js";
+import { _ as RigidBody2D, a as parseCells, c as ColorRect2D, d as AnimatedSprite2D, f as Sprite2D, g as PhysicsBody2D, h as CharacterBody2D, i as mergeSolidRects, l as CharacterController2D, m as Area2D, n as UILayer, o as Particles2D, p as Joint2D, r as TileMap2D, s as Label, t as registerNodes2D, u as Camera2D, v as StaticBody2D, y as Node2D } from "./register-COGCNitr.js";
+import { n as enablePhysics2D, t as Physics2D } from "./physics-2d-B4v39hca.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,9 +1,9 @@
-import { N as Scene$1, S as Scheduler, T as RendererStats, b as Engine, bt as Node, d as PropSchema, n as BehaviorCtor, w as GameStats } from "./behavior-CGSCWOHB.js";
-import { n as DiagnosticSink, t as EditorSwitchOptions } from "./editor-switch-DyXEtH36.js";
-import { i as SceneJson, s as JsonObject } from "./schema-3ywbdlrv.js";
-import { t as LoadSceneOptions } from "./loader-CUcj00M8.js";
-import { t as ParticleSim } from "./particle-sim-B-vZBF5R.js";
-import { n as PathGrid, s as SpatialPose } from "./pathfinding-DgOo2KNF.js";
+import { N as Scene$1, S as Scheduler, T as RendererStats, Tt as Node, b as Engine, d as PropSchema, n as BehaviorCtor, w as GameStats } from "./behavior-DibCwrW7.js";
+import { n as DiagnosticSink, t as EditorSwitchOptions } from "./editor-switch-DVwIGZdK.js";
+import { i as SceneJson, s as JsonObject } from "./schema-CFeioQRE.js";
+import { t as LoadSceneOptions } from "./loader-BqigZsfF.js";
+import { t as ParticleSim } from "./particle-sim-BzJ1yxoE.js";
+import { n as PathGrid, s as SpatialPose } from "./pathfinding-B3QtdhvZ.js";
 import { AnimationClip, AnimationMixer, BufferGeometry, Color, DirectionalLight, Group, InstancedMesh, Mesh, MeshPhysicalMaterial, Object3D, PerspectiveCamera, Scene, ShaderMaterial, Texture, Vector3, WebGLRenderer } from "three";
 import { VRM } from "@pixiv/three-vrm";
 import { Sky } from "three/examples/jsm/objects/Sky.js";

package/dist/3d.js

@@ -1,9 +1,9 @@
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
-import { A as Water3D, F as PhysicsBody3D, I as RigidBody3D, L as StaticBody3D, M as WaterCutout3D, N as Area3D, P as CharacterBody3D, R as Node3D, V as WATER_MAX_RIPPLES, j as WATER_CUTOUT_MAX } from "./gameplay-BvhcQbfJ.js";
-import { A as Terrain3D, B as keyboardIntensity, C as resolveFlowerDensity, D as BoneLookAt3D, E as Camera3D, F as InstancedMesh3D, G as acquireTexture, H as rigPose, I as MeshInstance3D, M as TERRAIN_THEMES, N as terrainThemeLayers, O as BoneAttachment3D, P as Joint3D, R as QUARTER_PITCH, S as Flowers3D, T as CharacterController3D, U as TextureCache3D, V as movementState, W as acquireOwnTexture, _ as LoftMesh3D, a as Tree3D, b as Foliage3D, c as buildRiverRings, d as riverCarveChannels, f as riverStepFor, g as ModelInstance3D, h as Particles3D, i as VoxelGrid3D, j as DEFAULT_TERRAIN_TEXTURE_BASE, k as Billboard3D, l as findRiverCoverageGaps, m as traceDownhillPath, n as registerNodes3D, o as Trail3D, p as smoothCourse, r as VOXEL_PALETTE, s as River3D, u as projectToRiver, v as DirectionalLight3D, w as FLOWER_VARIETIES, x as DENSITY_PRESETS, y as OmniLight3D, z as cameraRelative } from "./environment-presets-TAGvmM3z.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-BUD89Kqh.js";
+import { A as Water3D, F as PhysicsBody3D, I as RigidBody3D, L as StaticBody3D, M as WaterCutout3D, N as Area3D, P as CharacterBody3D, R as Node3D, V as WATER_MAX_RIPPLES, j as WATER_CUTOUT_MAX } from "./gameplay-C0MUMSak.js";
+import { A as Terrain3D, B as keyboardIntensity, C as resolveFlowerDensity, D as BoneLookAt3D, E as Camera3D, F as InstancedMesh3D, G as acquireTexture, H as rigPose, I as MeshInstance3D, M as TERRAIN_THEMES, N as terrainThemeLayers, O as BoneAttachment3D, P as Joint3D, R as QUARTER_PITCH, S as Flowers3D, T as CharacterController3D, U as TextureCache3D, V as movementState, W as acquireOwnTexture, _ as LoftMesh3D, a as Tree3D, b as Foliage3D, c as buildRiverRings, d as riverCarveChannels, f as riverStepFor, g as ModelInstance3D, h as Particles3D, i as VoxelGrid3D, j as DEFAULT_TERRAIN_TEXTURE_BASE, k as Billboard3D, l as findRiverCoverageGaps, m as traceDownhillPath, n as registerNodes3D, o as Trail3D, p as smoothCourse, r as VOXEL_PALETTE, s as River3D, u as projectToRiver, v as DirectionalLight3D, w as FLOWER_VARIETIES, x as DENSITY_PRESETS, y as OmniLight3D, z as cameraRelative } from "./environment-presets-fK9oyrrR.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-BBD3iUFZ.js";
 import { n as splatWeights, t as buildHeightmap } from "./heightmap-CRK0M4jT.js";
-import { n as enablePhysics3D, t as Physics3D } from "./physics-3d-DxBH4sIF.js";
+import { n as enablePhysics3D, t as Physics3D } from "./physics-3d-DFJVMYET.js";
 //#region src/3d/environment-runtime.ts
 /**
 * Live environment editing — the renderer re-applies `scene.environment`

package/dist/{audit-C5oZGAru.js → audit-D7F3n3Nt.js}

@@ -1,4 +1,4 @@
-import { A as translationKey } from "./register-BFLg0-_i.js";
+import { A as translationKey } from "./register-BHAwM4bK.js";
 //#region src/core/audit.ts
 const ANIMATED_TYPES = new Set([
 	"Particles2D",

package/dist/{behavior-CGSCWOHB.d.ts → behavior-DibCwrW7.d.ts}

@@ -1,4 +1,4 @@
-import { a as Rng, c as JsonValue, i as SceneJson, s as JsonObject } from "./schema-3ywbdlrv.js";
+import { a as Rng, c as JsonValue, i as SceneJson, s as JsonObject } from "./schema-CFeioQRE.js";
 
 //#region src/core/signal.d.ts
 /**
@@ -869,6 +869,48 @@ declare class Localization {
 */
 declare function suggestLocale(available: readonly string[], languages?: readonly string[]): string;
 //#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>;
+/**
+* A scene's own bands, on top of the six built in.
+*
+* A band is a NUMBER, not a name — `base(orderGroup) + renderOrder` is the whole
+* mechanism — so a game that wants "ui-back sits between effects and overlay"
+* declares what it is worth:
+*
+* ```json
+* { "orderGroups": { "ui-back": 2500, "ui-front": 3500 } }
+* ```
+*
+* Declaring a built-in name RE-BASES it for this scene, which is deliberate
+* (a 2D game with no terrain can reclaim that band) and is why the merge is
+* scene-last.
+*/
+type OrderGroupTable = Readonly<Record<string, number>>;
+/** Built-ins with a scene's declarations layered over them. */
+declare function resolveOrderGroups(declared?: Record<string, number>): OrderGroupTable;
+/**
+* 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.
+*/
+declare function effectiveOrder(group: string, renderOrder: number, table?: OrderGroupTable): number;
+//#endregion
 //#region src/core/save.d.ts
 /**
 * Namespaced game persistence — high scores, unlocks, settings. localStorage
@@ -1003,6 +1045,8 @@ declare class Scene {
   readonly input: JsonObject | undefined;
   /** Translations by locale (merged into `Engine.locale` on setScene). */
   readonly strings: Record<string, Record<string, string>> | undefined;
+  /** Extra draw-order bands (`name → base`), layered over the built-ins. */
+  readonly orderGroups: Record<string, number> | undefined;
   /** Physics config (gravity etc. — interpreted by the physics modules). */
   readonly physics: JsonObject | undefined;
   /** Multiplayer config (room etc. — interpreted by incanto/net). */
@@ -1191,6 +1235,11 @@ declare class Engine {
   * anything a locale does not declare falls back to it silently.
   */
   readonly locale: Localization;
+  /**
+  * Draw-order bands in force: the six built in, plus whatever the current
+  * scene declares. Read by `Node2D`/`Node3D.effectiveRenderOrder`.
+  */
+  orderGroups: OrderGroupTable;
   /** Low-latency procedural-SFX player (WebAudio, headless-safe). AudioPlayer
   *  presets play through it; games may call `engine.sfx.play(...)` directly. */
   readonly sfx: SfxEngine;
@@ -1376,7 +1425,7 @@ declare function getNodeSignals(typeName: string): string[];
 * Instantiate a registered type, assign schema defaults (cloned), then the
 * given props — validating every key and its JSON kind against the default.
 */
-declare function createNode(typeName: string, props?: Record<string, JsonValue>): Node;
+declare function createNode(typeName: string, props?: Record<string, JsonValue>, extraOptions?: Record<string, readonly string[]>): Node;
 //#endregion
 //#region src/core/behavior.d.ts
 interface BehaviorCtor {
@@ -1471,4 +1520,4 @@ declare function registeredBehaviors(): string[];
 /** Test isolation helper. */
 declare function clearBehaviors(): void;
 //#endregion
-export { Voice as $, qualityEnvironment as A, restoreBehaviors as B, EngineStats as C, LogEntry as Ct, QualityTier as D, SignalListener as Dt, DeviceHints as E, Signal as Et, RestoreReport as F, Localization as G, createSaveStore as H, SaveSlot as I, translationKey as J, T_PREFIX as K, SaveSlots as L, suggestQuality as M, Scene as N, Settings as O, BehaviorState as P, isAudioContextAvailable as Q, behaviorsWithoutSave as R, Scheduler as S, SceneTree as St, RendererStats as T, LogManager as Tt, BASE_LOCALE as U, SaveStore as V, LocaleTables as W, SfxEngine as X, InputMap as Y, SfxPlayOptions as Z, mergeStaticSignals as _, PlayMusicOptions as _t, clearBehaviors as a, Vec3 as at, Engine as b, Node as bt, registeredBehaviors as c, SFX_PRESETS as ct, PropSchema as d, SfxWave as dt, VoicePreset as et, clearRegistry as f, SynthOptions as ft, getNodeType as g, MusicTrack as gt, getNodeSignals as h, MusicManager as ht, behaviorSignals as i, SpatialParams as it, readDeviceHints as j, SettingsValues as k, NodeCtor as l, SFX_PRESET_NAMES as lt, getNodeSchema as m, MusicBackend as mt, BehaviorCtor as n, ROLLOFF_MODELS as nt, getBehavior as o, spatialGain as ot, createNode as p, synthSfx as pt, suggestLocale as q, behaviorSchema as r, RolloffModel as rt, registerBehavior as s, spatialPan as st, Behavior as t, Listener as tt, PropDef as u, SfxParams as ut, registerNode as v, AudioBuses as vt, GameStats as w, LogLevel as wt, EngineOptions as x, NodeLifecycle as xt, registeredTypes as y, BusName as yt, captureBehaviors as z };
+export { translationKey as $, qualityEnvironment as A, LogManager as At, restoreBehaviors as B, EngineStats as C, AudioBuses as Ct, QualityTier as D, SceneTree as Dt, DeviceHints as E, NodeLifecycle as Et, RestoreReport as F, OrderGroupTable as G, createSaveStore as H, SaveSlot as I, BASE_LOCALE as J, effectiveOrder as K, SaveSlots as L, suggestQuality as M, SignalListener as Mt, Scene as N, Settings as O, LogEntry as Ot, BehaviorState as P, suggestLocale as Q, behaviorsWithoutSave as R, Scheduler as S, PlayMusicOptions as St, RendererStats as T, Node as Tt, ORDER_GROUP_BASE as U, SaveStore as V, OrderGroup as W, Localization as X, LocaleTables as Y, T_PREFIX as Z, mergeStaticSignals as _, SynthOptions as _t, clearBehaviors as a, VoicePreset as at, Engine as b, MusicManager as bt, registeredBehaviors as c, RolloffModel as ct, PropSchema as d, spatialGain as dt, InputMap as et, clearRegistry as f, spatialPan as ft, getNodeType as g, SfxWave as gt, getNodeSignals as h, SfxParams as ht, behaviorSignals as i, Voice as it, readDeviceHints as j, Signal as jt, SettingsValues as k, LogLevel as kt, NodeCtor as l, SpatialParams as lt, getNodeSchema as m, SFX_PRESET_NAMES as mt, BehaviorCtor as n, SfxPlayOptions as nt, getBehavior as o, Listener as ot, createNode as p, SFX_PRESETS as pt, resolveOrderGroups as q, behaviorSchema as r, isAudioContextAvailable as rt, registerBehavior as s, ROLLOFF_MODELS as st, Behavior as t, SfxEngine as tt, PropDef as u, Vec3 as ut, registerNode as v, synthSfx as vt, GameStats as w, BusName as wt, EngineOptions as x, MusicTrack as xt, registeredTypes as y, MusicBackend as yt, captureBehaviors as z };

package/dist/{create-game-BUD89Kqh.js → create-game-BBD3iUFZ.js}

@@ -1,13 +1,13 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { h as diagnose, n as loadScene, x as registerBehavior } from "./loader-Mig5fY4n.js";
-import { h as Engine, m as AudioPlayer } from "./register-BFLg0-_i.js";
+import { n as loadScene, v as diagnose, w as registerBehavior } from "./loader-DAZlgqeC.js";
+import { h as Engine, m as AudioPlayer } from "./register-BHAwM4bK.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { i as resolveRendering, n as attachTouchControls } from "./touch-BoNg_MnF.js";
 import { a as poseFromRenderer, i as openBundledEditor, n as crossFade, r as devServerLibrary, t as teardown } from "./teardown-ByzfDPyu.js";
-import { B as createCausticsQuad, F as PhysicsBody3D, R as Node3D, n as registerGameplayBehaviors } from "./gameplay-BvhcQbfJ.js";
+import { B as createCausticsQuad, F as PhysicsBody3D, R as Node3D, n as registerGameplayBehaviors } from "./gameplay-C0MUMSak.js";
 import { t as debugSources } from "./debug-draw-BM3DsvtT.js";
-import { E as Camera3D, U as TextureCache3D, g as ModelInstance3D, n as registerNodes3D, t as resolveEnvironmentHdri, v as DirectionalLight3D } from "./environment-presets-TAGvmM3z.js";
-import { n as enablePhysics3D } from "./physics-3d-DxBH4sIF.js";
+import { E as Camera3D, U as TextureCache3D, g as ModelInstance3D, n as registerNodes3D, t as resolveEnvironmentHdri, v as DirectionalLight3D } from "./environment-presets-fK9oyrrR.js";
+import { n as enablePhysics3D } from "./physics-3d-DFJVMYET.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";

package/dist/{create-game-B0Wfhi2-.js → create-game-WmNFluFz.js}

@@ -1,13 +1,13 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { h as diagnose, n as loadScene, o as computeViewport, s as resolveViewport, x as registerBehavior } from "./loader-Mig5fY4n.js";
-import { h as Engine, m as AudioPlayer } from "./register-BFLg0-_i.js";
+import { n as loadScene, o as computeViewport, s as resolveViewport, v as diagnose, w as registerBehavior } from "./loader-DAZlgqeC.js";
+import { h as Engine, m as AudioPlayer } from "./register-BHAwM4bK.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { i as resolveRendering, n as attachTouchControls } from "./touch-BoNg_MnF.js";
 import { i as openBundledEditor, n as crossFade, r as devServerLibrary, t as teardown } from "./teardown-ByzfDPyu.js";
-import { n as registerGameplayBehaviors } from "./gameplay-BvhcQbfJ.js";
-import { g as PhysicsBody2D, n as UILayer, t as registerNodes2D, u as Camera2D, y as Node2D } from "./register-DSmIRAf7.js";
+import { n as registerGameplayBehaviors } from "./gameplay-C0MUMSak.js";
+import { g as PhysicsBody2D, n as UILayer, t as registerNodes2D, u as Camera2D, y as Node2D } from "./register-COGCNitr.js";
 import { t as debugSources } from "./debug-draw-BM3DsvtT.js";
-import { n as enablePhysics2D } from "./physics-2d-DqAclql-.js";
+import { n as enablePhysics2D } from "./physics-2d-B4v39hca.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 { T as RendererStats, b as Engine, wt as LogLevel } from "./behavior-CGSCWOHB.js";
+import { T as RendererStats, b as Engine, kt as LogLevel } from "./behavior-DibCwrW7.js";
 
 //#region src/debug/panel.d.ts
 /** Minimal document surface the overlay needs (injectable for tests). */

package/dist/debug.js

@@ -1,5 +1,5 @@
 import { t as jsonClone } from "./json-BLk7H2Qa.js";
-import { s as mergeStaticProps } from "./registry-CJdGpT2V.js";
+import { s as mergeStaticProps } from "./registry-IyWCGe4q.js";
 import { t as debugSources } from "./debug-draw-BM3DsvtT.js";
 //#region src/debug/panel.ts
 /** Keep a panel rect on screen and above the minimum usable size. */

package/dist/{duplicate-C716f-97.js → duplicate-Cvb1BSca.js}

@@ -1,18 +1,4 @@
-import { i as serializeNode, t as buildNodeJson } from "./loader-Mig5fY4n.js";
-//#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
+import { i as serializeNode, t as buildNodeJson } from "./loader-DAZlgqeC.js";
 //#region src/core/scene/duplicate.ts
 function stripUids(json) {
 	const { uid: _uid, ...rest } = json;
@@ -33,4 +19,4 @@ function duplicateNode(node) {
 	return buildNodeJson(stripUids(serializeNode(node)));
 }
 //#endregion
-export { ORDER_GROUP_BASE as n, effectiveOrder as r, duplicateNode as t };
+export { duplicateNode as t };

package/dist/{editor-switch-DyXEtH36.d.ts → editor-switch-DVwIGZdK.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/diagnostics.d.ts
 /** The minimum an engine has to look like to receive a diagnostic. */