@adaptabletools/adaptable-angular-aggrid 23.0.10 → 23.0.12

package/README.md

@@ -8,6 +8,39 @@ AdapTable provides a huge range of Data Grid (and FDC3) features, which extend A
 
 For full details on how to install, instantiate and reference AdapTable programmatically at run-time please read the [AdapTable Angular Documentation](https://www.adaptabletools.com/docs/angular-overview).
 
+## CommonJS Build Warnings
+
+When building an Angular application which uses AdapTable, you may see warnings like:
+
+```
+[WARNING] Module 'react' used by 'node_modules/@adaptabletools/adaptable/...' is not ESM
+CommonJS or AMD dependencies can cause optimization bailouts.
+```
+
+These warnings are emitted by all Angular builders — both the esbuild-based ones (`@angular/build:application`, `@angular-devkit/build-angular:browser-esbuild`) and the older webpack-based one (`@angular-devkit/build-angular:browser`, where the message reads `'...' depends on 'react'` instead).
+
+These warnings refer to React ecosystem packages used internally by AdapTable (`react`, `react-dom`, and the transitive dependency `use-sync-external-store`). These packages are published as CommonJS only — no ESM distribution exists — so the warnings cannot be avoided at the package level. They are harmless: the build output is correct, and the "optimization bailout" only means the bundler cannot tree-shake inside those specific modules (which would have no effect on React's monolithic runtime anyway).
+
+To silence the warnings, add the packages to the [`allowedCommonJsDependencies`](https://angular.dev/tools/cli/build#configuring-commonjs-dependencies) build option — in `angular.json`, or in `project.json` if you are using an Nx monorepo:
+
+```json
+{
+  "targets": {
+    "build": {
+      "executor": "@angular/build:application",
+      "options": {
+        "allowedCommonJsDependencies": [
+          "react",
+          "react-dom",
+          "use-sync-external-store"
+        ]
+      }
+    }
+  }
+}
+```
+
+Listing a package name also covers its deep imports (e.g. `react/jsx-runtime`, `react-dom/client`, `use-sync-external-store/shim`), so these three entries are sufficient.
 
 ## Demos