incanto 0.71.0 → 0.73.0

package/templates-app/beacon-isle-3d/verify.ts

@@ -285,3 +285,147 @@ const ok = (label: string, cond: boolean): void => {
 }
 
 console.log(process.exitCode ? '\nVERIFY FAILED' : '\nVERIFY OK');
+
+// ---- HEIGHTFIELD: this round's surfaces, on terrain instead of a flat arena -----
+// A trampoline pad snapped to the island (`snapToGround: 0.1` on a StaticBody3D
+// with `restitution 1`), a dead ball dropped on it, and a `CharacterBody3D`
+// walker chasing the player up the island's slope (`Chase.ground` auto: the
+// KCC's slopeLimitDeg and stepHeight decide, gravity keeps it on the ground).
+{
+  type Vec = { position: number[] };
+  type Terrain = { heightAt(x: number, z: number): number };
+  const ballY: number[] = [];
+  let walkerFrom: number[] = [];
+  let walkerTo: number[] = [];
+  let groundUnderWalker = 0;
+  let targetY = 0;
+  let closed = 0;
+  const result = await runScript(gameJson, {
+    behaviors: BEHAVIORS,
+    durationMs: 8000,
+    steps: [
+      {
+        atMs: 100,
+        do: (ctx) => {
+          const pad = ctx.getNode('/root/Pad') as unknown as Vec;
+          const ball = ctx.getNode('/root/Ball') as unknown as Vec;
+          ball.position = [pad.position[0] ?? 0, (pad.position[1] ?? 0) + 3, pad.position[2] ?? 0];
+        },
+      },
+      ...Array.from({ length: 30 }, (_, i) => ({
+        atMs: 200 + i * 100,
+        do: (ctx: { getNode(p: string): unknown }) => {
+          ballY.push((ctx.getNode('/root/Ball') as Vec).position[1] ?? 0);
+        },
+      })),
+      {
+        atMs: 3300,
+        do: (ctx) => {
+          const terrain = ctx.getNode('/root/Terrain/Ground/Surface') as unknown as Terrain;
+          const walker = ctx.getNode('/root/Walker') as unknown as Vec;
+          const player = ctx.getNode('/root/Player') as unknown as Vec;
+          const [wx = 0, , wz = 0] = walker.position;
+          // the steepest way UP from the walker, 10 m out: that is where the player goes
+          let best = { x: wx + 10, z: wz, h: -Infinity };
+          for (let a = 0; a < 16; a++) {
+            const x = wx + 10 * Math.cos((a / 16) * Math.PI * 2);
+            const z = wz + 10 * Math.sin((a / 16) * Math.PI * 2);
+            const h = terrain.heightAt(x, z);
+            if (h > best.h) best = { x, z, h };
+          }
+          player.position = [best.x, best.h + 1.4, best.z];
+          targetY = best.h;
+          walkerFrom = [...walker.position];
+          const d0 = Math.hypot(best.x - wx, best.z - wz);
+          for (let i = 0; i < 240; i++) ctx.engine.step();
+          walkerTo = [...walker.position];
+          const [tx = 0, , tz = 0] = walkerTo;
+          groundUnderWalker = terrain.heightAt(tx, tz);
+          closed = d0 - Math.hypot(best.x - tx, best.z - tz);
+          player.position = [-4.5, 18.73, 70.5]; // and back to the spawn for the quest
+        },
+      },
+    ],
+  });
+  ok('runScript reported no failures (HEIGHTFIELD path)', result.ok);
+  let touch = ballY.findIndex((y, i) => i > 0 && y > (ballY[i - 1] ?? 0));
+  if (touch < 1) touch = 1;
+  const low = ballY[touch - 1] ?? 0;
+  const rebound = Math.max(...ballY.slice(touch)) - low;
+  ok(
+    `a pad snapped to the island with restitution 1 launches a dead ball back up ${rebound.toFixed(2)} m of its 3 m drop`,
+    rebound > 1.8,
+  );
+  const rose = (walkerTo[1] ?? 0) - (walkerFrom[1] ?? 0);
+  const gap = targetY - (walkerFrom[1] ?? 0);
+  ok(
+    `the walker chased the player UP the slope: closed ${closed.toFixed(1)} m of 10, rose ${rose.toFixed(2)} m of a ${gap.toFixed(2)} m climb`,
+    closed > 5 && rose > gap * 0.5,
+  );
+  const hover = (walkerTo[1] ?? 0) - groundUnderWalker;
+  ok(
+    `…and stayed on the ground while doing it (capsule centre ${hover.toFixed(2)} m over the terrain, 0.95 expected)`,
+    hover > 0.5 && hover < 1.6,
+  );
+}
+
+// ---- FLOATS: what `Buoyancy.water`, `samples` and `drag` do on the open sea --------
+// Set by no example: every raft in the repo took the first Water3D, four samples
+// and the default drag. Two crates float west of the island (the heightfield
+// ends at x −120): the Buoy names its water, samples once and says `drag: 0.1`;
+// the Crate keeps the defaults. Both `drift: 0`, so a 3 m/s shove is the only
+// thing moving them and drag is the only thing that differs. Asserted by how
+// far each travels in 2 s — e^{-drag·t} says 5.4 m against 2.8 m — and by both
+// still sitting at the waterline afterwards.
+{
+  type Vec = { position: number[] };
+  type Body = { mass: number; applyImpulse(i: [number, number, number]): void };
+  type Water = { heightAt(x: number, z: number): number };
+  let buoyRest = 0;
+  let crateRest = 0;
+  let buoyRun = 0;
+  let crateRun = 0;
+  let buoyOver = 99;
+  let crateOver = 99;
+  const result = await runScript(gameJson, {
+    behaviors: BEHAVIORS,
+    durationMs: 8000,
+    steps: [
+      {
+        atMs: 100,
+        do: (ctx) => {
+          const sea = ctx.getNode('/root/Terrain/Sea') as unknown as Water;
+          const buoy = ctx.getNode('/root/Buoy') as unknown as Vec & Body;
+          const crate = ctx.getNode('/root/Crate') as unknown as Vec & Body;
+          for (let i = 0; i < 240; i++) ctx.engine.step(); // 4 s to settle on the waterline
+          buoyRest = buoy.position[1] ?? 0;
+          crateRest = crate.position[1] ?? 0;
+          const bx = buoy.position[0] ?? 0;
+          const cx = crate.position[0] ?? 0;
+          buoy.applyImpulse([3 * buoy.mass, 0, 0]);
+          crate.applyImpulse([3 * crate.mass, 0, 0]);
+          for (let i = 0; i < 120; i++) ctx.engine.step();
+          buoyRun = (buoy.position[0] ?? 0) - bx;
+          crateRun = (crate.position[0] ?? 0) - cx;
+          buoyOver =
+            (buoy.position[1] ?? 0) - sea.heightAt(buoy.position[0] ?? 0, buoy.position[2] ?? 0);
+          crateOver =
+            (crate.position[1] ?? 0) - sea.heightAt(crate.position[0] ?? 0, crate.position[2] ?? 0);
+        },
+      },
+    ],
+  });
+  ok('runScript reported no failures (FLOATS path)', result.ok);
+  ok(
+    `water "/root/Terrain/Sea", samples 1: the Buoy settles at y ${buoyRest.toFixed(2)} (sea 9.19 + draft 0.35 ≈ 9.54), the Crate at ${crateRest.toFixed(2)}`,
+    Math.abs(buoyRest - 9.54) < 0.5 && Math.abs(crateRest - 9.54) < 0.5,
+  );
+  ok(
+    `drag 0.1 vs 0.9: the same 3 m/s shove carries the Buoy ${buoyRun.toFixed(2)} m and the Crate ${crateRun.toFixed(2)} m in 2 s (5.4 vs 2.8 expected)`,
+    buoyRun > crateRun * 1.5 && buoyRun > 4 && crateRun > 1.5 && crateRun < 3.5,
+  );
+  ok(
+    `…and both still ride the waterline (${buoyOver.toFixed(2)} m and ${crateOver.toFixed(2)} m over the sea)`,
+    Math.abs(buoyOver - 0.35) < 0.5 && Math.abs(crateOver - 0.35) < 0.5,
+  );
+}

package/templates-app/molehill-2d/package.json

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

package/templates-app/platformer-2d/PROJECT/Status.md

@@ -58,3 +58,10 @@
 - One hand-authored level — extend by copying nodes into the right GROUP
   (`enemy`/`hazard`/`pit`/`checkpoint`/`platform`); `PlayerController` picks them
   up with no extra wiring.
+
+## The round's surfaces, in 2D (2026-09-04)
+
+A course past GroundD (x 3000+): `Trampoline` (`restitution 1`) with a dead `Bouncer`, `Ice`
+(`friction 0`) with a `Sled` at 260 px/s, and a `Hound` (`CharacterBody2D` + `Chase`
+`ground: true`) under a `Perch`. `verify.ts` measures the rebound (287 of 300 px), the slide
+(400 px of ice) and that the hound stays on the floor under a perched player.

package/templates-app/platformer-2d/PROJECT/Structure.md

@@ -75,3 +75,6 @@ The vibe-coding rules: read the skills, JSON structure, built-ins first, omit
 uids, declared assets, y-down space, collider props, GROUP-DRIVEN centralised
 damage (§8), deferred engine access (§11), debug draw, delta discipline, verify
 like a user.
+
+- `CourseFloor`, `Trampoline`, `Bouncer`, `Ice`, `Sled`, `Hound`, `Perch` — the harness's course for
+  the 2D surfaces and the ground chaser.

package/templates-app/platformer-2d/package.json

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