incanto 0.69.0 → 0.71.0

package/templates-app/village-quest-3d/tsconfig.json

@@ -9,5 +9,5 @@
     "resolveJsonModule": true,
     "types": ["vite/client", "node"]
   },
-  "include": ["src", "verify.ts"]
+  "include": ["src", "verify.ts", "vite.config.ts"]
 }

package/templates-app/village-quest-3d/verify.ts

@@ -62,6 +62,16 @@ function walkTo(
   const inputToWorld = Math.atan2(after[1] - before[1], after[0] - before[0]);
 
   for (let f = 0; f < budget && dist() > within; f++) {
+    /*
+     * A frozen clock is an ANSWER, not a slow walk.
+     *
+     * `GameFlow` sets `timeScale = 0` the moment the run is won or lost, and
+     * `engine.step()` then advances nothing. Without this the loop burns its
+     * whole budget on no-ops and the harness reports "the player cannot reach
+     * it on foot" about a player who has already WON — measured, 1100 of 1200
+     * steps were no-ops and the run ended `flow=won` one metre short.
+     */
+    if (ctx.engine.timeScale === 0) break;
     const here = at();
     const want = Math.atan2(target[1] - here[1], target[0] - here[0]);
     const aim = want - inputToWorld;
@@ -69,6 +79,7 @@ function walkTo(
     ctx.engine.step();
   }
   ctx.engine.input.setActionVector('move', 0, 0);
+  if (ctx.engine.timeScale === 0) return; // the run ended while we were walking
   for (let i = 0; i < 10; i++) ctx.engine.step();
   if (dist() > within) {
     throw new Error(
@@ -273,7 +284,9 @@ const ok = (label: string, cond: boolean): void => {
   resetQuest();
   const boot = async (): Promise<Engine> => {
     const engine = new Engine({ seed: 42, scheduler: () => () => {} });
-    engine.setScene(loadScene(structuredClone(villageJson) as Parameters<typeof loadScene>[0]));
+    engine.setScene(
+      loadScene(structuredClone(villageJson) as Parameters<typeof loadScene>[0], { engine }),
+    );
     await enablePhysics3D(engine);
     return engine;
   };

package/dist/duplicate-Dj4L-5AA.js

@@ -1,22 +0,0 @@
-import { a as serializeNode, t as buildNodeJson } from "./loader-DZE7B07H.js";
-//#region src/core/scene/duplicate.ts
-function stripUids(json) {
-	const { uid: _uid, ...rest } = json;
-	return {
-		...rest,
-		children: json.children?.map(stripUids)
-	};
-}
-/**
-* Deep-clone a node subtree (detached — add it wherever you like; sibling
-* auto-rename applies on attach). Implemented as serialize → rebuild so a
-* duplicate is exactly what would survive a save/load round-trip — EXCEPT
-* uids: clones are new entities and get a fresh identity (no uid), so
-* duplicating a uid'd template can never mint colliding ids. Names ARE
-* kept — rename clones you need to look up individually.
-*/
-function duplicateNode(node) {
-	return buildNodeJson(stripUids(serializeNode(node)));
-}
-//#endregion
-export { duplicateNode as t };

package/dist/json-CwwhxQgb.js

@@ -1,36 +0,0 @@
-import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-//#region src/core/json.ts
-var json_exports = /* @__PURE__ */ __exportAll({
-	jsonClone: () => jsonClone,
-	jsonEquals: () => jsonEquals,
-	jsonKind: () => jsonKind
-});
-function jsonKind(value) {
-	if (value === null) return "null";
-	if (Array.isArray(value)) return "array";
-	const t = typeof value;
-	if (t === "string" || t === "number" || t === "boolean") return t;
-	return "object";
-}
-/** Deep structural equality over JSON values (used for delta-only serialization). */
-function jsonEquals(a, b) {
-	if (a === b) return true;
-	if (Array.isArray(a) && Array.isArray(b)) return a.length === b.length && a.every((v, i) => jsonEquals(v, b[i]));
-	if (a !== null && b !== null && typeof a === "object" && typeof b === "object") {
-		if (Array.isArray(a) || Array.isArray(b)) return false;
-		const ka = Object.keys(a);
-		const kb = Object.keys(b);
-		return ka.length === kb.length && ka.every((k) => k in b && jsonEquals(a[k], b[k]));
-	}
-	return false;
-}
-/**
-* Deep clone of JSON-safe data (defaults must never be shared between
-* instances). The value must contain only JSON types.
-*/
-function jsonClone(value) {
-	if (value === null || typeof value !== "object") return value;
-	return JSON.parse(JSON.stringify(value));
-}
-//#endregion
-export { json_exports as i, jsonEquals as n, jsonKind as r, jsonClone as t };

package/dist/registry-CF70EArN.js

@@ -1,212 +0,0 @@
-import { t as IncantoError } from "./errors-BpWbnbb_.js";
-import { r as jsonKind, t as jsonClone } from "./json-CwwhxQgb.js";
-//#region src/core/prop-range.ts
-function describe(range) {
-	const { min, max, exclusiveMin, allow } = range;
-	let body;
-	if (min !== void 0 && max !== void 0) body = `${min}..${max}`;
-	else if (min !== void 0) body = exclusiveMin ? `greater than ${min}` : `at least ${min}`;
-	else if (max !== void 0) body = `at most ${max}`;
-	else body = "a finite number";
-	return allow && allow.length > 0 ? `${body} (or ${allow.join(", ")})` : body;
-}
-/**
-* Throws `PROP_TYPE_MISMATCH` when a number falls outside its documented range.
-*
-* A non-number is ignored: the kind check has already run and reporting the
-* same value twice, under two codes, tells its reader nothing new.
-*
-* @param value the authored value
-* @param label `Type.prop`, for the message
-* @param range what the prop documents
-*/
-function validatePropRange(value, label, range) {
-	if (typeof value !== "number") return;
-	if (range.allow?.includes(value)) return;
-	if (!Number.isFinite(value)) throw new IncantoError("PROP_TYPE_MISMATCH", `Prop '${label}' must be a finite number, got ${value}.`, { prop: label });
-	const belowMin = range.min !== void 0 && (range.exclusiveMin ? value <= range.min : value < range.min);
-	const aboveMax = range.max !== void 0 && value > range.max;
-	if (!belowMin && !aboveMax) return;
-	throw new IncantoError("PROP_TYPE_MISMATCH", `Prop '${label}' must be ${describe(range)}, got ${value}.`, { prop: label });
-}
-//#endregion
-//#region src/core/registry.ts
-/**
-* Validate a prop value against its schema default:
-* - JSON kind must match (unless the default is null = "any")
-* - numbers must be finite (NaN/Infinity corrupt JSON files)
-* - non-empty default arrays are FIXED templates: same length, element-wise match
-*   (empty default arrays are unconstrained — variable-length lists)
-*/
-function validatePropValue(value, def, at, options) {
-	if (options && typeof value === "string" && !options.includes(value)) throw new IncantoError("PROP_TYPE_MISMATCH", `Prop '${at}' is ${JSON.stringify(value)}, which is not one of: ${options.map((o) => JSON.stringify(o)).join(", ")}.`, {
-		prop: at,
-		validOptions: [...options]
-	});
-	const expected = jsonKind(def);
-	if (expected === "null") return;
-	const actual = jsonKind(value);
-	if (actual !== expected) throw new IncantoError("PROP_TYPE_MISMATCH", `Prop '${at}' expects ${expected} (default ${JSON.stringify(def)}), got ${actual} (${JSON.stringify(value)}).`, { prop: at });
-	if (typeof value === "number" && !Number.isFinite(value)) throw new IncantoError("PROP_TYPE_MISMATCH", `Prop '${at}' is ${value} — props must be finite numbers.`, { prop: at });
-	if (Array.isArray(def) && Array.isArray(value) && def.length > 0) {
-		if (value.length !== def.length) throw new IncantoError("PROP_TYPE_MISMATCH", `Prop '${at}' expects an array of length ${def.length} (default ${JSON.stringify(def)}), got length ${value.length}.`, { prop: at });
-		for (let i = 0; i < def.length; i++) validatePropValue(value[i], def[i], `${at}[${i}]`);
-	}
-}
-/**
-* Global node-type registry (Godot's ClassDB role).
-*
-* Registration is EXPLICIT — never an import-time side effect, so
-* `sideEffects: false` tree-shaking can never silently drop node types.
-*/
-const types = /* @__PURE__ */ new Map();
-function registerNode(ctor, opts) {
-	const existing = types.get(ctor.typeName);
-	if (existing && existing !== ctor && !opts?.replace) throw new IncantoError("DUPLICATE_NODE_TYPE", `Node type '${ctor.typeName}' is already registered by a different class. Replacing an implementation (e.g. under hot reload) needs registerNode(ctor, { replace: true }).`, { nodeType: ctor.typeName });
-	types.set(ctor.typeName, ctor);
-}
-function getNodeType(typeName) {
-	const ctor = types.get(typeName);
-	if (!ctor) {
-		const registered = [...types.keys()];
-		throw new IncantoError("UNKNOWN_NODE_TYPE", `Unknown node type '${typeName}'. Registered types: [${registered.join(", ")}].` + missingRegistrarHint(typeName), {
-			nodeType: typeName,
-			validOptions: registered
-		});
-	}
-	return ctor;
-}
-/**
-* "Unknown node type 'Node2D'" next to a list with no 2D types in it is the
-* most confusing error this engine can produce: the type is not misspelled and
-* not missing — a REGISTRAR was never called. Say which one.
-*
-* The case that produced this: the multiplayer boot registers `registerNodesNet()`
-* and loads a 2D scene, which dies on its own root node.
-*/
-function missingRegistrarHint(typeName) {
-	const suffix = typeName.endsWith("2D") ? "2D" : typeName.endsWith("3D") ? "3D" : "";
-	if (!suffix || types.has(`Node${suffix}`)) return "";
-	const dim = suffix.toLowerCase();
-	return ` '${typeName}' is a ${dim} node and no ${dim} type is registered: call registerNodes${suffix}() (from 'incanto/${dim}') before loading the scene — createGame${suffix}() does it for you. Registrars compose: a multiplayer game calls registerNodes${suffix}() AND registerNodesNet().`;
-}
-function registeredTypes() {
-	return [...types.keys()];
-}
-/** Test isolation helper. */
-function clearRegistry() {
-	types.clear();
-}
-/**
-* Effective prop schema for a type: own static `props` merged over every
-* ancestor's (subclass keys win).
-*/
-function getNodeSchema(typeName) {
-	return mergeStaticProps(getNodeType(typeName));
-}
-/** Walk a constructor's prototype chain collecting static `signals` (deduped). */
-function mergeStaticSignals(ctor) {
-	const out = [];
-	let current = ctor;
-	while (current) {
-		if (Object.hasOwn(current, "signals") && current.signals) out.unshift(...current.signals);
-		const parent = Object.getPrototypeOf(current);
-		current = typeof parent === "function" ? parent : null;
-	}
-	return [...new Set(out)];
-}
-/** Every signal a registered type declares (its own + inherited). */
-function getNodeSignals(typeName) {
-	return mergeStaticSignals(getNodeType(typeName));
-}
-/** Walk a constructor's prototype chain merging static `props` (subclass wins). */
-function mergeStaticProps(ctor) {
-	const chain = [];
-	let current = ctor;
-	while (current) {
-		if (Object.hasOwn(current, "props") && current.props) chain.unshift(current.props);
-		const parent = Object.getPrototypeOf(current);
-		current = typeof parent === "function" ? parent : null;
-	}
-	return Object.assign({}, ...chain);
-}
-/** Walk a constructor's prototype chain merging static `propAliases` (legacy
-* prop key → its current canonical key; subclass wins). Lets a renamed prop keep
-* loading old scenes (e.g. 2D `zIndex` → `renderOrder`) without a format bump. */
-function mergeStaticAliases(ctor) {
-	const chain = [];
-	let current = ctor;
-	while (current) {
-		if (Object.hasOwn(current, "propAliases") && current.propAliases) chain.unshift(current.propAliases);
-		const parent = Object.getPrototypeOf(current);
-		current = typeof parent === "function" ? parent : null;
-	}
-	return Object.assign({}, ...chain);
-}
-/**
-* Assign schema defaults (cloned) then the given props onto a target,
-* hard-validating every key and JSON kind. Shared by nodes and behaviors.
-* `aliases` maps legacy keys onto current ones (back-compat for renamed props).
-*/
-function applySchemaProps(target, schema, props, label, aliases = {}, extraOptions = {}) {
-	for (const [key, def] of Object.entries(schema)) target[key] = jsonClone(def.default);
-	if (props) applyGivenProps(target, schema, props, label, aliases, extraOptions);
-	requireNonEmpty(target, schema, label);
-}
-function applyGivenProps(target, schema, props, label, aliases, extraOptions) {
-	for (const [rawKey, value] of Object.entries(props)) {
-		const key = schema[rawKey] ? rawKey : aliases[rawKey] ?? rawKey;
-		const def = schema[key];
-		if (!def) {
-			const valid = Object.keys(schema);
-			throw new IncantoError("UNKNOWN_PROP", `Unknown prop '${rawKey}' on '${label}'. Valid props: [${valid.join(", ")}].`, {
-				prop: rawKey,
-				nodeType: label,
-				validOptions: valid
-			});
-		}
-		const extra = extraOptions[key];
-		const options = def.options && extra && extra.length > 0 ? [...def.options, ...extra] : def.options;
-		validatePropValue(value, def.default, `${label}.${key}`, options);
-		if (def.range) validatePropRange(value, `${label}.${key}`, def.range);
-		target[key] = jsonClone(value);
-	}
-}
-function requireNonEmpty(target, schema, label) {
-	for (const [key, def] of Object.entries(schema)) {
-		if (!def.required) continue;
-		if (!isEmptyValue(target[key])) continue;
-		throw new IncantoError("PROP_TYPE_MISMATCH", `'${label}' needs a "${key}" — it is empty.`, {
-			prop: key,
-			nodeType: label
-		});
-	}
-}
-/**
-* "Not a configuration" — what `required` refuses.
-*
-* The first cut only knew about `''`, which is what the two props that
-* introduced the flag hold. Three of the ones declared since default to an
-* ARRAY — `MoveTo.to`, `Patrol.points`, `WaveSpawner.waves` — and for those the
-* flag was inert: a `MoveTo` with no `to` loaded clean and moved nowhere, which
-* is exactly the failure the flag was added to stop. Found by running the
-* shipped package as a consumer instead of trusting the declaration.
-*/
-function isEmptyValue(value) {
-	if (value === "" || value === void 0 || value === null) return true;
-	if (Array.isArray(value)) return value.length === 0;
-	if (typeof value === "object") return Object.keys(value).length === 0;
-	return false;
-}
-/**
-* Instantiate a registered type, assign schema defaults (cloned), then the
-* given props — validating every key and its JSON kind against the default.
-*/
-function createNode(typeName, props, extraOptions) {
-	const ctor = getNodeType(typeName);
-	const node = new ctor();
-	applySchemaProps(node, getNodeSchema(typeName), props, typeName, mergeStaticAliases(ctor), extraOptions);
-	return node;
-}
-//#endregion
-export { getNodeSignals as a, mergeStaticSignals as c, getNodeSchema as i, registerNode as l, clearRegistry as n, getNodeType as o, createNode as r, mergeStaticProps as s, applySchemaProps as t, registeredTypes as u };

package/dist/rolldown-runtime-D7D4PA-g.js

@@ -1,13 +0,0 @@
-//#region \0rolldown/runtime.js
-var __defProp = Object.defineProperty;
-var __exportAll = (all, no_symbols) => {
-	let target = {};
-	for (var name in all) __defProp(target, name, {
-		get: all[name],
-		enumerable: true
-	});
-	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
-	return target;
-};
-//#endregion
-export { __exportAll as t };