@almadar/std 16.187.0 → 16.189.0

package/behaviors/lolo/ui/core/.hand-authored.json

@@ -99,6 +99,10 @@
     "signature": "33fcd927eb0bb9b7",
     "board": "packages/almadar-std/behaviors/lolo/ui/core/atoms/std-rating-review.lolo"
   },
+  "std-record-detail": {
+    "signature": "2d1e4a89d0de6e94",
+    "board": "packages/almadar-std/behaviors/lolo/ui/core/atoms/std-record-detail.lolo"
+  },
   "std-recurrence": {
     "signature": "56693212f7a2f8bc",
     "board": "packages/almadar-std/behaviors/lolo/ui/core/atoms/std-recurrence.lolo"
@@ -107,10 +111,6 @@
     "signature": "d11c4e5a26b3779d",
     "board": "packages/almadar-std/behaviors/lolo/ui/core/atoms/std-related.lolo"
   },
-  "std-rich-editor": {
-    "signature": "2ff1a9ef3cc7e487",
-    "board": "packages/almadar-std/behaviors/lolo/ui/core/atoms/std-rich-editor.lolo"
-  },
   "std-saved-search": {
     "signature": "e687e5294aaae0cc",
     "board": "packages/almadar-std/behaviors/lolo/ui/core/atoms/std-saved-search.lolo"

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

@@ -1,7 +1,8 @@
-app std-board "1.2.0"
-"std-board — generic N-column board primitive. `config.columns` is an array of column definitions ({ key, label, icon, variant }); the trait `array/map`s them on `BoardItemsLoaded` into `@entity.boards` where each board carries its filtered items + a count. The render is a `data-grid` over `@entity.boards` (one card per column) whose `renderItem` lambda nests a `data-list` over `@col.items` (the cards in that stage). N is config-driven — pass any number of columns; the outer `data-grid`'s `cols` is bound to `@config.gridCols` so the grid wraps if you exceed it. Topology = loading / viewing_board / viewing_card / adding / error — distinct from the cookie-cutter `loading/browsing/viewing_single/error` CRUD shape. App-level atoms (e.g. std-pipeline) compose std-board via `uses` and add a sibling persistor + extended source entity. `config.boardLook` switches the board body between the default N-column grid ('columns') and a Trello-style wide-column kanban ('kanban-classic')."
+app std-board "1.3.0"
+"std-board — generic N-column board primitive. `config.columns` is an array of column definitions ({ key, label, icon, variant }); the trait `array/map`s them on `BoardItemsLoaded` into `@entity.boards` where each board carries its filtered items + a count. The render is a `data-grid` over `@entity.boards` (one card per column) whose `renderItem` lambda nests a `data-list` over `@col.items` (the cards in that stage). N is config-driven — pass any number of columns; the outer `data-grid`'s `cols` is bound to `@config.gridCols` so the grid wraps if you exceed it. Topology = loading / viewing_board / viewing_card / adding / error — distinct from the cookie-cutter `loading/browsing/viewing_single/error` CRUD shape. App-level atoms (e.g. std-pipeline) compose std-board via `uses` and add a sibling persistor + extended source entity. `config.boardLook` switches the board body between the default N-column grid ('columns') and a Trello-style wide-column kanban ('kanban-classic'). `viewing_board` listens for REFETCH_QUERY/REFETCH_FILTER/REFETCH_PAGE (the std-search/std-filter/std-pagination wiring targets, no render on refetch — @entity.boards is bound reactively) and can optionally render its own search box (config.bodySearch, default false) and filter bar (config.filters, default []); no pagination control is rendered — a board's columns are not a paged list."
 type ObjectSpec = { id : string, label : string, value : string }
 type ColumnSpec = { key : string!, label : string!, icon : string, variant : string }
+type FilterSpec = { field : string!, label : string, options : [string] }
 orbital BoardOrbital {
     type BoardItem = { id : string!, title : string, description : string, stage : string, notes : string, position : number }
 
@@ -219,6 +220,33 @@ orbital BoardOrbital {
         (fetch BoardView {
           emit: { failure: BoardItemsLoadFailed, success: BoardItemsLoaded }
         })
+      ;; REFETCH_* stay in viewing_board and issue no render-ui, matching
+      ;; std-browse's REFETCH_QUERY/REFETCH_FILTER/REFETCH_PAGE: a render here
+      ;; would swap the whole board tree on every keystroke. The fetch runs in
+      ;; the background; the BoardItemsLoaded arm below already recomputes
+      ;; @entity.boards, which the mounted data-grid is bound to, so the grid
+      ;; updates in place with no unmount/flicker.
+      REFETCH_QUERY -> viewing_board
+        (fetch BoardView {
+          emit: { failure: BoardItemsLoadFailed, success: BoardItemsLoaded }
+          filter: (or ["=", ?searchTerm, ""] (str/includes (object/get @entity title) ?searchTerm))
+        })
+      REFETCH_FILTER -> viewing_board
+        (fetch BoardView {
+          emit: { failure: BoardItemsLoadFailed, success: BoardItemsLoaded }
+          filter: (or ["=", ?value, ""] ["=", (object/get @entity ?field), ?value])
+        })
+      ;; A board's columns are not a paged list — paging the underlying fetch
+      ;; would show only one page's worth of items spread across all columns,
+      ;; which is wrong kanban UX. This arm exists so a consumer CAN wire
+      ;; std-pagination if they have a reason to; std-board itself never
+      ;; renders a pagination control (see bodyContent/kanbanClassicBodyContent).
+      REFETCH_PAGE -> viewing_board
+        (fetch BoardView {
+          emit: { failure: BoardItemsLoadFailed, success: BoardItemsLoaded }
+          limit: @config.pageSize
+          offset: ["*", ["-", ?page, 1], @config.pageSize]
+        })
       BoardItemsLoaded -> viewing_board
         (set @entity.boards (array/map @config.columns (fn col {
           count: (array/len (array/filter ?data (fn item ["=", (object/get @item @config.groupByField), (object/get @col key)])))
@@ -422,6 +450,25 @@ orbital BoardOrbital {
         @description "Indicates a board card has been removed."
         @synonyms "remove, discard, delete"
         @tier "presentation"
+      REFETCH_QUERY {
+        searchTerm : string!
+      }
+        @description "Triggers a board refresh based on the current search query."
+        @synonyms "refresh, reload, update, re-query"
+        @tier "domain"
+      REFETCH_FILTER {
+        field : string!
+        value : string!
+      }
+        @description "Triggers a board refresh based on current filter criteria."
+        @synonyms "refresh, filter, update, reload"
+        @tier "domain"
+      REFETCH_PAGE {
+        page : number!
+      }
+        @description "Triggers a board refresh for a given page. std-board itself renders no pagination control; this exists so a composed std-pagination can drive one."
+        @synonyms "reload, refresh, update, paginate"
+        @tier "domain"
       BoardItemsLoaded {
         data : [ObjectSpec]
       }
@@ -508,6 +555,31 @@ orbital BoardOrbital {
         @label "Board look"
         @description "Layer 3 body layout: default N-column data-grid ('columns'), or a Trello-style wide-column kanban with sticky column headers ('kanban-classic')."
         @tier "presentation"
+      bodySearch : boolean = false
+        @label "Show the board's own search box?"
+        @description "Renders an inline search box above the columns. Defaults false: unlike std-browse, std-board has never had a search box, so defaulting this true would silently add one to every existing consumer. The wired path — composing std-search beside the board and routing its FILTER/SEARCH event to REFETCH_QUERY — works regardless of this knob; set true only for a standalone board with no page-level search affordance."
+        @synonyms "inline search, board search, built-in search, show search, duplicate search"
+        @tier "presentation"
+      searchPlaceholder : string = "Search…"
+        @label "Search box placeholder text"
+        @description "Hint text inside the board's embedded search box (e.g. 'Search cards…'). Only shown when bodySearch is true."
+        @synonyms "search hint, placeholder, search box text, search label"
+        @tier "presentation"
+      filters : [FilterSpec] = []
+        @label "Which filters should appear above the board?"
+        @description "Dropdown filter facets by field, rendered as an embedded filter bar above the columns; each selection fires REFETCH_FILTER on this trait. Empty (the default) = no filter bar, which is the right setting whenever the page already composes std-filter beside this board and routes its FILTER event to REFETCH_FILTER — that is the wired owner and remains the primary path. Use this knob only for a standalone board with no page-level filter affordance."
+        @synonyms "filter bar, faceted filters, field filters, column filters, dropdowns"
+        @tier "presentation"
+      filterBarLook : "toolbar" | "chips" | "pills" | "popover-trigger" | "inline-column-header" = toolbar
+        @label "Filter bar look"
+        @description "Visual treatment for the embedded filter bar, mirroring std-filter's own enum. Only applies when `filters` is non-empty."
+        @synonyms "filter bar style, facet style, chips, pills"
+        @tier "presentation"
+      pageSize : number = 10
+        @label "Fetch page size"
+        @description "Records fetched per REFETCH_PAGE request. std-board renders no pagination control itself — this only feeds the fetch limit/offset when a consumer wires a composed std-pagination to REFETCH_PAGE."
+        @synonyms "fetch limit, records per page, batch size, page limit"
+        @tier "presentation"
       cardActionsContent : render-ui = {
         align: center
         children: [{
@@ -536,7 +608,37 @@ orbital BoardOrbital {
           direction: horizontal
           gap: sm
           type: stack
-        }, { type: divider }, {
+        }, { type: divider }, (if @config.bodySearch {
+          children: [{
+            className: "w-full max-w-md"
+            clearable: true
+            event: REFETCH_QUERY
+            placeholder: @config.searchPlaceholder
+            type: search-input
+          }]
+          direction: horizontal
+          gap: sm
+          type: stack
+        } {
+          children: []
+          gap: none
+          type: stack
+        }), (if [">", (array/len @config.filters), 0] {
+          children: [{
+            entity: BoardView
+            event: REFETCH_FILTER
+            filters: @config.filters
+            look: @config.filterBarLook
+            type: filter-group
+          }]
+          direction: horizontal
+          gap: sm
+          type: stack
+        } {
+          children: []
+          gap: none
+          type: stack
+        }), {
           cols: @config.gridCols
           dndRoot: true
           entity: @entity.boards
@@ -636,7 +738,39 @@ orbital BoardOrbital {
           direction: horizontal
           gap: sm
           type: stack
-        }, { type: divider }, {
+        }, { type: divider }, (if @config.bodySearch {
+          children: [{
+            className: "w-full max-w-md"
+            clearable: true
+            event: REFETCH_QUERY
+            placeholder: @config.searchPlaceholder
+            type: search-input
+          }]
+          className: px-card-md
+          direction: horizontal
+          gap: sm
+          type: stack
+        } {
+          children: []
+          gap: none
+          type: stack
+        }), (if [">", (array/len @config.filters), 0] {
+          children: [{
+            entity: BoardView
+            event: REFETCH_FILTER
+            filters: @config.filters
+            look: @config.filterBarLook
+            type: filter-group
+          }]
+          className: px-card-md
+          direction: horizontal
+          gap: sm
+          type: stack
+        } {
+          children: []
+          gap: none
+          type: stack
+        }), {
           className: "w-full pb-2"
           dndRoot: true
           entity: @entity.boards

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

@@ -359,7 +359,7 @@ orbital BrowseItemOrbital {
         @tier "internal"
       filters : [FilterSpec] = []
         @label "Which filters should appear above the list?"
-        @description "Dropdown filter facets by field. Each fires a refetch when the user changes the selection. Empty = no filter bar."
+        @description "Dropdown filter facets by field, rendered as an embedded filter bar above the rows; each selection fires REFETCH_FILTER on this trait. Empty (the default) = no filter bar, which is the right setting whenever the page already composes std-filter beside this list and routes `XFilter.FILTER -> REFETCH_FILTER` — that is the wired owner and remains the primary path. Use this knob only for a standalone list with no page-level filter affordance, so the surface shows one filter bar instead of two."
         @synonyms "filter bar, faceted filters, field filters, column filters, dropdowns"
         @tier "presentation"
       maxInlineActions : number = 3
@@ -402,6 +402,11 @@ orbital BrowseItemOrbital {
         @description "Hint text inside the list search box (e.g. 'Search orders…')."
         @synonyms "search hint, placeholder, search box text, search label"
         @tier "presentation"
+      filterBarLook : "toolbar" | "chips" | "pills" | "popover-trigger" | "inline-column-header" = toolbar
+        @label "Filter bar look"
+        @description "Visual treatment for the embedded filter bar, mirroring std-filter's own enum. Only applies when `filters` is non-empty."
+        @synonyms "filter bar style, facet style, chips, pills"
+        @tier "presentation"
       viewPattern : pattern = data-grid
         @label "Render pattern"
         @description "UI pattern used to render the collection. Used by the default bodyContent tree; Layer 3 variants override bodyContent directly instead and may ignore this knob."
@@ -421,12 +426,43 @@ orbital BrowseItemOrbital {
         @synonyms "record actions, detail actions, pane actions"
         @tier "presentation"
       bodyContent : render-ui = {
-        children: [@trait.DataGrid1]
+        children: [(if @config.bodySearch {
+          children: [{
+            className: "w-full max-w-md"
+            clearable: true
+            event: REFETCH_QUERY
+            placeholder: @config.searchPlaceholder
+            type: search-input
+          }]
+          direction: horizontal
+          gap: sm
+          type: stack
+        } {
+          children: []
+          gap: none
+          type: stack
+        }), (if [">", (array/len @config.filters), 0] {
+          children: [{
+            entity: BrowseItem
+            event: REFETCH_FILTER
+            filters: @config.filters
+            look: @config.filterBarLook
+            type: filter-group
+          }]
+          direction: horizontal
+          gap: sm
+          type: stack
+        } {
+          children: []
+          gap: none
+          type: stack
+        }), @trait.DataGrid1]
         direction: vertical
+        gap: md
         type: stack
       }
         @label "Body content tree"
-        @description "Render-ui SExpr rendered after rows load when browseLook = table (the default). Composes the canonical data-grid call wrapped in a stack. See denseBodyContent/feedBodyContent/galleryBodyContent for the other browseLook bodies; any may be overridden directly while inheriting the same trait, state machine, emits, and listens."
+        @description "Render-ui SExpr rendered after rows load when browseLook = table (the default). Toolbar (search when bodySearch, filter bar when filters is non-empty) above the canonical data-grid call. Until 2026-08-27 this was the only one of the six looks with no search affordance at all. See denseBodyContent/feedBodyContent/galleryBodyContent for the other browseLook bodies; any may be overridden directly while inheriting the same trait, state machine, emits, and listens."
         @tier "internal"
       denseBodyContent : render-ui = {
         children: [(if @config.bodySearch {
@@ -445,6 +481,22 @@ orbital BrowseItemOrbital {
           children: []
           gap: none
           type: stack
+        }), (if [">", (array/len @config.filters), 0] {
+          children: [{
+            entity: BrowseItem
+            event: REFETCH_FILTER
+            filters: @config.filters
+            look: @config.filterBarLook
+            type: filter-group
+          }]
+          className: "px-card-md py-card-sm border-b border-[var(--color-border)]"
+          direction: horizontal
+          gap: sm
+          type: stack
+        } {
+          children: []
+          gap: none
+          type: stack
         }), {
           children: [@trait.DenseTableView]
           className: overflow-x-auto
@@ -478,6 +530,22 @@ orbital BrowseItemOrbital {
           children: []
           gap: none
           type: stack
+        }), (if [">", (array/len @config.filters), 0] {
+          children: [{
+            entity: BrowseItem
+            event: REFETCH_FILTER
+            filters: @config.filters
+            look: @config.filterBarLook
+            type: filter-group
+          }]
+          className: w-full
+          direction: horizontal
+          gap: sm
+          type: stack
+        } {
+          children: []
+          gap: none
+          type: stack
         }), {
           entity: ?data
           fields: []
@@ -579,6 +647,22 @@ orbital BrowseItemOrbital {
           children: []
           gap: none
           type: stack
+        }), (if [">", (array/len @config.filters), 0] {
+          children: [{
+            entity: BrowseItem
+            event: REFETCH_FILTER
+            filters: @config.filters
+            look: @config.filterBarLook
+            type: filter-group
+          }]
+          className: w-full
+          direction: horizontal
+          gap: sm
+          type: stack
+        } {
+          children: []
+          gap: none
+          type: stack
         }), {
           className: w-full
           entity: ?data
@@ -615,6 +699,22 @@ orbital BrowseItemOrbital {
           children: []
           gap: none
           type: stack
+        }), (if [">", (array/len @config.filters), 0] {
+          children: [{
+            entity: BrowseItem
+            event: REFETCH_FILTER
+            filters: @config.filters
+            look: @config.filterBarLook
+            type: filter-group
+          }]
+          className: "px-card-md py-card-sm border-b border-[var(--color-border)]"
+          direction: horizontal
+          gap: sm
+          type: stack
+        } {
+          children: []
+          gap: none
+          type: stack
         }), {
           children: [{
             entity: ?data
@@ -638,7 +738,7 @@ orbital BrowseItemOrbital {
         @description "Render-ui SExpr rendered after rows load when browseLook = triage. Inbox-register queue: one surface with a toolbar search and compact list rows (title + badges + inline meta) built for keyboard-pace queue work; row actions collapse per maxInlineActions. Composes fields/itemActions/searchPlaceholder/bodySearch."
         @tier "internal"
       masterDetailBodyContent : render-ui = {
-        children: [{
+        children: [(if @config.bodySearch {
           children: [{
             className: "w-full max-w-md"
             clearable: true
@@ -650,7 +750,27 @@ orbital BrowseItemOrbital {
           direction: horizontal
           gap: sm
           type: stack
-        }, {
+        } {
+          children: []
+          gap: none
+          type: stack
+        }), (if [">", (array/len @config.filters), 0] {
+          children: [{
+            entity: BrowseItem
+            event: REFETCH_FILTER
+            filters: @config.filters
+            look: @config.filterBarLook
+            type: filter-group
+          }]
+          className: "px-card-md py-card-sm border-b border-[var(--color-border)]"
+          direction: horizontal
+          gap: sm
+          type: stack
+        } {
+          children: []
+          gap: none
+          type: stack
+        }), {
           detail: {
             children: []
             gap: none
@@ -678,10 +798,10 @@ orbital BrowseItemOrbital {
         type: stack
       }
         @label "Master-detail look body (no selection)"
-        @description "Render-ui SExpr rendered after rows load when browseLook = master-detail: record-work split view — toolbar search, dense list left, empty-state pane right until a row is opened. Opening a row renders masterDetailRecordBodyContent. The toolbar is always present in this look (bodySearch does not apply)."
+        @description "Render-ui SExpr rendered after rows load when browseLook = master-detail: record-work split view — toolbar, dense list left, empty-state pane right until a row is opened. Opening a row renders masterDetailRecordBodyContent. The toolbar honours bodySearch and filters like every other look; it used to render its search box unconditionally, which put a second search box on any page that already composed std-search (observed in std-crm ContactOrbital)."
         @tier "internal"
       masterDetailRecordBodyContent : render-ui = {
-        children: [{
+        children: [(if @config.bodySearch {
           children: [{
             className: "w-full max-w-md"
             clearable: true
@@ -693,7 +813,27 @@ orbital BrowseItemOrbital {
           direction: horizontal
           gap: sm
           type: stack
-        }, {
+        } {
+          children: []
+          gap: none
+          type: stack
+        }), (if [">", (array/len @config.filters), 0] {
+          children: [{
+            entity: BrowseItem
+            event: REFETCH_FILTER
+            filters: @config.filters
+            look: @config.filterBarLook
+            type: filter-group
+          }]
+          className: "px-card-md py-card-sm border-b border-[var(--color-border)]"
+          direction: horizontal
+          gap: sm
+          type: stack
+        } {
+          children: []
+          gap: none
+          type: stack
+        }), {
           detail: {
             actions: @config.detailActions
             fieldNames: @config.detailFields