@helixui/library 1.1.2-next.8 → 1.1.2-next.9

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",
@@ -527,36 +303,260 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/hx-alert/hx-alert.ts",
+      "path": "src/components/hx-action-bar/hx-action-bar.ts",
       "declarations": [
         {
           "kind": "class",
-          "description": "A feedback component for communicating status messages, warnings, and errors.\nCritical for healthcare patient safety alerts.",
-          "name": "HelixAlert",
+          "description": "A horizontal toolbar container for grouping related action buttons and controls.\nImplements the ARIA toolbar pattern with roving tabindex keyboard navigation.",
+          "name": "HelixActionBar",
           "cssProperties": [
             {
-              "description": "Alert background color.",
-              "name": "--hx-alert-bg",
-              "default": "var(--hx-color-info-50)"
+              "description": "Bar background color (default variant).",
+              "name": "--hx-action-bar-bg",
+              "default": "transparent"
             },
             {
-              "description": "Alert text color.",
-              "name": "--hx-alert-color",
-              "default": "var(--hx-color-info-800)"
+              "description": "Bar border (default variant).",
+              "name": "--hx-action-bar-border",
+              "default": "none"
             },
             {
-              "description": "Alert border color.",
-              "name": "--hx-alert-border-color",
-              "default": "var(--hx-color-info-200)"
+              "description": "Inner padding.",
+              "name": "--hx-action-bar-padding",
+              "default": "var(--hx-space-2,0.5rem) var(--hx-space-3,0.75rem)"
             },
             {
-              "description": "Alert border radius.",
-              "name": "--hx-alert-border-radius",
-              "default": "var(--hx-border-radius-md)"
+              "description": "Gap between slotted items.",
+              "name": "--hx-action-bar-gap",
+              "default": "var(--hx-space-2,0.5rem)"
             },
             {
-              "description": "Alert border width.",
-              "name": "--hx-alert-border-width",
+              "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-alert/hx-alert.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "A feedback component for communicating status messages, warnings, and errors.\nCritical for healthcare patient safety alerts.",
+          "name": "HelixAlert",
+          "cssProperties": [
+            {
+              "description": "Alert background color.",
+              "name": "--hx-alert-bg",
+              "default": "var(--hx-color-info-50)"
+            },
+            {
+              "description": "Alert text color.",
+              "name": "--hx-alert-color",
+              "default": "var(--hx-color-info-800)"
+            },
+            {
+              "description": "Alert border color.",
+              "name": "--hx-alert-border-color",
+              "default": "var(--hx-color-info-200)"
+            },
+            {
+              "description": "Alert border radius.",
+              "name": "--hx-alert-border-radius",
+              "default": "var(--hx-border-radius-md)"
+            },
+            {
+              "description": "Alert border width.",
+              "name": "--hx-alert-border-width",
               "default": "var(--hx-border-width-thin)"
             },
             {
@@ -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": [
@@ -4055,670 +4060,670 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/hx-clinical-status/hx-clinical-status.ts",
+      "path": "src/components/hx-checkbox-group/hx-checkbox-group.ts",
       "declarations": [
         {
           "kind": "class",
-          "description": "A clinical status indicator designed for healthcare alert fatigue prevention.\nStandardizes clinical alert presentations to reduce cognitive overload from\ninconsistent color/icon combinations across healthcare interfaces.",
-          "name": "HelixClinicalStatus",
+          "description": "A form-associated checkbox group that manages a set of `<hx-checkbox>` children.",
+          "name": "HelixCheckboxGroup",
           "cssProperties": [
             {
-              "description": "Background color.",
-              "name": "--hx-clinical-status-bg",
-              "default": "var(--hx-color-info-50)"
+              "description": "Gap between checkbox items.",
+              "name": "--hx-checkbox-group-gap",
+              "default": "var(--hx-space-3, 0.75rem)"
             },
             {
-              "description": "Text color.",
-              "name": "--hx-clinical-status-color",
-              "default": "var(--hx-color-info-800)"
+              "description": "Label text color.",
+              "name": "--hx-checkbox-group-label-color",
+              "default": "var(--hx-color-neutral-700, #343a40)"
             },
             {
-              "description": "Border color.",
-              "name": "--hx-clinical-status-border-color",
-              "default": "var(--hx-color-info-200)"
+              "description": "Error message color.",
+              "name": "--hx-checkbox-group-error-color",
+              "default": "var(--hx-color-error-500, #dc3545)"
             },
             {
-              "description": "Border radius.",
-              "name": "--hx-clinical-status-border-radius",
-              "default": "var(--hx-border-radius-md)"
-            },
-            {
-              "description": "Border width.",
-              "name": "--hx-clinical-status-border-width",
-              "default": "var(--hx-border-width-thin)"
-            },
-            {
-              "description": "Left accent stripe color.",
-              "name": "--hx-clinical-status-accent-color",
-              "default": "var(--hx-color-info-500)"
-            },
-            {
-              "description": "Left accent stripe width.",
-              "name": "--hx-clinical-status-accent-width",
-              "default": "4px"
-            },
-            {
-              "description": "Container padding.",
-              "name": "--hx-clinical-status-padding",
-              "default": "var(--hx-space-4)"
-            },
-            {
-              "description": "Gap between elements.",
-              "name": "--hx-clinical-status-gap",
-              "default": "var(--hx-space-3)"
-            },
+              "description": "Help text color.",
+              "name": "--hx-checkbox-group-help-text-color",
+              "default": "var(--hx-color-neutral-500)"
+            }
+          ],
+          "cssParts": [
             {
-              "description": "Icon color.",
-              "name": "--hx-clinical-status-icon-color",
-              "default": "var(--hx-color-info-500)"
+              "description": "The fieldset wrapper.",
+              "name": "group"
             },
             {
-              "description": "Font family.",
-              "name": "--hx-clinical-status-font-family",
-              "default": "var(--hx-font-family-sans)"
+              "description": "The legend/label.",
+              "name": "label"
             },
             {
-              "description": "Padding in compact mode.",
-              "name": "--hx-clinical-status-compact-padding"
+              "description": "The help text container.",
+              "name": "help-text"
             },
             {
-              "description": "Accent width for emergent severity.",
-              "name": "--hx-clinical-status-emergent-accent-width",
-              "default": "6px"
+              "description": "The error message container.",
+              "name": "error-message"
             }
           ],
-          "cssParts": [
-            {
-              "description": "The outer status container.",
-              "name": "container"
-            },
-            {
-              "description": "The icon container.",
-              "name": "icon"
-            },
+          "slots": [
             {
-              "description": "The message content area.",
-              "name": "message"
+              "description": "`<hx-checkbox>` elements.",
+              "name": ""
             },
             {
-              "description": "The actions container (dismiss/acknowledge buttons).",
-              "name": "actions"
+              "description": "Rich HTML group label (overrides the label property when used).",
+              "name": "label"
             },
             {
-              "description": "The dismiss button (only rendered when dismissible).",
-              "name": "dismiss-button"
+              "description": "Custom error content (overrides the error property).",
+              "name": "error"
             },
             {
-              "description": "The acknowledge button (only rendered when acknowledgeable).",
-              "name": "acknowledge-button"
-            }
-          ],
-          "slots": [
-            {
-              "description": "Default slot for additional message content.",
-              "name": ""
+              "description": "Group-level help text.",
+              "name": "help-text"
             }
           ],
           "members": [
             {
               "kind": "field",
-              "name": "severity",
+              "name": "name",
               "type": {
-                "text": "ClinicalSeverity"
+                "text": "string"
               },
-              "default": "'info'",
-              "description": "Clinical severity level that determines visual styling and ARIA semantics.\n- `info`: Informational, non-urgent (role=\"status\")\n- `warning`: Requires attention but not immediate (role=\"status\")\n- `critical`: Requires prompt clinical attention (role=\"alert\")\n- `emergent`: Life-threatening, immediate action required (role=\"alert\")",
-              "attribute": "severity",
-              "reflects": true
+              "default": "''",
+              "description": "The name used for form submission. Passed to child `hx-checkbox` elements.",
+              "attribute": "name"
             },
             {
               "kind": "field",
-              "name": "message",
+              "name": "label",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "description": "Status message text. Displayed as the primary content of the indicator.",
-              "attribute": "message"
+              "description": "The fieldset legend/label text.",
+              "attribute": "label"
             },
             {
               "kind": "field",
-              "name": "dismissible",
+              "name": "required",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether the status can be dismissed by the user.\nCritical and emergent statuses should require acknowledgment rather than simple dismissal.",
-              "attribute": "dismissible",
+              "description": "Whether at least one checkbox must be checked for form submission.",
+              "attribute": "required",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "persistent",
+              "name": "disabled",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether the status survives page navigation.\nDefaults to false for info/warning, true for critical/emergent.\nWhen set explicitly, overrides the severity-based default.",
-              "attribute": "persistent",
+              "description": "Whether the entire group is disabled.",
+              "attribute": "disabled",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "icon",
+              "name": "error",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "description": "Optional custom icon name. When not set, a default severity-appropriate icon is shown.",
-              "attribute": "icon"
+              "description": "Error message to display. When set, the group enters an error state.",
+              "attribute": "error"
             },
             {
               "kind": "field",
-              "name": "compact",
+              "name": "helpText",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "description": "Compact mode for dense clinical UIs (e.g. patient dashboards, bedside displays).\nReduces padding, font size, and icon size.",
-              "attribute": "compact",
+              "default": "''",
+              "description": "Help text to display below the group. Can also be provided via the help-text slot.",
+              "attribute": "help-text"
+            },
+            {
+              "kind": "field",
+              "name": "orientation",
+              "type": {
+                "text": "'vertical' | 'horizontal'"
+              },
+              "description": "Layout orientation of the checkbox items.",
+              "attribute": "orientation",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "_isAssertive",
+              "name": "form",
               "type": {
-                "text": "boolean"
+                "text": "HTMLFormElement | null"
               },
-              "privacy": "private",
-              "description": "Returns true when the severity requires assertive announcement.",
+              "description": "Returns the associated form element, if any.",
               "readonly": true
             },
             {
               "kind": "field",
-              "name": "_role",
+              "name": "validationMessage",
               "type": {
                 "text": "string"
               },
-              "privacy": "private",
-              "description": "Returns the appropriate ARIA role based on severity.",
+              "description": "Returns the validation message.",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "validity",
+              "type": {
+                "text": "ValidityState"
+              },
+              "description": "Returns the ValidityState object.",
               "readonly": true
             },
             {
               "kind": "method",
-              "name": "_severityLabel",
-              "privacy": "private",
+              "name": "checkValidity",
               "return": {
                 "type": {
-                  "text": "string"
+                  "text": "boolean"
                 }
               },
-              "description": "Returns the default severity label for screen readers (WCAG 1.4.1)."
-            },
-            {
-              "kind": "field",
-              "name": "_requiresAcknowledgment",
-              "type": {
-                "text": "boolean"
-              },
-              "privacy": "private",
-              "description": "Returns true when the severity requires explicit acknowledgment.",
-              "readonly": true
+              "description": "Checks whether the group satisfies its constraints."
             },
             {
-              "kind": "field",
-              "name": "_effectivePersistent",
-              "type": {
-                "text": "boolean"
+              "kind": "method",
+              "name": "reportValidity",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
               },
-              "privacy": "private",
-              "description": "Effective persistent value, considering severity-based defaults.",
-              "readonly": true
+              "description": "Reports validity and shows the browser's constraint validation UI."
             }
           ],
           "events": [
             {
-              "name": "hx-dismiss",
               "type": {
-                "text": "CustomEvent<void>"
-              },
-              "description": "Dispatched when the user dismisses the status."
-            },
-            {
-              "name": "hx-acknowledge",
-              "type": {
-                "text": "CustomEvent<{ severity: ClinicalSeverity; persistent: boolean }>"
+                "text": "CustomEvent<{values: string[]}>"
               },
-              "description": "Dispatched when the user acknowledges a critical/emergent status."
+              "description": "Dispatched when any child checkbox changes.",
+              "name": "hx-change"
             }
           ],
           "attributes": [
             {
-              "name": "severity",
+              "name": "name",
               "type": {
-                "text": "ClinicalSeverity"
+                "text": "string"
               },
-              "default": "'info'",
-              "description": "Clinical severity level that determines visual styling and ARIA semantics.\n- `info`: Informational, non-urgent (role=\"status\")\n- `warning`: Requires attention but not immediate (role=\"status\")\n- `critical`: Requires prompt clinical attention (role=\"alert\")\n- `emergent`: Life-threatening, immediate action required (role=\"alert\")",
-              "fieldName": "severity",
-              "attribute": "severity"
+              "default": "''",
+              "description": "The name used for form submission. Passed to child `hx-checkbox` elements.",
+              "fieldName": "name",
+              "attribute": "name"
             },
             {
-              "name": "message",
+              "name": "label",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "description": "Status message text. Displayed as the primary content of the indicator.",
-              "fieldName": "message",
-              "attribute": "message"
+              "description": "The fieldset legend/label text.",
+              "fieldName": "label",
+              "attribute": "label"
             },
             {
-              "name": "dismissible",
+              "name": "required",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether the status can be dismissed by the user.\nCritical and emergent statuses should require acknowledgment rather than simple dismissal.",
-              "fieldName": "dismissible",
-              "attribute": "dismissible"
+              "description": "Whether at least one checkbox must be checked for form submission.",
+              "fieldName": "required",
+              "attribute": "required"
             },
             {
-              "name": "persistent",
+              "name": "disabled",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether the status survives page navigation.\nDefaults to false for info/warning, true for critical/emergent.\nWhen set explicitly, overrides the severity-based default.",
-              "fieldName": "persistent",
-              "attribute": "persistent"
+              "description": "Whether the entire group is disabled.",
+              "fieldName": "disabled",
+              "attribute": "disabled"
             },
             {
-              "name": "icon",
+              "name": "error",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "description": "Optional custom icon name. When not set, a default severity-appropriate icon is shown.",
-              "fieldName": "icon",
-              "attribute": "icon"
+              "description": "Error message to display. When set, the group enters an error state.",
+              "fieldName": "error",
+              "attribute": "error"
             },
             {
-              "name": "compact",
+              "name": "help-text",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "description": "Compact mode for dense clinical UIs (e.g. patient dashboards, bedside displays).\nReduces padding, font size, and icon size.",
-              "fieldName": "compact",
-              "attribute": "compact"
+              "default": "''",
+              "description": "Help text to display below the group. Can also be provided via the help-text slot.",
+              "fieldName": "helpText",
+              "attribute": "help-text"
+            },
+            {
+              "name": "orientation",
+              "type": {
+                "text": "'vertical' | 'horizontal'"
+              },
+              "description": "Layout orientation of the checkbox items.",
+              "fieldName": "orientation",
+              "attribute": "orientation"
             }
           ],
           "superclass": {
-            "name": "HelixElement",
-            "module": "/src/base/index.js"
+            "name": "LitElement",
+            "package": "lit"
           },
-          "tagName": "hx-clinical-status",
+          "tagName": "hx-checkbox-group",
           "customElement": true,
-          "summary": "Clinical status indicator for standardized healthcare alert fatigue prevention."
+          "summary": "Form-associated checkbox group with label, validation, help text, and multi-value form submission."
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "HelixClinicalStatus",
+          "name": "HelixCheckboxGroup",
           "declaration": {
-            "name": "HelixClinicalStatus",
-            "module": "src/components/hx-clinical-status/hx-clinical-status.ts"
+            "name": "HelixCheckboxGroup",
+            "module": "src/components/hx-checkbox-group/hx-checkbox-group.ts"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "hx-clinical-status",
+          "name": "hx-checkbox-group",
           "declaration": {
-            "name": "HelixClinicalStatus",
-            "module": "src/components/hx-clinical-status/hx-clinical-status.ts"
+            "name": "HelixCheckboxGroup",
+            "module": "src/components/hx-checkbox-group/hx-checkbox-group.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/hx-clinical-status/index.ts",
+      "path": "src/components/hx-checkbox-group/index.ts",
       "declarations": [],
       "exports": [
         {
           "kind": "js",
-          "name": "HelixClinicalStatus",
-          "declaration": {
-            "name": "HelixClinicalStatus",
-            "module": "./hx-clinical-status.js"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "ClinicalSeverity",
-          "declaration": {
-            "name": "ClinicalSeverity",
-            "module": "./hx-clinical-status.js"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "HxClinicalStatus",
+          "name": "HelixCheckboxGroup",
           "declaration": {
-            "name": "HxClinicalStatus",
-            "module": "./hx-clinical-status.js"
+            "name": "HelixCheckboxGroup",
+            "module": "./hx-checkbox-group.js"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/hx-checkbox-group/hx-checkbox-group.ts",
+      "path": "src/components/hx-clinical-status/hx-clinical-status.ts",
       "declarations": [
         {
           "kind": "class",
-          "description": "A form-associated checkbox group that manages a set of `<hx-checkbox>` children.",
-          "name": "HelixCheckboxGroup",
+          "description": "A clinical status indicator designed for healthcare alert fatigue prevention.\nStandardizes clinical alert presentations to reduce cognitive overload from\ninconsistent color/icon combinations across healthcare interfaces.",
+          "name": "HelixClinicalStatus",
           "cssProperties": [
             {
-              "description": "Gap between checkbox items.",
-              "name": "--hx-checkbox-group-gap",
-              "default": "var(--hx-space-3, 0.75rem)"
+              "description": "Background color.",
+              "name": "--hx-clinical-status-bg",
+              "default": "var(--hx-color-info-50)"
             },
             {
-              "description": "Label text color.",
-              "name": "--hx-checkbox-group-label-color",
-              "default": "var(--hx-color-neutral-700, #343a40)"
+              "description": "Text color.",
+              "name": "--hx-clinical-status-color",
+              "default": "var(--hx-color-info-800)"
             },
             {
-              "description": "Error message color.",
-              "name": "--hx-checkbox-group-error-color",
-              "default": "var(--hx-color-error-500, #dc3545)"
+              "description": "Border color.",
+              "name": "--hx-clinical-status-border-color",
+              "default": "var(--hx-color-info-200)"
             },
             {
-              "description": "Help text color.",
-              "name": "--hx-checkbox-group-help-text-color",
-              "default": "var(--hx-color-neutral-500)"
-            }
-          ],
-          "cssParts": [
+              "description": "Border radius.",
+              "name": "--hx-clinical-status-border-radius",
+              "default": "var(--hx-border-radius-md)"
+            },
             {
-              "description": "The fieldset wrapper.",
-              "name": "group"
+              "description": "Border width.",
+              "name": "--hx-clinical-status-border-width",
+              "default": "var(--hx-border-width-thin)"
             },
             {
-              "description": "The legend/label.",
-              "name": "label"
+              "description": "Left accent stripe color.",
+              "name": "--hx-clinical-status-accent-color",
+              "default": "var(--hx-color-info-500)"
             },
             {
-              "description": "The help text container.",
-              "name": "help-text"
+              "description": "Left accent stripe width.",
+              "name": "--hx-clinical-status-accent-width",
+              "default": "4px"
             },
             {
-              "description": "The error message container.",
-              "name": "error-message"
+              "description": "Container padding.",
+              "name": "--hx-clinical-status-padding",
+              "default": "var(--hx-space-4)"
+            },
+            {
+              "description": "Gap between elements.",
+              "name": "--hx-clinical-status-gap",
+              "default": "var(--hx-space-3)"
+            },
+            {
+              "description": "Icon color.",
+              "name": "--hx-clinical-status-icon-color",
+              "default": "var(--hx-color-info-500)"
+            },
+            {
+              "description": "Font family.",
+              "name": "--hx-clinical-status-font-family",
+              "default": "var(--hx-font-family-sans)"
+            },
+            {
+              "description": "Padding in compact mode.",
+              "name": "--hx-clinical-status-compact-padding"
+            },
+            {
+              "description": "Accent width for emergent severity.",
+              "name": "--hx-clinical-status-emergent-accent-width",
+              "default": "6px"
             }
           ],
-          "slots": [
+          "cssParts": [
             {
-              "description": "`<hx-checkbox>` elements.",
-              "name": ""
+              "description": "The outer status container.",
+              "name": "container"
             },
             {
-              "description": "Rich HTML group label (overrides the label property when used).",
-              "name": "label"
+              "description": "The icon container.",
+              "name": "icon"
             },
             {
-              "description": "Custom error content (overrides the error property).",
-              "name": "error"
+              "description": "The message content area.",
+              "name": "message"
             },
             {
-              "description": "Group-level help text.",
-              "name": "help-text"
+              "description": "The actions container (dismiss/acknowledge buttons).",
+              "name": "actions"
+            },
+            {
+              "description": "The dismiss button (only rendered when dismissible).",
+              "name": "dismiss-button"
+            },
+            {
+              "description": "The acknowledge button (only rendered when acknowledgeable).",
+              "name": "acknowledge-button"
+            }
+          ],
+          "slots": [
+            {
+              "description": "Default slot for additional message content.",
+              "name": ""
             }
           ],
           "members": [
             {
               "kind": "field",
-              "name": "name",
+              "name": "severity",
               "type": {
-                "text": "string"
+                "text": "ClinicalSeverity"
               },
-              "default": "''",
-              "description": "The name used for form submission. Passed to child `hx-checkbox` elements.",
-              "attribute": "name"
+              "default": "'info'",
+              "description": "Clinical severity level that determines visual styling and ARIA semantics.\n- `info`: Informational, non-urgent (role=\"status\")\n- `warning`: Requires attention but not immediate (role=\"status\")\n- `critical`: Requires prompt clinical attention (role=\"alert\")\n- `emergent`: Life-threatening, immediate action required (role=\"alert\")",
+              "attribute": "severity",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "label",
+              "name": "message",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "description": "The fieldset legend/label text.",
-              "attribute": "label"
+              "description": "Status message text. Displayed as the primary content of the indicator.",
+              "attribute": "message"
             },
             {
               "kind": "field",
-              "name": "required",
+              "name": "dismissible",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether at least one checkbox must be checked for form submission.",
-              "attribute": "required",
+              "description": "Whether the status can be dismissed by the user.\nCritical and emergent statuses should require acknowledgment rather than simple dismissal.",
+              "attribute": "dismissible",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "disabled",
+              "name": "persistent",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether the entire group is disabled.",
-              "attribute": "disabled",
+              "description": "Whether the status survives page navigation.\nDefaults to false for info/warning, true for critical/emergent.\nWhen set explicitly, overrides the severity-based default.",
+              "attribute": "persistent",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "error",
-              "type": {
-                "text": "string"
-              },
-              "default": "''",
-              "description": "Error message to display. When set, the group enters an error state.",
-              "attribute": "error"
-            },
-            {
-              "kind": "field",
-              "name": "helpText",
+              "name": "icon",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "description": "Help text to display below the group. Can also be provided via the help-text slot.",
-              "attribute": "help-text"
+              "description": "Optional custom icon name. When not set, a default severity-appropriate icon is shown.",
+              "attribute": "icon"
             },
             {
               "kind": "field",
-              "name": "orientation",
+              "name": "compact",
               "type": {
-                "text": "'vertical' | 'horizontal'"
+                "text": "boolean"
               },
-              "description": "Layout orientation of the checkbox items.",
-              "attribute": "orientation",
+              "default": "false",
+              "description": "Compact mode for dense clinical UIs (e.g. patient dashboards, bedside displays).\nReduces padding, font size, and icon size.",
+              "attribute": "compact",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "form",
+              "name": "_isAssertive",
               "type": {
-                "text": "HTMLFormElement | null"
+                "text": "boolean"
               },
-              "description": "Returns the associated form element, if any.",
+              "privacy": "private",
+              "description": "Returns true when the severity requires assertive announcement.",
               "readonly": true
             },
             {
               "kind": "field",
-              "name": "validationMessage",
+              "name": "_role",
               "type": {
                 "text": "string"
               },
-              "description": "Returns the validation message.",
-              "readonly": true
-            },
-            {
-              "kind": "field",
-              "name": "validity",
-              "type": {
-                "text": "ValidityState"
-              },
-              "description": "Returns the ValidityState object.",
+              "privacy": "private",
+              "description": "Returns the appropriate ARIA role based on severity.",
               "readonly": true
             },
             {
               "kind": "method",
-              "name": "checkValidity",
+              "name": "_severityLabel",
+              "privacy": "private",
               "return": {
                 "type": {
-                  "text": "boolean"
+                  "text": "string"
                 }
               },
-              "description": "Checks whether the group satisfies its constraints."
+              "description": "Returns the default severity label for screen readers (WCAG 1.4.1)."
             },
             {
-              "kind": "method",
-              "name": "reportValidity",
-              "return": {
-                "type": {
-                  "text": "boolean"
-                }
+              "kind": "field",
+              "name": "_requiresAcknowledgment",
+              "type": {
+                "text": "boolean"
               },
-              "description": "Reports validity and shows the browser's constraint validation UI."
+              "privacy": "private",
+              "description": "Returns true when the severity requires explicit acknowledgment.",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "_effectivePersistent",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "description": "Effective persistent value, considering severity-based defaults.",
+              "readonly": true
             }
           ],
           "events": [
             {
+              "name": "hx-dismiss",
               "type": {
-                "text": "CustomEvent<{values: string[]}>"
+                "text": "CustomEvent<void>"
               },
-              "description": "Dispatched when any child checkbox changes.",
-              "name": "hx-change"
+              "description": "Dispatched when the user dismisses the status."
+            },
+            {
+              "name": "hx-acknowledge",
+              "type": {
+                "text": "CustomEvent<{ severity: ClinicalSeverity; persistent: boolean }>"
+              },
+              "description": "Dispatched when the user acknowledges a critical/emergent status."
             }
           ],
           "attributes": [
             {
-              "name": "name",
+              "name": "severity",
               "type": {
-                "text": "string"
+                "text": "ClinicalSeverity"
               },
-              "default": "''",
-              "description": "The name used for form submission. Passed to child `hx-checkbox` elements.",
-              "fieldName": "name",
-              "attribute": "name"
+              "default": "'info'",
+              "description": "Clinical severity level that determines visual styling and ARIA semantics.\n- `info`: Informational, non-urgent (role=\"status\")\n- `warning`: Requires attention but not immediate (role=\"status\")\n- `critical`: Requires prompt clinical attention (role=\"alert\")\n- `emergent`: Life-threatening, immediate action required (role=\"alert\")",
+              "fieldName": "severity",
+              "attribute": "severity"
             },
             {
-              "name": "label",
+              "name": "message",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "description": "The fieldset legend/label text.",
-              "fieldName": "label",
-              "attribute": "label"
+              "description": "Status message text. Displayed as the primary content of the indicator.",
+              "fieldName": "message",
+              "attribute": "message"
             },
             {
-              "name": "required",
+              "name": "dismissible",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether at least one checkbox must be checked for form submission.",
-              "fieldName": "required",
-              "attribute": "required"
+              "description": "Whether the status can be dismissed by the user.\nCritical and emergent statuses should require acknowledgment rather than simple dismissal.",
+              "fieldName": "dismissible",
+              "attribute": "dismissible"
             },
             {
-              "name": "disabled",
+              "name": "persistent",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether the entire group is disabled.",
-              "fieldName": "disabled",
-              "attribute": "disabled"
-            },
-            {
-              "name": "error",
-              "type": {
-                "text": "string"
-              },
-              "default": "''",
-              "description": "Error message to display. When set, the group enters an error state.",
-              "fieldName": "error",
-              "attribute": "error"
+              "description": "Whether the status survives page navigation.\nDefaults to false for info/warning, true for critical/emergent.\nWhen set explicitly, overrides the severity-based default.",
+              "fieldName": "persistent",
+              "attribute": "persistent"
             },
             {
-              "name": "help-text",
+              "name": "icon",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "description": "Help text to display below the group. Can also be provided via the help-text slot.",
-              "fieldName": "helpText",
-              "attribute": "help-text"
+              "description": "Optional custom icon name. When not set, a default severity-appropriate icon is shown.",
+              "fieldName": "icon",
+              "attribute": "icon"
             },
             {
-              "name": "orientation",
+              "name": "compact",
               "type": {
-                "text": "'vertical' | 'horizontal'"
+                "text": "boolean"
               },
-              "description": "Layout orientation of the checkbox items.",
-              "fieldName": "orientation",
-              "attribute": "orientation"
+              "default": "false",
+              "description": "Compact mode for dense clinical UIs (e.g. patient dashboards, bedside displays).\nReduces padding, font size, and icon size.",
+              "fieldName": "compact",
+              "attribute": "compact"
             }
           ],
           "superclass": {
-            "name": "LitElement",
-            "package": "lit"
+            "name": "HelixElement",
+            "module": "/src/base/index.js"
           },
-          "tagName": "hx-checkbox-group",
+          "tagName": "hx-clinical-status",
           "customElement": true,
-          "summary": "Form-associated checkbox group with label, validation, help text, and multi-value form submission."
+          "summary": "Clinical status indicator for standardized healthcare alert fatigue prevention."
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "HelixCheckboxGroup",
+          "name": "HelixClinicalStatus",
           "declaration": {
-            "name": "HelixCheckboxGroup",
-            "module": "src/components/hx-checkbox-group/hx-checkbox-group.ts"
+            "name": "HelixClinicalStatus",
+            "module": "src/components/hx-clinical-status/hx-clinical-status.ts"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "hx-checkbox-group",
+          "name": "hx-clinical-status",
           "declaration": {
-            "name": "HelixCheckboxGroup",
-            "module": "src/components/hx-checkbox-group/hx-checkbox-group.ts"
+            "name": "HelixClinicalStatus",
+            "module": "src/components/hx-clinical-status/hx-clinical-status.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/hx-checkbox-group/index.ts",
+      "path": "src/components/hx-clinical-status/index.ts",
       "declarations": [],
       "exports": [
         {
           "kind": "js",
-          "name": "HelixCheckboxGroup",
+          "name": "HelixClinicalStatus",
           "declaration": {
-            "name": "HelixCheckboxGroup",
-            "module": "./hx-checkbox-group.js"
+            "name": "HelixClinicalStatus",
+            "module": "./hx-clinical-status.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ClinicalSeverity",
+          "declaration": {
+            "name": "ClinicalSeverity",
+            "module": "./hx-clinical-status.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "HxClinicalStatus",
+          "declaration": {
+            "name": "HxClinicalStatus",
+            "module": "./hx-clinical-status.js"
           }
         }
       ]
@@ -13015,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",
@@ -13103,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": [
@@ -13217,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": [
@@ -23768,7 +23803,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": [
@@ -23781,6 +23816,9 @@
             }
           ],
           "attributes": [
+            {
+              "name": "selected-index"
+            },
             {
               "name": "orientation",
               "type": {
@@ -27538,6 +27576,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",