@almadar/std 16.197.0 → 16.199.0

package/behaviors/lolo/ui/core/atoms/std-rating-review.lolo

@@ -889,7 +889,7 @@ orbital RatingReviewOrbital {
 
     state composing {
       RATE_DRAFT -> composing
-        (set @entity.draftRating ?rating)
+        (set @entity.draftRating ?value)
         (render-ui main {
           children: [{
             align: center
@@ -1042,13 +1042,13 @@ orbital RatingReviewOrbital {
         @synonyms "compose, create, add"
         @tier "domain"
       RATE_DRAFT {
-        rating : number
+        value : number
       }
         @description "Signals a draft rating has been created or modified."
         @synonyms "draft, update, modify, change"
         @tier "presentation"
       SUBMIT_REVIEW {
-        data : object
+        data : @entity!
       }
         @description "Signals a review has been successfully submitted."
         @synonyms "saved, posted, sent"
@@ -1105,13 +1105,13 @@ orbital RatingReviewOrbital {
         @synonyms "compose, create, add, write"
         @tier "domain"
       RATE_DRAFT {
-        rating : number
+        value : number
       }
         @description "A draft rating has been created or updated."
         @synonyms "draft, save, pending"
         @tier "presentation"
       SUBMIT_REVIEW {
-        data : object
+        data : @entity!
       }
         @description "Indicates a review has been successfully submitted."
         @synonyms "saved, posted, sent"
@@ -1260,7 +1260,7 @@ orbital RatingReviewOrbital {
           type: card
         })
       RATE_DRAFT -> composing
-        (set @entity.draftRating ?rating)
+        (set @entity.draftRating ?value)
         (render-ui main {
           children: [{
             children: [{
@@ -1437,13 +1437,13 @@ orbital RatingReviewOrbital {
 
     emits {
       RATE_DRAFT {
-        rating : number
+        value : number
       }
         @description "Signals a review draft has been created or updated."
         @synonyms "draft, save, pending"
         @tier "presentation"
       SUBMIT_REVIEW {
-        data : object
+        data : @entity!
       }
         @description "Signals a review has been successfully submitted."
         @synonyms "saved, posted, sent"
@@ -1471,13 +1471,13 @@ orbital RatingReviewOrbital {
 
     listens {
       RATE_DRAFT {
-        rating : number
+        value : number
       }
         @description "A draft rating has been created or updated."
         @synonyms "draft, pending, incomplete"
         @tier "presentation"
       SUBMIT_REVIEW {
-        data : object
+        data : @entity!
       }
         @description "A review has been successfully submitted."
         @synonyms "saved, posted, confirmed"

package/behaviors/lolo/ui/core/atoms/std-record-detail.lolo

@@ -22,7 +22,7 @@ orbital RecordItemOrbital {
     content : string @description "The record's rich-text body as HTML, edited in place by the document look." @synonyms "body, text, document, article body" = ""
     coverUrl : string @intrinsic @description "The document look's cover/hero image URL, stamped from the loaded row's coverField." = ""
     iconName : string @intrinsic @description "The document look's icon name, stamped from the loaded row's iconField." = ""
-    loadedRow : object @intrinsic @description "The full row exactly as last fetched (relations hydrated when config.include asks). The details drawer binds it, and hosts that need it (e.g. a settings modal) stash it from RecordItemLoaded — the document panel itself takes only scalar props and emits scalar payloads ({ id, title })." = {}
+    loadedRow : Map string scalar @intrinsic @description "The full row exactly as last fetched (relations hydrated when config.include asks). The details drawer binds it, and hosts that need it (e.g. a settings modal) stash it from RecordItemLoaded — the document panel itself takes only scalar props and emits scalar payloads ({ id, title })." = {}
     openDraft : string @intrinsic @description "Set from the navigate payload when the surface was opened on a record that was JUST minted blank; read once the row loads to decide whether the document body opens authoring (draft) or read-only. Absent on a refresh or a normal open, so the draft entry never repeats." @synonyms "new document, just created, draft open" = ""
     createdAt : string
   }
@@ -347,14 +347,14 @@ orbital RecordItemOrbital {
         @tier "internal"
       EDIT -> external {
         id : string!
-        row : RecordItem
+        row : RecordItem!
       }
         @description "Signals a request to edit the record being viewed."
         @synonyms "modify, update, change"
         @tier "domain"
       DELETE -> external {
         id : string!
-        row : RecordItem
+        row : RecordItem!
       }
         @description "Signals a request to remove the record being viewed."
         @synonyms "remove, discard, delete, archive"
@@ -422,7 +422,7 @@ orbital RecordItemOrbital {
         @tier "domain"
       OPEN_VIEW {
         id : string!
-        row : RecordItem
+        row : RecordItem!
       }
         @description "A row was opened from a list; shows that record in this surface."
         @synonyms "open record, view row, show details, drill in, expand"

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

@@ -388,7 +388,7 @@ orbital RecurrenceOrbital {
         @synonyms "modify, change, update"
         @tier "presentation"
       SAVE_RULE {
-        data : object
+        data : @entity!
       }
         @description "Signals that the recurrence rule has been successfully saved."
         @synonyms "saved, persisted, updated, confirmed"
@@ -398,7 +398,7 @@ orbital RecurrenceOrbital {
         @synonyms "delete, remove, deactivate, terminate"
         @tier "presentation"
       OPEN_EXCEPTION {
-        row : object!
+        row : @entity!
       }
         @description "Signals a per-run exception modal is opening."
         @synonyms "show, display, reveal, launch"
@@ -460,7 +460,7 @@ orbital RecurrenceOrbital {
         @synonyms "modify, change, update, alter"
         @tier "presentation"
       SAVE_RULE {
-        data : object
+        data : @entity!
       }
         @description "Rule changes have been successfully persisted."
         @synonyms "saved, updated, committed"
@@ -470,7 +470,7 @@ orbital RecurrenceOrbital {
         @synonyms "delete, remove, terminate"
         @tier "presentation"
       OPEN_EXCEPTION {
-        row : object!
+        row : @entity!
       }
         @description "A scheduled event requires exception handling."
         @synonyms "exception, override, modify, adjust"

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

@@ -13,7 +13,7 @@ orbital SavedSearchOrbital {
     id : string!
     name : string! @description "A user-defined label for the saved search." @synonyms "title, label, search name"
     query : string @description "The text of the search query." @synonyms "search, expression, criteria"
-    filters : object @description "Criteria used to define the search." @synonyms "criteria, conditions, constraints"
+    filters : Map string scalar @description "Criteria used to define the search." @synonyms "criteria, conditions, constraints"
     alertEnabled : boolean @description "Indicates whether alerts are enabled for this saved search." @synonyms "enabled, active, notification status" = false
     alertFrequency : "instant" | "daily" | "weekly" @description "How often alerts are triggered." @synonyms "frequency, interval, recurrence" = daily
     userId : string @description "Identifier of the user who created the saved search." @synonyms "creator, owner, user_id"

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

@@ -408,8 +408,10 @@ orbital SelectableItemOrbital {
         @synonyms "refresh, reload, update, re-query, search"
         @tier "domain"
       REFETCH_FILTER {
+        entity : string!
         field : string!
         value : string!
+        query : string
       }
         @description "Triggers a pick-list refresh based on current filter criteria."
         @synonyms "refresh, filter, update, reload"

package/behaviors/lolo/ui/core/atoms/std-tag-strip.lolo

@@ -204,12 +204,14 @@ orbital TagStripOrbital {
         @tier "domain"
       ADD_TAG {
         tag : string!
+        value : [string]
       }
         @description "A tag name was typed into the strip or an existing tag's suggestion chip was clicked."
         @synonyms "attach tag, add label"
         @tier "presentation"
       REMOVE_TAG {
         tag : string
+        index : number
         value : [string]
       }
         @description "A chip's remove affordance was clicked; value carries the names that remain."
@@ -251,12 +253,14 @@ orbital TagStripOrbital {
         @tier "domain"
       ADD_TAG {
         tag : string!
+        value : [string]
       }
         @description "Attach a tag by name — typed into the input or clicked from the existing-tag chips."
         @synonyms "attach tag, add label"
         @tier "presentation"
       REMOVE_TAG {
         tag : string
+        index : number
         value : [string]
       }
         @description "Detach a chip; value carries the names that remain."

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

@@ -40,7 +40,7 @@ orbital ThreadPostOrbital {
     voteCount : number @description "The number of votes associated with this item." @synonyms "votes, rating, score" = 0
     replyCount : number @description "The number of replies to this post." @synonyms "count, number of replies, child posts" = 0
     replies : [ThreadPost] @description "A list of child ThreadPost entities." @synonyms "children, descendants, sub-posts"
-    focusedRow : object @description "The currently selected or active row within the thread." @synonyms "selection, active, current" = {}
+    focusedRow : Map string scalar @description "The currently selected or active row within the thread." @synonyms "selection, active, current" = {}
   }
 
   trait ThreadPostBrowse -> @rebindable ThreadPost [interaction, collection] {
@@ -262,7 +262,7 @@ orbital ThreadPostOrbital {
     emits {
       SELECT -> external {
         id : string
-        row : object!
+        row : @entity!
       }
         @description "Indicates a post or reply has been chosen for interaction."
         @synonyms "choose, highlight, focus, activate"
@@ -318,7 +318,7 @@ orbital ThreadPostOrbital {
     listens {
       SELECT {
         id : string
-        row : object!
+        row : @entity!
       }
         @description "A post or reply has been chosen for interaction."
         @synonyms "choose, highlight, focus, activate"

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

@@ -361,8 +361,10 @@ orbital TreeNodeOrbital {
         @synonyms "refresh, reload, update, re-query"
         @tier "domain"
       REFETCH_FILTER {
+        entity : string!
         field : string!
         value : string!
+        query : string
       }
         @description "Triggers a tree refresh based on current filter criteria."
         @synonyms "refresh, filter, update, reload"

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

@@ -479,7 +479,7 @@ orbital WizardOrbital {
 
     emits {
       ADVANCE {
-        data : object
+        data : @entity!
       }
         @description "Signals progression to the next step in the wizard."
         @synonyms "next, proceed, continue"
@@ -526,7 +526,7 @@ orbital WizardOrbital {
 
     listens {
       ADVANCE {
-        data : object
+        data : @entity!
       }
         @description "Indicates a request to proceed to the next step."
         @synonyms "next, proceed, continue"

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

@@ -28,14 +28,10 @@ orbital AvatarOrbital {
     }
 
     emits {
-      @config.onClick -> external {
-        id : string
-      }
+      @config.onClick -> external { }
         @description "Click handler"
         @tier "essential"
-      @config.action -> external {
-        id : string
-      }
+      @config.action -> external { }
         @description "Declarative event name — emits UI:{action} via eventBus on click"
         @tier "essential"
     }
@@ -85,7 +81,7 @@ orbital AvatarOrbital {
         @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-box.lolo

@@ -38,13 +38,11 @@ orbital BoxOrbital {
     }
 
     emits {
-      @config.action -> external {
-        id : string
-      }
+      @config.action -> external { }
         @description "Declarative event name — emits UI:{action} via eventBus on click"
         @tier "essential"
       @config.hoverEvent -> external {
-        id : string
+        hovered : boolean!
       }
         @description "Declarative hover event — emits UI:{hoverEvent} with { hovered: true/false } on mouseEnter/mouseLeave"
         @tier "essential"
@@ -119,7 +117,7 @@ orbital BoxOrbital {
         @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-button.lolo

@@ -44,9 +44,7 @@ orbital ButtonOrbital {
     }
 
     emits {
-      @config.action -> external {
-        id : string
-      }
+      @config.action -> external { }
         @description "Declarative event name — emits UI:{action} via eventBus on click"
         @tier "essential"
     }
@@ -92,7 +90,7 @@ orbital ButtonOrbital {
         @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-card.lolo

@@ -26,9 +26,7 @@ orbital CardOrbital {
     }
 
     emits {
-      @config.action -> external {
-        id : string
-      }
+      @config.action -> external { }
         @description "Declarative event key emitted on click for trait dispatch"
         @tier "essential"
     }

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

@@ -21,9 +21,7 @@ orbital CheckboxOrbital {
     }
 
     emits {
-      @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-conditional-wrapper.lolo

@@ -2,10 +2,10 @@ app ui-conditional-wrapper "1.0.0"
 "ConditionalWrapper — UI factory (1:1 with the @almadar/ui conditional-wrapper pattern)."
 orbital ConditionalWrapperOrbital {
   type ConditionalWrapperContext = {
-    formValues : json!
-    globalVariables : json!
-    localVariables : json
-    entity : json
+    formValues : opaque!
+    globalVariables : opaque!
+    localVariables : opaque
+    entity : opaque
   }
 
   entity ConditionalWrapperItem [runtime] {

package/behaviors/lolo/ui/core/atoms/ui-flip-container.lolo

@@ -20,9 +20,7 @@ orbital FlipContainerOrbital {
     }
 
     emits {
-      @config.onClick -> external {
-        id : string
-      }
+      @config.onClick -> external { }
         @description "Click handler on the outer wrapper"
         @tier "essential"
     }

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

@@ -30,9 +30,7 @@ orbital HstackOrbital {
     }
 
     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 HstackOrbital {
         @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-infinite-scroll-sentinel.lolo

@@ -22,9 +22,7 @@ orbital InfiniteScrollSentinelOrbital {
     }
 
     emits {
-      @config.loadMoreEvent -> external {
-        id : string
-      }
+      @config.loadMoreEvent -> external { }
         @description "Event name to emit when load-more is triggered (emitted as UI:{loadMoreEvent})"
         @tier "essential"
     }
@@ -34,7 +32,7 @@ orbital InfiniteScrollSentinelOrbital {
         @label "Load More Event"
         @description "Event name to emit when load-more is triggered (emitted as UI:{loadMoreEvent})"
         @tier "presentation"
-      loadMorePayload : json = {}
+      loadMorePayload : @payload @config.loadMoreEvent
         @label "Load More Payload"
         @description "Optional payload to include with the load-more event"
         @tier "presentation"

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

@@ -8,6 +8,7 @@ orbital InputOrbital {
 
   entity InputItem [runtime] {
     id : string!
+    value : string
   }
 
   trait InputRender -> @rebindable InputItem [interaction, instance] {
@@ -15,10 +16,33 @@ orbital InputOrbital {
 
     state idle {
       INIT -> idle
+        (set @entity.value @config.value)
         (render-ui main {
           className: @config.className
           placeholder: @config.placeholder
-          value: @config.value
+          value: @entity.value
+          disabled: @config.disabled
+          action: @config.action
+          inputType: @config.inputType
+          label: @config.label
+          helperText: @config.helperText
+          error: @config.error
+          leftIcon: @config.leftIcon
+          rightIcon: @config.rightIcon
+          icon: @config.icon
+          clearable: @config.clearable
+          onClear: @config.onClear
+          options: @config.options
+          rows: @config.rows
+          onChange: @config.onChange
+          type: input
+        })
+      ACTION -> idle
+        (set @entity.value ?value)
+        (render-ui main {
+          className: @config.className
+          placeholder: @config.placeholder
+          value: @entity.value
           disabled: @config.disabled
           action: @config.action
           inputType: @config.inputType
@@ -39,22 +63,24 @@ orbital InputOrbital {
 
     emits {
       @config.action -> external {
-        id : string
+        value : string!
       }
         @description "Declarative event name for trait dispatch"
         @tier "essential"
-      @config.onClear -> external {
-        id : string
-      }
+      @config.onClear -> external { }
         @description "Callback or declarative event key when clear button is clicked"
         @tier "essential"
-      @config.onChange -> external {
-        id : string
-      }
+      @config.onChange -> external { }
         @description "onChange handler or declarative event key for trait dispatch"
         @tier "essential"
     }
 
+    listens {
+      ACTION {
+        value : string!
+      }
+    }
+
     config {
       className : string
         @label "Class Name"

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

@@ -20,9 +20,7 @@ orbital OverlayOrbital {
     }
 
     emits {
-      @config.action -> external {
-        id : string
-      }
+      @config.action -> external { }
         @description "Declarative event name — emits UI:{action} via eventBus on click"
         @tier "essential"
     }

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

@@ -3,6 +3,7 @@ app ui-radio "1.0.0"
 orbital RadioOrbital {
   entity RadioItem [runtime] {
     id : string!
+    value : string
   }
 
   trait RadioRender -> @rebindable RadioItem [interaction, instance] {
@@ -10,10 +11,24 @@ orbital RadioOrbital {
 
     state idle {
       INIT -> idle
+        (set @entity.value @config.value)
         (render-ui main {
           className: @config.className
           options: @config.options
-          value: @config.value
+          value: @entity.value
+          action: @config.action
+          label: @config.label
+          helperText: @config.helperText
+          error: @config.error
+          size: @config.size
+          type: radio
+        })
+      ACTION -> idle
+        (set @entity.value ?value)
+        (render-ui main {
+          className: @config.className
+          options: @config.options
+          value: @entity.value
           action: @config.action
           label: @config.label
           helperText: @config.helperText
@@ -25,12 +40,18 @@ orbital RadioOrbital {
 
     emits {
       @config.action -> external {
-        id : string
+        value : string!
       }
         @description "Declarative event name for trait dispatch"
         @tier "essential"
     }
 
+    listens {
+      ACTION {
+        value : string!
+      }
+    }
+
     config {
       className : string
         @label "Class Name"

package/behaviors/lolo/ui/core/atoms/ui-range-slider.lolo

@@ -28,6 +28,24 @@ orbital RangeSliderOrbital {
           onChange: @config.onChange
           type: range-slider
         })
+      ACTION -> idle
+        (set @entity.value ?value)
+        (render-ui main {
+          className: @config.className
+          min: @config.min
+          max: @config.max
+          value: @entity.value
+          step: @config.step
+          showTooltip: @config.showTooltip
+          showTicks: @config.showTicks
+          buffered: @config.buffered
+          size: @config.size
+          disabled: @config.disabled
+          action: @config.action
+          actionPayload: @config.actionPayload
+          onChange: @config.onChange
+          type: range-slider
+        })
       CHANGE -> idle
         (set @entity.value ?value)
         (render-ui main {
@@ -50,7 +68,7 @@ orbital RangeSliderOrbital {
 
     emits {
       @config.action -> external {
-        id : string
+        value : number!
       }
         @description "Declarative event name for value changes"
         @tier "essential"
@@ -62,6 +80,9 @@ orbital RangeSliderOrbital {
     }
 
     listens {
+      ACTION {
+        value : number!
+      }
       CHANGE {
         value : number
       }
@@ -112,7 +133,7 @@ orbital RangeSliderOrbital {
         @label "Action"
         @description "Declarative event name for value changes"
         @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-select.lolo

@@ -41,19 +41,13 @@ orbital SelectOrbital {
     }
 
     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 (native ChangeEvent) or declarative event key for trait dispatch"
         @tier "essential"
-      @config.onValueChange -> external {
-        id : string
-      }
+      @config.onValueChange -> external { }
         @description "Value-based change: a React callback (internal use) OR a declarative event key that emits `{ value }` on the bus (render-ui / lolo authoring). Mirrors the `onChange` handler|event convention so it's an event-emitting prop, not a bare callback."
         @tier "essential"
     }

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"