@koobiq/components 20.4.1 → 21.0.0

package/schematics/migrations/v21-upgrade/data.js

@@ -0,0 +1,1371 @@
+'use strict';
+
+var tagPatterns = require('../../tag-patterns-CNbEB0iT.js');
+var listItemPattern = require('../../list-item-pattern-D95Y1KIk.js');
+
+/** Removed in 21.0.0: the `kbq-accordion-trigger__action` class. */
+const accordion = {
+    warnPatterns: [
+        {
+            pattern: String.raw `(?<![\w-])kbq-accordion-trigger__action(?![\w-])`,
+            message: 'The kbq-accordion-trigger__action class was removed: an action inside the trigger is a focusable ' +
+                'element inside a `role="button"`. Move the actions out of the trigger into a ' +
+                '`<div class="kbq-accordion-header__actions">` placed after it in `<kbq-accordion-header>`.'
+        }
+    ]
+};
+
+// An opening `<kbq-code-block>` tag that binds `name` twice.
+const codeBlockTagTwice = (name) => String.raw `<kbq-code-block(?![\w-])(?=${tagPatterns.TAG_BODY}*[\s\[]${name}(?=[\]\s=/>])${tagPatterns.TAG_BODY}*[\s\[]${name}[\]\s=/>])`;
+// A file that names the component or reaches it through its `exportAs`.
+const CODE_BLOCK_ANCHOR = String.raw `\bKbqCodeBlock\b|["']kbqCodeBlock["']`;
+const ICON_BUTTON_ATTRIBUTE = String.raw `[\s\[]kbq-icon-button(?![\w-])`;
+// The start of an attribute on an opening icon button tag that does not set `size` itself.
+const ICON_BUTTON_TAG = String.raw `(<[a-zA-Z][\w-]*(?=${tagPatterns.TAG_BODY}*${ICON_BUTTON_ATTRIBUTE})(?!${tagPatterns.TAG_BODY}*[\s\[]size[\]\s=/>])${tagPatterns.TAG_BODY}*?\s)`;
+// A property path such as `isSmall`, `options.small` or `small()`, which needs no parentheses in a ternary.
+const PATH = String.raw `[A-Za-z_$][\w$]*(?:\(\))?(?:\??\.[A-Za-z_$][\w$]*(?:\(\))?)*`;
+/** Removed in 21.0.0: KbqCodeBlock (canLoad, codeFiles, scrollableCodeContent) and KbqIconButton (small). */
+const codeBlockAndIcon = {
+    templateReplacements: [
+        // `[canLoad]="…"`, `canLoad="…"` and a valueless `canLoad`.
+        { from: String.raw `${tagPatterns.codeBlockTagWithout('canDownload')}canLoad(?=\]?[\s=/>])`, to: '$1canDownload' },
+        { from: String.raw `${tagPatterns.codeBlockTagWithout('files')}codeFiles(?=\]?[\s=/>])`, to: '$1files' },
+        { from: String.raw `${ICON_BUTTON_TAG}\[small\]\s*=\s*"true"`, to: '$1size="compact"' },
+        { from: String.raw `${ICON_BUTTON_TAG}\[small\]\s*=\s*"false"`, to: '$1size="normal"' },
+        { from: String.raw `${ICON_BUTTON_TAG}\[small\]\s*=\s*"(${PATH})"`, to: `$1[size]="$2 ? 'compact' : 'normal'"` },
+        { from: String.raw `${ICON_BUTTON_TAG}\[small\]\s*=\s*"([^"]*)"`, to: `$1[size]="($2) ? 'compact' : 'normal'"` },
+        { from: String.raw `${ICON_BUTTON_TAG}small\s*=\s*"true"`, to: '$1size="compact"' },
+        // The class also appears in queries and inline styles.
+        { from: String.raw `\bkbq-icon-button_small\b`, to: 'kbq-icon-button_compact' }
+    ],
+    scssReplacements: [{ from: String.raw `\bkbq-icon-button_small\b`, to: 'kbq-icon-button_compact' }],
+    warnPatterns: [
+        {
+            anchor: String.raw `<kbq-code-block(?![\w-])`,
+            pattern: `${tagPatterns.codeBlockTagWith('canLoad', 'canDownload')}|${tagPatterns.codeBlockTagWith('codeFiles', 'files')}`,
+            message: 'KbqCodeBlock `canLoad` and `codeFiles` were removed: use `canDownload` and `files`. A ' +
+                '<kbq-code-block> that binds `canLoad` next to `canDownload`, or `codeFiles` next to `files`, was ' +
+                'left untouched: merge each pair into one binding. The download button showed when either was ' +
+                'true, and `codeFiles` applied while `files` was empty.'
+        },
+        {
+            anchor: String.raw `<kbq-code-block(?![\w-])`,
+            pattern: `${codeBlockTagTwice('canDownload')}|${codeBlockTagTwice('files')}`,
+            message: 'A <kbq-code-block> that binds `canDownload` or `files` twice is what the 20.0.0 migration left of ' +
+                '`canLoad` or `codeFiles` bound next to its replacement. Only the last binding takes effect: merge ' +
+                'the two into one.'
+        },
+        {
+            anchor: CODE_BLOCK_ANCHOR,
+            pattern: String.raw `\.(?:canLoad|codeFiles)(?:Input)?\b`,
+            message: 'KbqCodeBlock `canLoad`, `codeFiles` and their backing inputs `canLoadInput` and `codeFilesInput` ' +
+                'were removed: read `canDownload()` and `files()`, write `canDownload.set(…)` and `files.set(…)`. ' +
+                'Manual migration required.'
+        },
+        {
+            anchor: CODE_BLOCK_ANCHOR,
+            pattern: String.raw `\.scrollableCodeContent\b`,
+            message: 'KbqCodeBlock.scrollableCodeContent was removed: scroll the code with ' +
+                '`scrollTo(options)` on the code block. Manual migration required.'
+        },
+        {
+            anchor: ICON_BUTTON_ATTRIBUTE,
+            pattern: String.raw `<[a-zA-Z][\w-]*(?=${tagPatterns.TAG_BODY}*${ICON_BUTTON_ATTRIBUTE})(?:` +
+                String.raw `(?=${tagPatterns.TAG_BODY}*[\s\[]size[\]\s=/>])${tagPatterns.TAG_BODY}*[\s\[]small[\]\s=/>]|` +
+                String.raw `${tagPatterns.TAG_BODY}*\s(?:small(?!\s*=\s*"true")(?=[\s=/>])|\[small\]\s*=\s*'))`,
+            message: 'KbqIconButton `small` was removed: set `size="compact"`. Left untouched: an icon button that ' +
+                'sets both `small` and `size`, a single-quoted `[small]` binding, and a static `small` other ' +
+                'than `small="true"`. A valueless `small` never took effect, so drop it; any other static ' +
+                'value made the button compact.'
+        },
+        {
+            anchor: String.raw `\bKbqIconButton\b`,
+            pattern: String.raw `\.small\b`,
+            message: "KbqIconButton.small was removed: read or set `size` ('compact' | 'normal') instead. " +
+                'Manual migration required.'
+        }
+    ]
+};
+
+const CORE$1 = '@koobiq/components/core';
+/** A named import of `symbol` from the core entry point, so an app's own symbol of that name is left alone. */
+const importedFromCore = (symbol) => `import\\s*(?:type\\s*)?\\{[^}]*\\b${symbol}\\b[^}]*\\}\\s*from\\s*['"]${CORE$1}['"]`;
+/** Renames `from` to `to`; a core import clause that held both names keeps the last one. */
+const rename = (from, to) => [
+    { from: `\\b${from}\\b`, to },
+    {
+        from: `([{,]\\s*)${to}\\s*,\\s*(?=(?:[\\w\\s,]*,\\s*)?${to}\\b(?!\\s+as\\b)[\\w\\s,]*\\}\\s*from\\s*['"]${CORE$1}['"])`,
+        to: '$1'
+    }
+];
+// Templates read the enums when a component exposes them under their own name.
+const DEFAULT_ENUM_MEMBERS = [
+    { from: '\\bKbqThemeSelector\\.Default\\b', to: 'KbqThemeSelector.Light' },
+    { from: '\\bKbqThemeNames\\.Default\\b', to: 'KbqThemeNames.Light' }
+];
+// The members of `ThemePalette` that `KbqComponentColors` holds under the same value; the others style nothing.
+const THEME_PALETTE = [
+    {
+        from: `(?<=${importedFromCore('ThemePalette')}[\\s\\S]*)\\bThemePalette\\.(Error|Warning|Success)\\b`,
+        to: 'KbqComponentColors.$1',
+        ensureImport: { symbol: 'KbqComponentColors', from: CORE$1 }
+    },
+    {
+        // The import specifier, with one of its commas, once nothing else names it; an emptied clause is dropped by
+        // `removeImport`. A re-export is reported instead.
+        from: `(?<=\\bimport\\s*(?:type\\s*)?\\{[^}]*)${listItemPattern.listItemPattern('\\bThemePalette\\b(?!\\s+as\\b)')}(?=[^}]*\\}\\s*from\\s*['"]${CORE$1}['"])(?![\\s\\S]*\\bThemePalette\\b)`,
+        to: '',
+        removeImport: { symbol: 'ThemePalette', from: CORE$1 }
+    }
+];
+/**
+ * The `mc` alias `name` of a list item slot: an attribute of an opening tag in a template, or an attribute selector
+ * in a string, such as a `querySelector()` argument. The template replacements run over the whole of a `.ts` file,
+ * where the name anywhere else is the app's own: `mcLine = 1`, `this.mcLine`, a `.mcLine` class in `styles`.
+ */
+const mcAlias = (name, to) => [
+    { from: `(?<=<[a-zA-Z][\\w-]*\\s${tagPatterns.TAG_BODY}*)(?<=\\s)${name}(?=[\\s=/>])`, to },
+    { from: `(?<=['"\`][^'"\`\\n]*\\[\\s*)${name}(?=\\s*[\\]=~|^$*])`, to }
+];
+/** `name` as the attribute of a selector in a stylesheet, which matches an HTML attribute in any case. */
+const attributeSelector = (name) => {
+    const anyCase = [...name].map((char) => `[${char.toLowerCase()}${char.toUpperCase()}]`).join('');
+    return `(?<=\\[\\s*)${anyCase}(?=\\s*[\\]=~|^$*])`;
+};
+// In a stylesheet, only an attribute selector: `.mcLine` and `$mcLine` are the app's own.
+const MC_SELECTORS = [
+    { from: attributeSelector('mcLine'), to: 'kbq-line' },
+    { from: attributeSelector('mcListIcon'), to: 'kbq-list-icon' }
+];
+/** Undocumented core exports nothing in the library needed, removed in 21.0.0, with what to do instead. */
+const UNUSED_EXPORTS = [
+    {
+        symbols: [
+            'POSITION_MAP',
+            'EXTENDED_OVERLAY_POSITIONS',
+            'POSITION_PRIORITY_STRATEGY',
+            '\\w+_POSITION_PRIORITY',
+            'ARROW_BOTTOM_MARGIN_AND_HALF_HEIGHT',
+            'SELECT_PANEL_VIEWPORT_PADDING',
+            'NUMBER_FORMAT_REGEXP',
+            'isWithin'
+        ],
+        message: 'The pop-up position lists (`POSITION_MAP`, `EXTENDED_OVERLAY_POSITIONS`, `POSITION_PRIORITY_STRATEGY`, ' +
+            'the `*_POSITION_PRIORITY` lists), `ARROW_BOTTOM_MARGIN_AND_HALF_HEIGHT`, ' +
+            '`SELECT_PANEL_VIEWPORT_PADDING`, `NUMBER_FORMAT_REGEXP` and `isWithin()` are no longer exported: ' +
+            'they are implementation details of the pop-ups, the select and the number pipes. Copy the values ' +
+            'you need; for a pop-up position, set `kbqPlacement` on the trigger.'
+    },
+    {
+        symbols: ['KBQ_SELECT_SCROLL_STRATEGY_PROVIDER'],
+        message: '`KBQ_SELECT_SCROLL_STRATEGY_PROVIDER` was removed: `KBQ_SELECT_SCROLL_STRATEGY` has a root default, ' +
+            'so drop the provider; to change the strategy, provide `KBQ_SELECT_SCROLL_STRATEGY` itself.'
+    },
+    {
+        symbols: ['KBQ_CHECKABLE_CONTROL_VALUE_ACCESSOR'],
+        message: '`KBQ_CHECKABLE_CONTROL_VALUE_ACCESSOR` is no longer exported: `KbqCheckable` registers itself as the ' +
+            'value accessor, so drop the provider.'
+    },
+    {
+        symbols: ['KbqHover'],
+        message: '`KbqHover` was removed: bind `(mouseenter)` and `(mouseleave)`, or style `:hover`. Its host class ' +
+            '`kbq-hover` forced the hover look of the themes on every host.'
+    },
+    {
+        symbols: ['CanColor'],
+        message: '`CanColor` was removed: nothing implemented it. Type the member `Signal<KbqComponentColors | string>`, ' +
+            'or add `KbqColorDirective` to the host directives.'
+    },
+    {
+        symbols: ['KbqAnimationCurves', 'KbqAnimationDurations'],
+        message: '`KbqAnimationCurves` and `KbqAnimationDurations` were removed: they timed the `@angular/animations` ' +
+            'triggers the library no longer has. Copy the values you need into your own constants.'
+    },
+    {
+        symbols: ['KbqRectangleItem', 'countGroupLabelsBeforeOption'],
+        message: '`KbqRectangleItem` (left over from the removed navbar-ic) and `countGroupLabelsBeforeOption()` were ' +
+            'removed without a replacement: nothing in the library used them.'
+    },
+    {
+        symbols: ['KbqLineSetter'],
+        message: '`KbqLineSetter` was removed, and a list item no longer gets the `kbq-2-line`, `kbq-3-line` and ' +
+            '`kbq-multi-line` classes: no style read them.'
+    },
+    {
+        symbols: ['KbqLine'],
+        message: '`KbqLine` was removed: only `KbqListItem.lines` read it. The `kbq-line` attribute still places an ' +
+            'element in the text of a list item; drop `KbqLine` from `imports`, and to count the lines, query ' +
+            'your own elements, for example `contentChildren(...)` of a directive of yours.'
+    }
+];
+// The 20.x classes deriving from `KbqPopUp` or `KbqPopUpTrigger`: a trigger reaches its pop-up through the untyped
+// `instance`, so a removed member called there only fails at run time.
+const POP_UP_SUBCLASS = '\\bextends\\s+(?:KbqPopUp(?:Trigger)?|Kbq(?:Tooltip|Popover(?:Confirm)?|NotificationCenter|AppSwitcher)' +
+    '(?:Component|Trigger)|Kbq(?:Title|EllipsisCenter)Directive|KbqPasswordToggle|KbqNavbar(?:Item|Brand)|' +
+    'Kbq(?:Timezone)?OptionTooltip)\\b';
+// The 20.x pop-up classes, whose `elementRef` is a getter now; a trigger keeps it as a field.
+const POP_UP_PANEL_SUBCLASS = '\\bextends\\s+(?:KbqPopUp|Kbq(?:Tooltip|Popover(?:Confirm)?|NotificationCenter|AppSwitcher)Component)\\b';
+// `elementRef` declared as a field, decorated or not, or as a constructor parameter property.
+const ELEMENT_REF_FIELD = '(?:^|\\n)\\s*(?:@ViewChild\\s*\\([^)]*\\)\\s*)?(?:(?:public|protected|private|override|readonly|declare)\\s+)*' +
+    'elementRef\\s*[!?]?\\s*(?:=(?!=)|:[^;,(){}=]*;)|' +
+    '\\b(?:public|protected|private)\\s+(?:readonly\\s+)?elementRef\\s*\\??\\s*:';
+// The unprefixed date pipes and their `ImpurePipe` twins, by pipe name and by class name.
+const LEGACY_DATE_PIPE = '(?:absolute(?:Long|Short)Date(?:Time)?|relative(?:Long|Short)Date(?:Time)?|range(?:Long|Short)Date(?:Time)?|' +
+    'rangeMiddleDateTime|duration(?:Shortest|Long|Short))(?:ImpurePipe)?';
+const LEGACY_DATE_PIPE_CLASS = '(?:(?:Absolute|Relative|Range|Duration)\\w*Formatter(?:Impure)?Pipe|BaseFormatterPipe)';
+/** Deprecated in 21.0.0 for removal in 22.0.0, with what to use instead. */
+const DEPRECATED = [
+    {
+        pattern: `(?<!\\|)\\|\\s*${LEGACY_DATE_PIPE}(?![\\w-])|${importedFromCore(LEGACY_DATE_PIPE_CLASS)}`,
+        message: 'The unprefixed date pipes (`absoluteLongDate`…`durationShort`) and their `ImpurePipe` twins are ' +
+            'deprecated and will be removed in 22.0.0: use the `kbq*` pipe of the same format with the same ' +
+            'arguments, for example `kbqAbsoluteLongDate` (`KbqAbsoluteLongDatePipe`), which follows a locale change.'
+    },
+    {
+        pattern: `(?<!\\|)\\|\\s*mcHighlight(?![\\w-])|${importedFromCore('KbqHighlightPipe')}`,
+        message: 'The `mcHighlight` pipe (`KbqHighlightPipe`) is deprecated and will be removed in 22.0.0: use ' +
+            '`kbqHighlightBold` (`KbqHighlightBoldPipe`), which marks the matches the same way.'
+    },
+    {
+        pattern: importedFromCore('(?:isDigit|isBoolean|KbqMeasureScrollbarService)'),
+        message: '`isDigit()`, `isBoolean()` and `KbqMeasureScrollbarService` from `@koobiq/components/core` are ' +
+            "deprecated and will be removed in 22.0.0: use `isNumberKey()`, `typeof value === 'boolean'`, and " +
+            '`element.offsetWidth - element.clientWidth` of the element that scrolls.'
+    },
+    {
+        pattern: '\\.getFocusOrigin\\(\\)',
+        message: '`FocusKeyManager.getFocusOrigin()` is deprecated and will be removed in 22.0.0: keep the origin you ' +
+            'pass to `setFocusOrigin()`.'
+    },
+    {
+        // Beside `placeholder` or under `datepicker`: a `KBQ_DATE_FORMATS` object, its replacement, has the key too.
+        pattern: '\\bdatepicker\\s*:\\s*\\{[^{}]*\\bdateInput\\s*:|\\bplaceholder\\s*:[^{}]*\\bdateInput\\s*:|' +
+            '\\bdateInput\\s*:[^{}]*\\bplaceholder\\s*:|\\.datepicker\\??\\.dateInput\\b',
+        message: '`dateInput` of the datepicker locale configuration is deprecated and will be removed in 22.0.0: ' +
+            'nothing reads it. Set the input format through `KBQ_DATE_FORMATS`.'
+    }
+];
+/**
+ * Removed in 21.0.0: the `Default` members of `KbqThemeSelector` and `KbqThemeNames`, `KbqDefaultThemes`,
+ * `KbqTheme`, the legacy `ThemeService`, `getOptionScrollPosition`, `ThemePalette`, the unused undocumented
+ * exports and members with `KbqLineSetter`, `KbqLine` and `KbqListItem.lines`, and the `mcLine` and `mcListIcon`
+ * aliases. Also reports the core API deprecated for removal in 22.0.0.
+ */
+const core = {
+    tsReplacements: [
+        ...DEFAULT_ENUM_MEMBERS,
+        ...rename('KbqDefaultThemes', 'KBQ_DEFAULT_THEMES'),
+        ...rename('KbqTheme', 'KbqThemeConfig'),
+        ...THEME_PALETTE
+    ],
+    templateReplacements: [
+        ...DEFAULT_ENUM_MEMBERS,
+        ...mcAlias('mcLine', 'kbq-line'),
+        ...mcAlias('mcListIcon', 'kbq-list-icon')
+    ],
+    scssReplacements: MC_SELECTORS,
+    warnPatterns: [
+        ...UNUSED_EXPORTS.map(({ symbols, message }) => ({
+            pattern: importedFromCore(`(?:${symbols.join('|')})`),
+            message
+        })),
+        ...DEPRECATED,
+        {
+            pattern: '(?<![\\w-])kbq-(?:2|3|multi)-line(?![\\w-])',
+            message: 'A list item no longer gets the `kbq-2-line`, `kbq-3-line` and `kbq-multi-line` classes: style the ' +
+                'item by its content instead, for example `.kbq-list-item:has(.kbq-line + .kbq-line)`.'
+        },
+        {
+            pattern: '\\.(?:handleBodyInteraction\\(|isSpecialFormatForRULocale\\(|roundingOptions\\b)',
+            message: '`KbqPopUp.handleBodyInteraction()` was removed: nothing called it. `isSpecialFormatForRULocale()` ' +
+                'and `roundingOptions` of the number pipes are private: configure a pipe through its arguments and ' +
+                'the formatters locale configuration.'
+        },
+        {
+            anchor: POP_UP_SUBCLASS,
+            pattern: '\\b(?:this|super|instance)[!?]?\\.(?:markForCheck\\s*\\(|warning\\b|closeOnInteraction\\b)|' +
+                '\\boverride\\s+(?:readonly\\s+)?(?:markForCheck|warning|closeOnInteraction)\\b',
+            message: '`KbqPopUp.markForCheck()`, `warning` and the protected `closeOnInteraction` were removed. Delete a ' +
+                '`markForCheck()` made after `updateClassMap()` or a change of `visibility`: both re-render the ' +
+                'pop-up now. After writing a field of its own, a pop-up subclass calls ' +
+                '`this.changeDetectorRef.markForCheck()`; a trigger that writes the fields of its pop-up calls ' +
+                '`this.instance.detectChanges()`. `warning` did nothing and `closeOnInteraction` only gated the ' +
+                'removed `handleBodyInteraction()`: delete them.'
+        },
+        {
+            anchor: POP_UP_PANEL_SUBCLASS,
+            pattern: ELEMENT_REF_FIELD,
+            message: '`KbqPopUp.elementRef` is a protected getter now, so a pop-up subclass that re-declares it as a ' +
+                "field, such as `@ViewChild('panel') elementRef`, no longer compiles. Override the getter over a " +
+                'signal query instead: ' +
+                "`private readonly panel = viewChild.required<ElementRef<HTMLElement>>('panel');` and " +
+                '`override get elementRef(): ElementRef<HTMLElement> { return this.panel(); }`.'
+        },
+        {
+            anchor: '\\bKbqListItem\\b|<kbq-list-item\\b|\\bkbq-list-item\\b',
+            pattern: '\\.lines\\b',
+            message: '`KbqListItem.lines` was removed with `KbqLine`: nothing in the library counted the lines. Query ' +
+                'the elements you mark with `kbq-line` yourself.'
+        },
+        {
+            anchor: '\\bKbqSelectSearch\\b',
+            pattern: '\\.hasPlaceholder\\s*\\(',
+            message: '`KbqSelectSearch.hasPlaceholder()` was removed: nothing called it. Read the placeholder of the ' +
+                'search input instead.'
+        },
+        {
+            anchor: '\\bKbqFormElement\\b|["\']kbqFormElement["\']',
+            pattern: '\\.isRow\\b',
+            message: '`KbqFormElement.isRow` was removed: it only reflected the `kbq-form__row` class of the element, ' +
+                'so check that class instead.'
+        },
+        {
+            pattern: '\\bKbqTheme\\b',
+            message: '`KbqTheme` was renamed to `KbqThemeConfig`, which requires `colorScheme` (`light` or `dark`) and ' +
+                'has no `selected`: add `colorScheme` to every custom theme and compare a theme with ' +
+                '`KbqThemeService.currentTheme()` instead of reading `selected`.'
+        },
+        {
+            pattern: importedFromCore('ThemeService'),
+            message: '`ThemeService` was removed: inject `KbqThemeService` instead. `current.value` and `getTheme()` ' +
+                'become `currentTheme()` (a signal: wrap it in `toObservable()` for a stream), `themes` becomes ' +
+                '`themes()` and `setThemes()`, `setTheme(theme)` becomes `setMode(theme.colorScheme)`, or ' +
+                '`selectTheme(theme.name)` to pin that theme. `KbqThemeService` applies a theme once injected and ' +
+                "starts in `'auto'` mode: set the initial mode with `kbqThemeProvider({ mode })`."
+        },
+        {
+            pattern: importedFromCore('getOptionScrollPosition'),
+            message: '`getOptionScrollPosition()` was removed. `KbqOption.focus()` scrolls an option into view; for an ' +
+                'element of your own, call `kbqFocusAndReveal(element)` from `@koobiq/components/core`.'
+        },
+        {
+            // Every use but the rewritten members and the import specifier itself.
+            anchor: importedFromCore('ThemePalette'),
+            pattern: '\\bThemePalette\\s+as\\b|\\bThemePalette\\b(?!\\s*\\.\\s*(?:Error|Warning|Success)\\b)(?![^{}]*\\}\\s*from\\b)',
+            message: '`ThemePalette` was removed: use `KbqComponentColors`, which `Error`, `Warning` and `Success` are ' +
+                'rewritten to. `Primary`, `Secondary`, `Info` and `Default` matched no style of any component: drop ' +
+                'the color, or pick a member of `KbqComponentColors` the component supports. Instead of `Empty`, ' +
+                "leave `color` unset: `KbqComponentColors.Empty` is `'empty'`, not `''`. Type a member " +
+                '`KbqComponentColors`, and hand a template `KbqComponentColors` instead of the enum.'
+        },
+        {
+            pattern: `\\bexport\\s*(?:type\\s*)?\\{[^}]*\\bThemePalette\\b[^}]*\\}\\s*from\\s*['"]${CORE$1}['"]`,
+            message: 'A re-export of `ThemePalette` from `@koobiq/components/core` is left as is: the enum was removed, ' +
+                'and `KbqComponentColors` has other members and values, so it cannot take the name. Re-export ' +
+                '`KbqComponentColors` instead and migrate the files that import `ThemePalette` from here.'
+        }
+    ]
+};
+
+const CORE = '@koobiq/components/core';
+const DROPDOWN = '@koobiq/components/dropdown';
+/** A file that uses one of the selects: an import in code or the element in a template. */
+const SELECTS = '@koobiq/components/(?:select|tree-select|timezone)\\b|<kbq-(?:tree-|timezone-)?select\\b';
+/** A file that names the dropdown entry point, before or after the match. */
+const IN_DROPDOWN_FILE = `(?:(?<=['"]${DROPDOWN}['"][\\s\\S]*)|(?=[\\s\\S]*['"]${DROPDOWN}['"]))`;
+const TRIGGER_WIDTH = 'it had no effect, delete it. To match the panel to an element other than the trigger, set ' +
+    '`KbqDropdownTrigger.widthOrigin`.';
+const OFFSET_Y = '`offsetY` was removed from `KbqSelect`, `KbqTreeSelect` and `KbqTimezoneSelect`; delete it. The gap between ' +
+    'the trigger and the panel is the `--kbq-connected-overlay-gap` CSS variable, set on `:root` or on the pane.';
+const CLEAR_VALUE = '`clearValue()` was removed from `KbqSelect`, `KbqTreeSelect` and `KbqTimezoneSelect`: project ' +
+    '`<kbq-cleaner />` into the select for the user to clear it, and reset the bound form control or model to ' +
+    'clear it from code.';
+/**
+ * Moves `symbol` of `module` to `KbqPanelWidth` of the core entry point. An aliased import and a re-export are
+ * left to the warning below.
+ */
+const toPanelWidth = (symbol, module) => [
+    {
+        // The imported specifier, with one of its commas; an emptied clause is dropped by `removeImport`.
+        from: `(?<=import\\s*(?:type\\s*)?\\{[^}]*)${listItemPattern.listItemPattern(`\\b${symbol}\\b(?!\\s+as\\b)`)}(?=[^}]*\\}\\s*from\\s*['"]${module}['"])`,
+        to: '',
+        removeImport: { symbol, from: module },
+        ensureImport: { symbol: 'KbqPanelWidth', from: CORE }
+    },
+    {
+        from: `\\b${symbol}\\b(?!\\s+as\\b)(?![^}]*\\}\\s*from\\s*['"]${module}['"])`,
+        to: 'KbqPanelWidth',
+        ensureImport: { symbol: 'KbqPanelWidth', from: CORE }
+    }
+];
+/**
+ * Removed in 21.0.0: KbqDropdown triggerWidth, KbqSelect and KbqTreeSelect offsetY, AUTOCOMPLETE_PANEL_HEIGHT,
+ * DropdownPositionX and DropdownPositionY, KbqSelectPanelWidth and KbqTreeSelectPanelWidth, KbqSelect and
+ * KbqTreeSelect clearValue(), the kbq-dropdown__group-header_small modifier.
+ *
+ * The type aliases are rewritten to their replacements. The rest has nothing to rewrite to and is reported: none
+ * of the members was an input, so a template can only reach them through a reference.
+ */
+const dropdownAndSelect = {
+    tsReplacements: [
+        // Only in a file that names the dropdown entry point: an app may have a type of the same name.
+        { from: `\\bDropdownPosition([XY])\\b${IN_DROPDOWN_FILE}`, to: 'KbqDropdownPosition$1' },
+        {
+            // A clause that imported both names now holds the new one twice; keep the last one.
+            from: `([{,]\\s*)KbqDropdownPosition([XY])\\s*,\\s*(?=(?:[\\w\\s,]*,\\s*)?KbqDropdownPosition\\2\\b(?!\\s+as\\b)[\\w\\s,]*\\}\\s*from\\s*['"]${DROPDOWN}['"])`,
+            to: '$1'
+        },
+        ...toPanelWidth('KbqSelectPanelWidth', '@koobiq/components/select'),
+        ...toPanelWidth('KbqTreeSelectPanelWidth', '@koobiq/components/tree-select')
+    ],
+    templateReplacements: [],
+    warnPatterns: [
+        {
+            anchor: '@koobiq/components/dropdown\\b|<kbq-dropdown\\b',
+            pattern: '\\.triggerWidth\\b',
+            message: `\`KbqDropdown.triggerWidth\` was removed; ${TRIGGER_WIDTH}`
+        },
+        {
+            anchor: '\\bKbqDropdownPanel\\b|\\bextends\\s+KbqDropdown\\b',
+            pattern: '(?<!\\.)\\btriggerWidth\\b',
+            message: `\`KbqDropdownPanel.triggerWidth\` was removed; ${TRIGGER_WIDTH}`
+        },
+        {
+            anchor: SELECTS,
+            // Called, it is the `KbqDropdownTrigger.offsetY` input, which stays.
+            pattern: '\\.offsetY\\b(?!\\s*\\()',
+            message: OFFSET_Y
+        },
+        {
+            anchor: '\\bextends\\s+Kbq(?:Tree|Timezone)?Select\\b',
+            pattern: '(?:^|\\n)\\s*(?:(?:public|override)\\s+)*offsetY\\s*(?::\\s*number\\s*)?[=;]',
+            message: OFFSET_Y
+        },
+        {
+            anchor: '@koobiq/components/autocomplete\\b',
+            pattern: '\\bAUTOCOMPLETE_PANEL_HEIGHT\\b',
+            message: '`AUTOCOMPLETE_PANEL_HEIGHT` was removed; the library did not read it. The panel height is capped ' +
+                'by the `--kbq-autocomplete-size-panel-max-height` CSS variable; keep a constant of your own if ' +
+                'you need the 256.'
+        },
+        {
+            // The rewrite above leaves the type alone in a file that does not name the dropdown.
+            pattern: `^(?![\\s\\S]*['"]${DROPDOWN}['"])[\\s\\S]*\\bDropdownPosition[XY]\\b`,
+            message: '`DropdownPositionX` and `DropdownPositionY` were removed from `@koobiq/components/dropdown`. If ' +
+                'this one is theirs, re-exported, use `KbqDropdownPositionX` / `KbqDropdownPositionY`.'
+        },
+        {
+            pattern: '\\bKbq(?:Tree)?SelectPanelWidth\\s+as\\b|\\bexport\\s*(?:type\\s+)?\\{[^}]*\\bKbq(?:Tree)?SelectPanelWidth\\b',
+            message: '`KbqSelectPanelWidth` and `KbqTreeSelectPanelWidth` were removed: use `KbqPanelWidth` from ' +
+                '`@koobiq/components/core`. Plain imports and uses are rewritten; fix this aliased import or ' +
+                're-export by hand.'
+        },
+        {
+            anchor: SELECTS,
+            // `KbqFormField.clearValue()` stays; on `this` it is a method of the file's own class.
+            pattern: '(?<!\\bthis|[Ff]ormField(?:\\(\\))?[!?]?)\\.clearValue\\b',
+            message: `${CLEAR_VALUE} \`KbqFormField.clearValue()\` stays.`
+        },
+        {
+            anchor: '\\bextends\\s+Kbq(?:Tree|Timezone)?Select\\b',
+            pattern: '\\bclearValue\\b',
+            message: `${CLEAR_VALUE} A subclass drops its override.`
+        },
+        {
+            pattern: '\\bkbq-dropdown__group-header_small\\b',
+            message: 'The `kbq-dropdown__group-header_small` modifier was removed: replace the header with ' +
+                '`<kbq-optgroup label="…" />` (`KbqOptgroup` from `@koobiq/components/core`), which renders the ' +
+                'subheading in the same typography and color.'
+        }
+    ]
+};
+
+const FILTER_BAR = '@koobiq/components/filter-bar';
+/** The rest of a named import or re-export clause of the filter bar entry point. */
+const FILTER_BAR_CLAUSE_END = `(?=[^}]*\\}\\s*from\\s*['"]${FILTER_BAR}['"])`;
+/** The rest of an object literal at the same depth, past nested objects up to two levels deep. */
+const SAME_OBJECT = '(?:[^{}]|\\{(?:[^{}]|\\{[^{}]*\\})*\\})*';
+/** A key only a pipe has. */
+const PIPE_KEY = '(?:\\b(?:cleanable|removable)\\s*:|\\btype\\s*:\\s*KbqPipeTypes\\.)';
+/** The `required` key, as opposed to the `required?` of an interface or `Validators.required`. */
+const REQUIRED_KEY = '\\brequired\\s*:';
+/** Removed in 21.0.0: KbqFilterBar.changes, KbqFilterBarRefresher, the pipe min-width directive, KbqPipe.required. */
+const filterBar = {
+    tsReplacements: [
+        { from: '\\bKbqFilterBarRefresher\\b', to: 'KbqFilterRefresher' },
+        {
+            // A clause that imported both names now holds `KbqFilterRefresher` twice; keep the last one.
+            from: `([{,]\\s*)KbqFilterRefresher\\s*,\\s*(?=(?:[\\w\\s,]*,\\s*)?KbqFilterRefresher\\b(?!\\s+as\\b)[\\w\\s,]*\\}\\s*from\\s*['"]${FILTER_BAR}['"])`,
+            to: '$1'
+        },
+        {
+            // The specifier, with one of its commas; an emptied clause is dropped by `removeImport`.
+            from: `(?<=(?:import|export)\\s*(?:type\\s*)?\\{[^}]*)${listItemPattern.listItemPattern('\\bKbqPipeMinWidth\\b(?!\\s+as\\b)')}${FILTER_BAR_CLAUSE_END}`,
+            to: '',
+            removeImport: { symbol: 'KbqPipeMinWidth', from: FILTER_BAR }
+        },
+        // An element of an `imports` array: the first or a middle one, the last one, the only one.
+        { from: '([\\[,]\\s*)KbqPipeMinWidth\\s*,\\s*', to: '$1' },
+        { from: ',\\s*KbqPipeMinWidth(\\s*\\])', to: '$1' },
+        { from: '\\[\\s*KbqPipeMinWidth\\s*\\]', to: '[]' }
+    ],
+    templateReplacements: [{ from: `\\s+kbqPipeMinWidth(?:\\s*=\\s*(?:"[^"]*"|'[^']*'))?(\\s|/?>)`, to: '$1' }],
+    warnPatterns: [
+        {
+            anchor: '\\bKbqFilterBar\\b',
+            pattern: '\\.changes\\b',
+            message: 'KbqFilterBar.changes was removed in 21.0.0; it never emitted. If this `.changes` is the filter ' +
+                "bar's, read `filterBar.filter()` inside an `effect(...)` or listen to `(filterChange)`."
+        },
+        {
+            // Import specifiers and array elements are removed by the rewrites above.
+            pattern: '\\bKbqPipeMinWidth\\b(?!\\s*[,\\]}])',
+            message: 'KbqPipeMinWidth (kbqPipeMinWidth) was removed in 21.0.0 without a replacement: a pipe lays its ' +
+                'name and value out as shrinkable grid tracks, which keeps a short part intact. Remove this reference.'
+        },
+        {
+            // Only next to a key of the same pipe: a form config or a validator in the same file has `required:` too.
+            anchor: FILTER_BAR,
+            pattern: `${REQUIRED_KEY}${SAME_OBJECT}${PIPE_KEY}|${PIPE_KEY}${SAME_OBJECT}${REQUIRED_KEY}`,
+            message: 'KbqPipe.required was removed in 21.0.0; the filter bar never read it. Delete `required` from the ' +
+                'pipe and set `cleanable: false` and `removable: false` to keep the pipe from being cleared or removed.'
+        },
+        {
+            anchor: `${FILTER_BAR}|\\bkbq-pipe`,
+            pattern: '\\b(?:data|\\w*[pP]ipe)[?!]?\\.required\\b(?!\\s*\\()',
+            message: "KbqPipe.required was removed in 21.0.0. If this `.required` is a pipe's, a pipe that cannot be " +
+                'cleared or removed has `cleanable` and `removable` set to false: read those instead.'
+        }
+    ]
+};
+
+/** A named import of `symbol` from the form field entry point, so an app's own symbol of that name is left alone. */
+const importedFromFormField = (symbol) => `import\\s*(?:type\\s*)?\\{[^}]*\\b${symbol}\\b[^}]*\\}\\s*from\\s*['"]@koobiq/components/form-field['"]`;
+/** A member access on a receiver named like a form field: `formField.x`, `this.formField().x`, `myFormField?.x`. */
+const onFormField = (member) => `\\b\\w*[fF]ormField\\b(?:\\(\\))?[?!]?\\.${member}\\b`;
+const FORM_FIELD_OWNER = '\\bKbqFormField\\b|\\bkbqFormField\\b';
+/**
+ * Removed in 21.0.0: the `KbqPasswordHint` rules engine (`PasswordRules`, `regExpPasswordValidator`,
+ * `hasPasswordStrengthError`), what only served it on `KbqFormField` and `KbqInputPassword`, the unused
+ * `KbqFormField.canCleanerClearByEsc` and `onKeyDown`, and the no-op `KbqStepper.connectTo()`. None has a 1:1
+ * replacement, so all are reported.
+ */
+const formField = {
+    tsReplacements: [],
+    templateReplacements: [],
+    warnPatterns: [
+        {
+            pattern: importedFromFormField('KbqPasswordHint'),
+            message: '`KbqPasswordHint` was removed: use `KbqReactivePasswordHint`. Put the rules on the form control as ' +
+                'validators (`PasswordValidators` from `@koobiq/components/core`) and bind the hint to their ' +
+                'errors: `<kbq-reactive-password-hint [hasError]="control.hasError(\'minLength\')">`.'
+        },
+        {
+            pattern: '\\bkbq-password-hint(?:__icon)?\\b',
+            message: '`<kbq-password-hint>` was removed: replace it with `<kbq-reactive-password-hint [hasError]="…">`, ' +
+                'bound to the error of the matching validator of the control (`PasswordValidators` from ' +
+                '`@koobiq/components/core`). `[rule]`, `[min]`, `[max]`, `[regex]`, `[checkRule]` and ' +
+                '`[viewFormField]` have no counterpart, and the new hint has to be inside the `kbq-form-field`. ' +
+                'Selectors on `kbq-password-hint` / `.kbq-password-hint` target `.kbq-reactive-password-hint` now.'
+        },
+        {
+            pattern: importedFromFormField('PasswordRules'),
+            message: '`PasswordRules` was removed: express each rule as a validator of the form control — ' +
+                '`PasswordValidators.minLength`, `maxLength`, `minUppercase`, `minLowercase`, `minNumber` or ' +
+                '`minSpecial` from `@koobiq/components/core`, or a `ValidatorFn` of your own — and show it with ' +
+                '`<kbq-reactive-password-hint [hasError]="…">`.'
+        },
+        {
+            pattern: importedFromFormField('regExpPasswordValidator'),
+            message: '`regExpPasswordValidator` was removed: write the pattern you need into a validator of the form ' +
+                'control (`Validators.pattern` or a `ValidatorFn` of your own), or use `PasswordValidators` from ' +
+                '`@koobiq/components/core`.'
+        },
+        {
+            pattern: importedFromFormField('hasPasswordStrengthError'),
+            message: '`hasPasswordStrengthError` was removed: the password rules are validators of the form control ' +
+                "now, so check the control itself (`control.invalid`, `control.hasError('minLength')`)."
+        },
+        {
+            anchor: '@koobiq/components/(?:form-field|input)|\\bkbqInputPassword\\b',
+            pattern: `['"]passwordStrength['"]|\\berrors[?!]?\\.passwordStrength\\b`,
+            message: 'The form field no longer sets the `passwordStrength` error on the control: it came from the removed ' +
+                '`KbqPasswordHint`. Check the errors of the password validators of the control instead.'
+        },
+        {
+            anchor: FORM_FIELD_OWNER,
+            pattern: `\\.hasPasswordHint\\b|${onFormField('passwordHints')}`,
+            message: '`KbqFormField.passwordHints` and `hasPasswordHint` were removed together with `KbqPasswordHint`. ' +
+                'Query the hints you render (`viewChildren(KbqReactivePasswordHint)`) or read the errors of the control.'
+        },
+        {
+            pattern: '\\bcanCleanerClearByEsc\\b',
+            message: '`KbqFormField.canCleanerClearByEsc` was removed: it was unused and had no effect. Delete this ' +
+                'read or assignment.'
+        },
+        {
+            anchor: FORM_FIELD_OWNER,
+            pattern: `${onFormField('onKeyDown')}\\s*\\(`,
+            message: '`KbqFormField.onKeyDown()` was removed: it did nothing. Delete the call; listen to `(keydown)` on ' +
+                'the control if you need the event.'
+        },
+        {
+            anchor: '\\bKbqStepper\\b|\\bkbqStepper\\b|<kbq-stepper\\b',
+            pattern: '(?<!\\bthis)\\??\\.connectTo\\s*\\(',
+            message: '`KbqStepper.connectTo()` was removed: it did nothing, the stepper finds the number input of its ' +
+                'form field by itself. Delete the call.'
+        },
+        {
+            anchor: '\\bKbqInputPassword\\b|\\bkbqInputPassword\\b',
+            pattern: '\\.checkRules\\s*\\(|\\.checkRule\\.(?:next|subscribe|pipe|complete)\\b',
+            message: '`KbqInputPassword.checkRules()` and `checkRule` were removed together with `KbqPasswordHint`, ' +
+                'their only listener. `KbqReactivePasswordHint` follows the validators of the control: after ' +
+                'changing a rule, call `control.updateValueAndValidity()`.'
+        }
+    ]
+};
+
+const CHECKBOX = '@koobiq/components/checkbox';
+// A call on `this` is the consumer's own `ControlValueAccessor`, not a checkbox or toggle.
+const NOT_ON_THIS = '(?<!\\bthis)\\??';
+/** The rest of a named import or re-export clause of the checkbox entry point. */
+const CHECKBOX_CLAUSE_END = `(?=[^}]*\\}\\s*from\\s*['"]${CHECKBOX}['"])`;
+/**
+ * Removed in 21.0.0: the unused ControlValueAccessor members of KbqCheckbox and KbqToggleComponent, and the
+ * re-export of `TransitionCheckState` from the checkbox entry point. Also reports
+ * `KbqToggleComponent.onLabelTextChange()`, deprecated for removal in 22.0.0.
+ */
+const formsControls = {
+    tsReplacements: [
+        {
+            // The specifier, with one of its commas; an emptied clause is dropped by `removeImport`.
+            from: `(?<=import\\s*(?:type\\s*)?\\{[^}]*)${listItemPattern.listItemPattern('\\bTransitionCheckState\\b(?!\\s+as\\b)')}${CHECKBOX_CLAUSE_END}`,
+            to: '',
+            removeImport: { symbol: 'TransitionCheckState', from: CHECKBOX },
+            ensureImport: { symbol: 'TransitionCheckState', from: '@koobiq/components/core' }
+        }
+    ],
+    warnPatterns: [
+        {
+            pattern: '\\bKBQ_CHECKBOX_CONTROL_VALUE_ACCESSOR\\b',
+            message: 'KBQ_CHECKBOX_CONTROL_VALUE_ACCESSOR was removed: KbqCheckbox is not a ControlValueAccessor any more, ' +
+                'the KbqCheckable host directive registers itself as the value accessor of kbq-checkbox. Drop the ' +
+                'provider; [(ngModel)] and [formControl] work without it. Manual migration required.'
+        },
+        {
+            anchor: '\\bKbqCheckbox\\b|\\bKbqToggleComponent\\b|<kbq-(?:checkbox|toggle)\\b',
+            pattern: `${NOT_ON_THIS}\\.(?:writeValue|registerOnChange|registerOnTouched|setDisabledState)\\b`,
+            message: 'KbqCheckbox and KbqToggleComponent no longer implement ControlValueAccessor: their writeValue(), ' +
+                'registerOnChange(), registerOnTouched() and setDisabledState() were removed, the KbqCheckable ' +
+                'host directive is the value accessor. On a checkbox or toggle, replace writeValue(v) with ' +
+                'checked = !!v, setDisabledState(v) with disabled = v and registerOnChange(fn) with the (change) ' +
+                'output; bind [formControl] / [(ngModel)] to track touched, or call them on the host KbqCheckable ' +
+                '(viewChild(KbqCheckbox, { read: KbqCheckable })). Manual migration required.'
+        },
+        {
+            anchor: '\\bKbqCheckbox\\b|<kbq-checkbox\\b',
+            pattern: `${NOT_ON_THIS}\\.onTouched\\b`,
+            message: 'KbqCheckbox.onTouched was removed: forms never called it, the KbqCheckable host directive ' +
+                'tracks touched. Drop the call or assignment and read touched from the bound [formControl] / ' +
+                '[(ngModel)]. Manual migration required.'
+        },
+        {
+            anchor: `\\bKbqToggleComponent\\b|<kbq-toggle\\b|["']kbqToggle["']`,
+            pattern: `${NOT_ON_THIS}\\.onLabelTextChange\\s*\\(`,
+            message: 'KbqToggleComponent.onLabelTextChange() does nothing now and is deprecated for removal in 22.0.0: ' +
+                'the toggle reads nothing from its label, so a change of it needs no re-check. Delete the call.'
+        },
+        {
+            // Protected, so only a subclass reaches it; a read that is already a call is migrated.
+            anchor: '\\bextends\\s+KbqToggleComponent\\b',
+            pattern: '\\bcurrentCheckState\\b(?!\\s*\\()',
+            message: 'KbqToggleComponent.currentCheckState is a Signal<TransitionCheckState> now, shared with the host ' +
+                'KbqCheckable: read it as currentCheckState(). It is read-only; a transition goes through the ' +
+                'checked and indeterminate setters. Manual migration required.'
+        },
+        {
+            // A plain named import is moved by the rewrite above.
+            pattern: `\\bTransitionCheckState\\s+as\\s+\\w+${CHECKBOX_CLAUSE_END}` +
+                `|\\bexport\\s*(?:type\\s*)?\\{[^}]*\\bTransitionCheckState\\b${CHECKBOX_CLAUSE_END}` +
+                `|import\\s*\\*\\s*as\\s+(\\w+)\\s+from\\s*['"]${CHECKBOX}['"][\\s\\S]*\\b\\1\\.TransitionCheckState\\b`,
+            message: 'TransitionCheckState is no longer exported from @koobiq/components/checkbox: import or re-export ' +
+                'it from @koobiq/components/core.'
+        }
+    ]
+};
+
+// An opening tag that carries the brand directive, as an element or an attribute, wherever it sits in the tag.
+const BRAND_TAG = `<(?=${tagPatterns.TAG_BODY}*?\\bkbq-navbar-brand(?![\\w-]))${tagPatterns.TAG_BODY}*?`;
+// An opening `<kbq-dl>` tag that does not set `verticalBreakpoint` as well, which would end up bound twice.
+const DL_TAG_WITHOUT_BREAKPOINT = `<kbq-dl(?![\\w-])(?!${tagPatterns.TAG_BODY}*\\bverticalBreakpoint\\b)${tagPatterns.TAG_BODY}*?\\s`;
+const QUOTED_VALUE = '(?:"[^"]*"|\'[^\']*\')';
+const NUMBER = '\\s*[+-]?(?:\\d+(?:\\.\\d*)?|\\.\\d+)(?:[eE][+-]?\\d+)?\\s*';
+const QUOTED_NUMBER = `(?:"${NUMBER}"|'${NUMBER}')`;
+const LOADER_OVERLAY_DEPRECATED = '`transparent` and `card` of `<kbq-loader-overlay>` are deprecated and will be removed in 22.0.0: set ' +
+    '`surface` instead, `bg` (or `bg-secondary`, `bg-tertiary`) for a transparent overlay, `solid` for an opaque ' +
+    'one and `card` for `card`.';
+/**
+ * Removed in 21.0.0: KbqNavbarBrand.longTitle, KbqNavbarItem.getTitleWidth (with KbqNavbarTitle.outerElementWidth,
+ * which only fed it), the ellipsis center resizeStream and KbqDlComponent.minWidth. Also reports `transparent` and
+ * `card` of the loader overlay, deprecated for removal in 22.0.0.
+ */
+const navbarAndLayout = {
+    templateReplacements: [
+        // `longTitle` on the brand: the two-line title is detected automatically, so the binding is dropped.
+        { from: `(${BRAND_TAG})\\s+\\[longTitle\\]\\s*=\\s*${QUOTED_VALUE}`, to: '$1' },
+        { from: `(${BRAND_TAG})\\s+longTitle\\s*=\\s*${QUOTED_VALUE}`, to: '$1' },
+        { from: `(${BRAND_TAG})\\s+longTitle(?=[\\s/>])(?!\\s*=)`, to: '$1' },
+        // `minWidth` on `kbq-dl` was an alias of `verticalBreakpoint`.
+        { from: `(${DL_TAG_WITHOUT_BREAKPOINT})\\[minWidth\\](?=\\s*=)`, to: '$1[verticalBreakpoint]' },
+        { from: `(${DL_TAG_WITHOUT_BREAKPOINT})minWidth(?=\\s*=\\s*["'])`, to: '$1verticalBreakpoint' }
+    ],
+    warnPatterns: [
+        {
+            anchor: '\\bkbq-navbar-brand\\b',
+            pattern: `${BRAND_TAG}\\s(?:\\[longTitle\\]|longTitle)(?![\\w-])`,
+            message: '`KbqNavbarBrand.longTitle` was removed and its binding dropped: the brand switches to the ' +
+                'two-line title by itself when the title does not fit on one line. A forced `true` or `false` ' +
+                'has no replacement.'
+        },
+        {
+            anchor: '\\bKbqNavbarBrand\\b|["\']kbqNavbarBrand["\']',
+            pattern: '\\.longTitle\\s*\\(|setInput\\(\\s*["\']longTitle["\']',
+            message: '`KbqNavbarBrand.longTitle` was removed: the two-line title is detected automatically. Drop the ' +
+                'read or write; nothing replaces it.'
+        },
+        {
+            anchor: '\\bKbqNavbarItem\\b|["\']kbqNavbarItem["\']',
+            pattern: '\\.getTitleWidth\\s*\\(',
+            message: '`KbqNavbarItem.getTitleWidth()` was removed: the navbar collapses items by ' +
+                '`getCollapsibleWidth()`. To measure the title, call `getOuterElementWidth()` on its `KbqNavbarTitle`.'
+        },
+        {
+            anchor: '\\bKbqNavbarTitle\\b',
+            pattern: '\\.outerElementWidth\\b',
+            message: '`KbqNavbarTitle.outerElementWidth` was removed: call `getOuterElementWidth()`, which measures ' +
+                'the title when called instead of once on init.'
+        },
+        {
+            anchor: '\\bKbqEllipsisCenterDirective\\b',
+            pattern: '\\.resizeStream\\b',
+            message: '`KbqEllipsisCenterDirective.resizeStream` was removed: nothing read it. Drop the call; the ' +
+                'shared `ResizeObserver` re-measures the host, container-only resizes included.'
+        },
+        {
+            // Reported rather than rewritten to `(value) ?? 400`: under `strictTemplates`, NG8102 flags `??` on a
+            // value that cannot be nullish, which most bound values are.
+            anchor: '<kbq-dl(?![\\w-])',
+            pattern: `${DL_TAG_WITHOUT_BREAKPOINT}(?:\\[minWidth\\]|minWidth)\\s*=\\s*(?!${QUOTED_NUMBER})["']`,
+            message: '`minWidth` of `<kbq-dl>` was renamed to `verticalBreakpoint`. A value that is not a number, such ' +
+                'as `null`, `undefined`, `""` or `700px`, made `minWidth` fall back to the default 400, while ' +
+                '`verticalBreakpoint` reads it as `NaN` and never switches to the vertical layout: make sure the ' +
+                'value is always a number, for example `[verticalBreakpoint]="width ?? 400"`.'
+        },
+        {
+            anchor: '<kbq-dl(?![\\w-])',
+            pattern: `<kbq-dl(?![\\w-])(?=${tagPatterns.TAG_BODY}*\\bverticalBreakpoint\\b)${tagPatterns.TAG_BODY}*\\s\\[?minWidth\\b`,
+            message: '`minWidth` was removed from `<kbq-dl>` and is left as is where `verticalBreakpoint` is set too. ' +
+                'It took precedence, so move its value into `verticalBreakpoint` and delete it.'
+        },
+        {
+            anchor: '\\bKbqDlComponent\\b',
+            pattern: '\\.minWidth\\s*\\(|setInput\\(\\s*["\']minWidth["\']',
+            message: '`KbqDlComponent.minWidth` was removed: read and set `verticalBreakpoint` instead. It defaults ' +
+                'to 400, where an unset `minWidth` read `undefined`.'
+        },
+        {
+            anchor: '<kbq-loader-overlay(?![\\w-])',
+            pattern: `<kbq-loader-overlay(?![\\w-])${tagPatterns.TAG_BODY}*\\s\\[?(?:transparent|card)(?![\\w-])`,
+            message: LOADER_OVERLAY_DEPRECATED
+        },
+        {
+            anchor: '\\bKbqLoaderOverlay\\b',
+            pattern: '\\.(?:transparent|card)\\s*\\(|setInput\\(\\s*["\'](?:transparent|card)["\']',
+            message: LOADER_OVERLAY_DEPRECATED
+        }
+    ]
+};
+
+/** The removed unprefixed `KbqPopoverTrigger` inputs and the `kbqPopover…` inputs that replace them. */
+const RENAMED_INPUTS = {
+    hideIfNotInViewPort: 'kbqPopoverHideIfNotInViewPort',
+    defaultPaddings: 'kbqPopoverDefaultPaddings',
+    container: 'kbqPopoverContainer',
+    hasBackdrop: 'kbqPopoverHasBackdrop',
+    hasCloseButton: 'kbqPopoverHasCloseButton',
+    closeOnScroll: 'kbqPopoverCloseOnScroll',
+    backdropClass: 'kbqPopoverBackdropClass'
+};
+/**
+ * Renames `[name]=`, `name=` and a bare `name` on an element that carries `kbqPopover` or `kbqPopoverConfirm`,
+ * wherever that attribute stands in the tag. Other components (sidepanel, dropdown, select, …) have inputs of
+ * the same names, so an element without the trigger is left alone.
+ */
+function popoverInput(name, replacement) {
+    return {
+        from: `(<[a-zA-Z][\\w-]*(?=${tagPatterns.TAG_BODY}*[\\s\\[]kbqPopover)${tagPatterns.TAG_BODY}*?\\s\\[?)${name}(?=\\]?\\s*=|[\\s/>])`,
+        to: `$1${replacement}`
+    };
+}
+/** Removed in 21.0.0: the unprefixed KbqPopoverTrigger aliases and getKbqPopoverInvalidPositionError. */
+const popover = {
+    templateReplacements: Object.entries(RENAMED_INPUTS).map(([name, replacement]) => popoverInput(name, replacement)),
+    warnPatterns: [
+        {
+            anchor: '@koobiq/components/popover',
+            pattern: '\\bgetKbqPopoverInvalidPositionError\\b',
+            message: '`getKbqPopoverInvalidPositionError` was removed: an invalid popover placement is not an error, ' +
+                'it is reported with a console warning and falls back to `top`. Delete the call and its import.'
+        },
+        {
+            anchor: '\\bKbqPopover(?:Confirm)?Trigger\\b|["\']kbqPopover(?:Confirm)?["\']',
+            pattern: '\\.hideIfNotInViewPort\\b',
+            message: '`KbqPopoverTrigger.hideIfNotInViewPort` was removed: read `popoverHideIfNotInViewPort()`, the ' +
+                'signal of the `kbqPopoverHideIfNotInViewPort` input.'
+        },
+        {
+            pattern: '\\bdirective:\\s*KbqPopover(?:Confirm)?Trigger\\b[^}]*\\binputs:\\s*\\[[^\\]]*["\'](?:' +
+                Object.keys(RENAMED_INPUTS).join('|') +
+                ')\\b',
+            message: 'A `hostDirectives` entry of `KbqPopoverTrigger` exposes an unprefixed input that was removed. ' +
+                "Expose the `kbqPopover…` input instead: `'kbqPopoverHasBackdrop: hasBackdrop'` keeps the host's " +
+                'binding name.'
+        }
+    ]
+};
+
+const NOTIFICATION_CENTER_FLAGS = '(?:silentMode|loadingMode|errorMode|loadingMore|loadMoreErrorMode|hasMore)';
+// `.value` / `.getValue()` / `.next()` / `.subscribe()` / `.pipe()` right after the member: what a subject allowed.
+const SUBJECT_ACCESS = '\\s*\\.\\s*(?:value\\b|getValue\\s*\\(|next\\s*\\(|subscribe\\s*\\(|pipe\\s*\\()';
+/**
+ * 21.0.0 turned the state components and services expose for reading into signals. A read cannot be rewritten
+ * safely (a signal is called, a subject was subscribed to), so every use is reported.
+ */
+const stateSignals = {
+    warnPatterns: [
+        {
+            anchor: '@koobiq/components/notification-center',
+            pattern: `\\b${NOTIFICATION_CENTER_FLAGS}${SUBJECT_ACCESS}`,
+            message: 'The flags of `KbqNotificationCenterService` (`silentMode`, `loadingMode`, `errorMode`, `loadingMore`, ' +
+                '`loadMoreErrorMode`, `hasMore`) are signals: read `service.silentMode()`, write with the matching ' +
+                '`set…()` method, and wrap one in `toObservable()` where a stream is needed.'
+        },
+        {
+            anchor: 'kbqNotificationCenter|KbqNotificationCenter',
+            pattern: `\\b${NOTIFICATION_CENTER_FLAGS}\\s*\\|\\s*async\\b`,
+            message: 'The flags of `KbqNotificationCenterService` are signals: bind `service.silentMode()` instead of ' +
+                'piping them through `async`.'
+        },
+        {
+            pattern: '\\bunreadItemsCounter\\s*\\|\\s*async\\b',
+            message: '`unreadItemsCounter` of the notification center service and trigger is a signal: bind ' +
+                '`trigger.unreadItemsCounter()`, and drop `AsyncPipe` from the imports if nothing else uses it.'
+        },
+        {
+            anchor: '@koobiq/components/notification-center',
+            pattern: '\\b(?:unreadItemsCounter|groupedItems)\\s*\\.\\s*(?:subscribe|pipe)\\s*\\(',
+            message: '`unreadItemsCounter` and `groupedItems` of `KbqNotificationCenterService` are signals: read ' +
+                '`service.unreadItemsCounter()`, or wrap one in `toObservable()` where a stream is needed.'
+        },
+        {
+            anchor: 'kbqNotificationCenter|KbqNotificationCenter',
+            pattern: '\\bgroupedItems\\s*\\|\\s*async\\b',
+            message: '`KbqNotificationCenterService.groupedItems` is a signal: bind `service.groupedItems()`.'
+        },
+        {
+            anchor: '\\bKbqNotificationCenterService\\b',
+            pattern: '\\.\\s*changes\\s*\\.\\s*(?:subscribe|pipe)\\s*\\(',
+            message: 'If this subscribes to `KbqNotificationCenterService.changes`: it no longer emits on subscription. ' +
+                'A handler that relied on running then has to run once on its own before subscribing.'
+        },
+        {
+            anchor: '@koobiq/components/toast',
+            pattern: `\\b(?:hovered|focused)${SUBJECT_ACCESS}`,
+            message: '`hovered` and `focused` of `KbqToastService` and `KbqToastComponent` are read-only signals: read ' +
+                '`toastService.hovered()`; a subclass of the toast sets its hover state with `setHovered()`.'
+        },
+        {
+            // `KbqDropdownItem.hovered` stays an event stream, so the anchor names the pop-ups and their triggers.
+            anchor: '\\b(?:KbqPopUp|KbqPopUpTrigger|KbqTooltip(?:Component|Trigger)|KbqPopover(?:Confirm)?(?:Component|Trigger)|' +
+                'KbqNotificationCenter(?:Component|Trigger)|KbqAppSwitcher(?:Component|Trigger)|KbqTitleDirective|' +
+                'KbqEllipsisCenterDirective|KbqPasswordToggle)\\b',
+            pattern: `\\bhovered${SUBJECT_ACCESS}|\\bhovered\\s*\\.\\s*complete\\s*\\(`,
+            message: 'If this uses `hovered` of a pop-up or its trigger (tooltip, popover, notification center, app ' +
+                'switcher): it is a read-only signal. Read `hovered()`, wrap it in `toObservable()` where a stream ' +
+                'is needed; a subclass sets it with `this.setHovered(value)`.'
+        },
+        {
+            anchor: '@koobiq/components/filter-bar',
+            pattern: '\\.filteredOptions\\s*(?:\\.\\s*(?:subscribe|pipe)\\s*\\(|=(?!=))',
+            message: '`filteredOptions` of `KbqFilters`, `KbqPipeSelectComponent` and `KbqPipeMultiSelectComponent` is a ' +
+                'read-only signal: read `filteredOptions()`, and filter through the search control or the inputs.'
+        },
+        {
+            anchor: 'kbq-filters|kbqFilters|kbq-pipe',
+            pattern: '\\bfilteredOptions\\s*\\|\\s*async\\b',
+            message: '`filteredOptions` of the filter bar is a signal: bind `filteredOptions()`.'
+        },
+        {
+            anchor: '\\bextends\\s+KbqPipeSelectComponent\\b',
+            pattern: '\\bsuper\\s*\\.\\s*ngOnInit\\s*\\(',
+            message: '`KbqPipeSelectComponent` no longer implements `ngOnInit`: remove the `super.ngOnInit()` call.'
+        },
+        {
+            anchor: '\\bextends\\s+KbqPipeDate(?:Base|time)?Component\\b',
+            pattern: '\\bthis\\.(?:isListMode|showStartCalendar|showEndCalendar)\\b(?!\\s*\\(|\\.set\\s*\\()',
+            message: '`isListMode`, `showStartCalendar` and `showEndCalendar` of the date pipes are signals: read ' +
+                '`this.isListMode()` and write `this.isListMode.set(value)`.'
+        },
+        {
+            anchor: '\\bextends\\s+KbqPipeDate(?:Base|time)?Component\\b',
+            pattern: '\\bthis\\.returnButton\\s*\\(\\s*\\)\\s*\\.',
+            message: '`returnButton` of the date pipes may be `undefined`: the back button renders only when the pipe ' +
+                'template has `values`. Read it with `this.returnButton()?.`.'
+        },
+        {
+            anchor: 'kbq-date-period',
+            pattern: '\\(keydown\\.tab\\)\\s*=\\s*"hideCalendars\\(\\)"',
+            message: 'Bind `(keydown.tab)` and `(keydown.shift.tab)` of the date inputs of a date pipe template to ' +
+                '`onDateInputTab()`: it hides the calendars before the browser moves the focus, which ' +
+                '`hideCalendars()` no longer does without zone.js, so Tab lands in the calendar being hidden.'
+        },
+        {
+            anchor: '@koobiq/components/select',
+            pattern: '\\.hiddenItems\\b(?!\\s*\\()',
+            message: 'If this reads `KbqSelect.hiddenItems`: it is a read-only signal, as in `KbqTreeSelect`. Read ' +
+                '`select.hiddenItems()`.'
+        },
+        {
+            anchor: '<kbq-select\\b',
+            pattern: '\\bhiddenItems\\b(?!\\s*\\()',
+            message: 'If this reads `hiddenItems` of a `kbq-select`: it is a read-only signal, as in `KbqTreeSelect`. Bind ' +
+                '`select.hiddenItems()`.'
+        },
+        {
+            anchor: '@koobiq/components/search-expandable|<kbq-search-expandable\\b',
+            pattern: '\\.value\\s*\\.\\s*(?:next|getValue|subscribe|pipe|asObservable|value)\\b',
+            message: 'If this uses `KbqSearchExpandable.value`: it is a `WritableSignal<string>`. Read `value()`, write ' +
+                '`value.set(text)`, and use an `effect()` or `toObservable()` instead of subscribing.'
+        },
+        {
+            anchor: '\\bextends\\s+KbqDatepickerToggleIconComponent\\b',
+            pattern: '\\bsuper\\s*\\.\\s*(?:ngAfterContentInit|ngOnDestroy)\\s*\\(',
+            message: '`KbqDatepickerToggleIconComponent` no longer implements `ngAfterContentInit` and `ngOnDestroy`: ' +
+                'remove the `super` calls.'
+        }
+    ]
+};
+
+/** An `@include` of a mixin that takes no arguments any more, through a module namespace or not. */
+const ARGUMENTLESS_MIXIN = '(@include\\s+(?:[\\w-]+\\.)?(?:koobiq-theme|koobiq-typography|kbq-core-theme))';
+const LIGHT_AND_DARK_THEMES = {
+    from: '(@koobiq/components/prebuilt-themes/)(?:light|dark)-theme\\.css',
+    to: '$1theme.css'
+};
+/** A line that loads a style sheet: `@use`, `@import`, `@forward`, `<link>`, or a side-effect `import '…'`. */
+const LOAD_LINE = `[ \\t]*(?:@(?:use|import|forward)\\s|<link\\s|import\\s*['"])[^\\r\\n]*`;
+/** A line an import block holds besides the loads: a blank line or a one-line comment. */
+const IMPORT_BLOCK_LINE = `(?:${LOAD_LINE}|[ \\t]*(?://[^\\r\\n]*|/\\*.*?\\*/|<!--.*?-->)?[ \\t]*)`;
+/**
+ * Drops a line that repeats an earlier line loading `theme.css` in the same import block, as a file that loaded
+ * both themes is left with. Only a load followed by loads, blank lines and comments: anywhere else the two lines
+ * stand in different branches, such as the cases of a `switch` or two `@media` blocks.
+ */
+const REPEATED_THEME_LINE = {
+    from: `(?<=^|\\n)(${LOAD_LINE}@koobiq/components/prebuilt-themes/theme\\.css[^\\r\\n]*)` +
+        `((?:\\r?\\n${IMPORT_BLOCK_LINE})*?)\\r?\\n\\1(?=\\r?\\n|$)`,
+    to: '$1$2'
+};
+const MARKDOWN_CLASS = '(h[1-6]|body-mono|body|caption|table-cell|table-header)';
+/** A markdown typography class used as a selector: in a style sheet, an inline `<style>`, `[class.…]`, a query. */
+const MARKDOWN_CLASS_SELECTOR = {
+    from: `\\.md-${MARKDOWN_CLASS}(?![\\w-])`,
+    to: '.kbq-md-$1'
+};
+/** The `kbq-scrollbar` class token: not the `<kbq-scrollbar>` element, nor a class that starts with it. */
+const SCROLLBAR_CLASS = 'kbq-scrollbar(?![\\w-])';
+const QUOTED_SCROLLBAR_CLASS = `['"\`]${SCROLLBAR_CLASS}['"\`]`;
+/**
+ * Removed in 21.0.0: the arguments of `koobiq-theme()`, `koobiq-typography()` and `kbq-core-theme()`,
+ * `kbq-contrast()`, `kbq-palette()`, `kbq-color()`, `kbq-typography-config()`, `core/styles/tokens`, the prebuilt
+ * `light-theme.css` and `dark-theme.css`, the unprefixed markdown typography classes (`md-h1`, …), and the Sass
+ * modules, mixins, functions and timing variables nothing in the library used. Also reports, deprecated for removal
+ * in 22.0.0, `kbq-light-theme()`, `kbq-dark-theme()`, the `kbq-scrollbar` class with `kbq-scrollbar-theme()`, and
+ * the `--kbq-scrollbar-*` variables of that class the new scrollbar does not share.
+ */
+const styles = {
+    templateReplacements: [
+        LIGHT_AND_DARK_THEMES,
+        REPEATED_THEME_LINE,
+        {
+            from: `(?<=(?<![\\w-])class\\s*=\\s*(?:"[^"]*|'[^']*))(?<![\\w-])md-${MARKDOWN_CLASS}(?![\\w-])`,
+            to: 'kbq-md-$1'
+        },
+        MARKDOWN_CLASS_SELECTOR
+    ],
+    scssReplacements: [
+        { from: `${ARGUMENTLESS_MIXIN}\\([^(){};]*\\)`, to: '$1()' },
+        LIGHT_AND_DARK_THEMES,
+        REPEATED_THEME_LINE,
+        MARKDOWN_CLASS_SELECTOR
+    ],
+    styleEntryReplacements: [LIGHT_AND_DARK_THEMES],
+    warnPatterns: [
+        {
+            pattern: `${ARGUMENTLESS_MIXIN}\\((?=[^(){};]*\\()`,
+            message: '`koobiq-theme()`, `koobiq-typography()` and `kbq-core-theme()` take no arguments any more, as they ' +
+                'ignored them: remove the arguments, and the theme or typography map built only for them.'
+        },
+        {
+            pattern: '(?<![\\w-])kbq-(?:contrast|palette|color)\\(',
+            message: '`kbq-contrast()`, `kbq-palette()` and `kbq-color()` were removed from the theming module: use the ' +
+                'CSS variables of the theme instead, for example `var(--kbq-foreground-contrast)`.'
+        },
+        {
+            pattern: '(?<![\\w-])kbq-(?:light|dark)-theme\\(',
+            message: '`kbq-light-theme()` and `kbq-dark-theme()` are deprecated and will be removed in 22.0.0: nothing in the ' +
+                'library reads the theme map they build. Use the CSS variables of the theme instead, for example ' +
+                '`var(--kbq-foreground-contrast)`.'
+        },
+        {
+            pattern: 
+            // A selector, `[class.kbq-scrollbar]` or a query.
+            `\\.${SCROLLBAR_CLASS}` +
+                // A `class` attribute, a `[class]` binding or a `class` host property.
+                `|(?<![\\w-])['"]?class\\]?['"]?\\s*[=:]\\s*(?:"[^"]*|'[^']*|\`[^\`]*)(?<![\\w-])${SCROLLBAR_CLASS}` +
+                // `classList.add()`, `Renderer2.addClass()`, an `[ngClass]` key.
+                `|(?:classList\\.\\w+|(?:add|remove)Class)\\([^()]*${QUOTED_SCROLLBAR_CLASS}` +
+                `|${QUOTED_SCROLLBAR_CLASS}\\s*:` +
+                '|(?<![\\w-])kbq-scrollbar-theme\\(',
+            message: 'The `kbq-scrollbar` class and its `kbq-scrollbar-theme()` mixin are deprecated and will be removed ' +
+                'in 22.0.0, and no library component carries the class any more: put `kbqNativeScrollbar` on the ' +
+                'element that scrolls, with `kbqNativeScrollbarDescendants` to style the scrollbars inside it as the ' +
+                'class did, or wrap the content in `<kbq-scrollbar>` (both from `@koobiq/components/scrollbar`).'
+        },
+        {
+            pattern: '(?<![\\w-])--kbq-scrollbar-(?:size-(?:track-(?:dimension|padding-(?:vertical|horizontal))|' +
+                'thumb-(?:width|min-size|border-radius))|thumb-disabled-background|' +
+                'track-(?:default|hover|active)-(?:background|border))(?![\\w-])',
+            message: 'The `--kbq-scrollbar-size-*`, `--kbq-scrollbar-thumb-disabled-background` and ' +
+                '`--kbq-scrollbar-track-{default,hover,active}-{background,border}` variables are deprecated and ' +
+                'will be removed in 22.0.0: only the `kbq-scrollbar` class and the `KbqScrollbar` of ' +
+                '`@koobiq/components/scrollbar/deprecated` read them. The new scrollbar reads ' +
+                '`--kbq-scrollbar-track-size` for the track dimension, `--kbq-scrollbar-thumb-gap` (the gap on each ' +
+                'side of the thumb) for the thumb width, `--kbq-scrollbar-thumb-min-size` and ' +
+                '`--kbq-scrollbar-track-background`; the others have no counterpart.'
+        },
+        {
+            pattern: '(?<![\\w-])kbq-typography-config\\(',
+            message: '`kbq-typography-config()` was removed: use the typography CSS variables (`--kbq-typography-*`) or ' +
+                'the `kbq-typography-level-to-styles-css-variables()` mixin of `core/styles/common/tokens`.'
+        },
+        {
+            pattern: '@(?:use|import|forward)\\s+[\'"](?:~|[^\'"]*node_modules/)?@koobiq/components/core/styles/_?tokens' +
+                '(?:\\.scss)?[\'"]',
+            message: '`@koobiq/components/core/styles/tokens` was removed: load what it forwarded from the design tokens ' +
+                'package directly — `@koobiq/design-tokens/web/variables`, `/palette`, `/typography` or ' +
+                '`/md-typography` — or use the CSS variables (`var(--kbq-…)`).'
+        },
+        {
+            pattern: '@(?:use|import|forward)\\s+[\'"](?:~|[^\'"]*node_modules/)?@koobiq/components/core/styles/' +
+                '(?:functions(?:/_?(?:index|number|string))?|typography/_?typography-utils|common/_?(?:clearfix|popup))' +
+                '(?:\\.scss)?[\'"]',
+            message: 'The Sass modules `core/styles/functions` (its index, `number` and `string`), ' +
+                '`core/styles/typography/typography-utils`, `core/styles/common/clearfix` and ' +
+                '`core/styles/common/popup` were removed: nothing in the library used them. Copy what you need ' +
+                'into your own styles; for typography, use the `--kbq-typography-*` CSS variables.'
+        },
+        {
+            pattern: '(?<![\\w-])(?:kbq-markdown-typography-config|kbq-typography-level|kbq-typography-level-to-styles|' +
+                'kbq-font-(?:size|family|weight|style|feature-settings)|kbq-line-height|kbq-letter-spacing|' +
+                'kbq-text-transform|rtl-value)\\(|(?<![\\w-])(?:popup-params|input-placeholder|' +
+                'kbq-typography-css-variables)(?![\\w-])',
+            message: '`kbq-markdown-typography-config()`, the getters of `typography-utils` (`kbq-typography-level()`, ' +
+                '`kbq-typography-level-to-styles()`, `kbq-font-size()`…), `popup-params`, `input-placeholder`, ' +
+                '`rtl-value()` and `kbq-typography-css-variables` were removed: nothing in the library used them. ' +
+                'Use the `--kbq-typography-*` CSS variables, `kbq-typography-level-to-styles-css-variables()` of ' +
+                '`core/styles/common/tokens`, `::placeholder`, or copy the mixin into your own styles.'
+        },
+        {
+            anchor: '@koobiq/components/core/styles/functions',
+            pattern: '(?<![\\w-])\\$ease-(?!out-circ(?![\\w-])|in-out-quad(?![\\w-])|in-out-circ(?![\\w-]))' +
+                '(?:in|out|in-out)-(?:quad|cubic|quart|quint|sine|expo|circ|back)(?![\\w-])',
+            message: 'Of the timing variables of `core/styles/functions/timing`, only `$ease-out-circ`, ' +
+                '`$ease-in-out-quad` and `$ease-in-out-circ` remain: copy the `cubic-bezier()` of the others.'
+        },
+        {
+            pattern: `(?<=['"\`][^'"\`\\n]*)(?<![\\w.-])(?<!(?<![\\w-])class\\s*=\\s*(?:"[^"]*|'[^']*))md-${MARKDOWN_CLASS}` +
+                '(?![\\w-])',
+            message: 'The unprefixed markdown typography classes (`md-h1`…`md-h6`, `md-body`, `md-body-mono`, ' +
+                '`md-caption`, `md-table-cell`, `md-table-header`) were removed: use the `kbq-md-` class of the ' +
+                'same name, for example `kbq-md-h1`.'
+        }
+    ]
+};
+
+// A file that names the directive class or reaches it through its `exportAs`.
+const TAG_INPUT_ANCHOR = '\\bKbqTagInput\\b|["\']kbqTagInput(?:For)?["\']';
+/**
+ * Removed in 21.0.0: the unused validation members of KbqTagInput and KbqTagTextControl. Neither has a
+ * replacement to rewrite to, so both are reported. KbqTagTextControl is not exported, so its member is not.
+ */
+const tags = {
+    warnPatterns: [
+        // `this.ngControl` is a component's own control and `tagList.ngControl` the one that stays.
+        {
+            anchor: TAG_INPUT_ANCHOR,
+            pattern: '(?<!\\bthis|[Ll]ist(?:\\(\\))?[!?]?)\\.ngControl\\b',
+            message: '`KbqTagInput.ngControl` was removed. Read the control you bound to the input with ' +
+                '`[formControl]`/`[ngModel]` directly; validation belongs to the `<kbq-tag-list>` control.'
+        },
+        {
+            anchor: TAG_INPUT_ANCHOR,
+            pattern: '(?<!\\bthis)\\.triggerValidation\\s*\\(',
+            message: '`KbqTagInput.triggerValidation()` was removed: it was a no-op. Delete the call; the ' +
+                '`<kbq-tag-list>` control revalidates itself whenever its value changes.'
+        },
+        {
+            anchor: '\\bextends\\s+KbqTagInput\\b',
+            pattern: '\\b(?:ngControl|triggerValidation)\\b',
+            message: '`KbqTagInput` no longer declares `ngControl` and `triggerValidation()`. A subclass that reads ' +
+                'or overrides them injects `NgControl` itself or drops the override.'
+        }
+    ]
+};
+
+const MARGIN_TOP = String.raw `(?<![\w-])--kbq-toast-stack-size-margin-top(?![\w-])`;
+const MARGIN_RIGHT = String.raw `(?<![\w-])--kbq-toast-stack-size-margin-right(?![\w-])`;
+const MARGIN_REPLACEMENTS = [
+    { from: MARGIN_TOP, to: '--kbq-toast-stack-size-margin-vertical' },
+    { from: MARGIN_RIGHT, to: '--kbq-toast-stack-size-margin-horizontal' }
+];
+// A declaration of one of the properties, as opposed to a `var()` that reads it.
+const declaration = (names) => String.raw `(?<![\w-])--kbq-toast-stack-size-margin-(?:${names})\s*:`;
+/**
+ * Removed in 21.0.0: `KbqToastContainerComponent.dispatchScrollEvent` and the
+ * `--kbq-toast-stack-size-margin-top` / `-right` custom properties.
+ */
+const toast = {
+    // Style bindings and `setProperty()` calls name the properties too.
+    templateReplacements: MARGIN_REPLACEMENTS,
+    scssReplacements: MARGIN_REPLACEMENTS,
+    warnPatterns: [
+        {
+            anchor: String.raw `\bKbqToastContainerComponent\b|<kbq-toast-container(?![\w-])`,
+            pattern: String.raw `\bdispatchScrollEvent\b`,
+            message: 'KbqToastContainerComponent.dispatchScrollEvent was removed: the container reports its own ' +
+                'reflow through `elementScrolled()`, so overlays anchored in a toast reposition without it. ' +
+                'Delete the call.'
+        },
+        {
+            anchor: declaration('top|right'),
+            pattern: declaration('vertical|horizontal'),
+            message: '--kbq-toast-stack-size-margin-top and -right were renamed to -vertical and -horizontal. This ' +
+                'file declares both a removed and a new name: the new one used to win, after the rewrite the ' +
+                'cascade decides. Keep one declaration of each.'
+        }
+    ]
+};
+
+/** The first constructor argument (one level of nested calls), followed by a second one. */
+const SECOND_ARGUMENT = '\\((?:[^(),]|\\([^()]*\\))+,\\s*[^\\s)]';
+const CONSTRUCTOR = '`KbqTreeOptionChange` takes only the option now: drop the second argument, the `isUserInput` it set was ' +
+    'removed.';
+/** Renames the `(from)` listener on an opening `<tag>` to `(to)`. */
+function renameOutput(tag, from, to) {
+    return { from: `(<${tag}(?![\\w-])${tagPatterns.TAG_BODY}*?\\s)\\(${from}\\)(?=\\s*=)`, to: `$1(${to})` };
+}
+/**
+ * Removed in 21.0.0: KbqTreeOptionChange.isUserInput and the constructor parameter that set it. Neither has a
+ * replacement, so both are reported. The `isUserInput` of the select and tree-select change events stays.
+ *
+ * Deprecated for removal in 22.0.0: the `onSelectAll` and `onCopy` outputs of KbqTreeSelection and the
+ * `onSelectionChange` output of KbqTreeOption, which emit the same events as their replacements, and
+ * KbqTreeNode.mostRecentTreeNode. The outputs of the same names on the list selection, the tree-select and
+ * KbqOption are not deprecated.
+ */
+const tree = {
+    templateReplacements: [
+        renameOutput('kbq-tree-selection', 'onSelectAll', 'selectAllChange'),
+        renameOutput('kbq-tree-selection', 'onCopy', 'copyChange'),
+        renameOutput('kbq-tree-option', 'onSelectionChange', 'selectionChange')
+    ],
+    warnPatterns: [
+        {
+            anchor: '\\bKbqTreeOptionChange\\b',
+            // `$event` in a template is the next pattern's.
+            pattern: '(?<!\\$event\\??)\\.isUserInput\\b',
+            message: '`KbqTreeOptionChange.isUserInput` was removed: the tree never set it, so it was always `false`. ' +
+                'If this `isUserInput` is read from a tree option change, delete the check together with the ' +
+                'branch it guarded.'
+        },
+        {
+            // Matched before the rename above, so the deprecated name counts too.
+            pattern: `<kbq-tree-option(?![\\w-])${tagPatterns.TAG_BODY}*?\\((?:onS|s)electionChange\\)\\s*=\\s*"[^"]*\\$event\\??\\.isUserInput\\b`,
+            message: '`KbqTreeOptionChange.isUserInput` was removed: the tree never set it, so `$event.isUserInput` of ' +
+                'a `kbq-tree-option` was always `false`. Delete the check together with the branch it guarded.'
+        },
+        { pattern: `\\bnew\\s+KbqTreeOptionChange\\s*${SECOND_ARGUMENT}`, message: CONSTRUCTOR },
+        {
+            anchor: '\\bextends\\s+KbqTreeOptionChange\\b',
+            pattern: `\\bsuper\\s*${SECOND_ARGUMENT}`,
+            message: CONSTRUCTOR
+        },
+        {
+            anchor: '\\bKbqTreeSelection\\b|["\']kbqTreeSelection["\']',
+            pattern: '\\.(?:onSelectAll|onCopy)\\b',
+            message: '`onSelectAll` and `onCopy` of `KbqTreeSelection` are deprecated and will be removed in 22.0.0: ' +
+                'use `selectAllChange` and `copyChange`, which emit the same events. The outputs of the same ' +
+                'names on `KbqListSelection` and `KbqTreeSelect` stay.'
+        },
+        {
+            anchor: '\\bKbqTreeOption\\b|["\']kbqTreeOption["\']',
+            pattern: '\\.onSelectionChange\\b',
+            message: '`KbqTreeOption.onSelectionChange` is deprecated and will be removed in 22.0.0: use ' +
+                '`selectionChange`, which emits the same event. The `onSelectionChange` of `KbqOption` stays.'
+        },
+        {
+            // The CDK tree node has a static of the same name.
+            anchor: '@koobiq/components/tree[\'"]',
+            pattern: '\\.mostRecentTreeNode\\b',
+            message: '`KbqTreeNode.mostRecentTreeNode` is deprecated and will be removed in 22.0.0: nothing in the ' +
+                'library reads it, and it held the node created last on the page, in any tree. Query the nodes ' +
+                'of the tree instead, for example with `viewChildren(KbqTreeOption)`.'
+        }
+    ]
+};
+
+/** A named import of one of `symbols` (a regex alternation) from the `entry` entry point. */
+const importedFrom = (entry, symbols) => String.raw `import\s*(?:type\s*)?\{[^}]*\b(?:${symbols})\b[^}]*\}\s*from\s*['"]@koobiq/components/${entry}['"]`;
+/** A class of the library that a subclass extends. */
+const extending = (classes) => String.raw `\bextends\s+(?:${classes})\b`;
+/** A member reached through `this` or `super`, as a subclass does. */
+const ownMember = (members) => String.raw `\b(?:this|super)[!?]?\.(?:${members})\b`;
+/**
+ * Removed in 21.0.0 without a deprecation: the component exports, members and template context fields nothing in
+ * the library used, with the classes of the legacy validate directive and `kbq-no-select`.
+ */
+const unusedApi = {
+    warnPatterns: [
+        {
+            pattern: importedFrom('input', 'normalizeSplitter|isInt|isDigit'),
+            message: 'normalizeSplitter(), isInt() and isDigit() are no longer exported from @koobiq/components/input: ' +
+                "nothing in the library used them. Copy what you need: value.replace(/,/g, '.') and " +
+                String.raw `/^-?\d+$/.test(value); isFloat() stays.`
+        },
+        {
+            pattern: importedFrom('time-range', 'KbqTimeRangeTranslateTypeMap'),
+            message: 'KbqTimeRangeTranslateTypeMap was removed from @koobiq/components/time-range: nothing read it. Use ' +
+                'Record<KbqTimeRangeType, KbqTimeRangeTranslationType> instead.'
+        },
+        {
+            pattern: importedFrom('tabs', 'KbqTabBodyOriginState'),
+            message: "KbqTabBodyOriginState was removed: nothing read it. Use 'left' | 'right' instead."
+        },
+        {
+            pattern: importedFrom('datepicker', 'KbqDatepickerIntl'),
+            message: 'KbqDatepickerIntl was removed: no view of the datepicker rendered its labels, and its changes ' +
+                'stream only re-rendered the calendar. Drop the provider and the subclass; the datepicker texts ' +
+                'come from the locale configuration (kbqDatepickerLocaleConfigurationProvider()).'
+        },
+        {
+            anchor: String.raw `\bKbqDropdown\b|\bkbqDropdown\b|<kbq-dropdown\b`,
+            pattern: String.raw `\.onPanelReached\s*\(`,
+            message: 'KbqDropdown.onPanelReached() was removed: nothing subscribed to it. Delete the subscription.'
+        },
+        {
+            anchor: extending('KbqTreeSelection'),
+            pattern: ownMember('getItemHeight'),
+            message: 'The protected KbqTreeSelection.getItemHeight() was removed: call getHeight() on the first rendered ' +
+                'option instead, for example this.renderedOptions.first?.getHeight() ?? 0.'
+        },
+        {
+            anchor: extending('KbqTreeSelection'),
+            pattern: ownMember('setFocusedOption'),
+            message: 'The protected KbqTreeSelection.setFocusedOption() was removed: call ' +
+                'this.keyManager.setActiveItem(option) instead.'
+        },
+        {
+            anchor: String.raw `\bKbqTagList\b|<kbq-tag-list\b`,
+            pattern: String.raw `\.(?:tagSelectionChanges|shouldLabelFloat)\b`,
+            message: 'KbqTagList.tagSelectionChanges and shouldLabelFloat were removed: nothing read them. Listen to ' +
+                'the selectionChange output of each tag, and compute !tagList.empty() || tagList.focused() ' +
+                'yourself.'
+        },
+        {
+            anchor: String.raw `\bKbqTreeNodeOutlet\b`,
+            pattern: String.raw `\.changeDetectorRef\b`,
+            message: 'KbqTreeNodeOutlet.changeDetectorRef was removed: inject ChangeDetectorRef where you need it.'
+        },
+        // Protected members: only a subclass reaches them.
+        {
+            anchor: extending('KbqAccordion|KbqAccordionItem|KbqPasswordToggle|KbqIcon|KbqIconButton|KbqIconItem|KbqSearchExpandable'),
+            pattern: ownMember('changeDetectorRef'),
+            message: 'The protected changeDetectorRef of KbqAccordion, KbqAccordionItem, KbqPasswordToggle, KbqIcon ' +
+                '(with KbqIconButton and KbqIconItem) and KbqSearchExpandable was removed: nothing read it. Inject ' +
+                'ChangeDetectorRef in the subclass.'
+        },
+        {
+            anchor: extending('KbqAccordionTrigger'),
+            pattern: ownMember('nativeElement'),
+            message: 'The protected KbqAccordionTrigger.nativeElement was removed: inject ElementRef in the subclass.'
+        },
+        {
+            anchor: extending('KbqNotificationCenterComponent'),
+            pattern: ownMember('dateAdapter'),
+            message: 'The protected KbqNotificationCenterComponent.dateAdapter was removed: inject DateAdapter in the ' +
+                'subclass.'
+        },
+        {
+            anchor: extending('KbqFilters'),
+            pattern: ownMember('styles'),
+            message: 'The protected KbqFilters.styles was removed: use KbqButtonStyles from @koobiq/components/button.'
+        },
+        {
+            anchor: extending('KbqTitleDirective'),
+            pattern: ownMember('isHorizontalOverflown|isVerticalOverflown|child'),
+            message: 'The protected isHorizontalOverflown, isVerticalOverflown and child of KbqTitleDirective were ' +
+                'removed: isOverflown covers both directions and every measured text element.'
+        },
+        // Classes nothing sets.
+        {
+            pattern: String.raw `(?<![\w-])kbq-(?:control|form-field)_has-validate-directive(?![\w-])`,
+            message: 'The kbq-control_has-validate-directive and kbq-form-field_has-validate-directive classes no ' +
+                'longer style anything: the KbqValidateDirective that set them was removed in 20.0.0. The form ' +
+                'field, select and tree select show an error through their ErrorStateMatcher, which sets ' +
+                'kbq-form-field_invalid and kbq-invalid.'
+        },
+        {
+            pattern: String.raw `(?<![\w-])kbq-no-select(?![\w-])`,
+            message: 'The kbq-no-select class was removed: nothing set it. Set user-select: none in your own styles.'
+        }
+    ]
+};
+
+/**
+ * Replacement data for the v21.0.0 migration — the removed deprecated APIs and the state that became signals — one
+ * file per area under `data/`, applied by `replacementMigrationRule`. A warning reports what cannot be rewritten.
+ */
+const AREAS = [
+    accordion,
+    codeBlockAndIcon,
+    core,
+    dropdownAndSelect,
+    filterBar,
+    formField,
+    formsControls,
+    navbarAndLayout,
+    popover,
+    stateSignals,
+    styles,
+    tags,
+    toast,
+    tree,
+    unusedApi
+];
+/** TypeScript-source replacements (imports, identifiers, member accesses). */
+const tsReplacements = AREAS.flatMap((area) => area.tsReplacements ?? []);
+/** Replacements in templates, external `.html` files and inline `template:` strings alike. */
+const templateReplacements = AREAS.flatMap((area) => area.templateReplacements ?? []);
+/** Replacements in `.scss` and `.css` files. */
+const scssReplacements = AREAS.flatMap((area) => area.scssReplacements ?? []);
+/** Replacements in the `styles` entries of `angular.json`; an entry they turn into a duplicate is dropped. */
+const styleEntryReplacements = AREAS.flatMap((area) => area.styleEntryReplacements ?? []);
+/** What the migration reports instead of rewriting. */
+const warnPatterns = AREAS.flatMap((area) => area.warnPatterns ?? []);
+
+exports.scssReplacements = scssReplacements;
+exports.styleEntryReplacements = styleEntryReplacements;
+exports.templateReplacements = templateReplacements;
+exports.tsReplacements = tsReplacements;
+exports.warnPatterns = warnPatterns;