incanto 0.69.0 → 0.71.0

package/dist/index.d.ts

@@ -1,10 +1,10 @@
-import { a as ParticleSimConfig, c as showBootFailure, i as ParticleSim, n as AudioPlayer, o as ParticleView, s as isWebGLAvailable, t as AudioElementLike } from "./audio-player-C0j2k-yB.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-rm8vVzu_.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-B6ugCV1Q.js";
-import { n as loadScene, t as LoadSceneOptions } from "./loader-DadV2QCT.js";
+import { a as ParticleSimConfig, c as showBootFailure, i as ParticleSim, n as AudioPlayer, o as ParticleView, s as isWebGLAvailable, t as AudioElementLike } from "./audio-player-L8yccdMP.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-Dcz0fr1S.js";
+import { a as SceneJson, c as JsonValue, d as jsonKind, i as SCENE_FORMAT, l as jsonClone, n as ConnectionJson, o as JsonKind, r as NodeJson, s as JsonObject, t as Rng, u as jsonEquals } from "./rng-Bb-IutXB.js";
+import { n as loadScene, t as LoadSceneOptions } from "./loader-8-IHvbKD.js";
 import { i as resolveFrames, n as AnimationEntry, r as resolveAnimation, t as AnimationDef } from "./sprite-animation-CMr6f1K2.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-BQfkX4x7.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-F7IZHdFR.js";
 
 //#region src/core/audio/crossfade.d.ts
 /**
@@ -109,6 +109,20 @@ type DriveStep = {
   kind: "pointer";
   dx: number;
   dy: number;
+} | {
+  kind: "at";
+  x: number;
+  y: number;
+} | {
+  kind: "atNode";
+  path: string;
+} | {
+  kind: "click";
+  button: number;
+} | {
+  kind: "mouse";
+  button: number;
+  down: boolean;
 } | {
   kind: "step";
   ms: number;
@@ -245,13 +259,26 @@ type RefResult = {
 declare function resolveRefInJson(root: RefNode | undefined, owner: readonly number[], value: string): RefResult;
 /** The problem in English, for `incanto-check` and as the editor's base text. */
 declare function describeRefProblem(problem: RefProblem, value: string): string;
+interface RefWarningOptions {
+  /**
+  * This file is a PREFAB another scene drops in, so a path may legitimately
+  * leave it.
+  *
+  * `/root/Bolts` is the fragment's own root only while the fragment is alone;
+  * attached, it resolves. Four such warnings stood forever on four of five
+  * files of a real project whose main scene audited clean. The verdict is
+  * reworded rather than suppressed: a typo'd path is MOST likely in a file
+  * written away from the scene that gives it meaning, so it still gets named.
+  */
+  fragment?: boolean;
+}
 /**
 * Scene lints for node-path props that point at nothing.
 *
 * An EMPTY value is not reported: `''` is the default of most of these props and
 * means "not set", which is a choice rather than a typo.
 */
-declare function nodeRefWarnings(scene: JsonObject): string[];
+declare function nodeRefWarnings(scene: JsonObject, opts?: RefWarningOptions): string[];
 //#endregion
 //#region src/core/nodes/hud.d.ts
 /**
@@ -305,6 +332,22 @@ declare class HudLayer extends Node {
   override onExitTree(): void;
   override update(): void;
   /**
+  * Is this the layer the keyboard is talking to?
+  *
+  * Keyboard focus is singular by nature — a browser has ONE focused element —
+  * and `focusNavigation` is per LAYER, so a game with a HUD and a modal that
+  * armed both had a single Enter activate the focused widget in EACH: the
+  * pause menu's RESUME and whatever the screen underneath happened to have
+  * focused, which is "the modal does not block the screen behind it" arriving
+  * through the keyboard.
+  *
+  * The TOPMOST armed layer wins — last in document order, which is the one
+  * drawn on top, and the one a modal is. A hidden layer is not armed at all: a
+  * closed menu must not eat the key from the HUD it covers. With one layer,
+  * which is the usual case, this is always true.
+  */
+  private ownsFocus;
+  /**
   * Arrow keys / d-pad move the focus, Enter / A activates it.
   *
   * Off by default: a game whose HUD has a button must not lose its arrow keys
@@ -361,6 +404,19 @@ declare abstract class HudWidgetBase extends Node {
   * A or an arrow ON this widget means. Default: nothing.
   */
   _activate(_dir: number): void;
+  /**
+  * @internal What a MOUSE CLICK on this widget does. Defaults to `_activate`.
+  *
+  * For a button, a toggle and a select the two are the same thing, which is
+  * why one entry point served both for a while. For `UiDialogue` they are
+  * not: Enter on a waiting choice ANSWERS it, and a click on the box does
+  * not — `advance()` returns early while `current.choices` is set, with the
+  * comment "must pick — clicks don't skip choices".
+  *
+  * A harness whose `click:` answered the question would pass a test the real
+  * game fails, which is the one thing the ladder must not do.
+  */
+  _click(): void;
   /** @internal Draw the focus ring. Overridable if a widget wants its own. */
   _paintFocus(): void;
   /** @internal */
@@ -379,6 +435,27 @@ declare abstract class HudWidgetBase extends Node {
   */
   _mountWidget(): void;
   /**
+  * The gesture, without a pointer — the `press()` of drag and drop.
+  *
+  * All four signals lived on `_wireDrag`, which is wired to a DOM element and
+  * therefore does not exist headless. So the one screen the HUD skill says
+  * needs more than a click — an inventory — was the one screen no harness
+  * could drive: `dragStarted`, `droppedOn`, `dropped` and `dragCancelled`
+  * were unreachable from `runScript`, `incanto-playtest` and every check in
+  * the ladder, and a game that moves items between slots could only be tested
+  * by hand in a browser.
+  *
+  * Same rules as the pointer path, so a test that passes here is a test about
+  * the game: a non-`draggable` source does nothing, a target that is not a
+  * `dropTarget` CANCELS, and dropping a thing back where it came from — on
+  * itself, or on the slot it is already in — is not a move.
+  *
+  * Returns whether the drop was taken.
+  */
+  dropOnto(target: HudWidgetBase | null): boolean;
+  /** The slot this widget is sitting in, if any — its origin for a drop. */
+  private dropTargetAbove;
+  /**
   * Drag and drop, on the DOM the engine already builds.
   *
   * An inventory is the one screen where "click it" is not enough, and every
@@ -409,6 +486,12 @@ declare abstract class HudWidgetBase extends Node {
   * did nothing at all, forever.
   */
   private _followAnchor;
+  /**
+  * Follow the engine, and let a change made HERE reach it — with or without a
+  * DOM element. No element access allowed: this is the half that runs
+  * headless.
+  */
+  protected _pull(): void;
   protected _sync(): void;
   /**
   * Resolve a text prop through the engine's locale.
@@ -487,6 +570,20 @@ declare class UiText extends HudWidgetBase {
   * authored opening line. Filling the slot with nothing instead would put
   * `"Gems  / 8"` on screen for every game's first frame, and a score line
   * that starts blank looks broken rather than empty.
+  *
+  * Unless there IS no opening line. `format` alone painted `""`:
+  *
+  * ```
+  * format = 'Gems {} / 8'
+  * shown before setText  ""            <- nothing on screen
+  * shown after  setText  "Gems 3 / 8"
+  * ```
+  *
+  * and the signals a HUD is wired to — `scoreChanged`, `healthChanged` — only
+  * fire on CHANGE, so the row stays invisible through the whole opening of the
+  * game and forever if the value never moves. An empty slot in a visible
+  * template is the lesser of those two: it shows the author what they
+  * declared, where they declared it.
   */
   get shown(): string;
   override _paintedText(): string | undefined;
@@ -522,7 +619,7 @@ declare class UiBar extends HudWidgetBase {
   * already has, so a bar whose ceiling moves (a max-HP upgrade) needs no
   * second wire.
   */
-  setValue(value: number, max?: number): void;
+  setValue(value: number, max?: number | undefined): void;
   /** Move the ceiling on its own, leaving the fill where it is. */
   setMax(max: number): void;
   protected _build(): HTMLElement;
@@ -554,7 +651,7 @@ declare class UiBanner extends HudWidgetBase {
   show(text: string, opts?: {
     color?: string;
     seconds?: number;
-  }): void;
+  } | undefined): void;
   /** Drop everything (scene transitions). */
   clear(): void;
   protected _build(): HTMLElement;
@@ -626,7 +723,7 @@ declare class UiDialogue extends HudWidgetBase {
   /** What the box currently shows (grows while typing) — test-friendly. */
   get showing(): string;
   /** Queue a line; optional `choices` renders buttons after the line types out. */
-  say(speaker: string, text: string, choices?: string[]): void;
+  say(speaker: string, text: string, choices?: string[] | undefined): void;
   /**
   * A dialogue takes focus while it is up.
   *
@@ -647,6 +744,14 @@ declare class UiDialogue extends HudWidgetBase {
   * `dir` is 0 for "activate" and ±1 for a nudge, the same shape `UiSelect`
   * uses — so one key layout drives a menu, a slider and a conversation.
   */
+  /**
+  * A click on the BOX is `advance()`, which refuses to skip a choice.
+  *
+  * The DOM handler is `box.addEventListener('click', () => this.advance())`
+  * and `advance` returns early while `current.choices` is set. Enter is a
+  * different verb — it answers — so a harness clicking the box must not.
+  */
+  override _click(): void;
   override _activate(dir: number): void;
   /** Show which option the keyboard is on — a ring nobody can see is not one. */
   private paintCursor;
@@ -776,6 +881,16 @@ declare class Timer extends Node {
   private remaining;
   start(time?: number): void;
   stop(): void;
+  /**
+  * Scene-load validation: a period of zero is a timer that never fires.
+  *
+  * `update` guards it — a non-positive period "would spin forever on any dt",
+  * so it calls `stop()` — and the guard is right. Being SILENT about it is
+  * what a load error is for: a scene asking for a tick every zero seconds got
+  * no ticks and no word said. The runtime guard stays, for code that zeroes
+  * the period from a handler.
+  */
+  static validateJson(node: Node): void;
   override onReady(): void;
   override update(dt: number): void;
 }
@@ -858,6 +973,17 @@ declare class UiSlider extends HudWidgetBase {
   override focusable: boolean;
   /** Left/right nudge by one step — the only sane thing a d-pad can mean here. */
   override _activate(dir: number): void;
+  /**
+  * Move it as a PERSON would: set the value and say so.
+  *
+  * `UiButton` has `press()` and the value widgets had nothing, because
+  * assigning `.value` deliberately does not emit (restoring a saved setting
+  * must not fire the handler that saved it). So a harness — or a game driving
+  * its own menu: a preset button, "reset to defaults", a tutorial that moves a
+  * slider for you — had one route to "the player changed this", and it was
+  * `_activate`, which is internal and takes a direction rather than a value.
+  */
+  choose(value: number): void;
   private input;
   private text;
   private last;
@@ -874,6 +1000,8 @@ declare class UiToggle extends HudWidgetBase {
   override focusable: boolean;
   /** Confirm flips it; left/right set it explicitly, which reads better on a pad. */
   override _activate(dir: number): void;
+  /** Flip it as a PERSON would: set the value and say so. See `UiSlider.choose`. */
+  choose(value: boolean): void;
   private input;
   private last;
   protected _build(): HTMLElement;
@@ -890,8 +1018,34 @@ declare class UiSelect extends HudWidgetBase {
   options: string;
   value: string;
   override focusable: boolean;
+  /** The options, as the list of values it actually offers. */
+  private choices;
+  /**
+  * A value the list cannot show is a setting the game and the screen disagree
+  * about.
+  *
+  * The browser cannot select an option that does not exist, so it shows the
+  * FIRST one — while `node.value` keeps answering with what it was given, and
+  * `changed` only fires when a person moves it, so nothing ever reconciles
+  * them. That is the shape a saved setting has after a patch removes a quality
+  * tier, and it is silent for the rest of the session.
+  *
+  * A hard error at LOAD, like every other enum in this engine. An empty value
+  * is "nothing chosen yet", which is a choice.
+  */
+  static validateJson(node: Node): void;
   /** Left/right (and confirm) walk the list — a select has no other gesture. */
   override _activate(dir: number): void;
+  /**
+  * Pick an option as a PERSON would: set the value and say so. See
+  * `UiSlider.choose`.
+  *
+  * An option the list does not offer is refused, for the reason
+  * `validateJson` refuses it in the file: the browser would show the first one
+  * while the node kept answering with what it was given, and nothing would
+  * ever reconcile them.
+  */
+  choose(value: string): void;
   private select;
   private labelEl;
   private lastLabel;
@@ -909,7 +1063,18 @@ declare class UiSelect extends HudWidgetBase {
   */
   protected _optionLabel(value: string): string;
   private fillOptions;
+  /** What was already reported, so a stuck value is said once and not per frame. */
+  private complainedAbout;
+  /**
+  * The runtime half of `validateJson`.
+  *
+  * A behaviour may legitimately write the value first and widen `options`
+  * after — so this reports rather than refuses, and goes quiet again when the
+  * list catches up.
+  */
+  private reportMismatch;
   protected override _sync(): void;
+  protected override _pull(): void;
 }
 /**
 * The language picker, done — because every game needs the same one.
@@ -935,7 +1100,7 @@ declare class UiLanguageSelect extends UiSelect {
   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 _pull(): void;
   protected override _optionLabel(value: string): string;
 }
 /**
@@ -967,6 +1132,7 @@ declare abstract class UiSettingSelect extends UiSelect {
   * `settings.quality.high` is worse than one reading `High`. English is the
   * base language and the fallback, always.
   */
+  protected override _pull(): void;
   protected override _sync(): void;
 }
 /**
@@ -1062,7 +1228,7 @@ declare class UiVolumeSlider extends UiSlider {
   /** Last value we PUSHED in, to tell an engine-side change from a player drag. */
   private lastPushed;
   protected override _labelText(): string;
-  protected override _sync(): void;
+  protected override _pull(): void;
 }
 /**
 * The mute switch.
@@ -1079,7 +1245,7 @@ declare class UiMuteToggle extends UiToggle {
   static override readonly props: PropSchema;
   private lastPushed;
   protected override _labelText(): string;
-  protected override _sync(): void;
+  protected override _pull(): void;
 }
 //#endregion
 //#region src/core/noise.d.ts
@@ -1208,7 +1374,7 @@ declare function resolveConstants<T extends JsonValue | undefined>(value: T, con
 * duplicating a uid'd template can never mint colliding ids. Names ARE
 * kept — rename clones you need to look up individually.
 */
-declare function duplicateNode(node: Node): Node;
+declare function duplicateNode(node: Node, opts?: LoadSceneOptions): Node;
 //#endregion
 //#region src/core/scene/serializer.d.ts
 /**

package/dist/index.js

@@ -1,15 +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-DZE7B07H.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-mmfugpaQ.js";
+import { n as jsonEquals, r as jsonKind, t as jsonClone } from "./json-CfTjpvW8.js";
+import { $ as parseNodePath, A as SceneTree, B as HudLayer, D as computeViewport, E as resolveConstants, F as resolveOrderGroups, G as UiText, I as InputMap, J as Node, N as ORDER_GROUP_BASE, O as resolveViewport, P as effectiveOrder, Q as resolveRefInJson, T as isConstRef, U as UiBanner, W as UiBar, X as describeRefProblem, Z as nodeRefWarnings, _ as Scene, a as restoreBehaviors, at as getBehavior, ct as Signal, et as Behavior, h as loadScene, i as captureBehaviors, it as clearBehaviors, j as createSaveStore, k as newUid, n as SaveSlots, nt as behaviorSchema, o as savesWithoutUid, ot as registerBehavior, r as behaviorsWithoutSave, rt as behaviorSignals, s as duplicateNode, st as registeredBehaviors, v as serializeNode, w as CONST_REF_KEY, y as SCENE_FORMAT } from "./save-slots-Bvuh2p_r.js";
+import { A as T_PREFIX, B as SFX_PRESET_NAMES, D as EffectLog, E as LogManager, F as isAudioContextAvailable, G as crossfadeGains, H as synthSfx, I as ROLLOFF_MODELS, K as fadeGain, L as spatialGain, N as translationKey, O as BASE_LOCALE, P as SfxEngine, R as spatialPan, S as qualityEnvironment, T as suggestQuality, U as MusicManager, V as sfxDuration, W as WebAudioMusicBackend, _ 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 suggestLocale, k as Localization, l as UiSelect, m as Respawn, n as UiFrameCapSelect, o as UiPanel, p as Timer, q as AudioBuses, r as UiImage, s as UiQualitySelect, t as registerCoreNodes, u as UiSlider, v as Engine, w as readDeviceHints, z as SFX_PRESETS } from "./register-DuVdzxbq.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 { i as joystickVector, n as attachTouchControls, t as TouchControls } from "./touch-DEAmqGdf.js";
-import { n as startRecording, r as auditScene, t as replay } from "./replay-BEHLDcQV.js";
+import { t as Rng } from "./rng-CDOMybym.js";
+import { c as getNodeSchema, f as mergeStaticSignals, i as joystickVector, l as getNodeSignals, m as registeredTypes, n as attachTouchControls, o as clearRegistry, p as registerNode, s as createNode, t as TouchControls, u as getNodeType } from "./touch-BnCyPA0G.js";
+import { n as startRecording, r as auditScene, t as replay } from "./replay-DEvp3kyV.js";
 import { t as showBootFailure } from "./boot-failure-CKYrEcGF.js";
-import { a as logText, i as logReport, o as parseDrive, r as resolveRendering, t as isWebGLAvailable } from "./webgl-unavailable-Z5_g8x9H.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-CYEu-_S9.js";
-import { t as duplicateNode } from "./duplicate-Dj4L-5AA.js";
+import { a as logText, i as logReport, o as parseDrive, r as resolveRendering, t as isWebGLAvailable } from "./webgl-unavailable-C8aDbGmR.js";
+import { t as createNoise2D } from "./noise-D3nPpmFg.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-CqR2o3SA.js";
+import { a as findPath, i as preloadUrls, n as assetUrls, o as gridFromRows, r as preloadSceneAssets, t as VERSION } from "./src-_jk0qLsS.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, isWebGLAvailable, 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, showBootFailure, spatialGain, spatialPan, startRecording, suggestLocale, suggestQuality, synthSfx, translationKey };

package/dist/json-CfTjpvW8.js

@@ -0,0 +1,67 @@
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
+	return target;
+};
+//#endregion
+//#region src/core/json.ts
+var json_exports = /* @__PURE__ */ __exportAll({
+	jsonClone: () => jsonClone,
+	jsonEquals: () => jsonEquals,
+	jsonKind: () => jsonKind,
+	parseJsonText: () => parseJsonText
+});
+/**
+* `JSON.parse`, minus the byte nobody can see.
+*
+* A UTF-8 byte order mark is legal in a UTF-8 file and meaningless in it, and
+* `JSON.parse` refuses it. Windows PowerShell 5.1's `Set-Content` writes one by
+* default and several editors add it on "save as UTF-8", so a scene written by
+* an ordinary tool came back as
+*
+* ```
+* [BAD_JSON] Unexpected token '\uFEFF', "\uFEFF{ "format"... is not valid JSON
+* ```
+*
+* about a character that is ZERO WIDTH: the author sees valid JSON, an error
+* pointing at nothing, and no way forward. Node's own `require()` of a .json
+* file has stripped it for a decade; `JSON.parse` is the one door that does not.
+*/
+function parseJsonText(text) {
+	return JSON.parse(text.charCodeAt(0) === 65279 ? text.slice(1) : text);
+}
+function jsonKind(value) {
+	if (value === null) return "null";
+	if (Array.isArray(value)) return "array";
+	const t = typeof value;
+	if (t === "string" || t === "number" || t === "boolean") return t;
+	return "object";
+}
+/** Deep structural equality over JSON values (used for delta-only serialization). */
+function jsonEquals(a, b) {
+	if (a === b) return true;
+	if (Array.isArray(a) && Array.isArray(b)) return a.length === b.length && a.every((v, i) => jsonEquals(v, b[i]));
+	if (a !== null && b !== null && typeof a === "object" && typeof b === "object") {
+		if (Array.isArray(a) || Array.isArray(b)) return false;
+		const ka = Object.keys(a);
+		const kb = Object.keys(b);
+		return ka.length === kb.length && ka.every((k) => k in b && jsonEquals(a[k], b[k]));
+	}
+	return false;
+}
+/**
+* Deep clone of JSON-safe data (defaults must never be shared between
+* instances). The value must contain only JSON types.
+*/
+function jsonClone(value) {
+	if (value === null || typeof value !== "object") return value;
+	return JSON.parse(JSON.stringify(value));
+}
+//#endregion
+export { parseJsonText as a, json_exports as i, jsonEquals as n, __exportAll as o, jsonKind as r, jsonClone as t };

package/dist/{loader-DadV2QCT.d.ts → loader-8-IHvbKD.d.ts}

@@ -1,5 +1,5 @@
-import { P as Scene, b as Engine } from "./behavior-rm8vVzu_.js";
-import { i as SceneJson } from "./schema-B6ugCV1Q.js";
+import { P as Scene, b as Engine } from "./behavior-Dcz0fr1S.js";
+import { a as SceneJson } from "./rng-Bb-IutXB.js";
 
 //#region src/core/scene/loader.d.ts
 interface LoadSceneOptions {

package/dist/net.d.ts

@@ -1,5 +1,6 @@
-import { d as PropSchema, jt as Node } from "./behavior-rm8vVzu_.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-Cg76MCV5.js";
+import { d as PropSchema, jt as Node } from "./behavior-Dcz0fr1S.js";
+import { t as DiagnosticSink } from "./diagnostics-Cu85N3tL.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-CIYf1zSf.js";
 
 //#region src/net/agent8.d.ts
 /**
@@ -22,7 +23,7 @@ declare function createAgent8Server(config?: {
   verse?: string;
   account?: string;
   auth?: string;
-}): Promise<NetworkTransport>;
+}, diagnostics?: DiagnosticSink | null): Promise<NetworkTransport>;
 //#endregion
 //#region src/net/nodes/network-spawner.d.ts
 /**
@@ -48,6 +49,8 @@ declare class NetworkSpawner extends Node {
   private readonly positionTargets;
   private readonly failedKeys;
   private readonly reported;
+  /** Seconds spent looking for a NetworkManager — see the report in `update`. */
+  private waited;
   override update(dt: number): void;
   private currentEntries;
   /**
@@ -63,6 +66,27 @@ declare class NetworkSpawner extends Node {
   /** Say it ONCE per message — a per-frame repeat would drown the log. */
   private report;
   private setProp;
+  /**
+  * What the NETWORK last said this node's position is — not where it is drawn.
+  *
+  * A remote copy renders slightly in the past, chasing its target at
+  * ~12.5%/frame. That is the right way to draw one and the wrong way to
+  * COMPARE one: `incanto-multiplay`'s `agrees` rung read the rendered
+  * position, so a late joiner whose interpolation had not converged was
+  * reported as disagreeing with the owner —
+  *
+  *   ✗ late has p1's `position` as [-3.3465…], not [-3.3989…]
+  *
+  * — on both SHIPPED 2D multiplayer examples, which exit 1 today on the plain
+  * documented command. The size of the "disagreement" is the player's speed
+  * times the chase lag, so a faster game fails harder while replicating
+  * perfectly.
+  *
+  * `undefined` when this spawner has no target for that node: it is not one of
+  * ours, or `interpolate` is off, in which case the drawn value IS the
+  * received one.
+  */
+  replicatedPosition(node: Node): number[] | undefined;
   private stepInterpolation;
 }
 //#endregion

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-CauMwu6y.js";
+import { n as createAgent8Server } from "./agent8-Cfmd3ar_.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-eULetcg-.js";
 export { LocalGameServer, LocalGameServerTransport, LoopbackHub, LoopbackTransport, NetworkManager, NetworkSpawner, applySyncPatch, createAgent8Server, createLocalGameServer, createSplitScreen, registerNodesNet };

package/dist/{noise-CGUMx44x.js → noise-D3nPpmFg.js}

@@ -1,4 +1,4 @@
-import { t as Rng } from "./rng-DP-SR7eg.js";
+import { t as Rng } from "./rng-CDOMybym.js";
 //#region src/core/noise.ts
 /** Skewing factors for 2D simplex: F2 = (√3−1)/2, G2 = (3−√3)/6. */
 const F2 = .5 * (Math.sqrt(3) - 1);