@koobiq/components 19.8.3 → 20.1.0

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

@@ -0,0 +1,274 @@
+'use strict';
+
+/**
+ * Replacement data for the v20.0.0 deprecated API removal migration.
+ *
+ * Each entry uses a RegExp source string in `from` and a literal `to`. The
+ * RegExp is compiled with the `g` flag inside the migration driver.
+ *
+ * Three buckets are emitted so the schematic can apply each to the right
+ * file kind (.ts, .html / inline-template strings, .scss).
+ */
+/** TypeScript-source replacements (imports + identifiers + method renames). */
+const tsReplacements = [
+    // ─── Package moves ─────────────────────────────────────────────────────
+    // @koobiq/cdk was merged into @koobiq/components/core in v20.0.0.
+    // Order matters: subpath rules must run before any bare-prefix rule.
+    {
+        from: '@koobiq/cdk/a11y',
+        to: '@koobiq/components/core',
+        note: '@koobiq/cdk package was merged into @koobiq/components/core in v20.0.0'
+    },
+    {
+        from: '@koobiq/cdk/keycodes',
+        to: '@koobiq/components/core',
+        note: '@koobiq/cdk package was merged into @koobiq/components/core in v20.0.0'
+    },
+    {
+        from: '@koobiq/cdk/testing',
+        to: '@koobiq/components/core',
+        note: '@koobiq/cdk package was merged into @koobiq/components/core in v20.0.0'
+    },
+    {
+        from: '@koobiq/components/navbar-ic',
+        to: '@koobiq/components/navbar',
+        note: 'navbar-ic package was removed in v20.0.0'
+    },
+    {
+        from: '@koobiq/components/risk-level',
+        to: '@koobiq/components/badge',
+        note: 'risk-level package was removed in v20.0.0; consult Badge API for color/outline mapping'
+    },
+    {
+        from: '@koobiq/components-experimental/form-field',
+        to: '@koobiq/components/form-field',
+        note: 'experimental form-field merged back into the main package'
+    },
+    // ─── Identifier renames (TypeScript imports / type references) ────────
+    { from: '\\bRdxAccordionItemState\\b', to: 'KbqAccordionItemState' },
+    { from: '\\bKbqCodeFile\\b', to: 'KbqCodeBlockFile' },
+    { from: '\\bAnimationCurves\\b', to: 'KbqAnimationCurves' },
+    { from: '\\bMeasurementSystem\\b', to: 'KbqMeasurementSystem' },
+    { from: '\\bSizeUnitsConfig\\b', to: 'KbqSizeUnitsConfig' },
+    { from: '\\bKbqNavbarIcModule\\b', to: 'KbqNavbarModule' },
+    { from: '\\bKbqNavbarIcItem\\b', to: 'KbqNavbarItem' },
+    { from: '\\bKbqNavbarIcHeader\\b', to: 'KbqNavbarHeader' },
+    { from: '\\bKbqNavbarIc\\b', to: 'KbqNavbar' },
+    { from: '\\bKbqRiskLevelModule\\b', to: 'KbqBadgeModule' },
+    { from: '\\bKbqRiskLevel\\b', to: 'KbqBadge' },
+    { from: '\\bKbqWarningTooltipTrigger\\b', to: 'KbqTooltipTrigger' },
+    { from: '\\bKbqExtendedTooltipTrigger\\b', to: 'KbqTooltipTrigger' },
+    { from: '\\bKbqDatepickerToggle\\b(?!Icon)', to: 'KbqDatepickerToggleIconComponent' },
+    { from: '\\bKbqFilterBarSearch\\b', to: 'KbqSearchExpandable' },
+    {
+        from: '\\bKbqInputFileLabel\\b',
+        to: '',
+        removeImport: { symbol: 'KbqInputFileLabel', from: '@koobiq/components/file-upload' }
+    },
+    {
+        from: '\\bKbqInputFile\\b',
+        to: '',
+        removeImport: { symbol: 'KbqInputFile', from: '@koobiq/components/file-upload' }
+    },
+    {
+        from: '\\bKbqFileValidatorFn\\b',
+        to: '',
+        removeImport: { symbol: 'KbqFileValidatorFn', from: '@koobiq/components/file-upload' }
+    },
+    {
+        from: '\\bKbqValidationOptions\\b',
+        to: '',
+        removeImport: { symbol: 'KbqValidationOptions', from: '@koobiq/components/core' }
+    },
+    { from: '\\bKbqFormFieldRef\\b', to: 'KbqFormField' },
+    // Deprecated dropdown position type aliases → Kbq-prefixed names. The
+    // `\b…\b` boundaries make these idempotent: `KbqDropdownPositionX` is not
+    // re-matched because the `D` is preceded by a word char (`q`).
+    { from: '\\bDropdownPositionX\\b', to: 'KbqDropdownPositionX' },
+    { from: '\\bDropdownPositionY\\b', to: 'KbqDropdownPositionY' },
+    // ─── Tokens / function renames ────────────────────────────────────────
+    {
+        from: '\\bKBQ_VALIDATION\\b',
+        to: '',
+        removeImport: { symbol: 'KBQ_VALIDATION', from: '@koobiq/components/core' }
+    },
+    {
+        from: '\\bKBQ_SANITY_CHECKS\\b',
+        to: '',
+        removeImport: { symbol: 'KBQ_SANITY_CHECKS', from: '@koobiq/components/core' }
+    },
+    {
+        from: '\\bKBQ_SIDEPANEL_WITH_SHADOW\\b',
+        to: '',
+        removeImport: { symbol: 'KBQ_SIDEPANEL_WITH_SHADOW', from: '@koobiq/components/sidepanel' }
+    },
+    {
+        from: '\\bmcSanityChecksFactory\\b',
+        to: '',
+        removeImport: { symbol: 'mcSanityChecksFactory', from: '@koobiq/components/core' }
+    },
+    {
+        from: '\\bKbqCommonModule\\b',
+        to: '',
+        removeImport: { symbol: 'KbqCommonModule', from: '@koobiq/components/core' }
+    },
+    {
+        // No-op shim kept after the KbqValidateDirective removal in v20.0.0 is
+        // gone in this release. Strip the call, its trailing comma, and the
+        // import; the array/empty-providers cleanup happens via the extended
+        // `[ , … ]` / `[ … , ]` normalize pass in the driver.
+        from: '\\bkbqDisableLegacyValidationDirectiveProvider\\(\\s*\\),?\\s*',
+        to: '',
+        note: 'kbqDisableLegacyValidationDirectiveProvider was a no-op shim kept after the ' +
+            'KbqValidateDirective removal in v20.0.0; it is removed in this release. ' +
+            'You may also need to remove the (now-empty) `providers: []` key from the affected decorator.',
+        removeImport: {
+            symbol: 'kbqDisableLegacyValidationDirectiveProvider',
+            from: '@koobiq/components/core'
+        }
+    },
+    {
+        from: '\\btoBoolean\\(',
+        to: 'booleanAttribute(',
+        ensureImport: { symbol: 'booleanAttribute', from: '@angular/core' },
+        removeImport: { symbol: 'toBoolean', from: '@koobiq/components/core' }
+    },
+    {
+        from: '\\bisCorrectExtension\\(',
+        to: 'FileValidators.isCorrectExtension(',
+        ensureImport: { symbol: 'FileValidators', from: '@koobiq/components/file-upload' },
+        removeImport: { symbol: 'isCorrectExtension', from: '@koobiq/components/file-upload' }
+    },
+    {
+        from: '\\bformatDataSize\\(',
+        to: 'getFormattedSizeParts(',
+        removeImport: { symbol: 'formatDataSize', from: '@koobiq/components/core' }
+    },
+    // ─── Method renames on instances ──────────────────────────────────────
+    { from: '\\.openPanel\\(', to: '.open(' },
+    { from: '\\.toggleIsCollapsed\\(', to: '.toggle(' },
+    { from: '\\.focusViaKeyboard\\(', to: '.focus(' },
+    // ─── Modal options object key ─────────────────────────────────────────
+    {
+        from: '\\bkbqComponentParams:',
+        to: 'data:',
+        note: 'kbqComponentParams was renamed to data. The CHILD modal component must read the ' +
+            'payload via inject(KBQ_MODAL_DATA) instead of @Input — this rewrite only changes ' +
+            'the caller side.'
+    }
+];
+/** Template (HTML / inline-template string) replacements — selectors + attributes. */
+const templateReplacements = [
+    // ─── Selector renames (component tag names) ───────────────────────────
+    { from: '<kbq-filter-search([\\s/>])', to: '<kbq-search-expandable$1' },
+    { from: '</kbq-filter-search>', to: '</kbq-search-expandable>' },
+    { from: '<kbq-datepicker-toggle(?!-icon)([\\s/>])', to: '<kbq-datepicker-toggle-icon$1' },
+    { from: '</kbq-datepicker-toggle>', to: '</kbq-datepicker-toggle-icon>' },
+    { from: '<kbq-risk-level([\\s/>])', to: '<kbq-badge$1' },
+    { from: '</kbq-risk-level>', to: '</kbq-badge>' },
+    { from: '<kbq-navbar-ic-item([\\s/>])', to: '<kbq-navbar-item$1' },
+    { from: '</kbq-navbar-ic-item>', to: '</kbq-navbar-item>' },
+    { from: '<kbq-navbar-ic-header([\\s/>])', to: '<kbq-navbar-header$1' },
+    { from: '</kbq-navbar-ic-header>', to: '</kbq-navbar-header>' },
+    { from: '<kbq-navbar-ic([\\s/>])', to: '<kbq-navbar$1' },
+    { from: '</kbq-navbar-ic>', to: '</kbq-navbar>' },
+    // ─── Static-attribute tooltip form ────────────────────────────────────
+    // `<span kbqWarningTooltip="text">` (plain attribute, not a binding) must
+    // become `<span kbqTooltipModifier="warning" kbqTooltip="text">`. These
+    // rules MUST precede the `="kbqWarningTooltip"` exportAs rule below — the
+    // exportAs regex would otherwise rewrite the attribute name's `="..."`
+    // suffix and turn `kbqWarningTooltip="text"` into the wrong shape.
+    {
+        from: '\\bkbqWarningTooltip="([^"]*)"',
+        to: 'kbqTooltipModifier="warning" kbqTooltip="$1"'
+    },
+    {
+        from: '\\bkbqExtendedTooltip="([^"]*)"',
+        to: 'kbqTooltipModifier="extended" kbqTooltip="$1"'
+    },
+    // ─── Template-ref exportAs renames ────────────────────────────────────
+    { from: '="kbqWarningTooltip"', to: '="kbqTooltip"' },
+    { from: '="kbqExtendedTooltip"', to: '="kbqTooltip"' },
+    { from: '="kbqDatepickerToggle"', to: '="kbqDatepickerToggleIcon"' },
+    // ─── Attribute renames ────────────────────────────────────────────────
+    { from: '\\bkbqFormFieldWithoutBorders\\b', to: 'noBorders' },
+    // ─── KbqCodeBlock deprecated input renames ────────────────────────────
+    // Scoped strictly to the attribute form (`[x]` binding or `x="…"` static)
+    // so the common words `canDownload` / `files` elsewhere are never touched.
+    { from: '\\[canLoad\\]', to: '[canDownload]' },
+    { from: '\\bcanLoad="', to: 'canDownload="' },
+    { from: '\\[codeFiles\\]', to: '[files]' },
+    { from: '\\bcodeFiles="', to: 'files="' },
+    // ─── Tooltip warning trigger → kbqTooltip + modifier ───────────────────
+    // Two-step: first add modifier attribute, then rename binding key.
+    // The modifier insertion must come before the binding rename otherwise we
+    // can't tell the legacy directive from the base one. We approximate this
+    // by handling the bracketed binding (most common) and the bare-attribute
+    // variant separately, prepending `kbqTooltipModifier="warning"` inline.
+    {
+        from: '\\[kbqWarningTooltip\\]',
+        to: 'kbqTooltipModifier="warning" [kbqTooltip]'
+    },
+    {
+        from: '\\[kbqExtendedTooltip\\]',
+        to: 'kbqTooltipModifier="extended" [kbqTooltip]'
+    },
+    // ─── Divider deprecated inset attribute ───────────────────────────────
+    { from: '\\s\\[inset\\]="[^"]*"', to: '' },
+    { from: '\\sinset(\\s|>|/)', to: '$1' }
+];
+/** SCSS replacements (CSS class selectors that were renamed at the runtime level). */
+const scssReplacements = [
+    { from: '\\.kbq-risk-level\\b', to: '.kbq-badge' },
+    { from: '\\.kbq-navbar-ic\\b', to: '.kbq-navbar' },
+    { from: '\\.kbq-filter-search\\b', to: '.kbq-search-expandable' },
+    { from: '\\.kbq-datepicker-toggle(?!-icon)\\b', to: '.kbq-datepicker-toggle-icon' },
+    { from: '\\.kbq-form-field_without-borders\\b', to: '.kbq-form-field_no-borders' }
+];
+const warnPatterns = [
+    {
+        pattern: '\\(onSaveAsNew\\)',
+        message: '(onSaveAsNew) was removed from KbqFilters. Listen to (onSave) and branch on ' +
+            "$event.status === 'newFilter' instead. Manual migration required."
+    },
+    {
+        pattern: '\\[customValidation\\]',
+        message: '[customValidation] / KbqMultipleFileUploadComponent.customValidation was removed. ' +
+            'Use FormControl validators (e.g. FileValidators.isCorrectExtension) bound via [formControl] instead.'
+    },
+    {
+        pattern: '\\[errors\\]="[^"]*"',
+        message: 'KbqMultipleFileUploadComponent.errors / KbqSingleFileUploadComponent.errors @Input was removed. ' +
+            'Use FormControl.errors instead.'
+    },
+    {
+        pattern: '\\[apps\\]="[^"]*"',
+        message: 'KbqAppSwitcherTrigger.apps @Input was removed. Wrap your apps array in a single ' +
+            'KbqAppSwitcherSite and pass it via [sites]="[{ id, name, apps }]".'
+    },
+    {
+        pattern: '\\bkbqComponentParams:',
+        message: 'kbqComponentParams is being rewritten to "data:" — remember the CHILD modal ' +
+            "component must read the payload via inject(KBQ_MODAL_DATA) (from '@koobiq/components/modal') " +
+            'instead of @Input.'
+    },
+    {
+        pattern: '\\bscrollableCodeContent\\b',
+        message: 'KbqCodeBlock.scrollableCodeContent is deprecated; use the scrollTo() method instead. Manual migration required.'
+    },
+    {
+        pattern: '\\.canLoad\\b|\\.codeFiles\\b',
+        message: 'KbqCodeBlock.canLoad → canDownload and .codeFiles → files. Template bindings are auto-migrated; ' +
+            'update any programmatic (TypeScript) access manually.'
+    },
+    {
+        pattern: '\\brequired:\\s*(true|false)',
+        message: 'KbqFilter.required is deprecated — use cleanable = false and removable = false instead. ' +
+            'NOTE: this warning is best-effort and may match unrelated `required:` keys; verify it is a KbqFilter config.'
+    }
+];
+
+exports.scssReplacements = scssReplacements;
+exports.templateReplacements = templateReplacements;
+exports.tsReplacements = tsReplacements;
+exports.warnPatterns = warnPatterns;

package/schematics/migrations/v20-upgrade/index.js

@@ -0,0 +1,222 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var utils_messages = require('../../utils/messages.js');
+var utils_packageConfig = require('../../utils/package-config.js');
+var migrations_v20Upgrade_data = require('./data.js');
+require('@angular-devkit/schematics');
+require('@schematics/angular/utility');
+
+const TS_EXT = '.ts';
+const HTML_EXT = '.html';
+const SCSS_EXT = '.scss';
+const CSS_EXT = '.css';
+/**
+ * Applies an ordered list of regex replacements to a string, returns the new
+ * string, whether anything changed, and any imports the replacements introduced
+ * that the file must contain (e.g. `booleanAttribute` from `@angular/core` after
+ * a `toBoolean(` → `booleanAttribute(` rewrite).
+ */
+function applyReplacements(content, replacements) {
+    let result = content;
+    const importsToEnsure = [];
+    const importsToRemove = [];
+    for (const { from, to, ensureImport, removeImport } of replacements) {
+        const before = result;
+        result = result.replace(new RegExp(from, 'g'), to);
+        // Tidy up double commas / empty-element commas left over from identifier
+        // deletions like `{ A, KbqValidationOptions, B }` → `{ A, , B }`.
+        // Also covers array forms like `providers: [a(), removedCall(), b()]`
+        // → `providers: [a(), , b()]` after a call-site rewrite to ''.
+        if (to === '' && before !== result) {
+            result = result
+                .replace(/,\s*,/g, ',')
+                .replace(/{\s*,/g, '{')
+                .replace(/,\s*}/g, ' }')
+                .replace(/\[\s*,/g, '[')
+                .replace(/,\s*\]/g, ' ]');
+        }
+        if (ensureImport && before !== result) {
+            importsToEnsure.push(ensureImport);
+        }
+        if (removeImport && before !== result) {
+            importsToRemove.push(removeImport);
+        }
+    }
+    return { content: result, changed: result !== content, importsToEnsure, importsToRemove };
+}
+/**
+ * Idempotently add `import { symbol } from 'module'` to a TypeScript source
+ * string. If the module is already imported, the symbol is added to the
+ * existing import clause. If the symbol is already imported (from any
+ * module), this is a no-op. Otherwise a new import line is inserted at the
+ * top of the file (after any leading block / leading comments).
+ */
+function ensureImport(content, symbol, from) {
+    // Already imported (anywhere) — leave alone. The regex looks for the
+    // identifier inside an `import { ... }` clause; deliberately permissive
+    // so re-exports and renamed imports still skip the injection.
+    const alreadyImported = new RegExp(`import\\s*(?:type\\s*)?\\{[^}]*\\b${symbol}\\b[^}]*\\}\\s*from\\s*['"][^'"]+['"]`);
+    if (alreadyImported.test(content))
+        return content;
+    // Existing import line from the same module — extend its clause.
+    const sameModule = new RegExp(`(import\\s*(?:type\\s*)?\\{)([^}]*)(\\}\\s*from\\s*['"]${escapeRegExp(from)}['"])`);
+    if (sameModule.test(content)) {
+        return content.replace(sameModule, (_match, open, body, close) => {
+            const trimmed = body.trim().replace(/,$/, '');
+            const next = trimmed.length === 0 ? ` ${symbol} ` : `${body.replace(/\s*$/, '')}, ${symbol} `;
+            return `${open}${next}${close}`;
+        });
+    }
+    // Otherwise, prepend a new import. Insert after any leading comment block
+    // / shebang. The simple heuristic finds the first non-comment, non-blank
+    // line and inserts right before it.
+    const newImport = `import { ${symbol} } from '${from}';\n`;
+    const lines = content.split('\n');
+    let insertAt = 0;
+    let inBlockComment = false;
+    for (let i = 0; i < lines.length; i++) {
+        const trimmed = lines[i].trim();
+        if (inBlockComment) {
+            if (trimmed.endsWith('*/'))
+                inBlockComment = false;
+            insertAt = i + 1;
+            continue;
+        }
+        if (trimmed.startsWith('/*')) {
+            inBlockComment = !trimmed.includes('*/');
+            insertAt = i + 1;
+            continue;
+        }
+        if (trimmed.startsWith('//') || trimmed.length === 0) {
+            insertAt = i + 1;
+            continue;
+        }
+        break;
+    }
+    lines.splice(insertAt, 0, newImport.replace(/\n$/, ''));
+    return lines.join('\n');
+}
+function escapeRegExp(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/**
+ * Idempotently strip `symbol` from any `import { … } from 'from'` clause.
+ * - Multi-symbol clause: drop just that symbol, keep the others.
+ * - Single-symbol clause: drop the entire import line (including its trailing newline).
+ * Returns content unchanged if no matching clause is found.
+ *
+ * Used to clean up dangling references after rewrites that delete or rename a
+ * symbol (e.g. `toBoolean(` → `booleanAttribute(` must also remove the now-
+ * non-existent `toBoolean` import from `@koobiq/components/core`).
+ */
+function removeImport(content, symbol, from) {
+    const moduleRe = new RegExp(`(import\\s*(?:type\\s*)?\\{)([^}]*)(\\}\\s*from\\s*['"]${escapeRegExp(from)}['"];?\\s*\\n?)`, 'g');
+    return content.replace(moduleRe, (full, open, body, close) => {
+        const items = body
+            .split(',')
+            .map((s) => s.trim())
+            .filter(Boolean);
+        // Empty clause means an earlier regex rewrite already stripped the only
+        // specifier (e.g. `KbqValidationOptions` → `''` left `import {  } from …`).
+        // Since this caller asked us to remove `symbol` from this module, the line
+        // is dead either way — drop it.
+        if (items.length === 0)
+            return '';
+        const kept = items.filter((spec) => {
+            // Handle `<name> as <alias>` — match on the source name, not the alias.
+            const source = spec.split(/\s+as\s+/)[0].trim();
+            return source !== symbol;
+        });
+        if (kept.length === items.length)
+            return full; // no change
+        if (kept.length === 0)
+            return ''; // drop whole line
+        return `${open} ${kept.join(', ')} ${close}`;
+    });
+}
+function logWarnings(context, filePath, content, patterns) {
+    for (const { pattern, message } of patterns) {
+        if (new RegExp(pattern).test(content)) {
+            utils_messages.logMessage(context.logger, [`[v20-upgrade] ${filePath}`, `  ${message}`]);
+        }
+    }
+}
+function pickReplacements(filePath) {
+    if (filePath.endsWith(TS_EXT)) {
+        // .ts files: apply both ts-source and template replacements (covers inline templates)
+        return [...migrations_v20Upgrade_data.tsReplacements, ...migrations_v20Upgrade_data.templateReplacements];
+    }
+    if (filePath.endsWith(HTML_EXT)) {
+        return migrations_v20Upgrade_data.templateReplacements;
+    }
+    if (filePath.endsWith(SCSS_EXT) || filePath.endsWith(CSS_EXT)) {
+        return migrations_v20Upgrade_data.scssReplacements;
+    }
+    return null;
+}
+function v20Upgrade(options) {
+    return async (tree, context) => {
+        const { project, fix } = options;
+        const projectDefinition = await utils_packageConfig.setupOptions(project, tree);
+        const root = projectDefinition?.root ?? '';
+        const rootDir = root ? tree.getDir(root) : tree.root;
+        let touched = 0;
+        rootDir.visit((filePath, entry) => {
+            if (filePath.includes('node_modules') || filePath.includes('/dist/'))
+                return;
+            const replacements = pickReplacements(filePath);
+            if (!replacements)
+                return;
+            const originalContent = entry?.content.toString();
+            if (!originalContent)
+                return;
+            // Always surface warn-only patterns regardless of fix mode.
+            logWarnings(context, filePath, originalContent, migrations_v20Upgrade_data.warnPatterns);
+            const { content: replaced, changed, importsToEnsure, importsToRemove } = applyReplacements(originalContent, replacements);
+            if (!changed)
+                return;
+            let content = replaced;
+            if (filePath.endsWith(TS_EXT)) {
+                // Deduplicate by symbol+module since one replacement may match
+                // many call sites in the same file.
+                if (importsToRemove.length > 0) {
+                    const seenRemove = new Set();
+                    for (const { symbol, from } of importsToRemove) {
+                        const key = `${symbol}|${from}`;
+                        if (seenRemove.has(key))
+                            continue;
+                        seenRemove.add(key);
+                        content = removeImport(content, symbol, from);
+                    }
+                }
+                if (importsToEnsure.length > 0) {
+                    const seenEnsure = new Set();
+                    for (const { symbol, from } of importsToEnsure) {
+                        const key = `${symbol}|${from}`;
+                        if (seenEnsure.has(key))
+                            continue;
+                        seenEnsure.add(key);
+                        content = ensureImport(content, symbol, from);
+                    }
+                }
+            }
+            touched++;
+            if (fix) {
+                tree.overwrite(filePath, content);
+            }
+            else {
+                utils_messages.logMessage(context.logger, [
+                    `[v20-upgrade] would update ${filePath} (run with --fix to apply)`
+                ]);
+            }
+        });
+        utils_messages.logMessage(context.logger, [
+            `[v20-upgrade] processed tree under "${root || '<workspace root>'}", ` +
+                `${fix ? 'updated' : 'would update'} ${touched} file(s).`
+        ]);
+    };
+}
+
+exports.default = v20Upgrade;

package/schematics/migrations/v20-upgrade/schema.json

@@ -0,0 +1,20 @@
+{
+    "$schema": "http://json-schema.org/schema",
+    "$id": "koobiq-components-v20-upgrade",
+    "title": "Koobiq components v20.0.0 upgrade",
+    "type": "object",
+    "properties": {
+        "project": {
+            "type": "string",
+            "description": "Name of the project to migrate. If omitted, the migration runs over the whole tree.",
+            "$default": {
+                "$source": "projectName"
+            }
+        },
+        "fix": {
+            "type": "boolean",
+            "default": true,
+            "description": "When true, applies all auto-fix replacements. When false, prints what would change without writing."
+        }
+    }
+}

package/schematics/migrations.json

@@ -0,0 +1,15 @@
+{
+    "$schema": "../../../node_modules/@angular-devkit/schematics/collection-schema.json",
+    "schematics": {
+        "v20-upgrade": {
+            "version": "20.0.0-0",
+            "description": "Migrates code from deprecated APIs removed in @koobiq/components v20.0.0. Handles package moves (@koobiq/cdk/{a11y,keycodes,testing} → @koobiq/components/core, navbar-ic, risk-level, experimental form-field), TypeScript identifier renames, template selector renames (e.g. <kbq-filter-search> → <kbq-search-expandable>, <kbq-datepicker-toggle> → <kbq-datepicker-toggle-icon>), attribute renames (kbqFormFieldWithoutBorders → noBorders), tooltip modifier inputs, and emits warnings for structural changes that need manual migration (onSaveAsNew, file-upload customValidation/errors, app-switcher apps).",
+            "factory": "./migrations/v20-upgrade/index"
+        },
+        "filter-bar-signals": {
+            "version": "21.0.0-0",
+            "description": "Migrates KbqFilterBar consumers to the signal-based API. Rewrites programmatic reads of the now-signal members (filter, pipeTemplates, isChanged, isDisabled, isReadOnly, isSaved, isSavedAndChanged) to calls and `filter = v` writes to `filter.set(v)` on receivers typed KbqFilterBar, including reads via template reference variables on <kbq-filter-bar>. Renames KbqFilterBarRefresher → KbqFilterRefresher and warns on changes/preparePopover/view-query cases that need manual migration.",
+            "factory": "./migrations/filter-bar-signals/index"
+        }
+    }
+}

package/schematics/ng-add/index.js

@@ -26,12 +26,11 @@ function ngAdd(options) {
             }
         }
         // Installing dependencies
-        utils_packageConfig.addPackageToPackageJson(tree, '@angular/cdk', "^19.2.19");
-        utils_packageConfig.addPackageToPackageJson(tree, '@koobiq/cdk', "^19.8.3");
-        utils_packageConfig.addPackageToPackageJson(tree, '@koobiq/angular-luxon-adapter', "^19.8.3");
+        utils_packageConfig.addPackageToPackageJson(tree, '@angular/cdk', "^20.2.14");
+        utils_packageConfig.addPackageToPackageJson(tree, '@koobiq/angular-luxon-adapter', "^20.1.0");
         utils_packageConfig.addPackageToPackageJson(tree, '@koobiq/date-formatter', "^3.5.1");
         utils_packageConfig.addPackageToPackageJson(tree, '@koobiq/date-adapter', "^3.5.1");
-        utils_packageConfig.addPackageToPackageJson(tree, '@koobiq/icons', "^11.5.0");
+        utils_packageConfig.addPackageToPackageJson(tree, '@koobiq/icons', "^11.7.1");
         utils_packageConfig.addPackageToPackageJson(tree, '@koobiq/design-tokens', "^3.17.2");
         utils_packageConfig.addPackageToPackageJson(tree, 'luxon', "^3.7.2");
     };