incanto 0.74.0 → 0.76.0

package/dist/{picking-BMV34Pjl.js → picking-DIwE48sU.js}

@@ -1,7 +1,7 @@
-import { _ as AudioPlayer } from "./register-CjociOtt.js";
+import { i as worldPosition } from "./pose-ByFB_J3O.js";
+import { y as AudioPlayer } from "./register-B768Qedj.js";
 import { i as logReport, o as parseDrive } from "./webgl-unavailable-C8aDbGmR.js";
 import { a as frameSignature, i as frameImage, o as frameStats } from "./frame-report-D-_7YF2G.js";
-import { et as worldPosition } from "./gameplay-Bxe1sMVT.js";
 //#region src/core/audio-errors.ts
 /** Every AudioPlayer under `root` whose source could not be played. */
 function audioErrors(root) {
@@ -359,11 +359,14 @@ async function openBundledEditor(opts) {
 				await opts.play(working, camera);
 			}, "starting the game…");
 		},
-		...opts.exit ? { onExit: () => crossFade(async () => {
-			handle?.dispose();
-			handle = null;
-			await opts.exit?.();
-		}, "back to the game…") } : {}
+		...opts.exit ? { onExit: () => {
+			const working = handle?.working();
+			return crossFade(async () => {
+				handle?.dispose();
+				handle = null;
+				await opts.exit?.(working);
+			}, "back to the game…");
+		} } : {}
 	});
 }
 /**

package/dist/{save-slots-CEUGeLuB.js → pose-ByFB_J3O.js}

@@ -425,10 +425,12 @@ function nodeRefWarnings(scene, opts = {}) {
 			if (!bag) continue;
 			for (const key of propKeys) {
 				const value = bag[key];
-				if (typeof value !== "string" || value === "") continue;
-				const result = resolveRefInJson(root, at, value);
-				if (result.ok) continue;
-				warnings.push(`${path}: ${prefix}${key} — ${describeRefProblem(result.problem, value)} ` + (opts.fragment ? "This path leaves the fragment — only the host scene that instances it can answer, so this is fine if it resolves there and a typo if it does not." : "The scene loads and the prop does nothing."));
+				const entries = Array.isArray(value) ? value.flatMap((v, i) => typeof v === "string" && v !== "" ? [[`${key}[${i}]`, v]] : []) : typeof value === "string" && value !== "" ? [[key, value]] : [];
+				for (const [where, ref] of entries) {
+					const result = resolveRefInJson(root, at, ref);
+					if (result.ok) continue;
+					warnings.push(`${path}: ${prefix}${where} — ${describeRefProblem(result.problem, ref)} ` + (opts.fragment ? "This path leaves the fragment — only the host scene that instances it can answer, so this is fine if it resolves there and a typo if it does not." : "The scene loads and the prop does nothing."));
+				}
 			}
 		}
 		(node.children ?? []).forEach((child, i) => {
@@ -1231,6 +1233,16 @@ function hasDom() {
 	return typeof document !== "undefined";
 }
 /**
+* Is this widget switched off?
+*
+* `disabled` belongs to the widgets that can be pressed (`UiButton` today), not
+* to the base, so this asks rather than declares — a widget that grows the prop
+* later is out of the ring the day it does.
+*/
+function isDisabled(widget) {
+	return widget.disabled === true;
+}
+/**
 * The overlay container. One per scene is plenty; widgets mount into its
 * anchor slots. `zIndex` lifts it above game canvases; the layer never eats
 * pointer events (widgets that need clicks opt in individually).
@@ -1245,11 +1257,26 @@ var HudLayer = class HudLayer extends Node {
 		* layer, Enter / A activates. OFF by default — a game whose HUD has a
 		* button must not lose its arrow keys the moment one exists.
 		*/
-		focusNavigation: { default: false }
+		focusNavigation: { default: false },
+		/**
+		* Cinematic bars: the fraction of the layer's height each bar covers,
+		* 0..0.5, drawn full-bleed at the top and bottom edges over every widget.
+		* Two `UiPanel`s could not do this — they sit in anchor slots, inside the
+		* layer's padding, above the dialogue box. Animate it from a behaviour.
+		*/
+		letterbox: {
+			default: 0,
+			range: {
+				min: 0,
+				max: .5
+			}
+		}
 	};
 	zIndex = 100;
 	visible = true;
 	focusNavigation = false;
+	letterbox = 0;
+	bars = null;
 	/** @internal root overlay element (null headless). */
 	_element = null;
 	slots = /* @__PURE__ */ new Map();
@@ -1285,10 +1312,28 @@ var HudLayer = class HudLayer extends Node {
 		this._element = null;
 		this.slots.clear();
 	}
+	/** The two bars, made on first use and sized every frame from `letterbox`. */
+	_syncLetterbox() {
+		const el = this._element;
+		if (!el) return;
+		if (!this.bars) {
+			const make = (edge) => {
+				const bar = document.createElement("div");
+				bar.dataset.incantoLetterbox = edge;
+				bar.style.cssText = `position:absolute;left:0px;right:0px;${edge}:0px;height:0%;background:#000;pointer-events:none;z-index:1000;`;
+				el.appendChild(bar);
+				return bar;
+			};
+			this.bars = [make("top"), make("bottom")];
+		}
+		const pct = `${Math.round(Math.min(.5, Math.max(0, this.letterbox)) * 1e4) / 100}%`;
+		for (const bar of this.bars) if (bar.style.height !== pct) bar.style.height = pct;
+	}
 	update() {
 		if (this._element) {
 			this._mount();
 			this._element.style.display = this.visible ? "" : "none";
+			this._syncLetterbox();
 		}
 		if (this.focusNavigation && this.ownsFocus()) this.stepFocus();
 	}
@@ -1382,7 +1427,7 @@ var HudLayer = class HudLayer extends Node {
 		if (!this.visible) return out;
 		const walk = (node) => {
 			if (node instanceof HudWidgetBase && !node.visible) return;
-			if (node instanceof HudWidgetBase && node.focusable) out.push(node);
+			if (node instanceof HudWidgetBase && node.focusable && !isDisabled(node)) out.push(node);
 			for (const child of node.children) walk(child);
 		};
 		walk(this);
@@ -2683,7 +2728,8 @@ var InputMap = class {
 				const now = this.pointerPosition();
 				const movedX = was && now ? now.x - was.x : 0;
 				const movedY = was && now ? now.y - was.y : 0;
-				this.handlePointerMove(e.movementX ?? movedX, e.movementY ?? movedY);
+				const native = document.pointerLockElement === target || e.pointerType === void 0 || e.pointerType === "mouse";
+				this.handlePointerMove(native ? e.movementX ?? movedX : movedX, native ? e.movementY ?? movedY : movedY);
 			}
 		};
 		const onCancel = (e) => {
@@ -5041,8 +5087,9 @@ function wireConnections(root, connections, declareSignals = false) {
 			}
 			fn.apply(self, args);
 		};
-		const listener = (...args) => {
-			if (conn.filter && !matchesFilter(args[0], conn.filter)) return;
+		const listener = (...emitted) => {
+			if (conn.filter && !matchesFilter(emitted[0], conn.filter)) return;
+			const args = conn.args ? [...conn.args] : emitted;
 			if (conn.once) fromNode.off(conn.signal, listener);
 			try {
 				const fn = toNode[conn.handler];
@@ -5128,7 +5175,8 @@ const CONNECTION_KEYS = [
 	"to",
 	"handler",
 	"once",
-	"filter"
+	"filter",
+	"args"
 ];
 /** …and every key its `filter` may carry. */
 const FILTER_KEYS = ["group", "tag"];
@@ -5156,6 +5204,7 @@ function validateConnectionShape(conn) {
 		});
 	}
 	if (raw.once !== void 0 && typeof raw.once !== "boolean") throw new IncantoError("BAD_FORMAT", `Connection ${where}: "once" is true or false, not ${JSON.stringify(raw.once)} — every non-empty string is truthy, so it would fire exactly once.`, { prop: "once" });
+	if (raw.args !== void 0 && !Array.isArray(raw.args)) throw new IncantoError("BAD_FORMAT", `Connection ${where}: "args" is a LIST of the arguments to call the handler with, not ${JSON.stringify(raw.args)} — write ["ENRAGED"] rather than "ENRAGED".`, { prop: "args" });
 	if (raw.filter === void 0) return;
 	if (typeof raw.filter !== "object" || raw.filter === null || Array.isArray(raw.filter)) throw new IncantoError("BAD_FORMAT", `Connection ${where}: "filter" is {group?, tag?}, not ${JSON.stringify(raw.filter)} — a filter the matcher cannot read passes EVERYTHING.`, { prop: "filter" });
 	const filter = raw.filter;
@@ -5755,4 +5804,161 @@ function savesWithoutUid(root) {
 	return out;
 }
 //#endregion
-export { parseNodePath as $, SceneTree as A, HudLayer as B, sunDirectionFromSky as C, computeViewport as D, resolveConstants as E, resolveOrderGroups as F, UiText as G, TAPPABLE as H, InputMap as I, Node as J, requireNumber as K, handlerShadowWarnings as L, resetMemorySaves as M, ORDER_GROUP_BASE as N, resolveViewport as O, effectiveOrder as P, resolveRefInJson as Q, sceneDimension as R, sunDirectionFromElevationAzimuth as S, isConstRef as T, UiBanner as U, HudWidgetBase as V, UiBar as W, describeRefProblem as X, diagnose as Y, nodeRefWarnings as Z, Scene as _, restoreBehaviors as a, getBehavior as at, horizonColorFromSky as b, isCloned as c, Signal as ct, rebuildOptions as d, Behavior as et, rememberAuthoredPath as f, loader_exports as g, loadScene as h, captureBehaviors as i, clearBehaviors as it, createSaveStore as j, newUid as k, markCloned as l, buildSceneSubtree as m, SaveSlots as n, behaviorSchema as nt, savesWithoutUid as o, registerBehavior as ot, stripUids as p, requireText as q, behaviorsWithoutSave as r, behaviorSignals as rt, duplicateNode as s, registeredBehaviors as st, ENGINE_STATE_KEY as t, StubBehavior as tt, markTemplateName as u, serializeNode as v, CONST_REF_KEY as w, parseEnvironment3D as x, SCENE_FORMAT as y, FITS$1 as z };
+//#region src/core/pose.ts
+/** Duck-type test: every spatial node (Node2D/Node3D) exposes `position: number[]`. */
+function hasPosition(node) {
+	return Array.isArray(node.position);
+}
+const DEG = Math.PI / 180;
+/** Rotation matrix (row-major 3×3) of an Euler XYZ triple in degrees — three's 'XYZ' order. */
+function mat3FromEuler(rot) {
+	const a = (rot[0] ?? 0) * DEG;
+	const b = (rot[1] ?? 0) * DEG;
+	const c = (rot[2] ?? 0) * DEG;
+	const ca = Math.cos(a);
+	const sa = Math.sin(a);
+	const cb = Math.cos(b);
+	const sb = Math.sin(b);
+	const cc = Math.cos(c);
+	const sc = Math.sin(c);
+	return [
+		cb * cc,
+		-cb * sc,
+		sb,
+		ca * sc + sa * sb * cc,
+		ca * cc - sa * sb * sc,
+		-sa * cb,
+		sa * sc - ca * sb * cc,
+		sa * cc + ca * sb * sc,
+		ca * cb
+	];
+}
+function mat3Mul(a, b) {
+	const o = new Array(9);
+	for (let r = 0; r < 3; r++) for (let c = 0; c < 3; c++) o[r * 3 + c] = a[r * 3] * b[c] + a[r * 3 + 1] * b[3 + c] + a[r * 3 + 2] * b[6 + c];
+	return o;
+}
+function mat3Apply(m, v) {
+	const x = v[0] ?? 0;
+	const y = v[1] ?? 0;
+	const z = v[2] ?? 0;
+	return [
+		m[0] * x + m[1] * y + m[2] * z,
+		m[3] * x + m[4] * y + m[5] * z,
+		m[6] * x + m[7] * y + m[8] * z
+	];
+}
+function mat3ApplyT(m, v) {
+	const x = v[0] ?? 0;
+	const y = v[1] ?? 0;
+	const z = v[2] ?? 0;
+	return [
+		m[0] * x + m[3] * y + m[6] * z,
+		m[1] * x + m[4] * y + m[7] * z,
+		m[2] * x + m[5] * y + m[8] * z
+	];
+}
+const IDENTITY = [
+	1,
+	0,
+	0,
+	0,
+	1,
+	0,
+	0,
+	0,
+	1
+];
+/**
+* The pose of `node`'s PARENT frame in world space, composed through every
+* spatial ancestor — position AND rotation. It used to sum positions only, so
+* a child two metres down +z of a hull turned 90° was reported at world +z,
+* where nothing was drawn: the renderer composes the parent's rotation, and
+* every reader of this helper (a turret's muzzle, a camera under a rig, a
+* guard's eyes) disagreed with the picture by exactly that turn.
+*/
+function parentPose(node) {
+	const chain = [];
+	for (let at = node.parent; at; at = at.parent) if (hasPosition(at)) chain.push(at);
+	const position = [
+		0,
+		0,
+		0
+	];
+	let rot3 = IDENTITY;
+	let angle2 = 0;
+	for (let i = chain.length - 1; i >= 0; i--) {
+		const n = chain[i];
+		const local = n.position;
+		if (local.length >= 3) {
+			const moved = mat3Apply(rot3, local);
+			position[0] = (position[0] ?? 0) + (moved[0] ?? 0);
+			position[1] = (position[1] ?? 0) + (moved[1] ?? 0);
+			position[2] = (position[2] ?? 0) + (moved[2] ?? 0);
+			if (Array.isArray(n.rotation)) rot3 = mat3Mul(rot3, mat3FromEuler(n.rotation));
+		} else {
+			const a = angle2 * DEG;
+			const x = local[0] ?? 0;
+			const y = local[1] ?? 0;
+			position[0] = (position[0] ?? 0) + x * Math.cos(a) - y * Math.sin(a);
+			position[1] = (position[1] ?? 0) + x * Math.sin(a) + y * Math.cos(a);
+			if (typeof n.rotation === "number") angle2 += n.rotation;
+		}
+	}
+	return {
+		position,
+		rot3,
+		angle2
+	};
+}
+/** The node's position in WORLD space — its parents' positions and rotations composed. */
+function worldPosition(node) {
+	const own = node.position;
+	if (!Array.isArray(own)) return [];
+	const p = parentPose(node);
+	if (own.length >= 3) {
+		const moved = mat3Apply(p.rot3, own);
+		return [
+			(p.position[0] ?? 0) + (moved[0] ?? 0),
+			(p.position[1] ?? 0) + (moved[1] ?? 0),
+			(p.position[2] ?? 0) + (moved[2] ?? 0)
+		];
+	}
+	const a = p.angle2 * DEG;
+	const x = own[0] ?? 0;
+	const y = own[1] ?? 0;
+	return [(p.position[0] ?? 0) + x * Math.cos(a) - y * Math.sin(a), (p.position[1] ?? 0) + x * Math.sin(a) + y * Math.cos(a)];
+}
+/**
+* A LOCAL vector turned into world space by the node's own rotation and every
+* ancestor's — a barrel's forward, a muzzle's offset, a hardpoint's direction.
+*
+* `worldPosition` answers where a node IS; this answers which way it points,
+* and two games wrote it by hand (a tank's `forwardOf`, an artillery piece's
+* barrel tip) because nothing else could say it. `worldDirection(node, [0,0,1])`
+* is the +Z-forward convention every 3D skin in this engine follows.
+*/
+function worldDirection(node, local) {
+	const p = parentPose(node);
+	const own = node.rotation;
+	if (local.length >= 3 || Array.isArray(own)) return mat3Apply(Array.isArray(own) ? mat3Mul(p.rot3, mat3FromEuler(own)) : p.rot3, local);
+	const a = (p.angle2 + (typeof own === "number" ? own : 0)) * DEG;
+	const x = local[0] ?? 0;
+	const y = local[1] ?? 0;
+	return [x * Math.cos(a) - y * Math.sin(a), x * Math.sin(a) + y * Math.cos(a)];
+}
+/** The local `position` that puts `node` at `world` — the inverse of `worldPosition`. */
+function localFromWorld(node, world) {
+	const p = parentPose(node);
+	if (world.length >= 3) return mat3ApplyT(p.rot3, [
+		(world[0] ?? 0) - (p.position[0] ?? 0),
+		(world[1] ?? 0) - (p.position[1] ?? 0),
+		(world[2] ?? 0) - (p.position[2] ?? 0)
+	]);
+	const a = -p.angle2 * DEG;
+	const x = (world[0] ?? 0) - (p.position[0] ?? 0);
+	const y = (world[1] ?? 0) - (p.position[1] ?? 0);
+	return [x * Math.cos(a) - y * Math.sin(a), x * Math.sin(a) + y * Math.cos(a)];
+}
+//#endregion
+export { Node as $, isConstRef as A, resolveOrderGroups as B, serializeNode as C, sunDirectionFromElevationAzimuth as D, parseEnvironment3D as E, SceneTree as F, HudLayer as G, handlerShadowWarnings as H, createSaveStore as I, UiBanner as J, HudWidgetBase as K, resetMemorySaves as L, computeViewport as M, resolveViewport as N, sunDirectionFromSky as O, newUid as P, requireText as Q, ORDER_GROUP_BASE as R, Scene as S, horizonColorFromSky as T, sceneDimension as U, InputMap as V, FITS$1 as W, UiText as X, UiBar as Y, requireNumber as Z, stripUids as _, ENGINE_STATE_KEY as a, Behavior as at, loadScene as b, captureBehaviors as c, behaviorSignals as ct, duplicateNode as d, registerBehavior as dt, diagnose as et, isCloned as f, registeredBehaviors as ft, rememberAuthoredPath as g, rebuildOptions as h, worldPosition as i, parseNodePath as it, resolveConstants as j, CONST_REF_KEY as k, restoreBehaviors as l, clearBehaviors as lt, markTemplateName as m, localFromWorld as n, nodeRefWarnings as nt, SaveSlots as o, StubBehavior as ot, markCloned as p, Signal as pt, TAPPABLE as q, worldDirection as r, resolveRefInJson as rt, behaviorsWithoutSave as s, behaviorSchema as st, hasPosition as t, describeRefProblem as tt, savesWithoutUid as u, getBehavior as ut, buildNodeJson as v, SCENE_FORMAT as w, loader_exports as x, buildSceneSubtree as y, effectiveOrder as z };

package/dist/react.d.ts

@@ -1,5 +1,5 @@
-import { P as Scene, b as Engine, n as BehaviorCtor } from "./behavior-J1cmVah0.js";
-import { c as JsonValue } from "./rng-Bb-IutXB.js";
+import { P as Scene, b as Engine, n as BehaviorCtor } from "./behavior-B_245qRy.js";
+import { c as JsonValue } from "./rng-BsXZg3D6.js";
 import { CSSProperties, ReactNode } from "react";
 
 //#region src/react/index.d.ts

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-BAiA-FjP.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-ssvGvP7W.js").then((n) => n.n)).createGame2D(o)))(opts);
+			const next = await (_gameFactory ?? (mode === "3d" ? async (o) => (await import("./create-game-Dai5vfVu.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-BMIPKrQW.js").then((n) => n.n)).createGame2D(o)))(opts);
 			if (disposed) {
 				next.dispose();
 				return;