incanto 0.69.0 → 0.71.0

package/templates-app/platformer-2d/src/main.ts

@@ -44,8 +44,18 @@ scene.assets.goblin.url = goblinUrl;
 scene.assets.coin.url = coinUrl;
 scene.assets.gem.url = gemUrl;
 
+/** Dev-only surfaces: the ☰ debug overlay, and the editor behind it. */
+const DEBUG = import.meta.env.VITE_INCANTO_DEBUG === '1';
+
 const game = await createGame2D({
-  debug: import.meta.env.VITE_INCANTO_DEBUG === '1',
+  debug: DEBUG,
+  // The editor's 📚 buttons, served by `incantoLibrary()` in vite.config.ts.
+  // BOTH halves are the opt-in, and this half was missing from every shipped
+  // template: the plugin alone left a vite config whose own comment promised
+  // "the agent8 asset catalog behind the 📚 buttons" and no button anywhere.
+  // Gated on the same flag, because `editor` DEFAULTS to `debug` and an object
+  // here would turn the editor on in a production build.
+  editor: DEBUG && { library: true },
   canvas,
   scene,
   behaviors,

package/templates-app/platformer-2d/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/star-survivor/package.json

@@ -6,12 +6,12 @@
     "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",
-    "incanto": "^0.69.0",
+    "incanto": "^0.71.0",
     "three": "^0.184.0"
   },
   "devDependencies": {

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

@@ -3,16 +3,9 @@
   "type": "scene",
   "dimension": "2d",
   "name": "HollowHorde",
-  "environment": {
-    "background": "#0d1022"
-  },
-  "viewport": {
-    "design": [960, 540],
-    "fit": "expand"
-  },
-  "physics": {
-    "gravity": [0, 0]
-  },
+  "environment": { "background": "#0d1022" },
+  "viewport": { "design": [960, 540], "fit": "expand" },
+  "physics": { "gravity": [0, 0] },
   "input": {
     "move": {
       "type": "vector2",
@@ -54,28 +47,15 @@
   "root": {
     "name": "Game",
     "type": "Node",
-    "script": {
-      "name": "ScoreKeeper",
-      "props": {
-        "scoreToWin": 1,
-        "lives": 1
-      }
-    },
+    "script": { "name": "ScoreKeeper", "props": { "scoreToWin": 1, "lives": 1 } },
     "children": [
       {
         "name": "Floor",
         "type": "Node2D",
-        "props": {
-          "position": [0, 0]
-        },
+        "props": { "position": [0, 0] },
         "script": {
           "name": "GridFloor",
-          "props": {
-            "color": "#12152a",
-            "line": "#1d244a",
-            "cell": 200,
-            "lines": 26
-          }
+          "props": { "color": "#12152a", "line": "#1d244a", "cell": 200, "lines": 26 }
         },
         "uid": "n_gyoazhctbyg011uf"
       },
@@ -83,16 +63,8 @@
         "name": "Player",
         "type": "CharacterBody2D",
         "groups": ["player"],
-        "props": {
-          "position": [0, 0],
-          "collider": {
-            "shape": "circle",
-            "radius": 15
-          }
-        },
-        "script": {
-          "name": "Survivor"
-        },
+        "props": { "position": [0, 0], "collider": { "shape": "circle", "radius": 15 } },
+        "script": { "name": "Survivor" },
         "children": [
           {
             "name": "Skin",
@@ -103,29 +75,15 @@
               "scale": [0.46, 0.46],
               "anchor": [0.5, 0.56],
               "animations": {
-                "idle": {
-                  "frames": [0, 5],
-                  "fps": 10,
-                  "loop": true
-                },
-                "move": {
-                  "frames": [6, 11],
-                  "fps": 14,
-                  "loop": true
-                }
+                "idle": { "frames": [0, 5], "fps": 10, "loop": true },
+                "move": { "frames": [6, 11], "fps": 14, "loop": true }
               }
             }
           },
           {
             "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"
           }
         ],
@@ -134,17 +92,10 @@
       {
         "name": "GoblinSpawner",
         "type": "Node2D",
-        "props": {
-          "position": [0, 0]
-        },
+        "props": { "position": [0, 0] },
         "script": {
           "name": "Spawner",
-          "props": {
-            "prefab": "GoblinTemplate",
-            "interval": 1.3,
-            "max": 44,
-            "total": 0
-          }
+          "props": { "prefab": "GoblinTemplate", "interval": 1.3, "max": 44, "total": 0 }
         },
         "children": [
           {
@@ -154,18 +105,9 @@
             "props": {
               "position": [0, 0],
               "visible": false,
-              "collider": {
-                "shape": "circle",
-                "radius": 15
-              }
-            },
-            "script": {
-              "name": "Health",
-              "props": {
-                "max": 3,
-                "freeOnDeath": true
-              }
+              "collider": { "shape": "circle", "radius": 15 }
             },
+            "script": { "name": "Health", "props": { "max": 3, "freeOnDeath": true } },
             "children": [
               {
                 "name": "Skin",
@@ -176,16 +118,8 @@
                   "scale": [0.4, 0.4],
                   "anchor": [0.5, 0.58],
                   "animations": {
-                    "idle": {
-                      "frames": [0, 6],
-                      "fps": 9,
-                      "loop": true
-                    },
-                    "move": {
-                      "frames": [7, 12],
-                      "fps": 12,
-                      "loop": true
-                    }
+                    "idle": { "frames": [0, 6], "fps": 9, "loop": true },
+                    "move": { "frames": [7, 12], "fps": 12, "loop": true }
                   }
                 }
               },
@@ -194,31 +128,20 @@
                 "type": "Node2D",
                 "script": {
                   "name": "Chase",
-                  "props": {
-                    "target": "/root/Player",
-                    "speed": 62,
-                    "moveParent": true
-                  }
+                  "props": { "target": "/root/Player", "speed": 62, "moveParent": true }
                 },
                 "uid": "n_pyb54alv0xh0gvn4"
               },
               {
                 "name": "Face",
                 "type": "Node2D",
-                "script": {
-                  "name": "EnemyFace"
-                },
+                "script": { "name": "EnemyFace" },
                 "uid": "n_uww78ofvpq4ecg8k"
               },
               {
                 "name": "Hit",
                 "type": "Area2D",
-                "props": {
-                  "collider": {
-                    "shape": "circle",
-                    "radius": 18
-                  }
-                },
+                "props": { "collider": { "shape": "circle", "radius": 18 } },
                 "script": {
                   "name": "DamageOnContact",
                   "props": {
@@ -233,13 +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"
               }
             ],
@@ -251,17 +168,10 @@
       {
         "name": "GhostSpawner",
         "type": "Node2D",
-        "props": {
-          "position": [0, 0]
-        },
+        "props": { "position": [0, 0] },
         "script": {
           "name": "Spawner",
-          "props": {
-            "prefab": "GhostTemplate",
-            "interval": 2.8,
-            "max": 22,
-            "total": 0
-          }
+          "props": { "prefab": "GhostTemplate", "interval": 2.8, "max": 22, "total": 0 }
         },
         "children": [
           {
@@ -271,18 +181,9 @@
             "props": {
               "position": [0, 0],
               "visible": false,
-              "collider": {
-                "shape": "circle",
-                "radius": 14
-              }
-            },
-            "script": {
-              "name": "Health",
-              "props": {
-                "max": 5,
-                "freeOnDeath": true
-              }
+              "collider": { "shape": "circle", "radius": 14 }
             },
+            "script": { "name": "Health", "props": { "max": 5, "freeOnDeath": true } },
             "children": [
               {
                 "name": "Skin",
@@ -294,16 +195,8 @@
                   "anchor": [0.5, 0.6],
                   "opacity": 0.92,
                   "animations": {
-                    "idle": {
-                      "frames": [0, 5],
-                      "fps": 9,
-                      "loop": true
-                    },
-                    "move": {
-                      "frames": [6, 11],
-                      "fps": 12,
-                      "loop": true
-                    }
+                    "idle": { "frames": [0, 5], "fps": 9, "loop": true },
+                    "move": { "frames": [6, 11], "fps": 12, "loop": true }
                   }
                 }
               },
@@ -312,31 +205,20 @@
                 "type": "Node2D",
                 "script": {
                   "name": "Chase",
-                  "props": {
-                    "target": "/root/Player",
-                    "speed": 98,
-                    "moveParent": true
-                  }
+                  "props": { "target": "/root/Player", "speed": 98, "moveParent": true }
                 },
                 "uid": "n_runap60ko5ppsjjz"
               },
               {
                 "name": "Face",
                 "type": "Node2D",
-                "script": {
-                  "name": "EnemyFace"
-                },
+                "script": { "name": "EnemyFace" },
                 "uid": "n_wkgtjkvevrhj9z9q"
               },
               {
                 "name": "Hit",
                 "type": "Area2D",
-                "props": {
-                  "collider": {
-                    "shape": "circle",
-                    "radius": 16
-                  }
-                },
+                "props": { "collider": { "shape": "circle", "radius": 16 } },
                 "script": {
                   "name": "DamageOnContact",
                   "props": {
@@ -351,13 +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"
               }
             ],
@@ -382,99 +258,50 @@
       {
         "name": "Camera",
         "type": "Camera2D",
-        "props": {
-          "current": true
-        },
+        "props": { "current": true },
         "script": {
           "name": "FollowCamera",
-          "props": {
-            "target": "/root/Player",
-            "smoothing": 0.86
-          }
+          "props": { "target": "/root/Player", "smoothing": 0.86 }
         },
         "uid": "n_2c36byg8q2ob5w7l"
       },
       {
         "name": "SfxShoot",
         "type": "AudioPlayer",
-        "props": {
-          "preset": "shoot",
-          "bus": "sfx",
-          "volume": 0.28
-        }
+        "props": { "preset": "shoot", "bus": "sfx", "volume": 0.28 }
       },
       {
         "name": "SfxXp",
         "type": "AudioPlayer",
-        "props": {
-          "preset": "coin",
-          "bus": "sfx",
-          "volume": 0.4
-        }
+        "props": { "preset": "coin", "bus": "sfx", "volume": 0.4 }
       },
       {
         "name": "SfxKill",
         "type": "AudioPlayer",
-        "props": {
-          "preset": "hit",
-          "bus": "sfx",
-          "volume": 0.3
-        }
+        "props": { "preset": "hit", "bus": "sfx", "volume": 0.3 }
       },
       {
         "name": "SfxHurt",
         "type": "AudioPlayer",
-        "props": {
-          "preset": "hurt",
-          "bus": "sfx",
-          "volume": 0.55
-        }
+        "props": { "preset": "hurt", "bus": "sfx", "volume": 0.55 }
       },
       {
         "name": "SfxWin",
         "type": "AudioPlayer",
-        "props": {
-          "preset": "win",
-          "bus": "sfx",
-          "volume": 0.8
-        }
+        "props": { "preset": "win", "bus": "sfx", "volume": 0.8 }
       },
       {
         "name": "SfxLose",
         "type": "AudioPlayer",
-        "props": {
-          "preset": "lose",
-          "bus": "sfx",
-          "volume": 0.8
-        }
+        "props": { "preset": "lose", "bus": "sfx", "volume": 0.8 }
       }
     ],
     "uid": "n_tlqu945vs98khzn8"
   },
   "connections": [
-    {
-      "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"
-    }
+    { "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/star-survivor/src/main.ts

@@ -31,8 +31,18 @@ scene.assets.knight.url = knightUrl;
 scene.assets.goblin.url = goblinUrl;
 scene.assets.ghost.url = ghostUrl;
 
+/** Dev-only surfaces: the ☰ debug overlay, and the editor behind it. */
+const DEBUG = import.meta.env.VITE_INCANTO_DEBUG === '1';
+
 const game = await createGame2D({
-  debug: import.meta.env.VITE_INCANTO_DEBUG === '1',
+  debug: DEBUG,
+  // The editor's 📚 buttons, served by `incantoLibrary()` in vite.config.ts.
+  // BOTH halves are the opt-in, and this half was missing from every shipped
+  // template: the plugin alone left a vite config whose own comment promised
+  // "the agent8 asset catalog behind the 📚 buttons" and no button anywhere.
+  // Gated on the same flag, because `editor` DEFAULTS to `debug` and an object
+  // here would turn the editor on in a production build.
+  editor: DEBUG && { library: true },
   canvas,
   scene,
   behaviors,

package/templates-app/star-survivor/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/tps-3d/PROJECT/Context.md

@@ -5,7 +5,7 @@
 "Vanguard" — a 3D THIRD-PERSON shooter. The camera rides over your soldier's
 shoulder (you SEE your character); the crosshair is where the hitscan rifle
 fires. Move with WASD, look with the mouse (click locks the pointer), Shift to
-sprint, Space to jump, click / F to fire, R to reload. Survive and clear three
+sprint, Space to jump, click / F to fire, R to reload, Enter to restart. Survive and clear three
 escalating waves of chasing enemies to **SECURE THE AREA**; let them drain your
 HP to 0 and the **MISSION FAILS**.
 

package/templates-app/tps-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/tps-3d/src/behaviors.ts

@@ -20,6 +20,7 @@ import type { Node } from 'incanto';
 import { Behavior } from 'incanto';
 import type { CharacterController3D, ModelInstance3D, Node3D } from 'incanto/3d';
 import { MeshInstance3D, Particles3D } from 'incanto/3d';
+import { restartScene } from 'incanto/gameplay';
 
 // CharacterController3D movement state → mixamo clip (retargets onto the GLB).
 const STATE_CLIPS: Record<string, string> = {
@@ -373,6 +374,20 @@ export class HudUpdater extends Behavior {
 
   override update(): void {
     this.refresh();
+    /*
+     * Enter restarts, once the mission is over.
+     *
+     * The scene has declared a `restart` action since this template shipped and
+     * nothing read it — so `MISSION FAILED` was a dead end you left with F5.
+     * It was bound to `KeyR` as well, the reload key, which is the tell: a
+     * binding nobody reads is also a binding nobody notices colliding.
+     */
+    const engine = this.node.tree?.engine;
+    // Read EVERY frame, act only when the mission is over: an action polled
+    // behind a condition is invisible to `unreadActions()` until a run reaches
+    // that screen, and this template's own playtest reported it dead.
+    const pressed = engine ? engine.input.justPressed('restart') : false;
+    if (this.over && pressed && engine) restartScene(engine);
   }
 
   private refresh(): void {
@@ -399,7 +414,10 @@ export class HudUpdater extends Behavior {
     if (!hasDom) return;
     const b = document.getElementById('banner');
     if (b) {
-      b.textContent = text;
+      // A game-over screen has to say how to leave it, or the key that works is
+      // one only the input map knows about.
+      b.textContent = `${text}\nPress Enter to restart`;
+      b.style.whiteSpace = 'pre-line';
       b.style.color = color;
       b.style.opacity = '1';
     }