incanto 0.58.0 → 0.59.0

package/dist/{register-Ch70uByv.js → register-CDrAQqPp.js}

@@ -1,7 +1,8 @@
-import { C as diagnose, M as Signal, S as Node, _ as createSaveStore, b as resolveOrderGroups, h as restoreBehaviors, m as captureBehaviors, v as ORDER_GROUP_BASE, x as InputMap } from "./loader-BcrRSjxB.js";
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
+import { C as Node, N as Signal, S as InputMap, g as restoreBehaviors, h as captureBehaviors, v as createSaveStore, w as diagnose, x as resolveOrderGroups, y as ORDER_GROUP_BASE } from "./loader-D8n7TU8W.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as Rng } from "./rng-DP-SR7eg.js";
-import { l as registerNode } from "./registry-C7u42TID.js";
+import { l as registerNode } from "./registry-WWcQcfMr.js";
 //#region src/core/audio/buses.ts
 const AUDIO_LOG_LIMIT = 200;
 var AudioBuses = class {
@@ -1160,6 +1161,18 @@ var Localization = class {
 		const key = translationKey(value);
 		return key === null ? value : this.t(key, params);
 	}
+	/**
+	* Whether the ACTIVE locale or the base declares this key.
+	*
+	* This is the runtime question, and it is not the same as `has`: a key only
+	* `ko` declares is "declared", and an English player still gets the raw key
+	* back from `t()`, because the fallback chain is current → base → the key.
+	* Widgets that ask before translating asked the wrong one and painted
+	* `settings.quality.low` into an English menu.
+	*/
+	declares(key) {
+		return this.tables[this.current]?.[key] !== void 0 || this.tables["en"]?.[key] !== void 0;
+	}
 	/** Whether any locale declares this key — for the audit, not for the runtime. */
 	has(key) {
 		for (const entries of Object.values(this.tables)) if (entries[key] !== void 0) return true;
@@ -1182,6 +1195,22 @@ function suggestLocale(available, languages) {
 	}
 	return "en";
 }
+/**
+* Resolve a text prop on ANY node, not just a DOM HUD widget.
+*
+* `@t:` was honoured in exactly one place — `HudWidgetBase._t` — so text that
+* lives in the WORLD had no localization path at all: a `Label3D` reading
+* `"@t:sign.welcome"` rasterized those literal characters into the texture
+* standing over the shop door, in every language, and the audit certified the
+* scene clean because the key WAS declared.
+*
+* Returns the value untouched when there is no tree yet or no marker, so it is
+* safe to call from a rasterize path that runs before the node is in a scene.
+*/
+function translateOn(node, value) {
+	const locale = node.tree?.engine?.locale;
+	return locale ? locale.resolve(value) : value;
+}
 //#endregion
 //#region src/core/nodes/hud.ts
 const ANCHOR_CSS = {
@@ -1536,6 +1565,33 @@ var HudWidgetBase = class extends Node {
 		const locale = this.tree?.engine?.locale;
 		return locale ? locale.resolve(value) : value;
 	}
+	/**
+	* A translation with an English wording to fall back to.
+	*
+	* For text the ENGINE supplies — "Music", "Mute", "Unlimited" — where there
+	* is no author string to carry a `@t:` marker. Asks `declares()`, not
+	* `has()`: a key only another locale declares would otherwise come back as
+	* the raw key, which is worse than the English.
+	*/
+	/**
+	* What this widget's label READS as — resolved every frame, never stored.
+	*
+	* `UiVolumeSlider` and `UiMuteToggle` used to compute their auto-label in
+	* `_build()` and write the result back into `this.label`, which broke them
+	* twice over: the per-frame `_t(this.label)` then had a plain string with no
+	* marker left to resolve, and `_build` runs from `onReady` — inside
+	* `loadScene`, BEFORE `setScene` merges the scene's `strings` — so the table
+	* was empty at bake time and the English was permanent even for a game that
+	* boots in another language.
+	*/
+	_labelText() {
+		const label = this.label;
+		return typeof label === "string" ? this._t(label) : "";
+	}
+	_tOr(key, fallback) {
+		const locale = this.tree?.engine?.locale;
+		return locale?.declares(key) ? locale.t(key) : fallback;
+	}
 };
 /** A text line (score, timer, hints). Set `.text` from behaviors. */
 var UiText = class extends HudWidgetBase {
@@ -2126,7 +2182,7 @@ var Settings = class {
 	* without knowing this class exists. Returns the unsubscribe.
 	*/
 	bindLocale(locale) {
-		locale.locale = this.values.language;
+		locale.locale = this.store.get("language", "") || suggestLocale(locale.available());
 		return locale.changed.connect((next) => {
 			this.set("language", next);
 		});
@@ -2229,6 +2285,7 @@ function qualityRendering(tier) {
 }
 //#endregion
 //#region src/core/engine.ts
+var engine_exports = /* @__PURE__ */ __exportAll({ Engine: () => Engine });
 const MAX_DT_SECONDS = .25;
 function rafScheduler(cb) {
 	let live = true;
@@ -3193,17 +3250,6 @@ function px(n) {
 	return `${n}px`;
 }
 /**
-* The translated string, or the English one.
-*
-* `locale.t` returns the KEY when nothing declares it, and a menu reading
-* `settings.volume.music` is worse than one reading `Music`. English is the
-* base language and the fallback, always.
-*/
-function translated(engine, key, fallback) {
-	const locale = engine?.locale;
-	return locale?.has(key) ? locale.t(key) : fallback;
-}
-/**
 * A box that holds other widgets — the thing a menu actually is.
 *
 * Widgets normally mount into their HudLayer's anchor slot, which is why a
@@ -3377,7 +3423,7 @@ var UiSlider = class extends HudWidgetBase {
 		const wrap = document.createElement("div");
 		wrap.style.cssText = "display:flex;align-items:center;gap:8px;pointer-events:auto;font:600 13px system-ui,-apple-system,'Segoe UI',sans-serif;color:#fff;";
 		const text = document.createElement("span");
-		text.textContent = this._t(this.label);
+		text.textContent = this._labelText();
 		const input = document.createElement("input");
 		input.type = "range";
 		input.min = String(this.min);
@@ -3390,7 +3436,7 @@ var UiSlider = class extends HudWidgetBase {
 			this.last = this.value;
 			this.emit("changed", this.value);
 		});
-		if (this.label) wrap.appendChild(text);
+		if (this._labelText()) wrap.appendChild(text);
 		wrap.appendChild(input);
 		this.input = input;
 		this.text = text;
@@ -3402,7 +3448,7 @@ var UiSlider = class extends HudWidgetBase {
 			this.last = this.value;
 			this.input.value = String(this.value);
 		}
-		const label = this._t(this.label);
+		const label = this._labelText();
 		if (this.text && this.text.textContent !== label) this.text.textContent = label;
 	}
 };
@@ -3442,9 +3488,9 @@ var UiToggle = class extends HudWidgetBase {
 			this.emit("changed", this.value);
 		});
 		const text = document.createElement("span");
-		text.textContent = this._t(this.label);
+		text.textContent = this._labelText();
 		this.tag = text;
-		this.lastLabel = this._t(this.label);
+		this.lastLabel = this._labelText();
 		wrap.append(input, text);
 		this.input = input;
 		this.last = this.value;
@@ -3457,7 +3503,7 @@ var UiToggle = class extends HudWidgetBase {
 			this.last = this.value;
 			this.input.checked = this.value;
 		}
-		const label = this._t(this.label);
+		const label = this._labelText();
 		if (this.tag && label !== this.lastLabel) {
 			this.lastLabel = label;
 			this.tag.textContent = label;
@@ -3507,24 +3553,33 @@ var UiSelect = class extends HudWidgetBase {
 			this.last = this.value;
 			this.emit("changed", this.value);
 		});
-		if (this.label) wrap.appendChild(text);
+		if (this._labelText()) wrap.appendChild(text);
 		wrap.appendChild(select);
 		this.select = select;
 		this.fillOptions();
 		return wrap;
 	}
-	/** Override point: what an option READS as, when it differs from its value. */
+	/**
+	* What an option READS as, when it differs from its value.
+	*
+	* The base resolves `@t:` like every other text prop: the VALUE stays exactly
+	* what the author wrote — so a `changed` handler never has to know the active
+	* language — and only the displayed words change. Without this a dropdown was
+	* the one widget with no way to speak anything but English, and
+	* `"options": "@t:diff.easy"` rendered that marker literally on screen.
+	*/
 	_optionLabel(value) {
-		return value;
+		return this._t(value);
 	}
 	fillOptions() {
 		const select = this.select;
-		if (!select || this.options === this.lastOptions) return;
-		this.lastOptions = this.options;
+		if (!select) return;
+		const values = this.options.split(",").map((o) => o.trim()).filter(Boolean);
+		const painted = values.map((v) => `${v}\u0000${this._optionLabel(v)}`).join("
");
+		if (painted === this.lastOptions) return;
+		this.lastOptions = painted;
 		select.textContent = "";
-		for (const raw of this.options.split(",")) {
-			const value = raw.trim();
-			if (!value) continue;
+		for (const value of values) {
 			const option = document.createElement("option");
 			option.value = value;
 			option.textContent = this._optionLabel(value);
@@ -3635,9 +3690,6 @@ var UiSettingSelect = class extends UiSelect {
 	* `settings.quality.high` is worse than one reading `High`. English is the
 	* base language and the fallback, always.
 	*/
-	_tOr(key, fallback) {
-		return translated(this._engine(), key, fallback);
-	}
 	_sync() {
 		const engine = this._engine();
 		if (engine) {
@@ -3807,12 +3859,10 @@ var UiVolumeSlider = class extends UiSlider {
 	bus = "master";
 	/** Last value we PUSHED in, to tell an engine-side change from a player drag. */
 	lastPushed = null;
-	_build() {
-		if (!this.label) {
-			const english = VOLUME_LABELS[this.bus] ?? VOLUME_LABELS.master;
-			this.label = translated(this.tree?.engine ?? null, `settings.volume.${this.bus}`, english);
-		}
-		return super._build();
+	_labelText() {
+		if (this.label) return this._t(this.label);
+		const english = VOLUME_LABELS[this.bus] ?? VOLUME_LABELS.master;
+		return this._tOr(`settings.volume.${this.bus}`, english);
 	}
 	_sync() {
 		const audio = this.tree?.engine?.audio;
@@ -3846,9 +3896,8 @@ var UiMuteToggle = class extends UiToggle {
 		label: { default: "" }
 	};
 	lastPushed = null;
-	_build() {
-		if (!this.label) this.label = translated(this.tree?.engine ?? null, "settings.mute", "Mute");
-		return super._build();
+	_labelText() {
+		return this.label ? this._t(this.label) : this._tOr("settings.mute", "Mute");
 	}
 	_sync() {
 		const audio = this.tree?.engine?.audio;
@@ -3894,4 +3943,4 @@ function registerCoreNodes() {
 	registerNode(UiMuteToggle);
 }
 //#endregion
-export { UiText as A, spatialPan as B, suggestQuality as C, HudWidgetBase as D, HudLayer as E, translationKey as F, WebAudioMusicBackend as G, SFX_PRESET_NAMES as H, SfxEngine as I, AudioBuses as J, crossfadeGains as K, isAudioContextAvailable as L, Localization as M, T_PREFIX as N, UiBanner as O, suggestLocale as P, ROLLOFF_MODELS as R, readDeviceHints as S, EffectLog as T, synthSfx as U, SFX_PRESETS as V, MusicManager as W, Engine as _, UiMuteToggle as a, qualityEnvironment as b, UiRenderScaleSelect as c, UiToggle as d, UiVolumeSlider as f, AudioPlayer as g, UiDialogue as h, UiLanguageSelect as i, BASE_LOCALE as j, UiBar as k, UiSelect as l, UiButton as m, UiFrameCapSelect as n, UiPanel as o, Timer as p, fadeGain as q, UiImage as r, UiQualitySelect as s, registerCoreNodes as t, UiSlider as u, Settings as v, LogManager as w, qualityRendering as x, qualityCaps as y, spatialGain as z };
+export { UiBar as A, ROLLOFF_MODELS as B, readDeviceHints as C, HudLayer as D, EffectLog as E, suggestLocale as F, synthSfx as G, spatialPan as H, translateOn as I, crossfadeGains as J, MusicManager as K, translationKey as L, BASE_LOCALE as M, Localization as N, HudWidgetBase as O, T_PREFIX as P, SfxEngine as R, qualityRendering as S, LogManager as T, SFX_PRESETS as U, spatialGain as V, SFX_PRESET_NAMES as W, AudioBuses as X, fadeGain as Y, Engine as _, UiMuteToggle as a, qualityCaps as b, UiRenderScaleSelect as c, UiToggle as d, UiVolumeSlider as f, AudioPlayer as g, UiDialogue as h, UiLanguageSelect as i, UiText as j, UiBanner as k, UiSelect as l, UiButton as m, UiFrameCapSelect as n, UiPanel as o, Timer as p, WebAudioMusicBackend as q, UiImage as r, UiQualitySelect as s, registerCoreNodes as t, UiSlider as u, engine_exports as v, suggestQuality as w, qualityEnvironment as x, Settings as y, isAudioContextAvailable as z };

package/dist/{registry-C7u42TID.js → registry-WWcQcfMr.js}

@@ -1,5 +1,5 @@
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
-import { r as jsonKind, t as jsonClone } from "./json-BLk7H2Qa.js";
+import { r as jsonKind, t as jsonClone } from "./json-CwwhxQgb.js";
 //#region src/core/registry.ts
 /**
 * Validate a prop value against its schema default:

package/dist/{replay-s7I2GstT.js → replay-CEPyQtF_.js}

@@ -1,6 +1,6 @@
-import { E as behaviorSchema, w as parseNodePath } from "./loader-BcrRSjxB.js";
-import { D as HudWidgetBase, F as translationKey } from "./register-Ch70uByv.js";
-import { i as getNodeSchema, o as getNodeType } from "./registry-C7u42TID.js";
+import { D as behaviorSchema, T as parseNodePath } from "./loader-D8n7TU8W.js";
+import { L as translationKey, O as HudWidgetBase } from "./register-CDrAQqPp.js";
+import { i as getNodeSchema, o as getNodeType } from "./registry-WWcQcfMr.js";
 //#region src/core/node-refs.ts
 /**
 * Node-path PROPS, resolved against scene JSON.
@@ -317,15 +317,28 @@ function auditScene(scene) {
 * screen. Reported here — at author time, where it can still be fixed — rather
 * than at runtime in front of someone playing.
 */
+/**
+* Close to `@t:` without being it — `@T:`, a leading space, `@t :`, `@t.`.
+* Deliberately narrow: an at-sign in ordinary prose ("email me @ home") must
+* not trip it.
+*/
+const NEAR_MISS = /^\s*@\s*t\s*[:.]/i;
 function auditStrings(scene) {
 	const tables = scene.strings;
 	const declared = /* @__PURE__ */ new Set();
 	for (const entries of Object.values(tables ?? {})) for (const key of Object.keys(entries)) declared.add(key);
+	const inBase = new Set(Object.keys(tables?.["en"] ?? {}));
 	const missing = /* @__PURE__ */ new Set();
+	const notInEnglish = /* @__PURE__ */ new Set();
+	const nearMiss = /* @__PURE__ */ new Set();
 	const walk = (value) => {
 		if (typeof value === "string") {
+			if (translationKey(value) === null && NEAR_MISS.test(value)) nearMiss.add(value);
 			const key = translationKey(value);
-			if (key !== null && !declared.has(key)) missing.add(key);
+			if (key !== null) {
+				if (!declared.has(key)) missing.add(key);
+				else if (tables && !inBase.has(key)) notInEnglish.add(key);
+			}
 			return;
 		}
 		if (Array.isArray(value)) {
@@ -335,9 +348,20 @@ function auditStrings(scene) {
 		if (value !== null && typeof value === "object") for (const item of Object.values(value)) walk(item);
 	};
 	walk(scene.root);
-	if (missing.size === 0) return [];
-	const listed = [...missing].sort();
-	return [`${listed.length} translation key${listed.length === 1 ? "" : "s"} nothing declares: ${listed.join(", ")}. The key itself renders on screen. Add them under "strings": { "en": { ... } } — other locales may omit any of them and fall back to English.`];
+	const out = [];
+	if (missing.size > 0) {
+		const listed = [...missing].sort();
+		out.push(`${listed.length} translation key${listed.length === 1 ? "" : "s"} nothing declares: ${listed.join(", ")}. The key itself renders on screen. Add them under "strings": { "en": { ... } } — other locales may omit any of them and fall back to English.`);
+	}
+	if (nearMiss.size > 0) {
+		const listed = [...nearMiss].sort();
+		out.push(`${listed.length} value${listed.length === 1 ? "" : "s"} look${listed.length === 1 ? "s" : ""} like a translation marker but ${listed.length === 1 ? "is" : "are"} not: ${listed.map((v) => JSON.stringify(v)).join(", ")}. It must be exactly "@t:key" — lower-case, no space. As written, the text itself renders on screen.`);
+	}
+	if (notInEnglish.size > 0) {
+		const listed = [...notInEnglish].sort();
+		out.push(`${listed.length} translation key${listed.length === 1 ? "" : "s"} missing from "en": ${listed.join(", ")}. English is the base every other locale falls back to, so these render as the raw key for anyone not using the locale that declares them.`);
+	}
+	return out;
 }
 //#endregion
 //#region src/core/replay.ts

package/dist/{replay-Dw6gMlYA.d.ts → replay-O-yAGM76.d.ts}

@@ -1,4 +1,4 @@
-import { b as Engine } from "./behavior-l08AEbq9.js";
+import { b as Engine } from "./behavior-DWKTUzKI.js";
 import { s as JsonObject } from "./schema-CFeioQRE.js";
 
 //#region src/core/audit.d.ts

package/dist/{split-screen-B0baBwxI.d.ts → split-screen-BQ3tAsf-.d.ts}

@@ -1,5 +1,6 @@
-import { At as Node, It as Signal, b as Engine } from "./behavior-l08AEbq9.js";
+import { At as Node, It as Signal, b as Engine } from "./behavior-DWKTUzKI.js";
 import { c as JsonValue, i as SceneJson, s as JsonObject } from "./schema-CFeioQRE.js";
+import { t as LoadSceneOptions } from "./loader-TvkRFbyL.js";
 
 //#region src/net/types.d.ts
 type Unsubscribe = () => void;
@@ -277,6 +278,17 @@ interface NetworkManagerOptions {
   };
   /** Replication send window in ms (default 50; node `network.throttleMs` can lower it). */
   throttleMs?: number;
+  /**
+  * How often the FULL sync set is re-sent regardless of what changed, in ms
+  * (default 2000; 0 disables).
+  *
+  * Deltas are right on the wire and wrong in the store: backends shallow-merge
+  * one level down, so each send replaces the whole `sync` object and a key
+  * that stopped changing is erased from the authoritative state. A keyframe
+  * puts it back — for the next joiner, and for a send that never reached the
+  * wire, which is never retried.
+  */
+  keyframeMs?: number;
 }
 /**
 * Per-engine multiplayer hub: joins a room, exposes the room channels as core
@@ -308,6 +320,7 @@ declare class NetworkManager {
   private readonly server;
   private readonly engine;
   private readonly throttleMs;
+  private readonly keyframeMs;
   private readonly subs;
   private readonly messageSignals;
   private readonly collectionSignals;
@@ -320,8 +333,23 @@ declare class NetworkManager {
   /** Sync keys already reported unreadable, so a per-frame send says it once. */
   private readonly reportedDeadKeys;
   /** Name a sync key the owner cannot read — a typo in the prop or the path. */
+  /**
+  * A sync key that has NEVER been readable, reported once — after a grace
+  * period.
+  *
+  * Behaviours set their props in `onReady`/`update`, and replication runs on
+  * the fixed step, so a perfectly correct key reads as `undefined` on the
+  * first pass or two. Reporting immediately made the engine's own co-op
+  * example print "sync key 'firing' … it is never sent" about a key that is
+  * sent from frame 2 onward — a diagnostic that cries wolf teaches its reader
+  * to ignore the one that does not.
+  */
   private reportDeadSyncKey;
   private sendAccumulator;
+  /** Simulated ms since the last time the FULL sync set went out. */
+  private keyframeAccumulator;
+  /** Simulated ms this manager has been replicating — see reportDeadSyncKey. */
+  private aliveMs;
   private detachReplication;
   private lastOwner;
   private boundScene;
@@ -399,6 +427,15 @@ interface SplitScreenOptions extends LocalGameServerOptions {
   /** Engine seed base (each panel gets seed + index). */
   seed?: number;
   /**
+  * Loader options, per panel — `stubMissingBehaviors` for a headless check
+  * that has no TypeScript, `resolveScene` for `instance:` sub-scenes.
+  *
+  * Without these, `createSplitScreen` hard-failed on any real game: it called
+  * `loadScene` with nothing registered, so a scene naming one of its own
+  * behaviours threw `Unknown behavior` before a single frame ran.
+  */
+  load?: LoadSceneOptions;
+  /**
   * The room every panel joins. Default: whatever the FIRST panel got.
   *
   * A shared scene usually says `multiplayer: { room: "auto" }`, and "auto"

package/dist/{split-screen-DLsUrleX.js → split-screen-DDMZutQ6.js}

@@ -1,8 +1,8 @@
-import { C as diagnose, M as Signal, S as Node, n as loadScene, t as buildNodeJson } from "./loader-BcrRSjxB.js";
-import { _ as Engine, t as registerCoreNodes } from "./register-Ch70uByv.js";
+import { C as Node, N as Signal, n as loadScene, t as buildNodeJson, w as diagnose } from "./loader-D8n7TU8W.js";
+import { _ as Engine, t as registerCoreNodes } from "./register-CDrAQqPp.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
-import { n as jsonEquals, t as jsonClone } from "./json-BLk7H2Qa.js";
-import { l as registerNode } from "./registry-C7u42TID.js";
+import { n as jsonEquals, t as jsonClone } from "./json-CwwhxQgb.js";
+import { l as registerNode } from "./registry-WWcQcfMr.js";
 //#region src/net/loopback.ts
 /**
 * In-memory multiplayer hub implementing the SAME kernel contract as
@@ -771,6 +771,15 @@ var LocalGameServerTransport = class {
 };
 //#endregion
 //#region src/net/network-manager.ts
+/**
+* How long a sync key may read as `undefined` before it is called dead.
+*
+* Long enough for `onReady` and a few `update`s to have run; short enough that
+* a genuinely wrong prop name is named while its author is still looking.
+*/
+const DEAD_KEY_GRACE_MS = 500;
+/** Full-state resend interval, in simulated ms. See `keyframeMs`. */
+const DEFAULT_KEYFRAME_MS = 2e3;
 const managers = /* @__PURE__ */ new WeakMap();
 /**
 * Per-engine multiplayer hub: joins a room, exposes the room channels as core
@@ -802,6 +811,7 @@ var NetworkManager = class NetworkManager {
 	server;
 	engine;
 	throttleMs;
+	keyframeMs;
 	subs = [];
 	messageSignals = /* @__PURE__ */ new Map();
 	collectionSignals = /* @__PURE__ */ new Map();
@@ -814,12 +824,28 @@ var NetworkManager = class NetworkManager {
 	/** Sync keys already reported unreadable, so a per-frame send says it once. */
 	reportedDeadKeys = /* @__PURE__ */ new Set();
 	/** Name a sync key the owner cannot read — a typo in the prop or the path. */
+	/**
+	* A sync key that has NEVER been readable, reported once — after a grace
+	* period.
+	*
+	* Behaviours set their props in `onReady`/`update`, and replication runs on
+	* the fixed step, so a perfectly correct key reads as `undefined` on the
+	* first pass or two. Reporting immediately made the engine's own co-op
+	* example print "sync key 'firing' … it is never sent" about a key that is
+	* sent from frame 2 onward — a diagnostic that cries wolf teaches its reader
+	* to ignore the one that does not.
+	*/
 	reportDeadSyncKey(owner, key) {
 		if (this.reportedDeadKeys.has(key)) return;
+		if (this.aliveMs < DEAD_KEY_GRACE_MS) return;
 		this.reportedDeadKeys.add(key);
 		diagnose(owner.tree?.engine ?? null, "error", `[incanto] ${owner.getPath()}: sync key '${key}' reads as undefined — it is never sent, so remote players never see it change. Check the prop name and the node path.`);
 	}
 	sendAccumulator = 0;
+	/** Simulated ms since the last time the FULL sync set went out. */
+	keyframeAccumulator = 0;
+	/** Simulated ms this manager has been replicating — see reportDeadSyncKey. */
+	aliveMs = 0;
 	detachReplication = null;
 	lastOwner = null;
 	boundScene = null;
@@ -831,16 +857,17 @@ var NetworkManager = class NetworkManager {
 		const server = opts.transport ?? await createDefaultTransport(opts.config);
 		await server.connect();
 		const requested = opts.room ?? engine.scene?.multiplayer?.room ?? "auto";
-		const manager = new NetworkManager(engine, server, await server.remoteFunction("joinRoom", [requested === "auto" ? void 0 : requested], { needResponse: true }), opts.throttleMs ?? 50);
+		const manager = new NetworkManager(engine, server, await server.remoteFunction("joinRoom", [requested === "auto" ? void 0 : requested], { needResponse: true }), opts.throttleMs ?? 50, opts.keyframeMs ?? DEFAULT_KEYFRAME_MS);
 		managers.set(engine, manager);
 		return manager;
 	}
-	constructor(engine, server, roomId, throttleMs) {
+	constructor(engine, server, roomId, throttleMs, keyframeMs) {
 		this.engine = engine;
 		this.server = server;
 		this.roomId = roomId;
 		this.account = server.account;
 		this.throttleMs = Math.max(30, throttleMs);
+		this.keyframeMs = Math.max(0, keyframeMs);
 		this.boundScene = engine.scene;
 		this.subs.push(server.subscribeRoomState(roomId, (state) => {
 			this.latestRoomState = state;
@@ -996,6 +1023,7 @@ var NetworkManager = class NetworkManager {
 		const scene = this.engine.scene;
 		if (!scene || scene !== this.boundScene) return;
 		this.sendAccumulator += dt * 1e3;
+		this.aliveMs += dt * 1e3;
 		const owner = findOwnerNode(scene.root, true);
 		if (!owner) return;
 		if (owner !== this.lastOwner) {
@@ -1005,22 +1033,29 @@ var NetworkManager = class NetworkManager {
 		const net = owner.network;
 		const window = Math.max(30, typeof net.throttleMs === "number" ? net.throttleMs : this.throttleMs);
 		const syncKeys = Array.isArray(net.sync) ? net.sync : [];
-		const patch = {};
+		const full = {};
+		let changed = false;
 		for (const key of syncKeys) {
 			const value = readSyncKey(owner, key);
 			if (value === void 0) {
 				this.reportDeadSyncKey(owner, key);
 				continue;
 			}
-			if (!jsonEquals(this.lastSent.get(key) ?? null, value)) patch[key] = jsonClone(value);
+			full[key] = jsonClone(value);
+			if (!jsonEquals(this.lastSent.get(key) ?? null, value)) changed = true;
 		}
+		this.keyframeAccumulator += dt * 1e3;
+		const keyframeDue = this.keyframeMs > 0 && this.keyframeAccumulator >= this.keyframeMs;
 		if (this.sendAccumulator < window) return;
-		if (Object.keys(patch).length === 0) return;
-		for (const [key, value] of Object.entries(patch)) this.lastSent.set(key, jsonClone(value));
+		if (!changed && !keyframeDue) return;
+		if (Object.keys(full).length === 0) return;
+		for (const [key, value] of Object.entries(full)) this.lastSent.set(key, jsonClone(value));
+		this.keyframeAccumulator = 0;
 		this.sendAccumulator = 0;
-		this.setMyState({ sync: patch });
+		this.setMyState({ sync: full });
 	}
 };
+/** The single `network.mode === 'owner'` node in a tree, or null. @internal */
 function findOwnerNode(node, enforceSingle = false) {
 	const owners = [];
 	collectOwners(node, owners);
@@ -1032,6 +1067,13 @@ function collectOwners(node, out) {
 	for (const c of node.children) collectOwners(c, out);
 }
 /** `'position'` → own prop; `'Sprite.animation'` → child path + prop (last dot splits). */
+/**
+* Read one `network.sync` key off an owner node, exactly as the sender does.
+*
+* Exported so an agreement check reads GROUND TRUTH through the same last-dot
+* split the protocol uses — a second implementation would eventually disagree
+* with this one, and then the check would be measuring itself.
+*/
 function readSyncKey(node, key) {
 	const lastDot = key.lastIndexOf(".");
 	const target = lastDot === -1 ? node : node.getNodeOrNull(key.slice(0, lastDot)) ?? void 0;
@@ -1176,6 +1218,7 @@ var NetworkSpawner = class extends Node {
 		}
 	}
 };
+/** The child name a spawner gives an account's instance. @internal */
 function sanitizeName(key) {
 	return key.replace(/[/%]/g, "_") || "remote";
 }
@@ -1218,7 +1261,7 @@ async function createSplitScreen(opts) {
 	for (let i = 0; i < accounts.length; i++) {
 		const account = accounts[i];
 		const engine = new Engine(opts.seed !== void 0 ? { seed: opts.seed + i } : {});
-		engine.setScene(loadScene(jsonClone(opts.scene)));
+		engine.setScene(loadScene(jsonClone(opts.scene), opts.load));
 		const manager = await NetworkManager.create(engine, {
 			transport: server.createClient(account),
 			...opts.room !== void 0 || i > 0 ? { room: opts.room ?? players[0].manager.roomId } : {}
@@ -1275,4 +1318,4 @@ function hasBodyNamed(node, base) {
 	return false;
 }
 //#endregion
-export { applySyncPatch as a, createLocalGameServer as c, NetworkManager as i, LoopbackHub as l, registerNodesNet as n, LocalGameServer as o, NetworkSpawner as r, LocalGameServerTransport as s, createSplitScreen as t, LoopbackTransport as u };
+export { NetworkManager as a, readSyncKey as c, createLocalGameServer as d, LoopbackHub as f, sanitizeName as i, LocalGameServer as l, registerNodesNet as n, applySyncPatch as o, LoopbackTransport as p, NetworkSpawner as r, findOwnerNode as s, createSplitScreen as t, LocalGameServerTransport as u };

package/dist/{sprite-animation-C0wXLBZJ.js → sprite-animation-CY-mrr1L.js}

@@ -1,5 +1,5 @@
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
-import { n as jsonEquals } from "./json-BLk7H2Qa.js";
+import { n as jsonEquals } from "./json-CwwhxQgb.js";
 //#region src/core/particle-presets.ts
 const PARTICLE_PRESETS = {
 	fire: {

package/dist/{src-C1J09Op6.js → src-CY21B462.js}

@@ -214,6 +214,6 @@ function newUid() {
 //#endregion
 //#region src/index.ts
 /** Engine version. Kept in sync with package.json by the release pipeline. */
-const VERSION = "0.58.0";
+const VERSION = "0.59.0";
 //#endregion
 export { preloadUrls as a, preloadSceneAssets as i, newUid as n, findPath as o, assetUrls as r, gridFromRows as s, VERSION as t };

package/dist/{teardown-Cs113S9F.js → teardown-RApWnM1G.js}

@@ -1,4 +1,4 @@
-import { g as AudioPlayer } from "./register-Ch70uByv.js";
+import { g as AudioPlayer } from "./register-CDrAQqPp.js";
 import { a as logReport, s as parseDrive } from "./touch-DESwnpOc.js";
 import { a as frameSignature, i as frameImage, o as frameStats } from "./frame-report-BSMny7oe.js";
 //#region src/core/audio-errors.ts