@helixui/react 1.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 Clarity House LLC d/b/a Booked Solid Technology
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,101 @@
+# @helixui/react
+
+React wrappers for all 98 HELiX web components. Auto-generated from `custom-elements.json` using [`@lit/react`](https://lit.dev/docs/frameworks/react/) `createComponent()`.
+
+## Installation
+
+```bash
+npm install @helixui/react @helixui/library
+# or
+pnpm add @helixui/react @helixui/library
+```
+
+**Peer dependencies:** `react >= 18.0.0`, `react-dom >= 18.0.0`
+
+## Usage
+
+```tsx
+import { HxButton, HxTextInput, HxDialog } from '@helixui/react';
+
+function MyForm() {
+  return (
+    <form>
+      <HxTextInput label="Name" onHxInput={(e) => console.log(e)} />
+      <HxButton variant="primary" onHxClick={() => console.log('clicked')}>
+        Submit
+      </HxButton>
+    </form>
+  );
+}
+```
+
+## Event Binding
+
+Custom events are mapped to React-style callback props with the `onHx` prefix:
+
+| Web component event | React prop   |
+| ------------------- | ------------ |
+| `hx-click`          | `onHxClick`  |
+| `hx-input`          | `onHxInput`  |
+| `hx-change`         | `onHxChange` |
+| `hx-open`           | `onHxOpen`   |
+| `hx-close`          | `onHxClose`  |
+
+The `onHx*` prefix avoids collision with native React synthetic events (`onChange`, `onClick`).
+
+## Next.js 15 App Router (SSR)
+
+All wrappers include `'use client'` as the first line, making them compatible with Next.js 15 App Router. No additional configuration is needed.
+
+```tsx
+// app/page.tsx (Server Component) — import is fine
+import { HxButton } from '@helixui/react';
+
+// HxButton automatically runs as a Client Component due to 'use client'
+export default function Page() {
+  return <HxButton>Click me</HxButton>;
+}
+```
+
+## Tree-Shaking
+
+Each component is a separate entry point. Importing `HxButton` does not bundle all 98 components:
+
+```tsx
+// Only HxButton is included in your bundle
+import { HxButton } from '@helixui/react';
+
+// Or use the direct component path for explicit splitting
+import { HxButton } from '@helixui/react/components/HxButton';
+```
+
+## TypeScript
+
+All prop types are derived from CEM (`custom-elements.json`) declarations. Props, event handlers, and refs are fully typed:
+
+```tsx
+import { HxButton, type HxButtonProps } from '@helixui/react';
+
+const props: HxButtonProps = {
+  variant: 'primary', // 'primary' | 'secondary' | 'tertiary' | 'danger' | 'ghost' | 'outline'
+  size: 'md', // 'sm' | 'md' | 'lg'
+  disabled: false,
+  onHxClick: (e) => {},
+};
+```
+
+## Regenerating Wrappers
+
+Wrappers are auto-generated from `packages/hx-library/custom-elements.json`. If the CEM changes (new component, new prop, new event), regenerate:
+
+```bash
+pnpm --filter=@helixui/react run generate
+```
+
+This runs `scripts/generate-react-wrappers.ts` which reads the CEM and writes all wrapper files to `src/components/`.
+
+## Available Components
+
+All 98 HELiX components are available:
+
+`HxAccordion`, `HxAccordionItem`, `HxActionBar`, `HxAlert`, `HxAvatar`, `HxBadge`, `HxBanner`, `HxBreadcrumb`, `HxBreadcrumbItem`, `HxButton`, `HxButtonGroup`, `HxCard`, `HxCarousel`, `HxCarouselItem`, `HxCheckbox`, `HxCheckboxGroup`, `HxCodeSnippet`, `HxColorPicker`, `HxCombobox`, `HxContainer`, `HxCopyButton`, `HxCounter`, `HxDataTable`, `HxDatePicker`, `HxDialog`, `HxDivider`, `HxDrawer`, `HxDropdown`, `HxFileUpload`, `HxForm`, `HxIcon`, `HxInput`, `HxLabel`, `HxMenu`, `HxMenuItem`, `HxMenuLabel`, `HxNavItem`, `HxNavSection`, `HxNumberInput`, `HxOverflowMenu`, `HxPagination`, `HxPopover`, `HxProgressBar`, `HxProgressRing`, `HxQrCode`, `HxRadio`, `HxRadioButton`, `HxRadioGroup`, `HxRange`, `HxRating`, `HxRelativeTime`, `HxResizeObserver`, `HxSelect`, `HxSideNav`, `HxSkeletonEffect`, `HxSkeletonText`, `HxSlider`, `HxSpinner`, `HxSplitButton`, `HxSplitPanel`, `HxSteps`, `HxStructuredList`, `HxStructuredListBody`, `HxStructuredListHead`, `HxStructuredListRow`, `HxSwitch`, `HxTab`, `HxTabGroup`, `HxTabPanel`, `HxTabs`, `HxTag`, `HxTd`, `HxTextarea`, `HxTextInput`, `HxTh`, `HxTimePicker`, `HxToast`, `HxToastStack`, `HxToggleButton`, `HxTooltip`, `HxTopNav`, `HxTr`, `HxTreeItem`, `HxTreeView`, `HxVisuallyHidden`

package/dist/components/HxAccordion/HxAccordion.d.ts

@@ -0,0 +1,16 @@
+import { HelixAccordion } from '@helixui/library/components/hx-accordion';
+import { HxAccordionProps } from './types.js';
+export type { HxAccordionProps };
+/**
+ * An accordion container that manages collapsible content sections.
+ *
+ * @example
+ * ```tsx
+ * import { HxAccordion } from '@helixui/react';
+ *
+ * <HxAccordion />
+ * ```
+ */
+export declare const HxAccordion: import('@lit/react').ReactWebComponent<HelixAccordion, {}>;
+export default HxAccordion;
+//# sourceMappingURL=HxAccordion.d.ts.map

package/dist/components/HxAccordion/HxAccordion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HxAccordion.d.ts","sourceRoot":"","sources":["../../../src/components/HxAccordion/HxAccordion.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,cAAc,EAAE,MAAM,0CAA0C,CAAC;AAE1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,YAAY,EAAE,gBAAgB,EAAE,CAAC;AAEjC;;;;;;;;;GASG;AACH,eAAO,MAAM,WAAW,4DAMtB,CAAC;AAEH,eAAe,WAAW,CAAC"}

package/dist/components/HxAccordion/index.d.ts

@@ -0,0 +1,3 @@
+export { HxAccordion, default } from './HxAccordion.js';
+export type { HxAccordionProps } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/HxAccordion/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/HxAccordion/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACxD,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/components/HxAccordion/index.js

@@ -0,0 +1,6 @@
+import { H, H as H2 } from "../../shared/HxAccordion-BB3lypgd.js";
+export {
+  H as HxAccordion,
+  H2 as default
+};
+//# sourceMappingURL=index.js.map

package/dist/components/HxAccordion/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/components/HxAccordion/types.d.ts

@@ -0,0 +1,13 @@
+import { default as React } from 'react';
+export interface HxAccordionProps {
+    /** Slot content (children) */
+    children?: React.ReactNode;
+    /** CSS class name */
+    className?: string;
+    /** Inline styles */
+    style?: React.CSSProperties;
+    /** Expansion mode: 'single' collapses all other items when one expands.
+  'multi' allows multiple items open simultaneously. */
+    mode?: 'single' | 'multi';
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/components/HxAccordion/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/HxAccordion/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,WAAW,gBAAgB;IAC/B,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oBAAoB;IACpB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B;uDACmD;IACnD,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;CAC3B"}

package/dist/components/HxAccordionItem/HxAccordionItem.d.ts

@@ -0,0 +1,19 @@
+import { HelixAccordionItem } from '@helixui/library/components/hx-accordion';
+import { HxAccordionItemProps } from './types.js';
+export type { HxAccordionItemProps };
+/**
+ * An individual accordion item with collapsible content.
+ *
+ * @example
+ * ```tsx
+ * import { HxAccordionItem } from '@helixui/react';
+ *
+ * <HxAccordionItem />
+ * ```
+ */
+export declare const HxAccordionItem: import('@lit/react').ReactWebComponent<HelixAccordionItem, {
+    onHxExpand: string;
+    onHxCollapse: string;
+}>;
+export default HxAccordionItem;
+//# sourceMappingURL=HxAccordionItem.d.ts.map

package/dist/components/HxAccordionItem/HxAccordionItem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HxAccordionItem.d.ts","sourceRoot":"","sources":["../../../src/components/HxAccordionItem/HxAccordionItem.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0CAA0C,CAAC;AAE9E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,YAAY,EAAE,oBAAoB,EAAE,CAAC;AAErC;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe;;;EAS1B,CAAC;AAEH,eAAe,eAAe,CAAC"}

package/dist/components/HxAccordionItem/index.d.ts

@@ -0,0 +1,3 @@
+export { HxAccordionItem, default } from './HxAccordionItem.js';
+export type { HxAccordionItemProps } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/HxAccordionItem/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/HxAccordionItem/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAChE,YAAY,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC"}

package/dist/components/HxAccordionItem/index.js

@@ -0,0 +1,6 @@
+import { H, H as H2 } from "../../shared/HxAccordionItem-C26EIvJG.js";
+export {
+  H as HxAccordionItem,
+  H2 as default
+};
+//# sourceMappingURL=index.js.map

package/dist/components/HxAccordionItem/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/components/HxAccordionItem/types.d.ts

@@ -0,0 +1,22 @@
+import { default as React } from 'react';
+export interface HxAccordionItemProps {
+    /** Slot content (children) */
+    children?: React.ReactNode;
+    /** CSS class name */
+    className?: string;
+    /** Inline styles */
+    style?: React.CSSProperties;
+    /** Whether this item is expanded. */
+    expanded?: boolean;
+    /** Whether this item is disabled (cannot be toggled). */
+    disabled?: boolean;
+    /** Heading level (1–6) applied via `role="heading" aria-level` on the summary
+  trigger. Defaults to 3. Set to match the document outline around the
+  accordion so screen readers surface accordion items in the heading list. */
+    level?: string | string | string | string | string | string;
+    /** Dispatched when the item is expanded. */
+    onHxExpand?: (event: Event) => void;
+    /** Dispatched when the item is collapsed. */
+    onHxCollapse?: (event: Event) => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/components/HxAccordionItem/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/HxAccordionItem/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,WAAW,oBAAoB;IACnC,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oBAAoB;IACpB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,qCAAqC;IACrC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;6EAEyE;IACzE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAG5D,4CAA4C;IAC5C,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACpC,6CAA6C;IAC7C,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACvC"}

package/dist/components/HxActionBar/HxActionBar.d.ts

@@ -0,0 +1,17 @@
+import { HelixActionBar } from '@helixui/library/components/hx-action-bar';
+import { HxActionBarProps } from './types.js';
+export type { HxActionBarProps };
+/**
+ * A horizontal toolbar container for grouping related action buttons and controls.
+Implements the ARIA toolbar pattern with roving tabindex keyboard navigation.
+ *
+ * @example
+ * ```tsx
+ * import { HxActionBar } from '@helixui/react';
+ *
+ * <HxActionBar />
+ * ```
+ */
+export declare const HxActionBar: import('@lit/react').ReactWebComponent<HelixActionBar, {}>;
+export default HxActionBar;
+//# sourceMappingURL=HxActionBar.d.ts.map

package/dist/components/HxActionBar/HxActionBar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HxActionBar.d.ts","sourceRoot":"","sources":["../../../src/components/HxActionBar/HxActionBar.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAC;AAE3E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,YAAY,EAAE,gBAAgB,EAAE,CAAC;AAEjC;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW,4DAMtB,CAAC;AAEH,eAAe,WAAW,CAAC"}

package/dist/components/HxActionBar/index.d.ts

@@ -0,0 +1,3 @@
+export { HxActionBar, default } from './HxActionBar.js';
+export type { HxActionBarProps } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/HxActionBar/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/HxActionBar/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACxD,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/components/HxActionBar/index.js

@@ -0,0 +1,6 @@
+import { H, H as H2 } from "../../shared/HxActionBar-Bn--omCL.js";
+export {
+  H as HxActionBar,
+  H2 as default
+};
+//# sourceMappingURL=index.js.map

package/dist/components/HxActionBar/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/components/HxActionBar/types.d.ts

@@ -0,0 +1,24 @@
+import { default as React } from 'react';
+export interface HxActionBarProps {
+    /** Slot content (children) */
+    children?: React.ReactNode;
+    /** CSS class name */
+    className?: string;
+    /** Inline styles */
+    style?: React.CSSProperties;
+    /** Size of the action bar — propagated as a data attribute to slotted children. */
+    size?: 'sm' | 'md' | 'lg';
+    /** Visual variant controlling the bar background. */
+    variant?: 'default' | 'outlined' | 'filled';
+    /** Position and sticky behavior of the action bar.
+  - `top` — normal flow (default)
+  - `sticky` — sticks to the top of the scroll container; add `scroll-padding-top` to the
+    scroll container equal to the bar height to prevent anchor targets from scrolling behind it
+  - `bottom` — sticks to the bottom of the scroll container with iOS safe-area-inset support */
+    position?: 'top' | 'bottom' | 'sticky';
+    sticky?: boolean;
+    /** Accessible label for the toolbar.
+  Required when multiple toolbars appear on the same page. */
+    ariaLabel?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/components/HxActionBar/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/HxActionBar/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,WAAW,gBAAgB;IAC/B,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oBAAoB;IACpB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,mFAAmF;IACnF,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC1B,qDAAqD;IACrD,OAAO,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;IAC5C;;;;+FAI2F;IAC3F,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACvC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;6DACyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/components/HxAlert/HxAlert.d.ts

@@ -0,0 +1,20 @@
+import { HelixAlert } from '@helixui/library/components/hx-alert';
+import { HxAlertProps } from './types.js';
+export type { HxAlertProps };
+/**
+ * A feedback component for communicating status messages, warnings, and errors.
+Critical for healthcare patient safety alerts.
+ *
+ * @example
+ * ```tsx
+ * import { HxAlert } from '@helixui/react';
+ *
+ * <HxAlert />
+ * ```
+ */
+export declare const HxAlert: import('@lit/react').ReactWebComponent<HelixAlert, {
+    onHxClose: string;
+    onHxAfterClose: string;
+}>;
+export default HxAlert;
+//# sourceMappingURL=HxAlert.d.ts.map

package/dist/components/HxAlert/HxAlert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HxAlert.d.ts","sourceRoot":"","sources":["../../../src/components/HxAlert/HxAlert.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,UAAU,EAAE,MAAM,sCAAsC,CAAC;AAElE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,YAAY,EAAE,YAAY,EAAE,CAAC;AAE7B;;;;;;;;;;GAUG;AACH,eAAO,MAAM,OAAO;;;EASlB,CAAC;AAEH,eAAe,OAAO,CAAC"}

package/dist/components/HxAlert/index.d.ts

@@ -0,0 +1,3 @@
+export { HxAlert, default } from './HxAlert.js';
+export type { HxAlertProps } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/HxAlert/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/HxAlert/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAChD,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/components/HxAlert/index.js

@@ -0,0 +1,6 @@
+import { H, H as H2 } from "../../shared/HxAlert-BBdgyvjV.js";
+export {
+  H as HxAlert,
+  H2 as default
+};
+//# sourceMappingURL=index.js.map

package/dist/components/HxAlert/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/components/HxAlert/types.d.ts

@@ -0,0 +1,38 @@
+import { default as React } from 'react';
+export interface HxAlertProps {
+    /** Slot content (children) */
+    children?: React.ReactNode;
+    /** CSS class name */
+    className?: string;
+    /** Inline styles */
+    style?: React.CSSProperties;
+    /** Visual variant of the alert that determines colors and ARIA semantics. */
+    variant?: 'info' | 'success' | 'warning' | 'error';
+    /** Whether the alert can be dismissed by the user. */
+    dismissible?: boolean;
+    /** Optional heading text that provides context for the close button's accessible label.
+  When provided, the close button is announced as "Close [heading] alert".
+  When absent, the close button falls back to "Close alert". */
+    heading?: string;
+    /** Accessible label for the close button. Override for i18n. */
+    labelClose?: string;
+    /** Whether the alert is visible. Add the `open` attribute to show the alert. */
+    open?: boolean;
+    /** Whether to show the default variant icon. Add `show-icon` attribute to display the icon. */
+    showIcon?: boolean;
+    /** When true, applies a left border accent stripe instead of a full border.
+  Common healthcare/enterprise dashboard pattern for visual distinction of alert types. */
+    accent?: boolean;
+    /** Override for the severity prefix announced to screen readers (e.g., "Info:", "Error:").
+  When not set, defaults to the English label matching the current variant. */
+    severityLabel?: string | undefined;
+    /** CSS selector for the element to return focus to after the alert is dismissed.
+  When set, the component will find and focus the matching element after dismissal.
+  If not set, focus management is the caller's responsibility via the hx-after-close event. */
+    returnFocusTo?: string | null;
+    /** Dispatched when the user dismisses the alert. */
+    onHxClose?: (event: Event) => void;
+    /** Dispatched after the alert is dismissed. */
+    onHxAfterClose?: (event: Event) => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/components/HxAlert/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/HxAlert/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,WAAW,YAAY;IAC3B,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oBAAoB;IACpB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;IACnD,sDAAsD;IACtD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;+DAE2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gFAAgF;IAChF,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,+FAA+F;IAC/F,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;0FACsF;IACtF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;8EAC0E;IAC1E,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC;;8FAE0F;IAC1F,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAG9B,oDAAoD;IACpD,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACnC,+CAA+C;IAC/C,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACzC"}

package/dist/components/HxAvatar/HxAvatar.d.ts

@@ -0,0 +1,17 @@
+import { HelixAvatar } from '@helixui/library/components/hx-avatar';
+import { HxAvatarProps } from './types.js';
+export type { HxAvatarProps };
+/**
+ * A user avatar component that displays an image, initials, or a fallback icon.
+Supports a badge slot for status indicator overlays.
+ *
+ * @example
+ * ```tsx
+ * import { HxAvatar } from '@helixui/react';
+ *
+ * <HxAvatar />
+ * ```
+ */
+export declare const HxAvatar: import('@lit/react').ReactWebComponent<HelixAvatar, {}>;
+export default HxAvatar;
+//# sourceMappingURL=HxAvatar.d.ts.map

package/dist/components/HxAvatar/HxAvatar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HxAvatar.d.ts","sourceRoot":"","sources":["../../../src/components/HxAvatar/HxAvatar.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AAEpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,YAAY,EAAE,aAAa,EAAE,CAAC;AAE9B;;;;;;;;;;GAUG;AACH,eAAO,MAAM,QAAQ,yDAMnB,CAAC;AAEH,eAAe,QAAQ,CAAC"}

package/dist/components/HxAvatar/index.d.ts

@@ -0,0 +1,3 @@
+export { HxAvatar, default } from './HxAvatar.js';
+export type { HxAvatarProps } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/HxAvatar/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/HxAvatar/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAClD,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/components/HxAvatar/index.js

@@ -0,0 +1,6 @@
+import { H, H as H2 } from "../../shared/HxAvatar-BS-4kdPG.js";
+export {
+  H as HxAvatar,
+  H2 as default
+};
+//# sourceMappingURL=index.js.map

package/dist/components/HxAvatar/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/components/HxAvatar/types.d.ts

@@ -0,0 +1,26 @@
+import { default as React } from 'react';
+export interface HxAvatarProps {
+    /** Slot content (children) */
+    children?: React.ReactNode;
+    /** CSS class name */
+    className?: string;
+    /** Inline styles */
+    style?: React.CSSProperties;
+    /** Image URL. When provided and successfully loaded, displays the image. */
+    src?: string | undefined;
+    /** Accessible label for the image. Required when `src` is provided.
+  Used as the container's aria-label in image mode. */
+    alt?: string;
+    /** Human-readable accessible name for non-image states (initials, fallback icon).
+  In healthcare contexts, provide the full person name (e.g., "Dr. Jane Doe") rather than
+  relying on raw initials, which screen readers announce as individual letters.
+  When set, takes precedence over raw initials and the generic "Avatar" fallback. */
+    label?: string;
+    /** Fallback initials text displayed when no image is available. */
+    initials?: string;
+    /** Size variant of the avatar. */
+    size?: 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+    /** Shape variant of the avatar. */
+    shape?: 'circle' | 'square';
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/components/HxAvatar/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/HxAvatar/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,WAAW,aAAa;IAC5B,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oBAAoB;IACpB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,4EAA4E;IAC5E,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB;sDACkD;IAClD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;oFAGgF;IAChF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IACxC,mCAAmC;IACnC,KAAK,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;CAC7B"}

package/dist/components/HxBadge/HxBadge.d.ts

@@ -0,0 +1,18 @@
+import { HelixBadge } from '@helixui/library/components/hx-badge';
+import { HxBadgeProps } from './types.js';
+export type { HxBadgeProps };
+/**
+ * A small status indicator for notifications, counts, and labels.
+ *
+ * @example
+ * ```tsx
+ * import { HxBadge } from '@helixui/react';
+ *
+ * <HxBadge />
+ * ```
+ */
+export declare const HxBadge: import('@lit/react').ReactWebComponent<HelixBadge, {
+    onHxRemove: string;
+}>;
+export default HxBadge;
+//# sourceMappingURL=HxBadge.d.ts.map

package/dist/components/HxBadge/HxBadge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HxBadge.d.ts","sourceRoot":"","sources":["../../../src/components/HxBadge/HxBadge.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,UAAU,EAAE,MAAM,sCAAsC,CAAC;AAElE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,YAAY,EAAE,YAAY,EAAE,CAAC;AAE7B;;;;;;;;;GASG;AACH,eAAO,MAAM,OAAO;;EAQlB,CAAC;AAEH,eAAe,OAAO,CAAC"}

package/dist/components/HxBadge/index.d.ts

@@ -0,0 +1,3 @@
+export { HxBadge, default } from './HxBadge.js';
+export type { HxBadgeProps } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/HxBadge/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/HxBadge/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAChD,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/components/HxBadge/index.js

@@ -0,0 +1,6 @@
+import { H, H as H2 } from "../../shared/HxBadge-Ck9MRyi2.js";
+export {
+  H as HxBadge,
+  H2 as default
+};
+//# sourceMappingURL=index.js.map

package/dist/components/HxBadge/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/components/HxBadge/types.d.ts

@@ -0,0 +1,34 @@
+import { default as React } from 'react';
+export interface HxBadgeProps {
+    /** Slot content (children) */
+    children?: React.ReactNode;
+    /** CSS class name */
+    className?: string;
+    /** Inline styles */
+    style?: React.CSSProperties;
+    /** Visual style variant of the badge. */
+    variant?: 'primary' | 'secondary' | 'success' | 'warning' | 'error' | 'neutral' | 'info';
+    /** Size of the badge. */
+    size?: 'sm' | 'md' | 'lg';
+    /** Whether the badge uses fully rounded (pill) styling. */
+    pill?: boolean;
+    /** Whether the badge displays an animated pulse for attention. */
+    pulse?: boolean;
+    /** Whether the badge renders a dismiss button. */
+    removable?: boolean;
+    /** Numeric count to display. When set, renders the count as badge content.
+  When count exceeds `max`, displays `${max}+` (e.g. `99+`). */
+    count?: number | undefined;
+    /** Maximum count value before truncation to `${max}+`. Defaults to 99. */
+    max?: number;
+    /** Accessible label for the dot indicator mode (pulse + empty slot).
+  Required for WCAG 4.1.2 compliance when using the dot indicator pattern.
+  Example: `dot-label="3 new messages"`. */
+    dotLabel?: string;
+    /** Accessible label for the remove button. Should describe what is being removed.
+  Defaults to "Remove". For better accessibility, include context: e.g. "Remove Critical badge". */
+    removeLabel?: string;
+    /** Dispatched when the user clicks the remove button. */
+    onHxRemove?: (event: Event) => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/components/HxBadge/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/HxBadge/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,WAAW,YAAY;IAC3B,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oBAAoB;IACpB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,yCAAyC;IACzC,OAAO,CAAC,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACzF,yBAAyB;IACzB,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC1B,2DAA2D;IAC3D,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,kEAAkE;IAClE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,kDAAkD;IAClD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;+DAC2D;IAC3D,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,0EAA0E;IAC1E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;2CAEuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;mGAC+F;IAC/F,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,yDAAyD;IACzD,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACrC"}

package/dist/components/HxBanner/HxBanner.d.ts

@@ -0,0 +1,19 @@
+import { HelixBanner } from '@helixui/library/components/hx-banner';
+import { HxBannerProps } from './types.js';
+export type { HxBannerProps };
+/**
+ * A full-width page-level banner for persistent notifications and announcements.
+Designed for healthcare applications requiring prominent system-level messaging.
+ *
+ * @example
+ * ```tsx
+ * import { HxBanner } from '@helixui/react';
+ *
+ * <HxBanner />
+ * ```
+ */
+export declare const HxBanner: import('@lit/react').ReactWebComponent<HelixBanner, {
+    onHxDismiss: string;
+}>;
+export default HxBanner;
+//# sourceMappingURL=HxBanner.d.ts.map

package/dist/components/HxBanner/HxBanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HxBanner.d.ts","sourceRoot":"","sources":["../../../src/components/HxBanner/HxBanner.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AAEpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,YAAY,EAAE,aAAa,EAAE,CAAC;AAE9B;;;;;;;;;;GAUG;AACH,eAAO,MAAM,QAAQ;;EAQnB,CAAC;AAEH,eAAe,QAAQ,CAAC"}

package/dist/components/HxBanner/index.d.ts

@@ -0,0 +1,3 @@
+export { HxBanner, default } from './HxBanner.js';
+export type { HxBannerProps } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/HxBanner/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/HxBanner/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAClD,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/components/HxBanner/index.js

@@ -0,0 +1,6 @@
+import { H, H as H2 } from "../../shared/HxBanner-C8xMXTg5.js";
+export {
+  H as HxBanner,
+  H2 as default
+};
+//# sourceMappingURL=index.js.map

package/dist/components/HxBanner/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}