ngwr 10.0.0 → 10.1.0

package/llms-full.txt

@@ -3,6 +3,9 @@
 > Generated from the library source: every entry point with its import path,
 > selector(s), public exports, and description. For exact input / output
 > signatures read the bundled `.d.ts` types. Concise quick-ref: /llms.txt
+>
+> One component at a time: every docs page also ships as markdown at the same
+> URL plus `.md` — e.g. https://ngwr.dev/reference/components/select.md
 
 ## ngwr/action-sheet
 - import: `import { WrActionSheet } from 'ngwr/action-sheet'`
@@ -25,18 +28,19 @@
 ## ngwr/anchor
 - import: `import { WrAnchor } from 'ngwr/anchor'`
 - selector: `wr-anchor`
-- exports: WrAnchor, type WrAnchorLink
+- exports: WrAnchor, WrAnchorLink
 - Scroll-spy in-page navigation. Click a link to smooth-scroll; the closest visible heading auto-highlights.
 
 ## ngwr/aurora
 - import: `import { WrAurora } from 'ngwr/aurora'`
 - selector: `wr-aurora`
 - exports: WrAurora
+- Flowing northern-lights ribbons rendered with a WebGL2 simplex-noise shader, ramped across three colour stops. Use as a hero / section background.
 
 ## ngwr/avatar
 - import: `import { WrAvatar } from 'ngwr/avatar'`
 - selector: `wr-avatar`
-- exports: WrAvatar, WrAvatarSize
+- exports: WrAvatar, WrAvatarSize, WrAvatarShape
 - Image avatar with a fixed square or rounded shape. Shows a spinner while the image loads.
 
 ## ngwr/back-top
@@ -48,24 +52,26 @@
 ## ngwr/badge
 - import: `import { WrBadge } from 'ngwr/badge'`
 - selector: `wr-badge`, `wr-tag`
-- exports: WrBadge, WrTag, WrBadgeSize, WrTagIconPosition
+- exports: WrBadge, WrTag, WrBadgeSize, WrBadgeShape, WrTagIconPosition
 - Small status indicator with color variants and optional pill shape. Reach for `<wr-tag>` (in the same entry) when you need a richer label — icons, loading state, outlined / transparent styles.
 
 ## ngwr/bar-chart
 - import: `import { WrBarChart } from 'ngwr/bar-chart'`
 - selector: `wr-bar-chart`
-- exports: WrBarChart, type WrBarChartDatum
+- exports: WrBarChart, WrBarChartDatum
 - Vertical bars, one series. Per-bar color overrides via the `color` field.
 
 ## 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/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/breadcrumbs
 - import: `import { WrBreadcrumbs } from 'ngwr/breadcrumbs'`
@@ -81,7 +87,7 @@
 
 ## ngwr/button
 - import: `import { WrButton } from 'ngwr/button'`
-- selector: `wr-btn-group`, `wr-btn, button[wr-btn], a[wr-btn]`
+- selector: `wr-btn-group`, `wr-btn`, `button[wr-btn]`, `a[wr-btn]`
 - exports: WrButton, WrButtonGroup, WrButtonSize, WrButtonShape, WrButtonIconPosition
 - Trigger an action. Renders as <wr-btn>, button[wr-btn], or a[wr-btn].
 
@@ -94,7 +100,7 @@
 ## ngwr/calendar-heatmap
 - import: `import { WrCalendarHeatmap } from 'ngwr/calendar-heatmap'`
 - selector: `wr-calendar-heatmap`
-- exports: WrCalendarHeatmap, type WrHeatmapDatum
+- exports: WrCalendarHeatmap, WrHeatmapDatum
 - Year-grid heatmap — the classic GitHub contributions layout.
 
 ## ngwr/card
@@ -112,40 +118,42 @@
 ## ngwr/cascader
 - import: `import { WrCascader } from 'ngwr/cascader'`
 - selector: `wr-cascader`
-- exports: WrCascader, type WrCascaderOption, type WrCascaderSize
+- 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/checkbox
 - import: `import { WrCheckbox } from 'ngwr/checkbox'`
 - selector: `wr-checkbox-group`, `wr-checkbox`
-- exports: WrCheckbox, WrCheckboxSize, WrCheckboxGroup, WR_CHECKBOX_GROUP, type WrCheckboxGroupContext
+- exports: WrCheckbox, WrCheckboxSize, WrCheckboxGroup, WR_CHECKBOX_GROUP, WrCheckboxGroupContext
 - Two-state checkbox. Standalone (boolean) or inside <wr-checkbox-group> (array of values).
 
 ## ngwr/circular-text
 - import: `import { WrCircularText } from 'ngwr/circular-text'`
 - selector: `wr-circular-text`
-- exports: WrCircularText, type WrCircularTextHover
+- 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/click-spark
 - import: `import { WrClickSpark } from 'ngwr/click-spark'`
 - selector: `wr-click-spark`
-- exports: WrClickSpark, type WrClickSparkEasing
+- exports: WrClickSpark, WrClickSparkEasing
+- Click ripple. Bursts a ring of short line sparks from the click point across any projected content. The canvas overlay has `pointer-events: none`, so projected DOM stays fully interactive.
 
 ## ngwr/clipboard
 - import: `import { WrClipboard } from 'ngwr/clipboard'`
-- exports: WrClipboard, type WrClipboardPermission
+- exports: WrClipboard, WrClipboardPermission
 - Programmatic clipboard read and write. Uses `navigator.clipboard.writeText` when available, with a hidden-textarea + `execCommand` fallback for non-secure contexts.
 
 ## ngwr/collapse
 - import: `import { WrCollapse } from 'ngwr/collapse'`
 - selector: `wr-accordion`, `wr-collapse-group`, `wr-collapse`
-- exports: WrCollapse, WrCollapseGroup, WrAccordion, WR_COLLAPSE_GROUP, type WrCollapseGroupContext
+- 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/color-picker
 - import: `import { WrColorPicker } from 'ngwr/color-picker'`
 - selector: `[wrColorPickerTrigger]`, `wr-color-picker`
-- exports: WrColorPicker, WrColorPickerTrigger, hslToRgb, hsvToRgb, parseHex, rgbToHsl, rgbToHsv, toHex, type WrHsl, type WrHsv, type WrRgb, WrColorFormat
+- 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/command-palette
@@ -163,6 +171,7 @@
 ## ngwr/confetti
 - import: `import { WrConfetti } from 'ngwr/confetti'`
 - exports: WrConfetti, WrConfettiOptions
+- Imperative confetti service. Inject `WrConfetti` and call `.fire()` on a celebration event.
 
 ## ngwr/context-menu
 - import: `import { WrContextMenu } from 'ngwr/context-menu'`
@@ -172,18 +181,18 @@
 
 ## ngwr/cookie
 - import: `import { WrCookie } from 'ngwr/cookie'`
-- exports: WrCookie, type WrCookieOptions
+- exports: WrCookie, WrCookieOptions
 - Thin, SSR-safe `document.cookie` wrapper modelled after `WrStorage`. Read, write, delete, and list cookies — with typed options for expiry, path, domain, secure, and SameSite.
 
 ## ngwr/counter
 - import: `import { WrCounter } from 'ngwr/counter'`
 - selector: `wr-count-up`, `wr-counter`
-- exports: WrCounter, WrCounterMode, WrCountUp, type WrCountUpDirection, type WrCountUpEasing, type WrCountUpTrigger
+- 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'`
-- exports: WrDateAdapter, WrNativeDateAdapter, provideWrDateAdapter, type WrDateAdapterOptions, WR_DATE_LOCALE, WrDateFormat, isNamedFormat
+- exports: WrDateAdapter, WrNativeDateAdapter, provideWrDateAdapter, WrDateAdapterOptions, WR_DATE_LOCALE, WrDateFormat, isNamedFormat
 
 ## ngwr/date-adapter-fns
 - import: `import { WrDateFnsAdapter } from 'ngwr/date-adapter-fns'`
@@ -202,12 +211,13 @@
 ## ngwr/decrypt-text
 - import: `import { WrDecryptText } from 'ngwr/decrypt-text'`
 - selector: `wr-decrypt-text`
-- exports: WrDecryptText, type WrDecryptTextAnimateOn, type WrDecryptTextClickMode, type WrDecryptTextRevealDirection
+- 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/density
 - import: `import { WrDensity } from 'ngwr/density'`
 - selector: `[wrDensity]`
-- exports: WrDensity, WrDensityDirective, provideWrDensity, WR_DENSITY_CONFIG, DEFAULT_WR_DENSITY_CONFIG, type WrDensityValue, type WrDensityConfig
+- 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.
 
 ## ngwr/descriptions
@@ -218,6 +228,7 @@
 
 ## ngwr/dialog
 - import: `import { WrDialog } from 'ngwr/dialog'`
+- selector: `[wrDialogClose]`, `[wrDialogContent]`, `[wrDialogFooter]`, `[wrDialogTitle]`
 - 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.
 
@@ -229,24 +240,24 @@
 ## ngwr/divider
 - import: `import { WrDivider } from 'ngwr/divider'`
 - selector: `wr-divider`
-- exports: WrDivider, WrDividerType
+- exports: WrDivider, WrDividerType, WrDividerAlign
 - Horizontal separator. Solid, dashed, or dotted; tinted with any theme color.
 
 ## ngwr/donut-chart
 - import: `import { WrDonutChart } from 'ngwr/donut-chart'`
 - selector: `wr-donut-chart`
-- exports: WrDonutChart, type WrDonutSegment
-- Data shapes used by the inputs and outputs above.
+- exports: WrDonutChart, WrDonutSegment
+- Ring chart with optional center label / value. Set `thickness="0"` for a solid pie.
 
 ## ngwr/drag-drop
 - import: `import { WrSortableList } from 'ngwr/drag-drop'`
 - selector: `[wrDragHandle]`, `wr-sortable-list`
-- exports: WrSortableList, type WrSortableReorderEvent, WrDragHandle
+- exports: WrSortableList, WrSortableReorderEvent, WrDragHandle
 - `<wr-sortable-list>` wraps CDK's `cdkDropList` + `cdkDrag` with a signal-based two-way `[(items)]` binding. Includes the `[wrDragHandle]` helper and themed `.cdk-drag-preview` / `.cdk-drag-placeholder` defaults. Touch-ready: a default touch start-delay lets a quick swipe scroll the list while a hold begins a drag.
 
 ## ngwr/drawer
 - import: `import { WrDrawer } from 'ngwr/drawer'`
-- selector: `wr-drawer`
+- selector: `[wrDrawerClose]`, `[wrDrawerContent]`, `[wrDrawerFooter]`, `[wrDrawerTitle]`, `wr-drawer`
 - 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.
 
@@ -262,10 +273,17 @@
 - exports: WrEmpty
 - Empty-state placeholder for when the underlying data is missing. Project a description and an optional `[wrEmptyActions]` row.
 
+## ngwr/event-calendar
+- import: `import { WrEventCalendar } from 'ngwr/event-calendar'`
+- selector: `ng-template[wrCalendarEvent]`, `wr-event-calendar`
+- exports: WrEventCalendar, WrCalendarEventTemplate, WrCalendarEvent, WrCalendarEventChange, WrCalendarEventContext, WrCalendarSlot, WrCalendarView
+- Month, week and day views of a set of events — draggable, resizable, keyboard-operable.
+
 ## ngwr/falling-text
 - import: `import { WrFallingText } from 'ngwr/falling-text'`
 - selector: `wr-falling-text`
-- exports: WrFallingText, type WrFallingTextTrigger
+- 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/file-upload
 - import: `import { WrFileUpload } from 'ngwr/file-upload'`
@@ -275,14 +293,15 @@
 
 ## ngwr/form
 - import: `import { WrFormItem } from 'ngwr/form'`
-- selector: `wr-form-field`, `wr-form-error`, `wr-form-item`
-- exports: WrFormItem, WrFormField, WrFormError
+- 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/fuzzy-text
 - import: `import { WrFuzzyText } from 'ngwr/fuzzy-text'`
 - selector: `wr-fuzzy-text`
-- exports: WrFuzzyText, type WrFuzzyTextDirection
+- 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/gauge
 - import: `import { WrGauge } from 'ngwr/gauge'`
@@ -294,30 +313,48 @@
 - 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/gradient-text
 - import: `import { WrGradientText } from 'ngwr/gradient-text'`
 - selector: `wr-gradient-text`
-- exports: WrGradientText, type WrGradientTextDirection
+- 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/hotkey
 - import: `import { WrHotkey } from 'ngwr/hotkey'`
 - selector: `[wrHotkey]`
-- exports: WrHotkey, WrHotkeyBinding, parseHotkeySpec, matchesHotkey, type WrParsedHotkey, WrHotkeyHandle, WrHotkeyOptions, WrHotkeySpec
-- Raw `keydown` listeners need platform-aware modifier mapping (⌘ vs Ctrl), input-field exclusion, and teardown. `WrHotkey` registers a declarative combo and cleans up with the host's `DestroyRef`.
+- exports: WrHotkey, WrHotkeyBinding, parseHotkeySpec, matchesHotkey, WrParsedHotkey, WrHotkeyHandle, WrHotkeyOptions, WrHotkeySpec
+- Global keybinding registry. Specs like `mod+k` — `mod` auto-resolves to Cmd on macOS / Ctrl elsewhere. Skips bindings while an input / textarea has focus by default. `[wrHotkey]` is the declarative form of the same registry — also global unless you pass `[scoped]="true"` to limit it to the host element.
 
 ## ngwr/i18n
 - import: `import { WrI18n } from 'ngwr/i18n'`
 - selector: `[wrT]`
-- exports: WrI18n, WrTPipe, WrTDirective, WR_I18N_CONFIG, DEFAULT_WR_I18N_CONFIG, type WrI18nCatalog, type WrI18nConfig, type WrI18nConfigResolved, type WrI18nParams, type WrI18nMissingHandler, WR_I18N_LOADER, type WrI18nLoader, WR_I18N_BASE_CATALOGS, type WrI18nBaseCatalogs, WrI18nStaticLoader, type WrI18nStaticCatalogs, type WrI18nStaticScopedCatalogs, WrI18nHttpLoader, type WrI18nHttpLoaderConfig, provideWrI18n, provideWrI18nBaseCatalogs, provideWrI18nStaticLoader, provideWrI18nHttpLoader, type ProvideWrI18nOptions, useI18nText, readI18nText, useI18nFormatter
+- exports: WrI18n, WrTPipe, WrTDirective, WR_I18N_CONFIG, DEFAULT_WR_I18N_CONFIG, WrI18nCatalog, WrI18nConfig, WrI18nConfigResolved, WrI18nParams, WrI18nMissingHandler, WR_I18N_LOADER, WrI18nLoader, WR_I18N_BASE_CATALOGS, WrI18nBaseCatalogs, WrI18nStaticLoader, WrI18nStaticCatalogs, WrI18nStaticScopedCatalogs, WrI18nHttpLoader, WrI18nHttpLoaderConfig, provideWrI18n, provideWrI18nBaseCatalogs, provideWrI18nStaticLoader, provideWrI18nHttpLoader, ProvideWrI18nOptions, useI18nText, readI18nText, useI18nFormatter
 - Reactive i18n service. Active locale lives on a signal, catalogs load lazily through a swappable loader (HTTP or static), and double-brace placeholders interpolate at render time. Scopes let feature modules ship and load their own catalogs.
 
+## ngwr/i18n/en
+- import: `import { wrEn } from 'ngwr/i18n/en'`
+- exports: wrEn
+
+## ngwr/i18n/ru
+- import: `import { wrRu } from 'ngwr/i18n/ru'`
+- exports: wrRu
+
 ## ngwr/icon
 - import: `import { WrIcon } from 'ngwr/icon'`
 - selector: `wr-icon`
 - exports: WrIcon, provideWrIcons, svgIcon, WrIconDef, WrIconName
 - The icon renderer. Resolves a registered name from the `provideWrIcons` registry and inlines its SVG. ngwr ships no built-in icons — bring your own via an adapter or `svgIcon()`.
 
+## ngwr/icon/adapters/feather
+- import: `import { feather } from 'ngwr/icon/adapters/feather'`
+- exports: feather, featherIcons
+
+## ngwr/icon/adapters/lucide
+- import: `import { lucide } from 'ngwr/icon/adapters/lucide'`
+- exports: lucide, lucideIcons, LucideIconNode
+
 ## ngwr/image-cropper
 - import: `import { WrImageCropper } from 'ngwr/image-cropper'`
 - selector: `wr-image-cropper`
@@ -326,7 +363,7 @@
 
 ## ngwr/input
 - import: `import { WrInput } from 'ngwr/input'`
-- selector: `wr-input-group`, `wr-password-toggle`
+- selector: `[wrInputPrefix]`, `[wrInputSuffix]`, `input[wrInput]`, `textarea[wrInput]`, `wr-input-group`, `wr-password-toggle`
 - exports: WrInput, WrInputPrefix, WrInputSuffix, WrInputGroup, WrPasswordToggle, WrInputType, WrInputSize
 - Attribute directive applied to a native `<input>` (or `<textarea>`). Because the styling lives on the real input, third-party directives like `ngx-mask`, custom validators, and `[(ngModel)]` compose naturally on the same element.
 
@@ -369,7 +406,7 @@
 ## ngwr/line-chart
 - import: `import { WrLineChart } from 'ngwr/line-chart'`
 - selector: `wr-line-chart`
-- exports: WrLineChart, type WrLineSeries
+- exports: WrLineChart, WrLineSeries
 - Multi-series line chart with a hover tooltip that snaps to the nearest x-axis tick.
 
 ## ngwr/list
@@ -381,13 +418,14 @@
 ## ngwr/loading-bar
 - import: `import { WrLoadingBar } from 'ngwr/loading-bar'`
 - selector: `wr-loading-bar`
-- exports: WrLoadingBar, type WrLoadingState, WrLoadingBarComponent
+- 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/marquee
 - import: `import { WrMarquee } from 'ngwr/marquee'`
 - selector: `wr-marquee`
-- exports: WrMarquee, type WrMarqueeItem, type WrMarqueeImage, type WrMarqueeNode
+- 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/media
 - import: `import { WrMedia } from 'ngwr/media'`
@@ -413,7 +451,7 @@
 - Stacked-segment progress bar. Each segment is sized proportionally to its `value` relative to the sum (or the explicit `max`); legend listed underneath.
 
 ## ngwr/overlay
-- import: `import { wrAppendOverlayClose } from 'ngwr/overlay'`
+- import: `import { WrOutsideClick } from 'ngwr/overlay'`
 - exports: wrAppendOverlayClose, WrOutsideClick, WrOverlayContainer, provideWrOverlay, provideWrResponsiveOverlays, WR_OVERLAY, WR_OVERLAY_CONTAINER, WR_RESPONSIVE_OVERLAYS, wrPresentAsSheet
 
 ## ngwr/page-header
@@ -425,28 +463,29 @@
 ## ngwr/pagination
 - import: `import { WrPagination } from 'ngwr/pagination'`
 - selector: `wr-pagination`
-- exports: WrPagination, WrPaginationAlign
+- exports: WrPagination, WrPaginationAlign, WrPaginationSize, WrPaginationShape
 - Numbered page navigator. Two-way binds currentPage and pageSize via signal models.
 
 ## ngwr/pipes
 - import: `import { WrBytes } from 'ngwr/pipes'`
-- exports: WrBytes, WrDate, WrMark, WrNumber, type WrNumberStyle, WrPlural, type WrPluralForms, type WrPluralOptions, WrRange, WrTruncate
+- exports: WrBytes, WrDate, WrMark, WrNumber, WrNumberStyle, WrPlural, WrPluralForms, WrPluralOptions, WrRange, WrTruncate
 
 ## ngwr/platform
 - import: `import { WrPlatform } from 'ngwr/platform'`
-- exports: WrPlatform, WrVisualViewport, WrHaptics, type WrHapticImpact
+- exports: WrPlatform, WrVisualViewport, WrHaptics, WrHapticImpact
 - SSR-safe environment probes. Use to gate browser-only code paths and react to user preferences.
 
 ## ngwr/popconfirm
 - import: `import { WrPopconfirm } from 'ngwr/popconfirm'`
 - selector: `wr-popconfirm`, `[wrPopconfirm]`
 - exports: WrPopconfirm, WrPopconfirmPanel, WrPopconfirmPosition
+- Small "Are you sure?" panel anchored to its trigger. Emits confirmed or cancelled.
 
 ## ngwr/popover
 - import: `import { WrPopover } from 'ngwr/popover'`
 - selector: `[wrPopover]`
 - exports: WrPopover, WrPopoverPosition
-- Popover mode only — with `responsive` (or app-wide via `provideWrResponsiveOverlays()`) the panel slides up as a full-width bottom-sheet with a backdrop on small viewports. Tooltips never become sheets. Open this on a phone (or narrow the window below 640px).
+- 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/progress
 - import: `import { WrProgress } from 'ngwr/progress'`
@@ -469,7 +508,7 @@
 ## ngwr/radio
 - import: `import { WrRadio } from 'ngwr/radio'`
 - selector: `wr-radio-group`, `wr-radio`
-- exports: WrRadio, WrRadioSize, WrRadioGroup, WR_RADIO_GROUP, type WrRadioGroupContext
+- 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/rating
@@ -481,13 +520,14 @@
 ## ngwr/result
 - import: `import { WrResult } from 'ngwr/result'`
 - selector: `wr-result-404`, `wr-result-403`, `wr-result-500`, `wr-result`
-- exports: WrResult, type WrResultStatus, WrResult404, WrResult403, WrResult500
+- exports: WrResult, WrResultStatus, WrResult404, WrResult403, WrResult500
 - Large-illustration result / empty-state. Built-in statuses: success / warning / error / info / empty. Plus ready-made `<wr-result-404>`, `<wr-result-403>`, `<wr-result-500>` presets.
 
 ## ngwr/rotating-text
 - import: `import { WrRotatingText } from 'ngwr/rotating-text'`
 - selector: `wr-rotating-text`
-- exports: WrRotatingText, type WrRotatingTextSplit, type WrRotatingTextStaggerFrom
+- 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/scroll
 - import: `import { WrScroll } from 'ngwr/scroll'`
@@ -503,13 +543,14 @@
 ## ngwr/select
 - import: `import { WrSelect } from 'ngwr/select'`
 - selector: `wr-option-group`, `wr-option`, `wr-select`
-- exports: WrSelect, WrOption, WrOptionGroup, WR_SELECT, type WrSelectContext, WrSelectMode, WrSelectSearchLoader, WrSelectTagValidator, WrSelectSize
+- 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/shiny-text
 - import: `import { WrShinyText } from 'ngwr/shiny-text'`
 - selector: `[wrShimmer]`, `wr-shiny-text`
 - 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/sidebar
 - import: `import { WrSidebar } from 'ngwr/sidebar'`
@@ -538,7 +579,7 @@
 ## ngwr/speed-dial
 - import: `import { WrSpeedDial } from 'ngwr/speed-dial'`
 - selector: `wr-speed-dial`
-- exports: WrSpeedDial, type WrSpeedDialAction, type WrSpeedDialDirection
+- exports: WrSpeedDial, WrSpeedDialAction, WrSpeedDialDirection
 - Floating action button that fans out a set of secondary actions on click.
 
 ## ngwr/spinner
@@ -551,11 +592,13 @@
 - import: `import { WrSplashCursor } from 'ngwr/splash-cursor'`
 - selector: `wr-splash-cursor`
 - 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/split-text
 - import: `import { WrSplitText } from 'ngwr/split-text'`
 - selector: `wr-split-text`
-- exports: WrSplitText, type WrSplitTextMotion, type WrSplitTextUnit
+- 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/splitter
 - import: `import { WrSplitter } from 'ngwr/splitter'`
@@ -567,17 +610,19 @@
 - 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/squircle
-- import: `import { squirclePath } from 'ngwr/squircle'`
+- import: `import { WrSquircle } from 'ngwr/squircle'`
 - selector: `wr-squircle`, `[wrSquircle]`
-- exports: squirclePath, type WrSquircleCorners, WrSquircle, type WrSquircleCornerMask, WrSquircleHost
+- exports: squirclePath, WrSquircleCorners, WrSquircle, WrSquircleCornerMask, WrSquircleHost
 - Figma-style smooth-corner rectangle. Standalone `<wr-squircle>` or `[wrSquircle]` directive that clips any element with a superellipse path. Re-computes on resize. The CSS-`corner-shape` route (via the `smooth-br` SCSS mixin) is also wired into most ngwr components — both paths are considered **experimental** while the underlying CSS spec stabilises.
 
 ## ngwr/star-border
 - import: `import { WrStarBorder } from 'ngwr/star-border'`
-- selector: `wr-star-border, [wr-star-border]`
-- exports: WrStarBorder, type WrStarBorderMode, type WrStarBorderRays
+- selector: `wr-star-border`, `[wr-star-border]`
+- 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/statistic
 - import: `import { WrStatistic } from 'ngwr/statistic'`
@@ -588,12 +633,12 @@
 ## ngwr/stepper
 - import: `import { WrStepper } from 'ngwr/stepper'`
 - selector: `wr-step`, `wr-stepper`
-- exports: WrStepper, WrStep, WR_STEPPER, type WrStepperContext
+- 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/storage
 - import: `import { WrStorage } from 'ngwr/storage'`
-- exports: WrStorage, provideWrStorage, type ProvideWrStorageOptions, WR_STORAGE_CONFIG, DEFAULT_WR_STORAGE_CONFIG, type WrStorageConfig, type WrStorageConfigResolved, WR_STORAGE_ENGINE, createMemoryStorage, type WrStorageEngine
+- exports: WrStorage, provideWrStorage, ProvideWrStorageOptions, WR_STORAGE_CONFIG, DEFAULT_WR_STORAGE_CONFIG, WrStorageConfig, WrStorageConfigResolved, WR_STORAGE_ENGINE, createMemoryStorage, WrStorageEngine
 - Reactive key/value storage on top of any `Storage`-compatible engine. Swap the engine through DI (defaults to `localStorage` with an in-memory SSR / private-mode fallback). Built-in prefixing, TTL, and signal-based `watch()` for local + cross-tab updates.
 
 ## ngwr/switch
@@ -611,7 +656,7 @@
 ## ngwr/tabs
 - import: `import { WrTabs } from 'ngwr/tabs'`
 - selector: `wr-tab`, `wr-tabs`
-- exports: WrTabs, WrTab, WR_TABS, type WrTabsContext
+- 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/textarea
@@ -621,19 +666,20 @@
 - 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/theme
-- import: `import { WR_COLORS } from 'ngwr/theme'`
-- exports: WR_COLORS, WrColor, WrTheme, provideWrTheme, WR_THEME_CONFIG, DEFAULT_WR_THEME_CONFIG, type WrResolvedTheme, type WrThemeMode, type WrThemeConfig
+- import: `import { WrTheme } from 'ngwr/theme'`
+- exports: WR_COLORS, 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
 - import: `import { WrTiltCard } from 'ngwr/tilt-card'`
 - selector: `wr-tilt-card`, `[wrTilt]`
 - 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/timeline
 - import: `import { WrTimeline } from 'ngwr/timeline'`
 - selector: `wr-timeline-item`, `wr-timeline`
-- exports: WrTimeline, WrTimelineItem, type WrTimelineColor
+- exports: WrTimeline, WrTimelineItem, WrTimelineColor
 - Event ladder with markers. Vertical (default) or horizontal. Dot colors: primary / success / warning / danger / medium.
 
 ## ngwr/toast
@@ -648,16 +694,29 @@
 - exports: WrToolbar
 - Three-zone action bar — start / center / end. Each zone collapses when empty.
 
+## ngwr/tour
+- import: `import { WrTour } from 'ngwr/tour'`
+- selector: `wr-tour-popup`
+- exports: WrTour, WrTourPopup, WrTourPlacement, WrTourStep
+- Guided product tour — a spotlight over one element at a time plus a popup explaining it.
+
+## ngwr/transfer
+- import: `import { WrTransfer } from 'ngwr/transfer'`
+- selector: `wr-transfer`
+- exports: WrTransfer, WrTransferItem
+- Dual listbox — two panes and the buttons that move rows between them. The RIGHT pane is the value.
+
 ## ngwr/tree
 - import: `import { WrTree } from 'ngwr/tree'`
 - selector: `wr-tree`
 - exports: WrTree, WrTreeNode, WrTreeSelectionMode
-- Click a row to select. Arrow keys navigate, ←/→ collapse/expand, Enter or Space selects, Home/End jump to ends.
+- 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/typewriter
 - import: `import { WrTypewriter } from 'ngwr/typewriter'`
 - selector: `wr-typewriter`
-- exports: WrTypewriter, type WrTypewriterVariableSpeed
+- 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/typography
 - import: `import { WrTypography } from 'ngwr/typography'`
@@ -666,7 +725,7 @@
 - One directive covering every text role. It sets no element of its own — put it on the `<p>`, `<h1>`, `<code>` or `<ul>` you already have, pick a variant, and it applies the shared `--wr-text-*` / `--wr-font-weight-*` / `--wr-leading-*` tokens by binding a class.
 
 ## ngwr/utils
-- import: `import { Maybe } from 'ngwr/utils'`
+- import: `import { isDefined } from 'ngwr/utils'`
 - exports: Maybe, SafeAny, isDefined, isNonEmptyArray, isObservable, clamp, round, numAttr, resolveCssSize, ResolveCssSizeOptions, ResolvedCssSize, getRootFontSize, getFocusableElements, trapFocus, randomId, noop, debounce, throttle, WrDebouncedFn, WrThrottledFn, KEYS, hasModifier, isPrintableKey, WrKey, badgeLog
 
 ## ngwr/validators
@@ -674,7 +733,8 @@
 - exports: WrValidators
 
 ## ngwr/version
-- import: `import { … } from 'ngwr/version'`
+- import: `import { NGWR_VERSION } from 'ngwr/version'`
+- exports: NGWR_VERSION, NGWR_VERSION_TOKEN
 
 ## ngwr/virtual-scroll
 - import: `import { WrVirtualScroll } from 'ngwr/virtual-scroll'`
@@ -686,9 +746,10 @@
 - import: `import { WrWaves } from 'ngwr/waves'`
 - selector: `wr-waves`
 - 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/window
-- import: `import { WR_WINDOW_DATA } from '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, type WrWindowBeforeCloseHook, WrWindowRef, WrWindowTaskbar, WrWindowChromeSize, WrWindowConfig, WrWindowOs, WrWindowPersistMode, WrWindowSize, WrWindowSnap, WrWindowState, WrWindowStorageConfig
+- 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.