@almadar/std 16.238.0 → 16.239.0

package/behaviors/lolo/ui/core/molecules/ui-agent-chat-feed.lolo

@@ -0,0 +1,231 @@
+app ui-agent-chat-feed "1.0.0"
+"AgentChatFeed — UI factory (1:1 with the @almadar/ui agent-chat-feed pattern)."
+;; @pattern "agent-chat-feed"
+orbital AgentChatFeedOrbital {
+  type AgentChatFeedActivitiesItem = AgentChatFeedActivitiesItemMessage | AgentChatFeedActivitiesItemToolCall | AgentChatFeedActivitiesItemToolResult | AgentChatFeedActivitiesItemFileOperation | AgentChatFeedActivitiesItemSchemaDiff | AgentChatFeedActivitiesItemError | AgentChatFeedActivitiesItemCoordinatorDecision | AgentChatFeedActivitiesItemPlanCommitted | AgentChatFeedActivitiesItemPendingQuestion | AgentChatFeedActivitiesItemClarificationQuestion | AgentChatFeedActivitiesItemAnalysis | AgentChatFeedActivitiesItemOrbitalStarted | AgentChatFeedActivitiesItemOrbitalDone | AgentChatFeedActivitiesItemSchemaChange | AgentChatFeedActivitiesItemDone | AgentChatFeedActivitiesItemCancelled | AgentChatFeedActivitiesItemLlmResponse
+  type AgentChatFeedActivitiesItemMessage = {
+    type : "message"!
+    role : "user" | "assistant" | "system"!
+    content : string!
+    timestamp : number!
+    isStreaming : boolean
+  }
+  type AgentChatFeedActivitiesItemToolCall = {
+    type : "tool_call"!
+    tool : string!
+    kind : "input" | "read" | "invalid"
+    argsText : string!
+    timestamp : number!
+    isExecuting : boolean
+  }
+  type AgentChatFeedActivitiesItemToolResult = {
+    type : "tool_result"!
+    tool : string!
+    kind : "input" | "read" | "invalid"
+    success : boolean!
+    detail : string
+    rows : number
+    resultText : string!
+    timestamp : number!
+  }
+  type AgentChatFeedActivitiesItemFileOperation = {
+    type : "file_operation"!
+    operation : "ls" | "read_file" | "write_file" | "edit_file"!
+    path : string!
+    success : boolean
+    timestamp : number!
+  }
+  type AgentChatFeedActivitiesItemSchemaDiff = {
+    type : "schema_diff"!
+    filePath : string!
+    hunks : [AgentChatFeedActivitiesItemSchemaDiffHunksItem]!
+    timestamp : number!
+  }
+  type AgentChatFeedActivitiesItemSchemaDiffHunksItem = {
+    oldStart : number!
+    oldLines : number!
+    newStart : number!
+    newLines : number!
+    lines : [AgentChatFeedActivitiesItemSchemaDiffHunksItemLinesItem]!
+  }
+  type AgentChatFeedActivitiesItemSchemaDiffHunksItemLinesItem = {
+    type : "add" | "remove" | "context"!
+    content : string!
+  }
+  type AgentChatFeedActivitiesItemError = {
+    type : "error"!
+    message : string!
+    code : string
+    timestamp : number!
+  }
+  type AgentChatFeedActivitiesItemCoordinatorDecision = {
+    type : "coordinator_decision"!
+    organism : string!
+    reason : string!
+    priorOrganism : string
+    timestamp : number!
+  }
+  type AgentChatFeedActivitiesItemPlanCommitted = {
+    type : "plan_committed"!
+    orbitals : [string]!
+    timestamp : number!
+  }
+  type AgentChatFeedActivitiesItemPendingQuestion = {
+    type : "pending_question"!
+    questionId : string!
+    question : string!
+    orbitalName : string
+    timestamp : number!
+  }
+  type AgentChatFeedActivitiesItemClarificationQuestion = {
+    type : "clarification_question"!
+    level : "organism" | "molecule" | "atom_trait"!
+    scope : AgentChatFeedActivitiesItemClarificationQuestionScope!
+    question : string!
+    candidates : [AgentChatFeedActivitiesItemClarificationQuestionCandidatesItem]!
+    skipDefault : string!
+    timestamp : number!
+  }
+  type AgentChatFeedActivitiesItemClarificationQuestionScope = {
+    orbitalName : string
+    traitName : string
+  }
+  type AgentChatFeedActivitiesItemClarificationQuestionCandidatesItem = {
+    id : string!
+    label : string!
+    description : string!
+    whyThisFits : string!
+  }
+  type AgentChatFeedActivitiesItemAnalysis = {
+    type : "analysis"!
+    organism : string!
+    organismReason : string
+    complexity : AgentChatFeedActivitiesItemAnalysisComplexity
+    renames : [AgentChatFeedActivitiesItemAnalysisRenamesItem]!
+    deletes : [string]!
+    timestamp : number!
+  }
+  type AgentChatFeedActivitiesItemAnalysisComplexity = {
+    category : string!
+    reasoning : string!
+  }
+  type AgentChatFeedActivitiesItemAnalysisRenamesItem = {
+    from : string!
+    to : string!
+  }
+  type AgentChatFeedActivitiesItemOrbitalStarted = {
+    type : "orbital_started"!
+    orbitalName : string!
+    timestamp : number!
+  }
+  type AgentChatFeedActivitiesItemOrbitalDone = {
+    type : "orbital_done"!
+    orbitalName : string!
+    traitCount : number
+    transitionCount : number
+    timestamp : number!
+  }
+  type AgentChatFeedActivitiesItemSchemaChange = {
+    type : "schema_change"!
+    changeKind : "orbital-added" | "orbital-removed" | "entity-fields-changed" | "trait-added" | "trait-removed" | "trait-config-changed" | "state-machine-changed" | "guard-changed" | "effect-changed" | "render-ui-changed" | "event-wiring-changed" | "page-changed" | "theme-changed" | "behavior-composed"!
+    orbitalName : string!
+    traitName : string
+    transitionEvent : string
+    timestamp : number!
+  }
+  type AgentChatFeedActivitiesItemDone = {
+    type : "done"!
+    orbitalCount : number!
+    timestamp : number!
+  }
+  type AgentChatFeedActivitiesItemCancelled = {
+    type : "cancelled"!
+    message : string!
+    timestamp : number!
+  }
+  type AgentChatFeedActivitiesItemLlmResponse = {
+    type : "llm_response"!
+    content : string!
+    llm : AgentChatFeedActivitiesItemLlmResponseLlm
+    timestamp : number!
+  }
+  type AgentChatFeedActivitiesItemLlmResponseLlm = {
+    service : string!
+    provider : string!
+    model : string!
+    systemPrompt : string!
+    userPrompt : string!
+    toolCallsJson : string
+    attempt : number
+    durationMs : number!
+    promptTokens : number
+    completionTokens : number
+    cachedPromptTokens : number
+    costUSD : number
+  }
+
+  entity AgentChatFeedItem [runtime] {
+    id : string!
+  }
+
+  trait AgentChatFeedRender -> @rebindable AgentChatFeedItem [interaction, instance] {
+    initial: idle
+
+    state idle {
+      INIT -> idle
+        (render-ui main {
+          activities: @config.activities
+          emptyTitle: @config.emptyTitle
+          rawLlmPreferenceKey: @config.rawLlmPreferenceKey
+          idPrefix: @config.idPrefix
+          working: @config.working
+          className: @config.className
+          enter: @config.enter
+          enterDelay: @config.enterDelay
+          skeleton: @config.skeleton
+          type: agent-chat-feed
+        })
+    }
+
+    config {
+      activities : [AgentChatFeedActivitiesItem] = []
+        @label "Activities"
+        @description "Activities already selected by the host's manifest audience."
+        @tier "presentation"
+      emptyTitle : string = ""
+        @label "Empty Title"
+        @description "emptyTitle prop"
+        @tier "presentation"
+      rawLlmPreferenceKey : string = ""
+        @label "Raw Llm Preference Key"
+        @description "localStorage key remembering the Raw LLM switch for this host."
+        @tier "presentation"
+      idPrefix : string = ""
+        @label "Id Prefix"
+        @description "Prefix for the toolbar test id and the switch's element id."
+        @tier "presentation"
+      working : boolean = false
+        @label "Working"
+        @description "The agent is running — the feed shows it is thinking."
+        @tier "presentation"
+      className : string
+        @label "Class Name"
+        @description "className prop"
+        @tier "presentation"
+      enter : "none" | "fade" | "rise" | "scale" | "slide"
+        @label "Enter"
+        @description "How this element animates in when it mounts (theme-styled); overrides the theme's default slot entry. `none` opts out."
+        @tier "presentation"
+      enterDelay : number
+        @label "Enter Delay"
+        @description "Stagger step for the entry: waits this many `--motion-enter-stagger` steps before animating."
+        @tier "presentation"
+      skeleton : "header" | "table" | "list" | "grid" | "detail" | "stats" | "form" | "card" | "text" | "none"
+        @label "Skeleton"
+        @description "Skeleton shown while this element's server render is in flight: a shape (`table`, `list`, …), `{ variant, rows?, columns?, fields? }`, or `none`."
+        @tier "presentation"
+    }
+  }
+
+  page "/agent-chat-feed" as AgentChatFeedPage -> AgentChatFeedRender
+}

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

@@ -25,6 +25,7 @@ orbital AlertOrbital {
           dismissEvent: @config.dismissEvent
           enter: @config.enter
           enterDelay: @config.enterDelay
+          skeleton: @config.skeleton
           aria-label: @config.ariaLabel
           aria-labelledby: @config.ariaLabelledby
           aria-describedby: @config.ariaDescribedby
@@ -105,6 +106,10 @@ orbital AlertOrbital {
         @label "Enter Delay"
         @description "Stagger step for the entry: waits this many `--motion-enter-stagger` steps before animating."
         @tier "presentation"
+      skeleton : "header" | "table" | "list" | "grid" | "detail" | "stats" | "form" | "card" | "text" | "none"
+        @label "Skeleton"
+        @description "Skeleton shown while this element's server render is in flight: a shape (`table`, `list`, …), `{ variant, rows?, columns?, fields? }`, or `none`."
+        @tier "presentation"
       ariaLabel : string
         @label "Aria-label"
         @description "Accessible name read by screen readers when the visible text is missing or not descriptive (e.g. an icon-only control)."

package/behaviors/lolo/ui/core/molecules/ui-animated-counter.lolo

@@ -21,6 +21,7 @@ orbital AnimatedCounterOrbital {
           className: @config.className
           enter: @config.enter
           enterDelay: @config.enterDelay
+          skeleton: @config.skeleton
           aria-label: @config.ariaLabel
           aria-labelledby: @config.ariaLabelledby
           aria-describedby: @config.ariaDescribedby
@@ -76,6 +77,10 @@ orbital AnimatedCounterOrbital {
         @label "Enter Delay"
         @description "Stagger step for the entry: waits this many `--motion-enter-stagger` steps before animating."
         @tier "presentation"
+      skeleton : "header" | "table" | "list" | "grid" | "detail" | "stats" | "form" | "card" | "text" | "none"
+        @label "Skeleton"
+        @description "Skeleton shown while this element's server render is in flight: a shape (`table`, `list`, …), `{ variant, rows?, columns?, fields? }`, or `none`."
+        @tier "presentation"
       ariaLabel : string
         @label "Aria-label"
         @description "Accessible name read by screen readers when the visible text is missing or not descriptive (e.g. an icon-only control)."

package/behaviors/lolo/ui/core/molecules/ui-bloom-quiz-block.lolo

@@ -21,6 +21,7 @@ orbital BloomQuizBlockOrbital {
           className: @config.className
           enter: @config.enter
           enterDelay: @config.enterDelay
+          skeleton: @config.skeleton
           aria-label: @config.ariaLabel
           aria-labelledby: @config.ariaLabelledby
           aria-describedby: @config.ariaDescribedby
@@ -76,6 +77,10 @@ orbital BloomQuizBlockOrbital {
         @label "Enter Delay"
         @description "Stagger step for the entry: waits this many `--motion-enter-stagger` steps before animating."
         @tier "presentation"
+      skeleton : "header" | "table" | "list" | "grid" | "detail" | "stats" | "form" | "card" | "text" | "none"
+        @label "Skeleton"
+        @description "Skeleton shown while this element's server render is in flight: a shape (`table`, `list`, …), `{ variant, rows?, columns?, fields? }`, or `none`."
+        @tier "presentation"
       ariaLabel : string
         @label "Aria-label"
         @description "Accessible name read by screen readers when the visible text is missing or not descriptive (e.g. an icon-only control)."

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

@@ -34,12 +34,14 @@ orbital BranchingLogicBuilderOrbital {
         (render-ui main {
           questions: @config.questions
           rules: @config.rules
+          surface: @config.surface
           onRulesChange: @config.onRulesChange
           rulesChangeEvent: @config.rulesChangeEvent
           readOnly: @config.readOnly
           className: @config.className
           enter: @config.enter
           enterDelay: @config.enterDelay
+          skeleton: @config.skeleton
           aria-label: @config.ariaLabel
           aria-labelledby: @config.ariaLabelledby
           aria-describedby: @config.ariaDescribedby
@@ -75,6 +77,10 @@ orbital BranchingLogicBuilderOrbital {
         @label "Rules"
         @description "Rules. Accepts either a typed array (direct consumers) or the runtime payload shape from a render-ui binding (`@payload.data`). Narrowed to `[]` internally when the value isn't an array."
         @tier "presentation"
+      surface : "auto" | "none" = auto
+        @label "Surface"
+        @description "Content surface: `auto` paints the theme's surface behind this block unless it already sits on one (a card, dialog or another block); `none` opts out."
+        @tier "presentation"
       onRulesChange : event = "RULES_CHANGE"
         @label "On Rules Change"
         @description "onRulesChange prop"
@@ -99,6 +105,10 @@ orbital BranchingLogicBuilderOrbital {
         @label "Enter Delay"
         @description "Stagger step for the entry: waits this many `--motion-enter-stagger` steps before animating."
         @tier "presentation"
+      skeleton : "header" | "table" | "list" | "grid" | "detail" | "stats" | "form" | "card" | "text" | "none"
+        @label "Skeleton"
+        @description "Skeleton shown while this element's server render is in flight: a shape (`table`, `list`, …), `{ variant, rows?, columns?, fields? }`, or `none`."
+        @tier "presentation"
       ariaLabel : string
         @label "Aria-label"
         @description "Accessible name read by screen readers when the visible text is missing or not descriptive (e.g. an icon-only control)."

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

@@ -30,6 +30,7 @@ orbital BreadcrumbOrbital {
           className: @config.className
           enter: @config.enter
           enterDelay: @config.enterDelay
+          skeleton: @config.skeleton
           aria-label: @config.ariaLabel
           aria-labelledby: @config.ariaLabelledby
           aria-describedby: @config.ariaDescribedby
@@ -91,6 +92,10 @@ orbital BreadcrumbOrbital {
         @label "Enter Delay"
         @description "Stagger step for the entry: waits this many `--motion-enter-stagger` steps before animating."
         @tier "presentation"
+      skeleton : "header" | "table" | "list" | "grid" | "detail" | "stats" | "form" | "card" | "text" | "none"
+        @label "Skeleton"
+        @description "Skeleton shown while this element's server render is in flight: a shape (`table`, `list`, …), `{ variant, rows?, columns?, fields? }`, or `none`."
+        @tier "presentation"
       ariaLabel : string
         @label "Aria-label"
         @description "Accessible name read by screen readers when the visible text is missing or not descriptive (e.g. an icon-only control)."

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

@@ -26,6 +26,7 @@ orbital CalendarGridOrbital {
           onDayClick: @config.onDayClick
           onEventClick: @config.onEventClick
           className: @config.className
+          surface: @config.surface
           longPressEvent: @config.longPressEvent
           longPressPayload: @config.longPressPayload
           swipeLeftEvent: @config.swipeLeftEvent
@@ -37,6 +38,7 @@ orbital CalendarGridOrbital {
           colorField: @config.colorField
           enter: @config.enter
           enterDelay: @config.enterDelay
+          skeleton: @config.skeleton
           aria-label: @config.ariaLabel
           aria-labelledby: @config.ariaLabelledby
           aria-describedby: @config.ariaDescribedby
@@ -62,6 +64,7 @@ orbital CalendarGridOrbital {
           onDayClick: @config.onDayClick
           onEventClick: @config.onEventClick
           className: @config.className
+          surface: @config.surface
           longPressEvent: @config.longPressEvent
           longPressPayload: @config.longPressPayload
           swipeLeftEvent: @config.swipeLeftEvent
@@ -73,6 +76,7 @@ orbital CalendarGridOrbital {
           colorField: @config.colorField
           enter: @config.enter
           enterDelay: @config.enterDelay
+          skeleton: @config.skeleton
           aria-label: @config.ariaLabel
           aria-labelledby: @config.ariaLabelledby
           aria-describedby: @config.ariaDescribedby
@@ -98,6 +102,7 @@ orbital CalendarGridOrbital {
           onDayClick: @config.onDayClick
           onEventClick: @config.onEventClick
           className: @config.className
+          surface: @config.surface
           longPressEvent: @config.longPressEvent
           longPressPayload: @config.longPressPayload
           swipeLeftEvent: @config.swipeLeftEvent
@@ -109,6 +114,7 @@ orbital CalendarGridOrbital {
           colorField: @config.colorField
           enter: @config.enter
           enterDelay: @config.enterDelay
+          skeleton: @config.skeleton
           aria-label: @config.ariaLabel
           aria-labelledby: @config.ariaLabelledby
           aria-describedby: @config.ariaDescribedby
@@ -187,6 +193,10 @@ orbital CalendarGridOrbital {
         @label "Class Name"
         @description "Additional CSS classes"
         @tier "presentation"
+      surface : "auto" | "none" = auto
+        @label "Surface"
+        @description "Content surface: `auto` paints the theme's surface behind this block unless it already sits on one (a card, dialog or another block); `none` opts out."
+        @tier "presentation"
       longPressEvent : event = "LONG_PRESS"
         @label "Long Press Event"
         @description "Event emitted on long-press of a time slot: UI:{longPressEvent} with { date, time, ...longPressPayload }"
@@ -231,6 +241,10 @@ orbital CalendarGridOrbital {
         @label "Enter Delay"
         @description "Stagger step for the entry: waits this many `--motion-enter-stagger` steps before animating."
         @tier "presentation"
+      skeleton : "header" | "table" | "list" | "grid" | "detail" | "stats" | "form" | "card" | "text" | "none"
+        @label "Skeleton"
+        @description "Skeleton shown while this element's server render is in flight: a shape (`table`, `list`, …), `{ variant, rows?, columns?, fields? }`, or `none`."
+        @tier "presentation"
       ariaLabel : string
         @label "Aria-label"
         @description "Accessible name read by screen readers when the visible text is missing or not descriptive (e.g. an icon-only control)."

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

@@ -29,6 +29,7 @@ orbital CarouselOrbital {
           className: @config.className
           enter: @config.enter
           enterDelay: @config.enterDelay
+          skeleton: @config.skeleton
           aria-label: @config.ariaLabel
           aria-labelledby: @config.ariaLabelledby
           aria-describedby: @config.ariaDescribedby
@@ -100,6 +101,10 @@ orbital CarouselOrbital {
         @label "Enter Delay"
         @description "Stagger step for the entry: waits this many `--motion-enter-stagger` steps before animating."
         @tier "presentation"
+      skeleton : "header" | "table" | "list" | "grid" | "detail" | "stats" | "form" | "card" | "text" | "none"
+        @label "Skeleton"
+        @description "Skeleton shown while this element's server render is in flight: a shape (`table`, `list`, …), `{ variant, rows?, columns?, fields? }`, or `none`."
+        @tier "presentation"
       ariaLabel : string
         @label "Aria-label"
         @description "Accessible name read by screen readers when the visible text is missing or not descriptive (e.g. an icon-only control)."

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

@@ -26,6 +26,7 @@ orbital ChangeListOrbital {
           className: @config.className
           enter: @config.enter
           enterDelay: @config.enterDelay
+          skeleton: @config.skeleton
           aria-label: @config.ariaLabel
           aria-labelledby: @config.ariaLabelledby
           aria-describedby: @config.ariaDescribedby
@@ -74,6 +75,10 @@ orbital ChangeListOrbital {
         @label "Enter Delay"
         @description "Stagger step for the entry: waits this many `--motion-enter-stagger` steps before animating."
         @tier "presentation"
+      skeleton : "header" | "table" | "list" | "grid" | "detail" | "stats" | "form" | "card" | "text" | "none"
+        @label "Skeleton"
+        @description "Skeleton shown while this element's server render is in flight: a shape (`table`, `list`, …), `{ variant, rows?, columns?, fields? }`, or `none`."
+        @tier "presentation"
       ariaLabel : string
         @label "Aria-label"
         @description "Accessible name read by screen readers when the visible text is missing or not descriptive (e.g. an icon-only control)."

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

@@ -22,6 +22,7 @@ orbital ChartLegendOrbital {
           direction: @config.direction
           enter: @config.enter
           enterDelay: @config.enterDelay
+          skeleton: @config.skeleton
           aria-label: @config.ariaLabel
           aria-labelledby: @config.ariaLabelledby
           aria-describedby: @config.ariaDescribedby
@@ -61,6 +62,10 @@ orbital ChartLegendOrbital {
         @label "Enter Delay"
         @description "Stagger step for the entry: waits this many `--motion-enter-stagger` steps before animating."
         @tier "presentation"
+      skeleton : "header" | "table" | "list" | "grid" | "detail" | "stats" | "form" | "card" | "text" | "none"
+        @label "Skeleton"
+        @description "Skeleton shown while this element's server render is in flight: a shape (`table`, `list`, …), `{ variant, rows?, columns?, fields? }`, or `none`."
+        @tier "presentation"
       ariaLabel : string
         @label "Aria-label"
         @description "Accessible name read by screen readers when the visible text is missing or not descriptive (e.g. an icon-only control)."

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

@@ -49,6 +49,7 @@ orbital ChartOrbital {
     state idle {
       INIT -> idle
         (render-ui main {
+          surface: @config.surface
           title: @config.title
           subtitle: @config.subtitle
           chartType: @config.chartType
@@ -65,6 +66,7 @@ orbital ChartOrbital {
           drillEvent: @config.drillEvent
           actions: (array/filter @config.actions (fn action (or (= (array/len (object/get @action roles [])) 0) (array/includes (object/get @action roles []) @config.viewerRole))))
           isLoading: @config.isLoading
+          skeleton: @config.skeleton
           error: @config.error
           className: @config.className
           enter: @config.enter
@@ -88,6 +90,10 @@ orbital ChartOrbital {
     }
 
     config {
+      surface : "auto" | "none" = auto
+        @label "Surface"
+        @description "Content surface: `auto` paints the theme's surface behind this block unless it already sits on one (a card, dialog or another block); `none` opts out."
+        @tier "presentation"
       title : string
         @label "Title"
         @description "Chart title"
@@ -154,6 +160,10 @@ orbital ChartOrbital {
         @label "Is Loading"
         @description "Loading state"
         @tier "presentation"
+      skeleton : "header" | "table" | "list" | "grid" | "detail" | "stats" | "form" | "card" | "text" | "none" = card
+        @label "Skeleton"
+        @description "Skeleton drawn while loading, and the shape an empty slot shows while this element's server render is in flight (`none` opts out)."
+        @tier "presentation"
       error : ChartError
         @label "Error"
         @description "Error state"

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

@@ -87,6 +87,7 @@ orbital CodeBlockOrbital {
           lineNumbers: @config.lineNumbers
           enter: @config.enter
           enterDelay: @config.enterDelay
+          skeleton: @config.skeleton
           aria-label: @config.ariaLabel
           aria-labelledby: @config.ariaLabelledby
           aria-describedby: @config.ariaDescribedby
@@ -143,6 +144,7 @@ orbital CodeBlockOrbital {
           lineNumbers: @config.lineNumbers
           enter: @config.enter
           enterDelay: @config.enterDelay
+          skeleton: @config.skeleton
           aria-label: @config.ariaLabel
           aria-labelledby: @config.ariaLabelledby
           aria-describedby: @config.ariaDescribedby
@@ -199,6 +201,7 @@ orbital CodeBlockOrbital {
           lineNumbers: @config.lineNumbers
           enter: @config.enter
           enterDelay: @config.enterDelay
+          skeleton: @config.skeleton
           aria-label: @config.ariaLabel
           aria-labelledby: @config.ariaLabelledby
           aria-describedby: @config.ariaDescribedby
@@ -255,6 +258,7 @@ orbital CodeBlockOrbital {
           lineNumbers: @config.lineNumbers
           enter: @config.enter
           enterDelay: @config.enterDelay
+          skeleton: @config.skeleton
           aria-label: @config.ariaLabel
           aria-labelledby: @config.ariaLabelledby
           aria-describedby: @config.ariaDescribedby
@@ -311,6 +315,7 @@ orbital CodeBlockOrbital {
           lineNumbers: @config.lineNumbers
           enter: @config.enter
           enterDelay: @config.enterDelay
+          skeleton: @config.skeleton
           aria-label: @config.ariaLabel
           aria-labelledby: @config.ariaLabelledby
           aria-describedby: @config.ariaDescribedby
@@ -367,6 +372,7 @@ orbital CodeBlockOrbital {
           lineNumbers: @config.lineNumbers
           enter: @config.enter
           enterDelay: @config.enterDelay
+          skeleton: @config.skeleton
           aria-label: @config.ariaLabel
           aria-labelledby: @config.ariaLabelledby
           aria-describedby: @config.ariaDescribedby
@@ -423,6 +429,7 @@ orbital CodeBlockOrbital {
           lineNumbers: @config.lineNumbers
           enter: @config.enter
           enterDelay: @config.enterDelay
+          skeleton: @config.skeleton
           aria-label: @config.ariaLabel
           aria-labelledby: @config.ariaLabelledby
           aria-describedby: @config.ariaDescribedby
@@ -479,6 +486,7 @@ orbital CodeBlockOrbital {
           lineNumbers: @config.lineNumbers
           enter: @config.enter
           enterDelay: @config.enterDelay
+          skeleton: @config.skeleton
           aria-label: @config.ariaLabel
           aria-labelledby: @config.ariaLabelledby
           aria-describedby: @config.ariaDescribedby
@@ -701,6 +709,10 @@ orbital CodeBlockOrbital {
         @label "Enter Delay"
         @description "Stagger step for the entry: waits this many `--motion-enter-stagger` steps before animating."
         @tier "presentation"
+      skeleton : "header" | "table" | "list" | "grid" | "detail" | "stats" | "form" | "card" | "text" | "none"
+        @label "Skeleton"
+        @description "Skeleton shown while this element's server render is in flight: a shape (`table`, `list`, …), `{ variant, rows?, columns?, fields? }`, or `none`."
+        @tier "presentation"
       ariaLabel : string
         @label "Aria-label"
         @description "Accessible name read by screen readers when the visible text is missing or not descriptive (e.g. an icon-only control)."

package/behaviors/lolo/ui/core/molecules/ui-command-palette.lolo

@@ -49,6 +49,7 @@ orbital CommandPaletteOrbital {
           className: @config.className
           enter: @config.enter
           enterDelay: @config.enterDelay
+          skeleton: @config.skeleton
           aria-label: @config.ariaLabel
           aria-labelledby: @config.ariaLabelledby
           aria-describedby: @config.ariaDescribedby
@@ -77,6 +78,7 @@ orbital CommandPaletteOrbital {
           className: @config.className
           enter: @config.enter
           enterDelay: @config.enterDelay
+          skeleton: @config.skeleton
           aria-label: @config.ariaLabel
           aria-labelledby: @config.ariaLabelledby
           aria-describedby: @config.ariaDescribedby
@@ -151,6 +153,10 @@ orbital CommandPaletteOrbital {
         @label "Enter Delay"
         @description "Stagger step for the entry: waits this many `--motion-enter-stagger` steps before animating."
         @tier "presentation"
+      skeleton : "header" | "table" | "list" | "grid" | "detail" | "stats" | "form" | "card" | "text" | "none"
+        @label "Skeleton"
+        @description "Skeleton shown while this element's server render is in flight: a shape (`table`, `list`, …), `{ variant, rows?, columns?, fields? }`, or `none`."
+        @tier "presentation"
       ariaLabel : string
         @label "Aria-label"
         @description "Accessible name read by screen readers when the visible text is missing or not descriptive (e.g. an icon-only control)."

package/behaviors/lolo/ui/core/molecules/ui-commit-row.lolo

@@ -29,6 +29,7 @@ orbital CommitRowOrbital {
           className: @config.className
           enter: @config.enter
           enterDelay: @config.enterDelay
+          skeleton: @config.skeleton
           aria-label: @config.ariaLabel
           aria-labelledby: @config.ariaLabelledby
           aria-describedby: @config.ariaDescribedby
@@ -62,6 +63,7 @@ orbital CommitRowOrbital {
           className: @config.className
           enter: @config.enter
           enterDelay: @config.enterDelay
+          skeleton: @config.skeleton
           aria-label: @config.ariaLabel
           aria-labelledby: @config.ariaLabelledby
           aria-describedby: @config.ariaDescribedby
@@ -95,6 +97,7 @@ orbital CommitRowOrbital {
           className: @config.className
           enter: @config.enter
           enterDelay: @config.enterDelay
+          skeleton: @config.skeleton
           aria-label: @config.ariaLabel
           aria-labelledby: @config.ariaLabelledby
           aria-describedby: @config.ariaDescribedby
@@ -192,6 +195,10 @@ orbital CommitRowOrbital {
         @label "Enter Delay"
         @description "Stagger step for the entry: waits this many `--motion-enter-stagger` steps before animating."
         @tier "presentation"
+      skeleton : "header" | "table" | "list" | "grid" | "detail" | "stats" | "form" | "card" | "text" | "none"
+        @label "Skeleton"
+        @description "Skeleton shown while this element's server render is in flight: a shape (`table`, `list`, …), `{ variant, rows?, columns?, fields? }`, or `none`."
+        @tier "presentation"
       ariaLabel : string
         @label "Aria-label"
         @description "Accessible name read by screen readers when the visible text is missing or not descriptive (e.g. an icon-only control)."

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

@@ -43,6 +43,7 @@ orbital ConfirmDialogOrbital {
           className: @config.className
           enter: @config.enter
           enterDelay: @config.enterDelay
+          skeleton: @config.skeleton
           aria-label: @config.ariaLabel
           aria-labelledby: @config.ariaLabelledby
           aria-describedby: @config.ariaDescribedby
@@ -161,6 +162,10 @@ orbital ConfirmDialogOrbital {
         @label "Enter Delay"
         @description "Stagger step for the entry: waits this many `--motion-enter-stagger` steps before animating."
         @tier "presentation"
+      skeleton : "header" | "table" | "list" | "grid" | "detail" | "stats" | "form" | "card" | "text" | "none"
+        @label "Skeleton"
+        @description "Skeleton shown while this element's server render is in flight: a shape (`table`, `list`, …), `{ variant, rows?, columns?, fields? }`, or `none`."
+        @tier "presentation"
       ariaLabel : string
         @label "Aria-label"
         @description "Accessible name read by screen readers when the visible text is missing or not descriptive (e.g. an icon-only control)."