@almadar/std 16.197.0 → 16.199.0

package/behaviors/registry/ui/core/molecules/ui-calendar-grid.orb

@@ -197,11 +197,10 @@
               "type": "event"
             },
             "longPressPayload": {
-              "default": {},
               "description": "Additional payload for long-press events",
               "label": "Long Press Payload",
               "tier": "presentation",
-              "type": "json"
+              "type": "@payload(longPressEvent)"
             },
             "onDayClick": {
               "default": "DAY_CLICK",
@@ -279,6 +278,7 @@
           },
           "emits": [
             {
+              "definerKnob": "onSlotClick",
               "description": "Called when a time slot is clicked",
               "event": "@config.onSlotClick",
               "eventId": "evt_01KXG04MYC6SQV30RQK7P6RP2Q",
@@ -296,6 +296,7 @@
               "tier": "essential"
             },
             {
+              "definerKnob": "onDayClick",
               "description": "Called when a day header is clicked",
               "event": "@config.onDayClick",
               "eventId": "evt_01KXG04MYCAN4CGV9B156VAT49",
@@ -309,19 +310,21 @@
               "tier": "essential"
             },
             {
+              "definerKnob": "onEventClick",
               "description": "Called when an event is clicked",
               "event": "@config.onEventClick",
               "eventId": "evt_01KXG04MYC61SJ4DH4E9S1H7V1",
               "payloadSchema": [
                 {
                   "name": "event",
-                  "type": "object"
+                  "type": "@entity"
                 }
               ],
               "scope": "external",
               "tier": "essential"
             },
             {
+              "definerKnob": "longPressEvent",
               "description": "Event emitted on long-press of a time slot: UI:{longPressEvent} with { date, time, ...longPressPayload }",
               "event": "@config.longPressEvent",
               "eventId": "evt_01KXG04MYCX4183XG2C5JESPJW",
@@ -340,28 +343,18 @@
               "tier": "essential"
             },
             {
+              "definerKnob": "swipeLeftEvent",
               "description": "Event emitted on swipe left (next week): UI:{swipeLeftEvent}",
               "event": "@config.swipeLeftEvent",
               "eventId": "evt_01KXG04MYCZGN47Z1AF4NWKFN7",
-              "payloadSchema": [
-                {
-                  "name": "id",
-                  "type": "string"
-                }
-              ],
               "scope": "external",
               "tier": "essential"
             },
             {
+              "definerKnob": "swipeRightEvent",
               "description": "Event emitted on swipe right (prev week): UI:{swipeRightEvent}",
               "event": "@config.swipeRightEvent",
               "eventId": "evt_01KXG04MYC2Z0VWVTRH20S7Y2B",
-              "payloadSchema": [
-                {
-                  "name": "id",
-                  "type": "string"
-                }
-              ],
               "scope": "external",
               "tier": "essential"
             },
@@ -452,7 +445,7 @@
                 "payloadSchema": [
                   {
                     "name": "event",
-                    "type": "object"
+                    "type": "@entity"
                   }
                 ],
                 "tier": "essential"
@@ -480,12 +473,6 @@
                 "id": "evt_01KXG04MYCZGN47Z1AF4NWKFN7",
                 "key": "@config.swipeLeftEvent",
                 "name": "@config.swipe left event",
-                "payloadSchema": [
-                  {
-                    "name": "id",
-                    "type": "string"
-                  }
-                ],
                 "tier": "essential"
               },
               {
@@ -493,12 +480,6 @@
                 "id": "evt_01KXG04MYC2Z0VWVTRH20S7Y2B",
                 "key": "@config.swipeRightEvent",
                 "name": "@config.swipe right event",
-                "payloadSchema": [
-                  {
-                    "name": "id",
-                    "type": "string"
-                  }
-                ],
                 "tier": "essential"
               }
             ],

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

@@ -113,11 +113,11 @@
               "default": [],
               "description": "Array of items to display as slides",
               "items": {
-                "type": "object"
+                "type": "opaque"
               },
               "label": "Items",
               "tier": "presentation",
-              "type": "[json]"
+              "type": "[opaque]"
             },
             "loop": {
               "default": false,
@@ -148,15 +148,15 @@
               "type": "event"
             },
             "slideChangePayload": {
-              "default": {},
               "description": "Payload to include with the slide change event",
               "label": "Slide Change Payload",
               "tier": "presentation",
-              "type": "json"
+              "type": "@payload(slideChangeEvent)"
             }
           },
           "emits": [
             {
+              "definerKnob": "slideChangeEvent",
               "description": "Declarative event name for slide change",
               "event": "@config.slideChangeEvent",
               "eventId": "evt_01KXG04MZFXV5EQ2PGB2J66RD6",

package/behaviors/registry/ui/core/molecules/ui-code-block.orb

@@ -433,6 +433,7 @@
           },
           "emits": [
             {
+              "definerKnob": "onChange",
               "description": "GAP-51: called with the new code on every keystroke when `editable === true`. Consumers should debounce + parse downstream — `CodeBlock` does not.",
               "event": "@config.onChange",
               "eventId": "evt_01KXG04N2V41DBRXK6PA5TWZZ0",

package/behaviors/registry/ui/core/molecules/ui-confirm-dialog.orb

@@ -251,28 +251,18 @@
           },
           "emits": [
             {
+              "definerKnob": "onClose",
               "description": "Callback when dialog is closed (injected by slot wrapper)",
               "event": "@config.onClose",
               "eventId": "evt_01KXG04N3V329TX80KYS58WTH8",
-              "payloadSchema": [
-                {
-                  "name": "id",
-                  "type": "string"
-                }
-              ],
               "scope": "external",
               "tier": "essential"
             },
             {
+              "definerKnob": "onConfirm",
               "description": "Callback when action is confirmed (injected by slot wrapper)",
               "event": "@config.onConfirm",
               "eventId": "evt_01KXG04N3VBGPR9X1EXKM5459K",
-              "payloadSchema": [
-                {
-                  "name": "id",
-                  "type": "string"
-                }
-              ],
               "scope": "external",
               "tier": "essential"
             },
@@ -333,12 +323,6 @@
                 "id": "evt_01KXG04N3V329TX80KYS58WTH8",
                 "key": "@config.onClose",
                 "name": "@config.on close",
-                "payloadSchema": [
-                  {
-                    "name": "id",
-                    "type": "string"
-                  }
-                ],
                 "tier": "essential"
               },
               {
@@ -346,12 +330,6 @@
                 "id": "evt_01KXG04N3VBGPR9X1EXKM5459K",
                 "key": "@config.onConfirm",
                 "name": "@config.on confirm",
-                "payloadSchema": [
-                  {
-                    "name": "id",
-                    "type": "string"
-                  }
-                ],
                 "tier": "essential"
               }
             ],

package/behaviors/registry/ui/core/molecules/ui-content-renderer.orb

@@ -181,10 +181,7 @@
                     "required": true,
                     "type": "string",
                     "values": [
-                      "markdown",
-                      "code",
-                      "orbital",
-                      "quiz"
+                      "markdown"
                     ]
                   }
                 },

package/behaviors/registry/ui/core/molecules/ui-data-grid.orb

@@ -480,28 +480,25 @@
           },
           "emits": [
             {
+              "definerKnob": "selectionEvent",
               "description": "Selection change event name (emits UI:{selectionEvent} with { selectedIds: string[] })",
               "event": "@config.selectionEvent",
               "eventId": "evt_01KXG04N8DGC8A3RER0AYS0QJM",
               "payloadSchema": [
                 {
-                  "name": "id",
-                  "type": "string"
+                  "name": "selectedIds",
+                  "required": true,
+                  "type": "[string]"
                 }
               ],
               "scope": "external",
               "tier": "essential"
             },
             {
+              "definerKnob": "loadMoreEvent",
               "description": "Event emitted when more items needed: UI:{loadMoreEvent}",
               "event": "@config.loadMoreEvent",
               "eventId": "evt_01KXG04N8D5HH49DN80YD3E4GT",
-              "payloadSchema": [
-                {
-                  "name": "id",
-                  "type": "string"
-                }
-              ],
               "scope": "external",
               "tier": "essential"
             },
@@ -512,7 +509,13 @@
               "payloadSchema": [
                 {
                   "name": "id",
+                  "required": true,
                   "type": "string"
+                },
+                {
+                  "name": "row",
+                  "required": true,
+                  "type": "@entity"
                 }
               ],
               "scope": "external",
@@ -574,8 +577,9 @@
                 "name": "@config.selection event",
                 "payloadSchema": [
                   {
-                    "name": "id",
-                    "type": "string"
+                    "name": "selectedIds",
+                    "required": true,
+                    "type": "[string]"
                   }
                 ],
                 "tier": "essential"
@@ -585,12 +589,6 @@
                 "id": "evt_01KXG04N8D5HH49DN80YD3E4GT",
                 "key": "@config.loadMoreEvent",
                 "name": "@config.load more event",
-                "payloadSchema": [
-                  {
-                    "name": "id",
-                    "type": "string"
-                  }
-                ],
                 "tier": "essential"
               },
               {
@@ -601,7 +599,13 @@
                 "payloadSchema": [
                   {
                     "name": "id",
+                    "required": true,
                     "type": "string"
+                  },
+                  {
+                    "name": "row",
+                    "required": true,
+                    "type": "@entity"
                   }
                 ],
                 "tier": "essential"

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

@@ -615,80 +615,62 @@
           },
           "emits": [
             {
+              "definerKnob": "reorderEvent",
               "description": "Event emitted on reorder: UI:{reorderEvent} with { fromIndex, toIndex }",
               "event": "@config.reorderEvent",
               "eventId": "evt_01KXG04N9M0MPJ2H0462NH6D5S",
-              "payloadSchema": [
-                {
-                  "name": "id",
-                  "type": "string"
-                }
-              ],
               "scope": "external",
               "tier": "essential"
             },
             {
+              "definerKnob": "itemClickEvent",
               "description": "When set, the whole row is clickable and emits UI:{itemClickEvent} with { id, row } (action-button clicks stopPropagation so they still win).",
               "event": "@config.itemClickEvent",
               "eventId": "evt_01KXG04N9M1SYY5TFSHW7PM4FR",
               "payloadSchema": [
                 {
                   "name": "id",
+                  "required": true,
                   "type": "string"
+                },
+                {
+                  "name": "row",
+                  "required": true,
+                  "type": "@entity"
                 }
               ],
               "scope": "external",
               "tier": "essential"
             },
             {
+              "definerKnob": "swipeLeftEvent",
               "description": "Event emitted on left swipe: UI:{swipeLeftEvent} with { row }",
               "event": "@config.swipeLeftEvent",
               "eventId": "evt_01KXG04N9MM59JGGTT35DQYF1V",
-              "payloadSchema": [
-                {
-                  "name": "id",
-                  "type": "string"
-                }
-              ],
               "scope": "external",
               "tier": "essential"
             },
             {
+              "definerKnob": "swipeRightEvent",
               "description": "Event emitted on right swipe: UI:{swipeRightEvent} with { row }",
               "event": "@config.swipeRightEvent",
               "eventId": "evt_01KXG04N9M3WMQ4EW2SRQHFXA8",
-              "payloadSchema": [
-                {
-                  "name": "id",
-                  "type": "string"
-                }
-              ],
               "scope": "external",
               "tier": "essential"
             },
             {
+              "definerKnob": "longPressEvent",
               "description": "Event emitted on long press: UI:{longPressEvent} with { row }",
               "event": "@config.longPressEvent",
               "eventId": "evt_01KXG04N9M3VXYPVP67C0XJ1EZ",
-              "payloadSchema": [
-                {
-                  "name": "id",
-                  "type": "string"
-                }
-              ],
               "scope": "external",
               "tier": "essential"
             },
             {
+              "definerKnob": "loadMoreEvent",
               "description": "Event emitted when more items needed: UI:{loadMoreEvent}",
               "event": "@config.loadMoreEvent",
               "eventId": "evt_01KXG04N9M5KBAZZ09ZPBS3ZH4",
-              "payloadSchema": [
-                {
-                  "name": "id",
-                  "type": "string"
-                }
-              ],
               "scope": "external",
               "tier": "essential"
             },
@@ -699,7 +681,13 @@
               "payloadSchema": [
                 {
                   "name": "id",
+                  "required": true,
                   "type": "string"
+                },
+                {
+                  "name": "row",
+                  "required": true,
+                  "type": "@entity"
                 }
               ],
               "scope": "external",
@@ -759,12 +747,6 @@
                 "id": "evt_01KXG04N9M0MPJ2H0462NH6D5S",
                 "key": "@config.reorderEvent",
                 "name": "@config.reorder event",
-                "payloadSchema": [
-                  {
-                    "name": "id",
-                    "type": "string"
-                  }
-                ],
                 "tier": "essential"
               },
               {
@@ -775,7 +757,13 @@
                 "payloadSchema": [
                   {
                     "name": "id",
+                    "required": true,
                     "type": "string"
+                  },
+                  {
+                    "name": "row",
+                    "required": true,
+                    "type": "@entity"
                   }
                 ],
                 "tier": "essential"
@@ -785,12 +773,6 @@
                 "id": "evt_01KXG04N9MM59JGGTT35DQYF1V",
                 "key": "@config.swipeLeftEvent",
                 "name": "@config.swipe left event",
-                "payloadSchema": [
-                  {
-                    "name": "id",
-                    "type": "string"
-                  }
-                ],
                 "tier": "essential"
               },
               {
@@ -798,12 +780,6 @@
                 "id": "evt_01KXG04N9M3WMQ4EW2SRQHFXA8",
                 "key": "@config.swipeRightEvent",
                 "name": "@config.swipe right event",
-                "payloadSchema": [
-                  {
-                    "name": "id",
-                    "type": "string"
-                  }
-                ],
                 "tier": "essential"
               },
               {
@@ -811,12 +787,6 @@
                 "id": "evt_01KXG04N9M3VXYPVP67C0XJ1EZ",
                 "key": "@config.longPressEvent",
                 "name": "@config.long press event",
-                "payloadSchema": [
-                  {
-                    "name": "id",
-                    "type": "string"
-                  }
-                ],
                 "tier": "essential"
               },
               {
@@ -824,12 +794,6 @@
                 "id": "evt_01KXG04N9M5KBAZZ09ZPBS3ZH4",
                 "key": "@config.loadMoreEvent",
                 "name": "@config.load more event",
-                "payloadSchema": [
-                  {
-                    "name": "id",
-                    "type": "string"
-                  }
-                ],
                 "tier": "essential"
               },
               {
@@ -840,7 +804,13 @@
                 "payloadSchema": [
                   {
                     "name": "id",
+                    "required": true,
                     "type": "string"
+                  },
+                  {
+                    "name": "row",
+                    "required": true,
+                    "type": "@entity"
                   }
                 ],
                 "tier": "essential"

package/behaviors/registry/ui/core/molecules/ui-date-range-picker.orb

@@ -188,6 +188,7 @@
           },
           "emits": [
             {
+              "definerKnob": "event",
               "description": "Event name emitted as `UI:{event}` with payload `{ from, to }`. Optional — when omitted, only the `onChange` callback fires.",
               "event": "@config.event",
               "eventId": "evt_01KXG04NASPVM35YDDQGMNSPXD",
@@ -207,6 +208,7 @@
               "tier": "essential"
             },
             {
+              "definerKnob": "onChange",
               "description": "Callback fired alongside the bus emit.",
               "event": "@config.onChange",
               "eventId": "evt_01KXG04NASX5BAY4MQS58XH0AP",

package/behaviors/registry/ui/core/molecules/ui-date-range-selector.orb

@@ -134,6 +134,7 @@
           },
           "emits": [
             {
+              "definerKnob": "onSelect",
               "description": "Callback when a range is selected",
               "event": "@config.onSelect",
               "eventId": "evt_01KXG04NC20FGHRSN0M627F628",

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

@@ -116,7 +116,10 @@
                   },
                   "items": {
                     "items": {
-                      "type": "object"
+                      "type": "union",
+                      "values": [
+                        "DocSidebarItemsItem"
+                      ]
                     },
                     "name": "items",
                     "required": false,
@@ -183,7 +186,48 @@
             ]
           }
         }
-      ]
+      ],
+      "types": {
+        "DocSidebarItemsItem": [
+          {
+            "name": "label",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "href",
+            "type": "string"
+          },
+          {
+            "name": "items",
+            "properties": [
+              {
+                "name": "label",
+                "required": true,
+                "type": "string"
+              },
+              {
+                "name": "href",
+                "type": "string"
+              },
+              {
+                "name": "items",
+                "properties": [],
+                "type": "[DocSidebarItemsItem]"
+              },
+              {
+                "name": "active",
+                "type": "boolean"
+              }
+            ],
+            "type": "[object]"
+          },
+          {
+            "name": "active",
+            "type": "boolean"
+          }
+        ]
+      }
     }
   ],
   "schemaVersion": 1,

package/behaviors/registry/ui/core/molecules/ui-document-details.orb

@@ -217,6 +217,7 @@
           },
           "emits": [
             {
+              "definerKnob": "metaCommitEvent",
               "description": "Emitted when a property commits: { id, patch } — patch carries the id plus the one changed field, ready for a partial persist update.",
               "event": "@config.metaCommitEvent",
               "eventId": "evt_01M13ZXC59R4VP1T1DHD262B08",
@@ -229,13 +230,14 @@
                 {
                   "name": "patch",
                   "required": true,
-                  "type": "object"
+                  "type": "Map<string,opaque>"
                 }
               ],
               "scope": "external",
               "tier": "essential"
             },
             {
+              "definerKnob": "relationEvent",
               "description": "Makes relation chips clickable: emitted with { field, id, name } when a hydrated relation value (or one row of a many-relation) is clicked — the host routes it to the linked record's own surface.",
               "event": "@config.relationEvent",
               "eventId": "evt_01M1694617Q04F1T085TTM4F8C",
@@ -322,7 +324,7 @@
                   {
                     "name": "patch",
                     "required": true,
-                    "type": "object"
+                    "type": "Map<string,opaque>"
                   }
                 ],
                 "tier": "essential"

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

@@ -284,6 +284,7 @@
           },
           "emits": [
             {
+              "definerKnob": "titleCommitEvent",
               "description": "Emitted when the title commits: { title, id }",
               "event": "@config.titleCommitEvent",
               "eventId": "evt_01M13ZXC5NZ2ZF7NK4XFSNNJ3T",
@@ -303,6 +304,7 @@
               "tier": "essential"
             },
             {
+              "definerKnob": "contentChangeEvent",
               "description": "Forwarded to the embedded RichTextEditor's autosave stream: { value }",
               "event": "@config.contentChangeEvent",
               "eventId": "evt_01M13ZXC5NM3Y5VQW65DAM1JW7",
@@ -317,6 +319,7 @@
               "tier": "essential"
             },
             {
+              "definerKnob": "editEvent",
               "description": "Emitted by the header Edit affordance and a click on the read body: { id }",
               "event": "@config.editEvent",
               "eventId": "evt_01M13ZXC5N0V3HVHF8B4GR9037",
@@ -331,6 +334,7 @@
               "tier": "essential"
             },
             {
+              "definerKnob": "doneEvent",
               "description": "Emitted by the Done button that ends the editing session: { id }",
               "event": "@config.doneEvent",
               "eventId": "evt_01M13ZXC5NHMYWEH0Q87APMFPE",