@almadar/std 16.191.0 → 16.192.0

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

@@ -7,6 +7,8 @@ orbital TagTaxonomyOrbital {
 
     type TagSelected = Event { tagId : string! } "Fired when a tag is selected to drill into its children"
 
+    type TagCommit = { name : string!, parentId : string }
+
   entity Tag [persistent: tags] {
     id : string!
     name : string! @description "The descriptive label for this item." @synonyms "label, title, description"
@@ -21,6 +23,11 @@ orbital TagTaxonomyOrbital {
     initial: loading
 
     state loading {
+      LEVEL_RELOAD -> loading
+        (fetch Tag {
+          filter: ["=", (object/get @entity parentId), (str/default ?tagId "")]
+          emit: { failure: TagLoadFailed, success: TagLoaded }
+        })
       INIT -> loading
         (set @entity.id "")
         (set @entity.parentId "")
@@ -55,7 +62,14 @@ orbital TagTaxonomyOrbital {
             content: @config.title
             type: typography
             variant: h3
-          }, {
+          }, (if @config.allowEdit {
+            action: NEW_TAG
+            icon: plus
+            label: "New category"
+            size: sm
+            type: button
+            variant: secondary
+          } null), {
             entity: ?data
             fields: []
             gap: sm
@@ -200,7 +214,14 @@ orbital TagTaxonomyOrbital {
             content: @config.title
             type: typography
             variant: h3
-          }, {
+          }, (if @config.allowEdit {
+            action: NEW_TAG
+            icon: plus
+            label: "New category"
+            size: sm
+            type: button
+            variant: secondary
+          } null), {
             entity: ?data
             fields: []
             gap: sm
@@ -261,6 +282,29 @@ orbital TagTaxonomyOrbital {
           gap: md
           type: stack
         })
+      NEW_TAG -> creating when @config.allowEdit
+        (render-ui modal {
+          children: [{
+            content: "New category"
+            type: typography
+            variant: h3
+          }, {
+            color: muted
+            content: (if (!= @entity.id "") "Created inside the open category." "Created at the top level.")
+            type: typography
+            variant: caption
+          }, { type: divider }, {
+            cancelEvent: CANCEL_TAG
+            entity: { parentId: @entity.id }
+            fields: (name)
+            mode: create
+            submitEvent: COMMIT_TAG
+            type: form-section
+          }]
+          direction: vertical
+          gap: md
+          type: stack
+        })
       TagLoadFailed -> error
         (render-ui main {
           message: ?error
@@ -269,6 +313,61 @@ orbital TagTaxonomyOrbital {
         })
     }
 
+    state creating {
+      COMMIT_TAG -> creating
+        (persist create Tag {
+          name: (object/get ?data name)
+          parentId: (str/default (object/get ?data parentId) "")
+        } {
+          emit: { failure: TagCreateFailed, success: TagCreated }
+        })
+      ;; A filter expression binds @entity to the candidate ROW, so the open
+      ;; level must travel by payload: the arm emits LEVEL_RELOAD carrying the
+      ;; trait's own level id, and loading refetches from it.
+      CANCEL_TAG -> loading
+        (render-ui modal null)
+        (render-ui main {
+          align: center
+          children: [{ type: spinner }, {
+            color: muted
+            content: "Loading categories…"
+            type: typography
+            variant: caption
+          }]
+          className: py-12
+          direction: vertical
+          gap: md
+          type: stack
+        })
+        (emit LEVEL_RELOAD { tagId: @entity.id })
+      ;; Refetch the level the new tag landed on — its own parentId names it.
+      TagCreated -> loading
+        (render-ui modal null)
+        (render-ui main {
+          align: center
+          children: [{ type: spinner }, {
+            color: muted
+            content: "Loading categories…"
+            type: typography
+            variant: caption
+          }]
+          className: py-12
+          direction: vertical
+          gap: md
+          type: stack
+        })
+        (fetch Tag {
+          filter: ["=", (object/get @entity parentId), (str/default (object/get ?row parentId) "")]
+          emit: { failure: TagLoadFailed, success: TagLoaded }
+        })
+      TagCreateFailed -> creating
+        (render-ui modal {
+          message: ?error
+          type: alert
+          variant: error
+        })
+    }
+
     state editing {
       INIT -> loading
         (set @entity.id "")
@@ -311,7 +410,14 @@ orbital TagTaxonomyOrbital {
             content: @config.title
             type: typography
             variant: h3
-          }, {
+          }, (if @config.allowEdit {
+            action: NEW_TAG
+            icon: plus
+            label: "New category"
+            size: sm
+            type: button
+            variant: secondary
+          } null), {
             entity: ?data
             fields: []
             gap: sm
@@ -429,6 +535,39 @@ orbital TagTaxonomyOrbital {
         @description "Signals a tag has been chosen for further exploration."
         @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."
+        @synonyms "add tag, create category, new category"
+        @tier "domain"
+      COMMIT_TAG {
+        data : TagCommit
+      }
+        @description "The new-category form committed; data carries the name and the parent level."
+        @synonyms "save tag, create tag"
+        @tier "internal"
+      CANCEL_TAG
+        @description "The new-category form was dismissed without creating."
+        @synonyms "cancel, back"
+        @tier "internal"
+      LEVEL_RELOAD {
+        tagId : string
+      }
+        @description "Internal hop that refetches the open level after the new-category form closes (a fetch filter cannot read trait state, so the level travels by payload)."
+        @synonyms "reload level, refresh"
+        @tier "internal"
+      TagCreated {
+        row : Tag
+      }
+        @description "A new tag row persisted; the open level refetches to show it."
+        @synonyms "created, added"
+        @tier "internal"
+      TagCreateFailed {
+        error : string
+        code : string
+      }
+        @description "The tag create failed."
+        @synonyms "error, failure"
+        @tier "internal"
     }
 
     listens {
@@ -457,6 +596,39 @@ orbital TagTaxonomyOrbital {
         @description "A tag in the taxonomy has been chosen by the user."
         @synonyms "chosen, picked, activated, selected"
         @tier "domain"
+      NEW_TAG
+        @description "The New-category affordance was clicked."
+        @synonyms "add tag, create category"
+        @tier "domain"
+      COMMIT_TAG {
+        data : TagCommit
+      }
+        @description "The new-category form committed."
+        @synonyms "save tag, create tag"
+        @tier "internal"
+      CANCEL_TAG
+        @description "The new-category form was dismissed."
+        @synonyms "cancel, back"
+        @tier "internal"
+      LEVEL_RELOAD {
+        tagId : string
+      }
+        @description "Refetch the open level."
+        @synonyms "reload level, refresh"
+        @tier "internal"
+      TagCreated {
+        row : Tag
+      }
+        @description "A new tag row persisted."
+        @synonyms "created, added"
+        @tier "internal"
+      TagCreateFailed {
+        error : string
+        code : string
+      }
+        @description "The tag create failed."
+        @synonyms "error, failure"
+        @tier "internal"
     }
 
     config {
@@ -466,7 +638,7 @@ orbital TagTaxonomyOrbital {
         @tier "presentation"
       allowEdit : boolean = false
         @label "Allow editing"
-        @description "Show inline controls to create or rename tags"
+        @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)."
         @tier "domain"
       tableLook : "dense" | "spacious" | "striped" | "borderless" | "card-rows" = dense
         @label "Table look"

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-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"
     }
   }
 

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

@@ -12,7 +12,7 @@ orbital SortableListOrbital {
     initial: idle
 
     state idle {
-      INIT -> idle
+      INIT -> idle when @config.selfFetch
         (fetch SortableListItem { emit: { success: SortableListLoaded } })
         (render-ui main {
           items: @entity
@@ -23,6 +23,16 @@ orbital SortableListOrbital {
           className: @config.className
           type: sortable-list
         })
+      INIT -> idle when (not @config.selfFetch)
+        (render-ui main {
+          items: @entity
+          renderItem: (fn item { content: (object/get @item @config.itemLabelField ""), type: typography })
+          reorderEvent: @config.reorderEvent
+          reorderPayload: @config.reorderPayload
+          dragHandlePosition: @config.dragHandlePosition
+          className: @config.className
+          type: sortable-list
+        })
       SortableListLoaded -> idle
         (render-ui main {
           items: @payload.data
@@ -68,6 +78,10 @@ orbital SortableListOrbital {
         @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"
     }
   }