@almadar/std 16.235.0 → 16.237.0

package/behaviors/registry/ui/core/organisms/ui-detail-panel.orb

@@ -19,10 +19,19 @@
         "parent": "trt_01KXG04SD9CXEV12B2DCF8KYGK",
         "renames": []
       },
-      "evt_01KXG04SDBVHXJR39FQKJ2R4F9": {
+      "evt_01M3RWGFY2NR2AWA5M5G9DE397": {
         "bakedName": "DetailPanelLoaded",
         "curName": "DetailPanelLoaded",
-        "id": "evt_01KXG04SDBVHXJR39FQKJ2R4F9",
+        "id": "evt_01M3RWGFY2NR2AWA5M5G9DE397",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KXG04SD9CXEV12B2DCF8KYGK",
+        "renames": []
+      },
+      "evt_01M3T0VXEXYCXXAVQSJNA41FTD": {
+        "bakedName": "@config.closeEvent",
+        "curName": "@config.closeEvent",
+        "id": "evt_01M3T0VXEXYCXXAVQSJNA41FTD",
         "kind": "event",
         "owner": "workspace",
         "parent": "trt_01KXG04SD9CXEV12B2DCF8KYGK",
@@ -114,6 +123,14 @@
                     "required": false,
                     "type": "string"
                   },
+                  "roles": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "name": "roles",
+                    "required": false,
+                    "type": "array"
+                  },
                   "variant": {
                     "name": "variant",
                     "required": false,
@@ -124,6 +141,11 @@
                       "ghost",
                       "danger"
                     ]
+                  },
+                  "when": {
+                    "name": "when",
+                    "required": false,
+                    "type": "object"
                   }
                 },
                 "type": "object"
@@ -182,6 +204,11 @@
                     "ghost",
                     "danger"
                   ]
+                },
+                "when": {
+                  "name": "when",
+                  "required": false,
+                  "type": "object"
                 }
               },
               "tier": "presentation",
@@ -193,6 +220,13 @@
               "tier": "presentation",
               "type": "string"
             },
+            "closeEvent": {
+              "default": "CLOSE",
+              "description": "The event of the declared action that dismisses the panel. The matching action renders as the header close ×; omitted, no × is drawn.",
+              "label": "Close Event",
+              "tier": "presentation",
+              "type": "event"
+            },
             "displayFields": {
               "default": [],
               "description": "Display fields (alias for fields)",
@@ -244,8 +278,10 @@
             "fields": {
               "default": [
                 {
-                  "header": "Header",
-                  "key": "Key",
+                  "format": "date",
+                  "icon": "circle",
+                  "label": "Label",
+                  "name": "Name",
                   "relation": {
                     "cardinality": "one",
                     "entity": "Entity"
@@ -254,11 +290,14 @@
                   "values": [
                     "Item",
                     "Item 2"
-                  ]
+                  ],
+                  "variant": "h3"
                 },
                 {
-                  "header": "Header 2",
-                  "key": "Key 2",
+                  "format": "currency",
+                  "icon": "circle",
+                  "label": "Label 2",
+                  "name": "Name 2",
                   "relation": {
                     "cardinality": "many",
                     "entity": "Entity 2"
@@ -267,19 +306,65 @@
                   "values": [
                     "Item",
                     "Item 2"
-                  ]
+                  ],
+                  "variant": "h4"
                 }
               ],
-              "description": "Fields to display - accepts string[], {key, header}[], or DetailField[]",
+              "description": "Fields to display: field names, or declared fields ({ name, label, variant, format, colorMap, labels })",
               "items": {
                 "properties": {
-                  "header": {
-                    "name": "header",
+                  "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"
+                    ]
+                  },
+                  "icon": {
+                    "name": "icon",
+                    "required": false,
+                    "type": "string"
+                  },
+                  "label": {
+                    "name": "label",
                     "required": false,
                     "type": "string"
                   },
-                  "key": {
-                    "name": "key",
+                  "labels": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "name": "labels",
+                    "required": false,
+                    "type": "object"
+                  },
+                  "name": {
+                    "name": "name",
                     "required": true,
                     "type": "string"
                   },
@@ -319,6 +404,20 @@
                     "name": "values",
                     "required": false,
                     "type": "array"
+                  },
+                  "variant": {
+                    "name": "variant",
+                    "required": false,
+                    "type": "string",
+                    "values": [
+                      "h3",
+                      "h4",
+                      "body",
+                      "caption",
+                      "badge",
+                      "small",
+                      "progress"
+                    ]
                   }
                 },
                 "type": "object"
@@ -484,8 +583,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"
             },
@@ -563,6 +662,13 @@
               "tier": "presentation",
               "type": "number"
             },
+            "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"
+            },
             "width": {
               "description": "Panel width (CSS value, e.g., '400px', '50%')",
               "label": "Width",
@@ -582,9 +688,17 @@
           ],
           "emits": [
             {
-              "description": "DetailPanel rows finished loading; payload.data holds the collection.",
+              "definerKnob": "closeEvent",
+              "description": "The event of the declared action that dismisses the panel. The matching action renders as the header close ×; omitted, no × is drawn.",
+              "event": "@config.closeEvent",
+              "eventId": "evt_01M3T0VXEXYCXXAVQSJNA41FTD",
+              "scope": "external",
+              "tier": "essential"
+            },
+            {
+              "description": "DetailPanel row finished loading; payload.data holds the single row.",
               "event": "DetailPanelLoaded",
-              "eventId": "evt_01KXG04SDBVHXJR39FQKJ2R4F9",
+              "eventId": "evt_01M3RWGFY2NR2AWA5M5G9DE397",
               "payloadSchema": [
                 {
                   "entity": "DetailPanelItem",
@@ -596,7 +710,7 @@
                       "type": "string"
                     }
                   ],
-                  "type": "[object]"
+                  "type": "object"
                 }
               ],
               "scope": "internal",
@@ -620,13 +734,21 @@
           "stateMachine": {
             "events": [
               {
+                "description": "Mount payload; a host that routes to this panel by id (a :id page param) passes it here.",
                 "id": "evt_01KXG04SD94X8KGY16SVTBNF6K",
                 "key": "INIT",
-                "name": "Initialize"
+                "name": "Initialize",
+                "payloadSchema": [
+                  {
+                    "name": "id",
+                    "type": "string"
+                  }
+                ],
+                "tier": "internal"
               },
               {
-                "description": "DetailPanel rows finished loading; payload.data holds the collection.",
-                "id": "evt_01KXG04SDBVHXJR39FQKJ2R4F9",
+                "description": "DetailPanel row finished loading; payload.data holds the single row.",
+                "id": "evt_01M3RWGFY2NR2AWA5M5G9DE397",
                 "key": "DetailPanelLoaded",
                 "name": "Detail panel loaded",
                 "payloadSchema": [
@@ -640,16 +762,26 @@
                         "type": "string"
                       }
                     ],
-                    "type": "[object]"
+                    "type": "object"
                   }
                 ],
                 "synonyms": "loaded, fetched, retrieved",
                 "tier": "essential"
+              },
+              {
+                "description": "The event of the declared action that dismisses the panel. The matching action renders as the header close ×; omitted, no × is drawn.",
+                "id": "evt_01M3T0VXEXYCXXAVQSJNA41FTD",
+                "key": "@config.closeEvent",
+                "name": "@config.close event",
+                "tier": "essential"
               }
             ],
             "states": [
               {
                 "isInitial": true,
+                "name": "resolving"
+              },
+              {
                 "name": "idle"
               }
             ],
@@ -662,18 +794,53 @@
                     {
                       "emit": {
                         "success": "DetailPanelLoaded"
-                      }
+                      },
+                      "id": "@payload.id"
                     }
                   ],
                   [
                     "render-ui",
                     "main",
                     {
-                      "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"
+                            ]
+                          ]
+                        ]
+                      ],
                       "activeFilters": "@config.activeFilters",
                       "avatar": "@config.avatar",
                       "backAction": "@config.backAction",
                       "className": "@config.className",
+                      "closeEvent": "@config.closeEvent",
                       "displayFields": "@config.displayFields",
                       "entity": "@entity",
                       "error": "@config.error",
@@ -707,8 +874,25 @@
                 ],
                 "event": "INIT",
                 "eventId": "evt_01KXG04SD94X8KGY16SVTBNF6K",
-                "from": "idle",
-                "guard": "@config.selfFetch",
+                "from": "resolving",
+                "guard": [
+                  "and",
+                  "@config.selfFetch",
+                  [
+                    "!=",
+                    [
+                      "str/default",
+                      "@payload.id",
+                      ""
+                    ],
+                    ""
+                  ],
+                  [
+                    "!=",
+                    "@config.mode",
+                    "create"
+                  ]
+                ],
                 "to": "idle"
               },
               {
@@ -717,11 +901,45 @@
                     "render-ui",
                     "main",
                     {
-                      "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"
+                            ]
+                          ]
+                        ]
+                      ],
                       "activeFilters": "@config.activeFilters",
                       "avatar": "@config.avatar",
                       "backAction": "@config.backAction",
                       "className": "@config.className",
+                      "closeEvent": "@config.closeEvent",
                       "displayFields": "@config.displayFields",
                       "entity": "@entity",
                       "error": "@config.error",
@@ -755,11 +973,109 @@
                 ],
                 "event": "INIT",
                 "eventId": "evt_01KXG04SD94X8KGY16SVTBNF6K",
-                "from": "idle",
+                "from": "resolving",
                 "guard": [
                   "not",
-                  "@config.selfFetch"
+                  [
+                    "and",
+                    "@config.selfFetch",
+                    [
+                      "!=",
+                      [
+                        "str/default",
+                        "@payload.id",
+                        ""
+                      ],
+                      ""
+                    ],
+                    [
+                      "!=",
+                      "@config.mode",
+                      "create"
+                    ]
+                  ]
+                ],
+                "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "actions": [
+                        "array/filter",
+                        "@config.actions",
+                        [
+                          "fn",
+                          "action",
+                          [
+                            "or",
+                            [
+                              "=",
+                              [
+                                "array/len",
+                                [
+                                  "object/get",
+                                  "@action",
+                                  "roles",
+                                  []
+                                ]
+                              ],
+                              0.0
+                            ],
+                            [
+                              "array/includes",
+                              [
+                                "object/get",
+                                "@action",
+                                "roles",
+                                []
+                              ],
+                              "@config.viewerRole"
+                            ]
+                          ]
+                        ]
+                      ],
+                      "activeFilters": "@config.activeFilters",
+                      "avatar": "@config.avatar",
+                      "backAction": "@config.backAction",
+                      "className": "@config.className",
+                      "closeEvent": "@config.closeEvent",
+                      "displayFields": "@config.displayFields",
+                      "entity": "@entity",
+                      "error": "@config.error",
+                      "fieldNames": "@config.fieldNames",
+                      "fields": "@config.fields",
+                      "footer": "@config.footer",
+                      "initialData": "@entity",
+                      "isLoading": "@config.isLoading",
+                      "maxInlineActions": "@config.maxInlineActions",
+                      "mode": "@config.mode",
+                      "onTitleCommit": "@config.onTitleCommit",
+                      "page": "@config.pageProp",
+                      "pageSize": "@config.pageSize",
+                      "position": "@config.position",
+                      "relationsData": "@config.relationsData",
+                      "searchValue": "@config.searchValue",
+                      "sections": "@config.sections",
+                      "selectedIds": "@config.selectedIds",
+                      "showActions": "@config.showActions",
+                      "slideOver": "@config.slideOver",
+                      "sortBy": "@config.sortBy",
+                      "sortDirection": "@config.sortDirection",
+                      "status": "@config.status",
+                      "subtitle": "@config.subtitle",
+                      "title": "@config.title",
+                      "totalCount": "@config.totalCount",
+                      "type": "detail-panel",
+                      "width": "@config.width"
+                    }
+                  ]
                 ],
+                "event": "INIT",
+                "eventId": "evt_01KXG04SD94X8KGY16SVTBNF6K",
+                "from": "idle",
                 "to": "idle"
               },
               {
@@ -768,11 +1084,45 @@
                     "render-ui",
                     "main",
                     {
-                      "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"
+                            ]
+                          ]
+                        ]
+                      ],
                       "activeFilters": "@config.activeFilters",
                       "avatar": "@config.avatar",
                       "backAction": "@config.backAction",
                       "className": "@config.className",
+                      "closeEvent": "@config.closeEvent",
                       "displayFields": "@config.displayFields",
                       "entity": "@payload.data",
                       "error": "@config.error",
@@ -805,7 +1155,7 @@
                   ]
                 ],
                 "event": "DetailPanelLoaded",
-                "eventId": "evt_01KXG04SDBVHXJR39FQKJ2R4F9",
+                "eventId": "evt_01M3RWGFY2NR2AWA5M5G9DE397",
                 "from": "idle",
                 "to": "idle"
               }
@@ -835,6 +1185,14 @@
           {
             "name": "variant",
             "type": "string"
+          },
+          {
+            "name": "when",
+            "type": "SExpr"
+          },
+          {
+            "name": "roles",
+            "type": "[string]"
           }
         ],
         "DetailPanelBackAction": [
@@ -858,6 +1216,10 @@
           {
             "name": "variant",
             "type": "string"
+          },
+          {
+            "name": "when",
+            "type": "SExpr"
           }
         ],
         "DetailPanelError": [
@@ -881,14 +1243,34 @@
         ],
         "DetailPanelFieldsItem": [
           {
-            "name": "key",
+            "name": "name",
             "required": true,
             "type": "string"
           },
           {
-            "name": "header",
+            "name": "label",
+            "type": "string"
+          },
+          {
+            "name": "icon",
+            "type": "icon"
+          },
+          {
+            "name": "variant",
+            "type": "string"
+          },
+          {
+            "name": "format",
             "type": "string"
           },
+          {
+            "name": "colorMap",
+            "type": "Map<string,DetailPanelFieldsItemColorMapValue>"
+          },
+          {
+            "name": "labels",
+            "type": "Map<string,string>"
+          },
           {
             "name": "type",
             "type": "string"