refactor(@angular/build): provide a pre-link resolution condition for APF

To support future APF changes that may include pre-linked code specific
to the Angular version used to create the package, an additional package
resolution condition will now be automatically added to the build process
for applications. A condition in the form of `angular:linked-<version>`,
where `<version>` is the full package version of `@angular/core`, will now
be present during application builds. This change in combination with APF
changes will allow matching packages to avoid the linking step during a
build. Non-version matching packages will continue to function and use
the existing linking transformation process.

Author: clydin

packages/angular/build/src/builders/application/options.ts

@@ -9,7 +9,7 @@
 import type { BuilderContext } from '@angular-devkit/architect';
 import type { Plugin } from 'esbuild';
 import { realpathSync } from 'node:fs';
-import { access, constants } from 'node:fs/promises';
+import { access, constants, readFile } from 'node:fs/promises';
 import { createRequire } from 'node:module';
 import path from 'node:path';
 import { normalizeAssetPatterns, normalizeOptimization, normalizeSourceMaps } from '../../utils';
@@ -499,6 +499,7 @@ export async function normalizeOptions(
     templateUpdates: !!options.templateUpdates,
     incrementalResults: !!options.incrementalResults,
     customConditions: options.conditions,
+    frameworkVersion: await findFrameworkVersion(projectRoot),
   };
 }
 
@@ -706,3 +707,22 @@ function normalizeExternals(value: string[] | undefined): string[] | undefined {
 
   return [...new Set(value.map((d) => (d.endsWith('/*') ? d.slice(0, -2) : d)))];
 }
+
+async function findFrameworkVersion(projectRoot: string): Promise<string> {
+  // Create a custom require function for ESM compliance.
+  // NOTE: The trailing slash is significant.
+  const projectResolve = createRequire(projectRoot + '/').resolve;
+
+  try {
+    const manifestPath = projectResolve('@angular/core/package.json');
+    const manifestData = await readFile(manifestPath, 'utf-8');
+    const manifestObject = JSON.parse(manifestData) as { version: string };
+    const version = manifestObject.version;
+
+    return version;
+  } catch {
+    throw new Error(
+      'Error: It appears that "@angular/core" is missing as a dependency. Please ensure it is included in your project.',
+    );
+  }
+}

packages/angular/build/src/tools/esbuild/application-code-bundle.ts

@@ -547,6 +547,7 @@ function getEsBuildCommonOptions(options: NormalizedApplicationBuildOptions): Bu
     jsonLogs,
     i18nOptions,
     customConditions,
+    frameworkVersion,
   } = options;
 
   // Ensure unique hashes for i18n translation changes when using post-process inlining.
@@ -570,6 +571,14 @@ function getEsBuildCommonOptions(options: NormalizedApplicationBuildOptions): Bu
     'es2015',
     'es2020',
   ];
+  // The pre-linked code is not used with JIT for two reasons:
+  // 1) The pre-linked code may not have the metadata included that is required for JIT
+  // 2) The CLI is otherwise setup to use runtime linking for JIT to match the application template compilation
+  if (!jit) {
+    // The pre-linked package condition is based on the framework version.
+    // Currently this is specific to each patch version of the framework.
+    conditions.push('angular:linked-' + frameworkVersion);
+  }
 
   // Append custom conditions if present
   if (customConditions) {