@almadar/std 16.211.0 → 16.213.0

package/behaviors/lolo/ui/core/atoms/std-rating-review.lolo

@@ -881,9 +881,189 @@ orbital RatingReviewOrbital {
           type: stack
         })
       MARK_HELPFUL -> viewing
+        (set @entity.reviews (array/map @entity.reviews (fn row (if ["=", (object/get @row id ""), ?id] (object/merge @row { helpful: ["+", (object/get @row helpful 0), 1] }) @row))))
+        (set @entity.reviewsSource (array/map @entity.reviewsSource (fn row (if ["=", (object/get @row id ""), ?id] (object/merge @row { helpful: ["+", (object/get @row helpful 0), 1] }) @row))))
         (render-ui main {
-          title: "Recording…"
-          type: loading-state
+          children: [{
+            align: center
+            children: [{
+              children: [{
+                align: center
+                children: [{ name: star, type: icon }, {
+                  content: Reviews
+                  type: typography
+                  variant: h3
+                }, {
+                  color: muted
+                  content: "·"
+                  type: typography
+                }, {
+                  content: @entity.averageRating
+                  type: typography
+                  variant: h3
+                }, {
+                  color: warning
+                  name: star
+                  type: icon
+                }, {
+                  color: muted
+                  content: "·"
+                  type: typography
+                }, {
+                  color: muted
+                  content: @entity.totalReviews
+                  type: typography
+                  variant: h4
+                }, {
+                  color: muted
+                  content: reviews
+                  type: typography
+                  variant: h4
+                }]
+                direction: horizontal
+                gap: sm
+                type: stack
+              }, {
+                color: muted
+                content: @config.subjectTitle
+                type: typography
+                variant: caption
+              }]
+              direction: vertical
+              gap: xs
+              type: stack
+            }, {
+              action: WRITE_REVIEW
+              icon: edit
+              label: @config.writeLabel
+              type: button
+              variant: primary
+            }]
+            direction: horizontal
+            gap: md
+            justify: between
+            type: stack
+          }, {
+            children: [{
+              children: [{
+                content: "Rating distribution"
+                type: typography
+                variant: h4
+              }, {
+                entity: @entity.starDistribution
+                fields: []
+                gap: sm
+                renderItem: (fn bar {
+                  align: center
+                  children: [{
+                    content: @bar.label
+                    type: typography
+                    variant: caption
+                  }, {
+                    max: 100
+                    type: progress-bar
+                    value: @bar.percentage
+                    variant: primary
+                  }, {
+                    color: muted
+                    content: @bar.percentage
+                    type: typography
+                    variant: caption
+                  }, {
+                    color: muted
+                    content: "%"
+                    type: typography
+                    variant: caption
+                  }]
+                  direction: horizontal
+                  gap: md
+                  type: stack
+                })
+                type: data-list
+              }]
+              direction: vertical
+              gap: sm
+              type: stack
+            }]
+            look: @config.cardLook
+            type: card
+          }, {
+            activeTab: @entity.currentSort
+            tabChangeEvent: CHANGE_SORT
+            tabs: @config.sortOptions
+            type: tabs
+          }, {
+            entity: @entity.reviews
+            fields: []
+            gap: md
+            renderItem: (fn review {
+              children: [{
+                children: [{
+                  align: center
+                  children: [{ name: @review.avatarIcon, type: icon }, {
+                    content: @review.authorName
+                    type: typography
+                    weight: bold
+                  }, {
+                    color: muted
+                    content: "·"
+                    type: typography
+                  }, {
+                    color: warning
+                    name: star
+                    type: icon
+                  }, {
+                    content: @review.rating
+                    type: typography
+                    weight: bold
+                  }, {
+                    color: muted
+                    content: "·"
+                    type: typography
+                  }, {
+                    color: muted
+                    content: @review.createdAt
+                    type: typography
+                    variant: caption
+                  }]
+                  direction: horizontal
+                  gap: sm
+                  type: stack
+                }, {
+                  content: @review.comment
+                  type: typography
+                  variant: body
+                }, {
+                  align: center
+                  children: [{
+                    action: MARK_HELPFUL
+                    actionPayload: { id: @review.id }
+                    icon: thumbs-up
+                    label: Helpful
+                    type: button
+                    variant: ghost
+                  }, {
+                    color: muted
+                    content: @review.helpful
+                    type: typography
+                    variant: caption
+                  }]
+                  direction: horizontal
+                  gap: sm
+                  type: stack
+                }]
+                direction: vertical
+                gap: sm
+                type: stack
+              }]
+              look: @config.cardLook
+              type: card
+            })
+            type: data-list
+          }]
+          direction: vertical
+          gap: lg
+          type: stack
         })
     }
 
@@ -1539,7 +1719,38 @@ orbital RatingReviewOrbital {
     }
   }
 
-  page "/reviews" as RatingReviewPage -> RatingReviewBoard
+  trait RatingReviewPageNav -> ReviewView [interaction, instance] {
+    initial: ready
+
+    state ready {
+      INIT -> ready
+        (render-ui main {
+          action: OPEN_REVIEW_FORM
+          icon: external-link
+          label: "Open review form"
+          type: button
+          variant: ghost
+        })
+      OPEN_REVIEW_FORM -> ready
+        (navigate "/reviews/new")
+    }
+
+    emits {
+      OPEN_REVIEW_FORM
+        @description "Opens the standalone review-submission page."
+        @synonyms "open form, new page, direct link"
+        @tier "presentation"
+    }
+
+    listens {
+      OPEN_REVIEW_FORM
+        @description "Opens the standalone review-submission page in place of the inline composer."
+        @synonyms "open form, new page, direct link"
+        @tier "presentation"
+    }
+  }
+
+  page "/reviews" as RatingReviewPage -> RatingReviewBoard, RatingReviewPageNav
 
   page "/reviews/new" as RatingReviewSubmitPage -> RatingReviewSubmit
 }

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

@@ -145,7 +145,7 @@ orbital SelectableItemOrbital {
       REFETCH_QUERY -> idle
         (fetch SelectableItem {
           emit: { failure: SelectableItemLoadFailed, success: SelectableItemLoaded }
-          filter: (or ["=", ?searchTerm, ""] (str/includes (object/get @entity name) ?searchTerm))
+          filter: (or ["=", ?searchTerm, ""] (str/includes (object/get @entity @config.searchField) ?searchTerm))
         })
       REFETCH_FILTER -> idle
         (fetch SelectableItem {
@@ -166,6 +166,8 @@ orbital SelectableItemOrbital {
           limit: @config.pageSize
           offset: ["*", ["-", ?page, 1], @config.pageSize]
         })
+      SelectableItemLoadFailed -> idle
+        (notify error (str/concat "Couldn't refresh the list — " ?error))
       SelectableItemLoaded -> idle
         (render-ui main {
           children: [{
@@ -429,6 +431,11 @@ orbital SelectableItemOrbital {
         @label "Table look"
         @description "Layer 2 visual treatment for the data table rendered by this atom."
         @tier "presentation"
+      searchField : string = "name"
+        @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 `name` column must set this to a real field (e.g. title, label) or the search box can never match a row."
+        @synonyms "search column, search on field, match field, search key"
+        @tier "policy"
       bodySearch : boolean = false
         @label "Show the pick-list's own search box?"
         @description "Embeds a search box above the pick-list. Set true only when the page has no other search affordance (e.g. no page-level std-search), so the surface shows one search box instead of two. False is the default — this atom has never had a search box (0 consumers today)."

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

@@ -35,6 +35,7 @@ orbital TagStripOrbital {
       ;; Pre-scope paint: the store is warm but no record is open yet.
       TagStripOptions -> idle
       TagStripLoadFailed -> idle
+        (notify error (str/concat "Couldn't load tags — " ?error))
       SHOW_TAG_STRIP -> loading
         (set @entity.docId ?id)
         (set @entity.docTagIds (array/map ?tagIds (fn t (str/default (object/get @t id) @t))))

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

@@ -342,6 +342,22 @@ orbital TagTaxonomyOrbital {
           type: stack
         })
         (emit LEVEL_RELOAD { tagId: @entity.id })
+      CLOSE -> loading
+        (render-ui modal null)
+        (render-ui main {
+          align: center
+          children: [{ type: spinner }, {
+            color: muted
+            content: "Loading…"
+            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)

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

@@ -444,6 +444,42 @@ orbital WizardOrbital {
     }
 
     state completed {
+      WizardSaved -> completed
+        (render-ui main {
+          align: center
+          children: [{
+            name: check-circle
+            size: lg
+            type: icon
+          }, {
+            align: center
+            content: Complete
+            type: typography
+            variant: h2
+          }, {
+            align: center
+            color: muted
+            content: @entity.completionMessage
+            type: typography
+            variant: body
+          }, {
+            allowNavigation: false
+            currentStep: @entity.totalSteps
+            steps: @entity.wizardSteps
+            type: wizard-progress
+          }, {
+            action: RESTART
+            icon: rotate-ccw
+            label: "Start a new wizard"
+            type: button
+            variant: secondary
+          }]
+          direction: vertical
+          gap: lg
+          type: stack
+        })
+      WizardSaveFailed -> completed
+        (notify error (str/concat "Couldn't save the wizard — " ?error))
       RESTART -> loading
         (set @entity.currentStepIndex 0)
         (set @entity.completionMessage "")

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

@@ -9,7 +9,7 @@ orbital BadgeOrbital {
     style : "pixel" | "vector" | "hd" | "1-bit" | "isometric"
     variant : string
     dimension : "2d" | "3d"
-    aspect : "1:1" | "16:9" | "5:7" | "8:1"
+    aspect : "1:1" | "16:9" | "5:7" | "8:1" | "4:1" | "5:3" | "1:2"
     atlas : asset
     sprite : string
     name : string

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

@@ -9,7 +9,7 @@ orbital ButtonOrbital {
     style : "pixel" | "vector" | "hd" | "1-bit" | "isometric"
     variant : string
     dimension : "2d" | "3d"
-    aspect : "1:1" | "16:9" | "5:7" | "8:1"
+    aspect : "1:1" | "16:9" | "5:7" | "8:1" | "4:1" | "5:3" | "1:2"
     atlas : asset
     sprite : string
     name : string

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

@@ -3,6 +3,7 @@ app ui-checkbox "1.0.0"
 orbital CheckboxOrbital {
   entity CheckboxItem [runtime] {
     id : string!
+    checked : boolean @intrinsic
   }
 
   trait CheckboxRender -> @rebindable CheckboxItem [interaction, instance] {
@@ -10,9 +11,20 @@ orbital CheckboxOrbital {
 
     state idle {
       INIT -> idle
+        (set @entity.checked @config.checked)
         (render-ui main {
           className: @config.className
-          checked: @config.checked
+          checked: @entity.checked
+          defaultChecked: @config.defaultChecked
+          label: @config.label
+          onChange: @config.onChange
+          type: checkbox
+        })
+      CHANGE -> idle
+        (set @entity.checked ?checked)
+        (render-ui main {
+          className: @config.className
+          checked: @entity.checked
           defaultChecked: @config.defaultChecked
           label: @config.label
           onChange: @config.onChange
@@ -21,11 +33,19 @@ orbital CheckboxOrbital {
     }
 
     emits {
-      @config.onChange -> external { }
+      @config.onChange -> external {
+        checked : boolean!
+      }
         @description "onChange handler or declarative event key for trait dispatch"
         @tier "essential"
     }
 
+    listens {
+      CHANGE {
+        checked : boolean!
+      }
+    }
+
     config {
       className : string
         @label "Class Name"

package/behaviors/lolo/ui/core/atoms/ui-game-icon.lolo

@@ -9,7 +9,7 @@ orbital GameIconOrbital {
     style : "pixel" | "vector" | "hd" | "1-bit" | "isometric"
     variant : string
     dimension : "2d" | "3d"
-    aspect : "1:1" | "16:9" | "5:7" | "8:1"
+    aspect : "1:1" | "16:9" | "5:7" | "8:1" | "4:1" | "5:3" | "1:2"
     atlas : asset
     sprite : string
     name : string

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

@@ -46,10 +46,14 @@ orbital SelectOrbital {
       }
         @description "Declarative event name for trait dispatch — emits `{ value }` on selection commit (same gestures as `onChange`)."
         @tier "essential"
-      @config.onChange -> external { }
+      @config.onChange -> external {
+        value : string!
+      }
         @description "onChange handler (native ChangeEvent) or declarative event key for trait dispatch"
         @tier "essential"
-      @config.onValueChange -> external { }
+      @config.onValueChange -> external {
+        value : string!
+      }
         @description "Value-based change: a React callback (internal use) OR a declarative event key that emits `{ value }` on the bus (render-ui / lolo authoring). Mirrors the `onChange` handler|event convention so it's an event-emitting prop, not a bare callback."
         @tier "essential"
     }

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

@@ -25,7 +25,9 @@ orbital TextareaOrbital {
       @config.action -> external { }
         @description "Declarative event name for trait dispatch"
         @tier "essential"
-      @config.onChange -> external { }
+      @config.onChange -> external {
+        value : string!
+      }
         @description "onChange handler or declarative event key for trait dispatch"
         @tier "essential"
     }

package/behaviors/lolo/ui/core/molecules/ui-command-palette.lolo

@@ -89,7 +89,7 @@ orbital CommandPaletteOrbital {
         @label "On Open Change"
         @description "Called to open/close the overlay (Escape, overlay click, or a selection)"
         @tier "presentation"
-      commands : [CommandPaletteCommandsItem] = [{ id: "Id", label: "Label", icon: "circle", shortcut: "Shortcut", keywords: ["Item", "Item 2"], group: "Group", disabled: false, action: "INIT" }, { id: "Id 2", label: "Label 2", icon: "circle", shortcut: "Shortcut 2", keywords: ["Item", "Item 2"], group: "Group 2", disabled: true, action: "INIT" }]
+      commands : [CommandPaletteCommandsItem] = []
         @label "Commands"
         @description "Commands listed in the palette, filtered as the user types"
         @tier "presentation"

package/behaviors/lolo/ui/core/molecules/ui-data-grid.lolo

@@ -32,6 +32,12 @@ orbital DataGridOrbital {
     code : string
     stack : string
   }
+  type DataGridRelationsDataValueItem = {
+    value : string!
+    label : string!
+    description : string
+    disabled : boolean
+  }
 
   entity DataGridItem [runtime] {
     id : string!
@@ -72,6 +78,7 @@ orbital DataGridOrbital {
           hasMore: @config.hasMore
           pageSize: @config.pageSize
           look: @config.look
+          relationsData: @config.relationsData
           type: data-grid
         })
       INIT -> idle when (not @config.selfFetch)
@@ -104,6 +111,7 @@ orbital DataGridOrbital {
           hasMore: @config.hasMore
           pageSize: @config.pageSize
           look: @config.look
+          relationsData: @config.relationsData
           type: data-grid
         })
       DataGridLoaded -> idle
@@ -136,6 +144,7 @@ orbital DataGridOrbital {
           hasMore: @config.hasMore
           pageSize: @config.pageSize
           look: @config.look
+          relationsData: @config.relationsData
           type: data-grid
         })
     }
@@ -270,6 +279,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"
+      relationsData : Map string [DataGridRelationsDataValueItem] = {}
+        @label "Relations Data"
+        @description "Relation display data: { fieldName: [{value, label}] } — injected server-side by the runtime (relation-option injection) or bound by compiled codegen; resolves stored foreign ids to display names for a field whose type is relation. Same contract DetailPanel takes."
+        @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."

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

@@ -38,6 +38,12 @@ orbital DataListOrbital {
     icon : icon
     variant : "primary" | "secondary" | "danger" | "ghost"
   }
+  type DataListRelationsDataValueItem = {
+    value : string!
+    label : string!
+    description : string
+    disabled : boolean
+  }
 
   entity DataListItem [runtime] {
     id : string!
@@ -87,6 +93,7 @@ orbital DataListOrbital {
           sortBy: @config.sortBy
           sortDirection: @config.sortDirection
           look: @config.look
+          relationsData: @config.relationsData
           type: data-list
         })
       INIT -> idle when (not @config.selfFetch)
@@ -128,6 +135,7 @@ orbital DataListOrbital {
           sortBy: @config.sortBy
           sortDirection: @config.sortDirection
           look: @config.look
+          relationsData: @config.relationsData
           type: data-list
         })
       DataListLoaded -> idle
@@ -169,6 +177,7 @@ orbital DataListOrbital {
           sortBy: @config.sortBy
           sortDirection: @config.sortDirection
           look: @config.look
+          relationsData: @config.relationsData
           type: data-list
         })
     }
@@ -352,6 +361,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"
+      relationsData : Map string [DataListRelationsDataValueItem] = {}
+        @label "Relations Data"
+        @description "Relation display data: { fieldName: [{value, label}] } — injected server-side by the runtime (relation-option injection) or bound by compiled codegen; resolves stored foreign ids to display names for a field whose type is relation. Same contract DetailPanel takes."
+        @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."

package/behaviors/lolo/ui/core/molecules/ui-floating-toolbar.lolo

@@ -32,7 +32,7 @@ orbital FloatingToolbarOrbital {
     }
 
     config {
-      items : [FloatingToolbarItemsItem] = [{ id: "Id", icon: "circle", label: "Label", action: "INIT", active: false, disabled: false, testId: "Test Id" }, { id: "Id 2", icon: "circle", label: "Label 2", action: "INIT", active: true, disabled: true, testId: "Test Id 2" }]
+      items : [FloatingToolbarItemsItem] = []
         @label "Items"
         @description "Tool items rendered as icon buttons"
         @tier "presentation"

package/behaviors/lolo/ui/core/molecules/ui-import-preview-tree.lolo

@@ -56,7 +56,7 @@ orbital ImportPreviewTreeOrbital {
     }
 
     config {
-      units : [ImportPreviewTreeUnitsItem] = [{ ref: "Ref", targetEntity: "Target Entity", fields: {}, parentRef: "Parent Ref" }, { ref: "Ref 2", targetEntity: "Target Entity 2", fields: {}, parentRef: "Parent Ref 2" }]
+      units : [ImportPreviewTreeUnitsItem] = []
         @label "Units"
         @description "Staged units to preview"
         @tier "presentation"

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

@@ -39,7 +39,7 @@ orbital MenuOrbital {
         @label "Trigger"
         @description "Menu trigger element"
         @tier "presentation"
-      items : [MenuItemsItem] = [{ id: "Id", label: "Label", icon: "circle", badge: "Badge", disabled: false, title: "Title", url: "Url", variant: default, subMenu: [] }, { id: "Id 2", label: "Label 2", icon: "circle", badge: "Badge 2", disabled: true, title: "Title 2", url: "Url 2", variant: danger, subMenu: [] }]
+      items : [MenuItemsItem] = []
         @label "Items"
         @description "Menu items"
         @tier "presentation"

package/behaviors/lolo/ui/core/molecules/ui-table-view.lolo

@@ -41,6 +41,12 @@ orbital TableViewOrbital {
     code : string
     stack : string
   }
+  type TableViewRelationsDataValueItem = {
+    value : string!
+    label : string!
+    description : string
+    disabled : boolean
+  }
 
   entity TableViewItem [runtime] {
     id : string!
@@ -80,6 +86,7 @@ orbital TableViewOrbital {
           groupBy: @config.groupBy
           pageSize: @config.pageSize
           look: @config.look
+          relationsData: @config.relationsData
           type: table-view
         })
       INIT -> idle when (not @config.selfFetch)
@@ -111,6 +118,7 @@ orbital TableViewOrbital {
           groupBy: @config.groupBy
           pageSize: @config.pageSize
           look: @config.look
+          relationsData: @config.relationsData
           type: table-view
         })
       TableViewLoaded -> idle
@@ -142,6 +150,7 @@ orbital TableViewOrbital {
           groupBy: @config.groupBy
           pageSize: @config.pageSize
           look: @config.look
+          relationsData: @config.relationsData
           type: table-view
         })
     }
@@ -275,6 +284,10 @@ orbital TableViewOrbital {
         @label "Look"
         @description "Layer 2 visual treatment — mirrors the data-list / entity-table look enum so authors share one knob name across row renderers."
         @tier "presentation"
+      relationsData : Map string [TableViewRelationsDataValueItem] = {}
+        @label "Relations Data"
+        @description "Relation display data: { fieldName: [{value, label}] } — injected server-side by the runtime (relation-option injection) or bound by compiled codegen; resolves stored foreign ids to display names for a column whose field is relation-typed. Same contract DetailPanel takes."
+        @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."

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

@@ -21,7 +21,7 @@ orbital TabsOrbital {
     style : "pixel" | "vector" | "hd" | "1-bit" | "isometric"
     variant : string
     dimension : "2d" | "3d"
-    aspect : "1:1" | "16:9" | "5:7" | "8:1"
+    aspect : "1:1" | "16:9" | "5:7" | "8:1" | "4:1" | "5:3" | "1:2"
     atlas : asset
     sprite : string
     name : string
@@ -47,7 +47,7 @@ orbital TabsOrbital {
     style : "pixel" | "vector" | "hd" | "1-bit" | "isometric"
     variant : string
     dimension : "2d" | "3d"
-    aspect : "1:1" | "16:9" | "5:7" | "8:1"
+    aspect : "1:1" | "16:9" | "5:7" | "8:1" | "4:1" | "5:3" | "1:2"
     atlas : asset
     sprite : string
     name : string