incanto 0.52.0 → 0.53.0

package/dist/index.d.ts

@@ -1,10 +1,10 @@
-import { $ as T_PREFIX, A as SettingsValues, At as LogEntry, B as captureBehaviors, C as EngineStats, Ct as MusicTrack, Dt as Node, E as DeviceHints, Et as BusName, F as BehaviorState, G as ORDER_GROUP_BASE, H as savesWithoutUid, I as RestoreReport, J as effectiveOrder, K as OrderGroup, L as SaveSlot, M as readDeviceHints, Mt as LogManager, N as suggestQuality, Nt as Signal, O as QualityTier, Ot as NodeLifecycle, P as Scene, Pt as SignalListener, Q as Localization, R as SaveSlots, S as Scheduler, St as MusicManager, T as RendererStats, Tt as AudioBuses, U as SaveStore, V as restoreBehaviors, W as createSaveStore, X as BASE_LOCALE, Y as resolveOrderGroups, Z as LocaleTables, _ as mergeStaticSignals, _t as SfxParams, a as clearBehaviors, at as isAudioContextAvailable, b as Engine, bt as synthSfx, c as registeredBehaviors, ct as Listener, d as PropSchema, dt as SpatialParams, et as suggestLocale, f as clearRegistry, ft as Vec3, g as getNodeType, gt as SFX_PRESET_NAMES, h as getNodeSignals, ht as SFX_PRESETS, i as behaviorSignals, it as SfxPlayOptions, j as qualityEnvironment, jt as LogLevel, k as Settings, kt as SceneTree, l as NodeCtor, lt as ROLLOFF_MODELS, m as getNodeSchema, mt as spatialPan, n as BehaviorCtor, nt as InputMap, o as getBehavior, ot as Voice, p as createNode, pt as spatialGain, q as OrderGroupTable, r as behaviorSchema, rt as SfxEngine, s as registerBehavior, st as VoicePreset, t as Behavior, tt as translationKey, u as PropDef, ut as RolloffModel, v as registerNode, vt as SfxWave, w as GameStats, wt as PlayMusicOptions, x as EngineOptions, xt as MusicBackend, y as registeredTypes, yt as SynthOptions, z as behaviorsWithoutSave } from "./behavior-uPEuZrUB.js";
+import { $ as T_PREFIX, A as SettingsValues, At as LogEntry, B as captureBehaviors, C as EngineStats, Ct as MusicTrack, Dt as Node, E as DeviceHints, Et as BusName, F as BehaviorState, G as ORDER_GROUP_BASE, H as savesWithoutUid, I as RestoreReport, J as effectiveOrder, K as OrderGroup, L as SaveSlot, M as readDeviceHints, Mt as LogManager, N as suggestQuality, Nt as Signal, O as QualityTier, Ot as NodeLifecycle, P as Scene, Pt as SignalListener, Q as Localization, R as SaveSlots, S as Scheduler, St as MusicManager, T as RendererStats, Tt as AudioBuses, U as SaveStore, V as restoreBehaviors, W as createSaveStore, X as BASE_LOCALE, Y as resolveOrderGroups, Z as LocaleTables, _ as mergeStaticSignals, _t as SfxParams, a as clearBehaviors, at as isAudioContextAvailable, b as Engine, bt as synthSfx, c as registeredBehaviors, ct as Listener, d as PropSchema, dt as SpatialParams, et as suggestLocale, f as clearRegistry, ft as Vec3, g as getNodeType, gt as SFX_PRESET_NAMES, h as getNodeSignals, ht as SFX_PRESETS, i as behaviorSignals, it as SfxPlayOptions, j as qualityEnvironment, jt as LogLevel, k as Settings, kt as SceneTree, l as NodeCtor, lt as ROLLOFF_MODELS, m as getNodeSchema, mt as spatialPan, n as BehaviorCtor, nt as InputMap, o as getBehavior, ot as Voice, p as createNode, pt as spatialGain, q as OrderGroupTable, r as behaviorSchema, rt as SfxEngine, s as registerBehavior, st as VoicePreset, t as Behavior, tt as translationKey, u as PropDef, ut as RolloffModel, v as registerNode, vt as SfxWave, w as GameStats, wt as PlayMusicOptions, x as EngineOptions, xt as MusicBackend, y as registeredTypes, yt as SynthOptions, z as behaviorsWithoutSave } from "./behavior-Do0Da56m.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-B9iTqs27.js";
+import { n as loadScene, t as LoadSceneOptions } from "./loader-Cu_7kJDy.js";
 import { i as resolveFrames, n as AnimationEntry, r as resolveAnimation, t as AnimationDef } from "./sprite-animation-CMr6f1K2.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-CAR9DjQQ.js";
-import { a as startRecording, c as IncantoErrorDetails, i as replay, l as auditScene, n as ReplayEvent, o as IncantoError, r as ReplayJson, s as IncantoErrorCode, t as Recorder } from "./replay-BU1CCM15.js";
+import { a as AudioElementLike, i as gridFromRows, n as PathGrid, o as AudioPlayer, r as findPath, t as FindPathOptions } from "./pathfinding-HNGFqGUZ.js";
+import { a as startRecording, c as IncantoErrorDetails, i as replay, l as auditScene, n as ReplayEvent, o as IncantoError, r as ReplayJson, s as IncantoErrorCode, t as Recorder } from "./replay-9Fy6C10F.js";
 
 //#region src/core/audio/crossfade.d.ts
 /**
@@ -38,6 +38,7 @@ declare class WebAudioMusicBackend implements MusicBackend {
   private ensure;
   createTrack(src: string): MusicTrack;
   unlock(): void;
+  dispose(): void;
 }
 //#endregion
 //#region src/core/debug-draw.d.ts
@@ -697,6 +698,177 @@ declare class UiSelect extends HudWidgetBase {
   private fillOptions;
   protected override _sync(): void;
 }
+/**
+* The language picker, done — because every game needs the same one.
+*
+* A plain `UiSelect` bound to the locale would take a behavior, a signal
+* connection, and the knowledge that `Settings` persists it: three things an
+* agent has to get right to ship a feature the engine already has. This is one
+* node.
+*
+* ```json
+* { "name": "Language", "type": "UiLanguageSelect",
+*   "props": { "label": "@t:settings.language" } }
+* ```
+*
+* Options are the locales the SCENE declares, so a game shipping only English
+* shows only English and the widget quietly costs nothing. Each is labeled with
+* its own endonym, because a player who cannot read the language currently on
+* screen still has to be able to find theirs.
+*/
+declare class UiLanguageSelect extends UiSelect {
+  static override readonly typeName: string;
+  static override readonly props: PropSchema;
+  override label: string;
+  /** Last locale we PUSHED into `value`, to tell an engine change from a player one. */
+  private lastLocale;
+  protected override _sync(): void;
+  protected override _optionLabel(value: string): string;
+}
+/**
+* A select bound to one persisted setting — the shape all three graphics
+* controls share.
+*
+* The engine owns quality tiers, the frame cap and the resolution scale, and
+* every one of them was reachable only from TypeScript. A vibe-coded game whose
+* whole world is JSON could not put a graphics menu on screen without a
+* behavior, a signal connection, and the knowledge that `Settings` persists —
+* which is how "supports low-end devices" quietly becomes "does not".
+*
+* Subclasses say which setting, what the options are, and what they read as.
+*/
+declare abstract class UiSettingSelect extends UiSelect {
+  /** Last value we PUSHED into the select, to tell an engine change from a player one. */
+  private lastPushed;
+  /** The settings key this control owns. */
+  protected abstract _key(): string;
+  /** The stored value, as the string the select carries. */
+  protected abstract _read(engine: NonNullable<ReturnType<UiSettingSelect["_engine"]>>): string;
+  /** Apply a player's pick. */
+  protected abstract _write(engine: NonNullable<ReturnType<UiSettingSelect["_engine"]>>, value: string): void;
+  protected _engine(): Engine | null;
+  /**
+  * The translated option label, or the English one.
+  *
+  * `locale.t` returns the KEY when nothing declares it, and a menu reading
+  * `settings.quality.high` is worse than one reading `High`. English is the
+  * base language and the fallback, always.
+  */
+  protected _tOr(key: string, fallback: string): string;
+  protected override _sync(): void;
+}
+/**
+* The graphics quality picker.
+*
+* ```json
+* { "name": "Quality", "type": "UiQualitySelect" }
+* ```
+*
+* Writes through `chooseQuality`, NOT `set('quality')`: a tier a person picked
+* has to survive the next launch's device detection, and the two are
+* indistinguishable afterwards unless the choice is recorded as one.
+*
+* Shadows, bloom, post and clouds follow immediately. Antialiasing follows on
+* the next launch — it is a WebGL context attribute and cannot change while a
+* context exists.
+*/
+declare class UiQualitySelect extends UiSettingSelect {
+  static override readonly typeName: string;
+  static override readonly props: PropSchema;
+  override label: string;
+  override options: string;
+  protected override _key(): string;
+  protected override _read(engine: Engine): string;
+  protected override _write(engine: Engine, value: string): void;
+  protected override _optionLabel(value: string): string;
+}
+/**
+* The frame-rate cap: fewer frames, a cooler phone, a longer battery.
+*
+* ```json
+* { "name": "FrameCap", "type": "UiFrameCapSelect" }
+* ```
+*
+* `0` is uncapped and is the default — a cap nobody asked for is a downgrade.
+* The cap gates the whole frame, so it saves the CPU as well as the GPU.
+*/
+declare class UiFrameCapSelect extends UiSettingSelect {
+  static override readonly typeName: string;
+  static override readonly props: PropSchema;
+  override label: string;
+  override options: string;
+  protected override _key(): string;
+  protected override _read(engine: Engine): string;
+  protected override _write(engine: Engine, value: string): void;
+  protected override _optionLabel(value: string): string;
+}
+/**
+* The resolution scale — the cheapest frames on a weak GPU.
+*
+* ```json
+* { "name": "Resolution", "type": "UiRenderScaleSelect" }
+* ```
+*
+* At 75% the fragment shaders run over 56% of the pixels for a slightly softer
+* image and nothing else, where dropping a quality tier costs the shadows
+* outright. Reads as a percentage, because `0.75` means nothing to a player.
+*/
+declare class UiRenderScaleSelect extends UiSettingSelect {
+  static override readonly typeName: string;
+  static override readonly props: PropSchema;
+  override label: string;
+  override options: string;
+  protected override _key(): string;
+  protected override _read(engine: Engine): string;
+  protected override _write(engine: Engine, value: string): void;
+  protected override _optionLabel(value: string): string;
+}
+/** The three buses a player is ever offered a slider for. */
+declare const VOLUME_BUSES: readonly ["master", "sfx", "music"];
+type VolumeBus = (typeof VOLUME_BUSES)[number];
+/**
+* The volume slider — the settings row every game has.
+*
+* ```json
+* { "name": "Music", "type": "UiVolumeSlider", "props": { "bus": "music" } }
+* ```
+*
+* The graphics controls above became nodes because a game whose whole world is
+* JSON could not put a menu on screen without a behavior, a signal connection
+* and the knowledge that `Settings` persists. All of that was just as true of
+* volume, which is the control a player looks for FIRST and the only one some
+* games need at all — so an audio menu meant hand-rolled DOM, and hand-rolled
+* DOM is out of scene JSON, out of the editor, and out of every headless check.
+*
+* It writes the bus; the bus persists itself (`bindAudio`, which
+* `createGame2D/3D` wire), so there is nothing to save.
+*/
+declare class UiVolumeSlider extends UiSlider {
+  static override readonly typeName: string;
+  static override readonly props: PropSchema;
+  bus: VolumeBus;
+  /** Last value we PUSHED in, to tell an engine-side change from a player drag. */
+  private lastPushed;
+  protected override _build(): HTMLElement;
+  protected override _sync(): void;
+}
+/**
+* The mute switch.
+*
+* ```json
+* { "name": "Mute", "type": "UiMuteToggle" }
+* ```
+*
+* Checked means silent. Like the slider it writes `engine.audio`, which
+* persists itself.
+*/
+declare class UiMuteToggle extends UiToggle {
+  static override readonly typeName: string;
+  static override readonly props: PropSchema;
+  private lastPushed;
+  protected override _build(): HTMLElement;
+  protected override _sync(): void;
+}
 //#endregion
 //#region src/core/noise.d.ts
 /**
@@ -917,4 +1089,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 { type AnimationDef, type AnimationEntry, type AssetFailure, 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, type DriveScript, type DriveStep, Engine, type EngineOptions, type EngineStats, type FindPathOptions, type GameStats, type GroupedLog, type HudAnchor, HudLayer, IncantoError, type IncantoErrorCode, type IncantoErrorDetails, InputMap, type JsonKind, type JsonObject, type JsonValue, type Listener, type LiveInput, type LiveReport, 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 RefNode, type RefProblem, type RefResult, 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, describeRefProblem, duplicateNode, effectiveOrder, fadeGain, findPath, getBehavior, getNodeSchema, getNodeSignals, getNodeType, gridFromRows, isAudioContextAvailable, isConstRef, joystickVector, jsonClone, jsonEquals, jsonKind, loadScene, logReport, logText, mergeStaticSignals, newUid, nodeRefWarnings, parseDrive, parseNodePath, preloadUrls, qualityEnvironment, readDeviceHints, registerBehavior, registerCoreNodes, registerNode, registeredBehaviors, registeredTypes, replay, resolveAnimation, resolveConstants, resolveFrames, resolveOrderGroups, resolveRefInJson, resolveRendering, resolveViewport, restoreBehaviors, savesWithoutUid, serializeNode, spatialGain, spatialPan, startRecording, suggestLocale, suggestQuality, synthSfx, translationKey };
+export { type AnimationDef, type AnimationEntry, type AssetFailure, 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, type DriveScript, type DriveStep, Engine, type EngineOptions, type EngineStats, type FindPathOptions, type GameStats, type GroupedLog, type HudAnchor, HudLayer, IncantoError, type IncantoErrorCode, type IncantoErrorDetails, InputMap, type JsonKind, type JsonObject, type JsonValue, type Listener, type LiveInput, type LiveReport, 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 RefNode, type RefProblem, type RefResult, 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, UiFrameCapSelect, UiImage, UiLanguageSelect, UiMuteToggle, UiPanel, UiQualitySelect, UiRenderScaleSelect, UiSelect, UiSlider, UiText, UiToggle, UiVolumeSlider, 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, describeRefProblem, duplicateNode, effectiveOrder, fadeGain, findPath, getBehavior, getNodeSchema, getNodeSignals, getNodeType, gridFromRows, isAudioContextAvailable, isConstRef, joystickVector, jsonClone, jsonEquals, jsonKind, loadScene, logReport, logText, mergeStaticSignals, newUid, nodeRefWarnings, parseDrive, parseNodePath, preloadUrls, qualityEnvironment, readDeviceHints, registerBehavior, registerCoreNodes, registerNode, registeredBehaviors, registeredTypes, replay, resolveAnimation, resolveConstants, resolveFrames, resolveOrderGroups, resolveRefInJson, resolveRendering, resolveViewport, restoreBehaviors, savesWithoutUid, serializeNode, spatialGain, spatialPan, startRecording, suggestLocale, suggestQuality, synthSfx, translationKey };

package/dist/index.js

@@ -1,14 +1,14 @@
-import { A as registerBehavior, D as behaviorSignals, E as behaviorSchema, M as Signal, O as clearBehaviors, S as InputMap, T as Behavior, _ as savesWithoutUid, a as SCENE_FORMAT, b as effectiveOrder, c as SceneTree, d as resolveConstants, f as Node, g as restoreBehaviors, h as captureBehaviors, i as serializeNode, j as registeredBehaviors, k as getBehavior, l as CONST_REF_KEY, m as behaviorsWithoutSave, n as loadScene, o as computeViewport, p as SaveSlots, r as Scene, s as resolveViewport, u as isConstRef, v as createSaveStore, w as parseNodePath, x as resolveOrderGroups, y as ORDER_GROUP_BASE } from "./loader-B-Gft32x.js";
-import { A as ROLLOFF_MODELS, B as AudioBuses, C as BASE_LOCALE, D as translationKey, E as suggestLocale, F as synthSfx, I as MusicManager, L as WebAudioMusicBackend, M as spatialPan, N as SFX_PRESETS, O as SfxEngine, P as SFX_PRESET_NAMES, R as crossfadeGains, S as LogManager, T as T_PREFIX, a as UiSlider, b as readDeviceHints, c as UiButton, d as UiBanner, f as UiBar, g as Settings, h as Engine, i as UiSelect, j as spatialGain, k as isAudioContextAvailable, 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 qualityEnvironment, w as Localization, x as suggestQuality, z as fadeGain } from "./register-DVwlnZAZ.js";
+import { A as registerBehavior, D as behaviorSignals, E as behaviorSchema, M as Signal, O as clearBehaviors, S as InputMap, T as Behavior, _ as savesWithoutUid, a as SCENE_FORMAT, b as effectiveOrder, c as SceneTree, d as resolveConstants, f as Node, g as restoreBehaviors, h as captureBehaviors, i as serializeNode, j as registeredBehaviors, k as getBehavior, l as CONST_REF_KEY, m as behaviorsWithoutSave, n as loadScene, o as computeViewport, p as SaveSlots, r as Scene, s as resolveViewport, u as isConstRef, v as createSaveStore, w as parseNodePath, x as resolveOrderGroups, y as ORDER_GROUP_BASE } from "./loader-BTkHYrQn.js";
+import { A as Localization, B as SFX_PRESET_NAMES, D as suggestQuality, E as readDeviceHints, F as isAudioContextAvailable, G as fadeGain, H as MusicManager, I as ROLLOFF_MODELS, K as AudioBuses, L as spatialGain, M as suggestLocale, N as translationKey, O as LogManager, P as SfxEngine, R as spatialPan, S as Settings, U as WebAudioMusicBackend, V as synthSfx, W as crossfadeGains, _ as UiBanner, a as UiMuteToggle, b as AudioPlayer, c as UiRenderScaleSelect, d as UiToggle, f as UiVolumeSlider, g as HudLayer, h as UiDialogue, i as UiLanguageSelect, j as T_PREFIX, k as BASE_LOCALE, l as UiSelect, m as UiButton, n as UiFrameCapSelect, o as UiPanel, p as Timer, r as UiImage, s as UiQualitySelect, t as registerCoreNodes, u as UiSlider, v as UiBar, w as qualityEnvironment, x as Engine, y as UiText, z as SFX_PRESETS } from "./register-BTomIiYG.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as Rng } from "./rng-DP-SR7eg.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-C7u42TID.js";
-import { a as nodeRefWarnings, i as describeRefProblem, n as startRecording, o as resolveRefInJson, r as auditScene, t as replay } from "./replay-BicPOMX0.js";
-import { n as logText, r as parseDrive, t as logReport } from "./log-report-lxrQY9cH.js";
+import { a as nodeRefWarnings, i as describeRefProblem, n as startRecording, o as resolveRefInJson, r as auditScene, t as replay } from "./replay-DYNUL4BU.js";
+import { n as logText, r as parseDrive, t as logReport } from "./log-report-CPFm4OXf.js";
 import { t as createNoise2D } from "./noise-CGUMx44x.js";
 import { a as PARTICLE_PRESETS, i as ParticleSim, n as resolveFrames, o as PARTICLE_PRESET_NAMES, s as applyParticlePreset, t as resolveAnimation } from "./sprite-animation-D_p28jwU.js";
-import { a as findPath, i as preloadUrls, n as newUid, o as gridFromRows, r as assetUrls, t as VERSION } from "./src-5gbZO47I.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-B-OtSRFL.js";
-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, describeRefProblem, duplicateNode, effectiveOrder, fadeGain, findPath, getBehavior, getNodeSchema, getNodeSignals, getNodeType, gridFromRows, isAudioContextAvailable, isConstRef, joystickVector, jsonClone, jsonEquals, jsonKind, loadScene, logReport, logText, mergeStaticSignals, newUid, nodeRefWarnings, parseDrive, parseNodePath, preloadUrls, qualityEnvironment, readDeviceHints, registerBehavior, registerCoreNodes, registerNode, registeredBehaviors, registeredTypes, replay, resolveAnimation, resolveConstants, resolveFrames, resolveOrderGroups, resolveRefInJson, resolveRendering, resolveViewport, restoreBehaviors, savesWithoutUid, serializeNode, spatialGain, spatialPan, startRecording, suggestLocale, suggestQuality, synthSfx, translationKey };
+import { a as findPath, i as preloadUrls, n as newUid, o as gridFromRows, r as assetUrls, t as VERSION } from "./src-C9xyZW7M.js";
+import { i as resolveRendering, n as attachTouchControls, r as joystickVector, t as TouchControls } from "./touch-BnMyy9tr.js";
+import { t as duplicateNode } from "./duplicate-MNLMAcbz.js";
+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, UiFrameCapSelect, UiImage, UiLanguageSelect, UiMuteToggle, UiPanel, UiQualitySelect, UiRenderScaleSelect, UiSelect, UiSlider, UiText, UiToggle, UiVolumeSlider, VERSION, WebAudioMusicBackend, applyParticlePreset, assetUrls, attachTouchControls, auditScene, behaviorSchema, behaviorSignals, behaviorsWithoutSave, captureBehaviors, clearBehaviors, clearRegistry, computeViewport, createNode, createNoise2D, createSaveStore, crossfadeGains, describeRefProblem, duplicateNode, effectiveOrder, fadeGain, findPath, getBehavior, getNodeSchema, getNodeSignals, getNodeType, gridFromRows, isAudioContextAvailable, isConstRef, joystickVector, jsonClone, jsonEquals, jsonKind, loadScene, logReport, logText, mergeStaticSignals, newUid, nodeRefWarnings, parseDrive, parseNodePath, preloadUrls, qualityEnvironment, readDeviceHints, registerBehavior, registerCoreNodes, registerNode, registeredBehaviors, registeredTypes, replay, resolveAnimation, resolveConstants, resolveFrames, resolveOrderGroups, resolveRefInJson, resolveRendering, resolveViewport, restoreBehaviors, savesWithoutUid, serializeNode, spatialGain, spatialPan, startRecording, suggestLocale, suggestQuality, synthSfx, translationKey };

package/dist/{loader-B-Gft32x.js → loader-BTkHYrQn.js}

@@ -221,12 +221,9 @@ var InputMap = class {
 			};
 			return;
 		}
-		const el = target;
-		const scaleX = typeof el.width === "number" && el.width > 0 ? el.width / rect.width : 1;
-		const scaleY = typeof el.height === "number" && el.height > 0 ? el.height / rect.height : 1;
 		this.pointerPos = {
-			x: (clientX - rect.left) * scaleX,
-			y: (clientY - rect.top) * scaleY
+			x: clientX - rect.left,
+			y: clientY - rect.top
 		};
 	}
 	pointerPos = null;
@@ -418,36 +415,69 @@ var InputMap = class {
 		};
 		return disconnect;
 	}
+	/**
+	* Pointer input from a mouse, a FINGER or a pen — one code path.
+	*
+	* This used to bind `mousedown`/`mousemove`/`mouseup`, which on a phone only
+	* arrive as COMPATIBILITY events: delayed until the browser has decided the
+	* touch is not a scroll, never fired for drags or multi-touch, and suppressed
+	* outright once the surface claims its gestures with `touch-action: none`.
+	* So every genre the comment below lists — match-3, tower defense, card,
+	* point-and-click, RTS — was mouse-only on the device most of them are played
+	* on. Pointer events cover all three input kinds and fire immediately.
+	*
+	* Only the PRIMARY pointer drives it: a second finger (the one on the virtual
+	* stick) must not also swing the camera.
+	*/
 	attachPointer(target, opts) {
 		let buttonsHeld = 0;
+		/** The pointer that pressed on THIS target; others are somebody else's. */
+		let activeId = null;
 		const onDown = (e) => {
+			if (!e.isPrimary) return;
+			activeId = e.pointerId;
 			buttonsHeld++;
 			this.setPointerPosition(e.clientX, e.clientY, target);
 			this.handleMouseButton(e.button, true);
 			if (opts?.lockOnClick && document.pointerLockElement !== target) target.requestPointerLock?.();
 		};
 		const onUp = (e) => {
+			if (activeId !== null && e.pointerId !== activeId) return;
+			activeId = null;
 			buttonsHeld = Math.max(0, buttonsHeld - 1);
 			this.handleMouseButton(e.button, false);
 		};
 		const onMove = (e) => {
+			if (activeId !== null && e.pointerId !== activeId) return;
 			this.setPointerPosition(e.clientX, e.clientY, target);
-			if (document.pointerLockElement === target || buttonsHeld > 0) this.handlePointerMove(e.movementX, e.movementY);
+			if (document.pointerLockElement === target || buttonsHeld > 0) {
+				const dx = e.movementX || this.pointerDelta().x;
+				const dy = e.movementY || this.pointerDelta().y;
+				this.handlePointerMove(dx, dy);
+			}
+		};
+		const onCancel = (e) => {
+			if (activeId !== null && e.pointerId !== activeId) return;
+			activeId = null;
+			buttonsHeld = 0;
+			this.handleMouseButton(0, false);
 		};
 		const onWheel = (e) => {
 			e.preventDefault();
 			this.handleWheel(e.deltaY);
 		};
 		const onContext = (e) => e.preventDefault();
-		target.addEventListener("mousedown", onDown);
-		window.addEventListener("mouseup", onUp);
-		window.addEventListener("mousemove", onMove);
+		target.addEventListener("pointerdown", onDown);
+		window.addEventListener("pointerup", onUp);
+		window.addEventListener("pointermove", onMove);
+		window.addEventListener("pointercancel", onCancel);
 		target.addEventListener("wheel", onWheel, { passive: false });
 		target.addEventListener("contextmenu", onContext);
 		const detach = () => {
-			target.removeEventListener("mousedown", onDown);
-			window.removeEventListener("mouseup", onUp);
-			window.removeEventListener("mousemove", onMove);
+			target.removeEventListener("pointerdown", onDown);
+			window.removeEventListener("pointerup", onUp);
+			window.removeEventListener("pointermove", onMove);
+			window.removeEventListener("pointercancel", onCancel);
 			target.removeEventListener("wheel", onWheel);
 			target.removeEventListener("contextmenu", onContext);
 		};
@@ -604,6 +634,12 @@ var InputMap = class {
 * never looked at `input` at all. A typo there ("keys": "KeyW" instead of
 * ["KeyW"]) passed the check and threw in the browser at boot.
 */
+const DIRECTIONS = [
+	"up",
+	"down",
+	"left",
+	"right"
+];
 function parseInputDecls(decls) {
 	const out = /* @__PURE__ */ new Map();
 	for (const [name, raw] of Object.entries(decls)) {
@@ -619,12 +655,12 @@ function parseInputDecls(decls) {
 			});
 		} else if (decl.type === "vector2") {
 			const dirs = decl.keys;
-			for (const dir of [
-				"up",
-				"down",
-				"left",
-				"right"
-			]) if (!Array.isArray(dirs?.[dir])) throw new IncantoError("BAD_FORMAT", `Input action '${name}': vector2 "keys" needs arrays for up/down/left/right.`);
+			const missing = DIRECTIONS.filter((dir) => !Array.isArray(dirs?.[dir]));
+			if (missing.length > 0) {
+				const atTopLevel = DIRECTIONS.filter((dir) => Array.isArray(decl[dir]));
+				const where = atTopLevel.length > 0 ? ` — ${atTopLevel.join(", ")} ${atTopLevel.length === 1 ? "is" : "are"} at the top level, not under "keys"` : "";
+				throw new IncantoError("BAD_FORMAT", `Input action '${name}': a vector2 needs ${missing.join(", ")} as arrays of KeyboardEvent.code strings under "keys"${where}. Like this: { "type": "vector2", "keys": { "up": ["KeyW"], "down": ["KeyS"], "left": ["KeyA"], "right": ["KeyD"] } }`);
+			}
 			if (decl.touch !== void 0 && decl.touch !== "joystick") throw new IncantoError("BAD_FORMAT", `Input action '${name}': vector2 "touch" must be 'joystick', got ${JSON.stringify(decl.touch)}.`);
 			const d = dirs;
 			out.set(name, {

package/dist/{loader-B9iTqs27.d.ts → loader-Cu_7kJDy.d.ts}

@@ -1,4 +1,4 @@
-import { P as Scene, b as Engine } from "./behavior-uPEuZrUB.js";
+import { P as Scene, b as Engine } from "./behavior-Do0Da56m.js";
 import { i as SceneJson } from "./schema-CFeioQRE.js";
 
 //#region src/core/scene/loader.d.ts

package/dist/net.d.ts

@@ -1,5 +1,5 @@
-import { Dt as Node, d as PropSchema } from "./behavior-uPEuZrUB.js";
-import { a as NetworkManagerOptions, c as LocalGameServer, d as ServerClass, f as createLocalGameServer, g as Unsubscribe, h as NetworkTransport, i as NetworkManager, l as LocalGameServerOptions, m as LoopbackTransport, n as SplitScreenPlayer, o as applySyncPatch, p as LoopbackHub, r as createSplitScreen, s as CollectionOptions, t as SplitScreenOptions, u as LocalGameServerTransport } from "./split-screen-paxkQs_q.js";
+import { Dt as Node, d as PropSchema } from "./behavior-Do0Da56m.js";
+import { a as NetworkManagerOptions, c as LocalGameServer, d as ServerClass, f as createLocalGameServer, g as Unsubscribe, h as NetworkTransport, i as NetworkManager, l as LocalGameServerOptions, m as LoopbackTransport, n as SplitScreenPlayer, o as applySyncPatch, p as LoopbackHub, r as createSplitScreen, s as CollectionOptions, t as SplitScreenOptions, u as LocalGameServerTransport } from "./split-screen-DNmcX1Pz.js";
 
 //#region src/net/agent8.d.ts
 /**

package/dist/net.js

@@ -1,3 +1,3 @@
 import { n as createAgent8Server } from "./agent8-CvsfVskX.js";
-import { a as applySyncPatch, c as createLocalGameServer, i as NetworkManager, l as LoopbackHub, n as registerNodesNet, o as LocalGameServer, r as NetworkSpawner, s as LocalGameServerTransport, t as createSplitScreen, u as LoopbackTransport } from "./split-screen-CZ9ccBBQ.js";
+import { a as applySyncPatch, c as createLocalGameServer, i as NetworkManager, l as LoopbackHub, n as registerNodesNet, o as LocalGameServer, r as NetworkSpawner, s as LocalGameServerTransport, t as createSplitScreen, u as LoopbackTransport } from "./split-screen-CaF9hO7g.js";
 export { LocalGameServer, LocalGameServerTransport, LoopbackHub, LoopbackTransport, NetworkManager, NetworkSpawner, applySyncPatch, createAgent8Server, createLocalGameServer, createSplitScreen, registerNodesNet };

package/dist/{pathfinding-CAR9DjQQ.d.ts → pathfinding-HNGFqGUZ.d.ts}

@@ -1,4 +1,4 @@
-import { Dt as Node, ct as Listener, d as PropSchema } from "./behavior-uPEuZrUB.js";
+import { Dt as Node, ct as Listener, d as PropSchema } from "./behavior-Do0Da56m.js";
 
 //#region src/core/nodes/audio-player.d.ts
 /**
@@ -74,6 +74,11 @@ declare class AudioPlayer extends Node {
   static validateJson(node: Node): void;
   /** A play() was blocked by the browser's autoplay policy. */
   pendingGesture: boolean;
+  /**
+  * Why this player is silent, when the reason is the FILE rather than the
+  * autoplay gate. Read by `game.assetErrors()`.
+  */
+  loadError: string | null;
   private element;
   private _playing;
   private autoplayed;
@@ -86,6 +91,14 @@ declare class AudioPlayer extends Node {
   * unless `spatial` is on. Headless / 2D scenes never call this.
   */
   _setSpatialPose(pose: SpatialPose): void;
+  /**
+  * Write this sound into the engine's audio record.
+  *
+  * The CALL happens even where the backend does not (headless, the verify VM),
+  * which is exactly why the record is worth keeping: it answers "did the coin
+  * sound fire when the coin was collected" in places no sound can be heard.
+  */
+  private note;
   /** Final gain = engine buses × this volume (1 when not in a tree). */
   private gain;
   /** Distance gain for the src/element path (1 when not spatial / no pose). */
@@ -101,6 +114,16 @@ declare class AudioPlayer extends Node {
   * a suspended context is resumed by the same unlock listener as `src` players.
   */
   private playPreset;
+  /**
+  * A destroyed node goes SILENT.
+  *
+  * Nothing used to stop a sound on teardown, so a level's looping background
+  * clip kept playing over the level after it — the node was freed, so nobody
+  * had a handle to stop it with either. Being MOVED is deliberately not this:
+  * reparenting a node is not destroying it, and a sound that survives the move
+  * is what a scene graph should do.
+  */
+  override free(): void;
   stop(): void;
   /** Replay a gesture-blocked play (wired to the first user gesture). */
   retryPending(): void;

package/dist/{physics-2d-Dns-oZlE.js → physics-2d-BhZZ-HAp.js}

@@ -1,7 +1,7 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { C as diagnose } from "./loader-B-Gft32x.js";
+import { C as diagnose } from "./loader-BTkHYrQn.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-Trx7WHnD.js";
+import { _ as RigidBody2D, b as validateCollider2D, g as PhysicsBody2D, h as CharacterBody2D, m as Area2D, p as Joint2D, y as Node2D } from "./register-DROK2l7J.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-BhI0ehpe.js → physics-3d-DmyO2oaN.js}

@@ -1,9 +1,9 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { C as diagnose } from "./loader-B-Gft32x.js";
+import { C as diagnose } from "./loader-BTkHYrQn.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
-import { B as validateCollider3D, F as CharacterBody3D, I as PhysicsBody3D, L as RigidBody3D, P as Area3D, z as Node3D } from "./gameplay-B6jqvYeM.js";
+import { B as validateCollider3D, F as CharacterBody3D, I as PhysicsBody3D, L as RigidBody3D, P as Area3D, z as Node3D } from "./gameplay-CRYw_Q-T.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-DSZwsKPs.js";
+import { A as Terrain3D, F as InstancedMesh3D, L as buildMeshGeometry, P as Joint3D } from "./environment-presets-SkGanr2s.js";
 import { Euler, Matrix4, Quaternion, Vector3 } from "three";
 //#region src/3d/physics/collider-lines.ts
 /**

package/dist/react.d.ts

@@ -1,4 +1,4 @@
-import { P as Scene, b as Engine, n as BehaviorCtor } from "./behavior-uPEuZrUB.js";
+import { P as Scene, b as Engine, n as BehaviorCtor } from "./behavior-Do0Da56m.js";
 import { c as JsonValue } from "./schema-CFeioQRE.js";
 import { CSSProperties, ReactNode } from "react";
 

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-CGnoypjL.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-B_e9hJf7.js").then((n) => n.n)).createGame2D(o)))(opts);
+			const next = await (_gameFactory ?? (mode === "3d" ? async (o) => (await import("./create-game-CDJ1lVqK.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-9D87XaiX.js").then((n) => n.n)).createGame2D(o)))(opts);
 			if (disposed) {
 				next.dispose();
 				return;