docs: add readme

Author: manfredsteyer

libs/native-federation/README.md

@@ -23,6 +23,7 @@ We will at least provide a new version of this package per Angular major. If nec
 - Use version 16.1.x for Angular 16.1.x
 - Use version 16.2.x for Angular 16.2.x
 - Use version 17.x for Angular 17.x
+- Use version 17.1.x-rc.x for Angular 17.1
 
 ## Credits
 

libs/native-federation/migrate-appbuilder.md

@@ -1,3 +1,15 @@
+# Migrating to Native Federation 17.1
+
+Beginning with version 17.1, Native Federation uses the CLI's Application Builder and Dev Server to keep track with the innovations and performance improvements the CLI team works on.
+
+This requires some changes in the `angular.json`. If you go with a default configuration for Native Federation, the following command takes care of them:
+
+```
+ng g @angular-architects/native-federation:appbuilder
+```
+
+For more advanced cases, please find a diff of the changes needed for this version:
+
 ```diff
  {
         "$schema": "./node_modules/@angular/cli/lib/config/schema.json",

libs/native-federation/src/builders/build/builder.ts

@@ -69,18 +69,13 @@ export async function* runBuilder(
     logger.info('Application-Builder and its Dev-Server.');
     logger.info('Please update your project config, e.g. in angular.json');
     logger.info('');
-    logger.info(
-      'This command performs the needed update for default configs:'
-    );
+    logger.info('This command performs the needed update for default configs:');
     logger.info('');
     logger.info('\tng g @angular-architects/native-federation:appbuilder');
     logger.info('');
     logger.info('You need to run it once per application to migrate');
-    logger.info(
-      'Please find more information here: https://shorturl.at/gADJW'
-    );
+    logger.info('Please find more information here: https://shorturl.at/gADJW');
     return;
-
   }
 
   let options = (await context.validateOptions(

libs/native-federation/src/utils/angular-esbuild-adapter.ts

@@ -203,9 +203,9 @@ async function runEsbuild(
 
   const tailwindConfiguration = tailwindConfigurationPath
     ? {
-      file: tailwindConfigurationPath,
-      package: resolver.resolve('tailwindcss'),
-    }
+        file: tailwindConfigurationPath,
+        package: resolver.resolve('tailwindcss'),
+      }
     : undefined;
 
   const outputNames = {
@@ -222,7 +222,11 @@ async function runEsbuild(
     }
   }
 
-  tsConfigPath = createTsConfigForFederation(workspaceRoot, tsConfigPath, entryPoints);
+  tsConfigPath = createTsConfigForFederation(
+    workspaceRoot,
+    tsConfigPath,
+    entryPoints
+  );
 
   const pluginOptions = createCompilerPluginOptions(
     {
@@ -335,20 +339,28 @@ function cleanUpTsConfigForFederation(tsConfigPath: string) {
   }
 }
 
-function createTsConfigForFederation(workspaceRoot: string, tsConfigPath: string, entryPoints: EntryPoint[]) {
+function createTsConfigForFederation(
+  workspaceRoot: string,
+  tsConfigPath: string,
+  entryPoints: EntryPoint[]
+) {
   const fullTsConfigPath = path.join(workspaceRoot, tsConfigPath);
   const tsconfigDir = path.dirname(fullTsConfigPath);
 
-  const filtered = entryPoints.filter(ep => !ep.fileName.includes('/node_modules/') && !ep.fileName.startsWith('.')).map(ep => path.relative(tsconfigDir, ep.fileName).replace(/\\\\/g, '/'));
+  const filtered = entryPoints
+    .filter(
+      (ep) =>
+        !ep.fileName.includes('/node_modules/') && !ep.fileName.startsWith('.')
+    )
+    .map((ep) => path.relative(tsconfigDir, ep.fileName).replace(/\\\\/g, '/'));
 
   const tsconfigAsString = fs.readFileSync(fullTsConfigPath, 'utf-8');
   const tsconfigWithoutComments = tsconfigAsString.replace(
-      /\/\*.+?\*\/|\/\/.*(?=[\n\r])/g,
-      ''
+    /\/\*.+?\*\/|\/\/.*(?=[\n\r])/g,
+    ''
   );
   const tsconfig = JSON.parse(tsconfigWithoutComments);
 
-
   if (!tsconfig.include) {
     tsconfig.include = [];
   }