incanto 0.58.0 → 0.59.0

package/dist/gameplay.d.ts

@@ -1,4 +1,4 @@
-import { At as Node, b as Engine, d as PropSchema, n as BehaviorCtor, t as Behavior } from "./behavior-l08AEbq9.js";
+import { At as Node, b as Engine, d as PropSchema, n as BehaviorCtor, t as Behavior } from "./behavior-DWKTUzKI.js";
 import { c as JsonValue, s as JsonObject } from "./schema-CFeioQRE.js";
 
 //#region src/gameplay/chase.d.ts

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-BVphcxmE.js";
+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-BBEjPFsR.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 };

package/dist/index.d.ts

@@ -1,10 +1,10 @@
-import { $ as T_PREFIX, A as SettingsValues, At as Node, B as captureBehaviors, C as EngineStats, Ct as synthSfx, Dt as PlayMusicOptions, E as DeviceHints, Et as MusicTrack, F as BehaviorState, Ft as LogManager, G as ORDER_GROUP_BASE, H as savesWithoutUid, I as RestoreReport, It as Signal, J as effectiveOrder, K as OrderGroup, L as SaveSlot, Lt as SignalListener, M as readDeviceHints, Mt as SceneTree, N as suggestQuality, Nt as LogEntry, O as QualityTier, Ot as AudioBuses, P as Scene, Pt as LogLevel, Q as Localization, R as SaveSlots, S as Scheduler, St as SynthOptions, T as RendererStats, Tt as MusicManager, 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 NodeLifecycle, k as Settings, kt as BusName, 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 MusicBackend, x as EngineOptions, xt as SfxWave, y as registeredTypes, yt as SFX_PRESET_NAMES, z as behaviorsWithoutSave } from "./behavior-l08AEbq9.js";
+import { $ as T_PREFIX, A as SettingsValues, At as Node, B as captureBehaviors, C as EngineStats, Ct as synthSfx, Dt as PlayMusicOptions, E as DeviceHints, Et as MusicTrack, F as BehaviorState, Ft as LogManager, G as ORDER_GROUP_BASE, H as savesWithoutUid, I as RestoreReport, It as Signal, J as effectiveOrder, K as OrderGroup, L as SaveSlot, Lt as SignalListener, M as readDeviceHints, Mt as SceneTree, N as suggestQuality, Nt as LogEntry, O as QualityTier, Ot as AudioBuses, P as Scene, Pt as LogLevel, Q as Localization, R as SaveSlots, S as Scheduler, St as SynthOptions, T as RendererStats, Tt as MusicManager, 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 NodeLifecycle, k as Settings, kt as BusName, 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 MusicBackend, x as EngineOptions, xt as SfxWave, y as registeredTypes, yt as SFX_PRESET_NAMES, z as behaviorsWithoutSave } from "./behavior-DWKTUzKI.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-BbEMTuWg.js";
+import { n as loadScene, t as LoadSceneOptions } from "./loader-TvkRFbyL.js";
 import { i as resolveFrames, n as AnimationEntry, r as resolveAnimation, t as AnimationDef } from "./sprite-animation-CMr6f1K2.js";
 import { n as ParticleSimConfig, r as ParticleView, t as ParticleSim } from "./particle-sim-C5OfBbmU.js";
-import { a as AudioElementLike, i as gridFromRows, n as PathGrid, o as AudioPlayer, r as findPath, t as FindPathOptions } from "./pathfinding-mEN4V1CU.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-Dw6gMlYA.js";
+import { a as AudioElementLike, i as gridFromRows, n as PathGrid, o as AudioPlayer, r as findPath, t as FindPathOptions } from "./pathfinding-BqWBb0kh.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-O-yAGM76.js";
 
 //#region src/core/audio/crossfade.d.ts
 /**
@@ -398,6 +398,27 @@ declare abstract class HudWidgetBase extends Node {
   * `startsWith` and is returned untouched.
   */
   protected _t(value: string): string;
+  /**
+  * 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.
+  */
+  protected _labelText(): string;
+  protected _tOr(key: string, fallback: string): string;
 }
 /** A text line (score, timer, hints). Set `.text` from behaviors. */
 declare class UiText extends HudWidgetBase {
@@ -725,7 +746,15 @@ declare class UiSelect extends HudWidgetBase {
   private lastOptions;
   private last;
   protected _build(): HTMLElement;
-  /** 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.
+  */
   protected _optionLabel(value: string): string;
   private fillOptions;
   protected override _sync(): void;
@@ -786,7 +815,6 @@ 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 _tOr(key: string, fallback: string): string;
   protected override _sync(): void;
 }
 /**
@@ -881,7 +909,7 @@ declare class UiVolumeSlider extends UiSlider {
   bus: VolumeBus;
   /** Last value we PUSHED in, to tell an engine-side change from a player drag. */
   private lastPushed;
-  protected override _build(): HTMLElement;
+  protected override _labelText(): string;
   protected override _sync(): void;
 }
 /**
@@ -898,7 +926,7 @@ declare class UiMuteToggle extends UiToggle {
   static override readonly typeName: string;
   static override readonly props: PropSchema;
   private lastPushed;
-  protected override _build(): HTMLElement;
+  protected override _labelText(): string;
   protected override _sync(): void;
 }
 //#endregion

package/dist/index.js

@@ -1,13 +1,13 @@
-import { A as registerBehavior, D as behaviorSignals, E as behaviorSchema, M as Signal, O as clearBehaviors, S as Node, T as Behavior, _ as createSaveStore, a as SCENE_FORMAT, b as resolveOrderGroups, c as SceneTree, d as resolveConstants, f as SaveSlots, g as savesWithoutUid, h as restoreBehaviors, i as serializeNode, j as registeredBehaviors, k as getBehavior, l as CONST_REF_KEY, m as captureBehaviors, n as loadScene, o as computeViewport, p as behaviorsWithoutSave, r as Scene, s as resolveViewport, u as isConstRef, v as ORDER_GROUP_BASE, w as parseNodePath, x as InputMap, y as effectiveOrder } from "./loader-BcrRSjxB.js";
-import { A as UiText, B as spatialPan, C as suggestQuality, E as HudLayer, F as translationKey, G as WebAudioMusicBackend, H as SFX_PRESET_NAMES, I as SfxEngine, J as AudioBuses, K as crossfadeGains, L as isAudioContextAvailable, M as Localization, N as T_PREFIX, O as UiBanner, P as suggestLocale, R as ROLLOFF_MODELS, S as readDeviceHints, T as EffectLog, U as synthSfx, V as SFX_PRESETS, W as MusicManager, _ as Engine, a as UiMuteToggle, b as qualityEnvironment, c as UiRenderScaleSelect, d as UiToggle, f as UiVolumeSlider, g as AudioPlayer, h as UiDialogue, i as UiLanguageSelect, j as BASE_LOCALE, k as UiBar, l as UiSelect, m as UiButton, n as UiFrameCapSelect, o as UiPanel, p as Timer, q as fadeGain, r as UiImage, s as UiQualitySelect, t as registerCoreNodes, u as UiSlider, v as Settings, w as LogManager, z as spatialGain } from "./register-Ch70uByv.js";
+import { A as getBehavior, C as Node, D as behaviorSchema, E as Behavior, M as registeredBehaviors, N as Signal, O as behaviorSignals, S as InputMap, T as parseNodePath, _ as savesWithoutUid, a as serializeNode, b as effectiveOrder, c as resolveViewport, d as isConstRef, f as resolveConstants, g as restoreBehaviors, h as captureBehaviors, i as Scene, j as registerBehavior, k as clearBehaviors, l as SceneTree, m as behaviorsWithoutSave, n as loadScene, o as SCENE_FORMAT, p as SaveSlots, s as computeViewport, u as CONST_REF_KEY, v as createSaveStore, x as resolveOrderGroups, y as ORDER_GROUP_BASE } from "./loader-D8n7TU8W.js";
+import { A as UiBar, B as ROLLOFF_MODELS, C as readDeviceHints, D as HudLayer, E as EffectLog, F as suggestLocale, G as synthSfx, H as spatialPan, J as crossfadeGains, K as MusicManager, L as translationKey, M as BASE_LOCALE, N as Localization, P as T_PREFIX, R as SfxEngine, T as LogManager, U as SFX_PRESETS, V as spatialGain, W as SFX_PRESET_NAMES, X as AudioBuses, Y as fadeGain, _ as Engine, a as UiMuteToggle, c as UiRenderScaleSelect, d as UiToggle, f as UiVolumeSlider, g as AudioPlayer, h as UiDialogue, i as UiLanguageSelect, j as UiText, k as UiBanner, l as UiSelect, m as UiButton, n as UiFrameCapSelect, o as UiPanel, p as Timer, q as WebAudioMusicBackend, r as UiImage, s as UiQualitySelect, t as registerCoreNodes, u as UiSlider, w as suggestQuality, x as qualityEnvironment, y as Settings, z as isAudioContextAvailable } from "./register-CDrAQqPp.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as Rng } from "./rng-DP-SR7eg.js";
-import { n as jsonEquals, r as jsonKind, t as jsonClone } from "./json-BLk7H2Qa.js";
-import { a as getNodeSignals, c as mergeStaticSignals, i as getNodeSchema, l as registerNode, n as clearRegistry, o as getNodeType, r as createNode, u as registeredTypes } from "./registry-C7u42TID.js";
-import { a as nodeRefWarnings, i as describeRefProblem, n as startRecording, o as resolveRefInJson, r as auditScene, t as replay } from "./replay-s7I2GstT.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-WWcQcfMr.js";
+import { a as nodeRefWarnings, i as describeRefProblem, n as startRecording, o as resolveRefInJson, r as auditScene, t as replay } from "./replay-CEPyQtF_.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-C0wXLBZJ.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-C1J09Op6.js";
-import { t as duplicateNode } from "./duplicate-BPLZDZpd.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-CY21B462.js";
+import { t as duplicateNode } from "./duplicate-DJQd44CD.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, 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, spatialGain, spatialPan, startRecording, suggestLocale, suggestQuality, synthSfx, translationKey };

package/dist/{json-BLk7H2Qa.js → json-CwwhxQgb.js}

@@ -1,4 +1,10 @@
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
 //#region src/core/json.ts
+var json_exports = /* @__PURE__ */ __exportAll({
+	jsonClone: () => jsonClone,
+	jsonEquals: () => jsonEquals,
+	jsonKind: () => jsonKind
+});
 function jsonKind(value) {
 	if (value === null) return "null";
 	if (Array.isArray(value)) return "array";
@@ -27,4 +33,4 @@ function jsonClone(value) {
 	return JSON.parse(JSON.stringify(value));
 }
 //#endregion
-export { jsonEquals as n, jsonKind as r, jsonClone as t };
+export { json_exports as i, jsonEquals as n, jsonKind as r, jsonClone as t };

package/dist/{loader-BcrRSjxB.js → loader-D8n7TU8W.js}

@@ -1,6 +1,7 @@
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
-import { n as jsonEquals, t as jsonClone } from "./json-BLk7H2Qa.js";
-import { c as mergeStaticSignals, i as getNodeSchema, r as createNode, s as mergeStaticProps, t as applySchemaProps } from "./registry-C7u42TID.js";
+import { n as jsonEquals, t as jsonClone } from "./json-CwwhxQgb.js";
+import { c as mergeStaticSignals, i as getNodeSchema, r as createNode, s as mergeStaticProps, t as applySchemaProps } from "./registry-WWcQcfMr.js";
 //#region src/core/signal.ts
 var Signal = class {
 	connections = [];
@@ -1728,6 +1729,67 @@ function computeViewport(canvasW, canvasH, viewport) {
 	};
 }
 //#endregion
+//#region src/core/scene/network-validate.ts
+/**
+* Hard-check a node's `network` block at LOAD.
+*
+* This block was the one part of a scene the loader deep-cloned without
+* looking at, and it is the part with the most expensive silent failure in the
+* engine. Three typos a person makes constantly —
+*
+*     "sync": "position"        (a string where an array belongs)
+*     "mode": "Owner"           (capitalised)
+*     "syncs": ["position"]     (plural)
+*
+* — each mean the same thing at runtime: **nothing replicates, and nothing
+* says so.** `collectOwners` matches the exact string `'owner'`;
+* `Array.isArray(net.sync)` yields zero keys, so the send loop's body never
+* runs and even its dead-key diagnostic cannot fire. Every other player is a
+* named statue at the spawn point and every layer reports success — measured:
+* all three variants produce a report byte-identical to the working game's.
+*
+* Hard load-time errors over silent warnings is the engine's rule (see
+* AGENTS.md); this block was simply never held to it.
+*/
+const MODES = new Set(["owner", "observer"]);
+function fail$1(message, nodeName, details = {}) {
+	throw new IncantoError("BAD_FORMAT", `${message} (on '${nodeName}')`, details);
+}
+/** Throws `BAD_FORMAT` if `network` cannot mean what its author intended. */
+function validateNetworkBlock(network, nodeName) {
+	if (network === void 0 || network === null) return;
+	if (typeof network !== "object" || Array.isArray(network)) fail$1("\"network\" must be an object like { \"mode\": \"owner\", \"sync\": [\"position\"] }", nodeName);
+	const net = network;
+	const known = new Set([
+		"mode",
+		"sync",
+		"throttleMs"
+	]);
+	for (const key of Object.keys(net)) {
+		if (known.has(key)) continue;
+		fail$1(`Unknown key "${key}" in "network"${key === "syncs" ? " — did you mean \"sync\"?" : ""}. Valid keys: [mode, sync, throttleMs]`, nodeName, {
+			prop: key,
+			validOptions: [
+				"mode",
+				"sync",
+				"throttleMs"
+			]
+		});
+	}
+	if (net.mode !== void 0) {
+		if (typeof net.mode !== "string" || !MODES.has(net.mode)) fail$1(`"network.mode" must be one of [owner, observer], not ${JSON.stringify(net.mode)}` + (typeof net.mode === "string" && MODES.has(net.mode.toLowerCase()) ? " — it is lower-case" : ""), nodeName, {
+			prop: "mode",
+			validOptions: [...MODES]
+		});
+	}
+	if (net.sync !== void 0) {
+		if (!Array.isArray(net.sync)) fail$1(`"network.sync" must be an ARRAY of prop names, not ${JSON.stringify(net.sync)}` + (typeof net.sync === "string" ? ` — write ["${net.sync}"]` : ""), nodeName);
+		for (const key of net.sync) if (typeof key !== "string" || key === "") fail$1(`"network.sync" entries must be non-empty prop names, got ${JSON.stringify(key)}`, nodeName);
+	}
+	if (net.throttleMs !== void 0 && typeof net.throttleMs !== "number") fail$1(`"network.throttleMs" must be a number, not ${JSON.stringify(net.throttleMs)}`, nodeName);
+	if (net.mode === "owner" && Array.isArray(net.sync) && net.sync.length === 0) fail$1("\"network.mode\" is \"owner\" but \"sync\" is empty — nothing would replicate", nodeName);
+}
+//#endregion
 //#region src/core/scene/schema.ts
 /** Current scene file format version. Defaults are frozen per format version. */
 const SCENE_FORMAT = 1;
@@ -1846,7 +1908,41 @@ var Scene = class {
 	}
 };
 //#endregion
+//#region src/core/scene/strings-validate.ts
+/**
+* Hard-check a scene's `strings` header at LOAD.
+*
+* `Localization.load` quietly drops anything that is not a string leaf, and
+* `auditScene` only walks the KEYS it finds — so a table shaped wrongly passed
+* every check the engine had and then rendered raw keys at runtime. Measured:
+*
+* ```
+* "strings": { "en": { "hud.score": 42 } }   → ok, ZERO warnings, exit 0
+* "strings": "nope"                          → ok, ZERO warnings, exit 0
+* ```
+*
+* A number where a string belongs is the common one — a score label written as
+* a default rather than a template — and it is indistinguishable at runtime
+* from a key nobody declared.
+*/
+function fail(message, details = {}) {
+	throw new IncantoError("BAD_FORMAT", message, details);
+}
+/** Throws `BAD_FORMAT` unless `strings` is `locale → key → string`. */
+function validateStrings(strings) {
+	if (strings === void 0 || strings === null) return;
+	if (typeof strings !== "object" || Array.isArray(strings)) fail(`Scene "strings" must be an object of locale tables, like { "en": { "hud.score": "Score" } } — got ${JSON.stringify(strings)}.`);
+	for (const [locale, table] of Object.entries(strings)) {
+		if (typeof table !== "object" || table === null || Array.isArray(table)) fail(`Scene "strings.${locale}" must be an object of key → string, got ${JSON.stringify(table)}.`, { prop: locale });
+		for (const [key, value] of Object.entries(table)) if (typeof value !== "string") fail(`Scene "strings.${locale}.${key}" must be a string, got ${JSON.stringify(value)}. A non-string is dropped and the key renders raw on screen.`, { prop: `${locale}.${key}` });
+	}
+}
+//#endregion
 //#region src/core/scene/loader.ts
+var loader_exports = /* @__PURE__ */ __exportAll({
+	buildNodeJson: () => buildNodeJson,
+	loadScene: () => loadScene
+});
 /**
 * Build a live Scene from scene JSON.
 *
@@ -1861,13 +1957,50 @@ function loadScene(json, opts) {
 	if (typeof json !== "object" || json === null) throw new IncantoError("BAD_FORMAT", `Scene JSON must be an object, got ${json === null ? "null" : typeof json}.`);
 	const sceneJson = json;
 	validateHeader(sceneJson);
+	validateStrings(sceneJson.strings);
+	inheritedStrings = {};
 	const root = buildNode(sceneJson.root, opts, [], "", sceneJson.constants, Object.keys(sceneJson.orderGroups ?? {}));
 	validateUniqueUids(root);
 	const tree = new SceneTree();
 	if (opts?.engine) tree._setEngine(opts.engine);
 	tree.setRoot(root);
 	wireConnections(root, sceneJson.connections ?? [], opts?.declareConnectionSignals);
-	return new Scene(sceneJson, root, tree);
+	const collected = inheritedStrings;
+	inheritedStrings = null;
+	return new Scene(withInheritedStrings(sceneJson, collected), root, tree);
+}
+/**
+* Tables contributed by sub-scenes during the current `loadScene`.
+*
+* A module-level accumulator rather than a threaded parameter because
+* `buildInstance` sits five frames down a recursion whose signature is already
+* long, and a load is synchronous and non-reentrant — the same reason the
+* constants table is passed the way it is.
+*/
+let inheritedStrings = null;
+/** Fold one sub-scene's table into the accumulator. */
+function inheritStrings(strings) {
+	if (!inheritedStrings || strings === void 0) return;
+	validateStrings(strings);
+	for (const [locale, table] of Object.entries(strings)) {
+		inheritedStrings[locale] ??= {};
+		const into = inheritedStrings[locale];
+		for (const [key, value] of Object.entries(table)) if (into[key] === void 0) into[key] = value;
+	}
+}
+/** The parent's own table laid over everything its sub-scenes brought. */
+function withInheritedStrings(sceneJson, collected) {
+	if (!collected || Object.keys(collected).length === 0) return sceneJson;
+	const merged = {};
+	for (const [locale, table] of Object.entries(collected)) merged[locale] = { ...table };
+	for (const [locale, table] of Object.entries(sceneJson.strings ?? {})) merged[locale] = {
+		...merged[locale] ?? {},
+		...table
+	};
+	return {
+		...sceneJson,
+		strings: merged
+	};
 }
 /** @internal Rebuild a detached node subtree from node JSON (used by duplicateNode).
 * The source comes from a live node's serialized props, which are already resolved
@@ -1936,6 +2069,7 @@ function buildInstance(nj, opts, stack, path, constants, bands) {
 	const sub = opts.resolveScene(instancePath);
 	if (!sub) throw new IncantoError("UNRESOLVED_INSTANCE", `resolveScene returned nothing for instance '${instancePath}' (node '${nj.name}').`);
 	validateHeader(sub);
+	inheritStrings(sub.strings);
 	const overrides = resolveConstants(nj.overrides ?? {}, constants);
 	const node = buildNode({
 		...sub.root,
@@ -1969,7 +2103,10 @@ function applyCommon(node, nj, opts) {
 		node.behavior = behavior;
 		for (const s of mergeStaticSignals(behavior.constructor)) node.declareSignal(s);
 	}
-	if (nj.network) node.network = jsonClone(nj.network);
+	if (nj.network) {
+		validateNetworkBlock(nj.network, node.name);
+		node.network = jsonClone(nj.network);
+	}
 }
 function deepMerge(base, override) {
 	const out = { ...base };
@@ -2066,4 +2203,4 @@ function validateUniqueUids(root) {
 	walk(root);
 }
 //#endregion
-export { registerBehavior as A, diagnose as C, behaviorSignals as D, behaviorSchema as E, Signal as M, clearBehaviors as O, Node as S, Behavior as T, createSaveStore as _, SCENE_FORMAT as a, resolveOrderGroups as b, SceneTree as c, resolveConstants as d, SaveSlots as f, savesWithoutUid as g, restoreBehaviors as h, serializeNode as i, registeredBehaviors as j, getBehavior as k, CONST_REF_KEY as l, captureBehaviors as m, loadScene as n, computeViewport as o, behaviorsWithoutSave as p, Scene as r, resolveViewport as s, buildNodeJson as t, isConstRef as u, ORDER_GROUP_BASE as v, parseNodePath as w, InputMap as x, effectiveOrder as y };
+export { getBehavior as A, Node as C, behaviorSchema as D, Behavior as E, registeredBehaviors as M, Signal as N, behaviorSignals as O, InputMap as S, parseNodePath as T, savesWithoutUid as _, serializeNode as a, effectiveOrder as b, resolveViewport as c, isConstRef as d, resolveConstants as f, restoreBehaviors as g, captureBehaviors as h, Scene as i, registerBehavior as j, clearBehaviors as k, SceneTree as l, behaviorsWithoutSave as m, loadScene as n, SCENE_FORMAT as o, SaveSlots as p, loader_exports as r, computeViewport as s, buildNodeJson as t, CONST_REF_KEY as u, createSaveStore as v, diagnose as w, resolveOrderGroups as x, ORDER_GROUP_BASE as y };

package/dist/{loader-BbEMTuWg.d.ts → loader-TvkRFbyL.d.ts}

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

package/dist/net.d.ts

@@ -1,5 +1,5 @@
-import { At as Node, d as PropSchema } from "./behavior-l08AEbq9.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-B0baBwxI.js";
+import { At as Node, d as PropSchema } from "./behavior-DWKTUzKI.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-BQ3tAsf-.js";
 
 //#region src/net/agent8.d.ts
 /**

package/dist/net.js

@@ -1,3 +1,3 @@
 import { n as createAgent8Server } from "./agent8-CvsfVskX.js";
-import { a as applySyncPatch, c as createLocalGameServer, i as NetworkManager, l as LoopbackHub, n as registerNodesNet, o as LocalGameServer, r as NetworkSpawner, s as LocalGameServerTransport, t as createSplitScreen, u as LoopbackTransport } from "./split-screen-DLsUrleX.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-DDMZutQ6.js";
 export { LocalGameServer, LocalGameServerTransport, LoopbackHub, LoopbackTransport, NetworkManager, NetworkSpawner, applySyncPatch, createAgent8Server, createLocalGameServer, createSplitScreen, registerNodesNet };

package/dist/{pathfinding-mEN4V1CU.d.ts → pathfinding-BqWBb0kh.d.ts}

@@ -1,4 +1,4 @@
-import { At as Node, d as PropSchema, dt as Listener } from "./behavior-l08AEbq9.js";
+import { At as Node, d as PropSchema, dt as Listener } from "./behavior-DWKTUzKI.js";
 
 //#region src/core/nodes/audio-player.d.ts
 /**

package/dist/{physics-2d-EqA-jddf.js → physics-2d-BaRSRrrZ.js}

@@ -1,7 +1,7 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { C as diagnose } from "./loader-BcrRSjxB.js";
+import { w as diagnose } from "./loader-D8n7TU8W.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-C6ZBFRjd.js";
+import { _ as RigidBody2D, b as validateCollider2D, g as PhysicsBody2D, h as CharacterBody2D, m as Area2D, p as Joint2D, y as Node2D } from "./register-BpFcgdcL.js";
 import { n as registerDebugSource } from "./debug-draw-BM3DsvtT.js";
 import { t as withoutRapierInitNoise } from "./quiet-rapier-BAJ4K94N.js";
 //#region src/2d/physics/physics-2d.ts
@@ -433,10 +433,20 @@ var Physics2D = class {
 			};
 			this.entries.set(node, e);
 			this.byColliderHandle.set(collider.handle, node);
+			if (!node.enabled) {
+				collider.setEnabled(false);
+				body.setEnabled(false);
+			}
 			node._colliderChanged = false;
+			node._enabledChanged = false;
 			node._physics = this;
 			return e;
 		}
+		if (node._enabledChanged) {
+			e.collider.setEnabled(node.enabled);
+			e.body.setEnabled(node.enabled);
+			node._enabledChanged = false;
+		}
 		const [px, py] = worldPosition2D(node);
 		if (px !== e.lastX || py !== e.lastY) {
 			e.body.setTranslation({

package/dist/{physics-3d-Dnz4fsXX.js → physics-3d-CYxjh-HW.js}

@@ -1,10 +1,10 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { C as diagnose } from "./loader-BcrRSjxB.js";
+import { w as diagnose } from "./loader-D8n7TU8W.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
-import { H as validateCollider3D, I as Area3D, L as CharacterBody3D, R as PhysicsBody3D, V as Node3D, z as RigidBody3D } from "./gameplay-BVphcxmE.js";
+import { H as validateCollider3D, I as Area3D, L as CharacterBody3D, R as PhysicsBody3D, V as Node3D, z as RigidBody3D } from "./gameplay-BBEjPFsR.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-CvvQr_bJ.js";
+import { A as Terrain3D, F as InstancedMesh3D, L as buildMeshGeometry, P as Joint3D } from "./environment-presets-DRAz5EV9.js";
 import { Euler, Matrix4, Quaternion, Vector3 } from "three";
 //#region src/3d/physics/collider-lines.ts
 /**
@@ -652,11 +652,21 @@ var Physics3D = class {
 			};
 			this.entries.set(node, e);
 			this.byColliderHandle.set(collider.handle, node);
+			if (!node.enabled) {
+				collider.setEnabled(false);
+				body.setEnabled(false);
+			}
 			node._colliderChanged = false;
+			node._enabledChanged = false;
 			node._physics = this;
 			if (node instanceof RigidBody3D) node._physics3d = this;
 			return e;
 		}
+		if (node._enabledChanged) {
+			e.collider.setEnabled(node.enabled);
+			e.body.setEnabled(node.enabled);
+			node._enabledChanged = false;
+		}
 		const p = worldPosition3D(node);
 		if (p[0] !== e.last[0] || p[1] !== e.last[1] || p[2] !== e.last[2]) {
 			e.body.setTranslation({

package/dist/react.d.ts

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

package/dist/react.js

@@ -1,4 +1,4 @@
-import { n as jsonEquals, t as jsonClone } from "./json-BLk7H2Qa.js";
+import { n as jsonEquals, t as jsonClone } from "./json-CwwhxQgb.js";
 import { createContext, useContext, useEffect, useRef, useState } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 //#region src/react/index.tsx
@@ -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-D10bU5_J.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-BZwWJIns.js").then((n) => n.n)).createGame2D(o)))(opts);
+			const next = await (_gameFactory ?? (mode === "3d" ? async (o) => (await import("./create-game-BiW8Men_.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-CHDLDQsQ.js").then((n) => n.n)).createGame2D(o)))(opts);
 			if (disposed) {
 				next.dispose();
 				return;

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();