@almadar/std 16.144.0 → 16.145.0

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

@@ -11,10 +11,11 @@ orbital CalendarEventOrbital {
     description : string @description "event details or notes" @synonyms "details, notes, body, summary"
     status : "active" | "inactive" | "pending" @description "event lifecycle status" @synonyms "state, stage, phase" = active
     createdAt : string
-    date : datetime @intrinsic = ""
+    date : datetime @intrinsic
     time : string @description "event start time of day" @synonyms "start, scheduled time, begins, when, start time" = ""
     duration : number @description "event length in minutes" @synonyms "minutes, length, span, duration" = 60
     selectedRange : string @intrinsic = month
+    weekAnchor : date @intrinsic
   }
 
   trait CalendarEventCalendar -> @rebindable CalendarEvent [interaction, collection] {
@@ -22,6 +23,7 @@ orbital CalendarEventOrbital {
 
     state loading {
       INIT -> loading
+        (set @entity.weekAnchor (time/now))
         (fetch CalendarEvent {
           emit: { failure: CalendarEventLoadFailed, success: CalendarEventLoaded }
         })
@@ -87,6 +89,16 @@ orbital CalendarEventOrbital {
           emit: { failure: CalendarEventLoadFailed, success: CalendarEventLoaded }
           filter: (time/isAfter (time/parse @entity.date) (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 }
+        })
+      CALENDAR_NEXT_WEEK -> loading
+        (set @entity.weekAnchor (time/add @entity.weekAnchor 1 week))
+        (fetch CalendarEvent {
+          emit: { failure: CalendarEventLoadFailed, success: CalendarEventLoaded }
+        })
     }
 
     state error {
@@ -106,6 +118,11 @@ orbital CalendarEventOrbital {
         @description "Indicates a failure to load calendar events."
         @synonyms "error, failed, problem, loading issue"
         @tier "internal"
+      @config.onEventClick -> external {
+        event : object
+      }
+        @description "Emitted when a calendar chip is clicked: UI:{onEventClick} with { event } carrying the clicked row."
+        @tier "presentation"
     }
 
     listens {
@@ -128,6 +145,14 @@ orbital CalendarEventOrbital {
         @description "Indicates a failure to load calendar events."
         @synonyms "error, failure, problem, failed"
         @tier "internal"
+      CALENDAR_PREV_WEEK
+        @description "Move the week timeline one week earlier."
+        @synonyms "previous week, back a week, earlier week, last week"
+        @tier "domain"
+      CALENDAR_NEXT_WEEK
+        @description "Move the week timeline one week later."
+        @synonyms "next week, forward a week, later week, following week"
+        @tier "domain"
     }
 
     config {
@@ -151,6 +176,16 @@ orbital CalendarEventOrbital {
         @label "Description binding"
         @description "Per-row binding for the event description slot."
         @tier "presentation"
+      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."
+        @synonyms "start column, date column, when field, timestamp field"
+        @tier "presentation"
+      onEventClick : string = ""
+        @label "On Event Click"
+        @description "Event emitted when a calendar chip is clicked: UI:{onEventClick} with { event } carrying the clicked row. Empty means chips are not clickable."
+        @synonyms "open event, event click, select event, chip click"
+        @tier "presentation"
       calendarLook : "month" | "agenda-list" | "week-timeline" = month
         @label "Calendar look"
         @description "Layer 3 body layout: default month-grid + upcoming-events list ('month'), day-grouped agenda list ('agenda-list'), or 7-column week timeline ('week-timeline')."
@@ -181,7 +216,17 @@ orbital CalendarEventOrbital {
           gap: md
           justify: between
           type: stack
-        }, { type: divider }, { events: ?data, type: calendar-grid }, { type: divider }, {
+        }, { type: divider }, {
+          events: ?data
+          onEventClick: @config.onEventClick
+          renderItem: (fn item {
+            content: @config.titleBinding
+            type: typography
+            variant: small
+          })
+          startField: @config.startField
+          type: calendar-grid
+        }, { type: divider }, {
           content: "Upcoming Events"
           type: typography
           variant: h4
@@ -331,6 +376,29 @@ orbital CalendarEventOrbital {
             direction: horizontal
             gap: sm
             type: stack
+          }, {
+            align: center
+            children: [{
+              action: CALENDAR_PREV_WEEK
+              icon: chevron-left
+              label: "Previous week"
+              type: button
+              variant: ghost
+            }, {
+              color: muted
+              content: (time/format @entity.weekAnchor "MMM D, YYYY")
+              type: typography
+              variant: caption
+            }, {
+              action: CALENDAR_NEXT_WEEK
+              icon: chevron-right
+              label: "Next week"
+              type: button
+              variant: ghost
+            }]
+            direction: horizontal
+            gap: xs
+            type: stack
           }, {
             onSelect: SELECT_DAY
             selected: @entity.selectedRange
@@ -344,7 +412,17 @@ orbital CalendarEventOrbital {
           className: w-full
           dayWindow: 7
           events: ?data
+          onEventClick: @config.onEventClick
+          renderItem: (fn item {
+            content: @config.titleBinding
+            type: typography
+            variant: small
+          })
+          startField: @config.startField
+          swipeLeftEvent: CALENDAR_NEXT_WEEK
+          swipeRightEvent: CALENDAR_PREV_WEEK
           type: calendar-grid
+          weekStart: @entity.weekAnchor
         }]
         direction: vertical
         gap: md

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

@@ -46,7 +46,7 @@ orbital TypographyOrbital {
         @tier "presentation"
       weight : "none" | "light" | "normal" | "medium" | "semibold" | "bold" = none
         @label "Weight"
-        @description "Font weight override"
+        @description "Font weight override — `none` = no override, the variant's baked weight applies"
         @tier "presentation"
       size : "none" | "xs" | "sm" | "md" | "lg" | "xl" | "2xl" | "3xl" = none
         @label "Size"

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

@@ -30,6 +30,9 @@ orbital CalendarGridOrbital {
           swipeLeftEvent: @config.swipeLeftEvent
           swipeRightEvent: @config.swipeRightEvent
           dayWindow: @config.dayWindow
+          titleField: @config.titleField
+          startField: @config.startField
+          colorField: @config.colorField
           type: calendar-grid
         })
       CalendarGridLoaded -> idle
@@ -46,6 +49,9 @@ orbital CalendarGridOrbital {
           swipeLeftEvent: @config.swipeLeftEvent
           swipeRightEvent: @config.swipeRightEvent
           dayWindow: @config.dayWindow
+          titleField: @config.titleField
+          startField: @config.startField
+          colorField: @config.colorField
           type: calendar-grid
         })
     }
@@ -134,6 +140,18 @@ orbital CalendarGridOrbital {
         @label "Day Window"
         @description "Override the viewport-driven day window. `'auto'` (default) tracks `window.innerWidth` — 1 day on mobile, 3 on tablet, 7 on laptop+. Pass an explicit number to force a fixed window (useful for print layouts or screenshot tests)."
         @tier "presentation"
+      titleField : string = title
+        @label "Title Field"
+        @description "Row field holding the chip label. Defaults to `title`. Lets a host bound to its own entity name the column instead of being forced to rename its fields to this grid's contract (same accessor idiom as `DataList`'s `senderField` / `DataGrid`'s `imageField`)."
+        @tier "presentation"
+      startField : string = startTime
+        @label "Start Field"
+        @description "Row field holding the start timestamp (ISO or epoch). Defaults to `startTime`."
+        @tier "presentation"
+      colorField : string = color
+        @label "Color Field"
+        @description "Row field holding the chip's Tailwind colour class. Defaults to `color`."
+        @tier "presentation"
     }
   }
 

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

@@ -106,6 +106,8 @@ orbital DataGridOrbital {
           look: @config.look
           type: data-grid
         })
+      VIEW -> idle
+        (emit VIEW {})
     }
 
     emits {

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

@@ -18,8 +18,7 @@ orbital DataListOrbital {
   }
   type DataListItemActionsItem = {
     label : string!
-    event : string
-    navigatesTo : string
+    event : string!
     icon : icon
     variant : "primary" | "secondary" | "ghost" | "danger"
   }
@@ -123,6 +122,8 @@ orbital DataListOrbital {
           look: @config.look
           type: data-list
         })
+      VIEW -> idle
+        (emit VIEW {})
     }
 
     emits {

package/behaviors/lolo/ui/core/molecules/ui-filter-group.lolo

@@ -30,6 +30,8 @@ orbital FilterGroupOrbital {
           query: @config.query
           isLoading: @config.isLoading
           look: @config.look
+          event: @config.event
+          clearEvent: @config.clearEvent
           type: filter-group
         })
     }
@@ -46,6 +48,16 @@ orbital FilterGroupOrbital {
       }
         @description "Callback to clear all filters"
         @tier "essential"
+      @config.event -> external {
+        id : string
+      }
+        @description "Declarative filter event — emits UI:{event} via eventBus on filter change (alongside canonical UI:FILTER)"
+        @tier "essential"
+      @config.clearEvent -> external {
+        id : string
+      }
+        @description "Declarative clear event — emits UI:{clearEvent} via eventBus on clear-all (alongside canonical UI:CLEAR_FILTERS)"
+        @tier "essential"
     }
 
     config {
@@ -85,6 +97,14 @@ orbital FilterGroupOrbital {
         @label "Look"
         @description "Layer 2 visual treatment — orthogonal to the semantic variant."
         @tier "presentation"
+      event : string = "EVENT"
+        @label "Event"
+        @description "Declarative filter event — emits UI:{event} via eventBus on filter change (alongside canonical UI:FILTER)"
+        @tier "presentation"
+      clearEvent : string = "CLEAR"
+        @label "Clear Event"
+        @description "Declarative clear event — emits UI:{clearEvent} via eventBus on clear-all (alongside canonical UI:CLEAR_FILTERS)"
+        @tier "presentation"
     }
   }
 

package/behaviors/lolo/ui/core/molecules/ui-search-input.lolo

@@ -49,6 +49,11 @@ orbital SearchInputOrbital {
       }
         @description "Callback when search value changes"
         @tier "essential"
+      @config.event -> external {
+        id : string
+      }
+        @description "Declarative search event — emits UI:{event} via eventBus on query submit (alongside canonical UI:SEARCH)"
+        @tier "essential"
     }
 
     listens {
@@ -86,9 +91,9 @@ orbital SearchInputOrbital {
         @label "Class Name"
         @description "Additional CSS classes"
         @tier "presentation"
-      event : string
+      event : string = "EVENT"
         @label "Event"
-        @description "Event name to dispatch on search (schema metadata, wired by trait) This is metadata used by the trait generator, not by the component."
+        @description "Declarative search event — emits UI:{event} via eventBus on query submit (alongside canonical UI:SEARCH)"
         @tier "presentation"
       query : string
         @label "Query"

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

@@ -31,8 +31,7 @@ orbital TableViewOrbital {
   }
   type TableViewItemActionsItem = {
     label : string!
-    event : string
-    navigatesTo : string
+    event : string!
     icon : icon
     variant : "primary" | "secondary" | "ghost" | "danger"
   }
@@ -112,6 +111,8 @@ orbital TableViewOrbital {
           look: @config.look
           type: table-view
         })
+      VIEW -> idle
+        (emit VIEW {})
     }
 
     emits {

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

@@ -96,6 +96,8 @@ orbital EntityCardsOrbital {
           imageField: @config.imageField
           type: entity-cards
         })
+      VIEW -> idle
+        (emit VIEW {})
     }
 
     emits {

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

@@ -74,6 +74,8 @@ orbital EntityListOrbital {
           fieldNames: @config.fieldNames
           type: entity-list
         })
+      VIEW -> idle
+        (emit VIEW {})
     }
 
     emits {

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

@@ -120,6 +120,8 @@ orbital EntityTableOrbital {
           look: @config.look
           type: entity-table
         })
+      VIEW -> idle
+        (emit VIEW {})
     }
 
     emits {

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

@@ -59,6 +59,8 @@ orbital TimelineOrbital {
           look: @config.look
           type: timeline
         })
+      VIEW -> idle
+        (emit VIEW {})
     }
 
     emits {