angular/packages/forms
arturovt a7b9ff5a58 docs: document FormBuilder.group() controlsConfig value shapes
The `@param` JSDoc for `FormBuilder.group()` previously described the argument only as “a collection of child controls”, without explaining the four supported value shapes:

* a raw value
* a `FormControlState`
* a `ControlConfig` tuple
* a pre-built `AbstractControl`

The fact that the second element of a `ControlConfig` tuple can accept `AbstractControlOptions` (for example to configure per-control `updateOn`) was especially non-obvious and undocumented.

This change adds a `@usageNotes` section with concrete examples covering each supported shape.

Closes #43984

(cherry picked from commit 3b8503f960)
2026-05-20 14:07:59 -07:00
..
signals fix(forms): prohibit concurrent submits in signal forms 2026-05-05 11:14:08 -07:00
src docs: document FormBuilder.group() controlsConfig value shapes 2026-05-20 14:07:59 -07:00
test test(forms): move timeout and autoTick helpers to shared testing utilities 2026-02-10 07:45:00 -08:00
BUILD.bazel build: don't substitute binary files 2026-01-21 10:35:04 -08:00
index.ts refactor: update license text to point to angular.dev (#57901) 2024-09-24 15:33:00 +02:00
package.json build(forms): setup infrastructure for code examples 2026-01-05 12:36:00 -05:00
PACKAGE.md build: format md files 2025-11-06 10:03:05 -08:00
public_api.ts refactor: update license text to point to angular.dev (#57901) 2024-09-24 15:33:00 +02:00