@almadar/std 16.236.0 → 16.237.0

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

@@ -37,6 +37,15 @@
         "parent": "trt_01KXG04SJF04WRRXPKM7PJD93N",
         "renames": []
       },
+      "evt_01M3T1CTZ3ZYA6FHZ18QR37H8E": {
+        "bakedName": "@config.itemClickEvent",
+        "curName": "@config.itemClickEvent",
+        "id": "evt_01M3T1CTZ3ZYA6FHZ18QR37H8E",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KXG04SJF04WRRXPKM7PJD93N",
+        "renames": []
+      },
       "orb_01KXG04SJFV1XY022E435J9GPQ": {
         "bakedName": "EntityTableOrbital",
         "curName": "EntityTableOrbital",
@@ -163,6 +172,28 @@
               "description": "Columns can be Column objects or simple string field names",
               "items": {
                 "properties": {
+                  "align": {
+                    "name": "align",
+                    "required": false,
+                    "type": "string",
+                    "values": [
+                      "left",
+                      "center",
+                      "right"
+                    ]
+                  },
+                  "format": {
+                    "name": "format",
+                    "required": false,
+                    "type": "string",
+                    "values": [
+                      "date",
+                      "currency",
+                      "number",
+                      "boolean",
+                      "percent"
+                    ]
+                  },
                   "header": {
                     "name": "header",
                     "required": false,
@@ -267,6 +298,8 @@
             "fields": {
               "default": [
                 {
+                  "align": "left",
+                  "format": "date",
                   "header": "Header",
                   "key": "Key",
                   "label": "Label",
@@ -275,6 +308,8 @@
                   "width": "Width"
                 },
                 {
+                  "align": "center",
+                  "format": "currency",
                   "header": "Header 2",
                   "key": "Key 2",
                   "label": "Label 2",
@@ -286,6 +321,28 @@
               "description": "Fields to display - accepts string[] or Column[] for unified interface. Alias for columns",
               "items": {
                 "properties": {
+                  "align": {
+                    "name": "align",
+                    "required": false,
+                    "type": "string",
+                    "values": [
+                      "left",
+                      "center",
+                      "right"
+                    ]
+                  },
+                  "format": {
+                    "name": "format",
+                    "required": false,
+                    "type": "string",
+                    "values": [
+                      "date",
+                      "currency",
+                      "number",
+                      "boolean",
+                      "percent"
+                    ]
+                  },
                   "header": {
                     "name": "header",
                     "required": false,
@@ -397,6 +454,13 @@
               "tier": "presentation",
               "type": "[EntityTableItemActionsItem]"
             },
+            "itemClickEvent": {
+              "default": "ITEM_CLICK",
+              "description": "When set, rows are activatable and emit UI:{itemClickEvent} with { id, row }",
+              "label": "Item Click Event",
+              "tier": "presentation",
+              "type": "event"
+            },
             "look": {
               "default": "dense",
               "description": "Layer 2 visual treatment — orthogonal to the semantic variant.",
@@ -600,6 +664,26 @@
             }
           ],
           "emits": [
+            {
+              "definerKnob": "itemClickEvent",
+              "description": "When set, rows are activatable and emit UI:{itemClickEvent} with { id, row }",
+              "event": "@config.itemClickEvent",
+              "eventId": "evt_01M3T1CTZ3ZYA6FHZ18QR37H8E",
+              "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",
@@ -684,6 +768,25 @@
                 "synonyms": "loaded, fetched, retrieved",
                 "tier": "essential"
               },
+              {
+                "description": "When set, rows are activatable and emit UI:{itemClickEvent} with { id, row }",
+                "id": "evt_01M3T1CTZ3ZYA6FHZ18QR37H8E",
+                "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_01KXG04SJJ648J6B44Z4MCR8KK",
@@ -806,6 +909,7 @@
                           ]
                         ]
                       ],
+                      "itemClickEvent": "@config.itemClickEvent",
                       "look": "@config.look",
                       "page": "@config.pageProp",
                       "pageSize": "@config.pageSize",
@@ -949,6 +1053,7 @@
                           ]
                         ]
                       ],
+                      "itemClickEvent": "@config.itemClickEvent",
                       "look": "@config.look",
                       "page": "@config.pageProp",
                       "pageSize": "@config.pageSize",
@@ -1095,6 +1200,7 @@
                           ]
                         ]
                       ],
+                      "itemClickEvent": "@config.itemClickEvent",
                       "look": "@config.look",
                       "page": "@config.pageProp",
                       "pageSize": "@config.pageSize",
@@ -1203,6 +1309,14 @@
           {
             "name": "sortable",
             "type": "boolean"
+          },
+          {
+            "name": "align",
+            "type": "string"
+          },
+          {
+            "name": "format",
+            "type": "string"
           }
         ],
         "EntityTableEmptyAction": [
@@ -1259,6 +1373,14 @@
           {
             "name": "sortable",
             "type": "boolean"
+          },
+          {
+            "name": "align",
+            "type": "string"
+          },
+          {
+            "name": "format",
+            "type": "string"
           }
         ],
         "EntityTableItemActionsItem": [

package/behaviors/registry/ui/core/organisms/ui-form-section.orb

@@ -643,6 +643,14 @@
                     "required": false,
                     "type": "string"
                   },
+                  "labels": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "name": "labels",
+                    "required": false,
+                    "type": "object"
+                  },
                   "max": {
                     "name": "max",
                     "required": false,
@@ -1001,6 +1009,14 @@
                           "required": false,
                           "type": "string"
                         },
+                        "labels": {
+                          "items": {
+                            "type": "string"
+                          },
+                          "name": "labels",
+                          "required": false,
+                          "type": "object"
+                        },
                         "max": {
                           "name": "max",
                           "required": false,
@@ -2013,6 +2029,10 @@
             "name": "values",
             "type": "[string]"
           },
+          {
+            "name": "labels",
+            "type": "Map<string,string>"
+          },
           {
             "name": "relation",
             "properties": [
@@ -2251,6 +2271,10 @@
                 "name": "values",
                 "type": "[string]"
               },
+              {
+                "name": "labels",
+                "type": "Map<string,string>"
+              },
               {
                 "name": "relation",
                 "properties": [
@@ -2410,6 +2434,10 @@
             "name": "values",
             "type": "[string]"
           },
+          {
+            "name": "labels",
+            "type": "Map<string,string>"
+          },
           {
             "name": "relation",
             "properties": [

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

@@ -643,6 +643,14 @@
                     "required": false,
                     "type": "string"
                   },
+                  "labels": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "name": "labels",
+                    "required": false,
+                    "type": "object"
+                  },
                   "max": {
                     "name": "max",
                     "required": false,
@@ -1001,6 +1009,14 @@
                           "required": false,
                           "type": "string"
                         },
+                        "labels": {
+                          "items": {
+                            "type": "string"
+                          },
+                          "name": "labels",
+                          "required": false,
+                          "type": "object"
+                        },
                         "max": {
                           "name": "max",
                           "required": false,
@@ -2013,6 +2029,10 @@
             "name": "values",
             "type": "[string]"
           },
+          {
+            "name": "labels",
+            "type": "Map<string,string>"
+          },
           {
             "name": "relation",
             "properties": [
@@ -2251,6 +2271,10 @@
                 "name": "values",
                 "type": "[string]"
               },
+              {
+                "name": "labels",
+                "type": "Map<string,string>"
+              },
               {
                 "name": "relation",
                 "properties": [
@@ -2410,6 +2434,10 @@
             "name": "values",
             "type": "[string]"
           },
+          {
+            "name": "labels",
+            "type": "Map<string,string>"
+          },
           {
             "name": "relation",
             "properties": [

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

@@ -165,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",
@@ -348,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",
@@ -532,6 +546,7 @@
                       ],
                       "activeFilters": "@config.activeFilters",
                       "aspectRatio": "@config.aspectRatio",
+                      "captionField": "@config.captionField",
                       "className": "@config.className",
                       "columns": "@config.columns",
                       "entity": "@entity",
@@ -548,6 +563,7 @@
                       "showUpload": "@config.showUpload",
                       "sortBy": "@config.sortBy",
                       "sortDirection": "@config.sortDirection",
+                      "srcField": "@config.srcField",
                       "title": "@config.title",
                       "totalCount": "@config.totalCount",
                       "type": "media-gallery"
@@ -602,6 +618,7 @@
                       ],
                       "activeFilters": "@config.activeFilters",
                       "aspectRatio": "@config.aspectRatio",
+                      "captionField": "@config.captionField",
                       "className": "@config.className",
                       "columns": "@config.columns",
                       "entity": "@entity",
@@ -618,6 +635,7 @@
                       "showUpload": "@config.showUpload",
                       "sortBy": "@config.sortBy",
                       "sortDirection": "@config.sortDirection",
+                      "srcField": "@config.srcField",
                       "title": "@config.title",
                       "totalCount": "@config.totalCount",
                       "type": "media-gallery"
@@ -675,6 +693,7 @@
                       ],
                       "activeFilters": "@config.activeFilters",
                       "aspectRatio": "@config.aspectRatio",
+                      "captionField": "@config.captionField",
                       "className": "@config.className",
                       "columns": "@config.columns",
                       "entity": "@payload.data",
@@ -691,6 +710,7 @@
                       "showUpload": "@config.showUpload",
                       "sortBy": "@config.sortBy",
                       "sortDirection": "@config.sortDirection",
+                      "srcField": "@config.srcField",
                       "title": "@config.title",
                       "totalCount": "@config.totalCount",
                       "type": "media-gallery"

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-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"
               },
@@ -273,12 +282,24 @@
               "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.",
@@ -425,6 +446,8 @@
                     "main",
                     {
                       "className": "@config.className",
+                      "dateField": "@config.dateField",
+                      "descriptionField": "@config.descriptionField",
                       "entity": "@entity",
                       "error": "@config.error",
                       "fields": "@config.fields",
@@ -465,7 +488,9 @@
                       ],
                       "items": "@config.items",
                       "look": "@config.look",
+                      "statusField": "@config.statusField",
                       "title": "@config.title",
+                      "titleField": "@config.titleField",
                       "type": "timeline"
                     }
                   ]
@@ -483,6 +508,8 @@
                     "main",
                     {
                       "className": "@config.className",
+                      "dateField": "@config.dateField",
+                      "descriptionField": "@config.descriptionField",
                       "entity": "@entity",
                       "error": "@config.error",
                       "fields": "@config.fields",
@@ -523,7 +550,9 @@
                       ],
                       "items": "@config.items",
                       "look": "@config.look",
+                      "statusField": "@config.statusField",
                       "title": "@config.title",
+                      "titleField": "@config.titleField",
                       "type": "timeline"
                     }
                   ]
@@ -544,6 +573,8 @@
                     "main",
                     {
                       "className": "@config.className",
+                      "dateField": "@config.dateField",
+                      "descriptionField": "@config.descriptionField",
                       "entity": "@payload.data",
                       "error": "@config.error",
                       "fields": "@config.fields",
@@ -584,7 +615,9 @@
                       ],
                       "items": "@config.items",
                       "look": "@config.look",
+                      "statusField": "@config.statusField",
                       "title": "@config.title",
+                      "titleField": "@config.titleField",
                       "type": "timeline"
                     }
                   ]

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",

package/behaviors/registry/ui/core/templates/ui-counter-template.orb

@@ -205,7 +205,6 @@
               ]
             },
             "title": {
-              "default": "Counter",
               "description": "Title displayed above the counter",
               "label": "Title",
               "tier": "presentation",

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

@@ -117,7 +117,6 @@
           "category": "interaction",
           "config": {
             "appName": {
-              "default": "{{APP_TITLE}}",
               "description": "App name shown in sidebar",
               "label": "App Name",
               "tier": "presentation",

package/behaviors/registry/ui/game/atoms/ui-choice-button.orb

@@ -248,7 +248,7 @@
               "type": "boolean"
             },
             "text": {
-              "default": "Charge forward into the fray",
+              "default": "",
               "description": "Choice text content",
               "label": "Text",
               "tier": "presentation",

package/behaviors/registry/ui/game/atoms/ui-dialogue-bubble.orb

@@ -208,14 +208,13 @@
               "type": "number"
             },
             "speaker": {
-              "default": "Hero",
               "description": "Speaker name displayed at the top",
               "label": "Speaker",
               "tier": "presentation",
               "type": "string"
             },
             "text": {
-              "default": "The dungeon awaits. Choose your path wisely.",
+              "default": "",
               "description": "Dialogue text content",
               "label": "Text",
               "tier": "presentation",

package/behaviors/registry/ui/game/atoms/ui-game-menu.orb

@@ -316,7 +316,7 @@
               "type": "string"
             },
             "title": {
-              "default": "Epic Quest",
+              "default": "",
               "description": "Menu title",
               "label": "Title",
               "tier": "presentation",

package/behaviors/registry/ui/game/atoms/ui-score-display.orb

@@ -190,7 +190,6 @@
               "type": "string"
             },
             "locale": {
-              "default": "en-US",
               "description": "Number formatting locale",
               "label": "Locale",
               "tier": "presentation",