incanto 0.50.0 → 0.52.0

package/dist/2d.d.ts

@@ -1,7 +1,7 @@
-import { Et as Node, P as Scene$1, S as Scheduler, T as RendererStats, b as Engine, d as PropSchema, n as BehaviorCtor, w as GameStats } from "./behavior-62q0HWBO.js";
+import { Dt as Node, P as Scene$1, S as Scheduler, T as RendererStats, b as Engine, d as PropSchema, n as BehaviorCtor, w as GameStats } from "./behavior-uPEuZrUB.js";
 import { n as DiagnosticSink, t as EditorSwitchOptions } from "./editor-switch-DAvWQeld.js";
 import { i as SceneJson, s as JsonObject } from "./schema-CFeioQRE.js";
-import { t as LoadSceneOptions } from "./loader-CeyU_bm1.js";
+import { t as LoadSceneOptions } from "./loader-B9iTqs27.js";
 import { n as AnimationEntry } from "./sprite-animation-CMr6f1K2.js";
 import { t as ParticleSim } from "./particle-sim-BzJ1yxoE.js";
 import { Group, Mesh, Object3D, Scene, Texture } from "three";
@@ -36,6 +36,19 @@ declare class AssetStore2D {
   constructor(loader?: (url: string, callbacks?: TextureLoadCallbacks) => Texture, engine?: DiagnosticSink | null);
   /** Load (or extend with) a scene's `assets` declarations. Hard-validates each entry. */
   load(assets: Record<string, JsonObject>): void;
+  /**
+  * Every declared asset that FAILED to load, `$ref` and url included.
+  *
+  * The 3D store has answered this since 0.32.0 — the 2D one only tracked a
+  * per-key status, which the console printed and nothing else could read. A
+  * 404'd texture is invisible, and "invisible" is the one symptom an author
+  * cannot tell apart from "I put it in the wrong place".
+  */
+  errors(): Array<{
+    ref: string;
+    url: string;
+    error: string;
+  }>;
   /** Load status of a declared asset KEY (no '$'), or undefined if unknown. */
   status(key: string): AssetStatus | undefined;
   getTexture(ref: string): Texture;
@@ -206,6 +219,7 @@ declare class Physics2D {
   private readonly world;
   private readonly events;
   private readonly kcc;
+  private readonly disconnectScene;
   private readonly disconnect;
   private lastDt;
   private readonly optsGravity;
@@ -840,6 +854,8 @@ declare class Renderer2D {
   private syncSelectionOutline;
   private syncDebugLines;
   private render;
+  /** UI-pass extent from the last render — the space HUD nodes are posed in. */
+  private lastUi;
   private lastViewport;
   private lastView;
   /** The world view used by the LAST render (center/zoom/canvas size). */
@@ -862,6 +878,26 @@ declare class Renderer2D {
   * Hits resolve through `userData.incantoNode` and prefer higher renderOrder.
   */
   pick(sx: number, sy: number): Node | null;
+  private hit;
+  /** Does the UI pass draw this node (i.e. is it under a UILayer)? */
+  isUiNode(node: Node): boolean;
+  /**
+  * UI-space px → canvas px.
+  *
+  * A UILayer's children are posed in the UI pass's own space (origin top-left,
+  * `uiW × uiH`), NOT in world space — so mapping them with `screenFromWorld`
+  * puts them wherever the game camera happens to be looking.
+  */
+  screenFromUi(ux: number, uy: number): {
+    x: number;
+    y: number;
+  };
+  /** Canvas px → UI-space px (the inverse of `screenFromUi`). */
+  uiFromScreen(sx: number, sy: number): {
+    x: number;
+    y: number;
+  };
+  private uiView;
   /**
   * Canvas-pixel AABB of a node's rendered world-pass objects, or null when it
   * has no renderable extent (plain Nodes, empty containers).

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-BLDjy_PW.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-BNPZYJmd.js";
-import { n as enablePhysics2D, t as Physics2D } from "./physics-2d-_9VBOHn6.js";
+import { a as AssetStore2D, i as syncTree2D, r as Renderer2D, t as createGame2D } from "./create-game-B_e9hJf7.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-Trx7WHnD.js";
+import { n as enablePhysics2D, t as Physics2D } from "./physics-2d-Dns-oZlE.js";
 //#region src/2d/library-sprite.ts
 /**
 * What a `CharacterController2D`/`3D` will ask a skin to play, and the clip in

package/dist/3d.d.ts

@@ -1,10 +1,10 @@
-import { D as QualityCaps, Et as Node, P as Scene$1, S as Scheduler, T as RendererStats, b as Engine, d as PropSchema, n as BehaviorCtor, w as GameStats } from "./behavior-62q0HWBO.js";
+import { D as QualityCaps, Dt as Node, P as Scene$1, S as Scheduler, T as RendererStats, b as Engine, d as PropSchema, n as BehaviorCtor, w as GameStats } from "./behavior-uPEuZrUB.js";
 import { n as DiagnosticSink, t as EditorSwitchOptions } from "./editor-switch-DAvWQeld.js";
 import { i as SceneJson$1, s as JsonObject } from "./schema-CFeioQRE.js";
-import { t as LoadSceneOptions } from "./loader-CeyU_bm1.js";
+import { t as LoadSceneOptions } from "./loader-B9iTqs27.js";
 import { t as ParticleSim } from "./particle-sim-BzJ1yxoE.js";
 import { a as GridCell, c as diffText, d as frameText, i as FrameStatsOptions, l as frameSignature, n as FrameSignature, o as SIGNATURE_GRID, r as FrameStats, s as diffSignatures, t as FrameDiff, u as frameStats } from "./frame-report-DZ70IY26.js";
-import { n as PathGrid, s as SpatialPose } from "./pathfinding-C49JSNNq.js";
+import { n as PathGrid, s as SpatialPose } from "./pathfinding-CAR9DjQQ.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";
@@ -439,6 +439,7 @@ declare class Physics3D {
   private readonly world;
   private readonly events;
   private readonly kcc;
+  private readonly disconnectScene;
   private readonly disconnect;
   private lastDt;
   private readonly optsGravity;

package/dist/3d.js

@@ -1,9 +1,9 @@
-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-DbaI313d.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-XFuqu5jv.js";
-import { a as Environment3D, c as parseEnvironment3D, d as AssetStore3D, i as syncTree, l as sunDirectionFromElevationAzimuth, o as setEnvironment3D, r as Renderer3D, s as horizonColorFromSky, t as createGame3D, u as sunDirectionFromSky } from "./create-game-DqqxEax1.js";
+import { F as CharacterBody3D, H as WATER_MAX_RIPPLES, I as PhysicsBody3D, L as RigidBody3D, M as WATER_CUTOUT_MAX, N as WaterCutout3D, P as Area3D, R as StaticBody3D, j as Water3D, z as Node3D } from "./gameplay-B6jqvYeM.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-DSZwsKPs.js";
+import { a as Environment3D, c as parseEnvironment3D, d as AssetStore3D, i as syncTree, l as sunDirectionFromElevationAzimuth, o as setEnvironment3D, r as Renderer3D, s as horizonColorFromSky, t as createGame3D, u as sunDirectionFromSky } from "./create-game-CGnoypjL.js";
 import { a as frameSignature, n as diffSignatures, o as frameStats, r as diffText, s as frameText, t as SIGNATURE_GRID } from "./frame-report-njybhZon.js";
 import { n as splatWeights, t as buildHeightmap } from "./heightmap-CRK0M4jT.js";
-import { n as enablePhysics3D, t as Physics3D } from "./physics-3d-DrpF5hcG.js";
+import { n as enablePhysics3D, t as Physics3D } from "./physics-3d-BhI0ehpe.js";
 //#region src/3d/model-verdict.ts
 /** Mixamo exports every bone as `mixamorigX`; the retargeter binds by that name. */
 const MIXAMO = /^mixamorig[:_]?/i;

package/dist/{behavior-62q0HWBO.d.ts → behavior-uPEuZrUB.d.ts}

@@ -151,6 +151,14 @@ declare class SceneTree {
   _queueFree(node: Node): void;
   /** @internal Called by Node.free(): a freed root must not be re-drivable. */
   _detachRoot(node: Node): void;
+  /**
+  * @internal Is this node already on its way out?
+  *
+  * A save taken from a `collected` handler runs BEFORE the deferred free, so
+  * the pickup that triggered the checkpoint is still in the tree — and came
+  * back on the next run while its score did not.
+  */
+  _isQueuedFree(node: Node): boolean;
   private flushFreeQueue;
 }
 //#endregion
@@ -968,6 +976,18 @@ interface RestoreReport {
   skipped: string[];
   /** How many behaviors actually took their state back. */
   restored: number;
+  /**
+  * How much state this tree HAD to give back — every behavior in it with a
+  * `serialize`, addressable or not.
+  *
+  * `restored: 0` is ambiguous on its own and the ambiguity is expensive: a
+  * hand-written scene with no uids saves `{}`, and the documented check
+  * (`if (report.missing.length)`) passes on it while the whole run is gone.
+  * `restored: 0, expected: 2` cannot be read as success.
+  */
+  expected: number;
+  /** Authored nodes the save says the run consumed, and that were freed again. */
+  freed: number;
 }
 /**
 * Every behavior in the tree that has something to say, by uid.
@@ -980,9 +1000,10 @@ interface RestoreReport {
 * cannot be given back. The editor assigns a uid to every node it touches; a
 * hand-written scene may not have.
 */
-declare function captureBehaviors(root: Node): {
+declare function captureBehaviors(root: Node, source?: JsonValue): {
   state: BehaviorState; /** Paths of nodes that had state to save and no uid to save it under. */
-  unaddressable: string[];
+  unaddressable: string[]; /** Behaviors in this tree that have something to save — addressable or not. */
+  saveable: number;
 };
 /**
 * Hand each behavior its state back.
@@ -1032,6 +1053,19 @@ declare class SaveSlots {
 * and the caller decides.
 */
 declare function behaviorsWithoutSave(root: Node): string[];
+/**
+* Behaviors that DO save, on nodes with no uid to save them under — the state
+* that goes nowhere.
+*
+* `incanto-check` warns about the built-ins it can recognise from the JSON
+* (Health, ScoreKeeper, Collector), but a scene file cannot be asked whether
+* YOUR behavior has a `serialize`. This can: it walks the live tree, so a quest
+* log or a wallet of your own is named too.
+*
+* The pair to read before shipping: `behaviorsWithoutSave` is "did you forget
+* to write serialize", this is "did you forget the uid that makes it count".
+*/
+declare function savesWithoutUid(root: Node): string[];
 //#endregion
 //#region src/core/scene/scene.d.ts
 /**
@@ -1547,6 +1581,16 @@ interface PropDef {
   */
   nodePath?: boolean;
   /**
+  * The prop must be given a value — an empty string is not a configuration.
+  *
+  * `Chase.target` and `FollowCamera.target` threw for this in `onReady`, which
+  * is the browser, at the moment the level starts. Declared here it is a LOAD
+  * error instead: `incanto-check` reports it while you are still writing the
+  * scene, and the editor knows not to "unlink" a prop whose emptiness the
+  * engine refuses.
+  */
+  required?: boolean;
+  /**
   * For an OBJECT-valued prop shaped as a tagged union — `collider`, whose
   * `shape` decides which other keys are required. One declaration gives an
   * inspector both the dropdown AND something valid to write when the tag
@@ -1682,4 +1726,4 @@ declare function registeredBehaviors(): string[];
 /** Test isolation helper. */
 declare function clearBehaviors(): void;
 //#endregion
-export { suggestLocale as $, SettingsValues as A, LogLevel as At, captureBehaviors as B, EngineStats as C, PlayMusicOptions as Ct, QualityCaps as D, NodeLifecycle as Dt, DeviceHints as E, Node as Et, BehaviorState as F, OrderGroup as G, SaveStore as H, RestoreReport as I, resolveOrderGroups as J, OrderGroupTable as K, SaveSlot as L, readDeviceHints as M, Signal as Mt, suggestQuality as N, SignalListener as Nt, QualityTier as O, SceneTree as Ot, Scene as P, T_PREFIX as Q, SaveSlots as R, Scheduler as S, MusicTrack as St, RendererStats as T, BusName as Tt, createSaveStore as U, restoreBehaviors as V, ORDER_GROUP_BASE as W, LocaleTables as X, BASE_LOCALE as Y, Localization as Z, mergeStaticSignals as _, SfxWave as _t, clearBehaviors as a, Voice as at, Engine as b, MusicBackend as bt, registeredBehaviors as c, ROLLOFF_MODELS as ct, PropSchema as d, Vec3 as dt, translationKey as et, clearRegistry as f, spatialGain as ft, getNodeType as g, SfxParams as gt, getNodeSignals as h, SFX_PRESET_NAMES as ht, behaviorSignals as i, isAudioContextAvailable as it, qualityEnvironment as j, LogManager as jt, Settings as k, LogEntry as kt, NodeCtor as l, RolloffModel as lt, getNodeSchema as m, SFX_PRESETS as mt, BehaviorCtor as n, SfxEngine as nt, getBehavior as o, VoicePreset as ot, createNode as p, spatialPan as pt, effectiveOrder as q, behaviorSchema as r, SfxPlayOptions as rt, registerBehavior as s, Listener as st, Behavior as t, InputMap as tt, PropDef as u, SpatialParams as ut, registerNode as v, SynthOptions as vt, GameStats as w, AudioBuses as wt, EngineOptions as x, MusicManager as xt, registeredTypes as y, synthSfx as yt, behaviorsWithoutSave as z };
+export { T_PREFIX as $, SettingsValues as A, LogEntry as At, captureBehaviors as B, EngineStats as C, MusicTrack as Ct, QualityCaps as D, Node as Dt, DeviceHints as E, BusName as Et, BehaviorState as F, ORDER_GROUP_BASE as G, savesWithoutUid as H, RestoreReport as I, effectiveOrder as J, OrderGroup as K, SaveSlot as L, readDeviceHints as M, LogManager as Mt, suggestQuality as N, Signal as Nt, QualityTier as O, NodeLifecycle as Ot, Scene as P, SignalListener as Pt, Localization as Q, SaveSlots as R, Scheduler as S, MusicManager as St, RendererStats as T, AudioBuses as Tt, SaveStore as U, restoreBehaviors as V, createSaveStore as W, BASE_LOCALE as X, resolveOrderGroups as Y, LocaleTables as Z, mergeStaticSignals as _, SfxParams as _t, clearBehaviors as a, isAudioContextAvailable as at, Engine as b, synthSfx as bt, registeredBehaviors as c, Listener as ct, PropSchema as d, SpatialParams as dt, suggestLocale as et, clearRegistry as f, Vec3 as ft, getNodeType as g, SFX_PRESET_NAMES as gt, getNodeSignals as h, SFX_PRESETS as ht, behaviorSignals as i, SfxPlayOptions as it, qualityEnvironment as j, LogLevel as jt, Settings as k, SceneTree as kt, NodeCtor as l, ROLLOFF_MODELS as lt, getNodeSchema as m, spatialPan as mt, BehaviorCtor as n, InputMap as nt, getBehavior as o, Voice as ot, createNode as p, spatialGain as pt, OrderGroupTable as q, behaviorSchema as r, SfxEngine as rt, registerBehavior as s, VoicePreset as st, Behavior as t, translationKey as tt, PropDef as u, RolloffModel as ut, registerNode as v, SfxWave as vt, GameStats as w, PlayMusicOptions as wt, EngineOptions as x, MusicBackend as xt, registeredTypes as y, SynthOptions as yt, behaviorsWithoutSave as z };

package/dist/{create-game-BLDjy_PW.js → create-game-B_e9hJf7.js}

@@ -1,13 +1,13 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { n as loadScene, o as computeViewport, s as resolveViewport, v as diagnose, w as registerBehavior } from "./loader-DwazzlQb.js";
-import { h as Engine, m as AudioPlayer } from "./register-uvaZj1KX.js";
+import { A as registerBehavior, C as diagnose, n as loadScene, o as computeViewport, s as resolveViewport } from "./loader-B-Gft32x.js";
+import { h as Engine, m as AudioPlayer } from "./register-DVwlnZAZ.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { i as resolveRendering, n as attachTouchControls } from "./touch-BoNg_MnF.js";
-import { a as openBundledEditor, i as devServerLibrary, n as pauseWhenHidden, r as crossFade, t as teardown } from "./teardown-BKTCzLek.js";
-import { n as registerGameplayBehaviors } from "./gameplay-DbaI313d.js";
-import { g as PhysicsBody2D, n as UILayer, t as registerNodes2D, u as Camera2D, y as Node2D } from "./register-BNPZYJmd.js";
+import { a as openBundledEditor, i as devServerLibrary, n as pauseWhenHidden, r as crossFade, t as teardown } from "./teardown-ks3d5W9n.js";
+import { n as registerGameplayBehaviors } from "./gameplay-B6jqvYeM.js";
+import { g as PhysicsBody2D, n as UILayer, t as registerNodes2D, u as Camera2D, y as Node2D } from "./register-Trx7WHnD.js";
 import { t as debugSources } from "./debug-draw-BM3DsvtT.js";
-import { n as enablePhysics2D } from "./physics-2d-_9VBOHn6.js";
+import { n as enablePhysics2D } from "./physics-2d-Dns-oZlE.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
 /**
@@ -50,6 +50,7 @@ var AssetStore2D = class {
 				},
 				onError: (err) => {
 					state.status = "error";
+					state.error = err instanceof Error ? err.message : `could not load ${decl.url}`;
 					diagnose(this.engine, "error", `[incanto] failed to load texture '${key}' (${decl.url}):`, err);
 				}
 			});
@@ -66,10 +67,31 @@ var AssetStore2D = class {
 				type,
 				frameWidth,
 				frameHeight,
+				url: decl.url,
 				state
 			});
 		}
 	}
+	/**
+	* Every declared asset that FAILED to load, `$ref` and url included.
+	*
+	* The 3D store has answered this since 0.32.0 — the 2D one only tracked a
+	* per-key status, which the console printed and nothing else could read. A
+	* 404'd texture is invisible, and "invisible" is the one symptom an author
+	* cannot tell apart from "I put it in the wrong place".
+	*/
+	errors() {
+		const out = [];
+		for (const [key, entry] of this.entries) {
+			if (entry.state.status !== "error") continue;
+			out.push({
+				ref: `$${key}`,
+				url: entry.url,
+				error: entry.state.error ?? `could not load ${entry.url}`
+			});
+		}
+		return out;
+	}
 	/** Load status of a declared asset KEY (no '$'), or undefined if unknown. */
 	status(key) {
 		return this.entries.get(key)?.state.status;
@@ -107,6 +129,18 @@ function worldFromScreen(view, sx, sy) {
 		y: (sy - view.h / 2) / view.zoom + view.cy
 	};
 }
+function screenFromUi(v, ux, uy) {
+	return {
+		x: v.offsetX + ux / v.uiW * v.contentW,
+		y: v.offsetY + uy / v.uiH * v.contentH
+	};
+}
+function uiFromScreen(v, sx, sy) {
+	return {
+		x: (sx - v.offsetX) / v.contentW * v.uiW,
+		y: (sy - v.offsetY) / v.contentH * v.uiH
+	};
+}
 //#endregion
 //#region src/2d/selection-outline.ts
 /** 2D twin of the 3D selection outline: a world-space (px, y-down) rectangle
@@ -355,6 +389,10 @@ var Renderer2D = class {
 		const view = vp ? computeViewport(w, h, vp) : null;
 		const uiW = view ? view.viewW : w;
 		const uiH = view ? view.viewH : h;
+		this.lastUi = {
+			w: uiW,
+			h: uiH
+		};
 		const { activeCamera } = syncTree2D(scene.root, this.worldScene, this.uiScene, this.assets, {
 			width: uiW,
 			height: uiH
@@ -406,6 +444,11 @@ var Renderer2D = class {
 		this.webgl.render(this.uiScene, this.uiCam);
 		this.webgl.autoClear = true;
 	}
+	/** UI-pass extent from the last render — the space HUD nodes are posed in. */
+	lastUi = {
+		w: 1,
+		h: 1
+	};
 	lastViewport = null;
 	lastView = {
 		cx: 0,
@@ -448,8 +491,13 @@ var Renderer2D = class {
 		const cw = this.lastViewport?.contentW ?? w;
 		const ch = this.lastViewport?.contentH ?? h;
 		pickNdc.set((sx - ox) / cw * 2 - 1, -((sy - oy) / ch * 2 - 1));
-		raycaster.setFromCamera(pickNdc, this.worldCam);
-		const hits = raycaster.intersectObjects(this.worldScene.children, true);
+		const ui = this.hit(this.uiScene, this.uiCam);
+		if (ui) return ui;
+		return this.hit(this.worldScene, this.worldCam);
+	}
+	hit(scene, cam) {
+		raycaster.setFromCamera(pickNdc, cam);
+		const hits = raycaster.intersectObjects(scene.children, true);
 		let best = null;
 		for (const hit of hits) {
 			let obj = hit.object;
@@ -464,6 +512,39 @@ var Renderer2D = class {
 		}
 		return best?.node ?? null;
 	}
+	/** Does the UI pass draw this node (i.e. is it under a UILayer)? */
+	isUiNode(node) {
+		let obj = node._object2D ?? node._group ?? null;
+		while (obj) {
+			if (obj === this.uiScene) return true;
+			obj = obj.parent;
+		}
+		return false;
+	}
+	/**
+	* UI-space px → canvas px.
+	*
+	* A UILayer's children are posed in the UI pass's own space (origin top-left,
+	* `uiW × uiH`), NOT in world space — so mapping them with `screenFromWorld`
+	* puts them wherever the game camera happens to be looking.
+	*/
+	screenFromUi(ux, uy) {
+		return screenFromUi(this.uiView(), ux, uy);
+	}
+	/** Canvas px → UI-space px (the inverse of `screenFromUi`). */
+	uiFromScreen(sx, sy) {
+		return uiFromScreen(this.uiView(), sx, sy);
+	}
+	uiView() {
+		return {
+			offsetX: this.lastViewport?.offsetX ?? 0,
+			offsetY: this.lastViewport?.offsetY ?? 0,
+			contentW: this.lastViewport?.contentW ?? this.lastView.w,
+			contentH: this.lastViewport?.contentH ?? this.lastView.h,
+			uiW: this.lastUi.w,
+			uiH: this.lastUi.h
+		};
+	}
 	/**
 	* Canvas-pixel AABB of a node's rendered world-pass objects, or null when it
 	* has no renderable extent (plain Nodes, empty containers).
@@ -476,8 +557,9 @@ var Renderer2D = class {
 		if (boundsScratch.isEmpty()) return null;
 		boundsScratch.getSize(sizeScratch3);
 		if (sizeScratch3.x === 0 && sizeScratch3.y === 0) return null;
-		const a = this.screenFromWorld(boundsScratch.min.x, -boundsScratch.max.y);
-		const b = this.screenFromWorld(boundsScratch.max.x, -boundsScratch.min.y);
+		const map = this.isUiNode(node) ? (x, y) => this.screenFromUi(x, y) : (x, y) => this.screenFromWorld(x, y);
+		const a = map(boundsScratch.min.x, -boundsScratch.max.y);
+		const b = map(boundsScratch.max.x, -boundsScratch.min.y);
 		return {
 			x: a.x,
 			y: a.y,

package/dist/{create-game-DqqxEax1.js → create-game-CGnoypjL.js}

@@ -1,15 +1,15 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { n as loadScene, v as diagnose, w as registerBehavior } from "./loader-DwazzlQb.js";
-import { _ as qualityCaps, h as Engine, m as AudioPlayer, y as qualityRendering } from "./register-uvaZj1KX.js";
+import { A as registerBehavior, C as diagnose, n as loadScene } from "./loader-B-Gft32x.js";
+import { _ as qualityCaps, h as Engine, m as AudioPlayer, y as qualityRendering } from "./register-DVwlnZAZ.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { r as parseDrive, t as logReport } from "./log-report-lxrQY9cH.js";
 import { i as resolveRendering, n as attachTouchControls } from "./touch-BoNg_MnF.js";
-import { a as openBundledEditor, i as devServerLibrary, n as pauseWhenHidden, o as poseFromRenderer, r as crossFade, t as teardown } from "./teardown-BKTCzLek.js";
-import { B as createCausticsQuad, F as PhysicsBody3D, R as Node3D, n as registerGameplayBehaviors } from "./gameplay-DbaI313d.js";
+import { a as openBundledEditor, i as devServerLibrary, n as pauseWhenHidden, o as poseFromRenderer, r as crossFade, t as teardown } from "./teardown-ks3d5W9n.js";
+import { I as PhysicsBody3D, V as createCausticsQuad, n as registerGameplayBehaviors, z as Node3D } from "./gameplay-B6jqvYeM.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-XFuqu5jv.js";
+import { E as Camera3D, U as TextureCache3D, g as ModelInstance3D, n as registerNodes3D, t as resolveEnvironmentHdri, v as DirectionalLight3D } from "./environment-presets-DSZwsKPs.js";
 import { a as frameSignature, i as frameImage, o as frameStats } from "./frame-report-njybhZon.js";
-import { n as enablePhysics3D } from "./physics-3d-DrpF5hcG.js";
+import { n as enablePhysics3D } from "./physics-3d-BhI0ehpe.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/debug.d.ts

@@ -1,4 +1,4 @@
-import { At as LogLevel, T as RendererStats, b as Engine } from "./behavior-62q0HWBO.js";
+import { T as RendererStats, b as Engine, jt as LogLevel } from "./behavior-uPEuZrUB.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-IyWCGe4q.js";
+import { s as mergeStaticProps } from "./registry-C7u42TID.js";
 import { t as debugSources } from "./debug-draw-BM3DsvtT.js";
 //#region src/debug/capture.ts
 /**

package/dist/{duplicate-CI9WF_bg.js → duplicate-B-OtSRFL.js}

@@ -1,4 +1,4 @@
-import { i as serializeNode, t as buildNodeJson } from "./loader-DwazzlQb.js";
+import { i as serializeNode, t as buildNodeJson } from "./loader-B-Gft32x.js";
 //#region src/core/scene/duplicate.ts
 function stripUids(json) {
 	const { uid: _uid, ...rest } = json;