@helixui/library 0.3.3 → 0.3.4

package/custom-elements.json

@@ -394,191 +394,126 @@
     },
     {
       "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",
-              "type": {
-                "text": "string | null"
-              },
-              "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"
-            },
-            {
-              "kind": "field",
-              "name": "_hasActions",
-              "type": {
-                "text": "boolean"
-              },
-              "privacy": "private",
-              "default": "false"
-            },
-            {
-              "kind": "field",
-              "name": "_hasTitle",
+              "name": "_sticky",
               "type": {
                 "text": "boolean"
               },
@@ -587,342 +522,396 @@
             },
             {
               "kind": "field",
-              "name": "_actionsSlotChangeHandler",
+              "name": "ariaLabel",
               "type": {
-                "text": "(() => void) | null"
+                "text": "string"
               },
-              "privacy": "private",
-              "default": "null"
+              "default": "'Actions'",
+              "description": "Accessible label for the toolbar.\nRequired when multiple toolbars appear on the same page.",
+              "attribute": "aria-label"
             },
             {
               "kind": "field",
-              "name": "_titleSlotChangeHandler",
+              "name": "_focusableCache",
               "type": {
-                "text": "(() => void) | null"
+                "text": "HTMLElement[] | null"
               },
               "privacy": "private",
-              "default": "null"
+              "default": "null",
+              "description": "Cached list of focusable items — invalidated on slot change."
             },
             {
               "kind": "field",
-              "name": "_isAssertive",
+              "name": "_hasOverflow",
               "type": {
                 "text": "boolean"
               },
               "privacy": "private",
-              "description": "Returns true when the variant requires assertive announcement.",
-              "readonly": true
+              "default": "false",
+              "description": "Whether the overflow slot has assigned content."
             },
             {
               "kind": "field",
-              "name": "_role",
-              "type": {
-                "text": "string"
-              },
+              "name": "_handleKeydown",
               "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"
-            },
-            {
-              "kind": "method",
-              "name": "_renderErrorIcon",
-              "privacy": "private"
+              "description": "Arrow function field — stable reference for add/removeEventListener."
             },
             {
               "kind": "method",
-              "name": "_renderDefaultIcon",
-              "privacy": "private"
+              "name": "_isFocusable",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "el",
+                  "type": {
+                    "text": "HTMLElement"
+                  }
+                }
+              ]
             },
             {
               "kind": "method",
-              "name": "_renderCloseIcon",
-              "privacy": "private"
+              "name": "_getFocusableItems",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "HTMLElement[]"
+                }
+              }
             },
             {
               "kind": "method",
-              "name": "_handleDismiss",
+              "name": "_initRovingTabindex",
               "privacy": "private",
               "return": {
                 "type": {
                   "text": "void"
                 }
               }
-            }
-          ],
-          "events": [
+            },
             {
-              "name": "hx-close",
-              "type": {
-                "text": "CustomEvent<{reason: string}>"
+              "kind": "method",
+              "name": "_moveFocus",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
               },
-              "description": "Dispatched when the user dismisses the alert."
+              "parameters": [
+                {
+                  "name": "direction",
+                  "type": {
+                    "text": "'next' | 'prev'"
+                  }
+                }
+              ]
             },
             {
-              "name": "hx-after-close",
-              "type": {
-                "text": "CustomEvent"
+              "kind": "method",
+              "name": "_handleSlotChange",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
               },
-              "description": "Dispatched after the alert is dismissed."
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ]
             }
           ],
           "attributes": [
             {
-              "name": "variant",
-              "type": {
-                "text": "AlertVariant"
-              },
-              "default": "'info'",
-              "description": "Visual variant of the alert that determines colors and ARIA semantics.",
-              "fieldName": "variant",
-              "attribute": "variant"
-            },
-            {
-              "name": "dismissible",
+              "name": "size",
               "type": {
-                "text": "boolean"
+                "text": "'sm' | 'md' | 'lg'"
               },
-              "default": "false",
-              "description": "Whether the alert can be dismissed by the user.",
-              "fieldName": "dismissible",
-              "attribute": "dismissible"
+              "default": "'md'",
+              "description": "Size of the action bar — propagated as a data attribute to slotted children.",
+              "fieldName": "size",
+              "attribute": "size"
             },
             {
-              "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.",
-              "fieldName": "open",
-              "attribute": "open"
+              "default": "'default'",
+              "description": "Visual variant controlling the bar background.",
+              "fieldName": "variant",
+              "attribute": "variant"
             },
             {
-              "name": "show-icon",
+              "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.",
-              "fieldName": "showIcon",
-              "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",
+              "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",
-          "declaration": {
-            "name": "HelixAlert",
-            "module": "./hx-alert.js"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "AlertVariant",
+          "name": "HelixActionBar",
           "declaration": {
-            "name": "AlertVariant",
-            "module": "./hx-alert.js"
+            "name": "HelixActionBar",
+            "module": "./hx-action-bar.js"
           }
         }
       ]
     },
     {
       "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 overflow slot wrapper (hidden when no overflow content).",
-              "name": "overflow"
+              "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": "dismissible",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether the alert can be dismissed by the user.",
+              "attribute": "dismissible",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "open",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "true",
+              "description": "Whether the alert is visible. Set to false to hide the alert.",
+              "attribute": "open",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "showIcon",
+              "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.",
+              "attribute": "show-icon",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "variant",
+              "name": "accent",
               "type": {
-                "text": "'default' | 'outlined' | 'filled'"
+                "text": "boolean"
               },
-              "default": "'default'",
-              "description": "Visual variant controlling the bar background.",
-              "attribute": "variant",
+              "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": "position",
+              "name": "returnFocusTo",
               "type": {
-                "text": "'top' | 'bottom' | 'sticky'"
+                "text": "string | null"
               },
-              "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
+              "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"
             },
             {
               "kind": "field",
-              "name": "sticky",
+              "name": "_hasActions",
               "type": {
                 "text": "boolean"
               },
-              "deprecated": "Use `position=\"sticky\"` instead.\nWhen true, the bar sticks to the top of its scroll container.",
-              "attribute": "sticky",
-              "reflects": true
+              "privacy": "private",
+              "default": "false"
             },
             {
               "kind": "field",
-              "name": "_sticky",
+              "name": "_hasTitle",
               "type": {
                 "text": "boolean"
               },
@@ -931,205 +920,216 @@
             },
             {
               "kind": "field",
-              "name": "ariaLabel",
+              "name": "_actionsSlotChangeHandler",
               "type": {
-                "text": "string"
+                "text": "(() => void) | null"
               },
-              "default": "'Actions'",
-              "description": "Accessible label for the toolbar.\nRequired when multiple toolbars appear on the same page.",
-              "attribute": "aria-label"
+              "privacy": "private",
+              "default": "null"
             },
             {
               "kind": "field",
-              "name": "_focusableCache",
+              "name": "_titleSlotChangeHandler",
               "type": {
-                "text": "HTMLElement[] | null"
+                "text": "(() => void) | null"
               },
               "privacy": "private",
-              "default": "null",
-              "description": "Cached list of focusable items — invalidated on slot change."
+              "default": "null"
             },
             {
               "kind": "field",
-              "name": "_hasOverflow",
+              "name": "_isAssertive",
               "type": {
                 "text": "boolean"
               },
               "privacy": "private",
-              "default": "false",
-              "description": "Whether the overflow slot has assigned content."
+              "description": "Returns true when the variant requires assertive announcement.",
+              "readonly": true
             },
             {
               "kind": "field",
-              "name": "_handleKeydown",
+              "name": "_role",
+              "type": {
+                "text": "string"
+              },
               "privacy": "private",
-              "description": "Arrow function field — stable reference for add/removeEventListener."
+              "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": "_isFocusable",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "boolean"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "el",
-                  "type": {
-                    "text": "HTMLElement"
-                  }
-                }
-              ]
+              "name": "_renderInfoIcon",
+              "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "_getFocusableItems",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "HTMLElement[]"
-                }
-              }
+              "name": "_renderSuccessIcon",
+              "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "_initRovingTabindex",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              }
+              "name": "_renderWarningIcon",
+              "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "_moveFocus",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "direction",
-                  "type": {
-                    "text": "'next' | 'prev'"
-                  }
-                }
-              ]
+              "name": "_renderErrorIcon",
+              "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "_handleSlotChange",
+              "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"
               },
-              "deprecated": "Use `position=\"sticky\"` instead.\nWhen true, the bar sticks to the top of its scroll container.",
-              "fieldName": "sticky",
-              "attribute": "sticky"
+              "default": "true",
+              "description": "Whether the alert is visible. Set to false to hide the alert.",
+              "fieldName": "open",
+              "attribute": "open"
             },
             {
-              "name": "aria-label",
+              "name": "show-icon",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "default": "'Actions'",
-              "description": "Accessible label for the toolbar.\nRequired when multiple toolbars appear on the same page.",
-              "fieldName": "ariaLabel",
-              "attribute": "aria-label"
+              "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",
+              "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": "return-focus-to",
+              "type": {
+                "text": "string | null"
+              },
+              "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"
           }
         }
       ]