@almadar/std 16.187.0 → 16.189.0

package/behaviors/registry/ui/core/atoms/std-calendar.orb

@@ -91,6 +91,24 @@
         "parent": "trt_01KXG04FWZGZV0R5K3Q0RRAZX0",
         "renames": []
       },
+      "evt_01M11GWC97NYPT5PYRSFDMY7CH": {
+        "bakedName": "REFETCH_QUERY",
+        "curName": "REFETCH_QUERY",
+        "id": "evt_01M11GWC97NYPT5PYRSFDMY7CH",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KXG04FWZGZV0R5K3Q0RRAZX0",
+        "renames": []
+      },
+      "evt_01M11GWC97WX3DYKFKER0MKM4T": {
+        "bakedName": "REFETCH_FILTER",
+        "curName": "REFETCH_FILTER",
+        "id": "evt_01M11GWC97WX3DYKFKER0MKM4T",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KXG04FWZGZV0R5K3Q0RRAZX0",
+        "renames": []
+      },
       "orb_01KXG04FWZ393C1RSEYVW6QS6A": {
         "bakedName": "CalendarEventOrbital",
         "curName": "CalendarEventOrbital",
@@ -219,13 +237,7 @@
               "type": "string"
             },
             "agendaItemActions": {
-              "default": [
-                {
-                  "event": "SELECT_DAY",
-                  "icon": "eye",
-                  "label": "View"
-                }
-              ],
+              "default": [],
               "description": "Per-item action buttons on agenda-list rows — data-list itemActions descriptors (label/event/icon/variant). Consumers override to wire their own row actions (View/Edit/Delete) so agenda hosts never need a second table for actions.",
               "items": {
                 "properties": {
@@ -302,6 +314,59 @@
                     "justify": "between",
                     "type": "stack"
                   },
+                  [
+                    "if",
+                    "@config.bodySearch",
+                    {
+                      "children": [
+                        {
+                          "className": "w-full max-w-md",
+                          "clearable": true,
+                          "event": "REFETCH_QUERY",
+                          "placeholder": "@config.searchPlaceholder",
+                          "type": "search-input"
+                        }
+                      ],
+                      "direction": "horizontal",
+                      "gap": "sm",
+                      "type": "stack"
+                    },
+                    {
+                      "children": [],
+                      "gap": "none",
+                      "type": "stack"
+                    }
+                  ],
+                  [
+                    "if",
+                    [
+                      ">",
+                      [
+                        "array/len",
+                        "@config.filters"
+                      ],
+                      0.0
+                    ],
+                    {
+                      "children": [
+                        {
+                          "entity": "CalendarEvent",
+                          "event": "REFETCH_FILTER",
+                          "filters": "@config.filters",
+                          "look": "@config.filterBarLook",
+                          "type": "filter-group"
+                        }
+                      ],
+                      "direction": "horizontal",
+                      "gap": "sm",
+                      "type": "stack"
+                    },
+                    {
+                      "children": [],
+                      "gap": "none",
+                      "type": "stack"
+                    }
+                  ],
                   {
                     "type": "divider"
                   },
@@ -448,6 +513,59 @@
                     "justify": "between",
                     "type": "stack"
                   },
+                  [
+                    "if",
+                    "@config.bodySearch",
+                    {
+                      "children": [
+                        {
+                          "className": "w-full max-w-md",
+                          "clearable": true,
+                          "event": "REFETCH_QUERY",
+                          "placeholder": "@config.searchPlaceholder",
+                          "type": "search-input"
+                        }
+                      ],
+                      "direction": "horizontal",
+                      "gap": "sm",
+                      "type": "stack"
+                    },
+                    {
+                      "children": [],
+                      "gap": "none",
+                      "type": "stack"
+                    }
+                  ],
+                  [
+                    "if",
+                    [
+                      ">",
+                      [
+                        "array/len",
+                        "@config.filters"
+                      ],
+                      0.0
+                    ],
+                    {
+                      "children": [
+                        {
+                          "entity": "CalendarEvent",
+                          "event": "REFETCH_FILTER",
+                          "filters": "@config.filters",
+                          "look": "@config.filterBarLook",
+                          "type": "filter-group"
+                        }
+                      ],
+                      "direction": "horizontal",
+                      "gap": "sm",
+                      "type": "stack"
+                    },
+                    {
+                      "children": [],
+                      "gap": "none",
+                      "type": "stack"
+                    }
+                  ],
                   {
                     "type": "divider"
                   },
@@ -500,13 +618,7 @@
                         "variant": "badge"
                       }
                     ],
-                    "itemActions": [
-                      {
-                        "event": "SELECT_DAY",
-                        "icon": "eye",
-                        "label": "View"
-                      }
-                    ],
+                    "itemActions": "@config.agendaItemActions",
                     "look": "@config.tableLook",
                     "type": "data-list"
                   }
@@ -520,6 +632,14 @@
               "tier": "internal",
               "type": "render-ui"
             },
+            "bodySearch": {
+              "default": false,
+              "description": "Embeds a title search box in the toolbar above the calendar body (all three calendarLook trees). Defaults false: std-calendar has never had a search box, so an untouched consumer's surface is unchanged; the primary path is composing std-search beside this atom and wiring XSearch.SEARCH -> REFETCH_QUERY. Set true only for a standalone calendar with no page-level search affordance.",
+              "label": "Show the calendar's own search box?",
+              "synonyms": "inline search, calendar search, built-in search, show search, duplicate search",
+              "tier": "presentation",
+              "type": "boolean"
+            },
             "calendarLook": {
               "default": "month",
               "description": "Layer 3 body layout: default month-grid + upcoming-events list ('month'), day-grouped agenda list ('agenda-list'), or 7-column week timeline ('week-timeline').",
@@ -539,6 +659,63 @@
               "tier": "presentation",
               "type": "string"
             },
+            "filterBarLook": {
+              "default": "toolbar",
+              "description": "Visual treatment for the embedded filter bar, mirroring std-filter's own enum. Only applies when `filters` is non-empty.",
+              "label": "Filter bar look",
+              "synonyms": "filter bar style, facet style, chips, pills",
+              "tier": "presentation",
+              "type": "string",
+              "values": [
+                "toolbar",
+                "chips",
+                "pills",
+                "popover-trigger",
+                "inline-column-header"
+              ]
+            },
+            "filters": {
+              "default": [],
+              "description": "Dropdown filter facets by field, rendered as an embedded filter bar above the calendar body (all three calendarLook trees); each selection fires REFETCH_FILTER on this trait. Empty (the default) = no filter bar, which is the right setting whenever the page already composes std-filter beside this calendar and routes XFilter.FILTER -> REFETCH_FILTER — that is the wired owner and remains the primary path. Use this knob only for a standalone calendar with no page-level filter affordance.",
+              "items": {
+                "properties": {
+                  "field": {
+                    "name": "field",
+                    "required": true,
+                    "type": "string"
+                  },
+                  "label": {
+                    "name": "label",
+                    "required": false,
+                    "type": "string"
+                  },
+                  "options": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "name": "options",
+                    "required": false,
+                    "type": "array"
+                  }
+                },
+                "type": "object"
+              },
+              "label": "Which filters should appear above the calendar?",
+              "synonyms": "filter bar, faceted filters, field filters, dropdowns",
+              "tier": "presentation",
+              "type": "[FilterSpec]"
+            },
+            "include": {
+              "default": [],
+              "description": "Entity relation field names to hydrate on fetch (e.g. a `category : Category` field named `category`), so chip bindings can use dot-paths like @item.category.name. Empty = no hydration, the default.",
+              "items": {
+                "type": "string"
+              },
+              "label": "Which relation fields to hydrate?",
+              "synonyms": "relation hydration, populate relations, joined fields, hydrate relations",
+              "tier": "internal",
+              "type": "[string]"
+            },
             "onEventClick": {
               "default": "",
               "description": "Event emitted when a calendar chip is clicked: UI:{onEventClick} with { event } carrying the clicked row. Empty means chips are not clickable.",
@@ -547,6 +724,14 @@
               "tier": "presentation",
               "type": "string"
             },
+            "searchPlaceholder": {
+              "default": "Search…",
+              "description": "Hint text inside the calendar's search box (e.g. 'Search events…').",
+              "label": "Search box placeholder text",
+              "synonyms": "search hint, placeholder, search box text, search label",
+              "tier": "presentation",
+              "type": "string"
+            },
             "startField": {
               "default": "date",
               "description": "Row column holding the timestamp the calendar grid places each chip by. Rebound hosts point this at their own column (e.g. startTime, startsAt, dueAt); the chip's LABEL comes from titleBinding, not from here.",
@@ -656,6 +841,59 @@
                     "justify": "between",
                     "type": "stack"
                   },
+                  [
+                    "if",
+                    "@config.bodySearch",
+                    {
+                      "children": [
+                        {
+                          "className": "w-full max-w-md",
+                          "clearable": true,
+                          "event": "REFETCH_QUERY",
+                          "placeholder": "@config.searchPlaceholder",
+                          "type": "search-input"
+                        }
+                      ],
+                      "direction": "horizontal",
+                      "gap": "sm",
+                      "type": "stack"
+                    },
+                    {
+                      "children": [],
+                      "gap": "none",
+                      "type": "stack"
+                    }
+                  ],
+                  [
+                    "if",
+                    [
+                      ">",
+                      [
+                        "array/len",
+                        "@config.filters"
+                      ],
+                      0.0
+                    ],
+                    {
+                      "children": [
+                        {
+                          "entity": "CalendarEvent",
+                          "event": "REFETCH_FILTER",
+                          "filters": "@config.filters",
+                          "look": "@config.filterBarLook",
+                          "type": "filter-group"
+                        }
+                      ],
+                      "direction": "horizontal",
+                      "gap": "sm",
+                      "type": "stack"
+                    },
+                    {
+                      "children": [],
+                      "gap": "none",
+                      "type": "stack"
+                    }
+                  ],
                   {
                     "type": "divider"
                   },
@@ -724,13 +962,21 @@
               "tier": "internal"
             },
             {
-              "description": "Emitted when a calendar chip is clicked: UI:{onEventClick} with { event } carrying the clicked row.",
+              "description": "Emitted when a calendar chip is clicked ({ event } carries the clicked row) or an agenda/upcoming row action fires ({ id, row }). Consumers routing it should read the row from ?event or ?row, whichever the payload carries.",
               "event": "@config.onEventClick",
               "eventId": "evt_01KYBV098PMR56F9NQ5CWWPX36",
               "payloadSchema": [
                 {
                   "name": "event",
-                  "type": "object"
+                  "type": "@entity"
+                },
+                {
+                  "name": "id",
+                  "type": "string"
+                },
+                {
+                  "name": "row",
+                  "type": "@entity"
                 }
               ],
               "scope": "external",
@@ -823,20 +1069,63 @@
                 "synonyms": "next week, forward a week, later week, following week",
                 "tier": "domain"
               },
+              {
+                "description": "Triggers a data refresh based on the current query.",
+                "id": "evt_01M11GWC97NYPT5PYRSFDMY7CH",
+                "key": "REFETCH_QUERY",
+                "name": "Refetch Query",
+                "payloadSchema": [
+                  {
+                    "name": "searchTerm",
+                    "required": true,
+                    "type": "string"
+                  }
+                ],
+                "synonyms": "refresh, reload, update, re-query",
+                "tier": "domain"
+              },
+              {
+                "description": "Triggers a data refresh based on current filter criteria.",
+                "id": "evt_01M11GWC97WX3DYKFKER0MKM4T",
+                "key": "REFETCH_FILTER",
+                "name": "Refetch Filter",
+                "payloadSchema": [
+                  {
+                    "name": "field",
+                    "required": true,
+                    "type": "string"
+                  },
+                  {
+                    "name": "value",
+                    "required": true,
+                    "type": "string"
+                  }
+                ],
+                "synonyms": "refresh, filter, update, reload",
+                "tier": "domain"
+              },
               {
                 "id": "evt_01KYXKERV560CXHYS3TRXBVM92",
                 "key": "RETRY",
                 "name": "Retry"
               },
               {
-                "description": "Emitted when a calendar chip is clicked: UI:{onEventClick} with { event } carrying the clicked row.",
+                "description": "Emitted when a calendar chip is clicked ({ event } carries the clicked row) or an agenda/upcoming row action fires ({ id, row }). Consumers routing it should read the row from ?event or ?row, whichever the payload carries.",
                 "id": "evt_01KYBV098PMR56F9NQ5CWWPX36",
                 "key": "@config.onEventClick",
                 "name": "@config.on event click",
                 "payloadSchema": [
                   {
                     "name": "event",
-                    "type": "object"
+                    "type": "@entity"
+                  },
+                  {
+                    "name": "id",
+                    "type": "string"
+                  },
+                  {
+                    "name": "row",
+                    "type": "@entity"
                   }
                 ],
                 "tier": "presentation"
@@ -886,7 +1175,8 @@
                       "emit": {
                         "failure": "CalendarEventLoadFailed",
                         "success": "CalendarEventLoaded"
-                      }
+                      },
+                      "include": "@config.include"
                     }
                   ],
                   [
@@ -1009,7 +1299,8 @@
                       "emit": {
                         "failure": "CalendarEventLoadFailed",
                         "success": "CalendarEventLoaded"
-                      }
+                      },
+                      "include": "@config.include"
                     }
                   ],
                   [
@@ -1106,7 +1397,8 @@
                             ]
                           ]
                         ]
-                      ]
+                      ],
+                      "include": "@config.include"
                     }
                   ]
                 ],
@@ -1134,7 +1426,8 @@
                       "emit": {
                         "failure": "CalendarEventLoadFailed",
                         "success": "CalendarEventLoaded"
-                      }
+                      },
+                      "include": "@config.include"
                     }
                   ]
                 ],
@@ -1162,7 +1455,8 @@
                       "emit": {
                         "failure": "CalendarEventLoadFailed",
                         "success": "CalendarEventLoaded"
-                      }
+                      },
+                      "include": "@config.include"
                     }
                   ]
                 ],
@@ -1180,7 +1474,80 @@
                       "emit": {
                         "failure": "CalendarEventLoadFailed",
                         "success": "CalendarEventLoaded"
-                      }
+                      },
+                      "filter": [
+                        "or",
+                        [
+                          "=",
+                          "@payload.searchTerm",
+                          ""
+                        ],
+                        [
+                          "str/includes",
+                          [
+                            "object/get",
+                            "@entity",
+                            "name"
+                          ],
+                          "@payload.searchTerm"
+                        ]
+                      ],
+                      "include": "@config.include"
+                    }
+                  ]
+                ],
+                "event": "REFETCH_QUERY",
+                "eventId": "evt_01M11GWC97NYPT5PYRSFDMY7CH",
+                "from": "month-view",
+                "to": "loading"
+              },
+              {
+                "effects": [
+                  [
+                    "fetch",
+                    "CalendarEvent",
+                    {
+                      "emit": {
+                        "failure": "CalendarEventLoadFailed",
+                        "success": "CalendarEventLoaded"
+                      },
+                      "filter": [
+                        "or",
+                        [
+                          "=",
+                          "@payload.value",
+                          ""
+                        ],
+                        [
+                          "=",
+                          [
+                            "object/get",
+                            "@entity",
+                            "@payload.field"
+                          ],
+                          "@payload.value"
+                        ]
+                      ],
+                      "include": "@config.include"
+                    }
+                  ]
+                ],
+                "event": "REFETCH_FILTER",
+                "eventId": "evt_01M11GWC97WX3DYKFKER0MKM4T",
+                "from": "month-view",
+                "to": "loading"
+              },
+              {
+                "effects": [
+                  [
+                    "fetch",
+                    "CalendarEvent",
+                    {
+                      "emit": {
+                        "failure": "CalendarEventLoadFailed",
+                        "success": "CalendarEventLoaded"
+                      },
+                      "include": "@config.include"
                     }
                   ],
                   [
@@ -1205,7 +1572,8 @@
                       "emit": {
                         "failure": "CalendarEventLoadFailed",
                         "success": "CalendarEventLoaded"
-                      }
+                      },
+                      "include": "@config.include"
                     }
                   ],
                   [

package/behaviors/registry/ui/core/atoms/std-dashboard-grid-embedded.orb

@@ -130,7 +130,8 @@
           "linkedEntity": "DashboardGridEmbeddedData",
           "linkedEntityId": "ent_01KXG04G02KY54SX7VCED85JZR",
           "name": "SimpleGrid1",
-          "ref": "SimpleGrid.traits.SimpleGridRender"
+          "ref": "SimpleGrid.traits.SimpleGridRender",
+          "refId": "trt_01KXG04R9RWNHP9Y7B1QW8VNVR"
         },
         {
           "category": "interaction",

package/behaviors/registry/ui/core/atoms/std-esign-flow.orb

@@ -1267,7 +1267,8 @@
             }
           ],
           "name": "SignatureSessionCreate",
-          "ref": "Modal.traits.ModalRecordModal"
+          "ref": "Modal.traits.ModalRecordModal",
+          "refId": "trt_01KXG04GVS1W2103BQKJT7KZRZ"
         },
         {
           "config": {
@@ -1306,7 +1307,8 @@
             }
           ],
           "name": "SignatureSessionDelete",
-          "ref": "Confirmation.traits.ConfirmActionConfirmation"
+          "ref": "Confirmation.traits.ConfirmActionConfirmation",
+          "refId": "trt_01KXG04FYBTTTS73WNZ70BHYG3"
         },
         {
           "category": "lifecycle",

package/behaviors/registry/ui/core/atoms/std-esign-request.orb

@@ -221,7 +221,8 @@
           "linkedEntity": "ESignRequest",
           "linkedEntityId": "ent_01KXG04G5B7M3Z329MRPPNYF8T",
           "name": "TitleHeading",
-          "ref": "Typography.traits.TypographyRender"
+          "ref": "Typography.traits.TypographyRender",
+          "refId": "trt_01KXG04MN4YEZRM29MVNFTYM98"
         },
         {
           "config": {
@@ -264,7 +265,8 @@
           "linkedEntity": "ESignRequest",
           "linkedEntityId": "ent_01KXG04G5B7M3Z329MRPPNYF8T",
           "name": "RequestDataGrid",
-          "ref": "DataGrid.traits.DataGridRender"
+          "ref": "DataGrid.traits.DataGridRender",
+          "refId": "trt_01KXG04N8B3PF7M8CWQWG5WQ60"
         },
         {
           "config": {
@@ -285,7 +287,8 @@
           "linkedEntity": "ESignRequest",
           "linkedEntityId": "ent_01KXG04G5B7M3Z329MRPPNYF8T",
           "name": "ErrorAlert",
-          "ref": "Alert.traits.AlertRender"
+          "ref": "Alert.traits.AlertRender",
+          "refId": "trt_01KXG04MT125AX1BGFS3ZNGX67"
         },
         {
           "category": "interaction",