@angular/build 20.0.0-next.3 → 20.0.0-next.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular/build",
-  "version": "20.0.0-next.3",
+  "version": "20.0.0-next.5",
   "description": "Official build system for Angular",
   "keywords": [
     "Angular CLI",
@@ -23,16 +23,15 @@
   "builders": "builders.json",
   "dependencies": {
     "@ampproject/remapping": "2.3.0",
-    "@angular-devkit/architect": "0.2000.0-next.3",
+    "@angular-devkit/architect": "0.2000.0-next.5",
     "@babel/core": "7.26.10",
     "@babel/helper-annotate-as-pure": "7.25.9",
     "@babel/helper-split-export-declaration": "7.24.7",
-    "@babel/plugin-syntax-import-attributes": "7.26.0",
-    "@inquirer/confirm": "5.1.8",
+    "@inquirer/confirm": "5.1.9",
     "@vitejs/plugin-basic-ssl": "2.0.0",
-    "beasties": "0.2.0",
+    "beasties": "0.3.2",
     "browserslist": "^4.23.0",
-    "esbuild": "0.25.1",
+    "esbuild": "0.25.2",
     "https-proxy-agent": "7.0.6",
     "istanbul-lib-instrument": "6.0.3",
     "jsonc-parser": "3.3.1",
@@ -42,33 +41,38 @@
     "parse5-html-rewriting-stream": "7.0.0",
     "picomatch": "4.0.2",
     "piscina": "4.9.2",
-    "rollup": "4.37.0",
-    "sass": "1.86.0",
+    "rollup": "4.39.0",
+    "sass": "1.86.3",
     "semver": "7.7.1",
     "source-map-support": "0.5.21",
     "tinyglobby": "0.2.12",
-    "vite": "6.2.3",
+    "vite": "6.2.5",
     "watchpack": "2.4.2"
   },
   "optionalDependencies": {
     "lmdb": "3.2.6"
   },
   "peerDependencies": {
+    "@angular/core": "^20.0.0 || ^20.0.0-next.0",
     "@angular/compiler": "^20.0.0 || ^20.0.0-next.0",
     "@angular/compiler-cli": "^20.0.0 || ^20.0.0-next.0",
     "@angular/localize": "^20.0.0 || ^20.0.0-next.0",
     "@angular/platform-browser": "^20.0.0 || ^20.0.0-next.0",
     "@angular/platform-server": "^20.0.0 || ^20.0.0-next.0",
     "@angular/service-worker": "^20.0.0 || ^20.0.0-next.0",
-    "@angular/ssr": "^20.0.0-next.3",
+    "@angular/ssr": "^20.0.0-next.5",
     "karma": "^6.4.0",
     "less": "^4.2.0",
     "ng-packagr": "^20.0.0 || ^20.0.0-next.0",
     "postcss": "^8.4.0",
     "tailwindcss": "^2.0.0 || ^3.0.0 || ^4.0.0",
+    "tslib": "^2.3.0",
     "typescript": ">=5.8 <5.9"
   },
   "peerDependenciesMeta": {
+    "@angular/core": {
+      "optional": true
+    },
     "@angular/localize": {
       "optional": true
     },

package/src/builders/application/options.d.ts

@@ -203,6 +203,8 @@ export declare function normalizeOptions(context: BuilderContext, projectName: s
     };
     templateUpdates: boolean;
     incrementalResults: boolean;
+    customConditions: string[] | undefined;
+    frameworkVersion: string;
 }>;
 export declare function getLocaleBaseHref(baseHref: string | undefined, i18n: NormalizedApplicationBuildOptions['i18nOptions'], locale: string): string | undefined;
 export {};

package/src/builders/application/options.js

@@ -132,12 +132,12 @@ async function normalizeOptions(context, projectName, options, extensions) {
         ? undefined
         : await getTailwindConfig(searchDirectories, workspaceRoot, context);
     let serverEntryPoint;
-    if (options.server) {
+    if (typeof options.server === 'string') {
+        if (options.server === '') {
+            throw new Error('The "server" option cannot be an empty string.');
+        }
         serverEntryPoint = node_path_1.default.join(workspaceRoot, options.server);
     }
-    else if (options.server === '') {
-        throw new Error('The "server" option cannot be an empty string.');
-    }
     let prerenderOptions;
     if (options.prerender) {
         const { discoverRoutes = true, routesFile = undefined } = options.prerender === true ? {} : options.prerender;
@@ -191,12 +191,18 @@ async function normalizeOptions(context, projectName, options, extensions) {
     let indexHtmlOptions;
     // index can never have a value of `true` but in the schema it's of type `boolean`.
     if (typeof options.index !== 'boolean') {
+        let indexInput;
         let indexOutput;
         // The output file will be created within the configured output path
         if (typeof options.index === 'string') {
-            indexOutput = options.index;
+            indexInput = indexOutput = node_path_1.default.join(workspaceRoot, options.index);
+        }
+        else if (typeof options.index === 'undefined') {
+            indexInput = node_path_1.default.join(projectSourceRoot, 'index.html');
+            indexOutput = 'index.html';
         }
         else {
+            indexInput = node_path_1.default.join(workspaceRoot, options.index.input);
             indexOutput = options.index.output || 'index.html';
         }
         /**
@@ -214,7 +220,7 @@ async function normalizeOptions(context, projectName, options, extensions) {
                 ? exports.INDEX_HTML_CSR
                 : indexBaseName;
         indexHtmlOptions = {
-            input: node_path_1.default.join(workspaceRoot, typeof options.index === 'string' ? options.index : options.index.input),
+            input: indexInput,
             output: indexOutput,
             insertionOrder: [
                 ['polyfills', true],
@@ -312,6 +318,8 @@ async function normalizeOptions(context, projectName, options, extensions) {
         security,
         templateUpdates: !!options.templateUpdates,
         incrementalResults: !!options.incrementalResults,
+        customConditions: options.conditions,
+        frameworkVersion: await findFrameworkVersion(projectRoot),
     };
 }
 async function getTailwindConfig(searchDirectories, workspaceRoot, context) {
@@ -468,5 +476,24 @@ function normalizeExternals(value) {
     if (!value) {
         return undefined;
     }
-    return [...new Set(value.map((d) => (d.endsWith('/*') ? d.slice(0, -2) : d)))];
+    return [
+        ...new Set(value.map((d) => 
+        // remove "/*" wildcard in the end if provided string is not path-like
+        d.endsWith('/*') && !/^\.{0,2}\//.test(d) ? d.slice(0, -2) : d)),
+    ];
+}
+async function findFrameworkVersion(projectRoot) {
+    // Create a custom require function for ESM compliance.
+    // NOTE: The trailing slash is significant.
+    const projectResolve = (0, node_module_1.createRequire)(projectRoot + '/').resolve;
+    try {
+        const manifestPath = projectResolve('@angular/core/package.json');
+        const manifestData = await (0, promises_1.readFile)(manifestPath, 'utf-8');
+        const manifestObject = JSON.parse(manifestData);
+        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.');
+    }
 }

package/src/builders/application/schema.d.ts

@@ -37,6 +37,13 @@ export type Schema = {
      * Automatically clear the terminal screen during rebuilds.
      */
     clearScreen?: boolean;
+    /**
+     * Custom package resolution conditions used to resolve conditional exports/imports.
+     * Defaults to ['module', 'development'/'production']. The following special conditions are
+     * always present if the requirements are satisfied: 'default', 'import', 'require',
+     * 'browser', 'node'.
+     */
+    conditions?: string[];
     /**
      * Define the crossorigin attribute setting of elements that provide CORS support.
      */
@@ -86,7 +93,7 @@ export type Schema = {
     /**
      * Configures the generation of the application's HTML index.
      */
-    index: IndexUnion;
+    index?: IndexUnion;
     /**
      * The stylesheet language to use for the application's inline component styles.
      */
@@ -163,11 +170,11 @@ export type Schema = {
      * The full path for the server entry point to the application, relative to the current
      * workspace.
      */
-    server?: string;
+    server?: Serv;
     /**
      * Generates a service worker configuration.
      */
-    serviceWorker?: ServiceWorker;
+    serviceWorker?: Serv;
     /**
      * Output source maps for scripts and styles. For more information, see
      * https://angular.dev/reference/configs/workspace-config#source-map-configuration.
@@ -496,9 +503,12 @@ export type AutoCspClass = {
     unsafeEval?: boolean;
 };
 /**
+ * The full path for the server entry point to the application, relative to the current
+ * workspace.
+ *
  * Generates a service worker configuration.
  */
-export type ServiceWorker = boolean | string;
+export type Serv = boolean | string;
 /**
  * Output source maps for scripts and styles. For more information, see
  * https://angular.dev/reference/configs/workspace-config#source-map-configuration.

package/src/builders/application/schema.json

@@ -17,7 +17,6 @@
       "description": "The full path for the browser entry point to the application, relative to the current workspace."
     },
     "server": {
-      "type": "string",
       "description": "The full path for the server entry point to the application, relative to the current workspace.",
       "oneOf": [
         {
@@ -293,6 +292,13 @@
         "type": "string"
       }
     },
+    "conditions": {
+      "description": "Custom package resolution conditions used to resolve conditional exports/imports. Defaults to ['module', 'development'/'production']. The following special conditions are always present if the requirements are satisfied: 'default', 'import', 'require', 'browser', 'node'.",
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
     "fileReplacements": {
       "description": "Replace compilation source files with other compilation source files in the build.",
       "type": "array",
@@ -610,7 +616,7 @@
     }
   },
   "additionalProperties": false,
-  "required": ["index", "browser", "tsConfig"],
+  "required": ["browser", "tsConfig"],
   "definitions": {
     "assetPattern": {
       "oneOf": [

package/src/builders/dev-server/vite-server.js

@@ -121,12 +121,6 @@ async function* serveWithVite(serverOptions, builderName, builderAction, context
     // This will also replace file-based/inline styles as code if external runtime styles are not enabled.
     browserOptions.templateUpdates =
         serverOptions.liveReload && serverOptions.hmr && environment_options_1.useComponentTemplateHmr;
-    if (browserOptions.templateUpdates) {
-        context.logger.warn('Component HMR has been enabled.\n' +
-            'If you encounter application reload issues, you can manually reload the page to bypass HMR and/or disable this feature with the' +
-            ' `--no-hmr` command line option.\n' +
-            'Please consider reporting any issues you encounter here: https://github.com/angular/angular-cli/issues\n');
-    }
     browserOptions.incrementalResults = true;
     // Setup the prebundling transformer that will be shared across Vite prebundling requests
     const prebundleTransformer = new internal_1.JavaScriptTransformer(

package/src/builders/karma/application_builder.js

@@ -295,6 +295,7 @@ async function collectEntrypoints(options, context, projectSourceRoot) {
     const testFiles = await (0, find_tests_1.findTests)(options.include ?? [], options.exclude ?? [], context.workspaceRoot, projectSourceRoot);
     return (0, find_tests_1.getTestEntrypoints)(testFiles, { projectSourceRoot, workspaceRoot: context.workspaceRoot });
 }
+// eslint-disable-next-line max-lines-per-function
 async function initializeApplication(options, context, karmaOptions, transforms = {}) {
     const outputPath = path.join(context.workspaceRoot, 'dist/test-out', (0, node_crypto_1.randomUUID)());
     const projectSourceRoot = await getProjectSourceRoot(context);
@@ -406,6 +407,14 @@ async function initializeApplication(options, context, karmaOptions, transforms
         karmaOptions.files.push({ pattern: `*.css`, type: 'css', watched: false });
     }
     const parsedKarmaConfig = await karma.config.parseConfig(options.karmaConfig && path.resolve(context.workspaceRoot, options.karmaConfig), transforms.karmaOptions ? transforms.karmaOptions(karmaOptions) : karmaOptions, { promiseConfig: true, throwErrors: true });
+    // Check for jsdom which does not support executing ESM scripts.
+    // If present, remove jsdom and issue a warning.
+    const updatedBrowsers = parsedKarmaConfig.browsers?.filter((browser) => browser !== 'jsdom');
+    if (parsedKarmaConfig.browsers?.length !== updatedBrowsers?.length) {
+        parsedKarmaConfig.browsers = updatedBrowsers;
+        context.logger.warn(`'jsdom' does not support ESM code execution and cannot be used for karma testing.` +
+            ` The 'jsdom' entry has been removed from the 'browsers' option.`);
+    }
     // Remove the webpack plugin/framework:
     // Alternative would be to make the Karma plugin "smart" but that's a tall order
     // with managing unneeded imports etc..

package/src/builders/karma/index.js

@@ -76,7 +76,7 @@ function getBaseKarmaOptions(options, context) {
     karmaOptions.client.clearContext ??= singleRun ?? false; // `singleRun` defaults to `false` per Karma docs.
     // Convert browsers from a string to an array
     if (typeof options.browsers === 'string' && options.browsers) {
-        karmaOptions.browsers = options.browsers.split(',');
+        karmaOptions.browsers = options.browsers.split(',').map((browser) => browser.trim());
     }
     else if (options.browsers === false) {
         karmaOptions.browsers = [];

package/src/builders/karma/polyfills/init_test_bed.js

@@ -7,12 +7,10 @@
  */
 
 import { getTestBed } from '@angular/core/testing';
-import { platformBrowser } from '@angular/platform-browser';
-import { BrowserTestingModule } from '@angular/platform-browser/testing';
+import { BrowserTestingModule, platformBrowserTesting } from '@angular/platform-browser/testing';
 
-// TODO(alanagius): replace with `platformBrowserTesting` once https://github.com/angular/angular/pull/60480 is released.
 // Initialize the Angular testing environment.
-getTestBed().initTestEnvironment(BrowserTestingModule, platformBrowser(), {
+getTestBed().initTestEnvironment(BrowserTestingModule, platformBrowserTesting(), {
   errorOnUnknownElements: true,
   errorOnUnknownProperties: true,
 });

package/src/builders/ng-packagr/builder.js

@@ -57,7 +57,7 @@ const purge_cache_1 = require("../../utils/purge-cache");
 async function* execute(options, context) {
     // Purge old build disk cache.
     await (0, purge_cache_1.purgeStaleBuildCache)(context);
-    const root = context.workspaceRoot;
+    const workspaceRoot = context.workspaceRoot;
     let packager;
     try {
         packager = (await Promise.resolve().then(() => __importStar(require('ng-packagr')))).ngPackagr();
@@ -72,15 +72,18 @@ async function* execute(options, context) {
         }
         throw error;
     }
-    packager.forProject((0, node_path_1.resolve)(root, options.project));
-    if (options.tsConfig) {
-        packager.withTsConfig((0, node_path_1.resolve)(root, options.tsConfig));
-    }
     const projectName = context.target?.project;
     if (!projectName) {
         throw new Error('The builder requires a target.');
     }
     const metadata = await context.getProjectMetadata(projectName);
+    const ngPackagrConfig = options.project
+        ? (0, node_path_1.join)(workspaceRoot, options.project)
+        : (0, node_path_1.join)(workspaceRoot, metadata.root ?? '', 'ng-package.json');
+    packager.forProject(ngPackagrConfig);
+    if (options.tsConfig) {
+        packager.withTsConfig((0, node_path_1.resolve)(workspaceRoot, options.tsConfig));
+    }
     const { enabled: cacheEnabled, path: cacheDirectory } = (0, normalize_cache_1.normalizeCacheOptions)(metadata, context.workspaceRoot);
     const ngPackagrOptions = {
         cacheEnabled,

package/src/builders/ng-packagr/schema.d.ts

@@ -9,7 +9,7 @@ export type Schema = {
     /**
      * The file path for the ng-packagr configuration file, relative to the current workspace.
      */
-    project: string;
+    project?: string;
     /**
      * The full path for the TypeScript configuration file, relative to the current workspace.
      */

package/src/builders/ng-packagr/schema.json

@@ -22,6 +22,5 @@
       "description": "Enable and define the file watching poll time period in milliseconds."
     }
   },
-  "additionalProperties": false,
-  "required": ["project"]
+  "additionalProperties": false
 }

package/src/tools/esbuild/angular/compiler-plugin.d.ts

@@ -14,6 +14,7 @@ export interface CompilerPluginOptions {
     sourcemap: boolean | 'external';
     tsconfig: string;
     jit?: boolean;
+    includeTestMetadata?: boolean;
     advancedOptimizations?: boolean;
     thirdPartySourcemaps?: boolean;
     fileReplacements?: Record<string, string>;

package/src/tools/esbuild/angular/compiler-plugin.js

@@ -233,7 +233,7 @@ function createCompilerPlugin(pluginOptions, compilationOrFactory, stylesheetBun
                 let referencedFiles;
                 let externalStylesheets;
                 try {
-                    const initializationResult = await compilation.initialize(pluginOptions.tsconfig, hostOptions, createCompilerOptionsTransformer(setupWarnings, pluginOptions, preserveSymlinks, build.initialOptions.conditions, build.initialOptions.absWorkingDir));
+                    const initializationResult = await compilation.initialize(pluginOptions.tsconfig, hostOptions, createCompilerOptionsTransformer(setupWarnings, pluginOptions, preserveSymlinks, build.initialOptions.conditions));
                     shouldTsIgnoreJs = !initializationResult.compilerOptions.allowJs;
                     // Isolated modules option ensures safe non-TypeScript transpilation.
                     // Typescript printing support for sourcemaps is not yet integrated.
@@ -474,7 +474,7 @@ async function bundleExternalStylesheet(stylesheetBundler, stylesheetFile, exter
         });
     }
 }
-function createCompilerOptionsTransformer(setupWarnings, pluginOptions, preserveSymlinks, customConditions, absWorkingDir) {
+function createCompilerOptionsTransformer(setupWarnings, pluginOptions, preserveSymlinks, customConditions) {
     return (compilerOptions) => {
         // target of 9 is ES2022 (using the number avoids an expensive import of typescript just for an enum)
         if (compilerOptions.target === undefined || compilerOptions.target < 9 /** ES2022 */) {
@@ -542,6 +542,7 @@ function createCompilerOptionsTransformer(setupWarnings, pluginOptions, preserve
         return {
             ...compilerOptions,
             noEmitOnError: false,
+            composite: false,
             inlineSources: !!pluginOptions.sourcemap,
             inlineSourceMap: !!pluginOptions.sourcemap,
             sourceMap: undefined,
@@ -550,6 +551,7 @@ function createCompilerOptionsTransformer(setupWarnings, pluginOptions, preserve
             preserveSymlinks,
             externalRuntimeStyles: pluginOptions.externalRuntimeStyles,
             _enableHmr: !!pluginOptions.templateUpdates,
+            supportTestBed: !!pluginOptions.includeTestMetadata,
         };
     };
 }

package/src/tools/esbuild/application-code-bundle.js

@@ -382,7 +382,7 @@ function getEsBuildServerCommonOptions(options) {
     };
 }
 function getEsBuildCommonOptions(options) {
-    const { workspaceRoot, outExtension, optimizationOptions, sourcemapOptions, tsconfig, externalDependencies, outputNames, preserveSymlinks, jit, loaderExtensions, jsonLogs, i18nOptions, } = options;
+    const { workspaceRoot, outExtension, optimizationOptions, sourcemapOptions, tsconfig, externalDependencies, outputNames, preserveSymlinks, jit, loaderExtensions, jsonLogs, i18nOptions, customConditions, frameworkVersion, } = options;
     // Ensure unique hashes for i18n translation changes when using post-process inlining.
     // This hash value is added as a footer to each file and ensures that the output file names (with hashes)
     // change when translation files have changed. If this is not done the post processed files may have
@@ -393,18 +393,36 @@ function getEsBuildCommonOptions(options) {
         const i18nHash = Object.values(i18nOptions.locales).reduce((data, locale) => data + locale.files.map((file) => file.integrity || '').join('|'), '');
         footer = { js: `/**i18n:${(0, node_crypto_1.createHash)('sha256').update(i18nHash).digest('hex')}*/` };
     }
+    // Core conditions that are always included
+    const conditions = [
+        // Required to support rxjs 7.x which will use es5 code if this condition is not present
+        '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) {
+        conditions.push(...customConditions);
+    }
+    else {
+        // Include default conditions
+        conditions.push('module');
+        conditions.push(optimizationOptions.scripts ? 'production' : 'development');
+    }
     return {
         absWorkingDir: workspaceRoot,
         format: 'esm',
         bundle: true,
         packages: 'bundle',
         assetNames: outputNames.media,
-        conditions: [
-            'es2020',
-            'es2015',
-            'module',
-            optimizationOptions.scripts ? 'production' : 'development',
-        ],
+        conditions,
         resolveExtensions: ['.ts', '.tsx', '.mjs', '.js', '.cjs'],
         metafile: true,
         legalComments: options.extractLicenses ? 'none' : 'eof',

package/src/tools/esbuild/compiler-plugin-options.js

@@ -9,7 +9,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createCompilerPluginOptions = createCompilerPluginOptions;
 function createCompilerPluginOptions(options, sourceFileCache, loadResultCache, templateUpdates) {
-    const { sourcemapOptions, tsconfig, fileReplacements, advancedOptimizations, jit, externalRuntimeStyles, instrumentForCoverage, } = options;
+    const { sourcemapOptions, tsconfig, fileReplacements, advancedOptimizations, jit, externalRuntimeStyles, instrumentForCoverage, optimizationOptions, } = options;
     const incremental = !!options.watch;
     return {
         sourcemap: !!sourcemapOptions.scripts && (sourcemapOptions.hidden ? 'external' : true),
@@ -24,5 +24,6 @@ function createCompilerPluginOptions(options, sourceFileCache, loadResultCache,
         externalRuntimeStyles,
         instrumentForCoverage,
         templateUpdates,
+        includeTestMetadata: !optimizationOptions.scripts,
     };
 }

package/src/tools/esbuild/javascript-transformer-worker.js

@@ -70,9 +70,7 @@ async function transformWithBabel(filename, data, options) {
     const shouldLink = !options.skipLinker && (await requiresLinking(filename, data));
     const useInputSourcemap = options.sourcemap &&
         (!!options.thirdPartySourcemaps || !/[\\/]node_modules[\\/]/.test(filename));
-    // @ts-expect-error Import attribute syntax plugin does not currently have type definitions
-    const { default: importAttributePlugin } = await Promise.resolve().then(() => __importStar(require('@babel/plugin-syntax-import-attributes')));
-    const plugins = [importAttributePlugin];
+    const plugins = [];
     if (options.instrumentForCoverage) {
         const { default: coveragePlugin } = await Promise.resolve().then(() => __importStar(require('../babel/plugins/add-code-coverage.js')));
         plugins.push(coveragePlugin);

package/src/utils/normalize-cache.js

@@ -10,7 +10,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.normalizeCacheOptions = normalizeCacheOptions;
 const node_path_1 = require("node:path");
 /** Version placeholder is replaced during the build process with actual package version */
-const VERSION = '20.0.0-next.3';
+const VERSION = '20.0.0-next.5';
 function hasCacheMetadata(value) {
     return (!!value &&
         typeof value === 'object' &&