refactor(forms): deprecate unwanted control events aliases

This commit deprecates the aliases for the control events to ease the changes in G3 A follow-up commit will remove those deprecated entries.
JeanMeche · May 8, 2024 · 57fe249 · 57fe249
1 parent 1872fcd
commit 57fe249
Show file tree

Hide file tree

Showing 3 changed files with 36 additions and 6 deletions.
diff --git a/goldens/public-api/forms/index.md b/goldens/public-api/forms/index.md
@@ -786,14 +786,18 @@ export class PatternValidator extends AbstractValidatorDirective {
 }
 
 // @public
-export class PristineEvent extends ControlEvent {
+export class PristineChangeEvent extends ControlEvent {
     constructor(pristine: boolean, source: AbstractControl);
     // (undocumented)
     readonly pristine: boolean;
     // (undocumented)
     readonly source: AbstractControl;
 }
 
+// @public @deprecated (undocumented)
+export class PristineEvent extends PristineChangeEvent {
+}
+
 // @public
 export class RadioControlValueAccessor extends BuiltInControlValueAccessor implements ControlValueAccessor, OnDestroy, OnInit {
     constructor(renderer: Renderer2, elementRef: ElementRef, _registry: RadioControlRegistry, _injector: Injector);
@@ -880,23 +884,31 @@ export class SelectMultipleControlValueAccessor extends BuiltInControlValueAcces
 export type SetDisabledStateOption = 'whenDisabledForLegacyCode' | 'always';
 
 // @public
-export class StatusEvent extends ControlEvent {
+export class StatusChangeEvent extends ControlEvent {
     constructor(status: FormControlStatus, source: AbstractControl);
     // (undocumented)
     readonly source: AbstractControl;
     // (undocumented)
     readonly status: FormControlStatus;
 }
 
+// @public @deprecated (undocumented)
+export class StatusEvent extends StatusChangeEvent {
+}
+
 // @public
-export class TouchedEvent extends ControlEvent {
+export class TouchedChangeEvent extends ControlEvent {
     constructor(touched: boolean, source: AbstractControl);
     // (undocumented)
     readonly source: AbstractControl;
     // (undocumented)
     readonly touched: boolean;
 }
 
+// @public @deprecated (undocumented)
+export class TouchedEvent extends TouchedChangeEvent {
+}
+
 // @public
 export type UntypedFormArray = FormArray<any>;
 

diff --git a/packages/forms/src/forms.ts b/packages/forms/src/forms.ts
@@ -74,9 +74,12 @@ export {
   AbstractControlOptions,
   ControlEvent,
   FormControlStatus,
-  PristineChangeEvent as PristineEvent,
-  StatusChangeEvent as StatusEvent,
-  TouchedChangeEvent as TouchedEvent,
+  PristineEvent,
+  StatusEvent,
+  TouchedEvent,
+  PristineChangeEvent,
+  StatusChangeEvent,
+  TouchedChangeEvent,
   ValueChangeEvent,
   ɵCoerceStrArrToNumArr,
   ɵGetProperty,

diff --git a/packages/forms/src/model/abstract_model.ts b/packages/forms/src/model/abstract_model.ts
@@ -116,6 +116,11 @@ export class PristineChangeEvent extends ControlEvent {
   }
 }
 
+/**
+ * @deprecated use `PristineChangeEvent` symbol instead.
+ */
+export class PristineEvent extends PristineChangeEvent {}
+
 /**
  * Event fired when the control's touched status changes (touched <=> untouched).
  *
@@ -130,6 +135,11 @@ export class TouchedChangeEvent extends ControlEvent {
   }
 }
 
+/**
+ * @deprecated use `TouchedChangeEvent` symbol instead.
+ */
+export class TouchedEvent extends TouchedChangeEvent {}
+
 /**
  * Event fired when the control's status changes.
  *
@@ -144,6 +154,11 @@ export class StatusChangeEvent extends ControlEvent {
   }
 }
 
+/**
+ * @deprecated use `StatusChangeEvent` symbol instead.
+ */
+export class StatusEvent extends StatusChangeEvent {}
+
 /**
  * Gets validators from either an options object or given validators.
  */