incanto 0.57.0 → 0.59.0

package/bin/incanto.mjs

@@ -0,0 +1,107 @@
+#!/usr/bin/env node
+/**
+ * incanto — the front door.
+ *
+ *   bunx incanto new my-game        scaffold a game (no install needed first)
+ *   bunx incanto check src          validate scene JSON
+ *   bunx incanto verify             the whole verification ladder
+ *
+ * WHY THIS EXISTS. Every doc used to open with `bunx incanto-new my-game`, and
+ * that command 404s for the one person it is written for. `bunx <name>` fetches
+ * the PACKAGE called `<name>`; it does not search the registry for a package
+ * that happens to ship a bin by that name. There is no `incanto-new` package,
+ * so a brand-new reader's very first command failed — while every existing
+ * consumer ran it happily, because with `incanto` already in `node_modules` the
+ * same words resolve to the local bin. The funnel was the one path nobody
+ * walked.
+ *
+ * `bunx incanto <subcommand>` works from nothing, because `incanto` IS the
+ * package name. The `incanto-*` bins all still exist and are unchanged — inside
+ * a project they are the shorter thing to type.
+ *
+ * Dispatch is an in-process import, not a spawn: the child bin then runs under
+ * the SAME runtime that started this one, which matters because `--behaviors`
+ * loads your TypeScript and bun and node disagree about what they can import.
+ */
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+
+const HERE = dirname(fileURLToPath(import.meta.url));
+
+/** Subcommand → bin file, in the order the help should list them. */
+const COMMANDS = {
+  new: ['incanto-new.mjs', 'scaffold a ready-to-run game from a template'],
+  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'],
+  logs: ['incanto-logs.mjs', 'what the running page has been saying'],
+  editor: ['incanto-editor.mjs', 'the visual scene composer'],
+  model: ['incanto-model.mjs', "a GLB's real bounds, animations and rig"],
+  assets: ['incanto-assets.mjs', 'the built-in art and audio catalog'],
+  env: ['incanto-env.mjs', 'generate a 3D environment'],
+  skills: ['incanto-skills.mjs', 'install the agent skills for this engine version'],
+};
+
+function version() {
+  try {
+    const pkg = JSON.parse(readFileSync(join(HERE, '..', 'package.json'), 'utf-8'));
+    return pkg.version ?? 'unknown';
+  } catch {
+    return 'unknown';
+  }
+}
+
+function help() {
+  const width = Math.max(...Object.keys(COMMANDS).map((k) => k.length));
+  const lines = Object.entries(COMMANDS).map(
+    ([name, [, blurb]]) => `  ${name.padEnd(width)}  ${blurb}`,
+  );
+  return [
+    `incanto ${version()} — a vibe-coding-first web game engine`,
+    '',
+    'Usage: bunx incanto <command> [options]',
+    '',
+    ...lines,
+    '',
+    'Start a game:      bunx incanto new my-game',
+    'See the templates: bunx incanto new --list',
+    '',
+    'Each command also ships as its own bin (`incanto-new`, `incanto-check`, …),',
+    'which is what to type once the package is installed in your project.',
+  ].join('\n');
+}
+
+const [command, ...rest] = process.argv.slice(2);
+
+if (!command || command === '--help' || command === '-h' || command === 'help') {
+  console.log(help());
+  process.exit(0);
+}
+if (command === '--version' || command === '-v') {
+  console.log(version());
+  process.exit(0);
+}
+
+const entry = COMMANDS[command];
+if (!entry) {
+  const near = Object.keys(COMMANDS).filter((k) => k.startsWith(command[0] ?? ''));
+  console.error(
+    `incanto: unknown command '${command}'.` +
+      (near.length ? ` Did you mean: ${near.join(', ')}?` : '') +
+      '\n\n' +
+      help(),
+  );
+  process.exit(2);
+}
+
+const target = join(HERE, entry[0]);
+// The child reads `process.argv.slice(2)`, so hand it an argv that looks like
+// it was invoked directly. Importing rather than spawning keeps one process
+// and, more importantly, one runtime.
+process.argv = [process.argv[0], target, ...rest];
+await import(pathToFileURL(target).href);

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-DpbUrMOQ.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-BLcvEFDR.js";
+import { a as AssetStore2D, i as syncTree2D, r as Renderer2D, t as createGame2D } from "./create-game-CHDLDQsQ.js";
+import { _ as RigidBody2D, a as parseCells, c as ColorRect2D, d as AnimatedSprite2D, f as Sprite2D, g as PhysicsBody2D, h as CharacterBody2D, i as mergeSolidRects, l as CharacterController2D, m as Area2D, n as UILayer, o as Particles2D, p as Joint2D, r as TileMap2D, s as Label, t as registerNodes2D, u as Camera2D, v as StaticBody2D, y as Node2D } from "./register-BpFcgdcL.js";
+import { n as enablePhysics2D, t as Physics2D } from "./physics-2d-BaRSRrrZ.js";
 //#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-C5jQYPah.js";
+import { B as StaticBody3D, F as WaterCutout3D, I as Area3D, L as CharacterBody3D, N as Water3D, P as WATER_CUTOUT_MAX, R as PhysicsBody3D, V as Node3D, W as WATER_MAX_RIPPLES, z as RigidBody3D } from "./gameplay-BBEjPFsR.js";
+import { A as Terrain3D, B as keyboardIntensity, C as resolveFlowerDensity, D as BoneLookAt3D, E as Camera3D, F as InstancedMesh3D, G as acquireTexture, H as rigPose, I as MeshInstance3D, M as TERRAIN_THEMES, N as terrainThemeLayers, O as BoneAttachment3D, P as Joint3D, R as QUARTER_PITCH, S as Flowers3D, T as CharacterController3D, U as TextureCache3D, V as movementState, W as acquireOwnTexture, _ as LoftMesh3D, a as Tree3D, b as Foliage3D, c as buildRiverRings, d as riverCarveChannels, f as riverStepFor, g as ModelInstance3D, h as Particles3D, i as VoxelGrid3D, j as DEFAULT_TERRAIN_TEXTURE_BASE, k as Billboard3D, l as findRiverCoverageGaps, m as traceDownhillPath, n as registerNodes3D, o as Trail3D, p as smoothCourse, r as VOXEL_PALETTE, s as River3D, u as projectToRiver, v as DirectionalLight3D, w as FLOWER_VARIETIES, x as DENSITY_PRESETS, y as OmniLight3D, z as cameraRelative } from "./environment-presets-DRAz5EV9.js";
+import { a as Environment3D, c as parseEnvironment3D, d as AssetStore3D, i as syncTree, l as sunDirectionFromElevationAzimuth, o as setEnvironment3D, r as Renderer3D, s as horizonColorFromSky, t as createGame3D, u as sunDirectionFromSky } from "./create-game-BiW8Men_.js";
 import { n as splatWeights, t as buildHeightmap } from "./heightmap-CRK0M4jT.js";
-import { n as enablePhysics3D, t as Physics3D } from "./physics-3d-QBrfIT2Y.js";
+import { n as enablePhysics3D, t as Physics3D } from "./physics-3d-CYxjh-HW.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-C5jQYPah.js → create-game-BiW8Men_.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-CDrAQqPp.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-RApWnM1G.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-QBrfIT2Y.js";
+import { E as Camera3D, U as TextureCache3D, g as ModelInstance3D, n as registerNodes3D, t as resolveEnvironmentHdri, v as DirectionalLight3D } from "./environment-presets-DRAz5EV9.js";
+import { n as enablePhysics3D } from "./physics-3d-CYxjh-HW.js";
 import { 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";
@@ -173,6 +173,59 @@ var AssetStore3D = class {
 	}
 };
 //#endregion
+//#region src/core/yield-frame.ts
+/**
+* Give the browser a chance to paint, and come back either way.
+*
+* Boot work that runs in slices — compiling shaders a few materials at a time,
+* reporting progress — yields between slices so the page stays responsive and
+* the loading bar can move. The obvious way to write that yield is
+* `requestAnimationFrame`, and it is a trap: **a browser does not run rAF for
+* a tab it considers hidden**, and "hidden" includes a background tab, a
+* minimized window, and a window fully covered by another one. Not slowly —
+* not at all. An `await` on rAF alone in that tab never returns.
+*
+* That is what happened to `createGame3D`: the shader warm-up hung mid-boot,
+* so the promise never resolved, the game's own `#loading` overlay was never
+* removed, and the dev channel — wired on the line after the one that hung —
+* never answered `incanto-frame` or `incanto-logs`. `incanto-verify` reported
+* `draws` and `says` as unmeasurable and told the reader to bring the window
+* to the front, which was true but sounded like a browser limitation. It was
+* ours, and it made two of the five verification rungs unreachable to anything
+* that cannot focus a window.
+*
+* So: race the frame against a timer. When frames are coming the frame wins
+* (~16 ms) and the behaviour is what it always was. When none is coming the
+* timer wins and the boot finishes — slower, because a hidden tab also clamps
+* timers to about a second, but finished beats hung.
+*/
+/** How long to wait for a paint that may never come. */
+const DEFAULT_MAX_WAIT_MS = 50;
+/**
+* Resolve on the next painted frame, or after `maxWaitMs`, whichever is first.
+*
+* @param maxWaitMs how long to wait for a frame before giving up on one
+* @param raf injected for tests; defaults to the global
+*/
+function yieldToFrame(maxWaitMs = DEFAULT_MAX_WAIT_MS, raf = typeof requestAnimationFrame === "function" ? requestAnimationFrame : void 0) {
+	return new Promise((resolve) => {
+		let done = false;
+		const finish = () => {
+			if (done) return;
+			done = true;
+			resolve();
+		};
+		const timer = setTimeout(finish, Math.max(0, maxWaitMs));
+		if (!raf) return;
+		raf(() => {
+			setTimeout(() => {
+				clearTimeout(timer);
+				finish();
+			}, 0);
+		});
+	});
+}
+//#endregion
 //#region src/3d/environment.ts
 const SKY_KEYS = [
 	"type",
@@ -1804,9 +1857,7 @@ var Renderer3D = class {
 				for (let k = i * per; k < Math.min((i + 1) * per, hidden.length); k++) hidden[k].visible = true;
 				this.webgl.compile(this.threeScene, camera);
 				onProgress?.((i + 1) / slices);
-				if (typeof requestAnimationFrame === "function") await new Promise((resolve) => {
-					requestAnimationFrame(() => setTimeout(resolve, 0));
-				});
+				await yieldToFrame();
 			}
 		} finally {
 			for (const obj of hidden) obj.visible = true;
@@ -2333,10 +2384,7 @@ async function createGame3D(opts) {
 	const report = async (fraction, label) => {
 		if (!opts.onProgress) return;
 		opts.onProgress(fraction, label);
-		if (typeof requestAnimationFrame !== "function") return;
-		await new Promise((resolve) => {
-			requestAnimationFrame(() => setTimeout(resolve, 0));
-		});
+		await yieldToFrame();
 	};
 	registerNodes3D();
 	if (opts.gameplay ?? true) registerGameplayBehaviors();

package/dist/{create-game-DpbUrMOQ.js → create-game-CHDLDQsQ.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-CDrAQqPp.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-RApWnM1G.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-BpFcgdcL.js";
 import { t as debugSources } from "./debug-draw-BM3DsvtT.js";
-import { n as enablePhysics2D } from "./physics-2d-BLcvEFDR.js";
+import { n as enablePhysics2D } from "./physics-2d-BaRSRrrZ.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-DRAz5EV9.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-CDrAQqPp.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;

package/dist/{gameplay-BVphcxmE.js → gameplay-BBEjPFsR.js}

@@ -1,7 +1,7 @@
-import { A as registerBehavior, C as diagnose, S as Node, T as Behavior, f as SaveSlots, n as loadScene, y as effectiveOrder } from "./loader-BcrRSjxB.js";
+import { C as Node, E as Behavior, b as effectiveOrder, j as registerBehavior, n as loadScene, p as SaveSlots, w as diagnose } from "./loader-D8n7TU8W.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
-import { t as jsonClone } from "./json-BLk7H2Qa.js";
-import { t as duplicateNode } from "./duplicate-BPLZDZpd.js";
+import { t as jsonClone } from "./json-CwwhxQgb.js";
+import { t as duplicateNode } from "./duplicate-DJQd44CD.js";
 import { Color, CubeCamera, DepthTexture, DoubleSide, Euler, FloatType, Frustum, HalfFloatType, LinearMipmapLinearFilter, MathUtils, Matrix4, Mesh, MeshDepthMaterial, Object3D, PerspectiveCamera, Plane, PlaneGeometry, Quaternion, ShaderMaterial, Sphere, Vector2, Vector3, Vector4, WebGLCubeRenderTarget, WebGLRenderTarget } from "three";
 //#region src/3d/frustum.ts
 const scratchFrustum = new Frustum();
@@ -2441,43 +2441,62 @@ var Node3D = class Node3D extends Node {
 * `{shape:'capsule', radius, height}` (meters, y-up).
 */
 var PhysicsBody3D = class extends Node3D {
-	static props = { collider: {
-		default: {},
-		variants: {
-			tag: "shape",
-			byTag: {
-				auto: { shape: "auto" },
-				box: {
-					shape: "box",
-					size: [
-						1,
-						1,
-						1
-					]
-				},
-				sphere: {
-					shape: "sphere",
-					radius: .5
-				},
-				capsule: {
-					shape: "capsule",
-					radius: .35,
-					height: 1
-				},
-				trimesh: {
-					shape: "trimesh",
-					vertices: [],
-					indices: []
-				},
-				heightfield: { shape: "heightfield" }
+	static props = {
+		collider: {
+			default: {},
+			variants: {
+				tag: "shape",
+				byTag: {
+					auto: { shape: "auto" },
+					box: {
+						shape: "box",
+						size: [
+							1,
+							1,
+							1
+						]
+					},
+					sphere: {
+						shape: "sphere",
+						radius: .5
+					},
+					capsule: {
+						shape: "capsule",
+						radius: .35,
+						height: 1
+					},
+					trimesh: {
+						shape: "trimesh",
+						vertices: [],
+						indices: []
+					},
+					heightfield: { shape: "heightfield" }
+				}
 			}
-		}
-	} };
+		},
+		/**
+		* Whether this body's collider takes part in physics right now.
+		*
+		* A melee hitbox is off most of the time and live for a few frames of a
+		* swing, and there was no way to say so: games expressed it by REPLACING
+		* `collider` with `{}`, which tears the rigid body down and builds a new
+		* one twice per swing, and makes the engine warn `has no collider —
+		* physics skips it` about a scene that is correct. Keep the real collider
+		* and turn it off.
+		*
+		* Off means no contacts and no `triggerEnter`/`triggerExit`. The body
+		* itself stays, so nothing is rebuilt and re-arming is one call.
+		*/
+		enabled: { default: true }
+	};
 	/** The unified collision model: every collider participant can emit these. */
 	static signals = ["triggerEnter", "triggerExit"];
 	_collider = {};
 	/** @internal Physics resync flag — raised when `collider` is REPLACED. */
 	_colliderChanged = false;
+	_enabled = true;
+	/** @internal Physics resync flag — raised when `enabled` is written. */
+	_enabledChanged = false;
 	/**
 	* Collider shape prop. Change it by REPLACING the object
 	* (`body.collider = { shape: 'box', size: [...] }`) — physics rebuilds the
@@ -2490,6 +2509,15 @@ var PhysicsBody3D = class extends Node3D {
 		this._collider = value;
 		this._colliderChanged = true;
 	}
+	/** See the `enabled` prop. Writing it arms or disarms the existing collider. */
+	get enabled() {
+		return this._enabled;
+	}
+	set enabled(value) {
+		if (value === this._enabled) return;
+		this._enabled = value;
+		this._enabledChanged = true;
+	}
 	/** Loader hook: bad collider shapes fail at LOAD, not at physics start. */
 	static validateJson(node) {
 		const body = node;

package/dist/gameplay.d.ts

@@ -1,4 +1,4 @@
-import { At as Node, b as Engine, d as PropSchema, n as BehaviorCtor, t as Behavior } from "./behavior-l08AEbq9.js";
+import { At as Node, b as Engine, d as PropSchema, n as BehaviorCtor, t as Behavior } from "./behavior-DWKTUzKI.js";
 import { c as JsonValue, s as JsonObject } from "./schema-CFeioQRE.js";
 
 //#region src/gameplay/chase.d.ts

package/dist/gameplay.js

@@ -1,2 +1,2 @@
-import { A as Health, C as restartScene, D as DayNight, E as FloatAway, M as Chase, O as phaseOf, S as goToScene, T as FollowCamera, _ as Cooldown, a as Wander, b as Interactable, c as SavePoint, d as Patrol, f as PathFollow, g as CameraShake, h as Lifetime, i as WaveSpawner, j as Collector, k as DamageOnContact, l as Projectile, m as MoveTo, n as registerGameplayBehaviors, o as Spawner, p as Oscillate, r as ZombieAI, s as ScoreKeeper, t as GAMEPLAY_BEHAVIORS, u as Pickup, v as hitStop, x as GameFlow, y as screenFlash } from "./gameplay-BVphcxmE.js";
+import { A as Health, C as restartScene, D as DayNight, E as FloatAway, M as Chase, O as phaseOf, S as goToScene, T as FollowCamera, _ as Cooldown, a as Wander, b as Interactable, c as SavePoint, d as Patrol, f as PathFollow, g as CameraShake, h as Lifetime, i as WaveSpawner, j as Collector, k as DamageOnContact, l as Projectile, m as MoveTo, n as registerGameplayBehaviors, o as Spawner, p as Oscillate, r as ZombieAI, s as ScoreKeeper, t as GAMEPLAY_BEHAVIORS, u as Pickup, v as hitStop, x as GameFlow, y as screenFlash } from "./gameplay-BBEjPFsR.js";
 export { CameraShake, Chase, Collector, Cooldown, DamageOnContact, DayNight, FloatAway, FollowCamera, GAMEPLAY_BEHAVIORS, GameFlow, Health, Interactable, Lifetime, MoveTo, Oscillate, PathFollow, Patrol, Pickup, Projectile, SavePoint, ScoreKeeper, Spawner, Wander, WaveSpawner, ZombieAI, goToScene, hitStop, phaseOf, registerGameplayBehaviors, restartScene, screenFlash };