@almadar/std 16.238.0 → 16.239.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-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/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"
                     }

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

@@ -382,6 +382,24 @@
                 "xl"
               ]
             },
+            "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": "Image source URL",
@@ -505,6 +523,7 @@
                       "onClick": "@config.onClick",
                       "role": "@config.role",
                       "size": "@config.size",
+                      "skeleton": "@config.skeleton",
                       "src": "@config.src",
                       "status": "@config.status",
                       "tabIndex": "@config.tabIndex",

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

@@ -434,6 +434,24 @@
                 "lg"
               ]
             },
+            "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",
@@ -522,6 +540,7 @@
                       "removeLabel": "@config.removeLabel",
                       "role": "@config.role",
                       "size": "@config.size",
+                      "skeleton": "@config.skeleton",
                       "tabIndex": "@config.tabIndex",
                       "type": "badge",
                       "variant": "@config.variant"

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

@@ -549,6 +549,24 @@
                 "xl"
               ]
             },
+            "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",
@@ -685,6 +703,7 @@
                       "role": "@config.role",
                       "rounded": "@config.rounded",
                       "shadow": "@config.shadow",
+                      "skeleton": "@config.skeleton",
                       "tabIndex": "@config.tabIndex",
                       "tapReveal": "@config.tapReveal",
                       "type": "box"

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

@@ -475,6 +475,24 @@
                 "lg"
               ]
             },
+            "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",
@@ -584,6 +602,7 @@
                       "rightIcon": "@config.rightIcon",
                       "role": "@config.role",
                       "size": "@config.size",
+                      "skeleton": "@config.skeleton",
                       "tabIndex": "@config.tabIndex",
                       "type": "button",
                       "variant": "@config.variant"

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

@@ -369,6 +369,24 @@
                 "lg"
               ]
             },
+            "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"
+              ]
+            },
             "subtitle": {
               "description": "Card subtitle - renders below title",
               "label": "Subtitle",
@@ -480,6 +498,7 @@
                       "padding": "@config.padding",
                       "role": "@config.role",
                       "shadow": "@config.shadow",
+                      "skeleton": "@config.skeleton",
                       "subtitle": "@config.subtitle",
                       "tabIndex": "@config.tabIndex",
                       "title": "@config.title",