@almadar/std 16.231.0 → 16.233.0

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

@@ -241,7 +241,7 @@ orbital BoardOrbital {
       REFETCH_QUERY -> viewing_board
         (fetch BoardView {
           emit: { failure: BoardItemsLoadFailed, success: BoardItemsLoaded }
-          filter: (or ["=", ?searchTerm, ""] (str/includes (object/get @entity title) ?searchTerm))
+          filter: (or ["=", ?searchTerm, ""] (str/includes (object/get @entity @config.searchField) ?searchTerm))
         })
       REFETCH_FILTER -> viewing_board
         (fetch BoardView {
@@ -535,6 +535,11 @@ orbital BoardOrbital {
         @label "Board title"
         @description "Heading shown above the column board"
         @tier "presentation"
+      searchField : string = "title"
+        @label "Which column does the search box match against?"
+        @description "Name the field on this entity the search box's str/includes filter matches against. Declared, never inferred: an entity with no `title` column must set this to a real field (e.g. name, summary) or the search box can never match a card."
+        @synonyms "search column, search on field, match field, search key"
+        @tier "policy"
       columns : [ColumnSpec] = [{
         icon: circle
         key: todo

package/behaviors/lolo/ui/core/atoms/std-event-log.lolo

@@ -241,12 +241,12 @@ orbital EventLogOrbital {
       REFETCH_QUERY -> viewing
         (fetch EventLogView {
           emit: { failure: EventLogLoadFailed, success: EventLogLoaded }
-          filter: (and (or ["=", @entity.filterKind, ""] ["=", (object/get @entity kind), @entity.filterKind]) (or ["=", ?searchTerm, ""] (str/includes (object/get @entity title) ?searchTerm)))
+          filter: (and (or ["=", @entity.filterKind, ""] ["=", (object/get @entity @config.kindField), @entity.filterKind]) (or ["=", ?searchTerm, ""] (str/includes (object/get @entity @config.searchField) ?searchTerm)))
         })
       REFETCH_FILTER -> viewing
         (fetch EventLogView {
           emit: { failure: EventLogLoadFailed, success: EventLogLoaded }
-          filter: (and (or ["=", @entity.filterKind, ""] ["=", (object/get @entity kind), @entity.filterKind]) (or ["=", ?value, ""] ["=", (object/get @entity ?field), ?value]))
+          filter: (and (or ["=", @entity.filterKind, ""] ["=", (object/get @entity @config.kindField), @entity.filterKind]) (or ["=", ?value, ""] ["=", (object/get @entity ?field), ?value]))
         })
       ;; No filter carried over on REFETCH_PAGE, mirroring std-browse exactly —
       ;; the reference page arm does not preserve query/filter either.
@@ -588,6 +588,16 @@ orbital EventLogOrbital {
         @label "Section title"
         @description "Heading shown above the activity timeline"
         @tier "presentation"
+      searchField : string = "title"
+        @label "Which column does the search box match against?"
+        @description "Name the field on this entity the search box's str/includes filter matches against. Declared, never inferred: an entity with no `title` column must set this to a real field or the search box can never match an entry."
+        @synonyms "search column, search on field, match field, search key"
+        @tier "policy"
+      kindField : string = "kind"
+        @label "Which column holds each entry's kind?"
+        @description "Name the field on this entity the kind filter compares against (the values of kindOptions). An entity whose kind lives under another column (e.g. status) sets it here, or the kind filter can never match an entry."
+        @synonyms "kind column, type field, category column, filter by kind"
+        @tier "policy"
       kindOptions : [KindOption] = [{
         icon: plus-circle
         key: created

package/behaviors/lolo/ui/core/atoms/std-form-advanced.lolo

@@ -49,9 +49,12 @@ orbital FormEntryOrbital {
             type: stack
           }, { type: divider }, {
             cancelEvent: CANCEL
+            cancelLabel: @config.cancelLabel
             fields: @config.fields
             mode: create
+            showCancel: @config.showCancel
             submitEvent: SUBMIT
+            submitLabel: @config.submitLabel
             type: form-section
           }]
           direction: vertical
@@ -75,9 +78,12 @@ orbital FormEntryOrbital {
             type: stack
           }, { type: divider }, {
             cancelEvent: CANCEL
+            cancelLabel: @config.cancelLabel
             fields: @config.fields
             mode: create
+            showCancel: @config.showCancel
             submitEvent: SUBMIT
+            submitLabel: @config.submitLabel
             type: form-section
           }]
           direction: vertical
@@ -91,17 +97,17 @@ orbital FormEntryOrbital {
         (render-ui main {
           align: center
           children: [{ name: check-circle, size: xl, type: icon }, {
-            content: "Form Submitted"
+            content: @config.successTitle
             type: typography
             variant: h2
           }, {
-            message: "Your form has been submitted successfully."
+            message: @config.successMessage
             type: alert
             variant: success
           }, {
             action: RESET
             icon: plus
-            label: "New Entry"
+            label: @config.newEntryLabel
             type: button
             variant: primary
           }]
@@ -137,9 +143,12 @@ orbital FormEntryOrbital {
             type: stack
           }, { type: divider }, {
             cancelEvent: CANCEL
+            cancelLabel: @config.cancelLabel
             fields: @config.fields
             mode: create
+            showCancel: @config.showCancel
             submitEvent: SUBMIT
+            submitLabel: @config.submitLabel
             type: form-section
           }]
           direction: vertical
@@ -246,6 +255,30 @@ orbital FormEntryOrbital {
         @label "Field validation"
         @description "Per-field rules (format, regex, length) shown inline on submit"
         @tier "domain"
+      submitLabel : string
+        @label "Submit button"
+        @description "Label on the submit button; unset keeps the translated Save"
+        @tier "presentation"
+      cancelLabel : string
+        @label "Cancel button"
+        @description "Label on the cancel button; unset keeps the translated Cancel"
+        @tier "presentation"
+      showCancel : boolean = true
+        @label "Show cancel"
+        @description "Whether the form shows a cancel button"
+        @tier "presentation"
+      successTitle : string = "Form Submitted"
+        @label "Confirmation title"
+        @description "Heading shown after a successful submit"
+        @tier "presentation"
+      successMessage : string = "Your form has been submitted successfully."
+        @label "Confirmation message"
+        @description "Message shown after a successful submit"
+        @tier "presentation"
+      newEntryLabel : string = "New Entry"
+        @label "New entry button"
+        @description "Label on the button that starts another entry after a submit"
+        @tier "presentation"
     }
   }
 

package/behaviors/lolo/ui/core/atoms/std-version-history.lolo

@@ -1,13 +1,11 @@
 app std-version-history "1.0.0"
-"std-version-history — wiki/CMS revision history with diff + rollback. Browses revisions; opens detail in `viewing_single`; compares two revisions in `comparing` with intrinsic version-diff; persists rollback. `RevisionManage` is a rebindable single-entity trait: a consumer rebinds it to its own entity via `linkedEntity`. `config.scopeField` names the Revision field holding the parent document id; a page-mounted `{id}` route param scopes INIT's own fetch, and a consumer forwards SHOW_HISTORY { key } (via a `listens` override) to rescope the feed to one document — empty scopeField (default) or no id keeps today's unfiltered global feed. Rollback and retry refetches stay scoped."
+"std-version-history — wiki/CMS revision history with diff + rollback. Browses revisions; opens detail in `viewing_single`; compares the opened revision with the newest in `comparing`; Rollback emits RevisionRolledBack { row } for the consumer to restore onto its source document. `RevisionManage` is a rebindable single-entity trait: a consumer rebinds it to its own entity via `linkedEntity`. `config.scopeField` names the Revision field holding the parent document id; a page-mounted `{id}` route param scopes INIT's own fetch, and a consumer forwards SHOW_HISTORY { key } (via a `listens` override) to rescope the feed to one document — empty scopeField (default) or no id keeps today's unfiltered global feed. Rollback and retry refetches stay scoped."
 orbital RevisionOrbital {
     type RevisionLoaded = Event { data : [Revision] } "Fired when the revision collection finishes loading"
 
     type RevisionLoadFailed = Event { error : string, code : string } "Fired when the revision collection fails to load"
 
-    type RevisionRolledBack = Event Revision "Fired after a rollback persists successfully on the source document"
-
-    type RevisionRollbackFailed = Event { error : string, code : string } "Fired when a rollback fails to persist"
+    type RevisionRolledBack = Event { row : Revision! } "The revision to roll back to: the consumer restores row.content onto its source document (listen for it)"
 
   entity Revision [persistent: revisions] {
     id : string!
@@ -16,11 +14,12 @@ orbital RevisionOrbital {
     versionNumber : number! @description "A sequential identifier representing the revision's order." @synonyms "sequence, order, iteration"
     authorId : string @description "Unique identifier for the user who made the change." @synonyms "user identifier, creator, contributor"
     authorName : string @description "The name of the user who made the change." @synonyms "user, contributor, owner"
-    content : string @description "The snapshotted body of the revision — plain text or the rich-text HTML a document-look record carries. Rollback hands the whole row back to the host, which restores content onto the source document." @synonyms "text, body, data, value"
+    content : string @description "The snapshotted body of the revision — plain text or the rich-text HTML a document-look record carries. Rollback emits RevisionRolledBack { row }; the consumer restores row.content onto its source document." @synonyms "text, body, data, value"
     summary : string @description "A brief explanation of the revision's changes." @synonyms "description, note, comment, explanation"
     searchTerm : string @intrinsic @description "The current search query the user submitted." @synonyms "query, term, q" = ""
     createdAt : string
     scopeKey : string @intrinsic @description "The parent document id the feed is currently scoped to, set by SHOW_HISTORY. Empty when browsing the unfiltered global feed." @synonyms "scope, filter key, document scope" = ""
+    revisions : [Revision] @intrinsic @description "The loaded revisions, newest first — what Compare diffs against." @synonyms "versions, history" = []
   }
 
   trait RevisionManage -> @rebindable Revision [interaction, collection] {
@@ -47,6 +46,7 @@ orbital RevisionOrbital {
           type: stack
         })
       RevisionLoaded -> browsing
+        (set @entity.revisions (array/sort ?data "versionNumber" "desc"))
         (render-ui main {
           children: [{
             align: center
@@ -97,18 +97,6 @@ orbital RevisionOrbital {
           gap: md
           type: stack
         })
-      RevisionRolledBack -> loading
-        (set @entity.scopeKey (object/get @payload @config.scopeField ""))
-        (fetch Revision {
-          filter: (or ["=", @config.scopeField, ""] ["=", (object/get @payload @config.scopeField ""), ""] ["=", (object/get @entity @config.scopeField), (object/get @payload @config.scopeField "")])
-          emit: { failure: RevisionLoadFailed, success: RevisionLoaded }
-        })
-      RevisionRollbackFailed -> error
-        (render-ui main {
-          message: ?error
-          type: alert
-          variant: error
-        })
       RevisionLoadFailed -> error
         (render-ui main {
           message: ?error
@@ -267,7 +255,7 @@ orbital RevisionOrbital {
               variant: secondary
             }, {
               action: ROLLBACK
-              actionPayload: { id: @entity.id }
+              actionPayload: { row: @entity }
               label: Rollback
               type: button
               variant: danger
@@ -281,9 +269,11 @@ orbital RevisionOrbital {
           type: stack
         })
       ROLLBACK -> loading
-        (set @entity.id ?id)
-        (persist update Revision @entity {
-          emit: { failure: RevisionRollbackFailed, success: RevisionRolledBack }
+        (emit RevisionRolledBack { row: ?row })
+        (set @entity.scopeKey (object/get ?row @config.scopeField ""))
+        (fetch Revision {
+          filter: (or ["=", @config.scopeField, ""] ["=", (object/get ?row @config.scopeField ""), ""] ["=", (object/get @entity @config.scopeField), (object/get ?row @config.scopeField "")])
+          emit: { failure: RevisionLoadFailed, success: RevisionLoaded }
         })
         (render-ui main {
           align: center
@@ -322,6 +312,7 @@ orbital RevisionOrbital {
     state viewing_single {
       CLOSE_VIEW -> loading
         (fetch Revision {
+          filter: (or ["=", @config.scopeField, ""] ["=", @entity.scopeKey, ""] ["=", (object/get @entity @config.scopeField), @entity.scopeKey])
           emit: { failure: RevisionLoadFailed, success: RevisionLoaded }
         })
         (render-ui main {
@@ -356,17 +347,16 @@ orbital RevisionOrbital {
             gap: sm
             type: stack
           }, { type: divider }, {
-            afterId: ?afterId
-            beforeId: ?beforeId
-            onRevert: ROLLBACK
-            revisions: ?revisions
+            afterId: (object/get (array/first @entity.revisions) "id" "")
+            beforeId: @entity.id
+            revisions: (array/map @entity.revisions (fn r { id: @r.id, label: (str/concat "v" (str/default @r.versionNumber "")), author: @r.authorName, timestamp: @r.createdAt, content: @r.content }))
             type: version-diff
             view: side-by-side
           }, {
             align: center
             children: [{
               action: ROLLBACK
-              actionPayload: { id: @entity.id }
+              actionPayload: { row: @entity }
               label: Rollback
               type: button
               variant: danger
@@ -380,9 +370,11 @@ orbital RevisionOrbital {
           type: stack
         })
       ROLLBACK -> loading
-        (set @entity.id ?id)
-        (persist update Revision @entity {
-          emit: { failure: RevisionRollbackFailed, success: RevisionRolledBack }
+        (emit RevisionRolledBack { row: ?row })
+        (set @entity.scopeKey (object/get ?row @config.scopeField ""))
+        (fetch Revision {
+          filter: (or ["=", @config.scopeField, ""] ["=", (object/get ?row @config.scopeField ""), ""] ["=", (object/get @entity @config.scopeField), (object/get ?row @config.scopeField "")])
+          emit: { failure: RevisionLoadFailed, success: RevisionLoaded }
         })
         (render-ui main {
           align: center
@@ -421,6 +413,7 @@ orbital RevisionOrbital {
     state comparing {
       CLOSE_VIEW -> loading
         (fetch Revision {
+          filter: (or ["=", @config.scopeField, ""] ["=", @entity.scopeKey, ""] ["=", (object/get @entity @config.scopeField), @entity.scopeKey])
           emit: { failure: RevisionLoadFailed, success: RevisionLoaded }
         })
         (render-ui main {
@@ -437,9 +430,11 @@ orbital RevisionOrbital {
           type: stack
         })
       ROLLBACK -> loading
-        (set @entity.id ?id)
-        (persist update Revision @entity {
-          emit: { failure: RevisionRollbackFailed, success: RevisionRolledBack }
+        (emit RevisionRolledBack { row: ?row })
+        (set @entity.scopeKey (object/get ?row @config.scopeField ""))
+        (fetch Revision {
+          filter: (or ["=", @config.scopeField, ""] ["=", (object/get ?row @config.scopeField ""), ""] ["=", (object/get @entity @config.scopeField), (object/get ?row @config.scopeField "")])
+          emit: { failure: RevisionLoadFailed, success: RevisionLoaded }
         })
         (render-ui main {
           align: center
@@ -506,17 +501,14 @@ orbital RevisionOrbital {
         @tier "domain"
       COMPARE {
         id : string!
-        beforeId : string!
-        afterId : string!
-        revisions : [Revision]
       }
-        @description "Signals a request to compare two versions."
+        @description "Signals a request to compare the opened revision with the newest one."
         @synonyms "compare, diff, contrast"
         @tier "presentation"
       ROLLBACK {
-        id : string!
+        row : Revision!
       }
-        @description "Indicates a revision has been successfully reverted."
+        @description "Requests a rollback to this revision."
         @synonyms "reverted, undone, restored"
         @tier "domain"
       RevisionLoaded {
@@ -532,17 +524,12 @@ orbital RevisionOrbital {
         @description "Indicates a failure to load revision data."
         @synonyms "error, fail, problem, unsuccessful"
         @tier "internal"
-      RevisionRolledBack
-        @description "Indicates a revision has been successfully restored to a previous state."
-        @synonyms "restored, reverted, undone"
-        @tier "presentation"
-      RevisionRollbackFailed {
-        error : string
-        code : string
+      RevisionRolledBack -> external {
+        row : Revision!
       }
-        @description "Indicates that a revision rollback operation was unsuccessful."
-        @synonyms "rollback failed, revert error, undo failure"
-        @tier "internal"
+        @description "The revision to roll back to; the consumer restores row.content onto its source document."
+        @synonyms "restored, reverted, undone"
+        @tier "domain"
     }
 
     listens {
@@ -565,17 +552,14 @@ orbital RevisionOrbital {
         @tier "domain"
       COMPARE {
         id : string!
-        beforeId : string!
-        afterId : string!
-        revisions : [Revision]
       }
-        @description "Indicates a request to compare two versions."
+        @description "Indicates a request to compare the opened revision with the newest one."
         @synonyms "diff, compare, contrast"
         @tier "presentation"
       ROLLBACK {
-        id : string!
+        row : Revision!
       }
-        @description "A revision has been successfully reverted to a previous state."
+        @description "A rollback to this revision was requested."
         @synonyms "reverted, undone, restored"
         @tier "domain"
       RevisionLoaded {
@@ -591,17 +575,6 @@ orbital RevisionOrbital {
         @description "Indicates a failure to retrieve revision data."
         @synonyms "error, failure, problem, fetch failed"
         @tier "internal"
-      RevisionRolledBack
-        @description "Indicates a revision has been successfully reverted."
-        @synonyms "reverted, undone, restored"
-        @tier "internal"
-      RevisionRollbackFailed {
-        error : string
-        code : string
-      }
-        @description "Indicates that a revision rollback operation has failed."
-        @synonyms "rollback error, revert failure, undo failed"
-        @tier "internal"
       SHOW_HISTORY {
         key : string!
       }

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

@@ -59,7 +59,7 @@ orbital BoxOrbital {
         @label "Dir"
         @description "Text direction for this subtree: 'ltr', 'rtl' (Arabic/Hebrew content) or 'auto'"
         @tier "presentation"
-      padding : "none" | "xs" | "sm" | "md" | "lg" | "xl" | "2xl" = none
+      padding : "none" | "xs" | "sm" | "md" | "lg" | "xl" | "2xl" = md
         @label "Padding"
         @description "Padding on all sides"
         @tier "presentation"
@@ -87,7 +87,7 @@ orbital BoxOrbital {
         @label "Bg"
         @description "Background color"
         @tier "presentation"
-      border : boolean = false
+      border : boolean = true
         @label "Border"
         @description "Show border"
         @tier "presentation"

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

@@ -96,7 +96,7 @@ orbital ButtonOrbital {
         @label "Action Payload"
         @description "Payload to include with the action event"
         @tier "presentation"
-      label : string
+      label : string = Button
         @label "Label"
         @description "Button label text (alternative to children for schema-driven rendering)"
         @tier "presentation"

package/behaviors/lolo/ui/core/molecules/ui-breadcrumb.lolo

@@ -42,7 +42,7 @@ orbital BreadcrumbOrbital {
     }
 
     config {
-      items : [BreadcrumbItemsItem] = []
+      items : [BreadcrumbItemsItem] = [{ label: "Home", href: "/" } { label: "Page" }]
         @label "Items"
         @description "Breadcrumb items. Omit together with `fromNavStack` to render the orbital-scoped navigation stack instead of an authored trail."
         @tier "presentation"

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

@@ -0,0 +1,57 @@
+app ui-change-list "1.0.0"
+"The plain-language changes in one version (added / modified / removed). — UI factory (1:1 with the @almadar/ui change-list pattern)."
+;; @capabilities "change summary, what changed, version changes, diff summary, release notes list, modification list"
+;; @pattern "change-list"
+orbital ChangeListOrbital {
+  type ChangeListChangesItem = {
+    type : "added" | "modified" | "removed"!
+    title : string!
+    description : string
+    before : string
+    after : string
+  }
+
+  entity ChangeListItem [runtime] {
+    id : string!
+  }
+
+  trait ChangeListRender -> @rebindable ChangeListItem [interaction, instance] {
+    initial: idle
+
+    state idle {
+      INIT -> idle
+        (render-ui main {
+          changes: @config.changes
+          inspectEvent: @config.inspectEvent
+          className: @config.className
+          type: change-list
+        })
+    }
+
+    emits {
+      @config.inspectEvent -> external {
+        title : string!
+        type : "added" | "modified" | "removed"!
+      }
+        @description "Emitted by a change's Inspect button. Payload: { title, type }."
+        @tier "essential"
+    }
+
+    config {
+      changes : [ChangeListChangesItem] = [{ type: added, title: "Title", description: "Description", before: "Before", after: "After" }, { type: modified, title: "Title 2", description: "Description 2", before: "Before 2", after: "After 2" }]
+        @label "Changes"
+        @description "The changes. Accepts a typed list or a render-ui payload binding."
+        @tier "presentation"
+      inspectEvent : event = "INSPECT"
+        @label "Inspect Event"
+        @description "Emitted by a change's Inspect button. Payload: { title, type }."
+        @tier "presentation"
+      className : string
+        @label "Class Name"
+        @description "className prop"
+        @tier "presentation"
+    }
+  }
+
+  page "/change-list" as ChangeListPage -> ChangeListRender
+}

package/behaviors/lolo/ui/core/molecules/ui-commit-row.lolo

@@ -0,0 +1,143 @@
+app ui-commit-row "1.0.0"
+"One version in a history list — a commit row with select and restore. — UI factory (1:1 with the @almadar/ui commit-row pattern)."
+;; @capabilities "version history row, commit entry, revision list item, change log entry, restore point, undo history item"
+;; @pattern "commit-row"
+orbital CommitRowOrbital {
+  entity CommitRowItem [runtime] {
+    id : string!
+    sha : string @intrinsic = ""
+  }
+
+  trait CommitRowRender -> @rebindable CommitRowItem [interaction, instance] {
+    initial: idle
+
+    state idle {
+      INIT -> idle
+        (set @entity.sha @config.sha)
+        (render-ui main {
+          sha: @entity.sha
+          message: @config.message
+          author: @config.author
+          timestamp: @config.timestamp
+          kind: @config.kind
+          additions: @config.additions
+          deletions: @config.deletions
+          selected: @config.selected
+          current: @config.current
+          selectEvent: @config.selectEvent
+          restoreEvent: @config.restoreEvent
+          className: @config.className
+          type: commit-row
+        })
+      SELECT -> idle
+        (set @entity.sha ?sha)
+        (render-ui main {
+          sha: @entity.sha
+          message: @config.message
+          author: @config.author
+          timestamp: @config.timestamp
+          kind: @config.kind
+          additions: @config.additions
+          deletions: @config.deletions
+          selected: @config.selected
+          current: @config.current
+          selectEvent: @config.selectEvent
+          restoreEvent: @config.restoreEvent
+          className: @config.className
+          type: commit-row
+        })
+      RESTORE -> idle
+        (set @entity.sha ?sha)
+        (render-ui main {
+          sha: @entity.sha
+          message: @config.message
+          author: @config.author
+          timestamp: @config.timestamp
+          kind: @config.kind
+          additions: @config.additions
+          deletions: @config.deletions
+          selected: @config.selected
+          current: @config.current
+          selectEvent: @config.selectEvent
+          restoreEvent: @config.restoreEvent
+          className: @config.className
+          type: commit-row
+        })
+    }
+
+    emits {
+      @config.selectEvent -> external {
+        sha : string!
+      }
+        @description "Emitted when the row is picked. Payload: { sha }."
+        @tier "essential"
+      @config.restoreEvent -> external {
+        sha : string!
+      }
+        @description "Emitted by the Restore button. Payload: { sha }."
+        @tier "essential"
+    }
+
+    listens {
+      SELECT {
+        sha : string!
+      }
+      RESTORE {
+        sha : string!
+      }
+    }
+
+    config {
+      sha : string = ""
+        @label "Sha"
+        @description "Commit id; the first 7 characters are shown, the whole id on hover."
+        @tier "presentation"
+      message : string = ""
+        @label "Message"
+        @description "Commit message."
+        @tier "presentation"
+      author : string
+        @label "Author"
+        @description "author prop"
+        @tier "presentation"
+      timestamp : string
+        @label "Timestamp"
+        @description "Display time (already formatted, e.g. '2 min ago')."
+        @tier "presentation"
+      kind : "user" | "agent" | "restore" | "undo" | "redo" | "snapshot" = user
+        @label "Kind"
+        @description "What made this version (a user save, an agent turn, a restore, an undo/redo, a snapshot)."
+        @tier "presentation"
+      additions : number
+        @label "Additions"
+        @description "additions prop"
+        @tier "presentation"
+      deletions : number
+        @label "Deletions"
+        @description "deletions prop"
+        @tier "presentation"
+      selected : boolean = false
+        @label "Selected"
+        @description "The row the user picked (shows its detail)."
+        @tier "presentation"
+      current : boolean = false
+        @label "Current"
+        @description "The version the app is at now — it cannot be restored to."
+        @tier "presentation"
+      selectEvent : event = "SELECT"
+        @label "Select Event"
+        @description "Emitted when the row is picked. Payload: { sha }."
+        @tier "presentation"
+      restoreEvent : event = "RESTORE"
+        @label "Restore Event"
+        @description "Emitted by the Restore button. Payload: { sha }."
+        @tier "presentation"
+      className : string
+        @label "Class Name"
+        @description "className prop"
+        @tier "presentation"
+    }
+  }
+
+  page "/commit-row" as CommitRowPage -> CommitRowRender
+}

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

@@ -7,6 +7,7 @@ orbital FileTreeOrbital {
     path : string!
     type : "file" | "dir"!
     children : [FileTreeTreeItem]
+    note : string
     size : number
     language : string
   }