incanto 0.36.1 → 0.37.0

package/bin/incanto-feel.mjs

@@ -0,0 +1,93 @@
+#!/usr/bin/env node
+import { readFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+/**
+ * incanto-feel — what your controls actually FEEL like, as numbers.
+ *
+ *   bunx incanto-feel src/game.scene.json
+ *
+ * `capture()` and `framing()` are snapshots. Game feel lives on the time axis:
+ * how high the jump really goes, how many frames a turn costs, how wide the
+ * coyote window really is. This drives the player through scripted probes and
+ * reports the measurements.
+ *
+ * The windows are MEASURED by probing, not read off the schema — so a
+ * `coyoteSeconds` the controller never consults reports 0 ms. That was a real
+ * bug in this engine's own 3D controller, and the JSON looked correct
+ * throughout.
+ *
+ * It reports numbers and does not grade them: "good" jump feel is a genre
+ * decision, and a PASS/FAIL table against invented bands would be confidently
+ * wrong for most games.
+ */
+import { fileURLToPath, pathToFileURL } from 'node:url';
+
+const PKG = join(dirname(fileURLToPath(import.meta.url)), '..');
+
+function parseArgs(argv) {
+  const args = {};
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === '--behaviors') args.behaviors = argv[++i];
+    else if (a === '--move') args.move = argv[++i];
+    else if (a === '--jump') args.jump = argv[++i];
+    else if (a === '--json') args.json = true;
+    else if (a === '--help' || a === '-h') args.help = true;
+    else if (a.startsWith('--')) {
+      console.error(`unknown flag: ${a}`);
+      args.help = true;
+    } else if (!args.scene) args.scene = a;
+  }
+  return args;
+}
+
+const args = parseArgs(process.argv.slice(2));
+if (args.help || !args.scene) {
+  console.error(`Usage: incanto-feel <scene.json> [options]
+
+  --behaviors FILE  your Behavior subclasses (.ts works on node >= 23.6 / bun)
+  --move ACTION     the vector action to move with (default: the first vector2)
+  --jump ACTION     the button to jump with (default: "jump")
+  --json            the report as JSON instead of prose`);
+  process.exit(args.help && args.scene !== undefined ? 0 : 1);
+}
+
+const { feelReport, feelText } = await import(pathToFileURL(join(PKG, 'dist', 'test.js')).href);
+const incanto = await import(pathToFileURL(join(PKG, 'dist', 'index.js')).href);
+
+const behaviors = {};
+if (args.behaviors) {
+  let mod;
+  try {
+    mod = await import(pathToFileURL(resolve(args.behaviors)).href);
+  } catch (e) {
+    console.error(`could not load --behaviors '${args.behaviors}' (${e?.message ?? e}).`);
+    process.exit(1);
+  }
+  for (const [name, value] of Object.entries(mod)) {
+    if (typeof value === 'function' && value.prototype instanceof incanto.Behavior) {
+      behaviors[name] = value;
+    }
+  }
+}
+
+const scenePath = resolve(args.scene);
+const sceneDir = dirname(scenePath);
+const sceneJson = JSON.parse(readFileSync(scenePath, 'utf-8'));
+
+let report;
+try {
+  report = await feelReport(sceneJson, {
+    behaviors,
+    stubMissingBehaviors: !args.behaviors,
+    ...(args.move ? { moveAction: args.move } : {}),
+    ...(args.jump ? { jumpAction: args.jump } : {}),
+    resolveScene: (p) => JSON.parse(readFileSync(resolve(sceneDir, p), 'utf-8')),
+  });
+} catch (e) {
+  console.error(`feel failed: ${e?.message ?? e}`);
+  process.exit(1);
+}
+
+process.stdout.write(args.json ? `${JSON.stringify(report, null, 2)}\n` : `${feelText(report)}\n`);
+process.exit(report.player ? 0 : 1);

package/bin/incanto-playtest.mjs

@@ -0,0 +1,136 @@
+#!/usr/bin/env node
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+/**
+ * incanto-playtest — the engine plays your game and tells you whether it works.
+ *
+ *   bunx incanto-playtest src/game.scene.json --runs 20 --seconds 60
+ *
+ * `incanto-check` answers "will it load". This answers "is it a game": can it
+ * be finished, which destinations are unreachable, which wires never fire, and
+ * whether anything in it can hurt the player.
+ *
+ * Runs are seeded and headless — no renderer, no browser — so twenty minutes of
+ * simulated play costs a second or two. A run that did NOT win is written out
+ * as a replay you can watch:
+ *
+ *   bunx incanto-play src/game.scene.json --commands .incanto/playtest/fell-seed7.txt
+ *
+ * Without --behaviors, unregistered scripts are stubbed: the structure plays,
+ * your game logic does not. Pass the file that exports your Behavior subclasses
+ * to test the real thing.
+ *
+ * Exit code 1 when no run reached a win, so CI can gate on it.
+ */
+import { fileURLToPath, pathToFileURL } from 'node:url';
+
+const PKG = join(dirname(fileURLToPath(import.meta.url)), '..');
+
+function parseArgs(argv) {
+  const args = { runs: 20, seconds: 60, seed: 1, out: '.incanto/playtest' };
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === '--behaviors') args.behaviors = argv[++i];
+    else if (a === '--runs') args.runs = Number(argv[++i]);
+    else if (a === '--seconds') args.seconds = Number(argv[++i]);
+    else if (a === '--seed') args.seed = Number(argv[++i]);
+    else if (a === '--out') args.out = argv[++i];
+    else if (a === '--no-replays') args.noReplays = true;
+    else if (a === '--json') args.json = true;
+    else if (a === '--help' || a === '-h') args.help = true;
+    else if (a.startsWith('--')) {
+      console.error(`unknown flag: ${a}`);
+      args.help = true;
+    } else if (!args.scene) args.scene = a;
+  }
+  return args;
+}
+
+const args = parseArgs(process.argv.slice(2));
+if (args.help || !args.scene) {
+  console.error(`Usage: incanto-playtest <scene.json> [options]
+
+  --runs N          independent seeded runs (default 20)
+  --seconds N       simulated seconds per run before calling it stuck (default 60)
+  --seed N          first seed; run i uses seed+i (default 1)
+  --behaviors FILE  your Behavior subclasses (.ts works on node >= 23.6 / bun)
+  --out DIR         where failing replays go (default .incanto/playtest)
+  --no-replays      report only, write nothing
+  --json            the full report as JSON instead of prose
+
+Exits 1 when no run reached a win.`);
+  process.exit(args.help && args.scene !== undefined ? 0 : 1);
+}
+
+const { playtest, playtestText, failingReplays } = await import(
+  pathToFileURL(join(PKG, 'dist', 'test.js')).href
+);
+const incanto = await import(pathToFileURL(join(PKG, 'dist', 'index.js')).href);
+
+const behaviors = {};
+if (args.behaviors) {
+  let mod;
+  try {
+    mod = await import(pathToFileURL(resolve(args.behaviors)).href);
+  } catch (e) {
+    console.error(
+      `could not load --behaviors '${args.behaviors}' (${e?.message ?? e}). ` +
+        'Pass the file that exports your Behavior subclasses, e.g. src/behaviors.ts.',
+    );
+    process.exit(1);
+  }
+  for (const [name, value] of Object.entries(mod)) {
+    if (typeof value === 'function' && value.prototype instanceof incanto.Behavior) {
+      behaviors[name] = value;
+    }
+  }
+  if (Object.keys(behaviors).length === 0) {
+    console.error(`warning: no Behavior subclasses exported from ${args.behaviors}`);
+  }
+}
+
+const scenePath = resolve(args.scene);
+const sceneJson = JSON.parse(readFileSync(scenePath, 'utf-8'));
+const sceneDir = dirname(scenePath);
+
+let report;
+try {
+  report = await playtest(sceneJson, {
+    runs: args.runs,
+    seconds: args.seconds,
+    seed: args.seed,
+    behaviors,
+    stubMissingBehaviors: !args.behaviors,
+    // sub-scenes resolve relative to the scene file, as the loader does
+    resolveScene: (p) => JSON.parse(readFileSync(resolve(sceneDir, p), 'utf-8')),
+  });
+} catch (e) {
+  console.error(`playtest failed: ${e?.message ?? e}`);
+  process.exit(1);
+}
+
+if (args.json) {
+  process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
+} else {
+  process.stdout.write(`${playtestText(report)}\n`);
+}
+
+// A failing run is only useful if you can watch it. One file per outcome kind —
+// twenty identical "stuck" replays teach nothing that the first one does not.
+if (!args.noReplays && !args.json) {
+  const seen = new Set();
+  const written = [];
+  for (const { seed, outcome, replay } of failingReplays(report)) {
+    if (seen.has(outcome)) continue;
+    seen.add(outcome);
+    const file = join(resolve(args.out), `${outcome}-seed${seed}.json`);
+    mkdirSync(dirname(file), { recursive: true });
+    writeFileSync(file, JSON.stringify(replay, null, 2));
+    written.push(file);
+  }
+  if (written.length > 0) {
+    process.stdout.write(`\n  replays: ${written.join('\n           ')}\n`);
+  }
+}
+
+process.exit(report.runs.some((r) => r.outcome === 'won') ? 0 : 1);

package/dist/2d.d.ts

@@ -1,7 +1,7 @@
-import { N as Scene$1, S as Scheduler, T as RendererStats, Tt as Node, b as Engine, d as PropSchema, n as BehaviorCtor, w as GameStats } from "./behavior-DibCwrW7.js";
+import { N as Scene$1, S as Scheduler, T as RendererStats, Tt as Node, b as Engine, d as PropSchema, n as BehaviorCtor, w as GameStats } from "./behavior-5o1EkbLD.js";
 import { n as DiagnosticSink, t as EditorSwitchOptions } from "./editor-switch-DVwIGZdK.js";
 import { i as SceneJson, s as JsonObject } from "./schema-CFeioQRE.js";
-import { t as LoadSceneOptions } from "./loader-BqigZsfF.js";
+import { t as LoadSceneOptions } from "./loader-iGq2PT_k.js";
 import { t as ParticleSim } from "./particle-sim-BzJ1yxoE.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-D-StzrTj.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-COGCNitr.js";
-import { n as enablePhysics2D, t as Physics2D } from "./physics-2d-B4v39hca.js";
+import { a as AssetStore2D, i as syncTree2D, r as Renderer2D, t as createGame2D } from "./create-game-DmGc-Mrn.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-DFSW2Y30.js";
+import { n as enablePhysics2D, t as Physics2D } from "./physics-2d-C8Hi40qb.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,9 +1,9 @@
-import { N as Scene$1, S as Scheduler, T as RendererStats, Tt as Node, b as Engine, d as PropSchema, n as BehaviorCtor, w as GameStats } from "./behavior-DibCwrW7.js";
+import { N as Scene$1, S as Scheduler, T as RendererStats, Tt as Node, b as Engine, d as PropSchema, n as BehaviorCtor, w as GameStats } from "./behavior-5o1EkbLD.js";
 import { n as DiagnosticSink, t as EditorSwitchOptions } from "./editor-switch-DVwIGZdK.js";
 import { i as SceneJson, s as JsonObject } from "./schema-CFeioQRE.js";
-import { t as LoadSceneOptions } from "./loader-BqigZsfF.js";
+import { t as LoadSceneOptions } from "./loader-iGq2PT_k.js";
 import { t as ParticleSim } from "./particle-sim-BzJ1yxoE.js";
-import { n as PathGrid, s as SpatialPose } from "./pathfinding-B3QtdhvZ.js";
+import { n as PathGrid, s as SpatialPose } from "./pathfinding-pPrqtlWS.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";
@@ -1058,6 +1058,12 @@ declare class CharacterController3D extends Node3D {
   sprintMultiplier: number;
   jumpVelocity: number;
   sprintJumpMultiplier: number;
+  coyoteSeconds: number;
+  jumpBufferSeconds: number;
+  jumpCutMultiplier: number;
+  maxJumps: number;
+  airControl: number;
+  fallGravity: number;
   floatHeight: number;
   mouseLook: boolean;
   zoomMin: number;
@@ -1093,6 +1099,11 @@ declare class CharacterController3D extends Node3D {
   /** idle | walk | run | fastRun | airborne — drive animations from this. */
   state: "idle" | "walk" | "run" | "fastRun" | "airborne";
   grounded: boolean;
+  /** @internal Feel timers — see the jump block for what each one buys. */
+  private coyoteLeft;
+  private bufferLeft;
+  private jumpsUsed;
+  private rising;
   private get body();
   override onEnterTree(): void;
   override fixedUpdate(dt: number): void;

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-C0MUMSak.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-fK9oyrrR.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-DnOu2aAa.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-CsJDUQh_.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-DWHxLHM5.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-QqrrK3yr.js";
 import { n as splatWeights, t as buildHeightmap } from "./heightmap-CRK0M4jT.js";
-import { n as enablePhysics3D, t as Physics3D } from "./physics-3d-DFJVMYET.js";
+import { n as enablePhysics3D, t as Physics3D } from "./physics-3d-C0mWoWXC.js";
 //#region src/3d/environment-runtime.ts
 /**
 * Live environment editing — the renderer re-applies `scene.environment`

package/dist/{behavior-DibCwrW7.d.ts → behavior-5o1EkbLD.d.ts}

@@ -670,6 +670,17 @@ declare class InputMap {
   * scripted gameplay tests and touch buttons drive the game by intent
   * (`press('jump')`) instead of reverse-engineering keybinds.
   */
+  /**
+  * Every action this scene declared, with its kind.
+  *
+  * A scene states its own control vocabulary in `input{}`, which means a tool
+  * can drive a game it has never seen — the automated playtester's entire
+  * premise. Nothing else could ask: `actions` was private.
+  */
+  declaredActions(): Array<{
+    name: string;
+    type: "button" | "vector2";
+  }>;
   pressAction(action: string): void;
   /** Release an injected button action (yields one justReleased frame). */
   releaseAction(action: string): void;

package/dist/{create-game-D-StzrTj.js → create-game-DmGc-Mrn.js}

@@ -1,13 +1,13 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { n as loadScene, o as computeViewport, s as resolveViewport, v as diagnose, w as registerBehavior } from "./loader-DAZlgqeC.js";
-import { h as Engine, m as AudioPlayer } from "./register-BHAwM4bK.js";
+import { n as loadScene, o as computeViewport, s as resolveViewport, v as diagnose, w as registerBehavior } from "./loader-r49nDwB4.js";
+import { h as Engine, m as AudioPlayer } from "./register-DOWGnxe1.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { i as resolveRendering, n as attachTouchControls } from "./touch-BoNg_MnF.js";
 import { i as openBundledEditor, n as crossFade, r as devServerLibrary, t as teardown } from "./teardown-CCtAMDLB.js";
-import { n as registerGameplayBehaviors } from "./gameplay-C0MUMSak.js";
-import { g as PhysicsBody2D, n as UILayer, t as registerNodes2D, u as Camera2D, y as Node2D } from "./register-COGCNitr.js";
+import { n as registerGameplayBehaviors } from "./gameplay-CsJDUQh_.js";
+import { g as PhysicsBody2D, n as UILayer, t as registerNodes2D, u as Camera2D, y as Node2D } from "./register-DFSW2Y30.js";
 import { t as debugSources } from "./debug-draw-BM3DsvtT.js";
-import { n as enablePhysics2D } from "./physics-2d-B4v39hca.js";
+import { n as enablePhysics2D } from "./physics-2d-C8Hi40qb.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/{create-game-DnOu2aAa.js → create-game-QqrrK3yr.js}

@@ -1,13 +1,13 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { n as loadScene, v as diagnose, w as registerBehavior } from "./loader-DAZlgqeC.js";
-import { h as Engine, m as AudioPlayer } from "./register-BHAwM4bK.js";
+import { n as loadScene, v as diagnose, w as registerBehavior } from "./loader-r49nDwB4.js";
+import { h as Engine, m as AudioPlayer } from "./register-DOWGnxe1.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { i as resolveRendering, n as attachTouchControls } from "./touch-BoNg_MnF.js";
 import { a as poseFromRenderer, i as openBundledEditor, n as crossFade, r as devServerLibrary, t as teardown } from "./teardown-CCtAMDLB.js";
-import { B as createCausticsQuad, F as PhysicsBody3D, R as Node3D, n as registerGameplayBehaviors } from "./gameplay-C0MUMSak.js";
+import { B as createCausticsQuad, F as PhysicsBody3D, R as Node3D, n as registerGameplayBehaviors } from "./gameplay-CsJDUQh_.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-fK9oyrrR.js";
-import { n as enablePhysics3D } from "./physics-3d-DFJVMYET.js";
+import { E as Camera3D, U as TextureCache3D, g as ModelInstance3D, n as registerNodes3D, t as resolveEnvironmentHdri, v as DirectionalLight3D } from "./environment-presets-DWHxLHM5.js";
+import { n as enablePhysics3D } from "./physics-3d-C0mWoWXC.js";
 import { ACESFilmicToneMapping, AmbientLight, Box3, BufferAttribute, BufferGeometry, Color, DepthTexture, EquirectangularReflectionMapping, FloatType, Fog, HalfFloatType, LineBasicMaterial, LineSegments, Matrix4, Mesh, PCFShadowMap, PMREMGenerator, PerspectiveCamera, PlaneGeometry, Quaternion, Raycaster, Scene, ShaderMaterial, Vector2, Vector3, WebGLRenderTarget, WebGLRenderer } from "three";
 import { VRMLoaderPlugin, VRMUtils } from "@pixiv/three-vrm";
 import { GLTFLoader } from "three/addons/loaders/GLTFLoader.js";

package/dist/debug.d.ts

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

package/dist/{duplicate-Cvb1BSca.js → duplicate-CRtihGmC.js}

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

package/dist/editor.js

@@ -4057,7 +4057,7 @@ var Ur = class {
 		}) === !0;
 	}
 	reset(e) {
-		this.working = e, this.original = JSON.stringify(e), this.working.root && Wr(this.working.root), this.undoStack = [], this.selection = [], this.emit();
+		this.working = e, this.working.root && Wr(this.working.root), this.original = JSON.stringify(this.working), this.undoStack = [], this.selection = [], this.emit();
 	}
 	markSaved() {
 		this.original = JSON.stringify(this.working), this.emit();

package/dist/{environment-presets-fK9oyrrR.js → environment-presets-DWHxLHM5.js}

@@ -1,10 +1,10 @@
-import { t as registerCoreNodes } from "./register-BHAwM4bK.js";
+import { t as registerCoreNodes } from "./register-DOWGnxe1.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-IyWCGe4q.js";
 import { t as createNoise2D } from "./noise-CGUMx44x.js";
 import { i as applyParticlePreset, r as PARTICLE_PRESET_NAMES, t as ParticleSim } from "./particle-sim-Bw7hB93B.js";
-import { A as Water3D, F as PhysicsBody3D, H as colliderFootDrop, I as RigidBody3D, L as StaticBody3D, M as WaterCutout3D, N as Area3D, P as CharacterBody3D, R as Node3D } from "./gameplay-C0MUMSak.js";
+import { A as Water3D, F as PhysicsBody3D, H as colliderFootDrop, I as RigidBody3D, L as StaticBody3D, M as WaterCutout3D, N as Area3D, P as CharacterBody3D, R as Node3D } from "./gameplay-CsJDUQh_.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";
 import { clone } from "three/addons/utils/SkeletonUtils.js";
@@ -2488,11 +2488,9 @@ var Camera3D = class extends Node3D {
 //#endregion
 //#region src/3d/nodes/character-controller-3d.ts
 const ACC_DELTA_TIME = 8;
-const AIR_DRAG = .2;
 const DRAG_DAMPING = .15;
 const SPRING_K = 1.2;
 const SPRING_DAMPING = .08;
-const FALLING_GRAVITY_SCALE = 2.5;
 const FALLING_MAX_VEL = -20;
 const LOOK_SPEED = .002;
 const RAD2DEG = 180 / Math.PI;
@@ -2539,6 +2537,18 @@ var CharacterController3D = class extends Node3D {
 		sprintMultiplier: { default: 2 },
 		jumpVelocity: { default: 4 },
 		sprintJumpMultiplier: { default: 1.2 },
+		/** Jump this long AFTER walking off a ledge. The single biggest one. */
+		coyoteSeconds: { default: 0 },
+		/** Press jump this long BEFORE landing and still get it. */
+		jumpBufferSeconds: { default: 0 },
+		/** Releasing jump early cuts the rise to this fraction (1 = fixed height). */
+		jumpCutMultiplier: { default: 1 },
+		/** 2 = double jump. Extra jumps work in mid-air. */
+		maxJumps: { default: 1 },
+		/** How much of your ground control you keep in the air (0 = none, 1 = full). */
+		airControl: { default: .2 },
+		/** Gravity multiplier while falling — >1 is the "snappy" arc. */
+		fallGravity: { default: 2.5 },
 		floatHeight: { default: .01 },
 		mouseLook: { default: true },
 		zoomMin: { default: 0 },
@@ -2565,6 +2575,12 @@ var CharacterController3D = class extends Node3D {
 	sprintMultiplier = 2;
 	jumpVelocity = 4;
 	sprintJumpMultiplier = 1.2;
+	coyoteSeconds = 0;
+	jumpBufferSeconds = 0;
+	jumpCutMultiplier = 1;
+	maxJumps = 1;
+	airControl = .2;
+	fallGravity = 2.5;
 	floatHeight = .01;
 	mouseLook = true;
 	zoomMin = 0;
@@ -2600,6 +2616,11 @@ var CharacterController3D = class extends Node3D {
 	/** idle | walk | run | fastRun | airborne — drive animations from this. */
 	state = "idle";
 	grounded = false;
+	/** @internal Feel timers — see the jump block for what each one buys. */
+	coyoteLeft = 0;
+	bufferLeft = 0;
+	jumpsUsed = 0;
+	rising = false;
 	get body() {
 		const parent = this.parent;
 		if (!(parent instanceof RigidBody3D)) throw new IncantoError("TREE_VIOLATION", `CharacterController3D '${this.name}' must be a child of a RigidBody3D (parent is '${parent?.name ?? "none"}').`);
@@ -2653,6 +2674,7 @@ var CharacterController3D = class extends Node3D {
 			}
 		}
 		this.grounded = toi !== null && toi < floatingDis * 2;
+		const footed = toi !== null && toi < floatingDis * 1.3 && (vel[1] ?? 0) <= .5;
 		let mx = 0;
 		let mz = 0;
 		let moving = false;
@@ -2673,7 +2695,7 @@ var CharacterController3D = class extends Node3D {
 		const intensity = keyboardIntensity(moving, sprinting);
 		const speedMultiplier = 1 + (this.sprintMultiplier - 1) * intensity;
 		const targetSpeed = moving ? this.maxSpeed * speedMultiplier : 0;
-		const control = this.grounded ? 1 : AIR_DRAG;
+		const control = this.grounded ? 1 : this.airControl;
 		const ax = (mx * targetSpeed - vel[0]) / ACC_DELTA_TIME * control;
 		const az = (mz * targetSpeed - vel[2]) / ACC_DELTA_TIME * control;
 		body.applyImpulse([
@@ -2694,7 +2716,18 @@ var CharacterController3D = class extends Node3D {
 				0
 			]);
 		}
-		if (this.grounded && safePressed(input, this.jumpAction)) {
+		if (footed) {
+			this.coyoteLeft = this.coyoteSeconds;
+			this.jumpsUsed = 0;
+			this.rising = false;
+		} else {
+			this.coyoteLeft = Math.max(0, this.coyoteLeft - dt);
+			if (this.coyoteLeft <= 0 && this.jumpsUsed === 0) this.jumpsUsed = 1;
+		}
+		const pressedJump = safeJustPressed(input, this.jumpAction);
+		if (pressedJump) this.bufferLeft = Math.max(this.jumpBufferSeconds, 0);
+		else this.bufferLeft = Math.max(0, this.bufferLeft - dt);
+		if ((this.bufferLeft > 0 || pressedJump) && (footed || this.coyoteLeft > 0 || this.jumpsUsed < this.maxJumps)) {
 			const jumpVel = this.jumpVelocity * (1 + (this.sprintJumpMultiplier - 1) * intensity);
 			body.linearVelocity = [
 				vel[0],
@@ -2702,16 +2735,34 @@ var CharacterController3D = class extends Node3D {
 				vel[2]
 			];
 			this.grounded = false;
+			this.jumpsUsed += 1;
+			this.bufferLeft = 0;
+			this.coyoteLeft = 0;
+			this.rising = true;
+			vel[1] = jumpVel;
+		}
+		if (this.rising) {
+			if ((vel[1] ?? 0) <= 0) this.rising = false;
+			else if (this.jumpCutMultiplier < 1 && !safePressed(input, this.jumpAction)) {
+				const cut = (vel[1] ?? 0) * this.jumpCutMultiplier;
+				body.linearVelocity = [
+					vel[0],
+					cut,
+					vel[2]
+				];
+				vel[1] = cut;
+				this.rising = false;
+			}
 		}
-		if (vel[1] < FALLING_MAX_VEL) body.gravityScale = 0;
-		else if (vel[1] < 0 && !this.grounded) body.gravityScale = FALLING_GRAVITY_SCALE;
+		if ((vel[1] ?? 0) < FALLING_MAX_VEL) body.gravityScale = 0;
+		else if ((vel[1] ?? 0) < 0 && !footed) body.gravityScale = this.fallGravity;
 		else body.gravityScale = 1;
 		if (this.view === "side" && Math.abs(pos[2]) > .01) body.position = [
 			body.position[0] ?? 0,
 			body.position[1] ?? 0,
 			0
 		];
-		const next = movementState(this.grounded, moving ? intensity : 0);
+		const next = movementState(footed, moving ? intensity : 0);
 		if (next !== this.state) {
 			this.state = next;
 			const clip = this.animations[next];
@@ -2855,6 +2906,21 @@ function safePressed(input, action) {
 		return false;
 	}
 }
+/**
+* The EDGE, not the level.
+*
+* Jump used to read `isPressed`, so holding the button re-jumped on every frame
+* the raycast found ground — an auto-hop nobody asked for, and one that makes
+* coyote time incoherent (a held button would re-fire through the whole
+* window). Same undeclared-action tolerance as `safePressed`.
+*/
+function safeJustPressed(input, action) {
+	try {
+		return input.justPressed(action);
+	} catch {
+		return false;
+	}
+}
 //#endregion
 //#region src/3d/vegetation/grass-placement.ts
 const NOISE_SCALE = .15;

package/dist/{gameplay-C0MUMSak.js → gameplay-CsJDUQh_.js}

@@ -1,7 +1,7 @@
-import { f as Node, h as effectiveOrder, n as loadScene, w as registerBehavior, y as Behavior } from "./loader-DAZlgqeC.js";
+import { f as Node, h as effectiveOrder, n as loadScene, w as registerBehavior, y as Behavior } from "./loader-r49nDwB4.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as jsonClone } from "./json-BLk7H2Qa.js";
-import { t as duplicateNode } from "./duplicate-Cvb1BSca.js";
+import { t as duplicateNode } from "./duplicate-CRtihGmC.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();

package/dist/gameplay.d.ts

@@ -1,4 +1,4 @@
-import { Tt as Node, b as Engine, d as PropSchema, n as BehaviorCtor, t as Behavior } from "./behavior-DibCwrW7.js";
+import { Tt as Node, b as Engine, d as PropSchema, n as BehaviorCtor, t as Behavior } from "./behavior-5o1EkbLD.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 { C as FollowCamera, D as Health, E as DamageOnContact, O as Collector, S as restartScene, T as phaseOf, _ as hitStop, a as Wander, b as GameFlow, c as Projectile, d as PathFollow, f as Oscillate, g as Cooldown, h as CameraShake, i as WaveSpawner, k as Chase, l as Pickup, m as Lifetime, n as registerGameplayBehaviors, o as Spawner, p as MoveTo, r as ZombieAI, s as ScoreKeeper, t as GAMEPLAY_BEHAVIORS, u as Patrol, v as screenFlash, w as DayNight, x as goToScene, y as Interactable } from "./gameplay-C0MUMSak.js";
+import { C as FollowCamera, D as Health, E as DamageOnContact, O as Collector, S as restartScene, T as phaseOf, _ as hitStop, a as Wander, b as GameFlow, c as Projectile, d as PathFollow, f as Oscillate, g as Cooldown, h as CameraShake, i as WaveSpawner, k as Chase, l as Pickup, m as Lifetime, n as registerGameplayBehaviors, o as Spawner, p as MoveTo, r as ZombieAI, s as ScoreKeeper, t as GAMEPLAY_BEHAVIORS, u as Patrol, v as screenFlash, w as DayNight, x as goToScene, y as Interactable } from "./gameplay-CsJDUQh_.js";
 export { CameraShake, Chase, Collector, Cooldown, DamageOnContact, DayNight, FollowCamera, GAMEPLAY_BEHAVIORS, GameFlow, Health, Interactable, Lifetime, MoveTo, Oscillate, PathFollow, Patrol, Pickup, Projectile, ScoreKeeper, Spawner, Wander, WaveSpawner, ZombieAI, goToScene, hitStop, phaseOf, registerGameplayBehaviors, restartScene, screenFlash };