@almadar/std 16.150.0 → 16.151.0

package/behaviors/registry/ui/core/atoms/std-app-search.orb

@@ -573,6 +573,36 @@
                 "from": "idle",
                 "to": "searching"
               },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.searchTerm",
+                    ""
+                  ],
+                  [
+                    "fetch",
+                    "AppSearchTarget",
+                    {}
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "children": [
+                        "@config.idleContent"
+                      ],
+                      "direction": "vertical",
+                      "gap": "md",
+                      "type": "stack"
+                    }
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01KXG04FP6TY19Y30E3AN5K0C7",
+                "from": "searching",
+                "to": "idle"
+              },
               {
                 "effects": [
                   [
@@ -728,6 +758,36 @@
                 "from": "searching",
                 "to": "idle"
               },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.searchTerm",
+                    ""
+                  ],
+                  [
+                    "fetch",
+                    "AppSearchTarget",
+                    {}
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "children": [
+                        "@config.idleContent"
+                      ],
+                      "direction": "vertical",
+                      "gap": "md",
+                      "type": "stack"
+                    }
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01KXG04FP6TY19Y30E3AN5K0C7",
+                "from": "results",
+                "to": "idle"
+              },
               {
                 "effects": [
                   [

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

@@ -780,7 +780,7 @@
                                                 "label": "@config.cardStageBinding",
                                                 "size": "sm",
                                                 "type": "badge",
-                                                "variant": "primary"
+                                                "variant": "@col.variant"
                                               },
                                               {
                                                 "action": "OPEN_CARD",

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

@@ -562,6 +562,19 @@
               "tier": "internal",
               "type": "string"
             },
+            "detailActions": {
+              "default": [
+                {
+                  "event": "CLOSE",
+                  "label": "Close"
+                }
+              ],
+              "description": "Action buttons on the master-detail record pane (detail-panel `actions` descriptors: label/event/icon/variant). Consumers add their own record actions (Edit/Delete/…) alongside or instead of Close.",
+              "label": "Master-detail record pane actions",
+              "synonyms": "record actions, detail actions, pane actions",
+              "tier": "presentation",
+              "type": "json"
+            },
             "detailFields": {
               "default": [
                 "name",
@@ -669,6 +682,7 @@
                                       {
                                         "color": "muted",
                                         "content": "@config.metaBinding",
+                                        "format": "@config.metaFormat",
                                         "type": "typography",
                                         "variant": "caption"
                                       },
@@ -1019,15 +1033,10 @@
                   },
                   {
                     "detail": {
-                      "actions": [
-                        {
-                          "event": "CLOSE",
-                          "label": "Close"
-                        }
-                      ],
+                      "actions": "@config.detailActions",
                       "fieldNames": "@config.detailFields",
                       "initialData": "@payload.row",
-                      "showActions": false,
+                      "showActions": true,
                       "type": "detail-panel"
                     },
                     "hasSelection": true,
@@ -1063,11 +1072,25 @@
             },
             "metaBinding": {
               "default": "@item.createdAt",
-              "description": "Binding path for the secondary meta slot (timestamp / category).",
+              "description": "Binding path for the secondary meta slot (timestamp / category). Hosts binding a count or other non-date value should label it in the binding itself (e.g. (str/concat \"Vehicles: \" @item.vehicleCount)) and set metaFormat: none.",
               "label": "Meta field binding",
               "tier": "internal",
               "type": "string"
             },
+            "metaFormat": {
+              "default": "date",
+              "description": "Typography format for the feed meta slot — date by default so the createdAt binding renders human-readable instead of raw ISO; set none for non-date bindings.",
+              "label": "Meta value format",
+              "tier": "presentation",
+              "type": "string",
+              "values": [
+                "none",
+                "date",
+                "time",
+                "datetime",
+                "number"
+              ]
+            },
             "pageSize": {
               "default": 10.0,
               "description": "Records fetched from the server per page request.",
@@ -1090,6 +1113,14 @@
               "tier": "internal",
               "type": "string"
             },
+            "scopeField": {
+              "default": "",
+              "description": "Name the field on this entity that holds the viewer's id (e.g. memberId, patientId, assignee). When set, the list loads ONLY rows whose that field equals @user.id — the 'my bookings' / 'my appointments' shape. Left blank the list loads every row, which is the default. Declared, never inferred: guessing the column from its name would silently scope the wrong one.",
+              "label": "Only show records owned by the signed-in user?",
+              "synonyms": "owner field, my records, only mine, only my own, scope to user, per-user list, mine only, owned by me",
+              "tier": "policy",
+              "type": "string"
+            },
             "searchPlaceholder": {
               "default": "Search…",
               "description": "Hint text inside the list search box (e.g. 'Search orders…').",
@@ -1606,6 +1637,23 @@
                         "failure": "BrowseItemLoadFailed",
                         "success": "BrowseItemLoaded"
                       },
+                      "filter": [
+                        "or",
+                        [
+                          "=",
+                          "@config.scopeField",
+                          ""
+                        ],
+                        [
+                          "=",
+                          [
+                            "object/get",
+                            "@entity",
+                            "@config.scopeField"
+                          ],
+                          "@user.id"
+                        ]
+                      ],
                       "limit": "@config.pageSize",
                       "offset": 0.0
                     }
@@ -1730,17 +1778,26 @@
                         "failure": "BrowseItemLoadFailed",
                         "success": "BrowseItemLoaded"
                       },
+                      "filter": [
+                        "or",
+                        [
+                          "=",
+                          "@config.scopeField",
+                          ""
+                        ],
+                        [
+                          "=",
+                          [
+                            "object/get",
+                            "@entity",
+                            "@config.scopeField"
+                          ],
+                          "@user.id"
+                        ]
+                      ],
                       "limit": "@config.pageSize",
                       "offset": 0.0
                     }
-                  ],
-                  [
-                    "render-ui",
-                    "main",
-                    {
-                      "rows": 4.0,
-                      "type": "skeleton"
-                    }
                   ]
                 ],
                 "event": "INIT",
@@ -1759,20 +1816,40 @@
                         "success": "BrowseItemLoaded"
                       },
                       "filter": [
-                        "or",
+                        "and",
                         [
-                          "=",
-                          "@payload.searchTerm",
-                          ""
+                          "or",
+                          [
+                            "=",
+                            "@config.scopeField",
+                            ""
+                          ],
+                          [
+                            "=",
+                            [
+                              "object/get",
+                              "@entity",
+                              "@config.scopeField"
+                            ],
+                            "@user.id"
+                          ]
                         ],
                         [
-                          "str/includes",
+                          "or",
                           [
-                            "object/get",
-                            "@entity",
-                            "name"
+                            "=",
+                            "@payload.searchTerm",
+                            ""
                           ],
-                          "@payload.searchTerm"
+                          [
+                            "str/includes",
+                            [
+                              "object/get",
+                              "@entity",
+                              "name"
+                            ],
+                            "@payload.searchTerm"
+                          ]
                         ]
                       ],
                       "limit": "@config.pageSize",
@@ -1796,20 +1873,40 @@
                         "success": "BrowseItemLoaded"
                       },
                       "filter": [
-                        "or",
+                        "and",
                         [
-                          "=",
-                          "@payload.value",
-                          ""
+                          "or",
+                          [
+                            "=",
+                            "@config.scopeField",
+                            ""
+                          ],
+                          [
+                            "=",
+                            [
+                              "object/get",
+                              "@entity",
+                              "@config.scopeField"
+                            ],
+                            "@user.id"
+                          ]
                         ],
                         [
-                          "=",
+                          "or",
                           [
-                            "object/get",
-                            "@entity",
-                            "@payload.field"
+                            "=",
+                            "@payload.value",
+                            ""
                           ],
-                          "@payload.value"
+                          [
+                            "=",
+                            [
+                              "object/get",
+                              "@entity",
+                              "@payload.field"
+                            ],
+                            "@payload.value"
+                          ]
                         ]
                       ],
                       "limit": "@config.pageSize",
@@ -1832,6 +1929,23 @@
                         "failure": "BrowseItemLoadFailed",
                         "success": "BrowseItemLoaded"
                       },
+                      "filter": [
+                        "or",
+                        [
+                          "=",
+                          "@config.scopeField",
+                          ""
+                        ],
+                        [
+                          "=",
+                          [
+                            "object/get",
+                            "@entity",
+                            "@config.scopeField"
+                          ],
+                          "@user.id"
+                        ]
+                      ],
                       "limit": "@config.pageSize",
                       "offset": [
                         "*",
@@ -1974,6 +2088,23 @@
                         "failure": "BrowseItemLoadFailed",
                         "success": "BrowseItemLoaded"
                       },
+                      "filter": [
+                        "or",
+                        [
+                          "=",
+                          "@config.scopeField",
+                          ""
+                        ],
+                        [
+                          "=",
+                          [
+                            "object/get",
+                            "@entity",
+                            "@config.scopeField"
+                          ],
+                          "@user.id"
+                        ]
+                      ],
                       "limit": "@config.pageSize",
                       "offset": 0.0
                     }
@@ -2022,5 +2153,5 @@
     }
   ],
   "schemaVersion": 1,
-  "version": "2.3.0"
+  "version": "2.4.0"
 }

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

@@ -202,6 +202,28 @@
         {
           "category": "interaction",
           "config": {
+            "agendaGroupBy": {
+              "default": "date",
+              "description": "Row field the agenda list groups its day sections by. Rebound hosts point this at their own timestamp column (e.g. startTime, scheduledAt).",
+              "label": "Agenda group-by field",
+              "synonyms": "group field, section field, day field",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "agendaItemActions": {
+              "default": [
+                {
+                  "event": "SELECT_DAY",
+                  "icon": "eye",
+                  "label": "View"
+                }
+              ],
+              "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.",
+              "label": "Agenda item actions",
+              "synonyms": "agenda actions, row actions, event actions, list actions",
+              "tier": "presentation",
+              "type": "json"
+            },
             "agendaListBodyContent": {
               "default": {
                 "children": [
@@ -243,7 +265,8 @@
                     "entity": "@payload.data",
                     "fields": [],
                     "gap": "md",
-                    "groupBy": "date",
+                    "groupBy": "@config.agendaGroupBy",
+                    "itemActions": "@config.agendaItemActions",
                     "renderItem": [
                       "fn",
                       "item",
@@ -258,6 +281,7 @@
                                   {
                                     "color": "muted",
                                     "content": "@config.timeBinding",
+                                    "format": "time",
                                     "type": "typography",
                                     "variant": "overline"
                                   },

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

@@ -426,29 +426,27 @@
             "parties": {
               "default": [
                 {
-                  "actionDescription": "Authorize $28,500 to be held in escrow until delivery is confirmed.",
+                  "actionDescription": "Authorize the funds to be held in escrow until delivery is confirmed.",
                   "actionIcon": "credit-card",
                   "actionLabel": "Confirm payment",
-                  "actor": "Alice Chen",
-                  "description": "Funds the transaction and confirms receipt of the vehicle.",
+                  "description": "Funds the transaction and confirms receipt.",
                   "icon": "user",
                   "id": "buyer",
                   "stepLabel": "Step 1 of 2",
                   "title": "Buyer"
                 },
                 {
-                  "actionDescription": "Mark the vehicle as shipped. Funds will release after the buyer confirms receipt.",
+                  "actionDescription": "Mark the item as shipped. Funds release after the buyer confirms receipt.",
                   "actionIcon": "package",
                   "actionLabel": "Confirm shipment",
-                  "actor": "Bob's Auto Sales LLC",
-                  "description": "Ships the vehicle and uploads delivery proof.",
+                  "description": "Ships the item and uploads delivery proof.",
                   "icon": "user-check",
                   "id": "seller",
                   "stepLabel": "Step 2 of 2",
                   "title": "Seller"
                 }
               ],
-              "description": "Ordered participants with role, actor name, and required action",
+              "description": "Ordered participants with role, actor name, and required action. stepLabel entries should track the party count when overriding.",
               "items": {
                 "properties": {
                   "actionDescription": {
@@ -570,21 +568,21 @@
               "type": "string"
             },
             "transactionAmount": {
-              "default": "$28,500",
+              "default": "$0.00",
               "description": "Formatted amount held in escrow",
               "label": "Amount",
               "tier": "presentation",
               "type": "string"
             },
             "transactionReference": {
-              "default": "TXN-A8B2C-2024-001",
+              "default": "",
               "description": "External identifier shown in the summary",
               "label": "Reference",
               "tier": "presentation",
               "type": "string"
             },
             "transactionSubject": {
-              "default": "Sale of 2024 Honda CR-V",
+              "default": "Sale of item",
               "description": "Short description of what is being transacted",
               "label": "Subject",
               "tier": "presentation",

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

@@ -458,6 +458,15 @@
                   "format": "number",
                   "icon": "list",
                   "label": "Total Items",
+                  "sparklineData": [
+                    2.0,
+                    4.0,
+                    3.0,
+                    6.0,
+                    5.0,
+                    8.0,
+                    7.0
+                  ],
                   "variant": "primary"
                 },
                 {
@@ -465,6 +474,15 @@
                   "format": "number",
                   "icon": "check-circle",
                   "label": "Active",
+                  "sparklineData": [
+                    1.0,
+                    3.0,
+                    2.0,
+                    4.0,
+                    6.0,
+                    5.0,
+                    7.0
+                  ],
                   "variant": "success"
                 },
                 {
@@ -473,6 +491,15 @@
                   "format": "number",
                   "icon": "trending-up",
                   "label": "Avg Value",
+                  "sparklineData": [
+                    5.0,
+                    4.0,
+                    6.0,
+                    3.0,
+                    5.0,
+                    7.0,
+                    6.0
+                  ],
                   "variant": "info"
                 }
               ],

package/behaviors/registry/ui/core/atoms/ui-typography.orb

@@ -126,8 +126,23 @@
               "tier": "presentation",
               "type": "node"
             },
+            "format": {
+              "default": "none",
+              "description": "Value formatting applied to string/number/Date content — `none` (the default) renders content as-is. Covers the raw-ISO-date class: a bound datetime renders human-readable via `format='date'|'time'|'datetime'`.",
+              "label": "Format",
+              "tier": "presentation",
+              "type": "string",
+              "values": [
+                "none",
+                "date",
+                "time",
+                "datetime",
+                "number",
+                "currency",
+                "percent"
+              ]
+            },
             "level": {
-              "default": 1.0,
               "description": "Heading level (1-6) - alternative to variant for headings",
               "label": "Level",
               "tier": "presentation",
@@ -258,6 +273,7 @@
                       "className": "@config.className",
                       "color": "@config.color",
                       "content": "@config.content",
+                      "format": "@config.format",
                       "level": "@config.level",
                       "overflow": "@config.overflow",
                       "size": "@config.size",

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

@@ -129,7 +129,6 @@
               "type": "string"
             },
             "cols": {
-              "default": 1.0,
               "description": "Number of columns (uses auto-fit if omitted)",
               "label": "Cols",
               "tier": "presentation",
@@ -350,8 +349,46 @@
             },
             "itemActions": {
               "default": [],
+              "description": "Per-item action buttons",
+              "items": {
+                "properties": {
+                  "event": {
+                    "name": "event",
+                    "required": false,
+                    "type": "string"
+                  },
+                  "icon": {
+                    "name": "icon",
+                    "required": false,
+                    "type": "string"
+                  },
+                  "label": {
+                    "name": "label",
+                    "required": true,
+                    "type": "string"
+                  },
+                  "navigatesTo": {
+                    "name": "navigatesTo",
+                    "required": false,
+                    "type": "string"
+                  },
+                  "variant": {
+                    "name": "variant",
+                    "required": false,
+                    "type": "string",
+                    "values": [
+                      "primary",
+                      "secondary",
+                      "ghost",
+                      "danger"
+                    ]
+                  }
+                },
+                "type": "object"
+              },
+              "label": "Item Actions",
               "tier": "presentation",
-              "type": "json"
+              "type": "[DataGridItemActionsItem]"
             },
             "loadMoreEvent": {
               "default": "LOAD_MORE",