ngwr 10.2.1 → 11.1.0

package/llms-full.txt

@@ -91,6 +91,10 @@
 - exports: WrButton, WrButtonGroup, WrButtonSize, WrButtonShape, WrButtonIconPosition
 - Trigger an action. Renders as <wr-btn>, button[wr-btn], or a[wr-btn].
 
+## ngwr/button/testing
+- import: `import { WrButtonHarness } from 'ngwr/button/testing'`
+- exports: WrButtonHarness, WrButtonHarnessFilters
+
 ## ngwr/calendar
 - import: `import { WrCalendar } from 'ngwr/calendar'`
 - selector: `wr-calendar`
@@ -113,7 +117,11 @@
 - import: `import { WrCarousel } from 'ngwr/carousel'`
 - selector: `wr-carousel-slide`, `wr-carousel`
 - exports: WrCarousel, WrCarouselSlide
-- Slide carousel with prev/next, dots, and optional autoplay. Pause on hover.
+- Slide carousel with prev/next, dots, and optional autoplay. Autoplay holds while the pointer is over it, while focus is inside it, and while a drag is in flight — hovering is not a way to stop moving content for someone who never uses a mouse, which is what WCAG 2.2.2 asks for.
+
+## ngwr/carousel/testing
+- import: `import { WrCarouselHarness } from 'ngwr/carousel/testing'`
+- exports: WrCarouselHarness, WrCarouselHarnessFilters
 
 ## ngwr/cascader
 - import: `import { WrCascader } from 'ngwr/cascader'`
@@ -121,12 +129,20 @@
 - exports: WrCascader, WrCascaderOption, WrCascaderSize
 - Multi-level select. Drills through hierarchical categories one column at a time; picking a leaf commits the full path. A signal-forms native control — it implements `FormValueControl`, so `[formField]` binds straight to its `value` model (`readonly T[]`). `[(value)]` works standalone, and `[(ngModel)]` / reactive forms keep working through Angular's bridge.
 
+## ngwr/cascader/testing
+- import: `import { WrCascaderColumnHarness } from 'ngwr/cascader/testing'`
+- exports: WrCascaderColumnHarness, WrCascaderHarness, WrCascaderOptionHarness, WrCascaderColumnHarnessFilters, WrCascaderHarnessFilters, WrCascaderOptionHarnessFilters
+
 ## ngwr/checkbox
 - import: `import { WrCheckbox } from 'ngwr/checkbox'`
 - selector: `wr-checkbox-group`, `wr-checkbox`
 - exports: WrCheckbox, WrCheckboxSize, WrCheckboxGroup, WR_CHECKBOX_GROUP, WrCheckboxGroupContext
 - Two-state checkbox. Standalone (boolean) or inside <wr-checkbox-group> (array of values).
 
+## ngwr/checkbox/testing
+- import: `import { WrCheckboxHarness } from 'ngwr/checkbox/testing'`
+- exports: WrCheckboxHarness, WrCheckboxHarnessFilters
+
 ## ngwr/circular-text
 - import: `import { WrCircularText } from 'ngwr/circular-text'`
 - selector: `wr-circular-text`
@@ -150,6 +166,10 @@
 - exports: WrCollapse, WrCollapseGroup, WrAccordion, WR_COLLAPSE_GROUP, WrCollapseGroupContext
 - Expandable panel with a clickable header. Two-way binds `open`. Wrap in `<wr-collapse-group accordion>` for single-open behavior.
 
+## ngwr/collapse/testing
+- import: `import { WrCollapseGroupHarness } from 'ngwr/collapse/testing'`
+- exports: WrCollapseGroupHarness, WrCollapseHarness, WrCollapseGroupHarnessFilters, WrCollapseHarnessFilters
+
 ## ngwr/color-picker
 - import: `import { WrColorPicker } from 'ngwr/color-picker'`
 - selector: `[wrColorPickerTrigger]`, `wr-color-picker`
@@ -162,6 +182,10 @@
 - exports: WrCommandPalette, WrCommandItem, WrCommandGroup
 - ⌘K-style centred modal with a search input and filtered list of actions. Items group automatically, support icons, descriptions, and shortcut hints. Bind a global hotkey (default `mod+k`) or open it programmatically.
 
+## ngwr/command-palette/testing
+- import: `import { WrCommandPaletteGroupHarness } from 'ngwr/command-palette/testing'`
+- exports: WrCommandPaletteGroupHarness, WrCommandPaletteHarness, WrCommandPaletteItemHarness, WrCommandPaletteGroupHarnessFilters, WrCommandPaletteHarnessFilters, WrCommandPaletteItemHarnessFilters
+
 ## ngwr/compare
 - import: `import { WrCompare } from 'ngwr/compare'`
 - selector: `wr-compare`
@@ -173,12 +197,20 @@
 - exports: WrConfetti, WrConfettiOptions
 - Imperative confetti service. Inject `WrConfetti` and call `.fire()` on a celebration event.
 
+## ngwr/config
+- import: `import { provideWrConfig } from 'ngwr/config'`
+- exports: provideWrConfig, useConfigValue, WR_CONFIG, WrConfig, WrControlDefaults, WrControlSize
+
 ## ngwr/context-menu
 - import: `import { WrContextMenu } from 'ngwr/context-menu'`
 - selector: `wr-context-menu-divider`, `wr-context-menu-item`, `wr-context-menu`, `[wrContextMenu]`
 - exports: WrContextMenu, WrContextMenuPanel, WrContextMenuItem, WrContextMenuDivider
 - Attach `[wrContextMenu]` to any element to open a `<wr-context-menu>` at the pointer position on right-click. Native browser menu is suppressed on the host.
 
+## ngwr/context-menu/testing
+- import: `import { WrContextMenuHarness } from 'ngwr/context-menu/testing'`
+- exports: WrContextMenuHarness, WrContextMenuItemHarness, WrContextMenuHarnessFilters, WrContextMenuItemHarnessFilters
+
 ## ngwr/cookie
 - import: `import { WrCookie } from 'ngwr/cookie'`
 - exports: WrCookie, WrCookieOptions
@@ -208,6 +240,10 @@
 - exports: WrDatePicker, WrDateRangePicker, WrDateRange
 - Unified date / time / date-time picker. `<input>` + popover for every mode — overlay content swaps based on `[mode]`. Parses on every keystroke (silently — only emits when valid), reformats canonical on blur. Format driven by `WrDateAdapter`.
 
+## ngwr/date-picker/testing
+- import: `import { WrDatePickerDayHarness } from 'ngwr/date-picker/testing'`
+- exports: WrDatePickerDayHarness, WrDatePickerHarness, WrDateRangePickerHarness, WrDatePickerDayHarnessFilters, WrDatePickerHarnessFilters, WrDatePickerTimeFields, WrDateRangePickerHarnessFilters
+
 ## ngwr/decrypt-text
 - import: `import { WrDecryptText } from 'ngwr/decrypt-text'`
 - selector: `wr-decrypt-text`
@@ -218,7 +254,7 @@
 - import: `import { WrDensity } from 'ngwr/density'`
 - selector: `[wrDensity]`
 - exports: WrDensity, WrDensityDirective, provideWrDensity, WR_DENSITY_CONFIG, DEFAULT_WR_DENSITY_CONFIG, WrDensityValue, WrDensityConfig
-- Density scale — `compact` / `default` / `comfortable` / `touch` — applied as CSS-variable multipliers on per-component paddings. `touch` enlarges hit areas for finger input. Persisted via WrStorage and overrideable per-subtree with the `[wrDensity]` directive.
+- Density scale — `sm` / `md` / `lg` / `touch` — applied as CSS-variable multipliers on per-component paddings. `md` is the default and resolves to `1` everywhere; `touch` enlarges hit areas for finger input. Persisted via WrStorage and overrideable per-subtree with the `[wrDensity]` directive.
 
 ## ngwr/descriptions
 - import: `import { WrDescriptions } from 'ngwr/descriptions'`
@@ -232,6 +268,10 @@
 - exports: WrDialog, WrDialogRef, WR_DIALOG_DATA, WR_DIALOG_REF, WrDialogOptions, WrDialogTitle, WrDialogContent, WrDialogFooter, WrDialogClose
 - Modal dialogs via a service that wraps @angular/cdk/dialog. Open any component as a dialog and read its close result as a Promise.
 
+## ngwr/dialog/testing
+- import: `import { WrDialogHarness } from 'ngwr/dialog/testing'`
+- exports: WrDialogHarness, WrDialogHarnessFilters
+
 ## ngwr/directives
 - import: `import { WrAutofocus } from 'ngwr/directives'`
 - selector: `[wrAutofocus]`, `textarea[wrAutosize]`, `[wrClickOutside]`, `[wrCopyToClipboard]`
@@ -261,12 +301,20 @@
 - exports: WrDrawer, WrDrawerManager, WrDrawerRef, WR_DRAWER_DATA, WR_DRAWER_REF, WrDrawerTitle, WrDrawerContent, WrDrawerFooter, WrDrawerClose, WrDrawerOptions, WrDrawerPosition
 - Side panel that slides in from any edge. Use the component when the markup lives in your template, or `WrDrawerManager` to open any component as a drawer and read its close result.
 
+## ngwr/drawer/testing
+- import: `import { WrDrawerHarness } from 'ngwr/drawer/testing'`
+- exports: WrDrawerHarness, WrDrawerHarnessFilters
+
 ## ngwr/dropdown
 - import: `import { WrDropdown } from 'ngwr/dropdown'`
 - selector: `wr-dropdown-item`, `wr-dropdown-menu`, `[wrDropdown]`
 - exports: WrDropdown, WrDropdownMenu, WrDropdownItem, WrDropdownPosition, WrDropdownTrigger
 - Attach a floating menu to any trigger via the wrDropdown directive. Built on CDK Overlay — handles outside clicks, Escape, and edge collisions.
 
+## ngwr/dropdown/testing
+- import: `import { WrDropdownHarness } from 'ngwr/dropdown/testing'`
+- exports: WrDropdownHarness, WrDropdownItemHarness, WrDropdownHarnessFilters, WrDropdownItemHarnessFilters
+
 ## ngwr/empty
 - import: `import { WrEmpty } from 'ngwr/empty'`
 - selector: `wr-empty`
@@ -291,12 +339,20 @@
 - exports: WrFileUpload, WrFileUploadRejection, WrFileUploadRejectionReason
 - Drag-and-drop zone with click-to-browse and an optional file list. Value type is `File | File[] | null`. Rejected files surface through the `(rejected)` output.
 
+## ngwr/file-upload/testing
+- import: `import { WrFileUploadHarness } from 'ngwr/file-upload/testing'`
+- exports: WrFileUploadHarness, WrFileUploadHarnessFilters
+
 ## ngwr/form
 - import: `import { WrFormItem } from 'ngwr/form'`
 - selector: `wr-form-error`, `wr-form-field`, `wr-form-item`
 - exports: WrFormItem, WrFormField, WrFormError, WR_FORM_FIELD, WrFormFieldContext, WR_FORM_ERRORS, WR_FORM_ERROR_FALLBACKS, provideWrFormErrors, WrFormErrorContext, WrFormErrorMessage, WrFormErrorMessages
 - Layout helpers: <wr-form-item> wraps a label + control + error message; <wr-form-error> renders inline error text.
 
+## ngwr/form/testing
+- import: `import { WrFormFieldHarness } from 'ngwr/form/testing'`
+- exports: WrFormFieldHarness, WrFormItemHarness, WrFormFieldError, WrFormFieldErrorSource, WrFormFieldHarnessFilters, WrFormItemHarnessFilters
+
 ## ngwr/fuzzy-text
 - import: `import { WrFuzzyText } from 'ngwr/fuzzy-text'`
 - selector: `wr-fuzzy-text`
@@ -373,12 +429,24 @@
 - exports: WrInputNumber
 - Numeric input with locale-aware formatting and ▲▼ stepper buttons. Value is `number | null`. Parses leniently while typing, re-formats with grouping + fixed decimals on blur.
 
+## ngwr/input-number/testing
+- import: `import { WrInputNumberHarness } from 'ngwr/input-number/testing'`
+- exports: WrInputNumberHarness, WrInputNumberHarnessFilters
+
 ## ngwr/input-otp
 - import: `import { WrInputOtp } from 'ngwr/input-otp'`
 - selector: `wr-input-otp`
 - exports: WrInputOtp, WrInputOtpMode, WrInputOtpSize
 - Fixed-length one-time-code input. One cell per character, auto-advances focus on typing, handles paste of a full code, optional masking like a password field.
 
+## ngwr/input-otp/testing
+- import: `import { WrInputOtpBoxHarness } from 'ngwr/input-otp/testing'`
+- exports: WrInputOtpBoxHarness, WrInputOtpHarness, WrInputOtpBoxHarnessFilters, WrInputOtpHarnessFilters
+
+## ngwr/input/testing
+- import: `import { WrInputHarness } from 'ngwr/input/testing'`
+- exports: WrInputHarness, WrInputHarnessFilters
+
 ## ngwr/keyboard
 - import: `import { WrKbd } from 'ngwr/keyboard'`
 - selector: `wr-kbd`
@@ -389,7 +457,7 @@
 - import: `import { WrKnob } from 'ngwr/knob'`
 - selector: `wr-knob`
 - exports: WrKnob
-- Radial dial input. CVA-backed `number | null`. Drag around the dial or use arrow keys (Shift = ×10).
+- Radial dial input. A signal-forms native control: the value is a `number`, snapped to `step` and clamped to `[min, max]`. Drag around the dial or use arrow keys (Shift = ×10); Home / End jump to the ends.
 
 ## ngwr/layout
 - import: `import { WrLayout } from 'ngwr/layout'`
@@ -421,6 +489,16 @@
 - exports: WrLoadingBar, WrLoadingState, WrLoadingBarComponent
 - Top-of-page progress bar driven by router navigations out of the box, plus a manual `start()` / `complete()` slot API for HTTP interceptors or any long-running task.
 
+## ngwr/markdown
+- import: `import { WrMarkdown } from 'ngwr/markdown'`
+- selector: `wr-markdown`
+- exports: WrMarkdown, WrMarkdownHighlight, parseMarkdown, parseInlines, plainText, safeMarkdownUrl, provideWrMarkdownHighlighter, WR_MARKDOWN_HIGHLIGHTER, WrHighlightLine, WrHighlightSpan, WrMarkdownAlign, WrMarkdownBlock, WrMarkdownCell, WrMarkdownHighlighter, WrMarkdownInline, WrMarkdownListItem, WrMarkdownParseOptions
+- Renders markdown as DOM, not as HTML. Built for streamed model output, and useful for any markdown an app does not write itself — comments, release notes, a README. Raw HTML in the source is escaped rather than rendered, and nothing in the pipeline is ever parsed as HTML.
+
+## ngwr/markdown/testing
+- import: `import { WrMarkdownCodeBlockHarness } from 'ngwr/markdown/testing'`
+- exports: WrMarkdownCodeBlockHarness, WrMarkdownHarness, WrMarkdownCodeBlockHarnessFilters, WrMarkdownHarnessAlign, WrMarkdownHarnessFilters, WrMarkdownHarnessHeading, WrMarkdownHarnessImage, WrMarkdownHarnessLink, WrMarkdownHarnessTable, WrMarkdownHarnessTaskItem
+
 ## ngwr/marquee
 - import: `import { WrMarquee } from 'ngwr/marquee'`
 - selector: `wr-marquee`
@@ -438,6 +516,10 @@
 - exports: WrMention, WrMentionPanel, WrMentionItem, WrMentionCommit
 - `@`-style mention picker for `<textarea>` and `<input>`. Detects trigger characters at word boundaries, opens an overlay at the caret, commits the selection back into the field.
 
+## ngwr/mention/testing
+- import: `import { WrMentionHarness } from 'ngwr/mention/testing'`
+- exports: WrMentionHarness, WrMentionOptionHarness, WrMentionHarnessFilters, WrMentionOptionHarnessFilters
+
 ## ngwr/meta
 - import: `import { WrMeta } from 'ngwr/meta'`
 - selector: `[wrMeta]`
@@ -452,7 +534,7 @@
 
 ## ngwr/overlay
 - import: `import { WrOutsideClick } from 'ngwr/overlay'`
-- exports: wrAppendOverlayClose, WrOutsideClick, WrOverlayContainer, provideWrOverlay, provideWrResponsiveOverlays, WR_OVERLAY, WR_OVERLAY_CONTAINER, WR_RESPONSIVE_OVERLAYS, wrPresentAsSheet
+- exports: wrAppendOverlayClose, wrMirrorOffsets, WrOutsideClick, WrOverlayContainer, provideWrOverlay, provideWrResponsiveOverlays, WR_OVERLAY, WR_OVERLAY_CONTAINER, WR_RESPONSIVE_OVERLAYS, wrPresentAsSheet
 
 ## ngwr/page-header
 - import: `import { WrPageHeader } from 'ngwr/page-header'`
@@ -466,6 +548,11 @@
 - exports: WrPagination, WrPaginationAlign, WrPaginationSize, WrPaginationShape
 - Numbered page navigator. Two-way binds currentPage and pageSize via signal models.
 
+## ngwr/pagination/testing
+- import: `import { WrPaginationHarness } from 'ngwr/pagination/testing'`
+- selector: `.wr-pagination__page`, `.wr-pagination__nav > wr-btn:not(.wr-pagination__page)`, `.wr-pagination__size`, `.wr-pagination__page[aria-current="page"]`
+- exports: WrPaginationHarness, WrPaginationHarnessFilters
+
 ## ngwr/pipes
 - import: `import { WrBytes } from 'ngwr/pipes'`
 - exports: WrBytes, WrDate, WrMark, WrNumber, WrNumberStyle, WrPlural, WrPluralForms, WrPluralOptions, WrRange, WrTruncate
@@ -481,12 +568,20 @@
 - exports: WrPopconfirm, WrPopconfirmPanel, WrPopconfirmPosition
 - Small "Are you sure?" panel anchored to its trigger. Emits confirmed or cancelled.
 
+## ngwr/popconfirm/testing
+- import: `import { WrPopconfirmHarness } from 'ngwr/popconfirm/testing'`
+- exports: WrPopconfirmHarness, WrPopconfirmHarnessFilters
+
 ## ngwr/popover
 - import: `import { WrPopover } from 'ngwr/popover'`
 - selector: `[wrPopover]`
 - exports: WrPopover, WrPopoverPosition
 - Anchored content panel. Project a template (popover) or pass a plain string (tooltip — use `mode="tooltip"`). Click, hover, or focus to open. Built on CDK Overlay.
 
+## ngwr/popover/testing
+- import: `import { WrPopoverHarness } from 'ngwr/popover/testing'`
+- exports: WrPopoverHarness, WrPopoverHarnessFilters
+
 ## ngwr/progress
 - import: `import { WrProgress } from 'ngwr/progress'`
 - selector: `wr-progress`
@@ -511,12 +606,20 @@
 - exports: WrRadio, WrRadioSize, WrRadioGroup, WR_RADIO_GROUP, WrRadioGroupContext
 - Single-choice option. Always used inside <wr-radio-group>, which is the form control: it implements `FormValueControl`, so `[formField]` binds straight to its `value` model. `[(value)]` works standalone, and `[(ngModel)]` / reactive forms keep working through Angular's bridge.
 
+## ngwr/radio/testing
+- import: `import { WrRadioGroupHarness } from 'ngwr/radio/testing'`
+- exports: WrRadioGroupHarness, WrRadioHarness, WrRadioGroupHarnessFilters, WrRadioHarnessFilters
+
 ## ngwr/rating
 - import: `import { WrRating } from 'ngwr/rating'`
 - selector: `wr-rating`
 - exports: WrRating, WrRatingSize
 - Star rating input with whole or half-step granularity. Value type is `number | null` (clamped to `[0, count]`). Keyboard: arrows step by `step`, Home / End jump to 0 / max, Delete / Backspace clears.
 
+## ngwr/rating/testing
+- import: `import { WrRatingHarness } from 'ngwr/rating/testing'`
+- exports: WrRatingHarness, WrRatingItemHarness, WrRatingHarnessFilters, WrRatingItemHarnessFilters
+
 ## ngwr/result
 - import: `import { WrResult } from 'ngwr/result'`
 - selector: `wr-result-404`, `wr-result-403`, `wr-result-500`, `wr-result`
@@ -540,12 +643,20 @@
 - exports: WrSegmented, WrSegmentedOption, WrSegmentedSize
 - Single-choice picker rendered as a segmented control. Two-way binds the selected value.
 
+## ngwr/segmented/testing
+- import: `import { WrSegmentedHarness } from 'ngwr/segmented/testing'`
+- exports: WrSegmentedHarness, WrSegmentedOptionHarness, WrSegmentedHarnessFilters, WrSegmentedOptionHarnessFilters
+
 ## ngwr/select
 - import: `import { WrSelect } from 'ngwr/select'`
 - selector: `wr-option-group`, `wr-option`, `wr-select`
 - exports: WrSelect, WrOption, WrOptionGroup, WR_SELECT, WrSelectContext, WrSelectMode, WrSelectSearchLoader, WrSelectTagValidator, WrSelectSize
 - Native-like select built on CDK Overlay. A signal-forms native control — it implements `FormValueControl`, so `[formField]` binds straight to its `value` model. `[(value)]` works standalone, and `[(ngModel)]` / reactive forms keep working through Angular's bridge.
 
+## ngwr/select/testing
+- import: `import { WrOptionHarness } from 'ngwr/select/testing'`
+- exports: WrOptionHarness, WrSelectHarness, WrOptionHarnessFilters, WrSelectHarnessFilters
+
 ## ngwr/shiny-text
 - import: `import { WrShinyText } from 'ngwr/shiny-text'`
 - selector: `[wrShimmer]`, `wr-shiny-text`
@@ -570,6 +681,10 @@
 - exports: WrSlider, WrSliderValue
 - Drag-to-pick numeric input. Single-thumb by default, optional dual-thumb range mode. A signal-forms native control — it implements `FormValueControl`, so `[formField]` binds straight to its `value` model. `[(value)]` works standalone, and template-driven `[(ngModel)]` / reactive forms keep working through Angular's bridge.
 
+## ngwr/slider/testing
+- import: `import { WrSliderHarness } from 'ngwr/slider/testing'`
+- exports: WrSliderHarness, WrSliderThumbHarness, WrSliderHarnessFilters, WrSliderThumbHarnessFilters, WrSliderThumbPosition
+
 ## ngwr/sparkline
 - import: `import { WrSparkline } from 'ngwr/sparkline'`
 - selector: `wr-sparkline`
@@ -636,6 +751,10 @@
 - exports: WrStepper, WrStep, WR_STEPPER, WrStepperContext
 - Multi-step wizard. Numbered headers with completed / active / pending states, content body for the active step. Two-way bind `[(active)]` to the step index.
 
+## ngwr/stepper/testing
+- import: `import { WrStepHarness } from 'ngwr/stepper/testing'`
+- exports: WrStepHarness, WrStepperHarness, WrStepHarnessFilters, WrStepperHarnessFilters
+
 ## ngwr/storage
 - import: `import { WrStorage } from 'ngwr/storage'`
 - exports: WrStorage, provideWrStorage, ProvideWrStorageOptions, WR_STORAGE_CONFIG, DEFAULT_WR_STORAGE_CONFIG, WrStorageConfig, WrStorageConfigResolved, WR_STORAGE_ENGINE, createMemoryStorage, WrStorageEngine
@@ -647,24 +766,40 @@
 - exports: WrSwitch, WrSwitchSize
 - Boolean toggle with an iOS-style slider. A signal-forms native control — it implements `FormCheckboxControl`, so `[formField]` binds straight to its `checked` model. `[(checked)]` works standalone, and `[(ngModel)]` / reactive forms keep working through Angular's bridge.
 
+## ngwr/switch/testing
+- import: `import { WrSwitchHarness } from 'ngwr/switch/testing'`
+- exports: WrSwitchHarness, WrSwitchHarnessFilters
+
 ## ngwr/table
 - import: `import { WrTable } from 'ngwr/table'`
 - selector: `[wrTableCell]`, `ng-template[wrTableExpand]`, `wr-table-filter`, `ng-template[wrTableGroupHeader]`, `wr-table-sort`, `wr-table`
 - exports: WrTable, WrTableCell, WrTableExpand, WrTableGroupHeader, WrTableSort, WrTableFilter, WrTableCellContext, WrTableColumn, WrTableColumns, WrTableCsvOptions, WrTableExpandContext, WrTableFilterChange, WrTableFilterItem, WrTableGroupContext, WrTableSortState, WrTableSortDirection, WrTableSummary
 - Data table with sortable / filterable headers and custom cell templates.
 
+## ngwr/table/testing
+- import: `import { WrTableCellHarness } from 'ngwr/table/testing'`
+- exports: WrTableCellHarness, WrTableHarness, WrTableHeaderCellHarness, WrTableRowHarness, WrTableCellHarnessFilters, WrTableHarnessFilters, WrTableHeaderCellHarnessFilters, WrTableRowHarnessFilters
+
 ## ngwr/tabs
 - import: `import { WrTabs } from 'ngwr/tabs'`
 - selector: `wr-tab`, `wr-tabs`
 - exports: WrTabs, WrTab, WR_TABS, WrTabsContext
 - Tabbed container. Use projected content for simple tabs, or set routerLink on children to switch into router mode.
 
+## ngwr/tabs/testing
+- import: `import { WrTabHarness } from 'ngwr/tabs/testing'`
+- exports: WrTabHarness, WrTabsHarness, WrTabHarnessFilters, WrTabsHarnessFilters, WrTabsHarnessSize
+
 ## ngwr/textarea
 - import: `import { WrTextarea } from 'ngwr/textarea'`
 - selector: `wr-textarea`
 - exports: WrTextarea, WrTextareaSize, WrTextareaResize
 - Multi-line text input with optional autosize. A signal-forms native control — it implements `FormValueControl`, so `[formField]` binds straight to its `value` model. `[(value)]` works standalone, and `[(ngModel)]` / reactive forms keep working through Angular's bridge.
 
+## ngwr/textarea/testing
+- import: `import { WrTextareaHarness } from 'ngwr/textarea/testing'`
+- exports: WrTextareaHarness, WrTextareaHarnessFilters
+
 ## ngwr/theme
 - import: `import { WrTheme } from 'ngwr/theme'`
 - exports: WR_COLORS, WrColor, WrTheme, provideWrTheme, WR_THEME_CONFIG, DEFAULT_WR_THEME_CONFIG, WrResolvedTheme, WrThemeMode, WrThemeConfig
@@ -688,6 +823,10 @@
 - exports: WrToast, WrToastRef, provideWrToastConfig, DEFAULT_TOAST_CONFIG, WR_TOAST_CONFIG, WrToastConfig, WrToastMode, WrToastOptions, WrToastPosition, WrToastType
 - Stack of dismissible notifications anchored to a viewport corner. Service-driven; rendered in a single shared CDK overlay.
 
+## ngwr/toast/testing
+- import: `import { WrToastHarness } from 'ngwr/toast/testing'`
+- exports: WrToastHarness, WrToastHarnessFilters
+
 ## ngwr/toolbar
 - import: `import { WrToolbar } from 'ngwr/toolbar'`
 - selector: `wr-toolbar`
@@ -706,12 +845,20 @@
 - exports: WrTransfer, WrTransferItem
 - Dual listbox — two panes and the buttons that move rows between them. The RIGHT pane is the value.
 
+## ngwr/transfer/testing
+- import: `import { WrTransferHarness } from 'ngwr/transfer/testing'`
+- exports: WrTransferHarness, WrTransferItemHarness, WrTransferPaneHarness, WrTransferHarnessFilters, WrTransferItemHarnessFilters, WrTransferPaneHarnessFilters, WrTransferSide
+
 ## ngwr/tree
 - import: `import { WrTree } from 'ngwr/tree'`
 - selector: `wr-tree`
 - exports: WrTree, WrTreeNode, WrTreeSelectionMode
 - Hierarchical list with expand / collapse, selection (single or multi), and full keyboard navigation. Renders inline (display widget) or as a `wr-select`-style combobox via `openOn="overlay"` (form-bound picker — replaces the standalone `wr-tree-select`).
 
+## ngwr/tree/testing
+- import: `import { WrTreeHarness } from 'ngwr/tree/testing'`
+- exports: WrTreeHarness, WrTreeNodeHarness, WrTreeHarnessFilters, WrTreeNodeHarnessFilters
+
 ## ngwr/typewriter
 - import: `import { WrTypewriter } from 'ngwr/typewriter'`
 - selector: `wr-typewriter`

package/llms.txt

@@ -1,7 +1,7 @@
 # ngwr
 
 > Angular UI library — standalone, signals-first, zoneless, fully tree-shakable.
-> 130 secondary entry points, 188 component and directive classes, built on
+> 166 secondary entry points, 181 component and directive classes, built on
 > `@angular/cdk` primitives. The only runtime dependency is `tslib`. Docs and
 > live demos: https://ngwr.dev — source: https://github.com/thekhegay/ngwr
 
@@ -48,6 +48,13 @@ Add from their entry points as needed:
 - `provideWrIcons(lucideIcons({ check: Check }))` — icon registry (`ngwr/icon`,
   adapters under `ngwr/icon/adapters/*`).
 - `provideWrTheme()` — `--wr-*` design tokens. `provideWrDensity()` — sizing.
+- `provideWrConfig({ button: { size: 'sm' }, select: { rounded: true } })`
+  (`ngwr/config`) — app-wide component DEFAULTS. A value bound on the element always
+  wins, and a bound `false` beats a configured `true`, so a config never has to be
+  escaped. Covers `size` on the form controls, `rounded` on `input` / `inputNumber`
+  / `select`, and `linkTarget` / `copyable` on `markdown`. There is deliberately no
+  `color` key — a bound `[color]="null"` means "no intent", which a default cannot
+  express without inventing a sentinel.
 - `provideWrI18n(...)` + `provideWrI18nStaticLoader(...)` — localization.
 - `provideWrDateAdapter(...)` — calendar + date-picker (`ngwr/date-adapter-fns`
   or `ngwr/date-adapter-luxon`).
@@ -85,19 +92,22 @@ before writing your own. Full catalog: https://ngwr.dev/reference/components.
   `wr-input-number`, `wr-input-otp`, `wr-date-picker` (date/time/datetime) and
   `wr-date-range-picker` (both in ngwr/date-picker; the range value is
   `[start, end]`, hence a separate component), `wr-file-upload`,
-  `wr-form-field`, `wr-color-picker`, `wr-transfer` (dual listbox; the value
-  is the RIGHT pane).
+  `wr-form-field` (in ngwr/form), `wr-color-picker`, `wr-transfer` (dual listbox;
+  the value is the RIGHT pane).
 - **Data** — `wr-table` (column pin/resize/drag-reorder, row selection,
   expandable rows, grouping, tree rows (`childrenKey`), summary rows,
   CSV export, virtualized body),
   `wr-pagination`, `wr-tree`, `wr-virtual-scroll`, `wr-sortable-list`
-  (drag-to-reorder).
+  (drag-to-reorder, with `[wrDragHandle]` — both in ngwr/drag-drop).
 - **Feedback** — `wr-alert`, `wr-result`, `wr-empty`, `wr-skeleton`,
   `wr-spinner`.
 - **Layout / Display** — `wr-card`, `wr-carousel`, `wr-collapse`, `wr-splitter`,
   `wr-toolbar`, `wr-descriptions`, `wr-statistic`, `wr-lightbox`,
-  `wr-pull-to-refresh`.
-- **Navigation** — `wr-tabs`, `wr-stepper`, `wr-breadcrumbs`, `wr-dropdown-menu`.
+  `wr-pull-to-refresh`, `wr-markdown` (renders markdown as DOM, never as HTML —
+  raw HTML in the source is escaped; `[streaming]` for a partial document;
+  `provideWrMarkdownHighlighter()` takes coloured spans, not markup).
+- **Navigation** — `wr-tabs`, `wr-stepper`, `wr-breadcrumbs`, `wr-dropdown-menu`
+  (with its `[wrDropdown]` trigger — both in ngwr/dropdown).
 - **Overlays** — `wr-drawer` (or `WrDrawerManager.open()` to open a component as
   a drawer from code), `wr-action-sheet`, `[wrPopover]` (directive; has a
   `tooltip` mode), `wr-command-palette`, `wr-context-menu`, `wr-popconfirm`.
@@ -118,14 +128,43 @@ before writing your own. Full catalog: https://ngwr.dev/reference/components.
   by `provideWrTheme()`. Two contrast tokens per intent, easy to confuse:
   `--wr-color-<intent>-contrast` is the label ON a filled intent;
   `--wr-color-<intent>-ink` is the intent used AS text on a surface or its own
-  `-soft` tint. A bare `--wr-color-<intent>` as text fails WCAG AA in light. For
-  muted prose use `--wr-color-on-surface-muted`, not the `medium` intent.
+  `-soft` tint. A bare `--wr-color-<intent>` as text clears AA on a plain light
+  surface for every intent but `warning` and `light`, but still fails on the `-soft`
+  tint — which is exactly where outlined / ghost / tinted variants paint it, so use
+  `-ink` there. For muted prose use `--wr-color-on-surface-muted`, not the `medium`
+  intent.
 - **Mobile** — overlays collapse to sheets (`provideWrResponsiveOverlays()`), a
   `responsive` input reflows layout components, a `touch` density preset enlarges
   controls, and `WrHaptics` (ngwr/platform) fires vibration feedback.
 - **Large datasets** — `virtualScroll` is an opt-in input on `wr-table`,
   `wr-tree` and `wr-select` (search mode), alongside the standalone
   `wr-virtual-scroll` wrapper.
+- **Testing** — CDK component harnesses ship beside the components they drive, at
+  `ngwr/<name>/testing`. 34 entry points so far, 61 harness classes, covering the
+  form controls, the overlays, both data views, the navigation / disclosure set
+  (`tabs`, `stepper`, `carousel`, `pagination`, `segmented`, `collapse`,
+  `transfer`) and `markdown`: the form controls
+  (`button`, `input`, `textarea`, `checkbox`, `switch`, `radio`, `select`,
+  `input-number`, `input-otp`, `slider`, `rating`, `file-upload`, `form` for
+  `<wr-form-field>`), the overlays (`date-picker`, `dropdown`, `popover`, `dialog`,
+  `drawer`, `toast`, `context-menu`, `popconfirm`, `command-palette`, `cascader`,
+  `mention`) and the data views (`table`, `tree`). `color-picker` and
+  `action-sheet` are the two that have none yet.
+  Load them with `TestbedHarnessEnvironment` and narrow with
+  `WrButtonHarness.with({ text: 'Save' })` instead of querying ngwr's markup.
+  Dialog, toast and a service-opened drawer render outside the fixture — load
+  those from `documentRootLoader()`; everything else is an element in your
+  template, and where its panel is in the overlay the harness reaches it for you,
+  scoped to that instance by the id the trigger publishes.
+  Many are families: `WrTableHarness` + row / cell / header-cell, `WrTreeHarness`
+  + node, `WrCascaderHarness` + column / option, `WrCommandPaletteHarness` +
+  group / item, `WrRadioGroupHarness` + radio, `WrSliderHarness` + thumb,
+  `WrInputOtpHarness` + box, `WrRatingHarness` + item, `WrContextMenuHarness` +
+  item (submenus included), `WrMentionHarness` + option, `WrTransferHarness` +
+  pane / item, `WrMarkdownHarness` + code block.
+  A unit test has no layout, so anything a mouse would drag (slider, rating,
+  file-upload's drop zone) is driven by the KEYBOARD or by real events, never by
+  coordinates. Guide: https://ngwr.dev/guides/testing
 - **Scheduling** — `wr-event-calendar` covers month / week / day in one
   component. `events` is an input the calendar never writes to: a drag emits
   `eventChange` with the proposed start / end, and you apply it. Event `end` is
@@ -143,6 +182,16 @@ before writing your own. Full catalog: https://ngwr.dev/reference/components.
   prose and code samples and API tables, without the site chrome. Prefer it over
   `llms-full.txt` when you already know which component you need. Each HTML page
   advertises its twin as `<link rel="alternate" type="text/markdown">`.
+- **MCP server — the same files, askable.** `npx -y ngwr-mcp` (a bin in the
+  installed package; zero dependencies, JSON-RPC over stdio) exposes four tools:
+  `search_ngwr` turns a need into an entry point name, `get_ngwr_component`
+  summarises one entry point, `get_ngwr_api` returns a class's inputs / models /
+  outputs read out of the shipped `.d.ts`, and `get_ngwr_setup` returns the
+  install / `ng g ngwr:use` / provider commands as text — it never runs them,
+  and it never reaches outside its own package: no network, no commands. It reads the resources
+  listed here rather than embedding a copy of them. Client config for Claude
+  Code / Claude Desktop / Cursor, and a worked example of each tool:
+  https://ngwr.dev/guides/mcp
 - All site URLs (for crawlers): https://ngwr.dev/sitemap.xml
 - Source, README, per-component `.d.ts` types: https://github.com/thekhegay/ngwr
   (installed at `node_modules/ngwr/types/ngwr-<name>.d.ts`; the package also

package/loading-bar/styles/_index.scss

@@ -6,8 +6,7 @@
 .wr-loading-bar {
   position: fixed;
   top: 0;
-  left: 0;
-  right: 0;
+  inset-inline: 0;
   z-index: var(--wr-z-top, 9999);
   pointer-events: none;