refactor: mark slide/step toggleAnimation methods internal and deprecated

Author: damyanpetev

CHANGELOG.md

@@ -10,12 +10,14 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
 - Exposed more public API type aliases for component property types like `ButtonVariant`, `PickerMode`, `StepperOrientation`, `HorizontalTransitionAnimation` (carousel and horizontal stepper) and more.
 
 ### Deprecated
-Some event argument types have been renamed for consistency:
-- `CheckboxChangeEventArgs` deprecated, use `IgcCheckboxChangeEventArgs` instead.
-- `RadioChangeEventArgs` deprecated, use `IgcRadioChangeEventArgs` instead.
-- `IgcRangeSliderValue` deprecated, use `IgcRangeSliderValueEventArgs` instead.
-- `IgcActiveStepChangingArgs` deprecated, use `IgcActiveStepChangingEventArgs` instead.
-- `IgcActiveStepChangedArgs` deprecated, use `IgcActiveStepChangedEventArgs` instead.
+- Some event argument types have been renamed for consistency:
+  - `CheckboxChangeEventArgs` deprecated, use `IgcCheckboxChangeEventArgs` instead.
+  - `RadioChangeEventArgs` deprecated, use `IgcRadioChangeEventArgs` instead.
+  - `IgcRangeSliderValue` deprecated, use `IgcRangeSliderValueEventArgs` instead.
+  - `IgcActiveStepChangingArgs` deprecated, use `IgcActiveStepChangingEventArgs` instead.
+  - `IgcActiveStepChangedArgs` deprecated, use `IgcActiveStepChangedEventArgs` instead.
+- Carousel Slide's `toggleAnimation` is now marked internal and deprecated for use in favor of parent Carousel's `select` method.
+- Stepper Step's `toggleAnimation` is now marked internal and deprecated for use in favor of parent Stepper's `navigateTo` method.
 
 ### Fixed
 - Setting validation properties on a pristine non-dirty form associated element does not apply invalid styles [#1632](https://github.com/IgniteUI/igniteui-webcomponents/issues/1632)

src/components/carousel/carousel-slide.ts

@@ -69,6 +69,10 @@ export default class IgcCarouselSlideComponent extends LitElement {
   @property({ type: Boolean, reflect: true })
   public previous = false;
 
+  /**
+   * @hidden @internal
+   * @deprecated since 5.4.0. Use Carousel's `select` method instead.
+   */
   public async toggleAnimation(
     type: 'in' | 'out',
     direction: 'normal' | 'reverse' = 'normal'

src/components/checkbox/checkbox-base.ts

@@ -20,7 +20,7 @@ export interface IgcCheckboxChangeEventArgs {
   value?: string;
 }
 
-/** @deprecated use IgcCheckboxChangeEventArgs instead */
+/** @deprecated since 5.4.0. Use IgcCheckboxChangeEventArgs instead */
 export type CheckboxChangeEventArgs = IgcCheckboxChangeEventArgs;
 
 export interface IgcCheckboxComponentEventMap {

src/components/radio/radio.ts

@@ -45,7 +45,7 @@ export interface IgcRadioChangeEventArgs {
   value?: string;
 }
 
-/** @deprecated use IgcRadioChangeEventArgs instead */
+/** @deprecated since 5.4.0. Use IgcRadioChangeEventArgs instead */
 export type RadioChangeEventArgs = IgcRadioChangeEventArgs;
 
 export interface IgcRadioComponentEventMap {

src/components/slider/range-slider.ts

@@ -16,7 +16,7 @@ export interface IgcRangeSliderValueEventArgs {
   upper: number;
 }
 
-/** @deprecated use IgcRangeSliderValueEventArgs instead */
+/** @deprecated since 5.4.0. Use IgcRangeSliderValueEventArgs instead */
 export type IgcRangeSliderValue = IgcRangeSliderValueEventArgs;
 
 export interface IgcRangeSliderComponentEventMap {

src/components/stepper/step.ts

@@ -156,6 +156,10 @@ export default class IgcStepComponent extends LitElement {
   @property({ attribute: false })
   public animationDuration = 350;
 
+  /**
+   * @hidden @internal
+   * @deprecated since 5.4.0. Use the Stepper's `navigateTo` method instead.
+   */
   public async toggleAnimation(
     type: 'in' | 'out',
     direction: 'normal' | 'reverse' = 'normal'

src/components/stepper/stepper.common.ts

@@ -7,9 +7,9 @@ export interface IgcActiveStepChangedEventArgs {
   index: number;
 }
 
-/** @deprecated use IgcActiveStepChangingEventArgs instead */
+/** @deprecated since 5.4.0. Use IgcActiveStepChangingEventArgs instead */
 export type IgcActiveStepChangingArgs = IgcActiveStepChangingEventArgs;
-/** @deprecated use IgcActiveStepChangedEventArgs instead */
+/** @deprecated since 5.4.0. Use IgcActiveStepChangedEventArgs instead */
 export type IgcActiveStepChangedArgs = IgcActiveStepChangedEventArgs;
 
 export interface IgcStepperComponentEventMap {