@almadar/std 16.197.0 → 16.199.0

package/behaviors/registry/ui/core/atoms/ui-text-highlight.orb

@@ -64,6 +64,24 @@
         "parent": "trt_01KXG04MBA3GR6VT51RQ4ESK2Y",
         "renames": []
       },
+      "evt_01M1CHY4JZ8ZZC1JVEZTPVTBBT": {
+        "bakedName": "ACTION",
+        "curName": "ACTION",
+        "id": "evt_01M1CHY4JZ8ZZC1JVEZTPVTBBT",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KXG04MBA3GR6VT51RQ4ESK2Y",
+        "renames": []
+      },
+      "evt_01M1CHY4JZCBZRHNKWX81SCJ9H": {
+        "bakedName": "HOVER",
+        "curName": "HOVER",
+        "id": "evt_01M1CHY4JZCBZRHNKWX81SCJ9H",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KXG04MBA3GR6VT51RQ4ESK2Y",
+        "renames": []
+      },
       "orb_01KXG04MBAAAJZECCVVJV7MDT9": {
         "bakedName": "TextHighlightOrbital",
         "curName": "TextHighlightOrbital",
@@ -100,6 +118,10 @@
             "name": "id",
             "required": true,
             "type": "string"
+          },
+          {
+            "name": "annotationId",
+            "type": "string"
           }
         ],
         "id": "ent_01KXG04MBA867693BX0BDCN2MJ",
@@ -163,7 +185,7 @@
             },
             "hoverEvent": {
               "default": "HOVER",
-              "description": "Declarative hover event — emits UI:{hoverEvent} with { hovered: true/false }",
+              "description": "Declarative hover event — emits UI:{hoverEvent} with { hovered, annotationId }",
               "label": "Hover Event",
               "tier": "presentation",
               "type": "event"
@@ -199,51 +221,37 @@
           },
           "emits": [
             {
+              "definerKnob": "onClick",
               "description": "Callback when highlight is clicked",
               "event": "@config.onClick",
               "eventId": "evt_01KXG04MBCG66XRY0BRBZH9KCS",
-              "payloadSchema": [
-                {
-                  "name": "id",
-                  "type": "string"
-                }
-              ],
               "scope": "external",
               "tier": "essential"
             },
             {
+              "definerKnob": "onMouseEnter",
               "description": "Callback when highlight is hovered",
               "event": "@config.onMouseEnter",
               "eventId": "evt_01KXG04MBCNZ4FV0XPDQR7KXYM",
-              "payloadSchema": [
-                {
-                  "name": "id",
-                  "type": "string"
-                }
-              ],
               "scope": "external",
               "tier": "essential"
             },
             {
+              "definerKnob": "onMouseLeave",
               "description": "Callback when hover ends",
               "event": "@config.onMouseLeave",
               "eventId": "evt_01KXG04MBCDY7PYB5WT6E3WNH8",
-              "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_01KXG04MBCBZ0JD0HD6EBRN6ME",
               "payloadSchema": [
                 {
-                  "name": "id",
+                  "name": "annotationId",
                   "type": "string"
                 }
               ],
@@ -251,12 +259,18 @@
               "tier": "essential"
             },
             {
-              "description": "Declarative hover event — emits UI:{hoverEvent} with { hovered: true/false }",
+              "definerKnob": "hoverEvent",
+              "description": "Declarative hover event — emits UI:{hoverEvent} with { hovered, annotationId }",
               "event": "@config.hoverEvent",
               "eventId": "evt_01KXG04MBCKZYBB6A0DV7AYFVM",
               "payloadSchema": [
                 {
-                  "name": "id",
+                  "name": "hovered",
+                  "required": true,
+                  "type": "boolean"
+                },
+                {
+                  "name": "annotationId",
                   "type": "string"
                 }
               ],
@@ -265,7 +279,9 @@
             }
           ],
           "entityContract": {
-            "provides": [],
+            "provides": [
+              "annotationId"
+            ],
             "requires": []
           },
           "entityRebindable": true,
@@ -285,16 +301,37 @@
                 "name": "Initialize"
               },
               {
-                "description": "Callback when highlight is clicked",
-                "id": "evt_01KXG04MBCG66XRY0BRBZH9KCS",
-                "key": "@config.onClick",
-                "name": "@config.on click",
+                "id": "evt_01M1CHY4JZ8ZZC1JVEZTPVTBBT",
+                "key": "ACTION",
+                "name": "Action",
                 "payloadSchema": [
                   {
-                    "name": "id",
+                    "name": "annotationId",
                     "type": "string"
                   }
-                ],
+                ]
+              },
+              {
+                "id": "evt_01M1CHY4JZCBZRHNKWX81SCJ9H",
+                "key": "HOVER",
+                "name": "Hover",
+                "payloadSchema": [
+                  {
+                    "name": "hovered",
+                    "required": true,
+                    "type": "boolean"
+                  },
+                  {
+                    "name": "annotationId",
+                    "type": "string"
+                  }
+                ]
+              },
+              {
+                "description": "Callback when highlight is clicked",
+                "id": "evt_01KXG04MBCG66XRY0BRBZH9KCS",
+                "key": "@config.onClick",
+                "name": "@config.on click",
                 "tier": "essential"
               },
               {
@@ -302,12 +339,6 @@
                 "id": "evt_01KXG04MBCNZ4FV0XPDQR7KXYM",
                 "key": "@config.onMouseEnter",
                 "name": "@config.on mouse enter",
-                "payloadSchema": [
-                  {
-                    "name": "id",
-                    "type": "string"
-                  }
-                ],
                 "tier": "essential"
               },
               {
@@ -315,12 +346,6 @@
                 "id": "evt_01KXG04MBCDY7PYB5WT6E3WNH8",
                 "key": "@config.onMouseLeave",
                 "name": "@config.on mouse leave",
-                "payloadSchema": [
-                  {
-                    "name": "id",
-                    "type": "string"
-                  }
-                ],
                 "tier": "essential"
               },
               {
@@ -330,20 +355,25 @@
                 "name": "@config.action",
                 "payloadSchema": [
                   {
-                    "name": "id",
+                    "name": "annotationId",
                     "type": "string"
                   }
                 ],
                 "tier": "essential"
               },
               {
-                "description": "Declarative hover event — emits UI:{hoverEvent} with { hovered: true/false }",
+                "description": "Declarative hover event — emits UI:{hoverEvent} with { hovered, annotationId }",
                 "id": "evt_01KXG04MBCKZYBB6A0DV7AYFVM",
                 "key": "@config.hoverEvent",
                 "name": "@config.hover event",
                 "payloadSchema": [
                   {
-                    "name": "id",
+                    "name": "hovered",
+                    "required": true,
+                    "type": "boolean"
+                  },
+                  {
+                    "name": "annotationId",
                     "type": "string"
                   }
                 ],
@@ -359,12 +389,17 @@
             "transitions": [
               {
                 "effects": [
+                  [
+                    "set",
+                    "@entity.annotationId",
+                    "@config.annotationId"
+                  ],
                   [
                     "render-ui",
                     "main",
                     {
                       "action": "@config.action",
-                      "annotationId": "@config.annotationId",
+                      "annotationId": "@entity.annotationId",
                       "children": "@config.children",
                       "className": "@config.className",
                       "highlightType": "@config.highlightType",
@@ -381,6 +416,66 @@
                 "eventId": "evt_01KXG04MBAEB6FR4QFASF0P9N5",
                 "from": "idle",
                 "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.annotationId",
+                    "@payload.annotationId"
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "action": "@config.action",
+                      "annotationId": "@entity.annotationId",
+                      "children": "@config.children",
+                      "className": "@config.className",
+                      "highlightType": "@config.highlightType",
+                      "hoverEvent": "@config.hoverEvent",
+                      "isActive": "@config.isActive",
+                      "onClick": "@config.onClick",
+                      "onMouseEnter": "@config.onMouseEnter",
+                      "onMouseLeave": "@config.onMouseLeave",
+                      "type": "text-highlight"
+                    }
+                  ]
+                ],
+                "event": "ACTION",
+                "eventId": "evt_01M1CHY4JZ8ZZC1JVEZTPVTBBT",
+                "from": "idle",
+                "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.annotationId",
+                    "@payload.annotationId"
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "action": "@config.action",
+                      "annotationId": "@entity.annotationId",
+                      "children": "@config.children",
+                      "className": "@config.className",
+                      "highlightType": "@config.highlightType",
+                      "hoverEvent": "@config.hoverEvent",
+                      "isActive": "@config.isActive",
+                      "onClick": "@config.onClick",
+                      "onMouseEnter": "@config.onMouseEnter",
+                      "onMouseLeave": "@config.onMouseLeave",
+                      "type": "text-highlight"
+                    }
+                  ]
+                ],
+                "event": "HOVER",
+                "eventId": "evt_01M1CHY4JZCBZRHNKWX81SCJ9H",
+                "from": "idle",
+                "to": "idle"
               }
             ]
           }

package/behaviors/registry/ui/core/atoms/ui-textarea.orb

@@ -139,28 +139,18 @@
           },
           "emits": [
             {
+              "definerKnob": "action",
               "description": "Declarative event name for trait dispatch",
               "event": "@config.action",
               "eventId": "evt_01KXG04MCN5MVPZH4K7YHGNYS0",
-              "payloadSchema": [
-                {
-                  "name": "id",
-                  "type": "string"
-                }
-              ],
               "scope": "external",
               "tier": "essential"
             },
             {
+              "definerKnob": "onChange",
               "description": "onChange handler or declarative event key for trait dispatch",
               "event": "@config.onChange",
               "eventId": "evt_01KXG04MCN9JBEBT36429H3N4R",
-              "payloadSchema": [
-                {
-                  "name": "id",
-                  "type": "string"
-                }
-              ],
               "scope": "external",
               "tier": "essential"
             }
@@ -190,12 +180,6 @@
                 "id": "evt_01KXG04MCN5MVPZH4K7YHGNYS0",
                 "key": "@config.action",
                 "name": "@config.action",
-                "payloadSchema": [
-                  {
-                    "name": "id",
-                    "type": "string"
-                  }
-                ],
                 "tier": "essential"
               },
               {
@@ -203,12 +187,6 @@
                 "id": "evt_01KXG04MCN9JBEBT36429H3N4R",
                 "key": "@config.onChange",
                 "name": "@config.on change",
-                "payloadSchema": [
-                  {
-                    "name": "id",
-                    "type": "string"
-                  }
-                ],
                 "tier": "essential"
               }
             ],

package/behaviors/registry/ui/core/atoms/ui-time-slot-cell.orb

@@ -139,6 +139,7 @@
           },
           "emits": [
             {
+              "definerKnob": "onClick",
               "description": "Called when the slot is clicked",
               "event": "@config.onClick",
               "eventId": "evt_01KXG04MF3GFBD206685434BTQ",

package/behaviors/registry/ui/core/atoms/ui-typewriter-text.orb

@@ -126,15 +126,10 @@
           },
           "emits": [
             {
+              "definerKnob": "onComplete",
               "description": "Called when the entire text has been revealed",
               "event": "@config.onComplete",
               "eventId": "evt_01KXG04MKTJVF0AVR2XHSS5AVY",
-              "payloadSchema": [
-                {
-                  "name": "id",
-                  "type": "string"
-                }
-              ],
               "scope": "external",
               "tier": "essential"
             }
@@ -164,12 +159,6 @@
                 "id": "evt_01KXG04MKTJVF0AVR2XHSS5AVY",
                 "key": "@config.onComplete",
                 "name": "@config.on complete",
-                "payloadSchema": [
-                  {
-                    "name": "id",
-                    "type": "string"
-                  }
-                ],
                 "tier": "essential"
               }
             ],

package/behaviors/registry/ui/core/atoms/ui-vstack.orb

@@ -97,11 +97,10 @@
               "type": "event"
             },
             "actionPayload": {
-              "default": {},
               "description": "Payload to include with the action event",
               "label": "Action Payload",
               "tier": "presentation",
-              "type": "json"
+              "type": "@payload(action)"
             },
             "align": {
               "default": "stretch",
@@ -213,15 +212,10 @@
           },
           "emits": [
             {
+              "definerKnob": "action",
               "description": "Declarative event name — emits UI:{action} via eventBus on click",
               "event": "@config.action",
               "eventId": "evt_01KXG04MPGA5D7RMCC40VAW1GJ",
-              "payloadSchema": [
-                {
-                  "name": "id",
-                  "type": "string"
-                }
-              ],
               "scope": "external",
               "tier": "essential"
             }
@@ -251,12 +245,6 @@
                 "id": "evt_01KXG04MPGA5D7RMCC40VAW1GJ",
                 "key": "@config.action",
                 "name": "@config.action",
-                "payloadSchema": [
-                  {
-                    "name": "id",
-                    "type": "string"
-                  }
-                ],
                 "tier": "essential"
               }
             ],

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

@@ -217,6 +217,7 @@
           },
           "emits": [
             {
+              "definerKnob": "onItemToggle",
               "description": "Callback when item opens/closes",
               "event": "@config.onItemToggle",
               "eventId": "evt_01KXG04MQS04ZGVY0F259874Z3",
@@ -234,6 +235,7 @@
               "tier": "essential"
             },
             {
+              "definerKnob": "toggleEvent",
               "description": "Declarative toggle event — emits UI:{toggleEvent} with { itemId, isOpen }",
               "event": "@config.toggleEvent",
               "eventId": "evt_01KXG04MQSYWVXRGAMYED6TJQ1",

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

@@ -172,28 +172,18 @@
           },
           "emits": [
             {
+              "definerKnob": "onDismiss",
               "description": "onDismiss prop",
               "event": "@config.onDismiss",
               "eventId": "evt_01KXG04MT49Q31KWA8NFE3KD3B",
-              "payloadSchema": [
-                {
-                  "name": "id",
-                  "type": "string"
-                }
-              ],
               "scope": "external",
               "tier": "essential"
             },
             {
+              "definerKnob": "onClose",
               "description": "onClose prop",
               "event": "@config.onClose",
               "eventId": "evt_01KXG04MT4Y1VCZFCN1GEKJQ7G",
-              "payloadSchema": [
-                {
-                  "name": "id",
-                  "type": "string"
-                }
-              ],
               "scope": "external",
               "tier": "essential"
             }
@@ -223,12 +213,6 @@
                 "id": "evt_01KXG04MT49Q31KWA8NFE3KD3B",
                 "key": "@config.onDismiss",
                 "name": "@config.on dismiss",
-                "payloadSchema": [
-                  {
-                    "name": "id",
-                    "type": "string"
-                  }
-                ],
                 "tier": "essential"
               },
               {
@@ -236,12 +220,6 @@
                 "id": "evt_01KXG04MT4Y1VCZFCN1GEKJQ7G",
                 "key": "@config.onClose",
                 "name": "@config.on close",
-                "payloadSchema": [
-                  {
-                    "name": "id",
-                    "type": "string"
-                  }
-                ],
                 "tier": "essential"
               }
             ],

package/behaviors/registry/ui/core/molecules/ui-branching-logic-builder.orb

@@ -233,13 +233,14 @@
           },
           "emits": [
             {
+              "definerKnob": "onRulesChange",
               "description": "onRulesChange prop",
               "event": "@config.onRulesChange",
               "eventId": "evt_01KXG04MW60PDXJ66CPBENGY37",
               "payloadSchema": [
                 {
                   "name": "rules",
-                  "type": "[object]"
+                  "type": "[BranchingLogicBuilderRULESCHANGERulesItem]"
                 }
               ],
               "scope": "external",
@@ -274,7 +275,7 @@
                 "payloadSchema": [
                   {
                     "name": "rules",
-                    "type": "[object]"
+                    "type": "[BranchingLogicBuilderRULESCHANGERulesItem]"
                   }
                 ],
                 "tier": "essential"

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

@@ -166,13 +166,24 @@
           },
           "emits": [
             {
+              "definerKnob": "itemEvent",
               "description": "Event emitted when a non-current crumb is clicked, with payload `{ label, href, index }` — the trait handles it with `(navigate ?href)`. Without it, stack crumbs navigate directly.",
               "event": "@config.itemEvent",
               "eventId": "evt_01M0HZ7JXZT1B3WE2JVP75FDGK",
               "payloadSchema": [
                 {
-                  "name": "id",
+                  "name": "label",
+                  "required": true,
                   "type": "string"
+                },
+                {
+                  "name": "href",
+                  "type": "string"
+                },
+                {
+                  "name": "index",
+                  "required": true,
+                  "type": "number"
                 }
               ],
               "scope": "external",
@@ -206,8 +217,18 @@
                 "name": "@config.item event",
                 "payloadSchema": [
                   {
-                    "name": "id",
+                    "name": "label",
+                    "required": true,
+                    "type": "string"
+                  },
+                  {
+                    "name": "href",
                     "type": "string"
+                  },
+                  {
+                    "name": "index",
+                    "required": true,
+                    "type": "number"
                   }
                 ],
                 "tier": "essential"