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

angular · Sep 7, 2022 · cf0dd6c · cf0dd6c
1 parent d527ddf
commit cf0dd6c
Show file tree

Hide file tree

Showing 5 changed files with 49 additions and 3 deletions.
diff --git a/src/material/legacy-input/input-module.ts b/src/material/legacy-input/input-module.ts
@@ -12,6 +12,10 @@ import {ErrorStateMatcher, MatCommonModule} from '@angular/material/core';
 import {MatLegacyFormFieldModule} from '@angular/material/legacy-form-field';
 import {MatLegacyInput} from './input';
 
+/**
+ * @deprecated Use `MatInputModule` from `@angular/material/input` instead. See https://material.angular.io/guide/mdc-migration for information about migrating.
+ * @breaking-change 17.0.0
+ */
 @NgModule({
   declarations: [MatLegacyInput],
   imports: [TextFieldModule, MatLegacyFormFieldModule, MatCommonModule],

diff --git a/src/material/legacy-input/input.ts b/src/material/legacy-input/input.ts
@@ -14,7 +14,11 @@ import {
   MAT_LEGACY_FORM_FIELD,
 } from '@angular/material/legacy-form-field';
 
-/** Directive that allows a native input to work inside a `MatFormField`. */
+/**
+ * Directive that allows a native input to work inside a `MatFormField`.
+ * @deprecated Use `MatInput` from `@angular/material/input` instead. See https://material.angular.io/guide/mdc-migration for information about migrating.
+ * @breaking-change 17.0.0
+ */
 @Directive({
   selector: `input[matInput], textarea[matInput], select[matNativeControl],
       input[matNativeControl], textarea[matNativeControl]`,

diff --git a/src/material/legacy-input/public-api.ts b/src/material/legacy-input/public-api.ts
@@ -9,6 +9,15 @@
 export {MatLegacyInput} from './input';
 export {MatLegacyInputModule} from './input-module';
 export {
+  /**
+   * @deprecated Use `MAT_INPUT_VALUE_ACCESSOR` from `@angular/material/input` instead. See https://material.angular.io/guide/mdc-migration for information about migrating.
+   * @breaking-change 17.0.0
+   */
   MAT_INPUT_VALUE_ACCESSOR as MAT_LEGACY_INPUT_VALUE_ACCESSOR,
+
+  /**
+   * @deprecated Use `getMatInputUnsupportedTypeError` from `@angular/material/input` instead. See https://material.angular.io/guide/mdc-migration for information about migrating.
+   * @breaking-change 17.0.0
+   */
   getMatInputUnsupportedTypeError as getMatLegacyInputUnsupportedTypeError,
 } from '@angular/material/input';
diff --git a/src/material/legacy-input/testing/public-api.ts b/src/material/legacy-input/testing/public-api.ts
@@ -7,10 +7,39 @@
  */
 
 export {
+  /**
+   * @deprecated Use `InputHarnessFilters` from `@angular/material/input/testing` instead. See https://material.angular.io/guide/mdc-migration for information about migrating.
+   * @breaking-change 17.0.0
+   */
   InputHarnessFilters as LegacyInputHarnessFilters,
+
+  /**
+   * @deprecated Use `MatInputHarness` from `@angular/material/input/testing` instead. See https://material.angular.io/guide/mdc-migration for information about migrating.
+   * @breaking-change 17.0.0
+   */
   MatInputHarness as MatLegacyInputHarness,
+
+  /**
+   * @deprecated Use `MatNativeSelectHarness` from `@angular/material/input/testing` instead. See https://material.angular.io/guide/mdc-migration for information about migrating.
+   * @breaking-change 17.0.0
+   */
   MatNativeSelectHarness as MatLegacyNativeSelectHarness,
+
+  /**
+   * @deprecated Use `MatNativeOptionHarness` from `@angular/material/input/testing` instead. See https://material.angular.io/guide/mdc-migration for information about migrating.
+   * @breaking-change 17.0.0
+   */
   MatNativeOptionHarness as MatLegacyNativeOptionHarness,
+
+  /**
+   * @deprecated Use `NativeOptionHarnessFilters` from `@angular/material/input/testing` instead. See https://material.angular.io/guide/mdc-migration for information about migrating.
+   * @breaking-change 17.0.0
+   */
   NativeOptionHarnessFilters as LegacyNativeOptionHarnessFilters,
+
+  /**
+   * @deprecated Use `NativeSelectHarnessFilters` from `@angular/material/input/testing` instead. See https://material.angular.io/guide/mdc-migration for information about migrating.
+   * @breaking-change 17.0.0
+   */
   NativeSelectHarnessFilters as LegacyNativeSelectHarnessFilters,
 } from '@angular/material/input/testing';
diff --git a/tools/public_api_guard/material/legacy-input.md b/tools/public_api_guard/material/legacy-input.md
@@ -16,7 +16,7 @@ export { getMatLegacyInputUnsupportedTypeError }
 
 export { MAT_LEGACY_INPUT_VALUE_ACCESSOR }
 
-// @public
+// @public @deprecated
 export class MatLegacyInput extends MatInput {
     // (undocumented)
     protected _getPlaceholder(): string | null;
@@ -26,7 +26,7 @@ export class MatLegacyInput extends MatInput {
     static ɵfac: i0.ɵɵFactoryDeclaration<MatLegacyInput, never>;
 }
 
-// @public (undocumented)
+// @public @deprecated (undocumented)
 export class MatLegacyInputModule {
     // (undocumented)
     static ɵfac: i0.ɵɵFactoryDeclaration<MatLegacyInputModule, never>;