incanto 0.57.0 → 0.59.0

package/dist/{register-C6ZBFRjd.js → register-BpFcgdcL.js}

@@ -1,9 +1,9 @@
-import { C as diagnose, S as Node, y as effectiveOrder } from "./loader-BcrRSjxB.js";
-import { t as registerCoreNodes } from "./register-Ch70uByv.js";
+import { C as Node, b as effectiveOrder, w as diagnose } from "./loader-D8n7TU8W.js";
+import { I as translateOn, t as registerCoreNodes } from "./register-CDrAQqPp.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as Rng } from "./rng-DP-SR7eg.js";
-import { i as getNodeSchema, l as registerNode } from "./registry-C7u42TID.js";
-import { i as ParticleSim, n as resolveFrames, o as PARTICLE_PRESET_NAMES, r as validateAnimationAliases, s as applyParticlePreset, t as resolveAnimation } from "./sprite-animation-C0wXLBZJ.js";
+import { i as getNodeSchema, l as registerNode } from "./registry-WWcQcfMr.js";
+import { i as ParticleSim, n as resolveFrames, o as PARTICLE_PRESET_NAMES, r as validateAnimationAliases, s as applyParticlePreset, t as resolveAnimation } from "./sprite-animation-CY-mrr1L.js";
 import { t as checkSheetGrid } from "./sheet-grid-BT6N_Bjs.js";
 import { AdditiveBlending, BufferAttribute, BufferGeometry, CanvasTexture, Color, DynamicDrawUsage, Group, InstancedMesh, MathUtils, Matrix4, Mesh, MeshBasicMaterial, NearestFilter, NormalBlending, Object3D, PlaneGeometry, SRGBColorSpace } from "three";
 //#region src/2d/physics/collider-validate.ts
@@ -115,32 +115,51 @@ var Node2D = class extends Node {
 * `{shape:'capsule', radius, height}` — never child shape nodes.
 */
 var PhysicsBody2D = class extends Node2D {
-	static props = { collider: {
-		default: {},
-		variants: {
-			tag: "shape",
-			byTag: {
-				rect: {
-					shape: "rect",
-					size: [32, 32]
-				},
-				circle: {
-					shape: "circle",
-					radius: 16
-				},
-				capsule: {
-					shape: "capsule",
-					radius: 12,
-					height: 32
+	static props = {
+		collider: {
+			default: {},
+			variants: {
+				tag: "shape",
+				byTag: {
+					rect: {
+						shape: "rect",
+						size: [32, 32]
+					},
+					circle: {
+						shape: "circle",
+						radius: 16
+					},
+					capsule: {
+						shape: "capsule",
+						radius: 12,
+						height: 32
+					}
 				}
 			}
-		}
-	} };
+		},
+		/**
+		* Whether this body's collider takes part in physics right now.
+		*
+		* A melee hitbox is off most of the time and live for a few frames of a
+		* swing, and there was no way to say so: games expressed it by REPLACING
+		* `collider` with `{}`, which tears the rigid body down and builds a new
+		* one twice per swing, and makes the engine warn `has no collider —
+		* physics skips it` about a scene that is correct. Keep the real collider
+		* and turn it off.
+		*
+		* Off means no contacts and no `triggerEnter`/`triggerExit`. The body
+		* itself stays, so nothing is rebuilt and re-arming is one call.
+		*/
+		enabled: { default: true }
+	};
 	/** The unified collision model: every collider participant can emit these. */
 	static signals = ["triggerEnter", "triggerExit"];
 	_collider = {};
 	/** @internal Physics resync flag — raised when `collider` is REPLACED. */
 	_colliderChanged = false;
+	_enabled = true;
+	/** @internal Physics resync flag — raised when `enabled` is written. */
+	_enabledChanged = false;
 	/**
 	* Collider shape prop. Change it by REPLACING the object
 	* (`body.collider = { shape: 'box', size: [...] }`) — physics rebuilds the
@@ -153,6 +172,15 @@ var PhysicsBody2D = class extends Node2D {
 		this._collider = value;
 		this._colliderChanged = true;
 	}
+	/** See the `enabled` prop. Writing it arms or disarms the existing collider. */
+	get enabled() {
+		return this._enabled;
+	}
+	set enabled(value) {
+		if (value === this._enabled) return;
+		this._enabled = value;
+		this._enabledChanged = true;
+	}
 	/** Loader hook: bad collider shapes fail at LOAD, not at physics start. */
 	static validateJson(node) {
 		validateCollider2D(node.collider, node.name);
@@ -825,11 +853,12 @@ var Label = class extends Node2D {
 	_syncObject2D(assets) {
 		super._syncObject2D(assets);
 		const quad = this._quad();
-		if (typeof document === "undefined" || this.text === "") {
+		const text = translateOn(this, this.text);
+		if (typeof document === "undefined" || text === "") {
 			quad.visible = false;
 			return;
 		}
-		const key = `${this.text}\0${this.fontSize}\0${this.color}\0${this.font}\0${this.align}`;
+		const key = `${text}\0${this.fontSize}\0${this.color}\0${this.font}\0${this.align}`;
 		if (key !== this.lastKey) {
 			this.lastKey = key;
 			this.rasterize();
@@ -838,13 +867,14 @@ var Label = class extends Node2D {
 		quad.renderOrder = this.effectiveRenderOrder;
 	}
 	rasterize() {
+		const text = translateOn(this, this.text);
 		const dpr = Math.min(globalThis.devicePixelRatio ?? 1, 2);
 		this.canvas ??= document.createElement("canvas");
 		const ctx = this.canvas.getContext("2d");
 		if (!ctx) return;
 		const fontSpec = `${this.fontSize * dpr}px ${this.font}`;
 		ctx.font = fontSpec;
-		const metrics = ctx.measureText(this.text);
+		const metrics = ctx.measureText(text);
 		const w = Math.max(1, Math.ceil(metrics.width));
 		const h = Math.ceil(this.fontSize * dpr * 1.4);
 		this.canvas.width = w;
@@ -852,7 +882,7 @@ var Label = class extends Node2D {
 		ctx.font = fontSpec;
 		ctx.fillStyle = this.color;
 		ctx.textBaseline = "middle";
-		ctx.fillText(this.text, 0, h / 2);
+		ctx.fillText(text, 0, h / 2);
 		const quad = this._quad();
 		const mat = quad.material;
 		mat.map?.dispose();

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"