incanto 0.74.0 → 0.76.0

package/templates-app/platformer-2d/src/game.scene.json

@@ -17,7 +17,9 @@
       },
       "touch": "joystick"
     },
-    "jump": { "type": "button", "keys": ["Space", "KeyW", "ArrowUp"], "touch": "button" }
+    "jump": { "type": "button", "keys": ["Space", "KeyW", "ArrowUp"], "touch": "button" },
+    "pause": { "type": "button", "keys": ["Escape"] },
+    "restart": { "type": "button", "keys": ["KeyR"] }
   },
   "assets": {
     "knight": {
@@ -1235,6 +1237,23 @@
             },
             "uid": "n_odjl6nsgedmaiijc"
           },
+          {
+            "name": "Vitals",
+            "type": "Node",
+            "script": {
+              "name": "Health",
+              "props": {
+                "max": 3,
+                "invulnerableFor": 1.1,
+                "knockback": 420,
+                "knockbackSeconds": 0.22,
+                "knockUp": 360,
+                "staggerSeconds": 0.22,
+                "applyKnockback": false
+              }
+            },
+            "uid": "n_636k806hf3tc9wxe"
+          },
           {
             "name": "Feet",
             "type": "Area2D",
@@ -1334,6 +1353,98 @@
               "color": "#f4f4f4"
             },
             "uid": "n_xzbq736pxmlog2ze"
+          },
+          {
+            "name": "PauseMenu",
+            "type": "UiPanel",
+            "uid": "n_18nwr09ab7ql2z4r",
+            "props": {
+              "anchor": "center",
+              "layout": "column",
+              "gap": 12,
+              "padding": 22,
+              "visible": false,
+              "background": "rgba(10,14,22,0.92)",
+              "radius": 12
+            },
+            "children": [
+              {
+                "name": "PausedTitle",
+                "type": "UiText",
+                "uid": "n_zbj0pg98lnk8rv82",
+                "props": { "text": "PAUSED", "size": 26 }
+              },
+              {
+                "name": "Resume",
+                "type": "UiButton",
+                "uid": "n_pn2pcwtmdaxii0ir",
+                "props": { "text": "RESUME", "size": 18 }
+              },
+              {
+                "name": "PauseOptions",
+                "type": "UiButton",
+                "uid": "n_rlol3m8e7ev1akf3",
+                "props": { "text": "OPTIONS", "size": 16 }
+              },
+              {
+                "name": "Restart",
+                "type": "UiButton",
+                "uid": "n_08baib5wy10vg0ar",
+                "props": { "text": "START OVER", "size": 16 }
+              }
+            ]
+          },
+          {
+            "name": "Options",
+            "type": "UiPanel",
+            "uid": "n_rnlo15z2gqd6hma0",
+            "props": {
+              "anchor": "center",
+              "layout": "column",
+              "gap": 10,
+              "padding": 22,
+              "visible": false,
+              "background": "rgba(10,14,22,0.92)",
+              "radius": 12
+            },
+            "children": [
+              {
+                "name": "OptionsTitle",
+                "type": "UiText",
+                "uid": "n_dybfe2jy973oxrw8",
+                "props": { "text": "OPTIONS", "size": 24 }
+              },
+              {
+                "name": "Master",
+                "type": "UiVolumeSlider",
+                "uid": "n_5rd1metkz071rwyl",
+                "props": { "label": "master", "bus": "master", "width": 260 }
+              },
+              {
+                "name": "Sfx",
+                "type": "UiVolumeSlider",
+                "uid": "n_3jz8z3sx850i1vlh",
+                "props": { "label": "effects", "bus": "sfx", "width": 260 }
+              },
+              {
+                "name": "Mute",
+                "type": "UiMuteToggle",
+                "uid": "n_9jn0ncey479106t8",
+                "props": { "label": "mute everything" }
+              },
+              {
+                "name": "Quality",
+                "type": "UiQualitySelect",
+                "uid": "n_w0dd38u2gqui7oli",
+                "props": { "label": "quality" }
+              },
+              {
+                "name": "Back",
+                "type": "UiButton",
+                "uid": "n_huasc2fyi2sc1ejj",
+                "props": { "text": "BACK", "size": 16 }
+              }
+            ]
           }
         ],
         "uid": "n_ng718r3uiw1madux"
@@ -1476,6 +1587,12 @@
             "props": { "size": [160, 20], "color": "#9aa3bd", "anchor": [0.5, 0.5] }
           }
         ]
+      },
+      {
+        "name": "Flow",
+        "type": "Node",
+        "uid": "n_i26ub26uzhmxyulv",
+        "script": { "name": "GameFlow" }
       }
     ],
     "uid": "n_d9t51gs0vhpnp2jj"
@@ -1510,6 +1627,31 @@
     { "signal": "collected", "from": "Gem1", "to": "SfxCheckpoint", "handler": "play" },
     { "signal": "collected", "from": "Gem2", "to": "SfxCheckpoint", "handler": "play" },
     { "signal": "won", "from": "/root", "to": "SfxWin", "handler": "play" },
-    { "signal": "lost", "from": "/root", "to": "SfxLose", "handler": "play" }
+    { "signal": "lost", "from": "/root", "to": "SfxLose", "handler": "play" },
+    {
+      "from": "/root/HUD/PauseMenu/Resume",
+      "signal": "pressed",
+      "to": "/root/Flow",
+      "handler": "resume"
+    },
+    {
+      "from": "/root/HUD/PauseMenu/PauseOptions",
+      "signal": "pressed",
+      "to": "/root/Flow",
+      "handler": "screen",
+      "args": ["/root/HUD/Options"]
+    },
+    {
+      "from": "/root/HUD/PauseMenu/Restart",
+      "signal": "pressed",
+      "to": "/root/Flow",
+      "handler": "restart"
+    },
+    {
+      "from": "/root/HUD/Options/Back",
+      "signal": "pressed",
+      "to": "/root/Flow",
+      "handler": "back"
+    }
   ]
 }

package/templates-app/platformer-2d/verify.ts

@@ -124,6 +124,8 @@ interface Player {
   let enemiesBefore = 0;
   let enemiesAfterStomp = 0;
   let heartsAfterHit = 3;
+  let hitKnock = 0; // px the knight was kicked AWAY from Gob2 while holding TOWARDS it
+  let hitLift = 0; // px it rose (knockUp)
 
   const result = await runScript(sceneJson, {
     durationMs: 4000,
@@ -165,10 +167,21 @@ interface Player {
         do: (ctx) => {
           const player = ctx.getNode('Player') as unknown as Body;
           const gob = ctx.getNode('Gob2') as unknown as Body;
-          player.position = [gob.position[0] ?? 0, gob.position[1] ?? 0];
+          // just LEFT of the goblin, overlapping it, and holding RIGHT into it:
+          // the hit's kick must win the stick (stagger) and carry the knight left and up
+          player.position = [(gob.position[0] ?? 0) - 12, gob.position[1] ?? 0];
           player.velocity = [0, 0];
+          ctx.engine.input.setActionVector('move', 1, 0);
           for (let i = 0; i < 3; i++) ctx.engine.step();
           heartsAfterHit = (ctx.getNode('Player').behavior as unknown as Player).hearts;
+          const x0 = player.position[0] ?? 0;
+          const y0 = player.position[1] ?? 0;
+          for (let i = 0; i < 12; i++) {
+            ctx.engine.step();
+            hitKnock = Math.max(hitKnock, x0 - (player.position[0] ?? 0));
+            hitLift = Math.max(hitLift, y0 - (player.position[1] ?? 0));
+          }
+          ctx.engine.input.setActionVector('move', 0, 0);
         },
       },
     ],
@@ -184,6 +197,10 @@ interface Player {
     scores.some((s) => s >= 50),
   );
   ok('a side hit cost a heart', heartsAfterHit < 3);
+  ok(
+    `…and kicked the knight ${hitKnock.toFixed(0)} px AWAY against a held stick, ${hitLift.toFixed(0)} px up (Health.knockback/knockUp/staggerSeconds)`,
+    hitKnock > 20 && hitLift > 10,
+  );
   ok('runScript reported no failures (coin/stomp/hit path)', result.ok);
 }
 

package/templates-app/star-survivor/PROJECT/Status.md

@@ -42,3 +42,10 @@
 - Spawning leans on the built-in `Spawner` + `Director` scatter (the engine's clone
   path is internal). Add enemy types by copying a template + spawner into the
   `Director.spawners` list.
+
+## Pausing
+
+ESC pauses and shows the pause menu; OPTIONS opens the settings over it and
+BACK returns to the menu that asked. All of it is `GameFlow` (`pausePanelPath`,
+`screen(path)`, `back()`) wired with `connections` — there is no TypeScript for
+any screen in this game.

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

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

package/templates-app/star-survivor/src/behaviors.ts

@@ -36,7 +36,7 @@ interface HealthLike {
   current: number;
   max: number;
   isDead: boolean;
-  damage(n: number): void;
+  damage(n: number, from?: readonly number[]): void;
   heal(n: number): void;
 }
 interface ScoreLike {
@@ -50,7 +50,6 @@ const BOLT_SPEED = 520;
 const BOLT_LIFE = 0.9;
 const PICKUP_RADIUS = 30;
 const SURVIVE_SECONDS = 90;
-const HIT_KNOCK = 18; // px an enemy is shoved back when a bolt connects (hit feedback)
 
 interface Bolt {
   node: Node2D;
@@ -238,13 +237,15 @@ export class Survivor extends Behavior {
           if (dist2(nx, ny, en.position[0] ?? 0, en.position[1] ?? 0) < 26 * 26) {
             b.hit.add(e);
             // HIT FEEDBACK: damage (→ the enemy's EnemyFace flashes on 'damaged'),
-            // shove it back along the bolt, and pop an impact spark at the contact.
-            (e as unknown as { behavior?: HealthLike }).behavior?.damage?.(this.damage);
+            // and pop an impact spark at the contact. The shove back along the
+            // bolt is the enemy's `Health.knockback` now — the hit's source is a
+            // point one px behind it, opposite the bolt's travel, so the kick
+            // lands along the bolt exactly as the hand-written one did.
             const il = Math.hypot(b.vx, b.vy) || 1;
-            en.position = [
-              (en.position[0] ?? 0) + (b.vx / il) * HIT_KNOCK,
-              (en.position[1] ?? 0) + (b.vy / il) * HIT_KNOCK,
-            ];
+            (e as unknown as { behavior?: HealthLike }).behavior?.damage?.(this.damage, [
+              (en.position[0] ?? 0) - b.vx / il,
+              (en.position[1] ?? 0) - b.vy / il,
+            ]);
             this.spark(nx, ny);
             if (b.pierce <= 0) {
               dead = true;

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

@@ -16,7 +16,9 @@
         "right": ["KeyD", "ArrowRight"]
       },
       "touch": "joystick"
-    }
+    },
+    "pause": { "type": "button", "keys": ["Escape"] },
+    "restart": { "type": "button", "keys": ["KeyR"] }
   },
   "assets": {
     "knight": {
@@ -108,7 +110,10 @@
               "visible": false,
               "collider": { "shape": "circle", "radius": 15 }
             },
-            "script": { "name": "Health", "props": { "max": 3, "freeOnDeath": true } },
+            "script": {
+              "name": "Health",
+              "props": { "max": 3, "freeOnDeath": true, "knockback": 240, "staggerSeconds": 0.1 }
+            },
             "children": [
               {
                 "name": "Skin",
@@ -185,7 +190,10 @@
               "visible": false,
               "collider": { "shape": "circle", "radius": 14 }
             },
-            "script": { "name": "Health", "props": { "max": 5, "freeOnDeath": true } },
+            "script": {
+              "name": "Health",
+              "props": { "max": 5, "freeOnDeath": true, "knockback": 240, "staggerSeconds": 0.1 }
+            },
             "children": [
               {
                 "name": "Skin",
@@ -303,6 +311,111 @@
         "type": "AudioPlayer",
         "props": { "preset": "lose", "bus": "sfx", "volume": 0.8 },
         "uid": "n_9c48ixvudwh3egqc"
+      },
+      {
+        "name": "Flow",
+        "type": "Node",
+        "uid": "n_k1b5tdq7qfgute05",
+        "script": { "name": "GameFlow" }
+      },
+      {
+        "name": "Hud",
+        "type": "HudLayer",
+        "uid": "n_t21l3ly0b78tuyhf",
+        "children": [
+          {
+            "name": "PauseMenu",
+            "type": "UiPanel",
+            "uid": "n_4zudk60s8o480dzn",
+            "props": {
+              "anchor": "center",
+              "layout": "column",
+              "gap": 12,
+              "padding": 22,
+              "visible": false,
+              "background": "rgba(10,14,22,0.92)",
+              "radius": 12
+            },
+            "children": [
+              {
+                "name": "PausedTitle",
+                "type": "UiText",
+                "uid": "n_jkw1i6abam6b2ich",
+                "props": { "text": "PAUSED", "size": 26 }
+              },
+              {
+                "name": "Resume",
+                "type": "UiButton",
+                "uid": "n_4xe73y1h6dfx33xx",
+                "props": { "text": "RESUME", "size": 18 }
+              },
+              {
+                "name": "PauseOptions",
+                "type": "UiButton",
+                "uid": "n_vld87yos9y2n1ktz",
+                "props": { "text": "OPTIONS", "size": 16 }
+              },
+              {
+                "name": "Restart",
+                "type": "UiButton",
+                "uid": "n_vwt3fbpsozqfdm80",
+                "props": { "text": "START OVER", "size": 16 }
+              }
+            ]
+          },
+          {
+            "name": "Options",
+            "type": "UiPanel",
+            "uid": "n_u1q9tf8qi4kd95xc",
+            "props": {
+              "anchor": "center",
+              "layout": "column",
+              "gap": 10,
+              "padding": 22,
+              "visible": false,
+              "background": "rgba(10,14,22,0.92)",
+              "radius": 12
+            },
+            "children": [
+              {
+                "name": "OptionsTitle",
+                "type": "UiText",
+                "uid": "n_9m4wm8glz3ah8rr3",
+                "props": { "text": "OPTIONS", "size": 24 }
+              },
+              {
+                "name": "Master",
+                "type": "UiVolumeSlider",
+                "uid": "n_0xk7mn0j15d0kaq2",
+                "props": { "label": "master", "bus": "master", "width": 260 }
+              },
+              {
+                "name": "Sfx",
+                "type": "UiVolumeSlider",
+                "uid": "n_fdvxcfvz0c2axgm9",
+                "props": { "label": "effects", "bus": "sfx", "width": 260 }
+              },
+              {
+                "name": "Mute",
+                "type": "UiMuteToggle",
+                "uid": "n_f8cpyypniznhbja3",
+                "props": { "label": "mute everything" }
+              },
+              {
+                "name": "Quality",
+                "type": "UiQualitySelect",
+                "uid": "n_d97o1nvn1ujgjfwe",
+                "props": { "label": "quality" }
+              },
+              {
+                "name": "Back",
+                "type": "UiButton",
+                "uid": "n_0c24jyr9ddbkk5vb",
+                "props": { "text": "BACK", "size": 16 }
+              }
+            ]
+          }
+        ]
       }
     ],
     "uid": "n_tlqu945vs98khzn8"
@@ -311,6 +424,31 @@
     { "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": "lost", "from": "/root", "to": "SfxLose", "handler": "play" },
+    {
+      "from": "/root/Hud/PauseMenu/Resume",
+      "signal": "pressed",
+      "to": "/root/Flow",
+      "handler": "resume"
+    },
+    {
+      "from": "/root/Hud/PauseMenu/PauseOptions",
+      "signal": "pressed",
+      "to": "/root/Flow",
+      "handler": "screen",
+      "args": ["/root/Hud/Options"]
+    },
+    {
+      "from": "/root/Hud/PauseMenu/Restart",
+      "signal": "pressed",
+      "to": "/root/Flow",
+      "handler": "restart"
+    },
+    {
+      "from": "/root/Hud/Options/Back",
+      "signal": "pressed",
+      "to": "/root/Flow",
+      "handler": "back"
+    }
   ]
 }

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

@@ -90,6 +90,7 @@ interface HealthB {
 {
   let kills = 0;
   let xpShards = 0;
+  let retreat = 0; // px a bolt shoved the goblin back from its closest approach (Health.knockback)
   const result = await runScript(sceneJson, {
     durationMs: 5000,
     seed: 2,
@@ -107,9 +108,20 @@ interface HealthB {
           };
           const enemy = spawner.spawn() as unknown as Vec | null;
           if (enemy) enemy.position = [(player.position[0] ?? 0) + 200, player.position[1] ?? 0];
+          let nearest = Number.POSITIVE_INFINITY;
           for (let i = 0; i < 260; i++) {
             if ((player.behavior as unknown as SurvivorB).kills >= 1) break;
             ctx.engine.step();
+            // a chaser only ever closes in; every step it is FURTHER than its
+            // closest approach so far is a hit that moved it
+            if (enemy && (enemy as unknown as { tree: unknown }).tree) {
+              const d = Math.hypot(
+                (enemy.position[0] ?? 0) - (player.position[0] ?? 0),
+                (enemy.position[1] ?? 0) - (player.position[1] ?? 0),
+              );
+              nearest = Math.min(nearest, d);
+              retreat = Math.max(retreat, d - nearest);
+            }
           }
           kills = (player.behavior as unknown as SurvivorB).kills;
           xpShards = ctx.scene.tree.getNodesInGroup('xp').length;
@@ -118,6 +130,7 @@ interface HealthB {
     ],
   });
   ok('the auto-attack killed an enemy', kills >= 1);
+  ok(`a bolt SHOVED the goblin back ${retreat.toFixed(1)} px (Health.knockback)`, retreat >= 10);
   ok('a dead enemy dropped an XP shard', xpShards >= 1);
   ok('runScript reported no failures (attack path)', result.ok);
 }

package/templates-app/tps-3d/PROJECT/Status.md

@@ -78,3 +78,9 @@ camera to 0.45 m (4.2 in the open); standing still on the lift for two seconds,
 and Cliff plateaus, the Lift and a double jump reach over the 3 m walls (24 playtests fell
 3 times before it, none after). `verify.ts` drops the player over Wall1 and asserts the catch.
 
+## Pausing
+
+ESC pauses and shows the pause menu; OPTIONS opens the settings over it and
+BACK returns to the menu that asked. All of it is `GameFlow` (`pausePanelPath`,
+`screen(path)`, `back()`) wired with `connections` — there is no TypeScript for
+any screen in this game.

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

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

@@ -809,22 +809,58 @@
                 "uid": "n_ffjlx3r053emjjhc"
               },
               {
-                "name": "ResumeHint",
+                "name": "Resume",
+                "type": "UiButton",
+                "uid": "n_ibf6agaxzcxjhcmg",
+                "props": { "text": "RESUME", "size": 18 }
+              },
+              {
+                "name": "PauseOptions",
+                "type": "UiButton",
+                "uid": "n_kdecsevdetjk0q1i",
+                "props": { "text": "OPTIONS", "size": 16 }
+              },
+              {
+                "name": "Restart",
+                "type": "UiButton",
+                "uid": "n_vaxmkxrqot30vd7u",
+                "props": { "text": "START OVER", "size": 16 }
+              }
+            ],
+            "uid": "n_8bcregfz1ajwi03l"
+          },
+          {
+            "name": "Options",
+            "type": "UiPanel",
+            "uid": "n_36ox1wee9cdz2cgj",
+            "props": {
+              "anchor": "center",
+              "layout": "column",
+              "gap": 10,
+              "padding": 22,
+              "visible": false,
+              "background": "rgba(10,14,22,0.92)",
+              "radius": 12
+            },
+            "children": [
+              {
+                "name": "OptionsTitle",
                 "type": "UiText",
-                "props": {
-                  "text": "Esc to resume · Enter to restart",
-                  "size": 13,
-                  "color": "#c9d2dd"
-                },
-                "uid": "n_atxlw44pqdn146zj"
+                "uid": "n_3nt1ztixpsvjtb86",
+                "props": { "text": "OPTIONS", "size": 24 }
               },
               { "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" }
-            ],
-            "uid": "n_8bcregfz1ajwi03l"
+              { "name": "FrameCap", "type": "UiFrameCapSelect", "uid": "n_mgqwgghn0bx900ip" },
+              {
+                "name": "Back",
+                "type": "UiButton",
+                "uid": "n_0ytaknljuqmthwpl",
+                "props": { "text": "BACK", "size": 16 }
+              }
+            ]
           }
         ],
         "uid": "n_dimifr19c9et8cr4"
@@ -843,6 +879,31 @@
       "to": "Arena/Mine",
       "handler": "startTimer",
       "filter": { "group": "player" }
+    },
+    {
+      "from": "/root/HUD/PauseMenu/Resume",
+      "signal": "pressed",
+      "to": "/root/Flow",
+      "handler": "resume"
+    },
+    {
+      "from": "/root/HUD/PauseMenu/PauseOptions",
+      "signal": "pressed",
+      "to": "/root/Flow",
+      "handler": "screen",
+      "args": ["/root/HUD/Options"]
+    },
+    {
+      "from": "/root/HUD/PauseMenu/Restart",
+      "signal": "pressed",
+      "to": "/root/Flow",
+      "handler": "restart"
+    },
+    {
+      "from": "/root/HUD/Options/Back",
+      "signal": "pressed",
+      "to": "/root/Flow",
+      "handler": "back"
     }
   ]
 }

package/templates-app/village-quest-3d/PROJECT/Status.md

@@ -24,3 +24,10 @@
 ## Known limitations / ideas
 
 - A hurt/attack clip for the wolves once one lands in the animation catalog.
+
+## Pausing
+
+ESC pauses and shows the pause menu; OPTIONS opens the settings over it and
+BACK returns to the menu that asked. All of it is `GameFlow` (`pausePanelPath`,
+`screen(path)`, `back()`) wired with `connections` — there is no TypeScript for
+any screen in this game.

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