fix(material/legacy-button): deprecate all ts symbols

Author: mmalerba

src/material/legacy-button/button-module.ts

@@ -10,6 +10,10 @@ import {NgModule} from '@angular/core';
 import {MatCommonModule, MatRippleModule} from '@angular/material/core';
 import {MatLegacyAnchor, MatLegacyButton} from './button';
 
+/**
+ * @deprecated Use `MatButtonModule` from `@angular/material/button` instead. See https://material.angular.io/guide/mdc-migration for information about migrating.
+ * @breaking-change 17.0.0
+ */
 @NgModule({
   imports: [MatRippleModule, MatCommonModule],
   exports: [MatLegacyButton, MatLegacyAnchor, MatCommonModule],

src/material/legacy-button/button.ts

@@ -61,6 +61,8 @@ const _MatButtonBase = mixinColor(
 
 /**
  * Material design button.
+ * @deprecated Use `MatButton` from `@angular/material/button` instead. See https://material.angular.io/guide/mdc-migration for information about migrating.
+ * @breaking-change 17.0.0
  */
 @Component({
   selector: `button[mat-button], button[mat-raised-button], button[mat-icon-button],
@@ -153,6 +155,8 @@ export class MatLegacyButton
 
 /**
  * Material design anchor button.
+ * @deprecated Use `MatAnchor` from `@angular/material/button` instead. See https://material.angular.io/guide/mdc-migration for information about migrating.
+ * @breaking-change 17.0.0
  */
 @Component({
   selector: `a[mat-button], a[mat-raised-button], a[mat-icon-button], a[mat-fab],

src/material/legacy-button/testing/button-harness-filters.ts

@@ -8,7 +8,11 @@
 
 import {BaseHarnessFilters} from '@angular/cdk/testing';
 
-/** A set of criteria that can be used to filter a list of button harness instances. */
+/**
+ * A set of criteria that can be used to filter a list of button harness instances.
+ * @deprecated Use `ButtonHarnessFilters` from `@angular/material/button/testing` instead. See https://material.angular.io/guide/mdc-migration for information about migrating.
+ * @breaking-change 17.0.0
+ */
 export interface LegacyButtonHarnessFilters extends BaseHarnessFilters {
   /** Only find instances whose text matches the given value. */
   text?: string | RegExp;

src/material/legacy-button/testing/button-harness.ts

@@ -10,7 +10,11 @@ import {ContentContainerComponentHarness, HarnessPredicate} from '@angular/cdk/t
 import {coerceBooleanProperty} from '@angular/cdk/coercion';
 import {LegacyButtonHarnessFilters} from './button-harness-filters';
 
-/** Harness for interacting with a standard mat-button in tests. */
+/**
+ * Harness for interacting with a standard mat-button in tests.
+ * @deprecated Use `MatButtonHarness` from `@angular/material/button/testing` instead. See https://material.angular.io/guide/mdc-migration for information about migrating.
+ * @breaking-change 17.0.0
+ */
 export class MatLegacyButtonHarness extends ContentContainerComponentHarness {
   // TODO(jelbourn) use a single class, like `.mat-button-base`
   /** The selector for the host element of a button instance. */

tools/public_api_guard/material/legacy-button-testing.md

@@ -8,12 +8,12 @@ import { BaseHarnessFilters } from '@angular/cdk/testing';
 import { ContentContainerComponentHarness } from '@angular/cdk/testing';
 import { HarnessPredicate } from '@angular/cdk/testing';
 
-// @public
+// @public @deprecated
 export interface LegacyButtonHarnessFilters extends BaseHarnessFilters {
     text?: string | RegExp;
 }
 
-// @public
+// @public @deprecated
 export class MatLegacyButtonHarness extends ContentContainerComponentHarness {
     blur(): Promise<void>;
     click(relativeX: number, relativeY: number): Promise<void>;

tools/public_api_guard/material/legacy-button.md

@@ -20,7 +20,7 @@ import { MatRipple } from '@angular/material/core';
 import { NgZone } from '@angular/core';
 import { OnDestroy } from '@angular/core';
 
-// @public
+// @public @deprecated
 export class MatLegacyAnchor extends MatLegacyButton implements AfterViewInit, OnDestroy {
     constructor(focusMonitor: FocusMonitor, elementRef: ElementRef, animationMode: string,
     _ngZone?: NgZone | undefined);
@@ -37,7 +37,7 @@ export class MatLegacyAnchor extends MatLegacyButton implements AfterViewInit, O
     static ɵfac: i0.ɵɵFactoryDeclaration<MatLegacyAnchor, [null, null, { optional: true; }, { optional: true; }]>;
 }
 
-// @public
+// @public @deprecated
 export class MatLegacyButton extends _MatButtonBase implements AfterViewInit, OnDestroy, CanDisable, CanColor, CanDisableRipple, FocusableOption {
     constructor(elementRef: ElementRef, _focusMonitor: FocusMonitor, _animationMode: string);
     // (undocumented)
@@ -61,7 +61,7 @@ export class MatLegacyButton extends _MatButtonBase implements AfterViewInit, On
     static ɵfac: i0.ɵɵFactoryDeclaration<MatLegacyButton, [null, null, { optional: true; }]>;
 }
 
-// @public (undocumented)
+// @public @deprecated (undocumented)
 export class MatLegacyButtonModule {
     // (undocumented)
     static ɵfac: i0.ɵɵFactoryDeclaration<MatLegacyButtonModule, never>;