@almadar/std 16.235.0 → 16.237.0

package/behaviors/registry/ui/core/organisms/ui-media-gallery.orb

@@ -118,6 +118,14 @@
                     "required": false,
                     "type": "string"
                   },
+                  "roles": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "name": "roles",
+                    "required": false,
+                    "type": "array"
+                  },
                   "variant": {
                     "name": "variant",
                     "required": false,
@@ -157,6 +165,13 @@
                 "portrait"
               ]
             },
+            "captionField": {
+              "default": "caption",
+              "description": "Record field holding each image's caption (entity mode). Default `caption`.",
+              "label": "Caption Field",
+              "tier": "presentation",
+              "type": "string"
+            },
             "className": {
               "description": "Additional CSS classes",
               "label": "Class Name",
@@ -340,6 +355,13 @@
                 "desc"
               ]
             },
+            "srcField": {
+              "default": "src",
+              "description": "Record field holding each image's URL (entity mode). Default `src`.",
+              "label": "Src Field",
+              "tier": "presentation",
+              "type": "string"
+            },
             "title": {
               "description": "Gallery title",
               "label": "Title",
@@ -351,6 +373,13 @@
               "label": "Total Count",
               "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"
             }
           },
           "effectRow": [
@@ -481,9 +510,43 @@
                     "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",
                       "aspectRatio": "@config.aspectRatio",
+                      "captionField": "@config.captionField",
                       "className": "@config.className",
                       "columns": "@config.columns",
                       "entity": "@entity",
@@ -500,6 +563,7 @@
                       "showUpload": "@config.showUpload",
                       "sortBy": "@config.sortBy",
                       "sortDirection": "@config.sortDirection",
+                      "srcField": "@config.srcField",
                       "title": "@config.title",
                       "totalCount": "@config.totalCount",
                       "type": "media-gallery"
@@ -518,9 +582,43 @@
                     "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",
                       "aspectRatio": "@config.aspectRatio",
+                      "captionField": "@config.captionField",
                       "className": "@config.className",
                       "columns": "@config.columns",
                       "entity": "@entity",
@@ -537,6 +635,7 @@
                       "showUpload": "@config.showUpload",
                       "sortBy": "@config.sortBy",
                       "sortDirection": "@config.sortDirection",
+                      "srcField": "@config.srcField",
                       "title": "@config.title",
                       "totalCount": "@config.totalCount",
                       "type": "media-gallery"
@@ -558,9 +657,43 @@
                     "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",
                       "aspectRatio": "@config.aspectRatio",
+                      "captionField": "@config.captionField",
                       "className": "@config.className",
                       "columns": "@config.columns",
                       "entity": "@payload.data",
@@ -577,6 +710,7 @@
                       "showUpload": "@config.showUpload",
                       "sortBy": "@config.sortBy",
                       "sortDirection": "@config.sortDirection",
+                      "srcField": "@config.srcField",
                       "title": "@config.title",
                       "totalCount": "@config.totalCount",
                       "type": "media-gallery"
@@ -610,6 +744,10 @@
           {
             "name": "variant",
             "type": "string"
+          },
+          {
+            "name": "roles",
+            "type": "[string]"
           }
         ],
         "MediaGalleryError": [

package/behaviors/registry/ui/core/organisms/ui-stat-card.orb

@@ -212,11 +212,37 @@
               "description": "Metrics to display (schema format) - accepts readonly for compatibility with generated const arrays",
               "items": {
                 "properties": {
+                  "aggregate": {
+                    "name": "aggregate",
+                    "required": false,
+                    "type": "string",
+                    "values": [
+                      "count",
+                      "sum"
+                    ]
+                  },
                   "field": {
                     "name": "field",
                     "required": false,
                     "type": "string"
                   },
+                  "filter": {
+                    "name": "filter",
+                    "properties": {
+                      "equals": {
+                        "name": "equals",
+                        "required": true,
+                        "type": "string"
+                      },
+                      "field": {
+                        "name": "field",
+                        "required": true,
+                        "type": "string"
+                      }
+                    },
+                    "required": false,
+                    "type": "object"
+                  },
                   "format": {
                     "name": "format",
                     "required": false,
@@ -647,6 +673,38 @@
           {
             "name": "format",
             "type": "string"
+          },
+          {
+            "name": "aggregate",
+            "type": "string"
+          },
+          {
+            "name": "filter",
+            "properties": [
+              {
+                "name": "field",
+                "required": true,
+                "type": "string"
+              },
+              {
+                "name": "equals",
+                "required": true,
+                "type": "string"
+              }
+            ],
+            "type": "object"
+          }
+        ],
+        "StatCardMetricsItemFilter": [
+          {
+            "name": "field",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "equals",
+            "required": true,
+            "type": "string"
           }
         ]
       }

package/behaviors/registry/ui/core/organisms/ui-state-machine-view.orb

@@ -183,6 +183,13 @@
                 "gear"
               ]
             },
+            "onTransitionClick": {
+              "default": "TRANSITION_CLICK",
+              "description": "Direct transition-click callback, for React hosts (e.g. a canvas node).",
+              "label": "On Transition Click",
+              "tier": "presentation",
+              "type": "event"
+            },
             "pendingSourceState": {
               "description": "Source of a transition being drawn — the next state click picks its target.",
               "label": "Pending Source State",
@@ -391,6 +398,32 @@
                   "name": "to",
                   "required": true,
                   "type": "string"
+                },
+                {
+                  "name": "transition",
+                  "properties": [
+                    {
+                      "name": "index",
+                      "required": true,
+                      "type": "number"
+                    },
+                    {
+                      "name": "event",
+                      "required": true,
+                      "type": "string"
+                    },
+                    {
+                      "name": "from",
+                      "required": true,
+                      "type": "string"
+                    },
+                    {
+                      "name": "to",
+                      "required": true,
+                      "type": "string"
+                    }
+                  ],
+                  "type": "object"
                 }
               ],
               "scope": "external",
@@ -456,6 +489,32 @@
                     "name": "to",
                     "required": true,
                     "type": "string"
+                  },
+                  {
+                    "name": "transition",
+                    "properties": [
+                      {
+                        "name": "index",
+                        "required": true,
+                        "type": "number"
+                      },
+                      {
+                        "name": "event",
+                        "required": true,
+                        "type": "string"
+                      },
+                      {
+                        "name": "from",
+                        "required": true,
+                        "type": "string"
+                      },
+                      {
+                        "name": "to",
+                        "required": true,
+                        "type": "string"
+                      }
+                    ],
+                    "type": "object"
                   }
                 ],
                 "tier": "essential"
@@ -482,6 +541,7 @@
                       "error": "@config.error",
                       "isLoading": "@config.isLoading",
                       "nodeShape": "@config.nodeShape",
+                      "onTransitionClick": "@config.onTransitionClick",
                       "pendingSourceState": "@config.pendingSourceState",
                       "selectedState": "@config.selectedState",
                       "showHeader": "@config.showHeader",
@@ -522,6 +582,28 @@
             "type": "string"
           }
         ],
+        "StateMachineViewTRANSITIONCLICKTransition": [
+          {
+            "name": "index",
+            "required": true,
+            "type": "number"
+          },
+          {
+            "name": "event",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "from",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "to",
+            "required": true,
+            "type": "string"
+          }
+        ],
         "StateMachineViewTrait": [
           {
             "name": "name",

package/behaviors/registry/ui/core/organisms/ui-timeline.orb

@@ -104,6 +104,18 @@
               "tier": "presentation",
               "type": "string"
             },
+            "dateField": {
+              "description": "Entity field holding each item's date.",
+              "label": "Date Field",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "descriptionField": {
+              "description": "Entity field holding each item's description.",
+              "label": "Description Field",
+              "tier": "presentation",
+              "type": "string"
+            },
             "error": {
               "description": "Error state",
               "label": "Error",
@@ -133,11 +145,8 @@
               "type": "TimelineError"
             },
             "fields": {
-              "default": [
-                "Item",
-                "Item 2"
-              ],
-              "description": "Fields to display",
+              "default": [],
+              "description": "Entity fields the timeline draws; each slot is named by its own `*Field` prop.",
               "items": {
                 "type": "string"
               },
@@ -172,6 +181,14 @@
                     "required": false,
                     "type": "string"
                   },
+                  "roles": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "name": "roles",
+                    "required": false,
+                    "type": "array"
+                  },
                   "variant": {
                     "name": "variant",
                     "required": false,
@@ -265,11 +282,30 @@
               "tier": "internal",
               "type": "boolean"
             },
+            "statusField": {
+              "description": "Entity field holding each item's status (complete | active | pending | error).",
+              "label": "Status Field",
+              "tier": "presentation",
+              "type": "string"
+            },
             "title": {
               "description": "Timeline title",
               "label": "Title",
               "tier": "presentation",
               "type": "string"
+            },
+            "titleField": {
+              "description": "Entity field holding each item's title.",
+              "label": "Title Field",
+              "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": [
@@ -410,14 +446,51 @@
                     "main",
                     {
                       "className": "@config.className",
+                      "dateField": "@config.dateField",
+                      "descriptionField": "@config.descriptionField",
                       "entity": "@entity",
                       "error": "@config.error",
                       "fields": "@config.fields",
                       "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"
+                            ]
+                          ]
+                        ]
+                      ],
                       "items": "@config.items",
                       "look": "@config.look",
+                      "statusField": "@config.statusField",
                       "title": "@config.title",
+                      "titleField": "@config.titleField",
                       "type": "timeline"
                     }
                   ]
@@ -435,14 +508,51 @@
                     "main",
                     {
                       "className": "@config.className",
+                      "dateField": "@config.dateField",
+                      "descriptionField": "@config.descriptionField",
                       "entity": "@entity",
                       "error": "@config.error",
                       "fields": "@config.fields",
                       "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"
+                            ]
+                          ]
+                        ]
+                      ],
                       "items": "@config.items",
                       "look": "@config.look",
+                      "statusField": "@config.statusField",
                       "title": "@config.title",
+                      "titleField": "@config.titleField",
                       "type": "timeline"
                     }
                   ]
@@ -463,14 +573,51 @@
                     "main",
                     {
                       "className": "@config.className",
+                      "dateField": "@config.dateField",
+                      "descriptionField": "@config.descriptionField",
                       "entity": "@payload.data",
                       "error": "@config.error",
                       "fields": "@config.fields",
                       "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"
+                            ]
+                          ]
+                        ]
+                      ],
                       "items": "@config.items",
                       "look": "@config.look",
+                      "statusField": "@config.statusField",
                       "title": "@config.title",
+                      "titleField": "@config.titleField",
                       "type": "timeline"
                     }
                   ]
@@ -521,6 +668,10 @@
           {
             "name": "variant",
             "type": "string"
+          },
+          {
+            "name": "roles",
+            "type": "[string]"
           }
         ],
         "TimelineItemsItem": [

package/behaviors/registry/ui/core/templates/ui-auth-layout.orb

@@ -81,7 +81,6 @@
           "category": "interaction",
           "config": {
             "appName": {
-              "default": "My App",
               "description": "App name",
               "label": "App Name",
               "tier": "presentation",