@almadar/std 16.197.0 → 16.199.0

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

@@ -202,15 +202,10 @@
           },
           "emits": [
             {
+              "definerKnob": "onClose",
               "description": "Callback when drawer should close (injected by slot wrapper)",
               "event": "@config.onClose",
               "eventId": "evt_01KXG04NNQF8X136A5E4RS94BZ",
-              "payloadSchema": [
-                {
-                  "name": "id",
-                  "type": "string"
-                }
-              ],
               "scope": "external",
               "tier": "essential"
             },
@@ -271,12 +266,6 @@
                 "id": "evt_01KXG04NNQF8X136A5E4RS94BZ",
                 "key": "@config.onClose",
                 "name": "@config.on close",
-                "payloadSchema": [
-                  {
-                    "name": "id",
-                    "type": "string"
-                  }
-                ],
                 "tier": "essential"
               }
             ],

package/behaviors/registry/ui/core/molecules/ui-emoji-picker.orb

@@ -129,12 +129,14 @@
           },
           "emits": [
             {
+              "definerKnob": "pickEvent",
               "description": "Declarative event name — picking an emoji emits UI:{pickEvent} with { emoji } via eventBus",
               "event": "@config.pickEvent",
               "eventId": "evt_01KYQH4C422XMP60F6KRA0A70N",
               "payloadSchema": [
                 {
-                  "name": "id",
+                  "name": "emoji",
+                  "required": true,
                   "type": "string"
                 }
               ],
@@ -169,7 +171,8 @@
                 "name": "@config.pick event",
                 "payloadSchema": [
                   {
-                    "name": "id",
+                    "name": "emoji",
+                    "required": true,
                     "type": "string"
                   }
                 ],

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,10 @@
                 "properties": {
                   "children": {
                     "items": {
-                      "type": "object"
+                      "type": "union",
+                      "values": [
+                        "FileTreeTreeItem"
+                      ]
                     },
                     "name": "children",
                     "required": false,
@@ -242,6 +245,7 @@
           },
           "emits": [
             {
+              "definerKnob": "onFileSelect",
               "description": "Called when a file is clicked",
               "event": "@config.onFileSelect",
               "eventId": "evt_01KXG04NVZGH7814A6YF2K5B97",
@@ -326,7 +330,88 @@
             ]
           }
         }
-      ]
+      ],
+      "types": {
+        "FileTreeItemsItem": [
+          {
+            "name": "id",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "label",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "parentId",
+            "type": "string"
+          },
+          {
+            "name": "icon",
+            "type": "string"
+          }
+        ],
+        "FileTreeTreeItem": [
+          {
+            "name": "name",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "path",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "type",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "children",
+            "properties": [
+              {
+                "name": "name",
+                "required": true,
+                "type": "string"
+              },
+              {
+                "name": "path",
+                "required": true,
+                "type": "string"
+              },
+              {
+                "name": "type",
+                "required": true,
+                "type": "string"
+              },
+              {
+                "name": "children",
+                "properties": [],
+                "type": "[FileTreeTreeItem]"
+              },
+              {
+                "name": "size",
+                "type": "number"
+              },
+              {
+                "name": "language",
+                "type": "string"
+              }
+            ],
+            "type": "[object]"
+          },
+          {
+            "name": "size",
+            "type": "number"
+          },
+          {
+            "name": "language",
+            "type": "string"
+          }
+        ]
+      }
     }
   ],
   "schemaVersion": 1,

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