@almadar/std 16.239.0 → 16.241.0

package/behaviors/behaviors-registry.json

@@ -1,5 +1,5 @@
 {
-  "$generated": "2026-10-02T10:40:25.872Z",
+  "$generated": "2026-10-03T12:41:28.438Z",
   "$source": "tools/almadar-pattern-sync/behaviors",
   "$package": "@almadar/std",
   "totalBehaviors": 443,
@@ -26079,6 +26079,19 @@
           ],
           "listenedEvents": [],
           "overridableConfigKeys": [
+            {
+              "key": "addPlacement",
+              "type": "string",
+              "default": "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",
+              "enumValues": [
+                "floating",
+                "inline"
+              ]
+            },
             {
               "key": "boardLook",
               "type": "string",
@@ -26096,6 +26109,35 @@
               "type": "render-ui",
               "default": {
                 "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",
@@ -26296,13 +26338,26 @@
                     ],
                     "type": "data-grid"
                   },
-                  {
-                    "action": "ADD_CARD",
-                    "icon": "plus",
-                    "label": "Add item",
-                    "type": "floating-action-button",
-                    "variant": "primary"
-                  }
+                  [
+                    "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",
@@ -26645,6 +26700,35 @@
               "type": "render-ui",
               "default": {
                 "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",
@@ -26869,13 +26953,26 @@
                     "scrollX": true,
                     "type": "data-grid"
                   },
-                  {
-                    "action": "ADD_CARD",
-                    "icon": "plus",
-                    "label": "Add card",
-                    "type": "floating-action-button",
-                    "variant": "primary"
-                  }
+                  [
+                    "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",
@@ -58881,7 +58978,7 @@
       "topic": "ui/core",
       "family": "ui/core",
       "layer": "UI Patterns",
-      "description": "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.",
+      "description": "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.",
       "defaultOrbitalName": "SiteHeaderOrbital",
       "statePattern": "idle",
       "complexity": {
@@ -59283,6 +59380,16 @@
                   {
                     "actions": [
                       "@trait.SiteHeaderLanguages",
+                      {
+                        "className": [
+                          "if",
+                          "@config.showThemeToggle",
+                          "",
+                          "hidden"
+                        ],
+                        "size": "sm",
+                        "type": "theme-toggle"
+                      },
                       {
                         "action": "NAV_LINK",
                         "actionPayload": {
@@ -59306,6 +59413,7 @@
                         "variant": "primary"
                       }
                     ],
+                    "brandHref": "@config.homeHref",
                     "brandName": "@config.brandName",
                     "className": "hidden lg:flex",
                     "logoSrc": "@config.logoSrc",
@@ -59385,8 +59493,19 @@
                   },
                   {
                     "actions": [
-                      "@trait.SiteHeaderLanguages"
+                      "@trait.SiteHeaderLanguages",
+                      {
+                        "className": [
+                          "if",
+                          "@config.showThemeToggle",
+                          "",
+                          "hidden"
+                        ],
+                        "size": "sm",
+                        "type": "theme-toggle"
+                      }
                     ],
+                    "brandHref": "@config.homeHref",
                     "brandName": "@config.brandName",
                     "className": "lg:hidden",
                     "isMenuOpen": "@entity.menuOpen",
@@ -59580,6 +59699,15 @@
               "label": "Header body",
               "tier": "internal"
             },
+            {
+              "key": "homeHref",
+              "type": "string",
+              "default": "",
+              "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"
+            },
             {
               "key": "languages",
               "type": "[SiteLanguage]",
@@ -59663,6 +59791,15 @@
               "label": "Logo image",
               "description": "Logo URL; empty shows the name only",
               "tier": "presentation"
+            },
+            {
+              "key": "showThemeToggle",
+              "type": "boolean",
+              "default": 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"
             }
           ],
           "capabilities": [],
@@ -63957,7 +64094,8 @@
           },
           {
             "name": "docTagIds",
-            "type": "array"
+            "type": "array",
+            "default": []
           },
           {
             "name": "pendingTagName",
@@ -63966,7 +64104,8 @@
           },
           {
             "name": "pendingNames",
-            "type": "array"
+            "type": "array",
+            "default": []
           }
         ]
       },
@@ -161558,6 +161697,13 @@
               "synonyms": "aria-selected",
               "tier": "presentation"
             },
+            {
+              "key": "brandHref",
+              "type": "string",
+              "label": "Brand Href",
+              "description": "Where the brand (logo + name) links to, usually the home page; empty leaves it unlinked",
+              "tier": "presentation"
+            },
             {
               "key": "brandName",
               "type": "string",

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-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"