@almadar/std 16.197.0 → 16.199.0

package/behaviors/registry/ui/game/atoms/ui-canvas.orb

@@ -138,11 +138,89 @@
               "type": "asset"
             },
             "camera": {
-              "default": {},
               "description": "Neutral camera pose. Mapped to the underlying host's framing + zoom.",
               "label": "Camera",
+              "properties": {
+                "azimuth": {
+                  "name": "azimuth",
+                  "required": false,
+                  "type": "number"
+                },
+                "elevation": {
+                  "name": "elevation",
+                  "required": false,
+                  "type": "number"
+                },
+                "fov": {
+                  "name": "fov",
+                  "required": false,
+                  "type": "number"
+                },
+                "mode": {
+                  "name": "mode",
+                  "required": false,
+                  "type": "string",
+                  "values": [
+                    "isometric",
+                    "perspective",
+                    "top-down",
+                    "front",
+                    "follow",
+                    "chase"
+                  ]
+                },
+                "pos": {
+                  "name": "pos",
+                  "properties": {
+                    "x": {
+                      "name": "x",
+                      "required": true,
+                      "type": "number"
+                    },
+                    "y": {
+                      "name": "y",
+                      "required": true,
+                      "type": "number"
+                    },
+                    "z": {
+                      "name": "z",
+                      "required": false,
+                      "type": "number"
+                    }
+                  },
+                  "required": false,
+                  "type": "object"
+                },
+                "target": {
+                  "name": "target",
+                  "properties": {
+                    "x": {
+                      "name": "x",
+                      "required": true,
+                      "type": "number"
+                    },
+                    "y": {
+                      "name": "y",
+                      "required": true,
+                      "type": "number"
+                    },
+                    "z": {
+                      "name": "z",
+                      "required": false,
+                      "type": "number"
+                    }
+                  },
+                  "required": false,
+                  "type": "object"
+                },
+                "zoom": {
+                  "name": "zoom",
+                  "required": false,
+                  "type": "number"
+                }
+              },
               "tier": "presentation",
-              "type": "json"
+              "type": "CanvasCamera"
             },
             "children": {
               "description": "Declarative JSX drawable children (`<DrawShape .../>` composed in paint order). Forwarded to the 2D host, which collects them via drawable registry context.",
@@ -160,11 +238,11 @@
               "default": [],
               "description": "Neutral drawable descriptors — the `draw-*` children. Routed to the host's painter.",
               "items": {
-                "type": "object"
+                "type": "node"
               },
               "label": "Drawables",
               "tier": "presentation",
-              "type": "[object]"
+              "type": "[node]"
             },
             "featureClickEvent": {
               "default": "FEATURE_CLICK",
@@ -223,11 +301,140 @@
               "type": "Map<string,string>"
             },
             "lighting": {
-              "default": {},
               "description": "3D scene light rig as data — ambient/directional/hemisphere/point lights + optional 'room' environment for PBR reflections. Omitted → the standard fixed rig.",
               "label": "Lighting",
+              "properties": {
+                "ambient": {
+                  "name": "ambient",
+                  "properties": {
+                    "color": {
+                      "name": "color",
+                      "required": false,
+                      "type": "string"
+                    },
+                    "intensity": {
+                      "name": "intensity",
+                      "required": false,
+                      "type": "number"
+                    },
+                    "position": {
+                      "items": {
+                        "type": "number"
+                      },
+                      "name": "position",
+                      "required": false,
+                      "type": "array"
+                    }
+                  },
+                  "required": false,
+                  "type": "object"
+                },
+                "directional": {
+                  "name": "directional",
+                  "properties": {
+                    "color": {
+                      "name": "color",
+                      "required": false,
+                      "type": "string"
+                    },
+                    "intensity": {
+                      "name": "intensity",
+                      "required": false,
+                      "type": "number"
+                    },
+                    "position": {
+                      "items": {
+                        "type": "number"
+                      },
+                      "name": "position",
+                      "required": false,
+                      "type": "array"
+                    }
+                  },
+                  "required": false,
+                  "type": "object"
+                },
+                "environment": {
+                  "name": "environment",
+                  "required": false,
+                  "type": "string",
+                  "values": [
+                    "room",
+                    "none"
+                  ]
+                },
+                "hemisphere": {
+                  "name": "hemisphere",
+                  "properties": {
+                    "color": {
+                      "name": "color",
+                      "required": false,
+                      "type": "string"
+                    },
+                    "groundColor": {
+                      "name": "groundColor",
+                      "required": false,
+                      "type": "string"
+                    },
+                    "intensity": {
+                      "name": "intensity",
+                      "required": false,
+                      "type": "number"
+                    }
+                  },
+                  "required": false,
+                  "type": "object"
+                },
+                "points": {
+                  "items": {
+                    "properties": {
+                      "color": {
+                        "name": "color",
+                        "required": false,
+                        "type": "string"
+                      },
+                      "decay": {
+                        "name": "decay",
+                        "required": false,
+                        "type": "number"
+                      },
+                      "distance": {
+                        "name": "distance",
+                        "required": false,
+                        "type": "number"
+                      },
+                      "intensity": {
+                        "name": "intensity",
+                        "required": false,
+                        "type": "number"
+                      },
+                      "position": {
+                        "items": {
+                          "type": "number"
+                        },
+                        "name": "position",
+                        "required": true,
+                        "type": "array"
+                      }
+                    },
+                    "type": "object"
+                  },
+                  "name": "points",
+                  "required": false,
+                  "type": "array"
+                },
+                "toneMapping": {
+                  "name": "toneMapping",
+                  "required": false,
+                  "type": "string",
+                  "values": [
+                    "aces",
+                    "none"
+                  ]
+                }
+              },
               "tier": "presentation",
-              "type": "object"
+              "type": "CanvasLighting"
             },
             "mode": {
               "default": "2d",
@@ -247,11 +454,51 @@
               "type": "number"
             },
             "post": {
-              "default": {},
               "description": "3D post-processing stack — bloom (emissive glow / neon) and vignette. Omitted → no post pass.",
               "label": "Post",
+              "properties": {
+                "bloom": {
+                  "name": "bloom",
+                  "properties": {
+                    "intensity": {
+                      "name": "intensity",
+                      "required": false,
+                      "type": "number"
+                    },
+                    "smoothing": {
+                      "name": "smoothing",
+                      "required": false,
+                      "type": "number"
+                    },
+                    "threshold": {
+                      "name": "threshold",
+                      "required": false,
+                      "type": "number"
+                    }
+                  },
+                  "required": false,
+                  "type": "object"
+                },
+                "vignette": {
+                  "name": "vignette",
+                  "properties": {
+                    "darkness": {
+                      "name": "darkness",
+                      "required": false,
+                      "type": "number"
+                    },
+                    "offset": {
+                      "name": "offset",
+                      "required": false,
+                      "type": "number"
+                    }
+                  },
+                  "required": false,
+                  "type": "object"
+                }
+              },
               "tier": "presentation",
-              "type": "object"
+              "type": "CanvasPost"
             },
             "projection": {
               "default": "isometric",
@@ -352,58 +599,89 @@
           },
           "emits": [
             {
+              "definerKnob": "tileClickEvent",
               "description": "--- Shared interaction (LOLO-owned). The painter emitted at runtime depends on",
               "event": "@config.tileClickEvent",
               "eventId": "evt_01M055GNZCR3PVXN2JTBH2BJWS",
               "payloadSchema": [
                 {
-                  "name": "_payload",
-                  "type": "object"
+                  "name": "x",
+                  "type": "number"
+                },
+                {
+                  "name": "y",
+                  "type": "number"
+                },
+                {
+                  "name": "tileId",
+                  "type": "string"
+                },
+                {
+                  "name": "z",
+                  "type": "number"
                 }
               ],
               "scope": "external",
               "tier": "essential"
             },
             {
+              "definerKnob": "unitClickEvent",
               "description": "unitClickEvent prop",
               "event": "@config.unitClickEvent",
               "eventId": "evt_01M055GNZCVTB1VRV2AE4NVA02",
               "payloadSchema": [
                 {
-                  "name": "_payload",
-                  "type": "object"
+                  "name": "unitId",
+                  "type": "string"
+                },
+                {
+                  "name": "x",
+                  "type": "number"
+                },
+                {
+                  "name": "z",
+                  "type": "number"
                 }
               ],
               "scope": "external",
               "tier": "essential"
             },
             {
+              "definerKnob": "tileHoverEvent",
               "description": "tileHoverEvent prop",
               "event": "@config.tileHoverEvent",
               "eventId": "evt_01M055GNZCC9MCGDJ727YGQB2D",
               "payloadSchema": [
                 {
-                  "name": "_payload",
-                  "type": "object"
+                  "name": "x",
+                  "type": "number"
+                },
+                {
+                  "name": "y",
+                  "type": "number"
+                },
+                {
+                  "name": "tileId",
+                  "type": "string"
+                },
+                {
+                  "name": "z",
+                  "type": "number"
                 }
               ],
               "scope": "external",
               "tier": "essential"
             },
             {
+              "definerKnob": "tileLeaveEvent",
               "description": "tileLeaveEvent prop",
               "event": "@config.tileLeaveEvent",
               "eventId": "evt_01M055GNZC7GCH1G61XK01CY15",
-              "payloadSchema": [
-                {
-                  "name": "id",
-                  "type": "string"
-                }
-              ],
               "scope": "external",
               "tier": "essential"
             },
             {
+              "definerKnob": "featureClickEvent",
               "description": "Feature-click event (3D only).",
               "event": "@config.featureClickEvent",
               "eventId": "evt_01M055GNZCSJFEP7EY20KER3PF",
@@ -459,8 +737,20 @@
                 "name": "@config.tile click event",
                 "payloadSchema": [
                   {
-                    "name": "_payload",
-                    "type": "object"
+                    "name": "x",
+                    "type": "number"
+                  },
+                  {
+                    "name": "y",
+                    "type": "number"
+                  },
+                  {
+                    "name": "tileId",
+                    "type": "string"
+                  },
+                  {
+                    "name": "z",
+                    "type": "number"
                   }
                 ],
                 "tier": "essential"
@@ -472,8 +762,16 @@
                 "name": "@config.unit click event",
                 "payloadSchema": [
                   {
-                    "name": "_payload",
-                    "type": "object"
+                    "name": "unitId",
+                    "type": "string"
+                  },
+                  {
+                    "name": "x",
+                    "type": "number"
+                  },
+                  {
+                    "name": "z",
+                    "type": "number"
                   }
                 ],
                 "tier": "essential"
@@ -485,8 +783,20 @@
                 "name": "@config.tile hover event",
                 "payloadSchema": [
                   {
-                    "name": "_payload",
-                    "type": "object"
+                    "name": "x",
+                    "type": "number"
+                  },
+                  {
+                    "name": "y",
+                    "type": "number"
+                  },
+                  {
+                    "name": "tileId",
+                    "type": "string"
+                  },
+                  {
+                    "name": "z",
+                    "type": "number"
                   }
                 ],
                 "tier": "essential"
@@ -496,12 +806,6 @@
                 "id": "evt_01M055GNZC7GCH1G61XK01CY15",
                 "key": "@config.tileLeaveEvent",
                 "name": "@config.tile leave event",
-                "payloadSchema": [
-                  {
-                    "name": "id",
-                    "type": "string"
-                  }
-                ],
                 "tier": "essential"
               },
               {

package/behaviors/registry/ui/game/atoms/ui-choice-button.orb

@@ -254,28 +254,18 @@
           },
           "emits": [
             {
+              "definerKnob": "onClick",
               "description": "Click handler",
               "event": "@config.onClick",
               "eventId": "evt_01KXG04TR8R5GBSXMP6JZ3XCXZ",
-              "payloadSchema": [
-                {
-                  "name": "id",
-                  "type": "string"
-                }
-              ],
               "scope": "external",
               "tier": "essential"
             },
             {
+              "definerKnob": "action",
               "description": "Declarative event name — emits UI:{action} via eventBus on click",
               "event": "@config.action",
               "eventId": "evt_01KXG04TR8RKRV4VB4JK9HPDZ0",
-              "payloadSchema": [
-                {
-                  "name": "id",
-                  "type": "string"
-                }
-              ],
               "scope": "external",
               "tier": "essential"
             }
@@ -305,12 +295,6 @@
                 "id": "evt_01KXG04TR8R5GBSXMP6JZ3XCXZ",
                 "key": "@config.onClick",
                 "name": "@config.on click",
-                "payloadSchema": [
-                  {
-                    "name": "id",
-                    "type": "string"
-                  }
-                ],
                 "tier": "essential"
               },
               {
@@ -318,12 +302,6 @@
                 "id": "evt_01KXG04TR8RKRV4VB4JK9HPDZ0",
                 "key": "@config.action",
                 "name": "@config.action",
-                "payloadSchema": [
-                  {
-                    "name": "id",
-                    "type": "string"
-                  }
-                ],
                 "tier": "essential"
               }
             ],

package/behaviors/registry/ui/game/atoms/ui-control-button.orb

@@ -284,28 +284,18 @@
           },
           "emits": [
             {
+              "definerKnob": "onPress",
               "description": "Called when button is pressed",
               "event": "@config.onPress",
               "eventId": "evt_01KXG04TSZA72XSK8YGTW7MTKM",
-              "payloadSchema": [
-                {
-                  "name": "id",
-                  "type": "string"
-                }
-              ],
               "scope": "external",
               "tier": "essential"
             },
             {
+              "definerKnob": "onRelease",
               "description": "Called when button is released",
               "event": "@config.onRelease",
               "eventId": "evt_01KXG04TSZBNWYF8W5QF96M4PT",
-              "payloadSchema": [
-                {
-                  "name": "id",
-                  "type": "string"
-                }
-              ],
               "scope": "external",
               "tier": "essential"
             }
@@ -335,12 +325,6 @@
                 "id": "evt_01KXG04TSZA72XSK8YGTW7MTKM",
                 "key": "@config.onPress",
                 "name": "@config.on press",
-                "payloadSchema": [
-                  {
-                    "name": "id",
-                    "type": "string"
-                  }
-                ],
                 "tier": "essential"
               },
               {
@@ -348,12 +332,6 @@
                 "id": "evt_01KXG04TSZBNWYF8W5QF96M4PT",
                 "key": "@config.onRelease",
                 "name": "@config.on release",
-                "payloadSchema": [
-                  {
-                    "name": "id",
-                    "type": "string"
-                  }
-                ],
                 "tier": "essential"
               }
             ],

package/behaviors/registry/ui/game/atoms/ui-control-grid.orb

@@ -448,6 +448,7 @@
           },
           "emits": [
             {
+              "definerKnob": "onAction",
               "description": "Called when a button/direction is pressed or released",
               "event": "@config.onAction",
               "eventId": "evt_01M055GP1Q3FFWYHXRB0AVBMH2",
@@ -465,6 +466,7 @@
               "tier": "essential"
             },
             {
+              "definerKnob": "onDirection",
               "description": "Called when a direction is pressed or released (kind='dpad' convenience overload)",
               "event": "@config.onDirection",
               "eventId": "evt_01M055GP1Q1RB9KMXAPFNSGNH5",

package/behaviors/registry/ui/game/atoms/ui-draw-fx-layer.orb

@@ -88,7 +88,7 @@
               "items": {
                 "items": {
                   "items": {
-                    "type": "object"
+                    "type": "node"
                   },
                   "type": "array"
                 },
@@ -96,13 +96,14 @@
               },
               "label": "Art",
               "tier": "presentation",
-              "type": "Map<string,Map<string,[object]>>"
+              "type": "Map<string,Map<string,[node]>>"
             },
             "items": {
               "default": [
                 {
                   "id": "e1",
                   "message": "Unit spawned",
+                  "ttl": 1.0,
                   "type": "spawn",
                   "x": 2.0,
                   "y": 2.0
@@ -110,6 +111,7 @@
                 {
                   "id": "e2",
                   "message": "Attack landed",
+                  "ttl": 2.0,
                   "type": "effect",
                   "x": 3.0,
                   "y": 1.0
@@ -118,6 +120,11 @@
               "description": "The live fx entries — the mechanic's `@entity.fx` list passed whole; `space: 'screen'` entries are skipped (the overlay owns those).",
               "items": {
                 "properties": {
+                  "animation": {
+                    "name": "animation",
+                    "required": false,
+                    "type": "string"
+                  },
                   "bornAt": {
                     "name": "bornAt",
                     "required": false,
@@ -249,6 +256,11 @@
               "description": "Consumer-declared effect vocabulary — one row per fx `type` (look + recipe). Unknown types fall back to a neutral spark burst.",
               "items": {
                 "properties": {
+                  "animation": {
+                    "name": "animation",
+                    "required": false,
+                    "type": "string"
+                  },
                   "color": {
                     "name": "color",
                     "required": false,

package/behaviors/registry/ui/game/atoms/ui-draw-group.orb

@@ -184,11 +184,11 @@
               "default": [],
               "description": "The grouped drawables, painted through the normal dispatch.",
               "items": {
-                "type": "object"
+                "type": "node"
               },
               "label": "Items",
               "tier": "presentation",
-              "type": "[object]"
+              "type": "[node]"
             },
             "opacity": {
               "description": "0..1 opacity.",