incanto 0.36.2 → 0.38.0

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-B5PJ32eu.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

@@ -1121,6 +1121,27 @@ var ht = {
 				en: "Options are the locales the scene declares in \"strings\", each labeled with its own endonym. Picking one switches the game live and persists it. English is the base: any key a locale omits falls back to it, on purpose.",
 				ko: "옵션은 씬의 \"strings\"가 선언한 로케일이며, 각 언어의 자기 이름으로 표시됩니다. 선택하면 즉시 바뀌고 저장됩니다. 영어가 기준이라 로케일이 빠뜨린 키는 의도적으로 영어로 표시됩니다."
 			}),
+			R("UiQualitySelect", {
+				en: "Graphics quality — Low, Medium, High. Already wired.",
+				ko: "그래픽 품질 — Low, Medium, High. 이미 연결되어 있습니다."
+			}, {
+				en: "Low turns off shadows, bloom, post and clouds; Medium keeps shadows but makes them static and drops post; High is everything. Applies live and persists. Antialiasing follows the tier on the NEXT launch — it is a WebGL context attribute and cannot change while a context exists. Picking records a human choice, so device detection never overrides it later.",
+				ko: "Low는 그림자·블룸·포스트·구름을 끄고, Medium은 그림자를 정적으로 유지하며 포스트를 끄고, High는 전부 켭니다. 즉시 적용되고 저장됩니다. 안티에일리어싱만 다음 실행부터 반영됩니다(WebGL 컨텍스트 속성이라 생성 후에는 못 바꿉니다). 사람이 고른 값으로 기록되어 이후 자동 감지가 덮어쓰지 않습니다."
+			}),
+			R("UiFrameCapSelect", {
+				en: "Frame rate cap — 30, 60, 120 or Unlimited.",
+				ko: "프레임 제한 — 30, 60, 120 또는 무제한."
+			}, {
+				en: "Gates the whole frame, not just the render, so it saves CPU as well as GPU — a cooler phone and a longer battery. Unlimited (0) is the default. Restrict the list with options, e.g. \"60,120,0\".",
+				ko: "렌더뿐 아니라 프레임 전체를 제한하므로 GPU와 CPU를 함께 아낍니다 — 발열과 배터리에 유리합니다. 기본값은 무제한(0). options로 목록을 줄일 수 있습니다(예: \"60,120,0\")."
+			}),
+			R("UiRenderScaleSelect", {
+				en: "Resolution scale — 50%, 75%, 100%.",
+				ko: "해상도 배율 — 50%, 75%, 100%."
+			}, {
+				en: "The cheapest frames on a weak GPU: at 75% the fragment shaders run over 56% of the pixels for a slightly softer image and nothing else, where dropping a quality tier costs the shadows outright. Multiplies with the engine's automatic resolution governor rather than fighting it.",
+				ko: "저사양 GPU에서 가장 값싼 프레임: 75%면 픽셀의 약 56%만 셰이딩하므로 이미지가 약간 부드러워질 뿐이지만, 품질 단계를 낮추면 그림자가 통째로 사라집니다. 엔진의 자동 해상도 조절과 충돌하지 않고 곱해집니다."
+			}),
 			R("UiSelect", {
 				en: "One of several — quality, resolution, language.",
 				ko: "여러 개 중 하나 — 품질, 해상도, 언어."

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

@@ -1,10 +1,10 @@
-import { t as registerCoreNodes } from "./register-BHAwM4bK.js";
+import { t as registerCoreNodes } from "./register-Dm7nrd-E.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-B5PJ32eu.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 };

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-import { $ as translationKey, A as qualityEnvironment, At as LogManager, B as restoreBehaviors, C as EngineStats, Ct as AudioBuses, D as QualityTier, Dt as SceneTree, E as DeviceHints, Et as NodeLifecycle, F as RestoreReport, G as OrderGroupTable, H as createSaveStore, I as SaveSlot, J as BASE_LOCALE, K as effectiveOrder, L as SaveSlots, M as suggestQuality, Mt as SignalListener, N as Scene, O as Settings, Ot as LogEntry, P as BehaviorState, Q as suggestLocale, R as behaviorsWithoutSave, S as Scheduler, St as PlayMusicOptions, T as RendererStats, Tt as Node, U as ORDER_GROUP_BASE, V as SaveStore, W as OrderGroup, X as Localization, Y as LocaleTables, Z as T_PREFIX, _ as mergeStaticSignals, _t as SynthOptions, a as clearBehaviors, at as VoicePreset, b as Engine, bt as MusicManager, c as registeredBehaviors, ct as RolloffModel, d as PropSchema, dt as spatialGain, et as InputMap, f as clearRegistry, ft as spatialPan, g as getNodeType, gt as SfxWave, h as getNodeSignals, ht as SfxParams, i as behaviorSignals, it as Voice, j as readDeviceHints, jt as Signal, k as SettingsValues, kt as LogLevel, l as NodeCtor, lt as SpatialParams, m as getNodeSchema, mt as SFX_PRESET_NAMES, n as BehaviorCtor, nt as SfxPlayOptions, o as getBehavior, ot as Listener, p as createNode, pt as SFX_PRESETS, q as resolveOrderGroups, r as behaviorSchema, rt as isAudioContextAvailable, s as registerBehavior, st as ROLLOFF_MODELS, t as Behavior, tt as SfxEngine, u as PropDef, ut as Vec3, v as registerNode, vt as synthSfx, w as GameStats, wt as BusName, x as EngineOptions, xt as MusicTrack, y as registeredTypes, yt as MusicBackend, z as captureBehaviors } from "./behavior-DibCwrW7.js";
+import { $ as translationKey, A as qualityEnvironment, At as LogManager, B as restoreBehaviors, C as EngineStats, Ct as AudioBuses, D as QualityTier, Dt as SceneTree, E as DeviceHints, Et as NodeLifecycle, F as RestoreReport, G as OrderGroupTable, H as createSaveStore, I as SaveSlot, J as BASE_LOCALE, K as effectiveOrder, L as SaveSlots, M as suggestQuality, Mt as SignalListener, N as Scene, O as Settings, Ot as LogEntry, P as BehaviorState, Q as suggestLocale, R as behaviorsWithoutSave, S as Scheduler, St as PlayMusicOptions, T as RendererStats, Tt as Node, U as ORDER_GROUP_BASE, V as SaveStore, W as OrderGroup, X as Localization, Y as LocaleTables, Z as T_PREFIX, _ as mergeStaticSignals, _t as SynthOptions, a as clearBehaviors, at as VoicePreset, b as Engine, bt as MusicManager, c as registeredBehaviors, ct as RolloffModel, d as PropSchema, dt as spatialGain, et as InputMap, f as clearRegistry, ft as spatialPan, g as getNodeType, gt as SfxWave, h as getNodeSignals, ht as SfxParams, i as behaviorSignals, it as Voice, j as readDeviceHints, jt as Signal, k as SettingsValues, kt as LogLevel, l as NodeCtor, lt as SpatialParams, m as getNodeSchema, mt as SFX_PRESET_NAMES, n as BehaviorCtor, nt as SfxPlayOptions, o as getBehavior, ot as Listener, p as createNode, pt as SFX_PRESETS, q as resolveOrderGroups, r as behaviorSchema, rt as isAudioContextAvailable, s as registerBehavior, st as ROLLOFF_MODELS, t as Behavior, tt as SfxEngine, u as PropDef, ut as Vec3, v as registerNode, vt as synthSfx, w as GameStats, wt as BusName, x as EngineOptions, xt as MusicTrack, y as registeredTypes, yt as MusicBackend, z as captureBehaviors } from "./behavior-B5PJ32eu.js";
 import { a as Rng, c as JsonValue, d as jsonKind, i as SceneJson, l as jsonClone, n as NodeJson, o as JsonKind, r as SCENE_FORMAT, s as JsonObject, t as ConnectionJson, u as jsonEquals } from "./schema-CFeioQRE.js";
-import { n as loadScene, t as LoadSceneOptions } from "./loader-BqigZsfF.js";
+import { n as loadScene, t as LoadSceneOptions } from "./loader-DSMdqasu.js";
 import { n as ParticleSimConfig, r as ParticleView, t as ParticleSim } from "./particle-sim-BzJ1yxoE.js";
-import { a as AudioElementLike, i as gridFromRows, n as PathGrid, o as AudioPlayer, r as findPath, t as FindPathOptions } from "./pathfinding-B3QtdhvZ.js";
-import { i as auditScene, n as IncantoErrorCode, r as IncantoErrorDetails, t as IncantoError } from "./errors-DGRtWlSx.js";
+import { a as AudioElementLike, i as gridFromRows, n as PathGrid, o as AudioPlayer, r as findPath, t as FindPathOptions } from "./pathfinding-BrE5Uec6.js";
+import { a as startRecording, c as IncantoErrorDetails, i as replay, l as auditScene, n as ReplayEvent, o as IncantoError, r as ReplayJson, s as IncantoErrorCode, t as Recorder } from "./replay-Cxrr-ApH.js";
 
 //#region src/core/audio/crossfade.d.ts
 /**
@@ -586,52 +586,6 @@ declare function resolveRendering(environment: JsonObject | undefined, fallback:
   preserveDrawingBuffer?: boolean;
 }): ResolvedRendering;
 //#endregion
-//#region src/core/replay.d.ts
-/**
-* Deterministic input replay — the engine already runs on a seeded RNG and
-* an injectable clock, so a recording of (tick timestamps + input events)
-* replays BIT-IDENTICALLY into a fresh engine with the same seed and scene.
-* That turns "does my game still work?" into an assertion an agent can run
-* headlessly: record once while playing, replay forever as a regression.
-*
-*   const rec = startRecording(engine);            // play the game...
-*   const replayJson = rec.stop();                 // ...save this JSON
-*
-*   const fresh = new Engine({ seed: SAME_SEED }); // same seed + scene JSON
-*   fresh.setScene(loadScene(sceneJson));
-*   replay(fresh, replayJson);                     // now assert game state
-*
-* Caveats (documented, by design): game code must use `engine.rng` (not
-* Math.random) and dt/engine.time (not Date.now) — the engine's own rules.
-* Gamepad polling is not recorded (bind pads to actions; actions replay).
-*/
-/** [tickIndex, methodName, ...primitive args] */
-type ReplayEvent = [number, string, ...(string | number | boolean)[]];
-interface ReplayJson {
-  /** File-format marker for forward compatibility. */
-  replay: 1;
-  /** Tick timestamps (ms) exactly as the loop delivered them. */
-  ticks: number[];
-  events: ReplayEvent[];
-}
-interface Recorder {
-  /** Detach the taps and return the recording. */
-  stop(): ReplayJson;
-}
-/**
-* Tap the engine's input entry points and tick clock. Recording starts at
-* the CURRENT moment — start it before the first tick for full-run replays.
-*/
-declare function startRecording(engine: Engine): Recorder;
-/**
-* Drive a fresh engine through a recording: for each recorded tick, feed
-* that tick's input events first, then tick with the recorded timestamp.
-* `onTick(index)` lets tests assert mid-run state.
-*/
-declare function replay(engine: Engine, recording: ReplayJson, opts?: {
-  onTick?: (index: number) => void;
-}): void;
-//#endregion
 //#region src/core/scene/constants.d.ts
 /** The single reserved key marking a prop value as a constant reference. */
 declare const CONST_REF_KEY = "@const";

package/dist/index.js

@@ -1,14 +1,14 @@
-import { C as getBehavior, E as Signal, S as clearBehaviors, T as registeredBehaviors, _ as InputMap, a as SCENE_FORMAT, b as behaviorSchema, c as SceneTree, d as resolveConstants, f as Node, g as resolveOrderGroups, h as effectiveOrder, i as serializeNode, l as CONST_REF_KEY, m as ORDER_GROUP_BASE, n as loadScene, o as computeViewport, p as parseNodePath, r as Scene, s as resolveViewport, u as isConstRef, w as registerBehavior, x as behaviorSignals, y as Behavior } from "./loader-DAZlgqeC.js";
-import { A as translationKey, B as WebAudioMusicBackend, C as restoreBehaviors, D as Localization, E as BASE_LOCALE, F as spatialPan, H as fadeGain, I as SFX_PRESETS, L as SFX_PRESET_NAMES, M as isAudioContextAvailable, N as ROLLOFF_MODELS, O as T_PREFIX, P as spatialGain, R as synthSfx, S as captureBehaviors, T as LogManager, U as AudioBuses, V as crossfadeGains, _ as qualityEnvironment, a as UiSlider, b as SaveSlots, c as UiButton, d as UiBanner, f as UiBar, g as Settings, h as Engine, i as UiSelect, j as SfxEngine, k as suggestLocale, l as UiDialogue, m as AudioPlayer, n as UiImage, o as UiToggle, p as UiText, r as UiPanel, s as Timer, t as registerCoreNodes, u as HudLayer, v as readDeviceHints, w as createSaveStore, x as behaviorsWithoutSave, y as suggestQuality, z as MusicManager } from "./register-BHAwM4bK.js";
+import { C as getBehavior, E as Signal, S as clearBehaviors, T as registeredBehaviors, _ as InputMap, a as SCENE_FORMAT, b as behaviorSchema, c as SceneTree, d as resolveConstants, f as Node, g as resolveOrderGroups, h as effectiveOrder, i as serializeNode, l as CONST_REF_KEY, m as ORDER_GROUP_BASE, n as loadScene, o as computeViewport, p as parseNodePath, r as Scene, s as resolveViewport, u as isConstRef, w as registerBehavior, x as behaviorSignals, y as Behavior } from "./loader-r49nDwB4.js";
+import { A as suggestLocale, B as MusicManager, C as captureBehaviors, D as BASE_LOCALE, E as LogManager, F as spatialGain, H as crossfadeGains, I as spatialPan, L as SFX_PRESETS, M as SfxEngine, N as isAudioContextAvailable, O as Localization, P as ROLLOFF_MODELS, R as SFX_PRESET_NAMES, S as behaviorsWithoutSave, T as createSaveStore, U as fadeGain, V as WebAudioMusicBackend, W as AudioBuses, _ as qualityEnvironment, a as UiSlider, b as suggestQuality, c as UiButton, d as UiBanner, f as UiBar, g as Settings, h as Engine, i as UiSelect, j as translationKey, k as T_PREFIX, l as UiDialogue, m as AudioPlayer, n as UiImage, o as UiToggle, p as UiText, r as UiPanel, s as Timer, t as registerCoreNodes, u as HudLayer, w as restoreBehaviors, x as SaveSlots, y as readDeviceHints, z as synthSfx } from "./register-Dm7nrd-E.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as Rng } from "./rng-DP-SR7eg.js";
-import { t as auditScene } from "./audit-D7F3n3Nt.js";
+import { n as startRecording, r as auditScene, t as replay } from "./replay-DH0UOuZ-.js";
 import { n as jsonEquals, r as jsonKind, t as jsonClone } from "./json-BLk7H2Qa.js";
 import { a as getNodeSignals, c as mergeStaticSignals, i as getNodeSchema, l as registerNode, n as clearRegistry, o as getNodeType, r as createNode, u as registeredTypes } from "./registry-IyWCGe4q.js";
 import { t as createNoise2D } from "./noise-CGUMx44x.js";
 import { i as applyParticlePreset, n as PARTICLE_PRESETS, r as PARTICLE_PRESET_NAMES, t as ParticleSim } from "./particle-sim-Bw7hB93B.js";
 import { i as resolveRendering, n as attachTouchControls, r as joystickVector, t as TouchControls } from "./touch-BoNg_MnF.js";
-import { t as duplicateNode } from "./duplicate-Cvb1BSca.js";
+import { t as duplicateNode } from "./duplicate-CRtihGmC.js";
 //#region src/core/pathfinding.ts
 /**
 * A* from `from` to `to` (inclusive cell coords). Returns the cell path
@@ -155,76 +155,6 @@ function assetUrls(assets) {
 	return Object.values(assets ?? {}).map((a) => a.url).filter((u) => typeof u === "string" && !u.startsWith("data:"));
 }
 //#endregion
-//#region src/core/replay.ts
-const RECORDED_METHODS = [
-	"handleKey",
-	"handleMouseButton",
-	"handlePointerMove",
-	"handleWheel",
-	"pressAction",
-	"releaseAction"
-];
-/**
-* Tap the engine's input entry points and tick clock. Recording starts at
-* the CURRENT moment — start it before the first tick for full-run replays.
-*/
-function startRecording(engine) {
-	const ticks = [];
-	const events = [];
-	const input = engine.input;
-	const originals = /* @__PURE__ */ new Map();
-	for (const name of RECORDED_METHODS) {
-		const original = input[name];
-		originals.set(name, original);
-		input[name] = (...args) => {
-			events.push([
-				ticks.length,
-				name,
-				...args
-			]);
-			return original.apply(engine.input, args);
-		};
-	}
-	const originalTick = engine.tick.bind(engine);
-	const engineAny = engine;
-	engineAny.tick = (nowMs) => {
-		ticks.push(nowMs);
-		originalTick(nowMs);
-	};
-	let stopped = false;
-	return { stop() {
-		if (!stopped) {
-			stopped = true;
-			for (const [name, fn] of originals) input[name] = fn;
-			engineAny.tick = originalTick;
-		}
-		return {
-			replay: 1,
-			ticks,
-			events
-		};
-	} };
-}
-/**
-* Drive a fresh engine through a recording: for each recorded tick, feed
-* that tick's input events first, then tick with the recorded timestamp.
-* `onTick(index)` lets tests assert mid-run state.
-*/
-function replay(engine, recording, opts) {
-	const input = engine.input;
-	let cursor = 0;
-	for (let i = 0; i < recording.ticks.length; i++) {
-		while (cursor < recording.events.length && recording.events[cursor][0] === i) {
-			const [, method, ...args] = recording.events[cursor];
-			const fn = input[method];
-			if (typeof fn === "function") fn.apply(engine.input, args);
-			cursor += 1;
-		}
-		engine.tick(recording.ticks[i]);
-		opts?.onTick?.(i);
-	}
-}
-//#endregion
 //#region src/core/uid-gen.ts
 /**
 * The ONE way to mint a node uid: crypto-strength, `n_` + 16 base36 chars
@@ -242,6 +172,6 @@ function newUid() {
 //#endregion
 //#region src/index.ts
 /** Engine version. Kept in sync with package.json by the release pipeline. */
-const VERSION = "0.36.2";
+const VERSION = "0.38.0";
 //#endregion
 export { AudioBuses, AudioPlayer, BASE_LOCALE, Behavior, CONST_REF_KEY, Engine, HudLayer, IncantoError, InputMap, Localization, LogManager, MusicManager, Node, ORDER_GROUP_BASE, PARTICLE_PRESETS, PARTICLE_PRESET_NAMES, ParticleSim, ROLLOFF_MODELS, Rng, SCENE_FORMAT, SFX_PRESETS, SFX_PRESET_NAMES, SaveSlots, Scene, SceneTree, Settings, SfxEngine, Signal, T_PREFIX, Timer, TouchControls, UiBanner, UiBar, UiButton, UiDialogue, UiImage, UiPanel, UiSelect, UiSlider, UiText, UiToggle, VERSION, WebAudioMusicBackend, applyParticlePreset, assetUrls, attachTouchControls, auditScene, behaviorSchema, behaviorSignals, behaviorsWithoutSave, captureBehaviors, clearBehaviors, clearRegistry, computeViewport, createNode, createNoise2D, createSaveStore, crossfadeGains, duplicateNode, effectiveOrder, fadeGain, findPath, getBehavior, getNodeSchema, getNodeSignals, getNodeType, gridFromRows, isAudioContextAvailable, isConstRef, joystickVector, jsonClone, jsonEquals, jsonKind, loadScene, mergeStaticSignals, newUid, parseNodePath, preloadUrls, qualityEnvironment, readDeviceHints, registerBehavior, registerCoreNodes, registerNode, registeredBehaviors, registeredTypes, replay, resolveConstants, resolveOrderGroups, resolveRendering, resolveViewport, restoreBehaviors, serializeNode, spatialGain, spatialPan, startRecording, suggestLocale, suggestQuality, synthSfx, translationKey };

package/dist/{loader-BqigZsfF.d.ts → loader-DSMdqasu.d.ts}

@@ -1,4 +1,4 @@
-import { N as Scene, b as Engine } from "./behavior-DibCwrW7.js";
+import { N as Scene, b as Engine } from "./behavior-B5PJ32eu.js";
 import { i as SceneJson } from "./schema-CFeioQRE.js";
 
 //#region src/core/scene/loader.d.ts

package/dist/{loader-DAZlgqeC.js → loader-r49nDwB4.js}

@@ -221,6 +221,21 @@ var InputMap = class {
 	* 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() {
+		const out = [];
+		for (const [name, def] of this.actions) out.push({
+			name,
+			type: def.type
+		});
+		return out;
+	}
 	pressAction(action) {
 		this.button(action);
 		if (!this.injectedDown.has(action)) {

package/dist/net.d.ts

@@ -1,4 +1,4 @@
-import { Tt as Node, b as Engine, d as PropSchema, jt as Signal } from "./behavior-DibCwrW7.js";
+import { Tt as Node, b as Engine, d as PropSchema, jt as Signal } from "./behavior-B5PJ32eu.js";
 import { c as JsonValue, i as SceneJson, s as JsonObject } from "./schema-CFeioQRE.js";
 
 //#region src/net/types.d.ts

package/dist/net.js

@@ -1,9 +1,9 @@
-import { n as loadScene } from "./loader-DAZlgqeC.js";
-import { h as Engine } from "./register-BHAwM4bK.js";
+import { n as loadScene } from "./loader-r49nDwB4.js";
+import { h as Engine } from "./register-Dm7nrd-E.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as jsonClone } from "./json-BLk7H2Qa.js";
 import { n as createAgent8Server } from "./agent8-CvsfVskX.js";
-import { i as applySyncPatch, n as NetworkSpawner, r as NetworkManager, t as registerNodesNet } from "./register-DXwtIVqP.js";
+import { i as applySyncPatch, n as NetworkSpawner, r as NetworkManager, t as registerNodesNet } from "./register-B4RRQbyq.js";
 //#region src/net/loopback.ts
 /**
 * In-memory multiplayer hub implementing the SAME kernel contract as

package/dist/{pathfinding-B3QtdhvZ.d.ts → pathfinding-BrE5Uec6.d.ts}

@@ -1,4 +1,4 @@
-import { Tt as Node, d as PropSchema, ot as Listener } from "./behavior-DibCwrW7.js";
+import { Tt as Node, d as PropSchema, ot as Listener } from "./behavior-B5PJ32eu.js";
 
 //#region src/core/nodes/audio-player.d.ts
 /**

package/dist/{physics-2d-B4v39hca.js → physics-2d-OfKb0PV_.js}

@@ -1,7 +1,7 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { v as diagnose } from "./loader-DAZlgqeC.js";
+import { v as diagnose } from "./loader-r49nDwB4.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
-import { _ as RigidBody2D, b as validateCollider2D, g as PhysicsBody2D, h as CharacterBody2D, m as Area2D, p as Joint2D, y as Node2D } from "./register-COGCNitr.js";
+import { _ as RigidBody2D, b as validateCollider2D, g as PhysicsBody2D, h as CharacterBody2D, m as Area2D, p as Joint2D, y as Node2D } from "./register-DnB9m7Rl.js";
 import { n as registerDebugSource } from "./debug-draw-BM3DsvtT.js";
 //#region src/2d/physics/physics-2d.ts
 var physics_2d_exports = /* @__PURE__ */ __exportAll({

package/dist/{physics-3d-DFJVMYET.js → physics-3d-C8242nXr.js}

@@ -1,9 +1,9 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { v as diagnose } from "./loader-DAZlgqeC.js";
+import { v as diagnose } from "./loader-r49nDwB4.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
-import { F as PhysicsBody3D, I as RigidBody3D, N as Area3D, P as CharacterBody3D, R as Node3D, z as validateCollider3D } from "./gameplay-C0MUMSak.js";
+import { F as PhysicsBody3D, I as RigidBody3D, N as Area3D, P as CharacterBody3D, R as Node3D, z as validateCollider3D } from "./gameplay-CsJDUQh_.js";
 import { n as registerDebugSource } from "./debug-draw-BM3DsvtT.js";
-import { A as Terrain3D, F as InstancedMesh3D, L as buildMeshGeometry, P as Joint3D } from "./environment-presets-fK9oyrrR.js";
+import { A as Terrain3D, F as InstancedMesh3D, L as buildMeshGeometry, P as Joint3D } from "./environment-presets-C0Axpfth.js";
 import { Euler, Matrix4, Quaternion, Vector3 } from "three";
 //#region src/3d/physics/collider-lines.ts
 /**

package/dist/react.d.ts

@@ -1,4 +1,4 @@
-import { N as Scene, b as Engine, n as BehaviorCtor } from "./behavior-DibCwrW7.js";
+import { N as Scene, b as Engine, n as BehaviorCtor } from "./behavior-B5PJ32eu.js";
 import { c as JsonValue } from "./schema-CFeioQRE.js";
 import { CSSProperties, ReactNode } from "react";
 

package/dist/react.js

@@ -156,7 +156,7 @@ function IncantoCanvas(props) {
 				pointer: latest.pointer,
 				...keyboard !== void 0 ? { keyboard } : {}
 			};
-			const next = await (_gameFactory ?? (mode === "3d" ? async (o) => (await import("./create-game-DnOu2aAa.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-D-StzrTj.js").then((n) => n.n)).createGame2D(o)))(opts);
+			const next = await (_gameFactory ?? (mode === "3d" ? async (o) => (await import("./create-game-DqY2lMBc.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-C4t5gVhc.js").then((n) => n.n)).createGame2D(o)))(opts);
 			if (disposed) {
 				next.dispose();
 				return;

package/dist/{register-DXwtIVqP.js → register-B4RRQbyq.js}

@@ -1,5 +1,5 @@
-import { E as Signal, f as Node, t as buildNodeJson } from "./loader-DAZlgqeC.js";
-import { t as registerCoreNodes } from "./register-BHAwM4bK.js";
+import { E as Signal, f as Node, t as buildNodeJson } from "./loader-r49nDwB4.js";
+import { t as registerCoreNodes } from "./register-Dm7nrd-E.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { n as jsonEquals, t as jsonClone } from "./json-BLk7H2Qa.js";
 import { l as registerNode } from "./registry-IyWCGe4q.js";