refactor(multiple): deprecate exposed ripples (#26914)

* refactor(multiple): deprecate exposed ripples

* fixup! refactor(multiple): deprecate exposed ripples

(cherry picked from commit 708c971)

Author: wagnermaciel

src/material/checkbox/checkbox.ts

@@ -180,7 +180,11 @@ export abstract class _MatCheckboxBase<E>
   /** The native `<label>` element */
   @ViewChild('label') _labelElement: ElementRef<HTMLInputElement>;
 
-  /** Reference to the ripple instance of the checkbox. */
+  /**
+   * Reference to the MatRipple instance of the checkbox.
+   * @deprecated Considered an implementation detail. To be removed.
+   * @breaking-change 17.0.0
+   */
   @ViewChild(MatRipple) ripple: MatRipple;
 
   /**

src/material/chips/chip.ts

@@ -246,7 +246,11 @@ export class MatChip
   /** The chip's trailing remove icon. */
   @ContentChild(MAT_CHIP_REMOVE) removeIcon: MatChipRemove;
 
-  /** Reference to the MatRipple instance of the chip. */
+  /**
+   * Reference to the MatRipple instance of the chip.
+   * @deprecated Considered an implementation detail. To be removed.
+   * @breaking-change 17.0.0
+   */
   @ViewChild(MatRipple) ripple: MatRipple;
 
   /** Action receiving the primary set of user interactions. */

tools/public_api_guard/material/checkbox.md

@@ -124,6 +124,7 @@ export abstract class _MatCheckboxBase<E> extends _MatCheckboxMixinBase implemen
     registerOnTouched(fn: any): void;
     get required(): boolean;
     set required(value: BooleanInput);
+    // @deprecated
     ripple: MatRipple;
     // (undocumented)
     setDisabledState(isDisabled: boolean): void;

tools/public_api_guard/material/chips.md

@@ -113,6 +113,7 @@ export class MatChip extends _MatChipMixinBase implements OnInit, AfterViewInit,
     remove(): void;
     readonly removed: EventEmitter<MatChipEvent>;
     removeIcon: MatChipRemove;
+    // @deprecated
     ripple: MatRipple;
     role: string | null;
     trailingIcon: MatChipTrailingIcon;