@helixui/library 0.1.3 → 0.2.0

package/custom-elements.json

@@ -169,24 +169,18 @@
           ],
           "events": [
             {
-              "name": "eventName",
-              "type": {
-                "text": "CustomEvent"
-              }
-            },
-            {
+              "name": "hx-expand",
               "type": {
                 "text": "CustomEvent<{expanded: boolean, itemId: string}>"
               },
-              "description": "Dispatched when the item is expanded.",
-              "name": "hx-expand"
+              "description": "Dispatched when the item is expanded."
             },
             {
+              "name": "hx-collapse",
               "type": {
                 "text": "CustomEvent<{expanded: boolean, itemId: string}>"
               },
-              "description": "Dispatched when the item is collapsed.",
-              "name": "hx-collapse"
+              "description": "Dispatched when the item is collapsed."
             }
           ],
           "attributes": [
@@ -218,6 +212,14 @@
           "tagName": "hx-accordion-item",
           "customElement": true,
           "summary": "Collapsible panel that can be expanded or collapsed."
+        },
+        {
+          "kind": "variable",
+          "name": "detail",
+          "type": {
+            "text": "object"
+          },
+          "default": "{ expanded, itemId: this.id || '' }"
         }
       ],
       "exports": [
@@ -254,6 +256,12 @@
               "default": "var(--hx-border-radius-md)"
             }
           ],
+          "cssParts": [
+            {
+              "description": "The outer container wrapping all accordion items.",
+              "name": "accordion"
+            }
+          ],
           "slots": [
             {
               "description": "Default slot for hx-accordion-item elements.",
@@ -283,22 +291,9 @@
               }
             },
             {
-              "kind": "method",
+              "kind": "field",
               "name": "_handleChildExpand",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "e",
-                  "type": {
-                    "text": "CustomEvent<{ expanded: boolean; itemId: string }>"
-                  }
-                }
-              ]
+              "privacy": "private"
             },
             {
               "kind": "field",
@@ -399,723 +394,735 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/hx-action-bar/hx-action-bar.ts",
+      "path": "src/components/hx-alert/hx-alert.ts",
       "declarations": [
         {
           "kind": "class",
-          "description": "A horizontal toolbar container for grouping related action buttons and controls.\nImplements the ARIA toolbar pattern with roving tabindex keyboard navigation.",
-          "name": "HelixActionBar",
+          "description": "A feedback component for communicating status messages, warnings, and errors.\nCritical for healthcare patient safety alerts.",
+          "name": "HelixAlert",
           "cssProperties": [
             {
-              "description": "Bar background color (default variant).",
-              "name": "--hx-action-bar-bg",
-              "default": "transparent"
+              "description": "Alert background color.",
+              "name": "--hx-alert-bg",
+              "default": "var(--hx-color-info-50)"
             },
             {
-              "description": "Bar border (default variant).",
-              "name": "--hx-action-bar-border",
-              "default": "none"
+              "description": "Alert text color.",
+              "name": "--hx-alert-color",
+              "default": "var(--hx-color-info-800)"
             },
             {
-              "description": "Inner padding.",
-              "name": "--hx-action-bar-padding",
-              "default": "var(--hx-space-2,0.5rem) var(--hx-space-3,0.75rem)"
+              "description": "Alert border color.",
+              "name": "--hx-alert-border-color",
+              "default": "var(--hx-color-info-200)"
             },
             {
-              "description": "Gap between slotted items.",
-              "name": "--hx-action-bar-gap",
-              "default": "var(--hx-space-2,0.5rem)"
+              "description": "Alert border radius.",
+              "name": "--hx-alert-border-radius",
+              "default": "var(--hx-border-radius-md)"
             },
             {
-              "description": "Z-index when sticky or bottom position.",
-              "name": "--hx-action-bar-z-index",
-              "default": "10"
+              "description": "Alert border width.",
+              "name": "--hx-alert-border-width",
+              "default": "var(--hx-border-width-thin)"
+            },
+            {
+              "description": "Alert padding.",
+              "name": "--hx-alert-padding",
+              "default": "var(--hx-space-4)"
+            },
+            {
+              "description": "Gap between alert elements.",
+              "name": "--hx-alert-gap",
+              "default": "var(--hx-space-3)"
+            },
+            {
+              "description": "Alert icon color.",
+              "name": "--hx-alert-icon-color",
+              "default": "var(--hx-color-info-500)"
+            },
+            {
+              "description": "Alert font family.",
+              "name": "--hx-alert-font-family",
+              "default": "var(--hx-font-family-sans)"
+            },
+            {
+              "description": "Minimum touch target size for the close button.",
+              "name": "--hx-touch-target-size",
+              "default": "44px"
+            },
+            {
+              "description": "Width of the left border accent stripe.",
+              "name": "--hx-alert-accent-width",
+              "default": "4px"
             }
           ],
           "cssParts": [
             {
-              "description": "The root toolbar container element.",
-              "name": "base"
+              "description": "The outer alert container.",
+              "name": "alert"
             },
             {
-              "description": "The start (left) slot wrapper.",
-              "name": "start"
+              "description": "The title/headline container.",
+              "name": "title"
             },
             {
-              "description": "The center (default) slot wrapper.",
-              "name": "center"
+              "description": "The icon container.",
+              "name": "icon"
             },
             {
-              "description": "The end (right) slot wrapper.",
-              "name": "end"
+              "description": "The message content area.",
+              "name": "message"
+            },
+            {
+              "description": "The dismiss button (only rendered when dismissible).",
+              "name": "close-button"
+            },
+            {
+              "description": "The actions container.",
+              "name": "actions"
             }
           ],
           "slots": [
             {
-              "description": "Left-aligned actions.",
-              "name": "start"
+              "description": "Default slot for alert message content.",
+              "name": ""
             },
             {
-              "description": "Center content (default slot).",
-              "name": ""
+              "description": "Optional title/headline for the alert.",
+              "name": "title"
             },
             {
-              "description": "Right-aligned actions.",
-              "name": "end"
+              "description": "Custom icon to override the default variant icon.",
+              "name": "icon"
             },
             {
-              "description": "Actions revealed when the bar is constrained for space.",
-              "name": "overflow"
+              "description": "Action buttons rendered within the alert.",
+              "name": "actions"
             }
           ],
           "members": [
             {
               "kind": "field",
-              "name": "size",
+              "name": "variant",
               "type": {
-                "text": "'sm' | 'md' | 'lg'"
+                "text": "AlertVariant"
               },
-              "default": "'md'",
-              "description": "Size of the action bar — propagated as a data attribute to slotted children.",
-              "attribute": "size",
+              "default": "'info'",
+              "description": "Visual variant of the alert that determines colors and ARIA semantics.",
+              "attribute": "variant",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "variant",
+              "name": "dismissible",
               "type": {
-                "text": "'default' | 'outlined' | 'filled'"
+                "text": "boolean"
               },
-              "default": "'default'",
-              "description": "Visual variant controlling the bar background.",
-              "attribute": "variant",
+              "default": "false",
+              "description": "Whether the alert can be dismissed by the user.",
+              "attribute": "dismissible",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "position",
+              "name": "open",
               "type": {
-                "text": "'top' | 'bottom' | 'sticky'"
+                "text": "boolean"
               },
-              "default": "'top'",
-              "description": "Position and sticky behavior of the action bar.\n- `top` — normal flow (default)\n- `sticky` — sticks to the top of the scroll container; add `scroll-padding-top` to the\n  scroll container equal to the bar height to prevent anchor targets from scrolling behind it\n- `bottom` — sticks to the bottom of the scroll container with iOS safe-area-inset support",
-              "attribute": "position",
+              "default": "true",
+              "description": "Whether the alert is visible. Set to false to hide the alert.",
+              "attribute": "open",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "sticky",
+              "name": "showIcon",
               "type": {
                 "text": "boolean"
               },
-              "default": "false",
-              "deprecated": "Use `position=\"sticky\"` instead.\nWhen true, the bar sticks to the top of its scroll container.",
-              "attribute": "sticky",
+              "default": "true",
+              "description": "Whether to show the default variant icon. Set to false to hide the icon container entirely.\nNote: Boolean attribute semantics apply — the attribute must be absent (not set to \"false\")\nto hide the icon. `<hx-alert show-icon=\"false\">` still shows the icon because the attribute\nis present; use `<hx-alert>` (attribute absent) or `el.showIcon = false` to hide it.",
+              "attribute": "show-icon",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "ariaLabel",
+              "name": "accent",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "default": "'Actions'",
-              "description": "Accessible label for the toolbar.\nRequired when multiple toolbars appear on the same page.",
-              "attribute": "aria-label"
+              "default": "false",
+              "description": "When true, applies a left border accent stripe instead of a full border.\nCommon healthcare/enterprise dashboard pattern for visual distinction of alert types.",
+              "attribute": "accent",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "_focusableCache",
+              "name": "returnFocusTo",
               "type": {
-                "text": "HTMLElement[] | null"
+                "text": "string | null"
               },
-              "privacy": "private",
               "default": "null",
-              "description": "Cached list of focusable items — invalidated on slot change."
+              "description": "CSS selector for the element to return focus to after the alert is dismissed.\nWhen set, the component will find and focus the matching element after dismissal.\nIf not set, focus management is the caller's responsibility via the hx-after-close event.",
+              "attribute": "return-focus-to"
             },
             {
               "kind": "field",
-              "name": "_hasOverflow",
+              "name": "_hasActions",
               "type": {
                 "text": "boolean"
               },
               "privacy": "private",
-              "default": "false",
-              "description": "Whether the overflow slot has assigned content."
+              "default": "false"
             },
             {
               "kind": "field",
-              "name": "_handleKeydown",
+              "name": "_hasTitle",
+              "type": {
+                "text": "boolean"
+              },
               "privacy": "private",
-              "description": "Arrow function field — stable reference for add/removeEventListener."
+              "default": "false"
             },
             {
-              "kind": "method",
-              "name": "_isFocusable",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "boolean"
-                }
+              "kind": "field",
+              "name": "_actionsSlotChangeHandler",
+              "type": {
+                "text": "(() => void) | null"
               },
-              "parameters": [
-                {
-                  "name": "el",
-                  "type": {
-                    "text": "HTMLElement"
-                  }
-                }
-              ]
+              "privacy": "private",
+              "default": "null"
             },
             {
-              "kind": "method",
-              "name": "_getFocusableItems",
+              "kind": "field",
+              "name": "_titleSlotChangeHandler",
+              "type": {
+                "text": "(() => void) | null"
+              },
               "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "HTMLElement[]"
-                }
-              }
+              "default": "null"
             },
             {
-              "kind": "method",
-              "name": "_initRovingTabindex",
+              "kind": "field",
+              "name": "_isAssertive",
+              "type": {
+                "text": "boolean"
+              },
               "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              }
+              "description": "Returns true when the variant requires assertive announcement.",
+              "readonly": true
             },
             {
-              "kind": "method",
-              "name": "_moveFocus",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
+              "kind": "field",
+              "name": "_role",
+              "type": {
+                "text": "string"
               },
-              "parameters": [
-                {
-                  "name": "direction",
-                  "type": {
-                    "text": "'next' | 'prev'"
-                  }
-                }
-              ]
+              "privacy": "private",
+              "description": "Returns the appropriate ARIA role based on variant.\nrole=\"alert\" implies aria-live=\"assertive\"; role=\"status\" implies aria-live=\"polite\".\nWe do NOT set aria-live explicitly to avoid double-announcements in JAWS.",
+              "readonly": true
             },
             {
               "kind": "method",
-              "name": "_handleSlotChange",
+              "name": "_renderInfoIcon",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_renderSuccessIcon",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_renderWarningIcon",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_renderErrorIcon",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_renderDefaultIcon",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_renderCloseIcon",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_handleDismiss",
               "privacy": "private",
               "return": {
                 "type": {
                   "text": "void"
                 }
-              },
-              "parameters": [
-                {
-                  "name": "e",
-                  "type": {
-                    "text": "Event"
-                  }
-                }
-              ]
+              }
             }
           ],
-          "attributes": [
+          "events": [
             {
-              "name": "size",
+              "name": "hx-close",
               "type": {
-                "text": "'sm' | 'md' | 'lg'"
+                "text": "CustomEvent<{reason: string}>"
               },
-              "default": "'md'",
-              "description": "Size of the action bar — propagated as a data attribute to slotted children.",
-              "fieldName": "size",
-              "attribute": "size"
+              "description": "Dispatched when the user dismisses the alert."
             },
+            {
+              "name": "hx-after-close",
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "Dispatched after the alert is dismissed."
+            }
+          ],
+          "attributes": [
             {
               "name": "variant",
               "type": {
-                "text": "'default' | 'outlined' | 'filled'"
+                "text": "AlertVariant"
               },
-              "default": "'default'",
-              "description": "Visual variant controlling the bar background.",
+              "default": "'info'",
+              "description": "Visual variant of the alert that determines colors and ARIA semantics.",
               "fieldName": "variant",
               "attribute": "variant"
             },
             {
-              "name": "position",
+              "name": "dismissible",
               "type": {
-                "text": "'top' | 'bottom' | 'sticky'"
+                "text": "boolean"
               },
-              "default": "'top'",
-              "description": "Position and sticky behavior of the action bar.\n- `top` — normal flow (default)\n- `sticky` — sticks to the top of the scroll container; add `scroll-padding-top` to the\n  scroll container equal to the bar height to prevent anchor targets from scrolling behind it\n- `bottom` — sticks to the bottom of the scroll container with iOS safe-area-inset support",
-              "fieldName": "position",
-              "attribute": "position"
+              "default": "false",
+              "description": "Whether the alert can be dismissed by the user.",
+              "fieldName": "dismissible",
+              "attribute": "dismissible"
             },
             {
-              "name": "sticky",
+              "name": "open",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "true",
+              "description": "Whether the alert is visible. Set to false to hide the alert.",
+              "fieldName": "open",
+              "attribute": "open"
+            },
+            {
+              "name": "show-icon",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "true",
+              "description": "Whether to show the default variant icon. Set to false to hide the icon container entirely.\nNote: Boolean attribute semantics apply — the attribute must be absent (not set to \"false\")\nto hide the icon. `<hx-alert show-icon=\"false\">` still shows the icon because the attribute\nis present; use `<hx-alert>` (attribute absent) or `el.showIcon = false` to hide it.",
+              "fieldName": "showIcon",
+              "attribute": "show-icon"
+            },
+            {
+              "name": "accent",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "deprecated": "Use `position=\"sticky\"` instead.\nWhen true, the bar sticks to the top of its scroll container.",
-              "fieldName": "sticky",
-              "attribute": "sticky"
+              "description": "When true, applies a left border accent stripe instead of a full border.\nCommon healthcare/enterprise dashboard pattern for visual distinction of alert types.",
+              "fieldName": "accent",
+              "attribute": "accent"
             },
             {
-              "name": "aria-label",
+              "name": "return-focus-to",
               "type": {
-                "text": "string"
+                "text": "string | null"
               },
-              "default": "'Actions'",
-              "description": "Accessible label for the toolbar.\nRequired when multiple toolbars appear on the same page.",
-              "fieldName": "ariaLabel",
-              "attribute": "aria-label"
+              "default": "null",
+              "description": "CSS selector for the element to return focus to after the alert is dismissed.\nWhen set, the component will find and focus the matching element after dismissal.\nIf not set, focus management is the caller's responsibility via the hx-after-close event.",
+              "fieldName": "returnFocusTo",
+              "attribute": "return-focus-to"
             }
           ],
           "superclass": {
             "name": "LitElement",
             "package": "lit"
           },
-          "tagName": "hx-action-bar",
+          "tagName": "hx-alert",
           "customElement": true,
-          "summary": "Horizontal action bar for grouping related controls."
+          "summary": "Feedback alert for status messages with variant-based styling and ARIA live regions."
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "HelixActionBar",
+          "name": "HelixAlert",
           "declaration": {
-            "name": "HelixActionBar",
-            "module": "src/components/hx-action-bar/hx-action-bar.ts"
+            "name": "HelixAlert",
+            "module": "src/components/hx-alert/hx-alert.ts"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "hx-action-bar",
+          "name": "hx-alert",
           "declaration": {
-            "name": "HelixActionBar",
-            "module": "src/components/hx-action-bar/hx-action-bar.ts"
+            "name": "HelixAlert",
+            "module": "src/components/hx-alert/hx-alert.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "HxAlert",
+          "declaration": {
+            "name": "HelixAlert",
+            "module": "src/components/hx-alert/hx-alert.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/hx-action-bar/index.ts",
+      "path": "src/components/hx-alert/index.ts",
       "declarations": [],
       "exports": [
         {
           "kind": "js",
-          "name": "HelixActionBar",
+          "name": "HelixAlert",
           "declaration": {
-            "name": "HelixActionBar",
-            "module": "./hx-action-bar.js"
+            "name": "HelixAlert",
+            "module": "./hx-alert.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AlertVariant",
+          "declaration": {
+            "name": "AlertVariant",
+            "module": "./hx-alert.js"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/hx-alert/hx-alert.ts",
+      "path": "src/components/hx-action-bar/hx-action-bar.ts",
       "declarations": [
         {
           "kind": "class",
-          "description": "A feedback component for communicating status messages, warnings, and errors.\nCritical for healthcare patient safety alerts.",
-          "name": "HelixAlert",
+          "description": "A horizontal toolbar container for grouping related action buttons and controls.\nImplements the ARIA toolbar pattern with roving tabindex keyboard navigation.",
+          "name": "HelixActionBar",
           "cssProperties": [
             {
-              "description": "Alert background color.",
-              "name": "--hx-alert-bg",
-              "default": "var(--hx-color-info-50)"
-            },
-            {
-              "description": "Alert text color.",
-              "name": "--hx-alert-color",
-              "default": "var(--hx-color-info-800)"
-            },
-            {
-              "description": "Alert border color.",
-              "name": "--hx-alert-border-color",
-              "default": "var(--hx-color-info-200)"
-            },
-            {
-              "description": "Alert border radius.",
-              "name": "--hx-alert-border-radius",
-              "default": "var(--hx-border-radius-md)"
-            },
-            {
-              "description": "Alert border width.",
-              "name": "--hx-alert-border-width",
-              "default": "var(--hx-border-width-thin)"
-            },
-            {
-              "description": "Alert padding.",
-              "name": "--hx-alert-padding",
-              "default": "var(--hx-space-4)"
-            },
-            {
-              "description": "Gap between alert elements.",
-              "name": "--hx-alert-gap",
-              "default": "var(--hx-space-3)"
+              "description": "Bar background color (default variant).",
+              "name": "--hx-action-bar-bg",
+              "default": "transparent"
             },
             {
-              "description": "Alert icon color.",
-              "name": "--hx-alert-icon-color",
-              "default": "var(--hx-color-info-500)"
+              "description": "Bar border (default variant).",
+              "name": "--hx-action-bar-border",
+              "default": "none"
             },
             {
-              "description": "Alert font family.",
-              "name": "--hx-alert-font-family",
-              "default": "var(--hx-font-family-sans)"
+              "description": "Inner padding.",
+              "name": "--hx-action-bar-padding",
+              "default": "var(--hx-space-2,0.5rem) var(--hx-space-3,0.75rem)"
             },
             {
-              "description": "Minimum touch target size for the close button.",
-              "name": "--hx-touch-target-size",
-              "default": "44px"
+              "description": "Gap between slotted items.",
+              "name": "--hx-action-bar-gap",
+              "default": "var(--hx-space-2,0.5rem)"
             },
             {
-              "description": "Width of the left border accent stripe.",
-              "name": "--hx-alert-accent-width",
-              "default": "4px"
+              "description": "Z-index when sticky or bottom position.",
+              "name": "--hx-action-bar-z-index",
+              "default": "10"
             }
           ],
           "cssParts": [
             {
-              "description": "The outer alert container.",
-              "name": "alert"
-            },
-            {
-              "description": "The title/headline container.",
-              "name": "title"
+              "description": "The root toolbar container element.",
+              "name": "base"
             },
             {
-              "description": "The icon container.",
-              "name": "icon"
+              "description": "The start (left) slot wrapper.",
+              "name": "start"
             },
             {
-              "description": "The message content area.",
-              "name": "message"
+              "description": "The center (default) slot wrapper.",
+              "name": "center"
             },
             {
-              "description": "The dismiss button (only rendered when dismissible).",
-              "name": "close-button"
+              "description": "The end (right) slot wrapper.",
+              "name": "end"
             },
             {
-              "description": "The actions container.",
-              "name": "actions"
+              "description": "The overflow slot wrapper (hidden when no overflow content).",
+              "name": "overflow"
             }
           ],
           "slots": [
             {
-              "description": "Default slot for alert message content.",
-              "name": ""
+              "description": "Left-aligned actions.",
+              "name": "start"
             },
             {
-              "description": "Optional title/headline for the alert.",
-              "name": "title"
+              "description": "Center content (default slot).",
+              "name": ""
             },
             {
-              "description": "Custom icon to override the default variant icon.",
-              "name": "icon"
+              "description": "Right-aligned actions.",
+              "name": "end"
             },
             {
-              "description": "Action buttons rendered within the alert.",
-              "name": "actions"
+              "description": "Actions revealed when the bar is constrained for space.",
+              "name": "overflow"
             }
           ],
           "members": [
             {
               "kind": "field",
-              "name": "variant",
-              "type": {
-                "text": "AlertVariant"
-              },
-              "default": "'info'",
-              "description": "Visual variant of the alert that determines colors and ARIA semantics.",
-              "attribute": "variant",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "dismissible",
+              "name": "size",
               "type": {
-                "text": "boolean"
+                "text": "'sm' | 'md' | 'lg'"
               },
-              "default": "false",
-              "description": "Whether the alert can be dismissed by the user.",
-              "attribute": "dismissible",
+              "default": "'md'",
+              "description": "Size of the action bar — propagated as a data attribute to slotted children.",
+              "attribute": "size",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "open",
+              "name": "variant",
               "type": {
-                "text": "boolean"
+                "text": "'default' | 'outlined' | 'filled'"
               },
-              "default": "true",
-              "description": "Whether the alert is visible. Set to false to hide the alert.",
-              "attribute": "open",
+              "default": "'default'",
+              "description": "Visual variant controlling the bar background.",
+              "attribute": "variant",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "showIcon",
+              "name": "position",
               "type": {
-                "text": "boolean"
+                "text": "'top' | 'bottom' | 'sticky'"
               },
-              "default": "true",
-              "description": "Whether to show the default variant icon. Set to false to hide the icon container entirely.\nNote: Boolean attribute semantics apply — the attribute must be absent (not set to \"false\")\nto hide the icon. `<hx-alert show-icon=\"false\">` still shows the icon because the attribute\nis present; use `<hx-alert>` (attribute absent) or `el.showIcon = false` to hide it.",
-              "attribute": "show-icon",
+              "default": "'top'",
+              "description": "Position and sticky behavior of the action bar.\n- `top` — normal flow (default)\n- `sticky` — sticks to the top of the scroll container; add `scroll-padding-top` to the\n  scroll container equal to the bar height to prevent anchor targets from scrolling behind it\n- `bottom` — sticks to the bottom of the scroll container with iOS safe-area-inset support",
+              "attribute": "position",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "accent",
+              "name": "sticky",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "When true, applies a left border accent stripe instead of a full border.\nCommon healthcare/enterprise dashboard pattern for visual distinction of alert types.",
-              "attribute": "accent",
+              "deprecated": "Use `position=\"sticky\"` instead.\nWhen true, the bar sticks to the top of its scroll container.",
+              "attribute": "sticky",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "returnFocusTo",
+              "name": "ariaLabel",
               "type": {
-                "text": "string | null"
+                "text": "string"
               },
-              "default": "null",
-              "description": "CSS selector for the element to return focus to after the alert is dismissed.\nWhen set, the component will find and focus the matching element after dismissal.\nIf not set, focus management is the caller's responsibility via the hx-after-close event.",
-              "attribute": "return-focus-to"
+              "default": "'Actions'",
+              "description": "Accessible label for the toolbar.\nRequired when multiple toolbars appear on the same page.",
+              "attribute": "aria-label"
             },
             {
               "kind": "field",
-              "name": "_hasActions",
+              "name": "_focusableCache",
               "type": {
-                "text": "boolean"
+                "text": "HTMLElement[] | null"
               },
               "privacy": "private",
-              "default": "false"
+              "default": "null",
+              "description": "Cached list of focusable items — invalidated on slot change."
             },
             {
               "kind": "field",
-              "name": "_hasTitle",
+              "name": "_hasOverflow",
               "type": {
                 "text": "boolean"
               },
               "privacy": "private",
-              "default": "false"
-            },
-            {
-              "kind": "field",
-              "name": "_actionsSlotChangeHandler",
-              "type": {
-                "text": "(() => void) | null"
-              },
-              "privacy": "private",
-              "default": "null"
+              "default": "false",
+              "description": "Whether the overflow slot has assigned content."
             },
             {
               "kind": "field",
-              "name": "_titleSlotChangeHandler",
-              "type": {
-                "text": "(() => void) | null"
-              },
+              "name": "_handleKeydown",
               "privacy": "private",
-              "default": "null"
+              "description": "Arrow function field — stable reference for add/removeEventListener."
             },
             {
-              "kind": "field",
-              "name": "_isAssertive",
-              "type": {
-                "text": "boolean"
-              },
+              "kind": "method",
+              "name": "_isFocusable",
               "privacy": "private",
-              "description": "Returns true when the variant requires assertive announcement.",
-              "readonly": true
-            },
-            {
-              "kind": "field",
-              "name": "_role",
-              "type": {
-                "text": "string"
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
               },
-              "privacy": "private",
-              "description": "Returns the appropriate ARIA role based on variant.\nrole=\"alert\" implies aria-live=\"assertive\"; role=\"status\" implies aria-live=\"polite\".\nWe do NOT set aria-live explicitly to avoid double-announcements in JAWS.",
-              "readonly": true
-            },
-            {
-              "kind": "method",
-              "name": "_renderInfoIcon",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "_renderSuccessIcon",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "_renderWarningIcon",
-              "privacy": "private"
+              "parameters": [
+                {
+                  "name": "el",
+                  "type": {
+                    "text": "HTMLElement"
+                  }
+                }
+              ]
             },
             {
               "kind": "method",
-              "name": "_renderErrorIcon",
-              "privacy": "private"
+              "name": "_getFocusableItems",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "HTMLElement[]"
+                }
+              }
             },
             {
               "kind": "method",
-              "name": "_renderDefaultIcon",
-              "privacy": "private"
+              "name": "_initRovingTabindex",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
             },
             {
               "kind": "method",
-              "name": "_renderCloseIcon",
-              "privacy": "private"
+              "name": "_moveFocus",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "direction",
+                  "type": {
+                    "text": "'next' | 'prev'"
+                  }
+                }
+              ]
             },
             {
               "kind": "method",
-              "name": "_handleDismiss",
+              "name": "_handleSlotChange",
               "privacy": "private",
               "return": {
                 "type": {
                   "text": "void"
                 }
-              }
+              },
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ]
             }
           ],
-          "events": [
+          "attributes": [
             {
-              "name": "hx-close",
+              "name": "size",
               "type": {
-                "text": "CustomEvent<{reason: string}>"
+                "text": "'sm' | 'md' | 'lg'"
               },
-              "description": "Dispatched when the user dismisses the alert."
+              "default": "'md'",
+              "description": "Size of the action bar — propagated as a data attribute to slotted children.",
+              "fieldName": "size",
+              "attribute": "size"
             },
-            {
-              "name": "hx-after-close",
-              "type": {
-                "text": "CustomEvent"
-              },
-              "description": "Dispatched after the alert is dismissed."
-            }
-          ],
-          "attributes": [
             {
               "name": "variant",
               "type": {
-                "text": "AlertVariant"
+                "text": "'default' | 'outlined' | 'filled'"
               },
-              "default": "'info'",
-              "description": "Visual variant of the alert that determines colors and ARIA semantics.",
+              "default": "'default'",
+              "description": "Visual variant controlling the bar background.",
               "fieldName": "variant",
               "attribute": "variant"
             },
             {
-              "name": "dismissible",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Whether the alert can be dismissed by the user.",
-              "fieldName": "dismissible",
-              "attribute": "dismissible"
-            },
-            {
-              "name": "open",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "true",
-              "description": "Whether the alert is visible. Set to false to hide the alert.",
-              "fieldName": "open",
-              "attribute": "open"
-            },
-            {
-              "name": "show-icon",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "true",
-              "description": "Whether to show the default variant icon. Set to false to hide the icon container entirely.\nNote: Boolean attribute semantics apply — the attribute must be absent (not set to \"false\")\nto hide the icon. `<hx-alert show-icon=\"false\">` still shows the icon because the attribute\nis present; use `<hx-alert>` (attribute absent) or `el.showIcon = false` to hide it.",
-              "fieldName": "showIcon",
-              "attribute": "show-icon"
+              "name": "position",
+              "type": {
+                "text": "'top' | 'bottom' | 'sticky'"
+              },
+              "default": "'top'",
+              "description": "Position and sticky behavior of the action bar.\n- `top` — normal flow (default)\n- `sticky` — sticks to the top of the scroll container; add `scroll-padding-top` to the\n  scroll container equal to the bar height to prevent anchor targets from scrolling behind it\n- `bottom` — sticks to the bottom of the scroll container with iOS safe-area-inset support",
+              "fieldName": "position",
+              "attribute": "position"
             },
             {
-              "name": "accent",
+              "name": "sticky",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "When true, applies a left border accent stripe instead of a full border.\nCommon healthcare/enterprise dashboard pattern for visual distinction of alert types.",
-              "fieldName": "accent",
-              "attribute": "accent"
+              "deprecated": "Use `position=\"sticky\"` instead.\nWhen true, the bar sticks to the top of its scroll container.",
+              "fieldName": "sticky",
+              "attribute": "sticky"
             },
             {
-              "name": "return-focus-to",
+              "name": "aria-label",
               "type": {
-                "text": "string | null"
+                "text": "string"
               },
-              "default": "null",
-              "description": "CSS selector for the element to return focus to after the alert is dismissed.\nWhen set, the component will find and focus the matching element after dismissal.\nIf not set, focus management is the caller's responsibility via the hx-after-close event.",
-              "fieldName": "returnFocusTo",
-              "attribute": "return-focus-to"
+              "default": "'Actions'",
+              "description": "Accessible label for the toolbar.\nRequired when multiple toolbars appear on the same page.",
+              "fieldName": "ariaLabel",
+              "attribute": "aria-label"
             }
           ],
           "superclass": {
             "name": "LitElement",
             "package": "lit"
           },
-          "tagName": "hx-alert",
+          "tagName": "hx-action-bar",
           "customElement": true,
-          "summary": "Feedback alert for status messages with variant-based styling and ARIA live regions."
+          "summary": "Horizontal action bar for grouping related controls."
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "HelixAlert",
+          "name": "HelixActionBar",
           "declaration": {
-            "name": "HelixAlert",
-            "module": "src/components/hx-alert/hx-alert.ts"
+            "name": "HelixActionBar",
+            "module": "src/components/hx-action-bar/hx-action-bar.ts"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "hx-alert",
-          "declaration": {
-            "name": "HelixAlert",
-            "module": "src/components/hx-alert/hx-alert.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "HxAlert",
+          "name": "hx-action-bar",
           "declaration": {
-            "name": "HelixAlert",
-            "module": "src/components/hx-alert/hx-alert.ts"
+            "name": "HelixActionBar",
+            "module": "src/components/hx-action-bar/hx-action-bar.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/hx-alert/index.ts",
+      "path": "src/components/hx-action-bar/index.ts",
       "declarations": [],
       "exports": [
         {
           "kind": "js",
-          "name": "HelixAlert",
+          "name": "HelixActionBar",
           "declaration": {
-            "name": "HelixAlert",
-            "module": "./hx-alert.js"
+            "name": "HelixActionBar",
+            "module": "./hx-action-bar.js"
           }
         }
       ]
@@ -2634,6 +2641,17 @@
               "description": "Form field value submitted via ElementInternals.setFormValue on submit.",
               "attribute": "value"
             },
+            {
+              "kind": "field",
+              "name": "ariaLabel",
+              "type": {
+                "text": "string | null"
+              },
+              "default": "null",
+              "description": "Accessible label forwarded to the inner button/anchor. Required for icon-only usage.",
+              "attribute": "aria-label",
+              "reflects": true
+            },
             {
               "kind": "field",
               "name": "form",
@@ -2664,12 +2682,22 @@
             {
               "kind": "method",
               "name": "_renderSpinner",
-              "privacy": "private"
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "TemplateResult"
+                }
+              }
             },
             {
               "kind": "method",
               "name": "_renderInner",
-              "privacy": "private"
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "TemplateResult"
+                }
+              }
             }
           ],
           "events": [
@@ -2771,6 +2799,16 @@
               "description": "Form field value submitted via ElementInternals.setFormValue on submit.",
               "fieldName": "value",
               "attribute": "value"
+            },
+            {
+              "name": "aria-label",
+              "type": {
+                "text": "string | null"
+              },
+              "default": "null",
+              "description": "Accessible label forwarded to the inner button/anchor. Required for icon-only usage.",
+              "fieldName": "ariaLabel",
+              "attribute": "aria-label"
             }
           ],
           "superclass": {
@@ -2822,7 +2860,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "A container component that groups related hx-button elements into a cohesive\nhorizontal or vertical action set. Eliminates double borders between adjacent\nbuttons and squares off inner border-radius for a unified visual appearance.",
+          "description": "A container component that groups related hx-button elements into a cohesive\nhorizontal or vertical action set. Eliminates double borders between adjacent\nbuttons and squares off inner border-radius for a unified visual appearance.\n\n**Accessibility:** Always provide an accessible label via `aria-label` or\n`aria-labelledby` so screen readers can announce the group purpose.",
           "name": "HelixButtonGroup",
           "cssProperties": [
             {
@@ -2881,19 +2919,9 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "Accessible label for the button group. Sets aria-label via ElementInternals.\nRequired for WCAG 2.1 AA compliance when the group purpose is not clear from context.\nAlternatively, consumers may apply aria-label directly as an HTML attribute.",
+              "description": "Accessible label for the button group. Sets aria-label via ElementInternals.\n**Strongly recommended** for WCAG 2.1 AA compliance — without it, screen\nreaders announce an unnamed \"group\". For Drupal/Twig compatibility, prefer\napplying `aria-label` directly as an HTML attribute instead.",
               "attribute": "label"
             },
-            {
-              "kind": "method",
-              "name": "_handleSlotChange",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              }
-            },
             {
               "kind": "field",
               "name": "role",
@@ -2930,7 +2958,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "Accessible label for the button group. Sets aria-label via ElementInternals.\nRequired for WCAG 2.1 AA compliance when the group purpose is not clear from context.\nAlternatively, consumers may apply aria-label directly as an HTML attribute.",
+              "description": "Accessible label for the button group. Sets aria-label via ElementInternals.\n**Strongly recommended** for WCAG 2.1 AA compliance — without it, screen\nreaders announce an unnamed \"group\". For Drupal/Twig compatibility, prefer\napplying `aria-label` directly as an HTML attribute instead.",
               "fieldName": "label",
               "attribute": "label"
             }
@@ -3072,6 +3100,16 @@
             }
           ],
           "members": [
+            {
+              "kind": "field",
+              "name": "shadowRootOptions",
+              "type": {
+                "text": "object"
+              },
+              "static": true,
+              "default": "{ ...LitElement.shadowRootOptions, delegatesFocus: true, }",
+              "description": "Enable delegatesFocus so :focus on the host works when the inner card div has focus."
+            },
             {
               "kind": "field",
               "name": "variant",
@@ -4263,6 +4301,11 @@
               "name": "--hx-checkbox-help-text-color",
               "default": "var(--hx-color-neutral-500, #6c757d)"
             },
+            {
+              "description": "Border color on hover.",
+              "name": "--hx-checkbox-hover-border-color",
+              "default": "var(--hx-checkbox-border-color)"
+            },
             {
               "description": "Error state color.",
               "name": "--hx-checkbox-error-color",
@@ -4558,6 +4601,24 @@
               ],
               "description": "Called when the form restores state (e.g., back/forward navigation)."
             },
+            {
+              "kind": "method",
+              "name": "formDisabledCallback",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "disabled",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ],
+              "description": "Called when a parent fieldset is disabled/enabled."
+            },
             {
               "kind": "method",
               "name": "_handleChange",
@@ -4810,6 +4871,11 @@
               "description": "Error message color.",
               "name": "--hx-checkbox-group-error-color",
               "default": "var(--hx-color-error-500, #dc3545)"
+            },
+            {
+              "description": "Help text color.",
+              "name": "--hx-checkbox-group-help-text-color",
+              "default": "var(--hx-color-neutral-500)"
             }
           ],
           "cssParts": [
@@ -6314,24 +6380,18 @@
           ],
           "events": [
             {
-              "name": "eventName",
-              "type": {
-                "text": "CustomEvent"
-              }
-            },
-            {
+              "name": "hx-input",
               "type": {
                 "text": "CustomEvent<{value: string}>"
               },
-              "description": "Dispatched while dragging sliders or grid.",
-              "name": "hx-input"
+              "description": "Dispatched while dragging sliders or grid."
             },
             {
+              "name": "hx-change",
               "type": {
                 "text": "CustomEvent<{value: string}>"
               },
-              "description": "Dispatched when a color is committed.",
-              "name": "hx-change"
+              "description": "Dispatched when a color is committed."
             }
           ],
           "attributes": [
@@ -6413,6 +6473,14 @@
           "tagName": "hx-color-picker",
           "customElement": true,
           "summary": "Color selection control with swatches, gradient picker, and formatted input."
+        },
+        {
+          "kind": "variable",
+          "name": "detail",
+          "type": {
+            "text": "object"
+          },
+          "default": "{ value: formatted }"
         }
       ],
       "exports": [
@@ -10420,7 +10488,7 @@
               "kind": "field",
               "name": "size",
               "type": {
-                "text": "DrawerSize | string"
+                "text": "DrawerSize"
               },
               "default": "'md'",
               "description": "The size of the drawer panel. Use 'sm', 'md', 'lg', 'full', or any valid CSS length.",
@@ -10764,7 +10832,7 @@
             {
               "name": "size",
               "type": {
-                "text": "DrawerSize | string"
+                "text": "DrawerSize"
               },
               "default": "'md'",
               "description": "The size of the drawer panel. Use 'sm', 'md', 'lg', 'full', or any valid CSS length.",
@@ -11290,6 +11358,14 @@
             "name": "HelixDropdown",
             "module": "./hx-dropdown.js"
           }
+        },
+        {
+          "kind": "js",
+          "name": "DropdownPlacement",
+          "declaration": {
+            "name": "DropdownPlacement",
+            "module": "./hx-dropdown.js"
+          }
         }
       ]
     },
@@ -11769,7 +11845,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "Standardized label for form fields. Used as a consistent sub-component\nfor hx-field and other form field components.\n\nWhen the `for` attribute is set, renders a native `<label for=\"...\">` element.\n**Note:** Due to the shadow DOM boundary, this label association only works\nwhen the associated input is in the **same shadow root**. For inputs in\nlight DOM (the typical consumer deployment), use `aria-labelledby` pointing\nto the host element's `id` instead of the `for` attribute.\n\nWhen `for` is unset, renders a `<span>` that can be referenced via\n`aria-labelledby` for labeling controls in a shadow DOM boundary.",
+          "description": "Standardized label for form fields. Used as a consistent sub-component\nfor hx-field and other form field components.\n\n## Label Association\n\n**For inputs in light DOM (the typical consumer deployment):** Use\n`aria-labelledby` pointing to the host element's `id`. The `for` attribute\nrenders a native `<label for=\"...\">` inside shadow DOM, but the HTML spec\nscopes `for`/`id` lookup to the same tree — a shadow-DOM label cannot\nassociate with a light-DOM input. Example:\n\n```html\n<hx-field-label id=\"label-email\">Email</hx-field-label>\n<input id=\"email\" aria-labelledby=\"label-email\" />\n```\n\n**For inputs in the same shadow root:** The `for` attribute works as\nexpected for direct label association.\n\nWhen `for` is unset, renders a `<span>` that can be referenced via\n`aria-labelledby` for labeling controls across the shadow DOM boundary.",
           "name": "HelixFieldLabel",
           "cssProperties": [
             {
@@ -11780,7 +11856,7 @@
             {
               "description": "Required indicator color.",
               "name": "--hx-field-label-required-color",
-              "default": "var(--hx-color-danger, var(--hx-color-error-500, #ef4444))"
+              "default": "var(--hx-color-danger, var(--hx-color-error-text, #b91c1c))"
             },
             {
               "description": "Label font size.",
@@ -11995,6 +12071,10 @@
             {
               "description": "The visible label element.",
               "name": "label"
+            },
+            {
+              "description": "The error message container below the dropzone.",
+              "name": "error"
             }
           ],
           "slots": [
@@ -14738,13 +14818,33 @@
             {
               "description": "Danger variant color.",
               "name": "--hx-link-color-danger",
-              "default": "var(--hx-color-error-500)"
+              "default": "var(--hx-color-error-text)"
+            },
+            {
+              "description": "Danger variant hover color.",
+              "name": "--hx-link-color-danger-hover",
+              "default": "var(--hx-color-error-700)"
+            },
+            {
+              "description": "Link font family.",
+              "name": "--hx-link-font-family",
+              "default": "var(--hx-font-family-sans)"
             },
             {
               "description": "Link text decoration.",
               "name": "--hx-link-text-decoration",
               "default": "underline"
             },
+            {
+              "description": "Hover text decoration.",
+              "name": "--hx-link-text-decoration-hover",
+              "default": "underline"
+            },
+            {
+              "description": "Text underline offset.",
+              "name": "--hx-link-underline-offset",
+              "default": "2px"
+            },
             {
               "description": "Focus ring color.",
               "name": "--hx-link-focus-ring-color",
@@ -15916,6 +16016,17 @@
             }
           ],
           "members": [
+            {
+              "kind": "field",
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Accessible label for the menu. Rendered as `aria-label` on the inner\n`role=\"menu\"` element when set.",
+              "attribute": "label",
+              "reflects": true
+            },
             {
               "kind": "field",
               "name": "_focusedIndex",
@@ -15952,6 +16063,17 @@
                 }
               }
             },
+            {
+              "kind": "method",
+              "name": "_syncRovingTabIndex",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Synchronize roving tabindex across all enabled items.\nOnly the active item (or first item if none active) gets tabindex=0."
+            },
             {
               "kind": "method",
               "name": "focusFirst",
@@ -16095,6 +16217,18 @@
               "description": "Dispatched when an item is selected."
             }
           ],
+          "attributes": [
+            {
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Accessible label for the menu. Rendered as `aria-label` on the inner\n`role=\"menu\"` element when set.",
+              "fieldName": "label",
+              "attribute": "label"
+            }
+          ],
           "superclass": {
             "name": "LitElement",
             "package": "lit"
@@ -16476,6 +16610,11 @@
               "name": "--hx-nav-color",
               "default": "var(--hx-color-neutral-100)"
             },
+            {
+              "description": "Navigation font family.",
+              "name": "--hx-nav-font-family",
+              "default": "var(--hx-font-family-sans)"
+            },
             {
               "description": "Link text color.",
               "name": "--hx-nav-link-color",
@@ -16506,6 +16645,11 @@
               "name": "--hx-nav-submenu-bg",
               "default": "var(--hx-color-neutral-800)"
             },
+            {
+              "description": "Submenu minimum width.",
+              "name": "--hx-nav-submenu-min-width",
+              "default": "12rem"
+            },
             {
               "description": "Navigation font size.",
               "name": "--hx-nav-font-size",
@@ -16681,6 +16825,12 @@
                   "type": {
                     "text": "NavItem"
                   }
+                },
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "Event"
+                  }
                 }
               ]
             },
@@ -16782,6 +16932,12 @@
                   "type": {
                     "text": "number"
                   }
+                },
+                {
+                  "name": "parentLabel",
+                  "type": {
+                    "text": "string"
+                  }
                 }
               ]
             },
@@ -20080,14 +20236,13 @@
               "readonly": true
             },
             {
-              "kind": "method",
-              "name": "_syncState",
+              "kind": "field",
+              "name": "_labelWarned",
+              "type": {
+                "text": "boolean"
+              },
               "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              }
+              "default": "false"
             }
           ],
           "attributes": [
@@ -20522,9 +20677,10 @@
               "kind": "field",
               "name": "_groupEl",
               "type": {
-                "text": "HTMLElement"
+                "text": "HTMLElement | null"
               },
-              "privacy": "private"
+              "privacy": "private",
+              "readonly": true
             },
             {
               "kind": "field",
@@ -23151,6 +23307,11 @@
               "name": "--hx-slider-thumb-border-color",
               "default": "var(--hx-color-primary-500)"
             },
+            {
+              "description": "Thumb border width.",
+              "name": "--hx-slider-thumb-border-width",
+              "default": "2px"
+            },
             {
               "description": "Thumb box shadow.",
               "name": "--hx-slider-thumb-shadow",
@@ -26293,7 +26454,7 @@
               "kind": "field",
               "name": "_trackEl",
               "type": {
-                "text": "HTMLButtonElement"
+                "text": "HTMLButtonElement | null"
               },
               "privacy": "private",
               "description": "Reference to the native button element acting as the switch track."
@@ -26586,6 +26747,22 @@
             "name": "HelixSwitch",
             "module": "./hx-switch.js"
           }
+        },
+        {
+          "kind": "js",
+          "name": "HxSwitch",
+          "declaration": {
+            "name": "HxSwitch",
+            "module": "./hx-switch.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "WcSwitch",
+          "declaration": {
+            "name": "WcSwitch",
+            "module": "./hx-switch.js"
+          }
         }
       ]
     },
@@ -28541,9 +28718,18 @@
                 "text": "number"
               },
               "default": "4",
-              "description": "The number of visible text rows.",
+              "description": "The number of visible text rows. Must be a positive integer (minimum 1).\nInvalid values are clamped to the nearest valid value.",
               "attribute": "rows"
             },
+            {
+              "kind": "field",
+              "name": "minlength",
+              "type": {
+                "text": "number | undefined"
+              },
+              "description": "Minimum number of characters required.",
+              "attribute": "minlength"
+            },
             {
               "kind": "field",
               "name": "maxlength",
@@ -28792,10 +28978,19 @@
                 "text": "number"
               },
               "default": "4",
-              "description": "The number of visible text rows.",
+              "description": "The number of visible text rows. Must be a positive integer (minimum 1).\nInvalid values are clamped to the nearest valid value.",
               "fieldName": "rows",
               "attribute": "rows"
             },
+            {
+              "name": "minlength",
+              "type": {
+                "text": "number | undefined"
+              },
+              "description": "Minimum number of characters required.",
+              "fieldName": "minlength",
+              "attribute": "minlength"
+            },
             {
               "name": "maxlength",
               "type": {