@almadar/std 16.238.0 → 16.241.0

package/behaviors/registry/ui/core/atoms/std-panel-launcher.orb

@@ -0,0 +1,312 @@
+{
+  "description": "std-panel-launcher — a floating button on the page that opens a side panel holding one trait (an assistant, a help panel, a cart). Closed: the button floats bottom-right. Open: the panel shows `contentTrait` under `title` and the button steps aside; the panel's close button (or Escape on small screens) brings the button back. The panel slot defaults to `dock`, which pushes the page aside on wide screens and becomes a side sheet below 1024px. List the trait on every page that should carry the button — it never injects itself.",
+  "ledger": {
+    "entries": {
+      "ent_01M3WBAV2PJNY2ACS5PHE6N0AA": {
+        "bakedName": "PanelLauncherView",
+        "curName": "PanelLauncherView",
+        "id": "ent_01M3WBAV2PJNY2ACS5PHE6N0AA",
+        "kind": "entity",
+        "owner": "workspace",
+        "renames": []
+      },
+      "evt_01M3WBAV2P3BNZ0MEAYB63SNE6": {
+        "bakedName": "CLOSE",
+        "curName": "CLOSE",
+        "id": "evt_01M3WBAV2P3BNZ0MEAYB63SNE6",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M3WBAV2P82ATESF1QEKT8CWS",
+        "renames": []
+      },
+      "evt_01M3WBAV2P4BPXCKRY9TXD0WVW": {
+        "bakedName": "INIT",
+        "curName": "INIT",
+        "id": "evt_01M3WBAV2P4BPXCKRY9TXD0WVW",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M3WBAV2P82ATESF1QEKT8CWS",
+        "renames": []
+      },
+      "evt_01M3WBAV2P90F9YFP7AD881QG6": {
+        "bakedName": "OPEN",
+        "curName": "OPEN",
+        "id": "evt_01M3WBAV2P90F9YFP7AD881QG6",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M3WBAV2P82ATESF1QEKT8CWS",
+        "renames": []
+      },
+      "orb_01M3WBAV2PZ1ERRJH9ATZH3PKE": {
+        "bakedName": "PanelLauncherOrbital",
+        "curName": "PanelLauncherOrbital",
+        "id": "orb_01M3WBAV2PZ1ERRJH9ATZH3PKE",
+        "kind": "orbital",
+        "owner": "workspace",
+        "renames": []
+      },
+      "pag_01M3WBAV2PRS42Z6KEPS3P4GAR": {
+        "bakedName": "PanelLauncherPage",
+        "curName": "PanelLauncherPage",
+        "id": "pag_01M3WBAV2PRS42Z6KEPS3P4GAR",
+        "kind": "page",
+        "owner": "workspace",
+        "renames": []
+      },
+      "trt_01M3WBAV2P82ATESF1QEKT8CWS": {
+        "bakedName": "PanelLauncher",
+        "curName": "PanelLauncher",
+        "id": "trt_01M3WBAV2P82ATESF1QEKT8CWS",
+        "kind": "trait",
+        "owner": "workspace",
+        "renames": []
+      }
+    },
+    "schemaVersion": 1
+  },
+  "name": "std-panel-launcher",
+  "orbitals": [
+    {
+      "entity": {
+        "fields": [
+          {
+            "name": "id",
+            "required": true,
+            "type": "string"
+          }
+        ],
+        "id": "ent_01M3WBAV2PJNY2ACS5PHE6N0AA",
+        "name": "PanelLauncherView",
+        "persistence": "runtime"
+      },
+      "id": "orb_01M3WBAV2PZ1ERRJH9ATZH3PKE",
+      "name": "PanelLauncherOrbital",
+      "pages": [
+        {
+          "id": "pag_01M3WBAV2PRS42Z6KEPS3P4GAR",
+          "name": "PanelLauncherPage",
+          "path": "/panel-launcher",
+          "traits": [
+            {
+              "ref": "PanelLauncher",
+              "refId": "trt_01M3WBAV2P82ATESF1QEKT8CWS"
+            }
+          ]
+        }
+      ],
+      "traits": [
+        {
+          "category": "interaction",
+          "config": {
+            "closeLabel": {
+              "default": "Close panel",
+              "label": "Close button label",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "contentTrait": {
+              "description": "The trait the panel shows when it is open.",
+              "label": "What does the panel hold?",
+              "synonyms": "panel content, body, assistant, chat",
+              "tier": "presentation",
+              "type": "trait"
+            },
+            "icon": {
+              "default": "message-circle",
+              "label": "Button icon",
+              "tier": "presentation",
+              "type": "icon"
+            },
+            "label": {
+              "default": "Open panel",
+              "description": "What the floating button does, read to screen readers and shown as its tooltip.",
+              "label": "Button label",
+              "synonyms": "aria label, button name, tooltip",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "panelSlot": {
+              "default": "dock",
+              "description": "`dock` pushes the page aside (a side sheet on small screens); `drawer` slides over it.",
+              "label": "Where the panel opens",
+              "tier": "presentation",
+              "type": "slot"
+            },
+            "title": {
+              "default": "Panel",
+              "description": "Heading at the top of the open panel.",
+              "label": "Panel title",
+              "tier": "presentation",
+              "type": "string"
+            }
+          },
+          "effectRow": [
+            {
+              "kind": "render-ui",
+              "resolved": false,
+              "resource": "@config.panelSlot"
+            },
+            {
+              "kind": "render-ui",
+              "resource": "floating"
+            }
+          ],
+          "emits": [
+            {
+              "description": "Open the panel.",
+              "event": "OPEN",
+              "eventId": "evt_01M3WBAV2P90F9YFP7AD881QG6",
+              "synonyms": "show, launch, expand",
+              "tier": "presentation"
+            },
+            {
+              "description": "Close the panel.",
+              "event": "CLOSE",
+              "eventId": "evt_01M3WBAV2P3BNZ0MEAYB63SNE6",
+              "synonyms": "hide, dismiss, collapse",
+              "tier": "presentation"
+            }
+          ],
+          "entityContract": {
+            "provides": [],
+            "requires": []
+          },
+          "entityRebindable": true,
+          "entityRefIds": {
+            "PanelLauncherView": "ent_01M3WBAV2PJNY2ACS5PHE6N0AA"
+          },
+          "id": "trt_01M3WBAV2P82ATESF1QEKT8CWS",
+          "linkedEntity": "PanelLauncherView",
+          "linkedEntityId": "ent_01M3WBAV2PJNY2ACS5PHE6N0AA",
+          "name": "PanelLauncher",
+          "scope": "instance",
+          "stateMachine": {
+            "events": [
+              {
+                "id": "evt_01M3WBAV2P4BPXCKRY9TXD0WVW",
+                "key": "INIT",
+                "name": "Initialize"
+              },
+              {
+                "description": "Open the panel.",
+                "id": "evt_01M3WBAV2P90F9YFP7AD881QG6",
+                "key": "OPEN",
+                "name": "Open",
+                "synonyms": "show, launch, expand",
+                "tier": "presentation"
+              },
+              {
+                "description": "Close the panel.",
+                "id": "evt_01M3WBAV2P3BNZ0MEAYB63SNE6",
+                "key": "CLOSE",
+                "name": "Close",
+                "synonyms": "hide, dismiss, collapse",
+                "tier": "presentation"
+              }
+            ],
+            "states": [
+              {
+                "isInitial": true,
+                "name": "closed"
+              },
+              {
+                "name": "open"
+              }
+            ],
+            "transitions": [
+              {
+                "effects": [
+                  [
+                    "render-ui",
+                    "floating",
+                    {
+                      "action": "OPEN",
+                      "icon": "@config.icon",
+                      "label": "@config.label",
+                      "type": "floating-action-button"
+                    }
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01M3WBAV2P4BPXCKRY9TXD0WVW",
+                "from": "closed",
+                "to": "closed"
+              },
+              {
+                "effects": [
+                  [
+                    "render-ui",
+                    "floating",
+                    null
+                  ],
+                  [
+                    "render-ui",
+                    "@config.panelSlot",
+                    {
+                      "children": [
+                        {
+                          "align": "center",
+                          "children": [
+                            {
+                              "content": "@config.title",
+                              "type": "typography",
+                              "variant": "h4"
+                            },
+                            {
+                              "action": "CLOSE",
+                              "aria-label": "@config.closeLabel",
+                              "icon": "x",
+                              "type": "button",
+                              "variant": "ghost"
+                            }
+                          ],
+                          "direction": "horizontal",
+                          "justify": "between",
+                          "type": "stack"
+                        },
+                        "@config.contentTrait"
+                      ],
+                      "className": "h-full min-h-0 p-4",
+                      "direction": "vertical",
+                      "gap": "md",
+                      "type": "stack"
+                    }
+                  ]
+                ],
+                "event": "OPEN",
+                "eventId": "evt_01M3WBAV2P90F9YFP7AD881QG6",
+                "from": "closed",
+                "to": "open"
+              },
+              {
+                "effects": [
+                  [
+                    "render-ui",
+                    "@config.panelSlot",
+                    null
+                  ],
+                  [
+                    "render-ui",
+                    "floating",
+                    {
+                      "action": "OPEN",
+                      "icon": "@config.icon",
+                      "label": "@config.label",
+                      "type": "floating-action-button"
+                    }
+                  ]
+                ],
+                "event": "CLOSE",
+                "eventId": "evt_01M3WBAV2P3BNZ0MEAYB63SNE6",
+                "from": "open",
+                "to": "closed"
+              }
+            ]
+          }
+        }
+      ]
+    }
+  ],
+  "schemaVersion": 1,
+  "version": "1.0.0"
+}

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-stats.orb

@@ -786,7 +786,7 @@
                             "type": "stack"
                           }
                         ],
-                        "className": "rounded-lg border border-[var(--color-border)] bg-[var(--color-card)] p-card-md shadow-elevation-sm hover:shadow-elevation-md transition-shadow min-h-[180px]",
+                        "className": "surface-content p-card-md hover:shadow-elevation-dialog transition-shadow min-h-[180px]",
                         "direction": "vertical",
                         "gap": "sm",
                         "type": "stack"

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/atoms/ui-animated-graphic.orb

@@ -359,6 +359,24 @@
                 "treeitem"
               ]
             },
+            "skeleton": {
+              "description": "Skeleton shown while this element's server render is in flight: a shape (`table`, `list`, …), `{ variant, rows?, columns?, fields? }`, or `none`.",
+              "label": "Skeleton",
+              "tier": "presentation",
+              "type": "string",
+              "values": [
+                "header",
+                "table",
+                "list",
+                "grid",
+                "detail",
+                "stats",
+                "form",
+                "card",
+                "text",
+                "none"
+              ]
+            },
             "src": {
               "default": "https://almadar-kflow-assets.web.app/shared/ui-roguelike-board/default/units/player.png",
               "description": "URL to an SVG file. Fetched and inlined to enable stroke/fill animations.",
@@ -455,6 +473,7 @@
                       "height": "@config.height",
                       "lang": "@config.lang",
                       "role": "@config.role",
+                      "skeleton": "@config.skeleton",
                       "src": "@config.src",
                       "strokeColor": "@config.strokeColor",
                       "svgContent": "@config.svgContent",

package/behaviors/registry/ui/core/atoms/ui-animated-reveal.orb

@@ -357,6 +357,24 @@
                 "treeitem"
               ]
             },
+            "skeleton": {
+              "description": "Skeleton shown while this element's server render is in flight: a shape (`table`, `list`, …), `{ variant, rows?, columns?, fields? }`, or `none`.",
+              "label": "Skeleton",
+              "tier": "presentation",
+              "type": "string",
+              "values": [
+                "header",
+                "table",
+                "list",
+                "grid",
+                "detail",
+                "stats",
+                "form",
+                "card",
+                "text",
+                "none"
+              ]
+            },
             "tabIndex": {
               "description": "0 puts the element in the Tab order; -1 makes it focusable only programmatically.",
               "label": "Tab Index",
@@ -446,6 +464,7 @@
                       "lang": "@config.lang",
                       "once": "@config.once",
                       "role": "@config.role",
+                      "skeleton": "@config.skeleton",
                       "tabIndex": "@config.tabIndex",
                       "threshold": "@config.threshold",
                       "trigger": "@config.trigger",

package/behaviors/registry/ui/core/atoms/ui-aside.orb

@@ -306,6 +306,24 @@
                 "treeitem"
               ]
             },
+            "skeleton": {
+              "description": "Skeleton shown while this element's server render is in flight: a shape (`table`, `list`, …), `{ variant, rows?, columns?, fields? }`, or `none`.",
+              "label": "Skeleton",
+              "tier": "presentation",
+              "type": "string",
+              "values": [
+                "header",
+                "table",
+                "list",
+                "grid",
+                "detail",
+                "stats",
+                "form",
+                "card",
+                "text",
+                "none"
+              ]
+            },
             "tabIndex": {
               "description": "0 puts the element in the Tab order; -1 makes it focusable only programmatically.",
               "label": "Tab Index",
@@ -370,6 +388,7 @@
                       "enterDelay": "@config.enterDelay",
                       "lang": "@config.lang",
                       "role": "@config.role",
+                      "skeleton": "@config.skeleton",
                       "tabIndex": "@config.tabIndex",
                       "type": "aside"
                     }

package/behaviors/registry/ui/core/atoms/ui-atlas-image.orb

@@ -182,6 +182,24 @@
               "tier": "presentation",
               "type": "number"
             },
+            "skeleton": {
+              "description": "Skeleton shown while this element's server render is in flight: a shape (`table`, `list`, …), `{ variant, rows?, columns?, fields? }`, or `none`.",
+              "label": "Skeleton",
+              "tier": "presentation",
+              "type": "string",
+              "values": [
+                "header",
+                "table",
+                "list",
+                "grid",
+                "detail",
+                "stats",
+                "form",
+                "card",
+                "text",
+                "none"
+              ]
+            },
             "style": {
               "default": {},
               "description": "style prop",
@@ -249,6 +267,7 @@
                       "fit": "@config.fit",
                       "height": "@config.height",
                       "size": "@config.size",
+                      "skeleton": "@config.skeleton",
                       "style": "@config.style",
                       "type": "atlas-image",
                       "width": "@config.width"

package/behaviors/registry/ui/core/atoms/ui-atlas-panel.orb

@@ -176,6 +176,24 @@
                 "repeat"
               ]
             },
+            "skeleton": {
+              "description": "Skeleton shown while this element's server render is in flight: a shape (`table`, `list`, …), `{ variant, rows?, columns?, fields? }`, or `none`.",
+              "label": "Skeleton",
+              "tier": "presentation",
+              "type": "string",
+              "values": [
+                "header",
+                "table",
+                "list",
+                "grid",
+                "detail",
+                "stats",
+                "form",
+                "card",
+                "text",
+                "none"
+              ]
+            },
             "style": {
               "default": {},
               "description": "style prop",
@@ -236,6 +254,7 @@
                       "enter": "@config.enter",
                       "enterDelay": "@config.enterDelay",
                       "mode": "@config.mode",
+                      "skeleton": "@config.skeleton",
                       "style": "@config.style",
                       "type": "atlas-panel"
                     }