@almadar/std 16.197.0 → 16.199.0

package/behaviors/registry/ui/core/molecules/ui-search-input.orb

@@ -173,6 +173,7 @@
           },
           "emits": [
             {
+              "definerKnob": "onSearch",
               "description": "Callback when search value changes",
               "event": "@config.onSearch",
               "eventId": "evt_01KXG04R0C37XSAZN1EX0F4AXZ",
@@ -186,12 +187,18 @@
               "tier": "essential"
             },
             {
+              "definerKnob": "event",
               "description": "Declarative search event — emits UI:{event} via eventBus on query submit (alongside canonical UI:SEARCH)",
               "event": "@config.event",
               "eventId": "evt_01KYC06S4G3K7GBQ9XAPXR61GW",
               "payloadSchema": [
                 {
-                  "name": "id",
+                  "name": "searchTerm",
+                  "required": true,
+                  "type": "string"
+                },
+                {
+                  "name": "entity",
                   "type": "string"
                 }
               ],
@@ -252,7 +259,12 @@
                 "name": "@config.event",
                 "payloadSchema": [
                   {
-                    "name": "id",
+                    "name": "searchTerm",
+                    "required": true,
+                    "type": "string"
+                  },
+                  {
+                    "name": "entity",
                     "type": "string"
                   }
                 ],

package/behaviors/registry/ui/core/molecules/ui-side-panel.orb

@@ -176,15 +176,10 @@
           },
           "emits": [
             {
+              "definerKnob": "onClose",
               "description": "On close handler",
               "event": "@config.onClose",
               "eventId": "evt_01KXG04R3HM7RC1MJGFXW9QY43",
-              "payloadSchema": [
-                {
-                  "name": "id",
-                  "type": "string"
-                }
-              ],
               "scope": "external",
               "tier": "essential"
             },
@@ -245,12 +240,6 @@
                 "id": "evt_01KXG04R3HM7RC1MJGFXW9QY43",
                 "key": "@config.onClose",
                 "name": "@config.on close",
-                "payloadSchema": [
-                  {
-                    "name": "id",
-                    "type": "string"
-                  }
-                ],
                 "tier": "essential"
               }
             ],

package/behaviors/registry/ui/core/molecules/ui-sidebar.orb

@@ -270,7 +270,10 @@
                   },
                   "subItems": {
                     "items": {
-                      "type": "object"
+                      "type": "union",
+                      "values": [
+                        "SidebarItemsItem"
+                      ]
                     },
                     "name": "subItems",
                     "required": false,
@@ -319,6 +322,7 @@
           },
           "emits": [
             {
+              "definerKnob": "collapseChangeEvent",
               "description": "Event emitted when collapse state changes, payload: { collapsed: boolean }",
               "event": "@config.collapseChangeEvent",
               "eventId": "evt_01KXG04R5D1EG5ESZVS3NSVV47",
@@ -333,28 +337,18 @@
               "tier": "essential"
             },
             {
+              "definerKnob": "closeEvent",
               "description": "Event emitted when close button is clicked",
               "event": "@config.closeEvent",
               "eventId": "evt_01KXG04R5DC3ZZQF9JCBYDXKK4",
-              "payloadSchema": [
-                {
-                  "name": "id",
-                  "type": "string"
-                }
-              ],
               "scope": "external",
               "tier": "essential"
             },
             {
+              "definerKnob": "logoClickEvent",
               "description": "Event emitted when logo/brand is clicked",
               "event": "@config.logoClickEvent",
               "eventId": "evt_01KXG04R5DMEFBCNXND72D183E",
-              "payloadSchema": [
-                {
-                  "name": "id",
-                  "type": "string"
-                }
-              ],
               "scope": "external",
               "tier": "essential"
             }
@@ -412,12 +406,6 @@
                 "id": "evt_01KXG04R5DC3ZZQF9JCBYDXKK4",
                 "key": "@config.closeEvent",
                 "name": "@config.close event",
-                "payloadSchema": [
-                  {
-                    "name": "id",
-                    "type": "string"
-                  }
-                ],
                 "tier": "essential"
               },
               {
@@ -425,12 +413,6 @@
                 "id": "evt_01KXG04R5DMEFBCNXND72D183E",
                 "key": "@config.logoClickEvent",
                 "name": "@config.logo click event",
-                "payloadSchema": [
-                  {
-                    "name": "id",
-                    "type": "string"
-                  }
-                ],
                 "tier": "essential"
               }
             ],
@@ -516,7 +498,101 @@
             ]
           }
         }
-      ]
+      ],
+      "types": {
+        "SidebarError": [
+          {
+            "name": "message",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "name",
+            "type": "string"
+          },
+          {
+            "name": "code",
+            "type": "string"
+          },
+          {
+            "name": "stack",
+            "type": "string"
+          }
+        ],
+        "SidebarItemsItem": [
+          {
+            "name": "id",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "label",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "icon",
+            "type": "icon"
+          },
+          {
+            "name": "badge",
+            "type": "string"
+          },
+          {
+            "name": "href",
+            "type": "string"
+          },
+          {
+            "name": "active",
+            "type": "boolean"
+          },
+          {
+            "name": "isActive",
+            "type": "boolean"
+          },
+          {
+            "name": "subItems",
+            "properties": [
+              {
+                "name": "id",
+                "required": true,
+                "type": "string"
+              },
+              {
+                "name": "label",
+                "required": true,
+                "type": "string"
+              },
+              {
+                "name": "icon",
+                "type": "icon"
+              },
+              {
+                "name": "badge",
+                "type": "string"
+              },
+              {
+                "name": "href",
+                "type": "string"
+              },
+              {
+                "name": "active",
+                "type": "boolean"
+              },
+              {
+                "name": "isActive",
+                "type": "boolean"
+              },
+              {
+                "name": "subItems",
+                "properties": [],
+                "type": "[SidebarItemsItem]"
+              }
+            ],
+            "type": "[object]"
+          }
+        ]
+      }
     }
   ],
   "schemaVersion": 1,

package/behaviors/registry/ui/core/molecules/ui-signature-pad.orb

@@ -217,6 +217,7 @@
           },
           "emits": [
             {
+              "definerKnob": "onChange",
               "description": "Callback when signature changes",
               "event": "@config.onChange",
               "eventId": "evt_01KXG04R7P85AG6MZ64ZQ7ACGQ",
@@ -230,6 +231,7 @@
               "tier": "essential"
             },
             {
+              "definerKnob": "signEvent",
               "description": "Event to emit on sign",
               "event": "@config.signEvent",
               "eventId": "evt_01KXG04R7PHRS8CQSFVKR42PBV",
@@ -244,15 +246,10 @@
               "tier": "essential"
             },
             {
+              "definerKnob": "clearEvent",
               "description": "Event to emit on clear",
               "event": "@config.clearEvent",
               "eventId": "evt_01KXG04R7PQ9E04T1ZYDDEZTES",
-              "payloadSchema": [
-                {
-                  "name": "id",
-                  "type": "string"
-                }
-              ],
               "scope": "external",
               "tier": "essential"
             }
@@ -309,12 +306,6 @@
                 "id": "evt_01KXG04R7PQ9E04T1ZYDDEZTES",
                 "key": "@config.clearEvent",
                 "name": "@config.clear event",
-                "payloadSchema": [
-                  {
-                    "name": "id",
-                    "type": "string"
-                  }
-                ],
                 "tier": "essential"
               }
             ],

package/behaviors/registry/ui/core/molecules/ui-sortable-list.orb

@@ -130,11 +130,10 @@
               "type": "event"
             },
             "reorderPayload": {
-              "default": {},
               "description": "reorderPayload prop",
               "label": "Reorder Payload",
               "tier": "presentation",
-              "type": "json"
+              "type": "@payload(reorderEvent)"
             },
             "selfFetch": {
               "default": true,
@@ -146,13 +145,25 @@
           },
           "emits": [
             {
+              "definerKnob": "reorderEvent",
               "description": "reorderEvent prop",
               "event": "@config.reorderEvent",
               "eventId": "evt_01KXG04RJ0FKCT7VTWQK8C121Z",
               "payloadSchema": [
                 {
-                  "name": "id",
-                  "type": "string"
+                  "name": "fromIndex",
+                  "required": true,
+                  "type": "number"
+                },
+                {
+                  "name": "toIndex",
+                  "required": true,
+                  "type": "number"
+                },
+                {
+                  "name": "item",
+                  "required": true,
+                  "type": "@entity"
                 }
               ],
               "scope": "external",
@@ -214,8 +225,19 @@
                 "name": "@config.reorder event",
                 "payloadSchema": [
                   {
-                    "name": "id",
-                    "type": "string"
+                    "name": "fromIndex",
+                    "required": true,
+                    "type": "number"
+                  },
+                  {
+                    "name": "toIndex",
+                    "required": true,
+                    "type": "number"
+                  },
+                  {
+                    "name": "item",
+                    "required": true,
+                    "type": "@entity"
                   }
                 ],
                 "tier": "essential"

package/behaviors/registry/ui/core/molecules/ui-star-rating.orb

@@ -46,6 +46,15 @@
         "parent": "trt_01KXG04RNP6TY9Z342EQ0KX6DS",
         "renames": []
       },
+      "evt_01M1CHY5P4VMNW56C77SFM8ZXD": {
+        "bakedName": "ACTION",
+        "curName": "ACTION",
+        "id": "evt_01M1CHY5P4VMNW56C77SFM8ZXD",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KXG04RNP6TY9Z342EQ0KX6DS",
+        "renames": []
+      },
       "orb_01KXG04RNPQ740XZCK84RTN2HB": {
         "bakedName": "StarRatingOrbital",
         "curName": "StarRatingOrbital",
@@ -120,11 +129,10 @@
               "type": "event"
             },
             "actionPayload": {
-              "default": {},
               "description": "Payload to include with the action event",
               "label": "Action Payload",
               "tier": "presentation",
-              "type": "json"
+              "type": "@payload(action)"
             },
             "className": {
               "description": "Additional CSS classes",
@@ -192,19 +200,22 @@
           },
           "emits": [
             {
+              "definerKnob": "action",
               "description": "Declarative event name for rating changes",
               "event": "@config.action",
               "eventId": "evt_01KXG04RNRA69P9ESERSGGCHK8",
               "payloadSchema": [
                 {
-                  "name": "id",
-                  "type": "string"
+                  "name": "value",
+                  "required": true,
+                  "type": "number"
                 }
               ],
               "scope": "external",
               "tier": "essential"
             },
             {
+              "definerKnob": "onChange",
               "description": "Direct onChange callback",
               "event": "@config.onChange",
               "eventId": "evt_01KXG04RNRNWNNFSPRVE8GP1H7",
@@ -240,6 +251,18 @@
                 "key": "INIT",
                 "name": "Initialize"
               },
+              {
+                "id": "evt_01M1CHY5P4VMNW56C77SFM8ZXD",
+                "key": "ACTION",
+                "name": "Action",
+                "payloadSchema": [
+                  {
+                    "name": "value",
+                    "required": true,
+                    "type": "number"
+                  }
+                ]
+              },
               {
                 "id": "evt_01KXG04RNRMMVVR7P5K9BHDB51",
                 "key": "CHANGE",
@@ -258,8 +281,9 @@
                 "name": "@config.action",
                 "payloadSchema": [
                   {
-                    "name": "id",
-                    "type": "string"
+                    "name": "value",
+                    "required": true,
+                    "type": "number"
                   }
                 ],
                 "tier": "essential"
@@ -315,6 +339,36 @@
                 "from": "idle",
                 "to": "idle"
               },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.value",
+                    "@payload.value"
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "action": "@config.action",
+                      "actionPayload": "@config.actionPayload",
+                      "className": "@config.className",
+                      "label": "@config.label",
+                      "max": "@config.max",
+                      "onChange": "@config.onChange",
+                      "precision": "@config.precision",
+                      "readOnly": "@config.readOnly",
+                      "size": "@config.size",
+                      "type": "star-rating",
+                      "value": "@entity.value"
+                    }
+                  ]
+                ],
+                "event": "ACTION",
+                "eventId": "evt_01M1CHY5P4VMNW56C77SFM8ZXD",
+                "from": "idle",
+                "to": "idle"
+              },
               {
                 "effects": [
                   [

package/behaviors/registry/ui/core/molecules/ui-swipeable-row.orb

@@ -93,11 +93,10 @@
               "type": "string"
             },
             "itemData": {
-              "default": {},
               "description": "itemData prop",
               "label": "Item Data",
               "tier": "presentation",
-              "type": "json"
+              "type": "opaque"
             },
             "leftActions": {
               "default": [],
@@ -112,7 +111,7 @@
                   "eventPayload": {
                     "name": "eventPayload",
                     "required": false,
-                    "type": "string"
+                    "type": "opaque"
                   },
                   "icon": {
                     "name": "icon",
@@ -155,7 +154,7 @@
                   "eventPayload": {
                     "name": "eventPayload",
                     "required": false,
-                    "type": "string"
+                    "type": "opaque"
                   },
                   "icon": {
                     "name": "icon",

package/behaviors/registry/ui/core/molecules/ui-table-view.orb

@@ -455,7 +455,7 @@
             },
             "selectEvent": {
               "default": "SELECT",
-              "description": "Event emitted on selection change: UI:{selectEvent} with { ids, rows }.",
+              "description": "Event emitted on selection change: UI:{selectEvent} with { selectedIds }.",
               "label": "Select Event",
               "tier": "presentation",
               "type": "event"
@@ -517,25 +517,34 @@
           },
           "emits": [
             {
-              "description": "Event emitted on selection change: UI:{selectEvent} with { ids, rows }.",
+              "definerKnob": "selectEvent",
+              "description": "Event emitted on selection change: UI:{selectEvent} with { selectedIds }.",
               "event": "@config.selectEvent",
               "eventId": "evt_01KXG04RSDTCZQPH74KHHQR5MZ",
               "payloadSchema": [
                 {
-                  "name": "id",
-                  "type": "string"
+                  "name": "selectedIds",
+                  "required": true,
+                  "type": "[string]"
                 }
               ],
               "scope": "external",
               "tier": "essential"
             },
             {
+              "definerKnob": "sortEvent",
               "description": "Event emitted on sortable-header click: UI:{sortEvent} with { column, direction }.",
               "event": "@config.sortEvent",
               "eventId": "evt_01KXG04RSDX3BXZBA0CDEKZV1G",
               "payloadSchema": [
                 {
-                  "name": "id",
+                  "name": "column",
+                  "required": true,
+                  "type": "string"
+                },
+                {
+                  "name": "direction",
+                  "required": true,
                   "type": "string"
                 }
               ],
@@ -549,7 +558,13 @@
               "payloadSchema": [
                 {
                   "name": "id",
+                  "required": true,
                   "type": "string"
+                },
+                {
+                  "name": "row",
+                  "required": true,
+                  "type": "@entity"
                 }
               ],
               "scope": "external",
@@ -605,14 +620,15 @@
                 "tier": "essential"
               },
               {
-                "description": "Event emitted on selection change: UI:{selectEvent} with { ids, rows }.",
+                "description": "Event emitted on selection change: UI:{selectEvent} with { selectedIds }.",
                 "id": "evt_01KXG04RSDTCZQPH74KHHQR5MZ",
                 "key": "@config.selectEvent",
                 "name": "@config.select event",
                 "payloadSchema": [
                   {
-                    "name": "id",
-                    "type": "string"
+                    "name": "selectedIds",
+                    "required": true,
+                    "type": "[string]"
                   }
                 ],
                 "tier": "essential"
@@ -624,7 +640,13 @@
                 "name": "@config.sort event",
                 "payloadSchema": [
                   {
-                    "name": "id",
+                    "name": "column",
+                    "required": true,
+                    "type": "string"
+                  },
+                  {
+                    "name": "direction",
+                    "required": true,
                     "type": "string"
                   }
                 ],
@@ -638,7 +660,13 @@
                 "payloadSchema": [
                   {
                     "name": "id",
+                    "required": true,
                     "type": "string"
+                  },
+                  {
+                    "name": "row",
+                    "required": true,
+                    "type": "@entity"
                   }
                 ],
                 "tier": "essential"

package/behaviors/registry/ui/core/molecules/ui-tabs.orb

@@ -435,6 +435,7 @@
           },
           "emits": [
             {
+              "definerKnob": "onTabChange",
               "description": "Callback when tab changes",
               "event": "@config.onTabChange",
               "eventId": "evt_01KXG04RTR97PTWWC14PSEEBTN",