@almadar/std 16.239.0 → 16.242.0

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

@@ -587,6 +587,11 @@ orbital BoardOrbital {
         @label "Group-by field"
         @description "Entity field whose value matches a column key — items are filtered into columns by it. Default 'stage'; set to 'status' (or any field) for entities that track state under a different name."
         @tier "presentation"
+      addPlacement : "floating" | "inline" = floating
+        @label "Add button placement"
+        @description "Where the add-item button sits: 'floating' (default) pins a floating action button to the screen corner; 'inline' renders an ordinary Add button above the columns, for a board embedded in a card or panel."
+        @synonyms "add button position, floating add, inline add, add item button placement. user phrases: 'put the add button inside the board' / 'no floating button' -> inline"
+        @tier "presentation"
       boardLook : "columns" | "kanban-classic" = columns
         @label "Board look"
         @description "Layer 3 body layout: default N-column data-grid ('columns'), or a Trello-style wide-column kanban with sticky column headers ('kanban-classic')."
@@ -647,7 +652,24 @@ orbital BoardOrbital {
         @description "Actions row of the open-card panel. Default is the Delete button only. Override to add consumer-wired actions — e.g. an Edit button with action: EDIT_CARD and actionPayload: { id: @entity.currentId, row: @entity.currentRow }, listened to by the organism's edit modal. Never leave a button here without a listener."
         @tier "presentation"
       bodyContent : render-ui = {
-        children: [(if @config.showHeader {
+        children: [(if ["=", @config.addPlacement, "inline"] {
+          children: [{
+            action: ADD_CARD
+            icon: plus
+            label: "Add item"
+            size: sm
+            type: button
+            variant: secondary
+          }]
+          direction: horizontal
+          gap: sm
+          justify: end
+          type: stack
+        } {
+          children: []
+          gap: none
+          type: stack
+        }), (if @config.showHeader {
           children: [{
             align: center
             children: [{ name: kanban-square, size: lg, type: icon }, {
@@ -770,13 +792,17 @@ orbital BoardOrbital {
             type: card
           })
           type: data-grid
-        }, {
+        }, (if ["=", @config.addPlacement, "floating"] {
           action: ADD_CARD
           icon: plus
           label: "Add item"
           type: floating-action-button
           variant: primary
-        }]
+        } {
+          children: []
+          gap: none
+          type: stack
+        })]
         direction: vertical
         gap: md
         type: stack
@@ -785,7 +811,24 @@ orbital BoardOrbital {
         @description "Render-ui SExpr rendered after the board loads for boardLook='columns' — the canonical column data-grid with nested per-column data-lists. boardLook='kanban-classic' renders kanbanClassicBodyContent instead; both share this trait's state machine, emits, and listens."
         @tier "internal"
       kanbanClassicBodyContent : render-ui = {
-        children: [(if @config.showHeader {
+        children: [(if ["=", @config.addPlacement, "inline"] {
+          children: [{
+            action: ADD_CARD
+            icon: plus
+            label: "Add card"
+            size: sm
+            type: button
+            variant: secondary
+          }]
+          direction: horizontal
+          gap: sm
+          justify: end
+          type: stack
+        } {
+          children: []
+          gap: none
+          type: stack
+        }), (if @config.showHeader {
           children: [{
             align: center
             children: [{ name: kanban-square, size: xl, type: icon }, {
@@ -931,13 +974,17 @@ orbital BoardOrbital {
           })
           scrollX: true
           type: data-grid
-        }, {
+        }, (if ["=", @config.addPlacement, "floating"] {
           action: ADD_CARD
           icon: plus
           label: "Add card"
           type: floating-action-button
           variant: primary
-        }]
+        } {
+          children: []
+          gap: none
+          type: stack
+        })]
         className: h-full
         direction: vertical
         gap: md

package/behaviors/lolo/ui/core/atoms/std-book-reader.lolo

@@ -17,8 +17,16 @@ orbital BookReaderOrbital {
     initial: cover
 
     state cover {
-      INIT -> cover
+      INIT -> cover when (== @config.opensAt "cover")
         (render-ui main @config.coverContent)
+      INIT -> reading when (== @config.opensAt "reading")
+        (set @entity.chapterIndex 0)
+        (set @entity.chapterTitle (object/get (array/nth @config.chapters 0) title ""))
+        (set @entity.chapterContent (object/get (array/nth @config.chapters 0) content ""))
+        (set @entity.isFirst true)
+        (set @entity.isLast (<= (array/len @config.chapters) 1))
+        (set @entity.progressLabel (str/concat "1 / " (array/len @config.chapters)))
+        (render-ui main @config.readingContent)
       START_READING -> reading
         (set @entity.chapterIndex 0)
         (set @entity.chapterTitle (object/get (array/nth @config.chapters 0) title ""))
@@ -92,6 +100,10 @@ orbital BookReaderOrbital {
     }
 
     config {
+      opensAt : "cover" | "reading" = "cover"
+        @label "Opens at"
+        @description "Where the reader opens: the cover, or straight into the first chapter (an article read in place)"
+        @tier "presentation"
       title : string = "Untitled book"
         @label "Title"
         @tier "presentation"
@@ -236,6 +248,18 @@ orbital BookReaderOrbital {
               align: start
               className: "lg:sticky lg:top-6 self-start"
               children: [{
+                type: typography
+                content: @config.title
+                variant: h5
+                weight: semibold
+                className: "text-balance"
+              }, {
+                type: typography
+                content: @config.author
+                variant: caption
+                color: muted
+                className: (if (== @config.author "") hidden "pb-2")
+              }, {
                 type: button
                 variant: link
                 label: @config.coverLabel

package/behaviors/lolo/ui/core/atoms/std-card-grid.lolo

@@ -85,6 +85,15 @@ orbital CardGridOrbital {
                     variant: h4
                     weight: semibold
                     align: (if (== @config.look profile) center left)
+                    className: (if (== (object/get @item href "") "") "" hidden)
+                  }, {
+                    type: button
+                    label: (object/get @item title "")
+                    href: (object/get @item href "")
+                    variant: link
+                    action: CARD_OPEN
+                    actionPayload: { href: (object/get @item href ""), title: (object/get @item title "") }
+                    className: (if (== (object/get @item href "") "") hidden "text-lg font-semibold text-foreground whitespace-normal text-start")
                   }, {
                     type: typography
                     content: (object/get @item meta "")

package/behaviors/lolo/ui/core/atoms/std-doc-page.lolo

@@ -0,0 +1,153 @@
+app std-doc-page "1.0.0"
+"std-doc-page — one page of a documentation site: a section sidebar with the current page marked, a breadcrumb, the page title and lede, an \"on this page\" contents list, the page's own content (a render slot the call site fills, live behaviors included) and previous/next links. Supports right-to-left pages. Pick for docs sites, handbooks, reference manuals and knowledge bases."
+type DocNavItem = { label : string!, href : string, items : [DocNavItem], active : boolean }
+type DocCrumb = { label : string!, href : string }
+type DocTocEntry = { id : string!, label : string!, level : number! }
+type DocLink = { label : string!, href : string!, category : string }
+orbital DocPageOrbital {
+
+  entity DocPageView [runtime] {
+    id : string!
+  }
+
+  trait DocPageRender -> @rebindable DocPageView [interaction, instance] {
+    initial: idle
+
+    state idle {
+      INIT -> idle
+        (render-ui main {
+          type: box
+          paddingY: lg
+          fullWidth: true
+          dir: @config.direction
+          children: [{
+            type: container
+            size: xl
+            maxWidth: xl
+            padding: lg
+            children: [{
+              type: split
+              ratio: "1:4"
+              gap: xl
+              children: [{
+                type: stack
+                direction: vertical
+                gap: sm
+                className: "lg:sticky lg:top-6 self-start"
+                children: [{
+                  type: typography
+                  content: @config.sidebarLabel
+                  variant: label
+                  weight: semibold
+                  className: (if (== @config.sidebarLabel "") hidden "px-3")
+                }, {
+                  type: doc-sidebar
+                  items: @config.navItems
+                  aria-label: @config.sidebarLabel
+                }]
+              }, {
+                type: stack
+                direction: vertical
+                gap: lg
+                className: "min-w-0"
+                children: [{
+                  type: doc-breadcrumb
+                  items: @config.crumbs
+                  className: (if (== (array/len @config.crumbs) 0) hidden "")
+                }, {
+                  type: stack
+                  direction: vertical
+                  gap: sm
+                  children: [{
+                    type: typography
+                    content: @config.title
+                    variant: h1
+                    weight: bold
+                    className: "tracking-tight text-balance"
+                  }, {
+                    type: typography
+                    content: @config.lede
+                    variant: large
+                    color: muted
+                    className: (if (== @config.lede "") hidden "max-w-3xl text-pretty")
+                  }]
+                }, {
+                  type: box
+                  bg: muted
+                  padding: md
+                  rounded: lg
+                  className: (if (== (array/len @config.toc) 0) hidden "")
+                  children: [{
+                    type: stack
+                    direction: vertical
+                    gap: xs
+                    children: [{
+                      type: typography
+                      content: @config.tocLabel
+                      variant: label
+                      weight: semibold
+                    }, {
+                      type: doc-toc
+                      items: @config.toc
+                      aria-label: @config.tocLabel
+                    }]
+                  }]
+                }, @config.content, {
+                  type: divider
+                }, {
+                  type: doc-pagination
+                  prev: (if (== (object/get @config.prev href "") "") null @config.prev)
+                  next: (if (== (object/get @config.next href "") "") null @config.next)
+                }]
+              }]
+            }]
+          }]
+        })
+    }
+
+    config {
+      title : string = "Untitled page"
+        @label "Title"
+        @tier "presentation"
+      lede : string = ""
+        @label "Lede"
+        @description "One or two sentences under the title; empty hides it"
+        @tier "presentation"
+      content : render-ui = { type: stack, direction: vertical, gap: lg, children: [] }
+        @label "Content"
+        @description "The page body: markdown, code and live behaviors (trait references) in reading order"
+        @tier "presentation"
+      navItems : [DocNavItem] = []
+        @label "Sidebar"
+        @description "The documentation tree; mark the current page active"
+        @tier "presentation"
+      sidebarLabel : string = "Documentation"
+        @label "Sidebar label"
+        @tier "presentation"
+      crumbs : [DocCrumb] = []
+        @label "Breadcrumb"
+        @description "Ancestors first, the current page last without a link; empty hides it"
+        @tier "presentation"
+      toc : [DocTocEntry] = []
+        @label "On this page"
+        @description "Anchors of the page's sections (each section declares the same id); empty hides it"
+        @tier "presentation"
+      tocLabel : string = "On this page"
+        @label "Contents label"
+        @tier "presentation"
+      prev : DocLink = { label: "", href: "" }
+        @label "Previous page"
+        @description "Empty href hides it"
+        @tier "presentation"
+      next : DocLink = { label: "", href: "" }
+        @label "Next page"
+        @description "Empty href hides it"
+        @tier "presentation"
+      direction : "ltr" | "rtl" = "ltr"
+        @label "Direction"
+        @tier "presentation"
+    }
+  }
+
+  page "/doc" as DocPage -> DocPageRender
+}

package/behaviors/lolo/ui/core/atoms/std-site-header.lolo

@@ -1,5 +1,5 @@
 app std-site-header "1.0.0"
-"std-site-header — the sticky top bar of a public website: brand (logo + name), navigation links with the current page marked (a link with children opens a dropdown), an optional language picker (std-language-picker: the same page in each language, default language at the root and the others under /<code>/), and an optional call-to-action button. On small screens the links fold into a menu opened by a toggle, with child links indented under their parent and the call-to-action button at the bottom. Links follow `href` (in-app path, #anchor, or absolute URL); the header action and the small-screen menu links also emit NAV_CLICKED { href, label }. Pick for marketing sites, docs portals and product websites; for signed-in app chrome use std-app-layout."
+"std-site-header — the sticky top bar of a public website: brand (logo + name, linking home when `homeHref` is set), navigation links with the current page marked (a link with children opens a dropdown), an optional light/dark toggle, an optional language picker (std-language-picker: the same page in each language, default language at the root and the others under /<code>/), and an optional call-to-action button. On small screens the links fold into a menu opened by a toggle, with child links indented under their parent and the call-to-action button at the bottom. Links follow `href` (in-app path, #anchor, or absolute URL); the header action and the small-screen menu links also emit NAV_CLICKED { href, label }. Pick for marketing sites, docs portals and product websites; for signed-in app chrome use std-app-layout."
 type SiteNavLink = { label : string!, href : string!, children : [SiteNavLink] }
 type SiteLanguage = { code : string!, label : string!, href : string! }
 orbital SiteHeaderOrbital {
@@ -54,6 +54,11 @@ orbital SiteHeaderOrbital {
         @label "Logo image"
         @description "Logo URL; empty shows the name only"
         @tier "presentation"
+      homeHref : string = ""
+        @label "Home link"
+        @description "Where the brand (logo + name) links to, usually the site's home page; empty leaves the brand unlinked"
+        @synonyms "logo link, home page, brand link"
+        @tier "presentation"
       links : [SiteNavLink] = [{ label: "Features", href: "/features" }, { label: "Pricing", href: "/pricing" }, { label: "About", href: "/about" }]
         @label "Navigation links"
         @synonyms "menu, nav items, top navigation"
@@ -67,6 +72,11 @@ orbital SiteHeaderOrbital {
         @description "Every language this page exists in, each named in its own language, with the href of THIS page in that language (default language at the root, others under /<code>/). Empty hides the language picker."
         @synonyms "locales, translations, language switcher, i18n"
         @tier "presentation"
+      showThemeToggle : boolean = false
+        @label "Light/dark toggle"
+        @description "Show a button that switches the site between its light and dark mode"
+        @synonyms "dark mode, theme switch, color mode"
+        @tier "presentation"
       currentLanguage : string = "en"
         @label "Current language"
         @description "The code of the language this page is in"
@@ -92,6 +102,7 @@ orbital SiteHeaderOrbital {
           showMenuToggle: false
           brandName: @config.brandName
           logoSrc: @config.logoSrc
+          brandHref: @config.homeHref
           className: "hidden lg:flex"
           navigationItems: (array/map @config.links (fn entry {
             label: (object/get @entry label "")
@@ -103,7 +114,7 @@ orbital SiteHeaderOrbital {
               active: (== (object/get @child href "") @config.currentPath)
             }))
           }))
-          actions: [@trait.SiteHeaderLanguages, {
+          actions: [@trait.SiteHeaderLanguages, { type: theme-toggle, size: sm, className: (if @config.showThemeToggle "" hidden) }, {
             type: button
             label: @config.actionLabel
             href: @config.actionHref
@@ -122,8 +133,9 @@ orbital SiteHeaderOrbital {
           onMenuToggle: MENU_TOGGLE
           brandName: @config.brandName
           logoSrc: @config.logoSrc
+          brandHref: @config.homeHref
           className: "lg:hidden"
-          actions: [@trait.SiteHeaderLanguages]
+          actions: [@trait.SiteHeaderLanguages, { type: theme-toggle, size: sm, className: (if @config.showThemeToggle "" hidden) }]
         }, {
           type: stack
           direction: vertical

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

@@ -19,9 +19,9 @@ orbital TagStripOrbital {
     createdAt : string = ""
     pendingId : string = ""
     docId : string @intrinsic @description "The open record's id, stashed at SHOW_TAG_STRIP so commits know which row to update." @synonyms "record id, scope id" = ""
-    docTagIds : [string] @intrinsic @description "The open record's current tag ids, stashed at SHOW_TAG_STRIP for membership tests." @synonyms "attached tags, current tags"
+    docTagIds : [string] @intrinsic @description "The open record's current tag ids, stashed at SHOW_TAG_STRIP for membership tests." @synonyms "attached tags, current tags" = []
     pendingTagName : string @intrinsic @description "The tag name typed or clicked on add, held across the resolve fetch." @synonyms "typed tag, adding tag" = ""
-    pendingNames : [string] @intrinsic @description "The chip names remaining after a remove, held across the resolve fetch." @synonyms "remaining tags, kept names"
+    pendingNames : [string] @intrinsic @description "The chip names remaining after a remove, held across the resolve fetch." @synonyms "remaining tags, kept names" = []
   }
 
   trait TagStrip -> @rebindable StripTag [interaction, collection] {

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

@@ -5,7 +5,7 @@ orbital TagTaxonomyOrbital {
 
     type TagLoadFailed = Event { error : string, code : string } "Fired when the tag collection fails to load"
 
-    type TagSelected = Event { tagId : string! } "Fired when a tag is selected to drill into its children"
+    type TagSelected = Event { tagId : Tag.id! } "Fired when a tag is selected to drill into its children"
 
     type TagCreated = Event Tag "Fired after a new tag row persists — the payload IS the created row (flat: ?id, ?name, ?parentId)"
 
@@ -476,7 +476,7 @@ orbital TagTaxonomyOrbital {
 
     emits {
       SELECT_TAG {
-        tagId : string!
+        tagId : Tag.id!
       }
         @description "Signals a tag has been chosen for navigation."
         @synonyms "choose, pick, activate, navigate"
@@ -495,7 +495,7 @@ orbital TagTaxonomyOrbital {
         @synonyms "error, failed, problem, issue"
         @tier "internal"
       TagSelected {
-        tagId : string!
+        tagId : Tag.id!
       }
         @description "Signals a tag has been chosen for further exploration."
         @synonyms "chosen, picked, activated, highlighted"
@@ -512,7 +512,7 @@ orbital TagTaxonomyOrbital {
         @synonyms "cancel, back"
         @tier "internal"
       LEVEL_RELOAD {
-        tagId : string
+        tagId : Tag.id
       }
         @description "Internal hop that refetches the open level after the new-category form closes (a fetch filter cannot read trait state, so the level travels by payload)."
         @synonyms "reload level, refresh"
@@ -532,7 +532,7 @@ orbital TagTaxonomyOrbital {
 
     listens {
       SELECT_TAG {
-        tagId : string!
+        tagId : Tag.id!
       }
         @description "A tag in the taxonomy was selected for navigation."
         @synonyms "choose, pick, activate, navigate"
@@ -551,7 +551,7 @@ orbital TagTaxonomyOrbital {
         @synonyms "error, failure, load failed"
         @tier "internal"
       TagSelected {
-        tagId : string!
+        tagId : Tag.id!
       }
         @description "A tag in the taxonomy has been chosen by the user."
         @synonyms "chosen, picked, activated, selected"
@@ -571,7 +571,7 @@ orbital TagTaxonomyOrbital {
         @synonyms "cancel, back"
         @tier "internal"
       LEVEL_RELOAD {
-        tagId : string
+        tagId : Tag.id
       }
         @description "Refetch the open level."
         @synonyms "reload level, refresh"

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

@@ -168,7 +168,7 @@ orbital RevisionOrbital {
                 type: typography
                 variant: caption
               }, {
-                content: @entity.createdAt
+                content: (time/format (time/parse @entity.createdAt) "MMM D, YYYY")
                 type: typography
                 variant: body
               }]

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

@@ -50,6 +50,7 @@ orbital HeaderOrbital {
           variant: @config.variant
           look: @config.look
           onLogoClick: @config.onLogoClick
+          brandHref: @config.brandHref
           className: @config.className
           isLoading: @config.isLoading
           error: @config.error
@@ -164,6 +165,10 @@ orbital HeaderOrbital {
         @label "On Logo Click"
         @description "Callback when logo/brand is clicked"
         @tier "presentation"
+      brandHref : string
+        @label "Brand Href"
+        @description "Where the brand (logo + name) links to, usually the home page; empty leaves it unlinked"
+        @tier "presentation"
       className : string
         @label "Class Name"
         @description "Additional CSS classes"