npm - incanto - Versions diffs - 0.36.2 → 0.38.0 - Mend

incanto 0.36.2 → 0.38.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (57) hide show

package/bin/incanto-feel.mjs +93 -0
package/bin/incanto-playtest.mjs +136 -0
package/dist/2d.d.ts +2 -2
package/dist/2d.js +3 -3
package/dist/3d.d.ts +44 -3
package/dist/3d.js +4 -32
package/dist/{behavior-DibCwrW7.d.ts → behavior-B5PJ32eu.d.ts} +106 -6
package/dist/{create-game-D-StzrTj.js → create-game-C4t5gVhc.js} +5 -5
package/dist/{create-game-DnOu2aAa.js → create-game-DqY2lMBc.js} +783 -689
package/dist/debug.d.ts +1 -1
package/dist/{duplicate-Cvb1BSca.js → duplicate-CRtihGmC.js} +1 -1
package/dist/editor.js +21 -0
package/dist/{environment-presets-fK9oyrrR.js → environment-presets-C0Axpfth.js} +75 -9
package/dist/{gameplay-C0MUMSak.js → gameplay-CsJDUQh_.js} +2 -2
package/dist/gameplay.d.ts +1 -1
package/dist/gameplay.js +1 -1
package/dist/index.d.ts +4 -50
package/dist/index.js +5 -75
package/dist/{loader-BqigZsfF.d.ts → loader-DSMdqasu.d.ts} +1 -1
package/dist/{loader-DAZlgqeC.js → loader-r49nDwB4.js} +15 -0
package/dist/net.d.ts +1 -1
package/dist/net.js +3 -3
package/dist/{pathfinding-B3QtdhvZ.d.ts → pathfinding-BrE5Uec6.d.ts} +1 -1
package/dist/{physics-2d-B4v39hca.js → physics-2d-OfKb0PV_.js} +2 -2
package/dist/{physics-3d-DFJVMYET.js → physics-3d-C8242nXr.js} +3 -3
package/dist/react.d.ts +1 -1
package/dist/react.js +1 -1
package/dist/{register-DXwtIVqP.js → register-B4RRQbyq.js} +2 -2
package/dist/{register-BHAwM4bK.js → register-Dm7nrd-E.js} +322 -34
package/dist/{register-COGCNitr.js → register-DnB9m7Rl.js} +2 -2
package/dist/replay-Cxrr-ApH.d.ts +86 -0
package/dist/{audit-D7F3n3Nt.js → replay-DH0UOuZ-.js} +72 -2
package/dist/test-CoDPWx-m.js +1404 -0
package/dist/test.d.ts +113 -4
package/dist/test.js +3 -3
package/dist/vite.js +1 -1
package/editor/assets/{agent8-DMvBVhe4.js → agent8-BtIlblPm.js} +1 -1
package/editor/assets/{debug-BgAq55oC.js → debug-BvTmHXI7.js} +1 -1
package/editor/assets/{index-Cy_QsKbh.js → index-BS01WWgM.js} +91 -91
package/editor/index.html +1 -1
package/package.json +3 -1
package/schemas/scene.schema.json +318 -0
package/skills/incanto-3d-character.md +35 -0
package/skills/incanto-building-2d-games.md +6 -0
package/skills/incanto-building-3d-games.md +6 -0
package/skills/incanto-game-feel.md +76 -0
package/skills/incanto-node-reference.md +51 -0
package/skills/incanto-performance.md +212 -0
package/skills/incanto-playtesting.md +143 -0
package/skills/incanto-verifying-your-game.md +41 -0
package/templates-app/beacon-isle-3d/package.json +1 -1
package/templates-app/tps-3d/package.json +1 -1
package/templates-app/village-quest-3d/package.json +1 -1
package/templates-app/village-quest-3d/src/village.scene.json +3 -1
package/templates-app/village-quest-3d/verify.ts +55 -5
package/dist/errors-DGRtWlSx.d.ts +0 -39
package/dist/test-X_xE6Yay.js +0 -642

package/editor/index.html CHANGED Viewed

@@ -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-Cy_QsKbh.js"></script>
+    <script type="module" crossorigin src="./assets/index-BS01WWgM.js"></script>
     <link rel="modulepreload" crossorigin href="./assets/GameServer-C56iOUgF.js">
   </head>
   <body>

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "incanto",
-  "version": "0.36.2",
+  "version": "0.38.0",
   "description": "Vibe-coding-first web game engine SDK — JSON-driven scenes on three.js",
   "keywords": [
     "game-engine",
@@ -95,6 +95,8 @@
     "incanto-assets": "bin/incanto-assets.mjs",
     "incanto-env": "bin/incanto-env.mjs",
     "incanto-play": "bin/incanto-play.mjs",
+    "incanto-playtest": "bin/incanto-playtest.mjs",
+    "incanto-feel": "bin/incanto-feel.mjs",
     "incanto-new": "bin/incanto-new.mjs"
   }
 }

package/schemas/scene.schema.json CHANGED Viewed

@@ -343,6 +343,9 @@
         {
           "$ref": "#/$defs/UiDialogue"
         },
+        {
+          "$ref": "#/$defs/UiFrameCapSelect"
+        },
         {
           "$ref": "#/$defs/UiImage"
         },
@@ -352,6 +355,12 @@
         {
           "$ref": "#/$defs/UiPanel"
         },
+        {
+          "$ref": "#/$defs/UiQualitySelect"
+        },
+        {
+          "$ref": "#/$defs/UiRenderScaleSelect"
+        },
         {
           "$ref": "#/$defs/UiSelect"
         },
@@ -2054,6 +2063,30 @@
               "type": "number",
               "default": 1.2
             },
+            "coyoteSeconds": {
+              "type": "number",
+              "default": 0
+            },
+            "jumpBufferSeconds": {
+              "type": "number",
+              "default": 0
+            },
+            "jumpCutMultiplier": {
+              "type": "number",
+              "default": 1
+            },
+            "maxJumps": {
+              "type": "number",
+              "default": 1
+            },
+            "airControl": {
+              "type": "number",
+              "default": 0.2
+            },
+            "fallGravity": {
+              "type": "number",
+              "default": 2.5
+            },
             "floatHeight": {
               "type": "number",
               "default": 0.01
@@ -6536,6 +6569,101 @@
       },
       "required": ["name", "type"]
     },
+    "UiFrameCapSelect": {
+      "type": "object",
+      "x-signals": ["dragStarted", "dragCancelled", "droppedOn", "dropped", "changed"],
+      "properties": {
+        "name": {
+          "type": "string"
+        },
+        "uid": {
+          "type": "string"
+        },
+        "type": {
+          "const": "UiFrameCapSelect"
+        },
+        "groups": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "tags": {
+          "type": "object"
+        },
+        "props": {
+          "type": "object",
+          "properties": {
+            "anchor": {
+              "type": "string",
+              "enum": [
+                "topLeft",
+                "top",
+                "topRight",
+                "left",
+                "center",
+                "right",
+                "bottomLeft",
+                "bottom",
+                "bottomRight"
+              ],
+              "default": "topLeft"
+            },
+            "visible": {
+              "type": "boolean",
+              "default": true
+            },
+            "focusable": {
+              "type": "boolean",
+              "default": true
+            },
+            "draggable": {
+              "type": "boolean",
+              "default": false
+            },
+            "dropTarget": {
+              "type": "boolean",
+              "default": false
+            },
+            "label": {
+              "type": "string",
+              "default": "Frame rate"
+            },
+            "options": {
+              "type": "string",
+              "default": "30,60,120,0"
+            },
+            "value": {
+              "type": "string",
+              "default": ""
+            }
+          },
+          "additionalProperties": false
+        },
+        "script": {
+          "type": "object",
+          "properties": {
+            "name": {
+              "type": "string"
+            },
+            "props": {
+              "type": "object"
+            }
+          },
+          "required": ["name"]
+        },
+        "network": {
+          "type": "object"
+        },
+        "children": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/node"
+          }
+        }
+      },
+      "required": ["name", "type"]
+    },
     "UiImage": {
       "type": "object",
       "x-signals": ["dragStarted", "dragCancelled", "droppedOn", "dropped"],
@@ -6859,6 +6987,196 @@
       },
       "required": ["name", "type"]
     },
+    "UiQualitySelect": {
+      "type": "object",
+      "x-signals": ["dragStarted", "dragCancelled", "droppedOn", "dropped", "changed"],
+      "properties": {
+        "name": {
+          "type": "string"
+        },
+        "uid": {
+          "type": "string"
+        },
+        "type": {
+          "const": "UiQualitySelect"
+        },
+        "groups": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "tags": {
+          "type": "object"
+        },
+        "props": {
+          "type": "object",
+          "properties": {
+            "anchor": {
+              "type": "string",
+              "enum": [
+                "topLeft",
+                "top",
+                "topRight",
+                "left",
+                "center",
+                "right",
+                "bottomLeft",
+                "bottom",
+                "bottomRight"
+              ],
+              "default": "topLeft"
+            },
+            "visible": {
+              "type": "boolean",
+              "default": true
+            },
+            "focusable": {
+              "type": "boolean",
+              "default": true
+            },
+            "draggable": {
+              "type": "boolean",
+              "default": false
+            },
+            "dropTarget": {
+              "type": "boolean",
+              "default": false
+            },
+            "label": {
+              "type": "string",
+              "default": "Quality"
+            },
+            "options": {
+              "type": "string",
+              "default": "low,medium,high"
+            },
+            "value": {
+              "type": "string",
+              "default": ""
+            }
+          },
+          "additionalProperties": false
+        },
+        "script": {
+          "type": "object",
+          "properties": {
+            "name": {
+              "type": "string"
+            },
+            "props": {
+              "type": "object"
+            }
+          },
+          "required": ["name"]
+        },
+        "network": {
+          "type": "object"
+        },
+        "children": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/node"
+          }
+        }
+      },
+      "required": ["name", "type"]
+    },
+    "UiRenderScaleSelect": {
+      "type": "object",
+      "x-signals": ["dragStarted", "dragCancelled", "droppedOn", "dropped", "changed"],
+      "properties": {
+        "name": {
+          "type": "string"
+        },
+        "uid": {
+          "type": "string"
+        },
+        "type": {
+          "const": "UiRenderScaleSelect"
+        },
+        "groups": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "tags": {
+          "type": "object"
+        },
+        "props": {
+          "type": "object",
+          "properties": {
+            "anchor": {
+              "type": "string",
+              "enum": [
+                "topLeft",
+                "top",
+                "topRight",
+                "left",
+                "center",
+                "right",
+                "bottomLeft",
+                "bottom",
+                "bottomRight"
+              ],
+              "default": "topLeft"
+            },
+            "visible": {
+              "type": "boolean",
+              "default": true
+            },
+            "focusable": {
+              "type": "boolean",
+              "default": true
+            },
+            "draggable": {
+              "type": "boolean",
+              "default": false
+            },
+            "dropTarget": {
+              "type": "boolean",
+              "default": false
+            },
+            "label": {
+              "type": "string",
+              "default": "Resolution"
+            },
+            "options": {
+              "type": "string",
+              "default": "0.5,0.75,1"
+            },
+            "value": {
+              "type": "string",
+              "default": ""
+            }
+          },
+          "additionalProperties": false
+        },
+        "script": {
+          "type": "object",
+          "properties": {
+            "name": {
+              "type": "string"
+            },
+            "props": {
+              "type": "object"
+            }
+          },
+          "required": ["name"]
+        },
+        "network": {
+          "type": "object"
+        },
+        "children": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/node"
+          }
+        }
+      },
+      "required": ["name", "type"]
+    },
     "UiSelect": {
       "type": "object",
       "x-signals": ["dragStarted", "dragCancelled", "droppedOn", "dropped", "changed"],

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

@@ -39,6 +39,41 @@ capsule BOTTOM `floatHeight` above the ground (5-ray probe). Author the Skin
 y-offset as `-(halfHeight + radius + floatHeight)` so the feet sit at the
 capsule bottom (the example templates do this).
+## Game feel — the props a jump needs to stop feeling broken
+A jump that only fires while the ground ray says so feels BROKEN, and players do
+not report it as "the coyote time is missing" — they report the game as
+unresponsive. `CharacterController2D` got these in 0.33.0; the 3D controller
+did not until now.
+| prop | default | what it buys |
+|---|---|---|
+| `coyoteSeconds` | `0` | jump this long AFTER walking off a ledge. **The single biggest one** — try `0.12`. |
+| `jumpBufferSeconds` | `0` | press jump this long BEFORE landing and still get it. Try `0.15`. |
+| `jumpCutMultiplier` | `1` | release early and the rise is cut to this fraction. `0.45` = variable-height jump. |
+| `maxJumps` | `1` | `2` = double jump. Extra jumps work in mid-air. |
+| `airControl` | `0.2` | how much ground control you keep airborne (0 = committed, 1 = full). |
+| `fallGravity` | `2.5` | gravity multiplier while falling. Higher = snappier arc. |
+Every one defaults to OFF (`0` / `1`) or to the previous hard-coded constant, so
+a scene that asks for nothing behaves exactly as before.
+```json
+{ "name": "Ctl", "type": "CharacterController3D",
+  "props": { "coyoteSeconds": 0.12, "jumpBufferSeconds": 0.15,
+             "jumpCutMultiplier": 0.45, "maxJumps": 2 } }
+```
+**Jump reads the button EDGE.** Holding the jump key no longer re-jumps every
+frame — that auto-hop was never intended and it made coyote time incoherent (a
+held button would re-fire through the whole window).
+**Two ground senses, deliberately.** `grounded` stays generous (slack for the
+hover spring, so slopes and bumps do not flicker the animation state). The feel
+props and the airborne animation use a stricter test: close to the support AND
+not moving upward. Without the velocity term the check is one frame stale, which
+at launch speed is ~6 cm — enough to still read as standing on the floor.
 ## Views
 | view | what it does | key props |

package/skills/incanto-building-2d-games.md CHANGED Viewed

@@ -329,3 +329,9 @@ Wall moves need to know there IS a wall: `CharacterBody2D` now answers
 `isOnFloor()`. Before, the floor was the only surface a character could report,
 which is why a wall jump was not awkward to write but impossible.
+**And then play it.** `bunx incanto-playtest src/game.scene.json` runs seeded
+headless bot sessions and reports what could not be reached, which wires never
+fired, and whether anything in the level can hurt the player. See
+`incanto-playtesting.md`.

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

@@ -578,3 +578,9 @@ behind it), what lights the scene, and which colliders intersect. Then read
 `stats().errors` (something threw and got skipped) and `assetErrors()` (a model
 404'd). All four are silent failures otherwise — the screen just looks wrong,
 or empty, and nothing throws.
+**And then play it.** `bunx incanto-playtest src/game.scene.json` runs seeded
+headless bot sessions and reports what could not be reached, which wires never
+fired, and whether anything in the level can hurt the player. See
+`incanto-playtesting.md`.

package/skills/incanto-game-feel.md ADDED Viewed

@@ -0,0 +1,76 @@
+---
+name: incanto-game-feel
+description: Measure what your controls actually feel like — bunx incanto-feel reports top speed, ramp and stop times, turnaround, jump apex and airtime, and the coyote/jump-buffer windows MEASURED by probing rather than read from the schema. Use when tuning a character, or when a game "feels off" and you cannot see why.
+---
+# Game feel, as numbers
+`capture()` and `framing()` are snapshots. Feel lives on the **time axis**.
+```bash
+bunx incanto-feel src/game.scene.json
+```
+```
+feel of /Game/Player
+  top speed        5.62 u/s
+  to full speed    383 ms
+  to a stop        133 ms
+  turnaround       367 ms
+  input → motion   1 frame(s)
+  jump apex        0.262 u
+  time to apex     133 ms
+  airtime          267 ms
+  coyote window    100 ms
+  jump buffer      150 ms
+```
+## Why this exists
+**`jumpVelocity: 4` is not a height.** It is an impulse, and what it produces
+depends on gravity, mass, drag and `fallGravity`. The apex in world units and the
+hang time in milliseconds are what you are actually choosing.
+**The windows are MEASURED, not read.** `coyoteMs` comes from probing — lift the
+character clear of its support, wait, press, see whether it launched, binary
+search the boundary. A `coyoteSeconds: 0.12` that the controller never consults
+reports **0 ms**. That was a real bug in this engine's own 3D controller until
+0.37, and the JSON looked correct the entire time.
+## Reading it
+| line | what it tells you |
+|---|---|
+| `to full speed` | acceleration. Under ~100 ms is twitchy-responsive; over ~500 ms is weighty. |
+| `to a stop` | how much you slide. A platformer that overshoots ledges has a long one. |
+| `turnaround` | the cost of changing your mind. The number players feel most and name least. |
+| `input → motion` | 1 frame is immediate. More than 2 and something is buffering. |
+| `jump apex` / `airtime` | compare against the gaps and platform heights in your level. |
+| `coyote window` | **0 reads to players as "the controls are broken"**, not as a missing feature. |
+| `jump buffer` | 0 throws away a press made a few frames before landing. |
+## It reports, it does not grade
+There are no PASS/FAIL bands here on purpose. A twitch platformer and a survival
+horror want opposite numbers, and a table of thresholds invented by an engine
+would be confidently wrong for most games. Two exceptions are called out because
+they are almost never intentional: a coyote window of 0 and a jump buffer of 0.
+## Tuning loop
+```bash
+bunx incanto-feel src/game.scene.json          # measure
+# edit coyoteSeconds / jumpBufferSeconds / jumpVelocity / fallGravity
+bunx incanto-feel src/game.scene.json          # measure again
+```
+The props live on `CharacterController2D` / `CharacterController3D` — see
+`incanto-3d-character.md`.
+## Pairs with the playtester
+`incanto-feel` answers *how does it move*. `incanto-playtest` answers *can it be
+finished*. A level whose jump apex is 0.26 u and whose gaps are 2 u apart will
+show up in the second as `never reached`.

package/skills/incanto-node-reference.md CHANGED Viewed

@@ -277,6 +277,12 @@ Signals: `movementStateChanged(state)`
 | `sprintMultiplier` | `2` | number |
 | `jumpVelocity` | `4` | number |
 | `sprintJumpMultiplier` | `1.2` | number |
+| `coyoteSeconds` | `0` | number |
+| `jumpBufferSeconds` | `0` | number |
+| `jumpCutMultiplier` | `1` | number |
+| `maxJumps` | `1` | number |
+| `airControl` | `0.2` | number |
+| `fallGravity` | `2.5` | number |
 | `floatHeight` | `0.01` | number |
 | `mouseLook` | `true` | boolean |
 | `zoomMin` | `0` | number |
@@ -984,6 +990,21 @@ Signals: `dragStarted` · `dragCancelled` · `droppedOn` · `dropped` · `presse
 Signals: `dragStarted` · `dragCancelled` · `droppedOn` · `dropped` · `lineShown` · `choiceMade` · `dialogueFinished`
+## `UiFrameCapSelect` — `incanto`
+| Prop | Default | Kind |
+|---|---|---|
+| `anchor` | `"topLeft"` | one of: `topLeft` `top` `topRight` `left` `center` `right` `bottomLeft` `bottom` `bottomRight` |
+| `visible` | `true` | boolean |
+| `focusable` | `true` | boolean |
+| `draggable` | `false` | boolean |
+| `dropTarget` | `false` | boolean |
+| `label` | `"Frame rate"` | string |
+| `options` | `"30,60,120,0"` | string |
+| `value` | `""` | string |
+Signals: `dragStarted` · `dragCancelled` · `droppedOn` · `dropped` · `changed`
 ## `UiImage` — `incanto`
 | Prop | Default | Kind |
@@ -1038,6 +1059,36 @@ Signals: `dragStarted` · `dragCancelled` · `droppedOn` · `dropped` · `change
 Signals: `dragStarted` · `dragCancelled` · `droppedOn` · `dropped`
+## `UiQualitySelect` — `incanto`
+| Prop | Default | Kind |
+|---|---|---|
+| `anchor` | `"topLeft"` | one of: `topLeft` `top` `topRight` `left` `center` `right` `bottomLeft` `bottom` `bottomRight` |
+| `visible` | `true` | boolean |
+| `focusable` | `true` | boolean |
+| `draggable` | `false` | boolean |
+| `dropTarget` | `false` | boolean |
+| `label` | `"Quality"` | string |
+| `options` | `"low,medium,high"` | string |
+| `value` | `""` | string |
+Signals: `dragStarted` · `dragCancelled` · `droppedOn` · `dropped` · `changed`
+## `UiRenderScaleSelect` — `incanto`
+| Prop | Default | Kind |
+|---|---|---|
+| `anchor` | `"topLeft"` | one of: `topLeft` `top` `topRight` `left` `center` `right` `bottomLeft` `bottom` `bottomRight` |
+| `visible` | `true` | boolean |
+| `focusable` | `true` | boolean |
+| `draggable` | `false` | boolean |
+| `dropTarget` | `false` | boolean |
+| `label` | `"Resolution"` | string |
+| `options` | `"0.5,0.75,1"` | string |
+| `value` | `""` | string |
+Signals: `dragStarted` · `dragCancelled` · `droppedOn` · `dropped` · `changed`
 ## `UiSelect` — `incanto`
 | Prop | Default | Kind |