feat(@angular-devkit/build-angular): provide option to allow automati…

…cally cleaning the terminal screen during rebuilds

When setting `"clearScreen": true` to the appliction builder during rebuilds the terminimal screen will be cleaned.

```json
{
  "projects": {
    "my-app": {
      "projectType": "application",
      "root": "",
      "sourceRoot": "src",
      "architect": {
        "build": {
          "builder": "@angular-devkit/build-angular:application",
          "options": {
            "clearScreen": true
          }
        }
      }
    }
  }
}
```

Closes #25699

goldens/public-api/angular_devkit/build_angular/index.md

@@ -30,6 +30,7 @@ export interface ApplicationBuilderOptions {
     baseHref?: string;
     browser: string;
     budgets?: Budget_2[];
+    clearScreen?: boolean;
     crossOrigin?: CrossOrigin_2;
     deleteOutputPath?: boolean;
     externalDependencies?: string[];

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

@@ -19,6 +19,20 @@ import { shouldWatchRoot } from '../../utils/environment-options';
 import { NormalizedCachedOptions } from '../../utils/normalize-cache';
 import { NormalizedOutputOptions } from './options';
 
+// Watch workspace for package manager changes
+const packageWatchFiles = [
+  // manifest can affect module resolution
+  'package.json',
+  // npm lock file
+  'package-lock.json',
+  // pnpm lock file
+  'pnpm-lock.yaml',
+  // yarn lock file including Yarn PnP manifest files (https://yarnpkg.com/advanced/pnp-spec/)
+  'yarn.lock',
+  '.pnp.cjs',
+  '.pnp.data.json',
+];
+
 export async function* runEsBuildBuildAction(
   action: (rebuildState?: RebuildState) => ExecutionResult | Promise<ExecutionResult>,
   options: {
@@ -36,13 +50,15 @@ export async function* runEsBuildBuildAction(
     poll?: number;
     signal?: AbortSignal;
     preserveSymlinks?: boolean;
+    clearScreen?: boolean;
   },
 ): AsyncIterable<(ExecutionResult['outputWithFiles'] | ExecutionResult['output']) & BuilderOutput> {
   const {
     writeToFileSystemFilter,
     writeToFileSystem,
     watch,
     poll,
+    clearScreen,
     logger,
     deleteOutputPath,
     cacheOptions,
@@ -113,20 +129,6 @@ export async function* runEsBuildBuildAction(
       watcher.add(projectRoot);
     }
 
-    // Watch workspace for package manager changes
-    const packageWatchFiles = [
-      // manifest can affect module resolution
-      'package.json',
-      // npm lock file
-      'package-lock.json',
-      // pnpm lock file
-      'pnpm-lock.yaml',
-      // yarn lock file including Yarn PnP manifest files (https://yarnpkg.com/advanced/pnp-spec/)
-      'yarn.lock',
-      '.pnp.cjs',
-      '.pnp.data.json',
-    ];
-
     watcher.add(
       packageWatchFiles
         .map((file) => path.join(workspaceRoot, file))
@@ -164,6 +166,11 @@ export async function* runEsBuildBuildAction(
         break;
       }
 
+      if (clearScreen) {
+        // eslint-disable-next-line no-console
+        console.clear();
+      }
+
       if (verbose) {
         logger.info(changes.toDebugString());
       }

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

@@ -126,6 +126,7 @@ export async function* buildApplicationInternal(
       projectRoot: normalizedOptions.projectRoot,
       workspaceRoot: normalizedOptions.workspaceRoot,
       progress: normalizedOptions.progress,
+      clearScreen: normalizedOptions.clearScreen,
       writeToFileSystem,
       // For app-shell and SSG server files are not required by users.
       // Omit these when SSR is not enabled.

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

@@ -294,6 +294,7 @@ export async function normalizeOptions(
     namedChunks,
     budgets,
     deployUrl,
+    clearScreen,
   } = options;
 
   // Return all the normalized options
@@ -348,6 +349,7 @@ export async function normalizeOptions(
     loaderExtensions,
     jsonLogs: useJSONBuildLogs,
     colors: colors.enabled,
+    clearScreen,
   };
 }
 

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

@@ -133,6 +133,11 @@
       },
       "default": []
     },
+    "clearScreen": {
+      "type": "boolean",
+      "default": false,
+      "description": "Automatically clear the terminal screen during rebuilds."
+    },
     "optimization": {
       "description": "Enables optimization of the build output. Including minification of scripts and styles, tree-shaking, dead-code elimination, inlining of critical CSS and fonts inlining. For more information, see https://angular.io/guide/workspace-config#optimization-configuration.",
       "default": true,