feat(@schematics/angular): add option to setup new workspace or application as zoneless mode

Introduces option `--experimental-zoneless` to setup workspace or application as zoneless mode.

Author: aparzi

packages/schematics/angular/application/files/module-files/src/main.ts.template

@@ -1,10 +1,16 @@
-<% if(!!viewEncapsulation) { %>import { ViewEncapsulation } from '@angular/core';
-<% }%>import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
-
+import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
 import { AppModule } from './app/app.module';
 
-platformBrowserDynamic().bootstrapModule(AppModule, {
-  ngZoneEventCoalescing: true<% if(!!viewEncapsulation) { %>,
-  defaultEncapsulation: ViewEncapsulation.<%= viewEncapsulation %><% } %>
-})
+const bootstrapOptions = {
+    <% if(!experimentalZoneless) { %>ngZoneEventCoalescing: true<% } else { %>
+    const { provideExperimentalZonelessChangeDetection } = await import('@angular/core');
+    providers: [provideExperimentalZonelessChangeDetection()];
+    <% } %>
+    <% if(!!viewEncapsulation) { %>
+      const { ViewEncapsulation } = await import('@angular/core');
+      defaultEncapsulation: ViewEncapsulation.<%= viewEncapsulation %>;
+    <% } %>
+};
+
+platformBrowserDynamic().bootstrapModule(AppModule, bootstrapOptions)
   .catch(err => console.error(err));

packages/schematics/angular/application/files/standalone-files/src/app/app.config.ts.template

@@ -1,8 +1,10 @@
-import { ApplicationConfig, provideZoneChangeDetection } from '@angular/core';<% if (routing) { %>
+import { ApplicationConfig, <% if(!experimentalZoneless) { %>provideZoneChangeDetection<% } else { %>provideExperimentalZonelessChangeDetection<% } %> } from '@angular/core';<% if (routing) { %>
 import { provideRouter } from '@angular/router';
 
 import { routes } from './app.routes';<% } %>
 
 export const appConfig: ApplicationConfig = {
-  providers: [provideZoneChangeDetection({ eventCoalescing: true })<% if (routing) { %>, provideRouter(routes)<% } %>]
+  providers: [
+  <% if(experimentalZoneless) { %>provideExperimentalZonelessChangeDetection()<% } else { %>provideZoneChangeDetection({ eventCoalescing: true })<% } %><% if (routing) {%>, provideRouter(routes)<% } %>
+  ]
 };

packages/schematics/angular/application/index.ts

@@ -239,7 +239,7 @@ function addAppToWorkspaceFile(
           outputPath: `dist/${folderName}`,
           index: `${sourceRoot}/index.html`,
           browser: `${sourceRoot}/main.ts`,
-          polyfills: ['zone.js'],
+          polyfills: options.experimentalZoneless ? [] : ['zone.js'],
           tsConfig: `${projectRoot}tsconfig.app.json`,
           inlineStyleLanguage,
           assets: [{ 'glob': '**/*', 'input': `${projectRoot}public` }],
@@ -279,7 +279,7 @@ function addAppToWorkspaceFile(
         : {
             builder: Builders.Karma,
             options: {
-              polyfills: ['zone.js', 'zone.js/testing'],
+              polyfills: options.experimentalZoneless ? [] : ['zone.js', 'zone.js/testing'],
               tsConfig: `${projectRoot}tsconfig.spec.json`,
               inlineStyleLanguage,
               assets: [{ 'glob': '**/*', 'input': `${projectRoot}public` }],

packages/schematics/angular/application/index_spec.ts

@@ -619,7 +619,7 @@ describe('Application Schematic', () => {
       const path = '/projects/foo/src/main.ts';
       const content = tree.readContent(path);
       expect(content).toContain('defaultEncapsulation: ViewEncapsulation.ShadowDom');
-      expect(content).toContain(`import { ViewEncapsulation } from '@angular/core'`);
+      expect(content).toContain(`const { ViewEncapsulation } = await import('@angular/core');`);
     });
 
     it('should handle the routing flag', async () => {
@@ -698,5 +698,48 @@ describe('Application Schematic', () => {
         }),
       );
     });
+
+    it('should add provideExperimentalZonelessChangeDetection() when experimentalZoneless is true', async () => {
+      const tree = await schematicRunner.runSchematic(
+        'application',
+        {
+          ...defaultOptions,
+          experimentalZoneless: true,
+        },
+        workspaceTree,
+      );
+      const path = '/projects/foo/src/app/app.config.ts';
+      console.log('tree => ', tree);
+      const fileContent = tree.readContent(path);
+      expect(fileContent).toContain('provideExperimentalZonelessChangeDetection()');
+    });
+
+    it('should not add provideExperimentalZonelessChangeDetection() when experimentalZoneless is false', async () => {
+      const tree = await schematicRunner.runSchematic(
+        'application',
+        {
+          ...defaultOptions,
+          experimentalZoneless: false,
+        },
+        workspaceTree,
+      );
+      const path = '/projects/foo/src/app/app.config.ts';
+      const fileContent = tree.readContent(path);
+      expect(fileContent).not.toContain('provideExperimentalZonelessChangeDetection()');
+    });
+
+    it('should not add provideZoneChangeDetection when experimentalZoneless is true', async () => {
+      const tree = await schematicRunner.runSchematic(
+        'application',
+        {
+          ...defaultOptions,
+          experimentalZoneless: true,
+        },
+        workspaceTree,
+      );
+      const path = '/projects/foo/src/app/app.config.ts';
+      const fileContent = tree.readContent(path);
+      expect(fileContent).not.toContain('provideZoneChangeDetection');
+    });
   });
 });

packages/schematics/angular/application/schema.json

@@ -117,6 +117,11 @@
       "type": "boolean",
       "default": false,
       "x-user-analytics": "ep.ng_ssr"
+    },
+    "experimentalZoneless": {
+      "description": "Create an application that does not utilize zone.js.",
+      "type": "boolean",
+      "default": false
     }
   },
   "required": ["name"]

packages/schematics/angular/ng-new/index.ts

@@ -57,6 +57,7 @@ export default function (options: NgNewOptions): Rule {
     minimal: options.minimal,
     standalone: options.standalone,
     ssr: options.ssr,
+    experimentalZoneless: options.experimentalZoneless,
   };
 
   return chain([

packages/schematics/angular/ng-new/schema.json

@@ -138,6 +138,11 @@
       "description": "Creates an application with Server-Side Rendering (SSR) and Static Site Generation (SSG/Prerendering) enabled.",
       "type": "boolean",
       "x-user-analytics": "ep.ng_ssr"
+    },
+    "experimentalZoneless": {
+      "description": "Create an application that does not utilize zone.js.",
+      "type": "boolean",
+      "default": false
     }
   },
   "required": ["name", "version"]

packages/schematics/angular/service-worker/index_spec.ts

@@ -131,7 +131,7 @@ describe('Service Worker Schematic', () => {
         provideServiceWorker('ngsw-worker.js', {
           enabled: !isDevMode(),
           registrationStrategy: 'registerWhenStable:30000'
-        })  
+        })
     `);
   });
 

tests/legacy-cli/e2e/tests/generate/application/application-zoneless.ts

@@ -0,0 +1,9 @@
+import { ng } from '../../../utils/process';
+import { useCIChrome } from '../../../utils/project';
+
+export default async function () {
+  await ng('generate', 'application', 'app2', '--experimental-zoneless');
+  await useCIChrome('app2', 'projects/app2');
+  await ng('test', 'app2', '--watch=false');
+  await ng('build', 'app2');
+}