@almadar/std 16.235.0 → 16.237.0

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

@@ -261,6 +261,14 @@
                     "required": false,
                     "type": "string"
                   },
+                  "roles": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "name": "roles",
+                    "required": false,
+                    "type": "array"
+                  },
                   "variant": {
                     "name": "variant",
                     "required": false,
@@ -271,6 +279,11 @@
                       "ghost",
                       "danger"
                     ]
+                  },
+                  "when": {
+                    "name": "when",
+                    "required": false,
+                    "type": "object"
                   }
                 },
                 "type": "object"
@@ -376,7 +389,40 @@
                     "fields": [],
                     "gap": "md",
                     "groupBy": "@config.agendaGroupBy",
-                    "itemActions": "@config.agendaItemActions",
+                    "itemActions": [
+                      "array/filter",
+                      "@config.agendaItemActions",
+                      [
+                        "fn",
+                        "action",
+                        [
+                          "or",
+                          [
+                            "=",
+                            [
+                              "array/len",
+                              [
+                                "object/get",
+                                "@action",
+                                "roles",
+                                []
+                              ]
+                            ],
+                            0.0
+                          ],
+                          [
+                            "array/includes",
+                            [
+                              "object/get",
+                              "@action",
+                              "roles",
+                              []
+                            ],
+                            "@config.viewerRole"
+                          ]
+                        ]
+                      ]
+                    ],
                     "renderItem": [
                       "fn",
                       "item",
@@ -597,7 +643,40 @@
                   {
                     "entity": "@payload.data",
                     "fields": "@config.fields",
-                    "itemActions": "@config.agendaItemActions",
+                    "itemActions": [
+                      "array/filter",
+                      "@config.agendaItemActions",
+                      [
+                        "fn",
+                        "action",
+                        [
+                          "or",
+                          [
+                            "=",
+                            [
+                              "array/len",
+                              [
+                                "object/get",
+                                "@action",
+                                "roles",
+                                []
+                              ]
+                            ],
+                            0.0
+                          ],
+                          [
+                            "array/includes",
+                            [
+                              "object/get",
+                              "@action",
+                              "roles",
+                              []
+                            ],
+                            "@config.viewerRole"
+                          ]
+                        ]
+                      ]
+                    ],
                     "look": "@config.tableLook",
                     "type": "data-list"
                   }
@@ -839,6 +918,13 @@
               "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"
+            },
             "weekTimelineBodyContent": {
               "default": {
                 "children": [
@@ -1837,6 +1923,14 @@
           {
             "name": "icon",
             "type": "string"
+          },
+          {
+            "name": "roles",
+            "type": "[string]"
+          },
+          {
+            "name": "when",
+            "type": "SExpr"
           }
         ]
       }

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

@@ -401,6 +401,71 @@
       "traits": [
         {
           "category": "interaction",
+          "config": {
+            "itemActions": {
+              "default": [
+                {
+                  "event": "RESEND_REQUEST",
+                  "label": "Resend",
+                  "variant": "primary"
+                },
+                {
+                  "event": "REQUEST_DELETE",
+                  "label": "Cancel",
+                  "variant": "danger"
+                },
+                {
+                  "event": "CHECK_ENVELOPE_STATUS",
+                  "label": "Refresh status",
+                  "variant": "secondary"
+                }
+              ],
+              "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"
+                  },
+                  "variant": {
+                    "name": "variant",
+                    "required": false,
+                    "type": "string"
+                  },
+                  "when": {
+                    "name": "when",
+                    "required": false,
+                    "type": "object"
+                  }
+                },
+                "type": "object"
+              },
+              "label": "Row actions",
+              "tier": "presentation",
+              "type": "[ItemAction]"
+            },
+            "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": [
             {
               "kind": "fetch",
@@ -1193,21 +1258,38 @@
                             }
                           ],
                           "itemActions": [
-                            {
-                              "event": "RESEND_REQUEST",
-                              "label": "Resend",
-                              "variant": "primary"
-                            },
-                            {
-                              "event": "REQUEST_DELETE",
-                              "label": "Cancel",
-                              "variant": "danger"
-                            },
-                            {
-                              "event": "CHECK_ENVELOPE_STATUS",
-                              "label": "Refresh status",
-                              "variant": "secondary"
-                            }
+                            "array/filter",
+                            "@config.itemActions",
+                            [
+                              "fn",
+                              "action",
+                              [
+                                "or",
+                                [
+                                  "=",
+                                  [
+                                    "array/len",
+                                    [
+                                      "object/get",
+                                      "@action",
+                                      "roles",
+                                      []
+                                    ]
+                                  ],
+                                  0.0
+                                ],
+                                [
+                                  "array/includes",
+                                  [
+                                    "object/get",
+                                    "@action",
+                                    "roles",
+                                    []
+                                  ],
+                                  "@config.viewerRole"
+                                ]
+                              ]
+                            ]
                           ],
                           "type": "data-grid"
                         }
@@ -2423,6 +2505,31 @@
           }
         }
       ],
+      "types": {
+        "ItemAction": [
+          {
+            "name": "label",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "event",
+            "type": "event"
+          },
+          {
+            "name": "variant",
+            "type": "string"
+          },
+          {
+            "name": "roles",
+            "type": "[string]"
+          },
+          {
+            "name": "when",
+            "type": "SExpr"
+          }
+        ]
+      },
       "uses": [
         {
           "as": "StoredFile",

package/behaviors/registry/ui/core/atoms/std-esign-request.orb

@@ -273,6 +273,10 @@
             "look": {
               "default": "@config.tableLook",
               "type": "unknown"
+            },
+            "viewerRole": {
+              "default": "@config.viewerRole",
+              "type": "unknown"
             }
           },
           "id": "trt_01KXZ44YADY8TSA72HC2HVFCWN",
@@ -325,6 +329,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": [

package/behaviors/registry/ui/core/atoms/std-event-log.orb

@@ -412,13 +412,19 @@
                 "tile-image-first"
               ]
             },
-            "displayPageSize": {
-              "default": 20.0,
-              "description": "Page size a consumer-composed std-pagination control should use to compute total pages (e.g. from totalCount). This atom's own timeline pattern has no built-in pager UI, so this knob is informational for the composed control, not consumed by the timeline itself.",
-              "label": "How many entries per page should a pager show?",
-              "synonyms": "visible rows, items per page, display limit",
+            "dateField": {
+              "default": "date",
+              "description": "Entity field holding each event's date.",
+              "label": "Date field",
               "tier": "presentation",
-              "type": "number"
+              "type": "string"
+            },
+            "descriptionField": {
+              "default": "description",
+              "description": "Entity field holding each event's description.",
+              "label": "Description field",
+              "tier": "presentation",
+              "type": "string"
             },
             "filterBarLook": {
               "default": "toolbar",
@@ -576,6 +582,13 @@
               "tier": "presentation",
               "type": "string"
             },
+            "statusField": {
+              "default": "status",
+              "description": "Entity field holding each event's status (complete | active | pending | error).",
+              "label": "Status field",
+              "tier": "presentation",
+              "type": "string"
+            },
             "timelineLook": {
               "default": "vertical-spacious",
               "description": "Layer 2 visual treatment for the timeline.",
@@ -595,6 +608,13 @@
               "label": "Section title",
               "tier": "presentation",
               "type": "string"
+            },
+            "titleField": {
+              "default": "title",
+              "description": "Entity field holding each event's title.",
+              "label": "Title field",
+              "tier": "presentation",
+              "type": "string"
             }
           },
           "effectRow": [
@@ -1325,6 +1345,8 @@
                           "type": "tabs"
                         },
                         {
+                          "dateField": "@config.dateField",
+                          "descriptionField": "@config.descriptionField",
                           "entity": "@entity.entries",
                           "fields": [
                             "title",
@@ -1333,6 +1355,8 @@
                             "status"
                           ],
                           "look": "@config.timelineLook",
+                          "statusField": "@config.statusField",
+                          "titleField": "@config.titleField",
                           "type": "timeline"
                         }
                       ],
@@ -1561,6 +1585,8 @@
                           "type": "tabs"
                         },
                         {
+                          "dateField": "@config.dateField",
+                          "descriptionField": "@config.descriptionField",
                           "entity": "@entity.entries",
                           "fields": [
                             "title",
@@ -1569,6 +1595,8 @@
                             "status"
                           ],
                           "look": "@config.timelineLook",
+                          "statusField": "@config.statusField",
+                          "titleField": "@config.titleField",
                           "type": "timeline"
                         }
                       ],
@@ -2043,6 +2071,8 @@
                           "type": "tabs"
                         },
                         {
+                          "dateField": "@config.dateField",
+                          "descriptionField": "@config.descriptionField",
                           "entity": "@entity.entries",
                           "fields": [
                             "title",
@@ -2051,6 +2081,8 @@
                             "status"
                           ],
                           "look": "@config.timelineLook",
+                          "statusField": "@config.statusField",
+                          "titleField": "@config.titleField",
                           "type": "timeline"
                         }
                       ],
@@ -2266,6 +2298,8 @@
                           "type": "tabs"
                         },
                         {
+                          "dateField": "@config.dateField",
+                          "descriptionField": "@config.descriptionField",
                           "entity": "@entity.entries",
                           "fields": [
                             "title",
@@ -2274,6 +2308,8 @@
                             "status"
                           ],
                           "look": "@config.timelineLook",
+                          "statusField": "@config.statusField",
+                          "titleField": "@config.titleField",
                           "type": "timeline"
                         }
                       ],

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

@@ -182,14 +182,6 @@
               "tier": "presentation",
               "type": "string"
             },
-            "event": {
-              "default": "EXPORT_REQUESTED",
-              "description": "Event emitted when the user picks a format. Each entry in formats[] carries its own literal event field (no per-item templating in .lolo) — overriding this alone does not retarget the click; also set formats[].event to match.",
-              "label": "Export event",
-              "synonyms": "bus event name. internal wiring; users rarely target directly",
-              "tier": "internal",
-              "type": "string"
-            },
             "formats": {
               "default": [
                 {
@@ -246,14 +238,6 @@
               "synonyms": "list of export format entries (csv / xlsx / pdf / png / json). user phrases: 'only CSV' -> keep only csv entry; 'add JSON' -> append json entry; 'no PNG' -> remove png; 'allow X and Y' -> set the array to those two",
               "tier": "presentation",
               "type": "[FormatOption]"
-            },
-            "tileId": {
-              "default": "",
-              "description": "Identifier of the dashboard tile being exported",
-              "label": "Tile id",
-              "synonyms": "internal identifier — host orbital wires this; users rarely set it directly",
-              "tier": "internal",
-              "type": "string"
             }
           },
           "effectRow": [

package/behaviors/registry/ui/core/atoms/std-file-store.orb

@@ -237,6 +237,14 @@
                     "required": true,
                     "type": "string"
                   },
+                  "roles": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "name": "roles",
+                    "required": false,
+                    "type": "array"
+                  },
                   "variant": {
                     "name": "variant",
                     "required": false,
@@ -247,6 +255,11 @@
                       "ghost",
                       "danger"
                     ]
+                  },
+                  "when": {
+                    "name": "when",
+                    "required": false,
+                    "type": "object"
                   }
                 },
                 "type": "object"
@@ -260,7 +273,7 @@
                 {
                   "label": "Name",
                   "name": "name",
-                  "variant": "caption"
+                  "variant": "h4"
                 },
                 {
                   "label": "Folder",
@@ -278,6 +291,7 @@
                   "variant": "caption"
                 },
                 {
+                  "format": "date",
                   "label": "Uploaded",
                   "name": "uploadedAt",
                   "variant": "caption"
@@ -383,6 +397,14 @@
                     "required": true,
                     "type": "string"
                   },
+                  "roles": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "name": "roles",
+                    "required": false,
+                    "type": "array"
+                  },
                   "variant": {
                     "name": "variant",
                     "required": false,
@@ -393,6 +415,11 @@
                       "ghost",
                       "danger"
                     ]
+                  },
+                  "when": {
+                    "name": "when",
+                    "required": false,
+                    "type": "object"
                   }
                 },
                 "type": "object"
@@ -401,6 +428,15 @@
               "tier": "presentation",
               "type": "[ItemAction]"
             },
+            "itemClickEvent": {
+              "default": "OPEN_FILE",
+              "description": "Row-click channel; empty = rows are not clickable.",
+              "label": "Which event does clicking a row fire?",
+              "refId": "evt_01KXG04GBVY9JZ0GKE9H65FMMJ",
+              "synonyms": "row click event, item click, open event",
+              "tier": "presentation",
+              "type": "event"
+            },
             "reorderable": {
               "default": false,
               "description": "Allow drag-reordering of rows (emits REORDER). On for ordered trees (e.g. wiki page nav).",
@@ -522,6 +558,13 @@
               "label": "Folder tree",
               "tier": "presentation",
               "type": "[TreeNode]"
+            },
+            "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": [
@@ -1157,7 +1200,41 @@
                           "entity": "@payload.data",
                           "fields": "@config.fields",
                           "gap": "sm",
-                          "itemActions": "@config.itemActions",
+                          "itemActions": [
+                            "array/filter",
+                            "@config.itemActions",
+                            [
+                              "fn",
+                              "action",
+                              [
+                                "or",
+                                [
+                                  "=",
+                                  [
+                                    "array/len",
+                                    [
+                                      "object/get",
+                                      "@action",
+                                      "roles",
+                                      []
+                                    ]
+                                  ],
+                                  0.0
+                                ],
+                                [
+                                  "array/includes",
+                                  [
+                                    "object/get",
+                                    "@action",
+                                    "roles",
+                                    []
+                                  ],
+                                  "@config.viewerRole"
+                                ]
+                              ]
+                            ]
+                          ],
+                          "itemClickEvent": "@config.itemClickEvent",
                           "look": "@config.tableLook",
                           "reorderEvent": "REORDER",
                           "reorderable": "@config.reorderable",
@@ -1333,7 +1410,40 @@
                           "type": "divider"
                         },
                         {
-                          "entity": "@config.detailActions",
+                          "entity": [
+                            "array/filter",
+                            "@config.detailActions",
+                            [
+                              "fn",
+                              "action",
+                              [
+                                "or",
+                                [
+                                  "=",
+                                  [
+                                    "array/len",
+                                    [
+                                      "object/get",
+                                      "@action",
+                                      "roles",
+                                      []
+                                    ]
+                                  ],
+                                  0.0
+                                ],
+                                [
+                                  "array/includes",
+                                  [
+                                    "object/get",
+                                    "@action",
+                                    "roles",
+                                    []
+                                  ],
+                                  "@config.viewerRole"
+                                ]
+                              ]
+                            ]
+                          ],
                           "fields": [],
                           "gap": "sm",
                           "renderItem": [
@@ -1664,6 +1774,14 @@
           {
             "name": "icon",
             "type": "string"
+          },
+          {
+            "name": "roles",
+            "type": "[string]"
+          },
+          {
+            "name": "when",
+            "type": "SExpr"
           }
         ],
         "TreeNode": [