feat(@angular-devkit/build-angular): support standalone apps route discovery during prerendering

This fixes an issue were routes could not be discovered automatically in a standalone application.

This is a total overhaul of the route extraction process as instead of using `guess-parser` NPM package, we now use the Angular Router. This enables a number of exciting possibilities for the future which were not possible before.

# How it works?
The application is bootstrapped and through DI injection we get the injector and router config instance and recursively build the routes tree.

Author: alan-agius4

package.json

@@ -145,7 +145,6 @@
     "eslint-plugin-import": "2.28.1",
     "express": "4.18.2",
     "fast-glob": "3.3.1",
-    "guess-parser": "0.4.22",
     "http-proxy": "^1.18.1",
     "http-proxy-middleware": "2.0.6",
     "https-proxy-agent": "7.0.2",

packages/angular/ssr/schematics/ng-add/files/server-builder/server.ts.template

@@ -64,4 +64,4 @@ if (moduleFilename === __filename || moduleFilename.includes('iisnode')) {
   run();
 }
 
-<% if (isStandalone) { %>export default bootstrap;<% } else { %>export * from './src/main.server';<% } %>
+export default <% if (isStandalone) { %>bootstrap<% } else { %>AppServerModule<% } %>;

packages/angular/ssr/schematics/ng-add/index_spec.ts

@@ -194,7 +194,7 @@ describe('SSR Schematic', () => {
       const tree = await schematicRunner.runSchematic('ng-add', defaultOptions, appTree);
 
       const content = tree.readContent('/projects/test-app/server.ts');
-      expect(content).toContain(`export * from './src/main.server'`);
+      expect(content).toContain(`export default AppServerModule`);
     });
 
     it(`should add correct value to 'distFolder'`, async () => {

packages/angular/ssr/src/common-engine.ts

@@ -162,7 +162,7 @@ async function exists(path: fs.PathLike): Promise<boolean> {
 }
 
 function isBootstrapFn(value: unknown): value is () => Promise<ApplicationRef> {
-  // We can differentiate between a module and a bootstrap function by reading `cmp`:
+  // We can differentiate between a module and a bootstrap function by reading compiler-generated `ɵmod` static property:
   return typeof value === 'function' && !('ɵmod' in value);
 }
 

packages/angular_devkit/build_angular/BUILD.bazel

@@ -122,6 +122,7 @@ ts_library(
     module_root = "src/index.d.ts",
     deps = [
         "//packages/angular_devkit/architect",
+        "//packages/angular_devkit/build_angular/src/utils/routes-extractor",
         "//packages/angular_devkit/build_webpack",
         "//packages/angular_devkit/core",
         "//packages/angular_devkit/core/node",
@@ -168,7 +169,6 @@ ts_library(
         "@npm//esbuild",
         "@npm//esbuild-wasm",
         "@npm//fast-glob",
-        "@npm//guess-parser",
         "@npm//http-proxy-middleware",
         "@npm//https-proxy-agent",
         "@npm//inquirer",

packages/angular_devkit/build_angular/package.json

@@ -34,7 +34,6 @@
     "css-loader": "6.8.1",
     "esbuild-wasm": "0.19.3",
     "fast-glob": "3.3.1",
-    "guess-parser": "0.4.22",
     "https-proxy-agent": "7.0.2",
     "http-proxy-middleware": "2.0.6",
     "inquirer": "8.2.6",

packages/angular_devkit/build_angular/src/builders/app-shell/render-worker.ts

@@ -102,7 +102,7 @@ async function render({ serverBundlePath, document, url }: RenderRequest): Promi
 }
 
 function isBootstrapFn(value: unknown): value is () => Promise<ApplicationRef> {
-  // We can differentiate between a module and a bootstrap function by reading `cmp`:
+  // We can differentiate between a module and a bootstrap function by reading compiler-generated `ɵmod` static property:
   return typeof value === 'function' && !('ɵmod' in value);
 }
 

packages/angular_devkit/build_angular/src/builders/application/execute-build.ts

@@ -53,6 +53,7 @@ export async function executeBuild(
     prerenderOptions,
     appShellOptions,
     ssrOptions,
+    verbose,
   } = options;
 
   const browsers = getSupportedBrowsers(projectRoot, context.logger);
@@ -182,13 +183,13 @@ export async function executeBuild(
 
     const { output, warnings, errors } = await prerenderPages(
       workspaceRoot,
-      options.tsconfig,
       appShellOptions,
       prerenderOptions,
       executionResult.outputFiles,
       indexContentOutputNoCssInlining,
       optimizationOptions.styles.inlineCritical,
       maxWorkers,
+      verbose,
     );
 
     printWarningsAndErrorsToConsole(context, warnings, errors);
@@ -242,6 +243,7 @@ export async function executeBuild(
   if (optimizationOptions.scripts || optimizationOptions.styles.minify) {
     estimatedTransferSizes = await calculateEstimatedTransferSizes(executionResult.outputFiles);
   }
+
   logBuildStats(context, metafile, initialFiles, estimatedTransferSizes);
 
   const buildTime = Number(process.hrtime.bigint() - startTime) / 10 ** 9;

packages/angular_devkit/build_angular/src/builders/application/options.ts

@@ -181,15 +181,11 @@ export async function normalizeOptions(
 
   let prerenderOptions;
   if (options.prerender) {
-    const {
-      discoverRoutes = true,
-      routes = [],
-      routesFile = undefined,
-    } = options.prerender === true ? {} : options.prerender;
+    const { discoverRoutes = true, routesFile = undefined } =
+      options.prerender === true ? {} : options.prerender;
 
     prerenderOptions = {
       discoverRoutes,
-      routes,
       routesFile: routesFile && path.join(workspaceRoot, routesFile),
     };
   }

packages/angular_devkit/build_angular/src/builders/application/schema.json

@@ -423,19 +423,9 @@
               "type": "string",
               "description": "The path to a file containing routes separated by newlines."
             },
-            "routes": {
-              "type": "array",
-              "description": "The routes to render.",
-              "items": {
-                "minItems": 1,
-                "type": "string",
-                "uniqueItems": true
-              },
-              "default": []
-            },
             "discoverRoutes": {
               "type": "boolean",
-              "description": "Whether the builder should statically discover routes.",
+              "description": "Whether the builder should discover routers using the Angular Router.",
               "default": true
             }
           },