npm - incanto - Versions diffs - 0.32.0 → 0.33.0 - Mend

incanto 0.32.0 → 0.33.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 (49) hide show

package/dist/2d.d.ts +59 -2
package/dist/2d.js +3 -3
package/dist/3d.d.ts +8 -3
package/dist/3d.js +4 -4
package/dist/{behavior-D_jMpFh8.d.ts → behavior-CKwTCjfR.d.ts} +140 -1
package/dist/{create-game-bKHgHcsZ.js → create-game-D2QU5x7S.js} +13 -6
package/dist/{create-game-gXI7PYl0.js → create-game-sFuTLqjD.js} +11 -5
package/dist/debug.d.ts +1 -1
package/dist/{duplicate-KRPtUtzl.js → duplicate-BgnG1Lqz.js} +1 -1
package/dist/editor.js +35 -0
package/dist/{environment-presets--DigHNg4.js → environment-presets-CQtEGogB.js} +2 -2
package/dist/{gameplay-BftxM_It.js → gameplay-BpQCbABv.js} +90 -2
package/dist/gameplay.d.ts +1 -1
package/dist/gameplay.js +1 -1
package/dist/index.d.ts +125 -23
package/dist/index.js +5 -58
package/dist/{loader-BlaRQGaA.js → loader-Buk8Bu1h.js} +53 -0
package/dist/{loader-BYBrqTxP.d.ts → loader-COn5fS0o.d.ts} +1 -1
package/dist/net.d.ts +1 -1
package/dist/net.js +3 -3
package/dist/{pathfinding-BwhqPD3i.d.ts → pathfinding-DUw9mir9.d.ts} +1 -1
package/dist/{physics-2d-D9wquBvK.js → physics-2d-DjXR5DMu.js} +12 -2
package/dist/{physics-3d-CnPygVGo.js → physics-3d-DF8npb1O.js} +55 -9
package/dist/react.d.ts +1 -1
package/dist/react.js +1 -1
package/dist/{register-Dzkd6-os.js → register-CscIzJEO.js} +551 -13
package/dist/{register-CUY284Is.js → register-CtI-itec.js} +2 -2
package/dist/{register-tkR_8tWg.js → register-FIJtNbub.js} +145 -8
package/dist/{test-WwRIlXsK.js → test-BRxLd2jH.js} +10 -10
package/dist/test.d.ts +2 -2
package/dist/test.js +1 -1
package/dist/vite.js +1 -1
package/editor/assets/{agent8-C5k1nTCH.js → agent8-BdDP3xKW.js} +1 -1
package/editor/assets/{debug-BT_0mjk-.js → debug-DbjTyTlC.js} +1 -1
package/editor/assets/{index-gfyrByWw.js → index-BWCudoz1.js} +90 -90
package/editor/index.html +1 -1
package/package.json +1 -1
package/schemas/scene.schema.json +520 -0
package/skills/incanto-audio.md +43 -0
package/skills/incanto-building-2d-games.md +36 -0
package/skills/incanto-hud.md +41 -0
package/skills/incanto-node-reference.md +89 -0
package/skills/incanto-physics-and-input.md +50 -0
package/templates-app/beacon-isle-3d/docs/project-3d-rules.md +40 -19
package/templates-app/beacon-isle-3d/package.json +1 -1
package/templates-app/tps-3d/docs/project-3d-rules.md +41 -19
package/templates-app/tps-3d/package.json +1 -1
package/templates-app/village-quest-3d/docs/project-3d-rules.md +40 -19
package/templates-app/village-quest-3d/package.json +1 -1

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-gfyrByWw.js"></script>
+    <script type="module" crossorigin src="./assets/index-BWCudoz1.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.32.0",
+  "version": "0.33.0",
   "description": "Vibe-coding-first web game engine SDK — JSON-driven scenes on three.js",
   "keywords": [
     "game-engine",

package/schemas/scene.schema.json CHANGED Viewed

@@ -322,9 +322,24 @@
         {
           "$ref": "#/$defs/UiDialogue"
         },
+        {
+          "$ref": "#/$defs/UiImage"
+        },
+        {
+          "$ref": "#/$defs/UiPanel"
+        },
+        {
+          "$ref": "#/$defs/UiSelect"
+        },
+        {
+          "$ref": "#/$defs/UiSlider"
+        },
         {
           "$ref": "#/$defs/UiText"
         },
+        {
+          "$ref": "#/$defs/UiToggle"
+        },
         {
           "$ref": "#/$defs/VoxelGrid3D"
         },
@@ -1798,6 +1813,7 @@
     },
     "CharacterController2D": {
       "type": "object",
+      "x-signals": ["movementStateChanged"],
       "properties": {
         "name": {
           "type": "string"
@@ -1840,6 +1856,47 @@
             "jumpAction": {
               "type": "string",
               "default": "jump"
+            },
+            "coyoteSeconds": {
+              "type": "number",
+              "default": 0
+            },
+            "jumpBufferSeconds": {
+              "type": "number",
+              "default": 0
+            },
+            "jumpCutMultiplier": {
+              "type": "number",
+              "default": 1
+            },
+            "maxJumps": {
+              "type": "number",
+              "default": 1
+            },
+            "dashSpeed": {
+              "type": "number",
+              "default": 0
+            },
+            "dashSeconds": {
+              "type": "number",
+              "default": 0.15
+            },
+            "dashAction": {
+              "type": "string",
+              "default": "dash"
+            },
+            "wallSlideSpeed": {
+              "type": "number",
+              "default": 0
+            },
+            "wallJumpImpulse": {
+              "type": "array",
+              "items": {
+                "type": "number"
+              },
+              "minItems": 2,
+              "maxItems": 2,
+              "default": [0, 0]
             }
           },
           "additionalProperties": false
@@ -6383,6 +6440,390 @@
       },
       "required": ["name", "type"]
     },
+    "UiImage": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string"
+        },
+        "uid": {
+          "type": "string"
+        },
+        "type": {
+          "const": "UiImage"
+        },
+        "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
+            },
+            "src": {
+              "type": "string",
+              "default": ""
+            },
+            "width": {
+              "type": "number",
+              "default": 48
+            },
+            "height": {
+              "type": "number",
+              "default": 48
+            },
+            "fit": {
+              "type": "string",
+              "enum": ["contain", "cover", "fill"],
+              "default": "contain"
+            },
+            "tint": {
+              "type": "string",
+              "default": ""
+            },
+            "opacity": {
+              "type": "number",
+              "default": 1
+            }
+          },
+          "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"]
+    },
+    "UiPanel": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string"
+        },
+        "uid": {
+          "type": "string"
+        },
+        "type": {
+          "const": "UiPanel"
+        },
+        "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
+            },
+            "layout": {
+              "type": "string",
+              "enum": ["column", "row", "grid"],
+              "default": "column"
+            },
+            "columns": {
+              "type": "number",
+              "default": 4
+            },
+            "gap": {
+              "type": "number",
+              "default": 8
+            },
+            "padding": {
+              "type": "number",
+              "default": 12
+            },
+            "background": {
+              "type": "string",
+              "default": "rgba(0,0,0,0.55)"
+            },
+            "radius": {
+              "type": "number",
+              "default": 10
+            },
+            "width": {
+              "type": "number",
+              "default": 0
+            },
+            "height": {
+              "type": "number",
+              "default": 0
+            },
+            "border": {
+              "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": ["changed"],
+      "properties": {
+        "name": {
+          "type": "string"
+        },
+        "uid": {
+          "type": "string"
+        },
+        "type": {
+          "const": "UiSelect"
+        },
+        "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
+            },
+            "label": {
+              "type": "string",
+              "default": ""
+            },
+            "options": {
+              "type": "string",
+              "default": ""
+            },
+            "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"]
+    },
+    "UiSlider": {
+      "type": "object",
+      "x-signals": ["changed"],
+      "properties": {
+        "name": {
+          "type": "string"
+        },
+        "uid": {
+          "type": "string"
+        },
+        "type": {
+          "const": "UiSlider"
+        },
+        "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
+            },
+            "label": {
+              "type": "string",
+              "default": ""
+            },
+            "value": {
+              "type": "number",
+              "default": 0.5
+            },
+            "min": {
+              "type": "number",
+              "default": 0
+            },
+            "max": {
+              "type": "number",
+              "default": 1
+            },
+            "step": {
+              "type": "number",
+              "default": 0.01
+            },
+            "width": {
+              "type": "number",
+              "default": 180
+            },
+            "color": {
+              "type": "string",
+              "default": "#6ee7dc"
+            }
+          },
+          "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"]
+    },
     "UiText": {
       "type": "object",
       "properties": {
@@ -6469,6 +6910,85 @@
       },
       "required": ["name", "type"]
     },
+    "UiToggle": {
+      "type": "object",
+      "x-signals": ["changed"],
+      "properties": {
+        "name": {
+          "type": "string"
+        },
+        "uid": {
+          "type": "string"
+        },
+        "type": {
+          "const": "UiToggle"
+        },
+        "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
+            },
+            "label": {
+              "type": "string",
+              "default": ""
+            },
+            "value": {
+              "type": "boolean",
+              "default": false
+            }
+          },
+          "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"]
+    },
     "VoxelGrid3D": {
       "type": "object",
       "x-signals": ["blocksChanged"],

package/skills/incanto-audio.md CHANGED Viewed

@@ -330,3 +330,46 @@ this.tree.engine.music.crossfadeTo('incanto/assets/audio/boss.mp3', 3);
 - **Global volume / mute / settings** → `engine.audio.master/sfx/music/muted`.
 - **Verifying headlessly** → audio is a no-op in the VM; assert `play()` doesn't
   throw and check your gameplay/score logic instead (see incanto-verifying).
+## Settings that survive a reload (`engine.settings`)
+Every player's volume used to reset on every page load: `createSaveStore` was
+good and had zero callers, and eight examples set `engine.audio.music = 0.5` at
+boot without reading a saved value.
+`createGame2D/3D` now binds them, so **a slider that writes `engine.audio.music`
+has already saved it** — no extra call, which is the promise this skill was
+already making.
+```ts
+engine.settings.get('quality');            // 'low' | 'medium' | 'high'
+engine.settings.set('sensitivity', 1.4);
+engine.settings.all();                     // the whole options screen at once
+engine.settings.reset();
+engine.settings.changed.connect((k) => …); // k is the key that changed
+```
+Stored keys: `master`, `sfx`, `music`, `muted`, `quality`, `sensitivity`,
+`invertY`, `reduceMotion`. Setting a value that has not changed does NOT emit,
+and a corrupt/hand-edited `quality` falls back to the default instead of
+bricking the game.
+### Quality tiers
+```ts
+import { qualityEnvironment, readDeviceHints, suggestQuality, setEnvironment3D } from 'incanto';
+const tier = engine.settings.get('quality') ?? suggestQuality(readDeviceHints());
+setEnvironment3D(engine, qualityEnvironment(tier));
+```
+`qualityEnvironment(tier)` is an **environment patch**, not a second rendering
+pipeline: `setEnvironment3D` already applies one live and validated. `low` turns
+off shadows/bloom/post/clouds and pins pixelRatio to 1; `medium` keeps shadows
+but makes them static (measured ~42% of a dense-forest frame); `high` is
+everything at device pixel ratio.
+`suggestQuality(readDeviceHints())` picks a STARTING point from cores, memory and
+a coarse pointer — the options menu is the real answer, and a `UiSelect` bound to
+`quality` is the whole options row (see `incanto-hud.md`).

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

@@ -293,3 +293,39 @@ 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.
+## Platformer game feel (CharacterController2D)
+A jump that only fires while `isOnFloor()` is true feels BROKEN, and players do
+not report it as "the coyote time is missing" — they report the game as
+unresponsive. These are the constants `examples/platformer-2d` hand-rolls in a
+541-line behavior, as props. **Every one defaults to off**, so an existing scene
+behaves exactly as before.
+| prop | default | what it buys |
+| --- | --- | --- |
+| `coyoteSeconds` | `0` | jump for this long AFTER walking off a ledge — the single biggest one |
+| `jumpBufferSeconds` | `0` | a press just BEFORE landing still fires on touchdown |
+| `jumpCutMultiplier` | `1` | release early → rise less (variable jump height) |
+| `maxJumps` | `1` | `2` = double jump. Walking off a ledge spends the ground jump |
+| `dashSpeed` / `dashSeconds` / `dashAction` | `0` / `0.15` / `dash` | a straight-line dash |
+| `wallSlideSpeed` | `0` | capped fall while against a wall |
+| `wallJumpImpulse` | `[0, 0]` | `[away, up]` push off a wall |
+```json
+{ "name": "Controller", "type": "CharacterController2D",
+  "props": { "coyoteSeconds": 0.12, "jumpBufferSeconds": 0.15,
+             "jumpCutMultiplier": 0.45, "maxJumps": 2,
+             "wallSlideSpeed": 60, "wallJumpImpulse": [260, 380] } }
+```
+**`movementStateChanged(state)`** fires on every change — `idle` · `run` ·
+`jump` · `fall` · `wallSlide` · `dash` — so an `AnimatedSprite2D` follows the
+character from scene JSON instead of a behavior polling velocities. The 3D
+sibling has had this signal since it shipped.
+Wall moves need to know there IS a wall: `CharacterBody2D` now answers
+`isOnWall()`, `wallSide()` (-1 left / +1 right) and `isOnCeiling()` as well as
+`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.