@almadar/std 16.193.0 → 16.194.0

package/behaviors/lolo/infra/atoms/std-approval-gate.lolo

@@ -1,5 +1,5 @@
 app std-approval-gate "1.1.0"
-"std-approval-gate — generic approval gate / approver workflow. Use when a user voices that an action must be reviewed, approved, signed off, or authorized by a privileged role before it proceeds (admin approval, supervisor sign-off, manager approval, gatekeeper review, editor approval, senior editor approval, reviewer approval, publishing approval, draft approval, content review, submit drafts then editors review and approve or reject, needs approval before going live, requires sign-off before publish). Persists ApprovalRequest rows + surfaces the PENDING ones in a review queue showing what is being approved and who asked, with Approve / Deny actions — Deny captures a written reason. approverRoles is ENFORCED by the review transitions themselves: an APPROVE/DENY from a viewer whose role is not listed does not fire. On approval emits ApprovalGranted; on denial emits ApprovalDenied (with the reason). Hosts that replay the gated action MUST route a failed replay back via APPROVAL_REPLAY_FAILED so the request reopens instead of being silently consumed. Compose onto any orbital whose action you want to gate: the target orbital emits an external event, an ApprovalRequest row is created (stamp subjectLabel/subjectId/requestedBy so reviewers see what they are judging), and downstream effects wait on ApprovalGranted. Differs from std-mod-queue, which is content-moderation-specific."
+"std-approval-gate — generic approval gate / approver workflow. Use when a user voices that an action must be reviewed, approved, signed off, or authorized by a privileged role before it proceeds (admin approval, supervisor sign-off, manager approval, gatekeeper review, editor approval, senior editor approval, reviewer approval, publishing approval, draft approval, content review, submit drafts then editors review and approve or reject, needs approval before going live, requires sign-off before publish). Persists ApprovalRequest rows + surfaces the PENDING ones in a review queue showing what is being approved and who asked, with Approve / Deny actions — Deny captures a written reason. approverRoles is ENFORCED by the review transitions themselves: an APPROVE/DENY from a viewer whose role is not listed does not fire. blockSelfApproval additionally stops a reviewer approving their own request (four-eyes) — DENY stays allowed as self-withdrawal. On approval emits ApprovalGranted; on denial emits ApprovalDenied (with the reason). Hosts that replay the gated action MUST route a failed replay back via APPROVAL_REPLAY_FAILED so the request reopens instead of being silently consumed. Compose onto any orbital whose action you want to gate: the target orbital emits an external event, an ApprovalRequest row is created (stamp subjectLabel/subjectId/requestedBy so reviewers see what they are judging), and downstream effects wait on ApprovalGranted. Differs from std-mod-queue, which is content-moderation-specific."
 orbital ApprovalGateOrbital {
     uses Spinner from "std/behaviors/ui-spinner"
     uses Typography from "std/behaviors/ui-typography"
@@ -227,8 +227,9 @@ orbital ApprovalGateOrbital {
       ;; The role guard IS the enforcement (both execution paths honor
       ;; transition guards, for the button and for a bus-delivered event
       ;; alike): empty approverRoles = ungated, otherwise the viewer's role
-      ;; must be listed or the decision does not fire.
-      APPROVE -> reviewing when (or ["=", (array/len @config.approverRoles), 0] (array/includes @config.approverRoles @user.role))
+      ;; must be listed or the decision does not fire. blockSelfApproval
+      ;; additionally blocks APPROVE when ?row.requestedBy is the viewer.
+      APPROVE -> reviewing when (and (or ["=", (array/len @config.approverRoles), 0] (array/includes @config.approverRoles @user.role)) (or ["=", @config.blockSelfApproval, false] ["!=", (object/get ?row requestedBy), @user.id]))
         (set @entity.id ?id)
         (set @entity.status approved)
         (set @entity.reviewer @user.id)
@@ -499,6 +500,11 @@ orbital ApprovalGateOrbital {
         @description "Roles eligible to decide. ENFORCED by the APPROVE/DENY transition guards: a viewer whose @user.role is not listed cannot fire a decision, from the button or from the bus. Empty = every signed-in viewer may decide (ungated)."
         @synonyms "approver, reviewer, authorized roles, sign-off roles, who approves"
         @tier "policy"
+      blockSelfApproval : boolean = false
+        @label "Block approving your own requests?"
+        @description "When on, a reviewer cannot APPROVE a request they submitted themselves (requestedBy = the viewer's id) — enforced by the APPROVE transition guard, from the button or from the bus. Requires hosts to stamp requestedBy at request creation. DENY stays allowed on your own request (denying your own request withdraws it). Off by default."
+        @synonyms "self approval, self-approval, four eyes, four-eyes, separation of duties, cannot approve own, no self sign-off, dual control"
+        @tier "policy"
       threshold : number = 0
         @label "Auto-approve below this value"
         @description "Requests whose gated value is below this threshold are auto-approved. v1.0 declarative only."

package/behaviors/lolo/ui/core/atoms/std-app-layout.lolo

@@ -119,7 +119,7 @@ orbital AppLayoutOrbital {
         @description "Top-level navigation links shown on the left rail."
         @synonyms "nav links, menu items, sidebar sections, navigation entries, pages"
         @tier "presentation"
-      searchEvent : string = SEARCH
+      searchEvent : event = SEARCH
         @label "Search event"
         @description "Event emitted when the user runs a global search"
         @tier "internal"
@@ -133,7 +133,7 @@ orbital AppLayoutOrbital {
         @description "Items shown in the notifications dropdown."
         @synonyms "alerts, messages, notices, notification items, bell items"
         @tier "presentation"
-      notificationClickEvent : string = NOTIFY_CLICK
+      notificationClickEvent : event = NOTIFY_CLICK
         @label "Notification click event"
         @description "Event emitted when the user picks a notification"
         @tier "internal"

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

@@ -370,7 +370,7 @@ orbital BrowseItemOrbital {
         @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"
-      itemClickEvent : string = VIEW
+      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"

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

@@ -234,7 +234,7 @@ orbital CalendarEventOrbital {
         @description "Row column holding the timestamp the calendar grid places each chip by. Rebound hosts point this at their own column (e.g. startTime, startsAt, dueAt); the chip's LABEL comes from titleBinding, not from here."
         @synonyms "start column, date column, when field, timestamp field"
         @tier "presentation"
-      onEventClick : string = ""
+      onEventClick : event = ""
         @label "On Event Click"
         @description "Event emitted when a calendar chip is clicked: UI:{onEventClick} with { event } carrying the clicked row. Empty means chips are not clickable."
         @synonyms "open event, event click, select event, chip click"

package/behaviors/lolo/ui/core/atoms/std-date-range.lolo

@@ -78,7 +78,7 @@ orbital DateRangeOrbital {
     }
 
     config {
-      event : string = DATE_RANGE_CHANGED
+      event : event = DATE_RANGE_CHANGED
         @label "Change event"
         @description "Event name emitted when the user picks a new range"
         @tier "internal"

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

@@ -18,9 +18,9 @@ orbital DetailLayoutOrbital {
           className: "w-full"
           children: [{
             type: stack
-            direction: horizontal
-            align: center
-            gap: sm
+            direction: vertical
+            align: start
+            gap: xs
             className: "w-full border-b border-border pb-3"
             children: [{
               type: button

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

@@ -82,7 +82,7 @@ orbital FilterTargetOrbital {
         @description "Field, label, control type, and options for each filter input. numberrange renders a min/max slider pair (bounded by min/max/step) and emits one FILTER per side as `<field>_min` / `<field>_max`, mirroring daterange's `<field>_from` / `<field>_to` convention."
         @synonyms "numeric range, price range, min max, slider filter, range filter, threshold filter"
         @tier "presentation"
-      event : string = FILTER
+      event : event = FILTER
         @label "Filter event"
         @description "Event emitted when the user changes a filter selection"
         @tier "internal"

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

@@ -112,7 +112,7 @@ orbital GeoSearchResultOrbital {
         @label "Default radius (km)"
         @description "Initial search radius around the chosen center"
         @tier "presentation"
-      event : string = GEO_SEARCH
+      event : event = GEO_SEARCH
         @label "Search event"
         @description "Event emitted when the user runs a geo search"
         @tier "internal"

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

@@ -128,7 +128,7 @@ orbital GraphItemOrbital {
         @description "Keep only the first N points after sorting (0 = all)"
         @synonyms "user phrases: 'top 5' -> 5; 'top 10' -> 10; 'first 3' -> 3; 'all' / 'no limit' -> 0; 'show all' -> 0"
         @tier "presentation"
-      drillEvent : string = ""
+      drillEvent : event = ""
         @label "Drill event"
         @description "Event emitted when a user clicks a chart point"
         @synonyms "click-through navigation event. user phrases: 'on click navigate to X' / 'drill into X' / 'when clicked open X' -> X event name"

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

@@ -154,7 +154,7 @@ orbital ModalRecordOrbital {
         @description "Per-field label/placeholder/hint overrides, keyed by field name. Types, options and required-ness stay entity-schema-driven (declare once on the entity); override only display copy the entity's @description doesn't fit."
         @synonyms "field labels, custom labels, help text overrides, placeholder text"
         @tier "presentation"
-      mode : string = create
+      mode : "create" | "edit" = create
         @label "Is this for creating or editing?"
         @description "create = blank form; edit = pre-filled from the selected row."
         @synonyms "form mode, create or edit, new or update, add or modify"

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

@@ -97,7 +97,7 @@ orbital PagedItemOrbital {
         @label "Page size"
         @description "Rows per page used to derive total page count"
         @tier "presentation"
-      event : string = PAGE
+      event : event = PAGE
         @label "Page-change event"
         @description "Event emitted when the user picks a new page"
         @tier "internal"

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

@@ -70,6 +70,12 @@ orbital RecordItemOrbital {
           include: @config.include
         })
         (render-ui main { rows: 4, type: skeleton })
+      ;; Event-opened overlay (openOn: event): stays blank until OPEN_VIEW,
+      ;; but renders the blank EXPLICITLY — an embedded @trait.X reference to
+      ;; a trait with no indexed content is flagged by the compiled client's
+      ;; render probe (trait_bindings_resolved).
+      INIT -> idle when ["=", @config.openOn, "event"]
+        (render-ui main null)
       ;; self-loops on the external emits so the validator sees in-atom
       ;; listeners — the real consumers are the composing organism's
       ;; persistor (CONTENT_SAVED, TITLE_COMMITTED) and its refetch /
@@ -535,6 +541,11 @@ orbital RecordItemOrbital {
         @label "Edit button label"
         @description "Label of the quiet button above the document body that starts an editing session (the body itself is also clickable)."
         @tier "presentation"
+      allowEdit : boolean = true
+        @label "Allow editing the document?"
+        @description "When false the document look is a pure read surface: no header Edit button, no click-to-edit body, no click-to-rename title. Hosts pass a role condition here so read-only viewers get the page without its authoring affordances; the entity's own access predicates stay the enforcement floor."
+        @synonyms "read only document, viewer mode, can edit, editing allowed"
+        @tier "policy"
       doneLabel : string = "Done"
         @label "Done button label"
         @description "Label of the button that ends the document editing session; work is already autosaved when it is pressed."
@@ -613,14 +624,14 @@ orbital RecordItemOrbital {
         actions: @config.actions
         coverImage: @entity.coverUrl
         icon: @entity.iconName
-        editEvent: EDIT_CONTENT
+        editEvent: (if @config.allowEdit EDIT_CONTENT null)
         editLabel: @config.editLabel
         id: @entity.id
         maxInlineActions: @config.maxInlineActions
         placeholder: @config.placeholder
         subtitle: @entity.description
         title: @entity.name
-        titleCommitEvent: TITLE_COMMITTED
+        titleCommitEvent: (if @config.allowEdit TITLE_COMMITTED null)
         type: document-panel
         value: @entity.content
         className: "w-full"

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

@@ -118,7 +118,7 @@ orbital ScatterItemOrbital {
         @label "Chart height"
         @description "Pixel height of the rendered scatter plot"
         @tier "presentation"
-      drillEvent : string = ""
+      drillEvent : event = ""
         @label "Drill event"
         @description "Event emitted when the user clicks a data point"
         @tier "internal"

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

@@ -48,7 +48,7 @@ orbital SearchResultOrbital {
         @label "Placeholder text"
         @description "Hint text shown inside the empty search input"
         @tier "presentation"
-      event : string = SEARCH
+      event : event = SEARCH
         @label "Search event"
         @description "Event emitted when the user submits a query"
         @tier "internal"

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

@@ -52,12 +52,12 @@ orbital TagStripOrbital {
         })
       TagStripOptions -> ready
         (render-ui main {
-          children: [(if ["!=", @config.title, ""] {
+          children: [(if (or @config.readOnly ["=", @config.title, ""]) null {
             color: muted
             content: @config.title
             type: typography
             variant: caption
-          } null), {
+          }), (if @config.readOnly null {
             addEvent: ADD_TAG
             helperText: @config.helperText
             placeholder: @config.placeholder
@@ -65,7 +65,7 @@ orbital TagStripOrbital {
             type: tag-input
             value: (array/map (array/filter ?data (fn t (array/includes @entity.docTagIds (object/get @t id)))) (fn t (object/get @t name)))
             variant: secondary
-          }, (if ["=", (array/len (array/filter ?data (fn t (if (array/includes @entity.docTagIds (object/get @t id)) false true)))), 0] null {
+          }), (if (or @config.readOnly ["=", (array/len (array/filter ?data (fn t (if (array/includes @entity.docTagIds (object/get @t id)) false true)))), 0]) null {
             children: (array/map (array/filter ?data (fn t (if (array/includes @entity.docTagIds (object/get @t id)) false true))) (fn t {
               action: ADD_TAG
               actionPayload: { tag: @t.name }
@@ -299,6 +299,11 @@ orbital TagStripOrbital {
         @label "Strip caption"
         @description "Small caption above the chips; empty hides it"
         @tier "presentation"
+      readOnly : boolean = false
+        @label "Read-only?"
+        @description "When true the strip renders nothing — no add input, no remove, no suggestion chips. Hosts pass a role condition here so read-only viewers rely on the record's read-only rails (which keep showing the tags) instead of an editing surface."
+        @synonyms "read only tags, viewer mode, no tag editing, hide tag input"
+        @tier "policy"
       placeholder : string = "Add a tag…"
         @label "Input placeholder"
         @description "Placeholder in the type-to-add input"

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

@@ -1,5 +1,5 @@
 app std-thread "1.3.0"
-"std-thread — forum-style nested replies with collapse + flat-mode toggle. Owns ThreadPost (persistent). flat:true covers 1:1 linear inquiry threads; flat:false renders forum-style nested. INIT fetches, scoped by @config.threadRootId when set (blank = every root, the default). REPLY persists a child post under @payload.parentId, stamped with the real @user identity. A consumer that mounts this as page comments forwards its own document-opened signal to SET_THREAD_ROOT { rootId }, which stamps the frame and refetches filtered by the payload; the after-create and after-select refetch arms keep filtering by @config.threadRootId, so a mutation re-widens the panel until the consumer re-fires SET_THREAD_ROOT. Layer 3 variants override `bodyContent` to deliver chat-bubble, email-threaded, or linear-comments UX while inheriting the same trait, state machine, emits, and listens."
+"std-thread — forum-style nested replies with collapse + flat-mode toggle. Owns ThreadPost (persistent). flat:true covers 1:1 linear inquiry threads; flat:false renders forum-style nested. INIT fetches, scoped by @config.threadRootId when set (blank = every root, the default). REPLY persists a child post under @payload.parentId, stamped with the real @user identity. A consumer that mounts this as page comments forwards its own document-opened signal to SET_THREAD_ROOT { rootId }, which stamps the frame and refetches filtered by the payload; the after-create and after-select refetch arms keep filtering by @config.threadRootId, so a mutation re-widens the panel until the consumer re-fires SET_THREAD_ROOT. Layer 3 variants override `bodyContent` to deliver chat-bubble, email-threaded, or linear-comments UX while inheriting the same trait, state machine, emits, and listens. A non-empty sectionTitle switches the default bodyContent into titled-comments mode: header + post list + a standalone composer button (without it an empty thread has no REPLY emitter at all — the affordance only existed per-row)."
 orbital ThreadPostOrbital {
   ;; Forward relation: array of child ThreadPost IDs whose parentId === this.id.
   ;; Lowers to `type: "relation", cardinality: "many"` (orbital-lolo lower.rs).
@@ -15,7 +15,15 @@ orbital ThreadPostOrbital {
 
     type ThreadPostLoadFailed = Event { error : string, code : string } "Fired when the thread-post collection fails to load"
 
-    type ThreadPostCreated = Event { row : ThreadPost } "Fired after a new thread-post persists successfully"
+    ;; Bare entity alias, not { row: ThreadPost } — `persist create`'s success
+    ;; emit is the created row itself (flat), matching @almadar/runtime's
+    ;; EffectExecutor.ts (`successPayload = persisted ?? data`, emitted
+    ;; directly) AND orbital-core's executor.rs (`executed_with_value(effect,
+    ;; value)`), verified live 2026-08-30: a wrapped declaration validates and
+    ;; compiles clean but silently returns undefined for every `?row.<field>`
+    ;; access — no validator connects a persist-emit's declared shape to what
+    ;; the effect that fires it actually produces.
+    type ThreadPostCreated = Event ThreadPost "Fired after a new thread-post persists successfully"
 
     type ThreadPostCreateFailed = Event { error : string, code : string } "Fired when a new thread-post fails to persist"
 
@@ -97,7 +105,7 @@ orbital ThreadPostOrbital {
             type: typography
             variant: h4
           }, {
-            action: EDIT_REPLY
+            onChange: EDIT_REPLY
             placeholder: "Your reply…"
             type: textarea
           }, {
@@ -121,19 +129,50 @@ orbital ThreadPostOrbital {
           gap: md
           type: stack
         })
+      ;; Scoped to the row just created, not @config.threadRootId — a runtime-
+      ;; scoped consumer (SET_THREAD_ROOT-driven, e.g. std-wiki's WikiComments)
+      ;; never sets config.threadRootId, so that filter was permanently blank/
+      ;; unfiltered here and every document's posts bled together on refetch.
+      ;; ?threadRootId is the FLAT field on ThreadPostCreated's payload (the
+      ;; row's own scope, per the create effect's fallback chain) — NOT
+      ;; ?row.threadRootId; ThreadPostCreated's payload is the created row
+      ;; itself (see the type alias above), no `row` wrapper exists.
       ThreadPostCreated -> browsing
+        (set @entity.content "")
+        (set @entity.parentId "")
         (fetch ThreadPost {
           emit: { failure: ThreadPostLoadFailed, success: ThreadPostLoaded }
-          filter: (or ["=", @config.threadRootId, ""] ["=", (object/get @entity threadRootId), @config.threadRootId])
+          filter: (or ["=", ?threadRootId, ""] ["=", (object/get @entity threadRootId), ?threadRootId])
           include: (replies)
         })
+      ;; SELECT's payload IS { id, row } (caller-constructed, unlike the
+      ;; persist-auto-emitted ThreadPostCreated) — ?row.threadRootId is
+      ;; correct here.
       SELECT -> loading
         (set @entity.focusedRow ?row)
         (fetch ThreadPost {
           emit: { failure: ThreadPostLoadFailed, success: ThreadPostLoaded }
-          filter: (or ["=", @config.threadRootId, ""] ["=", (object/get @entity threadRootId), @config.threadRootId])
+          filter: (or ["=", ?row.threadRootId, ""] ["=", (object/get @entity threadRootId), ?row.threadRootId])
           include: (replies)
         })
+      ;; Inline composers (bodyContent overrides with their own textarea +
+      ;; submit button) fire the composer triad while the trait sits in
+      ;; browsing — without these arms every such click is swallowed.
+      EDIT_REPLY -> browsing
+        (set @entity.content ?value)
+      SUBMIT_REPLY -> browsing when (not ["=", (str/default @entity.content ""), ""])
+        (persist create ThreadPost {
+          authorId: @user.id
+          authorName: @user.name
+          content: @entity.content
+          parentId: (str/default @entity.parentId "")
+          threadRootId: (str/default @entity.threadRootId (str/default @config.threadRootId root))
+        } {
+          emit: { failure: ThreadPostCreateFailed, success: ThreadPostCreated }
+        })
+      CANCEL_REPLY -> browsing
+        (set @entity.content "")
+        (set @entity.parentId "")
       ;; replying.SUBMIT_REPLY -> browsing lands here before the persist
       ;; resolves; a failure must be caught here too, not just replying's twin arm.
       ThreadPostCreateFailed -> browsing
@@ -163,19 +202,27 @@ orbital ThreadPostOrbital {
     state replying {
       EDIT_REPLY -> replying
         (set @entity.content ?value)
-      SUBMIT_REPLY -> browsing
-        (persist create ThreadPost (object/merge ?data { authorId: @user.id, authorName: @user.name }) {
+      SUBMIT_REPLY -> browsing when (not ["=", (str/default @entity.content ""), ""])
+        (persist create ThreadPost {
+          authorId: @user.id
+          authorName: @user.name
+          content: @entity.content
+          parentId: (str/default @entity.parentId "")
+          threadRootId: (str/default @entity.threadRootId (str/default @config.threadRootId root))
+        } {
           emit: { failure: ThreadPostCreateFailed, success: ThreadPostCreated }
         })
       CANCEL_REPLY -> browsing
         (set @entity.content "")
         (set @entity.parentId "")
+      ;; Scoped to the row just created (?threadRootId, flat) — see the twin
+      ;; arm in `browsing` for why.
       ThreadPostCreated -> browsing
         (set @entity.content "")
         (set @entity.parentId "")
         (fetch ThreadPost {
           emit: { failure: ThreadPostLoadFailed, success: ThreadPostLoaded }
-          filter: (or ["=", @config.threadRootId, ""] ["=", (object/get @entity threadRootId), @config.threadRootId])
+          filter: (or ["=", ?threadRootId, ""] ["=", (object/get @entity threadRootId), ?threadRootId])
           include: (replies)
         })
       ThreadPostCreateFailed -> replying
@@ -234,10 +281,8 @@ orbital ThreadPostOrbital {
         @description "Indicates a reply has been modified."
         @synonyms "update, change, modify"
         @tier "presentation"
-      SUBMIT_REPLY {
-        data : @entity!
-      }
-        @description "Signals a new reply has been successfully submitted."
+      SUBMIT_REPLY
+        @description "Signals the composed draft should be persisted as a new post — the draft is read from the entity frame (@entity.content), so bare buttons can emit it."
         @synonyms "post, send, add, publish"
         @tier "domain"
       CANCEL_REPLY
@@ -257,10 +302,8 @@ orbital ThreadPostOrbital {
         @description "Indicates a failure to load a thread post."
         @synonyms "load error, fetch failed, retrieval failed"
         @tier "internal"
-      ThreadPostCreated {
-        row : ThreadPost
-      }
-        @description "A new post has been added to the thread."
+      ThreadPostCreated
+        @description "A new post has been added to the thread — payload is the created ThreadPost row itself (flat: ?id, ?threadRootId, ?authorId, ?content, …), not wrapped under a row field."
         @synonyms "new post, added, created"
         @tier "domain"
       ThreadPostCreateFailed {
@@ -294,10 +337,8 @@ orbital ThreadPostOrbital {
         @description "A reply is being modified."
         @synonyms "update, change, revise"
         @tier "presentation"
-      SUBMIT_REPLY {
-        data : @entity!
-      }
-        @description "A new reply has been submitted and is awaiting processing."
+      SUBMIT_REPLY
+        @description "A new reply has been submitted and is awaiting processing — the draft is read from the entity frame (@entity.content), no payload required."
         @synonyms "post, send, add, submit"
         @tier "domain"
       CANCEL_REPLY
@@ -317,10 +358,8 @@ orbital ThreadPostOrbital {
         @description "Indicates a failure to load a thread post."
         @synonyms "error, failure, load failed"
         @tier "internal"
-      ThreadPostCreated {
-        row : ThreadPost
-      }
-        @description "A new post has been added to the thread."
+      ThreadPostCreated
+        @description "A new post has been added to the thread — payload is the created ThreadPost row itself (flat: ?id, ?threadRootId, ?authorId, ?content, …), not wrapped under a row field."
         @synonyms "new post, added, created"
         @tier "domain"
       ThreadPostCreateFailed {
@@ -356,9 +395,15 @@ orbital ThreadPostOrbital {
         @label "recipientName"
         @description "Header/recipient label for chat-style threads."
         @tier "presentation"
-      sectionTitle : string = Discussion
+      sectionTitle : string = ""
         @label "sectionTitle"
-        @description "Section header for linear-comment threads."
+        @description "Section header rendered by the default bodyContent when non-empty, along with a standalone composer button — the only REPLY affordance an empty thread has. Blank (the default) keeps the bare post list for embedded threads that bring their own chrome (chat rails, custom comment sections)."
+        @synonyms "header, comments title, discussion title"
+        @tier "presentation"
+      composerLabel : string = "Add comment"
+        @label "composerLabel"
+        @description "Label of the standalone composer button rendered under the post list when sectionTitle is non-empty."
+        @synonyms "reply label, comment button, add comment"
         @tier "presentation"
       emailAuthorBinding : string = @item.authorName
         @label "emailAuthorBinding"
@@ -413,7 +458,15 @@ orbital ThreadPostOrbital {
         @description "Reply binding for the reply body."
         @tier "presentation"
       bodyContent : render-ui = {
-        children: [{
+        children: [(if ["!=", @config.sectionTitle, ""] {
+          content: @config.sectionTitle
+          type: typography
+          variant: h4
+        } {
+          children: []
+          gap: none
+          type: stack
+        }), {
           entity: ?data
           fields: [{
             label: Author
@@ -437,7 +490,17 @@ orbital ThreadPostOrbital {
           look: @config.tableLook
           type: data-list
           variant: card
-        }]
+        }, (if ["!=", @config.sectionTitle, ""] {
+          action: REPLY
+          icon: message-square
+          label: @config.composerLabel
+          type: button
+          variant: secondary
+        } {
+          children: []
+          gap: none
+          type: stack
+        })]
         direction: vertical
         gap: md
         type: stack

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

@@ -113,7 +113,7 @@ orbital TreeNodeOrbital {
             type: file-tree
           }]
           direction: vertical
-          gap: md
+          gap: (if ["=", @config.look, "rail"] none md)
           type: stack
         })
       TreeNodeLoadFailed -> error
@@ -265,7 +265,7 @@ orbital TreeNodeOrbital {
             type: file-tree
           }]
           direction: vertical
-          gap: md
+          gap: (if ["=", @config.look, "rail"] none md)
           type: stack
         })
       TreeNodeLoadFailed -> error

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

@@ -77,11 +77,11 @@ orbital AvatarOrbital {
         @label "Class Name"
         @description "Additional CSS classes"
         @tier "presentation"
-      onClick : string = "CLICK"
+      onClick : event = "CLICK"
         @label "On Click"
         @description "Click handler"
         @tier "presentation"
-      action : string = "ACTION"
+      action : event = "ACTION"
         @label "Action"
         @description "Declarative event name — emits UI:{action} via eventBus on click"
         @tier "presentation"

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

@@ -68,7 +68,7 @@ orbital BadgeOrbital {
         @label "Icon Asset"
         @description "Asset image rendered as the badge icon; takes precedence over icon when provided."
         @tier "presentation"
-      onRemove : string = ""
+      onRemove : event = ""
         @label "On Remove"
         @description "When set, renders a small X button on the right of the badge that invokes this handler — turns the badge into a removable chip. Used by the TagInput molecule and other 'list of removable values' surfaces."
         @tier "presentation"

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

@@ -115,7 +115,7 @@ orbital BoxOrbital {
         @label "Position"
         @description "Position"
         @tier "presentation"
-      action : string = "ACTION"
+      action : event = "ACTION"
         @label "Action"
         @description "Declarative event name — emits UI:{action} via eventBus on click"
         @tier "presentation"
@@ -123,7 +123,7 @@ orbital BoxOrbital {
         @label "Action Payload"
         @description "Payload to include with the action event"
         @tier "presentation"
-      hoverEvent : string = "HOVER"
+      hoverEvent : event = "HOVER"
         @label "Hover Event"
         @description "Declarative hover event — emits UI:{hoverEvent} with { hovered: true/false } on mouseEnter/mouseLeave"
         @tier "presentation"

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

@@ -88,7 +88,7 @@ orbital ButtonOrbital {
         @label "Icon Asset"
         @description "Asset image rendered as the leading icon; takes precedence over icon/leftIcon when provided."
         @tier "presentation"
-      action : string = "ACTION"
+      action : event = "ACTION"
         @label "Action"
         @description "Declarative event name — emits UI:{action} via eventBus on click"
         @tier "presentation"

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

@@ -66,7 +66,7 @@ orbital CardOrbital {
         @label "Children"
         @description "Card content"
         @tier "presentation"
-      action : string = "ACTION"
+      action : event = "ACTION"
         @label "Action"
         @description "Declarative event key emitted on click for trait dispatch"
         @tier "presentation"

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

@@ -45,7 +45,7 @@ orbital CheckboxOrbital {
         @label "Label"
         @description "label prop"
         @tier "presentation"
-      onChange : string = "CHANGE"
+      onChange : event = "CHANGE"
         @label "On Change"
         @description "onChange handler or declarative event key for trait dispatch"
         @tier "presentation"

package/behaviors/lolo/ui/core/atoms/ui-day-cell.lolo

@@ -36,7 +36,7 @@ orbital DayCellOrbital {
         @label "Is Today"
         @description "Whether this date is today"
         @tier "presentation"
-      onClick : string = "CLICK"
+      onClick : event = "CLICK"
         @label "On Click"
         @description "Called when the day is clicked"
         @tier "presentation"

package/behaviors/lolo/ui/core/atoms/ui-filter-pill.lolo

@@ -77,7 +77,7 @@ orbital FilterPillOrbital {
         @label "Icon"
         @description "Lucide icon component or canonical kebab-case icon name string"
         @tier "presentation"
-      onRemove : string = ""
+      onRemove : event = ""
         @label "On Remove"
         @description "Called when the user clicks the remove (×) button"
         @tier "presentation"
@@ -85,15 +85,15 @@ orbital FilterPillOrbital {
         @label "Removable"
         @description "Disable the remove button (renders without × control)"
         @tier "presentation"
-      onClick : string = "CLICK"
+      onClick : event = "CLICK"
         @label "On Click"
         @description "Click handler for the body of the pill (filter toggle)"
         @tier "presentation"
-      clickEvent : string = "CLICK"
+      clickEvent : event = "CLICK"
         @label "Click Event"
         @description "Event name dispatched via event bus when the pill body is clicked. Payload: { label }"
         @tier "presentation"
-      removeEvent : string = ""
+      removeEvent : event = ""
         @label "Remove Event"
         @description "Event name dispatched via event bus when the remove (×) button is clicked. Payload: { label }"
         @tier "presentation"

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

@@ -40,7 +40,7 @@ orbital FlipContainerOrbital {
         @label "Children"
         @description "The two face elements (front and back)"
         @tier "presentation"
-      onClick : string = "CLICK"
+      onClick : event = "CLICK"
         @label "On Click"
         @description "Click handler on the outer wrapper"
         @tier "presentation"

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

@@ -82,7 +82,7 @@ orbital HstackOrbital {
         @label "Tab Index"
         @description "Tab index for focus management"
         @tier "presentation"
-      action : string = "ACTION"
+      action : event = "ACTION"
         @label "Action"
         @description "Declarative event name — emits UI:{action} via eventBus on click"
         @tier "presentation"