incanto 0.7.0 → 0.8.0

package/bin/incanto-check.mjs

@@ -71,7 +71,7 @@ if (files.length === 0) {
   process.exit(1);
 }
 
-const { validateScene } = await import(pathToFileURL(join(DIST, 'test.js')).href);
+const { auditScene, validateScene } = await import(pathToFileURL(join(DIST, 'test.js')).href);
 
 const results = files.map((file) => {
   let json;
@@ -84,7 +84,7 @@ 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 };
+  if (res.ok) return { file, ok: true, warnings: auditScene(json) };
   return {
     file,
     ok: false,
@@ -99,8 +99,10 @@ if (args.json) {
   console.log(JSON.stringify({ ok: failed.length === 0, results }, null, 2));
 } else {
   for (const r of results) {
-    if (r.ok) console.log(`  ok  ${r.file}`);
-    else console.log(`FAIL  ${r.file}\n      [${r.code}] ${r.message}`);
+    if (r.ok) {
+      console.log(`  ok  ${r.file}`);
+      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`);
 }

package/dist/2d.d.ts

@@ -1,6 +1,6 @@
 import { s as JsonObject } from "./schema-CcoWb32N.js";
-import { C as RendererStats, S as GameStats, T as Node, b as Scheduler, l as PropSchema, n as BehaviorCtor, v as Engine, w as Scene$1 } from "./behavior-e3kAmPGC.js";
-import { t as LoadSceneOptions } from "./loader-y_X4zYO0.js";
+import { $ as Node, C as RendererStats, S as GameStats, b as Scheduler, l as PropSchema, n as BehaviorCtor, v as Engine, w as Scene$1 } from "./behavior-Bod1AyJS.js";
+import { t as LoadSceneOptions } from "./loader-BcUDfNHn.js";
 import { t as ParticleSim } from "./particle-sim-CwJ5rI_P.js";
 import { Group, Mesh, Object3D, Scene, Texture } from "three";
 import * as RapierNs from "@dimforge/rapier2d-compat";
@@ -559,6 +559,66 @@ declare class Particles2D extends Node2D {
   override _syncObject2D(assets: AssetStore2D | null): void;
 }
 //#endregion
+//#region src/2d/nodes/tile-map-2d.d.ts
+/**
+* A whole tile level as ONE node — grid render in a single draw call plus
+* greedy-merged static colliders. Author the level as rows of characters:
+*
+*   { "name": "Level", "type": "TileMap2D", "props": {
+*       "texture": "$tiles", "tileSize": 32,
+*       "cells": [
+*         "..................",
+*         "......111.........",
+*         "000000000000000000"
+*       ],
+*       "solid": [0, 1] } }
+*
+* `.` / space = empty, digits 0-9 = atlas tile index, other chars map through
+* `legend` (e.g. `{"G": 12}`). The atlas is read left-to-right, top-to-bottom
+* in `tileSize` squares. Tiles listed in `solid` become static colliders,
+* greedy-merged into a few rectangles (hundreds of cells → a handful of
+* bodies). Cell (0,0) renders with its TOP-LEFT on this node's origin.
+*/
+declare class TileMap2D extends Node2D {
+  static override readonly typeName: string;
+  static override readonly props: PropSchema;
+  texture: string;
+  tileSize: number;
+  columns: number;
+  private _cells;
+  private _legend;
+  private _solid;
+  /** Rebuild flags — raised when the map-shaping props are REPLACED. */
+  private geometryDirty;
+  private collidersDirty;
+  /** Replace the whole array to change the map (mutations are not watched). */
+  get cells(): (string | number[])[];
+  set cells(value: (string | number[])[]);
+  get legend(): Record<string, number>;
+  set legend(value: Record<string, number>);
+  get solid(): number[];
+  set solid(value: number[]);
+  opacity: number;
+  private tileMesh;
+  private builtColumns;
+  private builtRows;
+  /** Loader hook: bad cells fail at LOAD (unknown chars), not at render. */
+  static validateJson(node: Node): void;
+  /** The parsed index grid (test/tooling hook). */
+  grid(): number[][];
+  override onReady(): void;
+  override update(_dt: number): void;
+  private rebuildColliders;
+  /** @internal The drawable mesh (lazily created under the backing object). */
+  _mesh(): Mesh;
+  override _syncObject2D(assets: AssetStore2D | null): void;
+  /** One quad per visible tile, atlas UVs — a single draw call for the level. */
+  private buildGeometry;
+  /** Test hook: rendered tile count (quads in the built geometry). */
+  get renderedTileCount(): number;
+  override free(): void;
+}
+//#endregion
 //#region src/2d/nodes/ui-layer.d.ts
 declare const ANCHORS: readonly ["top-left", "top", "top-right", "left", "center", "right", "bottom-left", "bottom", "bottom-right"];
 type UIAnchor = (typeof ANCHORS)[number];
@@ -655,6 +715,8 @@ declare class Renderer2D {
   private readonly canvas;
   constructor(opts: Renderer2DOptions);
   private readonly debugLines;
+  private readonly selectionLines;
+  private syncSelectionOutline;
   private syncDebugLines;
   private render;
   private lastViewport;
@@ -718,4 +780,32 @@ declare function syncTree2D(root: Node, world: Scene, ui: Scene, assets: AssetSt
   ignoreStatic?: boolean;
 }): Sync2DResult;
 //#endregion
-export { AnimatedSprite2D, type AnimationDef, Area2D, type AssetStatus, AssetStore2D, Camera2D, CharacterBody2D, CharacterController2D, ColorRect2D, type CreateGame2DOptions, type Game2D, Joint2D, type JointType2D, Label, Node2D, Particles2D, Physics2D, type Physics2DOptions, PhysicsBody2D, Renderer2D, type Renderer2DOptions, type ResolvedSpriteTexture, RigidBody2D, type SheetInfo, Sprite2D, type SpriteFromLibraryResult, StaticBody2D, type Sync2DResult, type TextureLoadCallbacks, type UIAnchor, UILayer, createGame2D, enablePhysics2D, registerNodes2D, spriteFromLibraryMeta, syncTree2D };
+//#region src/2d/tilemap-grid.d.ts
+/**
+* Pure tile-grid logic for TileMap2D — no three, unit-testable in node.
+* Grids are `number[][]` of atlas tile indices, `-1` = empty.
+*/
+interface TileRect {
+  /** Cell coords (col, row) of the rect's top-left. */
+  x: number;
+  y: number;
+  /** Size in cells. */
+  w: number;
+  h: number;
+}
+/**
+* Normalize the `cells` prop into an index grid. Two author formats:
+* - string rows: `"." `/`" "` = empty, digits `0-9` = tile index, anything
+*   else must be in `legend` (char → index). Unknown chars HARD-fail.
+* - number rows: passed through (`-1` = empty).
+* Ragged rows are right-padded with empty.
+*/
+declare function parseCells(cells: readonly (string | readonly number[])[], legend: Record<string, number>): number[][];
+/**
+* Greedy rectangle merge over the solid cells: maximal horizontal runs,
+* extended downward while the identical run repeats. A platform level's
+* hundreds of solid tiles collapse to a handful of colliders.
+*/
+declare function mergeSolidRects(grid: readonly (readonly number[])[], solid: Set<number>): TileRect[];
+//#endregion
+export { AnimatedSprite2D, type AnimationDef, Area2D, type AssetStatus, AssetStore2D, Camera2D, CharacterBody2D, CharacterController2D, ColorRect2D, type CreateGame2DOptions, type Game2D, Joint2D, type JointType2D, Label, Node2D, Particles2D, Physics2D, type Physics2DOptions, PhysicsBody2D, Renderer2D, type Renderer2DOptions, type ResolvedSpriteTexture, RigidBody2D, type SheetInfo, Sprite2D, type SpriteFromLibraryResult, StaticBody2D, type Sync2DResult, type TextureLoadCallbacks, TileMap2D, type TileRect, type UIAnchor, UILayer, createGame2D, enablePhysics2D, mergeSolidRects, parseCells, registerNodes2D, spriteFromLibraryMeta, syncTree2D };

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-X5iRu6pf.js";
-import { a as ColorRect2D, c as AnimatedSprite2D, d as Area2D, f as CharacterBody2D, g as Node2D, h as StaticBody2D, i as Label, l as Sprite2D, m as RigidBody2D, n as UILayer, o as CharacterController2D, p as PhysicsBody2D, r as Particles2D, s as Camera2D, t as registerNodes2D, u as Joint2D } from "./register-ClKnoILk.js";
-import { n as enablePhysics2D, t as Physics2D } from "./physics-2d-DmQ540uR.js";
+import { a as AssetStore2D, i as syncTree2D, r as Renderer2D, t as createGame2D } from "./create-game-BNDSbhy-.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-Cqjxrfq0.js";
+import { n as enablePhysics2D, t as Physics2D } from "./physics-2d-q2N362ph.js";
 //#region src/2d/library-sprite.ts
 /**
 * Turn a library sprite-animation JSON into a scene-ready spritesheet asset
@@ -41,4 +41,4 @@ function spriteFromLibraryMeta(meta, opts) {
 	};
 }
 //#endregion
-export { AnimatedSprite2D, Area2D, AssetStore2D, Camera2D, CharacterBody2D, CharacterController2D, ColorRect2D, Joint2D, Label, Node2D, Particles2D, Physics2D, PhysicsBody2D, Renderer2D, RigidBody2D, Sprite2D, StaticBody2D, UILayer, createGame2D, enablePhysics2D, registerNodes2D, spriteFromLibraryMeta, syncTree2D };
+export { AnimatedSprite2D, Area2D, AssetStore2D, Camera2D, CharacterBody2D, CharacterController2D, ColorRect2D, Joint2D, Label, Node2D, Particles2D, Physics2D, PhysicsBody2D, Renderer2D, RigidBody2D, Sprite2D, StaticBody2D, TileMap2D, UILayer, createGame2D, enablePhysics2D, mergeSolidRects, parseCells, registerNodes2D, spriteFromLibraryMeta, syncTree2D };

package/dist/3d.d.ts

@@ -1,8 +1,8 @@
 import { s as JsonObject } from "./schema-CcoWb32N.js";
-import { C as RendererStats, S as GameStats, T as Node, b as Scheduler, l as PropSchema, n as BehaviorCtor, v as Engine, w as Scene$1 } from "./behavior-e3kAmPGC.js";
-import { t as LoadSceneOptions } from "./loader-y_X4zYO0.js";
+import { $ as Node, C as RendererStats, S as GameStats, b as Scheduler, l as PropSchema, n as BehaviorCtor, v as Engine, w as Scene$1 } from "./behavior-Bod1AyJS.js";
+import { t as LoadSceneOptions } from "./loader-BcUDfNHn.js";
 import { t as ParticleSim } from "./particle-sim-CwJ5rI_P.js";
-import { r as SpatialPose } from "./audio-player-VSjk_vG8.js";
+import { r as SpatialPose } from "./audio-player-Dyjg5k92.js";
 import { AnimationClip, BufferGeometry, Color, DirectionalLight, InstancedMesh, MeshPhysicalMaterial, Object3D, PerspectiveCamera, Scene, Vector3, WebGLRenderer } from "three";
 import { VRM } from "@pixiv/three-vrm";
 import { Sky } from "three/examples/jsm/objects/Sky.js";
@@ -696,6 +696,13 @@ declare class CharacterController3D extends Node3D {
   * character facing away from the camera until it first moves).
   */
   skinYawOffset: number;
+  /**
+  * Movement-state → animation asset map, applied to the `skinPath` model
+  * directly — no CharacterAnimator behavior needed:
+  *   "animations": { "idle": "$idle", "run": "$run", "fastRun": "$sprint",
+  *                   "walk": "$walk", "airborne": "$jump" }
+  */
+  animations: Record<string, string>;
   /** Camera yaw/pitch in radians (mouse look mutates these). */
   yaw: number;
   pitch: number;
@@ -1547,6 +1554,38 @@ declare class Terrain3D extends Node3D {
   override free(): void;
 }
 //#endregion
+//#region src/3d/nodes/trail-3d.d.ts
+/**
+* A fading ribbon behind whatever this node is parented to — wingtip trails,
+* sword arcs, tyre streaks. Records the node's world position over `seconds`
+* and renders a camera-facing strip that tapers and fades to the tail.
+*
+*   { "name": "WingTrail", "type": "Trail3D",
+*     "props": { "width": 0.4, "color": "#dddddd", "seconds": 0.8 } }
+*
+* `emitting: false` stops laying new ribbon (the old tail still fades out).
+*/
+declare class Trail3D extends Node3D {
+  static override readonly typeName: string;
+  static override readonly props: PropSchema;
+  width: number;
+  color: string;
+  opacity: number;
+  seconds: number;
+  emitting: boolean;
+  additive: boolean;
+  minDistance: number;
+  private readonly points;
+  private clock;
+  private mesh;
+  private lastColor;
+  protected override _createObject3D(): Object3D;
+  override update(dt: number): void;
+  _onRender3D(ctx: RenderContext3D): void;
+  /** Test hook: recorded point count. */
+  get pointCount(): number;
+}
+//#endregion
 //#region src/3d/vegetation/tree-blueprint.d.ts
 /**
 * Tree3D construction recipes — the pure half of the procedural trees.
@@ -1969,6 +2008,8 @@ declare class Renderer3D {
   private bloomCompositeUniforms;
   constructor(opts: Renderer3DOptions);
   private readonly debugLines;
+  private readonly selectionLines;
+  private syncSelectionOutline;
   private syncDebugLines;
   private render;
   /**
@@ -2114,4 +2155,4 @@ interface WalkState {
   ignoreStatic: boolean;
 }
 //#endregion
-export { Area3D, AssetStore3D, Billboard3D, type BillboardGroupMode, Camera3D, CharacterBody3D, CharacterController3D, type CreateGame3DOptions, DEFAULT_TERRAIN_TEXTURE_BASE, DirectionalLight3D, Environment3D, type Environment3DConfig, DENSITY_PRESETS as FLOWER_DENSITY_PRESETS, FLOWER_VARIETIES, type FlowerVariety, Flowers3D, type FogEnvironment, Foliage3D, type FoliageKind, type FoliageStyle, type Game3D, type Heightmap, type HeightmapOptions, 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, type ShadowsEnvironment, type SkyEnvironment, StaticBody3D, type SunConsumer3D, type SyncOptions, type SyncResult, TERRAIN_THEMES, Terrain3D, type TerrainLayer, type TerrainTheme, Tree3D, type TreeTier, type TreeType, VOXEL_PALETTE, type VoxelBlock, VoxelGrid3D, WATER_MAX_RIPPLES, Water3D, buildHeightmap, cameraRelative, createGame3D, enablePhysics3D, horizonColorFromSky, keyboardIntensity, movementState, parseEnvironment3D, registerNodes3D, resolveFlowerDensity, rigPose, splatWeights, sunDirectionFromElevationAzimuth, sunDirectionFromSky, syncTree, terrainThemeLayers };
+export { Area3D, AssetStore3D, Billboard3D, type BillboardGroupMode, Camera3D, CharacterBody3D, CharacterController3D, type CreateGame3DOptions, DEFAULT_TERRAIN_TEXTURE_BASE, DirectionalLight3D, Environment3D, type Environment3DConfig, DENSITY_PRESETS as FLOWER_DENSITY_PRESETS, FLOWER_VARIETIES, type FlowerVariety, Flowers3D, type FogEnvironment, Foliage3D, type FoliageKind, type FoliageStyle, type Game3D, type Heightmap, type HeightmapOptions, 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, type ShadowsEnvironment, type SkyEnvironment, StaticBody3D, type SunConsumer3D, type SyncOptions, type SyncResult, TERRAIN_THEMES, Terrain3D, type TerrainLayer, type TerrainTheme, Trail3D, Tree3D, type TreeTier, type TreeType, VOXEL_PALETTE, type VoxelBlock, VoxelGrid3D, WATER_MAX_RIPPLES, Water3D, buildHeightmap, cameraRelative, createGame3D, enablePhysics3D, horizonColorFromSky, keyboardIntensity, movementState, parseEnvironment3D, registerNodes3D, resolveFlowerDensity, rigPose, splatWeights, sunDirectionFromElevationAzimuth, sunDirectionFromSky, syncTree, terrainThemeLayers };

package/dist/3d.js

@@ -1,5 +1,5 @@
-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-CEFoFN8d.js";
-import { A as StaticBody3D, C as TERRAIN_THEMES, D as CharacterBody3D, E as Area3D, F as keyboardIntensity, I as movementState, L as rigPose, N as QUARTER_PITCH, O as PhysicsBody3D, P as cameraRelative, S as DEFAULT_TERRAIN_TEXTURE_BASE, T as Joint3D, _ as FLOWER_VARIETIES, a as VoxelGrid3D, b as Billboard3D, c as ModelInstance3D, d as DirectionalLight3D, f as OmniLight3D, g as resolveFlowerDensity, h as Flowers3D, i as VOXEL_PALETTE, j as Node3D, k as RigidBody3D, l as LoftMesh3D, m as DENSITY_PRESETS, n as Water3D, o as Tree3D, p as Foliage3D, r as WATER_MAX_RIPPLES, s as Particles3D, t as registerNodes3D, u as MeshInstance3D, v as CharacterController3D, w as terrainThemeLayers, x as Terrain3D, y as Camera3D } from "./register-CscQqB7V.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-66c4iYJE.js";
+import { A as RigidBody3D, C as DEFAULT_TERRAIN_TEXTURE_BASE, D as Area3D, E as Joint3D, F as cameraRelative, I as keyboardIntensity, L as movementState, M as Node3D, O as CharacterBody3D, P as QUARTER_PITCH, R as rigPose, S as Terrain3D, T as terrainThemeLayers, _ as resolveFlowerDensity, a as VoxelGrid3D, b as Camera3D, c as Particles3D, d as MeshInstance3D, f as DirectionalLight3D, g as Flowers3D, h as DENSITY_PRESETS, i as VOXEL_PALETTE, j as StaticBody3D, k as PhysicsBody3D, l as ModelInstance3D, m as Foliage3D, n as Water3D, o as Tree3D, p as OmniLight3D, r as WATER_MAX_RIPPLES, s as Trail3D, t as registerNodes3D, u as LoftMesh3D, v as FLOWER_VARIETIES, w as TERRAIN_THEMES, x as Billboard3D, y as CharacterController3D } from "./register-Cbs7QxoV.js";
 import { n as splatWeights, t as buildHeightmap } from "./heightmap-CroQPEER.js";
-import { n as enablePhysics3D, t as Physics3D } from "./physics-3d-CDjuhtt_.js";
-export { Area3D, AssetStore3D, Billboard3D, Camera3D, CharacterBody3D, CharacterController3D, DEFAULT_TERRAIN_TEXTURE_BASE, DirectionalLight3D, Environment3D, DENSITY_PRESETS as FLOWER_DENSITY_PRESETS, FLOWER_VARIETIES, Flowers3D, Foliage3D, Joint3D, LoftMesh3D, MeshInstance3D, ModelInstance3D, Node3D, OmniLight3D, Particles3D, Physics3D, PhysicsBody3D, QUARTER_PITCH, Renderer3D, RigidBody3D, StaticBody3D, TERRAIN_THEMES, Terrain3D, Tree3D, VOXEL_PALETTE, VoxelGrid3D, WATER_MAX_RIPPLES, Water3D, buildHeightmap, cameraRelative, createGame3D, enablePhysics3D, horizonColorFromSky, keyboardIntensity, movementState, parseEnvironment3D, registerNodes3D, resolveFlowerDensity, rigPose, splatWeights, sunDirectionFromElevationAzimuth, sunDirectionFromSky, syncTree, terrainThemeLayers };
+import { n as enablePhysics3D, t as Physics3D } from "./physics-3d-CvHr31d4.js";
+export { Area3D, AssetStore3D, Billboard3D, Camera3D, CharacterBody3D, CharacterController3D, DEFAULT_TERRAIN_TEXTURE_BASE, DirectionalLight3D, Environment3D, DENSITY_PRESETS as FLOWER_DENSITY_PRESETS, FLOWER_VARIETIES, Flowers3D, Foliage3D, Joint3D, LoftMesh3D, MeshInstance3D, ModelInstance3D, Node3D, OmniLight3D, Particles3D, Physics3D, PhysicsBody3D, QUARTER_PITCH, Renderer3D, RigidBody3D, StaticBody3D, TERRAIN_THEMES, Terrain3D, Trail3D, Tree3D, VOXEL_PALETTE, VoxelGrid3D, WATER_MAX_RIPPLES, Water3D, buildHeightmap, cameraRelative, createGame3D, enablePhysics3D, horizonColorFromSky, keyboardIntensity, movementState, parseEnvironment3D, registerNodes3D, resolveFlowerDensity, rigPose, splatWeights, sunDirectionFromElevationAzimuth, sunDirectionFromSky, syncTree, terrainThemeLayers };

package/dist/{audio-player-VSjk_vG8.d.ts → audio-player-Dyjg5k92.d.ts}

@@ -1,4 +1,4 @@
-import { F as Listener, T as Node, l as PropSchema } from "./behavior-e3kAmPGC.js";
+import { $ as Node, P as Listener, l as PropSchema } from "./behavior-Bod1AyJS.js";
 
 //#region src/core/nodes/audio-player.d.ts
 /**

package/dist/audit-C6rMyict.js

@@ -0,0 +1,58 @@
+//#region src/core/audit.ts
+const ANIMATED_TYPES = new Set([
+	"Particles2D",
+	"Particles3D",
+	"Water3D",
+	"AnimatedSprite2D",
+	"AnimatedSprite3D",
+	"Camera2D",
+	"Camera3D"
+]);
+const BODY_TYPES = new Set([
+	"StaticBody2D",
+	"RigidBody2D",
+	"Area2D",
+	"CharacterBody2D",
+	"StaticBody3D",
+	"RigidBody3D",
+	"Area3D",
+	"CharacterBody3D"
+]);
+const HUD_WIDGETS = new Set([
+	"UiText",
+	"UiBar",
+	"UiBanner",
+	"UiButton",
+	"UiDialogue"
+]);
+/** Human-readable warnings (empty = clean). Pure JSON walk, no registry. */
+function auditScene(scene) {
+	const warnings = [];
+	const root = scene.root;
+	if (!root) return warnings;
+	let currentCameras = 0;
+	let cameras = 0;
+	const walk = (node, path, insideHud, staticRoot) => {
+		const type = node.type ?? "";
+		const props = node.props ?? {};
+		if (type === "Camera2D" || type === "Camera3D") {
+			cameras += 1;
+			if (props.current === true) currentCameras += 1;
+		}
+		if (BODY_TYPES.has(type)) {
+			const collider = props.collider;
+			if (!collider || collider.shape === void 0) warnings.push(`${path}: ${type} has no collider — physics will skip it (add "collider": { "shape": ... }).`);
+		}
+		if (HUD_WIDGETS.has(type) && !insideHud) warnings.push(`${path}: ${type} works only as a descendant of a HudLayer — it will not render.`);
+		if (staticRoot && ANIMATED_TYPES.has(type)) warnings.push(`${path}: ${type} is frozen inside static subtree '${staticRoot}' — it will not animate/update on screen.`);
+		const nextStatic = staticRoot ?? (props.static === true ? node.name ?? path : null);
+		const nextHud = insideHud || type === "HudLayer";
+		for (const child of node.children ?? []) walk(child, `${path}/${child.name ?? "?"}`, nextHud, nextStatic);
+	};
+	walk(root, root.name ?? "root", false, root.props?.static === true ? root.name ?? "root" : null);
+	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.`);
+	return warnings;
+}
+//#endregion
+export { auditScene as t };