@almadar/std 16.182.0 → 16.184.0

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

@@ -0,0 +1,247 @@
+app std-tree "1.0.0"
+"std-tree — generic hierarchical node browser. Fetches a flat TreeNode collection and renders it through file-tree's flat `items` mode (parentId-nested at render time by the component, not the .lolo); OPEN_NODE is the external handoff for a selected node's id. Rebindable: pass `fields` at the call site to retarget it at any parent-pointer entity (categories, org units, comment threads)."
+orbital TreeNodeOrbital {
+    type TreeNodeLoaded = Event { data : [TreeNode] } "Fired when the tree node collection finishes loading"
+
+    type TreeNodeLoadFailed = Event { error : string, code : string } "Fired when the tree node collection fails to load"
+
+  entity TreeNode [persistent: treenodes] {
+    id : string!
+    name : string! @description "The descriptive label for this node." @synonyms "label, title, text"
+    parentId : string @description "Reference to the parent node in the hierarchy; empty marks a root." @synonyms "parent, superior, ancestor" = ""
+    icon : string @description "Icon name shown beside the node." @synonyms "glyph, symbol, pictogram" = ""
+    createdAt : string
+  }
+
+  trait TreeBrowse -> @rebindable TreeNode [interaction, collection] {
+    initial: loading
+
+    state loading {
+      INIT -> loading
+        (fetch TreeNode {
+          emit: { failure: TreeNodeLoadFailed, success: TreeNodeLoaded }
+        })
+        (render-ui main {
+          align: center
+          children: [{ type: spinner }, {
+            color: muted
+            content: "Loading tree…"
+            type: typography
+            variant: caption
+          }]
+          className: py-12
+          direction: vertical
+          gap: md
+          type: stack
+        })
+      TreeNodeLoaded -> browsing
+        (render-ui main {
+          children: [{
+            align: center
+            children: [{ name: list-tree, type: icon }, {
+              content: @config.title
+              type: typography
+              variant: h3
+            }, {
+              label: (array/len ?data)
+              size: sm
+              type: badge
+              variant: neutral
+            }]
+            direction: horizontal
+            gap: sm
+            type: stack
+          }, { type: divider }, {
+            items: (array/map ?data (fn row {
+              icon: @row.icon
+              id: @row.id
+              label: @row.name
+              parentId: @row.parentId
+            }))
+            onNodeSelect: OPEN_NODE
+            type: file-tree
+          }]
+          direction: vertical
+          gap: md
+          type: stack
+        })
+      TreeNodeLoadFailed -> error
+        (render-ui main {
+          align: center
+          children: [{
+            color: error
+            name: alert-triangle
+            type: icon
+          }, {
+            content: "Failed to load tree"
+            type: typography
+            variant: body
+          }, {
+            color: muted
+            content: ?error
+            type: typography
+            variant: caption
+          }, {
+            action: RETRY
+            icon: rotate-ccw
+            label: Retry
+            type: button
+            variant: ghost
+          }]
+          className: py-8
+          direction: vertical
+          gap: sm
+          type: stack
+        })
+    }
+
+    state browsing {
+      INIT -> loading
+        (fetch TreeNode {
+          emit: { failure: TreeNodeLoadFailed, success: TreeNodeLoaded }
+        })
+        (render-ui main {
+          align: center
+          children: [{ type: spinner }, {
+            color: muted
+            content: "Loading tree…"
+            type: typography
+            variant: caption
+          }]
+          className: py-12
+          direction: vertical
+          gap: md
+          type: stack
+        })
+      OPEN_NODE -> browsing
+        (set @entity.id ?id)
+      TreeNodeLoaded -> browsing
+        (render-ui main {
+          children: [{
+            align: center
+            children: [{ name: list-tree, type: icon }, {
+              content: @config.title
+              type: typography
+              variant: h3
+            }, {
+              label: (array/len ?data)
+              size: sm
+              type: badge
+              variant: neutral
+            }]
+            direction: horizontal
+            gap: sm
+            type: stack
+          }, { type: divider }, {
+            items: (array/map ?data (fn row {
+              icon: @row.icon
+              id: @row.id
+              label: @row.name
+              parentId: @row.parentId
+            }))
+            onNodeSelect: OPEN_NODE
+            type: file-tree
+          }]
+          direction: vertical
+          gap: md
+          type: stack
+        })
+      TreeNodeLoadFailed -> error
+        (render-ui main {
+          align: center
+          children: [{
+            color: error
+            name: alert-triangle
+            type: icon
+          }, {
+            content: "Failed to load tree"
+            type: typography
+            variant: body
+          }, {
+            color: muted
+            content: ?error
+            type: typography
+            variant: caption
+          }, {
+            action: RETRY
+            icon: rotate-ccw
+            label: Retry
+            type: button
+            variant: ghost
+          }]
+          className: py-8
+          direction: vertical
+          gap: sm
+          type: stack
+        })
+    }
+
+    state error {
+      INIT -> loading
+        (fetch TreeNode {
+          emit: { failure: TreeNodeLoadFailed, success: TreeNodeLoaded }
+        })
+        (render-ui main { type: spinner })
+      ;; the error screen's Retry button: INIT is lifecycle-only and the bus never
+      ;; delivers it, so the affordance must target a first-class user event
+      RETRY -> loading
+        (fetch TreeNode {
+          emit: { failure: TreeNodeLoadFailed, success: TreeNodeLoaded }
+        })
+        (render-ui main { type: spinner })
+    }
+
+    emits {
+      OPEN_NODE {
+        id : string!
+      }
+        @description "Signals a tree node has been selected for external handoff."
+        @synonyms "select, choose, open, activate"
+        @tier "domain"
+      TreeNodeLoaded {
+        data : [TreeNode]
+      }
+        @description "Indicates the tree node collection has been successfully retrieved."
+        @synonyms "loaded, fetched, retrieved, ready"
+        @tier "domain"
+      TreeNodeLoadFailed {
+        error : string
+        code : string
+      }
+        @description "Indicates a failure to load the tree node collection."
+        @synonyms "error, failed, problem, unsuccessful"
+        @tier "internal"
+    }
+
+    listens {
+      OPEN_NODE {
+        id : string!
+      }
+        @description "A tree node was selected for external handoff."
+        @synonyms "select, choose, open, activate"
+        @tier "domain"
+      TreeNodeLoaded {
+        data : [TreeNode]
+      }
+        @description "Indicates the tree node collection has been successfully retrieved."
+        @synonyms "loaded, fetched, retrieved, ready"
+        @tier "domain"
+      TreeNodeLoadFailed {
+        error : string
+        code : string
+      }
+        @description "Indicates a failure to load the tree node collection."
+        @synonyms "error, failed, problem, unsuccessful"
+        @tier "internal"
+    }
+
+    config {
+      title : string = Tree
+        @label "Section title"
+        @description "Heading shown above the tree"
+        @tier "presentation"
+    }
+  }
+
+  page "/tree" as TreePage -> TreeBrowse
+}

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

@@ -1,5 +1,5 @@
 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."
+"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."
 orbital RevisionOrbital {
     type RevisionLoaded = Event { data : [Revision] } "Fired when the revision collection finishes loading"
 
@@ -20,14 +20,17 @@ orbital RevisionOrbital {
     summary : string @description "A brief explanation of the revision's changes." @synonyms "description, note, comment, explanation"
     searchTerm : string @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" = ""
   }
 
-  trait RevisionManage -> Revision [interaction, collection] {
+  trait RevisionManage -> @rebindable Revision [interaction, collection] {
     initial: loading
 
     state loading {
       INIT -> loading
+        (set @entity.scopeKey (str/default ?id ""))
         (fetch Revision {
+          filter: (or ["=", @config.scopeField, ""] ["=", (str/default ?id ""), ""] ["=", (object/get @entity @config.scopeField), ?id])
           emit: { failure: RevisionLoadFailed, success: RevisionLoaded }
         })
         (render-ui main {
@@ -95,7 +98,9 @@ orbital RevisionOrbital {
           type: stack
         })
       RevisionRolledBack -> loading
+        (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 }
         })
       RevisionRollbackFailed -> error
@@ -110,11 +115,32 @@ orbital RevisionOrbital {
           type: alert
           variant: error
         })
+      SHOW_HISTORY -> loading
+        (set @entity.scopeKey ?key)
+        (fetch Revision {
+          filter: ["=", (object/get @entity @config.scopeField), ?key]
+          emit: { failure: RevisionLoadFailed, success: RevisionLoaded }
+        })
+        (render-ui main {
+          align: center
+          children: [{ type: spinner }, {
+            color: muted
+            content: "Loading version history…"
+            type: typography
+            variant: caption
+          }]
+          className: py-12
+          direction: vertical
+          gap: md
+          type: stack
+        })
     }
 
     state browsing {
       INIT -> loading
+        (set @entity.scopeKey (str/default ?id ""))
         (fetch Revision {
+          filter: (or ["=", @config.scopeField, ""] ["=", (str/default ?id ""), ""] ["=", (object/get @entity @config.scopeField), ?id])
           emit: { failure: RevisionLoadFailed, success: RevisionLoaded }
         })
         (render-ui main {
@@ -270,6 +296,25 @@ orbital RevisionOrbital {
           gap: md
           type: stack
         })
+      SHOW_HISTORY -> loading
+        (set @entity.scopeKey ?key)
+        (fetch Revision {
+          filter: ["=", (object/get @entity @config.scopeField), ?key]
+          emit: { failure: RevisionLoadFailed, success: RevisionLoaded }
+        })
+        (render-ui main {
+          align: center
+          children: [{ type: spinner }, {
+            color: muted
+            content: "Loading version history…"
+            type: typography
+            variant: caption
+          }]
+          className: py-12
+          direction: vertical
+          gap: md
+          type: stack
+        })
     }
 
     state viewing_single {
@@ -350,6 +395,25 @@ orbital RevisionOrbital {
           gap: md
           type: stack
         })
+      SHOW_HISTORY -> loading
+        (set @entity.scopeKey ?key)
+        (fetch Revision {
+          filter: ["=", (object/get @entity @config.scopeField), ?key]
+          emit: { failure: RevisionLoadFailed, success: RevisionLoaded }
+        })
+        (render-ui main {
+          align: center
+          children: [{ type: spinner }, {
+            color: muted
+            content: "Loading version history…"
+            type: typography
+            variant: caption
+          }]
+          className: py-12
+          direction: vertical
+          gap: md
+          type: stack
+        })
     }
 
     state comparing {
@@ -388,11 +452,39 @@ orbital RevisionOrbital {
           gap: md
           type: stack
         })
+      SHOW_HISTORY -> loading
+        (set @entity.scopeKey ?key)
+        (fetch Revision {
+          filter: ["=", (object/get @entity @config.scopeField), ?key]
+          emit: { failure: RevisionLoadFailed, success: RevisionLoaded }
+        })
+        (render-ui main {
+          align: center
+          children: [{ type: spinner }, {
+            color: muted
+            content: "Loading version history…"
+            type: typography
+            variant: caption
+          }]
+          className: py-12
+          direction: vertical
+          gap: md
+          type: stack
+        })
     }
 
     state error {
       INIT -> loading
+        (set @entity.scopeKey (str/default ?id ""))
         (fetch Revision {
+          filter: (or ["=", @config.scopeField, ""] ["=", (str/default ?id ""), ""] ["=", (object/get @entity @config.scopeField), ?id])
+          emit: { failure: RevisionLoadFailed, success: RevisionLoaded }
+        })
+        (render-ui main { size: sm, type: spinner })
+      SHOW_HISTORY -> loading
+        (set @entity.scopeKey ?key)
+        (fetch Revision {
+          filter: ["=", (object/get @entity @config.scopeField), ?key]
           emit: { failure: RevisionLoadFailed, success: RevisionLoaded }
         })
         (render-ui main { size: sm, type: spinner })
@@ -454,6 +546,12 @@ orbital RevisionOrbital {
     }
 
     listens {
+      INIT {
+        id : string
+      }
+        @description "Optional route param delivered on mount (e.g. an :id page segment); scopes INIT's own fetch to rows whose scopeField equals id. Absent id or empty scopeField config keeps the unfiltered global feed."
+        @synonyms "route id, deep link, initial scope"
+        @tier "domain"
       OPEN_REVISION {
         id : string!
         row : Revision
@@ -506,6 +604,12 @@ orbital RevisionOrbital {
         @description "Indicates that a revision rollback operation has failed."
         @synonyms "rollback error, revert failure, undo failed"
         @tier "internal"
+      SHOW_HISTORY {
+        key : string!
+      }
+        @description "Requests the revision feed scoped to one parent document; stores the key and refetches filtered by config.scopeField."
+        @synonyms "view history, doc history, filter revisions"
+        @tier "domain"
     }
 
     config {
@@ -521,6 +625,10 @@ orbital RevisionOrbital {
         @label "Stat display look"
         @description "Layer 2 visual treatment for stat / KPI cards."
         @tier "presentation"
+      scopeField : string = ""
+        @label "Scope field"
+        @description "Revision entity field holding the parent document's id. When set, a page-mounted {id} route param scopes INIT's fetch, and a SHOW_HISTORY { key } event rescopes the feed, to rows whose scopeField equals the id/key; rollback and retry refetches stay scoped too. Empty (default) or no id = unfiltered global feed, unchanged from prior behavior."
+        @tier "domain"
     }
   }
 

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

@@ -9,6 +9,12 @@ orbital FileTreeOrbital {
     size : number
     language : string
   }
+  type FileTreeItemsItem = {
+    id : string!
+    label : string!
+    parentId : string
+    icon : string
+  }
 
   entity FileTreeItem [runtime] {
     id : string!
@@ -21,8 +27,10 @@ orbital FileTreeOrbital {
       INIT -> idle
         (render-ui main {
           tree: @config.tree
+          items: @config.items
           selectedPath: @config.selectedPath
           onFileSelect: @config.onFileSelect
+          onNodeSelect: @config.onNodeSelect
           className: @config.className
           indent: @config.indent
           type: file-tree
@@ -38,9 +46,13 @@ orbital FileTreeOrbital {
     }
 
     config {
-      tree : [FileTreeTreeItem] = [{ name: "Name", path: "Path", type: file, children: [], size: 1, language: "Language" }, { name: "Name 2", path: "Path 2", type: dir, children: [], size: 2, language: "Language 2" }]
+      tree : [FileTreeTreeItem] = []
         @label "Tree"
-        @description "The tree data"
+        @description "The tree data (pre-nested). Ignored when `items` is provided."
+        @tier "presentation"
+      items : [FileTreeItemsItem] = []
+        @label "Items"
+        @description "Flat node list, nested by `parentId` at render time — takes precedence over `tree` when provided. A `parentId` with no matching row renders that node as a root rather than dropping it."
         @tier "presentation"
       selectedPath : string
         @label "Selected Path"
@@ -50,6 +62,10 @@ orbital FileTreeOrbital {
         @label "On File Select"
         @description "Called when a file is clicked"
         @tier "presentation"
+      onNodeSelect : string = ""
+        @label "On Node Select"
+        @description "Called when a node is clicked, in flat `items` mode; carries the selected node's id. Presence-gated: binding this prop is what turns on the click-to-select affordance, mirroring Badge's `onRemove`."
+        @tier "presentation"
       className : string
         @label "Class Name"
         @description "CSS class"

package/behaviors/lolo/ui/core/organisms/ui-detail-panel.lolo

@@ -41,7 +41,11 @@ orbital DetailPanelOrbital {
     header : string
     type : string
     values : [string]
-    relation : string
+    relation : DetailPanelFieldsItemRelation
+  }
+  type DetailPanelFieldsItemRelation = {
+    entity : string!
+    cardinality : "one" | "many" | "one-to-many" | "many-to-one" | "many-to-many"
   }
   type DetailPanelRelationsDataValueItem = {
     value : string!
@@ -224,7 +228,7 @@ orbital DetailPanelOrbital {
         @label "Slide Over"
         @description "slideOver prop"
         @tier "presentation"
-      fields : [DetailPanelFieldsItem] = [{ key: "Key", header: "Header", type: "Type", values: ["Item", "Item 2"], relation: "Relation" }, { key: "Key 2", header: "Header 2", type: "Type 2", values: ["Item", "Item 2"], relation: "Relation 2" }]
+      fields : [DetailPanelFieldsItem] = [{ key: "Key", header: "Header", type: "Type", values: ["Item", "Item 2"], relation: { entity: "Entity", cardinality: one } }, { key: "Key 2", header: "Header 2", type: "Type 2", values: ["Item", "Item 2"], relation: { entity: "Entity 2", cardinality: many } }]
         @label "Fields"
         @description "Fields to display - accepts string[], {key, header}[], or DetailField[]"
         @tier "presentation"

package/behaviors/lolo/ui/core/organisms/ui-form-section.lolo

@@ -29,7 +29,7 @@ orbital FormSectionOrbital {
   type FormSectionFieldsItemRelation = {
     entity : string!
     displayField : string
-    cardinality : "one" | "many"
+    cardinality : "one" | "many" | "one-to-many" | "many-to-one" | "many-to-many"
   }
   type FormSectionFieldsItemValidation = {
     enum : [string]
@@ -108,7 +108,7 @@ orbital FormSectionOrbital {
   type FormSectionSectionsItemFieldsItemRelation = {
     entity : string!
     displayField : string
-    cardinality : "one" | "many"
+    cardinality : "one" | "many" | "one-to-many" | "many-to-one" | "many-to-many"
   }
   type FormSectionSectionsItemFieldsItemValidation = {
     enum : [string]

package/behaviors/lolo/ui/core/organisms/ui-form.lolo

@@ -29,7 +29,7 @@ orbital FormOrbital {
   type FormFieldsItemRelation = {
     entity : string!
     displayField : string
-    cardinality : "one" | "many"
+    cardinality : "one" | "many" | "one-to-many" | "many-to-one" | "many-to-many"
   }
   type FormFieldsItemValidation = {
     enum : [string]
@@ -108,7 +108,7 @@ orbital FormOrbital {
   type FormSectionsItemFieldsItemRelation = {
     entity : string!
     displayField : string
-    cardinality : "one" | "many"
+    cardinality : "one" | "many" | "one-to-many" | "many-to-one" | "many-to-many"
   }
   type FormSectionsItemFieldsItemValidation = {
     enum : [string]

package/behaviors/lolo/ui/game/atoms/std-fx-trail.lolo

@@ -0,0 +1,63 @@
+app std-fx-trail "1.0.0"
+"Headless motion-trail mechanic: records the moving body's recent positions as timestamped dots on a [runtime, shared] entity so the render layer can draw a fading comet trail. Rides the body authority's BODY_MOVED — appends a dot only when the body's speed exceeds minSpeed (standing still leaves no trail) and prunes dots older than ttl on the same pass, so no decay tick is needed and a stopped body's trail simply stops growing (the render side fades each dot by bornAt/ttl). RESTART clears. Renders nothing."
+orbital FxTrailOrbital {
+  type TrailDot = {
+    id : string!
+    x : number!
+    y : number!
+    bornAt : number!
+    ttl : number!
+  }
+
+  entity FxTrailData [runtime, shared] {
+    id : string!
+    trail : [TrailDot] = []
+    seq : number = 0
+  }
+
+  trait FxTrail -> @rebindable FxTrailData [lifecycle] {
+    initial: active
+
+    state active {
+      INIT -> active
+        (set @entity.trail [])
+        (set @entity.seq 0)
+
+      BODY_MOVED -> active when @config.running
+        (set @entity.trail
+          (array/filter
+            (if (> @payload.speed @config.minSpeed)
+              (array/concat @entity.trail [ { id: (str/concat "trail-" (+ @entity.seq 1)), x: @payload.x, y: @payload.y, bornAt: (time/now), ttl: @config.ttl } ])
+              @entity.trail)
+            (fn d (< (- (time/now) (object/get @d bornAt)) (object/get @d ttl)))))
+        (if (> @payload.speed @config.minSpeed)
+          (set @entity.seq (+ @entity.seq 1))
+          null)
+
+      RESTART -> active
+        (set @entity.trail [])
+    }
+
+    listens {
+      BODY_MOVED { x : number!, y : number!, vx : number!, vy : number!, grounded : boolean!, skating : boolean!, speed : number! }
+      RESTART { id : string }
+    }
+
+    config {
+      running : boolean = true
+        @label "Running"
+        @description "When true, BODY_MOVED appends trail dots; toggle to freeze the trail (existing dots still age out)."
+        @tier "domain"
+      ttl : number = 600
+        @label "Trail Ttl (ms)"
+        @description "Milliseconds a trail dot lives; at a 33ms move cadence ~600ms keeps the last eighteen positions. The ttl is also the natural length cap — no separate limit needed."
+        @tier "presentation"
+      minSpeed : number = 0.5
+        @label "Min Speed"
+        @description "Body speed (units/s, from BODY_MOVED) below which no dot is appended, so a resting body doesn't pile dots on one spot."
+        @tier "domain"
+    }
+  }
+
+  page "/fx-trail" as FxTrailPage -> FxTrail
+}