docs(core): clarify provideZoneChangeDetection usage in v21+

angular-bootstrap · angular-bootstrap · commit ed672ac23648 · 2026-03-06T15:35:30.000-06:00
Clarify that zoneless change detection is the default in Angular v21+ and that provideZoneChangeDetection() opts applications into NgZone/ZoneJS-based change detection while also allowing NgZone options such as eventCoalescing to be configured. Fixes angular#67498
diff --git a/packages/core/src/change_detection/scheduling/ng_zone_scheduling.ts b/packages/core/src/change_detection/scheduling/ng_zone_scheduling.ts
@@ -134,8 +134,9 @@ export function internalProvideZoneChangeDetection({
  * Provides `NgZone`-based change detection for the application bootstrapped using
  * `bootstrapApplication`.
  *
- * `NgZone` is already provided in applications by default. This provider allows you to configure
- * options like `eventCoalescing` in the `NgZone`.
+ * In Angular v21+, zoneless change detection is the default for new applications. Add this
+ * provider to use `NgZone`/ZoneJS-based change detection, or to configure options like
+ * `eventCoalescing` in the `NgZone`.
  *
  * If you need this provider function in an NgModule-based application, pass it as `applicationProviders` to `bootstrapModule()`.
  *

Original file line number	Diff line number	Diff line change
`@@ -134,8 +134,9 @@ export function internalProvideZoneChangeDetection({`
`134`	`134`	* Provides `NgZone`-based change detection for the application bootstrapped using
`135`	`135`	* `bootstrapApplication`.
`136`	`136`	`*`
`137`		- * `NgZone` is already provided in applications by default. This provider allows you to configure
`138`		- * options like `eventCoalescing` in the `NgZone`.
	`137`	`+ * In Angular v21+, zoneless change detection is the default for new applications. Add this`
	`138`	+ * provider to use `NgZone`/ZoneJS-based change detection, or to configure options like
	`139`	+ * `eventCoalescing` in the `NgZone`.
`139`	`140`	`*`
`140`	`141`	* If you need this provider function in an NgModule-based application, pass it as `applicationProviders` to `bootstrapModule()`.
`141`	`142`	`*`