@almadar/std 16.238.0 → 16.239.0

package/behaviors/lolo/ui/core/organisms/ui-media-gallery.lolo

@@ -48,6 +48,7 @@ orbital MediaGalleryOrbital {
           totalCount: @config.totalCount
           activeFilters: @config.activeFilters
           selectedIds: @config.selectedIds
+          surface: @config.surface
           entity: @entity
           title: @config.title
           items: @config.items
@@ -62,6 +63,7 @@ orbital MediaGalleryOrbital {
           captionField: @config.captionField
           enter: @config.enter
           enterDelay: @config.enterDelay
+          skeleton: @config.skeleton
           aria-label: @config.ariaLabel
           aria-labelledby: @config.ariaLabelledby
           aria-describedby: @config.ariaDescribedby
@@ -91,6 +93,7 @@ orbital MediaGalleryOrbital {
           totalCount: @config.totalCount
           activeFilters: @config.activeFilters
           selectedIds: @config.selectedIds
+          surface: @config.surface
           entity: @entity
           title: @config.title
           items: @config.items
@@ -105,6 +108,7 @@ orbital MediaGalleryOrbital {
           captionField: @config.captionField
           enter: @config.enter
           enterDelay: @config.enterDelay
+          skeleton: @config.skeleton
           aria-label: @config.ariaLabel
           aria-labelledby: @config.ariaLabelledby
           aria-describedby: @config.ariaDescribedby
@@ -134,6 +138,7 @@ orbital MediaGalleryOrbital {
           totalCount: @config.totalCount
           activeFilters: @config.activeFilters
           selectedIds: @config.selectedIds
+          surface: @config.surface
           entity: @payload.data
           title: @config.title
           items: @config.items
@@ -148,6 +153,7 @@ orbital MediaGalleryOrbital {
           captionField: @config.captionField
           enter: @config.enter
           enterDelay: @config.enterDelay
+          skeleton: @config.skeleton
           aria-label: @config.ariaLabel
           aria-labelledby: @config.ariaLabelledby
           aria-describedby: @config.ariaDescribedby
@@ -224,6 +230,10 @@ orbital MediaGalleryOrbital {
         @label "Selected Ids"
         @description "Currently selected item IDs"
         @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"
       title : string
         @label "Title"
         @description "Gallery title"
@@ -276,6 +286,10 @@ orbital MediaGalleryOrbital {
         @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/organisms/ui-modal-slot.lolo

@@ -30,6 +30,7 @@ orbital ModalSlotOrbital {
           sourceTrait: @config.sourceTrait
           enter: @config.enter
           enterDelay: @config.enterDelay
+          skeleton: @config.skeleton
           type: modal-slot
         })
     }
@@ -71,6 +72,10 @@ orbital ModalSlotOrbital {
         @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"
     }
   }
 

package/behaviors/lolo/ui/core/organisms/ui-runtime-debugger.lolo

@@ -19,6 +19,7 @@ orbital RuntimeDebuggerOrbital {
           defaultTab: @config.defaultTab
           enter: @config.enter
           enterDelay: @config.enterDelay
+          skeleton: @config.skeleton
           aria-label: @config.ariaLabel
           aria-labelledby: @config.ariaLabelledby
           aria-describedby: @config.ariaDescribedby
@@ -66,6 +67,10 @@ orbital RuntimeDebuggerOrbital {
         @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/organisms/ui-segment-renderer.lolo

@@ -3,8 +3,9 @@ app ui-segment-renderer "1.0.0"
 ;; @pattern "segment-renderer"
 orbital SegmentRendererOrbital {
   type SegmentRendererSegmentsItem = {
-    type : "markdown"!
-    content : string!
+    type : "quiz"!
+    question : string!
+    answer : string!
   }
   type SegmentRendererUserProgress = {
     activationResponse : string
@@ -28,6 +29,7 @@ orbital SegmentRendererOrbital {
           userProgress: @config.userProgress
           enter: @config.enter
           enterDelay: @config.enterDelay
+          skeleton: @config.skeleton
           aria-label: @config.ariaLabel
           aria-labelledby: @config.ariaLabelledby
           aria-describedby: @config.ariaDescribedby
@@ -47,7 +49,7 @@ orbital SegmentRendererOrbital {
     }
 
     config {
-      segments : [SegmentRendererSegmentsItem] = [{ type: markdown, content: "Content" }, { type: markdown, content: "Content 2" }]
+      segments : [SegmentRendererSegmentsItem] = [{ type: quiz, question: "Question", answer: "Answer" }, { type: quiz, question: "Question 2", answer: "Answer 2" }]
         @label "Segments"
         @description "Parsed lesson segments (see `parseLessonSegments`)"
         @tier "presentation"
@@ -71,6 +73,10 @@ orbital SegmentRendererOrbital {
         @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/organisms/ui-split-pane.lolo

@@ -26,6 +26,7 @@ orbital SplitPaneOrbital {
           onRatioChange: @config.onRatioChange
           enter: @config.enter
           enterDelay: @config.enterDelay
+          skeleton: @config.skeleton
           aria-label: @config.ariaLabel
           aria-labelledby: @config.ariaLabelledby
           aria-describedby: @config.ariaDescribedby
@@ -57,6 +58,7 @@ orbital SplitPaneOrbital {
           onRatioChange: @config.onRatioChange
           enter: @config.enter
           enterDelay: @config.enterDelay
+          skeleton: @config.skeleton
           aria-label: @config.ariaLabel
           aria-labelledby: @config.ariaLabelledby
           aria-describedby: @config.ariaDescribedby
@@ -138,6 +140,10 @@ orbital SplitPaneOrbital {
         @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/organisms/ui-stat-card.lolo

@@ -67,8 +67,10 @@ orbital StatCardOrbital {
           metrics: @config.metrics
           compact: @config.compact
           sparklineData: @config.sparklineData
+          surface: @config.surface
           enter: @config.enter
           enterDelay: @config.enterDelay
+          skeleton: @config.skeleton
           aria-label: @config.ariaLabel
           aria-labelledby: @config.ariaLabelledby
           aria-describedby: @config.ariaDescribedby
@@ -115,8 +117,10 @@ orbital StatCardOrbital {
           metrics: @config.metrics
           compact: @config.compact
           sparklineData: @config.sparklineData
+          surface: @config.surface
           enter: @config.enter
           enterDelay: @config.enterDelay
+          skeleton: @config.skeleton
           aria-label: @config.ariaLabel
           aria-labelledby: @config.ariaLabelledby
           aria-describedby: @config.ariaDescribedby
@@ -163,8 +167,10 @@ orbital StatCardOrbital {
           metrics: @config.metrics
           compact: @config.compact
           sparklineData: @config.sparklineData
+          surface: @config.surface
           enter: @config.enter
           enterDelay: @config.enterDelay
+          skeleton: @config.skeleton
           aria-label: @config.ariaLabel
           aria-labelledby: @config.ariaLabelledby
           aria-describedby: @config.ariaDescribedby
@@ -300,6 +306,10 @@ orbital StatCardOrbital {
         @label "Sparkline Data"
         @description "Sparkline data points for an inline trend chart"
         @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"
       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."
@@ -308,6 +318,10 @@ orbital StatCardOrbital {
         @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/organisms/ui-state-machine-view.lolo

@@ -68,6 +68,7 @@ orbital StateMachineViewOrbital {
           error: @config.error
           enter: @config.enter
           enterDelay: @config.enterDelay
+          skeleton: @config.skeleton
           aria-label: @config.ariaLabel
           aria-labelledby: @config.ariaLabelledby
           aria-describedby: @config.ariaDescribedby
@@ -136,7 +137,7 @@ orbital StateMachineViewOrbital {
         @label "Pending Source State"
         @description "Source of a transition being drawn — the next state click picks its target."
         @tier "presentation"
-      nodeShape : "pill" | "gear"
+      nodeShape : "pill" | "gear" = pill
         @label "Node Shape"
         @description "Node silhouette. @default 'pill'"
         @tier "presentation"
@@ -144,11 +145,11 @@ orbital StateMachineViewOrbital {
         @label "Entity Fields"
         @description "Entity field names listed in the header."
         @tier "presentation"
-      direction : "ltr" | "rtl"
+      direction : "ltr" | "rtl" = ltr
         @label "Direction"
         @description "Flow direction. @default 'ltr'"
         @tier "presentation"
-      showHeader : boolean
+      showHeader : boolean = true
         @label "Show Header"
         @description "Show the trait header (name, entity, listens/emits). @default true"
         @tier "presentation"
@@ -177,6 +178,10 @@ orbital StateMachineViewOrbital {
         @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/organisms/ui-subagent-trace-panel.lolo

@@ -18,12 +18,234 @@ orbital SubagentTracePanelOrbital {
     task : string!
     messages : [SubagentTracePanelSubagentsItemMessagesItem]!
     durationMs : number
+    timeline : [SubagentTracePanelSubagentsItemTimelineItem]
   }
   type SubagentTracePanelSubagentsItemMessagesItem = {
     message : string!
     tool : string
     timestamp : number!
   }
+  type SubagentTracePanelSubagentsItemTimelineItem = SubagentTracePanelSubagentsItemTimelineItemMessage | SubagentTracePanelSubagentsItemTimelineItemToolCall | SubagentTracePanelSubagentsItemTimelineItemToolResult | SubagentTracePanelSubagentsItemTimelineItemFileOperation | SubagentTracePanelSubagentsItemTimelineItemSchemaDiff | SubagentTracePanelSubagentsItemTimelineItemError | SubagentTracePanelSubagentsItemTimelineItemMilestone
+  type SubagentTracePanelSubagentsItemTimelineItemMessage = {
+    type : "message"!
+    role : "user" | "assistant" | "system" | "tool"!
+    content : string!
+    timestamp : number!
+    isStreaming : boolean
+    label : string
+  }
+  type SubagentTracePanelSubagentsItemTimelineItemToolCall = {
+    type : "tool_call"!
+    tool : string!
+    argsText : string!
+    timestamp : number!
+    isExecuting : boolean
+  }
+  type SubagentTracePanelSubagentsItemTimelineItemToolResult = {
+    type : "tool_result"!
+    tool : string!
+    resultText : string!
+    success : boolean!
+    timestamp : number!
+    durationMs : number
+  }
+  type SubagentTracePanelSubagentsItemTimelineItemFileOperation = {
+    type : "file_operation"!
+    operation : "ls" | "read_file" | "write_file" | "edit_file"!
+    path : string!
+    success : boolean
+    timestamp : number!
+  }
+  type SubagentTracePanelSubagentsItemTimelineItemSchemaDiff = {
+    type : "schema_diff"!
+    filePath : string!
+    hunks : [SubagentTracePanelSubagentsItemTimelineItemSchemaDiffHunksItem]!
+    timestamp : number!
+  }
+  type SubagentTracePanelSubagentsItemTimelineItemSchemaDiffHunksItem = {
+    oldStart : number!
+    oldLines : number!
+    newStart : number!
+    newLines : number!
+    lines : [SubagentTracePanelSubagentsItemTimelineItemSchemaDiffHunksItemLinesItem]!
+  }
+  type SubagentTracePanelSubagentsItemTimelineItemSchemaDiffHunksItemLinesItem = {
+    type : "add" | "remove" | "context"!
+    content : string!
+  }
+  type SubagentTracePanelSubagentsItemTimelineItemError = {
+    type : "error"!
+    message : string!
+    code : string
+    timestamp : number!
+  }
+  type SubagentTracePanelSubagentsItemTimelineItemMilestone = {
+    type : "milestone"!
+    milestone : string!
+    summary : string
+    timestamp : number!
+  }
+  type SubagentTracePanelCoordinatorActivitiesItem = SubagentTracePanelCoordinatorActivitiesItemMessage | SubagentTracePanelCoordinatorActivitiesItemToolCall | SubagentTracePanelCoordinatorActivitiesItemToolResult | SubagentTracePanelCoordinatorActivitiesItemFileOperation | SubagentTracePanelCoordinatorActivitiesItemSchemaDiff | SubagentTracePanelCoordinatorActivitiesItemError | SubagentTracePanelCoordinatorActivitiesItemCoordinatorDecision | SubagentTracePanelCoordinatorActivitiesItemPlanCommitted | SubagentTracePanelCoordinatorActivitiesItemPendingQuestion | SubagentTracePanelCoordinatorActivitiesItemClarificationQuestion | SubagentTracePanelCoordinatorActivitiesItemAnalysis | SubagentTracePanelCoordinatorActivitiesItemOrbitalStarted | SubagentTracePanelCoordinatorActivitiesItemOrbitalDone | SubagentTracePanelCoordinatorActivitiesItemSchemaChange | SubagentTracePanelCoordinatorActivitiesItemDone | SubagentTracePanelCoordinatorActivitiesItemCancelled | SubagentTracePanelCoordinatorActivitiesItemLlmResponse
+  type SubagentTracePanelCoordinatorActivitiesItemMessage = {
+    type : "message"!
+    role : "user" | "assistant" | "system"!
+    content : string!
+    timestamp : number!
+    isStreaming : boolean
+  }
+  type SubagentTracePanelCoordinatorActivitiesItemToolCall = {
+    type : "tool_call"!
+    tool : string!
+    kind : "input" | "read" | "invalid"
+    argsText : string!
+    timestamp : number!
+    isExecuting : boolean
+  }
+  type SubagentTracePanelCoordinatorActivitiesItemToolResult = {
+    type : "tool_result"!
+    tool : string!
+    kind : "input" | "read" | "invalid"
+    success : boolean!
+    detail : string
+    rows : number
+    resultText : string!
+    timestamp : number!
+  }
+  type SubagentTracePanelCoordinatorActivitiesItemFileOperation = {
+    type : "file_operation"!
+    operation : "ls" | "read_file" | "write_file" | "edit_file"!
+    path : string!
+    success : boolean
+    timestamp : number!
+  }
+  type SubagentTracePanelCoordinatorActivitiesItemSchemaDiff = {
+    type : "schema_diff"!
+    filePath : string!
+    hunks : [SubagentTracePanelCoordinatorActivitiesItemSchemaDiffHunksItem]!
+    timestamp : number!
+  }
+  type SubagentTracePanelCoordinatorActivitiesItemSchemaDiffHunksItem = {
+    oldStart : number!
+    oldLines : number!
+    newStart : number!
+    newLines : number!
+    lines : [SubagentTracePanelCoordinatorActivitiesItemSchemaDiffHunksItemLinesItem]!
+  }
+  type SubagentTracePanelCoordinatorActivitiesItemSchemaDiffHunksItemLinesItem = {
+    type : "add" | "remove" | "context"!
+    content : string!
+  }
+  type SubagentTracePanelCoordinatorActivitiesItemError = {
+    type : "error"!
+    message : string!
+    code : string
+    timestamp : number!
+  }
+  type SubagentTracePanelCoordinatorActivitiesItemCoordinatorDecision = {
+    type : "coordinator_decision"!
+    organism : string!
+    reason : string!
+    priorOrganism : string
+    timestamp : number!
+  }
+  type SubagentTracePanelCoordinatorActivitiesItemPlanCommitted = {
+    type : "plan_committed"!
+    orbitals : [string]!
+    timestamp : number!
+  }
+  type SubagentTracePanelCoordinatorActivitiesItemPendingQuestion = {
+    type : "pending_question"!
+    questionId : string!
+    question : string!
+    orbitalName : string
+    timestamp : number!
+  }
+  type SubagentTracePanelCoordinatorActivitiesItemClarificationQuestion = {
+    type : "clarification_question"!
+    level : "organism" | "molecule" | "atom_trait"!
+    scope : SubagentTracePanelCoordinatorActivitiesItemClarificationQuestionScope!
+    question : string!
+    candidates : [SubagentTracePanelCoordinatorActivitiesItemClarificationQuestionCandidatesItem]!
+    skipDefault : string!
+    timestamp : number!
+  }
+  type SubagentTracePanelCoordinatorActivitiesItemClarificationQuestionScope = {
+    orbitalName : string
+    traitName : string
+  }
+  type SubagentTracePanelCoordinatorActivitiesItemClarificationQuestionCandidatesItem = {
+    id : string!
+    label : string!
+    description : string!
+    whyThisFits : string!
+  }
+  type SubagentTracePanelCoordinatorActivitiesItemAnalysis = {
+    type : "analysis"!
+    organism : string!
+    organismReason : string
+    complexity : SubagentTracePanelCoordinatorActivitiesItemAnalysisComplexity
+    renames : [SubagentTracePanelCoordinatorActivitiesItemAnalysisRenamesItem]!
+    deletes : [string]!
+    timestamp : number!
+  }
+  type SubagentTracePanelCoordinatorActivitiesItemAnalysisComplexity = {
+    category : string!
+    reasoning : string!
+  }
+  type SubagentTracePanelCoordinatorActivitiesItemAnalysisRenamesItem = {
+    from : string!
+    to : string!
+  }
+  type SubagentTracePanelCoordinatorActivitiesItemOrbitalStarted = {
+    type : "orbital_started"!
+    orbitalName : string!
+    timestamp : number!
+  }
+  type SubagentTracePanelCoordinatorActivitiesItemOrbitalDone = {
+    type : "orbital_done"!
+    orbitalName : string!
+    traitCount : number
+    transitionCount : number
+    timestamp : number!
+  }
+  type SubagentTracePanelCoordinatorActivitiesItemSchemaChange = {
+    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 SubagentTracePanelCoordinatorActivitiesItemDone = {
+    type : "done"!
+    orbitalCount : number!
+    timestamp : number!
+  }
+  type SubagentTracePanelCoordinatorActivitiesItemCancelled = {
+    type : "cancelled"!
+    message : string!
+    timestamp : number!
+  }
+  type SubagentTracePanelCoordinatorActivitiesItemLlmResponse = {
+    type : "llm_response"!
+    content : string!
+    llm : SubagentTracePanelCoordinatorActivitiesItemLlmResponseLlm
+    timestamp : number!
+  }
+  type SubagentTracePanelCoordinatorActivitiesItemLlmResponseLlm = {
+    service : string!
+    provider : string!
+    model : string!
+    systemPrompt : string!
+    userPrompt : string!
+    toolCallsJson : string
+    attempt : number
+    durationMs : number!
+    promptTokens : number
+    completionTokens : number
+    cachedPromptTokens : number
+    costUSD : number
+  }
   type SubagentTracePanelCoordinatorMessagesItem = {
     role : "system" | "user" | "assistant" | "tool"!
     content : string!
@@ -69,10 +291,12 @@ orbital SubagentTracePanelOrbital {
           disclosureLevel: @config.disclosureLevel
           open: @config.open
           onClose: @config.onClose
+          coordinatorActivities: @config.coordinatorActivities
           coordinatorMessages: @config.coordinatorMessages
           mode: @config.mode
           enter: @config.enter
           enterDelay: @config.enterDelay
+          skeleton: @config.skeleton
           aria-label: @config.ariaLabel
           aria-labelledby: @config.ariaLabelledby
           aria-describedby: @config.ariaDescribedby
@@ -178,6 +402,10 @@ orbital SubagentTracePanelOrbital {
         @label "On Close"
         @description "Optional dismiss handler."
         @tier "presentation"
+      coordinatorActivities : [SubagentTracePanelCoordinatorActivitiesItem] = []
+        @label "Coordinator Activities"
+        @description "Full coordinator activities (tool calls, results, messages, errors)."
+        @tier "presentation"
       coordinatorMessages : [SubagentTracePanelCoordinatorMessagesItem] = []
         @label "Coordinator Messages"
         @description "Canonical Coordinator conversation — same shape live and on reload. When present, takes precedence over `coordinatorActivities` for the Coordinator section."
@@ -194,6 +422,10 @@ orbital SubagentTracePanelOrbital {
         @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/organisms/ui-tabbed-container.lolo

@@ -29,6 +29,7 @@ orbital TabbedContainerOrbital {
           className: @config.className
           enter: @config.enter
           enterDelay: @config.enterDelay
+          skeleton: @config.skeleton
           aria-label: @config.ariaLabel
           aria-labelledby: @config.ariaLabelledby
           aria-describedby: @config.ariaDescribedby
@@ -88,6 +89,10 @@ orbital TabbedContainerOrbital {
         @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/organisms/ui-timeline.lolo

@@ -37,8 +37,10 @@ orbital TimelineOrbital {
       INIT -> idle when @config.selfFetch
         (fetch TimelineItem { emit: { success: TimelineLoaded } })
         (render-ui main {
+          surface: @config.surface
           className: @config.className
           isLoading: @config.isLoading
+          skeleton: @config.skeleton
           error: @config.error
           entity: @entity
           title: @config.title
@@ -70,8 +72,10 @@ orbital TimelineOrbital {
         })
       INIT -> idle when (not @config.selfFetch)
         (render-ui main {
+          surface: @config.surface
           className: @config.className
           isLoading: @config.isLoading
+          skeleton: @config.skeleton
           error: @config.error
           entity: @entity
           title: @config.title
@@ -103,8 +107,10 @@ orbital TimelineOrbital {
         })
       TimelineLoaded -> idle
         (render-ui main {
+          surface: @config.surface
           className: @config.className
           isLoading: @config.isLoading
+          skeleton: @config.skeleton
           error: @config.error
           entity: @payload.data
           title: @config.title
@@ -150,6 +156,10 @@ orbital TimelineOrbital {
     }
 
     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"
       className : string
         @label "Class Name"
         @description "Additional CSS classes"
@@ -158,6 +168,10 @@ orbital TimelineOrbital {
         @label "Is Loading"
         @description "Loading state indicator"
         @tier "presentation"
+      skeleton : "header" | "table" | "list" | "grid" | "detail" | "stats" | "form" | "card" | "text" | "none" = list
+        @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 : TimelineError
         @label "Error"
         @description "Error state"

package/behaviors/lolo/ui/core/organisms/ui-toast-slot.lolo

@@ -31,6 +31,7 @@ orbital ToastSlotOrbital {
           sourceTrait: @config.sourceTrait
           enter: @config.enter
           enterDelay: @config.enterDelay
+          skeleton: @config.skeleton
           aria-label: @config.ariaLabel
           aria-labelledby: @config.ariaLabelledby
           aria-describedby: @config.ariaDescribedby
@@ -90,6 +91,10 @@ orbital ToastSlotOrbital {
         @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/templates/ui-counter-template.lolo

@@ -33,6 +33,7 @@ orbital CounterTemplateOrbital {
           variant: @config.variant
           enter: @config.enter
           enterDelay: @config.enterDelay
+          skeleton: @config.skeleton
           aria-label: @config.ariaLabel
           aria-labelledby: @config.ariaLabelledby
           aria-describedby: @config.ariaDescribedby
@@ -116,6 +117,10 @@ orbital CounterTemplateOrbital {
         @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)."