@almadar/std 16.196.0 → 16.198.0

package/behaviors/registry/ui/game/atoms/ui-sequence-bar.orb

@@ -221,7 +221,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",
@@ -241,7 +264,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": "The current sequence (sparse — undefined means empty slot)",
@@ -361,6 +407,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"
                   }
@@ -374,6 +475,7 @@
           },
           "emits": [
             {
+              "definerKnob": "onSlotDrop",
               "description": "Called when an item is dropped into slot at index (callback path)",
               "event": "@config.onSlotDrop",
               "eventId": "evt_01M055GPE1C8HDYAHYQH55SD2Z",
@@ -467,6 +569,53 @@
                     },
                     {
                       "name": "stateMachine",
+                      "properties": [
+                        {
+                          "name": "name",
+                          "required": true,
+                          "type": "string"
+                        },
+                        {
+                          "name": "states",
+                          "required": true,
+                          "type": "[string]"
+                        },
+                        {
+                          "name": "currentState",
+                          "required": true,
+                          "type": "string"
+                        },
+                        {
+                          "name": "transitions",
+                          "properties": [
+                            {
+                              "name": "from",
+                              "required": true,
+                              "type": "string"
+                            },
+                            {
+                              "name": "to",
+                              "required": true,
+                              "type": "string"
+                            },
+                            {
+                              "name": "event",
+                              "required": true,
+                              "type": "string"
+                            },
+                            {
+                              "name": "guardHint",
+                              "type": "string"
+                            }
+                          ],
+                          "required": true,
+                          "type": "[object]"
+                        },
+                        {
+                          "name": "description",
+                          "type": "string"
+                        }
+                      ],
                       "type": "object"
                     }
                   ],
@@ -487,6 +636,7 @@
               "tier": "essential"
             },
             {
+              "definerKnob": "onSlotRemove",
               "description": "Called when a slot is cleared (callback path)",
               "event": "@config.onSlotRemove",
               "eventId": "evt_01M055GPE1FWNY4QX2WEPFAZQS",
@@ -620,6 +770,53 @@
                       },
                       {
                         "name": "stateMachine",
+                        "properties": [
+                          {
+                            "name": "name",
+                            "required": true,
+                            "type": "string"
+                          },
+                          {
+                            "name": "states",
+                            "required": true,
+                            "type": "[string]"
+                          },
+                          {
+                            "name": "currentState",
+                            "required": true,
+                            "type": "string"
+                          },
+                          {
+                            "name": "transitions",
+                            "properties": [
+                              {
+                                "name": "from",
+                                "required": true,
+                                "type": "string"
+                              },
+                              {
+                                "name": "to",
+                                "required": true,
+                                "type": "string"
+                              },
+                              {
+                                "name": "event",
+                                "required": true,
+                                "type": "string"
+                              },
+                              {
+                                "name": "guardHint",
+                                "type": "string"
+                              }
+                            ],
+                            "required": true,
+                            "type": "[object]"
+                          },
+                          {
+                            "name": "description",
+                            "type": "string"
+                          }
+                        ],
                         "type": "object"
                       }
                     ],

package/behaviors/registry/ui/game/atoms/ui-state-graph.orb

@@ -188,12 +188,14 @@
           },
           "emits": [
             {
+              "definerKnob": "nodeClickEvent",
               "description": "Emits UI:{nodeClickEvent} with { stateId } when a node is clicked.",
               "event": "@config.nodeClickEvent",
               "eventId": "evt_01M055GPFRGJXP0M6BCAYQRJW2",
               "payloadSchema": [
                 {
-                  "name": "id",
+                  "name": "stateId",
+                  "required": true,
                   "type": "string"
                 }
               ],
@@ -228,7 +230,8 @@
                 "name": "@config.node click event",
                 "payloadSchema": [
                   {
-                    "name": "id",
+                    "name": "stateId",
+                    "required": true,
                     "type": "string"
                   }
                 ],

package/behaviors/registry/ui/game/atoms/ui-trait-slot.orb

@@ -307,6 +307,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"
                 }
@@ -531,6 +586,7 @@
           },
           "emits": [
             {
+              "definerKnob": "onItemDrop",
               "description": "-- Drag and drop --",
               "event": "@config.onItemDrop",
               "eventId": "evt_01M055GPHBRRAB8TVR7NDRNX3Y",
@@ -620,6 +676,53 @@
                     },
                     {
                       "name": "stateMachine",
+                      "properties": [
+                        {
+                          "name": "name",
+                          "required": true,
+                          "type": "string"
+                        },
+                        {
+                          "name": "states",
+                          "required": true,
+                          "type": "[string]"
+                        },
+                        {
+                          "name": "currentState",
+                          "required": true,
+                          "type": "string"
+                        },
+                        {
+                          "name": "transitions",
+                          "properties": [
+                            {
+                              "name": "from",
+                              "required": true,
+                              "type": "string"
+                            },
+                            {
+                              "name": "to",
+                              "required": true,
+                              "type": "string"
+                            },
+                            {
+                              "name": "event",
+                              "required": true,
+                              "type": "string"
+                            },
+                            {
+                              "name": "guardHint",
+                              "type": "string"
+                            }
+                          ],
+                          "required": true,
+                          "type": "[object]"
+                        },
+                        {
+                          "name": "description",
+                          "type": "string"
+                        }
+                      ],
                       "type": "object"
                     }
                   ],
@@ -630,6 +733,7 @@
               "tier": "essential"
             },
             {
+              "definerKnob": "onDragStart",
               "description": "Called when drag starts from this slot",
               "event": "@config.onDragStart",
               "eventId": "evt_01M055GPHBMSHYMHW5FKPHZ0W8",
@@ -719,6 +823,53 @@
                     },
                     {
                       "name": "stateMachine",
+                      "properties": [
+                        {
+                          "name": "name",
+                          "required": true,
+                          "type": "string"
+                        },
+                        {
+                          "name": "states",
+                          "required": true,
+                          "type": "[string]"
+                        },
+                        {
+                          "name": "currentState",
+                          "required": true,
+                          "type": "string"
+                        },
+                        {
+                          "name": "transitions",
+                          "properties": [
+                            {
+                              "name": "from",
+                              "required": true,
+                              "type": "string"
+                            },
+                            {
+                              "name": "to",
+                              "required": true,
+                              "type": "string"
+                            },
+                            {
+                              "name": "event",
+                              "required": true,
+                              "type": "string"
+                            },
+                            {
+                              "name": "guardHint",
+                              "type": "string"
+                            }
+                          ],
+                          "required": true,
+                          "type": "[object]"
+                        },
+                        {
+                          "name": "description",
+                          "type": "string"
+                        }
+                      ],
                       "type": "object"
                     }
                   ],
@@ -729,6 +880,7 @@
               "tier": "essential"
             },
             {
+              "definerKnob": "onClick",
               "description": "-- Callbacks --",
               "event": "@config.onClick",
               "eventId": "evt_01M055GPHBVPFGMP4E4JVC80V2",
@@ -743,6 +895,7 @@
               "tier": "essential"
             },
             {
+              "definerKnob": "dropEvent",
               "description": "Emits UI:{dropEvent} with { slotNumber, itemId } when an item is dropped into this slot",
               "event": "@config.dropEvent",
               "eventId": "evt_01M055GPHB635J0W15V724EWKQ",
@@ -904,6 +1057,53 @@
                       },
                       {
                         "name": "stateMachine",
+                        "properties": [
+                          {
+                            "name": "name",
+                            "required": true,
+                            "type": "string"
+                          },
+                          {
+                            "name": "states",
+                            "required": true,
+                            "type": "[string]"
+                          },
+                          {
+                            "name": "currentState",
+                            "required": true,
+                            "type": "string"
+                          },
+                          {
+                            "name": "transitions",
+                            "properties": [
+                              {
+                                "name": "from",
+                                "required": true,
+                                "type": "string"
+                              },
+                              {
+                                "name": "to",
+                                "required": true,
+                                "type": "string"
+                              },
+                              {
+                                "name": "event",
+                                "required": true,
+                                "type": "string"
+                              },
+                              {
+                                "name": "guardHint",
+                                "type": "string"
+                              }
+                            ],
+                            "required": true,
+                            "type": "[object]"
+                          },
+                          {
+                            "name": "description",
+                            "type": "string"
+                          }
+                        ],
                         "type": "object"
                       }
                     ],
@@ -1003,6 +1203,53 @@
                       },
                       {
                         "name": "stateMachine",
+                        "properties": [
+                          {
+                            "name": "name",
+                            "required": true,
+                            "type": "string"
+                          },
+                          {
+                            "name": "states",
+                            "required": true,
+                            "type": "[string]"
+                          },
+                          {
+                            "name": "currentState",
+                            "required": true,
+                            "type": "string"
+                          },
+                          {
+                            "name": "transitions",
+                            "properties": [
+                              {
+                                "name": "from",
+                                "required": true,
+                                "type": "string"
+                              },
+                              {
+                                "name": "to",
+                                "required": true,
+                                "type": "string"
+                              },
+                              {
+                                "name": "event",
+                                "required": true,
+                                "type": "string"
+                              },
+                              {
+                                "name": "guardHint",
+                                "type": "string"
+                              }
+                            ],
+                            "required": true,
+                            "type": "[object]"
+                          },
+                          {
+                            "name": "description",
+                            "type": "string"
+                          }
+                        ],
                         "type": "object"
                       }
                     ],

package/behaviors/registry/ui/game/organisms/std-tactics-board-2d.orb

@@ -790,8 +790,17 @@
           },
           {
             "default": {},
+            "items": {
+              "items": {
+                "items": {
+                  "type": "node"
+                },
+                "type": "array"
+              },
+              "type": "object"
+            },
             "name": "svgAssetArt",
-            "type": "string"
+            "type": "object"
           }
         ],
         "id": "ent_01M055GPXJZJ7NC8W6DKWM844Y",
@@ -2013,6 +2022,7 @@
               "tier": "domain"
             },
             {
+              "definerKnob": "extraAddonEvent",
               "description": "Board-declared event name for the `extraAddons` action (e.g. Produce). Registers the call-site literal used inside `extraAddons` button descriptors in this trait's own event set.",
               "event": "@config.extraAddonEvent",
               "eventId": "evt_01M055GPXJ4GYDN3NDHC1XS278",

package/behaviors/registry/ui/game/organisms/std-tactics-board-3d.orb

@@ -709,8 +709,17 @@
           },
           {
             "default": {},
+            "items": {
+              "items": {
+                "items": {
+                  "type": "node"
+                },
+                "type": "array"
+              },
+              "type": "object"
+            },
             "name": "meshAssetArt",
-            "type": "string"
+            "type": "object"
           }
         ],
         "id": "ent_01M055GPZ35080PS7F2G7ESD3E",

package/behaviors/registry/ui/game/templates/ui-game-shell.orb

@@ -205,8 +205,8 @@
               "type": "node"
             },
             "fontFamily": {
-              "default": "future",
-              "description": "Game display-font key (future | future-narrow | pixel | blocks | mini) or a CSS font-family. Scoped override of the theme contract's --font-family-display slot: titles and numerics take this face, body text follows the active theme.",
+              "default": "",
+              "description": "Game display-font key (pixel | fredoka | future | future-narrow | blocks | mini) or a CSS font-family. Scoped override of the theme contract's --font-family-display slot: titles and numerics take this face, body text follows the active theme. Empty = the active theme's font-family-display token decides.",
               "label": "Font Family",
               "tier": "presentation",
               "type": "string"

package/behaviors/registry/ui/learning/atoms/std-learn-diagram.orb

@@ -203,14 +203,14 @@
           },
           {
             "items": {
-              "type": "object"
+              "type": "node"
             },
             "name": "captionChildren",
             "type": "array"
           },
           {
             "items": {
-              "type": "object"
+              "type": "node"
             },
             "name": "partButtons",
             "type": "array"

package/behaviors/registry/ui/learning/atoms/std-learn-stepper.orb

@@ -337,7 +337,7 @@
           },
           {
             "items": {
-              "type": "object"
+              "type": "node"
             },
             "name": "filterButtons",
             "type": "array"