ngwr 11.1.0 → 12.0.0

package/llms-full.txt

@@ -13,6 +13,10 @@
 - exports: WrActionSheet, WrActionSheetAction
 - An iOS-style bottom sheet of choices — a data-driven preset over the drawer, with destructive and cancel roles.
 
+## ngwr/action-sheet/testing
+- import: `import { WrActionSheetActionHarness } from 'ngwr/action-sheet/testing'`
+- exports: WrActionSheetActionHarness, WrActionSheetHarness, WrActionSheetActionHarnessFilters, WrActionSheetHarnessFilters
+
 ## ngwr/affix
 - import: `import { WrAffix } from 'ngwr/affix'`
 - selector: `[wrAffix]`
@@ -61,18 +65,30 @@
 - exports: WrBarChart, WrBarChartDatum
 - Vertical bars, one series. Per-bar color overrides via the `color` field.
 
+## ngwr/bar-chart/testing
+- import: `import { WrBarChartHarness } from 'ngwr/bar-chart/testing'`
+- exports: WrBarChartHarness, WrBarChartBar, WrBarChartHarnessFilters
+
 ## ngwr/blur-text
 - import: `import { WrBlurText } from 'ngwr/blur-text'`
 - selector: `wr-blur-text`
-- exports: WrBlurText
+- exports: WrBlurText, WrBlurTextDirection, WrBlurTextUnit
 - Reveals text by blurring each piece in from a coloured offset, through a half-blurred mid-step, into the steady state. Triggers on viewport entry. Dependency-free port — uses `IntersectionObserver` + Web Animations API.
 
+## ngwr/blur-text/testing
+- import: `import { WrBlurTextHarness } from 'ngwr/blur-text/testing'`
+- exports: WrBlurTextHarness, WrBlurTextHarnessFilters
+
 ## ngwr/border-glow
 - import: `import { WrBorderGlow } from 'ngwr/border-glow'`
 - selector: `wr-border-glow`
 - exports: WrBorderGlow
 - Cursor-tracked glowing border card. A cone of light follows the pointer along the perimeter, brightening as the cursor approaches an edge. Optional `[animated]` mode plays a one-shot sweep on mount.
 
+## ngwr/border-glow/testing
+- import: `import { WrBorderGlowHarness } from 'ngwr/border-glow/testing'`
+- exports: WrBorderGlowHarness, WrBorderGlowHarnessFilters
+
 ## ngwr/breadcrumbs
 - import: `import { WrBreadcrumbs } from 'ngwr/breadcrumbs'`
 - selector: `wr-breadcrumbs-item`, `wr-breadcrumbs`
@@ -107,6 +123,14 @@
 - exports: WrCalendarHeatmap, WrHeatmapDatum
 - Year-grid heatmap — the classic GitHub contributions layout.
 
+## ngwr/calendar-heatmap/testing
+- import: `import { WrCalendarHeatmapHarness } from 'ngwr/calendar-heatmap/testing'`
+- exports: WrCalendarHeatmapHarness, WrCalendarHeatmapCell, WrCalendarHeatmapHarnessFilters
+
+## ngwr/calendar/testing
+- import: `import { WrCalendarDayHarness } from 'ngwr/calendar/testing'`
+- exports: WrCalendarDayHarness, WrCalendarHarness, WrCalendarChip, WrCalendarDayHarnessFilters, WrCalendarHarnessFilters, WrCalendarView
+
 ## ngwr/card
 - import: `import { WrCard } from 'ngwr/card'`
 - selector: `wr-card`, `wr-card-header`, `wr-card-footer`
@@ -116,7 +140,7 @@
 ## ngwr/carousel
 - import: `import { WrCarousel } from 'ngwr/carousel'`
 - selector: `wr-carousel-slide`, `wr-carousel`
-- exports: WrCarousel, WrCarouselSlide
+- exports: WrCarousel, WrCarouselSlide, WR_CAROUSEL, WrCarouselContext
 - 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
@@ -149,6 +173,10 @@
 - exports: WrCircularText, WrCircularTextHover
 - Text laid out around a circle, with the whole circle spinning on a keyframe. Hover behaviour swaps the spin rate (or pauses) without resetting the rotation angle. Pure CSS port — no JS animation loop.
 
+## ngwr/circular-text/testing
+- import: `import { WrCircularTextHarness } from 'ngwr/circular-text/testing'`
+- exports: WrCircularTextHarness, WrCircularTextHarnessFilters
+
 ## ngwr/click-spark
 - import: `import { WrClickSpark } from 'ngwr/click-spark'`
 - selector: `wr-click-spark`
@@ -176,6 +204,10 @@
 - exports: WrColorPicker, WrColorPickerTrigger, hslToRgb, hsvToRgb, parseHex, rgbToHsl, rgbToHsv, toHex, WrHsl, WrHsv, WrRgb, WrColorFormat
 - HSV canvas + hue / alpha sliders + HEX / RGB / HSL inputs + optional swatches. Use `<wr-color-picker>` inline or anchor it to a button with `[wrColorPickerTrigger]`.
 
+## ngwr/color-picker/testing
+- import: `import { WrColorPickerHarness } from 'ngwr/color-picker/testing'`
+- exports: WrColorPickerHarness, WrColorPickerTriggerHarness, WrColorPickerHarnessFilters, WrColorPickerTab, WrColorPickerThumbs, WrColorPickerTriggerHarnessFilters
+
 ## ngwr/command-palette
 - import: `import { WrCommandPalette } from 'ngwr/command-palette'`
 - selector: `wr-command-palette`
@@ -222,18 +254,10 @@
 - exports: WrCounter, WrCounterMode, WrCountUp, WrCountUpDirection, WrCountUpEasing, WrCountUpTrigger
 - Animated number display. Use **odometer** mode for rolling-digit motion (mechanical counter look) or **tween** mode for an eased count-up from the previous value.
 
-## ngwr/date-adapter
-- import: `import { WrDateAdapter } from 'ngwr/date-adapter'`
+## ngwr/date
+- import: `import { WrDateAdapter } from 'ngwr/date'`
 - exports: WrDateAdapter, WrNativeDateAdapter, provideWrDateAdapter, WrDateAdapterOptions, WR_DATE_LOCALE, WrDateFormat, isNamedFormat
 
-## ngwr/date-adapter-fns
-- import: `import { WrDateFnsAdapter } from 'ngwr/date-adapter-fns'`
-- exports: WrDateFnsAdapter, provideWrDateFnsAdapter
-
-## ngwr/date-adapter-luxon
-- import: `import { WrLuxonAdapter } from 'ngwr/date-adapter-luxon'`
-- exports: WrLuxonAdapter, provideWrLuxonAdapter
-
 ## ngwr/date-picker
 - import: `import { WrDatePicker } from 'ngwr/date-picker'`
 - selector: `wr-date-picker`, `wr-date-range-picker`
@@ -244,12 +268,24 @@
 - import: `import { WrDatePickerDayHarness } from 'ngwr/date-picker/testing'`
 - exports: WrDatePickerDayHarness, WrDatePickerHarness, WrDateRangePickerHarness, WrDatePickerDayHarnessFilters, WrDatePickerHarnessFilters, WrDatePickerTimeFields, WrDateRangePickerHarnessFilters
 
+## ngwr/date/adapters/fns
+- import: `import { WrDateFnsAdapter } from 'ngwr/date/adapters/fns'`
+- exports: WrDateFnsAdapter, provideWrDateFnsAdapter
+
+## ngwr/date/adapters/luxon
+- import: `import { WrLuxonAdapter } from 'ngwr/date/adapters/luxon'`
+- exports: WrLuxonAdapter, provideWrLuxonAdapter
+
 ## ngwr/decrypt-text
 - import: `import { WrDecryptText } from 'ngwr/decrypt-text'`
 - selector: `wr-decrypt-text`
 - exports: WrDecryptText, WrDecryptTextAnimateOn, WrDecryptTextClickMode, WrDecryptTextRevealDirection
 - Reveals a string by scrambling characters and progressively replacing scramble glyphs with the originals. Sequential reveal in three directions, or non-sequential settle after N iterations. Four trigger modes: hover, click, view, in-view + hover. Dependency-free port — signals + `setInterval`.
 
+## ngwr/decrypt-text/testing
+- import: `import { WrDecryptTextHarness } from 'ngwr/decrypt-text/testing'`
+- exports: WrDecryptTextHarness, WrDecryptTextHarnessFilters
+
 ## ngwr/density
 - import: `import { WrDensity } from 'ngwr/density'`
 - selector: `[wrDensity]`
@@ -289,6 +325,10 @@
 - exports: WrDonutChart, WrDonutSegment
 - Ring chart with optional center label / value. Set `thickness="0"` for a solid pie.
 
+## ngwr/donut-chart/testing
+- import: `import { WrDonutChartHarness } from 'ngwr/donut-chart/testing'`
+- exports: WrDonutChartHarness, WrDonutChartHarnessFilters, WrDonutChartLegendEntry
+
 ## ngwr/drag-drop
 - import: `import { WrSortableList } from 'ngwr/drag-drop'`
 - selector: `[wrDragHandle]`, `wr-sortable-list`
@@ -327,12 +367,20 @@
 - exports: WrEventCalendar, WrCalendarEventTemplate, WrCalendarEvent, WrCalendarEventChange, WrCalendarEventContext, WrCalendarSlot, WrCalendarView
 - Month, week and day views of a set of events — draggable, resizable, keyboard-operable.
 
+## ngwr/event-calendar/testing
+- import: `import { WrEventCalendarChipHarness } from 'ngwr/event-calendar/testing'`
+- exports: WrEventCalendarChipHarness, WrEventCalendarHarness, WrEventCalendarChipHarnessFilters, WrEventCalendarHarnessFilters
+
 ## ngwr/falling-text
 - import: `import { WrFallingText } from 'ngwr/falling-text'`
 - selector: `wr-falling-text`
 - exports: WrFallingText, WrFallingTextTrigger
 - Words fall like physical bodies — gravity, wall / floor collision, body-to-body bouncing, and cursor drag-to-pick-up. Words start at their typeset position and release into the simulator on trigger. Reactbits' original uses matter-js; this port ships a minimal in-house AABB physics simulator so there's no extra runtime dependency.
 
+## ngwr/falling-text/testing
+- import: `import { WrFallingTextHarness } from 'ngwr/falling-text/testing'`
+- exports: WrFallingTextHarness, WrFallingTextHarnessFilters
+
 ## ngwr/file-upload
 - import: `import { WrFileUpload } from 'ngwr/file-upload'`
 - selector: `wr-file-upload`
@@ -359,24 +407,40 @@
 - exports: WrFuzzyText, WrFuzzyTextDirection
 - Canvas-rendered fuzzy text — each row (or column) is offset by a random amount per frame for a TV-static or motion-blur look. Intensity ramps up on hover, click, and during periodic glitch bursts.
 
+## ngwr/fuzzy-text/testing
+- import: `import { WrFuzzyTextHarness } from 'ngwr/fuzzy-text/testing'`
+- exports: WrFuzzyTextHarness, WrFuzzyTextHarnessFilters
+
 ## ngwr/gauge
 - import: `import { WrGauge } from 'ngwr/gauge'`
 - selector: `wr-gauge`
 - exports: WrGauge
 - Semicircle progress display — read-only, perfect for utilisation and score widgets.
 
+## ngwr/gauge/testing
+- import: `import { WrGaugeHarness } from 'ngwr/gauge/testing'`
+- exports: WrGaugeHarness, WrGaugeHarnessFilters
+
 ## ngwr/glitch-text
 - import: `import { WrGlitchText } from 'ngwr/glitch-text'`
 - selector: `wr-glitch-text`
 - exports: WrGlitchText
 - Colour-split horizontal-tear glitch on the provided text. Defaults to glitching on hover; flip `[enableOnHover]` to play constantly. Pure CSS port — two pseudo-element clones with offset coloured shadows and a clip-path keyframe.
 
+## ngwr/glitch-text/testing
+- import: `import { WrGlitchTextHarness } from 'ngwr/glitch-text/testing'`
+- exports: WrGlitchTextHarness, WrGlitchTextColourSplit, WrGlitchTextDurations, WrGlitchTextHarnessFilters
+
 ## ngwr/gradient-text
 - import: `import { WrGradientText } from 'ngwr/gradient-text'`
 - selector: `wr-gradient-text`
 - exports: WrGradientText, WrGradientTextDirection
 - Animated multi-stop gradient text. The gradient slides across the text via `background-clip: text`. Optional border variant wraps the text in a dark pill with the same animated gradient as a border ring. Pure CSS port — no JS animation loop.
 
+## ngwr/gradient-text/testing
+- import: `import { WrGradientTextHarness } from 'ngwr/gradient-text/testing'`
+- exports: WrGradientTextHarness, WrGradientTextHarnessFilters
+
 ## ngwr/hotkey
 - import: `import { WrHotkey } from 'ngwr/hotkey'`
 - selector: `[wrHotkey]`
@@ -417,6 +481,10 @@
 - exports: WrImageCropper, WrCropRect, WrCropHandle, WrImageOutputType
 - DOM-based crop UI. Drag the box to move, drag any of the eight handles to resize. Optional `[aspectRatio]` locks the box shape. `(cropped)` fires with a `Blob` after each drag end — wire to upload or preview.
 
+## ngwr/image-cropper/testing
+- import: `import { WrImageCropperHarness } from 'ngwr/image-cropper/testing'`
+- exports: WrImageCropperHarness, WrCropArrow, WrCropWindowBox, WrImageCropperHarnessFilters
+
 ## ngwr/input
 - import: `import { WrInput } from 'ngwr/input'`
 - selector: `[wrInputPrefix]`, `[wrInputSuffix]`, `input[wrInput]`, `textarea[wrInput]`, `wr-input-group`, `wr-password-toggle`
@@ -459,6 +527,10 @@
 - exports: WrKnob
 - 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/knob/testing
+- import: `import { WrKnobHarness } from 'ngwr/knob/testing'`
+- exports: WrKnobHarness, WrKnobHarnessFilters
+
 ## ngwr/layout
 - import: `import { WrLayout } from 'ngwr/layout'`
 - selector: `wr-layout-content`, `wr-layout-footer`, `wr-layout-header`, `wr-layout-sider`, `wr-layout`
@@ -471,12 +543,20 @@
 - exports: WrLightbox
 - Image with click-to-zoom lightbox. Renders a thumbnail; clicking opens a full-size overlay viewer with backdrop, ESC + click-out to close.
 
+## ngwr/lightbox/testing
+- import: `import { WrLightboxHarness } from 'ngwr/lightbox/testing'`
+- exports: WrLightboxHarness, WrLightboxHarnessFilters
+
 ## ngwr/line-chart
 - import: `import { WrLineChart } from 'ngwr/line-chart'`
 - selector: `wr-line-chart`
 - exports: WrLineChart, WrLineSeries
 - Multi-series line chart with a hover tooltip that snaps to the nearest x-axis tick.
 
+## ngwr/line-chart/testing
+- import: `import { WrLineChartHarness } from 'ngwr/line-chart/testing'`
+- exports: WrLineChartHarness, WrLineChartHarnessFilters, WrLineChartTooltipRow
+
 ## ngwr/list
 - import: `import { WrList } from 'ngwr/list'`
 - selector: `wr-list-item`, `wr-list`
@@ -505,6 +585,10 @@
 - exports: WrMarquee, WrMarqueeItem, WrMarqueeImage, WrMarqueeNode
 - Endless rAF-driven horizontal carousel. Pass items as image sources or Angular templates; the track auto-duplicates to cover the container. Optional edge fades, pause/scale-on-hover, custom hover speed.
 
+## ngwr/marquee/testing
+- import: `import { WrMarqueeHarness } from 'ngwr/marquee/testing'`
+- exports: WrMarqueeHarness, WrMarqueeItemHarness, WrMarqueeHarnessFilters, WrMarqueeItemHarnessFilters, WrMarqueeLink
+
 ## ngwr/media
 - import: `import { WrMedia } from 'ngwr/media'`
 - exports: WrMedia, provideWrMedia, WR_BREAKPOINTS, DEFAULT_WR_BREAKPOINTS, WrBreakpoint, WrBreakpointMap
@@ -532,9 +616,13 @@
 - exports: WrMeterGroup, WrMeterSegment
 - Stacked-segment progress bar. Each segment is sized proportionally to its `value` relative to the sum (or the explicit `max`); legend listed underneath.
 
+## ngwr/meter-group/testing
+- import: `import { WrMeterGroupHarness } from 'ngwr/meter-group/testing'`
+- exports: WrMeterGroupHarness, WrMeterGroupHarnessFilters, WrMeterGroupSlice
+
 ## ngwr/overlay
 - import: `import { WrOutsideClick } from 'ngwr/overlay'`
-- exports: wrAppendOverlayClose, wrMirrorOffsets, 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, WrResponsiveOverlaysConfig
 
 ## ngwr/page-header
 - import: `import { WrPageHeader } from 'ngwr/page-header'`
@@ -550,7 +638,6 @@
 
 ## 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
@@ -632,6 +719,10 @@
 - exports: WrRotatingText, WrRotatingTextSplit, WrRotatingTextStaggerFrom
 - Cycles through a list of strings, animating each transition character-by-character (or word/line). Auto-advances on a timer by default; also controllable imperatively via `next()` / `previous()` / `jumpTo()` / `reset()`.
 
+## ngwr/rotating-text/testing
+- import: `import { WrRotatingTextHarness } from 'ngwr/rotating-text/testing'`
+- exports: WrRotatingTextHarness, WrRotatingTextHarnessFilters
+
 ## ngwr/scroll
 - import: `import { WrScroll } from 'ngwr/scroll'`
 - exports: WrScroll, WrScrollTarget, WrScrollOptions
@@ -663,6 +754,10 @@
 - exports: WrShinyText, WrShimmer
 - Shimmer-over-text effect. A bright stripe sweeps across the text using `background-clip: text` + an animated `background-position`. Pure CSS port — no JS animation loop.
 
+## ngwr/shiny-text/testing
+- import: `import { WrShinyTextHarness } from 'ngwr/shiny-text/testing'`
+- exports: WrShinyTextHarness, WrShinyTextHarnessFilters, WrShinyTextSweepDirection
+
 ## ngwr/sidebar
 - import: `import { WrSidebar } from 'ngwr/sidebar'`
 - selector: `wr-sidebar`
@@ -691,12 +786,20 @@
 - exports: WrSparkline
 - Tiny inline trend line — no axes, no labels. Drop it next to a number to give context at a glance.
 
+## ngwr/sparkline/testing
+- import: `import { WrSparklineHarness } from 'ngwr/sparkline/testing'`
+- exports: WrSparklineHarness, WrSparklineHarnessFilters
+
 ## ngwr/speed-dial
 - import: `import { WrSpeedDial } from 'ngwr/speed-dial'`
 - selector: `wr-speed-dial`
 - exports: WrSpeedDial, WrSpeedDialAction, WrSpeedDialDirection
 - Floating action button that fans out a set of secondary actions on click.
 
+## ngwr/speed-dial/testing
+- import: `import { WrSpeedDialActionHarness } from 'ngwr/speed-dial/testing'`
+- exports: WrSpeedDialActionHarness, WrSpeedDialHarness, WrSpeedDialActionHarnessFilters, WrSpeedDialHarnessFilters
+
 ## ngwr/spinner
 - import: `import { WrSpinner } from 'ngwr/spinner'`
 - selector: `wr-spinner`
@@ -709,24 +812,40 @@
 - exports: WrSplashCursor, WrFluidConfig
 - WebGL fluid simulation that splashes colourful dye wherever the pointer moves or clicks. Fullscreen click-through overlay by default, or contained in any positioned box — where the dye collides with the walls. Renders nothing under prefers-reduced-motion or without WebGL.
 
+## ngwr/splash-cursor/testing
+- import: `import { WrSplashCursorHarness } from 'ngwr/splash-cursor/testing'`
+- exports: WrSplashCursorHarness, WrSplashCursorHarnessFilters
+
 ## ngwr/split-text
 - import: `import { WrSplitText } from 'ngwr/split-text'`
 - selector: `wr-split-text`
 - exports: WrSplitText, WrSplitTextMotion, WrSplitTextUnit
 - Reveals text by splitting it into chars or words and staggering each piece in from a `from` state to a `to` state when the element scrolls into view. GSAP-free port — uses `IntersectionObserver` + Web Animations API.
 
+## ngwr/split-text/testing
+- import: `import { WrSplitTextHarness } from 'ngwr/split-text/testing'`
+- exports: WrSplitTextHarness, WrSplitTextHarnessAlign, WrSplitTextHarnessFilters
+
 ## ngwr/splitter
 - import: `import { WrSplitter } from 'ngwr/splitter'`
 - selector: `wr-splitter`
 - exports: WrSplitter
 - Resizable two-pane split. Drag the divider or focus it and use arrows. Two-way `[(position)]` (0–100).
 
+## ngwr/splitter/testing
+- import: `import { WrSplitterHarness } from 'ngwr/splitter/testing'`
+- exports: WrSplitterHarness, WrSplitterHarnessFilters, WrSplitterPaneSizes
+
 ## ngwr/spotlight-card
 - import: `import { WrSpotlightCard } from 'ngwr/spotlight-card'`
 - selector: `wr-spotlight-card`, `[wrSpotlight]`
 - exports: WrSpotlightCard, WrSpotlight
 - Cursor-tracked spotlight card. A soft radial highlight follows the pointer, fading in on hover.
 
+## ngwr/spotlight-card/testing
+- import: `import { WrSpotlightCardHarness } from 'ngwr/spotlight-card/testing'`
+- exports: WrSpotlightCardHarness, WrSpotlightHarness, WrSpotlightCardHarnessFilters, WrSpotlightHarnessFilters
+
 ## ngwr/squircle
 - import: `import { WrSquircle } from 'ngwr/squircle'`
 - selector: `wr-squircle`, `[wrSquircle]`
@@ -739,6 +858,10 @@
 - exports: WrStarBorder, WrStarBorderMode, WrStarBorderRays
 - Radial comet rays sweeping along the edges of a rounded container. Run them forever or only on hover, mirrored on both edges or as a single ray.
 
+## ngwr/star-border/testing
+- import: `import { WrStarBorderHarness } from 'ngwr/star-border/testing'`
+- exports: WrStarBorderHarness, WrStarBorderHarnessFilters
+
 ## ngwr/statistic
 - import: `import { WrStatistic } from 'ngwr/statistic'`
 - selector: `wr-statistic-countdown`, `wr-statistic-group`, `wr-statistic`
@@ -773,7 +896,7 @@
 ## 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
+- exports: WrTable, WrTableCell, WrTableExpand, WrTableGroupHeader, WrTableSort, WrTableFilter, WrTableCellContext, WrTableColumn, WrTableColumns, WrTableCsvOptions, WrTableExpandContext, WrTableFilterChange, WrTableFilterItem, WrTableGroupContext, WrTableRow, WrTableSortState, WrTableSortDirection, WrTableSummary
 - Data table with sortable / filterable headers and custom cell templates.
 
 ## ngwr/table/testing
@@ -802,7 +925,7 @@
 
 ## ngwr/theme
 - import: `import { WrTheme } from 'ngwr/theme'`
-- exports: WR_COLORS, WrColor, WrTheme, provideWrTheme, WR_THEME_CONFIG, DEFAULT_WR_THEME_CONFIG, WrResolvedTheme, WrThemeMode, WrThemeConfig
+- exports: WR_COLORS, wrContrastFor, wrIntentTokens, wrThemeTokens, WrColor, WrTheme, provideWrTheme, WR_THEME_CONFIG, DEFAULT_WR_THEME_CONFIG, WrResolvedTheme, WrThemeMode, WrThemeConfig
 - Light / dark theme manager. Writes `[data-theme]` on `<html>`, persists the chosen mode to localStorage. `auto` mode follows `WrPlatform.prefersDark`.
 
 ## ngwr/tilt-card
@@ -811,6 +934,10 @@
 - exports: WrTiltCard, WrTilt
 - Cursor-tracked 3D tilt. Use `<wr-tilt-card>` for a ready-made card host, or `[wrTilt]` to add the tilt behaviour to any element.
 
+## ngwr/tilt-card/testing
+- import: `import { WrTiltHarness } from 'ngwr/tilt-card/testing'`
+- exports: WrTiltHarness, WrTiltHarnessFilters, WrTiltRotation
+
 ## ngwr/timeline
 - import: `import { WrTimeline } from 'ngwr/timeline'`
 - selector: `wr-timeline-item`, `wr-timeline`
@@ -819,7 +946,6 @@
 
 ## ngwr/toast
 - import: `import { WrToast } from 'ngwr/toast'`
-- selector: `wr-toast-host`, `wr-toast`
 - 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.
 
@@ -839,6 +965,10 @@
 - exports: WrTour, WrTourPopup, WrTourPlacement, WrTourStep
 - Guided product tour — a spotlight over one element at a time plus a popup explaining it.
 
+## ngwr/tour/testing
+- import: `import { WrTourHarness } from 'ngwr/tour/testing'`
+- exports: WrTourHarness, WrTourHarnessFilters, WrTourProgress
+
 ## ngwr/transfer
 - import: `import { WrTransfer } from 'ngwr/transfer'`
 - selector: `wr-transfer`
@@ -865,6 +995,10 @@
 - exports: WrTypewriter, WrTypewriterVariableSpeed
 - Classic typewriter — types out a string char-by-char, optionally deletes it, then types the next string. Cycles through `[texts]` (or a single string) with a blinking cursor. Pure JS (no GSAP), pure CSS cursor blink.
 
+## ngwr/typewriter/testing
+- import: `import { WrTypewriterHarness } from 'ngwr/typewriter/testing'`
+- exports: WrTypewriterHarness, WrTypewriterHarnessFilters
+
 ## ngwr/typography
 - import: `import { WrTypography } from 'ngwr/typography'`
 - selector: `[wrTypography]`
@@ -895,8 +1029,16 @@
 - exports: WrWaves
 - Wave-field background — a grid of lines drifting on perlin noise, nudged by the pointer. Line colour follows the theme out of the box. Use behind hero copy or section content.
 
+## ngwr/waves/testing
+- import: `import { WrWavesHarness } from 'ngwr/waves/testing'`
+- exports: WrWavesHarness, WrWavesHarnessFilters
+
 ## ngwr/window
 - import: `import { WrWindowManager } from 'ngwr/window'`
-- selector: `wr-window-container`, `wr-window-taskbar`, `wr-window`
-- exports: WR_WINDOW_DATA, WR_WINDOW_REF, WrWindowManager, WrWindowBeforeCloseHook, WrWindowRef, WrWindowTaskbar, WrWindowChromeSize, WrWindowConfig, WrWindowOs, WrWindowPersistMode, WrWindowSize, WrWindowSnap, WrWindowState, WrWindowStorageConfig
+- selector: `wr-window-taskbar`
+- exports: WR_WINDOW_DATA, WR_WINDOW_REF, WrWindowManager, WrWindowBeforeCloseHook, WrWindowRef, WrWindowTaskbar, WrWindowChromeSize, WrWindowConfig, WrWindowLayoutSnapshot, WrWindowOs, WrWindowPersistMode, WrWindowSize, WrWindowSnap, WrWindowState, WrWindowStorageConfig
 - Free-floating OS-style window opened programmatically via `WrWindowManager`. Drag the header to move, drag any edge or corner to resize, minimize to the taskbar. There is no declarative `<wr-window>` component — the manager is the only entry point so the API stays single-track. Need a backdrop + focus trap? That's `WrDialog`, not this.
+
+## ngwr/window/testing
+- import: `import { WrWindowHarness } from 'ngwr/window/testing'`
+- exports: WrWindowHarness, WrWindowTaskbarHarness, WrWindowBox, WrWindowHarnessFilters, WrWindowTaskbarHarnessFilters

package/llms.txt

@@ -1,7 +1,7 @@
 # ngwr
 
 > Angular UI library — standalone, signals-first, zoneless, fully tree-shakable.
-> 166 secondary entry points, 181 component and directive classes, built on
+> 202 secondary entry points, 187 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
 
@@ -56,8 +56,8 @@ Add from their entry points as needed:
   `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`).
+- `provideWrDateAdapter(...)` — calendar + date-picker (`ngwr/date/adapters/fns`
+  or `ngwr/date/adapters/luxon`).
 
 Injected rather than provided: `WrTour` (`ngwr/tour`) runs a guided onboarding
 tour — `tour.start([{ target: '[data-tour="save"]', content: '…' }])` spotlights
@@ -75,6 +75,21 @@ one element at a time; a step whose target is missing is skipped, not floated.
 - `ng g ngwr:page <form|table|dashboard>` — starter page wired with ngwr.
 - `ng update ngwr` — runs upgrade migrations.
 
+## Upgrading to v12
+
+Two breaking changes, and only one is codemoddable.
+
+- **Date entry points nest under `ngwr/date`.** `ngwr/date-adapter` →
+  `ngwr/date`, `ngwr/date-adapter-fns` → `ngwr/date/adapters/fns`,
+  `ngwr/date-adapter-luxon` → `ngwr/date/adapters/luxon`. Import paths only —
+  every symbol keeps its name. `ng update ngwr@12` rewrites them.
+- **`readI18nText()` returns `Signal<string>`.** Add `()` at every read. No
+  codemod: adding the call means knowing which identifiers hold the result, and
+  the type error already names every site. `useI18nText`, the `wrT` pipe and the
+  `[wrT]` directive are unchanged.
+
+Full guide, with diffs: https://ngwr.dev/start/migration
+
 ## Use ngwr — don't hand-roll
 
 The catalog is large: prefer an ngwr component, util, pipe, or validator over raw
@@ -140,16 +155,21 @@ before writing your own. Full catalog: https://ngwr.dev/reference/components.
   `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
+  `ngwr/<name>/testing`. 70 entry points so far, 104 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.
+  `input-number`, `input-otp`, `slider`, `rating`, `file-upload`, `color-picker`,
+  `knob`, `form` for `<wr-form-field>`), the overlays (`date-picker`, `dropdown`,
+  `popover`, `dialog`, `drawer`, `action-sheet`, `toast`, `context-menu`, `popconfirm`,
+  `command-palette`, `cascader`, `mention`), the data views (`table`, `tree`),
+  `splitter`, `speed-dial`, `lightbox`, `tour`, `calendar`, `event-calendar`,
+  `window`, `image-cropper`, every chart and eighteen of the twenty-one animations —
+  every control, every overlay and every chart has one. `aurora`, `click-spark`,
+  `confetti` and `virtual-scroll` deliberately have none: what they do is a canvas or
+  a measured viewport, so every honest method would read the same for a working
+  component and a broken one.
   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
@@ -192,7 +212,22 @@ before writing your own. Full catalog: https://ngwr.dev/reference/components.
   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
+- **Agent skill — the rules, not the catalog.** `skills/ngwr/SKILL.md` in the
+  installed package (also at https://ngwr.dev/skills/ngwr/SKILL.md) is about a
+  page of the things this library does that a reasonable guess gets wrong: the
+  button's selector is `wr-btn`, a checkbox's group identity is `checkboxValue`,
+  there is no `ControlValueAccessor`, imports come from the entry point rather
+  than a barrel. `references/catalog.md` and `references/setup.md` sit beside it
+  for the long tail. Generated from the same pass as `llms-full.txt`:
+  https://ngwr.dev/guides/agent-skill
+- **Registry — an open format for shareable theme presets and blocks.** One
+  installable unit per JSON file, hosted anywhere; the contract is
+  https://ngwr.dev/registry/schema.json and four worked examples sit beside it
+  at `/registry/items/` — three theme presets and one block. `cssVars` keys are
+  `--wr-*` tokens, `entryPoints` names `ngwr/*` subpaths, and a `files[].target`
+  is always relative:
+  https://ngwr.dev/guides/registry
 - 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
-  ships `README.md`, `llms.txt`, and `llms-full.txt`)
+  ships `README.md`, `llms.txt`, `llms-full.txt` and `skills/ngwr/`)

package/markdown/styles/_index.scss

@@ -77,7 +77,7 @@
   &__code-inline {
     padding: 0.15em 0.35em;
     border-radius: var(--wr-border-radius-sm);
-    background: rgb(var(--wr-color-light-rgb) / 25%);
+    background: var(--wr-color-fill);
     // `-ink`, not the bare intent: code on a tint is text, and the bare colour
     // fails AA there. The share in `$ink-mix` is calibrated against this tint.
     color: var(--wr-color-dark-ink);
@@ -95,7 +95,7 @@
     padding: 0.75rem;
     overflow-x: auto;
     border-radius: var(--wr-border-radius-base);
-    background: rgb(var(--wr-color-light-rgb) / 25%);
+    background: var(--wr-color-fill);
     tab-size: 2;
   }
 
@@ -257,7 +257,7 @@
   }
 
   &__th {
-    background: rgb(var(--wr-color-light-rgb) / 25%);
+    background: var(--wr-color-fill);
     font-weight: var(--wr-font-weight-semibold);
   }
 

package/mcp/api.js

@@ -7,10 +7,12 @@
 /**
  * Angular's signal wrappers, behind whichever namespace alias ng-packagr used.
  *
- * BOTH aliases, which is not decoration: of the 167 shipped declaration files, 99
- * import Angular as `_angular_core` and 25 as `i0`. Matching only the first hid
- * every binding in those 25 files — including `WrIcon`, whose single required
- * input is the entire component.
+ * BOTH aliases, which is not decoration: ng-packagr writes `_angular_core` for
+ * most of the shipped declarations and `i0` for a couple of dozen of them, and
+ * which file gets which moves with every entry point added — so the rule is here
+ * and the census deliberately is not. Matching the first alias alone hid every
+ * binding in the `i0` files, `WrIcon` among them, whose single required input is
+ * the entire component.
  */
 const SIGNAL_WRAPPER = /^(?:[A-Za-z_$][\w$]*\.)?(InputSignal|InputSignalWithTransform|ModelSignal|OutputEmitterRef)</;
 /** Modifiers that may precede a member name in a `.d.ts`. */

package/mcp/catalog.js

@@ -11,7 +11,7 @@ import { fileURLToPath } from 'node:url';
  * The catalog, read from the files the package already ships.
  *
  * **No second copy of anything, and that is the design constraint this whole
- * server was built under.** `llms-full.txt` (51 KB, 166 entry points) and
+ * server was built under.** `llms-full.txt` (~57 KB, 202 entry points) and
  * `schematics/use/symbol-map.json` (215 symbols) are already in the tarball for
  * other reasons, and the `.d.ts` bundle carries every signature. A server that
  * embedded its own index would be a fourth copy to keep in step with the library,
@@ -19,7 +19,7 @@ import { fileURLToPath } from 'node:url';
  *
  * What it adds on top is the part none of those files have: a way to ASK. An
  * agent that does not already know an entry point's name cannot use a `.d.ts`,
- * and reading 51 KB of catalog to answer "what renders markdown" is the cost this
+ * and reading ~57 KB of catalog to answer "what renders markdown" is the cost this
  * exists to remove.
  */
 class Catalog {
@@ -51,10 +51,15 @@ class Catalog {
     /**
      * Does this entry point ship a stylesheet?
      *
-     * Read from the package's own `exports` map rather than assumed: 58 of the 166
+     * Read from the package's own `exports` map rather than assumed: 94 of the 202
      * entry points ship no `styles/_index.scss` — the testing harnesses, the
      * services, the adapters — and telling a consumer to `@use` one of those breaks
      * their Sass build.
+     *
+     * Count them with `hasStyles()` rather than by tallying `sass` conditions in the
+     * `exports` map: six of those keys are not catalog entry points at all (the root
+     * plus `animations`, `breakpoints`, `grid`, `reset`, `typography-utilities`), so
+     * that arithmetic comes out six short.
      */
     hasStyles(path) {
         this.exports ??= (() => {
@@ -94,6 +99,38 @@ class Catalog {
         const file = join('types', `${path.replace(/\//g, '-')}.d.ts`);
         return this.read(file);
     }
+    /**
+     * Whether `symbol` is something Angular accepts in `imports: []`.
+     *
+     * Read from the SHIPPED declaration file rather than from a table, because the
+     * compiler already wrote the answer there: a component, directive or pipe gets
+     * a `static ɵcmp` / `ɵdir` / `ɵpipe` whose first type argument is the class. A
+     * service gets `ɵprov` instead. So this needs no second copy of anything, and
+     * cannot drift — which matters, because the alternative was a hand-kept list
+     * and `ng g ngwr:use` now REFUSES a non-declarable: recommending the command
+     * for `WrDialog` would hand an agent a line that errors.
+     *
+     * `null` when the types are not there to read, so a caller can tell "not
+     * declarable" from "cannot say".
+     */
+    declarable(symbol, path) {
+        const source = this.types(path);
+        if (!source)
+            return null;
+        // Ask for the declarable markers FIRST and separately. A single alternation
+        // over all five answers with whichever appears earliest in the file, and
+        // `ɵfac` is always emitted above `ɵcmp` — so the combined form calls every
+        // component a non-declarable, while a fixture with no markers at all hides
+        // it. Two passes, no ordering assumption.
+        const declarable = new RegExp(`static ɵ(?:cmp|dir|pipe): [^;]*<${symbol}[,>]`);
+        if (declarable.test(source))
+            return true;
+        // Only claim "no" for a symbol this file actually declares; a `.d.ts` that
+        // merely mentions the name is not evidence, which is the difference between
+        // "not declarable" and "cannot say".
+        const declared = new RegExp(`static ɵ(?:prov|fac): [^;]*<${symbol}[,>]`);
+        return declared.test(source) ? false : null;
+    }
     read(relative) {
         const file = join(this.root, relative);
         return existsSync(file) ? readFileSync(file, 'utf8') : null;