fix(material/schematics): add renaming of non standard symbols (#25523)

Author: wagnermaciel

src/material/schematics/ng-update/migrations/legacy-components-v15/constants.ts

@@ -41,6 +41,19 @@ export const MDC_IMPORT_CHANGES = COMPONENTS.map(component => ({
   new: `@angular/material/${component}`,
 }));
 
+export const CUSTOM_TS_SYMBOL_RENAMINGS = [
+  {old: 'ProgressAnimationEnd', new: 'LegacyProgressAnimationEnd'},
+  {old: 'ProgressBarMode', new: 'LegacyProgressBarMode'},
+  {old: 'ProgressSpinnerMode', new: 'LegacyProgressSpinnerMode'},
+  {old: 'AutoFocusTarget', new: 'LegacyAutoFocusTarget'},
+  {old: 'DialogRole', new: 'LegacyDialogRole'},
+  {old: 'DialogPosition', new: 'LegacyDialogPosition'},
+  {old: '_closeDialogVia', new: '_closeLegacyDialogVia'},
+  {old: 'MatTestDialogOpener', new: 'MatTestLegacyDialogOpener'},
+  {old: 'SimpleSnackBar', new: 'LegacySimpleSnackBar'},
+  {old: 'TextOnlySnackBar', new: 'LegacyTextOnlySnackBar'},
+];
+
 export const MIXINS = COMPONENTS.concat(['option', 'optgroup']).flatMap(component => [
   `${component}-theme`,
   `${component}-color`,

src/material/schematics/ng-update/migrations/legacy-components-v15/index.ts

@@ -10,7 +10,12 @@ import * as ts from 'typescript';
 import * as postcss from 'postcss';
 import * as scss from 'postcss-scss';
 
-import {MAT_IMPORT_CHANGES, MDC_IMPORT_CHANGES, MIXINS} from './constants';
+import {
+  CUSTOM_TS_SYMBOL_RENAMINGS,
+  MAT_IMPORT_CHANGES,
+  MDC_IMPORT_CHANGES,
+  MIXINS,
+} from './constants';
 
 import {Migration, ResolvedResource, TargetVersion, WorkspacePath} from '@angular/cdk/schematics';
 
@@ -152,6 +157,16 @@ export class LegacyComponentsMigration extends Migration<null> {
     const separator = ts.isImportSpecifier(node) ? ' as ' : ': ';
     const oldExport = name.escapedText.toString();
 
+    // Handle TS Symbols that have non-standard renamings.
+    const customMapping = CUSTOM_TS_SYMBOL_RENAMINGS.find(v => v.old === oldExport);
+    if (customMapping) {
+      const replacement = node.propertyName
+        ? customMapping.new
+        : `${customMapping.new}${separator}${customMapping.old}`;
+      this._tsReplaceAt(name, {old: oldExport, new: replacement});
+      return;
+    }
+
     // Handle TS Symbols that have standard renamings.
     const newExport = this._parseMatSymbol(oldExport);
     if (newExport) {

src/material/schematics/ng-update/test-cases/v15/legacy-components-v15.spec.ts

@@ -43,6 +43,15 @@ describe('v15 legacy components migration', () => {
       expect(readLine(TS_FILE_PATH)).withContext(ctx).toEqual(opts.new);
     }
 
+    async function runMultilineTypeScriptMigrationTest(
+      ctx: string,
+      opts: {old: string[]; new: string[]},
+    ) {
+      writeLines(TS_FILE_PATH, opts.old);
+      await runMigration();
+      expect(readLines(TS_FILE_PATH)).withContext(ctx).toEqual(opts.new);
+    }
+
     describe('material --> legacy', () => {
       it('updates import declarations', async () => {
         await runTypeScriptMigrationTest('named binding', {
@@ -61,6 +70,24 @@ describe('v15 legacy components migration', () => {
           old: `import {MatButton, MatButtonModule as ButtonModule} from '@angular/material/button';`,
           new: `import {MatLegacyButton as MatButton, MatLegacyButtonModule as ButtonModule} from '@angular/material/legacy-button';`,
         });
+        await runMultilineTypeScriptMigrationTest('specific cases', {
+          old: [
+            `import {ProgressAnimationEnd, ProgressBarMode} from '@angular/material/progress-bar';`,
+            `import {ProgressSpinnerMode} from '@angular/material/progress-spinner';`,
+            `import {AutoFocusTarget, DialogRole, DialogPosition, _closeDialogVia, MatTestDialogOpener} from '@angular/material/dialog';`,
+            `import {SimpleSnackBar, TextOnlySnackBar} from '@angular/material/snack-bar';`,
+          ],
+          new: [
+            `import {LegacyProgressAnimationEnd as ProgressAnimationEnd, LegacyProgressBarMode as ProgressBarMode} from '@angular/material/legacy-progress-bar';`,
+            `import {LegacyProgressSpinnerMode as ProgressSpinnerMode} from '@angular/material/legacy-progress-spinner';`,
+            `import {LegacyAutoFocusTarget as AutoFocusTarget, LegacyDialogRole as DialogRole, LegacyDialogPosition as DialogPosition, _closeLegacyDialogVia as _closeDialogVia, MatTestLegacyDialogOpener as MatTestDialogOpener} from '@angular/material/legacy-dialog';`,
+            `import {LegacySimpleSnackBar as SimpleSnackBar, LegacyTextOnlySnackBar as TextOnlySnackBar} from '@angular/material/legacy-snack-bar';`,
+          ],
+        });
+        await runTypeScriptMigrationTest('specific case w/ alias', {
+          old: `import {ProgressBarMode as MatProgressBarMode} from '@angular/material/progress-bar';`,
+          new: `import {LegacyProgressBarMode as MatProgressBarMode} from '@angular/material/legacy-progress-bar';`,
+        });
       });
 
       it('updates import expressions', async () => {