@mnci/cli 4.48.0 → 4.49.0

package/README.md

@@ -507,6 +507,40 @@ from File`), and the curated root scripts.
 4. Installs the chosen **stack** (see below), `husky` + `@commitlint/*` for
    real, so versions resolve at generation time.
 
+## A paired Playwright project (`mnci add react-app web --e2e`)
+
+`--e2e` scaffolds `apps/<name>-e2e` beside a React app with `@nx/react:app --e2eTestRunner=playwright`. It is
+opt-in, and for React apps only: it adds Playwright to the workspace, and a Node API has no page to drive.
+
+- **The test.** Nx's sample looks for an `h1` containing "Welcome", which mnci's greeting app does not render, so it
+  is replaced by `src/greeting.e2e.spec.ts`: open `/` and expect the app's own greeting.
+- **What CI verifies.** The project has `lint` and `typecheck` (both pass, and CI's `lint,typecheck,test,build` run
+  picks them up); it has no `test` or `build`. Its `e2e` target is **not** part of CI's verify, because it needs a
+  browser, and installing one on every agent would cost every run. Run it where a browser exists:
+  `npx playwright install chromium`, then `npx nx run <name>-e2e:e2e -- --project=chromium` (the `--` hands the
+  flag to Playwright, not to Nx).
+- **Commands.** `npm run <name>-e2e:qa` is lint and typecheck. There is no `:build` or `:start`.
+- **No per-project ESLint config.** None is generated (`--linter=none`), and the usual sweep covers the directory.
+
+The `react e2e project` e2e section generates one, checks CI's targets, installs Chromium and runs the test against
+the built app.
+
+## ES module Node apps (`mnci add node-app|node-function-app --esm`)
+
+Generated Node apps are CommonJS by default, and `npm-lib` packages are ESM-only. `--esm` makes an app an ES module
+too: its `package.json` gets `"type": "module"` and its esbuild target builds `esm`; every relative import in its
+sources names its file the way `nodenext` resolution needs (`./hello` becomes `./hello/index.js`, which TypeScript
+reports as TS2835 otherwise); and its `jest.config.cts` gets a `moduleNameMapper` that resolves `./x.js` back to the
+`./x.ts` Jest transforms. It applies to `node-app` (Express, Koa or no framework) and `node-function-app`; Fastify
+and Nest keep the layout their framework mandates (autoloaded routes, decorators), so `--esm` is refused with them,
+and on any other kind.
+
+Measured on generated apps rather than assumed (the `node esm apps` e2e section): lint, typecheck, test and build are
+green; the built bundle is ES module syntax and runs; `prune` keeps `"type": "module"` in the pruned manifest, so
+`dist` still runs afterwards; and a **CommonJS** app that depends on an ESM-only library typechecks, builds and runs,
+including from `dist` after `prune` and an install there, because Node loads the ES module through `require`
+(unflagged from Node 22.12; the e2e says so and skips on older Node).
+
 ## The interactive wizard (`mnci` with no arguments)
 
 Bare `mnci` lists **every command** (inside a workspace the Projects and Dependencies sections come first, outside