@angular/build 19.1.4 → 19.1.6

package/README.md

@@ -2,4 +2,4 @@
 
 The sources for this package are in the [Angular CLI](https://github.com/angular/angular-cli) repository. Please file issues and pull requests against that repository.
 
-Usage information and reference details can be found in repository [README](../../../README.md) file.
+Usage information and reference details can be found in repository [README](https://github.com/angular/angular-cli/blob/main/README.md) file.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular/build",
-  "version": "19.1.4",
+  "version": "19.1.6",
   "description": "Official build system for Angular",
   "keywords": [
     "Angular CLI",
@@ -23,7 +23,8 @@
   "builders": "builders.json",
   "dependencies": {
     "@ampproject/remapping": "2.3.0",
-    "@angular-devkit/architect": "0.1901.4",
+    "@angular-devkit/core": "19.1.6",
+    "@angular-devkit/architect": "0.1901.6",
     "@babel/core": "7.26.0",
     "@babel/helper-annotate-as-pure": "7.25.9",
     "@babel/helper-split-export-declaration": "7.24.7",
@@ -45,7 +46,7 @@
     "rollup": "4.30.1",
     "sass": "1.83.1",
     "semver": "7.6.3",
-    "vite": "6.0.7",
+    "vite": "6.0.11",
     "watchpack": "2.4.2"
   },
   "optionalDependencies": {
@@ -57,11 +58,11 @@
     "@angular/localize": "^19.0.0",
     "@angular/platform-server": "^19.0.0",
     "@angular/service-worker": "^19.0.0",
-    "@angular/ssr": "^19.1.4",
+    "@angular/ssr": "^19.1.6",
     "less": "^4.2.0",
     "ng-packagr": "^19.0.0",
     "postcss": "^8.4.0",
-    "tailwindcss": "^2.0.0 || ^3.0.0",
+    "tailwindcss": "^2.0.0 || ^3.0.0 || ^4.0.0",
     "typescript": ">=5.5 <5.8"
   },
   "peerDependenciesMeta": {

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

@@ -127,6 +127,9 @@ async function* runEsBuildBuildAction(action, options) {
     if (!watcher) {
         return;
     }
+    // Used to force a full result on next rebuild if there were initial errors.
+    // This ensures at least one full result is emitted.
+    let hasInitialErrors = result.errors.length > 0;
     // Wait for changes and rebuild as needed
     const currentWatchFiles = new Set(result.watchFiles);
     try {
@@ -164,9 +167,11 @@ async function* runEsBuildBuildAction(action, options) {
             if (staleWatchFiles?.size) {
                 watcher.remove([...staleWatchFiles]);
             }
-            for (const outputResult of emitOutputResults(result, outputOptions, changes, incrementalResults ? rebuildState : undefined)) {
+            for (const outputResult of emitOutputResults(result, outputOptions, changes, incrementalResults && !hasInitialErrors ? rebuildState : undefined)) {
                 yield outputResult;
             }
+            // Clear initial build errors flag if no errors are now present
+            hasInitialErrors &&= result.errors.length > 0;
         }
     }
     finally {
@@ -239,6 +244,7 @@ function* emitOutputResults({ outputFiles, assetFiles, errors, warnings, externa
             outputOptions,
         },
     };
+    let hasCssUpdates = false;
     // Initially assume all previous output files have been removed
     const removedOutputFiles = new Map(previousOutputInfo);
     for (const file of outputFiles) {
@@ -254,8 +260,11 @@ function* emitOutputResults({ outputFiles, assetFiles, errors, warnings, externa
             incrementalResult.modified.push(file.path);
         }
         if (needFile) {
-            // Updates to non-JS files must signal an update with the dev server
-            if (!/(?:\.m?js|\.map)$/.test(file.path)) {
+            if (file.path.endsWith('.css')) {
+                hasCssUpdates = true;
+            }
+            else if (!/(?:\.m?js|\.map)$/.test(file.path)) {
+                // Updates to non-JS files must signal an update with the dev server
                 incrementalResult.background = false;
             }
             incrementalResult.files[file.path] = {
@@ -281,12 +290,21 @@ function* emitOutputResults({ outputFiles, assetFiles, errors, warnings, externa
         else {
             continue;
         }
+        hasCssUpdates ||= destination.endsWith('.css');
         incrementalResult.files[destination] = {
             type: bundler_context_1.BuildOutputFileType.Browser,
             inputPath: source,
             origin: 'disk',
         };
     }
+    // Do not remove stale files yet if there are template updates.
+    // Component chunk files may still be referenced in running browser code.
+    // Module evaluation time component updates will update any of these files.
+    // This typically occurs when a lazy component is changed that has not yet
+    // been accessed at runtime.
+    if (hasTemplateUpdates && incrementalResult.background) {
+        removedOutputFiles.clear();
+    }
     // Include the removed output and asset files
     incrementalResult.removed.push(...Array.from(removedOutputFiles, ([file, { type }]) => ({
         path: file,
@@ -299,6 +317,17 @@ function* emitOutputResults({ outputFiles, assetFiles, errors, warnings, externa
     // If there are template updates and the incremental update was background only, a component
     // update is possible.
     if (hasTemplateUpdates && incrementalResult.background) {
+        // Template changes may be accompanied by stylesheet changes and these should also be updated hot when possible.
+        if (hasCssUpdates) {
+            const styleResult = {
+                kind: results_1.ResultKind.Incremental,
+                added: incrementalResult.added.filter(isCssFilePath),
+                removed: incrementalResult.removed.filter(({ path }) => isCssFilePath(path)),
+                modified: incrementalResult.modified.filter(isCssFilePath),
+                files: Object.fromEntries(Object.entries(incrementalResult.files).filter(([path]) => isCssFilePath(path))),
+            };
+            yield styleResult;
+        }
         const updateResult = {
             kind: results_1.ResultKind.ComponentUpdate,
             updates: Array.from(templateUpdates, ([id, content]) => ({
@@ -310,3 +339,6 @@ function* emitOutputResults({ outputFiles, assetFiles, errors, warnings, externa
         yield updateResult;
     }
 }
+function isCssFilePath(filePath) {
+    return /\.css(?:\.map)?$/i.test(filePath);
+}

package/src/builders/application/execute-post-bundle.js

@@ -38,7 +38,7 @@ async function executePostBundleSteps(metafile, options, outputFiles, assetFiles
     const allErrors = [];
     const allWarnings = [];
     const prerenderedRoutes = {};
-    const { baseHref = '/', serviceWorker, i18nOptions, indexHtmlOptions, optimizationOptions, sourcemapOptions, outputMode, serverEntryPoint, prerenderOptions, appShellOptions, publicPath, workspaceRoot, partialSSRBuild, } = options;
+    const { baseHref = '/', serviceWorker, ssrOptions, indexHtmlOptions, optimizationOptions, sourcemapOptions, outputMode, serverEntryPoint, prerenderOptions, appShellOptions, publicPath, workspaceRoot, partialSSRBuild, } = options;
     // Index HTML content without CSS inlining to be used for server rendering (AppShell, SSG and SSR).
     // NOTE: Critical CSS inlining is deliberately omitted here, as it will be handled during server rendering.
     // Additionally, when using prerendering or AppShell, the index HTML file may be regenerated.
@@ -57,7 +57,7 @@ async function executePostBundleSteps(metafile, options, outputFiles, assetFiles
     }
     // Create server manifest
     const initialFilesPaths = new Set(initialFiles.keys());
-    if (serverEntryPoint) {
+    if (serverEntryPoint && (outputMode || prerenderOptions || appShellOptions || ssrOptions)) {
         const { manifestContent, serverAssetsChunks } = (0, manifest_1.generateAngularServerAppManifest)(additionalHtmlOutputFiles, outputFiles, optimizationOptions.styles.inlineCritical ?? false, undefined, locale, baseHref, initialFilesPaths, metafile, publicPath);
         additionalOutputFiles.push(...serverAssetsChunks, (0, utils_1.createOutputFile)(manifest_1.SERVER_APP_MANIFEST_FILENAME, manifestContent, bundler_context_1.BuildOutputFileType.ServerApplication));
     }

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

@@ -44,4 +44,5 @@ export declare function normalizeOptions(context: BuilderContext, projectName: s
         host?: string;
         port?: number;
     };
+    allowedHosts: true | string[];
 }>;

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

@@ -73,7 +73,7 @@ async function normalizeOptions(context, projectName, options) {
         }
     }
     // Initial options to keep
-    const { host, port, poll, open, verbose, watch, liveReload, hmr, headers, proxyConfig, servePath, ssl, sslCert, sslKey, prebundle, } = options;
+    const { host, port, poll, open, verbose, watch, liveReload, hmr, headers, proxyConfig, servePath, ssl, sslCert, sslKey, prebundle, allowedHosts, } = options;
     // Return all the normalized options
     return {
         buildTarget,
@@ -97,5 +97,6 @@ async function normalizeOptions(context, projectName, options) {
         // Prebundling defaults to true but requires caching to function
         prebundle: cacheOptions.enabled && !optimization.scripts && prebundle,
         inspect,
+        allowedHosts: allowedHosts ? allowedHosts : [],
     };
 }

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

@@ -2,6 +2,12 @@
  * Dev Server target options for Build Facade.
  */
 export type Schema = {
+    /**
+     * The hosts that can access the development server. This option sets the Vite option of the
+     * same name. For further details:
+     * https://vite.dev/config/server-options.html#server-allowedhosts
+     */
+    allowedHosts?: AllowedHosts;
     /**
      * A build builder target to serve in the format of `project:target[:configuration]`. You
      * can also pass in more than one configuration name as a comma-separated list. Example:
@@ -79,6 +85,12 @@ export type Schema = {
      */
     watch?: boolean;
 };
+/**
+ * The hosts that can access the development server. This option sets the Vite option of the
+ * same name. For further details:
+ * https://vite.dev/config/server-options.html#server-allowedhosts
+ */
+export type AllowedHosts = string[] | boolean;
 /**
  * Activate debugging inspector. This option only has an effect when 'SSR' or 'SSG' are
  * enabled.

package/src/builders/dev-server/schema.json

@@ -36,6 +36,23 @@
       "type": "string",
       "description": "SSL certificate to use for serving HTTPS."
     },
+    "allowedHosts": {
+      "description": "The hosts that can access the development server. This option sets the Vite option of the same name. For further details: https://vite.dev/config/server-options.html#server-allowedhosts",
+      "default": [],
+      "oneOf": [
+        {
+          "type": "array",
+          "description": "List of hosts that are allowed to access the development server.",
+          "items": {
+            "type": "string"
+          }
+        },
+        {
+          "type": "boolean",
+          "description": "Indicates that all hosts are allowed. This is not recommended and a security risk."
+        }
+      ]
+    },
     "headers": {
       "type": "object",
       "description": "Custom HTTP headers to be added to all responses.",

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

@@ -161,6 +161,7 @@ async function* serveWithVite(serverOptions, builderName, builderAction, context
                     },
                 });
             }
+            yield { baseUrl: '', success: false };
             continue;
         }
         // Clear existing error overlay on successful result
@@ -304,6 +305,46 @@ async function* serveWithVite(serverOptions, builderName, builderAction, context
             const serverConfiguration = await setupServer(serverOptions, generatedFiles, assetFiles, browserOptions.preserveSymlinks, externalMetadata, ssrMode, prebundleTransformer, target, (0, internal_1.isZonelessApp)(polyfills), componentStyles, templateUpdates, browserOptions.loader, browserOptions.define, extensions?.middleware, transformers?.indexHtml, thirdPartySourcemaps);
             server = await createServer(serverConfiguration);
             await server.listen();
+            // Setup builder context logging for browser clients
+            server.hot.on('angular:log', (data) => {
+                if (typeof data?.text !== 'string') {
+                    context.logger.warn('Development server client sent invalid internal log event.');
+                }
+                switch (data.kind) {
+                    case 'error':
+                        context.logger.error(`[CLIENT ERROR]: ${data.text}`);
+                        break;
+                    case 'warning':
+                        context.logger.warn(`[CLIENT WARNING]: ${data.text}`);
+                        break;
+                    default:
+                        context.logger.info(`[CLIENT INFO]: ${data.text}`);
+                        break;
+                }
+            });
+            // Setup component HMR invalidation
+            // Invalidation occurs when the runtime cannot update a component
+            server.hot.on('angular:invalidate', (data) => {
+                if (typeof data?.id !== 'string') {
+                    context.logger.warn('Development server client sent invalid internal invalidate event.');
+                }
+                // Clear invalid template update
+                templateUpdates.delete(data.id);
+                // Some cases are expected unsupported update scenarios but some may be errors.
+                // If an error occurred, log the error in addition to the invalidation.
+                if (data.error) {
+                    context.logger.error(`Component update failed${data.message ? `: ${data.message}` : '.'}` +
+                        '\nPlease consider reporting the error at https://github.com/angular/angular-cli/issues');
+                }
+                else {
+                    context.logger.warn(`Component update unsupported${data.message ? `: ${data.message}` : '.'}`);
+                }
+                server?.ws.send({
+                    type: 'full-reload',
+                    path: '*',
+                });
+                context.logger.info('Page reload sent to client(s).');
+            });
             const urls = server.resolvedUrls;
             if (urls && (urls.local.length || urls.network.length)) {
                 serverUrl = new URL(urls.local[0] ?? urls.network[0]);
@@ -353,26 +394,22 @@ async function invalidateUpdatedFiles(normalizePath, generatedFiles, assetFiles,
         updatedFiles.push(file);
     }
     // Invalidate any updated files
-    let destroyAngularServerAppCalled = false;
+    let serverApplicationChanged = false;
     for (const [file, record] of generatedFiles) {
         if (!record.updated) {
             continue;
         }
         record.updated = false;
-        if (record.type === internal_1.BuildOutputFileType.ServerApplication && !destroyAngularServerAppCalled) {
-            // Clear the server app cache
-            // This must be done before module invalidation.
-            const { ɵdestroyAngularServerApp } = (await server.ssrLoadModule('/main.server.mjs'));
-            ɵdestroyAngularServerApp();
-            destroyAngularServerAppCalled = true;
-        }
         updatedFiles.push(file);
+        serverApplicationChanged ||= record.type === internal_1.BuildOutputFileType.ServerApplication;
         const updatedModules = server.moduleGraph.getModulesByFile(normalizePath((0, node_path_1.join)(server.config.root, file)));
         updatedModules?.forEach((m) => server.moduleGraph.invalidateModule(m));
     }
-    if (destroyAngularServerAppCalled) {
-        // Trigger module evaluation before reload to initiate dependency optimization.
-        await server.ssrLoadModule('/main.server.mjs');
+    if (serverApplicationChanged) {
+        // Clear the server app cache and
+        // trigger module evaluation before reload to initiate dependency optimization.
+        const { ɵdestroyAngularServerApp } = (await server.ssrLoadModule('/main.server.mjs'));
+        ɵdestroyAngularServerApp();
     }
     return updatedFiles;
 }
@@ -424,7 +461,7 @@ function handleUpdate(server, serverOptions, logger, componentStyles, updatedFil
                     type: 'update',
                     updates,
                 });
-                logger.info('HMR update sent to client(s).');
+                logger.info('Stylesheet update sent to client(s).');
                 return;
             }
         }
@@ -537,6 +574,14 @@ async function setupServer(serverOptions, outputFiles, assets, preserveSymlinks,
             mainFields: ['es2020', 'browser', 'module', 'main'],
             preserveSymlinks,
         },
+        dev: {
+            // This is needed when `externalDependencies` is used to prevent Vite load errors.
+            // NOTE: If Vite adds direct support for externals, this can be removed.
+            // NOTE: Vite breaks the resolution of browser modules in SSR
+            //       when accessing a url with two or more segments (e.g., 'foo/bar'),
+            //       as they are not re-based from the base href.
+            preTransformRequests: externalMetadata.explicitBrowser.length === 0 && ssrMode === plugins_1.ServerSsrMode.NoSsr,
+        },
         server: {
             warmup: {
                 ssrFiles,
@@ -545,6 +590,7 @@ async function setupServer(serverOptions, outputFiles, assets, preserveSymlinks,
             strictPort: true,
             host: serverOptions.host,
             open: serverOptions.open,
+            allowedHosts: serverOptions.allowedHosts,
             headers: serverOptions.headers,
             // Disable the websocket if live reload is disabled (false/undefined are the only valid values)
             ws: serverOptions.liveReload === false && serverOptions.hmr === false ? false : undefined,
@@ -573,9 +619,6 @@ async function setupServer(serverOptions, outputFiles, assets, preserveSymlinks,
                     ...[...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.
-            preTransformRequests: externalMetadata.explicitBrowser.length === 0,
         },
         ssr: {
             // Note: `true` and `/.*/` have different sematics. When true, the `external` option is ignored.

package/src/tools/angular/compilation/angular-compilation.js

@@ -80,6 +80,9 @@ class AngularCompilation {
             enableResourceInlining: false,
             supportTestBed: false,
             supportJitMode: false,
+            // Disable removing of comments as TS is quite aggressive with these and can
+            // remove important annotations, such as /* @__PURE__ */ and comments like /* vite-ignore */.
+            removeComments: false,
         }));
     }
     async diagnoseFiles(modes = DiagnosticModes.All) {

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

@@ -22,6 +22,10 @@ function createAngularSsrInternalMiddleware(server, indexHtmlTransformer) {
             // which must be processed by the runtime linker, even if they are not used.
             await (0, load_esm_1.loadEsmModule)('@angular/compiler');
             const { writeResponseToNodeResponse, createWebRequestFromNodeRequest } = await (0, load_esm_1.loadEsmModule)('@angular/ssr/node');
+            // The following is necessary because accessing the module after invalidation may result in an empty module,
+            // which can trigger a `TypeError: ɵgetOrCreateAngularServerApp is not a function` error.
+            // TODO: look into why.
+            await server.ssrLoadModule('/main.server.mjs');
             const { ɵgetOrCreateAngularServerApp } = (await server.ssrLoadModule('/main.server.mjs'));
             const angularServerApp = ɵgetOrCreateAngularServerApp({
                 allowStaticRouteRender: true,

package/src/tools/vite/plugins/angular-memory-plugin.js

@@ -47,24 +47,13 @@ async function createAngularMemoryPlugin(options) {
                 // `/@id/${source}` but is currently closer to a raw external than a resolved file path.
                 return source;
             }
-            if (importer) {
+            if (importer && source[0] === '.') {
                 const normalizedImporter = normalizePath(importer);
-                if (source[0] === '.' && normalizedImporter.startsWith(virtualProjectRoot)) {
+                if (normalizedImporter.startsWith(virtualProjectRoot)) {
                     // Remove query if present
                     const [importerFile] = normalizedImporter.split('?', 1);
                     source = '/' + (0, node_path_1.join)((0, node_path_1.dirname)((0, node_path_1.relative)(virtualProjectRoot, importerFile)), source);
                 }
-                else if (!ssr &&
-                    source[0] === '/' &&
-                    importer.endsWith('index.html') &&
-                    normalizedImporter.startsWith(virtualProjectRoot)) {
-                    // This is only needed when using SSR and `angularSsrMiddleware` (old style) to correctly resolve
-                    // .js files when using lazy-loading.
-                    // Remove query if present
-                    const [importerFile] = normalizedImporter.split('?', 1);
-                    source =
-                        '/' + (0, node_path_1.join)((0, node_path_1.dirname)((0, node_path_1.relative)(virtualProjectRoot, importerFile)), (0, node_path_1.basename)(source));
-                }
             }
             const [file] = source.split('?', 1);
             if (outputFiles.has(normalizePath(file))) {

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

package/src/utils/service-worker.d.ts

@@ -9,7 +9,7 @@ import type { Config, Filesystem } from '@angular/service-worker/config';
 import { promises as fsPromises } from 'node:fs';
 import { BuildOutputFile } from '../tools/esbuild/bundler-context';
 import { BuildOutputAsset } from '../tools/esbuild/bundler-execution-result';
-export declare function augmentAppWithServiceWorker(appRoot: string, workspaceRoot: string, outputPath: string, baseHref: string, ngswConfigPath?: string, inputputFileSystem?: typeof fsPromises, outputFileSystem?: typeof fsPromises): Promise<void>;
+export declare function augmentAppWithServiceWorker(appRoot: string, workspaceRoot: string, outputPath: string, baseHref: string, ngswConfigPath?: string, inputFileSystem?: typeof fsPromises, outputFileSystem?: typeof fsPromises): Promise<void>;
 export declare function augmentAppWithServiceWorkerEsbuild(workspaceRoot: string, configPath: string, baseHref: string, indexHtml: string | undefined, outputFiles: BuildOutputFile[], assetFiles: BuildOutputAsset[]): Promise<{
     manifest: string;
     assetFiles: BuildOutputAsset[];

package/src/utils/service-worker.js

@@ -133,7 +133,7 @@ class ResultFilesystem {
         throw new Error('Serviceworker manifest generator should not attempted to write.');
     }
 }
-async function augmentAppWithServiceWorker(appRoot, workspaceRoot, outputPath, baseHref, ngswConfigPath, inputputFileSystem = node_fs_1.promises, outputFileSystem = node_fs_1.promises) {
+async function augmentAppWithServiceWorker(appRoot, workspaceRoot, outputPath, baseHref, ngswConfigPath, inputFileSystem = node_fs_1.promises, outputFileSystem = node_fs_1.promises) {
     // Determine the configuration file path
     const configPath = ngswConfigPath
         ? path.join(workspaceRoot, ngswConfigPath)
@@ -141,7 +141,7 @@ async function augmentAppWithServiceWorker(appRoot, workspaceRoot, outputPath, b
     // Read the configuration file
     let config;
     try {
-        const configurationData = await inputputFileSystem.readFile(configPath, 'utf-8');
+        const configurationData = await inputFileSystem.readFile(configPath, 'utf-8');
         config = JSON.parse(configurationData);
     }
     catch (error) {
@@ -158,11 +158,7 @@ async function augmentAppWithServiceWorker(appRoot, workspaceRoot, outputPath, b
     const result = await augmentAppWithServiceWorkerCore(config, new CliFilesystem(outputFileSystem, outputPath), baseHref);
     const copy = async (src, dest) => {
         const resolvedDest = path.join(outputPath, dest);
-        return inputputFileSystem === outputFileSystem
-            ? // Native FS (Builder).
-                inputputFileSystem.copyFile(src, resolvedDest, node_fs_1.constants.COPYFILE_FICLONE)
-            : // memfs (Webpack): Read the file from the input FS (disk) and write it to the output FS (memory).
-                outputFileSystem.writeFile(resolvedDest, await inputputFileSystem.readFile(src));
+        return outputFileSystem.writeFile(resolvedDest, await inputFileSystem.readFile(src));
     };
     await outputFileSystem.writeFile(path.join(outputPath, 'ngsw.json'), result.manifest);
     for (const { source, destination } of result.assetFiles) {