@helixui/library 1.1.2-next.4 → 1.1.2-next.5

package/custom-elements.json

@@ -1131,104 +1131,98 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/hx-banner/hx-banner.ts",
+      "path": "src/components/hx-badge/hx-badge.ts",
       "declarations": [
         {
           "kind": "class",
-          "description": "A full-width page-level banner for persistent notifications and announcements.\nDesigned for healthcare applications requiring prominent system-level messaging.",
-          "name": "HelixBanner",
+          "description": "A small status indicator for notifications, counts, and labels.",
+          "name": "HelixBadge",
           "cssProperties": [
             {
-              "description": "Banner background color.",
-              "name": "--hx-banner-bg",
-              "default": "var(--hx-color-info-50)"
+              "description": "Badge background color. The primary override point.",
+              "name": "--hx-badge-bg",
+              "default": "var(--hx-color-primary-500)"
             },
             {
-              "description": "Banner text color.",
-              "name": "--hx-banner-color",
-              "default": "var(--hx-color-info-800)"
+              "description": "Badge text color. The primary override point.",
+              "name": "--hx-badge-color",
+              "default": "var(--hx-color-neutral-0)"
             },
             {
-              "description": "Banner bottom border color.",
-              "name": "--hx-banner-border-color",
-              "default": "var(--hx-color-info-200)"
+              "description": "Badge font size (set per size variant).",
+              "name": "--hx-badge-font-size"
             },
             {
-              "description": "Banner bottom border width.",
-              "name": "--hx-banner-border-width",
-              "default": "var(--hx-border-width-thin)"
+              "description": "Badge font weight.",
+              "name": "--hx-badge-font-weight",
+              "default": "var(--hx-font-weight-semibold)"
             },
             {
-              "description": "Banner padding.",
-              "name": "--hx-banner-padding",
-              "default": "var(--hx-space-3) var(--hx-space-4)"
+              "description": "Badge font family.",
+              "name": "--hx-badge-font-family",
+              "default": "var(--hx-font-family-sans)"
             },
             {
-              "description": "Gap between banner elements.",
-              "name": "--hx-banner-gap",
-              "default": "var(--hx-space-3)"
+              "description": "Badge border radius.",
+              "name": "--hx-badge-border-radius",
+              "default": "var(--hx-border-radius-md)"
             },
             {
-              "description": "Banner icon color.",
-              "name": "--hx-banner-icon-color",
-              "default": "var(--hx-color-info-500)"
+              "description": "Badge horizontal padding (set per size variant).",
+              "name": "--hx-badge-padding-x"
             },
             {
-              "description": "Banner font family.",
-              "name": "--hx-banner-font-family",
-              "default": "var(--hx-font-family-sans)"
+              "description": "Badge vertical padding (set per size variant).",
+              "name": "--hx-badge-padding-y"
             },
             {
-              "description": "Action link color.",
-              "name": "--hx-banner-action-color",
-              "default": "var(--hx-banner-color)"
+              "description": "Pulse color matching variant background with reduced opacity.",
+              "name": "--hx-badge-pulse-color"
             },
             {
-              "description": "CSS position value (sticky or fixed).",
-              "name": "--hx-banner-position",
-              "default": "sticky"
+              "description": "Dot indicator size when rendered without content.",
+              "name": "--hx-badge-dot-size",
+              "default": "var(--hx-size-2)"
             },
             {
-              "description": "Banner z-index for stacking context.",
-              "name": "--hx-banner-z-index",
-              "default": "100"
+              "description": "Background for the secondary variant.",
+              "name": "--hx-badge-secondary-bg",
+              "default": "var(--hx-color-neutral-100)"
             },
             {
-              "description": "Minimum touch target size for the close button.",
-              "name": "--hx-touch-target-size",
-              "default": "44px"
-            }
-          ],
-          "cssParts": [
-            {
-              "description": "The outer banner container.",
-              "name": "banner"
+              "description": "Text color for the secondary variant.",
+              "name": "--hx-badge-secondary-color",
+              "default": "var(--hx-color-neutral-700)"
             },
             {
-              "description": "The icon container.",
-              "name": "icon"
+              "description": "Background for the info variant.",
+              "name": "--hx-badge-info-bg",
+              "default": "var(--hx-color-info-700)"
             },
             {
-              "description": "The message content area.",
-              "name": "message"
-            },
+              "description": "Text color for the info variant.",
+              "name": "--hx-badge-info-color",
+              "default": "var(--hx-color-neutral-0)"
+            }
+          ],
+          "cssParts": [
             {
-              "description": "The action link element (only rendered when action-label and action-href are set).",
-              "name": "action"
+              "description": "The badge element.",
+              "name": "badge"
             },
             {
-              "description": "The dismiss button (only rendered when dismissible).",
-              "name": "close-button"
+              "description": "The remove/dismiss button.",
+              "name": "remove-button"
             }
           ],
           "slots": [
             {
-              "description": "Default slot for banner message content.",
+              "description": "Default slot for badge content (text, number). When empty with pulse enabled, renders as a dot indicator.",
               "name": ""
             },
             {
-              "description": "Optional slot to override the built-in action link with custom content.",
-              "name": "action"
+              "description": "Icon or content rendered before the badge text.",
+              "name": "prefix"
             }
           ],
           "members": [
@@ -1236,387 +1230,360 @@
               "kind": "field",
               "name": "variant",
               "type": {
-                "text": "'info' | 'success' | 'warning' | 'error'"
+                "text": "'primary' | 'secondary' | 'success' | 'warning' | 'error' | 'neutral' | 'info'"
               },
-              "default": "'info'",
-              "description": "Visual variant of the banner that determines colors and ARIA semantics.",
+              "default": "'primary'",
+              "description": "Visual style variant of the badge.",
               "attribute": "variant",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "position",
+              "name": "size",
               "type": {
-                "text": "'sticky' | 'fixed'"
+                "text": "'sm' | 'md' | 'lg'"
               },
-              "default": "'sticky'",
-              "description": "CSS positioning behavior. \"sticky\" keeps the banner in flow; \"fixed\" pins it to the viewport.",
-              "attribute": "position",
+              "default": "'md'",
+              "description": "Size of the badge.",
+              "attribute": "hx-size",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "dismissible",
+              "name": "pill",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether the banner can be dismissed by the user.",
-              "attribute": "dismissible",
+              "description": "Whether the badge uses fully rounded (pill) styling.",
+              "attribute": "pill",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "heading",
+              "name": "pulse",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "default": "''",
-              "description": "Heading text for the banner, used to provide context in the action link's and\nclose button's accessible labels.",
-              "attribute": "heading"
+              "default": "false",
+              "description": "Whether the badge displays an animated pulse for attention.",
+              "attribute": "pulse",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "actionLabel",
+              "name": "removable",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "default": "''",
-              "description": "Label text for the optional action link. Requires action-href to render.",
-              "attribute": "action-label"
+              "default": "false",
+              "description": "Whether the badge renders a dismiss button.",
+              "attribute": "removable",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "actionHref",
+              "name": "count",
               "type": {
-                "text": "string"
+                "text": "number | undefined"
               },
-              "default": "''",
-              "description": "URL for the optional action link. Requires action-label to render.",
-              "attribute": "action-href"
+              "default": "undefined",
+              "description": "Numeric count to display. When set, renders the count as badge content.\nWhen count exceeds `max`, displays `${max}+` (e.g. `99+`).",
+              "attribute": "count",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "open",
+              "name": "max",
               "type": {
-                "text": "boolean"
+                "text": "number"
               },
-              "default": "true",
-              "description": "Whether the banner is visible. Defaults to true — banners are shown by default.",
-              "attribute": "open",
+              "default": "99",
+              "description": "Maximum count value before truncation to `${max}+`. Defaults to 99.",
+              "attribute": "max",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "labelClose",
+              "name": "dotLabel",
               "type": {
                 "text": "string"
               },
-              "default": "'Dismiss banner'",
-              "description": "Accessible label for the dismiss button. Override for localized text.",
-              "attribute": "label-close"
-            },
-            {
-              "kind": "field",
-              "name": "severityLabel",
-              "type": {
-                "text": "string | undefined"
-              },
-              "description": "Override for the severity prefix announced to screen readers (e.g., \"Info:\", \"Error:\").\nWhen not set, defaults to the English label matching the current variant.",
-              "attribute": "severity-label"
-            },
-            {
-              "kind": "method",
-              "name": "_defaultSeverityLabel",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "string"
-                }
-              },
-              "description": "Returns the default English severity label for the current variant."
+              "default": "''",
+              "description": "Accessible label for the dot indicator mode (pulse + empty slot).\nRequired for WCAG 4.1.2 compliance when using the dot indicator pattern.\nExample: `dot-label=\"3 new messages\"`.",
+              "attribute": "dot-label"
             },
             {
               "kind": "field",
-              "name": "_effectiveSeverityLabel",
+              "name": "removeLabel",
               "type": {
                 "text": "string"
               },
-              "privacy": "private",
-              "description": "Returns the effective severity label, using the override if provided.",
-              "readonly": true
-            },
-            {
-              "kind": "method",
-              "name": "dismiss",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "description": "Programmatically dismisses the banner. Sets open=false and dispatches hx-dismiss."
+              "default": "'Remove'",
+              "description": "Accessible label for the remove button. Should describe what is being removed.\nDefaults to \"Remove\". For better accessibility, include context: e.g. \"Remove Critical badge\".",
+              "attribute": "remove-label"
             }
           ],
           "events": [
             {
-              "name": "hx-dismiss",
+              "name": "hx-remove",
               "type": {
-                "text": "CustomEvent<{reason: string}>"
+                "text": "CustomEvent<void>"
               },
-              "description": "Dispatched when the user dismisses the banner."
+              "description": "Dispatched when the user clicks the remove button."
             }
           ],
           "attributes": [
             {
               "name": "variant",
               "type": {
-                "text": "'info' | 'success' | 'warning' | 'error'"
+                "text": "'primary' | 'secondary' | 'success' | 'warning' | 'error' | 'neutral' | 'info'"
               },
-              "default": "'info'",
-              "description": "Visual variant of the banner that determines colors and ARIA semantics.",
+              "default": "'primary'",
+              "description": "Visual style variant of the badge.",
               "fieldName": "variant",
               "attribute": "variant"
             },
             {
-              "name": "position",
+              "name": "hx-size",
               "type": {
-                "text": "'sticky' | 'fixed'"
+                "text": "'sm' | 'md' | 'lg'"
               },
-              "default": "'sticky'",
-              "description": "CSS positioning behavior. \"sticky\" keeps the banner in flow; \"fixed\" pins it to the viewport.",
-              "fieldName": "position",
-              "attribute": "position"
+              "default": "'md'",
+              "description": "Size of the badge.",
+              "fieldName": "size",
+              "attribute": "hx-size"
             },
             {
-              "name": "dismissible",
+              "name": "pill",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether the banner can be dismissed by the user.",
-              "fieldName": "dismissible",
-              "attribute": "dismissible"
+              "description": "Whether the badge uses fully rounded (pill) styling.",
+              "fieldName": "pill",
+              "attribute": "pill"
             },
             {
-              "name": "heading",
+              "name": "pulse",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "default": "''",
-              "description": "Heading text for the banner, used to provide context in the action link's and\nclose button's accessible labels.",
-              "fieldName": "heading",
-              "attribute": "heading"
+              "default": "false",
+              "description": "Whether the badge displays an animated pulse for attention.",
+              "fieldName": "pulse",
+              "attribute": "pulse"
             },
             {
-              "name": "action-label",
+              "name": "removable",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "default": "''",
-              "description": "Label text for the optional action link. Requires action-href to render.",
-              "fieldName": "actionLabel",
-              "attribute": "action-label"
+              "default": "false",
+              "description": "Whether the badge renders a dismiss button.",
+              "fieldName": "removable",
+              "attribute": "removable"
             },
             {
-              "name": "action-href",
+              "name": "count",
               "type": {
-                "text": "string"
+                "text": "number | undefined"
               },
-              "default": "''",
-              "description": "URL for the optional action link. Requires action-label to render.",
-              "fieldName": "actionHref",
-              "attribute": "action-href"
+              "default": "undefined",
+              "description": "Numeric count to display. When set, renders the count as badge content.\nWhen count exceeds `max`, displays `${max}+` (e.g. `99+`).",
+              "fieldName": "count",
+              "attribute": "count"
             },
             {
-              "name": "open",
+              "name": "max",
               "type": {
-                "text": "boolean"
+                "text": "number"
               },
-              "default": "true",
-              "description": "Whether the banner is visible. Defaults to true — banners are shown by default.",
-              "fieldName": "open",
-              "attribute": "open"
+              "default": "99",
+              "description": "Maximum count value before truncation to `${max}+`. Defaults to 99.",
+              "fieldName": "max",
+              "attribute": "max"
             },
             {
-              "name": "severity-label",
+              "name": "dot-label",
               "type": {
-                "text": "string | undefined"
+                "text": "string"
               },
-              "description": "Override for the severity prefix announced to screen readers (e.g., \"Info:\", \"Error:\").\nWhen not set, defaults to the English label matching the current variant.",
-              "fieldName": "severityLabel",
-              "attribute": "severity-label"
+              "default": "''",
+              "description": "Accessible label for the dot indicator mode (pulse + empty slot).\nRequired for WCAG 4.1.2 compliance when using the dot indicator pattern.\nExample: `dot-label=\"3 new messages\"`.",
+              "fieldName": "dotLabel",
+              "attribute": "dot-label"
             },
             {
-              "name": "label-close",
+              "name": "remove-label",
               "type": {
                 "text": "string"
               },
-              "default": "'Dismiss banner'",
-              "description": "Accessible label for the dismiss button. Override for localized text.",
-              "fieldName": "labelClose"
+              "default": "'Remove'",
+              "description": "Accessible label for the remove button. Should describe what is being removed.\nDefaults to \"Remove\". For better accessibility, include context: e.g. \"Remove Critical badge\".",
+              "fieldName": "removeLabel",
+              "attribute": "remove-label"
             }
           ],
           "superclass": {
             "name": "LitElement",
             "package": "lit"
           },
-          "tagName": "hx-banner",
+          "tagName": "hx-badge",
           "customElement": true,
-          "summary": "Full-width page-level banner for persistent notifications with variant-based styling and ARIA live regions."
+          "summary": "Presentational badge for status indicators, notification counts, and labels."
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "HelixBanner",
+          "name": "HelixBadge",
           "declaration": {
-            "name": "HelixBanner",
-            "module": "src/components/hx-banner/hx-banner.ts"
+            "name": "HelixBadge",
+            "module": "src/components/hx-badge/hx-badge.ts"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "hx-banner",
-          "declaration": {
-            "name": "HelixBanner",
-            "module": "src/components/hx-banner/hx-banner.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "HxBanner",
+          "name": "hx-badge",
           "declaration": {
-            "name": "HelixBanner",
-            "module": "src/components/hx-banner/hx-banner.ts"
+            "name": "HelixBadge",
+            "module": "src/components/hx-badge/hx-badge.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/hx-banner/index.ts",
+      "path": "src/components/hx-badge/index.ts",
       "declarations": [],
       "exports": [
         {
           "kind": "js",
-          "name": "HelixBanner",
+          "name": "HelixBadge",
           "declaration": {
-            "name": "HelixBanner",
-            "module": "./hx-banner.js"
+            "name": "HelixBadge",
+            "module": "./hx-badge.js"
           }
         },
         {
           "kind": "js",
-          "name": "BannerVariant",
+          "name": "HxBadge",
           "declaration": {
-            "name": "BannerVariant",
-            "module": "./hx-banner.js"
+            "name": "HxBadge",
+            "module": "./hx-badge.js"
           }
         },
         {
           "kind": "js",
-          "name": "BannerPosition",
+          "name": "WcBadge",
           "declaration": {
-            "name": "BannerPosition",
-            "module": "./hx-banner.js"
+            "name": "WcBadge",
+            "module": "./hx-badge.js"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/hx-badge/hx-badge.ts",
+      "path": "src/components/hx-banner/hx-banner.ts",
       "declarations": [
         {
           "kind": "class",
-          "description": "A small status indicator for notifications, counts, and labels.",
-          "name": "HelixBadge",
+          "description": "A full-width page-level banner for persistent notifications and announcements.\nDesigned for healthcare applications requiring prominent system-level messaging.",
+          "name": "HelixBanner",
           "cssProperties": [
             {
-              "description": "Badge background color. The primary override point.",
-              "name": "--hx-badge-bg",
-              "default": "var(--hx-color-primary-500)"
+              "description": "Banner background color.",
+              "name": "--hx-banner-bg",
+              "default": "var(--hx-color-info-50)"
             },
             {
-              "description": "Badge text color. The primary override point.",
-              "name": "--hx-badge-color",
-              "default": "var(--hx-color-neutral-0)"
+              "description": "Banner text color.",
+              "name": "--hx-banner-color",
+              "default": "var(--hx-color-info-800)"
             },
             {
-              "description": "Badge font size (set per size variant).",
-              "name": "--hx-badge-font-size"
+              "description": "Banner bottom border color.",
+              "name": "--hx-banner-border-color",
+              "default": "var(--hx-color-info-200)"
             },
             {
-              "description": "Badge font weight.",
-              "name": "--hx-badge-font-weight",
-              "default": "var(--hx-font-weight-semibold)"
+              "description": "Banner bottom border width.",
+              "name": "--hx-banner-border-width",
+              "default": "var(--hx-border-width-thin)"
             },
             {
-              "description": "Badge font family.",
-              "name": "--hx-badge-font-family",
-              "default": "var(--hx-font-family-sans)"
+              "description": "Banner padding.",
+              "name": "--hx-banner-padding",
+              "default": "var(--hx-space-3) var(--hx-space-4)"
             },
             {
-              "description": "Badge border radius.",
-              "name": "--hx-badge-border-radius",
-              "default": "var(--hx-border-radius-md)"
+              "description": "Gap between banner elements.",
+              "name": "--hx-banner-gap",
+              "default": "var(--hx-space-3)"
             },
             {
-              "description": "Badge horizontal padding (set per size variant).",
-              "name": "--hx-badge-padding-x"
+              "description": "Banner icon color.",
+              "name": "--hx-banner-icon-color",
+              "default": "var(--hx-color-info-500)"
             },
             {
-              "description": "Badge vertical padding (set per size variant).",
-              "name": "--hx-badge-padding-y"
+              "description": "Banner font family.",
+              "name": "--hx-banner-font-family",
+              "default": "var(--hx-font-family-sans)"
             },
             {
-              "description": "Pulse color matching variant background with reduced opacity.",
-              "name": "--hx-badge-pulse-color"
+              "description": "Action link color.",
+              "name": "--hx-banner-action-color",
+              "default": "var(--hx-banner-color)"
             },
             {
-              "description": "Dot indicator size when rendered without content.",
-              "name": "--hx-badge-dot-size",
-              "default": "var(--hx-size-2)"
+              "description": "CSS position value (sticky or fixed).",
+              "name": "--hx-banner-position",
+              "default": "sticky"
             },
             {
-              "description": "Background for the secondary variant.",
-              "name": "--hx-badge-secondary-bg",
-              "default": "var(--hx-color-neutral-100)"
+              "description": "Banner z-index for stacking context.",
+              "name": "--hx-banner-z-index",
+              "default": "100"
             },
             {
-              "description": "Text color for the secondary variant.",
-              "name": "--hx-badge-secondary-color",
-              "default": "var(--hx-color-neutral-700)"
+              "description": "Minimum touch target size for the close button.",
+              "name": "--hx-touch-target-size",
+              "default": "44px"
+            }
+          ],
+          "cssParts": [
+            {
+              "description": "The outer banner container.",
+              "name": "banner"
             },
             {
-              "description": "Background for the info variant.",
-              "name": "--hx-badge-info-bg",
-              "default": "var(--hx-color-info-700)"
+              "description": "The icon container.",
+              "name": "icon"
             },
             {
-              "description": "Text color for the info variant.",
-              "name": "--hx-badge-info-color",
-              "default": "var(--hx-color-neutral-0)"
-            }
-          ],
-          "cssParts": [
+              "description": "The message content area.",
+              "name": "message"
+            },
             {
-              "description": "The badge element.",
-              "name": "badge"
+              "description": "The action link element (only rendered when action-label and action-href are set).",
+              "name": "action"
             },
             {
-              "description": "The remove/dismiss button.",
-              "name": "remove-button"
+              "description": "The dismiss button (only rendered when dismissible).",
+              "name": "close-button"
             }
           ],
           "slots": [
             {
-              "description": "Default slot for badge content (text, number). When empty with pulse enabled, renders as a dot indicator.",
+              "description": "Default slot for banner message content.",
               "name": ""
             },
             {
-              "description": "Icon or content rendered before the badge text.",
-              "name": "prefix"
+              "description": "Optional slot to override the built-in action link with custom content.",
+              "name": "action"
             }
           ],
           "members": [
@@ -1624,256 +1591,289 @@
               "kind": "field",
               "name": "variant",
               "type": {
-                "text": "'primary' | 'secondary' | 'success' | 'warning' | 'error' | 'neutral' | 'info'"
+                "text": "'info' | 'success' | 'warning' | 'error'"
               },
-              "default": "'primary'",
-              "description": "Visual style variant of the badge.",
+              "default": "'info'",
+              "description": "Visual variant of the banner that determines colors and ARIA semantics.",
               "attribute": "variant",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "size",
+              "name": "position",
               "type": {
-                "text": "'sm' | 'md' | 'lg'"
+                "text": "'sticky' | 'fixed'"
               },
-              "default": "'md'",
-              "description": "Size of the badge.",
-              "attribute": "hx-size",
+              "default": "'sticky'",
+              "description": "CSS positioning behavior. \"sticky\" keeps the banner in flow; \"fixed\" pins it to the viewport.",
+              "attribute": "position",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "pill",
+              "name": "dismissible",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether the badge uses fully rounded (pill) styling.",
-              "attribute": "pill",
+              "description": "Whether the banner can be dismissed by the user.",
+              "attribute": "dismissible",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "pulse",
+              "name": "heading",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "description": "Whether the badge displays an animated pulse for attention.",
-              "attribute": "pulse",
-              "reflects": true
+              "default": "''",
+              "description": "Heading text for the banner, used to provide context in the action link's and\nclose button's accessible labels.",
+              "attribute": "heading"
             },
             {
               "kind": "field",
-              "name": "removable",
+              "name": "actionLabel",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "description": "Whether the badge renders a dismiss button.",
-              "attribute": "removable",
-              "reflects": true
+              "default": "''",
+              "description": "Label text for the optional action link. Requires action-href to render.",
+              "attribute": "action-label"
             },
             {
               "kind": "field",
-              "name": "count",
+              "name": "actionHref",
               "type": {
-                "text": "number | undefined"
+                "text": "string"
               },
-              "default": "undefined",
-              "description": "Numeric count to display. When set, renders the count as badge content.\nWhen count exceeds `max`, displays `${max}+` (e.g. `99+`).",
-              "attribute": "count",
-              "reflects": true
+              "default": "''",
+              "description": "URL for the optional action link. Requires action-label to render.",
+              "attribute": "action-href"
             },
             {
               "kind": "field",
-              "name": "max",
+              "name": "open",
               "type": {
-                "text": "number"
+                "text": "boolean"
               },
-              "default": "99",
-              "description": "Maximum count value before truncation to `${max}+`. Defaults to 99.",
-              "attribute": "max",
+              "default": "true",
+              "description": "Whether the banner is visible. Defaults to true — banners are shown by default.",
+              "attribute": "open",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "dotLabel",
+              "name": "labelClose",
               "type": {
                 "text": "string"
               },
-              "default": "''",
-              "description": "Accessible label for the dot indicator mode (pulse + empty slot).\nRequired for WCAG 4.1.2 compliance when using the dot indicator pattern.\nExample: `dot-label=\"3 new messages\"`.",
-              "attribute": "dot-label"
+              "default": "'Dismiss banner'",
+              "description": "Accessible label for the dismiss button. Override for localized text.",
+              "attribute": "label-close"
             },
             {
               "kind": "field",
-              "name": "removeLabel",
+              "name": "severityLabel",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Override for the severity prefix announced to screen readers (e.g., \"Info:\", \"Error:\").\nWhen not set, defaults to the English label matching the current variant.",
+              "attribute": "severity-label"
+            },
+            {
+              "kind": "method",
+              "name": "_defaultSeverityLabel",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              },
+              "description": "Returns the default English severity label for the current variant."
+            },
+            {
+              "kind": "field",
+              "name": "_effectiveSeverityLabel",
               "type": {
                 "text": "string"
               },
-              "default": "'Remove'",
-              "description": "Accessible label for the remove button. Should describe what is being removed.\nDefaults to \"Remove\". For better accessibility, include context: e.g. \"Remove Critical badge\".",
-              "attribute": "remove-label"
+              "privacy": "private",
+              "description": "Returns the effective severity label, using the override if provided.",
+              "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "dismiss",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Programmatically dismisses the banner. Sets open=false and dispatches hx-dismiss."
             }
           ],
           "events": [
             {
-              "name": "hx-remove",
+              "name": "hx-dismiss",
               "type": {
-                "text": "CustomEvent<void>"
+                "text": "CustomEvent<{reason: string}>"
               },
-              "description": "Dispatched when the user clicks the remove button."
+              "description": "Dispatched when the user dismisses the banner."
             }
           ],
           "attributes": [
             {
               "name": "variant",
               "type": {
-                "text": "'primary' | 'secondary' | 'success' | 'warning' | 'error' | 'neutral' | 'info'"
+                "text": "'info' | 'success' | 'warning' | 'error'"
               },
-              "default": "'primary'",
-              "description": "Visual style variant of the badge.",
+              "default": "'info'",
+              "description": "Visual variant of the banner that determines colors and ARIA semantics.",
               "fieldName": "variant",
               "attribute": "variant"
             },
             {
-              "name": "hx-size",
+              "name": "position",
               "type": {
-                "text": "'sm' | 'md' | 'lg'"
+                "text": "'sticky' | 'fixed'"
               },
-              "default": "'md'",
-              "description": "Size of the badge.",
-              "fieldName": "size",
-              "attribute": "hx-size"
+              "default": "'sticky'",
+              "description": "CSS positioning behavior. \"sticky\" keeps the banner in flow; \"fixed\" pins it to the viewport.",
+              "fieldName": "position",
+              "attribute": "position"
             },
             {
-              "name": "pill",
+              "name": "dismissible",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether the badge uses fully rounded (pill) styling.",
-              "fieldName": "pill",
-              "attribute": "pill"
+              "description": "Whether the banner can be dismissed by the user.",
+              "fieldName": "dismissible",
+              "attribute": "dismissible"
             },
             {
-              "name": "pulse",
+              "name": "heading",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "description": "Whether the badge displays an animated pulse for attention.",
-              "fieldName": "pulse",
-              "attribute": "pulse"
+              "default": "''",
+              "description": "Heading text for the banner, used to provide context in the action link's and\nclose button's accessible labels.",
+              "fieldName": "heading",
+              "attribute": "heading"
             },
             {
-              "name": "removable",
+              "name": "action-label",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "description": "Whether the badge renders a dismiss button.",
-              "fieldName": "removable",
-              "attribute": "removable"
+              "default": "''",
+              "description": "Label text for the optional action link. Requires action-href to render.",
+              "fieldName": "actionLabel",
+              "attribute": "action-label"
             },
             {
-              "name": "count",
+              "name": "action-href",
               "type": {
-                "text": "number | undefined"
-              },
-              "default": "undefined",
-              "description": "Numeric count to display. When set, renders the count as badge content.\nWhen count exceeds `max`, displays `${max}+` (e.g. `99+`).",
-              "fieldName": "count",
-              "attribute": "count"
+                "text": "string"
+              },
+              "default": "''",
+              "description": "URL for the optional action link. Requires action-label to render.",
+              "fieldName": "actionHref",
+              "attribute": "action-href"
             },
             {
-              "name": "max",
+              "name": "open",
               "type": {
-                "text": "number"
+                "text": "boolean"
               },
-              "default": "99",
-              "description": "Maximum count value before truncation to `${max}+`. Defaults to 99.",
-              "fieldName": "max",
-              "attribute": "max"
+              "default": "true",
+              "description": "Whether the banner is visible. Defaults to true — banners are shown by default.",
+              "fieldName": "open",
+              "attribute": "open"
             },
             {
-              "name": "dot-label",
+              "name": "severity-label",
               "type": {
-                "text": "string"
+                "text": "string | undefined"
               },
-              "default": "''",
-              "description": "Accessible label for the dot indicator mode (pulse + empty slot).\nRequired for WCAG 4.1.2 compliance when using the dot indicator pattern.\nExample: `dot-label=\"3 new messages\"`.",
-              "fieldName": "dotLabel",
-              "attribute": "dot-label"
+              "description": "Override for the severity prefix announced to screen readers (e.g., \"Info:\", \"Error:\").\nWhen not set, defaults to the English label matching the current variant.",
+              "fieldName": "severityLabel",
+              "attribute": "severity-label"
             },
             {
-              "name": "remove-label",
+              "name": "label-close",
               "type": {
                 "text": "string"
               },
-              "default": "'Remove'",
-              "description": "Accessible label for the remove button. Should describe what is being removed.\nDefaults to \"Remove\". For better accessibility, include context: e.g. \"Remove Critical badge\".",
-              "fieldName": "removeLabel",
-              "attribute": "remove-label"
+              "default": "'Dismiss banner'",
+              "description": "Accessible label for the dismiss button. Override for localized text.",
+              "fieldName": "labelClose"
             }
           ],
           "superclass": {
             "name": "LitElement",
             "package": "lit"
           },
-          "tagName": "hx-badge",
+          "tagName": "hx-banner",
           "customElement": true,
-          "summary": "Presentational badge for status indicators, notification counts, and labels."
+          "summary": "Full-width page-level banner for persistent notifications with variant-based styling and ARIA live regions."
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "HelixBadge",
+          "name": "HelixBanner",
           "declaration": {
-            "name": "HelixBadge",
-            "module": "src/components/hx-badge/hx-badge.ts"
+            "name": "HelixBanner",
+            "module": "src/components/hx-banner/hx-banner.ts"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "hx-badge",
+          "name": "hx-banner",
           "declaration": {
-            "name": "HelixBadge",
-            "module": "src/components/hx-badge/hx-badge.ts"
+            "name": "HelixBanner",
+            "module": "src/components/hx-banner/hx-banner.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "HxBanner",
+          "declaration": {
+            "name": "HelixBanner",
+            "module": "src/components/hx-banner/hx-banner.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/hx-badge/index.ts",
+      "path": "src/components/hx-banner/index.ts",
       "declarations": [],
       "exports": [
         {
           "kind": "js",
-          "name": "HelixBadge",
+          "name": "HelixBanner",
           "declaration": {
-            "name": "HelixBadge",
-            "module": "./hx-badge.js"
+            "name": "HelixBanner",
+            "module": "./hx-banner.js"
           }
         },
         {
           "kind": "js",
-          "name": "HxBadge",
+          "name": "BannerVariant",
           "declaration": {
-            "name": "HxBadge",
-            "module": "./hx-badge.js"
+            "name": "BannerVariant",
+            "module": "./hx-banner.js"
           }
         },
         {
           "kind": "js",
-          "name": "WcBadge",
+          "name": "BannerPosition",
           "declaration": {
-            "name": "WcBadge",
-            "module": "./hx-badge.js"
+            "name": "BannerPosition",
+            "module": "./hx-banner.js"
           }
         }
       ]
@@ -15223,6 +15223,11 @@
               "description": "Photo area size.",
               "name": "--hx-patient-banner-photo-size",
               "default": "var(--hx-space-10,2.5rem)"
+            },
+            {
+              "description": "Photo area background color when empty.",
+              "name": "--hx-patient-banner-photo-bg",
+              "default": "var(--hx-color-neutral-200,#e5e7eb)"
             }
           ],
           "cssParts": [
@@ -15249,6 +15254,10 @@
             {
               "description": "The field value slot wrapper.",
               "name": "field-value"
+            },
+            {
+              "description": "The visually-hidden identifier rule violation status message.",
+              "name": "violation-message"
             }
           ],
           "slots": [
@@ -15359,39 +15368,6 @@
               "attribute": "enforce-identifier-rule",
               "reflects": true
             },
-            {
-              "kind": "field",
-              "name": "_identifierCount",
-              "type": {
-                "text": "number"
-              },
-              "privacy": "private",
-              "default": "0"
-            },
-            {
-              "kind": "field",
-              "name": "_nameSlot",
-              "type": {
-                "text": "HTMLSlotElement"
-              },
-              "privacy": "private"
-            },
-            {
-              "kind": "field",
-              "name": "_mrnSlot",
-              "type": {
-                "text": "HTMLSlotElement"
-              },
-              "privacy": "private"
-            },
-            {
-              "kind": "field",
-              "name": "_dobSlot",
-              "type": {
-                "text": "HTMLSlotElement"
-              },
-              "privacy": "private"
-            },
             {
               "kind": "method",
               "name": "_countPopulatedIdentifiers",
@@ -15598,6 +15574,11 @@
               "description": "Focus ring color.",
               "name": "--hx-phi-field-focus-ring-color",
               "default": "var(--hx-focus-ring-color,var(--hx-color-primary-500,#2563eb))"
+            },
+            {
+              "description": "Opacity applied when the field is disabled.",
+              "name": "--hx-phi-field-disabled-opacity",
+              "default": "var(--hx-opacity-50,0.5)"
             }
           ],
           "cssParts": [
@@ -15658,127 +15639,24 @@
             },
             {
               "kind": "field",
-              "name": "_masked",
+              "name": "label",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "privacy": "private",
-              "default": "true"
+              "default": "''",
+              "description": "Accessible label describing the PHI field. Used as a prefix in screen reader\nannouncements (e.g., \"Social Security Number is masked\").",
+              "attribute": "label"
             },
             {
               "kind": "field",
-              "name": "_clipboardTimer",
+              "name": "disabled",
               "type": {
-                "text": "ReturnType<typeof setTimeout> | null"
-              },
-              "privacy": "private",
-              "default": "null"
-            },
-            {
-              "kind": "method",
-              "name": "_cancelClipboardTimer",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              }
-            },
-            {
-              "kind": "method",
-              "name": "_scheduleClipboardClear",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              }
-            },
-            {
-              "kind": "method",
-              "name": "_clearClipboard",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              }
-            },
-            {
-              "kind": "method",
-              "name": "_getMaskedValue",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "string"
-                }
-              }
-            },
-            {
-              "kind": "method",
-              "name": "_handleToggle",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              }
-            },
-            {
-              "kind": "method",
-              "name": "_handleCopy",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "e",
-                  "type": {
-                    "text": "ClipboardEvent"
-                  }
-                }
-              ]
-            },
-            {
-              "kind": "method",
-              "name": "_handlePaste",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
+                "text": "boolean"
               },
-              "parameters": [
-                {
-                  "name": "e",
-                  "type": {
-                    "text": "ClipboardEvent"
-                  }
-                }
-              ]
-            },
-            {
-              "kind": "method",
-              "name": "_renderEyeIcon",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "TemplateResult"
-                }
-              }
-            },
-            {
-              "kind": "method",
-              "name": "_renderEyeOffIcon",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "TemplateResult"
-                }
-              }
+              "default": "false",
+              "description": "When set, disables all interaction with the field and prevents reveal.",
+              "reflects": true,
+              "attribute": "disabled"
             }
           ],
           "events": [
@@ -15787,7 +15665,7 @@
               "type": {
                 "text": "CustomEvent<PhiAccessEventDetail>"
               },
-              "description": "Fired on reveal, hide, and clipboard auto-clear."
+              "description": "Fired on reveal, hide, and clipboard-clear actions."
             }
           ],
           "attributes": [
@@ -15830,6 +15708,26 @@
               "description": "Milliseconds after clipboard write before the clipboard is automatically cleared.\nDefaults to 30000 (30 seconds).",
               "fieldName": "clipboardTimeout",
               "attribute": "clipboard-timeout"
+            },
+            {
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Accessible label describing the PHI field. Used as a prefix in screen reader\nannouncements (e.g., \"Social Security Number is masked\").",
+              "fieldName": "label",
+              "attribute": "label"
+            },
+            {
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "When set, disables all interaction with the field and prevents reveal.",
+              "fieldName": "disabled",
+              "attribute": "disabled"
             }
           ],
           "superclass": {
@@ -18185,6 +18083,11 @@
               "name": "--hx-select-chevron-color",
               "default": "var(--hx-color-neutral-500)"
             },
+            {
+              "description": "Chevron indicator size (width/height base unit).",
+              "name": "--hx-select-chevron-size",
+              "default": "0.5rem"
+            },
             {
               "description": "Listbox panel background color.",
               "name": "--hx-select-listbox-bg",
@@ -21178,7 +21081,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "A colored dot/badge indicating system or entity health status.\nPurely visual — no slots. Supports an animated pulse ring.\n\nUses `role=\"img\"` with an auto-generated `aria-label` (e.g. \"Status: Online\").\nWhen used decoratively alongside visible text that conveys the same status information\n(e.g. \"Provider is available\"), set `aria-hidden=\"true\"` on the host element to prevent\nduplicate announcements to screen reader users. This is the recommended composition\npattern in healthcare dashboards.",
+          "description": "A colored dot/badge indicating system or entity health status.\nSupports an animated pulse ring and an optional visible text label.\n\nStatus is conveyed through color AND an `aria-label` on the host element.\nWhen `show-label` is set, a visible text label is rendered inside the component,\nensuring status is not communicated by color alone (WCAG 1.4.1 — Use of Color).\n\nUses `role=\"img\"` with an auto-generated `aria-label` (e.g. \"Status: Online\").\nWhen used decoratively alongside visible text that conveys the same status information\n(e.g. \"Provider is available\"), set `aria-hidden=\"true\"` on the host element to prevent\nduplicate announcements to screen reader users. This is the recommended composition\npattern in healthcare dashboards.",
           "name": "HelixStatusIndicator",
           "cssProperties": [
             {
@@ -21224,6 +21127,14 @@
             {
               "description": "Override pulse ring color independently from dot color.",
               "name": "--hx-status-indicator-pulse-color"
+            },
+            {
+              "description": "Override label text color.",
+              "name": "--hx-status-indicator-label-color"
+            },
+            {
+              "description": "Override label font size.",
+              "name": "--hx-status-indicator-label-font-size"
             }
           ],
           "cssParts": [
@@ -21234,6 +21145,10 @@
             {
               "description": "The animated pulse ring element.",
               "name": "pulse-ring"
+            },
+            {
+              "description": "The visible status label text element (visible when show-label is set).",
+              "name": "label"
             }
           ],
           "members": [
@@ -21279,6 +21194,17 @@
               "default": "''",
               "description": "Accessible label for the indicator. Defaults to \"Status: {Status}\".\nSet aria-hidden=\"true\" on the host when status is conveyed by adjacent text.",
               "attribute": "label"
+            },
+            {
+              "kind": "field",
+              "name": "showLabel",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "When true, renders a visible text label next to the dot conveying the status.\nUse this to satisfy WCAG 1.4.1 (Use of Color) when the indicator is not\naccompanied by other visible text that conveys the same status information.",
+              "attribute": "show-label",
+              "reflects": true
             }
           ],
           "attributes": [
@@ -21321,6 +21247,16 @@
               "description": "Accessible label for the indicator. Defaults to \"Status: {Status}\".\nSet aria-hidden=\"true\" on the host when status is conveyed by adjacent text.",
               "fieldName": "label",
               "attribute": "label"
+            },
+            {
+              "name": "show-label",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "When true, renders a visible text label next to the dot conveying the status.\nUse this to satisfy WCAG 1.4.1 (Use of Color) when the indicator is not\naccompanied by other visible text that conveys the same status information.",
+              "fieldName": "showLabel",
+              "attribute": "show-label"
             }
           ],
           "superclass": {