incanto 0.36.1 → 0.37.0

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-5o1EkbLD.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-iGq2PT_k.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-pPrqtlWS.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-DGzhZWrM.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 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-DOWGnxe1.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-BuOTl5rM.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.1";
+const VERSION = "0.37.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-iGq2PT_k.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-5o1EkbLD.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-5o1EkbLD.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-DOWGnxe1.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-t15rydSm.js";
 //#region src/net/loopback.ts
 /**
 * In-memory multiplayer hub implementing the SAME kernel contract as

package/dist/{pathfinding-B3QtdhvZ.d.ts → pathfinding-pPrqtlWS.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-5o1EkbLD.js";
 
 //#region src/core/nodes/audio-player.d.ts
 /**

package/dist/{physics-2d-B4v39hca.js → physics-2d-C8Hi40qb.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-DFSW2Y30.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-C0mWoWXC.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-DWHxLHM5.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-5o1EkbLD.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-QqrrK3yr.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-DmGc-Mrn.js").then((n) => n.n)).createGame2D(o)))(opts);
 			if (disposed) {
 				next.dispose();
 				return;

package/dist/{register-COGCNitr.js → register-DFSW2Y30.js}

@@ -1,5 +1,5 @@
-import { f as Node, h as effectiveOrder } from "./loader-DAZlgqeC.js";
-import { t as registerCoreNodes } from "./register-BHAwM4bK.js";
+import { f as Node, h as effectiveOrder } from "./loader-r49nDwB4.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";

package/dist/{register-BHAwM4bK.js → register-DOWGnxe1.js}

@@ -1,4 +1,4 @@
-import { E as Signal, _ as InputMap, b as behaviorSchema, f as Node, g as resolveOrderGroups, m as ORDER_GROUP_BASE, v as diagnose } from "./loader-DAZlgqeC.js";
+import { E as Signal, _ as InputMap, b as behaviorSchema, f as Node, g as resolveOrderGroups, m as ORDER_GROUP_BASE, v as diagnose } from "./loader-r49nDwB4.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as Rng } from "./rng-DP-SR7eg.js";
 import { l as registerNode } from "./registry-IyWCGe4q.js";

package/dist/{register-DXwtIVqP.js → register-t15rydSm.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-DOWGnxe1.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";

package/dist/{audit-D7F3n3Nt.js → replay-BuOTl5rM.js}

@@ -1,4 +1,4 @@
-import { A as translationKey } from "./register-BHAwM4bK.js";
+import { A as translationKey } from "./register-DOWGnxe1.js";
 //#region src/core/audit.ts
 const ANIMATED_TYPES = new Set([
 	"Particles2D",
@@ -108,4 +108,74 @@ function auditStrings(scene) {
 	return [`${listed.length} translation key${listed.length === 1 ? "" : "s"} nothing declares: ${listed.join(", ")}. The key itself renders on screen. Add them under "strings": { "en": { ... } } — other locales may omit any of them and fall back to English.`];
 }
 //#endregion
-export { auditScene as t };
+//#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
+export { startRecording as n, auditScene as r, replay as t };

package/dist/replay-DGzhZWrM.d.ts

@@ -0,0 +1,86 @@
+import { b as Engine } from "./behavior-5o1EkbLD.js";
+import { s as JsonObject } from "./schema-CFeioQRE.js";
+
+//#region src/core/audit.d.ts
+/** Human-readable warnings (empty = clean). Pure JSON walk, no registry. */
+declare function auditScene(scene: JsonObject): string[];
+//#endregion
+//#region src/core/errors.d.ts
+/**
+* Stable error codes for every hard failure in the engine.
+*
+* Incanto fails loudly with machine-readable codes and messages that list valid
+* alternatives — AI agents self-correct on hard failures, not warnings.
+*/
+type IncantoErrorCode = "BAD_FORMAT" | "BAD_NODE_PATH" | "DANGLING_CONNECTION" | "DUPLICATE_BEHAVIOR" | "DUPLICATE_NODE_TYPE" | "DUPLICATE_UNIQUE_NAME" | "DUPLICATE_UID" | "NODE_NOT_FOUND" | "PROP_TYPE_MISMATCH" | "TREE_VIOLATION" | "UNKNOWN_ANIMATION" | "UNKNOWN_ASSET" | "UNKNOWN_CONSTANT" | "UNKNOWN_BEHAVIOR" | "UNKNOWN_HANDLER" | "UNKNOWN_NODE_TYPE" | "UNKNOWN_PROP" | "UNKNOWN_SIGNAL" | "UNRESOLVED_INSTANCE";
+/**
+* Structured context mirrored from the prose message — tools and agents parse
+* THESE instead of regexing the message (which is for humans and may reword).
+*/
+interface IncantoErrorDetails {
+  /** Absolute path of the offending node in the scene being loaded ('/Root/Child'). */
+  readonly path?: string;
+  /** The offending node's uid, when the scene JSON declared one. */
+  readonly uid?: string;
+  /** The offending node's type name. */
+  readonly nodeType?: string;
+  /** The offending prop key. */
+  readonly prop?: string;
+  /** The offending signal name. */
+  readonly signal?: string;
+  /** The valid alternatives the message also lists — for programmatic self-correction. */
+  readonly validOptions?: readonly string[];
+}
+declare class IncantoError extends Error {
+  readonly code: IncantoErrorCode;
+  readonly details: IncantoErrorDetails;
+  constructor(code: IncantoErrorCode, message: string, details?: IncantoErrorDetails);
+}
+//#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
+export { startRecording as a, IncantoErrorDetails as c, replay as i, auditScene as l, ReplayEvent as n, IncantoError as o, ReplayJson as r, IncantoErrorCode as s, Recorder as t };