@almadar/std 16.197.0 → 16.198.0

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",

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

@@ -194,39 +194,59 @@
           },
           "emits": [
             {
+              "definerKnob": "onChange",
               "description": "Direct callback emitted on every change. Stays as the Storybook / non-trait contract; trait-driven schemas should prefer the bus events below.",
               "event": "@config.onChange",
               "eventId": "evt_01KXG04RVZ44PNVJ45THJPSNB2",
               "payloadSchema": [
                 {
                   "name": "next",
-                  "type": "[object]"
+                  "type": "[string]"
                 }
               ],
               "scope": "external",
               "tier": "essential"
             },
             {
+              "definerKnob": "addEvent",
               "description": "Event emitted when a tag is added: `UI:{addEvent}` with payload `{ tag: string, value: string[] }`.",
               "event": "@config.addEvent",
               "eventId": "evt_01KXG04RVZ9BSP3RG54TG21HVK",
               "payloadSchema": [
                 {
-                  "name": "id",
+                  "name": "tag",
+                  "required": true,
                   "type": "string"
+                },
+                {
+                  "name": "value",
+                  "required": true,
+                  "type": "[string]"
                 }
               ],
               "scope": "external",
               "tier": "essential"
             },
             {
+              "definerKnob": "removeEvent",
               "description": "Event emitted when a tag is removed: `UI:{removeEvent}` with payload `{ tag: string, index: number, value: string[] }`.",
               "event": "@config.removeEvent",
               "eventId": "evt_01KXG04RVZFAATZBQFTDSM5DH8",
               "payloadSchema": [
                 {
-                  "name": "id",
+                  "name": "tag",
+                  "required": true,
                   "type": "string"
+                },
+                {
+                  "name": "index",
+                  "required": true,
+                  "type": "number"
+                },
+                {
+                  "name": "value",
+                  "required": true,
+                  "type": "[string]"
                 }
               ],
               "scope": "external",
@@ -261,7 +281,7 @@
                 "payloadSchema": [
                   {
                     "name": "next",
-                    "type": "[object]"
+                    "type": "[string]"
                   }
                 ],
                 "tier": "essential"
@@ -273,8 +293,14 @@
                 "name": "@config.add event",
                 "payloadSchema": [
                   {
-                    "name": "id",
+                    "name": "tag",
+                    "required": true,
                     "type": "string"
+                  },
+                  {
+                    "name": "value",
+                    "required": true,
+                    "type": "[string]"
                   }
                 ],
                 "tier": "essential"
@@ -286,8 +312,19 @@
                 "name": "@config.remove event",
                 "payloadSchema": [
                   {
-                    "name": "id",
+                    "name": "tag",
+                    "required": true,
                     "type": "string"
+                  },
+                  {
+                    "name": "index",
+                    "required": true,
+                    "type": "number"
+                  },
+                  {
+                    "name": "value",
+                    "required": true,
+                    "type": "[string]"
                   }
                 ],
                 "tier": "essential"

package/behaviors/registry/ui/core/molecules/ui-upload-drop-zone.orb

@@ -103,11 +103,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",
@@ -156,13 +155,15 @@
           },
           "emits": [
             {
+              "definerKnob": "action",
               "description": "Declarative event name for file selection",
               "event": "@config.action",
               "eventId": "evt_01KXG04RYFM7PEKW0AYVYFZ7YW",
               "payloadSchema": [
                 {
-                  "name": "id",
-                  "type": "string"
+                  "name": "files",
+                  "required": true,
+                  "type": "[UploadDropZoneACTIONFilesItem]"
                 }
               ],
               "scope": "external",
@@ -196,8 +197,9 @@
                 "name": "@config.action",
                 "payloadSchema": [
                   {
-                    "name": "id",
-                    "type": "string"
+                    "name": "files",
+                    "required": true,
+                    "type": "[UploadDropZoneACTIONFilesItem]"
                   }
                 ],
                 "tier": "essential"

package/behaviors/registry/ui/core/molecules/ui-version-diff.orb

@@ -239,6 +239,7 @@
           },
           "emits": [
             {
+              "definerKnob": "onSelectBefore",
               "description": "Called when the user picks a different 'before' revision.",
               "event": "@config.onSelectBefore",
               "eventId": "evt_01KXG04S077NH486RETVYYMC9B",
@@ -252,6 +253,7 @@
               "tier": "essential"
             },
             {
+              "definerKnob": "onSelectAfter",
               "description": "Called when the user picks a different 'after' revision.",
               "event": "@config.onSelectAfter",
               "eventId": "evt_01KXG04S072EMG794E09Y930V4",
@@ -265,6 +267,7 @@
               "tier": "essential"
             },
             {
+              "definerKnob": "onRevert",
               "description": "Called when the user clicks the revert button (passes the 'before' id).",
               "event": "@config.onRevert",
               "eventId": "evt_01KXG04S074GEQ9KJWJMYDFJ2V",

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

@@ -221,19 +221,15 @@
           },
           "emits": [
             {
+              "definerKnob": "onDismiss",
               "description": "Dismiss handler",
               "event": "@config.onDismiss",
               "eventId": "evt_01KXG04S1PGK47ZW75Y1GVXWAC",
-              "payloadSchema": [
-                {
-                  "name": "id",
-                  "type": "string"
-                }
-              ],
               "scope": "external",
               "tier": "essential"
             },
             {
+              "definerKnob": "onNavigateToField",
               "description": "Navigate to the field that caused violation",
               "event": "@config.onNavigateToField",
               "eventId": "evt_01KXG04S1PPRRQ7Q7CMPA87T27",
@@ -272,12 +268,6 @@
                 "id": "evt_01KXG04S1PGK47ZW75Y1GVXWAC",
                 "key": "@config.onDismiss",
                 "name": "@config.on dismiss",
-                "payloadSchema": [
-                  {
-                    "name": "id",
-                    "type": "string"
-                  }
-                ],
                 "tier": "essential"
               },
               {

package/behaviors/registry/ui/core/molecules/ui-vote-stack.orb

@@ -167,6 +167,7 @@
           },
           "emits": [
             {
+              "definerKnob": "onVote",
               "description": "Toggle handler. Clicking the same arrow clears (emits null).",
               "event": "@config.onVote",
               "eventId": "evt_01KXG04S35PZ6BRH0JS2PQ206X",