incanto 0.40.1 → 0.42.0

package/dist/debug.js

@@ -192,6 +192,9 @@ function detailText(value, json) {
 function isPlainObject(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
+/** The slider's ceiling. Beyond this the number box is the tool — a 0..8 slider
+*  makes the 0.1-to-1 range, where slow-motion debugging actually lives, unusable. */
+const TIME_SLIDER_MAX = 2;
 /** Attach the overlay; null when no DOM is available (headless). */
 function attachDebugOverlay(engine, opts = {}) {
 	const doc = opts.doc ?? (typeof document !== "undefined" ? document : null);
@@ -235,6 +238,15 @@ var DebugOverlay = class {
 	editing = 0;
 	/** Which bulky values are unfolded, per node ('transforms', 'collider.vertices'). */
 	detailOpen = /* @__PURE__ */ new WeakMap();
+	/**
+	* The scale to come back to when a pause is lifted.
+	*
+	* Captured only from a RUNNING scale: pausing an already-frozen game (a
+	* hit-stop, a previous pause) must not record 0 as the thing to restore, or
+	* Resume does nothing and the game looks hung.
+	*/
+	resumeScale = 1;
+	timeEls = null;
 	/** Pointer inside the inspector — it stops refreshing under your hand. */
 	hovering = false;
 	constructor(engine, container, doc, statsSource, actions = []) {
@@ -282,6 +294,7 @@ var DebugOverlay = class {
 			this.renderExplorer();
 			this.renderStats();
 			if (this.editing === 0 && !this.hovering) this.renderInspector();
+			this.syncTime();
 		}));
 	}
 	isOpen(id) {
@@ -314,11 +327,18 @@ var DebugOverlay = class {
 			this.openStatsChip();
 			return;
 		}
-		if (this.panels.has(id)) return;
+		if (this.panels.has(id)) {
+			if (id === "explorer") this.renderExplorer();
+			if (id === "inspector") this.renderInspector();
+			if (id === "logs") this.renderLogs();
+			if (id === "time") this.renderTime();
+			return;
+		}
 		const panel = new FloatingPanel(this.doc, this.container, {
 			explorer: "Explorer",
 			inspector: "Inspector",
-			logs: "Logs"
+			logs: "Logs",
+			time: "Time"
 		}[id], {
 			explorer: {
 				x: 12,
@@ -337,6 +357,12 @@ var DebugOverlay = class {
 				y: 380,
 				w: 532,
 				h: 200
+			},
+			time: {
+				x: 556,
+				y: 44,
+				w: 260,
+				h: 150
 			}
 		}[id]);
 		panel.onClose = () => this.close(id);
@@ -352,6 +378,7 @@ var DebugOverlay = class {
 		if (id === "explorer") this.renderExplorer();
 		if (id === "inspector") this.renderInspector();
 		if (id === "logs") this.renderLogs();
+		if (id === "time") this.renderTime();
 	}
 	close(id) {
 		if (id === "inspector") this.hovering = false;
@@ -453,6 +480,7 @@ var DebugOverlay = class {
 			["explorer", "Explorer"],
 			["inspector", "Inspector"],
 			["logs", "Logs"],
+			["time", "Time"],
 			["stats", "Stats"],
 			["colliders", "Colliders"]
 		]) {
@@ -849,6 +877,148 @@ var DebugOverlay = class {
 		if (this.logRows.length > MAX_LOG_ROWS) this.logRows.splice(0, this.logRows.length - MAX_LOG_ROWS);
 		this.renderLogs();
 	}
+	/**
+	* Set game time, defensively. `timeScale` multiplies every dt in the engine,
+	* so a NaN from a text field would poison physics, timers and animation in
+	* one frame, and a negative would run the simulation backwards through code
+	* that has never been asked to.
+	*/
+	setTimeScale(next) {
+		if (!Number.isFinite(next)) return;
+		this.engine.timeScale = Math.max(0, next);
+		this.syncTime();
+	}
+	/** Freeze or unfreeze game time. Rendering keeps running — this is a pause,
+	*  not a stop: the camera still moves and the overlay stays interactive. */
+	setPaused(paused) {
+		if (paused) {
+			if (this.engine.timeScale > 0) this.resumeScale = this.engine.timeScale;
+			this.engine.timeScale = 0;
+		} else this.engine.timeScale = this.resumeScale > 0 ? this.resumeScale : 1;
+		this.syncTime();
+	}
+	get paused() {
+		return this.engine.timeScale === 0;
+	}
+	/**
+	* Advance exactly one frame, pausing first.
+	*
+	* Stepping a RUNNING game is meaningless — the next real frame lands a
+	* millisecond later and swamps the step — so this pauses and then steps,
+	* which is also the only way the button is useful twice in a row.
+	*/
+	nextFrame() {
+		if (!this.paused) this.setPaused(true);
+		this.engine.step();
+		this.syncTime();
+	}
+	/** Push the engine's current time state into the panel, without rebuilding it. */
+	syncTime() {
+		const els = this.timeEls;
+		if (!els) return;
+		const scale = this.engine.timeScale;
+		const text = String(Math.round(scale * 1e3) / 1e3);
+		if (this.editing === 0) {
+			els.slider.value = String(Math.min(scale, TIME_SLIDER_MAX));
+			els.box.value = text;
+		}
+		els.readout.textContent = `timeScale ${text}${this.paused ? " · paused" : ""}`;
+		els.pause.textContent = this.paused ? "▶ Resume" : "⏸ Pause";
+	}
+	renderTime() {
+		const panel = this.panels.get("time");
+		if (!panel) return;
+		clear(panel.body);
+		this.timeEls = null;
+		const readout = this.doc.createElement("div");
+		applyStyle(readout, {
+			marginBottom: "6px",
+			opacity: "0.85"
+		});
+		panel.body.appendChild(readout);
+		const slider = this.doc.createElement("input");
+		slider.type = "range";
+		slider.min = "0";
+		slider.max = String(TIME_SLIDER_MAX);
+		slider.step = "0.05";
+		slider.value = String(Math.min(this.engine.timeScale, TIME_SLIDER_MAX));
+		applyStyle(slider, {
+			width: "100%",
+			marginBottom: "6px"
+		});
+		this.trackEditing(slider);
+		slider.addEventListener("input", () => this.setTimeScale(Number(slider.value)));
+		panel.body.appendChild(slider);
+		const row = this.doc.createElement("div");
+		applyStyle(row, {
+			display: "flex",
+			gap: "6px",
+			alignItems: "center",
+			marginBottom: "8px"
+		});
+		const box = this.doc.createElement("input");
+		box.type = "number";
+		box.min = "0";
+		box.step = "0.05";
+		box.value = String(this.engine.timeScale);
+		applyStyle(box, inputStyle("72px"));
+		this.trackEditing(box);
+		box.addEventListener("change", () => {
+			const next = Number(box.value);
+			if (Number.isFinite(next)) this.setTimeScale(next);
+			this.syncTimeAfterEdit();
+		});
+		row.appendChild(box);
+		for (const preset of [
+			.25,
+			.5,
+			1,
+			2
+		]) {
+			const chip = this.doc.createElement("div");
+			chip.textContent = `${preset}×`;
+			applyStyle(chip, {
+				cursor: "pointer",
+				opacity: "0.7",
+				padding: "2px 4px"
+			});
+			chip.addEventListener("click", () => this.setTimeScale(preset));
+			row.appendChild(chip);
+		}
+		panel.body.appendChild(row);
+		const buttons = this.doc.createElement("div");
+		applyStyle(buttons, {
+			display: "flex",
+			gap: "8px"
+		});
+		const pause = this.doc.createElement("div");
+		applyStyle(pause, buttonStyle());
+		pause.addEventListener("click", () => this.setPaused(!this.paused));
+		buttons.appendChild(pause);
+		const step = this.doc.createElement("div");
+		step.textContent = "⏭ Next frame";
+		step.title = "Pauses, then advances one fixed step";
+		applyStyle(step, buttonStyle());
+		step.addEventListener("click", () => this.nextFrame());
+		buttons.appendChild(step);
+		panel.body.appendChild(buttons);
+		this.timeEls = {
+			slider,
+			box,
+			readout,
+			pause
+		};
+		this.syncTime();
+	}
+	/** After a committed edit the field must show what the ENGINE took — a
+	*  rejected 'abc' or a clamped -2 has to be visible, not left on screen. */
+	syncTimeAfterEdit() {
+		const els = this.timeEls;
+		if (!els) return;
+		const scale = this.engine.timeScale;
+		els.slider.value = String(Math.min(scale, TIME_SLIDER_MAX));
+		els.box.value = String(Math.round(scale * 1e3) / 1e3);
+	}
 	renderLogs() {
 		const panel = this.panels.get("logs");
 		if (!panel) return;
@@ -924,6 +1094,17 @@ function stringify(part) {
 		return String(part);
 	}
 }
+/** A clickable chip that reads as a button in the overlay's flat style. */
+function buttonStyle() {
+	return {
+		background: "rgba(255,255,255,0.08)",
+		border: "1px solid rgba(255,255,255,0.2)",
+		borderRadius: "4px",
+		padding: "4px 8px",
+		cursor: "pointer",
+		userSelect: "none"
+	};
+}
 function inputStyle(width) {
 	return {
 		width,

package/dist/{environment-presets-CIZXGKnS.js → environment-presets-Vl5xBsXp.js}

@@ -1,10 +1,10 @@
-import { t as registerCoreNodes } from "./register-DMFJI-c_.js";
+import { t as registerCoreNodes } from "./register-BSXV8T9F.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-By8mslMc.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-DRi9524r.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-By8mslMc.js → gameplay-DRi9524r.js}

@@ -5166,7 +5166,20 @@ var CameraShake = class extends Behavior {
 	magnitude = 0;
 	t = 0;
 	prev = [];
+	/**
+	* Start a shake — unless the player asked for no motion.
+	*
+	* `settings.reduceMotion` is an accessibility switch, and camera movement the
+	* player did not cause is the vestibular trigger it exists for. Checked HERE
+	* rather than in `update` so a shake requested while it is on leaves nothing
+	* queued to play the moment it is turned off.
+	*
+	* It deliberately does NOT touch gameplay timing (`hitStop`): freezing time
+	* for 80 ms is feedback, not motion, and removing it would change what the
+	* game is rather than how it moves.
+	*/
 	shake(magnitude, seconds) {
+		if (this.engine?.settings.get("reduceMotion") === true) return;
 		this.magnitude = Math.max(this.magnitude, magnitude);
 		this.t = seconds ?? this.falloff;
 	}

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-TA8nySqb.js";
+import { Et as Node, b as Engine, d as PropSchema, n as BehaviorCtor, t as Behavior } from "./behavior-62q0HWBO.js";
 import { c as JsonValue, s as JsonObject } from "./schema-CFeioQRE.js";
 
 //#region src/gameplay/chase.d.ts
@@ -685,6 +685,18 @@ declare class CameraShake extends Behavior {
   private magnitude;
   private t;
   private prev;
+  /**
+  * Start a shake — unless the player asked for no motion.
+  *
+  * `settings.reduceMotion` is an accessibility switch, and camera movement the
+  * player did not cause is the vestibular trigger it exists for. Checked HERE
+  * rather than in `update` so a shake requested while it is on leaves nothing
+  * queued to play the moment it is turned off.
+  *
+  * It deliberately does NOT touch gameplay timing (`hitStop`): freezing time
+  * for 80 ms is feedback, not motion, and removing it would change what the
+  * game is rather than how it moves.
+  */
   shake(magnitude: number, seconds?: number): void;
   override update(dt: number): void;
 }

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-By8mslMc.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-DRi9524r.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 suggestLocale, A as SettingsValues, At as LogLevel, B as captureBehaviors, C as EngineStats, Ct as PlayMusicOptions, Dt as NodeLifecycle, E as DeviceHints, Et as Node, F as BehaviorState, G as OrderGroup, H as SaveStore, I as RestoreReport, J as resolveOrderGroups, K as OrderGroupTable, L as SaveSlot, M as readDeviceHints, Mt as Signal, N as suggestQuality, Nt as SignalListener, O as QualityTier, Ot as SceneTree, P as Scene, Q as T_PREFIX, R as SaveSlots, S as Scheduler, St as MusicTrack, T as RendererStats, Tt as BusName, U as createSaveStore, V as restoreBehaviors, W as ORDER_GROUP_BASE, X as LocaleTables, Y as BASE_LOCALE, Z as Localization, _ as mergeStaticSignals, _t as SfxWave, a as clearBehaviors, at as Voice, b as Engine, bt as MusicBackend, c as registeredBehaviors, ct as ROLLOFF_MODELS, d as PropSchema, dt as Vec3, et as translationKey, f as clearRegistry, ft as spatialGain, g as getNodeType, gt as SfxParams, h as getNodeSignals, ht as SFX_PRESET_NAMES, i as behaviorSignals, it as isAudioContextAvailable, j as qualityEnvironment, jt as LogManager, k as Settings, kt as LogEntry, l as NodeCtor, lt as RolloffModel, m as getNodeSchema, mt as SFX_PRESETS, n as BehaviorCtor, nt as SfxEngine, o as getBehavior, ot as VoicePreset, p as createNode, pt as spatialPan, q as effectiveOrder, r as behaviorSchema, rt as SfxPlayOptions, s as registerBehavior, st as Listener, t as Behavior, tt as InputMap, u as PropDef, ut as SpatialParams, v as registerNode, vt as SynthOptions, w as GameStats, wt as AudioBuses, x as EngineOptions, xt as MusicManager, y as registeredTypes, yt as synthSfx, z as behaviorsWithoutSave } from "./behavior-TA8nySqb.js";
+import { $ as suggestLocale, A as SettingsValues, At as LogLevel, B as captureBehaviors, C as EngineStats, Ct as PlayMusicOptions, Dt as NodeLifecycle, E as DeviceHints, Et as Node, F as BehaviorState, G as OrderGroup, H as SaveStore, I as RestoreReport, J as resolveOrderGroups, K as OrderGroupTable, L as SaveSlot, M as readDeviceHints, Mt as Signal, N as suggestQuality, Nt as SignalListener, O as QualityTier, Ot as SceneTree, P as Scene, Q as T_PREFIX, R as SaveSlots, S as Scheduler, St as MusicTrack, T as RendererStats, Tt as BusName, U as createSaveStore, V as restoreBehaviors, W as ORDER_GROUP_BASE, X as LocaleTables, Y as BASE_LOCALE, Z as Localization, _ as mergeStaticSignals, _t as SfxWave, a as clearBehaviors, at as Voice, b as Engine, bt as MusicBackend, c as registeredBehaviors, ct as ROLLOFF_MODELS, d as PropSchema, dt as Vec3, et as translationKey, f as clearRegistry, ft as spatialGain, g as getNodeType, gt as SfxParams, h as getNodeSignals, ht as SFX_PRESET_NAMES, i as behaviorSignals, it as isAudioContextAvailable, j as qualityEnvironment, jt as LogManager, k as Settings, kt as LogEntry, l as NodeCtor, lt as RolloffModel, m as getNodeSchema, mt as SFX_PRESETS, n as BehaviorCtor, nt as SfxEngine, o as getBehavior, ot as VoicePreset, p as createNode, pt as spatialPan, q as effectiveOrder, r as behaviorSchema, rt as SfxPlayOptions, s as registerBehavior, st as Listener, t as Behavior, tt as InputMap, u as PropDef, ut as SpatialParams, v as registerNode, vt as SynthOptions, w as GameStats, wt as AudioBuses, x as EngineOptions, xt as MusicManager, y as registeredTypes, yt as synthSfx, z as behaviorsWithoutSave } from "./behavior-62q0HWBO.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-CvSDKC3v.js";
+import { n as loadScene, t as LoadSceneOptions } from "./loader-CeyU_bm1.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-_UlKUoox.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-DN-kG4va.js";
+import { a as AudioElementLike, i as gridFromRows, n as PathGrid, o as AudioPlayer, r as findPath, t as FindPathOptions } from "./pathfinding-C49JSNNq.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-CAphXMyM.js";
 
 //#region src/core/audio/crossfade.d.ts
 /**

package/dist/index.js

@@ -1,177 +1,13 @@
 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 T_PREFIX, B as synthSfx, C as behaviorsWithoutSave, D as LogManager, E as createSaveStore, F as ROLLOFF_MODELS, G as AudioBuses, H as WebAudioMusicBackend, I as spatialGain, L as spatialPan, M as translationKey, N as SfxEngine, O as BASE_LOCALE, P as isAudioContextAvailable, R as SFX_PRESETS, S as SaveSlots, T as restoreBehaviors, U as crossfadeGains, V as MusicManager, W as fadeGain, a as UiSlider, b as readDeviceHints, c as UiButton, d as UiBanner, f as UiBar, g as Settings, h as Engine, i as UiSelect, j as suggestLocale, k as Localization, 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 qualityEnvironment, w as captureBehaviors, x as suggestQuality, z as SFX_PRESET_NAMES } from "./register-DMFJI-c_.js";
+import { A as T_PREFIX, B as synthSfx, C as behaviorsWithoutSave, D as LogManager, E as createSaveStore, F as ROLLOFF_MODELS, G as AudioBuses, H as WebAudioMusicBackend, I as spatialGain, L as spatialPan, M as translationKey, N as SfxEngine, O as BASE_LOCALE, P as isAudioContextAvailable, R as SFX_PRESETS, S as SaveSlots, T as restoreBehaviors, U as crossfadeGains, V as MusicManager, W as fadeGain, a as UiSlider, b as readDeviceHints, c as UiButton, d as UiBanner, f as UiBar, g as Settings, h as Engine, i as UiSelect, j as suggestLocale, k as Localization, 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 qualityEnvironment, w as captureBehaviors, x as suggestQuality, z as SFX_PRESET_NAMES } from "./register-BSXV8T9F.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as Rng } from "./rng-DP-SR7eg.js";
-import { n as startRecording, r as auditScene, t as replay } from "./replay-D_QY5Xm3.js";
+import { n as startRecording, r as auditScene, t as replay } from "./replay-DilbZgQI.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 { a as findPath, i as preloadUrls, n as newUid, o as gridFromRows, r as assetUrls, t as VERSION } from "./src-cU57Uwdw.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-CRtihGmC.js";
-//#region src/core/pathfinding.ts
-/**
-* A* from `from` to `to` (inclusive cell coords). Returns the cell path
-* INCLUDING both endpoints, or null when unreachable. Straight steps cost
-* 1, diagonals √2; the heuristic is octile (admissible for both modes).
-*/
-function findPath(grid, from, to, opts) {
-	const [sx, sy] = from;
-	const [tx, ty] = to;
-	const { width, height } = grid;
-	const inBounds = (x, y) => x >= 0 && y >= 0 && x < width && y < height;
-	if (!inBounds(sx, sy) || !inBounds(tx, ty)) return null;
-	if (grid.solid(sx, sy) || grid.solid(tx, ty)) return null;
-	if (sx === tx && sy === ty) return [[sx, sy]];
-	const diagonal = opts?.diagonal ?? true;
-	const maxExpansions = opts?.maxExpansions ?? 2e4;
-	const idx = (x, y) => y * width + x;
-	const gScore = new Float64Array(width * height).fill(Number.POSITIVE_INFINITY);
-	const cameFrom = new Int32Array(width * height).fill(-1);
-	const closed = new Uint8Array(width * height);
-	const heap = [];
-	const fScore = new Float64Array(width * height).fill(Number.POSITIVE_INFINITY);
-	const push = (n) => {
-		heap.push(n);
-		let i = heap.length - 1;
-		while (i > 0) {
-			const p = i - 1 >> 1;
-			if (fScore[heap[p]] <= fScore[heap[i]]) break;
-			const t = heap[p];
-			heap[p] = heap[i];
-			heap[i] = t;
-			i = p;
-		}
-	};
-	const pop = () => {
-		const top = heap[0];
-		const last = heap.pop();
-		if (heap.length > 0) {
-			heap[0] = last;
-			let i = 0;
-			for (;;) {
-				const l = i * 2 + 1;
-				const r = l + 1;
-				let m = i;
-				if (l < heap.length && fScore[heap[l]] < fScore[heap[m]]) m = l;
-				if (r < heap.length && fScore[heap[r]] < fScore[heap[m]]) m = r;
-				if (m === i) break;
-				const t = heap[m];
-				heap[m] = heap[i];
-				heap[i] = t;
-				i = m;
-			}
-		}
-		return top;
-	};
-	const SQRT2 = Math.SQRT2;
-	const octile = (x, y) => {
-		const dx = Math.abs(x - tx);
-		const dy = Math.abs(y - ty);
-		return dx > dy ? dx - dy + SQRT2 * dy : dy - dx + SQRT2 * dx;
-	};
-	const start = idx(sx, sy);
-	gScore[start] = 0;
-	fScore[start] = octile(sx, sy);
-	push(start);
-	let expansions = 0;
-	while (heap.length > 0) {
-		if (++expansions > maxExpansions) return null;
-		const current = pop();
-		if (closed[current]) continue;
-		closed[current] = 1;
-		const cx = current % width;
-		const cy = current / width | 0;
-		if (cx === tx && cy === ty) {
-			const path = [];
-			let n = current;
-			while (n !== -1) {
-				path.push([n % width, n / width | 0]);
-				n = cameFrom[n];
-			}
-			path.reverse();
-			return path;
-		}
-		for (let dy = -1; dy <= 1; dy++) for (let dx = -1; dx <= 1; dx++) {
-			if (dx === 0 && dy === 0) continue;
-			const isDiag = dx !== 0 && dy !== 0;
-			if (isDiag && !diagonal) continue;
-			const nx = cx + dx;
-			const ny = cy + dy;
-			if (!inBounds(nx, ny) || grid.solid(nx, ny)) continue;
-			if (isDiag && (grid.solid(cx + dx, cy) || grid.solid(cx, cy + dy))) continue;
-			const n = idx(nx, ny);
-			if (closed[n]) continue;
-			const tentative = gScore[current] + (isDiag ? SQRT2 : 1);
-			if (tentative < gScore[n]) {
-				gScore[n] = tentative;
-				fScore[n] = tentative + octile(nx, ny);
-				cameFrom[n] = current;
-				push(n);
-			}
-		}
-	}
-	return null;
-}
-/** Build a PathGrid from row-strings ('#' = solid) — tests and tile games. */
-function gridFromRows(rows) {
-	const height = rows.length;
-	return {
-		width: rows[0]?.length ?? 0,
-		height,
-		solid: (x, y) => (rows[y]?.[x] ?? "#") === "#"
-	};
-}
-//#endregion
-//#region src/core/preload.ts
-/**
-* Warm the HTTP cache for a list of asset urls with a progress callback —
-* the loading-bar pattern every template ships. Failures only warn and still
-* count toward progress (a broken url must not block the game), but they are
-* reported in the result so callers can tell success from 100%-with-holes.
-*/
-async function preloadUrls(urls, onProgress) {
-	let loaded = 0;
-	const failed = [];
-	const total = urls.length;
-	if (total === 0) {
-		onProgress?.(0, 0);
-		return { failed };
-	}
-	await Promise.all(urls.map(async (url) => {
-		try {
-			await (await fetch(url)).arrayBuffer();
-		} catch (error) {
-			failed.push(url);
-			console.warn(`[incanto] preload failed for ${url}:`, error);
-		}
-		loaded += 1;
-		onProgress?.(loaded, total);
-	}));
-	return { failed };
-}
-/** Every url found in a scene's `assets` block (preload helper). */
-function assetUrls(assets) {
-	return Object.values(assets ?? {}).map((a) => a.url).filter((u) => typeof u === "string" && !u.startsWith("data:"));
-}
-//#endregion
-//#region src/core/uid-gen.ts
-/**
-* The ONE way to mint a node uid: crypto-strength, `n_` + 16 base36 chars
-* (~82 bits). Hand-written uids are forbidden by convention — they break the
-* collision-strength contract and read as fakes next to generated ones.
-*/
-function newUid() {
-	const bytes = new Uint8Array(16);
-	if (globalThis.crypto?.getRandomValues) globalThis.crypto.getRandomValues(bytes);
-	else for (let i = 0; i < bytes.length; i++) bytes[i] = Math.floor(Math.random() * 256);
-	let id = "";
-	for (const b of bytes) id += (b % 36).toString(36);
-	return `n_${id.slice(0, 16)}`;
-}
-//#endregion
-//#region src/index.ts
-/** Engine version. Kept in sync with package.json by the release pipeline. */
-const VERSION = "0.40.1";
-//#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-CvSDKC3v.d.ts → loader-CeyU_bm1.d.ts}

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

package/dist/net.d.ts

@@ -1,4 +1,4 @@
-import { Et as Node, Mt as Signal, b as Engine, d as PropSchema } from "./behavior-TA8nySqb.js";
+import { Et as Node, Mt as Signal, b as Engine, d as PropSchema } from "./behavior-62q0HWBO.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-r49nDwB4.js";
-import { h as Engine } from "./register-DMFJI-c_.js";
+import { h as Engine } from "./register-BSXV8T9F.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-D5v8iqjZ.js";
+import { i as applySyncPatch, n as NetworkSpawner, r as NetworkManager, t as registerNodesNet } from "./register-D651it1J.js";
 //#region src/net/loopback.ts
 /**
 * In-memory multiplayer hub implementing the SAME kernel contract as

package/dist/{pathfinding-_UlKUoox.d.ts → pathfinding-C49JSNNq.d.ts}

@@ -1,4 +1,4 @@
-import { Et as Node, d as PropSchema, st as Listener } from "./behavior-TA8nySqb.js";
+import { Et as Node, d as PropSchema, st as Listener } from "./behavior-62q0HWBO.js";
 
 //#region src/core/nodes/audio-player.d.ts
 /**

package/dist/{physics-2d-CxIqR1cW.js → physics-2d-BmgXBNDB.js}

@@ -1,7 +1,7 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.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-CgMO5JBY.js";
+import { _ as RigidBody2D, b as validateCollider2D, g as PhysicsBody2D, h as CharacterBody2D, m as Area2D, p as Joint2D, y as Node2D } from "./register-R2JTnIMw.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-CgIHivyL.js → physics-3d-C2G604O1.js}

@@ -1,9 +1,9 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.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-By8mslMc.js";
+import { F as PhysicsBody3D, I as RigidBody3D, N as Area3D, P as CharacterBody3D, R as Node3D, z as validateCollider3D } from "./gameplay-DRi9524r.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-CIZXGKnS.js";
+import { A as Terrain3D, F as InstancedMesh3D, L as buildMeshGeometry, P as Joint3D } from "./environment-presets-Vl5xBsXp.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 { P as Scene, b as Engine, n as BehaviorCtor } from "./behavior-TA8nySqb.js";
+import { P as Scene, b as Engine, n as BehaviorCtor } from "./behavior-62q0HWBO.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-p-O66Y_U.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-B7c5icho.js").then((n) => n.n)).createGame2D(o)))(opts);
+			const next = await (_gameFactory ?? (mode === "3d" ? async (o) => (await import("./create-game-DItIRyXH.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-9KPppR0L.js").then((n) => n.n)).createGame2D(o)))(opts);
 			if (disposed) {
 				next.dispose();
 				return;

package/dist/{register-DMFJI-c_.js → register-BSXV8T9F.js}

@@ -204,7 +204,9 @@ var WebAudioMusicBackend = class {
 * frame to advance fades (the engine wires this to `updated`).
 *
 * ```ts
-* engine.music.play('incanto/assets/audio/theme.mp3');     // loop, full
+* // NOTE: the bundle ships SFX only — no music track. A background track is
+* // your game's own file under public/, or a URL.
+* engine.music.play('/audio/theme.mp3');                     // loop, full
 * engine.music.crossfadeTo('boss.mp3', 3);                  // 3s equal-power swap
 * engine.music.stop(2);                                     // fade out over 2s
 * engine.music.setVolume(0.5);                              // per-manager volume
@@ -1980,6 +1982,8 @@ var Engine = class {
 	step() {
 		const scene = this._scene;
 		if (!scene) return;
+		this._time += this.fixedStep;
+		this._unscaledTime += this.fixedStep;
 		scene.tree.fixedUpdate(this.fixedStep);
 		this.fixedUpdated.emit(this.fixedStep);
 		scene.tree.update(this.fixedStep);

package/dist/{register-D5v8iqjZ.js → register-D651it1J.js}

@@ -1,5 +1,5 @@
 import { E as Signal, f as Node, t as buildNodeJson } from "./loader-r49nDwB4.js";
-import { t as registerCoreNodes } from "./register-DMFJI-c_.js";
+import { t as registerCoreNodes } from "./register-BSXV8T9F.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/{register-CgMO5JBY.js → register-R2JTnIMw.js}

@@ -1,5 +1,5 @@
 import { f as Node, h as effectiveOrder } from "./loader-r49nDwB4.js";
-import { t as registerCoreNodes } from "./register-DMFJI-c_.js";
+import { t as registerCoreNodes } from "./register-BSXV8T9F.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/{replay-DN-kG4va.d.ts → replay-CAphXMyM.d.ts}

@@ -1,4 +1,4 @@
-import { b as Engine } from "./behavior-TA8nySqb.js";
+import { b as Engine } from "./behavior-62q0HWBO.js";
 import { s as JsonObject } from "./schema-CFeioQRE.js";
 
 //#region src/core/audit.d.ts

package/dist/{replay-D_QY5Xm3.js → replay-DilbZgQI.js}

@@ -1,4 +1,4 @@
-import { M as translationKey } from "./register-DMFJI-c_.js";
+import { M as translationKey } from "./register-BSXV8T9F.js";
 //#region src/core/audit.ts
 const ANIMATED_TYPES = new Set([
 	"Particles2D",