@almadar/std 16.235.0 → 16.237.0

package/behaviors/registry/ui/core/organisms/ui-entity-cards.orb

@@ -37,6 +37,15 @@
         "parent": "trt_01KXG04SFSBE96PSPPSF6583GX",
         "renames": []
       },
+      "evt_01M3T0VXG9TJAGVG9GXRSZM3G8": {
+        "bakedName": "@config.itemClickEvent",
+        "curName": "@config.itemClickEvent",
+        "id": "evt_01M3T0VXG9TJAGVG9GXRSZM3G8",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KXG04SFSBE96PSPPSF6583GX",
+        "renames": []
+      },
       "orb_01KXG04SFS0B5Q7S2YETSA8YFJ": {
         "bakedName": "EntityCardsOrbital",
         "curName": "EntityCardsOrbital",
@@ -138,13 +147,40 @@
               "description": "Alias for fields - backwards compatibility",
               "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": "string"
+                    "type": "object"
                   },
-                  "key": {
-                    "name": "key",
+                  "format": {
+                    "name": "format",
+                    "required": false,
+                    "type": "string",
+                    "values": [
+                      "date",
+                      "currency",
+                      "number",
+                      "boolean",
+                      "percent"
+                    ]
+                  },
+                  "icon": {
+                    "name": "icon",
                     "required": false,
                     "type": "string"
                   },
@@ -153,10 +189,32 @@
                     "required": false,
                     "type": "string"
                   },
+                  "labels": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "name": "labels",
+                    "required": false,
+                    "type": "object"
+                  },
                   "name": {
                     "name": "name",
-                    "required": false,
+                    "required": true,
                     "type": "string"
+                  },
+                  "variant": {
+                    "name": "variant",
+                    "required": false,
+                    "type": "string",
+                    "values": [
+                      "h3",
+                      "h4",
+                      "body",
+                      "caption",
+                      "badge",
+                      "small",
+                      "progress"
+                    ]
                   }
                 },
                 "type": "object"
@@ -206,28 +264,57 @@
             "fields": {
               "default": [
                 {
-                  "header": "Header",
-                  "key": "Key",
+                  "format": "date",
+                  "icon": "circle",
                   "label": "Label",
-                  "name": "Name"
+                  "name": "Name",
+                  "variant": "h3"
                 },
                 {
-                  "header": "Header 2",
-                  "key": "Key 2",
+                  "format": "currency",
+                  "icon": "circle",
                   "label": "Label 2",
-                  "name": "Name 2"
+                  "name": "Name 2",
+                  "variant": "h4"
                 }
               ],
               "description": "Fields to display - required for schema-driven rendering",
               "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": "string"
+                    "type": "object"
+                  },
+                  "format": {
+                    "name": "format",
+                    "required": false,
+                    "type": "string",
+                    "values": [
+                      "date",
+                      "currency",
+                      "number",
+                      "boolean",
+                      "percent"
+                    ]
                   },
-                  "key": {
-                    "name": "key",
+                  "icon": {
+                    "name": "icon",
                     "required": false,
                     "type": "string"
                   },
@@ -236,10 +323,32 @@
                     "required": false,
                     "type": "string"
                   },
+                  "labels": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "name": "labels",
+                    "required": false,
+                    "type": "object"
+                  },
                   "name": {
                     "name": "name",
-                    "required": false,
+                    "required": true,
                     "type": "string"
+                  },
+                  "variant": {
+                    "name": "variant",
+                    "required": false,
+                    "type": "string",
+                    "values": [
+                      "h3",
+                      "h4",
+                      "body",
+                      "caption",
+                      "badge",
+                      "small",
+                      "progress"
+                    ]
                   }
                 },
                 "type": "object"
@@ -306,10 +415,23 @@
                     "required": false,
                     "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"
@@ -318,6 +440,13 @@
               "tier": "presentation",
               "type": "[EntityCardsItemActionsItem]"
             },
+            "itemClickEvent": {
+              "default": "ITEM_CLICK",
+              "description": "When set, clicking a card emits UI:{itemClickEvent} with { id, row }. Omit = cards are not clickable.",
+              "label": "Item Click Event",
+              "tier": "presentation",
+              "type": "event"
+            },
             "maxCols": {
               "description": "Maximum number of columns",
               "label": "Max Cols",
@@ -408,6 +537,13 @@
               "label": "Variant",
               "tier": "presentation",
               "type": "string"
+            },
+            "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": [
@@ -421,6 +557,26 @@
             }
           ],
           "emits": [
+            {
+              "definerKnob": "itemClickEvent",
+              "description": "When set, clicking a card emits UI:{itemClickEvent} with { id, row }. Omit = cards are not clickable.",
+              "event": "@config.itemClickEvent",
+              "eventId": "evt_01M3T0VXG9TJAGVG9GXRSZM3G8",
+              "payloadSchema": [
+                {
+                  "name": "id",
+                  "required": true,
+                  "type": "string"
+                },
+                {
+                  "name": "row",
+                  "required": true,
+                  "type": "@entity"
+                }
+              ],
+              "scope": "external",
+              "tier": "essential"
+            },
             {
               "description": "User opened a record from the list.",
               "event": "VIEW",
@@ -505,6 +661,25 @@
                 "synonyms": "loaded, fetched, retrieved",
                 "tier": "essential"
               },
+              {
+                "description": "When set, clicking a card emits UI:{itemClickEvent} with { id, row }. Omit = cards are not clickable.",
+                "id": "evt_01M3T0VXG9TJAGVG9GXRSZM3G8",
+                "key": "@config.itemClickEvent",
+                "name": "@config.item click event",
+                "payloadSchema": [
+                  {
+                    "name": "id",
+                    "required": true,
+                    "type": "string"
+                  },
+                  {
+                    "name": "row",
+                    "required": true,
+                    "type": "@entity"
+                  }
+                ],
+                "tier": "essential"
+              },
               {
                 "description": "User opened a record from the list.",
                 "id": "evt_01KXG04SFWKXQ588AJKC3XTPME",
@@ -559,7 +734,41 @@
                       "gap": "@config.gap",
                       "imageField": "@config.imageField",
                       "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",
                       "maxCols": "@config.maxCols",
                       "minCardWidth": "@config.minCardWidth",
                       "page": "@config.pageProp",
@@ -600,7 +809,41 @@
                       "gap": "@config.gap",
                       "imageField": "@config.imageField",
                       "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",
                       "maxCols": "@config.maxCols",
                       "minCardWidth": "@config.minCardWidth",
                       "page": "@config.pageProp",
@@ -644,7 +887,41 @@
                       "gap": "@config.gap",
                       "imageField": "@config.imageField",
                       "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",
                       "maxCols": "@config.maxCols",
                       "minCardWidth": "@config.minCardWidth",
                       "page": "@config.pageProp",
@@ -673,20 +950,33 @@
       "types": {
         "EntityCardsColumnsItem": [
           {
-            "name": "key",
+            "name": "name",
+            "required": true,
             "type": "string"
           },
           {
-            "name": "header",
+            "name": "label",
             "type": "string"
           },
           {
-            "name": "name",
+            "name": "icon",
+            "type": "icon"
+          },
+          {
+            "name": "variant",
             "type": "string"
           },
           {
-            "name": "label",
+            "name": "format",
             "type": "string"
+          },
+          {
+            "name": "colorMap",
+            "type": "Map<string,EntityCardsColumnsItemColorMapValue>"
+          },
+          {
+            "name": "labels",
+            "type": "Map<string,string>"
           }
         ],
         "EntityCardsError": [
@@ -710,20 +1000,33 @@
         ],
         "EntityCardsFieldsItem": [
           {
-            "name": "key",
+            "name": "name",
+            "required": true,
             "type": "string"
           },
           {
-            "name": "header",
+            "name": "label",
             "type": "string"
           },
           {
-            "name": "name",
+            "name": "icon",
+            "type": "icon"
+          },
+          {
+            "name": "variant",
             "type": "string"
           },
           {
-            "name": "label",
+            "name": "format",
             "type": "string"
+          },
+          {
+            "name": "colorMap",
+            "type": "Map<string,EntityCardsFieldsItemColorMapValue>"
+          },
+          {
+            "name": "labels",
+            "type": "Map<string,string>"
           }
         ],
         "EntityCardsItemActionsItem": [
@@ -747,6 +1050,14 @@
           {
             "name": "variant",
             "type": "string"
+          },
+          {
+            "name": "when",
+            "type": "SExpr"
+          },
+          {
+            "name": "roles",
+            "type": "[string]"
           }
         ]
       }