@almadar/std 16.236.0 → 16.237.0

package/behaviors/registry/infra/atoms/std-approval-gate.orb

@@ -635,6 +635,14 @@
               "tier": "presentation",
               "type": "[ItemAction]"
             },
+            "itemClickEvent": {
+              "default": "OPEN_SUBJECT",
+              "description": "Event emitted when a row is clicked; opens the subject under review. Empty disables the row click.",
+              "label": "Row click",
+              "refId": "evt_01M169J81G7ZGXNXN8MZSP7K88",
+              "tier": "presentation",
+              "type": "event"
+            },
             "reviewSlot": {
               "default": "modal",
               "description": "UI slot the review queue renders into. Defaults to the modal overlay so the queue never seizes the host's main content; summoned via OPEN, cleared via CLOSE.",
@@ -875,6 +883,66 @@
                   "required": true,
                   "type": "string"
                 },
+                {
+                  "entity": "ApprovalRequest",
+                  "name": "row",
+                  "properties": [
+                    {
+                      "name": "id",
+                      "required": true,
+                      "type": "string"
+                    },
+                    {
+                      "name": "gatedEvent",
+                      "type": "string"
+                    },
+                    {
+                      "name": "subjectLabel",
+                      "type": "string"
+                    },
+                    {
+                      "name": "subjectId",
+                      "type": "string"
+                    },
+                    {
+                      "name": "requestedBy",
+                      "type": "string"
+                    },
+                    {
+                      "name": "requestedByName",
+                      "type": "string"
+                    },
+                    {
+                      "name": "status",
+                      "type": "string"
+                    },
+                    {
+                      "name": "reviewer",
+                      "type": "string"
+                    },
+                    {
+                      "name": "requestedAt",
+                      "type": "number"
+                    },
+                    {
+                      "name": "decidedAt",
+                      "type": "number"
+                    },
+                    {
+                      "name": "escalatedAt",
+                      "type": "number"
+                    },
+                    {
+                      "name": "notes",
+                      "type": "string"
+                    },
+                    {
+                      "name": "payload",
+                      "type": "Map<string,scalar>"
+                    }
+                  ],
+                  "type": "object"
+                },
                 {
                   "name": "subjectId",
                   "type": "string"
@@ -1741,6 +1809,7 @@
                               "variant": "caption"
                             },
                             {
+                              "format": "date",
                               "label": "Requested",
                               "name": "requestedAt",
                               "variant": "caption"
@@ -1781,6 +1850,7 @@
                               ]
                             ]
                           ],
+                          "itemClickEvent": "@config.itemClickEvent",
                           "look": "@config.tableLook",
                           "type": "data-grid"
                         }

package/behaviors/registry/infra/atoms/std-migration-job.orb

@@ -346,7 +346,7 @@
           },
           {
             "default": [],
-            "description": "Staged ImportUnits ready for review (ref/targetEntity/fields/parentRef), when the host stages the full rows rather than aggregate stats only.",
+            "description": "Staged ImportUnits ready for review (ref/targetEntity/title/fields/parentRef), when the host stages the full rows rather than aggregate stats only.",
             "items": {
               "properties": {
                 "fields": {
@@ -371,6 +371,11 @@
                   "name": "targetEntity",
                   "required": true,
                   "type": "string"
+                },
+                "title": {
+                  "name": "title",
+                  "required": false,
+                  "type": "string"
                 }
               },
               "type": "object"
@@ -692,6 +697,10 @@
                       "required": true,
                       "type": "string"
                     },
+                    {
+                      "name": "title",
+                      "type": "string"
+                    },
                     {
                       "name": "fields",
                       "type": "Map<string,scalar>"
@@ -980,6 +989,10 @@
                         "required": true,
                         "type": "string"
                       },
+                      {
+                        "name": "title",
+                        "type": "string"
+                      },
                       {
                         "name": "fields",
                         "type": "Map<string,scalar>"
@@ -1040,6 +1053,10 @@
                         "required": true,
                         "type": "string"
                       },
+                      {
+                        "name": "title",
+                        "type": "string"
+                      },
                       {
                         "name": "fields",
                         "type": "Map<string,scalar>"
@@ -1097,6 +1114,10 @@
                         "required": true,
                         "type": "string"
                       },
+                      {
+                        "name": "title",
+                        "type": "string"
+                      },
                       {
                         "name": "fields",
                         "type": "Map<string,scalar>"
@@ -2078,6 +2099,10 @@
             "required": true,
             "type": "string"
           },
+          {
+            "name": "title",
+            "type": "string"
+          },
           {
             "name": "fields",
             "type": "Map<string,scalar>"

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

@@ -429,6 +429,14 @@
               "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.",
@@ -1254,6 +1262,7 @@
                               ]
                             ]
                           ],
+                          "itemClickEvent": "@config.itemClickEvent",
                           "look": "@config.tableLook",
                           "type": "data-grid"
                         }

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

@@ -543,6 +543,14 @@
               "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.",
@@ -1140,6 +1148,7 @@
                               ]
                             ]
                           ],
+                          "itemClickEvent": "@config.itemClickEvent",
                           "type": "data-grid"
                         }
                       ],

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

@@ -351,6 +351,7 @@
                         ]
                       ]
                     ],
+                    "itemClickEvent": "@config.itemClickEvent",
                     "maxInlineActions": "@config.maxInlineActions",
                     "pageSize": "@config.displayPageSize",
                     "type": "data-grid"
@@ -443,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,
@@ -476,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,
@@ -680,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,
@@ -828,6 +972,7 @@
                         ]
                       ]
                     ],
+                    "itemClickEvent": "@config.itemClickEvent",
                     "renderItem": [
                       "fn",
                       "item",
@@ -949,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,
@@ -981,6 +1146,14 @@
                     "required": false,
                     "type": "string"
                   },
+                  "labels": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "name": "labels",
+                    "required": false,
+                    "type": "object"
+                  },
                   "name": {
                     "name": "name",
                     "required": true,
@@ -1156,6 +1329,7 @@
                         ]
                       ]
                     ],
+                    "itemClickEvent": "@config.itemClickEvent",
                     "maxInlineActions": "@config.maxInlineActions",
                     "minCardWidth": 260.0,
                     "type": "data-grid"
@@ -1467,7 +1641,8 @@
                           ]
                         ]
                       ],
-                      "fieldNames": "@config.detailFields",
+                      "closeEvent": "@config.detailCloseEvent",
+                      "fields": "@config.detailFields",
                       "initialData": "@payload.row",
                       "showActions": true,
                       "type": "detail-panel"
@@ -1671,6 +1846,7 @@
                             ]
                           ]
                         ],
+                        "itemClickEvent": "@config.itemClickEvent",
                         "maxInlineActions": "@config.maxInlineActions",
                         "type": "data-list",
                         "variant": "compact"
@@ -2863,6 +3039,18 @@
           {
             "name": "icon",
             "type": "string"
+          },
+          {
+            "name": "colorMap",
+            "type": "Map<string,BadgeColor>"
+          },
+          {
+            "name": "labels",
+            "type": "Map<string,string>"
+          },
+          {
+            "name": "variant",
+            "type": "string"
           }
         ],
         "FieldSpec": [
@@ -2894,6 +3082,14 @@
           {
             "name": "header",
             "type": "string"
+          },
+          {
+            "name": "colorMap",
+            "type": "Map<string,BadgeColor>"
+          },
+          {
+            "name": "labels",
+            "type": "Map<string,string>"
           }
         ],
         "FilterSpec": [

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

@@ -412,6 +412,20 @@
                 "tile-image-first"
               ]
             },
+            "dateField": {
+              "default": "date",
+              "description": "Entity field holding each event's date.",
+              "label": "Date field",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "descriptionField": {
+              "default": "description",
+              "description": "Entity field holding each event's description.",
+              "label": "Description field",
+              "tier": "presentation",
+              "type": "string"
+            },
             "filterBarLook": {
               "default": "toolbar",
               "description": "Visual treatment for the embedded filter bar, mirroring std-filter's own enum. Only applies when `filters` is non-empty.",
@@ -568,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.",
@@ -587,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": [
@@ -1317,6 +1345,8 @@
                           "type": "tabs"
                         },
                         {
+                          "dateField": "@config.dateField",
+                          "descriptionField": "@config.descriptionField",
                           "entity": "@entity.entries",
                           "fields": [
                             "title",
@@ -1325,6 +1355,8 @@
                             "status"
                           ],
                           "look": "@config.timelineLook",
+                          "statusField": "@config.statusField",
+                          "titleField": "@config.titleField",
                           "type": "timeline"
                         }
                       ],
@@ -1553,6 +1585,8 @@
                           "type": "tabs"
                         },
                         {
+                          "dateField": "@config.dateField",
+                          "descriptionField": "@config.descriptionField",
                           "entity": "@entity.entries",
                           "fields": [
                             "title",
@@ -1561,6 +1595,8 @@
                             "status"
                           ],
                           "look": "@config.timelineLook",
+                          "statusField": "@config.statusField",
+                          "titleField": "@config.titleField",
                           "type": "timeline"
                         }
                       ],
@@ -2035,6 +2071,8 @@
                           "type": "tabs"
                         },
                         {
+                          "dateField": "@config.dateField",
+                          "descriptionField": "@config.descriptionField",
                           "entity": "@entity.entries",
                           "fields": [
                             "title",
@@ -2043,6 +2081,8 @@
                             "status"
                           ],
                           "look": "@config.timelineLook",
+                          "statusField": "@config.statusField",
+                          "titleField": "@config.titleField",
                           "type": "timeline"
                         }
                       ],
@@ -2258,6 +2298,8 @@
                           "type": "tabs"
                         },
                         {
+                          "dateField": "@config.dateField",
+                          "descriptionField": "@config.descriptionField",
                           "entity": "@entity.entries",
                           "fields": [
                             "title",
@@ -2266,6 +2308,8 @@
                             "status"
                           ],
                           "look": "@config.timelineLook",
+                          "statusField": "@config.statusField",
+                          "titleField": "@config.titleField",
                           "type": "timeline"
                         }
                       ],

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

@@ -273,7 +273,7 @@
                 {
                   "label": "Name",
                   "name": "name",
-                  "variant": "caption"
+                  "variant": "h4"
                 },
                 {
                   "label": "Folder",
@@ -291,6 +291,7 @@
                   "variant": "caption"
                 },
                 {
+                  "format": "date",
                   "label": "Uploaded",
                   "name": "uploadedAt",
                   "variant": "caption"
@@ -427,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).",
@@ -1224,6 +1234,7 @@
                               ]
                             ]
                           ],
+                          "itemClickEvent": "@config.itemClickEvent",
                           "look": "@config.tableLook",
                           "reorderEvent": "REORDER",
                           "reorderable": "@config.reorderable",