# Navius
>
> Machine-readable component contracts for the Navius Blazor primitives: one markdown manifest per component (frontmatter + anatomy + API tables + data attributes + keyboard map + ARIA mechanism).

## Components

- [Accessible Icon](/components/accessible-icon/): A utility that gives a decorative icon a screen-reader-only accessible name, with no wrapper element of its own.
- [Accordion](/components/accordion/): A vertically stacked set of interactive headings that each reveal a section of content.
- [Alert Dialog](/components/alert-dialog/): A modal dialog that interrupts the user with important content and expects a response.
- [Aspect Ratio](/components/aspect-ratio/): Displays content within a desired width/height ratio using a pure CSS technique, with no JavaScript involved.
- [Autocomplete](/components/autocomplete/): A free-text input that filters a list of suggestions, where the committed value is the typed text and selecting a suggestion fills it in.
- [Avatar](/components/avatar/): An image element with a fallback for representing the user.
- [Checkbox](/components/checkbox/): A control that toggles between checked, unchecked, and indeterminate states.
- [Collapsible](/components/collapsible/): An interactive component which expands and collapses a panel, implementing the disclosure WAI-ARIA APG pattern.
- [Color Picker](/components/color-picker/): A saturation/value canvas, hue and alpha tracks, a hex field and preset swatches, all driving one HSVA model projected to a color string.
- [Combobox](/components/combobox/): A value-selection input, the text field is a filter over a list, and the committed value is the item you pick, distinct from what you type.
- [Context Menu](/components/context-menu/): Displays a menu located at the pointer, triggered by a right click or a long press.
- [Currency Input](/components/currency-input/): A caret-stable money field whose bound value is a decimal?, formatted live through the culture's grouping, decimal separator and symbol.
- [Date Input](/components/date-input/): A segmented date editor with culture-ordered spinbutton fields for day, month and year, edited entirely from the keyboard with no popup calendar.
- [Date Range Picker](/components/date-range-picker/): Two segmented date inputs for a start and an end, a trigger that opens a popover, and a single ordered NaviusDateRange value.
- [Dialog](/components/dialog/): A window overlaid on either the primary window or another dialog window, with modal semantics via aria-modal, a focus trap, and page scroll lock.
- [Direction Provider](/components/direction-provider/): A DOM-transparent wrapper that cascades a reading direction (LTR or RTL) to direction-aware primitives beneath it.
- [File Upload](/components/file-upload/): A drag-and-drop file field built on a real hidden file input, with client-side validation, a rejection channel, and a rendered file list.
- [Form](/components/form/): Native constraint validation for a collection of fields, reported through ARIA with aria-describedby and aria-invalid.
- [Label](/components/label/): Renders a label associated with a control.
- [Masked Input](/components/masked-input/): A caret-stable masked text input where a pattern of digit, letter, and literal tokens is enforced on every keystroke without the caret jumping to the end.
- [Menu](/components/menu/): Displays a menu of actions to the user, triggered by a button, with submenus, checkbox/radio items, and full keyboard navigation.
- [Menubar](/components/menubar/): A visually persistent menu common in desktop applications that provides quick access to a consistent set of commands.
- [Message Scroller](/components/message-scroller/): A managed scroll region for conversational transcripts, with anchored turns, live-edge follow, and prepend-safe history.
- [Navigation Menu](/components/navigation-menu/): A collection of links for navigating websites.
- [One-Time Password Field](/components/one-time-password-field/): A group of single-character inputs for entering a one-time code, with auto-advance, paste/SMS autofill, and a hidden input for form posts.
- [Password Toggle Field](/components/password-toggle-field/): A password input paired with a button that toggles whether the value is visible.
- [Popover](/components/popover/): Displays rich content in a portal, triggered by a button.
- [Portal](/components/portal/): Renders its content into document.body (or a custom container) so it escapes clipping and stacking ancestors.
- [Preview Card](/components/preview-card/): For sighted users to preview content available behind a link, opening on hover or keyboard focus and never exposed as a dialog to assistive technology.
- [Progress](/components/progress/): An indicator showing the completion progress of a task, typically displayed as a progress bar.
- [Radio Group](/components/radio-group/): A set of checkable buttons, known as radio buttons, where no more than one can be checked at a time.
- [Rating](/components/rating/): A star rating built on the WAI-ARIA radio pattern, with roving focus, optional half values, and pointer hover preview.
- [Scroll Area](/components/scroll-area/): Augments native scroll functionality with a custom, cross-browser-consistent scrollbar while keeping all scrolling native.
- [Select](/components/select/): A list of options for the user to pick from, triggered by a button, with a role="combobox" trigger and role="listbox" content.
- [Separator](/components/separator/): Visually or semantically separates content.
- [Slider](/components/slider/): An input where the user selects one or more values from within a given range, with draggable thumbs and full keyboard support.
- [Slot](/components/slot/): Merges its props onto a single child element, the Blazor approximation of asChild.
- [Sortable](/components/sortable/): Headless drag-to-reorder over a list of stable keys, with pointer and touch dragging from the engine plus a full APG grab-and-move keyboard model.
- [Switch](/components/switch/): A control that toggles between an on and off state.
- [Tabs](/components/tabs/): A set of layered sections of content, known as tab panels, that are displayed one at a time.
- [Tag Input](/components/tag-input/): Materializes free text into removable chips, with delimiter-driven commits, roving chip navigation, and configurable commit rules (transform, validate, dedupe, cap).
- [Time Input](/components/time-input/): A segmented time editor with spinbutton fields for hours, minutes and optional seconds, in 12- or 24-hour modes with a day-period toggle.
- [Time Picker](/components/time-picker/): A segmented time input paired with a popover of scrollable listbox columns, type a time, or pick it from the hour, minute and AM/PM wheels.
- [Toast](/components/toast/): A succinct message that is displayed temporarily.
- [Toggle Group](/components/toggle-group/): A set of two-state buttons that can be toggled on or off, singly or as a multi-select set.
- [Toggle](/components/toggle/): A two-state button that can be either on or off, reflecting its state via aria-pressed.
- [Toolbar](/components/toolbar/): A container for grouping a set of controls, such as buttons, toggle groups or links.
- [Tooltip](/components/tooltip/): A popup that displays information related to an element when the element receives keyboard focus or the mouse hovers over it.
- [Tree](/components/tree/): A full WAI-ARIA APG tree view with single or multi selection, controlled expansion, roving or activedescendant focus, and a data-driven or hand-composed shape.
- [Visually Hidden](/components/visually-hidden/): Hides content from the screen while keeping it available to assistive technology.