angular/packages
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
..
animations test: remove duplicate tests 2026-03-11 13:35:26 -07:00
benchpress refactor(benchpress): remove zone-based testing utilities 2026-02-09 07:55:12 -08:00
common refactor(common): update deprecation message 2026-04-30 16:07:02 -07:00
compiler fix(compiler): strip namespaced SVG script elements during template compilation 2026-05-19 13:06:05 -07:00
compiler-cli fix(compiler): strip namespaced SVG script elements during template compilation 2026-05-19 13:06:05 -07:00
core docs: clarify ngDoCheck invocation behavior with OnPush strategy 2026-05-20 11:12:11 -07:00
docs/di build: format md files 2025-11-06 10:03:05 -08:00
elements refactor(core): mark VERSION as @__PURE__ for better tree-shaking 2025-11-10 12:04:04 -08:00
examples test(upgrade): exclude unit test files from E2E application sources 2026-05-19 12:57:52 -07:00
forms docs: document FormBuilder.group() controlsConfig value shapes 2026-05-20 14:07:59 -07:00
language-service fix(compiler): let declaration span not including end character 2026-04-28 00:09:19 +00:00
localize fix(localize): validate locale in getOutputPathFn to prevent path traversal 2026-03-30 12:15:31 +02:00
misc/angular-in-memory-web-api docs: normalize product name casing across docs 2026-05-07 15:09:49 -07:00
platform-browser Revert "fix(http): correctly cache blob responses in transfer cache (#67002)" 2026-03-04 17:19:14 +00:00
platform-browser-dynamic refactor(core): mark VERSION as @__PURE__ for better tree-shaking 2025-11-10 12:04:04 -08:00
platform-server fix(platform-server): forward BEFORE_APP_SERIALIZED errors to ErrorHandler 2026-05-08 14:10:15 -07:00
private/testing refactor(common): fix viewport tests 2026-04-28 16:38:11 -07:00
router fix(router): skip scroll-to-top on initial navigation when hydrating 2026-05-19 13:01:59 -07:00
service-worker refactor(service-worker): remove unnecessary cast in mock redirect check 2026-03-18 10:26:26 -07:00
ssr/docs build: add node type for api extraction 2026-02-11 13:57:58 -08:00
upgrade docs: correct "Angular JS" to "AngularJS" 2026-05-05 12:42:45 -07:00
zone.js fix(zone.js): allow draining microtasks in Promise.then (through flag) 2026-04-15 10:31:33 -04:00
BUILD.bazel build(forms): expose signal forms compat package 2025-11-14 09:23:36 -08:00
circular-deps-test.conf.cjs build: use Node.js built-in TypeScript support for dev-infra scripts 2026-01-02 08:15:40 +01:00
empty.ts refactor: update license text to point to angular.dev (#57901) 2024-09-24 15:33:00 +02:00
goog.d.ts refactor: update license text to point to angular.dev (#57901) 2024-09-24 15:33:00 +02:00
license-banner.txt docs: update copyright year 2026-01-07 12:28:34 -05:00
package.json build: prepare for compiler-cli to be using ts_project (#61181) 2025-05-09 15:59:46 +00:00
README.md build: format md files 2025-11-06 10:03:05 -08:00
system.d.ts refactor: update packages/core:{core,src} to ts_project (#61275) 2025-05-14 12:01:51 +00:00
tsconfig-build.json Revert "refactor(compiler-cli): remove deep imports from compiler-cli (#64732)" 2025-11-06 13:09:01 -08:00
tsconfig-legacy-saucelabs.json feat(core): support TypeScript 5.5 (#56096) 2024-05-29 15:33:33 +02:00
tsconfig-test.json
tsconfig.json feat(compiler-cli): enable type checking of host bindings by default (#63654) 2025-09-09 14:34:29 -07:00
tsec-exemption.json
types.d.ts build: move private testing helpers outside platform-browser/testing (#61472) 2025-05-20 10:00:43 +00:00

Angular

The sources for this package are in the main Angular repo. Please file issues and pull requests against that repo.

Usage information and reference details can be found in Angular documentation.

License: MIT