@almadar/std 16.235.0 → 16.237.0

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

@@ -3,25 +3,37 @@ app ui-data-list "1.0.0"
 ;; @pattern "data-list"
 orbital DataListOrbital {
     type DataListLoaded = Event { data : [DataListItem] } "DataList rows finished loading; payload.data holds the collection"
+  type DataListEmptyAction = {
+    label : string!
+    event : event
+  }
   type DataListFieldsItem = {
     name : string!
     label : string
     icon : icon
     variant : "h3" | "h4" | "body" | "caption" | "badge" | "small" | "progress"
     format : "date" | "currency" | "number" | "boolean" | "percent"
+    colorMap : Map string DataListFieldsItemColorMapValue
+    labels : Map string string
   }
+  type DataListFieldsItemColorMapValue = "default" | "primary" | "secondary" | "success" | "warning" | "danger" | "error" | "info" | "neutral" | "destructive"
   type DataListColumnsItem = {
     name : string!
     label : string
     icon : icon
     variant : "h3" | "h4" | "body" | "caption" | "badge" | "small" | "progress"
     format : "date" | "currency" | "number" | "boolean" | "percent"
+    colorMap : Map string DataListColumnsItemColorMapValue
+    labels : Map string string
   }
+  type DataListColumnsItemColorMapValue = "default" | "primary" | "secondary" | "success" | "warning" | "danger" | "error" | "info" | "neutral" | "destructive"
   type DataListItemActionsItem = {
     label : string!
     event : event!
     icon : icon
     variant : "primary" | "secondary" | "ghost" | "danger"
+    when : SExpr
+    roles : [string]
   }
   type DataListError = {
     message : string!
@@ -65,10 +77,14 @@ orbital DataListOrbital {
           positionEvent: @config.positionEvent
           dndItemIdField: @config.dndItemIdField
           dndRoot: @config.dndRoot
+          emptyIcon: @config.emptyIcon
+          emptyTitle: @config.emptyTitle
+          emptyDescription: @config.emptyDescription
+          emptyAction: @config.emptyAction
           entity: @entity
           fields: @config.fields
           columns: @config.columns
-          itemActions: @config.itemActions
+          itemActions: (array/filter @config.itemActions (fn action (or (= (array/len (object/get @action roles [])) 0) (array/includes (object/get @action roles []) @config.viewerRole))))
           maxInlineActions: @config.maxInlineActions
           itemClickEvent: @config.itemClickEvent
           gap: @config.gap
@@ -107,10 +123,14 @@ orbital DataListOrbital {
           positionEvent: @config.positionEvent
           dndItemIdField: @config.dndItemIdField
           dndRoot: @config.dndRoot
+          emptyIcon: @config.emptyIcon
+          emptyTitle: @config.emptyTitle
+          emptyDescription: @config.emptyDescription
+          emptyAction: @config.emptyAction
           entity: @entity
           fields: @config.fields
           columns: @config.columns
-          itemActions: @config.itemActions
+          itemActions: (array/filter @config.itemActions (fn action (or (= (array/len (object/get @action roles [])) 0) (array/includes (object/get @action roles []) @config.viewerRole))))
           maxInlineActions: @config.maxInlineActions
           itemClickEvent: @config.itemClickEvent
           gap: @config.gap
@@ -149,10 +169,14 @@ orbital DataListOrbital {
           positionEvent: @config.positionEvent
           dndItemIdField: @config.dndItemIdField
           dndRoot: @config.dndRoot
+          emptyIcon: @config.emptyIcon
+          emptyTitle: @config.emptyTitle
+          emptyDescription: @config.emptyDescription
+          emptyAction: @config.emptyAction
           entity: @payload.data
           fields: @config.fields
           columns: @config.columns
-          itemActions: @config.itemActions
+          itemActions: (array/filter @config.itemActions (fn action (or (= (array/len (object/get @action roles [])) 0) (array/includes (object/get @action roles []) @config.viewerRole))))
           maxInlineActions: @config.maxInlineActions
           itemClickEvent: @config.itemClickEvent
           gap: @config.gap
@@ -250,6 +274,22 @@ orbital DataListOrbital {
         @label "Dnd Root"
         @description "Mark this container as the DnD root for its subtree — descendant zones share one DndContext (cross-container drag). Use on an outer container whose own items are not draggable."
         @tier "presentation"
+      emptyIcon : icon
+        @label "Empty Icon"
+        @description "Domain icon for the empty state."
+        @tier "presentation"
+      emptyTitle : string
+        @label "Empty Title"
+        @description "Specific title ('No orders yet')."
+        @tier "presentation"
+      emptyDescription : string
+        @label "Empty Description"
+        @description "What will appear here once rows exist."
+        @tier "presentation"
+      emptyAction : DataListEmptyAction
+        @label "Empty Action"
+        @description "Create-the-first-item action."
+        @tier "presentation"
       fields : [DataListFieldsItem] = []
         @label "Fields"
         @description "Field definitions for rendering each row. The pattern contract in `@almadar/core/patterns` documents `columns` as the wire-format alias the compiler emits — both names resolve to the same shape here. Pass either."
@@ -366,6 +406,10 @@ orbital DataListOrbital {
         @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"
+      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."
+        @tier "policy"
       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-date-range-picker.lolo

@@ -93,13 +93,13 @@ orbital DateRangePickerOrbital {
         @tier "presentation"
       presets : [DateRangePickerPresetsItem] = []
         @label "Presets"
-        @description "Preset shortcuts. Defaults to the standard finance set (Last 7d / Last 30d / This Month / This Quarter / YTD). Pass an empty array to hide presets entirely."
+        @description "Preset shortcuts. Defaults to the translated standard finance set (Last 7d / Last 30d / This Month / This Quarter / YTD). Pass an empty array to hide presets entirely."
         @tier "presentation"
-      fromLabel : string = From
+      fromLabel : string
         @label "From Label"
         @description "From-input label."
         @tier "presentation"
-      toLabel : string = To
+      toLabel : string
         @label "To Label"
         @description "To-input label."
         @tier "presentation"

package/behaviors/lolo/ui/core/molecules/ui-document-details.lolo

@@ -3,7 +3,7 @@ app ui-document-details "1.0.0"
 ;; @capabilities "document settings, page details, post settings sidebar, metadata panel, document properties, publish settings"
 ;; @pattern "document-details"
 orbital DocumentDetailsOrbital {
-    type DocumentDetailsLoaded = Event { data : [DocumentDetailsItem] } "DocumentDetails rows finished loading; payload.data holds the collection"
+    type DocumentDetailsLoaded = Event { data : DocumentDetailsItem } "DocumentDetails row finished loading; payload.data holds the single row"
   type DocumentDetailsFieldsItem = {
     name : string
     key : string
@@ -12,6 +12,7 @@ orbital DocumentDetailsOrbital {
     icon : icon
     kind : "text" | "boolean" | "select" | "readonly" | "image"
     options : [string]
+    labels : Map string string
     format : "date" | "currency" | "number" | "boolean" | "percent"
     type : string
   }
@@ -28,11 +29,11 @@ orbital DocumentDetailsOrbital {
   }
 
   trait DocumentDetailsRender -> @rebindable DocumentDetailsItem [interaction, instance] {
-    initial: idle
+    initial: resolving
 
-    state idle {
-      INIT -> idle when @config.selfFetch
-        (fetch DocumentDetailsItem { emit: { success: DocumentDetailsLoaded } })
+    state resolving {
+      INIT -> idle when (and @config.selfFetch (!= (str/default ?id "") ""))
+        (fetch DocumentDetailsItem { id: ?id, emit: { success: DocumentDetailsLoaded } })
         (render-ui main {
           entity: @entity
           fields: @config.fields
@@ -42,7 +43,20 @@ orbital DocumentDetailsOrbital {
           className: @config.className
           type: document-details
         })
-      INIT -> idle when (not @config.selfFetch)
+      INIT -> idle when (not (and @config.selfFetch (!= (str/default ?id "") "")))
+        (render-ui main {
+          entity: @entity
+          fields: @config.fields
+          metaCommitEvent: @config.metaCommitEvent
+          relationEvent: @config.relationEvent
+          title: @config.title
+          className: @config.className
+          type: document-details
+        })
+    }
+
+    state idle {
+      INIT -> idle
         (render-ui main {
           entity: @entity
           fields: @config.fields
@@ -79,11 +93,19 @@ orbital DocumentDetailsOrbital {
         @description "Makes relation chips clickable: emitted with { field, id, name } when a hydrated relation value (or one row of a many-relation) is clicked — the host routes it to the linked record's own surface."
         @tier "essential"
       DocumentDetailsLoaded
-        @description "DocumentDetails rows finished loading; payload.data holds the collection."
+        @description "DocumentDetails row finished loading; payload.data holds the single row."
         @synonyms "loaded, fetched, retrieved"
         @tier "essential"
     }
 
+    listens {
+      INIT {
+        id : string
+      }
+        @description "Mount payload; a host that routes to this panel by id (a :id page param) passes it here."
+        @tier "internal"
+    }
+
     config {
       fields : [DocumentDetailsFieldsItem] = []
         @label "Fields"
@@ -106,8 +128,8 @@ orbital DocumentDetailsOrbital {
         @description "className prop"
         @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."
+        @label "Fetch its own row on mount?"
+        @description "true (default) = a mount that carries an id loads that one row (never the collection); a create-mode mount skips the load. false = a composing atom owns the load."
         @tier "internal"
     }
   }

package/behaviors/lolo/ui/core/molecules/ui-document-panel.lolo

@@ -8,6 +8,7 @@ orbital DocumentPanelOrbital {
     event : event
     icon : icon
     variant : "primary" | "secondary" | "ghost" | "danger"
+    roles : [string]
   }
 
   entity DocumentPanelItem [runtime] {
@@ -29,7 +30,7 @@ orbital DocumentPanelOrbital {
           coverImage: @config.coverImage
           icon: @config.icon
           value: @entity.value
-          actions: @config.actions
+          actions: (array/filter @config.actions (fn action (or (= (array/len (object/get @action roles [])) 0) (array/includes (object/get @action roles []) @config.viewerRole))))
           maxInlineActions: @config.maxInlineActions
           editing: @config.editing
           titleCommitEvent: @config.titleCommitEvent
@@ -51,7 +52,7 @@ orbital DocumentPanelOrbital {
           coverImage: @config.coverImage
           icon: @config.icon
           value: @entity.value
-          actions: @config.actions
+          actions: (array/filter @config.actions (fn action (or (= (array/len (object/get @action roles [])) 0) (array/includes (object/get @action roles []) @config.viewerRole))))
           maxInlineActions: @config.maxInlineActions
           editing: @config.editing
           titleCommitEvent: @config.titleCommitEvent
@@ -73,7 +74,7 @@ orbital DocumentPanelOrbital {
           coverImage: @config.coverImage
           icon: @config.icon
           value: @entity.value
-          actions: @config.actions
+          actions: (array/filter @config.actions (fn action (or (= (array/len (object/get @action roles [])) 0) (array/includes (object/get @action roles []) @config.viewerRole))))
           maxInlineActions: @config.maxInlineActions
           editing: @config.editing
           titleCommitEvent: @config.titleCommitEvent
@@ -192,6 +193,10 @@ orbital DocumentPanelOrbital {
         @label "Class Name"
         @description "className prop"
         @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."
+        @tier "policy"
     }
   }
 

package/behaviors/lolo/ui/core/molecules/ui-document-viewer.lolo

@@ -7,6 +7,7 @@ orbital DocumentViewerOrbital {
     event : event
     navigatesTo : string
     variant : "primary" | "secondary" | "ghost"
+    roles : [string]
   }
   type DocumentViewerDocumentsItem = {
     label : string!
@@ -41,7 +42,7 @@ orbital DocumentViewerOrbital {
           showToolbar: @config.showToolbar
           showDownload: @config.showDownload
           showPrint: @config.showPrint
-          actions: @config.actions
+          actions: (array/filter @config.actions (fn action (or (= (array/len (object/get @action roles [])) 0) (array/includes (object/get @action roles []) @config.viewerRole))))
           documents: @config.documents
           isLoading: @config.isLoading
           error: @config.error
@@ -111,6 +112,10 @@ orbital DocumentViewerOrbital {
         @label "Class Name"
         @description "Additional CSS classes"
         @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."
+        @tier "policy"
     }
   }
 

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

@@ -19,6 +19,8 @@ orbital DrawerOrbital {
       OPEN -> open
         (render-ui drawer {
           isOpen: @config.isOpen
+          onExited: @config.onExited
+          contained: @config.contained
           onClose: @config.onClose
           title: @config.title
           children: @config.children
@@ -45,6 +47,9 @@ orbital DrawerOrbital {
     }
 
     emits {
+      @config.onExited -> external { }
+        @description "Fires after the exit animation completes (the drawer is about to unmount)."
+        @tier "essential"
       @config.onClose -> external { }
         @description "Callback when drawer should close (injected by slot wrapper)"
         @tier "essential"
@@ -60,6 +65,14 @@ orbital DrawerOrbital {
         @label "Is Open"
         @description "Whether the drawer is open (defaults to true when rendered by slot wrapper)"
         @tier "presentation"
+      onExited : event = "EXITED"
+        @label "On Exited"
+        @description "Fires after the exit animation completes (the drawer is about to unmount)."
+        @tier "presentation"
+      contained : boolean = false
+        @label "Contained"
+        @description "Render inside the nearest positioned ancestor (a preview frame) instead of over the window."
+        @tier "presentation"
       onClose : event = "CLOSE"
         @label "On Close"
         @description "Callback when drawer should close (injected by slot wrapper)"

package/behaviors/lolo/ui/core/molecules/ui-emoji-picker.lolo

@@ -42,7 +42,7 @@ orbital EmojiPickerOrbital {
         @label "Trigger Icon"
         @description "Icon shown on the trigger button"
         @tier "presentation"
-      triggerLabel : string = "Add emoji"
+      triggerLabel : string
         @label "Trigger Label"
         @description "Accessible label for the trigger button"
         @tier "presentation"

package/behaviors/lolo/ui/core/molecules/ui-feature-card.lolo

@@ -42,7 +42,7 @@ orbital FeatureCardOrbital {
         @label "Href"
         @description "Optional link URL"
         @tier "presentation"
-      linkLabel : string = "Learn more"
+      linkLabel : string
         @label "Link Label"
         @description "Label for the link button"
         @tier "presentation"

package/behaviors/lolo/ui/core/molecules/ui-floating-action-button.lolo

@@ -8,6 +8,7 @@ orbital FloatingActionButtonOrbital {
     icon : icon!
     event : event
     variant : "primary" | "secondary" | "success" | "danger" | "warning"
+    roles : [string]
   }
 
   entity FloatingActionButtonItem [runtime] {
@@ -22,7 +23,7 @@ orbital FloatingActionButtonOrbital {
         (render-ui main {
           action: @config.action
           actionPayload: @config.actionPayload
-          actions: @config.actions
+          actions: (array/filter @config.actions (fn action (or (= (array/len (object/get @action roles [])) 0) (array/includes (object/get @action roles []) @config.viewerRole))))
           icon: @config.icon
           onClick: @config.onClick
           variant: @config.variant
@@ -79,6 +80,10 @@ orbital FloatingActionButtonOrbital {
         @label "Class Name"
         @description "Additional CSS classes"
         @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."
+        @tier "policy"
     }
   }
 

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

@@ -12,6 +12,7 @@ orbital FloatingToolbarOrbital {
     active : boolean
     disabled : boolean
     testId : string
+    roles : [string]
   }
 
   entity FloatingToolbarItem [runtime] {
@@ -24,7 +25,7 @@ orbital FloatingToolbarOrbital {
     state idle {
       INIT -> idle
         (render-ui main {
-          items: @config.items
+          items: (array/filter @config.items (fn action (or (= (array/len (object/get @action roles [])) 0) (array/includes (object/get @action roles []) @config.viewerRole))))
           position: @config.position
           children: @config.children
           className: @config.className
@@ -49,6 +50,10 @@ orbital FloatingToolbarOrbital {
         @label "Class Name"
         @description "Additional CSS classes on the positioned root"
         @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."
+        @tier "policy"
     }
   }
 

package/behaviors/lolo/ui/core/molecules/ui-form-actions.lolo

@@ -15,6 +15,7 @@ orbital FormActionsOrbital {
     event : event
     navigatesTo : string
     variant : string
+    roles : [string]
   }
   type FormActionsFiltersItem = {
     field : string!
@@ -40,7 +41,7 @@ orbital FormActionsOrbital {
         (render-ui main {
           children: @config.children
           primary: @config.primary
-          secondary: @config.secondary
+          secondary: (array/filter @config.secondary (fn action (or (= (array/len (object/get @action roles [])) 0) (array/includes (object/get @action roles []) @config.viewerRole))))
           variant: @config.variant
           orientation: @config.orientation
           className: @config.className
@@ -84,6 +85,10 @@ orbital FormActionsOrbital {
         @label "Look"
         @description "Layer 2 visual treatment for the action-cluster (form-actions) pattern."
         @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."
+        @tier "policy"
     }
   }
 

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

@@ -8,6 +8,7 @@ orbital GanttOrbital {
     from : string!
     to : string!
   }
+  type GanttStatusColorMapValue = "default" | "primary" | "secondary" | "success" | "warning" | "danger" | "error" | "info" | "neutral" | "destructive"
   type GanttError = {
     message : string!
     name : string
@@ -33,6 +34,7 @@ orbital GanttOrbital {
           endField: @config.endField
           durationField: @config.durationField
           statusField: @config.statusField
+          statusColorMap: @config.statusColorMap
           groupField: @config.groupField
           rangeStart: @config.rangeStart
           rangeEnd: @config.rangeEnd
@@ -53,6 +55,7 @@ orbital GanttOrbital {
           endField: @config.endField
           durationField: @config.durationField
           statusField: @config.statusField
+          statusColorMap: @config.statusColorMap
           groupField: @config.groupField
           rangeStart: @config.rangeStart
           rangeEnd: @config.rangeEnd
@@ -73,6 +76,7 @@ orbital GanttOrbital {
           endField: @config.endField
           durationField: @config.durationField
           statusField: @config.statusField
+          statusColorMap: @config.statusColorMap
           groupField: @config.groupField
           rangeStart: @config.rangeStart
           rangeEnd: @config.rangeEnd
@@ -121,7 +125,11 @@ orbital GanttOrbital {
         @tier "presentation"
       statusField : string = status
         @label "Status Field"
-        @description "Row field holding the bar status (drives bar colour). Defaults to `status`."
+        @description "Row field holding the bar status. Defaults to `status`."
+        @tier "presentation"
+      statusColorMap : Map string GanttStatusColorMapValue = { item: default }
+        @label "Status Color Map"
+        @description "Bar colour per exact status value; unmapped statuses are primary bars."
         @tier "presentation"
       groupField : string
         @label "Group Field"

package/behaviors/lolo/ui/core/molecules/ui-graph-canvas.lolo

@@ -41,6 +41,7 @@ orbital GraphCanvasOrbital {
     event : event
     navigatesTo : string
     variant : "primary" | "secondary" | "ghost"
+    roles : [string]
   }
   type GraphCanvasError = {
     message : string!
@@ -128,7 +129,7 @@ orbital GraphCanvasOrbital {
           showLabels: @config.showLabels
           interactive: @config.interactive
           draggable: @config.draggable
-          actions: @config.actions
+          actions: (array/filter @config.actions (fn action (or (= (array/len (object/get @action roles [])) 0) (array/includes (object/get @action roles []) @config.viewerRole))))
           onNodeClick: @config.onNodeClick
           onMarkClick: @config.onMarkClick
           onNodeDoubleClick: @config.onNodeDoubleClick
@@ -268,6 +269,10 @@ orbital GraphCanvasOrbital {
         @label "Class Name"
         @description "Additional CSS classes"
         @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."
+        @tier "policy"
     }
   }
 

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

@@ -5,6 +5,7 @@ orbital ImportPreviewTreeOrbital {
   type ImportPreviewTreeUnitsItem = {
     ref : string!
     targetEntity : string!
+    title : string
     fields : Map string ControlValue!
     parentRef : string
   }
@@ -77,11 +78,11 @@ orbital ImportPreviewTreeOrbital {
         @label "On Cancel"
         @description "Called when the user cancels the staged import"
         @tier "presentation"
-      confirmLabel : string = "Confirm import"
+      confirmLabel : string
         @label "Confirm Label"
         @description "Confirm button label"
         @tier "presentation"
-      cancelLabel : string = Cancel
+      cancelLabel : string
         @label "Cancel Label"
         @description "Cancel button label"
         @tier "presentation"

package/behaviors/lolo/ui/core/molecules/ui-likert-scale.lolo

@@ -45,7 +45,7 @@ orbital LikertScaleOrbital {
         @tier "presentation"
       options : [LikertScaleOptionsItem] = []
         @label "Options"
-        @description "Scale points (defaults to a 5-point agree/disagree set)"
+        @description "Scale points (defaults to a translated 5-point agree/disagree set)"
         @tier "presentation"
       value : scalar
         @label "Value"

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

@@ -3,6 +3,7 @@ app ui-menu "1.0.0"
 ;; @pattern "menu"
 orbital MenuOrbital {
   type MenuItemsItem = {
+    type : "item" | "divider"
     id : string
     label : string!
     icon : icon
@@ -14,6 +15,7 @@ orbital MenuOrbital {
     url : string
     variant : "default" | "danger"
     subMenu : [MenuItemsItem]
+    roles : [string]
   }
 
   entity MenuItem [runtime] {
@@ -27,7 +29,7 @@ orbital MenuOrbital {
       INIT -> idle
         (render-ui main {
           trigger: @config.trigger
-          items: @config.items
+          items: (array/filter @config.items (fn action (or (= (array/len (object/get @action roles [])) 0) (array/includes (object/get @action roles []) @config.viewerRole))))
           position: @config.position
           className: @config.className
           header: @config.header
@@ -61,6 +63,10 @@ orbital MenuOrbital {
         @label "Footer"
         @description "Optional slot rendered below the items."
         @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."
+        @tier "policy"
     }
   }
 

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

@@ -12,6 +12,7 @@ orbital MeterOrbital {
     event : event
     navigatesTo : string
     variant : "primary" | "secondary" | "ghost"
+    roles : [string]
   }
   type MeterError = {
     message : string!
@@ -40,7 +41,7 @@ orbital MeterOrbital {
           segments: @config.segments
           showValue: @config.showValue
           size: @config.size
-          actions: @config.actions
+          actions: (array/filter @config.actions (fn action (or (= (array/len (object/get @action roles [])) 0) (array/includes (object/get @action roles []) @config.viewerRole))))
           isLoading: @config.isLoading
           error: @config.error
           className: @config.className
@@ -105,6 +106,10 @@ orbital MeterOrbital {
         @label "Class Name"
         @description "Additional CSS classes"
         @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."
+        @tier "policy"
     }
   }
 

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

@@ -32,6 +32,7 @@ orbital ModalOrbital {
           closeEvent: @config.closeEvent
           swipeDownToClose: @config.swipeDownToClose
           look: @config.look
+          contained: @config.contained
           type: modal
         })
     }
@@ -117,6 +118,10 @@ orbital ModalOrbital {
         @label "Look"
         @description "Layer 2 visual treatment — orthogonal to the semantic variant."
         @tier "presentation"
+      contained : boolean = false
+        @label "Contained"
+        @description "Render inside the nearest positioned ancestor (a preview frame) instead of portaling over the whole window; page scroll is left alone."
+        @tier "presentation"
     }
   }