refactor(compiler-cli): add an internal config to enforce explicit deps in @defer for local compilation mode (#53591)

AndrewKushnir · atscott · commit 9cae9b4a8cee · 2024-01-10T15:28:59.000-08:00
This commit adds an internal config option to enforce explicit deps in `@defer` for local compilation mode. PR Close #53591
diff --git a/goldens/public-api/compiler-cli/compiler_options.md b/goldens/public-api/compiler-cli/compiler_options.md
@@ -8,6 +8,7 @@
 export interface BazelAndG3Options {
     annotateForClosureCompiler?: boolean;
     generateDeepReexports?: boolean;
+    onlyExplicitDeferDependencyImports?: boolean;
     onlyPublishPublicTypingsForNgModules?: boolean;
 }
 
diff --git a/packages/bazel/src/ngc-wrapped/index.ts b/packages/bazel/src/ngc-wrapped/index.ts
@@ -87,6 +87,7 @@ export async function runOneBuild(
     'createExternalSymbolFactoryReexports',
     'extendedDiagnostics',
     'forbidOrphanComponents',
+    'onlyExplicitDeferDependencyImports',
   ]);
 
   const userOverrides = Object.entries(userOptions)
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
@@ -317,6 +317,17 @@ export interface BazelAndG3Options {
    * Insert JSDoc type annotations needed by Closure Compiler
    */
   annotateForClosureCompiler?: boolean;
+
+  /**
+   * Specifies whether Angular compiler should rely on explicit imports
+   * via `@Component.deferredImports` field for `@defer` blocks and generate
+   * dynamic imports only for types from that list.
+   *
+   * This flag is needed to enable stricter behavior internally to make sure
+   * that local compilation with specific internal configuration can support
+   * `@defer` blocks.
+   */
+  onlyExplicitDeferDependencyImports?: boolean;
 }
 
 /**

Original file line number	Diff line number	Diff line change
`@@ -8,6 +8,7 @@`
`8`	`8`	`export interface BazelAndG3Options {`
`9`	`9`	`annotateForClosureCompiler?: boolean;`
`10`	`10`	`generateDeepReexports?: boolean;`
	`11`	`+ onlyExplicitDeferDependencyImports?: boolean;`
`11`	`12`	`onlyPublishPublicTypingsForNgModules?: boolean;`
`12`	`13`	`}`
`13`	`14`