incanto 0.58.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/bin/incanto-multiplay.mjs

@@ -0,0 +1,170 @@
+#!/usr/bin/env node
+/**
+ * incanto-multiplay — run a real match headlessly and check the clients AGREE.
+ *
+ *   bunx incanto multiplay src/game.scene.json
+ *   bunx incanto multiplay src/game.scene.json --players 3 --seconds 8 --json
+ *
+ * A desync is the purest silent failure this engine can have: both clients
+ * run, neither errors, and they are playing different games. Nothing checked
+ * for one — the harness measured room MEMBERSHIP, so "saw p2" meant "p2 is in
+ * the room", not "p2's data arrived", and a game whose replication was
+ * completely dead reported exactly what a working one did.
+ *
+ * WHAT THIS PROVES, AND WHAT IT DOES NOT. Every client runs against one
+ * in-memory server: no latency, no loss, no reordering. So this measures the
+ * APPLY path and the protocol shape, and says nothing about a live wire — a
+ * reconnect that never re-joins, a throttle that discards a payload, a batch
+ * dropped on a closed socket.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+
+const PKG = join(dirname(fileURLToPath(import.meta.url)), '..');
+
+const argv = process.argv.slice(2);
+const flag = (name, fallback) => {
+  const i = argv.indexOf(name);
+  return i >= 0 ? argv[i + 1] : fallback;
+};
+
+if (argv.includes('--help') || argv.includes('-h')) {
+  console.log(`Usage: incanto multiplay [scene.json] [options]
+
+  --players N        clients in the match (default 2)
+  --seconds N        simulated seconds (default 5)
+  --seed N           make the match reproducible (default 1)
+  --behaviors FILE   your Behavior subclasses (.ts works on bun / node >= 23.6)
+  --scenes a=b.json  a scene a NetworkSpawner names, repeatable
+  --no-late-join     skip the late-joining client
+  --json             machine-readable report
+
+Checks that every client holds the SAME value for every replicated key, plus
+one client that joins AFTER the match settles — the only observer that reads
+the authoritative snapshot fresh, and so the only one that can see a value
+erased from it.`);
+  process.exit(0);
+}
+
+const named = argv.find((a) => !a.startsWith('-') && a.endsWith('.json'));
+if (!named) {
+  console.error('incanto-multiplay: name the scene, e.g. src/game.scene.json');
+  process.exit(2);
+}
+const scenePath = resolve(named);
+if (!existsSync(scenePath)) {
+  console.error(`no such scene: ${scenePath}`);
+  process.exit(1);
+}
+
+const { playMultiplayer, multiplayText, registerAllNodes } = await import(
+  pathToFileURL(join(PKG, 'dist', 'test.js')).href
+);
+registerAllNodes();
+
+const sceneJson = JSON.parse(readFileSync(scenePath, 'utf-8'));
+const sceneDir = dirname(scenePath);
+
+// Without the game's own behaviours a scene that names one throws
+// `Unknown behavior` before a single frame runs — so load them when we are
+// given them, and stub what is left. A stubbed behaviour still lets the
+// SCENE's replication run, which is what this command measures.
+const behaviorsFile = flag('--behaviors', null);
+if (behaviorsFile) {
+  try {
+    const mod = await import(pathToFileURL(resolve(behaviorsFile)).href);
+    const { registerBehavior, Behavior } = await import(
+      pathToFileURL(join(PKG, 'dist', 'index.js')).href
+    );
+    for (const [name, value] of Object.entries(mod)) {
+      if (typeof value === 'function' && value.prototype instanceof Behavior) {
+        registerBehavior(name, value, { replace: true });
+      }
+    }
+  } catch (e) {
+    console.error(`could not load --behaviors '${behaviorsFile}' (${e?.message ?? e}).`);
+    process.exit(1);
+  }
+}
+
+/**
+ * Scenes a `NetworkSpawner` names.
+ *
+ * `--scenes remote-player=src/remote.scene.json` is explicit; otherwise every
+ * spawner's `scene` prop is looked for as a sibling file, which is where the
+ * templates put them. A spawner whose scene cannot be found materialises
+ * nothing, and the agreement check reports that as `missing` rather than
+ * letting it read as "this game has no remote players".
+ */
+const scenes = {};
+for (let i = 0; i < argv.length; i++) {
+  if (argv[i] !== '--scenes') continue;
+  const [key, file] = String(argv[i + 1] ?? '').split('=');
+  if (key && file) scenes[key] = JSON.parse(readFileSync(resolve(sceneDir, file), 'utf-8'));
+}
+const spawnerScenes = new Set();
+const walk = (node) => {
+  if (node?.type === 'NetworkSpawner' && typeof node.props?.scene === 'string') {
+    spawnerScenes.add(node.props.scene);
+  }
+  for (const child of node?.children ?? []) walk(child);
+};
+walk(sceneJson.root);
+for (const name of spawnerScenes) {
+  if (scenes[name]) continue;
+  for (const guess of [`${name}.scene.json`, `${name}.json`]) {
+    const at = resolve(sceneDir, guess);
+    if (existsSync(at)) {
+      scenes[name] = JSON.parse(readFileSync(at, 'utf-8'));
+      break;
+    }
+  }
+}
+
+let report;
+try {
+  report = await playMultiplayer({
+    scene: sceneJson,
+    scenes,
+    players: Number(flag('--players', 2)) || 2,
+    seconds: Number(flag('--seconds', 5)) || 5,
+    seed: Number(flag('--seed', 1)) || 1,
+    lateJoin: !argv.includes('--no-late-join'),
+    load: {
+      stubMissingBehaviors: true,
+      resolveScene: (p) => JSON.parse(readFileSync(resolve(sceneDir, p), 'utf-8')),
+    },
+    // Move the owner, or every replicated key holds its authored value and two
+    // motionless clients agree about nothing in particular.
+    drive: (player, frame) => {
+      const root = player.engine.scene?.root;
+      const owner = root && findOwner(root);
+      if (!owner || !Array.isArray(owner.position)) return;
+      const spin = (player.account.charCodeAt(1) || 1) * 0.7;
+      owner.position = owner.position.map((v, i) =>
+        i === 1 && owner.position.length === 3 ? v : Math.sin(frame / 20 + spin + i) * 4,
+      );
+    },
+  });
+} catch (e) {
+  console.error(`multiplay failed: ${e?.message ?? e}`);
+  process.exit(1);
+}
+
+/** The single `network.mode === 'owner'` node, the way the manager finds it. */
+function findOwner(node) {
+  if (node.network?.mode === 'owner') return node;
+  for (const child of node.children ?? []) {
+    const found = findOwner(child);
+    if (found) return found;
+  }
+  return null;
+}
+
+if (argv.includes('--json')) {
+  process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
+} else {
+  process.stdout.write(`${multiplayText(report)}\n`);
+}
+process.exit(report.ok ? 0 : 1);

package/bin/incanto-verify.mjs

@@ -19,7 +19,7 @@
  * what to arrange, and says so in the summary.
  */
 import { spawnSync } from 'node:child_process';
-import { existsSync, readdirSync, statSync } from 'node:fs';
+import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
 import { dirname, join, relative } from 'node:path';
 import { fileURLToPath, pathToFileURL } from 'node:url';
 
@@ -35,18 +35,21 @@ const flag = (name) => {
   return i >= 0 ? argv[i + 1] : null;
 };
 if (argv.includes('--help') || argv.includes('-h')) {
-  console.log(`Usage: incanto-verify [scene.json] [--behaviors FILE] [--json]
+  console.log(`Usage: incanto verify [scene.json] [--behaviors FILE] [--json]
 
 Walks the whole ladder and tells you the ONE thing to do next:
 
   loads   the scene is legal and every asset resolves       (incanto-check)
   plays   a seeded run can actually finish it               (incanto-playtest)
+  feels   the sounds and effects it declares actually fired (engine.audio/effects)
+  agrees  two clients hold the same replicated values       (incanto-multiplay)
   draws   the GPU drew something and the subject is in shot (incanto-frame)
   says    the running game logs no errors and lost no assets (incanto-logs)
 
 Without a scene it looks for one *.scene.json under the current directory.
-"draws" needs a dev server with the page open; without one it is reported as
-NOT MEASURED rather than failed — a missing measurement is not a broken game.`);
+"draws" needs a dev server with the page open, and "agrees" needs a scene with
+a "multiplayer" header; without either they are reported as NOT MEASURED rather
+than failed — a missing measurement is not a broken game.`);
   process.exit(0);
 }
 
@@ -274,6 +277,67 @@ if (rungs[0].status === 'pass') {
   }
 }
 
+// ---- agrees --------------------------------------------------------------
+// A desync is the purest silent failure this engine has: both clients run,
+// neither errors, and they are playing different games. Skipped outright for a
+// single-player game, because a rung that always passes is decoration.
+{
+  const isMultiplayer = (() => {
+    try {
+      const doc = JSON.parse(readFileSync(scene, 'utf-8'));
+      return Boolean(doc?.multiplayer);
+    } catch {
+      return false;
+    }
+  })();
+  if (!isMultiplayer) {
+    rungs.push({
+      name: 'agrees',
+      status: 'skipped',
+      summary: 'not run — this scene has no `multiplayer` header',
+    });
+  } else {
+    const args = [scene, '--json', '--seconds', '4'];
+    if (behaviors) args.push('--behaviors', behaviors);
+    const r = run('multiplay', args);
+    const out = safeJson(r.stdout);
+    if (!out) {
+      rungs.push({
+        name: 'agrees',
+        status: 'unmeasured',
+        summary: `the match could not run — ${firstLine(r.stderr) || `exit ${r.status}`}`,
+        fix: `see it in full: \`incanto multiplay ${scene}\``,
+      });
+    } else if (out.keysCompared === 0) {
+      // Nothing moved, so nothing was compared. Saying "pass" here is how a
+      // rung becomes decorative.
+      rungs.push({
+        name: 'agrees',
+        status: 'unmeasured',
+        summary: 'no owner node declared any sync keys, so agreement was not tested',
+        fix: 'give the player node `network: { mode: "owner", sync: ["position"] }`',
+      });
+    } else if (out.ok) {
+      rungs.push({
+        name: 'agrees',
+        status: 'pass',
+        summary:
+          `${out.keysCompared} replicated value(s) match across clients` +
+          `${out.lateJoinChecked ? ' and a late joiner' : ''}` +
+          ' — over one in-memory server, not a live wire',
+      });
+    } else {
+      const first = out.disagreements?.[0];
+      rungs.push({
+        name: 'agrees',
+        status: 'fail',
+        summary: first ? first.summary : (out.problems?.[0] ?? 'the clients disagreed'),
+        fix: `every disagreement: \`incanto multiplay ${scene}\``,
+      });
+    }
+  }
+}
+
 // ---- draws ---------------------------------------------------------------
 {
   const r = run('frame', ['--json']);

package/bin/incanto.mjs

@@ -35,6 +35,7 @@ const COMMANDS = {
   check: ['incanto-check.mjs', 'validate scene JSON and the assets it names'],
   verify: ['incanto-verify.mjs', 'the whole ladder: loads · plays · feels · draws · says'],
   playtest: ['incanto-playtest.mjs', 'drive the game headlessly and report what happened'],
+  multiplay: ['incanto-multiplay.mjs', 'run a real match and check the clients agree'],
   play: ['incanto-play.mjs', 'run a scene headlessly for a fixed span'],
   feel: ['incanto-feel.mjs', 'measure jump height, run speed, facing'],
   frame: ['incanto-frame.mjs', 'what the running page is drawing right now'],

package/dist/2d.d.ts

@@ -1,8 +1,8 @@
-import { At as Node, P as Scene$1, S as Scheduler, T as RendererStats, b as Engine, d as PropSchema, n as BehaviorCtor, w as GameStats } from "./behavior-l08AEbq9.js";
+import { At as Node, P as Scene$1, S as Scheduler, T as RendererStats, b as Engine, d as PropSchema, n as BehaviorCtor, w as GameStats } from "./behavior-DWKTUzKI.js";
 import { n as DiagnosticSink, t as EditorSwitchOptions } from "./editor-switch-DAvWQeld.js";
 import { i as SceneJson, s as JsonObject } from "./schema-CFeioQRE.js";
 import { r as FrameStats } from "./frame-report-DCnHFmto.js";
-import { t as LoadSceneOptions } from "./loader-BbEMTuWg.js";
+import { t as LoadSceneOptions } from "./loader-TvkRFbyL.js";
 import { n as AnimationEntry } from "./sprite-animation-CMr6f1K2.js";
 import { r as ParticleView, t as ParticleSim } from "./particle-sim-C5OfBbmU.js";
 import { Group, Mesh, Object3D, Scene, Texture } from "three";
@@ -107,6 +107,9 @@ declare class PhysicsBody2D extends Node2D {
   private _collider;
   /** @internal Physics resync flag — raised when `collider` is REPLACED. */
   _colliderChanged: boolean;
+  private _enabled;
+  /** @internal Physics resync flag — raised when `enabled` is written. */
+  _enabledChanged: boolean;
   /**
   * Collider shape prop. Change it by REPLACING the object
   * (`body.collider = { shape: 'box', size: [...] }`) — physics rebuilds the
@@ -114,6 +117,9 @@ declare class PhysicsBody2D extends Node2D {
   */
   get collider(): JsonObject;
   set collider(value: JsonObject);
+  /** See the `enabled` prop. Writing it arms or disarms the existing collider. */
+  get enabled(): boolean;
+  set enabled(value: boolean);
   /** Loader hook: bad collider shapes fail at LOAD, not at physics start. */
   static validateJson(node: Node): void;
   /** @internal Set by Physics2D when the body is created. */

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-BZwWJIns.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-C6ZBFRjd.js";
-import { n as enablePhysics2D, t as Physics2D } from "./physics-2d-EqA-jddf.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.d.ts

@@ -1,10 +1,10 @@
-import { At as Node, D as QualityCaps, P as Scene$1, S as Scheduler, T as RendererStats, b as Engine, d as PropSchema, n as BehaviorCtor, w as GameStats } from "./behavior-l08AEbq9.js";
+import { At as Node, D as QualityCaps, P as Scene$1, S as Scheduler, T as RendererStats, b as Engine, d as PropSchema, n as BehaviorCtor, w as GameStats } from "./behavior-DWKTUzKI.js";
 import { n as DiagnosticSink, t as EditorSwitchOptions } from "./editor-switch-DAvWQeld.js";
 import { i as SceneJson$1, s as JsonObject } from "./schema-CFeioQRE.js";
 import { a as GridCell, c as diffText, d as frameText, i as FrameStatsOptions, l as frameSignature, n as FrameSignature, o as SIGNATURE_GRID, r as FrameStats, s as diffSignatures, t as FrameDiff, u as frameStats } from "./frame-report-DCnHFmto.js";
-import { t as LoadSceneOptions } from "./loader-BbEMTuWg.js";
+import { t as LoadSceneOptions } from "./loader-TvkRFbyL.js";
 import { r as ParticleView, t as ParticleSim } from "./particle-sim-C5OfBbmU.js";
-import { n as PathGrid, s as SpatialPose } from "./pathfinding-mEN4V1CU.js";
+import { n as PathGrid, s as SpatialPose } from "./pathfinding-BqWBb0kh.js";
 import { AnimationClip, AnimationMixer, BufferGeometry, Color, DirectionalLight, Group, InstancedMesh, Mesh, MeshPhysicalMaterial, Object3D, PerspectiveCamera, Scene, ShaderMaterial, Texture, Vector3, WebGLRenderer } from "three";
 import { VRM } from "@pixiv/three-vrm";
 import { Sky } from "three/examples/jsm/objects/Sky.js";
@@ -333,6 +333,9 @@ declare class PhysicsBody3D extends Node3D {
   private _collider;
   /** @internal Physics resync flag — raised when `collider` is REPLACED. */
   _colliderChanged: boolean;
+  private _enabled;
+  /** @internal Physics resync flag — raised when `enabled` is written. */
+  _enabledChanged: boolean;
   /**
   * Collider shape prop. Change it by REPLACING the object
   * (`body.collider = { shape: 'box', size: [...] }`) — physics rebuilds the
@@ -340,6 +343,9 @@ declare class PhysicsBody3D extends Node3D {
   */
   get collider(): JsonObject;
   set collider(value: JsonObject);
+  /** See the `enabled` prop. Writing it arms or disarms the existing collider. */
+  get enabled(): boolean;
+  set enabled(value: boolean);
   /** Loader hook: bad collider shapes fail at LOAD, not at physics start. */
   static validateJson(node: Node): void;
   /** @internal Set by Physics3D when the body is created. */

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-BVphcxmE.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-CvvQr_bJ.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-D10bU5_J.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-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-Dnz4fsXX.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/{behavior-l08AEbq9.d.ts → behavior-DWKTUzKI.d.ts}

@@ -1033,6 +1033,16 @@ declare class Localization {
   * `startsWith` per widget per frame and nothing else.
   */
   resolve(value: string, params?: Record<string, JsonValue>): string;
+  /**
+  * 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: string): boolean;
   /** Whether any locale declares this key — for the audit, not for the runtime. */
   has(key: string): boolean;
 }

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

@@ -1,14 +1,14 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { A as registerBehavior, C as diagnose, n as loadScene } from "./loader-BcrRSjxB.js";
-import { _ as Engine, g as AudioPlayer, x as qualityRendering, y as qualityCaps } from "./register-Ch70uByv.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-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-Cs113S9F.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-BVphcxmE.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-CvvQr_bJ.js";
-import { n as enablePhysics3D } from "./physics-3d-Dnz4fsXX.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-BZwWJIns.js → create-game-ClnIb_M5.js}

@@ -1,14 +1,14 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { A as registerBehavior, C as diagnose, n as loadScene, o as computeViewport, s as resolveViewport } from "./loader-BcrRSjxB.js";
-import { _ as Engine, g as AudioPlayer } from "./register-Ch70uByv.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-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-Cs113S9F.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-BVphcxmE.js";
-import { g as PhysicsBody2D, n as UILayer, t as registerNodes2D, u as Camera2D, y as Node2D } from "./register-C6ZBFRjd.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-BSu2dWGC.js";
 import { t as debugSources } from "./debug-draw-BM3DsvtT.js";
-import { n as enablePhysics2D } from "./physics-2d-EqA-jddf.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/debug.d.ts

@@ -1,4 +1,4 @@
-import { Pt as LogLevel, T as RendererStats, b as Engine } from "./behavior-l08AEbq9.js";
+import { Pt as LogLevel, T as RendererStats, b as Engine } from "./behavior-DWKTUzKI.js";
 
 //#region src/debug/panel.d.ts
 /** Minimal document surface the overlay needs (injectable for tests). */

package/dist/debug.js

@@ -1,5 +1,5 @@
-import { t as jsonClone } from "./json-BLk7H2Qa.js";
-import { s as mergeStaticProps } from "./registry-C7u42TID.js";
+import { t as jsonClone } from "./json-CwwhxQgb.js";
+import { s as mergeStaticProps } from "./registry-WWcQcfMr.js";
 import { t as debugSources } from "./debug-draw-BM3DsvtT.js";
 //#region src/debug/capture.ts
 /**

package/dist/{duplicate-BPLZDZpd.js → duplicate-DJQd44CD.js}

@@ -1,4 +1,4 @@
-import { i as serializeNode, t as buildNodeJson } from "./loader-BcrRSjxB.js";
+import { a as serializeNode, t as buildNodeJson } from "./loader-D8n7TU8W.js";
 //#region src/core/scene/duplicate.ts
 function stripUids(json) {
 	const { uid: _uid, ...rest } = json;

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

@@ -1,11 +1,11 @@
-import { C as diagnose } from "./loader-BcrRSjxB.js";
-import { t as registerCoreNodes } from "./register-Ch70uByv.js";
+import { 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 getNodeSchema, l as registerNode } from "./registry-WWcQcfMr.js";
 import { t as createNoise2D } from "./noise-CGUMx44x.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 { B as StaticBody3D, F as WaterCutout3D, G as colliderFootDrop, I as Area3D, L as CharacterBody3D, N as Water3D, R as PhysicsBody3D, V as Node3D, w as tolerateUnknownAction, z as RigidBody3D } from "./gameplay-BVphcxmE.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 { B as StaticBody3D, F as WaterCutout3D, G as colliderFootDrop, I as Area3D, L as CharacterBody3D, N as Water3D, R as PhysicsBody3D, V as Node3D, w as tolerateUnknownAction, z as RigidBody3D } from "./gameplay-BBEjPFsR.js";
 import { t as checkSheetGrid } from "./sheet-grid-BT6N_Bjs.js";
 import { n as splatWeights, t as buildHeightmap } from "./heightmap-CRK0M4jT.js";
 import { AdditiveBlending, AnimationClip, AnimationMixer, Box3, BoxGeometry, BufferAttribute, BufferGeometry, CanvasTexture, CapsuleGeometry, ClampToEdgeWrapping, Color, ConeGeometry, CylinderGeometry, DataTexture, DirectionalLight, DoubleSide, DynamicDrawUsage, Euler, Group, IcosahedronGeometry, ImageBitmapLoader, InstancedBufferAttribute, InstancedMesh, LinearFilter, LinearMipmapLinearFilter, LoopOnce, LoopRepeat, Matrix4, Mesh, MeshBasicMaterial, MeshDepthMaterial, MeshPhysicalMaterial, MeshStandardMaterial, NearestFilter, NoBlending, NoColorSpace, NormalBlending, PerspectiveCamera, PlaneGeometry, PointLight, Points, PointsMaterial, Quaternion, QuaternionKeyframeTrack, RGBADepthPacking, RGBAFormat, RepeatWrapping, SRGBColorSpace, ShaderChunk, ShaderMaterial, SphereGeometry, Texture, TextureLoader, UniformsLib, UniformsUtils, Vector3, Vector4, VectorKeyframeTrack } from "three";
@@ -5837,8 +5837,9 @@ var Label3D = class extends Sprite3D {
 	canvasTexture = null;
 	lastKey = "";
 	resolveTexture(_assets) {
-		if (this.text === "" || typeof document === "undefined") return null;
-		const key = `${this.text}\0${this.height}\0${this.color}\0${this.font}\0${this.outline}`;
+		const text = translateOn(this, this.text);
+		if (text === "" || typeof document === "undefined") return null;
+		const key = `${text}\0${this.height}\0${this.color}\0${this.font}\0${this.outline}`;
 		if (key !== this.lastKey) {
 			this.lastKey = key;
 			this.rasterize();
@@ -5847,6 +5848,7 @@ var Label3D = class extends Sprite3D {
 	}
 	/** Draw the text once, and size the quad to what it measured. */
 	rasterize() {
+		const text = translateOn(this, this.text);
 		const fontPx = Math.max(8, Math.round(this.height * 256));
 		this.canvas ??= document.createElement("canvas");
 		const ctx = this.canvas.getContext("2d");
@@ -5854,7 +5856,7 @@ var Label3D = class extends Sprite3D {
 		const stroke = Math.max(1, Math.round(fontPx * .14));
 		const fontSpec = `bold ${fontPx}px ${this.font}`;
 		ctx.font = fontSpec;
-		const width = Math.max(1, Math.ceil(ctx.measureText(this.text).width) + stroke * 2);
+		const width = Math.max(1, Math.ceil(ctx.measureText(text).width) + stroke * 2);
 		const lineHeight = Math.ceil(fontPx * 1.35) + stroke * 2;
 		this.canvas.width = width;
 		this.canvas.height = lineHeight;
@@ -5865,10 +5867,10 @@ var Label3D = class extends Sprite3D {
 			ctx.lineWidth = stroke;
 			ctx.lineJoin = "round";
 			ctx.strokeStyle = this.outline;
-			ctx.strokeText(this.text, width / 2, lineHeight / 2);
+			ctx.strokeText(text, width / 2, lineHeight / 2);
 		}
 		ctx.fillStyle = this.color;
-		ctx.fillText(this.text, width / 2, lineHeight / 2);
+		ctx.fillText(text, width / 2, lineHeight / 2);
 		this.canvasTexture?.dispose();
 		const texture = new CanvasTexture(this.canvas);
 		texture.colorSpace = SRGBColorSpace;