@dotcms/angular 26.9.24-1 → 26.9.24-1-next.2779

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -103,6 +103,8 @@ For detailed instructions, please refer to the [dotCMS API Documentation - Read-
103
103
 
104
104
  ### Installation
105
105
 
106
+ `@dotcms/angular` requires **Angular 21.2 or newer** (`@angular/core`, `@angular/common` and `@angular/router`). It is built with Angular 21.2, so a single version works on every Angular from 21.2 up. On an older Angular, npm 7+ refuses the install with a peer-dependency error, and package managers that don't enforce peer dependencies only warn.
107
+
106
108
  ```bash
107
109
  npm install @dotcms/angular@latest
108
110
  ```
@@ -734,6 +736,14 @@ export class PageComponent implements OnInit, OnDestroy {
734
736
 
735
737
  ### Common Issues & Solutions
736
738
 
739
+ #### Build Errors
740
+
741
+ 1. **`Unsupported change detection strategy`**: `ng build` or `ng serve` fails with this error, pointing at `node_modules/@dotcms/angular/fesm2022/dotcms-angular.mjs`
742
+ - **Cause**: your app is on an Angular older than 21.2. `@dotcms/angular` 26.8.7-1 and later use `ChangeDetectionStrategy.Eager`, which Angular 21.1 and older can't read, even though releases up to 26.9.23-1 declared support for Angular 17 and up.
743
+ - **Solutions**:
744
+ - On Angular 21.0 or 21.1: update your app to Angular 21.2 or newer, a minor update within Angular 21.
745
+ - On Angular 20 or older: upgrade your app to Angular 21.2 or newer. No current release supports older versions.
746
+
737
747
  #### Universal Visual Editor (UVE)
738
748
 
739
749
  1. **UVE Not Loading**: Page loads but UVE controls are not visible