@almadar/std 16.235.0 → 16.237.0

package/behaviors/registry/infra/atoms/std-notification-preferences.orb

@@ -371,6 +371,72 @@
         {
           "category": "interaction",
           "config": {
+            "itemActions": {
+              "default": [
+                {
+                  "event": "EDIT",
+                  "icon": "pencil",
+                  "label": "Edit",
+                  "variant": "secondary"
+                },
+                {
+                  "event": "DELETE",
+                  "icon": "trash-2",
+                  "label": "Delete",
+                  "variant": "danger"
+                }
+              ],
+              "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"
+                  },
+                  "icon": {
+                    "name": "icon",
+                    "required": false,
+                    "type": "string"
+                  },
+                  "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]"
+            },
+            "itemClickEvent": {
+              "default": "EDIT",
+              "description": "Event emitted when a row is clicked; opens the preference for editing. Empty disables the row click.",
+              "label": "Row click",
+              "refId": "evt_01M2HEX5N2Y4V8B010WJDPPY13",
+              "tier": "presentation",
+              "type": "event"
+            },
             "tableLook": {
               "default": "dense",
               "description": "Layer 2 visual treatment for the preference data table rendered by this atom.",
@@ -391,6 +457,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": [
@@ -1156,19 +1229,40 @@
                           ],
                           "gap": "sm",
                           "itemActions": [
-                            {
-                              "event": "EDIT",
-                              "icon": "pencil",
-                              "label": "Edit",
-                              "variant": "secondary"
-                            },
-                            {
-                              "event": "DELETE",
-                              "icon": "trash-2",
-                              "label": "Delete",
-                              "variant": "danger"
-                            }
+                            "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",
                           "type": "data-grid"
                         }
@@ -2384,6 +2478,35 @@
           }
         }
       ],
+      "types": {
+        "ItemAction": [
+          {
+            "name": "label",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "event",
+            "type": "event"
+          },
+          {
+            "name": "variant",
+            "type": "string"
+          },
+          {
+            "name": "icon",
+            "type": "string"
+          },
+          {
+            "name": "roles",
+            "type": "[string]"
+          },
+          {
+            "name": "when",
+            "type": "SExpr"
+          }
+        ]
+      },
       "uses": [
         {
           "as": "Modal",

package/behaviors/registry/infra/atoms/std-notify-on-event.orb

@@ -514,17 +514,6 @@
               "tier": "policy",
               "type": "number"
             },
-            "listensFor": {
-              "default": [],
-              "description": "Event names that should fire a notification. Set this to the upstream event name (e.g. OrderPlaced, CheckoutCompleted) so this atom listens for events from the orbital that emits them. The orbital owning this trait reacts whenever the named event fires anywhere in the schema.",
-              "items": {
-                "type": "string"
-              },
-              "label": "Trigger events",
-              "synonyms": "subscribe to event, listen for event, react to event, watch for, wire upstream event, observe event from another orbital, cross-orbital subscription, on-event trigger",
-              "tier": "internal",
-              "type": "[string]"
-            },
             "notifyChannel": {
               "default": "in-app",
               "description": "Delivery channel. `in-app` (default) emits the in-app `notify` toast. `email`/`sms`/`webhook` dispatch through call-service at event time (email.send / twilio.sendSMS / webhook.send) and persist a NotificationRecord audit row with an honest `dispatched` flag: true only once the service call succeeds, false plus the failure detail in `error` otherwise. `push` looks up the recipient's PushSubscription row (captured by std-notification-center's subscribe flow) and dispatches web-push via push.send — a recipient with no subscription records the audit row undispatched (`no-push-subscription`). `webhook` requires `webhookUrl` to actually dispatch; a blank `webhookUrl` still records the audit row undispatched rather than failing. A per-user NotificationPreference row's `channel` overrides this value for that recipient.",

package/behaviors/registry/infra/atoms/std-permission-matrix.orb

@@ -484,6 +484,81 @@
             "access"
           ],
           "category": "interaction",
+          "config": {
+            "itemActions": {
+              "default": [
+                {
+                  "event": "EDIT",
+                  "icon": "pencil",
+                  "label": "Edit",
+                  "variant": "ghost"
+                },
+                {
+                  "event": "DELETE",
+                  "icon": "trash",
+                  "label": "Delete",
+                  "variant": "danger"
+                }
+              ],
+              "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"
+                  },
+                  "icon": {
+                    "name": "icon",
+                    "required": false,
+                    "type": "string"
+                  },
+                  "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]"
+            },
+            "itemClickEvent": {
+              "default": "EDIT",
+              "description": "Event emitted when a row is clicked; opens the grant for editing. Empty disables the row click.",
+              "label": "Row click",
+              "refId": "evt_01M2HEYQZMXWXQ5M0JAD911R8X",
+              "tier": "presentation",
+              "type": "event"
+            },
+            "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",
@@ -1040,19 +1115,40 @@
                           ],
                           "gap": "sm",
                           "itemActions": [
-                            {
-                              "event": "EDIT",
-                              "icon": "pencil",
-                              "label": "Edit",
-                              "variant": "ghost"
-                            },
-                            {
-                              "event": "DELETE",
-                              "icon": "trash",
-                              "label": "Delete",
-                              "variant": "danger"
-                            }
+                            "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",
                           "type": "data-grid"
                         }
                       ],
@@ -2196,6 +2292,35 @@
           }
         }
       ],
+      "types": {
+        "ItemAction": [
+          {
+            "name": "label",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "event",
+            "type": "event"
+          },
+          {
+            "name": "variant",
+            "type": "string"
+          },
+          {
+            "name": "icon",
+            "type": "string"
+          },
+          {
+            "name": "roles",
+            "type": "[string]"
+          },
+          {
+            "name": "when",
+            "type": "SExpr"
+          }
+        ]
+      },
       "uses": [
         {
           "as": "Modal",