incanto 0.52.0 → 0.54.0

package/bin/incanto-check.mjs

@@ -58,6 +58,61 @@ function collectScenes(entry) {
   return out;
 }
 
+/**
+ * Local art the project does not contain.
+ *
+ * A scene asset pointing at a file nobody copied loads fine, validates fine and
+ * draws NOTHING — the failure exists only in a browser, in `assetErrors()`,
+ * which needs a running game and someone to look at it. This command has the
+ * scene's path and runs after every edit, and the file is either there or it is
+ * not. A WARNING, not an error: a url can legitimately be produced at runtime,
+ * and refusing to load a scene over a guess would be worse than the bug.
+ */
+function missingArt(file, json) {
+  const assets = json && typeof json === 'object' ? json.assets : null;
+  if (!assets || typeof assets !== 'object') return [];
+  const sceneDir = dirname(file);
+  const root = projectRoot(sceneDir);
+  const out = [];
+  for (const [key, decl] of Object.entries(assets)) {
+    const url = decl && typeof decl === 'object' ? decl.url : null;
+    if (typeof url !== 'string' || url === '') continue;
+    // Remote and inline are not this command's business to guess about.
+    if (/^[a-z][a-z0-9+.-]*:/i.test(url) || url.startsWith('//')) continue;
+    const rel = url.replace(/^\//, '');
+    const candidates = [
+      join(root, 'public', rel),
+      join(root, rel),
+      join(sceneDir, rel),
+      join(sceneDir, '..', rel),
+    ];
+    if (candidates.some((p) => existsSync(p))) continue;
+    out.push(
+      `$${key} → ${url} is not in the project ` +
+        `(looked in ${relativeish(root, join(root, 'public'))}, ${relativeish(root, root)}` +
+        `, and beside the scene). It will draw nothing.`,
+    );
+  }
+  return out;
+}
+
+/** Nearest ancestor with a package.json, else the scene's own directory. */
+function projectRoot(from) {
+  let dir = resolve(from);
+  for (let i = 0; i < 8; i++) {
+    if (existsSync(join(dir, 'package.json'))) return dir;
+    const up = dirname(dir);
+    if (up === dir) break;
+    dir = up;
+  }
+  return resolve(from);
+}
+
+function relativeish(root, p) {
+  const r = p.slice(root.length).replace(/^[\\/]/, '');
+  return r === '' ? './' : `${r}/`;
+}
+
 const roots = args.files.length > 0 ? args.files : ['.'];
 for (const r of roots) {
   if (!existsSync(resolve(r))) {
@@ -84,7 +139,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, warnings: auditScene(json) };
+  if (res.ok) return { file, ok: true, warnings: [...auditScene(json), ...missingArt(file, json)] };
   return {
     file,
     ok: false,

package/dist/2d.d.ts

@@ -1,9 +1,9 @@
-import { Dt 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-uPEuZrUB.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-CyQoSu4n.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 { t as LoadSceneOptions } from "./loader-B9iTqs27.js";
+import { t as LoadSceneOptions } from "./loader-DhI1jFW_.js";
 import { n as AnimationEntry } from "./sprite-animation-CMr6f1K2.js";
-import { t as ParticleSim } from "./particle-sim-BzJ1yxoE.js";
+import { r as ParticleView, t as ParticleSim } from "./particle-sim-C5OfBbmU.js";
 import { Group, Mesh, Object3D, Scene, Texture } from "three";
 import * as RapierNs from "@dimforge/rapier2d-compat";
 
@@ -304,7 +304,21 @@ interface CreateGame2DOptions {
   * false disables. They overlay `touchContainer` (default: the canvas's
   * parent element — give it position: relative).
   */
+  /**
+  * Attach pointer input (mouse, finger or pen) to the canvas: positions for
+  * `input.pointerPosition()`, buttons for `input.mousePressed()`.
+  * `{ lockOnClick: true }` captures the cursor — rare in 2D, so it is off.
+  */
+  pointer?: boolean | {
+    lockOnClick?: boolean;
+  };
   touch?: "auto" | boolean;
+  /**
+  * Leave the browser's touch gestures (scroll/zoom/pull-to-refresh) on the
+  * canvas. Default false: the GAME owns them, or a drag on a phone scrolls
+  * the page instead of playing.
+  */
+  pageGestures?: boolean;
   touchContainer?: HTMLElement;
   /** @internal Test seam — replaces `document` for the touch overlay. */
   _touchDoc?: {
@@ -344,10 +358,32 @@ interface CreateGame2DOptions {
   _scheduler?: Scheduler;
 }
 /** What createGame needs from a renderer (stats is optional for test stubs). */
+/** What a renderer must do for the engine. The test seam supplies this much. */
 interface GameRenderer {
   dispose(): void;
   stats?(): RendererStats;
 }
+/**
+* What a GAME can ask its renderer for.
+*
+* The two coordinate conversions live here rather than only on `Renderer2D`,
+* because `game.renderer` is what a consumer holds: a tap needs screen→world
+* and a pinned DOM element needs world→screen, both are documented in the
+* skills, and neither typechecked through the narrow interface. Found by
+* following my own documentation in a fresh project.
+*/
+interface Game2DRenderer extends GameRenderer {
+  /** Canvas px → world px, through the design viewport and the camera. */
+  worldFromScreen(sx: number, sy: number): {
+    x: number;
+    y: number;
+  };
+  /** World px → canvas px (pin DOM to a node). */
+  screenFromWorld(wx: number, wy: number): {
+    x: number;
+    y: number;
+  };
+}
 interface Game2D {
   engine: Engine;
   scene: Scene$1;
@@ -356,13 +392,25 @@ interface Game2D {
   * A running tree has moved; the editor gets what was written down.
   */
   sourceJson: SceneJson;
-  renderer: GameRenderer;
+  renderer: Game2DRenderer;
   physics: Physics2D | null;
   /**
   * The node under a screen pixel, or null. The raycast the renderer already
   * does — reachable now without holding the renderer.
   */
   pick(x: number, y: number): Node | null;
+  /**
+  * Assets that did not arrive — a texture that 404'd, a sound that cannot be
+  * played — with the ref and the reason.
+  *
+  * The verify loop names this as one of its four signals, and 2D never had it:
+  * a 2D game could not ask the question at all.
+  */
+  assetErrors(): Array<{
+    ref: string;
+    url: string;
+    error: string;
+  }>;
   /** Engine + renderer perf counters in one read (fps/nodes/triangles/…). */
   stats(): GameStats;
   /**
@@ -469,6 +517,16 @@ declare class AnimatedSprite2D extends Sprite2D {
   stop(): void;
   override onReady(): void;
   override update(dt: number): void;
+  /** Sheets already reported, so a bad grid says so ONCE, not every frame. */
+  private gridChecked;
+  /**
+  * Tell the author their grid does not fit, the first time it is drawn.
+  *
+  * Both halves of this were silent: a frame size that does not divide the
+  * sheet slices every row further off centre, and an animation naming a frame
+  * past the end of the grid draws whatever is at the wrong end of the image.
+  */
+  private checkGrid;
   protected override resolveTexture(assets: AssetStore2D | null): ResolvedSpriteTexture | null;
 }
 //#endregion
@@ -651,6 +709,18 @@ declare class Particles2D extends Node2D {
   static override readonly props: PropSchema;
   preset: string;
   emitting: boolean;
+  /**
+  * Where a particle LIVES once it is born.
+  *
+  * `false` (default) — the emitter's local space: the plume moves with the
+  * node, which is what a torch on a moving platform wants.
+  *
+  * `true` — the world: a particle keeps the place it was born, so dust is left
+  * BEHIND a running player instead of glued to it, and moving a one-shot to
+  * the next explosion (the documented `p.position = …; p.replay()` recipe)
+  * stops dragging the previous one across the level.
+  */
+  worldSpace: boolean;
   rate: number;
   burst: number;
   lifetime: number[];
@@ -680,9 +750,30 @@ declare class Particles2D extends Node2D {
   private finishedEmitted;
   /** @internal Lazily applies the preset + builds the deterministic sim. */
   _ensureSim(): ParticleSim;
+  /** Particles alive this frame — an emitter that is running, told from one
+  *  that is not. `framing()` says where it IS; this says whether it is going. */
+  get aliveCount(): number;
+  /** A snapshot of the live particles — positions are in whichever space
+  *  `worldSpace` selects, relative to the emitter. */
+  particles(): ParticleView[];
+  /** The emitter's world position last frame, for world-space counter-motion. */
+  private lastWorld;
+  /** Last frame's `emitting`, so turning one ON is a reportable event. */
+  private wasEmitting;
   override update(dt: number): void;
+  /**
+  * Undo the emitter's own motion on everything already alive.
+  *
+  * Ancestor-summed like the physics helpers, so it follows a moving PARENT
+  * (dust under a player) as well as the node's own position.
+  */
+  private holdWorldSpace;
+  /** Tell the engine an effect fired — the visual half of the audio record. */
+  private report;
   /** Restart a one-shot (re-burst + allow finished to fire again). */
   replay(): void;
+  /** `replay()` asked for this burst, so `emitting: false` does not hold it. */
+  private armedByReplay;
   private mesh;
   /** Parsed `paletteColors`, reused; rebuilt only when the hex list changes. */
   private paletteCache;

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-B_e9hJf7.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-Trx7WHnD.js";
-import { n as enablePhysics2D, t as Physics2D } from "./physics-2d-Dns-oZlE.js";
+import { a as AssetStore2D, i as syncTree2D, r as Renderer2D, t as createGame2D } from "./create-game-BRt6XKmP.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-en63AEZO.js";
+import { n as enablePhysics2D, t as Physics2D } from "./physics-2d-CfWAggJ1.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 { D as QualityCaps, Dt 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-uPEuZrUB.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-CyQoSu4n.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 { t as LoadSceneOptions } from "./loader-B9iTqs27.js";
-import { t as ParticleSim } from "./particle-sim-BzJ1yxoE.js";
+import { t as LoadSceneOptions } from "./loader-DhI1jFW_.js";
+import { r as ParticleView, t as ParticleSim } from "./particle-sim-C5OfBbmU.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-DZ70IY26.js";
-import { n as PathGrid, s as SpatialPose } from "./pathfinding-CAR9DjQQ.js";
+import { n as PathGrid, s as SpatialPose } from "./pathfinding-CXGCpRQe.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";
@@ -61,6 +61,15 @@ declare class TextureCache3D {
   */
   acquireOwn(url: string, spec?: TextureSpec): Texture | null;
   /**
+  * File a failure this store did not load itself.
+  *
+  * `Tree3D` keeps its own cache on purpose (it decodes off-thread and its
+  * page-session lifetime is load-bearing for the editor), which left its bark
+  * and leaf textures outside the one place `assetErrors()` reads. A 404'd leaf
+  * texture is a forest of bare branches and no message anywhere.
+  */
+  noteError(url: string, error: unknown): void;
+  /**
   * What 404'd, by URL — reported raw, never by cache key, because an agent
   * greps this against the URL it wrote.
   */
@@ -563,6 +572,12 @@ interface CreateGame3DOptions {
   * parent element — give it position: relative).
   */
   touch?: "auto" | boolean;
+  /**
+  * Leave the browser's touch gestures (scroll/zoom/pull-to-refresh) on the
+  * canvas. Default false: the GAME owns them, or a drag on a phone scrolls
+  * the page instead of playing.
+  */
+  pageGestures?: boolean;
   touchContainer?: HTMLElement;
   /** @internal Test seam — replaces `document` for the touch overlay. */
   _touchDoc?: {
@@ -1853,6 +1868,15 @@ declare class LoftMesh3D extends Node3D {
   private geometryKey;
   protected override _createObject3D(): Object3D;
   override _syncObject3D(): void;
+  /**
+  * Hand the GPU back.
+  *
+  * Every other node that builds geometry disposes it here; these four did not,
+  * so a scene swap left their buffers and materials resident and a game with
+  * level transitions climbed until the tab died — with `stats().geometries` the
+  * only witness, and only if someone was watching it.
+  */
+  override free(): void;
 }
 //#endregion
 //#region src/3d/nodes/model-instance-3d.d.ts
@@ -2024,6 +2048,18 @@ declare class Particles3D extends Node3D {
   static override readonly props: PropSchema;
   preset: string;
   emitting: boolean;
+  /**
+  * Where a particle LIVES once it is born.
+  *
+  * `false` (default) — the emitter's local space: the plume moves with the
+  * node, which is what a torch on a moving platform wants.
+  *
+  * `true` — the world: a particle keeps the place it was born, so dust is left
+  * BEHIND a running player instead of glued to it, and moving a one-shot to
+  * the next explosion (the documented `p.position = …; p.replay()` recipe)
+  * stops dragging the previous one across the level.
+  */
+  worldSpace: boolean;
   rate: number;
   burst: number;
   lifetime: number[];
@@ -2059,9 +2095,30 @@ declare class Particles3D extends Node3D {
   private finishedEmitted;
   /** @internal */
   _ensureSim(): ParticleSim;
+  /** Particles alive this frame — an emitter that is running, told from one
+  *  that is not. `framing()` says where it IS; this says whether it is going. */
+  get aliveCount(): number;
+  /** A snapshot of the live particles — positions are in whichever space
+  *  `worldSpace` selects, relative to the emitter. */
+  particles(): ParticleView[];
+  /** The emitter's world position last frame, for world-space counter-motion. */
+  private lastWorld;
+  /** Last frame's `emitting`, so turning one ON is a reportable event. */
+  private wasEmitting;
   override update(dt: number): void;
+  /**
+  * Undo the emitter's own motion on everything already alive.
+  *
+  * Ancestor-summed like the physics helpers, so it follows a moving PARENT
+  * (dust under a player) as well as the node's own position.
+  */
+  private holdWorldSpace;
+  /** Tell the engine an effect fired — the visual half of the audio record. */
+  private report;
   /** Restart a one-shot (re-burst + allow finished to fire again). */
   replay(): void;
+  /** `replay()` asked for this burst, so `emitting: false` does not hold it. */
+  private armedByReplay;
   private points;
   private positions;
   private colors;
@@ -2074,6 +2131,15 @@ declare class Particles3D extends Node3D {
   * uses the colorStart→colorEnd ramp. */
   private refreshPalette;
   private syncParticles;
+  /**
+  * Hand the GPU back.
+  *
+  * Every other node that builds geometry disposes it here; these four did not,
+  * so a scene swap left their buffers and materials resident and a game with
+  * level transitions climbed until the tab died — with `stats().geometries` the
+  * only witness, and only if someone was watching it.
+  */
+  override free(): void;
 }
 //#endregion
 //#region src/3d/terrain/heightmap.d.ts
@@ -2750,10 +2816,30 @@ declare class Trail3D extends Node3D {
   private mesh;
   private lastColor;
   protected override _createObject3D(): Object3D;
+  /** Last frame's `emitting`, so laying ribbon is a reportable event. */
+  private wasEmitting;
   override update(dt: number): void;
   _onRender3D(ctx: RenderContext3D): void;
-  /** Test hook: recorded point count. */
+  /**
+  * How many points the ribbon is made of.
+  *
+  * ZERO with no renderer, and that is not a bug: the ribbon is laid in the
+  * render sync, because each point needs the node's real world transform (a
+  * sword arc is a ROTATING parent, which an ancestor position sum cannot see).
+  * Assert it from a browser check; read a headless 0 as "nothing rendered"
+  * rather than "my trail is broken", and use the `trail` effect record for the
+  * wiring question.
+  */
   get pointCount(): number;
+  /**
+  * Hand the GPU back.
+  *
+  * Every other node that builds geometry disposes it here; these four did not,
+  * so a scene swap left their buffers and materials resident and a game with
+  * level transitions climbed until the tab died — with `stats().geometries` the
+  * only witness, and only if someone was watching it.
+  */
+  override free(): void;
 }
 //#endregion
 //#region src/3d/vegetation/tree-blueprint.d.ts
@@ -2853,7 +2939,17 @@ declare class Tree3D extends Node3D {
   /** @internal Every grown variant (medium/high tiers; empty for 'simple'). */
   _variantMeshes(): TreeVariant[];
   override update(dt: number): void;
-  override _syncObject3D(): void;
+  /** The scene's asset store, so a 404'd bark or leaf reaches assetErrors(). */
+  private assets;
+  override _syncObject3D(alpha?: number, assets?: AssetStore3D | null): void;
+  /**
+  * File a texture failure where the ladder reads it.
+  *
+  * This node keeps its own cache on purpose, and that left its textures
+  * outside the one place `assetErrors()` looks — so a leaf URL that 404s was a
+  * forest of bare branches with no message anywhere.
+  */
+  private noteTextureError;
   /** Re-grow only when a grove-shaping prop changed (the JSON IS the grove). */
   private rebuildIfNeeded;
   /** Resolve the drape target + cache the grove's world position for `bedY`. */
@@ -2924,6 +3020,15 @@ declare class VoxelGrid3D extends Node3D {
   blocks(): VoxelBlock[];
   protected override _createObject3D(): Object3D;
   override update(): void;
+  /**
+  * Hand the GPU back.
+  *
+  * Every other node that builds geometry disposes it here; these four did not,
+  * so a scene swap left their buffers and materials resident and a game with
+  * level transitions climbed until the tab died — with `stats().geometries` the
+  * only witness, and only if someone was watching it.
+  */
+  override free(): void;
 }
 //#endregion
 //#region src/3d/water/interaction.d.ts

package/dist/3d.js

@@ -1,9 +1,9 @@
-import { F as CharacterBody3D, H as WATER_MAX_RIPPLES, I as PhysicsBody3D, L as RigidBody3D, M as WATER_CUTOUT_MAX, N as WaterCutout3D, P as Area3D, R as StaticBody3D, j as Water3D, z as Node3D } from "./gameplay-B6jqvYeM.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-DSZwsKPs.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-CGnoypjL.js";
+import { F as CharacterBody3D, H as WATER_MAX_RIPPLES, I as PhysicsBody3D, L as RigidBody3D, M as WATER_CUTOUT_MAX, N as WaterCutout3D, P as Area3D, R as StaticBody3D, j as Water3D, z as Node3D } from "./gameplay-CZ2yq37J.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-BQ_QsIBY.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-Czzp6ZuE.js";
 import { a as frameSignature, n as diffSignatures, o as frameStats, r as diffText, s as frameText, t as SIGNATURE_GRID } from "./frame-report-njybhZon.js";
 import { n as splatWeights, t as buildHeightmap } from "./heightmap-CRK0M4jT.js";
-import { n as enablePhysics3D, t as Physics3D } from "./physics-3d-BhI0ehpe.js";
+import { n as enablePhysics3D, t as Physics3D } from "./physics-3d-Bes-GIuR.js";
 //#region src/3d/model-verdict.ts
 /** Mixamo exports every bone as `mixamorigX`; the retargeter binds by that name. */
 const MIXAMO = /^mixamorig[:_]?/i;
@@ -50,6 +50,10 @@ const BODY = {
 	radius: .34,
 	height: 1
 };
+/** Three decimals — enough for millimetres, and no float dust in pasted JSON. */
+function round3(n) {
+	return Math.round(n * 1e3) / 1e3;
+}
 /**
 * A found character, as a thing that walks.
 *
@@ -122,10 +126,10 @@ function characterJson(target) {
 				type: "ModelInstance3D",
 				props: {
 					model: `$${target.key}`,
-					targetHeight: BODY.height + 2 * BODY.radius,
+					targetHeight: round3(BODY.height + 2 * BODY.radius),
 					position: [
 						0,
-						-(BODY.height / 2 + BODY.radius),
+						round3(-(BODY.height / 2 + BODY.radius)),
 						0
 					],
 					castShadow: true