@almadar/std 16.239.0 → 16.241.0

package/behaviors/registry/ui/core/atoms/std-board.orb

@@ -412,6 +412,18 @@
         {
           "category": "interaction",
           "config": {
+            "addPlacement": {
+              "default": "floating",
+              "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.",
+              "label": "Add button placement",
+              "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",
+              "type": "string",
+              "values": [
+                "floating",
+                "inline"
+              ]
+            },
             "boardLook": {
               "default": "columns",
               "description": "Layer 3 body layout: default N-column data-grid ('columns'), or a Trello-style wide-column kanban with sticky column headers ('kanban-classic').",
@@ -426,6 +438,35 @@
             "bodyContent": {
               "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",
@@ -626,13 +667,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",
@@ -958,6 +1012,35 @@
             "kanbanClassicBodyContent": {
               "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",
@@ -1182,13 +1265,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",

package/behaviors/registry/ui/core/atoms/std-site-header.orb

@@ -1,5 +1,5 @@
 {
-  "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.",
   "ledger": {
     "entries": {
       "ent_01M3B9EHRNR3JQPJSD36PH5QV8": {
@@ -166,6 +166,16 @@
                   {
                     "actions": [
                       "@trait.SiteHeaderLanguages",
+                      {
+                        "className": [
+                          "if",
+                          "@config.showThemeToggle",
+                          "",
+                          "hidden"
+                        ],
+                        "size": "sm",
+                        "type": "theme-toggle"
+                      },
                       {
                         "action": "NAV_LINK",
                         "actionPayload": {
@@ -189,6 +199,7 @@
                         "variant": "primary"
                       }
                     ],
+                    "brandHref": "@config.homeHref",
                     "brandName": "@config.brandName",
                     "className": "hidden lg:flex",
                     "logoSrc": "@config.logoSrc",
@@ -268,8 +279,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",
@@ -464,6 +486,14 @@
               "tier": "internal",
               "type": "render-ui"
             },
+            "homeHref": {
+              "default": "",
+              "description": "Where the brand (logo + name) links to, usually the site's home page; empty leaves the brand unlinked",
+              "label": "Home link",
+              "synonyms": "logo link, home page, brand link",
+              "tier": "presentation",
+              "type": "string"
+            },
             "languages": {
               "default": [],
               "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.",
@@ -544,6 +574,14 @@
               "label": "Logo image",
               "tier": "presentation",
               "type": "string"
+            },
+            "showThemeToggle": {
+              "default": false,
+              "description": "Show a button that switches the site between its light and dark mode",
+              "label": "Light/dark toggle",
+              "synonyms": "dark mode, theme switch, color mode",
+              "tier": "presentation",
+              "type": "boolean"
             }
           },
           "effectRow": [

package/behaviors/registry/ui/core/atoms/std-tag-strip.orb

@@ -175,6 +175,7 @@
             "type": "string"
           },
           {
+            "default": [],
             "description": "The open record's current tag ids, stashed at SHOW_TAG_STRIP for membership tests.",
             "intrinsic": true,
             "items": {
@@ -193,6 +194,7 @@
             "type": "string"
           },
           {
+            "default": [],
             "description": "The chip names remaining after a remove, held across the resolve fetch.",
             "intrinsic": true,
             "items": {

package/behaviors/registry/ui/core/atoms/std-tag-taxonomy.orb

@@ -317,6 +317,10 @@
               "payloadSchema": [
                 {
                   "name": "tagId",
+                  "projectedFrom": {
+                    "field": "id",
+                    "type": "Tag"
+                  },
                   "required": true,
                   "type": "string"
                 }
@@ -394,6 +398,10 @@
               "payloadSchema": [
                 {
                   "name": "tagId",
+                  "projectedFrom": {
+                    "field": "id",
+                    "type": "Tag"
+                  },
                   "required": true,
                   "type": "string"
                 }
@@ -439,6 +447,10 @@
               "payloadSchema": [
                 {
                   "name": "tagId",
+                  "projectedFrom": {
+                    "field": "id",
+                    "type": "Tag"
+                  },
                   "type": "string"
                 }
               ],
@@ -522,6 +534,10 @@
                 "payloadSchema": [
                   {
                     "name": "tagId",
+                    "projectedFrom": {
+                      "field": "id",
+                      "type": "Tag"
+                    },
                     "type": "string"
                   }
                 ],
@@ -606,6 +622,10 @@
                 "payloadSchema": [
                   {
                     "name": "tagId",
+                    "projectedFrom": {
+                      "field": "id",
+                      "type": "Tag"
+                    },
                     "required": true,
                     "type": "string"
                   }
@@ -731,6 +751,10 @@
                 "payloadSchema": [
                   {
                     "name": "tagId",
+                    "projectedFrom": {
+                      "field": "id",
+                      "type": "Tag"
+                    },
                     "required": true,
                     "type": "string"
                   }

package/behaviors/registry/ui/core/atoms/std-version-history.orb

@@ -1563,7 +1563,14 @@
                                   "variant": "caption"
                                 },
                                 {
-                                  "content": "@entity.createdAt",
+                                  "content": [
+                                    "time/format",
+                                    [
+                                      "time/parse",
+                                      "@entity.createdAt"
+                                    ],
+                                    "MMM D, YYYY"
+                                  ],
                                   "type": "typography",
                                   "variant": "body"
                                 }

package/behaviors/registry/ui/core/molecules/ui-header.orb

@@ -211,6 +211,12 @@
               "tier": "presentation",
               "type": "boolean"
             },
+            "brandHref": {
+              "description": "Where the brand (logo + name) links to, usually the home page; empty leaves it unlinked",
+              "label": "Brand Href",
+              "tier": "presentation",
+              "type": "string"
+            },
             "brandName": {
               "default": "KFlow",
               "description": "Brand/App name",
@@ -710,6 +716,7 @@
                       "aria-live": "@config.ariaLive",
                       "aria-pressed": "@config.ariaPressed",
                       "aria-selected": "@config.ariaSelected",
+                      "brandHref": "@config.brandHref",
                       "brandName": "@config.brandName",
                       "className": "@config.className",
                       "dir": "@config.dir",

package/canonical-operators.json

@@ -1,7 +1,7 @@
 {
   "version": "2.0.0",
   "description": "Canonical operator registry for Almadar. Generated from @almadar/std/modules. Consumed by orbital-compiler via include_str!.",
-  "generated": "2026-09-30T13:21:17.771Z",
+  "generated": "2026-10-03T09:14:54.097Z",
   "categories": {
     "arithmetic": {
       "description": "Numeric operations",
@@ -100,6 +100,13 @@
         "rust"
       ]
     },
+    "std-i18n": {
+      "description": "Message catalogs",
+      "target": [
+        "ts",
+        "rust"
+      ]
+    },
     "std-async": {
       "description": "Async utilities (runtime only)",
       "target": [
@@ -2938,6 +2945,7 @@
         }
       },
       "runsOn": "server",
+      "entityArgPosition": 0,
       "title": "Fetch",
       "params": [
         {
@@ -3990,6 +3998,31 @@
       ],
       "docsSource": "generated"
     },
+    "i18n/t": {
+      "category": "std-i18n",
+      "minArity": 1,
+      "maxArity": 2,
+      "returnType": "string",
+      "description": "The active locale's message for a catalog key, with {{placeholders}} filled from params",
+      "module": "i18n",
+      "params": [
+        {
+          "name": "key",
+          "type": "string",
+          "description": "Catalog key (a string literal)"
+        },
+        {
+          "name": "params",
+          "type": "object",
+          "description": "Values for the message {{placeholders}}",
+          "optional": true
+        }
+      ],
+      "examples": [
+        "(i18n/t \"posts.count\" {\"n\":3}) // => \"3 posts\""
+      ],
+      "docsSource": "generated"
+    },
     "if": {
       "category": "logic",
       "minArity": 3,
@@ -6350,6 +6383,7 @@
         }
       },
       "runsOn": "server",
+      "entityArgPosition": 1,
       "title": "Persist",
       "params": [
         {

package/dist/behaviors/exports-reader.js

@@ -17198,6 +17198,18 @@ function stdBoardBoardOrbital(params = {}) {
       {
         "category": "interaction",
         "config": {
+          "addPlacement": {
+            "default": "floating",
+            "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.",
+            "label": "Add button placement",
+            "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",
+            "type": "string",
+            "values": [
+              "floating",
+              "inline"
+            ]
+          },
           "boardLook": {
             "default": "columns",
             "description": "Layer 3 body layout: default N-column data-grid ('columns'), or a Trello-style wide-column kanban with sticky column headers ('kanban-classic').",
@@ -17212,6 +17224,35 @@ function stdBoardBoardOrbital(params = {}) {
           "bodyContent": {
             "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",
@@ -17412,13 +17453,26 @@ function stdBoardBoardOrbital(params = {}) {
                   ],
                   "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",
@@ -17744,6 +17798,35 @@ function stdBoardBoardOrbital(params = {}) {
           "kanbanClassicBodyContent": {
             "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",
@@ -17968,13 +18051,26 @@ function stdBoardBoardOrbital(params = {}) {
                   "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",
@@ -103963,6 +104059,10 @@ function stdTagTaxonomyTagTaxonomyOrbital(params = {}) {
             "payloadSchema": [
               {
                 "name": "tagId",
+                "projectedFrom": {
+                  "field": "id",
+                  "type": "Tag"
+                },
                 "required": true,
                 "type": "string"
               }
@@ -104037,6 +104137,10 @@ function stdTagTaxonomyTagTaxonomyOrbital(params = {}) {
             "payloadSchema": [
               {
                 "name": "tagId",
+                "projectedFrom": {
+                  "field": "id",
+                  "type": "Tag"
+                },
                 "required": true,
                 "type": "string"
               }
@@ -104079,6 +104183,10 @@ function stdTagTaxonomyTagTaxonomyOrbital(params = {}) {
             "payloadSchema": [
               {
                 "name": "tagId",
+                "projectedFrom": {
+                  "field": "id",
+                  "type": "Tag"
+                },
                 "type": "string"
               }
             ],
@@ -104154,6 +104262,10 @@ function stdTagTaxonomyTagTaxonomyOrbital(params = {}) {
               "payloadSchema": [
                 {
                   "name": "tagId",
+                  "projectedFrom": {
+                    "field": "id",
+                    "type": "Tag"
+                  },
                   "type": "string"
                 }
               ],
@@ -104234,6 +104346,10 @@ function stdTagTaxonomyTagTaxonomyOrbital(params = {}) {
               "payloadSchema": [
                 {
                   "name": "tagId",
+                  "projectedFrom": {
+                    "field": "id",
+                    "type": "Tag"
+                  },
                   "required": true,
                   "type": "string"
                 }
@@ -104351,6 +104467,10 @@ function stdTagTaxonomyTagTaxonomyOrbital(params = {}) {
               "payloadSchema": [
                 {
                   "name": "tagId",
+                  "projectedFrom": {
+                    "field": "id",
+                    "type": "Tag"
+                  },
                   "required": true,
                   "type": "string"
                 }
@@ -111851,7 +111971,14 @@ function stdVersionHistoryRevisionOrbital(params = {}) {
                                 "variant": "caption"
                               },
                               {
-                                "content": "@entity.createdAt",
+                                "content": [
+                                  "time/format",
+                                  [
+                                    "time/parse",
+                                    "@entity.createdAt"
+                                  ],
+                                  "MMM D, YYYY"
+                                ],
                                 "type": "typography",
                                 "variant": "body"
                               }