incanto 0.69.0 → 0.71.0

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

@@ -6,14 +6,14 @@
     "dev": "vite",
     "build": "vite build",
     "typecheck": "tsc --noEmit",
-    "check": "incanto-check src",
+    "check": "incanto-check src --behaviors src/behaviors.ts",
     "verify": "bun verify.ts"
   },
   "dependencies": {
     "@dimforge/rapier2d-compat": "0.19.3",
     "@dimforge/rapier3d-compat": "0.19.3",
     "@pixiv/three-vrm": "^3.5.3",
-    "incanto": "^0.69.0",
+    "incanto": "^0.71.0",
     "three": "^0.184.0"
   },
   "devDependencies": {

package/templates-app/village-quest-3d/src/behaviors.ts

@@ -23,7 +23,7 @@ import type {
   UiText,
   Voice,
 } from 'incanto';
-import { Behavior, findPath, gridFromRows } from 'incanto';
+import { Behavior, findPath, gridFromRows, Timer } from 'incanto';
 import { mergeSolidRects, parseCells } from 'incanto/2d';
 import type { Camera3D, CharacterController3D, Node3D, Trail3D } from 'incanto/3d';
 import { MeshInstance3D, Particles3D, StaticBody3D } from 'incanto/3d';
@@ -161,6 +161,16 @@ function ambientUpdate(
 // ---- VillageDirector --------------------------------------------------------------
 
 export class VillageDirector extends Behavior {
+  /**
+   * `QUEST COMPLETE` was a banner and nothing else.
+   *
+   * The village had an ending — the wolves cleared, the Elder's thanks, a
+   * restart button — and emitted no `won`, so the playtest reported
+   * `no win declared in this scene — nothing emits won/lost, so there is
+   * nothing to reach` about a game that has one. The same shape as the isle's.
+   */
+  static readonly signals: readonly string[] = ['won'];
+
   private wind: Voice | null = null;
   private gateHinted = false;
 
@@ -196,6 +206,16 @@ export class VillageDirector extends Behavior {
     if (engine && this.dialogue.active && engine.input.justPressed('interact')) {
       this.dialogue.advance();
     }
+    /*
+     * R restarts once the quest is done — the same thing the button does.
+     *
+     * The scene has always declared `"restart": { "keys": ["KeyR"] }` and
+     * nothing read it, so this game's own control vocabulary promised a key
+     * that did nothing. `incanto-playtest` now says so:
+     * `declared and never read: \`restart\``.
+     */
+    const restart = engine ? engine.input.justPressed('restart') : false;
+    if (restart && quest.done) this.onRestart();
   }
 
   /** Elder.interacted → here (scene connection). */
@@ -214,6 +234,7 @@ export class VillageDirector extends Behavior {
       const banner = this.node.getNode('HUD/Banner') as UiBanner;
       talk.on('dialogueFinished', () => {
         banner.show('QUEST COMPLETE');
+        this.node.emit('won');
         (this.node.getNode('HUD/RestartBtn') as UiButton).visible = true;
         (this.node.getNode('HUD/Quest') as UiText).text = 'Emberwood is safe.';
       });
@@ -573,7 +594,18 @@ export class SwordStrike extends Behavior {
 /** Strike bookkeeping: hits per wolf (module-scope — survives behavior instances). */
 const wolfHits = new WeakMap<Node, number>();
 
-/** Red hurt-flash on every mesh of the wolf, reverted a beat later. */
+/**
+ * Red hurt-flash on every mesh of the wolf, reverted a beat later.
+ *
+ * The beat is a `Timer`, not a `setTimeout` — which is what this was, and what
+ * `incanto-behaviors-and-scripts.md` calls "the canonical serializable game
+ * clock — NEVER setTimeout in game logic". Three things a wall-clock timeout
+ * gets wrong here: it keeps running while the game is paused (`timeScale: 0`),
+ * it ignores `timeScale` entirely, and in a headless run — where a minute of
+ * play takes a second — it fires long after the frame that asked for it, so a
+ * seeded playtest stops being reproducible. The node is a child of the wolf,
+ * so a wolf that dies mid-flash takes its timer with it.
+ */
 function flashWolf(wolf: Node): void {
   const meshes: { material: Record<string, unknown> }[] = [];
   const walk = (n: Node): void => {
@@ -585,11 +617,17 @@ function flashWolf(wolf: Node): void {
   walk(wolf);
   const originals = meshes.map((m) => m.material);
   for (const m of meshes) m.material = { ...m.material, color: '#ff5544' };
-  setTimeout(() => {
+  const beat = new Timer('Unflash');
+  beat.waitTime = 0.13;
+  beat.oneShot = true;
+  beat.autostart = true;
+  beat.on('timeout', () => {
     meshes.forEach((m, i) => {
       if (wolf.tree) m.material = originals[i] as Record<string, unknown>;
     });
-  }, 130);
+    beat.queueFree();
+  });
+  wolf.addChild(beat);
 }
 
 export const BEHAVIORS = { VillageDirector, GroveDirector, SwordStrike };