incanto 0.58.0 → 0.60.0

package/dist/{register-C6ZBFRjd.js → register-BSu2dWGC.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-Da3hXh2H.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-Da3hXh2H.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,45 @@ 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.
+	*/
+	/**
+	* What this widget actually PAINTS, when that differs from its props.
+	*
+	* A headless capture printed `text="@t:menu.start"` — byte-identical in
+	* every language — so a passing capture proved nothing about localization
+	* and a broken translation was invisible to every check the engine has.
+	* `incanto-frame` reads the WebGL buffer and cannot read DOM text at all.
+	*
+	* `undefined` when the painted words ARE the prop: recording it twice would
+	* be noise on every widget in a game that never localizes anything.
+	*/
+	_paintedText() {}
+	_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 {
@@ -1586,6 +1654,10 @@ var UiText = class extends HudWidgetBase {
 		if (this.format && this.slot !== null) return this._t(this.format).replace("{}", this.slot);
 		return this._t(this.text);
 	}
+	_paintedText() {
+		const painted = this.shown;
+		return painted === this.text ? void 0 : painted;
+	}
 	_build() {
 		const el = document.createElement("div");
 		el.style.cssText = this.look();
@@ -1756,6 +1828,7 @@ var UiBanner = class extends HudWidgetBase {
 	show(text, opts) {
 		this.queue.push({
 			text,
+			source: text,
 			color: opts?.color ?? "#ffffff",
 			seconds: opts?.seconds ?? this.seconds
 		});
@@ -1788,6 +1861,11 @@ var UiBanner = class extends HudWidgetBase {
 			this._element.style.opacity = opacity;
 		}
 		if (this.current) {
+			const next = this._t(this.current.source);
+			if (next !== this.current.text) {
+				this.current.text = next;
+				if (this._element) this._element.textContent = next;
+			}
 			if (this.current.seconds > 0) {
 				this.remaining -= dt;
 				if (this.remaining <= 0) {
@@ -1798,7 +1876,7 @@ var UiBanner = class extends HudWidgetBase {
 		}
 		if (!this.current && this.queue.length > 0) {
 			this.current = this.queue.shift();
-			this.current.text = this._t(this.current.text);
+			this.current.text = this._t(this.current.source);
 			this.remaining = this.current.seconds;
 			if (this._element) {
 				this._element.textContent = this.current.text;
@@ -2126,7 +2204,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 +2307,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;
@@ -3050,10 +3129,14 @@ var UiDialogue = class extends HudWidgetBase {
 	}
 	/** Queue a line; optional `choices` renders buttons after the line types out. */
 	say(speaker, text, choices) {
-		this.queue.push({
+		const source = {
 			speaker,
 			text,
 			choices: choices ?? null
+		};
+		this.queue.push({
+			...source,
+			source
 		});
 	}
 	/**
@@ -3107,13 +3190,22 @@ var UiDialogue = class extends HudWidgetBase {
 		box.addEventListener("click", () => this.advance());
 		return box;
 	}
+	/** The locale `current` was resolved in, so a switch is one compare away. */
+	resolvedIn = "\0";
+	/** Re-read the live line from its untouched source. */
+	resolveCurrent() {
+		const line = this.current;
+		if (!line) return;
+		line.text = this._t(line.source.text);
+		line.speaker = this._t(line.source.speaker);
+		line.choices = line.source.choices ? line.source.choices.map((c) => this._t(c)) : null;
+		this.resolvedIn = this.tree?.engine?.locale.locale ?? "";
+	}
 	update(dt) {
 		super.update(dt);
 		if (!this.current && this.queue.length > 0) {
 			this.current = this.queue.shift();
-			this.current.text = this._t(this.current.text);
-			this.current.speaker = this._t(this.current.speaker);
-			if (this.current.choices) this.current.choices = this.current.choices.map((c) => this._t(c));
+			this.resolveCurrent();
 			this.revealed = this.charsPerSecond <= 0 ? this.current.text.length : 0;
 			this.emit("lineShown", this.current.text);
 			if (this._element) {
@@ -3123,6 +3215,13 @@ var UiDialogue = class extends HudWidgetBase {
 		}
 		if (this._element) this._element.style.display = this.visible && this.current ? "block" : "none";
 		if (!this.current) return;
+		if ((this.tree?.engine?.locale.locale ?? "") !== this.resolvedIn) {
+			const before = this.current.text.length;
+			const progress = before > 0 ? this.revealed / before : 1;
+			this.resolveCurrent();
+			this.revealed = Math.round(progress * this.current.text.length);
+			if (this.speakerEl) this.speakerEl.textContent = this.current.speaker;
+		}
 		const wasTyping = this.revealed < this.current.text.length;
 		if (wasTyping) this.revealed = Math.min(this.current.text.length, this.revealed + this.charsPerSecond * dt);
 		const doneTyping = this.revealed >= this.current.text.length;
@@ -3193,17 +3292,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 +3465,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 +3478,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 +3490,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 +3530,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 +3545,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 +3595,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 +3732,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 +3901,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 +3938,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 +3985,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-Dw6gMlYA.d.ts → replay-BCMK_VRP.d.ts}

@@ -1,9 +1,22 @@
-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
 /** Human-readable warnings (empty = clean). Pure JSON walk, no registry. */
-declare function auditScene(scene: JsonObject): string[];
+interface AuditOptions {
+  /**
+  * Every locale table the whole PROJECT declares, unioned.
+  *
+  * Localization tables MERGE across scenes — a game's shared UI strings live
+  * in the scene it boots from, and a level that adds three lines of its own
+  * does not wipe them. Auditing one file in isolation therefore reported a key
+  * declared in the boot scene as "nothing declares" it, and told its author to
+  * add a string they already have. The checker passes the corpus in when it
+  * has one.
+  */
+  declaredElsewhere?: Record<string, Record<string, string>>;
+}
+declare function auditScene(scene: JsonObject, opts?: AuditOptions): string[];
 //#endregion
 //#region src/core/errors.d.ts
 /**

package/dist/{replay-s7I2GstT.js → replay-BlNuIDdg.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-Da3hXh2H.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.
@@ -266,8 +266,7 @@ function isLit(environment) {
 	const ambient = environment.ambient;
 	return typeof ambient?.intensity === "number" && ambient.intensity > 0;
 }
-/** Human-readable warnings (empty = clean). Pure JSON walk, no registry. */
-function auditScene(scene) {
+function auditScene(scene, opts = {}) {
 	const warnings = [];
 	const root = scene.root;
 	if (!root) return warnings;
@@ -301,7 +300,7 @@ function auditScene(scene) {
 	if (currentCameras > 1) warnings.push(`${currentCameras} cameras claim "current": true — only the first found wins.`);
 	if (scene.dimension === "3d" && lights === 0 && !isLit(scene.environment)) warnings.push("nothing lights this 3D scene — no light node, no environment sky/hdri, and no ambient intensity. It will render black. Add a DirectionalLight3D, or an \"environment\": { \"sky\": { \"type\": \"atmosphere\" } } / { \"preset\": \"...\" }.");
 	for (const warning of nodeRefWarnings(scene)) warnings.push(warning);
-	for (const warning of auditStrings(scene)) warnings.push(warning);
+	for (const warning of auditStrings(scene, opts.declaredElsewhere)) warnings.push(warning);
 	return warnings;
 }
 /**
@@ -317,15 +316,33 @@ function auditScene(scene) {
 * screen. Reported here — at author time, where it can still be fixed — rather
 * than at runtime in front of someone playing.
 */
-function auditStrings(scene) {
-	const tables = scene.strings;
+/**
+* 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, elsewhere) {
+	const own = scene.strings;
+	const tables = {};
+	for (const source of [elsewhere, own]) for (const [locale, entries] of Object.entries(source ?? {})) tables[locale] = {
+		...tables[locale] ?? {},
+		...entries
+	};
 	const declared = /* @__PURE__ */ new Set();
-	for (const entries of Object.values(tables ?? {})) for (const key of Object.keys(entries)) declared.add(key);
+	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 (declared.size > 0 && !inBase.has(key)) notInEnglish.add(key);
+			}
 			return;
 		}
 		if (Array.isArray(value)) {
@@ -335,9 +352,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