incanto 0.68.0 → 0.70.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.68.0",
+    "incanto": "^0.70.0",
     "three": "^0.184.0"
   },
   "devDependencies": {

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

@@ -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.';
       });

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

@@ -11,33 +11,16 @@
       "turbidity": 5,
       "rayleigh": 3.2
     },
-    "fog": {
-      "near": 20,
-      "far": 80
-    },
-    "shadows": {
-      "mapSize": 2048
-    },
+    "fog": { "near": 20, "far": 80 },
+    "shadows": { "mapSize": 2048 },
     "exposure": 1,
-    "ambient": {
-      "color": "#a8b4e0",
-      "intensity": 0.95
-    },
+    "ambient": { "color": "#a8b4e0", "intensity": 0.95 },
     "iblIntensity": 0.85,
     "background": "#141322",
-    "post": {
-      "vignette": 0.34,
-      "saturation": 0.88,
-      "contrast": 1.05
-    },
-    "bloom": {
-      "threshold": 0.85,
-      "strength": 0.5
-    }
-  },
-  "physics": {
-    "gravity": [0, -9.81, 0]
+    "post": { "vignette": 0.34, "saturation": 0.88, "contrast": 1.05 },
+    "bloom": { "threshold": 0.85, "strength": 0.5 }
   },
+  "physics": { "gravity": [0, -9.81, 0] },
   "input": {
     "move": {
       "type": "vector2",
@@ -48,30 +31,12 @@
         "right": ["KeyD", "ArrowRight"]
       }
     },
-    "jump": {
-      "type": "button",
-      "keys": ["Space"]
-    },
-    "sprint": {
-      "type": "button",
-      "keys": ["ShiftLeft", "ShiftRight"]
-    },
-    "interact": {
-      "type": "button",
-      "keys": ["KeyE"]
-    },
-    "attack": {
-      "type": "button",
-      "keys": ["Mouse0", "KeyF"]
-    },
-    "restart": {
-      "type": "button",
-      "keys": ["KeyR"]
-    },
-    "pause": {
-      "type": "button",
-      "keys": ["Escape"]
-    }
+    "jump": { "type": "button", "keys": ["Space"] },
+    "sprint": { "type": "button", "keys": ["ShiftLeft", "ShiftRight"] },
+    "interact": { "type": "button", "keys": ["KeyE"] },
+    "attack": { "type": "button", "keys": ["Mouse0", "KeyF"] },
+    "restart": { "type": "button", "keys": ["KeyR"] },
+    "pause": { "type": "button", "keys": ["Escape"] }
   },
   "assets": {
     "characters/base": {
@@ -106,29 +71,19 @@
   "root": {
     "name": "Game",
     "type": "Node",
-    "script": {
-      "name": "GroveDirector"
-    },
+    "script": { "name": "GroveDirector" },
     "children": [
       {
         "name": "Flow",
         "type": "Node",
-        "script": {
-          "name": "GameFlow",
-          "props": {
-            "pausePanelPath": "%PauseMenu"
-          }
-        },
+        "script": { "name": "GameFlow", "props": { "pausePanelPath": "%PauseMenu" } },
         "uid": "n_72gl5aezorlb9d5n"
       },
       {
         "name": "Ground",
         "type": "StaticBody3D",
         "props": {
-          "collider": {
-            "shape": "box",
-            "size": [40, 0.1, 32]
-          },
+          "collider": { "shape": "box", "size": [40, 0.1, 32] },
           "position": [0, -0.05, 0]
         },
         "children": [
@@ -138,25 +93,17 @@
             "props": {
               "mesh": "box",
               "size": [40, 0.1, 32],
-              "material": {
-                "color": "#2f4030",
-                "roughness": 1
-              },
+              "material": { "color": "#2f4030", "roughness": 1 },
               "receiveShadow": true
             }
           }
         ]
       },
-      {
-        "name": "Maze",
-        "type": "Node3D"
-      },
+      { "name": "Maze", "type": "Node3D" },
       {
         "name": "Scenery",
         "type": "Node3D",
-        "props": {
-          "static": true
-        },
+        "props": { "static": true },
         "children": [
           {
             "name": "Pine1",
@@ -219,13 +166,7 @@
             "name": "Wolf1",
             "type": "Node3D",
             "groups": ["wolf"],
-            "script": {
-              "name": "PathFollow",
-              "props": {
-                "speed": 2.4,
-                "loop": true
-              }
-            },
+            "script": { "name": "PathFollow", "props": { "speed": 2.4, "loop": true } },
             "children": [
               {
                 "name": "Body",
@@ -234,10 +175,7 @@
                   "mesh": "box",
                   "size": [0.55, 0.5, 1.3],
                   "position": [0, 0, 0],
-                  "material": {
-                    "color": "#3b3b44",
-                    "roughness": 0.9
-                  },
+                  "material": { "color": "#3b3b44", "roughness": 0.9 },
                   "castShadow": true
                 }
               },
@@ -248,10 +186,7 @@
                   "mesh": "box",
                   "size": [0.4, 0.38, 0.5],
                   "position": [0, 0.18, 0.75],
-                  "material": {
-                    "color": "#46464f",
-                    "roughness": 0.9
-                  },
+                  "material": { "color": "#46464f", "roughness": 0.9 },
                   "castShadow": true
                 }
               },
@@ -291,10 +226,7 @@
                   "size": [0.12, 0.12, 0.55],
                   "position": [0, 0.12, -0.85],
                   "rotation": [-20, 0, 0],
-                  "material": {
-                    "color": "#33333b",
-                    "roughness": 0.9
-                  },
+                  "material": { "color": "#33333b", "roughness": 0.9 },
                   "castShadow": true
                 }
               },
@@ -315,10 +247,7 @@
                 "type": "Area3D",
                 "props": {
                   "position": [0, 0.1, 0.55],
-                  "collider": {
-                    "shape": "box",
-                    "size": [0.6, 0.8, 0.7]
-                  }
+                  "collider": { "shape": "box", "size": [0.6, 0.8, 0.7] }
                 },
                 "script": {
                   "name": "DamageOnContact",
@@ -338,13 +267,7 @@
             "name": "Wolf2",
             "type": "Node3D",
             "groups": ["wolf"],
-            "script": {
-              "name": "PathFollow",
-              "props": {
-                "speed": 2.4,
-                "loop": true
-              }
-            },
+            "script": { "name": "PathFollow", "props": { "speed": 2.4, "loop": true } },
             "children": [
               {
                 "name": "Body",
@@ -353,10 +276,7 @@
                   "mesh": "box",
                   "size": [0.55, 0.5, 1.3],
                   "position": [0, 0, 0],
-                  "material": {
-                    "color": "#3b3b44",
-                    "roughness": 0.9
-                  },
+                  "material": { "color": "#3b3b44", "roughness": 0.9 },
                   "castShadow": true
                 }
               },
@@ -367,10 +287,7 @@
                   "mesh": "box",
                   "size": [0.4, 0.38, 0.5],
                   "position": [0, 0.18, 0.75],
-                  "material": {
-                    "color": "#46464f",
-                    "roughness": 0.9
-                  },
+                  "material": { "color": "#46464f", "roughness": 0.9 },
                   "castShadow": true
                 }
               },
@@ -410,10 +327,7 @@
                   "size": [0.12, 0.12, 0.55],
                   "position": [0, 0.12, -0.85],
                   "rotation": [-20, 0, 0],
-                  "material": {
-                    "color": "#33333b",
-                    "roughness": 0.9
-                  },
+                  "material": { "color": "#33333b", "roughness": 0.9 },
                   "castShadow": true
                 }
               },
@@ -434,10 +348,7 @@
                 "type": "Area3D",
                 "props": {
                   "position": [0, 0.1, 0.55],
-                  "collider": {
-                    "shape": "box",
-                    "size": [0.6, 0.8, 0.7]
-                  }
+                  "collider": { "shape": "box", "size": [0.6, 0.8, 0.7] }
                 },
                 "script": {
                   "name": "DamageOnContact",
@@ -457,13 +368,7 @@
             "name": "Wolf3",
             "type": "Node3D",
             "groups": ["wolf"],
-            "script": {
-              "name": "PathFollow",
-              "props": {
-                "speed": 2.4,
-                "loop": true
-              }
-            },
+            "script": { "name": "PathFollow", "props": { "speed": 2.4, "loop": true } },
             "children": [
               {
                 "name": "Body",
@@ -472,10 +377,7 @@
                   "mesh": "box",
                   "size": [0.55, 0.5, 1.3],
                   "position": [0, 0, 0],
-                  "material": {
-                    "color": "#3b3b44",
-                    "roughness": 0.9
-                  },
+                  "material": { "color": "#3b3b44", "roughness": 0.9 },
                   "castShadow": true
                 }
               },
@@ -486,10 +388,7 @@
                   "mesh": "box",
                   "size": [0.4, 0.38, 0.5],
                   "position": [0, 0.18, 0.75],
-                  "material": {
-                    "color": "#46464f",
-                    "roughness": 0.9
-                  },
+                  "material": { "color": "#46464f", "roughness": 0.9 },
                   "castShadow": true
                 }
               },
@@ -529,10 +428,7 @@
                   "size": [0.12, 0.12, 0.55],
                   "position": [0, 0.12, -0.85],
                   "rotation": [-20, 0, 0],
-                  "material": {
-                    "color": "#33333b",
-                    "roughness": 0.9
-                  },
+                  "material": { "color": "#33333b", "roughness": 0.9 },
                   "castShadow": true
                 }
               },
@@ -553,10 +449,7 @@
                 "type": "Area3D",
                 "props": {
                   "position": [0, 0.1, 0.55],
-                  "collider": {
-                    "shape": "box",
-                    "size": [0.6, 0.8, 0.7]
-                  }
+                  "collider": { "shape": "box", "size": [0.6, 0.8, 0.7] }
                 },
                 "script": {
                   "name": "DamageOnContact",
@@ -579,10 +472,7 @@
         "type": "Area3D",
         "props": {
           "position": [3.5, 1.2, 13.5],
-          "collider": {
-            "shape": "box",
-            "size": [1.8, 2.4, 0.8]
-          }
+          "collider": { "shape": "box", "size": [1.8, 2.4, 0.8] }
         },
         "children": [
           {
@@ -592,10 +482,7 @@
               "mesh": "box",
               "size": [2.2, 2.8, 0.3],
               "position": [0, 0.2, 0.6],
-              "material": {
-                "color": "#5c4632",
-                "roughness": 0.9
-              },
+              "material": { "color": "#5c4632", "roughness": 0.9 },
               "castShadow": true
             }
           },
@@ -624,11 +511,7 @@
           "position": [0, 1.4, 13],
           "fixedRotation": true,
           "friction": 0,
-          "collider": {
-            "shape": "capsule",
-            "radius": 0.34,
-            "height": 1
-          }
+          "collider": { "shape": "capsule", "radius": 0.34, "height": 1 }
         },
         "children": [
           {
@@ -648,11 +531,11 @@
                 "run": "$anims/run",
                 "fastRun": "$anims/runFast",
                 "airborne": "$anims/jump"
-              }
-            },
-            "script": {
-              "name": "SwordStrike"
+              },
+              "coyoteSeconds": 0.12,
+              "jumpBufferSeconds": 0.15
             },
+            "script": { "name": "SwordStrike" },
             "uid": "n_9xdg9b3a5eb9r4x1"
           },
           {
@@ -669,10 +552,7 @@
           {
             "name": "SwordMount",
             "type": "BoneAttachment3D",
-            "props": {
-              "target": "../Skin",
-              "bone": "RightHand"
-            },
+            "props": { "target": "../Skin", "bone": "RightHand" },
             "children": [
               {
                 "name": "Blade",
@@ -681,11 +561,7 @@
                   "mesh": "box",
                   "size": [0.045, 0.7, 0.045],
                   "position": [0, 0.42, 0],
-                  "material": {
-                    "color": "#d8dde8",
-                    "metalness": 0.9,
-                    "roughness": 0.25
-                  },
+                  "material": { "color": "#d8dde8", "metalness": 0.9, "roughness": 0.25 },
                   "castShadow": true
                 }
               },
@@ -696,19 +572,13 @@
                   "mesh": "box",
                   "size": [0.16, 0.04, 0.06],
                   "position": [0, 0.09, 0],
-                  "material": {
-                    "color": "#8a6d3a",
-                    "metalness": 0.7,
-                    "roughness": 0.4
-                  }
+                  "material": { "color": "#8a6d3a", "metalness": 0.7, "roughness": 0.4 }
                 }
               },
               {
                 "name": "SwordTip",
                 "type": "Node3D",
-                "props": {
-                  "position": [0, 0.78, 0]
-                },
+                "props": { "position": [0, 0.78, 0] },
                 "children": [
                   {
                     "name": "SwingTrail",
@@ -730,49 +600,27 @@
           {
             "name": "SwingSfx",
             "type": "AudioPlayer",
-            "props": {
-              "preset": "shoot",
-              "volume": 0.35,
-              "pitch": 0.55
-            }
+            "props": { "preset": "shoot", "volume": 0.35, "pitch": 0.55 }
           },
           {
             "name": "HitSfx",
             "type": "AudioPlayer",
-            "props": {
-              "preset": "hit",
-              "volume": 0.6
-            }
+            "props": { "preset": "hit", "volume": 0.6 }
           },
-          {
-            "name": "Catch",
-            "type": "Respawn"
-          }
+          { "name": "Catch", "type": "Respawn" }
         ],
-        "script": {
-          "name": "Health",
-          "props": {
-            "max": 100,
-            "invulnerableFor": 0.8
-          }
-        },
+        "script": { "name": "Health", "props": { "max": 100, "invulnerableFor": 0.8 } },
         "uid": "n_3hp4w1vicxhqr375"
       },
       {
         "name": "Camera",
         "type": "Camera3D",
-        "props": {
-          "current": true,
-          "position": [0, 4, 19]
-        }
+        "props": { "current": true, "position": [0, 4, 19] }
       },
       {
         "name": "WinSfx",
         "type": "AudioPlayer",
-        "props": {
-          "preset": "win",
-          "volume": 0.6
-        }
+        "props": { "preset": "win", "volume": 0.6 }
       },
       {
         "name": "HUD",
@@ -793,20 +641,13 @@
             "name": "HP",
             "type": "UiBar",
             "uid": "n_kdm2vun7p0o3t4l2",
-            "props": {
-              "anchor": "topRight",
-              "value": 100,
-              "max": 100,
-              "width": 160
-            }
+            "props": { "anchor": "topRight", "value": 100, "max": 100, "width": 160 }
           },
           {
             "name": "Banner",
             "type": "UiBanner",
             "uid": "n_21yz0pgnwqvz81yo",
-            "props": {
-              "anchor": "center"
-            }
+            "props": { "anchor": "center" }
           },
           {
             "name": "Hint",
@@ -823,20 +664,12 @@
           {
             "name": "PauseMenu",
             "type": "UiPanel",
-            "props": {
-              "anchor": "center",
-              "layout": "column",
-              "gap": 10,
-              "padding": 18
-            },
+            "props": { "anchor": "center", "layout": "column", "gap": 10, "padding": 18 },
             "children": [
               {
                 "name": "PausedTitle",
                 "type": "UiText",
-                "props": {
-                  "text": "Paused",
-                  "size": 24
-                }
+                "props": { "text": "Paused", "size": 24 }
               },
               {
                 "name": "ResumeHint",

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

@@ -21,8 +21,18 @@ await preloadUrls(assetUrls(villageJson.assets), (done, total) => {
 });
 
 const canvas = document.querySelector('canvas') as HTMLCanvasElement;
+/** Dev-only surfaces: the ☰ debug overlay, and the editor behind it. */
+const DEBUG = import.meta.env.VITE_INCANTO_DEBUG === '1';
+
 const game = await createGame3D({
-  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: villageJson,
   behaviors: BEHAVIORS,
@@ -36,7 +46,17 @@ const game = await createGame3D({
   throw e;
 });
 
-document.querySelector('#loading')?.remove();
-
-// Console-poking handle for playtesting ("teleport me to the elder").
+// The console handle FIRST, before any wiring of your own can throw.
+// `game.stats()`, `game.assetErrors()`, `game.frame()` and `game.engine.log`
+// are the entire in-page diagnostic surface, and a static build has no other.
+// Assigned after the wiring, one mistake below took all of them with it.
 (window as unknown as { game: typeof game }).game = game;
+
+// The overlay comes down LAST, after any wiring of your own. There is none in
+// this template — when you add some, put it above this line and wrap it:
+//
+//   try { …your wiring… } catch (e) { showBootFailure(e); throw e; }
+//
+// A throw between the overlay coming down and the handle going up used to leave
+// a level that renders perfectly with no player and no error of any kind.
+document.querySelector('#loading')?.remove();