incanto 0.6.0 → 0.7.0

package/skills/incanto-node-reference.md

@@ -24,6 +24,7 @@ description: GENERATED complete reference of every Incanto node type — props,
 | `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 |
 | `anchor` | `[0.5,0.5]` | array |
@@ -47,6 +48,7 @@ Signals: `animationFinished(name)`
 | `scale` | `[1,1,1]` | array |
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
+| `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
 | `texture` | `""` | string |
 | `size` | `[1,1]` | array |
 | `billboard` | `"y"` | one of: `y` `full` `none` |
@@ -75,6 +77,7 @@ Signals: `animationFinished(name)`
 | `static` | `false` | boolean |
 | `scale` | `[1,1]` | array |
 | `renderOrder` | `0` | number |
+| `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
 | `visible` | `true` | boolean |
 | `collider` | `{}` | object |
 
@@ -90,6 +93,7 @@ Signals: `triggerEnter(other)` · `triggerExit(other)`
 | `scale` | `[1,1,1]` | array |
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
+| `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
 | `collider` | `{}` | object |
 
 Signals: `triggerEnter(other)` · `triggerExit(other)`
@@ -123,6 +127,7 @@ Signals: `finished`
 | `scale` | `[1,1,1]` | array |
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
+| `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
 | `mode` | `"screen"` | one of: `screen` `y` `none` |
 
 ## `Camera2D` — `incanto/2d`
@@ -134,6 +139,7 @@ Signals: `finished`
 | `static` | `false` | boolean |
 | `scale` | `[1,1]` | array |
 | `renderOrder` | `0` | number |
+| `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
 | `visible` | `true` | boolean |
 | `follow` | `""` | string |
 | `smoothing` | `0` | number |
@@ -151,6 +157,7 @@ Signals: `finished`
 | `scale` | `[1,1,1]` | array |
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
+| `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
 | `fov` | `60` | number |
 | `near` | `0.1` | number |
 | `far` | `1000` | number |
@@ -165,6 +172,7 @@ Signals: `finished`
 | `static` | `false` | boolean |
 | `scale` | `[1,1]` | array |
 | `renderOrder` | `0` | number |
+| `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
 | `visible` | `true` | boolean |
 | `collider` | `{}` | object |
 | `velocity` | `[0,0]` | array |
@@ -183,6 +191,7 @@ Signals: `triggerEnter(other)` · `triggerExit(other)`
 | `scale` | `[1,1,1]` | array |
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
+| `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
 | `collider` | `{}` | object |
 | `velocity` | `[0,0,0]` | array |
 | `snapToGround` | `true` | boolean |
@@ -210,6 +219,7 @@ Signals: `triggerEnter(other)` · `triggerExit(other)`
 | `scale` | `[1,1,1]` | array |
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
+| `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
 | `view` | `"free"` | one of: `free` `firstPerson` `quarter` `side` |
 | `camDistance` | `4` | number |
 | `eyeHeight` | `0.64` | number |
@@ -243,6 +253,7 @@ Signals: `movementStateChanged(state)`
 | `static` | `false` | boolean |
 | `scale` | `[1,1]` | array |
 | `renderOrder` | `0` | number |
+| `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
 | `visible` | `true` | boolean |
 | `size` | `[100,100]` | array |
 | `color` | `"#ffffff"` | string |
@@ -259,6 +270,7 @@ Signals: `movementStateChanged(state)`
 | `scale` | `[1,1,1]` | array |
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
+| `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
 | `color` | `"#ffffff"` | string |
 | `intensity` | `1` | number |
 | `castShadow` | `false` | boolean |
@@ -276,6 +288,7 @@ Signals: `movementStateChanged(state)`
 | `scale` | `[1,1,1]` | array |
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
+| `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
 | `density` | `"sparse"` | one of: `lush` `sparse` `none` |
 | `area` | `[20,20]` | array |
 | `seed` | `1` | number |
@@ -297,6 +310,7 @@ Signals: `movementStateChanged(state)`
 | `scale` | `[1,1,1]` | array |
 | `visible` | `true` | boolean |
 | `renderOrder` | `2` | number |
+| `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
 | `kind` | `"grass"` | one of: `grass` `flowers` `reeds` |
 | `style` | `"mesh"` | one of: `blades` `simple` `mesh` `tufts` |
 | `tuftStyle` | `"grass"` | one of: `grass` `fern` |
@@ -334,6 +348,7 @@ Signals: `movementStateChanged(state)`
 | `static` | `false` | boolean |
 | `scale` | `[1,1]` | array |
 | `renderOrder` | `0` | number |
+| `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
 | `visible` | `true` | boolean |
 | `type` | `"revolute"` | one of: `fixed` `revolute` `rope` `spring` |
 | `target` | `""` | string |
@@ -353,6 +368,7 @@ Signals: `movementStateChanged(state)`
 | `scale` | `[1,1,1]` | array |
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
+| `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
 | `type` | `"spherical"` | one of: `fixed` `spherical` `rope` `spring` |
 | `target` | `""` | string |
 | `anchor` | `[0,0,0]` | array |
@@ -370,6 +386,7 @@ Signals: `movementStateChanged(state)`
 | `static` | `false` | boolean |
 | `scale` | `[1,1]` | array |
 | `renderOrder` | `0` | number |
+| `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
 | `visible` | `true` | boolean |
 | `text` | `""` | string |
 | `fontSize` | `16` | number |
@@ -387,6 +404,7 @@ Signals: `movementStateChanged(state)`
 | `scale` | `[1,1,1]` | array |
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
+| `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
 | `sections` | `[]` | array |
 | `slices` | `24` | number |
 | `smooth` | `4` | number |
@@ -404,6 +422,7 @@ Signals: `movementStateChanged(state)`
 | `scale` | `[1,1,1]` | array |
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
+| `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
 | `mesh` | `"box"` | one of: `box` `sphere` `capsule` `plane` `cylinder` `gem` |
 | `size` | `[1,1,1]` | array |
 | `material` | `{}` | object |
@@ -420,6 +439,7 @@ Signals: `movementStateChanged(state)`
 | `scale` | `[1,1,1]` | array |
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
+| `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
 | `model` | `""` | string |
 | `animation` | `""` | string |
 | `targetHeight` | `0` | number |
@@ -455,6 +475,7 @@ _No props (structural fields only)._
 | `static` | `false` | boolean |
 | `scale` | `[1,1]` | array |
 | `renderOrder` | `0` | number |
+| `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
 | `visible` | `true` | boolean |
 
 ## `Node3D` — `incanto/3d`
@@ -467,6 +488,7 @@ _No props (structural fields only)._
 | `scale` | `[1,1,1]` | array |
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
+| `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
 
 ## `OmniLight3D` — `incanto/3d`
 
@@ -478,6 +500,7 @@ _No props (structural fields only)._
 | `scale` | `[1,1,1]` | array |
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
+| `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
 | `color` | `"#ffffff"` | string |
 | `intensity` | `1` | number |
 | `range` | `0` | number |
@@ -491,6 +514,7 @@ _No props (structural fields only)._
 | `static` | `false` | boolean |
 | `scale` | `[1,1]` | array |
 | `renderOrder` | `0` | number |
+| `orderGroup` | `"effects"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
 | `visible` | `true` | boolean |
 | `preset` | `"custom"` | one of: `custom` `fire` `smoke` `sparks` `fireworks` `explosion` `flash` `lightning` `rain` `snow` `magic` |
 | `emitting` | `true` | boolean |
@@ -525,6 +549,7 @@ Signals: `finished`
 | `scale` | `[1,1,1]` | array |
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
+| `orderGroup` | `"effects"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
 | `preset` | `"custom"` | one of: `custom` `fire` `smoke` `sparks` `fireworks` `explosion` `flash` `lightning` `rain` `snow` `magic` |
 | `emitting` | `true` | boolean |
 | `rate` | `40` | number |
@@ -558,6 +583,7 @@ Signals: `finished`
 | `static` | `false` | boolean |
 | `scale` | `[1,1]` | array |
 | `renderOrder` | `0` | number |
+| `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
 | `visible` | `true` | boolean |
 | `collider` | `{}` | object |
 | `mass` | `1` | number |
@@ -579,6 +605,7 @@ Signals: `triggerEnter(other)` · `triggerExit(other)`
 | `scale` | `[1,1,1]` | array |
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
+| `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
 | `collider` | `{}` | object |
 | `mass` | `1` | number |
 | `gravityScale` | `1` | number |
@@ -598,6 +625,7 @@ Signals: `triggerEnter(other)` · `triggerExit(other)`
 | `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 |
 | `anchor` | `[0.5,0.5]` | array |
@@ -616,6 +644,7 @@ Signals: `triggerEnter(other)` · `triggerExit(other)`
 | `scale` | `[1,1,1]` | array |
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
+| `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
 | `texture` | `""` | string |
 | `size` | `[1,1]` | array |
 | `billboard` | `"y"` | one of: `y` `full` `none` |
@@ -637,6 +666,7 @@ Signals: `triggerEnter(other)` · `triggerExit(other)`
 | `static` | `false` | boolean |
 | `scale` | `[1,1]` | array |
 | `renderOrder` | `0` | number |
+| `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
 | `visible` | `true` | boolean |
 | `collider` | `{}` | object |
 
@@ -652,6 +682,7 @@ Signals: `triggerEnter(other)` · `triggerExit(other)`
 | `scale` | `[1,1,1]` | array |
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
+| `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
 | `collider` | `{}` | object |
 
 Signals: `triggerEnter(other)` · `triggerExit(other)`
@@ -666,6 +697,7 @@ Signals: `triggerEnter(other)` · `triggerExit(other)`
 | `scale` | `[1,1,1]` | array |
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
+| `orderGroup` | `"terrain"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
 | `size` | `[200,200]` | array |
 | `maxHeight` | `28` | number |
 | `seed` | `1` | number |
@@ -699,6 +731,7 @@ Signals: `timeout`
 | `scale` | `[1,1,1]` | array |
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
+| `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
 | `tier` | `"medium"` | one of: `simple` `medium` `high` |
 | `type` | `"conifer"` | one of: `conifer` `broadleaf` `dead` `bush` |
 | `seed` | `1` | number |
@@ -768,6 +801,7 @@ Signals: `bannerShown`
 | `scale` | `[1,1,1]` | array |
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
+| `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
 | `voxels` | `[]` | array |
 
 Signals: `blocksChanged`
@@ -782,6 +816,7 @@ Signals: `blocksChanged`
 | `scale` | `[1,1,1]` | array |
 | `visible` | `true` | boolean |
 | `renderOrder` | `1` | number |
+| `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
 | `size` | `[40,40]` | array |
 | `color` | `"#2a6fbe"` | string |
 | `opacity` | `0.8` | number |

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

@@ -106,6 +106,25 @@ physically adjacent, and makes subtree copy/move one-object operations. Flat
 addressing needs are covered by uid (`getNodeByUid`). Full reasoning:
 docs/adr/0001 in the repo.
 
+## Draw order: orderGroup + renderOrder
+
+Every visual node has TWO ordering props: `orderGroup` (a named band —
+`background < terrain < default < characters < effects < overlay`) and
+`renderOrder` (fine offset INSIDE the band). Effective order =
+band base + renderOrder. Type defaults: particles ship in `effects`,
+Terrain3D in `terrain`, everything else `default`.
+
+```json
+{ "name": "Hero", "type": "Sprite2D",
+  "props": { "orderGroup": "characters" } },
+{ "name": "Smoke", "type": "Particles2D",
+  "props": { "renderOrder": 5 } }          // effects band, +5 within it
+```
+
+In 3D the bands order the TRANSPARENT pass (opaque geometry is depth-
+tested regardless); in 2D they are the layering system. 2D `zIndex` is an
+accepted alias for `renderOrder`.
+
 ## Parents and children
 
 EVERY node type can hold children — `children` is universal, so any node works