> For AI agents: the complete documentation index is available at https://mfdoctor.kevinbeier.com/de/llms.txt, the full documentation bundle is available at https://mfdoctor.kevinbeier.com/de/llms-full.txt. > Dies ist die deutsche mfdoctor-Dokumentation. Technische Bezeichner, CLI-Flags, Regel-IDs und Codebeispiele bleiben unverändert, damit die Inhalte zwischen den Sprachen vollständig kompatibel bleiben. Verwenden Sie den Sprachumschalter für die kanonische englische Fassung. # Compatibility matrix Documented and CI-exercised support for every bundler and runtime mfdoctor claims in v1. Status labels are tied to analysis capabilities and real build+mfdoctor paths, not fixture-only confidence. Related: [capabilities](https://mfdoctor.kevinbeier.com/de/capabilities.md) · [limitations](https://mfdoctor.kevinbeier.com/de/limitations.md) · [#15](https://github.com/tonoizer/module-federation-doctor/issues/15) (`MFDOCTOR-106`). ## Statusbezeichnungen | Status | Meaning | | --------------- | ---------------------------------------------------------------------------------------------- | | **supported** | First-class adapter + real bundler build writes mfdoctor facts; exercised in CI | | **partial** | Usable with honest gaps, emits `doctor/partial-analysis` (or weaker evidence) instead of lying | | **unsupported** | Out of v1 scope (post-v1 or permanent non-goal) | ## Bundler | Bundler | Status | Adapter entry | CI evidence | Notes | | -------------------- | --------------- | ---------------------------- | -------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Vite | **supported** | `@tonoizer/mfdoctor/vite` | `compatibility` workflow → `host-vite` build + mfdoctor | Primary host path in `examples/mixed-federation` | | Vite 5 + CommonJS | **supported** | `@tonoizer/mfdoctor/vite` | `compatibility` workflow → `vite-cjs-v5` build + mfdoctor | Async ESM bridge for the Vite MF plugin; validates mfdoctor's published CommonJS adapter | | Rolldown / Vite Plus | **partial** | `@tonoizer/mfdoctor/vite` | `compatibility` workflow → `rolldown-smoke` (Vite Plus) + unit lifecycle hooks | Same Vite entry; Vite Plus production smoke exists; not a **supported** claim until emit evidence is complete (#11) | | Rspack | **supported** | `@tonoizer/mfdoctor/rspack` | `compatibility` workflow → `remote-rspack` build + mfdoctor | Direct `@module-federation/enhanced/rspack` (first-class) | | Rsbuild | **supported** | `@tonoizer/mfdoctor/rsbuild` | `compatibility` workflow → `remote-rsbuild` build + mfdoctor | `@module-federation/rsbuild-plugin` | | Webpack | **supported** | `@tonoizer/mfdoctor/webpack` | `compatibility` workflow → `webpack-smoke` build + mfdoctor | `@module-federation/enhanced/webpack` (#10 shipped) | | Modern.js | **partial** | `@tonoizer/mfdoctor/modern` | `compatibility` workflow → `modern-smoke` (Rspack-under-the-hood stub) | Adapter API + Rspack stub in CI. A real `@modern-js/app-tools@3.8.2` + `@module-federation/modern-js-v3@2.8.2` production emit works outside this lockfile, but current App Tools releases fail `trustPolicy: no-downgrade` (last provenance-attested stable is `2.63.3`). Status stays **partial**. Upstream core-demo re-soak remains #130 | | Nuxt 3/4 | **partial** | `@tonoizer/mfdoctor/nuxt` | `compatibility` workflow → `nuxt-smoke` (Vite-under-the-hood) + pinned upstream record | Public `vite:extendConfig` adapter + local emit cell; full `@module-federation/nuxt` app build remains baseline-blocked upstream ([nuxt/nuxt#36009](https://github.com/nuxt/nuxt/issues/36009)) | | Next.js | **unsupported** | Not applicable | none | `@module-federation/nextjs-mf` is Pages Router only and unmaintained. No mfdoctor adapter is planned. Prefer Rsbuild or Modern.js. See [limitations](https://mfdoctor.kevinbeier.com/de/limitations.md#permanent-guarantees--non-goals). | ## Variantenabdeckung The machine-readable contract lives in [`fixtures/compatibility-matrix.json`](https://github.com/tonoizer/module-federation-doctor/blob/main/fixtures/compatibility-matrix.json). It distinguishes reproducible local CI cells from unit contracts and pinned upstream validation records: | Surface | Current evidence | Matrix status | | -------------------------------------------------------- | ------------------------------------------------------------------------------------ | ---------------- | | Vite current ESM + Vite 5 CommonJS | Production build + project/report/SARIF assertions on Node 22, 24, and 26 | CI | | Rolldown / Vite Plus (`examples/compatibility/rolldown`) | Production Vite Plus build via `@tonoizer/mfdoctor/vite` | CI (partial) | | Rspack, Rsbuild, Webpack, Modern.js adapter stub | Production build + mfdoctor report assertions | CI | | Modern.js App Tools (`@modern-js/app-tools`) | Blocked by lockfile `trustPolicy: no-downgrade` (last provenance `2.63.3`) | blocked | | Nuxt 3/4 local emit (`examples/compatibility/nuxt`) | Production Vite-under-the-hood build via `@tonoizer/mfdoctor/nuxt` | CI (partial) | | Svelte and SvelteKit SSR | Pinned upstream app reports plus SvelteKit SSR-entry regression test | validated | | Angular | Pinned upstream validation; the example's existing package baseline blocks the build | baseline-blocked | | Nuxt 3/4 upstream `@module-federation/nuxt` | Pinned upstream validation; package-resolution baseline still blocks the full app | baseline-blocked | The upstream rows are evidence records, not release claims: CI uses pinned local fixtures so a moving external repository cannot silently change the release gate. Refresh the pinned ref and rerun the external validation before changing a row's status. Nuxt 3 / Nuxt 4 use the **partial** adapter `@tonoizer/mfdoctor/nuxt`. It hooks the public `vite:extendConfig` API. The local emit cell at [`examples/compatibility/nuxt`](https://github.com/tonoizer/module-federation-doctor/tree/main/examples/compatibility/nuxt) registers that module and production-builds (Vite-under-the-hood). A full `@module-federation/nuxt` application build remains dependent on the upstream package-resolution issue tracked in [nuxt/nuxt#36009](https://github.com/nuxt/nuxt/issues/36009), so Nuxt is not a first-class **supported** CI gate. Rolldown / Vite Plus use the **same** `@tonoizer/mfdoctor/vite` entry as classic Vite. The local emit cell at [`examples/compatibility/rolldown`](https://github.com/tonoizer/module-federation-doctor/tree/main/examples/compatibility/rolldown) aliases `vite` to Vite Plus and production-builds. Reports keep `partial-bundler` for this lifecycle, so the matrix cell stays **partial**. Runtime-only Module Federation (no bundler MF **build** plugin) is **unsupported** as a first-class path, see [limitations](https://mfdoctor.kevinbeier.com/de/limitations.md#permanent-guarantees--non-goals) and [#34](https://github.com/tonoizer/module-federation-doctor/issues/34). Next.js Module Federation (`@module-federation/nextjs-mf`) is **unsupported**. There is no adapter and none is planned, prefer Rsbuild or Modern.js. See [limitations](https://mfdoctor.kevinbeier.com/de/limitations.md#permanent-guarantees--non-goals). ## Analysetiefe (ehrliche Teilergebnisse) | Path | Status | Behavior when incomplete | | --------------------------------------------------------------------------- | ----------- | ------------------------------------------------------------------------------ | | Bundler MF plugin + mfdoctor adapter + shared `mfOptions` | supported | Full post-emit facts; CI defaults to terminal + JSON + SARIF | | CLI `check` with explicit MF config, no emit | partial | Config/imports only; weaker without artifacts | | Unresolved dynamic `import(expr)` / non-literal `loadRemote` / etc. | partial | Records `imports.unresolvedDynamic`; prefers `doctor/partial-analysis` | | Opt-in Observability `runtimeTrace` / `mfdoctor runtime` | supported\* | Offline correlation when a valid export is supplied; invalid/missing → partial | | On-disk / deployed `mf-manifest.json` (`check` on-disk manifests / `probe`) | partial | Producer/deploy evidence only | \*Runtime traces are opt-in and never fetch remote URLs or execute remote JS. Partial cells must not silently skip gaps. Prefer [`doctor/partial-analysis`](https://mfdoctor.kevinbeier.com/de/rules/doctor/partial-analysis.md) over false certainty (`shared/unused`, invented remotes, scraped private plugin fields). ## Laufzeit-Capture-Kompatibilität Runtime capture is a separate, opt-in Node/offline boundary. The checked-in contract at [`fixtures/runtime-capture-compatibility.json`](https://github.com/tonoizer/module-federation-doctor/blob/main/fixtures/runtime-capture-compatibility.json) and `scripts/verify-runtime-capture-compatibility.mjs` exercise the public `@tonoizer/mfdoctor/capture` entry point after every package build: | Surface | Status | Evidence | Compatibility guarantee | | ----------------------------------- | ------------- | ---------------------------------------- | -------------------------------------------------------------------------------------- | | Current Observability export | **supported** | `current-2.5.3.json` | Projects bounded reports/events and preserves source capability state. | | Legacy Observability export | **supported** | `healthy.json` | Keeps legacy report parsing and leaves absent fields unknown. | | Partial/sensitive export | **supported** | `remote-load-failed.json` | Redacts credentials/secrets before output and never retains raw error internals. | | Official DevTools export | **supported** | `partial-devtools.json` | Retains source-partial metadata and does not upgrade missing report facts. | | Node/SSR JSON export | **supported** | Node wrapper around `current-2.5.3.json` | Uses the `node-file` transport and a separate SSR realm. | | Preview runtime / disabled snapshot | **supported** | Fallback contract cases | Preview versions do not infer shared lifecycle; `disableSnapshot` is `not-applicable`. | | Browser frame / worker realms | **supported** | Browser connector contract cases | Navigation, realm, and source scope remain isolated and user-approved. | The default `@tonoizer/mfdoctor` entry and bundler adapter entries do not expose capture functions. Capture remains available only from the explicit `@tonoizer/mfdoctor/capture` subpath, and no automatic browser agent is part of the package. ## Node.js | Cell | Status | Exact versions | | ------------------------ | --------------- | ----------------------------------------------------------------------------- | | `package.json` `engines` | **supported** | `node: ">=22.12.0"` | | CI engines floor | **supported** | Node **22** (latest 22.x ≥ 22.12.0) via `.github/workflows/compatibility.yml` | | CI current line | **supported** | Node **24** (same workflow + quality/integration/e2e defaults) | | Node \< 22.12.0 | **unsupported** | Outside `engines`; not tested | ## Paketmanager | Manager | Status | Notes | | ---------------------- | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **pnpm** (primary) | **supported** | Vite+ delegates to pnpm 11 (`packageManager: "pnpm@11.17.0"`; `engines.pnpm: ">=11.0.0 <12.0.0"`); CI uses `vp install --frozen-lockfile`; workspace filters for examples; ten-day release-age and explicit build approvals are enforced | | npm | **partial** | Published package installs with `npm i -D @tonoizer/mfdoctor`; CLI via `npx mfdoctor`. This monorepo's lockfile and filters are pnpm-only, do not expect `npm install` at the repo root to reproduce CI. | | yarn (classic / Berry) | **partial** | Same published-package install/CLI story as npm. Yarn workspaces are not the repo's CI path; use pnpm for contributing and matrix jobs. | Where paths differ: contributors and CI always use **pnpm**. Consumers of the published tarball may use npm or yarn to install mfdoctor into their own app; the CLI binary name remains `mfdoctor`. ## Report-Oberflächen | Surface | Local default | CI / `--ci` / `mode: "ci"` | Artifact | | -------- | -------------------- | -------------------------- | -------------------------- | | terminal | yes (quiet on clean) | yes (quiet on clean) | stdout when findings exist | | JSON | yes (`report.json`) | yes | `.mf/doctor/report.json` | | SARIF | off unless requested | yes | `.mf/doctor/results.sarif` | CI auto-detect (`CI`, `GITHUB_ACTIONS`, …) enables `failOn: "error"` and terminal + JSON + SARIF without setting `mode: "ci"` in plugin config. The `compatibility` workflow asserts report artifacts after each supported bundler build. Terminal success lines stay off unless `--verbose` / `printLog.success` / `MFDOCTOR_QUIET=0` is set. ```bash pnpm mfdoctor check --format terminal,json,sarif ``` ## Fehlerpolitik (Release-Blocker) Reds that **block** a release claim for supported cells: 1. Vite, Rspack, Rsbuild, or Webpack real build + mfdoctor path fails on Node 22 or 24 in the `compatibility` workflow. 2. Missing mfdoctor artifacts after a green bundler build (`project.json`, `report.json`, or `results.sarif` on the CI path). 3. Quality / package / integration / e2e gates that already guard the adapters. Reds that **do not** block other cells: 1. npm/yarn consumer-path differences, documented partial; monorepo CI stays pnpm. 2. Expected `doctor/partial-analysis` warnings on partial analysis paths, honest gaps, not matrix failures. 3. Rolldown / Vite Plus, documented **partial** (Vite Plus production smoke plus unit lifecycle hooks; not a **supported** release gate). 4. Modern.js, documented **partial** (adapter API + Rspack-under-the-hood smoke in `compatibility.yml`). A real `@modern-js/app-tools` cell is blocked by this repo's `trustPolicy: no-downgrade` (current App Tools dropped npm provenance after `2.63.3`). Upstream core-demo re-soak remains #130. 5. Nuxt 3/4, documented **partial** (adapter + local emit smoke; upstream `@module-federation/nuxt` app build remains baseline-blocked; not a **supported** release gate). 6. Next.js (`@module-federation/nextjs-mf`), documented **unsupported** (permanent non-goal; no adapter planned). ## CI-Übersicht | Workflow | What it proves | | ----------------------------- | ----------------------------------------------------------------------- | | `compatibility.yml` | Per-bundler build+mfdoctor on Node 22, 24 + 26; report surfaces | | `doctor.yml` | Mixed + nested federation builds + workspace gates + SARIF upload | | `integration.yml` / `e2e.yml` | Adapter tests plus the full matrix and Playwright mixed-federation path | | `package.yml` | Pack/consume smoke on Node 22, 24 + 26 (includes Webpack) | | `quality.yml` | fmt, lint, types, unit tests, `docs:build` | ## mf-toolkit shapes mfdoctor soft-recognizes intentional **mf-toolkit** config shapes so agents do not get false broken-remote / component-DTS guidance: | Shape | Signal | Soft-exception | | ------------------------------- | ----------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- | | **mf-bridge** | expose `./entry` → `entry.*` module (toolkit `register` / `createMFEntry` / `defineMFEntry` contract) | Skip component-style DTS producer guidance (`artifact/dts-disabled`, `artifact/types-missing`, `artifact/types-metadata-missing`) | | **mf-ssr** | fragment URL/path remotes (`/api/fragments/...`, not `remoteEntry.js`) | Skip `config/remote-entry-invalid` for those entries | | **shared-inspector** (optional) | MF2 shared-array on manifest-only evidence | Skip `shared/unused` certainty; prefer `doctor/partial-analysis` | Recognition defaults **on when these signals are present**. Disable with `recognizeMfToolkit: false` in `mfdoctor.config` / adapter options, or turn the specific rule `"off"` / use a fingerprint baseline. Soft-exceptions **skip** findings rather than changing evidence shapes (fingerprint-stable for classic apps). In-repo fixtures (no toolkit checkout): `fixtures/mf-bridge-entry`, `fixtures/mf-ssr-fragment`, `fixtures/shared-inspector-mf2`. Full Bridge pack coverage is [#131](https://github.com/tonoizer/module-federation-doctor/issues/131), not this compatibility note.