@almadar/std 16.179.0 → 16.181.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/atoms/ui-badge.lolo

@@ -39,14 +39,6 @@ orbital BadgeOrbital {
         })
     }
 
-    emits {
-      @config.onRemove -> external {
-        id : string
-      }
-        @description "When set, renders a small X button on the right of the badge that invokes this handler — turns the badge into a removable chip. Used by the TagInput molecule and other 'list of removable values' surfaces."
-        @tier "essential"
-    }
-
     config {
       className : string
         @label "Class Name"
@@ -76,7 +68,7 @@ orbital BadgeOrbital {
         @label "Icon Asset"
         @description "Asset image rendered as the badge icon; takes precedence over icon when provided."
         @tier "presentation"
-      onRemove : string = "REMOVE"
+      onRemove : string = ""
         @label "On Remove"
         @description "When set, renders a small X button on the right of the badge that invokes this handler — turns the badge into a removable chip. Used by the TagInput molecule and other 'list of removable values' surfaces."
         @tier "presentation"

package/behaviors/lolo/ui/core/atoms/ui-filter-pill.lolo

@@ -25,21 +25,6 @@ orbital FilterPillOrbital {
           removeEvent: @config.removeEvent
           type: filter-pill
         })
-      REMOVE -> idle
-        (set @entity.label ?label)
-        (render-ui main {
-          className: @config.className
-          variant: @config.variant
-          size: @config.size
-          label: @entity.label
-          icon: @config.icon
-          onRemove: @config.onRemove
-          removable: @config.removable
-          onClick: @config.onClick
-          clickEvent: @config.clickEvent
-          removeEvent: @config.removeEvent
-          type: filter-pill
-        })
       CLICK -> idle
         (set @entity.label ?label)
         (render-ui main {
@@ -58,11 +43,6 @@ orbital FilterPillOrbital {
     }
 
     emits {
-      @config.onRemove -> external {
-        label : string!
-      }
-        @description "Called when the user clicks the remove (×) button"
-        @tier "essential"
       @config.onClick -> external {
         label : string!
       }
@@ -71,9 +51,6 @@ orbital FilterPillOrbital {
     }
 
     listens {
-      REMOVE {
-        label : string!
-      }
       CLICK {
         label : string!
       }
@@ -100,7 +77,7 @@ orbital FilterPillOrbital {
         @label "Icon"
         @description "Lucide icon component or canonical kebab-case icon name string"
         @tier "presentation"
-      onRemove : string = "REMOVE"
+      onRemove : string = ""
         @label "On Remove"
         @description "Called when the user clicks the remove (×) button"
         @tier "presentation"
@@ -116,7 +93,7 @@ orbital FilterPillOrbital {
         @label "Click Event"
         @description "Event name dispatched via event bus when the pill body is clicked. Payload: { label }"
         @tier "presentation"
-      removeEvent : string = "REMOVE"
+      removeEvent : string = ""
         @label "Remove Event"
         @description "Event name dispatched via event bus when the remove (×) button is clicked. Payload: { label }"
         @tier "presentation"

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/lolo/ui/game/atoms/ui-trait-slot.lolo

@@ -156,32 +156,6 @@ orbital TraitSlotOrbital {
           dropEvent: @config.dropEvent
           type: trait-slot
         })
-      REMOVE -> idle
-        (set @entity.slotNumber ?slotNumber)
-        (render-ui main {
-          slotNumber: @entity.slotNumber
-          equippedItem: @config.equippedItem
-          locked: @config.locked
-          lockLabel: @config.lockLabel
-          selected: @config.selected
-          size: @config.size
-          showTooltip: @config.showTooltip
-          categoryColors: @config.categoryColors
-          tooltipFrameUrl: @config.tooltipFrameUrl
-          className: @config.className
-          isLoading: @config.isLoading
-          error: @config.error
-          onItemDrop: @config.onItemDrop
-          draggable: @config.draggable
-          onDragStart: @config.onDragStart
-          feedback: @config.feedback
-          onClick: @config.onClick
-          onRemove: @config.onRemove
-          clickEvent: @config.clickEvent
-          removeEvent: @config.removeEvent
-          dropEvent: @config.dropEvent
-          type: trait-slot
-        })
       DROP -> idle
         (set @entity.slotNumber ?slotNumber)
         (render-ui main {
@@ -226,11 +200,6 @@ orbital TraitSlotOrbital {
       }
         @description "-- Callbacks --"
         @tier "essential"
-      @config.onRemove -> external {
-        slotNumber : number!
-      }
-        @description "Remove handler"
-        @tier "essential"
       @config.dropEvent -> external {
         slotNumber : number!
         itemId : string!
@@ -243,9 +212,6 @@ orbital TraitSlotOrbital {
       CLICK {
         slotNumber : number!
       }
-      REMOVE {
-        slotNumber : number!
-      }
       DROP {
         slotNumber : number!
         itemId : string!
@@ -321,7 +287,7 @@ orbital TraitSlotOrbital {
         @label "On Click"
         @description "-- Callbacks --"
         @tier "presentation"
-      onRemove : string = "REMOVE"
+      onRemove : string = ""
         @label "On Remove"
         @description "Remove handler"
         @tier "presentation"
@@ -329,7 +295,7 @@ orbital TraitSlotOrbital {
         @label "Click Event"
         @description "-- Declarative events --"
         @tier "presentation"
-      removeEvent : string = "REMOVE"
+      removeEvent : string = ""
         @label "Remove Event"
         @description "Emits UI:{removeEvent} with { slotNumber }"
         @tier "presentation"

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/atoms/ui-badge.orb

@@ -19,15 +19,6 @@
         "parent": "trt_01KXG04J66F1NVJTF3ZS57P7K6",
         "renames": []
       },
-      "evt_01KXG04J690VY1KHNSN7EFXBQX": {
-        "bakedName": "@config.onRemove",
-        "curName": "@config.onRemove",
-        "id": "evt_01KXG04J690VY1KHNSN7EFXBQX",
-        "kind": "event",
-        "owner": "workspace",
-        "parent": "trt_01KXG04J66F1NVJTF3ZS57P7K6",
-        "renames": []
-      },
       "orb_01KXG04J66RQ2ZKZ9VJXM9VS1C": {
         "bakedName": "BadgeOrbital",
         "curName": "BadgeOrbital",
@@ -202,7 +193,7 @@
               "type": "string"
             },
             "onRemove": {
-              "default": "REMOVE",
+              "default": "",
               "description": "When set, renders a small X button on the right of the badge that invokes this handler — turns the badge into a removable chip. Used by the TagInput molecule and other 'list of removable values' surfaces.",
               "label": "On Remove",
               "tier": "presentation",
@@ -245,21 +236,6 @@
               ]
             }
           },
-          "emits": [
-            {
-              "description": "When set, renders a small X button on the right of the badge that invokes this handler — turns the badge into a removable chip. Used by the TagInput molecule and other 'list of removable values' surfaces.",
-              "event": "@config.onRemove",
-              "eventId": "evt_01KXG04J690VY1KHNSN7EFXBQX",
-              "payloadSchema": [
-                {
-                  "name": "id",
-                  "type": "string"
-                }
-              ],
-              "scope": "external",
-              "tier": "essential"
-            }
-          ],
           "entityContract": {
             "provides": [],
             "requires": []
@@ -279,19 +255,6 @@
                 "id": "evt_01KXG04J66HMQ87R0XX75VN72Q",
                 "key": "INIT",
                 "name": "Initialize"
-              },
-              {
-                "description": "When set, renders a small X button on the right of the badge that invokes this handler — turns the badge into a removable chip. Used by the TagInput molecule and other 'list of removable values' surfaces.",
-                "id": "evt_01KXG04J690VY1KHNSN7EFXBQX",
-                "key": "@config.onRemove",
-                "name": "@config.on remove",
-                "payloadSchema": [
-                  {
-                    "name": "id",
-                    "type": "string"
-                  }
-                ],
-                "tier": "essential"
               }
             ],
             "states": [