fix(material/theming): Add schematic to update token names in override mixins

Author: mmalerba

src/cdk/schematics/update-tool/target-version.ts

@@ -11,6 +11,7 @@
 // tslint:disable-next-line:prefer-const-enum
 export enum TargetVersion {
   V18 = 'version 18',
+  V19 = 'version 19',
 }
 
 /**

src/material/core/theming/tests/m3-theme.spec.ts

@@ -286,7 +286,7 @@ describe('M3 theme', () => {
           (
             (namespace: (mat, minimal-pseudo-checkbox), prefix: 'minimal-'),
             (mat, full-pseudo-checkbox)
-          ), 
+          ),
           (
             minimal-selected-checkmark-color: magenta,
             selected-checkmark-color: cyan
@@ -310,7 +310,7 @@ describe('M3 theme', () => {
         $theme: token-utils.extend-theme($theme,
           (
             (namespace: (mat, minimal-pseudo-checkbox), prefix: 'minimal-'),
-          ), 
+          ),
           (
             selected-checkmark-color: magenta
           )
@@ -334,7 +334,7 @@ describe('M3 theme', () => {
           (
             (namespace: (mat, minimal-pseudo-checkbox), prefix: 'both-'),
             (namespace: (mat, full-pseudo-checkbox), prefix: 'both-')
-          ), 
+          ),
           (
             both-selected-checkmark-color: magenta
           )

src/material/schematics/migration.json

@@ -5,6 +5,11 @@
       "version": "18.0.0-0",
       "description": "Updates Angular Material to v18",
       "factory": "./ng-update/index_bundled#updateToV18"
+    },
+    "migration-v19": {
+      "version": "19.0.0-0",
+      "description": "Updates Angular Material to v19",
+      "factory": "./ng-update/index_bundled#updateToV19"
     }
   }
 }

src/material/schematics/ng-update/index.ts

@@ -8,21 +8,33 @@
 
 import {Rule, SchematicContext} from '@angular-devkit/schematics';
 import {
-  createMigrationSchematicRule,
   NullableDevkitMigration,
   TargetVersion,
+  createMigrationSchematicRule,
 } from '@angular/cdk/schematics';
 
-import {materialUpgradeData} from './upgrade-data';
 import {M2ThemingMigration} from './migrations/m2-theming-v18';
+import {TokenOverridesMigration} from './migrations/token-overrides-v19';
+import {materialUpgradeData} from './upgrade-data';
 
-const materialMigrations: NullableDevkitMigration[] = [M2ThemingMigration];
+const materialMigrationsV18: NullableDevkitMigration[] = [M2ThemingMigration];
+const materialMigrationsV19: NullableDevkitMigration[] = [TokenOverridesMigration];
 
 /** Entry point for the migration schematics with target of Angular Material v18 */
 export function updateToV18(): Rule {
   return createMigrationSchematicRule(
     TargetVersion.V18,
-    materialMigrations,
+    materialMigrationsV18,
+    materialUpgradeData,
+    onMigrationComplete,
+  );
+}
+
+/** Entry point for the migration schematics with target of Angular Material v19 */
+export function updateToV19(): Rule {
+  return createMigrationSchematicRule(
+    TargetVersion.V19,
+    materialMigrationsV19,
     materialUpgradeData,
     onMigrationComplete,
   );

src/material/schematics/ng-update/migrations/token-overrides-v19/index.ts

@@ -0,0 +1,43 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.io/license
+ */
+
+import {extname} from '@angular-devkit/core';
+import {DevkitMigration, ResolvedResource, TargetVersion} from '@angular/cdk/schematics';
+import {migrateTokenOverridesUsages} from './migration';
+
+/** Migration that updates usages of the token overrides APIs in v19. */
+export class TokenOverridesMigration extends DevkitMigration<null> {
+  private _potentialThemes: ResolvedResource[] = [];
+
+  /** Whether to run this migration. */
+  enabled = this.targetVersion === TargetVersion.V19;
+
+  override visitStylesheet(stylesheet: ResolvedResource): void {
+    if (
+      extname(stylesheet.filePath) === '.scss' &&
+      // Note: intended to exclude `@angular/material-experimental`.
+      stylesheet.content.match(/@angular\/material["']/)
+    ) {
+      this._potentialThemes.push(stylesheet);
+    }
+  }
+
+  override postAnalysis(): void {
+    for (const theme of this._potentialThemes) {
+      const migrated = migrateTokenOverridesUsages(theme.content);
+
+      if (migrated !== theme.content) {
+        this.fileSystem
+          .edit(theme.filePath)
+          .remove(0, theme.content.length)
+          .insertLeft(0, migrated);
+        this.fileSystem.commitEdits();
+      }
+    }
+  }
+}