# Navius WPF
>
> Machine-readable component contracts for Navius WPF, the lookless WPF parity ports of the Navius primitives, served from https://wpf.naviusui.dev: one markdown manifest per component (frontmatter + usage XAML + property/event tables + keyboard map + UIA mechanism + web deltas + theme captures), meant to be read raw by a coding agent.

## Guides

- [Installation](https://wpf.naviusui.dev/guides/install/): The four Navius.Wpf packages, vendoring components with the navius-wpf CLI, and wiring a consuming app for themed controls.
- [Theming](https://wpf.naviusui.dev/guides/theming/): The Navius token system, ThemeManager's runtime theme swap, and the Windows high-contrast mapping from ADR-0007.
- [Motion](https://wpf.naviusui.dev/guides/motion/): The spring solver and WPF execution surface ported from the web Navius Motion engine.
- [Architecture decisions](https://wpf.naviusui.dev/guides/adrs/): Summaries of the ADRs recorded in the framework repo for the WPF port.
- [Changelog](https://wpf.naviusui.dev/guides/changelog/): Notable changes to Navius WPF, milestone by milestone.

## Components

- [AccessibleIcon](https://wpf.naviusui.dev/components/accessible-icon/): A lookless wrapper that applies an accessible name directly to arbitrary icon content via UIA, rather than a hidden text node.
- [Accordion](https://wpf.naviusui.dev/components/accordion/): A lookless multi-part control that expands and collapses one or more content sections, with roving-focus keyboard navigation and per-item disabled state.
- [AlertDialog](https://wpf.naviusui.dev/components/alert-dialog/): An always-modal confirmation surface hosted in the window's NaviusOverlayLayer, with UIA alert-dialog semantics, an attached property for initial focus on the cancel action, and Escape-only dismissal.
- [Alert](https://wpf.naviusui.dev/components/alert/): A bordered callout surface for user attention, composed from an alert root plus optional title and description content blocks.
- [AspectRatio](https://wpf.naviusui.dev/components/aspect-ratio/): A ContentControl overriding MeasureOverride to constrain its child to a fixed width:height ratio, the behavioral port of the web's padding-bottom percentage hack.
- [Autocomplete](https://wpf.naviusui.dev/components/autocomplete/): An editable textbox with a virtual-focus suggestion popup, where the input text is both the live query and the committed value.
- [Avatar](https://wpf.naviusui.dev/components/avatar/): A lookless control that overlays an image over a fallback, driving a load-status state machine off the image's async download.
- [Badge](https://wpf.naviusui.dev/components/badge/): A small pill-shaped status or count label with four token-backed variants.
- [Breadcrumb](https://wpf.naviusui.dev/components/breadcrumb/): A navigation trail of crumbs and manually placed separators, wrapped in a horizontal wrapping panel.
- [ButtonGroup](https://wpf.naviusui.dev/components/button-group/): A segmented button row, one rounded silhouette clipped at the group boundary around plain square item segments.
- [Button](https://wpf.naviusui.dev/components/button/): A pressable control derived from the native WPF Button, with an explicit soft-disabled mode that stays focusable while suppressing activation.
- [Card](https://wpf.naviusui.dev/components/card/): A hairline-bordered panel surface composed from a root plus header, content, footer, title, and description blocks.
- [Carousel](https://wpf.naviusui.dev/components/carousel/): A slide host with prev/next chevrons, dot indicators, and keyboard arrow navigation.
- [Charts](https://wpf.naviusui.dev/components/charts/): A thin, token-themed wrapper over LiveCharts2 covering line, bar, area, and pie charts, with series colors derived automatically from the current Navius tokens.
- [Checkbox](https://wpf.naviusui.dev/components/checkbox/): A tri-state checkbox, built on the native CheckBox, with an optional select-all NaviusCheckboxGroup roll-up.
- [Collapsible](https://wpf.naviusui.dev/components/collapsible/): A lookless two-part control (trigger plus panel) that toggles a single content region's open state, with the height animation shared with Accordion.
- [ColorPicker](https://wpf.naviusui.dev/components/color-picker/): An HSVA-model color picker folding a 2D saturation/value canvas, hue and alpha tracks, a hex field, and a swatch list into one lookless Control.
- [Combobox](https://wpf.naviusui.dev/components/combobox/): An editable filter textbox paired with a virtual-focus popup listbox, supporting single- or multi-select with chips.
- [CommandPalette](https://wpf.naviusui.dev/components/command-palette/): A modal search-and-run surface with a filtered, grouped command list, keyboard highlight movement, and Enter-to-execute.
- [Context Menu](https://wpf.naviusui.dev/components/context-menu/): A right-click (and Shift+F10/menu-key) popup menu built on native ContextMenuService, reusing the Menu family's item, checkbox, radio, and separator classes.
- [CspProvider](https://wpf.naviusui.dev/components/csp-provider/): A web-only Content-Security-Policy nonce cascading provider, retired from the WPF port.
- [CurrencyInput](https://wpf.naviusui.dev/components/currency-input/): A caret-stable TextBox whose truth is a decimal value, formatted and reformatted live against a culture's currency conventions.
- [DataGrid](https://wpf.naviusui.dev/components/data-grid/): A re-templated native DataGrid with a grid-level global filter and row-key selector, riding the native grid's own sorting, selection, virtualization, and automation peer.
- [DateInput](https://wpf.naviusui.dev/components/date-input/): A segmented year, month, and day spinbutton editor driven by culture-aware layout and a shared per-segment keyboard engine.
- [DateRangePicker](https://wpf.naviusui.dev/components/date-range-picker/): A trigger-and-popup range picker that commits a two-pick start/end range through a pure engine on top of a re-templated native Calendar.
- [Dialog](https://wpf.naviusui.dev/components/dialog/): A modal overlay surface hosted in the window's NaviusOverlayLayer, with UIA dialog semantics, focus cycling, and Escape and outside-click dismissal.
- [DirectionProvider](https://wpf.naviusui.dev/components/direction-provider/): A web-only reading-direction cascading provider, retired from the WPF port in favor of native FlowDirection.
- [Drawer](https://wpf.naviusui.dev/components/drawer/): A modal sheet docked to one edge of the window, hosted in the window's NaviusOverlayLayer, that slides in and out and shares Dialog's UIA and dismissal mechanics.
- [Empty](https://wpf.naviusui.dev/components/empty/): A dashed-border empty-state placeholder composed from a media slot, a title, and a description.
- [Field](https://wpf.naviusui.dev/components/field/): A lookless coordinator that derives a control's touched, dirty, filled, focused, and valid state from real WPF events and wires a label, description, and error message onto whatever control it registers.
- [Fieldset](https://wpf.naviusui.dev/components/fieldset/): A disabled-state grouping container that maps the web's native fieldset-disabled cascade onto WPF's own IsEnabled tree inheritance, with a free-floating legend wired to the group's accessible name.
- [FileUpload](https://wpf.naviusui.dev/components/file-upload/): A dropzone plus file-list control backed by an injectable OS file-picker seam and native drag/drop, replacing the web's hidden-input relay architecture entirely.
- [Form](https://wpf.naviusui.dev/components/form/): A submit and validation orchestrator that discovers descendant Field controls by walking its own logical tree at each submit attempt instead of porting a field registry.
- [InputGroup](https://wpf.naviusui.dev/components/input-group/): A text field with optional leading and trailing adornment slots sharing one border with the input.
- [Item](https://wpf.naviusui.dev/components/item/): A list row composing leading media, a title and description block, and trailing content.
- [Kbd](https://wpf.naviusui.dev/components/kbd/): A single keyboard key or shortcut glyph, optionally grouped into a chord.
- [Label](https://wpf.naviusui.dev/components/label/): A caption control derived from the native WPF Label that resolves a string id to its associated element and adds click-to-focus behavior.
- [MaskedInput](https://wpf.naviusui.dev/components/masked-input/): A caret-stable TextBox that reformats its text against a mask pattern (digit/letter/alphanumeric/literal tokens) on every edit.
- [Menu](https://wpf.naviusui.dev/components/menu/): A trigger-anchored dropdown menu built on native WPF menu controls, with checkable items, radio items, and native submenu nesting.
- [Menubar](https://wpf.naviusui.dev/components/menubar/): A horizontal (or vertical) bar of top-level menus built on the native WPF Menu/MenuItem system, with checkable, radio, and nested submenu items.
- [MessageScroller](https://wpf.naviusui.dev/components/message-scroller/): A chat-transcript ItemsControl wrapping a ScrollViewer, applying a pure state-machine engine for live-edge follow, prepend preservation, and a JumpToLatest badge.
- [Meter](https://wpf.naviusui.dev/components/meter/): A native ProgressBar-derived, read-only static gauge (not a progress operation), always clamped into range and never indeterminate.
- [Navigation Menu](https://wpf.naviusui.dev/components/navigation-menu/): A hover- and keyboard-disclosed site-navigation row where each open item's content renders in its own anchored popup.
- [NumberField](https://wpf.naviusui.dev/components/number-field/): A spinbutton textbox that steps a numeric value with the keyboard or a pair of increment/decrement buttons, clamped to an optional range.
- [OneTimePasswordField](https://wpf.naviusui.dev/components/one-time-password-field/): A cluster of single-character cells sharing one authoritative buffer, for numeric or alphanumeric one-time codes.
- [Overlays](https://wpf.naviusui.dev/components/overlays/): The shared per-window z-order stack, dismiss routing, and in-window portal target that Dialog, AlertDialog, Drawer, Popover, PreviewCard, Tooltip, and Toast all build on.
- [Pagination](https://wpf.naviusui.dev/components/pagination/): Prev/next chevrons plus a computed strip of page numbers and ellipsis gaps for navigating pages.
- [PasswordToggleField](https://wpf.naviusui.dev/components/password-toggle-field/): A password input paired with a reveal/hide toggle button, keeping the plaintext inside native PasswordBox/TextBox controls at all times.
- [Popover](https://wpf.naviusui.dev/components/popover/): A click-toggled, anchored popup with an optional focus trap, built on the shared NaviusAnchoredPopup placement engine and the Overlays dismiss substrate.
- [PreviewCard](https://wpf.naviusui.dev/components/preview-card/): A hover- and focus-revealed preview panel, non-modal end to end, built on the shared NaviusAnchoredPopup placement engine and the Overlays dismiss substrate.
- [Progress](https://wpf.naviusui.dev/components/progress/): A native ProgressBar-derived, read-only progress indicator with a "validate, don't clamp" out-of-range rule and companion value/label text parts.
- [Radio Group](https://wpf.naviusui.dev/components/radio-group/): A roving-tabindex radio-button set that owns its own selection state and arrow/Home/End keyboard model instead of relying on native GroupName exclusion.
- [Rating](https://wpf.naviusui.dev/components/rating/): A star rating built on the WAI-ARIA radio-set pattern, with roving focus, optional half-star selection, and pointer hover preview.
- [Resizable](https://wpf.naviusui.dev/components/resizable/): A Grid-based host that expands its declared children into star-sized panes separated by draggable GridSplitter dividers.
- [ScrollArea](https://wpf.naviusui.dev/components/scroll-area/): A re-templated native ScrollViewer with overlay scrollbars that fade in on hover or scroll activity.
- [Select](https://wpf.naviusui.dev/components/select/): A generic listbox-style select control with single- and multi-select modes, built as a custom lookless ItemsControl rather than on ComboBox.
- [Separator](https://wpf.naviusui.dev/components/separator/): A small lookless line/divider control with a native orientation and an accessibility-tree-removing decorative mode.
- [Sidebar](https://wpf.naviusui.dev/components/sidebar/): A collapsible navigation rail with sectioned items, a built-in collapse toggle, and roving keyboard focus across its flattened item list.
- [Skeleton](https://wpf.naviusui.dev/components/skeleton/): A sizeable loading placeholder that pulses opacity to signal in-progress content without implying a determinate value.
- [Slider](https://wpf.naviusui.dev/components/slider/): A single-thumb value slider built on the native Slider, with contract-parity Step and LargeStep keyboard handling.
- [Slot](https://wpf.naviusui.dev/components/slot/): A web-only Blazor approximation of the asChild attribute-merge pattern, retired from the WPF port.
- [Sortable](https://wpf.naviusui.dev/components/sortable/): A custom reorderable-list control implementing the APG grab-and-move keyboard model plus native pointer drag, with UIA notification announcements in place of a live-region div.
- [Spinner](https://wpf.naviusui.dev/components/spinner/): An indeterminate rotating-arc loading indicator for inline use where a determinate progress bar does not apply.
- [SplitButton](https://wpf.naviusui.dev/components/split-button/): A primary action button fused to a chevron that opens a dropdown menu, sharing one border and corner-radius envelope.
- [Switch](https://wpf.naviusui.dev/components/switch/): An on/off toggle button, built directly on the native ToggleButton, with a mandatory thumb template part.
- [Tabs](https://wpf.naviusui.dev/components/tabs/): A native TabControl-derived tab strip and panel with hand-rolled activation-mode, loop, and RTL-aware keyboard navigation the stock control doesn't provide.
- [TagInput](https://wpf.naviusui.dev/components/tag-input/): A type-to-create-chips input folding the web's five-part anatomy into one lookless Control with a TextBox field and a real-focus chip roving-tabindex model.
- [TimeInput](https://wpf.naviusui.dev/components/time-input/): A segmented hour, minute, second, and day-period spinbutton editor sharing DateInput's segment engine, composing a time value instead of a date.
- [TimePicker](https://wpf.naviusui.dev/components/time-picker/): A trigger-and-popup time picker composing an embedded segmented time input with one native listbox column per unit, sharing one value between typed edits and column selection.
- [Timeline](https://wpf.naviusui.dev/components/timeline/): A vertical, single-column list of dated or staged entries, each pairing a rail dot and connector with a title and description block.
- [Toast](https://wpf.naviusui.dev/components/toast/): A manager-driven stack of transient notifications, hosted in a corner-anchored viewport, with UIA live-region announcement in place of the web's duplicated aria-live regions.
- [Toggle Group](https://wpf.naviusui.dev/components/toggle-group/): A single- or multiple-selection set of toggle buttons with a roving-focus keyboard model and root-owned mutual exclusion.
- [Toggle](https://wpf.naviusui.dev/components/toggle/): A strictly two-state pressed button, built directly on the native ToggleButton with no additional logic.
- [Toolbar](https://wpf.naviusui.dev/components/toolbar/): A flat container of focusable controls (buttons, links, toggle items) sharing a single roving Tab stop, per the WAI-ARIA APG toolbar pattern.
- [Tooltip](https://wpf.naviusui.dev/components/tooltip/): A custom hover/focus tooltip with its own hover-intent, skip-delay, and hoverable-content timing, built entirely on the shared NaviusAnchoredPopup placement engine rather than native ToolTipService.
- [Tree](https://wpf.naviusui.dev/components/tree/): A virtualized, data-driven tree view derived from TreeView, with fully custom single/multi-select tracking, ltr/rtl-aware arrow navigation, typeahead, and per-item UIA selection events.
- [VisuallyHidden](https://wpf.naviusui.dev/components/visually-hidden/): A web-only sr-only CSS clip-rect technique for AT-visible-but-sighted-invisible content, retired from the WPF port.