@almadar/std 16.150.0 → 16.152.0

package/behaviors/lolo/ui/core/atoms/std-app-search.lolo

@@ -67,6 +67,15 @@ orbital AppSearchOrbital {
     }
 
     state searching {
+      INIT -> idle
+        (set @entity.searchTerm "")
+        (fetch AppSearchTarget {})
+        (render-ui main {
+          type: stack
+          direction: vertical
+          gap: md
+          children: [@config.idleContent]
+        })
       APP_SEARCH -> searching
         (set @entity.searchTerm ?value)
         (fetch AppSearchTarget {
@@ -135,6 +144,15 @@ orbital AppSearchOrbital {
     }
 
     state results {
+      INIT -> idle
+        (set @entity.searchTerm "")
+        (fetch AppSearchTarget {})
+        (render-ui main {
+          type: stack
+          direction: vertical
+          gap: md
+          children: [@config.idleContent]
+        })
       APP_SEARCH -> searching
         (set @entity.searchTerm ?value)
         (fetch AppSearchTarget {

package/behaviors/lolo/ui/core/atoms/std-board.lolo

@@ -694,7 +694,7 @@ orbital BoardOrbital {
                         label: @config.cardStageBinding
                         size: sm
                         type: badge
-                        variant: primary
+                        variant: @col.variant
                       }, {
                         action: OPEN_CARD
                         actionPayload: { description: @config.cardDescriptionBinding, id: @config.cardIdBinding, row: @item, stage: @config.cardStageBinding, title: @config.cardTitleBinding }

package/behaviors/lolo/ui/core/atoms/std-browse.lolo

@@ -1,4 +1,4 @@
-app std-browse "2.3.0"
+app std-browse "2.5.0"
 "std-browse as a Function — single primitive: data-grid. Owns the fetch + REFETCH (query/filter/page) state machine. Consumers configure fields/imageField/itemActions/cols/gap/variant; the atom renders the grid. Each `fields[]` entry accepts `{ name, label, variant }` plus optional `referenceEntity` + `displayField` to render a foreign-key column as the joined entity's display value (data-grid resolves @list[referenceEntity] at render time when both keys are present). `browseLook` (table default / dense / feed / gallery / master-detail / triage) selects one of six render bodies; dense/feed/gallery were folded in from std-browse-dense/-feed/-gallery (Phase 5.B); master-detail (split record view driven by the guarded VIEW/CLOSE self-transitions) and triage (inbox rows) were folded in 2026-07-26. Consumers retarget by setting browseLook."
 type FieldSpec = { name : string!, label : string, variant : h3 | h4 | body | caption | badge | small | progress, icon : string, format : date | currency | number | boolean | percent, key : string, header : string }
 type ItemAction = { label : string!, event : string, navigatesTo : string, variant : primary | secondary | ghost | danger, icon : string }
@@ -75,6 +75,7 @@ orbital BrowseItemOrbital {
       INIT -> loading
         (fetch BrowseItem {
           emit: { failure: BrowseItemLoadFailed, success: BrowseItemLoaded }
+          filter: (and (or ["=", @config.scopeField, ""] ["=", (object/get @entity @config.scopeField), @user.id]) (or ["=", @config.initialFilterField, ""] ["=", (object/get @entity @config.initialFilterField), @config.initialFilterValue]))
           limit: @config.pageSize
           offset: 0
         })
@@ -96,13 +97,17 @@ orbital BrowseItemOrbital {
     }
 
     state browsing {
+      ;; No skeleton repaint here, for the same reason REFETCH_* has none: from
+      ;; a POPULATED body a skeleton unmounts the grid and flickers. First mount
+      ;; is unaffected — `initial: loading` and `state loading`'s own INIT still
+      ;; paint it; `browsing` is only reachable after a successful load.
       INIT -> loading
         (fetch BrowseItem {
           emit: { failure: BrowseItemLoadFailed, success: BrowseItemLoaded }
+          filter: (and (or ["=", @config.scopeField, ""] ["=", (object/get @entity @config.scopeField), @user.id]) (or ["=", @config.initialFilterField, ""] ["=", (object/get @entity @config.initialFilterField), @config.initialFilterValue]))
           limit: @config.pageSize
           offset: 0
         })
-        (render-ui main { rows: 4, type: skeleton })
       ;; REFETCH_* stays in `browsing` and DOES NOT replace the data-grid
       ;; with a spinner. Replacing during search-as-you-type unmounts the
       ;; grid every keystroke and causes a visible flicker. The fetch fires
@@ -112,20 +117,21 @@ orbital BrowseItemOrbital {
       REFETCH_QUERY -> browsing
         (fetch BrowseItem {
           emit: { failure: BrowseItemLoadFailed, success: BrowseItemLoaded }
-          filter: (or ["=", ?searchTerm, ""] (str/includes (object/get @entity name) ?searchTerm))
+          filter: (and (or ["=", @config.scopeField, ""] ["=", (object/get @entity @config.scopeField), @user.id]) (or ["=", ?searchTerm, ""] (str/includes (object/get @entity name) ?searchTerm)))
           limit: @config.pageSize
           offset: 0
         })
       REFETCH_FILTER -> browsing
         (fetch BrowseItem {
           emit: { failure: BrowseItemLoadFailed, success: BrowseItemLoaded }
-          filter: (or ["=", ?value, ""] ["=", (object/get @entity ?field), ?value])
+          filter: (and (or ["=", @config.scopeField, ""] ["=", (object/get @entity @config.scopeField), @user.id]) (or ["=", ?value, ""] ["=", (object/get @entity ?field), ?value]))
           limit: @config.pageSize
           offset: 0
         })
       REFETCH_PAGE -> browsing
         (fetch BrowseItem {
           emit: { failure: BrowseItemLoadFailed, success: BrowseItemLoaded }
+          filter: (or ["=", @config.scopeField, ""] ["=", (object/get @entity @config.scopeField), @user.id])
           limit: @config.pageSize
           offset: ["*", ["-", ?page, 1], @config.pageSize]
         })
@@ -155,6 +161,7 @@ orbital BrowseItemOrbital {
       INIT -> loading
         (fetch BrowseItem {
           emit: { failure: BrowseItemLoadFailed, success: BrowseItemLoaded }
+          filter: (and (or ["=", @config.scopeField, ""] ["=", (object/get @entity @config.scopeField), @user.id]) (or ["=", @config.initialFilterField, ""] ["=", (object/get @entity @config.initialFilterField), @config.initialFilterValue]))
           limit: @config.pageSize
           offset: 0
         })
@@ -288,8 +295,12 @@ orbital BrowseItemOrbital {
         @tier "internal"
       metaBinding : string = @item.createdAt
         @label "Meta field binding"
-        @description "Binding path for the secondary meta slot (timestamp / category)."
+        @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."
         @tier "internal"
+      metaFormat : "none" | "date" | "time" | "datetime" | "number" = date
+        @label "Meta value format"
+        @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."
+        @tier "presentation"
       categoryBinding : string = @item.category
         @label "Category field binding"
         @description "Binding path for the category/tag slot."
@@ -337,6 +348,21 @@ orbital BrowseItemOrbital {
         @description "Actions beyond this count collapse into a '⋯' overflow menu. Set 2–3 for dense tables."
         @synonyms "inline actions limit, overflow threshold, max buttons per row"
         @tier "presentation"
+      scopeField : string = ""
+        @label "Only show records owned by the signed-in user?"
+        @description "Name the field on this entity that holds the viewer's id (e.g. memberId, patientId, assignee). When set, the list loads ONLY rows whose that field equals @user.id — the 'my bookings' / 'my appointments' shape. Left blank the list loads every row, which is the default. Declared, never inferred: guessing the column from its name would silently scope the wrong one."
+        @synonyms "owner field, my records, only mine, only my own, scope to user, per-user list, mine only, owned by me"
+        @tier "policy"
+      initialFilterField : string = ""
+        @label "Which field does the first load filter on?"
+        @description "Name the field the INITIAL load filters on, paired with initialFilterValue. This is the detail half of a list-detail pair: a thread that must wait for a conversation to be picked sets the field to its parent key and leaves the value blank, so the first load matches nothing and the empty state shows instead of every record in the table. REFETCH_FILTER then supplies the real selection. Left blank the first load is unfiltered, which is the default."
+        @synonyms "initial filter, first load filter, wait for selection, detail pane filter, requires selection, start empty"
+        @tier "policy"
+      initialFilterValue : string = ""
+        @label "What value does the first load filter for?"
+        @description "The value initialFilterField must equal on the first load. Blank is meaningful: it matches only records whose field is itself blank, which for a detail pane is normally none — that is how a thread stays empty until its parent is selected."
+        @synonyms "initial filter value, first load value, default selection"
+        @tier "policy"
       selectable : boolean = false
         @label "Show row selection checkboxes?"
         @description "Adds a checkbox column with select-all to the dense table. Enable only when the surface offers bulk actions — checkboxes with nothing to act on are a dead affordance."
@@ -365,6 +391,11 @@ orbital BrowseItemOrbital {
         @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."
         @synonyms "detail columns, record fields, detail pane fields"
         @tier "presentation"
+      detailActions : json = [{ event: CLOSE, label: Close }]
+        @label "Master-detail record pane actions"
+        @description "Action buttons on the master-detail record pane (detail-panel `actions` descriptors: label/event/icon/variant). Consumers add their own record actions (Edit/Delete/…) alongside or instead of Close."
+        @synonyms "record actions, detail actions, pane actions"
+        @tier "presentation"
       bodyContent : render-ui = {
         children: [@trait.DataGrid1]
         direction: vertical
@@ -465,6 +496,7 @@ orbital BrowseItemOrbital {
                   children: [{
                     color: muted
                     content: @config.metaBinding
+                    format: @config.metaFormat
                     type: typography
                     variant: caption
                   }, {
@@ -639,13 +671,10 @@ orbital BrowseItemOrbital {
           type: stack
         }, {
           detail: {
-            actions: [{
-              event: CLOSE
-              label: Close
-            }]
+            actions: @config.detailActions
             fieldNames: @config.detailFields
             initialData: ?row
-            showActions: false
+            showActions: true
             type: detail-panel
           }
           hasSelection: true

package/behaviors/lolo/ui/core/atoms/std-calendar.lolo

@@ -194,6 +194,16 @@ orbital CalendarEventOrbital {
         @label "Title"
         @description "Header text shown above the calendar body."
         @tier "presentation"
+      agendaItemActions : json = [{ event: SELECT_DAY, icon: eye, label: View }]
+        @label "Agenda item actions"
+        @description "Per-item action buttons on agenda-list rows — data-list itemActions descriptors (label/event/icon/variant). Consumers override to wire their own row actions (View/Edit/Delete) so agenda hosts never need a second table for actions."
+        @synonyms "agenda actions, row actions, event actions, list actions"
+        @tier "presentation"
+      agendaGroupBy : string = date
+        @label "Agenda group-by field"
+        @description "Row field the agenda list groups its day sections by. Rebound hosts point this at their own timestamp column (e.g. startTime, scheduledAt)."
+        @synonyms "group field, section field, day field"
+        @tier "presentation"
       bodyContent : render-ui = {
         children: [{
           align: center
@@ -292,7 +302,8 @@ orbital CalendarEventOrbital {
           entity: ?data
           fields: []
           gap: md
-          groupBy: date
+          groupBy: @config.agendaGroupBy
+          itemActions: @config.agendaItemActions
           renderItem: (fn item {
             children: [{
               align: start
@@ -301,6 +312,7 @@ orbital CalendarEventOrbital {
                 children: [{
                   color: muted
                   content: @config.timeBinding
+                  format: time
                   type: typography
                   variant: overline
                 }, {

package/behaviors/lolo/ui/core/atoms/std-multi-party-flow.lolo

@@ -1220,41 +1220,39 @@ orbital MultiPartyFlowOrbital {
         @label "Page title"
         @description "Heading shown above the transaction view"
         @tier "presentation"
-      transactionSubject : string = "Sale of 2024 Honda CR-V"
+      transactionSubject : string = "Sale of item"
         @label "Subject"
         @description "Short description of what is being transacted"
         @tier "presentation"
-      transactionAmount : string = "$28,500"
+      transactionAmount : string = "$0.00"
         @label "Amount"
         @description "Formatted amount held in escrow"
         @tier "presentation"
-      transactionReference : string = TXN-A8B2C-2024-001
+      transactionReference : string = ""
         @label "Reference"
         @description "External identifier shown in the summary"
         @tier "presentation"
       parties : [PartySpec] = [{
-        actionDescription: "Authorize $28,500 to be held in escrow until delivery is confirmed."
+        actionDescription: "Authorize the funds to be held in escrow until delivery is confirmed."
         actionIcon: credit-card
         actionLabel: "Confirm payment"
-        actor: "Alice Chen"
-        description: "Funds the transaction and confirms receipt of the vehicle."
+        description: "Funds the transaction and confirms receipt."
         icon: user
         id: buyer
         stepLabel: "Step 1 of 2"
         title: Buyer
       }, {
-        actionDescription: "Mark the vehicle as shipped. Funds will release after the buyer confirms receipt."
+        actionDescription: "Mark the item as shipped. Funds release after the buyer confirms receipt."
         actionIcon: package
         actionLabel: "Confirm shipment"
-        actor: "Bob's Auto Sales LLC"
-        description: "Ships the vehicle and uploads delivery proof."
+        description: "Ships the item and uploads delivery proof."
         icon: user-check
         id: seller
         stepLabel: "Step 2 of 2"
         title: Seller
       }]
         @label "Parties"
-        @description "Ordered participants with role, actor name, and required action"
+        @description "Ordered participants with role, actor name, and required action. stepLabel entries should track the party count when overriding."
         @tier "domain"
       releaseLabel : string = "Release funds"
         @label "Release button"

package/behaviors/lolo/ui/core/atoms/std-stats.lolo

@@ -93,12 +93,14 @@ orbital StatsItemOrbital {
         format: number
         icon: list
         label: "Total Items"
+        sparklineData: [2, 4, 3, 6, 5, 8, 7]
         variant: primary
       }, {
         aggregation: count
         format: number
         icon: check-circle
         label: Active
+        sparklineData: [1, 3, 2, 4, 6, 5, 7]
         variant: success
       }, {
         aggregation: avg
@@ -106,6 +108,7 @@ orbital StatsItemOrbital {
         format: number
         icon: trending-up
         label: "Avg Value"
+        sparklineData: [5, 4, 6, 3, 5, 7, 6]
         variant: info
       }]
         @label "Metrics"

package/behaviors/lolo/ui/core/atoms/ui-typography.lolo

@@ -21,6 +21,7 @@ orbital TypographyOrbital {
           overflow: @config.overflow
           className: @config.className
           style: @config.style
+          format: @config.format
           content: @config.content
           children: @config.children
           type: typography
@@ -32,7 +33,7 @@ orbital TypographyOrbital {
         @label "Variant"
         @description "Typography variant"
         @tier "presentation"
-      level : number = 1
+      level : number
         @label "Level"
         @description "Heading level (1-6) - alternative to variant for headings"
         @tier "presentation"
@@ -68,6 +69,10 @@ orbital TypographyOrbital {
         @label "Style"
         @description "Inline style"
         @tier "presentation"
+      format : "none" | "date" | "time" | "datetime" | "number" | "currency" | "percent" = none
+        @label "Format"
+        @description "Value formatting applied to string/number/Date content — `none` (the default) renders content as-is. Covers the raw-ISO-date class: a bound datetime renders human-readable via `format='date'|'time'|'datetime'`."
+        @tier "presentation"
       content : node
         @label "Content"
         @description "Text content (alternative to children)"

package/behaviors/lolo/ui/core/molecules/ui-data-grid.lolo

@@ -171,7 +171,9 @@ orbital DataGridOrbital {
         @label "Columns"
         @description "Alias for `fields` — the compiler emits `columns` for field defs."
         @tier "presentation"
-      itemActions : json = []
+      itemActions : [DataGridItemActionsItem] = []
+        @label "Item Actions"
+        @description "Per-item action buttons"
         @tier "presentation"
       maxInlineActions : number
         @label "Max Inline Actions"
@@ -181,7 +183,7 @@ orbital DataGridOrbital {
         @label "Scroll X"
         @description "Lay items in a single horizontally-scrolling row (kanban columns) sized to `minCardWidth` instead of a wrapping grid."
         @tier "presentation"
-      cols : number = 1
+      cols : number
         @label "Cols"
         @description "Number of columns (uses auto-fit if omitted)"
         @tier "presentation"

package/behaviors/lolo/ui/core/molecules/ui-data-list.lolo

@@ -68,7 +68,9 @@ orbital DataListOrbital {
           variant: @config.variant
           groupBy: @config.groupBy
           senderField: @config.senderField
+          senderLabelField: @config.senderLabelField
           currentUser: @config.currentUser
+          emptyMessage: @config.emptyMessage
           className: @config.className
           isLoading: @config.isLoading
           error: @config.error
@@ -82,6 +84,8 @@ orbital DataListOrbital {
           loadMoreEvent: @config.loadMoreEvent
           hasMore: @config.hasMore
           pageSize: @config.pageSize
+          sortBy: @config.sortBy
+          sortDirection: @config.sortDirection
           look: @config.look
           type: data-list
         })
@@ -105,7 +109,9 @@ orbital DataListOrbital {
           variant: @config.variant
           groupBy: @config.groupBy
           senderField: @config.senderField
+          senderLabelField: @config.senderLabelField
           currentUser: @config.currentUser
+          emptyMessage: @config.emptyMessage
           className: @config.className
           isLoading: @config.isLoading
           error: @config.error
@@ -119,6 +125,8 @@ orbital DataListOrbital {
           loadMoreEvent: @config.loadMoreEvent
           hasMore: @config.hasMore
           pageSize: @config.pageSize
+          sortBy: @config.sortBy
+          sortDirection: @config.sortDirection
           look: @config.look
           type: data-list
         })
@@ -207,7 +215,9 @@ orbital DataListOrbital {
         @label "Columns"
         @description "Alias for `fields` — the compiler emits `columns` for field defs."
         @tier "presentation"
-      itemActions : json = []
+      itemActions : [DataListItemActionsItem] = []
+        @label "Item Actions"
+        @description "Per-item action buttons"
         @tier "presentation"
       maxInlineActions : number
         @label "Max Inline Actions"
@@ -233,10 +243,18 @@ orbital DataListOrbital {
         @label "Sender Field"
         @description "Field name identifying the sender (used with variant: 'message')"
         @tier "presentation"
+      senderLabelField : string
+        @label "Sender Label Field"
+        @description "Field holding the sender's human-readable name (used with variant: 'message'). Defaults to `senderField`. Set this when `senderField` holds an id — an id-keyed thread otherwise labels bubbles `staff-1` instead of `Sam Staff`."
+        @tier "presentation"
       currentUser : string
         @label "Current User"
         @description "Current user identifier; messages matching this value align right (used with variant: 'message')"
         @tier "presentation"
+      emptyMessage : string
+        @label "Empty Message"
+        @description "Message shown when there are no rows. Falls back to the generic 'no items' translation. `TableView` already exposes this; an agenda or an inbox wants to say what 'empty' means in its own words."
+        @tier "presentation"
       className : string
         @label "Class Name"
         @description "Additional CSS classes"
@@ -289,6 +307,14 @@ orbital DataListOrbital {
         @label "Page Size"
         @description "Max items to show before 'Show More' button. Defaults to 5. Set to 0 to disable."
         @tier "presentation"
+      sortBy : string
+        @label "Sort By"
+        @description "Field name to order rows by. Values are compared by their own type — numbers numerically, date-like strings chronologically, everything else alphabetically — never by what the field is called. Empty cells sort last. Unset leaves the incoming order untouched. Orders only the rows already fetched: a collection larger than its `limit` still needs ordering at the data layer."
+        @tier "presentation"
+      sortDirection : "asc" | "desc" = asc
+        @label "Sort Direction"
+        @description "Direction for `sortBy`. Defaults to ascending."
+        @tier "presentation"
       look : "dense" | "spacious" | "striped" | "borderless" | "card-rows" = dense
         @label "Look"
         @description "Layer 2 visual treatment — mirrors the `entity-table` look enum so data-grid / data-list / entity-table share one knob name from authors."

package/behaviors/lolo/ui/core/molecules/ui-graph-canvas.lolo

@@ -8,9 +8,14 @@ orbital GraphCanvasOrbital {
     color : string
     size : number
     badge : number
+    mark : GraphCanvasNodesItemMark
     x : number
     y : number
   }
+  type GraphCanvasNodesItemMark = {
+    kind : json!
+    suggestionId : string!
+  }
   type GraphCanvasEdgesItem = {
     source : string!
     target : string!
@@ -18,6 +23,13 @@ orbital GraphCanvasOrbital {
     weight : number
     color : string
   }
+  type GraphCanvasProposedEdgesItem = {
+    source : string!
+    target : string!
+    label : string
+    weight : number
+    color : string
+  }
   type GraphCanvasSimilarityItem = {
     source : string!
     target : string!
@@ -42,9 +54,29 @@ orbital GraphCanvasOrbital {
     color : string
     size : number
     badge : number
+    mark : GraphCanvasNODECLICKNodeMark
+    x : number
+    y : number
+  }
+  type GraphCanvasNODECLICKNodeMark = {
+    kind : json!
+    suggestionId : string!
+  }
+  type GraphCanvasMARKCLICKNode = {
+    id : string!
+    label : string
+    group : string
+    color : string
+    size : number
+    badge : number
+    mark : GraphCanvasMARKCLICKNodeMark
     x : number
     y : number
   }
+  type GraphCanvasMARKCLICKNodeMark = {
+    kind : json!
+    suggestionId : string!
+  }
   type GraphCanvasNODEDOUBLECLICKNode = {
     id : string!
     label : string
@@ -52,9 +84,14 @@ orbital GraphCanvasOrbital {
     color : string
     size : number
     badge : number
+    mark : GraphCanvasNODEDOUBLECLICKNodeMark
     x : number
     y : number
   }
+  type GraphCanvasNODEDOUBLECLICKNodeMark = {
+    kind : json!
+    suggestionId : string!
+  }
   type GraphCanvasBADGECLICKNode = {
     id : string!
     label : string
@@ -62,9 +99,14 @@ orbital GraphCanvasOrbital {
     color : string
     size : number
     badge : number
+    mark : GraphCanvasBADGECLICKNodeMark
     x : number
     y : number
   }
+  type GraphCanvasBADGECLICKNodeMark = {
+    kind : json!
+    suggestionId : string!
+  }
 
   entity GraphCanvasItem [runtime] {
     id : string!
@@ -79,6 +121,7 @@ orbital GraphCanvasOrbital {
           title: @config.title
           nodes: @config.nodes
           edges: @config.edges
+          proposedEdges: @config.proposedEdges
           similarity: @config.similarity
           height: @config.height
           showLabels: @config.showLabels
@@ -86,6 +129,7 @@ orbital GraphCanvasOrbital {
           draggable: @config.draggable
           actions: @config.actions
           onNodeClick: @config.onNodeClick
+          onMarkClick: @config.onMarkClick
           onNodeDoubleClick: @config.onNodeDoubleClick
           onBadgeClick: @config.onBadgeClick
           nodeClickEvent: @config.nodeClickEvent
@@ -109,6 +153,11 @@ orbital GraphCanvasOrbital {
       }
         @description "On node click"
         @tier "essential"
+      @config.onMarkClick -> external {
+        node : GraphCanvasMARKCLICKNode
+      }
+        @description "On marked-node click (suggestion/proposal target). Takes priority over onNodeClick."
+        @tier "essential"
       @config.onNodeDoubleClick -> external {
         node : GraphCanvasNODEDOUBLECLICKNode
       }
@@ -134,6 +183,10 @@ orbital GraphCanvasOrbital {
         @label "Edges"
         @description "Graph edges (the only rendered links)"
         @tier "presentation"
+      proposedEdges : [GraphCanvasProposedEdgesItem] = []
+        @label "Proposed Edges"
+        @description "Uncommitted proposal links — rendered dashed/faint in a separate pass, never folded into the layout springs."
+        @tier "presentation"
       similarity : [GraphCanvasSimilarityItem] = []
         @label "Similarity"
         @description "All-pairs similarity (cosine 0–1) used ONLY for layout, never drawn. It is the secondary macro-layout: non-connected pairs get a weak spring (higher cosine ⇒ closer) so clusters arrange relative to each other; drawn `edges` stay the primary tight structure. When omitted, edges alone drive the layout."
@@ -162,6 +215,10 @@ orbital GraphCanvasOrbital {
         @label "On Node Click"
         @description "On node click"
         @tier "presentation"
+      onMarkClick : string = "MARK_CLICK"
+        @label "On Mark Click"
+        @description "On marked-node click (suggestion/proposal target). Takes priority over onNodeClick."
+        @tier "presentation"
       onNodeDoubleClick : string = "NODE_DOUBLE_CLICK"
         @label "On Node Double Click"
         @description "On node double-click (e.g. to drill in)"

package/behaviors/lolo/ui/core/molecules/ui-simple-grid.lolo

@@ -26,11 +26,11 @@ orbital SimpleGridOrbital {
         @label "Min Child Width"
         @description "Minimum width of each child (e.g., 200, '200px', '15rem')"
         @tier "presentation"
-      maxCols : number = 1
+      maxCols : number
         @label "Max Cols"
         @description "Maximum number of columns"
         @tier "presentation"
-      cols : number = 1
+      cols : number
         @label "Cols"
         @description "Exact number of columns (disables auto-fit)"
         @tier "presentation"

package/behaviors/lolo/ui/core/molecules/ui-table-view.lolo

@@ -176,7 +176,9 @@ orbital TableViewOrbital {
         @label "Fields"
         @description "Alias for `columns`."
         @tier "presentation"
-      itemActions : json = []
+      itemActions : [TableViewItemActionsItem] = []
+        @label "Item Actions"
+        @description "Per-row action buttons (trailing column)."
         @tier "presentation"
       maxInlineActions : number
         @label "Max Inline Actions"

package/behaviors/lolo/ui/core/organisms/ui-entity-cards.lolo

@@ -160,7 +160,7 @@ orbital EntityCardsOrbital {
         @label "Min Card Width"
         @description "Minimum width of each card (default: 280px)"
         @tier "presentation"
-      maxCols : number = 1
+      maxCols : number
         @label "Max Cols"
         @description "Maximum number of columns"
         @tier "presentation"
@@ -188,7 +188,9 @@ orbital EntityCardsOrbital {
         @label "Columns"
         @description "Alias for fields - backwards compatibility"
         @tier "presentation"
-      itemActions : json = [{ event: VIEW, label: View, variant: ghost }]
+      itemActions : [EntityCardsItemActionsItem] = [{ event: VIEW, label: View, variant: ghost }]
+        @label "Item Actions"
+        @description "Actions for each card item (schema-driven)"
         @tier "presentation"
       showTotal : boolean = true
         @label "Show Total"

package/behaviors/lolo/ui/core/organisms/ui-entity-list.lolo

@@ -148,6 +148,8 @@ orbital EntityListOrbital {
         @description "selectable prop"
         @tier "presentation"
       itemActions : json = [{ event: VIEW, label: View, variant: ghost }]
+        @label "Item Actions"
+        @description "Item actions - schema-driven or function-based"
         @tier "presentation"
       showDividers : boolean
         @label "Show Dividers"

package/behaviors/lolo/ui/core/organisms/ui-entity-table.lolo

@@ -189,7 +189,9 @@ orbital EntityTableOrbital {
         @label "Columns"
         @description "Columns can be Column objects or simple string field names"
         @tier "presentation"
-      itemActions : json = [{ event: VIEW, label: View, variant: ghost }]
+      itemActions : [EntityTableItemActionsItem] = [{ event: VIEW, label: View, variant: ghost }]
+        @label "Item Actions"
+        @description "Item actions from generated code - maps to rowActions"
         @tier "presentation"
       emptyIcon : icon
         @label "Empty Icon"

package/behaviors/lolo/ui/core/organisms/ui-timeline.lolo

@@ -98,7 +98,9 @@ orbital TimelineOrbital {
         @label "Fields"
         @description "Fields to display"
         @tier "presentation"
-      itemActions : json = []
+      itemActions : [TimelineItemActionsItem] = []
+        @label "Item Actions"
+        @description "Actions per item"
         @tier "presentation"
       look : "vertical-compact" | "vertical-spacious" | "horizontal" | "swimlane" = "vertical-spacious"
         @label "Look"