module-federation-angular-adapter 0.2200.0

package/src/builders/remote/resolve-ng-options.d.ts

@@ -0,0 +1,24 @@
+import type { ApplicationBuilderOptions } from '@angular/build';
+import type { BuilderContext } from '@angular-devkit/architect';
+import type { NfRemoteBuilderSchema } from './schema.js';
+export interface ResolvedNgOptions {
+    ngBuilderOptions: ApplicationBuilderOptions;
+    projectRoot: string;
+    projectSourceRoot: string | undefined;
+}
+/**
+ * Builds the subset of ApplicationBuilderOptions that the esbuild adapter actually
+ * reads (see angular-bundler.ts / node-modules-bundler.ts).
+ *
+ * Unlike the `build` builder — which runs a full Angular target and has its options
+ * validated and defaulted by context.validateOptions — the remote builder has no
+ * Angular target to delegate to, so it forwards only these compile-level options
+ * straight from its own schema. `optimization`/`sourceMap` are normalized later at
+ * the point of use by the bundler.
+ *
+ * tsConfig, outputPath and assets are intentionally omitted: the federation adapter
+ * supplies the tsconfig path and output dir, and assets are copied by the remote
+ * builder's own pipeline (see assets.ts) — none are read off ApplicationBuilderOptions.
+ */
+export declare function resolveNgBuilderOptions(remote: NfRemoteBuilderSchema, context: BuilderContext): Promise<ResolvedNgOptions>;
+//# sourceMappingURL=resolve-ng-options.d.ts.map

package/src/builders/remote/resolve-ng-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-ng-options.d.ts","sourceRoot":"","sources":["../../../../src/builders/remote/resolve-ng-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEhE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEzD,MAAM,WAAW,iBAAiB;IAChC,gBAAgB,EAAE,yBAAyB,CAAC;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,qBAAqB,EAC7B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,iBAAiB,CAAC,CAe5B"}

package/src/builders/remote/resolve-ng-options.js

@@ -0,0 +1,28 @@
+/**
+ * Builds the subset of ApplicationBuilderOptions that the esbuild adapter actually
+ * reads (see angular-bundler.ts / node-modules-bundler.ts).
+ *
+ * Unlike the `build` builder — which runs a full Angular target and has its options
+ * validated and defaulted by context.validateOptions — the remote builder has no
+ * Angular target to delegate to, so it forwards only these compile-level options
+ * straight from its own schema. `optimization`/`sourceMap` are normalized later at
+ * the point of use by the bundler.
+ *
+ * tsConfig, outputPath and assets are intentionally omitted: the federation adapter
+ * supplies the tsconfig path and output dir, and assets are copied by the remote
+ * builder's own pipeline (see assets.ts) — none are read off ApplicationBuilderOptions.
+ */
+export async function resolveNgBuilderOptions(remote, context) {
+    const projectMetadata = await context.getProjectMetadata(context.target.project);
+    const projectRoot = projectMetadata['root'] ?? '';
+    const projectSourceRoot = projectMetadata['sourceRoot'];
+    const ngBuilderOptions = {
+        stylePreprocessorOptions: remote.stylePreprocessorOptions,
+        inlineStyleLanguage: remote.inlineStyleLanguage,
+        fileReplacements: remote.fileReplacements,
+        sourceMap: remote.sourceMap,
+        optimization: remote.optimization,
+        preserveSymlinks: remote.preserveSymlinks,
+    };
+    return { ngBuilderOptions, projectRoot, projectSourceRoot };
+}

package/src/builders/remote/schema.d.ts

@@ -0,0 +1,26 @@
+import type { JsonObject } from '@angular-devkit/core';
+import type { Plugin } from 'esbuild';
+import type { ApplicationBuilderOptions } from '@angular/build';
+
+export interface NfRemoteBuilderSchema extends JsonObject {
+  tsConfig: string;
+  dev: boolean;
+  rebuildDelay: number;
+  watch: boolean;
+  outputPath?: string;
+  projectName?: string;
+  verbose?: boolean;
+  entryPoints?: string[];
+  cacheExternalArtifacts?: boolean;
+
+  // Passthroughs to the Angular esbuild pipeline / asset copier.
+  assets?: ApplicationBuilderOptions['assets'];
+  stylePreprocessorOptions?: ApplicationBuilderOptions['stylePreprocessorOptions'];
+  inlineStyleLanguage?: ApplicationBuilderOptions['inlineStyleLanguage'];
+  fileReplacements?: ApplicationBuilderOptions['fileReplacements'];
+  sourceMap?: ApplicationBuilderOptions['sourceMap'];
+  optimization?: ApplicationBuilderOptions['optimization'];
+  preserveSymlinks?: ApplicationBuilderOptions['preserveSymlinks'];
+}
+
+export type NfRemoteInternalOptions = { plugins: Plugin[] };

package/src/builders/remote/schema.json

@@ -0,0 +1,116 @@
+{
+  "version": 2,
+  "outputCapture": "direct-nodejs",
+  "$schema": "http://json-schema.org/draft-07/schema",
+  "title": "native federation remote builder",
+  "description": "builder for native federation remotes that only produces the federation artifacts (remoteEntry.json + referenced files) plus copied assets. No Angular application build and no dev server; serving is handled externally.",
+  "type": "object",
+  "properties": {
+    "tsConfig": {
+      "type": "string",
+      "description": "Path to the tsconfig used to compile the exposed modules and shared mappings."
+    },
+    "dev": {
+      "type": "boolean",
+      "description": "Set this to true to start the builder in dev mode",
+      "default": false
+    },
+    "watch": {
+      "type": "boolean",
+      "default": false
+    },
+    "entryPoints": {
+      "type": "array"
+    },
+    "rebuildDelay": {
+      "type": "number",
+      "default": 2000,
+      "description": "Debounce delay (ms) before rebuilding federation artifacts after a file change in watch mode."
+    },
+    "projectName": {
+      "type": "string"
+    },
+    "outputPath": {
+      "type": "string"
+    },
+    "verbose": {
+      "type": "boolean",
+      "default": false
+    },
+    "cacheExternalArtifacts": {
+      "type": "boolean",
+      "default": true,
+      "description": "Will cache the shared externals so they can be re-used between builds",
+      "alias": "cache"
+    },
+    "assets": {
+      "type": "array",
+      "description": "Assets to copy into the output directory. Same shape as @angular/build:application 'assets'.",
+      "items": {
+        "oneOf": [
+          { "type": "string" },
+          {
+            "type": "object",
+            "properties": {
+              "glob": { "type": "string" },
+              "input": { "type": "string" },
+              "output": { "type": "string" },
+              "ignore": { "type": "array", "items": { "type": "string" } },
+              "followSymlinks": { "type": "boolean" }
+            },
+            "required": ["glob", "input"]
+          }
+        ]
+      }
+    },
+    "stylePreprocessorOptions": {
+      "type": "object",
+      "description": "Options passed to style preprocessors (e.g. Sass includePaths).",
+      "properties": {
+        "includePaths": { "type": "array", "items": { "type": "string" } },
+        "sass": { "type": "object" }
+      }
+    },
+    "inlineStyleLanguage": {
+      "type": "string",
+      "description": "Preprocessor language for inline component styles.",
+      "enum": ["css", "less", "sass", "scss"]
+    },
+    "fileReplacements": {
+      "type": "array",
+      "description": "Replace files listed in the build at compile time.",
+      "items": {
+        "type": "object",
+        "properties": {
+          "replace": { "type": "string" },
+          "with": { "type": "string" }
+        },
+        "required": ["replace", "with"]
+      }
+    },
+    "sourceMap": {
+      "description": "Enable or configure source maps.",
+      "oneOf": [
+        { "type": "boolean" },
+        {
+          "type": "object",
+          "properties": {
+            "scripts": { "type": "boolean" },
+            "styles": { "type": "boolean" },
+            "hidden": { "type": "boolean" },
+            "vendor": { "type": "boolean" }
+          }
+        }
+      ]
+    },
+    "optimization": {
+      "description": "Enable or configure optimizations.",
+      "oneOf": [{ "type": "boolean" }, { "type": "object" }]
+    },
+    "preserveSymlinks": {
+      "type": "boolean",
+      "description": "Do not use the real path when resolving modules."
+    }
+  },
+  "required": ["tsConfig"]
+}

package/src/config/angular-locales.d.ts

@@ -0,0 +1,6 @@
+import { type ExternalConfig } from '@softarc/native-federation/config';
+export declare function shareAngularLocales(keys: string[], opts?: {
+    config?: ExternalConfig;
+    legacy?: boolean;
+}): import("@softarc/native-federation").ShareExternalsOptions;
+//# sourceMappingURL=angular-locales.d.ts.map

package/src/config/angular-locales.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"angular-locales.d.ts","sourceRoot":"","sources":["../../../src/config/angular-locales.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAE/E,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,cAAc,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,8DA0BzD"}

package/src/config/angular-locales.js

@@ -0,0 +1,23 @@
+import { share } from '@softarc/native-federation/config';
+export function shareAngularLocales(keys, opts = {}) {
+    if (!opts.config) {
+        opts.config = {
+            singleton: true,
+            strictVersion: true,
+            requiredVersion: 'auto',
+        };
+    }
+    const ext = opts.legacy ? '.mjs' : '.js';
+    const locales = keys.reduce((acc, key) => {
+        acc[`@angular/common/locales/${key}`] = {
+            ...opts.config,
+            packageInfo: {
+                esm: true,
+                entryPoint: `node_modules/@angular/common/locales/${key}${ext}`,
+                ...opts.config.packageInfo,
+            },
+        };
+        return acc;
+    }, {});
+    return share(locales);
+}

package/src/config/angular-skip-list.d.ts

@@ -0,0 +1,3 @@
+import { type SkipList } from "@module-federation/esbuild/dist/lib/core/default-skip-list.js";
+export declare const NG_SKIP_LIST: SkipList;
+//# sourceMappingURL=angular-skip-list.d.ts.map

package/src/config/angular-skip-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"angular-skip-list.d.ts","sourceRoot":"","sources":["../../../src/config/angular-skip-list.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,KAAK,QAAQ,EAEd,MAAM,+DAA+D,CAAC;AAEvE,eAAO,MAAM,YAAY,EAAE,QAa1B,CAAC"}

package/src/config/angular-skip-list.js

@@ -0,0 +1,23 @@
+// M3.2 — Angular skip-list, MF-native. Two NF couplings broken vs the old file:
+//   (1) `SkipList` type + `DEFAULT_SKIP_LIST` base now come from
+//       `@module-federation/esbuild` (deep import, Breakage-A-free, like M3.1)
+//       instead of `@softarc/native-federation/config`;
+//   (2) the self-listed package paths are the **renamed** package, not the old
+//       `@angular-architects/native-federation*`.
+// The `@angular/localize*`, `*/upgrade`, `*/testing`, `@nx/angular`, and `zone.js`
+// entries carry over unchanged.
+import { DEFAULT_SKIP_LIST, } from "@module-federation/esbuild/dist/lib/core/default-skip-list.js";
+export const NG_SKIP_LIST = [
+    ...DEFAULT_SKIP_LIST,
+    "module-federation-angular-adapter",
+    "module-federation-angular-adapter/config",
+    "module-federation-angular-adapter/internal",
+    "zone.js",
+    "@angular/localize",
+    "@angular/localize/init",
+    "@angular/localize/tools",
+    "@angular/router/upgrade",
+    "@angular/common/upgrade",
+    /^@nx\/angular/,
+    (pkg) => pkg.startsWith("@angular/") && !!pkg.match(/\/testing(\/|$)/),
+];

package/src/config/with-module-federation.d.ts

@@ -0,0 +1,72 @@
+import { NG_SKIP_LIST } from './angular-skip-list.js';
+/**
+ * Package-name prefixes that imply a server (Node) build. Matched with
+ * `startsWith`, so secondary entry points (e.g. `@angular/ssr/node`) match too.
+ * (Carried over from NF's `share-utils.ts` unchanged.)
+ */
+export declare const SERVER_DEPENDENCIES: string[];
+/**
+ * Infers the default federation platform from the shared dependency keys:
+ * `'node'` if any is an Angular server package, else `'browser'`.
+ *
+ * ⚠️ MF has **no `platform` shared-key** (M3.1 table) — this stays an Angular-side
+ * build hint (drives the SSR side build + shared-set selection, Phase 4), not an
+ * MF `shared` field.
+ */
+export declare function getDefaultPlatform(deps: string[]): 'browser' | 'node';
+/** MF shared-config entry (mirrors `@module-federation/esbuild`'s `SharedConfig`). */
+export interface MfSharedConfig {
+    requiredVersion?: string;
+    singleton?: boolean;
+    strictVersion?: boolean;
+    version?: string;
+    eager?: boolean;
+    includeSecondaries?: boolean | {
+        skip?: string | string[];
+    };
+}
+/**
+ * Share specific packages as MF singletons. Thin pass-through to MF-esbuild's
+ * `share` (which resolves `requiredVersion: 'auto'`-style versions via
+ * `lookupVersion` at config-build time — the M3.1 table's `'auto'` mapping).
+ */
+export declare function share(shareObjects: Record<string, MfSharedConfig>, projectPath?: string): Record<string, MfSharedConfig>;
+/**
+ * Share all dependencies from `package.json` as MF singletons. Delegates to
+ * MF-esbuild's `shareAll`; `skip` defaults to the Angular skip-list
+ * ({@link NG_SKIP_LIST}, M3.2) so Angular framework/testing/locale packages and
+ * this adapter itself are not auto-shared.
+ */
+export declare function shareAll(config: MfSharedConfig, skip?: typeof NG_SKIP_LIST, projectPath?: string): Record<string, MfSharedConfig>;
+/** Normalized output of {@link withModuleFederation} (consumed by the side build). */
+export interface NormalizedModuleFederationConfig {
+    name: string;
+    filename: string;
+    exposes: Record<string, string>;
+    remotes: Record<string, string>;
+    shared: Record<string, MfSharedConfig>;
+    /** Angular-side build hint, not an MF shared key. */
+    platform: 'browser' | 'node';
+}
+/** Angular federation config input (mirrors NF's `FederationConfig` surface). */
+export interface ModuleFederationConfig {
+    name?: string;
+    filename?: string;
+    exposes?: Record<string, string>;
+    remotes?: Record<string, string>;
+    shared?: Record<string, MfSharedConfig>;
+    skip?: string[];
+    /** Angular-side build hint (browser|node); auto-filled from shared deps if omitted. */
+    platform?: 'browser' | 'node';
+}
+/**
+ * Angular `withModuleFederation` (M3.1). Auto-fills the Angular-side `platform`
+ * hint (NF parity), then normalizes via MF-esbuild's own `withFederation`.
+ *
+ * NF→MF field decisions (M3.1 table): `singleton`/`strictVersion`/`requiredVersion`/
+ * `version`/`eager`/`includeSecondaries` all map 1:1 (the MF plugin supports
+ * `includeSecondaries` — finding #4). NF-only `build`/`features.{denseChunking,
+ * ignoreUnusedDeps}` are **dropped** (no MF equivalent; MF shares only what's listed).
+ */
+export declare function withModuleFederation(cfg: ModuleFederationConfig): NormalizedModuleFederationConfig;
+//# sourceMappingURL=with-module-federation.d.ts.map

package/src/config/with-module-federation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-module-federation.d.ts","sourceRoot":"","sources":["../../../src/config/with-module-federation.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,UAA+C,CAAC;AAEhF;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG,MAAM,CAIrE;AAED,sFAAsF;AACtF,MAAM,WAAW,cAAc;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,kBAAkB,CAAC,EAAE,OAAO,GAAG;QAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;KAAE,CAAC;CAC7D;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CACnB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,EAC5C,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAEhC;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CACtB,MAAM,EAAE,cAAc,EACtB,IAAI,GAAE,OAAO,YAA2B,EACxC,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAMhC;AAED,sFAAsF;AACtF,MAAM,WAAW,gCAAgC;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACvC,qDAAqD;IACrD,QAAQ,EAAE,SAAS,GAAG,MAAM,CAAC;CAC9B;AAED,iFAAiF;AACjF,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACxC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,uFAAuF;IACvF,QAAQ,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;CAC/B;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,sBAAsB,GAC1B,gCAAgC,CAgBlC"}

package/src/config/with-module-federation.js

@@ -0,0 +1,72 @@
+// M3.1 — `withModuleFederation` mirroring NF's `withNativeFederation`, built as a
+// thin Angular wrapper over `@module-federation/esbuild`'s OWN config layer
+// (finding #4). Imported from the deep `dist/lib/config/*` path because the
+// high-level `./build` entry throws on import (Breakage A, the `json5` defect);
+// the deep path is allowed by the package's `"./*"` export and is Breakage-A-free.
+// ⚠️ Deep-import fragility: pinned to @module-federation/esbuild@0.0.109 internals;
+// re-verify these paths on any version bump (tracked with the dominant 0.0.x risk).
+import { share as coreShare, shareAll as coreShareAll, } from '@module-federation/esbuild/dist/lib/config/share-utils.js';
+import { withFederation as coreWithFederation } from '@module-federation/esbuild/dist/lib/config/with-native-federation.js';
+import { NG_SKIP_LIST } from './angular-skip-list.js';
+/**
+ * Package-name prefixes that imply a server (Node) build. Matched with
+ * `startsWith`, so secondary entry points (e.g. `@angular/ssr/node`) match too.
+ * (Carried over from NF's `share-utils.ts` unchanged.)
+ */
+export const SERVER_DEPENDENCIES = ['@angular/platform-server', '@angular/ssr'];
+/**
+ * Infers the default federation platform from the shared dependency keys:
+ * `'node'` if any is an Angular server package, else `'browser'`.
+ *
+ * ⚠️ MF has **no `platform` shared-key** (M3.1 table) — this stays an Angular-side
+ * build hint (drives the SSR side build + shared-set selection, Phase 4), not an
+ * MF `shared` field.
+ */
+export function getDefaultPlatform(deps) {
+    return deps.some((dep) => SERVER_DEPENDENCIES.some((s) => dep.startsWith(s)))
+        ? 'node'
+        : 'browser';
+}
+/**
+ * Share specific packages as MF singletons. Thin pass-through to MF-esbuild's
+ * `share` (which resolves `requiredVersion: 'auto'`-style versions via
+ * `lookupVersion` at config-build time — the M3.1 table's `'auto'` mapping).
+ */
+export function share(shareObjects, projectPath) {
+    return coreShare(shareObjects, projectPath);
+}
+/**
+ * Share all dependencies from `package.json` as MF singletons. Delegates to
+ * MF-esbuild's `shareAll`; `skip` defaults to the Angular skip-list
+ * ({@link NG_SKIP_LIST}, M3.2) so Angular framework/testing/locale packages and
+ * this adapter itself are not auto-shared.
+ */
+export function shareAll(config, skip = NG_SKIP_LIST, projectPath) {
+    return coreShareAll(config, skip, projectPath);
+}
+/**
+ * Angular `withModuleFederation` (M3.1). Auto-fills the Angular-side `platform`
+ * hint (NF parity), then normalizes via MF-esbuild's own `withFederation`.
+ *
+ * NF→MF field decisions (M3.1 table): `singleton`/`strictVersion`/`requiredVersion`/
+ * `version`/`eager`/`includeSecondaries` all map 1:1 (the MF plugin supports
+ * `includeSecondaries` — finding #4). NF-only `build`/`features.{denseChunking,
+ * ignoreUnusedDeps}` are **dropped** (no MF equivalent; MF shares only what's listed).
+ */
+export function withModuleFederation(cfg) {
+    const platform = cfg.platform ?? getDefaultPlatform(Object.keys(cfg.shared ?? {}));
+    const { name, filename, exposes, remotes, shared, skip } = cfg;
+    // Cast: upstream `withFederation` types `includeSecondaries` as `boolean` only,
+    // while its own `share-utils` accepts the `{ skip }` object form too — the
+    // runtime handles both. (Type defs disagree across the two upstream modules.)
+    const normalized = coreWithFederation({
+        name,
+        filename,
+        exposes,
+        remotes,
+        shared,
+        skip,
+    });
+    // `platform` is re-attached as an Angular-side hint (not an MF shared key).
+    return { ...normalized, platform };
+}

package/src/config.d.ts

@@ -0,0 +1,4 @@
+export { share, shareAll, withModuleFederation, getDefaultPlatform, SERVER_DEPENDENCIES, type ModuleFederationConfig, type MfSharedConfig, } from './config/with-module-federation.js';
+export { NG_SKIP_LIST } from './config/angular-skip-list.js';
+export { shareAngularLocales } from './config/angular-locales.js';
+//# sourceMappingURL=config.d.ts.map

package/src/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EACL,QAAQ,EACR,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,KAAK,sBAAsB,EAC3B,KAAK,cAAc,GACpB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC"}

package/src/config.js

@@ -0,0 +1,3 @@
+export { share, shareAll, withModuleFederation, getDefaultPlatform, SERVER_DEPENDENCIES, } from './config/with-module-federation.js';
+export { NG_SKIP_LIST } from './config/angular-skip-list.js';
+export { shareAngularLocales } from './config/angular-locales.js';

package/src/generators/native-federation/files/src/index.ts__template__

@@ -0,0 +1 @@
+const variable = "<%= projectName %>";

package/src/generators/native-federation/generator.d.ts

@@ -0,0 +1,4 @@
+import { type Tree } from "@nx/devkit";
+import type { NativeFederationGeneratorSchema } from "./schema.js";
+export default function (tree: Tree, options: NativeFederationGeneratorSchema): Promise<void>;
+//# sourceMappingURL=generator.d.ts.map

package/src/generators/native-federation/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../../../src/generators/native-federation/generator.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,IAAI,EACV,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,aAAa,CAAC;AA+CnE,yBACE,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,+BAA+B,iBAgBzC"}

package/src/generators/native-federation/generator.js

@@ -0,0 +1,45 @@
+import { addProjectConfiguration, formatFiles, generateFiles, getWorkspaceLayout, names, offsetFromRoot, } from "@nx/devkit";
+import * as path from "path";
+function normalizeOptions(tree, options) {
+    const name = names(options.name).fileName;
+    const projectDirectory = options.directory
+        ? `${names(options.directory).fileName}/${name}`
+        : name;
+    const projectName = projectDirectory.replace(new RegExp("/", "g"), "-");
+    const projectRoot = `${getWorkspaceLayout(tree).libsDir}/${projectDirectory}`;
+    const parsedTags = options.tags
+        ? options.tags.split(",").map((s) => s.trim())
+        : [];
+    return {
+        ...options,
+        projectName,
+        projectRoot,
+        projectDirectory,
+        parsedTags,
+    };
+}
+function addFiles(tree, options) {
+    const templateOptions = {
+        ...options,
+        ...names(options.name),
+        offsetFromRoot: offsetFromRoot(options.projectRoot),
+        template: "",
+    };
+    generateFiles(tree, path.join(__dirname, "files"), options.projectRoot, templateOptions);
+}
+export default async function (tree, options) {
+    const normalizedOptions = normalizeOptions(tree, options);
+    addProjectConfiguration(tree, normalizedOptions.projectName, {
+        root: normalizedOptions.projectRoot,
+        projectType: "library",
+        sourceRoot: `${normalizedOptions.projectRoot}/src`,
+        targets: {
+            build: {
+                executor: "module-federation-angular-adapter:build",
+            },
+        },
+        tags: normalizedOptions.parsedTags,
+    });
+    addFiles(tree, normalizedOptions);
+    await formatFiles(tree);
+}

package/src/generators/native-federation/schema.d.ts

@@ -0,0 +1,5 @@
+export interface NativeFederationGeneratorSchema {
+  name: string;
+  tags?: string;
+  directory?: string;
+}

package/src/generators/native-federation/schema.json

@@ -0,0 +1,29 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "cli": "nx",
+  "$id": "NativeFederation",
+  "title": "",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "",
+      "$default": {
+        "$source": "argv",
+        "index": 0
+      },
+      "x-prompt": "What name would you like to use?"
+    },
+    "tags": {
+      "type": "string",
+      "description": "Add tags to the project (used for linting)",
+      "alias": "t"
+    },
+    "directory": {
+      "type": "string",
+      "description": "A directory where the project is placed",
+      "alias": "d"
+    }
+  },
+  "required": ["name"]
+}

package/src/index.d.ts

@@ -0,0 +1,82 @@
+import { createInstance, type ModuleFederation, type ModuleFederationRuntimePlugin } from '@module-federation/runtime';
+/**
+ * Options for {@link FederationInstance.loadRemoteModule}.
+ *
+ * @property remoteName - Name of the remote as registered in
+ *   {@link initFederation}, or derived from `remoteEntry`.
+ * @property remoteEntry - URL to the remote's `remoteEntry.js` / `mf-manifest.json`.
+ *   Enables lazy-loading remotes not registered up front (wired in M1.3).
+ * @property exposedModule - Key exposed by the remote (e.g. `'./Component'`).
+ * @property fallback - Value returned on failure. Truthy-only — `null`/`0`/`''`
+ *   count as "no fallback".
+ */
+export type LoadRemoteModuleOptions<T = any> = {
+    remoteEntry?: string;
+    remoteName?: string;
+    exposedModule: string;
+    fallback?: T;
+};
+/** MF runtime `shared` map, derived from `createInstance` so we don't reach into the transitive `runtime-core`. */
+export type SharedConfig = NonNullable<Parameters<typeof createInstance>[0]['shared']>;
+/**
+ * Framework packages that MUST resolve to a single instance, or Angular trips
+ * `NG0203`. Registered as MF singletons (M0.2's mandated config).
+ *
+ * `requiredVersion: false` for now — the singleton is enforced but the version
+ * check is relaxed, because resolving the installed version (NF's
+ * `requiredVersion: 'auto'`) is a config-build-time concern owned by
+ * `withModuleFederation` in **M3.1**; once that lands it feeds concrete ranges
+ * here. The actual module sharing flows through es-module-shims import maps at
+ * runtime (finding #6) — this map only declares the singleton/version contract.
+ */
+export declare const DEFAULT_ANGULAR_SHARED: SharedConfig;
+/**
+ * Options for {@link initFederation}. NF-native knobs (`shimMode`, `sse`,
+ * `cacheTag`, `logging`) are intentionally dropped — MF manages its import map
+ * internally and exposes behaviour through runtime plugins instead.
+ */
+export interface InitFederationOptions {
+    /** Instance name registered with the MF share scope (default `'host'`). */
+    name?: string;
+    /** MF runtime plugins (replaces NF's `shimMode`/`esmsInitOptions`). */
+    runtimePlugins?: ModuleFederationRuntimePlugin[];
+    /** Override the default MF share scope name. */
+    shareScope?: string;
+    /**
+     * Shared singletons to register. Merged over {@link DEFAULT_ANGULAR_SHARED}
+     * (pass `{}` and spread a filtered default to opt out of a framework dep).
+     */
+    shared?: SharedConfig;
+}
+/**
+ * Handle returned by {@link initFederation}. Holds the live MF instance and the
+ * `loadRemoteModule` bound to it. (The NF-era module-scoped standalone
+ * `loadRemoteModule` export was dropped in M1.3 — destructure from here instead.)
+ */
+export interface FederationInstance {
+    /** Load an exposed module from a registered remote. */
+    loadRemoteModule<T = unknown>(remoteName: string, exposedModule: string): Promise<T>;
+    loadRemoteModule<T = unknown>(options: LoadRemoteModuleOptions<T>): Promise<T>;
+    /** The underlying `@module-federation/runtime` instance, for advanced use. */
+    readonly instance: ModuleFederation;
+}
+/** name → remoteEntry/manifest URL (the MF-native `entry` of each remote). */
+type RemotesMap = Record<string, string>;
+/**
+ * Initialise Module Federation for an Angular host.
+ *
+ * Unlike NF's promise-returning init, this is **synchronous** — MF's
+ * `createInstance` is sync and remotes load lazily on first `loadRemoteModule`.
+ *
+ * ```ts
+ * const { loadRemoteModule } = initFederation({ mfe1: 'http://localhost:4201/remoteEntry.js' });
+ * const m = await loadRemoteModule('mfe1', './Component');
+ * ```
+ *
+ * @param remotes - name → remoteEntry/manifest URL map. (A bare manifest-URL
+ *   string, like NF's `remotesOrManifestUrl`, is deferred to M1.7.)
+ * @param options - {@link InitFederationOptions}.
+ */
+export declare function initFederation(remotes?: RemotesMap, options?: InitFederationOptions): FederationInstance;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AASA,OAAO,EACL,cAAc,EACd,KAAK,gBAAgB,EACrB,KAAK,6BAA6B,EACnC,MAAM,4BAA4B,CAAC;AAEpC;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,uBAAuB,CAAC,CAAC,GAAG,GAAG,IAAI;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,CAAC,CAAC;CACd,CAAC;AAEF,mHAAmH;AACnH,MAAM,MAAM,YAAY,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;AAEvF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,sBAAsB,EAAE,YAQpC,CAAC;AAEF;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,2EAA2E;IAC3E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,cAAc,CAAC,EAAE,6BAA6B,EAAE,CAAC;IACjD,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,uDAAuD;IACvD,gBAAgB,CAAC,CAAC,GAAG,OAAO,EAC1B,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,CAAC,CAAC,CAAC;IACd,gBAAgB,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE,uBAAuB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC/E,8EAA8E;IAC9E,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;CACrC;AAED,8EAA8E;AAC9E,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AA4FzC;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAC5B,OAAO,GAAE,UAAe,EACxB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,kBAAkB,CA0BpB"}