@pushwoosh/frontend-builder-engine 4.3.0 → 4.3.1

package/README.md

@@ -62,6 +62,25 @@ an uppercase `@LICENSE` comment is not extracted. To fall back to terser for one
 ENGINE_MINIFIER=terser npm run build
 ```
 
+### React Compiler (opt-in)
+
+`babel-plugin-react-compiler` ships with the engine and is off by default: a project switches it on in
+its `pushwoosh.config.js`, so micro-frontends move to it one at a time.
+
+```js
+module.exports = {
+  reactCompiler: true,
+  // or compiler options, e.g. compile only components marked with 'use memo':
+  // reactCompiler: { compilationMode: 'annotation' },
+};
+```
+
+The plugin runs first in `lib/babel.application.config.js` with `target: '19'`, so it needs no
+`react-compiler-runtime` package: the memo cache comes from `react/compiler-runtime` of the project's own
+React 19, bundled into `index.mjs` while `react` itself stays external. Components the compiler cannot
+handle are left as they are (the default `panicThreshold: 'none'`). The option affects application
+builds only; `lib:build` does not read it.
+
 ## Migration from v3
 
 v3 is deprecated: its `dist/index.js` is not an ES module, and the platform loads native ES modules

package/lib/babel.application.config.js

@@ -12,6 +12,16 @@ const fromEngine = (name) => require.resolve(name);
 const runtimeVersion = require('@babel/runtime/package.json').version;
 
 const { BROWSER_TARGETS } = require('./browser-targets');
+const { loadPushwooshConfig } = require('./helpers');
+
+// Opt-in per project (pushwoosh.config.js `reactCompiler`); the compiler has to run before every other plugin.
+const reactCompilerPlugins = (option) => {
+  if (!option) {
+    return [];
+  }
+
+  return [[fromEngine('babel-plugin-react-compiler'), { target: '19', ...(typeof option === 'object' ? option : {}) }]];
+};
 
 module.exports = (api) => {
   api.cache(true);
@@ -30,6 +40,7 @@ module.exports = (api) => {
       fromEngine('@babel/preset-typescript')
     ],
     plugins: [
+      ...reactCompilerPlugins(loadPushwooshConfig().reactCompiler),
       [
         fromEngine('@babel/plugin-transform-runtime'),
         {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pushwoosh/frontend-builder-engine",
-  "version": "4.3.0",
+  "version": "4.3.1",
   "description": "Pushwoosh frontend builder engine",
   "main": "./lib/pushwoosh-frontend-builder-engine.js",
   "publishConfig": {
@@ -34,6 +34,7 @@
     "@types/eslint__js": "^8.42.3",
     "@types/webpack-env": "^1.18.4",
     "babel-loader": "^10.0.0",
+    "babel-plugin-react-compiler": "^1.0.0",
     "babel-plugin-styled-components": "^2.1.4",
     "babel-plugin-transform-imports": "^2.0.0",
     "commander": "^12.0.0",