@almadar/std 16.150.0 → 16.152.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"
                                       },
@@ -902,6 +916,22 @@
               "tier": "internal",
               "type": "string"
             },
+            "initialFilterField": {
+              "default": "",
+              "description": "Name the field the INITIAL load filters on, paired with initialFilterValue. This is the detail half of a list-detail pair: a thread that must wait for a conversation to be picked sets the field to its parent key and leaves the value blank, so the first load matches nothing and the empty state shows instead of every record in the table. REFETCH_FILTER then supplies the real selection. Left blank the first load is unfiltered, which is the default.",
+              "label": "Which field does the first load filter on?",
+              "synonyms": "initial filter, first load filter, wait for selection, detail pane filter, requires selection, start empty",
+              "tier": "policy",
+              "type": "string"
+            },
+            "initialFilterValue": {
+              "default": "",
+              "description": "The value initialFilterField must equal on the first load. Blank is meaningful: it matches only records whose field is itself blank, which for a detail pane is normally none — that is how a thread stays empty until its parent is selected.",
+              "label": "What value does the first load filter for?",
+              "synonyms": "initial filter value, first load value, default selection",
+              "tier": "policy",
+              "type": "string"
+            },
             "itemActions": {
               "default": [],
               "description": "Buttons rendered on each row (e.g. Edit, Delete, View).",
@@ -1019,15 +1049,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 +1088,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 +1129,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 +1653,43 @@
                         "failure": "BrowseItemLoadFailed",
                         "success": "BrowseItemLoaded"
                       },
+                      "filter": [
+                        "and",
+                        [
+                          "or",
+                          [
+                            "=",
+                            "@config.scopeField",
+                            ""
+                          ],
+                          [
+                            "=",
+                            [
+                              "object/get",
+                              "@entity",
+                              "@config.scopeField"
+                            ],
+                            "@user.id"
+                          ]
+                        ],
+                        [
+                          "or",
+                          [
+                            "=",
+                            "@config.initialFilterField",
+                            ""
+                          ],
+                          [
+                            "=",
+                            [
+                              "object/get",
+                              "@entity",
+                              "@config.initialFilterField"
+                            ],
+                            "@config.initialFilterValue"
+                          ]
+                        ]
+                      ],
                       "limit": "@config.pageSize",
                       "offset": 0.0
                     }
@@ -1730,17 +1814,46 @@
                         "failure": "BrowseItemLoadFailed",
                         "success": "BrowseItemLoaded"
                       },
+                      "filter": [
+                        "and",
+                        [
+                          "or",
+                          [
+                            "=",
+                            "@config.scopeField",
+                            ""
+                          ],
+                          [
+                            "=",
+                            [
+                              "object/get",
+                              "@entity",
+                              "@config.scopeField"
+                            ],
+                            "@user.id"
+                          ]
+                        ],
+                        [
+                          "or",
+                          [
+                            "=",
+                            "@config.initialFilterField",
+                            ""
+                          ],
+                          [
+                            "=",
+                            [
+                              "object/get",
+                              "@entity",
+                              "@config.initialFilterField"
+                            ],
+                            "@config.initialFilterValue"
+                          ]
+                        ]
+                      ],
                       "limit": "@config.pageSize",
                       "offset": 0.0
                     }
-                  ],
-                  [
-                    "render-ui",
-                    "main",
-                    {
-                      "rows": 4.0,
-                      "type": "skeleton"
-                    }
                   ]
                 ],
                 "event": "INIT",
@@ -1759,20 +1872,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 +1929,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 +1985,23 @@
                         "failure": "BrowseItemLoadFailed",
                         "success": "BrowseItemLoaded"
                       },
+                      "filter": [
+                        "or",
+                        [
+                          "=",
+                          "@config.scopeField",
+                          ""
+                        ],
+                        [
+                          "=",
+                          [
+                            "object/get",
+                            "@entity",
+                            "@config.scopeField"
+                          ],
+                          "@user.id"
+                        ]
+                      ],
                       "limit": "@config.pageSize",
                       "offset": [
                         "*",
@@ -1974,6 +2144,43 @@
                         "failure": "BrowseItemLoadFailed",
                         "success": "BrowseItemLoaded"
                       },
+                      "filter": [
+                        "and",
+                        [
+                          "or",
+                          [
+                            "=",
+                            "@config.scopeField",
+                            ""
+                          ],
+                          [
+                            "=",
+                            [
+                              "object/get",
+                              "@entity",
+                              "@config.scopeField"
+                            ],
+                            "@user.id"
+                          ]
+                        ],
+                        [
+                          "or",
+                          [
+                            "=",
+                            "@config.initialFilterField",
+                            ""
+                          ],
+                          [
+                            "=",
+                            [
+                              "object/get",
+                              "@entity",
+                              "@config.initialFilterField"
+                            ],
+                            "@config.initialFilterValue"
+                          ]
+                        ]
+                      ],
                       "limit": "@config.pageSize",
                       "offset": 0.0
                     }
@@ -2022,5 +2229,5 @@
     }
   ],
   "schemaVersion": 1,
-  "version": "2.3.0"
+  "version": "2.5.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",