@angular/build 19.1.0-rc.0 → 19.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular/build",
-  "version": "19.1.0-rc.0",
+  "version": "19.1.0",
   "description": "Official build system for Angular",
   "keywords": [
     "Angular CLI",
@@ -23,7 +23,7 @@
   "builders": "builders.json",
   "dependencies": {
     "@ampproject/remapping": "2.3.0",
-    "@angular-devkit/architect": "0.1901.0-rc.0",
+    "@angular-devkit/architect": "0.1901.0",
     "@babel/core": "7.26.0",
     "@babel/helper-annotate-as-pure": "7.25.9",
     "@babel/helper-split-export-declaration": "7.24.7",
@@ -52,14 +52,14 @@
     "lmdb": "3.2.2"
   },
   "peerDependencies": {
-    "@angular/compiler": "^19.0.0 || ^19.1.0-next.0",
-    "@angular/compiler-cli": "^19.0.0 || ^19.1.0-next.0",
-    "@angular/localize": "^19.0.0 || ^19.1.0-next.0",
-    "@angular/platform-server": "^19.0.0 || ^19.1.0-next.0",
-    "@angular/service-worker": "^19.0.0 || ^19.1.0-next.0",
-    "@angular/ssr": "^19.1.0-rc.0",
+    "@angular/compiler": "^19.0.0",
+    "@angular/compiler-cli": "^19.0.0",
+    "@angular/localize": "^19.0.0",
+    "@angular/platform-server": "^19.0.0",
+    "@angular/service-worker": "^19.0.0",
+    "@angular/ssr": "^19.1.0",
     "less": "^4.2.0",
-    "ng-packagr": "^19.0.0 || ^19.1.0-next.0",
+    "ng-packagr": "^19.0.0",
     "postcss": "^8.4.0",
     "tailwindcss": "^2.0.0 || ^3.0.0",
     "typescript": ">=5.5 <5.8"

package/src/builders/application/build-action.js

@@ -164,7 +164,7 @@ async function* runEsBuildBuildAction(action, options) {
             if (staleWatchFiles?.size) {
                 watcher.remove([...staleWatchFiles]);
             }
-            for (const outputResult of emitOutputResults(result, outputOptions, incrementalResults ? rebuildState.previousOutputInfo : undefined)) {
+            for (const outputResult of emitOutputResults(result, outputOptions, changes, incrementalResults ? rebuildState : undefined)) {
                 yield outputResult;
             }
         }
@@ -175,7 +175,7 @@ async function* runEsBuildBuildAction(action, options) {
         (0, sass_language_1.shutdownSassWorkerPool)();
     }
 }
-function* emitOutputResults({ outputFiles, assetFiles, errors, warnings, externalMetadata, htmlIndexPath, htmlBaseHref, templateUpdates, }, outputOptions, previousOutputInfo) {
+function* emitOutputResults({ outputFiles, assetFiles, errors, warnings, externalMetadata, htmlIndexPath, htmlBaseHref, templateUpdates, }, outputOptions, changes, rebuildState) {
     if (errors.length > 0) {
         yield {
             kind: results_1.ResultKind.Failure,
@@ -201,7 +201,8 @@ function* emitOutputResults({ outputFiles, assetFiles, errors, warnings, externa
         yield updateResult;
     }
     // Use an incremental result if previous output information is available
-    if (previousOutputInfo) {
+    if (rebuildState && changes) {
+        const { previousAssetsInfo, previousOutputInfo } = rebuildState;
         const incrementalResult = {
             kind: results_1.ResultKind.Incremental,
             warnings: warnings,
@@ -245,21 +246,33 @@ function* emitOutputResults({ outputFiles, assetFiles, errors, warnings, externa
                 };
             }
         }
-        // Include the removed output files
-        incrementalResult.removed.push(...Array.from(removedOutputFiles, ([file, { type }]) => ({
-            path: file,
-            type,
-        })));
-        // Always consider asset files as added to ensure new/modified assets are available.
-        // TODO: Consider more comprehensive asset analysis.
-        for (const file of assetFiles) {
-            incrementalResult.added.push(file.destination);
-            incrementalResult.files[file.destination] = {
+        // Initially assume all previous assets files have been removed
+        const removedAssetFiles = new Map(previousAssetsInfo);
+        for (const { source, destination } of assetFiles) {
+            removedAssetFiles.delete(source);
+            if (!previousAssetsInfo.has(source)) {
+                incrementalResult.added.push(destination);
+            }
+            else if (changes.modified.has(source)) {
+                incrementalResult.modified.push(destination);
+            }
+            else {
+                continue;
+            }
+            incrementalResult.files[destination] = {
                 type: bundler_context_1.BuildOutputFileType.Browser,
-                inputPath: file.source,
+                inputPath: source,
                 origin: 'disk',
             };
         }
+        // Include the removed output and asset files
+        incrementalResult.removed.push(...Array.from(removedOutputFiles, ([file, { type }]) => ({
+            path: file,
+            type,
+        })), ...Array.from(removedAssetFiles.values(), (file) => ({
+            path: file,
+            type: bundler_context_1.BuildOutputFileType.Browser,
+        })));
         yield incrementalResult;
         return;
     }

package/src/builders/application/execute-build.js

@@ -41,6 +41,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.executeBuild = executeBuild;
+const compilation_1 = require("../../tools/angular/compilation");
 const source_file_cache_1 = require("../../tools/esbuild/angular/source-file-cache");
 const budget_stats_1 = require("../../tools/esbuild/budget-stats");
 const bundler_context_1 = require("../../tools/esbuild/bundler-context");
@@ -102,7 +103,9 @@ async function executeBuild(options, context, rebuildState) {
         if (options.templateUpdates) {
             templateUpdates = new Map();
         }
-        bundlerContexts = (0, setup_bundling_1.setupBundlerContexts)(options, target, codeBundleCache, componentStyleBundler, templateUpdates);
+        bundlerContexts = (0, setup_bundling_1.setupBundlerContexts)(options, target, codeBundleCache, componentStyleBundler, 
+        // Create new reusable compilation for the appropriate mode based on the `jit` plugin option
+        await (0, compilation_1.createAngularCompilation)(!!options.jit, !options.serverEntryPoint), templateUpdates);
         // Bundle everything on initial build
         bundlingResult = await bundler_context_1.BundlerContext.bundleAll([
             ...bundlerContexts.typescriptContexts,

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

@@ -5,7 +5,8 @@
  * Use of this source code is governed by an MIT-style license that can be
  * found in the LICENSE file at https://angular.dev/license
  */
-import { BuilderContext, BuilderOutput } from '@angular-devkit/architect';
+import { Builder, BuilderContext, BuilderOutput } from '@angular-devkit/architect';
+import { json } from '@angular-devkit/core';
 import { ApplicationBuilderExtensions, ApplicationBuilderInternalOptions } from './options';
 import { Result } from './results';
 import { Schema as ApplicationBuilderOptions } from './schema';
@@ -28,5 +29,5 @@ export declare function buildApplicationInternal(options: ApplicationBuilderInte
  * @returns The build output results of the build.
  */
 export declare function buildApplication(options: ApplicationBuilderOptions, context: BuilderContext, extensions?: ApplicationBuilderExtensions): AsyncIterable<BuilderOutput>;
-declare const _default: import("../../../../../angular_devkit/architect/src/internal").Builder<ApplicationBuilderOptions & import("../../../../../angular_devkit/core").JsonObject>;
-export default _default;
+declare const builder: Builder<ApplicationBuilderOptions & json.JsonObject>;
+export default builder;

package/src/builders/application/index.js

@@ -196,4 +196,5 @@ function generateFullPath(filePath, type, outputOptions) {
     const fullFilePath = node_path_1.default.join(outputOptions.base, typeDirectory, filePath);
     return fullFilePath;
 }
-exports.default = (0, architect_1.createBuilder)(buildApplication);
+const builder = (0, architect_1.createBuilder)(buildApplication);
+exports.default = builder;

package/src/builders/application/setup-bundling.d.ts

@@ -5,6 +5,7 @@
  * Use of this source code is governed by an MIT-style license that can be
  * found in the LICENSE file at https://angular.dev/license
  */
+import { AngularCompilation } from '../../tools/angular/compilation';
 import { ComponentStylesheetBundler } from '../../tools/esbuild/angular/component-stylesheets';
 import { SourceFileCache } from '../../tools/esbuild/angular/source-file-cache';
 import { BundlerContext } from '../../tools/esbuild/bundler-context';
@@ -17,7 +18,7 @@ import { NormalizedApplicationBuildOptions } from './options';
  * @param codeBundleCache An instance of the TypeScript source file cache.
  * @returns An array of BundlerContext objects.
  */
-export declare function setupBundlerContexts(options: NormalizedApplicationBuildOptions, target: string[], codeBundleCache: SourceFileCache, stylesheetBundler: ComponentStylesheetBundler, templateUpdates: Map<string, string> | undefined): {
+export declare function setupBundlerContexts(options: NormalizedApplicationBuildOptions, target: string[], codeBundleCache: SourceFileCache, stylesheetBundler: ComponentStylesheetBundler, angularCompilation: AngularCompilation, templateUpdates: Map<string, string> | undefined): {
     typescriptContexts: BundlerContext[];
     otherContexts: BundlerContext[];
 };

package/src/builders/application/setup-bundling.js

@@ -23,12 +23,12 @@ const utils_1 = require("../../tools/esbuild/utils");
  * @param codeBundleCache An instance of the TypeScript source file cache.
  * @returns An array of BundlerContext objects.
  */
-function setupBundlerContexts(options, target, codeBundleCache, stylesheetBundler, templateUpdates) {
+function setupBundlerContexts(options, target, codeBundleCache, stylesheetBundler, angularCompilation, templateUpdates) {
     const { outputMode, serverEntryPoint, appShellOptions, prerenderOptions, ssrOptions, workspaceRoot, watch = false, } = options;
     const typescriptContexts = [];
     const otherContexts = [];
     // Browser application code
-    typescriptContexts.push(new bundler_context_1.BundlerContext(workspaceRoot, watch, (0, application_code_bundle_1.createBrowserCodeBundleOptions)(options, target, codeBundleCache, stylesheetBundler, templateUpdates)));
+    typescriptContexts.push(new bundler_context_1.BundlerContext(workspaceRoot, watch, (0, application_code_bundle_1.createBrowserCodeBundleOptions)(options, target, codeBundleCache, stylesheetBundler, angularCompilation, templateUpdates)));
     // Browser polyfills code
     const browserPolyfillBundleOptions = (0, application_code_bundle_1.createBrowserPolyfillBundleOptions)(options, target, codeBundleCache, stylesheetBundler);
     if (browserPolyfillBundleOptions) {

package/src/builders/dev-server/index.d.ts

@@ -5,10 +5,12 @@
  * Use of this source code is governed by an MIT-style license that can be
  * found in the LICENSE file at https://angular.dev/license
  */
+import { Builder } from '@angular-devkit/architect';
+import { json } from '@angular-devkit/core';
 import { execute } from './builder';
 import type { DevServerBuilderOutput } from './output';
 import type { Schema as DevServerBuilderOptions } from './schema';
 export { type DevServerBuilderOptions, type DevServerBuilderOutput, execute as executeDevServerBuilder, };
-declare const _default: import("../../../../../angular_devkit/architect/src/internal").Builder<DevServerBuilderOptions & import("../../../../../angular_devkit/core").JsonObject>;
-export default _default;
+declare const builder: Builder<DevServerBuilderOptions & json.JsonObject>;
+export default builder;
 export { execute as executeDevServer };

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

@@ -12,4 +12,5 @@ const architect_1 = require("@angular-devkit/architect");
 const builder_1 = require("./builder");
 Object.defineProperty(exports, "executeDevServerBuilder", { enumerable: true, get: function () { return builder_1.execute; } });
 Object.defineProperty(exports, "executeDevServer", { enumerable: true, get: function () { return builder_1.execute; } });
-exports.default = (0, architect_1.createBuilder)(builder_1.execute);
+const builder = (0, architect_1.createBuilder)(builder_1.execute);
+exports.default = builder;

package/src/builders/dev-server/vite-server.d.ts

@@ -23,6 +23,10 @@ interface OutputFileRecord {
     servable: boolean;
     type: BuildOutputFileType;
 }
+interface OutputAssetRecord {
+    source: string;
+    updated: boolean;
+}
 interface DevServerExternalResultMetadata extends Omit<ExternalResultMetadata, 'explicit'> {
     explicitBrowser: string[];
     explicitServer: string[];
@@ -34,5 +38,5 @@ export declare function serveWithVite(serverOptions: NormalizedDevServerOptions,
     middleware?: Connect.NextHandleFunction[];
     buildPlugins?: Plugin[];
 }): AsyncIterableIterator<DevServerBuilderOutput>;
-export declare function setupServer(serverOptions: NormalizedDevServerOptions, outputFiles: Map<string, OutputFileRecord>, assets: Map<string, string>, preserveSymlinks: boolean | undefined, externalMetadata: DevServerExternalResultMetadata, ssrMode: ServerSsrMode, prebundleTransformer: JavaScriptTransformer, target: string[], zoneless: boolean, componentStyles: Map<string, ComponentStyleRecord>, templateUpdates: Map<string, string>, prebundleLoaderExtensions: EsbuildLoaderOption | undefined, define: ApplicationBuilderInternalOptions['define'], extensionMiddleware?: Connect.NextHandleFunction[], indexHtmlTransformer?: (content: string) => Promise<string>, thirdPartySourcemaps?: boolean): Promise<InlineConfig>;
+export declare function setupServer(serverOptions: NormalizedDevServerOptions, outputFiles: Map<string, OutputFileRecord>, assets: Map<string, OutputAssetRecord>, preserveSymlinks: boolean | undefined, externalMetadata: DevServerExternalResultMetadata, ssrMode: ServerSsrMode, prebundleTransformer: JavaScriptTransformer, target: string[], zoneless: boolean, componentStyles: Map<string, ComponentStyleRecord>, templateUpdates: Map<string, string>, prebundleLoaderExtensions: EsbuildLoaderOption | undefined, define: ApplicationBuilderInternalOptions['define'], extensionMiddleware?: Connect.NextHandleFunction[], indexHtmlTransformer?: (content: string) => Promise<string>, thirdPartySourcemaps?: boolean): Promise<InlineConfig>;
 export {};

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

@@ -103,7 +103,7 @@ async function* serveWithVite(serverOptions, builderName, builderAction, context
         // https://nodejs.org/api/process.html#processsetsourcemapsenabledval
         process.setSourceMapsEnabled(true);
     }
-    // Enable to support link-based component style hot reloading (`NG_HMR_CSTYLES=0` can be used to disable selectively)
+    // Enable to support link-based component style hot reloading (`NG_HMR_CSTYLES=1` can be used to enable)
     browserOptions.externalRuntimeStyles =
         serverOptions.liveReload && serverOptions.hmr && environment_options_1.useComponentStyleHmr;
     // Enable to support component template hot replacement (`NG_HMR_TEMPLATE=0` can be used to disable selectively)
@@ -182,13 +182,8 @@ async function* serveWithVite(serverOptions, builderName, builderAction, context
                 assetFiles.clear();
                 componentStyles.clear();
                 generatedFiles.clear();
-                for (const entry of Object.entries(result.files)) {
-                    const [outputPath, file] = entry;
-                    if (file.origin === 'disk') {
-                        assetFiles.set('/' + normalizePath(outputPath), normalizePath(file.inputPath));
-                        continue;
-                    }
-                    updateResultRecord(outputPath, file, normalizePath, htmlIndexPath, generatedFiles, componentStyles, 
+                for (const [outputPath, file] of Object.entries(result.files)) {
+                    updateResultRecord(outputPath, file, normalizePath, htmlIndexPath, generatedFiles, assetFiles, componentStyles, 
                     // The initial build will not yet have a server setup
                     !server);
                 }
@@ -207,10 +202,10 @@ async function* serveWithVite(serverOptions, builderName, builderAction, context
                     assetFiles.delete(filePath);
                 }
                 for (const modified of result.modified) {
-                    updateResultRecord(modified, result.files[modified], normalizePath, htmlIndexPath, generatedFiles, componentStyles);
+                    updateResultRecord(modified, result.files[modified], normalizePath, htmlIndexPath, generatedFiles, assetFiles, componentStyles);
                 }
                 for (const added of result.added) {
-                    updateResultRecord(added, result.files[added], normalizePath, htmlIndexPath, generatedFiles, componentStyles);
+                    updateResultRecord(added, result.files[added], normalizePath, htmlIndexPath, generatedFiles, assetFiles, componentStyles);
                 }
                 break;
             case results_1.ResultKind.ComponentUpdate:
@@ -262,9 +257,12 @@ async function* serveWithVite(serverOptions, builderName, builderAction, context
         if (server) {
             // Update fs allow list to include any new assets from the build option.
             server.config.server.fs.allow = [
-                ...new Set([...server.config.server.fs.allow, ...assetFiles.values()]),
+                ...new Set([
+                    ...server.config.server.fs.allow,
+                    ...[...assetFiles.values()].map(({ source }) => source),
+                ]),
             ];
-            await handleUpdate(normalizePath, generatedFiles, server, serverOptions, context.logger, componentStyles);
+            await handleUpdate(normalizePath, generatedFiles, assetFiles, server, serverOptions, context.logger, componentStyles);
         }
         else {
             const projectName = context.target?.project;
@@ -337,10 +335,18 @@ async function* serveWithVite(serverOptions, builderName, builderAction, context
     }
     await new Promise((resolve) => (deferred = resolve));
 }
-async function handleUpdate(normalizePath, generatedFiles, server, serverOptions, logger, componentStyles) {
+async function handleUpdate(normalizePath, generatedFiles, assetFiles, server, serverOptions, logger, componentStyles) {
     const updatedFiles = [];
-    let destroyAngularServerAppCalled = false;
+    // Invalidate any updated asset
+    for (const [file, record] of assetFiles) {
+        if (!record.updated) {
+            continue;
+        }
+        record.updated = false;
+        updatedFiles.push(file);
+    }
     // Invalidate any updated files
+    let destroyAngularServerAppCalled = false;
     for (const [file, record] of generatedFiles) {
         if (!record.updated) {
             continue;
@@ -419,8 +425,12 @@ async function handleUpdate(normalizePath, generatedFiles, server, serverOptions
         logger.info('Page reload sent to client(s).');
     }
 }
-function updateResultRecord(outputPath, file, normalizePath, htmlIndexPath, generatedFiles, componentStyles, initial = false) {
+function updateResultRecord(outputPath, file, normalizePath, htmlIndexPath, generatedFiles, assetFiles, componentStyles, initial = false) {
     if (file.origin === 'disk') {
+        assetFiles.set('/' + normalizePath(outputPath), {
+            source: normalizePath(file.inputPath),
+            updated: !initial,
+        });
         return;
     }
     let filePath;
@@ -542,7 +552,11 @@ async function setupServer(serverOptions, outputFiles, assets, preserveSymlinks,
                 // The first two are required for Vite to function in prebundling mode (the default) and to load
                 // the Vite client-side code for browser reloading. These would be available by default but when
                 // the `allow` option is explicitly configured, they must be included manually.
-                allow: [cacheDir, (0, node_path_1.join)(serverOptions.workspaceRoot, 'node_modules'), ...assets.values()],
+                allow: [
+                    cacheDir,
+                    (0, node_path_1.join)(serverOptions.workspaceRoot, 'node_modules'),
+                    ...[...assets.values()].map(({ source }) => source),
+                ],
             },
             // This is needed when `externalDependencies` is used to prevent Vite load errors.
             // NOTE: If Vite adds direct support for externals, this can be removed.

package/src/builders/extract-i18n/index.d.ts

@@ -5,8 +5,10 @@
  * Use of this source code is governed by an MIT-style license that can be
  * found in the LICENSE file at https://angular.dev/license
  */
+import { Builder } from '@angular-devkit/architect';
+import { json } from '@angular-devkit/core';
 import { execute } from './builder';
 import type { Schema as ExtractI18nBuilderOptions } from './schema';
 export { ExtractI18nBuilderOptions, execute };
-declare const _default: import("../../../../../angular_devkit/architect/src/internal").Builder<ExtractI18nBuilderOptions & import("../../../../../angular_devkit/core").JsonObject>;
-export default _default;
+declare const builder: Builder<ExtractI18nBuilderOptions & json.JsonObject>;
+export default builder;

package/src/builders/extract-i18n/index.js

@@ -11,4 +11,5 @@ exports.execute = void 0;
 const architect_1 = require("@angular-devkit/architect");
 const builder_1 = require("./builder");
 Object.defineProperty(exports, "execute", { enumerable: true, get: function () { return builder_1.execute; } });
-exports.default = (0, architect_1.createBuilder)(builder_1.execute);
+const builder = (0, architect_1.createBuilder)(builder_1.execute);
+exports.default = builder;

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

@@ -5,8 +5,10 @@
  * Use of this source code is governed by an MIT-style license that can be
  * found in the LICENSE file at https://angular.dev/license
  */
+import { Builder } from '@angular-devkit/architect';
+import { json } from '@angular-devkit/core';
 import { execute } from './builder';
 import type { Schema as NgPackagrBuilderOptions } from './schema';
 export { type NgPackagrBuilderOptions, execute };
-declare const _default: import("../../../../../angular_devkit/architect/src/internal").Builder<NgPackagrBuilderOptions & import("../../../../../angular_devkit/core").JsonObject>;
-export default _default;
+declare const builder: Builder<NgPackagrBuilderOptions & json.JsonObject>;
+export default builder;

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

@@ -11,4 +11,5 @@ exports.execute = void 0;
 const architect_1 = require("@angular-devkit/architect");
 const builder_1 = require("./builder");
 Object.defineProperty(exports, "execute", { enumerable: true, get: function () { return builder_1.execute; } });
-exports.default = (0, architect_1.createBuilder)(builder_1.execute);
+const builder = (0, architect_1.createBuilder)(builder_1.execute);
+exports.default = builder;

package/src/private.d.ts

@@ -5,12 +5,6 @@
  * Use of this source code is governed by an MIT-style license that can be
  * found in the LICENSE file at https://angular.dev/license
  */
-/**
- * @fileoverview
- * Private exports intended only for use with the @angular-devkit/build-angular package.
- * All exports are not supported for external use, do not provide SemVer guarantees, and
- * their existence may change in any future version.
- */
 import { CompilerPluginOptions } from './tools/esbuild/angular/compiler-plugin';
 import { BundleStylesheetOptions } from './tools/esbuild/stylesheets/bundle-options';
 export { buildApplicationInternal } from './builders/application';
@@ -25,7 +19,10 @@ export { SassWorkerImplementation } from './tools/sass/sass-service';
 export { SourceFileCache } from './tools/esbuild/angular/source-file-cache';
 export { createJitResourceTransformer } from './tools/angular/transformers/jit-resource-transformer';
 export { JavaScriptTransformer } from './tools/esbuild/javascript-transformer';
-export declare function createCompilerPlugin(pluginOptions: CompilerPluginOptions, styleOptions: BundleStylesheetOptions & {
+export declare function createCompilerPlugin(pluginOptions: CompilerPluginOptions & {
+    browserOnlyBuild?: boolean;
+    noopTypeScriptCompilation?: boolean;
+}, styleOptions: BundleStylesheetOptions & {
     inlineStyleLanguage: string;
 }): import('esbuild').Plugin;
 export * from './utils/bundle-calculator';

package/src/private.js

@@ -29,6 +29,7 @@ exports.createCompilerPlugin = createCompilerPlugin;
  * All exports are not supported for external use, do not provide SemVer guarantees, and
  * their existence may change in any future version.
  */
+const compilation_1 = require("./tools/angular/compilation");
 const compiler_plugin_1 = require("./tools/esbuild/angular/compiler-plugin");
 const component_stylesheets_1 = require("./tools/esbuild/angular/component-stylesheets");
 // Builders
@@ -53,7 +54,9 @@ Object.defineProperty(exports, "createJitResourceTransformer", { enumerable: tru
 var javascript_transformer_1 = require("./tools/esbuild/javascript-transformer");
 Object.defineProperty(exports, "JavaScriptTransformer", { enumerable: true, get: function () { return javascript_transformer_1.JavaScriptTransformer; } });
 function createCompilerPlugin(pluginOptions, styleOptions) {
-    return (0, compiler_plugin_1.createCompilerPlugin)(pluginOptions, new component_stylesheets_1.ComponentStylesheetBundler(styleOptions, styleOptions.inlineStyleLanguage, pluginOptions.incremental));
+    return (0, compiler_plugin_1.createCompilerPlugin)(pluginOptions, pluginOptions.noopTypeScriptCompilation
+        ? new compilation_1.NoopCompilation()
+        : () => (0, compilation_1.createAngularCompilation)(!!pluginOptions.jit, !!pluginOptions.browserOnlyBuild), new component_stylesheets_1.ComponentStylesheetBundler(styleOptions, styleOptions.inlineStyleLanguage, pluginOptions.incremental));
 }
 // Utilities
 __exportStar(require("./utils/bundle-calculator"), exports);

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

@@ -6,6 +6,7 @@
  * found in the LICENSE file at https://angular.dev/license
  */
 import type { Plugin } from 'esbuild';
+import { AngularCompilation } from '../../angular/compilation';
 import { LoadResultCache } from '../load-result-cache';
 import { ComponentStylesheetBundler } from './component-stylesheets';
 import { SourceFileCache } from './source-file-cache';
@@ -13,9 +14,6 @@ export interface CompilerPluginOptions {
     sourcemap: boolean | 'external';
     tsconfig: string;
     jit?: boolean;
-    browserOnlyBuild?: boolean;
-    /** Skip TypeScript compilation setup. This is useful to re-use the TypeScript compilation from another plugin. */
-    noopTypeScriptCompilation?: boolean;
     advancedOptimizations?: boolean;
     thirdPartySourcemaps?: boolean;
     fileReplacements?: Record<string, string>;
@@ -26,4 +24,4 @@ export interface CompilerPluginOptions {
     instrumentForCoverage?: (request: string) => boolean;
     templateUpdates?: Map<string, string>;
 }
-export declare function createCompilerPlugin(pluginOptions: CompilerPluginOptions, stylesheetBundler: ComponentStylesheetBundler): Plugin;
+export declare function createCompilerPlugin(pluginOptions: CompilerPluginOptions, compilationOrFactory: AngularCompilation | (() => Promise<AngularCompilation>), stylesheetBundler: ComponentStylesheetBundler): Plugin;

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

@@ -56,7 +56,7 @@ const compilation_state_1 = require("./compilation-state");
 const file_reference_tracker_1 = require("./file-reference-tracker");
 const jit_plugin_callbacks_1 = require("./jit-plugin-callbacks");
 // eslint-disable-next-line max-lines-per-function
-function createCompilerPlugin(pluginOptions, stylesheetBundler) {
+function createCompilerPlugin(pluginOptions, compilationOrFactory, stylesheetBundler) {
     return {
         name: 'angular-compiler',
         // eslint-disable-next-line max-lines-per-function
@@ -94,16 +94,17 @@ function createCompilerPlugin(pluginOptions, stylesheetBundler) {
             // Setup defines based on the values used by the Angular compiler-cli
             build.initialOptions.define ??= {};
             build.initialOptions.define['ngI18nClosureMode'] ??= 'false';
+            // The factory is only relevant for compatibility purposes with the private API.
+            // TODO: Update private API in the next major to allow compilation function factory removal here.
+            const compilation = typeof compilationOrFactory === 'function'
+                ? await compilationOrFactory()
+                : compilationOrFactory;
             // The in-memory cache of TypeScript file outputs will be used during the build in `onLoad` callbacks for TS files.
             // A string value indicates direct TS/NG output and a Uint8Array indicates fully transformed code.
             const typeScriptFileCache = pluginOptions.sourceFileCache?.typeScriptFileCache ??
                 new Map();
             // The resources from component stylesheets and web workers that will be added to the build results output files
             const additionalResults = new Map();
-            // Create new reusable compilation for the appropriate mode based on the `jit` plugin option
-            const compilation = pluginOptions.noopTypeScriptCompilation
-                ? new compilation_1.NoopCompilation()
-                : await (0, compilation_1.createAngularCompilation)(!!pluginOptions.jit, !!pluginOptions.browserOnlyBuild);
             // Compilation is initially assumed to have errors until emitted
             let hasCompilationErrors = true;
             // Determines if TypeScript should process JavaScript files based on tsconfig `allowJs` option
@@ -128,8 +129,8 @@ function createCompilerPlugin(pluginOptions, stylesheetBundler) {
                 // Angular compiler which does not have direct knowledge of transitive resource
                 // dependencies or web worker processing.
                 let modifiedFiles;
-                if (pluginOptions.sourceFileCache?.modifiedFiles.size &&
-                    !pluginOptions.noopTypeScriptCompilation) {
+                if (!(compilation instanceof compilation_1.NoopCompilation) &&
+                    pluginOptions.sourceFileCache?.modifiedFiles.size) {
                     // TODO: Differentiate between changed input files and stale output files
                     modifiedFiles = referencedFileTracker.update(pluginOptions.sourceFileCache.modifiedFiles);
                     pluginOptions.sourceFileCache.invalidate(modifiedFiles);
@@ -141,9 +142,7 @@ function createCompilerPlugin(pluginOptions, stylesheetBundler) {
                     // Remove any stale additional results based on modified files
                     modifiedFiles.forEach((file) => additionalResults.delete(file));
                 }
-                if (!pluginOptions.noopTypeScriptCompilation &&
-                    compilation.update &&
-                    pluginOptions.sourceFileCache?.modifiedFiles.size) {
+                if (compilation.update && pluginOptions.sourceFileCache?.modifiedFiles.size) {
                     await compilation.update(modifiedFiles ?? pluginOptions.sourceFileCache.modifiedFiles);
                 }
                 // Create Angular compiler host options
@@ -523,6 +522,18 @@ function createCompilerOptionsTransformer(setupWarnings, pluginOptions, preserve
                 notes: [{ text: `The 'module' option will be set to 'ES2022' instead.` }],
             });
         }
+        if (compilerOptions.isolatedModules && compilerOptions.emitDecoratorMetadata) {
+            setupWarnings?.push({
+                text: `TypeScript compiler option 'isolatedModules' may prevent the 'emitDecoratorMetadata' option from emitting all metadata.`,
+                location: null,
+                notes: [
+                    {
+                        text: `The 'emitDecoratorMetadata' option is not required by Angular` +
+                            'and can be removed if not explictly required by the project.',
+                    },
+                ],
+            });
+        }
         // Synchronize custom resolve conditions.
         // Set if using the supported bundler resolution mode (bundler is the default in new projects)
         if (compilerOptions.moduleResolution === 100 /* ModuleResolutionKind.Bundler */) {

package/src/tools/esbuild/application-code-bundle.d.ts

@@ -7,11 +7,12 @@
  */
 import type { BuildOptions } from 'esbuild';
 import type { NormalizedApplicationBuildOptions } from '../../builders/application/options';
+import { AngularCompilation } from '../angular/compilation';
 import { ComponentStylesheetBundler } from './angular/component-stylesheets';
 import { SourceFileCache } from './angular/source-file-cache';
 import { BundlerOptionsFactory } from './bundler-context';
 import type { LoadResultCache } from './load-result-cache';
-export declare function createBrowserCodeBundleOptions(options: NormalizedApplicationBuildOptions, target: string[], sourceFileCache: SourceFileCache, stylesheetBundler: ComponentStylesheetBundler, templateUpdates: Map<string, string> | undefined): BundlerOptionsFactory;
+export declare function createBrowserCodeBundleOptions(options: NormalizedApplicationBuildOptions, target: string[], sourceFileCache: SourceFileCache, stylesheetBundler: ComponentStylesheetBundler, angularCompilation: AngularCompilation, templateUpdates: Map<string, string> | undefined): BundlerOptionsFactory;
 export declare function createBrowserPolyfillBundleOptions(options: NormalizedApplicationBuildOptions, target: string[], sourceFileCache: SourceFileCache, stylesheetBundler: ComponentStylesheetBundler): BuildOptions | BundlerOptionsFactory | undefined;
 export declare function createServerPolyfillBundleOptions(options: NormalizedApplicationBuildOptions, target: string[], loadResultCache: LoadResultCache | undefined): BundlerOptionsFactory | undefined;
 export declare function createServerMainCodeBundleOptions(options: NormalizedApplicationBuildOptions, target: string[], sourceFileCache: SourceFileCache, stylesheetBundler: ComponentStylesheetBundler): BundlerOptionsFactory;

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

@@ -21,6 +21,7 @@ const node_path_1 = require("node:path");
 const schema_1 = require("../../builders/application/schema");
 const environment_options_1 = require("../../utils/environment-options");
 const manifest_1 = require("../../utils/server-rendering/manifest");
+const compilation_1 = require("../angular/compilation");
 const compiler_plugin_1 = require("./angular/compiler-plugin");
 const angular_localize_init_warning_plugin_1 = require("./angular-localize-init-warning-plugin");
 const compiler_plugin_options_1 = require("./compiler-plugin-options");
@@ -33,7 +34,7 @@ const sourcemap_ignorelist_plugin_1 = require("./sourcemap-ignorelist-plugin");
 const utils_1 = require("./utils");
 const virtual_module_plugin_1 = require("./virtual-module-plugin");
 const wasm_plugin_1 = require("./wasm-plugin");
-function createBrowserCodeBundleOptions(options, target, sourceFileCache, stylesheetBundler, templateUpdates) {
+function createBrowserCodeBundleOptions(options, target, sourceFileCache, stylesheetBundler, angularCompilation, templateUpdates) {
     return (loadCache) => {
         const { entryPoints, outputNames, polyfills } = options;
         const pluginOptions = (0, compiler_plugin_options_1.createCompilerPluginOptions)(options, sourceFileCache, loadCache, templateUpdates);
@@ -57,7 +58,7 @@ function createBrowserCodeBundleOptions(options, target, sourceFileCache, styles
                 (0, angular_localize_init_warning_plugin_1.createAngularLocalizeInitWarningPlugin)(),
                 (0, compiler_plugin_1.createCompilerPlugin)(
                 // JS/TS options
-                pluginOptions, 
+                pluginOptions, angularCompilation, 
                 // Component stylesheet bundler
                 stylesheetBundler),
             ],
@@ -65,19 +66,7 @@ function createBrowserCodeBundleOptions(options, target, sourceFileCache, styles
         if (options.plugins) {
             buildOptions.plugins?.push(...options.plugins);
         }
-        if (options.externalPackages) {
-            // Package files affected by a customized loader should not be implicitly marked as external
-            if (options.loaderExtensions ||
-                options.plugins ||
-                typeof options.externalPackages === 'object') {
-                // Plugin must be added after custom plugins to ensure any added loader options are considered
-                buildOptions.plugins?.push((0, external_packages_plugin_1.createExternalPackagesPlugin)(options.externalPackages !== true ? options.externalPackages : undefined));
-            }
-            else {
-                // Safe to use the packages external option directly
-                buildOptions.packages = 'external';
-            }
-        }
+        appendOptionsForExternalPackages(options, buildOptions);
         return buildOptions;
     };
 }
@@ -109,7 +98,9 @@ function createBrowserPolyfillBundleOptions(options, target, sourceFileCache, st
         const pluginOptions = (0, compiler_plugin_options_1.createCompilerPluginOptions)(options, sourceFileCache);
         buildOptions.plugins.push((0, compiler_plugin_1.createCompilerPlugin)(
         // JS/TS options
-        { ...pluginOptions, noopTypeScriptCompilation: true }, 
+        pluginOptions, 
+        // Browser compilation handles the actual Angular code compilation
+        new compilation_1.NoopCompilation(), 
         // Component stylesheet options are unused for polyfills but required by the plugin
         stylesheetBundler));
     }
@@ -201,16 +192,15 @@ function createServerMainCodeBundleOptions(options, target, sourceFileCache, sty
                 (0, angular_localize_init_warning_plugin_1.createAngularLocalizeInitWarningPlugin)(),
                 (0, compiler_plugin_1.createCompilerPlugin)(
                 // JS/TS options
-                { ...pluginOptions, noopTypeScriptCompilation: true }, 
+                pluginOptions, 
+                // Browser compilation handles the actual Angular code compilation
+                new compilation_1.NoopCompilation(), 
                 // Component stylesheet bundler
                 stylesheetBundler),
             ],
         };
         buildOptions.plugins ??= [];
-        if (externalPackages) {
-            buildOptions.packages = 'external';
-        }
-        else {
+        if (!externalPackages) {
             buildOptions.plugins.push((0, rxjs_esm_resolution_plugin_1.createRxjsEsmResolutionPlugin)());
         }
         // Mark manifest and polyfills file as external as these are generated by a different bundle step.
@@ -269,6 +259,7 @@ function createServerMainCodeBundleOptions(options, target, sourceFileCache, sty
         if (options.plugins) {
             buildOptions.plugins.push(...options.plugins);
         }
+        appendOptionsForExternalPackages(options, buildOptions);
         return buildOptions;
     };
 }
@@ -305,16 +296,15 @@ function createSsrEntryCodeBundleOptions(options, target, sourceFileCache, style
                 (0, angular_localize_init_warning_plugin_1.createAngularLocalizeInitWarningPlugin)(),
                 (0, compiler_plugin_1.createCompilerPlugin)(
                 // JS/TS options
-                { ...pluginOptions, noopTypeScriptCompilation: true }, 
+                pluginOptions, 
+                // Browser compilation handles the actual Angular code compilation
+                new compilation_1.NoopCompilation(), 
                 // Component stylesheet bundler
                 stylesheetBundler),
             ],
         };
         buildOptions.plugins ??= [];
-        if (externalPackages) {
-            buildOptions.packages = 'external';
-        }
-        else {
+        if (!externalPackages) {
             buildOptions.plugins.push((0, rxjs_esm_resolution_plugin_1.createRxjsEsmResolutionPlugin)());
         }
         // Mark manifest file as external. As this will be generated later on.
@@ -370,6 +360,7 @@ function createSsrEntryCodeBundleOptions(options, target, sourceFileCache, style
         if (options.plugins) {
             buildOptions.plugins.push(...options.plugins);
         }
+        appendOptionsForExternalPackages(options, buildOptions);
         return buildOptions;
     };
 }
@@ -528,3 +519,19 @@ function entryFileToWorkspaceRelative(workspaceRoot, entryFile) {
             .replace(/.[mc]?ts$/, '')
             .replace(/\\/g, '/'));
 }
+function appendOptionsForExternalPackages(options, buildOptions) {
+    if (!options.externalPackages) {
+        return;
+    }
+    buildOptions.plugins ??= [];
+    // Package files affected by a customized loader should not be implicitly marked as external
+    if (options.loaderExtensions || options.plugins || typeof options.externalPackages === 'object') {
+        // Plugin must be added after custom plugins to ensure any added loader options are considered
+        buildOptions.plugins.push((0, external_packages_plugin_1.createExternalPackagesPlugin)(options.externalPackages !== true ? options.externalPackages : undefined));
+        buildOptions.packages = undefined;
+    }
+    else {
+        // Safe to use the packages external option directly
+        buildOptions.packages = 'external';
+    }
+}

package/src/tools/esbuild/bundler-execution-result.d.ts

@@ -22,10 +22,11 @@ export interface RebuildState {
     componentStyleBundler: ComponentStylesheetBundler;
     codeBundleCache?: SourceFileCache;
     fileChanges: ChangedFiles;
-    previousOutputInfo: Map<string, {
+    previousOutputInfo: ReadonlyMap<string, {
         hash: string;
         type: BuildOutputFileType;
     }>;
+    previousAssetsInfo: ReadonlyMap<string, string>;
     templateUpdates?: Map<string, string>;
 }
 export interface ExternalResultMetadata {
@@ -86,7 +87,7 @@ export declare class ExecutionResult {
     };
     get watchFiles(): Readonly<string[]>;
     createRebuildState(fileChanges: ChangedFiles): RebuildState;
-    findChangedFiles(previousOutputHashes: Map<string, {
+    findChangedFiles(previousOutputHashes: ReadonlyMap<string, {
         hash: string;
         type: BuildOutputFileType;
     }>): Set<string>;

package/src/tools/esbuild/bundler-execution-result.js

@@ -123,6 +123,7 @@ class ExecutionResult {
             componentStyleBundler: this.componentStyleBundler,
             fileChanges,
             previousOutputInfo: new Map(this.outputFiles.map(({ path, hash, type }) => [path, { hash, type }])),
+            previousAssetsInfo: new Map(this.assetFiles.map(({ source, destination }) => [source, destination])),
             templateUpdates: this.templateUpdates,
         };
     }

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

@@ -12,7 +12,6 @@ function createCompilerPluginOptions(options, sourceFileCache, loadResultCache,
     const { sourcemapOptions, tsconfig, fileReplacements, advancedOptimizations, jit, externalRuntimeStyles, instrumentForCoverage, } = options;
     const incremental = !!options.watch;
     return {
-        browserOnlyBuild: !options.serverEntryPoint,
         sourcemap: !!sourcemapOptions.scripts && (sourcemapOptions.hidden ? 'external' : true),
         thirdPartySourcemaps: sourcemapOptions.vendor,
         tsconfig,

package/src/tools/vite/middlewares/assets-middleware.d.ts

@@ -6,10 +6,10 @@
  * found in the LICENSE file at https://angular.dev/license
  */
 import type { Connect, ViteDevServer } from 'vite';
-import { AngularMemoryOutputFiles } from '../utils';
+import { AngularMemoryOutputFiles, AngularOutputAssets } from '../utils';
 export interface ComponentStyleRecord {
     rawContent: Uint8Array;
     used?: Set<string>;
     reload?: boolean;
 }
-export declare function createAngularAssetsMiddleware(server: ViteDevServer, assets: Map<string, string>, outputFiles: AngularMemoryOutputFiles, componentStyles: Map<string, ComponentStyleRecord>, encapsulateStyle: (style: Uint8Array, componentId: string) => string): Connect.NextHandleFunction;
+export declare function createAngularAssetsMiddleware(server: ViteDevServer, assets: AngularOutputAssets, outputFiles: AngularMemoryOutputFiles, componentStyles: Map<string, ComponentStyleRecord>, encapsulateStyle: (style: Uint8Array, componentId: string) => string): Connect.NextHandleFunction;

package/src/tools/vite/middlewares/assets-middleware.js

@@ -22,15 +22,15 @@ function createAngularAssetsMiddleware(server, assets, outputFiles, componentSty
         const extension = (0, node_path_1.extname)(pathname);
         const pathnameHasTrailingSlash = pathname[pathname.length - 1] === '/';
         // Rewrite all build assets to a vite raw fs URL
-        const assetSourcePath = assets.get(pathname);
-        if (assetSourcePath !== undefined) {
+        const asset = assets.get(pathname);
+        if (asset) {
             // Workaround to disable Vite transformer middleware.
             // See: https://github.com/vitejs/vite/blob/746a1daab0395f98f0afbdee8f364cb6cf2f3b3f/packages/vite/src/node/server/middlewares/transform.ts#L201 and
             // https://github.com/vitejs/vite/blob/746a1daab0395f98f0afbdee8f364cb6cf2f3b3f/packages/vite/src/node/server/transformRequest.ts#L204-L206
             req.headers.accept = 'text/html';
             // The encoding needs to match what happens in the vite static middleware.
             // ref: https://github.com/vitejs/vite/blob/d4f13bd81468961c8c926438e815ab6b1c82735e/packages/vite/src/node/server/middlewares/static.ts#L163
-            req.url = `${server.config.base}@fs/${encodeURI(assetSourcePath)}`;
+            req.url = `${server.config.base}@fs/${encodeURI(asset.source)}`;
             next();
             return;
         }
@@ -43,7 +43,7 @@ function createAngularAssetsMiddleware(server, assets, outputFiles, componentSty
             : // Non-trailing slash check for fallback `.html`
                 assets.get(pathname + '.html');
         if (htmlAssetSourcePath) {
-            req.url = `${server.config.base}@fs/${encodeURI(htmlAssetSourcePath)}`;
+            req.url = `${server.config.base}@fs/${encodeURI(htmlAssetSourcePath.source)}`;
             next();
             return;
         }

package/src/tools/vite/plugins/setup-middlewares-plugin.d.ts

@@ -7,7 +7,7 @@
  */
 import type { Connect, Plugin } from 'vite';
 import { ComponentStyleRecord } from '../middlewares';
-import { AngularMemoryOutputFiles } from '../utils';
+import { AngularMemoryOutputFiles, AngularOutputAssets } from '../utils';
 export declare enum ServerSsrMode {
     /**
      * No SSR
@@ -32,7 +32,7 @@ export declare enum ServerSsrMode {
 }
 interface AngularSetupMiddlewaresPluginOptions {
     outputFiles: AngularMemoryOutputFiles;
-    assets: Map<string, string>;
+    assets: AngularOutputAssets;
     extensionMiddleware?: Connect.NextHandleFunction[];
     indexHtmlTransformer?: (content: string) => Promise<string>;
     componentStyles: Map<string, ComponentStyleRecord>;

package/src/tools/vite/utils.d.ts

@@ -12,6 +12,9 @@ export type AngularMemoryOutputFiles = Map<string, {
     hash: string;
     servable: boolean;
 }>;
+export type AngularOutputAssets = Map<string, {
+    source: string;
+}>;
 export declare function pathnameWithoutBasePath(url: string, basePath: string): string;
 export declare function lookupMimeTypeFromRequest(url: string): string | undefined;
 export type EsbuildLoaderOption = Exclude<DepOptimizationConfig['esbuildOptions'], undefined>['loader'];

package/src/utils/environment-options.js

@@ -83,7 +83,7 @@ exports.useJSONBuildLogs = isPresent(buildLogsJsonVariable) && isEnabled(buildLo
 const optimizeChunksVariable = process.env['NG_BUILD_OPTIMIZE_CHUNKS'];
 exports.shouldOptimizeChunks = isPresent(optimizeChunksVariable) && isEnabled(optimizeChunksVariable);
 const hmrComponentStylesVariable = process.env['NG_HMR_CSTYLES'];
-exports.useComponentStyleHmr = !isPresent(hmrComponentStylesVariable) || !isDisabled(hmrComponentStylesVariable);
+exports.useComponentStyleHmr = isPresent(hmrComponentStylesVariable) && isEnabled(hmrComponentStylesVariable);
 const hmrComponentTemplateVariable = process.env['NG_HMR_TEMPLATES'];
 exports.useComponentTemplateHmr = !isPresent(hmrComponentTemplateVariable) || !isDisabled(hmrComponentTemplateVariable);
 const partialSsrBuildVariable = process.env['NG_BUILD_PARTIAL_SSR'];

package/src/utils/i18n-options.js

@@ -39,7 +39,7 @@ function ensureString(value, name) {
         throw new Error(`Project field '${name}' is malformed. Expected a string.`);
     }
 }
-function ensureValidsubPath(value, name) {
+function ensureValidSubPath(value, name) {
     ensureString(value, name);
     if (!/^[\w-]*$/.test(value)) {
         throw new Error(`Project field '${name}' is invalid. It can only contain letters, numbers, hyphens, and underscores.`);
@@ -78,7 +78,7 @@ function createI18nOptions(projectMetadata, inline, logger) {
             rawSourceLocaleBaseHref = metadata.sourceLocale.baseHref;
         }
         if (metadata.sourceLocale.subPath !== undefined) {
-            ensureValidsubPath(metadata.sourceLocale.subPath, 'i18n.sourceLocale.subPath');
+            ensureValidSubPath(metadata.sourceLocale.subPath, 'i18n.sourceLocale.subPath');
             rawsubPath = metadata.sourceLocale.subPath;
         }
         if (rawsubPath !== undefined && rawSourceLocaleBaseHref !== undefined) {
@@ -111,7 +111,7 @@ function createI18nOptions(projectMetadata, inline, logger) {
                     baseHref = options.baseHref;
                 }
                 if ('subPath' in options) {
-                    ensureString(options.subPath, `i18n.locales.${locale}.subPath`);
+                    ensureValidSubPath(options.subPath, `i18n.locales.${locale}.subPath`);
                     subPath = options.subPath;
                 }
                 if (subPath !== undefined && baseHref !== undefined) {

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 = '19.1.0-rc.0';
+const VERSION = '19.1.0';
 function hasCacheMetadata(value) {
     return (!!value &&
         typeof value === 'object' &&