suaveplan/packages/ui/react/react-ui/README.md

# @suaveplan/react-ui - React UI component library — opinionated providers, theme/pack plugin contracts, bundled translations, telemetry, shadcn-compatible registry generator.

## Summary

> Chassis for the Suaveplan React UI component library — opinionated
> providers, theme/pack plugin contracts, bundled translations,
> telemetry, and a shadcn-compatible registry generator.

This package ships the **chassis** for `@suaveplan/react-ui`. The 57+
components land per-batch under Wave 3 (a-h) of spec change
[`enterprise-react-ui-v2`](../../../docs/design/enterprise-react-ui-v2);
this README covers what Wave 2 ships.

<!-- begin:auto-docs -->
## Documentation tree

- [accordion](./src/components/accordion/accordion.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - accordion.variants — `accordionVariants`, `accordio…
  - [accordion](./src/components/accordion/accordion.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - accordion.variants — `accordionVariants`, `accordio…
  - [accordion.variants](./src/components/accordion/accordion.variants.md) — `accordionVariants`, `accordionItemVariants`, `accordionHeaderVariants`, `accordionTriggerVariants`, and `accordionCont…
- [alert](./src/components/alert/alert.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - alert.variants — `alertVariants` is the cva config……
  - [alert](./src/components/alert/alert.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - alert.variants — `alertVariants` is the cva config……
  - [alert.variants](./src/components/alert/alert.variants.md) — `alertVariants` is the cva config that powers the `<Alert>` chassis component. It exposes a `variant` axis with four ru…
- [alert-dialog](./src/components/alert-dialog/alert-dialog.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - alert-dialog.variants — `alertDialogOverlayVariants…
  - [alert-dialog](./src/components/alert-dialog/alert-dialog.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - alert-dialog.variants — `alertDialogOverlayVariants…
  - [alert-dialog.variants](./src/components/alert-dialog/alert-dialog.variants.md) — `alertDialogOverlayVariants`, `alertDialogContentVariants`, `alertDialogHeaderVariants`, `alertDialogFooterVariants`, `…
- [aspect-ratio](./src/components/aspect-ratio/aspect-ratio.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - aspect-ratio.variants — `aspectRatioVariants` is th…
  - [aspect-ratio](./src/components/aspect-ratio/aspect-ratio.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - aspect-ratio.variants — `aspectRatioVariants` is th…
  - [aspect-ratio.variants](./src/components/aspect-ratio/aspect-ratio.variants.md) — `aspectRatioVariants` is the cva (class-variance-authority) configuration powering the `<AspectRatio>` outer wrapper. I…
- [avatar](./src/components/avatar/avatar.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - avatar.variants — `avatarVariants` is the cva confi…
  - [avatar](./src/components/avatar/avatar.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - avatar.variants — `avatarVariants` is the cva confi…
  - [avatar.variants](./src/components/avatar/avatar.variants.md) — `avatarVariants` is the cva config that powers the `<Avatar>` chassis component (`<AvatarImage>` and `<AvatarFallback>`…
- [badge](./src/components/badge/badge.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - badge.variants — `badgeVariants` is the cva config……
  - [badge](./src/components/badge/badge.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - badge.variants — `badgeVariants` is the cva config……
  - [badge.variants](./src/components/badge/badge.variants.md) — `badgeVariants` is the cva config that powers the `<Badge>` chassis component. It exposes a `variant` axis with four ru…
- [breadcrumb](./src/components/breadcrumb/breadcrumb.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - breadcrumb.variants — `breadcrumbVariants`, `breadc…
  - [breadcrumb](./src/components/breadcrumb/breadcrumb.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - breadcrumb.variants — `breadcrumbVariants`, `breadc…
  - [breadcrumb.variants](./src/components/breadcrumb/breadcrumb.variants.md) — `breadcrumbVariants`, `breadcrumbListVariants`, `breadcrumbItemVariants`, `breadcrumbLinkVariants`, `breadcrumbPageVari…
- [button](./src/components/button/button.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - button.variants — `buttonVariants` is the cva (clas…
  - [button](./src/components/button/button.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - button.variants — `buttonVariants` is the cva (clas…
  - [button.variants](./src/components/button/button.variants.md) — `buttonVariants` is the cva (class-variance-authority) configuration that powers every `<Button>` render. It is split f…
- [calendar](./src/components/calendar/calendar.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - calendar.test-fixtures — Wave-3h local test fixture…
  - [calendar](./src/components/calendar/calendar.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - calendar.test-fixtures — Wave-3h local test fixture…
  - [calendar.test-fixtures](./src/components/calendar/calendar.test-fixtures.md) — Wave-3h local test fixture that augments the chassis test i18n instance with the `react-ui.calendar.*` keyset. The chas…
  - [calendar.variants](./src/components/calendar/calendar.variants.md) — `calendarVariants` is the cva config that powers the outer wrapper of `<Calendar>`. The recipe is intentionally minimal…
- [card](./src/components/card/card.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - card.variants — `cardVariants` (and its sub-compone…
  - [card](./src/components/card/card.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - card.variants — `cardVariants` (and its sub-compone…
  - [card.variants](./src/components/card/card.variants.md) — `cardVariants` (and its sub-component cva resolvers `cardHeaderVariants`, `cardTitleVariants`, `cardDescriptionVariants…
- [checkbox](./src/components/checkbox/checkbox.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - checkbox.variants — `checkboxVariants` is the cva (…
  - [checkbox](./src/components/checkbox/checkbox.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - checkbox.variants — `checkboxVariants` is the cva (…
  - [checkbox.variants](./src/components/checkbox/checkbox.variants.md) — `checkboxVariants` is the cva (class-variance-authority) configuration that powers every `<Checkbox>` render. It is spl…
- [collapsible](./src/components/collapsible/collapsible.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - collapsible.variants — `collapsibleVariants`, `coll…
  - [collapsible](./src/components/collapsible/collapsible.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - collapsible.variants — `collapsibleVariants`, `coll…
  - [collapsible.variants](./src/components/collapsible/collapsible.variants.md) — `collapsibleVariants`, `collapsibleTriggerVariants`, and `collapsibleContentVariants` are the cva (class-variance-autho…
- [confirm-delete-dialog](./src/components/confirm-delete-dialog/confirm-delete-dialog.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - confirm-delete-dialog.test-fixtures — Wave-3g local…
  - [confirm-delete-dialog](./src/components/confirm-delete-dialog/confirm-delete-dialog.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - confirm-delete-dialog.test-fixtures — Wave-3g local…
  - [confirm-delete-dialog.test-fixtures](./src/components/confirm-delete-dialog/confirm-delete-dialog.test-fixtures.md) — Wave-3g local test fixture that augments the chassis test i18n instance with the `react-ui.confirmDelete.*` keyset. The…
- [context-menu](./src/components/context-menu/context-menu.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - context-menu.variants — `contextMenuContentVariants…
  - [context-menu](./src/components/context-menu/context-menu.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - context-menu.variants — `contextMenuContentVariants…
  - [context-menu.variants](./src/components/context-menu/context-menu.variants.md) — `contextMenuContentVariants`, `contextMenuItemVariants`, `contextMenuLabelVariants`, `contextMenuSeparatorVariants`, `c…
- [data-table](./src/components/data-table/data-table.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - data-table.variants — `dataTableVariants`, `dataTab…
  - [data-table](./src/components/data-table/data-table.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - data-table.variants — `dataTableVariants`, `dataTab…
  - [data-table.variants](./src/components/data-table/data-table.variants.md) — `dataTableVariants`, `dataTablePaginationVariants`, and `dataTableSortHeaderVariants` drive the chassis `<DataTable>` o…
- [dialog](./src/components/dialog/dialog.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - dialog.variants — `dialogOverlayVariants`, `dialogC…
  - [dialog](./src/components/dialog/dialog.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - dialog.variants — `dialogOverlayVariants`, `dialogC…
  - [dialog.variants](./src/components/dialog/dialog.variants.md) — `dialogOverlayVariants`, `dialogContentVariants`, `dialogHeaderVariants`, `dialogFooterVariants`, `dialogTitleVariants`…
- [drawer](./src/components/drawer/drawer.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - drawer.variants — `drawerOverlayVariants`, `drawerC…
  - [drawer](./src/components/drawer/drawer.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - drawer.variants — `drawerOverlayVariants`, `drawerC…
  - [drawer.variants](./src/components/drawer/drawer.variants.md) — `drawerOverlayVariants`, `drawerContentVariants`, `drawerHandleVariants`, `drawerHeaderVariants`, `drawerFooterVariants…
- [dropdown-menu](./src/components/dropdown-menu/dropdown-menu.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - dropdown-menu.variants — `dropdownMenuContentVarian…
  - [dropdown-menu](./src/components/dropdown-menu/dropdown-menu.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - dropdown-menu.variants — `dropdownMenuContentVarian…
  - [dropdown-menu.variants](./src/components/dropdown-menu/dropdown-menu.variants.md) — `dropdownMenuContentVariants`, `dropdownMenuItemVariants`, `dropdownMenuLabelVariants`, `dropdownMenuSeparatorVariants`…
- [empty](./src/components/empty/empty.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - empty.variants — `emptyVariants` is the cva config……
  - [empty](./src/components/empty/empty.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - empty.variants — `emptyVariants` is the cva config……
  - [empty.variants](./src/components/empty/empty.variants.md) — `emptyVariants` is the cva config that powers the `<Empty>` chassis component (with `emptyHeaderVariants`, `emptyMediaV…
- [error-boundary](./src/components/error-boundary/error-boundary.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - error-boundary.metrics — Co-located OTel counter fo…
  - [error-boundary](./src/components/error-boundary/error-boundary.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - error-boundary.metrics — Co-located OTel counter fo…
  - [error-boundary.metrics](./src/components/error-boundary/error-boundary.metrics.md) — Co-located OTel counter for the chassis `<ErrorBoundary>` component. Lives next to the boundary itself rather than in t…
  - [error-boundary.test-fixtures](./src/components/error-boundary/error-boundary.test-fixtures.md) — Wave-3g local test fixture that augments the chassis test i18n instance with the `react-ui.errorBoundary.*` keyset. The…
  - [error-boundary.variants](./src/components/error-boundary/error-boundary.variants.md) — Cva slot definitions for the chassis `<ErrorBoundary>` default fallback. Splits the fallback into four named slots — ou…
- [field](./src/components/field/field.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - field.variants — `fieldVariants`, `fieldLabelVarian…
  - [field](./src/components/field/field.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - field.variants — `fieldVariants`, `fieldLabelVarian…
  - [field.variants](./src/components/field/field.variants.md) — `fieldVariants`, `fieldLabelVariants`, `fieldDescriptionVariants`, and `fieldErrorVariants` are the four cva (class-var…
- [field-group](./src/components/field-group/field-group.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - field-group.variants — `fieldGroupVariants` is the……
  - [field-group](./src/components/field-group/field-group.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - field-group.variants — `fieldGroupVariants` is the……
  - [field-group.variants](./src/components/field-group/field-group.variants.md) — `fieldGroupVariants` is the cva (class-variance-authority) configuration powering every `<FieldGroup>` render. It is sp…
- [field-set](./src/components/field-set/field-set.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - field-set.variants — `fieldSetVariants` and `fieldL…
  - [field-set](./src/components/field-set/field-set.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - field-set.variants — `fieldSetVariants` and `fieldL…
  - [field-set.variants](./src/components/field-set/field-set.variants.md) — `fieldSetVariants` and `fieldLegendVariants` are the cva (class-variance-authority) configurations powering `<FieldSet>…
- [hover-card](./src/components/hover-card/hover-card.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - hover-card.variants — `hoverCardContentVariants` is…
  - [hover-card](./src/components/hover-card/hover-card.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - hover-card.variants — `hoverCardContentVariants` is…
  - [hover-card.variants](./src/components/hover-card/hover-card.variants.md) — `hoverCardContentVariants` is the cva configuration powering the `<HoverCardContent>` floating panel. It is split from…
- [input](./src/components/input/input.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->- input-number — <!-- begin:auto-docs --> _(no submodu…
  - [input-number](./src/components/input/input-number/input-number.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
    - [input-number](./src/components/input/input-number/input-number.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
  - [input](./src/components/input/input.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->- input-number — <!-- begin:auto-docs --> _(no submodu…
  - [input.variants](./src/components/input/input.variants.md) — `inputVariants` is the cva (class-variance-authority) configuration that powers every `<Input>` render. It is split fro…
- [input-group](./src/components/input-group/input-group.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - input-group.variants — `inputGroupVariants`, `input…
  - [input-group](./src/components/input-group/input-group.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - input-group.variants — `inputGroupVariants`, `input…
  - [input-group.variants](./src/components/input-group/input-group.variants.md) — `inputGroupVariants`, `inputGroupAddonVariants`, `inputGroupInputVariants`, `inputGroupTextareaVariants`, and `inputGro…
- [label](./src/components/label/label.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - label.variants — `labelVariants` is the cva (class-…
  - [label](./src/components/label/label.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - label.variants — `labelVariants` is the cva (class-…
  - [label.variants](./src/components/label/label.variants.md) — `labelVariants` is the cva (class-variance-authority) configuration that powers every `<Label>` render. It is split fro…
- [menubar](./src/components/menubar/menubar.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - menubar.variants — `menubarVariants`, `menubarTrigg…
  - [menubar](./src/components/menubar/menubar.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - menubar.variants — `menubarVariants`, `menubarTrigg…
  - [menubar.variants](./src/components/menubar/menubar.variants.md) — `menubarVariants`, `menubarTriggerVariants`, `menubarContentVariants`, `menubarItemVariants`, `menubarLabelVariants`, `…
- [pagination](./src/components/pagination/pagination.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - pagination.variants — `paginationVariants`, `pagina…
  - [pagination](./src/components/pagination/pagination.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - pagination.variants — `paginationVariants`, `pagina…
  - [pagination.variants](./src/components/pagination/pagination.variants.md) — `paginationVariants`, `paginationContentVariants`, `paginationItemVariants`, `paginationLinkVariants`, `paginationPrevN…
- [popover](./src/components/popover/popover.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - popover.variants — `popoverContentVariants` is the……
  - [popover](./src/components/popover/popover.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - popover.variants — `popoverContentVariants` is the……
  - [popover.variants](./src/components/popover/popover.variants.md) — `popoverContentVariants` is the cva configuration powering the `<PopoverContent>` floating panel. It is split from `pop…
- [progress](./src/components/progress/progress.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - progress.variants — `progressVariants` is the cva c…
  - [progress](./src/components/progress/progress.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - progress.variants — `progressVariants` is the cva c…
  - [progress.variants](./src/components/progress/progress.variants.md) — `progressVariants` is the cva config that powers the `<Progress>` chassis component (paired with `progressIndicatorVari…
- [radio-group](./src/components/radio-group/radio-group.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - radio-group.variants — `radioGroupVariants` and `ra…
  - [radio-group](./src/components/radio-group/radio-group.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - radio-group.variants — `radioGroupVariants` and `ra…
  - [radio-group.variants](./src/components/radio-group/radio-group.variants.md) — `radioGroupVariants` and `radioGroupItemVariants` are the cva (class-variance-authority) configurations powering `<Radi…
- [resizable](./src/components/resizable/resizable.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - resizable.variants — `resizablePanelGroupVariants`,…
  - [resizable](./src/components/resizable/resizable.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - resizable.variants — `resizablePanelGroupVariants`,…
  - [resizable.variants](./src/components/resizable/resizable.variants.md) — `resizablePanelGroupVariants`, `resizablePanelVariants`, `resizableHandleVariants`, and `resizableHandleGripVariants` a…
- [scroll-area](./src/components/scroll-area/scroll-area.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - scroll-area.variants — `scrollAreaVariants`, `scrol…
  - [scroll-area](./src/components/scroll-area/scroll-area.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - scroll-area.variants — `scrollAreaVariants`, `scrol…
  - [scroll-area.variants](./src/components/scroll-area/scroll-area.variants.md) — `scrollAreaVariants`, `scrollAreaViewportVariants`, `scrollAreaScrollbarVariants`, `scrollAreaThumbVariants`, and `scro…
- [select](./src/components/select/select.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - select.test-fixtures — Wave-3h local test fixture t…
  - [select](./src/components/select/select.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - select.test-fixtures — Wave-3h local test fixture t…
  - [select.test-fixtures](./src/components/select/select.test-fixtures.md) — Wave-3h local test fixture that augments the chassis test i18n instance with the `react-ui.select.placeholder` key. The…
  - [select.variants](./src/components/select/select.variants.md) — The `<Select>` component is composed of six visual slots — trigger, content panel, item row, group label, separator, an…
- [separator](./src/components/separator/separator.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - separator.variants — `separatorVariants` is the cva…
  - [separator](./src/components/separator/separator.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - separator.variants — `separatorVariants` is the cva…
  - [separator.variants](./src/components/separator/separator.variants.md) — `separatorVariants` is the cva (class-variance-authority) configuration that powers every `<Separator>` render. It is s…
- [sheet](./src/components/sheet/sheet.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - sheet.variants — `sheetOverlayVariants`, `sheetCont…
  - [sheet](./src/components/sheet/sheet.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - sheet.variants — `sheetOverlayVariants`, `sheetCont…
  - [sheet.variants](./src/components/sheet/sheet.variants.md) — `sheetOverlayVariants`, `sheetContentVariants`, `sheetHeaderVariants`, `sheetFooterVariants`, `sheetTitleVariants`, `sh…
- [skeleton](./src/components/skeleton/skeleton.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - skeleton.variants — `skeletonVariants` is the cva (…
  - [skeleton](./src/components/skeleton/skeleton.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - skeleton.variants — `skeletonVariants` is the cva (…
  - [skeleton.variants](./src/components/skeleton/skeleton.variants.md) — `skeletonVariants` is the cva (class-variance-authority) configuration that powers every `<Skeleton>` render. It is spl…
- [sonner](./src/components/sonner/sonner.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - sonner.variants — Defines the `sonnerToasterVariant…
  - [sonner](./src/components/sonner/sonner.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - sonner.variants — Defines the `sonnerToasterVariant…
  - [sonner.variants](./src/components/sonner/sonner.variants.md) — Defines the `sonnerToasterVariants` cva slot for the chassis `<Sonner>` toaster host. Sonner manages its own stacking,…
- [spinner](./src/components/spinner/spinner.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - spinner.variants — `spinnerVariants` is the cva con…
  - [spinner](./src/components/spinner/spinner.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - spinner.variants — `spinnerVariants` is the cva con…
  - [spinner.variants](./src/components/spinner/spinner.variants.md) — `spinnerVariants` is the cva config that powers the `<Spinner>` chassis component. It exposes a `size` axis (`sm` / `de…
- [status-badge](./src/components/status-badge/status-badge.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - status-badge.variants — `statusBadgeVariants` is th…
  - [status-badge](./src/components/status-badge/status-badge.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - status-badge.variants — `statusBadgeVariants` is th…
  - [status-badge.variants](./src/components/status-badge/status-badge.variants.md) — `statusBadgeVariants` is the cva config that powers the `<StatusBadge>` chassis component. It exposes a `status` axis w…
- [switch](./src/components/switch/switch.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - switch.variants — `switchVariants` and `switchThumb…
  - [switch](./src/components/switch/switch.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - switch.variants — `switchVariants` and `switchThumb…
  - [switch.variants](./src/components/switch/switch.variants.md) — `switchVariants` and `switchThumbVariants` are the two cva (class-variance-authority) configurations that together powe…
- [table](./src/components/table/table.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - table.variants — `tableVariants` and its eight sub-…
  - [table](./src/components/table/table.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - table.variants — `tableVariants` and its eight sub-…
  - [table.variants](./src/components/table/table.variants.md) — `tableVariants` and its eight sub-component cva resolvers (`tableHeaderVariants`, `tableBodyVariants`, `tableFooterVari…
- [tabs](./src/components/tabs/tabs.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - tabs.variants — `tabsVariants`, `tabsListVariants`,…
  - [tabs](./src/components/tabs/tabs.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - tabs.variants — `tabsVariants`, `tabsListVariants`,…
  - [tabs.variants](./src/components/tabs/tabs.variants.md) — `tabsVariants`, `tabsListVariants`, `tabsTriggerVariants`, and `tabsContentVariants` are the cva (class-variance-author…
- [textarea](./src/components/textarea/textarea.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - textarea.variants — `textareaVariants` is the cva (…
  - [textarea](./src/components/textarea/textarea.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - textarea.variants — `textareaVariants` is the cva (…
  - [textarea.variants](./src/components/textarea/textarea.variants.md) — `textareaVariants` is the cva (class-variance-authority) configuration that powers every `<Textarea>` render. It is spl…
- [theme-toggle](./src/components/theme-toggle/theme-toggle.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - theme-toggle.variants — Cva slot for the chassis `<…
  - [theme-toggle](./src/components/theme-toggle/theme-toggle.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - theme-toggle.variants — Cva slot for the chassis `<…
  - [theme-toggle.variants](./src/components/theme-toggle/theme-toggle.variants.md) — Cva slot for the chassis `<ThemeToggle>` icon-button. Mirrors the shape of `<Button variant="outline" size="icon">` so…
- [toast](./src/components/toast/toast.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
  - [toast](./src/components/toast/toast.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
- [toggle](./src/components/toggle/toggle.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - toggle.variants — `toggleVariants` is the cva (clas…
  - [toggle](./src/components/toggle/toggle.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - toggle.variants — `toggleVariants` is the cva (clas…
  - [toggle.variants](./src/components/toggle/toggle.variants.md) — `toggleVariants` is the cva (class-variance-authority) configuration powering every `<Toggle>` render. It is split from…
- [toggle-group](./src/components/toggle-group/toggle-group.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - toggle-group.variants — `toggleGroupVariants` and `…
  - [toggle-group](./src/components/toggle-group/toggle-group.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - toggle-group.variants — `toggleGroupVariants` and `…
  - [toggle-group.variants](./src/components/toggle-group/toggle-group.variants.md) — `toggleGroupVariants` and `toggleGroupItemVariants` are the cva (class-variance-authority) configurations powering `<To…
- [tooltip](./src/components/tooltip/tooltip.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - tooltip.variants — `tooltipContentVariants` is the……
  - [tooltip](./src/components/tooltip/tooltip.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs --> - tooltip.variants — `tooltipContentVariants` is the……
  - [tooltip.variants](./src/components/tooltip/tooltip.variants.md) — `tooltipContentVariants` is the cva configuration powering the `<TooltipContent>` floating bubble. It is split from `to…
- [use-toast-sonner-bridge](./src/components/use-toast-sonner-bridge/use-toast-sonner-bridge.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
  - [use-toast-sonner-bridge](./src/components/use-toast-sonner-bridge/use-toast-sonner-bridge.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
- [error-codes](./src/errors/error-codes.md) — Defines every stable error code emitted by the `@suaveplan/react-ui` package. Codes are grouped under the `REACT_UI` na…
- [react-ui-error](./src/errors/react-ui-error.md) — Owns every error thrown by the `@suaveplan/react-ui` package. Extends the project-wide `SuaveplanError` so each instan…
- [use-mobile](./src/hooks/use-mobile/use-mobile.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
  - [use-mobile](./src/hooks/use-mobile/use-mobile.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
- [use-toast](./src/hooks/use-toast/use-toast.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
  - [use-toast](./src/hooks/use-toast/use-toast.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
- [formatted-cell](./src/i18n/formatted-cell/formatted-cell.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
  - [formatted-cell](./src/i18n/formatted-cell/formatted-cell.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
- [formatted-currency](./src/i18n/formatted-currency/formatted-currency.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
  - [formatted-currency](./src/i18n/formatted-currency/formatted-currency.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
- [formatted-date](./src/i18n/formatted-date/formatted-date.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
  - [formatted-date](./src/i18n/formatted-date/formatted-date.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
- [formatted-list](./src/i18n/formatted-list/formatted-list.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
  - [formatted-list](./src/i18n/formatted-list/formatted-list.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
- [formatted-message](./src/i18n/formatted-message/formatted-message.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
  - [formatted-message](./src/i18n/formatted-message/formatted-message.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
- [formatted-number](./src/i18n/formatted-number/formatted-number.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
  - [formatted-number](./src/i18n/formatted-number/formatted-number.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
- [formatted-relative-time](./src/i18n/formatted-relative-time/formatted-relative-time.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
  - [formatted-relative-time](./src/i18n/formatted-relative-time/formatted-relative-time.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
- [plural](./src/i18n/plural/plural.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
  - [plural](./src/i18n/plural/plural.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
- [react-ui-i18n-bridge](./src/i18n/react-ui-i18n-bridge/react-ui-i18n-bridge.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
  - [react-ui-i18n-bridge](./src/i18n/react-ui-i18n-bridge/react-ui-i18n-bridge.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
- [stories-shell](./src/i18n/stories-shell/stories-shell.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
  - [stories-shell](./src/i18n/stories-shell/stories-shell.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
- [tanstack-bridge](./src/i18n/tanstack-bridge/tanstack-bridge.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
  - [tanstack-bridge](./src/i18n/tanstack-bridge/tanstack-bridge.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
- [validation-message-bridge](./src/i18n/validation-message-bridge/validation-message-bridge.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
  - [validation-message-bridge](./src/i18n/validation-message-bridge/validation-message-bridge.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
- [augmentation](./src/locales/augmentation.md) — Side-effect-only TypeScript module that augments `@suaveplan/react-i18n`'s `ContributedTranslationKeys` interface with…
- [schema](./src/locales/schema.md) — Zod schema asserting that every locale bundle declares exactly the keys present in the canonical `en-GB.json` source-of…
- [translation-keys](./src/locales/translation-keys.md) — `translation-keys.ts` is the codegen-emitted string-literal union of every translation key contributed by `@suaveplan/r…
- [observability](./src/observability/react-ui-metrics.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
  - [react-ui-metrics](./src/observability/react-ui-metrics.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
- [pack](./src/pack/pack-context.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->- pack-registry-provider — <!-- begin:auto-docs --> _(…
  - [pack-registry-provider](./src/pack/pack-registry-provider/pack-registry-provider.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
    - [pack-registry-provider](./src/pack/pack-registry-provider/pack-registry-provider.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
  - [runtime-override](./src/pack/runtime-override/runtime-override.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
    - [runtime-override](./src/pack/runtime-override/runtime-override.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
  - [use-pack-component](./src/pack/use-pack-component/use-pack-component.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
    - [use-pack-component](./src/pack/use-pack-component/use-pack-component.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
  - [version-check](./src/pack/version-check/version-check.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
    - [version-check](./src/pack/version-check/version-check.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
  - [pack-context](./src/pack/pack-context.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->- pack-registry-provider — <!-- begin:auto-docs --> _(…
- [react-ui-provider](./src/provider/react-ui-provider/react-ui-provider.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
  - [react-ui-provider](./src/provider/react-ui-provider/react-ui-provider.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
- [theme](./src/theme/theme-context.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->- theme-provider — <!-- begin:auto-docs --> _(no submo…
  - [layer-stack](./src/theme/layer-stack/layer-stack.md) — The `layer-stack` module is the runtime engine that backs `<ThemeProvider>`, `useThemeMutator()`, and `useResolvedTheme…
    - [layer-stack](./src/theme/layer-stack/layer-stack.md) — The `layer-stack` module is the runtime engine that backs `<ThemeProvider>`, `useThemeMutator()`, and `useResolvedTheme…
  - [theme-provider](./src/theme/theme-provider/theme-provider.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
    - [theme-provider](./src/theme/theme-provider/theme-provider.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
  - [theme-switcher](./src/theme/theme-switcher/theme-switcher.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
    - [theme-switcher](./src/theme/theme-switcher/theme-switcher.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
  - [dark](./src/theme/themes/dark.md) — The dark counterpart of `lightTheme`. Same variant surface, same token names, lightness anchors inverted so foreground…
  - [high-contrast](./src/theme/themes/high-contrast.md) — Accessibility-first theme that meets WCAG AAA contrast for normal and large text alike. Pure-white foreground (`#FFFFFF…
  - [light](./src/theme/themes/light.md) — The default `ThemePlugin` instance shipped with `@suaveplan/react-ui`. `lightTheme` matches the shadcn `nova` token pre…
  - [use-resolved-theme-tokens](./src/theme/use-resolved-theme-tokens/use-resolved-theme-tokens.md) — `useResolvedThemeTokens()` is the read-side counterpart to `useThemeMutator()`. It returns the live merged token state…
    - [use-resolved-theme-tokens](./src/theme/use-resolved-theme-tokens/use-resolved-theme-tokens.md) — `useResolvedThemeTokens()` is the read-side counterpart to `useThemeMutator()`. It returns the live merged token state…
  - [use-theme](./src/theme/use-theme/use-theme.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
    - [use-theme](./src/theme/use-theme/use-theme.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
  - [use-theme-mutator](./src/theme/use-theme-mutator/use-theme-mutator.md) — `useThemeMutator()` is the public surface a consumer reaches for when it wants to push CSS custom properties onto the a…
    - [use-theme-mutator](./src/theme/use-theme-mutator/use-theme-mutator.md) — `useThemeMutator()` is the public surface a consumer reaches for when it wants to push CSS custom properties onto the a…
  - [use-theme-tokens](./src/theme/use-theme-tokens/use-theme-tokens.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
    - [use-theme-tokens](./src/theme/use-theme-tokens/use-theme-tokens.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
  - [use-themed-variants](./src/theme/use-themed-variants/use-themed-variants.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
    - [use-themed-variants](./src/theme/use-themed-variants/use-themed-variants.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
  - [theme-context](./src/theme/theme-context.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->- theme-provider — <!-- begin:auto-docs --> _(no submo…
- [cn](./src/utils/cn/cn.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
  - [cn](./src/utils/cn/cn.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
- [motion](./src/utils/motion/motion.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
  - [motion](./src/utils/motion/motion.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
- [variants](./src/variants/variants.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
  - [variants](./src/variants/variants.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
- [version](./src/version.md) — Declares the running version of `@suaveplan/react-ui` as the constant `REACT_UI_VERSION`. The version is hand-maintaine…
<!-- end:auto-docs --> - accordion.variants — `accordionVariants`, `accordio…
  - [accordion](./src/components/accordion/accordion.md) — <!-- begin:auto-docs --> _(no submodules)_- accordion.variants — `accordionVariants`, `accordio…
  - [accordion.variants](./src/components/accordion/accordion.variants.md) — `accordionVariants`, `accordionItemVariants`, `accordionHeaderVariants`, `accordionTriggerVariants`, and `accordionCont…
- [alert](./src/components/alert/alert.md) — <!-- begin:auto-docs --> _(no submodules)_- alert.variants — `alertVariants` is the cva config……
  - [alert](./src/components/alert/alert.md) — <!-- begin:auto-docs --> _(no submodules)_- alert.variants — `alertVariants` is the cva config……
  - [alert.variants](./src/components/alert/alert.variants.md) — `alertVariants` is the cva config that powers the `<Alert>` chassis component. It exposes a `variant` axis with four ru…
- [alert-dialog](./src/components/alert-dialog/alert-dialog.md) — <!-- begin:auto-docs --> _(no submodules)_- alert-dialog.variants — `alertDialogOverlayVariants…
  - [alert-dialog](./src/components/alert-dialog/alert-dialog.md) — <!-- begin:auto-docs --> _(no submodules)_- alert-dialog.variants — `alertDialogOverlayVariants…
  - [alert-dialog.variants](./src/components/alert-dialog/alert-dialog.variants.md) — `alertDialogOverlayVariants`, `alertDialogContentVariants`, `alertDialogHeaderVariants`, `alertDialogFooterVariants`, `…
- [aspect-ratio](./src/components/aspect-ratio/aspect-ratio.md) — <!-- begin:auto-docs --> _(no submodules)_- aspect-ratio.variants — `aspectRatioVariants` is th…
  - [aspect-ratio](./src/components/aspect-ratio/aspect-ratio.md) — <!-- begin:auto-docs --> _(no submodules)_- aspect-ratio.variants — `aspectRatioVariants` is th…
  - [aspect-ratio.variants](./src/components/aspect-ratio/aspect-ratio.variants.md) — `aspectRatioVariants` is the cva (class-variance-authority) configuration powering the `<AspectRatio>` outer wrapper. I…
- [avatar](./src/components/avatar/avatar.md) — <!-- begin:auto-docs --> _(no submodules)_- avatar.variants — `avatarVariants` is the cva confi…
  - [avatar](./src/components/avatar/avatar.md) — <!-- begin:auto-docs --> _(no submodules)_- avatar.variants — `avatarVariants` is the cva confi…
  - [avatar.variants](./src/components/avatar/avatar.variants.md) — `avatarVariants` is the cva config that powers the `<Avatar>` chassis component (`<AvatarImage>` and `<AvatarFallback>`…
- [badge](./src/components/badge/badge.md) — <!-- begin:auto-docs --> _(no submodules)_- badge.variants — `badgeVariants` is the cva config……
  - [badge](./src/components/badge/badge.md) — <!-- begin:auto-docs --> _(no submodules)_- badge.variants — `badgeVariants` is the cva config……
  - [badge.variants](./src/components/badge/badge.variants.md) — `badgeVariants` is the cva config that powers the `<Badge>` chassis component. It exposes a `variant` axis with four ru…
- [breadcrumb](./src/components/breadcrumb/breadcrumb.md) — <!-- begin:auto-docs --> _(no submodules)_- breadcrumb.variants — `breadcrumbVariants`, `breadc…
  - [breadcrumb](./src/components/breadcrumb/breadcrumb.md) — <!-- begin:auto-docs --> _(no submodules)_- breadcrumb.variants — `breadcrumbVariants`, `breadc…
  - [breadcrumb.variants](./src/components/breadcrumb/breadcrumb.variants.md) — `breadcrumbVariants`, `breadcrumbListVariants`, `breadcrumbItemVariants`, `breadcrumbLinkVariants`, `breadcrumbPageVari…
- [button](./src/components/button/button.md) — <!-- begin:auto-docs --> _(no submodules)_- button.variants — `buttonVariants` is the cva (clas…
  - [button](./src/components/button/button.md) — <!-- begin:auto-docs --> _(no submodules)_- button.variants — `buttonVariants` is the cva (clas…
  - [button.variants](./src/components/button/button.variants.md) — `buttonVariants` is the cva (class-variance-authority) configuration that powers every `<Button>` render. It is split f…
- [calendar](./src/components/calendar/calendar.md) — <!-- begin:auto-docs --> _(no submodules)_- calendar.test-fixtures — Wave-3h local test fixture…
  - [calendar](./src/components/calendar/calendar.md) — <!-- begin:auto-docs --> _(no submodules)_- calendar.test-fixtures — Wave-3h local test fixture…
  - [calendar.test-fixtures](./src/components/calendar/calendar.test-fixtures.md) — Wave-3h local test fixture that augments the chassis test i18n instance with the `react-ui.calendar.*` keyset. The chas…
  - [calendar.variants](./src/components/calendar/calendar.variants.md) — `calendarVariants` is the cva config that powers the outer wrapper of `<Calendar>`. The recipe is intentionally minimal…
- [card](./src/components/card/card.md) — <!-- begin:auto-docs --> _(no submodules)_- card.variants — `cardVariants` (and its sub-compone…
  - [card](./src/components/card/card.md) — <!-- begin:auto-docs --> _(no submodules)_- card.variants — `cardVariants` (and its sub-compone…
  - [card.variants](./src/components/card/card.variants.md) — `cardVariants` (and its sub-component cva resolvers `cardHeaderVariants`, `cardTitleVariants`, `cardDescriptionVariants…
- [checkbox](./src/components/checkbox/checkbox.md) — <!-- begin:auto-docs --> _(no submodules)_- checkbox.variants — `checkboxVariants` is the cva (…
  - [checkbox](./src/components/checkbox/checkbox.md) — <!-- begin:auto-docs --> _(no submodules)_- checkbox.variants — `checkboxVariants` is the cva (…
  - [checkbox.variants](./src/components/checkbox/checkbox.variants.md) — `checkboxVariants` is the cva (class-variance-authority) configuration that powers every `<Checkbox>` render. It is spl…
- [collapsible](./src/components/collapsible/collapsible.md) — <!-- begin:auto-docs --> _(no submodules)_- collapsible.variants — `collapsibleVariants`, `coll…
  - [collapsible](./src/components/collapsible/collapsible.md) — <!-- begin:auto-docs --> _(no submodules)_- collapsible.variants — `collapsibleVariants`, `coll…
  - [collapsible.variants](./src/components/collapsible/collapsible.variants.md) — `collapsibleVariants`, `collapsibleTriggerVariants`, and `collapsibleContentVariants` are the cva (class-variance-autho…
- [confirm-delete-dialog](./src/components/confirm-delete-dialog/confirm-delete-dialog.md) — <!-- begin:auto-docs --> _(no submodules)_- confirm-delete-dialog.test-fixtures — Wave-3g local…
  - [confirm-delete-dialog](./src/components/confirm-delete-dialog/confirm-delete-dialog.md) — <!-- begin:auto-docs --> _(no submodules)_- confirm-delete-dialog.test-fixtures — Wave-3g local…
  - [confirm-delete-dialog.test-fixtures](./src/components/confirm-delete-dialog/confirm-delete-dialog.test-fixtures.md) — Wave-3g local test fixture that augments the chassis test i18n instance with the `react-ui.confirmDelete.*` keyset. The…
- [context-menu](./src/components/context-menu/context-menu.md) — <!-- begin:auto-docs --> _(no submodules)_- context-menu.variants — `contextMenuContentVariants…
  - [context-menu](./src/components/context-menu/context-menu.md) — <!-- begin:auto-docs --> _(no submodules)_- context-menu.variants — `contextMenuContentVariants…
  - [context-menu.variants](./src/components/context-menu/context-menu.variants.md) — `contextMenuContentVariants`, `contextMenuItemVariants`, `contextMenuLabelVariants`, `contextMenuSeparatorVariants`, `c…
- [data-table](./src/components/data-table/data-table.md) — <!-- begin:auto-docs --> _(no submodules)_- data-table.variants — `dataTableVariants`, `dataTab…
  - [data-table](./src/components/data-table/data-table.md) — <!-- begin:auto-docs --> _(no submodules)_- data-table.variants — `dataTableVariants`, `dataTab…
  - [data-table.variants](./src/components/data-table/data-table.variants.md) — `dataTableVariants`, `dataTablePaginationVariants`, and `dataTableSortHeaderVariants` drive the chassis `<DataTable>` o…
- [dialog](./src/components/dialog/dialog.md) — <!-- begin:auto-docs --> _(no submodules)_- dialog.variants — `dialogOverlayVariants`, `dialogC…
  - [dialog](./src/components/dialog/dialog.md) — <!-- begin:auto-docs --> _(no submodules)_- dialog.variants — `dialogOverlayVariants`, `dialogC…
  - [dialog.variants](./src/components/dialog/dialog.variants.md) — `dialogOverlayVariants`, `dialogContentVariants`, `dialogHeaderVariants`, `dialogFooterVariants`, `dialogTitleVariants`…
- [drawer](./src/components/drawer/drawer.md) — <!-- begin:auto-docs --> _(no submodules)_- drawer.variants — `drawerOverlayVariants`, `drawerC…
  - [drawer](./src/components/drawer/drawer.md) — <!-- begin:auto-docs --> _(no submodules)_- drawer.variants — `drawerOverlayVariants`, `drawerC…
  - [drawer.variants](./src/components/drawer/drawer.variants.md) — `drawerOverlayVariants`, `drawerContentVariants`, `drawerHandleVariants`, `drawerHeaderVariants`, `drawerFooterVariants…
- [dropdown-menu](./src/components/dropdown-menu/dropdown-menu.md) — <!-- begin:auto-docs --> _(no submodules)_- dropdown-menu.variants — `dropdownMenuContentVarian…
  - [dropdown-menu](./src/components/dropdown-menu/dropdown-menu.md) — <!-- begin:auto-docs --> _(no submodules)_- dropdown-menu.variants — `dropdownMenuContentVarian…
  - [dropdown-menu.variants](./src/components/dropdown-menu/dropdown-menu.variants.md) — `dropdownMenuContentVariants`, `dropdownMenuItemVariants`, `dropdownMenuLabelVariants`, `dropdownMenuSeparatorVariants`…
- [empty](./src/components/empty/empty.md) — <!-- begin:auto-docs --> _(no submodules)_- empty.variants — `emptyVariants` is the cva config……
  - [empty](./src/components/empty/empty.md) — <!-- begin:auto-docs --> _(no submodules)_- empty.variants — `emptyVariants` is the cva config……
  - [empty.variants](./src/components/empty/empty.variants.md) — `emptyVariants` is the cva config that powers the `<Empty>` chassis component (with `emptyHeaderVariants`, `emptyMediaV…
- [error-boundary](./src/components/error-boundary/error-boundary.md) — <!-- begin:auto-docs --> _(no submodules)_- error-boundary.metrics — Co-located OTel counter fo…
  - [error-boundary](./src/components/error-boundary/error-boundary.md) — <!-- begin:auto-docs --> _(no submodules)_- error-boundary.metrics — Co-located OTel counter fo…
  - [error-boundary.metrics](./src/components/error-boundary/error-boundary.metrics.md) — Co-located OTel counter for the chassis `<ErrorBoundary>` component. Lives next to the boundary itself rather than in t…
  - [error-boundary.test-fixtures](./src/components/error-boundary/error-boundary.test-fixtures.md) — Wave-3g local test fixture that augments the chassis test i18n instance with the `react-ui.errorBoundary.*` keyset. The…
  - [error-boundary.variants](./src/components/error-boundary/error-boundary.variants.md) — Cva slot definitions for the chassis `<ErrorBoundary>` default fallback. Splits the fallback into four named slots — ou…
- [field](./src/components/field/field.md) — <!-- begin:auto-docs --> _(no submodules)_- field.variants — `fieldVariants`, `fieldLabelVarian…
  - [field](./src/components/field/field.md) — <!-- begin:auto-docs --> _(no submodules)_- field.variants — `fieldVariants`, `fieldLabelVarian…
  - [field.variants](./src/components/field/field.variants.md) — `fieldVariants`, `fieldLabelVariants`, `fieldDescriptionVariants`, and `fieldErrorVariants` are the four cva (class-var…
- [field-group](./src/components/field-group/field-group.md) — <!-- begin:auto-docs --> _(no submodules)_- field-group.variants — `fieldGroupVariants` is the……
  - [field-group](./src/components/field-group/field-group.md) — <!-- begin:auto-docs --> _(no submodules)_- field-group.variants — `fieldGroupVariants` is the……
  - [field-group.variants](./src/components/field-group/field-group.variants.md) — `fieldGroupVariants` is the cva (class-variance-authority) configuration powering every `<FieldGroup>` render. It is sp…
- [field-set](./src/components/field-set/field-set.md) — <!-- begin:auto-docs --> _(no submodules)_- field-set.variants — `fieldSetVariants` and `fieldL…
  - [field-set](./src/components/field-set/field-set.md) — <!-- begin:auto-docs --> _(no submodules)_- field-set.variants — `fieldSetVariants` and `fieldL…
  - [field-set.variants](./src/components/field-set/field-set.variants.md) — `fieldSetVariants` and `fieldLegendVariants` are the cva (class-variance-authority) configurations powering `<FieldSet>…
- [hover-card](./src/components/hover-card/hover-card.md) — <!-- begin:auto-docs --> _(no submodules)_- hover-card.variants — `hoverCardContentVariants` is…
  - [hover-card](./src/components/hover-card/hover-card.md) — <!-- begin:auto-docs --> _(no submodules)_- hover-card.variants — `hoverCardContentVariants` is…
  - [hover-card.variants](./src/components/hover-card/hover-card.variants.md) — `hoverCardContentVariants` is the cva configuration powering the `<HoverCardContent>` floating panel. It is split from…
- [input](./src/components/input/input.md) — <!-- begin:auto-docs --> _(no submodules)_- [input-number](./src/components/input/input-number/input-number.md) — <!-- begin:auto-docs --> _(no submodules)_- [input-number](./src/components/input/input-number/input-number.md) — <!-- begin:auto-docs --> _(no submodules)_- [input](./src/components/input/input.md) — <!-- begin:auto-docs --> _(no submodules)_- [input.variants](./src/components/input/input.variants.md) — `inputVariants` is the cva (class-variance-authority) configuration that powers every `<Input>` render. It is split fro…
- [input-group](./src/components/input-group/input-group.md) — <!-- begin:auto-docs --> _(no submodules)_- input-group.variants — `inputGroupVariants`, `input…
  - [input-group](./src/components/input-group/input-group.md) — <!-- begin:auto-docs --> _(no submodules)_- input-group.variants — `inputGroupVariants`, `input…
  - [input-group.variants](./src/components/input-group/input-group.variants.md) — `inputGroupVariants`, `inputGroupAddonVariants`, `inputGroupInputVariants`, `inputGroupTextareaVariants`, and `inputGro…
- [label](./src/components/label/label.md) — <!-- begin:auto-docs --> _(no submodules)_- label.variants — `labelVariants` is the cva (class-…
  - [label](./src/components/label/label.md) — <!-- begin:auto-docs --> _(no submodules)_- label.variants — `labelVariants` is the cva (class-…
  - [label.variants](./src/components/label/label.variants.md) — `labelVariants` is the cva (class-variance-authority) configuration that powers every `<Label>` render. It is split fro…
- [menubar](./src/components/menubar/menubar.md) — <!-- begin:auto-docs --> _(no submodules)_- menubar.variants — `menubarVariants`, `menubarTrigg…
  - [menubar](./src/components/menubar/menubar.md) — <!-- begin:auto-docs --> _(no submodules)_- menubar.variants — `menubarVariants`, `menubarTrigg…
  - [menubar.variants](./src/components/menubar/menubar.variants.md) — `menubarVariants`, `menubarTriggerVariants`, `menubarContentVariants`, `menubarItemVariants`, `menubarLabelVariants`, `…
- [pagination](./src/components/pagination/pagination.md) — <!-- begin:auto-docs --> _(no submodules)_- pagination.variants — `paginationVariants`, `pagina…
  - [pagination](./src/components/pagination/pagination.md) — <!-- begin:auto-docs --> _(no submodules)_- pagination.variants — `paginationVariants`, `pagina…
  - [pagination.variants](./src/components/pagination/pagination.variants.md) — `paginationVariants`, `paginationContentVariants`, `paginationItemVariants`, `paginationLinkVariants`, `paginationPrevN…
- [popover](./src/components/popover/popover.md) — <!-- begin:auto-docs --> _(no submodules)_- popover.variants — `popoverContentVariants` is the……
  - [popover](./src/components/popover/popover.md) — <!-- begin:auto-docs --> _(no submodules)_- popover.variants — `popoverContentVariants` is the……
  - [popover.variants](./src/components/popover/popover.variants.md) — `popoverContentVariants` is the cva configuration powering the `<PopoverContent>` floating panel. It is split from `pop…
- [progress](./src/components/progress/progress.md) — <!-- begin:auto-docs --> _(no submodules)_- progress.variants — `progressVariants` is the cva c…
  - [progress](./src/components/progress/progress.md) — <!-- begin:auto-docs --> _(no submodules)_- progress.variants — `progressVariants` is the cva c…
  - [progress.variants](./src/components/progress/progress.variants.md) — `progressVariants` is the cva config that powers the `<Progress>` chassis component (paired with `progressIndicatorVari…
- [radio-group](./src/components/radio-group/radio-group.md) — <!-- begin:auto-docs --> _(no submodules)_- radio-group.variants — `radioGroupVariants` and `ra…
  - [radio-group](./src/components/radio-group/radio-group.md) — <!-- begin:auto-docs --> _(no submodules)_- radio-group.variants — `radioGroupVariants` and `ra…
  - [radio-group.variants](./src/components/radio-group/radio-group.variants.md) — `radioGroupVariants` and `radioGroupItemVariants` are the cva (class-variance-authority) configurations powering `<Radi…
- [resizable](./src/components/resizable/resizable.md) — <!-- begin:auto-docs --> _(no submodules)_- resizable.variants — `resizablePanelGroupVariants`,…
  - [resizable](./src/components/resizable/resizable.md) — <!-- begin:auto-docs --> _(no submodules)_- resizable.variants — `resizablePanelGroupVariants`,…
  - [resizable.variants](./src/components/resizable/resizable.variants.md) — `resizablePanelGroupVariants`, `resizablePanelVariants`, `resizableHandleVariants`, and `resizableHandleGripVariants` a…
- [scroll-area](./src/components/scroll-area/scroll-area.md) — <!-- begin:auto-docs --> _(no submodules)_- scroll-area.variants — `scrollAreaVariants`, `scrol…
  - [scroll-area](./src/components/scroll-area/scroll-area.md) — <!-- begin:auto-docs --> _(no submodules)_- scroll-area.variants — `scrollAreaVariants`, `scrol…
  - [scroll-area.variants](./src/components/scroll-area/scroll-area.variants.md) — `scrollAreaVariants`, `scrollAreaViewportVariants`, `scrollAreaScrollbarVariants`, `scrollAreaThumbVariants`, and `scro…
- [select](./src/components/select/select.md) — <!-- begin:auto-docs --> _(no submodules)_- select.test-fixtures — Wave-3h local test fixture t…
  - [select](./src/components/select/select.md) — <!-- begin:auto-docs --> _(no submodules)_- select.test-fixtures — Wave-3h local test fixture t…
  - [select.test-fixtures](./src/components/select/select.test-fixtures.md) — Wave-3h local test fixture that augments the chassis test i18n instance with the `react-ui.select.placeholder` key. The…
  - [select.variants](./src/components/select/select.variants.md) — The `<Select>` component is composed of six visual slots — trigger, content panel, item row, group label, separator, an…
- [separator](./src/components/separator/separator.md) — <!-- begin:auto-docs --> _(no submodules)_- separator.variants — `separatorVariants` is the cva…
  - [separator](./src/components/separator/separator.md) — <!-- begin:auto-docs --> _(no submodules)_- separator.variants — `separatorVariants` is the cva…
  - [separator.variants](./src/components/separator/separator.variants.md) — `separatorVariants` is the cva (class-variance-authority) configuration that powers every `<Separator>` render. It is s…
- [sheet](./src/components/sheet/sheet.md) — <!-- begin:auto-docs --> _(no submodules)_- sheet.variants — `sheetOverlayVariants`, `sheetCont…
  - [sheet](./src/components/sheet/sheet.md) — <!-- begin:auto-docs --> _(no submodules)_- sheet.variants — `sheetOverlayVariants`, `sheetCont…
  - [sheet.variants](./src/components/sheet/sheet.variants.md) — `sheetOverlayVariants`, `sheetContentVariants`, `sheetHeaderVariants`, `sheetFooterVariants`, `sheetTitleVariants`, `sh…
- [skeleton](./src/components/skeleton/skeleton.md) — <!-- begin:auto-docs --> _(no submodules)_- skeleton.variants — `skeletonVariants` is the cva (…
  - [skeleton](./src/components/skeleton/skeleton.md) — <!-- begin:auto-docs --> _(no submodules)_- skeleton.variants — `skeletonVariants` is the cva (…
  - [skeleton.variants](./src/components/skeleton/skeleton.variants.md) — `skeletonVariants` is the cva (class-variance-authority) configuration that powers every `<Skeleton>` render. It is spl…
- [sonner](./src/components/sonner/sonner.md) — <!-- begin:auto-docs --> _(no submodules)_- sonner.variants — Defines the `sonnerToasterVariant…
  - [sonner](./src/components/sonner/sonner.md) — <!-- begin:auto-docs --> _(no submodules)_- sonner.variants — Defines the `sonnerToasterVariant…
  - [sonner.variants](./src/components/sonner/sonner.variants.md) — Defines the `sonnerToasterVariants` cva slot for the chassis `<Sonner>` toaster host. Sonner manages its own stacking,…
- [spinner](./src/components/spinner/spinner.md) — <!-- begin:auto-docs --> _(no submodules)_- spinner.variants — `spinnerVariants` is the cva con…
  - [spinner](./src/components/spinner/spinner.md) — <!-- begin:auto-docs --> _(no submodules)_- spinner.variants — `spinnerVariants` is the cva con…
  - [spinner.variants](./src/components/spinner/spinner.variants.md) — `spinnerVariants` is the cva config that powers the `<Spinner>` chassis component. It exposes a `size` axis (`sm` / `de…
- [status-badge](./src/components/status-badge/status-badge.md) — <!-- begin:auto-docs --> _(no submodules)_- status-badge.variants — `statusBadgeVariants` is th…
  - [status-badge](./src/components/status-badge/status-badge.md) — <!-- begin:auto-docs --> _(no submodules)_- status-badge.variants — `statusBadgeVariants` is th…
  - [status-badge.variants](./src/components/status-badge/status-badge.variants.md) — `statusBadgeVariants` is the cva config that powers the `<StatusBadge>` chassis component. It exposes a `status` axis w…
- [switch](./src/components/switch/switch.md) — <!-- begin:auto-docs --> _(no submodules)_- switch.variants — `switchVariants` and `switchThumb…
  - [switch](./src/components/switch/switch.md) — <!-- begin:auto-docs --> _(no submodules)_- switch.variants — `switchVariants` and `switchThumb…
  - [switch.variants](./src/components/switch/switch.variants.md) — `switchVariants` and `switchThumbVariants` are the two cva (class-variance-authority) configurations that together powe…
- [table](./src/components/table/table.md) — <!-- begin:auto-docs --> _(no submodules)_- table.variants — `tableVariants` and its eight sub-…
  - [table](./src/components/table/table.md) — <!-- begin:auto-docs --> _(no submodules)_- table.variants — `tableVariants` and its eight sub-…
  - [table.variants](./src/components/table/table.variants.md) — `tableVariants` and its eight sub-component cva resolvers (`tableHeaderVariants`, `tableBodyVariants`, `tableFooterVari…
- [tabs](./src/components/tabs/tabs.md) — <!-- begin:auto-docs --> _(no submodules)_- tabs.variants — `tabsVariants`, `tabsListVariants`,…
  - [tabs](./src/components/tabs/tabs.md) — <!-- begin:auto-docs --> _(no submodules)_- tabs.variants — `tabsVariants`, `tabsListVariants`,…
  - [tabs.variants](./src/components/tabs/tabs.variants.md) — `tabsVariants`, `tabsListVariants`, `tabsTriggerVariants`, and `tabsContentVariants` are the cva (class-variance-author…
- [textarea](./src/components/textarea/textarea.md) — <!-- begin:auto-docs --> _(no submodules)_- textarea.variants — `textareaVariants` is the cva (…
  - [textarea](./src/components/textarea/textarea.md) — <!-- begin:auto-docs --> _(no submodules)_- textarea.variants — `textareaVariants` is the cva (…
  - [textarea.variants](./src/components/textarea/textarea.variants.md) — `textareaVariants` is the cva (class-variance-authority) configuration that powers every `<Textarea>` render. It is spl…
- [theme-toggle](./src/components/theme-toggle/theme-toggle.md) — <!-- begin:auto-docs --> _(no submodules)_- theme-toggle.variants — Cva slot for the chassis `<…
  - [theme-toggle](./src/components/theme-toggle/theme-toggle.md) — <!-- begin:auto-docs --> _(no submodules)_- theme-toggle.variants — Cva slot for the chassis `<…
  - [theme-toggle.variants](./src/components/theme-toggle/theme-toggle.variants.md) — Cva slot for the chassis `<ThemeToggle>` icon-button. Mirrors the shape of `<Button variant="outline" size="icon">` so…
- [toast](./src/components/toast/toast.md) — <!-- begin:auto-docs --> _(no submodules)_- [toast](./src/components/toast/toast.md) — <!-- begin:auto-docs --> _(no submodules)_- [toggle](./src/components/toggle/toggle.md) — <!-- begin:auto-docs --> _(no submodules)_- toggle.variants — `toggleVariants` is the cva (clas…
  - [toggle](./src/components/toggle/toggle.md) — <!-- begin:auto-docs --> _(no submodules)_- toggle.variants — `toggleVariants` is the cva (clas…
  - [toggle.variants](./src/components/toggle/toggle.variants.md) — `toggleVariants` is the cva (class-variance-authority) configuration powering every `<Toggle>` render. It is split from…
- [toggle-group](./src/components/toggle-group/toggle-group.md) — <!-- begin:auto-docs --> _(no submodules)_- toggle-group.variants — `toggleGroupVariants` and `…
  - [toggle-group](./src/components/toggle-group/toggle-group.md) — <!-- begin:auto-docs --> _(no submodules)_- toggle-group.variants — `toggleGroupVariants` and `…
  - [toggle-group.variants](./src/components/toggle-group/toggle-group.variants.md) — `toggleGroupVariants` and `toggleGroupItemVariants` are the cva (class-variance-authority) configurations powering `<To…
- [tooltip](./src/components/tooltip/tooltip.md) — <!-- begin:auto-docs --> _(no submodules)_- tooltip.variants — `tooltipContentVariants` is the……
  - [tooltip](./src/components/tooltip/tooltip.md) — <!-- begin:auto-docs --> _(no submodules)_- tooltip.variants — `tooltipContentVariants` is the……
  - [tooltip.variants](./src/components/tooltip/tooltip.variants.md) — `tooltipContentVariants` is the cva configuration powering the `<TooltipContent>` floating bubble. It is split from `to…
- [use-toast-sonner-bridge](./src/components/use-toast-sonner-bridge/use-toast-sonner-bridge.md) — <!-- begin:auto-docs --> _(no submodules)_- [use-toast-sonner-bridge](./src/components/use-toast-sonner-bridge/use-toast-sonner-bridge.md) — <!-- begin:auto-docs --> _(no submodules)_- [error-codes](./src/errors/error-codes.md) — Defines every stable error code emitted by the `@suaveplan/react-ui` package. Codes are grouped under the `REACT_UI` na…
- [react-ui-error](./src/errors/react-ui-error.md) — Owns every error thrown by the `@suaveplan/react-ui` package. Extends the project-wide `SuaveplanError` so each instan…
- [use-mobile](./src/hooks/use-mobile/use-mobile.md) — <!-- begin:auto-docs --> _(no submodules)_- [use-mobile](./src/hooks/use-mobile/use-mobile.md) — <!-- begin:auto-docs --> _(no submodules)_- [use-toast](./src/hooks/use-toast/use-toast.md) — <!-- begin:auto-docs --> _(no submodules)_- [use-toast](./src/hooks/use-toast/use-toast.md) — <!-- begin:auto-docs --> _(no submodules)_- [formatted-cell](./src/i18n/formatted-cell/formatted-cell.md) — <!-- begin:auto-docs --> _(no submodules)_- [formatted-cell](./src/i18n/formatted-cell/formatted-cell.md) — <!-- begin:auto-docs --> _(no submodules)_- [formatted-currency](./src/i18n/formatted-currency/formatted-currency.md) — <!-- begin:auto-docs --> _(no submodules)_- [formatted-currency](./src/i18n/formatted-currency/formatted-currency.md) — <!-- begin:auto-docs --> _(no submodules)_- [formatted-date](./src/i18n/formatted-date/formatted-date.md) — <!-- begin:auto-docs --> _(no submodules)_- [formatted-date](./src/i18n/formatted-date/formatted-date.md) — <!-- begin:auto-docs --> _(no submodules)_- [formatted-list](./src/i18n/formatted-list/formatted-list.md) — <!-- begin:auto-docs --> _(no submodules)_- [formatted-list](./src/i18n/formatted-list/formatted-list.md) — <!-- begin:auto-docs --> _(no submodules)_- [formatted-message](./src/i18n/formatted-message/formatted-message.md) — <!-- begin:auto-docs --> _(no submodules)_- [formatted-message](./src/i18n/formatted-message/formatted-message.md) — <!-- begin:auto-docs --> _(no submodules)_- [formatted-number](./src/i18n/formatted-number/formatted-number.md) — <!-- begin:auto-docs --> _(no submodules)_- [formatted-number](./src/i18n/formatted-number/formatted-number.md) — <!-- begin:auto-docs --> _(no submodules)_- [formatted-relative-time](./src/i18n/formatted-relative-time/formatted-relative-time.md) — <!-- begin:auto-docs --> _(no submodules)_- [formatted-relative-time](./src/i18n/formatted-relative-time/formatted-relative-time.md) — <!-- begin:auto-docs --> _(no submodules)_- [plural](./src/i18n/plural/plural.md) — <!-- begin:auto-docs --> _(no submodules)_- [plural](./src/i18n/plural/plural.md) — <!-- begin:auto-docs --> _(no submodules)_- [react-ui-i18n-bridge](./src/i18n/react-ui-i18n-bridge/react-ui-i18n-bridge.md) — <!-- begin:auto-docs --> _(no submodules)_- [react-ui-i18n-bridge](./src/i18n/react-ui-i18n-bridge/react-ui-i18n-bridge.md) — <!-- begin:auto-docs --> _(no submodules)_- [stories-shell](./src/i18n/stories-shell/stories-shell.md) — <!-- begin:auto-docs --> _(no submodules)_- [stories-shell](./src/i18n/stories-shell/stories-shell.md) — <!-- begin:auto-docs --> _(no submodules)_- [tanstack-bridge](./src/i18n/tanstack-bridge/tanstack-bridge.md) — <!-- begin:auto-docs --> _(no submodules)_- [tanstack-bridge](./src/i18n/tanstack-bridge/tanstack-bridge.md) — <!-- begin:auto-docs --> _(no submodules)_- [validation-message-bridge](./src/i18n/validation-message-bridge/validation-message-bridge.md) — <!-- begin:auto-docs --> _(no submodules)_- [validation-message-bridge](./src/i18n/validation-message-bridge/validation-message-bridge.md) — <!-- begin:auto-docs --> _(no submodules)_- [augmentation](./src/locales/augmentation.md) — Side-effect-only TypeScript module that augments `@suaveplan/react-i18n`'s `ContributedTranslationKeys` interface with…
- [schema](./src/locales/schema.md) — Zod schema asserting that every locale bundle declares exactly the keys present in the canonical `en-GB.json` source-of…
- [translation-keys](./src/locales/translation-keys.md) — `translation-keys.ts` is the codegen-emitted string-literal union of every translation key contributed by `@suaveplan/r…
- [observability](./src/observability/react-ui-metrics.md) — <!-- begin:auto-docs --> _(no submodules)_- [react-ui-metrics](./src/observability/react-ui-metrics.md) — <!-- begin:auto-docs --> _(no submodules)_- [pack](./src/pack/pack-context.md) — <!-- begin:auto-docs --> _(no submodules)_- [pack-registry-provider](./src/pack/pack-registry-provider/pack-registry-provider.md) — <!-- begin:auto-docs --> _(no submodules)_- [pack-registry-provider](./src/pack/pack-registry-provider/pack-registry-provider.md) — <!-- begin:auto-docs --> _(no submodules)_- [runtime-override](./src/pack/runtime-override/runtime-override.md) — <!-- begin:auto-docs --> _(no submodules)_- [runtime-override](./src/pack/runtime-override/runtime-override.md) — <!-- begin:auto-docs --> _(no submodules)_- [use-pack-component](./src/pack/use-pack-component/use-pack-component.md) — <!-- begin:auto-docs --> _(no submodules)_- [use-pack-component](./src/pack/use-pack-component/use-pack-component.md) — <!-- begin:auto-docs --> _(no submodules)_- [version-check](./src/pack/version-check/version-check.md) — <!-- begin:auto-docs --> _(no submodules)_- [version-check](./src/pack/version-check/version-check.md) — <!-- begin:auto-docs --> _(no submodules)_- [pack-context](./src/pack/pack-context.md) — <!-- begin:auto-docs --> _(no submodules)_- [react-ui-provider](./src/provider/react-ui-provider/react-ui-provider.md) — <!-- begin:auto-docs --> _(no submodules)_- [react-ui-provider](./src/provider/react-ui-provider/react-ui-provider.md) — <!-- begin:auto-docs --> _(no submodules)_- [theme](./src/theme/theme-context.md) — <!-- begin:auto-docs --> _(no submodules)_- [theme-provider](./src/theme/theme-provider/theme-provider.md) — <!-- begin:auto-docs --> _(no submodules)_- [theme-provider](./src/theme/theme-provider/theme-provider.md) — <!-- begin:auto-docs --> _(no submodules)_- [theme-switcher](./src/theme/theme-switcher/theme-switcher.md) — <!-- begin:auto-docs --> _(no submodules)_- [theme-switcher](./src/theme/theme-switcher/theme-switcher.md) — <!-- begin:auto-docs --> _(no submodules)_- [dark](./src/theme/themes/dark.md) — The dark counterpart of `lightTheme`. Same variant surface, same token names, lightness anchors inverted so foreground…
  - [high-contrast](./src/theme/themes/high-contrast.md) — Accessibility-first theme that meets WCAG AAA contrast for normal and large text alike. Pure-white foreground (`#FFFFFF…
  - [light](./src/theme/themes/light.md) — The default `ThemePlugin` instance shipped with `@suaveplan/react-ui`. `lightTheme` matches the shadcn `nova` token pre…
  - [use-theme](./src/theme/use-theme/use-theme.md) — <!-- begin:auto-docs --> _(no submodules)_- [use-theme](./src/theme/use-theme/use-theme.md) — <!-- begin:auto-docs --> _(no submodules)_- [use-theme-tokens](./src/theme/use-theme-tokens/use-theme-tokens.md) — <!-- begin:auto-docs --> _(no submodules)_- [use-theme-tokens](./src/theme/use-theme-tokens/use-theme-tokens.md) — <!-- begin:auto-docs --> _(no submodules)_- [use-themed-variants](./src/theme/use-themed-variants/use-themed-variants.md) — <!-- begin:auto-docs --> _(no submodules)_- [use-themed-variants](./src/theme/use-themed-variants/use-themed-variants.md) — <!-- begin:auto-docs --> _(no submodules)_- [theme-context](./src/theme/theme-context.md) — <!-- begin:auto-docs --> _(no submodules)_- [cn](./src/utils/cn/cn.md) — <!-- begin:auto-docs --> _(no submodules)_- [cn](./src/utils/cn/cn.md) — <!-- begin:auto-docs --> _(no submodules)_- [motion](./src/utils/motion/motion.md) — <!-- begin:auto-docs --> _(no submodules)_- [motion](./src/utils/motion/motion.md) — <!-- begin:auto-docs --> _(no submodules)_- [variants](./src/variants/variants.md) — <!-- begin:auto-docs --> _(no submodules)_- [variants](./src/variants/variants.md) — <!-- begin:auto-docs --> _(no submodules)_- [version](./src/version.md) — Declares the running version of `@suaveplan/react-ui` as the constant `REACT_UI_VERSION`. The version is hand-maintaine…

- accordion.variants — `accordionVariants`, `accordio…

- [accordion](./src/components/accordion/accordion.md) — <!-- begin:auto-docs --> _(no submodules)_- accordion.variants — `accordionVariants`, `accordio…
- [accordion.variants](./src/components/accordion/accordion.variants.md) — `accordionVariants`, `accordionItemVariants`, `accordionHeaderVariants`, `accordionTriggerVariants`, and `accordionCont…
- [alert](./src/components/alert/alert.md) — <!-- begin:auto-docs --> _(no submodules)_- alert.variants — `alertVariants` is the cva config……
  - [alert](./src/components/alert/alert.md) — <!-- begin:auto-docs --> _(no submodules)_- alert.variants — `alertVariants` is the cva config……
  - [alert.variants](./src/components/alert/alert.variants.md) — `alertVariants` is the cva config that powers the `<Alert>` chassis component. It exposes a `variant` axis with four ru…
- [alert-dialog](./src/components/alert-dialog/alert-dialog.md) — <!-- begin:auto-docs --> _(no submodules)_- alert-dialog.variants — `alertDialogOverlayVariants…
  - [alert-dialog](./src/components/alert-dialog/alert-dialog.md) — <!-- begin:auto-docs --> _(no submodules)_- alert-dialog.variants — `alertDialogOverlayVariants…
  - [alert-dialog.variants](./src/components/alert-dialog/alert-dialog.variants.md) — `alertDialogOverlayVariants`, `alertDialogContentVariants`, `alertDialogHeaderVariants`, `alertDialogFooterVariants`, `…
- [aspect-ratio](./src/components/aspect-ratio/aspect-ratio.md) — <!-- begin:auto-docs --> _(no submodules)_- aspect-ratio.variants — `aspectRatioVariants` is th…
  - [aspect-ratio](./src/components/aspect-ratio/aspect-ratio.md) — <!-- begin:auto-docs --> _(no submodules)_- aspect-ratio.variants — `aspectRatioVariants` is th…
  - [aspect-ratio.variants](./src/components/aspect-ratio/aspect-ratio.variants.md) — `aspectRatioVariants` is the cva (class-variance-authority) configuration powering the `<AspectRatio>` outer wrapper. I…
- [avatar](./src/components/avatar/avatar.md) — <!-- begin:auto-docs --> _(no submodules)_- avatar.variants — `avatarVariants` is the cva confi…
  - [avatar](./src/components/avatar/avatar.md) — <!-- begin:auto-docs --> _(no submodules)_- avatar.variants — `avatarVariants` is the cva confi…
  - [avatar.variants](./src/components/avatar/avatar.variants.md) — `avatarVariants` is the cva config that powers the `<Avatar>` chassis component (`<AvatarImage>` and `<AvatarFallback>`…
- [badge](./src/components/badge/badge.md) — <!-- begin:auto-docs --> _(no submodules)_- badge.variants — `badgeVariants` is the cva config……
  - [badge](./src/components/badge/badge.md) — <!-- begin:auto-docs --> _(no submodules)_- badge.variants — `badgeVariants` is the cva config……
  - [badge.variants](./src/components/badge/badge.variants.md) — `badgeVariants` is the cva config that powers the `<Badge>` chassis component. It exposes a `variant` axis with four ru…
- [breadcrumb](./src/components/breadcrumb/breadcrumb.md) — <!-- begin:auto-docs --> _(no submodules)_- breadcrumb.variants — `breadcrumbVariants`, `breadc…
  - [breadcrumb](./src/components/breadcrumb/breadcrumb.md) — <!-- begin:auto-docs --> _(no submodules)_- breadcrumb.variants — `breadcrumbVariants`, `breadc…
  - [breadcrumb.variants](./src/components/breadcrumb/breadcrumb.variants.md) — `breadcrumbVariants`, `breadcrumbListVariants`, `breadcrumbItemVariants`, `breadcrumbLinkVariants`, `breadcrumbPageVari…
- [button](./src/components/button/button.md) — <!-- begin:auto-docs --> _(no submodules)_- button.variants — `buttonVariants` is the cva (clas…
  - [button](./src/components/button/button.md) — <!-- begin:auto-docs --> _(no submodules)_- button.variants — `buttonVariants` is the cva (clas…
  - [button.variants](./src/components/button/button.variants.md) — `buttonVariants` is the cva (class-variance-authority) configuration that powers every `<Button>` render. It is split f…
- [calendar](./src/components/calendar/calendar.md) — <!-- begin:auto-docs --> _(no submodules)_- calendar.test-fixtures — Wave-3h local test fixture…
  - [calendar](./src/components/calendar/calendar.md) — <!-- begin:auto-docs --> _(no submodules)_- calendar.test-fixtures — Wave-3h local test fixture…
  - [calendar.test-fixtures](./src/components/calendar/calendar.test-fixtures.md) — Wave-3h local test fixture that augments the chassis test i18n instance with the `react-ui.calendar.*` keyset. The chas…
  - [calendar.variants](./src/components/calendar/calendar.variants.md) — `calendarVariants` is the cva config that powers the outer wrapper of `<Calendar>`. The recipe is intentionally minimal…
- [card](./src/components/card/card.md) — <!-- begin:auto-docs --> _(no submodules)_- card.variants — `cardVariants` (and its sub-compone…
  - [card](./src/components/card/card.md) — <!-- begin:auto-docs --> _(no submodules)_- card.variants — `cardVariants` (and its sub-compone…
  - [card.variants](./src/components/card/card.variants.md) — `cardVariants` (and its sub-component cva resolvers `cardHeaderVariants`, `cardTitleVariants`, `cardDescriptionVariants…
- [checkbox](./src/components/checkbox/checkbox.md) — <!-- begin:auto-docs --> _(no submodules)_- checkbox.variants — `checkboxVariants` is the cva (…
  - [checkbox](./src/components/checkbox/checkbox.md) — <!-- begin:auto-docs --> _(no submodules)_- checkbox.variants — `checkboxVariants` is the cva (…
  - [checkbox.variants](./src/components/checkbox/checkbox.variants.md) — `checkboxVariants` is the cva (class-variance-authority) configuration that powers every `<Checkbox>` render. It is spl…
- [collapsible](./src/components/collapsible/collapsible.md) — <!-- begin:auto-docs --> _(no submodules)_- collapsible.variants — `collapsibleVariants`, `coll…
  - [collapsible](./src/components/collapsible/collapsible.md) — <!-- begin:auto-docs --> _(no submodules)_- collapsible.variants — `collapsibleVariants`, `coll…
  - [collapsible.variants](./src/components/collapsible/collapsible.variants.md) — `collapsibleVariants`, `collapsibleTriggerVariants`, and `collapsibleContentVariants` are the cva (class-variance-autho…
- [confirm-delete-dialog](./src/components/confirm-delete-dialog/confirm-delete-dialog.md) — <!-- begin:auto-docs --> _(no submodules)_- confirm-delete-dialog.test-fixtures — Wave-3g local…
  - [confirm-delete-dialog](./src/components/confirm-delete-dialog/confirm-delete-dialog.md) — <!-- begin:auto-docs --> _(no submodules)_- confirm-delete-dialog.test-fixtures — Wave-3g local…
  - [confirm-delete-dialog.test-fixtures](./src/components/confirm-delete-dialog/confirm-delete-dialog.test-fixtures.md) — Wave-3g local test fixture that augments the chassis test i18n instance with the `react-ui.confirmDelete.*` keyset. The…
- [context-menu](./src/components/context-menu/context-menu.md) — <!-- begin:auto-docs --> _(no submodules)_- context-menu.variants — `contextMenuContentVariants…
  - [context-menu](./src/components/context-menu/context-menu.md) — <!-- begin:auto-docs --> _(no submodules)_- context-menu.variants — `contextMenuContentVariants…
  - [context-menu.variants](./src/components/context-menu/context-menu.variants.md) — `contextMenuContentVariants`, `contextMenuItemVariants`, `contextMenuLabelVariants`, `contextMenuSeparatorVariants`, `c…
- [data-table](./src/components/data-table/data-table.md) — <!-- begin:auto-docs --> _(no submodules)_- data-table.variants — `dataTableVariants`, `dataTab…
  - [data-table](./src/components/data-table/data-table.md) — <!-- begin:auto-docs --> _(no submodules)_- data-table.variants — `dataTableVariants`, `dataTab…
  - [data-table.variants](./src/components/data-table/data-table.variants.md) — `dataTableVariants`, `dataTablePaginationVariants`, and `dataTableSortHeaderVariants` drive the chassis `<DataTable>` o…
- [dialog](./src/components/dialog/dialog.md) — <!-- begin:auto-docs --> _(no submodules)_- dialog.variants — `dialogOverlayVariants`, `dialogC…
  - [dialog](./src/components/dialog/dialog.md) — <!-- begin:auto-docs --> _(no submodules)_- dialog.variants — `dialogOverlayVariants`, `dialogC…
  - [dialog.variants](./src/components/dialog/dialog.variants.md) — `dialogOverlayVariants`, `dialogContentVariants`, `dialogHeaderVariants`, `dialogFooterVariants`, `dialogTitleVariants`…
- [drawer](./src/components/drawer/drawer.md) — <!-- begin:auto-docs --> _(no submodules)_- drawer.variants — `drawerOverlayVariants`, `drawerC…
  - [drawer](./src/components/drawer/drawer.md) — <!-- begin:auto-docs --> _(no submodules)_- drawer.variants — `drawerOverlayVariants`, `drawerC…
  - [drawer.variants](./src/components/drawer/drawer.variants.md) — `drawerOverlayVariants`, `drawerContentVariants`, `drawerHandleVariants`, `drawerHeaderVariants`, `drawerFooterVariants…
- [dropdown-menu](./src/components/dropdown-menu/dropdown-menu.md) — <!-- begin:auto-docs --> _(no submodules)_- dropdown-menu.variants — `dropdownMenuContentVarian…
  - [dropdown-menu](./src/components/dropdown-menu/dropdown-menu.md) — <!-- begin:auto-docs --> _(no submodules)_- dropdown-menu.variants — `dropdownMenuContentVarian…
  - [dropdown-menu.variants](./src/components/dropdown-menu/dropdown-menu.variants.md) — `dropdownMenuContentVariants`, `dropdownMenuItemVariants`, `dropdownMenuLabelVariants`, `dropdownMenuSeparatorVariants`…
- [empty](./src/components/empty/empty.md) — <!-- begin:auto-docs --> _(no submodules)_- empty.variants — `emptyVariants` is the cva config……
  - [empty](./src/components/empty/empty.md) — <!-- begin:auto-docs --> _(no submodules)_- empty.variants — `emptyVariants` is the cva config……
  - [empty.variants](./src/components/empty/empty.variants.md) — `emptyVariants` is the cva config that powers the `<Empty>` chassis component (with `emptyHeaderVariants`, `emptyMediaV…
- [error-boundary](./src/components/error-boundary/error-boundary.md) — <!-- begin:auto-docs --> _(no submodules)_- error-boundary.metrics — Co-located OTel counter fo…
  - [error-boundary](./src/components/error-boundary/error-boundary.md) — <!-- begin:auto-docs --> _(no submodules)_- error-boundary.metrics — Co-located OTel counter fo…
  - [error-boundary.metrics](./src/components/error-boundary/error-boundary.metrics.md) — Co-located OTel counter for the chassis `<ErrorBoundary>` component. Lives next to the boundary itself rather than in t…
  - [error-boundary.test-fixtures](./src/components/error-boundary/error-boundary.test-fixtures.md) — Wave-3g local test fixture that augments the chassis test i18n instance with the `react-ui.errorBoundary.*` keyset. The…
  - [error-boundary.variants](./src/components/error-boundary/error-boundary.variants.md) — Cva slot definitions for the chassis `<ErrorBoundary>` default fallback. Splits the fallback into four named slots — ou…
- [field](./src/components/field/field.md) — <!-- begin:auto-docs --> _(no submodules)_- field.variants — `fieldVariants`, `fieldLabelVarian…
  - [field](./src/components/field/field.md) — <!-- begin:auto-docs --> _(no submodules)_- field.variants — `fieldVariants`, `fieldLabelVarian…
  - [field.variants](./src/components/field/field.variants.md) — `fieldVariants`, `fieldLabelVariants`, `fieldDescriptionVariants`, and `fieldErrorVariants` are the four cva (class-var…
- [field-group](./src/components/field-group/field-group.md) — <!-- begin:auto-docs --> _(no submodules)_- field-group.variants — `fieldGroupVariants` is the……
  - [field-group](./src/components/field-group/field-group.md) — <!-- begin:auto-docs --> _(no submodules)_- field-group.variants — `fieldGroupVariants` is the……
  - [field-group.variants](./src/components/field-group/field-group.variants.md) — `fieldGroupVariants` is the cva (class-variance-authority) configuration powering every `<FieldGroup>` render. It is sp…
- [field-set](./src/components/field-set/field-set.md) — <!-- begin:auto-docs --> _(no submodules)_- field-set.variants — `fieldSetVariants` and `fieldL…
  - [field-set](./src/components/field-set/field-set.md) — <!-- begin:auto-docs --> _(no submodules)_- field-set.variants — `fieldSetVariants` and `fieldL…
  - [field-set.variants](./src/components/field-set/field-set.variants.md) — `fieldSetVariants` and `fieldLegendVariants` are the cva (class-variance-authority) configurations powering `<FieldSet>…
- [hover-card](./src/components/hover-card/hover-card.md) — <!-- begin:auto-docs --> _(no submodules)_- hover-card.variants — `hoverCardContentVariants` is…
  - [hover-card](./src/components/hover-card/hover-card.md) — <!-- begin:auto-docs --> _(no submodules)_- hover-card.variants — `hoverCardContentVariants` is…
  - [hover-card.variants](./src/components/hover-card/hover-card.variants.md) — `hoverCardContentVariants` is the cva configuration powering the `<HoverCardContent>` floating panel. It is split from…
- [input](./src/components/input/input.md) — <!-- begin:auto-docs --> _(no submodules)_- input-number — <!-- begin:au…
  - [input-number](./src/components/input/input-number/input-number.md) — <!-- begin:auto-docs --> _(no submodules)_- [input-number](./src/components/input/input-number/input-number.md) — <!-- begin:auto-docs --> _(no submodules)_- [input](./src/components/input/input.md) — <!-- begin:auto-docs --> _(no submodules)_- input-number — <!-- begin:au…
  - [input.variants](./src/components/input/input.variants.md) — `inputVariants` is the cva (class-variance-authority) configuration that powers every `<Input>` render. It is split fro…
- [input-group](./src/components/input-group/input-group.md) — <!-- begin:auto-docs --> _(no submodules)_- input-group.variants — `inputGroupVariants`, `input…
  - [input-group](./src/components/input-group/input-group.md) — <!-- begin:auto-docs --> _(no submodules)_- input-group.variants — `inputGroupVariants`, `input…
  - [input-group.variants](./src/components/input-group/input-group.variants.md) — `inputGroupVariants`, `inputGroupAddonVariants`, `inputGroupInputVariants`, `inputGroupTextareaVariants`, and `inputGro…
- [label](./src/components/label/label.md) — <!-- begin:auto-docs --> _(no submodules)_- label.variants — `labelVariants` is the cva (class-…
  - [label](./src/components/label/label.md) — <!-- begin:auto-docs --> _(no submodules)_- label.variants — `labelVariants` is the cva (class-…
  - [label.variants](./src/components/label/label.variants.md) — `labelVariants` is the cva (class-variance-authority) configuration that powers every `<Label>` render. It is split fro…
- [menubar](./src/components/menubar/menubar.md) — <!-- begin:auto-docs --> _(no submodules)_- menubar.variants — `menubarVariants`, `menubarTrigg…
  - [menubar](./src/components/menubar/menubar.md) — <!-- begin:auto-docs --> _(no submodules)_- menubar.variants — `menubarVariants`, `menubarTrigg…
  - [menubar.variants](./src/components/menubar/menubar.variants.md) — `menubarVariants`, `menubarTriggerVariants`, `menubarContentVariants`, `menubarItemVariants`, `menubarLabelVariants`, `…
- [pagination](./src/components/pagination/pagination.md) — <!-- begin:auto-docs --> _(no submodules)_- pagination.variants — `paginationVariants`, `pagina…
  - [pagination](./src/components/pagination/pagination.md) — <!-- begin:auto-docs --> _(no submodules)_- pagination.variants — `paginationVariants`, `pagina…
  - [pagination.variants](./src/components/pagination/pagination.variants.md) — `paginationVariants`, `paginationContentVariants`, `paginationItemVariants`, `paginationLinkVariants`, `paginationPrevN…
- [popover](./src/components/popover/popover.md) — <!-- begin:auto-docs --> _(no submodules)_- popover.variants — `popoverContentVariants` is the……
  - [popover](./src/components/popover/popover.md) — <!-- begin:auto-docs --> _(no submodules)_- popover.variants — `popoverContentVariants` is the……
  - [popover.variants](./src/components/popover/popover.variants.md) — `popoverContentVariants` is the cva configuration powering the `<PopoverContent>` floating panel. It is split from `pop…
- [progress](./src/components/progress/progress.md) — <!-- begin:auto-docs --> _(no submodules)_- progress.variants — `progressVariants` is the cva c…
  - [progress](./src/components/progress/progress.md) — <!-- begin:auto-docs --> _(no submodules)_- progress.variants — `progressVariants` is the cva c…
  - [progress.variants](./src/components/progress/progress.variants.md) — `progressVariants` is the cva config that powers the `<Progress>` chassis component (paired with `progressIndicatorVari…
- [radio-group](./src/components/radio-group/radio-group.md) — <!-- begin:auto-docs --> _(no submodules)_- radio-group.variants — `radioGroupVariants` and `ra…
  - [radio-group](./src/components/radio-group/radio-group.md) — <!-- begin:auto-docs --> _(no submodules)_- radio-group.variants — `radioGroupVariants` and `ra…
  - [radio-group.variants](./src/components/radio-group/radio-group.variants.md) — `radioGroupVariants` and `radioGroupItemVariants` are the cva (class-variance-authority) configurations powering `<Radi…
- [resizable](./src/components/resizable/resizable.md) — <!-- begin:auto-docs --> _(no submodules)_- resizable.variants — `resizablePanelGroupVariants`,…
  - [resizable](./src/components/resizable/resizable.md) — <!-- begin:auto-docs --> _(no submodules)_- resizable.variants — `resizablePanelGroupVariants`,…
  - [resizable.variants](./src/components/resizable/resizable.variants.md) — `resizablePanelGroupVariants`, `resizablePanelVariants`, `resizableHandleVariants`, and `resizableHandleGripVariants` a…
- [scroll-area](./src/components/scroll-area/scroll-area.md) — <!-- begin:auto-docs --> _(no submodules)_- scroll-area.variants — `scrollAreaVariants`, `scrol…
  - [scroll-area](./src/components/scroll-area/scroll-area.md) — <!-- begin:auto-docs --> _(no submodules)_- scroll-area.variants — `scrollAreaVariants`, `scrol…
  - [scroll-area.variants](./src/components/scroll-area/scroll-area.variants.md) — `scrollAreaVariants`, `scrollAreaViewportVariants`, `scrollAreaScrollbarVariants`, `scrollAreaThumbVariants`, and `scro…
- [select](./src/components/select/select.md) — <!-- begin:auto-docs --> _(no submodules)_- select.test-fixtures — Wave-3h local test fixture t…
  - [select](./src/components/select/select.md) — <!-- begin:auto-docs --> _(no submodules)_- select.test-fixtures — Wave-3h local test fixture t…
  - [select.test-fixtures](./src/components/select/select.test-fixtures.md) — Wave-3h local test fixture that augments the chassis test i18n instance with the `react-ui.select.placeholder` key. The…
  - [select.variants](./src/components/select/select.variants.md) — The `<Select>` component is composed of six visual slots — trigger, content panel, item row, group label, separator, an…
- [separator](./src/components/separator/separator.md) — <!-- begin:auto-docs --> _(no submodules)_- separator.variants — `separatorVariants` is the cva…
  - [separator](./src/components/separator/separator.md) — <!-- begin:auto-docs --> _(no submodules)_- separator.variants — `separatorVariants` is the cva…
  - [separator.variants](./src/components/separator/separator.variants.md) — `separatorVariants` is the cva (class-variance-authority) configuration that powers every `<Separator>` render. It is s…
- [sheet](./src/components/sheet/sheet.md) — <!-- begin:auto-docs --> _(no submodules)_- sheet.variants — `sheetOverlayVariants`, `sheetCont…
  - [sheet](./src/components/sheet/sheet.md) — <!-- begin:auto-docs --> _(no submodules)_- sheet.variants — `sheetOverlayVariants`, `sheetCont…
  - [sheet.variants](./src/components/sheet/sheet.variants.md) — `sheetOverlayVariants`, `sheetContentVariants`, `sheetHeaderVariants`, `sheetFooterVariants`, `sheetTitleVariants`, `sh…
- [skeleton](./src/components/skeleton/skeleton.md) — <!-- begin:auto-docs --> _(no submodules)_- skeleton.variants — `skeletonVariants` is the cva (…
  - [skeleton](./src/components/skeleton/skeleton.md) — <!-- begin:auto-docs --> _(no submodules)_- skeleton.variants — `skeletonVariants` is the cva (…
  - [skeleton.variants](./src/components/skeleton/skeleton.variants.md) — `skeletonVariants` is the cva (class-variance-authority) configuration that powers every `<Skeleton>` render. It is spl…
- [sonner](./src/components/sonner/sonner.md) — <!-- begin:auto-docs --> _(no submodules)_- sonner.variants — Defines the `sonnerToasterVariant…
  - [sonner](./src/components/sonner/sonner.md) — <!-- begin:auto-docs --> _(no submodules)_- sonner.variants — Defines the `sonnerToasterVariant…
  - [sonner.variants](./src/components/sonner/sonner.variants.md) — Defines the `sonnerToasterVariants` cva slot for the chassis `<Sonner>` toaster host. Sonner manages its own stacking,…
- [spinner](./src/components/spinner/spinner.md) — <!-- begin:auto-docs --> _(no submodules)_- spinner.variants — `spinnerVariants` is the cva con…
  - [spinner](./src/components/spinner/spinner.md) — <!-- begin:auto-docs --> _(no submodules)_- spinner.variants — `spinnerVariants` is the cva con…
  - [spinner.variants](./src/components/spinner/spinner.variants.md) — `spinnerVariants` is the cva config that powers the `<Spinner>` chassis component. It exposes a `size` axis (`sm` / `de…
- [status-badge](./src/components/status-badge/status-badge.md) — <!-- begin:auto-docs --> _(no submodules)_- status-badge.variants — `statusBadgeVariants` is th…
  - [status-badge](./src/components/status-badge/status-badge.md) — <!-- begin:auto-docs --> _(no submodules)_- status-badge.variants — `statusBadgeVariants` is th…
  - [status-badge.variants](./src/components/status-badge/status-badge.variants.md) — `statusBadgeVariants` is the cva config that powers the `<StatusBadge>` chassis component. It exposes a `status` axis w…
- [switch](./src/components/switch/switch.md) — <!-- begin:auto-docs --> _(no submodules)_- switch.variants — `switchVariants` and `switchThumb…
  - [switch](./src/components/switch/switch.md) — <!-- begin:auto-docs --> _(no submodules)_- switch.variants — `switchVariants` and `switchThumb…
  - [switch.variants](./src/components/switch/switch.variants.md) — `switchVariants` and `switchThumbVariants` are the two cva (class-variance-authority) configurations that together powe…
- [table](./src/components/table/table.md) — <!-- begin:auto-docs --> _(no submodules)_- table.variants — `tableVariants` and its eight sub-…
  - [table](./src/components/table/table.md) — <!-- begin:auto-docs --> _(no submodules)_- table.variants — `tableVariants` and its eight sub-…
  - [table.variants](./src/components/table/table.variants.md) — `tableVariants` and its eight sub-component cva resolvers (`tableHeaderVariants`, `tableBodyVariants`, `tableFooterVari…
- [tabs](./src/components/tabs/tabs.md) — <!-- begin:auto-docs --> _(no submodules)_- tabs.variants — `tabsVariants`, `tabsListVariants`,…
  - [tabs](./src/components/tabs/tabs.md) — <!-- begin:auto-docs --> _(no submodules)_- tabs.variants — `tabsVariants`, `tabsListVariants`,…
  - [tabs.variants](./src/components/tabs/tabs.variants.md) — `tabsVariants`, `tabsListVariants`, `tabsTriggerVariants`, and `tabsContentVariants` are the cva (class-variance-author…
- [textarea](./src/components/textarea/textarea.md) — <!-- begin:auto-docs --> _(no submodules)_- textarea.variants — `textareaVariants` is the cva (…
  - [textarea](./src/components/textarea/textarea.md) — <!-- begin:auto-docs --> _(no submodules)_- textarea.variants — `textareaVariants` is the cva (…
  - [textarea.variants](./src/components/textarea/textarea.variants.md) — `textareaVariants` is the cva (class-variance-authority) configuration that powers every `<Textarea>` render. It is spl…
- [theme-toggle](./src/components/theme-toggle/theme-toggle.md) — <!-- begin:auto-docs --> _(no submodules)_- theme-toggle.variants — Cva slot for the chassis `<…
  - [theme-toggle](./src/components/theme-toggle/theme-toggle.md) — <!-- begin:auto-docs --> _(no submodules)_- theme-toggle.variants — Cva slot for the chassis `<…
  - [theme-toggle.variants](./src/components/theme-toggle/theme-toggle.variants.md) — Cva slot for the chassis `<ThemeToggle>` icon-button. Mirrors the shape of `<Button variant="outline" size="icon">` so…
- [toast](./src/components/toast/toast.md) — <!-- begin:auto-docs --> _(no submodules)_- [toast](./src/components/toast/toast.md) — <!-- begin:auto-docs --> _(no submodules)_- [toggle](./src/components/toggle/toggle.md) — <!-- begin:auto-docs --> _(no submodules)_- toggle.variants — `toggleVariants` is the cva (clas…
  - [toggle](./src/components/toggle/toggle.md) — <!-- begin:auto-docs --> _(no submodules)_- toggle.variants — `toggleVariants` is the cva (clas…
  - [toggle.variants](./src/components/toggle/toggle.variants.md) — `toggleVariants` is the cva (class-variance-authority) configuration powering every `<Toggle>` render. It is split from…
- [toggle-group](./src/components/toggle-group/toggle-group.md) — <!-- begin:auto-docs --> _(no submodules)_- toggle-group.variants — `toggleGroupVariants` and `…
  - [toggle-group](./src/components/toggle-group/toggle-group.md) — <!-- begin:auto-docs --> _(no submodules)_- toggle-group.variants — `toggleGroupVariants` and `…
  - [toggle-group.variants](./src/components/toggle-group/toggle-group.variants.md) — `toggleGroupVariants` and `toggleGroupItemVariants` are the cva (class-variance-authority) configurations powering `<To…
- [tooltip](./src/components/tooltip/tooltip.md) — <!-- begin:auto-docs --> _(no submodules)_- tooltip.variants — `tooltipContentVariants` is the……
  - [tooltip](./src/components/tooltip/tooltip.md) — <!-- begin:auto-docs --> _(no submodules)_- tooltip.variants — `tooltipContentVariants` is the……
  - [tooltip.variants](./src/components/tooltip/tooltip.variants.md) — `tooltipContentVariants` is the cva configuration powering the `<TooltipContent>` floating bubble. It is split from `to…
- [use-toast-sonner-bridge](./src/components/use-toast-sonner-bridge/use-toast-sonner-bridge.md) — <!-- begin:auto-docs --> _(no submodules)_- [use-toast-sonner-bridge](./src/components/use-toast-sonner-bridge/use-toast-sonner-bridge.md) — <!-- begin:auto-docs --> _(no submodules)_- [error-codes](./src/errors/error-codes.md) — Defines every stable error code emitted by the `@suaveplan/react-ui` package. Codes are grouped under the `REACT_UI` na…
- [react-ui-error](./src/errors/react-ui-error.md) — Owns every error thrown by the `@suaveplan/react-ui` package. Extends the project-wide `SuaveplanError` so each instan…
- [use-mobile](./src/hooks/use-mobile/use-mobile.md) — <!-- begin:auto-docs --> _(no submodules)_- [use-mobile](./src/hooks/use-mobile/use-mobile.md) — <!-- begin:auto-docs --> _(no submodules)_- [use-toast](./src/hooks/use-toast/use-toast.md) — <!-- begin:auto-docs --> _(no submodules)_- [use-toast](./src/hooks/use-toast/use-toast.md) — <!-- begin:auto-docs --> _(no submodules)_- [formatted-cell](./src/i18n/formatted-cell/formatted-cell.md) — <!-- begin:auto-docs --> _(no submodules)_- [formatted-cell](./src/i18n/formatted-cell/formatted-cell.md) — <!-- begin:auto-docs --> _(no submodules)_- [formatted-currency](./src/i18n/formatted-currency/formatted-currency.md) — <!-- begin:auto-docs --> _(no submodules)_- [formatted-currency](./src/i18n/formatted-currency/formatted-currency.md) — <!-- begin:auto-docs --> _(no submodules)_- [formatted-date](./src/i18n/formatted-date/formatted-date.md) — <!-- begin:auto-docs --> _(no submodules)_- [formatted-date](./src/i18n/formatted-date/formatted-date.md) — <!-- begin:auto-docs --> _(no submodules)_- [formatted-list](./src/i18n/formatted-list/formatted-list.md) — <!-- begin:auto-docs --> _(no submodules)_- [formatted-list](./src/i18n/formatted-list/formatted-list.md) — <!-- begin:auto-docs --> _(no submodules)_- [formatted-message](./src/i18n/formatted-message/formatted-message.md) — <!-- begin:auto-docs --> _(no submodules)_- [formatted-message](./src/i18n/formatted-message/formatted-message.md) — <!-- begin:auto-docs --> _(no submodules)_- [formatted-number](./src/i18n/formatted-number/formatted-number.md) — <!-- begin:auto-docs --> _(no submodules)_- [formatted-number](./src/i18n/formatted-number/formatted-number.md) — <!-- begin:auto-docs --> _(no submodules)_- [formatted-relative-time](./src/i18n/formatted-relative-time/formatted-relative-time.md) — <!-- begin:auto-docs --> _(no submodules)_- [formatted-relative-time](./src/i18n/formatted-relative-time/formatted-relative-time.md) — <!-- begin:auto-docs --> _(no submodules)_- [plural](./src/i18n/plural/plural.md) — <!-- begin:auto-docs --> _(no submodules)_- [plural](./src/i18n/plural/plural.md) — <!-- begin:auto-docs --> _(no submodules)_- [react-ui-i18n-bridge](./src/i18n/react-ui-i18n-bridge/react-ui-i18n-bridge.md) — <!-- begin:auto-docs --> _(no submodules)_- [react-ui-i18n-bridge](./src/i18n/react-ui-i18n-bridge/react-ui-i18n-bridge.md) — <!-- begin:auto-docs --> _(no submodules)_- [stories-shell](./src/i18n/stories-shell/stories-shell.md) — <!-- begin:auto-docs --> _(no submodules)_- [stories-shell](./src/i18n/stories-shell/stories-shell.md) — <!-- begin:auto-docs --> _(no submodules)_- [tanstack-bridge](./src/i18n/tanstack-bridge/tanstack-bridge.md) — <!-- begin:auto-docs --> _(no submodules)_- [tanstack-bridge](./src/i18n/tanstack-bridge/tanstack-bridge.md) — <!-- begin:auto-docs --> _(no submodules)_- [validation-message-bridge](./src/i18n/validation-message-bridge/validation-message-bridge.md) — <!-- begin:auto-docs --> _(no submodules)_- [validation-message-bridge](./src/i18n/validation-message-bridge/validation-message-bridge.md) — <!-- begin:auto-docs --> _(no submodules)_- [augmentation](./src/locales/augmentation.md) — Side-effect-only TypeScript module that augments `@suaveplan/react-i18n`'s `ContributedTranslationKeys` interface with…
- [schema](./src/locales/schema.md) — Zod schema asserting that every locale bundle declares exactly the keys present in the canonical `en-GB.json` source-of…
- [translation-keys](./src/locales/translation-keys.md) — `translation-keys.ts` is the codegen-emitted string-literal union of every translation key contributed by `@suaveplan/r…
- [observability](./src/observability/react-ui-metrics.md) — <!-- begin:auto-docs --> _(no submodules)_- [react-ui-metrics](./src/observability/react-ui-metrics.md) — <!-- begin:auto-docs --> _(no submodules)_- [pack](./src/pack/pack-context.md) — <!-- begin:auto-docs --> _(no submodules)_- pack-registry-provider — <!-…
  - [pack-registry-provider](./src/pack/pack-registry-provider/pack-registry-provider.md) — <!-- begin:auto-docs --> _(no submodules)_- [pack-registry-provider](./src/pack/pack-registry-provider/pack-registry-provider.md) — <!-- begin:auto-docs --> _(no submodules)_- [runtime-override](./src/pack/runtime-override/runtime-override.md) — <!-- begin:auto-docs --> _(no submodules)_- [runtime-override](./src/pack/runtime-override/runtime-override.md) — <!-- begin:auto-docs --> _(no submodules)_- [use-pack-component](./src/pack/use-pack-component/use-pack-component.md) — <!-- begin:auto-docs --> _(no submodules)_- [use-pack-component](./src/pack/use-pack-component/use-pack-component.md) — <!-- begin:auto-docs --> _(no submodules)_- [version-check](./src/pack/version-check/version-check.md) — <!-- begin:auto-docs --> _(no submodules)_- [version-check](./src/pack/version-check/version-check.md) — <!-- begin:auto-docs --> _(no submodules)_- [pack-context](./src/pack/pack-context.md) — <!-- begin:auto-docs --> _(no submodules)_- pack-registry-provider — <!-…
- [react-ui-provider](./src/provider/react-ui-provider/react-ui-provider.md) — <!-- begin:auto-docs --> _(no submodules)_- [react-ui-provider](./src/provider/react-ui-provider/react-ui-provider.md) — <!-- begin:auto-docs --> _(no submodules)_- [theme](./src/theme/theme-context.md) — <!-- begin:auto-docs --> _(no submodules)_- theme-provider — <!-- begin:…
  - [theme-provider](./src/theme/theme-provider/theme-provider.md) — <!-- begin:auto-docs --> _(no submodules)_- [theme-provider](./src/theme/theme-provider/theme-provider.md) — <!-- begin:auto-docs --> _(no submodules)_- [theme-switcher](./src/theme/theme-switcher/theme-switcher.md) — <!-- begin:auto-docs --> _(no submodules)_- [theme-switcher](./src/theme/theme-switcher/theme-switcher.md) — <!-- begin:auto-docs --> _(no submodules)_- [dark](./src/theme/themes/dark.md) — The dark counterpart of `lightTheme`. Same variant surface, same token names, lightness anchors inverted so foreground…
  - [high-contrast](./src/theme/themes/high-contrast.md) — Accessibility-first theme that meets WCAG AAA contrast for normal and large text alike. Pure-white foreground (`#FFFFFF…
  - [light](./src/theme/themes/light.md) — The default `ThemePlugin` instance shipped with `@suaveplan/react-ui`. `lightTheme` matches the shadcn `nova` token pre…
  - [use-theme](./src/theme/use-theme/use-theme.md) — <!-- begin:auto-docs --> _(no submodules)_- [use-theme](./src/theme/use-theme/use-theme.md) — <!-- begin:auto-docs --> _(no submodules)_- [use-theme-tokens](./src/theme/use-theme-tokens/use-theme-tokens.md) — <!-- begin:auto-docs --> _(no submodules)_- [use-theme-tokens](./src/theme/use-theme-tokens/use-theme-tokens.md) — <!-- begin:auto-docs --> _(no submodules)_- [use-themed-variants](./src/theme/use-themed-variants/use-themed-variants.md) — <!-- begin:auto-docs --> _(no submodules)_- [use-themed-variants](./src/theme/use-themed-variants/use-themed-variants.md) — <!-- begin:auto-docs --> _(no submodules)_- [theme-context](./src/theme/theme-context.md) — <!-- begin:auto-docs --> _(no submodules)_- theme-provider — <!-- begin:…
- [cn](./src/utils/cn/cn.md) — <!-- begin:auto-docs --> _(no submodules)_- [cn](./src/utils/cn/cn.md) — <!-- begin:auto-docs --> _(no submodules)_- [motion](./src/utils/motion/motion.md) — <!-- begin:auto-docs --> _(no submodules)_- [motion](./src/utils/motion/motion.md) — <!-- begin:auto-docs --> _(no submodules)_- [variants](./src/variants/variants.md) — <!-- begin:auto-docs --> _(no submodules)_- [variants](./src/variants/variants.md) — <!-- begin:auto-docs --> _(no submodules)_- [version](./src/version.md) — Declares the running version of `@suaveplan/react-ui` as the constant `REACT_UI_VERSION`. The version is hand-maintaine…

- accordion.variants — `accordionVariants`, `accordio…

- [accordion](./src/components/accordion/accordion.md) — <!-- begin:auto-docs --> _(no submodules)_- accordion.variants — `accordionVariants`, `accordio…
- [accordion.variants](./src/components/accordion/accordion.variants.md) — `accordionVariants`, `accordionItemVariants`, `accordionHeaderVariants`, `accordionTriggerVariants`, and `accordionCont…
- [alert](./src/components/alert/alert.md) — <!-- begin:auto-docs --> _(no submodules)_- alert.variants — `alertVariants` is the cva config…
  - [alert](./src/components/alert/alert.md) — <!-- begin:auto-docs --> _(no submodules)_- alert.variants — `alertVariants` is the cva config…
  - [alert.variants](./src/components/alert/alert.variants.md) — `alertVariants` is the cva config that powers the `<Alert>` chassis component. It exposes a `variant` axis with four ru…
- [alert-dialog](./src/components/alert-dialog/alert-dialog.md) — <!-- begin:auto-docs --> _(no submodules)_- alert-dialog.variants — `alertDialogOverlayVariants…
  - [alert-dialog](./src/components/alert-dialog/alert-dialog.md) — <!-- begin:auto-docs --> _(no submodules)_- alert-dialog.variants — `alertDialogOverlayVariants…
  - [alert-dialog.variants](./src/components/alert-dialog/alert-dialog.variants.md) — `alertDialogOverlayVariants`, `alertDialogContentVariants`, `alertDialogHeaderVariants`, `alertDialogFooterVariants`, `…
- [aspect-ratio](./src/components/aspect-ratio/aspect-ratio.md) — <!-- begin:auto-docs --> _(no submodules)_- aspect-ratio.variants — `aspectRatioVariants` is th…
  - [aspect-ratio](./src/components/aspect-ratio/aspect-ratio.md) — <!-- begin:auto-docs --> _(no submodules)_- aspect-ratio.variants — `aspectRatioVariants` is th…
  - [aspect-ratio.variants](./src/components/aspect-ratio/aspect-ratio.variants.md) — `aspectRatioVariants` is the cva (class-variance-authority) configuration powering the `<AspectRatio>` outer wrapper. I…
- [avatar](./src/components/avatar/avatar.md) — <!-- begin:auto-docs --> _(no submodules)_- avatar.variants — `avatarVariants` is the cva confi…
  - [avatar](./src/components/avatar/avatar.md) — <!-- begin:auto-docs --> _(no submodules)_- avatar.variants — `avatarVariants` is the cva confi…
  - [avatar.variants](./src/components/avatar/avatar.variants.md) — `avatarVariants` is the cva config that powers the `<Avatar>` chassis component (`<AvatarImage>` and `<AvatarFallback>`…
- [badge](./src/components/badge/badge.md) — <!-- begin:auto-docs --> _(no submodules)_- badge.variants — `badgeVariants` is the cva config…
  - [badge](./src/components/badge/badge.md) — <!-- begin:auto-docs --> _(no submodules)_- badge.variants — `badgeVariants` is the cva config…
  - [badge.variants](./src/components/badge/badge.variants.md) — `badgeVariants` is the cva config that powers the `<Badge>` chassis component. It exposes a `variant` axis with four ru…
- [breadcrumb](./src/components/breadcrumb/breadcrumb.md) — <!-- begin:auto-docs --> _(no submodules)_- breadcrumb.variants — `breadcrumbVariants`, `breadc…
  - [breadcrumb](./src/components/breadcrumb/breadcrumb.md) — <!-- begin:auto-docs --> _(no submodules)_- breadcrumb.variants — `breadcrumbVariants`, `breadc…
  - [breadcrumb.variants](./src/components/breadcrumb/breadcrumb.variants.md) — `breadcrumbVariants`, `breadcrumbListVariants`, `breadcrumbItemVariants`, `breadcrumbLinkVariants`, `breadcrumbPageVari…
- [button](./src/components/button/button.md) — <!-- begin:auto-docs --> _(no submodules)_- button.variants — `buttonVariants` is the cva (clas…
  - [button](./src/components/button/button.md) — <!-- begin:auto-docs --> _(no submodules)_- button.variants — `buttonVariants` is the cva (clas…
  - [button.variants](./src/components/button/button.variants.md) — `buttonVariants` is the cva (class-variance-authority) configuration that powers every `<Button>` render. It is split f…
- [calendar](./src/components/calendar/calendar.md) — <!-- begin:auto-docs --> _(no submodules)_- calendar.test-fixtures — Wave-3h local test fixture…
  - [calendar](./src/components/calendar/calendar.md) — <!-- begin:auto-docs --> _(no submodules)_- calendar.test-fixtures — Wave-3h local test fixture…
  - [calendar.test-fixtures](./src/components/calendar/calendar.test-fixtures.md) — Wave-3h local test fixture that augments the chassis test i18n instance with the `react-ui.calendar.*` keyset. The chas…
  - [calendar.variants](./src/components/calendar/calendar.variants.md) — `calendarVariants` is the cva config that powers the outer wrapper of `<Calendar>`. The recipe is intentionally minimal…
- [card](./src/components/card/card.md) — <!-- begin:auto-docs --> _(no submodules)_- card.variants — `cardVariants` (and its sub-compone…
  - [card](./src/components/card/card.md) — <!-- begin:auto-docs --> _(no submodules)_- card.variants — `cardVariants` (and its sub-compone…
  - [card.variants](./src/components/card/card.variants.md) — `cardVariants` (and its sub-component cva resolvers `cardHeaderVariants`, `cardTitleVariants`, `cardDescriptionVariants…
- [checkbox](./src/components/checkbox/checkbox.md) — <!-- begin:auto-docs --> _(no submodules)_- checkbox.variants — `checkboxVariants` is the cva (…
  - [checkbox](./src/components/checkbox/checkbox.md) — <!-- begin:auto-docs --> _(no submodules)_- checkbox.variants — `checkboxVariants` is the cva (…
  - [checkbox.variants](./src/components/checkbox/checkbox.variants.md) — `checkboxVariants` is the cva (class-variance-authority) configuration that powers every `<Checkbox>` render. It is spl…
- [collapsible](./src/components/collapsible/collapsible.md) — <!-- begin:auto-docs --> _(no submodules)_- collapsible.variants — `collapsibleVariants`, `coll…
  - [collapsible](./src/components/collapsible/collapsible.md) — <!-- begin:auto-docs --> _(no submodules)_- collapsible.variants — `collapsibleVariants`, `coll…
  - [collapsible.variants](./src/components/collapsible/collapsible.variants.md) — `collapsibleVariants`, `collapsibleTriggerVariants`, and `collapsibleContentVariants` are the cva (class-variance-autho…
- [confirm-delete-dialog](./src/components/confirm-delete-dialog/confirm-delete-dialog.md) — <!-- begin:auto-docs --> _(no submodules)_- confirm-delete-dialog.test-fixtures — Wave-3g local…
  - [confirm-delete-dialog](./src/components/confirm-delete-dialog/confirm-delete-dialog.md) — <!-- begin:auto-docs --> _(no submodules)_- confirm-delete-dialog.test-fixtures — Wave-3g local…
  - [confirm-delete-dialog.test-fixtures](./src/components/confirm-delete-dialog/confirm-delete-dialog.test-fixtures.md) — Wave-3g local test fixture that augments the chassis test i18n instance with the `react-ui.confirmDelete.*` keyset. The…
- [context-menu](./src/components/context-menu/context-menu.md) — <!-- begin:auto-docs --> _(no submodules)_- context-menu.variants — `contextMenuContentVariants…
  - [context-menu](./src/components/context-menu/context-menu.md) — <!-- begin:auto-docs --> _(no submodules)_- context-menu.variants — `contextMenuContentVariants…
  - [context-menu.variants](./src/components/context-menu/context-menu.variants.md) — `contextMenuContentVariants`, `contextMenuItemVariants`, `contextMenuLabelVariants`, `contextMenuSeparatorVariants`, `c…
- [data-table](./src/components/data-table/data-table.md) — <!-- begin:auto-docs --> _(no submodules)_- data-table.variants — `dataTableVariants`, `dataTab…
  - [data-table](./src/components/data-table/data-table.md) — <!-- begin:auto-docs --> _(no submodules)_- data-table.variants — `dataTableVariants`, `dataTab…
  - [data-table.variants](./src/components/data-table/data-table.variants.md) — `dataTableVariants`, `dataTablePaginationVariants`, and `dataTableSortHeaderVariants` drive the chassis `<DataTable>` o…
- [dialog](./src/components/dialog/dialog.md) — <!-- begin:auto-docs --> _(no submodules)_- dialog.variants — `dialogOverlayVariants`, `dialogC…
  - [dialog](./src/components/dialog/dialog.md) — <!-- begin:auto-docs --> _(no submodules)_- dialog.variants — `dialogOverlayVariants`, `dialogC…
  - [dialog.variants](./src/components/dialog/dialog.variants.md) — `dialogOverlayVariants`, `dialogContentVariants`, `dialogHeaderVariants`, `dialogFooterVariants`, `dialogTitleVariants`…
- [drawer](./src/components/drawer/drawer.md) — <!-- begin:auto-docs --> _(no submodules)_- drawer.variants — `drawerOverlayVariants`, `drawerC…
  - [drawer](./src/components/drawer/drawer.md) — <!-- begin:auto-docs --> _(no submodules)_- drawer.variants — `drawerOverlayVariants`, `drawerC…
  - [drawer.variants](./src/components/drawer/drawer.variants.md) — `drawerOverlayVariants`, `drawerContentVariants`, `drawerHandleVariants`, `drawerHeaderVariants`, `drawerFooterVariants…
- [dropdown-menu](./src/components/dropdown-menu/dropdown-menu.md) — <!-- begin:auto-docs --> _(no submodules)_- dropdown-menu.variants — `dropdownMenuContentVarian…
  - [dropdown-menu](./src/components/dropdown-menu/dropdown-menu.md) — <!-- begin:auto-docs --> _(no submodules)_- dropdown-menu.variants — `dropdownMenuContentVarian…
  - [dropdown-menu.variants](./src/components/dropdown-menu/dropdown-menu.variants.md) — `dropdownMenuContentVariants`, `dropdownMenuItemVariants`, `dropdownMenuLabelVariants`, `dropdownMenuSeparatorVariants`…
- [empty](./src/components/empty/empty.md) — <!-- begin:auto-docs --> _(no submodules)_- empty.variants — `emptyVariants` is the cva config…
  - [empty](./src/components/empty/empty.md) — <!-- begin:auto-docs --> _(no submodules)_- empty.variants — `emptyVariants` is the cva config…
  - [empty.variants](./src/components/empty/empty.variants.md) — `emptyVariants` is the cva config that powers the `<Empty>` chassis component (with `emptyHeaderVariants`, `emptyMediaV…
- [error-boundary](./src/components/error-boundary/error-boundary.md) — <!-- begin:auto-docs --> _(no submodules)_- error-boundary.metrics — Co-located OTel counter fo…
  - [error-boundary](./src/components/error-boundary/error-boundary.md) — <!-- begin:auto-docs --> _(no submodules)_- error-boundary.metrics — Co-located OTel counter fo…
  - [error-boundary.metrics](./src/components/error-boundary/error-boundary.metrics.md) — Co-located OTel counter for the chassis `<ErrorBoundary>` component. Lives next to the boundary itself rather than in t…
  - [error-boundary.test-fixtures](./src/components/error-boundary/error-boundary.test-fixtures.md) — Wave-3g local test fixture that augments the chassis test i18n instance with the `react-ui.errorBoundary.*` keyset. The…
  - [error-boundary.variants](./src/components/error-boundary/error-boundary.variants.md) — Cva slot definitions for the chassis `<ErrorBoundary>` default fallback. Splits the fallback into four named slots — ou…
- [field](./src/components/field/field.md) — <!-- begin:auto-docs --> _(no submodules)_- field.variants — `fieldVariants`, `fieldLabelVarian…
  - [field](./src/components/field/field.md) — <!-- begin:auto-docs --> _(no submodules)_- field.variants — `fieldVariants`, `fieldLabelVarian…
  - [field.variants](./src/components/field/field.variants.md) — `fieldVariants`, `fieldLabelVariants`, `fieldDescriptionVariants`, and `fieldErrorVariants` are the four cva (class-var…
- [field-group](./src/components/field-group/field-group.md) — <!-- begin:auto-docs --> _(no submodules)_- field-group.variants — `fieldGroupVariants` is the…
  - [field-group](./src/components/field-group/field-group.md) — <!-- begin:auto-docs --> _(no submodules)_- field-group.variants — `fieldGroupVariants` is the…
  - [field-group.variants](./src/components/field-group/field-group.variants.md) — `fieldGroupVariants` is the cva (class-variance-authority) configuration powering every `<FieldGroup>` render. It is sp…
- [field-set](./src/components/field-set/field-set.md) — <!-- begin:auto-docs --> _(no submodules)_- field-set.variants — `fieldSetVariants` and `fieldL…
  - [field-set](./src/components/field-set/field-set.md) — <!-- begin:auto-docs --> _(no submodules)_- field-set.variants — `fieldSetVariants` and `fieldL…
  - [field-set.variants](./src/components/field-set/field-set.variants.md) — `fieldSetVariants` and `fieldLegendVariants` are the cva (class-variance-authority) configurations powering `<FieldSet>…
- [hover-card](./src/components/hover-card/hover-card.md) — <!-- begin:auto-docs --> _(no submodules)_- hover-card.variants — `hoverCardContentVariants` is…
  - [hover-card](./src/components/hover-card/hover-card.md) — <!-- begin:auto-docs --> _(no submodules)_- hover-card.variants — `hoverCardContentVariants` is…
  - [hover-card.variants](./src/components/hover-card/hover-card.variants.md) — `hoverCardContentVariants` is the cva configuration powering the `<HoverCardContent>` floating panel. It is split from…
- [input](./src/components/input/input.md) — <!-- begin:auto-docs --> _(no submodules)_- input-number — <!-- begin:auto-docs --> _(no submod…
  - [input-number](./src/components/input/input-number/input-number.md) — <!-- begin:auto-docs --> _(no submodules)_- [input-number](./src/components/input/input-number/input-number.md) — <!-- begin:auto-docs --> _(no submodules)_- [input](./src/components/input/input.md) — <!-- begin:auto-docs --> _(no submodules)_- input-number — <!-- begin:auto-docs --> _(no submod…
  - [input.variants](./src/components/input/input.variants.md) — `inputVariants` is the cva (class-variance-authority) configuration that powers every `<Input>` render. It is split fro…
- [input-group](./src/components/input-group/input-group.md) — <!-- begin:auto-docs --> _(no submodules)_- input-group.variants — `inputGroupVariants`, `input…
  - [input-group](./src/components/input-group/input-group.md) — <!-- begin:auto-docs --> _(no submodules)_- input-group.variants — `inputGroupVariants`, `input…
  - [input-group.variants](./src/components/input-group/input-group.variants.md) — `inputGroupVariants`, `inputGroupAddonVariants`, `inputGroupInputVariants`, `inputGroupTextareaVariants`, and `inputGro…
- [label](./src/components/label/label.md) — <!-- begin:auto-docs --> _(no submodules)_- label.variants — `labelVariants` is the cva (class-…
  - [label](./src/components/label/label.md) — <!-- begin:auto-docs --> _(no submodules)_- label.variants — `labelVariants` is the cva (class-…
  - [label.variants](./src/components/label/label.variants.md) — `labelVariants` is the cva (class-variance-authority) configuration that powers every `<Label>` render. It is split fro…
- [menubar](./src/components/menubar/menubar.md) — <!-- begin:auto-docs --> _(no submodules)_- menubar.variants — `menubarVariants`, `menubarTrigg…
  - [menubar](./src/components/menubar/menubar.md) — <!-- begin:auto-docs --> _(no submodules)_- menubar.variants — `menubarVariants`, `menubarTrigg…
  - [menubar.variants](./src/components/menubar/menubar.variants.md) — `menubarVariants`, `menubarTriggerVariants`, `menubarContentVariants`, `menubarItemVariants`, `menubarLabelVariants`, `…
- [pagination](./src/components/pagination/pagination.md) — <!-- begin:auto-docs --> _(no submodules)_- pagination.variants — `paginationVariants`, `pagina…
  - [pagination](./src/components/pagination/pagination.md) — <!-- begin:auto-docs --> _(no submodules)_- pagination.variants — `paginationVariants`, `pagina…
  - [pagination.variants](./src/components/pagination/pagination.variants.md) — `paginationVariants`, `paginationContentVariants`, `paginationItemVariants`, `paginationLinkVariants`, `paginationPrevN…
- [popover](./src/components/popover/popover.md) — <!-- begin:auto-docs --> _(no submodules)_- popover.variants — `popoverContentVariants` is the…
  - [popover](./src/components/popover/popover.md) — <!-- begin:auto-docs --> _(no submodules)_- popover.variants — `popoverContentVariants` is the…
  - [popover.variants](./src/components/popover/popover.variants.md) — `popoverContentVariants` is the cva configuration powering the `<PopoverContent>` floating panel. It is split from `pop…
- [progress](./src/components/progress/progress.md) — <!-- begin:auto-docs --> _(no submodules)_- progress.variants — `progressVariants` is the cva c…
  - [progress](./src/components/progress/progress.md) — <!-- begin:auto-docs --> _(no submodules)_- progress.variants — `progressVariants` is the cva c…
  - [progress.variants](./src/components/progress/progress.variants.md) — `progressVariants` is the cva config that powers the `<Progress>` chassis component (paired with `progressIndicatorVari…
- [radio-group](./src/components/radio-group/radio-group.md) — <!-- begin:auto-docs --> _(no submodules)_- radio-group.variants — `radioGroupVariants` and `ra…
  - [radio-group](./src/components/radio-group/radio-group.md) — <!-- begin:auto-docs --> _(no submodules)_- radio-group.variants — `radioGroupVariants` and `ra…
  - [radio-group.variants](./src/components/radio-group/radio-group.variants.md) — `radioGroupVariants` and `radioGroupItemVariants` are the cva (class-variance-authority) configurations powering `<Radi…
- [resizable](./src/components/resizable/resizable.md) — <!-- begin:auto-docs --> _(no submodules)_- resizable.variants — `resizablePanelGroupVariants`,…
  - [resizable](./src/components/resizable/resizable.md) — <!-- begin:auto-docs --> _(no submodules)_- resizable.variants — `resizablePanelGroupVariants`,…
  - [resizable.variants](./src/components/resizable/resizable.variants.md) — `resizablePanelGroupVariants`, `resizablePanelVariants`, `resizableHandleVariants`, and `resizableHandleGripVariants` a…
- [scroll-area](./src/components/scroll-area/scroll-area.md) — <!-- begin:auto-docs --> _(no submodules)_- scroll-area.variants — `scrollAreaVariants`, `scrol…
  - [scroll-area](./src/components/scroll-area/scroll-area.md) — <!-- begin:auto-docs --> _(no submodules)_- scroll-area.variants — `scrollAreaVariants`, `scrol…
  - [scroll-area.variants](./src/components/scroll-area/scroll-area.variants.md) — `scrollAreaVariants`, `scrollAreaViewportVariants`, `scrollAreaScrollbarVariants`, `scrollAreaThumbVariants`, and `scro…
- [select](./src/components/select/select.md) — <!-- begin:auto-docs --> _(no submodules)_- select.test-fixtures — Wave-3h local test fixture t…
  - [select](./src/components/select/select.md) — <!-- begin:auto-docs --> _(no submodules)_- select.test-fixtures — Wave-3h local test fixture t…
  - [select.test-fixtures](./src/components/select/select.test-fixtures.md) — Wave-3h local test fixture that augments the chassis test i18n instance with the `react-ui.select.placeholder` key. The…
  - [select.variants](./src/components/select/select.variants.md) — The `<Select>` component is composed of six visual slots — trigger, content panel, item row, group label, separator, an…
- [separator](./src/components/separator/separator.md) — <!-- begin:auto-docs --> _(no submodules)_- separator.variants — `separatorVariants` is the cva…
  - [separator](./src/components/separator/separator.md) — <!-- begin:auto-docs --> _(no submodules)_- separator.variants — `separatorVariants` is the cva…
  - [separator.variants](./src/components/separator/separator.variants.md) — `separatorVariants` is the cva (class-variance-authority) configuration that powers every `<Separator>` render. It is s…
- [sheet](./src/components/sheet/sheet.md) — <!-- begin:auto-docs --> _(no submodules)_- sheet.variants — `sheetOverlayVariants`, `sheetCont…
  - [sheet](./src/components/sheet/sheet.md) — <!-- begin:auto-docs --> _(no submodules)_- sheet.variants — `sheetOverlayVariants`, `sheetCont…
  - [sheet.variants](./src/components/sheet/sheet.variants.md) — `sheetOverlayVariants`, `sheetContentVariants`, `sheetHeaderVariants`, `sheetFooterVariants`, `sheetTitleVariants`, `sh…
- [skeleton](./src/components/skeleton/skeleton.md) — <!-- begin:auto-docs --> _(no submodules)_- skeleton.variants — `skeletonVariants` is the cva (…
  - [skeleton](./src/components/skeleton/skeleton.md) — <!-- begin:auto-docs --> _(no submodules)_- skeleton.variants — `skeletonVariants` is the cva (…
  - [skeleton.variants](./src/components/skeleton/skeleton.variants.md) — `skeletonVariants` is the cva (class-variance-authority) configuration that powers every `<Skeleton>` render. It is spl…
- [sonner](./src/components/sonner/sonner.md) — <!-- begin:auto-docs --> _(no submodules)_- sonner.variants — Defines the `sonnerToasterVariant…
  - [sonner](./src/components/sonner/sonner.md) — <!-- begin:auto-docs --> _(no submodules)_- sonner.variants — Defines the `sonnerToasterVariant…
  - [sonner.variants](./src/components/sonner/sonner.variants.md) — Defines the `sonnerToasterVariants` cva slot for the chassis `<Sonner>` toaster host. Sonner manages its own stacking,…
- [spinner](./src/components/spinner/spinner.md) — <!-- begin:auto-docs --> _(no submodules)_- spinner.variants — `spinnerVariants` is the cva con…
  - [spinner](./src/components/spinner/spinner.md) — <!-- begin:auto-docs --> _(no submodules)_- spinner.variants — `spinnerVariants` is the cva con…
  - [spinner.variants](./src/components/spinner/spinner.variants.md) — `spinnerVariants` is the cva config that powers the `<Spinner>` chassis component. It exposes a `size` axis (`sm` / `de…
- [status-badge](./src/components/status-badge/status-badge.md) — <!-- begin:auto-docs --> _(no submodules)_- status-badge.variants — `statusBadgeVariants` is th…
  - [status-badge](./src/components/status-badge/status-badge.md) — <!-- begin:auto-docs --> _(no submodules)_- status-badge.variants — `statusBadgeVariants` is th…
  - [status-badge.variants](./src/components/status-badge/status-badge.variants.md) — `statusBadgeVariants` is the cva config that powers the `<StatusBadge>` chassis component. It exposes a `status` axis w…
- [switch](./src/components/switch/switch.md) — <!-- begin:auto-docs --> _(no submodules)_- switch.variants — `switchVariants` and `switchThumb…
  - [switch](./src/components/switch/switch.md) — <!-- begin:auto-docs --> _(no submodules)_- switch.variants — `switchVariants` and `switchThumb…
  - [switch.variants](./src/components/switch/switch.variants.md) — `switchVariants` and `switchThumbVariants` are the two cva (class-variance-authority) configurations that together powe…
- [table](./src/components/table/table.md) — <!-- begin:auto-docs --> _(no submodules)_- table.variants — `tableVariants` and its eight sub-…
  - [table](./src/components/table/table.md) — <!-- begin:auto-docs --> _(no submodules)_- table.variants — `tableVariants` and its eight sub-…
  - [table.variants](./src/components/table/table.variants.md) — `tableVariants` and its eight sub-component cva resolvers (`tableHeaderVariants`, `tableBodyVariants`, `tableFooterVari…
- [tabs](./src/components/tabs/tabs.md) — <!-- begin:auto-docs --> _(no submodules)_- tabs.variants — `tabsVariants`, `tabsListVariants`,…
  - [tabs](./src/components/tabs/tabs.md) — <!-- begin:auto-docs --> _(no submodules)_- tabs.variants — `tabsVariants`, `tabsListVariants`,…
  - [tabs.variants](./src/components/tabs/tabs.variants.md) — `tabsVariants`, `tabsListVariants`, `tabsTriggerVariants`, and `tabsContentVariants` are the cva (class-variance-author…
- [textarea](./src/components/textarea/textarea.md) — <!-- begin:auto-docs --> _(no submodules)_- textarea.variants — `textareaVariants` is the cva (…
  - [textarea](./src/components/textarea/textarea.md) — <!-- begin:auto-docs --> _(no submodules)_- textarea.variants — `textareaVariants` is the cva (…
  - [textarea.variants](./src/components/textarea/textarea.variants.md) — `textareaVariants` is the cva (class-variance-authority) configuration that powers every `<Textarea>` render. It is spl…
- [theme-toggle](./src/components/theme-toggle/theme-toggle.md) — <!-- begin:auto-docs --> _(no submodules)_- theme-toggle.variants — Cva slot for the chassis `<…
  - [theme-toggle](./src/components/theme-toggle/theme-toggle.md) — <!-- begin:auto-docs --> _(no submodules)_- theme-toggle.variants — Cva slot for the chassis `<…
  - [theme-toggle.variants](./src/components/theme-toggle/theme-toggle.variants.md) — Cva slot for the chassis `<ThemeToggle>` icon-button. Mirrors the shape of `<Button variant="outline" size="icon">` so…
- [toast](./src/components/toast/toast.md) — <!-- begin:auto-docs --> _(no submodules)_- [toast](./src/components/toast/toast.md) — <!-- begin:auto-docs --> _(no submodules)_- [toggle](./src/components/toggle/toggle.md) — <!-- begin:auto-docs --> _(no submodules)_- toggle.variants — `toggleVariants` is the cva (clas…
  - [toggle](./src/components/toggle/toggle.md) — <!-- begin:auto-docs --> _(no submodules)_- toggle.variants — `toggleVariants` is the cva (clas…
  - [toggle.variants](./src/components/toggle/toggle.variants.md) — `toggleVariants` is the cva (class-variance-authority) configuration powering every `<Toggle>` render. It is split from…
- [toggle-group](./src/components/toggle-group/toggle-group.md) — <!-- begin:auto-docs --> _(no submodules)_- toggle-group.variants — `toggleGroupVariants` and `…
  - [toggle-group](./src/components/toggle-group/toggle-group.md) — <!-- begin:auto-docs --> _(no submodules)_- toggle-group.variants — `toggleGroupVariants` and `…
  - [toggle-group.variants](./src/components/toggle-group/toggle-group.variants.md) — `toggleGroupVariants` and `toggleGroupItemVariants` are the cva (class-variance-authority) configurations powering `<To…
- [tooltip](./src/components/tooltip/tooltip.md) — <!-- begin:auto-docs --> _(no submodules)_- tooltip.variants — `tooltipContentVariants` is the…
  - [tooltip](./src/components/tooltip/tooltip.md) — <!-- begin:auto-docs --> _(no submodules)_- tooltip.variants — `tooltipContentVariants` is the…
  - [tooltip.variants](./src/components/tooltip/tooltip.variants.md) — `tooltipContentVariants` is the cva configuration powering the `<TooltipContent>` floating bubble. It is split from `to…
- [use-toast-sonner-bridge](./src/components/use-toast-sonner-bridge/use-toast-sonner-bridge.md) — <!-- begin:auto-docs --> _(no submodules)_- [use-toast-sonner-bridge](./src/components/use-toast-sonner-bridge/use-toast-sonner-bridge.md) — <!-- begin:auto-docs --> _(no submodules)_- [error-codes](./src/errors/error-codes.md) — Defines every stable error code emitted by the `@suaveplan/react-ui` package. Codes are grouped under the `REACT_UI` na…
- [react-ui-error](./src/errors/react-ui-error.md) — Owns every error thrown by the `@suaveplan/react-ui` package. Extends the project-wide `SuaveplanError` so each instan…
- [use-mobile](./src/hooks/use-mobile/use-mobile.md) — <!-- begin:auto-docs --> _(no submodules)_- [use-mobile](./src/hooks/use-mobile/use-mobile.md) — <!-- begin:auto-docs --> _(no submodules)_- [use-toast](./src/hooks/use-toast/use-toast.md) — <!-- begin:auto-docs --> _(no submodules)_- [use-toast](./src/hooks/use-toast/use-toast.md) — <!-- begin:auto-docs --> _(no submodules)_- [formatted-cell](./src/i18n/formatted-cell/formatted-cell.md) — <!-- begin:auto-docs --> _(no submodules)_- [formatted-cell](./src/i18n/formatted-cell/formatted-cell.md) — <!-- begin:auto-docs --> _(no submodules)_- [formatted-currency](./src/i18n/formatted-currency/formatted-currency.md) — <!-- begin:auto-docs --> _(no submodules)_- [formatted-currency](./src/i18n/formatted-currency/formatted-currency.md) — <!-- begin:auto-docs --> _(no submodules)_- [formatted-date](./src/i18n/formatted-date/formatted-date.md) — <!-- begin:auto-docs --> _(no submodules)_- [formatted-date](./src/i18n/formatted-date/formatted-date.md) — <!-- begin:auto-docs --> _(no submodules)_- [formatted-list](./src/i18n/formatted-list/formatted-list.md) — <!-- begin:auto-docs --> _(no submodules)_- [formatted-list](./src/i18n/formatted-list/formatted-list.md) — <!-- begin:auto-docs --> _(no submodules)_- [formatted-message](./src/i18n/formatted-message/formatted-message.md) — <!-- begin:auto-docs --> _(no submodules)_- [formatted-message](./src/i18n/formatted-message/formatted-message.md) — <!-- begin:auto-docs --> _(no submodules)_- [formatted-number](./src/i18n/formatted-number/formatted-number.md) — <!-- begin:auto-docs --> _(no submodules)_- [formatted-number](./src/i18n/formatted-number/formatted-number.md) — <!-- begin:auto-docs --> _(no submodules)_- [formatted-relative-time](./src/i18n/formatted-relative-time/formatted-relative-time.md) — <!-- begin:auto-docs --> _(no submodules)_- [formatted-relative-time](./src/i18n/formatted-relative-time/formatted-relative-time.md) — <!-- begin:auto-docs --> _(no submodules)_- [plural](./src/i18n/plural/plural.md) — <!-- begin:auto-docs --> _(no submodules)_- [plural](./src/i18n/plural/plural.md) — <!-- begin:auto-docs --> _(no submodules)_- [react-ui-i18n-bridge](./src/i18n/react-ui-i18n-bridge/react-ui-i18n-bridge.md) — <!-- begin:auto-docs --> _(no submodules)_- [react-ui-i18n-bridge](./src/i18n/react-ui-i18n-bridge/react-ui-i18n-bridge.md) — <!-- begin:auto-docs --> _(no submodules)_- [stories-shell](./src/i18n/stories-shell/stories-shell.md) — <!-- begin:auto-docs --> _(no submodules)_- [stories-shell](./src/i18n/stories-shell/stories-shell.md) — <!-- begin:auto-docs --> _(no submodules)_- [tanstack-bridge](./src/i18n/tanstack-bridge/tanstack-bridge.md) — <!-- begin:auto-docs --> _(no submodules)_- [tanstack-bridge](./src/i18n/tanstack-bridge/tanstack-bridge.md) — <!-- begin:auto-docs --> _(no submodules)_- [validation-message-bridge](./src/i18n/validation-message-bridge/validation-message-bridge.md) — <!-- begin:auto-docs --> _(no submodules)_- [validation-message-bridge](./src/i18n/validation-message-bridge/validation-message-bridge.md) — <!-- begin:auto-docs --> _(no submodules)_- [augmentation](./src/locales/augmentation.md) — Side-effect-only TypeScript module that augments `@suaveplan/react-i18n`'s `ContributedTranslationKeys` interface with…
- [schema](./src/locales/schema.md) — Zod schema asserting that every locale bundle declares exactly the keys present in the canonical `en-GB.json` source-of…
- [translation-keys](./src/locales/translation-keys.md) — `translation-keys.ts` is the codegen-emitted string-literal union of every translation key contributed by `@suaveplan/r…
- [observability](./src/observability/react-ui-metrics.md) — <!-- begin:auto-docs --> _(no submodules)_- [react-ui-metrics](./src/observability/react-ui-metrics.md) — <!-- begin:auto-docs --> _(no submodules)_- [pack](./src/pack/pack-context.md) — <!-- begin:auto-docs --> _(no submodules)_- pack-registry-provider — <!-- begin:auto-docs --> _…
  - [pack-registry-provider](./src/pack/pack-registry-provider/pack-registry-provider.md) — <!-- begin:auto-docs --> _(no submodules)_- [pack-registry-provider](./src/pack/pack-registry-provider/pack-registry-provider.md) — <!-- begin:auto-docs --> _(no submodules)_- [runtime-override](./src/pack/runtime-override/runtime-override.md) — <!-- begin:auto-docs --> _(no submodules)_- [runtime-override](./src/pack/runtime-override/runtime-override.md) — <!-- begin:auto-docs --> _(no submodules)_- [use-pack-component](./src/pack/use-pack-component/use-pack-component.md) — <!-- begin:auto-docs --> _(no submodules)_- [use-pack-component](./src/pack/use-pack-component/use-pack-component.md) — <!-- begin:auto-docs --> _(no submodules)_- [version-check](./src/pack/version-check/version-check.md) — <!-- begin:auto-docs --> _(no submodules)_- [version-check](./src/pack/version-check/version-check.md) — <!-- begin:auto-docs --> _(no submodules)_- [pack-context](./src/pack/pack-context.md) — <!-- begin:auto-docs --> _(no submodules)_- pack-registry-provider — <!-- begin:auto-docs --> _…
- [react-ui-provider](./src/provider/react-ui-provider/react-ui-provider.md) — <!-- begin:auto-docs --> _(no submodules)_- [react-ui-provider](./src/provider/react-ui-provider/react-ui-provider.md) — <!-- begin:auto-docs --> _(no submodules)_- [theme](./src/theme/theme-context.md) — <!-- begin:auto-docs --> _(no submodules)_- theme-provider — <!-- begin:auto-docs --> _(no subm…
  - [theme-provider](./src/theme/theme-provider/theme-provider.md) — <!-- begin:auto-docs --> _(no submodules)_- [theme-provider](./src/theme/theme-provider/theme-provider.md) — <!-- begin:auto-docs --> _(no submodules)_- [theme-switcher](./src/theme/theme-switcher/theme-switcher.md) — <!-- begin:auto-docs --> _(no submodules)_- [theme-switcher](./src/theme/theme-switcher/theme-switcher.md) — <!-- begin:auto-docs --> _(no submodules)_- [dark](./src/theme/themes/dark.md) — The dark counterpart of `lightTheme`. Same variant surface, same token names, lightness anchors inverted so foreground…
  - [high-contrast](./src/theme/themes/high-contrast.md) — Accessibility-first theme that meets WCAG AAA contrast for normal and large text alike. Pure-white foreground (`#FFFFFF…
  - [light](./src/theme/themes/light.md) — The default `ThemePlugin` instance shipped with `@suaveplan/react-ui`. `lightTheme` matches the shadcn `nova` token pre…
  - [use-theme](./src/theme/use-theme/use-theme.md) — <!-- begin:auto-docs --> _(no submodules)_- [use-theme](./src/theme/use-theme/use-theme.md) — <!-- begin:auto-docs --> _(no submodules)_- [use-theme-tokens](./src/theme/use-theme-tokens/use-theme-tokens.md) — <!-- begin:auto-docs --> _(no submodules)_- [use-theme-tokens](./src/theme/use-theme-tokens/use-theme-tokens.md) — <!-- begin:auto-docs --> _(no submodules)_- [use-themed-variants](./src/theme/use-themed-variants/use-themed-variants.md) — <!-- begin:auto-docs --> _(no submodules)_- [use-themed-variants](./src/theme/use-themed-variants/use-themed-variants.md) — <!-- begin:auto-docs --> _(no submodules)_- [theme-context](./src/theme/theme-context.md) — <!-- begin:auto-docs --> _(no submodules)_- theme-provider — <!-- begin:auto-docs --> _(no subm…
- [cn](./src/utils/cn/cn.md) — <!-- begin:auto-docs --> _(no submodules)_- [cn](./src/utils/cn/cn.md) — <!-- begin:auto-docs --> _(no submodules)_- [motion](./src/utils/motion/motion.md) — <!-- begin:auto-docs --> _(no submodules)_- [motion](./src/utils/motion/motion.md) — <!-- begin:auto-docs --> _(no submodules)_- [variants](./src/variants/variants.md) — <!-- begin:auto-docs --> _(no submodules)_- [variants](./src/variants/variants.md) — <!-- begin:auto-docs --> _(no submodules)_- [version](./src/version.md) — Declares the running version of `@suaveplan/react-ui` as the constant `REACT_UI_VERSION`. The version is hand-maintaine…
- [accordion](./src/components/accordion/accordion.md) — <!-- begin:auto-docs --> _(no submodules)_- [accordion.variants](./src/components/accordion/accordion.variants.md) — `accordionVariants`, `accordionItemVariants`, `accordionHeaderVariants`, `accordionTriggerVariants`, and `accordionCont…
- [alert](./src/components/alert/alert.md) — <!-- begin:auto-docs --> _(no submodules)_  - [alert](./src/components/alert/alert.md) — <!-- begin:auto-docs --> _(no submodules)_  - [alert.variants](./src/components/alert/alert.variants.md) — `alertVariants` is the cva config that powers the `<Alert>` chassis component. It exposes a `variant` axis with four ru…
- [alert-dialog](./src/components/alert-dialog/alert-dialog.md) — <!-- begin:auto-docs --> _(no submodules)_  - [alert-dialog](./src/components/alert-dialog/alert-dialog.md) — <!-- begin:auto-docs --> _(no submodules)_  - [alert-dialog.variants](./src/components/alert-dialog/alert-dialog.variants.md) — `alertDialogOverlayVariants`, `alertDialogContentVariants`, `alertDialogHeaderVariants`, `alertDialogFooterVariants`, `…
- [aspect-ratio](./src/components/aspect-ratio/aspect-ratio.md) — <!-- begin:auto-docs --> _(no submodules)_  - [aspect-ratio](./src/components/aspect-ratio/aspect-ratio.md) — <!-- begin:auto-docs --> _(no submodules)_  - [aspect-ratio.variants](./src/components/aspect-ratio/aspect-ratio.variants.md) — `aspectRatioVariants` is the cva (class-variance-authority) configuration powering the `<AspectRatio>` outer wrapper. I…
- [avatar](./src/components/avatar/avatar.md) — <!-- begin:auto-docs --> _(no submodules)_  - [avatar](./src/components/avatar/avatar.md) — <!-- begin:auto-docs --> _(no submodules)_  - [avatar.variants](./src/components/avatar/avatar.variants.md) — `avatarVariants` is the cva config that powers the `<Avatar>` chassis component (`<AvatarImage>` and `<AvatarFallback>`…
- [badge](./src/components/badge/badge.md) — <!-- begin:auto-docs --> _(no submodules)_  - [badge](./src/components/badge/badge.md) — <!-- begin:auto-docs --> _(no submodules)_  - [badge.variants](./src/components/badge/badge.variants.md) — `badgeVariants` is the cva config that powers the `<Badge>` chassis component. It exposes a `variant` axis with four ru…
- [breadcrumb](./src/components/breadcrumb/breadcrumb.md) — <!-- begin:auto-docs --> _(no submodules)_  - [breadcrumb](./src/components/breadcrumb/breadcrumb.md) — <!-- begin:auto-docs --> _(no submodules)_  - [breadcrumb.variants](./src/components/breadcrumb/breadcrumb.variants.md) — `breadcrumbVariants`, `breadcrumbListVariants`, `breadcrumbItemVariants`, `breadcrumbLinkVariants`, `breadcrumbPageVari…
- [button](./src/components/button/button.md) — <!-- begin:auto-docs --> _(no submodules)_  - [button](./src/components/button/button.md) — <!-- begin:auto-docs --> _(no submodules)_  - [button.variants](./src/components/button/button.variants.md) — `buttonVariants` is the cva (class-variance-authority) configuration that powers every `<Button>` render. It is split f…
- [calendar](./src/components/calendar/calendar.md) — <!-- begin:auto-docs --> _(no submodules)_  - [calendar](./src/components/calendar/calendar.md) — <!-- begin:auto-docs --> _(no submodules)_  - [calendar.test-fixtures](./src/components/calendar/calendar.test-fixtures.md) — Wave-3h local test fixture that augments the chassis test i18n instance with the `react-ui.calendar.*` keyset. The chas…
  - [calendar.variants](./src/components/calendar/calendar.variants.md) — `calendarVariants` is the cva config that powers the outer wrapper of `<Calendar>`. The recipe is intentionally minimal…
- [card](./src/components/card/card.md) — <!-- begin:auto-docs --> _(no submodules)_  - [card](./src/components/card/card.md) — <!-- begin:auto-docs --> _(no submodules)_  - [card.variants](./src/components/card/card.variants.md) — `cardVariants` (and its sub-component cva resolvers `cardHeaderVariants`, `cardTitleVariants`, `cardDescriptionVariants…
- [checkbox](./src/components/checkbox/checkbox.md) — <!-- begin:auto-docs --> _(no submodules)_  - [checkbox](./src/components/checkbox/checkbox.md) — <!-- begin:auto-docs --> _(no submodules)_  - [checkbox.variants](./src/components/checkbox/checkbox.variants.md) — `checkboxVariants` is the cva (class-variance-authority) configuration that powers every `<Checkbox>` render. It is spl…
- [collapsible](./src/components/collapsible/collapsible.md) — <!-- begin:auto-docs --> _(no submodules)_  - [collapsible](./src/components/collapsible/collapsible.md) — <!-- begin:auto-docs --> _(no submodules)_  - [collapsible.variants](./src/components/collapsible/collapsible.variants.md) — `collapsibleVariants`, `collapsibleTriggerVariants`, and `collapsibleContentVariants` are the cva (class-variance-autho…
- [confirm-delete-dialog](./src/components/confirm-delete-dialog/confirm-delete-dialog.md) — <!-- begin:auto-docs --> _(no submodules)_  - [confirm-delete-dialog](./src/components/confirm-delete-dialog/confirm-delete-dialog.md) — <!-- begin:auto-docs --> _(no submodules)_  - [confirm-delete-dialog.test-fixtures](./src/components/confirm-delete-dialog/confirm-delete-dialog.test-fixtures.md) — Wave-3g local test fixture that augments the chassis test i18n instance with the `react-ui.confirmDelete.*` keyset. The…
- [context-menu](./src/components/context-menu/context-menu.md) — <!-- begin:auto-docs --> _(no submodules)_  - [context-menu](./src/components/context-menu/context-menu.md) — <!-- begin:auto-docs --> _(no submodules)_  - [context-menu.variants](./src/components/context-menu/context-menu.variants.md) — `contextMenuContentVariants`, `contextMenuItemVariants`, `contextMenuLabelVariants`, `contextMenuSeparatorVariants`, `c…
- [data-table](./src/components/data-table/data-table.md) — <!-- begin:auto-docs --> _(no submodules)_  - [data-table](./src/components/data-table/data-table.md) — <!-- begin:auto-docs --> _(no submodules)_  - [data-table.variants](./src/components/data-table/data-table.variants.md) — `dataTableVariants`, `dataTablePaginationVariants`, and `dataTableSortHeaderVariants` drive the chassis `<DataTable>` o…
- [dialog](./src/components/dialog/dialog.md) — <!-- begin:auto-docs --> _(no submodules)_  - [dialog](./src/components/dialog/dialog.md) — <!-- begin:auto-docs --> _(no submodules)_  - [dialog.variants](./src/components/dialog/dialog.variants.md) — `dialogOverlayVariants`, `dialogContentVariants`, `dialogHeaderVariants`, `dialogFooterVariants`, `dialogTitleVariants`…
- [drawer](./src/components/drawer/drawer.md) — <!-- begin:auto-docs --> _(no submodules)_  - [drawer](./src/components/drawer/drawer.md) — <!-- begin:auto-docs --> _(no submodules)_  - [drawer.variants](./src/components/drawer/drawer.variants.md) — `drawerOverlayVariants`, `drawerContentVariants`, `drawerHandleVariants`, `drawerHeaderVariants`, `drawerFooterVariants…
- [dropdown-menu](./src/components/dropdown-menu/dropdown-menu.md) — <!-- begin:auto-docs --> _(no submodules)_  - [dropdown-menu](./src/components/dropdown-menu/dropdown-menu.md) — <!-- begin:auto-docs --> _(no submodules)_  - [dropdown-menu.variants](./src/components/dropdown-menu/dropdown-menu.variants.md) — `dropdownMenuContentVariants`, `dropdownMenuItemVariants`, `dropdownMenuLabelVariants`, `dropdownMenuSeparatorVariants`…
- [empty](./src/components/empty/empty.md) — <!-- begin:auto-docs --> _(no submodules)_  - [empty](./src/components/empty/empty.md) — <!-- begin:auto-docs --> _(no submodules)_  - [empty.variants](./src/components/empty/empty.variants.md) — `emptyVariants` is the cva config that powers the `<Empty>` chassis component (with `emptyHeaderVariants`, `emptyMediaV…
- [error-boundary](./src/components/error-boundary/error-boundary.md) — <!-- begin:auto-docs --> _(no submodules)_  - [error-boundary](./src/components/error-boundary/error-boundary.md) — <!-- begin:auto-docs --> _(no submodules)_  - [error-boundary.metrics](./src/components/error-boundary/error-boundary.metrics.md) — Co-located OTel counter for the chassis `<ErrorBoundary>` component. Lives next to the boundary itself rather than in t…
  - [error-boundary.test-fixtures](./src/components/error-boundary/error-boundary.test-fixtures.md) — Wave-3g local test fixture that augments the chassis test i18n instance with the `react-ui.errorBoundary.*` keyset. The…
  - [error-boundary.variants](./src/components/error-boundary/error-boundary.variants.md) — Cva slot definitions for the chassis `<ErrorBoundary>` default fallback. Splits the fallback into four named slots — ou…
- [field](./src/components/field/field.md) — <!-- begin:auto-docs --> _(no submodules)_  - [field](./src/components/field/field.md) — <!-- begin:auto-docs --> _(no submodules)_  - [field.variants](./src/components/field/field.variants.md) — `fieldVariants`, `fieldLabelVariants`, `fieldDescriptionVariants`, and `fieldErrorVariants` are the four cva (class-var…
- [field-group](./src/components/field-group/field-group.md) — <!-- begin:auto-docs --> _(no submodules)_  - [field-group](./src/components/field-group/field-group.md) — <!-- begin:auto-docs --> _(no submodules)_  - [field-group.variants](./src/components/field-group/field-group.variants.md) — `fieldGroupVariants` is the cva (class-variance-authority) configuration powering every `<FieldGroup>` render. It is sp…
- [field-set](./src/components/field-set/field-set.md) — <!-- begin:auto-docs --> _(no submodules)_  - [field-set](./src/components/field-set/field-set.md) — <!-- begin:auto-docs --> _(no submodules)_  - [field-set.variants](./src/components/field-set/field-set.variants.md) — `fieldSetVariants` and `fieldLegendVariants` are the cva (class-variance-authority) configurations powering `<FieldSet>…
- [hover-card](./src/components/hover-card/hover-card.md) — <!-- begin:auto-docs --> _(no submodules)_  - [hover-card](./src/components/hover-card/hover-card.md) — <!-- begin:auto-docs --> _(no submodules)_  - [hover-card.variants](./src/components/hover-card/hover-card.variants.md) — `hoverCardContentVariants` is the cva configuration powering the `<HoverCardContent>` floating panel. It is split from…
- [input](./src/components/input/input.md) — <!-- begin:auto-docs --> _(no submodules)_  - [input-number](./src/components/input/input-number/input-number.md) — <!-- begin:auto-docs --> _(no submodules)_    - [input-number](./src/components/input/input-number/input-number.md) — <!-- begin:auto-docs --> _(no submodules)_  - [input](./src/components/input/input.md) — <!-- begin:auto-docs --> _(no submodules)_  - [input.variants](./src/components/input/input.variants.md) — `inputVariants` is the cva (class-variance-authority) configuration that powers every `<Input>` render. It is split fro…
- [input-group](./src/components/input-group/input-group.md) — <!-- begin:auto-docs --> _(no submodules)_  - [input-group](./src/components/input-group/input-group.md) — <!-- begin:auto-docs --> _(no submodules)_  - [input-group.variants](./src/components/input-group/input-group.variants.md) — `inputGroupVariants`, `inputGroupAddonVariants`, `inputGroupInputVariants`, `inputGroupTextareaVariants`, and `inputGro…
- [label](./src/components/label/label.md) — <!-- begin:auto-docs --> _(no submodules)_  - [label](./src/components/label/label.md) — <!-- begin:auto-docs --> _(no submodules)_  - [label.variants](./src/components/label/label.variants.md) — `labelVariants` is the cva (class-variance-authority) configuration that powers every `<Label>` render. It is split fro…
- [menubar](./src/components/menubar/menubar.md) — <!-- begin:auto-docs --> _(no submodules)_  - [menubar](./src/components/menubar/menubar.md) — <!-- begin:auto-docs --> _(no submodules)_  - [menubar.variants](./src/components/menubar/menubar.variants.md) — `menubarVariants`, `menubarTriggerVariants`, `menubarContentVariants`, `menubarItemVariants`, `menubarLabelVariants`, `…
- [pagination](./src/components/pagination/pagination.md) — <!-- begin:auto-docs --> _(no submodules)_  - [pagination](./src/components/pagination/pagination.md) — <!-- begin:auto-docs --> _(no submodules)_  - [pagination.variants](./src/components/pagination/pagination.variants.md) — `paginationVariants`, `paginationContentVariants`, `paginationItemVariants`, `paginationLinkVariants`, `paginationPrevN…
- [popover](./src/components/popover/popover.md) — <!-- begin:auto-docs --> _(no submodules)_  - [popover](./src/components/popover/popover.md) — <!-- begin:auto-docs --> _(no submodules)_  - [popover.variants](./src/components/popover/popover.variants.md) — `popoverContentVariants` is the cva configuration powering the `<PopoverContent>` floating panel. It is split from `pop…
- [progress](./src/components/progress/progress.md) — <!-- begin:auto-docs --> _(no submodules)_  - [progress](./src/components/progress/progress.md) — <!-- begin:auto-docs --> _(no submodules)_  - [progress.variants](./src/components/progress/progress.variants.md) — `progressVariants` is the cva config that powers the `<Progress>` chassis component (paired with `progressIndicatorVari…
- [radio-group](./src/components/radio-group/radio-group.md) — <!-- begin:auto-docs --> _(no submodules)_  - [radio-group](./src/components/radio-group/radio-group.md) — <!-- begin:auto-docs --> _(no submodules)_  - [radio-group.variants](./src/components/radio-group/radio-group.variants.md) — `radioGroupVariants` and `radioGroupItemVariants` are the cva (class-variance-authority) configurations powering `<Radi…
- [resizable](./src/components/resizable/resizable.md) — <!-- begin:auto-docs --> _(no submodules)_  - [resizable](./src/components/resizable/resizable.md) — <!-- begin:auto-docs --> _(no submodules)_  - [resizable.variants](./src/components/resizable/resizable.variants.md) — `resizablePanelGroupVariants`, `resizablePanelVariants`, `resizableHandleVariants`, and `resizableHandleGripVariants` a…
- [scroll-area](./src/components/scroll-area/scroll-area.md) — <!-- begin:auto-docs --> _(no submodules)_  - [scroll-area](./src/components/scroll-area/scroll-area.md) — <!-- begin:auto-docs --> _(no submodules)_  - [scroll-area.variants](./src/components/scroll-area/scroll-area.variants.md) — `scrollAreaVariants`, `scrollAreaViewportVariants`, `scrollAreaScrollbarVariants`, `scrollAreaThumbVariants`, and `scro…
- [select](./src/components/select/select.md) — <!-- begin:auto-docs --> _(no submodules)_  - [select](./src/components/select/select.md) — <!-- begin:auto-docs --> _(no submodules)_  - [select.test-fixtures](./src/components/select/select.test-fixtures.md) — Wave-3h local test fixture that augments the chassis test i18n instance with the `react-ui.select.placeholder` key. The…
  - [select.variants](./src/components/select/select.variants.md) — The `<Select>` component is composed of six visual slots — trigger, content panel, item row, group label, separator, an…
- [separator](./src/components/separator/separator.md) — <!-- begin:auto-docs --> _(no submodules)_  - [separator](./src/components/separator/separator.md) — <!-- begin:auto-docs --> _(no submodules)_  - [separator.variants](./src/components/separator/separator.variants.md) — `separatorVariants` is the cva (class-variance-authority) configuration that powers every `<Separator>` render. It is s…
- [sheet](./src/components/sheet/sheet.md) — <!-- begin:auto-docs --> _(no submodules)_  - [sheet](./src/components/sheet/sheet.md) — <!-- begin:auto-docs --> _(no submodules)_  - [sheet.variants](./src/components/sheet/sheet.variants.md) — `sheetOverlayVariants`, `sheetContentVariants`, `sheetHeaderVariants`, `sheetFooterVariants`, `sheetTitleVariants`, `sh…
- [skeleton](./src/components/skeleton/skeleton.md) — <!-- begin:auto-docs --> _(no submodules)_  - [skeleton](./src/components/skeleton/skeleton.md) — <!-- begin:auto-docs --> _(no submodules)_  - [skeleton.variants](./src/components/skeleton/skeleton.variants.md) — `skeletonVariants` is the cva (class-variance-authority) configuration that powers every `<Skeleton>` render. It is spl…
- [sonner](./src/components/sonner/sonner.md) — <!-- begin:auto-docs --> _(no submodules)_  - [sonner](./src/components/sonner/sonner.md) — <!-- begin:auto-docs --> _(no submodules)_  - [sonner.variants](./src/components/sonner/sonner.variants.md) — Defines the `sonnerToasterVariants` cva slot for the chassis `<Sonner>` toaster host. Sonner manages its own stacking,…
- [spinner](./src/components/spinner/spinner.md) — <!-- begin:auto-docs --> _(no submodules)_  - [spinner](./src/components/spinner/spinner.md) — <!-- begin:auto-docs --> _(no submodules)_  - [spinner.variants](./src/components/spinner/spinner.variants.md) — `spinnerVariants` is the cva config that powers the `<Spinner>` chassis component. It exposes a `size` axis (`sm` / `de…
- [status-badge](./src/components/status-badge/status-badge.md) — <!-- begin:auto-docs --> _(no submodules)_  - [status-badge](./src/components/status-badge/status-badge.md) — <!-- begin:auto-docs --> _(no submodules)_  - [status-badge.variants](./src/components/status-badge/status-badge.variants.md) — `statusBadgeVariants` is the cva config that powers the `<StatusBadge>` chassis component. It exposes a `status` axis w…
- [switch](./src/components/switch/switch.md) — <!-- begin:auto-docs --> _(no submodules)_  - [switch](./src/components/switch/switch.md) — <!-- begin:auto-docs --> _(no submodules)_  - [switch.variants](./src/components/switch/switch.variants.md) — `switchVariants` and `switchThumbVariants` are the two cva (class-variance-authority) configurations that together powe…
- [table](./src/components/table/table.md) — <!-- begin:auto-docs --> _(no submodules)_  - [table](./src/components/table/table.md) — <!-- begin:auto-docs --> _(no submodules)_  - [table.variants](./src/components/table/table.variants.md) — `tableVariants` and its eight sub-component cva resolvers (`tableHeaderVariants`, `tableBodyVariants`, `tableFooterVari…
- [tabs](./src/components/tabs/tabs.md) — <!-- begin:auto-docs --> _(no submodules)_  - [tabs](./src/components/tabs/tabs.md) — <!-- begin:auto-docs --> _(no submodules)_  - [tabs.variants](./src/components/tabs/tabs.variants.md) — `tabsVariants`, `tabsListVariants`, `tabsTriggerVariants`, and `tabsContentVariants` are the cva (class-variance-author…
- [textarea](./src/components/textarea/textarea.md) — <!-- begin:auto-docs --> _(no submodules)_  - [textarea](./src/components/textarea/textarea.md) — <!-- begin:auto-docs --> _(no submodules)_  - [textarea.variants](./src/components/textarea/textarea.variants.md) — `textareaVariants` is the cva (class-variance-authority) configuration that powers every `<Textarea>` render. It is spl…
- [theme-toggle](./src/components/theme-toggle/theme-toggle.md) — <!-- begin:auto-docs --> _(no submodules)_  - [theme-toggle](./src/components/theme-toggle/theme-toggle.md) — <!-- begin:auto-docs --> _(no submodules)_  - [theme-toggle.variants](./src/components/theme-toggle/theme-toggle.variants.md) — Cva slot for the chassis `<ThemeToggle>` icon-button. Mirrors the shape of `<Button variant="outline" size="icon">` so…
- [toast](./src/components/toast/toast.md) — <!-- begin:auto-docs --> _(no submodules)_  - [toast](./src/components/toast/toast.md) — <!-- begin:auto-docs --> _(no submodules)_- [toggle](./src/components/toggle/toggle.md) — <!-- begin:auto-docs --> _(no submodules)_  - [toggle](./src/components/toggle/toggle.md) — <!-- begin:auto-docs --> _(no submodules)_  - [toggle.variants](./src/components/toggle/toggle.variants.md) — `toggleVariants` is the cva (class-variance-authority) configuration powering every `<Toggle>` render. It is split from…
- [toggle-group](./src/components/toggle-group/toggle-group.md) — <!-- begin:auto-docs --> _(no submodules)_  - [toggle-group](./src/components/toggle-group/toggle-group.md) — <!-- begin:auto-docs --> _(no submodules)_  - [toggle-group.variants](./src/components/toggle-group/toggle-group.variants.md) — `toggleGroupVariants` and `toggleGroupItemVariants` are the cva (class-variance-authority) configurations powering `<To…
- [tooltip](./src/components/tooltip/tooltip.md) — <!-- begin:auto-docs --> _(no submodules)_  - [tooltip](./src/components/tooltip/tooltip.md) — <!-- begin:auto-docs --> _(no submodules)_  - [tooltip.variants](./src/components/tooltip/tooltip.variants.md) — `tooltipContentVariants` is the cva configuration powering the `<TooltipContent>` floating bubble. It is split from `to…
- [use-toast-sonner-bridge](./src/components/use-toast-sonner-bridge/use-toast-sonner-bridge.md) — <!-- begin:auto-docs --> _(no submodules)_  - [use-toast-sonner-bridge](./src/components/use-toast-sonner-bridge/use-toast-sonner-bridge.md) — <!-- begin:auto-docs --> _(no submodules)_- [error-codes](./src/errors/error-codes.md) — Defines every stable error code emitted by the `@suaveplan/react-ui` package. Codes are grouped under the `REACT_UI` na…
- [react-ui-error](./src/errors/react-ui-error.md) — Owns every error thrown by the `@suaveplan/react-ui` package. Extends the project-wide `SuaveplanError` so each instan…
- [use-mobile](./src/hooks/use-mobile/use-mobile.md) — <!-- begin:auto-docs --> _(no submodules)_  - [use-mobile](./src/hooks/use-mobile/use-mobile.md) — <!-- begin:auto-docs --> _(no submodules)_- [use-toast](./src/hooks/use-toast/use-toast.md) — <!-- begin:auto-docs --> _(no submodules)_  - [use-toast](./src/hooks/use-toast/use-toast.md) — <!-- begin:auto-docs --> _(no submodules)_- [formatted-cell](./src/i18n/formatted-cell/formatted-cell.md) — <!-- begin:auto-docs --> _(no submodules)_  - [formatted-cell](./src/i18n/formatted-cell/formatted-cell.md) — <!-- begin:auto-docs --> _(no submodules)_- [formatted-currency](./src/i18n/formatted-currency/formatted-currency.md) — <!-- begin:auto-docs --> _(no submodules)_  - [formatted-currency](./src/i18n/formatted-currency/formatted-currency.md) — <!-- begin:auto-docs --> _(no submodules)_- [formatted-date](./src/i18n/formatted-date/formatted-date.md) — <!-- begin:auto-docs --> _(no submodules)_  - [formatted-date](./src/i18n/formatted-date/formatted-date.md) — <!-- begin:auto-docs --> _(no submodules)_- [formatted-list](./src/i18n/formatted-list/formatted-list.md) — <!-- begin:auto-docs --> _(no submodules)_  - [formatted-list](./src/i18n/formatted-list/formatted-list.md) — <!-- begin:auto-docs --> _(no submodules)_- [formatted-message](./src/i18n/formatted-message/formatted-message.md) — <!-- begin:auto-docs --> _(no submodules)_  - [formatted-message](./src/i18n/formatted-message/formatted-message.md) — <!-- begin:auto-docs --> _(no submodules)_- [formatted-number](./src/i18n/formatted-number/formatted-number.md) — <!-- begin:auto-docs --> _(no submodules)_  - [formatted-number](./src/i18n/formatted-number/formatted-number.md) — <!-- begin:auto-docs --> _(no submodules)_- [formatted-relative-time](./src/i18n/formatted-relative-time/formatted-relative-time.md) — <!-- begin:auto-docs --> _(no submodules)_  - [formatted-relative-time](./src/i18n/formatted-relative-time/formatted-relative-time.md) — <!-- begin:auto-docs --> _(no submodules)_- [plural](./src/i18n/plural/plural.md) — <!-- begin:auto-docs --> _(no submodules)_  - [plural](./src/i18n/plural/plural.md) — <!-- begin:auto-docs --> _(no submodules)_- [react-ui-i18n-bridge](./src/i18n/react-ui-i18n-bridge/react-ui-i18n-bridge.md) — <!-- begin:auto-docs --> _(no submodules)_  - [react-ui-i18n-bridge](./src/i18n/react-ui-i18n-bridge/react-ui-i18n-bridge.md) — <!-- begin:auto-docs --> _(no submodules)_- [stories-shell](./src/i18n/stories-shell/stories-shell.md) — <!-- begin:auto-docs --> _(no submodules)_  - [stories-shell](./src/i18n/stories-shell/stories-shell.md) — <!-- begin:auto-docs --> _(no submodules)_- [tanstack-bridge](./src/i18n/tanstack-bridge/tanstack-bridge.md) — <!-- begin:auto-docs --> _(no submodules)_  - [tanstack-bridge](./src/i18n/tanstack-bridge/tanstack-bridge.md) — <!-- begin:auto-docs --> _(no submodules)_- [validation-message-bridge](./src/i18n/validation-message-bridge/validation-message-bridge.md) — <!-- begin:auto-docs --> _(no submodules)_  - [validation-message-bridge](./src/i18n/validation-message-bridge/validation-message-bridge.md) — <!-- begin:auto-docs --> _(no submodules)_- [augmentation](./src/locales/augmentation.md) — Side-effect-only TypeScript module that augments `@suaveplan/react-i18n`'s `ContributedTranslationKeys` interface with…
- [schema](./src/locales/schema.md) — Zod schema asserting that every locale bundle declares exactly the keys present in the canonical `en-GB.json` source-of…
- [translation-keys](./src/locales/translation-keys.md) — `translation-keys.ts` is the codegen-emitted string-literal union of every translation key contributed by `@suaveplan/r…
- [observability](./src/observability/react-ui-metrics.md) — <!-- begin:auto-docs --> _(no submodules)_  - [react-ui-metrics](./src/observability/react-ui-metrics.md) — <!-- begin:auto-docs --> _(no submodules)_- [pack](./src/pack/pack-context.md) — <!-- begin:auto-docs --> _(no submodules)_  - [pack-registry-provider](./src/pack/pack-registry-provider/pack-registry-provider.md) — <!-- begin:auto-docs --> _(no submodules)_    - [pack-registry-provider](./src/pack/pack-registry-provider/pack-registry-provider.md) — <!-- begin:auto-docs --> _(no submodules)_  - [runtime-override](./src/pack/runtime-override/runtime-override.md) — <!-- begin:auto-docs --> _(no submodules)_    - [runtime-override](./src/pack/runtime-override/runtime-override.md) — <!-- begin:auto-docs --> _(no submodules)_  - [use-pack-component](./src/pack/use-pack-component/use-pack-component.md) — <!-- begin:auto-docs --> _(no submodules)_    - [use-pack-component](./src/pack/use-pack-component/use-pack-component.md) — <!-- begin:auto-docs --> _(no submodules)_  - [version-check](./src/pack/version-check/version-check.md) — <!-- begin:auto-docs --> _(no submodules)_    - [version-check](./src/pack/version-check/version-check.md) — <!-- begin:auto-docs --> _(no submodules)_  - [pack-context](./src/pack/pack-context.md) — <!-- begin:auto-docs --> _(no submodules)_- [react-ui-provider](./src/provider/react-ui-provider/react-ui-provider.md) — <!-- begin:auto-docs --> _(no submodules)_  - [react-ui-provider](./src/provider/react-ui-provider/react-ui-provider.md) — <!-- begin:auto-docs --> _(no submodules)_- [theme](./src/theme/theme-context.md) — <!-- begin:auto-docs --> _(no submodules)_  - [theme-provider](./src/theme/theme-provider/theme-provider.md) — <!-- begin:auto-docs --> _(no submodules)_    - [theme-provider](./src/theme/theme-provider/theme-provider.md) — <!-- begin:auto-docs --> _(no submodules)_  - [theme-switcher](./src/theme/theme-switcher/theme-switcher.md) — <!-- begin:auto-docs --> _(no submodules)_    - [theme-switcher](./src/theme/theme-switcher/theme-switcher.md) — <!-- begin:auto-docs --> _(no submodules)_  - [dark](./src/theme/themes/dark.md) — The dark counterpart of `lightTheme`. Same variant surface, same token names, lightness anchors inverted so foreground…
  - [high-contrast](./src/theme/themes/high-contrast.md) — Accessibility-first theme that meets WCAG AAA contrast for normal and large text alike. Pure-white foreground (`#FFFFFF…
  - [light](./src/theme/themes/light.md) — The default `ThemePlugin` instance shipped with `@suaveplan/react-ui`. `lightTheme` matches the shadcn `nova` token pre…
  - [use-theme](./src/theme/use-theme/use-theme.md) — <!-- begin:auto-docs --> _(no submodules)_    - [use-theme](./src/theme/use-theme/use-theme.md) — <!-- begin:auto-docs --> _(no submodules)_  - [use-theme-tokens](./src/theme/use-theme-tokens/use-theme-tokens.md) — <!-- begin:auto-docs --> _(no submodules)_    - [use-theme-tokens](./src/theme/use-theme-tokens/use-theme-tokens.md) — <!-- begin:auto-docs --> _(no submodules)_  - [use-themed-variants](./src/theme/use-themed-variants/use-themed-variants.md) — <!-- begin:auto-docs --> _(no submodules)_    - [use-themed-variants](./src/theme/use-themed-variants/use-themed-variants.md) — <!-- begin:auto-docs --> _(no submodules)_  - [theme-context](./src/theme/theme-context.md) — <!-- begin:auto-docs --> _(no submodules)_- [cn](./src/utils/cn/cn.md) — <!-- begin:auto-docs --> _(no submodules)_  - [cn](./src/utils/cn/cn.md) — <!-- begin:auto-docs --> _(no submodules)_- [motion](./src/utils/motion/motion.md) — <!-- begin:auto-docs --> _(no submodules)_  - [motion](./src/utils/motion/motion.md) — <!-- begin:auto-docs --> _(no submodules)_- [variants](./src/variants/variants.md) — <!-- begin:auto-docs --> _(no submodules)_  - [variants](./src/variants/variants.md) — <!-- begin:auto-docs --> _(no submodules)_- [version](./src/version.md) — Declares the running version of `@suaveplan/react-ui` as the constant `REACT_UI_VERSION`. The version is hand-maintaine…

## What is here

- `<ReactUiProvider>` — opinionated wrapper composing
  `<TranslationProvider>` → `<ThemeProvider>` → `<PackRegistryProvider>`
- `<ThemeProvider>` — theme registry with FOUC-prevention inline script,
  `prefers-color-scheme` + `prefers-reduced-motion` listeners, and a
  schema-validated `ThemePlugin` contract
- `<PackRegistryProvider>` — plugin registry with collision detection,
  lifecycle hooks, peer-version checks (warn-only), and per-pack
  translation auto-registration
- `useTheme`, `useThemeTokens`, `useThemedVariants`, `<ThemeSwitcher>` —
  read-side hooks
- `usePackComponent` — typed pack-component lookup
- `useMobile`, `useToast`, `useDirection` — chassis hooks
- `cn`, `motionToken`, `defineVariants`, `cva` — utilities + variant
  authoring helpers
- Three built-in themes: `lightTheme` (shadcn `nova`), `darkTheme` (pure
  inversion), `highContrastTheme` (WCAG AAA)
- Five bundled locale catalogs (`en-GB`, `zh-CN`, `ar-AE`, `cy-GB`,
  `ru-RU`); auto-registered into the active i18n instance
- OpenTelemetry counters / histograms / spans for every chassis
  surface (theme switches, pack lifecycle, locale-bundle loads, themed
  variants resolve, toast notifications, provider mount)
- shadcn-CLI-compatible registry generator at
  `scripts/build-registry.ts`

## Installation

```bash
bun add @suaveplan/react-ui @suaveplan/react-i18n @suaveplan/i18n
```

## Quickstart

```tsx
import { ReactUiProvider } from "@suaveplan/react-ui/provider";
import { darkTheme, lightTheme } from "@suaveplan/react-ui/theme";
import { createI18n } from "@suaveplan/i18n/plugin";

const i18n = createI18n({ defaultLocale: "en-GB" });

export function App() {
    return (
        <ReactUiProvider
            i18n={i18n}
            themes={[lightTheme, darkTheme]}
            defaultTheme="light"
        >
            <YourApp />
        </ReactUiProvider>
    );
}
```

## Tier and tree-shaking

- **Tier**: React. Peer-deps `react ^18.0.0 || ^19.0.0` /
  `react-dom ^18.0.0 || ^19.0.0`.
- **Tree-shaken**: each feature module is exported under its own
  subpath in `package.json#exports` so a consumer importing only `cn`
  (`import { cn } from '@suaveplan/react-ui/utils/cn'`) does NOT pull
  the rest of the chassis.
- **CSS side-effects**: `package.json#sideEffects` whitelists
  `styles/global.css` and the bundled locale `*.json` so bundlers
  preserve CSS layer registration AND lazy-import chunk emission.

## OpenSpec

Owning change: [`enterprise-react-ui-v2`](../../../docs/design/enterprise-react-ui-v2).
Cross-cutting design: `docs/cross-cutting-designs/2026-05-05-react-ui-react-i18n-react-forms.md`.

## License

MIT — © Suaveplan Team.