incanto 0.7.0 → 0.8.0

package/skills/incanto-multiplayer.md

@@ -140,6 +140,33 @@ const manager = await NetworkManager.create(engine, { transport: local.createCli
 engine.updated.connect((dt) => void local.tick(Math.min(dt, 0.05) * 1000));
 ```
 
+### Split-screen preview in one call (`createSplitScreen`)
+
+Testing multiplayer alone means playing BOTH sides. `createSplitScreen` wires
+the whole N-panel harness — one LocalGameServer, one engine + NetworkManager
+per player — so you only supply the per-panel renderer/input:
+
+```ts
+import { createSplitScreen, registerNodesNet } from 'incanto/net';
+
+const canvases = [document.getElementById('p1'), document.getElementById('p2')];
+const { players, server, dispose } = await createSplitScreen({
+  scene: gameJson,                       // shared scene (each panel gets its own copy)
+  server: Server,                        // your v2 Server class (optional)
+  scenes: { 'remote-player': remoteJson }, // NetworkSpawner scenes, every panel
+  accounts: ['p1', 'p2'],                // one panel per account (default)
+  setup: ({ engine }, i) => {            // finish wiring each panel
+    new Renderer2D({ canvas: canvases[i], engine });
+    engine.input.attachKeyboard(i === 0 ? window : canvases[i]); // split inputs!
+    engine.start();
+  },
+});
+```
+
+The first panel's clock pumps `server.tick` (so `$roomTick` runs) — don't add
+your own. `dispose()` tears every panel down. Going live is unchanged: ONE
+client per browser with `createAgent8Server()` as the transport.
+
 It runs the SAME class body the cloud runs: the v2 globals (`$sender`/`$global`/
 `$room`/`$lock`) are injected per call, a FRESH `Server` instance runs per request
 (so `this.*` never persists), and calls are serialized (no global leaks across

package/skills/incanto-node-reference.md

@@ -241,6 +241,7 @@ Signals: `triggerEnter(other)` · `triggerExit(other)`
 | `sprintAction` | `"sprint"` | string |
 | `skinPath` | `"../Skin"` | string |
 | `skinYawOffset` | `0` | number |
+| `animations` | `{}` | object |
 
 Signals: `movementStateChanged(state)`
 
@@ -711,6 +712,25 @@ Signals: `triggerEnter(other)` · `triggerExit(other)`
 | `textureBase` | `"https://agent8-games.verse8.io/assets/3D/default/textures/terrain"` | string |
 | `basins` | `[]` | array |
 
+## `TileMap2D` — `incanto/2d`
+
+| Prop | Default | Kind |
+|---|---|---|
+| `position` | `[0,0]` | array |
+| `rotation` | `0` | number |
+| `static` | `false` | boolean |
+| `scale` | `[1,1]` | array |
+| `renderOrder` | `0` | number |
+| `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
+| `visible` | `true` | boolean |
+| `texture` | `""` | string |
+| `tileSize` | `32` | number |
+| `columns` | `0` | number |
+| `cells` | `[]` | array |
+| `legend` | `{}` | object |
+| `solid` | `[]` | array |
+| `opacity` | `1` | number |
+
 ## `Timer` — `incanto`
 
 | Prop | Default | Kind |
@@ -721,6 +741,25 @@ Signals: `triggerEnter(other)` · `triggerExit(other)`
 
 Signals: `timeout`
 
+## `Trail3D` — `incanto/3d`
+
+| Prop | Default | Kind |
+|---|---|---|
+| `position` | `[0,0,0]` | array |
+| `rotation` | `[0,0,0]` | array |
+| `static` | `false` | boolean |
+| `scale` | `[1,1,1]` | array |
+| `visible` | `true` | boolean |
+| `renderOrder` | `0` | number |
+| `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
+| `width` | `0.3` | number |
+| `color` | `"#ffffff"` | string |
+| `opacity` | `0.8` | number |
+| `seconds` | `0.6` | number |
+| `emitting` | `true` | boolean |
+| `additive` | `false` | boolean |
+| `minDistance` | `0.05` | number |
+
 ## `Tree3D` — `incanto/3d`
 
 | Prop | Default | Kind |
@@ -780,6 +819,31 @@ Signals: `bannerShown`
 | `background` | `"rgba(0,0,0,0.5)"` | string |
 | `label` | `""` | string |
 
+## `UiButton` — `incanto`
+
+| Prop | Default | Kind |
+|---|---|---|
+| `anchor` | `"topLeft"` | one of: `topLeft` `top` `topRight` `left` `center` `right` `bottomLeft` `bottom` `bottomRight` |
+| `visible` | `true` | boolean |
+| `text` | `"OK"` | string |
+| `size` | `16` | number |
+| `color` | `"#ffffff"` | string |
+| `background` | `"rgba(255,255,255,0.14)"` | string |
+| `disabled` | `false` | boolean |
+
+Signals: `pressed`
+
+## `UiDialogue` — `incanto`
+
+| Prop | Default | Kind |
+|---|---|---|
+| `anchor` | `"bottom"` | one of: `topLeft` `top` `topRight` `left` `center` `right` `bottomLeft` `bottom` `bottomRight` |
+| `visible` | `true` | boolean |
+| `charsPerSecond` | `40` | number |
+| `width` | `520` | number |
+
+Signals: `lineShown` · `choiceMade` · `dialogueFinished`
+
 ## `UiText` — `incanto`
 
 | Prop | Default | Kind |
@@ -951,6 +1015,15 @@ Signals: `arrived`
 | `frequency` | `1` | number |
 | `mode` | `"position"` | one of: `position` `rotation` `scale` |
 
+### `PathFollow`
+
+| Prop | Default | Kind |
+|---|---|---|
+| `speed` | `120` | number |
+| `loop` | `false` | boolean |
+
+Signals: `waypointReached` · `arrived`
+
 ### `Patrol`
 
 | Prop | Default | Kind |

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

@@ -133,6 +133,15 @@ Injected state combines with key state (vectors clamped to unit length).
 - Reference: [examples/2d-phaser-sprite-character-gravity](https://github.com/rareboe/Incanto/tree/main/examples/2d-phaser-sprite-character-gravity) — gravity, jump, attack lockout, custom
   `Player` node type. Verified in Chromium end-to-end.
 
+## Platformer staples (2D)
+
+- **One-way platforms**: `"collider": { "shape": "rect", "size": [300, 20],
+  "oneWay": true }` on a StaticBody2D — characters jump up THROUGH it and
+  land ON it (solid only when falling from above). The Mario ledge.
+- **Moving platforms carry riders automatically**: a CharacterBody2D
+  standing on ANY body follows that body's movement (elevators, patrol
+  platforms — just animate the platform's `position`; the character rides).
+
 ## Joints (Joint2D / Joint3D)
 
 Link two bodies: put the joint node as a CHILD of body A, point `target` at

package/skills/incanto-verifying-your-game.md

@@ -189,3 +189,43 @@ thing gating it: keep it `false` (or dev-gated) in anything you publish.
   seeded run reproduces exactly.
 - A run that "does nothing": remember the first engine tick only primes the
   clock — `runScript` already handles this for you.
+
+## Finding a node ON SCREEN (selection highlight)
+
+Selecting a node in the dev overlay's Explorer draws its world-space
+bounding box as an ORANGE outline in the running game (children included;
+depth-test off, so it shows through walls). Extent-less nodes get a small
+marker cube at their position. That is the fastest answer to "which thing
+on screen IS this node?" — and the reverse of it: walk the tree clicking
+rows until the orange box lands on the thing you're hunting.
+
+## Semantic warnings (audit)
+
+`incanto-check` now WARNS about scenes that load fine but play wrong: no
+`current` camera, physics bodies without colliders, animated nodes frozen
+inside a `static` subtree, HUD widgets outside a HudLayer. Programmatic:
+`auditScene(json)` from `incanto` or `incanto/test` returns the warnings.
+
+## Deterministic replay (record once, regression-test forever)
+
+The engine is fully deterministic under a seed + injected clock, so a
+recording of (tick timestamps + input events) replays BIT-identically:
+
+```ts
+import { Engine, loadScene, replay, startRecording } from 'incanto';
+
+// while playing (dev build):
+const rec = startRecording(engine);
+// ... play the level ...
+save.set('replays/level1', rec.stop());
+
+// in a headless test:
+const engine = new Engine({ seed: SAME_SEED });
+engine.setScene(loadScene(sceneJson));
+replay(engine, recording, { onTick(i) { /* mid-run asserts */ } });
+expect(player.position).toEqual(expected); // exact, not approximate
+```
+
+Rules that make it hold (the engine's own rules anyway): use `engine.rng`
+never Math.random, dt/`engine.time` never Date.now. Gamepads replay through
+the ACTIONS they were bound to, not raw pad state.