@almadar/std 16.197.0 → 16.198.0

package/behaviors/registry/ui/core/molecules/ui-empty-state.orb

@@ -175,15 +175,10 @@
           },
           "emits": [
             {
+              "definerKnob": "onAction",
               "description": "onAction prop",
               "event": "@config.onAction",
               "eventId": "evt_01KXG04NQXY843Q2GNATHYBEZ9",
-              "payloadSchema": [
-                {
-                  "name": "id",
-                  "type": "string"
-                }
-              ],
               "scope": "external",
               "tier": "essential"
             }
@@ -213,12 +208,6 @@
                 "id": "evt_01KXG04NQXY843Q2GNATHYBEZ9",
                 "key": "@config.onAction",
                 "name": "@config.on action",
-                "payloadSchema": [
-                  {
-                    "name": "id",
-                    "type": "string"
-                  }
-                ],
                 "tier": "essential"
               }
             ],

package/behaviors/registry/ui/core/molecules/ui-error-state.orb

@@ -130,15 +130,10 @@
           },
           "emits": [
             {
+              "definerKnob": "onRetry",
               "description": "onRetry prop",
               "event": "@config.onRetry",
               "eventId": "evt_01KXG04NSZ9ZK10QAMT8J7RNN9",
-              "payloadSchema": [
-                {
-                  "name": "id",
-                  "type": "string"
-                }
-              ],
               "scope": "external",
               "tier": "essential"
             }
@@ -168,12 +163,6 @@
                 "id": "evt_01KXG04NSZ9ZK10QAMT8J7RNN9",
                 "key": "@config.onRetry",
                 "name": "@config.on retry",
-                "payloadSchema": [
-                  {
-                    "name": "id",
-                    "type": "string"
-                  }
-                ],
                 "tier": "essential"
               }
             ],

package/behaviors/registry/ui/core/molecules/ui-file-tree.orb

@@ -197,7 +197,7 @@
                 "properties": {
                   "children": {
                     "items": {
-                      "type": "object"
+                      "type": "opaque"
                     },
                     "name": "children",
                     "required": false,
@@ -242,6 +242,7 @@
           },
           "emits": [
             {
+              "definerKnob": "onFileSelect",
               "description": "Called when a file is clicked",
               "event": "@config.onFileSelect",
               "eventId": "evt_01KXG04NVZGH7814A6YF2K5B97",

package/behaviors/registry/ui/core/molecules/ui-filter-group.orb

@@ -55,6 +55,24 @@
         "parent": "trt_01KXG04NWZX79JYS9DQRRJSY6D",
         "renames": []
       },
+      "evt_01M1CHY51TCN1E24KMEX670MQ7": {
+        "bakedName": "CLEAR",
+        "curName": "CLEAR",
+        "id": "evt_01M1CHY51TCN1E24KMEX670MQ7",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KXG04NWZX79JYS9DQRRJSY6D",
+        "renames": []
+      },
+      "evt_01M1CHY51TDX4RV6N36X3M5EAP": {
+        "bakedName": "EVENT",
+        "curName": "EVENT",
+        "id": "evt_01M1CHY51TDX4RV6N36X3M5EAP",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KXG04NWZX79JYS9DQRRJSY6D",
+        "renames": []
+      },
       "orb_01KXG04NWZHMEEFXA8JY1SW36Z": {
         "bakedName": "FilterGroupOrbital",
         "curName": "FilterGroupOrbital",
@@ -91,6 +109,10 @@
             "name": "id",
             "required": true,
             "type": "string"
+          },
+          {
+            "name": "query",
+            "type": "string"
           }
         ],
         "id": "ent_01KXG04NWZS9BZRCJ1BJNGSYF5",
@@ -303,6 +325,7 @@
           },
           "emits": [
             {
+              "definerKnob": "onFilterChange",
               "description": "Callback when a filter changes - for EntityStore integration",
               "event": "@config.onFilterChange",
               "eventId": "evt_01KXG04NX201G8CA9JSP9DTETG",
@@ -320,25 +343,36 @@
               "tier": "essential"
             },
             {
+              "definerKnob": "onClearAll",
               "description": "Callback to clear all filters",
               "event": "@config.onClearAll",
               "eventId": "evt_01KXG04NX2E2M6WQ90755C1W1P",
-              "payloadSchema": [
-                {
-                  "name": "id",
-                  "type": "string"
-                }
-              ],
               "scope": "external",
               "tier": "essential"
             },
             {
+              "definerKnob": "event",
               "description": "Declarative filter event — emits UI:{event} via eventBus on filter change (alongside canonical UI:FILTER)",
               "event": "@config.event",
               "eventId": "evt_01KYC06RDGC5AX8D3JVW30MTNT",
               "payloadSchema": [
                 {
-                  "name": "id",
+                  "name": "entity",
+                  "required": true,
+                  "type": "string"
+                },
+                {
+                  "name": "field",
+                  "required": true,
+                  "type": "string"
+                },
+                {
+                  "name": "value",
+                  "required": true,
+                  "type": "string"
+                },
+                {
+                  "name": "query",
                   "type": "string"
                 }
               ],
@@ -346,12 +380,18 @@
               "tier": "essential"
             },
             {
+              "definerKnob": "clearEvent",
               "description": "Declarative clear event — emits UI:{clearEvent} via eventBus on clear-all (alongside canonical UI:CLEAR_FILTERS)",
               "event": "@config.clearEvent",
               "eventId": "evt_01KYC06RDGJEVGWBTWQKHSHA5J",
               "payloadSchema": [
                 {
-                  "name": "id",
+                  "name": "entity",
+                  "required": true,
+                  "type": "string"
+                },
+                {
+                  "name": "query",
                   "type": "string"
                 }
               ],
@@ -360,7 +400,9 @@
             }
           ],
           "entityContract": {
-            "provides": [],
+            "provides": [
+              "query"
+            ],
             "requires": []
           },
           "entityRebindable": true,
@@ -379,6 +421,48 @@
                 "key": "INIT",
                 "name": "Initialize"
               },
+              {
+                "id": "evt_01M1CHY51TDX4RV6N36X3M5EAP",
+                "key": "EVENT",
+                "name": "Event",
+                "payloadSchema": [
+                  {
+                    "name": "entity",
+                    "required": true,
+                    "type": "string"
+                  },
+                  {
+                    "name": "field",
+                    "required": true,
+                    "type": "string"
+                  },
+                  {
+                    "name": "value",
+                    "required": true,
+                    "type": "string"
+                  },
+                  {
+                    "name": "query",
+                    "type": "string"
+                  }
+                ]
+              },
+              {
+                "id": "evt_01M1CHY51TCN1E24KMEX670MQ7",
+                "key": "CLEAR",
+                "name": "Clear",
+                "payloadSchema": [
+                  {
+                    "name": "entity",
+                    "required": true,
+                    "type": "string"
+                  },
+                  {
+                    "name": "query",
+                    "type": "string"
+                  }
+                ]
+              },
               {
                 "description": "Callback when a filter changes - for EntityStore integration",
                 "id": "evt_01KXG04NX201G8CA9JSP9DTETG",
@@ -401,12 +485,6 @@
                 "id": "evt_01KXG04NX2E2M6WQ90755C1W1P",
                 "key": "@config.onClearAll",
                 "name": "@config.on clear all",
-                "payloadSchema": [
-                  {
-                    "name": "id",
-                    "type": "string"
-                  }
-                ],
                 "tier": "essential"
               },
               {
@@ -416,7 +494,22 @@
                 "name": "@config.event",
                 "payloadSchema": [
                   {
-                    "name": "id",
+                    "name": "entity",
+                    "required": true,
+                    "type": "string"
+                  },
+                  {
+                    "name": "field",
+                    "required": true,
+                    "type": "string"
+                  },
+                  {
+                    "name": "value",
+                    "required": true,
+                    "type": "string"
+                  },
+                  {
+                    "name": "query",
                     "type": "string"
                   }
                 ],
@@ -429,7 +522,12 @@
                 "name": "@config.clear event",
                 "payloadSchema": [
                   {
-                    "name": "id",
+                    "name": "entity",
+                    "required": true,
+                    "type": "string"
+                  },
+                  {
+                    "name": "query",
                     "type": "string"
                   }
                 ],
@@ -450,6 +548,11 @@
                     "FilterGroupItem",
                     {}
                   ],
+                  [
+                    "set",
+                    "@entity.query",
+                    "@config.query"
+                  ],
                   [
                     "render-ui",
                     "main",
@@ -463,7 +566,7 @@
                       "look": "@config.look",
                       "onClearAll": "@config.onClearAll",
                       "onFilterChange": "@config.onFilterChange",
-                      "query": "@config.query",
+                      "query": "@entity.query",
                       "showIcon": "@config.showIcon",
                       "type": "filter-group",
                       "variant": "@config.variant"
@@ -474,6 +577,70 @@
                 "eventId": "evt_01KXG04NWZ7H3S794N1JVCNZ39",
                 "from": "idle",
                 "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.query",
+                    "@payload.query"
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "className": "@config.className",
+                      "clearEvent": "@config.clearEvent",
+                      "entity": "FilterGroupItem",
+                      "event": "@config.event",
+                      "filters": "@config.filters",
+                      "isLoading": "@config.isLoading",
+                      "look": "@config.look",
+                      "onClearAll": "@config.onClearAll",
+                      "onFilterChange": "@config.onFilterChange",
+                      "query": "@entity.query",
+                      "showIcon": "@config.showIcon",
+                      "type": "filter-group",
+                      "variant": "@config.variant"
+                    }
+                  ]
+                ],
+                "event": "EVENT",
+                "eventId": "evt_01M1CHY51TDX4RV6N36X3M5EAP",
+                "from": "idle",
+                "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.query",
+                    "@payload.query"
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "className": "@config.className",
+                      "clearEvent": "@config.clearEvent",
+                      "entity": "FilterGroupItem",
+                      "event": "@config.event",
+                      "filters": "@config.filters",
+                      "isLoading": "@config.isLoading",
+                      "look": "@config.look",
+                      "onClearAll": "@config.onClearAll",
+                      "onFilterChange": "@config.onFilterChange",
+                      "query": "@entity.query",
+                      "showIcon": "@config.showIcon",
+                      "type": "filter-group",
+                      "variant": "@config.variant"
+                    }
+                  ]
+                ],
+                "event": "CLEAR",
+                "eventId": "evt_01M1CHY51TCN1E24KMEX670MQ7",
+                "from": "idle",
+                "to": "idle"
               }
             ]
           }

package/behaviors/registry/ui/core/molecules/ui-flip-card.orb

@@ -133,15 +133,10 @@
           },
           "emits": [
             {
+              "definerKnob": "onFlip",
               "description": "Callback when the card is clicked to flip",
               "event": "@config.onFlip",
               "eventId": "evt_01KXG04P010NK0AWWS81AY8TFA",
-              "payloadSchema": [
-                {
-                  "name": "id",
-                  "type": "string"
-                }
-              ],
               "scope": "external",
               "tier": "essential"
             }
@@ -171,12 +166,6 @@
                 "id": "evt_01KXG04P010NK0AWWS81AY8TFA",
                 "key": "@config.onFlip",
                 "name": "@config.on flip",
-                "payloadSchema": [
-                  {
-                    "name": "id",
-                    "type": "string"
-                  }
-                ],
                 "tier": "essential"
               }
             ],

package/behaviors/registry/ui/core/molecules/ui-floating-action-button.orb

@@ -106,11 +106,10 @@
               "type": "event"
             },
             "actionPayload": {
-              "default": {},
               "description": "Payload to include with the dispatched action event.",
               "label": "Action Payload",
               "tier": "presentation",
-              "type": "json"
+              "type": "@payload(action)"
             },
             "actions": {
               "default": [],
@@ -213,28 +212,18 @@
           },
           "emits": [
             {
+              "definerKnob": "action",
               "description": "Declarative event name. When set, clicking the FAB emits `UI:{action}` via the event bus and (if also provided) calls `onClick`. Mirrors the Button atom's `action` prop so schemas can write `{ type: 'floating-action-button', action: 'INIT' }` uniformly.",
               "event": "@config.action",
               "eventId": "evt_01KXG04P1X5S656AM267A9K3DQ",
-              "payloadSchema": [
-                {
-                  "name": "id",
-                  "type": "string"
-                }
-              ],
               "scope": "external",
               "tier": "essential"
             },
             {
+              "definerKnob": "onClick",
               "description": "Optional direct click handler. Runs after the action emit when both are present.",
               "event": "@config.onClick",
               "eventId": "evt_01KXG04P1XFS31NSY0DMHG9T59",
-              "payloadSchema": [
-                {
-                  "name": "id",
-                  "type": "string"
-                }
-              ],
               "scope": "external",
               "tier": "essential"
             }
@@ -264,12 +253,6 @@
                 "id": "evt_01KXG04P1X5S656AM267A9K3DQ",
                 "key": "@config.action",
                 "name": "@config.action",
-                "payloadSchema": [
-                  {
-                    "name": "id",
-                    "type": "string"
-                  }
-                ],
                 "tier": "essential"
               },
               {
@@ -277,12 +260,6 @@
                 "id": "evt_01KXG04P1XFS31NSY0DMHG9T59",
                 "key": "@config.onClick",
                 "name": "@config.on click",
-                "payloadSchema": [
-                  {
-                    "name": "id",
-                    "type": "string"
-                  }
-                ],
                 "tier": "essential"
               }
             ],

package/behaviors/registry/ui/core/molecules/ui-form-section-header.orb

@@ -165,15 +165,10 @@
           },
           "emits": [
             {
+              "definerKnob": "onToggle",
               "description": "Toggle collapse handler (makes header clickable)",
               "event": "@config.onToggle",
               "eventId": "evt_01KXG04P858C292HB7TB4RSEPY",
-              "payloadSchema": [
-                {
-                  "name": "id",
-                  "type": "string"
-                }
-              ],
               "scope": "external",
               "tier": "essential"
             }
@@ -203,12 +198,6 @@
                 "id": "evt_01KXG04P858C292HB7TB4RSEPY",
                 "key": "@config.onToggle",
                 "name": "@config.on toggle",
-                "payloadSchema": [
-                  {
-                    "name": "id",
-                    "type": "string"
-                  }
-                ],
                 "tier": "essential"
               }
             ],

package/behaviors/registry/ui/core/molecules/ui-fx-overlay.orb

@@ -97,6 +97,7 @@
                 {
                   "id": "e1",
                   "message": "Unit spawned",
+                  "ttl": 1.0,
                   "type": "spawn",
                   "x": 2.0,
                   "y": 2.0
@@ -104,6 +105,7 @@
                 {
                   "id": "e2",
                   "message": "Attack landed",
+                  "ttl": 2.0,
                   "type": "effect",
                   "x": 3.0,
                   "y": 1.0

package/behaviors/registry/ui/core/molecules/ui-graph-canvas.orb

@@ -328,7 +328,10 @@
                       "kind": {
                         "name": "kind",
                         "required": true,
-                        "type": "string"
+                        "type": "string",
+                        "values": [
+                          "suggested"
+                        ]
                       },
                       "suggestionId": {
                         "name": "suggestionId",
@@ -482,6 +485,7 @@
           },
           "emits": [
             {
+              "definerKnob": "onNodeClick",
               "description": "On node click",
               "event": "@config.onNodeClick",
               "eventId": "evt_01KXG04PBEGHZRZQ03Q18VVX8P",
@@ -520,7 +524,7 @@
                         {
                           "name": "kind",
                           "required": true,
-                          "type": "json"
+                          "type": "string"
                         },
                         {
                           "name": "suggestionId",
@@ -551,6 +555,7 @@
               "tier": "essential"
             },
             {
+              "definerKnob": "onMarkClick",
               "description": "On marked-node click (suggestion/proposal target). Takes priority over onNodeClick.",
               "event": "@config.onMarkClick",
               "eventId": "evt_01KYM63CSC8HWDZZDFN1CEXFH5",
@@ -589,7 +594,7 @@
                         {
                           "name": "kind",
                           "required": true,
-                          "type": "json"
+                          "type": "string"
                         },
                         {
                           "name": "suggestionId",
@@ -615,6 +620,7 @@
               "tier": "essential"
             },
             {
+              "definerKnob": "onNodeDoubleClick",
               "description": "On node double-click (e.g. to drill in)",
               "event": "@config.onNodeDoubleClick",
               "eventId": "evt_01KXG04PBESG3WNHVVB6Z7VVD1",
@@ -653,7 +659,7 @@
                         {
                           "name": "kind",
                           "required": true,
-                          "type": "json"
+                          "type": "string"
                         },
                         {
                           "name": "suggestionId",
@@ -679,6 +685,7 @@
               "tier": "essential"
             },
             {
+              "definerKnob": "onBadgeClick",
               "description": "On node badge click (e.g. to expand a merged cluster).",
               "event": "@config.onBadgeClick",
               "eventId": "evt_01KXN8682CNR0FEQ1F5WVB6KN1",
@@ -717,7 +724,7 @@
                         {
                           "name": "kind",
                           "required": true,
-                          "type": "json"
+                          "type": "string"
                         },
                         {
                           "name": "suggestionId",
@@ -803,7 +810,7 @@
                           {
                             "name": "kind",
                             "required": true,
-                            "type": "json"
+                            "type": "string"
                           },
                           {
                             "name": "suggestionId",
@@ -872,7 +879,7 @@
                           {
                             "name": "kind",
                             "required": true,
-                            "type": "json"
+                            "type": "string"
                           },
                           {
                             "name": "suggestionId",
@@ -936,7 +943,7 @@
                           {
                             "name": "kind",
                             "required": true,
-                            "type": "json"
+                            "type": "string"
                           },
                           {
                             "name": "suggestionId",
@@ -1000,7 +1007,7 @@
                           {
                             "name": "kind",
                             "required": true,
-                            "type": "json"
+                            "type": "string"
                           },
                           {
                             "name": "suggestionId",

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

@@ -258,6 +258,7 @@
           },
           "emits": [
             {
+              "definerKnob": "onNodeClick",
               "description": "Callback when a node is clicked",
               "event": "@config.onNodeClick",
               "eventId": "evt_01KXG04PD97XNJ32MGBJV2V5Q2",
@@ -294,6 +295,7 @@
               "tier": "essential"
             },
             {
+              "definerKnob": "onNodeHover",
               "description": "Callback when a node is hovered (null on leave)",
               "event": "@config.onNodeHover",
               "eventId": "evt_01KXG04PD9XT6C19SCPZY4S8QP",