incanto 0.49.0 → 0.51.0

package/bin/incanto-play.mjs

@@ -62,8 +62,11 @@ wheel/capture/describe/framing/logs/quit), JSON-line responses on stdout.`);
 }
 
 const out = (obj) => process.stdout.write(`${JSON.stringify(obj)}\n`);
-const fail = (cmd, e) =>
+let failures = 0;
+const fail = (cmd, e) => {
+  failures += 1;
   out({ ok: false, cmd, error: { code: e?.code ?? 'ERROR', message: e?.message ?? String(e) } });
+};
 
 const { createPlaySession } = await import(pathToFileURL(join(PKG, 'dist', 'test.js')).href);
 const incanto = await import(pathToFileURL(join(PKG, 'dist', 'index.js')).href);
@@ -204,21 +207,43 @@ function handle(line) {
 }
 
 if (args.commands) {
-  for (const line of readFileSync(resolve(args.commands), 'utf-8').split('\n')) {
-    if (!handle(line)) process.exit(0);
+  const text = readFileSync(resolve(args.commands), 'utf-8');
+  // A REPLAY, not a command script. `incanto-playtest` writes its failing runs
+  // as ReplayJson and the docs point this flag at them; reading one as text
+  // rejected every line as UNKNOWN_COMMAND and still exited 0, so the tool's
+  // whole payoff — "the failure comes back as a file you can watch" — silently
+  // did nothing.
+  const recording = text.trimStart().startsWith('{') ? JSON.parse(text) : null;
+  if (recording?.replay) {
+    incanto.replay(session.engine, recording);
+    out({
+      ok: true,
+      cmd: 'replay',
+      frames: recording.ticks.length,
+      events: recording.events.length,
+    });
+    out({ ok: true, cmd: 'describe', text: session.describe() });
+    session.dispose();
+    process.exitCode = 0;
+  } else {
+    for (const line of text.split('\n')) {
+      if (!handle(line)) break;
+    }
+    session.dispose();
+    // A script whose every line was rejected must not report success: that is
+    // exactly how a replay pointed at the wrong reader stayed invisible.
+    process.exitCode = failures > 0 ? 1 : 0;
   }
-  session.dispose();
-  process.exit(0);
-}
-
-const rl = createInterface({ input: process.stdin });
-rl.on('line', (line) => {
-  if (!handle(line)) {
-    rl.close();
+} else {
+  const rl = createInterface({ input: process.stdin });
+  rl.on('line', (line) => {
+    if (!handle(line)) {
+      rl.close();
+      process.exit(0);
+    }
+  });
+  rl.on('close', () => {
+    session.dispose();
     process.exit(0);
-  }
-});
-rl.on('close', () => {
-  session.dispose();
-  process.exit(0);
-});
+  });
+}

package/dist/2d.d.ts

@@ -1,7 +1,7 @@
-import { Et as Node, P as Scene$1, S as Scheduler, T as RendererStats, b as Engine, d as PropSchema, n as BehaviorCtor, w as GameStats } from "./behavior-62q0HWBO.js";
+import { Dt as Node, P as Scene$1, S as Scheduler, T as RendererStats, b as Engine, d as PropSchema, n as BehaviorCtor, w as GameStats } from "./behavior-rZNfzVbH.js";
 import { n as DiagnosticSink, t as EditorSwitchOptions } from "./editor-switch-DAvWQeld.js";
 import { i as SceneJson, s as JsonObject } from "./schema-CFeioQRE.js";
-import { t as LoadSceneOptions } from "./loader-CeyU_bm1.js";
+import { t as LoadSceneOptions } from "./loader-Dkbn56KC.js";
 import { n as AnimationEntry } from "./sprite-animation-CMr6f1K2.js";
 import { t as ParticleSim } from "./particle-sim-BzJ1yxoE.js";
 import { Group, Mesh, Object3D, Scene, Texture } from "three";
@@ -206,6 +206,7 @@ declare class Physics2D {
   private readonly world;
   private readonly events;
   private readonly kcc;
+  private readonly disconnectScene;
   private readonly disconnect;
   private lastDt;
   private readonly optsGravity;

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-BgV6UbVA.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-BNPZYJmd.js";
-import { n as enablePhysics2D, t as Physics2D } from "./physics-2d-vyCBfACH.js";
+import { a as AssetStore2D, i as syncTree2D, r as Renderer2D, t as createGame2D } from "./create-game-CkzKZ4v5.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-B_BaaGx-.js";
+import { n as enablePhysics2D, t as Physics2D } from "./physics-2d-Ccq2L9R0.js";
 //#region src/2d/library-sprite.ts
 /**
 * What a `CharacterController2D`/`3D` will ask a skin to play, and the clip in

package/dist/3d.d.ts

@@ -1,10 +1,10 @@
-import { D as QualityCaps, Et as Node, P as Scene$1, S as Scheduler, T as RendererStats, b as Engine, d as PropSchema, n as BehaviorCtor, w as GameStats } from "./behavior-62q0HWBO.js";
+import { D as QualityCaps, Dt as Node, P as Scene$1, S as Scheduler, T as RendererStats, b as Engine, d as PropSchema, n as BehaviorCtor, w as GameStats } from "./behavior-rZNfzVbH.js";
 import { n as DiagnosticSink, t as EditorSwitchOptions } from "./editor-switch-DAvWQeld.js";
 import { i as SceneJson$1, s as JsonObject } from "./schema-CFeioQRE.js";
-import { t as LoadSceneOptions } from "./loader-CeyU_bm1.js";
+import { t as LoadSceneOptions } from "./loader-Dkbn56KC.js";
 import { t as ParticleSim } from "./particle-sim-BzJ1yxoE.js";
 import { a as GridCell, c as diffText, d as frameText, i as FrameStatsOptions, l as frameSignature, n as FrameSignature, o as SIGNATURE_GRID, r as FrameStats, s as diffSignatures, t as FrameDiff, u as frameStats } from "./frame-report-DZ70IY26.js";
-import { n as PathGrid, s as SpatialPose } from "./pathfinding-C49JSNNq.js";
+import { n as PathGrid, s as SpatialPose } from "./pathfinding-Bz34pvQD.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";
@@ -439,6 +439,7 @@ declare class Physics3D {
   private readonly world;
   private readonly events;
   private readonly kcc;
+  private readonly disconnectScene;
   private readonly disconnect;
   private lastDt;
   private readonly optsGravity;

package/dist/3d.js

@@ -1,9 +1,9 @@
-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-02Btmmjn.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-CZOH5TY5.js";
-import { a as Environment3D, c as parseEnvironment3D, d as AssetStore3D, i as syncTree, l as sunDirectionFromElevationAzimuth, o as setEnvironment3D, r as Renderer3D, s as horizonColorFromSky, t as createGame3D, u as sunDirectionFromSky } from "./create-game-DFBjMetZ.js";
+import { F as CharacterBody3D, H as WATER_MAX_RIPPLES, I as PhysicsBody3D, L as RigidBody3D, M as WATER_CUTOUT_MAX, N as WaterCutout3D, P as Area3D, R as StaticBody3D, j as Water3D, z as Node3D } from "./gameplay-bStgtZBV.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-C08pOC6H.js";
+import { a as Environment3D, c as parseEnvironment3D, d as AssetStore3D, i as syncTree, l as sunDirectionFromElevationAzimuth, o as setEnvironment3D, r as Renderer3D, s as horizonColorFromSky, t as createGame3D, u as sunDirectionFromSky } from "./create-game-BNaOC3Px.js";
 import { a as frameSignature, n as diffSignatures, o as frameStats, r as diffText, s as frameText, t as SIGNATURE_GRID } from "./frame-report-njybhZon.js";
 import { n as splatWeights, t as buildHeightmap } from "./heightmap-CRK0M4jT.js";
-import { n as enablePhysics3D, t as Physics3D } from "./physics-3d-DpRqw8Mz.js";
+import { n as enablePhysics3D, t as Physics3D } from "./physics-3d-B2c5KNYh.js";
 //#region src/3d/model-verdict.ts
 /** Mixamo exports every bone as `mixamorigX`; the retargeter binds by that name. */
 const MIXAMO = /^mixamorig[:_]?/i;

package/dist/{behavior-62q0HWBO.d.ts → behavior-rZNfzVbH.d.ts}

@@ -151,6 +151,14 @@ declare class SceneTree {
   _queueFree(node: Node): void;
   /** @internal Called by Node.free(): a freed root must not be re-drivable. */
   _detachRoot(node: Node): void;
+  /**
+  * @internal Is this node already on its way out?
+  *
+  * A save taken from a `collected` handler runs BEFORE the deferred free, so
+  * the pickup that triggered the checkpoint is still in the tree — and came
+  * back on the next run while its score did not.
+  */
+  _isQueuedFree(node: Node): boolean;
   private flushFreeQueue;
 }
 //#endregion
@@ -968,6 +976,18 @@ interface RestoreReport {
   skipped: string[];
   /** How many behaviors actually took their state back. */
   restored: number;
+  /**
+  * How much state this tree HAD to give back — every behavior in it with a
+  * `serialize`, addressable or not.
+  *
+  * `restored: 0` is ambiguous on its own and the ambiguity is expensive: a
+  * hand-written scene with no uids saves `{}`, and the documented check
+  * (`if (report.missing.length)`) passes on it while the whole run is gone.
+  * `restored: 0, expected: 2` cannot be read as success.
+  */
+  expected: number;
+  /** Authored nodes the save says the run consumed, and that were freed again. */
+  freed: number;
 }
 /**
 * Every behavior in the tree that has something to say, by uid.
@@ -980,9 +1000,10 @@ interface RestoreReport {
 * cannot be given back. The editor assigns a uid to every node it touches; a
 * hand-written scene may not have.
 */
-declare function captureBehaviors(root: Node): {
+declare function captureBehaviors(root: Node, source?: JsonValue): {
   state: BehaviorState; /** Paths of nodes that had state to save and no uid to save it under. */
-  unaddressable: string[];
+  unaddressable: string[]; /** Behaviors in this tree that have something to save — addressable or not. */
+  saveable: number;
 };
 /**
 * Hand each behavior its state back.
@@ -1032,6 +1053,19 @@ declare class SaveSlots {
 * and the caller decides.
 */
 declare function behaviorsWithoutSave(root: Node): string[];
+/**
+* Behaviors that DO save, on nodes with no uid to save them under — the state
+* that goes nowhere.
+*
+* `incanto-check` warns about the built-ins it can recognise from the JSON
+* (Health, ScoreKeeper, Collector), but a scene file cannot be asked whether
+* YOUR behavior has a `serialize`. This can: it walks the live tree, so a quest
+* log or a wallet of your own is named too.
+*
+* The pair to read before shipping: `behaviorsWithoutSave` is "did you forget
+* to write serialize", this is "did you forget the uid that makes it count".
+*/
+declare function savesWithoutUid(root: Node): string[];
 //#endregion
 //#region src/core/scene/scene.d.ts
 /**
@@ -1682,4 +1716,4 @@ declare function registeredBehaviors(): string[];
 /** Test isolation helper. */
 declare function clearBehaviors(): void;
 //#endregion
-export { suggestLocale as $, SettingsValues as A, LogLevel as At, captureBehaviors as B, EngineStats as C, PlayMusicOptions as Ct, QualityCaps as D, NodeLifecycle as Dt, DeviceHints as E, Node as Et, BehaviorState as F, OrderGroup as G, SaveStore as H, RestoreReport as I, resolveOrderGroups as J, OrderGroupTable as K, SaveSlot as L, readDeviceHints as M, Signal as Mt, suggestQuality as N, SignalListener as Nt, QualityTier as O, SceneTree as Ot, Scene as P, T_PREFIX as Q, SaveSlots as R, Scheduler as S, MusicTrack as St, RendererStats as T, BusName as Tt, createSaveStore as U, restoreBehaviors as V, ORDER_GROUP_BASE as W, LocaleTables as X, BASE_LOCALE as Y, Localization as Z, mergeStaticSignals as _, SfxWave as _t, clearBehaviors as a, Voice as at, Engine as b, MusicBackend as bt, registeredBehaviors as c, ROLLOFF_MODELS as ct, PropSchema as d, Vec3 as dt, translationKey as et, clearRegistry as f, spatialGain as ft, getNodeType as g, SfxParams as gt, getNodeSignals as h, SFX_PRESET_NAMES as ht, behaviorSignals as i, isAudioContextAvailable as it, qualityEnvironment as j, LogManager as jt, Settings as k, LogEntry as kt, NodeCtor as l, RolloffModel as lt, getNodeSchema as m, SFX_PRESETS as mt, BehaviorCtor as n, SfxEngine as nt, getBehavior as o, VoicePreset as ot, createNode as p, spatialPan as pt, effectiveOrder as q, behaviorSchema as r, SfxPlayOptions as rt, registerBehavior as s, Listener as st, Behavior as t, InputMap as tt, PropDef as u, SpatialParams as ut, registerNode as v, SynthOptions as vt, GameStats as w, AudioBuses as wt, EngineOptions as x, MusicManager as xt, registeredTypes as y, synthSfx as yt, behaviorsWithoutSave as z };
+export { T_PREFIX as $, SettingsValues as A, LogEntry as At, captureBehaviors as B, EngineStats as C, MusicTrack as Ct, QualityCaps as D, Node as Dt, DeviceHints as E, BusName as Et, BehaviorState as F, ORDER_GROUP_BASE as G, savesWithoutUid as H, RestoreReport as I, effectiveOrder as J, OrderGroup as K, SaveSlot as L, readDeviceHints as M, LogManager as Mt, suggestQuality as N, Signal as Nt, QualityTier as O, NodeLifecycle as Ot, Scene as P, SignalListener as Pt, Localization as Q, SaveSlots as R, Scheduler as S, MusicManager as St, RendererStats as T, AudioBuses as Tt, SaveStore as U, restoreBehaviors as V, createSaveStore as W, BASE_LOCALE as X, resolveOrderGroups as Y, LocaleTables as Z, mergeStaticSignals as _, SfxParams as _t, clearBehaviors as a, isAudioContextAvailable as at, Engine as b, synthSfx as bt, registeredBehaviors as c, Listener as ct, PropSchema as d, SpatialParams as dt, suggestLocale as et, clearRegistry as f, Vec3 as ft, getNodeType as g, SFX_PRESET_NAMES as gt, getNodeSignals as h, SFX_PRESETS as ht, behaviorSignals as i, SfxPlayOptions as it, qualityEnvironment as j, LogLevel as jt, Settings as k, SceneTree as kt, NodeCtor as l, ROLLOFF_MODELS as lt, getNodeSchema as m, spatialPan as mt, BehaviorCtor as n, InputMap as nt, getBehavior as o, Voice as ot, createNode as p, spatialGain as pt, OrderGroupTable as q, behaviorSchema as r, SfxEngine as rt, registerBehavior as s, VoicePreset as st, Behavior as t, translationKey as tt, PropDef as u, RolloffModel as ut, registerNode as v, SfxWave as vt, GameStats as w, PlayMusicOptions as wt, EngineOptions as x, MusicBackend as xt, registeredTypes as y, SynthOptions as yt, behaviorsWithoutSave as z };

package/dist/{create-game-DFBjMetZ.js → create-game-BNaOC3Px.js}

@@ -1,15 +1,15 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { n as loadScene, v as diagnose, w as registerBehavior } from "./loader-DwazzlQb.js";
-import { _ as qualityCaps, h as Engine, m as AudioPlayer, y as qualityRendering } from "./register-uvaZj1KX.js";
+import { A as registerBehavior, n as loadScene, w as diagnose } from "./loader-B2asghWa.js";
+import { _ as qualityCaps, h as Engine, m as AudioPlayer, y as qualityRendering } from "./register-CGq-Hee8.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { r as parseDrive, t as logReport } from "./log-report-lxrQY9cH.js";
 import { i as resolveRendering, n as attachTouchControls } from "./touch-BoNg_MnF.js";
 import { a as openBundledEditor, i as devServerLibrary, n as pauseWhenHidden, o as poseFromRenderer, r as crossFade, t as teardown } from "./teardown-BKTCzLek.js";
-import { B as createCausticsQuad, F as PhysicsBody3D, R as Node3D, n as registerGameplayBehaviors } from "./gameplay-02Btmmjn.js";
+import { I as PhysicsBody3D, V as createCausticsQuad, n as registerGameplayBehaviors, z as Node3D } from "./gameplay-bStgtZBV.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-CZOH5TY5.js";
+import { E as Camera3D, U as TextureCache3D, g as ModelInstance3D, n as registerNodes3D, t as resolveEnvironmentHdri, v as DirectionalLight3D } from "./environment-presets-C08pOC6H.js";
 import { a as frameSignature, i as frameImage, o as frameStats } from "./frame-report-njybhZon.js";
-import { n as enablePhysics3D } from "./physics-3d-DpRqw8Mz.js";
+import { n as enablePhysics3D } from "./physics-3d-B2c5KNYh.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/{create-game-BgV6UbVA.js → create-game-CkzKZ4v5.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-DwazzlQb.js";
-import { h as Engine, m as AudioPlayer } from "./register-uvaZj1KX.js";
+import { A as registerBehavior, n as loadScene, o as computeViewport, s as resolveViewport, w as diagnose } from "./loader-B2asghWa.js";
+import { h as Engine, m as AudioPlayer } from "./register-CGq-Hee8.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { i as resolveRendering, n as attachTouchControls } from "./touch-BoNg_MnF.js";
 import { a as openBundledEditor, i as devServerLibrary, n as pauseWhenHidden, r as crossFade, t as teardown } from "./teardown-BKTCzLek.js";
-import { n as registerGameplayBehaviors } from "./gameplay-02Btmmjn.js";
-import { g as PhysicsBody2D, n as UILayer, t as registerNodes2D, u as Camera2D, y as Node2D } from "./register-BNPZYJmd.js";
+import { n as registerGameplayBehaviors } from "./gameplay-bStgtZBV.js";
+import { g as PhysicsBody2D, n as UILayer, t as registerNodes2D, u as Camera2D, y as Node2D } from "./register-B_BaaGx-.js";
 import { t as debugSources } from "./debug-draw-BM3DsvtT.js";
-import { n as enablePhysics2D } from "./physics-2d-vyCBfACH.js";
+import { n as enablePhysics2D } from "./physics-2d-Ccq2L9R0.js";
 import { Box3, BufferAttribute, BufferGeometry, Color, LineBasicMaterial, LineSegments, LinearFilter, NearestFilter, OrthographicCamera, Raycaster, SRGBColorSpace, Scene, TextureLoader, Vector2, Vector3, WebGLRenderer } from "three";
 //#region src/2d/assets.ts
 /**

package/dist/debug.d.ts

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

package/dist/{duplicate-CI9WF_bg.js → duplicate-EybyYeyL.js}

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

package/dist/{environment-presets-CZOH5TY5.js → environment-presets-C08pOC6H.js}

@@ -1,10 +1,10 @@
-import { t as registerCoreNodes } from "./register-uvaZj1KX.js";
+import { t as registerCoreNodes } from "./register-CGq-Hee8.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 ParticleSim, n as resolveFrames, o as PARTICLE_PRESET_NAMES, r as validateAnimationAliases, s as applyParticlePreset, t as resolveAnimation } from "./sprite-animation-D_p28jwU.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-02Btmmjn.js";
+import { F as CharacterBody3D, I as PhysicsBody3D, L as RigidBody3D, N as WaterCutout3D, P as Area3D, R as StaticBody3D, U as colliderFootDrop, j as Water3D, z as Node3D } from "./gameplay-bStgtZBV.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";

package/dist/{gameplay-02Btmmjn.js → gameplay-bStgtZBV.js}

@@ -1,7 +1,7 @@
-import { f as Node, h as effectiveOrder, n as loadScene, w as registerBehavior, y as Behavior } from "./loader-DwazzlQb.js";
+import { A as registerBehavior, T as Behavior, f as Node, m as SaveSlots, n as loadScene, x as effectiveOrder } from "./loader-B2asghWa.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as jsonClone } from "./json-BLk7H2Qa.js";
-import { t as duplicateNode } from "./duplicate-CI9WF_bg.js";
+import { t as duplicateNode } from "./duplicate-EybyYeyL.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();
@@ -4252,6 +4252,20 @@ function firstWater(node) {
 	return null;
 }
 //#endregion
+//#region src/gameplay/move-body.ts
+function moveBody(node, to, dt) {
+	const body = node;
+	if (typeof body.moveAndSlide !== "function" || body._physics == null || dt <= 0) {
+		node.position = [...to];
+		return;
+	}
+	const from = body.position;
+	const v = [];
+	for (let i = 0; i < from.length; i++) v.push(((to[i] ?? from[i] ?? 0) - (from[i] ?? 0)) / dt);
+	body.velocity = v;
+	body.moveAndSlide();
+}
+//#endregion
 //#region src/gameplay/spatial.ts
 /** Duck-type test: every spatial node (Node2D/Node3D) exposes `position: number[]`. */
 function hasPosition$1(node) {
@@ -4414,7 +4428,7 @@ var Chase = class extends Behavior {
 		this.inRange = false;
 		const step = Math.min(this.speed * dt, this.stopRange > 0 ? d - this.stopRange : d);
 		const { position } = moveToward(mover.position, target.position, Math.max(0, step));
-		mover.position = position;
+		moveBody(mover, position, dt);
 	}
 };
 //#endregion
@@ -5675,7 +5689,7 @@ var Patrol = class extends Behavior {
 		const target = this.pointAt(this.index);
 		if (!target) return;
 		const { position, reached } = moveToward(node.position, target, this.speed * dt);
-		node.position = position;
+		moveBody(node, position, dt);
 		if (reached) {
 			this.emit("reachedPoint", this.index);
 			this.advance();
@@ -5740,8 +5754,8 @@ var Pickup = class extends Behavior {
 		const collector = findCollector(other, this.collectorGroup);
 		if (!collector) return;
 		this.collectedAlready = true;
-		this.emit("collected", this.value, collector);
 		this.node.queueFree();
+		this.emit("collected", this.value, collector);
 	}
 };
 /**
@@ -5842,6 +5856,160 @@ var Projectile = class extends Behavior {
 	}
 };
 //#endregion
+//#region src/gameplay/save-point.ts
+/**
+* The save, as something the scene can point a signal at.
+*
+* Every other common wiring in this engine became declarative — score to
+* screen, damage to health bar, waves, win and lose — and saving stayed the one
+* thing that needed TypeScript. The skill's own autosave example is a
+* connection to `Game.onCheckpoint`, a method the author has to go and write.
+*
+* "*When* to save is a design decision and only your game knows" is right, and
+* it is untouched here: the SCENE still says when, by choosing which signal to
+* wire — a level exit's `triggerEnter`, `won`, a key. What it gets is something
+* to wire TO.
+*
+* ```json
+* { "name": "Save", "type": "Node", "uid": "n_…",
+*   "script": { "name": "SavePoint", "props": { "game": "vault", "slot": "1" } } }
+* ```
+* ```json
+* { "signal": "triggerEnter", "from": "Level/Exit", "to": "Save", "handler": "save" }
+* ```
+*/
+var SavePoint = class extends Behavior {
+	static props = {
+		/** Namespace for this game's slots — keeps two games on one origin apart. */
+		game: { default: "game" },
+		/** Which slot this node writes and reads. */
+		slot: { default: "1" },
+		/** Shown in a load menu. */
+		label: { default: "" },
+		/**
+		* The scene key a load should route back to. Empty = this scene's `name`.
+		* The engine does not route scenes; it records what your loader will need.
+		*/
+		scene: { default: "" },
+		/** Read the slot back as soon as the scene is ready — a "Continue" boot. */
+		restoreOnReady: { default: false },
+		/**
+		* Ask, without loading: on the first frame, emit `hasSave(label, playtime)`
+		* or `noSave`. A title screen needs this and nothing else — the scene can
+		* then wire `noSave → Continue.hide` and `hasSave → SlotInfo.setText`.
+		*/
+		probeOnReady: { default: false }
+	};
+	static signals = [
+		"saved",
+		"restored",
+		"noSave",
+		"hasSave"
+	];
+	game = "game";
+	slot = "1";
+	label = "";
+	scene = "";
+	restoreOnReady = false;
+	probeOnReady = false;
+	/** Seconds this run has been playing — written into the slot as `playtime`. */
+	elapsed = 0;
+	slots = null;
+	store() {
+		this.slots ??= new SaveSlots(this.game);
+		return this.slots;
+	}
+	pendingRestore = false;
+	pendingProbe = false;
+	onReady() {
+		this.pendingRestore = this.restoreOnReady;
+		this.pendingProbe = this.probeOnReady;
+	}
+	update(dt) {
+		if (this.pendingProbe) {
+			this.pendingProbe = false;
+			this.probe();
+		}
+		if (this.pendingRestore) {
+			this.pendingRestore = false;
+			this.restore();
+		}
+		this.elapsed += dt;
+	}
+	/**
+	* Is there anything to continue? Emits `hasSave(label, playtime, scene)` or
+	* `noSave`, and touches nothing.
+	*
+	* The label leads because that is what a menu shows; an unlabelled slot
+	* falls back to its scene key, so `hasSave → SlotInfo.setText` always says
+	* something rather than nothing.
+	*/
+	probe() {
+		const slot = this.store().read(this.slot);
+		if (!slot) {
+			this.emit("noSave");
+			return;
+		}
+		this.emit("hasSave", slot.label || slot.scene, slot.playtime, slot.scene);
+	}
+	/** Seconds this run has been playing, including time carried over a continue. */
+	get playtime() {
+		return Math.round(this.elapsed);
+	}
+	/**
+	* The scene key this slot was saved from — what a loader needs to route.
+	* Null when the slot is empty.
+	*/
+	slotScene() {
+		return this.store().read(this.slot)?.scene ?? null;
+	}
+	/**
+	* Write the run to its slot. Emits `saved(slotId)`.
+	*
+	* Wire it to whatever marks the moment. Extra signal arguments are ignored,
+	* so `triggerEnter → save` works as-is.
+	*/
+	save() {
+		const engine = this.engine;
+		this.store().write(this.slot, {
+			scene: this.scene || (engine.scene?.source.name ?? ""),
+			state: engine.captureState(),
+			label: this.label,
+			savedAt: Date.now(),
+			playtime: Math.round(this.elapsed)
+		});
+		this.emit("saved", this.slot);
+	}
+	/**
+	* Give this scene the slot's state back. Emits `restored(count)`, or
+	* `noSave` when the slot is empty — which is what greys out a Continue button.
+	*
+	* Restoring does NOT route: if the slot names another scene, that is your
+	* loader's business, and `slot.scene` is the key it needs.
+	*/
+	restore() {
+		const slot = this.store().read(this.slot);
+		if (!slot) {
+			this.emit("noSave");
+			return;
+		}
+		const report = this.engine.restoreState(slot.state);
+		this.emit("restored", report.restored);
+	}
+	/** Forget this slot — a "delete save" button. */
+	clear() {
+		this.store().remove(this.slot);
+	}
+	/** The run's own clock survives a save/continue cycle. */
+	serialize() {
+		return { playtime: Math.round(this.elapsed) };
+	}
+	deserialize(data) {
+		const d = data;
+		if (typeof d.playtime === "number" && d.playtime >= 0) this.elapsed = d.playtime;
+	}
+};
+//#endregion
 //#region src/gameplay/score-keeper.ts
 /**
 * The game's state hub — score, lives, and win/lose detection. Put it on the
@@ -6446,6 +6614,7 @@ const GAMEPLAY_BEHAVIORS = {
 	DamageOnContact,
 	Interactable,
 	Clickable,
+	SavePoint,
 	FollowCamera,
 	Patrol,
 	Chase,
@@ -6468,4 +6637,4 @@ function registerGameplayBehaviors(opts) {
 	for (const [name, ctor] of Object.entries(GAMEPLAY_BEHAVIORS)) registerBehavior(name, ctor, { replace });
 }
 //#endregion
-export { Water3D as A, createCausticsQuad as B, FollowCamera as C, Health as D, DamageOnContact as E, PhysicsBody3D as F, colliderFootDrop as H, RigidBody3D as I, StaticBody3D as L, WaterCutout3D as M, Area3D as N, Collector as O, CharacterBody3D as P, Node3D as R, restartScene as S, phaseOf as T, WATER_MAX_RIPPLES as V, hitStop as _, Wander as a, GameFlow as b, Projectile as c, PathFollow as d, Oscillate as f, Cooldown as g, CameraShake as h, WaveSpawner as i, WATER_CUTOUT_MAX as j, Chase as k, Pickup as l, Lifetime as m, registerGameplayBehaviors as n, Spawner as o, MoveTo as p, ZombieAI as r, ScoreKeeper as s, GAMEPLAY_BEHAVIORS as t, Patrol as u, screenFlash as v, DayNight as w, goToScene as x, Interactable as y, validateCollider3D as z };
+export { Chase as A, validateCollider3D as B, restartScene as C, DamageOnContact as D, phaseOf as E, CharacterBody3D as F, WATER_MAX_RIPPLES as H, PhysicsBody3D as I, RigidBody3D as L, WATER_CUTOUT_MAX as M, WaterCutout3D as N, Health as O, Area3D as P, StaticBody3D as R, goToScene as S, DayNight as T, colliderFootDrop as U, createCausticsQuad as V, Cooldown as _, Wander as a, Interactable as b, SavePoint as c, Patrol as d, PathFollow as f, CameraShake as g, Lifetime as h, WaveSpawner as i, Water3D as j, Collector as k, Projectile as l, MoveTo as m, registerGameplayBehaviors as n, Spawner as o, Oscillate as p, ZombieAI as r, ScoreKeeper as s, GAMEPLAY_BEHAVIORS as t, Pickup as u, hitStop as v, FollowCamera as w, GameFlow as x, screenFlash as y, Node3D as z };

package/dist/gameplay.d.ts

@@ -1,4 +1,4 @@
-import { Et as Node, b as Engine, d as PropSchema, n as BehaviorCtor, t as Behavior } from "./behavior-62q0HWBO.js";
+import { Dt as Node, b as Engine, d as PropSchema, n as BehaviorCtor, t as Behavior } from "./behavior-rZNfzVbH.js";
 import { c as JsonValue, s as JsonObject } from "./schema-CFeioQRE.js";
 
 //#region src/gameplay/chase.d.ts
@@ -375,6 +375,83 @@ declare class Projectile extends Behavior {
   private forwardFromRotation;
 }
 //#endregion
+//#region src/gameplay/save-point.d.ts
+/**
+* The save, as something the scene can point a signal at.
+*
+* Every other common wiring in this engine became declarative — score to
+* screen, damage to health bar, waves, win and lose — and saving stayed the one
+* thing that needed TypeScript. The skill's own autosave example is a
+* connection to `Game.onCheckpoint`, a method the author has to go and write.
+*
+* "*When* to save is a design decision and only your game knows" is right, and
+* it is untouched here: the SCENE still says when, by choosing which signal to
+* wire — a level exit's `triggerEnter`, `won`, a key. What it gets is something
+* to wire TO.
+*
+* ```json
+* { "name": "Save", "type": "Node", "uid": "n_…",
+*   "script": { "name": "SavePoint", "props": { "game": "vault", "slot": "1" } } }
+* ```
+* ```json
+* { "signal": "triggerEnter", "from": "Level/Exit", "to": "Save", "handler": "save" }
+* ```
+*/
+declare class SavePoint extends Behavior {
+  static readonly props: PropSchema;
+  static readonly signals: readonly string[];
+  game: string;
+  slot: string;
+  label: string;
+  scene: string;
+  restoreOnReady: boolean;
+  probeOnReady: boolean;
+  /** Seconds this run has been playing — written into the slot as `playtime`. */
+  private elapsed;
+  private slots;
+  private store;
+  private pendingRestore;
+  private pendingProbe;
+  override onReady(): void;
+  override update(dt: number): void;
+  /**
+  * Is there anything to continue? Emits `hasSave(label, playtime, scene)` or
+  * `noSave`, and touches nothing.
+  *
+  * The label leads because that is what a menu shows; an unlabelled slot
+  * falls back to its scene key, so `hasSave → SlotInfo.setText` always says
+  * something rather than nothing.
+  */
+  probe(): void;
+  /** Seconds this run has been playing, including time carried over a continue. */
+  get playtime(): number;
+  /**
+  * The scene key this slot was saved from — what a loader needs to route.
+  * Null when the slot is empty.
+  */
+  slotScene(): string | null;
+  /**
+  * Write the run to its slot. Emits `saved(slotId)`.
+  *
+  * Wire it to whatever marks the moment. Extra signal arguments are ignored,
+  * so `triggerEnter → save` works as-is.
+  */
+  save(): void;
+  /**
+  * Give this scene the slot's state back. Emits `restored(count)`, or
+  * `noSave` when the slot is empty — which is what greys out a Continue button.
+  *
+  * Restoring does NOT route: if the slot names another scene, that is your
+  * loader's business, and `slot.scene` is the key it needs.
+  */
+  restore(): void;
+  /** Forget this slot — a "delete save" button. */
+  clear(): void;
+  /** The run's own clock survives a save/continue cycle. */
+  override serialize(): JsonValue;
+  override deserialize(data: JsonValue): void;
+}
+//#endregion
 //#region src/gameplay/score-keeper.d.ts
 /**
 * The game's state hub — score, lives, and win/lose detection. Put it on the
@@ -787,4 +864,4 @@ declare function registerGameplayBehaviors(opts?: {
   replace?: boolean;
 }): void;
 //#endregion
-export { CameraShake, Chase, Collector, Cooldown, DamageOnContact, DayNight, type DayPhase, FollowCamera, GAMEPLAY_BEHAVIORS, GameFlow, type GameFlowState, Health, Interactable, Lifetime, MoveTo, Oscillate, PathFollow, Patrol, Pickup, Projectile, ScoreKeeper, Spawner, Wander, WaveSpawner, ZombieAI, goToScene, hitStop, phaseOf, registerGameplayBehaviors, restartScene, screenFlash };
+export { CameraShake, Chase, Collector, Cooldown, DamageOnContact, DayNight, type DayPhase, FollowCamera, GAMEPLAY_BEHAVIORS, GameFlow, type GameFlowState, Health, Interactable, Lifetime, MoveTo, Oscillate, PathFollow, Patrol, Pickup, Projectile, SavePoint, ScoreKeeper, Spawner, Wander, WaveSpawner, ZombieAI, goToScene, hitStop, phaseOf, registerGameplayBehaviors, restartScene, screenFlash };

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