@helixui/library 1.1.2-next.2 → 1.1.2-next.25

package/custom-elements.json

@@ -2,230 +2,6 @@
   "schemaVersion": "1.0.0",
   "readme": "",
   "modules": [
-    {
-      "kind": "javascript-module",
-      "path": "src/components/hx-action-bar/hx-action-bar.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",
-          "cssProperties": [
-            {
-              "description": "Bar background color (default variant).",
-              "name": "--hx-action-bar-bg",
-              "default": "transparent"
-            },
-            {
-              "description": "Bar border (default variant).",
-              "name": "--hx-action-bar-border",
-              "default": "none"
-            },
-            {
-              "description": "Inner padding.",
-              "name": "--hx-action-bar-padding",
-              "default": "var(--hx-space-2,0.5rem) var(--hx-space-3,0.75rem)"
-            },
-            {
-              "description": "Gap between slotted items.",
-              "name": "--hx-action-bar-gap",
-              "default": "var(--hx-space-2,0.5rem)"
-            },
-            {
-              "description": "Z-index when sticky or bottom position.",
-              "name": "--hx-action-bar-z-index",
-              "default": "10"
-            }
-          ],
-          "cssParts": [
-            {
-              "description": "The root toolbar container element.",
-              "name": "base"
-            },
-            {
-              "description": "The start (left) slot wrapper.",
-              "name": "start"
-            },
-            {
-              "description": "The center (default) slot wrapper.",
-              "name": "center"
-            },
-            {
-              "description": "The end (right) slot wrapper.",
-              "name": "end"
-            },
-            {
-              "description": "The overflow slot wrapper (hidden when no overflow content).",
-              "name": "overflow"
-            }
-          ],
-          "slots": [
-            {
-              "description": "Left-aligned actions.",
-              "name": "start"
-            },
-            {
-              "description": "Center content (default slot).",
-              "name": ""
-            },
-            {
-              "description": "Right-aligned actions.",
-              "name": "end"
-            },
-            {
-              "description": "Actions revealed when the bar is constrained for space.",
-              "name": "overflow"
-            }
-          ],
-          "members": [
-            {
-              "kind": "field",
-              "name": "size",
-              "type": {
-                "text": "'sm' | 'md' | 'lg'"
-              },
-              "default": "'md'",
-              "description": "Size of the action bar — propagated as a data attribute to slotted children.",
-              "attribute": "hx-size",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "variant",
-              "type": {
-                "text": "'default' | 'outlined' | 'filled'"
-              },
-              "default": "'default'",
-              "description": "Visual variant controlling the bar background.",
-              "attribute": "variant",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "position",
-              "type": {
-                "text": "'top' | 'bottom' | 'sticky'"
-              },
-              "default": "'top'",
-              "description": "Position and sticky behavior of the action bar.\n- `top` — normal flow (default)\n- `sticky` — sticks to the top of the scroll container; add `scroll-padding-top` to the\n  scroll container equal to the bar height to prevent anchor targets from scrolling behind it\n- `bottom` — sticks to the bottom of the scroll container with iOS safe-area-inset support",
-              "attribute": "position",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "sticky",
-              "type": {
-                "text": "boolean"
-              },
-              "deprecated": "Use `position=\"sticky\"` instead.\nWhen true, the bar sticks to the top of its scroll container.",
-              "attribute": "sticky",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "ariaLabel",
-              "type": {
-                "text": "string"
-              },
-              "default": "'Actions'",
-              "description": "Accessible label for the toolbar.\nRequired when multiple toolbars appear on the same page.",
-              "attribute": "aria-label"
-            }
-          ],
-          "attributes": [
-            {
-              "name": "hx-size",
-              "type": {
-                "text": "'sm' | 'md' | 'lg'"
-              },
-              "default": "'md'",
-              "description": "Size of the action bar — propagated as a data attribute to slotted children.",
-              "fieldName": "size",
-              "attribute": "hx-size"
-            },
-            {
-              "name": "variant",
-              "type": {
-                "text": "'default' | 'outlined' | 'filled'"
-              },
-              "default": "'default'",
-              "description": "Visual variant controlling the bar background.",
-              "fieldName": "variant",
-              "attribute": "variant"
-            },
-            {
-              "name": "position",
-              "type": {
-                "text": "'top' | 'bottom' | 'sticky'"
-              },
-              "default": "'top'",
-              "description": "Position and sticky behavior of the action bar.\n- `top` — normal flow (default)\n- `sticky` — sticks to the top of the scroll container; add `scroll-padding-top` to the\n  scroll container equal to the bar height to prevent anchor targets from scrolling behind it\n- `bottom` — sticks to the bottom of the scroll container with iOS safe-area-inset support",
-              "fieldName": "position",
-              "attribute": "position"
-            },
-            {
-              "name": "sticky",
-              "type": {
-                "text": "boolean"
-              },
-              "deprecated": "Use `position=\"sticky\"` instead.\nWhen true, the bar sticks to the top of its scroll container.",
-              "fieldName": "sticky",
-              "attribute": "sticky"
-            },
-            {
-              "name": "aria-label",
-              "type": {
-                "text": "string"
-              },
-              "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-action-bar",
-          "customElement": true,
-          "summary": "Horizontal action bar for grouping related controls."
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "HelixActionBar",
-          "declaration": {
-            "name": "HelixActionBar",
-            "module": "src/components/hx-action-bar/hx-action-bar.ts"
-          }
-        },
-        {
-          "kind": "custom-element-definition",
-          "name": "hx-action-bar",
-          "declaration": {
-            "name": "HelixActionBar",
-            "module": "src/components/hx-action-bar/hx-action-bar.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/components/hx-action-bar/index.ts",
-      "declarations": [],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "HelixActionBar",
-          "declaration": {
-            "name": "HelixActionBar",
-            "module": "./hx-action-bar.js"
-          }
-        }
-      ]
-    },
     {
       "kind": "javascript-module",
       "path": "src/components/hx-accordion/hx-accordion-item.ts",
@@ -494,33 +270,257 @@
         },
         {
           "kind": "custom-element-definition",
-          "name": "hx-accordion",
+          "name": "hx-accordion",
+          "declaration": {
+            "name": "HelixAccordion",
+            "module": "src/components/hx-accordion/hx-accordion.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/hx-accordion/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "HelixAccordion",
+          "declaration": {
+            "name": "HelixAccordion",
+            "module": "./hx-accordion.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "HelixAccordionItem",
+          "declaration": {
+            "name": "HelixAccordionItem",
+            "module": "./hx-accordion-item.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/hx-action-bar/hx-action-bar.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",
+          "cssProperties": [
+            {
+              "description": "Bar background color (default variant).",
+              "name": "--hx-action-bar-bg",
+              "default": "transparent"
+            },
+            {
+              "description": "Bar border (default variant).",
+              "name": "--hx-action-bar-border",
+              "default": "none"
+            },
+            {
+              "description": "Inner padding.",
+              "name": "--hx-action-bar-padding",
+              "default": "var(--hx-space-2,0.5rem) var(--hx-space-3,0.75rem)"
+            },
+            {
+              "description": "Gap between slotted items.",
+              "name": "--hx-action-bar-gap",
+              "default": "var(--hx-space-2,0.5rem)"
+            },
+            {
+              "description": "Z-index when sticky or bottom position.",
+              "name": "--hx-action-bar-z-index",
+              "default": "10"
+            }
+          ],
+          "cssParts": [
+            {
+              "description": "The root toolbar container element.",
+              "name": "base"
+            },
+            {
+              "description": "The start (left) slot wrapper.",
+              "name": "start"
+            },
+            {
+              "description": "The center (default) slot wrapper.",
+              "name": "center"
+            },
+            {
+              "description": "The end (right) slot wrapper.",
+              "name": "end"
+            },
+            {
+              "description": "The overflow slot wrapper (hidden when no overflow content).",
+              "name": "overflow"
+            }
+          ],
+          "slots": [
+            {
+              "description": "Left-aligned actions.",
+              "name": "start"
+            },
+            {
+              "description": "Center content (default slot).",
+              "name": ""
+            },
+            {
+              "description": "Right-aligned actions.",
+              "name": "end"
+            },
+            {
+              "description": "Actions revealed when the bar is constrained for space.",
+              "name": "overflow"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "size",
+              "type": {
+                "text": "'sm' | 'md' | 'lg'"
+              },
+              "default": "'md'",
+              "description": "Size of the action bar — propagated as a data attribute to slotted children.",
+              "attribute": "hx-size",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "variant",
+              "type": {
+                "text": "'default' | 'outlined' | 'filled'"
+              },
+              "default": "'default'",
+              "description": "Visual variant controlling the bar background.",
+              "attribute": "variant",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "position",
+              "type": {
+                "text": "'top' | 'bottom' | 'sticky'"
+              },
+              "default": "'top'",
+              "description": "Position and sticky behavior of the action bar.\n- `top` — normal flow (default)\n- `sticky` — sticks to the top of the scroll container; add `scroll-padding-top` to the\n  scroll container equal to the bar height to prevent anchor targets from scrolling behind it\n- `bottom` — sticks to the bottom of the scroll container with iOS safe-area-inset support",
+              "attribute": "position",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "sticky",
+              "type": {
+                "text": "boolean"
+              },
+              "deprecated": "Use `position=\"sticky\"` instead.\nWhen true, the bar sticks to the top of its scroll container.",
+              "attribute": "sticky",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "ariaLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Actions'",
+              "description": "Accessible label for the toolbar.\nRequired when multiple toolbars appear on the same page.",
+              "attribute": "aria-label"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "hx-size",
+              "type": {
+                "text": "'sm' | 'md' | 'lg'"
+              },
+              "default": "'md'",
+              "description": "Size of the action bar — propagated as a data attribute to slotted children.",
+              "fieldName": "size",
+              "attribute": "hx-size"
+            },
+            {
+              "name": "variant",
+              "type": {
+                "text": "'default' | 'outlined' | 'filled'"
+              },
+              "default": "'default'",
+              "description": "Visual variant controlling the bar background.",
+              "fieldName": "variant",
+              "attribute": "variant"
+            },
+            {
+              "name": "position",
+              "type": {
+                "text": "'top' | 'bottom' | 'sticky'"
+              },
+              "default": "'top'",
+              "description": "Position and sticky behavior of the action bar.\n- `top` — normal flow (default)\n- `sticky` — sticks to the top of the scroll container; add `scroll-padding-top` to the\n  scroll container equal to the bar height to prevent anchor targets from scrolling behind it\n- `bottom` — sticks to the bottom of the scroll container with iOS safe-area-inset support",
+              "fieldName": "position",
+              "attribute": "position"
+            },
+            {
+              "name": "sticky",
+              "type": {
+                "text": "boolean"
+              },
+              "deprecated": "Use `position=\"sticky\"` instead.\nWhen true, the bar sticks to the top of its scroll container.",
+              "fieldName": "sticky",
+              "attribute": "sticky"
+            },
+            {
+              "name": "aria-label",
+              "type": {
+                "text": "string"
+              },
+              "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-action-bar",
+          "customElement": true,
+          "summary": "Horizontal action bar for grouping related controls."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "HelixActionBar",
+          "declaration": {
+            "name": "HelixActionBar",
+            "module": "src/components/hx-action-bar/hx-action-bar.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "hx-action-bar",
           "declaration": {
-            "name": "HelixAccordion",
-            "module": "src/components/hx-accordion/hx-accordion.ts"
+            "name": "HelixActionBar",
+            "module": "src/components/hx-action-bar/hx-action-bar.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/hx-accordion/index.ts",
+      "path": "src/components/hx-action-bar/index.ts",
       "declarations": [],
       "exports": [
         {
           "kind": "js",
-          "name": "HelixAccordion",
-          "declaration": {
-            "name": "HelixAccordion",
-            "module": "./hx-accordion.js"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "HelixAccordionItem",
+          "name": "HelixActionBar",
           "declaration": {
-            "name": "HelixAccordionItem",
-            "module": "./hx-accordion-item.js"
+            "name": "HelixActionBar",
+            "module": "./hx-action-bar.js"
           }
         }
       ]
@@ -1920,6 +1920,11 @@
             {
               "description": "Optional max-width for text truncation.",
               "name": "--hx-breadcrumb-item-max-width"
+            },
+            {
+              "description": "Focus ring color for breadcrumb links.",
+              "name": "--hx-breadcrumb-link-focus-ring-color",
+              "default": "var(--hx-focus-ring-color, var(--hx-color-primary-500))"
             }
           ],
           "cssParts": [
@@ -4534,12 +4539,6 @@
               "attribute": "compact",
               "reflects": true
             },
-            {
-              "kind": "field",
-              "name": "_componentId",
-              "privacy": "private",
-              "description": "SSR-safe unique ID for ARIA relationships."
-            },
             {
               "kind": "field",
               "name": "_isAssertive",
@@ -4596,14 +4595,14 @@
             {
               "name": "hx-dismiss",
               "type": {
-                "text": "CustomEvent"
+                "text": "CustomEvent<void>"
               },
               "description": "Dispatched when the user dismisses the status."
             },
             {
               "name": "hx-acknowledge",
               "type": {
-                "text": "CustomEvent"
+                "text": "CustomEvent<{ severity: ClinicalSeverity; persistent: boolean }>"
               },
               "description": "Dispatched when the user acknowledges a critical/emergent status."
             }
@@ -4695,14 +4694,6 @@
             "name": "HelixClinicalStatus",
             "module": "src/components/hx-clinical-status/hx-clinical-status.ts"
           }
-        },
-        {
-          "kind": "js",
-          "name": "HxClinicalStatus",
-          "declaration": {
-            "name": "HelixClinicalStatus",
-            "module": "src/components/hx-clinical-status/hx-clinical-status.ts"
-          }
         }
       ]
     },
@@ -4726,6 +4717,14 @@
             "name": "ClinicalSeverity",
             "module": "./hx-clinical-status.js"
           }
+        },
+        {
+          "kind": "js",
+          "name": "HxClinicalStatus",
+          "declaration": {
+            "name": "HxClinicalStatus",
+            "module": "./hx-clinical-status.js"
+          }
         }
       ]
     },
@@ -13021,6 +13020,24 @@
             }
           ],
           "members": [
+            {
+              "kind": "method",
+              "name": "setSubmenuOpen",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "open",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ],
+              "description": "Set whether the nested submenu is open. Called by the component managing submenu visibility."
+            },
             {
               "kind": "field",
               "name": "value",
@@ -13109,6 +13126,13 @@
                 "text": "CustomEvent<{item: HelixMenuItem}>"
               },
               "description": "Dispatched when ArrowRight is pressed on an item with a submenu."
+            },
+            {
+              "name": "hx-item-submenu-close",
+              "type": {
+                "text": "CustomEvent<{item: HelixMenuItem}>"
+              },
+              "description": "Dispatched when ArrowLeft is pressed on an item, signaling the parent to close the submenu and return focus."
             }
           ],
           "attributes": [
@@ -13223,6 +13247,11 @@
               "description": "Minimum menu width.",
               "name": "--hx-menu-min-width",
               "default": "10rem"
+            },
+            {
+              "description": "Maximum menu height before vertical scroll is activated.",
+              "name": "--hx-menu-max-height",
+              "default": "20rem"
             }
           ],
           "cssParts": [
@@ -15229,6 +15258,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": [
@@ -15255,6 +15289,10 @@
             {
               "description": "The field value slot wrapper.",
               "name": "field-value"
+            },
+            {
+              "description": "The visually-hidden identifier rule violation status message.",
+              "name": "violation-message"
             }
           ],
           "slots": [
@@ -15365,39 +15403,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",
@@ -15604,6 +15609,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": [
@@ -15664,127 +15674,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": [
@@ -15793,7 +15700,7 @@
               "type": {
                 "text": "CustomEvent<PhiAccessEventDetail>"
               },
-              "description": "Fired on reveal, hide, and clipboard auto-clear."
+              "description": "Fired on reveal, hide, and clipboard-clear actions."
             }
           ],
           "attributes": [
@@ -15836,6 +15743,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": {
@@ -18191,6 +18118,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",
@@ -18868,6 +18800,11 @@
                 }
               ],
               "description": "Delegates focus to the internal link or button element (part=\"link\").\nAllows parent components to focus nav items without piercing the Shadow DOM.\nWCAG 2.1.1: keyboard navigation must not cross shadow boundaries via\ndirect shadowRoot queries."
+            },
+            {
+              "kind": "field",
+              "name": "_tooltipId",
+              "default": "`nav-item-tooltip-${++HelixNavItem._instanceCounter}`"
             }
           ],
           "attributes": [
@@ -21184,7 +21121,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": [
             {
@@ -21230,6 +21167,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": [
@@ -21240,6 +21185,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": [
@@ -21285,6 +21234,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": [
@@ -21327,6 +21287,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": {
@@ -23838,7 +23808,7 @@
               "type": {
                 "text": "number"
               },
-              "description": "Gets or sets the zero-based index of the currently selected tab.\nSetting this programmatically activates the tab at the given index."
+              "description": "Gets or sets the zero-based index of the currently selected tab.\nSetting this programmatically activates the tab at the given index.\nCan also be set via the `selected-index` HTML attribute for server-side\npre-selection (e.g. Drupal Twig templates)."
             }
           ],
           "events": [
@@ -23851,6 +23821,9 @@
             }
           ],
           "attributes": [
+            {
+              "name": "selected-index"
+            },
             {
               "name": "orientation",
               "type": {
@@ -27608,6 +27581,15 @@
               },
               "readonly": true
             },
+            {
+              "kind": "field",
+              "name": "labelText",
+              "type": {
+                "text": "string"
+              },
+              "description": "The text content of the item's label slot, used for typeahead keyboard navigation.\nReturns an empty string until the label slot has been assigned.",
+              "readonly": true
+            },
             {
               "kind": "method",
               "name": "setRovingActive",