ngwr 11.1.0 → 11.2.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
 - 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`
@@ -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,11 @@
 - 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'`
+- selector: `.wr-color-picker__tabs`
+- exports: WrColorPickerHarness, WrColorPickerTriggerHarness, WrColorPickerHarnessFilters, WrColorPickerTab, WrColorPickerThumbs, WrColorPickerTriggerHarnessFilters
+
 ## ngwr/command-palette
 - import: `import { WrCommandPalette } from 'ngwr/command-palette'`
 - selector: `wr-command-palette`
@@ -250,6 +283,10 @@
 - 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 +326,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 +368,21 @@
 - 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'`
+- selector: `.wr-event-calendar__view`
+- 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 +409,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 +483,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, WrImageCropperHarnessFilters
+
 ## ngwr/input
 - import: `import { WrInput } from 'ngwr/input'`
 - selector: `[wrInputPrefix]`, `[wrInputSuffix]`, `input[wrInput]`, `textarea[wrInput]`, `wr-input-group`, `wr-password-toggle`
@@ -459,6 +529,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 +545,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 +587,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,6 +618,10 @@
 - 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
@@ -632,6 +722,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 +757,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 +789,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 +815,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 +861,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`
@@ -811,6 +937,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`
@@ -839,6 +969,11 @@
 - 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'`
+- selector: `.wr-tour-popup__action--next`, `.wr-tour-popup__action--skip`, `.wr-tour-popup__action--back`
+- exports: WrTourHarness, WrTourHarnessFilters, WrTourProgress
+
 ## ngwr/transfer
 - import: `import { WrTransfer } from 'ngwr/transfer'`
 - selector: `wr-transfer`
@@ -865,6 +1000,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 +1034,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
 - 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, 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
 
@@ -140,16 +140,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 +197,21 @@ 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 two worked examples sit beside it at
+  `/registry/items/`. `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/mcp/providers.js

@@ -0,0 +1,29 @@
+/**
+ * @license
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://github.com/thekhegay/ngwr/blob/main/LICENSE
+ */
+const REQUIRED_PROVIDERS = [
+    {
+        test: /^Wr(Dialog|Drawer|Toast|Popover|Popconfirm|ContextMenu|Select|Dropdown|CommandPalette|Cascader|Mention|DatePicker|Tour|Lightbox)/,
+        provider: "provideWrOverlay() // from 'ngwr/overlay'",
+        why: 'overlays render into an ngwr-owned container; without it they never appear',
+    },
+    {
+        test: /^WrIcon/,
+        provider: "provideWrIcons(lucideIcons({ … })) // from 'ngwr/icon' + 'ngwr/icon/adapters/lucide'",
+        why: 'icons resolve by name from a registry you populate',
+    },
+    {
+        test: /^WrDatePicker|^WrCalendar|^WrEventCalendar/,
+        provider: "provideWrDateAdapter(wrDateFnsAdapter) // from 'ngwr/date-adapter-fns'",
+        why: 'every date mode goes through an adapter; there is no built-in default',
+    },
+    {
+        test: /^WrT$|^WrI18n/,
+        provider: "provideWrI18n() + provideWrI18nStaticLoader({ en: wrEn }) // from 'ngwr/i18n'",
+        why: 'the pipe and directive read from a catalog you provide',
+    },
+];
+export { REQUIRED_PROVIDERS };

package/mcp/tools.js

@@ -5,6 +5,7 @@
  * found in the LICENSE file at https://github.com/thekhegay/ngwr/blob/main/LICENSE
  */
 import { declaredClasses, extractClass } from './api.js';
+import { REQUIRED_PROVIDERS } from './providers.js';
 const DOCS = 'https://ngwr.dev';
 /**
  * The four tools, and why there are only four.
@@ -77,35 +78,6 @@ const TOOLS = [
         },
     },
 ];
-/**
- * Providers a symbol cannot work without.
- *
- * Hard-coded, and the list is short on purpose: these are the four cases where
- * the component compiles, renders nothing useful, and gives no error that names
- * the cause. Everything else is discoverable from the docs page.
- */
-const REQUIRED_PROVIDERS = [
-    {
-        test: /^Wr(Dialog|Drawer|Toast|Popover|Popconfirm|ContextMenu|Select|Dropdown|CommandPalette|Cascader|Mention|DatePicker|Tour|Lightbox)/,
-        provider: "provideWrOverlay() // from 'ngwr/overlay'",
-        why: 'overlays render into an ngwr-owned container; without it they never appear',
-    },
-    {
-        test: /^WrIcon/,
-        provider: "provideWrIcons(lucideIcons({ … })) // from 'ngwr/icon' + 'ngwr/icon/adapters/lucide'",
-        why: 'icons resolve by name from a registry you populate',
-    },
-    {
-        test: /^WrDatePicker|^WrCalendar|^WrEventCalendar/,
-        provider: "provideWrDateAdapter(wrDateFnsAdapter) // from 'ngwr/date-adapter-fns'",
-        why: 'every date mode goes through an adapter; there is no built-in default',
-    },
-    {
-        test: /^WrT$|^WrI18n/,
-        provider: "provideWrI18n() + provideWrI18nStaticLoader({ en: wrEn }) // from 'ngwr/i18n'",
-        why: 'the pipe and directive read from a catalog you provide',
-    },
-];
 /**
  * The published schema, actually enforced.
  *