@almadar/std 16.238.0 → 16.239.0

package/behaviors/registry/ui/avl/atoms/ui-avl-glyph.orb

@@ -187,6 +187,7 @@
               ]
             },
             "effectType": {
+              "default": "set",
               "description": "Effect symbol variant. @default 'set'",
               "label": "Effect Type",
               "tier": "presentation",
@@ -358,6 +359,24 @@
                 "lg"
               ]
             },
+            "skeleton": {
+              "description": "Skeleton shown while this element's server render is in flight: a shape (`table`, `list`, …), `{ variant, rows?, columns?, fields? }`, or `none`.",
+              "label": "Skeleton",
+              "tier": "presentation",
+              "type": "string",
+              "values": [
+                "header",
+                "table",
+                "list",
+                "grid",
+                "detail",
+                "stats",
+                "form",
+                "card",
+                "text",
+                "none"
+              ]
+            },
             "tabIndex": {
               "description": "0 puts the element in the Tab order; -1 makes it focusable only programmatically.",
               "label": "Tab Index",
@@ -426,6 +445,7 @@
                       "role": "@config.role",
                       "showCaption": "@config.showCaption",
                       "size": "@config.size",
+                      "skeleton": "@config.skeleton",
                       "tabIndex": "@config.tabIndex",
                       "type": "avl-glyph"
                     }

package/behaviors/registry/ui/avl/atoms/ui-avl-state-machine.orb

@@ -388,6 +388,24 @@
               "tier": "presentation",
               "type": "boolean"
             },
+            "skeleton": {
+              "description": "Skeleton shown while this element's server render is in flight: a shape (`table`, `list`, …), `{ variant, rows?, columns?, fields? }`, or `none`.",
+              "label": "Skeleton",
+              "tier": "presentation",
+              "type": "string",
+              "values": [
+                "header",
+                "table",
+                "list",
+                "grid",
+                "detail",
+                "stats",
+                "form",
+                "card",
+                "text",
+                "none"
+              ]
+            },
             "stateClickEvent": {
               "default": "STATE_CLICK",
               "description": "Emits UI:{stateClickEvent} with { stateId } when a state is clicked.",
@@ -870,6 +888,7 @@
                       "role": "@config.role",
                       "selectedState": "@config.selectedState",
                       "showHeader": "@config.showHeader",
+                      "skeleton": "@config.skeleton",
                       "stateClickEvent": "@config.stateClickEvent",
                       "tabIndex": "@config.tabIndex",
                       "trait": "@config.traitProp",

package/behaviors/registry/ui/core/atoms/std-billable-hour.orb

@@ -490,6 +490,13 @@
               "tier": "presentation",
               "type": "[ItemAction]"
             },
+            "showHeader": {
+              "default": true,
+              "description": "Off when the page already carries a page header naming the same thing, so the page shows one title.",
+              "label": "Show the list's own title row?",
+              "tier": "presentation",
+              "type": "boolean"
+            },
             "statLook": {
               "default": "elevated",
               "description": "Layer 2 visual treatment for stat / KPI cards.",
@@ -1048,27 +1055,43 @@
                     "main",
                     {
                       "children": [
-                        {
-                          "align": "center",
-                          "children": [
-                            {
-                              "name": "clock",
-                              "size": "lg",
-                              "type": "icon"
-                            },
-                            {
-                              "content": "@config.title",
-                              "type": "typography",
-                              "variant": "h3"
-                            }
-                          ],
-                          "direction": "horizontal",
-                          "gap": "sm",
-                          "type": "stack"
-                        },
-                        {
-                          "type": "divider"
-                        },
+                        [
+                          "if",
+                          "@config.showHeader",
+                          {
+                            "children": [
+                              {
+                                "align": "center",
+                                "children": [
+                                  {
+                                    "name": "clock",
+                                    "size": "lg",
+                                    "type": "icon"
+                                  },
+                                  {
+                                    "content": "@config.title",
+                                    "type": "typography",
+                                    "variant": "h3"
+                                  }
+                                ],
+                                "direction": "horizontal",
+                                "gap": "sm",
+                                "type": "stack"
+                              },
+                              {
+                                "type": "divider"
+                              }
+                            ],
+                            "direction": "vertical",
+                            "gap": "md",
+                            "type": "stack"
+                          },
+                          {
+                            "children": [],
+                            "gap": "none",
+                            "type": "stack"
+                          }
+                        ],
                         {
                           "children": [
                             "@trait.DenseHoursTable"

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

@@ -210,13 +210,17 @@
               "type": "unknown"
             },
             "maxInlineActions": {
-              "default": "@config.maxInlineActions",
+              "default": 0.0,
               "type": "unknown"
             },
             "selfFetch": {
               "default": false,
               "type": "unknown"
             },
+            "surface": {
+              "default": "none",
+              "type": "unknown"
+            },
             "variant": {
               "default": "compact",
               "type": "unknown"
@@ -245,13 +249,6 @@
         {
           "category": "interaction",
           "config": {
-            "badgeBinding": {
-              "default": "@item.status",
-              "description": "Binding path for the status/badge slot.",
-              "label": "Badge field binding",
-              "tier": "internal",
-              "type": "string"
-            },
             "bodyContent": {
               "default": {
                 "children": [
@@ -354,6 +351,7 @@
                     "itemClickEvent": "@config.itemClickEvent",
                     "maxInlineActions": "@config.maxInlineActions",
                     "pageSize": "@config.displayPageSize",
+                    "surface": "@config.surface",
                     "type": "data-grid"
                   }
                 ],
@@ -388,13 +386,6 @@
                 "triage"
               ]
             },
-            "categoryBinding": {
-              "default": "@item.category",
-              "description": "Binding path for the category/tag slot.",
-              "label": "Category field binding",
-              "tier": "internal",
-              "type": "string"
-            },
             "cols": {
               "default": 1.0,
               "description": "Number of columns in the responsive card/grid layout.",
@@ -641,6 +632,7 @@
                         "maxInlineActions": "@config.maxInlineActions",
                         "pageSize": "@config.displayPageSize",
                         "selectable": "@config.selectable",
+                        "surface": "none",
                         "type": "table-view"
                       }
                     ],
@@ -650,7 +642,16 @@
                     "type": "stack"
                   }
                 ],
-                "className": "rounded-lg border border-[var(--color-border)] bg-[var(--color-card)] shadow-sm overflow-hidden",
+                "className": [
+                  "if",
+                  [
+                    "=",
+                    "@config.surface",
+                    "auto"
+                  ],
+                  "surface-content overflow-hidden",
+                  ""
+                ],
                 "direction": "vertical",
                 "gap": "none",
                 "type": "stack"
@@ -660,13 +661,6 @@
               "tier": "internal",
               "type": "render-ui"
             },
-            "descriptionBinding": {
-              "default": "@item.description",
-              "description": "Binding path for the card body/subtitle slot.",
-              "label": "Description field binding",
-              "tier": "internal",
-              "type": "string"
-            },
             "detailActions": {
               "default": [
                 {
@@ -779,6 +773,8 @@
                     "type": "string",
                     "values": [
                       "date",
+                      "time",
+                      "datetime",
                       "currency",
                       "number",
                       "boolean",
@@ -825,6 +821,8 @@
                     "values": [
                       "h3",
                       "h4",
+                      "overline",
+                      "avatar",
                       "body",
                       "caption",
                       "badge",
@@ -936,8 +934,8 @@
                     "emptyIcon": "@config.emptyIcon",
                     "emptyTitle": "@config.emptyTitle",
                     "entity": "@payload.data",
-                    "fields": [],
-                    "gap": "md",
+                    "fields": "@config.fields",
+                    "gap": "none",
                     "itemActions": [
                       "array/filter",
                       "@config.itemActions",
@@ -973,94 +971,39 @@
                       ]
                     ],
                     "itemClickEvent": "@config.itemClickEvent",
-                    "renderItem": [
-                      "fn",
-                      "item",
-                      {
-                        "children": [
-                          {
-                            "align": "start",
-                            "children": [
-                              {
-                                "className": "rounded-full flex-shrink-0",
-                                "fallback": "@config.titleBinding",
-                                "size": "md",
-                                "type": "avatar"
-                              },
-                              {
-                                "children": [
-                                  {
-                                    "align": "center",
-                                    "children": [
-                                      {
-                                        "className": "truncate",
-                                        "content": "@config.titleBinding",
-                                        "type": "typography",
-                                        "variant": "body",
-                                        "weight": "medium"
-                                      },
-                                      {
-                                        "label": "@config.categoryBinding",
-                                        "size": "sm",
-                                        "type": "badge",
-                                        "variant": "neutral"
-                                      }
-                                    ],
-                                    "className": "flex-wrap",
-                                    "direction": "horizontal",
-                                    "gap": "xs",
-                                    "type": "stack"
-                                  },
-                                  {
-                                    "className": "text-[var(--color-foreground)] whitespace-pre-wrap break-words leading-relaxed",
-                                    "content": "@config.descriptionBinding",
-                                    "type": "typography",
-                                    "variant": "body"
-                                  },
-                                  {
-                                    "align": "center",
-                                    "children": [
-                                      {
-                                        "color": "muted",
-                                        "content": "@config.metaBinding",
-                                        "format": "@config.metaFormat",
-                                        "type": "typography",
-                                        "variant": "caption"
-                                      },
-                                      {
-                                        "label": "@config.badgeBinding",
-                                        "size": "sm",
-                                        "type": "badge",
-                                        "variant": "default"
-                                      }
-                                    ],
-                                    "className": "pt-1",
-                                    "direction": "horizontal",
-                                    "gap": "sm",
-                                    "justify": "between",
-                                    "type": "stack"
-                                  }
-                                ],
-                                "className": "flex-1 min-w-0",
-                                "direction": "vertical",
-                                "gap": "xs",
-                                "type": "stack"
-                              }
-                            ],
-                            "className": "p-card-md",
-                            "direction": "horizontal",
-                            "gap": "md",
-                            "type": "stack"
-                          }
-                        ],
-                        "className": "rounded-lg bg-[var(--color-card)] border border-[var(--color-border)] shadow-sm transition-all duration-normal hover:shadow-main hover:border-[var(--color-border-strong)] hover:-translate-y-px",
-                        "look": "flat-bordered",
-                        "padding": "none",
-                        "type": "card"
-                      }
+                    "look": [
+                      "if",
+                      [
+                        "=",
+                        "@config.feedSurface",
+                        "cards"
+                      ],
+                      "card-rows",
+                      "borderless"
+                    ],
+                    "maxInlineActions": "@config.maxInlineActions",
+                    "pageSize": "@config.displayPageSize",
+                    "surface": [
+                      "if",
+                      [
+                        "=",
+                        "@config.feedSurface",
+                        "plain"
+                      ],
+                      "none",
+                      "@config.surface"
                     ],
                     "type": "data-list",
-                    "variant": "card"
+                    "variant": [
+                      "if",
+                      [
+                        "=",
+                        "@config.feedSurface",
+                        "divided"
+                      ],
+                      "card",
+                      "default"
+                    ]
                   }
                 ],
                 "className": "w-full",
@@ -1068,11 +1011,24 @@
                 "gap": "lg",
                 "type": "stack"
               },
-              "description": "Render-ui SExpr rendered after rows load when browseLook = feed. Chronological card-per-item stream with avatar, title, meta, body, timestamp; composes titleBinding/descriptionBinding/categoryBinding/badgeBinding/metaBinding/searchPlaceholder/itemActions. Folded from std-browse-feed (Phase 5.B).",
+              "description": "Render-ui SExpr rendered after rows load when browseLook = feed. Chronological item stream on the same `fields` contract every look reads (roles: overline, h3/h4, caption, small/body, badge, avatar), separated per feedSurface. Folded from std-browse-feed (Phase 5.B).",
               "label": "Feed look body",
               "tier": "internal",
               "type": "render-ui"
             },
+            "feedSurface": {
+              "default": "cards",
+              "description": "browseLook = feed only. cards = each item its own raised card with space between (community posts, listings); divided = one surface with hairline rows (inboxes, answer lists, notes); plain = no chrome, items on the page background (editorial article lists, changelogs). What each item shows comes from `fields`: overline = eyebrow above the title, h3/h4 = title (its `icon` becomes a leading tile), caption = prose, small/body = meta line, badge = pill, avatar = leading initials.",
+              "label": "How are feed items separated?",
+              "synonyms": "feed style, item chrome, card per item, divided list, editorial list, rows or cards",
+              "tier": "presentation",
+              "type": "string",
+              "values": [
+                "cards",
+                "divided",
+                "plain"
+              ]
+            },
             "fields": {
               "default": [
                 {
@@ -1120,6 +1076,8 @@
                     "type": "string",
                     "values": [
                       "date",
+                      "time",
+                      "datetime",
                       "currency",
                       "number",
                       "boolean",
@@ -1166,6 +1124,8 @@
                     "values": [
                       "h3",
                       "h4",
+                      "overline",
+                      "avatar",
                       "body",
                       "caption",
                       "badge",
@@ -1332,6 +1292,7 @@
                     "itemClickEvent": "@config.itemClickEvent",
                     "maxInlineActions": "@config.maxInlineActions",
                     "minCardWidth": 260.0,
+                    "surface": "@config.surface",
                     "type": "data-grid"
                   }
                 ],
@@ -1537,7 +1498,16 @@
                     "type": "master-detail-layout"
                   }
                 ],
-                "className": "rounded-lg border border-[var(--color-border)] bg-[var(--color-card)] shadow-sm overflow-hidden",
+                "className": [
+                  "if",
+                  [
+                    "=",
+                    "@config.surface",
+                    "auto"
+                  ],
+                  "surface-content overflow-hidden",
+                  ""
+                ],
                 "direction": "vertical",
                 "gap": "none",
                 "type": "stack"
@@ -1645,6 +1615,7 @@
                       "fields": "@config.detailFields",
                       "initialData": "@payload.row",
                       "showActions": true,
+                      "surface": "none",
                       "type": "detail-panel"
                     },
                     "hasSelection": true,
@@ -1660,7 +1631,16 @@
                     "type": "master-detail-layout"
                   }
                 ],
-                "className": "rounded-lg border border-[var(--color-border)] bg-[var(--color-card)] shadow-sm overflow-hidden",
+                "className": [
+                  "if",
+                  [
+                    "=",
+                    "@config.surface",
+                    "auto"
+                  ],
+                  "surface-content overflow-hidden",
+                  ""
+                ],
                 "direction": "vertical",
                 "gap": "none",
                 "type": "stack"
@@ -1678,27 +1658,6 @@
               "tier": "presentation",
               "type": "number"
             },
-            "metaBinding": {
-              "default": "@item.createdAt",
-              "description": "Binding path for the secondary meta slot (timestamp / category). Hosts binding a count or other non-date value should label it in the binding itself (e.g. (str/concat \"Vehicles: \" @item.vehicleCount)) and set metaFormat: none.",
-              "label": "Meta field binding",
-              "tier": "internal",
-              "type": "string"
-            },
-            "metaFormat": {
-              "default": "date",
-              "description": "Typography format for the feed meta slot — date by default so the createdAt binding renders human-readable instead of raw ISO; set none for non-date bindings.",
-              "label": "Meta value format",
-              "tier": "presentation",
-              "type": "string",
-              "values": [
-                "none",
-                "date",
-                "time",
-                "datetime",
-                "number"
-              ]
-            },
             "pageSize": {
               "default": 10.0,
               "description": "Records fetched from the server per page request.",
@@ -1739,12 +1698,17 @@
               "tier": "presentation",
               "type": "boolean"
             },
-            "titleBinding": {
-              "default": "@item.name",
-              "description": "Binding path for the card title slot (e.g. @item.dishName).",
-              "label": "Title field binding",
-              "tier": "internal",
-              "type": "string"
+            "surface": {
+              "default": "auto",
+              "description": "auto (default) draws the theme's content surface behind every look — on a patterned page background the list reads as one block; the theme decides how that surface looks. none places the list directly on the page (e.g. a list already inside a card or panel you composed).",
+              "label": "Paint a surface behind the list?",
+              "synonyms": "card background, panel, container, list background, no background, transparent, bare",
+              "tier": "presentation",
+              "type": "string",
+              "values": [
+                "auto",
+                "none"
+              ]
             },
             "triageBodyContent": {
               "default": {
@@ -1848,6 +1812,8 @@
                         ],
                         "itemClickEvent": "@config.itemClickEvent",
                         "maxInlineActions": "@config.maxInlineActions",
+                        "pageSize": "@config.displayPageSize",
+                        "surface": "none",
                         "type": "data-list",
                         "variant": "compact"
                       }
@@ -1858,7 +1824,16 @@
                     "type": "stack"
                   }
                 ],
-                "className": "rounded-lg border border-[var(--color-border)] bg-[var(--color-card)] shadow-sm overflow-hidden",
+                "className": [
+                  "if",
+                  [
+                    "=",
+                    "@config.surface",
+                    "auto"
+                  ],
+                  "surface-content overflow-hidden",
+                  ""
+                ],
                 "direction": "vertical",
                 "gap": "none",
                 "type": "stack"

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

@@ -1,5 +1,5 @@
 {
-  "description": "std-graphs — embeddable chart atom. ITEMS_LOADED keeps the rows whose @config.filterField equals @config.filterValue (blank = all), groups them by @config.categoryField, or (timeAxis=true) by the @config.period bucket of @config.timeField — rows without a time value have no place on a time axis and are left out — and aggregates per bucket. Multi-series rendering via @config.series (preformatted ChartSeries shape). Histograms via chartType=histogram pass pre-binned @payload.data through unchanged. Stacked / 100% stacked bars via @config.stack. Post-process sort + limit. Clicking a data point emits UI:@config.drillEvent with { label, value, seriesLabel? }. Drop into a dashboard alongside std-stats / std-browse.",
+  "description": "std-graphs — embeddable chart atom. ITEMS_LOADED keeps the rows whose @config.filterField equals @config.filterValue (blank = all), groups them by @config.categoryField, or (timeAxis=true) by the @config.period bucket of @config.timeField — rows without a time value (or, by category, without a category value) have no bucket to land in and are left out — and aggregates per bucket. Multi-series rendering via @config.series (preformatted ChartSeries shape). Histograms via chartType=histogram pass pre-binned @payload.data through unchanged. Stacked / 100% stacked bars via @config.stack. Post-process sort + limit. Clicking a data point emits UI:@config.drillEvent with { label, value, seriesLabel? }. Drop into a dashboard alongside std-stats / std-browse.",
   "ledger": {
     "entries": {
       "ent_01KXG04GN3VS5JTJHRM5AAK86J": {
@@ -585,7 +585,19 @@
                               ],
                               [
                                 "array/groupBy",
-                                "@rows",
+                                [
+                                  "array/filter",
+                                  "@rows",
+                                  [
+                                    "fn",
+                                    "row",
+                                    [
+                                      "object/get",
+                                      "@row",
+                                      "@config.categoryField"
+                                    ]
+                                  ]
+                                ],
                                 "@config.categoryField"
                               ]
                             ]