@koobiq/components 20.4.1 → 21.0.0

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

@@ -1,14 +1,53 @@
 'use strict';
 
+var listItemPattern = require('../../list-item-pattern-D95Y1KIk.js');
+var tagPatterns = require('../../tag-patterns-CNbEB0iT.js');
+
 /**
- * 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.
+ * Replacement data for the v20.0.0 deprecated API removal migration, applied by `replacementMigrationRule`.
  *
  * Three buckets are emitted so the schematic can apply each to the right
  * file kind (.ts, .html / inline-template strings, .scss).
  */
+const CORE = '@koobiq/components/core';
+const FILE_UPLOAD = '@koobiq/components/file-upload';
+/** A named import of `symbol` from `module`. */
+const namedImport = (symbol, module) => `\\bimport\\s*(?:type\\s*)?\\{[^}]*\\b${symbol}\\b[^}]*\\}\\s*from\\s*['"]${module}['"]`;
+/** A mention of the Koobiq autocomplete: one of its symbols, its entry point, its `exportAs` or its input. */
+const KBQ_AUTOCOMPLETE = '(?:\\bKbqAutocomplete|@koobiq/components/autocomplete\\b|\\bkbqAutocomplete)';
+/** An opening `<kbq-divider>` tag up to one of its attributes, captured as `$1`. */
+const DIVIDER_TAG = `(<kbq-divider(?![\\w-])${tagPatterns.TAG_BODY}*?)`;
+/** The `="…"` of an attribute. */
+const ATTRIBUTE_VALUE = `(?:\\s*=\\s*(?:"[^"]*"|'[^']*'))`;
+const REMOVED_SYMBOLS = [
+    { name: 'KbqInputFileLabel', module: FILE_UPLOAD },
+    { name: 'KbqInputFile', module: FILE_UPLOAD },
+    { name: 'KbqFileValidatorFn', module: FILE_UPLOAD },
+    { name: 'KbqValidationOptions', module: CORE },
+    { name: 'KBQ_VALIDATION', module: CORE },
+    { name: 'KBQ_SANITY_CHECKS', module: CORE },
+    { name: 'KBQ_SIDEPANEL_WITH_SHADOW', module: '@koobiq/components/sidepanel' },
+    { name: 'mcSanityChecksFactory', module: CORE },
+    { name: 'KbqCommonModule', module: CORE },
+    // A no-op shim kept after the KbqValidateDirective removal. Its calls go, which can leave an empty
+    // `providers: []` behind.
+    { name: 'kbqDisableLegacyValidationDirectiveProvider', module: CORE, call: true }
+];
+/**
+ * A mention of the symbol outside the elements of `[…]` and `{…}` lists: a type annotation, an `@Inject()` token, a
+ * `provide:`, an aliased import. Deleting it there would leave the code broken.
+ */
+const outsideLists = ({ name, call }) => `(?<![\\[{,]\\s*(?:\\btype\\s+)?)\\b${name}\\b|\\b${name}\\b(?!${call ? '(?:\\s*\\(\\s*\\))?' : ''}\\s*[,\\]}])`;
+/**
+ * Removes the symbol with one of its commas from the named imports and exports and the arrays of a file that names
+ * it nowhere else. A file that also uses it elsewhere is left untouched and reported.
+ */
+const removeFromLists = (symbol) => ({
+    from: listItemPattern.listItemPattern(symbol.call ? `\\b${symbol.name}\\(\\s*\\)` : `\\b${symbol.name}\\b`),
+    to: '',
+    unless: outsideLists(symbol),
+    removeImport: { symbol: symbol.name, from: symbol.module }
+});
 /** TypeScript-source replacements (imports + identifiers + method renames). */
 const tsReplacements = [
     // ─── Package moves ─────────────────────────────────────────────────────
@@ -47,9 +86,14 @@ const tsReplacements = [
     // ─── Identifier renames (TypeScript imports / type references) ────────
     { from: '\\bRdxAccordionItemState\\b', to: 'KbqAccordionItemState' },
     { from: '\\bKbqCodeFile\\b', to: 'KbqCodeBlockFile' },
-    { from: '\\bAnimationCurves\\b', to: 'KbqAnimationCurves' },
+    // The import specifier and the uses of the core one only: Angular Material exports an `AnimationCurves` too.
+    {
+        from: `\\bAnimationCurves\\b(?:(?=[^{}]*\\}\\s*from\\s*['"]${CORE}['"])|` +
+            `(?<=${namedImport('AnimationCurves', CORE)}[\\s\\S]*))`,
+        to: 'KbqAnimationCurves'
+    },
     { from: '\\bMeasurementSystem\\b', to: 'KbqMeasurementSystem' },
-    { from: '\\bSizeUnitsConfig\\b', to: 'KbqSizeUnitsConfig' },
+    { from: '\\bSizeUnitsConfig\\b', to: 'KbqSizeUnitsLocaleConfiguration' },
     { from: '\\bKbqNavbarIcModule\\b', to: 'KbqNavbarModule' },
     { from: '\\bKbqNavbarIcItem\\b', to: 'KbqNavbarItem' },
     { from: '\\bKbqNavbarIcHeader\\b', to: 'KbqNavbarHeader' },
@@ -60,73 +104,14 @@ const tsReplacements = [
     { 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'
-        }
-    },
+    // ─── Removed symbols / function renames ───────────────────────────────
+    ...REMOVED_SYMBOLS.map(removeFromLists),
     {
         from: '\\btoBoolean\\(',
         to: 'booleanAttribute(',
@@ -145,7 +130,12 @@ const tsReplacements = [
         removeImport: { symbol: 'formatDataSize', from: '@koobiq/components/core' }
     },
     // ─── Method renames on instances ──────────────────────────────────────
-    { from: '\\.openPanel\\(', to: '.open(' },
+    // `KbqAutocompleteTrigger.openPanel()`, in a file that uses the Koobiq autocomplete: the autocomplete trigger of
+    // Angular Material keeps its `openPanel()`.
+    {
+        from: `\\.openPanel\\((?:(?<=${KBQ_AUTOCOMPLETE}[\\s\\S]*)|(?=[\\s\\S]*${KBQ_AUTOCOMPLETE}))`,
+        to: '.open('
+    },
     { from: '\\.toggleIsCollapsed\\(', to: '.toggle(' },
     { from: '\\.focusViaKeyboard\\(', to: '.focus(' },
     // ─── Modal options object key ─────────────────────────────────────────
@@ -192,13 +182,27 @@ const templateReplacements = [
     { from: '="kbqDatepickerToggle"', to: '="kbqDatepickerToggleIcon"' },
     // ─── Attribute renames ────────────────────────────────────────────────
     { from: '\\bkbqFormFieldWithoutBorders\\b', to: 'noBorders' },
+    // ─── KbqFilterBarSearch inputs → KbqSearchExpandable inputs ───────────
+    // The selector rewrite above only renames the tag: without these the inputs
+    // of the removed KbqFilterBarSearch survive as attributes the new component
+    // does not have. Scoped to the attribute forms (`[x]` binding, `x="…"`
+    // static, bare attribute) so the identifiers elsewhere are never touched.
+    // The bare `emitValueByEnter` and the everyday word `tooltip` are additionally anchored to an
+    // opening `<kbq-search-expandable` tag — already renamed by the selector rule above. Template
+    // replacements run over the whole text of every `.ts` file, so an unanchored rule would also
+    // rewrite TypeScript expressions such as `this.emitValueByEnter && …`.
+    { from: '\\[emitValueByEnter\\]', to: '[isEmitValueByEnterEnabled]' },
+    { from: '\\bemitValueByEnter="', to: 'isEmitValueByEnterEnabled="' },
+    { from: '(<kbq-search-expandable\\b[^>]*?\\s)emitValueByEnter(?![\\w-])', to: '$1isEmitValueByEnterEnabled' },
+    { from: '\\[onSearchTimeout\\]', to: '[emitValueTimeout]' },
+    { from: '\\bonSearchTimeout="', to: 'emitValueTimeout="' },
+    { from: '(<kbq-search-expandable\\b[^>]*?\\s)\\[tooltip\\]', to: '$1[tooltipText]' },
+    { from: '(<kbq-search-expandable\\b[^>]*?\\s)tooltip="', to: '$1tooltipText="' },
     // ─── 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="' },
+    // `[x]="…"`, `x="…"` and a valueless `x`, only on a `<kbq-code-block>` that does not bind the replacement
+    // as well: the two bindings would end up under one name. Such a tag is reported below.
+    { from: String.raw `${tagPatterns.codeBlockTagWithout('canDownload')}canLoad(?=\]?[\s=/>])`, to: '$1canDownload' },
+    { from: String.raw `${tagPatterns.codeBlockTagWithout('files')}codeFiles(?=\]?[\s=/>])`, to: '$1files' },
     // ─── 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
@@ -214,8 +218,9 @@ const templateReplacements = [
         to: 'kbqTooltipModifier="extended" [kbqTooltip]'
     },
     // ─── Divider deprecated inset attribute ───────────────────────────────
-    { from: '\\s\\[inset\\]="[^"]*"', to: '' },
-    { from: '\\sinset(\\s|>|/)', to: '$1' }
+    // Only on a `<kbq-divider>`: in code `inset` is any identifier, and other dividers have an input of that name.
+    { from: `${DIVIDER_TAG}\\s\\[inset\\]${ATTRIBUTE_VALUE}`, to: '$1' },
+    { from: `${DIVIDER_TAG}\\sinset${ATTRIBUTE_VALUE}?(?=[\\s/>])`, to: '$1' }
 ];
 /** SCSS replacements (CSS class selectors that were renamed at the runtime level). */
 const scssReplacements = [
@@ -225,6 +230,10 @@ const scssReplacements = [
     { from: '\\.kbq-datepicker-toggle(?!-icon)\\b', to: '.kbq-datepicker-toggle-icon' },
     { from: '\\.kbq-form-field_without-borders\\b', to: '.kbq-form-field_no-borders' }
 ];
+/**
+ * Patterns that we can't safely auto-fix — surface them to the user with file
+ * locations so they can migrate manually, whether or not the fix is applied.
+ */
 const warnPatterns = [
     {
         pattern: '\\(onSaveAsNew\\)',
@@ -261,11 +270,49 @@ const warnPatterns = [
         message: 'KbqCodeBlock.canLoad → canDownload and .codeFiles → files. Template bindings are auto-migrated; ' +
             'update any programmatic (TypeScript) access manually.'
     },
+    {
+        pattern: `${tagPatterns.codeBlockTagWith('canLoad', 'canDownload')}|${tagPatterns.codeBlockTagWith('codeFiles', 'files')}`,
+        message: 'A <kbq-code-block> that binds `canLoad` next to `canDownload`, or `codeFiles` next to `files`, was ' +
+            'left untouched: merge each pair into one `canDownload` / `files` binding. Manual migration required.'
+    },
+    {
+        pattern: '\\[initialValue\\]|\\binitialValue="',
+        message: 'KbqFilterBarSearch.initialValue has no counterpart in kbq-search-expandable: the component ' +
+            'is a form control with no separate value input. Seed the bound [formControl] / [(ngModel)] ' +
+            'with the value instead. Manual migration required.'
+    },
+    {
+        pattern: '\\(onSearch\\)',
+        message: 'KbqFilterBarSearch.onSearch was removed. kbq-search-expandable reports the query through its ' +
+            'form binding — read the bound control (valueChanges) instead. Manual migration required.'
+    },
+    {
+        // Everything but the element form, which the template replacements above rewrite: a leading `<` or
+        // `</` is the tag, a leading `.` the stylesheet class the scss replacements handle.
+        pattern: '(?<![</.\\w-])kbq-filter-search\\b',
+        message: 'KbqFilterBarSearch also matched as an attribute (<div kbq-filter-search>), which ' +
+            'kbq-search-expandable does not: its selector is element-only, so the attribute would silently ' +
+            'match nothing after the upgrade. Replace the host element with <kbq-search-expandable> by hand. ' +
+            'Manual migration required.'
+    },
+    {
+        pattern: '<kbq-filter-search\\b',
+        message: 'KbqFilterBarSearch.onSearchTimeout defaulted to 0 while kbq-search-expandable.emitValueTimeout ' +
+            'defaults to 200: markup that never set the timeout emitted on every keystroke and now waits ' +
+            '200ms. The rename itself is auto-migrated — add [emitValueTimeout]="0" to keep the old timing.'
+    },
     {
         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.'
-    }
+    },
+    ...REMOVED_SYMBOLS.map((symbol) => ({
+        anchor: `\\b(?:import|export)\\s*(?:type\\s*)?\\{[^}]*\\b${symbol.name}\\b[^}]*\\}\\s*from\\s*['"]${symbol.module}['"]`,
+        pattern: outsideLists(symbol),
+        message: `\`${symbol.name}\` was removed in 20.0.0 with nothing in its place. This file uses it outside an ` +
+            'import or a list, e.g. as a type, an `@Inject()` token or a `provide:`, so it was left untouched: ' +
+            'remove those uses, and the code that depends on them, by hand. Manual migration required.'
+    }))
 ];
 
 exports.scssReplacements = scssReplacements;

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

@@ -2,224 +2,17 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var utils_messages = require('../../utils/messages.js');
-var utils_packageConfig = require('../../utils/package-config.js');
+var replacementDriver = require('../../replacement-driver-8o5P9eyQ.js');
 var migrations_v20Upgrade_data = require('./data.js');
+require('../../list-item-pattern-D95Y1KIk.js');
+require('../../utils/messages.js');
+require('../../package-config-BhU2TfC8.js');
 require('@angular-devkit/schematics');
 require('@schematics/angular/utility');
+require('../../tag-patterns-CNbEB0iT.js');
 
-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 } = options;
-        // `ng update` invokes migrations with no options at all, and migrations.json declares no schema, so the
-        // schema default never reaches us — applying the fix is the intended behaviour there.
-        const fix = options.fix ?? true;
-        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).`
-        ]);
-    };
+    return replacementDriver.replacementMigrationRule({ label: '[v20-upgrade]', tsReplacements: migrations_v20Upgrade_data.tsReplacements, templateReplacements: migrations_v20Upgrade_data.templateReplacements, scssReplacements: migrations_v20Upgrade_data.scssReplacements, warnPatterns: migrations_v20Upgrade_data.warnPatterns }, options);
 }
 
 exports.default = v20Upgrade;