incanto 0.10.0 → 0.12.0

package/editor/index.html

@@ -5,7 +5,7 @@
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>Incanto Scene Editor</title>
     <link rel="icon" href="data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'><rect width='16' height='16' rx='3' fill='%236ee7dc'/><text x='8' y='12' text-anchor='middle' font-size='11' font-family='monospace' fill='%230e1018'>i</text></svg>" />
-    <script type="module" crossorigin src="./assets/index-Dp_cYQx1.js"></script>
+    <script type="module" crossorigin src="./assets/index-s0DZuroe.js"></script>
     <link rel="modulepreload" crossorigin href="./assets/GameServer-C56iOUgF.js">
     <link rel="stylesheet" crossorigin href="./assets/index-D8QvwvOm.css">
   </head>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "incanto",
-  "version": "0.10.0",
+  "version": "0.12.0",
   "description": "Vibe-coding-first web game engine SDK — JSON-driven scenes on three.js",
   "keywords": [
     "game-engine",

package/skills/incanto-3d-character.md

@@ -56,9 +56,14 @@ character stays centered even while the camera is catching up or pulled in by a
 collision — no jitter.
 
 **Camera collision (spring arm).** For the orbit views (`free`/`quarter`/`side`)
-the camera won't clip through walls or the ground: each frame it raycasts from
-the eye toward the camera and, if a collider blocks the boom, smoothly pulls the
-camera in front of it (plus a ground backstop so it never drops below the floor).
+the camera won't clip through walls or the ground: each frame it sweeps a small
+SPHERE (not a thin ray — a ray that skims 10 cm over a wall reports "clear"
+while the wall still fills the frame) from the eye toward the camera and, if a
+collider blocks the boom, smoothly pulls the camera in front of it (plus a
+ground backstop so it never drops below the floor).
+Level-design corollary: walls you want the camera to respect must be TALLER
+than the eye line (`player y + eyeHeight`, ~1.9 m for a default rig) — a
+1.8 m hedge is below the boom entirely and the camera will look over it.
 This is on by default (`cameraCollision: true`); set it `false` to get the old raw
 orbit. Only the STATIC/fixed world stops it — give walls/floors/terrain a
 `StaticBody3D` collider (collider-less meshes are invisible to the ray, same as to
@@ -141,7 +146,8 @@ A sword in the hand, a hat on the head, sparks on a wingtip — parent them to a
 - Purely VISUAL: it follows the rendered skeleton, so headless the node stays
   at its prop transform — keep hit checks range-based from the body, never
   bone-based.
-- `model.boneNames()` lists every bone at runtime when you need to hunt one.
+- `model.boneNames()` lists every bone at runtime when you need to hunt one
+  (the editor's inspector offers the same list as a dropdown on the `bone` prop).
 
 ## Facing a direction in 3D — the +Z-FORWARD rule (read before turning ANY skin)
 

package/skills/incanto-building-3d-games.md

@@ -283,6 +283,14 @@ demo into a commercial-looking outdoor scene:
   dreamier), `strength` how strongly the blurred glow is added back (default
   0.85; ~1.2 = neon night). One extra half-res blur pass per frame — cheap.
   Caustics/clouds composites take precedence (pipelines don't stack yet).
+- `post`: the color-grade tail — `{ "vignette"?, "saturation"?, "contrast"? }`.
+  `vignette` 0..1 darkens the corners (0.3 = cinematic, 0.6 = heavy mood);
+  `saturation` 0..4 (0 = grayscale, 1 = neutral, 1.2 = vivid); `contrast`
+  0.2..3 around mid-gray (1 = neutral). Applied after tone mapping on the same
+  composite pass as bloom — declaring `post` WITHOUT `bloom` costs just one
+  offscreen pass. The fastest way to give a scene a LOOK: dusk = vignette 0.35
+  + saturation 0.85, candy = saturation 1.25 + contrast 1.08. Caustics/clouds
+  composites take precedence (pipelines don't stack yet).
 - `shadows`: `true` | `false` | `{ "mapSize": 1024|2048, "radius": n }`.
   Truthy makes the main DirectionalLight cast (PCF soft, terrain + trees +
   meshes cast/receive, mesh grass RECEIVES only). One static ortho box (±75 m
@@ -388,6 +396,33 @@ from a `seed`, with `heightAt(x, z)` for spawning/placement and a
 `StaticBody3D`). Full themes table, custom layer format and the water/beach
 pairing live in the **incanto-environment** skill.
 
+### Navigation on terrain (`buildTerrainNav` + findPath)
+
+Enemies that chase across an open world need paths that respect the surface —
+`buildTerrainNav` samples the heightfield into a walkable grid for the core
+A* (`findPath`), and lifts waypoints back ONTO the surface:
+
+```ts
+import { buildTerrainNav } from 'incanto/3d';
+import { findPath } from 'incanto';
+
+const nav = buildTerrainNav(terrain, {
+  cellSize: 2,        // meters per cell (character-scale corridors)
+  maxSlopeDeg: 40,    // steeper cells are unwalkable
+  minHeight: 0.5,     // below sea level = unwalkable (pair with your Water3D y)
+});
+const cells = findPath(nav.grid, nav.toCell(ex, ez), nav.toCell(px, pz));
+if (cells) follow.setPath(cells.map(([cx, cy]) => nav.toWorld(cx, cy)));
+// nav.toWorld's y IS the terrain height — PathFollow rides the surface.
+```
+
+- Build it ONCE per scene (onReady) — sampling is O(cells); re-pathing with
+  `findPath` per second is cheap (binary-heap A*).
+- Trees/rocks/buildings aren't in the heightfield: stamp them out with
+  `nav.setSolid(...nav.toCell(x, z))` after building.
+- Walkability is judged inside each cell (corner samples), so a flat trail
+  beside a cliff stays walkable — only genuinely steep cells go solid.
+
 ## Performance levers for big scenes
 
 - **`static: true`** (any Node3D): the renderer syncs that subtree ONCE and

package/skills/incanto-editor.md

@@ -119,9 +119,9 @@ active brush. The palette chips offer every char already used in `cells`, the
 single char (digits map straight to atlas tile indices, other chars need a
 `legend` entry). The grid grows right/down automatically when you paint past
 the edge — to grow left/up, move the node instead (cell (0,0) hangs on the
-node origin). Merged solid colliders re-derive live as you paint. Each painted
-cell is one undo step; toggle paint off (or select another node) to get normal
-click-select back.
+node origin). Merged solid colliders re-derive live as you paint. A whole
+drag stroke is ONE undo step; toggle paint off (or select another node) to
+get normal click-select back.
 
 ## Generate environments
 

package/skills/incanto-physics-and-input.md

@@ -173,6 +173,14 @@ const hit = physics.castRay(origin, dir, maxLen, excludeBody?, { staticOnly?: tr
 
 Exclude the shooter's own body when casting from inside it.
 
+3D also has a THICK ray — a sphere sweep — for probes where skimming matters
+(the camera boom, ledge feelers):
+
+```ts
+const hit = physics.castSphere(origin, dir, radius, maxLen, excludeBody?, { staticOnly?: true });
+// → { distance, node } | null   (distance = travel of the sphere CENTER)
+```
+
 ## Gamepad
 
 `engine.input.attachGamepad(engine)` polls the first connected pad every