@almadar/std 16.141.0 → 16.142.0

package/behaviors/lolo/ui/avl/molecules/ui-module-card.lolo

@@ -1,5 +1,5 @@
 app ui-module-card "1.0.0"
-"ModuleCard — a card summarizing one course module or lesson with progress and entry point."
+"ModuleCard — a card summarizing one course module or lesson with progress and entry point. — UI factory (1:1 with the @almadar/ui module-card pattern)."
 ;; @capabilities "course module card, lesson card, curriculum unit card, learning-path step card"
 orbital ModuleCardOrbital {
   entity ModuleCardItem [runtime] {

package/behaviors/lolo/ui/core/atoms/std-app-search.lolo

@@ -12,6 +12,27 @@ orbital AppSearchOrbital {
     searchTerm : string @intrinsic @description "The current search query the user submitted." @synonyms "query, term, q" = ""
   }
 
+  trait AppSearchIdleHint -> AppSearchTarget [interaction, instance] {
+    initial: idle
+
+    state idle {
+      INIT -> idle
+        (render-ui main {
+          type: stack
+          align: center
+          direction: vertical
+          gap: sm
+          className: "py-12"
+          children: [{ type: icon, name: search, size: lg, color: muted }, {
+            type: typography
+            variant: caption
+            color: muted
+            content: "Start typing to search"
+          }]
+        })
+    }
+  }
+
   trait AppSearch -> @rebindable AppSearchTarget [interaction, collection] {
     initial: idle
 
@@ -161,7 +182,7 @@ orbital AppSearchOrbital {
     }
 
     config {
-      idleContent : trait
+      idleContent : trait = @trait.AppSearchIdleHint
         @label "Idle content"
         @description "The normal content view (e.g. the data ledger/browse trait) shown when no search is active."
         @tier "presentation"

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

@@ -30,6 +30,10 @@ orbital BrowseItemOrbital {
       itemActions: @config.itemActions
       pageSize: @config.displayPageSize
     }
+
+    listens {
+      BrowseItemBrowse.BrowseItemLoaded -> DataGridLoaded
+    }
   }
 
   trait DenseTableView = TableView.traits.TableViewRender -> BrowseItem {
@@ -42,6 +46,10 @@ orbital BrowseItemOrbital {
       pageSize: @config.displayPageSize
       selectable: true
     }
+
+    listens {
+      BrowseItemBrowse.BrowseItemLoaded -> TableViewLoaded
+    }
   }
 
   trait BrowseItemBrowse -> @rebindable BrowseItem [interaction, collection] {
@@ -461,6 +469,8 @@ orbital BrowseItemOrbital {
           entity: ?data
           fields: []
           gap: lg
+          itemActions: @config.itemActions
+          maxInlineActions: @config.maxInlineActions
           minCardWidth: 260
           renderItem: (fn item {
             children: [{

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

@@ -16,6 +16,7 @@ orbital FilterTargetOrbital {
         (fetch FilterTarget {})
         (render-ui main {
           entity: FilterTarget
+          event: @config.event
           filters: @config.filters
           look: @config.filterBarLook
           type: filter-group
@@ -25,6 +26,7 @@ orbital FilterTargetOrbital {
         (set @entity.value ?value)
         (render-ui main {
           entity: FilterTarget
+          event: @config.event
           filters: @config.filters
           look: @config.filterBarLook
           type: filter-group
@@ -38,6 +40,7 @@ orbital FilterTargetOrbital {
         })
         (render-ui main {
           entity: FilterTarget
+          event: @config.event
           filters: @config.filters
           look: @config.filterBarLook
           type: filter-group

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

@@ -3,16 +3,6 @@ app std-wizard "3.0.1"
 type ObjectSpec = { id : string, label : string, value : string }
 type StepSpec = { label : string!, key : string, icon : string, description : string, fields : [string], allowedRoles : [string] }
 orbital WizardOrbital {
-    uses Icon from "std/behaviors/ui-icon"
-    uses Typography from "std/behaviors/ui-typography"
-    uses Button from "std/behaviors/ui-button"
-    uses Card from "std/behaviors/ui-card"
-    uses LoadingState from "std/behaviors/ui-loading-state"
-    uses ErrorState from "std/behaviors/ui-error-state"
-    uses WizardProgress from "std/behaviors/ui-wizard-progress"
-    uses FormSection from "std/behaviors/ui-form-section"
-    uses WizardNavigation from "std/behaviors/ui-wizard-navigation"
-
     type WizardStep = { id : string!, title : string!, description : string }
 
     type WizardLoaded = Event { data : [ObjectSpec] } "Fired when wizard context finishes loading"
@@ -46,240 +36,6 @@ orbital WizardOrbital {
     errorMessage : string @description "Error message displayed when a process fails." @synonyms "error, fault, problem" = ""
   }
 
-  trait Icon_ListChecks = Icon.traits.IconRender -> WizardView {
-    config {
-      name: list-checks
-    }
-  }
-
-  trait Icon_CheckCircle = Icon.traits.IconRender -> WizardView {
-    config {
-      name: check-circle
-    }
-  }
-
-  trait Icon_XCircle = Icon.traits.IconRender -> WizardView {
-    config {
-      name: x-circle
-    }
-  }
-
-  trait Icon_CurrentStep = Icon.traits.IconRender -> WizardView {
-    config {
-      name: @entity.currentStepIcon
-      size: lg
-    }
-  }
-
-  trait Icon_ChevronLeft = Icon.traits.IconRender -> WizardView {
-    config {
-      name: chevron-left
-    }
-  }
-
-  trait Icon_X = Icon.traits.IconRender -> WizardView {
-    config {
-      name: x
-    }
-  }
-
-  trait Icon_ChevronRight = Icon.traits.IconRender -> WizardView {
-    config {
-      name: chevron-right
-    }
-  }
-
-  trait Icon_RotateCcw = Icon.traits.IconRender -> WizardView {
-    config {
-      name: rotate-ccw
-    }
-  }
-
-  trait Typography_Title = Typography.traits.TypographyRender -> WizardView {
-    config {
-      content: @config.title
-      variant: h3
-    }
-  }
-
-  trait Typography_CurrentStepLabel = Typography.traits.TypographyRender -> WizardView {
-    config {
-      content: @entity.currentStepLabel
-      variant: h2
-    }
-  }
-
-  trait Typography_CurrentStepDescription = Typography.traits.TypographyRender -> WizardView {
-    config {
-      color: muted
-      content: @entity.currentStepDescription
-      variant: body
-    }
-  }
-
-  trait Typography_Complete = Typography.traits.TypographyRender -> WizardView {
-    config {
-      align: center
-      content: Complete
-      variant: h2
-    }
-  }
-
-  trait Typography_CompleteMessage = Typography.traits.TypographyRender -> WizardView {
-    config {
-      align: center
-      color: muted
-      content: @entity.completionMessage
-      variant: body
-    }
-  }
-
-  trait Typography_Cancelled = Typography.traits.TypographyRender -> WizardView {
-    config {
-      align: center
-      content: Cancelled
-      variant: h2
-    }
-  }
-
-  trait Typography_CancelledMessage = Typography.traits.TypographyRender -> WizardView {
-    config {
-      align: center
-      color: muted
-      content: "The wizard was cancelled. No data was submitted."
-      variant: body
-    }
-  }
-
-  trait Typography_SignUp = Typography.traits.TypographyRender -> WizardView {
-    config {
-      content: Sign-up
-      variant: h3
-    }
-  }
-
-  trait Button_Back = Button.traits.ButtonRender -> WizardView {
-    config {
-      action: RETREAT
-      disabled: @entity.isFirstStep
-      icon: chevron-left
-      label: Back
-      variant: ghost
-    }
-  }
-
-  trait Button_CancelWizard = Button.traits.ButtonRender -> WizardView {
-    config {
-      action: CANCEL
-      icon: x
-      label: "Cancel wizard"
-      variant: ghost
-    }
-  }
-
-  trait Button_Advance = Button.traits.ButtonRender -> WizardView {
-    config {
-      action: ADVANCE
-      icon: @entity.primaryActionIcon
-      label: @entity.primaryActionLabel
-      variant: primary
-    }
-  }
-
-  trait Button_Restart = Button.traits.ButtonRender -> WizardView {
-    config {
-      action: RESTART
-      icon: rotate-ccw
-      label: "Start a new wizard"
-      variant: secondary
-    }
-  }
-
-  trait Button_RestartGhost = Button.traits.ButtonRender -> WizardView {
-    config {
-      action: RESTART
-      icon: rotate-ccw
-      label: "Start a new wizard"
-      variant: ghost
-    }
-  }
-
-  trait WizardProgress_Main = WizardProgress.traits.WizardProgressRender -> WizardView {
-    config {
-      allowNavigation: false
-      currentStep: @entity.currentStepIndex
-      steps: @entity.wizardSteps
-    }
-  }
-
-  trait WizardProgress_TotalSteps = WizardProgress.traits.WizardProgressRender -> WizardView {
-    config {
-      allowNavigation: false
-      currentStep: @entity.totalSteps
-      steps: @entity.wizardSteps
-    }
-  }
-
-  trait FormSection_Main = FormSection.traits.FormSectionRender -> WizardView {
-    config {
-      cancelEvent: CANCEL
-      fields: @entity.currentFields
-      mode: edit
-      showCancel: false
-      showSubmit: false
-      submitEvent: ADVANCE
-    }
-  }
-
-  trait WizardNavigation_Main = WizardNavigation.traits.WizardNavigationRender -> WizardView {
-    config {
-      currentStep: 0
-      onNext: NEXT
-      showBack: false
-      showComplete: false
-      showNext: true
-      totalSteps: 3
-    }
-  }
-
-  trait LoadingState_Loading = LoadingState.traits.LoadingStateRender -> WizardView {
-    config {
-      title: "Loading wizard…"
-    }
-  }
-
-  trait LoadingState_Refreshing = LoadingState.traits.LoadingStateRender -> WizardView {
-    config {
-      title: "Refreshing…"
-    }
-  }
-
-  trait LoadingState_Restarting = LoadingState.traits.LoadingStateRender -> WizardView {
-    config {
-      title: "Restarting…"
-    }
-  }
-
-  trait LoadingState_Retrying = LoadingState.traits.LoadingStateRender -> WizardView {
-    config {
-      title: "Retrying…"
-    }
-  }
-
-  trait ErrorState_LoadFailed = ErrorState.traits.ErrorStateRender -> WizardView {
-    config {
-      message: @entity.errorMessage
-      title: "Failed to load"
-    }
-  }
-
-  trait ErrorState_SaveFailed = ErrorState.traits.ErrorStateRender -> WizardView {
-    config {
-      message: @entity.errorMessage
-      title: "Save failed"
-    }
-  }
-
   trait WizardForm -> @rebindable WizardView [interaction, instance] {
     initial: loading
 

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

@@ -1,5 +1,5 @@
 app ui-aside "1.0.0"
-"Aside — a secondary side panel that hosts navigation links or supplementary content alongside a main content area."
+"Aside — a secondary side panel that hosts navigation links or supplementary content alongside a main content area. — UI factory (1:1 with the @almadar/ui aside pattern)."
 ;; @capabilities "settings navigation sidebar, preferences menu panel, account settings nav, secondary panel, side navigation rail"
 orbital AsideOrbital {
   entity AsideItem [runtime] {

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

@@ -44,11 +44,11 @@ orbital TypographyOrbital {
         @label "Align"
         @description "Text alignment"
         @tier "presentation"
-      weight : "light" | "normal" | "medium" | "semibold" | "bold" = light
+      weight : "none" | "light" | "normal" | "medium" | "semibold" | "bold" = none
         @label "Weight"
         @description "Font weight override"
         @tier "presentation"
-      size : "xs" | "sm" | "md" | "lg" | "xl" | "2xl" | "3xl" = xs
+      size : "none" | "xs" | "sm" | "md" | "lg" | "xl" | "2xl" | "3xl" = none
         @label "Size"
         @description "Font size override"
         @tier "presentation"

package/behaviors/lolo/ui/core/molecules/ui-code-block.lolo

@@ -10,7 +10,7 @@ orbital CodeBlockOrbital {
   type CodeBlockFilesItem = {
     label : string!
     code : string!
-    language : "text" | "json" | "javascript" | "js" | "typescript" | "ts" | "jsx" | "tsx" | "css" | "markdown" | "md" | "bash" | "shell" | "sh" | "yaml" | "yml" | "rust" | "python" | "py" | "sql" | "diff" | "toml" | "go" | "graphql" | "html" | "xml" | "orb" | "lolo"
+    language : "text" | "json" | "javascript" | "js" | "typescript" | "ts" | "jsx" | "tsx" | "css" | "markdown" | "md" | "bash" | "shell" | "sh" | "yaml" | "yml" | "rust" | "python" | "py" | "sql" | "diff" | "toml" | "go" | "graphql" | "html" | "xml" | "clojure" | "clj" | "edn" | "haskell" | "hs" | "lisp" | "scheme" | "scala" | "elixir" | "ex" | "exs" | "erlang" | "erl" | "elm" | "fsharp" | "fs" | "fsx" | "ocaml" | "ml" | "java" | "c" | "cpp" | "c++" | "cc" | "cxx" | "hpp" | "h" | "csharp" | "cs" | "objectivec" | "objc" | "php" | "ruby" | "rb" | "swift" | "kotlin" | "kt" | "lua" | "r" | "dart" | "julia" | "fortran" | "f90" | "f95" | "perl" | "pl" | "powershell" | "ps1" | "makefile" | "make" | "nginx" | "ini" | "orb" | "lolo"
   }
   type CodeBlockActionsItem = {
     label : string!
@@ -107,9 +107,9 @@ orbital CodeBlockOrbital {
         @label "Code"
         @description "The code content to display"
         @tier "presentation"
-      language : "text" | "json" | "javascript" | "js" | "typescript" | "ts" | "jsx" | "tsx" | "css" | "markdown" | "md" | "bash" | "shell" | "sh" | "yaml" | "yml" | "rust" | "python" | "py" | "sql" | "diff" | "toml" | "go" | "graphql" | "html" | "xml" | "orb" | "lolo" = text
+      language : string = text
         @label "Language"
-        @description "Programming language for syntax highlighting"
+        @description "Programming language for syntax highlighting (any Prism id; loaded on demand if not pre-registered)"
         @tier "presentation"
       showCopyButton : boolean = true
         @label "Show Copy Button"

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

@@ -1,5 +1,5 @@
 app ui-data-grid "1.0.0"
-"DataGrid — structured records grid rendering rows over configurable columns, with sort, select, and drag-reorder."
+"DataGrid — structured records grid rendering rows over configurable columns, with sort, select, and drag-reorder. — UI factory (1:1 with the @almadar/ui data-grid pattern)."
 ;; @capabilities "admin table, records grid, user list, CRUD list, manage-records view, spreadsheet-style data grid, sortable columns"
 orbital DataGridOrbital {
     type DataGridLoaded = Event { data : [DataGridItem] } "DataGrid rows finished loading; payload.data holds the collection"

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

@@ -65,9 +65,9 @@ orbital DrawerOrbital {
         @label "On Close"
         @description "Callback when drawer should close (injected by slot wrapper)"
         @tier "presentation"
-      title : string
+      title : node
         @label "Title"
-        @description "Drawer title"
+        @description "Drawer title (text or any node, e.g. a brand logo + name)."
         @tier "presentation"
       children : node
         @label "Children"

package/behaviors/lolo/ui/core/molecules/ui-filter-group.lolo

@@ -1,5 +1,5 @@
 app ui-filter-group "1.0.0"
-"FilterGroup — a panel of filter controls that narrows a collection by field values."
+"FilterGroup — a panel of filter controls that narrows a collection by field values. — UI factory (1:1 with the @almadar/ui filter-group pattern)."
 ;; @capabilities "search refinement panel, facet filters, admin list filters, records filter sidebar, filter chips panel"
 orbital FilterGroupOrbital {
   type FilterGroupFiltersItem = {

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

@@ -1,5 +1,5 @@
 app ui-flip-card "1.0.0"
-"FlipCard — flip card that reveals a hidden back face on tap or click, toggling between a front and back content slot."
+"FlipCard — flip card that reveals a hidden back face on tap or click, toggling between a front and back content slot. — UI factory (1:1 with the @almadar/ui flip-card pattern)."
 ;; @capabilities "flashcard, study deck, spaced-repetition review card, memorization drill, quiz reveal card, question/answer card, before/after reveal, term-and-definition card"
 orbital FlipCardOrbital {
   entity FlipCardItem [runtime] {

package/behaviors/lolo/ui/core/molecules/ui-quiz-block.lolo

@@ -1,5 +1,5 @@
 app ui-quiz-block "1.0.0"
-"QuizBlock — a single quiz question with answer choices and submit/reveal feedback."
+"QuizBlock — a single quiz question with answer choices and submit/reveal feedback. — UI factory (1:1 with the @almadar/ui quiz-block pattern)."
 ;; @capabilities "multiple-choice quiz, test question, exam item, assessment question, knowledge check, trivia question"
 orbital QuizBlockOrbital {
   entity QuizBlockItem [runtime] {

package/behaviors/lolo/ui/core/molecules/ui-repeatable-form-section.lolo

@@ -1,5 +1,5 @@
 app ui-repeatable-form-section "1.0.0"
-"RepeatableFormSection — a form section that repeats a fixed group of fields, letting the user add or remove entries."
+"RepeatableFormSection — a form section that repeats a fixed group of fields, letting the user add or remove entries. — UI factory (1:1 with the @almadar/ui repeatable-form-section pattern)."
 ;; @capabilities "dynamic line items, repeatable field group, add/remove entry rows, multi-entry form block"
 orbital RepeatableFormSectionOrbital {
   type RepeatableFormSectionItemsItem = {

package/behaviors/lolo/ui/core/molecules/ui-signature-pad.lolo

@@ -1,5 +1,5 @@
 app ui-signature-pad "1.0.0"
-"SignaturePad — a draw-to-sign canvas that captures a handwritten signature or initials."
+"SignaturePad — a draw-to-sign canvas that captures a handwritten signature or initials. — UI factory (1:1 with the @almadar/ui signature-pad pattern)."
 ;; @capabilities "e-signature capture, sign-here field, consent signature, initial-here field, wet-signature substitute"
 orbital SignaturePadOrbital {
   type SignaturePadError = {

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

@@ -1,5 +1,5 @@
 app ui-sortable-list "1.0.0"
-"SortableList — a drag-and-drop reorderable list of items."
+"SortableList — a drag-and-drop reorderable list of items. — UI factory (1:1 with the @almadar/ui sortable-list pattern)."
 ;; @capabilities "checklist, task list, to-do list, priority list, ranked list, drag-to-reorder queue"
 orbital SortableListOrbital {
     type SortableListLoaded = Event { data : [SortableListItem] } "SortableList rows finished loading; payload.data holds the collection"

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

@@ -1,5 +1,5 @@
 app ui-table-view "1.0.0"
-"TableView — sortable, selectable data table rendering rows over configurable columns, with inline row actions and grouping."
+"TableView — sortable, selectable data table rendering rows over configurable columns, with inline row actions and grouping. — UI factory (1:1 with the @almadar/ui table-view pattern)."
 ;; @capabilities "admin console table, records list, CRUD data table, user list, manage-users grid, sortable columns, row selection with bulk actions, grouped list view"
 orbital TableViewOrbital {
     type TableViewLoaded = Event { data : [TableViewItem] } "TableView rows finished loading; payload.data holds the collection"

package/behaviors/lolo/ui/core/organisms/ui-segment-renderer.lolo

@@ -1,16 +1,6 @@
 app ui-segment-renderer "1.0.0"
 "SegmentRenderer — UI factory (1:1 with the @almadar/ui segment-renderer pattern)."
 orbital SegmentRendererOrbital {
-  type SegmentRendererSegmentsItem = {
-    type : json!
-    content : string!
-  }
-  type SegmentRendererUserProgress = {
-    activationResponse : string
-    reflectionNotes : [string]
-    bloomAnswered : Map string boolean
-  }
-
   entity SegmentRendererItem [runtime] {
     id : string!
   }
@@ -30,7 +20,7 @@ orbital SegmentRendererOrbital {
     }
 
     config {
-      segments : [SegmentRendererSegmentsItem] = [{ type: "Type", content: "Content" }, { type: "Type 2", content: "Content 2" }]
+      segments : [json] = []
         @label "Segments"
         @description "Parsed lesson segments (see `parseLessonSegments`)"
         @tier "presentation"
@@ -42,7 +32,7 @@ orbital SegmentRendererOrbital {
         @label "Container Class Name"
         @description "CSS classes for the outer wrapping div"
         @tier "presentation"
-      userProgress : SegmentRendererUserProgress
+      userProgress : json = {}
         @label "User Progress"
         @description "User progress for restoring activation/reflection state"
         @tier "presentation"

package/behaviors/lolo/ui/marketing/atoms/ui-marketing-stat-card.lolo

@@ -1,5 +1,5 @@
 app ui-marketing-stat-card "1.0.0"
-"MarketingStatCard — a single number-highlight card pairing a large value with a label and trend delta."
+"MarketingStatCard — a single number-highlight card pairing a large value with a label and trend delta. — UI factory (1:1 with the @almadar/ui marketing-stat-card pattern)."
 ;; @capabilities "KPI card, metric tile, dashboard stat card, number card, big-number widget, stat highlight, key metric callout"
 orbital MarketingStatCardOrbital {
   entity MarketingStatCardItem [runtime] {

package/behaviors/lolo/ui/marketing/molecules/ui-case-study-card.lolo

@@ -1,5 +1,5 @@
 app ui-case-study-card "1.0.0"
-"CaseStudyCard — a card summarizing a customer case study with logo, headline result, and link."
+"CaseStudyCard — a card summarizing a customer case study with logo, headline result, and link. — UI factory (1:1 with the @almadar/ui case-study-card pattern)."
 ;; @capabilities "customer story, success story, client story card, results showcase, proof-point card"
 orbital CaseStudyCardOrbital {
   entity CaseStudyCardItem [runtime] {

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

@@ -1,5 +1,5 @@
 app ui-feature-card "1.0.0"
-"FeatureCard — an icon-led card pairing a title and description to call out a single product feature."
+"FeatureCard — an icon-led card pairing a title and description to call out a single product feature. — UI factory (1:1 with the @almadar/ui feature-card pattern)."
 ;; @capabilities "feature highlight, benefit callout, product capability card, feature-grid tile"
 orbital FeatureCardOrbital {
   entity FeatureCardItem [runtime] {

package/behaviors/lolo/ui/marketing/molecules/ui-pricing-card.lolo

@@ -1,5 +1,5 @@
 app ui-pricing-card "1.0.0"
-"PricingCard — a single pricing-tier card with price, billing period, feature list, and call-to-action."
+"PricingCard — a single pricing-tier card with price, billing period, feature list, and call-to-action. — UI factory (1:1 with the @almadar/ui pricing-card pattern)."
 ;; @capabilities "pricing tier, plan card, subscription tier, plan comparison card, price plan"
 orbital PricingCardOrbital {
   type PricingCardAction = {