@almadar/std 16.191.0 → 16.193.0

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,12 +99,17 @@ 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
@@ -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,12 +251,17 @@ 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
@@ -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/std-version-history.lolo

@@ -245,7 +245,9 @@ orbital RevisionOrbital {
               label: Document
               look: @config.statLook
               type: stat-display
-              value: @entity.documentId
+              ;; The captured title, never the raw foreign id — also keeps this
+              ;; binding scalar when a consumer retypes documentId as a relation.
+              value: (str/default @entity.summary "")
             }, {
               icon: layers
               label: Type

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

@@ -15,7 +15,7 @@ orbital CalendarGridOrbital {
     initial: idle
 
     state idle {
-      INIT -> idle
+      INIT -> idle when @config.selfFetch
         (fetch CalendarGridItem { emit: { success: CalendarGridLoaded } })
         (render-ui main {
           weekStart: @config.weekStart
@@ -36,6 +36,26 @@ orbital CalendarGridOrbital {
           colorField: @config.colorField
           type: calendar-grid
         })
+      INIT -> idle when (not @config.selfFetch)
+        (render-ui main {
+          weekStart: @config.weekStart
+          timeSlots: @config.timeSlots
+          events: @entity
+          onSlotClick: @config.onSlotClick
+          onDayClick: @config.onDayClick
+          onEventClick: @config.onEventClick
+          className: @config.className
+          longPressEvent: @config.longPressEvent
+          longPressPayload: @config.longPressPayload
+          swipeLeftEvent: @config.swipeLeftEvent
+          swipeRightEvent: @config.swipeRightEvent
+          dayWindow: @config.dayWindow
+          titleField: @config.titleField
+          startField: @config.startField
+          endField: @config.endField
+          colorField: @config.colorField
+          type: calendar-grid
+        })
       CalendarGridLoaded -> idle
         (render-ui main {
           weekStart: @config.weekStart
@@ -158,6 +178,10 @@ orbital CalendarGridOrbital {
         @label "Color Field"
         @description "Row field holding the chip's Tailwind colour class. Defaults to `color`."
         @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"
     }
   }
 

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

@@ -41,7 +41,7 @@ orbital DataGridOrbital {
     initial: idle
 
     state idle {
-      INIT -> idle
+      INIT -> idle when @config.selfFetch
         (fetch DataGridItem { emit: { success: DataGridLoaded } })
         (render-ui main {
           dragGroup: @config.dragGroup
@@ -74,6 +74,38 @@ orbital DataGridOrbital {
           look: @config.look
           type: data-grid
         })
+      INIT -> idle when (not @config.selfFetch)
+        (render-ui main {
+          dragGroup: @config.dragGroup
+          accepts: @config.accepts
+          sortable: @config.sortable
+          dropEvent: @config.dropEvent
+          reorderEvent: @config.reorderEvent
+          positionEvent: @config.positionEvent
+          dndItemIdField: @config.dndItemIdField
+          dndRoot: @config.dndRoot
+          entity: @entity
+          fields: @config.fields
+          columns: @config.columns
+          itemActions: @config.itemActions
+          maxInlineActions: @config.maxInlineActions
+          scrollX: @config.scrollX
+          cols: @config.cols
+          gap: @config.gap
+          minCardWidth: @config.minCardWidth
+          className: @config.className
+          isLoading: @config.isLoading
+          error: @config.error
+          imageField: @config.imageField
+          selectable: @config.selectable
+          selectionEvent: @config.selectionEvent
+          infiniteScroll: @config.infiniteScroll
+          loadMoreEvent: @config.loadMoreEvent
+          hasMore: @config.hasMore
+          pageSize: @config.pageSize
+          look: @config.look
+          type: data-grid
+        })
       DataGridLoaded -> idle
         (render-ui main {
           dragGroup: @config.dragGroup
@@ -239,6 +271,10 @@ orbital DataGridOrbital {
         @label "Look"
         @description "Layer 2 visual treatment — mirrors the `entity-table` look enum so data-grid / data-list / entity-table share one knob name from authors."
         @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"
     }
   }
 

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

@@ -47,7 +47,7 @@ orbital DataListOrbital {
     initial: idle
 
     state idle {
-      INIT -> idle
+      INIT -> idle when @config.selfFetch
         (fetch DataListItem { emit: { success: DataListLoaded } })
         (render-ui main {
           dragGroup: @config.dragGroup
@@ -89,6 +89,47 @@ orbital DataListOrbital {
           look: @config.look
           type: data-list
         })
+      INIT -> idle when (not @config.selfFetch)
+        (render-ui main {
+          dragGroup: @config.dragGroup
+          accepts: @config.accepts
+          sortable: @config.sortable
+          dropEvent: @config.dropEvent
+          reorderEvent: @config.reorderEvent
+          positionEvent: @config.positionEvent
+          dndItemIdField: @config.dndItemIdField
+          dndRoot: @config.dndRoot
+          entity: @entity
+          fields: @config.fields
+          columns: @config.columns
+          itemActions: @config.itemActions
+          maxInlineActions: @config.maxInlineActions
+          itemClickEvent: @config.itemClickEvent
+          gap: @config.gap
+          variant: @config.variant
+          groupBy: @config.groupBy
+          senderField: @config.senderField
+          senderLabelField: @config.senderLabelField
+          currentUser: @config.currentUser
+          emptyMessage: @config.emptyMessage
+          className: @config.className
+          isLoading: @config.isLoading
+          error: @config.error
+          reorderable: @config.reorderable
+          swipeLeftEvent: @config.swipeLeftEvent
+          swipeLeftActions: @config.swipeLeftActions
+          swipeRightEvent: @config.swipeRightEvent
+          swipeRightActions: @config.swipeRightActions
+          longPressEvent: @config.longPressEvent
+          infiniteScroll: @config.infiniteScroll
+          loadMoreEvent: @config.loadMoreEvent
+          hasMore: @config.hasMore
+          pageSize: @config.pageSize
+          sortBy: @config.sortBy
+          sortDirection: @config.sortDirection
+          look: @config.look
+          type: data-list
+        })
       DataListLoaded -> idle
         (render-ui main {
           dragGroup: @config.dragGroup
@@ -319,6 +360,10 @@ orbital DataListOrbital {
         @label "Look"
         @description "Layer 2 visual treatment — mirrors the `entity-table` look enum so data-grid / data-list / entity-table share one knob name from authors."
         @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"
     }
   }
 

package/behaviors/lolo/ui/core/molecules/ui-document-details.lolo

@@ -9,9 +9,10 @@ orbital DocumentDetailsOrbital {
     label : string
     header : string
     icon : icon
-    kind : "text" | "boolean" | "select" | "readonly"
+    kind : "text" | "boolean" | "select" | "readonly" | "image"
     options : [string]
     format : "date" | "currency" | "number" | "boolean" | "percent"
+    type : string
   }
 
   entity DocumentDetailsItem [runtime] {
@@ -22,12 +23,23 @@ orbital DocumentDetailsOrbital {
     initial: idle
 
     state idle {
-      INIT -> idle
+      INIT -> idle when @config.selfFetch
         (fetch DocumentDetailsItem { emit: { success: DocumentDetailsLoaded } })
         (render-ui main {
           entity: @entity
           fields: @config.fields
           metaCommitEvent: @config.metaCommitEvent
+          relationEvent: @config.relationEvent
+          title: @config.title
+          className: @config.className
+          type: document-details
+        })
+      INIT -> idle when (not @config.selfFetch)
+        (render-ui main {
+          entity: @entity
+          fields: @config.fields
+          metaCommitEvent: @config.metaCommitEvent
+          relationEvent: @config.relationEvent
           title: @config.title
           className: @config.className
           type: document-details
@@ -37,6 +49,7 @@ orbital DocumentDetailsOrbital {
           entity: @payload.data
           fields: @config.fields
           metaCommitEvent: @config.metaCommitEvent
+          relationEvent: @config.relationEvent
           title: @config.title
           className: @config.className
           type: document-details
@@ -50,6 +63,13 @@ orbital DocumentDetailsOrbital {
       }
         @description "Emitted when a property commits: { id, patch } — patch carries the id plus the one changed field, ready for a partial persist update."
         @tier "essential"
+      @config.relationEvent -> external {
+        field : string!
+        id : string!
+        name : string!
+      }
+        @description "Makes relation chips clickable: emitted with { field, id, name } when a hydrated relation value (or one row of a many-relation) is clicked — the host routes it to the linked record's own surface."
+        @tier "essential"
       DocumentDetailsLoaded
         @description "DocumentDetails rows finished loading; payload.data holds the collection."
         @synonyms "loaded, fetched, retrieved"
@@ -65,6 +85,10 @@ orbital DocumentDetailsOrbital {
         @label "Meta Commit Event"
         @description "Emitted when a property commits: { id, patch } — patch carries the id plus the one changed field, ready for a partial persist update."
         @tier "presentation"
+      relationEvent : string = "RELATION"
+        @label "Relation Event"
+        @description "Makes relation chips clickable: emitted with { field, id, name } when a hydrated relation value (or one row of a many-relation) is clicked — the host routes it to the linked record's own surface."
+        @tier "presentation"
       title : string
         @label "Title"
         @description "Card heading (defaults to the localized 'Details')"
@@ -73,6 +97,10 @@ orbital DocumentDetailsOrbital {
         @label "Class Name"
         @description "className prop"
         @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"
     }
   }
 

package/behaviors/lolo/ui/core/molecules/ui-document-panel.lolo

@@ -25,6 +25,8 @@ orbital DocumentPanelOrbital {
         (render-ui main {
           title: @entity.title
           subtitle: @config.subtitle
+          coverImage: @config.coverImage
+          icon: @config.icon
           value: @entity.value
           actions: @config.actions
           maxInlineActions: @config.maxInlineActions
@@ -45,6 +47,8 @@ orbital DocumentPanelOrbital {
         (render-ui main {
           title: @entity.title
           subtitle: @config.subtitle
+          coverImage: @config.coverImage
+          icon: @config.icon
           value: @entity.value
           actions: @config.actions
           maxInlineActions: @config.maxInlineActions
@@ -65,6 +69,8 @@ orbital DocumentPanelOrbital {
         (render-ui main {
           title: @entity.title
           subtitle: @config.subtitle
+          coverImage: @config.coverImage
+          icon: @config.icon
           value: @entity.value
           actions: @config.actions
           maxInlineActions: @config.maxInlineActions
@@ -125,6 +131,14 @@ orbital DocumentPanelOrbital {
         @label "Subtitle"
         @description "Muted byline under the title; hidden when empty"
         @tier "presentation"
+      coverImage : string
+        @label "Cover Image"
+        @description "Cover/hero image URL painted as a full-bleed banner above the header row (Notion/article-hero shape); hidden when empty"
+        @tier "presentation"
+      icon : icon
+        @label "Icon"
+        @description "Document icon rendered beside the title (a file glyph, a domain icon); hidden when empty"
+        @tier "presentation"
       value : string
         @label "Value"
         @description "The document body as rich-text HTML"

package/behaviors/lolo/ui/core/molecules/ui-file-tree.lolo

@@ -29,8 +29,13 @@ orbital FileTreeOrbital {
           tree: @config.tree
           items: @config.items
           selectedPath: @config.selectedPath
+          selectedId: @config.selectedId
+          look: @config.look
           onFileSelect: @config.onFileSelect
           onNodeSelect: @config.onNodeSelect
+          onNodeAction: @config.onNodeAction
+          nodeActionIcon: @config.nodeActionIcon
+          nodeActionLabel: @config.nodeActionLabel
           className: @config.className
           indent: @config.indent
           type: file-tree
@@ -58,6 +63,14 @@ orbital FileTreeOrbital {
         @label "Selected Path"
         @description "Currently selected file path"
         @tier "presentation"
+      selectedId : string
+        @label "Selected Id"
+        @description "Currently selected node id, in flat `items` mode: the row highlights and every ancestor auto-expands so the selection is always visible — the 'you are here' a navigation tree needs."
+        @tier "presentation"
+      look : "files" | "nav" = files
+        @label "Look"
+        @description "Visual treatment for flat `items` mode: `files` (default) keeps the monospace file-browser look; `nav` renders a sidebar navigation tree — regular font, document icons, roomier hit areas."
+        @tier "presentation"
       onFileSelect : string = "FILE_SELECT"
         @label "On File Select"
         @description "Called when a file is clicked"
@@ -66,6 +79,18 @@ orbital FileTreeOrbital {
         @label "On Node Select"
         @description "Called when a node is clicked, in flat `items` mode; carries the selected node's id. Presence-gated: binding this prop is what turns on the click-to-select affordance, mirroring Badge's `onRemove`."
         @tier "presentation"
+      onNodeAction : string = ""
+        @label "On Node Action"
+        @description "Called from the row's hover action button, in flat `items` mode; carries that node's id. Presence-gated: binding it renders the action."
+        @tier "presentation"
+      nodeActionIcon : string
+        @label "Node Action Icon"
+        @description "Icon for the row hover action (default: plus)."
+        @tier "presentation"
+      nodeActionLabel : string
+        @label "Node Action Label"
+        @description "Accessible label/tooltip for the row hover action."
+        @tier "presentation"
       className : string
         @label "Class Name"
         @description "CSS class"

package/behaviors/lolo/ui/core/molecules/ui-positioned-canvas.lolo

@@ -19,7 +19,7 @@ orbital PositionedCanvasOrbital {
     initial: idle
 
     state idle {
-      INIT -> idle
+      INIT -> idle when @config.selfFetch
         (fetch PositionedCanvasItem { emit: { success: PositionedCanvasLoaded } })
         (render-ui main {
           items: @entity
@@ -34,6 +34,20 @@ orbital PositionedCanvasOrbital {
           className: @config.className
           type: positioned-canvas
         })
+      INIT -> idle when (not @config.selfFetch)
+        (render-ui main {
+          items: @entity
+          width: @config.width
+          height: @config.height
+          selectedId: @config.selectedId
+          editable: @config.editable
+          onSelect: @config.onSelect
+          onMove: @config.onMove
+          selectEvent: @config.selectEvent
+          moveEvent: @config.moveEvent
+          className: @config.className
+          type: positioned-canvas
+        })
       PositionedCanvasLoaded -> idle
         (render-ui main {
           items: @payload.data
@@ -106,6 +120,10 @@ orbital PositionedCanvasOrbital {
         @label "Class Name"
         @description "className prop"
         @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"
     }
   }
 

package/behaviors/lolo/ui/core/molecules/ui-reply-tree.lolo

@@ -19,7 +19,7 @@ orbital ReplyTreeOrbital {
     initial: idle
 
     state idle {
-      INIT -> idle
+      INIT -> idle when @config.selfFetch
         (fetch ReplyTreeItem { emit: { success: ReplyTreeLoaded } })
         (render-ui main {
           nodes: @entity
@@ -36,6 +36,22 @@ orbital ReplyTreeOrbital {
           className: @config.className
           type: reply-tree
         })
+      INIT -> idle when (not @config.selfFetch)
+        (render-ui main {
+          nodes: @entity
+          maxDepth: @config.maxDepth
+          onVote: @config.onVote
+          onReply: @config.onReply
+          onFlag: @config.onFlag
+          onContinueThread: @config.onContinueThread
+          voteEvent: @config.voteEvent
+          replyEvent: @config.replyEvent
+          flagEvent: @config.flagEvent
+          continueThreadEvent: @config.continueThreadEvent
+          showActions: @config.showActions
+          className: @config.className
+          type: reply-tree
+        })
       ReplyTreeLoaded -> idle
         (render-ui main {
           nodes: @payload.data
@@ -128,6 +144,10 @@ orbital ReplyTreeOrbital {
         @label "Class Name"
         @description "className prop"
         @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"
     }
   }