@almadar/std 16.235.0 → 16.237.0

package/behaviors/registry/ui/core/atoms/std-record-detail.orb

@@ -387,6 +387,14 @@
                     "required": true,
                     "type": "string"
                   },
+                  "roles": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "name": "roles",
+                    "required": false,
+                    "type": "array"
+                  },
                   "variant": {
                     "name": "variant",
                     "required": false,
@@ -397,6 +405,11 @@
                       "ghost",
                       "danger"
                     ]
+                  },
+                  "when": {
+                    "name": "when",
+                    "required": false,
+                    "type": "object"
                   }
                 },
                 "type": "object"
@@ -425,10 +438,44 @@
               "default": {
                 "children": [
                   {
-                    "actions": "@config.actions",
-                    "entity": "@payload.data",
+                    "actions": [
+                      "array/filter",
+                      "@config.actions",
+                      [
+                        "fn",
+                        "action",
+                        [
+                          "or",
+                          [
+                            "=",
+                            [
+                              "array/len",
+                              [
+                                "object/get",
+                                "@action",
+                                "roles",
+                                []
+                              ]
+                            ],
+                            0.0
+                          ],
+                          [
+                            "array/includes",
+                            [
+                              "object/get",
+                              "@action",
+                              "roles",
+                              []
+                            ],
+                            "@config.viewerRole"
+                          ]
+                        ]
+                      ]
+                    ],
+                    "closeEvent": "@config.closeEvent",
+                    "entity": "@entity.loadedRow",
                     "fields": "@config.fields",
-                    "initialData": "@payload.data",
+                    "initialData": "@entity.loadedRow",
                     "maxInlineActions": "@config.maxInlineActions",
                     "sections": "@config.sections",
                     "showActions": "@config.showActions",
@@ -446,6 +493,14 @@
               "tier": "internal",
               "type": "render-ui"
             },
+            "closeEvent": {
+              "default": "",
+              "description": "The `actions` entry whose event matches renders as the panel's close (×) button. Empty = no close button (a routed detail page navigates back instead).",
+              "label": "Which action closes the record?",
+              "synonyms": "close event, dismiss event, close button",
+              "tier": "presentation",
+              "type": "event"
+            },
             "contentField": {
               "default": "content",
               "description": "Name of the field on the loaded record that carries the rich-text HTML body the document look renders and edits (e.g. content, body, articleText).",
@@ -478,7 +533,40 @@
             },
             "documentBodyContent": {
               "default": {
-                "actions": "@config.actions",
+                "actions": [
+                  "array/filter",
+                  "@config.actions",
+                  [
+                    "fn",
+                    "action",
+                    [
+                      "or",
+                      [
+                        "=",
+                        [
+                          "array/len",
+                          [
+                            "object/get",
+                            "@action",
+                            "roles",
+                            []
+                          ]
+                        ],
+                        0.0
+                      ],
+                      [
+                        "array/includes",
+                        [
+                          "object/get",
+                          "@action",
+                          "roles",
+                          []
+                        ],
+                        "@config.viewerRole"
+                      ]
+                    ]
+                  ]
+                ],
                 "className": "w-full",
                 "coverImage": "@entity.coverUrl",
                 "editEvent": [
@@ -510,7 +598,40 @@
             },
             "documentEditingContent": {
               "default": {
-                "actions": "@config.actions",
+                "actions": [
+                  "array/filter",
+                  "@config.actions",
+                  [
+                    "fn",
+                    "action",
+                    [
+                      "or",
+                      [
+                        "=",
+                        [
+                          "array/len",
+                          [
+                            "object/get",
+                            "@action",
+                            "roles",
+                            []
+                          ]
+                        ],
+                        0.0
+                      ],
+                      [
+                        "array/includes",
+                        [
+                          "object/get",
+                          "@action",
+                          "roles",
+                          []
+                        ],
+                        "@config.viewerRole"
+                      ]
+                    ]
+                  ]
+                ],
                 "autosaveHint": "@config.autosaveHint",
                 "className": "w-full",
                 "contentChangeEvent": "CONTENT_CHANGE",
@@ -551,15 +672,18 @@
               "default": [
                 {
                   "header": "Name",
-                  "key": "name"
+                  "key": "name",
+                  "variant": "h4"
                 },
                 {
                   "header": "Description",
-                  "key": "description"
+                  "key": "description",
+                  "variant": "body"
                 },
                 {
                   "header": "Status",
-                  "key": "status"
+                  "key": "status",
+                  "variant": "badge"
                 },
                 {
                   "format": "date",
@@ -570,6 +694,26 @@
               "description": "Each entry maps one entity field to a labelled row in the panel. Unlike a list row, a detail panel SHOULD label every field — the value stands alone here with no column header or repeated row position to name it.",
               "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,
@@ -591,6 +735,28 @@
                     "name": "key",
                     "required": true,
                     "type": "string"
+                  },
+                  "labels": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "name": "labels",
+                    "required": false,
+                    "type": "object"
+                  },
+                  "variant": {
+                    "name": "variant",
+                    "required": false,
+                    "type": "string",
+                    "values": [
+                      "h3",
+                      "h4",
+                      "body",
+                      "caption",
+                      "badge",
+                      "small",
+                      "progress"
+                    ]
                   }
                 },
                 "type": "object"
@@ -643,10 +809,44 @@
               "default": {
                 "children": [
                   {
-                    "actions": "@config.actions",
-                    "entity": "@payload.data",
+                    "actions": [
+                      "array/filter",
+                      "@config.actions",
+                      [
+                        "fn",
+                        "action",
+                        [
+                          "or",
+                          [
+                            "=",
+                            [
+                              "array/len",
+                              [
+                                "object/get",
+                                "@action",
+                                "roles",
+                                []
+                              ]
+                            ],
+                            0.0
+                          ],
+                          [
+                            "array/includes",
+                            [
+                              "object/get",
+                              "@action",
+                              "roles",
+                              []
+                            ],
+                            "@config.viewerRole"
+                          ]
+                        ]
+                      ]
+                    ],
+                    "closeEvent": "@config.closeEvent",
+                    "entity": "@entity.loadedRow",
                     "fields": "@config.fields",
-                    "initialData": "@payload.data",
+                    "initialData": "@entity.loadedRow",
                     "maxInlineActions": "@config.maxInlineActions",
                     "sections": "@config.sections",
                     "showActions": "@config.showActions",
@@ -710,10 +910,44 @@
               "default": {
                 "children": [
                   {
-                    "actions": "@config.actions",
-                    "entity": "@payload.data",
+                    "actions": [
+                      "array/filter",
+                      "@config.actions",
+                      [
+                        "fn",
+                        "action",
+                        [
+                          "or",
+                          [
+                            "=",
+                            [
+                              "array/len",
+                              [
+                                "object/get",
+                                "@action",
+                                "roles",
+                                []
+                              ]
+                            ],
+                            0.0
+                          ],
+                          [
+                            "array/includes",
+                            [
+                              "object/get",
+                              "@action",
+                              "roles",
+                              []
+                            ],
+                            "@config.viewerRole"
+                          ]
+                        ]
+                      ]
+                    ],
+                    "closeEvent": "@config.closeEvent",
+                    "entity": "@entity.loadedRow",
                     "fields": "@config.fields",
-                    "initialData": "@payload.data",
+                    "initialData": "@entity.loadedRow",
                     "maxInlineActions": "@config.maxInlineActions",
                     "sections": "@config.sections",
                     "showActions": "@config.showActions",
@@ -747,6 +981,13 @@
               "synonyms": "title field, heading field, name field, label field",
               "tier": "presentation",
               "type": "string"
+            },
+            "viewerRole": {
+              "default": "",
+              "description": "The signed-in viewer's role that each 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": [
@@ -4176,6 +4417,14 @@
           {
             "name": "variant",
             "type": "string"
+          },
+          {
+            "name": "roles",
+            "type": "[string]"
+          },
+          {
+            "name": "when",
+            "type": "SExpr"
           }
         ],
         "RecordFieldSpec": [
@@ -4191,6 +4440,18 @@
           {
             "name": "format",
             "type": "string"
+          },
+          {
+            "name": "variant",
+            "type": "string"
+          },
+          {
+            "name": "colorMap",
+            "type": "Map<string,BadgeColor>"
+          },
+          {
+            "name": "labels",
+            "type": "Map<string,string>"
           }
         ],
         "RecordSection": [

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

@@ -389,6 +389,41 @@
               "tier": "presentation",
               "type": "[string]"
             },
+            "itemActions": {
+              "default": [
+                {
+                  "event": "OPEN_EXCEPTION",
+                  "label": "Manage"
+                }
+              ],
+              "description": "Actions offered on each row; give an item `roles` to show it only to those viewer roles.",
+              "items": {
+                "properties": {
+                  "event": {
+                    "name": "event",
+                    "required": false,
+                    "type": "event"
+                  },
+                  "label": {
+                    "name": "label",
+                    "required": true,
+                    "type": "string"
+                  },
+                  "roles": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "name": "roles",
+                    "required": false,
+                    "type": "array"
+                  }
+                },
+                "type": "object"
+              },
+              "label": "Row actions",
+              "tier": "presentation",
+              "type": "[ItemAction]"
+            },
             "timelineLook": {
               "default": "vertical-spacious",
               "description": "Layer 2 visual treatment for the timeline.",
@@ -408,6 +443,13 @@
               "label": "Section title",
               "tier": "presentation",
               "type": "string"
+            },
+            "viewerRole": {
+              "default": "",
+              "description": "The signed-in viewer's role that each 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": [
@@ -1117,6 +1159,8 @@
                           "variant": "h4"
                         },
                         {
+                          "dateField": "date",
+                          "descriptionField": "description",
                           "entity": "@entity.occurrences",
                           "fields": [
                             "title",
@@ -1125,12 +1169,42 @@
                             "status"
                           ],
                           "itemActions": [
-                            {
-                              "event": "OPEN_EXCEPTION",
-                              "label": "Manage"
-                            }
+                            "array/filter",
+                            "@config.itemActions",
+                            [
+                              "fn",
+                              "action",
+                              [
+                                "or",
+                                [
+                                  "=",
+                                  [
+                                    "array/len",
+                                    [
+                                      "object/get",
+                                      "@action",
+                                      "roles",
+                                      []
+                                    ]
+                                  ],
+                                  0.0
+                                ],
+                                [
+                                  "array/includes",
+                                  [
+                                    "object/get",
+                                    "@action",
+                                    "roles",
+                                    []
+                                  ],
+                                  "@config.viewerRole"
+                                ]
+                              ]
+                            ]
                           ],
                           "look": "@config.timelineLook",
+                          "statusField": "status",
+                          "titleField": "title",
                           "type": "timeline"
                         },
                         {
@@ -1638,6 +1712,21 @@
         }
       ],
       "types": {
+        "ItemAction": [
+          {
+            "name": "label",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "event",
+            "type": "event"
+          },
+          {
+            "name": "roles",
+            "type": "[string]"
+          }
+        ],
         "ObjectSpec": [
           {
             "name": "id",