incanto 0.6.0 → 0.7.1

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, Z as Node, b as Scheduler, l as PropSchema, n as BehaviorCtor, v as Engine, w as Scene$1 } from "./behavior-q3cejJgs.js";
+import { t as LoadSceneOptions } from "./loader-DnLMMRy8.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;
@@ -650,6 +655,8 @@ declare class Renderer2D {
   private readonly canvas;
   constructor(opts: Renderer2DOptions);
   private readonly debugLines;
+  private readonly selectionLines;
+  private syncSelectionOutline;
   private syncDebugLines;
   private render;
   private lastViewport;

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-DuDkqnjl.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-Cl3pAxX-.js";
+import { n as enablePhysics2D, t as Physics2D } from "./physics-2d-CZM5Y90X.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, Z as Node, b as Scheduler, l as PropSchema, n as BehaviorCtor, v as Engine, w as Scene$1 } from "./behavior-q3cejJgs.js";
+import { t as LoadSceneOptions } from "./loader-DnLMMRy8.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-C3bH_eZ5.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. */
@@ -1963,6 +1969,8 @@ declare class Renderer3D {
   private bloomCompositeUniforms;
   constructor(opts: Renderer3DOptions);
   private readonly debugLines;
+  private readonly selectionLines;
+  private syncSelectionOutline;
   private syncDebugLines;
   private render;
   /**

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-rFulaS3s.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-CpXcMiEk.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-DT5e8izo.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-C3bH_eZ5.d.ts}

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

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

@@ -1,5 +1,68 @@
 import { a as Rng, c as JsonValue, i as SceneJson, s as JsonObject } from "./schema-CcoWb32N.js";
 
+//#region src/core/scene-tree.d.ts
+/**
+* Owns a node tree and drives its lifecycle:
+*
+* - `setRoot` → onEnterTree parent-first, then onReady children-first (once per instance)
+* - `update`/`fixedUpdate` → parent-first traversal, then flush of queued frees
+* - group queries across attached nodes
+*
+* Headless by design — tests step it manually; the render loop (M2) calls it.
+*/
+declare class SceneTree {
+  private _root;
+  private _engine;
+  private readonly freeQueue;
+  /**
+  * name → attached nodes with that name. Maintained by Node enter/exit/rename
+  * so `%name` targeting and root-level getNodesByName are O(1) — behaviors
+  * resolve targets every frame and a full-tree walk per chaser melted horde
+  * scenes (N chasers × whole tree, 60×/s).
+  */
+  private readonly _nameIndex;
+  /**
+  * Bumped whenever ANY node attaches or detaches — cheap "did the tree
+  * change shape?" check for per-step body gathers and similar caches.
+  */
+  _structureVersion: number;
+  private _frameId;
+  /**
+  * Monotonic update-frame counter — bumped once per `update()`. Per-frame
+  * caches (e.g. the 3d grass-bender body gather) key off this so they rebuild
+  * at most once a frame regardless of node visitation order.
+  */
+  get frameId(): number;
+  /** @internal Node attach hook. */
+  _indexName(node: Node): void;
+  /** @internal Node detach/rename hook (`name` = the entry to remove). */
+  _unindexName(node: Node, name?: string): void;
+  /** @internal Every ATTACHED node named `name` (undefined = none). */
+  _nodesNamed(name: string): ReadonlySet<Node> | undefined;
+  /**
+  * @internal Opaque per-frame scratch the 3d layer parks its shared moving-body
+  * snapshot on (kept here so it is per-tree-instance, never a module global —
+  * core stays three-free, the 3d resolver owns the shape).
+  */
+  _frameScratch: unknown;
+  get root(): Node | null;
+  /** The engine driving this tree (set by Engine.setScene), or null. */
+  get engine(): Engine | null;
+  /** @internal */
+  _setEngine(engine: Engine | null): void;
+  setRoot(node: Node): void;
+  update(dt: number): void;
+  fixedUpdate(dt: number): void;
+  getNodesInGroup(group: string): Node[];
+  /** Call `method(...args)` on every group member that implements it. */
+  callGroup(group: string, method: string, ...args: unknown[]): void;
+  /** @internal */
+  _queueFree(node: Node): void;
+  /** @internal Called by Node.free(): a freed root must not be re-drivable. */
+  _detachRoot(node: Node): void;
+  private flushFreeQueue;
+}
+//#endregion
 //#region src/core/signal.d.ts
 /**
 * Minimal typed observer used for every engine event (Godot signal semantics).
@@ -20,6 +83,116 @@ declare class Signal<Args extends unknown[] = unknown[]> {
   get connectionCount(): number;
 }
 //#endregion
+//#region src/core/node.d.ts
+/** Lifecycle hooks a SceneTree drives. Wired in scene-tree.ts. */
+interface NodeLifecycle {
+  onEnterTree(): void;
+  onReady(): void;
+  onExitTree(): void;
+  update(dt: number): void;
+  fixedUpdate(dt: number): void;
+}
+/**
+* Base class of everything in an Incanto scene (Godot's Node model).
+*
+* Pure data + tree structure: no rendering, no DOM, no three.js — renderer
+* adapters subscribe from the outside.
+*/
+declare class Node implements NodeLifecycle {
+  static readonly typeName: string;
+  /**
+  * Signals this node type can emit, declared statically (merged up the class
+  * hierarchy). A behavior's `static signals` are declared onto its node at
+  * load. Emitting or subscribing an UNDECLARED signal is a hard error —
+  * a typo'd signal name must fail loudly, never silently never-fire.
+  */
+  static readonly signals?: readonly string[];
+  private _name;
+  private _parent;
+  private readonly _children;
+  private readonly _groups;
+  private readonly _signals;
+  private _declared;
+  private _tree;
+  private _ready;
+  /**
+  * Optional STABLE identifier (scene JSON `uid`) — unlike names (unique only
+  * among siblings) a uid is unique across the whole scene, so scripts and
+  * tools can address a node no matter where it moves.
+  */
+  uid: string | null;
+  /** Free-form JSON identity for game logic (e.g. `{kind: 'ITEM', value: 10}`). */
+  tags: Record<string, unknown>;
+  /** Behavior attachment blob from scene JSON (resolved by the loader). */
+  script: JsonObject | null;
+  /** The resolved behavior instance (set by the loader from `script`). */
+  behavior: Behavior | null;
+  /** Replication config blob from scene JSON (interpreted in M6; preserved until then). */
+  network: JsonObject | null;
+  constructor(name?: string);
+  get name(): string;
+  set name(value: string);
+  get parent(): Node | null;
+  get children(): readonly Node[];
+  get groups(): ReadonlySet<string>;
+  /** The SceneTree this node is attached to, or null while detached. */
+  get tree(): SceneTree | null;
+  /** Whether onReady has run (it runs at most once per instance). */
+  get isReady(): boolean;
+  addChild<T extends Node>(child: T): T;
+  removeChild(child: Node): void;
+  reparent(newParent: Node): void;
+  findChild(name: string, recursive?: boolean): Node | null;
+  /** Topmost ancestor (the node itself when detached). */
+  getRoot(): Node;
+  /** Depth-first search of THIS subtree for the node carrying `uid`. */
+  getNodeByUid(uid: string): Node | null;
+  /** Every node in THIS subtree named `name` — names repeat, so a list. */
+  getNodesByName(name: string): Node[];
+  getPath(): string;
+  getNode(path: string): Node;
+  getNodeOrNull(path: string): Node | null;
+  private resolve;
+  addToGroup(group: string): void;
+  removeFromGroup(group: string): void;
+  isInGroup(group: string): boolean;
+  private declaredSignals;
+  /** Declare an ad-hoc signal on THIS instance (static `signals` covers types). */
+  declareSignal(name: string): void;
+  /** Every signal this instance may emit (static + behavior + ad-hoc). */
+  declaredSignalNames(): string[];
+  private assertDeclared;
+  /** Get the named DECLARED signal (creating its Signal object on demand). */
+  signal(name: string): Signal<unknown[]>;
+  on(signal: string, fn: SignalListener<unknown[]>, opts?: {
+    once?: boolean;
+  }): () => void;
+  off(signal: string, fn: SignalListener<unknown[]>): void;
+  emit(signal: string, ...args: unknown[]): void;
+  /**
+  * Defer destruction to the end of the current update pass (flushed by the
+  * SceneTree). Frees immediately when detached from any tree.
+  */
+  queueFree(): void;
+  /** Immediately detach and tear down this node and its children. */
+  free(): void;
+  /** @internal */
+  _propagateEnterTree(tree: SceneTree): void;
+  /** @internal */
+  _propagateReady(): void;
+  /** @internal */
+  _propagateExitTree(): void;
+  /** @internal */
+  _propagateUpdate(dt: number): void;
+  /** @internal */
+  _propagateFixedUpdate(dt: number): void;
+  onEnterTree(): void;
+  onReady(): void;
+  onExitTree(): void;
+  update(_dt: number): void;
+  fixedUpdate(_dt: number): void;
+}
+//#endregion
 //#region src/core/audio/buses.d.ts
 /** The two volume buses every sound routes through (plus the global `master`). */
 type BusName = "sfx" | "music";
@@ -477,179 +650,6 @@ declare class LogManager {
   private push;
 }
 //#endregion
-//#region src/core/scene-tree.d.ts
-/**
-* Owns a node tree and drives its lifecycle:
-*
-* - `setRoot` → onEnterTree parent-first, then onReady children-first (once per instance)
-* - `update`/`fixedUpdate` → parent-first traversal, then flush of queued frees
-* - group queries across attached nodes
-*
-* Headless by design — tests step it manually; the render loop (M2) calls it.
-*/
-declare class SceneTree {
-  private _root;
-  private _engine;
-  private readonly freeQueue;
-  /**
-  * name → attached nodes with that name. Maintained by Node enter/exit/rename
-  * so `%name` targeting and root-level getNodesByName are O(1) — behaviors
-  * resolve targets every frame and a full-tree walk per chaser melted horde
-  * scenes (N chasers × whole tree, 60×/s).
-  */
-  private readonly _nameIndex;
-  /**
-  * Bumped whenever ANY node attaches or detaches — cheap "did the tree
-  * change shape?" check for per-step body gathers and similar caches.
-  */
-  _structureVersion: number;
-  private _frameId;
-  /**
-  * Monotonic update-frame counter — bumped once per `update()`. Per-frame
-  * caches (e.g. the 3d grass-bender body gather) key off this so they rebuild
-  * at most once a frame regardless of node visitation order.
-  */
-  get frameId(): number;
-  /** @internal Node attach hook. */
-  _indexName(node: Node): void;
-  /** @internal Node detach/rename hook (`name` = the entry to remove). */
-  _unindexName(node: Node, name?: string): void;
-  /** @internal Every ATTACHED node named `name` (undefined = none). */
-  _nodesNamed(name: string): ReadonlySet<Node> | undefined;
-  /**
-  * @internal Opaque per-frame scratch the 3d layer parks its shared moving-body
-  * snapshot on (kept here so it is per-tree-instance, never a module global —
-  * core stays three-free, the 3d resolver owns the shape).
-  */
-  _frameScratch: unknown;
-  get root(): Node | null;
-  /** The engine driving this tree (set by Engine.setScene), or null. */
-  get engine(): Engine | null;
-  /** @internal */
-  _setEngine(engine: Engine | null): void;
-  setRoot(node: Node): void;
-  update(dt: number): void;
-  fixedUpdate(dt: number): void;
-  getNodesInGroup(group: string): Node[];
-  /** Call `method(...args)` on every group member that implements it. */
-  callGroup(group: string, method: string, ...args: unknown[]): void;
-  /** @internal */
-  _queueFree(node: Node): void;
-  /** @internal Called by Node.free(): a freed root must not be re-drivable. */
-  _detachRoot(node: Node): void;
-  private flushFreeQueue;
-}
-//#endregion
-//#region src/core/node.d.ts
-/** Lifecycle hooks a SceneTree drives. Wired in scene-tree.ts. */
-interface NodeLifecycle {
-  onEnterTree(): void;
-  onReady(): void;
-  onExitTree(): void;
-  update(dt: number): void;
-  fixedUpdate(dt: number): void;
-}
-/**
-* Base class of everything in an Incanto scene (Godot's Node model).
-*
-* Pure data + tree structure: no rendering, no DOM, no three.js — renderer
-* adapters subscribe from the outside.
-*/
-declare class Node implements NodeLifecycle {
-  static readonly typeName: string;
-  /**
-  * Signals this node type can emit, declared statically (merged up the class
-  * hierarchy). A behavior's `static signals` are declared onto its node at
-  * load. Emitting or subscribing an UNDECLARED signal is a hard error —
-  * a typo'd signal name must fail loudly, never silently never-fire.
-  */
-  static readonly signals?: readonly string[];
-  private _name;
-  private _parent;
-  private readonly _children;
-  private readonly _groups;
-  private readonly _signals;
-  private _declared;
-  private _tree;
-  private _ready;
-  /**
-  * Optional STABLE identifier (scene JSON `uid`) — unlike names (unique only
-  * among siblings) a uid is unique across the whole scene, so scripts and
-  * tools can address a node no matter where it moves.
-  */
-  uid: string | null;
-  /** Free-form JSON identity for game logic (e.g. `{kind: 'ITEM', value: 10}`). */
-  tags: Record<string, unknown>;
-  /** Behavior attachment blob from scene JSON (resolved by the loader). */
-  script: JsonObject | null;
-  /** The resolved behavior instance (set by the loader from `script`). */
-  behavior: Behavior | null;
-  /** Replication config blob from scene JSON (interpreted in M6; preserved until then). */
-  network: JsonObject | null;
-  constructor(name?: string);
-  get name(): string;
-  set name(value: string);
-  get parent(): Node | null;
-  get children(): readonly Node[];
-  get groups(): ReadonlySet<string>;
-  /** The SceneTree this node is attached to, or null while detached. */
-  get tree(): SceneTree | null;
-  /** Whether onReady has run (it runs at most once per instance). */
-  get isReady(): boolean;
-  addChild<T extends Node>(child: T): T;
-  removeChild(child: Node): void;
-  reparent(newParent: Node): void;
-  findChild(name: string, recursive?: boolean): Node | null;
-  /** Topmost ancestor (the node itself when detached). */
-  getRoot(): Node;
-  /** Depth-first search of THIS subtree for the node carrying `uid`. */
-  getNodeByUid(uid: string): Node | null;
-  /** Every node in THIS subtree named `name` — names repeat, so a list. */
-  getNodesByName(name: string): Node[];
-  getPath(): string;
-  getNode(path: string): Node;
-  getNodeOrNull(path: string): Node | null;
-  private resolve;
-  addToGroup(group: string): void;
-  removeFromGroup(group: string): void;
-  isInGroup(group: string): boolean;
-  private declaredSignals;
-  /** Declare an ad-hoc signal on THIS instance (static `signals` covers types). */
-  declareSignal(name: string): void;
-  /** Every signal this instance may emit (static + behavior + ad-hoc). */
-  declaredSignalNames(): string[];
-  private assertDeclared;
-  /** Get the named DECLARED signal (creating its Signal object on demand). */
-  signal(name: string): Signal<unknown[]>;
-  on(signal: string, fn: SignalListener<unknown[]>, opts?: {
-    once?: boolean;
-  }): () => void;
-  off(signal: string, fn: SignalListener<unknown[]>): void;
-  emit(signal: string, ...args: unknown[]): void;
-  /**
-  * Defer destruction to the end of the current update pass (flushed by the
-  * SceneTree). Frees immediately when detached from any tree.
-  */
-  queueFree(): void;
-  /** Immediately detach and tear down this node and its children. */
-  free(): void;
-  /** @internal */
-  _propagateEnterTree(tree: SceneTree): void;
-  /** @internal */
-  _propagateReady(): void;
-  /** @internal */
-  _propagateExitTree(): void;
-  /** @internal */
-  _propagateUpdate(dt: number): void;
-  /** @internal */
-  _propagateFixedUpdate(dt: number): void;
-  onEnterTree(): void;
-  onReady(): void;
-  onExitTree(): void;
-  update(_dt: number): void;
-  fixedUpdate(_dt: number): void;
-}
-//#endregion
 //#region src/core/scene/scene.d.ts
 /**
 * A loaded, live scene: the node tree plus everything needed to round-trip
@@ -773,6 +773,24 @@ declare class Engine {
   * timers, behaviors all breathe together. See `gameplay` `hitStop()`.
   */
   timeScale: number;
+  /**
+  * The node the dev overlay has selected (renderers draw its bounding box
+  * as an orange outline in the game view so you can SEE what you picked).
+  * Null when nothing is selected; cleared automatically when it leaves the
+  * tree. Set by the debug overlay — games normally never touch this.
+  */
+  debugSelection: Node | null;
+  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. */
@@ -902,4 +920,4 @@ declare function registeredBehaviors(): string[];
 /** Test isolation helper. */
 declare function clearBehaviors(): void;
 //#endregion
-export { BusName as $, LogManager as A, spatialGain as B, RendererStats as C, SceneTree as D, NodeLifecycle as E, Listener as F, SfxWave as G, SFX_PRESETS as H, ROLLOFF_MODELS as I, MusicBackend as J, SynthOptions as K, RolloffModel as L, SfxEngine as M, SfxPlayOptions as N, LogEntry as O, isAudioContextAvailable as P, AudioBuses as Q, SpatialParams as R, GameStats as S, Node as T, SFX_PRESET_NAMES as U, spatialPan as V, SfxParams as W, MusicTrack as X, MusicManager as Y, PlayMusicOptions as Z, registeredTypes as _, registerBehavior as a, Scheduler as b, PropDef as c, createNode as d, Signal as et, getNodeSchema as f, registerNode as g, mergeStaticSignals as h, getBehavior as i, InputMap as j, LogLevel as k, PropSchema as l, getNodeType as m, BehaviorCtor as n, registeredBehaviors as o, getNodeSignals as p, synthSfx as q, clearBehaviors as r, NodeCtor as s, Behavior as t, SignalListener as tt, clearRegistry as u, Engine as v, Scene as w, EngineStats as x, EngineOptions as y, Vec3 as z };
+export { Signal as $, SfxPlayOptions as A, SFX_PRESET_NAMES as B, RendererStats as C, LogManager as D, LogLevel as E, SpatialParams as F, MusicBackend as G, SfxWave as H, Vec3 as I, PlayMusicOptions as J, MusicManager as K, spatialGain as L, Listener as M, ROLLOFF_MODELS as N, InputMap as O, RolloffModel as P, NodeLifecycle as Q, spatialPan as R, GameStats as S, LogEntry as T, SynthOptions as U, SfxParams as V, synthSfx as W, BusName as X, AudioBuses as Y, Node as Z, registeredTypes as _, registerBehavior as a, Scheduler as b, PropDef as c, createNode as d, SignalListener as et, getNodeSchema as f, registerNode as g, mergeStaticSignals as h, getBehavior as i, isAudioContextAvailable as j, SfxEngine as k, PropSchema as l, getNodeType as m, BehaviorCtor as n, registeredBehaviors as o, getNodeSignals as p, MusicTrack as q, clearBehaviors as r, NodeCtor as s, Behavior as t, SceneTree as tt, clearRegistry as u, Engine as v, Scene as w, EngineStats as x, EngineOptions as y, SFX_PRESETS as z };

package/dist/{create-game-B_sW_eiE.js → create-game-DuDkqnjl.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-m3CdTGSl.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { s as AudioPlayer } from "./register-Dl_ixIJe.js";
 import { i as resolveRendering, n as attachTouchControls } from "./touch-031PxtCR.js";
 import { n as registerGameplayBehaviors } from "./gameplay-CDFgSG6z.js";
-import { 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-Cl3pAxX-.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-CZM5Y90X.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
 /**
@@ -101,6 +101,58 @@ function worldFromScreen(view, sx, sy) {
 	};
 }
 //#endregion
+//#region src/2d/selection-outline.ts
+/** 2D twin of the 3D selection outline: a world-space (px, y-down) rectangle
+*  around the selected node's rendered extent, or a marker square. */
+const box = new Box3();
+const size = new Vector3();
+const MARKER_HALF = 12;
+/** 4 rect edges = 8 points × xy. */
+const OUT = new Float32Array(16);
+function selectionOutline2D(node) {
+	if (!(node instanceof Node2D)) return null;
+	const obj = node._ensureObject2D();
+	obj.updateWorldMatrix(true, true);
+	box.setFromObject(obj);
+	box.getSize(size);
+	let minX;
+	let minY;
+	let maxX;
+	let maxY;
+	if (!Number.isFinite(size.x) || size.x === 0 && size.y === 0) {
+		const p = new Vector3().setFromMatrixPosition(obj.matrixWorld);
+		minX = p.x - MARKER_HALF;
+		maxX = p.x + MARKER_HALF;
+		minY = p.y - MARKER_HALF;
+		maxY = p.y + MARKER_HALF;
+	} else {
+		minX = box.min.x - 2;
+		maxX = box.max.x + 2;
+		minY = box.min.y - 2;
+		maxY = box.max.y + 2;
+	}
+	const pts = [
+		minX,
+		minY,
+		maxX,
+		minY,
+		maxX,
+		minY,
+		maxX,
+		maxY,
+		maxX,
+		maxY,
+		minX,
+		maxY,
+		minX,
+		maxY,
+		minX,
+		minY
+	];
+	OUT.set(pts);
+	return OUT;
+}
+//#endregion
 //#region src/2d/sync.ts
 function createSync2DScratch() {
 	return {
@@ -217,14 +269,44 @@ var Renderer2D = class {
 		});
 		this.webgl.setPixelRatio(rendering.pixelRatio);
 		this.webgl.info.autoReset = false;
-		this.debugLines = new LineSegments(new BufferGeometry(), new LineBasicMaterial({ color: "#00ff6e" }));
+		this.debugLines = new LineSegments(new BufferGeometry(), new LineBasicMaterial({
+			color: "#00ff6e",
+			transparent: true,
+			depthTest: false
+		}));
 		this.debugLines.frustumCulled = false;
 		this.debugLines.renderOrder = 9999;
 		this.debugLines.visible = false;
 		this.worldScene.add(this.debugLines);
+		this.selectionLines = new LineSegments(new BufferGeometry(), new LineBasicMaterial({
+			color: "#ffb020",
+			transparent: true,
+			depthTest: false
+		}));
+		this.selectionLines.frustumCulled = false;
+		this.selectionLines.renderOrder = 1e4;
+		this.selectionLines.visible = false;
+		this.worldScene.add(this.selectionLines);
 		this.disconnect = this.engine.updated.connect(() => this.render());
 	}
 	debugLines;
+	selectionLines;
+	syncSelectionOutline() {
+		const node = this.engine.debugSelection;
+		if (node && node.tree !== this.engine.scene?.tree) this.engine.debugSelection = null;
+		const current = this.engine.debugSelection;
+		const vertices = current ? selectionOutline2D(current) : null;
+		this.selectionLines.visible = vertices !== null;
+		if (!vertices) return;
+		const xyz = new Float32Array(vertices.length / 2 * 3);
+		for (let i = 0, j = 0; i < vertices.length; i += 2, j += 3) {
+			xyz[j] = vertices[i];
+			xyz[j + 1] = vertices[i + 1];
+			xyz[j + 2] = 0;
+		}
+		this.selectionLines.geometry.setAttribute("position", new BufferAttribute(xyz, 3));
+		this.selectionLines.geometry.getAttribute("position").needsUpdate = true;
+	}
 	syncDebugLines() {
 		let vertices = null;
 		for (const source of debugSources("2d")) {
@@ -246,6 +328,7 @@ var Renderer2D = class {
 		if (!scene) return;
 		this.webgl.info.reset();
 		this.syncDebugLines();
+		this.syncSelectionOutline();
 		if (scene.assets && !this.loadedAssetScenes.has(scene)) {
 			this.assets.load(scene.assets);
 			this.loadedAssetScenes.add(scene);