@brightspot/ui 5.1.0 → 5.2.0

package/dist/custom-elements.json

@@ -876,6 +876,187 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/badge/Badge.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "A badge component for highlighting important information.\n\nBadges help highlight notifications, status, or new messages.\nPrimarily used for communicating secondary or additional information.",
+          "name": "Badge",
+          "cssProperties": [
+            {
+              "description": "Text color (overrides theme color)",
+              "name": "--badge-color-foreground"
+            },
+            {
+              "description": "Background color (overrides theme color)",
+              "name": "--badge-color-background"
+            },
+            {
+              "description": "Border radius size (overrides shape default, default: 999px)",
+              "name": "--badge-radius-size"
+            },
+            {
+              "description": "Horizontal padding (overrides size default)",
+              "name": "--badge-px"
+            },
+            {
+              "description": "Vertical padding (overrides size default)",
+              "name": "--badge-py"
+            },
+            {
+              "description": "Size of the dot affordance (default: 6px)",
+              "name": "--badge-dot-size"
+            }
+          ],
+          "slots": [
+            {
+              "description": "Label text or child elements (e.g., btu-icon + text)",
+              "name": ""
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "variant",
+              "type": {
+                "text": "'info' | 'primary' | 'error' | 'success' | 'warning'"
+              },
+              "default": "'info'",
+              "description": "Style of the badge.\n- 'info': Informational (default)\n- 'primary': Primary action or emphasis\n- 'error': Error or danger state\n- 'success': Success or completion state\n- 'warning': Warning or caution state",
+              "attribute": "variant"
+            },
+            {
+              "kind": "field",
+              "name": "dot",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Should a dot be displayed before the label?",
+              "attribute": "dot"
+            },
+            {
+              "kind": "field",
+              "name": "size",
+              "type": {
+                "text": "'sm' | 'md' | 'lg'"
+              },
+              "default": "'sm'",
+              "description": "Size variant.\n- 'sm': Small (default)\n- 'md': Medium\n- 'lg': Large",
+              "attribute": "size"
+            },
+            {
+              "kind": "method",
+              "name": "emit",
+              "parameters": [
+                {
+                  "name": "type",
+                  "type": {
+                    "text": "K"
+                  },
+                  "description": "Event name from CustomEventMap"
+                },
+                {
+                  "name": "detail",
+                  "optional": true,
+                  "type": {
+                    "text": "UnpackCustomEvent<CustomEventMap[K]>"
+                  },
+                  "description": "Optional event detail payload"
+                }
+              ],
+              "description": "Dispatches a type-safe CustomEvent with standardized configuration.\n\nAll events are configured with:\n- bubbles: true (event propagates up the DOM tree)\n- cancelable: false (event cannot be cancelled)\n- composed: true (event crosses shadow DOM boundaries)",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "inheritedFrom": {
+                "name": "EventEmitterMixin",
+                "module": "src/util/EventEmitterMixin.ts"
+              }
+            }
+          ],
+          "events": [
+            {
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "Fired after first render and initialization",
+              "name": "btu-badge-ready"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "variant",
+              "type": {
+                "text": "'info' | 'primary' | 'error' | 'success' | 'warning'"
+              },
+              "default": "'info'",
+              "description": "Style of the badge.\n- 'info': Informational (default)\n- 'primary': Primary action or emphasis\n- 'error': Error or danger state\n- 'success': Success or completion state\n- 'warning': Warning or caution state",
+              "fieldName": "variant",
+              "attribute": "variant"
+            },
+            {
+              "name": "dot",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Should a dot be displayed before the label?",
+              "fieldName": "dot",
+              "attribute": "dot"
+            },
+            {
+              "name": "size",
+              "type": {
+                "text": "'sm' | 'md' | 'lg'"
+              },
+              "default": "'sm'",
+              "description": "Size variant.\n- 'sm': Small (default)\n- 'md': Medium\n- 'lg': Large",
+              "fieldName": "size",
+              "attribute": "size"
+            }
+          ],
+          "mixins": [
+            {
+              "name": "EventEmitterMixin",
+              "module": "/src/util/EventEmitterMixin.js"
+            },
+            {
+              "name": "ReadyMixin",
+              "module": "/src/util/ReadyMixin.js"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "btu-badge",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "default",
+          "declaration": {
+            "name": "Badge",
+            "module": "src/components/badge/Badge.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "btu-badge",
+          "declaration": {
+            "name": "Badge",
+            "module": "src/components/badge/Badge.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/components/avatar/Avatar.ts",
@@ -1531,263 +1712,82 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/badge/Badge.ts",
+      "path": "src/components/button-group/ButtonGroup.ts",
       "declarations": [
         {
           "kind": "class",
-          "description": "A badge component for highlighting important information.\n\nBadges help highlight notifications, status, or new messages.\nPrimarily used for communicating secondary or additional information.",
-          "name": "Badge",
+          "description": "A semantic container for grouping related buttons together.\n\nSupports connected (joined) and spaced layouts, horizontal and vertical\norientation, group-level size and disabled propagation, and optional\ntoggle/selection modes (single-select or multi-select).",
+          "name": "ButtonGroup",
           "cssProperties": [
             {
-              "description": "Text color (overrides theme color)",
-              "name": "--badge-color-foreground"
+              "description": "Space between buttons when variant=\"spaced\" (default: spacing.sm)",
+              "name": "--button-group-gap"
             },
             {
-              "description": "Background color (overrides theme color)",
-              "name": "--badge-color-background"
+              "description": "Corner radius of outer edges when variant=\"connected\" (default: 0.5rem)",
+              "name": "--button-group-border-radius"
             },
             {
-              "description": "Border radius size (overrides shape default, default: 999px)",
-              "name": "--badge-radius-size"
+              "description": "Internal divider color between connected buttons (default: gray-300)",
+              "name": "--button-group-border-color"
             },
             {
-              "description": "Horizontal padding (overrides size default)",
-              "name": "--badge-px"
+              "description": "Background of a toggled/selected child (default: child's --button-tint-subtle)",
+              "name": "--button-group-selection-bg"
             },
             {
-              "description": "Vertical padding (overrides size default)",
-              "name": "--badge-py"
+              "description": "Text/icon color of a toggled/selected child (default: child's --button-tint-strong)",
+              "name": "--button-group-selection-color"
             },
             {
-              "description": "Size of the dot affordance (default: 6px)",
-              "name": "--badge-dot-size"
+              "description": "Highlight color of the selection shimmer effect (default: child's --button-tint-highlight) Reads the following CSS custom properties from each child button (set by the button plugin per color variant — see tailwind-plugin-button.ts):",
+              "name": "--button-group-shimmer-highlight"
+            },
+            {
+              "description": "Subtle tint of the child button's color family (read-only here)",
+              "name": "--button-tint-subtle"
+            },
+            {
+              "description": "Strong tint of the child button's color family (read-only here)",
+              "name": "--button-tint-strong"
+            },
+            {
+              "description": "Highlight tint of the child button's color family (read-only here)",
+              "name": "--button-tint-highlight"
             }
           ],
           "slots": [
             {
-              "description": "Label text or child elements (e.g., btu-icon + text)",
+              "description": "One or more `<button class=\"btu-button …\">` or `<btu-icon-button>` elements to display in the group. The `connected` variant rounds the outer corners on the real `<button>`, so anchors styled as `.btu-button` slotted directly will not get rounded corners. Use `<button>` for grouped controls.",
               "name": ""
+            },
+            {
+              "description": "Pushes the child to the end of the group via auto-margin (vertical: bottom, horizontal: right)",
+              "name": "end"
             }
           ],
           "members": [
             {
               "kind": "field",
-              "name": "variant",
-              "type": {
-                "text": "'info' | 'primary' | 'error' | 'success' | 'warning'"
-              },
-              "default": "'info'",
-              "description": "Style of the badge.\n- 'info': Informational (default)\n- 'primary': Primary action or emphasis\n- 'error': Error or danger state\n- 'success': Success or completion state\n- 'warning': Warning or caution state",
-              "attribute": "variant"
+              "name": "tagName",
+              "static": true,
+              "readonly": true
             },
             {
               "kind": "field",
-              "name": "dot",
+              "name": "label",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "description": "Should a dot be displayed before the label?",
-              "attribute": "dot"
+              "default": "''",
+              "description": "Accessible name for the group, announced by assistive devices via aria-label.",
+              "attribute": "label"
             },
             {
               "kind": "field",
-              "name": "size",
+              "name": "orientation",
               "type": {
-                "text": "'sm' | 'md' | 'lg'"
-              },
-              "default": "'sm'",
-              "description": "Size variant.\n- 'sm': Small (default)\n- 'md': Medium\n- 'lg': Large",
-              "attribute": "size"
-            },
-            {
-              "kind": "method",
-              "name": "emit",
-              "parameters": [
-                {
-                  "name": "type",
-                  "type": {
-                    "text": "K"
-                  },
-                  "description": "Event name from CustomEventMap"
-                },
-                {
-                  "name": "detail",
-                  "optional": true,
-                  "type": {
-                    "text": "UnpackCustomEvent<CustomEventMap[K]>"
-                  },
-                  "description": "Optional event detail payload"
-                }
-              ],
-              "description": "Dispatches a type-safe CustomEvent with standardized configuration.\n\nAll events are configured with:\n- bubbles: true (event propagates up the DOM tree)\n- cancelable: false (event cannot be cancelled)\n- composed: true (event crosses shadow DOM boundaries)",
-              "return": {
-                "type": {
-                  "text": "boolean"
-                }
-              },
-              "inheritedFrom": {
-                "name": "EventEmitterMixin",
-                "module": "src/util/EventEmitterMixin.ts"
-              }
-            }
-          ],
-          "events": [
-            {
-              "type": {
-                "text": "CustomEvent"
-              },
-              "description": "Fired after first render and initialization",
-              "name": "btu-badge-ready"
-            }
-          ],
-          "attributes": [
-            {
-              "name": "variant",
-              "type": {
-                "text": "'info' | 'primary' | 'error' | 'success' | 'warning'"
-              },
-              "default": "'info'",
-              "description": "Style of the badge.\n- 'info': Informational (default)\n- 'primary': Primary action or emphasis\n- 'error': Error or danger state\n- 'success': Success or completion state\n- 'warning': Warning or caution state",
-              "fieldName": "variant",
-              "attribute": "variant"
-            },
-            {
-              "name": "dot",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Should a dot be displayed before the label?",
-              "fieldName": "dot",
-              "attribute": "dot"
-            },
-            {
-              "name": "size",
-              "type": {
-                "text": "'sm' | 'md' | 'lg'"
-              },
-              "default": "'sm'",
-              "description": "Size variant.\n- 'sm': Small (default)\n- 'md': Medium\n- 'lg': Large",
-              "fieldName": "size",
-              "attribute": "size"
-            }
-          ],
-          "mixins": [
-            {
-              "name": "EventEmitterMixin",
-              "module": "/src/util/EventEmitterMixin.js"
-            },
-            {
-              "name": "ReadyMixin",
-              "module": "/src/util/ReadyMixin.js"
-            }
-          ],
-          "superclass": {
-            "name": "LitElement",
-            "package": "lit"
-          },
-          "tagName": "btu-badge",
-          "customElement": true
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "default",
-          "declaration": {
-            "name": "Badge",
-            "module": "src/components/badge/Badge.ts"
-          }
-        },
-        {
-          "kind": "custom-element-definition",
-          "name": "btu-badge",
-          "declaration": {
-            "name": "Badge",
-            "module": "src/components/badge/Badge.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/components/button-group/ButtonGroup.ts",
-      "declarations": [
-        {
-          "kind": "class",
-          "description": "A semantic container for grouping related buttons together.\n\nSupports connected (joined) and spaced layouts, horizontal and vertical\norientation, group-level size and disabled propagation, and optional\ntoggle/selection modes (single-select or multi-select).",
-          "name": "ButtonGroup",
-          "cssProperties": [
-            {
-              "description": "Space between buttons when variant=\"spaced\" (default: spacing.sm)",
-              "name": "--button-group-gap"
-            },
-            {
-              "description": "Corner radius of outer edges when variant=\"connected\" (default: 0.5rem)",
-              "name": "--button-group-border-radius"
-            },
-            {
-              "description": "Internal divider color between connected buttons (default: gray-300)",
-              "name": "--button-group-border-color"
-            },
-            {
-              "description": "Background of a toggled/selected child (default: child's --button-tint-subtle)",
-              "name": "--button-group-selection-bg"
-            },
-            {
-              "description": "Text/icon color of a toggled/selected child (default: child's --button-tint-strong)",
-              "name": "--button-group-selection-color"
-            },
-            {
-              "description": "Highlight color of the selection shimmer effect (default: child's --button-tint-highlight) Reads the following CSS custom properties from each child button (set by the button plugin per color variant — see tailwind-plugin-button.ts):",
-              "name": "--button-group-shimmer-highlight"
-            },
-            {
-              "description": "Subtle tint of the child button's color family (read-only here)",
-              "name": "--button-tint-subtle"
-            },
-            {
-              "description": "Strong tint of the child button's color family (read-only here)",
-              "name": "--button-tint-strong"
-            },
-            {
-              "description": "Highlight tint of the child button's color family (read-only here)",
-              "name": "--button-tint-highlight"
-            }
-          ],
-          "slots": [
-            {
-              "description": "One or more `<button class=\"btu-button …\">` or `<btu-icon-button>` elements to display in the group. The `connected` variant rounds the outer corners on the real `<button>`, so anchors styled as `.btu-button` slotted directly will not get rounded corners. Use `<button>` for grouped controls.",
-              "name": ""
-            },
-            {
-              "description": "Pushes the child to the end of the group via auto-margin (vertical: bottom, horizontal: right)",
-              "name": "end"
-            }
-          ],
-          "members": [
-            {
-              "kind": "field",
-              "name": "tagName",
-              "static": true,
-              "readonly": true
-            },
-            {
-              "kind": "field",
-              "name": "label",
-              "type": {
-                "text": "string"
-              },
-              "default": "''",
-              "description": "Accessible name for the group, announced by assistive devices via aria-label.",
-              "attribute": "label"
-            },
-            {
-              "kind": "field",
-              "name": "orientation",
-              "type": {
-                "text": "'horizontal' | 'vertical'"
+                "text": "'horizontal' | 'vertical'"
               },
               "default": "'horizontal'",
               "description": "Layout direction of the buttons.",
@@ -2103,93 +2103,95 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/checkbox/Checkbox.ts",
+      "path": "src/components/card/Card.ts",
       "declarations": [
         {
           "kind": "class",
-          "description": "A checkbox component for selecting one or more options from a set.\n\nUses a hidden native checkbox internally for accessibility and form\nparticipation. Styled via the `btu-checkbox` Tailwind plugin classes.\nThe component manages its own `className` — do not modify it externally\nafter initialization (classes present at connection time are preserved).",
-          "name": "Checkbox",
+          "description": "A flexible content container for presenting and organizing information.\n\nThe layout is driven by composition:\n\n- a direct `<img>` or `<btu-icon>` child renders the media layout (image area);\n  the icon shows in the image area as the fallback.\n- neither child renders a text-only card.\n- the `compact` attribute renders a quick-start tile; only a\n  featured `<btu-icon>` and the `action` slot are used.\n\nComposable children, all relocated into the layout automatically:\n- `<img>` — the thumbnail.\n- `<btu-icon>` — the featured icon (compact) or the media image fallback (shown\n  when no `<img>` is provided or it fails to load; defaults to `file-text`). The card sizes it.\n- `<btu-badge>` — a status badge.\n- `slot=\"action\"` / `slot=\"secondary-action\"` — a control in the top-right corner\n  or next to the title. A `<btu-checkbox>` there stays visible and toggles the\n  selected styling (listen for the bubbling `btu-checkbox-change` event); buttons\n  reveal on hover/focus.\n\nCards are full-width by default and rely on the parent layout (grid or flex) to\ncontrol their size.",
+          "name": "Card",
           "cssProperties": [
             {
-              "description": "Background and border color when checked or indeterminate, and tinted background/border on unchecked hover (default: oklch(var(--btu-theme-primary-700)))",
-              "name": "--checkbox-color-primary"
+              "description": "Minimum width of the card (default: 160px)",
+              "name": "--card-min-width"
             },
             {
-              "description": "Border color in the unchecked state (default: oklch(var(--btu-theme-gray-300)))",
-              "name": "--checkbox-color-border"
+              "description": "Background color (default: var(--btu-theme-white))",
+              "name": "--card-background"
             },
             {
-              "description": "Border and text color in the error state (default: oklch(var(--btu-theme-error-600)))",
-              "name": "--checkbox-color-error"
+              "description": "Border style (default: 1px solid gray-200)",
+              "name": "--card-border"
             },
             {
-              "description": "Corner rounding of the checkbox square (default: 4px)",
-              "name": "--checkbox-border-radius"
+              "description": "Corner rounding (default: 8px)",
+              "name": "--card-radius"
             },
             {
-              "description": "Distance between the checkbox and the label (default: 0.75rem)",
-              "name": "--checkbox-label-spacing"
+              "description": "Fixed aspect ratio for the thumbnail when an `<img>` child is present (default: 16 / 9)",
+              "name": "--card-img-ratio"
             },
             {
-              "description": "[Internal] Width and height of the checkbox square, set by the size variant (sm: 1rem, md: 1.25rem). Use the `size` attribute instead of overriding directly — the icon must scale in tandem.",
-              "name": "--checkbox-box-size"
+              "description": "Object-fit mode for the `<img>` child thumbnail (default: contain)",
+              "name": "--card-img-fit"
             },
             {
-              "description": "[Internal] Width and height of the icon inside the box, set by the size variant (sm: 0.75rem, md: 0.875rem). Use the `size` attribute instead of overriding directly.",
-              "name": "--checkbox-icon-size"
+              "description": "Background color behind the composed icon (compact card and media-image fallback) (default: gray-100)",
+              "name": "--card-icon-background"
+            }
+          ],
+          "slots": [
+            {
+              "description": "Intended for a single action in the top-right corner of the card.",
+              "name": "action"
+            },
+            {
+              "description": "Intended for a single action next to the title.",
+              "name": "secondary-action"
+            },
+            {
+              "description": "Intended for additional metadata fields displayed below the title & description",
+              "name": "fields"
             }
           ],
           "members": [
             {
               "kind": "field",
-              "name": "label",
+              "name": "heading",
               "type": {
-                "text": "string | undefined"
+                "text": "string"
               },
-              "description": "The text label displayed next to the checkbox.",
-              "attribute": "label"
+              "default": "''",
+              "description": "Heading text displayed on the card.",
+              "attribute": "heading"
             },
             {
               "kind": "field",
-              "name": "description",
+              "name": "headingLevel",
               "type": {
-                "text": "string | undefined"
+                "text": "number"
               },
-              "description": "Optional helper text displayed below the label.",
-              "attribute": "description"
+              "default": "2",
+              "description": "Heading level (1-6) for the card heading element. Drives the semantic h1–h6 tag.\nInvalid values log a warning and fall back to the default (2).",
+              "attribute": "heading-level"
             },
             {
               "kind": "field",
-              "name": "size",
-              "type": {
-                "text": "'sm' | 'md'"
-              },
-              "default": "'sm'",
-              "description": "Controls the scale of the checkbox and associated typography.",
-              "attribute": "size",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "checked",
+              "name": "description",
               "type": {
-                "text": "boolean"
+                "text": "string | undefined"
               },
-              "default": "false",
-              "description": "Whether the checkbox is currently selected.",
-              "attribute": "checked",
-              "reflects": true
+              "description": "Supporting body text. Truncated to 3 lines via CSS.",
+              "attribute": "description"
             },
             {
               "kind": "field",
-              "name": "indeterminate",
+              "name": "compact",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether the checkbox is in a partially selected state. Sets `aria-checked='mixed'`\nand activates the native `:indeterminate` pseudo-class. Cleared automatically when\nthe user clicks the checkbox.",
-              "attribute": "indeterminate",
-              "reflects": true
+              "description": "Renders the card as a compact quick-start tile.\nBadge, image, fields, and secondary-action children are ignored in this case.",
+              "attribute": "compact"
             },
             {
               "kind": "field",
@@ -2198,139 +2200,17 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "If true, the checkbox is non-interactive and visually muted.",
-              "attribute": "disabled",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "invalid",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "If true, displays error styling on the checkbox.",
-              "attribute": "invalid",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "error",
-              "type": {
-                "text": "string | undefined"
-              },
-              "description": "Error message text displayed below the checkbox when validation fails.\nSetting this also activates error styling without needing to set invalid.",
-              "attribute": "error"
-            },
-            {
-              "kind": "field",
-              "name": "required",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Marks the field as mandatory for form submission.",
-              "attribute": "required",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "name",
-              "type": {
-                "text": "string | undefined"
-              },
-              "description": "Name of the form control submitted with the form data.",
-              "attribute": "name"
-            },
-            {
-              "kind": "field",
-              "name": "value",
-              "type": {
-                "text": "string"
-              },
-              "default": "'on'",
-              "description": "Value associated with the checkbox when submitted.",
-              "attribute": "value"
-            },
-            {
-              "kind": "field",
-              "name": "_userInitiated",
-              "type": {
-                "text": "boolean"
-              },
-              "privacy": "private",
-              "default": "false"
-            },
-            {
-              "kind": "field",
-              "name": "_initialClasses",
-              "type": {
-                "text": "string[]"
-              },
-              "privacy": "private",
-              "default": "[]"
-            },
-            {
-              "kind": "field",
-              "name": "_initialClassesCaptured",
-              "type": {
-                "text": "boolean"
-              },
-              "privacy": "private",
-              "default": "false"
-            },
-            {
-              "kind": "field",
-              "name": "_descId",
-              "privacy": "private",
-              "default": "`checkbox-desc-${crypto.randomUUID()}`"
-            },
-            {
-              "kind": "field",
-              "name": "_errorId",
-              "privacy": "private",
-              "default": "`checkbox-error-${crypto.randomUUID()}`"
-            },
-            {
-              "kind": "method",
-              "name": "_onInputChange",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "e",
-                  "type": {
-                    "text": "Event"
-                  }
-                }
-              ]
-            },
-            {
-              "kind": "field",
-              "name": "_handleClick",
-              "privacy": "private"
+              "description": "Whether the card is disabled.",
+              "attribute": "disabled"
             },
             {
               "kind": "field",
-              "name": "_describedBy",
+              "name": "href",
               "type": {
                 "text": "string | undefined"
               },
-              "privacy": "private",
-              "readonly": true
-            },
-            {
-              "kind": "field",
-              "name": "_iconSymbol",
-              "type": {
-                "text": "'minus' | 'check'"
-              },
-              "privacy": "private",
-              "readonly": true
+              "description": "Navigation URL for the entire card surface.\nWhen set, the card renders as a link.",
+              "attribute": "href"
             },
             {
               "kind": "method",
@@ -2362,72 +2242,91 @@
                 "name": "EventEmitterMixin",
                 "module": "src/util/EventEmitterMixin.ts"
               }
-            }
-          ],
-          "events": [
+            },
             {
+              "kind": "field",
+              "name": "#stopFns",
+              "privacy": "private",
               "type": {
-                "text": "CustomEvent"
+                "text": "Array<() => void>"
               },
-              "description": "Fired after the checkbox is first rendered and initialized",
-              "name": "btu-checkbox-ready"
+              "default": "[]",
+              "inheritedFrom": {
+                "name": "OnFindMixin",
+                "module": "src/util/OnFindMixin.ts"
+              }
             },
             {
-              "type": {
-                "text": "CustomEvent<{ checked: boolean }>"
+              "kind": "method",
+              "name": "onFindRegistration",
+              "return": {
+                "type": {
+                  "text": "OnFindRegistration | OnFindRegistration[] | null"
+                }
               },
-              "description": "Fired when the user toggles the checked state",
-              "name": "btu-checkbox-change"
+              "inheritedFrom": {
+                "name": "OnFindMixin",
+                "module": "src/util/OnFindMixin.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "#armFind",
+              "privacy": "private",
+              "inheritedFrom": {
+                "name": "OnFindMixin",
+                "module": "src/util/OnFindMixin.ts"
+              }
             }
           ],
-          "attributes": [
+          "events": [
             {
-              "name": "label",
               "type": {
-                "text": "string | undefined"
+                "text": "CustomEvent"
               },
-              "description": "The text label displayed next to the checkbox.",
-              "fieldName": "label",
-              "attribute": "label"
-            },
+              "description": "Fired after first render and initialization",
+              "name": "btu-card-ready"
+            }
+          ],
+          "attributes": [
             {
-              "name": "description",
+              "name": "heading",
               "type": {
-                "text": "string | undefined"
+                "text": "string"
               },
-              "description": "Optional helper text displayed below the label.",
-              "fieldName": "description",
-              "attribute": "description"
+              "default": "''",
+              "description": "Heading text displayed on the card.",
+              "fieldName": "heading",
+              "attribute": "heading"
             },
             {
-              "name": "size",
+              "name": "heading-level",
               "type": {
-                "text": "'sm' | 'md'"
+                "text": "number"
               },
-              "default": "'sm'",
-              "description": "Controls the scale of the checkbox and associated typography.",
-              "fieldName": "size",
-              "attribute": "size"
+              "default": "2",
+              "description": "Heading level (1-6) for the card heading element. Drives the semantic h1–h6 tag.\nInvalid values log a warning and fall back to the default (2).",
+              "fieldName": "headingLevel",
+              "attribute": "heading-level"
             },
             {
-              "name": "checked",
+              "name": "description",
               "type": {
-                "text": "boolean"
+                "text": "string | undefined"
               },
-              "default": "false",
-              "description": "Whether the checkbox is currently selected.",
-              "fieldName": "checked",
-              "attribute": "checked"
+              "description": "Supporting body text. Truncated to 3 lines via CSS.",
+              "fieldName": "description",
+              "attribute": "description"
             },
             {
-              "name": "indeterminate",
+              "name": "compact",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether the checkbox is in a partially selected state. Sets `aria-checked='mixed'`\nand activates the native `:indeterminate` pseudo-class. Cleared automatically when\nthe user clicks the checkbox.",
-              "fieldName": "indeterminate",
-              "attribute": "indeterminate"
+              "description": "Renders the card as a compact quick-start tile.\nBadge, image, fields, and secondary-action children are ignored in this case.",
+              "fieldName": "compact",
+              "attribute": "compact"
             },
             {
               "name": "disabled",
@@ -2435,57 +2334,18 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "If true, the checkbox is non-interactive and visually muted.",
+              "description": "Whether the card is disabled.",
               "fieldName": "disabled",
               "attribute": "disabled"
             },
             {
-              "name": "invalid",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "If true, displays error styling on the checkbox.",
-              "fieldName": "invalid",
-              "attribute": "invalid"
-            },
-            {
-              "name": "error",
-              "type": {
-                "text": "string | undefined"
-              },
-              "description": "Error message text displayed below the checkbox when validation fails.\nSetting this also activates error styling without needing to set invalid.",
-              "fieldName": "error",
-              "attribute": "error"
-            },
-            {
-              "name": "required",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Marks the field as mandatory for form submission.",
-              "fieldName": "required",
-              "attribute": "required"
-            },
-            {
-              "name": "name",
+              "name": "href",
               "type": {
                 "text": "string | undefined"
               },
-              "description": "Name of the form control submitted with the form data.",
-              "fieldName": "name",
-              "attribute": "name"
-            },
-            {
-              "name": "value",
-              "type": {
-                "text": "string"
-              },
-              "default": "'on'",
-              "description": "Value associated with the checkbox when submitted.",
-              "fieldName": "value",
-              "attribute": "value"
+              "description": "Navigation URL for the entire card surface.\nWhen set, the card renders as a link.",
+              "fieldName": "href",
+              "attribute": "href"
             }
           ],
           "mixins": [
@@ -2493,6 +2353,10 @@
               "name": "EventEmitterMixin",
               "module": "/src/util/EventEmitterMixin.js"
             },
+            {
+              "name": "OnFindMixin",
+              "module": "/src/util/OnFindMixin.js"
+            },
             {
               "name": "ReadyMixin",
               "module": "/src/util/ReadyMixin.js"
@@ -2502,7 +2366,7 @@
             "name": "LitElement",
             "package": "lit"
           },
-          "tagName": "btu-checkbox",
+          "tagName": "btu-card",
           "customElement": true
         }
       ],
@@ -2511,130 +2375,250 @@
           "kind": "js",
           "name": "default",
           "declaration": {
-            "name": "Checkbox",
-            "module": "src/components/checkbox/Checkbox.ts"
+            "name": "Card",
+            "module": "src/components/card/Card.ts"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "btu-checkbox",
+          "name": "btu-card",
           "declaration": {
-            "name": "Checkbox",
-            "module": "src/components/checkbox/Checkbox.ts"
+            "name": "Card",
+            "module": "src/components/card/Card.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/card/Card.ts",
+      "path": "src/components/checkbox/Checkbox.ts",
       "declarations": [
         {
           "kind": "class",
-          "description": "A flexible content container for presenting and organizing information.\n\nThe layout is driven by composition:\n\n- a direct `<img>` or `<btu-icon>` child renders the media layout (image area);\n  the icon shows in the image area as the fallback.\n- neither child renders a text-only card.\n- the `compact` attribute renders a quick-start tile; only a\n  featured `<btu-icon>` and the `action` slot are used.\n\nComposable children, all relocated into the layout automatically:\n- `<img>` — the thumbnail.\n- `<btu-icon>` — the featured icon (compact) or the media image fallback (shown\n  when no `<img>` is provided or it fails to load; defaults to `file-text`). The card sizes it.\n- `<btu-badge>` — a status badge.\n- `slot=\"action\"` / `slot=\"secondary-action\"` — a control in the top-right corner\n  or next to the title. A `<btu-checkbox>` there stays visible and toggles the\n  selected styling (listen for the bubbling `btu-checkbox-change` event); buttons\n  reveal on hover/focus.\n\nCards are full-width by default and rely on the parent layout (grid or flex) to\ncontrol their size.",
-          "name": "Card",
+          "description": "A checkbox component for selecting one or more options from a set.\n\nUses a hidden native checkbox internally for accessibility and form\nparticipation. Styled via the `btu-checkbox` Tailwind plugin classes.\nThe component manages its own `className` — do not modify it externally\nafter initialization (classes present at connection time are preserved).",
+          "name": "Checkbox",
           "cssProperties": [
             {
-              "description": "Minimum width of the card (default: 160px)",
-              "name": "--card-min-width"
+              "description": "Background and border color when checked or indeterminate, and tinted background/border on unchecked hover (default: oklch(var(--btu-theme-primary-700)))",
+              "name": "--checkbox-color-primary"
             },
             {
-              "description": "Background color (default: var(--btu-theme-white))",
-              "name": "--card-background"
+              "description": "Border color in the unchecked state (default: oklch(var(--btu-theme-gray-300)))",
+              "name": "--checkbox-color-border"
+            },
+            {
+              "description": "Border and text color in the error state (default: oklch(var(--btu-theme-error-600)))",
+              "name": "--checkbox-color-error"
+            },
+            {
+              "description": "Corner rounding of the checkbox square (default: 4px)",
+              "name": "--checkbox-border-radius"
+            },
+            {
+              "description": "Distance between the checkbox and the label (default: 0.75rem)",
+              "name": "--checkbox-label-spacing"
+            },
+            {
+              "description": "[Internal] Width and height of the checkbox square, set by the size variant (sm: 1rem, md: 1.25rem). Use the `size` attribute instead of overriding directly — the icon must scale in tandem.",
+              "name": "--checkbox-box-size"
+            },
+            {
+              "description": "[Internal] Width and height of the icon inside the box, set by the size variant (sm: 0.75rem, md: 0.875rem). Use the `size` attribute instead of overriding directly.",
+              "name": "--checkbox-icon-size"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "label",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "The text label displayed next to the checkbox.",
+              "attribute": "label"
+            },
+            {
+              "kind": "field",
+              "name": "description",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Optional helper text displayed below the label.",
+              "attribute": "description"
+            },
+            {
+              "kind": "field",
+              "name": "size",
+              "type": {
+                "text": "'sm' | 'md'"
+              },
+              "default": "'sm'",
+              "description": "Controls the scale of the checkbox and associated typography.",
+              "attribute": "size",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "checked",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether the checkbox is currently selected.",
+              "attribute": "checked",
+              "reflects": true
             },
             {
-              "description": "Border style (default: 1px solid gray-200)",
-              "name": "--card-border"
+              "kind": "field",
+              "name": "indeterminate",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether the checkbox is in a partially selected state. Sets `aria-checked='mixed'`\nand activates the native `:indeterminate` pseudo-class. Cleared automatically when\nthe user clicks the checkbox.",
+              "attribute": "indeterminate",
+              "reflects": true
             },
             {
-              "description": "Corner rounding (default: 8px)",
-              "name": "--card-radius"
+              "kind": "field",
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "If true, the checkbox is non-interactive and visually muted.",
+              "attribute": "disabled",
+              "reflects": true
             },
             {
-              "description": "Fixed aspect ratio for the thumbnail when an `<img>` child is present (default: 16 / 9)",
-              "name": "--card-img-ratio"
+              "kind": "field",
+              "name": "invalid",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "If true, displays error styling on the checkbox.",
+              "attribute": "invalid",
+              "reflects": true
             },
             {
-              "description": "Object-fit mode for the `<img>` child thumbnail (default: contain)",
-              "name": "--card-img-fit"
+              "kind": "field",
+              "name": "error",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Error message text displayed below the checkbox when validation fails.\nSetting this also activates error styling without needing to set invalid.",
+              "attribute": "error"
             },
             {
-              "description": "Background color behind the composed icon (compact card and media-image fallback) (default: gray-100)",
-              "name": "--card-icon-background"
-            }
-          ],
-          "slots": [
-            {
-              "description": "Intended for a single action in the top-right corner of the card.",
-              "name": "action"
+              "kind": "field",
+              "name": "required",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Marks the field as mandatory for form submission.",
+              "attribute": "required",
+              "reflects": true
             },
             {
-              "description": "Intended for a single action next to the title.",
-              "name": "secondary-action"
+              "kind": "field",
+              "name": "name",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Name of the form control submitted with the form data.",
+              "attribute": "name"
             },
-            {
-              "description": "Intended for additional metadata fields displayed below the title & description",
-              "name": "fields"
-            }
-          ],
-          "members": [
             {
               "kind": "field",
-              "name": "heading",
+              "name": "value",
               "type": {
                 "text": "string"
               },
-              "default": "''",
-              "description": "Heading text displayed on the card.",
-              "attribute": "heading"
+              "default": "'on'",
+              "description": "Value associated with the checkbox when submitted.",
+              "attribute": "value"
             },
             {
               "kind": "field",
-              "name": "headingLevel",
+              "name": "_userInitiated",
               "type": {
-                "text": "number"
+                "text": "boolean"
               },
-              "default": "2",
-              "description": "Heading level (1-6) for the card heading element. Drives the semantic h1–h6 tag.\nInvalid values log a warning and fall back to the default (2).",
-              "attribute": "heading-level"
+              "privacy": "private",
+              "default": "false"
             },
             {
               "kind": "field",
-              "name": "description",
+              "name": "_initialClasses",
               "type": {
-                "text": "string | undefined"
+                "text": "string[]"
               },
-              "description": "Supporting body text. Truncated to 3 lines via CSS.",
-              "attribute": "description"
+              "privacy": "private",
+              "default": "[]"
             },
             {
               "kind": "field",
-              "name": "compact",
+              "name": "_initialClassesCaptured",
               "type": {
                 "text": "boolean"
               },
-              "default": "false",
-              "description": "Renders the card as a compact quick-start tile.\nBadge, image, fields, and secondary-action children are ignored in this case.",
-              "attribute": "compact"
+              "privacy": "private",
+              "default": "false"
             },
             {
               "kind": "field",
-              "name": "disabled",
-              "type": {
-                "text": "boolean"
+              "name": "_descId",
+              "privacy": "private",
+              "default": "`checkbox-desc-${crypto.randomUUID()}`"
+            },
+            {
+              "kind": "field",
+              "name": "_errorId",
+              "privacy": "private",
+              "default": "`checkbox-error-${crypto.randomUUID()}`"
+            },
+            {
+              "kind": "method",
+              "name": "_onInputChange",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
               },
-              "default": "false",
-              "description": "Whether the card is disabled.",
-              "attribute": "disabled"
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ]
             },
             {
               "kind": "field",
-              "name": "href",
+              "name": "_handleClick",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "_describedBy",
               "type": {
                 "text": "string | undefined"
               },
-              "description": "Navigation URL for the entire card surface.\nWhen set, the card renders as a link.",
-              "attribute": "href"
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "_iconSymbol",
+              "type": {
+                "text": "'minus' | 'check'"
+              },
+              "privacy": "private",
+              "readonly": true
             },
             {
               "kind": "method",
@@ -2666,110 +2650,130 @@
                 "name": "EventEmitterMixin",
                 "module": "src/util/EventEmitterMixin.ts"
               }
+            }
+          ],
+          "events": [
+            {
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "Fired after the checkbox is first rendered and initialized",
+              "name": "btu-checkbox-ready"
             },
             {
-              "kind": "field",
-              "name": "#stopFns",
-              "privacy": "private",
               "type": {
-                "text": "Array<() => void>"
+                "text": "CustomEvent<{ checked: boolean }>"
               },
-              "default": "[]",
-              "inheritedFrom": {
-                "name": "OnFindMixin",
-                "module": "src/util/OnFindMixin.ts"
-              }
+              "description": "Fired when the user toggles the checked state",
+              "name": "btu-checkbox-change"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "label",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "The text label displayed next to the checkbox.",
+              "fieldName": "label",
+              "attribute": "label"
             },
             {
-              "kind": "method",
-              "name": "onFindRegistration",
-              "return": {
-                "type": {
-                  "text": "OnFindRegistration | OnFindRegistration[] | null"
-                }
+              "name": "description",
+              "type": {
+                "text": "string | undefined"
               },
-              "inheritedFrom": {
-                "name": "OnFindMixin",
-                "module": "src/util/OnFindMixin.ts"
-              }
+              "description": "Optional helper text displayed below the label.",
+              "fieldName": "description",
+              "attribute": "description"
             },
             {
-              "kind": "method",
-              "name": "#armFind",
-              "privacy": "private",
-              "inheritedFrom": {
-                "name": "OnFindMixin",
-                "module": "src/util/OnFindMixin.ts"
-              }
-            }
-          ],
-          "events": [
+              "name": "size",
+              "type": {
+                "text": "'sm' | 'md'"
+              },
+              "default": "'sm'",
+              "description": "Controls the scale of the checkbox and associated typography.",
+              "fieldName": "size",
+              "attribute": "size"
+            },
             {
+              "name": "checked",
               "type": {
-                "text": "CustomEvent"
+                "text": "boolean"
               },
-              "description": "Fired after first render and initialization",
-              "name": "btu-card-ready"
-            }
-          ],
-          "attributes": [
+              "default": "false",
+              "description": "Whether the checkbox is currently selected.",
+              "fieldName": "checked",
+              "attribute": "checked"
+            },
             {
-              "name": "heading",
+              "name": "indeterminate",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "default": "''",
-              "description": "Heading text displayed on the card.",
-              "fieldName": "heading",
-              "attribute": "heading"
+              "default": "false",
+              "description": "Whether the checkbox is in a partially selected state. Sets `aria-checked='mixed'`\nand activates the native `:indeterminate` pseudo-class. Cleared automatically when\nthe user clicks the checkbox.",
+              "fieldName": "indeterminate",
+              "attribute": "indeterminate"
+            },
+            {
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "If true, the checkbox is non-interactive and visually muted.",
+              "fieldName": "disabled",
+              "attribute": "disabled"
             },
             {
-              "name": "heading-level",
+              "name": "invalid",
               "type": {
-                "text": "number"
+                "text": "boolean"
               },
-              "default": "2",
-              "description": "Heading level (1-6) for the card heading element. Drives the semantic h1–h6 tag.\nInvalid values log a warning and fall back to the default (2).",
-              "fieldName": "headingLevel",
-              "attribute": "heading-level"
+              "default": "false",
+              "description": "If true, displays error styling on the checkbox.",
+              "fieldName": "invalid",
+              "attribute": "invalid"
             },
             {
-              "name": "description",
+              "name": "error",
               "type": {
                 "text": "string | undefined"
               },
-              "description": "Supporting body text. Truncated to 3 lines via CSS.",
-              "fieldName": "description",
-              "attribute": "description"
+              "description": "Error message text displayed below the checkbox when validation fails.\nSetting this also activates error styling without needing to set invalid.",
+              "fieldName": "error",
+              "attribute": "error"
             },
             {
-              "name": "compact",
+              "name": "required",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Renders the card as a compact quick-start tile.\nBadge, image, fields, and secondary-action children are ignored in this case.",
-              "fieldName": "compact",
-              "attribute": "compact"
+              "description": "Marks the field as mandatory for form submission.",
+              "fieldName": "required",
+              "attribute": "required"
             },
             {
-              "name": "disabled",
+              "name": "name",
               "type": {
-                "text": "boolean"
+                "text": "string | undefined"
               },
-              "default": "false",
-              "description": "Whether the card is disabled.",
-              "fieldName": "disabled",
-              "attribute": "disabled"
+              "description": "Name of the form control submitted with the form data.",
+              "fieldName": "name",
+              "attribute": "name"
             },
             {
-              "name": "href",
+              "name": "value",
               "type": {
-                "text": "string | undefined"
+                "text": "string"
               },
-              "description": "Navigation URL for the entire card surface.\nWhen set, the card renders as a link.",
-              "fieldName": "href",
-              "attribute": "href"
+              "default": "'on'",
+              "description": "Value associated with the checkbox when submitted.",
+              "fieldName": "value",
+              "attribute": "value"
             }
           ],
           "mixins": [
@@ -2777,10 +2781,6 @@
               "name": "EventEmitterMixin",
               "module": "/src/util/EventEmitterMixin.js"
             },
-            {
-              "name": "OnFindMixin",
-              "module": "/src/util/OnFindMixin.js"
-            },
             {
               "name": "ReadyMixin",
               "module": "/src/util/ReadyMixin.js"
@@ -2790,7 +2790,7 @@
             "name": "LitElement",
             "package": "lit"
           },
-          "tagName": "btu-card",
+          "tagName": "btu-checkbox",
           "customElement": true
         }
       ],
@@ -2799,16 +2799,16 @@
           "kind": "js",
           "name": "default",
           "declaration": {
-            "name": "Card",
-            "module": "src/components/card/Card.ts"
+            "name": "Checkbox",
+            "module": "src/components/checkbox/Checkbox.ts"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "btu-card",
+          "name": "btu-checkbox",
           "declaration": {
-            "name": "Card",
-            "module": "src/components/card/Card.ts"
+            "name": "Checkbox",
+            "module": "src/components/checkbox/Checkbox.ts"
           }
         }
       ]
@@ -5157,6 +5157,238 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/esca-avatar/EscaAvatar.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "The animated avatar for the Esca AI assistant, driven entirely by its `state` attribute so the same\nelement works wherever the assistant appears.\n\nAccessibility: the avatar is a visual indicator, not a status channel. By default it exposes a static\naccessible name (`role=\"img\"`, `aria-label=\"Esca\"`) so it reads like an author/identity avatar; both\nare only set when absent, so consumers can override them.\n- When the assistant is already named in the surrounding UI (the common case in a chat), treat the\n  avatar as decorative: set `aria-hidden=\"true\"` to avoid a redundant announcement.\n- Do NOT convey activity (thinking / done) by changing this element's ARIA per `state` — a looping\n  `search` would announce repeatedly. Surface status as text in a polite `aria-live` region owned by\n  the chat UI, which has the context to word and time announcements. This component intentionally\n  does not announce its own state.",
+          "name": "EscaAvatar",
+          "cssProperties": [
+            {
+              "description": "Width and height of the avatar; overrides the `size` attribute (default: 2.5rem)",
+              "name": "--esca-avatar-size"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "state",
+              "type": {
+                "text": "EscaAvatarState"
+              },
+              "default": "'idle'",
+              "description": "Animation to play; changing it swaps the clip.",
+              "attribute": "state",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "size",
+              "type": {
+                "text": "EscaAvatarSize"
+              },
+              "default": "'md'",
+              "description": "Size of the avatar, mirroring `<btu-avatar>`'s scale. `--esca-avatar-size` overrides it.",
+              "attribute": "size",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "_containerRef",
+              "type": {
+                "text": "Ref<HTMLDivElement>"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "_animation",
+              "type": {
+                "text": "AnimationItem | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_rendered",
+              "type": {
+                "text": "EscaAvatarState | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_reduceMotion",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "_loadToken",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "default": "0"
+            },
+            {
+              "kind": "field",
+              "name": "_resizeObserver",
+              "type": {
+                "text": "ResizeObserver | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "_intersectionObserver",
+              "type": {
+                "text": "IntersectionObserver | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "_motionQuery",
+              "type": {
+                "text": "MediaQueryList | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_applySize",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "_onMotionChange",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_play",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_destroy",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "emit",
+              "parameters": [
+                {
+                  "name": "type",
+                  "type": {
+                    "text": "K"
+                  },
+                  "description": "Event name from CustomEventMap"
+                },
+                {
+                  "name": "detail",
+                  "optional": true,
+                  "type": {
+                    "text": "UnpackCustomEvent<CustomEventMap[K]>"
+                  },
+                  "description": "Optional event detail payload"
+                }
+              ],
+              "description": "Dispatches a type-safe CustomEvent with standardized configuration.\n\nAll events are configured with:\n- bubbles: true (event propagates up the DOM tree)\n- cancelable: false (event cannot be cancelled)\n- composed: true (event crosses shadow DOM boundaries)",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "inheritedFrom": {
+                "name": "EventEmitterMixin",
+                "module": "src/util/EventEmitterMixin.ts"
+              }
+            }
+          ],
+          "events": [
+            {
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "Fired after the first render",
+              "name": "btu-esca-avatar-ready"
+            },
+            {
+              "type": {
+                "text": "CustomEvent<{state: string}>"
+              },
+              "description": "Fired when a non-looping animation finishes",
+              "name": "btu-esca-avatar-complete"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "state",
+              "type": {
+                "text": "EscaAvatarState"
+              },
+              "default": "'idle'",
+              "description": "Animation to play; changing it swaps the clip.",
+              "fieldName": "state",
+              "attribute": "state"
+            },
+            {
+              "name": "size",
+              "type": {
+                "text": "EscaAvatarSize"
+              },
+              "default": "'md'",
+              "description": "Size of the avatar, mirroring `<btu-avatar>`'s scale. `--esca-avatar-size` overrides it.",
+              "fieldName": "size",
+              "attribute": "size"
+            }
+          ],
+          "mixins": [
+            {
+              "name": "EventEmitterMixin",
+              "module": "/src/util/EventEmitterMixin.js"
+            },
+            {
+              "name": "ReadyMixin",
+              "module": "/src/util/ReadyMixin.js"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "btu-esca-avatar",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "default",
+          "declaration": {
+            "name": "EscaAvatar",
+            "module": "src/components/esca-avatar/EscaAvatar.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "btu-esca-avatar",
+          "declaration": {
+            "name": "EscaAvatar",
+            "module": "src/components/esca-avatar/EscaAvatar.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/components/icon/Icon.ts",