refactor(compiler-cli): Add experimental local compilation mode. (#49846)

pmvald · dylhunn · commit 345dd6d81acc · 2023-04-23T18:19:35.000-07:00
In this mode the compiler generates code based on each individual source file without using its dependencies. This mode is suitable only for fast edit/refresh during development. PR Close #49846
diff --git a/goldens/public-api/compiler-cli/compiler_options.md b/goldens/public-api/compiler-cli/compiler_options.md
@@ -73,7 +73,7 @@ export interface StrictTemplateOptions {
 
 // @public
 export interface TargetOptions {
-    compilationMode?: 'full' | 'partial';
+    compilationMode?: 'full' | 'partial' | 'experimental-local';
 }
 
 // (No @packageDocumentation comment for this package)
diff --git a/packages/compiler-cli/src/ngtsc/core/api/src/public_options.ts b/packages/compiler-cli/src/ngtsc/core/api/src/public_options.ts
@@ -383,10 +383,13 @@ export interface TargetOptions {
    * Specifies the compilation mode to use. The following modes are available:
    * - 'full': generates fully AOT compiled code using Ivy instructions.
    * - 'partial': generates code in a stable, but intermediate form suitable for publication to NPM.
+   * - 'experimental-local': generates code based on each individual source file without using its
+   * dependencies. This mode is suitable only for fast edit/refresh during development. It will be
+   * eventually replaced by the value `local` once the feature is ready to be public.
    *
    * The default value is 'full'.
    */
-  compilationMode?: 'full'|'partial';
+  compilationMode?: 'full'|'partial'|'experimental-local';
 }
 
 /**
diff --git a/packages/compiler-cli/src/ngtsc/core/src/compiler.ts b/packages/compiler-cli/src/ngtsc/core/src/compiler.ts
@@ -1006,9 +1006,20 @@ export class NgCompiler {
     // Note: If this compilation builds `@angular/core`, we always build in full compilation
     // mode. Code inside the core package is always compatible with itself, so it does not
     // make sense to go through the indirection of partial compilation
-    const compilationMode = this.options.compilationMode === 'partial' && !isCore ?
-        CompilationMode.PARTIAL :
-        CompilationMode.FULL;
+    let compilationMode: CompilationMode = CompilationMode.FULL;
+    if (!isCore) {
+      switch (this.options.compilationMode) {
+        case 'full':
+          compilationMode = CompilationMode.FULL;
+          break;
+        case 'partial':
+          compilationMode = CompilationMode.PARTIAL;
+          break;
+        case 'experimental-local':
+          compilationMode = CompilationMode.LOCAL;
+          break;
+      }
+    }
 
     // Cycles are handled in full compilation mode by "remote scoping".
     // "Remote scoping" does not work well with tree shaking for libraries.
diff --git a/packages/compiler-cli/src/ngtsc/transform/src/api.ts b/packages/compiler-cli/src/ngtsc/transform/src/api.ts
@@ -31,6 +31,12 @@ export enum CompilationMode {
    * Generates code using a stable, but intermediate format suitable to be published to NPM.
    */
   PARTIAL,
+
+  /**
+   * Generates code based on each individual source file without using its
+   * dependencies (suitable for local dev edit/refresh workflow).
+   */
+  LOCAL,
 }
 
 export enum HandlerPrecedence {

Original file line number	Diff line number	Diff line change
`@@ -73,7 +73,7 @@ export interface StrictTemplateOptions {`
`73`	`73`
`74`	`74`	`// @public`
`75`	`75`	`export interface TargetOptions {`
`76`		`- compilationMode?: 'full' \| 'partial';`
	`76`	`+ compilationMode?: 'full' \| 'partial' \| 'experimental-local';`
`77`	`77`	`}`
`78`	`78`
`79`	`79`	`// (No @packageDocumentation comment for this package)`
Original file line number	Diff line number	Diff line change
`@@ -383,10 +383,13 @@ export interface TargetOptions {`
`383`	`383`	`* Specifies the compilation mode to use. The following modes are available:`
`384`	`384`	`* - 'full': generates fully AOT compiled code using Ivy instructions.`
`385`	`385`	`* - 'partial': generates code in a stable, but intermediate form suitable for publication to NPM.`
	`386`	`+ * - 'experimental-local': generates code based on each individual source file without using its`
	`387`	`+ * dependencies. This mode is suitable only for fast edit/refresh during development. It will be`
	`388`	+ * eventually replaced by the value `local` once the feature is ready to be public.
`386`	`389`	`*`
`387`	`390`	`* The default value is 'full'.`
`388`	`391`	`*/`
`389`		`- compilationMode?: 'full'\|'partial';`
	`392`	`+ compilationMode?: 'full'\|'partial'\|'experimental-local';`
`390`	`393`	`}`
`391`	`394`
`392`	`395`	`/**`