incanto 0.34.0 → 0.35.0

package/dist/2d.d.ts

@@ -1,8 +1,8 @@
-import { C as RendererStats, N as Scene$1, S as GameStats, at as Node, b as Scheduler, l as PropSchema, n as BehaviorCtor, v as Engine } from "./behavior-CtPScDMo.js";
-import { n as DiagnosticSink, t as EditorSwitchOptions } from "./editor-switch-BJb-CWfA.js";
-import { i as SceneJson, s as JsonObject } from "./schema-CcoWb32N.js";
-import { t as LoadSceneOptions } from "./loader-DmXfj6Uv.js";
-import { t as ParticleSim } from "./particle-sim-CwJ5rI_P.js";
+import { N as Scene$1, S as Scheduler, T as RendererStats, b as Engine, bt as Node, d as PropSchema, n as BehaviorCtor, w as GameStats } from "./behavior-CGSCWOHB.js";
+import { n as DiagnosticSink, t as EditorSwitchOptions } from "./editor-switch-DyXEtH36.js";
+import { i as SceneJson, s as JsonObject } from "./schema-3ywbdlrv.js";
+import { t as LoadSceneOptions } from "./loader-CUcj00M8.js";
+import { t as ParticleSim } from "./particle-sim-B-vZBF5R.js";
 import { Group, Mesh, Object3D, Scene, Texture } from "three";
 import * as RapierNs from "@dimforge/rapier2d-compat";
 

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-CFNqoqOX.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-BLPC10Mj.js";
-import { n as enablePhysics2D, t as Physics2D } from "./physics-2d-BuyAwsW5.js";
+import { a as AssetStore2D, i as syncTree2D, r as Renderer2D, t as createGame2D } from "./create-game-B0Wfhi2-.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-DSmIRAf7.js";
+import { n as enablePhysics2D, t as Physics2D } from "./physics-2d-DqAclql-.js";
 //#region src/2d/library-sprite.ts
 /**
 * Turn a library sprite-animation JSON into a scene-ready spritesheet asset

package/dist/3d.d.ts

@@ -1,14 +1,92 @@
-import { C as RendererStats, N as Scene$1, S as GameStats, at as Node, b as Scheduler, l as PropSchema, n as BehaviorCtor, v as Engine } from "./behavior-CtPScDMo.js";
-import { n as DiagnosticSink, t as EditorSwitchOptions } from "./editor-switch-BJb-CWfA.js";
-import { i as SceneJson, s as JsonObject } from "./schema-CcoWb32N.js";
-import { t as LoadSceneOptions } from "./loader-DmXfj6Uv.js";
-import { t as ParticleSim } from "./particle-sim-CwJ5rI_P.js";
-import { n as PathGrid, s as SpatialPose } from "./pathfinding-DRCe89SI.js";
-import { AnimationClip, AnimationMixer, BufferGeometry, Color, DirectionalLight, Group, InstancedMesh, Mesh, MeshPhysicalMaterial, Object3D, PerspectiveCamera, Scene, ShaderMaterial, Vector3, WebGLRenderer } from "three";
+import { N as Scene$1, S as Scheduler, T as RendererStats, b as Engine, bt as Node, d as PropSchema, n as BehaviorCtor, w as GameStats } from "./behavior-CGSCWOHB.js";
+import { n as DiagnosticSink, t as EditorSwitchOptions } from "./editor-switch-DyXEtH36.js";
+import { i as SceneJson, s as JsonObject } from "./schema-3ywbdlrv.js";
+import { t as LoadSceneOptions } from "./loader-CUcj00M8.js";
+import { t as ParticleSim } from "./particle-sim-B-vZBF5R.js";
+import { n as PathGrid, s as SpatialPose } from "./pathfinding-DgOo2KNF.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";
 import * as RapierNs from "@dimforge/rapier3d-compat";
 
+//#region src/3d/textures.d.ts
+/** Where a diagnostic goes when a texture fails to load. */
+interface TextureDiagnostics {
+  warn(...parts: unknown[]): void;
+}
+interface TextureSpec {
+  /** sRGB for anything the eye reads as colour; linear for data maps. */
+  colorSpace?: "srgb" | "linear";
+  /** `nearest` also turns mipmaps OFF — pixel art mipmapped is mud. */
+  filter?: "linear" | "nearest";
+  wrap?: "clamp" | "repeat";
+  anisotropy?: number;
+  /**
+  * A one-shot rewrite of the decoded image, applied to the MASTER once.
+  *
+  * `Tree3D`'s green-matte pass is the only user: it is deterministic per URL,
+  * so it belongs on the shared image rather than being redone per node. The
+  * `id` is part of the cache key, so the same URL with and without a process
+  * are two different entries.
+  */
+  process?: {
+    id: string;
+    run(texture: Texture): void;
+  };
+}
+/** The loader seam, so a node-environment test can count real load calls. */
+type TextureLoad3D = (url: string, onError: (error: unknown) => void) => Texture;
+declare class TextureCache3D {
+  private readonly entries;
+  private readonly load;
+  private readonly diagnostics;
+  constructor(opts?: {
+    loader?: TextureLoad3D;
+    diagnostics?: TextureDiagnostics | null;
+  });
+  /**
+  * The SHARED texture for this url+spec, or null with no DOM to decode in.
+  *
+  * Callers must NOT mutate `offset`/`repeat`/`center`/`rotation` on it — that
+  * is what `acquireOwn` is for — and must not dispose it; the store owns it.
+  */
+  acquire(url: string, spec?: TextureSpec): Texture | null;
+  /**
+  * A private CLONE, for a node that writes its own UV window.
+  *
+  * The caller owns it and disposes it in `free()`. That is safe: three
+  * refcounts the GPU texture per `source`, so disposing one clone does not
+  * pull the image out from under the others.
+  */
+  acquireOwn(url: string, spec?: TextureSpec): Texture | null;
+  /**
+  * What 404'd, by URL — reported raw, never by cache key, because an agent
+  * greps this against the URL it wrote.
+  */
+  errors(): {
+    url: string;
+    error: string;
+  }[];
+  /** How many distinct images this store has decoded — the point, measurable. */
+  size(): number;
+  dispose(): void;
+}
+/**
+* The one call a node makes: shared texture through the store, or an uncached
+* load when there is no store (a detached probe, a headless test).
+*
+* The fallback is deliberately silent and deliberately uncached — a node that
+* renders outside a renderer walk is a legitimate case (`Tree3D._trunk()` builds
+* detached), and failing there would be worse than doing the work twice.
+*/
+declare function acquireTexture(assets: {
+  textures: TextureCache3D;
+} | null, url: string, spec?: TextureSpec): Texture | null;
+/** As `acquireTexture`, but a private clone for a node with its own UV window. */
+declare function acquireOwnTexture(assets: {
+  textures: TextureCache3D;
+} | null, url: string, spec?: TextureSpec): Texture | null;
+//#endregion
 //#region src/3d/assets.d.ts
 interface ModelEntry {
   status: "loading" | "ready" | "error";
@@ -51,6 +129,12 @@ declare class AssetStore3D {
   private readonly animationKeys;
   private readonly loader;
   /**
+  * Shared textures, store-scoped like everything else here. Instance state, not
+  * a module map: two games on one page must not share a decode cache, and the
+  * repo has one rule about module-level engine state.
+  */
+  readonly textures: TextureCache3D;
+  /**
   * `engine` is optional only so a bare store still constructs in tests. Give it
   * one and every load failure lands in `engine.log` — where the debug overlay,
   * `runScript()` and any agent tool can see it. Without it a 404'd GLB was a
@@ -214,8 +298,15 @@ declare class Node3D extends Node {
   protected _createObject3D(): Object3D;
   /** @internal Push JSON props onto the backing object. Called every frame.
   *  `alpha` (0..1) interpolates a physics body between its last two fixed-step
-  *  positions; non-physics nodes ignore it and render `position` directly. */
-  _syncObject3D(alpha?: number): void;
+  *  positions; non-physics nodes ignore it and render `position` directly.
+  *
+  *  `assets` is the renderer's store, the only route a node has to shared
+  *  textures — mirroring `_syncObject2D(assets)`, which has always taken it. It
+  *  is a PARAMETER rather than a field so a node that forgets it is a type
+  *  error rather than a silent per-node decode; overrides that do not need it
+  *  simply keep the one-argument signature. Null in a headless test or a
+  *  detached probe, where the node falls back to loading uncached. */
+  _syncObject3D(alpha?: number, _assets?: AssetStore3D | null): void;
   override free(): void;
 }
 //#endregion
@@ -1415,12 +1506,31 @@ declare class MeshInstance3D extends Node3D {
   private textureKey;
   private loadedTextures;
   protected override _createObject3D(): Object3D;
-  override _syncObject3D(): void;
+  override _syncObject3D(alpha?: number, assets?: AssetStore3D | null): void;
   /** Lazy texture dressing — same headless guard as Tree3D bark: without a
   * DOM there is no Image decode, so geometry/colors apply and the maps are
   * skipped. Re-loads only when a texture-shaping key changes. */
   private syncTextures;
+  /**
+  * A private CLONE: `repeat` is per-node here (a 1x1 crate and a 8x8 floor
+  * share one tile image), and that is the one field a shared master cannot
+  * carry. The clone shares `texture.source`, so the fetch and the decode are
+  * still done once per url for the whole scene.
+  */
   private loadTexture;
+  /**
+  * Give the GPU back everything this node OWNS.
+  *
+  * It used to dispose textures and nothing else, so every freed mesh leaked its
+  * geometry and its material — a wave spawner that kills and respawns fifty
+  * enemies a minute leaks fifty of each, forever, and nothing in the game says
+  * so. Both are built here (`_createObject3D` news them, `_syncObject3D`
+  * rebuilds the geometry on a shape change), so both are ours to release.
+  *
+  * The textures are NOT: since the shared texture cache they belong to the
+  * asset store, except the per-node clones this node asked for, which are what
+  * `loadedTextures` holds.
+  */
   override free(): void;
 }
 //#endregion
@@ -2419,7 +2529,6 @@ declare class Terrain3D extends Node3D {
   private heightmap;
   private heightmapKey;
   private builtKey;
-  private loadedTextures;
   protected override _createObject3D(): Object3D;
   /**
   * Terrain surface height (world y) at WORLD x/z — works headless, before
@@ -2442,14 +2551,13 @@ declare class Terrain3D extends Node3D {
   private rememberShape;
   /** The splat layers in effect — theme preset, or `layers` for 'custom'. */
   resolvedLayers(): TerrainLayer[];
-  override _syncObject3D(): void;
+  override _syncObject3D(alpha?: number, assets?: AssetStore3D | null): void;
   private effectiveIslandEdge;
   private segments;
   /** Rebuild geometry+material only when a terrain-shaping prop changed. */
   private rebuildIfNeeded;
   private buildGeometry;
   private buildMaterial;
-  private disposeTextures;
   override free(): void;
 }
 //#endregion
@@ -3344,4 +3452,4 @@ declare function createNavDebugNode(nav: TerrainNav, opts?: {
   name?: string;
 }): InstancedMesh3D;
 //#endregion
-export { Area3D, AssetStore3D, type BedSampler, Billboard3D, type BillboardGroupMode, BoneAttachment3D, BoneLookAt3D, Camera3D, CharacterBody3D, CharacterController3D, type CreateGame3DOptions, DEFAULT_TERRAIN_TEXTURE_BASE, DirectionalLight3D, type DownhillTraceOptions, Environment3D, type Environment3DConfig, DENSITY_PRESETS as FLOWER_DENSITY_PRESETS, FLOWER_VARIETIES, type FlowerVariety, Flowers3D, type FogEnvironment, Foliage3D, type FoliageKind, type FoliageStyle, type Game3D, type HeightSampler, type Heightmap, type HeightmapOptions, InstancedMesh3D, Joint3D, type JointType3D, LoftMesh3D, type LoftSection, MeshInstance3D, type MeshKind, type MeshMaterialProps, type ModelEntry, ModelInstance3D, Node3D, OmniLight3D, Particles3D, Physics3D, type Physics3DOptions, PhysicsBody3D, QUARTER_PITCH, type RenderContext3D, type RenderHook3D, Renderer3D, type Renderer3DOptions, type RigView, RigidBody3D, type Ripple, River3D, type RiverCarveOptions, type RiverCoverageGap, type RiverHit, type RiverRing, type RiverRingOptions, type ShadowsEnvironment, type SkyEnvironment, StaticBody3D, type SunConsumer3D, type SyncOptions, type SyncResult, TERRAIN_THEMES, Terrain3D, type TerrainLayer, type TerrainNav, type TerrainNavOptions, type TerrainTheme, Trail3D, Tree3D, type TreeTier, type TreeType, VOXEL_PALETTE, type VoxelBlock, VoxelGrid3D, WATER_CUTOUT_MAX, WATER_MAX_RIPPLES, Water3D, WaterCutout3D, buildHeightmap, buildRiverRings, buildTerrainNav, cameraRelative, createGame3D, createNavDebugNode, enablePhysics3D, findRiverCoverageGaps, horizonColorFromSky, keyboardIntensity, movementState, parseEnvironment3D, projectToRiver, registerNodes3D, resolveFlowerDensity, rigPose, riverCarveChannels, riverStepFor, setEnvironment3D, smoothCourse, splatWeights, sunDirectionFromElevationAzimuth, sunDirectionFromSky, syncTree, terrainThemeLayers, traceDownhillPath };
+export { Area3D, AssetStore3D, type BedSampler, Billboard3D, type BillboardGroupMode, BoneAttachment3D, BoneLookAt3D, Camera3D, CharacterBody3D, CharacterController3D, type CreateGame3DOptions, DEFAULT_TERRAIN_TEXTURE_BASE, DirectionalLight3D, type DownhillTraceOptions, Environment3D, type Environment3DConfig, DENSITY_PRESETS as FLOWER_DENSITY_PRESETS, FLOWER_VARIETIES, type FlowerVariety, Flowers3D, type FogEnvironment, Foliage3D, type FoliageKind, type FoliageStyle, type Game3D, type HeightSampler, type Heightmap, type HeightmapOptions, InstancedMesh3D, Joint3D, type JointType3D, LoftMesh3D, type LoftSection, MeshInstance3D, type MeshKind, type MeshMaterialProps, type ModelEntry, ModelInstance3D, Node3D, OmniLight3D, Particles3D, Physics3D, type Physics3DOptions, PhysicsBody3D, QUARTER_PITCH, type RenderContext3D, type RenderHook3D, Renderer3D, type Renderer3DOptions, type RigView, RigidBody3D, type Ripple, River3D, type RiverCarveOptions, type RiverCoverageGap, type RiverHit, type RiverRing, type RiverRingOptions, type ShadowsEnvironment, type SkyEnvironment, StaticBody3D, type SunConsumer3D, type SyncOptions, type SyncResult, TERRAIN_THEMES, Terrain3D, type TerrainLayer, type TerrainNav, type TerrainNavOptions, type TerrainTheme, TextureCache3D, type TextureSpec, Trail3D, Tree3D, type TreeTier, type TreeType, VOXEL_PALETTE, type VoxelBlock, VoxelGrid3D, WATER_CUTOUT_MAX, WATER_MAX_RIPPLES, Water3D, WaterCutout3D, acquireOwnTexture, acquireTexture, buildHeightmap, buildRiverRings, buildTerrainNav, cameraRelative, createGame3D, createNavDebugNode, enablePhysics3D, findRiverCoverageGaps, horizonColorFromSky, keyboardIntensity, movementState, parseEnvironment3D, projectToRiver, registerNodes3D, resolveFlowerDensity, rigPose, riverCarveChannels, riverStepFor, setEnvironment3D, smoothCourse, splatWeights, sunDirectionFromElevationAzimuth, sunDirectionFromSky, syncTree, terrainThemeLayers, traceDownhillPath };

package/dist/3d.js

@@ -1,9 +1,9 @@
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
-import { A as Water3D, F as PhysicsBody3D, I as RigidBody3D, L as StaticBody3D, M as WaterCutout3D, N as Area3D, P as CharacterBody3D, R as Node3D, V as WATER_MAX_RIPPLES, j as WATER_CUTOUT_MAX } from "./gameplay-BxFtmfSe.js";
-import { a as Environment3D, c as sunDirectionFromElevationAzimuth, i as syncTree, l as sunDirectionFromSky, o as horizonColorFromSky, r as Renderer3D, s as parseEnvironment3D, t as createGame3D, u as AssetStore3D } from "./create-game-QTfghzwM.js";
-import { A as Terrain3D, B as keyboardIntensity, C as resolveFlowerDensity, D as BoneLookAt3D, E as Camera3D, F as InstancedMesh3D, 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, V as movementState, _ 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-B6WiUsaO.js";
+import { A as Water3D, F as PhysicsBody3D, I as RigidBody3D, L as StaticBody3D, M as WaterCutout3D, N as Area3D, P as CharacterBody3D, R as Node3D, V as WATER_MAX_RIPPLES, j as WATER_CUTOUT_MAX } from "./gameplay-BvhcQbfJ.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-TAGvmM3z.js";
+import { a as Environment3D, c as sunDirectionFromElevationAzimuth, i as syncTree, l as sunDirectionFromSky, o as horizonColorFromSky, r as Renderer3D, s as parseEnvironment3D, t as createGame3D, u as AssetStore3D } from "./create-game-BUD89Kqh.js";
 import { n as splatWeights, t as buildHeightmap } from "./heightmap-CRK0M4jT.js";
-import { n as enablePhysics3D, t as Physics3D } from "./physics-3d-C8Kn_Nyb.js";
+import { n as enablePhysics3D, t as Physics3D } from "./physics-3d-DxBH4sIF.js";
 //#region src/3d/environment-runtime.ts
 /**
 * Live environment editing — the renderer re-applies `scene.environment`
@@ -142,4 +142,4 @@ function createNavDebugNode(nav, opts) {
 	return node;
 }
 //#endregion
-export { Area3D, AssetStore3D, Billboard3D, BoneAttachment3D, BoneLookAt3D, Camera3D, CharacterBody3D, CharacterController3D, DEFAULT_TERRAIN_TEXTURE_BASE, DirectionalLight3D, Environment3D, DENSITY_PRESETS as FLOWER_DENSITY_PRESETS, FLOWER_VARIETIES, Flowers3D, Foliage3D, InstancedMesh3D, Joint3D, LoftMesh3D, MeshInstance3D, ModelInstance3D, Node3D, OmniLight3D, Particles3D, Physics3D, PhysicsBody3D, QUARTER_PITCH, Renderer3D, RigidBody3D, River3D, StaticBody3D, TERRAIN_THEMES, Terrain3D, Trail3D, Tree3D, VOXEL_PALETTE, VoxelGrid3D, WATER_CUTOUT_MAX, WATER_MAX_RIPPLES, Water3D, WaterCutout3D, buildHeightmap, buildRiverRings, buildTerrainNav, cameraRelative, createGame3D, createNavDebugNode, enablePhysics3D, findRiverCoverageGaps, horizonColorFromSky, keyboardIntensity, movementState, parseEnvironment3D, projectToRiver, registerNodes3D, resolveFlowerDensity, rigPose, riverCarveChannels, riverStepFor, setEnvironment3D, smoothCourse, splatWeights, sunDirectionFromElevationAzimuth, sunDirectionFromSky, syncTree, terrainThemeLayers, traceDownhillPath };
+export { Area3D, AssetStore3D, Billboard3D, BoneAttachment3D, BoneLookAt3D, Camera3D, CharacterBody3D, CharacterController3D, DEFAULT_TERRAIN_TEXTURE_BASE, DirectionalLight3D, Environment3D, DENSITY_PRESETS as FLOWER_DENSITY_PRESETS, FLOWER_VARIETIES, Flowers3D, Foliage3D, InstancedMesh3D, Joint3D, LoftMesh3D, MeshInstance3D, ModelInstance3D, Node3D, OmniLight3D, Particles3D, Physics3D, PhysicsBody3D, QUARTER_PITCH, Renderer3D, RigidBody3D, River3D, StaticBody3D, TERRAIN_THEMES, Terrain3D, TextureCache3D, Trail3D, Tree3D, VOXEL_PALETTE, VoxelGrid3D, WATER_CUTOUT_MAX, WATER_MAX_RIPPLES, Water3D, WaterCutout3D, acquireOwnTexture, acquireTexture, buildHeightmap, buildRiverRings, buildTerrainNav, cameraRelative, createGame3D, createNavDebugNode, enablePhysics3D, findRiverCoverageGaps, horizonColorFromSky, keyboardIntensity, movementState, parseEnvironment3D, projectToRiver, registerNodes3D, resolveFlowerDensity, rigPose, riverCarveChannels, riverStepFor, setEnvironment3D, smoothCourse, splatWeights, sunDirectionFromElevationAzimuth, sunDirectionFromSky, syncTree, terrainThemeLayers, traceDownhillPath };

package/dist/{audit-C4kmDK0o.js → audit-C5oZGAru.js}

@@ -1,3 +1,4 @@
+import { A as translationKey } from "./register-BFLg0-_i.js";
 //#region src/core/audit.ts
 const ANIMATED_TYPES = new Set([
 	"Particles2D",
@@ -68,7 +69,43 @@ function auditScene(scene) {
 	if (cameras > 0 && currentCameras === 0) warnings.push("no camera has \"current\": true — the screen renders from a default view, probably not what you framed.");
 	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 auditStrings(scene)) warnings.push(warning);
 	return warnings;
 }
+/**
+* Translation keys nothing declares — the ONE localization mistake worth
+* reporting.
+*
+* A key present in `en` and missing from `ko` is not a mistake: falling back to
+* the English is the intended outcome whenever the English term is the more
+* precise one, or the translation would not fit. That case is silent by design
+* (see core/localization.ts).
+*
+* A key missing from EVERY locale is a typo, and the player sees the raw key on
+* 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;
+	const declared = /* @__PURE__ */ new Set();
+	for (const entries of Object.values(tables ?? {})) for (const key of Object.keys(entries)) declared.add(key);
+	const missing = /* @__PURE__ */ new Set();
+	const walk = (value) => {
+		if (typeof value === "string") {
+			const key = translationKey(value);
+			if (key !== null && !declared.has(key)) missing.add(key);
+			return;
+		}
+		if (Array.isArray(value)) {
+			for (const item of value) walk(item);
+			return;
+		}
+		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.`];
+}
 //#endregion
 export { auditScene as t };