luxen-ui 0.21.3 → 0.21.4

package/cdn/custom-elements.json

@@ -2,351 +2,6 @@
   "schemaVersion": "1.0.0",
   "readme": "",
   "modules": [
-    {
-      "kind": "javascript-module",
-      "path": "src/html/elements/alert/alert.ts",
-      "declarations": [
-        {
-          "kind": "class",
-          "description": "",
-          "name": "Alert",
-          "cssProperties": [
-            {
-              "description": "Gap between the icon, content, and close button.",
-              "name": "--gap",
-              "default": "0.75rem"
-            },
-            {
-              "description": "Inner padding.",
-              "name": "--padding",
-              "default": "1rem"
-            },
-            {
-              "description": "Corner radius.",
-              "name": "--border-radius",
-              "default": "8px"
-            }
-          ],
-          "members": [
-            {
-              "kind": "field",
-              "name": "variant",
-              "type": {
-                "text": "AlertVariant | undefined"
-              },
-              "description": "Semantic variant: `info`, `success`, `warning`, or `danger`. Default is neutral.",
-              "attribute": "variant",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "icon",
-              "type": {
-                "text": "string | undefined"
-              },
-              "description": "Iconify icon name (e.g. `lucide:bell`) overriding the variant's default icon.",
-              "attribute": "icon"
-            },
-            {
-              "kind": "field",
-              "name": "withoutIcon",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Hide the leading icon entirely.",
-              "attribute": "without-icon"
-            },
-            {
-              "kind": "field",
-              "name": "dismissible",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Show a close button that dismisses the alert when clicked.",
-              "attribute": "dismissible",
-              "reflects": true
-            }
-          ],
-          "events": [
-            {
-              "name": "hide",
-              "description": "Emitted when a dismissible alert is about to close. Cancelable — call `event.preventDefault()` to keep it open.",
-              "cancelable": true
-            },
-            {
-              "name": "after-hide",
-              "description": "Emitted after the dismiss animation completes and the alert is removed from the DOM. Not cancelable.",
-              "cancelable": false
-            }
-          ],
-          "attributes": [
-            {
-              "name": "variant",
-              "type": {
-                "text": "AlertVariant | undefined"
-              },
-              "description": "Semantic variant: `info`, `success`, `warning`, or `danger`. Default is neutral.",
-              "fieldName": "variant"
-            },
-            {
-              "name": "icon",
-              "type": {
-                "text": "string | undefined"
-              },
-              "description": "Iconify icon name (e.g. `lucide:bell`) overriding the variant's default icon.",
-              "fieldName": "icon"
-            },
-            {
-              "name": "without-icon",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Hide the leading icon entirely.",
-              "fieldName": "withoutIcon"
-            },
-            {
-              "name": "dismissible",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Show a close button that dismisses the alert when clicked.",
-              "fieldName": "dismissible"
-            }
-          ],
-          "superclass": {
-            "name": "LuxenElement",
-            "module": "/src/html/shared/luxen-element.js"
-          },
-          "tagName": "l-alert",
-          "customElement": true,
-          "summary": "A callout box that highlights contextual information with a semantic color and a leading icon.",
-          "examples": [
-            {
-              "language": "html",
-              "code": "<l-alert variant=\"warning\" dismissible>\n  <span class=\"l-alert-title\">Heads up</span>\n  This action cannot be undone.\n</l-alert>"
-            }
-          ],
-          "_cssClasses": [
-            {
-              "name": ".l-alert-icon",
-              "description": "The leading icon, colored by variant (auto-injected)."
-            },
-            {
-              "name": ".l-alert-content",
-              "description": "Wrapper the authored children are moved into; stacks them vertically (auto-injected)."
-            },
-            {
-              "name": ".l-alert-title",
-              "description": "Optional bold heading placed above the body content. Use a real heading element (e.g. `<h3 class=\"l-alert-title\">`) when the alert is a section callout so it is reachable by heading navigation."
-            }
-          ]
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "Alert",
-          "declaration": {
-            "name": "Alert",
-            "module": "src/html/elements/alert/alert.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/html/elements/alert/index.ts",
-      "declarations": [],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "*",
-          "declaration": {
-            "name": "*",
-            "module": "src/html/elements/alert/alert.js"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/html/elements/avatar/avatar.ts",
-      "declarations": [
-        {
-          "kind": "class",
-          "description": "",
-          "name": "Avatar",
-          "cssProperties": [
-            {
-              "description": "Box size (any length). Set it inline (e.g. `style=\"--size: 20px\"`) for an arbitrary size beyond the `size` token scale; the font then follows proportionally. The `size` attribute sets it to the matching token.",
-              "name": "--size",
-              "default": "40px"
-            },
-            {
-              "description": "Background fill color for initials and the default icon.",
-              "name": "--color"
-            },
-            {
-              "description": "Initials/icon color over `--color`. Defaults to an auto-derived readable color; set it to enforce a specific brand color (overrides the automatic choice).",
-              "name": "--text-color"
-            },
-            {
-              "description": "Set to `circle` for a fully circular avatar (default is a rounded square).",
-              "name": "--appearance"
-            }
-          ],
-          "cssParts": [
-            {
-              "description": "The avatar container that paints `--color`; style it (e.g. `color`) to override the auto-derived text color.",
-              "name": "base"
-            }
-          ],
-          "members": [
-            {
-              "kind": "field",
-              "name": "src",
-              "type": {
-                "text": "string"
-              },
-              "default": "''",
-              "description": "Image URL. Falls back to initials (then the default icon) if it fails to load.",
-              "attribute": "src"
-            },
-            {
-              "kind": "field",
-              "name": "name",
-              "type": {
-                "text": "string"
-              },
-              "default": "''",
-              "description": "Name used as the accessible label and to derive the initials fallback.",
-              "attribute": "name"
-            },
-            {
-              "kind": "field",
-              "name": "size",
-              "type": {
-                "text": "string"
-              },
-              "default": "'md'",
-              "description": "Avatar size: `xs`, `sm`, `md` (default), `lg`, or `xl`.",
-              "attribute": "size",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "badge",
-              "type": {
-                "text": "number"
-              },
-              "default": "0",
-              "description": "Count shown in the corner badge. `0` hides the badge.",
-              "attribute": "badge"
-            },
-            {
-              "kind": "field",
-              "name": "interactive",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Render as a `<button>` with focus ring and hover states.",
-              "attribute": "interactive",
-              "reflects": true
-            }
-          ],
-          "attributes": [
-            {
-              "name": "src",
-              "type": {
-                "text": "string"
-              },
-              "default": "''",
-              "description": "Image URL. Falls back to initials (then the default icon) if it fails to load.",
-              "fieldName": "src"
-            },
-            {
-              "name": "name",
-              "type": {
-                "text": "string"
-              },
-              "default": "''",
-              "description": "Name used as the accessible label and to derive the initials fallback.",
-              "fieldName": "name"
-            },
-            {
-              "name": "size",
-              "type": {
-                "text": "string"
-              },
-              "default": "'md'",
-              "description": "Avatar size: `xs`, `sm`, `md` (default), `lg`, or `xl`.",
-              "fieldName": "size"
-            },
-            {
-              "name": "badge",
-              "type": {
-                "text": "number"
-              },
-              "default": "0",
-              "description": "Count shown in the corner badge. `0` hides the badge.",
-              "fieldName": "badge"
-            },
-            {
-              "name": "interactive",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Render as a `<button>` with focus ring and hover states.",
-              "fieldName": "interactive"
-            }
-          ],
-          "superclass": {
-            "name": "LuxenElement",
-            "module": "/src/html/shared/luxen-element.js"
-          },
-          "tagName": "l-avatar",
-          "customElement": true,
-          "summary": "An avatar component for displaying user images, initials, or a default icon.",
-          "_cssClasses": [
-            {
-              "name": ".l-avatar-group",
-              "description": "Flex wrapper that overlaps a row of stacked avatars."
-            }
-          ]
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "Avatar",
-          "declaration": {
-            "name": "Avatar",
-            "module": "src/html/elements/avatar/avatar.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/html/elements/avatar/index.ts",
-      "declarations": [],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "*",
-          "declaration": {
-            "name": "*",
-            "module": "src/html/elements/avatar/avatar.js"
-          }
-        }
-      ]
-    },
     {
       "kind": "javascript-module",
       "path": "src/html/elements/alert-dialog/alert-dialog.ts",
@@ -439,348 +94,709 @@
           ],
           "cssParts": [
             {
-              "description": "The native `<dialog>` element.",
-              "name": "dialog",
+              "description": "The native `<dialog>` element.",
+              "name": "dialog",
+              "inheritedFrom": {
+                "name": "Dialog",
+                "module": "src/html/elements/dialog/dialog.ts"
+              }
+            },
+            {
+              "description": "The header wrapper containing the title.",
+              "name": "header",
+              "inheritedFrom": {
+                "name": "Dialog",
+                "module": "src/html/elements/dialog/dialog.ts"
+              }
+            },
+            {
+              "description": "The dialog title heading.",
+              "name": "title",
+              "inheritedFrom": {
+                "name": "Dialog",
+                "module": "src/html/elements/dialog/dialog.ts"
+              }
+            },
+            {
+              "description": "The body wrapper around the description.",
+              "name": "body",
+              "inheritedFrom": {
+                "name": "Dialog",
+                "module": "src/html/elements/dialog/dialog.ts"
+              }
+            },
+            {
+              "description": "The footer wrapper around the actions.",
+              "name": "footer",
+              "inheritedFrom": {
+                "name": "Dialog",
+                "module": "src/html/elements/dialog/dialog.ts"
+              }
+            },
+            {
+              "description": "Both built-in action buttons.",
+              "name": "button"
+            },
+            {
+              "description": "The built-in cancel button.",
+              "name": "cancel"
+            },
+            {
+              "description": "The built-in confirm button.",
+              "name": "confirm"
+            }
+          ],
+          "slots": [
+            {
+              "description": "Description text. Provides the dialog's accessible description.",
+              "name": "",
+              "inheritedFrom": {
+                "name": "Dialog",
+                "module": "src/html/elements/dialog/dialog.ts"
+              }
+            },
+            {
+              "description": "Custom heading element. Overrides the default `<h2>` rendered from the `title` property. Also provides the dialog's accessible name.",
+              "name": "title",
+              "inheritedFrom": {
+                "name": "Dialog",
+                "module": "src/html/elements/dialog/dialog.ts"
+              }
+            },
+            {
+              "description": "Replaces the built-in cancel action (e.g. a link). Keep it focusable.",
+              "name": "cancel"
+            },
+            {
+              "description": "Replaces the built-in confirm action.",
+              "name": "confirm"
+            },
+            {
+              "description": "Close button (typically `<button class=\"l-close\">`).",
+              "name": "close",
+              "inheritedFrom": {
+                "name": "Dialog",
+                "module": "src/html/elements/dialog/dialog.ts"
+              }
+            },
+            {
+              "description": "Footer actions.",
+              "name": "footer",
+              "inheritedFrom": {
+                "name": "Dialog",
+                "module": "src/html/elements/dialog/dialog.ts"
+              }
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "confirmText",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Confirm'",
+              "description": "Label for the confirm action.",
+              "attribute": "confirm-text"
+            },
+            {
+              "kind": "field",
+              "name": "cancelText",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Cancel'",
+              "description": "Label for the cancel action.",
+              "attribute": "cancel-text"
+            },
+            {
+              "kind": "field",
+              "name": "tone",
+              "type": {
+                "text": "'danger' | undefined"
+              },
+              "description": "Visual tone. `danger` renders the confirm action as destructive.",
+              "attribute": "tone",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "loading",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Show a busy state on the confirm action (spinner + `aria-disabled`); the\ncancel action stays operable as an escape hatch.",
+              "attribute": "loading",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "title",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Dialog title rendered in the header and used as the dialog's accessible name.",
+              "attribute": "title",
               "inheritedFrom": {
                 "name": "Dialog",
                 "module": "src/html/elements/dialog/dialog.ts"
               }
             },
             {
-              "description": "The header wrapper containing the title.",
-              "name": "header",
+              "kind": "field",
+              "name": "open",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether the dialog is open.",
+              "attribute": "open",
+              "reflects": true,
               "inheritedFrom": {
                 "name": "Dialog",
                 "module": "src/html/elements/dialog/dialog.ts"
               }
             },
             {
-              "description": "The dialog title heading.",
-              "name": "title",
+              "kind": "field",
+              "name": "lightDismiss",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Close when the backdrop is clicked.",
+              "attribute": "light-dismiss",
+              "reflects": true,
               "inheritedFrom": {
                 "name": "Dialog",
                 "module": "src/html/elements/dialog/dialog.ts"
               }
             },
             {
-              "description": "The body wrapper around the description.",
-              "name": "body",
+              "kind": "field",
+              "name": "withoutHeader",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Hide the header entirely (title and close slot).",
+              "attribute": "without-header",
+              "reflects": true,
               "inheritedFrom": {
                 "name": "Dialog",
                 "module": "src/html/elements/dialog/dialog.ts"
               }
             },
             {
-              "description": "The footer wrapper around the actions.",
-              "name": "footer",
+              "kind": "field",
+              "name": "dialog",
+              "type": {
+                "text": "HTMLDialogElement"
+              },
               "inheritedFrom": {
                 "name": "Dialog",
                 "module": "src/html/elements/dialog/dialog.ts"
               }
+            }
+          ],
+          "events": [
+            {
+              "name": "confirm",
+              "description": "Fired when the user accepts. Cancelable — `preventDefault()` keeps it open for async work.",
+              "cancelable": true
             },
             {
-              "description": "Both built-in action buttons.",
-              "name": "button"
+              "name": "cancel",
+              "description": "Fired when the user dismisses (cancel action, Escape). Cancelable — `preventDefault()` keeps it open.",
+              "cancelable": true
             },
             {
-              "description": "The built-in cancel button.",
-              "name": "cancel"
+              "name": "show",
+              "description": "Fired when the dialog is about to open. Cancelable.",
+              "cancelable": true
             },
             {
-              "description": "The built-in confirm button.",
-              "name": "confirm"
+              "name": "hide",
+              "description": "Fired when the dialog is about to close via the `open` property. Cancelable. (The confirm, cancel, and Escape paths close natively and emit `confirm`/`cancel` instead of `hide`.)",
+              "cancelable": true
+            },
+            {
+              "name": "after-show",
+              "description": "Fired after the open animation completes. Not cancelable.",
+              "cancelable": false
+            },
+            {
+              "name": "after-hide",
+              "description": "Fired after the close animation completes. Not cancelable.",
+              "cancelable": false
             }
           ],
-          "slots": [
+          "attributes": [
             {
-              "description": "Description text. Provides the dialog's accessible description.",
-              "name": "",
+              "name": "confirm-text",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Confirm'",
+              "description": "Label for the confirm action.",
+              "fieldName": "confirmText"
+            },
+            {
+              "name": "cancel-text",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Cancel'",
+              "description": "Label for the cancel action.",
+              "fieldName": "cancelText"
+            },
+            {
+              "name": "tone",
+              "type": {
+                "text": "'danger' | undefined"
+              },
+              "description": "Visual tone. `danger` renders the confirm action as destructive.",
+              "fieldName": "tone"
+            },
+            {
+              "name": "loading",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Show a busy state on the confirm action (spinner + `aria-disabled`); the\ncancel action stays operable as an escape hatch.",
+              "fieldName": "loading"
+            },
+            {
+              "name": "title",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Dialog title rendered in the header and used as the dialog's accessible name.",
+              "fieldName": "title",
               "inheritedFrom": {
                 "name": "Dialog",
                 "module": "src/html/elements/dialog/dialog.ts"
               }
             },
             {
-              "description": "Custom heading element. Overrides the default `<h2>` rendered from the `title` property. Also provides the dialog's accessible name.",
-              "name": "title",
+              "name": "open",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether the dialog is open.",
+              "fieldName": "open",
               "inheritedFrom": {
                 "name": "Dialog",
                 "module": "src/html/elements/dialog/dialog.ts"
               }
             },
             {
-              "description": "Replaces the built-in cancel action (e.g. a link). Keep it focusable.",
-              "name": "cancel"
-            },
-            {
-              "description": "Replaces the built-in confirm action.",
-              "name": "confirm"
-            },
-            {
-              "description": "Close button (typically `<button class=\"l-close\">`).",
-              "name": "close",
+              "name": "light-dismiss",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Close when the backdrop is clicked.",
+              "fieldName": "lightDismiss",
               "inheritedFrom": {
                 "name": "Dialog",
                 "module": "src/html/elements/dialog/dialog.ts"
               }
             },
             {
-              "description": "Footer actions.",
-              "name": "footer",
+              "name": "without-header",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Hide the header entirely (title and close slot).",
+              "fieldName": "withoutHeader",
               "inheritedFrom": {
                 "name": "Dialog",
                 "module": "src/html/elements/dialog/dialog.ts"
               }
             }
           ],
+          "superclass": {
+            "name": "Dialog",
+            "module": "/src/html/elements/dialog/dialog.js"
+          },
+          "tagName": "l-alert-dialog",
+          "customElement": true,
+          "commands": [
+            {
+              "name": "--show",
+              "description": "Sets `open = true`."
+            },
+            {
+              "name": "--hide",
+              "description": "Sets `open = false`."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "ConfirmEvent",
+          "declaration": {
+            "name": "ConfirmEvent",
+            "module": "src/html/elements/alert-dialog/alert-dialog.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "CancelEvent",
+          "declaration": {
+            "name": "CancelEvent",
+            "module": "src/html/elements/alert-dialog/alert-dialog.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AlertDialog",
+          "declaration": {
+            "name": "AlertDialog",
+            "module": "src/html/elements/alert-dialog/alert-dialog.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/html/elements/alert-dialog/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "module": "src/html/elements/alert-dialog/alert-dialog.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/html/elements/alert/alert.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "",
+          "name": "Alert",
+          "cssProperties": [
+            {
+              "description": "Gap between the icon, content, and close button.",
+              "name": "--gap",
+              "default": "0.75rem"
+            },
+            {
+              "description": "Inner padding.",
+              "name": "--padding",
+              "default": "1rem"
+            },
+            {
+              "description": "Corner radius.",
+              "name": "--border-radius",
+              "default": "8px"
+            }
+          ],
           "members": [
             {
               "kind": "field",
-              "name": "confirmText",
+              "name": "variant",
               "type": {
-                "text": "string"
+                "text": "AlertVariant | undefined"
               },
-              "default": "'Confirm'",
-              "description": "Label for the confirm action.",
-              "attribute": "confirm-text"
+              "description": "Semantic variant: `info`, `success`, `warning`, or `danger`. Default is neutral.",
+              "attribute": "variant",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "cancelText",
+              "name": "icon",
               "type": {
-                "text": "string"
+                "text": "string | undefined"
               },
-              "default": "'Cancel'",
-              "description": "Label for the cancel action.",
-              "attribute": "cancel-text"
+              "description": "Iconify icon name (e.g. `lucide:bell`) overriding the variant's default icon.",
+              "attribute": "icon"
             },
             {
               "kind": "field",
-              "name": "tone",
+              "name": "withoutIcon",
               "type": {
-                "text": "'danger' | undefined"
+                "text": "boolean"
               },
-              "description": "Visual tone. `danger` renders the confirm action as destructive.",
-              "attribute": "tone",
-              "reflects": true
+              "default": "false",
+              "description": "Hide the leading icon entirely.",
+              "attribute": "without-icon"
             },
             {
               "kind": "field",
-              "name": "loading",
+              "name": "dismissible",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Show a busy state on the confirm action (spinner + `aria-disabled`); the\ncancel action stays operable as an escape hatch.",
-              "attribute": "loading",
+              "description": "Show a close button that dismisses the alert when clicked.",
+              "attribute": "dismissible",
               "reflects": true
+            }
+          ],
+          "events": [
+            {
+              "name": "hide",
+              "description": "Emitted when a dismissible alert is about to close. Cancelable — call `event.preventDefault()` to keep it open.",
+              "cancelable": true
             },
             {
-              "kind": "field",
-              "name": "title",
+              "name": "after-hide",
+              "description": "Emitted after the dismiss animation completes and the alert is removed from the DOM. Not cancelable.",
+              "cancelable": false
+            }
+          ],
+          "attributes": [
+            {
+              "name": "variant",
               "type": {
-                "text": "string"
+                "text": "AlertVariant | undefined"
               },
-              "default": "''",
-              "description": "Dialog title rendered in the header and used as the dialog's accessible name.",
-              "attribute": "title",
-              "inheritedFrom": {
-                "name": "Dialog",
-                "module": "src/html/elements/dialog/dialog.ts"
-              }
+              "description": "Semantic variant: `info`, `success`, `warning`, or `danger`. Default is neutral.",
+              "fieldName": "variant"
             },
             {
-              "kind": "field",
-              "name": "open",
+              "name": "icon",
               "type": {
-                "text": "boolean"
+                "text": "string | undefined"
               },
-              "default": "false",
-              "description": "Whether the dialog is open.",
-              "attribute": "open",
-              "reflects": true,
-              "inheritedFrom": {
-                "name": "Dialog",
-                "module": "src/html/elements/dialog/dialog.ts"
-              }
+              "description": "Iconify icon name (e.g. `lucide:bell`) overriding the variant's default icon.",
+              "fieldName": "icon"
             },
             {
-              "kind": "field",
-              "name": "lightDismiss",
+              "name": "without-icon",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Close when the backdrop is clicked.",
-              "attribute": "light-dismiss",
-              "reflects": true,
-              "inheritedFrom": {
-                "name": "Dialog",
-                "module": "src/html/elements/dialog/dialog.ts"
-              }
+              "description": "Hide the leading icon entirely.",
+              "fieldName": "withoutIcon"
             },
             {
-              "kind": "field",
-              "name": "withoutHeader",
+              "name": "dismissible",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Hide the header entirely (title and close slot).",
-              "attribute": "without-header",
-              "reflects": true,
-              "inheritedFrom": {
-                "name": "Dialog",
-                "module": "src/html/elements/dialog/dialog.ts"
-              }
-            },
+              "description": "Show a close button that dismisses the alert when clicked.",
+              "fieldName": "dismissible"
+            }
+          ],
+          "superclass": {
+            "name": "LuxenElement",
+            "module": "/src/html/shared/luxen-element.js"
+          },
+          "tagName": "l-alert",
+          "customElement": true,
+          "summary": "A callout box that highlights contextual information with a semantic color and a leading icon.",
+          "examples": [
             {
-              "kind": "field",
-              "name": "dialog",
-              "type": {
-                "text": "HTMLDialogElement"
-              },
-              "inheritedFrom": {
-                "name": "Dialog",
-                "module": "src/html/elements/dialog/dialog.ts"
-              }
+              "language": "html",
+              "code": "<l-alert variant=\"warning\" dismissible>\n  <span class=\"l-alert-title\">Heads up</span>\n  This action cannot be undone.\n</l-alert>"
             }
           ],
-          "events": [
+          "_cssClasses": [
             {
-              "name": "confirm",
-              "description": "Fired when the user accepts. Cancelable — `preventDefault()` keeps it open for async work.",
-              "cancelable": true
+              "name": ".l-alert-icon",
+              "description": "The leading icon, colored by variant (auto-injected)."
             },
             {
-              "name": "cancel",
-              "description": "Fired when the user dismisses (cancel action, Escape). Cancelable — `preventDefault()` keeps it open.",
-              "cancelable": true
+              "name": ".l-alert-content",
+              "description": "Wrapper the authored children are moved into; stacks them vertically (auto-injected)."
             },
             {
-              "name": "show",
-              "description": "Fired when the dialog is about to open. Cancelable.",
-              "cancelable": true
+              "name": ".l-alert-title",
+              "description": "Optional bold heading placed above the body content. Use a real heading element (e.g. `<h3 class=\"l-alert-title\">`) when the alert is a section callout so it is reachable by heading navigation."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "Alert",
+          "declaration": {
+            "name": "Alert",
+            "module": "src/html/elements/alert/alert.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/html/elements/alert/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "module": "src/html/elements/alert/alert.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/html/elements/avatar/avatar.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "",
+          "name": "Avatar",
+          "cssProperties": [
+            {
+              "description": "Box size (any length). Set it inline (e.g. `style=\"--size: 20px\"`) for an arbitrary size beyond the `size` token scale; the font then follows proportionally. The `size` attribute sets it to the matching token.",
+              "name": "--size",
+              "default": "40px"
             },
             {
-              "name": "hide",
-              "description": "Fired when the dialog is about to close via the `open` property. Cancelable. (The confirm, cancel, and Escape paths close natively and emit `confirm`/`cancel` instead of `hide`.)",
-              "cancelable": true
+              "description": "Background fill color for initials and the default icon.",
+              "name": "--color"
             },
             {
-              "name": "after-show",
-              "description": "Fired after the open animation completes. Not cancelable.",
-              "cancelable": false
+              "description": "Initials/icon color over `--color`. Defaults to an auto-derived readable color; set it to enforce a specific brand color (overrides the automatic choice).",
+              "name": "--text-color"
             },
             {
-              "name": "after-hide",
-              "description": "Fired after the close animation completes. Not cancelable.",
-              "cancelable": false
+              "description": "Set to `circle` for a fully circular avatar (default is a rounded square).",
+              "name": "--appearance"
             }
           ],
-          "attributes": [
+          "cssParts": [
             {
-              "name": "confirm-text",
+              "description": "The avatar container that paints `--color`; style it (e.g. `color`) to override the auto-derived text color.",
+              "name": "base"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "src",
               "type": {
                 "text": "string"
               },
-              "default": "'Confirm'",
-              "description": "Label for the confirm action.",
-              "fieldName": "confirmText"
+              "default": "''",
+              "description": "Image URL. Falls back to initials (then the default icon) if it fails to load.",
+              "attribute": "src"
             },
             {
-              "name": "cancel-text",
+              "kind": "field",
+              "name": "name",
               "type": {
                 "text": "string"
               },
-              "default": "'Cancel'",
-              "description": "Label for the cancel action.",
-              "fieldName": "cancelText"
+              "default": "''",
+              "description": "Name used as the accessible label and to derive the initials fallback.",
+              "attribute": "name"
             },
             {
-              "name": "tone",
+              "kind": "field",
+              "name": "size",
               "type": {
-                "text": "'danger' | undefined"
+                "text": "string"
               },
-              "description": "Visual tone. `danger` renders the confirm action as destructive.",
-              "fieldName": "tone"
+              "default": "'md'",
+              "description": "Avatar size: `xs`, `sm`, `md` (default), `lg`, or `xl`.",
+              "attribute": "size",
+              "reflects": true
             },
             {
-              "name": "loading",
+              "kind": "field",
+              "name": "badge",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "description": "Count shown in the corner badge. `0` hides the badge.",
+              "attribute": "badge"
+            },
+            {
+              "kind": "field",
+              "name": "interactive",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Show a busy state on the confirm action (spinner + `aria-disabled`); the\ncancel action stays operable as an escape hatch.",
-              "fieldName": "loading"
+              "description": "Render as a `<button>` with focus ring and hover states.",
+              "attribute": "interactive",
+              "reflects": true
+            }
+          ],
+          "attributes": [
+            {
+              "name": "src",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Image URL. Falls back to initials (then the default icon) if it fails to load.",
+              "fieldName": "src"
             },
             {
-              "name": "title",
+              "name": "name",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "description": "Dialog title rendered in the header and used as the dialog's accessible name.",
-              "fieldName": "title",
-              "inheritedFrom": {
-                "name": "Dialog",
-                "module": "src/html/elements/dialog/dialog.ts"
-              }
+              "description": "Name used as the accessible label and to derive the initials fallback.",
+              "fieldName": "name"
             },
             {
-              "name": "open",
+              "name": "size",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "description": "Whether the dialog is open.",
-              "fieldName": "open",
-              "inheritedFrom": {
-                "name": "Dialog",
-                "module": "src/html/elements/dialog/dialog.ts"
-              }
+              "default": "'md'",
+              "description": "Avatar size: `xs`, `sm`, `md` (default), `lg`, or `xl`.",
+              "fieldName": "size"
             },
             {
-              "name": "light-dismiss",
+              "name": "badge",
               "type": {
-                "text": "boolean"
+                "text": "number"
               },
-              "default": "false",
-              "description": "Close when the backdrop is clicked.",
-              "fieldName": "lightDismiss",
-              "inheritedFrom": {
-                "name": "Dialog",
-                "module": "src/html/elements/dialog/dialog.ts"
-              }
+              "default": "0",
+              "description": "Count shown in the corner badge. `0` hides the badge.",
+              "fieldName": "badge"
             },
             {
-              "name": "without-header",
+              "name": "interactive",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Hide the header entirely (title and close slot).",
-              "fieldName": "withoutHeader",
-              "inheritedFrom": {
-                "name": "Dialog",
-                "module": "src/html/elements/dialog/dialog.ts"
-              }
+              "description": "Render as a `<button>` with focus ring and hover states.",
+              "fieldName": "interactive"
             }
           ],
           "superclass": {
-            "name": "Dialog",
-            "module": "/src/html/elements/dialog/dialog.js"
+            "name": "LuxenElement",
+            "module": "/src/html/shared/luxen-element.js"
           },
-          "tagName": "l-alert-dialog",
+          "tagName": "l-avatar",
           "customElement": true,
-          "commands": [
-            {
-              "name": "--show",
-              "description": "Sets `open = true`."
-            },
+          "summary": "An avatar component for displaying user images, initials, or a default icon.",
+          "_cssClasses": [
             {
-              "name": "--hide",
-              "description": "Sets `open = false`."
+              "name": ".l-avatar-group",
+              "description": "Flex wrapper that overlaps a row of stacked avatars."
             }
           ]
         }
@@ -788,33 +804,17 @@
       "exports": [
         {
           "kind": "js",
-          "name": "ConfirmEvent",
-          "declaration": {
-            "name": "ConfirmEvent",
-            "module": "src/html/elements/alert-dialog/alert-dialog.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "CancelEvent",
-          "declaration": {
-            "name": "CancelEvent",
-            "module": "src/html/elements/alert-dialog/alert-dialog.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "AlertDialog",
+          "name": "Avatar",
           "declaration": {
-            "name": "AlertDialog",
-            "module": "src/html/elements/alert-dialog/alert-dialog.ts"
+            "name": "Avatar",
+            "module": "src/html/elements/avatar/avatar.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/html/elements/alert-dialog/index.ts",
+      "path": "src/html/elements/avatar/index.ts",
       "declarations": [],
       "exports": [
         {
@@ -822,7 +822,7 @@
           "name": "*",
           "declaration": {
             "name": "*",
-            "module": "src/html/elements/alert-dialog/alert-dialog.js"
+            "module": "src/html/elements/avatar/avatar.js"
           }
         }
       ]
@@ -6545,6 +6545,88 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/html/elements/skeleton/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "module": "src/html/elements/skeleton/skeleton.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/html/elements/skeleton/skeleton.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "",
+          "name": "Skeleton",
+          "cssProperties": [
+            {
+              "description": "Width of the skeleton",
+              "name": "--width"
+            },
+            {
+              "description": "Height of the skeleton",
+              "name": "--height"
+            }
+          ],
+          "members": [],
+          "attributes": [
+            {
+              "description": "circle | text — Placeholder shape. Default is a block.",
+              "name": "shape"
+            },
+            {
+              "description": "pulse | wave — Loading animation. Default is `pulse`.",
+              "name": "animation"
+            }
+          ],
+          "superclass": {
+            "name": "LuxenElement",
+            "module": "/src/html/shared/luxen-element.js"
+          },
+          "tagName": "l-skeleton",
+          "customElement": true,
+          "summary": "A skeleton loading placeholder.",
+          "_attributes": [
+            {
+              "name": "shape",
+              "values": [
+                "circle",
+                "text"
+              ],
+              "description": "Placeholder shape. Default is a block."
+            },
+            {
+              "name": "animation",
+              "values": [
+                "pulse",
+                "wave"
+              ],
+              "description": "Loading animation. Default is `pulse`."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "Skeleton",
+          "declaration": {
+            "name": "Skeleton",
+            "module": "src/html/elements/skeleton/skeleton.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/html/elements/select/index.ts",
@@ -6923,88 +7005,6 @@
         }
       ]
     },
-    {
-      "kind": "javascript-module",
-      "path": "src/html/elements/skeleton/index.ts",
-      "declarations": [],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "*",
-          "declaration": {
-            "name": "*",
-            "module": "src/html/elements/skeleton/skeleton.js"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/html/elements/skeleton/skeleton.ts",
-      "declarations": [
-        {
-          "kind": "class",
-          "description": "",
-          "name": "Skeleton",
-          "cssProperties": [
-            {
-              "description": "Width of the skeleton",
-              "name": "--width"
-            },
-            {
-              "description": "Height of the skeleton",
-              "name": "--height"
-            }
-          ],
-          "members": [],
-          "attributes": [
-            {
-              "description": "circle | text — Placeholder shape. Default is a block.",
-              "name": "shape"
-            },
-            {
-              "description": "pulse | wave — Loading animation. Default is `pulse`.",
-              "name": "animation"
-            }
-          ],
-          "superclass": {
-            "name": "LuxenElement",
-            "module": "/src/html/shared/luxen-element.js"
-          },
-          "tagName": "l-skeleton",
-          "customElement": true,
-          "summary": "A skeleton loading placeholder.",
-          "_attributes": [
-            {
-              "name": "shape",
-              "values": [
-                "circle",
-                "text"
-              ],
-              "description": "Placeholder shape. Default is a block."
-            },
-            {
-              "name": "animation",
-              "values": [
-                "pulse",
-                "wave"
-              ],
-              "description": "Loading animation. Default is `pulse`."
-            }
-          ]
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "Skeleton",
-          "declaration": {
-            "name": "Skeleton",
-            "module": "src/html/elements/skeleton/skeleton.ts"
-          }
-        }
-      ]
-    },
     {
       "kind": "javascript-module",
       "path": "src/html/elements/slider/index.ts",