incanto 0.70.0 → 0.71.0

package/templates-app/star-survivor/package.json

@@ -11,7 +11,7 @@
   },
   "dependencies": {
     "@dimforge/rapier2d-compat": "0.19.3",
-    "incanto": "^0.70.0",
+    "incanto": "^0.71.0",
     "three": "^0.184.0"
   },
   "devDependencies": {

package/templates-app/star-survivor/src/game.scene.json

@@ -83,10 +83,7 @@
           {
             "name": "Vitals",
             "type": "Node2D",
-            "script": {
-              "name": "Health",
-              "props": { "max": 100, "invulnerableFor": 0.6 }
-            },
+            "script": { "name": "Health", "props": { "max": 100, "invulnerableFor": 0.6 } },
             "uid": "n_bk99wi475y8y1c1g"
           }
         ],
@@ -159,10 +156,7 @@
               {
                 "name": "Drop",
                 "type": "Node2D",
-                "script": {
-                  "name": "EnemyDrop",
-                  "props": { "xp": 1, "color": "#ff8a5b" }
-                },
+                "script": { "name": "EnemyDrop", "props": { "xp": 1, "color": "#ff8a5b" } },
                 "uid": "n_ik9ixyv3h463m3bj"
               }
             ],
@@ -239,10 +233,7 @@
               {
                 "name": "Drop",
                 "type": "Node2D",
-                "script": {
-                  "name": "EnemyDrop",
-                  "props": { "xp": 2, "color": "#8fd0ff" }
-                },
+                "script": { "name": "EnemyDrop", "props": { "xp": 2, "color": "#8fd0ff" } },
                 "uid": "n_ldwl2f8oqqnmv0uc"
               }
             ],
@@ -308,18 +299,8 @@
     "uid": "n_tlqu945vs98khzn8"
   },
   "connections": [
-    {
-      "signal": "died",
-      "from": "Player/Vitals",
-      "to": "/root",
-      "handler": "loseLife"
-    },
-    {
-      "signal": "damaged",
-      "from": "Player/Vitals",
-      "to": "SfxHurt",
-      "handler": "play"
-    },
+    { "signal": "died", "from": "Player/Vitals", "to": "/root", "handler": "loseLife" },
+    { "signal": "damaged", "from": "Player/Vitals", "to": "SfxHurt", "handler": "play" },
     { "signal": "won", "from": "/root", "to": "SfxWin", "handler": "play" },
     { "signal": "lost", "from": "/root", "to": "SfxLose", "handler": "play" }
   ]

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.70.0",
+    "incanto": "^0.71.0",
     "three": "^0.184.0"
   },
   "devDependencies": {

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

@@ -385,11 +385,7 @@
         "type": "Camera3D",
         "props": { "position": [0, 2.6, 23], "fov": 70, "current": true, "far": 400 }
       },
-      {
-        "name": "HurtSfx",
-        "type": "AudioPlayer",
-        "props": { "preset": "hurt", "volume": 0.6 }
-      },
+      { "name": "HurtSfx", "type": "AudioPlayer", "props": { "preset": "hurt", "volume": 0.6 } },
       {
         "name": "Spawner",
         "type": "Node3D",
@@ -398,24 +394,9 @@
           "name": "WaveSpawner",
           "props": {
             "waves": [
-              {
-                "prefab": "EnemyTemplate",
-                "count": 4,
-                "interval": 1.1,
-                "delayBefore": 2
-              },
-              {
-                "prefab": "EnemyTemplate",
-                "count": 6,
-                "interval": 0.9,
-                "delayBefore": 3
-              },
-              {
-                "prefab": "EnemyTemplate",
-                "count": 8,
-                "interval": 0.7,
-                "delayBefore": 3
-              }
+              { "prefab": "EnemyTemplate", "count": 4, "interval": 1.1, "delayBefore": 2 },
+              { "prefab": "EnemyTemplate", "count": 6, "interval": 0.9, "delayBefore": 3 },
+              { "prefab": "EnemyTemplate", "count": 8, "interval": 0.7, "delayBefore": 3 }
             ]
           }
         },
@@ -453,11 +434,7 @@
                   "mesh": "sphere",
                   "size": [0.12, 0.12, 0.12],
                   "position": [0, 0.55, 0.32],
-                  "material": {
-                    "color": "#ffec5c",
-                    "emissive": "#ffd000",
-                    "emissiveIntensity": 2
-                  }
+                  "material": { "color": "#ffec5c", "emissive": "#ffd000", "emissiveIntensity": 2 }
                 }
               },
               {
@@ -551,31 +528,11 @@
                   "color": "#c9d2dd"
                 }
               },
-              {
-                "name": "Volume",
-                "type": "UiVolumeSlider",
-                "uid": "n_5p4124fbnjxx8s0c"
-              },
-              {
-                "name": "Mute",
-                "type": "UiMuteToggle",
-                "uid": "n_e1lyn3mvsy3vj2qr"
-              },
-              {
-                "name": "Quality",
-                "type": "UiQualitySelect",
-                "uid": "n_35r1h71i75yft3ex"
-              },
-              {
-                "name": "RenderScale",
-                "type": "UiRenderScaleSelect",
-                "uid": "n_emg840df89fqsriw"
-              },
-              {
-                "name": "FrameCap",
-                "type": "UiFrameCapSelect",
-                "uid": "n_mgqwgghn0bx900ip"
-              }
+              { "name": "Volume", "type": "UiVolumeSlider", "uid": "n_5p4124fbnjxx8s0c" },
+              { "name": "Mute", "type": "UiMuteToggle", "uid": "n_e1lyn3mvsy3vj2qr" },
+              { "name": "Quality", "type": "UiQualitySelect", "uid": "n_35r1h71i75yft3ex" },
+              { "name": "RenderScale", "type": "UiRenderScaleSelect", "uid": "n_emg840df89fqsriw" },
+              { "name": "FrameCap", "type": "UiFrameCapSelect", "uid": "n_mgqwgghn0bx900ip" }
             ]
           }
         ]
@@ -585,23 +542,8 @@
   },
   "connections": [
     { "signal": "died", "from": "Player", "to": "/root", "handler": "loseLife" },
-    {
-      "signal": "lifeLost",
-      "from": "/root",
-      "to": "Player",
-      "handler": "reviveFull"
-    },
-    {
-      "signal": "damaged",
-      "from": "Player",
-      "to": "HurtSfx",
-      "handler": "play"
-    },
-    {
-      "signal": "allCleared",
-      "from": "Spawner",
-      "to": "Hud",
-      "handler": "onAllCleared"
-    }
+    { "signal": "lifeLost", "from": "/root", "to": "Player", "handler": "reviveFull" },
+    { "signal": "damaged", "from": "Player", "to": "HurtSfx", "handler": "play" },
+    { "signal": "allCleared", "from": "Spawner", "to": "Hud", "handler": "onAllCleared" }
   ]
 }

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.70.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';
@@ -594,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 => {
@@ -606,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 };

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

@@ -108,42 +108,22 @@
           {
             "name": "Pine1",
             "type": "Tree3D",
-            "props": {
-              "position": [-18, 0, -13],
-              "type": "conifer",
-              "seed": 7,
-              "height": 9
-            }
+            "props": { "position": [-18, 0, -13], "type": "conifer", "seed": 7, "height": 9 }
           },
           {
             "name": "Pine2",
             "type": "Tree3D",
-            "props": {
-              "position": [18, 0, -12],
-              "type": "conifer",
-              "seed": 13,
-              "height": 8
-            }
+            "props": { "position": [18, 0, -12], "type": "conifer", "seed": 13, "height": 8 }
           },
           {
             "name": "Pine3",
             "type": "Tree3D",
-            "props": {
-              "position": [-17, 0, 12],
-              "type": "dead",
-              "seed": 29,
-              "height": 7
-            }
+            "props": { "position": [-17, 0, 12], "type": "dead", "seed": 29, "height": 7 }
           },
           {
             "name": "Pine4",
             "type": "Tree3D",
-            "props": {
-              "position": [17, 0, 13],
-              "type": "conifer",
-              "seed": 41,
-              "height": 10
-            }
+            "props": { "position": [17, 0, 13], "type": "conifer", "seed": 41, "height": 10 }
           },
           {
             "name": "Moon",
@@ -197,11 +177,7 @@
                   "mesh": "sphere",
                   "size": [0.07, 0.07, 0.07],
                   "position": [-0.1, 0.24, 1],
-                  "material": {
-                    "color": "#ff3030",
-                    "emissive": "#ff3030",
-                    "emissiveIntensity": 2
-                  }
+                  "material": { "color": "#ff3030", "emissive": "#ff3030", "emissiveIntensity": 2 }
                 }
               },
               {
@@ -211,11 +187,7 @@
                   "mesh": "sphere",
                   "size": [0.07, 0.07, 0.07],
                   "position": [0.1, 0.24, 1],
-                  "material": {
-                    "color": "#ff3030",
-                    "emissive": "#ff3030",
-                    "emissiveIntensity": 2
-                  }
+                  "material": { "color": "#ff3030", "emissive": "#ff3030", "emissiveIntensity": 2 }
                 }
               },
               {
@@ -298,11 +270,7 @@
                   "mesh": "sphere",
                   "size": [0.07, 0.07, 0.07],
                   "position": [-0.1, 0.24, 1],
-                  "material": {
-                    "color": "#ff3030",
-                    "emissive": "#ff3030",
-                    "emissiveIntensity": 2
-                  }
+                  "material": { "color": "#ff3030", "emissive": "#ff3030", "emissiveIntensity": 2 }
                 }
               },
               {
@@ -312,11 +280,7 @@
                   "mesh": "sphere",
                   "size": [0.07, 0.07, 0.07],
                   "position": [0.1, 0.24, 1],
-                  "material": {
-                    "color": "#ff3030",
-                    "emissive": "#ff3030",
-                    "emissiveIntensity": 2
-                  }
+                  "material": { "color": "#ff3030", "emissive": "#ff3030", "emissiveIntensity": 2 }
                 }
               },
               {
@@ -399,11 +363,7 @@
                   "mesh": "sphere",
                   "size": [0.07, 0.07, 0.07],
                   "position": [-0.1, 0.24, 1],
-                  "material": {
-                    "color": "#ff3030",
-                    "emissive": "#ff3030",
-                    "emissiveIntensity": 2
-                  }
+                  "material": { "color": "#ff3030", "emissive": "#ff3030", "emissiveIntensity": 2 }
                 }
               },
               {
@@ -413,11 +373,7 @@
                   "mesh": "sphere",
                   "size": [0.07, 0.07, 0.07],
                   "position": [0.1, 0.24, 1],
-                  "material": {
-                    "color": "#ff3030",
-                    "emissive": "#ff3030",
-                    "emissiveIntensity": 2
-                  }
+                  "material": { "color": "#ff3030", "emissive": "#ff3030", "emissiveIntensity": 2 }
                 }
               },
               {
@@ -602,11 +558,7 @@
             "type": "AudioPlayer",
             "props": { "preset": "shoot", "volume": 0.35, "pitch": 0.55 }
           },
-          {
-            "name": "HitSfx",
-            "type": "AudioPlayer",
-            "props": { "preset": "hit", "volume": 0.6 }
-          },
+          { "name": "HitSfx", "type": "AudioPlayer", "props": { "preset": "hit", "volume": 0.6 } },
           { "name": "Catch", "type": "Respawn" }
         ],
         "script": { "name": "Health", "props": { "max": 100, "invulnerableFor": 0.8 } },
@@ -617,11 +569,7 @@
         "type": "Camera3D",
         "props": { "current": true, "position": [0, 4, 19] }
       },
-      {
-        "name": "WinSfx",
-        "type": "AudioPlayer",
-        "props": { "preset": "win", "volume": 0.6 }
-      },
+      { "name": "WinSfx", "type": "AudioPlayer", "props": { "preset": "win", "volume": 0.6 } },
       {
         "name": "HUD",
         "type": "HudLayer",
@@ -630,12 +578,7 @@
             "name": "Quest",
             "type": "UiText",
             "uid": "n_nmkf915b9r8d37nf",
-            "props": {
-              "text": "Wolves left: 3",
-              "size": 16,
-              "anchor": "topLeft",
-              "shadow": true
-            }
+            "props": { "text": "Wolves left: 3", "size": 16, "anchor": "topLeft", "shadow": true }
           },
           {
             "name": "HP",
@@ -674,11 +617,7 @@
               {
                 "name": "ResumeHint",
                 "type": "UiText",
-                "props": {
-                  "text": "Esc to resume · R to restart",
-                  "size": 13,
-                  "color": "#c9d2dd"
-                }
+                "props": { "text": "Esc to resume · R to restart", "size": 13, "color": "#c9d2dd" }
               }
             ]
           }
@@ -688,17 +627,7 @@
     "uid": "n_tq2dy6amirvyfhlg"
   },
   "connections": [
-    {
-      "signal": "triggerEnter",
-      "from": "ReturnPortal",
-      "to": "/root",
-      "handler": "onPortalEnter"
-    },
-    {
-      "signal": "died",
-      "from": "Player",
-      "to": "/root",
-      "handler": "onPlayerDown"
-    }
+    { "signal": "triggerEnter", "from": "ReturnPortal", "to": "/root", "handler": "onPortalEnter" },
+    { "signal": "died", "from": "Player", "to": "/root", "handler": "onPlayerDown" }
   ]
 }

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

@@ -2654,10 +2654,7 @@
         "name": "Elder",
         "type": "Node3D",
         "props": { "position": [3, 0, -2] },
-        "script": {
-          "name": "Interactable",
-          "props": { "action": "interact", "range": 2.8 }
-        },
+        "script": { "name": "Interactable", "props": { "action": "interact", "range": 2.8 } },
         "children": [
           {
             "name": "Body",
@@ -2811,11 +2808,7 @@
             "type": "AudioPlayer",
             "props": { "preset": "shoot", "volume": 0.35, "pitch": 0.55 }
           },
-          {
-            "name": "HitSfx",
-            "type": "AudioPlayer",
-            "props": { "preset": "hit", "volume": 0.6 }
-          },
+          { "name": "HitSfx", "type": "AudioPlayer", "props": { "preset": "hit", "volume": 0.6 } },
           { "name": "Catch", "type": "Respawn" }
         ]
       },
@@ -2881,23 +2874,8 @@
     "uid": "n_2a2pghqmq92ko29c"
   },
   "connections": [
-    {
-      "signal": "interacted",
-      "from": "Elder",
-      "to": "/root",
-      "handler": "onTalk"
-    },
-    {
-      "signal": "triggerEnter",
-      "from": "GroveGate",
-      "to": "/root",
-      "handler": "onGateEnter"
-    },
-    {
-      "signal": "pressed",
-      "from": "HUD/RestartBtn",
-      "to": "/root",
-      "handler": "onRestart"
-    }
+    { "signal": "interacted", "from": "Elder", "to": "/root", "handler": "onTalk" },
+    { "signal": "triggerEnter", "from": "GroveGate", "to": "/root", "handler": "onGateEnter" },
+    { "signal": "pressed", "from": "HUD/RestartBtn", "to": "/root", "handler": "onRestart" }
   ]
 }