@pushwoosh/frontend-builder-engine 4.0.0 → 4.1.0

package/README.md

@@ -42,7 +42,7 @@ its own `knip.json` in the project root and a plain `knip` call — the shared c
 ### Output format
 
 Since v4 an application builds as a native ES module: `dist/index.mjs` with `import … from "react"`
-for every external, no `System.register`. Externals resolve through the root-config `importmap`,
+for every external. Externals resolve through the root-config `importmap`,
 chunks and assets resolve against `import.meta.url` (`publicPath: 'auto'`). The browser floor is
 Chrome/Edge 94, Firefox 108 (import maps), Safari/iOS 16.4. To see it from a project:
 
@@ -52,8 +52,10 @@ npx browserslist "$(node -p "require('@pushwoosh/frontend-builder-engine/lib/bro
 
 ## Migration from v3
 
-v3 builds SystemJS (`dist/index.js`); it stays published and is maintained on the `v3` branch, so a
-micro-frontend moves to v4 on its own schedule. Moving one:
+v3 is deprecated: its `dist/index.js` is not an ES module, and the platform loads native ES modules
+only since root-config dropped its module loader (DEV-992), so a v3 build no longer starts there —
+its `import()` fails with `ReferenceError: System is not defined` and the app slot stays empty.
+Hotfixes for v3 go to the `v3` branch only. Moving a micro-frontend to v4:
 
 1. Bump `@pushwoosh/frontend-builder-engine` to `^4.0.0` in `devDependencies`.
 2. Replace `module.hot` with `import.meta.webpackHot` (same API):
@@ -65,21 +67,14 @@ micro-frontend moves to v4 on its own schedule. Moving one:
    ```
 
 3. The build output is `dist/index.mjs` instead of `dist/index.js`. Nothing to change in CI: the
-   shared `frontend/microfrontend-release.yml` registers `index.mjs` in the import map when `dist`
-   has it. The manual dev stand (`microfrontend-dev.yml`) still prints an `index.js` override URL —
-   replace it with `index.mjs` by hand.
+   shared `frontend/microfrontend-release.yml` registers `index.mjs` in the import map, and
+   `microfrontend-dev.yml` prints the `index.mjs` override, both whenever `dist` has it.
 4. `pushwoosh.config.js` (`applicationExternals`, `applicationWebpack`) needs no changes, unless
-   `applicationWebpack` sets `output.libraryTarget`/`output.library` or adds
-   `SystemJSPublicPathWebpackPlugin` itself — drop those.
+   `applicationWebpack` sets `output.libraryTarget`/`output.library` or adds a public-path plugin of
+   its own — drop those.
 
-**Release order.** Every external becomes a native `import`, resolved by the browser's import map,
-not by SystemJS. Do not roll out the first v4 micro-frontend before:
-
-- root-config ships the SystemJS ↔ ESM bridge (DEV-984) — without it the first `index.mjs` in the map
-  breaks every v3 micro-frontend;
-- `@pushwoosh/http-client`, `@pushwoosh/session-store`, `@pushwoosh/rpc-gateway-*` and
-  `@pushwoosh/rpc-v2-http-api-data` are in the map as `.mjs` (DEV-987, DEV-988) — while they are
-  `.js` (System bundles), a v4 app that imports them fails to load.
+Every name in `defaultExternals` resolves through the root-config import map and must point at an
+ES module (`.mjs`) there; all of them do since DEV-987/DEV-988.
 
 ### Library commands (reusable packages)
 
@@ -101,6 +96,8 @@ cd examples/library && npm install && npm start
 ### Release
 
 Releases are triggered by Git tags in CI. Tag with `v*` for stable, include `beta` for beta channel.
-v4 is released from `master`, v3.x fixes from the `v3` branch. CI publishes every non-beta tag as
-npm `latest`, so after a v3.x patch move `latest` back:
-`npm dist-tag add @pushwoosh/frontend-builder-engine@<newest 4.x> latest`.
+v4 is released from `master`, hotfixes for the deprecated v3 from the `v3` branch. CI publishes
+every non-beta tag as npm `latest`, so after a v3.x patch move `latest` back:
+`npm dist-tag add @pushwoosh/frontend-builder-engine@<newest 4.x> latest`, and re-run
+`npm deprecate @pushwoosh/frontend-builder-engine@3.x "…"`: a deprecation covers only the versions
+published before it.

package/lib/eslint.config.mjs

@@ -36,7 +36,7 @@ export default tseslint.config(
     },
     rules: {
       ...hooksPlugin.configs.recommended.rules,
-      'react-hooks/set-state-in-effect': 'off',
+      'react-hooks/set-state-in-effect': 'error',
       'react-hooks/refs': 'off',
       'react-hooks/incompatible-library': 'error',
       'react/display-name': 'off',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pushwoosh/frontend-builder-engine",
-  "version": "4.0.0",
+  "version": "4.1.0",
   "description": "Pushwoosh frontend builder engine",
   "main": "./lib/pushwoosh-frontend-builder-engine.js",
   "publishConfig": {