ngwr 7.2.0 → 7.3.0

package/llms-full.txt

@@ -0,0 +1,673 @@
+# ngwr — full reference
+
+> 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
+
+## ngwr/affix
+- import: `import { WrAffix } from 'ngwr/affix'`
+- selector: `[wrAffix]`
+- exports: WrAffix
+
+## ngwr/alert
+- import: `import { WrAlert } from 'ngwr/alert'`
+- selector: `wr-alert`
+- exports: WrAlert, WrAlertType
+- Inline status banner — info, success, warning, danger.
+
+## ngwr/anchor
+- import: `import { WrAnchor } from 'ngwr/anchor'`
+- selector: `wr-anchor`
+- exports: WrAnchor, type 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
+
+## ngwr/avatar
+- import: `import { WrAvatar } from 'ngwr/avatar'`
+- selector: `wr-avatar`
+- exports: WrAvatar, WrAvatarSize
+- Image avatar with a fixed square or rounded shape. Shows a spinner while the image loads.
+
+## ngwr/back-top
+- import: `import { WrBackTop } from 'ngwr/back-top'`
+- selector: `wr-back-top`
+- exports: WrBackTop
+- Pinned floating button that appears once the user has scrolled past `visibilityThreshold` and scrolls to the top on click.
+
+## ngwr/badge
+- import: `import { WrBadge } from 'ngwr/badge'`
+- selector: `wr-badge`, `wr-tag`
+- exports: WrBadge, WrTag, WrBadgeSize, 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
+- 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
+
+## ngwr/border-glow
+- import: `import { WrBorderGlow } from 'ngwr/border-glow'`
+- selector: `wr-border-glow`
+- exports: WrBorderGlow
+
+## ngwr/breadcrumbs
+- import: `import { WrBreadcrumbs } from 'ngwr/breadcrumbs'`
+- selector: `wr-breadcrumbs-item`, `wr-breadcrumbs`
+- exports: WrBreadcrumbs, WrBreadcrumbsItem
+- Navigation trail showing the user's location in the site hierarchy. `<wr-breadcrumbs-item>` renders as a `<li>` containing either an `<a>` (when linked) or a `<span aria-current=&quot;page&quot;>` (the final crumb). Separator is a CSS pseudo-element so it doesn't pollute the accessibility tree. Each item accepts an optional leading icon.
+
+## ngwr/burger
+- import: `import { WrBurger } from 'ngwr/burger'`
+- selector: `wr-burger`
+- exports: WrBurger
+- Animated menu toggle — three SVG strokes morph between a hamburger and a close mark. Two-way bindable, so it pairs naturally with a `<wr-drawer>`.
+
+## ngwr/button
+- import: `import { WrButton } from 'ngwr/button'`
+- 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].
+
+## ngwr/calendar
+- import: `import { WrCalendar } from 'ngwr/calendar'`
+- selector: `wr-calendar`
+- exports: WrCalendar, WrCalendarMode, WrCalendarRange
+- Month-view calendar — standalone widget for picking a single date or a date range. Built on the `WrDateAdapter` abstraction. Click the header label to zoom into month / year quick-pick views.
+
+## ngwr/calendar-heatmap
+- import: `import { WrCalendarHeatmap } from 'ngwr/calendar-heatmap'`
+- selector: `wr-calendar-heatmap`
+- exports: WrCalendarHeatmap, type WrHeatmapDatum
+- Year-grid heatmap — the classic GitHub contributions layout.
+
+## ngwr/card
+- import: `import { WrCard } from 'ngwr/card'`
+- selector: `wr-card`, `wr-card-header`, `wr-card-footer`
+- exports: WrCard, WrCardHeader, WrCardFooter
+- Surface container with optional header / footer slots. Bordered by default; toggle hoverable for clickable lists and loading for in-place data refresh.
+
+## ngwr/carousel
+- import: `import { WrCarousel } from 'ngwr/carousel'`
+- selector: `wr-carousel-slide`, `wr-carousel`
+- exports: WrCarousel, WrCarouselSlide
+- Slide carousel with prev/next, dots, and optional autoplay. Pause on hover.
+
+## ngwr/cascader
+- import: `import { WrCascader } from 'ngwr/cascader'`
+- selector: `wr-cascader`
+- exports: WrCascader, type WrCascaderOption
+- Multi-level select. Drills through hierarchical categories one column at a time; picking a leaf commits the full path. Implements `ControlValueAccessor` — model is `readonly T[]`.
+
+## ngwr/checkbox
+- import: `import { WrCheckbox } from 'ngwr/checkbox'`
+- selector: `wr-checkbox-group`, `wr-checkbox`
+- exports: WrCheckbox, WrCheckboxGroup, WR_CHECKBOX_GROUP, type 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
+
+## ngwr/click-spark
+- import: `import { WrClickSpark } from 'ngwr/click-spark'`
+- selector: `wr-click-spark`
+- exports: WrClickSpark, type WrClickSparkEasing
+
+## ngwr/clipboard
+- import: `import { WrClipboard } from 'ngwr/clipboard'`
+- exports: WrClipboard, type WrClipboardPermission
+
+## 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
+- 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
+- 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
+- import: `import { WrCommandPalette } from 'ngwr/command-palette'`
+- selector: `wr-command-palette`
+- exports: WrCommandPalette, WrCommandItem, WrCommandGroup
+- ⌘K-style centred modal with a search input and filtered list of actions. Items group automatically, support icons, descriptions, and shortcut hints. Bind a global hotkey (default `mod+k`) or open it programmatically.
+
+## ngwr/compare
+- import: `import { WrCompare } from 'ngwr/compare'`
+- selector: `wr-compare`
+- exports: WrCompare
+- Before/after split with a draggable divider. Project anything (images, text, divs, components) via `[wrCompareBefore]` and `[wrCompareAfter]` attributes — the component stacks them and clips the after side.
+
+## ngwr/confetti
+- import: `import { WrConfetti } from 'ngwr/confetti'`
+- exports: WrConfetti, WrConfettiOptions
+
+## ngwr/context-menu
+- import: `import { WrContextMenu } from 'ngwr/context-menu'`
+- selector: `wr-context-menu-divider`, `wr-context-menu-item`, `wr-context-menu`, `[wrContextMenu]`
+- exports: WrContextMenu, WrContextMenuPanel, WrContextMenuItem, WrContextMenuDivider
+- Attach `[wrContextMenu]` to any element to open a `<wr-context-menu>` at the pointer position on right-click — or a long-press on touch. Native browser menu is suppressed on the host.
+
+## ngwr/cookie
+- import: `import { WrCookie } from 'ngwr/cookie'`
+- exports: WrCookie, type WrCookieOptions
+
+## ngwr/counter
+- import: `import { WrCounter } from 'ngwr/counter'`
+- selector: `wr-count-up`, `wr-counter`
+- exports: WrCounter, WrCounterMode, WrCountUp, type WrCountUpDirection, type WrCountUpEasing, type 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
+
+## 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`
+- exports: WrDatePicker
+- Unified date / time / date-time picker. `<input>` + popover for every mode — overlay content swaps based on `[mode]`. Parses on every keystroke (silently — only emits when valid), reformats canonical on blur. Format driven by `WrDateAdapter`.
+
+## ngwr/decrypt-text
+- import: `import { WrDecryptText } from 'ngwr/decrypt-text'`
+- selector: `wr-decrypt-text`
+- exports: WrDecryptText, type WrDecryptTextAnimateOn, type WrDecryptTextClickMode, type WrDecryptTextRevealDirection
+
+## 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
+
+## ngwr/descriptions
+- import: `import { WrDescriptions } from 'ngwr/descriptions'`
+- selector: `wr-description-item`, `wr-descriptions`
+- exports: WrDescriptions, WrDescriptionItem
+- Read-only labeled key/value list. `inline` for label-left / value-right, `bordered` for a card.
+
+## ngwr/dialog
+- import: `import { WrDialog } from 'ngwr/dialog'`
+- exports: WrDialog, WrDialogRef, WR_DIALOG_DATA, WrDialogOptions, WrDialogTitle, WrDialogContent, WrDialogFooter, WrDialogClose
+- Modal dialogs via a service that wraps @angular/cdk/dialog. Open any component as a dialog and read its close result as a Promise.
+
+## ngwr/directives
+- import: `import { WrAutofocus } from 'ngwr/directives'`
+- selector: `[wrAutofocus]`, `textarea[wrAutosize]`, `[wrClickOutside]`, `[wrCopyToClipboard]`, `[wrReveal]`
+- exports: WrAutofocus, WrAutosize, WrClickOutside, WrCopyToClipboard, WrReveal
+
+## ngwr/divider
+- import: `import { WrDivider } from 'ngwr/divider'`
+- selector: `wr-divider`
+- exports: WrDivider, WrDividerType
+- 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.
+
+## ngwr/drag-drop
+- import: `import { WrSortableList } from 'ngwr/drag-drop'`
+- selector: `[wrDragHandle]`, `wr-sortable-list`
+- exports: WrSortableList, type 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`
+- exports: WrDrawer, WrDrawerTitle, WrDrawerContent, WrDrawerFooter, WrDrawerClose, WrDrawerPosition
+- Side panel that slides in from any edge. Two-way binds `open`; renders into a CDK overlay so it sits above page content.
+
+## ngwr/dropdown
+- import: `import { WrDropdown } from 'ngwr/dropdown'`
+- selector: `wr-dropdown-item`, `wr-dropdown-menu`, `[wrDropdown]`
+- exports: WrDropdown, WrDropdownMenu, WrDropdownItem, WrDropdownPosition, WrDropdownTrigger
+- Attach a floating menu to any trigger via the wrDropdown directive. Built on CDK Overlay — handles outside clicks, Escape, and edge collisions.
+
+## ngwr/empty
+- import: `import { WrEmpty } from 'ngwr/empty'`
+- selector: `wr-empty`
+- exports: WrEmpty
+- Empty-state placeholder for when the underlying data is missing. Project a description and an optional `[wrEmptyActions]` row.
+
+## ngwr/falling-text
+- import: `import { WrFallingText } from 'ngwr/falling-text'`
+- selector: `wr-falling-text`
+- exports: WrFallingText, type WrFallingTextTrigger
+
+## ngwr/file-upload
+- import: `import { WrFileUpload } from 'ngwr/file-upload'`
+- selector: `wr-file-upload`
+- exports: WrFileUpload, WrFileUploadRejection, WrFileUploadRejectionReason
+- Drag-and-drop zone with click-to-browse and an optional file list. Value type is `File | File[] | null`. Rejected files surface through the `(rejected)` output.
+
+## ngwr/form
+- import: `import { WrFormItem } from 'ngwr/form'`
+- selector: `wr-form-field`, `wr-form-error`, `wr-form-item`
+- exports: WrFormItem, WrFormField, WrFormError
+- 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
+
+## 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/glitch-text
+- import: `import { WrGlitchText } from 'ngwr/glitch-text'`
+- selector: `wr-glitch-text`
+- exports: WrGlitchText
+
+## ngwr/gradient-text
+- import: `import { WrGradientText } from 'ngwr/gradient-text'`
+- selector: `wr-gradient-text`
+- exports: WrGradientText, type WrGradientTextDirection
+
+## ngwr/hotkey
+- import: `import { WrHotkey } from 'ngwr/hotkey'`
+- selector: `[wrHotkey]`
+- exports: WrHotkey, WrHotkeyBinding, parseHotkeySpec, matchesHotkey, type WrParsedHotkey, WrHotkeyHandle, WrHotkeyOptions, WrHotkeySpec
+
+## 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, WrI18nStaticLoader, type WrI18nStaticCatalogs, type WrI18nStaticScopedCatalogs, WrI18nHttpLoader, type WrI18nHttpLoaderConfig, provideWrI18n, provideWrI18nStaticLoader, provideWrI18nHttpLoader, type ProvideWrI18nOptions, useI18nText, readI18nText, useI18nFormatter
+
+## 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/image-cropper
+- import: `import { WrImageCropper } from 'ngwr/image-cropper'`
+- selector: `wr-image-cropper`
+- 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/input
+- import: `import { WrInput } from 'ngwr/input'`
+- selector: `wr-input-group`, `wr-password-toggle`
+- exports: WrInput, WrInputPrefix, WrInputSuffix, WrInputGroup, WrPasswordToggle, WrInputType
+- 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.
+
+## ngwr/input-number
+- import: `import { WrInputNumber } from 'ngwr/input-number'`
+- selector: `wr-input-number`
+- exports: WrInputNumber
+- Numeric input with locale-aware formatting and ▲▼ stepper buttons. Value is `number | null`. Parses leniently while typing, re-formats with grouping + fixed decimals on blur.
+
+## ngwr/input-otp
+- import: `import { WrInputOtp } from 'ngwr/input-otp'`
+- selector: `wr-input-otp`
+- exports: WrInputOtp, WrInputOtpMode
+- Fixed-length one-time-code input. One cell per character, auto-advances focus on typing, handles paste of a full code, optional masking like a password field.
+
+## ngwr/keyboard
+- import: `import { WrKbd } from 'ngwr/keyboard'`
+- selector: `wr-kbd`
+- exports: WrKbd, WrKbdSize
+- Keycap chip for rendering keyboard shortcuts in copy. Stack with a plain `+` between caps for chords.
+
+## ngwr/knob
+- import: `import { WrKnob } from 'ngwr/knob'`
+- selector: `wr-knob`
+- exports: WrKnob
+- Radial dial input. CVA-backed `number | null`. Drag around the dial or use arrow keys (Shift = ×10).
+
+## ngwr/layout
+- import: `import { WrLayout } from 'ngwr/layout'`
+- selector: `wr-layout-content`, `wr-layout-footer`, `wr-layout-header`, `wr-layout-sider`, `wr-layout`
+- exports: WrLayout, WrLayoutHeader, WrLayoutSider, WrLayoutContent, WrLayoutFooter
+- App-shell layout primitives. Container switches to row automatically when a sider is among its children — drop in header / sider / content / footer and it falls into place.
+
+## ngwr/lightbox
+- import: `import { WrLightbox } from 'ngwr/lightbox'`
+- selector: `wr-lightbox`
+- 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/line-chart
+- import: `import { WrLineChart } from 'ngwr/line-chart'`
+- selector: `wr-line-chart`
+- exports: WrLineChart, type WrLineSeries
+- Multi-series line chart with a hover tooltip that snaps to the nearest x-axis tick.
+
+## ngwr/list
+- import: `import { WrList } from 'ngwr/list'`
+- selector: `wr-list-item`, `wr-list`
+- exports: WrList, WrListItem
+- Generic list with leading / body / trailing slots. Bordered or flat, with optional dividers + dense padding. Items can be plain or interactive (hover + Enter/Space activation).
+
+## ngwr/loading-bar
+- import: `import { WrLoadingBar } from 'ngwr/loading-bar'`
+- selector: `wr-loading-bar`
+- exports: WrLoadingBar, type WrLoadingState, WrLoadingBarComponent
+
+## ngwr/marquee
+- import: `import { WrMarquee } from 'ngwr/marquee'`
+- selector: `wr-marquee`
+- exports: WrMarquee, type WrMarqueeItem, type WrMarqueeImage, type WrMarqueeNode
+
+## ngwr/media
+- import: `import { WrMedia } from 'ngwr/media'`
+- exports: WrMedia, provideWrMedia, WR_BREAKPOINTS, DEFAULT_WR_BREAKPOINTS, WrBreakpoint, WrBreakpointMap
+
+## ngwr/mention
+- import: `import { WrMention } from 'ngwr/mention'`
+- selector: `wr-mention-panel`, `[wrMention]`
+- exports: WrMention, WrMentionPanel, WrMentionItem, WrMentionCommit
+- `@`-style mention picker for `<textarea>` and `<input>`. Detects trigger characters at word boundaries, opens an overlay at the caret, commits the selection back into the field.
+
+## ngwr/meta
+- import: `import { WrMeta } from 'ngwr/meta'`
+- selector: `[wrMeta]`
+- exports: WrMeta, WrMetaBinding, provideWrMeta, WR_META_DEFAULTS, WrMetaConfig, WrMetaHandle, WrMetaOg, WrMetaTwitter
+
+## ngwr/meter-group
+- import: `import { WrMeterGroup } from 'ngwr/meter-group'`
+- selector: `wr-meter-group`
+- 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/overlay
+- import: `import { WrOverlayContainer } from 'ngwr/overlay'`
+- exports: WrOverlayContainer, provideWrOverlay, provideWrResponsiveOverlays, WR_OVERLAY, WR_OVERLAY_CONTAINER, WR_RESPONSIVE_OVERLAYS, wrPresentAsSheet
+
+## ngwr/page-header
+- import: `import { WrPageHeader } from 'ngwr/page-header'`
+- selector: `wr-page-header`
+- exports: WrPageHeader
+- Top-of-page heading block with three projected slots — breadcrumbs, actions, extra (tags / metadata).
+
+## ngwr/pagination
+- import: `import { WrPagination } from 'ngwr/pagination'`
+- selector: `wr-pagination`
+- exports: WrPagination, WrPaginationAlign
+- 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
+
+## ngwr/platform
+- import: `import { WrPlatform } from 'ngwr/platform'`
+- exports: WrPlatform
+
+## ngwr/popconfirm
+- import: `import { WrPopconfirm } from 'ngwr/popconfirm'`
+- selector: `wr-popconfirm`, `[wrPopconfirm]`
+- exports: WrPopconfirm, WrPopconfirmPanel, WrPopconfirmPosition
+
+## 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).
+
+## ngwr/progress
+- import: `import { WrProgress } from 'ngwr/progress'`
+- selector: `wr-progress`
+- exports: WrProgress
+- Horizontal progress bar with theme colors and an animated fill.
+
+## ngwr/qr
+- import: `import { WrQr } from 'ngwr/qr'`
+- selector: `wr-qr`
+- exports: WrQr, WrQrErrorLevel
+- Renders a QR code on a canvas. Optional center icon overlay. Encoding is handled by [Project Nayuki's QR Code generator library](https://www.nayuki.io/page/qr-code-generator-library) (MIT) vendored inline — no runtime dependency.
+
+## ngwr/radio
+- import: `import { WrRadio } from 'ngwr/radio'`
+- selector: `wr-radio-group`, `wr-radio`
+- exports: WrRadio, WrRadioGroup, WR_RADIO_GROUP, type WrRadioGroupContext
+- Single-choice option. Always used inside <wr-radio-group>, which implements ControlValueAccessor.
+
+## ngwr/rating
+- import: `import { WrRating } from 'ngwr/rating'`
+- selector: `wr-rating`
+- exports: WrRating
+- Star rating input with whole or half-step granularity. Value type is `number | null` (clamped to `[0, count]`). Keyboard: arrows step by `step`, Home / End jump to 0 / max, Delete / Backspace clears.
+
+## ngwr/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
+- 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
+
+## ngwr/scramble-text
+- import: `import { WrScrambleText } from 'ngwr/scramble-text'`
+- selector: `wr-scramble-text`
+- exports: WrScrambleText
+
+## ngwr/scroll
+- import: `import { WrScroll } from 'ngwr/scroll'`
+- exports: WrScroll, WrScrollTarget, WrScrollOptions
+
+## ngwr/segmented
+- import: `import { WrSegmented } from 'ngwr/segmented'`
+- selector: `wr-segmented`
+- exports: WrSegmented, WrSegmentedOption
+- Single-choice picker rendered as a segmented control. Two-way binds the selected value.
+
+## 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
+- Native-like select built on CDK Overlay. Implements ControlValueAccessor.
+
+## ngwr/shiny-text
+- import: `import { WrShinyText } from 'ngwr/shiny-text'`
+- selector: `[wrShimmer]`, `wr-shiny-text`
+- exports: WrShinyText, WrShimmer
+
+## ngwr/sidebar
+- import: `import { WrSidebar } from 'ngwr/sidebar'`
+- selector: `wr-sidebar`
+- exports: WrSidebar, WrSidebarItem, WrSidebarGroup, WrSidebarEntry
+- Data-driven nav with flat links and expandable groups. Active route auto-expands its containing group. Icons, trailing badges, and disabled state all opt-in per entry.
+
+## ngwr/skeleton
+- import: `import { WrSkeleton } from 'ngwr/skeleton'`
+- selector: `wr-skeleton`
+- exports: WrSkeleton
+- Placeholder block shown while content is loading. Default height matches the surrounding line height (1lh).
+
+## ngwr/slider
+- import: `import { WrSlider } from 'ngwr/slider'`
+- selector: `wr-slider`
+- exports: WrSlider, WrSliderValue
+- Drag-to-pick numeric input. Single-thumb by default, optional dual-thumb range mode. Implements `ControlValueAccessor` so it plays nicely with template-driven and reactive forms.
+
+## ngwr/sparkline
+- import: `import { WrSparkline } from 'ngwr/sparkline'`
+- selector: `wr-sparkline`
+- exports: WrSparkline
+- Tiny inline trend line — no axes, no labels. Drop it next to a number to give context at a glance.
+
+## ngwr/speed-dial
+- import: `import { WrSpeedDial } from 'ngwr/speed-dial'`
+- selector: `wr-speed-dial`
+- exports: WrSpeedDial, type WrSpeedDialAction, type WrSpeedDialDirection
+- Floating action button that fans out a set of secondary actions on click.
+
+## ngwr/spinner
+- import: `import { WrSpinner } from 'ngwr/spinner'`
+- selector: `wr-spinner`
+- exports: WrSpinner, WrSpinnerSize
+- Inline loading indicator. Em-based sizing and inherits color from surrounding text.
+
+## ngwr/splash-cursor
+- import: `import { WrSplashCursor } from 'ngwr/splash-cursor'`
+- selector: `wr-splash-cursor`
+- exports: WrSplashCursor, WrFluidConfig
+
+## ngwr/split-text
+- import: `import { WrSplitText } from 'ngwr/split-text'`
+- selector: `wr-split-text`
+- exports: WrSplitText, type WrSplitTextMotion, type WrSplitTextUnit
+
+## 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/spotlight-card
+- import: `import { WrSpotlightCard } from 'ngwr/spotlight-card'`
+- selector: `wr-spotlight-card`, `[wrSpotlight]`
+- exports: WrSpotlightCard, WrSpotlight
+
+## ngwr/squircle
+- import: `import { squirclePath } from 'ngwr/squircle'`
+- selector: `wr-squircle`, `[wrSquircle]`
+- exports: squirclePath, type WrSquircleCorners, WrSquircle, type 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
+
+## ngwr/statistic
+- import: `import { WrStatistic } from 'ngwr/statistic'`
+- selector: `wr-statistic-countdown`, `wr-statistic`
+- exports: WrStatistic, WrStatisticCountdown
+- KPI card — label + big number + optional prefix / suffix + delta.
+
+## ngwr/stepper
+- import: `import { WrStepper } from 'ngwr/stepper'`
+- selector: `wr-step`, `wr-stepper`
+- exports: WrStepper, WrStep, WR_STEPPER, type 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
+
+## ngwr/switch
+- import: `import { WrSwitch } from 'ngwr/switch'`
+- selector: `wr-switch`
+- exports: WrSwitch
+- Boolean toggle with an iOS-style slider. Implements ControlValueAccessor.
+
+## ngwr/table
+- import: `import { WrTable } from 'ngwr/table'`
+- selector: `[wrTableCell]`, `wr-table-filter`, `wr-table-sort`, `wr-table`
+- exports: WrTable, WrTableCell, WrTableSort, WrTableFilter, WrTableCellContext, WrTableColumn, WrTableColumns, WrTableFilterChange, WrTableFilterItem, WrTableSortState, WrTableSortDirection
+- Data table with sortable / filterable headers and custom cell templates.
+
+## ngwr/tabs
+- import: `import { WrTabs } from 'ngwr/tabs'`
+- selector: `wr-tab`, `wr-tabs`
+- exports: WrTabs, WrTab, WR_TABS, type WrTabsContext
+- Tabbed container. Use projected content for simple tabs, or set routerLink on children to switch into router mode.
+
+## ngwr/textarea
+- import: `import { WrTextarea } from 'ngwr/textarea'`
+- selector: `wr-textarea`
+- exports: WrTextarea
+- Multi-line text input. Implements ControlValueAccessor. Optional autosize.
+
+## 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
+
+## ngwr/tilt-card
+- import: `import { WrTiltCard } from 'ngwr/tilt-card'`
+- selector: `wr-tilt-card`, `[wrTilt]`
+- exports: WrTiltCard, WrTilt
+
+## ngwr/timeline
+- import: `import { WrTimeline } from 'ngwr/timeline'`
+- selector: `wr-timeline-item`, `wr-timeline`
+- exports: WrTimeline, WrTimelineItem, type WrTimelineColor
+- Event ladder with markers. Vertical (default) or horizontal. Dot colors: primary / success / warning / danger / medium.
+
+## 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.
+
+## ngwr/toolbar
+- import: `import { WrToolbar } from 'ngwr/toolbar'`
+- selector: `wr-toolbar`
+- exports: WrToolbar
+- Three-zone action bar — start / center / end. Each zone collapses when empty.
+
+## 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.
+
+## ngwr/typewriter
+- import: `import { WrTypewriter } from 'ngwr/typewriter'`
+- selector: `wr-typewriter`
+- exports: WrTypewriter, type WrTypewriterVariableSpeed
+
+## ngwr/typography
+- import: `import { WrTypography } from 'ngwr/typography'`
+- selector: `[wrTypography]`
+- exports: WrTypography, WrTypographyVariant, WrTypographyAlign, WrTypographyTone
+
+## ngwr/utils
+- import: `import { Maybe } 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
+- import: `import { WrValidators } from 'ngwr/validators'`
+- exports: WrValidators
+
+## ngwr/version
+- import: `import { … } from 'ngwr/version'`
+
+## ngwr/virtual-scroll
+- import: `import { WrVirtualScroll } from 'ngwr/virtual-scroll'`
+- selector: `wr-virtual-scroll`
+- exports: WrVirtualScroll
+- Fixed-size virtual scroll viewport. Thin wrapper around CDK's `cdk-virtual-scroll-viewport` with ngwr theming + sensible buffer defaults. Renders only the rows actually on screen, so a 100k-row list costs the same as a 30-row list.
+
+## ngwr/waves
+- import: `import { WrWaves } from 'ngwr/waves'`
+- selector: `wr-waves`
+- exports: WrWaves
+
+## ngwr/window
+- import: `import { WR_WINDOW_DATA } 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
+- 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.