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

Author: mmalerba

src/material/legacy-slide-toggle/public-api.ts

@@ -17,8 +17,27 @@ export {
   MAT_LEGACY_SLIDE_TOGGLE_DEFAULT_OPTIONS,
 } from './slide-toggle-config';
 export {
+  /**
+   * @deprecated Use `_MatSlideToggleBase` from `@angular/material/slide-toggle` instead. See https://material.angular.io/guide/mdc-migration for information about migrating.
+   * @breaking-change 17.0.0
+   */
   _MatSlideToggleBase as _MatLegacySlideToggleBase,
+
+  /**
+   * @deprecated Use `_MatSlideToggleRequiredValidatorModule` from `@angular/material/slide-toggle` instead. See https://material.angular.io/guide/mdc-migration for information about migrating.
+   * @breaking-change 17.0.0
+   */
   _MatSlideToggleRequiredValidatorModule as _MatLegacySlideToggleRequiredValidatorModule,
+
+  /**
+   * @deprecated Use `MAT_SLIDE_TOGGLE_REQUIRED_VALIDATOR` from `@angular/material/slide-toggle` instead. See https://material.angular.io/guide/mdc-migration for information about migrating.
+   * @breaking-change 17.0.0
+   */
   MAT_SLIDE_TOGGLE_REQUIRED_VALIDATOR as MAT_LEGACY_SLIDE_TOGGLE_REQUIRED_VALIDATOR,
+
+  /**
+   * @deprecated Use `MatSlideToggleRequiredValidator` from `@angular/material/slide-toggle` instead. See https://material.angular.io/guide/mdc-migration for information about migrating.
+   * @breaking-change 17.0.0
+   */
   MatSlideToggleRequiredValidator as MatLegacySlideToggleRequiredValidator,
 } from '@angular/material/slide-toggle';

src/material/legacy-slide-toggle/slide-toggle-config.ts

@@ -8,7 +8,11 @@
 import {InjectionToken} from '@angular/core';
 import {ThemePalette} from '@angular/material/core';
 
-/** Default `mat-slide-toggle` options that can be overridden. */
+/**
+ * Default `mat-slide-toggle` options that can be overridden.
+ * @deprecated Use `MatSlideToggleDefaultOptions` from `@angular/material/slide-toggle` instead. See https://material.angular.io/guide/mdc-migration for information about migrating.
+ * @breaking-change 17.0.0
+ */
 export interface MatLegacySlideToggleDefaultOptions {
   /** Whether toggle action triggers value changes in slide toggle. */
   disableToggleValue?: boolean;
@@ -17,7 +21,11 @@ export interface MatLegacySlideToggleDefaultOptions {
   color?: ThemePalette;
 }
 
-/** Injection token to be used to override the default options for `mat-slide-toggle`. */
+/**
+ * Injection token to be used to override the default options for `mat-slide-toggle`
+ * @deprecated Use `MAT_SLIDE_TOGGLE_DEFAULT_OPTIONS` from `@angular/material/slide-toggle` instead. See https://material.angular.io/guide/mdc-migration for information about migrating.
+ * @breaking-change 17.0.0
+ */
 export const MAT_LEGACY_SLIDE_TOGGLE_DEFAULT_OPTIONS =
   new InjectionToken<MatLegacySlideToggleDefaultOptions>('mat-slide-toggle-default-options', {
     providedIn: 'root',

src/material/legacy-slide-toggle/slide-toggle-module.ts

@@ -12,6 +12,10 @@ import {MatCommonModule, MatRippleModule} from '@angular/material/core';
 import {MatLegacySlideToggle} from './slide-toggle';
 import {_MatSlideToggleRequiredValidatorModule} from '@angular/material/slide-toggle';
 
+/**
+ * @deprecated Use `MatSlideToggleModule` from `@angular/material/slide-toggle` instead. See https://material.angular.io/guide/mdc-migration for information about migrating.
+ * @breaking-change 17.0.0
+ */
 @NgModule({
   imports: [
     _MatSlideToggleRequiredValidatorModule,

src/material/legacy-slide-toggle/slide-toggle.ts

@@ -27,14 +27,22 @@ import {
 } from './slide-toggle-config';
 import {_MatSlideToggleBase} from '@angular/material/slide-toggle';
 
-/** @docs-private */
+/**
+ * @docs-private
+ * @deprecated Use `MAT_SLIDE_TOGGLE_VALUE_ACCESSOR` from `@angular/material/slide-toggle` instead. See https://material.angular.io/guide/mdc-migration for information about migrating.
+ * @breaking-change 17.0.0
+ */
 export const MAT_LEGACY_SLIDE_TOGGLE_VALUE_ACCESSOR = {
   provide: NG_VALUE_ACCESSOR,
   useExisting: forwardRef(() => MatLegacySlideToggle),
   multi: true,
 };
 
-/** Change event object emitted by a slide toggle. */
+/**
+ * Change event object emitted by a slide toggle.
+ * @deprecated Use `MatSlideToggleChange` from `@angular/material/slide-toggle` instead. See https://material.angular.io/guide/mdc-migration for information about migrating.
+ * @breaking-change 17.0.0
+ */
 export class MatLegacySlideToggleChange {
   constructor(
     /** The source slide toggle of the event. */
@@ -44,7 +52,11 @@ export class MatLegacySlideToggleChange {
   ) {}
 }
 
-/** Represents a slidable "switch" toggle that can be moved between on and off. */
+/**
+ * Represents a slidable "switch" toggle that can be moved between on and off.
+ * @deprecated Use `MatSlideToggle` from `@angular/material/slide-toggle` instead. See https://material.angular.io/guide/mdc-migration for information about migrating.
+ * @breaking-change 17.0.0
+ */
 @Component({
   selector: 'mat-slide-toggle',
   exportAs: 'matSlideToggle',

src/material/legacy-slide-toggle/testing/public-api.ts

@@ -8,6 +8,15 @@
 
 export {MatLegacySlideToggleHarness} from './slide-toggle-harness';
 export {
+  /**
+   * @deprecated Use `_MatSlideToggleHarnessBase` from `@angular/material/slide-toggle/testing` instead. See https://material.angular.io/guide/mdc-migration for information about migrating.
+   * @breaking-change 17.0.0
+   */
   _MatSlideToggleHarnessBase as _MatLegacySlideToggleHarnessBase,
+
+  /**
+   * @deprecated Use `SlideToggleHarnessFilters` from `@angular/material/slide-toggle/testing` instead. See https://material.angular.io/guide/mdc-migration for information about migrating.
+   * @breaking-change 17.0.0
+   */
   SlideToggleHarnessFilters as LegacySlideToggleHarnessFilters,
 } from '@angular/material/slide-toggle/testing';

src/material/legacy-slide-toggle/testing/slide-toggle-harness.ts

@@ -13,7 +13,11 @@ import {
   SlideToggleHarnessFilters,
 } from '@angular/material/slide-toggle/testing';
 
-/** Harness for interacting with a standard mat-slide-toggle in tests. */
+/**
+ * Harness for interacting with a standard mat-slide-toggle in tests.
+ * @deprecated Use `MatSlideToggleHarness` from `@angular/material/slide-toggle/testing` instead. See https://material.angular.io/guide/mdc-migration for information about migrating.
+ * @breaking-change 17.0.0
+ */
 export class MatLegacySlideToggleHarness extends _MatSlideToggleHarnessBase {
   private _inputContainer = this.locatorFor('.mat-slide-toggle-bar');
   protected _nativeElement = this.locatorFor('input');

tools/public_api_guard/material/legacy-slide-toggle-testing.md

@@ -12,7 +12,7 @@ import { TestElement } from '@angular/cdk/testing';
 
 export { LegacySlideToggleHarnessFilters }
 
-// @public
+// @public @deprecated
 export class MatLegacySlideToggleHarness extends _MatLegacySlideToggleHarnessBase {
     static hostSelector: string;
     isChecked(): Promise<boolean>;

tools/public_api_guard/material/legacy-slide-toggle.md

@@ -21,19 +21,19 @@ import { _MatSlideToggleRequiredValidatorModule as _MatLegacySlideToggleRequired
 import { ThemePalette } from '@angular/material/core';
 import { Type } from '@angular/core';
 
-// @public
+// @public @deprecated
 export const MAT_LEGACY_SLIDE_TOGGLE_DEFAULT_OPTIONS: InjectionToken<MatLegacySlideToggleDefaultOptions>;
 
 export { MAT_LEGACY_SLIDE_TOGGLE_REQUIRED_VALIDATOR }
 
-// @public
+// @public @deprecated
 export const MAT_LEGACY_SLIDE_TOGGLE_VALUE_ACCESSOR: {
     provide: InjectionToken<readonly ControlValueAccessor[]>;
     useExisting: Type<any>;
     multi: boolean;
 };
 
-// @public
+// @public @deprecated
 export class MatLegacySlideToggle extends _MatLegacySlideToggleBase<MatLegacySlideToggleChange> {
     constructor(elementRef: ElementRef, focusMonitor: FocusMonitor, changeDetectorRef: ChangeDetectorRef, tabIndex: string, defaults: MatLegacySlideToggleDefaultOptions, animationMode?: string);
     // (undocumented)
@@ -51,7 +51,7 @@ export class MatLegacySlideToggle extends _MatLegacySlideToggleBase<MatLegacySli
 
 export { _MatLegacySlideToggleBase }
 
-// @public
+// @public @deprecated
 export class MatLegacySlideToggleChange {
     constructor(
     source: MatLegacySlideToggle,
@@ -60,13 +60,13 @@ export class MatLegacySlideToggleChange {
     source: MatLegacySlideToggle;
 }
 
-// @public
+// @public @deprecated
 export interface MatLegacySlideToggleDefaultOptions {
     color?: ThemePalette;
     disableToggleValue?: boolean;
 }
 
-// @public (undocumented)
+// @public @deprecated (undocumented)
 export class MatLegacySlideToggleModule {
     // (undocumented)
     static ɵfac: i0.ɵɵFactoryDeclaration<MatLegacySlideToggleModule, never>;