module-federation-angular-adapter 0.2200.0

package/src/schematics/init/steps/update-polyfills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-polyfills.d.ts","sourceRoot":"","sources":["../../../../../src/schematics/init/steps/update-polyfills.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAEvD,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,QAMvE"}

package/src/schematics/init/steps/update-polyfills.js

@@ -0,0 +1,21 @@
+export function updatePolyfills(tree, polyfills) {
+    if (typeof polyfills === 'string') {
+        updatePolyfillsFile(tree, polyfills);
+    }
+    else {
+        updatePolyfillsArray(tree, polyfills);
+    }
+}
+function updatePolyfillsFile(tree, polyfills) {
+    let polyfillsContent = tree.readText(polyfills);
+    if (!polyfillsContent.includes('es-module-shims')) {
+        polyfillsContent += `\nimport 'es-module-shims';\n`;
+        tree.overwrite(polyfills, polyfillsContent);
+    }
+}
+function updatePolyfillsArray(_tree, polyfills) {
+    const polyfillsConfig = polyfills;
+    if (!polyfillsConfig.includes('es-module-shims')) {
+        polyfillsConfig.push('es-module-shims');
+    }
+}

package/src/schematics/init/steps/update-workspace-config.d.ts

@@ -0,0 +1,4 @@
+import type { Tree } from "@angular-devkit/schematics";
+import type { NormalizedOptions } from "./normalize-options.js";
+export declare function updateWorkspaceConfig(tree: Tree, options: NormalizedOptions, workspace: any, workspaceFileName: string): void;
+//# sourceMappingURL=update-workspace-config.d.ts.map

package/src/schematics/init/steps/update-workspace-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-workspace-config.d.ts","sourceRoot":"","sources":["../../../../../src/schematics/init/steps/update-workspace-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,iBAAiB,EAC1B,SAAS,EAAE,GAAG,EACd,iBAAiB,EAAE,MAAM,QAmG1B"}

package/src/schematics/init/steps/update-workspace-config.js

@@ -0,0 +1,76 @@
+export function updateWorkspaceConfig(tree, options, workspace, workspaceFileName) {
+    const { projectConfig, projectName, port } = options;
+    if (!projectConfig?.architect?.build || !projectConfig?.architect?.serve) {
+        throw new Error(`The project doesn't have a build or serve target in angular.json!`);
+    }
+    if (projectConfig.architect.build.builder ===
+        "module-federation-angular-adapter:build") {
+        console.log("native-federation builder is already set, skipping workspace setup.");
+        return;
+    }
+    const originalBuild = projectConfig.architect.build;
+    // Force the esbuild application builder. The build target Angular scaffolds is
+    // either `@angular-devkit/build-angular:application` or `@angular/build:application`;
+    // both normalize to the latter here.
+    console.log("Switching project to the application builder using esbuild ...");
+    originalBuild.builder = "@angular/build:application";
+    delete originalBuild.configurations?.development?.buildOptimizer;
+    delete originalBuild.configurations?.development?.vendorChunk;
+    if (originalBuild.options.main) {
+        const main = originalBuild.options.main;
+        delete originalBuild.options.main;
+        originalBuild.options.browser = main;
+    }
+    delete originalBuild.options.commonChunk;
+    projectConfig.architect.esbuild = originalBuild;
+    projectConfig.architect.build = {
+        builder: "module-federation-angular-adapter:build",
+        options: {
+            cacheExternalArtifacts: true,
+        },
+        configurations: {
+            production: {
+                target: `${projectName}:esbuild:production`,
+            },
+            development: {
+                target: `${projectName}:esbuild:development`,
+                dev: true,
+            },
+        },
+        defaultConfiguration: "production",
+    };
+    const serve = projectConfig.architect.serve;
+    serve.options ??= {};
+    serve.options.port = port;
+    delete serve.options.commonChunk;
+    const serveProd = projectConfig.architect.serve.configurations?.production;
+    if (serveProd) {
+        serveProd.buildTarget = `${projectName}:esbuild:production`;
+        delete serveProd.browserTarget;
+    }
+    const serveDev = projectConfig.architect.serve.configurations?.development;
+    if (serveDev) {
+        serveDev.buildTarget = `${projectName}:esbuild:development`;
+        delete serveDev.browserTarget;
+    }
+    projectConfig.architect["serve-original"] = projectConfig.architect.serve;
+    projectConfig.architect.serve = {
+        builder: "module-federation-angular-adapter:build",
+        options: {
+            target: `${projectName}:serve-original:development`,
+            rebuildDelay: 500,
+            cacheExternalArtifacts: true,
+            dev: true,
+            devServer: true,
+            port: 0,
+        },
+    };
+    const serveSsr = projectConfig.architect["serve-ssr"];
+    if (serveSsr && !serveSsr.options) {
+        serveSsr.options = {};
+    }
+    if (serveSsr) {
+        serveSsr.options.port = port;
+    }
+    tree.overwrite(workspaceFileName, JSON.stringify(workspace, null, "\t"));
+}

package/src/schematics/remove/schema.d.ts

@@ -0,0 +1,3 @@
+export interface NfSchematicSchema {
+  project: string;
+}

package/src/schematics/remove/schema.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "$id": "nf",
+  "title": "",
+  "type": "object",
+  "properties": {
+    "project": {
+      "type": "string",
+      "description": "The project to remove native federation from",
+      "$default": {
+        "$source": "argv",
+        "index": 0
+      },
+      "x-prompt": "Project name (press enter for default project)"
+    }
+  }
+}

package/src/schematics/remove/schematic.d.ts

@@ -0,0 +1,5 @@
+import type { Rule, Tree } from '@angular-devkit/schematics';
+import type { NfSchematicSchema } from './schema.js';
+export default function remove(options: NfSchematicSchema): Rule;
+export declare function getWorkspaceFileName(tree: Tree): string;
+//# sourceMappingURL=schematic.d.ts.map

package/src/schematics/remove/schematic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schematic.d.ts","sourceRoot":"","sources":["../../../../src/schematics/remove/schematic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAE7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAcrD,MAAM,CAAC,OAAO,UAAU,MAAM,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAgB/D;AA+GD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAUvD"}

package/src/schematics/remove/schematic.js

@@ -0,0 +1,106 @@
+import * as path from 'path';
+export default function remove(options) {
+    return async function (tree) {
+        const workspaceFileName = getWorkspaceFileName(tree);
+        const workspace = JSON.parse(tree.read(workspaceFileName)?.toString('utf8') ?? '{}');
+        const normalized = normalizeOptions(options, workspace);
+        const { polyfills, projectRoot } = normalized;
+        const bootstrapPath = path.join(projectRoot, 'src/bootstrap.ts');
+        const mainPath = path.join(projectRoot, 'src/main.ts');
+        makeMainSync(tree, bootstrapPath, mainPath);
+        updatePolyfills(tree, polyfills);
+        updateWorkspaceConfig(tree, normalized, workspace, workspaceFileName);
+    };
+}
+function makeMainSync(tree, bootstrapPath, mainPath) {
+    if (tree.exists(bootstrapPath) && tree.exists(mainPath)) {
+        tree.delete(mainPath);
+        tree.rename(bootstrapPath, mainPath);
+    }
+}
+function updateWorkspaceConfig(tree, options, workspace, workspaceFileName) {
+    const { projectConfig } = options;
+    if (!projectConfig?.architect?.build || !projectConfig?.architect?.serve) {
+        throw new Error(`The project doesn't have a build or serve target in angular.json!`);
+    }
+    if (projectConfig.architect.esbuild) {
+        projectConfig.architect.build = projectConfig.architect.esbuild;
+        delete projectConfig.architect.esbuild;
+    }
+    if (projectConfig.architect['serve-original']) {
+        projectConfig.architect.serve = projectConfig.architect['serve-original'];
+        delete projectConfig.architect['serve-original'];
+    }
+    if (projectConfig.architect.serve) {
+        const conf = projectConfig.architect.serve.configurations;
+        conf.production.buildTarget = conf.production.buildTarget.replace(':esbuild:', ':build:');
+        conf.development.buildTarget = conf.development.buildTarget.replace(':esbuild:', ':build:');
+    }
+    tree.overwrite(workspaceFileName, JSON.stringify(workspace, null, '\t'));
+}
+function normalizeOptions(options, workspace) {
+    const projects = Object.keys(workspace.projects);
+    if (!options.project && projects.length === 0) {
+        throw new Error(`No default project found. Please specifiy a project name!`);
+    }
+    if (!options.project) {
+        console.log('Using first configured project as default project: ' + projects[0]);
+        options.project = projects[0];
+    }
+    const projectName = options.project;
+    const projectConfig = workspace.projects[projectName];
+    if (!projectConfig) {
+        throw new Error(`Project ${projectName} not found in angular.json.`);
+    }
+    const projectRoot = projectConfig.root?.replace(/\\/g, '/');
+    const projectSourceRoot = projectConfig.sourceRoot?.replace(/\\/g, '/');
+    const manifestPath = path
+        .join(projectRoot, 'src/assets/federation.manifest.json')
+        .replace(/\\/g, '/');
+    const main = projectConfig.architect.build.options.main;
+    if (!projectConfig.architect.build.options.polyfills) {
+        projectConfig.architect.build.options.polyfills = [];
+    }
+    const polyfills = projectConfig.architect.build.options.polyfills;
+    return {
+        polyfills,
+        projectName,
+        projectRoot,
+        projectSourceRoot,
+        manifestPath,
+        projectConfig,
+        main,
+    };
+}
+function updatePolyfills(tree, polyfills) {
+    if (typeof polyfills === 'string') {
+        updatePolyfillsFile(tree, polyfills);
+    }
+    else {
+        updatePolyfillsArray(tree, polyfills);
+    }
+}
+function updatePolyfillsFile(tree, polyfills) {
+    let polyfillsContent = tree.readText(polyfills);
+    if (polyfillsContent.includes('es-module-shims')) {
+        polyfillsContent = polyfillsContent.replace(`import 'es-module-shims';`, '');
+        tree.overwrite(polyfills, polyfillsContent);
+    }
+}
+function updatePolyfillsArray(_tree, polyfills) {
+    const polyfillsConfig = polyfills;
+    const index = polyfillsConfig.findIndex(p => p === 'es-module-shims');
+    if (index === -1) {
+        return;
+    }
+    polyfillsConfig.splice(index, 1);
+}
+export function getWorkspaceFileName(tree) {
+    if (tree.exists('angular.json')) {
+        return 'angular.json';
+    }
+    if (tree.exists('workspace.json')) {
+        return 'workspace.json';
+    }
+    throw new Error("angular.json or workspace.json expected! Did you call this in your project's root?");
+}

package/src/tools/esbuild/angular-bundler.d.ts

@@ -0,0 +1,10 @@
+import * as esbuild from 'esbuild';
+import type { NormalizedContextOptions } from '../../utils/normalize-context-options.js';
+export declare function createAngularEsbuildContext(options: NormalizedContextOptions, extra?: {
+    extraPlugins?: esbuild.Plugin[];
+    write?: boolean;
+}): Promise<{
+    ctx: esbuild.BuildContext;
+    pluginDisposed: Promise<void>;
+}>;
+//# sourceMappingURL=angular-bundler.d.ts.map

package/src/tools/esbuild/angular-bundler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"angular-bundler.d.ts","sourceRoot":"","sources":["../../../../src/tools/esbuild/angular-bundler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AAiBnC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AAGzF,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,wBAAwB,EAOjC,KAAK,GAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAC/D,OAAO,CAAC;IACT,GAAG,EAAE,OAAO,CAAC,YAAY,CAAC;IAC1B,cAAc,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B,CAAC,CAsJD"}

package/src/tools/esbuild/angular-bundler.js

@@ -0,0 +1,134 @@
+import * as esbuild from 'esbuild';
+import * as path from 'path';
+import { createRequire } from 'node:module';
+import { transformSupportedBrowsersToTargets, getSupportedBrowsers, generateSearchDirectories, findTailwindConfiguration, loadPostcssConfiguration, } from '@angular/build/private';
+import { normalizeOptimization, normalizeSourceMaps } from '../../utils/normalize-build-options.js';
+import { createAwaitableCompilerPlugin } from './create-awaitable-compiler-plugin.js';
+import { updateFederationTsConfig } from './create-federation-tsconfig.js';
+export async function createAngularEsbuildContext(options, 
+// `extraPlugins`: appended after the Angular compiler — the MF side build (M2.1)
+// injects `moduleFederationPlugin` here (one-pass composition).
+// `write`: defaults to `false` (NF's adapter wrote outputs itself via writeResult).
+// The MF side build MUST set `true` (M2.2): the plugin's `onEnd` reads the
+// emitted container off disk (`fs.readFileSync`) to inject the module map, so it
+// does not honor `write:false`.
+extra = {}) {
+    const { builderOptions, context, entryPoints, external, outdir, cache, dev, hash, chunks, platform, optimizedMappings, } = options;
+    let tsConfigPath = options.tsConfigPath;
+    if (!tsConfigPath) {
+        throw new Error('tsConfigPath is required for Angular/esbuild context creation');
+    }
+    const workspaceRoot = context.workspaceRoot;
+    const projectMetadata = await context.getProjectMetadata(context.target.project);
+    const projectRoot = path.join(workspaceRoot, projectMetadata['root'] ?? '');
+    const browsers = getSupportedBrowsers(projectRoot, context.logger);
+    const target = transformSupportedBrowsersToTargets(browsers);
+    const optimizationOptions = normalizeOptimization(builderOptions.optimization);
+    const sourcemapOptions = normalizeSourceMaps(builderOptions.sourceMap);
+    const searchDirectories = await generateSearchDirectories([projectRoot, workspaceRoot]);
+    const postcssConfiguration = await loadPostcssConfiguration(searchDirectories);
+    const tailwindConfiguration = postcssConfiguration
+        ? undefined
+        : await getTailwindConfig(searchDirectories);
+    const outputNames = {
+        bundles: '[name]',
+        media: 'media/[name]',
+    };
+    let fileReplacements;
+    if (builderOptions.fileReplacements) {
+        for (const replacement of builderOptions.fileReplacements) {
+            fileReplacements ??= {};
+            fileReplacements[path.join(workspaceRoot, replacement.replace)] = path.join(workspaceRoot, replacement.with);
+        }
+    }
+    if (optimizedMappings) {
+        updateFederationTsConfig(workspaceRoot, tsConfigPath, entryPoints);
+    }
+    tsConfigPath = path.join(workspaceRoot, tsConfigPath);
+    const pluginOptions = {
+        sourcemap: !!sourcemapOptions.scripts && (sourcemapOptions.hidden ? 'external' : true),
+        thirdPartySourcemaps: sourcemapOptions.vendor,
+        tsconfig: tsConfigPath,
+        jit: false,
+        advancedOptimizations: !dev,
+        fileReplacements,
+        sourceFileCache: cache.bundlerCache,
+        loadResultCache: cache.bundlerCache.loadResultCache,
+        incremental: true,
+        includeTestMetadata: !optimizationOptions.scripts,
+        instrumentForCoverage: builderOptions.instrumentForCoverage,
+    };
+    const stylesheetBundlerOptions = {
+        workspaceRoot,
+        inlineFonts: !!optimizationOptions.fonts.inline,
+        optimization: !!optimizationOptions.styles.minify,
+        sourcemap: 
+        // Hidden component stylesheet sourcemaps are inaccessible which is effectively
+        // the same as being disabled. Disabling has the advantage of avoiding the overhead
+        // of sourcemap processing.
+        sourcemapOptions.styles && !sourcemapOptions.hidden ? 'linked' : false,
+        outputNames,
+        includePaths: builderOptions.stylePreprocessorOptions?.includePaths,
+        sass: builderOptions?.stylePreprocessorOptions?.sass,
+        externalDependencies: external,
+        target,
+        inlineStyleLanguage: builderOptions.inlineStyleLanguage ?? 'css',
+        preserveSymlinks: builderOptions.preserveSymlinks,
+        tailwindConfiguration,
+        postcssConfiguration,
+        cacheOptions: {
+            enabled: true,
+            basePath: cache.cachePath,
+            path: cache.cachePath,
+        },
+    };
+    const commonjsPluginModule = await import('@chialab/esbuild-plugin-commonjs');
+    const commonjsPlugin = commonjsPluginModule.default;
+    stylesheetBundlerOptions.externalDependencies = [];
+    const [compilerPlugin, pluginDisposed] = createAwaitableCompilerPlugin(pluginOptions, stylesheetBundlerOptions);
+    const customPlugins = Array.isArray(options.builderOptions.plugins)
+        ? options.builderOptions.plugins
+        : [];
+    const config = {
+        entryPoints: entryPoints.map(ep => ({
+            in: ep.fileName,
+            out: path.parse(ep.outName).name,
+        })),
+        outdir,
+        entryNames: hash ? '[name]-[hash]' : '[name]',
+        write: extra.write ?? false,
+        external,
+        logLevel: 'warning',
+        bundle: true,
+        sourcemap: sourcemapOptions.scripts,
+        minify: !dev,
+        supported: {
+            'async-await': false,
+            'object-rest-spread': false,
+        },
+        splitting: chunks,
+        platform: platform ?? 'browser',
+        format: 'esm',
+        target: target,
+        logLimit: 0,
+        plugins: [compilerPlugin, commonjsPlugin(), ...customPlugins, ...(extra.extraPlugins ?? [])],
+        define: {
+            ...(dev ? {} : { ngDevMode: 'false' }),
+            ngJitMode: 'false',
+        },
+        ...(builderOptions.loader ? { loader: builderOptions.loader } : {}),
+        resolveExtensions: ['.ts', '.tsx', '.mjs', '.js', '.cjs'],
+    };
+    const ctx = await esbuild.context(config);
+    return { ctx, pluginDisposed };
+}
+async function getTailwindConfig(searchDirectories) {
+    const tailwindConfigurationPath = findTailwindConfiguration(searchDirectories);
+    if (!tailwindConfigurationPath) {
+        return undefined;
+    }
+    return {
+        file: tailwindConfigurationPath,
+        package: createRequire(tailwindConfigurationPath).resolve('tailwindcss'),
+    };
+}

package/src/tools/esbuild/create-awaitable-compiler-plugin.d.ts

@@ -0,0 +1,6 @@
+import type * as esbuild from 'esbuild';
+import { createCompilerPlugin } from '@angular/build/private';
+type CreateCompilerPluginParams = Parameters<typeof createCompilerPlugin>;
+export declare function createAwaitableCompilerPlugin(pluginOptions: CreateCompilerPluginParams[0], styleOptions: CreateCompilerPluginParams[1]): [esbuild.Plugin, Promise<void>];
+export {};
+//# sourceMappingURL=create-awaitable-compiler-plugin.d.ts.map

package/src/tools/esbuild/create-awaitable-compiler-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-awaitable-compiler-plugin.d.ts","sourceRoot":"","sources":["../../../../src/tools/esbuild/create-awaitable-compiler-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,OAAO,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,KAAK,0BAA0B,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAE1E,wBAAgB,6BAA6B,CAC3C,aAAa,EAAE,0BAA0B,CAAC,CAAC,CAAC,EAC5C,YAAY,EAAE,0BAA0B,CAAC,CAAC,CAAC,GAC1C,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CA+BjC"}

package/src/tools/esbuild/create-awaitable-compiler-plugin.js

@@ -0,0 +1,29 @@
+import { createCompilerPlugin } from '@angular/build/private';
+export function createAwaitableCompilerPlugin(pluginOptions, styleOptions) {
+    const originalPlugin = createCompilerPlugin(pluginOptions, styleOptions);
+    let resolveDispose;
+    const onDisposePromise = new Promise(resolve => {
+        resolveDispose = resolve;
+    });
+    const wrappedPlugin = {
+        ...originalPlugin,
+        setup(build) {
+            // Wrap the build object to intercept onDispose
+            const wrappedBuild = new Proxy(build, {
+                get(target, prop) {
+                    if (prop === 'onDispose') {
+                        return (callback) => {
+                            return target.onDispose(() => {
+                                callback();
+                                resolveDispose();
+                            });
+                        };
+                    }
+                    return target[prop];
+                },
+            });
+            return originalPlugin.setup(wrappedBuild);
+        },
+    };
+    return [wrappedPlugin, onDisposePromise];
+}

package/src/tools/esbuild/create-federation-tsconfig.d.ts

@@ -0,0 +1,7 @@
+import type { EntryPoint } from '@softarc/native-federation';
+/**
+ * Updates the federation tsconfig to include optimized mapping entry points.
+ * Only modifies the file when there are non-local entry points to add.
+ */
+export declare function updateFederationTsConfig(workspaceRoot: string, tsConfigPath: string, entryPoints: EntryPoint[]): void;
+//# sourceMappingURL=create-federation-tsconfig.d.ts.map

package/src/tools/esbuild/create-federation-tsconfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-federation-tsconfig.d.ts","sourceRoot":"","sources":["../../../../src/tools/esbuild/create-federation-tsconfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAM7D;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,UAAU,EAAE,GACxB,IAAI,CA8BN"}

package/src/tools/esbuild/create-federation-tsconfig.js

@@ -0,0 +1,46 @@
+import path from 'path';
+import fs from 'fs';
+import JSON5 from 'json5';
+import { isDeepStrictEqual } from 'util';
+/**
+ * Updates the federation tsconfig to include optimized mapping entry points.
+ * Only modifies the file when there are non-local entry points to add.
+ */
+export function updateFederationTsConfig(workspaceRoot, tsConfigPath, entryPoints) {
+    const fullTsConfigPath = path.join(workspaceRoot, tsConfigPath);
+    const tsconfigDir = path.dirname(fullTsConfigPath);
+    const filtered = entryPoints
+        .filter(ep => !ep.fileName.startsWith('.'))
+        .map(ep => path.relative(tsconfigDir, ep.fileName).replace(/\\\\/g, '/'));
+    if (filtered.length === 0) {
+        return;
+    }
+    const tsconfigAsString = fs.readFileSync(fullTsConfigPath, 'utf-8');
+    const tsconfig = JSON5.parse(tsconfigAsString);
+    if (!tsconfig.include) {
+        tsconfig.include = [];
+    }
+    for (const ep of filtered) {
+        if (!tsconfig.include.includes(ep)) {
+            tsconfig.include.push(ep);
+        }
+    }
+    const content = JSON5.stringify(tsconfig, null, 2);
+    if (!doesFileExistAndJsonEqual(fullTsConfigPath, content)) {
+        fs.writeFileSync(fullTsConfigPath, JSON.stringify(tsconfig, null, 2));
+    }
+}
+function doesFileExistAndJsonEqual(filePath, content) {
+    if (!fs.existsSync(filePath)) {
+        return false;
+    }
+    try {
+        const currentContent = fs.readFileSync(filePath, 'utf-8');
+        const currentJson = JSON5.parse(currentContent);
+        const newJson = JSON5.parse(content);
+        return isDeepStrictEqual(currentJson, newJson);
+    }
+    catch {
+        return false;
+    }
+}

package/src/tools/esbuild/shared-mappings-plugin.d.ts

@@ -0,0 +1,4 @@
+import type { Plugin } from 'esbuild';
+import type { PathToImport } from '@softarc/native-federation/internal';
+export declare function createSharedMappingsPlugin(mappedPaths: PathToImport): Plugin;
+//# sourceMappingURL=shared-mappings-plugin.d.ts.map

package/src/tools/esbuild/shared-mappings-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-mappings-plugin.d.ts","sourceRoot":"","sources":["../../../../src/tools/esbuild/shared-mappings-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAe,MAAM,SAAS,CAAC;AAEnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAOxE,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,YAAY,GAAG,MAAM,CA8B5E"}

package/src/tools/esbuild/shared-mappings-plugin.js

@@ -0,0 +1,33 @@
+import * as path from 'path';
+// TODO: `createSharedMappingsPlugin` currently has no callers. Before deleting,
+// verify its responsibility (rewriting relative imports of shared/exposed paths
+// to externals) isn't already handled elsewhere — e.g. the federation adapter's
+// `external` list / mapped-paths handling in `angular-bundler.ts`. If covered,
+// remove this file and its spec; otherwise wire it back into the esbuild config.
+export function createSharedMappingsPlugin(mappedPaths) {
+    return {
+        name: 'custom',
+        setup(build) {
+            build.onResolve({ filter: /^[.]/ }, async (args) => {
+                let mappedPath = undefined;
+                let isSelf = false;
+                if (args.kind === 'import-statement') {
+                    const importPath = path.join(args.resolveDir, args.path);
+                    if (mappedPaths) {
+                        mappedPath = Object.keys(mappedPaths).find(p => importPath.startsWith(path.dirname(p)));
+                    }
+                }
+                if (mappedPath) {
+                    isSelf = args.importer.startsWith(path.dirname(mappedPath));
+                }
+                if (mappedPath && !isSelf) {
+                    return {
+                        path: mappedPaths[mappedPath],
+                        external: true,
+                    };
+                }
+                return {};
+            });
+        },
+    };
+}

package/src/tools/mf/build-for-federation.d.ts

@@ -0,0 +1,70 @@
+import type { ApplicationBuilderOptions } from '@angular/build';
+import type { BuilderContext } from '@angular-devkit/architect';
+import type { SourceFileCache } from '@angular/build/private';
+import type { FederationCache } from '@softarc/native-federation';
+import type { FederationSharedInput } from './to-plugin-config.js';
+import type { NfInternalOptions } from '../../builders/build/schema.js';
+/**
+ * Minimal normalized-config shape this driver reads. NF's
+ * `NormalizedFederationConfig` satisfies it structurally (transitional — Phase 3
+ * replaces the config loader with `withModuleFederation`).
+ */
+export interface NormalizedConfig {
+    name: string;
+    filename?: string;
+    exposes?: Record<string, {
+        file: string;
+    }>;
+    shared?: Record<string, FederationSharedInput>;
+    sharedMappings?: Record<string, string>;
+    remotes?: Record<string, string>;
+    chunks?: boolean;
+    /** NF puts `features` on the config; `optimizedMappings` reads `ignoreUnusedDeps`. */
+    features?: {
+        ignoreUnusedDeps?: boolean;
+    };
+}
+/** Federation options the builder already computed (subset NF's `fedOptions` provides). */
+export interface FederationOptions {
+    outputPath: string;
+    /** Optional to match NF's `fedOptions.tsConfig`; `createAngularEsbuildContext` guards undefined at runtime. */
+    tsConfig?: string;
+    dev?: boolean;
+    watch?: boolean;
+    federationCache: FederationCache<SourceFileCache>;
+}
+/** MF-shaped build result (replaces NF's `FederationInfo`); consumed by i18n (M4.2). */
+export interface MfFederationInfo {
+    name: string;
+    exposes: string[];
+    writtenFiles: string[];
+}
+/** Build context for the MF side build. */
+export interface BuilderCtx {
+    builderOptions: ApplicationBuilderOptions & NfInternalOptions;
+    context: BuilderContext;
+}
+/**
+ * Stateful MF side builder (M2.1) — the `buildForFederation` + `rebuildForFederation`
+ * replacement. Holds one esbuild `BuildContext` (Angular compiler +
+ * `moduleFederationPlugin`, one-pass) across rebuilds so `ng serve` incremental
+ * DX (M2.6) is preserved — mirroring NF's adapter lifecycle (setup → build →
+ * rebuild* → dispose). NF's four shared-bundling phases are gone (MF owns shared,
+ * finding #6); the plugin emits `remoteEntry.js` + `mf-manifest.json`.
+ *
+ * Field values mirror NF's `bundleExposedAndMappings` exactly, so it is
+ * correct-by-construction against the existing context machinery.
+ *
+ * ⚠️ Type-checked, not yet runtime-verified: emitting against a real Angular app
+ * needs a browser/Angular env absent here (same limit as the M1.7 e2e).
+ */
+export interface MfFederationBuilder {
+    /** Initial build: bundle exposed modules + emit container/manifest. */
+    build(): Promise<MfFederationInfo>;
+    /** Incremental rebuild for `ng serve` (invalidates the changed files first). */
+    rebuild(modifiedFiles?: string[]): Promise<MfFederationInfo>;
+    /** Tear down the esbuild context (call once when the build/watch ends). */
+    dispose(): Promise<void>;
+}
+export declare function createMfFederationBuilder(config: NormalizedConfig, fedOptions: FederationOptions, externals: string[], ctx: BuilderCtx): Promise<MfFederationBuilder>;
+//# sourceMappingURL=build-for-federation.d.ts.map

package/src/tools/mf/build-for-federation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-for-federation.d.ts","sourceRoot":"","sources":["../../../../src/tools/mf/build-for-federation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAQlE,OAAO,KAAK,EAEV,qBAAqB,EACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAExE;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IAC/C,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,sFAAsF;IACtF,QAAQ,CAAC,EAAE;QAAE,gBAAgB,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAC3C;AAED,2FAA2F;AAC3F,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,+GAA+G;IAC/G,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,eAAe,EAAE,eAAe,CAAC,eAAe,CAAC,CAAC;CACnD;AAED,wFAAwF;AACxF,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AA4BD,2CAA2C;AAC3C,MAAM,WAAW,UAAU;IACzB,cAAc,EAAE,yBAAyB,GAAG,iBAAiB,CAAC;IAC9D,OAAO,EAAE,cAAc,CAAC;CACzB;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,mBAAmB;IAClC,uEAAuE;IACvE,KAAK,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACnC,gFAAgF;IAChF,OAAO,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC7D,2EAA2E;IAC3E,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,gBAAgB,EACxB,UAAU,EAAE,iBAAiB,EAC7B,SAAS,EAAE,MAAM,EAAE,EACnB,GAAG,EAAE,UAAU,GACd,OAAO,CAAC,mBAAmB,CAAC,CAuD9B"}