@almadar/std 16.197.0 → 16.199.0

package/behaviors/registry/ui/core/templates/ui-dashboard-layout.orb

@@ -172,7 +172,10 @@
                   },
                   "children": {
                     "items": {
-                      "type": "object"
+                      "type": "union",
+                      "values": [
+                        "DashboardLayoutNavItemsItem"
+                      ]
                     },
                     "name": "children",
                     "required": false,
@@ -310,7 +313,7 @@
                   },
                   "event": {
                     "name": "event",
-                    "required": true,
+                    "required": false,
                     "type": "event"
                   },
                   "icon": {
@@ -323,6 +326,11 @@
                     "required": false,
                     "type": "string"
                   },
+                  "navigatesTo": {
+                    "name": "navigatesTo",
+                    "required": false,
+                    "type": "string"
+                  },
                   "variant": {
                     "name": "variant",
                     "required": false,
@@ -366,6 +374,7 @@
           },
           "emits": [
             {
+              "definerKnob": "searchEvent",
               "description": "Declarative search event — fires `UI:{searchEvent}` on the bus when the user submits the search box (Enter key). Setting this implies `showSearch=true`. Use `onSearchSubmit` for direct React usage instead.",
               "event": "@config.searchEvent",
               "eventId": "evt_01KXG04TC138XK52TG435GHH2P",
@@ -380,6 +389,7 @@
               "tier": "essential"
             },
             {
+              "definerKnob": "onSearchSubmit",
               "description": "React-side search submit callback. Used when the host wires the layout directly (not via render-ui pattern resolution).",
               "event": "@config.onSearchSubmit",
               "eventId": "evt_01KXG04TC1ENK77X916YWX7CTN",
@@ -393,28 +403,18 @@
               "tier": "essential"
             },
             {
+              "definerKnob": "notificationClickEvent",
               "description": "Declarative bell click event — fires `UI:{notificationClickEvent}` on the bus with an empty payload when the user clicks the bell.",
               "event": "@config.notificationClickEvent",
               "eventId": "evt_01KXG04TC132HDYY1JAATC6G3M",
-              "payloadSchema": [
-                {
-                  "name": "id",
-                  "type": "string"
-                }
-              ],
               "scope": "external",
               "tier": "essential"
             },
             {
+              "definerKnob": "onSignOut",
               "description": "Callback when user clicks sign out (optional - uses auth context signOut if not provided)",
               "event": "@config.onSignOut",
               "eventId": "evt_01KXG04TC1R6MBQBTSP2QTGYXT",
-              "payloadSchema": [
-                {
-                  "name": "id",
-                  "type": "string"
-                }
-              ],
               "scope": "external",
               "tier": "essential"
             }
@@ -471,12 +471,6 @@
                 "id": "evt_01KXG04TC132HDYY1JAATC6G3M",
                 "key": "@config.notificationClickEvent",
                 "name": "@config.notification click event",
-                "payloadSchema": [
-                  {
-                    "name": "id",
-                    "type": "string"
-                  }
-                ],
                 "tier": "essential"
               },
               {
@@ -484,12 +478,6 @@
                 "id": "evt_01KXG04TC1R6MBQBTSP2QTGYXT",
                 "key": "@config.onSignOut",
                 "name": "@config.on sign out",
-                "payloadSchema": [
-                  {
-                    "name": "id",
-                    "type": "string"
-                  }
-                ],
                 "tier": "essential"
               }
             ],
@@ -537,7 +525,124 @@
             ]
           }
         }
-      ]
+      ],
+      "types": {
+        "DashboardLayoutNavItemsItem": [
+          {
+            "name": "label",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "href",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "icon",
+            "type": "icon"
+          },
+          {
+            "name": "badge",
+            "type": "string"
+          },
+          {
+            "name": "children",
+            "properties": [
+              {
+                "name": "label",
+                "required": true,
+                "type": "string"
+              },
+              {
+                "name": "href",
+                "required": true,
+                "type": "string"
+              },
+              {
+                "name": "icon",
+                "type": "icon"
+              },
+              {
+                "name": "badge",
+                "type": "string"
+              },
+              {
+                "name": "children",
+                "properties": [],
+                "type": "[DashboardLayoutNavItemsItem]"
+              }
+            ],
+            "type": "[object]"
+          }
+        ],
+        "DashboardLayoutNotificationsItem": [
+          {
+            "name": "id",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "message",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "description",
+            "type": "string"
+          },
+          {
+            "name": "createdAt",
+            "type": "string"
+          },
+          {
+            "name": "read",
+            "type": "boolean"
+          }
+        ],
+        "DashboardLayoutTopBarActionsItem": [
+          {
+            "name": "icon",
+            "required": true,
+            "type": "icon"
+          },
+          {
+            "name": "label",
+            "type": "string"
+          },
+          {
+            "name": "event",
+            "type": "event"
+          },
+          {
+            "name": "navigatesTo",
+            "type": "string"
+          },
+          {
+            "name": "badge",
+            "type": "string"
+          },
+          {
+            "name": "variant",
+            "type": "string"
+          }
+        ],
+        "DashboardLayoutUser": [
+          {
+            "name": "name",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "email",
+            "type": "string"
+          },
+          {
+            "name": "avatar",
+            "type": "asset"
+          }
+        ]
+      }
     }
   ],
   "schemaVersion": 1,

package/behaviors/registry/ui/game/atoms/std-fx-particles.orb

@@ -78,6 +78,11 @@
             "default": [],
             "items": {
               "properties": {
+                "animation": {
+                  "name": "animation",
+                  "required": false,
+                  "type": "string"
+                },
                 "bornAt": {
                   "name": "bornAt",
                   "required": false,
@@ -206,6 +211,11 @@
               "description": "Seed particles rendered before the first BURST; usually empty.",
               "items": {
                 "properties": {
+                  "animation": {
+                    "name": "animation",
+                    "required": false,
+                    "type": "string"
+                  },
                   "bornAt": {
                     "name": "bornAt",
                     "required": false,
@@ -407,6 +417,10 @@
                       {
                         "name": "particleCount",
                         "type": "number"
+                      },
+                      {
+                        "name": "animation",
+                        "type": "string"
                       }
                     ],
                     "type": "[object]"

package/behaviors/registry/ui/game/atoms/std-mesh-asset-art.orb

@@ -76,8 +76,17 @@
           },
           {
             "default": {},
+            "items": {
+              "items": {
+                "items": {
+                  "type": "node"
+                },
+                "type": "array"
+              },
+              "type": "object"
+            },
             "name": "meshAssetArt",
-            "type": "string"
+            "type": "object"
           }
         ],
         "id": "ent_01KYW6V1CFDTB39012XJ6R2F0X",
@@ -107,9 +116,12 @@
             "seedArt": {
               "default": {},
               "description": "Initial kind → (state → draw-group items of draw-mesh descriptors) catalog merged under bus-published entries (published entries win). Lets a 3D board ship volumetric art with zero asset imports.",
+              "items": {
+                "type": "opaque"
+              },
               "label": "Seed Art",
               "tier": "presentation",
-              "type": "json"
+              "type": "Map<string,opaque>"
             }
           },
           "emits": [
@@ -161,7 +173,7 @@
                   },
                   {
                     "name": "states",
-                    "type": "json"
+                    "type": "Map<string,opaque>"
                   }
                 ]
               }

package/behaviors/registry/ui/game/atoms/std-svg-asset-art.orb

@@ -76,8 +76,17 @@
           },
           {
             "default": {},
+            "items": {
+              "items": {
+                "items": {
+                  "type": "node"
+                },
+                "type": "array"
+              },
+              "type": "object"
+            },
             "name": "svgAssetArt",
-            "type": "string"
+            "type": "object"
           }
         ],
         "id": "ent_01KYV3PJKCJSAVS17HX3HBTZQG",
@@ -107,9 +116,12 @@
             "seedArt": {
               "default": {},
               "description": "Initial kind → (state → draw-group items) catalog merged under bus-published entries (published entries win). Lets a board ship vector art with zero asset imports.",
+              "items": {
+                "type": "opaque"
+              },
               "label": "Seed Art",
               "tier": "presentation",
-              "type": "json"
+              "type": "Map<string,opaque>"
             }
           },
           "emits": [
@@ -161,7 +173,7 @@
                   },
                   {
                     "name": "states",
-                    "type": "json"
+                    "type": "Map<string,opaque>"
                   }
                 ]
               }

package/behaviors/registry/ui/game/atoms/ui-action-palette.orb

@@ -100,7 +100,30 @@
                     "url": "https://almadar-kflow-assets.web.app/shared/ui-battle-board/default/ui/star.png"
                   },
                   "id": "Id",
-                  "name": "Name"
+                  "name": "Name",
+                  "stateMachine": {
+                    "currentState": "Current State",
+                    "description": "Description",
+                    "name": "Name",
+                    "states": [
+                      "Item",
+                      "Item 2"
+                    ],
+                    "transitions": [
+                      {
+                        "event": "Event",
+                        "from": "From",
+                        "guardHint": "Guard Hint",
+                        "to": "To"
+                      },
+                      {
+                        "event": "Event 2",
+                        "from": "From 2",
+                        "guardHint": "Guard Hint 2",
+                        "to": "To 2"
+                      }
+                    ]
+                  }
                 },
                 {
                   "category": "Category 2",
@@ -120,7 +143,30 @@
                     "url": "https://almadar-kflow-assets.web.app/shared/ui-battle-board/default/ui/star.png"
                   },
                   "id": "Id 2",
-                  "name": "Name 2"
+                  "name": "Name 2",
+                  "stateMachine": {
+                    "currentState": "Current State 2",
+                    "description": "Description 2",
+                    "name": "Name 2",
+                    "states": [
+                      "Item",
+                      "Item 2"
+                    ],
+                    "transitions": [
+                      {
+                        "event": "Event",
+                        "from": "From",
+                        "guardHint": "Guard Hint",
+                        "to": "To"
+                      },
+                      {
+                        "event": "Event 2",
+                        "from": "From 2",
+                        "guardHint": "Guard Hint 2",
+                        "to": "To 2"
+                      }
+                    ]
+                  }
                 }
               ],
               "description": "Available actions",
@@ -240,6 +286,61 @@
                   },
                   "stateMachine": {
                     "name": "stateMachine",
+                    "properties": {
+                      "currentState": {
+                        "name": "currentState",
+                        "required": true,
+                        "type": "string"
+                      },
+                      "description": {
+                        "name": "description",
+                        "required": false,
+                        "type": "string"
+                      },
+                      "name": {
+                        "name": "name",
+                        "required": true,
+                        "type": "string"
+                      },
+                      "states": {
+                        "items": {
+                          "type": "string"
+                        },
+                        "name": "states",
+                        "required": true,
+                        "type": "array"
+                      },
+                      "transitions": {
+                        "items": {
+                          "properties": {
+                            "event": {
+                              "name": "event",
+                              "required": true,
+                              "type": "string"
+                            },
+                            "from": {
+                              "name": "from",
+                              "required": true,
+                              "type": "string"
+                            },
+                            "guardHint": {
+                              "name": "guardHint",
+                              "required": false,
+                              "type": "string"
+                            },
+                            "to": {
+                              "name": "to",
+                              "required": true,
+                              "type": "string"
+                            }
+                          },
+                          "type": "object"
+                        },
+                        "name": "transitions",
+                        "required": true,
+                        "type": "array"
+                      }
+                    },
                     "required": false,
                     "type": "object"
                   }

package/behaviors/registry/ui/game/atoms/ui-action-tile.orb

@@ -99,7 +99,30 @@
                   "url": "https://almadar-kflow-assets.web.app/shared/ui-battle-board/default/ui/star.png"
                 },
                 "id": "Id",
-                "name": "Name"
+                "name": "Name",
+                "stateMachine": {
+                  "currentState": "Current State",
+                  "description": "Description",
+                  "name": "Name",
+                  "states": [
+                    "Item",
+                    "Item 2"
+                  ],
+                  "transitions": [
+                    {
+                      "event": "Event",
+                      "from": "From",
+                      "guardHint": "Guard Hint",
+                      "to": "To"
+                    },
+                    {
+                      "event": "Event 2",
+                      "from": "From 2",
+                      "guardHint": "Guard Hint 2",
+                      "to": "To 2"
+                    }
+                  ]
+                }
               },
               "description": "The action data",
               "label": "Action",
@@ -218,6 +241,61 @@
                 },
                 "stateMachine": {
                   "name": "stateMachine",
+                  "properties": {
+                    "currentState": {
+                      "name": "currentState",
+                      "required": true,
+                      "type": "string"
+                    },
+                    "description": {
+                      "name": "description",
+                      "required": false,
+                      "type": "string"
+                    },
+                    "name": {
+                      "name": "name",
+                      "required": true,
+                      "type": "string"
+                    },
+                    "states": {
+                      "items": {
+                        "type": "string"
+                      },
+                      "name": "states",
+                      "required": true,
+                      "type": "array"
+                    },
+                    "transitions": {
+                      "items": {
+                        "properties": {
+                          "event": {
+                            "name": "event",
+                            "required": true,
+                            "type": "string"
+                          },
+                          "from": {
+                            "name": "from",
+                            "required": true,
+                            "type": "string"
+                          },
+                          "guardHint": {
+                            "name": "guardHint",
+                            "required": false,
+                            "type": "string"
+                          },
+                          "to": {
+                            "name": "to",
+                            "required": true,
+                            "type": "string"
+                          }
+                        },
+                        "type": "object"
+                      },
+                      "name": "transitions",
+                      "required": true,
+                      "type": "array"
+                    }
+                  },
                   "required": false,
                   "type": "object"
                 }

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

@@ -179,11 +179,11 @@
               "default": [],
               "description": "--- Scene ---",
               "items": {
-                "type": "object"
+                "type": "node"
               },
               "label": "Drawables",
               "tier": "presentation",
-              "type": "[object]"
+              "type": "[node]"
             },
             "error": {
               "description": "Error state",
@@ -339,6 +339,7 @@
           },
           "emits": [
             {
+              "definerKnob": "tileClickEvent",
               "description": "--- Declarative events back to LOLO ---",
               "event": "@config.tileClickEvent",
               "eventId": "evt_01M055GNYPZJ1B85V8PJJKAH3G",
@@ -358,6 +359,7 @@
               "tier": "essential"
             },
             {
+              "definerKnob": "unitClickEvent",
               "description": "Unit-click event. The neutral drawable host cannot resolve a click to a per-entity id (descriptors carry only a `ScenePos`, no id), so this prop is accepted but not yet emitted — the id-hit-test is a tracked fork (docs/Almadar_Std_Game_V2_PLAN.md).",
               "event": "@config.unitClickEvent",
               "eventId": "evt_01M055GNYPK44W2BW0QREKG351",
@@ -372,6 +374,7 @@
               "tier": "essential"
             },
             {
+              "definerKnob": "tileHoverEvent",
               "description": "Emits UI:{tileHoverEvent} with the unprojected scene { x, y } on hover.",
               "event": "@config.tileHoverEvent",
               "eventId": "evt_01M055GNYP001PZTRX5N4CHPKZ",
@@ -391,15 +394,10 @@
               "tier": "essential"
             },
             {
+              "definerKnob": "tileLeaveEvent",
               "description": "Emits UI:{tileLeaveEvent} with {} on pointer leave.",
               "event": "@config.tileLeaveEvent",
               "eventId": "evt_01M055GNYPQZ509HNQSND656XT",
-              "payloadSchema": [
-                {
-                  "name": "id",
-                  "type": "string"
-                }
-              ],
               "scope": "external",
               "tier": "essential"
             }
@@ -481,12 +479,6 @@
                 "id": "evt_01M055GNYPQZ509HNQSND656XT",
                 "key": "@config.tileLeaveEvent",
                 "name": "@config.tile leave event",
-                "payloadSchema": [
-                  {
-                    "name": "id",
-                    "type": "string"
-                  }
-                ],
                 "tier": "essential"
               }
             ],