feat(schematics): support for ng-update. (#13303)

Introduces support for `ng update` of `@angular/cdk`. The Angular Material update schematic will share code with the CDK schematics code.

Author: devversion

src/cdk/schematics/index.ts

@@ -7,3 +7,4 @@
  */
 
 export * from './utils';
+export * from './ng-update/public-api';

src/cdk/schematics/migration.json

@@ -1,4 +1,20 @@
 {
   "$schema": "./node_modules/@angular-devkit/schematics/collection-schema.json",
-  "schematics": {}
+  "schematics": {
+    "migration-v6": {
+      "version": "6",
+      "description": "Updates the Angular CDK to v6",
+      "factory": "./ng-update/index#updateToV6"
+    },
+    "migration-v7": {
+      "version": "7",
+      "description": "Updates the Angular CDK to v7",
+      "factory": "./ng-update/index#updateToV7"
+    },
+    "ng-post-update": {
+      "description": "Prints out results after ng-update.",
+      "factory": "./ng-update/index#postUpdate",
+      "private": true
+    }
+  }
 }

src/lib/schematics/update/material/data/attribute-selectors.ts renamed to src/cdk/schematics/ng-update/data/attribute-selectors.ts

@@ -6,17 +6,17 @@
  * found in the LICENSE file at https://angular.io/license
  */
 
-import {TargetVersion} from '../../target-version';
-import {VersionChanges} from '../transform-change-data';
+import {TargetVersion} from '../target-version';
+import {VersionChanges} from '../upgrade-data';
 
-export interface MaterialAttributeSelectorData {
+export interface AttributeSelectorUpgradeData {
   /** The attribute name to replace. */
   replace: string;
   /** The new name for the attribute. */
   replaceWith: string;
 }
 
-export const attributeSelectors: VersionChanges<MaterialAttributeSelectorData> = {
+export const attributeSelectors: VersionChanges<AttributeSelectorUpgradeData> = {
   [TargetVersion.V6]: [
     {
       pr: 'https://github.com/angular/material2/pull/10257',

src/lib/schematics/update/material/data/class-names.ts renamed to src/cdk/schematics/ng-update/data/class-names.ts

@@ -6,17 +6,17 @@
  * found in the LICENSE file at https://angular.io/license
  */
 
-import {TargetVersion} from '../../target-version';
-import {VersionChanges} from '../transform-change-data';
+import {TargetVersion} from '../target-version';
+import {VersionChanges} from '../upgrade-data';
 
-export interface MaterialClassNameData {
+export interface ClassNameUpgradeData {
   /** The Class name to replace. */
   replace: string;
   /** The new name for the Class. */
   replaceWith: string;
 }
 
-export const classNames: VersionChanges<MaterialClassNameData> = {
+export const classNames: VersionChanges<ClassNameUpgradeData> = {
   [TargetVersion.V6]: [
     {
       pr: 'https://github.com/angular/material2/pull/10161',
@@ -42,24 +42,6 @@ export const classNames: VersionChanges<MaterialClassNameData> = {
       ]
     },
 
-    {
-      pr: 'https://github.com/angular/material2/pull/10291',
-      changes: [
-        {
-          replace: 'FloatPlaceholderType',
-          replaceWith: 'FloatLabelType'
-        },
-        {
-          replace: 'MAT_PLACEHOLDER_GLOBAL_OPTIONS',
-          replaceWith: 'MAT_LABEL_GLOBAL_OPTIONS'
-        },
-        {
-          replace: 'PlaceholderOptions',
-          replaceWith: 'LabelOptions'
-        }
-      ]
-    },
-
     {
       pr: 'https://github.com/angular/material2/pull/10325',
       changes: [

src/cdk/schematics/ng-update/data/constructor-checks.ts

@@ -0,0 +1,22 @@
+/**
+ * @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 {TargetVersion} from '../target-version';
+import {VersionChanges} from '../upgrade-data';
+
+export type ConstructorChecksUpgradeData = string;
+
+/**
+ * List of class names for which the constructor signature has been changed. The new constructor
+ * signature types don't need to be stored here because the signature will be determined
+ * automatically through type checking.
+ */
+export const constructorChecks: VersionChanges<ConstructorChecksUpgradeData> = {
+  [TargetVersion.V7]: [],
+  [TargetVersion.V6]: []
+};

src/cdk/schematics/ng-update/data/css-selectors.ts

@@ -0,0 +1,30 @@
+/**
+ * @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 {TargetVersion} from '../target-version';
+import {VersionChanges} from '../upgrade-data';
+
+export interface CssSelectorUpgradeData {
+  /** The CSS selector to replace. */
+  replace: string;
+  /** The new CSS selector. */
+  replaceWith: string;
+  /** Whitelist where this replacement is made. If omitted it is made in all files. */
+  whitelist?: {
+    /** Replace this name in stylesheet files. */
+    stylesheet?: boolean,
+    /** Replace this name in HTML files. */
+    html?: boolean,
+    /** Replace this name in TypeScript strings. */
+    strings?: boolean
+  };
+}
+
+export const cssSelectors: VersionChanges<CssSelectorUpgradeData> = {
+  [TargetVersion.V6]: []
+};

src/cdk/schematics/ng-update/data/element-selectors.ts

@@ -0,0 +1,21 @@
+/**
+ * @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 {TargetVersion} from '../target-version';
+import {VersionChanges} from '../upgrade-data';
+
+export interface ElementSelectorUpgradeData {
+  /** The element name to replace. */
+  replace: string;
+  /** The new name for the element. */
+  replaceWith: string;
+}
+
+export const elementSelectors: VersionChanges<ElementSelectorUpgradeData> = {
+  [TargetVersion.V6]: []
+};

src/cdk/schematics/ng-update/data/index.ts

@@ -0,0 +1,17 @@
+/**
+ * @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
+ */
+
+export * from './attribute-selectors';
+export * from './class-names';
+export * from './constructor-checks';
+export * from './css-selectors';
+export * from './element-selectors';
+export * from './input-names';
+export * from './method-call-checks';
+export * from './output-names';
+export * from './property-names';

src/lib/schematics/update/material/data/input-names.ts renamed to src/cdk/schematics/ng-update/data/input-names.ts

@@ -6,10 +6,10 @@
  * found in the LICENSE file at https://angular.io/license
  */
 
-import {TargetVersion} from '../../target-version';
-import {VersionChanges} from '../transform-change-data';
+import {TargetVersion} from '../target-version';
+import {VersionChanges} from '../upgrade-data';
 
-export interface MaterialInputNameData {
+export interface InputNameUpgradeData {
   /** The @Input() name to replace. */
   replace: string;
   /** The new name for the @Input(). */
@@ -23,7 +23,7 @@ export interface MaterialInputNameData {
   };
 }
 
-export const inputNames: VersionChanges<MaterialInputNameData> = {
+export const inputNames: VersionChanges<InputNameUpgradeData> = {
   [TargetVersion.V6]: [
     {
       pr: 'https://github.com/angular/material2/pull/10161',
@@ -114,110 +114,5 @@ export const inputNames: VersionChanges<MaterialInputNameData> = {
         }
       ]
     },
-
-    {
-      pr: 'https://github.com/angular/material2/pull/10218',
-      changes: [
-        {
-          replace: 'align',
-          replaceWith: 'labelPosition',
-          whitelist: {
-            elements: ['mat-radio-group', 'mat-radio-button']
-          }
-        }
-      ]
-    },
-
-    {
-      pr: 'https://github.com/angular/material2/pull/10279',
-      changes: [
-        {
-          replace: 'align',
-          replaceWith: 'position',
-          whitelist: {
-            elements: ['mat-drawer', 'mat-sidenav']
-          }
-        }
-      ]
-    },
-
-    {
-      pr: 'https://github.com/angular/material2/pull/10294',
-      changes: [
-        {
-          replace: 'dividerColor',
-          replaceWith: 'color',
-          whitelist: {
-            elements: ['mat-form-field']
-          }
-        },
-        {
-          replace: 'floatPlaceholder',
-          replaceWith: 'floatLabel',
-          whitelist: {
-            elements: ['mat-form-field']
-          }
-        }
-      ]
-    },
-
-    {
-      pr: 'https://github.com/angular/material2/pull/10309',
-      changes: [
-        {
-          replace: 'mat-dynamic-height',
-          replaceWith: 'dynamicHeight',
-          whitelist: {
-            elements: ['mat-tab-group']
-          }
-        }
-      ]
-    },
-
-    {
-      pr: 'https://github.com/angular/material2/pull/10342',
-      changes: [
-        {
-          replace: 'align',
-          replaceWith: 'labelPosition',
-          whitelist: {
-            elements: ['mat-checkbox']
-          }
-        }
-      ]
-    },
-
-    {
-      pr: 'https://github.com/angular/material2/pull/10344',
-      changes: [
-        {
-          replace: 'tooltip-position',
-          replaceWith: 'matTooltipPosition',
-          whitelist: {
-            attributes: ['matTooltip']
-          }
-        }
-      ]
-    },
-
-    {
-      pr: 'https://github.com/angular/material2/pull/10373',
-      changes: [
-        {
-          replace: 'thumb-label',
-          replaceWith: 'thumbLabel',
-          whitelist: {
-            elements: ['mat-slider']
-          }
-        },
-        {
-          replace: 'tick-interval',
-          replaceWith: 'tickInterval',
-          whitelist: {
-            elements: ['mat-slider']
-          }
-        }
-      ]
-    }
   ]
 };

src/lib/schematics/update/material/data/method-call-checks.ts renamed to src/cdk/schematics/ng-update/data/method-call-checks.ts

@@ -6,10 +6,10 @@
  * found in the LICENSE file at https://angular.io/license
  */
 
-import {TargetVersion} from '../../target-version';
-import {VersionChanges} from '../transform-change-data';
+import {TargetVersion} from '../target-version';
+import {VersionChanges} from '../upgrade-data';
 
-export interface MaterialMethodCallData {
+export interface MethodCallUpgradeData {
   className: string;
   method: string;
   invalidArgCounts: {
@@ -18,7 +18,7 @@ export interface MaterialMethodCallData {
   }[];
 }
 
-export const methodCallChecks: VersionChanges<MaterialMethodCallData> = {
+export const methodCallChecks: VersionChanges<MethodCallUpgradeData> = {
   [TargetVersion.V6]: [
     {
       pr: 'https://github.com/angular/material2/pull/10325',

src/cdk/schematics/ng-update/data/output-names.ts

@@ -0,0 +1,28 @@
+/**
+ * @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 {TargetVersion} from '../target-version';
+import {VersionChanges} from '../upgrade-data';
+
+export interface OutputNameUpgradeData {
+  /** The @Output() name to replace. */
+  replace: string;
+  /** The new name for the @Output(). */
+  replaceWith: string;
+  /** Whitelist where this replacement is made. If omitted it is made in all HTML & CSS */
+  whitelist: {
+    /** Limit to elements with any of these element tags. */
+    elements?: string[],
+    /** Limit to elements with any of these attributes. */
+    attributes?: string[],
+  };
+}
+
+export const outputNames: VersionChanges<OutputNameUpgradeData> = {
+  [TargetVersion.V6]: [],
+};