@almadar/std 16.149.0 → 16.151.0

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

@@ -264,7 +264,13 @@
                   "variant": {
                     "name": "variant",
                     "required": false,
-                    "type": "string"
+                    "type": "string",
+                    "values": [
+                      "primary",
+                      "secondary",
+                      "ghost",
+                      "danger"
+                    ]
                   }
                 },
                 "type": "object"
@@ -302,7 +308,14 @@
                   "format": {
                     "name": "format",
                     "required": false,
-                    "type": "string"
+                    "type": "string",
+                    "values": [
+                      "date",
+                      "currency",
+                      "number",
+                      "boolean",
+                      "percent"
+                    ]
                   },
                   "hidden": {
                     "name": "hidden",
@@ -324,6 +337,11 @@
                     "required": false,
                     "type": "string"
                   },
+                  "name": {
+                    "name": "name",
+                    "required": true,
+                    "type": "string"
+                  },
                   "payload": {
                     "name": "payload",
                     "required": false,
@@ -332,7 +350,16 @@
                   "variant": {
                     "name": "variant",
                     "required": false,
-                    "type": "string"
+                    "type": "string",
+                    "values": [
+                      "h3",
+                      "h4",
+                      "body",
+                      "caption",
+                      "badge",
+                      "small",
+                      "progress"
+                    ]
                   }
                 },
                 "type": "object"
@@ -546,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": [
                   [
@@ -701,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/dist/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/dist/behaviors/registry/ui/core/atoms/std-browse.orb

@@ -441,7 +441,12 @@
                   "align": {
                     "name": "align",
                     "required": false,
-                    "type": "string"
+                    "type": "string",
+                    "values": [
+                      "left",
+                      "center",
+                      "right"
+                    ]
                   },
                   "className": {
                     "name": "className",
@@ -456,7 +461,15 @@
                   "format": {
                     "name": "format",
                     "required": false,
-                    "type": "string"
+                    "type": "string",
+                    "values": [
+                      "badge",
+                      "date",
+                      "currency",
+                      "number",
+                      "percent",
+                      "boolean"
+                    ]
                   },
                   "header": {
                     "name": "header",
@@ -476,7 +489,12 @@
                   "weight": {
                     "name": "weight",
                     "required": false,
-                    "type": "string"
+                    "type": "string",
+                    "values": [
+                      "normal",
+                      "medium",
+                      "semibold"
+                    ]
                   },
                   "width": {
                     "name": "width",
@@ -544,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",
@@ -651,6 +682,7 @@
                                       {
                                         "color": "muted",
                                         "content": "@config.metaBinding",
+                                        "format": "@config.metaFormat",
                                         "type": "typography",
                                         "variant": "caption"
                                       },
@@ -724,7 +756,14 @@
                   "format": {
                     "name": "format",
                     "required": false,
-                    "type": "string"
+                    "type": "string",
+                    "values": [
+                      "date",
+                      "currency",
+                      "number",
+                      "boolean",
+                      "percent"
+                    ]
                   },
                   "header": {
                     "name": "header",
@@ -754,7 +793,16 @@
                   "variant": {
                     "name": "variant",
                     "required": false,
-                    "type": "string"
+                    "type": "string",
+                    "values": [
+                      "h3",
+                      "h4",
+                      "body",
+                      "caption",
+                      "badge",
+                      "small",
+                      "progress"
+                    ]
                   }
                 },
                 "type": "object"
@@ -896,7 +944,13 @@
                   "variant": {
                     "name": "variant",
                     "required": false,
-                    "type": "string"
+                    "type": "string",
+                    "values": [
+                      "primary",
+                      "secondary",
+                      "ghost",
+                      "danger"
+                    ]
                   }
                 },
                 "type": "object"
@@ -979,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,
@@ -1023,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.",
@@ -1050,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…').",
@@ -1566,6 +1637,23 @@
                         "failure": "BrowseItemLoadFailed",
                         "success": "BrowseItemLoaded"
                       },
+                      "filter": [
+                        "or",
+                        [
+                          "=",
+                          "@config.scopeField",
+                          ""
+                        ],
+                        [
+                          "=",
+                          [
+                            "object/get",
+                            "@entity",
+                            "@config.scopeField"
+                          ],
+                          "@user.id"
+                        ]
+                      ],
                       "limit": "@config.pageSize",
                       "offset": 0.0
                     }
@@ -1690,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",
@@ -1719,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",
@@ -1756,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",
@@ -1792,6 +1929,23 @@
                         "failure": "BrowseItemLoadFailed",
                         "success": "BrowseItemLoaded"
                       },
+                      "filter": [
+                        "or",
+                        [
+                          "=",
+                          "@config.scopeField",
+                          ""
+                        ],
+                        [
+                          "=",
+                          [
+                            "object/get",
+                            "@entity",
+                            "@config.scopeField"
+                          ],
+                          "@user.id"
+                        ]
+                      ],
                       "limit": "@config.pageSize",
                       "offset": [
                         "*",
@@ -1934,6 +2088,23 @@
                         "failure": "BrowseItemLoadFailed",
                         "success": "BrowseItemLoaded"
                       },
+                      "filter": [
+                        "or",
+                        [
+                          "=",
+                          "@config.scopeField",
+                          ""
+                        ],
+                        [
+                          "=",
+                          [
+                            "object/get",
+                            "@entity",
+                            "@config.scopeField"
+                          ],
+                          "@user.id"
+                        ]
+                      ],
                       "limit": "@config.pageSize",
                       "offset": 0.0
                     }
@@ -1982,5 +2153,5 @@
     }
   ],
   "schemaVersion": 1,
-  "version": "2.3.0"
+  "version": "2.4.0"
 }

package/dist/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/dist/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",