ngwr 13.0.1 → 14.0.1

package/i18n/en.json

@@ -29,7 +29,8 @@
     "goToPage": "Go to page {{page}}",
     "label": "Pagination",
     "pageOf": "Page {{current}} of {{total}}",
-    "of": "of"
+    "range": "{{from}}–{{to}} of {{total}}",
+    "compact": "{{current}} / {{total}}"
   },
   "table": {
     "empty": "No data",
@@ -120,12 +121,14 @@
     "collapse": "Collapse",
     "placeholder": "Select…",
     "clearSelection": "Clear selection",
-    "removeItem": "Remove {{label}}"
+    "removeItem": "Remove {{label}}",
+    "more": "+{{count}} more"
   },
   "commandPalette": {
     "label": "Command palette",
     "placeholder": "Type a command or search…",
-    "noResults": "No results"
+    "noResults": "No results",
+    "escHint": "esc"
   },
   "empty": {
     "noData": "No data"
@@ -136,7 +139,13 @@
     "dropZoneLabel": "File upload drop zone — click or drop files",
     "removeFile": "Remove file",
     "invalid": "Unsupported file type",
-    "tooBig": "File too large"
+    "tooBig": "File too large",
+    "size": "{{value}} {{unit}}",
+    "unitByte": "B",
+    "unitKb": "KB",
+    "unitMb": "MB",
+    "unitGb": "GB",
+    "unitTb": "TB"
   },
   "popconfirm": {
     "label": "Confirm action",
@@ -184,7 +193,10 @@
     "prevYear": "Previous year",
     "nextYear": "Next year",
     "prevYears": "Previous 12 years",
-    "nextYears": "Next 12 years"
+    "nextYears": "Next 12 years",
+    "header": "{{month}} {{year}}",
+    "yearRange": "{{from}} – {{to}}",
+    "dayLabel": "{{weekday}}, {{date}}"
   },
   "imageCropper": {
     "empty": "No image",
@@ -201,7 +213,18 @@
   "colorPicker": {
     "area": "Saturation and brightness, {{saturation}}% and {{brightness}}%",
     "hue": "Hue",
-    "alpha": "Opacity"
+    "alpha": "Opacity",
+    "formatHex": "HEX",
+    "formatRgb": "RGB",
+    "formatHsl": "HSL",
+    "channelHex": "HEX",
+    "channelRed": "R",
+    "channelGreen": "G",
+    "channelBlue": "B",
+    "channelHue": "H",
+    "channelSaturation": "S%",
+    "channelLightness": "L%",
+    "channelAlpha": "A%"
   },
   "calendarHeatmap": {
     "label": "Calendar heatmap"
@@ -329,6 +352,10 @@
   "speedDial": {
     "label": "Actions"
   },
+  "statistic": {
+    "delta": "{{value}}{{suffix}}",
+    "deltaSuffix": "%"
+  },
   "result": {
     "notFound": "Sorry, the page you visited does not exist.",
     "forbidden": "Sorry, you are not authorized to access this page.",

package/i18n/ru.json

@@ -29,7 +29,8 @@
     "goToPage": "Перейти на страницу {{page}}",
     "label": "Пагинация",
     "pageOf": "Страница {{current}} из {{total}}",
-    "of": "из"
+    "range": "{{from}}–{{to}} из {{total}}",
+    "compact": "{{current}} / {{total}}"
   },
   "table": {
     "empty": "Нет данных",
@@ -120,12 +121,14 @@
     "collapse": "Свернуть",
     "placeholder": "Выберите…",
     "clearSelection": "Очистить выбор",
-    "removeItem": "Удалить {{label}}"
+    "removeItem": "Удалить {{label}}",
+    "more": "ещё {{count}}"
   },
   "commandPalette": {
     "label": "Палитра команд",
     "placeholder": "Введите команду или поиск…",
-    "noResults": "Ничего не найдено"
+    "noResults": "Ничего не найдено",
+    "escHint": "esc"
   },
   "empty": {
     "noData": "Нет данных"
@@ -136,7 +139,13 @@
     "dropZoneLabel": "Зона загрузки файлов — нажмите или перетащите",
     "removeFile": "Удалить файл",
     "invalid": "Неподдерживаемый тип файла",
-    "tooBig": "Файл слишком большой"
+    "tooBig": "Файл слишком большой",
+    "size": "{{value}} {{unit}}",
+    "unitByte": "Б",
+    "unitKb": "КБ",
+    "unitMb": "МБ",
+    "unitGb": "ГБ",
+    "unitTb": "ТБ"
   },
   "popconfirm": {
     "label": "Подтверждение действия",
@@ -184,7 +193,10 @@
     "prevYear": "Предыдущий год",
     "nextYear": "Следующий год",
     "prevYears": "Предыдущие 12 лет",
-    "nextYears": "Следующие 12 лет"
+    "nextYears": "Следующие 12 лет",
+    "header": "{{month}} {{year}}",
+    "yearRange": "{{from}} – {{to}}",
+    "dayLabel": "{{weekday}}, {{date}}"
   },
   "imageCropper": {
     "empty": "Нет изображения",
@@ -201,7 +213,18 @@
   "colorPicker": {
     "area": "Насыщенность и яркость, {{saturation}}% и {{brightness}}%",
     "hue": "Оттенок",
-    "alpha": "Непрозрачность"
+    "alpha": "Непрозрачность",
+    "formatHex": "HEX",
+    "formatRgb": "RGB",
+    "formatHsl": "HSL",
+    "channelHex": "HEX",
+    "channelRed": "R",
+    "channelGreen": "G",
+    "channelBlue": "B",
+    "channelHue": "H",
+    "channelSaturation": "S%",
+    "channelLightness": "L%",
+    "channelAlpha": "A%"
   },
   "calendarHeatmap": {
     "label": "Календарная тепловая карта"
@@ -329,6 +352,10 @@
   "speedDial": {
     "label": "Действия"
   },
+  "statistic": {
+    "delta": "{{value}}{{suffix}}",
+    "deltaSuffix": "%"
+  },
   "result": {
     "notFound": "Извините, страница не найдена.",
     "forbidden": "Извините, доступ к этой странице ограничен.",

package/llms-full.txt

@@ -129,7 +129,7 @@
 
 ## ngwr/calendar/testing
 - import: `import { WrCalendarDayHarness } from 'ngwr/calendar/testing'`
-- exports: WrCalendarDayHarness, WrCalendarHarness, WrCalendarChip, WrCalendarDayHarnessFilters, WrCalendarHarnessFilters, WrCalendarView
+- exports: WrCalendarDayHarness, WrCalendarHarness, WrCalendarArrowKey, WrCalendarChip, WrCalendarDayHarnessFilters, WrCalendarHarnessFilters, WrCalendarView
 
 ## ngwr/card
 - import: `import { WrCard } from 'ngwr/card'`
@@ -191,7 +191,7 @@
 ## ngwr/collapse
 - import: `import { WrCollapse } from 'ngwr/collapse'`
 - selector: `wr-accordion`, `wr-collapse-group`, `wr-collapse`
-- exports: WrCollapse, WrCollapseGroup, WrAccordion, WR_COLLAPSE_GROUP, WrCollapseGroupContext
+- exports: WrCollapse, WrCollapseGroup, WrAccordion, WR_COLLAPSE_GROUP, WrCollapseGroupContext, WrCollapseGroupMember
 - Expandable panel with a clickable header. Two-way binds `open`. Wrap in `<wr-collapse-group accordion>` for single-open behavior.
 
 ## ngwr/collapse/testing
@@ -262,15 +262,15 @@
 - import: `import { WrDatePicker } from 'ngwr/date-picker'`
 - selector: `wr-date-picker`, `wr-date-range-picker`
 - exports: WrDatePicker, WrDateRangePicker, WrDateRange
-- 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`. 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.
+- 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`. 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 22's forms bridge](/guides/forms).
 
 ## ngwr/date-picker/testing
 - import: `import { WrDatePickerDayHarness } from 'ngwr/date-picker/testing'`
-- exports: WrDatePickerDayHarness, WrDatePickerHarness, WrDateRangePickerHarness, WrDatePickerDayHarnessFilters, WrDatePickerHarnessFilters, WrDatePickerTimeFields, WrDateRangePickerHarnessFilters
+- exports: WrDatePickerDayHarness, WrDatePickerHarness, WrDateRangePickerHarness, WrAnyDatePickerHarness, WrDatePickerDayHarnessFilters, WrDatePickerHarnessFilters, WrDatePickerTimeFields, WrDateRangePickerEnd, WrDateRangePickerHarnessFilters
 
 ## ngwr/date/adapters/fns
 - import: `import { WrDateFnsAdapter } from 'ngwr/date/adapters/fns'`
-- exports: WrDateFnsAdapter, provideWrDateFnsAdapter
+- exports: WrDateFnsAdapter, provideWrDateFnsAdapter, WR_DATE_FNS_LOCALE
 
 ## ngwr/date/adapters/luxon
 - import: `import { WrLuxonAdapter } from 'ngwr/date/adapters/luxon'`
@@ -369,7 +369,7 @@
 
 ## ngwr/event-calendar/testing
 - import: `import { WrEventCalendarChipHarness } from 'ngwr/event-calendar/testing'`
-- exports: WrEventCalendarChipHarness, WrEventCalendarHarness, WrEventCalendarChipHarnessFilters, WrEventCalendarHarnessFilters
+- exports: WrEventCalendarChipHarness, WrEventCalendarHarness, WrEventCalendarArrowKey, WrEventCalendarChipHarnessFilters, WrEventCalendarHarnessFilters
 
 ## ngwr/falling-text
 - import: `import { WrFallingText } from 'ngwr/falling-text'`
@@ -529,7 +529,7 @@
 
 ## ngwr/knob/testing
 - import: `import { WrKnobHarness } from 'ngwr/knob/testing'`
-- exports: WrKnobHarness, WrKnobHarnessFilters
+- exports: WrKnobHarness, WrKnobArrowKey, WrKnobHarnessFilters
 
 ## ngwr/layout
 - import: `import { WrLayout } from 'ngwr/layout'`
@@ -567,7 +567,11 @@
 - import: `import { WrLoadingBar } from 'ngwr/loading-bar'`
 - selector: `wr-loading-bar`
 - 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.
+- Top-of-page progress bar with a `start()` / `complete()` slot API for HTTP interceptors or any long-running task. Add `provideWrLoadingBarRouter()` and router navigations drive it as well — an opt-in, because that subscription is what would otherwise pull `@angular/router` into an app that never routes.
+
+## ngwr/loading-bar/router
+- import: `import { provideWrLoadingBarRouter } from 'ngwr/loading-bar/router'`
+- exports: provideWrLoadingBarRouter
 
 ## ngwr/markdown
 - import: `import { WrMarkdown } from 'ngwr/markdown'`
@@ -634,7 +638,7 @@
 - import: `import { WrPagination } from 'ngwr/pagination'`
 - selector: `wr-pagination`
 - exports: WrPagination, WrPaginationAlign, WrPaginationSize, WrPaginationShape
-- Numbered page navigator. Two-way binds currentPage and pageSize via signal models.
+- Numbered page navigator. Two-way binds page and pageSize via signal models.
 
 ## ngwr/pagination/testing
 - import: `import { WrPaginationHarness } from 'ngwr/pagination/testing'`
@@ -691,7 +695,7 @@
 - import: `import { WrRadio } from 'ngwr/radio'`
 - selector: `wr-radio-group`, `wr-radio`
 - 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.
+- 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 22's forms bridge](/guides/forms).
 
 ## ngwr/radio/testing
 - import: `import { WrRadioGroupHarness } from 'ngwr/radio/testing'`
@@ -701,7 +705,7 @@
 - import: `import { WrRating } from 'ngwr/rating'`
 - selector: `wr-rating`
 - exports: WrRating, WrRatingSize
-- 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.
+- Star rating input with whole or half-step granularity. Value type is `number | null`; `[0, count]` bounds what the control's own edits produce. Keyboard: arrows step by `step`, Home / End jump to 0 / max, Delete / Backspace clears.
 
 ## ngwr/rating/testing
 - import: `import { WrRatingHarness } from 'ngwr/rating/testing'`
@@ -742,7 +746,7 @@
 - import: `import { WrSelect } from 'ngwr/select'`
 - selector: `wr-option-group`, `wr-option`, `wr-select`
 - 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.
+- 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 22's forms bridge](/guides/forms).
 
 ## ngwr/select/testing
 - import: `import { WrOptionHarness } from 'ngwr/select/testing'`
@@ -774,7 +778,7 @@
 - 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. A signal-forms native control — it implements `FormValueControl`, so `[formField]` binds straight to its `value` model. `[(value)]` works standalone, and template-driven `[(ngModel)]` / reactive forms keep working through Angular's bridge.
+- Drag-to-pick numeric input. Single-thumb by default, optional dual-thumb range mode. A signal-forms native control — it implements `FormValueControl`, so `[formField]` binds straight to its `value` model. `[(value)]` works standalone, and template-driven `[(ngModel)]` / reactive forms keep working through [Angular 22's forms bridge](/guides/forms).
 
 ## ngwr/slider/testing
 - import: `import { WrSliderHarness } from 'ngwr/slider/testing'`
@@ -834,7 +838,7 @@
 
 ## ngwr/splitter/testing
 - import: `import { WrSplitterHarness } from 'ngwr/splitter/testing'`
-- exports: WrSplitterHarness, WrSplitterHarnessFilters, WrSplitterPaneSizes
+- exports: WrSplitterHarness, WrSplitterArrowKey, WrSplitterHarnessFilters, WrSplitterPaneSizes
 
 ## ngwr/spotlight-card
 - import: `import { WrSpotlightCard } from 'ngwr/spotlight-card'`
@@ -880,14 +884,14 @@
 
 ## ngwr/storage
 - import: `import { WrStorage } from 'ngwr/storage'`
-- exports: WrStorage, provideWrStorage, ProvideWrStorageOptions, WR_STORAGE_CONFIG, DEFAULT_WR_STORAGE_CONFIG, WrStorageConfig, WrStorageConfigResolved, WR_STORAGE_ENGINE, createMemoryStorage, WrStorageEngine
+- exports: WrStorage, provideWrStorage, ProvideWrStorageOptions, WR_STORAGE_CONFIG, DEFAULT_WR_STORAGE_CONFIG, WrStorageConfig, WrStorageConfigResolved, WR_STORAGE_ENGINE, createMemoryStorage, WrStorageEngine, WrStorageEnvelope
 - 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
 - import: `import { WrSwitch } from 'ngwr/switch'`
 - selector: `wr-switch`
 - exports: WrSwitch, WrSwitchSize
-- Boolean toggle with an iOS-style slider. A signal-forms native control — it implements `FormCheckboxControl`, so `[formField]` binds straight to its `checked` model. `[(checked)]` works standalone, and `[(ngModel)]` / reactive forms keep working through Angular's bridge.
+- Boolean toggle with an iOS-style slider. A signal-forms native control — it implements `FormCheckboxControl`, so `[formField]` binds straight to its `checked` model. `[(checked)]` works standalone, and `[(ngModel)]` / reactive forms keep working through [Angular 22's forms bridge](/guides/forms).
 
 ## ngwr/switch/testing
 - import: `import { WrSwitchHarness } from 'ngwr/switch/testing'`
@@ -906,9 +910,14 @@
 ## ngwr/tabs
 - import: `import { WrTabs } from 'ngwr/tabs'`
 - selector: `wr-tab`, `wr-tabs`
-- exports: WrTabs, WrTab, WR_TABS, WrTabsContext
+- exports: WrTabs, WrTab, WR_TABS, WrTabsContext, WR_TABS_ROUTING, WrTabsRoutingAdapter
 - Tabbed container. Use projected content for simple tabs, or set routerLink on children to switch into router mode.
 
+## ngwr/tabs/router
+- import: `import { WrTabsRouting } from 'ngwr/tabs/router'`
+- selector: `[wrTabsRouting]`
+- exports: WrTabsRouting
+
 ## ngwr/tabs/testing
 - import: `import { WrTabHarness } from 'ngwr/tabs/testing'`
 - exports: WrTabHarness, WrTabsHarness, WrTabHarnessFilters, WrTabsHarnessFilters, WrTabsHarnessSize
@@ -917,7 +926,7 @@
 - import: `import { WrTextarea } from 'ngwr/textarea'`
 - selector: `wr-textarea`
 - exports: WrTextarea, WrTextareaSize, WrTextareaResize
-- 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.
+- 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 22's forms bridge](/guides/forms).
 
 ## ngwr/textarea/testing
 - import: `import { WrTextareaHarness } from 'ngwr/textarea/testing'`
@@ -925,7 +934,7 @@
 
 ## ngwr/theme
 - import: `import { WrTheme } from 'ngwr/theme'`
-- exports: WR_COLORS, wrContrastFor, wrIntentTokens, wrThemeTokens, WrColor, WrTheme, provideWrTheme, WR_THEME_CONFIG, DEFAULT_WR_THEME_CONFIG, WrResolvedTheme, WrThemeMode, WrThemeConfig
+- exports: WR_COLORS, wrContrastFor, wrIntentTokens, wrThemeTokens, WrColor, WrTheme, provideWrTheme, wrThemePrePaintScript, WrThemePrePaintOptions, 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
@@ -1007,7 +1016,7 @@
 
 ## ngwr/utils
 - import: `import { isDefined } from 'ngwr/utils'`
-- exports: Maybe, SafeAny, isDefined, isNonEmptyArray, isObservable, clamp, round, numAttr, isSafeCssValue, resolveCssSize, ResolveCssSizeOptions, ResolvedCssSize, getRootFontSize, getFocusableElements, trapFocus, randomId, noop, debounce, throttle, WrDebouncedFn, WrThrottledFn, KEYS, hasModifier, isPrintableKey, WrKey, badgeLog
+- exports: Maybe, SafeAny, isDefined, isNonEmptyArray, isObservable, clamp, round, numAttr, isSafeCssValue, resolveCssSize, ResolveCssSizeOptions, ResolvedCssSize, getRootFontSize, getFocusableElements, trapFocus, randomId, noop, debounce, throttle, WrDebouncedFn, WrThrottledFn, KEYS, hasModifier, isComposing, isPrintableKey, WrKey, badgeLog
 
 ## ngwr/validators
 - import: `import { WrValidators } from 'ngwr/validators'`

package/llms.txt

@@ -1,7 +1,7 @@
 # ngwr
 
 > Angular UI library — standalone, signals-first, zoneless, fully tree-shakable.
-> 202 secondary entry points, 187 component and directive classes, built on
+> 204 secondary entry points, 174 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
 
@@ -28,11 +28,36 @@ pnpm add ngwr @angular/cdk
 
 Requires Angular / CDK `>= 22.0.0` (peers: `@angular/cdk`, `@angular/common`,
 `@angular/core`, `@angular/platform-browser`, `rxjs ^7`; optional `date-fns` /
-`luxon` / `lucide`).
+`luxon` / `lucide`). On Angular 21 or older the INSTALL succeeds — every package
+manager treats an unmet peer as a warning — and the `ng build` fails instead, in
+the linker, with `Unsupported enum value for [object Object]`. The floor is real
+and the ceiling is absent — an Angular newer than the release has not been built
+or tested against, and nothing warns. There is no `engines` field and no
+TypeScript peer either: both come from your Angular. What that range does and
+does not promise: https://ngwr.dev/start/versioning
 
-Each component is a tree-shakable subpath import: `import { WrButton } from
-'ngwr/button'`. Styles: `@use 'ngwr'` (everything) or `@use 'ngwr/<name>'` (per
-component) in your global SCSS.
+**There is no root barrel: `import { X } from 'ngwr'` is always wrong.** The root
+entry point exports nothing, so an IDE auto-import from it gives `TS2305` and no
+hint. Every symbol comes from its entry point — `import { WrButton } from
+'ngwr/button'` — and the entry point is the last segment of the component's docs
+URL. Mind the ones that do not match the selector: `<wr-btn>` is `ngwr/button`,
+`<wr-tag>` is `ngwr/badge`, `<wr-option>` is `ngwr/select`, `<wr-accordion>` is
+`ngwr/collapse`, `<wr-form-field>` is `ngwr/form`, `<wr-sortable-list>` is
+`ngwr/drag-drop`, `<wr-kbd>` is `ngwr/keyboard`.
+
+Styles: `@use 'ngwr'` (everything — about 290 kB minified, 42 kB gzipped) or
+`@use 'ngwr/<name>'` per component in your global SCSS. **Per component, the
+theme tokens come with each entry but the other components it renders do not**,
+and nothing warns — the control just paints wrong. Always add `ngwr/icon` (the
+inline chevrons, carets and sort arrows are bare SVGs sized by `.wr-icon__svg`),
+`ngwr/density` (nothing else declares the `--wr-density-*` multipliers, so
+`provideWrDensity()` silently does nothing without it) and `ngwr/overlay` (the
+responsive bottom sheet). Then follow what a component renders:
+`ngwr/table` needs checkbox / dropdown / pagination / spinner, `ngwr/pagination`
+needs button / select, `ngwr/date-picker` needs calendar / input, and a service
+mounts a component no template names — `WrDialog.open()` needs `ngwr/dialog`,
+`WrToast.show()` needs `ngwr/toast`. Full table:
+https://ngwr.dev/start/installation
 
 ## Providers (main.ts)
 
@@ -44,7 +69,11 @@ Add from their entry points as needed:
   tracker mobile sheets need to clear the on-screen keyboard. Without it overlays
   still work, falling back to CDK's shared root container — but
   `--wr-keyboard-inset` stays 0 and sheets won't lift above the keyboard. Add
-  `provideWrResponsiveOverlays()` for mobile sheets.
+  `provideWrResponsiveOverlays()` for mobile sheets — both from `ngwr/overlay`,
+  not from the component's own entry point. Optional does not mean free: what it
+  references is CDK's overlay module, the heaviest dependency in the catalog, so
+  it is near-zero in an app with any overlay on screen and the whole of it in an
+  app with none.
 - `provideWrIcons(lucideIcons({ check: Check }))` — icon registry (`ngwr/icon`,
   adapters under `ngwr/icon/adapters/*`).
 - `provideWrTheme()` — `--wr-*` design tokens. `provideWrDensity()` — sizing.
@@ -75,20 +104,48 @@ one element at a time; a step whose target is missing is skipped, not floated.
 - `ng g ngwr:page <form|table|dashboard>` — starter page wired with ngwr.
 - `ng update ngwr` — runs upgrade migrations.
 
-## Upgrading to v12
+## Upgrading to v14
+
+Run `ng update ngwr@14`. It rewrites the renames and REPORTS the rest — read its
+output, because the reported half is where the silent failures are.
+
+Rewritten for you (six renames, one word per concept):
 
-Two breaking changes, and only one is codemoddable.
+- `<wr-alert>` from `closeable` to `closable`.
+- `[wrInput]` from `wrSize` to `size`, like every other control. v13's release
+  note announced this rename and did NOT make it; it lands in v14. On v13 a
+  `size` written on an ngwr input compiled — it is a legal native attribute —
+  and the control quietly fell back to `md`.
+- `<wr-table>` from `[totalItems]` to `[total]`.
+- `<wr-pagination>` from `[(currentPage)]` to `[(page)]`, and from
+  `(currentPageChange)` to `(pageChange)`.
+- `isDisabledWhenLoading` to `disabledWhenLoading` (the library's last
+  `is`-prefixed boolean).
+- The window `chromeSize` scale from `'compact' | 'normal'` to `'sm' | 'md'`,
+  including the `.wr-window--chrome-compact` class.
 
-- **Date entry points nest under `ngwr/date`.** `ngwr/date-adapter` →
-  `ngwr/date`, `ngwr/date-adapter-fns` → `ngwr/date/adapters/fns`,
-  `ngwr/date-adapter-luxon` → `ngwr/date/adapters/luxon`. Import paths only —
-  every symbol keeps its name. `ng update ngwr@12` rewrites them.
-- **`readI18nText()` returns `Signal<string>`.** Add `()` at every read. No
-  codemod: adding the call means knowing which identifiers hold the result, and
-  the type error already names every site. `useI18nText`, the `wrT` pipe and the
-  `[wrT]` directive are unchanged.
+Reported, not rewritten — each needs a decision a codemod cannot make:
 
-Full guide, with diffs: https://ngwr.dev/start/migration
+- **Router integration is opt-in.** `<wr-loading-bar>` no longer follows the
+  router on its own: add `provideWrLoadingBarRouter()` from
+  `ngwr/loading-bar/router`. A `<wr-tab routerLink>` needs `wrTabsRouting` on the
+  strip and `WrTabsRouting` (from `ngwr/tabs/router`) in `imports`. The tab strip
+  throws without it; **the loading bar does not — it just never moves.**
+- **Locale comes from Angular's `LOCALE_ID`.** `WR_DATE_LOCALE` and `WrI18n`'s
+  `defaultLocale` / `availableLocales` used to read `navigator.language` or a
+  literal `'en'`. An app that really wants the browser's tag now writes
+  `provideWrDateAdapter({ locale: navigator.language })`.
+- **A named date format refuses input it cannot read.** `shortDate` / `time` and
+  friends parse through the same `Intl` formatter that printed the string, so
+  they round-trip; unreadable input returns null and leaves the committed value
+  alone instead of guessing. Pass an explicit token `[format]` if you relied on
+  `new Date()`'s leniency.
+- **`<wr-pagination ofLabel>` is gone**, and the `pagination.of` catalog key with
+  it. The range is one `pagination.range` template with `{{from}}` / `{{to}}` /
+  `{{total}}` placeholders — a catalog still carrying the old key reverts that
+  line to English silently.
+
+Earlier steps, with diffs, back to v6: https://ngwr.dev/start/migration
 
 ## Use ngwr — don't hand-roll
 
@@ -138,9 +195,22 @@ before writing your own. Full catalog: https://ngwr.dev/reference/components.
   its own `value` model, and implements neither.
   Bind `[formField]="form.x"`, use the two-way model standalone (`[(value)]`, or
   `[(checked)]` on checkbox/switch), or classic `[(ngModel)]` / reactive forms
-  via Angular's bridge.
+  via Angular's bridge. **That bridge is not an accessor and does not behave like
+  one**, and the differences are silent: `updateOn: 'blur'` / `'submit'` do not
+  apply to an ngwr control while a native `<input>` in the same group still
+  honours them; a `{ emitEvent: false }` write moves the model and leaves the
+  control showing the old value; `<wr-select>` compares object values by `===`
+  with no `compareWith`. What the bridge carries, what it drops, and what a form
+  does about each: https://ngwr.dev/guides/forms
 - **Icons** — register via `provideWrIcons`, render `<wr-icon name="check" />`.
-- **i18n** — `{{ 'key' | wrT }}` (pipe from `ngwr/i18n`).
+- **Router** — nothing injects `@angular/router` unless you opt in. A
+  `<wr-tab routerLink>` needs `wrTabsRouting` on the strip plus `WrTabsRouting`
+  (`ngwr/tabs/router`) in `imports`, and it throws if you forget.
+  `<wr-loading-bar>` follows navigation only with
+  `provideWrLoadingBarRouter()` (`ngwr/loading-bar/router`), and it does NOT
+  throw — without the provider the bar simply never moves.
+- **i18n** — `{{ 'key' | wrT }}` (pipe from `ngwr/i18n`). The locale defaults to
+  Angular's `LOCALE_ID`, not the browser, for both copy and dates.
 - **Theme** — CSS custom properties `--wr-color-*`, `--wr-border-radius-*`, … set
   by `provideWrTheme()`. Two contrast tokens per intent, easy to confuse:
   `--wr-color-<intent>-contrast` is the label ON a filled intent;
@@ -150,6 +220,17 @@ before writing your own. Full catalog: https://ngwr.dev/reference/components.
   tint — which is exactly where outlined / ghost / tinted variants paint it, so use
   `-ink` there. For muted prose use `--wr-color-on-surface-muted`, not the `medium`
   intent.
+- **SSR** — everything renders on the server; the library contains no
+  `ngSkipHydration`, so `provideClientHydration()` and `withEventReplay()` need
+  nothing from it. Two calls are NOT no-ops there and ship an overlay into a
+  cached page: `WrToast.show()` and `WrDialog.open()` (`WrTour.start()` is the
+  one that returns early) — guard them with `afterNextRender` or `WrPlatform`'s
+  `isBrowser`. `WrMedia` has no viewport to measure, so `matches()` is `false`
+  and `current()` is `'xs'` until hydration: reflow with the `responsive`
+  container-query modifiers rather than a template branch. And a server has no
+  `localStorage`, so a dark-mode visitor sees a light page until the bundle
+  boots — `wrThemePrePaintScript()` (`ngwr/theme`) is the blocking `<head>`
+  reader that closes it: https://ngwr.dev/guides/ssr
 - **Mobile** — overlays collapse to sheets (`provideWrResponsiveOverlays()`), a
   `responsive` input reflows layout components, a `touch` density preset enlarges
   controls, and `WrHaptics` (ngwr/platform) fires vibration feedback.
@@ -157,7 +238,9 @@ 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`. 70 entry points so far, 104 harness classes, covering the
+  `ngwr/<name>/testing`. 70 entry points so far, 104 exported harness names over
+  103 distinct classes — `WrCalendarDayHarness` ships under two, since a date
+  picker's popup IS a calendar — 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
@@ -195,23 +278,40 @@ before writing your own. Full catalog: https://ngwr.dev/reference/components.
 
 ## Deciding whether to use it
 
-Three pages exist for the question before installation, and everything on them
+Four pages exist for the question before installation, and everything on them
 is meant to be checkable rather than taken on trust:
 
 - **Why ngwr, and when not to** — the wedge (nineteen value controls are Signal
   Forms controls; no `ControlValueAccessor` in the library), a comparison against
   Material / PrimeNG / NG-ZORRO / Taiga / Spartan, and a per-competitor "choose
   something else if" section: https://ngwr.dev/start/comparison
-- **What gates a change** — eight gates on every PR, three separate
+- **What gates a change** — nine gates on every PR, three separate
   accessibility sweeps and what each one cannot see, the two nightly baselines
   and what is accepted in them, plus what the test suite does NOT cover:
   https://ngwr.dev/start/quality
 - **A live Signal Forms demo** you can read before installing anything:
   https://ngwr.dev/start/playground
+- **What a version number promises** — what a major is allowed to break, and the
+  one semver rule made mechanical: `release:prepare` refuses a minor or patch
+  bump when any commit since the last tag is marked breaking, so `^14.0.0` is a
+  safe range (12.2.0 was a minor carrying a breaking change, which is why the
+  guard exists). Also the support window — current major in full, previous major
+  mechanical security fixes only, ending when the next major ships — and the
+  actual cadence: https://ngwr.dev/start/versioning
 
 The honest shape of the project, since these pages say it too: one maintainer,
-MIT, six majors shipped between 2026-06-12 and 2026-08-20, a codemod for every
-break a codemod can repair, no commercial support.
+MIT, eight majors shipped since 2026-06-12, a codemod for every break a codemod
+can repair and a reported diagnosis for the rest, no commercial support.
+
+Public API is three surfaces and all three move only in a major: the exported
+TypeScript, the `.wr-*` BEM class names (every component ships
+`ViewEncapsulation.None`), and the `--wr-*` custom properties. `@internal` in a
+TSDoc means not API and survives into the published types, so
+`grep -rn "@internal" node_modules/ngwr/types` answers it. A few helpers are
+exported, unmarked and undocumented — `wrAppendOverlayClose`, `wrMirrorOffsets`,
+`wrPresentAsSheet`, `WrOutsideClick`, `useConfigValue`, `useFormFieldAria`,
+`squirclePath`, `wrContrastFor`, `isSafeCssValue` — and carry no stability
+statement; do not build on them.
 
 ## Resources (machine-readable)
 
@@ -252,4 +352,6 @@ break a codemod can repair, no commercial support.
 - 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`, `llms-full.txt` and `skills/ngwr/`)
+  ships `README.md`, `llms.txt`, `llms-full.txt` and `skills/ngwr/` — and no
+  other markdown: there is no `CHANGELOG.md` in the tarball, and the docs'
+  markdown twins are served from ngwr.dev rather than copied into it)

package/mcp/catalog.js

@@ -11,8 +11,8 @@ import { fileURLToPath } from 'node:url';
  * The catalog, read from the files the package already ships.
  *
  * **No second copy of anything, and that is the design constraint this whole
- * server was built under.** `llms-full.txt` (~57 KB, 202 entry points) and
- * `schematics/use/symbol-map.json` (215 symbols) are already in the tarball for
+ * server was built under.** `llms-full.txt` (~57 KB, 204 entry points) and
+ * `schematics/use/symbol-map.json` (216 symbols) are already in the tarball for
  * other reasons, and the `.d.ts` bundle carries every signature. A server that
  * embedded its own index would be a fourth copy to keep in step with the library,
  * and the first one to go stale.
@@ -51,7 +51,7 @@ class Catalog {
     /**
      * Does this entry point ship a stylesheet?
      *
-     * Read from the package's own `exports` map rather than assumed: 94 of the 202
+     * Read from the package's own `exports` map rather than assumed: 96 of the 204
      * entry points ship no `styles/_index.scss` — the testing harnesses, the
      * services, the adapters — and telling a consumer to `@use` one of those breaks
      * their Sass build.

package/mcp/providers.js

@@ -25,6 +25,17 @@ const REQUIRED_PROVIDERS = [
         provider: "provideWrDateFnsAdapter() // from 'ngwr/date/adapters/fns'",
         why: 'every date mode goes through an adapter; there is no built-in default',
     },
+    {
+        // The bar itself needs no provider — `start()` / `complete()` work bare — so
+        // the rule names the ROUTER half, which is exactly the table's criterion: the
+        // component compiles, renders, and sits at 0% forever with nothing naming the
+        // cause. The subscription is opt-in because it is what pulls
+        // `@angular/router` into a bundle, and this project's own site shipped a dead
+        // bar for the length of one release by missing it.
+        test: /^WrLoadingBar/,
+        provider: "provideWrLoadingBarRouter() // from 'ngwr/loading-bar/router'",
+        why: 'without it the bar never responds to navigation; it only moves for manual start() / complete()',
+    },
     {
         // Spelled out rather than `^WrT(Pipe|Directive)$`: `describeTest` in the
         // skill generator only names alternatives that are bare symbols, so a group

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ngwr",
-  "version": "13.0.1",
+  "version": "14.0.1",
   "bin": {
     "ngwr-mcp": "mcp/server.js"
   },
@@ -845,6 +845,10 @@
       "types": "./types/ngwr-line-chart-testing.d.ts",
       "default": "./fesm2022/ngwr-line-chart-testing.mjs"
     },
+    "./loading-bar/router": {
+      "types": "./types/ngwr-loading-bar-router.d.ts",
+      "default": "./fesm2022/ngwr-loading-bar-router.mjs"
+    },
     "./markdown/testing": {
       "types": "./types/ngwr-markdown-testing.d.ts",
       "default": "./fesm2022/ngwr-markdown-testing.mjs"
@@ -965,6 +969,10 @@
       "types": "./types/ngwr-table-testing.d.ts",
       "default": "./fesm2022/ngwr-table-testing.mjs"
     },
+    "./tabs/router": {
+      "types": "./types/ngwr-tabs-router.d.ts",
+      "default": "./fesm2022/ngwr-tabs-router.mjs"
+    },
     "./tabs/testing": {
       "types": "./types/ngwr-tabs-testing.d.ts",
       "default": "./fesm2022/ngwr-tabs-testing.mjs"