@almadar/std 16.196.0 → 16.198.0

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

@@ -31,9 +31,7 @@ orbital StackOrbital {
     }
 
     emits {
-      @config.action -> external {
-        id : string
-      }
+      @config.action -> external { }
         @description "Declarative event name — emits UI:{action} via eventBus on click"
         @tier "essential"
     }
@@ -91,7 +89,7 @@ orbital StackOrbital {
         @label "Action"
         @description "Declarative event name — emits UI:{action} via eventBus on click"
         @tier "presentation"
-      actionPayload : json = {}
+      actionPayload : @payload @config.action
         @label "Action Payload"
         @description "Payload to include with the action event"
         @tier "presentation"

package/behaviors/lolo/ui/core/atoms/ui-text-highlight.lolo

@@ -3,6 +3,7 @@ app ui-text-highlight "1.0.0"
 orbital TextHighlightOrbital {
   entity TextHighlightItem [runtime] {
     id : string!
+    annotationId : string
   }
 
   trait TextHighlightRender -> @rebindable TextHighlightItem [interaction, instance] {
@@ -10,13 +11,44 @@ orbital TextHighlightOrbital {
 
     state idle {
       INIT -> idle
+        (set @entity.annotationId @config.annotationId)
         (render-ui main {
           highlightType: @config.highlightType
           isActive: @config.isActive
           onClick: @config.onClick
           onMouseEnter: @config.onMouseEnter
           onMouseLeave: @config.onMouseLeave
-          annotationId: @config.annotationId
+          annotationId: @entity.annotationId
+          className: @config.className
+          children: @config.children
+          action: @config.action
+          hoverEvent: @config.hoverEvent
+          type: text-highlight
+        })
+      ACTION -> idle
+        (set @entity.annotationId ?annotationId)
+        (render-ui main {
+          highlightType: @config.highlightType
+          isActive: @config.isActive
+          onClick: @config.onClick
+          onMouseEnter: @config.onMouseEnter
+          onMouseLeave: @config.onMouseLeave
+          annotationId: @entity.annotationId
+          className: @config.className
+          children: @config.children
+          action: @config.action
+          hoverEvent: @config.hoverEvent
+          type: text-highlight
+        })
+      HOVER -> idle
+        (set @entity.annotationId ?annotationId)
+        (render-ui main {
+          highlightType: @config.highlightType
+          isActive: @config.isActive
+          onClick: @config.onClick
+          onMouseEnter: @config.onMouseEnter
+          onMouseLeave: @config.onMouseLeave
+          annotationId: @entity.annotationId
           className: @config.className
           children: @config.children
           action: @config.action
@@ -26,33 +58,38 @@ orbital TextHighlightOrbital {
     }
 
     emits {
-      @config.onClick -> external {
-        id : string
-      }
+      @config.onClick -> external { }
         @description "Callback when highlight is clicked"
         @tier "essential"
-      @config.onMouseEnter -> external {
-        id : string
-      }
+      @config.onMouseEnter -> external { }
         @description "Callback when highlight is hovered"
         @tier "essential"
-      @config.onMouseLeave -> external {
-        id : string
-      }
+      @config.onMouseLeave -> external { }
         @description "Callback when hover ends"
         @tier "essential"
       @config.action -> external {
-        id : string
+        annotationId : string
       }
         @description "Declarative event name — emits UI:{action} via eventBus on click"
         @tier "essential"
       @config.hoverEvent -> external {
-        id : string
+        hovered : boolean!
+        annotationId : string
       }
-        @description "Declarative hover event — emits UI:{hoverEvent} with { hovered: true/false }"
+        @description "Declarative hover event — emits UI:{hoverEvent} with { hovered, annotationId }"
         @tier "essential"
     }
 
+    listens {
+      ACTION {
+        annotationId : string
+      }
+      HOVER {
+        hovered : boolean!
+        annotationId : string
+      }
+    }
+
     config {
       highlightType : "question" | "note" = question
         @label "Highlight Type"
@@ -92,7 +129,7 @@ orbital TextHighlightOrbital {
         @tier "presentation"
       hoverEvent : event = "HOVER"
         @label "Hover Event"
-        @description "Declarative hover event — emits UI:{hoverEvent} with { hovered: true/false }"
+        @description "Declarative hover event — emits UI:{hoverEvent} with { hovered, annotationId }"
         @tier "presentation"
     }
   }

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

@@ -22,14 +22,10 @@ orbital TextareaOrbital {
     }
 
     emits {
-      @config.action -> external {
-        id : string
-      }
+      @config.action -> external { }
         @description "Declarative event name for trait dispatch"
         @tier "essential"
-      @config.onChange -> external {
-        id : string
-      }
+      @config.onChange -> external { }
         @description "onChange handler or declarative event key for trait dispatch"
         @tier "essential"
     }

package/behaviors/lolo/ui/core/atoms/ui-typewriter-text.lolo

@@ -21,9 +21,7 @@ orbital TypewriterTextOrbital {
     }
 
     emits {
-      @config.onComplete -> external {
-        id : string
-      }
+      @config.onComplete -> external { }
         @description "Called when the entire text has been revealed"
         @tier "essential"
     }

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

@@ -30,9 +30,7 @@ orbital VstackOrbital {
     }
 
     emits {
-      @config.action -> external {
-        id : string
-      }
+      @config.action -> external { }
         @description "Declarative event name — emits UI:{action} via eventBus on click"
         @tier "essential"
     }
@@ -86,7 +84,7 @@ orbital VstackOrbital {
         @label "Action"
         @description "Declarative event name — emits UI:{action} via eventBus on click"
         @tier "presentation"
-      actionPayload : json = {}
+      actionPayload : @payload @config.action
         @label "Action Payload"
         @description "Payload to include with the action event"
         @tier "presentation"

package/behaviors/lolo/ui/core/molecules/ui-alert.lolo

@@ -26,14 +26,10 @@ orbital AlertOrbital {
     }
 
     emits {
-      @config.onDismiss -> external {
-        id : string
-      }
+      @config.onDismiss -> external { }
         @description "onDismiss prop"
         @tier "essential"
-      @config.onClose -> external {
-        id : string
-      }
+      @config.onClose -> external { }
         @description "onClose prop"
         @tier "essential"
     }

package/behaviors/lolo/ui/core/molecules/ui-branching-logic-builder.lolo

@@ -13,6 +13,13 @@ orbital BranchingLogicBuilderOrbital {
     value : [string]!
     targetQuestionId : json!
   }
+  type BranchingLogicBuilderRULESCHANGERulesItem = {
+    id : string!
+    sourceQuestionId : string!
+    operator : "equals" | "not-equals" | "contains" | "in"!
+    value : [string]!
+    targetQuestionId : json!
+  }
 
   entity BranchingLogicBuilderItem [runtime] {
     id : string!
@@ -36,7 +43,7 @@ orbital BranchingLogicBuilderOrbital {
 
     emits {
       @config.onRulesChange -> external {
-        rules : [object]
+        rules : [BranchingLogicBuilderRULESCHANGERulesItem]
       }
         @description "onRulesChange prop"
         @tier "essential"

package/behaviors/lolo/ui/core/molecules/ui-breadcrumb.lolo

@@ -32,7 +32,9 @@ orbital BreadcrumbOrbital {
 
     emits {
       @config.itemEvent -> external {
-        id : string
+        label : string!
+        href : string
+        index : number!
       }
         @description "Event emitted when a non-current crumb is clicked, with payload `{ label, href, index }` — the trait handles it with `(navigate ?href)`. Without it, stack crumbs navigate directly."
         @tier "essential"

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

@@ -91,7 +91,7 @@ orbital CalendarGridOrbital {
         @description "Called when a day header is clicked"
         @tier "essential"
       @config.onEventClick -> external {
-        event : object
+        event : @entity
       }
         @description "Called when an event is clicked"
         @tier "essential"
@@ -101,14 +101,10 @@ orbital CalendarGridOrbital {
       }
         @description "Event emitted on long-press of a time slot: UI:{longPressEvent} with { date, time, ...longPressPayload }"
         @tier "essential"
-      @config.swipeLeftEvent -> external {
-        id : string
-      }
+      @config.swipeLeftEvent -> external { }
         @description "Event emitted on swipe left (next week): UI:{swipeLeftEvent}"
         @tier "essential"
-      @config.swipeRightEvent -> external {
-        id : string
-      }
+      @config.swipeRightEvent -> external { }
         @description "Event emitted on swipe right (prev week): UI:{swipeRightEvent}"
         @tier "essential"
       CalendarGridLoaded
@@ -146,7 +142,7 @@ orbital CalendarGridOrbital {
         @label "Long Press Event"
         @description "Event emitted on long-press of a time slot: UI:{longPressEvent} with { date, time, ...longPressPayload }"
         @tier "presentation"
-      longPressPayload : json = {}
+      longPressPayload : @payload @config.longPressEvent
         @label "Long Press Payload"
         @description "Additional payload for long-press events"
         @tier "presentation"

package/behaviors/lolo/ui/core/molecules/ui-carousel.lolo

@@ -33,7 +33,7 @@ orbital CarouselOrbital {
     }
 
     config {
-      items : [json] = []
+      items : [opaque] = []
         @label "Items"
         @description "Array of items to display as slides"
         @tier "presentation"
@@ -61,7 +61,7 @@ orbital CarouselOrbital {
         @label "Slide Change Event"
         @description "Declarative event name for slide change"
         @tier "presentation"
-      slideChangePayload : json = {}
+      slideChangePayload : @payload @config.slideChangeEvent
         @label "Slide Change Payload"
         @description "Payload to include with the slide change event"
         @tier "presentation"

package/behaviors/lolo/ui/core/molecules/ui-chart.lolo

@@ -26,7 +26,7 @@ orbital ChartOrbital {
   }
   type ChartActionsItem = {
     label : string!
-    event : string
+    event : event
     navigatesTo : string
     variant : "primary" | "secondary" | "ghost"
   }

package/behaviors/lolo/ui/core/molecules/ui-code-block.lolo

@@ -14,7 +14,7 @@ orbital CodeBlockOrbital {
   }
   type CodeBlockActionsItem = {
     label : string!
-    event : string
+    event : event
     navigatesTo : string
     variant : "primary" | "secondary" | "ghost"
   }

package/behaviors/lolo/ui/core/molecules/ui-confirm-dialog.lolo

@@ -54,14 +54,10 @@ orbital ConfirmDialogOrbital {
     }
 
     emits {
-      @config.onClose -> external {
-        id : string
-      }
+      @config.onClose -> external { }
         @description "Callback when dialog is closed (injected by slot wrapper)"
         @tier "essential"
-      @config.onConfirm -> external {
-        id : string
-      }
+      @config.onConfirm -> external { }
         @description "Callback when action is confirmed (injected by slot wrapper)"
         @tier "essential"
       OPEN -> external {

package/behaviors/lolo/ui/core/molecules/ui-content-renderer.lolo

@@ -8,7 +8,7 @@ orbital ContentRendererOrbital {
     stack : string
   }
   type ContentRendererSegmentsItem = {
-    type : "markdown" | "code" | "orbital" | "quiz"!
+    type : "markdown"!
     content : string!
   }
 

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

@@ -142,17 +142,16 @@ orbital DataGridOrbital {
 
     emits {
       @config.selectionEvent -> external {
-        id : string
+        selectedIds : [string]!
       }
         @description "Selection change event name (emits UI:{selectionEvent} with { selectedIds: string[] })"
         @tier "essential"
-      @config.loadMoreEvent -> external {
-        id : string
-      }
+      @config.loadMoreEvent -> external { }
         @description "Event emitted when more items needed: UI:{loadMoreEvent}"
         @tier "essential"
       VIEW -> external {
-        id : string
+        id : string!
+        row : @entity!
       }
         @description "User opened a record from the list."
         @tier "essential"

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

@@ -174,38 +174,30 @@ orbital DataListOrbital {
     }
 
     emits {
-      @config.reorderEvent -> external {
-        id : string
-      }
+      @config.reorderEvent -> external { }
         @description "Event emitted on reorder: UI:{reorderEvent} with { fromIndex, toIndex }"
         @tier "essential"
       @config.itemClickEvent -> external {
-        id : string
+        id : string!
+        row : @entity!
       }
         @description "When set, the whole row is clickable and emits UI:{itemClickEvent} with { id, row } (action-button clicks stopPropagation so they still win)."
         @tier "essential"
-      @config.swipeLeftEvent -> external {
-        id : string
-      }
+      @config.swipeLeftEvent -> external { }
         @description "Event emitted on left swipe: UI:{swipeLeftEvent} with { row }"
         @tier "essential"
-      @config.swipeRightEvent -> external {
-        id : string
-      }
+      @config.swipeRightEvent -> external { }
         @description "Event emitted on right swipe: UI:{swipeRightEvent} with { row }"
         @tier "essential"
-      @config.longPressEvent -> external {
-        id : string
-      }
+      @config.longPressEvent -> external { }
         @description "Event emitted on long press: UI:{longPressEvent} with { row }"
         @tier "essential"
-      @config.loadMoreEvent -> external {
-        id : string
-      }
+      @config.loadMoreEvent -> external { }
         @description "Event emitted when more items needed: UI:{loadMoreEvent}"
         @tier "essential"
       VIEW -> external {
-        id : string
+        id : string!
+        row : @entity!
       }
         @description "User opened a record from the list."
         @tier "essential"

package/behaviors/lolo/ui/core/molecules/ui-doc-sidebar.lolo

@@ -4,7 +4,7 @@ orbital DocSidebarOrbital {
   type DocSidebarItemsItem = {
     label : string!
     href : string
-    items : [json]
+    items : [opaque]
     active : boolean
   }
 

package/behaviors/lolo/ui/core/molecules/ui-document-details.lolo

@@ -59,7 +59,7 @@ orbital DocumentDetailsOrbital {
     emits {
       @config.metaCommitEvent -> external {
         id : string!
-        patch : object!
+        patch : Map string opaque!
       }
         @description "Emitted when a property commits: { id, patch } — patch carries the id plus the one changed field, ready for a partial persist update."
         @tier "essential"

package/behaviors/lolo/ui/core/molecules/ui-document-viewer.lolo

@@ -3,7 +3,7 @@ app ui-document-viewer "1.0.0"
 orbital DocumentViewerOrbital {
   type DocumentViewerActionsItem = {
     label : string!
-    event : string
+    event : event
     navigatesTo : string
     variant : "primary" | "secondary" | "ghost"
   }

package/behaviors/lolo/ui/core/molecules/ui-drawer.lolo

@@ -44,9 +44,7 @@ orbital DrawerOrbital {
     }
 
     emits {
-      @config.onClose -> external {
-        id : string
-      }
+      @config.onClose -> external { }
         @description "Callback when drawer should close (injected by slot wrapper)"
         @tier "essential"
       OPEN -> external {

package/behaviors/lolo/ui/core/molecules/ui-emoji-picker.lolo

@@ -22,7 +22,7 @@ orbital EmojiPickerOrbital {
 
     emits {
       @config.pickEvent -> external {
-        id : string
+        emoji : string!
       }
         @description "Declarative event name — picking an emoji emits UI:{pickEvent} with { emoji } via eventBus"
         @tier "essential"

package/behaviors/lolo/ui/core/molecules/ui-empty-state.lolo

@@ -27,9 +27,7 @@ orbital EmptyStateOrbital {
     }
 
     emits {
-      @config.onAction -> external {
-        id : string
-      }
+      @config.onAction -> external { }
         @description "onAction prop"
         @tier "essential"
     }

package/behaviors/lolo/ui/core/molecules/ui-error-state.lolo

@@ -22,9 +22,7 @@ orbital ErrorStateOrbital {
     }
 
     emits {
-      @config.onRetry -> external {
-        id : string
-      }
+      @config.onRetry -> external { }
         @description "onRetry prop"
         @tier "essential"
     }

package/behaviors/lolo/ui/core/molecules/ui-file-tree.lolo

@@ -5,7 +5,7 @@ orbital FileTreeOrbital {
     name : string!
     path : string!
     type : "file" | "dir"!
-    children : [json]
+    children : [opaque]
     size : number
     language : string
   }

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

@@ -15,6 +15,7 @@ orbital FilterGroupOrbital {
 
   entity FilterGroupItem [runtime] {
     id : string!
+    query : string
   }
 
   trait FilterGroupRender -> @rebindable FilterGroupItem [interaction, instance] {
@@ -23,6 +24,7 @@ orbital FilterGroupOrbital {
     state idle {
       INIT -> idle
         (fetch FilterGroupItem {})
+        (set @entity.query @config.query)
         (render-ui main {
           entity: FilterGroupItem
           filters: @config.filters
@@ -31,7 +33,41 @@ orbital FilterGroupOrbital {
           className: @config.className
           variant: @config.variant
           showIcon: @config.showIcon
-          query: @config.query
+          query: @entity.query
+          isLoading: @config.isLoading
+          look: @config.look
+          event: @config.event
+          clearEvent: @config.clearEvent
+          type: filter-group
+        })
+      EVENT -> idle
+        (set @entity.query ?query)
+        (render-ui main {
+          entity: FilterGroupItem
+          filters: @config.filters
+          onFilterChange: @config.onFilterChange
+          onClearAll: @config.onClearAll
+          className: @config.className
+          variant: @config.variant
+          showIcon: @config.showIcon
+          query: @entity.query
+          isLoading: @config.isLoading
+          look: @config.look
+          event: @config.event
+          clearEvent: @config.clearEvent
+          type: filter-group
+        })
+      CLEAR -> idle
+        (set @entity.query ?query)
+        (render-ui main {
+          entity: FilterGroupItem
+          filters: @config.filters
+          onFilterChange: @config.onFilterChange
+          onClearAll: @config.onClearAll
+          className: @config.className
+          variant: @config.variant
+          showIcon: @config.showIcon
+          query: @entity.query
           isLoading: @config.isLoading
           look: @config.look
           event: @config.event
@@ -47,23 +83,38 @@ orbital FilterGroupOrbital {
       }
         @description "Callback when a filter changes - for EntityStore integration"
         @tier "essential"
-      @config.onClearAll -> external {
-        id : string
-      }
+      @config.onClearAll -> external { }
         @description "Callback to clear all filters"
         @tier "essential"
       @config.event -> external {
-        id : string
+        entity : string!
+        field : string!
+        value : string!
+        query : string
       }
         @description "Declarative filter event — emits UI:{event} via eventBus on filter change (alongside canonical UI:FILTER)"
         @tier "essential"
       @config.clearEvent -> external {
-        id : string
+        entity : string!
+        query : string
       }
         @description "Declarative clear event — emits UI:{clearEvent} via eventBus on clear-all (alongside canonical UI:CLEAR_FILTERS)"
         @tier "essential"
     }
 
+    listens {
+      EVENT {
+        entity : string!
+        field : string!
+        value : string!
+        query : string
+      }
+      CLEAR {
+        entity : string!
+        query : string
+      }
+    }
+
     config {
       filters : [FilterGroupFiltersItem] = [{ field: "Field", label: "Label", filterType: text, type: text, options: ["Item", "Item 2"], min: 1, max: 1, step: 1 }, { field: "Field 2", label: "Label 2", filterType: select, type: select, options: ["Item", "Item 2"], min: 2, max: 2, step: 2 }]
         @label "Filters"

package/behaviors/lolo/ui/core/molecules/ui-flip-card.lolo

@@ -23,9 +23,7 @@ orbital FlipCardOrbital {
     }
 
     emits {
-      @config.onFlip -> external {
-        id : string
-      }
+      @config.onFlip -> external { }
         @description "Callback when the card is clicked to flip"
         @tier "essential"
     }

package/behaviors/lolo/ui/core/molecules/ui-floating-action-button.lolo

@@ -5,7 +5,7 @@ orbital FloatingActionButtonOrbital {
     id : string!
     label : string!
     icon : icon!
-    event : string
+    event : event
     variant : "primary" | "secondary" | "success" | "danger" | "warning"
   }
 
@@ -33,14 +33,10 @@ orbital FloatingActionButtonOrbital {
     }
 
     emits {
-      @config.action -> external {
-        id : string
-      }
+      @config.action -> external { }
         @description "Declarative event name. When set, clicking the FAB emits `UI:{action}` via the event bus and (if also provided) calls `onClick`. Mirrors the Button atom's `action` prop so schemas can write `{ type: 'floating-action-button', action: 'INIT' }` uniformly."
         @tier "essential"
-      @config.onClick -> external {
-        id : string
-      }
+      @config.onClick -> external { }
         @description "Optional direct click handler. Runs after the action emit when both are present."
         @tier "essential"
     }
@@ -50,7 +46,7 @@ orbital FloatingActionButtonOrbital {
         @label "Action"
         @description "Declarative event name. When set, clicking the FAB emits `UI:{action}` via the event bus and (if also provided) calls `onClick`. Mirrors the Button atom's `action` prop so schemas can write `{ type: 'floating-action-button', action: 'INIT' }` uniformly."
         @tier "presentation"
-      actionPayload : json = {}
+      actionPayload : @payload @config.action
         @label "Action Payload"
         @description "Payload to include with the dispatched action event."
         @tier "presentation"

package/behaviors/lolo/ui/core/molecules/ui-form-actions.lolo

@@ -11,7 +11,7 @@ orbital FormActionsOrbital {
   type FormActionsSecondaryItem = {
     label : string!
     actionType : string
-    event : string
+    event : event
     navigatesTo : string
     variant : string
   }