docs: add info on AbstractControl.source type. (#58094)

JeanMeche · AndrewKushnir · commit 186b52449af7 · 2024-10-07T08:21:55.000-07:00
The source can be of any type and can't be inferred from `T` fixes #58076 PR Close #58094
diff --git a/packages/forms/src/model/abstract_model.ts b/packages/forms/src/model/abstract_model.ts
@@ -92,6 +92,8 @@ export type FormControlStatus = 'VALID' | 'INVALID' | 'PENDING' | 'DISABLED';
 export abstract class ControlEvent<T = any> {
   /**
    * Form control from which this event is originated.
+   *
+   * Note: the type of the control can't be infered from T as the event can be emitted by any of child controls
    */
   public abstract readonly source: AbstractControl<unknown>;
 }

Original file line number	Diff line number	Diff line change
`@@ -92,6 +92,8 @@ export type FormControlStatus = 'VALID' \| 'INVALID' \| 'PENDING' \| 'DISABLED';`
`92`	`92`	`export abstract class ControlEvent<T = any> {`
`93`	`93`	`/**`
`94`	`94`	`* Form control from which this event is originated.`
	`95`	`+ *`
	`96`	`+ * Note: the type of the control can't be infered from T as the event can be emitted by any of child controls`
`95`	`97`	`*/`
`96`	`98`	`public abstract readonly source: AbstractControl<unknown>;`
`97`	`99`	`}`