@almadar/std 16.179.0 → 16.180.0

package/behaviors/lolo/ui/core/atoms/std-detail-layout.lolo

@@ -0,0 +1,82 @@
+app std-detail-layout "1.0.0"
+"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`."
+;; @capabilities "detail page shell, breadcrumb trail, back navigation, record detail chrome, navigation stack, drill-down hierarchy"
+orbital DetailLayoutOrbital {
+  entity DetailLayoutData [runtime] {
+    id : string!
+  }
+
+  trait DetailLayout -> @rebindable DetailLayoutData [interaction, instance] {
+    initial: composing
+
+    state composing {
+      INIT -> composing
+        (render-ui main {
+          type: stack
+          direction: vertical
+          gap: lg
+          className: "w-full"
+          children: [{
+            type: stack
+            direction: horizontal
+            align: center
+            gap: sm
+            className: "w-full border-b border-border pb-3"
+            children: [{
+              type: button
+              variant: ghost
+              size: sm
+              icon: arrow-left
+              label: @config.backLabel
+              action: BACK
+            }, {
+              type: breadcrumb
+              fromNavStack: true
+              itemEvent: CRUMB_NAV
+            }]
+          },
+          @config.contentTrait]
+        })
+      BACK -> composing
+        (navigate-back)
+      CRUMB_NAV -> composing
+        (navigate ?href)
+    }
+
+    emits {
+      BACK
+        @description "The shell's back affordance was pressed; the layout pops the navigation stack."
+        @synonyms "go back, return, previous page, up one level"
+        @tier "internal"
+      CRUMB_NAV
+        @description "A breadcrumb level was clicked; the layout navigates to that level's href."
+        @synonyms "breadcrumb click, jump to level, trail navigation"
+        @tier "internal"
+    }
+
+    listens {
+      CRUMB_NAV {
+        label : string
+        href : string!
+        index : number
+      }
+        @description "Breadcrumb level picked from the navigation-stack trail."
+        @synonyms "breadcrumb click, trail navigation"
+        @tier "internal"
+    }
+
+    config {
+      contentTrait : trait
+        @label "Content trait"
+        @description "The detail trait rendered below the navigation band (the DetailPanel + sections view)."
+        @tier "presentation"
+      backLabel : string = Back
+        @label "Back button label"
+        @description "Label on the band's back button, e.g. \"Back to contracts\"."
+        @synonyms "back text, return label"
+        @tier "presentation"
+    }
+  }
+
+  page "/detail-layout" as DetailLayoutPage -> DetailLayout
+}

package/behaviors/lolo/ui/core/molecules/ui-breadcrumb.lolo

@@ -21,6 +21,8 @@ orbital BreadcrumbOrbital {
       INIT -> idle
         (render-ui main {
           items: @config.items
+          fromNavStack: @config.fromNavStack
+          itemEvent: @config.itemEvent
           separator: @config.separator
           maxItems: @config.maxItems
           className: @config.className
@@ -28,10 +30,26 @@ orbital BreadcrumbOrbital {
         })
     }
 
+    emits {
+      @config.itemEvent -> external {
+        id : string
+      }
+        @description "Event emitted when a non-current crumb is clicked, with payload `{ label, href, index }` — the trait handles it with `(navigate ?href)`. Without it, stack crumbs navigate directly."
+        @tier "essential"
+    }
+
     config {
-      items : [BreadcrumbItemsItem] = [{ label: "Label", href: "Href", path: "Path", icon: "circle", isCurrent: false }, { label: "Label 2", href: "Href 2", path: "Path 2", icon: "circle", isCurrent: true }]
+      items : [BreadcrumbItemsItem] = []
         @label "Items"
-        @description "Breadcrumb items"
+        @description "Breadcrumb items. Omit together with `fromNavStack` to render the orbital-scoped navigation stack instead of an authored trail."
+        @tier "presentation"
+      fromNavStack : boolean = false
+        @label "From Nav Stack"
+        @description "Render the current orbital's navigation stack (NavStackProvider) as the trail: one crumb per visited/declared level, last entry current. The stack is client-session state both execution paths maintain; outside a provider this renders nothing."
+        @tier "presentation"
+      itemEvent : string = "ITEM"
+        @label "Item Event"
+        @description "Event emitted when a non-current crumb is clicked, with payload `{ label, href, index }` — the trait handles it with `(navigate ?href)`. Without it, stack crumbs navigate directly."
         @tier "presentation"
       separator : icon
         @label "Separator"

package/behaviors/lolo/ui/core/organisms/ui-detail-panel.lolo

@@ -79,6 +79,7 @@ orbital DetailPanelOrbital {
           avatar: @config.avatar
           sections: @config.sections
           actions: @config.actions
+          maxInlineActions: @config.maxInlineActions
           backAction: @config.backAction
           footer: @config.footer
           slideOver: @config.slideOver
@@ -113,6 +114,7 @@ orbital DetailPanelOrbital {
           avatar: @config.avatar
           sections: @config.sections
           actions: @config.actions
+          maxInlineActions: @config.maxInlineActions
           backAction: @config.backAction
           footer: @config.footer
           slideOver: @config.slideOver
@@ -206,6 +208,10 @@ orbital DetailPanelOrbital {
         @label "Actions"
         @description "Unified actions array - first action with variant='primary' is the main action"
         @tier "presentation"
+      maxInlineActions : number
+        @label "Max Inline Actions"
+        @description "Max inline action buttons before the rest collapse into a '⋯' overflow menu (mirrors DataGrid's maxInlineActions). Omit = all inline."
+        @tier "presentation"
       backAction : DetailPanelBackAction
         @label "Back Action"
         @description "Navigation-back affordance. Renders top-LEFT before the title (OS/back convention — Almadar_UX §8.4), spatially separated from the right-aligned action buttons + close X. Never inferred from actions[] labels."

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

@@ -0,0 +1,265 @@
+{
+  "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`.",
+  "ledger": {
+    "entries": {
+      "ent_01M0J07QZHFKDT9JQZ42HBVNQQ": {
+        "bakedName": "DetailLayoutData",
+        "curName": "DetailLayoutData",
+        "id": "ent_01M0J07QZHFKDT9JQZ42HBVNQQ",
+        "kind": "entity",
+        "owner": "workspace",
+        "renames": []
+      },
+      "evt_01M0J07QZHF7RM3JBVCVWSV7B4": {
+        "bakedName": "INIT",
+        "curName": "INIT",
+        "id": "evt_01M0J07QZHF7RM3JBVCVWSV7B4",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M0J07QZH6N0G9CKFXKBJ3AC6",
+        "renames": []
+      },
+      "evt_01M0J07QZKCG5P5AGK0VHN2N9G": {
+        "bakedName": "BACK",
+        "curName": "BACK",
+        "id": "evt_01M0J07QZKCG5P5AGK0VHN2N9G",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M0J07QZH6N0G9CKFXKBJ3AC6",
+        "renames": []
+      },
+      "evt_01M0J07QZKF2YJ9MMQ69KZ3CVB": {
+        "bakedName": "CRUMB_NAV",
+        "curName": "CRUMB_NAV",
+        "id": "evt_01M0J07QZKF2YJ9MMQ69KZ3CVB",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M0J07QZH6N0G9CKFXKBJ3AC6",
+        "renames": []
+      },
+      "orb_01M0J07QZHNJF5BJSSEKF13PVV": {
+        "bakedName": "DetailLayoutOrbital",
+        "curName": "DetailLayoutOrbital",
+        "id": "orb_01M0J07QZHNJF5BJSSEKF13PVV",
+        "kind": "orbital",
+        "owner": "workspace",
+        "renames": []
+      },
+      "pag_01M0J07QZKPKTYGMZR1DDDDFC1": {
+        "bakedName": "DetailLayoutPage",
+        "curName": "DetailLayoutPage",
+        "id": "pag_01M0J07QZKPKTYGMZR1DDDDFC1",
+        "kind": "page",
+        "owner": "workspace",
+        "renames": []
+      },
+      "trt_01M0J07QZH6N0G9CKFXKBJ3AC6": {
+        "bakedName": "DetailLayout",
+        "curName": "DetailLayout",
+        "id": "trt_01M0J07QZH6N0G9CKFXKBJ3AC6",
+        "kind": "trait",
+        "owner": "workspace",
+        "renames": []
+      }
+    },
+    "schemaVersion": 1
+  },
+  "name": "std-detail-layout",
+  "orbitals": [
+    {
+      "entity": {
+        "fields": [
+          {
+            "name": "id",
+            "required": true,
+            "type": "string"
+          }
+        ],
+        "id": "ent_01M0J07QZHFKDT9JQZ42HBVNQQ",
+        "name": "DetailLayoutData",
+        "persistence": "runtime"
+      },
+      "id": "orb_01M0J07QZHNJF5BJSSEKF13PVV",
+      "name": "DetailLayoutOrbital",
+      "pages": [
+        {
+          "id": "pag_01M0J07QZKPKTYGMZR1DDDDFC1",
+          "name": "DetailLayoutPage",
+          "path": "/detail-layout",
+          "traits": [
+            {
+              "ref": "DetailLayout",
+              "refId": "trt_01M0J07QZH6N0G9CKFXKBJ3AC6"
+            }
+          ]
+        }
+      ],
+      "traits": [
+        {
+          "category": "interaction",
+          "config": {
+            "backLabel": {
+              "default": "Back",
+              "description": "Label on the band's back button, e.g. \"Back to contracts\".",
+              "label": "Back button label",
+              "synonyms": "back text, return label",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "contentTrait": {
+              "description": "The detail trait rendered below the navigation band (the DetailPanel + sections view).",
+              "label": "Content trait",
+              "tier": "presentation",
+              "type": "trait"
+            }
+          },
+          "emits": [
+            {
+              "description": "The shell's back affordance was pressed; the layout pops the navigation stack.",
+              "event": "BACK",
+              "eventId": "evt_01M0J07QZKCG5P5AGK0VHN2N9G",
+              "synonyms": "go back, return, previous page, up one level",
+              "tier": "internal"
+            },
+            {
+              "description": "A breadcrumb level was clicked; the layout navigates to that level's href.",
+              "event": "CRUMB_NAV",
+              "eventId": "evt_01M0J07QZKF2YJ9MMQ69KZ3CVB",
+              "synonyms": "breadcrumb click, jump to level, trail navigation",
+              "tier": "internal"
+            }
+          ],
+          "entityContract": {
+            "provides": [],
+            "requires": []
+          },
+          "entityRebindable": true,
+          "entityRefIds": {
+            "DetailLayoutData": "ent_01M0J07QZHFKDT9JQZ42HBVNQQ"
+          },
+          "id": "trt_01M0J07QZH6N0G9CKFXKBJ3AC6",
+          "linkedEntity": "DetailLayoutData",
+          "linkedEntityId": "ent_01M0J07QZHFKDT9JQZ42HBVNQQ",
+          "name": "DetailLayout",
+          "scope": "instance",
+          "stateMachine": {
+            "events": [
+              {
+                "id": "evt_01M0J07QZHF7RM3JBVCVWSV7B4",
+                "key": "INIT",
+                "name": "Initialize"
+              },
+              {
+                "description": "The shell's back affordance was pressed; the layout pops the navigation stack.",
+                "id": "evt_01M0J07QZKCG5P5AGK0VHN2N9G",
+                "key": "BACK",
+                "name": "Back",
+                "synonyms": "go back, return, previous page, up one level",
+                "tier": "internal"
+              },
+              {
+                "description": "A breadcrumb level was clicked; the layout navigates to that level's href.",
+                "id": "evt_01M0J07QZKF2YJ9MMQ69KZ3CVB",
+                "key": "CRUMB_NAV",
+                "name": "Crumb Nav",
+                "payloadSchema": [
+                  {
+                    "name": "label",
+                    "type": "string"
+                  },
+                  {
+                    "name": "href",
+                    "required": true,
+                    "type": "string"
+                  },
+                  {
+                    "name": "index",
+                    "type": "number"
+                  }
+                ],
+                "synonyms": "breadcrumb click, jump to level, trail navigation",
+                "tier": "internal"
+              }
+            ],
+            "states": [
+              {
+                "isInitial": true,
+                "name": "composing"
+              }
+            ],
+            "transitions": [
+              {
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "children": [
+                        {
+                          "align": "center",
+                          "children": [
+                            {
+                              "action": "BACK",
+                              "icon": "arrow-left",
+                              "label": "@config.backLabel",
+                              "size": "sm",
+                              "type": "button",
+                              "variant": "ghost"
+                            },
+                            {
+                              "fromNavStack": true,
+                              "itemEvent": "CRUMB_NAV",
+                              "type": "breadcrumb"
+                            }
+                          ],
+                          "className": "w-full border-b border-border pb-3",
+                          "direction": "horizontal",
+                          "gap": "sm",
+                          "type": "stack"
+                        },
+                        "@config.contentTrait"
+                      ],
+                      "className": "w-full",
+                      "direction": "vertical",
+                      "gap": "lg",
+                      "type": "stack"
+                    }
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01M0J07QZHF7RM3JBVCVWSV7B4",
+                "from": "composing",
+                "to": "composing"
+              },
+              {
+                "effects": [
+                  [
+                    "navigate-back"
+                  ]
+                ],
+                "event": "BACK",
+                "eventId": "evt_01M0J07QZKCG5P5AGK0VHN2N9G",
+                "from": "composing",
+                "to": "composing"
+              },
+              {
+                "effects": [
+                  [
+                    "navigate",
+                    "@payload.href"
+                  ]
+                ],
+                "event": "CRUMB_NAV",
+                "eventId": "evt_01M0J07QZKF2YJ9MMQ69KZ3CVB",
+                "from": "composing",
+                "to": "composing"
+              }
+            ]
+          }
+        }
+      ]
+    }
+  ],
+  "schemaVersion": 1,
+  "version": "1.0.0"
+}

package/behaviors/registry/ui/core/molecules/ui-breadcrumb.orb

@@ -19,6 +19,15 @@
         "parent": "trt_01KXG04MX6C96QT73HKMXSSXW9",
         "renames": []
       },
+      "evt_01M0HZ7JXZT1B3WE2JVP75FDGK": {
+        "bakedName": "@config.itemEvent",
+        "curName": "@config.itemEvent",
+        "id": "evt_01M0HZ7JXZT1B3WE2JVP75FDGK",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KXG04MX6C96QT73HKMXSSXW9",
+        "renames": []
+      },
       "orb_01KXG04MX6C39A82D7NECQJ0X8": {
         "bakedName": "BreadcrumbOrbital",
         "curName": "BreadcrumbOrbital",
@@ -86,24 +95,23 @@
               "tier": "presentation",
               "type": "string"
             },
+            "fromNavStack": {
+              "default": false,
+              "description": "Render the current orbital's navigation stack (NavStackProvider) as the trail: one crumb per visited/declared level, last entry current. The stack is client-session state both execution paths maintain; outside a provider this renders nothing.",
+              "label": "From Nav Stack",
+              "tier": "presentation",
+              "type": "boolean"
+            },
+            "itemEvent": {
+              "default": "ITEM",
+              "description": "Event emitted when a non-current crumb is clicked, with payload `{ label, href, index }` — the trait handles it with `(navigate ?href)`. Without it, stack crumbs navigate directly.",
+              "label": "Item Event",
+              "tier": "presentation",
+              "type": "string"
+            },
             "items": {
-              "default": [
-                {
-                  "href": "Href",
-                  "icon": "circle",
-                  "isCurrent": false,
-                  "label": "Label",
-                  "path": "Path"
-                },
-                {
-                  "href": "Href 2",
-                  "icon": "circle",
-                  "isCurrent": true,
-                  "label": "Label 2",
-                  "path": "Path 2"
-                }
-              ],
-              "description": "Breadcrumb items",
+              "default": [],
+              "description": "Breadcrumb items. Omit together with `fromNavStack` to render the orbital-scoped navigation stack instead of an authored trail.",
               "items": {
                 "properties": {
                   "event": {
@@ -156,6 +164,21 @@
               "type": "icon"
             }
           },
+          "emits": [
+            {
+              "description": "Event emitted when a non-current crumb is clicked, with payload `{ label, href, index }` — the trait handles it with `(navigate ?href)`. Without it, stack crumbs navigate directly.",
+              "event": "@config.itemEvent",
+              "eventId": "evt_01M0HZ7JXZT1B3WE2JVP75FDGK",
+              "payloadSchema": [
+                {
+                  "name": "id",
+                  "type": "string"
+                }
+              ],
+              "scope": "external",
+              "tier": "essential"
+            }
+          ],
           "entityContract": {
             "provides": [],
             "requires": []
@@ -175,6 +198,19 @@
                 "id": "evt_01KXG04MX61JX4AMH0MQK0YQ6W",
                 "key": "INIT",
                 "name": "Initialize"
+              },
+              {
+                "description": "Event emitted when a non-current crumb is clicked, with payload `{ label, href, index }` — the trait handles it with `(navigate ?href)`. Without it, stack crumbs navigate directly.",
+                "id": "evt_01M0HZ7JXZT1B3WE2JVP75FDGK",
+                "key": "@config.itemEvent",
+                "name": "@config.item event",
+                "payloadSchema": [
+                  {
+                    "name": "id",
+                    "type": "string"
+                  }
+                ],
+                "tier": "essential"
               }
             ],
             "states": [
@@ -191,6 +227,8 @@
                     "main",
                     {
                       "className": "@config.className",
+                      "fromNavStack": "@config.fromNavStack",
+                      "itemEvent": "@config.itemEvent",
                       "items": "@config.items",
                       "maxItems": "@config.maxItems",
                       "separator": "@config.separator",

package/behaviors/registry/ui/core/organisms/ui-detail-panel.orb

@@ -315,6 +315,12 @@
               "tier": "presentation",
               "type": "boolean"
             },
+            "maxInlineActions": {
+              "description": "Max inline action buttons before the rest collapse into a '⋯' overflow menu (mirrors DataGrid's maxInlineActions). Omit = all inline.",
+              "label": "Max Inline Actions",
+              "tier": "presentation",
+              "type": "number"
+            },
             "mode": {
               "description": "Display mode (passed by compiler)",
               "label": "Mode",
@@ -609,6 +615,7 @@
                       "footer": "@config.footer",
                       "initialData": "@entity",
                       "isLoading": "@config.isLoading",
+                      "maxInlineActions": "@config.maxInlineActions",
                       "mode": "@config.mode",
                       "page": "@config.pageProp",
                       "pageSize": "@config.pageSize",
@@ -654,6 +661,7 @@
                       "footer": "@config.footer",
                       "initialData": "@payload.data",
                       "isLoading": "@config.isLoading",
+                      "maxInlineActions": "@config.maxInlineActions",
                       "mode": "@config.mode",
                       "page": "@config.pageProp",
                       "pageSize": "@config.pageSize",

package/canonical-operators.json

@@ -1929,15 +1929,27 @@
     "navigate": {
       "category": "effect",
       "minArity": 1,
-      "maxArity": 2,
+      "maxArity": 3,
       "returnType": "void",
-      "description": "Navigate to a route",
+      "description": "Navigate to a route: (navigate path payload? options?) — options carries { crumb } labelling the navigation-stack entry for the target page",
       "module": "core",
       "hasSideEffects": true,
       "effect": {
         "kind": "navigate"
       }
     },
+    "navigate-back": {
+      "category": "effect",
+      "minArity": 0,
+      "maxArity": 0,
+      "returnType": "void",
+      "description": "Pop the orbital-scoped navigation stack and return to the previous entry",
+      "module": "core",
+      "hasSideEffects": true,
+      "effect": {
+        "kind": "navigate-back"
+      }
+    },
     "nn/batchnorm": {
       "category": "ml-arch",
       "minArity": 1,