@almadar/std 16.236.0 → 16.238.0

package/behaviors/registry/ui/core/atoms/std-browse.orb

@@ -351,6 +351,7 @@
                         ]
                       ]
                     ],
+                    "itemClickEvent": "@config.itemClickEvent",
                     "maxInlineActions": "@config.maxInlineActions",
                     "pageSize": "@config.displayPageSize",
                     "type": "data-grid"
@@ -443,6 +444,26 @@
                     "required": false,
                     "type": "string"
                   },
+                  "colorMap": {
+                    "items": {
+                      "type": "string",
+                      "values": [
+                        "default",
+                        "primary",
+                        "secondary",
+                        "success",
+                        "warning",
+                        "danger",
+                        "error",
+                        "info",
+                        "neutral",
+                        "destructive"
+                      ]
+                    },
+                    "name": "colorMap",
+                    "required": false,
+                    "type": "object"
+                  },
                   "field": {
                     "name": "field",
                     "required": false,
@@ -476,6 +497,23 @@
                     "required": true,
                     "type": "string"
                   },
+                  "labels": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "name": "labels",
+                    "required": false,
+                    "type": "object"
+                  },
+                  "variant": {
+                    "name": "variant",
+                    "required": false,
+                    "type": "string",
+                    "values": [
+                      "h3",
+                      "h4"
+                    ]
+                  },
                   "weight": {
                     "name": "weight",
                     "required": false,
@@ -680,21 +718,127 @@
               "tier": "presentation",
               "type": "[BrowseDetailAction]"
             },
+            "detailCloseEvent": {
+              "default": "CLOSE",
+              "description": "The detailActions entry whose event matches renders as the pane's close (×) button.",
+              "label": "Which pane action closes the record?",
+              "refId": "evt_01KYG176Z4DTZ2W62WXFKKSXJV",
+              "synonyms": "close event, dismiss event, pane close",
+              "tier": "presentation",
+              "type": "event"
+            },
             "detailFields": {
               "default": [
-                "name",
-                "description",
-                "status",
-                "createdAt"
+                {
+                  "label": "Name",
+                  "name": "name",
+                  "variant": "h4"
+                },
+                {
+                  "label": "Description",
+                  "name": "description",
+                  "variant": "body"
+                },
+                {
+                  "label": "Status",
+                  "name": "status",
+                  "variant": "badge"
+                },
+                {
+                  "format": "date",
+                  "label": "Created",
+                  "name": "createdAt"
+                }
               ],
-              "description": "Field names shown in the detail panel when browseLook = master-detail; the first entry doubles as the pane title. Consumers overriding columns/fields should override this list to match their entity.",
+              "description": "Fields shown in the detail panel when browseLook = master-detail; the field declared variant h3/h4 is the pane title. Consumers overriding columns/fields should override this list to match their entity.",
               "items": {
-                "type": "string"
+                "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,
+                    "type": "string",
+                    "values": [
+                      "date",
+                      "currency",
+                      "number",
+                      "boolean",
+                      "percent"
+                    ]
+                  },
+                  "header": {
+                    "name": "header",
+                    "required": false,
+                    "type": "string"
+                  },
+                  "icon": {
+                    "name": "icon",
+                    "required": false,
+                    "type": "string"
+                  },
+                  "key": {
+                    "name": "key",
+                    "required": false,
+                    "type": "string"
+                  },
+                  "label": {
+                    "name": "label",
+                    "required": false,
+                    "type": "string"
+                  },
+                  "labels": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "name": "labels",
+                    "required": false,
+                    "type": "object"
+                  },
+                  "name": {
+                    "name": "name",
+                    "required": true,
+                    "type": "string"
+                  },
+                  "variant": {
+                    "name": "variant",
+                    "required": false,
+                    "type": "string",
+                    "values": [
+                      "h3",
+                      "h4",
+                      "body",
+                      "caption",
+                      "badge",
+                      "small",
+                      "progress"
+                    ]
+                  }
+                },
+                "type": "object"
               },
               "label": "Which fields appear in the master-detail record pane?",
               "synonyms": "detail columns, record fields, detail pane fields",
               "tier": "presentation",
-              "type": "[string]"
+              "type": "[FieldSpec]"
             },
             "displayPageSize": {
               "default": 10.0,
@@ -828,6 +972,7 @@
                         ]
                       ]
                     ],
+                    "itemClickEvent": "@config.itemClickEvent",
                     "renderItem": [
                       "fn",
                       "item",
@@ -949,6 +1094,26 @@
               "description": "Each entry maps one entity field to a display column with an optional label and variant.",
               "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,
@@ -981,6 +1146,14 @@
                     "required": false,
                     "type": "string"
                   },
+                  "labels": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "name": "labels",
+                    "required": false,
+                    "type": "object"
+                  },
                   "name": {
                     "name": "name",
                     "required": true,
@@ -1156,6 +1329,7 @@
                         ]
                       ]
                     ],
+                    "itemClickEvent": "@config.itemClickEvent",
                     "maxInlineActions": "@config.maxInlineActions",
                     "minCardWidth": 260.0,
                     "type": "data-grid"
@@ -1467,7 +1641,8 @@
                           ]
                         ]
                       ],
-                      "fieldNames": "@config.detailFields",
+                      "closeEvent": "@config.detailCloseEvent",
+                      "fields": "@config.detailFields",
                       "initialData": "@payload.row",
                       "showActions": true,
                       "type": "detail-panel"
@@ -1671,6 +1846,7 @@
                             ]
                           ]
                         ],
+                        "itemClickEvent": "@config.itemClickEvent",
                         "maxInlineActions": "@config.maxInlineActions",
                         "type": "data-list",
                         "variant": "compact"
@@ -2259,12 +2435,60 @@
                     }
                   ],
                   [
-                    "render-ui",
-                    "main",
-                    {
-                      "rows": 4.0,
-                      "type": "skeleton"
-                    }
+                    "if",
+                    [
+                      "=",
+                      "@config.browseLook",
+                      "gallery"
+                    ],
+                    [
+                      "render-ui",
+                      "main",
+                      {
+                        "rows": 6.0,
+                        "type": "skeleton",
+                        "variant": "grid"
+                      }
+                    ],
+                    [
+                      "if",
+                      [
+                        "or",
+                        [
+                          "=",
+                          "@config.browseLook",
+                          "feed"
+                        ],
+                        [
+                          "=",
+                          "@config.browseLook",
+                          "master-detail"
+                        ],
+                        [
+                          "=",
+                          "@config.browseLook",
+                          "triage"
+                        ]
+                      ],
+                      [
+                        "render-ui",
+                        "main",
+                        {
+                          "rows": 6.0,
+                          "type": "skeleton",
+                          "variant": "list"
+                        }
+                      ],
+                      [
+                        "render-ui",
+                        "main",
+                        {
+                          "rows": 6.0,
+                          "type": "skeleton",
+                          "variant": "table"
+                        }
+                      ]
+                    ]
                   ]
                 ],
                 "event": "INIT",
@@ -2777,12 +3001,60 @@
                     }
                   ],
                   [
-                    "render-ui",
-                    "main",
-                    {
-                      "rows": 4.0,
-                      "type": "skeleton"
-                    }
+                    "if",
+                    [
+                      "=",
+                      "@config.browseLook",
+                      "gallery"
+                    ],
+                    [
+                      "render-ui",
+                      "main",
+                      {
+                        "rows": 6.0,
+                        "type": "skeleton",
+                        "variant": "grid"
+                      }
+                    ],
+                    [
+                      "if",
+                      [
+                        "or",
+                        [
+                          "=",
+                          "@config.browseLook",
+                          "feed"
+                        ],
+                        [
+                          "=",
+                          "@config.browseLook",
+                          "master-detail"
+                        ],
+                        [
+                          "=",
+                          "@config.browseLook",
+                          "triage"
+                        ]
+                      ],
+                      [
+                        "render-ui",
+                        "main",
+                        {
+                          "rows": 6.0,
+                          "type": "skeleton",
+                          "variant": "list"
+                        }
+                      ],
+                      [
+                        "render-ui",
+                        "main",
+                        {
+                          "rows": 6.0,
+                          "type": "skeleton",
+                          "variant": "table"
+                        }
+                      ]
+                    ]
                   ]
                 ],
                 "event": "INIT",
@@ -2863,6 +3135,18 @@
           {
             "name": "icon",
             "type": "string"
+          },
+          {
+            "name": "colorMap",
+            "type": "Map<string,BadgeColor>"
+          },
+          {
+            "name": "labels",
+            "type": "Map<string,string>"
+          },
+          {
+            "name": "variant",
+            "type": "string"
           }
         ],
         "FieldSpec": [
@@ -2894,6 +3178,14 @@
           {
             "name": "header",
             "type": "string"
+          },
+          {
+            "name": "colorMap",
+            "type": "Map<string,BadgeColor>"
+          },
+          {
+            "name": "labels",
+            "type": "Map<string,string>"
           }
         ],
         "FilterSpec": [

package/behaviors/registry/ui/core/atoms/std-calendar.orb

@@ -1452,22 +1452,8 @@
                     "render-ui",
                     "main",
                     {
-                      "align": "center",
-                      "children": [
-                        {
-                          "type": "spinner"
-                        },
-                        {
-                          "color": "muted",
-                          "content": "Loading calendar…",
-                          "type": "typography",
-                          "variant": "caption"
-                        }
-                      ],
-                      "className": "py-12",
-                      "direction": "vertical",
-                      "gap": "md",
-                      "type": "stack"
+                      "type": "skeleton",
+                      "variant": "card"
                     }
                   ]
                 ],
@@ -1577,7 +1563,8 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "spinner"
+                      "type": "skeleton",
+                      "variant": "card"
                     }
                   ]
                 ],
@@ -1824,7 +1811,8 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "spinner"
+                      "type": "skeleton",
+                      "variant": "card"
                     }
                   ]
                 ],
@@ -1850,7 +1838,8 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "spinner"
+                      "type": "skeleton",
+                      "variant": "card"
                     }
                   ]
                 ],

package/behaviors/registry/ui/core/atoms/std-detail-layout.orb

@@ -1,5 +1,5 @@
 {
-  "description": "std-detail-layout — detail-page chrome band (back button + navigation-stack breadcrumb trail) above a single contentTrait slot. Use as the contentTrait of a detail page's AppShell binding: the band renders `← Back | Contracts › Contract details` from the orbital-scoped client navigation stack (session history, seeded from declared page-path ancestry on cold loads — the trail is never empty), and the consumer's detail trait renders below it. Back pops the stack; crumb clicks navigate to their level; a list router's `(navigate path payload { crumb: ?row.title })` labels the detail crumb with the real record title. Bind once per detail page — `XDetailLayout = DetailShell.traits.DetailLayout` with `contentTrait: @trait.XDetail`.",
+  "description": "std-detail-layout — detail-page chrome band (back button + navigation-stack breadcrumb trail) above a single contentTrait slot. Use as the contentTrait of a detail page's AppShell binding: the band renders `Contracts › Contract details` (phones: `← Back`) from the orbital-scoped client navigation stack (session history, seeded from declared page-path ancestry on cold loads — the trail is never empty), and the consumer's detail trait renders below it. Back pops the stack; crumb clicks navigate to their level; a list router's `(navigate path payload { crumb: ?row.title })` labels the detail crumb with the real record title. Bind once per detail page — `XDetailLayout = DetailShell.traits.DetailLayout` with `contentTrait: @trait.XDetail`.",
   "ledger": {
     "entries": {
       "ent_01M0J07QZHFKDT9JQZ42HBVNQQ": {
@@ -213,6 +213,7 @@
                           "children": [
                             {
                               "action": "BACK",
+                              "className": "md:hidden",
                               "icon": "arrow-left",
                               "label": "@config.backLabel",
                               "size": "sm",
@@ -220,6 +221,7 @@
                               "variant": "ghost"
                             },
                             {
+                              "className": "hidden md:flex",
                               "fromNavStack": true,
                               "itemEvent": "CRUMB_NAV",
                               "type": "breadcrumb"

package/behaviors/registry/ui/core/atoms/std-esign-flow.orb

@@ -1161,21 +1161,19 @@
                     "render-ui",
                     "main",
                     {
-                      "align": "center",
                       "children": [
                         {
-                          "type": "spinner"
+                          "type": "skeleton",
+                          "variant": "header"
                         },
                         {
-                          "color": "muted",
-                          "content": "Loading signature requests…",
-                          "type": "typography",
-                          "variant": "caption"
+                          "rows": 6.0,
+                          "type": "skeleton",
+                          "variant": "grid"
                         }
                       ],
-                      "className": "py-12",
                       "direction": "vertical",
-                      "gap": "md",
+                      "gap": "lg",
                       "type": "stack"
                     }
                   ]
@@ -1366,7 +1364,20 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "spinner"
+                      "children": [
+                        {
+                          "type": "skeleton",
+                          "variant": "header"
+                        },
+                        {
+                          "rows": 6.0,
+                          "type": "skeleton",
+                          "variant": "grid"
+                        }
+                      ],
+                      "direction": "vertical",
+                      "gap": "lg",
+                      "type": "stack"
                     }
                   ]
                 ],
@@ -1391,7 +1402,20 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "spinner"
+                      "children": [
+                        {
+                          "type": "skeleton",
+                          "variant": "header"
+                        },
+                        {
+                          "rows": 6.0,
+                          "type": "skeleton",
+                          "variant": "grid"
+                        }
+                      ],
+                      "direction": "vertical",
+                      "gap": "lg",
+                      "type": "stack"
                     }
                   ]
                 ],
@@ -1416,7 +1440,20 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "spinner"
+                      "children": [
+                        {
+                          "type": "skeleton",
+                          "variant": "header"
+                        },
+                        {
+                          "rows": 6.0,
+                          "type": "skeleton",
+                          "variant": "grid"
+                        }
+                      ],
+                      "direction": "vertical",
+                      "gap": "lg",
+                      "type": "stack"
                     }
                   ]
                 ],

package/behaviors/registry/ui/core/atoms/std-esign-request.orb

@@ -617,8 +617,20 @@
                     "render-ui",
                     "main",
                     {
-                      "size": "md",
-                      "type": "spinner"
+                      "children": [
+                        {
+                          "type": "skeleton",
+                          "variant": "header"
+                        },
+                        {
+                          "rows": 6.0,
+                          "type": "skeleton",
+                          "variant": "grid"
+                        }
+                      ],
+                      "direction": "vertical",
+                      "gap": "lg",
+                      "type": "stack"
                     }
                   ]
                 ],
@@ -728,8 +740,20 @@
                     "render-ui",
                     "main",
                     {
-                      "size": "md",
-                      "type": "spinner"
+                      "children": [
+                        {
+                          "type": "skeleton",
+                          "variant": "header"
+                        },
+                        {
+                          "rows": 6.0,
+                          "type": "skeleton",
+                          "variant": "grid"
+                        }
+                      ],
+                      "direction": "vertical",
+                      "gap": "lg",
+                      "type": "stack"
                     }
                   ]
                 ],