# 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, neutral, offline. ## 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 `` (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. `` renders as a `
  • ` containing either an `` (when linked) or a `` (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 ``. ## 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 , 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, type WrCascaderSize - 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, WrCheckboxSize, WrCheckboxGroup, WR_CHECKBOX_GROUP, type WrCheckboxGroupContext - Two-state checkbox. Standalone (boolean) or inside (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 `` 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 `` 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 `` at the pointer position on right-click. 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. `` + 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]` - exports: WrAutofocus, WrAutosize, WrClickOutside, WrCopyToClipboard ## 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 - `` 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: wraps a label + control + error message; 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, WrInputSize - Attribute directive applied to a native `` (or `