@almadar/std 16.235.0 → 16.237.0

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

@@ -220,6 +220,10 @@
             "variant": {
               "default": "compact",
               "type": "unknown"
+            },
+            "viewerRole": {
+              "default": "@config.viewerRole",
+              "type": "unknown"
             }
           },
           "id": "trt_01KYG176Z400JFKWZ2XPKJ4798",
@@ -241,13 +245,6 @@
         {
           "category": "interaction",
           "config": {
-            "assigneeBinding": {
-              "default": "@item.assignee",
-              "description": "Binding path for the assignee/owner slot.",
-              "label": "Assignee field binding",
-              "tier": "internal",
-              "type": "string"
-            },
             "badgeBinding": {
               "default": "@item.status",
               "description": "Binding path for the status/badge slot.",
@@ -313,11 +310,48 @@
                   ],
                   {
                     "cols": "@config.cols",
+                    "emptyDescription": "@config.emptyDescription",
+                    "emptyIcon": "@config.emptyIcon",
+                    "emptyTitle": "@config.emptyTitle",
                     "entity": "@payload.data",
                     "fields": "@config.fields",
                     "gap": "@config.gap",
                     "imageField": "@config.imageField",
-                    "itemActions": "@config.itemActions",
+                    "itemActions": [
+                      "array/filter",
+                      "@config.itemActions",
+                      [
+                        "fn",
+                        "item",
+                        [
+                          "or",
+                          [
+                            "=",
+                            [
+                              "array/len",
+                              [
+                                "object/get",
+                                "@item",
+                                "roles",
+                                []
+                              ]
+                            ],
+                            0.0
+                          ],
+                          [
+                            "array/includes",
+                            [
+                              "object/get",
+                              "@item",
+                              "roles",
+                              []
+                            ],
+                            "@config.viewerRole"
+                          ]
+                        ]
+                      ]
+                    ],
+                    "itemClickEvent": "@config.itemClickEvent",
                     "maxInlineActions": "@config.maxInlineActions",
                     "pageSize": "@config.displayPageSize",
                     "type": "data-grid"
@@ -410,6 +444,26 @@
                     "required": false,
                     "type": "string"
                   },
+                  "colorMap": {
+                    "items": {
+                      "type": "string",
+                      "values": [
+                        "default",
+                        "primary",
+                        "secondary",
+                        "success",
+                        "warning",
+                        "danger",
+                        "error",
+                        "info",
+                        "neutral",
+                        "destructive"
+                      ]
+                    },
+                    "name": "colorMap",
+                    "required": false,
+                    "type": "object"
+                  },
                   "field": {
                     "name": "field",
                     "required": false,
@@ -443,6 +497,23 @@
                     "required": true,
                     "type": "string"
                   },
+                  "labels": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "name": "labels",
+                    "required": false,
+                    "type": "object"
+                  },
+                  "variant": {
+                    "name": "variant",
+                    "required": false,
+                    "type": "string",
+                    "values": [
+                      "h3",
+                      "h4"
+                    ]
+                  },
                   "weight": {
                     "name": "weight",
                     "required": false,
@@ -527,9 +598,44 @@
                     "children": [
                       {
                         "columns": "@config.columns",
-                        "emptyMessage": "No records",
+                        "emptyDescription": "@config.emptyDescription",
+                        "emptyIcon": "@config.emptyIcon",
+                        "emptyTitle": "@config.emptyTitle",
                         "entity": "@payload.data",
-                        "itemActions": "@config.itemActions",
+                        "itemActions": [
+                          "array/filter",
+                          "@config.itemActions",
+                          [
+                            "fn",
+                            "item",
+                            [
+                              "or",
+                              [
+                                "=",
+                                [
+                                  "array/len",
+                                  [
+                                    "object/get",
+                                    "@item",
+                                    "roles",
+                                    []
+                                  ]
+                                ],
+                                0.0
+                              ],
+                              [
+                                "array/includes",
+                                [
+                                  "object/get",
+                                  "@item",
+                                  "roles",
+                                  []
+                                ],
+                                "@config.viewerRole"
+                              ]
+                            ]
+                          ]
+                        ],
                         "itemClickEvent": "@config.itemClickEvent",
                         "look": "dense",
                         "maxInlineActions": "@config.maxInlineActions",
@@ -586,10 +692,23 @@
                     "required": true,
                     "type": "string"
                   },
+                  "roles": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "name": "roles",
+                    "required": false,
+                    "type": "array"
+                  },
                   "variant": {
                     "name": "variant",
                     "required": false,
                     "type": "string"
+                  },
+                  "when": {
+                    "name": "when",
+                    "required": false,
+                    "type": "object"
                   }
                 },
                 "type": "object"
@@ -599,21 +718,127 @@
               "tier": "presentation",
               "type": "[BrowseDetailAction]"
             },
+            "detailCloseEvent": {
+              "default": "CLOSE",
+              "description": "The detailActions entry whose event matches renders as the pane's close (×) button.",
+              "label": "Which pane action closes the record?",
+              "refId": "evt_01KYG176Z4DTZ2W62WXFKKSXJV",
+              "synonyms": "close event, dismiss event, pane close",
+              "tier": "presentation",
+              "type": "event"
+            },
             "detailFields": {
               "default": [
-                "name",
-                "description",
-                "status",
-                "createdAt"
+                {
+                  "label": "Name",
+                  "name": "name",
+                  "variant": "h4"
+                },
+                {
+                  "label": "Description",
+                  "name": "description",
+                  "variant": "body"
+                },
+                {
+                  "label": "Status",
+                  "name": "status",
+                  "variant": "badge"
+                },
+                {
+                  "format": "date",
+                  "label": "Created",
+                  "name": "createdAt"
+                }
               ],
-              "description": "Field names shown in the detail panel when browseLook = master-detail; the first entry doubles as the pane title. Consumers overriding columns/fields should override this list to match their entity.",
+              "description": "Fields shown in the detail panel when browseLook = master-detail; the field declared variant h3/h4 is the pane title. Consumers overriding columns/fields should override this list to match their entity.",
               "items": {
-                "type": "string"
+                "properties": {
+                  "colorMap": {
+                    "items": {
+                      "type": "string",
+                      "values": [
+                        "default",
+                        "primary",
+                        "secondary",
+                        "success",
+                        "warning",
+                        "danger",
+                        "error",
+                        "info",
+                        "neutral",
+                        "destructive"
+                      ]
+                    },
+                    "name": "colorMap",
+                    "required": false,
+                    "type": "object"
+                  },
+                  "format": {
+                    "name": "format",
+                    "required": false,
+                    "type": "string",
+                    "values": [
+                      "date",
+                      "currency",
+                      "number",
+                      "boolean",
+                      "percent"
+                    ]
+                  },
+                  "header": {
+                    "name": "header",
+                    "required": false,
+                    "type": "string"
+                  },
+                  "icon": {
+                    "name": "icon",
+                    "required": false,
+                    "type": "string"
+                  },
+                  "key": {
+                    "name": "key",
+                    "required": false,
+                    "type": "string"
+                  },
+                  "label": {
+                    "name": "label",
+                    "required": false,
+                    "type": "string"
+                  },
+                  "labels": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "name": "labels",
+                    "required": false,
+                    "type": "object"
+                  },
+                  "name": {
+                    "name": "name",
+                    "required": true,
+                    "type": "string"
+                  },
+                  "variant": {
+                    "name": "variant",
+                    "required": false,
+                    "type": "string",
+                    "values": [
+                      "h3",
+                      "h4",
+                      "body",
+                      "caption",
+                      "badge",
+                      "small",
+                      "progress"
+                    ]
+                  }
+                },
+                "type": "object"
               },
               "label": "Which fields appear in the master-detail record pane?",
               "synonyms": "detail columns, record fields, detail pane fields",
               "tier": "presentation",
-              "type": "[string]"
+              "type": "[FieldSpec]"
             },
             "displayPageSize": {
               "default": 10.0,
@@ -623,6 +848,30 @@
               "tier": "presentation",
               "type": "number"
             },
+            "emptyDescription": {
+              "default": "",
+              "description": "What will appear here once rows exist.",
+              "label": "Empty-state description",
+              "synonyms": "empty text, no data message, empty hint",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "emptyIcon": {
+              "default": "inbox",
+              "description": "Domain icon shown when there are no rows.",
+              "label": "Empty-state icon",
+              "synonyms": "empty icon, no data icon",
+              "tier": "presentation",
+              "type": "icon"
+            },
+            "emptyTitle": {
+              "default": "",
+              "description": "Specific title shown when there are no rows (\"No orders yet\"). Left blank, a generic line shows.",
+              "label": "Empty-state title",
+              "synonyms": "empty title, no data title, empty heading",
+              "tier": "presentation",
+              "type": "string"
+            },
             "feedBodyContent": {
               "default": {
                 "children": [
@@ -683,10 +932,47 @@
                     }
                   ],
                   {
+                    "emptyDescription": "@config.emptyDescription",
+                    "emptyIcon": "@config.emptyIcon",
+                    "emptyTitle": "@config.emptyTitle",
                     "entity": "@payload.data",
                     "fields": [],
                     "gap": "md",
-                    "itemActions": "@config.itemActions",
+                    "itemActions": [
+                      "array/filter",
+                      "@config.itemActions",
+                      [
+                        "fn",
+                        "item",
+                        [
+                          "or",
+                          [
+                            "=",
+                            [
+                              "array/len",
+                              [
+                                "object/get",
+                                "@item",
+                                "roles",
+                                []
+                              ]
+                            ],
+                            0.0
+                          ],
+                          [
+                            "array/includes",
+                            [
+                              "object/get",
+                              "@item",
+                              "roles",
+                              []
+                            ],
+                            "@config.viewerRole"
+                          ]
+                        ]
+                      ]
+                    ],
+                    "itemClickEvent": "@config.itemClickEvent",
                     "renderItem": [
                       "fn",
                       "item",
@@ -808,6 +1094,26 @@
               "description": "Each entry maps one entity field to a display column with an optional label and variant.",
               "items": {
                 "properties": {
+                  "colorMap": {
+                    "items": {
+                      "type": "string",
+                      "values": [
+                        "default",
+                        "primary",
+                        "secondary",
+                        "success",
+                        "warning",
+                        "danger",
+                        "error",
+                        "info",
+                        "neutral",
+                        "destructive"
+                      ]
+                    },
+                    "name": "colorMap",
+                    "required": false,
+                    "type": "object"
+                  },
                   "format": {
                     "name": "format",
                     "required": false,
@@ -840,6 +1146,14 @@
                     "required": false,
                     "type": "string"
                   },
+                  "labels": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "name": "labels",
+                    "required": false,
+                    "type": "object"
+                  },
                   "name": {
                     "name": "name",
                     "required": true,
@@ -974,11 +1288,48 @@
                   ],
                   {
                     "className": "w-full",
+                    "emptyDescription": "@config.emptyDescription",
+                    "emptyIcon": "@config.emptyIcon",
+                    "emptyTitle": "@config.emptyTitle",
                     "entity": "@payload.data",
                     "fields": "@config.fields",
                     "gap": "lg",
                     "imageField": "@config.imageField",
-                    "itemActions": "@config.itemActions",
+                    "itemActions": [
+                      "array/filter",
+                      "@config.itemActions",
+                      [
+                        "fn",
+                        "item",
+                        [
+                          "or",
+                          [
+                            "=",
+                            [
+                              "array/len",
+                              [
+                                "object/get",
+                                "@item",
+                                "roles",
+                                []
+                              ]
+                            ],
+                            0.0
+                          ],
+                          [
+                            "array/includes",
+                            [
+                              "object/get",
+                              "@item",
+                              "roles",
+                              []
+                            ],
+                            "@config.viewerRole"
+                          ]
+                        ]
+                      ]
+                    ],
+                    "itemClickEvent": "@config.itemClickEvent",
                     "maxInlineActions": "@config.maxInlineActions",
                     "minCardWidth": 260.0,
                     "type": "data-grid"
@@ -1010,13 +1361,6 @@
               "tier": "presentation",
               "type": "string"
             },
-            "imageLabelBinding": {
-              "default": "@item.thumbnailLabel",
-              "description": "Binding path for the image-area label slot.",
-              "label": "Image label binding",
-              "tier": "internal",
-              "type": "string"
-            },
             "include": {
               "default": [],
               "description": "Entity relation field names to hydrate on fetch (e.g. a `tag : Category` field named `tag`), so grid columns can use dot-paths like tag.name. Empty = no hydration, the default.",
@@ -1069,6 +1413,14 @@
                     "required": false,
                     "type": "string"
                   },
+                  "roles": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "name": "roles",
+                    "required": false,
+                    "type": "array"
+                  },
                   "variant": {
                     "name": "variant",
                     "required": false,
@@ -1079,6 +1431,11 @@
                       "ghost",
                       "danger"
                     ]
+                  },
+                  "when": {
+                    "name": "when",
+                    "required": false,
+                    "type": "object"
                   }
                 },
                 "type": "object"
@@ -1250,8 +1607,42 @@
                   ],
                   {
                     "detail": {
-                      "actions": "@config.detailActions",
-                      "fieldNames": "@config.detailFields",
+                      "actions": [
+                        "array/filter",
+                        "@config.detailActions",
+                        [
+                          "fn",
+                          "action",
+                          [
+                            "or",
+                            [
+                              "=",
+                              [
+                                "array/len",
+                                [
+                                  "object/get",
+                                  "@action",
+                                  "roles",
+                                  []
+                                ]
+                              ],
+                              0.0
+                            ],
+                            [
+                              "array/includes",
+                              [
+                                "object/get",
+                                "@action",
+                                "roles",
+                                []
+                              ],
+                              "@config.viewerRole"
+                            ]
+                          ]
+                        ]
+                      ],
+                      "closeEvent": "@config.detailCloseEvent",
+                      "fields": "@config.detailFields",
                       "initialData": "@payload.row",
                       "showActions": true,
                       "type": "detail-panel"
@@ -1316,20 +1707,6 @@
               "tier": "presentation",
               "type": "number"
             },
-            "priceBinding": {
-              "default": "@item.price",
-              "description": "Binding path for the price/amount overlay slot.",
-              "label": "Price field binding",
-              "tier": "internal",
-              "type": "string"
-            },
-            "priorityBinding": {
-              "default": "@item.priority",
-              "description": "Binding path for the priority slot.",
-              "label": "Priority field binding",
-              "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.",
@@ -1430,9 +1807,46 @@
                   {
                     "children": [
                       {
+                        "emptyDescription": "@config.emptyDescription",
+                        "emptyIcon": "@config.emptyIcon",
+                        "emptyTitle": "@config.emptyTitle",
                         "entity": "@payload.data",
                         "fields": "@config.fields",
-                        "itemActions": "@config.itemActions",
+                        "itemActions": [
+                          "array/filter",
+                          "@config.itemActions",
+                          [
+                            "fn",
+                            "item",
+                            [
+                              "or",
+                              [
+                                "=",
+                                [
+                                  "array/len",
+                                  [
+                                    "object/get",
+                                    "@item",
+                                    "roles",
+                                    []
+                                  ]
+                                ],
+                                0.0
+                              ],
+                              [
+                                "array/includes",
+                                [
+                                  "object/get",
+                                  "@item",
+                                  "roles",
+                                  []
+                                ],
+                                "@config.viewerRole"
+                              ]
+                            ]
+                          ]
+                        ],
+                        "itemClickEvent": "@config.itemClickEvent",
                         "maxInlineActions": "@config.maxInlineActions",
                         "type": "data-list",
                         "variant": "compact"
@@ -1454,12 +1868,12 @@
               "tier": "internal",
               "type": "render-ui"
             },
-            "viewPattern": {
-              "default": "data-grid",
-              "description": "UI pattern used to render the collection. Used by the default bodyContent tree; Layer 3 variants override bodyContent directly instead and may ignore this knob.",
-              "label": "Render pattern",
-              "tier": "internal",
-              "type": "pattern"
+            "viewerRole": {
+              "default": "",
+              "description": "The signed-in viewer's role that each row action's `roles` is checked against. Bind it explicitly at the call site (e.g. `viewerRole: @user.role`) in an app whose identity carries a role; left empty, only actions with no `roles` show.",
+              "label": "Viewer's role",
+              "tier": "policy",
+              "type": "string"
             }
           },
           "effectRow": [
@@ -2578,6 +2992,14 @@
           {
             "name": "variant",
             "type": "string"
+          },
+          {
+            "name": "roles",
+            "type": "[string]"
+          },
+          {
+            "name": "when",
+            "type": "SExpr"
           }
         ],
         "ColumnSpec": [
@@ -2617,6 +3039,18 @@
           {
             "name": "icon",
             "type": "string"
+          },
+          {
+            "name": "colorMap",
+            "type": "Map<string,BadgeColor>"
+          },
+          {
+            "name": "labels",
+            "type": "Map<string,string>"
+          },
+          {
+            "name": "variant",
+            "type": "string"
           }
         ],
         "FieldSpec": [
@@ -2648,6 +3082,14 @@
           {
             "name": "header",
             "type": "string"
+          },
+          {
+            "name": "colorMap",
+            "type": "Map<string,BadgeColor>"
+          },
+          {
+            "name": "labels",
+            "type": "Map<string,string>"
           }
         ],
         "FilterSpec": [
@@ -2686,6 +3128,14 @@
           {
             "name": "icon",
             "type": "string"
+          },
+          {
+            "name": "roles",
+            "type": "[string]"
+          },
+          {
+            "name": "when",
+            "type": "SExpr"
           }
         ]
       },