@almadar/std 16.192.0 → 16.194.0

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

@@ -39,7 +39,7 @@ orbital TagTaxonomyOrbital {
           align: center
           children: [{ type: spinner }, {
             color: muted
-            content: "Loading categories…"
+            content: "Loading…"
             type: typography
             variant: caption
           }]
@@ -54,7 +54,7 @@ orbital TagTaxonomyOrbital {
             action: SHOW_ROOT
             disabled: (if (!= @entity.id "") false true)
             icon: arrow-left
-            label: "All categories"
+            label: @config.rootLabel
             size: sm
             type: button
             variant: ghost
@@ -65,7 +65,7 @@ orbital TagTaxonomyOrbital {
           }, (if @config.allowEdit {
             action: NEW_TAG
             icon: plus
-            label: "New category"
+            label: @config.createLabel
             size: sm
             type: button
             variant: secondary
@@ -150,7 +150,7 @@ orbital TagTaxonomyOrbital {
           align: center
           children: [{ type: spinner }, {
             color: muted
-            content: "Loading categories…"
+            content: "Loading…"
             type: typography
             variant: caption
           }]
@@ -171,7 +171,7 @@ orbital TagTaxonomyOrbital {
           align: center
           children: [{ type: spinner }, {
             color: muted
-            content: "Loading children…"
+            content: "Loading…"
             type: typography
             variant: caption
           }]
@@ -191,7 +191,7 @@ orbital TagTaxonomyOrbital {
           align: center
           children: [{ type: spinner }, {
             color: muted
-            content: "Loading categories…"
+            content: "Loading…"
             type: typography
             variant: caption
           }]
@@ -206,7 +206,7 @@ orbital TagTaxonomyOrbital {
             action: SHOW_ROOT
             disabled: (if (!= @entity.id "") false true)
             icon: arrow-left
-            label: "All categories"
+            label: @config.rootLabel
             size: sm
             type: button
             variant: ghost
@@ -217,7 +217,7 @@ orbital TagTaxonomyOrbital {
           }, (if @config.allowEdit {
             action: NEW_TAG
             icon: plus
-            label: "New category"
+            label: @config.createLabel
             size: sm
             type: button
             variant: secondary
@@ -285,7 +285,7 @@ orbital TagTaxonomyOrbital {
       NEW_TAG -> creating when @config.allowEdit
         (render-ui modal {
           children: [{
-            content: "New category"
+            content: @config.createLabel
             type: typography
             variant: h3
           }, {
@@ -330,7 +330,7 @@ orbital TagTaxonomyOrbital {
           align: center
           children: [{ type: spinner }, {
             color: muted
-            content: "Loading categories…"
+            content: "Loading…"
             type: typography
             variant: caption
           }]
@@ -347,7 +347,7 @@ orbital TagTaxonomyOrbital {
           align: center
           children: [{ type: spinner }, {
             color: muted
-            content: "Loading categories…"
+            content: "Loading…"
             type: typography
             variant: caption
           }]
@@ -380,7 +380,7 @@ orbital TagTaxonomyOrbital {
           align: center
           children: [{ type: spinner }, {
             color: muted
-            content: "Loading categories…"
+            content: "Loading…"
             type: typography
             variant: caption
           }]
@@ -402,7 +402,7 @@ orbital TagTaxonomyOrbital {
             action: SHOW_ROOT
             disabled: (if (!= @entity.id "") false true)
             icon: arrow-left
-            label: "All categories"
+            label: @config.rootLabel
             size: sm
             type: button
             variant: ghost
@@ -413,7 +413,7 @@ orbital TagTaxonomyOrbital {
           }, (if @config.allowEdit {
             action: NEW_TAG
             icon: plus
-            label: "New category"
+            label: @config.createLabel
             size: sm
             type: button
             variant: secondary
@@ -498,7 +498,7 @@ orbital TagTaxonomyOrbital {
           align: center
           children: [{ type: spinner }, {
             color: muted
-            content: "Loading categories…"
+            content: "Loading…"
             type: typography
             variant: caption
           }]
@@ -536,7 +536,7 @@ orbital TagTaxonomyOrbital {
         @synonyms "chosen, picked, activated, highlighted"
         @tier "domain"
       NEW_TAG
-        @description "Opens the new-category form (rendered only when allowEdit is on); the creation lands at the level currently open."
+        @description "Opens the create-tag form (rendered only when allowEdit is on); the creation lands at the level currently open."
         @synonyms "add tag, create category, new category"
         @tier "domain"
       COMMIT_TAG {
@@ -638,8 +638,18 @@ orbital TagTaxonomyOrbital {
         @tier "presentation"
       allowEdit : boolean = false
         @label "Allow editing"
-        @description "Render the New-category affordance: creations land at the level currently open (top level, or inside the drilled-into category). Rename is a follow-up (ledgered)."
+        @description "Render the create-tag affordance: creations land at the level currently open (top level, or inside the drilled-into category). Rename is a follow-up (ledgered)."
         @tier "domain"
+      createLabel : string = "New tag"
+        @label "Create-button label"
+        @description "Label on the create affordance and its form heading — say what this taxonomy calls its entries (New tag, New category, New topic)."
+        @synonyms "add label, new tag label, create caption"
+        @tier "presentation"
+      rootLabel : string = "All tags"
+        @label "Back-to-root label"
+        @description "Label on the back affordance that returns from a drilled-in level to the root — phrase it in this taxonomy's vocabulary (All tags, All categories)."
+        @synonyms "back label, root caption, all label"
+        @tier "presentation"
       tableLook : "dense" | "spacious" | "striped" | "borderless" | "card-rows" = dense
         @label "Table look"
         @description "Layer 2 visual treatment for the data table rendered by this atom."

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

@@ -1,5 +1,5 @@
 app std-tree "1.0.0"
-"std-tree — generic hierarchical node browser. Fetches a flat TreeNode collection and renders it through file-tree's flat `items` mode (parentId-nested at render time by the component, not the .lolo); OPEN_NODE is the external handoff for a selected node's id. Rebindable: pass `fields` at the call site to retarget it at any parent-pointer entity (categories, org units, comment threads). Search/filter are wired (REFETCH_QUERY/REFETCH_FILTER re-fetch the flat node set server-side); pagination is deliberately NOT offered — a hierarchy is not a paged list, and paging a flat node set would sever children from parents that fell on another page."
+"std-tree — generic hierarchical node browser. Fetches a flat TreeNode collection and renders it through file-tree's flat `items` mode (parentId-nested at render time by the component, not the .lolo); OPEN_NODE is the external handoff for a selected node's id. Rebindable: pass `fields` at the call site to retarget it at any parent-pointer entity (categories, org units, comment threads). Search/filter are wired (REFETCH_QUERY/REFETCH_FILTER re-fetch the flat node set server-side). `look: rail` renders the compact sidebar-navigation form (slim caption, nav-styled rows) for mounting in an app layout's sidebarTrait; SET_CURRENT marks the open record so the row highlights and its ancestors auto-expand; `childAction: true` renders a hover plus-affordance per row emitting CHILD_REQUESTED { parentId } for the host's create-draft writer; pagination is deliberately NOT offered — a hierarchy is not a paged list, and paging a flat node set would sever children from parents that fell on another page."
 type FilterSpec = { field : string!, label : string, options : [string] }
 orbital TreeNodeOrbital {
     type TreeNodeLoaded = Event { data : [TreeNode] } "Fired when the tree node collection finishes loading"
@@ -18,6 +18,11 @@ orbital TreeNodeOrbital {
     initial: loading
 
     state loading {
+      SET_CURRENT -> loading
+        (set @entity.id ?id)
+        (fetch TreeNode {
+          emit: { failure: TreeNodeLoadFailed, success: TreeNodeLoaded }
+        })
       INIT -> loading
         (fetch TreeNode {
           emit: { failure: TreeNodeLoadFailed, success: TreeNodeLoaded }
@@ -37,7 +42,13 @@ orbital TreeNodeOrbital {
         })
       TreeNodeLoaded -> browsing
         (render-ui main {
-          children: [{
+          children: [(if ["=", @config.look, "rail"] {
+            className: "px-2 pb-1 uppercase tracking-wide"
+            color: muted
+            content: @config.title
+            type: typography
+            variant: caption
+          } {
             align: center
             children: [{ name: list-tree, type: icon }, {
               content: @config.title
@@ -52,7 +63,11 @@ orbital TreeNodeOrbital {
             direction: horizontal
             gap: sm
             type: stack
-          }, { type: divider }, (if @config.bodySearch {
+          }), (if ["=", @config.look, "rail"] {
+            children: []
+            gap: none
+            type: stack
+          } { type: divider }), (if @config.bodySearch {
             children: [{
               className: "w-full max-w-md"
               clearable: true
@@ -84,16 +99,21 @@ orbital TreeNodeOrbital {
             type: stack
           }), {
             items: (array/map ?data (fn row {
-              icon: @row.icon
+              icon: (str/default (object/get @row @config.iconField) "")
               id: @row.id
-              label: @row.name
-              parentId: @row.parentId
+              label: (str/default (object/get @row @config.labelField) "")
+              parentId: (str/default (object/get @row @config.parentField) "")
             }))
+            look: (if ["=", @config.look, "rail"] nav files)
+            nodeActionIcon: plus
+            nodeActionLabel: @config.childActionLabel
+            onNodeAction: (if @config.childAction ADD_CHILD null)
             onNodeSelect: OPEN_NODE
+            selectedId: (str/default (object/get @entity id) "")
             type: file-tree
           }]
           direction: vertical
-          gap: md
+          gap: (if ["=", @config.look, "rail"] none md)
           type: stack
         })
       TreeNodeLoadFailed -> error
@@ -153,7 +173,7 @@ orbital TreeNodeOrbital {
       REFETCH_QUERY -> browsing
         (fetch TreeNode {
           emit: { failure: TreeNodeLoadFailed, success: TreeNodeLoaded }
-          filter: (or ["=", ?searchTerm, ""] (str/includes (object/get @entity name) ?searchTerm))
+          filter: (or ["=", ?searchTerm, ""] (str/includes (str/default (object/get @entity @config.labelField) "") ?searchTerm))
         })
       REFETCH_FILTER -> browsing
         (fetch TreeNode {
@@ -162,9 +182,25 @@ orbital TreeNodeOrbital {
         })
       OPEN_NODE -> browsing
         (set @entity.id ?id)
+      ;; The open record changed (routed from the host document's load
+      ;; events): remember it and re-fetch so the re-render highlights the
+      ;; row and unfolds its ancestors.
+      SET_CURRENT -> browsing
+        (set @entity.id ?id)
+        (fetch TreeNode {
+          emit: { failure: TreeNodeLoadFailed, success: TreeNodeLoaded }
+        })
+      ADD_CHILD -> browsing
+        (emit CHILD_REQUESTED { parentId: ?id })
       TreeNodeLoaded -> browsing
         (render-ui main {
-          children: [{
+          children: [(if ["=", @config.look, "rail"] {
+            className: "px-2 pb-1 uppercase tracking-wide"
+            color: muted
+            content: @config.title
+            type: typography
+            variant: caption
+          } {
             align: center
             children: [{ name: list-tree, type: icon }, {
               content: @config.title
@@ -179,7 +215,11 @@ orbital TreeNodeOrbital {
             direction: horizontal
             gap: sm
             type: stack
-          }, { type: divider }, (if @config.bodySearch {
+          }), (if ["=", @config.look, "rail"] {
+            children: []
+            gap: none
+            type: stack
+          } { type: divider }), (if @config.bodySearch {
             children: [{
               className: "w-full max-w-md"
               clearable: true
@@ -211,16 +251,21 @@ orbital TreeNodeOrbital {
             type: stack
           }), {
             items: (array/map ?data (fn row {
-              icon: @row.icon
+              icon: (str/default (object/get @row @config.iconField) "")
               id: @row.id
-              label: @row.name
-              parentId: @row.parentId
+              label: (str/default (object/get @row @config.labelField) "")
+              parentId: (str/default (object/get @row @config.parentField) "")
             }))
+            look: (if ["=", @config.look, "rail"] nav files)
+            nodeActionIcon: plus
+            nodeActionLabel: @config.childActionLabel
+            onNodeAction: (if @config.childAction ADD_CHILD null)
             onNodeSelect: OPEN_NODE
+            selectedId: (str/default (object/get @entity id) "")
             type: file-tree
           }]
           direction: vertical
-          gap: md
+          gap: (if ["=", @config.look, "rail"] none md)
           type: stack
         })
       TreeNodeLoadFailed -> error
@@ -275,6 +320,12 @@ orbital TreeNodeOrbital {
         @description "Signals a tree node has been selected for external handoff."
         @synonyms "select, choose, open, activate"
         @tier "domain"
+      CHILD_REQUESTED -> external {
+        parentId : string!
+      }
+        @description "Create a new record under this node — the host routes it into its create-draft writer with parentId stamped."
+        @synonyms "new subpage, add child page, create under"
+        @tier "domain"
       TreeNodeLoaded {
         data : [TreeNode]
       }
@@ -291,6 +342,18 @@ orbital TreeNodeOrbital {
     }
 
     listens {
+      SET_CURRENT {
+        id : string!
+      }
+        @description "Mark this record as the open one (routed from the host document's load events); its row highlights and its ancestors auto-expand."
+        @synonyms "highlight current, select node, you are here"
+        @tier "domain"
+      ADD_CHILD {
+        id : string!
+      }
+        @description "The row's hover + affordance was clicked."
+        @synonyms "add inside, new child"
+        @tier "presentation"
       REFETCH_QUERY {
         searchTerm : string!
       }
@@ -330,6 +393,35 @@ orbital TreeNodeOrbital {
         @label "Section title"
         @description "Heading shown above the tree"
         @tier "presentation"
+      labelField : string = name
+        @label "Label column"
+        @description "Entity field rendered as each node's label. Config-driven on purpose: the trait-level `fields {}` remap is compiled-path-only (the JS runtime never applies it), so a rebind names its columns here and both execution paths agree."
+        @synonyms "title field, name column, display field"
+        @tier "domain"
+      parentField : string = parentId
+        @label "Parent column"
+        @description "Entity field holding the parent reference the hierarchy nests by."
+        @synonyms "parent id field, hierarchy column"
+        @tier "domain"
+      iconField : string = icon
+        @label "Icon column"
+        @description "Entity field holding each node's icon name; point it at a nonexistent field (or empty) to suppress per-node icons."
+        @synonyms "glyph field, icon column"
+        @tier "presentation"
+      look : "full" | "rail" = full
+        @label "Tree look"
+        @description "full = standalone section (heading, count, divider); rail = compact sidebar navigation (slim caption, nav-styled rows) for an app layout's sidebarTrait slot."
+        @synonyms "sidebar tree, rail look, nav tree, compact"
+        @tier "presentation"
+      childAction : boolean = false
+        @label "Row + affordance?"
+        @description "Render a hover + on every row that emits CHILD_REQUESTED { parentId } — wire it to the host's create-draft writer so new records are born inside the node."
+        @synonyms "add inside, new subpage button, plus on rows"
+        @tier "domain"
+      childActionLabel : string = "Add inside"
+        @label "Row + tooltip"
+        @description "Accessible label on the row's + affordance (e.g. New subpage)."
+        @tier "presentation"
       bodySearch : boolean = false
         @label "Show the tree's own search box?"
         @description "Embeds a search box above the tree that re-fetches the flat node set server-side. Set false (the default) when the page already provides a search affordance (a toolbar Search molecule), so the surface shows one search box instead of two."

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"