@almadar/std 16.235.0 → 16.237.0

package/behaviors/registry/ui/core/molecules/ui-data-list.orb

@@ -169,6 +169,26 @@
               "description": "Alias for `fields` — the compiler emits `columns` for field defs.",
               "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,
@@ -191,6 +211,14 @@
                     "required": false,
                     "type": "string"
                   },
+                  "labels": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "name": "labels",
+                    "required": false,
+                    "type": "object"
+                  },
                   "name": {
                     "name": "name",
                     "required": true,
@@ -247,12 +275,48 @@
               "tier": "presentation",
               "type": "string"
             },
+            "emptyAction": {
+              "description": "Create-the-first-item action.",
+              "label": "Empty Action",
+              "properties": {
+                "event": {
+                  "name": "event",
+                  "required": false,
+                  "type": "event"
+                },
+                "label": {
+                  "name": "label",
+                  "required": true,
+                  "type": "string"
+                }
+              },
+              "tier": "presentation",
+              "type": "DataListEmptyAction"
+            },
+            "emptyDescription": {
+              "description": "What will appear here once rows exist.",
+              "label": "Empty Description",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "emptyIcon": {
+              "description": "Domain icon for the empty state.",
+              "label": "Empty Icon",
+              "tier": "presentation",
+              "type": "icon"
+            },
             "emptyMessage": {
               "description": "Message shown when there are no rows. Falls back to the generic 'no items' translation. `TableView` already exposes this; an agenda or an inbox wants to say what 'empty' means in its own words.",
               "label": "Empty Message",
               "tier": "presentation",
               "type": "string"
             },
+            "emptyTitle": {
+              "description": "Specific title ('No orders yet').",
+              "label": "Empty Title",
+              "tier": "presentation",
+              "type": "string"
+            },
             "error": {
               "description": "Error state",
               "label": "Error",
@@ -286,6 +350,26 @@
               "description": "Field definitions for rendering each row. The pattern contract in `@almadar/core/patterns` documents `columns` as the wire-format alias the compiler emits — both names resolve to the same shape here. Pass either.",
               "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,
@@ -308,6 +392,14 @@
                     "required": false,
                     "type": "string"
                   },
+                  "labels": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "name": "labels",
+                    "required": false,
+                    "type": "object"
+                  },
                   "name": {
                     "name": "name",
                     "required": true,
@@ -392,6 +484,14 @@
                     "required": true,
                     "type": "string"
                   },
+                  "roles": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "name": "roles",
+                    "required": false,
+                    "type": "array"
+                  },
                   "variant": {
                     "name": "variant",
                     "required": false,
@@ -402,6 +502,11 @@
                       "ghost",
                       "danger"
                     ]
+                  },
+                  "when": {
+                    "name": "when",
+                    "required": false,
+                    "type": "object"
                   }
                 },
                 "type": "object"
@@ -646,6 +751,13 @@
                 "compact",
                 "message"
               ]
+            },
+            "viewerRole": {
+              "default": "",
+              "description": "The viewer's role that each action's `roles` is checked against; bind it at the call site (e.g. `viewerRole: @user.role`). Empty = only actions with no `roles` show.",
+              "label": "Viewer's role",
+              "tier": "policy",
+              "type": "string"
             }
           },
           "effectRow": [
@@ -907,7 +1019,11 @@
                       "dndRoot": "@config.dndRoot",
                       "dragGroup": "@config.dragGroup",
                       "dropEvent": "@config.dropEvent",
+                      "emptyAction": "@config.emptyAction",
+                      "emptyDescription": "@config.emptyDescription",
+                      "emptyIcon": "@config.emptyIcon",
                       "emptyMessage": "@config.emptyMessage",
+                      "emptyTitle": "@config.emptyTitle",
                       "entity": "@entity",
                       "error": "@config.error",
                       "fields": "@config.fields",
@@ -916,7 +1032,40 @@
                       "hasMore": "@config.hasMore",
                       "infiniteScroll": "@config.infiniteScroll",
                       "isLoading": "@config.isLoading",
-                      "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",
                       "loadMoreEvent": "@config.loadMoreEvent",
                       "longPressEvent": "@config.longPressEvent",
@@ -961,7 +1110,11 @@
                       "dndRoot": "@config.dndRoot",
                       "dragGroup": "@config.dragGroup",
                       "dropEvent": "@config.dropEvent",
+                      "emptyAction": "@config.emptyAction",
+                      "emptyDescription": "@config.emptyDescription",
+                      "emptyIcon": "@config.emptyIcon",
                       "emptyMessage": "@config.emptyMessage",
+                      "emptyTitle": "@config.emptyTitle",
                       "entity": "@entity",
                       "error": "@config.error",
                       "fields": "@config.fields",
@@ -970,7 +1123,40 @@
                       "hasMore": "@config.hasMore",
                       "infiniteScroll": "@config.infiniteScroll",
                       "isLoading": "@config.isLoading",
-                      "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",
                       "loadMoreEvent": "@config.loadMoreEvent",
                       "longPressEvent": "@config.longPressEvent",
@@ -1018,7 +1204,11 @@
                       "dndRoot": "@config.dndRoot",
                       "dragGroup": "@config.dragGroup",
                       "dropEvent": "@config.dropEvent",
+                      "emptyAction": "@config.emptyAction",
+                      "emptyDescription": "@config.emptyDescription",
+                      "emptyIcon": "@config.emptyIcon",
                       "emptyMessage": "@config.emptyMessage",
+                      "emptyTitle": "@config.emptyTitle",
                       "entity": "@payload.data",
                       "error": "@config.error",
                       "fields": "@config.fields",
@@ -1027,7 +1217,40 @@
                       "hasMore": "@config.hasMore",
                       "infiniteScroll": "@config.infiniteScroll",
                       "isLoading": "@config.isLoading",
-                      "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",
                       "loadMoreEvent": "@config.loadMoreEvent",
                       "longPressEvent": "@config.longPressEvent",
@@ -1083,6 +1306,25 @@
           {
             "name": "format",
             "type": "string"
+          },
+          {
+            "name": "colorMap",
+            "type": "Map<string,DataListColumnsItemColorMapValue>"
+          },
+          {
+            "name": "labels",
+            "type": "Map<string,string>"
+          }
+        ],
+        "DataListEmptyAction": [
+          {
+            "name": "label",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "event",
+            "type": "event"
           }
         ],
         "DataListError": [
@@ -1125,6 +1367,14 @@
           {
             "name": "format",
             "type": "string"
+          },
+          {
+            "name": "colorMap",
+            "type": "Map<string,DataListFieldsItemColorMapValue>"
+          },
+          {
+            "name": "labels",
+            "type": "Map<string,string>"
           }
         ],
         "DataListItemActionsItem": [
@@ -1145,6 +1395,14 @@
           {
             "name": "variant",
             "type": "string"
+          },
+          {
+            "name": "when",
+            "type": "SExpr"
+          },
+          {
+            "name": "roles",
+            "type": "[string]"
           }
         ],
         "DataListRelationsDataValueItem": [

package/behaviors/registry/ui/core/molecules/ui-date-range-picker.orb

@@ -131,7 +131,6 @@
               "type": "event"
             },
             "fromLabel": {
-              "default": "From",
               "description": "From-input label.",
               "label": "From Label",
               "tier": "presentation",
@@ -153,7 +152,7 @@
             },
             "presets": {
               "default": [],
-              "description": "Preset shortcuts. Defaults to the standard finance set (Last 7d / Last 30d / This Month / This Quarter / YTD). Pass an empty array to hide presets entirely.",
+              "description": "Preset shortcuts. Defaults to the translated standard finance set (Last 7d / Last 30d / This Month / This Quarter / YTD). Pass an empty array to hide presets entirely.",
               "items": {
                 "properties": {
                   "label": {
@@ -174,7 +173,6 @@
               "type": "[DateRangePickerPresetsItem]"
             },
             "toLabel": {
-              "default": "To",
               "description": "To-input label.",
               "label": "To Label",
               "tier": "presentation",

package/behaviors/registry/ui/core/molecules/ui-document-details.orb

@@ -10,15 +10,6 @@
         "owner": "workspace",
         "renames": []
       },
-      "evt_01M13ZXC59HB41Z83ZYJR50JQP": {
-        "bakedName": "DocumentDetailsLoaded",
-        "curName": "DocumentDetailsLoaded",
-        "id": "evt_01M13ZXC59HB41Z83ZYJR50JQP",
-        "kind": "event",
-        "owner": "workspace",
-        "parent": "trt_01M13ZXC5906BVQKXF5JMWBD0E",
-        "renames": []
-      },
       "evt_01M13ZXC59R4VP1T1DHD262B08": {
         "bakedName": "@config.metaCommitEvent",
         "curName": "@config.metaCommitEvent",
@@ -46,6 +37,15 @@
         "parent": "trt_01M13ZXC5906BVQKXF5JMWBD0E",
         "renames": []
       },
+      "evt_01M3RWGC5NSA2MG9W3F0E0SB97": {
+        "bakedName": "DocumentDetailsLoaded",
+        "curName": "DocumentDetailsLoaded",
+        "id": "evt_01M3RWGC5NSA2MG9W3F0E0SB97",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M13ZXC5906BVQKXF5JMWBD0E",
+        "renames": []
+      },
       "orb_01M13ZXC59HR3466AAAMSKD8MY": {
         "bakedName": "DocumentDetailsOrbital",
         "curName": "DocumentDetailsOrbital",
@@ -162,6 +162,14 @@
                     "required": false,
                     "type": "string"
                   },
+                  "labels": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "name": "labels",
+                    "required": false,
+                    "type": "object"
+                  },
                   "name": {
                     "name": "name",
                     "required": false,
@@ -203,8 +211,8 @@
             },
             "selfFetch": {
               "default": true,
-              "description": "true (default) = standalone mount self-populates on INIT. false = a composing atom owns the fetch and routes its loaded event here — suppresses the wrapper's own un-hydrated fetch so it cannot race the composer's.",
-              "label": "Fetch its own rows on mount?",
+              "description": "true (default) = a mount that carries an id loads that one row (never the collection); a create-mode mount skips the load. false = a composing atom owns the load.",
+              "label": "Fetch its own row on mount?",
               "tier": "internal",
               "type": "boolean"
             },
@@ -272,9 +280,9 @@
               "tier": "essential"
             },
             {
-              "description": "DocumentDetails rows finished loading; payload.data holds the collection.",
+              "description": "DocumentDetails row finished loading; payload.data holds the single row.",
               "event": "DocumentDetailsLoaded",
-              "eventId": "evt_01M13ZXC59HB41Z83ZYJR50JQP",
+              "eventId": "evt_01M3RWGC5NSA2MG9W3F0E0SB97",
               "payloadSchema": [
                 {
                   "entity": "DocumentDetailsItem",
@@ -286,7 +294,7 @@
                       "type": "string"
                     }
                   ],
-                  "type": "[object]"
+                  "type": "object"
                 }
               ],
               "scope": "internal",
@@ -310,13 +318,21 @@
           "stateMachine": {
             "events": [
               {
+                "description": "Mount payload; a host that routes to this panel by id (a :id page param) passes it here.",
                 "id": "evt_01M13ZXC59XKCDATMN4TVFVMZ7",
                 "key": "INIT",
-                "name": "Initialize"
+                "name": "Initialize",
+                "payloadSchema": [
+                  {
+                    "name": "id",
+                    "type": "string"
+                  }
+                ],
+                "tier": "internal"
               },
               {
-                "description": "DocumentDetails rows finished loading; payload.data holds the collection.",
-                "id": "evt_01M13ZXC59HB41Z83ZYJR50JQP",
+                "description": "DocumentDetails row finished loading; payload.data holds the single row.",
+                "id": "evt_01M3RWGC5NSA2MG9W3F0E0SB97",
                 "key": "DocumentDetailsLoaded",
                 "name": "Document details loaded",
                 "payloadSchema": [
@@ -330,7 +346,7 @@
                         "type": "string"
                       }
                     ],
-                    "type": "[object]"
+                    "type": "object"
                   }
                 ],
                 "synonyms": "loaded, fetched, retrieved",
@@ -383,6 +399,9 @@
             "states": [
               {
                 "isInitial": true,
+                "name": "resolving"
+              },
+              {
                 "name": "idle"
               }
             ],
@@ -395,7 +414,8 @@
                     {
                       "emit": {
                         "success": "DocumentDetailsLoaded"
-                      }
+                      },
+                      "id": "@payload.id"
                     }
                   ],
                   [
@@ -414,8 +434,20 @@
                 ],
                 "event": "INIT",
                 "eventId": "evt_01M13ZXC59XKCDATMN4TVFVMZ7",
-                "from": "idle",
-                "guard": "@config.selfFetch",
+                "from": "resolving",
+                "guard": [
+                  "and",
+                  "@config.selfFetch",
+                  [
+                    "!=",
+                    [
+                      "str/default",
+                      "@payload.id",
+                      ""
+                    ],
+                    ""
+                  ]
+                ],
                 "to": "idle"
               },
               {
@@ -436,11 +468,44 @@
                 ],
                 "event": "INIT",
                 "eventId": "evt_01M13ZXC59XKCDATMN4TVFVMZ7",
-                "from": "idle",
+                "from": "resolving",
                 "guard": [
                   "not",
-                  "@config.selfFetch"
+                  [
+                    "and",
+                    "@config.selfFetch",
+                    [
+                      "!=",
+                      [
+                        "str/default",
+                        "@payload.id",
+                        ""
+                      ],
+                      ""
+                    ]
+                  ]
+                ],
+                "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "className": "@config.className",
+                      "entity": "@entity",
+                      "fields": "@config.fields",
+                      "metaCommitEvent": "@config.metaCommitEvent",
+                      "relationEvent": "@config.relationEvent",
+                      "title": "@config.title",
+                      "type": "document-details"
+                    }
+                  ]
                 ],
+                "event": "INIT",
+                "eventId": "evt_01M13ZXC59XKCDATMN4TVFVMZ7",
+                "from": "idle",
                 "to": "idle"
               },
               {
@@ -460,7 +525,7 @@
                   ]
                 ],
                 "event": "DocumentDetailsLoaded",
-                "eventId": "evt_01M13ZXC59HB41Z83ZYJR50JQP",
+                "eventId": "evt_01M3RWGC5NSA2MG9W3F0E0SB97",
                 "from": "idle",
                 "to": "idle"
               }
@@ -498,6 +563,10 @@
             "name": "options",
             "type": "[string]"
           },
+          {
+            "name": "labels",
+            "type": "Map<string,string>"
+          },
           {
             "name": "format",
             "type": "string"