incanto 0.56.0 → 0.58.0

package/templates-app/star-survivor/verify.ts

@@ -0,0 +1,193 @@
+/**
+ * Headless proof that Hollow Horde actually PLAYS — the browserless half of the
+ * agent loop (author → VERIFY → fix). Drives the real `game.scene.json` through
+ * `incanto/test`'s `runScript` at a fixed, seeded timestep and asserts the survivor
+ * loop end to end:
+ *
+ *   MOVE   — holding `move` walks the player (top-down CharacterBody2D).
+ *   ATTACK — the auto-attack fires bolts at a nearby enemy; the enemy DIES, which
+ *            drops an XP shard (group 'xp') and tallies a kill (EnemyDrop).
+ *   LEVEL  — gaining XP raises the level (and headlessly auto-takes an upgrade).
+ *   WIN    — surviving the clock sets the score to scoreToWin → ScoreKeeper `won`.
+ *   LOSE   — draining the player's Health to 0 → `died` → loseLife → `lost`.
+ *
+ * Run with `bun verify.ts` (or `bun run verify`).
+ */
+import type { Node } from 'incanto';
+import { registerBehavior } from 'incanto';
+import { auditScene, registerAllNodes, runScript } from 'incanto/test';
+import { Director, EnemyDrop, EnemyFace, GridFloor, Survivor } from './src/behaviors';
+import sceneJson from './src/game.scene.json';
+
+const behaviors = { Survivor, Director, EnemyDrop, EnemyFace, GridFloor };
+
+const ok = (label: string, cond: boolean): void => {
+  if (!cond) {
+    console.error(`FAIL: ${label}`);
+    process.exitCode = 1;
+  } else {
+    console.log(`pass: ${label}`);
+  }
+};
+
+// ---- AUDIT ---------------------------------------------------------------------------
+// The check that fails on a WARNING, not just an error. Three of the five
+// shipped templates had no audit block, which is how every one of them came to
+// ship a scene whose saveable state had no uid to key it under: the save came
+// back empty, the load reported no problem, and nothing here asked.
+{
+  registerAllNodes();
+  for (const [name, ctor] of Object.entries(behaviors)) {
+    registerBehavior(name, ctor as never, { replace: true });
+  }
+  const warnings = auditScene(sceneJson as unknown as Parameters<typeof auditScene>[0]);
+  ok(`auditScene is clean (${warnings.length} warnings)`, warnings.length === 0);
+  for (const w of warnings) console.error(`  warn: ${w}`);
+}
+
+interface Vec {
+  position: number[];
+}
+interface SurvivorB {
+  kills: number;
+  level: number;
+  elapsed: number;
+  addXp(n: number): void;
+}
+interface HealthB {
+  kill(): void;
+}
+
+// ---- MOVE --------------------------------------------------------------------
+{
+  let startX = 0;
+  let moved = false;
+  await runScript(sceneJson, {
+    durationMs: 1200,
+    seed: 1,
+    behaviors,
+    steps: [
+      {
+        atMs: 100,
+        do: (ctx) => {
+          startX = (ctx.getNode('Player') as unknown as Vec).position[0] ?? 0;
+        },
+      },
+      { atMs: 150, vector: ['move', 1, 0] },
+      {
+        atMs: 900,
+        label: 'holding move walked the player',
+        do: (ctx) => {
+          moved = ((ctx.getNode('Player') as unknown as Vec).position[0] ?? 0) > startX + 40;
+        },
+      },
+    ],
+  });
+  ok('holding move walked the player', moved);
+}
+
+// ---- AUTO-ATTACK kills an enemy → XP drop + kill tally ------------------------
+{
+  let kills = 0;
+  let xpShards = 0;
+  const result = await runScript(sceneJson, {
+    durationMs: 5000,
+    seed: 2,
+    behaviors,
+    steps: [
+      {
+        atMs: 300,
+        label: 'spawn a goblin in attack range so the auto-attack cuts it down',
+        do: (ctx) => {
+          const player = ctx.getNode('Player') as unknown as Vec & { behavior: SurvivorB };
+          // turn the magnet off so the dropped shard lingers in the world for the assert
+          (player.behavior as unknown as { magnet: number }).magnet = 0;
+          const spawner = ctx.getNode('GoblinSpawner').behavior as unknown as {
+            spawn(): Node | null;
+          };
+          const enemy = spawner.spawn() as unknown as Vec | null;
+          if (enemy) enemy.position = [(player.position[0] ?? 0) + 200, player.position[1] ?? 0];
+          for (let i = 0; i < 260; i++) {
+            if ((player.behavior as unknown as SurvivorB).kills >= 1) break;
+            ctx.engine.step();
+          }
+          kills = (player.behavior as unknown as SurvivorB).kills;
+          xpShards = ctx.scene.tree.getNodesInGroup('xp').length;
+        },
+      },
+    ],
+  });
+  ok('the auto-attack killed an enemy', kills >= 1);
+  ok('a dead enemy dropped an XP shard', xpShards >= 1);
+  ok('runScript reported no failures (attack path)', result.ok);
+}
+
+// ---- XP → LEVEL UP -----------------------------------------------------------
+{
+  let leveled = false;
+  await runScript(sceneJson, {
+    durationMs: 800,
+    seed: 3,
+    behaviors,
+    steps: [
+      {
+        atMs: 200,
+        label: 'gaining XP raises the level',
+        do: (ctx) => {
+          const s = ctx.getNode('Player').behavior as unknown as SurvivorB;
+          const before = s.level;
+          s.addXp(60);
+          leveled = s.level > before;
+        },
+      },
+    ],
+  });
+  ok('gaining XP raised the level', leveled);
+}
+
+// ---- WIN (survive the clock) -------------------------------------------------
+{
+  let won = 0;
+  await runScript(sceneJson, {
+    durationMs: 1200,
+    seed: 4,
+    behaviors,
+    steps: [
+      { atMs: 100, do: (ctx) => ctx.scene.root.on('won', () => won++) },
+      {
+        atMs: 300,
+        label: 'fast-forward the survive clock → WIN',
+        do: (ctx) => {
+          const s = ctx.getNode('Player').behavior as unknown as SurvivorB;
+          s.elapsed = 89.9;
+          for (let i = 0; i < 12 && won === 0; i++) ctx.engine.step();
+        },
+      },
+    ],
+  });
+  ok('surviving the clock emitted `won`', won === 1);
+}
+
+// ---- LOSE (HP to 0) ----------------------------------------------------------
+{
+  let lost = 0;
+  await runScript(sceneJson, {
+    durationMs: 1200,
+    seed: 5,
+    behaviors,
+    steps: [
+      { atMs: 100, do: (ctx) => ctx.scene.root.on('lost', () => lost++) },
+      {
+        atMs: 300,
+        label: 'drain the player to 0 HP → died → loseLife → lost',
+        do: (ctx) => {
+          (ctx.getNode('Player/Vitals').behavior as unknown as HealthB).kill();
+          for (let i = 0; i < 6 && lost === 0; i++) ctx.engine.step();
+        },
+      },
+    ],
+  });
+  ok('player death lost the game (`lost`)', lost === 1);
+}
+
+console.log(process.exitCode ? '\nVERIFY FAILED' : '\nVERIFY OK — Hollow Horde plays end to end');

package/templates-app/star-survivor/vite.config.ts

@@ -0,0 +1,12 @@
+import { incantoLibrary, incantoScenes } from 'incanto/vite';
+import { defineConfig } from 'vite';
+
+export default defineConfig({
+  base: './',
+  // Dev-server only, and both are why the editor is useful here:
+  // - incantoScenes(): validates every *.scene.json the moment you save it,
+  //   AND serves this project's scenes, so the editor (☰ debug ▸ edit this
+  //   scene ▸ scenes) can open, create and save any scene in the project.
+  // - incantoLibrary(): the agent8 asset catalog behind the 📚 buttons.
+  plugins: [incantoScenes(), incantoLibrary()],
+});

package/templates-app/tps-3d/package.json

@@ -13,7 +13,7 @@
     "@dimforge/rapier2d-compat": "0.19.3",
     "@dimforge/rapier3d-compat": "0.19.3",
     "@pixiv/three-vrm": "^3.5.3",
-    "incanto": "^0.56.0",
+    "incanto": "^0.58.0",
     "three": "^0.184.0"
   },
   "devDependencies": {

package/templates-app/tps-3d/src/game.scene.json

@@ -499,7 +499,8 @@
               }
             ]
           }
-        ]
+        ],
+        "uid": "n_nx7dsn65lts2arru"
       },
       {
         "name": "Camera",
@@ -647,7 +648,8 @@
                   "pitch": 0.6
                 }
               }
-            ]
+            ],
+            "uid": "n_17sotvbult7pgelw"
           }
         ]
       },
@@ -705,7 +707,8 @@
           }
         ]
       }
-    ]
+    ],
+    "uid": "n_h46qaejxdqadqc1c"
   },
   "connections": [
     {

package/templates-app/tps-3d/verify.ts

@@ -17,7 +17,8 @@
  * headlessly, so this isolates the gameplay logic.
  */
 import type { Node } from 'incanto';
-import { runScript } from 'incanto/test';
+import { registerBehavior } from 'incanto';
+import { auditScene, registerAllNodes, runScript } from 'incanto/test';
 import { HudUpdater, Shoot } from './src/behaviors';
 import sceneJson from './src/game.scene.json';
 
@@ -45,6 +46,21 @@ const ok = (label: string, cond: boolean): void => {
   }
 };
 
+// ---- AUDIT ---------------------------------------------------------------------------
+// The check that fails on a WARNING, not just an error. Three of the five
+// shipped templates had no audit block, which is how every one of them came to
+// ship a scene whose saveable state had no uid to key it under: the save came
+// back empty, the load reported no problem, and nothing here asked.
+{
+  registerAllNodes();
+  for (const [name, ctor] of Object.entries(behaviors)) {
+    registerBehavior(name, ctor as never, { replace: true });
+  }
+  const warnings = auditScene(sceneJson as unknown as Parameters<typeof auditScene>[0]);
+  ok(`auditScene is clean (${warnings.length} warnings)`, warnings.length === 0);
+  for (const w of warnings) console.error(`  warn: ${w}`);
+}
+
 // ---- MOVE + WIN path ----------------------------------------------------------
 {
   let won = 0;

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

@@ -13,7 +13,7 @@
     "@dimforge/rapier2d-compat": "0.19.3",
     "@dimforge/rapier3d-compat": "0.19.3",
     "@pixiv/three-vrm": "^3.5.3",
-    "incanto": "^0.56.0",
+    "incanto": "^0.58.0",
     "three": "^0.184.0"
   },
   "devDependencies": {

package/templates-app/village-quest-3d/src/grove.scene.json

@@ -18,7 +18,7 @@
     "shadows": {
       "mapSize": 2048
     },
-    "exposure": 1.0,
+    "exposure": 1,
     "ambient": {
       "color": "#a8b4e0",
       "intensity": 0.95
@@ -260,7 +260,7 @@
                 "props": {
                   "mesh": "sphere",
                   "size": [0.07, 0.07, 0.07],
-                  "position": [-0.1, 0.24, 1.0],
+                  "position": [-0.1, 0.24, 1],
                   "material": {
                     "color": "#ff3030",
                     "emissive": "#ff3030",
@@ -274,7 +274,7 @@
                 "props": {
                   "mesh": "sphere",
                   "size": [0.07, 0.07, 0.07],
-                  "position": [0.1, 0.24, 1.0],
+                  "position": [0.1, 0.24, 1],
                   "material": {
                     "color": "#ff3030",
                     "emissive": "#ff3030",
@@ -377,7 +377,7 @@
                 "props": {
                   "mesh": "sphere",
                   "size": [0.07, 0.07, 0.07],
-                  "position": [-0.1, 0.24, 1.0],
+                  "position": [-0.1, 0.24, 1],
                   "material": {
                     "color": "#ff3030",
                     "emissive": "#ff3030",
@@ -391,7 +391,7 @@
                 "props": {
                   "mesh": "sphere",
                   "size": [0.07, 0.07, 0.07],
-                  "position": [0.1, 0.24, 1.0],
+                  "position": [0.1, 0.24, 1],
                   "material": {
                     "color": "#ff3030",
                     "emissive": "#ff3030",
@@ -494,7 +494,7 @@
                 "props": {
                   "mesh": "sphere",
                   "size": [0.07, 0.07, 0.07],
-                  "position": [-0.1, 0.24, 1.0],
+                  "position": [-0.1, 0.24, 1],
                   "material": {
                     "color": "#ff3030",
                     "emissive": "#ff3030",
@@ -508,7 +508,7 @@
                 "props": {
                   "mesh": "sphere",
                   "size": [0.07, 0.07, 0.07],
-                  "position": [0.1, 0.24, 1.0],
+                  "position": [0.1, 0.24, 1],
                   "material": {
                     "color": "#ff3030",
                     "emissive": "#ff3030",
@@ -631,7 +631,7 @@
               "view": "free",
               "camDistance": 4.6,
               "eyeHeight": 1.1,
-              "maxSpeed": 4.0,
+              "maxSpeed": 4,
               "sprintMultiplier": 1.8,
               "pitchMin": -0.5,
               "pitchMax": 1.1,
@@ -743,7 +743,8 @@
             "max": 100,
             "invulnerableFor": 0.8
           }
-        }
+        },
+        "uid": "n_3hp4w1vicxhqr375"
       },
       {
         "name": "Camera",
@@ -768,7 +769,7 @@
           {
             "name": "Quest",
             "type": "UiText",
-            "uid": "n_gq_quest",
+            "uid": "n_nmkf915b9r8d37nf",
             "props": {
               "text": "Wolves left: 3",
               "size": 16,
@@ -779,7 +780,7 @@
           {
             "name": "HP",
             "type": "UiBar",
-            "uid": "n_gq_hp",
+            "uid": "n_kdm2vun7p0o3t4l2",
             "props": {
               "anchor": "topRight",
               "value": 100,
@@ -790,7 +791,7 @@
           {
             "name": "Banner",
             "type": "UiBanner",
-            "uid": "n_gq_banner",
+            "uid": "n_21yz0pgnwqvz81yo",
             "props": {
               "anchor": "center"
             }
@@ -798,7 +799,7 @@
           {
             "name": "Hint",
             "type": "UiText",
-            "uid": "n_gq_hint",
+            "uid": "n_dg8p7etf1n6lc495",
             "props": {
               "text": "click/F strike · Shift sprint · portal returns home",
               "size": 12,

package/templates-app/village-quest-3d/src/village.scene.json

@@ -3448,7 +3448,7 @@
           {
             "name": "Quest",
             "type": "UiText",
-            "uid": "n_vq_quest",
+            "uid": "n_ouw4yqcp59yn0xwp",
             "props": {
               "text": "@t:quest.talkElder",
               "size": 16,
@@ -3459,7 +3459,7 @@
           {
             "name": "Banner",
             "type": "UiBanner",
-            "uid": "n_vq_banner",
+            "uid": "n_rqkjlucsenuwggtc",
             "props": {
               "anchor": "center"
             }
@@ -3467,7 +3467,7 @@
           {
             "name": "Dialogue",
             "type": "UiDialogue",
-            "uid": "n_vq_dialogue",
+            "uid": "n_ui4xf7paa0mgjzmh",
             "props": {
               "anchor": "bottom",
               "charsPerSecond": 45
@@ -3476,7 +3476,7 @@
           {
             "name": "RestartBtn",
             "type": "UiButton",
-            "uid": "n_vq_restart",
+            "uid": "n_5eupths7miw4jilp",
             "props": {
               "text": "@t:ui.playAgain",
               "anchor": "bottom",
@@ -3486,7 +3486,7 @@
           {
             "name": "Hint",
             "type": "UiText",
-            "uid": "n_vq_hint",
+            "uid": "n_aoy8da41ca8tq4mr",
             "props": {
               "text": "@t:ui.hint",
               "size": 12,

package/dist/log-report-CPFm4OXf.js

@@ -1,173 +0,0 @@
-//#region src/core/drive-script.ts
-const num = (raw) => {
-	if (raw === void 0) return null;
-	const n = Number(raw);
-	return Number.isFinite(n) ? n : null;
-};
-/**
-* `vector move 0 1; step 2000` → steps, or an error naming the bad command.
-*
-* Semicolons and newlines both separate, so a whole plan fits in one shell
-* argument and a longer one fits in a file. `#` starts a comment.
-*
-* A command it does not know REFUSES THE WHOLE SCRIPT. Skipping it would leave
-* an agent looking at a frame that never moved, believing it had walked
-* somewhere — the failure mode this exists to prevent.
-*/
-function parseDrive(text) {
-	const steps = [];
-	let totalMs = 0;
-	const lines = text.split(/[;\n]/).map((l) => l.replace(/#.*$/, "").trim()).filter(Boolean);
-	for (const line of lines) {
-		const [word, ...rest] = line.split(/\s+/);
-		const bad = (why) => ({
-			steps: [],
-			error: `${why}: "${line}"`,
-			totalMs: 0
-		});
-		switch (word) {
-			case "press":
-			case "release": {
-				const action = rest[0];
-				if (!action) return bad(`${word} needs an action name`);
-				steps.push(word === "press" ? {
-					kind: "press",
-					action
-				} : {
-					kind: "release",
-					action
-				});
-				break;
-			}
-			case "vector": {
-				const action = rest[0];
-				const x = num(rest[1]);
-				const y = num(rest[2]);
-				if (!action || x === null || y === null) return bad("vector needs an action and two numbers");
-				steps.push({
-					kind: "vector",
-					action,
-					x,
-					y
-				});
-				break;
-			}
-			case "key": {
-				const code = rest[0];
-				const dir = rest[1];
-				if (!code || dir !== "down" && dir !== "up") return bad("key needs a code and down|up");
-				steps.push({
-					kind: "key",
-					code,
-					down: dir === "down"
-				});
-				break;
-			}
-			case "pointer": {
-				const dx = num(rest[0]);
-				const dy = num(rest[1]);
-				if (dx === null || dy === null) return bad("pointer needs two numbers");
-				steps.push({
-					kind: "pointer",
-					dx,
-					dy
-				});
-				break;
-			}
-			case "step": {
-				const ms = num(rest[0]);
-				if (ms === null || ms < 0) return bad("step needs a duration in ms");
-				steps.push({
-					kind: "step",
-					ms
-				});
-				totalMs += ms;
-				break;
-			}
-			default: return bad("not a command");
-		}
-	}
-	return {
-		steps,
-		error: null,
-		totalMs
-	};
-}
-//#endregion
-//#region src/core/log-report.ts
-const RANK = {
-	debug: 0,
-	info: 1,
-	warn: 2,
-	error: 3
-};
-/** Under this, with the loop running, is a frame rate somebody can feel. */
-const SLOW_FPS = 50;
-/** How many distinct messages to carry. Beyond this it is a log file, not a report. */
-const MAX_GROUPS = 20;
-/** The engine logs values, not strings — format them the way a console would. */
-function format(parts) {
-	return parts.map((p) => {
-		if (typeof p === "string") return p;
-		if (p instanceof Error) return p.message;
-		try {
-			return JSON.stringify(p);
-		} catch {
-			return String(p);
-		}
-	}).join(" ");
-}
-function logReport(input) {
-	const counts = {
-		debug: 0,
-		info: 0,
-		warn: 0,
-		error: 0
-	};
-	const byMessage = /* @__PURE__ */ new Map();
-	for (const e of input.entries) {
-		counts[e.level] += 1;
-		const message = format(e.parts);
-		const key = `${e.level}\0${message}`;
-		const seen = byMessage.get(key);
-		if (seen) {
-			seen.count += 1;
-			seen.lastMs = Math.max(seen.lastMs, e.timeMs);
-		} else byMessage.set(key, {
-			level: e.level,
-			message,
-			count: 1,
-			lastMs: e.timeMs
-		});
-	}
-	const grouped = [...byMessage.values()].sort((a, b) => RANK[b.level] - RANK[a.level] || b.lastMs - a.lastMs).slice(0, MAX_GROUPS);
-	const hidden = input.hidden === true;
-	const slow = !hidden && input.stats.running && input.stats.fps > 0 && input.stats.fps < SLOW_FPS;
-	return {
-		hidden,
-		ok: counts.error === 0 && input.stats.errors === 0 && input.assetErrors.length === 0,
-		slow,
-		counts,
-		grouped,
-		worst: grouped.find((g) => g.level === "error") ?? grouped[0] ?? null,
-		stats: input.stats,
-		assetErrors: input.assetErrors
-	};
-}
-/** The report as a person or an agent reads it: what is wrong, then the numbers. */
-function logText(r) {
-	const lines = [];
-	if (r.stats.errors > 0) lines.push(`${r.stats.errors} error${r.stats.errors === 1 ? "" : "s"} were swallowed to keep the game alive — it is running, and something in it is broken`);
-	for (const a of r.assetErrors) lines.push(`asset ${a.ref} never loaded: ${a.error} (${a.url})`);
-	for (const g of r.grouped) {
-		if (g.level === "debug") continue;
-		lines.push(`[${g.level}] ${g.message}${g.count > 1 ? ` ×${g.count}` : ""}`);
-	}
-	if (lines.length === 0) lines.push("nothing wrong — no warnings, no errors, no failed assets");
-	if (!r.stats.running) lines.push(`not running — the loop is stopped (${r.stats.nodes} nodes in the scene)`);
-	else if (r.hidden) lines.push(`${r.stats.nodes} nodes · frame rate not measurable — the page is hidden (a window covered by another counts), and the browser throttles it. Bring it to the front`);
-	else lines.push(`${Math.round(r.stats.fps)} fps · ${r.stats.frameMs.toFixed(1)}ms per frame · ${r.stats.nodes} nodes${r.slow ? " — slow enough to feel" : ""}`);
-	return lines.join("\n");
-}
-//#endregion
-export { logText as n, parseDrive as r, logReport as t };