npm - incanto - Versions diffs - 0.71.0 → 0.72.0 - Mend

incanto 0.71.0 → 0.72.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 (62) hide show

package/bin/incanto-editor.mjs +15 -9
package/bin/incanto-feel.mjs +11 -1
package/bin/incanto-play.mjs +11 -1
package/bin/incanto-playtest.mjs +11 -1
package/dist/2d.d.ts +3 -3
package/dist/2d.js +3 -3
package/dist/3d.d.ts +3 -3
package/dist/3d.js +5 -5
package/dist/{agent8-Cfmd3ar_.js → agent8-BqZ0_O1u.js} +1 -1
package/dist/{audio-player-L8yccdMP.d.ts → audio-player-ioZ7VKC6.d.ts} +1 -1
package/dist/{behavior-Dcz0fr1S.d.ts → behavior-Bf9P9oB2.d.ts} +1 -1
package/dist/{create-game-CH4kt78v.js → create-game-C9rWqqAC.js} +36 -12
package/dist/{create-game-LCHBLfA4.js → create-game-CmFAtLZp.js} +7 -6
package/dist/debug.d.ts +1 -1
package/dist/editor.js +1069 -1035
package/dist/{environment-presets-99BzP_L-.js → environment-presets-BeHoaGhy.js} +3 -3
package/dist/{gameplay-CNULJvwh.js → gameplay-BlQe-M07.js} +1 -1
package/dist/gameplay.d.ts +1 -1
package/dist/gameplay.js +1 -1
package/dist/index.d.ts +4 -4
package/dist/index.js +4 -4
package/dist/{loader-8-IHvbKD.d.ts → loader-CBfQzB6S.d.ts} +10 -3
package/dist/net.d.ts +2 -2
package/dist/net.js +2 -2
package/dist/{physics-2d-FhrXUc6B.js → physics-2d-DrIgTlLk.js} +2 -2
package/dist/{physics-3d-CFEGxBXZ.js → physics-3d-BzOCw1VS.js} +3 -3
package/dist/{picking-DVo7fI13.js → picking-C9McVJrO.js} +2 -2
package/dist/react.d.ts +1 -1
package/dist/react.js +1 -1
package/dist/{register-DuVdzxbq.js → register-5IYfooAN.js} +1 -1
package/dist/{register-BYQCBySi.js → register-C8HuRkOf.js} +3 -3
package/dist/{replay-F7IZHdFR.d.ts → replay-CBEChqXq.d.ts} +2 -2
package/dist/{replay-DEvp3kyV.js → replay-datiAE-b.js} +15 -8
package/dist/{save-slots-Bvuh2p_r.js → save-slots-CEuJPUle.js} +46 -1
package/dist/{split-screen-eULetcg-.js → split-screen-Bm5DTElG.js} +3 -3
package/dist/{split-screen-CIYf1zSf.d.ts → split-screen-DkqLng6q.d.ts} +2 -2
package/dist/{src-_jk0qLsS.js → src-DRSsRleD.js} +1 -1
package/dist/{test-CmN54kWv.js → test-Djuq3Vhq.js} +13 -13
package/dist/test.d.ts +4 -4
package/dist/test.js +2 -2
package/dist/vite.d.ts +8 -1
package/dist/vite.js +22 -5
package/editor/assets/{agent8-yLIEYHbd.js → agent8-CMKz2cax.js} +1 -1
package/editor/assets/{debug-u31w_yhq.js → debug-DLrQm-az.js} +1 -1
package/editor/assets/{index-DK9xMGpW.js → index-BEKuxYcE.js} +92 -92
package/editor/index.html +1 -1
package/package.json +1 -1
package/skills/incanto-building-2d-games.md +6 -0
package/skills/incanto-editor.md +4 -0
package/skills/incanto-scene-json-authoring.md +30 -0
package/templates-app/beacon-isle-3d/package.json +1 -1
package/templates-app/beacon-isle-3d/src/game.scene.json +377 -185
package/templates-app/molehill-2d/package.json +1 -1
package/templates-app/platformer-2d/package.json +1 -1
package/templates-app/platformer-2d/src/game.scene.json +193 -93
package/templates-app/star-survivor/package.json +1 -1
package/templates-app/star-survivor/src/game.scene.json +18 -9
package/templates-app/tps-3d/package.json +1 -1
package/templates-app/tps-3d/src/game.scene.json +82 -39
package/templates-app/village-quest-3d/package.json +1 -1
package/templates-app/village-quest-3d/src/grove.scene.json +98 -46
package/templates-app/village-quest-3d/src/village.scene.json +449 -223

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

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

@@ -117,6 +117,12 @@ stop hand-placing dozens of ColorRect walls:
   } }
   ```
+  A grid with rows and NEITHER of them draws nothing at all — the mesh is
+  hidden, the colliders are still there, and you get a floor you can stand on
+  and cannot see. `incanto-check` says so now (`examples/tiles-2d` shipped
+  exactly that), so if you meant an invisible collision map over scenery you
+  drew yourself, the warning is the price of saying so.
   Exclusive with `texture` (one material, one draw call — a half-textured level
   that loads clean is exactly the silence this engine fails loudly about), and
   `solid` takes the CHAR you painted as well as an atlas index, because that is

package/skills/incanto-editor.md CHANGED Viewed

@@ -181,6 +181,10 @@ Opens a local page (default `http://127.0.0.1:5179/`) with three panes:
   registered node types appear automatically. Edits re-validate through the real
   loader: hard `IncantoError`s appear in a banner. Validation is STRUCTURE-level —
   physics semantics are checked when physics actually runs.
+- A node placed with **`instance:`** shows a PLACEMENT card first — which
+  prefab file it is (editable, to re-point it) and its `overrides` as JSON, the
+  props deep-merged onto the sub-scene root. Dragging its gizmo writes there
+  too; `props` on a placement is a load error and is read by nothing.
 - **Inspector** — schema-driven from the node registry, with STRUCTURED editors for
   the hard parts: `collider` (shape dropdown + per-shape dimensions, mirrored by
   the wireframe), `network` (mode dropdown + sync-key chips + throttle),

package/skills/incanto-scene-json-authoring.md CHANGED Viewed

@@ -398,6 +398,35 @@ that do exist at the failing spot).
 - Current limitation: exporting expands instances into full trees (the `instance` reference is
   not preserved on export yet).
 - Cycles (`a` instances `b` instances `a`) and missing resolvers → `UNRESOLVED_INSTANCE`.
+- A placement's props go in `overrides`. `props` on an `instance:` node is a
+  hard `BAD_FORMAT` error — it used to be accepted and read by nothing, so a
+  position written there was silently the sub-scene's own.
+### Giving the loader the sub-scenes (the half that is not JSON)
+`loadScene` never reads files: it asks `resolveScene(path)` for the JSON behind
+an `instance:` string, synchronously, and without one a scene with a prefab in
+it does not load. Every CLI (`incanto-check`, `-playtest`, `-verify`, `-feel`,
+`-play`) passes one already, resolved against the SCENE's own folder — your
+game and your harness are the two places you write it yourself:
+```ts
+// main.ts — vite. Every *.scene.json beside this file, keyed by the path an
+// `instance:` names.
+const prefabs = import.meta.glob('./*.scene.json', { eager: true, import: 'default' });
+const resolveScene = (path: string): unknown => prefabs[`./${path}`] ?? null;
+await createGame2D({ canvas, scene: sceneJson, resolveScene });
+```
+```ts
+// verify.ts — bun, no bundler: import the prefab and hand it over by path.
+import crateJson from './src/crate.scene.json';
+const resolveScene = (path: string) => (path === 'crate.scene.json' ? crateJson : null);
+await runScript(sceneJson, { durationMs: 4000, resolveScene, steps: [...] });
+```
+`examples/tiles-2d` is the worked example: two crates that ARE
+`crate.scene.json`, one of them adding a rope child of its own.
 ## Error codes you will see (all hard failures at load)
@@ -417,6 +446,7 @@ that do exist at the failing spot).
 | `UNKNOWN_SIGNAL` | connection (or emit/on) names a signal the from node never declares | use a declared signal, or declare it (`static signals` / `declareSignal`) |
 | `UNKNOWN_BEHAVIOR` | `script.name` not registered | `registerBehavior(name, Class)` before `loadScene` |
 | `UNRESOLVED_INSTANCE` | no resolver, unknown path, or instance cycle | provide/fix `resolveScene`, break the cycle |
+| `WRONG_DIMENSION` | a `*3D` node in a 2D scene (or the reverse), or `createGame2D` given a 3D scene | use the matching node type / the matching `createGame*` |
 | `DUPLICATE_NODE_TYPE` | two classes registered under one type name | rename one type, or `{ replace: true }` for hot reload |
 | `DUPLICATE_BEHAVIOR` | two classes registered under one behavior name | rename one, or `{ replace: true }` for hot reload |
 | `TREE_VIOLATION` | invalid name, re-parenting without detach, cycles, double root | follow the rule in the message |

package/templates-app/beacon-isle-3d/package.json CHANGED Viewed

@@ -14,7 +14,7 @@
     "@dimforge/rapier2d-compat": "0.19.3",
     "@dimforge/rapier3d-compat": "0.19.3",
     "@pixiv/three-vrm": "^3.5.3",
-    "incanto": "^0.71.0",
+    "incanto": "^0.72.0",
     "three": "^0.184.0"
   },
   "devDependencies": {