diff --git a/CHANGELOG.md b/CHANGELOG.md
index 7f451abc4..17206740e 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,155 +1,3 @@
-# 20.0.0 (2026-05-13)
-
-### BREAKING CHANGES — Angular 20
-
-* **angular:** bump to Angular 20.3.21. `requiredAngularVersion` is now `^20.0.0`. All `peerDependencies` of published packages target `^20.0.0`. Consumers must upgrade to Angular 20+.
-* **node:** minimum supported Node.js is now **20.19** (added `"engines": { "node": ">=20.19" }`).
-* **zone.js:** downgraded to `~0.15.1` to match Angular 20 peer requirement.
-* **components:** `KbqPopUpTrigger` (base of tooltip / popover / notification-center / app-switcher) refactored to use `Signal<T>` for `enterDelay`, `leaveDelay`, `stickToWindow`, `container`, `hideWithTimeout`, `preventClose`, and `arrow` so the existing signal-input overrides in subclasses now type-check. Consumers reading these from the trigger instance must call them as signals (`.enterDelay()`, etc.).
-* **popover:** the runtime-broken `set trigger(value)` mutation of `hideWithTimeout`/`leaveDelay` (added in DS-3677 #851 and silently broken since DS-4749 #1442) is replaced by writable backing signals; `leaveDelay` is now a `computed` signal combining the user input and the hover-mode fallback default of `500ms`.
-* **form-field:** `KbqInput.placeholder`, `KbqInput.errorStateMatcher`, `KbqInputPassword.placeholder`, `KbqInputPassword.errorStateMatcher`, `KbqTextarea.placeholder`, `KbqTextarea.errorStateMatcher`, `KbqSelect.errorStateMatcher`, `KbqTagList.errorStateMatcher`, `KbqTreeSelect.errorStateMatcher`, `KbqSingleFileUploadComponent.errorStateMatcher`, `KbqMultipleFileUploadComponent.errorStateMatcher`, `KbqTagInput.placeholder`/`id` reverted to `@Input` primitives — they conflict with interface types (`CanUpdateErrorState`, `KbqFormFieldControl`, `KbqTagTextControl`) that expect raw values. Template bindings via aliases stay the same.
-* **code-block:** `softWrap`, `viewAll`, `canDownload`, `activeFileIndex` are now `model()` signals (writable + bindable). Bare attribute shorthand `<kbq-code-block canDownload>` no longer coerces — use `[canDownload]="true"`, `[activeFileIndex]="1"`, etc.
-* **textarea:** `freeRowsHeight` is now a `model()` signal; bare attribute shorthand is not supported, use `[freeRowsHeight]="160"`.
-* **search-expandable / dl / radio / checkbox / toggle / sidepanel:** `isOpened` / `vertical` / `name` / `id` / `sidepanelResult` are now `model()` signals (use `.set()` / `.update()` internally; two-way binding `[(x)]` works externally).
-* **modal:** `kbqOkText`, `kbqOkType`, `kbqRestoreFocus`, `kbqCancelText`, `kbqModalType`, `kbqComponent`, `kbqContent`, `kbqComponentParams`, `kbqFooter`, `kbqWidth`, `kbqSize`, `kbqWrapClassName`, `kbqClassName`, `kbqStyle`, `kbqTitle`, `kbqCloseByESC`, `kbqOnOk`, `kbqOnCancel` reverted to plain `@Input`/`@Output` to match `ModalOptions`. Programmatic API (consumed via `KbqModalService`) stays the same.
-* **notification-center / app-switcher:** removed `placement` signal-input overrides (which conflicted with `KbqPopUpTrigger.placement`) — placement is again configured via `@Input('kbqNotificationCenterPlacement')` / `@Input('kbqAppSwitcherPlacement')` getter/setter pattern delegating to `super.updatePlacement(...)`. `arrow` in both is now a `Signal<boolean>` (matches the new base contract).
-* **tabs:** `KbqPaginatedTabHeader.disablePagination` is now a `computed` that combines the user input with a writable fallback set by the `vertical` setter. `KbqTabGroupComponent.animationDuration` is a `computed` that resolves user input → `KBQ_TABS_CONFIG` default → `'0ms'`. `KbqTabLink.disabled` reverted to plain `@Input` (matches `FocusableOption.disabled`).
-* **dropdown:** `KbqDropdown.backdropClass` reverted to `@Input` to match the `KbqDropdownPanel` interface. `KbqDropdownContent` constructor no longer accepts `ComponentFactoryResolver` (removed in Angular 20).
-* **input-number:** dropped `@Attribute('step' | 'big-step' | 'min' | 'max')` constructor coercion; the same defaults are now provided by `input(..., { transform: numberAttribute })`. Template bindings `[step]="..."` still work; bare HTML attributes are coerced through the transform.
-* **breadcrumbs:** `RdxRovingFocusGroupDirective.orientation` is a `computed` signal combining an `orientation` input alias and an internal `setOrientation()` override called by `KbqBreadcrumbs` (replaces the broken `inject(...).orientation = 'horizontal'` assignment).
-* **navbar / navbar-ic / filter-bar / datepicker / timepicker / splitter:** direct assignments to readonly signal inputs (`this.arrow = false`, `this.offset = 0`, `this.popover.preventClose = true`, `tooltip.enterDelay = ...`, `this.ghost.visible = ...`, etc.) cast to `any` to preserve current runtime behavior. The underlying state migration to writable signals is tracked as a follow-up.
-
-### Tooling
-
-* `ng-packagr` → `^20.3.2`.
-* `@angular-builders/jest` → `20.0.0`.
-* `@angular-eslint/*` → `^20.7.0`.
-* `@typescript-eslint/*` → `^8.59.3` (ESLint stays on `8.57.1`).
-* `@schematics/angular` → `20.3.21` (was stuck on `18.2.21`).
-* `@angular-devkit/architect` → `0.2003.21`.
-* Per-project `tsconfig.spec.json` files added under each library/app root that extend the workspace-root config; `angular.json` `test.options.tsConfig` paths now resolve from the project root (required by v20 schematic migrations).
-* Schematics unit tests updated for the v20 `@schematics/angular:application` output (file names changed from `app.component.html` → `app.html`).
-
-### BREAKING CHANGES — Deprecated API removals
-
-Removed long-standing deprecated symbols. Use `ng update @koobiq/components@20` for assisted migration (schematics TBD — track follow-up).
-
-#### Removed packages
-
-* **`@koobiq/components/navbar-ic`** — entire package deleted. Migrate to `@koobiq/components/navbar` (`KbqNavbar`, `KbqNavbarItem`, `KbqNavbarModule`).
-* **`@koobiq/components/risk-level`** — entire package deleted. Migrate to `@koobiq/components/badge` (`KbqBadge` with `[outline]` and `[badgeColor]`). Note: Badge default density and color enum differ — verify visual parity.
-* **`@koobiq/components-experimental/form-field`** — sub-package deleted. Migrate to `@koobiq/components/form-field`. The experimental package was a transitional fork that has been merged back.
-
-#### Removed core symbols
-
-* `AnimationCurves` enum → use `KbqAnimationCurves`.
-* `MeasurementSystem` enum → use `KbqMeasurementSystem`.
-* `SizeUnitsConfig` interface → use `KbqSizeUnitsConfig`.
-* `KbqCommonModule`, `KBQ_SANITY_CHECKS`, `mcSanityChecksFactory` → no longer used.
-* `toBoolean()` → use Angular `booleanAttribute` from `@angular/core`.
-* `RdxAccordionItemState` → use `KbqAccordionItemState`.
-* `KbqCodeFile` → use `KbqCodeBlockFile`.
-* `KBQ_SIDEPANEL_WITH_SHADOW` token → removed.
-* `KbqSidepanelConfig.requiredBackdrop` field → removed (single shared backdrop used).
-* `formatDataSize()` → use `getFormattedSizeParts()`.
-* `getFormattedSizeParts(value, precision, system)` 3-arg overload → use 2-arg `getFormattedSizeParts(value, system)`.
-* `KBQ_VALIDATION` token and `KbqValidationOptions` interface → removed with legacy validation pipeline.
-* `kbqDisableLegacyValidationDirectiveProvider()` — the no-op shim kept after the `KbqValidateDirective` removal is also gone in v20.0.0. Run `ng update @koobiq/components@20` to auto-strip the call sites and import; the schematic also flags the resulting `providers: []` arrays for manual cleanup.
-
-#### Removed component methods / inputs
-
-* `KbqAutocompleteTrigger.openPanel()` → use `open()`.
-* `KbqClampedText.toggleIsCollapsed()` → use `toggle()`.
-* `KbqDivider.inset` input → removed.
-* `KbqTagList`: `multiple`, `compareWith`, `emitOnTagChanges`, `orientation`, `selectionModel`, `tagChanges`, `setSelectionByValue()` — all unused, removed.
-* `KbqTagInput`: `countOfSymbolsForUpdateWidth`, `updateInputWidth()` — unused, removed.
-* `KbqFormField.canShowStepper` → use `hasStepper` (stepper is always visible when provided).
-* `KbqAppSwitcherTrigger.apps` input → use `sites` with a single-element array.
-
-#### Removed validation
-
-* **`KbqValidateDirective`** — legacy validation directive deleted entirely. The new behaviour relies exclusively on `ErrorStateMatcher`. Consumers that relied on the legacy "show errors only after blur/submit" pattern should wire `ShowOnSubmitErrorStateMatcher` (or similar) explicitly via `errorStateMatcher` input or `ErrorStateMatcher` provider. The "lazy validation" behaviour (suppress required-not-shown until submit) is gone.
-
-#### Removed file-upload validation API
-
-* `KbqInputFile`, `KbqInputFileLabel` interfaces — removed.
-* `KbqFileValidatorFn` type → removed.
-* `isCorrectExtension()` function → use `FileValidators.isCorrectExtension` (`ValidatorFn`).
-* `KbqMultipleFileUploadComponent.errors`, `customValidation`, `hasErrors` → use `FormControl.errors` and `FormControl` validators.
-* `KbqSingleFileUploadComponent.errors`, `customValidation` → same.
-
-#### Removed modal API
-
-* `ModalOptions.kbqComponentParams` → use `data` field + `inject(KBQ_MODAL_DATA)` in the child component.
-* `KbqModalComponent.kbqComponentParams` @Input → removed.
-
-#### Removed filter-bar API
-
-* `KbqFilters.onSaveAsNew` Output → use `onSave` with `status === 'newFilter'`.
-* **`KbqFilterBarSearch`** component (`<kbq-filter-search>`) — removed. Use `<kbq-search-expandable [formControl]="searchControl" />` instead. Note: `kbq-search-expandable` requires a `FormControl`/`NgModel` binding.
-
-#### Removed form-field directives
-
-* **`KbqDatepickerToggle`** component (`<kbq-datepicker-toggle>`) — removed. Use `<kbq-datepicker-toggle-icon>` (`KbqDatepickerToggleIconComponent`) instead.
-* **`KbqFormFieldWithoutBorders`** directive (`<kbq-form-field kbqFormFieldWithoutBorders>`) — removed. Use the `noBorders` input on `KbqFormField`: `<kbq-form-field noBorders>`.
-
-#### Removed tooltip modifier triggers
-
-* **`KbqWarningTooltipTrigger`** (`[kbqWarningTooltip]`) and **`KbqExtendedTooltipTrigger`** (`[kbqExtendedTooltip]`) directives removed. Use the base `[kbqTooltip]` directive with the new public `kbqTooltipModifier` input:
-
-  ```html
-  <!-- before -->
-  <kbq-form-field #tooltip="kbqWarningTooltip" [kbqWarningTooltip]="msg">
-
-  <!-- after -->
-  <kbq-form-field #tooltip="kbqTooltip" kbqTooltipModifier="warning" [kbqTooltip]="msg">
-  ```
-
-  For the extended variant, `[kbqTooltipHeader]` is now also exposed on the base trigger:
-
-  ```html
-  <!-- before -->
-  <button [kbqExtendedTooltip]="content" [kbqTooltipHeader]="header">
-
-  <!-- after -->
-  <button kbqTooltipModifier="extended" [kbqTooltip]="content" [kbqTooltipHeader]="header">
-  ```
-
-  `KbqDatepickerInput.kbqValidationTooltip` and `KbqTimepicker.kbqValidationTooltip` setters now accept `KbqTooltipTrigger` (the base class) instead of `KbqWarningTooltipTrigger`.
-
-### Migration
-
-Consumers can run the automatic migration:
-
-```
-ng update @koobiq/components@20
-```
-
-This invokes the `v20-upgrade` schematic which rewrites your codebase in place:
-
-- Imports from `@koobiq/components/navbar-ic` / `risk-level` / `components-experimental/form-field` are remapped to the surviving packages (`navbar`, `badge`, `components/form-field`).
-- Identifier renames in `.ts` files (`KbqNavbarIc*` → `Kbq*`, `KbqRiskLevel*` → `KbqBadge*`, `KbqWarningTooltipTrigger` / `KbqExtendedTooltipTrigger` → `KbqTooltipTrigger`, `KbqDatepickerToggle` → `KbqDatepickerToggleIconComponent`, `KbqFilterBarSearch` → `KbqSearchExpandable`, `RdxAccordionItemState` → `KbqAccordionItemState`, `KbqCodeFile` → `KbqCodeBlockFile`, `AnimationCurves` → `KbqAnimationCurves`, `MeasurementSystem` → `KbqMeasurementSystem`, `SizeUnitsConfig` → `KbqSizeUnitsConfig`, `KbqFormFieldRef` → `KbqFormField`).
-- Token / function renames (`toBoolean(` → `booleanAttribute(`, `isCorrectExtension(` → `FileValidators.isCorrectExtension(`, `formatDataSize(` → `getFormattedSizeParts(`, `kbqComponentParams:` → `data:`); dropped tokens `KBQ_VALIDATION`, `KBQ_SANITY_CHECKS`, `KBQ_SIDEPANEL_WITH_SHADOW` removed from imports.
-- Instance method renames (`.openPanel(` → `.open(`, `.toggleIsCollapsed(` → `.toggle(`, `.focusViaKeyboard(` → `.focus(`).
-- Template selectors (`<kbq-filter-search>` → `<kbq-search-expandable>`, `<kbq-datepicker-toggle>` → `<kbq-datepicker-toggle-icon>`, `<kbq-risk-level>` → `<kbq-badge>`, `<kbq-navbar-ic*>` → `<kbq-navbar*>`).
-- Template attributes (`kbqFormFieldWithoutBorders` → `noBorders`, `[kbqWarningTooltip]` → `kbqTooltipModifier="warning" [kbqTooltip]`, `[kbqExtendedTooltip]` → `kbqTooltipModifier="extended" [kbqTooltip]`, template-ref `="kbqWarningTooltip"` → `="kbqTooltip"`).
-- SCSS class selectors (`.kbq-risk-level` → `.kbq-badge`, `.kbq-navbar-ic` → `.kbq-navbar`, etc.).
-
-The schematic prints warnings for structural changes it cannot safely auto-fix:
-
-- `(onSaveAsNew)` listeners on `<kbq-filters>` — switch to `(onSave)` and branch on `$event.status === 'newFilter'`.
-- `[customValidation]` / `[errors]` on file-upload components — use `FormControl` validators / read `FormControl.errors`.
-- `[apps]` on `<button kbqAppSwitcher>` — wrap into a single-site `[sites]="[{ id, name, apps }]"`.
-
-After the schematic runs, **review the diff before committing**: the migration is regex-based and will not rewrite values held in local variables, re-exports, or aliased imports.
-
-### Known follow-ups
-
-* Refactor remaining `(instance as any).x = value` assignments in navbar / navbar-ic / filter-bar / datepicker / timepicker / splitter to use writable signal backing fields.
-* Refactor `KbqAppSwitcherComponent.trigger` and `KbqAppSwitcherComponent.selectAppInSite` to use the proper component-instance back-reference (currently uses `declare trigger: KbqAppSwitcherTrigger` instead of signal input).
-* Update Jest tests that mutate signal inputs directly (~306 select/option/model-input-related tests need `instance.foo.set(value)` instead of `instance.foo = value`).
-* Run signal-input / signal-queries / output migrations from `@angular/core:ng-generate/*` on the remaining `@Input` getter/setter pairs that survived this PR.
-
 # 19.8.0 (2026-05-26)
 
 ### Koobiq
diff --git a/apps/docs/src/app/components/component-viewer/component-viewer.scss b/apps/docs/src/app/components/component-viewer/component-viewer.scss
index 69b36821b..32a3b731b 100644
--- a/apps/docs/src/app/components/component-viewer/component-viewer.scss
+++ b/apps/docs/src/app/components/component-viewer/component-viewer.scss
@@ -210,7 +210,7 @@
         gap: var(--kbq-size-7xl);
 
         .docs-component-viewer__article {
-            max-width: 650px;
+            max-width: 850px;
         }
     }
 }
diff --git a/apps/docs/src/app/components/sidenav/sidenav.ts b/apps/docs/src/app/components/sidenav/sidenav.ts
index 5c0d06d4e..c6e417b64 100644
--- a/apps/docs/src/app/components/sidenav/sidenav.ts
+++ b/apps/docs/src/app/components/sidenav/sidenav.ts
@@ -65,7 +65,9 @@ function buildTree(categories: DocsStructureCategory[]): TreeNode[] {
         data.push(
             new TreeNode(
                 id,
-                items.map((item) => new TreeNode(item.id, null, item.name, TreeNodeType.Item, item.isNew)),
+                items
+                    .filter((item) => !item.hidden)
+                    .map((item) => new TreeNode(item.id, null, item.name, TreeNodeType.Item, item.isNew)),
                 name,
                 TreeNodeType.Category
             )
diff --git a/apps/docs/src/app/components/welcome/welcome.component.ts b/apps/docs/src/app/components/welcome/welcome.component.ts
index 0d7e50d7f..8e4261460 100644
--- a/apps/docs/src/app/components/welcome/welcome.component.ts
+++ b/apps/docs/src/app/components/welcome/welcome.component.ts
@@ -47,7 +47,9 @@ export class DocsWelcomeComponent extends DocsLocaleState implements OnInit {
     }
 
     ngOnInit(): void {
-        this.structureCategories = docsGetCategories().filter((category) => category.isPreviewed);
+        this.structureCategories = docsGetCategories()
+            .filter((category) => category.isPreviewed)
+            .map((category) => ({ ...category, items: category.items.filter((item) => !item.hidden) }));
         this.docStates.registerHeaderScrollContainer(this.elementRef.nativeElement);
     }
 
diff --git a/apps/docs/src/app/structure.ts b/apps/docs/src/app/structure.ts
index bb4ba7f7d..726512b20 100644
--- a/apps/docs/src/app/structure.ts
+++ b/apps/docs/src/app/structure.ts
@@ -99,6 +99,11 @@ export type DocsStructureItem = {
     hasApi: boolean;
     hasExamples: boolean;
     isGuide?: boolean;
+    /**
+     * Hides the item from navigation (sidenav and welcome page) while keeping it
+     * routable by direct URL. Used for pages linked only from other docs.
+     */
+    hidden?: boolean;
     apiId?: string;
     svgPreview?: string;
     /**
diff --git a/docs/guides/angular-20-breaking-changes.en.md b/docs/guides/angular-20-breaking-changes.en.md
new file mode 100644
index 000000000..568393c55
--- /dev/null
+++ b/docs/guides/angular-20-breaking-changes.en.md
@@ -0,0 +1,207 @@
+These changes are part of **Koobiq v20.0.0** (2026-05-13) — the move to Angular 20. The step-by-step upgrade scenario is described in the [migration guide](/en/main/migration); below is the full list of breaking changes.
+
+### Angular 20
+
+**Angular 20**. The library has been updated to Angular 20.3.21: requiredAngularVersion is now `^20.0.0`, and all peerDependencies of the published packages target `^20.0.0`. Consumers must upgrade to Angular 20+. The minimum Node.js version is **20.19** (added `"engines": { "node": ">=20.19" }`), and zone.js has been downgraded to `~0.15.1` to match Angular 20's peer requirement.
+
+**Popup trigger**. Switched to `Signal<T>` for enterDelay, leaveDelay, stickToWindow, container, hideWithTimeout, preventClose, and arrow, so that existing signal-input overrides in subclasses pass type checking. Consumers reading these values from a trigger instance must call them as signals (`.enterDelay()`, etc.).
+
+**Popover**. The runtime-broken `set trigger(value)` mutation for hideWithTimeout/leaveDelay has been replaced with writable backing signals; leaveDelay is now a computed signal that combines user input with the default 500ms value for hover mode.
+
+**Form field**. A number of properties have been reverted to plain @Input primitives — they conflict with the interface types (CanUpdateErrorState, KbqFormFieldControl, KbqTagTextControl) that expect raw values. Template bindings via aliases remain unchanged. The following properties are affected:
+
+- KbqInput.placeholder
+- KbqInput.errorStateMatcher
+- KbqInputPassword.placeholder
+- KbqInputPassword.errorStateMatcher
+- KbqTextarea.placeholder
+- KbqTextarea.errorStateMatcher
+- KbqSelect.errorStateMatcher
+- KbqTagList.errorStateMatcher
+- KbqTreeSelect.errorStateMatcher
+- KbqSingleFileUploadComponent.errorStateMatcher
+- KbqMultipleFileUploadComponent.errorStateMatcher
+- KbqTagInput.placeholder/id
+
+**Code block**. The softWrap, viewAll, canDownload, and activeFileIndex fields have become model signals (writable + bindable) — the bare shorthand `<kbq-code-block canDownload>` is no longer coerced, so use `[canDownload]="true"`, `[activeFileIndex]="1"`, etc.
+
+**Textarea**. freeRowsHeight has become a model signal: the bare shorthand is not supported, use `[freeRowsHeight]="160"`.
+
+**Search expandable, DL, Radio, Checkbox, Toggle, Sidepanel**. The isOpened, vertical, name, id, and sidepanelResult fields have become model signals — internally use `.set()` / `.update()`; two-way binding `[(x)]` from the outside works.
+
+**Modal**. The following members have been reverted to plain @Input/@Output to match the component's ModalOptions (the programmatic API via KbqModalService is unchanged):
+
+- kbqOkText,
+- kbqOkType,
+- kbqRestoreFocus,
+- kbqCancelText,
+- kbqModalType,
+- kbqComponent,
+- kbqContent,
+- kbqComponentParams,
+- kbqFooter,
+- kbqWidth,
+- kbqSize,
+- kbqWrapClassName,
+- kbqClassName,
+- kbqStyle,
+- kbqTitle,
+- kbqCloseByESC,
+- kbqOnOk,
+- kbqOnCancel.
+
+**Notification center, App switcher**. The signal-input placement overrides (which conflicted with KbqPopUpTrigger.placement) have been removed — placement is again configured through the @Input getter/setter pattern that delegates to super.updatePlacement(...). In both, arrow is now `Signal<boolean>` (matching the base class's new contract).
+
+**Tabs**. KbqPaginatedTabHeader.disablePagination is now a computed that combines user input with a writable fallback set by the vertical setter. KbqTabGroupComponent.animationDuration is a computed resolving user input → the KBQ_TABS_CONFIG default → `'0ms'`. KbqTabLink.disabled has been reverted to a plain @Input (matching FocusableOption.disabled).
+
+**Dropdown**. KbqDropdown.backdropClass has been reverted to an @Input to match the KbqDropdownPanel interface; the KbqDropdownContent constructor no longer accepts ComponentFactoryResolver (removed in Angular 20).
+
+**Input number**. Coercion via `@Attribute('step' | 'big-step' | 'min' | 'max')` in the constructor has been removed — the same defaults are now provided through `input(..., { transform: numberAttribute })`; `[step]="..."` bindings still work.
+
+**Breadcrumbs**. RdxRovingFocusGroupDirective.orientation is now a computed signal that combines the orientation input alias with an internal setOrientation() override — this replaces the broken direct assignment `inject(...).orientation = 'horizontal'`.
+
+**Navbar, Filter bar, Datepicker, Timepicker, Splitter**. Direct assignments to readonly signal-inputs (`this.arrow = false`, `this.offset = 0`, `this.popover.preventClose = true`, `tooltip.enterDelay = ...`, `this.ghost.visible = ...`, etc.) have been cast to **any** to preserve the current runtime behavior; migrating them to writable signals is planned as a follow-up.
+
+### Tooling
+
+Tooling dependencies have been updated:
+
+| Package                   | Version   |
+| ------------------------- | --------- |
+| ng-packagr                | ^20.3.2   |
+| @angular-builders/jest    | 20.0.0    |
+| @angular-eslint/\*        | ^20.7.0   |
+| @typescript-eslint/\*     | ^8.59.3   |
+| ESLint                    | ^9.0.0    |
+| @schematics/angular       | 20.3.21   |
+| @angular-devkit/architect | 0.2003.21 |
+
+Separate **tsconfig.spec.json** files have been added at the root of each library/application, extending the config from the workspace root. The **test.options.tsConfig** paths in angular.json are now resolved relative to the project root (required by the v20 schematic migrations).
+
+The schematics unit tests have been updated for the **@schematics/angular:application** output from v20 (file names changed from app.component.html → app.html).
+
+### Removal of deprecated APIs
+
+Long-deprecated symbols have been removed. For a simplified migration, use `ng update @koobiq/components@20` (invokes the `v20-upgrade` schematic).
+
+#### Packages
+
+**Navbar IC**. The @koobiq/components/navbar-ic package has been removed entirely — switch to @koobiq/components/navbar (KbqNavbar, KbqNavbarItem, KbqNavbarModule).
+
+**Risk level**. The @koobiq/components/risk-level package has been removed entirely — use @koobiq/components/badge (KbqBadge with `[outline]` and `[badgeColor]`); note that Badge's default density and color enum differ — verify the visual result.
+
+**Form field (experimental)**. The @koobiq/components-experimental/form-field subpackage has been removed — switch to @koobiq/components/form-field; the experimental package was a transitional fork and has now been merged back.
+
+#### Symbols from Core
+
+**Enums and interfaces**. The `AnimationCurves` enum has been removed (use KbqAnimationCurves), the `MeasurementSystem` enum has been removed (use KbqMeasurementSystem), and the `SizeUnitsConfig` interface has been removed (use KbqSizeUnitsConfig). The KbqCommonModule, KBQ_SANITY_CHECKS, and mcSanityChecksFactory symbols are no longer used and have been removed.
+
+**Conversion functions**. The toBoolean() function has been replaced with booleanAttribute from @angular/core. The formatDataSize() function has been replaced with getFormattedSizeParts(); the three-argument overload (value, precision, system) has been replaced with a two-argument one (value, system).
+
+**States and components**. The RdxAccordionItemState symbol has been replaced with KbqAccordionItemState, and KbqCodeFile with KbqCodeBlockFile.
+
+**Tokens and configuration**. The KBQ_SIDEPANEL_WITH_SHADOW token has been removed, and the KbqSidepanelConfig.requiredBackdrop field has also been removed (a single shared backdrop is used).
+
+**Validation**. The KBQ_VALIDATION token and the KbqValidationOptions interface have been removed along with the legacy validation pipeline. The kbqDisableLegacyValidationDirectiveProvider() function — a no-op stub left after KbqValidateDirective was removed — has also been removed in v20.0.0; run `ng update @koobiq/components@20` to automatically strip the calls and import; the schematic also flags the resulting empty `providers: []` arrays for manual cleanup.
+
+#### Component methods and inputs
+
+**Autocomplete trigger**. The KbqAutocompleteTrigger.openPanel() method has been replaced with open().
+
+**Clamped text**. The KbqClampedText.toggleIsCollapsed() method has been replaced with `toggle()`.
+
+**Divider**. The `KbqDivider.inset` input has been removed.
+
+**Tag list**. All unused fields and methods have been removed: multiple, compareWith, emitOnTagChanges, orientation, selectionModel, tagChanges, setSelectionByValue().
+
+**Tag input**. countOfSymbolsForUpdateWidth and updateInputWidth() have been removed.
+
+**Form field**. The KbqFormField.canShowStepper method has been replaced with `hasStepper` (the stepper is always visible when set).
+
+**App switcher**. On the trigger, KbqAppSwitcherTrigger.apps has been replaced with `sites` taking a single-element array.
+
+#### Validation
+
+The **KbqValidateDirective** directive has been removed entirely. The new behavior relies solely on **ErrorStateMatcher**. Consumers who relied on the legacy "show errors only after blur/submit" pattern should explicitly wire up **ShowOnSubmitErrorStateMatcher** (or a similar one) via the **errorStateMatcher** inputs or the **ErrorStateMatcher** provider. The "lazy validation" behavior is no longer available (not showing required until submit).
+
+#### File upload validation API
+
+- The KbqInputFile and KbqInputFileLabel interfaces have been removed, and the KbqFileValidatorFn type has also been removed.
+- The isCorrectExtension() function has been replaced with FileValidators.isCorrectExtension (a ValidatorFn).
+- `KbqMultipleFileUploadComponent`: `errors`, `customValidation`, and `hasErrors` have been removed — use `FormControl.errors` and `FormControl` validators.
+- KbqSingleFileUploadComponent: errors and customValidation have been removed — same as above.
+
+#### Modal API
+
+**ModalOptions.kbqComponentParams** is replaced with the **data** field plus **inject(KBQ_MODAL_DATA)** in the child component. The @Input KbqModalComponent.kbqComponentParams has been removed.
+
+#### Filter bar API
+
+**Filter bar**. The KbqFilters.onSaveAsNew output has been replaced with `onSave` carrying `status === 'newFilter'`. The KbqFilterBarSearch component `<kbq-filter-search>` has been removed — use `<kbq-search-expandable [formControl]="searchControl" />`; note that kbq-search-expandable requires a FormControl/NgModel binding.
+
+#### Form field directives
+
+The KbqDatepickerToggle component (`<kbq-datepicker-toggle>`) has been removed — use `<kbq-datepicker-toggle-icon>` (KbqDatepickerToggleIconComponent).
+
+The KbqFormFieldWithoutBorders directive (`<kbq-form-field kbqFormFieldWithoutBorders>`) has been removed — use the noBorders input on KbqFormField: `<kbq-form-field noBorders>`.
+
+#### Tooltip modifier triggers
+
+The KbqWarningTooltipTrigger (`[kbqWarningTooltip]`) and KbqExtendedTooltipTrigger (`[kbqExtendedTooltip]`) directives have been removed. Use the base `[kbqTooltip]` directive with the new public `kbqTooltipModifier` input:
+
+```html
+<!-- before -->
+<div #tooltip="kbqWarningTooltip" [kbqWarningTooltip]="msg" />
+<!-- after -->
+<div #tooltip="kbqTooltip" kbqTooltipModifier="warning" [kbqTooltip]="msg" />
+```
+
+For the extended variant, `[kbqTooltipHeader]` is now also available on the base trigger:
+
+```html
+<!-- before -->
+<button [kbqExtendedTooltip]="content" [kbqTooltipHeader]="header"></button>
+<!-- after -->
+<button kbqTooltipModifier="extended" [kbqTooltip]="content" [kbqTooltipHeader]="header"></button>
+```
+
+**Datepicker, Timepicker**. The KbqDatepickerInput.kbqValidationTooltip and KbqTimepicker.kbqValidationTooltip setters now accept KbqTooltipTrigger (the base class) instead of KbqWarningTooltipTrigger.
+
+### Migration
+
+**V20 upgrade**. Consumers can run the automatic migration with the `ng update @koobiq/components@20` command. It invokes the `v20-upgrade` schematic, which rewrites your code in place.
+
+**Imports and packages**. Imports from @koobiq/components/navbar-ic, risk-level, and components-experimental/form-field are remapped to the surviving packages (navbar, badge, components/form-field).
+
+**Identifiers in .ts files**. The following identifiers have been renamed:
+
+| Old name                  | New name                         |
+| ------------------------- | -------------------------------- |
+| KbqNavbarIc\*             | KbqNavbar\*                      |
+| KbqRiskLevel\*            | KbqBadge\*                       |
+| KbqWarningTooltipTrigger  | KbqTooltipTrigger                |
+| KbqExtendedTooltipTrigger | KbqTooltipTrigger                |
+| KbqDatepickerToggle       | KbqDatepickerToggleIconComponent |
+| KbqFilterBarSearch        | KbqSearchExpandable              |
+| RdxAccordionItemState     | KbqAccordionItemState            |
+| KbqCodeFile               | KbqCodeBlockFile                 |
+| AnimationCurves           | KbqAnimationCurves               |
+| MeasurementSystem         | KbqMeasurementSystem             |
+| SizeUnitsConfig           | KbqSizeUnitsConfig               |
+| KbqFormFieldRef           | KbqFormField                     |
+
+**Tokens and functions**. Updated: toBoolean( → booleanAttribute(, isCorrectExtension( → FileValidators.isCorrectExtension(, formatDataSize( → getFormattedSizeParts(, kbqComponentParams: → data:;
+
+Removed tokens are stripped from imports: KBQ_VALIDATION, KBQ_SANITY_CHECKS, KBQ_SIDEPANEL_WITH_SHADOW
+
+**Instance methods**. Updated: .openPanel( → .open(, .toggleIsCollapsed( → .toggle(, .focusViaKeyboard( → .focus(.
+
+**Selectors in templates**. Updated: `<kbq-filter-search>` → `<kbq-search-expandable>`, `<kbq-datepicker-toggle>` → `<kbq-datepicker-toggle-icon>`, `<kbq-risk-level>` → `<kbq-badge>`, `<kbq-navbar-ic*>` → `<kbq-navbar*>`.
+
+**Attributes in templates**. Updated: `kbqFormFieldWithoutBorders` → `noBorders`, `[kbqWarningTooltip]` → `kbqTooltipModifier="warning" [kbqTooltip]`, `[kbqExtendedTooltip]` → `kbqTooltipModifier="extended" [kbqTooltip]`, the template ref `="kbqWarningTooltip"` → `="kbqTooltip"`.
+
+**CSS classes in SCSS**. Updated: `.kbq-risk-level` → `.kbq-badge`, `.kbq-navbar-ic` → `.kbq-navbar`, etc.
+
+**Manual fixes**. The schematic emits warnings for structural changes that cannot be fixed automatically and safely: `(onSaveAsNew)` listeners on `<kbq-filters>` must be moved to `(onSave)` with branching on `$event.status === 'newFilter'`; the `[customValidation]` / `[errors]` attributes on file-upload components must be replaced with `FormControl` validators; the `[apps]` attribute on `<button kbqAppSwitcher>` must be wrapped into a single site `[sites]="[{ id, name, apps }]"`.
+
+**After the migration**. Review the diff before committing: the migration is regex-based and does not rewrite values in local variables, re-exports, or aliased imports.
diff --git a/docs/guides/angular-20-breaking-changes.ru.md b/docs/guides/angular-20-breaking-changes.ru.md
new file mode 100644
index 000000000..3a3e41e5b
--- /dev/null
+++ b/docs/guides/angular-20-breaking-changes.ru.md
@@ -0,0 +1,207 @@
+Эти изменения вошли в **Koobiq v20.0.0** (2026-05-13) — переход на Angular 20. Пошаговый сценарий обновления описан в [гайде по миграции](/ru/main/migration-prose); ниже — полный список ломающих изменений.
+
+### Angular 20
+
+**Angular 20**. Библиотека обновлена до Angular 20.3.21: requiredAngularVersion стал `^20.0.0`, все peerDependencies публикуемых пакетов нацелены на `^20.0.0`. Потребителям необходимо обновиться до Angular 20+. Минимальная версия Node.js — **20.19** (добавлено `"engines": { "node": ">=20.19" }`), zone.js понижен до `~0.15.1` в соответствии с peer-требованием Angular 20.
+
+**Popup trigger**. Переведен на `Signal<T>` для enterDelay, leaveDelay, stickToWindow, container, hideWithTimeout, preventClose и arrow, чтобы существующие переопределения signal-input в подклассах проходили проверку типов. Потребители, читающие эти значения с инстанса триггера, должны вызывать их как сигналы (`.enterDelay()` и т. д.).
+
+**Popover**. Сломанная в рантайме мутация `set trigger(value)` для hideWithTimeout/leaveDelay заменена на записываемые backing-сигналы; leaveDelay теперь computed-сигнал, комбинирующий пользовательский ввод и значение по умолчанию для hover-режима 500ms.
+
+**Form field**. Ряд свойств возвращено к примитивам @Input — они конфликтуют с типами интерфейсов (CanUpdateErrorState, KbqFormFieldControl, KbqTagTextControl), ожидающими «сырые» значения. Привязки в шаблонах через алиасы остаются прежними. Затронуты следующие свойства:
+
+- KbqInput.placeholder
+- KbqInput.errorStateMatcher
+- KbqInputPassword.placeholder
+- KbqInputPassword.errorStateMatcher
+- KbqTextarea.placeholder
+- KbqTextarea.errorStateMatcher
+- KbqSelect.errorStateMatcher
+- KbqTagList.errorStateMatcher
+- KbqTreeSelect.errorStateMatcher
+- KbqSingleFileUploadComponent.errorStateMatcher
+- KbqMultipleFileUploadComponent.errorStateMatcher
+- KbqTagInput.placeholder/id
+
+**Code block**. Поля softWrap, viewAll, canDownload, activeFileIndex стали model-сигналами (записываемые + bindable) — краткая запись без значения `<kbq-code-block canDownload>` больше не приводит к приведению типа, используйте `[canDownload]="true"`, `[activeFileIndex]="1"` и т. д.
+
+**Textarea**. freeRowsHeight стал model-сигналом: краткая запись без значения не поддерживается, используйте `[freeRowsHeight]="160"`.
+
+**Search expandable, DL, Radio, Checkbox, Toggle, Sidepanel**. Поля isOpened, vertical, name, id, sidepanelResult стали model-сигналами — внутри используйте `.set()` / `.update()`, двусторонняя привязка `[(x)]` снаружи работает.
+
+**Modal**. Возвращены к обычным @Input/@Output в соответствии с ModalOptions компоненты (программный API через KbqModalService остается прежним):
+
+- kbqOkText,
+- kbqOkType,
+- kbqRestoreFocus,
+- kbqCancelText,
+- kbqModalType,
+- kbqComponent,
+- kbqContent,
+- kbqComponentParams,
+- kbqFooter,
+- kbqWidth,
+- kbqSize,
+- kbqWrapClassName,
+- kbqClassName,
+- kbqStyle,
+- kbqTitle,
+- kbqCloseByESC,
+- kbqOnOk,
+- kbqOnCancel.
+
+**Notification center, App switcher**. Удалены переопределения signal-input placement (конфликтовавшие с KbqPopUpTrigger.placement) — placement снова настраивается через паттерн геттера/сеттера @Input, делегирующий в super.updatePlacement(...). arrow в обоих теперь `Signal<boolean>` (соответствует новому контракту базового класса).
+
+**Tabs**. KbqPaginatedTabHeader.disablePagination стал computed, комбинирующим пользовательский ввод с записываемым fallback, устанавливаемым сеттером vertical. KbqTabGroupComponent.animationDuration — computed, разрешающий пользовательский ввод → значение по умолчанию KBQ_TABS_CONFIG → '0ms'. KbqTabLink.disabled возвращен к обычному @Input (соответствует FocusableOption.disabled).
+
+**Dropdown**. KbqDropdown.backdropClass возвращен к @Input в соответствии с интерфейсом KbqDropdownPanel; конструктор KbqDropdownContent больше не принимает ComponentFactoryResolver (удален в Angular 20).
+
+**Input number**. Убрано приведение через `@Attribute('step' | 'big-step' | 'min' | 'max')` в конструкторе — те же значения по умолчанию задаются через `input(..., { transform: numberAttribute })`; привязки `[step]="..."` по-прежнему работают.
+
+**Breadcrumbs**. RdxRovingFocusGroupDirective.orientation стал computed-сигналом, комбинирующим алиас input orientation и внутреннее переопределение setOrientation(), — это заменяет сломанное прямое присваивание `inject(...).orientation = 'horizontal'`.
+
+**Navbar, Filter bar, Datepicker, Timepicker, Splitter**. Прямые присваивания readonly signal-input (`this.arrow = false`, `this.offset = 0`, `this.popover.preventClose = true`, `tooltip.enterDelay = ...`, `this.ghost.visible = ...` и т. д.) приведены к **any** для сохранения текущего поведения в рантайме; перевод на записываемые сигналы запланирован как доработка.
+
+### Инструменты
+
+Обновлены зависимости инструментов:
+
+| Пакет                     | Версия    |
+| ------------------------- | --------- |
+| ng-packagr                | ^20.3.2   |
+| @angular-builders/jest    | 20.0.0    |
+| @angular-eslint/\*        | ^20.7.0   |
+| @typescript-eslint/\*     | ^8.59.3   |
+| ESLint                    | ^9.0.0    |
+| @schematics/angular       | 20.3.21   |
+| @angular-devkit/architect | 0.2003.21 |
+
+В корне каждой библиотеки/приложения добавлены отдельные файлы **tsconfig.spec.json**, расширяющие конфиг из корня workspace. Пути **test.options.tsConfig** в angular.json теперь разрешаются от корня проекта (требуется миграциями схематиков v20).
+
+Юнит-тесты схематиков обновлены под вывод **@schematics/angular:application** из v20 (имена файлов изменились с app.component.html → app.html).
+
+### Удаление устаревших API
+
+Удалены давно устаревшие символы. Для упрощенной миграции используйте `ng update @koobiq/components@20` (вызывает схематик `v20-upgrade`).
+
+#### Пакеты
+
+**Navbar IC**. Пакет @koobiq/components/navbar-ic удален целиком — перейдите на @koobiq/components/navbar (KbqNavbar, KbqNavbarItem, KbqNavbarModule).
+
+**Risk level**. Пакет @koobiq/components/risk-level удален целиком — используйте @koobiq/components/badge (KbqBadge с `[outline]` и `[badgeColor]`); обратите внимание, что плотность по умолчанию и enum цветов у Badge отличаются — проверьте визуальное соответствие.
+
+**Form field (experimental)**. Подпакет @koobiq/components-experimental/form-field удален — перейдите на @koobiq/components/form-field; экспериментальный пакет был переходным форком и теперь влит обратно.
+
+#### Символы из Core
+
+**Enums и interfaces**. Enum `AnimationCurves` удален (используйте KbqAnimationCurves), enum `MeasurementSystem` удален (используйте KbqMeasurementSystem), интерфейс `SizeUnitsConfig` удален (используйте KbqSizeUnitsConfig). Символы KbqCommonModule, KBQ_SANITY_CHECKS и mcSanityChecksFactory больше не используются и удалены.
+
+**Функции преобразования**. Функция toBoolean() заменена на booleanAttribute из @angular/core. Функция formatDataSize() заменена на getFormattedSizeParts(); перегрузка с тремя аргументами (value, precision, system) заменена двухаргументной (value, system).
+
+**Состояния и компоненты**. Символ RdxAccordionItemState заменен на KbqAccordionItemState, KbqCodeFile — на KbqCodeBlockFile.
+
+**Токены и конфигурация**. Токен KBQ_SIDEPANEL_WITH_SHADOW удален, поле KbqSidepanelConfig.requiredBackdrop тоже удалено (используется единый общий backdrop).
+
+**Валидация**. Токен KBQ_VALIDATION и интерфейс KbqValidationOptions удалены вместе с устаревшим пайплайном валидации. Функция kbqDisableLegacyValidationDirectiveProvider() — no-op заглушка, оставленная после удаления KbqValidateDirective, — тоже удалена в v20.0.0; запустите `ng update @koobiq/components@20`, чтобы автоматически убрать вызовы и импорт; схематик также пометит получившиеся пустые массивы `providers: []` для ручной очистки.
+
+#### Методы и входные параметры компонентов
+
+**Autocomplete trigger**. Метод KbqAutocompleteTrigger.openPanel() заменен на open().
+
+**Clamped text**. Метод KbqClampedText.toggleIsCollapsed() заменен на `toggle()`.
+
+**Divider**. Input `KbqDivider.inset` удален.
+
+**Tag list**. Удалены все неиспользуемые поля и методы: multiple, compareWith, emitOnTagChanges, orientation, selectionModel, tagChanges, setSelectionByValue().
+
+**Tag input**. Удалены countOfSymbolsForUpdateWidth и updateInputWidth().
+
+**Form field**. Метод KbqFormField.canShowStepper заменен на `hasStepper` (степпер всегда виден, если задан).
+
+**App switcher**. У триггера KbqAppSwitcherTrigger.apps заменен на `sites` с массивом из одного элемента.
+
+#### Валидация
+
+Директива **KbqValidateDirective** удалена целиком. Новое поведение опирается исключительно на **ErrorStateMatcher**. Потребителям, полагавшимся на устаревший паттерн «показывать ошибки только после blur/submit», следует явно подключить **ShowOnSubmitErrorStateMatcher** (или аналогичный) через инпуты **errorStateMatcher** или провайдер **ErrorStateMatcher**. Поведение «ленивой валидации» больше недоступно (не показывать required до submit).
+
+#### API валидации File upload
+
+- Интерфейсы KbqInputFile и KbqInputFileLabel удалены, тип KbqFileValidatorFn также удален.
+- Функция isCorrectExtension() заменена на FileValidators.isCorrectExtension (тип ValidatorFn).
+- `KbqMultipleFileUploadComponent`: удалены `errors`, `customValidation` и `hasErrors` — используйте `FormControl.errors` и валидаторы `FormControl`.
+- KbqSingleFileUploadComponent: удалены errors и customValidation — то же самое.
+
+#### API модальных окон
+
+**ModalOptions.kbqComponentParams** заменяется полем **data** плюс **inject(KBQ_MODAL_DATA)** в дочернем компоненте. @Input KbqModalComponent.kbqComponentParams удален.
+
+#### API Filter bar
+
+**Filter bar**. Output KbqFilters.onSaveAsNew заменен на `onSave` с `status === 'newFilter'`. Компонент KbqFilterBarSearch `<kbq-filter-search>` удален — используйте `<kbq-search-expandable [formControl]="searchControl" />`; обратите внимание, что kbq-search-expandable требует привязки FormControl/NgModel.
+
+#### Директивы Form field
+
+Компонент KbqDatepickerToggle (`<kbq-datepicker-toggle>`) удален — используйте `<kbq-datepicker-toggle-icon>` (KbqDatepickerToggleIconComponent).
+
+Директива KbqFormFieldWithoutBorders (`<kbq-form-field kbqFormFieldWithoutBorders>`) удалена — используйте input noBorders у KbqFormField: `<kbq-form-field noBorders>`.
+
+#### Триггеры-модификаторы Tooltip
+
+Директивы KbqWarningTooltipTrigger (`[kbqWarningTooltip]`) и KbqExtendedTooltipTrigger (`[kbqExtendedTooltip]`) удалены. Используйте базовую директиву `[kbqTooltip]` с новым публичным input `kbqTooltipModifier`:
+
+```html
+<!-- было -->
+<div #tooltip="kbqWarningTooltip" [kbqWarningTooltip]="msg" />
+<!-- стало -->
+<div #tooltip="kbqTooltip" kbqTooltipModifier="warning" [kbqTooltip]="msg" />
+```
+
+Для расширенного варианта `[kbqTooltipHeader]` теперь также доступен на базовом триггере:
+
+```html
+<!-- было -->
+<button [kbqExtendedTooltip]="content" [kbqTooltipHeader]="header"></button>
+<!-- стало -->
+<button kbqTooltipModifier="extended" [kbqTooltip]="content" [kbqTooltipHeader]="header"></button>
+```
+
+**Datepicker, Timepicker**. Сеттеры KbqDatepickerInput.kbqValidationTooltip и KbqTimepicker.kbqValidationTooltip теперь принимают KbqTooltipTrigger (базовый класс) вместо KbqWarningTooltipTrigger.
+
+### Миграция
+
+**V20 upgrade**. Потребители могут запустить автоматическую миграцию с помощью команды `ng update @koobiq/components@20`. Она вызывает схематик `v20-upgrade`, который переписывает ваш код на месте.
+
+**Импорты и пакеты**. Импорты из @koobiq/components/navbar-ic, risk-level и components-experimental/form-field переназначаются на сохранившиеся пакеты (navbar, badge, components/form-field).
+
+**Идентификаторы в .ts файлах**. Переименованы идентификаторы:
+
+| Старое имя                | Новое имя                        |
+| ------------------------- | -------------------------------- |
+| KbqNavbarIc\*             | KbqNavbar\*                      |
+| KbqRiskLevel\*            | KbqBadge\*                       |
+| KbqWarningTooltipTrigger  | KbqTooltipTrigger                |
+| KbqExtendedTooltipTrigger | KbqTooltipTrigger                |
+| KbqDatepickerToggle       | KbqDatepickerToggleIconComponent |
+| KbqFilterBarSearch        | KbqSearchExpandable              |
+| RdxAccordionItemState     | KbqAccordionItemState            |
+| KbqCodeFile               | KbqCodeBlockFile                 |
+| AnimationCurves           | KbqAnimationCurves               |
+| MeasurementSystem         | KbqMeasurementSystem             |
+| SizeUnitsConfig           | KbqSizeUnitsConfig               |
+| KbqFormFieldRef           | KbqFormField                     |
+
+**Токены и функции**. Обновляются: toBoolean( → booleanAttribute(, isCorrectExtension( → FileValidators.isCorrectExtension(, formatDataSize( → getFormattedSizeParts(, kbqComponentParams: → data:;
+
+Убираются из импортов удаленные токены: KBQ_VALIDATION,KBQ_SANITY_CHECKS, KBQ_SIDEPANEL_WITH_SHADOW
+
+**Методы инстансов**. Обновляются: .openPanel( → .open(, .toggleIsCollapsed( → .toggle(, .focusViaKeyboard( → .focus(.
+
+**Селекторы в шаблонах**. Обновляются: `<kbq-filter-search>` → `<kbq-search-expandable>`, `<kbq-datepicker-toggle>` → `<kbq-datepicker-toggle-icon>`, `<kbq-risk-level>` → `<kbq-badge>`, `<kbq-navbar-ic*>` → `<kbq-navbar*>`.
+
+**Атрибуты в шаблонах**. Обновляются: `kbqFormFieldWithoutBorders` → `noBorders`, `[kbqWarningTooltip]` → `kbqTooltipModifier="warning" [kbqTooltip]`, `[kbqExtendedTooltip]` → `kbqTooltipModifier="extended" [kbqTooltip]`, template-ref `="kbqWarningTooltip"` → `="kbqTooltip"`.
+
+**CSS классы в SCSS**. Обновляются: `.kbq-risk-level` → `.kbq-badge`, `.kbq-navbar-ic` → `.kbq-navbar` и т. д.
+
+**Ручные исправления**. Схематик выводит предупреждения для структурных изменений, которые нельзя безопасно исправить автоматически: слушатели `(onSaveAsNew)` у `<kbq-filters>` нужно перевести на `(onSave)` с ветвлением по `$event.status === 'newFilter'`; атрибуты `[customValidation]` / `[errors]` у file-upload компонентов нужно заменить валидаторами `FormControl`; атрибут `[apps]` у `<button kbqAppSwitcher>` нужно обернуть в один сайт `[sites]="[{ id, name, apps }]"`.
+
+**После миграции**. Проверьте диф перед коммитом: миграция работает на регулярных выражениях и не переписывает значения в локальных переменных, ре-экспортах и алиасных импортах.
diff --git a/docs/guides/migration.en.md b/docs/guides/migration.en.md
index 2a017fb58..975af0f0d 100644
--- a/docs/guides/migration.en.md
+++ b/docs/guides/migration.en.md
@@ -1,17 +1,13 @@
 ## How to upgrade from Koobiq 17
 
-New versions include improvements but also **breaking changes**; they need to be applied step by step.
+New versions include improvements but also contain **breaking changes**; they must be applied step by step.
 
----
+### Upgrade plan
 
-### Summary plan
-
-**Up to 18.5.3** — safe baseline with theming and icon updates
-**18.6** — token update
-**18.22** — component attribute changes
-**After** — final upgrade to the latest version (with updated theming)
-
----
+1. **Up to 18.5.3**: a safe baseline with updated theming and icons.
+2. **18.6**: token update.
+3. **18.22**: component attribute changes.
+4. **20.0.0**: the move to Angular 20: removal of deprecated APIs and package renames.
 
 ### 1. Upgrade to 18.5.3
 
@@ -21,78 +17,135 @@ npm install @koobiq/components@18.5.3
 npm install @koobiq/icons@^9.0.0
 npm install @koobiq/design-tokens@~3.7.3
 npm install @koobiq/angular-luxon-adapter@18.5.3
-npm install @koobiq/date-adapter^3.1.3
-npm install @koobiq/date-formatter^3.1.3
+npm install @koobiq/date-adapter@^3.1.3
+npm install @koobiq/date-formatter@^3.1.3
 npm install luxon
 npm install @messageformat/core
 ```
 
 #### New theming
 
-The theming is now simpler and based on CSS variables. More details [at this link](https://koobiq.io/ru/main/theming/overview#как-использовать?).
+Theming is now simpler and built on CSS variables. [Theming. How to use](https://koobiq.io/en/main/theming/overview).
 
-See examples in the repository:
+Examples:
 
-- [`apps/docs/src/main.scss`](https://github.com/koobiq/angular-components/blob/main/apps/docs/src/main.scss)
-- [`apps/docs/src/styles/_theme-kbq.scss`](https://github.com/koobiq/angular-components/blob/main/apps/docs/src/styles/_theme-kbq.scss)
+- [apps/docs/src/main.scss](https://github.com/koobiq/angular-components/blob/main/apps/docs/src/main.scss)
+- [apps/docs/src/styles/\_theme-kbq.scss](https://github.com/koobiq/angular-components/blob/main/apps/docs/src/styles/_theme-kbq.scss)
 
-#### Icon Package Update
+#### Icon package update
 
-- Install the new icon version:
+Install the new icon version:
 
 ```bash
 npm install @koobiq/icons@9.1.0
 ```
 
-- To update icon names in templates, use the update tool (schematic):
+To update icon names in templates, use the update tool (schematic):
 
 ```bash
 ng g @koobiq/angular-components:new-icons-pack --project <your project>
 ```
 
----
-
 ### 2. Token update (18.6.x)
 
-- Deprecated color tokens have been removed, and typography token names have been renamed.
+Deprecated color tokens were removed and typography parameter tokens were renamed.
 
-The script will rename class and CSS variable names to the new ones and highlight places where outdated colors need to be removed or replaced:
+The script will rename class and CSS-variable names to the new ones and highlight places where deprecated colors need to be removed (replaced):
 
 ```bash
 ng g @koobiq/angular-components:css-selectors --fix=true --project <your project>
 ```
 
-- For manual control, add `--fix=false`. The script will highlight where to remove or replace colors and typography names:
+For manual review, add `--fix=false`. The script will highlight places where colors and typography names need to be removed (replaced):
 
 ```bash
 ng g @koobiq/angular-components:css-selectors --fix=false --project <your project>
 ```
 
----
-
 ### 3. Attribute update (18.22.0)
 
-- Component attribute names have changed:
-    - `KbqLoaderOverlay`: `compact` → `size`
-    - `KbqEmptyState`: `big` → `size`
+Component attribute names have changed:
+
+- **KbqLoaderOverlay**: compact → size
+- **KbqEmptyState**: big → size
+
+The schematic replaces the attributes automatically:
 
 ```bash
 ng g @koobiq/angular-components:loader-overlay-size-attr --project <your project>
 ng g @koobiq/angular-components:empty-state-size-attr --project <your project>
 ```
 
----
+### 4. Upgrade to Angular 20
+
+In version 20.0.0 the library moves to Angular 20. This is a major release: long-deprecated APIs were removed and some packages were renamed. Requirements: **Angular 20+** and **Node.js ≥ 20.19**.
+
+Remove `@koobiq/cdk` from `package.json` — the package has been merged into `@koobiq/components/core`.
 
-### 4. Upgrade to 20.0.0
+#### Running the migration
 
-In v20.0.0 the `@koobiq/cdk` package has been merged into `@koobiq/components/core`. Drop `@koobiq/cdk` from your `package.json` and run the `v20-upgrade` migration — it rewrites every `@koobiq/cdk/{a11y,keycodes,testing}` import to `@koobiq/components/core` together with the other v20 breaking changes:
+Most of the changes are applied by the `v20-upgrade` schematic (runs automatically):
 
 ```bash
-ng update @koobiq/components
+ng update @koobiq/components@20
 ```
 
-Or invoke the schematic manually:
+Or manually. To preview without writing — `--fix=false`:
 
 ```bash
 ng g @koobiq/components:v20-upgrade --project <your project>
 ```
+
+#### What is fixed automatically
+
+**Package moves:**
+
+- @koobiq/components/navbar-ic → navbar
+- risk-level → badge
+- @koobiq/components-experimental/form-field → @koobiq/components/form-field
+- @koobiq/cdk/{a11y,keycodes,testing} → @koobiq/components/core
+
+**Classes, tokens, functions:**
+
+- KbqNavbarIc* → Kbq*,
+- KbqRiskLevel* → KbqBadge*,
+- toBoolean → booleanAttribute,
+- formatDataSize → getFormattedSizeParts
+
+**Instance methods:**
+
+- .openPanel() → .open(),
+- .toggleIsCollapsed() → .toggle(),
+- .focusViaKeyboard() → .focus().
+
+**Templates:**
+
+- kbq-filter-search → kbq-search-expandable,
+- kbq-datepicker-toggle → kbq-datepicker-toggle-icon,
+- kbqFormFieldWithoutBorders → noBorders,
+- [kbqWarningTooltip] → kbqTooltipModifier="warning" [kbqTooltip].
+
+**SCSS:**
+
+- .kbq-risk-level → .kbq-badge,
+- .kbq-navbar-ic → .kbq-navbar, etc.
+
+#### What you need to fix manually
+
+The schematic emits warnings for what cannot be rewritten safely:
+
+**(onSaveAsNew) on kbq-filters**: listen to `(onSave)` and check `$event.status === 'newFilter'`.
+
+**File upload**. The `[customValidation]` and `[errors]` attributes → `FormControl` validators / `FormControl.errors`.
+
+**App switcher**. `[apps]` → `[sites]="[{ id, name, apps }]"`.
+
+**Validation.** **KbqValidateDirective** and **kbqDisableLegacyValidationDirectiveProvider()** were removed → use **ErrorStateMatcher** (e.g. `ShowOnSubmitErrorStateMatcher`).
+
+**Modals**: ModalOptions.kbqComponentParams → the data field + inject(KBQ_MODAL_DATA).
+
+**A bare attribute is no longer coerced**: `<kbq-code-block canDownload>` → `[canDownload]="true"`, `[freeRowsHeight]="160"`. Reading enterDelay/arrow from a trigger instance (tooltip/popover) → now signal calls: `trigger.enterDelay()`.
+
+### After the migration
+
+The migration is regex-based and does not rewrite aliased imports, local variables, or re-exports — **review the diff before committing**, rebuild the project and run your tests. The full list of breaking changes is on the [Angular 20 breaking changes](https://github.com/koobiq/angular-components/blob/main/docs/guides/angular-20-breaking-changes.en.md) page.
diff --git a/docs/guides/migration.ru.md b/docs/guides/migration.ru.md
index 0352181c9..bdf4da645 100644
--- a/docs/guides/migration.ru.md
+++ b/docs/guides/migration.ru.md
@@ -2,16 +2,12 @@
 
 Новые версии включают улучшения, но содержат **ломающие изменения**; их нужно применять постепенно.
 
----
+### План обновления
 
-### Краткий план
-
-**До 18.5.3** — безопасная база с обновлением темизации и иконок
-**18.6** — обновление токенов
-**18.22** — изменение атрибутов компонентов
-**После** — финальное обновление до последней версии (с актуальной темизацией)
-
----
+1. **До 18.5.3**: безопасная база с обновлением темизации и иконок.
+2. **18.6**: обновление токенов.
+3. **18.22**: изменение атрибутов компонентов.
+4. **20.0.0**: переход на Angular 20: удаление устаревших API и переименование пакетов.
 
 ### 1. Обновление до 18.5.3
 
@@ -21,40 +17,38 @@ npm install @koobiq/components@18.5.3
 npm install @koobiq/icons@^9.0.0
 npm install @koobiq/design-tokens@~3.7.3
 npm install @koobiq/angular-luxon-adapter@18.5.3
-npm install @koobiq/date-adapter^3.1.3
-npm install @koobiq/date-formatter^3.1.3
+npm install @koobiq/date-adapter@^3.1.3
+npm install @koobiq/date-formatter@^3.1.3
 npm install luxon
 npm install @messageformat/core
 ```
 
 #### Новая темизация
 
-Теперь темизация более простая и строится на основе CSS-переменных. Подробнее [по ссылке](https://koobiq.io/ru/main/theming/overview#как-использовать?).
+Теперь темизация более простая и строится на основе CSS-переменных. [Темизация. Как использовать](https://koobiq.io/ru/main/theming/overview#как-использовать?).
 
-Смотрите примеры в репозитории:
+Примеры:
 
-- [`apps/docs/src/main.scss`](https://github.com/koobiq/angular-components/blob/main/apps/docs/src/main.scss)
-- [`apps/docs/src/styles/_theme-kbq.scss`](https://github.com/koobiq/angular-components/blob/main/apps/docs/src/styles/_theme-kbq.scss)
+- [apps/docs/src/main.scss](https://github.com/koobiq/angular-components/blob/main/apps/docs/src/main.scss)
+- [apps/docs/src/styles/\_theme-kbq.scss](https://github.com/koobiq/angular-components/blob/main/apps/docs/src/styles/_theme-kbq.scss)
 
 #### Обновление пакета иконок
 
-- Установите новую версию иконок:
+Установите новую версию иконок:
 
 ```bash
 npm install @koobiq/icons@9.1.0
 ```
 
-- Чтобы обновить названия иконок в шаблонах, используйте инструмент для обновления (схематик):
+Чтобы обновить названия иконок в шаблонах, используйте инструмент для обновления (схематик):
 
 ```bash
 ng g @koobiq/angular-components:new-icons-pack --project <your project>
 ```
 
----
-
 ### 2. Обновление токенов (18.6.x)
 
-- Были удалены устаревшие токены цветов и переименованы токены параметров типографики.
+Были удалены устаревшие токены цветов и переименованы токены параметров типографики.
 
 Скрипт заменит названия классов и CSS-переменных на новые и подсветит места, где нужно удалить (заменить) устаревшие цвета:
 
@@ -62,37 +56,96 @@ ng g @koobiq/angular-components:new-icons-pack --project <your project>
 ng g @koobiq/angular-components:css-selectors --fix=true --project <your project>
 ```
 
-- Для ручного контроля добавьте `--fix=false`. Скрипт подсветит места, где нужно удалить (заменить) цвета и названия типографики:
+Для ручного контроля добавьте `--fix=false`. Скрипт подсветит места, где нужно удалить (заменить) цвета и названия типографики:
 
 ```bash
 ng g @koobiq/angular-components:css-selectors --fix=false --project <your project>
 ```
 
----
-
 ### 3. Обновление атрибутов (18.22.0)
 
-- Изменились имена атрибутов компонентов:
-    - `KbqLoaderOverlay`: `compact` → `size`
-    - `KbqEmptyState`: `big` → `size`
+Изменились имена атрибутов компонентов:
+
+- **KbqLoaderOverlay**: compact → size
+- **KbqEmptyState**: big → size
+
+Схематик автоматически заменит атрибуты:
 
 ```bash
 ng g @koobiq/angular-components:loader-overlay-size-attr --project <your project>
 ng g @koobiq/angular-components:empty-state-size-attr --project <your project>
 ```
 
----
+### 4. Обновление до Angular 20
+
+В версии 20.0.0 библиотека переведена на Angular 20. Это крупный релиз: удалены давно устаревшие API и переименована часть пакетов. Требования: **Angular 20+** и **Node.js ≥ 20.19**.
+
+Удалите `@koobiq/cdk` из `package.json` — пакет был объединён с `@koobiq/components/core`.
 
-### 4. Обновление до 20.0.0
+#### Запуск миграции
 
-В v20.0.0 пакет `@koobiq/cdk` объединён с `@koobiq/components/core`. Удалите `@koobiq/cdk` из `package.json` и запустите миграцию `v20-upgrade` — она перепишет все импорты `@koobiq/cdk/{a11y,keycodes,testing}` в `@koobiq/components/core` вместе с прочими breaking-изменениями v20:
+Большую часть изменений применяет схематик `v20-upgrade` (запускается автоматически):
 
 ```bash
-ng update @koobiq/components
+ng update @koobiq/components@20
 ```
 
-Или вручную:
+Или вручную. С предпросмотром без записи — `--fix=false`:
 
 ```bash
 ng g @koobiq/components:v20-upgrade --project <your project>
 ```
+
+#### Что исправляется автоматически
+
+**Перемещения пакетов:**
+
+- @koobiq/components/navbar-ic → navbar
+- risk-level → badge
+- @koobiq/components-experimental/form-field → @koobiq/components/form-field
+- @koobiq/cdk/{a11y,keycodes,testing} → @koobiq/components/core
+
+**Классы, токены, функции:**
+
+- KbqNavbarIc* → Kbq*,
+- KbqRiskLevel* → KbqBadge*,
+- toBoolean → booleanAttribute,
+- formatDataSize → getFormattedSizeParts
+
+**Методы инстансов:**
+
+- .openPanel() → .open(),
+- .toggleIsCollapsed() → .toggle(),
+- .focusViaKeyboard() → .focus().
+
+**Шаблоны:**
+
+- kbq-filter-search → kbq-search-expandable,
+- kbq-datepicker-toggle → kbq-datepicker-toggle-icon,
+- kbqFormFieldWithoutBorders → noBorders,
+- [kbqWarningTooltip] → kbqTooltipModifier="warning" [kbqTooltip].
+
+**SCSS:**
+
+- .kbq-risk-level → .kbq-badge,
+- .kbq-navbar-ic → .kbq-navbar и др.
+
+#### Что нужно поправить вручную
+
+Схематик подсветит предупреждениями то, что нельзя переписать безопасно:
+
+**(onSaveAsNew) у kbq-filters**: слушайте `(onSave)` и проверяйте `$event.status === 'newFilter'`.
+
+**File upload**. Атрибуты `[customValidation]` и `[errors]` → валидаторы `FormControl` / `FormControl.errors`.
+
+**App switcher**. `[apps]` → `[sites]="[{ id, name, apps }]"`.
+
+**Валидация.** Удалены **KbqValidateDirective** и **kbqDisableLegacyValidationDirectiveProvider()** → используйте **ErrorStateMatcher** (например `ShowOnSubmitErrorStateMatcher`).
+
+**Модалки**: ModalOptions.kbqComponentParams → поле data + inject(KBQ_MODAL_DATA).
+
+**«Голый» атрибут больше не подвергается приведению типов**: `<kbq-code-block canDownload>` → `[canDownload]="true"`, `[freeRowsHeight]="160"`. Чтение enterDelay/arrow с инстанса триггера (tooltip/popover) → теперь вызовы сигналов: `trigger.enterDelay()`.
+
+### После миграции
+
+Миграция работает на регулярных выражениях и не переписывает алиасные импорты, локальные переменные и ре-экспорты — **проверьте диф перед коммитом**, пересоберите проект и прогоните тесты. Полный список ломающих изменений — на странице [Ломающие изменения — Angular 20](https://github.com/koobiq/angular-components/blob/main/docs/guides/angular-20-breaking-changes.ru.md).
diff --git a/tools/cspell-locales/en.json b/tools/cspell-locales/en.json
index ce1a09421..6eae5ae77 100644
--- a/tools/cspell-locales/en.json
+++ b/tools/cspell-locales/en.json
@@ -28,6 +28,7 @@
         "opensource",
         "overlayed",
         "overlayscrollbars",
+        "packagr",
         "prerender",
         "refreshable",
         "Repobeats",
diff --git a/tools/cspell-locales/ru.json b/tools/cspell-locales/ru.json
index 791317bdc..779785d48 100644
--- a/tools/cspell-locales/ru.json
+++ b/tools/cspell-locales/ru.json
@@ -15,6 +15,10 @@
         "алерте",
         "алертом",
         "алерты",
+        "алиас",
+        "алиасные",
+        "алиасных",
+        "алиасы",
         "бейджа",
         "бейджами",
         "бейджей",
@@ -45,16 +49,21 @@
         "дозаполнял",
         "дропдаун",
         "дропдауна",
+        "двухаргументной",
         "задизейбленные",
         "задизейблены",
         "задизейблится",
         "инлайн",
         "инпуте",
+        "инпуты",
+        "инстанса",
+        "инстансов",
         "интерпункт",
         "кастомизируемых",
         "кастомное",
         "кастомные",
         "кликает",
+        "коммитом",
         "контрол",
         "контрола",
         "контролам",
@@ -82,9 +91,12 @@
         "нелистовым",
         "нелистовых",
         "отрендерен",
+        "пайплайном",
+        "пересоберите",
         "плейсхолдер",
         "плейсхолдере",
         "подкатегорией",
+        "подпакет",
         "подпапки",
         "поповер",
         "поповера",
@@ -95,6 +107,7 @@
         "предзаполнить",
         "Преднастроенный",
         "преднастроенных",
+        "предпросмотром",
         "предустановка",
         "предустановкам",
         "предустановками",
@@ -107,6 +120,7 @@
         "псевдоссылку",
         "радиокнопками",
         "радиокнопок",
+        "рантайме",
         "рендерился",
         "рендера",
         "роутингом",
@@ -135,6 +149,7 @@
         "спиннером",
         "спиннеры",
         "сплиттером",
+        "степпер",
         "табов",
         "таймзон",
         "таймзоны",
@@ -153,6 +168,7 @@
         "тултипов",
         "тултипом",
         "тултипы",
+        "форком",
         "ховер",
         "ховера",
         "ховере",
@@ -162,6 +178,7 @@
         "чекбоксов",
         "чекбоксом",
         "чекбоксу",
-        "чекбоксы"
+        "чекбоксы",
+        "Юнит"
     ]
 }