incanto 0.41.0 → 0.43.0

package/dist/{gameplay-By8mslMc.js → gameplay-BQOeAid6.js}

@@ -4973,10 +4973,15 @@ var GameFlow = class extends Behavior {
 	static signals = ["flowChanged"];
 	static props = {
 		restartAction: { default: "restart" },
+		pauseAction: { default: "pause" },
 		freezeOnEnd: { default: true },
 		bannerPath: {
 			default: "%Banner",
 			nodePath: true
+		},
+		pausePanelPath: {
+			default: "%PauseMenu",
+			nodePath: true
 		}
 	};
 	/** Input action that restarts from gameover/won (declare it in `input{}`). */
@@ -4985,8 +4990,31 @@ var GameFlow = class extends Behavior {
 	freezeOnEnd = true;
 	/** Where the flow looks for a UiBanner ('' = never). */
 	bannerPath = "%Banner";
+	/**
+	* Input action that toggles pause (declare it in `input{}`; undeclared is
+	* fine and means pause is API-only).
+	*/
+	pauseAction = "pause";
+	/**
+	* A node shown while paused and hidden otherwise — a `UiPanel` of buttons in
+	* practice. '' turns the whole thing off.
+	*
+	* This lives here rather than in each game because it is identical in all of
+	* them, and a pause menu that costs a script is a pause menu no generated
+	* game will have. `UiPanel` appeared in zero template scenes before this.
+	*/
+	pausePanelPath = "%PauseMenu";
 	state = "playing";
 	frozeScale = false;
+	onReady() {
+		this.syncPausePanel();
+	}
+	/** The panel follows the state; nothing else may own its visibility. */
+	syncPausePanel() {
+		if (this.pausePanelPath === "") return;
+		const panel = this.node.getNodeOrNull(this.pausePanelPath);
+		if (panel && "visible" in panel) panel.visible = this.state === "paused";
+	}
 	gameOver(text = "GAME OVER", color = "#ef4444") {
 		this.transition("gameover", text, color);
 	}
@@ -4997,12 +5025,14 @@ var GameFlow = class extends Behavior {
 		if (this.state !== "playing") return;
 		this.state = "paused";
 		this.freeze();
+		this.syncPausePanel();
 		this.node.emit("flowChanged", this.state);
 	}
 	resume() {
 		if (this.state !== "paused") return;
 		this.state = "playing";
 		this.thaw();
+		this.syncPausePanel();
 		this.node.emit("flowChanged", this.state);
 	}
 	restart() {
@@ -5035,6 +5065,13 @@ var GameFlow = class extends Behavior {
 		this.engine.timeScale = 1;
 	}
 	update() {
+		if (this.state === "playing" || this.state === "paused") {
+			try {
+				if (this.engine.input.justPressed(this.pauseAction)) if (this.state === "playing") this.pause();
+				else this.resume();
+			} catch {}
+			return;
+		}
 		if (this.state !== "gameover" && this.state !== "won") return;
 		try {
 			if (this.engine.input.justPressed(this.restartAction)) this.restart();
@@ -5166,7 +5203,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
@@ -622,8 +622,25 @@ declare class GameFlow extends Behavior {
   freezeOnEnd: boolean;
   /** Where the flow looks for a UiBanner ('' = never). */
   bannerPath: string;
+  /**
+  * Input action that toggles pause (declare it in `input{}`; undeclared is
+  * fine and means pause is API-only).
+  */
+  pauseAction: string;
+  /**
+  * A node shown while paused and hidden otherwise — a `UiPanel` of buttons in
+  * practice. '' turns the whole thing off.
+  *
+  * This lives here rather than in each game because it is identical in all of
+  * them, and a pause menu that costs a script is a pause menu no generated
+  * game will have. `UiPanel` appeared in zero template scenes before this.
+  */
+  pausePanelPath: string;
   state: GameFlowState;
   private frozeScale;
+  override onReady(): void;
+  /** The panel follows the state; nothing else may own its visibility. */
+  private syncPausePanel;
   gameOver(text?: string, color?: string): void;
   win(text?: string, color?: string): void;
   pause(): void;
@@ -685,6 +702,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-BQOeAid6.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-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-CwYxzZKl.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-CLPFv99o.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-BQOeAid6.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-Ds5kXLoF.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-B3vBWgVD.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-DFRbG0Bj.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-CwYxzZKl.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.43.0";
+//#endregion
+export { findPath as a, preloadUrls as i, newUid as n, gridFromRows as o, assetUrls as r, VERSION as t };