incanto 0.59.0 → 0.60.0

package/bin/incanto-check.mjs

@@ -8,6 +8,7 @@
  *   npx incanto-check src/game.scene.json   → specific files (or directories)
  *   npx incanto-check --json                → machine-readable report
  *   npx incanto-check --strict-behaviors    → unregistered script names fail too
+ *   npx incanto-check --strict-warnings     → a warning is a failure (CI, agents)
  *
  * Unregistered behaviors are STUBBED by default: structure-only validation
  * that needs no TypeScript. Sub-scene `instance` paths resolve relative to
@@ -25,6 +26,7 @@ function parseArgs(argv) {
   for (const a of argv) {
     if (a === '--json') args.json = true;
     else if (a === '--strict-behaviors') args.strict = true;
+    else if (a === '--strict-warnings') args.strictWarnings = true;
     else if (a === '--help' || a === '-h') args.help = true;
     else if (a.startsWith('--')) {
       console.error(`unknown flag: ${a}`);
@@ -36,7 +38,7 @@ function parseArgs(argv) {
 
 const args = parseArgs(process.argv.slice(2));
 if (args.help || args.invalid) {
-  console.log(`Usage: npx incanto-check [files|dirs...] [--json] [--strict-behaviors]
+  console.log(`Usage: npx incanto check [files|dirs...] [--json] [--strict-behaviors] [--strict-warnings]
 
 Validates *.scene.json files headlessly with the installed engine.
 With no arguments, scans the current directory recursively
@@ -155,6 +157,28 @@ if (files.length === 0) {
 
 const { auditScene, validateScene } = await import(pathToFileURL(join(DIST, 'test.js')).href);
 
+/**
+ * Every `strings` table in the corpus, unioned.
+ *
+ * Localization tables MERGE across scenes at runtime — a game's shared UI
+ * strings live in the scene it boots from — so auditing one file in isolation
+ * reported a key declared in the boot scene as "nothing declares" it, and told
+ * its author to add a string they already have. Checking a project means
+ * knowing what the project declares.
+ */
+const declaredElsewhere = {};
+for (const file of files) {
+  try {
+    const doc = JSON.parse(readFileSync(file, 'utf-8'));
+    for (const [locale, entries] of Object.entries(doc?.strings ?? {})) {
+      if (typeof entries !== 'object' || entries === null) continue;
+      declaredElsewhere[locale] = { ...(declaredElsewhere[locale] ?? {}), ...entries };
+    }
+  } catch {
+    /* a file that will not parse is reported below, on its own line */
+  }
+}
+
 const results = files.map((file) => {
   let json;
   try {
@@ -166,7 +190,13 @@ const results = files.map((file) => {
     strictBehaviors: args.strict,
     resolveScene: (p) => JSON.parse(readFileSync(resolve(dirname(file), p), 'utf-8')),
   });
-  if (res.ok) return { file, ok: true, warnings: [...auditScene(json), ...missingArt(file, json)] };
+  if (res.ok) {
+    return {
+      file,
+      ok: true,
+      warnings: [...auditScene(json, { declaredElsewhere }), ...missingArt(file, json)],
+    };
+  }
   return {
     file,
     ok: false,
@@ -177,6 +207,7 @@ const results = files.map((file) => {
 });
 
 const failed = results.filter((r) => !r.ok);
+const warned = results.reduce((n, r) => n + (r.warnings?.length ?? 0), 0);
 if (args.json) {
   console.log(JSON.stringify({ ok: failed.length === 0, results }, null, 2));
 } else {
@@ -186,10 +217,20 @@ if (args.json) {
       for (const w of r.warnings ?? []) console.log(`      warn: ${w}`);
     } else console.log(`FAIL  ${r.file}\n      [${r.code}] ${r.message}`);
   }
-  console.log(`\n${results.length - failed.length}/${results.length} scene(s) valid`);
+  // Say the warning count on the summary line. A warning printed under an `ok`
+  // and a summary that never mentions it is a finding an agent scrolls past.
+  console.log(
+    `\n${results.length - failed.length}/${results.length} scene(s) valid` +
+      (warned > 0
+        ? `, ${warned} warning(s)${args.strictWarnings ? '' : ' — `--strict-warnings` to fail on them'}`
+        : ''),
+  );
 }
 // `exitCode`, never `process.exit()`: stdout to a PIPE is written
 // asynchronously, and exiting discards whatever has not flushed. A --json
 // report read by another program came back truncated — silently, and only
 // when piped, which is the only way a program reads it.
-process.exitCode = failed.length === 0 ? 0 : 1;
+// A warning is a finding, and a checker read by a CI step or an agent is read
+// through its EXIT CODE. Opt-in, because turning it on by default would fail
+// every project that has been living with one.
+process.exitCode = failed.length === 0 && !(args.strictWarnings && warned > 0) ? 0 : 1;

package/dist/2d.js

@@ -1,7 +1,7 @@
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
-import { a as AssetStore2D, i as syncTree2D, r as Renderer2D, t as createGame2D } from "./create-game-CHDLDQsQ.js";
-import { _ as RigidBody2D, a as parseCells, c as ColorRect2D, d as AnimatedSprite2D, f as Sprite2D, g as PhysicsBody2D, h as CharacterBody2D, i as mergeSolidRects, l as CharacterController2D, m as Area2D, n as UILayer, o as Particles2D, p as Joint2D, r as TileMap2D, s as Label, t as registerNodes2D, u as Camera2D, v as StaticBody2D, y as Node2D } from "./register-BpFcgdcL.js";
-import { n as enablePhysics2D, t as Physics2D } from "./physics-2d-BaRSRrrZ.js";
+import { a as AssetStore2D, i as syncTree2D, r as Renderer2D, t as createGame2D } from "./create-game-ClnIb_M5.js";
+import { _ as RigidBody2D, a as parseCells, c as ColorRect2D, d as AnimatedSprite2D, f as Sprite2D, g as PhysicsBody2D, h as CharacterBody2D, i as mergeSolidRects, l as CharacterController2D, m as Area2D, n as UILayer, o as Particles2D, p as Joint2D, r as TileMap2D, s as Label, t as registerNodes2D, u as Camera2D, v as StaticBody2D, y as Node2D } from "./register-BSu2dWGC.js";
+import { n as enablePhysics2D, t as Physics2D } from "./physics-2d-DqdVp1bt.js";
 //#region src/2d/library-sprite.ts
 /**
 * What a `CharacterController2D`/`3D` will ask a skin to play, and the clip in

package/dist/3d.js

@@ -1,9 +1,9 @@
 import { a as frameSignature, n as diffSignatures, o as frameStats, r as diffText, s as frameText, t as SIGNATURE_GRID } from "./frame-report-BSMny7oe.js";
 import { B as StaticBody3D, F as WaterCutout3D, I as Area3D, L as CharacterBody3D, N as Water3D, P as WATER_CUTOUT_MAX, R as PhysicsBody3D, V as Node3D, W as WATER_MAX_RIPPLES, z as RigidBody3D } from "./gameplay-BBEjPFsR.js";
-import { A as Terrain3D, B as keyboardIntensity, C as resolveFlowerDensity, D as BoneLookAt3D, E as Camera3D, F as InstancedMesh3D, G as acquireTexture, H as rigPose, I as MeshInstance3D, M as TERRAIN_THEMES, N as terrainThemeLayers, O as BoneAttachment3D, P as Joint3D, R as QUARTER_PITCH, S as Flowers3D, T as CharacterController3D, U as TextureCache3D, V as movementState, W as acquireOwnTexture, _ as LoftMesh3D, a as Tree3D, b as Foliage3D, c as buildRiverRings, d as riverCarveChannels, f as riverStepFor, g as ModelInstance3D, h as Particles3D, i as VoxelGrid3D, j as DEFAULT_TERRAIN_TEXTURE_BASE, k as Billboard3D, l as findRiverCoverageGaps, m as traceDownhillPath, n as registerNodes3D, o as Trail3D, p as smoothCourse, r as VOXEL_PALETTE, s as River3D, u as projectToRiver, v as DirectionalLight3D, w as FLOWER_VARIETIES, x as DENSITY_PRESETS, y as OmniLight3D, z as cameraRelative } from "./environment-presets-DRAz5EV9.js";
-import { a as Environment3D, c as parseEnvironment3D, d as AssetStore3D, i as syncTree, l as sunDirectionFromElevationAzimuth, o as setEnvironment3D, r as Renderer3D, s as horizonColorFromSky, t as createGame3D, u as sunDirectionFromSky } from "./create-game-BiW8Men_.js";
+import { A as Terrain3D, B as keyboardIntensity, C as resolveFlowerDensity, D as BoneLookAt3D, E as Camera3D, F as InstancedMesh3D, G as acquireTexture, H as rigPose, I as MeshInstance3D, M as TERRAIN_THEMES, N as terrainThemeLayers, O as BoneAttachment3D, P as Joint3D, R as QUARTER_PITCH, S as Flowers3D, T as CharacterController3D, U as TextureCache3D, V as movementState, W as acquireOwnTexture, _ as LoftMesh3D, a as Tree3D, b as Foliage3D, c as buildRiverRings, d as riverCarveChannels, f as riverStepFor, g as ModelInstance3D, h as Particles3D, i as VoxelGrid3D, j as DEFAULT_TERRAIN_TEXTURE_BASE, k as Billboard3D, l as findRiverCoverageGaps, m as traceDownhillPath, n as registerNodes3D, o as Trail3D, p as smoothCourse, r as VOXEL_PALETTE, s as River3D, u as projectToRiver, v as DirectionalLight3D, w as FLOWER_VARIETIES, x as DENSITY_PRESETS, y as OmniLight3D, z as cameraRelative } from "./environment-presets-8cjF3t6w.js";
+import { a as Environment3D, c as parseEnvironment3D, d as AssetStore3D, i as syncTree, l as sunDirectionFromElevationAzimuth, o as setEnvironment3D, r as Renderer3D, s as horizonColorFromSky, t as createGame3D, u as sunDirectionFromSky } from "./create-game-BCm38FJV.js";
 import { n as splatWeights, t as buildHeightmap } from "./heightmap-CRK0M4jT.js";
-import { n as enablePhysics3D, t as Physics3D } from "./physics-3d-CYxjh-HW.js";
+import { n as enablePhysics3D, t as Physics3D } from "./physics-3d-BP0DZb_1.js";
 //#region src/3d/model-verdict.ts
 /** Mixamo exports every bone as `mixamorigX`; the retargeter binds by that name. */
 const MIXAMO = /^mixamorig[:_]?/i;

package/dist/{create-game-BiW8Men_.js → create-game-BCm38FJV.js}

@@ -1,14 +1,14 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
 import { j as registerBehavior, n as loadScene, w as diagnose } from "./loader-D8n7TU8W.js";
-import { S as qualityRendering, _ as Engine, b as qualityCaps, g as AudioPlayer } from "./register-CDrAQqPp.js";
+import { S as qualityRendering, _ as Engine, b as qualityCaps, g as AudioPlayer } from "./register-Da3hXh2H.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { i as resolveRendering, n as attachTouchControls } from "./touch-DESwnpOc.js";
-import { a as openBundledEditor, c as claimCanvasGestures, i as devServerLibrary, l as audioErrors, n as pauseWhenHidden, o as poseFromRenderer, r as crossFade, s as wireDevChannel, t as teardown } from "./teardown-RApWnM1G.js";
+import { a as openBundledEditor, c as claimCanvasGestures, i as devServerLibrary, l as audioErrors, n as pauseWhenHidden, o as poseFromRenderer, r as crossFade, s as wireDevChannel, t as teardown } from "./teardown-CTTwhWSe.js";
 import { o as frameStats } from "./frame-report-BSMny7oe.js";
 import { R as PhysicsBody3D, U as createCausticsQuad, V as Node3D, n as registerGameplayBehaviors } from "./gameplay-BBEjPFsR.js";
 import { t as debugSources } from "./debug-draw-BM3DsvtT.js";
-import { E as Camera3D, U as TextureCache3D, g as ModelInstance3D, n as registerNodes3D, t as resolveEnvironmentHdri, v as DirectionalLight3D } from "./environment-presets-DRAz5EV9.js";
-import { n as enablePhysics3D } from "./physics-3d-CYxjh-HW.js";
+import { E as Camera3D, U as TextureCache3D, g as ModelInstance3D, n as registerNodes3D, t as resolveEnvironmentHdri, v as DirectionalLight3D } from "./environment-presets-8cjF3t6w.js";
+import { n as enablePhysics3D } from "./physics-3d-BP0DZb_1.js";
 import { ACESFilmicToneMapping, AmbientLight, Box3, BufferAttribute, BufferGeometry, Color, DepthTexture, EquirectangularReflectionMapping, FloatType, Fog, HalfFloatType, LineBasicMaterial, LineSegments, Matrix4, Mesh, PCFShadowMap, PMREMGenerator, PerspectiveCamera, PlaneGeometry, Quaternion, Raycaster, Scene, ShaderMaterial, Vector2, Vector3, WebGLRenderTarget, WebGLRenderer } from "three";
 import { VRMLoaderPlugin, VRMUtils } from "@pixiv/three-vrm";
 import { GLTFLoader } from "three/addons/loaders/GLTFLoader.js";

package/dist/{create-game-CHDLDQsQ.js → create-game-ClnIb_M5.js}

@@ -1,14 +1,14 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
 import { c as resolveViewport, j as registerBehavior, n as loadScene, s as computeViewport, w as diagnose } from "./loader-D8n7TU8W.js";
-import { _ as Engine, g as AudioPlayer } from "./register-CDrAQqPp.js";
+import { _ as Engine, g as AudioPlayer } from "./register-Da3hXh2H.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { i as resolveRendering, n as attachTouchControls } from "./touch-DESwnpOc.js";
-import { a as openBundledEditor, c as claimCanvasGestures, i as devServerLibrary, l as audioErrors, n as pauseWhenHidden, r as crossFade, s as wireDevChannel, t as teardown } from "./teardown-RApWnM1G.js";
+import { a as openBundledEditor, c as claimCanvasGestures, i as devServerLibrary, l as audioErrors, n as pauseWhenHidden, r as crossFade, s as wireDevChannel, t as teardown } from "./teardown-CTTwhWSe.js";
 import { o as frameStats } from "./frame-report-BSMny7oe.js";
 import { n as registerGameplayBehaviors } from "./gameplay-BBEjPFsR.js";
-import { g as PhysicsBody2D, n as UILayer, t as registerNodes2D, u as Camera2D, y as Node2D } from "./register-BpFcgdcL.js";
+import { g as PhysicsBody2D, n as UILayer, t as registerNodes2D, u as Camera2D, y as Node2D } from "./register-BSu2dWGC.js";
 import { t as debugSources } from "./debug-draw-BM3DsvtT.js";
-import { n as enablePhysics2D } from "./physics-2d-BaRSRrrZ.js";
+import { n as enablePhysics2D } from "./physics-2d-DqdVp1bt.js";
 import { Box3, BufferAttribute, BufferGeometry, Color, LineBasicMaterial, LineSegments, LinearFilter, NearestFilter, OrthographicCamera, Raycaster, SRGBColorSpace, Scene, TextureLoader, Vector2, Vector3, WebGLRenderer } from "three";
 //#region src/2d/assets.ts
 /**

package/dist/{environment-presets-DRAz5EV9.js → environment-presets-8cjF3t6w.js}

@@ -1,5 +1,5 @@
 import { w as diagnose } from "./loader-D8n7TU8W.js";
-import { I as translateOn, t as registerCoreNodes } from "./register-CDrAQqPp.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-WWcQcfMr.js";

package/dist/index.d.ts

@@ -4,7 +4,7 @@ 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-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";
+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-BCMK_VRP.js";
 
 //#region src/core/audio/crossfade.d.ts
 /**
@@ -417,6 +417,18 @@ declare abstract class HudWidgetBase extends Node {
   * 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(): string | undefined;
   protected _labelText(): string;
   protected _tOr(key: string, fallback: string): string;
 }
@@ -456,6 +468,7 @@ declare class UiText extends HudWidgetBase {
   * that starts blank looks broken rather than empty.
   */
   get shown(): string;
+  override _paintedText(): string | undefined;
   protected _build(): HTMLElement;
   /** The whole appearance as one string, so re-applying is one comparison. */
   private look;
@@ -604,6 +617,10 @@ declare class UiDialogue extends HudWidgetBase {
   clear(): void;
   private next;
   protected _build(): HTMLElement;
+  /** The locale `current` was resolved in, so a switch is one compare away. */
+  private resolvedIn;
+  /** Re-read the live line from its untouched source. */
+  private resolveCurrent;
   override update(dt: number): void;
 }
 //#endregion

package/dist/index.js

@@ -1,13 +1,13 @@
 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 { 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-Da3hXh2H.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as Rng } from "./rng-DP-SR7eg.js";
 import { n as jsonEquals, r as jsonKind, t as jsonClone } from "./json-CwwhxQgb.js";
 import { a as getNodeSignals, c as mergeStaticSignals, i as getNodeSchema, l as registerNode, n as clearRegistry, o as getNodeType, r as createNode, u as registeredTypes } from "./registry-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 nodeRefWarnings, i as describeRefProblem, n as startRecording, o as resolveRefInJson, r as auditScene, t as replay } from "./replay-BlNuIDdg.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-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 { a as preloadUrls, i as preloadSceneAssets, n as newUid, o as findPath, r as assetUrls, s as gridFromRows, t as VERSION } from "./src-DFpXBMJN.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/net.js

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

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

@@ -1,7 +1,7 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.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-BpFcgdcL.js";
+import { _ as RigidBody2D, b as validateCollider2D, g as PhysicsBody2D, h as CharacterBody2D, m as Area2D, p as Joint2D, y as Node2D } from "./register-BSu2dWGC.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

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

@@ -4,7 +4,7 @@ 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-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-DRAz5EV9.js";
+import { A as Terrain3D, F as InstancedMesh3D, L as buildMeshGeometry, P as Joint3D } from "./environment-presets-8cjF3t6w.js";
 import { Euler, Matrix4, Quaternion, Vector3 } from "three";
 //#region src/3d/physics/collider-lines.ts
 /**

package/dist/react.js

@@ -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-BiW8Men_.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-CHDLDQsQ.js").then((n) => n.n)).createGame2D(o)))(opts);
+			const next = await (_gameFactory ?? (mode === "3d" ? async (o) => (await import("./create-game-BCm38FJV.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-ClnIb_M5.js").then((n) => n.n)).createGame2D(o)))(opts);
 			if (disposed) {
 				next.dispose();
 				return;

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

@@ -1,5 +1,5 @@
 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 { 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-WWcQcfMr.js";

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

@@ -1584,6 +1584,18 @@ var HudWidgetBase = class extends Node {
 	* 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) : "";
@@ -1642,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();
@@ -1812,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
 		});
@@ -1844,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) {
@@ -1854,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;
@@ -3107,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
 		});
 	}
 	/**
@@ -3164,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) {
@@ -3180,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;

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

@@ -3,7 +3,20 @@ 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-CEPyQtF_.js → replay-BlNuIDdg.js}

@@ -1,5 +1,5 @@
 import { D as behaviorSchema, T as parseNodePath } from "./loader-D8n7TU8W.js";
-import { L as translationKey, O as HudWidgetBase } from "./register-CDrAQqPp.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
 /**
@@ -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;
 }
 /**
@@ -323,11 +322,16 @@ function auditScene(scene) {
 * not trip it.
 */
 const NEAR_MISS = /^\s*@\s*t\s*[:.]/i;
-function auditStrings(scene) {
-	const tables = scene.strings;
+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);
-	const inBase = new Set(Object.keys(tables?.["en"] ?? {}));
+	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();
@@ -337,7 +341,7 @@ function auditStrings(scene) {
 			const key = translationKey(value);
 			if (key !== null) {
 				if (!declared.has(key)) missing.add(key);
-				else if (tables && !inBase.has(key)) notInEnglish.add(key);
+				else if (declared.size > 0 && !inBase.has(key)) notInEnglish.add(key);
 			}
 			return;
 		}

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

@@ -1,5 +1,5 @@
 import { C as Node, N as Signal, n as loadScene, t as buildNodeJson, w as diagnose } from "./loader-D8n7TU8W.js";
-import { _ as Engine, t as registerCoreNodes } from "./register-CDrAQqPp.js";
+import { _ as Engine, t as registerCoreNodes } from "./register-Da3hXh2H.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { n as jsonEquals, t as jsonClone } from "./json-CwwhxQgb.js";
 import { l as registerNode } from "./registry-WWcQcfMr.js";

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

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

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

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

package/dist/{test-DHYuFyAu.js → test-BeZ95pqw.js}

@@ -1,13 +1,13 @@
 import { c as resolveViewport, j as registerBehavior, n as loadScene } from "./loader-D8n7TU8W.js";
-import { _ as Engine } from "./register-CDrAQqPp.js";
+import { _ as Engine } from "./register-Da3hXh2H.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { n as jsonEquals, t as jsonClone } from "./json-CwwhxQgb.js";
 import { i as getNodeSchema, s as mergeStaticProps } from "./registry-WWcQcfMr.js";
-import { n as startRecording } from "./replay-CEPyQtF_.js";
+import { n as startRecording } from "./replay-BlNuIDdg.js";
 import { n as registerGameplayBehaviors } from "./gameplay-BBEjPFsR.js";
-import { t as registerNodes2D } from "./register-BpFcgdcL.js";
-import { n as registerNodes3D, t as resolveEnvironmentHdri } from "./environment-presets-DRAz5EV9.js";
-import { a as NetworkManager, c as readSyncKey, i as sanitizeName, n as registerNodesNet, r as NetworkSpawner, s as findOwnerNode, t as createSplitScreen } from "./split-screen-DDMZutQ6.js";
+import { t as registerNodes2D } from "./register-BSu2dWGC.js";
+import { n as registerNodes3D, t as resolveEnvironmentHdri } from "./environment-presets-8cjF3t6w.js";
+import { a as NetworkManager, c as readSyncKey, i as sanitizeName, n as registerNodesNet, r as NetworkSpawner, s as findOwnerNode, t as createSplitScreen } from "./split-screen-CL5Yvxse.js";
 import { Box3, Euler, Matrix4, PerspectiveCamera, Quaternion, Vector3 } from "three";
 //#region src/test/framing.ts
 /**
@@ -1669,7 +1669,7 @@ async function playMultiplayer(opts) {
 */
 async function joinLate(server, first, opts) {
 	try {
-		const { Engine } = await import("./register-CDrAQqPp.js").then((n) => n.v);
+		const { Engine } = await import("./register-Da3hXh2H.js").then((n) => n.v);
 		const { loadScene } = await import("./loader-D8n7TU8W.js").then((n) => n.r);
 		const { jsonClone } = await import("./json-CwwhxQgb.js").then((n) => n.i);
 		const engine = new Engine(opts.seed !== void 0 ? { seed: opts.seed + 999 } : {});
@@ -1925,6 +1925,8 @@ function captureScene(scene) {
 			type: ctor.typeName,
 			props
 		};
+		const painted = node._paintedText?.();
+		if (typeof painted === "string") capture.text = painted;
 		if (node.uid) capture.uid = node.uid;
 		if (node.groups.size > 0) capture.groups = [...node.groups];
 		if (Object.keys(node.tags).length > 0) capture.tags = jsonClone(node.tags);
@@ -1951,6 +1953,7 @@ function describeCapture(capture) {
 		const schema = defaultsFor(node.type);
 		const deltas = Object.entries(node.props).filter(([key, value]) => !schema || !jsonEquals(value, schema[key]?.default ?? null)).map(([key, value]) => `${key}=${JSON.stringify(value)}`);
 		const extras = [
+			node.text !== void 0 ? `paints=${JSON.stringify(node.text)}` : "",
 			node.script ? `script=${node.script}` : "",
 			node.groups ? `groups=${node.groups.join(",")}` : "",
 			...deltas
@@ -2021,12 +2024,13 @@ async function runScript(json, opts) {
 	});
 	const scene = loadScene(structuredClone(json), { resolveScene: opts.resolveScene });
 	engine.setScene(scene);
+	if (opts.locale) engine.locale.locale = opts.locale;
 	const physics = opts.physics ?? "auto";
 	if (physics === "2d" || physics === "auto" && scene.dimension === "2d") {
-		const { enablePhysics2D } = await import("./physics-2d-BaRSRrrZ.js").then((n) => n.r);
+		const { enablePhysics2D } = await import("./physics-2d-DqdVp1bt.js").then((n) => n.r);
 		await enablePhysics2D(engine);
 	} else if (physics === "3d" || physics === "auto" && scene.dimension === "3d") {
-		const { enablePhysics3D } = await import("./physics-3d-CYxjh-HW.js").then((n) => n.r);
+		const { enablePhysics3D } = await import("./physics-3d-BP0DZb_1.js").then((n) => n.r);
 		await enablePhysics3D(engine);
 	}
 	const failures = [];
@@ -2139,10 +2143,10 @@ async function createPlaySession(json, opts = {}) {
 	engine.setScene(scene);
 	const physics = opts.physics ?? "auto";
 	if (physics === "2d" || physics === "auto" && scene.dimension === "2d") {
-		const { enablePhysics2D } = await import("./physics-2d-BaRSRrrZ.js").then((n) => n.r);
+		const { enablePhysics2D } = await import("./physics-2d-DqdVp1bt.js").then((n) => n.r);
 		await enablePhysics2D(engine);
 	} else if (physics === "3d" || physics === "auto" && scene.dimension === "3d") {
-		const { enablePhysics3D } = await import("./physics-3d-CYxjh-HW.js").then((n) => n.r);
+		const { enablePhysics3D } = await import("./physics-3d-BP0DZb_1.js").then((n) => n.r);
 		await enablePhysics3D(engine);
 	}
 	const stepMs = 1e3 / (opts.fixedHz ?? 60);

package/dist/test.d.ts

@@ -1,7 +1,7 @@
 import { At as Node, Nt as LogEntry, P as Scene, b as Engine, n as BehaviorCtor } 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";
-import { l as auditScene, o as IncantoError, r as ReplayJson } from "./replay-O-yAGM76.js";
+import { l as auditScene, o as IncantoError, r as ReplayJson } from "./replay-BCMK_VRP.js";
 import { l as LocalGameServerOptions, n as SplitScreenPlayer } from "./split-screen-BQ3tAsf-.js";
 
 //#region src/test/facing.d.ts
@@ -490,6 +490,14 @@ interface NodeCapture {
   script?: string;
   /** CURRENT value of every schema prop (not delta — captures runtime state). */
   props: Record<string, JsonValue>;
+  /**
+  * What this node actually PAINTS, when that differs from its props.
+  *
+  * A capture printed `text="@t:menu.start"` — byte-identical in every
+  * language — so it proved nothing about localization. Absent unless the
+  * painted words differ from the authored ones.
+  */
+  text?: string;
 }
 interface SceneCapture {
   name: string;
@@ -564,6 +572,14 @@ interface RunScriptOptions {
   physics?: "2d" | "3d" | "auto" | false;
   /** Collect a snapshot every N simulated ms. */
   snapshotEveryMs?: number;
+  /**
+  * Run the whole script in this language.
+  *
+  * Without it every headless check ran in English, so a translation could
+  * only ever be verified by opening a browser and reading — which is exactly
+  * the loop the ladder exists to replace.
+  */
+  locale?: string;
   resolveScene?: LoadSceneOptions["resolveScene"];
 }
 interface RunResult {