@almadar/std 16.231.0 → 16.232.0

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/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-version-diff.lolo

@@ -1,5 +1,6 @@
 app ui-version-diff "1.0.0"
-"VersionDiff — UI factory (1:1 with the @almadar/ui version-diff pattern)."
+"A line diff between two versions — two whole texts, or a pre-computed diff such as one commit. — UI factory (1:1 with the @almadar/ui version-diff pattern)."
+;; @capabilities "version diff, compare revisions, what changed, before and after, code diff, commit diff, revision comparison"
 ;; @pattern "version-diff"
 orbital VersionDiffOrbital {
   type VersionDiffRevisionsItem = {
@@ -9,6 +10,16 @@ orbital VersionDiffOrbital {
     timestamp : string
     content : string!
   }
+  type VersionDiffHunksItem = {
+    header : string!
+    lines : [VersionDiffHunksItemLinesItem]!
+  }
+  type VersionDiffHunksItemLinesItem = {
+    type : "added" | "removed" | "unchanged" | "context"!
+    beforeLineNumber : number
+    afterLineNumber : number
+    content : string!
+  }
 
   entity VersionDiffItem [runtime] {
     id : string!
@@ -21,6 +32,7 @@ orbital VersionDiffOrbital {
       INIT -> idle
         (render-ui main {
           revisions: @config.revisions
+          hunks: @config.hunks
           beforeId: @config.beforeId
           afterId: @config.afterId
           view: @config.view
@@ -55,10 +67,14 @@ orbital VersionDiffOrbital {
     }
 
     config {
-      revisions : [VersionDiffRevisionsItem] = [{ id: "Id", label: "Label", author: "Author", timestamp: "Timestamp", content: "Content" }, { id: "Id 2", label: "Label 2", author: "Author 2", timestamp: "Timestamp 2", content: "Content 2" }]
+      revisions : [VersionDiffRevisionsItem] = []
         @label "Revisions"
         @description "All available revisions (at least 2). Accepts either a typed array (direct consumers) or the runtime payload shape from a render-ui binding (`@payload.revisions`). Narrowed to `[]` internally when the value isn't an array."
         @tier "presentation"
+      hunks : [VersionDiffHunksItem] = []
+        @label "Hunks"
+        @description "A pre-computed diff to render instead of diffing `revisions` (no revision pickers)."
+        @tier "presentation"
       beforeId : string
         @label "Before Id"
         @description "Currently selected 'before' revision id."
@@ -69,7 +85,7 @@ orbital VersionDiffOrbital {
         @tier "presentation"
       view : "side-by-side" | "inline" = "side-by-side"
         @label "View"
-        @description "Display mode."
+        @description "Display mode to start in; the toggle switches it."
         @tier "presentation"
       onSelectBefore : event = "SELECT_BEFORE"
         @label "On Select Before"

package/behaviors/lolo/ui/game/atoms/ui-canvas.lolo

@@ -146,6 +146,7 @@ orbital CanvasOrbital {
         featureId : string!
         x : number!
         z : number!
+        type : string
         elevation : number
       }
         @description "Feature-click event (3D only)."