@almadar/std 16.241.0 → 16.242.0

package/behaviors/signatures.lolo

@@ -11335,7 +11335,7 @@ pattern meter {
 ;; an `Alias.orbitals.X` reference overrides config + identifiers, never
 ;; the imported orbital's own topology.
 
-;; === atoms (281 behaviors, 281 apps, 281 orbitals, 281 entities, 302 traits, 284 pages) ===
+;; === atoms (280 behaviors, 280 apps, 281 orbitals, 281 entities, 302 traits, 284 pages) ===
 
 ;; From @almadar/std (behaviors/registry/agent/atoms/std-agent-completion.orb)
 app std-agent-completion {
@@ -11391,7 +11391,7 @@ app std-agent-planner {
 app std-agent-session {
   alias          : AgentSession
   version        : "3.0.0"
-  orbitals       : (AgentSessionOrbital)
+  orbitals       : (AgentSessionOrbital AgentChatsOrbital)
   override-surface : (config)
   ;; via uses Alias from "std/behaviors/std-agent-session" { config { ... } }
   source         : "@almadar/std (behaviors/registry/agent/atoms/std-agent-session.orb)"
@@ -12337,16 +12337,6 @@ app std-lifecycle {
   source         : "@almadar/std (behaviors/registry/infra/atoms/std-lifecycle.orb)"
 }
 
-;; From @almadar/std (behaviors/registry/ui/core/atoms/std-list.orb)
-app std-list {
-  alias          : List
-  version        : "1.0.0"
-  orbitals       : (ListItemOrbital)
-  override-surface : (config)
-  ;; via uses Alias from "std/behaviors/std-list" { config { ... } }
-  source         : "@almadar/std (behaviors/registry/ui/core/atoms/std-list.orb)"
-}
-
 ;; From @almadar/std (behaviors/registry/ui/game/atoms/std-lives.orb)
 app std-lives {
   alias          : Lives
@@ -14197,6 +14187,16 @@ orbital std-agent-planner.orbitals.AgentPlannerOrbital {
   source         : "@almadar/std (behaviors/registry/agent/atoms/std-agent-planner.orb orbitals[0])"
 }
 
+;; From @almadar/std (behaviors/registry/agent/atoms/std-agent-session.orb orbitals[1])
+orbital std-agent-session.orbitals.AgentChatsOrbital {
+  alias          : AgentSession
+  entity         : AgentChat
+  traits         : (AgentChatKeeper AgentChatList)
+  pages          : ("/agent-session/chats")
+  override-surface : (entity fields extend pages omit only config events roles entities mounts)
+  source         : "@almadar/std (behaviors/registry/agent/atoms/std-agent-session.orb orbitals[1])"
+}
+
 ;; From @almadar/std (behaviors/registry/agent/atoms/std-agent-session.orb orbitals[0])
 orbital std-agent-session.orbitals.AgentSessionOrbital {
   alias          : AgentSession
@@ -15147,16 +15147,6 @@ orbital std-lifecycle.orbitals.LifecycleOrbital {
   source         : "@almadar/std (behaviors/registry/infra/atoms/std-lifecycle.orb orbitals[0])"
 }
 
-;; From @almadar/std (behaviors/registry/ui/core/atoms/std-list.orb orbitals[0])
-orbital std-list.orbitals.ListItemOrbital {
-  alias          : List
-  entity         : ListItem
-  traits         : (ListItemBrowse ListItemPersistor ListItemCreateButton = Button.traits.ButtonRender ListItemCreateGate = RoleGate.traits.RoleGate ListItemCreate = Modal.traits.ModalRecordModal ListItemEdit = Modal.traits.ModalRecordModal ListItemDelete = Confirmation.traits.ConfirmActionConfirmation)
-  pages          : ("/listitems")
-  override-surface : (entity fields extend pages omit only config events roles entities mounts)
-  source         : "@almadar/std (behaviors/registry/ui/core/atoms/std-list.orb orbitals[0])"
-}
-
 ;; From @almadar/std (behaviors/registry/ui/game/atoms/std-lives.orb orbitals[0])
 orbital std-lives.orbitals.LivesOrbital {
   alias          : Lives
@@ -17008,13 +16998,24 @@ entity std-agent-planner.entity {
   source         : "@almadar/std (behaviors/registry/agent/atoms/std-agent-planner.orb orbitals[0].entity)"
 }
 
+;; From @almadar/std (behaviors/registry/agent/atoms/std-agent-session.orb orbitals[1].entity)
+entity std-agent-session.entity {
+  alias          : AgentSession
+  name           : AgentChat
+  persistence    : persistent
+  collection     : agentChats
+  fields         : (id! ownerId! title startedAt lastActiveAt pendingMessage pendingReply)
+  override-surface : (extends name fields persistence collection)
+  source         : "@almadar/std (behaviors/registry/agent/atoms/std-agent-session.orb orbitals[1].entity)"
+}
+
 ;; From @almadar/std (behaviors/registry/agent/atoms/std-agent-session.orb orbitals[0].entity)
 entity std-agent-session.entity {
   alias          : AgentSession
   name           : AgentMessage
   persistence    : persistent
   collection     : agentMessages
-  fields         : (id! ownerId! role content! createdAt)
+  fields         : (id! ownerId! role content! createdAt chatId)
   override-surface : (extends name fields persistence collection)
   source         : "@almadar/std (behaviors/registry/agent/atoms/std-agent-session.orb orbitals[0].entity)"
 }
@@ -17709,7 +17710,7 @@ entity std-learn-coupled-sim.entity {
   alias          : LearnCoupledSim
   name           : CoupledSimScene
   persistence    : runtime
-  fields         : (id! active title t p q coefA coefB running pSamples qSamples curves)
+  fields         : (id! active title t p q coefA coefB running speed pSamples qSamples curves)
   override-surface : (extends name fields persistence collection)
   source         : "@almadar/std (behaviors/registry/ui/learning/atoms/std-learn-coupled-sim.orb orbitals[0].entity)"
 }
@@ -17779,7 +17780,7 @@ entity std-learn-grid-sim.entity {
   alias          : LearnGridSim
   name           : GridSimScene
   persistence    : runtime
-  fields         : (id! active title cells generation aliveCount running cellShapes)
+  fields         : (id! active title cells generation aliveCount running speed elapsedMs cellShapes)
   override-surface : (extends name fields persistence collection)
   source         : "@almadar/std (behaviors/registry/ui/learning/atoms/std-learn-grid-sim.orb orbitals[0].entity)"
 }
@@ -17809,7 +17810,7 @@ entity std-learn-measure.entity {
   alias          : LearnMeasure
   name           : MeasureScene
   persistence    : runtime
-  fields         : (id! active title t value running traceSamples traceCurves points sampleCount meanValue)
+  fields         : (id! active title t value running speed traceSamples traceCurves points sampleCount meanValue)
   override-surface : (extends name fields persistence collection)
   source         : "@almadar/std (behaviors/registry/ui/learning/atoms/std-learn-measure.orb orbitals[0].entity)"
 }
@@ -17829,7 +17830,7 @@ entity std-learn-perturb.entity {
   alias          : LearnPerturb
   name           : PerturbScene
   persistence    : runtime
-  fields         : (id! active title t value setpoint rate running traceSamples curves)
+  fields         : (id! active title t value setpoint rate running speed traceSamples curves)
   override-surface : (extends name fields persistence collection)
   source         : "@almadar/std (behaviors/registry/ui/learning/atoms/std-learn-perturb.orb orbitals[0].entity)"
 }
@@ -17909,7 +17910,7 @@ entity std-learn-speed-drill.entity {
   alias          : LearnSpeedDrill
   name           : SpeedDrillScene
   persistence    : runtime
-  fields         : (id! active title itemIndex totalItems remaining running verdict score streak bestStreak done promptText options correctIndex feedback view)
+  fields         : (id! active title itemIndex totalItems remaining running verdict score streak bestStreak done promptText options correctIndex feedback pickedIndex view)
   override-surface : (extends name fields persistence collection)
   source         : "@almadar/std (behaviors/registry/ui/learning/atoms/std-learn-speed-drill.orb orbitals[0].entity)"
 }
@@ -17939,7 +17940,7 @@ entity std-learn-trace-player.entity {
   alias          : LearnTracePlayer
   name           : TracePlayerScene
   persistence    : runtime
-  fields         : (id! active title frameIndex running bars frameLabel frameCaption statusNote)
+  fields         : (id! active title frameIndex running speed elapsedMs bars frameLabel frameCaption statusNote)
   override-surface : (extends name fields persistence collection)
   source         : "@almadar/std (behaviors/registry/ui/learning/atoms/std-learn-trace-player.orb orbitals[0].entity)"
 }
@@ -17949,7 +17950,7 @@ entity std-learn-transport.entity {
   alias          : LearnTransport
   name           : LearnTransportScene
   persistence    : runtime
-  fields         : (id! active title running steps elapsedMs done)
+  fields         : (id! active title running steps elapsedMs done speed)
   override-surface : (extends name fields persistence collection)
   source         : "@almadar/std (behaviors/registry/ui/learning/atoms/std-learn-transport.orb orbitals[0].entity)"
 }
@@ -17975,17 +17976,6 @@ entity std-lifecycle.entity {
   source         : "@almadar/std (behaviors/registry/infra/atoms/std-lifecycle.orb orbitals[0].entity)"
 }
 
-;; From @almadar/std (behaviors/registry/ui/core/atoms/std-list.orb orbitals[0].entity)
-entity std-list.entity {
-  alias          : List
-  name           : ListItem
-  persistence    : persistent
-  collection     : listitems
-  fields         : (id! name! description status createdAt pendingId)
-  override-surface : (extends name fields persistence collection)
-  source         : "@almadar/std (behaviors/registry/ui/core/atoms/std-list.orb orbitals[0].entity)"
-}
-
 ;; From @almadar/std (behaviors/registry/ui/game/atoms/std-lives.orb orbitals[0].entity)
 entity std-lives.entity {
   alias          : Lives
@@ -19890,9 +19880,9 @@ trait std-agent-memory.traits.AgentMemoryRecall {
   linkedEntity   : AgentMemory
   category       : lifecycle
   states         : (ready* recalling remembering)
-  events         : (INIT MEMORY_STORED RECALL REMEMBER MemoryEmbedded MemoriesForRecall MemoryEmbedFailed AgentMemoriesLoadFailed RECALLED)
-  transitions    : ((ready -> ready on INIT) (ready -> ready on MEMORY_STORED) (ready -> recalling on RECALL) (ready -> remembering on REMEMBER) (recalling -> recalling on MemoryEmbedded) (recalling -> ready on MemoriesForRecall) (recalling -> ready on MemoryEmbedFailed) (recalling -> ready on AgentMemoriesLoadFailed) (remembering -> ready on MemoryEmbedded) (remembering -> ready on MemoryEmbedFailed))
-  emits          : (RECALLED MEMORY_STORED AgentMemoriesLoadFailed MemoriesForRecall MemoryEmbedded MemoryEmbedFailed)
+  events         : (INIT MEMORY_STORED LIST MemoriesForList MemoryListFailed RECALL REMEMBER MemoryEmbedded MemoriesForRecall MemoryEmbedFailed AgentMemoriesLoadFailed RECALLED ASSISTANT_MEMORIES_LOADED)
+  transitions    : ((ready -> ready on INIT) (ready -> ready on MEMORY_STORED) (ready -> ready on LIST) (ready -> ready on MemoriesForList) (ready -> ready on MemoryListFailed) (ready -> recalling on RECALL) (ready -> remembering on REMEMBER) (recalling -> recalling on MemoryEmbedded) (recalling -> ready on MemoriesForRecall) (recalling -> ready on MemoryEmbedFailed) (recalling -> ready on AgentMemoriesLoadFailed) (remembering -> ready on MemoryEmbedded) (remembering -> ready on MemoryEmbedFailed))
+  emits          : (RECALLED ASSISTANT_MEMORIES_LOADED MemoriesForList MemoryListFailed MEMORY_STORED AgentMemoriesLoadFailed MemoriesForRecall MemoryEmbedded MemoryEmbedFailed)
   config {
     recallLimit    : number = 3 @label "Memories recalled per request" @description "How many of the closest memories go to the model with each request." @tier "policy"
   }
@@ -19925,19 +19915,56 @@ trait std-agent-planner.traits.PlannerListener {
   source         : "@almadar/std (behaviors/registry/agent/atoms/std-agent-planner.orb orbitals[0].traits[1])"
 }
 
+;; From @almadar/std (behaviors/registry/agent/atoms/std-agent-session.orb orbitals[1].traits[0])
+trait std-agent-session.traits.AgentChatKeeper {
+  alias          : AgentSession
+  linkedEntity   : AgentChat
+  category       : lifecycle
+  states         : (ready*)
+  events         : (INIT LOAD_HISTORY ChatsForHistory SEND ChatsForSend ChatReadyForSend REPLIED ChatsForReply NEW_CHAT NewChatStarted SELECT_CHAT ChatsForSelect ChatSelected LIST_CHATS ChatsForList AgentChatsLoadFailed ASSISTANT_CHAT_OPENED ASSISTANT_SEND_IN_CHAT ASSISTANT_REPLY_IN_CHAT ASSISTANT_CHATS_CHANGED ASSISTANT_THREAD_FAILED ASSISTANT_CHATS_LOADED)
+  transitions    : ((ready -> ready on INIT) (ready -> ready on LOAD_HISTORY) (ready -> ready on ChatsForHistory) (ready -> ready on SEND) (ready -> ready on ChatsForSend) (ready -> ready on ChatsForSend) (ready -> ready on ChatReadyForSend) (ready -> ready on REPLIED) (ready -> ready on ChatsForReply) (ready -> ready on NEW_CHAT) (ready -> ready on NewChatStarted) (ready -> ready on SELECT_CHAT) (ready -> ready on ChatsForSelect) (ready -> ready on ChatSelected) (ready -> ready on LIST_CHATS) (ready -> ready on ChatsForList) (ready -> ready on AgentChatsLoadFailed))
+  emits          : (ASSISTANT_CHAT_OPENED ASSISTANT_SEND_IN_CHAT ASSISTANT_REPLY_IN_CHAT ASSISTANT_CHATS_CHANGED ASSISTANT_THREAD_FAILED ASSISTANT_CHATS_LOADED ChatsForList ChatsForHistory ChatsForSend ChatsForReply ChatsForSelect ChatReadyForSend NewChatStarted ChatSelected AgentChatsLoadFailed)
+  override-surface : (linkedEntity name events effects listens emitsScope config)
+  source         : "@almadar/std (behaviors/registry/agent/atoms/std-agent-session.orb orbitals[1].traits[0])"
+}
+
+;; From @almadar/std (behaviors/registry/agent/atoms/std-agent-session.orb orbitals[1].traits[1])
+trait std-agent-session.traits.AgentChatList {
+  alias          : AgentSession
+  linkedEntity   : AgentChat
+  category       : interaction
+  states         : (loading* browsing)
+  events         : (INIT AgentChatsLoaded AgentChatsLoadFailed CHATS_CHANGED OPEN_CHAT NEW_CHAT_CLICKED ASSISTANT_CHAT_SELECTED ASSISTANT_NEW_CHAT)
+  transitions    : ((loading -> loading on INIT) (loading -> browsing on AgentChatsLoaded) (loading -> browsing on AgentChatsLoadFailed) (browsing -> loading on INIT) (browsing -> browsing on CHATS_CHANGED) (browsing -> browsing on AgentChatsLoaded) (browsing -> browsing on AgentChatsLoadFailed) (browsing -> browsing on OPEN_CHAT) (browsing -> browsing on NEW_CHAT_CLICKED))
+  emits          : (ASSISTANT_CHAT_SELECTED ASSISTANT_NEW_CHAT AgentChatsLoaded AgentChatsLoadFailed)
+  config {
+    newChatLabel   : string = "New conversation" @label "New conversation button" @tier "presentation"
+    untitledLabel  : string = "New conversation" @label "Name of a conversation with no messages yet" @tier "presentation"
+  }
+  override-surface : (linkedEntity name events effects listens emitsScope config)
+  source         : "@almadar/std (behaviors/registry/agent/atoms/std-agent-session.orb orbitals[1].traits[1])"
+}
+
 ;; From @almadar/std (behaviors/registry/agent/atoms/std-agent-session.orb orbitals[0].traits[1])
 trait std-agent-session.traits.AgentConversation {
   alias          : AgentSession
   linkedEntity   : AgentConversationView
   category       : interaction
   states         : (idle*)
-  events         : (INIT THREAD_LOADED ASK STEP REPLIED REPLY_FAILED SEND)
-  transitions    : ((idle -> idle on INIT) (idle -> idle on THREAD_LOADED) (idle -> idle on ASK) (idle -> idle on STEP) (idle -> idle on REPLIED) (idle -> idle on REPLY_FAILED))
-  emits          : (SEND ASK)
+  events         : (INIT THREAD_LOADED ASK STEP REPLIED NEW_CHAT_CLICKED OPEN_CHATS_CLICKED CHATS_LISTED CHAT_PICKED OPEN_MEMORY_CLICKED MEMORIES_LISTED BACK_TO_CHAT REPLY_FAILED ASSISTANT_HISTORY_REQUESTED ASSISTANT_NEW_CHAT ASSISTANT_SEND ASSISTANT_CHATS_REQUESTED ASSISTANT_CHAT_SELECTED ASSISTANT_MEMORIES_REQUESTED)
+  transitions    : ((idle -> idle on INIT) (idle -> idle on THREAD_LOADED) (idle -> idle on ASK) (idle -> idle on STEP) (idle -> idle on REPLIED) (idle -> idle on NEW_CHAT_CLICKED) (idle -> idle on OPEN_CHATS_CLICKED) (idle -> idle on CHATS_LISTED) (idle -> idle on CHAT_PICKED) (idle -> idle on OPEN_MEMORY_CLICKED) (idle -> idle on MEMORIES_LISTED) (idle -> idle on BACK_TO_CHAT) (idle -> idle on REPLY_FAILED))
+  emits          : (ASSISTANT_HISTORY_REQUESTED ASSISTANT_NEW_CHAT NEW_CHAT_CLICKED ASSISTANT_SEND ASSISTANT_CHATS_REQUESTED ASSISTANT_CHAT_SELECTED ASSISTANT_MEMORIES_REQUESTED OPEN_CHATS_CLICKED OPEN_MEMORY_CLICKED CHAT_PICKED ASK)
   config {
+    backLabel      : string = "Back" @label "Back to the conversation" @tier "presentation"
+    chatsEmptyTitle : string = "No conversations yet" @label "Empty conversation list" @tier "presentation"
+    chatsLabel     : string = "Conversations" @label "Past conversations button" @description "Shows the person's past conversations in place of the chat; picking one reopens it." @tier "presentation"
     emptyTitle     : string = "Ask me to do something in this app" @label "Empty conversation title" @tier "presentation"
-    links          : [AgentLink] = [] @label "Links above the conversation" @description "Related pages (e.g. the run history)." @tier "presentation"
+    links          : [AgentLink] = [{"href":"/agent-session/chats","label":"All conversations"}] @label "Links above the conversation" @description "Related pages (e.g. the run history)." @tier "presentation"
+    memoryEmptyTitle : string = "Nothing remembered yet" @label "Empty memory list" @tier "presentation"
+    memoryLabel    : string = "What I remember" @label "Memory button" @description "Shows what the assistant remembers for this person in place of the chat." @tier "presentation"
+    newChatLabel   : string = "New conversation" @label "New conversation button" @description "Starts a fresh conversation; earlier ones stay in the conversation list." @tier "presentation"
     placeholder    : string = "Ask the assistant…" @label "Message placeholder" @tier "presentation"
+    untitledLabel  : string = "New conversation" @label "Title of a conversation with no messages yet" @tier "presentation"
   }
   override-surface : (linkedEntity name events effects listens emitsScope config)
   source         : "@almadar/std (behaviors/registry/agent/atoms/std-agent-session.orb orbitals[0].traits[1])"
@@ -19949,9 +19976,9 @@ trait std-agent-session.traits.AgentThread {
   linkedEntity   : AgentMessage
   category       : lifecycle
   states         : (ready*)
-  events         : (INIT SEND AgentMessageSaved AgentConversationLoaded REPLIED AgentMessagesLoadFailed AgentMessageSaveFailed THREAD_FAILED CONVERSE AgentMessagesLoaded)
-  transitions    : ((ready -> ready on INIT) (ready -> ready on SEND) (ready -> ready on AgentMessageSaved) (ready -> ready on AgentConversationLoaded) (ready -> ready on REPLIED) (ready -> ready on AgentMessagesLoadFailed) (ready -> ready on AgentMessageSaveFailed))
-  emits          : (THREAD_FAILED CONVERSE AgentMessagesLoaded AgentMessagesLoadFailed AgentConversationLoaded AgentMessageSaved AgentMessageSaveFailed)
+  events         : (INIT OPEN_CHAT SEND_IN_CHAT AgentMessageSaved AgentConversationLoaded REPLY_IN_CHAT AgentMessagesLoadFailed AgentMessageSaveFailed ASSISTANT_THREAD_FAILED CONVERSE AgentMessagesLoaded)
+  transitions    : ((ready -> ready on INIT) (ready -> ready on OPEN_CHAT) (ready -> ready on OPEN_CHAT) (ready -> ready on SEND_IN_CHAT) (ready -> ready on AgentMessageSaved) (ready -> ready on AgentConversationLoaded) (ready -> ready on REPLY_IN_CHAT) (ready -> ready on AgentMessagesLoadFailed) (ready -> ready on AgentMessageSaveFailed))
+  emits          : (ASSISTANT_THREAD_FAILED CONVERSE AgentMessagesLoaded AgentMessagesLoadFailed AgentConversationLoaded AgentMessageSaved AgentMessageSaveFailed)
   override-surface : (linkedEntity name events effects listens emitsScope config)
   source         : "@almadar/std (behaviors/registry/agent/atoms/std-agent-session.orb orbitals[0].traits[0])"
 }
@@ -19987,9 +20014,9 @@ trait std-agent-tool-loop.traits.AgentToolLoop {
   linkedEntity   : AgentTurn
   category       : interaction
   states         : (idle* thinking)
-  events         : (INIT CONVERSE ANSWERED ASK_FAILED STEP REPLIED REPLY_FAILED)
+  events         : (INIT CONVERSE ANSWERED ASK_FAILED ASSISTANT_STEP ASSISTANT_REPLIED ASSISTANT_REPLY_FAILED)
   transitions    : ((idle -> idle on INIT) (idle -> thinking on CONVERSE) (thinking -> idle on ANSWERED) (thinking -> idle on ASK_FAILED))
-  emits          : (STEP REPLIED REPLY_FAILED ANSWERED ASK_FAILED)
+  emits          : (ASSISTANT_STEP ASSISTANT_REPLIED ASSISTANT_REPLY_FAILED ANSWERED ASK_FAILED)
   config {
     instructions   : string = "You operate this app for the signed-in user. Use the tools to act and to look things up; when a tool reports that something was refused or denied, say so plainly." @label "How should the assistant behave?" @description "Standing instructions sent with every conversation." @synonyms "system prompt, persona, guidance" @tier "domain"
     maxSteps       : number = 8 @label "Model round-trips per request" @description "How many model calls one request may take before it fails." @tier "policy"
@@ -20238,6 +20265,7 @@ trait std-billable-hour.traits.BillableHourTimesheet {
     columns        : [ColumnSpec] = [{"align":"left","field":"workerName","header":"Worker","key":"workerName","width":"minmax(8rem, 1fr)"},{"align":"left","field":"matterId","header":"Matter","key":"matterId","width":"8rem"},{"align":"left","field":"workDate","format":"date","header":"Date","key":"workDate","width":"8rem"},{"align":"right","field":"hours","format":"number","header":"Hours","key":"hours","width":"6rem"},{"align":"right","field":"rate","format":"currency","header":"Rate","key":"rate","width":"7rem"},{"align":"center","field":"invoiceStatus","format":"badge","header":"Status","key":"invoiceStatus","width":"8rem"}] @label "Table columns" @description "ColumnSpec list for the dense hours ledger table." @tier "presentation"
     invoiceRoles   : [string] = [] @label "Roles that can invoice" @description "Roles (matched against viewerRole) that see the Invoice button. Empty = everyone." @tier "policy"
     itemActions    : [ItemAction] = [{"event":"OPEN_HOURS","icon":"arrow-right","label":"Open","variant":"ghost"},{"event":"WRITE_OFF_HOURS","label":"Write Off","variant":"danger"}] @label "Row actions" @description "Per-row actions rendered by the hours table." @tier "presentation"
+    showHeader     : boolean = true @label "Show the list's own title row?" @description "Off when the page already carries a page header naming the same thing, so the page shows one title." @tier "presentation"
     statLook       : string = "elevated" @label "Stat display look" @description "Layer 2 visual treatment for stat / KPI cards." @tier "presentation" @values (elevated flat progress-backed gauge sparkline)
     tableLook      : string = "dense" @label "Table look" @description "Layer 2 visual treatment for the data table rendered by this atom." @tier "presentation" @values (dense spacious striped borderless bordered)
     title          : string = "Time Entries" @label "Section title" @description "Heading shown above the time-entries list" @tier "presentation"
@@ -20258,8 +20286,9 @@ trait std-board.traits.BoardItemBoard {
   transitions    : ((loading -> loading on INIT) (loading -> viewing_board on BoardItemsLoaded) (loading -> error on BoardItemsLoadFailed) (loading -> loading on BoardItemsSaved) (loading -> loading on BoardItemDeleted) (loading -> error on BoardItemsSaveFailed) (viewing_board -> loading on INIT) (viewing_board -> viewing_card on OPEN_CARD) (viewing_board -> adding on ADD_CARD) (viewing_board -> viewing_board on MOVE_CARD) (viewing_board -> viewing_board on REORDER_CARD) (viewing_board -> viewing_board on REORDER_POSITION) (viewing_board -> viewing_board on BoardItemsSaved) (viewing_board -> viewing_board on REFETCH_QUERY) (viewing_board -> viewing_board on REFETCH_FILTER) (viewing_board -> viewing_board on REFETCH_PAGE) (viewing_board -> viewing_board on BoardItemsLoaded) (viewing_board -> viewing_board on BoardItemsSaveFailed) (viewing_board -> viewing_board on BoardItemsLoadFailed) (viewing_card -> loading on CLOSE_CARD) (viewing_card -> loading on MOVE_CARD) (viewing_card -> loading on DELETE_CARD) (adding -> loading on SAVE_CARD) (adding -> viewing_board on CANCEL_ADD) (error -> loading on INIT))
   emits          : (OPEN_CARD CLOSE_CARD ADD_CARD CANCEL_ADD SAVE_CARD MOVE_CARD REORDER_CARD DELETE_CARD EDIT_CARD BoardItemsLoaded BoardItemsLoadFailed BoardItemsSaved BoardItemDeleted BoardItemsSaveFailed)
   config {
+    addPlacement   : string = "floating" @label "Add button placement" @description "Where the add-item button sits: 'floating' (default) pins a floating action button to the screen corner; 'inline' renders an ordinary Add button above the columns, for a board embedded in a card or panel." @synonyms "add button position, floating add, inline add, add item button placement. user phrases: 'put the add button inside the board' / 'no floating button' -> inline" @tier "presentation" @values (floating inline)
     boardLook      : string = "columns" @label "Board look" @description "Layer 3 body layout: default N-column data-grid ('columns'), or a Trello-style wide-column kanban with sticky column headers ('kanban-classic')." @tier "presentation" @values (columns kanban-classic)
-    bodyContent    : render-ui = {"children":[["if","@config.showHeader",{"children":[{"align":"center","children":[{"name":"kanban-square","size":"lg","type":"icon"},{"content":"@config.title","type":"typography","variant":"h3"}],"direction":"horizontal","gap":"sm","type":"stack"},{"type":"divider"}],"direction":"vertical","gap":"md","type":"stack"},{"children":[],"gap":"none","type":"stack"}],["if","@config.bodySearch",{"children":[{"className":"w-full max-w-md","clearable":true,"event":"REFETCH_QUERY","placeholder":"@config.searchPlaceholder","type":"search-input"}],"direction":"horizontal","gap":"sm","type":"stack"},{"children":[],"gap":"none","type":"stack"}],["if",[">",["array/len","@config.filters"],0],{"children":[{"entity":"BoardView","event":"REFETCH_FILTER","filters":"@config.filters","look":"@config.filterBarLook","type":"filter-group"}],"direction":"horizontal","gap":"sm","type":"stack"},{"children":[],"gap":"none","type":"stack"}],{"cols":"@config.gridCols","dndRoot":true,"entity":"@entity.boards","fields":[],"gap":"md","renderItem":["fn","col",{"children":[{"children":[{"align":"center","children":[{"name":"@col.icon","type":"icon"},{"content":"@col.label","type":"typography","variant":"h4"},{"label":"@col.count","type":"badge","variant":"@col.variant"}],"direction":"horizontal","gap":"xs","type":"stack"},{"accepts":"*","dragGroup":"@col.key","dropEvent":"MOVE_CARD","entity":"@col.items","fields":[],"gap":"sm","positionEvent":"REORDER_POSITION","renderItem":["fn","item",{"children":[{"children":[{"content":"@config.cardTitleBinding","type":"typography","variant":"h4"},{"color":"muted","content":"@config.cardDescriptionBinding","type":"typography","variant":"caption"},{"align":"center","children":[{"action":"OPEN_CARD","actionPayload":{"description":"@config.cardDescriptionBinding","id":"@config.cardIdBinding","notes":"@config.cardNotesBinding","row":"@item","stage":"@config.cardStageBinding","title":"@config.cardTitleBinding"},"icon":"arrow-right","label":"Open","type":"button","variant":"ghost"}],"direction":"horizontal","gap":"xs","type":"stack"}],"direction":"vertical","gap":"xs","type":"stack"}],"look":"@config.cardLook","type":"card"}],"reorderEvent":"REORDER_CARD","sortable":true,"type":"data-list"}],"direction":"vertical","gap":"sm","type":"stack"}],"look":"@config.cardLook","type":"card"}],"type":"data-grid"},{"action":"ADD_CARD","icon":"plus","label":"Add item","type":"floating-action-button","variant":"primary"}],"direction":"vertical","gap":"md","type":"stack"} @label "Body content tree" @description "Render-ui SExpr rendered after the board loads for boardLook='columns' — the canonical column data-grid with nested per-column data-lists. boardLook='kanban-classic' renders kanbanClassicBodyContent instead; both share this trait's state machine, emits, and listens." @tier "internal"
+    bodyContent    : render-ui = {"children":[["if",["=","@config.addPlacement","inline"],{"children":[{"action":"ADD_CARD","icon":"plus","label":"Add item","size":"sm","type":"button","variant":"secondary"}],"direction":"horizontal","gap":"sm","justify":"end","type":"stack"},{"children":[],"gap":"none","type":"stack"}],["if","@config.showHeader",{"children":[{"align":"center","children":[{"name":"kanban-square","size":"lg","type":"icon"},{"content":"@config.title","type":"typography","variant":"h3"}],"direction":"horizontal","gap":"sm","type":"stack"},{"type":"divider"}],"direction":"vertical","gap":"md","type":"stack"},{"children":[],"gap":"none","type":"stack"}],["if","@config.bodySearch",{"children":[{"className":"w-full max-w-md","clearable":true,"event":"REFETCH_QUERY","placeholder":"@config.searchPlaceholder","type":"search-input"}],"direction":"horizontal","gap":"sm","type":"stack"},{"children":[],"gap":"none","type":"stack"}],["if",[">",["array/len","@config.filters"],0],{"children":[{"entity":"BoardView","event":"REFETCH_FILTER","filters":"@config.filters","look":"@config.filterBarLook","type":"filter-group"}],"direction":"horizontal","gap":"sm","type":"stack"},{"children":[],"gap":"none","type":"stack"}],{"cols":"@config.gridCols","dndRoot":true,"entity":"@entity.boards","fields":[],"gap":"md","renderItem":["fn","col",{"children":[{"children":[{"align":"center","children":[{"name":"@col.icon","type":"icon"},{"content":"@col.label","type":"typography","variant":"h4"},{"label":"@col.count","type":"badge","variant":"@col.variant"}],"direction":"horizontal","gap":"xs","type":"stack"},{"accepts":"*","dragGroup":"@col.key","dropEvent":"MOVE_CARD","entity":"@col.items","fields":[],"gap":"sm","positionEvent":"REORDER_POSITION","renderItem":["fn","item",{"children":[{"children":[{"content":"@config.cardTitleBinding","type":"typography","variant":"h4"},{"color":"muted","content":"@config.cardDescriptionBinding","type":"typography","variant":"caption"},{"align":"center","children":[{"action":"OPEN_CARD","actionPayload":{"description":"@config.cardDescriptionBinding","id":"@config.cardIdBinding","notes":"@config.cardNotesBinding","row":"@item","stage":"@config.cardStageBinding","title":"@config.cardTitleBinding"},"icon":"arrow-right","label":"Open","type":"button","variant":"ghost"}],"direction":"horizontal","gap":"xs","type":"stack"}],"direction":"vertical","gap":"xs","type":"stack"}],"look":"@config.cardLook","type":"card"}],"reorderEvent":"REORDER_CARD","sortable":true,"type":"data-list"}],"direction":"vertical","gap":"sm","type":"stack"}],"look":"@config.cardLook","type":"card"}],"type":"data-grid"},["if",["=","@config.addPlacement","floating"],{"action":"ADD_CARD","icon":"plus","label":"Add item","type":"floating-action-button","variant":"primary"},{"children":[],"gap":"none","type":"stack"}]],"direction":"vertical","gap":"md","type":"stack"} @label "Body content tree" @description "Render-ui SExpr rendered after the board loads for boardLook='columns' — the canonical column data-grid with nested per-column data-lists. boardLook='kanban-classic' renders kanbanClassicBodyContent instead; both share this trait's state machine, emits, and listens." @tier "internal"
     bodySearch     : boolean = false @label "Show the board's own search box?" @description "Renders an inline search box above the columns. Defaults false: unlike std-browse, std-board has never had a search box, so defaulting this true would silently add one to every existing consumer. The wired path — composing std-search beside the board and routing its FILTER/SEARCH event to REFETCH_QUERY — works regardless of this knob; set true only for a standalone board with no page-level search affordance." @synonyms "inline search, board search, built-in search, show search, duplicate search" @tier "presentation"
     cardActions    : [ItemAction] = [{"event":"DELETE_CARD","icon":"trash-2","label":"Delete","variant":"danger"}] @label "Card panel action list" @description "Buttons on the open-card panel's actions row, built by the default cardActionsContent. Give an item `roles` to show it only to those viewer roles." @tier "presentation"
     cardActionsContent : render-ui = {"align":"center","children":["array/map",["array/filter","@config.cardActions",["fn","action",["or",["=",["array/len",["object/get","@action","roles",[]]],0],["array/includes",["object/get","@action","roles",[]],"@config.viewerRole"]]]],["fn","a",{"action":"@a.event","actionPayload":{"id":"@entity.currentId"},"icon":"@a.icon","label":"@a.label","type":"button","variant":"@a.variant"}]],"direction":"horizontal","gap":"sm","type":"stack"} @label "Card panel actions" @description "Actions row of the open-card panel. Default is the Delete button only. Override to add consumer-wired actions — e.g. an Edit button with action: EDIT_CARD and actionPayload: { id: @entity.currentId, row: @entity.currentRow }, listened to by the organism's edit modal. Never leave a button here without a listener." @tier "presentation"
@@ -20276,7 +20305,7 @@ trait std-board.traits.BoardItemBoard {
     gridCols       : number = 3 @label "Grid columns" @description "Outer grid column count before the board wraps" @tier "presentation"
     groupByField   : string = "stage" @label "Group-by field" @description "Entity field whose value matches a column key — items are filtered into columns by it. Default 'stage'; set to 'status' (or any field) for entities that track state under a different name." @tier "presentation"
     include        : [string] = [] @label "Which relation fields to hydrate?" @description "Entity relation field names to hydrate on fetch (e.g. an `assignee : TeamMember` field named `assignee`), so card bindings can use dot-paths like @item.assignee.name. Empty = no hydration, the default." @synonyms "relation hydration, populate relations, joined fields, hydrate relations" @tier "domain"
-    kanbanClassicBodyContent : render-ui = {"children":[["if","@config.showHeader",{"children":[{"align":"center","children":[{"name":"kanban-square","size":"xl","type":"icon"},{"content":"@config.title","type":"typography","variant":"h2"}],"className":"px-card-md","direction":"horizontal","gap":"sm","type":"stack"},{"type":"divider"}],"direction":"vertical","gap":"md","type":"stack"},{"children":[],"gap":"none","type":"stack"}],["if","@config.bodySearch",{"children":[{"className":"w-full max-w-md","clearable":true,"event":"REFETCH_QUERY","placeholder":"@config.searchPlaceholder","type":"search-input"}],"className":"px-card-md","direction":"horizontal","gap":"sm","type":"stack"},{"children":[],"gap":"none","type":"stack"}],["if",[">",["array/len","@config.filters"],0],{"children":[{"entity":"BoardView","event":"REFETCH_FILTER","filters":"@config.filters","look":"@config.filterBarLook","type":"filter-group"}],"className":"px-card-md","direction":"horizontal","gap":"sm","type":"stack"},{"children":[],"gap":"none","type":"stack"}],{"className":"w-full pb-2","dndRoot":true,"entity":"@entity.boards","fields":[],"gap":"lg","minCardWidth":300,"renderItem":["fn","col",{"children":[{"children":[{"align":"center","children":[{"name":"@col.icon","type":"icon"},{"className":"flex-1","content":"@col.label","type":"typography","variant":"h4"},{"label":"@col.count","size":"sm","type":"badge","variant":"primary"}],"className":"p-card-md border-b border-[var(--color-border)] sticky top-0 bg-[var(--color-surface)]","direction":"horizontal","gap":"sm","type":"stack"},{"accepts":"*","className":"p-card-md min-h-[120px]","dragGroup":"@col.key","dropEvent":"MOVE_CARD","entity":"@col.items","fields":[],"gap":"sm","positionEvent":"REORDER_POSITION","renderItem":["fn","item",{"children":[{"children":[{"content":"@config.cardTitleBinding","type":"typography","variant":"body","weight":"medium"},{"className":"line-clamp-2","color":"muted","content":"@config.cardDescriptionBinding","type":"typography","variant":"caption"},{"align":"center","children":[{"label":"@config.cardStageBinding","size":"sm","type":"badge","variant":"@col.variant"},{"action":"OPEN_CARD","actionPayload":{"description":"@config.cardDescriptionBinding","id":"@config.cardIdBinding","notes":"@config.cardNotesBinding","row":"@item","stage":"@config.cardStageBinding","title":"@config.cardTitleBinding"},"className":"ml-auto","icon":"arrow-right","label":"Open","size":"sm","type":"button","variant":"ghost"}],"className":"pt-1","direction":"horizontal","gap":"xs","type":"stack"}],"direction":"vertical","gap":"xs","type":"stack"}],"className":"cursor-grab hover:shadow-lg transition-shadow","look":"@config.cardLook","padding":"sm","type":"card"}],"reorderEvent":"REORDER_CARD","sortable":true,"type":"data-list"}],"direction":"vertical","gap":"none","type":"stack"}],"className":"w-[300px] bg-[var(--color-surface-subtle)] rounded-lg overflow-hidden","look":"elevated","padding":"none","type":"card"}],"scrollX":true,"type":"data-grid"},{"action":"ADD_CARD","icon":"plus","label":"Add card","type":"floating-action-button","variant":"primary"}],"className":"h-full","direction":"vertical","gap":"md","type":"stack"} @label "Kanban classic body content tree" @description "Render-ui SExpr for boardLook='kanban-classic' — Trello-style wide elevated columns with sticky headers, dense cards with a status badge; per-item cards honor config.cardLook (the column wrapper stays elevated — it is column chrome, not a card)." @tier "internal"
+    kanbanClassicBodyContent : render-ui = {"children":[["if",["=","@config.addPlacement","inline"],{"children":[{"action":"ADD_CARD","icon":"plus","label":"Add card","size":"sm","type":"button","variant":"secondary"}],"direction":"horizontal","gap":"sm","justify":"end","type":"stack"},{"children":[],"gap":"none","type":"stack"}],["if","@config.showHeader",{"children":[{"align":"center","children":[{"name":"kanban-square","size":"xl","type":"icon"},{"content":"@config.title","type":"typography","variant":"h2"}],"className":"px-card-md","direction":"horizontal","gap":"sm","type":"stack"},{"type":"divider"}],"direction":"vertical","gap":"md","type":"stack"},{"children":[],"gap":"none","type":"stack"}],["if","@config.bodySearch",{"children":[{"className":"w-full max-w-md","clearable":true,"event":"REFETCH_QUERY","placeholder":"@config.searchPlaceholder","type":"search-input"}],"className":"px-card-md","direction":"horizontal","gap":"sm","type":"stack"},{"children":[],"gap":"none","type":"stack"}],["if",[">",["array/len","@config.filters"],0],{"children":[{"entity":"BoardView","event":"REFETCH_FILTER","filters":"@config.filters","look":"@config.filterBarLook","type":"filter-group"}],"className":"px-card-md","direction":"horizontal","gap":"sm","type":"stack"},{"children":[],"gap":"none","type":"stack"}],{"className":"w-full pb-2","dndRoot":true,"entity":"@entity.boards","fields":[],"gap":"lg","minCardWidth":300,"renderItem":["fn","col",{"children":[{"children":[{"align":"center","children":[{"name":"@col.icon","type":"icon"},{"className":"flex-1","content":"@col.label","type":"typography","variant":"h4"},{"label":"@col.count","size":"sm","type":"badge","variant":"primary"}],"className":"p-card-md border-b border-[var(--color-border)] sticky top-0 bg-[var(--color-surface)]","direction":"horizontal","gap":"sm","type":"stack"},{"accepts":"*","className":"p-card-md min-h-[120px]","dragGroup":"@col.key","dropEvent":"MOVE_CARD","entity":"@col.items","fields":[],"gap":"sm","positionEvent":"REORDER_POSITION","renderItem":["fn","item",{"children":[{"children":[{"content":"@config.cardTitleBinding","type":"typography","variant":"body","weight":"medium"},{"className":"line-clamp-2","color":"muted","content":"@config.cardDescriptionBinding","type":"typography","variant":"caption"},{"align":"center","children":[{"label":"@config.cardStageBinding","size":"sm","type":"badge","variant":"@col.variant"},{"action":"OPEN_CARD","actionPayload":{"description":"@config.cardDescriptionBinding","id":"@config.cardIdBinding","notes":"@config.cardNotesBinding","row":"@item","stage":"@config.cardStageBinding","title":"@config.cardTitleBinding"},"className":"ml-auto","icon":"arrow-right","label":"Open","size":"sm","type":"button","variant":"ghost"}],"className":"pt-1","direction":"horizontal","gap":"xs","type":"stack"}],"direction":"vertical","gap":"xs","type":"stack"}],"className":"cursor-grab hover:shadow-lg transition-shadow","look":"@config.cardLook","padding":"sm","type":"card"}],"reorderEvent":"REORDER_CARD","sortable":true,"type":"data-list"}],"direction":"vertical","gap":"none","type":"stack"}],"className":"w-[300px] bg-[var(--color-surface-subtle)] rounded-lg overflow-hidden","look":"elevated","padding":"none","type":"card"}],"scrollX":true,"type":"data-grid"},["if",["=","@config.addPlacement","floating"],{"action":"ADD_CARD","icon":"plus","label":"Add card","type":"floating-action-button","variant":"primary"},{"children":[],"gap":"none","type":"stack"}]],"className":"h-full","direction":"vertical","gap":"md","type":"stack"} @label "Kanban classic body content tree" @description "Render-ui SExpr for boardLook='kanban-classic' — Trello-style wide elevated columns with sticky headers, dense cards with a status badge; per-item cards honor config.cardLook (the column wrapper stays elevated — it is column chrome, not a card)." @tier "internal"
     pageSize       : number = 10 @label "Fetch page size" @description "Records fetched per REFETCH_PAGE request. std-board renders no pagination control itself — this only feeds the fetch limit/offset when a consumer wires a composed std-pagination to REFETCH_PAGE." @synonyms "fetch limit, records per page, batch size, page limit" @tier "presentation"
     searchField    : string = "title" @label "Which column does the search box match against?" @description "Name the field on this entity the search box's str/includes filter matches against. Declared, never inferred: an entity with no `title` column must set this to a real field (e.g. name, summary) or the search box can never match a card." @synonyms "search column, search on field, match field, search key" @tier "policy"
     searchPlaceholder : string = "Search…" @label "Search box placeholder text" @description "Hint text inside the board's embedded search box (e.g. 'Search cards…'). Only shown when bodySearch is true." @synonyms "search hint, placeholder, search box text, search label" @tier "presentation"
@@ -20326,16 +20355,12 @@ trait std-browse.traits.BrowseItemBrowse {
   transitions    : ((loading -> loading on INIT) (loading -> browsing on BrowseItemLoaded) (loading -> error on BrowseItemLoadFailed) (browsing -> loading on INIT) (browsing -> browsing on REFETCH_QUERY) (browsing -> browsing on REFETCH_FILTER) (browsing -> browsing on REFETCH_PAGE) (browsing -> browsing on VIEW) (browsing -> browsing on CLOSE) (browsing -> browsing on BrowseItemLoaded) (browsing -> browsing on BrowseItemLoadFailed) (error -> loading on INIT))
   emits          : (BrowseItemLoaded BrowseItemLoadFailed VIEW EDIT DELETE)
   config {
-    avatarBinding  : string = "@item.name" @label "Avatar name binding" @description "Binding path whose value names the leading avatar when feedLeading = avatar (e.g. @item.authorName) — the person, not the post title." @tier "internal"
-    badgeBinding   : string = "@item.status" @label "Badge field binding" @description "Binding path for the status/badge slot." @tier "internal"
-    bodyContent    : render-ui = {"children":[["if","@config.bodySearch",{"children":[{"className":"w-full max-w-md","clearable":true,"event":"REFETCH_QUERY","placeholder":"@config.searchPlaceholder","type":"search-input"}],"direction":"horizontal","gap":"sm","type":"stack"},{"children":[],"gap":"none","type":"stack"}],["if",[">",["array/len","@config.filters"],0],{"children":[{"entity":"BrowseItem","event":"REFETCH_FILTER","filters":"@config.filters","look":"@config.filterBarLook","type":"filter-group"}],"direction":"horizontal","gap":"sm","type":"stack"},{"children":[],"gap":"none","type":"stack"}],{"cols":"@config.cols","emptyDescription":"@config.emptyDescription","emptyIcon":"@config.emptyIcon","emptyTitle":"@config.emptyTitle","entity":"@payload.data","fields":"@config.fields","gap":"@config.gap","imageField":"@config.imageField","itemActions":["array/filter","@config.itemActions",["fn","item",["or",["=",["array/len",["object/get","@item","roles",[]]],0],["array/includes",["object/get","@item","roles",[]],"@config.viewerRole"]]]],"itemClickEvent":"@config.itemClickEvent","maxInlineActions":"@config.maxInlineActions","pageSize":"@config.displayPageSize","type":"data-grid"}],"direction":"vertical","gap":"md","type":"stack"} @label "Body content tree" @description "Render-ui SExpr rendered after rows load when browseLook = table (the default). Toolbar (search when bodySearch, filter bar when filters is non-empty) above the canonical data-grid call. Until 2026-08-27 this was the only one of the six looks with no search affordance at all. See denseBodyContent/feedBodyContent/galleryBodyContent for the other browseLook bodies; any may be overridden directly while inheriting the same trait, state machine, emits, and listens. Inlined directly (not via a composed sibling trait) 2026-09-08 — a separately-listening DataGrid1 sibling fired unconditionally on every BrowseItemLoaded regardless of browseLook, racing the correct body for slot main (a listens guard can't gate this: both the Rust interpreter and the TS codegen path restrict a listens guard's context to @payload only, so a browseLook config check there always evaluates undefined)."
+    bodyContent    : render-ui = {"children":[["if","@config.bodySearch",{"children":[{"className":"w-full max-w-md","clearable":true,"event":"REFETCH_QUERY","placeholder":"@config.searchPlaceholder","type":"search-input"}],"direction":"horizontal","gap":"sm","type":"stack"},{"children":[],"gap":"none","type":"stack"}],["if",[">",["array/len","@config.filters"],0],{"children":[{"entity":"BrowseItem","event":"REFETCH_FILTER","filters":"@config.filters","look":"@config.filterBarLook","type":"filter-group"}],"direction":"horizontal","gap":"sm","type":"stack"},{"children":[],"gap":"none","type":"stack"}],{"cols":"@config.cols","emptyDescription":"@config.emptyDescription","emptyIcon":"@config.emptyIcon","emptyTitle":"@config.emptyTitle","entity":"@payload.data","fields":"@config.fields","gap":"@config.gap","imageField":"@config.imageField","itemActions":["array/filter","@config.itemActions",["fn","item",["or",["=",["array/len",["object/get","@item","roles",[]]],0],["array/includes",["object/get","@item","roles",[]],"@config.viewerRole"]]]],"itemClickEvent":"@config.itemClickEvent","maxInlineActions":"@config.maxInlineActions","pageSize":"@config.displayPageSize","surface":"@config.surface","type":"data-grid"}],"direction":"vertical","gap":"md","type":"stack"} @label "Body content tree" @description "Render-ui SExpr rendered after rows load when browseLook = table (the default). Toolbar (search when bodySearch, filter bar when filters is non-empty) above the canonical data-grid call. Until 2026-08-27 this was the only one of the six looks with no search affordance at all. See denseBodyContent/feedBodyContent/galleryBodyContent for the other browseLook bodies; any may be overridden directly while inheriting the same trait, state machine, emits, and listens. Inlined directly (not via a composed sibling trait) 2026-09-08 — a separately-listening DataGrid1 sibling fired unconditionally on every BrowseItemLoaded regardless of browseLook, racing the correct body for slot main (a listens guard can't gate this: both the Rust interpreter and the TS codegen path restrict a listens guard's context to @payload only, so a browseLook config check there always evaluates undefined)."
     bodySearch     : boolean = true @label "Show the list's own search box?" @description "The dense/feed/gallery looks embed their own search box above the rows. Set false when the page already provides a search affordance (a toolbar Search molecule), so the surface shows one search box instead of two." @synonyms "inline search, list search, built-in search, show search, duplicate search" @tier "presentation"
     browseLook     : string = "table" @label "Browse look" @description "Layer 2 visual treatment for the whole browse surface. table = the default data-grid (bodyContent); dense = spreadsheet-style table with toolbar search (denseBodyContent); feed = chronological card stream (feedBodyContent); gallery = image-first responsive card grid (galleryBodyContent); master-detail = record-work split view — dense list left, clicked record's detail right (masterDetailBodyContent); triage = inbox-register compact rows for queue work (triageBodyContent). Selecting a non-table look swaps which body tree renders after rows load; any body may still be overridden directly at the call site for a one-off layout." @tier "presentation" @values (table dense feed gallery master-detail triage)
-    categoryBinding : string = "@item.category" @label "Category field binding" @description "Binding path for the category/tag slot." @tier "internal"
     cols           : number = 1 @label "How many columns in the grid?" @description "Number of columns in the responsive card/grid layout." @synonyms "columns, grid width, card columns, num columns" @tier "presentation"
     columns        : [ColumnSpec] = [{"align":"left","field":"name","header":"Name","key":"name","weight":"medium"},{"align":"left","field":"description","header":"Detail","key":"description"},{"align":"center","field":"status","format":"badge","header":"Status","key":"status"}] @label "Table columns" @description "Column definitions for table-style variants (dense). Each maps an entity field to a column with optional width / align / weight / format." @tier "presentation"
-    denseBodyContent : render-ui = {"children":[["if","@config.bodySearch",{"children":[{"className":"w-full max-w-md","clearable":true,"event":"REFETCH_QUERY","placeholder":"@config.searchPlaceholder","type":"search-input"}],"className":"px-card-md py-card-sm border-b border-[var(--color-border)]","direction":"horizontal","gap":"sm","type":"stack"},{"children":[],"gap":"none","type":"stack"}],["if",[">",["array/len","@config.filters"],0],{"children":[{"entity":"BrowseItem","event":"REFETCH_FILTER","filters":"@config.filters","look":"@config.filterBarLook","type":"filter-group"}],"className":"px-card-md py-card-sm border-b border-[var(--color-border)]","direction":"horizontal","gap":"sm","type":"stack"},{"children":[],"gap":"none","type":"stack"}],{"children":[{"columns":"@config.columns","emptyDescription":"@config.emptyDescription","emptyIcon":"@config.emptyIcon","emptyTitle":"@config.emptyTitle","entity":"@payload.data","itemActions":["array/filter","@config.itemActions",["fn","item",["or",["=",["array/len",["object/get","@item","roles",[]]],0],["array/includes",["object/get","@item","roles",[]],"@config.viewerRole"]]]],"itemClickEvent":"@config.itemClickEvent","look":"dense","maxInlineActions":"@config.maxInlineActions","pageSize":"@config.displayPageSize","selectable":"@config.selectable","type":"table-view"}],"className":"overflow-x-auto","direction":"vertical","gap":"none","type":"stack"}],"className":"rounded-lg border border-[var(--color-border)] bg-[var(--color-card)] shadow-sm overflow-hidden","direction":"vertical","gap":"none","type":"stack"} @label "Dense look body" @description "Render-ui SExpr rendered after rows load when browseLook = dense. Spreadsheet-style sticky-header data-table with a search bar; composes columns/itemActions/maxInlineActions/displayPageSize/searchPlaceholder. Folded from std-browse-dense (Phase 5.B). Inlined directly (not via a composed sibling trait) 2026-09-08 — see the table-default body's note for why." @tier "internal"
-    descriptionBinding : string = "@item.description" @label "Description field binding" @description "Binding path for the card body/subtitle slot." @tier "internal"
+    denseBodyContent : render-ui = {"children":[["if","@config.bodySearch",{"children":[{"className":"w-full max-w-md","clearable":true,"event":"REFETCH_QUERY","placeholder":"@config.searchPlaceholder","type":"search-input"}],"className":"px-card-md py-card-sm border-b border-[var(--color-border)]","direction":"horizontal","gap":"sm","type":"stack"},{"children":[],"gap":"none","type":"stack"}],["if",[">",["array/len","@config.filters"],0],{"children":[{"entity":"BrowseItem","event":"REFETCH_FILTER","filters":"@config.filters","look":"@config.filterBarLook","type":"filter-group"}],"className":"px-card-md py-card-sm border-b border-[var(--color-border)]","direction":"horizontal","gap":"sm","type":"stack"},{"children":[],"gap":"none","type":"stack"}],{"children":[{"columns":"@config.columns","emptyDescription":"@config.emptyDescription","emptyIcon":"@config.emptyIcon","emptyTitle":"@config.emptyTitle","entity":"@payload.data","itemActions":["array/filter","@config.itemActions",["fn","item",["or",["=",["array/len",["object/get","@item","roles",[]]],0],["array/includes",["object/get","@item","roles",[]],"@config.viewerRole"]]]],"itemClickEvent":"@config.itemClickEvent","look":"dense","maxInlineActions":"@config.maxInlineActions","pageSize":"@config.displayPageSize","selectable":"@config.selectable","surface":"none","type":"table-view"}],"className":"overflow-x-auto","direction":"vertical","gap":"none","type":"stack"}],"className":["if",["=","@config.surface","auto"],"surface-content overflow-hidden",""],"direction":"vertical","gap":"none","type":"stack"} @label "Dense look body" @description "Render-ui SExpr rendered after rows load when browseLook = dense. Spreadsheet-style sticky-header data-table with a search bar; composes columns/itemActions/maxInlineActions/displayPageSize/searchPlaceholder. Folded from std-browse-dense (Phase 5.B). Inlined directly (not via a composed sibling trait) 2026-09-08 — see the table-default body's note for why." @tier "internal"
     detailActions  : [BrowseDetailAction] = [{"event":"CLOSE","label":"Close"}] @label "Master-detail record pane actions" @description "Action buttons on the master-detail record pane (detail-panel `actions` descriptors: label/event/icon/variant). Consumers add their own record actions (Edit/Delete/…) alongside or instead of Close." @synonyms "record actions, detail actions, pane actions" @tier "presentation"
     detailCloseEvent : event = "CLOSE" @label "Which pane action closes the record?" @description "The detailActions entry whose event matches renders as the pane's close (×) button." @synonyms "close event, dismiss event, pane close" @tier "presentation"
     detailFields   : [FieldSpec] = [{"label":"Name","name":"name","variant":"h4"},{"label":"Description","name":"description","variant":"body"},{"label":"Status","name":"status","variant":"badge"},{"format":"date","label":"Created","name":"createdAt"}] @label "Which fields appear in the master-detail record pane?" @description "Fields shown in the detail panel when browseLook = master-detail; the field declared variant h3/h4 is the pane title. Consumers overriding columns/fields should override this list to match their entity." @synonyms "detail columns, record fields, detail pane fields" @tier "presentation"
@@ -20343,17 +20368,12 @@ trait std-browse.traits.BrowseItemBrowse {
     emptyDescription : string = "" @label "Empty-state description" @description "What will appear here once rows exist." @synonyms "empty text, no data message, empty hint" @tier "presentation"
     emptyIcon      : icon = "inbox" @label "Empty-state icon" @description "Domain icon shown when there are no rows." @synonyms "empty icon, no data icon" @tier "presentation"
     emptyTitle     : string = "" @label "Empty-state title" @description "Specific title shown when there are no rows (\"No orders yet\"). Left blank, a generic line shows." @synonyms "empty title, no data title, empty heading" @tier "presentation"
-    feedBodyContent : render-ui = {"children":[["if","@config.bodySearch",{"align":"center","children":[{"className":"w-full","clearable":true,"event":"REFETCH_QUERY","placeholder":"@config.searchPlaceholder","type":"search-input"}],"className":"w-full","direction":"horizontal","gap":"sm","type":"stack"},{"children":[],"gap":"none","type":"stack"}],["if",[">",["array/len","@config.filters"],0],{"children":[{"entity":"BrowseItem","event":"REFETCH_FILTER","filters":"@config.filters","look":"@config.filterBarLook","type":"filter-group"}],"className":"w-full","direction":"horizontal","gap":"sm","type":"stack"},{"children":[],"gap":"none","type":"stack"}],{"emptyDescription":"@config.emptyDescription","emptyIcon":"@config.emptyIcon","emptyTitle":"@config.emptyTitle","entity":"@payload.data","fields":[],"gap":["if",["=","@config.feedSurface","cards"],"md","none"],"itemActions":["array/filter","@config.itemActions",["fn","item",["or",["=",["array/len",["object/get","@item","roles",[]]],0],["array/includes",["object/get","@item","roles",[]],"@config.viewerRole"]]]],"itemClickEvent":"@config.itemClickEvent","renderItem":["fn","item",{"align":"start","children":[["if",["=","@config.feedLeading","avatar"],{"className":"flex-shrink-0","name":"@config.avatarBinding","size":"md","type":"avatar"},["if",["=","@config.feedLeading","icon"],{"align":"center","children":[{"color":"primary","name":"@config.feedIcon","size":"md","type":"icon"}],"className":"flex-shrink-0 w-10 h-10 rounded-container bg-primary/10","direction":"horizontal","gap":"none","justify":"center","type":"stack"},{"children":[],"className":"hidden","gap":"none","type":"stack"}]],{"children":[["if",["=","@config.feedCategoryLook","eyebrow"],{"color":"primary","content":"@config.categoryBinding","type":"typography","variant":"overline"},{"children":[],"className":"hidden","gap":"none","type":"stack"}],{"align":"center","children":[{"className":"min-w-0","content":"@config.titleBinding","type":"typography","variant":"@config.feedTitleVariant","weight":"semibold"},["if",["=","@config.feedCategoryLook","badge"],{"label":"@config.categoryBinding","size":"sm","type":"badge","variant":"neutral"},{"children":[],"className":"hidden","gap":"none","type":"stack"}]],"className":"flex-wrap","direction":"horizontal","gap":"sm","type":"stack"},{"className":"text-[var(--color-muted-foreground)] whitespace-pre-wrap break-words leading-relaxed","content":"@config.descriptionBinding","type":"typography","variant":"body"},{"align":"center","children":[{"color":"muted","content":"@config.metaBinding","format":"@config.metaFormat","type":"typography","variant":"caption"},["if","@config.feedShowBadge",{"label":"@config.badgeBinding","size":"sm","type":"badge","variant":"default"},{"children":[],"className":"hidden","gap":"none","type":"stack"}]],"className":"pt-1","direction":"horizontal","gap":"sm","justify":"between","type":"stack"}],"className":"flex-1 min-w-0","direction":"vertical","gap":"xs","type":"stack"}],"className":["if",["=","@config.feedSurface","cards"],"p-card-md rounded-container bg-[var(--color-card)] border border-[var(--color-border)] shadow-elevation-card transition-all duration-normal hover:border-[var(--color-border-strong)] hover:shadow-elevation-popover",["if",["=","@config.feedSurface","divided"],"px-card-md py-card-sm transition-colors duration-fast hover:bg-[var(--color-muted)]/60","py-card-sm border-b border-[var(--color-border)]"]],"direction":"horizontal","gap":"md","type":"stack"}],"type":"data-list","variant":["if",["=","@config.feedSurface","divided"],"card","default"]}],"className":"w-full","direction":"vertical","gap":"lg","type":"stack"} @label "Feed look body" @description "Render-ui SExpr rendered after rows load when browseLook = feed. Chronological item stream: optional leading avatar/icon, category eyebrow or badge, title, body, meta + status badge; composes titleBinding/descriptionBinding/categoryBinding/badgeBinding/metaBinding/avatarBinding plus the feedSurface/feedLeading/feedIcon/feedTitleVariant/feedCategoryLook/feedShowBadge anatomy knobs. Folded from std-browse-feed (Phase 5.B)." @tier "internal"
-    feedCategoryLook : string = "badge" @label "How is the category shown?" @description "browseLook = feed only. badge = a pill beside the title; eyebrow = a small overline above the title (editorial sections); none = hidden." @synonyms "category pill, kicker, section label, overline, tag display" @tier "presentation" @values (badge eyebrow none)
-    feedIcon       : icon = "file-text" @label "Which icon leads each feed item?" @description "Icon shown in the leading tile when feedLeading = icon." @synonyms "item icon, row icon, leading icon" @tier "presentation"
-    feedLeading    : string = "avatar" @label "What leads each feed item?" @description "browseLook = feed only. avatar = initials of avatarBinding (people-authored posts, messages); icon = feedIcon in a tinted tile (articles, docs, tickets); none = text starts flush (editorial)." @synonyms "leading avatar, item icon, thumbnail, no avatar" @tier "presentation" @values (avatar icon none)
-    feedShowBadge  : boolean = true @label "Show the status badge?" @description "browseLook = feed only. Shows badgeBinding at the end of each item's meta line. Turn off on public surfaces where the status (e.g. published) is internal noise." @synonyms "status pill, hide status, show state" @tier "presentation"
-    feedSurface    : string = "cards" @label "How are feed items separated?" @description "browseLook = feed only. cards = each item its own raised card with space between (community posts, listings); divided = one surface with hairline rows (inboxes, answer lists, notes); plain = no chrome, rule lines on the page background (editorial article lists, changelogs)." @synonyms "feed style, item chrome, card per item, divided list, editorial list, rows or cards" @tier "presentation" @values (cards divided plain)
-    feedTitleVariant : string = "body" @label "How prominent is each feed title?" @description "browseLook = feed only. body for conversational streams, h4/h3 for headline-led lists such as articles." @synonyms "title size, headline size, title weight" @tier "presentation" @values (body h4 h3)
+    feedBodyContent : render-ui = {"children":[["if","@config.bodySearch",{"align":"center","children":[{"className":"w-full","clearable":true,"event":"REFETCH_QUERY","placeholder":"@config.searchPlaceholder","type":"search-input"}],"className":"w-full","direction":"horizontal","gap":"sm","type":"stack"},{"children":[],"gap":"none","type":"stack"}],["if",[">",["array/len","@config.filters"],0],{"children":[{"entity":"BrowseItem","event":"REFETCH_FILTER","filters":"@config.filters","look":"@config.filterBarLook","type":"filter-group"}],"className":"w-full","direction":"horizontal","gap":"sm","type":"stack"},{"children":[],"gap":"none","type":"stack"}],{"emptyDescription":"@config.emptyDescription","emptyIcon":"@config.emptyIcon","emptyTitle":"@config.emptyTitle","entity":"@payload.data","fields":"@config.fields","gap":"none","itemActions":["array/filter","@config.itemActions",["fn","item",["or",["=",["array/len",["object/get","@item","roles",[]]],0],["array/includes",["object/get","@item","roles",[]],"@config.viewerRole"]]]],"itemClickEvent":"@config.itemClickEvent","look":["if",["=","@config.feedSurface","cards"],"card-rows","borderless"],"maxInlineActions":"@config.maxInlineActions","pageSize":"@config.displayPageSize","surface":["if",["=","@config.feedSurface","plain"],"none","@config.surface"],"type":"data-list","variant":["if",["=","@config.feedSurface","divided"],"card","default"]}],"className":"w-full","direction":"vertical","gap":"lg","type":"stack"} @label "Feed look body" @description "Render-ui SExpr rendered after rows load when browseLook = feed. Chronological item stream on the same `fields` contract every look reads (roles: overline, h3/h4, caption, small/body, badge, avatar), separated per feedSurface. Folded from std-browse-feed (Phase 5.B)." @tier "internal"
+    feedSurface    : string = "cards" @label "How are feed items separated?" @description "browseLook = feed only. cards = each item its own raised card with space between (community posts, listings); divided = one surface with hairline rows (inboxes, answer lists, notes); plain = no chrome, items on the page background (editorial article lists, changelogs). What each item shows comes from `fields`: overline = eyebrow above the title, h3/h4 = title (its `icon` becomes a leading tile), caption = prose, small/body = meta line, badge = pill, avatar = leading initials." @synonyms "feed style, item chrome, card per item, divided list, editorial list, rows or cards" @tier "presentation" @values (cards divided plain)
     fields         : [FieldSpec] = [{"label":"Name","name":"name","variant":"h4"},{"label":"Description","name":"description","variant":"caption"},{"label":"Status","name":"status","variant":"badge"}] @label "Which fields should appear as columns?" @description "Each entry maps one entity field to a display column with an optional label and variant." @synonyms "visible columns, displayed fields, card fields, column list" @tier "presentation"
     filterBarLook  : string = "toolbar" @label "Filter bar look" @description "Visual treatment for the embedded filter bar, mirroring std-filter's own enum. Only applies when `filters` is non-empty." @synonyms "filter bar style, facet style, chips, pills" @tier "presentation" @values (toolbar chips pills popover-trigger inline-column-header)
     filters        : [FilterSpec] = [] @label "Which filters should appear above the list?" @description "Dropdown filter facets by field, rendered as an embedded filter bar above the rows; each selection fires REFETCH_FILTER on this trait. Empty (the default) = no filter bar, which is the right setting whenever the page already composes std-filter beside this list and routes `XFilter.FILTER -> REFETCH_FILTER` — that is the wired owner and remains the primary path. Use this knob only for a standalone list with no page-level filter affordance, so the surface shows one filter bar instead of two." @synonyms "filter bar, faceted filters, field filters, column filters, dropdowns" @tier "presentation"
-    galleryBodyContent : render-ui = {"children":[["if","@config.bodySearch",{"align":"center","children":[{"className":"w-full","clearable":true,"event":"REFETCH_QUERY","placeholder":"@config.searchPlaceholder","type":"search-input"}],"className":"sticky top-0 z-10 py-3 bg-[var(--color-surface)]/95 backdrop-blur","direction":"horizontal","gap":"sm","type":"stack"},{"children":[],"gap":"none","type":"stack"}],["if",[">",["array/len","@config.filters"],0],{"children":[{"entity":"BrowseItem","event":"REFETCH_FILTER","filters":"@config.filters","look":"@config.filterBarLook","type":"filter-group"}],"className":"w-full","direction":"horizontal","gap":"sm","type":"stack"},{"children":[],"gap":"none","type":"stack"}],{"className":"w-full","emptyDescription":"@config.emptyDescription","emptyIcon":"@config.emptyIcon","emptyTitle":"@config.emptyTitle","entity":"@payload.data","fields":"@config.fields","gap":"lg","imageField":"@config.imageField","itemActions":["array/filter","@config.itemActions",["fn","item",["or",["=",["array/len",["object/get","@item","roles",[]]],0],["array/includes",["object/get","@item","roles",[]],"@config.viewerRole"]]]],"itemClickEvent":"@config.itemClickEvent","maxInlineActions":"@config.maxInlineActions","minCardWidth":260,"type":"data-grid"}],"className":"w-full","direction":"vertical","gap":"lg","type":"stack"} @label "Gallery look body" @description "Render-ui SExpr rendered after rows load when browseLook = gallery. Image-first responsive card grid (auto-fit minCardWidth) on the data-grid fields path: imageField renders the card photo when set (falsy-safe when empty), fields drive title/badges/meta. One tree, no renderItem lambda — lambdas do not survive inside (if) arms (2026-07-27)." @tier "internal"
+    galleryBodyContent : render-ui = {"children":[["if","@config.bodySearch",{"align":"center","children":[{"className":"w-full","clearable":true,"event":"REFETCH_QUERY","placeholder":"@config.searchPlaceholder","type":"search-input"}],"className":"sticky top-0 z-10 py-3 bg-[var(--color-surface)]/95 backdrop-blur","direction":"horizontal","gap":"sm","type":"stack"},{"children":[],"gap":"none","type":"stack"}],["if",[">",["array/len","@config.filters"],0],{"children":[{"entity":"BrowseItem","event":"REFETCH_FILTER","filters":"@config.filters","look":"@config.filterBarLook","type":"filter-group"}],"className":"w-full","direction":"horizontal","gap":"sm","type":"stack"},{"children":[],"gap":"none","type":"stack"}],{"className":"w-full","emptyDescription":"@config.emptyDescription","emptyIcon":"@config.emptyIcon","emptyTitle":"@config.emptyTitle","entity":"@payload.data","fields":"@config.fields","gap":"lg","imageField":"@config.imageField","itemActions":["array/filter","@config.itemActions",["fn","item",["or",["=",["array/len",["object/get","@item","roles",[]]],0],["array/includes",["object/get","@item","roles",[]],"@config.viewerRole"]]]],"itemClickEvent":"@config.itemClickEvent","maxInlineActions":"@config.maxInlineActions","minCardWidth":260,"surface":"@config.surface","type":"data-grid"}],"className":"w-full","direction":"vertical","gap":"lg","type":"stack"} @label "Gallery look body" @description "Render-ui SExpr rendered after rows load when browseLook = gallery. Image-first responsive card grid (auto-fit minCardWidth) on the data-grid fields path: imageField renders the card photo when set (falsy-safe when empty), fields drive title/badges/meta. One tree, no renderItem lambda — lambdas do not survive inside (if) arms (2026-07-27)." @tier "internal"
     gap            : string = "md" @label "Spacing between rows" @description "Gap between grid cells: sm, md, or lg." @synonyms "row gap, cell spacing, grid gap, padding between items" @tier "presentation"
     imageField     : string = "" @label "Which field holds the row image?" @description "Entity field containing the thumbnail URL for each row." @synonyms "image field, thumbnail field, photo field, picture column" @tier "presentation"
     include        : [string] = [] @label "Which relation fields to hydrate?" @description "Entity relation field names to hydrate on fetch (e.g. a `tag : Category` field named `tag`), so grid columns can use dot-paths like tag.name. Empty = no hydration, the default." @synonyms "relation hydration, populate relations, joined fields, hydrate relations" @tier "internal"
@@ -20361,18 +20381,16 @@ trait std-browse.traits.BrowseItemBrowse {
     initialFilterValue : string = "" @label "What value does the first load filter for?" @description "The value initialFilterField must equal on the first load. Blank is meaningful: it matches only records whose field is itself blank, which for a detail pane is normally none — that is how a thread stays empty until its parent is selected." @synonyms "initial filter value, first load value, default selection" @tier "policy"
     itemActions    : [ItemAction] = [] @label "What actions can users take on each row?" @description "Buttons rendered on each row (e.g. Edit, Delete, View)." @synonyms "row buttons, row actions, item actions, per-row buttons, table actions" @tier "presentation"
     itemClickEvent : event = "VIEW" @label "Which event does clicking a row fire?" @description "Row-click channel. Retarget when two browse lists coexist in one orbital and their VIEW payloads differ, so each gets its own typed channel." @synonyms "row click event, item click, open event, select event" @tier "presentation"
-    masterDetailBodyContent : render-ui = {"children":[["if","@config.bodySearch",{"children":[{"className":"w-full max-w-md","clearable":true,"event":"REFETCH_QUERY","placeholder":"@config.searchPlaceholder","type":"search-input"}],"className":"px-card-md py-card-sm border-b border-[var(--color-border)]","direction":"horizontal","gap":"sm","type":"stack"},{"children":[],"gap":"none","type":"stack"}],["if",[">",["array/len","@config.filters"],0],{"children":[{"entity":"BrowseItem","event":"REFETCH_FILTER","filters":"@config.filters","look":"@config.filterBarLook","type":"filter-group"}],"className":"px-card-md py-card-sm border-b border-[var(--color-border)]","direction":"horizontal","gap":"sm","type":"stack"},{"children":[],"gap":"none","type":"stack"}],{"detail":{"children":[],"gap":"none","type":"stack"},"emptyDetail":{"description":"Select a record from the list to see its details.","icon":"mouse-pointer-click","title":"Nothing selected","type":"empty-state"},"hasSelection":false,"master":{"children":["@trait.MasterListView"],"className":"overflow-y-auto","direction":"vertical","gap":"none","type":"stack"},"type":"master-detail-layout"}],"className":"rounded-lg border border-[var(--color-border)] bg-[var(--color-card)] shadow-sm overflow-hidden","direction":"vertical","gap":"none","type":"stack"} @label "Master-detail look body (no selection)" @description "Render-ui SExpr rendered after rows load when browseLook = master-detail: record-work split view — toolbar, dense list left, empty-state pane right until a row is opened. Opening a row renders masterDetailRecordBodyContent. The toolbar honours bodySearch and filters like every other look; it used to render its search box unconditionally, which put a second search box on any page that already composed std-search (observed in std-crm ContactOrbital)." @tier "internal"
-    masterDetailRecordBodyContent : render-ui = {"children":[["if","@config.bodySearch",{"children":[{"className":"w-full max-w-md","clearable":true,"event":"REFETCH_QUERY","placeholder":"@config.searchPlaceholder","type":"search-input"}],"className":"px-card-md py-card-sm border-b border-[var(--color-border)]","direction":"horizontal","gap":"sm","type":"stack"},{"children":[],"gap":"none","type":"stack"}],["if",[">",["array/len","@config.filters"],0],{"children":[{"entity":"BrowseItem","event":"REFETCH_FILTER","filters":"@config.filters","look":"@config.filterBarLook","type":"filter-group"}],"className":"px-card-md py-card-sm border-b border-[var(--color-border)]","direction":"horizontal","gap":"sm","type":"stack"},{"children":[],"gap":"none","type":"stack"}],{"detail":{"actions":["array/filter","@config.detailActions",["fn","action",["or",["=",["array/len",["object/get","@action","roles",[]]],0],["array/includes",["object/get","@action","roles",[]],"@config.viewerRole"]]]],"closeEvent":"@config.detailCloseEvent","fields":"@config.detailFields","initialData":"@payload.row","showActions":true,"type":"detail-panel"},"hasSelection":true,"master":{"children":["@trait.MasterListView"],"className":"overflow-y-auto","direction":"vertical","gap":"none","type":"stack"},"type":"master-detail-layout"}],"className":"rounded-lg border border-[var(--color-border)] bg-[var(--color-card)] shadow-sm overflow-hidden","direction":"vertical","gap":"none","type":"stack"} @label "Master-detail look body (record open)" @description "Render-ui SExpr rendered by the VIEW transition when browseLook = master-detail: the same split view with the clicked record's detail panel on the right, fed by the VIEW payload row and detailFields." @tier "internal"
+    masterDetailBodyContent : render-ui = {"children":[["if","@config.bodySearch",{"children":[{"className":"w-full max-w-md","clearable":true,"event":"REFETCH_QUERY","placeholder":"@config.searchPlaceholder","type":"search-input"}],"className":"px-card-md py-card-sm border-b border-[var(--color-border)]","direction":"horizontal","gap":"sm","type":"stack"},{"children":[],"gap":"none","type":"stack"}],["if",[">",["array/len","@config.filters"],0],{"children":[{"entity":"BrowseItem","event":"REFETCH_FILTER","filters":"@config.filters","look":"@config.filterBarLook","type":"filter-group"}],"className":"px-card-md py-card-sm border-b border-[var(--color-border)]","direction":"horizontal","gap":"sm","type":"stack"},{"children":[],"gap":"none","type":"stack"}],{"detail":{"children":[],"gap":"none","type":"stack"},"emptyDetail":{"description":"Select a record from the list to see its details.","icon":"mouse-pointer-click","title":"Nothing selected","type":"empty-state"},"hasSelection":false,"master":{"children":["@trait.MasterListView"],"className":"overflow-y-auto","direction":"vertical","gap":"none","type":"stack"},"type":"master-detail-layout"}],"className":["if",["=","@config.surface","auto"],"surface-content overflow-hidden",""],"direction":"vertical","gap":"none","type":"stack"} @label "Master-detail look body (no selection)" @description "Render-ui SExpr rendered after rows load when browseLook = master-detail: record-work split view — toolbar, dense list left, empty-state pane right until a row is opened. Opening a row renders masterDetailRecordBodyContent. The toolbar honours bodySearch and filters like every other look; it used to render its search box unconditionally, which put a second search box on any page that already composed std-search (observed in std-crm ContactOrbital)." @tier "internal"
+    masterDetailRecordBodyContent : render-ui = {"children":[["if","@config.bodySearch",{"children":[{"className":"w-full max-w-md","clearable":true,"event":"REFETCH_QUERY","placeholder":"@config.searchPlaceholder","type":"search-input"}],"className":"px-card-md py-card-sm border-b border-[var(--color-border)]","direction":"horizontal","gap":"sm","type":"stack"},{"children":[],"gap":"none","type":"stack"}],["if",[">",["array/len","@config.filters"],0],{"children":[{"entity":"BrowseItem","event":"REFETCH_FILTER","filters":"@config.filters","look":"@config.filterBarLook","type":"filter-group"}],"className":"px-card-md py-card-sm border-b border-[var(--color-border)]","direction":"horizontal","gap":"sm","type":"stack"},{"children":[],"gap":"none","type":"stack"}],{"detail":{"actions":["array/filter","@config.detailActions",["fn","action",["or",["=",["array/len",["object/get","@action","roles",[]]],0],["array/includes",["object/get","@action","roles",[]],"@config.viewerRole"]]]],"closeEvent":"@config.detailCloseEvent","fields":"@config.detailFields","initialData":"@payload.row","showActions":true,"surface":"none","type":"detail-panel"},"hasSelection":true,"master":{"children":["@trait.MasterListView"],"className":"overflow-y-auto","direction":"vertical","gap":"none","type":"stack"},"type":"master-detail-layout"}],"className":["if",["=","@config.surface","auto"],"surface-content overflow-hidden",""],"direction":"vertical","gap":"none","type":"stack"} @label "Master-detail look body (record open)" @description "Render-ui SExpr rendered by the VIEW transition when browseLook = master-detail: the same split view with the clicked record's detail panel on the right, fed by the VIEW payload row and detailFields." @tier "internal"
     maxInlineActions : number = 3 @label "How many row actions to show before collapsing?" @description "Actions beyond this count collapse into a '⋯' overflow menu. Set 2–3 for dense tables." @synonyms "inline actions limit, overflow threshold, max buttons per row" @tier "presentation"
-    metaBinding    : string = "@item.createdAt" @label "Meta field binding" @description "Binding path for the secondary meta slot (timestamp / category). Hosts binding a count or other non-date value should label it in the binding itself (e.g. (str/concat \"Vehicles: \" @item.vehicleCount)) and set metaFormat: none." @tier "internal"
-    metaFormat     : string = "date" @label "Meta value format" @description "Typography format for the feed meta slot — date by default so the createdAt binding renders human-readable instead of raw ISO; set none for non-date bindings." @tier "presentation" @values (none date time datetime number)
     pageSize       : number = 10 @label "How many rows to fetch per page?" @description "Records fetched from the server per page request." @synonyms "fetch limit, records per page, batch size, page limit" @tier "presentation"
     scopeField     : string = "" @label "Only show records owned by the signed-in user?" @description "Name the field on this entity that holds the viewer's id (e.g. memberId, patientId, assignee). When set, the list loads ONLY rows whose that field equals @user.id — the 'my bookings' / 'my appointments' shape. Left blank the list loads every row, which is the default. Declared, never inferred: guessing the column from its name would silently scope the wrong one." @synonyms "owner field, my records, only mine, only my own, scope to user, per-user list, mine only, owned by me" @tier "policy"
     searchField    : string = "name" @label "Which column does the search box match against?" @description "Name the field on this entity the search box's str/includes filter matches against. Declared, never inferred: an entity with no `name` column must set this to a real field (e.g. title, content) or the search box can never match a row." @synonyms "search column, search on field, match field, search key" @tier "policy"
     searchPlaceholder : string = "Search…" @label "Search box placeholder text" @description "Hint text inside the list search box (e.g. 'Search orders…')." @synonyms "search hint, placeholder, search box text, search label" @tier "presentation"
     selectable     : boolean = false @label "Show row selection checkboxes?" @description "Adds a checkbox column with select-all to the dense table. Enable only when the surface offers bulk actions — checkboxes with nothing to act on are a dead affordance." @synonyms "row checkboxes, multi-select, bulk select, selection column" @tier "presentation"
-    titleBinding   : string = "@item.name" @label "Title field binding" @description "Binding path for the card title slot (e.g. @item.dishName)." @tier "internal"
-    triageBodyContent : render-ui = {"children":[["if","@config.bodySearch",{"children":[{"className":"w-full max-w-md","clearable":true,"event":"REFETCH_QUERY","placeholder":"@config.searchPlaceholder","type":"search-input"}],"className":"px-card-md py-card-sm border-b border-[var(--color-border)]","direction":"horizontal","gap":"sm","type":"stack"},{"children":[],"gap":"none","type":"stack"}],["if",[">",["array/len","@config.filters"],0],{"children":[{"entity":"BrowseItem","event":"REFETCH_FILTER","filters":"@config.filters","look":"@config.filterBarLook","type":"filter-group"}],"className":"px-card-md py-card-sm border-b border-[var(--color-border)]","direction":"horizontal","gap":"sm","type":"stack"},{"children":[],"gap":"none","type":"stack"}],{"children":[{"emptyDescription":"@config.emptyDescription","emptyIcon":"@config.emptyIcon","emptyTitle":"@config.emptyTitle","entity":"@payload.data","fields":"@config.fields","itemActions":["array/filter","@config.itemActions",["fn","item",["or",["=",["array/len",["object/get","@item","roles",[]]],0],["array/includes",["object/get","@item","roles",[]],"@config.viewerRole"]]]],"itemClickEvent":"@config.itemClickEvent","maxInlineActions":"@config.maxInlineActions","type":"data-list","variant":"compact"}],"className":"overflow-x-auto","direction":"vertical","gap":"none","type":"stack"}],"className":"rounded-lg border border-[var(--color-border)] bg-[var(--color-card)] shadow-sm overflow-hidden","direction":"vertical","gap":"none","type":"stack"} @label "Triage look body" @description "Render-ui SExpr rendered after rows load when browseLook = triage. Inbox-register queue: one surface with a toolbar search and compact list rows (title + badges + inline meta) built for keyboard-pace queue work; row actions collapse per maxInlineActions. Composes fields/itemActions/searchPlaceholder/bodySearch." @tier "internal"
+    surface        : string = "auto" @label "Paint a surface behind the list?" @description "auto (default) draws the theme's content surface behind every look — on a patterned page background the list reads as one block; the theme decides how that surface looks. none places the list directly on the page (e.g. a list already inside a card or panel you composed)." @synonyms "card background, panel, container, list background, no background, transparent, bare" @tier "presentation" @values (auto none)
+    triageBodyContent : render-ui = {"children":[["if","@config.bodySearch",{"children":[{"className":"w-full max-w-md","clearable":true,"event":"REFETCH_QUERY","placeholder":"@config.searchPlaceholder","type":"search-input"}],"className":"px-card-md py-card-sm border-b border-[var(--color-border)]","direction":"horizontal","gap":"sm","type":"stack"},{"children":[],"gap":"none","type":"stack"}],["if",[">",["array/len","@config.filters"],0],{"children":[{"entity":"BrowseItem","event":"REFETCH_FILTER","filters":"@config.filters","look":"@config.filterBarLook","type":"filter-group"}],"className":"px-card-md py-card-sm border-b border-[var(--color-border)]","direction":"horizontal","gap":"sm","type":"stack"},{"children":[],"gap":"none","type":"stack"}],{"children":[{"emptyDescription":"@config.emptyDescription","emptyIcon":"@config.emptyIcon","emptyTitle":"@config.emptyTitle","entity":"@payload.data","fields":"@config.fields","itemActions":["array/filter","@config.itemActions",["fn","item",["or",["=",["array/len",["object/get","@item","roles",[]]],0],["array/includes",["object/get","@item","roles",[]],"@config.viewerRole"]]]],"itemClickEvent":"@config.itemClickEvent","maxInlineActions":"@config.maxInlineActions","pageSize":"@config.displayPageSize","surface":"none","type":"data-list","variant":"compact"}],"className":"overflow-x-auto","direction":"vertical","gap":"none","type":"stack"}],"className":["if",["=","@config.surface","auto"],"surface-content overflow-hidden",""],"direction":"vertical","gap":"none","type":"stack"} @label "Triage look body" @description "Render-ui SExpr rendered after rows load when browseLook = triage. Inbox-register queue: one surface with a toolbar search and compact list rows (title + badges + inline meta) built for keyboard-pace queue work; row actions collapse per maxInlineActions. Composes fields/itemActions/searchPlaceholder/bodySearch." @tier "internal"
     viewerRole     : string = "" @label "Viewer's role" @description "The signed-in viewer's role that each row action's `roles` is checked against. Bind it explicitly at the call site (e.g. `viewerRole: @user.role`) in an app whose identity carries a role; left empty, only actions with no `roles` show." @tier "policy"
   }
   override-surface : (linkedEntity name events effects listens emitsScope config)
@@ -21425,28 +21443,29 @@ trait std-learn-arrangement.traits.LearnArrangementSim {
   category       : interaction
   states         : (idle*)
   events         : (INIT MODE_SELECTED PLACE UNDO CHECK RETRY ARRANGEMENT_CHECKED ARRANGEMENT_RESET LEARN_ROUND_COMPLETE)
-  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on PLACE) (idle -> idle on UNDO) (idle -> idle on CHECK) (idle -> idle on RETRY))
+  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on PLACE) (idle -> idle on UNDO) (idle -> idle on CHECK) (idle -> idle on RETRY))
   emits          : (ARRANGEMENT_CHECKED ARRANGEMENT_RESET LEARN_ROUND_COMPLETE)
   config {
     animate        : boolean = false @label "Animate" @description "Enable continuous redraw loop." @tier "presentation"
     checkLabel     : string = "Check" @label "Check Button Label" @tier "presentation"
-    correctColor   : string = "#16a34a" @label "Correct Slot Color" @description "Fill color for a filled slot whose item matches its correct position, once graded." @tier "presentation"
-    emptySlotColor : string = "#e2e8f0" @label "Empty Slot Color" @description "Fill color for a slot with no item placed yet." @tier "presentation"
+    correctColor   : string = "success" @label "Correct Slot Color" @description "Fill color for a filled slot whose item matches its correct position, once graded." @tier "presentation"
+    emptySlotColor : string = "fill" @label "Empty Slot Color" @description "Fill color for a slot with no item placed yet." @tier "presentation"
     height         : number = 220 @label "Height" @description "Canvas height in pixels." @tier "presentation"
-    incorrectColor : string = "#dc2626" @label "Incorrect Slot Color" @description "Fill color for a filled slot whose item does not match its correct position, once graded." @tier "presentation"
+    incorrectColor : string = "error" @label "Incorrect Slot Color" @description "Fill color for a filled slot whose item does not match its correct position, once graded." @tier "presentation"
     interactive    : boolean = false @label "Interactive" @description "Enable pointer interaction on the canvas." @tier "presentation"
     items          : [LearnArrangementItem] = [{"correctPosition":0,"hint":"What has to happen before anything can be poured?","id":"1","label":"Boil water in a kettle"},{"correctPosition":1,"hint":"The bag goes in before the water does.","id":"2","label":"Place a tea bag in the cup"},{"correctPosition":2,"hint":"Now the water and the bag meet.","id":"3","label":"Pour the hot water over the tea bag"},{"correctPosition":3,"hint":"Flavor needs time to develop.","id":"4","label":"Let it steep for a few minutes"},{"correctPosition":4,"hint":"This happens once the tea is strong enough.","id":"5","label":"Remove the tea bag and add milk or sugar to taste"}] @label "Items" @description "Roster of items to order; each carries its label, its zero-based correct position in the finished sequence, and an optional hint shown beneath its button while unplaced." @synonyms "item, step, stage, sequence, order, ranking, procedure" @tier "domain"
     matchMode      : string = "" @label "Match Mode" @description "When composed behind a lab router, the MODE_SELECTED mode value this instrument responds to. Empty string means standalone — render immediately on INIT." @tier "presentation"
-    pendingColor   : string = "#94a3b8" @label "Pending Slot Color" @description "Fill color for a filled slot before grading." @tier "presentation"
+    pendingColor   : string = "series-2" @label "Pending Slot Color" @description "Fill color for a filled slot before grading." @tier "presentation"
     retryLabel     : string = "Retry" @label "Retry Button Label" @tier "presentation"
-    slotBorderColor : string = "#334155" @label "Slot Border Color" @tier "presentation"
-    slotFontSize   : number = 13 @label "Slot Font Size" @tier "presentation"
+    slotBorderColor : string = "ink" @label "Slot Border Color" @tier "presentation"
+    slotFontSize   : string = "sm" @label "Slot Text Size" @description "Slot label size role: xs, sm, base or lg." @tier "presentation"
     slotHeight     : number = 60 @label "Slot Height (px)" @tier "presentation"
     slotLeft       : number = 40 @label "First Slot X (px)" @tier "presentation"
     slotSpacing    : number = 120 @label "Slot Spacing (px)" @tier "presentation"
-    slotTextColor  : string = "#0f172a" @label "Slot Text Color" @tier "presentation"
+    slotTextColor  : string = "label" @label "Slot Text Color" @tier "presentation"
     slotWidth      : number = 100 @label "Slot Width (px)" @tier "presentation"
     slotY          : number = 70 @label "Slot Row Y (px)" @tier "presentation"
+    summary        : string = "" @label "Concept" @description "One line under the title saying what is being ordered (keep it under ~65 characters). Empty shows no line." @tier "presentation"
     title          : string = "Build the Order" @label "Title" @description "Title shown above the instrument." @tier "presentation"
     undoLabel      : string = "Undo" @label "Undo Button Label" @tier "presentation"
     width          : number = 640 @label "Width" @description "Canvas width in pixels." @tier "presentation"
@@ -21462,18 +21481,18 @@ trait std-learn-classify.traits.LearnClassifySim {
   category       : interaction
   states         : (idle*)
   events         : (INIT MODE_SELECTED PICK ADVANCE RETRY TOGGLE_RUN CLASSIFY_UPDATED LEARN_ROUND_COMPLETE)
-  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on PICK) (idle -> idle on ADVANCE) (idle -> idle on RETRY) (idle -> idle on TOGGLE_RUN))
+  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on PICK) (idle -> idle on ADVANCE) (idle -> idle on RETRY) (idle -> idle on TOGGLE_RUN))
   emits          : (CLASSIFY_UPDATED LEARN_ROUND_COMPLETE)
   config {
     advanceLabel   : string = "Next" @label "Advance Button Label" @description "Label text for the button that advances to the next item." @tier "presentation"
     advanceMs      : number = 900 @label "Auto-Advance Interval (ms)" @description "Milliseconds between automatic advances while running — the 32ms base tick accumulates elapsed time and fires ADVANCE each time this interval elapses." @tier "domain"
     animate        : boolean = false @label "Animate" @description "Enable continuous redraw loop." @tier "presentation"
     autoRun        : boolean = false @label "Auto Run" @description "When true the advance clock starts on load and the drill flips to the next item every advanceMs milliseconds; toggle live with the Auto/Pause button." @tier "domain"
-    backgroundColor : string = "#f8fafc" @label "Background Color" @tier "presentation"
-    categories     : [LearnClassifyOption] = [{"color":"#94a3b8","label":"Category A","value":"a"},{"color":"#64748b","label":"Category B","value":"b"}] @label "Categories" @description "Ordered bottom-to-top roster of category buckets (value/label/color) used to render the stacked backdrop and the pick buttons; order determines the backdrop's stacking, widest at the bottom to narrowest at the top." @synonyms "category, bucket, class, tier, level, classification, roster" @tier "domain"
-    correctColor   : string = "#16a34a" @label "Correct Highlight Color" @description "Fill color for the correct category once the learner has picked." @tier "presentation"
+    backgroundColor : string = "" @label "Background Color" @description "Canvas ground (tone name, token or colour); empty uses the theme's drawing ground." @tier "presentation"
+    categories     : [LearnClassifyOption] = [{"color":"series-1","label":"Category A","value":"a"},{"color":"series-2","label":"Category B","value":"b"}] @label "Categories" @description "Ordered bottom-to-top roster of category buckets (value/label/color) used to render the stacked backdrop and the pick buttons; order determines the backdrop's stacking, widest at the bottom to narrowest at the top." @synonyms "category, bucket, class, tier, level, classification, roster" @tier "domain"
+    correctColor   : string = "success" @label "Correct Highlight Color" @description "Fill color for the correct category once the learner has picked." @tier "presentation"
     height         : number = 420 @label "Height" @description "Canvas height in pixels." @tier "presentation"
-    incorrectColor : string = "#dc2626" @label "Incorrect Highlight Color" @description "Fill color for the learner's picked category when it does not match the correct category." @tier "presentation"
+    incorrectColor : string = "error" @label "Incorrect Highlight Color" @description "Fill color for the learner's picked category when it does not match the correct category." @tier "presentation"
     interactive    : boolean = false @label "Interactive" @description "Enable pointer interaction on the canvas." @tier "presentation"
     items          : [LearnClassifyItem] = [{"category":"a","explanation":"This example was written to satisfy category A's defining trait.","hint":"Consider what makes this belong to category A.","text":"Example item one."},{"category":"b","explanation":"This example was written to satisfy category B's defining trait.","hint":"Consider what makes this belong to category B.","text":"Example item two."}] @label "Items" @description "Roster of items the learner classifies; each carries its prompt text, the value of its correct category, and optional hint/explanation text shown before/after the pick." @synonyms "item, prompt, scenario, situation, case, example, question" @tier "domain"
     loopRound      : boolean = false @label "Loop Round" @description "When true the item cursor wraps past the last item forever (a looping drill) instead of ending the round at the summary screen." @tier "domain"
@@ -21485,6 +21504,8 @@ trait std-learn-classify.traits.LearnClassifySim {
     retryLabel     : string = "Retry Round" @label "Retry Button Label" @description "Label text for the button that restarts the round from the end-of-round summary." @tier "presentation"
     scoreCap       : number = 0 @label "Score Cap" @description "Upper bound on the rubric score; 0 means uncapped." @tier "domain"
     showHint       : boolean = true @label "Show Hint" @description "Show each item's hint line beneath the prompt before the learner picks; hide for a harder drill." @tier "domain"
+    summary        : string = "" @label "Concept" @description "One line under the title saying what is being classified (keep it under ~65 characters). Empty shows no line." @tier "presentation"
+    taper          : number = 0 @label "Taper" @description "How far the category rungs narrow toward the top: 0 = equal-width rungs (no implied order), 1 = a full pyramid for hierarchies (needs, levels). Long category names need 0." @tier "presentation"
     title          : string = "Classify" @label "Title" @description "Title shown above the instrument." @tier "presentation"
     width          : number = 640 @label "Width" @description "Canvas width in pixels." @tier "presentation"
   }
@@ -21499,7 +21520,7 @@ trait std-learn-compare.traits.CompareSim {
   category       : interaction
   states         : (idle*)
   events         : (INIT MODE_SELECTED SET_PARAM COMPARISON_CHANGED)
-  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on SET_PARAM))
+  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on SET_PARAM))
   emits          : (COMPARISON_CHANGED)
   config {
     compareText    : string = "Tune each side's parameters and watch how the two curves diverge." @label "Compare Text" @description "One-sentence statement of what is being contrasted." @tier "domain"
@@ -21508,7 +21529,7 @@ trait std-learn-compare.traits.CompareSim {
     height         : number = 400 @label "Height" @tier "presentation"
     leftADefault   : number = 1 @label "Left A Default" @tier "domain"
     leftBDefault   : number = 2 @label "Left B Default" @tier "domain"
-    leftColor      : string = "#3b82f6" @label "Left Color" @tier "presentation"
+    leftColor      : string = "series-1" @label "Left Color" @tier "presentation"
     leftLabel      : string = "Left" @label "Left Label" @description "Display name of the first compared instance." @tier "domain"
     matchMode      : string = "" @label "Match Mode" @description "When composed behind a lab router, the MODE_SELECTED mode value this instrument responds to. Empty string means standalone — render immediately on INIT." @tier "presentation"
     paramALabel    : string = "A" @label "Parameter A Label" @tier "presentation"
@@ -21521,10 +21542,11 @@ trait std-learn-compare.traits.CompareSim {
     paramBStep     : number = 0.1 @label "Parameter B Step" @tier "presentation"
     rightADefault  : number = 2 @label "Right A Default" @tier "domain"
     rightBDefault  : number = 1.5 @label "Right B Default" @tier "domain"
-    rightColor     : string = "#f59e0b" @label "Right Color" @tier "presentation"
+    rightColor     : string = "series-2" @label "Right Color" @tier "presentation"
     rightLabel     : string = "Right" @label "Right Label" @description "Display name of the second compared instance." @tier "domain"
     showAxes       : boolean = true @label "Show Axes" @tier "presentation"
     showGrid       : boolean = true @label "Show Grid" @tier "presentation"
+    summary        : string = "" @label "Concept" @description "One line under the title saying what the learner is looking at (keep it under ~65 characters). Empty shows no line." @tier "presentation"
     title          : string = "Compare Two Settings" @label "Title" @description "Title shown above the canvas." @tier "presentation"
     width          : number = 600 @label "Width" @tier "presentation"
     xMax           : number = 10 @label "X Max" @tier "presentation"
@@ -21540,8 +21562,8 @@ trait std-learn-coupled-sim.traits.CoupledSimSim {
   linkedEntity   : CoupledSimScene
   category       : interaction
   states         : (idle*)
-  events         : (INIT MODE_SELECTED RUN PAUSE RESET SET_A SET_B SHOCK RUN_TOGGLED SIM_RESET COEFS_CHANGED SHOCK_APPLIED)
-  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on RUN) (idle -> idle on PAUSE) (idle -> idle on RESET) (idle -> idle on SET_A) (idle -> idle on SET_B) (idle -> idle on SHOCK))
+  events         : (INIT MODE_SELECTED TOGGLE_RUN SPEED_SET RUN PAUSE RESET SET_A SET_B SHOCK RUN_TOGGLED SIM_RESET COEFS_CHANGED SHOCK_APPLIED)
+  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on TOGGLE_RUN) (idle -> idle on SPEED_SET) (idle -> idle on RUN) (idle -> idle on PAUSE) (idle -> idle on RESET) (idle -> idle on SET_A) (idle -> idle on SET_B) (idle -> idle on SHOCK))
   emits          : (RUN_TOGGLED SIM_RESET COEFS_CHANGED SHOCK_APPLIED)
   config {
     autoRun        : boolean = true @label "Auto Run" @description "Whether the simulation starts running immediately on load." @tier "domain"
@@ -21562,18 +21584,19 @@ trait std-learn-coupled-sim.traits.CoupledSimSim {
     height         : number = 360 @label "Height" @tier "presentation"
     kind           : string = "predator-prey" @label "Interaction Family" @description "Which coupled dynamics govern the two quantities: predator-prey (oscillating cycles), epidemic (S and I with transmission and recovery), or kinetics (A decaying into B)." @synonyms "predator prey, Lotka-Volterra, SIR, epidemic, reaction kinetics, coupled ODE" @tier "domain"
     matchMode      : string = "" @label "Match Mode" @description "When composed behind a lab router, the MODE_SELECTED mode value this instrument responds to. Empty string means standalone — render immediately on INIT." @tier "presentation"
-    pColor         : string = "#16a34a" @label "P Color" @tier "presentation"
+    pColor         : string = "series-1" @label "P Color" @tier "presentation"
     pLabel         : string = "Prey" @label "P Label" @description "Display name of the first quantity." @tier "domain"
     pStart         : number = 120 @label "P Start" @tier "domain"
-    qColor         : string = "#dc2626" @label "Q Color" @tier "presentation"
+    qColor         : string = "series-2" @label "Q Color" @tier "presentation"
     qLabel         : string = "Predators" @label "Q Label" @description "Display name of the second quantity." @tier "domain"
     qStart         : number = 40 @label "Q Start" @tier "domain"
     shockDownLabel : string = "− Prey cull" @label "Shock Down Label" @tier "presentation"
     shockSize      : number = 40 @label "Shock Size" @description "How much of the first quantity a shock button injects or removes." @tier "domain"
     shockUpLabel   : string = "+ Prey burst" @label "Shock Up Label" @tier "presentation"
+    summary        : string = "" @label "Concept" @description "One line under the title saying what the learner is looking at (keep it under ~65 characters). Empty shows no line." @tier "presentation"
     taskText       : string = "Run the system, retune the rates, and shock it — watch how the two quantities push and pull each other." @label "Task Text" @description "One-sentence statement of what to explore." @tier "domain"
     timeScale      : number = 1 @label "Time Scale" @description "Multiplier on the integration step; raise it to fast-forward the dynamics." @tier "domain"
-    title          : string = "Coupled System" @label "Title" @description "Title shown above the simulation." @tier "presentation"
+    title          : string = "Coupled System" @label "Title" @description "The instrument's name, the header's one hero." @tier "presentation"
     valueMax       : number = 300 @label "Value Max" @description "Upper bound of the chart's y axis." @tier "presentation"
     width          : number = 600 @label "Width" @tier "presentation"
   }
@@ -21588,7 +21611,7 @@ trait std-learn-derivation.traits.LearnDerivationSim {
   category       : interaction
   states         : (idle*)
   events         : (INIT MODE_SELECTED APPLY_STEP TOGGLE_RUN RESET DERIVATION_UPDATED LEARN_ROUND_COMPLETE)
-  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on APPLY_STEP) (idle -> idle on TOGGLE_RUN) (idle -> idle on RESET))
+  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on APPLY_STEP) (idle -> idle on TOGGLE_RUN) (idle -> idle on RESET))
   emits          : (DERIVATION_UPDATED LEARN_ROUND_COMPLETE)
   config {
     autoApplyIntervalMs : number = 800 @label "Auto-Apply Interval (ms)" @description "Milliseconds of running clock per automatic candidate application — the 32ms base tick accumulates elapsed time and applies the first applicable candidate each time this interval elapses." @tier "domain"
@@ -21605,6 +21628,7 @@ trait std-learn-derivation.traits.LearnDerivationSim {
     noStepAvailableMessage : string = "No further steps are available yet." @label "No Step Available Message" @description "Feedback shown when the auto-apply tick finds no applicable candidate." @tier "presentation"
     premises       : [LearnDerivationLine] = [{"badgeLabel":"GIVEN","badgeVariant":"neutral","id":"given-a","kind":"fact","label":"A","negated":false,"subject":"A"},{"badgeLabel":"RULE","badgeVariant":"info","id":"given-a-implies-b","kind":"link","label":"A → B","leftNegated":false,"leftSubject":"A","rightNegated":false,"rightSubject":"B"}] @label "Premises" @description "The starting lines of the derivation: plain facts (subject/negated) and two-sided links (leftSubject/leftNegated/rightSubject/rightNegated) the learner combines with candidate steps. Each line carries its own badgeLabel/badgeVariant." @synonyms "premise, given, starting line, hypothesis, starting statement" @tier "domain"
     resetLabel     : string = "Reset" @label "Reset Button Label" @description "Label text for the button that restores the starting premises." @tier "presentation"
+    summary        : string = "" @label "Concept" @description "One line under the title saying what is being derived (keep it under ~65 characters). Empty shows no line." @tier "presentation"
     title          : string = "Derivation Lab" @label "Title" @description "Title shown above the derivation panel." @tier "presentation"
     width          : number = 600 @label "Width" @description "Maximum width of the panel, in pixels." @tier "presentation"
   }
@@ -21619,17 +21643,18 @@ trait std-learn-diagram.traits.LearnDiagramSim {
   category       : interaction
   states         : (idle*)
   events         : (INIT MODE_SELECTED SELECT_PART CLEAR_PART PART_SELECTED SELECTION_CLEARED)
-  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on SELECT_PART) (idle -> idle on CLEAR_PART))
+  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on SELECT_PART) (idle -> idle on CLEAR_PART))
   emits          : (PART_SELECTED SELECTION_CLEARED)
   config {
-    backgroundColor : string = "#f8fafc" @label "Background Color" @description "Canvas background color." @tier "presentation"
+    backgroundColor : string = "" @label "Background Color" @description "Canvas ground. Empty uses the theme drawing ground." @tier "presentation"
     clearLabel     : string = "Clear" @label "Clear Button Label" @description "Label text for the button that clears the current selection." @tier "presentation"
     height         : number = 400 @label "Height" @description "Canvas height in pixels." @tier "presentation"
-    highlightColor : string = "#f59e0b" @label "Highlight Color" @description "Ring color drawn around the selected part." @tier "presentation"
-    links          : [LearnDiagramLink] = [{"color":"#cbd5e1","from":"input","label":"","to":"processor"},{"color":"#cbd5e1","from":"processor","label":"","to":"storage"},{"color":"#cbd5e1","from":"processor","label":"","to":"output"},{"color":"#cbd5e1","from":"controller","label":"","to":"processor"}] @label "Links" @description "Connector lines drawn between parts, by id." @synonyms "link, edge, connector, arrow" @tier "domain"
+    highlightColor : string = "highlight" @label "Highlight Color" @description "Ring color drawn around the selected part." @tier "presentation"
+    links          : [LearnDiagramLink] = [{"color":"guide","from":"input","label":"","to":"processor"},{"color":"guide","from":"processor","label":"","to":"storage"},{"color":"guide","from":"processor","label":"","to":"output"},{"color":"guide","from":"controller","label":"","to":"processor"}] @label "Links" @description "Connector lines drawn between parts, by id." @synonyms "link, edge, connector, arrow" @tier "domain"
     matchMode      : string = "" @label "Match Mode" @description "When composed behind a lab router, the MODE_SELECTED mode value this instrument responds to. Empty string means standalone — render immediately on INIT." @tier "presentation"
     overviewText   : string = "Select a part below to learn what it does." @label "Overview Text" @description "Caption card text shown when no part is selected." @tier "presentation"
-    parts          : [LearnDiagramPart] = [{"color":"#2563eb","description":"Receives raw data or requests from the outside world and hands them to the processor.","id":"input","label":"Input","radius":34,"x":120,"y":200},{"color":"#7c3aed","description":"The central component that transforms incoming data according to the system's rules.","id":"processor","label":"Processor","radius":46,"x":300,"y":200},{"color":"#0891b2","description":"Persists data so it can be retrieved later, even after the system restarts.","id":"storage","label":"Storage","radius":34,"x":300,"y":320},{"color":"#16a34a","description":"Delivers the processor's results back out to users or other systems.","id":"output","label":"Output","radius":34,"x":480,"y":200},{"color":"#dc2626","description":"Coordinates timing and configuration for the processor without touching the data itself.","id":"controller","label":"Controller","radius":26,"x":300,"y":80}] @label "Parts" @description "Roster of labeled parts (id, label, description, x, y, radius, color) the diagram renders as circles; the learner selects one to see its description." @synonyms "part, node, component, label, annotation" @tier "domain"
+    parts          : [LearnDiagramPart] = [{"color":"series-1","description":"Receives raw data or requests from the outside world and hands them to the processor.","id":"input","label":"Input","radius":34,"x":120,"y":200},{"color":"series-2","description":"The central component that transforms incoming data according to the system's rules.","id":"processor","label":"Processor","radius":46,"x":300,"y":200},{"color":"series-3","description":"Persists data so it can be retrieved later, even after the system restarts.","id":"storage","label":"Storage","radius":34,"x":300,"y":320},{"color":"series-4","description":"Delivers the processor's results back out to users or other systems.","id":"output","label":"Output","radius":34,"x":480,"y":200},{"color":"series-5","description":"Coordinates timing and configuration for the processor without touching the data itself.","id":"controller","label":"Controller","radius":26,"x":300,"y":80}] @label "Parts" @description "Roster of labeled parts (id, label, description, x, y, radius, color) the diagram renders as circles; the learner selects one to see its description." @synonyms "part, node, component, label, annotation" @tier "domain"
+    summary        : string = "" @label "Concept" @description "One line under the title saying what the learner is looking at (keep it under ~65 characters). Empty shows no line." @tier "presentation"
     title          : string = "System Diagram" @label "Title" @description "Title shown above the diagram." @tier "presentation"
     width          : number = 600 @label "Width" @description "Canvas width in pixels." @tier "presentation"
   }
@@ -21644,12 +21669,12 @@ trait std-learn-doser.traits.LearnDoserSim {
   category       : interaction
   states         : (idle*)
   events         : (INIT MODE_SELECTED ADD_SMALL ADD_LARGE TOGGLE_DRIP RESET DOSE_ADDED DOSE_RESET DOSER_UPDATED LEARN_ROUND_COMPLETE)
-  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on ADD_SMALL) (idle -> idle on ADD_LARGE) (idle -> idle on TOGGLE_DRIP) (idle -> idle on RESET))
+  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on ADD_SMALL) (idle -> idle on ADD_LARGE) (idle -> idle on TOGGLE_DRIP) (idle -> idle on RESET))
   emits          : (DOSE_ADDED DOSE_RESET DOSER_UPDATED LEARN_ROUND_COMPLETE)
   config {
     autoDrip       : boolean = false @label "Auto Drip" @description "When true, INIT/MODE_SELECTED/Reset start the drip clock adding a small increment each interval; toggle live with the Auto-dose/Pause button." @tier "domain"
-    backgroundColor : string = "#fafafa" @label "Background Color" @description "Canvas background color." @tier "presentation"
-    bands          : [DoserBand] = [{"color":"#94a3b8","label":"Low","terminal":false,"upperBound":50},{"color":"#16a34a","label":"High","terminal":true,"upperBound":999999999}] @label "Bands" @description "Ordered ascending roster of dose bands/zones — each carries the dose upper bound it covers, a label, a color, and whether crossing into it is terminal (irreversible; sets done true until Reset). The accumulated dose is classified into the first band whose upperBound it does not exceed, falling through to the last band beyond all bounds." @synonyms "zone, band, threshold, region, stage, phase, tier" @tier "domain"
+    backgroundColor : string = "" @label "Background Color" @description "Canvas ground. Empty uses the theme drawing ground." @tier "presentation"
+    bands          : [DoserBand] = [{"color":"muted","label":"Low","terminal":false,"upperBound":50},{"color":"success","label":"High","terminal":true,"upperBound":999999999}] @label "Bands" @description "Ordered ascending roster of dose bands/zones — each carries the dose upper bound it covers, a label, a color, and whether crossing into it is terminal (irreversible; sets done true until Reset). The accumulated dose is classified into the first band whose upperBound it does not exceed, falling through to the last band beyond all bounds." @synonyms "zone, band, threshold, region, stage, phase, tier" @tier "domain"
     capacity       : number = 100 @label "Capacity" @description "Maximum total dose the source can deliver; the source vessel drains to empty and additions clamp once accumulated dose reaches this cap." @tier "domain"
     dripIntervalMs : number = 500 @label "Drip Interval (ms)" @description "Milliseconds of running clock per auto-drip increment — the 32ms base tick accumulates elapsed time and adds a small step each time this interval elapses." @tier "domain"
     height         : number = 400 @label "Height" @description "Canvas height in pixels." @tier "presentation"
@@ -21657,11 +21682,13 @@ trait std-learn-doser.traits.LearnDoserSim {
     matchMode      : string = "" @label "Match Mode" @description "When composed behind a lab router, the MODE_SELECTED mode value this instrument responds to. Empty string means standalone — render immediately on INIT." @tier "presentation"
     quantityLabel  : string = "Dose" @label "Quantity Label" @description "Label used for the accumulated-quantity readout and in the narration line." @synonyms "quantity, amount, dose, volume, level" @tier "domain"
     reservoirLabel : string = "Reservoir" @label "Reservoir Label" @description "Label for the vessel that fills as dose accumulates." @synonyms "reservoir, beaker, tank, container, receiving vessel" @tier "presentation"
+    series         : [string] = [] @label "Palette" @description "Overrides the theme's categorical palette on the canvas (series-1…N) — a subject's real-world color convention, such as indicator colors. Empty uses the theme's palette." @tier "presentation"
     showCanvas     : boolean = true @label "Show Canvas" @description "When true (the default, standalone use) the instrument renders its own reservoir/source canvas and narration below the control strip. Set false when a domain sibling trait composes this atom via @rebindable and owns the accurate scene render itself — then only the control strip (add/drip/reset buttons) embeds via @trait.<name>, avoiding a duplicate canvas." @tier "presentation"
-    sourceColor    : string = "#60a5fa" @label "Source Color" @description "Fill color for the source vessel." @tier "presentation"
+    sourceColor    : string = "series-1" @label "Source Color" @description "Tone name for the source vessel fill (for example series-1)." @tier "presentation"
     sourceLabel    : string = "Source" @label "Source Label" @description "Label for the vessel that drains as dose is delivered from it." @synonyms "source, burette, supply, dispenser" @tier "presentation"
     stepLarge      : number = 5 @label "Large Step" @description "Quantity added per press of the coarse add button." @tier "domain"
     stepSmall      : number = 1 @label "Small Step" @description "Quantity added per press of the fine add button, and per auto-drip tick — for precise control near a band boundary." @tier "domain"
+    summary        : string = "" @label "Concept" @description "One line under the title saying what the learner is looking at (keep it under ~65 characters). Empty shows no line." @tier "presentation"
     title          : string = "Doser" @label "Title" @description "Title shown above the instrument." @tier "presentation"
     unit           : string = "" @label "Unit" @description "Unit suffix appended to the step-size button labels (e.g. \"mL\", \"mg\", \"units\"); empty means no unit shown." @tier "domain"
     width          : number = 600 @label "Width" @description "Canvas width in pixels." @tier "presentation"
@@ -21678,7 +21705,7 @@ trait std-learn-estimate.traits.EstimateSim {
   category       : interaction
   states         : (idle*)
   events         : (INIT MODE_SELECTED SET_ESTIMATE LOCK_IN NEXT RETRY ESTIMATE_JUDGED PROMPT_ADVANCED ROUND_RESTARTED LEARN_ROUND_COMPLETE)
-  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on SET_ESTIMATE) (idle -> idle on LOCK_IN) (idle -> idle on NEXT) (idle -> idle on RETRY))
+  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on SET_ESTIMATE) (idle -> idle on LOCK_IN) (idle -> idle on NEXT) (idle -> idle on RETRY))
   emits          : (ESTIMATE_JUDGED PROMPT_ADVANCED ROUND_RESTARTED LEARN_ROUND_COMPLETE)
   config {
     closePct       : number = 0.25 @label "Close Band" @description "Relative error at or below this fraction (but above the exact band) counts as close (partial points)." @tier "domain"
@@ -21694,6 +21721,7 @@ trait std-learn-estimate.traits.EstimateSim {
     sliderMax      : number = 500 @label "Slider Max" @description "Upper bound of the estimate slider." @tier "domain"
     sliderMin      : number = 0 @label "Slider Min" @description "Lower bound of the estimate slider." @tier "domain"
     sliderStep     : number = 0.1 @label "Slider Step" @tier "presentation"
+    summary        : string = "" @label "Concept" @description "One line under the title saying what the learner is looking at (keep it under ~65 characters). Empty shows no line." @tier "presentation"
     title          : string = "Estimate It" @label "Title" @description "Title shown above the drill." @tier "presentation"
   }
   override-surface : (linkedEntity name events effects listens emitsScope config)
@@ -21731,7 +21759,7 @@ trait std-learn-goal-seek.traits.GoalSeekSim {
   category       : interaction
   states         : (idle*)
   events         : (INIT MODE_SELECTED SET_PARAM_A SET_PARAM_B CHECK RESET PARAMS_CHANGED GOAL_CHECKED GOAL_RESET LEARN_ROUND_COMPLETE)
-  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on SET_PARAM_A) (idle -> idle on SET_PARAM_B) (idle -> idle on CHECK) (idle -> idle on RESET))
+  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on SET_PARAM_A) (idle -> idle on SET_PARAM_B) (idle -> idle on CHECK) (idle -> idle on RESET))
   emits          : (PARAMS_CHANGED GOAL_CHECKED GOAL_RESET LEARN_ROUND_COMPLETE)
   config {
     checkLabel     : string = "Check" @label "Check Label" @tier "presentation"
@@ -21739,7 +21767,7 @@ trait std-learn-goal-seek.traits.GoalSeekSim {
     goalText       : string = "Tune the two sliders until your curve matches the target curve, then press Check." @label "Goal Text" @description "One-sentence statement of the inverse problem the learner must solve." @tier "domain"
     gridStep       : number = 1 @label "Grid Step" @tier "presentation"
     height         : number = 400 @label "Height" @tier "presentation"
-    learnerColor   : string = "#3b82f6" @label "Learner Color" @tier "presentation"
+    learnerColor   : string = "series-2" @label "Learner Color" @tier "presentation"
     learnerLabel   : string = "Yours" @label "Learner Label" @tier "presentation"
     matchMode      : string = "" @label "Match Mode" @description "When composed behind a lab router, the MODE_SELECTED mode value this instrument responds to. Empty string means standalone — render immediately on INIT." @tier "presentation"
     paramADefault  : number = 1 @label "Parameter A Default" @description "Starting value of the learner's first parameter." @tier "domain"
@@ -21755,9 +21783,10 @@ trait std-learn-goal-seek.traits.GoalSeekSim {
     showAxes       : boolean = true @label "Show Axes" @tier "presentation"
     showGrid       : boolean = true @label "Show Grid" @tier "presentation"
     showLiveDistance : boolean = true @label "Show Live Distance" @description "When true the RMS distance updates live as the learner tunes (warmer/colder); when false only attempts are shown, for a harder variant." @tier "domain"
+    summary        : string = "" @label "Concept" @description "One line under the title saying what the learner is looking at (keep it under ~65 characters). Empty shows no line." @tier "presentation"
     targetA        : number = 2.5 @label "Target A" @description "Hidden first parameter of the target curve the learner must recover." @tier "domain"
     targetB        : number = 1.5 @label "Target B" @description "Hidden second parameter of the target curve the learner must recover." @tier "domain"
-    targetColor    : string = "#94a3b8" @label "Target Color" @tier "presentation"
+    targetColor    : string = "guide" @label "Target Color" @tier "presentation"
     targetLabel    : string = "Target" @label "Target Label" @tier "presentation"
     title          : string = "Goal Seek" @label "Title" @description "Title shown above the canvas." @tier "presentation"
     tolerance      : number = 0.35 @label "Tolerance" @description "Maximum RMS distance between learner and target curves that still counts as a match." @tier "domain"
@@ -21775,28 +21804,29 @@ trait std-learn-grid-sim.traits.GridSimSim {
   linkedEntity   : GridSimScene
   category       : interaction
   states         : (idle*)
-  events         : (INIT MODE_SELECTED RUN PAUSE STEP TAP_CELL RESET RUN_TOGGLED GRID_STEPPED CELL_TOGGLED GRID_RESET)
-  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on RUN) (idle -> idle on PAUSE) (idle -> idle on STEP) (idle -> idle on TAP_CELL) (idle -> idle on RESET))
+  events         : (INIT MODE_SELECTED TOGGLE_RUN SPEED_SET RUN PAUSE STEP TAP_CELL RESET RUN_TOGGLED GRID_STEPPED CELL_TOGGLED GRID_RESET)
+  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on TOGGLE_RUN) (idle -> idle on SPEED_SET) (idle -> idle on RUN) (idle -> idle on PAUSE) (idle -> idle on STEP) (idle -> idle on TAP_CELL) (idle -> idle on RESET))
   emits          : (RUN_TOGGLED GRID_STEPPED CELL_TOGGLED GRID_RESET)
   config {
     autoRun        : boolean = false @label "Auto Run" @description "Whether the evolution starts running immediately on load." @tier "domain"
-    backgroundColor : string = "#f8fafc" @label "Background Color" @tier "presentation"
+    backgroundColor : string = "" @label "Background Color" @description "Canvas ground override; empty uses the theme's drawing ground." @tier "presentation"
     cellSize       : number = 26 @label "Cell Size" @tier "presentation"
     cols           : number = 16 @label "Columns" @tier "domain"
     decay          : number = 0.995 @label "Decay" @description "Diffusion rule only: fraction of a cell's value retained each generation." @tier "domain"
     diffuseRate    : number = 0.5 @label "Diffuse Rate" @description "Diffusion rule only: how strongly a cell moves toward its neighbourhood average each generation." @tier "domain"
     height         : number = 332 @label "Height" @tier "presentation"
-    lowColor       : string = "#bfdbfe" @label "Low Color" @tier "presentation"
+    lowColor       : string = "muted" @label "Low Color" @tier "presentation"
     matchMode      : string = "" @label "Match Mode" @description "When composed behind a lab router, the MODE_SELECTED mode value this instrument responds to. Empty string means standalone — render immediately on INIT." @tier "presentation"
-    midColor       : string = "#60a5fa" @label "Mid Color" @tier "presentation"
-    offColor       : string = "#e2e8f0" @label "Off Color" @tier "presentation"
-    onColor        : string = "#1d4ed8" @label "On Color" @tier "presentation"
+    midColor       : string = "series-3" @label "Mid Color" @tier "presentation"
+    offColor       : string = "fill" @label "Off Color" @tier "presentation"
+    onColor        : string = "series-2" @label "On Color" @tier "presentation"
     rows           : number = 12 @label "Rows" @tier "domain"
     rule           : string = "life" @label "Rule" @description "The local update rule: life (Conway birth-3 survive-2-3), spread (an active 4-neighbour activates a cell), or diffusion (cells relax toward the neighbourhood average with decay)." @synonyms "game of life, contagion, wavefront, heat diffusion, cellular automaton rule" @tier "domain"
     seeds          : [number] = [1,18,32,33,34,88,89,90] @label "Seeds" @description "Flat cell indexes (row·cols + col) active at the start — the default plants a glider and a blinker. Realizations declare their own starting pattern here." @tier "domain"
     stepLabel      : string = "Step" @label "Step Label" @tier "presentation"
+    summary        : string = "" @label "Concept" @description "One line under the title saying what the learner is looking at (keep it under ~65 characters). Empty shows no line." @tier "presentation"
     taskText       : string = "Tap cells to seed the world, then Run — or Step one generation at a time to see the rule at work." @label "Task Text" @description "One-sentence statement of what to explore." @tier "domain"
-    title          : string = "Grid World" @label "Title" @description "Title shown above the grid." @tier "presentation"
+    title          : string = "Grid World" @label "Title" @description "The instrument's name, the header's one hero." @tier "presentation"
     width          : number = 436 @label "Width" @tier "presentation"
   }
   override-surface : (linkedEntity name events effects listens emitsScope config)
@@ -21810,17 +21840,18 @@ trait std-learn-hotspot.traits.HotspotSim {
   category       : interaction
   states         : (idle*)
   events         : (INIT MODE_SELECTED TAP_SHAPE NEXT RETRY TAP_JUDGED PROMPT_ADVANCED ROUND_RESTARTED LEARN_ROUND_COMPLETE)
-  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on TAP_SHAPE) (idle -> idle on NEXT) (idle -> idle on RETRY))
+  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on TAP_SHAPE) (idle -> idle on NEXT) (idle -> idle on RETRY))
   emits          : (TAP_JUDGED PROMPT_ADVANCED ROUND_RESTARTED LEARN_ROUND_COMPLETE)
   config {
-    backgroundColor : string = "#f8fafc" @label "Background Color" @tier "presentation"
+    backgroundColor : string = "" @label "Background Color" @tier "presentation"
     height         : number = 380 @label "Height" @tier "presentation"
-    hitColor       : string = "#16a34a" @label "Hit Ring Color" @description "Color of the highlight ring drawn around the target once found." @tier "presentation"
+    hitColor       : string = "success" @label "Hit Ring Color" @description "Color of the highlight ring drawn around the target once found." @tier "presentation"
     matchMode      : string = "" @label "Match Mode" @description "When composed behind a lab router, the MODE_SELECTED mode value this instrument responds to. Empty string means standalone — render immediately on INIT." @tier "presentation"
     nextLabel      : string = "Next" @label "Next Label" @tier "presentation"
     prompts        : [HotspotPrompt] = [{"explanation":"The nucleus holds the DNA.","prompt":"Tap the part that stores the cell's genetic material.","targetId":"nucleus"},{"explanation":"Mitochondria run cellular respiration.","prompt":"Tap the part that produces the cell's energy.","targetId":"mitochondrion"},{"explanation":"Ribosomes translate mRNA into protein.","prompt":"Tap the part that builds proteins.","targetId":"ribosome"}] @label "Prompts" @description "The question roster; each prompt names a target hotspot id and an explanation revealed on a hit." @tier "domain"
     retryLabel     : string = "Try Again" @label "Retry Label" @tier "presentation"
-    shapes         : [HotspotShape] = [{"color":"#8b5cf6","id":"nucleus","label":"Nucleus","radius":34,"x":300,"y":170},{"color":"#3b82f6","id":"membrane","label":"Membrane","radius":26,"x":130,"y":120},{"color":"#f59e0b","id":"mitochondrion","label":"Mitochondrion","radius":24,"x":460,"y":120},{"color":"#16a34a","id":"ribosome","label":"Ribosome","radius":18,"x":200,"y":280},{"color":"#06b6d4","id":"vacuole","label":"Vacuole","radius":28,"x":420,"y":280}] @label "Hotspots" @description "The labeled parts of the scene; each carries an id, display label, canvas position, radius, and color. Realizations declare their own subject's parts here." @tier "domain"
+    shapes         : [HotspotShape] = [{"color":"series-1","id":"nucleus","label":"Nucleus","radius":34,"x":300,"y":170},{"color":"series-2","id":"membrane","label":"Membrane","radius":26,"x":130,"y":120},{"color":"series-3","id":"mitochondrion","label":"Mitochondrion","radius":24,"x":460,"y":120},{"color":"series-4","id":"ribosome","label":"Ribosome","radius":18,"x":200,"y":280},{"color":"series-5","id":"vacuole","label":"Vacuole","radius":28,"x":420,"y":280}] @label "Hotspots" @description "The labeled parts of the scene; each carries an id, display label, canvas position, radius, and color. Realizations declare their own subject's parts here." @tier "domain"
+    summary        : string = "" @label "Concept" @description "One line under the title saying what is being identified (keep it under ~65 characters). Empty shows no line." @tier "presentation"
     title          : string = "Tap the Part" @label "Title" @description "Title shown above the canvas." @tier "presentation"
     width          : number = 600 @label "Width" @tier "presentation"
   }
@@ -21834,12 +21865,12 @@ trait std-learn-live-sim.traits.LiveSimSim {
   linkedEntity   : LiveSimScene
   category       : interaction
   states         : (idle*)
-  events         : (INIT MODE_SELECTED RUN PAUSE RESET SET_GRAVITY SET_DAMPING RUN_TOGGLED SIM_RESET)
-  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on RUN) (idle -> idle on PAUSE) (idle -> idle on RESET) (idle -> idle on SET_GRAVITY) (idle -> idle on SET_DAMPING))
+  events         : (INIT MODE_SELECTED TOGGLE_RUN RUN PAUSE RESET SET_GRAVITY SET_DAMPING RUN_TOGGLED SIM_RESET)
+  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on TOGGLE_RUN) (idle -> idle on RUN) (idle -> idle on PAUSE) (idle -> idle on RESET) (idle -> idle on SET_GRAVITY) (idle -> idle on SET_DAMPING))
   emits          : (RUN_TOGGLED SIM_RESET)
   config {
-    backgroundColor : string = "#f8fafc" @label "Background Color" @tier "presentation"
-    bodies         : [LiveSimBody] = [{"color":"#2563eb","id":"ball-a","radius":14,"vx":4,"vy":0,"x":100,"y":60},{"color":"#16a34a","id":"ball-b","radius":18,"vx":-3,"vy":2,"x":260,"y":90},{"color":"#f59e0b","id":"ball-c","radius":11,"vx":2,"vy":-1,"x":420,"y":40}] @label "Bodies" @description "Initial bodies; each carries position (x,y), radius, color, and velocity (vx,vy). Restored on Reset." @tier "presentation"
+    backgroundColor : string = "" @label "Background Color" @description "Canvas ground override; empty uses the theme's drawing ground." @tier "presentation"
+    bodies         : [LiveSimBody] = [{"color":"series-1","id":"ball-a","radius":14,"vx":4,"vy":0,"x":100,"y":60},{"color":"series-2","id":"ball-b","radius":18,"vx":-3,"vy":2,"x":260,"y":90},{"color":"series-3","id":"ball-c","radius":11,"vx":2,"vy":-1,"x":420,"y":40}] @label "Bodies" @description "Initial bodies; each carries position (x,y), radius, color, and velocity (vx,vy). Restored on Reset." @tier "presentation"
     damping        : number = 0.995 @label "Damping" @description "Initial fraction of velocity retained each tick (air resistance); adjustable live via the Damping slider." @tier "domain"
     gravity        : number = 0.4 @label "Gravity" @description "Initial downward acceleration added to each body's vy every tick; adjustable live via the Gravity slider." @tier "domain"
     height         : number = 400 @label "Height" @description "Simulation height in pixels; bounds the bounce." @tier "presentation"
@@ -21847,7 +21878,8 @@ trait std-learn-live-sim.traits.LiveSimSim {
     restitution    : number = 0.78 @label "Restitution" @description "Fraction of speed kept when a body bounces off a wall." @tier "domain"
     running        : boolean = false @label "Running" @description "Whether the simulation starts already running on INIT." @tier "domain"
     showVelocity   : boolean = true @label "Show Velocity" @description "Draw each body's velocity vector as an arrow." @tier "presentation"
-    title          : string = "Live Sim" @label "Title" @description "Title shown above the instrument." @tier "presentation"
+    summary        : string = "" @label "Concept" @description "One line under the title saying what the learner is looking at (keep it under ~65 characters). Empty shows no line." @tier "presentation"
+    title          : string = "Live Sim" @label "Title" @description "The instrument's name, the header's one hero." @tier "presentation"
     velocityScale  : number = 8 @label "Velocity Scale" @description "Length multiplier for the velocity arrows." @tier "presentation"
     width          : number = 600 @label "Width" @description "Simulation width in pixels; bounds the bounce." @tier "presentation"
   }
@@ -21861,8 +21893,8 @@ trait std-learn-measure.traits.MeasureSim {
   linkedEntity   : MeasureScene
   category       : interaction
   states         : (idle*)
-  events         : (INIT MODE_SELECTED RUN PAUSE PROBE RESET RUN_TOGGLED PROBE_RECORDED MEASURE_RESET)
-  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on RUN) (idle -> idle on PAUSE) (idle -> idle on PROBE) (idle -> idle on RESET))
+  events         : (INIT MODE_SELECTED TOGGLE_RUN SPEED_SET RUN PAUSE PROBE RESET RUN_TOGGLED PROBE_RECORDED MEASURE_RESET)
+  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on TOGGLE_RUN) (idle -> idle on SPEED_SET) (idle -> idle on RUN) (idle -> idle on PAUSE) (idle -> idle on PROBE) (idle -> idle on RESET))
   emits          : (RUN_TOGGLED PROBE_RECORDED MEASURE_RESET)
   config {
     amplitude      : number = 5 @label "Amplitude" @description "The A parameter: the signal's scale." @tier "domain"
@@ -21870,13 +21902,14 @@ trait std-learn-measure.traits.MeasureSim {
     gridStep       : number = 1 @label "Grid Step" @tier "presentation"
     height         : number = 360 @label "Height" @tier "presentation"
     matchMode      : string = "" @label "Match Mode" @description "When composed behind a lab router, the MODE_SELECTED mode value this instrument responds to. Empty string means standalone — render immediately on INIT." @tier "presentation"
-    probeColor     : string = "#dc2626" @label "Probe Color" @tier "presentation"
+    probeColor     : string = "highlight" @label "Probe Color" @tier "presentation"
     probeLabel     : string = "Probe" @label "Probe Label" @tier "presentation"
     rate           : number = 1.2 @label "Rate" @description "The B parameter: angular rate for sine, growth rate for growth, half-life in seconds for decay." @tier "domain"
-    signalColor    : string = "#94a3b8" @label "Signal Color" @tier "presentation"
+    signalColor    : string = "ink" @label "Signal Color" @tier "presentation"
     signalKind     : string = "sine" @label "Signal Kind" @description "How the measured quantity evolves: sine (A·sin(B·t)), growth (A·(1+B)ᵗ), or decay (half-life A·(1/2)^(t/B))." @synonyms "signal family, oscillation, exponential growth, half-life decay" @tier "domain"
+    summary        : string = "" @label "Concept" @description "One line under the title saying what the learner is looking at (keep it under ~65 characters). Empty shows no line." @tier "presentation"
     taskText       : string = "Run the signal, then press Probe to record measurements. Watch the running mean settle." @label "Task Text" @description "One-sentence statement of the measuring task." @tier "domain"
-    title          : string = "Measurement Lab" @label "Title" @description "Title shown above the experiment." @tier "presentation"
+    title          : string = "Measurement Lab" @label "Title" @description "The instrument's name, the header's one hero." @tier "presentation"
     valueLabel     : string = "value" @label "Value Label" @description "Display name of the measured quantity." @tier "presentation"
     valueMax       : number = 6 @label "Value Max" @description "Upper bound of the chart's y axis." @tier "presentation"
     valueMin       : number = -6 @label "Value Min" @description "Lower bound of the chart's y axis." @tier "presentation"
@@ -21893,11 +21926,11 @@ trait std-learn-param-explorer.traits.ParamExplorerSim {
   category       : interaction
   states         : (idle*)
   events         : (INIT MODE_SELECTED SET_PARAM_A SET_PARAM_B PARAMS_CHANGED)
-  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on SET_PARAM_A) (idle -> idle on SET_PARAM_B))
+  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on SET_PARAM_A) (idle -> idle on SET_PARAM_B))
   emits          : (PARAMS_CHANGED)
   config {
     animate        : boolean = false @label "Animate" @tier "presentation"
-    color          : string = "#3b82f6" @label "Curve Color" @tier "presentation"
+    color          : string = "series-2" @label "Curve Color" @tier "presentation"
     curveKind      : string = "power" @label "Curve Kind" @description "Curve family the two parameters drive: power (y = A·xᴮ), linear (y = A + B·x), or sine (y = A·sin(B·x))." @synonyms "curve family, power law, linear function, sine wave, function type" @tier "domain"
     gridStep       : number = 1 @label "Grid Step" @tier "presentation"
     height         : number = 400 @label "Height" @tier "presentation"
@@ -21915,6 +21948,7 @@ trait std-learn-param-explorer.traits.ParamExplorerSim {
     paramBStep     : number = 0.1 @label "Parameter B Step" @description "Slider increment for the second parameter." @tier "presentation"
     showAxes       : boolean = true @label "Show Axes" @tier "presentation"
     showGrid       : boolean = true @label "Show Grid" @tier "presentation"
+    summary        : string = "" @label "Concept" @description "One line under the title saying what the learner is looking at (keep it under ~65 characters). Empty shows no line." @tier "presentation"
     title          : string = "Parameter Explorer" @label "Title" @description "Title shown above the canvas." @tier "presentation"
     width          : number = 600 @label "Width" @tier "presentation"
     xMax           : number = 10 @label "X Max" @description "Right edge of the sampled x range." @tier "presentation"
@@ -21930,8 +21964,8 @@ trait std-learn-perturb.traits.PerturbSim {
   linkedEntity   : PerturbScene
   category       : interaction
   states         : (idle*)
-  events         : (INIT MODE_SELECTED RUN PAUSE RESET SET_POINT SET_RATE SHOCK RUN_TOGGLED SIM_RESET SETPOINT_CHANGED RATE_CHANGED SHOCK_APPLIED)
-  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on RUN) (idle -> idle on PAUSE) (idle -> idle on RESET) (idle -> idle on SET_POINT) (idle -> idle on SET_RATE) (idle -> idle on SHOCK))
+  events         : (INIT MODE_SELECTED TOGGLE_RUN SPEED_SET RUN PAUSE RESET SET_POINT SET_RATE SHOCK RUN_TOGGLED SIM_RESET SETPOINT_CHANGED RATE_CHANGED SHOCK_APPLIED)
+  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on TOGGLE_RUN) (idle -> idle on SPEED_SET) (idle -> idle on RUN) (idle -> idle on PAUSE) (idle -> idle on RESET) (idle -> idle on SET_POINT) (idle -> idle on SET_RATE) (idle -> idle on SHOCK))
   emits          : (RUN_TOGGLED SIM_RESET SETPOINT_CHANGED RATE_CHANGED SHOCK_APPLIED)
   config {
     autoRun        : boolean = true @label "Auto Run" @description "Whether the simulation starts running immediately on load." @tier "domain"
@@ -21944,7 +21978,7 @@ trait std-learn-perturb.traits.PerturbSim {
     rateMax        : number = 3 @label "Rate Max" @tier "domain"
     rateMin        : number = 0.05 @label "Rate Min" @tier "domain"
     rateStep       : number = 0.05 @label "Rate Step" @tier "presentation"
-    setpointColor  : string = "#94a3b8" @label "Setpoint Color" @tier "presentation"
+    setpointColor  : string = "guide" @label "Setpoint Color" @tier "presentation"
     setpointDefault : number = 37 @label "Setpoint Default" @tier "domain"
     setpointLabel  : string = "Setpoint" @label "Setpoint Label" @description "Display name of the equilibrium target." @tier "domain"
     setpointMax    : number = 44 @label "Setpoint Max" @tier "domain"
@@ -21953,9 +21987,10 @@ trait std-learn-perturb.traits.PerturbSim {
     shockDownLabel : string = "− Shock down" @label "Shock Down Label" @tier "presentation"
     shockSize      : number = 4 @label "Shock Size" @description "How far a shock button knocks the quantity from its current value." @tier "domain"
     shockUpLabel   : string = "+ Shock up" @label "Shock Up Label" @tier "presentation"
+    summary        : string = "" @label "Concept" @description "One line under the title saying what the learner is looking at (keep it under ~65 characters). Empty shows no line." @tier "presentation"
     taskText       : string = "Run the system, shock it off its setpoint, and watch it recover — then move the setpoint mid-run." @label "Task Text" @description "One-sentence statement of what to explore." @tier "domain"
-    title          : string = "Equilibrium & Shock" @label "Title" @description "Title shown above the simulation." @tier "presentation"
-    valueColor     : string = "#dc2626" @label "Value Color" @tier "presentation"
+    title          : string = "Equilibrium & Shock" @label "Title" @description "The instrument's name, the header's one hero." @tier "presentation"
+    valueColor     : string = "highlight" @label "Value Color" @tier "presentation"
     valueLabel     : string = "Temperature" @label "Value Label" @description "Display name of the regulated quantity." @tier "domain"
     valueMax       : number = 46 @label "Value Max" @description "Upper bound of the chart's y axis." @tier "presentation"
     valueMin       : number = 28 @label "Value Min" @description "Lower bound of the chart's y axis." @tier "presentation"
@@ -21973,7 +22008,7 @@ trait std-learn-predict.traits.PredictSim {
   category       : interaction
   states         : (idle*)
   events         : (INIT MODE_SELECTED PREDICT NEXT RETRY PREDICTION_COMMITTED SCENARIO_ADVANCED ROUND_RESTARTED LEARN_ROUND_COMPLETE)
-  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on PREDICT) (idle -> idle on NEXT) (idle -> idle on RETRY))
+  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on PREDICT) (idle -> idle on NEXT) (idle -> idle on RETRY))
   emits          : (PREDICTION_COMMITTED SCENARIO_ADVANCED ROUND_RESTARTED LEARN_ROUND_COMPLETE)
   config {
     gridStep       : number = 25 @label "Grid Step" @tier "presentation"
@@ -21981,9 +22016,10 @@ trait std-learn-predict.traits.PredictSim {
     matchMode      : string = "" @label "Match Mode" @description "When composed behind a lab router, the MODE_SELECTED mode value this instrument responds to. Empty string means standalone — render immediately on INIT." @tier "presentation"
     nextLabel      : string = "Next" @label "Next Label" @tier "presentation"
     retryLabel     : string = "Try Again" @label "Retry Label" @tier "presentation"
-    revealColor    : string = "#3b82f6" @label "Reveal Color" @tier "presentation"
+    revealColor    : string = "series-1" @label "Reveal Color" @tier "presentation"
     revealLabel    : string = "Outcome" @label "Reveal Label" @tier "presentation"
     scenarios      : [PredictScenario] = [{"correctIndex":1,"explanation":"With no limiting factor yet, growth compounds each season.","frames":[{"caption":"Season 1: 40 rabbits","value":40},{"caption":"Season 2: 52 rabbits","value":52},{"caption":"Season 3: 68 rabbits","value":68},{"caption":"Season 4: 88 rabbits","value":88},{"caption":"Season 5: 114 rabbits","value":114},{"caption":"Season 6: 148 rabbits — still accelerating","value":148}],"options":["It levels off","It keeps accelerating","It collapses"],"question":"What happens to the population over the next six seasons?","setup":"A small island hosts 40 rabbits with unlimited grass and no predators."},{"correctIndex":1,"explanation":"Predation and food limits impose a carrying capacity.","frames":[{"caption":"Season 1: 148 rabbits","value":148},{"caption":"Season 2: 160 rabbits","value":160},{"caption":"Season 3: 166 rabbits","value":166},{"caption":"Season 4: 169 rabbits","value":169},{"caption":"Season 5: 170 rabbits — the curve flattens","value":170}],"options":["It keeps accelerating","It levels off near a ceiling","It grows linearly"],"question":"What happens to the rabbit population now?","setup":"The same island now has foxes, and grass is running short."}] @label "Scenarios" @description "The scenario roster; each carries a setup, the question, the offered predictions with the correct index, an explanation, and the reveal frames (caption + value) that play out after the learner commits. Realizations declare their own subject's scenarios here." @tier "domain"
+    summary        : string = "" @label "Concept" @description "One line under the title saying what is being predicted (keep it under ~65 characters). Empty shows no line." @tier "presentation"
     title          : string = "Predict, Then Watch" @label "Title" @description "Title shown above the instrument." @tier "presentation"
     valueMax       : number = 200 @label "Value Max" @description "Upper bound of the reveal chart's y axis." @tier "presentation"
     valueMin       : number = 0 @label "Value Min" @description "Lower bound of the reveal chart's y axis." @tier "presentation"
@@ -22000,17 +22036,18 @@ trait std-learn-sample-accumulator.traits.SampleAccumulatorSim {
   category       : interaction
   states         : (idle*)
   events         : (INIT MODE_SELECTED DRAW SET_BATCH_SIZE RESET SAMPLES_DRAWN ACCUMULATOR_RESET)
-  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on DRAW) (idle -> idle on SET_BATCH_SIZE) (idle -> idle on RESET))
+  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on DRAW) (idle -> idle on SET_BATCH_SIZE) (idle -> idle on RESET))
   emits          : (SAMPLES_DRAWN ACCUMULATOR_RESET)
   config {
     batchSize      : number = 25 @label "Batch Size" @description "Number of samples the Draw button adds per click." @synonyms "batch size, draws per click, sample batch" @tier "domain"
     bias           : number = 0.5 @label "Bias" @description "Probability the coin source draws 1, used only when sourceKind is coin." @synonyms "probability, bernoulli parameter, coin bias, p" @tier "domain"
     binCount       : number = 10 @label "Bin Count" @description "Number of histogram buckets across the 0..1 value range." @tier "presentation"
-    color          : string = "#2563eb" @label "Bar Color" @tier "presentation"
+    color          : string = "series-1" @label "Bar Color" @tier "presentation"
     height         : number = 400 @label "Height" @tier "presentation"
     matchMode      : string = "" @label "Match Mode" @description "When composed behind a lab router, the MODE_SELECTED mode value this instrument responds to. Empty string means standalone — render immediately on INIT." @tier "presentation"
     sourceKind     : string = "uniform" @label "Source Kind" @description "Distribution each draw samples from: uniform (0..1) or coin (Bernoulli 0/1 weighted by bias)." @synonyms "uniform distribution, coin flip, bernoulli trial, random sampling, source distribution" @tier "domain"
-    title          : string = "Sample Accumulator" @label "Title" @description "Title shown above the canvas." @tier "presentation"
+    summary        : string = "" @label "Concept" @description "One line under the title saying what the learner is looking at (keep it under ~65 characters). Empty shows no line." @tier "presentation"
+    title          : string = "Sample Accumulator" @label "Title" @description "The instrument's name, the header's one hero." @tier "presentation"
     width          : number = 600 @label "Width" @tier "presentation"
   }
   override-surface : (linkedEntity name events effects listens emitsScope config)
@@ -22024,16 +22061,16 @@ trait std-learn-sandbox.traits.LearnSandboxSim {
   category       : interaction
   states         : (idle*)
   events         : (INIT MODE_SELECTED TOGGLE RESET SYSTEM_CHANGED SANDBOX_RESET)
-  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on TOGGLE) (idle -> idle on RESET))
+  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on TOGGLE) (idle -> idle on RESET))
   emits          : (SYSTEM_CHANGED SANDBOX_RESET)
   config {
     animate        : boolean = false @label "Animate" @description "Enable continuous redraw loop." @tier "presentation"
-    backgroundColor : string = "#f8fafc" @label "Background Color" @tier "presentation"
-    disabledColor  : string = "#cbd5e1" @label "Disabled Node Color" @tier "presentation"
-    disabledEdgeColor : string = "#e2e8f0" @label "Disabled Edge Color" @tier "presentation"
+    backgroundColor : string = "" @label "Background Color" @tier "presentation"
+    disabledColor  : string = "muted" @label "Disabled Node Color" @tier "presentation"
+    disabledEdgeColor : string = "guide" @label "Disabled Edge Color" @tier "presentation"
     elements       : [LearnSandboxElement] = [{"enabled":true,"id":"a","label":"Module A","weight":15,"x":100,"y":80},{"enabled":true,"id":"b","label":"Module B","weight":20,"x":300,"y":60},{"enabled":false,"id":"c","label":"Module C","weight":10,"x":500,"y":80},{"enabled":true,"id":"d","label":"Module D","weight":25,"x":200,"y":220},{"enabled":true,"id":"e","label":"Module E","weight":18,"x":420,"y":220}] @label "Elements" @description "Roster of toggleable elements; each carries its label, its weight toward the derived total, its default enabled state, and its canvas position." @synonyms "element, node, component, module, factor, contributor" @tier "domain"
-    enabledColor   : string = "#2563eb" @label "Enabled Node Color" @tier "presentation"
-    enabledEdgeColor : string = "#1e3a8a" @label "Enabled Edge Color" @tier "presentation"
+    enabledColor   : string = "series-2" @label "Enabled Node Color" @tier "presentation"
+    enabledEdgeColor : string = "ink" @label "Enabled Edge Color" @tier "presentation"
     height         : number = 320 @label "Height" @description "Canvas height in pixels." @tier "presentation"
     interactive    : boolean = false @label "Interactive" @description "Enable pointer interaction on the canvas." @tier "presentation"
     links          : [LearnSandboxLink] = [{"from":"a","to":"b"},{"from":"b","to":"c"},{"from":"a","to":"d"},{"from":"d","to":"e"}] @label "Links" @description "Declared relationships drawn between elements; a link dims when either endpoint is disabled." @synonyms "link, edge, connection, dependency, relationship" @tier "domain"
@@ -22041,6 +22078,7 @@ trait std-learn-sandbox.traits.LearnSandboxSim {
     nodeRadius     : number = 34 @label "Node Radius" @tier "presentation"
     outcomeLabel   : string = "System Status" @label "Outcome Label" @description "Label prefix used in the readout describing the derived total and hold status." @tier "presentation"
     resetLabel     : string = "Reset" @label "Reset Button Label" @tier "presentation"
+    summary        : string = "" @label "Concept" @description "One line under the title saying what the system models (keep it under ~65 characters). Empty shows no line." @tier "presentation"
     threshold      : number = 60 @label "Threshold" @description "The summed weight of enabled elements must reach this value for the system to hold." @synonyms "threshold, tipping point, sufficient total" @tier "domain"
     title          : string = "System Sandbox" @label "Title" @description "Title shown above the instrument." @tier "presentation"
     width          : number = 640 @label "Width" @description "Canvas width in pixels." @tier "presentation"
@@ -22056,7 +22094,7 @@ trait std-learn-scatter-fit.traits.LearnScatterFitSim {
   category       : interaction
   states         : (idle*)
   events         : (INIT MODE_SELECTED ADD_POINT DRAG_POINT GUESS_LINE REVEAL_FIT TOGGLE_RUN RESET LEARN_SCATTER_FIT_UPDATED LEARN_ROUND_COMPLETE)
-  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on ADD_POINT) (idle -> idle on DRAG_POINT) (idle -> idle on GUESS_LINE) (idle -> idle on REVEAL_FIT) (idle -> idle on TOGGLE_RUN) (idle -> idle on RESET))
+  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on ADD_POINT) (idle -> idle on DRAG_POINT) (idle -> idle on GUESS_LINE) (idle -> idle on REVEAL_FIT) (idle -> idle on TOGGLE_RUN) (idle -> idle on RESET))
   emits          : (LEARN_SCATTER_FIT_UPDATED LEARN_ROUND_COMPLETE)
   config {
     addPointLabel  : string = "Add Point" @label "Add Point Button Label" @tier "presentation"
@@ -22066,10 +22104,10 @@ trait std-learn-scatter-fit.traits.LearnScatterFitSim {
     axisXMin       : number = 0 @label "X Axis Min" @description "Lower bound of the canvas x axis, in data coordinates." @tier "domain"
     axisYMax       : number = 100 @label "Y Axis Max" @description "Upper bound of the canvas y axis; also the ceiling curve samples clamp to and the high end of the guess-intercept slider default range." @tier "domain"
     axisYMin       : number = 0 @label "Y Axis Min" @description "Lower bound of the canvas y axis; also the floor curve samples clamp to and the low end of the guess-intercept slider default range." @tier "domain"
-    fitColor       : string = "#2563eb" @label "Fit Curve Color" @tier "presentation"
+    fitColor       : string = "series-2" @label "Fit Curve Color" @tier "presentation"
     fitLabel       : string = "fit" @label "Fit Curve Label" @description "Legend label for the computed least-squares fit line." @tier "presentation"
     gridStep       : number = 20 @label "Grid Step" @description "Spacing between canvas gridlines, in data coordinates." @tier "presentation"
-    guessColor     : string = "#dc2626" @label "Guess Curve Color" @tier "presentation"
+    guessColor     : string = "series-3" @label "Guess Curve Color" @tier "presentation"
     guessInterceptCaption : string = "Guess intercept: " @label "Guess Intercept Caption" @description "Text prefixed to the current guess-intercept value above its slider." @tier "presentation"
     guessInterceptMax : number = 100 @label "Guess Intercept Max" @description "Upper bound of the guess-intercept slider; typically set to axisYMax." @tier "domain"
     guessInterceptMin : number = 0 @label "Guess Intercept Min" @description "Lower bound of the guess-intercept slider; typically set to axisYMin." @tier "domain"
@@ -22081,7 +22119,7 @@ trait std-learn-scatter-fit.traits.LearnScatterFitSim {
     guessSlopeMin  : number = -3 @label "Guess Slope Min" @description "Lower bound of the guess-slope slider." @tier "domain"
     guessSlopeStep : number = 0.05 @label "Guess Slope Step" @tier "domain"
     height         : number = 400 @label "Height" @description "Canvas height in pixels." @tier "presentation"
-    initialPoints  : [LearnScatterFitPoint] = [{"color":"#334155","id":"p0","label":"","radius":5,"x":15,"y":25},{"color":"#334155","id":"p1","label":"","radius":5,"x":32,"y":40},{"color":"#334155","id":"p2","label":"","radius":5,"x":48,"y":44},{"color":"#334155","id":"p3","label":"","radius":5,"x":63,"y":62},{"color":"#334155","id":"p4","label":"","radius":5,"x":80,"y":70}] @label "Initial Points" @description "Scatter points the canvas starts with, in axis data coordinates; Reset reseeds from this roster." @synonyms "seed points, dataset, scatter data, sample" @tier "domain"
+    initialPoints  : [LearnScatterFitPoint] = [{"color":"ink","id":"p0","label":"","radius":5,"x":15,"y":25},{"color":"ink","id":"p1","label":"","radius":5,"x":32,"y":40},{"color":"ink","id":"p2","label":"","radius":5,"x":48,"y":44},{"color":"ink","id":"p3","label":"","radius":5,"x":63,"y":62},{"color":"ink","id":"p4","label":"","radius":5,"x":80,"y":70}] @label "Initial Points" @description "Scatter points the canvas starts with, in axis data coordinates; Reset reseeds from this roster." @synonyms "seed points, dataset, scatter data, sample" @tier "domain"
     interactive    : boolean = true @label "Interactive" @description "Enable pointer interaction on the canvas — required for dragging points." @tier "presentation"
     matchMode      : string = "" @label "Match Mode" @description "When composed behind a lab router, the MODE_SELECTED mode value this instrument responds to. Empty string means standalone — render immediately on INIT." @tier "presentation"
     maxPoints      : number = 20 @label "Max Points" @description "Cap on accumulated scatter points; Add Point and the auto-run tick stop once reached, until Reset." @tier "domain"
@@ -22093,12 +22131,12 @@ trait std-learn-scatter-fit.traits.LearnScatterFitSim {
     narrationMaxReachedSuffix : string = " — max points reached" @label "Max Reached Narration Suffix" @description "Suffix appended to the added-point narration once maxPoints is hit." @tier "domain"
     narrationMovedTemplate : string = "point moved" @label "Moved Narration Template" @description "Narration phrase after a point is dragged, assembled as \"<template> — r = .., R² = ..\"." @tier "domain"
     narrationPausedTemplate : string = "Paused — add manually with Add Point." @label "Paused Narration" @description "Narration shown after Pause is pressed." @tier "domain"
-    newPointColor  : string = "#334155" @label "New Point Color" @description "Fill color assigned to points created by Add Point or the auto-add tick." @tier "presentation"
+    newPointColor  : string = "ink" @label "New Point Color" @description "Fill color assigned to points created by Add Point or the auto-add tick." @tier "presentation"
     newPointRadius : number = 5 @label "New Point Radius" @tier "presentation"
     pauseLabel     : string = "Pause" @label "Pause Button Label" @tier "presentation"
     pointMarginPct : number = 0.05 @label "Point Margin Percent" @description "Fraction of each axis span kept clear at both ends when Add Point/the tick place a new random point, so new points never land flush against the axis edge." @tier "domain"
     resetLabel     : string = "Reset" @label "Reset Button Label" @tier "presentation"
-    residualColor  : string = "#f59e0b" @label "Residual Color" @tier "presentation"
+    residualColor  : string = "guide" @label "Residual Color" @tier "presentation"
     residualDash   : string = "dashed" @label "Residual Dash Style" @tier "presentation" @values (dashed dotted)
     revealLabel    : string = "Reveal Fit" @label "Reveal Fit Button Label" @tier "presentation"
     runLabel       : string = "Run" @label "Run Button Label" @tier "presentation"
@@ -22107,6 +22145,7 @@ trait std-learn-scatter-fit.traits.LearnScatterFitSim {
     showR          : boolean = true @label "Show r and R²" @description "Show the correlation coefficient r and coefficient of determination R² under the canvas." @synonyms "correlation coefficient, r squared, goodness of fit" @tier "domain"
     showResiduals  : boolean = true @label "Show Residuals" @description "Draw a dashed segment from each point to the fit line — the errors least squares minimizes." @synonyms "residuals, errors, deviations" @tier "domain"
     showTickLabels : boolean = true @label "Show Tick Labels" @tier "presentation"
+    summary        : string = "" @label "Concept" @description "One line under the title saying what the learner is looking at (keep it under ~65 characters). Empty shows no line." @tier "presentation"
     title          : string = "Scatter Fit" @label "Title" @description "Title shown above the canvas." @tier "presentation"
     width          : number = 600 @label "Width" @description "Canvas width in pixels." @tier "presentation"
   }
@@ -22121,7 +22160,7 @@ trait std-learn-scenario.traits.ScenarioSim {
   category       : interaction
   states         : (idle*)
   events         : (INIT MODE_SELECTED CHOOSE RESTART CHOICE_MADE SCENARIO_RESTARTED)
-  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on CHOOSE) (idle -> idle on RESTART))
+  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on CHOOSE) (idle -> idle on RESTART))
   emits          : (CHOICE_MADE SCENARIO_RESTARTED)
   config {
     matchMode      : string = "" @label "Match Mode" @description "When composed behind a lab router, the MODE_SELECTED mode value this instrument responds to. Empty string means standalone — render immediately on INIT." @tier "presentation"
@@ -22132,6 +22171,7 @@ trait std-learn-scenario.traits.ScenarioSim {
     nodes          : [ScenarioNode] = [{"choices":[{"deltaA":-60,"deltaB":10,"label":"Build a levee now","next":"levee","note":"Fast protection, most of the budget gone."},{"deltaA":-25,"deltaB":-5,"label":"Restore the upstream wetlands","next":"wetlands","note":"Cheaper and greener, but slower to work."}],"id":"start","situation":"Your town's river floods every spring. The council asks you to lead the response."},{"choices":[{"deltaA":-30,"deltaB":-10,"label":"Raise the levee again","next":"end-lock-in","note":"Costs keep compounding."},{"deltaA":-20,"deltaB":15,"label":"Add wetlands as a second line","next":"end-hybrid","note":"Late, but it eases the pressure."}],"id":"levee","situation":"The levee holds the first spring, but silt builds up and the river rises higher each year."},{"choices":[{"deltaA":-15,"deltaB":25,"label":"Expand the wetland corridor","next":"end-green","note":"The town rallies behind the project."},{"deltaA":10,"deltaB":5,"label":"Bank the savings","next":"end-thrifty","note":"Prudent, though the corridor stays small."}],"id":"wetlands","situation":"Two springs pass; the wetlands now absorb most floods, and wildlife is returning."},{"choices":[],"id":"end-lock-in","situation":"You are locked into an arms race with the river: protected, but at ever-growing cost."},{"choices":[],"id":"end-hybrid","situation":"The hybrid defense works: the levee buys time and the wetlands cut the peak floods."},{"choices":[],"id":"end-green","situation":"The restored river corridor protects the town and becomes its most loved public space."},{"choices":[],"id":"end-thrifty","situation":"The town stays safe in normal years, with savings in reserve for a bigger flood."}] @label "Nodes" @description "The decision graph; each node carries a situation and its choices, each choice naming the next node, metric deltas, and a consequence note. A node with no choices ends the run. Realizations declare their own subject's decision tree here." @tier "domain"
     restartLabel   : string = "Play Again" @label "Restart Label" @tier "presentation"
     startId        : string = "start" @label "Start Node" @description "Id of the node the scenario opens on." @tier "domain"
+    summary        : string = "" @label "Concept" @description "One line under the title saying what the scenario explores (keep it under ~65 characters). Empty shows no line." @tier "presentation"
     title          : string = "Decision Scenario" @label "Title" @description "Title shown above the scenario." @tier "presentation"
   }
   override-surface : (linkedEntity name events effects listens emitsScope config)
@@ -22144,14 +22184,15 @@ trait std-learn-sim-3d.traits.Learn3DSimTransport {
   linkedEntity   : Learn3DSimScene
   category       : interaction
   states         : (idle*)
-  events         : (INIT MODE_SELECTED RUN PAUSE RESET SPEED_HALF SPEED_NORMAL SPEED_DOUBLE SPEED_QUAD SIM_3D_TICK SIM_3D_UPDATED)
-  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on RUN) (idle -> idle on PAUSE) (idle -> idle on RESET) (idle -> idle on SPEED_HALF) (idle -> idle on SPEED_NORMAL) (idle -> idle on SPEED_DOUBLE) (idle -> idle on SPEED_QUAD))
+  events         : (INIT MODE_SELECTED TOGGLE_RUN SPEED_SET RUN PAUSE RESET SPEED_HALF SPEED_NORMAL SPEED_DOUBLE SPEED_QUAD SIM_3D_TICK SIM_3D_UPDATED)
+  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on TOGGLE_RUN) (idle -> idle on SPEED_SET) (idle -> idle on RUN) (idle -> idle on PAUSE) (idle -> idle on RESET) (idle -> idle on SPEED_HALF) (idle -> idle on SPEED_NORMAL) (idle -> idle on SPEED_DOUBLE) (idle -> idle on SPEED_QUAD))
   emits          : (SIM_3D_TICK SIM_3D_UPDATED)
   config {
     dt             : number = 0.02 @label "Timestep" @description "Simulated seconds per tick before the speed multiplier; the effective step emitted on SIM_3D_TICK is dt x speedMultiplier." @tier "domain"
     matchMode      : string = "" @label "Match Mode" @description "When composed behind a lab router, the MODE_SELECTED mode value this instrument responds to. Empty string means standalone — render immediately on INIT." @tier "presentation"
     running        : boolean = true @label "Running" @description "When true the clock starts ticking on INIT; the Reset arm restores this value." @tier "domain"
-    title          : string = "3D Simulation" @label "Title" @description "Title shown above the transport controls." @tier "presentation"
+    summary        : string = "" @label "Concept" @description "One line under the title saying what the learner is looking at (keep it under ~65 characters). Empty shows no line." @tier "presentation"
+    title          : string = "3D Simulation" @label "Title" @description "The instrument's name, the header's one hero." @tier "presentation"
   }
   override-surface : (linkedEntity name events effects listens emitsScope config)
   source         : "@almadar/std (behaviors/registry/ui/learning/atoms/std-learn-sim-3d.orb orbitals[0].traits[0])"
@@ -22183,7 +22224,7 @@ trait std-learn-speed-drill.traits.SpeedDrillSim {
   category       : interaction
   states         : (idle*)
   events         : (INIT MODE_SELECTED ANSWER NEXT RETRY ANSWER_JUDGED PROMPT_ADVANCED ROUND_RESTARTED LEARN_ROUND_COMPLETE)
-  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on ANSWER) (idle -> idle on NEXT) (idle -> idle on RETRY))
+  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on ANSWER) (idle -> idle on NEXT) (idle -> idle on RETRY))
   emits          : (ANSWER_JUDGED PROMPT_ADVANCED ROUND_RESTARTED LEARN_ROUND_COMPLETE)
   config {
     basePoints     : number = 10 @label "Base Points" @description "Points for a correct answer regardless of speed." @tier "domain"
@@ -22192,6 +22233,7 @@ trait std-learn-speed-drill.traits.SpeedDrillSim {
     nextLabel      : string = "Next" @label "Next Label" @tier "presentation"
     retryLabel     : string = "Try Again" @label "Retry Label" @tier "presentation"
     speedBonus     : number = 10 @label "Speed Bonus" @description "Maximum extra points awarded in proportion to the time left on the clock." @tier "domain"
+    summary        : string = "" @label "Concept" @description "One line under the title saying what is being drilled (keep it under ~65 characters). Empty shows no line." @tier "presentation"
     timeLimit      : number = 6 @label "Time Limit" @description "Seconds the learner has to answer each item before it counts as a miss." @tier "domain"
     title          : string = "Speed Drill" @label "Title" @description "Title shown above the drill." @tier "presentation"
   }
@@ -22206,7 +22248,7 @@ trait std-learn-stepper.traits.LearnStepperSim {
   category       : interaction
   states         : (idle*)
   events         : (INIT MODE_SELECTED NEXT PREV FILTER_CATEGORY RESET_STEPPER STEPPER_ADVANCED)
-  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on NEXT) (idle -> idle on PREV) (idle -> idle on FILTER_CATEGORY) (idle -> idle on RESET_STEPPER))
+  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on NEXT) (idle -> idle on PREV) (idle -> idle on FILTER_CATEGORY) (idle -> idle on RESET_STEPPER))
   emits          : (STEPPER_ADVANCED)
   config {
     allLabel       : string = "All" @label "All Filter Label" @tier "presentation"
@@ -22216,8 +22258,8 @@ trait std-learn-stepper.traits.LearnStepperSim {
     axisMarginLeft : number = 60 @label "Axis Left Margin" @tier "presentation"
     axisMarginRight : number = 60 @label "Axis Right Margin" @tier "presentation"
     axisY          : number = 220 @label "Axis Y" @description "Canvas y-position of the horizontal axis." @tier "presentation"
-    backgroundColor : string = "#f8fafc" @label "Background Color" @tier "presentation"
-    categories     : [LearnStepperCategory] = [{"category":"a","color":"#7c3aed","label":"Category A"},{"category":"b","color":"#15803d","label":"Category B"}] @label "Categories" @description "Marker color and button label per stage category, used for the axis dots, the legend, the FILTER_CATEGORY buttons, and the running per-category tally." @synonyms "category color, category legend, stage category, filter lens" @tier "domain"
+    backgroundColor : string = "" @label "Background Color" @description "Canvas ground override; empty uses the theme's drawing ground." @tier "presentation"
+    categories     : [LearnStepperCategory] = [{"category":"a","color":"series-1","label":"Category A"},{"category":"b","color":"series-2","label":"Category B"}] @label "Categories" @description "Marker color and button label per stage category, used for the axis dots, the legend, the FILTER_CATEGORY buttons, and the running per-category tally." @synonyms "category color, category legend, stage category, filter lens" @tier "domain"
     categorySummaries : [LearnStepperCategorySummary] = [{"category":"a","summary":"Viewed through Category A alone, only the stages tagged A are highlighted."},{"category":"b","summary":"Viewed through Category B alone, only the stages tagged B are highlighted."}] @label "Category Summaries" @description "Narrative summary shown when the learner filters the sequence to a single category — how the sequence reads through that lens alone." @synonyms "historiographical lens, primary source lens, single-cause narrative, category narrative, visible thread" @tier "domain"
     height         : number = 420 @label "Height" @description "Canvas height in pixels." @tier "presentation"
     interactive    : boolean = false @label "Interactive" @description "Enable pointer interaction on the canvas." @tier "presentation"
@@ -22228,8 +22270,9 @@ trait std-learn-stepper.traits.LearnStepperSim {
     minPosition    : number = 0 @label "Min Position" @description "Earliest position on the axis (before the first stage)." @tier "domain"
     stages         : [LearnStepperStage] = [{"category":"a","description":"First stage in the sequence.","id":"stage-1","label":"Stage One","position":1},{"category":"b","description":"Second stage in the sequence.","id":"stage-2","label":"Stage Two","position":2},{"category":"a","description":"Third stage in the sequence.","id":"stage-3","label":"Stage Three","position":3}] @label "Stages" @description "Ordered roster of stages (position, label, category, description) stepped through by NEXT/PREV and filtered by FILTER_CATEGORY. Sorted ascending by position." @synonyms "stage roster, sequence, timeline, cycle, phase, event roster, ordered stages" @tier "domain"
     startPrompt    : string = "Press Next to begin." @label "Start Prompt" @description "Narration shown before the learner has advanced past the first stage." @tier "presentation"
-    title          : string = "Stepper" @label "Title" @description "Title shown above the instrument." @tier "presentation"
-    unreachedColor : string = "#d6d3d1" @label "Unreached Marker Color" @description "Color of stage markers the learner has not yet stepped to." @tier "presentation"
+    summary        : string = "" @label "Concept" @description "One line under the title saying what the learner is looking at (keep it under ~65 characters). Empty shows no line." @tier "presentation"
+    title          : string = "Stepper" @label "Title" @description "The instrument's name, the header's one hero." @tier "presentation"
+    unreachedColor : string = "muted" @label "Unreached Marker Color" @description "Color of stage markers the learner has not yet stepped to." @tier "presentation"
     width          : number = 640 @label "Width" @description "Canvas width in pixels." @tier "presentation"
   }
   override-surface : (linkedEntity name events effects listens emitsScope config)
@@ -22243,12 +22286,12 @@ trait std-learn-tour-3d.traits.Learn3DTourSim {
   category       : interaction
   states         : (idle*)
   events         : (INIT MODE_SELECTED TOUR SELECT_STATION RESET SYNC_STATIONS TOUR_3D_UPDATED LEARN_ROUND_COMPLETE)
-  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on TOUR) (idle -> idle on SELECT_STATION) (idle -> idle on RESET) (idle -> idle on SYNC_STATIONS))
+  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on TOUR) (idle -> idle on SELECT_STATION) (idle -> idle on RESET) (idle -> idle on SYNC_STATIONS))
   emits          : (TOUR_3D_UPDATED LEARN_ROUND_COMPLETE)
   config {
     azimuth        : number = 0.6 @label "Azimuth" @description "Camera orbit azimuth in radians; the learner can orbit freely on top of this." @tier "presentation"
     backdrop       : [Learn3DStation] = [] @label "Backdrop Nodes" @description "Non-station scene geometry rendered under the tour stations (painted first, stations on top) — painted but never tour stops and never highlight-selected; SYNC_STATIONS swaps it together with the roster, so a composed preset coordinator can re-skin the whole scene per preset." @synonyms "backdrop, scenery, geometry, context nodes, 3d" @tier "domain"
-    backgroundColor : string = "#0f172a" @label "Background Color" @description "Canvas background color — a dark stage makes translucent shells and station colors read in 3D." @tier "presentation"
+    backgroundColor : string = "" @label "Background Color" @description "Canvas ground. Empty uses the theme drawing ground." @tier "presentation"
     edges          : [Learn3DEdge] = [] @label "Edges" @description "Optional connector lines drawn between stations, by id." @synonyms "edge, link, connector, tether" @tier "domain"
     fov            : number = 50 @label "Field of View" @description "Perspective camera field of view in degrees." @tier "presentation"
     height         : number = 400 @label "Height" @description "Canvas height in pixels." @tier "presentation"
@@ -22256,9 +22299,10 @@ trait std-learn-tour-3d.traits.Learn3DTourSim {
     matchMode      : string = "" @label "Match Mode" @description "When composed behind a lab router, the MODE_SELECTED mode value this instrument responds to. Empty string means standalone — render immediately on INIT." @tier "presentation"
     post           : Post3D = {} @label "Post Processing" @description "3D post-processing stack (bloom/vignette) as data; empty object disables it." @tier "presentation"
     resetLabel     : string = "Reset" @label "Reset Button Label" @description "Label text for the button that returns the tour to the first station." @tier "presentation"
-    stations       : [Learn3DStation] = [{"caption":"The first stop on the tour — the camera retargets here and the narration reads its caption.","color":"#2563eb","id":"alpha","name":"Station Alpha","opacity":1,"radius":1,"shape":"sphere","x":0,"y":0,"z":0},{"caption":"The second stop — press Tour again or click a shape to advance the selection.","color":"#7c3aed","id":"beta","name":"Station Beta","opacity":1,"radius":0.8,"shape":"sphere","x":3,"y":1,"z":-1},{"caption":"The final stop — once every station has been visited the tour marks itself complete.","color":"#0891b2","id":"gamma","name":"Station Gamma","opacity":1,"radius":0.8,"shape":"sphere","x":-3,"y":-1,"z":1}] @label "Stations" @description "The station roster in didactic tour order — each with scene position, mesh shape, and a caption. Tour and clicks enlarge the selected station, retarget the camera onto its x/y/z, and narrate its caption." @synonyms "station, stop, waypoint, tour, landmark, 3d" @tier "domain"
+    stations       : [Learn3DStation] = [{"caption":"The first stop on the tour — the camera retargets here and the narration reads its caption.","color":"series-1","id":"alpha","name":"Station Alpha","opacity":1,"radius":1,"shape":"sphere","x":0,"y":0,"z":0},{"caption":"The second stop — press Tour again or click a shape to advance the selection.","color":"series-2","id":"beta","name":"Station Beta","opacity":1,"radius":0.8,"shape":"sphere","x":3,"y":1,"z":-1},{"caption":"The final stop — once every station has been visited the tour marks itself complete.","color":"series-3","id":"gamma","name":"Station Gamma","opacity":1,"radius":0.8,"shape":"sphere","x":-3,"y":-1,"z":1}] @label "Stations" @description "The station roster in didactic tour order — each with scene position, mesh shape, and a caption. Tour and clicks enlarge the selected station, retarget the camera onto its x/y/z, and narrate its caption." @synonyms "station, stop, waypoint, tour, landmark, 3d" @tier "domain"
+    summary        : string = "" @label "Concept" @description "One line under the title saying what the learner is looking at (keep it under ~65 characters). Empty shows no line." @tier "presentation"
     title          : string = "3D Guided Tour" @label "Title" @description "Title shown above the canvas." @tier "presentation"
-    tourLabel      : string = "Tour" @label "Tour Button Label" @description "Label text for the button that advances the tour to the next station." @tier "presentation"
+    tourLabel      : string = "Next station" @label "Tour Button Label" @description "Label text for the button that advances the tour to the next station." @tier "presentation"
     width          : number = 600 @label "Width" @description "Canvas width in pixels." @tier "presentation"
     zoom           : number = 1 @label "Zoom" @description "Camera zoom factor for the 3D scene." @tier "presentation"
   }
@@ -22272,19 +22316,20 @@ trait std-learn-trace-player.traits.TracePlayerSim {
   linkedEntity   : TracePlayerScene
   category       : interaction
   states         : (idle*)
-  events         : (INIT MODE_SELECTED PLAY PAUSE RESTART FRAME_ADVANCED TRACE_DONE)
-  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on PLAY) (idle -> idle on PAUSE) (idle -> idle on RESTART))
+  events         : (INIT MODE_SELECTED TOGGLE_RUN SPEED_SET PLAY PAUSE RESTART FRAME_ADVANCED TRACE_DONE)
+  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on TOGGLE_RUN) (idle -> idle on SPEED_SET) (idle -> idle on PLAY) (idle -> idle on PAUSE) (idle -> idle on RESTART))
   emits          : (FRAME_ADVANCED TRACE_DONE)
   config {
-    backgroundColor : string = "#f8fafc" @label "Background Color" @tier "presentation"
-    baseColor      : string = "#3b82f6" @label "Base Bar Color" @description "Color of bars not highlighted in the current frame." @tier "presentation"
+    backgroundColor : string = "" @label "Background Color" @description "Canvas ground override; empty uses the theme's drawing ground." @tier "presentation"
+    baseColor      : string = "series-1" @label "Base Bar Color" @description "Color of bars not highlighted in the current frame." @tier "presentation"
     frames         : [TraceFrame] = [{"caption":"Unsorted array.","highlights":[],"label":"Start","values":[5,3,8,1,9,2]},{"caption":"Compare the first two elements; 5 > 3 so swap them.","highlights":[0,1],"label":"Compare 5, 3","values":[3,5,8,1,9,2]},{"caption":"Compare the next pair; already in order.","highlights":[1,2],"label":"Compare 5, 8","values":[3,5,8,1,9,2]},{"caption":"8 > 1 so swap them.","highlights":[2,3],"label":"Compare 8, 1","values":[3,5,1,8,9,2]},{"caption":"Already in order.","highlights":[3,4],"label":"Compare 8, 9","values":[3,5,1,8,9,2]},{"caption":"9 > 2 so swap them; one pass complete.","highlights":[4,5],"label":"Compare 9, 2","values":[3,5,1,8,2,9]}] @label "Frames" @description "Ordered roster of frames (label, caption, values, highlights) stepped through by Play/Pause/Restart. Each frame's values render as bars; highlighted indices pick out which bars changed." @synonyms "trace, animation frames, snapshot roster, playback sequence, keyframes" @tier "domain"
     height         : number = 400 @label "Height" @description "Canvas height in pixels." @tier "presentation"
-    highlightColor : string = "#f59e0b" @label "Highlight Bar Color" @description "Color of bars whose index appears in the current frame's highlights." @tier "presentation"
+    highlightColor : string = "highlight" @label "Highlight Bar Color" @description "Color of bars whose index appears in the current frame's highlights." @tier "presentation"
     loop           : boolean = false @label "Loop" @description "When true, autoplay wraps from the last frame back to the first instead of stopping and emitting TRACE_DONE." @tier "domain"
     matchMode      : string = "" @label "Match Mode" @description "When composed behind a lab router, the MODE_SELECTED mode value this instrument responds to. Empty string means standalone — render immediately on INIT." @tier "presentation"
+    summary        : string = "" @label "Concept" @description "One line under the title saying what the learner is looking at (keep it under ~65 characters). Empty shows no line." @tier "presentation"
     tickMs         : number = 500 @label "Tick Milliseconds" @description "Milliseconds per frame shown in the readout; the autoplay cadence." @tier "presentation"
-    title          : string = "Trace Player" @label "Title" @description "Title shown above the instrument." @tier "presentation"
+    title          : string = "Trace Player" @label "Title" @description "The instrument's name, the header's one hero." @tier "presentation"
     width          : number = 600 @label "Width" @description "Canvas width in pixels." @tier "presentation"
   }
   override-surface : (linkedEntity name events effects listens emitsScope config)
@@ -22297,14 +22342,16 @@ trait std-learn-transport.traits.LearnTransportSim {
   linkedEntity   : LearnTransportScene
   category       : interaction
   states         : (idle*)
-  events         : (INIT MODE_SELECTED STEP TOGGLE_RUN RESET LEARN_STEP LEARN_RESET LEARN_UPDATED)
-  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on STEP) (idle -> idle on TOGGLE_RUN) (idle -> idle on RESET))
+  events         : (INIT MODE_SELECTED STEP TOGGLE_RUN RESET SPEED_SET LEARN_STEP LEARN_RESET LEARN_UPDATED)
+  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on STEP) (idle -> idle on TOGGLE_RUN) (idle -> idle on RESET) (idle -> idle on SPEED_SET))
   emits          : (LEARN_STEP LEARN_RESET LEARN_UPDATED)
   config {
     autoRun        : boolean = false @label "Auto Run" @description "When true the clock starts stepping on INIT; the Reset arm restores this value." @tier "domain"
     matchMode      : string = "" @label "Match Mode" @description "When composed behind a lab router, the MODE_SELECTED mode value this instrument responds to. Empty string means standalone — render immediately on INIT." @tier "presentation"
     stepIntervalMs : number = 500 @label "Step Interval (ms)" @description "Milliseconds of running clock per domain step — the 32ms base tick accumulates elapsed time and fires LEARN_STEP each time this interval elapses. 300-900 suits narrated steppers; 32 fires every frame for continuous sims." @tier "domain"
-    title          : string = "Learning Instrument" @label "Title" @description "Title shown above the transport controls." @tier "presentation"
+    summary        : string = "" @label "Concept" @description "One line under the title saying what the learner is looking at (keep it under ~65 characters). Empty shows no line." @tier "presentation"
+    title          : string = "Learning Instrument" @label "Title" @description "The instrument's name, the header's one hero." @tier "presentation"
+    totalSteps     : int = 0 @label "Total Steps" @description "When the walk has a known length, the step counter reads 'Step N of M'. 0 means open-ended." @tier "presentation"
   }
   override-surface : (linkedEntity name events effects listens emitsScope config)
   source         : "@almadar/std (behaviors/registry/ui/learning/atoms/std-learn-transport.orb orbitals[0].traits[0])"
@@ -22317,15 +22364,16 @@ trait std-learn-tree.traits.LearnTreeSim {
   category       : interaction
   states         : (idle*)
   events         : (INIT MODE_SELECTED INSERT_VALUE DELETE_VALUE RUN_TRAVERSAL TOGGLE_RUN RESET TREE_UPDATED)
-  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on INSERT_VALUE) (idle -> idle on DELETE_VALUE) (idle -> idle on RUN_TRAVERSAL) (idle -> idle on TOGGLE_RUN) (idle -> idle on RESET))
+  transitions    : ((idle -> idle on INIT) (idle -> idle on MODE_SELECTED) (idle -> idle on MODE_SELECTED) (idle -> idle on INSERT_VALUE) (idle -> idle on DELETE_VALUE) (idle -> idle on RUN_TRAVERSAL) (idle -> idle on TOGGLE_RUN) (idle -> idle on RESET))
   emits          : (TREE_UPDATED)
   config {
     autoRun        : boolean = false @label "Auto Run" @description "When true, the tick auto-steps the traversal sweep started by Traverse; toggle live with the Run/Pause button. Has no effect on Insert/Delete, which stay manual." @synonyms "auto run, auto step, auto play" @tier "domain"
-    backgroundColor : string = "#f8fafc" @label "Background Color" @description "Canvas background color." @tier "presentation"
+    backgroundColor : string = "" @label "Background Color" @description "Canvas ground. Empty uses the theme drawing ground." @tier "presentation"
     balanced       : boolean = false @label "Balance Readout" @description "When true, each insert's narration reports the tree's current height against its node count so the learner can judge balance; no auto-rotation is performed." @synonyms "balance, height, balance readout" @tier "domain"
     height         : number = 400 @label "Height" @description "Canvas height in pixels." @tier "presentation"
     matchMode      : string = "" @label "Match Mode" @description "When composed behind a lab router, the MODE_SELECTED mode value this instrument responds to. Empty string means standalone — render immediately on INIT." @tier "presentation"
     showComparisons : boolean = true @label "Show Comparisons" @description "Include each left/right comparison in the narration while a value descends; turn off for a terse attach-only narration." @synonyms "comparisons, narration detail" @tier "presentation"
+    summary        : string = "" @label "Concept" @description "One line under the title saying what the learner is looking at (keep it under ~65 characters). Empty shows no line." @tier "presentation"
     title          : string = "Ordered Tree" @label "Title" @description "Title shown above the canvas." @tier "presentation"
     traversalKind  : string = "inorder" @label "Traversal Kind" @description "Which sweep Traverse replays — inorder (sorted order, left to right), preorder (root before children), or levelorder (breadth first, top to bottom)." @synonyms "traversal, in-order, pre-order, level-order, sweep" @tier "domain"
     values         : [number] = [50,30,70,20,40,60,80] @label "Values" @description "The values Insert feeds into the tree, one per descent, in order." @synonyms "keys, values to insert, dataset, sequence" @tier "domain"
@@ -22357,45 +22405,6 @@ trait std-lifecycle.traits.LifecycleScheduler {
   source         : "@almadar/std (behaviors/registry/infra/atoms/std-lifecycle.orb orbitals[0].traits[0])"
 }
 
-;; From @almadar/std (behaviors/registry/ui/core/atoms/std-list.orb orbitals[0].traits[0])
-trait std-list.traits.ListItemBrowse {
-  alias          : List
-  linkedEntity   : ListItem
-  category       : interaction
-  states         : (loading* browsing error)
-  events         : (INIT ListItemLoaded ListItemLoadFailed REFETCH_QUERY REFETCH_FILTER REFETCH_PAGE RETRY CREATE EDIT DELETE)
-  transitions    : ((loading -> loading on INIT) (loading -> browsing on ListItemLoaded) (loading -> error on ListItemLoadFailed) (browsing -> loading on INIT) (browsing -> browsing on REFETCH_QUERY) (browsing -> browsing on REFETCH_FILTER) (browsing -> browsing on REFETCH_PAGE) (browsing -> browsing on ListItemLoadFailed) (browsing -> browsing on ListItemLoaded) (error -> loading on INIT) (error -> loading on RETRY))
-  emits          : (CREATE EDIT DELETE ListItemLoaded ListItemLoadFailed)
-  config {
-    bodySearch     : boolean = false @label "Show the list's own search box?" @description "Embeds a search box above the grid. Set true only when the page has no other search affordance (e.g. no page-level std-search), so the surface shows one search box instead of two. False is the default — this atom has never had a search box (0 consumers today)." @synonyms "inline search, list search, built-in search, show search" @tier "presentation"
-    createRoles    : [string] = [] @label "Roles that can create" @description "Roles (matched against viewerRole) that see the Create button. Empty = everyone." @tier "policy"
-    displayPageSize : number = 20 @label "How many rows to show at once?" @description "Rows visible per page before the data-grid's own pagination control appears — 20 matches the CRUD-list density sweet spot (Miller's law, 10-25 rows)." @synonyms "visible rows, items per page, display limit, show per page" @tier "presentation"
-    filterBarLook  : string = "toolbar" @label "Filter bar look" @description "Visual treatment for the embedded filter bar, mirroring std-filter's own enum. Only applies when `filters` is non-empty." @synonyms "filter bar style, facet style, chips, pills" @tier "presentation" @values (toolbar chips pills popover-trigger inline-column-header)
-    filters        : [FilterSpec] = [] @label "Which filters should appear above the grid?" @description "Dropdown filter facets by field, rendered as an embedded filter bar above the rows; each selection fires REFETCH_FILTER on this trait. Empty (the default) = no filter bar, the right setting whenever the page already composes std-filter beside this list and routes XFilter.FILTER -> REFETCH_FILTER — that is the wired owner and remains the primary path. Use this knob only for a standalone list with no page-level filter affordance." @synonyms "filter bar, faceted filters, field filters, dropdowns" @tier "presentation"
-    itemActions    : [ItemAction] = [{"event":"EDIT","label":"Edit","variant":"ghost"},{"event":"DELETE","label":"Delete","variant":"danger"}] @label "Row actions" @description "Actions offered on each row; give an item `roles` to show it only to those viewer roles." @tier "presentation"
-    itemClickEvent : event = "EDIT" @label "Which event does clicking a row fire?" @description "Row-click channel; empty = rows are not clickable." @synonyms "row click event, item click, open event" @tier "presentation"
-    pageSize       : number = 20 @label "How many rows per page when paging?" @description "Records fetched from the server per REFETCH_PAGE request. The initial load and search/filter refetches remain unpaginated (load everything that matches) unless a consumer wires REFETCH_PAGE, so the default list surface is unchanged." @synonyms "fetch limit, records per page, page limit" @tier "presentation"
-    searchField    : string = "name" @label "Which column does the search box match against?" @description "Name the field on this entity the search box's str/includes filter matches against. Declared, never inferred: an entity with no `name` column must set this to a real field (e.g. title, label) or the search box can never match a row." @synonyms "search column, search on field, match field, search key" @tier "policy"
-    searchPlaceholder : string = "Search…" @label "Search box placeholder text" @description "Hint text inside the list search box." @synonyms "search hint, placeholder, search box text" @tier "presentation"
-    viewerRole     : string = "" @label "Viewer's role" @description "The signed-in viewer's role that each action's `roles` is checked against. Bind it explicitly at the call site (e.g. `viewerRole: @user.role`) in an app whose identity carries a role; left empty, only actions with no `roles` show." @tier "policy"
-  }
-  override-surface : (linkedEntity name events effects listens emitsScope config)
-  source         : "@almadar/std (behaviors/registry/ui/core/atoms/std-list.orb orbitals[0].traits[0])"
-}
-
-;; From @almadar/std (behaviors/registry/ui/core/atoms/std-list.orb orbitals[0].traits[1])
-trait std-list.traits.ListItemPersistor {
-  alias          : List
-  linkedEntity   : ListItem
-  category       : lifecycle
-  states         : (idle*)
-  events         : (INIT DO_CREATE DO_UPDATE DO_DELETE ITEM_CREATED ITEM_UPDATED ITEM_DELETED)
-  transitions    : ((idle -> idle on INIT) (idle -> idle on DO_CREATE) (idle -> idle on DO_UPDATE) (idle -> idle on DO_DELETE))
-  emits          : (ITEM_CREATED ITEM_UPDATED ITEM_DELETED)
-  override-surface : (linkedEntity name events effects listens emitsScope config)
-  source         : "@almadar/std (behaviors/registry/ui/core/atoms/std-list.orb orbitals[0].traits[1])"
-}
-
 ;; From @almadar/std (behaviors/registry/ui/game/atoms/std-lives.orb orbitals[0].traits[0])
 trait std-lives.traits.Lives {
   alias          : Lives
@@ -23662,10 +23671,12 @@ trait std-site-header.traits.SiteHeaderRender {
     brandName      : string = "Almadar" @label "Brand name" @synonyms "site name, company, logo text" @tier "presentation"
     currentLanguage : string = "en" @label "Current language" @description "The code of the language this page is in" @synonyms "locale, active language, page language" @tier "presentation"
     currentPath    : string = "/" @label "Current page path" @description "Marks the matching link as active" @tier "presentation"
-    headerContent  : render-ui = {"children":[{"actions":["@trait.SiteHeaderLanguages",{"action":"NAV_LINK","actionPayload":{"href":"@config.actionHref","label":"@config.actionLabel"},"className":["if",["==","@config.actionLabel",""],"hidden",""],"href":"@config.actionHref","label":"@config.actionLabel","size":"sm","type":"button","variant":"primary"}],"brandName":"@config.brandName","className":"hidden lg:flex","logoSrc":"@config.logoSrc","navigationItems":["array/map","@config.links",["fn","entry",{"active":["==",["object/get","@entry","href",""],"@config.currentPath"],"children":["array/map",["object/get","@entry","children",[]],["fn","child",{"active":["==",["object/get","@child","href",""],"@config.currentPath"],"href":["object/get","@child","href",""],"label":["object/get","@child","label",""]}]],"href":["object/get","@entry","href",""],"label":["object/get","@entry","label",""]}]],"showMenuToggle":false,"sticky":false,"type":"header","variant":"desktop"},{"actions":["@trait.SiteHeaderLanguages"],"brandName":"@config.brandName","className":"lg:hidden","isMenuOpen":"@entity.menuOpen","logoSrc":"@config.logoSrc","onMenuToggle":"MENU_TOGGLE","showMenuToggle":true,"sticky":false,"type":"header","variant":"mobile"},{"align":"stretch","children":[{"align":"stretch","children":["array/map","@config.links",["fn",["entry"],{"align":"stretch","children":[{"action":"NAV_LINK","actionPayload":{"href":["object/get","@entry","href",""],"label":["object/get","@entry","label",""]},"className":"justify-start","href":["object/get","@entry","href",""],"label":["object/get","@entry","label",""],"type":"button","variant":["if",["==",["object/get","@entry","href",""],"@config.currentPath"],"secondary","ghost"]},{"align":"stretch","children":["array/map",["object/get","@entry","children",[]],["fn",["child"],{"action":"NAV_LINK","actionPayload":{"href":["object/get","@child","href",""],"label":["object/get","@child","label",""]},"className":"justify-start","href":["object/get","@child","href",""],"label":["object/get","@child","label",""],"type":"button","variant":["if",["==",["object/get","@child","href",""],"@config.currentPath"],"secondary","ghost"]}]],"className":"ps-6","direction":"vertical","gap":"xs","type":"stack"}],"direction":"vertical","gap":"xs","type":"stack"}]],"direction":"vertical","gap":"xs","type":"stack"},{"action":"NAV_LINK","actionPayload":{"href":"@config.actionHref","label":"@config.actionLabel"},"className":["if",["==","@config.actionLabel",""],"hidden","mt-2 w-full"],"href":"@config.actionHref","label":"@config.actionLabel","size":"md","type":"button","variant":"primary"}],"className":["if","@entity.menuOpen","lg:hidden border-b border-border bg-card px-4 py-3","hidden"],"direction":"vertical","gap":"xs","type":"stack"}],"className":"sticky top-0 z-50","direction":"vertical","gap":"none","type":"stack"} @label "Header body" @tier "internal"
+    headerContent  : render-ui = {"children":[{"actions":["@trait.SiteHeaderLanguages",{"className":["if","@config.showThemeToggle","","hidden"],"size":"sm","type":"theme-toggle"},{"action":"NAV_LINK","actionPayload":{"href":"@config.actionHref","label":"@config.actionLabel"},"className":["if",["==","@config.actionLabel",""],"hidden",""],"href":"@config.actionHref","label":"@config.actionLabel","size":"sm","type":"button","variant":"primary"}],"brandHref":"@config.homeHref","brandName":"@config.brandName","className":"hidden lg:flex","logoSrc":"@config.logoSrc","navigationItems":["array/map","@config.links",["fn","entry",{"active":["==",["object/get","@entry","href",""],"@config.currentPath"],"children":["array/map",["object/get","@entry","children",[]],["fn","child",{"active":["==",["object/get","@child","href",""],"@config.currentPath"],"href":["object/get","@child","href",""],"label":["object/get","@child","label",""]}]],"href":["object/get","@entry","href",""],"label":["object/get","@entry","label",""]}]],"showMenuToggle":false,"sticky":false,"type":"header","variant":"desktop"},{"actions":["@trait.SiteHeaderLanguages",{"className":["if","@config.showThemeToggle","","hidden"],"size":"sm","type":"theme-toggle"}],"brandHref":"@config.homeHref","brandName":"@config.brandName","className":"lg:hidden","isMenuOpen":"@entity.menuOpen","logoSrc":"@config.logoSrc","onMenuToggle":"MENU_TOGGLE","showMenuToggle":true,"sticky":false,"type":"header","variant":"mobile"},{"align":"stretch","children":[{"align":"stretch","children":["array/map","@config.links",["fn",["entry"],{"align":"stretch","children":[{"action":"NAV_LINK","actionPayload":{"href":["object/get","@entry","href",""],"label":["object/get","@entry","label",""]},"className":"justify-start","href":["object/get","@entry","href",""],"label":["object/get","@entry","label",""],"type":"button","variant":["if",["==",["object/get","@entry","href",""],"@config.currentPath"],"secondary","ghost"]},{"align":"stretch","children":["array/map",["object/get","@entry","children",[]],["fn",["child"],{"action":"NAV_LINK","actionPayload":{"href":["object/get","@child","href",""],"label":["object/get","@child","label",""]},"className":"justify-start","href":["object/get","@child","href",""],"label":["object/get","@child","label",""],"type":"button","variant":["if",["==",["object/get","@child","href",""],"@config.currentPath"],"secondary","ghost"]}]],"className":"ps-6","direction":"vertical","gap":"xs","type":"stack"}],"direction":"vertical","gap":"xs","type":"stack"}]],"direction":"vertical","gap":"xs","type":"stack"},{"action":"NAV_LINK","actionPayload":{"href":"@config.actionHref","label":"@config.actionLabel"},"className":["if",["==","@config.actionLabel",""],"hidden","mt-2 w-full"],"href":"@config.actionHref","label":"@config.actionLabel","size":"md","type":"button","variant":"primary"}],"className":["if","@entity.menuOpen","lg:hidden border-b border-border bg-card px-4 py-3","hidden"],"direction":"vertical","gap":"xs","type":"stack"}],"className":"sticky top-0 z-50","direction":"vertical","gap":"none","type":"stack"} @label "Header body" @tier "internal"
+    homeHref       : string = "" @label "Home link" @description "Where the brand (logo + name) links to, usually the site's home page; empty leaves the brand unlinked" @synonyms "logo link, home page, brand link" @tier "presentation"
     languages      : [SiteLanguage] = [] @label "Languages" @description "Every language this page exists in, each named in its own language, with the href of THIS page in that language (default language at the root, others under /<code>/). Empty hides the language picker." @synonyms "locales, translations, language switcher, i18n" @tier "presentation"
     links          : [SiteNavLink] = [{"href":"/features","label":"Features"},{"href":"/pricing","label":"Pricing"},{"href":"/about","label":"About"}] @label "Navigation links" @synonyms "menu, nav items, top navigation" @tier "presentation"
     logoSrc        : string = "" @label "Logo image" @description "Logo URL; empty shows the name only" @tier "presentation"
+    showThemeToggle : boolean = false @label "Light/dark toggle" @description "Show a button that switches the site between its light and dark mode" @synonyms "dark mode, theme switch, color mode" @tier "presentation"
   }
   override-surface : (linkedEntity name events effects listens emitsScope config)
   source         : "@almadar/std (behaviors/registry/ui/core/atoms/std-site-header.orb orbitals[0].traits[0])"
@@ -23725,7 +23736,7 @@ trait std-stats.traits.StatsItemStats {
     heroMetricBodyContent : render-ui = {"children":[["if",["!=","@config.title",""],{"content":"@config.title","type":"typography","variant":"h3"},{"children":[],"gap":"none","type":"stack"}],{"entity":"@entity.cards","fields":[],"gap":"none","renderItem":["fn","card",{"children":[{"children":[{"align":"center","children":[{"align":"center","children":[{"color":"muted","name":"@card.icon","size":"md","type":"icon"},{"className":"uppercase tracking-widest","color":"muted","content":"@card.label","type":"typography","variant":"overline","weight":"bold"}],"direction":"horizontal","gap":"sm","justify":"center","type":"stack"},{"align":"baseline","children":[{"color":"muted","content":"@card.prefix","type":"typography","variant":"h2","weight":"normal"},{"className":"text-7xl md:text-8xl font-bold tracking-tighter tabular-nums text-[var(--color-foreground)]","format":"@card.format","type":"animated-counter","value":"@card.value"},{"color":"muted","content":"@card.suffix","type":"typography","variant":"h2","weight":"normal"}],"className":"py-section","direction":"horizontal","gap":"xs","justify":"center","type":"stack"},{"showValue":true,"size":"md","type":"trend-indicator","value":"@card.trend"}],"className":"relative z-10 w-full max-w-2xl mx-auto text-center","direction":"vertical","gap":"md","type":"stack"},{"className":"absolute inset-x-0 bottom-0 w-full opacity-10 pointer-events-none","color":"auto","data":"@card.sparklineData","fill":true,"height":96,"strokeWidth":1,"type":"sparkline"}],"look":"elevated","padding":"lg","type":"card"}],"className":"relative w-full rounded-xl shadow-lg overflow-hidden","direction":"vertical","gap":"none","type":"stack"}],"type":"data-list"}],"data-theme":"@config.theme","type":"box"} @label "Hero metric body content tree" @description "Render-ui SExpr for statsLook='hero-metric' — one elevated card, one oversize number, background sparkline." @tier "internal"
     kpiTilesBodyContent : render-ui = {"children":[["if",["!=","@config.title",""],{"content":"@config.title","type":"typography","variant":"h3"},{"children":[],"gap":"none","type":"stack"}],{"className":"w-full","entity":"@entity.cards","fields":[],"gap":"lg","minCardWidth":220,"renderItem":["fn","card",{"children":[{"align":"center","children":[{"className":"uppercase tracking-wide","color":"muted","content":"@card.label","type":"typography","variant":"caption","weight":"medium"},{"color":"muted","name":"@card.icon","size":"sm","type":"icon"}],"direction":"horizontal","gap":"xs","justify":"between","type":"stack"},{"align":"baseline","children":[{"color":"muted","content":"@card.prefix","type":"typography","variant":"caption"},{"className":"text-4xl font-bold tracking-tight","format":"@card.format","type":"animated-counter","value":"@card.value"},{"color":"muted","content":"@card.suffix","type":"typography","variant":"caption"}],"direction":"horizontal","gap":"xs","type":"stack"},{"align":"center","children":[{"showValue":true,"size":"sm","type":"trend-indicator","value":"@card.trend"},{"className":"flex-1","color":"auto","data":"@card.sparklineData","fill":true,"height":24,"type":"sparkline"}],"direction":"horizontal","gap":"sm","type":"stack"}],"className":"rounded-lg border border-[var(--color-border)] bg-[var(--color-surface)] p-card-lg shadow-elevation-sm hover:shadow-elevation-md transition-shadow","direction":"vertical","gap":"sm","type":"stack"}],"type":"data-grid"}],"data-theme":"@config.theme","type":"box"} @label "KPI tiles body content tree" @description "Render-ui SExpr for statsLook='kpi-tiles' — Stripe-dashboard style tile grid: huge typography number, label, trend indicator, sparkline hint." @tier "internal"
     metrics        : [MetricSpec] = [{"aggregation":"count","format":"number","icon":"list","label":"Total Items","sparklineData":[2,4,3,6,5,8,7],"variant":"primary"},{"aggregation":"count","format":"number","icon":"check-circle","label":"Active","sparklineData":[1,3,2,4,6,5,7],"variant":"success"},{"aggregation":"avg","field":"value","format":"number","icon":"trending-up","label":"Avg Value","sparklineData":[5,4,6,3,5,7,6],"variant":"info"}] @label "Metrics" @description "One stat card per entry; declares aggregation, format, and styling" @synonyms "list of KPI cards / stat tiles / metric cards. each entry has label / value / format / icon / variant / aggregation. user phrases: 'replace metrics with X, Y, Z' -> rewrite array; 'add Revenue tile' -> append entry; 'change KPIs to X' -> rewrite array" @tier "presentation"
-    sparklineRowBodyContent : render-ui = {"children":[["if",["!=","@config.title",""],{"content":"@config.title","type":"typography","variant":"h3"},{"children":[],"gap":"none","type":"stack"}],{"className":"w-full","entity":"@entity.cards","fields":[],"gap":"md","minCardWidth":260,"renderItem":["fn","card",{"children":[{"align":"center","children":[{"color":"muted","name":"@card.icon","size":"xs","type":"icon"},{"className":"uppercase tracking-wide truncate","color":"muted","content":"@card.label","type":"typography","variant":"overline","weight":"semibold"}],"direction":"horizontal","gap":"xs","type":"stack"},{"className":"w-full","color":"auto","data":"@card.sparklineData","fill":true,"height":64,"strokeWidth":2,"type":"sparkline"},{"align":"baseline","children":[{"align":"baseline","children":[{"color":"muted","content":"@card.prefix","type":"typography","variant":"caption"},{"className":"text-2xl font-semibold tabular-nums","format":"@card.format","type":"animated-counter","value":"@card.value"},{"color":"muted","content":"@card.suffix","type":"typography","variant":"caption"}],"direction":"horizontal","gap":"xs","type":"stack"},{"showValue":true,"size":"sm","type":"trend-indicator","value":"@card.trend"}],"direction":"horizontal","gap":"sm","justify":"between","type":"stack"}],"className":"rounded-lg border border-[var(--color-border)] bg-[var(--color-card)] p-card-md shadow-elevation-sm hover:shadow-elevation-md transition-shadow min-h-[180px]","direction":"vertical","gap":"sm","type":"stack"}],"type":"data-grid"}],"data-theme":"@config.theme","type":"box"} @label "Sparkline row body content tree" @description "Render-ui SExpr for statsLook='sparkline-row' — chart-first tiles where the mini trend line is the visual centerpiece, label above, value+delta footer." @tier "internal"
+    sparklineRowBodyContent : render-ui = {"children":[["if",["!=","@config.title",""],{"content":"@config.title","type":"typography","variant":"h3"},{"children":[],"gap":"none","type":"stack"}],{"className":"w-full","entity":"@entity.cards","fields":[],"gap":"md","minCardWidth":260,"renderItem":["fn","card",{"children":[{"align":"center","children":[{"color":"muted","name":"@card.icon","size":"xs","type":"icon"},{"className":"uppercase tracking-wide truncate","color":"muted","content":"@card.label","type":"typography","variant":"overline","weight":"semibold"}],"direction":"horizontal","gap":"xs","type":"stack"},{"className":"w-full","color":"auto","data":"@card.sparklineData","fill":true,"height":64,"strokeWidth":2,"type":"sparkline"},{"align":"baseline","children":[{"align":"baseline","children":[{"color":"muted","content":"@card.prefix","type":"typography","variant":"caption"},{"className":"text-2xl font-semibold tabular-nums","format":"@card.format","type":"animated-counter","value":"@card.value"},{"color":"muted","content":"@card.suffix","type":"typography","variant":"caption"}],"direction":"horizontal","gap":"xs","type":"stack"},{"showValue":true,"size":"sm","type":"trend-indicator","value":"@card.trend"}],"direction":"horizontal","gap":"sm","justify":"between","type":"stack"}],"className":"surface-content p-card-md hover:shadow-elevation-dialog transition-shadow min-h-[180px]","direction":"vertical","gap":"sm","type":"stack"}],"type":"data-grid"}],"data-theme":"@config.theme","type":"box"} @label "Sparkline row body content tree" @description "Render-ui SExpr for statsLook='sparkline-row' — chart-first tiles where the mini trend line is the visual centerpiece, label above, value+delta footer." @tier "internal"
     statLook       : string = "elevated" @label "Stat display look" @description "Layer 2 visual treatment for stat / KPI cards." @tier "presentation" @values (elevated flat progress-backed gauge sparkline)
     statsLook      : string = "cards" @label "Stats look" @description "Layer 3 body layout: default per-metric stat-card grid ('cards'), Stripe-dashboard KPI tile row ('kpi-tiles'), single oversize hero number ('hero-metric'), or chart-first sparkline tile grid ('sparkline-row')." @tier "presentation" @values (cards kpi-tiles hero-metric sparkline-row)
     theme          : string = "" @label "Theme" @description "Data-theme skin applied to the stat body root — for chrome-less pages composed without an AppShell." @tier "presentation"
@@ -24248,6 +24259,8 @@ trait ui-algo-graph-canvas.traits.AlgoGraphCanvasRender {
     height         : number = 400 @label "Height" @description "height prop" @tier "presentation"
     interactive    : boolean = false @label "Interactive" @description "interactive prop" @tier "presentation"
     isLoading      : boolean @label "Is Loading" @description "isLoading prop" @tier "presentation"
+    keyMap         : Map<string,string> = {"item":"INIT"} @label "Key Map" @description "Maps a keydown `e.code` (optionally `Mod+`/`Shift+`/`Alt+` prefixed) to a SEMANTIC event emitted as `UI:{event}` — e.g. `{ Space: TOGGLE_RUN, ArrowRight: STEP, KeyR: RESET }`; keystrokes inside inputs never route." @tier "presentation"
+    keyUpMap       : Map<string,string> = {"item":"INIT"} @label "Key Up Map" @description "Maps a keyup `e.code` to a semantic event emitted as `UI:{event}`." @tier "presentation"
     lang           : string @label "Lang" @description "Language of this element's content (BCP 47, e.g. ar, sl, en)." @tier "presentation"
     layout         : string = "manual" @label "Layout" @description "Deterministic layout to compute node positions; `manual` passes through `x`/`y`." @tier "presentation" @values (manual tree layered circle)
     nodes          : [AlgoGraphCanvasNodesItem] = [] @label "Nodes" @description "nodes prop" @tier "presentation"
@@ -24255,6 +24268,7 @@ trait ui-algo-graph-canvas.traits.AlgoGraphCanvasRender {
     onShapeClick   : event = "SHAPE_CLICK" @label "On Shape Click" @description "onShapeClick prop" @tier "presentation"
     role           : string @label "Role" @description "WAI-ARIA role when the element's native semantics don't describe it." @tier "presentation" @values (alert alertdialog application article banner blockquote button caption cell checkbox code columnheader combobox complementary contentinfo definition deletion dialog document emphasis feed figure form generic grid gridcell group heading img insertion link list listbox listitem log main marquee math menu menubar menuitem menuitemcheckbox menuitemradio meter navigation none note option paragraph presentation progressbar radio radiogroup region row rowgroup rowheader scrollbar search searchbox separator slider spinbutton status strong subscript superscript switch tab table tablist tabpanel term textbox time timer toolbar tooltip tree treegrid treeitem)
     root           : string @label "Root" @description "`tree` layout only: preferred root id. Falls back to the first indegree-0 node." @tier "presentation"
+    series         : [string] = [] @label "Series" @description "Overrides the theme's categorical palette (`series-1…N`) for this canvas — real-world conventions like CPK atom colors or resistor bands. Unset, the theme's `--color-series-*` apply." @tier "presentation"
     shapes         : [AlgoGraphCanvasShapesItem] = [] @label "Shapes" @description "Extra declarative shapes in canvas pixel coordinates." @tier "presentation"
     skeleton       : string @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" @values (header table list grid detail stats form card text none)
     tabIndex       : number @label "Tab Index" @description "0 puts the element in the Tab order; -1 makes it focusable only programmatically." @tier "presentation"
@@ -24301,12 +24315,15 @@ trait ui-algorithm-canvas.traits.AlgorithmCanvasRender {
     height         : number = 400 @label "Height" @description "height prop" @tier "presentation"
     interactive    : boolean = false @label "Interactive" @description "interactive prop" @tier "presentation"
     isLoading      : boolean @label "Is Loading" @description "isLoading prop" @tier "presentation"
+    keyMap         : Map<string,string> = {"item":"INIT"} @label "Key Map" @description "Maps a keydown `e.code` (optionally `Mod+`/`Shift+`/`Alt+` prefixed) to a SEMANTIC event emitted as `UI:{event}` — e.g. `{ Space: TOGGLE_RUN, ArrowRight: STEP, KeyR: RESET }`; keystrokes inside inputs never route." @tier "presentation"
+    keyUpMap       : Map<string,string> = {"item":"INIT"} @label "Key Up Map" @description "Maps a keyup `e.code` to a semantic event emitted as `UI:{event}`." @tier "presentation"
     lang           : string @label "Lang" @description "Language of this element's content (BCP 47, e.g. ar, sl, en)." @tier "presentation"
     onShapeClick   : event = "SHAPE_CLICK" @label "On Shape Click" @description "onShapeClick prop" @tier "presentation"
     pointers       : [AlgorithmCanvasPointersItem] = [] @label "Pointers" @description "Index cursors (i/j/lo/hi/mid); drawn as markers beneath the referenced bar/slot column." @tier "presentation"
     ranges         : [AlgorithmCanvasRangesItem] = [] @label "Ranges" @description "Highlighted index ranges over the bars panel (translucent fill bands or labeled brackets)." @tier "presentation"
     role           : string @label "Role" @description "WAI-ARIA role when the element's native semantics don't describe it." @tier "presentation" @values (alert alertdialog application article banner blockquote button caption cell checkbox code columnheader combobox complementary contentinfo definition deletion dialog document emphasis feed figure form generic grid gridcell group heading img insertion link list listbox listitem log main marquee math menu menubar menuitem menuitemcheckbox menuitemradio meter navigation none note option paragraph presentation progressbar radio radiogroup region row rowgroup rowheader scrollbar search searchbox separator slider spinbutton status strong subscript superscript switch tab table tablist tabpanel term textbox time timer toolbar tooltip tree treegrid treeitem)
     rowLabels      : [AlgorithmCanvasRowLabelsItem] = [] @label "Row Labels" @description "Row-header labels drawn to the left of the cells grid." @tier "presentation"
+    series         : [string] = [] @label "Series" @description "Overrides the theme's categorical palette (`series-1…N`) for this canvas — real-world conventions like CPK atom colors or resistor bands. Unset, the theme's `--color-series-*` apply." @tier "presentation"
     shapes         : [AlgorithmCanvasShapesItem] = [] @label "Shapes" @description "Extra declarative shapes in canvas pixel coordinates." @tier "presentation"
     skeleton       : string @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" @values (header table list grid detail stats form card text none)
     slotOrientation : string = "horizontal" @label "Slot Orientation" @description "Slot stack direction; horizontal lays slots left-to-right, vertical stacks bottom-up." @tier "presentation" @values (horizontal vertical)
@@ -24554,7 +24571,7 @@ trait ui-avl-glyph.traits.AvlGlyphRender {
     ariaSelected   : boolean @label "Aria-selected" @description "Whether this item is selected (tabs, options, grid cells)." @synonyms "aria-selected" @tier "presentation"
     className      : string @label "Class Name" @description "className prop" @tier "presentation"
     dir            : string @label "Dir" @description "Text direction of this element's content." @tier "presentation" @values (ltr rtl auto)
-    effectType     : string @label "Effect Type" @description "Effect symbol variant. @default 'set'" @tier "presentation"
+    effectType     : string = "set" @label "Effect Type" @description "Effect symbol variant. @default 'set'" @tier "presentation"
     enter          : string @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" @values (none fade rise scale slide)
     enterDelay     : number @label "Enter Delay" @description "Stagger step for the entry: waits this many `--motion-enter-stagger` steps before animating." @tier "presentation"
     kind           : string = "@state" @label "Kind" @description "Which notation symbol to draw." @tier "presentation" @values (application orbital entity trait page state transition event guard effect field fieldType binding bindingRef persistence operator sexpr literal)
@@ -24721,6 +24738,8 @@ trait ui-biology-canvas.traits.BiologyCanvasRender {
     helix3d        : BiologyCanvasHelix3d @label "Helix3d" @description "A 3D DNA double-helix ladder. 3D only." @tier "presentation"
     interactive    : boolean @label "Interactive" @description "2D: pointer interaction (click/hover). 3D: orbit camera controls." @tier "presentation"
     isLoading      : boolean @label "Is Loading" @description "isLoading prop" @tier "presentation"
+    keyMap         : Map<string,string> = {"item":"INIT"} @label "Key Map" @description "Maps a keydown `e.code` (optionally `Mod+`/`Shift+`/`Alt+` prefixed) to a SEMANTIC event emitted as `UI:{event}` — e.g. `{ Space: TOGGLE_RUN, ArrowRight: STEP, KeyR: RESET }`; keystrokes inside inputs never route." @tier "presentation"
+    keyUpMap       : Map<string,string> = {"item":"INIT"} @label "Key Up Map" @description "Maps a keyup `e.code` to a semantic event emitted as `UI:{event}`." @tier "presentation"
     lang           : string @label "Lang" @description "Language of this element's content (BCP 47, e.g. ar, sl, en)." @tier "presentation"
     lighting       : BiologyCanvasLighting @label "Lighting" @description "3D only: scene light rig as data." @tier "presentation"
     mode           : string = "2d" @label "Mode" @description "Painter: 2D raster (default) or 3D mesh scene via the lazy three.js host." @tier "presentation" @values (2d 3d)
@@ -24729,6 +24748,7 @@ trait ui-biology-canvas.traits.BiologyCanvasRender {
     post           : BiologyCanvasPost @label "Post" @description "3D only: post-processing stack (bloom/vignette)." @tier "presentation"
     readouts       : [BiologyCanvasReadoutsItem] = [] @label "Readouts" @description "Top-right status chip row, forwarded to LearningCanvas verbatim." @tier "presentation"
     role           : string @label "Role" @description "WAI-ARIA role when the element's native semantics don't describe it." @tier "presentation" @values (alert alertdialog application article banner blockquote button caption cell checkbox code columnheader combobox complementary contentinfo definition deletion dialog document emphasis feed figure form generic grid gridcell group heading img insertion link list listbox listitem log main marquee math menu menubar menuitem menuitemcheckbox menuitemradio meter navigation none note option paragraph presentation progressbar radio radiogroup region row rowgroup rowheader scrollbar search searchbox separator slider spinbutton status strong subscript superscript switch tab table tablist tabpanel term textbox time timer toolbar tooltip tree treegrid treeitem)
+    series         : [string] = [] @label "Series" @description "Overrides the theme's categorical palette (`series-1…N`) for this canvas — real-world conventions like CPK atom colors or resistor bands. Unset, the theme's `--color-series-*` apply." @tier "presentation"
     shadows        : boolean @label "Shadows" @description "3D only: enable shadows. Omitted → the host default." @tier "presentation"
     shapes         : [BiologyCanvasShapesItem] = [] @label "Shapes" @description "Extra declarative shapes in canvas pixel coordinates (2D mode only — ignored in 3D)." @tier "presentation"
     showGrid       : boolean @label "Show Grid" @description "3D only: show the ground grid (default off)." @tier "presentation"
@@ -25125,11 +25145,13 @@ trait ui-chemistry-canvas.traits.ChemistryCanvasRender {
     enter          : string @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" @values (none fade rise scale slide)
     enterDelay     : number @label "Enter Delay" @description "Stagger step for the entry: waits this many `--motion-enter-stagger` steps before animating." @tier "presentation"
     equation       : string @label "Equation" @description "Reaction equation text centered at the top of the canvas. 2D only." @synonyms "reaction equation, formula" @tier "presentation"
-    equationColor  : string @label "Equation Color" @description "Equation text color (default '#111827')." @tier "presentation"
+    equationColor  : string @label "Equation Color" @description "Equation text color: a tone name, token or literal (default the `ink` tone)." @tier "presentation"
     error          : ChemistryCanvasError @label "Error" @description "error prop" @tier "presentation"
     height         : number = 400 @label "Height" @description "height prop" @tier "presentation"
     interactive    : boolean @label "Interactive" @description "2D: pointer interaction (click/hover). 3D: orbit camera controls." @tier "presentation"
     isLoading      : boolean @label "Is Loading" @description "isLoading prop" @tier "presentation"
+    keyMap         : Map<string,string> = {"item":"INIT"} @label "Key Map" @description "Maps a keydown `e.code` (optionally `Mod+`/`Shift+`/`Alt+` prefixed) to a SEMANTIC event emitted as `UI:{event}` — e.g. `{ Space: TOGGLE_RUN, ArrowRight: STEP, KeyR: RESET }`; keystrokes inside inputs never route." @tier "presentation"
+    keyUpMap       : Map<string,string> = {"item":"INIT"} @label "Key Up Map" @description "Maps a keyup `e.code` to a semantic event emitted as `UI:{event}`." @tier "presentation"
     lang           : string @label "Lang" @description "Language of this element's content (BCP 47, e.g. ar, sl, en)." @tier "presentation"
     lattice3d      : ChemistryCanvasLattice3d @label "Lattice3d" @description "A 3D crystal lattice block (simple cubic, BCC, FCC, rock salt, diamond, ...). 3D only." @tier "presentation"
     lighting       : ChemistryCanvasLighting @label "Lighting" @description "3D only: scene light rig as data." @tier "presentation"
@@ -25138,6 +25160,7 @@ trait ui-chemistry-canvas.traits.ChemistryCanvasRender {
     post           : ChemistryCanvasPost @label "Post" @description "3D only: post-processing stack (bloom/vignette)." @tier "presentation"
     readouts       : [ChemistryCanvasReadoutsItem] = [] @label "Readouts" @description "Top-right status chip row, forwarded to LearningCanvas verbatim." @tier "presentation"
     role           : string @label "Role" @description "WAI-ARIA role when the element's native semantics don't describe it." @tier "presentation" @values (alert alertdialog application article banner blockquote button caption cell checkbox code columnheader combobox complementary contentinfo definition deletion dialog document emphasis feed figure form generic grid gridcell group heading img insertion link list listbox listitem log main marquee math menu menubar menuitem menuitemcheckbox menuitemradio meter navigation none note option paragraph presentation progressbar radio radiogroup region row rowgroup rowheader scrollbar search searchbox separator slider spinbutton status strong subscript superscript switch tab table tablist tabpanel term textbox time timer toolbar tooltip tree treegrid treeitem)
+    series         : [string] = [] @label "Series" @description "Overrides the theme's categorical palette (`series-1…N`) for this canvas — real-world conventions like CPK atom colors or resistor bands. Unset, the theme's `--color-series-*` apply." @tier "presentation"
     shadows        : boolean @label "Shadows" @description "3D only: enable shadows. Omitted → the host default." @tier "presentation"
     shapes         : [ChemistryCanvasShapesItem] = [] @label "Shapes" @description "Extra declarative shapes in canvas pixel coordinates (2D mode only — ignored in 3D)." @tier "presentation"
     showGrid       : boolean @label "Show Grid" @description "3D only: show the ground grid (default off)." @tier "presentation"
@@ -26305,7 +26328,7 @@ trait ui-learning-canvas.traits.LearningCanvasRender {
     ariaLive       : string @label "Aria-live" @description "Announce changes to this region: polite waits for a pause, assertive interrupts." @synonyms "aria-live" @tier "presentation" @values (off polite assertive)
     ariaPressed    : string @label "Aria-pressed" @description "Toggle-button state." @synonyms "aria-pressed" @tier "presentation" @values (true false mixed)
     ariaSelected   : boolean @label "Aria-selected" @description "Whether this item is selected (tabs, options, grid cells)." @synonyms "aria-selected" @tier "presentation"
-    backgroundColor : string @label "Background Color" @description "Background color (default transparent)." @tier "presentation"
+    backgroundColor : string @label "Background Color" @description "Canvas ground: a tone name, `var()` token or literal (default the theme's `--surface-diagram`)." @tier "presentation"
     className      : string @label "Class Name" @description "Additional CSS classes." @tier "presentation"
     description    : string @label "Description" @description "Text alternative for the canvas, rendered as visually hidden text and linked by aria-describedby." @tier "presentation"
     dir            : string @label "Dir" @description "Text direction of this element's content." @tier "presentation" @values (ltr rtl auto)
@@ -26317,12 +26340,15 @@ trait ui-learning-canvas.traits.LearningCanvasRender {
     height         : number = 400 @label "Height" @description "Canvas height in CSS pixels." @tier "presentation"
     interactive    : boolean = false @label "Interactive" @description "Enable pointer interaction (click/hover)." @tier "presentation"
     isLoading      : boolean @label "Is Loading" @description "Loading state." @tier "presentation"
+    keyMap         : Map<string,string> = {"item":"INIT"} @label "Key Map" @description "Maps a keydown `e.code` — optionally prefixed `Mod+` (⌘/Ctrl), `Shift+`, `Alt+` — to a SEMANTIC event emitted as `UI:{event}` (e.g. `{ Space: TOGGLE_RUN, ArrowRight: STEP, KeyR: RESET }`); keystrokes inside inputs never route." @tier "presentation"
+    keyUpMap       : Map<string,string> = {"item":"INIT"} @label "Key Up Map" @description "Maps a keyup `e.code` to a semantic event emitted as `UI:{event}`." @tier "presentation"
     lang           : string @label "Lang" @description "Language of this element's content (BCP 47, e.g. ar, sl, en)." @tier "presentation"
     onShapeClick   : event = "SHAPE_CLICK" @label "On Shape Click" @description "Clicked shape payload: { id?, type?, index }." @tier "presentation"
     onShapeHover   : event = "SHAPE_HOVER" @label "On Shape Hover" @description "Hovered shape payload: { id?, type?, index }." @tier "presentation"
     projector      : LearningCanvasProjector @label "Projector" @description "World-to-pixel projector for `drawables`. When absent, `drawables` are ignored." @tier "presentation"
     readouts       : [LearningCanvasReadoutsItem] = [] @label "Readouts" @description "Top-right status chip row (live measurements, scores, counters)." @synonyms "chips, stats, measurements" @tier "presentation"
     role           : string @label "Role" @description "WAI-ARIA role when the element's native semantics don't describe it." @tier "presentation" @values (alert alertdialog application article banner blockquote button caption cell checkbox code columnheader combobox complementary contentinfo definition deletion dialog document emphasis feed figure form generic grid gridcell group heading img insertion link list listbox listitem log main marquee math menu menubar menuitem menuitemcheckbox menuitemradio meter navigation none note option paragraph presentation progressbar radio radiogroup region row rowgroup rowheader scrollbar search searchbox separator slider spinbutton status strong subscript superscript switch tab table tablist tabpanel term textbox time timer toolbar tooltip tree treegrid treeitem)
+    series         : [string] = [] @label "Series" @description "Overrides the theme's categorical palette for this canvas: `series-1…N` resolve to these colors instead. For real-world conventions (CPK atom colors, resistor bands); unset, the theme's `--color-series-*` apply." @tier "presentation"
     shapes         : [LearningCanvasShapesItem] = [] @label "Shapes" @description "Declarative shapes to draw." @tier "presentation"
     skeleton       : string @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" @values (header table list grid detail stats form card text none)
     tabIndex       : number @label "Tab Index" @description "0 puts the element in the Tab order; -1 makes it focusable only programmatically." @tier "presentation"
@@ -26355,8 +26381,9 @@ trait ui-math-canvas.traits.MathCanvasRender {
     ariaLive       : string @label "Aria-live" @description "Announce changes to this region: polite waits for a pause, assertive interrupts." @synonyms "aria-live" @tier "presentation" @values (off polite assertive)
     ariaPressed    : string @label "Aria-pressed" @description "Toggle-button state." @synonyms "aria-pressed" @tier "presentation" @values (true false mixed)
     ariaSelected   : boolean @label "Aria-selected" @description "Whether this item is selected (tabs, options, grid cells)." @synonyms "aria-selected" @tier "presentation"
-    axisColor      : string = "var(--color-muted-foreground, #374151)" @label "Axis Color" @description "Axis line color; resolves theme tokens (default `var(--color-muted-foreground, #374151)`)." @tier "presentation"
-    backgroundColor : string @label "Background Color" @description "Canvas fill color; `var(--token, fallback)` strings resolve against the active theme. Default transparent." @tier "presentation"
+    aspect         : string = "fit" @label "Aspect" @description "How the x and y ranges map to the canvas. `fit` stretches each range to fill the plot (function plots); `equal` uses one scale for both axes so circles stay round (geometry). Default `fit`." @tier "presentation" @values (fit equal)
+    axisColor      : string = "axis" @label "Axis Color" @description "Axis line color: a tone name, token or literal (default the `axis` tone)." @tier "presentation"
+    backgroundColor : string @label "Background Color" @description "Canvas ground: a tone name, `var()` token or literal. Default the theme's `--surface-diagram`." @tier "presentation"
     bars           : [MathCanvasBarsItem] = [] @label "Bars" @description "Riemann/histogram bar strips." @tier "presentation"
     className      : string @label "Class Name" @description "className prop" @tier "presentation"
     curves         : [MathCanvasCurvesItem] = [] @label "Curves" @description "curves prop" @tier "presentation"
@@ -26366,7 +26393,7 @@ trait ui-math-canvas.traits.MathCanvasRender {
     enterDelay     : number @label "Enter Delay" @description "Stagger step for the entry: waits this many `--motion-enter-stagger` steps before animating." @tier "presentation"
     error          : MathCanvasError @label "Error" @description "error prop" @tier "presentation"
     fontFamily     : string @label "Font Family" @description "Canvas text font family. Accepts a known game-font key (e.g. 'future-narrow') or a CSS font-family string." @tier "presentation"
-    gridColor      : string = "var(--color-border, #9ca3af)" @label "Grid Color" @description "Grid line color; resolves theme tokens (default `var(--color-border, #9ca3af)`)." @tier "presentation"
+    gridColor      : string = "grid" @label "Grid Color" @description "Grid line color: a tone name, token or literal (default the `grid` tone)." @tier "presentation"
     gridStep       : number = 1 @label "Grid Step" @description "gridStep prop" @tier "presentation"
     guides         : [MathCanvasGuidesItem] = [] @label "Guides" @description "Fixed reference lines (vline/hline)." @tier "presentation"
     height         : number = 400 @label "Height" @description "height prop" @tier "presentation"
@@ -26375,13 +26402,14 @@ trait ui-math-canvas.traits.MathCanvasRender {
     isLoading      : boolean @label "Is Loading" @description "isLoading prop" @tier "presentation"
     keyMap         : Map<string,string> = {"item":"INIT"} @label "Key Map" @description "Maps a keydown `e.code` — optionally prefixed `Mod+` (⌘/Ctrl), `Shift+`, `Alt+` in that order — to the board's SEMANTIC event (device-agnostic input), emitted as `UI:{event}` — same contract as the game canvas keyMap; keystrokes inside inputs/textareas never route." @tier "presentation"
     keyUpMap       : Map<string,string> = {"item":"INIT"} @label "Key Up Map" @description "Maps a keyup `e.code` — optionally prefixed `Mod+` (⌘/Ctrl), `Shift+`, `Alt+` in that order — to the board's SEMANTIC event, emitted as `UI:{event}`; keystrokes inside inputs/textareas never route." @tier "presentation"
-    labelFontSize  : number = 12 @label "Label Font Size" @description "Base font size in px for all other canvas annotations (points, vectors, guides, curves, regions, angles, hops; default 12)." @tier "presentation"
+    labelFontSize  : number @label "Label Font Size" @description "Font size in px for all other canvas annotations (default the theme's diagram label size)." @tier "presentation"
     lang           : string @label "Lang" @description "Language of this element's content (BCP 47, e.g. ar, sl, en)." @tier "presentation"
     onShapeClick   : event = "SHAPE_CLICK" @label "On Shape Click" @description "onShapeClick prop" @tier "presentation"
     points         : [MathCanvasPointsItem] = [] @label "Points" @description "points prop" @tier "presentation"
     readouts       : [MathCanvasReadoutsItem] = [] @label "Readouts" @description "Top-right status chips, forwarded verbatim to LearningCanvas." @tier "presentation"
     regions        : [MathCanvasRegionsItem] = [] @label "Regions" @description "Filled areas under curves or between curve pairs." @tier "presentation"
     role           : string @label "Role" @description "WAI-ARIA role when the element's native semantics don't describe it." @tier "presentation" @values (alert alertdialog application article banner blockquote button caption cell checkbox code columnheader combobox complementary contentinfo definition deletion dialog document emphasis feed figure form generic grid gridcell group heading img insertion link list listbox listitem log main marquee math menu menubar menuitem menuitemcheckbox menuitemradio meter navigation none note option paragraph presentation progressbar radio radiogroup region row rowgroup rowheader scrollbar search searchbox separator slider spinbutton status strong subscript superscript switch tab table tablist tabpanel term textbox time timer toolbar tooltip tree treegrid treeitem)
+    series         : [string] = [] @label "Series" @description "Overrides the theme's categorical palette (`series-1…N`) for this canvas — real-world conventions like CPK atom colors or resistor bands. Unset, the theme's `--color-series-*` apply." @tier "presentation"
     shapes         : [MathCanvasShapesItem] = [] @label "Shapes" @description "Extra declarative shapes in canvas pixel coordinates." @tier "presentation"
     showAxes       : boolean = true @label "Show Axes" @description "showAxes prop" @tier "presentation"
     showCurveLabels : boolean = false @label "Show Curve Labels" @description "Draw each curve's `label` at its last in-range sample (default false)." @tier "presentation"
@@ -26389,7 +26417,7 @@ trait ui-math-canvas.traits.MathCanvasRender {
     showTickLabels : boolean = false @label "Show Tick Labels" @description "Draw numeric labels on grid lines (default false)." @tier "presentation"
     skeleton       : string @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" @values (header table list grid detail stats form card text none)
     tabIndex       : number @label "Tab Index" @description "0 puts the element in the Tab order; -1 makes it focusable only programmatically." @tier "presentation"
-    tickLabelFontSize : number = 10 @label "Tick Label Font Size" @description "Font size in px for axis tick labels (default 10)." @tier "presentation"
+    tickLabelFontSize : number @label "Tick Label Font Size" @description "Font size in px for axis tick labels (default the theme's `xs` step)." @tier "presentation"
     title          : string @label "Title" @description "title prop" @tier "presentation"
     traces         : [MathCanvasTracesItem] = [] @label "Traces" @description "Inset sparkline panels, forwarded verbatim to LearningCanvas." @tier "presentation"
     vectors        : [MathCanvasVectorsItem] = [] @label "Vectors" @description "vectors prop" @tier "presentation"
@@ -26540,6 +26568,8 @@ trait ui-physics-canvas.traits.PhysicsCanvasRender {
     height         : number = 400 @label "Height" @description "height prop" @tier "presentation"
     interactive    : boolean @label "Interactive" @description "2D: pointer interaction (click/hover). 3D: orbit camera controls." @tier "presentation"
     isLoading      : boolean @label "Is Loading" @description "isLoading prop" @tier "presentation"
+    keyMap         : Map<string,string> = {"item":"INIT"} @label "Key Map" @description "Maps a keydown `e.code` (optionally `Mod+`/`Shift+`/`Alt+` prefixed) to a SEMANTIC event emitted as `UI:{event}` — e.g. `{ Space: TOGGLE_RUN, ArrowRight: STEP, KeyR: RESET }`; keystrokes inside inputs never route." @tier "presentation"
+    keyUpMap       : Map<string,string> = {"item":"INIT"} @label "Key Up Map" @description "Maps a keyup `e.code` to a semantic event emitted as `UI:{event}`." @tier "presentation"
     lang           : string @label "Lang" @description "Language of this element's content (BCP 47, e.g. ar, sl, en)." @tier "presentation"
     lighting       : PhysicsCanvasLighting @label "Lighting" @description "3D only: scene light rig as data." @tier "presentation"
     meters         : [PhysicsCanvasMetersItem] = [] @label "Meters" @description "Bottom-left labeled bar gauges. 2D only." @tier "presentation"
@@ -26549,6 +26579,7 @@ trait ui-physics-canvas.traits.PhysicsCanvasRender {
     readouts       : [PhysicsCanvasReadoutsItem] = [] @label "Readouts" @description "Top-right status chip row, forwarded to LearningCanvas verbatim." @tier "presentation"
     role           : string @label "Role" @description "WAI-ARIA role when the element's native semantics don't describe it." @tier "presentation" @values (alert alertdialog application article banner blockquote button caption cell checkbox code columnheader combobox complementary contentinfo definition deletion dialog document emphasis feed figure form generic grid gridcell group heading img insertion link list listbox listitem log main marquee math menu menubar menuitem menuitemcheckbox menuitemradio meter navigation none note option paragraph presentation progressbar radio radiogroup region row rowgroup rowheader scrollbar search searchbox separator slider spinbutton status strong subscript superscript switch tab table tablist tabpanel term textbox time timer toolbar tooltip tree treegrid treeitem)
     sceneObjects   : [PhysicsCanvasSceneObjectsItem] = [] @label "Scene Objects" @description "Ground/wall/ramp/box/pivot scene fixtures. 2D only." @tier "presentation"
+    series         : [string] = [] @label "Series" @description "Overrides the theme's categorical palette (`series-1…N`) for this canvas — real-world conventions like CPK atom colors or resistor bands. Unset, the theme's `--color-series-*` apply." @tier "presentation"
     shadows        : boolean @label "Shadows" @description "3D only: enable shadows. Omitted → the host default." @tier "presentation"
     shapes         : [PhysicsCanvasShapesItem] = [] @label "Shapes" @description "Extra declarative shapes in canvas pixel coordinates (2D mode only — ignored in 3D)." @tier "presentation"
     showForces     : boolean = false @label "Show Forces" @description "showForces prop" @tier "presentation"
@@ -26580,7 +26611,7 @@ trait ui-presence.traits.PresenceRender {
   transitions    : ((idle -> idle on INIT))
   emits          : (@config.onExited)
   config {
-    animate        : boolean @label "Animate" @description "Per-instance opt-out. Global opt-out is `--motion-enable` / reduced-motion. @default true" @tier "presentation"
+    animate        : boolean = true @label "Animate" @description "Per-instance opt-out. Global opt-out is `--motion-enable` / reduced-motion. @default true" @tier "presentation"
     animation      : string = "modal" @label "Animation" @description "Which motion preset to use (maps to `animate-<name>-in/out`)." @tier "presentation" @values (modal overlay slide-up drawer popover toast fade page)
     ariaBusy       : boolean @label "Aria-busy" @description "This region is updating; assistive technology waits before announcing it." @synonyms "aria-busy" @tier "presentation"
     ariaCurrent    : string @label "Aria-current" @description "Marks the current item in a set: the current page, step, location, date or time." @synonyms "aria-current" @tier "presentation" @values (page step location date time true false)
@@ -26628,7 +26659,7 @@ trait ui-progress-bar.traits.ProgressBarRender {
     ariaPressed    : string @label "Aria-pressed" @description "Toggle-button state." @synonyms "aria-pressed" @tier "presentation" @values (true false mixed)
     ariaSelected   : boolean @label "Aria-selected" @description "Whether this item is selected (tabs, options, grid cells)." @synonyms "aria-selected" @tier "presentation"
     className      : string @label "Class Name" @description "Additional CSS classes" @tier "presentation"
-    color          : string @label "Color" @description "Color variant (alias for variant)" @tier "presentation" @values (default primary success warning error danger)
+    color          : string @label "Color" @description "Color variant (alias for variant; `variant` applies when omitted)" @tier "presentation" @values (default primary success warning error danger)
     dir            : string @label "Dir" @description "Text direction of this element's content." @tier "presentation" @values (ltr rtl auto)
     enter          : string @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" @values (none fade rise scale slide)
     enterDelay     : number @label "Enter Delay" @description "Stagger step for the entry: waits this many `--motion-enter-stagger` steps before animating." @tier "presentation"
@@ -28209,6 +28240,15 @@ page std-agent-planner.pages.AgentPlannerPage {
   source         : "@almadar/std (behaviors/registry/agent/atoms/std-agent-planner.orb orbitals[0].pages[0])"
 }
 
+;; From @almadar/std (behaviors/registry/agent/atoms/std-agent-session.orb orbitals[1].pages[0])
+page std-agent-session.pages.AgentChatsPage {
+  alias          : AgentSession
+  defaultPath    : /agent-session/chats
+  traits         : (AgentChatList AgentChatKeeper)
+  override-surface : (path linkedEntity traits)
+  source         : "@almadar/std (behaviors/registry/agent/atoms/std-agent-session.orb orbitals[1].pages[0])"
+}
+
 ;; From @almadar/std (behaviors/registry/agent/atoms/std-agent-session.orb orbitals[0].pages[0])
 page std-agent-session.pages.AgentSessionPage {
   alias          : AgentSession
@@ -29065,15 +29105,6 @@ page std-lifecycle.pages.LifecycleSchedulerPage {
   source         : "@almadar/std (behaviors/registry/infra/atoms/std-lifecycle.orb orbitals[0].pages[0])"
 }
 
-;; From @almadar/std (behaviors/registry/ui/core/atoms/std-list.orb orbitals[0].pages[0])
-page std-list.pages.ListItemPage {
-  alias          : List
-  defaultPath    : /listitems
-  traits         : (ListItemBrowse ListItemCreate ListItemEdit ListItemDelete ListItemPersistor)
-  override-surface : (path linkedEntity traits)
-  source         : "@almadar/std (behaviors/registry/ui/core/atoms/std-list.orb orbitals[0].pages[0])"
-}
-
 ;; From @almadar/std (behaviors/registry/ui/game/atoms/std-lives.orb orbitals[0].pages[0])
 page std-lives.pages.LivesPage {
   alias          : Lives
@@ -34433,6 +34464,7 @@ trait ui-accordion.traits.AccordionRender {
     openItems      : [string] = [] @label "Open Items" @description "Controlled open items (IDs)" @tier "presentation"
     role           : string @label "Role" @description "WAI-ARIA role when the element's native semantics don't describe it." @tier "presentation" @values (alert alertdialog application article banner blockquote button caption cell checkbox code columnheader combobox complementary contentinfo definition deletion dialog document emphasis feed figure form generic grid gridcell group heading img insertion link list listbox listitem log main marquee math menu menubar menuitem menuitemcheckbox menuitemradio meter navigation none note option paragraph presentation progressbar radio radiogroup region row rowgroup rowheader scrollbar search searchbox separator slider spinbutton status strong subscript superscript switch tab table tablist tabpanel term textbox time timer toolbar tooltip tree treegrid treeitem)
     skeleton       : string @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" @values (header table list grid detail stats form card text none)
+    surface        : string = "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" @values (auto none)
     tabIndex       : number @label "Tab Index" @description "0 puts the element in the Tab order; -1 makes it focusable only programmatically." @tier "presentation"
     toggleEvent    : event = "TOGGLE" @label "Toggle Event" @description "Declarative toggle event — emits UI:{toggleEvent} with { itemId, isOpen }" @tier "presentation"
   }
@@ -34481,16 +34513,18 @@ trait ui-agent-activity-feed.traits.AgentActivityFeedRender {
   linkedEntity   : AgentActivityFeedItem
   category       : interaction
   states         : (idle*)
-  events         : (INIT)
+  events         : (INIT @config.onJump)
   transitions    : ((idle -> idle on INIT))
+  emits          : (@config.onJump)
   config {
+    activities     : [AgentActivityFeedActivitiesItem] = [] @label "Activities" @description "activities prop" @tier "presentation"
     className      : string @label "Class Name" @description "className prop" @tier "presentation"
     emptyDescription : string @label "Empty Description" @description "emptyDescription prop" @tier "presentation"
     emptyTitle     : string @label "Empty Title" @description "emptyTitle prop" @tier "presentation"
     enter          : string @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" @values (none fade rise scale slide)
     enterDelay     : number @label "Enter Delay" @description "Stagger step for the entry: waits this many `--motion-enter-stagger` steps before animating." @tier "presentation"
     followLatest   : boolean = true @label "Follow Latest" @description "Scroll the latest row into view as rows arrive. Off for a list of feeds (a run history). @default true" @tier "presentation"
-    onJump         : string @label "On Jump" @description "onJump prop" @tier "presentation"
+    onJump         : event = "JUMP" @label "On Jump" @description "onJump prop" @tier "presentation"
     skeleton       : string @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" @values (header table list grid detail stats form card text none)
     working        : boolean = false @label "Working" @description "The agent is running: show the thinking row after the last activity." @tier "presentation"
   }
@@ -34508,6 +34542,7 @@ trait ui-agent-activity-row.traits.AgentActivityRowRender {
   transitions    : ((idle -> idle on INIT))
   emits          : (@config.onJump)
   config {
+    activity       : AgentActivityRowActivity = {} @label "Activity" @description "activity prop" @tier "presentation"
     facts          : AgentActivityRowFacts = {"readyCount":1,"settled":false} @label "Facts" @description "What the row knows from its list (`activityRowFacts`)." @tier "presentation"
     onJump         : event = "JUMP" @label "On Jump" @description "'Jump to' affordance — rendered only when supplied and the activity names an orbital." @tier "presentation"
   }
@@ -34524,6 +34559,7 @@ trait ui-agent-chat-feed.traits.AgentChatFeedRender {
   events         : (INIT)
   transitions    : ((idle -> idle on INIT))
   config {
+    activities     : [AgentChatFeedActivitiesItem] = [] @label "Activities" @description "Activities already selected by the host's manifest audience." @tier "presentation"
     className      : string @label "Class Name" @description "className prop" @tier "presentation"
     emptyTitle     : string = "" @label "Empty Title" @description "emptyTitle prop" @tier "presentation"
     enter          : string @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" @values (none fade rise scale slide)
@@ -34688,6 +34724,7 @@ trait ui-branching-logic-builder.traits.BranchingLogicBuilderRender {
     rules          : [BranchingLogicBuilderRulesItem] = [{"id":"Id","operator":"equals","sourceQuestionId":"Source Question Id","targetQuestionId":"Target Question Id","value":"Value"},{"id":"Id 2","operator":"not-equals","sourceQuestionId":"Source Question Id 2","targetQuestionId":"Target Question Id 2","value":"Value 2"}] @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"
     rulesChangeEvent : event = "RULES_CHANGE" @label "Rules Change Event" @description "Event name dispatched via event bus when rules change. Payload: `{ rules }`." @tier "presentation"
     skeleton       : string @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" @values (header table list grid detail stats form card text none)
+    surface        : string = "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" @values (auto none)
     tabIndex       : number @label "Tab Index" @description "0 puts the element in the Tab order; -1 makes it focusable only programmatically." @tier "presentation"
   }
   override-surface : (linkedEntity name events effects listens emitsScope config)
@@ -34770,6 +34807,7 @@ trait ui-calendar-grid.traits.CalendarGridRender {
     selfFetch      : boolean = true @label "Fetch its own rows on mount?" @description "true (default) = standalone mount self-populates on INIT. false = a composing atom owns the fetch and routes its loaded event here — suppresses the wrapper's own un-hydrated fetch so it cannot race the composer's." @tier "internal"
     skeleton       : string @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" @values (header table list grid detail stats form card text none)
     startField     : string = "startTime" @label "Start Field" @description "Row field holding the start timestamp (ISO or epoch). Defaults to `startTime`." @tier "presentation"
+    surface        : string = "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" @values (auto none)
     swipeLeftEvent : event = "SWIPE_LEFT" @label "Swipe Left Event" @description "Event emitted on swipe left (next week): UI:{swipeLeftEvent}" @tier "presentation"
     swipeRightEvent : event = "SWIPE_RIGHT" @label "Swipe Right Event" @description "Event emitted on swipe right (prev week): UI:{swipeRightEvent}" @tier "presentation"
     tabIndex       : number @label "Tab Index" @description "0 puts the element in the Tab order; -1 makes it focusable only programmatically." @tier "presentation"
@@ -34898,6 +34936,7 @@ trait ui-chart.traits.ChartRender {
     skeleton       : string = "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" @values (header table list grid detail stats form card text none)
     stack          : string = "none" @label "Stack" @description "Stack mode for bar / area" @tier "presentation" @values (none stack normalize)
     subtitle       : string @label "Subtitle" @description "Chart subtitle / description" @tier "presentation"
+    surface        : string = "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" @values (auto none)
     tabIndex       : number @label "Tab Index" @description "0 puts the element in the Tab order; -1 makes it focusable only programmatically." @tier "presentation"
     timeAxis       : boolean = false @label "Time Axis" @description "Format X-axis labels as time (ISO date in → 'Mar 2026'-style label out)" @tier "presentation"
     title          : string @label "Title" @description "Chart title" @tier "presentation"
@@ -35244,7 +35283,6 @@ trait ui-content-renderer.traits.ContentRendererRender {
     pageSize       : number @label "Page Size" @description "Number of items per page" @tier "presentation"
     role           : string @label "Role" @description "WAI-ARIA role when the element's native semantics don't describe it." @tier "presentation" @values (alert alertdialog application article banner blockquote button caption cell checkbox code columnheader combobox complementary contentinfo definition deletion dialog document emphasis feed figure form generic grid gridcell group heading img insertion link list listbox listitem log main marquee math menu menubar menuitem menuitemcheckbox menuitemradio meter navigation none note option paragraph presentation progressbar radio radiogroup region row rowgroup rowheader scrollbar search searchbox separator slider spinbutton status strong subscript superscript switch tab table tablist tabpanel term textbox time timer toolbar tooltip tree treegrid treeitem)
     searchValue    : string @label "Search Value" @description "Current search query value" @tier "presentation"
-    segments       : [ContentRendererSegmentsItem] = [] @label "Segments" @description "Pre-parsed segments (overrides content)" @tier "presentation"
     selectedIds    : [string] = [] @label "Selected Ids" @description "Currently selected item IDs" @tier "presentation"
     skeleton       : string @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" @values (header table list grid detail stats form card text none)
     sortBy         : string @label "Sort By" @description "── Display hints (set by trait via render-ui, never written by organism) ──" @tier "presentation"
@@ -35316,6 +35354,7 @@ trait ui-data-grid.traits.DataGridRender {
     selfFetch      : boolean = true @label "Fetch its own rows on mount?" @description "true (default) = standalone mount self-populates on INIT. false = a composing atom owns the fetch and routes its loaded event here — suppresses the wrapper's own un-hydrated fetch so it cannot race the composer's." @tier "internal"
     skeleton       : string = "grid" @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" @values (header table list grid detail stats form card text none)
     sortable       : boolean @label "Sortable" @description "Enable in-container reorder; items can be dragged to new positions among siblings" @tier "presentation"
+    surface        : string = "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" @values (auto none)
     tabIndex       : number @label "Tab Index" @description "0 puts the element in the Tab order; -1 makes it focusable only programmatically." @tier "presentation"
     viewerRole     : string = "" @label "Viewer's role" @description "The viewer's role that each action's `roles` is checked against; bind it at the call site (e.g. `viewerRole: @user.role`). Empty = only actions with no `roles` show." @tier "policy"
   }
@@ -35386,6 +35425,7 @@ trait ui-data-list.traits.DataListRender {
     sortable       : boolean @label "Sortable" @description "Enable in-container reorder; items can be dragged to new positions among siblings" @tier "presentation"
     sortBy         : string @label "Sort By" @description "Field name to order rows by. Values are compared by their own type — numbers numerically, date-like strings chronologically, everything else alphabetically — never by what the field is called. Empty cells sort last. Unset leaves the incoming order untouched. Orders only the rows already fetched: a collection larger than its `limit` still needs ordering at the data layer." @tier "presentation"
     sortDirection  : string @label "Sort Direction" @description "Direction for `sortBy`. Defaults to ascending." @tier "presentation" @values (asc desc)
+    surface        : string = "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" @values (auto none)
     swipeLeftActions : [DataListSwipeLeftActionsItem] = [] @label "Swipe Left Actions" @description "Actions revealed on left swipe" @tier "presentation"
     swipeLeftEvent : event = "SWIPE_LEFT" @label "Swipe Left Event" @description "Event emitted on left swipe: UI:{swipeLeftEvent} with { row }" @tier "presentation"
     swipeRightActions : [DataListSwipeRightActionsItem] = [] @label "Swipe Right Actions" @description "Actions revealed on right swipe" @tier "presentation"
@@ -35767,6 +35807,7 @@ trait ui-document-viewer.traits.DocumentViewerRender {
     showToolbar    : boolean = true @label "Show Toolbar" @description "Show toolbar" @tier "presentation"
     skeleton       : string @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" @values (header table list grid detail stats form card text none)
     src            : asset = "https://almadar-kflow-assets.web.app/shared/ui-roguelike-board/default/units/player.png" @label "Src" @description "Document URL (for PDF/external documents)" @tier "presentation"
+    surface        : string = "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" @values (auto none)
     tabIndex       : number @label "Tab Index" @description "0 puts the element in the Tab order; -1 makes it focusable only programmatically." @tier "presentation"
     title          : string @label "Title" @description "Document title" @tier "presentation"
     totalPages     : number @label "Total Pages" @description "Total pages" @tier "presentation"
@@ -35877,7 +35918,7 @@ trait ui-emoji-picker.traits.EmojiPickerRender {
     skeleton       : string @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" @values (header table list grid detail stats form card text none)
     tabIndex       : number @label "Tab Index" @description "0 puts the element in the Tab order; -1 makes it focusable only programmatically." @tier "presentation"
     triggerIcon    : icon @label "Trigger Icon" @description "Icon shown on the trigger button" @tier "presentation"
-    triggerLabel   : string @label "Trigger Label" @description "Accessible label for the trigger button" @tier "presentation"
+    triggerLabel   : string @label "Trigger Label" @description "Accessible label for the trigger button (the translated 'Add emoji' when omitted)" @tier "presentation"
   }
   override-surface : (linkedEntity name events effects listens emitsScope config)
   source         : "@almadar/std (behaviors/registry/ui/core/molecules/ui-emoji-picker.orb orbitals[0].traits[0])"
@@ -36545,6 +36586,7 @@ trait ui-gantt.traits.GanttRender {
     startField     : string = "start" @label "Start Field" @description "Row field holding the start timestamp (ISO or epoch). Defaults to `start`." @tier "presentation"
     statusColorMap : Map<string,GanttStatusColorMapValue> = {"item":"default"} @label "Status Color Map" @description "Bar colour per exact status value; unmapped statuses are primary bars." @tier "presentation"
     statusField    : string = "status" @label "Status Field" @description "Row field holding the bar status. Defaults to `status`." @tier "presentation"
+    surface        : string = "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" @values (auto none)
     tabIndex       : number @label "Tab Index" @description "0 puts the element in the Tab order; -1 makes it focusable only programmatically." @tier "presentation"
     titleField     : string = "title" @label "Title Field" @description "Row field holding the bar label. Defaults to `title`." @tier "presentation"
   }
@@ -36702,6 +36744,7 @@ trait ui-graph-view.traits.GraphViewRender {
     role           : string @label "Role" @description "WAI-ARIA role when the element's native semantics don't describe it." @tier "presentation" @values (alert alertdialog application article banner blockquote button caption cell checkbox code columnheader combobox complementary contentinfo definition deletion dialog document emphasis feed figure form generic grid gridcell group heading img insertion link list listbox listitem log main marquee math menu menubar menuitem menuitemcheckbox menuitemradio meter navigation none note option paragraph presentation progressbar radio radiogroup region row rowgroup rowheader scrollbar search searchbox separator slider spinbutton status strong subscript superscript switch tab table tablist tabpanel term textbox time timer toolbar tooltip tree treegrid treeitem)
     showLabels     : boolean = true @label "Show Labels" @description "Show node labels (default true)" @tier "presentation"
     skeleton       : string @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" @values (header table list grid detail stats form card text none)
+    surface        : string = "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" @values (auto none)
     tabIndex       : number @label "Tab Index" @description "0 puts the element in the Tab order; -1 makes it focusable only programmatically." @tier "presentation"
     width          : number @label "Width" @description "Width in pixels" @tier "presentation"
     zoomToFit      : boolean = true @label "Zoom To Fit" @description "Auto zoom-to-fit after layout settles (default true)" @tier "presentation"
@@ -36773,6 +36816,7 @@ trait ui-header.traits.HeaderRender {
     ariaLive       : string @label "Aria-live" @description "Announce changes to this region: polite waits for a pause, assertive interrupts." @synonyms "aria-live" @tier "presentation" @values (off polite assertive)
     ariaPressed    : string @label "Aria-pressed" @description "Toggle-button state." @synonyms "aria-pressed" @tier "presentation" @values (true false mixed)
     ariaSelected   : boolean @label "Aria-selected" @description "Whether this item is selected (tabs, options, grid cells)." @synonyms "aria-selected" @tier "presentation"
+    brandHref      : string @label "Brand Href" @description "Where the brand (logo + name) links to, usually the home page; empty leaves it unlinked" @tier "presentation"
     brandName      : string = "KFlow" @label "Brand Name" @description "Brand/App name" @tier "presentation"
     className      : string @label "Class Name" @description "Additional CSS classes" @tier "presentation"
     dir            : string @label "Dir" @description "Text direction of this element's content." @tier "presentation" @values (ltr rtl auto)
@@ -36883,6 +36927,7 @@ trait ui-import-preview-tree.traits.ImportPreviewTreeRender {
     role           : string @label "Role" @description "WAI-ARIA role when the element's native semantics don't describe it." @tier "presentation" @values (alert alertdialog application article banner blockquote button caption cell checkbox code columnheader combobox complementary contentinfo definition deletion dialog document emphasis feed figure form generic grid gridcell group heading img insertion link list listbox listitem log main marquee math menu menubar menuitem menuitemcheckbox menuitemradio meter navigation none note option paragraph presentation progressbar radio radiogroup region row rowgroup rowheader scrollbar search searchbox separator slider spinbutton status strong subscript superscript switch tab table tablist tabpanel term textbox time timer toolbar tooltip tree treegrid treeitem)
     skeleton       : string @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" @values (header table list grid detail stats form card text none)
     skipped        : [ImportPreviewTreeSkippedItem] = [] @label "Skipped" @description "Elements skipped during extraction, with reasons" @tier "presentation"
+    surface        : string = "auto" @label "Surface" @description "Content surface: `auto` paints the theme's surface behind each group tile unless it already sits on one (a card, dialog or another block); `none` opts out." @tier "presentation" @values (auto none)
     tabIndex       : number @label "Tab Index" @description "0 puts the element in the Tab order; -1 makes it focusable only programmatically." @tier "presentation"
     units          : [ImportPreviewTreeUnitsItem] = [] @label "Units" @description "Staged units to preview" @tier "presentation"
   }
@@ -37243,6 +37288,7 @@ trait ui-map-view.traits.MapViewRender {
     showAttribution : boolean = true @label "Show Attribution" @description "Show attribution (default true)" @tier "presentation"
     showClickedPin : boolean = false @label "Show Clicked Pin" @description "Whether to show a pin at the clicked location" @tier "presentation"
     skeleton       : string @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" @values (header table list grid detail stats form card text none)
+    surface        : string = "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" @values (auto none)
     tabIndex       : number @label "Tab Index" @description "0 puts the element in the Tab order; -1 makes it focusable only programmatically." @tier "presentation"
     zoom           : number = 13 @label "Zoom" @description "Zoom level (1-18, default 13)" @tier "presentation"
   }
@@ -37601,6 +37647,7 @@ trait ui-option-constraint-group.traits.OptionConstraintGroupRender {
     ariaSelected   : boolean @label "Aria-selected" @description "Whether this item is selected (tabs, options, grid cells)." @synonyms "aria-selected" @tier "presentation"
     changeEvent    : event = "CHANGE" @label "Change Event" @description "changeEvent prop" @tier "presentation"
     className      : string @label "Class Name" @description "className prop" @tier "presentation"
+    constraint     : OptionConstraintGroupConstraint @label "Constraint" @description "Selection constraint. Optional — defaults to single-select (the generic factory can't author a discriminated-union value; an author overrides it)." @tier "presentation"
     description    : string @label "Description" @description "description prop" @tier "presentation"
     dir            : string @label "Dir" @description "Text direction of this element's content." @tier "presentation" @values (ltr rtl auto)
     enter          : string @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" @values (none fade rise scale slide)
@@ -37697,7 +37744,7 @@ trait ui-page-header.traits.PageHeaderRender {
     onTabChange    : event = "TAB_CHANGE" @label "On Tab Change" @description "onTabChange prop" @tier "presentation"
     role           : string @label "Role" @description "WAI-ARIA role when the element's native semantics don't describe it." @tier "presentation" @values (alert alertdialog application article banner blockquote button caption cell checkbox code columnheader combobox complementary contentinfo definition deletion dialog document emphasis feed figure form generic grid gridcell group heading img insertion link list listbox listitem log main marquee math menu menubar menuitem menuitemcheckbox menuitemradio meter navigation none note option paragraph presentation progressbar radio radiogroup region row rowgroup rowheader scrollbar search searchbox separator slider spinbutton status strong subscript superscript switch tab table tablist tabpanel term textbox time timer toolbar tooltip tree treegrid treeitem)
     showBack       : boolean = false @label "Show Back" @description "Show back button" @tier "presentation"
-    skeleton       : string @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" @values (header table list grid detail stats form card text none)
+    skeleton       : string = "header" @label "Skeleton" @description "The shape an empty slot shows while this header's server render is in flight (`none` opts out). @default 'header'" @tier "presentation" @values (header table list grid detail stats form card text none)
     status         : PageHeaderStatus @label "Status" @description "Status badge — a bare string (an entity's status field bound directly, e.g. `status: @entity.status`) renders as a default-variant badge" @tier "presentation"
     subtitle       : scalar @label "Subtitle" @description "Optional subtitle/description" @tier "presentation"
     tabIndex       : number @label "Tab Index" @description "0 puts the element in the Tab order; -1 makes it focusable only programmatically." @tier "presentation"
@@ -38295,7 +38342,7 @@ trait ui-search-input.traits.SearchInputRender {
     isLoading      : boolean = false @label "Is Loading" @description "Show loading state" @tier "presentation"
     lang           : string @label "Lang" @description "Language of this element's content (BCP 47, e.g. ar, sl, en)." @tier "presentation"
     onSearch       : event = "SEARCH" @label "On Search" @description "Callback when search value changes" @tier "presentation"
-    placeholder    : string @label "Placeholder" @description "Placeholder text" @tier "presentation"
+    placeholder    : string @label "Placeholder" @description "Placeholder text (the translated 'Search' when omitted)" @tier "presentation"
     query          : string @label "Query" @description "Query singleton binding for state management. When provided, syncs search state with the query singleton. Example: '@TaskQuery'" @tier "presentation"
     role           : string @label "Role" @description "WAI-ARIA role when the element's native semantics don't describe it." @tier "presentation" @values (alert alertdialog application article banner blockquote button caption cell checkbox code columnheader combobox complementary contentinfo definition deletion dialog document emphasis feed figure form generic grid gridcell group heading img insertion link list listbox listitem log main marquee math menu menubar menuitem menuitemcheckbox menuitemradio meter navigation none note option paragraph presentation progressbar radio radiogroup region row rowgroup rowheader scrollbar search searchbox separator slider spinbutton status strong subscript superscript switch tab table tablist tabpanel term textbox time timer toolbar tooltip tree treegrid treeitem)
     skeleton       : string @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" @values (header table list grid detail stats form card text none)
@@ -38755,6 +38802,7 @@ trait ui-stat-display.traits.StatDisplayRender {
     skeleton       : string @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" @values (header table list grid detail stats form card text none)
     sparklineData  : [number] = [] @label "Sparkline Data" @description "Optional inline sparkline data appended to the trend row. Length < 2 renders nothing." @tier "presentation"
     suffix         : string @label "Suffix" @description "Suffix appended to the formatted value (e.g. ' /mo', ' ms')." @tier "presentation"
+    surface        : string = "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" @values (auto none)
     tabIndex       : number @label "Tab Index" @description "0 puts the element in the Tab order; -1 makes it focusable only programmatically." @tier "presentation"
     target         : number @label "Target" @description "Optional progress target. >0 renders a progress bar at value/target." @tier "presentation"
     trend          : number @label "Trend" @description "Signed delta vs previous period. >0 renders ↑ green, <0 renders ↓ red, 0 hides. Polarity reversal via `trendPolarity`." @tier "presentation"
@@ -38864,6 +38912,7 @@ trait ui-table-view.traits.TableViewRender {
     sortColumn     : string @label "Sort Column" @description "Current sort column (display hint for the active header arrow)." @tier "presentation"
     sortDirection  : string @label "Sort Direction" @description "Current sort direction (display hint)." @tier "presentation" @values (asc desc)
     sortEvent      : event = "SORT" @label "Sort Event" @description "Event emitted on sortable-header click: UI:{sortEvent} with { column, direction }." @tier "presentation"
+    surface        : string = "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" @values (auto none)
     tabIndex       : number @label "Tab Index" @description "0 puts the element in the Tab order; -1 makes it focusable only programmatically." @tier "presentation"
     viewerRole     : string = "" @label "Viewer's role" @description "The viewer's role that each action's `roles` is checked against; bind it at the call site (e.g. `viewerRole: @user.role`). Empty = only actions with no `roles` show." @tier "policy"
   }
@@ -40427,12 +40476,12 @@ page ui-wizard-progress.pages.WizardProgressPage {
   source         : "@almadar/std (behaviors/registry/ui/core/molecules/ui-wizard-progress.orb orbitals[0].pages[0])"
 }
 
-;; === organisms (40 behaviors, 40 apps, 41 orbitals, 41 entities, 41 traits, 42 pages) ===
+;; === organisms (36 behaviors, 36 apps, 37 orbitals, 37 entities, 37 traits, 37 pages) ===
 
 ;; From @almadar/std (behaviors/registry/agent/organisms/std-agent-assistant.orb)
 app std-agent-assistant {
   alias          : AgentAssistant
-  version        : "1.0.0"
+  version        : "2.0.0"
   orbitals       : (AgentAssistantOrbital AgentRecordsOrbital)
   override-surface : (config)
   ;; via uses Alias from "std/behaviors/std-agent-assistant" { config { ... } }
@@ -40649,36 +40698,6 @@ app ui-drawer-slot {
   source         : "@almadar/std (behaviors/registry/ui/core/organisms/ui-drawer-slot.orb)"
 }
 
-;; From @almadar/std (behaviors/registry/ui/core/organisms/ui-entity-cards.orb)
-app ui-entity-cards {
-  alias          : UiEntityCards
-  version        : "1.0.0"
-  orbitals       : (EntityCardsOrbital)
-  override-surface : (config)
-  ;; via uses Alias from "std/behaviors/ui-entity-cards" { config { ... } }
-  source         : "@almadar/std (behaviors/registry/ui/core/organisms/ui-entity-cards.orb)"
-}
-
-;; From @almadar/std (behaviors/registry/ui/core/organisms/ui-entity-list.orb)
-app ui-entity-list {
-  alias          : UiEntityList
-  version        : "1.0.0"
-  orbitals       : (EntityListOrbital)
-  override-surface : (config)
-  ;; via uses Alias from "std/behaviors/ui-entity-list" { config { ... } }
-  source         : "@almadar/std (behaviors/registry/ui/core/organisms/ui-entity-list.orb)"
-}
-
-;; From @almadar/std (behaviors/registry/ui/core/organisms/ui-entity-table.orb)
-app ui-entity-table {
-  alias          : UiEntityTable
-  version        : "1.0.0"
-  orbitals       : (EntityTableOrbital)
-  override-surface : (config)
-  ;; via uses Alias from "std/behaviors/ui-entity-table" { config { ... } }
-  source         : "@almadar/std (behaviors/registry/ui/core/organisms/ui-entity-table.orb)"
-}
-
 ;; From @almadar/std (behaviors/registry/ui/core/organisms/ui-form.orb)
 app ui-form {
   alias          : UiForm
@@ -40699,16 +40718,6 @@ app ui-form-section {
   source         : "@almadar/std (behaviors/registry/ui/core/organisms/ui-form-section.orb)"
 }
 
-;; From @almadar/std (behaviors/registry/ui/core/organisms/ui-master-detail.orb)
-app ui-master-detail {
-  alias          : UiMasterDetail
-  version        : "1.0.0"
-  orbitals       : (MasterDetailOrbital)
-  override-surface : (config)
-  ;; via uses Alias from "std/behaviors/ui-master-detail" { config { ... } }
-  source         : "@almadar/std (behaviors/registry/ui/core/organisms/ui-master-detail.orb)"
-}
-
 ;; From @almadar/std (behaviors/registry/ui/core/organisms/ui-master-detail-layout.orb)
 app ui-master-detail-layout {
   alias          : UiMasterDetailLayout
@@ -40833,15 +40842,18 @@ app ui-toast-slot {
 orbital std-agent-assistant.orbitals.AgentAssistantOrbital {
   alias          : AgentAssistant
   entity         : AgentAssistant
-  traits         : (AssistantThread = Session.traits.AgentThread AssistantContext = Context.traits.AgentContextCompactor AssistantMemory = Memory.traits.AgentMemoryRecall AssistantLoop = Loop.traits.AgentToolLoop AssistantTrace = Trace.traits.AgentTraceRecorder)
+  traits         : (AssistantThread = Session.traits.AgentThread AssistantChatKeeper = Session.traits.AgentChatKeeper AssistantConversation = Session.traits.AgentConversation AssistantLayout = Shell.traits.AppLayout AssistantContext = Context.traits.AgentContextCompactor AssistantMemory = Memory.traits.AgentMemoryRecall AssistantLoop = Loop.traits.AgentToolLoop AssistantTrace = Trace.traits.AgentTraceRecorder)
   pages          : ("/assistant")
   config {
+    appName        : string = "Assistant" @label "App name in the assistant page's header" @description "Pass the app's own name so the assistant page matches the rest of the app." @tier "presentation"
     instructions   : string = "You operate this app for the signed-in user. Use the tools to act and to look things up; when a tool reports that something was refused or denied, say so plainly." @label "How should the assistant behave?" @description "Standing instructions sent with every request." @synonyms "system prompt, persona, guidance" @tier "domain"
     keepMessages   : number = 12 @label "Turns kept verbatim" @tier "policy"
-    links          : [AgentLink] = [{"href":"/assistant/runs","label":"Run history"},{"href":"/assistant/memory","label":"What I remember"}] @label "Links above the conversation" @description "The pages showing the assistant's run history and memory." @tier "presentation"
+    links          : [AgentLink] = [{"href":"/assistant/runs","label":"Run history"}] @label "Links above the conversation" @description "Related pages, e.g. the assistant's run history." @tier "presentation"
     maxSteps       : number = 8 @label "Model round-trips per request" @tier "policy"
+    navItems       : [NavItem] = [] @label "Sidebar navigation on the assistant page" @description "Pass the app's own navItems so the assistant page keeps the app's sidebar." @tier "presentation"
     recallLimit    : number = 3 @label "Memories recalled per request" @tier "policy"
-    tools          : [AgentTool] = [] @label "What may the assistant do?" @description "The declared inputs it may fire (`{ event: Trait.EVENT }` / `{ event: Orbital.Trait.EVENT }`) and the entities it may read (`{ read: Entity }`), as the signed-in user." @synonyms "allowlist, abilities, actions, permissions" @tier "domain"
+    tools          : [AgentTool] = [{"scope":"declared"}] @label "What may the assistant do?" @description "As the signed-in user: `{ scope: declared }` (the default) gives it every external input the program declares and a read over every persisted entity, so each building block's declared inputs become its abilities; or list them — `{ event: Orbital.Trait.EVENT }` for one input, `{ read: Entity }` for one entity." @synonyms "allowlist, abilities, actions, permissions" @tier "domain"
+    viewerRole     : string = "" @label "Viewer role on the assistant page" @description "The role the assistant page's sidebar items and their `roles` are checked against. Bind `@user.role` in an app whose identity carries a role; left empty, only items with no `roles` show." @tier "policy"
   }
   override-surface : (entity fields extend pages omit only config events roles entities mounts)
   source         : "@almadar/std (behaviors/registry/agent/organisms/std-agent-assistant.orb orbitals[0])"
@@ -40851,8 +40863,8 @@ orbital std-agent-assistant.orbitals.AgentAssistantOrbital {
 orbital std-agent-assistant.orbitals.AgentRecordsOrbital {
   alias          : AgentAssistant
   entity         : AgentRun
-  traits         : (AgentRunHistory = Trace.traits.AgentRunBrowse AgentMemoryList = Memory.traits.AgentMemoryBrowse)
-  pages          : ("/assistant/runs" "/assistant/memory")
+  traits         : (AgentRunHistory = Trace.traits.AgentRunBrowse)
+  pages          : ("/assistant/runs")
   override-surface : (entity fields extend pages omit only config events roles entities mounts)
   source         : "@almadar/std (behaviors/registry/agent/organisms/std-agent-assistant.orb orbitals[1])"
 }
@@ -41067,36 +41079,6 @@ orbital ui-drawer-slot.orbitals.DrawerSlotOrbital {
   source         : "@almadar/std (behaviors/registry/ui/core/organisms/ui-drawer-slot.orb orbitals[0])"
 }
 
-;; From @almadar/std (behaviors/registry/ui/core/organisms/ui-entity-cards.orb orbitals[0])
-orbital ui-entity-cards.orbitals.EntityCardsOrbital {
-  alias          : UiEntityCards
-  entity         : EntityCardsItem
-  traits         : (EntityCardsRender)
-  pages          : ("/entity-cards")
-  override-surface : (entity fields extend pages omit only config events roles entities mounts)
-  source         : "@almadar/std (behaviors/registry/ui/core/organisms/ui-entity-cards.orb orbitals[0])"
-}
-
-;; From @almadar/std (behaviors/registry/ui/core/organisms/ui-entity-list.orb orbitals[0])
-orbital ui-entity-list.orbitals.EntityListOrbital {
-  alias          : UiEntityList
-  entity         : EntityListItem
-  traits         : (EntityListRender)
-  pages          : ("/entity-list")
-  override-surface : (entity fields extend pages omit only config events roles entities mounts)
-  source         : "@almadar/std (behaviors/registry/ui/core/organisms/ui-entity-list.orb orbitals[0])"
-}
-
-;; From @almadar/std (behaviors/registry/ui/core/organisms/ui-entity-table.orb orbitals[0])
-orbital ui-entity-table.orbitals.EntityTableOrbital {
-  alias          : UiEntityTable
-  entity         : EntityTableItem
-  traits         : (EntityTableRender)
-  pages          : ("/entity-table")
-  override-surface : (entity fields extend pages omit only config events roles entities mounts)
-  source         : "@almadar/std (behaviors/registry/ui/core/organisms/ui-entity-table.orb orbitals[0])"
-}
-
 ;; From @almadar/std (behaviors/registry/ui/core/organisms/ui-form.orb orbitals[0])
 orbital ui-form.orbitals.FormOrbital {
   alias          : UiForm
@@ -41117,16 +41099,6 @@ orbital ui-form-section.orbitals.FormSectionOrbital {
   source         : "@almadar/std (behaviors/registry/ui/core/organisms/ui-form-section.orb orbitals[0])"
 }
 
-;; From @almadar/std (behaviors/registry/ui/core/organisms/ui-master-detail.orb orbitals[0])
-orbital ui-master-detail.orbitals.MasterDetailOrbital {
-  alias          : UiMasterDetail
-  entity         : MasterDetailItem
-  traits         : (MasterDetailRender)
-  pages          : ("/master-detail")
-  override-surface : (entity fields extend pages omit only config events roles entities mounts)
-  source         : "@almadar/std (behaviors/registry/ui/core/organisms/ui-master-detail.orb orbitals[0])"
-}
-
 ;; From @almadar/std (behaviors/registry/ui/core/organisms/ui-master-detail-layout.orb orbitals[0])
 orbital ui-master-detail-layout.orbitals.MasterDetailLayoutOrbital {
   alias          : UiMasterDetailLayout
@@ -41478,36 +41450,6 @@ entity ui-drawer-slot.entity {
   source         : "@almadar/std (behaviors/registry/ui/core/organisms/ui-drawer-slot.orb orbitals[0].entity)"
 }
 
-;; From @almadar/std (behaviors/registry/ui/core/organisms/ui-entity-cards.orb orbitals[0].entity)
-entity ui-entity-cards.entity {
-  alias          : UiEntityCards
-  name           : EntityCardsItem
-  persistence    : runtime
-  fields         : (id!)
-  override-surface : (extends name fields persistence collection)
-  source         : "@almadar/std (behaviors/registry/ui/core/organisms/ui-entity-cards.orb orbitals[0].entity)"
-}
-
-;; From @almadar/std (behaviors/registry/ui/core/organisms/ui-entity-list.orb orbitals[0].entity)
-entity ui-entity-list.entity {
-  alias          : UiEntityList
-  name           : EntityListItem
-  persistence    : runtime
-  fields         : (id!)
-  override-surface : (extends name fields persistence collection)
-  source         : "@almadar/std (behaviors/registry/ui/core/organisms/ui-entity-list.orb orbitals[0].entity)"
-}
-
-;; From @almadar/std (behaviors/registry/ui/core/organisms/ui-entity-table.orb orbitals[0].entity)
-entity ui-entity-table.entity {
-  alias          : UiEntityTable
-  name           : EntityTableItem
-  persistence    : runtime
-  fields         : (id!)
-  override-surface : (extends name fields persistence collection)
-  source         : "@almadar/std (behaviors/registry/ui/core/organisms/ui-entity-table.orb orbitals[0].entity)"
-}
-
 ;; From @almadar/std (behaviors/registry/ui/core/organisms/ui-form.orb orbitals[0].entity)
 entity ui-form.entity {
   alias          : UiForm
@@ -41528,16 +41470,6 @@ entity ui-form-section.entity {
   source         : "@almadar/std (behaviors/registry/ui/core/organisms/ui-form-section.orb orbitals[0].entity)"
 }
 
-;; From @almadar/std (behaviors/registry/ui/core/organisms/ui-master-detail.orb orbitals[0].entity)
-entity ui-master-detail.entity {
-  alias          : UiMasterDetail
-  name           : MasterDetailItem
-  persistence    : runtime
-  fields         : (id!)
-  override-surface : (extends name fields persistence collection)
-  source         : "@almadar/std (behaviors/registry/ui/core/organisms/ui-master-detail.orb orbitals[0].entity)"
-}
-
 ;; From @almadar/std (behaviors/registry/ui/core/organisms/ui-master-detail-layout.orb orbitals[0].entity)
 entity ui-master-detail-layout.entity {
   alias          : UiMasterDetailLayout
@@ -42163,6 +42095,7 @@ trait ui-dashboard-grid.traits.DashboardGridRender {
     skeleton       : string @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" @values (header table list grid detail stats form card text none)
     sortBy         : string @label "Sort By" @description "Current sort field" @tier "presentation"
     sortDirection  : string @label "Sort Direction" @description "Current sort direction" @tier "presentation" @values (asc desc)
+    surface        : string = "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. Each cell is a tile." @tier "presentation" @values (auto none)
     tabIndex       : number @label "Tab Index" @description "0 puts the element in the Tab order; -1 makes it focusable only programmatically." @tier "presentation"
     totalCount     : number @label "Total Count" @description "Total number of items" @tier "presentation"
   }
@@ -42206,7 +42139,7 @@ trait ui-detail-panel.traits.DetailPanelRender {
     enterDelay     : number @label "Enter Delay" @description "Stagger step for the entry: waits this many `--motion-enter-stagger` steps before animating." @tier "presentation"
     error          : DetailPanelError @label "Error" @description "Error state (UiError)" @tier "presentation"
     fieldNames     : [string] = [] @label "Field Names" @description "Alias for fields - backwards compatibility" @tier "presentation"
-    fields         : [DetailPanelFieldsItem] = [{"format":"date","icon":"circle","label":"Label","name":"Name","relation":{"cardinality":"one","entity":"Entity"},"type":"Type","values":["Item","Item 2"],"variant":"h3"},{"format":"datetime","icon":"circle","label":"Label 2","name":"Name 2","relation":{"cardinality":"many","entity":"Entity 2"},"type":"Type 2","values":["Item","Item 2"],"variant":"h4"}] @label "Fields" @description "Fields to display: field names, or declared fields ({ name, label, variant, format, colorMap, labels })" @tier "presentation"
+    fields         : [DetailPanelFieldsItem] = [{"format":"date","icon":"circle","label":"Label","name":"Name","relation":{"cardinality":"one","entity":"Entity"},"type":"Type","values":["Item","Item 2"],"variant":"h3"},{"format":"time","icon":"circle","label":"Label 2","name":"Name 2","relation":{"cardinality":"many","entity":"Entity 2"},"type":"Type 2","values":["Item","Item 2"],"variant":"h4"}] @label "Fields" @description "Fields to display: field names, or declared fields ({ name, label, variant, format, colorMap, labels })" @tier "presentation"
     footer         : node @label "Footer" @description "footer prop" @tier "presentation"
     isLoading      : boolean = false @label "Is Loading" @description "Loading state indicator" @tier "presentation"
     lang           : string @label "Lang" @description "Language of this element's content (BCP 47, e.g. ar, sl, en)." @tier "presentation"
@@ -42237,6 +42170,7 @@ trait ui-detail-panel.traits.DetailPanelRender {
     stages         : [DetailPanelStagesItem] = [] @label "Stages" @description "The lifecycle in order, `{ value, label }` per stage (workflow)." @tier "presentation"
     status         : DetailPanelStatus @label "Status" @description "status prop" @tier "presentation"
     subtitle       : string @label "Subtitle" @description "subtitle prop" @tier "presentation"
+    surface        : string = "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. Inline mode only; the slide-over is itself a surface." @tier "presentation" @values (auto none)
     tabIndex       : number @label "Tab Index" @description "0 puts the element in the Tab order; -1 makes it focusable only programmatically." @tier "presentation"
     tabs           : [DetailPanelTabsItem] = [] @label "Tabs" @description "Tabs after the overview tab, each listing declared field names (workspace)." @tier "presentation"
     threadContent  : node @label "Thread Content" @description "The thread composed in instead of `thread` — e.g. the replies' own trait with its composer (conversation)." @tier "presentation"
@@ -42272,7 +42206,7 @@ trait ui-dock-layout.traits.DockLayoutRender {
     ariaSelected   : boolean @label "Aria-selected" @description "Whether this item is selected (tabs, options, grid cells)." @synonyms "aria-selected" @tier "presentation"
     bottomPanel    : node @label "Bottom Panel" @description "Collapsible, resizable-height bottom panel." @tier "presentation"
     bottomPanelClassName : string @label "Bottom Panel Class Name" @description "bottomPanelClassName prop" @tier "presentation"
-    bottomPanelCollapsed : boolean @label "Bottom Panel Collapsed" @description "Whether `bottomPanel` is collapsed. @default false" @tier "presentation"
+    bottomPanelCollapsed : boolean @label "Bottom Panel Collapsed" @description "Whether `bottomPanel` is collapsed (controlled; the layout keeps its own state when omitted)." @tier "presentation"
     bottomPanelHeight : number = 30 @label "Bottom Panel Height" @description "Bottom panel size as a SplitPane ratio (0-100, percentage given to the panel). @default 30" @tier "presentation"
     bottomPanelIcon : icon @label "Bottom Panel Icon" @description "bottomPanelIcon prop" @tier "presentation"
     bottomPanelLabel : string @label "Bottom Panel Label" @description "Compact: the top-bar button that opens `bottomPanel`." @tier "presentation"
@@ -42296,13 +42230,13 @@ trait ui-dock-layout.traits.DockLayoutRender {
     role           : string @label "Role" @description "WAI-ARIA role when the element's native semantics don't describe it." @tier "presentation" @values (alert alertdialog application article banner blockquote button caption cell checkbox code columnheader combobox complementary contentinfo definition deletion dialog document emphasis feed figure form generic grid gridcell group heading img insertion link list listbox listitem log main marquee math menu menubar menuitem menuitemcheckbox menuitemradio meter navigation none note option paragraph presentation progressbar radio radiogroup region row rowgroup rowheader scrollbar search searchbox separator slider spinbutton status strong subscript superscript switch tab table tablist tabpanel term textbox time timer toolbar tooltip tree treegrid treeitem)
     secondarySidebar : node @label "Secondary Sidebar" @description "Collapsible right sidebar." @tier "presentation"
     secondarySidebarClassName : string @label "Secondary Sidebar Class Name" @description "secondarySidebarClassName prop" @tier "presentation"
-    secondarySidebarCollapsed : boolean @label "Secondary Sidebar Collapsed" @description "Whether `secondarySidebar` is collapsed. @default false" @tier "presentation"
+    secondarySidebarCollapsed : boolean @label "Secondary Sidebar Collapsed" @description "Whether `secondarySidebar` is collapsed (controlled; the layout keeps its own state when omitted)." @tier "presentation"
     secondarySidebarIcon : icon @label "Secondary Sidebar Icon" @description "secondarySidebarIcon prop" @tier "presentation"
     secondarySidebarLabel : string @label "Secondary Sidebar Label" @description "Compact: the top-bar button that opens `secondarySidebar` (e.g. 'Inspector', 'Chat')." @tier "presentation"
     secondarySidebarWidth : number = 280 @label "Secondary Sidebar Width" @description "Width of `secondarySidebar` in pixels (fixed — not resizable). @default 280" @tier "presentation"
     sidebar        : node @label "Sidebar" @description "Collapsible, resizable left sidebar." @tier "presentation"
     sidebarClassName : string @label "Sidebar Class Name" @description "sidebarClassName prop" @tier "presentation"
-    sidebarCollapsed : boolean @label "Sidebar Collapsed" @description "Whether `sidebar` is collapsed. @default false" @tier "presentation"
+    sidebarCollapsed : boolean @label "Sidebar Collapsed" @description "Whether `sidebar` is collapsed (controlled; the layout keeps its own state when omitted)." @tier "presentation"
     sidebarMinSize : number = 160 @label "Sidebar Min Size" @description "Minimum sidebar size in pixels, forwarded to SplitPane's `minSize`. @default 160" @tier "presentation"
     sidebarWidth   : number = 20 @label "Sidebar Width" @description "Sidebar size as a SplitPane ratio (0-100, percentage of the sidebar/main split). @default 20" @tier "presentation"
     skeleton       : string @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" @values (header table list grid detail stats form card text none)
@@ -42340,184 +42274,6 @@ trait ui-drawer-slot.traits.DrawerSlotRender {
   source         : "@almadar/std (behaviors/registry/ui/core/organisms/ui-drawer-slot.orb orbitals[0].traits[0])"
 }
 
-;; From @almadar/std (behaviors/registry/ui/core/organisms/ui-entity-cards.orb orbitals[0].traits[0])
-trait ui-entity-cards.traits.EntityCardsRender {
-  alias          : UiEntityCards
-  linkedEntity   : EntityCardsItem
-  category       : interaction
-  states         : (idle*)
-  events         : (INIT EntityCardsLoaded @config.itemClickEvent VIEW)
-  transitions    : ((idle -> idle on INIT) (idle -> idle on INIT) (idle -> idle on EntityCardsLoaded))
-  emits          : (@config.itemClickEvent VIEW EntityCardsLoaded)
-  config {
-    activeFilters  : Map<string,string> = {} @label "Active Filters" @description "Active filters" @tier "presentation"
-    alignItems     : string = "stretch" @label "Align Items" @description "Align cards vertically in their cells" @tier "presentation" @values (start center end stretch)
-    ariaBusy       : boolean @label "Aria-busy" @description "This region is updating; assistive technology waits before announcing it." @synonyms "aria-busy" @tier "presentation"
-    ariaCurrent    : string @label "Aria-current" @description "Marks the current item in a set: the current page, step, location, date or time." @synonyms "aria-current" @tier "presentation" @values (page step location date time true false)
-    ariaDescribedby : string @label "Aria-describedby" @description "Id of the element whose text describes this one (help text, error)." @synonyms "aria-describedby" @tier "presentation"
-    ariaExpanded   : boolean @label "Aria-expanded" @description "Whether the element it controls is expanded." @synonyms "aria-expanded" @tier "presentation"
-    ariaHidden     : boolean @label "Aria-hidden" @description "Hide from assistive technology (decorative content only)." @synonyms "aria-hidden" @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)." @synonyms "aria-label" @tier "presentation"
-    ariaLabelledby : string @label "Aria-labelledby" @description "Id of the element whose text names this one." @synonyms "aria-labelledby" @tier "presentation"
-    ariaLive       : string @label "Aria-live" @description "Announce changes to this region: polite waits for a pause, assertive interrupts." @synonyms "aria-live" @tier "presentation" @values (off polite assertive)
-    ariaPressed    : string @label "Aria-pressed" @description "Toggle-button state." @synonyms "aria-pressed" @tier "presentation" @values (true false mixed)
-    ariaSelected   : boolean @label "Aria-selected" @description "Whether this item is selected (tabs, options, grid cells)." @synonyms "aria-selected" @tier "presentation"
-    children       : node @label "Children" @description "Children elements (cards) - optional when using entity prop" @tier "presentation"
-    className      : string @label "Class Name" @description "Additional CSS classes" @tier "presentation"
-    columns        : [EntityCardsColumnsItem] = [] @label "Columns" @description "Alias for fields - backwards compatibility" @tier "presentation"
-    dir            : string @label "Dir" @description "Text direction of this element's content." @tier "presentation" @values (ltr rtl auto)
-    enter          : string @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" @values (none fade rise scale slide)
-    enterDelay     : number @label "Enter Delay" @description "Stagger step for the entry: waits this many `--motion-enter-stagger` steps before animating." @tier "presentation"
-    error          : EntityCardsError @label "Error" @description "Error state (UiError)" @tier "presentation"
-    fieldNames     : [string] = [] @label "Field Names" @description "Alias for fields - backwards compatibility" @tier "presentation"
-    fields         : [EntityCardsFieldsItem] = [{"format":"date","icon":"circle","label":"Label","name":"Name","variant":"h3"},{"format":"datetime","icon":"circle","label":"Label 2","name":"Name 2","variant":"h4"}] @label "Fields" @description "Fields to display - required for schema-driven rendering" @tier "presentation"
-    gap            : string = "md" @label "Gap" @description "Gap between cards" @tier "presentation" @values (none sm md lg xl)
-    imageField     : string @label "Image Field" @description "Entity field name containing an image URL to display as card thumbnail" @tier "presentation"
-    isLoading      : boolean = false @label "Is Loading" @description "Loading state indicator" @tier "presentation"
-    itemActions    : [EntityCardsItemActionsItem] = [{"event":"VIEW","label":"View","variant":"ghost"}] @label "Item Actions" @description "Actions for each card item (schema-driven)" @tier "presentation"
-    itemClickEvent : event = "ITEM_CLICK" @label "Item Click Event" @description "When set, clicking a card emits UI:{itemClickEvent} with { id, row }. Omit = cards are not clickable." @tier "presentation"
-    lang           : string @label "Lang" @description "Language of this element's content (BCP 47, e.g. ar, sl, en)." @tier "presentation"
-    maxCols        : number @label "Max Cols" @description "Maximum number of columns" @tier "presentation"
-    minCardWidth   : number = 280 @label "Min Card Width" @description "Minimum width of each card (default: 280px)" @tier "presentation"
-    pageProp       : number @label "Page" @description "Current page number" @synonyms "page" @tier "presentation"
-    pageSize       : number @label "Page Size" @description "Number of items per page" @tier "presentation"
-    role           : string @label "Role" @description "WAI-ARIA role when the element's native semantics don't describe it." @tier "presentation" @values (alert alertdialog application article banner blockquote button caption cell checkbox code columnheader combobox complementary contentinfo definition deletion dialog document emphasis feed figure form generic grid gridcell group heading img insertion link list listbox listitem log main marquee math menu menubar menuitem menuitemcheckbox menuitemradio meter navigation none note option paragraph presentation progressbar radio radiogroup region row rowgroup rowheader scrollbar search searchbox separator slider spinbutton status strong subscript superscript switch tab table tablist tabpanel term textbox time timer toolbar tooltip tree treegrid treeitem)
-    searchValue    : string @label "Search Value" @description "Current search query value" @tier "presentation"
-    selectedIds    : [string] = [] @label "Selected Ids" @description "Currently selected item IDs" @tier "presentation"
-    selfFetch      : boolean = true @label "Fetch its own rows on mount?" @description "true (default) = standalone mount self-populates on INIT. false = a composing atom owns the fetch and routes its loaded event here — suppresses the wrapper's own un-hydrated fetch so it cannot race the composer's." @tier "internal"
-    showAvatar     : boolean @label "Show Avatar" @description "Show avatar/image field on cards" @tier "presentation"
-    showTotal      : boolean = true @label "Show Total" @description "Show total count in pagination" @tier "presentation"
-    skeleton       : string = "grid" @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" @values (header table list grid detail stats form card text none)
-    sortBy         : string @label "Sort By" @description "Current sort field" @tier "presentation"
-    sortDirection  : string @label "Sort Direction" @description "Current sort direction" @tier "presentation" @values (asc desc)
-    tabIndex       : number @label "Tab Index" @description "0 puts the element in the Tab order; -1 makes it focusable only programmatically." @tier "presentation"
-    totalCount     : number @label "Total Count" @description "Total number of items" @tier "presentation"
-    variant        : string @label "Variant" @description "Visual variant for the card grid" @tier "presentation"
-    viewerRole     : string = "" @label "Viewer's role" @description "The viewer's role that each action's `roles` is checked against; bind it at the call site (e.g. `viewerRole: @user.role`). Empty = only actions with no `roles` show." @tier "policy"
-  }
-  override-surface : (linkedEntity name events effects listens emitsScope config)
-  source         : "@almadar/std (behaviors/registry/ui/core/organisms/ui-entity-cards.orb orbitals[0].traits[0])"
-}
-
-;; From @almadar/std (behaviors/registry/ui/core/organisms/ui-entity-list.orb orbitals[0].traits[0])
-trait ui-entity-list.traits.EntityListRender {
-  alias          : UiEntityList
-  linkedEntity   : EntityListItem
-  category       : interaction
-  states         : (idle*)
-  events         : (INIT EntityListLoaded ITEM_ACTIONS @config.itemClickEvent VIEW)
-  transitions    : ((idle -> idle on INIT) (idle -> idle on INIT) (idle -> idle on EntityListLoaded))
-  emits          : (ITEM_ACTIONS @config.itemClickEvent VIEW EntityListLoaded)
-  config {
-    activeFilters  : Map<string,string> = {} @label "Active Filters" @description "Active filters" @tier "presentation"
-    ariaBusy       : boolean @label "Aria-busy" @description "This region is updating; assistive technology waits before announcing it." @synonyms "aria-busy" @tier "presentation"
-    ariaCurrent    : string @label "Aria-current" @description "Marks the current item in a set: the current page, step, location, date or time." @synonyms "aria-current" @tier "presentation" @values (page step location date time true false)
-    ariaDescribedby : string @label "Aria-describedby" @description "Id of the element whose text describes this one (help text, error)." @synonyms "aria-describedby" @tier "presentation"
-    ariaExpanded   : boolean @label "Aria-expanded" @description "Whether the element it controls is expanded." @synonyms "aria-expanded" @tier "presentation"
-    ariaHidden     : boolean @label "Aria-hidden" @description "Hide from assistive technology (decorative content only)." @synonyms "aria-hidden" @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)." @synonyms "aria-label" @tier "presentation"
-    ariaLabelledby : string @label "Aria-labelledby" @description "Id of the element whose text names this one." @synonyms "aria-labelledby" @tier "presentation"
-    ariaLive       : string @label "Aria-live" @description "Announce changes to this region: polite waits for a pause, assertive interrupts." @synonyms "aria-live" @tier "presentation" @values (off polite assertive)
-    ariaPressed    : string @label "Aria-pressed" @description "Toggle-button state." @synonyms "aria-pressed" @tier "presentation" @values (true false mixed)
-    ariaSelected   : boolean @label "Aria-selected" @description "Whether this item is selected (tabs, options, grid cells)." @synonyms "aria-selected" @tier "presentation"
-    children       : node @label "Children" @description "children prop" @tier "presentation"
-    className      : string @label "Class Name" @description "Additional CSS classes" @tier "presentation"
-    completedField : string @label "Completed Field" @description "Row field that marks an item completed (`true` strikes its title through)" @tier "presentation"
-    dir            : string @label "Dir" @description "Text direction of this element's content." @tier "presentation" @values (ltr rtl auto)
-    disabledField  : string @label "Disabled Field" @description "Row field that marks an item disabled (`true` dims the row and disables its click)" @tier "presentation"
-    emptyMessage   : string @label "Empty Message" @description "emptyMessage prop" @tier "presentation"
-    enter          : string @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" @values (none fade rise scale slide)
-    enterDelay     : number @label "Enter Delay" @description "Stagger step for the entry: waits this many `--motion-enter-stagger` steps before animating." @tier "presentation"
-    entityType     : string @label "Entity Type" @description "Entity type name for display" @tier "presentation"
-    error          : EntityListError @label "Error" @description "Error state (UiError)" @tier "presentation"
-    fieldNames     : [string] = [] @label "Field Names" @description "Alias for fields - backwards compatibility" @tier "presentation"
-    fields         : [EntityListFieldsItem] = [{"format":"date","icon":"circle","label":"Label","name":"Name","variant":"h3"},{"format":"datetime","icon":"circle","label":"Label 2","name":"Name 2","variant":"h4"}] @label "Fields" @description "Fields to display: field names, or declared fields ({ name, label, variant, format, colorMap, labels })" @tier "presentation"
-    isLoading      : boolean = false @label "Is Loading" @description "Loading state indicator" @tier "presentation"
-    itemActions    : [EntityListItemActionsItem] = [{"event":"VIEW","label":"View","variant":"ghost"}] @label "Item Actions" @description "Item actions - schema-driven or function-based" @tier "presentation"
-    itemClickEvent : event = "ITEM_CLICK" @label "Item Click Event" @description "When set, clicking a row emits UI:{itemClickEvent} with { id, row }. Omit = rows are not clickable." @tier "presentation"
-    lang           : string @label "Lang" @description "Language of this element's content (BCP 47, e.g. ar, sl, en)." @tier "presentation"
-    pageProp       : number @label "Page" @description "Current page number" @synonyms "page" @tier "presentation"
-    pageSize       : number @label "Page Size" @description "Number of items per page" @tier "presentation"
-    role           : string @label "Role" @description "WAI-ARIA role when the element's native semantics don't describe it." @tier "presentation" @values (alert alertdialog application article banner blockquote button caption cell checkbox code columnheader combobox complementary contentinfo definition deletion dialog document emphasis feed figure form generic grid gridcell group heading img insertion link list listbox listitem log main marquee math menu menubar menuitem menuitemcheckbox menuitemradio meter navigation none note option paragraph presentation progressbar radio radiogroup region row rowgroup rowheader scrollbar search searchbox separator slider spinbutton status strong subscript superscript switch tab table tablist tabpanel term textbox time timer toolbar tooltip tree treegrid treeitem)
-    searchValue    : string @label "Search Value" @description "Current search query value" @tier "presentation"
-    selectable     : boolean = false @label "Selectable" @description "selectable prop" @tier "presentation"
-    selectedIds    : [string] = [] @label "Selected Ids" @description "Currently selected item IDs" @tier "presentation"
-    selfFetch      : boolean = true @label "Fetch its own rows on mount?" @description "true (default) = standalone mount self-populates on INIT. false = a composing atom owns the fetch and routes its loaded event here — suppresses the wrapper's own un-hydrated fetch so it cannot race the composer's." @tier "internal"
-    showDividers   : boolean @label "Show Dividers" @description "showDividers prop" @tier "presentation"
-    skeleton       : string = "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" @values (header table list grid detail stats form card text none)
-    sortBy         : string @label "Sort By" @description "Current sort field" @tier "presentation"
-    sortDirection  : string @label "Sort Direction" @description "Current sort direction" @tier "presentation" @values (asc desc)
-    tabIndex       : number @label "Tab Index" @description "0 puts the element in the Tab order; -1 makes it focusable only programmatically." @tier "presentation"
-    totalCount     : number @label "Total Count" @description "Total number of items" @tier "presentation"
-    variant        : string @label "Variant" @description "variant prop" @tier "presentation" @values (default card)
-    viewerRole     : string = "" @label "Viewer's role" @description "The viewer's role that each action's `roles` is checked against; bind it at the call site (e.g. `viewerRole: @user.role`). Empty = only actions with no `roles` show." @tier "policy"
-  }
-  override-surface : (linkedEntity name events effects listens emitsScope config)
-  source         : "@almadar/std (behaviors/registry/ui/core/organisms/ui-entity-list.orb orbitals[0].traits[0])"
-}
-
-;; From @almadar/std (behaviors/registry/ui/core/organisms/ui-entity-table.orb orbitals[0].traits[0])
-trait ui-entity-table.traits.EntityTableRender {
-  alias          : UiEntityTable
-  linkedEntity   : EntityTableItem
-  category       : interaction
-  states         : (idle*)
-  events         : (INIT EntityTableLoaded @config.itemClickEvent VIEW)
-  transitions    : ((idle -> idle on INIT) (idle -> idle on INIT) (idle -> idle on EntityTableLoaded))
-  emits          : (@config.itemClickEvent VIEW EntityTableLoaded)
-  config {
-    activeFilters  : Map<string,string> = {} @label "Active Filters" @description "Active filters" @tier "presentation"
-    ariaBusy       : boolean @label "Aria-busy" @description "This region is updating; assistive technology waits before announcing it." @synonyms "aria-busy" @tier "presentation"
-    ariaCurrent    : string @label "Aria-current" @description "Marks the current item in a set: the current page, step, location, date or time." @synonyms "aria-current" @tier "presentation" @values (page step location date time true false)
-    ariaDescribedby : string @label "Aria-describedby" @description "Id of the element whose text describes this one (help text, error)." @synonyms "aria-describedby" @tier "presentation"
-    ariaExpanded   : boolean @label "Aria-expanded" @description "Whether the element it controls is expanded." @synonyms "aria-expanded" @tier "presentation"
-    ariaHidden     : boolean @label "Aria-hidden" @description "Hide from assistive technology (decorative content only)." @synonyms "aria-hidden" @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)." @synonyms "aria-label" @tier "presentation"
-    ariaLabelledby : string @label "Aria-labelledby" @description "Id of the element whose text names this one." @synonyms "aria-labelledby" @tier "presentation"
-    ariaLive       : string @label "Aria-live" @description "Announce changes to this region: polite waits for a pause, assertive interrupts." @synonyms "aria-live" @tier "presentation" @values (off polite assertive)
-    ariaPressed    : string @label "Aria-pressed" @description "Toggle-button state." @synonyms "aria-pressed" @tier "presentation" @values (true false mixed)
-    ariaSelected   : boolean @label "Aria-selected" @description "Whether this item is selected (tabs, options, grid cells)." @synonyms "aria-selected" @tier "presentation"
-    bulkActions    : [EntityTableBulkActionsItem] = [] @label "Bulk Actions" @description "Bulk actions" @tier "presentation"
-    className      : string @label "Class Name" @description "Additional CSS classes" @tier "presentation"
-    columns        : [EntityTableColumnsItem] = [] @label "Columns" @description "Columns can be Column objects or simple string field names" @tier "presentation"
-    dir            : string @label "Dir" @description "Text direction of this element's content." @tier "presentation" @values (ltr rtl auto)
-    emptyAction    : EntityTableEmptyAction @label "Empty Action" @description "emptyAction prop" @tier "presentation"
-    emptyDescription : string @label "Empty Description" @description "emptyDescription prop" @tier "presentation"
-    emptyIcon      : icon @label "Empty Icon" @description "emptyIcon prop" @tier "presentation"
-    emptyTitle     : string @label "Empty Title" @description "emptyTitle prop" @tier "presentation"
-    enter          : string @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" @values (none fade rise scale slide)
-    enterDelay     : number @label "Enter Delay" @description "Stagger step for the entry: waits this many `--motion-enter-stagger` steps before animating." @tier "presentation"
-    error          : EntityTableError @label "Error" @description "Error state (UiError)" @tier "presentation"
-    fields         : [EntityTableFieldsItem] = [{"align":"left","format":"date","header":"Header","key":"Key","label":"Label","name":"Name","sortable":false,"width":"Width"},{"align":"center","format":"datetime","header":"Header 2","key":"Key 2","label":"Label 2","name":"Name 2","sortable":true,"width":"Width 2"}] @label "Fields" @description "Fields to display - accepts string[] or Column[] for unified interface. Alias for columns" @tier "presentation"
-    headerActions  : node @label "Header Actions" @description "Header actions" @tier "presentation"
-    isLoading      : boolean = false @label "Is Loading" @description "Loading state indicator" @tier "presentation"
-    itemActions    : [EntityTableItemActionsItem] = [{"event":"VIEW","label":"View","variant":"ghost"}] @label "Item Actions" @description "Item actions from generated code - maps to rowActions" @tier "presentation"
-    itemClickEvent : event = "ITEM_CLICK" @label "Item Click Event" @description "When set, rows are activatable and emit UI:{itemClickEvent} with { id, row }" @tier "presentation"
-    lang           : string @label "Lang" @description "Language of this element's content (BCP 47, e.g. ar, sl, en)." @tier "presentation"
-    look           : string = "dense" @label "Look" @description "Layer 2 visual treatment — orthogonal to the semantic variant." @tier "presentation" @values (dense spacious striped borderless card-rows)
-    pageProp       : number @label "Page" @description "Current page number" @synonyms "page" @tier "presentation"
-    pageSize       : number @label "Page Size" @description "Number of items per page" @tier "presentation"
-    relationsData  : Map<string,[EntityTableRelationsDataValueItem]> = {} @label "Relations Data" @description "Relation display data: { fieldName: [{value, label}] } — injected server-side by the runtime (relation-option injection) or bound by compiled codegen; resolves stored foreign ids to display names for a column whose field is relation-typed. Same contract DetailPanel takes." @tier "presentation"
-    role           : string @label "Role" @description "WAI-ARIA role when the element's native semantics don't describe it." @tier "presentation" @values (alert alertdialog application article banner blockquote button caption cell checkbox code columnheader combobox complementary contentinfo definition deletion dialog document emphasis feed figure form generic grid gridcell group heading img insertion link list listbox listitem log main marquee math menu menubar menuitem menuitemcheckbox menuitemradio meter navigation none note option paragraph presentation progressbar radio radiogroup region row rowgroup rowheader scrollbar search searchbox separator slider spinbutton status strong subscript superscript switch tab table tablist tabpanel term textbox time timer toolbar tooltip tree treegrid treeitem)
-    rowActions     : [EntityTableRowActionsItem] = [] @label "Row Actions" @description "Row actions" @tier "presentation"
-    searchable     : boolean = false @label "Searchable" @description "Search" @tier "presentation"
-    searchPlaceholder : string @label "Search Placeholder" @description "searchPlaceholder prop" @tier "presentation"
-    searchValue    : string @label "Search Value" @description "Current search query value" @tier "presentation"
-    selectable     : boolean = false @label "Selectable" @description "Selection" @tier "presentation"
-    selectedIds    : [string] = [] @label "Selected Ids" @description "Currently selected item IDs" @tier "presentation"
-    selfFetch      : boolean = true @label "Fetch its own rows on mount?" @description "true (default) = standalone mount self-populates on INIT. false = a composing atom owns the fetch and routes its loaded event here — suppresses the wrapper's own un-hydrated fetch so it cannot race the composer's." @tier "internal"
-    showTotal      : boolean = true @label "Show Total" @description "Show total count in pagination" @tier "presentation"
-    skeleton       : string = "table" @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" @values (header table list grid detail stats form card text none)
-    sortBy         : string @label "Sort By" @description "Current sort field" @tier "presentation"
-    sortDirection  : string = "asc" @label "Sort Direction" @description "Current sort direction" @tier "presentation" @values (asc desc)
-    tabIndex       : number @label "Tab Index" @description "0 puts the element in the Tab order; -1 makes it focusable only programmatically." @tier "presentation"
-    totalCount     : number @label "Total Count" @description "Total number of items" @tier "presentation"
-    viewerRole     : string = "" @label "Viewer's role" @description "The viewer's role that each action's `roles` is checked against; bind it at the call site (e.g. `viewerRole: @user.role`). Empty = only actions with no `roles` show." @tier "policy"
-  }
-  override-surface : (linkedEntity name events effects listens emitsScope config)
-  source         : "@almadar/std (behaviors/registry/ui/core/organisms/ui-entity-table.orb orbitals[0].traits[0])"
-}
-
 ;; From @almadar/std (behaviors/registry/ui/core/organisms/ui-form.orb orbitals[0].traits[0])
 trait ui-form.traits.FormRender {
   alias          : UiForm
@@ -42568,9 +42324,10 @@ trait ui-form.traits.FormRender {
     selfFetch      : boolean = true @label "Fetch its own row on mount?" @description "true (default) = a mount that carries an id loads that one row (never the collection); a create-mode mount skips the load. false = a composing atom owns the load." @tier "internal"
     showCancel     : boolean @label "Show Cancel" @description "Show cancel button (defaults to true for schema forms)" @tier "presentation"
     showSubmit     : boolean = true @label "Show Submit" @description "Show submit button (defaults to true for schema forms). Set false when a parent atom owns the submit action externally (e.g. wizard footers)." @tier "presentation"
-    skeleton       : string @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" @values (header table list grid detail stats form card text none)
+    skeleton       : string = "form" @label "Skeleton" @description "The shape an empty slot shows while this form's server render is in flight (`none` opts out). @default 'form'" @tier "presentation" @values (header table list grid detail stats form card text none)
     submitEvent    : event = "SUBMIT" @label "Submit Event" @description "Event dispatch props (for trait state machine integration)" @tier "presentation"
     submitLabel    : string @label "Submit Label" @description "Submit button label" @tier "presentation"
+    surface        : string = "auto" @label "Surface" @description "Content surface: `auto` paints the theme's surface (with card padding) behind this block unless it already sits on one (a card, dialog or another block); `none` opts out." @tier "presentation" @values (auto none)
     tabIndex       : number @label "Tab Index" @description "0 puts the element in the Tab order; -1 makes it focusable only programmatically." @tier "presentation"
     title          : string @label "Title" @description "Form title (used by ModalSlot to extract title)" @tier "presentation"
     violationTriggers : [FormViolationTriggersItem] = [] @label "Violation Triggers" @description "Violation conditions that emit VIOLATION_DETECTED when met (boolean true means enabled but config loaded separately)" @tier "presentation"
@@ -42629,9 +42386,10 @@ trait ui-form-section.traits.FormSectionRender {
     selfFetch      : boolean = true @label "Fetch its own row on mount?" @description "true (default) = a mount that carries an id loads that one row (never the collection); a create-mode mount skips the load. false = a composing atom owns the load." @tier "internal"
     showCancel     : boolean @label "Show Cancel" @description "Show cancel button (defaults to true for schema forms)" @tier "presentation"
     showSubmit     : boolean = true @label "Show Submit" @description "Show submit button (defaults to true for schema forms). Set false when a parent atom owns the submit action externally (e.g. wizard footers)." @tier "presentation"
-    skeleton       : string @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" @values (header table list grid detail stats form card text none)
+    skeleton       : string = "form" @label "Skeleton" @description "The shape an empty slot shows while this form's server render is in flight (`none` opts out). @default 'form'" @tier "presentation" @values (header table list grid detail stats form card text none)
     submitEvent    : event = "SUBMIT" @label "Submit Event" @description "Event dispatch props (for trait state machine integration)" @tier "presentation"
     submitLabel    : string @label "Submit Label" @description "Submit button label" @tier "presentation"
+    surface        : string = "auto" @label "Surface" @description "Content surface: `auto` paints the theme's surface (with card padding) behind this block unless it already sits on one (a card, dialog or another block); `none` opts out." @tier "presentation" @values (auto none)
     tabIndex       : number @label "Tab Index" @description "0 puts the element in the Tab order; -1 makes it focusable only programmatically." @tier "presentation"
     title          : string @label "Title" @description "Form title (used by ModalSlot to extract title)" @tier "presentation"
     violationTriggers : [FormSectionViolationTriggersItem] = [] @label "Violation Triggers" @description "Violation conditions that emit VIOLATION_DETECTED when met (boolean true means enabled but config loaded separately)" @tier "presentation"
@@ -42640,53 +42398,6 @@ trait ui-form-section.traits.FormSectionRender {
   source         : "@almadar/std (behaviors/registry/ui/core/organisms/ui-form-section.orb orbitals[0].traits[0])"
 }
 
-;; From @almadar/std (behaviors/registry/ui/core/organisms/ui-master-detail.orb orbitals[0].traits[0])
-trait ui-master-detail.traits.MasterDetailRender {
-  alias          : UiMasterDetail
-  linkedEntity   : MasterDetailItem
-  category       : interaction
-  states         : (idle*)
-  events         : (INIT MasterDetailLoaded)
-  transitions    : ((idle -> idle on INIT) (idle -> idle on INIT) (idle -> idle on MasterDetailLoaded))
-  emits          : (MasterDetailLoaded)
-  config {
-    activeFilters  : Map<string,string> = {} @label "Active Filters" @description "Active filters" @tier "presentation"
-    ariaBusy       : boolean @label "Aria-busy" @description "This region is updating; assistive technology waits before announcing it." @synonyms "aria-busy" @tier "presentation"
-    ariaCurrent    : string @label "Aria-current" @description "Marks the current item in a set: the current page, step, location, date or time." @synonyms "aria-current" @tier "presentation" @values (page step location date time true false)
-    ariaDescribedby : string @label "Aria-describedby" @description "Id of the element whose text describes this one (help text, error)." @synonyms "aria-describedby" @tier "presentation"
-    ariaExpanded   : boolean @label "Aria-expanded" @description "Whether the element it controls is expanded." @synonyms "aria-expanded" @tier "presentation"
-    ariaHidden     : boolean @label "Aria-hidden" @description "Hide from assistive technology (decorative content only)." @synonyms "aria-hidden" @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)." @synonyms "aria-label" @tier "presentation"
-    ariaLabelledby : string @label "Aria-labelledby" @description "Id of the element whose text names this one." @synonyms "aria-labelledby" @tier "presentation"
-    ariaLive       : string @label "Aria-live" @description "Announce changes to this region: polite waits for a pause, assertive interrupts." @synonyms "aria-live" @tier "presentation" @values (off polite assertive)
-    ariaPressed    : string @label "Aria-pressed" @description "Toggle-button state." @synonyms "aria-pressed" @tier "presentation" @values (true false mixed)
-    ariaSelected   : boolean @label "Aria-selected" @description "Whether this item is selected (tabs, options, grid cells)." @synonyms "aria-selected" @tier "presentation"
-    className      : string @label "Class Name" @description "Additional CSS classes" @tier "presentation"
-    detailFields   : [string] = [] @label "Detail Fields" @description "Fields for detail view (passed through but typically handled by separate render_ui)" @tier "presentation"
-    dir            : string @label "Dir" @description "Text direction of this element's content." @tier "presentation" @values (ltr rtl auto)
-    enter          : string @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" @values (none fade rise scale slide)
-    enterDelay     : number @label "Enter Delay" @description "Stagger step for the entry: waits this many `--motion-enter-stagger` steps before animating." @tier "presentation"
-    error          : MasterDetailError @label "Error" @description "Error state (UiError)" @tier "presentation"
-    isLoading      : boolean @label "Is Loading" @description "Loading state indicator" @tier "presentation"
-    lang           : string @label "Lang" @description "Language of this element's content (BCP 47, e.g. ar, sl, en)." @tier "presentation"
-    loading        : boolean @label "Loading" @description "Loading state (alias for isLoading)" @tier "presentation"
-    masterFields   : [string] = ["Item","Item 2"] @label "Master Fields" @description "Fields to show in the master list (maps to DataTable columns)" @tier "presentation"
-    pageProp       : number @label "Page" @description "Current page number" @synonyms "page" @tier "presentation"
-    pageSize       : number @label "Page Size" @description "Number of items per page" @tier "presentation"
-    role           : string @label "Role" @description "WAI-ARIA role when the element's native semantics don't describe it." @tier "presentation" @values (alert alertdialog application article banner blockquote button caption cell checkbox code columnheader combobox complementary contentinfo definition deletion dialog document emphasis feed figure form generic grid gridcell group heading img insertion link list listbox listitem log main marquee math menu menubar menuitem menuitemcheckbox menuitemradio meter navigation none note option paragraph presentation progressbar radio radiogroup region row rowgroup rowheader scrollbar search searchbox separator slider spinbutton status strong subscript superscript switch tab table tablist tabpanel term textbox time timer toolbar tooltip tree treegrid treeitem)
-    searchValue    : string @label "Search Value" @description "Current search query value" @tier "presentation"
-    selectedIds    : [string] = [] @label "Selected Ids" @description "Currently selected item IDs" @tier "presentation"
-    selfFetch      : boolean = true @label "Fetch its own rows on mount?" @description "true (default) = standalone mount self-populates on INIT. false = a composing atom owns the fetch and routes its loaded event here — suppresses the wrapper's own un-hydrated fetch so it cannot race the composer's." @tier "internal"
-    skeleton       : string @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" @values (header table list grid detail stats form card text none)
-    sortBy         : string @label "Sort By" @description "Current sort field" @tier "presentation"
-    sortDirection  : string @label "Sort Direction" @description "Current sort direction" @tier "presentation" @values (asc desc)
-    tabIndex       : number @label "Tab Index" @description "0 puts the element in the Tab order; -1 makes it focusable only programmatically." @tier "presentation"
-    totalCount     : number @label "Total Count" @description "Total number of items" @tier "presentation"
-  }
-  override-surface : (linkedEntity name events effects listens emitsScope config)
-  source         : "@almadar/std (behaviors/registry/ui/core/organisms/ui-master-detail.orb orbitals[0].traits[0])"
-}
-
 ;; From @almadar/std (behaviors/registry/ui/core/organisms/ui-master-detail-layout.orb orbitals[0].traits[0])
 trait ui-master-detail-layout.traits.MasterDetailLayoutRender {
   alias          : UiMasterDetailLayout
@@ -42773,6 +42484,7 @@ trait ui-media-gallery.traits.MediaGalleryRender {
     sortBy         : string @label "Sort By" @description "Current sort field" @tier "presentation"
     sortDirection  : string @label "Sort Direction" @description "Current sort direction" @tier "presentation" @values (asc desc)
     srcField       : string = "src" @label "Src Field" @description "Record field holding each image's URL (entity mode). Default `src`." @tier "presentation"
+    surface        : string = "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" @values (auto none)
     tabIndex       : number @label "Tab Index" @description "0 puts the element in the Tab order; -1 makes it focusable only programmatically." @tier "presentation"
     title          : string @label "Title" @description "Gallery title" @tier "presentation"
     totalCount     : number @label "Total Count" @description "Total number of items" @tier "presentation"
@@ -42868,7 +42580,7 @@ trait ui-segment-renderer.traits.SegmentRendererRender {
     enterDelay     : number @label "Enter Delay" @description "Stagger step for the entry: waits this many `--motion-enter-stagger` steps before animating." @tier "presentation"
     lang           : string @label "Lang" @description "Language of this element's content (BCP 47, e.g. ar, sl, en)." @tier "presentation"
     role           : string @label "Role" @description "WAI-ARIA role when the element's native semantics don't describe it." @tier "presentation" @values (alert alertdialog application article banner blockquote button caption cell checkbox code columnheader combobox complementary contentinfo definition deletion dialog document emphasis feed figure form generic grid gridcell group heading img insertion link list listbox listitem log main marquee math menu menubar menuitem menuitemcheckbox menuitemradio meter navigation none note option paragraph presentation progressbar radio radiogroup region row rowgroup rowheader scrollbar search searchbox separator slider spinbutton status strong subscript superscript switch tab table tablist tabpanel term textbox time timer toolbar tooltip tree treegrid treeitem)
-    segments       : [SegmentRendererSegmentsItem] = [{"content":"Content","type":"markdown"},{"content":"Content 2","type":"markdown"}] @label "Segments" @description "Parsed lesson segments (see `parseLessonSegments`)" @tier "presentation"
+    segments       : [SegmentRendererSegmentsItem] = [{"answer":"Answer","question":"Question","type":"quiz"},{"answer":"Answer 2","question":"Question 2","type":"quiz"}] @label "Segments" @description "Parsed lesson segments (see `parseLessonSegments`)" @tier "presentation"
     skeleton       : string @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" @values (header table list grid detail stats form card text none)
     tabIndex       : number @label "Tab Index" @description "0 puts the element in the Tab order; -1 makes it focusable only programmatically." @tier "presentation"
     userProgress   : SegmentRendererUserProgress @label "User Progress" @description "User progress for restoring activation/reflection state" @tier "presentation"
@@ -42968,6 +42680,7 @@ trait ui-stat-card.traits.StatCardRender {
     sortDirection  : string @label "Sort Direction" @description "Current sort direction" @tier "presentation" @values (asc desc)
     sparklineData  : [number] = [] @label "Sparkline Data" @description "Sparkline data points for an inline trend chart" @tier "presentation"
     subtitle       : string @label "Subtitle" @description "Subtitle or description" @tier "presentation"
+    surface        : string = "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" @values (auto none)
     tabIndex       : number @label "Tab Index" @description "0 puts the element in the Tab order; -1 makes it focusable only programmatically." @tier "presentation"
     title          : string @label "Title" @description "Title (alias for label)" @tier "presentation"
     totalCount     : number @label "Total Count" @description "Total number of items" @tier "presentation"
@@ -43003,19 +42716,19 @@ trait ui-state-machine-view.traits.StateMachineViewRender {
     ariaSelected   : boolean @label "Aria-selected" @description "Whether this item is selected (tabs, options, grid cells)." @synonyms "aria-selected" @tier "presentation"
     className      : string @label "Class Name" @description "className prop" @tier "presentation"
     dir            : string @label "Dir" @description "Text direction of this element's content." @tier "presentation" @values (ltr rtl auto)
-    direction      : string @label "Direction" @description "Flow direction. @default 'ltr'" @tier "presentation" @values (ltr rtl)
+    direction      : string = "ltr" @label "Direction" @description "Flow direction. @default 'ltr'" @tier "presentation" @values (ltr rtl)
     enter          : string @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" @values (none fade rise scale slide)
     enterDelay     : number @label "Enter Delay" @description "Stagger step for the entry: waits this many `--motion-enter-stagger` steps before animating." @tier "presentation"
     entityFields   : [string] = [] @label "Entity Fields" @description "Entity field names listed in the header." @tier "presentation"
     error          : StateMachineViewError @label "Error" @description "Error state" @tier "presentation"
     isLoading      : boolean = false @label "Is Loading" @description "Loading state indicator" @tier "presentation"
     lang           : string @label "Lang" @description "Language of this element's content (BCP 47, e.g. ar, sl, en)." @tier "presentation"
-    nodeShape      : string @label "Node Shape" @description "Node silhouette. @default 'pill'" @tier "presentation" @values (pill gear)
+    nodeShape      : string = "pill" @label "Node Shape" @description "Node silhouette. @default 'pill'" @tier "presentation" @values (pill gear)
     onTransitionClick : event = "TRANSITION_CLICK" @label "On Transition Click" @description "Direct transition-click callback, for React hosts (e.g. a canvas node)." @tier "presentation"
     pendingSourceState : string @label "Pending Source State" @description "Source of a transition being drawn — the next state click picks its target." @tier "presentation"
     role           : string @label "Role" @description "WAI-ARIA role when the element's native semantics don't describe it." @tier "presentation" @values (alert alertdialog application article banner blockquote button caption cell checkbox code columnheader combobox complementary contentinfo definition deletion dialog document emphasis feed figure form generic grid gridcell group heading img insertion link list listbox listitem log main marquee math menu menubar menuitem menuitemcheckbox menuitemradio meter navigation none note option paragraph presentation progressbar radio radiogroup region row rowgroup rowheader scrollbar search searchbox separator slider spinbutton status strong subscript superscript switch tab table tablist tabpanel term textbox time timer toolbar tooltip tree treegrid treeitem)
     selectedState  : string @label "Selected State" @description "State picked in an editor (first click)." @tier "presentation"
-    showHeader     : boolean @label "Show Header" @description "Show the trait header (name, entity, listens/emits). @default true" @tier "presentation"
+    showHeader     : boolean = true @label "Show Header" @description "Show the trait header (name, entity, listens/emits). @default true" @tier "presentation"
     skeleton       : string @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" @values (header table list grid detail stats form card text none)
     stateClickEvent : event = "STATE_CLICK" @label "State Click Event" @description "Emits UI:{stateClickEvent} with { stateId } when a state is clicked." @tier "presentation"
     tabIndex       : number @label "Tab Index" @description "0 puts the element in the Tab order; -1 makes it focusable only programmatically." @tier "presentation"
@@ -43049,6 +42762,7 @@ trait ui-subagent-trace-panel.traits.SubagentTracePanelRender {
     ariaPressed    : string @label "Aria-pressed" @description "Toggle-button state." @synonyms "aria-pressed" @tier "presentation" @values (true false mixed)
     ariaSelected   : boolean @label "Aria-selected" @description "Whether this item is selected (tabs, options, grid cells)." @synonyms "aria-selected" @tier "presentation"
     className      : string @label "Class Name" @description "Additional CSS classes" @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." @tier "presentation"
     dir            : string @label "Dir" @description "Text direction of this element's content." @tier "presentation" @values (ltr rtl auto)
     disclosureLevel : number = 1 @label "Disclosure Level" @description "Drives density: 1-2 → compact, 3-4 → full activity embed (when mode='overlay')." @tier "presentation"
@@ -43152,6 +42866,7 @@ trait ui-timeline.traits.TimelineRender {
     selfFetch      : boolean = true @label "Fetch its own rows on mount?" @description "true (default) = standalone mount self-populates on INIT. false = a composing atom owns the fetch and routes its loaded event here — suppresses the wrapper's own un-hydrated fetch so it cannot race the composer's." @tier "internal"
     skeleton       : string = "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" @values (header table list grid detail stats form card text none)
     statusField    : string @label "Status Field" @description "Entity field holding each item's status (complete | active | pending | error)." @tier "presentation"
+    surface        : string = "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" @values (auto none)
     tabIndex       : number @label "Tab Index" @description "0 puts the element in the Tab order; -1 makes it focusable only programmatically." @tier "presentation"
     title          : string @label "Title" @description "Timeline title" @tier "presentation"
     titleField     : string @label "Title Field" @description "Entity field holding each item's title." @tier "presentation"
@@ -43200,20 +42915,11 @@ trait ui-toast-slot.traits.ToastSlotRender {
   source         : "@almadar/std (behaviors/registry/ui/core/organisms/ui-toast-slot.orb orbitals[0].traits[0])"
 }
 
-;; From @almadar/std (behaviors/registry/agent/organisms/std-agent-assistant.orb orbitals[1].pages[1])
-page std-agent-assistant.pages.AssistantMemoryPage {
-  alias          : AgentAssistant
-  defaultPath    : /assistant/memory
-  traits         : (AgentMemoryList)
-  override-surface : (path linkedEntity traits)
-  source         : "@almadar/std (behaviors/registry/agent/organisms/std-agent-assistant.orb orbitals[1].pages[1])"
-}
-
 ;; From @almadar/std (behaviors/registry/agent/organisms/std-agent-assistant.orb orbitals[0].pages[0])
 page std-agent-assistant.pages.AssistantPage {
   alias          : AgentAssistant
   defaultPath    : /assistant
-  traits         : (AssistantThread AssistantContext AssistantMemory AssistantLoop AssistantTrace)
+  traits         : (AssistantLayout AssistantThread AssistantChatKeeper AssistantContext AssistantMemory AssistantLoop AssistantTrace)
   override-surface : (path linkedEntity traits)
   source         : "@almadar/std (behaviors/registry/agent/organisms/std-agent-assistant.orb orbitals[0].pages[0])"
 }
@@ -43416,33 +43122,6 @@ page ui-drawer-slot.pages.DrawerSlotPage {
   source         : "@almadar/std (behaviors/registry/ui/core/organisms/ui-drawer-slot.orb orbitals[0].pages[0])"
 }
 
-;; From @almadar/std (behaviors/registry/ui/core/organisms/ui-entity-cards.orb orbitals[0].pages[0])
-page ui-entity-cards.pages.EntityCardsPage {
-  alias          : UiEntityCards
-  defaultPath    : /entity-cards
-  traits         : (EntityCardsRender)
-  override-surface : (path linkedEntity traits)
-  source         : "@almadar/std (behaviors/registry/ui/core/organisms/ui-entity-cards.orb orbitals[0].pages[0])"
-}
-
-;; From @almadar/std (behaviors/registry/ui/core/organisms/ui-entity-list.orb orbitals[0].pages[0])
-page ui-entity-list.pages.EntityListPage {
-  alias          : UiEntityList
-  defaultPath    : /entity-list
-  traits         : (EntityListRender)
-  override-surface : (path linkedEntity traits)
-  source         : "@almadar/std (behaviors/registry/ui/core/organisms/ui-entity-list.orb orbitals[0].pages[0])"
-}
-
-;; From @almadar/std (behaviors/registry/ui/core/organisms/ui-entity-table.orb orbitals[0].pages[0])
-page ui-entity-table.pages.EntityTablePage {
-  alias          : UiEntityTable
-  defaultPath    : /entity-table
-  traits         : (EntityTableRender)
-  override-surface : (path linkedEntity traits)
-  source         : "@almadar/std (behaviors/registry/ui/core/organisms/ui-entity-table.orb orbitals[0].pages[0])"
-}
-
 ;; From @almadar/std (behaviors/registry/ui/core/organisms/ui-form.orb orbitals[0].pages[0])
 page ui-form.pages.FormPage {
   alias          : UiForm
@@ -43461,15 +43140,6 @@ page ui-form-section.pages.FormSectionPage {
   source         : "@almadar/std (behaviors/registry/ui/core/organisms/ui-form-section.orb orbitals[0].pages[0])"
 }
 
-;; From @almadar/std (behaviors/registry/ui/core/organisms/ui-master-detail.orb orbitals[0].pages[0])
-page ui-master-detail.pages.MasterDetailPage {
-  alias          : UiMasterDetail
-  defaultPath    : /master-detail
-  traits         : (MasterDetailRender)
-  override-surface : (path linkedEntity traits)
-  source         : "@almadar/std (behaviors/registry/ui/core/organisms/ui-master-detail.orb orbitals[0].pages[0])"
-}
-
 ;; From @almadar/std (behaviors/registry/ui/core/organisms/ui-master-detail-layout.orb orbitals[0].pages[0])
 page ui-master-detail-layout.pages.MasterDetailLayoutPage {
   alias          : UiMasterDetailLayout