@angular/build 19.1.0-next.2 → 19.1.0-rc.0

package/LICENSE

@@ -1,6 +1,6 @@
 The MIT License
 
-Copyright (c) 2010-2024 Google LLC. https://angular.dev/license
+Copyright (c) 2010-2025 Google LLC. https://angular.dev/license
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/builders.json

@@ -14,6 +14,11 @@
       "implementation": "./src/builders/extract-i18n/index",
       "schema": "./src/builders/extract-i18n/schema.json",
       "description": "Extract i18n messages from an application."
+    },
+    "ng-packagr": {
+      "implementation": "./src/builders/ng-packagr/index",
+      "schema": "./src/builders/ng-packagr/schema.json",
+      "description": "Build a library with ng-packagr."
     }
   }
 }

package/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * 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
+ */
+export * from './src/index';

package/index.js

@@ -0,0 +1,24 @@
+"use strict";
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * 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
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./src/index"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular/build",
-  "version": "19.1.0-next.2",
+  "version": "19.1.0-rc.0",
   "description": "Official build system for Angular",
   "keywords": [
     "Angular CLI",
@@ -23,33 +23,33 @@
   "builders": "builders.json",
   "dependencies": {
     "@ampproject/remapping": "2.3.0",
-    "@angular-devkit/architect": "0.1901.0-next.2",
+    "@angular-devkit/architect": "0.1901.0-rc.0",
     "@babel/core": "7.26.0",
     "@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.0",
+    "@inquirer/confirm": "5.1.1",
     "@vitejs/plugin-basic-ssl": "1.2.0",
     "beasties": "0.2.0",
     "browserslist": "^4.23.0",
-    "esbuild": "0.24.0",
-    "fast-glob": "3.3.2",
+    "esbuild": "0.24.2",
+    "fast-glob": "3.3.3",
     "https-proxy-agent": "7.0.6",
     "istanbul-lib-instrument": "6.0.3",
     "listr2": "8.2.5",
-    "magic-string": "0.30.15",
+    "magic-string": "0.30.17",
     "mrmime": "2.0.0",
     "parse5-html-rewriting-stream": "7.0.0",
     "picomatch": "4.0.2",
     "piscina": "4.8.0",
-    "rollup": "4.28.1",
-    "sass": "1.83.0",
+    "rollup": "4.30.1",
+    "sass": "1.83.1",
     "semver": "7.6.3",
-    "vite": "6.0.3",
+    "vite": "6.0.7",
     "watchpack": "2.4.2"
   },
   "optionalDependencies": {
-    "lmdb": "3.2.0"
+    "lmdb": "3.2.2"
   },
   "peerDependencies": {
     "@angular/compiler": "^19.0.0 || ^19.1.0-next.0",
@@ -57,8 +57,9 @@
     "@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-next.2",
+    "@angular/ssr": "^19.1.0-rc.0",
     "less": "^4.2.0",
+    "ng-packagr": "^19.0.0 || ^19.1.0-next.0",
     "postcss": "^8.4.0",
     "tailwindcss": "^2.0.0 || ^3.0.0",
     "typescript": ">=5.5 <5.8"
@@ -79,6 +80,9 @@
     "less": {
       "optional": true
     },
+    "ng-packagr": {
+      "optional": true
+    },
     "postcss": {
       "optional": true
     },

package/private/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * 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
+ */
+export * from '../src/private';

package/private/index.js

@@ -0,0 +1,24 @@
+"use strict";
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * 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
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("../src/private"), exports);

package/src/builders/application/build-action.d.ts

@@ -25,4 +25,5 @@ export declare function runEsBuildBuildAction(action: (rebuildState?: RebuildSta
     clearScreen?: boolean;
     colors?: boolean;
     jsonLogs?: boolean;
+    incrementalResults?: boolean;
 }): AsyncIterable<Result>;

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

@@ -65,7 +65,7 @@ const packageWatchFiles = [
     '.pnp.data.json',
 ];
 async function* runEsBuildBuildAction(action, options) {
-    const { watch, poll, clearScreen, logger, cacheOptions, outputOptions, verbose, projectRoot, workspaceRoot, progress, preserveSymlinks, colors, jsonLogs, } = options;
+    const { watch, poll, clearScreen, logger, cacheOptions, outputOptions, verbose, projectRoot, workspaceRoot, progress, preserveSymlinks, colors, jsonLogs, incrementalResults, } = options;
     const withProgress = progress ? utils_1.withSpinner : utils_1.withNoProgress;
     // Initial build
     let result;
@@ -122,7 +122,7 @@ async function* runEsBuildBuildAction(action, options) {
     // Output the first build results after setting up the watcher to ensure that any code executed
     // higher in the iterator call stack will trigger the watcher. This is particularly relevant for
     // unit tests which execute the builder and modify the file system programmatically.
-    yield await emitOutputResult(result, outputOptions);
+    yield* emitOutputResults(result, outputOptions);
     // Finish if watch mode is not enabled
     if (!watcher) {
         return;
@@ -143,7 +143,8 @@ async function* runEsBuildBuildAction(action, options) {
             }
             // Clear removed files from current watch files
             changes.removed.forEach((removedPath) => currentWatchFiles.delete(removedPath));
-            result = await withProgress('Changes detected. Rebuilding...', () => action(result.createRebuildState(changes)));
+            const rebuildState = result.createRebuildState(changes);
+            result = await withProgress('Changes detected. Rebuilding...', () => action(rebuildState));
             // Log all diagnostic (error/warning/logs) messages
             await (0, utils_1.logMessages)(logger, result, colors, jsonLogs);
             // Update watched locations provided by the new build result.
@@ -163,7 +164,9 @@ async function* runEsBuildBuildAction(action, options) {
             if (staleWatchFiles?.size) {
                 watcher.remove([...staleWatchFiles]);
             }
-            yield await emitOutputResult(result, outputOptions);
+            for (const outputResult of emitOutputResults(result, outputOptions, incrementalResults ? rebuildState.previousOutputInfo : undefined)) {
+                yield outputResult;
+            }
         }
     }
     finally {
@@ -172,9 +175,9 @@ async function* runEsBuildBuildAction(action, options) {
         (0, sass_language_1.shutdownSassWorkerPool)();
     }
 }
-async function emitOutputResult({ outputFiles, assetFiles, errors, warnings, externalMetadata, htmlIndexPath, htmlBaseHref, templateUpdates, }, outputOptions) {
+function* emitOutputResults({ outputFiles, assetFiles, errors, warnings, externalMetadata, htmlIndexPath, htmlBaseHref, templateUpdates, }, outputOptions, previousOutputInfo) {
     if (errors.length > 0) {
-        return {
+        yield {
             kind: results_1.ResultKind.Failure,
             errors: errors,
             warnings: warnings,
@@ -182,19 +185,85 @@ async function emitOutputResult({ outputFiles, assetFiles, errors, warnings, ext
                 outputOptions,
             },
         };
+        return;
     }
-    // Template updates only exist if no other changes have occurred
-    if (templateUpdates?.size) {
+    // Template updates only exist if no other JS changes have occurred
+    const hasTemplateUpdates = !!templateUpdates?.size;
+    if (hasTemplateUpdates) {
         const updateResult = {
             kind: results_1.ResultKind.ComponentUpdate,
-            updates: Array.from(templateUpdates).map(([id, content]) => ({
+            updates: Array.from(templateUpdates, ([id, content]) => ({
                 type: 'template',
                 id,
                 content,
             })),
         };
-        return updateResult;
+        yield updateResult;
+    }
+    // Use an incremental result if previous output information is available
+    if (previousOutputInfo) {
+        const incrementalResult = {
+            kind: results_1.ResultKind.Incremental,
+            warnings: warnings,
+            added: [],
+            removed: [],
+            modified: [],
+            files: {},
+            detail: {
+                externalMetadata,
+                htmlIndexPath,
+                htmlBaseHref,
+                outputOptions,
+            },
+        };
+        // Initially assume all previous output files have been removed
+        const removedOutputFiles = new Map(previousOutputInfo);
+        for (const file of outputFiles) {
+            removedOutputFiles.delete(file.path);
+            // Temporarily ignore JS files until Angular compiler plugin refactor to allow
+            // bypassing application code bundling for template affecting only changes.
+            // TODO: Remove once refactor is complete.
+            if (hasTemplateUpdates && /\.js(?:\.map)?$/.test(file.path)) {
+                continue;
+            }
+            const previousHash = previousOutputInfo.get(file.path)?.hash;
+            let needFile = false;
+            if (previousHash === undefined) {
+                needFile = true;
+                incrementalResult.added.push(file.path);
+            }
+            else if (previousHash !== file.hash) {
+                needFile = true;
+                incrementalResult.modified.push(file.path);
+            }
+            if (needFile) {
+                incrementalResult.files[file.path] = {
+                    type: file.type,
+                    contents: file.contents,
+                    origin: 'memory',
+                    hash: file.hash,
+                };
+            }
+        }
+        // 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] = {
+                type: bundler_context_1.BuildOutputFileType.Browser,
+                inputPath: file.source,
+                origin: 'disk',
+            };
+        }
+        yield incrementalResult;
+        return;
     }
+    // Otherwise, use a full result
     const result = {
         kind: results_1.ResultKind.Full,
         warnings: warnings,
@@ -221,5 +290,5 @@ async function emitOutputResult({ outputFiles, assetFiles, errors, warnings, ext
             hash: file.hash,
         };
     }
-    return result;
+    yield result;
 }

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

@@ -145,7 +145,7 @@ async function executeBuild(options, context, rebuildState) {
     }
     const { metafile, initialFiles, outputFiles } = bundlingResult;
     executionResult.outputFiles.push(...outputFiles);
-    const changedFiles = rebuildState && executionResult.findChangedFiles(rebuildState.previousOutputHashes);
+    const changedFiles = rebuildState && executionResult.findChangedFiles(rebuildState.previousOutputInfo);
     // Analyze files for bundle budget failures if present
     let budgetFailures;
     if (options.budgets) {

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

@@ -6,7 +6,6 @@
  * found in the LICENSE file at https://angular.dev/license
  */
 import { BuilderContext, BuilderOutput } from '@angular-devkit/architect';
-import { BuildOutputFile } from '../../tools/esbuild/bundler-context';
 import { ApplicationBuilderExtensions, ApplicationBuilderInternalOptions } from './options';
 import { Result } from './results';
 import { Schema as ApplicationBuilderOptions } from './schema';
@@ -14,13 +13,6 @@ export type { ApplicationBuilderOptions };
 export declare function buildApplicationInternal(options: ApplicationBuilderInternalOptions, context: BuilderContext & {
     signal?: AbortSignal;
 }, extensions?: ApplicationBuilderExtensions): AsyncIterable<Result>;
-export interface ApplicationBuilderOutput extends BuilderOutput {
-    outputFiles?: BuildOutputFile[];
-    assetFiles?: {
-        source: string;
-        destination: string;
-    }[];
-}
 /**
  * Builds an application using the `application` builder with the provided
  * options.
@@ -35,6 +27,6 @@ export interface ApplicationBuilderOutput extends BuilderOutput {
  * @param extensions An object contain extension points for the build.
  * @returns The build output results of the build.
  */
-export declare function buildApplication(options: ApplicationBuilderOptions, context: BuilderContext, extensions?: ApplicationBuilderExtensions): AsyncIterable<ApplicationBuilderOutput>;
-declare const _default: import("../../../../../angular_devkit/architect/src/internal").Builder<ApplicationBuilderOptions & import("../../../../../angular_devkit/core/src").JsonObject>;
+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;

package/src/builders/application/index.js

@@ -96,6 +96,7 @@ context, extensions) {
         clearScreen: normalizedOptions.clearScreen,
         colors: normalizedOptions.colors,
         jsonLogs: normalizedOptions.jsonLogs,
+        incrementalResults: normalizedOptions.incrementalResults,
         logger,
         signal,
     });
@@ -116,7 +117,8 @@ context, extensions) {
  */
 async function* buildApplication(options, context, extensions) {
     let initial = true;
-    for await (const result of buildApplicationInternal(options, context, extensions)) {
+    const internalOptions = { ...options, incrementalResults: true };
+    for await (const result of buildApplicationInternal(internalOptions, context, extensions)) {
         const outputOptions = result.detail?.['outputOptions'];
         if (initial) {
             initial = false;
@@ -134,7 +136,7 @@ async function* buildApplication(options, context, extensions) {
             continue;
         }
         (0, node_assert_1.default)(outputOptions, 'Application output options are required for builder usage.');
-        (0, node_assert_1.default)(result.kind === results_1.ResultKind.Full, 'Application build did not provide a full output.');
+        (0, node_assert_1.default)(result.kind === results_1.ResultKind.Full || result.kind === results_1.ResultKind.Incremental, 'Application build did not provide a file result output.');
         // TODO: Restructure output logging to better handle stdout JSON piping
         if (!environment_options_1.useJSONBuildLogs) {
             context.logger.info(`Output location: ${outputOptions.base}\n`);
@@ -147,24 +149,7 @@ async function* buildApplication(options, context, extensions) {
                     file.type === bundler_context_1.BuildOutputFileType.ServerRoot)) {
                 return;
             }
-            let typeDirectory;
-            switch (file.type) {
-                case bundler_context_1.BuildOutputFileType.Browser:
-                case bundler_context_1.BuildOutputFileType.Media:
-                    typeDirectory = outputOptions.browser;
-                    break;
-                case bundler_context_1.BuildOutputFileType.ServerApplication:
-                case bundler_context_1.BuildOutputFileType.ServerRoot:
-                    typeDirectory = outputOptions.server;
-                    break;
-                case bundler_context_1.BuildOutputFileType.Root:
-                    typeDirectory = '';
-                    break;
-                default:
-                    throw new Error(`Unhandled write for file "${filePath}" with type "${bundler_context_1.BuildOutputFileType[file.type]}".`);
-            }
-            // NOTE: 'base' is a fully resolved path at this point
-            const fullFilePath = node_path_1.default.join(outputOptions.base, typeDirectory, filePath);
+            const fullFilePath = generateFullPath(filePath, file.type, outputOptions);
             // Ensure output subdirectories exist
             const fileBasePath = node_path_1.default.dirname(fullFilePath);
             if (fileBasePath && !directoryExists.has(fileBasePath)) {
@@ -180,7 +165,35 @@ async function* buildApplication(options, context, extensions) {
                 await promises_1.default.copyFile(file.inputPath, fullFilePath, promises_1.default.constants.COPYFILE_FICLONE);
             }
         });
+        // Delete any removed files if incremental
+        if (result.kind === results_1.ResultKind.Incremental && result.removed?.length) {
+            await Promise.all(result.removed.map((file) => {
+                const fullFilePath = generateFullPath(file.path, file.type, outputOptions);
+                return promises_1.default.rm(fullFilePath, { force: true, maxRetries: 3 });
+            }));
+        }
         yield { success: true };
     }
 }
+function generateFullPath(filePath, type, outputOptions) {
+    let typeDirectory;
+    switch (type) {
+        case bundler_context_1.BuildOutputFileType.Browser:
+        case bundler_context_1.BuildOutputFileType.Media:
+            typeDirectory = outputOptions.browser;
+            break;
+        case bundler_context_1.BuildOutputFileType.ServerApplication:
+        case bundler_context_1.BuildOutputFileType.ServerRoot:
+            typeDirectory = outputOptions.server;
+            break;
+        case bundler_context_1.BuildOutputFileType.Root:
+            typeDirectory = '';
+            break;
+        default:
+            throw new Error(`Unhandled write for file "${filePath}" with type "${bundler_context_1.BuildOutputFileType[type]}".`);
+    }
+    // NOTE: 'base' is a fully resolved path at this point
+    const fullFilePath = node_path_1.default.join(outputOptions.base, typeDirectory, filePath);
+    return fullFilePath;
+}
 exports.default = (0, architect_1.createBuilder)(buildApplication);

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

@@ -74,6 +74,11 @@ interface InternalOptions {
      * template updates.
      */
     templateUpdates?: boolean;
+    /**
+     * Enables emitting incremental build results when in watch mode. A full build result will only be emitted
+     * for the initial build. This option also requires watch to be enabled to have an effect.
+     */
+    incrementalResults?: boolean;
     /**
      * Enables instrumentation to collect code coverage data for specific files.
      *
@@ -193,6 +198,7 @@ export declare function normalizeOptions(context: BuilderContext, projectName: s
     instrumentForCoverage: ((filename: string) => boolean) | undefined;
     security: import("./schema").Security | undefined;
     templateUpdates: boolean;
+    incrementalResults: boolean;
 }>;
 export declare function getLocaleBaseHref(baseHref: string | undefined, i18n: NormalizedApplicationBuildOptions['i18nOptions'], locale: string): string | undefined;
 export {};

package/src/builders/application/options.js

@@ -298,6 +298,7 @@ async function normalizeOptions(context, projectName, options, extensions) {
         instrumentForCoverage,
         security,
         templateUpdates: !!options.templateUpdates,
+        incrementalResults: !!options.incrementalResults,
     };
 }
 async function getTailwindConfig(searchDirectories, workspaceRoot, context) {

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

@@ -30,7 +30,10 @@ export interface FullResult extends BaseResult {
 export interface IncrementalResult extends BaseResult {
     kind: ResultKind.Incremental;
     added: string[];
-    removed: string[];
+    removed: {
+        path: string;
+        type: BuildOutputFileType;
+    }[];
     modified: string[];
     files: Record<string, ResultFile>;
 }

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

@@ -9,6 +9,6 @@ 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/src").JsonObject>;
+declare const _default: import("../../../../../angular_devkit/architect/src/internal").Builder<DevServerBuilderOptions & import("../../../../../angular_devkit/core").JsonObject>;
 export default _default;
 export { execute as executeDevServer };

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

@@ -34,5 +34,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, 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, 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 {};