@angular/build 19.1.3 → 19.1.5

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.3",
+  "version": "19.1.5",
   "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.3",
+    "@angular-devkit/core": "19.1.5",
+    "@angular-devkit/architect": "0.1901.5",
     "@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.3",
+    "@angular/ssr": "^19.1.5",
     "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

@@ -239,6 +239,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 +255,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 +285,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 +312,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 +334,6 @@ function* emitOutputResults({ outputFiles, assetFiles, errors, warnings, externa
         yield updateResult;
     }
 }
+function isCssFilePath(filePath) {
+    return /\.css(?:\.map)?$/i.test(filePath);
+}

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

@@ -6,7 +6,6 @@
  * found in the LICENSE file at https://angular.dev/license
  */
 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';
@@ -29,5 +28,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 builder: Builder<ApplicationBuilderOptions & json.JsonObject>;
+declare const builder: Builder<ApplicationBuilderOptions>;
 export default builder;

package/src/builders/application/options.js

@@ -63,7 +63,7 @@ async function normalizeOptions(context, projectName, options, extensions) {
     // Gather persistent caching option and provide a project specific cache location
     const cacheOptions = (0, normalize_cache_1.normalizeCacheOptions)(projectMetadata, workspaceRoot);
     cacheOptions.path = node_path_1.default.join(cacheOptions.path, projectName);
-    const i18nOptions = (0, i18n_options_1.createI18nOptions)(projectMetadata, options.localize, context.logger);
+    const i18nOptions = (0, i18n_options_1.createI18nOptions)(projectMetadata, options.localize, context.logger, !!options.ssr);
     i18nOptions.duplicateTranslationBehavior = options.i18nDuplicateTranslation;
     i18nOptions.missingTranslationBehavior = options.i18nMissingTranslation;
     if (options.forceI18nFlatOutput) {

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

@@ -1,7 +1,7 @@
 /**
  * Application builder target options
  */
-export interface Schema {
+export type Schema = {
     /**
      * A list of CommonJS or AMD packages that are allowed to be used without a build time
      * warning. Use `'*'` to allow all.
@@ -208,9 +208,9 @@ export interface Schema {
      * TypeScript configuration for Web Worker modules.
      */
     webWorkerTsConfig?: string;
-}
+};
 export type AssetPattern = AssetPatternClass | string;
-export interface AssetPatternClass {
+export type AssetPatternClass = {
     /**
      * Allow glob patterns to follow symlink directories. This allows subdirectories of the
      * symlink to be searched.
@@ -232,8 +232,8 @@ export interface AssetPatternClass {
      * Absolute path within the output.
      */
     output?: string;
-}
-export interface Budget {
+};
+export type Budget = {
     /**
      * The baseline size for comparison.
      */
@@ -270,7 +270,7 @@ export interface Budget {
      * The threshold for warning relative to the baseline (min & max).
      */
     warning?: string;
-}
+};
 /**
  * The type of budget.
  */
@@ -291,10 +291,10 @@ export declare enum CrossOrigin {
     None = "none",
     UseCredentials = "use-credentials"
 }
-export interface FileReplacement {
+export type FileReplacement = {
     replace: string;
     with: string;
-}
+};
 /**
  * How to handle duplicate translations for i18n.
  *
@@ -309,7 +309,7 @@ export declare enum I18NTranslation {
  * Configures the generation of the application's HTML index.
  */
 export type IndexUnion = boolean | IndexObject | string;
-export interface IndexObject {
+export type IndexObject = {
     /**
      * The path of a file to use for the application's generated HTML index.
      */
@@ -325,7 +325,7 @@ export interface IndexObject {
      */
     preloadInitial?: boolean;
     [property: string]: any;
-}
+};
 /**
  * The stylesheet language to use for the application's inline component styles.
  */
@@ -346,7 +346,7 @@ export type Localize = string[] | boolean;
  * https://angular.dev/reference/configs/workspace-config#optimization-configuration.
  */
 export type OptimizationUnion = boolean | OptimizationClass;
-export interface OptimizationClass {
+export type OptimizationClass = {
     /**
      * Enables optimization for fonts. This option requires internet access. `HTTPS_PROXY`
      * environment variable can be used to specify a proxy server.
@@ -360,25 +360,25 @@ export interface OptimizationClass {
      * Enables optimization of the styles output.
      */
     styles?: StylesUnion;
-}
+};
 /**
  * Enables optimization for fonts. This option requires internet access. `HTTPS_PROXY`
  * environment variable can be used to specify a proxy server.
  */
 export type FontsUnion = boolean | FontsClass;
-export interface FontsClass {
+export type FontsClass = {
     /**
      * Reduce render blocking requests by inlining external Google Fonts and Adobe Fonts CSS
      * definitions in the application's HTML index file. This option requires internet access.
      * `HTTPS_PROXY` environment variable can be used to specify a proxy server.
      */
     inline?: boolean;
-}
+};
 /**
  * Enables optimization of the styles output.
  */
 export type StylesUnion = boolean | StylesClass;
-export interface StylesClass {
+export type StylesClass = {
     /**
      * Extract and inline critical CSS definitions to improve first paint time.
      */
@@ -393,7 +393,7 @@ export interface StylesClass {
      * '//!' or '/*!'.
      */
     removeSpecialComments?: boolean;
-}
+};
 /**
  * Define the output filename cache-busting hashing mode.
  */
@@ -416,7 +416,7 @@ export declare enum OutputMode {
  * Specify the output path relative to workspace root.
  */
 export type OutputPathUnion = OutputPathClass | string;
-export interface OutputPathClass {
+export type OutputPathClass = {
     /**
      * Specify the output path relative to workspace root.
      */
@@ -436,12 +436,12 @@ export interface OutputPathClass {
      * 'server'.
      */
     server?: string;
-}
+};
 /**
  * Prerender (SSG) pages of your application during build time.
  */
 export type PrerenderUnion = boolean | PrerenderClass;
-export interface PrerenderClass {
+export type PrerenderClass = {
     /**
      * Whether the builder should process the Angular Router configuration to find all
      * unparameterized routes and prerender them.
@@ -452,9 +452,9 @@ export interface PrerenderClass {
      * newlines. This option is useful if you want to prerender routes with parameterized URLs.
      */
     routesFile?: string;
-}
+};
 export type ScriptElement = ScriptClass | string;
-export interface ScriptClass {
+export type ScriptClass = {
     /**
      * The bundle name for this extra entry point.
      */
@@ -467,32 +467,32 @@ export interface ScriptClass {
      * The file to include.
      */
     input: string;
-}
+};
 /**
  * Security features to protect against XSS and other common attacks
  */
-export interface Security {
+export type Security = {
     /**
      * Enables automatic generation of a hash-based Strict Content Security Policy
      * (https://web.dev/articles/strict-csp#choose-hash) based on scripts in index.html. Will
      * default to true once we are out of experimental/preview phases.
      */
     autoCsp?: AutoCspUnion;
-}
+};
 /**
  * Enables automatic generation of a hash-based Strict Content Security Policy
  * (https://web.dev/articles/strict-csp#choose-hash) based on scripts in index.html. Will
  * default to true once we are out of experimental/preview phases.
  */
 export type AutoCspUnion = boolean | AutoCspClass;
-export interface AutoCspClass {
+export type AutoCspClass = {
     /**
      * Include the `unsafe-eval` directive (https://web.dev/articles/strict-csp#remove-eval) in
      * the auto-CSP. Please only enable this if you are absolutely sure that you need to, as
      * allowing calls to eval will weaken the XSS defenses provided by the auto-CSP.
      */
     unsafeEval?: boolean;
-}
+};
 /**
  * Generates a service worker configuration.
  */
@@ -502,7 +502,7 @@ export type ServiceWorker = boolean | string;
  * https://angular.dev/reference/configs/workspace-config#source-map-configuration.
  */
 export type SourceMapUnion = boolean | SourceMapClass;
-export interface SourceMapClass {
+export type SourceMapClass = {
     /**
      * Output source maps used for error reporting tools.
      */
@@ -519,12 +519,12 @@ export interface SourceMapClass {
      * Resolve vendor packages source maps.
      */
     vendor?: boolean;
-}
+};
 /**
  * Server side render (SSR) pages of your application during runtime.
  */
 export type SsrUnion = boolean | SsrClass;
-export interface SsrClass {
+export type SsrClass = {
     /**
      * The server entry-point that when executed will spawn the web server.
      */
@@ -543,7 +543,7 @@ export interface SsrClass {
      * versions.
      */
     experimentalPlatform?: ExperimentalPlatform;
-}
+};
 /**
  * Specifies the platform for which the server bundle is generated. This affects the APIs
  * and modules available in the server-side code.
@@ -564,7 +564,7 @@ export declare enum ExperimentalPlatform {
 /**
  * Options to pass to style preprocessors.
  */
-export interface StylePreprocessorOptions {
+export type StylePreprocessorOptions = {
     /**
      * Paths to include. Paths will be resolved to workspace root.
      */
@@ -573,11 +573,11 @@ export interface StylePreprocessorOptions {
      * Options to pass to the sass preprocessor.
      */
     sass?: Sass;
-}
+};
 /**
  * Options to pass to the sass preprocessor.
  */
-export interface Sass {
+export type Sass = {
     /**
      * A set of deprecations to treat as fatal. If a deprecation warning of any provided type is
      * encountered during compilation, the compiler will error instead. If a Version is
@@ -595,9 +595,9 @@ export interface Sass {
      * encountered during compilation, the compiler will ignore it instead.
      */
     silenceDeprecations?: string[];
-}
+};
 export type StyleElement = StyleClass | string;
-export interface StyleClass {
+export type StyleClass = {
     /**
      * The bundle name for this extra entry point.
      */
@@ -610,4 +610,4 @@ export interface StyleClass {
      * The file to include.
      */
     input: string;
-}
+};

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

@@ -6,11 +6,10 @@
  * 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 builder: Builder<DevServerBuilderOptions & json.JsonObject>;
+declare const builder: Builder<DevServerBuilderOptions>;
 export default builder;
 export { execute as executeDevServer };

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

@@ -1,7 +1,13 @@
 /**
  * Dev Server target options for Build Facade.
  */
-export interface Schema {
+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:
@@ -78,7 +84,13 @@ export interface Schema {
      * Rebuild on change.
      */
     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.
@@ -89,10 +101,10 @@ export type Inspect = boolean | string;
  * enable prebundling, the Angular CLI cache must also be enabled.
  */
 export type PrebundleUnion = boolean | PrebundleClass;
-export interface PrebundleClass {
+export type PrebundleClass = {
     /**
      * List of package imports that should not be prebundled by the development server. The
      * packages will be bundled into the application code itself.
      */
     exclude: string[];
-}
+};

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

@@ -304,6 +304,23 @@ 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;
+                }
+            });
             const urls = server.resolvedUrls;
             if (urls && (urls.local.length || urls.network.length)) {
                 serverUrl = new URL(urls.local[0] ?? urls.network[0]);
@@ -353,26 +370,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 +437,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;
             }
         }
@@ -545,6 +558,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,

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

@@ -6,9 +6,8 @@
  * 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 builder: Builder<ExtractI18nBuilderOptions & json.JsonObject>;
+declare const builder: Builder<ExtractI18nBuilderOptions>;
 export default builder;

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

@@ -1,7 +1,7 @@
 /**
  * Extract i18n target options for Build Facade.
  */
-export interface Schema {
+export type Schema = {
     /**
      * A builder target to extract i18n messages in the format of
      * `project:target[:configuration]`. You can also pass in more than one configuration name
@@ -24,7 +24,7 @@ export interface Schema {
      * Log progress to the console.
      */
     progress?: boolean;
-}
+};
 /**
  * Output format for the generated file.
  */

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

@@ -6,9 +6,8 @@
  * 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 builder: Builder<NgPackagrBuilderOptions & json.JsonObject>;
+declare const builder: Builder<NgPackagrBuilderOptions>;
 export default builder;

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

@@ -1,7 +1,7 @@
 /**
  * ng-packagr target options for Build Architect. Use to build library projects.
  */
-export interface Schema {
+export type Schema = {
     /**
      * Enable and define the file watching poll time period in milliseconds.
      */
@@ -18,4 +18,4 @@ export interface Schema {
      * Run build when files change.
      */
     watch?: boolean;
-}
+};

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

@@ -35,11 +35,7 @@ async function createAngularMemoryPlugin(options) {
                 // Vite will resolve these these files example:
                 // `file:///@ng/component?c=src%2Fapp%2Fapp.component.ts%40AppComponent&t=1737017253850`
                 const sourcePath = (0, node_url_1.fileURLToPath)(source);
-                const sourceWithoutRoot = sourcePath.startsWith(virtualProjectRoot)
-                    ? normalizePath('/' + (0, node_path_1.relative)(virtualProjectRoot, sourcePath))
-                    : // TODO: remove once https://github.com/angular/angular/blob/4e6017a9f5cda389c5fbf4f2c1519ce1bba23e11/packages/compiler/src/render3/r3_hmr_compiler.ts#L57
-                        // is changed from `/@ng` to `./@ng/`
-                        normalizePath('/' + sourcePath.slice((0, node_path_1.parse)(sourcePath).root.length));
+                const sourceWithoutRoot = normalizePath('/' + (0, node_path_1.relative)(virtualProjectRoot, sourcePath));
                 if (sourceWithoutRoot.startsWith(ANGULAR_PREFIX)) {
                     const [, query] = source.split('?', 2);
                     return `\0${sourceWithoutRoot}?${query}`;

package/src/utils/i18n-options.d.ts

@@ -29,7 +29,7 @@ export declare function createI18nOptions(projectMetadata: {
     i18n?: unknown;
 }, inline?: boolean | string[], logger?: {
     warn(message: string): void;
-}): I18nOptions;
+}, ssrEnabled?: boolean): I18nOptions;
 export declare function loadTranslations(locale: string, desc: LocaleDescription, workspaceRoot: string, loader: TranslationLoader, logger: {
     warn: (message: string) => void;
     error: (message: string) => void;

package/src/utils/i18n-options.js

@@ -45,7 +45,7 @@ function ensureValidSubPath(value, name) {
         throw new Error(`Project field '${name}' is invalid. It can only contain letters, numbers, hyphens, and underscores.`);
     }
 }
-function createI18nOptions(projectMetadata, inline, logger) {
+function createI18nOptions(projectMetadata, inline, logger, ssrEnabled) {
     const { i18n: metadata = {} } = projectMetadata;
     ensureObject(metadata, 'i18n');
     const i18n = {
@@ -71,10 +71,12 @@ function createI18nOptions(projectMetadata, inline, logger) {
         }
         if (metadata.sourceLocale.baseHref !== undefined) {
             ensureString(metadata.sourceLocale.baseHref, 'i18n.sourceLocale.baseHref');
-            logger?.warn(`The 'baseHref' field under 'i18n.sourceLocale' is deprecated and will be removed in future versions. ` +
-                `Please use 'subPath' instead.\nNote: 'subPath' defines the URL segment for the locale, acting ` +
-                `as both the HTML base HREF and the directory name for output.\nBy default, ` +
-                `if not specified, 'subPath' uses the locale code.`);
+            if (ssrEnabled) {
+                logger?.warn(`'baseHref' in 'i18n.sourceLocale' may lead to undefined behavior when used with SSR. ` +
+                    `Consider using 'subPath' instead.\n\n` +
+                    `Note: 'subPath' specifies the URL segment for the locale, serving as both the HTML base HREF ` +
+                    `and the output directory name.\nBy default, if not explicitly set, 'subPath' defaults to the locale code.`);
+            }
             rawSourceLocaleBaseHref = metadata.sourceLocale.baseHref;
         }
         if (metadata.sourceLocale.subPath !== undefined) {
@@ -104,10 +106,12 @@ function createI18nOptions(projectMetadata, inline, logger) {
                 translationFiles = normalizeTranslationFileOption(options.translation, locale, false);
                 if ('baseHref' in options) {
                     ensureString(options.baseHref, `i18n.locales.${locale}.baseHref`);
-                    logger?.warn(`The 'baseHref' field under 'i18n.locales.${locale}' is deprecated and will be removed in future versions. ` +
-                        `Please use 'subPath' instead.\nNote: 'subPath' defines the URL segment for the locale, acting ` +
-                        `as both the HTML base HREF and the directory name for output.\nBy default, ` +
-                        `if not specified, 'subPath' uses the locale code.`);
+                    if (ssrEnabled) {
+                        logger?.warn(`'baseHref' in 'i18n.locales.${locale}' may lead to undefined behavior when used with SSR. ` +
+                            `Consider using 'subPath' instead.\n\n` +
+                            `Note: 'subPath' specifies the URL segment for the locale, serving as both the HTML base HREF ` +
+                            `and the output directory name.\nBy default, if not explicitly set, 'subPath' defaults to the locale code.`);
+                    }
                     baseHref = options.baseHref;
                 }
                 if ('subPath' in options) {
@@ -131,17 +135,6 @@ function createI18nOptions(projectMetadata, inline, logger) {
             };
         }
     }
-    // Check that subPaths are unique.
-    const localesData = Object.entries(i18n.locales);
-    for (let i = 0; i < localesData.length; i++) {
-        const [localeA, { subPath: subPathA }] = localesData[i];
-        for (let j = i + 1; j < localesData.length; j++) {
-            const [localeB, { subPath: subPathB }] = localesData[j];
-            if (subPathA === subPathB) {
-                throw new Error(`Invalid i18n configuration: Locales '${localeA}' and '${localeB}' cannot have the same subPath: '${subPathB}'.`);
-            }
-        }
-    }
     if (inline === true) {
         i18n.inlineLocales.add(i18n.sourceLocale);
         Object.keys(i18n.locales).forEach((locale) => i18n.inlineLocales.add(locale));
@@ -154,6 +147,17 @@ function createI18nOptions(projectMetadata, inline, logger) {
             i18n.inlineLocales.add(locale);
         }
     }
+    // Check that subPaths are unique only the locales that we are inlining.
+    const localesData = Object.entries(i18n.locales).filter(([locale]) => i18n.inlineLocales.has(locale));
+    for (let i = 0; i < localesData.length; i++) {
+        const [localeA, { subPath: subPathA }] = localesData[i];
+        for (let j = i + 1; j < localesData.length; j++) {
+            const [localeB, { subPath: subPathB }] = localesData[j];
+            if (subPathA === subPathB) {
+                throw new Error(`Invalid i18n configuration: Locales '${localeA}' and '${localeB}' cannot have the same subPath: '${subPathB}'.`);
+            }
+        }
+    }
     return i18n;
 }
 function loadTranslations(locale, desc, workspaceRoot, loader, logger, usedFormats, duplicateTranslation) {

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

package/src/utils/server-rendering/prerender.js

@@ -16,6 +16,7 @@ const error_1 = require("../error");
 const url_1 = require("../url");
 const worker_pool_1 = require("../worker-pool");
 const utils_1 = require("./esm-in-memory-loader/utils");
+const manifest_1 = require("./manifest");
 const models_1 = require("./models");
 async function prerenderPages(workspaceRoot, baseHref, appShellOptions, prerenderOptions, outputFiles, assets, outputMode, sourcemap = false, maxThreads = 1) {
     const outputFilesForWorker = {};
@@ -89,6 +90,12 @@ async function prerenderPages(workspaceRoot, baseHref, appShellOptions, prerende
             serializableRouteTreeNode,
         };
     }
+    // Add the extracted routes to the manifest file.
+    // We could re-generate it from the start, but that would require a number of options to be passed down.
+    const manifest = outputFilesForWorker[manifest_1.SERVER_APP_MANIFEST_FILENAME];
+    if (manifest) {
+        outputFilesForWorker[manifest_1.SERVER_APP_MANIFEST_FILENAME] = manifest.replace('routes: undefined,', `routes: ${JSON.stringify(serializableRouteTreeNodeForPrerender, undefined, 2)},`);
+    }
     // Render routes
     const { errors: renderingErrors, output } = await renderPages(baseHref, sourcemap, serializableRouteTreeNodeForPrerender, maxThreads, workspaceRoot, outputFilesForWorker, assetsReversed, outputMode, appShellRoute ?? appShellOptions?.route);
     errors.push(...renderingErrors);

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) {