incanto 0.64.1 → 0.66.0

package/dist/gameplay.d.ts

@@ -1,4 +1,4 @@
-import { b as Engine, d as PropSchema, jt as Node, n as BehaviorCtor, t as Behavior } from "./behavior-DsgayMsH.js";
+import { b as Engine, d as PropSchema, jt as Node, n as BehaviorCtor, t as Behavior } from "./behavior-BXNLfIJk.js";
 import { c as JsonValue, s as JsonObject } from "./schema-CFeioQRE.js";
 
 //#region src/gameplay/chase.d.ts
@@ -11,6 +11,8 @@ import { c as JsonValue, s as JsonObject } from "./schema-CFeioQRE.js";
 *   it leaves), so wire it to an attack.
 * - `loseRange` (>0) gives up the chase when the target gets that far away,
 *   emitting `lostTarget` once.
+* - `facePath`/`turnSpeed` turn a skin toward the direction of travel — the job
+*   `CharacterController3D` does for the player and nobody did for an NPC.
 * - `moveParent` (default false) moves the parent node instead of this one.
 *   A node carries ONE behavior, so an enemy whose ROOT must hold `Health`
 *   (e.g. for `Health.freeOnDeath` clone-safe cleanup) puts `Chase` on a CHILD
@@ -25,6 +27,8 @@ declare class Chase extends Behavior {
   stopRange: number;
   loseRange: number;
   moveParent: boolean;
+  facePath: string;
+  turnSpeed: number;
   private inRange;
   private lost;
   override onReady(): void;
@@ -56,6 +60,37 @@ declare class Collector extends Behavior {
   override deserialize(data: JsonValue): void;
 }
 //#endregion
+//#region src/gameplay/currency.d.ts
+/**
+* Money. Earn it, spend it, and refuse what you cannot afford.
+*
+* `ScoreKeeper` is the closest thing the library had and it is a SCORE: it
+* counts up, it has no spend, no affordability question, and its counter is
+* already wired to the win condition. So a tower defense built on 0.65.0 wrote
+* its own wallet — and so does every shop, every build mode, every upgrade tree
+* and every economy game.
+*
+* `spend` is the whole point: it returns whether it went through, and emits
+* `refused` when it did not, so "you cannot afford that" is a wire rather than
+* a comparison every caller repeats and one caller forgets.
+*/
+declare class Currency extends Behavior {
+  static readonly props: PropSchema;
+  static readonly signals: readonly string[];
+  amount: number;
+  max: number;
+  /** Can this be paid right now? */
+  canAfford(cost: number): boolean;
+  /** Pay `cost` if it is there. Returns whether it went through. */
+  spend(cost: number): boolean;
+  /** Take payment in. */
+  earn(gain: number): void;
+  /** Set it outright (a shop that grants, a cheat, a restore). */
+  setAmount(next: number): void;
+  override serialize(): JsonValue;
+  override deserialize(data: JsonValue): void;
+}
+//#endregion
 //#region src/gameplay/health.d.ts
 /**
 * Hit points with regeneration and post-hit invulnerability (i-frames) —
@@ -158,7 +193,9 @@ declare class Health extends Behavior {
 * - `repeatEvery` (seconds, 0 = off) re-damages targets that STAY overlapped —
 *   lava pools, poison clouds, an enemy standing on you. Contact events fire
 *   only on entry/exit; this is the "and it keeps hurting" knob.
-* - `destroySelf` frees the hazard after a hit (single-use projectiles).
+* - `destroySelf` frees the hazard after a hit (single-use projectiles), and
+*   `freeParent` makes that free the PARENT — a bullet whose hitbox is a child,
+*   which is the only shape a node-carries-one-script engine allows.
 *
 * SCORING PATTERN (clone-safe): wire the KILLER's `dealtDamage` →
 * `ScoreKeeper.addScore`. The weapon is usually a non-cloned node (it lives on
@@ -173,6 +210,7 @@ declare class DamageOnContact extends Behavior {
   oncePerTarget: boolean;
   repeatEvery: number;
   destroySelf: boolean;
+  freeParent: boolean;
   private readonly hit;
   /** Targets currently overlapping → seconds until their next repeat tick. */
   private readonly inside;
@@ -181,6 +219,42 @@ declare class DamageOnContact extends Behavior {
   private tryDamage;
 }
 //#endregion
+//#region src/gameplay/face-target.d.ts
+/**
+* Turn toward the nearest thing in a group, and say when you are on it.
+*
+* A turret is the shape every tower defense, sentry gun, security camera and
+* idle-NPC-that-watches-you needs, and it could not be composed. `Chase`
+* already finds the nearest target and turns toward it — and then MOVES, which
+* is the one thing a turret must not do; `Patrol`/`Chase`'s `facePath` only
+* turns as a side effect of locomotion, so a stationary node cannot use it.
+* A tower defense built on 0.65.0 hand-wrote acquisition (~20 lines) and
+* turn-and-gate-the-shot (~15) because of that.
+*
+* `aimed` fires when the facing settles onto the target and `lostAim` when it
+* comes off, so "only fire while actually pointed at it" is a wire rather than
+* an angle comparison you write yourself.
+*/
+declare class FaceTarget extends Behavior {
+  static readonly props: PropSchema;
+  static readonly signals: readonly string[];
+  targetGroup: string;
+  range: number;
+  facePath: string;
+  turnSpeed: number;
+  aimTolerance: number;
+  /** The node currently being tracked, or null. */
+  target: Node | null;
+  /** True while the facing is within `aimTolerance` of the target. */
+  onTarget: boolean;
+  override onReady(): void;
+  override update(dt: number): void;
+  private nearest;
+  /** Is the turret's forward within tolerance of the direction to the target? */
+  private pointedAt;
+  private setAim;
+}
+//#endregion
 //#region src/gameplay/follow-camera.d.ts
 /**
 * Make the node it sits on chase a target's position — THE camera-follow
@@ -235,6 +309,10 @@ declare class Interactable extends Behavior {
 * pickups that vanish. Accumulates `dt`; on elapse emits `expired` then
 * `queueFree()`s its node.
 *
+* `freeParent: true` frees the node's PARENT instead — the shape a bullet needs,
+* since a node carries ONE script so `Projectile`, the damage and the timer have
+* to live on separate nodes.
+*
 * With `startOnSignal: true` the countdown is armed manually via `startTimer()`
 * (wire a signal → `startTimer`), so the lifetime begins on an event rather
 * than at spawn.
@@ -244,6 +322,7 @@ declare class Lifetime extends Behavior {
   static readonly signals: readonly string[];
   seconds: number;
   startOnSignal: boolean;
+  freeParent: boolean;
   private elapsed;
   private running;
   private fired;
@@ -327,6 +406,13 @@ declare class Oscillate extends Behavior {
 *
 * - `loop` (default) — after the last point, head back to the first.
 * - `mode: 'pingpong'` — reverse direction at each end instead of wrapping.
+* - `moveParent` (default false) moves the parent node instead of this one,
+*   exactly as `Chase` does. A node carries ONE behavior, so a guard that must
+*   patrol AND hold `Health` on its body puts `Patrol` on a CHILD. Without
+*   this the patrolling body had to carry `Patrol` itself and could hold
+*   nothing else — so a patrolling enemy could not be hurt.
+* - `facePath`/`turnSpeed` turn a skin toward the direction of travel, the job
+*   `CharacterController3D` does for the player and nobody did for an NPC.
 */
 declare class Patrol extends Behavior {
   static readonly props: PropSchema;
@@ -336,11 +422,16 @@ declare class Patrol extends Behavior {
   loop: boolean;
   mode: string;
   pauseAt: number;
+  moveParent: boolean;
+  facePath: string;
+  turnSpeed: number;
   private index;
   private direction;
   private pauseTimer;
   override onReady(): void;
   override update(dt: number): void;
+  /** Turn the skin toward the step just taken. */
+  private face;
   /** Waypoints already reported dead, so a per-frame stall says it once. */
   private readonly reportedDead;
   /**
@@ -971,4 +1062,4 @@ declare function registerGameplayBehaviors(opts?: {
   replace?: boolean;
 }): void;
 //#endregion
-export { CameraShake, Chase, Collector, Cooldown, DamageOnContact, DayNight, type DayPhase, FloatAway, FollowCamera, GAMEPLAY_BEHAVIORS, GameFlow, type GameFlowState, Health, Interactable, Lifetime, MoveTo, Oscillate, PathFollow, Patrol, Pickup, Projectile, SavePoint, ScoreKeeper, Spawner, Wander, WaveSpawner, ZombieAI, goToScene, hitStop, phaseOf, registerGameplayBehaviors, restartScene, screenFlash };
+export { CameraShake, Chase, Collector, Cooldown, Currency, DamageOnContact, DayNight, type DayPhase, FaceTarget, FloatAway, FollowCamera, GAMEPLAY_BEHAVIORS, GameFlow, type GameFlowState, Health, Interactable, Lifetime, MoveTo, Oscillate, PathFollow, Patrol, Pickup, Projectile, SavePoint, ScoreKeeper, Spawner, Wander, WaveSpawner, ZombieAI, goToScene, hitStop, phaseOf, registerGameplayBehaviors, restartScene, screenFlash };

package/dist/gameplay.js

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

package/dist/index.d.ts

@@ -1,10 +1,10 @@
-import { $ as T_PREFIX, A as SettingsValues, At as BusName, B as captureBehaviors, C as EngineStats, Ct as sfxDuration, Dt as MusicTrack, E as DeviceHints, Et as MusicManager, F as BehaviorState, Ft as LogLevel, G as ORDER_GROUP_BASE, H as savesWithoutUid, I as RestoreReport, It as LogManager, J as effectiveOrder, K as OrderGroup, L as SaveSlot, Lt as Signal, M as readDeviceHints, Mt as NodeLifecycle, N as suggestQuality, Nt as SceneTree, O as QualityTier, Ot as PlayMusicOptions, P as Scene, Pt as LogEntry, Q as Localization, R as SaveSlots, Rt as SignalListener, S as Scheduler, St as SynthOptions, T as RendererStats, Tt as MusicBackend, U as SaveStore, V as restoreBehaviors, W as createSaveStore, X as BASE_LOCALE, Y as resolveOrderGroups, Z as LocaleTables, _ as mergeStaticSignals, _t as spatialPan, a as clearBehaviors, at as EffectLog, b as Engine, bt as SfxParams, c as registeredBehaviors, ct as isAudioContextAvailable, d as PropSchema, dt as Listener, et as suggestLocale, f as clearRegistry, ft as ROLLOFF_MODELS, g as getNodeType, gt as spatialGain, h as getNodeSignals, ht as Vec3, i as behaviorSignals, it as EffectKind, j as qualityEnvironment, jt as Node, k as Settings, kt as AudioBuses, l as NodeCtor, lt as Voice, m as getNodeSchema, mt as SpatialParams, n as BehaviorCtor, nt as InputMap, o as getBehavior, ot as SfxEngine, p as createNode, pt as RolloffModel, q as OrderGroupTable, r as behaviorSchema, rt as EffectEvent, s as registerBehavior, st as SfxPlayOptions, t as Behavior, tt as translationKey, u as PropDef, ut as VoicePreset, v as registerNode, vt as SFX_PRESETS, w as GameStats, wt as synthSfx, x as EngineOptions, xt as SfxWave, y as registeredTypes, yt as SFX_PRESET_NAMES, z as behaviorsWithoutSave } from "./behavior-DsgayMsH.js";
+import { $ as T_PREFIX, A as SettingsValues, At as BusName, B as captureBehaviors, C as EngineStats, Ct as sfxDuration, Dt as MusicTrack, E as DeviceHints, Et as MusicManager, F as BehaviorState, Ft as LogLevel, G as ORDER_GROUP_BASE, H as savesWithoutUid, I as RestoreReport, It as LogManager, J as effectiveOrder, K as OrderGroup, L as SaveSlot, Lt as Signal, M as readDeviceHints, Mt as NodeLifecycle, N as suggestQuality, Nt as SceneTree, O as QualityTier, Ot as PlayMusicOptions, P as Scene, Pt as LogEntry, Q as Localization, R as SaveSlots, Rt as SignalListener, S as Scheduler, St as SynthOptions, T as RendererStats, Tt as MusicBackend, U as SaveStore, V as restoreBehaviors, W as createSaveStore, X as BASE_LOCALE, Y as resolveOrderGroups, Z as LocaleTables, _ as mergeStaticSignals, _t as spatialPan, a as clearBehaviors, at as EffectLog, b as Engine, bt as SfxParams, c as registeredBehaviors, ct as isAudioContextAvailable, d as PropSchema, dt as Listener, et as suggestLocale, f as clearRegistry, ft as ROLLOFF_MODELS, g as getNodeType, gt as spatialGain, h as getNodeSignals, ht as Vec3, i as behaviorSignals, it as EffectKind, j as qualityEnvironment, jt as Node, k as Settings, kt as AudioBuses, l as NodeCtor, lt as Voice, m as getNodeSchema, mt as SpatialParams, n as BehaviorCtor, nt as InputMap, o as getBehavior, ot as SfxEngine, p as createNode, pt as RolloffModel, q as OrderGroupTable, r as behaviorSchema, rt as EffectEvent, s as registerBehavior, st as SfxPlayOptions, t as Behavior, tt as translationKey, u as PropDef, ut as VoicePreset, v as registerNode, vt as SFX_PRESETS, w as GameStats, wt as synthSfx, x as EngineOptions, xt as SfxWave, y as registeredTypes, yt as SFX_PRESET_NAMES, z as behaviorsWithoutSave } from "./behavior-BXNLfIJk.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-DolLJWJn.js";
+import { n as loadScene, t as LoadSceneOptions } from "./loader-Cga7FVP4.js";
 import { i as resolveFrames, n as AnimationEntry, r as resolveAnimation, t as AnimationDef } from "./sprite-animation-CMr6f1K2.js";
-import { a as ParticleSimConfig, i as ParticleSim, n as AudioPlayer, o as ParticleView, t as AudioElementLike } from "./audio-player-D5GJgb_x.js";
+import { a as ParticleSimConfig, i as ParticleSim, n as AudioPlayer, o as ParticleView, t as AudioElementLike } from "./audio-player-_UAcHxnC.js";
 import { i as gridFromRows, n as PathGrid, r as findPath, t as FindPathOptions } from "./pathfinding-_fGrCFmH.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-C5x2vPF5.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-BHoB6fCU.js";
 
 //#region src/core/audio/crossfade.d.ts
 /**

package/dist/index.js

@@ -1,13 +1,13 @@
-import { A as describeRefProblem, B as registeredBehaviors, C as ORDER_GROUP_BASE, E as InputMap, F as behaviorSchema, I as behaviorSignals, L as clearBehaviors, M as resolveRefInJson, N as parseNodePath, O as Node, P as Behavior, R as getBehavior, S as createSaveStore, T as resolveOrderGroups, V as Signal, _ as SaveSlots, a as serializeNode, b as restoreBehaviors, d as computeViewport, f as resolveViewport, g as resolveConstants, h as isConstRef, i as Scene, j as nodeRefWarnings, m as CONST_REF_KEY, n as loadScene, o as SCENE_FORMAT, p as SceneTree, v as behaviorsWithoutSave, w as effectiveOrder, x as savesWithoutUid, y as captureBehaviors, z as registerBehavior } from "./loader-zDynoew_.js";
-import { A as UiBanner, B as isAudioContextAvailable, D as EffectLog, E as LogManager, F as T_PREFIX, G as SFX_PRESET_NAMES, H as spatialGain, I as suggestLocale, J as MusicManager, K as sfxDuration, M as UiText, N as BASE_LOCALE, O as HudLayer, P as Localization, Q as AudioBuses, R as translationKey, S as qualityEnvironment, T as suggestQuality, U as spatialPan, V as ROLLOFF_MODELS, W as SFX_PRESETS, X as crossfadeGains, Y as WebAudioMusicBackend, Z as fadeGain, _ as AudioPlayer, a as UiMuteToggle, b as Settings, c as UiRenderScaleSelect, d as UiToggle, f as UiVolumeSlider, g as UiDialogue, h as UiButton, i as UiLanguageSelect, j as UiBar, l as UiSelect, m as Respawn, n as UiFrameCapSelect, o as UiPanel, p as Timer, q as synthSfx, r as UiImage, s as UiQualitySelect, t as registerCoreNodes, u as UiSlider, v as Engine, w as readDeviceHints, z as SfxEngine } from "./register-Btm7_Emq.js";
+import { A as describeRefProblem, B as registeredBehaviors, C as ORDER_GROUP_BASE, E as InputMap, F as behaviorSchema, I as behaviorSignals, L as clearBehaviors, M as resolveRefInJson, N as parseNodePath, O as Node, P as Behavior, R as getBehavior, S as createSaveStore, T as resolveOrderGroups, V as Signal, _ as SaveSlots, a as serializeNode, b as restoreBehaviors, d as computeViewport, f as resolveViewport, g as resolveConstants, h as isConstRef, i as Scene, j as nodeRefWarnings, m as CONST_REF_KEY, n as loadScene, o as SCENE_FORMAT, p as SceneTree, v as behaviorsWithoutSave, w as effectiveOrder, x as savesWithoutUid, y as captureBehaviors, z as registerBehavior } from "./loader-lQDCwNag.js";
+import { A as UiBanner, B as isAudioContextAvailable, D as EffectLog, E as LogManager, F as T_PREFIX, G as SFX_PRESET_NAMES, H as spatialGain, I as suggestLocale, J as MusicManager, K as sfxDuration, M as UiText, N as BASE_LOCALE, O as HudLayer, P as Localization, Q as AudioBuses, R as translationKey, S as qualityEnvironment, T as suggestQuality, U as spatialPan, V as ROLLOFF_MODELS, W as SFX_PRESETS, X as crossfadeGains, Y as WebAudioMusicBackend, Z as fadeGain, _ as AudioPlayer, a as UiMuteToggle, b as Settings, c as UiRenderScaleSelect, d as UiToggle, f as UiVolumeSlider, g as UiDialogue, h as UiButton, i as UiLanguageSelect, j as UiBar, l as UiSelect, m as Respawn, n as UiFrameCapSelect, o as UiPanel, p as Timer, q as synthSfx, r as UiImage, s as UiQualitySelect, t as registerCoreNodes, u as UiSlider, v as Engine, w as readDeviceHints, z as SfxEngine } from "./register-BmuqYTiY.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-CwwhxQgb.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-CF70EArN.js";
-import { n as startRecording, r as auditScene, t as replay } from "./replay-DKRmiVjk.js";
+import { n as startRecording, r as auditScene, t as replay } from "./replay-IsZbNu6d.js";
 import { a as logReport, i as resolveRendering, n as attachTouchControls, o as logText, r as joystickVector, s as parseDrive, t as TouchControls } from "./touch-DESwnpOc.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-CY-mrr1L.js";
-import { a as preloadUrls, i as preloadSceneAssets, n as newUid, o as findPath, r as assetUrls, s as gridFromRows, t as VERSION } from "./src-CNS2xQB1.js";
-import { t as duplicateNode } from "./duplicate-BOOKmkQ7.js";
+import { a as preloadUrls, i as preloadSceneAssets, n as newUid, o as findPath, r as assetUrls, s as gridFromRows, t as VERSION } from "./src-BTLbXFPZ.js";
+import { t as duplicateNode } from "./duplicate-CqSAtdrh.js";
 export { AudioBuses, AudioPlayer, BASE_LOCALE, Behavior, CONST_REF_KEY, EffectLog, Engine, HudLayer, IncantoError, InputMap, Localization, LogManager, MusicManager, Node, ORDER_GROUP_BASE, PARTICLE_PRESETS, PARTICLE_PRESET_NAMES, ParticleSim, ROLLOFF_MODELS, Respawn, 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, preloadSceneAssets, preloadUrls, qualityEnvironment, readDeviceHints, registerBehavior, registerCoreNodes, registerNode, registeredBehaviors, registeredTypes, replay, resolveAnimation, resolveConstants, resolveFrames, resolveOrderGroups, resolveRefInJson, resolveRendering, resolveViewport, restoreBehaviors, savesWithoutUid, serializeNode, sfxDuration, spatialGain, spatialPan, startRecording, suggestLocale, suggestQuality, synthSfx, translationKey };

package/dist/{loader-DolLJWJn.d.ts → loader-Cga7FVP4.d.ts}

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

package/dist/{loader-zDynoew_.js → loader-lQDCwNag.js}

@@ -42,7 +42,47 @@ var Signal = class {
 * schema/defaults/delta model as node props.
 */
 var Behavior = class {
-	static props;
+	/**
+	* Every behavior accepts `enabled`, inherited down the static chain — see
+	* `enabled` below for why it is a universal prop rather than one each AI
+	* behavior declares for itself.
+	*/
+	static props = { enabled: { default: true } };
+	/**
+	* Whether this behavior's `update`/`fixedUpdate` run. `false` stops it
+	* without removing it — and this is what makes ENEMY AI expressible in JSON.
+	*
+	* A node holds ONE behavior, so `Patrol` and `Chase` cannot share one. Both
+	* can ride child nodes with `moveParent`, but then both run at once, and
+	* before this nothing could stop either — so "patrols until it spots you,
+	* then chases", the most ordinary AI there is, had to be hand-written in
+	* TypeScript, which is exactly what the gameplay library exists to prevent.
+	* With this the whole state machine is two wires:
+	*
+	* ```jsonc
+	* { "signal": "spotted", "from": "Eyes", "to": "Walk", "handler": "disable" },
+	* { "signal": "spotted", "from": "Eyes", "to": "Hunt", "handler": "enable"  }
+	* ```
+	*
+	* `Clickable` had already hand-rolled this exact prop for itself. One
+	* behavior needed it and solved it locally; nothing generalized it.
+	*
+	* Asleep is NOT detached: the behavior keeps its props and its accumulated
+	* state, stays reachable as `node.behavior`, keeps its signal connections,
+	* and still saves through `serialize()`. Only the per-frame hooks pause. The
+	* lifecycle hooks (`onEnterTree`/`onReady`/`onExitTree`) are not gated — they
+	* are structural, they fire once, and a behavior that skipped its own
+	* `onReady` would wake up uninitialized.
+	*/
+	enabled = true;
+	/** Start running again — a connection handler, so a wire can do it. */
+	enable() {
+		this.enabled = true;
+	}
+	/** Stop running without being removed — a connection handler. */
+	disable() {
+		this.enabled = false;
+	}
 	/**
 	* Custom signals this behavior emits via `this.emit(...)` — declared onto
 	* its node at load. Undeclared emits are hard errors (typo safety).
@@ -68,6 +108,22 @@ var Behavior = class {
 	get log() {
 		return this.engine.log;
 	}
+	/**
+	* The physics world, for the queries AI asks — `castRay` for line of sight,
+	* `castSphere` for a probe that must not skim past a wall.
+	*
+	* ```ts
+	* const hit = this.physics?.castRay(eye, dir, range, this.node);
+	* const blocked = hit !== null && hit.node !== player;
+	* ```
+	*
+	* `null` in a game with no physics, so a behavior that only sometimes needs
+	* a ray degrades instead of throwing. Pass the caster as `exclude` — a ray
+	* that starts inside its own collider hits itself at distance 0.
+	*/
+	get physics() {
+		return this.node?.tree?.engine?.physics ?? null;
+	}
 	getNode(path) {
 		return this.node.getNode(path);
 	}
@@ -650,7 +706,7 @@ var Node = class {
 		} catch (error) {
 			this._quarantine("update", error, "node");
 		}
-		if (this.behavior && !this.behaviorErrored) try {
+		if (this.behavior && this.behavior.enabled !== false && !this.behaviorErrored) try {
 			this.behavior.update?.(dt);
 		} catch (error) {
 			this._quarantine("update", error, "behavior");
@@ -665,7 +721,7 @@ var Node = class {
 		} catch (error) {
 			this._quarantine("fixedUpdate", error, "node");
 		}
-		if (this.behavior && !this.behaviorErrored) try {
+		if (this.behavior && this.behavior.enabled !== false && !this.behaviorErrored) try {
 			this.behavior.fixedUpdate?.(dt);
 		} catch (error) {
 			this._quarantine("fixedUpdate", error, "behavior");

package/dist/net.d.ts

@@ -1,5 +1,5 @@
-import { d as PropSchema, jt as Node } from "./behavior-DsgayMsH.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-D7OopelJ.js";
+import { d as PropSchema, jt as Node } from "./behavior-BXNLfIJk.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-eJUFjhi1.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 NetworkManager, d as createLocalGameServer, f as LoopbackHub, l as LocalGameServer, n as registerNodesNet, o as applySyncPatch, p as LoopbackTransport, r as NetworkSpawner, t as createSplitScreen, u as LocalGameServerTransport } from "./split-screen-Dx0LvzqS.js";
+import { a as NetworkManager, d as createLocalGameServer, f as LoopbackHub, l as LocalGameServer, n as registerNodesNet, o as applySyncPatch, p as LoopbackTransport, r as NetworkSpawner, t as createSplitScreen, u as LocalGameServerTransport } from "./split-screen-D_i7GRcY.js";
 export { LocalGameServer, LocalGameServerTransport, LoopbackHub, LoopbackTransport, NetworkManager, NetworkSpawner, applySyncPatch, createAgent8Server, createLocalGameServer, createSplitScreen, registerNodesNet };

package/dist/{physics-2d-BPJcJRRP.js → physics-2d-Cji5A6sX.js}

@@ -1,9 +1,9 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { k as diagnose } from "./loader-zDynoew_.js";
+import { k as diagnose } from "./loader-lQDCwNag.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-dGsbnJ87.js";
+import { _ as RigidBody2D, b as validateCollider2D, g as PhysicsBody2D, h as CharacterBody2D, m as Area2D, p as Joint2D, y as Node2D } from "./register-D0CxCveZ.js";
 import { n as registerDebugSource } from "./debug-draw-BM3DsvtT.js";
-import { t as withoutRapierInitNoise } from "./quiet-rapier-BAJ4K94N.js";
+import { n as jointContacts, t as withoutRapierInitNoise } from "./quiet-rapier-C6fW4zcW.js";
 //#region src/2d/physics/physics-2d.ts
 var physics_2d_exports = /* @__PURE__ */ __exportAll({
 	Physics2D: () => Physics2D,
@@ -68,6 +68,7 @@ var Physics2D = class {
 		this.disconnectScene = engine.sceneChanged.connect(() => {
 			if (engine.scene) this.syncBodies();
 		});
+		engine.physics = this;
 		this.syncBodies();
 	}
 	/** @internal Driven by engine.fixedUpdated. */
@@ -118,6 +119,8 @@ var Physics2D = class {
 			const b = this.byColliderHandle.get(h2);
 			if (!a || !b) return;
 			const sig = started ? "triggerEnter" : "triggerExit";
+			this.trackOverlap(a, b, started);
+			this.trackOverlap(b, a, started);
 			try {
 				a.emit(sig, b);
 				b.emit(sig, a);
@@ -283,9 +286,33 @@ var Physics2D = class {
 			else if (joint.type === "rope") data = R.JointData.rope(length, a1, a2);
 			else if (joint.type === "spring") data = R.JointData.spring(length, joint.stiffness, joint.damping, a1, a2);
 			else data = R.JointData.revolute(a1, a2);
-			this.joints.set(joint, this.world.createImpulseJoint(data, ea.body, eb.body, true));
+			const made = this.world.createImpulseJoint(data, ea.body, eb.body, true);
+			made.setContactsEnabled(jointContacts(joint.type, joint.collide));
+			this.joints.set(joint, made);
 		}
 	}
+	/** Who is currently inside each sensor/body, maintained from the event drain. */
+	overlaps = /* @__PURE__ */ new Map();
+	trackOverlap(self, other, started) {
+		let set = this.overlaps.get(self);
+		if (started) {
+			if (!set) {
+				set = /* @__PURE__ */ new Set();
+				this.overlaps.set(self, set);
+			}
+			set.add(other);
+		} else if (set) {
+			set.delete(other);
+			if (set.size === 0) this.overlaps.delete(self);
+		}
+	}
+	/** The bodies currently overlapping `node`. Freed nodes are dropped on read. */
+	overlapping(node) {
+		const set = this.overlaps.get(node);
+		if (!set) return [];
+		for (const other of set) if (other.tree === null) set.delete(other);
+		return [...set];
+	}
 	/**
 	* World-space raycast in PIXELS (y-down). `exclude` skips that body — a
 	* shooter probing from inside its own collider needs it. Sensors (Area2D)
@@ -315,6 +342,7 @@ var Physics2D = class {
 		this.disconnect();
 		this.disconnectScene();
 		this.unregisterDebug();
+		if (this.engine.physics === this) this.engine.physics = null;
 		this.world.free();
 	}
 	lastStructure = -1;

package/dist/{physics-3d-BOO58xzw.js → physics-3d-BkHjwJgI.js}

@@ -1,10 +1,10 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { k as diagnose } from "./loader-zDynoew_.js";
+import { k as diagnose } from "./loader-lQDCwNag.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
-import { B as CharacterBody3D, G as validateCollider3D, H as RigidBody3D, V as PhysicsBody3D, W as Node3D, z as Area3D } from "./gameplay-CLgFdkh5.js";
+import { H as CharacterBody3D, K as Node3D, U as PhysicsBody3D, V as Area3D, W as RigidBody3D, q as validateCollider3D } from "./gameplay-D1RADWu3.js";
 import { n as registerDebugSource } from "./debug-draw-BM3DsvtT.js";
-import { t as withoutRapierInitNoise } from "./quiet-rapier-BAJ4K94N.js";
-import { A as Terrain3D, F as InstancedMesh3D, L as buildMeshGeometry, P as Joint3D } from "./environment-presets-D2vzw583.js";
+import { n as jointContacts, t as withoutRapierInitNoise } from "./quiet-rapier-C6fW4zcW.js";
+import { A as Terrain3D, F as InstancedMesh3D, L as buildMeshGeometry, P as Joint3D } from "./environment-presets-BlPsEmq6.js";
 import { Euler, Matrix4, Quaternion, Vector3 } from "three";
 //#region src/3d/physics/collider-lines.ts
 /**
@@ -264,6 +264,7 @@ var Physics3D = class {
 		this.disconnectScene = engine.sceneChanged.connect(() => {
 			if (engine.scene) this.syncBodies();
 		});
+		engine.physics = this;
 		this.syncBodies();
 	}
 	/** Whether the solver runs at all. False = collider outlines only. */
@@ -327,6 +328,11 @@ var Physics3D = class {
 				nv[0] = lv.x;
 				nv[1] = lv.y;
 				nv[2] = lv.z;
+				const av = e.body.angvel();
+				const na = node.angularVelocity;
+				na[0] = av.x;
+				na[1] = av.y;
+				na[2] = av.z;
 				e.lastV[0] = lv.x;
 				e.lastV[1] = lv.y;
 				e.lastV[2] = lv.z;
@@ -341,6 +347,8 @@ var Physics3D = class {
 			const b = this.byColliderHandle.get(h2);
 			if (!a || !b) return;
 			const sig = started ? "triggerEnter" : "triggerExit";
+			this.trackOverlap(a, b, started);
+			this.trackOverlap(b, a, started);
 			try {
 				a.emit(sig, b);
 				b.emit(sig, a);
@@ -472,6 +480,7 @@ var Physics3D = class {
 		this.disconnect();
 		this.disconnectScene();
 		this.unregisterDebug();
+		if (this.engine.physics === this) this.engine.physics = null;
 		this.world.free();
 	}
 	lastStructure = -1;
@@ -633,6 +642,11 @@ var Physics3D = class {
 			if (node instanceof RigidBody3D) {
 				desc.setGravityScale(node.gravityScale);
 				desc.setLinvel(node.linearVelocity[0] ?? 0, node.linearVelocity[1] ?? 0, node.linearVelocity[2] ?? 0);
+				desc.setAngvel({
+					x: node.angularVelocity[0] ?? 0,
+					y: node.angularVelocity[1] ?? 0,
+					z: node.angularVelocity[2] ?? 0
+				});
 				if (node.fixedRotation) desc.lockRotations();
 			}
 			const body = this.world.createRigidBody(desc);
@@ -789,10 +803,40 @@ var Physics3D = class {
 			else if (joint.type === "rope") data = R.JointData.rope(length, a1, a2);
 			else if (joint.type === "spring") data = R.JointData.spring(length, joint.stiffness, joint.damping, a1, a2);
 			else data = R.JointData.spherical(a1, a2);
-			this.joints.set(joint, this.world.createImpulseJoint(data, ea.body, eb.body, true));
+			const made = this.world.createImpulseJoint(data, ea.body, eb.body, true);
+			made.setContactsEnabled(jointContacts(joint.type, joint.collide));
+			this.joints.set(joint, made);
+		}
+	}
+	/** Who is currently inside each sensor/body, maintained from the event drain. */
+	overlaps = /* @__PURE__ */ new Map();
+	trackOverlap(self, other, started) {
+		let set = this.overlaps.get(self);
+		if (started) {
+			if (!set) {
+				set = /* @__PURE__ */ new Set();
+				this.overlaps.set(self, set);
+			}
+			set.add(other);
+		} else if (set) {
+			set.delete(other);
+			if (set.size === 0) this.overlaps.delete(self);
 		}
 	}
 	/**
+	* The bodies currently overlapping `node` — the standing answer behind
+	* `triggerEnter`/`triggerExit`.
+	*
+	* Freed nodes are dropped on read rather than tracked, so a hazard that
+	* despawns inside a plate cannot leave a ghost holding a door open.
+	*/
+	overlapping(node) {
+		const set = this.overlaps.get(node);
+		if (!set) return [];
+		for (const other of set) if (other.tree === null) set.delete(other);
+		return [...set];
+	}
+	/**
 	* World-space raycast (meters). `exclude` skips that body's collider —
 	* ground probes from inside a capsule need it. `opts.staticOnly` hits ONLY the
 	* fixed/static world (excludes both dynamic AND kinematic bodies): the camera

package/dist/{quiet-rapier-BAJ4K94N.js → quiet-rapier-C6fW4zcW.js}

@@ -1,3 +1,16 @@
+//#region src/core/joint-contacts.ts
+/**
+* Should these two jointed bodies collide with each other?
+*
+* `null` means "decide from the type": a PIVOT wants its bodies overlapping and
+* must not let the contact solver fight the joint; a TETHER anchors something to
+* the world and that something still has to rest on it.
+*/
+function jointContacts(type, collide) {
+	if (collide !== null) return collide;
+	return type === "rope" || type === "spring";
+}
+//#endregion
 //#region src/core/quiet-rapier.ts
 /**
 * Swallow one wrong warning that rapier prints about itself.
@@ -43,4 +56,4 @@ async function withoutRapierInitNoise(boot, out = console) {
 	}
 }
 //#endregion
-export { withoutRapierInitNoise as t };
+export { jointContacts as n, withoutRapierInitNoise as t };

package/dist/react.d.ts

@@ -1,4 +1,4 @@
-import { P as Scene, b as Engine, n as BehaviorCtor } from "./behavior-DsgayMsH.js";
+import { P as Scene, b as Engine, n as BehaviorCtor } from "./behavior-BXNLfIJk.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-B746rYbr.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-B1KM6dA6.js").then((n) => n.n)).createGame2D(o)))(opts);
+			const next = await (_gameFactory ?? (mode === "3d" ? async (o) => (await import("./create-game-DYJCIzO0.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-Dd7H4bJV.js").then((n) => n.n)).createGame2D(o)))(opts);
 			if (disposed) {
 				next.dispose();
 				return;

package/dist/{register-Btm7_Emq.js → register-BmuqYTiY.js}

@@ -1,5 +1,5 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { C as ORDER_GROUP_BASE, E as InputMap, O as Node, S as createSaveStore, T as resolveOrderGroups, V as Signal, b as restoreBehaviors, k as diagnose, y as captureBehaviors } from "./loader-zDynoew_.js";
+import { C as ORDER_GROUP_BASE, E as InputMap, O as Node, S as createSaveStore, T as resolveOrderGroups, V as Signal, b as restoreBehaviors, k as diagnose, y as captureBehaviors } from "./loader-lQDCwNag.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as Rng } from "./rng-DP-SR7eg.js";
 import { l as registerNode } from "./registry-CF70EArN.js";
@@ -2365,6 +2365,20 @@ var Engine = class {
 	sceneChanged = new Signal();
 	/** Declarative input — scene `input{}` declarations load on setScene. */
 	input = new InputMap();
+	/**
+	* The physics world, once something enabled it — `null` in a game that has
+	* none, which is most 2D puzzle games and every menu scene.
+	*
+	* `enablePhysics2D/3D` set this, and `dispose()` clears it. It is the handle
+	* `incanto-physics-and-input.md` has always assumed you had: the skill teaches
+	* `physics.castRay(...)` but the object lived only where the game BOOTED, so
+	* a `Behavior` — where AI lives, and where line of sight is decided — had no
+	* way to reach it short of casting the private `node._physics`.
+	*
+	* Typed as the query surface rather than the concrete class so core never
+	* learns about Rapier or three. From a behavior, prefer `this.physics`.
+	*/
+	physics = null;
 	/** Seeded randomness for game logic (deterministic when `seed` is set). */
 	rng;
 	/** The engine log channel (debug overlay + headless harness tail this). */
@@ -2379,6 +2393,33 @@ var Engine = class {
 	* and cleared on dispose; null when nothing renders (headless).
 	*/
 	picker = null;
+	/** Frames the engine has stepped — monotonic, and the pick cache's key. */
+	frameNumber = 0;
+	/** @internal frame number + answer, so N Clickables cost ONE raycast. */
+	pickCacheFrame = -1;
+	pickCacheKey = "";
+	pickCacheHit = null;
+	/**
+	* The node under (x, y), answered at most ONCE per frame per cursor position.
+	*
+	* `Clickable` asks every frame, and a board game has one per cell: 42 pads
+	* measured **420 picker calls over ten frames** — one GPU raycast per pad per
+	* frame, all answering the same question about the same pixel. At 60 fps that
+	* is ~2500 raycasts a second to find out what the cursor is on, and a 200-tile
+	* board was unusable.
+	*
+	* Cached on (frame, x, y), so a game that picks at two different points in one
+	* frame still gets two real answers.
+	*/
+	pickAt(x, y) {
+		if (!this.picker) return null;
+		const key = `${x},${y}`;
+		if (this.pickCacheFrame === this.frameNumber && this.pickCacheKey === key) return this.pickCacheHit;
+		this.pickCacheFrame = this.frameNumber;
+		this.pickCacheKey = key;
+		this.pickCacheHit = this.picker(x, y);
+		return this.pickCacheHit;
+	}
 	/** Global volume buses — `master` × `sfx`/`music` gain + `muted`. AudioPlayer
 	*  routes its volume through this; games set it for global volume/mute. */
 	audio = new AudioBuses();
@@ -2714,6 +2755,7 @@ var Engine = class {
 		scene.tree.fixedUpdate(dt);
 		this.fixedUpdated.emit(dt);
 		const startedUpdate = performance.now();
+		this.frameNumber += 1;
 		scene.tree.update(dt);
 		this.music.tick(dt);
 		this.updated.emit(dt);
@@ -2748,6 +2790,7 @@ var Engine = class {
 		}
 		if (this.accumulator >= this.fixedStep) this.accumulator %= this.fixedStep;
 		const startedUpdate = performance.now();
+		this.frameNumber += 1;
 		scene.tree.update(dt);
 		this.music.tick(dt);
 		this.updated.emit(dt);