incanto 0.41.0 → 0.42.0

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-DuTlY56W.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-DcWg4LT5.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.41.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-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-DuTlY56W.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-DnycZ91Q.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-CEnZFcpM.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-MSZvnHkp.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-CumBBvQo.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-pGTHb_V4.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-u7TDbvln.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-CZpENyin.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-DuTlY56W.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

package/dist/{register-DnycZ91Q.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-DuTlY56W.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-MSZvnHkp.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-DuTlY56W.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-DcWg4LT5.js → replay-DilbZgQI.js}

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

package/dist/src-cU57Uwdw.js

@@ -0,0 +1,166 @@
+//#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.42.0";
+//#endregion
+export { findPath as a, preloadUrls as i, newUid as n, gridFromRows as o, assetUrls as r, VERSION as t };

package/dist/{test-B4kSwQzq.js → test-DuOD1DO8.js}

@@ -1,13 +1,13 @@
 import { n as loadScene, w as registerBehavior } from "./loader-r49nDwB4.js";
-import { h as Engine } from "./register-DuTlY56W.js";
+import { h as Engine } from "./register-BSXV8T9F.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
-import { n as startRecording } from "./replay-DcWg4LT5.js";
+import { n as startRecording } from "./replay-DilbZgQI.js";
 import { n as jsonEquals, t as jsonClone } from "./json-BLk7H2Qa.js";
 import { i as getNodeSchema, s as mergeStaticProps } from "./registry-IyWCGe4q.js";
-import { n as registerGameplayBehaviors } from "./gameplay-By8mslMc.js";
-import { t as registerNodes2D } from "./register-MSZvnHkp.js";
-import { n as registerNodes3D, t as resolveEnvironmentHdri } from "./environment-presets-pGTHb_V4.js";
-import { t as registerNodesNet } from "./register-DnycZ91Q.js";
+import { n as registerGameplayBehaviors } from "./gameplay-DRi9524r.js";
+import { t as registerNodes2D } from "./register-R2JTnIMw.js";
+import { n as registerNodes3D, t as resolveEnvironmentHdri } from "./environment-presets-Vl5xBsXp.js";
+import { t as registerNodesNet } from "./register-D651it1J.js";
 import { Box3, Euler, Matrix4, PerspectiveCamera, Quaternion, Vector3 } from "three";
 //#region src/test/framing.ts
 /**
@@ -663,8 +663,19 @@ function positionOf(node) {
 		p?.[2] ?? 0
 	];
 }
+/**
+* A body's velocity, whichever name it keeps it under.
+*
+* `RigidBody2D/3D` call it `linearVelocity` (the solver owns it);
+* `CharacterBody2D/3D` call it `velocity` (Godot semantics — the game owns it
+* and calls moveAndSlide). Reading only the first reported **zero for every
+* CharacterBody game**, so `incanto-feel` answered `topSpeed 0` and every
+* derived window as null — a feel report that cannot see the character move.
+* It went unnoticed because every test in feel.test.ts drives a RigidBody3D.
+*/
 function velocityOf(node) {
-	const v = node.linearVelocity;
+	const body = node;
+	const v = body.linearVelocity ?? body.velocity;
 	return [
 		v?.[0] ?? 0,
 		v?.[1] ?? 0,
@@ -1244,10 +1255,10 @@ async function runScript(json, opts) {
 	engine.setScene(scene);
 	const physics = opts.physics ?? "auto";
 	if (physics === "2d" || physics === "auto" && scene.dimension === "2d") {
-		const { enablePhysics2D } = await import("./physics-2d-CEnZFcpM.js").then((n) => n.r);
+		const { enablePhysics2D } = await import("./physics-2d-BmgXBNDB.js").then((n) => n.r);
 		await enablePhysics2D(engine);
 	} else if (physics === "3d" || physics === "auto" && scene.dimension === "3d") {
-		const { enablePhysics3D } = await import("./physics-3d-CumBBvQo.js").then((n) => n.r);
+		const { enablePhysics3D } = await import("./physics-3d-C2G604O1.js").then((n) => n.r);
 		await enablePhysics3D(engine);
 	}
 	const failures = [];
@@ -1360,10 +1371,10 @@ async function createPlaySession(json, opts = {}) {
 	engine.setScene(scene);
 	const physics = opts.physics ?? "auto";
 	if (physics === "2d" || physics === "auto" && scene.dimension === "2d") {
-		const { enablePhysics2D } = await import("./physics-2d-CEnZFcpM.js").then((n) => n.r);
+		const { enablePhysics2D } = await import("./physics-2d-BmgXBNDB.js").then((n) => n.r);
 		await enablePhysics2D(engine);
 	} else if (physics === "3d" || physics === "auto" && scene.dimension === "3d") {
-		const { enablePhysics3D } = await import("./physics-3d-CumBBvQo.js").then((n) => n.r);
+		const { enablePhysics3D } = await import("./physics-3d-C2G604O1.js").then((n) => n.r);
 		await enablePhysics3D(engine);
 	}
 	const stepMs = 1e3 / (opts.fixedHz ?? 60);

package/dist/test.d.ts

@@ -1,7 +1,7 @@
-import { Et as Node, P as Scene, b as Engine, kt as LogEntry, n as BehaviorCtor } from "./behavior-TA8nySqb.js";
+import { Et as Node, P as Scene, b as Engine, kt as LogEntry, n as BehaviorCtor } from "./behavior-62q0HWBO.js";
 import { c as JsonValue, i as SceneJson } from "./schema-CFeioQRE.js";
-import { t as LoadSceneOptions } from "./loader-CvSDKC3v.js";
-import { l as auditScene, o as IncantoError, r as ReplayJson } from "./replay-DN-kG4va.js";
+import { t as LoadSceneOptions } from "./loader-CeyU_bm1.js";
+import { l as auditScene, o as IncantoError, r as ReplayJson } from "./replay-CAphXMyM.js";
 
 //#region src/test/framing.d.ts
 /** Where a node's origin sits relative to the current camera. */

package/dist/test.js

@@ -1,3 +1,3 @@
-import { r as auditScene } from "./replay-DcWg4LT5.js";
-import { a as registerAllNodes, c as feelReport, d as findPlayer, f as playtest, h as framingText, i as findFloatingProps, l as feelText, m as describeFraming, n as createPlaySession, o as runScript, p as playtestText, r as describeCapture, s as validateScene, t as captureScene, u as failingReplays } from "./test-B4kSwQzq.js";
+import { r as auditScene } from "./replay-DilbZgQI.js";
+import { a as registerAllNodes, c as feelReport, d as findPlayer, f as playtest, h as framingText, i as findFloatingProps, l as feelText, m as describeFraming, n as createPlaySession, o as runScript, p as playtestText, r as describeCapture, s as validateScene, t as captureScene, u as failingReplays } from "./test-DuOD1DO8.js";
 export { auditScene, captureScene, createPlaySession, describeCapture, describeFraming, failingReplays, feelReport, feelText, findFloatingProps, findPlayer, framingText, playtest, playtestText, registerAllNodes, runScript, validateScene };

package/dist/vite.d.ts

@@ -1,3 +1,63 @@
+//#region src/vite/discover.d.ts
+/**
+* The listening TCP ports in `/proc/net/tcp` (and `tcp6`) format.
+*
+* Linux-only and dependency-free ON PURPOSE: `lsof` and `ss` are routinely
+* absent from a slim container, and this has to work in the container a
+* vibe-coding service actually ships, not in a developer's laptop.
+*/
+declare function parseProcNetTcp(text: string): number[];
+interface DiscoverDeps {
+  /** Reads a proc file; returns null when it is not there (macOS, Windows). */
+  read(path: string): string | null;
+}
+/**
+* Ports worth asking, in the order worth asking them.
+*
+* Observed first — those are facts. The usual suspects after, because a
+* container that hides `/proc` should still find a vite server on 5173.
+*/
+declare function listeningPorts(deps?: Partial<DiscoverDeps>): Promise<number[]>;
+//#endregion
+//#region src/vite/frame-endpoint.d.ts
+interface FrameHost {
+  config?: {
+    root?: string;
+  };
+  middlewares: {
+    use(path: string, handler: (req: unknown, res: FrameRes) => void): void;
+  };
+  /** Vite's HMR channel. `ws` on v5, `hot` on v6+ — both are accepted. */
+  ws?: FrameChannel;
+  hot?: FrameChannel;
+}
+interface FrameChannel {
+  send(payload: {
+    type: "custom";
+    event: string;
+    data?: unknown;
+  }): void;
+  on(event: string, cb: (data: unknown) => void): void;
+}
+interface FrameRes {
+  statusCode: number;
+  setHeader(name: string, value: string): void;
+  end(body?: string): void;
+}
+interface FrameEndpointOptions {
+  /** Overridden in tests; defaults to the real clock. */
+  now?: () => number;
+  timeoutMs?: number;
+}
+/**
+* Wire `/__incanto/ping` and `/__incanto/frame` onto a dev server.
+*
+* `ping` is how the CLI tells our server apart from anything else listening in
+* the container: it enumerates the ports that are actually open and asks each
+* one. That answer has to be cheap and unmistakable.
+*/
+declare function serveFrameEndpoints(host: FrameHost, version: string, opts?: FrameEndpointOptions): void;
+//#endregion
 //#region src/vite/index.d.ts
 interface HotUpdateContext {
   file: string;
@@ -161,4 +221,4 @@ declare function incantoLibrary(opts?: IncantoLibraryOptions): {
 /** @internal Exported for tests — the whole request/response behaviour. */
 declare function serveLibrary(req: LibraryReq, res: LibraryRes, opts?: IncantoLibraryOptions, doFetch?: typeof fetch): Promise<void>;
 //#endregion
-export { IncantoLibraryOptions, IncantoScenesOptions, ProjectFileEntry, discoverScenes, incantoLibrary, incantoScenes, resolveSceneFile, sceneFacts, serveLibrary, serveSceneFile, serveSceneList };
+export { type FrameHost, IncantoLibraryOptions, IncantoScenesOptions, ProjectFileEntry, discoverScenes, incantoLibrary, incantoScenes, listeningPorts, parseProcNetTcp, resolveSceneFile, sceneFacts, serveFrameEndpoints, serveLibrary, serveSceneFile, serveSceneList };