module-federation-angular-adapter 0.2200.0

package/LICENSE

@@ -0,0 +1,8 @@
+Copyright 2021 Softarc Consulting GmbH
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+

package/README.md

@@ -0,0 +1,115 @@
+# `module-federation-angular-adapter`
+
+An Angular adapter for **Module Federation v2**, built on
+[`@module-federation/runtime`](https://www.npmjs.com/package/@module-federation/runtime)
+and [`@module-federation/esbuild`](https://www.npmjs.com/package/@module-federation/esbuild).
+
+It lets an Angular app **consume** and **produce** Module Federation v2 remotes that
+interoperate with stock **webpack / rspack** MF hosts — while reusing Angular's
+esbuild-based `ApplicationBuilder` and the same es-module-shims foundation as
+[Native Federation](https://www.npmjs.com/package/@angular-architects/native-federation).
+
+> [!WARNING]
+> **Pre-release.** The adapter is code-complete and statically verified
+> (type-checks, lints, unit tests pass), but its **end-to-end behaviour is not yet
+> proven** in a real Angular app/browser. See
+> [Constraints & known issues](./docs/known-issues.md). Not yet recommended for
+> production.
+
+## Features
+
+- ✅ **Module Federation v2 interop** — emits `mf-manifest.json` + an ESM
+  `remoteEntry.js`; consumes/produces remotes across Angular, webpack, and rspack.
+- ✅ **Familiar config** — `withModuleFederation` / `share` / `shareAll`, the same
+  shape Native Federation / the Module Federation plugin use.
+- ✅ **Angular-native build** — delegates the app shell to Angular's fast esbuild
+  `ApplicationBuilder`; runs the federation container as a side build.
+- ✅ **Single-instance sharing** — `@angular/*`, `rxjs`, `zone.js` shared as strict
+  singletons via the MF shared scope.
+
+## Quick start
+
+```bash
+ng add module-federation-angular-adapter
+```
+
+Configure `federation.config.mjs`:
+
+```js
+import {
+  withModuleFederation,
+  shareAll,
+} from "module-federation-angular-adapter/config";
+
+export default withModuleFederation({
+  name: "mfe1",
+  // remotes only:
+  exposes: { "./Component": "./src/app/app.component.ts" },
+  shared: {
+    ...shareAll({
+      singleton: true,
+      strictVersion: true,
+      requiredVersion: "auto",
+    }),
+    "@angular/core": {
+      singleton: true,
+      strictVersion: true,
+      requiredVersion: "auto",
+      includeSecondaries: true,
+    },
+  },
+  skip: ["rxjs/ajax", "rxjs/fetch"],
+});
+```
+
+Load a remote in the host:
+
+```ts
+import { initFederation } from "module-federation-angular-adapter";
+
+const { loadRemoteModule } = initFederation({
+  mfe1: "http://localhost:4201/mf-manifest.json",
+});
+
+const m = await loadRemoteModule("mfe1", "./Component");
+```
+
+Full walkthrough: **[docs/usage.md](./docs/usage.md)**.
+
+## How it differs from Native Federation
+
+Same adapter shape and es-module-shims loader; the **orchestrator** and the
+**artifact contract** change.
+
+|                  | Native Federation                         | This adapter                                  |
+| ---------------- | ----------------------------------------- | --------------------------------------------- |
+| Runtime          | `@softarc/native-federation-orchestrator` | `@module-federation/runtime`                  |
+| Build core       | `@softarc/native-federation`              | `@module-federation/esbuild`                  |
+| Manifest         | `remoteEntry.json`                        | `remoteEntry.js` + `mf-manifest.json` (MF v2) |
+| `initFederation` | returns a `Promise`                       | **synchronous**                               |
+| Interop          | NF hosts only                             | stock webpack / rspack MF v2 hosts            |
+
+The trade: you gain the wider Module Federation v2 ecosystem; you depend on the
+(currently early `0.0.x`) `@module-federation/esbuild`. See
+[Architecture](./docs/architecture.md) for the full picture.
+
+## Documentation
+
+- **[Usage](./docs/usage.md)** — install, configure, load/expose remotes.
+- **[Architecture](./docs/architecture.md)** — how it works and the design behind it.
+- **[Constraints & known issues](./docs/known-issues.md)** — what to be aware of.
+- **[SSR proposal (deferred)](./docs/research/ssr-proposal-future.md)** — why SSR is
+  not yet supported.
+
+## Credits
+
+Built on the work of the Module Federation and Native Federation communities —
+[Zack Jackson](https://github.com/ScriptedAlchemy) (Module Federation), the
+[`@module-federation`](https://github.com/module-federation) team (`runtime` +
+`esbuild`), [Manfred Steyer](https://github.com/manfredsteyer) and the Angular
+Architects team (Native Federation, whose adapter this ports from), and the Angular
+CLI team for the esbuild `ApplicationBuilder`.
+
+## License
+
+MIT

package/builders.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "../../node_modules/@angular-devkit/architect/src/builders-schema.json",
+  "builders": {
+    "build": {
+      "implementation": "./src/builders/build/builder",
+      "schema": "./src/builders/build/schema.json",
+      "description": "native federation builder"
+    },
+    "remote": {
+      "implementation": "./src/builders/remote/builder",
+      "schema": "./src/builders/remote/schema.json",
+      "description": "native federation builder without the Angular application build or dev server (federation artifacts + copied assets only; serving is handled externally)"
+    }
+  }
+}

package/collection.json

@@ -0,0 +1,27 @@
+{
+  "$schema": "../../node_modules/@angular-devkit/schematics/collection-schema.json",
+  "name": "module-federation-esbuild",
+  "version": "0.0.1",
+  "schematics": {
+    "ng-add": {
+      "factory": "./src/schematics/init/schematic",
+      "schema": "./src/schematics/init/schema.json",
+      "description": "Initialize an angular project for module federation (esbuild)"
+    },
+    "init": {
+      "factory": "./src/schematics/init/schematic",
+      "schema": "./src/schematics/init/schema.json",
+      "description": "Initialize an angular project for module federation (esbuild)"
+    },
+    "remove": {
+      "factory": "./src/schematics/remove/schematic",
+      "schema": "./src/schematics/remove/schema.json",
+      "description": "Removes module federation (esbuild)"
+    },
+    "appbuilder": {
+      "factory": "./src/schematics/appbuilder/schematic",
+      "schema": "./src/schematics/appbuilder/schema.json",
+      "description": "Migrates for using the appbuilder"
+    }
+  }
+}

package/generators.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "name": "native-federation",
+  "version": "0.0.1",
+  "generators": {
+    "native-federation": {
+      "factory": "./src/generators/native-federation/generator",
+      "schema": "./src/generators/native-federation/schema.json",
+      "description": "native-federation generator"
+    }
+  }
+}

package/migration-collection.json

@@ -0,0 +1,6 @@
+{
+  "$schema": "../../node_modules/@angular-devkit/schematics/collection-schema.json",
+  "name": "module-federation-esbuild",
+  "version": "0.0.1",
+  "schematics": {}
+}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "module-federation-angular-adapter",
+  "version": "0.2200.0",
+  "generators": "./collection.json",
+  "builders": "./builders.json",
+  "schematics": "./collection.json",
+  "license": "MIT",
+  "author": {
+    "name": "Native federation team",
+    "url": "http://www.angulararchitects.io"
+  },
+  "peerDependencies": {
+    "@angular/build": "~22.0.0"
+  },
+  "dependencies": {
+    "@angular-devkit/architect": "^0.2200.0",
+    "@angular-devkit/core": "~22.0.0",
+    "@angular-devkit/schematics": "~22.0.0",
+    "@chialab/esbuild-plugin-commonjs": "^0.19.0",
+    "@module-federation/esbuild": "0.0.109",
+    "@module-federation/runtime": "2.6.0",
+    "@module-federation/sdk": "2.6.0",
+    "@module-federation/webpack-bundler-runtime": "2.6.0",
+    "@softarc/native-federation": "^4.0.0",
+    "es-module-shims": "^2.8.0",
+    "esbuild": "^0.28.0",
+    "mrmime": "^2.0.1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Aukevanoost/angular-module-federation-adapter"
+  },
+  "ng-update": {
+    "migrations": "./migration-collection.json"
+  },
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./src/index.d.ts",
+      "import": "./src/index.js",
+      "default": "./src/index.js"
+    },
+    "./config": {
+      "types": "./src/config.d.ts",
+      "import": "./src/config.js",
+      "default": "./src/config.js"
+    },
+    "./internal": {
+      "types": "./src/internal.d.ts",
+      "import": "./src/internal.js",
+      "default": "./src/internal.js"
+    }
+  },
+  "homepage": "https://github.com/Aukevanoost/angular-module-federation-adapter#readme",
+  "type": "module",
+  "files": [
+    "src",
+    "collection.json",
+    "generators.json",
+    "builders.json",
+    "migration-collection.json",
+    "README.md",
+    "LICENSE",
+    "!**/*.tsbuildinfo"
+  ],
+  "types": "./src/index.d.ts",
+  "module": "./src/index.js",
+  "main": "./src/index.js"
+}

package/src/builders/build/builder.d.ts

@@ -0,0 +1,7 @@
+import "./setup-builder-env-variables.js";
+import { type BuilderContext, type BuilderOutput } from "@angular-devkit/architect";
+import type { NfBuilderSchema, NfInternalOptions } from "./schema.js";
+export declare function runBuilder(nfBuilderOptions: NfBuilderSchema & NfInternalOptions, context: BuilderContext): AsyncIterable<BuilderOutput>;
+declare const _default: any;
+export default _default;
+//# sourceMappingURL=builder.d.ts.map

package/src/builders/build/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../../../src/builders/build/builder.ts"],"names":[],"mappings":"AAAA,OAAO,kCAAkC,CAAC;AAiB1C,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,aAAa,EAGnB,MAAM,2BAA2B,CAAC;AAsBnC,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAwEtE,wBAAuB,UAAU,CAC/B,gBAAgB,EAAE,eAAe,GAAG,iBAAiB,EACrD,OAAO,EAAE,cAAc,GACtB,aAAa,CAAC,aAAa,CAAC,CAke9B;wBAkE2C,GAAG;AAA/C,wBAAgD"}