@almadar/std 16.183.0 → 16.185.0

package/behaviors/lolo/ui/core/.hand-authored.json

@@ -151,6 +151,10 @@
     "signature": "a923f3042436663f",
     "board": "packages/almadar-std/behaviors/lolo/ui/core/atoms/std-thread.lolo"
   },
+  "std-tree": {
+    "signature": "",
+    "board": "packages/almadar-std/behaviors/lolo/ui/core/atoms/std-tree.lolo"
+  },
   "std-version-history": {
     "signature": "1f1eb4fcabd6cead",
     "board": "packages/almadar-std/behaviors/lolo/ui/core/atoms/std-version-history.lolo"

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

@@ -84,6 +84,7 @@ orbital BrowseItemOrbital {
         (fetch BrowseItem {
           emit: { failure: BrowseItemLoadFailed, success: BrowseItemLoaded }
           filter: (and (or ["=", @config.scopeField, ""] ["=", (object/get @entity @config.scopeField), @user.id]) (or ["=", @config.initialFilterField, ""] ["=", (object/get @entity @config.initialFilterField), @config.initialFilterValue]))
+          include: @config.include
           limit: @config.pageSize
           offset: 0
         })
@@ -113,6 +114,7 @@ orbital BrowseItemOrbital {
         (fetch BrowseItem {
           emit: { failure: BrowseItemLoadFailed, success: BrowseItemLoaded }
           filter: (and (or ["=", @config.scopeField, ""] ["=", (object/get @entity @config.scopeField), @user.id]) (or ["=", @config.initialFilterField, ""] ["=", (object/get @entity @config.initialFilterField), @config.initialFilterValue]))
+          include: @config.include
           limit: @config.pageSize
           offset: 0
         })
@@ -126,6 +128,7 @@ orbital BrowseItemOrbital {
         (fetch BrowseItem {
           emit: { failure: BrowseItemLoadFailed, success: BrowseItemLoaded }
           filter: (and (or ["=", @config.scopeField, ""] ["=", (object/get @entity @config.scopeField), @user.id]) (or ["=", ?searchTerm, ""] (str/includes (object/get @entity name) ?searchTerm)))
+          include: @config.include
           limit: @config.pageSize
           offset: 0
         })
@@ -133,6 +136,7 @@ orbital BrowseItemOrbital {
         (fetch BrowseItem {
           emit: { failure: BrowseItemLoadFailed, success: BrowseItemLoaded }
           filter: (and (or ["=", @config.scopeField, ""] ["=", (object/get @entity @config.scopeField), @user.id]) (or ["=", ?value, ""] ["=", (object/get @entity ?field), ?value]))
+          include: @config.include
           limit: @config.pageSize
           offset: 0
         })
@@ -140,6 +144,7 @@ orbital BrowseItemOrbital {
         (fetch BrowseItem {
           emit: { failure: BrowseItemLoadFailed, success: BrowseItemLoaded }
           filter: (or ["=", @config.scopeField, ""] ["=", (object/get @entity @config.scopeField), @user.id])
+          include: @config.include
           limit: @config.pageSize
           offset: ["*", ["-", ?page, 1], @config.pageSize]
         })
@@ -170,6 +175,7 @@ orbital BrowseItemOrbital {
         (fetch BrowseItem {
           emit: { failure: BrowseItemLoadFailed, success: BrowseItemLoaded }
           filter: (and (or ["=", @config.scopeField, ""] ["=", (object/get @entity @config.scopeField), @user.id]) (or ["=", @config.initialFilterField, ""] ["=", (object/get @entity @config.initialFilterField), @config.initialFilterValue]))
+          include: @config.include
           limit: @config.pageSize
           offset: 0
         })
@@ -346,6 +352,11 @@ orbital BrowseItemOrbital {
         @description "Rows visible per page before the pagination control appears."
         @synonyms "visible rows, items per page, display limit, show per page"
         @tier "presentation"
+      include : [string] = []
+        @label "Which relation fields to hydrate?"
+        @description "Entity relation field names to hydrate on fetch (e.g. a `tag : Category` field named `tag`), so grid columns can use dot-paths like tag.name. Empty = no hydration, the default."
+        @synonyms "relation hydration, populate relations, joined fields, hydrate relations"
+        @tier "internal"
       filters : [FilterSpec] = []
         @label "Which filters should appear above the list?"
         @description "Dropdown filter facets by field. Each fires a refetch when the user changes the selection. Empty = no filter bar."

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

@@ -1,18 +1,24 @@
-app std-related "1.0.0"
+app std-related "1.1.0"
 "std-related as a Function"
 ;;
-;; Relation-rendering atom. Assumes the linked entity's relation field has
-;; already been hydrated by an upstream fetch with include; this atom only
-;; owns the rendering of the related children.
+;; Relation-rendering atom. INIT loads the full RelatedItem collection
+;; unfiltered (unchanged default). A consumer that wants the list scoped to
+;; one parent document sets `relationField` (the RelatedItem column that
+;; holds the parent key) and redirects its own "document opened" signal to
+;; SHOW_RELATED { key } in a `listens` override — the atom then fetches only
+;; rows whose relationField equals key. Each row is clickable: it emits
+;; SELECT_RELATED { id, name } for a parent molecule (e.g.
+;; std-related-master-detail) to drive a detail panel.
 ;;
 ;; Paired with std-browse via @trait.X this gives a one-line master-detail
-;; layout: hstack [ @trait.ParentList, @trait.ParentRelated ]. The molecule
-;; std-related-master-detail is the canonical showcase.
+;; layout: hstack [ @trait.ParentList, @trait.ParentRelated ].
 orbital RelatedItemOrbital {
     type RelatedItemLoaded = Event { data : [RelatedItem] } "Fired when RelatedItem finishes loading; payload.data holds the list"
 
     type RelatedItemLoadFailed = Event { error : string, code : string } "Fired when RelatedItem fails to load"
 
+    type ShowRelated = Event { key : string! } "Fired to scope the related fetch to rows whose relationField equals key"
+
   entity RelatedItem [persistent: relateditems] {
     id : string!
     name : string @description "The identifier or designation for the related item." @synonyms "title, label, identifier"
@@ -39,12 +45,30 @@ orbital RelatedItemOrbital {
           gap: sm
           type: stack
         })
+      SHOW_RELATED -> loading
+        (fetch RelatedItem {
+          emit: { failure: RelatedItemLoadFailed, success: RelatedItemLoaded }
+          filter: (or ["=", @config.relationField, ""] ["=", (object/get @entity @config.relationField), ?key])
+        })
+        (render-ui main {
+          align: center
+          children: [{ type: spinner }, {
+            color: muted
+            content: "Loading related…"
+            type: typography
+            variant: caption
+          }]
+          className: py-8
+          direction: vertical
+          gap: sm
+          type: stack
+        })
       RelatedItemLoaded -> loaded
         (render-ui main {
           children: [{
             align: center
             children: [{ name: link, type: icon }, {
-              content: Related
+              content: @config.title
               type: typography
               variant: h3
             }]
@@ -56,13 +80,23 @@ orbital RelatedItemOrbital {
             fields: []
             look: @config.tableLook
             renderItem: (fn item {
+              align: center
               children: [{
                 content: @item.name
                 type: typography
                 variant: body
+              }, {
+                action: SELECT_RELATED
+                actionPayload: { id: @item.id, name: @item.name }
+                icon: chevron-right
+                label: Open
+                size: sm
+                type: button
+                variant: ghost
               }]
-              direction: vertical
+              direction: horizontal
               gap: xs
+              justify: between
               type: stack
             })
             type: data-list
@@ -107,6 +141,14 @@ orbital RelatedItemOrbital {
           emit: { failure: RelatedItemLoadFailed, success: RelatedItemLoaded }
         })
         (render-ui main { type: spinner })
+      SELECT_RELATED -> loaded
+        (set @entity.id ?id)
+      SHOW_RELATED -> loading
+        (fetch RelatedItem {
+          emit: { failure: RelatedItemLoadFailed, success: RelatedItemLoaded }
+          filter: (or ["=", @config.relationField, ""] ["=", (object/get @entity @config.relationField), ?key])
+        })
+        (render-ui main { type: spinner })
     }
 
     state error {
@@ -122,6 +164,12 @@ orbital RelatedItemOrbital {
           emit: { failure: RelatedItemLoadFailed, success: RelatedItemLoaded }
         })
         (render-ui main { type: spinner })
+      SHOW_RELATED -> loading
+        (fetch RelatedItem {
+          emit: { failure: RelatedItemLoadFailed, success: RelatedItemLoaded }
+          filter: (or ["=", @config.relationField, ""] ["=", (object/get @entity @config.relationField), ?key])
+        })
+        (render-ui main { type: spinner })
     }
 
     emits {
@@ -133,9 +181,23 @@ orbital RelatedItemOrbital {
         @description "Indicates failure to load related items."
         @synonyms "error, failure, problem, unsuccessful"
         @tier "internal"
+      SELECT_RELATED -> external {
+        id : string!
+        name : string
+      }
+        @description "Signals a related item was selected to drive a detail view."
+        @synonyms "select, choose, open, view"
+        @tier "domain"
     }
 
     listens {
+      SELECT_RELATED {
+        id : string!
+        name : string
+      }
+        @description "A related item was selected; the atom records it as the active row."
+        @synonyms "select, choose, open, view"
+        @tier "domain"
       RelatedItemLoadFailed {
         error : string
         code : string
@@ -143,9 +205,23 @@ orbital RelatedItemOrbital {
         @description "Indicates failure to load related items."
         @synonyms "error, failure, problem, unsuccessful"
         @tier "internal"
+      SHOW_RELATED {
+        key : string!
+      }
+        @description "Scopes the related fetch to rows whose relationField equals key."
+        @synonyms "scope, filter, focus, target"
+        @tier "domain"
     }
 
     config {
+      title : string = Related
+        @label "Section title"
+        @description "Heading shown above the related list."
+        @tier "presentation"
+      relationField : string = ""
+        @label "Relation field"
+        @description "RelatedItem field compared against SHOW_RELATED's key to scope the fetch to one parent document; empty renders the full unfiltered collection (default)."
+        @tier "domain"
       tableLook : "dense" | "spacious" | "striped" | "borderless" | "card-rows" = dense
         @label "Table look"
         @description "Layer 2 visual treatment for the data table rendered by this atom."
@@ -153,6 +229,7 @@ orbital RelatedItemOrbital {
     }
   }
 
-  ;; consumer: parent molecule (e.g. std-related-master-detail) listens for SELECT_RELATED to drive a detail panel
+  ;; consumer: parent molecule (e.g. std-related-master-detail) listens for SELECT_RELATED to drive a detail panel; a
+  ;; per-document scope forwards its "opened" event to SHOW_RELATED { key } via a listens override on relationField
   page "/related" as Related -> RelatedItemList
 }

package/behaviors/lolo/ui/core/atoms/std-rich-editor.lolo

@@ -1,5 +1,5 @@
 app std-rich-editor "1.0.0"
-"std-rich-editor — wiki/CMS Notion-style block editor. Browses documents in `browsing`; opens the rich-block-editor on a selected row; persists block edits + publish status."
+"std-rich-editor — wiki/CMS Notion-style block editor. Browses documents in `browsing`; opens the rich-block-editor on a selected row; persists block edits + publish status. `BlockEdit` is a rebindable single-row IN-PLACE body editor: an organism embeds it where the content belongs, rebinds it to its own entity (WikiPage, Note, …), hands it the row's id + blocksJson via OPEN, and routes the emitted BLOCKS_SAVED into its own persistor — this atom never fetches or persists. The read-only body is itself the edit affordance; an empty row paints an empty state that starts the first block; and OPEN_DRAFT opens straight into the authoring editor for a row that was just minted blank (document-first creation)."
 ;; @capabilities "notes app, note-taking, journal, personal journal entries, document editor, write and organize notes"
 type BlockSpec = { type : string!, content : string, id : string }
 type ObjectSpec = { id : string, label : string, value : string }
@@ -419,5 +419,372 @@ orbital DocumentOrbital {
     }
   }
 
+  ;; In-place body editor for one row. The composing organism embeds this
+  ;; trait where the content belongs (`<trait.X />` inside its detail
+  ;; render) and feeds it the loaded row through OPEN; the body paints
+  ;; read-only AND is its own edit affordance — clicking it enters editing
+  ;; with the authoring toolbar, and a row with no blocks yet paints an
+  ;; empty state whose button starts the first one. OPEN_DRAFT is the
+  ;; document-first entry: same payload, but it lands in the editor. SAVE
+  ;; emits BLOCKS_SAVED for the host's persistor; this atom never fetches or
+  ;; persists.
+  trait BlockEdit -> @rebindable Document [interaction, instance] {
+    initial: idle
+
+    state idle {
+      INIT -> idle
+      OPEN -> viewing when [">", (array/len ?blocksJson), 0]
+        (set @entity.id ?id)
+        (set @entity.blocksJson ?blocksJson)
+        (render-ui main {
+          children: [{
+            children: [{
+              action: EDIT_BLOCKS
+              icon: edit
+              label: @config.editLabel
+              type: button
+              variant: secondary
+            }]
+            direction: horizontal
+            gap: sm
+            justify: end
+            type: stack
+          }, {
+            action: EDIT_BLOCKS
+            children: [{
+              initialBlocks: @entity.blocksJson
+              readOnly: true
+              type: rich-block-editor
+            }]
+            className: "cursor-text rounded-md transition-colors hover:bg-muted/40"
+            type: box
+          }]
+          direction: vertical
+          gap: sm
+          type: stack
+        })
+      OPEN -> viewing when ["=", (array/len ?blocksJson), 0]
+        (set @entity.id ?id)
+        (set @entity.blocksJson ?blocksJson)
+        (render-ui main {
+          actionEvent: EDIT_BLOCKS
+          actionLabel: @config.emptyActionLabel
+          description: @config.emptyDescription
+          icon: file-text
+          title: @config.emptyTitle
+          type: empty-state
+        })
+      ;; Document-first entry: the row was just minted as a blank draft, so
+      ;; the body opens ALREADY authoring instead of painting an empty state
+      ;; the author has to click through. A distinct trigger, not a flag on
+      ;; OPEN — the guard surface stays decidable.
+      OPEN_DRAFT -> editing
+        (set @entity.id ?id)
+        (set @entity.blocksJson ?blocksJson)
+        (render-ui main {
+          children: [{
+            align: center
+            children: [{ name: file-text, type: icon }, {
+              content: @config.title
+              type: typography
+              variant: h4
+            }]
+            direction: horizontal
+            gap: sm
+            type: stack
+          }, {
+            changeEvent: BLOCKS_CHANGE
+            initialBlocks: @entity.blocksJson
+            placeholder: @config.placeholder
+            showToolbar: true
+            type: rich-block-editor
+          }, {
+            children: [{
+              action: SAVE_BLOCKS
+              label: Save
+              type: button
+              variant: primary
+            }, {
+              action: CLOSE
+              label: Cancel
+              type: button
+              variant: ghost
+            }]
+            direction: horizontal
+            gap: sm
+            justify: end
+            type: stack
+          }]
+          direction: vertical
+          gap: md
+          type: stack
+        })
+      ;; self-loop on the external emit so the validator sees an in-atom
+      ;; listener — the real consumer is the composing organism's persistor.
+      BLOCKS_SAVED -> idle
+    }
+
+    state viewing {
+      OPEN_DRAFT -> editing
+        (set @entity.id ?id)
+        (set @entity.blocksJson ?blocksJson)
+        (render-ui main {
+          children: [{
+            align: center
+            children: [{ name: file-text, type: icon }, {
+              content: @config.title
+              type: typography
+              variant: h4
+            }]
+            direction: horizontal
+            gap: sm
+            type: stack
+          }, {
+            changeEvent: BLOCKS_CHANGE
+            initialBlocks: @entity.blocksJson
+            placeholder: @config.placeholder
+            showToolbar: true
+            type: rich-block-editor
+          }, {
+            children: [{
+              action: SAVE_BLOCKS
+              label: Save
+              type: button
+              variant: primary
+            }, {
+              action: CLOSE
+              label: Cancel
+              type: button
+              variant: ghost
+            }]
+            direction: horizontal
+            gap: sm
+            justify: end
+            type: stack
+          }]
+          direction: vertical
+          gap: md
+          type: stack
+        })
+      OPEN -> viewing when [">", (array/len ?blocksJson), 0]
+        (set @entity.id ?id)
+        (set @entity.blocksJson ?blocksJson)
+        (render-ui main {
+          children: [{
+            children: [{
+              action: EDIT_BLOCKS
+              icon: edit
+              label: @config.editLabel
+              type: button
+              variant: secondary
+            }]
+            direction: horizontal
+            gap: sm
+            justify: end
+            type: stack
+          }, {
+            action: EDIT_BLOCKS
+            children: [{
+              initialBlocks: @entity.blocksJson
+              readOnly: true
+              type: rich-block-editor
+            }]
+            className: "cursor-text rounded-md transition-colors hover:bg-muted/40"
+            type: box
+          }]
+          direction: vertical
+          gap: sm
+          type: stack
+        })
+      OPEN -> viewing when ["=", (array/len ?blocksJson), 0]
+        (set @entity.id ?id)
+        (set @entity.blocksJson ?blocksJson)
+        (render-ui main {
+          actionEvent: EDIT_BLOCKS
+          actionLabel: @config.emptyActionLabel
+          description: @config.emptyDescription
+          icon: file-text
+          title: @config.emptyTitle
+          type: empty-state
+        })
+      EDIT_BLOCKS -> editing
+        (render-ui main {
+          children: [{
+            align: center
+            children: [{ name: file-text, type: icon }, {
+              content: @config.title
+              type: typography
+              variant: h4
+            }]
+            direction: horizontal
+            gap: sm
+            type: stack
+          }, {
+            changeEvent: BLOCKS_CHANGE
+            initialBlocks: @entity.blocksJson
+            placeholder: @config.placeholder
+            showToolbar: true
+            type: rich-block-editor
+          }, {
+            children: [{
+              action: SAVE_BLOCKS
+              label: Save
+              type: button
+              variant: primary
+            }, {
+              action: CLOSE
+              label: Cancel
+              type: button
+              variant: ghost
+            }]
+            direction: horizontal
+            gap: sm
+            justify: end
+            type: stack
+          }]
+          direction: vertical
+          gap: md
+          type: stack
+        })
+    }
+
+    state editing {
+      BLOCKS_CHANGE -> editing
+        (set @entity.blocksJson ?blocks)
+      SAVE_BLOCKS -> viewing
+        (emit BLOCKS_SAVED { id: @entity.id, blocksJson: @entity.blocksJson })
+        (render-ui main {
+          children: [{
+            children: [{
+              action: EDIT_BLOCKS
+              icon: edit
+              label: @config.editLabel
+              type: button
+              variant: secondary
+            }]
+            direction: horizontal
+            gap: sm
+            justify: end
+            type: stack
+          }, {
+            action: EDIT_BLOCKS
+            children: [{
+              initialBlocks: @entity.blocksJson
+              readOnly: true
+              type: rich-block-editor
+            }]
+            className: "cursor-text rounded-md transition-colors hover:bg-muted/40"
+            type: box
+          }]
+          direction: vertical
+          gap: sm
+          type: stack
+        })
+      CLOSE -> viewing
+        (render-ui main {
+          children: [{
+            children: [{
+              action: EDIT_BLOCKS
+              icon: edit
+              label: @config.editLabel
+              type: button
+              variant: secondary
+            }]
+            direction: horizontal
+            gap: sm
+            justify: end
+            type: stack
+          }, {
+            action: EDIT_BLOCKS
+            children: [{
+              initialBlocks: @entity.blocksJson
+              readOnly: true
+              type: rich-block-editor
+            }]
+            className: "cursor-text rounded-md transition-colors hover:bg-muted/40"
+            type: box
+          }]
+          direction: vertical
+          gap: sm
+          type: stack
+        })
+    }
+
+    emits {
+      BLOCKS_SAVED -> external {
+        id : string!
+        blocksJson : [BlockSpec]
+      }
+        @description "Signals a row's block content is ready to persist. This atom never persists — the composing organism routes BLOCKS_SAVED into its own persistor's update event."
+        @synonyms "saved, persist, update, commit"
+        @tier "domain"
+      CLOSE
+        @description "Leaves the editor without saving; the body returns to its read-only render."
+        @synonyms "dismiss, hide, cancel, close"
+        @tier "domain"
+      BLOCKS_CHANGE {
+        blocks : [BlockSpec]
+      }
+        @description "Signals that the content of a block has been modified while editing."
+        @synonyms "update, modify, changed, edit"
+        @tier "domain"
+    }
+
+    listens {
+      OPEN {
+        id : string!
+        blocksJson : [BlockSpec]
+      }
+        @description "Hands the editor the row whose body it renders — the caller supplies the row's id and current blocks, since this trait never fetches them itself. Re-firing it repaints the body (e.g. after the host refetches a saved row)."
+        @synonyms "show, launch, reveal, edit"
+        @tier "domain"
+      OPEN_DRAFT {
+        id : string!
+        blocksJson : [BlockSpec]
+      }
+        @description "Hands the editor a row that was just created as a blank draft: same payload as OPEN, but the body opens straight in the authoring editor instead of the read-only render, so a document-first 'New page' lands the author on a cursor rather than an empty state."
+        @synonyms "new document, start writing, blank draft, compose"
+        @tier "domain"
+      BLOCKS_CHANGE {
+        blocks : [BlockSpec]
+      }
+        @description "Indicates changes to the content of editable blocks while editing."
+        @synonyms "update, modify, edit"
+        @tier "domain"
+      CLOSE
+        @description "Leaves the editor without saving; the body returns to its read-only render."
+        @synonyms "dismiss, hide, cancel, close"
+        @tier "domain"
+    }
+
+    config {
+      title : string = "Edit content"
+        @label "Editor heading"
+        @description "Heading shown above the editor while the body is being edited."
+        @tier "presentation"
+      placeholder : string = "Start writing…"
+        @label "Placeholder text"
+        @description "Placeholder shown in the block editor when it is empty."
+        @tier "presentation"
+      editLabel : string = "Edit content"
+        @label "Edit button label"
+        @description "Label of the button above the read-only body that opens the editor."
+        @tier "presentation"
+      emptyTitle : string = "Nothing written yet"
+        @label "Empty heading"
+        @description "Heading shown in place of the body when the row has no blocks yet."
+        @tier "presentation"
+      emptyDescription : string = "This page has no content yet. Start writing to fill it in."
+        @label "Empty description"
+        @description "Supporting line shown with the empty body state."
+        @tier "presentation"
+      emptyActionLabel : string = "Start writing"
+        @label "Empty action label"
+        @description "Label of the button that opens the editor from the empty body state."
+        @tier "presentation"
+    }
+  }
+
   page "/documents/edit" as DocumentEditPage -> DocumentEdit
+  page "/documents/block-edit" as BlockEditPage -> BlockEdit
 }