@almadar/std 16.187.0 → 16.189.0

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

@@ -1,6 +1,7 @@
 app std-calendar "1.4.0"
 "std-calendar as a Function — owns the fetch + SELECT_DAY state machine; default bodyContent renders the month-grid + upcoming-events tree. `config.calendarLook` switches the body between the default month-grid ('month'), a day-grouped agenda list ('agenda-list'), and a 7-column week timeline ('week-timeline') while inheriting the same trait, state machine, emits, and listens."
 type ItemAction = { label : string!, event : string, navigatesTo : string, variant : primary | secondary | ghost | danger, icon : string }
+type FilterSpec = { field : string!, label : string, options : [string] }
 orbital CalendarEventOrbital {
     type CalendarEventLoaded = Event { data : [CalendarEvent] } "Fired when CalendarEvent finishes loading; payload.data holds the events"
 
@@ -27,6 +28,7 @@ orbital CalendarEventOrbital {
         (set @entity.weekAnchor (time/now))
         (fetch CalendarEvent {
           emit: { failure: CalendarEventLoadFailed, success: CalendarEventLoaded }
+          include: @config.include
         })
         (render-ui main {
           align: center
@@ -81,6 +83,7 @@ orbital CalendarEventOrbital {
       INIT -> loading
         (fetch CalendarEvent {
           emit: { failure: CalendarEventLoadFailed, success: CalendarEventLoaded }
+          include: @config.include
         })
         (render-ui main { type: spinner })
       SELECT_DAY -> loading
@@ -89,17 +92,36 @@ orbital CalendarEventOrbital {
         ;; hardcoded `date`, which retargeted consumers (startField=startTime) lack
         (fetch CalendarEvent {
           emit: { failure: CalendarEventLoadFailed, success: CalendarEventLoaded }
+          include: @config.include
           filter: (time/isAfter (time/parse (object/get @entity @config.startField)) (if ["=", ?value, week] (time/subtract (time/now) 1 week) (if ["=", ?value, "3months"] (time/subtract (time/now) 3 month) (if ["=", ?value, year] (time/subtract (time/now) 1 year) (time/subtract (time/now) 1 month)))))
         })
       CALENDAR_PREV_WEEK -> loading
         (set @entity.weekAnchor (time/subtract @entity.weekAnchor 1 week))
         (fetch CalendarEvent {
           emit: { failure: CalendarEventLoadFailed, success: CalendarEventLoaded }
+          include: @config.include
         })
       CALENDAR_NEXT_WEEK -> loading
         (set @entity.weekAnchor (time/add @entity.weekAnchor 1 week))
         (fetch CalendarEvent {
           emit: { failure: CalendarEventLoadFailed, success: CalendarEventLoaded }
+          include: @config.include
+        })
+      ;; Same no-render-ui shape as SELECT_DAY/CALENDAR_*_WEEK above: transition
+      ;; to `loading` without repainting, so the current grid/agenda/timeline
+      ;; stays mounted until CalendarEventLoaded's own render-ui fires — a
+      ;; repaint here would flicker the toolbar's search-input every keystroke.
+      REFETCH_QUERY -> loading
+        (fetch CalendarEvent {
+          emit: { failure: CalendarEventLoadFailed, success: CalendarEventLoaded }
+          include: @config.include
+          filter: (or ["=", ?searchTerm, ""] (str/includes (object/get @entity name) ?searchTerm))
+        })
+      REFETCH_FILTER -> loading
+        (fetch CalendarEvent {
+          emit: { failure: CalendarEventLoadFailed, success: CalendarEventLoaded }
+          include: @config.include
+          filter: (or ["=", ?value, ""] ["=", (object/get @entity ?field), ?value])
         })
     }
 
@@ -107,6 +129,7 @@ orbital CalendarEventOrbital {
       INIT -> loading
         (fetch CalendarEvent {
           emit: { failure: CalendarEventLoadFailed, success: CalendarEventLoaded }
+          include: @config.include
         })
         (render-ui main { type: spinner })
       ;; the error screen's Retry button: INIT is lifecycle-only and the bus never
@@ -114,6 +137,7 @@ orbital CalendarEventOrbital {
       RETRY -> loading
         (fetch CalendarEvent {
           emit: { failure: CalendarEventLoadFailed, success: CalendarEventLoaded }
+          include: @config.include
         })
         (render-ui main { type: spinner })
     }
@@ -128,9 +152,11 @@ orbital CalendarEventOrbital {
         @synonyms "error, failed, problem, loading issue"
         @tier "internal"
       @config.onEventClick -> external {
-        event : object
+        event : @entity
+        id : string
+        row : @entity
       }
-        @description "Emitted when a calendar chip is clicked: UI:{onEventClick} with { event } carrying the clicked row."
+        @description "Emitted when a calendar chip is clicked ({ event } carries the clicked row) or an agenda/upcoming row action fires ({ id, row }). Consumers routing it should read the row from ?event or ?row, whichever the payload carries."
         @tier "presentation"
     }
 
@@ -162,6 +188,19 @@ orbital CalendarEventOrbital {
         @description "Move the week timeline one week later."
         @synonyms "next week, forward a week, later week, following week"
         @tier "domain"
+      REFETCH_QUERY {
+        searchTerm : string!
+      }
+        @description "Triggers a data refresh based on the current query."
+        @synonyms "refresh, reload, update, re-query"
+        @tier "domain"
+      REFETCH_FILTER {
+        field : string!
+        value : string!
+      }
+        @description "Triggers a data refresh based on current filter criteria."
+        @synonyms "refresh, filter, update, reload"
+        @tier "domain"
     }
 
     config {
@@ -185,6 +224,11 @@ orbital CalendarEventOrbital {
         @label "Description binding"
         @description "Per-row binding for the event description slot."
         @tier "presentation"
+      include : [string] = []
+        @label "Which relation fields to hydrate?"
+        @description "Entity relation field names to hydrate on fetch (e.g. a `category : Category` field named `category`), so chip bindings can use dot-paths like @item.category.name. Empty = no hydration, the default."
+        @synonyms "relation hydration, populate relations, joined fields, hydrate relations"
+        @tier "internal"
       startField : string = "date"
         @label "Start field"
         @description "Row column holding the timestamp the calendar grid places each chip by. Rebound hosts point this at their own column (e.g. startTime, startsAt, dueAt); the chip's LABEL comes from titleBinding, not from here."
@@ -203,7 +247,7 @@ orbital CalendarEventOrbital {
         @label "Title"
         @description "Header text shown above the calendar body."
         @tier "presentation"
-      agendaItemActions : [ItemAction] = [{ event: SELECT_DAY, icon: eye, label: View }]
+      agendaItemActions : [ItemAction] = []
         @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"
@@ -213,6 +257,26 @@ orbital CalendarEventOrbital {
         @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"
+      bodySearch : boolean = false
+        @label "Show the calendar's own search box?"
+        @description "Embeds a title search box in the toolbar above the calendar body (all three calendarLook trees). Defaults false: std-calendar has never had a search box, so an untouched consumer's surface is unchanged; the primary path is composing std-search beside this atom and wiring XSearch.SEARCH -> REFETCH_QUERY. Set true only for a standalone calendar with no page-level search affordance."
+        @synonyms "inline search, calendar search, built-in search, show search, duplicate search"
+        @tier "presentation"
+      searchPlaceholder : string = "Search…"
+        @label "Search box placeholder text"
+        @description "Hint text inside the calendar's search box (e.g. 'Search events…')."
+        @synonyms "search hint, placeholder, search box text, search label"
+        @tier "presentation"
+      filters : [FilterSpec] = []
+        @label "Which filters should appear above the calendar?"
+        @description "Dropdown filter facets by field, rendered as an embedded filter bar above the calendar body (all three calendarLook trees); 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 calendar and routes XFilter.FILTER -> REFETCH_FILTER — that is the wired owner and remains the primary path. Use this knob only for a standalone calendar with no page-level filter affordance."
+        @synonyms "filter bar, faceted filters, field 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"
       bodyContent : render-ui = {
         children: [{
           align: center
@@ -235,7 +299,37 @@ orbital CalendarEventOrbital {
           gap: md
           justify: between
           type: stack
-        }, { 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: CalendarEvent
+            event: REFETCH_FILTER
+            filters: @config.filters
+            look: @config.filterBarLook
+            type: filter-group
+          }]
+          direction: horizontal
+          gap: sm
+          type: stack
+        } {
+          children: []
+          gap: none
+          type: stack
+        }), { type: divider }, {
           events: ?data
           onEventClick: @config.onEventClick
           renderItem: (fn item {
@@ -270,11 +364,7 @@ orbital CalendarEventOrbital {
             name: status
             variant: badge
           }]
-          itemActions: [{
-            event: SELECT_DAY
-            icon: eye
-            label: View
-          }]
+          itemActions: @config.agendaItemActions
           look: @config.tableLook
           type: data-list
         }]
@@ -307,7 +397,37 @@ orbital CalendarEventOrbital {
           gap: md
           justify: between
           type: stack
-        }, { 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: CalendarEvent
+            event: REFETCH_FILTER
+            filters: @config.filters
+            look: @config.filterBarLook
+            type: filter-group
+          }]
+          direction: horizontal
+          gap: sm
+          type: stack
+        } {
+          children: []
+          gap: none
+          type: stack
+        }), { type: divider }, {
           entity: ?data
           fields: []
           gap: md
@@ -429,7 +549,37 @@ orbital CalendarEventOrbital {
           gap: md
           justify: between
           type: stack
-        }, { 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: CalendarEvent
+            event: REFETCH_FILTER
+            filters: @config.filters
+            look: @config.filterBarLook
+            type: filter-group
+          }]
+          direction: horizontal
+          gap: sm
+          type: stack
+        } {
+          children: []
+          gap: none
+          type: stack
+        }), { type: divider }, {
           className: w-full
           dayWindow: 7
           events: ?data

package/behaviors/lolo/ui/core/atoms/std-event-log.lolo

@@ -2,6 +2,7 @@ app std-event-log "2.1.0"
 "std-event-log — generic chronological event feed (Stripe activity log / GitHub PR timeline / Linear event feed style). Renders a vertical `timeline` with type-coded dots, a single horizontal chip-bar of kind filters (All + per-kind), reverse-chronological sort, and an inline form for logging events that weren't auto-captured. `config.kindOptions` maps each kind → status/icon/label so consuming molecules/organisms get type-coded visuals without re-implementing topology. Topology = loading / viewing / backfilling / error."
 type ObjectSpec = { id : string, label : string, value : string }
 type KindOption = { label : string!, value : string! }
+type FilterSpec = { field : string!, label : string, options : [string] }
 orbital EventLogOrbital {
     type LogEntry = { id : string!, title : string!, description : string, date : string, status : "complete" | "active" | "pending" | "error", kind : "created" | "updated" | "approved" | "rejected" }
 
@@ -89,7 +90,37 @@ orbital EventLogOrbital {
             direction: horizontal
             gap: sm
             type: stack
-          }, {
+          }, (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: EventLogView
+              event: REFETCH_FILTER
+              filters: @config.filters
+              look: @config.filterBarLook
+              type: filter-group
+            }]
+            direction: horizontal
+            gap: sm
+            type: stack
+          } {
+            children: []
+            gap: none
+            type: stack
+          }), {
             activeTab: @entity.filterKind
             tabChangeEvent: APPLY_FILTER
             tabs: @entity.filterChips
@@ -155,7 +186,150 @@ orbital EventLogOrbital {
             direction: horizontal
             gap: sm
             type: stack
+          }, (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: EventLogView
+              event: REFETCH_FILTER
+              filters: @config.filters
+              look: @config.filterBarLook
+              type: filter-group
+            }]
+            direction: horizontal
+            gap: sm
+            type: stack
+          } {
+            children: []
+            gap: none
+            type: stack
+          }), {
+            activeTab: @entity.filterKind
+            tabChangeEvent: APPLY_FILTER
+            tabs: @entity.filterChips
+            type: tabs
           }, {
+            entity: @entity.entries
+            fields: (title description date status)
+            look: @config.timelineLook
+            type: timeline
+          }]
+          direction: vertical
+          gap: md
+          type: stack
+        })
+      ;; REFETCH_* stays in `viewing` and DOES NOT replace the timeline with a
+      ;; skeleton — same reasoning as std-browse's REFETCH_* arms: a skeleton
+      ;; on refetch unmounts the timeline and flickers every keystroke. The
+      ;; fetch fires in the background; the EventLogLoaded arm below re-renders
+      ;; in place once it lands. Each refetch also honours the current kind
+      ;; tab (@entity.filterKind) so search/generic-filter compound with it
+      ;; instead of resetting it.
+      REFETCH_QUERY -> viewing
+        (fetch EventLogView {
+          emit: { failure: EventLogLoadFailed, success: EventLogLoaded }
+          filter: (and (or ["=", @entity.filterKind, ""] ["=", (object/get @entity kind), @entity.filterKind]) (or ["=", ?searchTerm, ""] (str/includes (object/get @entity title) ?searchTerm)))
+        })
+      REFETCH_FILTER -> viewing
+        (fetch EventLogView {
+          emit: { failure: EventLogLoadFailed, success: EventLogLoaded }
+          filter: (and (or ["=", @entity.filterKind, ""] ["=", (object/get @entity kind), @entity.filterKind]) (or ["=", ?value, ""] ["=", (object/get @entity ?field), ?value]))
+        })
+      ;; No filter carried over on REFETCH_PAGE, mirroring std-browse exactly —
+      ;; the reference page arm does not preserve query/filter either.
+      REFETCH_PAGE -> viewing
+        (fetch EventLogView {
+          emit: { failure: EventLogLoadFailed, success: EventLogLoaded }
+          limit: @config.pageSize
+          offset: ["*", ["-", ?page, 1], @config.pageSize]
+        })
+      EventLogLoaded -> viewing
+        (set @entity.filterChips (array/prepend (array/map @config.kindOptions (fn k {
+          icon: (object/get @k icon circle)
+          id: (object/get @k key)
+          label: (object/get @k label)
+        })) {
+          icon: list
+          id: ""
+          label: All
+        }))
+        (set @entity.allEntries (array/sort (array/map ?data (fn row {
+          date: (object/get @row createdAt (object/get @row date ""))
+          description: (object/get @row description "")
+          id: (object/get @row id "")
+          kind: (object/get @row kind "")
+          status: (object/get (or (array/find @config.kindOptions (fn k ["=", (object/get @k key), (object/get @row kind "")])) {}) status pending)
+          title: (object/get @row title "")
+        })) date desc))
+        (set @entity.entries (array/sort (array/map ?data (fn row {
+          date: (object/get @row createdAt (object/get @row date ""))
+          description: (object/get @row description "")
+          id: (object/get @row id "")
+          kind: (object/get @row kind "")
+          status: (object/get (or (array/find @config.kindOptions (fn k ["=", (object/get @k key), (object/get @row kind "")])) {}) status pending)
+          title: (object/get @row title "")
+        })) date desc))
+        (render-ui main {
+          children: [{
+            align: center
+            children: [{ name: history, type: icon }, {
+              content: @config.title
+              type: typography
+              variant: h3
+            }, {
+              action: OPEN_BACKFILL
+              icon: plus
+              label: "Log event"
+              type: button
+              variant: primary
+            }]
+            direction: horizontal
+            gap: sm
+            type: stack
+          }, (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: EventLogView
+              event: REFETCH_FILTER
+              filters: @config.filters
+              look: @config.filterBarLook
+              type: filter-group
+            }]
+            direction: horizontal
+            gap: sm
+            type: stack
+          } {
+            children: []
+            gap: none
+            type: stack
+          }), {
             activeTab: @entity.filterKind
             tabChangeEvent: APPLY_FILTER
             tabs: @entity.filterChips
@@ -237,7 +411,37 @@ orbital EventLogOrbital {
             direction: horizontal
             gap: sm
             type: stack
-          }, {
+          }, (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: EventLogView
+              event: REFETCH_FILTER
+              filters: @config.filters
+              look: @config.filterBarLook
+              type: filter-group
+            }]
+            direction: horizontal
+            gap: sm
+            type: stack
+          } {
+            children: []
+            gap: none
+            type: stack
+          }), {
             activeTab: @entity.filterKind
             tabChangeEvent: APPLY_FILTER
             tabs: @entity.filterChips
@@ -354,6 +558,25 @@ orbital EventLogOrbital {
         @description "Indicates an attempt to save an event failed."
         @synonyms "error, failure, save failed"
         @tier "internal"
+      REFETCH_QUERY {
+        searchTerm : string!
+      }
+        @description "Triggers an activity feed refresh based on the current search term."
+        @synonyms "refresh, reload, update, re-query, search"
+        @tier "domain"
+      REFETCH_FILTER {
+        field : string!
+        value : string!
+      }
+        @description "Triggers an activity feed refresh based on a field/value filter, in addition to the built-in kind tabs."
+        @synonyms "refresh, filter, update, reload"
+        @tier "domain"
+      REFETCH_PAGE {
+        page : number!
+      }
+        @description "Triggers an activity feed page refresh."
+        @synonyms "reload, refresh, update, paginate"
+        @tier "domain"
     }
 
     config {
@@ -397,6 +620,36 @@ orbital EventLogOrbital {
         @label "Timeline look"
         @description "Layer 2 visual treatment for the timeline."
         @tier "presentation"
+      bodySearch : boolean = false
+        @label "Show the log's own search box?"
+        @description "Embeds a search box above the activity feed. Set true only when the page has no other search affordance (e.g. no page-level std-search), so the surface shows one search box instead of two. False is the default — no consumer of this atom has ever had a search box."
+        @synonyms "inline search, log search, built-in search, show search"
+        @tier "presentation"
+      searchPlaceholder : string = "Search activity…"
+        @label "Search box placeholder text"
+        @description "Hint text inside the log's search box."
+        @synonyms "search hint, placeholder, search box text"
+        @tier "presentation"
+      filters : [FilterSpec] = []
+        @label "Which filters should appear above the feed?"
+        @description "Dropdown filter facets by field, rendered as an embedded filter bar above the timeline; each selection fires REFETCH_FILTER on this trait, ANDed with the current kind tab. Empty (the default) = no filter bar — the right setting whenever the page already composes std-filter beside this atom and routes XFilter.FILTER -> REFETCH_FILTER, or relies solely on the built-in kind-filter chips (driven by kindOptions, which this knob does not duplicate or replace). Use this knob only for an extra facet beyond kind (e.g. actor, priority)."
+        @synonyms "filter bar, faceted filters, field 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 = 20
+        @label "How many entries per page when paging?"
+        @description "Records fetched from the server per REFETCH_PAGE request. The initial load and every search/kind/filter refetch stay unpaginated (load everything that matches) so the default unlimited activity feed is unchanged; only an explicit REFETCH_PAGE from a composed std-pagination control applies this limit."
+        @synonyms "fetch limit, records per page, page limit"
+        @tier "presentation"
+      displayPageSize : number = 20
+        @label "How many entries per page should a pager show?"
+        @description "Page size a consumer-composed std-pagination control should use to compute total pages (e.g. from totalCount). This atom's own timeline pattern has no built-in pager UI, so this knob is informational for the composed control, not consumed by the timeline itself."
+        @synonyms "visible rows, items per page, display limit"
+        @tier "presentation"
     }
   }