@almadar/std 16.236.0 → 16.237.0

package/behaviors/lolo/ui/core/organisms/ui-entity-list.lolo

@@ -10,17 +10,22 @@ orbital EntityListOrbital {
     stack : string
   }
   type EntityListFieldsItem = {
-    key : string
-    header : string
-    name : string
+    name : string!
     label : string
+    icon : icon
+    variant : "h3" | "h4" | "body" | "caption" | "badge" | "small" | "progress"
+    format : "date" | "currency" | "number" | "boolean" | "percent"
+    colorMap : Map string EntityListFieldsItemColorMapValue
+    labels : Map string string
   }
+  type EntityListFieldsItemColorMapValue = "default" | "primary" | "secondary" | "success" | "warning" | "danger" | "error" | "info" | "neutral" | "destructive"
   type EntityListItemActionsItem = {
     label : string!
     event : event
     navigatesTo : string
     placement : string
     variant : "primary" | "secondary" | "ghost" | "danger" | "default"
+    icon : icon
     when : SExpr
     roles : [string]
   }
@@ -57,6 +62,9 @@ orbital EntityListOrbital {
           children: @config.children
           fields: @config.fields
           fieldNames: @config.fieldNames
+          itemClickEvent: @config.itemClickEvent
+          completedField: @config.completedField
+          disabledField: @config.disabledField
           type: entity-list
         })
       INIT -> idle when (not @config.selfFetch)
@@ -82,6 +90,9 @@ orbital EntityListOrbital {
           children: @config.children
           fields: @config.fields
           fieldNames: @config.fieldNames
+          itemClickEvent: @config.itemClickEvent
+          completedField: @config.completedField
+          disabledField: @config.disabledField
           type: entity-list
         })
       EntityListLoaded -> idle
@@ -107,6 +118,9 @@ orbital EntityListOrbital {
           children: @config.children
           fields: @config.fields
           fieldNames: @config.fieldNames
+          itemClickEvent: @config.itemClickEvent
+          completedField: @config.completedField
+          disabledField: @config.disabledField
           type: entity-list
         })
     }
@@ -115,6 +129,12 @@ orbital EntityListOrbital {
       ITEM_ACTIONS -> external { }
         @description "Item actions - schema-driven or function-based"
         @tier "essential"
+      @config.itemClickEvent -> external {
+        id : string!
+        row : @entity!
+      }
+        @description "When set, clicking a row emits UI:{itemClickEvent} with { id, row }. Omit = rows are not clickable."
+        @tier "essential"
       VIEW -> external {
         id : string!
         row : @entity!
@@ -201,14 +221,26 @@ orbital EntityListOrbital {
         @label "Children"
         @description "children prop"
         @tier "presentation"
-      fields : [EntityListFieldsItem] = [{ key: "Key", header: "Header", name: "Name", label: "Label" }, { key: "Key 2", header: "Header 2", name: "Name 2", label: "Label 2" }]
+      fields : [EntityListFieldsItem] = [{ name: "Name", label: "Label", icon: "circle", variant: h3, format: date }, { name: "Name 2", label: "Label 2", icon: "circle", variant: h4, format: currency }]
         @label "Fields"
-        @description "Fields to display - accepts string[] or {key, header}[] for unified interface"
+        @description "Fields to display: field names, or declared fields ({ name, label, variant, format, colorMap, labels })"
         @tier "presentation"
       fieldNames : [string] = []
         @label "Field Names"
         @description "Alias for fields - backwards compatibility"
         @tier "presentation"
+      itemClickEvent : event = "ITEM_CLICK"
+        @label "Item Click Event"
+        @description "When set, clicking a row emits UI:{itemClickEvent} with { id, row }. Omit = rows are not clickable."
+        @tier "presentation"
+      completedField : string
+        @label "Completed Field"
+        @description "Row field that marks an item completed (`true` strikes its title through)"
+        @tier "presentation"
+      disabledField : string
+        @label "Disabled Field"
+        @description "Row field that marks an item disabled (`true` dims the row and disables its click)"
+        @tier "presentation"
       viewerRole : string = ""
         @label "Viewer's role"
         @description "The viewer's role that each action's `roles` is checked against; bind it at the call site (e.g. `viewerRole: @user.role`). Empty = only actions with no `roles` show."

package/behaviors/lolo/ui/core/organisms/ui-entity-table.lolo

@@ -16,6 +16,8 @@ orbital EntityTableOrbital {
     label : string
     width : string
     sortable : boolean
+    align : "left" | "center" | "right"
+    format : "date" | "currency" | "number" | "boolean" | "percent"
   }
   type EntityTableColumnsItem = {
     key : string
@@ -24,6 +26,8 @@ orbital EntityTableOrbital {
     label : string
     width : string
     sortable : boolean
+    align : "left" | "center" | "right"
+    format : "date" | "currency" | "number" | "boolean" | "percent"
   }
   type EntityTableItemActionsItem = {
     label : string!
@@ -86,6 +90,7 @@ orbital EntityTableOrbital {
           entity: @entity
           fields: @config.fields
           columns: @config.columns
+          itemClickEvent: @config.itemClickEvent
           itemActions: (array/filter @config.itemActions (fn action (or (= (array/len (object/get @action roles [])) 0) (array/includes (object/get @action roles []) @config.viewerRole))))
           emptyIcon: @config.emptyIcon
           emptyTitle: @config.emptyTitle
@@ -118,6 +123,7 @@ orbital EntityTableOrbital {
           entity: @entity
           fields: @config.fields
           columns: @config.columns
+          itemClickEvent: @config.itemClickEvent
           itemActions: (array/filter @config.itemActions (fn action (or (= (array/len (object/get @action roles [])) 0) (array/includes (object/get @action roles []) @config.viewerRole))))
           emptyIcon: @config.emptyIcon
           emptyTitle: @config.emptyTitle
@@ -150,6 +156,7 @@ orbital EntityTableOrbital {
           entity: @payload.data
           fields: @config.fields
           columns: @config.columns
+          itemClickEvent: @config.itemClickEvent
           itemActions: (array/filter @config.itemActions (fn action (or (= (array/len (object/get @action roles [])) 0) (array/includes (object/get @action roles []) @config.viewerRole))))
           emptyIcon: @config.emptyIcon
           emptyTitle: @config.emptyTitle
@@ -169,6 +176,12 @@ orbital EntityTableOrbital {
     }
 
     emits {
+      @config.itemClickEvent -> external {
+        id : string!
+        row : @entity!
+      }
+        @description "When set, rows are activatable and emit UI:{itemClickEvent} with { id, row }"
+        @tier "essential"
       VIEW -> external {
         id : string!
         row : @entity!
@@ -227,7 +240,7 @@ orbital EntityTableOrbital {
         @label "Selected Ids"
         @description "Currently selected item IDs"
         @tier "presentation"
-      fields : [EntityTableFieldsItem] = [{ key: "Key", header: "Header", name: "Name", label: "Label", width: "Width", sortable: false }, { key: "Key 2", header: "Header 2", name: "Name 2", label: "Label 2", width: "Width 2", sortable: true }]
+      fields : [EntityTableFieldsItem] = [{ key: "Key", header: "Header", name: "Name", label: "Label", width: "Width", sortable: false, align: left, format: date }, { key: "Key 2", header: "Header 2", name: "Name 2", label: "Label 2", width: "Width 2", sortable: true, align: center, format: currency }]
         @label "Fields"
         @description "Fields to display - accepts string[] or Column[] for unified interface. Alias for columns"
         @tier "presentation"
@@ -235,6 +248,10 @@ orbital EntityTableOrbital {
         @label "Columns"
         @description "Columns can be Column objects or simple string field names"
         @tier "presentation"
+      itemClickEvent : event = "ITEM_CLICK"
+        @label "Item Click Event"
+        @description "When set, rows are activatable and emit UI:{itemClickEvent} with { id, row }"
+        @tier "presentation"
       itemActions : [EntityTableItemActionsItem] = [{ event: VIEW, label: View, variant: ghost }]
         @label "Item Actions"
         @description "Item actions from generated code - maps to rowActions"

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

@@ -14,6 +14,7 @@ orbital FormSectionOrbital {
     defaultValue : ControlValue
     options : [FormSectionFieldsItemOptionsItem]
     values : [string]
+    labels : Map string string
     relation : FormSectionFieldsItemRelation
     min : number
     max : number
@@ -100,6 +101,7 @@ orbital FormSectionOrbital {
     defaultValue : ControlValue
     options : [FormSectionSectionsItemFieldsItemOptionsItem]
     values : [string]
+    labels : Map string string
     relation : FormSectionSectionsItemFieldsItemRelation
     min : number
     max : number

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

@@ -14,6 +14,7 @@ orbital FormOrbital {
     defaultValue : ControlValue
     options : [FormFieldsItemOptionsItem]
     values : [string]
+    labels : Map string string
     relation : FormFieldsItemRelation
     min : number
     max : number
@@ -100,6 +101,7 @@ orbital FormOrbital {
     defaultValue : ControlValue
     options : [FormSectionsItemFieldsItemOptionsItem]
     values : [string]
+    labels : Map string string
     relation : FormSectionsItemFieldsItemRelation
     min : number
     max : number

package/behaviors/lolo/ui/core/organisms/ui-media-gallery.lolo

@@ -58,6 +58,8 @@ orbital MediaGalleryOrbital {
           showUpload: @config.showUpload
           actions: (array/filter @config.actions (fn action (or (= (array/len (object/get @action roles [])) 0) (array/includes (object/get @action roles []) @config.viewerRole))))
           aspectRatio: @config.aspectRatio
+          srcField: @config.srcField
+          captionField: @config.captionField
           type: media-gallery
         })
       INIT -> idle when (not @config.selfFetch)
@@ -83,6 +85,8 @@ orbital MediaGalleryOrbital {
           showUpload: @config.showUpload
           actions: (array/filter @config.actions (fn action (or (= (array/len (object/get @action roles [])) 0) (array/includes (object/get @action roles []) @config.viewerRole))))
           aspectRatio: @config.aspectRatio
+          srcField: @config.srcField
+          captionField: @config.captionField
           type: media-gallery
         })
       MediaGalleryLoaded -> idle
@@ -108,6 +112,8 @@ orbital MediaGalleryOrbital {
           showUpload: @config.showUpload
           actions: (array/filter @config.actions (fn action (or (= (array/len (object/get @action roles [])) 0) (array/includes (object/get @action roles []) @config.viewerRole))))
           aspectRatio: @config.aspectRatio
+          srcField: @config.srcField
+          captionField: @config.captionField
           type: media-gallery
         })
     }
@@ -206,6 +212,14 @@ orbital MediaGalleryOrbital {
         @label "Aspect Ratio"
         @description "Aspect ratio for thumbnails"
         @tier "presentation"
+      srcField : string = src
+        @label "Src Field"
+        @description "Record field holding each image's URL (entity mode). Default `src`."
+        @tier "presentation"
+      captionField : string = caption
+        @label "Caption Field"
+        @description "Record field holding each image's caption (entity mode). Default `caption`."
+        @tier "presentation"
       viewerRole : string = ""
         @label "Viewer's role"
         @description "The viewer's role that each action's `roles` is checked against; bind it at the call site (e.g. `viewerRole: @user.role`). Empty = only actions with no `roles` show."

package/behaviors/lolo/ui/core/organisms/ui-stat-card.lolo

@@ -20,6 +20,12 @@ orbital StatCardOrbital {
     value : string
     icon : icon
     format : string
+    aggregate : "count" | "sum"
+    filter : StatCardMetricsItemFilter
+  }
+  type StatCardMetricsItemFilter = {
+    field : string!
+    equals : string!
   }
 
   entity StatCardItem [runtime] {

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

@@ -44,6 +44,10 @@ orbital TimelineOrbital {
           title: @config.title
           items: @config.items
           fields: @config.fields
+          titleField: @config.titleField
+          descriptionField: @config.descriptionField
+          dateField: @config.dateField
+          statusField: @config.statusField
           itemActions: (array/filter @config.itemActions (fn action (or (= (array/len (object/get @action roles [])) 0) (array/includes (object/get @action roles []) @config.viewerRole))))
           look: @config.look
           type: timeline
@@ -57,6 +61,10 @@ orbital TimelineOrbital {
           title: @config.title
           items: @config.items
           fields: @config.fields
+          titleField: @config.titleField
+          descriptionField: @config.descriptionField
+          dateField: @config.dateField
+          statusField: @config.statusField
           itemActions: (array/filter @config.itemActions (fn action (or (= (array/len (object/get @action roles [])) 0) (array/includes (object/get @action roles []) @config.viewerRole))))
           look: @config.look
           type: timeline
@@ -70,6 +78,10 @@ orbital TimelineOrbital {
           title: @config.title
           items: @config.items
           fields: @config.fields
+          titleField: @config.titleField
+          descriptionField: @config.descriptionField
+          dateField: @config.dateField
+          statusField: @config.statusField
           itemActions: (array/filter @config.itemActions (fn action (or (= (array/len (object/get @action roles [])) 0) (array/includes (object/get @action roles []) @config.viewerRole))))
           look: @config.look
           type: timeline
@@ -110,9 +122,25 @@ orbital TimelineOrbital {
         @label "Items"
         @description "Timeline items"
         @tier "presentation"
-      fields : [string] = ["Item", "Item 2"]
+      fields : [string] = []
         @label "Fields"
-        @description "Fields to display"
+        @description "Entity fields the timeline draws; each slot is named by its own `*Field` prop."
+        @tier "presentation"
+      titleField : string
+        @label "Title Field"
+        @description "Entity field holding each item's title."
+        @tier "presentation"
+      descriptionField : string
+        @label "Description Field"
+        @description "Entity field holding each item's description."
+        @tier "presentation"
+      dateField : string
+        @label "Date Field"
+        @description "Entity field holding each item's date."
+        @tier "presentation"
+      statusField : string
+        @label "Status Field"
+        @description "Entity field holding each item's status (complete | active | pending | error)."
         @tier "presentation"
       itemActions : [TimelineItemActionsItem] = []
         @label "Item Actions"

package/behaviors/lolo/ui/core/templates/ui-auth-layout.lolo

@@ -22,7 +22,7 @@ orbital AuthLayoutOrbital {
     }
 
     config {
-      appName : string = "My App"
+      appName : string
         @label "App Name"
         @description "App name"
         @tier "presentation"

package/behaviors/lolo/ui/core/templates/ui-counter-template.lolo

@@ -76,7 +76,7 @@ orbital CounterTemplateOrbital {
         @label "Reset Event"
         @description "Declarative event key — emits UI:{resetEvent} via bus on reset"
         @tier "presentation"
-      title : string = Counter
+      title : string
         @label "Title"
         @description "Title displayed above the counter"
         @tier "presentation"

package/behaviors/lolo/ui/core/templates/ui-dashboard-layout.lolo

@@ -84,7 +84,7 @@ orbital DashboardLayoutOrbital {
     }
 
     config {
-      appName : string = "{{APP_TITLE}}"
+      appName : string
         @label "App Name"
         @description "App name shown in sidebar"
         @tier "presentation"

package/behaviors/lolo/ui/game/.hand-authored.json

@@ -1,10 +1,10 @@
 {
   "game-shell": {
-    "signature": "aba270d4ed2ee09a",
+    "signature": "354579dbf896ca3f",
     "board": "packages/almadar-std/behaviors/lolo/ui/game/templates/ui-game-shell.lolo"
   },
   "timer-display": {
-    "signature": "6ed079507206072d",
+    "signature": "97c478e49455845f",
     "board": "packages/almadar-std/behaviors/lolo/ui/game/atoms/ui-timer-display.lolo"
   }
 }

package/behaviors/lolo/ui/game/atoms/ui-choice-button.lolo

@@ -51,7 +51,7 @@ orbital ChoiceButtonOrbital {
     }
 
     config {
-      text : string = "Charge forward into the fray"
+      text : string = ""
         @label "Text"
         @description "Choice text content"
         @tier "presentation"

package/behaviors/lolo/ui/game/atoms/ui-dialogue-bubble.lolo

@@ -39,11 +39,11 @@ orbital DialogueBubbleOrbital {
     }
 
     config {
-      speaker : string = Hero
+      speaker : string
         @label "Speaker"
         @description "Speaker name displayed at the top"
         @tier "presentation"
-      text : string = "The dungeon awaits. Choose your path wisely."
+      text : string = ""
         @label "Text"
         @description "Dialogue text content"
         @tier "presentation"

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

@@ -77,7 +77,7 @@ orbital GameMenuOrbital {
     }
 
     config {
-      title : string = "Epic Quest"
+      title : string = ""
         @label "Title"
         @description "Menu title"
         @tier "presentation"

package/behaviors/lolo/ui/game/atoms/ui-score-display.lolo

@@ -68,7 +68,7 @@ orbital ScoreDisplayOrbital {
         @label "Class Name"
         @description "Additional CSS classes"
         @tier "presentation"
-      locale : string = "en-US"
+      locale : string
         @label "Locale"
         @description "Number formatting locale"
         @tier "presentation"