@angular/forms 18.0.0-next.3 → 18.0.0-next.5

package/index.d.ts

@@ -1,6 +1,6 @@
 /**
- * @license Angular v18.0.0-next.3
- * (c) 2010-2022 Google LLC. https://angular.io/
+ * @license Angular v18.0.0-next.5
+ * (c) 2010-2024 Google LLC. https://angular.io/
  * License: MIT
  */
 
@@ -34,9 +34,9 @@ import { Version } from '@angular/core';
  * The first type parameter TValue represents the value type of the control (`control.value`).
  * The optional type parameter TRawValue  represents the raw value type (`control.getRawValue()`).
  *
- * @see [Forms Guide](/guide/forms)
- * @see [Reactive Forms Guide](/guide/reactive-forms)
- * @see [Dynamic Forms Guide](/guide/dynamic-form)
+ * @see [Forms Guide](guide/forms)
+ * @see [Reactive Forms Guide](guide/forms/reactive-forms)
+ * @see [Dynamic Forms Guide](guide/forms/dynamic-forms)
  *
  * @publicApi
  */
@@ -369,6 +369,9 @@ export declare abstract class AbstractControl<TValue = any, TRawValue extends TV
      * and emits events after marking is applied.
      * * `onlySelf`: When true, mark only this control. When false or not supplied,
      * marks all direct ancestors. Default is false.
+     * * `emitEvent`: When true or not supplied (the default), the `events`
+     * observable emits a `TouchedChangeEvent` with the `touched` property being `true`.
+     * When false, no events are emitted.
      */
     markAsTouched(opts?: {
         onlySelf?: boolean;
@@ -377,6 +380,12 @@ export declare abstract class AbstractControl<TValue = any, TRawValue extends TV
     /**
      * Marks the control and all its descendant controls as `touched`.
      * @see {@link markAsTouched()}
+     *
+     * @param opts Configuration options that determine how the control propagates changes
+     * and emits events after marking is applied.
+     * * `emitEvent`: When true or not supplied (the default), the `events`
+     * observable emits a `TouchedChangeEvent` with the `touched` property being `true`.
+     * When false, no events are emitted.
      */
     markAllAsTouched(opts?: {
         emitEvent?: boolean;
@@ -395,6 +404,9 @@ export declare abstract class AbstractControl<TValue = any, TRawValue extends TV
      * and emits events after the marking is applied.
      * * `onlySelf`: When true, mark only this control. When false or not supplied,
      * marks all direct ancestors. Default is false.
+     * * `emitEvent`: When true or not supplied (the default), the `events`
+     * observable emits a `TouchedChangeEvent` with the `touched` property being `false`.
+     * When false, no events are emitted.
      */
     markAsUntouched(opts?: {
         onlySelf?: boolean;
@@ -455,8 +467,9 @@ export declare abstract class AbstractControl<TValue = any, TRawValue extends TV
      * * `onlySelf`: When true, mark only this control. When false or not supplied,
      * marks all direct ancestors. Default is false.
      * * `emitEvent`: When true or not supplied (the default), the `statusChanges`
-     * observable emits an event with the latest status the control is marked pending.
-     * When false, no events are emitted.
+     * observable emits an event with the latest status the control is marked pending
+     * and the `events` observable emits a `StatusChangeEvent` with the `status` property being
+     * `PENDING` When false, no events are emitted.
      *
      */
     markAsPending(opts?: {
@@ -475,8 +488,8 @@ export declare abstract class AbstractControl<TValue = any, TRawValue extends TV
      * changes and emits events after the control is disabled.
      * * `onlySelf`: When true, mark only this control. When false or not supplied,
      * marks all direct ancestors. Default is false.
-     * * `emitEvent`: When true or not supplied (the default), both the `statusChanges` and
-     * `valueChanges`
+     * * `emitEvent`: When true or not supplied (the default), the `statusChanges`,
+     * `valueChanges` and `events`
      * observables emit events with the latest status and value when the control is disabled.
      * When false, no events are emitted.
      */
@@ -497,8 +510,8 @@ export declare abstract class AbstractControl<TValue = any, TRawValue extends TV
      * emits events when marked as untouched
      * * `onlySelf`: When true, mark only this control. When false or not supplied,
      * marks all direct ancestors. Default is false.
-     * * `emitEvent`: When true or not supplied (the default), both the `statusChanges` and
-     * `valueChanges`
+     * * `emitEvent`: When true or not supplied (the default), the `statusChanges`,
+     * `valueChanges` and `events`
      * observables emit events with the latest status and value when the control is enabled.
      * When false, no events are emitted.
      */
@@ -539,8 +552,8 @@ export declare abstract class AbstractControl<TValue = any, TRawValue extends TV
      * after updates and validity checks are applied.
      * * `onlySelf`: When true, only update this control. When false or not supplied,
      * update all direct ancestors. Default is false.
-     * * `emitEvent`: When true or not supplied (the default), both the `statusChanges` and
-     * `valueChanges`
+     * * `emitEvent`: When true or not supplied (the default), the `statusChanges`,
+     * `valueChanges` and `events`
      * observables emit events with the latest status and value when the control is updated.
      * When false, no events are emitted.
      */
@@ -1129,7 +1142,7 @@ export declare class CheckboxControlValueAccessor extends BuiltInControlValueAcc
  * A Directive that adds the `required` validator to checkbox controls marked with the
  * `required` attribute. The directive is provided with the `NG_VALIDATORS` multi-provider list.
  *
- * @see [Form Validation](guide/form-validation)
+ * @see [Form Validation](guide/forms/form-validation)
  *
  * @usageNotes
  *
@@ -1389,7 +1402,7 @@ declare const EMAIL_VALIDATOR: any;
  * incorporate more RFC rules. More information can be found on the [Validators.email
  * page](api/forms/Validators#email).
  *
- * @see [Form Validation](guide/form-validation)
+ * @see [Form Validation](guide/forms/form-validation)
  *
  * @usageNotes
  *
@@ -1821,7 +1834,7 @@ export declare class FormArray<TControl extends AbstractControl<any> = any> exte
  * will look for a `FormArray` registered with that name in the parent
  * `FormGroup` instance you passed into `FormGroupDirective`.
  *
- * @see [Reactive Forms Guide](guide/reactive-forms)
+ * @see [Reactive Forms Guide](guide/forms/reactive-forms)
  * @see {@link AbstractControl}
  *
  * @usageNotes
@@ -1887,7 +1900,7 @@ declare const formArrayNameProvider: any;
  * `FormControl`, `FormGroup`, or `FormArray`. It reduces the amount of boilerplate needed to
  * build complex forms.
  *
- * @see [Reactive Forms Guide](guide/reactive-forms)
+ * @see [Reactive Forms Guide](guide/forms/reactive-forms)
  *
  * @publicApi
  */
@@ -2046,7 +2059,7 @@ export declare class FormBuilder {
  * See [usage examples below](#usage-notes).
  *
  * @see {@link AbstractControl}
- * @see [Reactive Forms Guide](guide/reactive-forms)
+ * @see [Reactive Forms Guide](guide/forms/reactive-forms)
  * @see [Usage Notes](#usage-notes)
  *
  * @publicApi
@@ -2283,9 +2296,8 @@ export declare const FormControl: ɵFormControlCtor;
  * Note that support for using the `ngModel` input property and `ngModelChange` event with reactive
  * form directives was deprecated in Angular v6 and is scheduled for removal in
  * a future version of Angular.
- * For details, see [Deprecated features](guide/deprecations#ngmodel-with-reactive-forms).
  *
- * @see [Reactive Forms Guide](guide/reactive-forms)
+ * @see [Reactive Forms Guide](guide/forms/reactive-forms)
  * @see {@link FormControl}
  * @see {@link AbstractControl}
  *
@@ -2353,7 +2365,7 @@ export declare class FormControlDirective extends NgControl implements OnChanges
  * Syncs a `FormControl` in an existing `FormGroup` to a form control
  * element by name.
  *
- * @see [Reactive Forms Guide](guide/reactive-forms)
+ * @see [Reactive Forms Guide](guide/forms/reactive-forms)
  * @see {@link FormControl}
  * @see {@link AbstractControl}
  *
@@ -2377,8 +2389,6 @@ export declare class FormControlDirective extends NgControl implements OnChanges
  * form directives has been deprecated in Angular v6 and is scheduled for removal in
  * a future version of Angular.
  *
- * For details, see [Deprecated features](guide/deprecations#ngmodel-with-reactive-forms).
- *
  * @ngModule ReactiveFormsModule
  * @publicApi
  */
@@ -2856,7 +2866,7 @@ export declare class FormGroup<TControl extends {
  * and `FormArray` instances to child `FormControlName`, `FormGroupName`,
  * and `FormArrayName` directives.
  *
- * @see [Reactive Forms Guide](guide/reactive-forms)
+ * @see [Reactive Forms Guide](guide/forms/reactive-forms)
  * @see {@link AbstractControl}
  *
  * @usageNotes
@@ -3036,7 +3046,7 @@ export declare class FormGroupDirective extends ControlContainer implements Form
  * form separately from the rest or to group the values of certain
  * controls into their own nested object.
  *
- * @see [Reactive Forms Guide](guide/reactive-forms)
+ * @see [Reactive Forms Guide](guide/forms/reactive-forms)
  *
  * @usageNotes
  *
@@ -3198,8 +3208,8 @@ export declare interface FormRecord<TControl> {
  * Exports the required providers and directives for template-driven forms,
  * making them available for import by NgModules that import this module.
  *
- * @see [Forms Overview](/guide/forms-overview)
- * @see [Template-driven Forms Guide](/guide/forms)
+ * @see [Forms Overview](guide/forms)
+ * @see [Template-driven Forms Guide](guide/forms)
  *
  * @publicApi
  */
@@ -3438,7 +3448,7 @@ declare const MAX_VALIDATOR: Provider;
  * A directive that adds maximum length validation to controls marked with the
  * `maxlength` attribute. The directive is provided with the `NG_VALIDATORS` multi-provider list.
  *
- * @see [Form Validation](guide/form-validation)
+ * @see [Form Validation](guide/forms/form-validation)
  *
  * @usageNotes
  *
@@ -3469,7 +3479,7 @@ export declare class MaxLengthValidator extends AbstractValidatorDirective {
  * A directive which installs the {@link MaxValidator} for any `formControlName`,
  * `formControl`, or control with `ngModel` that also has a `max` attribute.
  *
- * @see [Form Validation](guide/form-validation)
+ * @see [Form Validation](guide/forms/form-validation)
  *
  * @usageNotes
  *
@@ -3512,7 +3522,7 @@ declare const MIN_VALIDATOR: Provider;
  * A directive that adds minimum length validation to controls marked with the
  * `minlength` attribute. The directive is provided with the `NG_VALIDATORS` multi-provider list.
  *
- * @see [Form Validation](guide/form-validation)
+ * @see [Form Validation](guide/forms/form-validation)
  *
  * @usageNotes
  *
@@ -3543,7 +3553,7 @@ export declare class MinLengthValidator extends AbstractValidatorDirective {
  * A directive which installs the {@link MinValidator} for any `formControlName`,
  * `formControl`, or control with `ngModel` that also has a `min` attribute.
  *
- * @see [Form Validation](guide/form-validation)
+ * @see [Form Validation](guide/forms/form-validation)
  *
  * @usageNotes
  *
@@ -4289,7 +4299,7 @@ declare const PATTERN_VALIDATOR: any;
  * `pattern` attribute. The regex must match the entire control value.
  * The directive is provided with the `NG_VALIDATORS` multi-provider list.
  *
- * @see [Form Validation](guide/form-validation)
+ * @see [Form Validation](guide/forms/form-validation)
  *
  * @usageNotes
  *
@@ -4493,8 +4503,8 @@ declare const REACTIVE_DRIVEN_DIRECTIVES: Type<any>[];
  * Exports the required infrastructure and directives for reactive forms,
  * making them available for import by NgModules that import this module.
  *
- * @see [Forms Overview](guide/forms-overview)
- * @see [Reactive Forms Guide](guide/reactive-forms)
+ * @see [Forms Overview](guide/forms)
+ * @see [Reactive Forms Guide](guide/forms/reactive-forms)
  *
  * @publicApi
  */
@@ -4529,7 +4539,7 @@ declare const REQUIRED_VALIDATOR: Provider;
  * A directive that adds the `required` validator to any controls marked with the
  * `required` attribute. The directive is provided with the `NG_VALIDATORS` multi-provider list.
  *
- * @see [Form Validation](guide/form-validation)
+ * @see [Form Validation](guide/forms/form-validation)
  *
  * @usageNotes
  *
@@ -4895,7 +4905,7 @@ export declare interface ValidatorFn {
  * A validator is a function that processes a `FormControl` or collection of
  * controls and returns an error map or null. A null map means that validation has passed.
  *
- * @see [Form Validation](/guide/form-validation)
+ * @see [Form Validation](guide/forms/form-validation)
  *
  * @publicApi
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular/forms",
-  "version": "18.0.0-next.3",
+  "version": "18.0.0-next.5",
   "description": "Angular - directives and services for creating forms",
   "author": "angular",
   "license": "MIT",
@@ -11,9 +11,9 @@
     "tslib": "^2.3.0"
   },
   "peerDependencies": {
-    "@angular/core": "18.0.0-next.3",
-    "@angular/common": "18.0.0-next.3",
-    "@angular/platform-browser": "18.0.0-next.3",
+    "@angular/core": "18.0.0-next.5",
+    "@angular/common": "18.0.0-next.5",
+    "@angular/platform-browser": "18.0.0-next.5",
     "rxjs": "^6.5.3 || ^7.4.0"
   },
   "repository": {