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

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

@@ -110,6 +110,7 @@ async function* serveWithVite(serverOptions, builderName, builderAction, context
     // This will also replace file-based/inline styles as code if external runtime styles are not enabled.
     browserOptions.templateUpdates =
         serverOptions.liveReload && serverOptions.hmr && environment_options_1.useComponentTemplateHmr;
+    browserOptions.incrementalResults = true;
     // Setup the prebundling transformer that will be shared across Vite prebundling requests
     const prebundleTransformer = new internal_1.JavaScriptTransformer(
     // Always enable JIT linking to support applications built with and without AOT.
@@ -179,10 +180,17 @@ async function* serveWithVite(serverOptions, builderName, builderAction, context
                             : baseHref;
                 }
                 assetFiles.clear();
-                for (const [outputPath, file] of Object.entries(result.files)) {
+                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, 
+                    // The initial build will not yet have a server setup
+                    !server);
                 }
                 // Invalidate SSR module graph to ensure that only new rebuild is used and not stale component updates
                 if (server && browserOptions.ssr && templateUpdates.size > 0) {
@@ -190,12 +198,20 @@ async function* serveWithVite(serverOptions, builderName, builderAction, context
                 }
                 // Clear stale template updates on code rebuilds
                 templateUpdates.clear();
-                // Analyze result files for changes
-                analyzeResultFiles(normalizePath, htmlIndexPath, result.files, generatedFiles, componentStyles);
                 break;
             case results_1.ResultKind.Incremental:
                 (0, node_assert_1.default)(server, 'Builder must provide an initial full build before incremental results.');
-                // TODO: Implement support -- application builder currently does not use
+                for (const removed of result.removed) {
+                    const filePath = '/' + normalizePath(removed.path);
+                    generatedFiles.delete(filePath);
+                    assetFiles.delete(filePath);
+                }
+                for (const modified of result.modified) {
+                    updateResultRecord(modified, result.files[modified], normalizePath, htmlIndexPath, generatedFiles, componentStyles);
+                }
+                for (const added of result.added) {
+                    updateResultRecord(added, result.files[added], normalizePath, htmlIndexPath, generatedFiles, componentStyles);
+                }
                 break;
             case results_1.ResultKind.ComponentUpdate:
                 (0, node_assert_1.default)(serverOptions.hmr, 'Component updates are only supported with HMR enabled.');
@@ -286,7 +302,7 @@ async function* serveWithVite(serverOptions, builderName, builderAction, context
                 });
             }
             // Setup server and start listening
-            const serverConfiguration = await setupServer(serverOptions, generatedFiles, assetFiles, browserOptions.preserveSymlinks, externalMetadata, ssrMode, prebundleTransformer, target, (0, internal_1.isZonelessApp)(polyfills), componentStyles, templateUpdates, browserOptions.loader, extensions?.middleware, transformers?.indexHtml, thirdPartySourcemaps);
+            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();
             const urls = server.resolvedUrls;
@@ -325,11 +341,12 @@ async function handleUpdate(normalizePath, generatedFiles, server, serverOptions
     const updatedFiles = [];
     let destroyAngularServerAppCalled = false;
     // Invalidate any updated files
-    for (const [file, { updated, type }] of generatedFiles) {
-        if (!updated) {
+    for (const [file, record] of generatedFiles) {
+        if (!record.updated) {
             continue;
         }
-        if (type === internal_1.BuildOutputFileType.ServerApplication && !destroyAngularServerAppCalled) {
+        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'));
@@ -402,79 +419,71 @@ async function handleUpdate(normalizePath, generatedFiles, server, serverOptions
         logger.info('Page reload sent to client(s).');
     }
 }
-function analyzeResultFiles(normalizePath, htmlIndexPath, resultFiles, generatedFiles, componentStyles) {
-    const seen = new Set(['/index.html']);
-    for (const [outputPath, file] of Object.entries(resultFiles)) {
-        if (file.origin === 'disk') {
-            continue;
-        }
-        let filePath;
-        if (outputPath === htmlIndexPath) {
-            // Convert custom index output path to standard index path for dev-server usage.
-            // This mimics the Webpack dev-server behavior.
-            filePath = '/index.html';
-        }
-        else {
-            filePath = '/' + normalizePath(outputPath);
-        }
-        seen.add(filePath);
-        const servable = file.type === internal_1.BuildOutputFileType.Browser || file.type === internal_1.BuildOutputFileType.Media;
-        // Skip analysis of sourcemaps
-        if (filePath.endsWith('.map')) {
-            generatedFiles.set(filePath, {
-                contents: file.contents,
-                servable,
-                size: file.contents.byteLength,
-                hash: file.hash,
-                type: file.type,
-                updated: false,
-            });
-            continue;
-        }
-        const existingRecord = generatedFiles.get(filePath);
-        if (existingRecord &&
-            existingRecord.size === file.contents.byteLength &&
-            existingRecord.hash === file.hash) {
-            // Same file
-            existingRecord.updated = false;
-            continue;
-        }
-        // New or updated file
+function updateResultRecord(outputPath, file, normalizePath, htmlIndexPath, generatedFiles, componentStyles, initial = false) {
+    if (file.origin === 'disk') {
+        return;
+    }
+    let filePath;
+    if (outputPath === htmlIndexPath) {
+        // Convert custom index output path to standard index path for dev-server usage.
+        // This mimics the Webpack dev-server behavior.
+        filePath = '/index.html';
+    }
+    else {
+        filePath = '/' + normalizePath(outputPath);
+    }
+    const servable = file.type === internal_1.BuildOutputFileType.Browser || file.type === internal_1.BuildOutputFileType.Media;
+    // Skip analysis of sourcemaps
+    if (filePath.endsWith('.map')) {
         generatedFiles.set(filePath, {
             contents: file.contents,
+            servable,
             size: file.contents.byteLength,
             hash: file.hash,
-            updated: true,
             type: file.type,
-            servable,
+            updated: false,
         });
-        // Record any external component styles
-        if (filePath.endsWith('.css') && /^\/[a-f0-9]{64}\.css$/.test(filePath)) {
-            const componentStyle = componentStyles.get(filePath);
-            if (componentStyle) {
-                componentStyle.rawContent = file.contents;
-            }
-            else {
-                componentStyles.set(filePath, {
-                    rawContent: file.contents,
-                });
-            }
-        }
+        return;
     }
-    // Clear stale output files
-    for (const file of generatedFiles.keys()) {
-        if (!seen.has(file)) {
-            generatedFiles.delete(file);
-            componentStyles.delete(file);
+    // New or updated file
+    generatedFiles.set(filePath, {
+        contents: file.contents,
+        size: file.contents.byteLength,
+        hash: file.hash,
+        // Consider the files updated except on the initial build result
+        updated: !initial,
+        type: file.type,
+        servable,
+    });
+    // Record any external component styles
+    if (filePath.endsWith('.css') && /^\/[a-f0-9]{64}\.css$/.test(filePath)) {
+        const componentStyle = componentStyles.get(filePath);
+        if (componentStyle) {
+            componentStyle.rawContent = file.contents;
+        }
+        else {
+            componentStyles.set(filePath, {
+                rawContent: file.contents,
+            });
         }
     }
 }
-async function setupServer(serverOptions, outputFiles, assets, preserveSymlinks, externalMetadata, ssrMode, prebundleTransformer, target, zoneless, componentStyles, templateUpdates, prebundleLoaderExtensions, extensionMiddleware, indexHtmlTransformer, thirdPartySourcemaps = false) {
+async function setupServer(serverOptions, outputFiles, assets, preserveSymlinks, externalMetadata, ssrMode, prebundleTransformer, target, zoneless, componentStyles, templateUpdates, prebundleLoaderExtensions, define, extensionMiddleware, indexHtmlTransformer, thirdPartySourcemaps = false) {
     const proxy = await (0, utils_2.loadProxyConfiguration)(serverOptions.workspaceRoot, serverOptions.proxyConfig);
     // dynamically import Vite for ESM compatibility
     const { normalizePath } = await (0, load_esm_1.loadEsmModule)('vite');
     // Path will not exist on disk and only used to provide separate path for Vite requests
     const virtualProjectRoot = normalizePath((0, node_path_1.join)(serverOptions.workspaceRoot, `.angular/vite-root`, serverOptions.buildTarget.project));
+    // Files used for SSR warmup.
+    let ssrFiles;
+    switch (ssrMode) {
+        case plugins_1.ServerSsrMode.InternalSsrMiddleware:
+            ssrFiles = ['./main.server.mjs'];
+            break;
+        case plugins_1.ServerSsrMode.ExternalSsrMiddleware:
+            ssrFiles = ['./main.server.mjs', './server.mjs'];
+            break;
+    }
     const cacheDir = (0, node_path_1.join)(serverOptions.cacheOptions.path, serverOptions.buildTarget.project, 'vite');
     const configuration = {
         configFile: false,
@@ -505,7 +514,7 @@ async function setupServer(serverOptions, outputFiles, assets, preserveSymlinks,
         },
         server: {
             warmup: {
-                ssrFiles: ['./main.server.mjs', './server.mjs'],
+                ssrFiles,
             },
             port: serverOptions.port,
             strictPort: true,
@@ -557,6 +566,7 @@ async function setupServer(serverOptions, outputFiles, assets, preserveSymlinks,
                 target,
                 loader: prebundleLoaderExtensions,
                 thirdPartySourcemaps,
+                define,
             }),
         },
         plugins: [
@@ -594,12 +604,13 @@ async function setupServer(serverOptions, outputFiles, assets, preserveSymlinks,
             zoneless,
             loader: prebundleLoaderExtensions,
             thirdPartySourcemaps,
+            define,
         }),
     };
     if (serverOptions.ssl) {
         if (serverOptions.sslCert && serverOptions.sslKey) {
+            configuration.server ??= {};
             // server configuration is defined above
-            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
             configuration.server.https = {
                 cert: await (0, promises_1.readFile)(serverOptions.sslCert),
                 key: await (0, promises_1.readFile)(serverOptions.sslKey),
@@ -607,7 +618,6 @@ async function setupServer(serverOptions, outputFiles, assets, preserveSymlinks,
         }
         else {
             const { default: basicSslPlugin } = await Promise.resolve().then(() => __importStar(require('@vitejs/plugin-basic-ssl')));
-            // eslint-disable-next-line @typescript-eslint/no-floating-promises
             configuration.plugins ??= [];
             configuration.plugins.push(basicSslPlugin());
         }

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

@@ -8,5 +8,5 @@
 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/src").JsonObject>;
+declare const _default: import("../../../../../angular_devkit/architect/src/internal").Builder<ExtractI18nBuilderOptions & import("../../../../../angular_devkit/core").JsonObject>;
 export default _default;

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

@@ -0,0 +1,19 @@
+/**
+ * @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
+ */
+import type { BuilderContext, BuilderOutput } from '@angular-devkit/architect';
+import type { Schema as NgPackagrBuilderOptions } from './schema';
+/**
+ * A Builder that executes the `ng-packagr` tool to build an Angular library.
+ *
+ * @param options The builder options as defined by the JSON schema.
+ * @param context A BuilderContext instance.
+ * @returns A BuilderOutput object.
+ *
+ * @experimental Direct usage of this function is considered experimental.
+ */
+export declare function execute(options: NgPackagrBuilderOptions, context: BuilderContext): AsyncIterableIterator<BuilderOutput>;

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

@@ -0,0 +1,103 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.execute = execute;
+const node_path_1 = require("node:path");
+const error_1 = require("../../utils/error");
+const normalize_cache_1 = require("../../utils/normalize-cache");
+const purge_cache_1 = require("../../utils/purge-cache");
+/**
+ * A Builder that executes the `ng-packagr` tool to build an Angular library.
+ *
+ * @param options The builder options as defined by the JSON schema.
+ * @param context A BuilderContext instance.
+ * @returns A BuilderOutput object.
+ *
+ * @experimental Direct usage of this function is considered experimental.
+ */
+async function* execute(options, context) {
+    // Purge old build disk cache.
+    await (0, purge_cache_1.purgeStaleBuildCache)(context);
+    const root = context.workspaceRoot;
+    let packager;
+    try {
+        packager = (await Promise.resolve().then(() => __importStar(require('ng-packagr')))).ngPackagr();
+    }
+    catch (error) {
+        (0, error_1.assertIsError)(error);
+        if (error.code === 'MODULE_NOT_FOUND') {
+            return {
+                success: false,
+                error: 'The "ng-packagr" package was not found. To correct this error, ensure this package is installed in the project.',
+            };
+        }
+        throw error;
+    }
+    packager.forProject((0, node_path_1.resolve)(root, options.project));
+    if (options.tsConfig) {
+        packager.withTsConfig((0, node_path_1.resolve)(root, options.tsConfig));
+    }
+    const projectName = context.target?.project;
+    if (!projectName) {
+        throw new Error('The builder requires a target.');
+    }
+    const metadata = await context.getProjectMetadata(projectName);
+    const { enabled: cacheEnabled, path: cacheDirectory } = (0, normalize_cache_1.normalizeCacheOptions)(metadata, context.workspaceRoot);
+    const ngPackagrOptions = {
+        cacheEnabled,
+        poll: options.poll,
+        cacheDirectory: (0, node_path_1.join)(cacheDirectory, 'ng-packagr'),
+    };
+    try {
+        if (options.watch) {
+            await packager.watch(ngPackagrOptions).toPromise();
+        }
+        else {
+            await packager.build(ngPackagrOptions);
+        }
+        yield { success: true };
+    }
+    catch (error) {
+        (0, error_1.assertIsError)(error);
+        yield { success: false, error: error.message };
+    }
+}

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

@@ -0,0 +1,12 @@
+/**
+ * @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
+ */
+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;

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

@@ -0,0 +1,14 @@
+"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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+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);

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

@@ -0,0 +1,21 @@
+/**
+ * ng-packagr target options for Build Architect. Use to build library projects.
+ */
+export interface Schema {
+    /**
+     * Enable and define the file watching poll time period in milliseconds.
+     */
+    poll?: number;
+    /**
+     * The file path for the ng-packagr configuration file, relative to the current workspace.
+     */
+    project: string;
+    /**
+     * The full path for the TypeScript configuration file, relative to the current workspace.
+     */
+    tsConfig?: string;
+    /**
+     * Run build when files change.
+     */
+    watch?: boolean;
+}

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

@@ -0,0 +1,4 @@
+"use strict";
+// THIS FILE IS AUTOMATICALLY GENERATED. TO UPDATE THIS FILE YOU NEED TO CHANGE THE
+// CORRESPONDING JSON SCHEMA FILE, THEN RUN devkit-admin build (or bazel build ...).
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,27 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema",
+  "title": "ng-packagr Target",
+  "description": "ng-packagr target options for Build Architect. Use to build library projects.",
+  "type": "object",
+  "properties": {
+    "project": {
+      "type": "string",
+      "description": "The file path for the ng-packagr configuration file, relative to the current workspace."
+    },
+    "tsConfig": {
+      "type": "string",
+      "description": "The full path for the TypeScript configuration file, relative to the current workspace."
+    },
+    "watch": {
+      "type": "boolean",
+      "description": "Run build when files change.",
+      "default": false
+    },
+    "poll": {
+      "type": "number",
+      "description": "Enable and define the file watching poll time period in milliseconds."
+    }
+  },
+  "additionalProperties": false,
+  "required": ["project"]
+}

package/src/index.d.ts

@@ -5,9 +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
  */
-export { buildApplication, type ApplicationBuilderOptions, type ApplicationBuilderOutput, } from './builders/application';
+export { buildApplication, type ApplicationBuilderOptions } from './builders/application';
 export type { ApplicationBuilderExtensions } from './builders/application/options';
 export { type BuildOutputFile, BuildOutputFileType } from './tools/esbuild/bundler-context';
 export type { BuildOutputAsset } from './tools/esbuild/bundler-execution-result';
 export { executeDevServerBuilder, type DevServerBuilderOptions, type DevServerBuilderOutput, } from './builders/dev-server';
 export { execute as executeExtractI18nBuilder, type ExtractI18nBuilderOptions, } from './builders/extract-i18n';
+export { execute as executeNgPackagrBuilder, type NgPackagrBuilderOptions, } from './builders/ng-packagr';

package/src/index.js

@@ -7,7 +7,7 @@
  * found in the LICENSE file at https://angular.dev/license
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.executeExtractI18nBuilder = exports.executeDevServerBuilder = exports.BuildOutputFileType = exports.buildApplication = void 0;
+exports.executeNgPackagrBuilder = exports.executeExtractI18nBuilder = exports.executeDevServerBuilder = exports.BuildOutputFileType = exports.buildApplication = void 0;
 var application_1 = require("./builders/application");
 Object.defineProperty(exports, "buildApplication", { enumerable: true, get: function () { return application_1.buildApplication; } });
 var bundler_context_1 = require("./tools/esbuild/bundler-context");
@@ -16,3 +16,5 @@ var dev_server_1 = require("./builders/dev-server");
 Object.defineProperty(exports, "executeDevServerBuilder", { enumerable: true, get: function () { return dev_server_1.executeDevServerBuilder; } });
 var extract_i18n_1 = require("./builders/extract-i18n");
 Object.defineProperty(exports, "executeExtractI18nBuilder", { enumerable: true, get: function () { return extract_i18n_1.execute; } });
+var ng_packagr_1 = require("./builders/ng-packagr");
+Object.defineProperty(exports, "executeNgPackagrBuilder", { enumerable: true, get: function () { return ng_packagr_1.execute; } });

package/src/tools/babel/plugins/pure-toplevel-functions.js

@@ -64,6 +64,16 @@ function isTslibHelperName(name) {
     }
     return tslibHelpers.has(originalName);
 }
+const babelHelpers = new Set(['_defineProperty']);
+/**
+ * Determinates whether an identifier name matches one of the Babel helper function names.
+ *
+ * @param name The identifier name to check.
+ * @returns True, if the name matches a Babel helper name; otherwise, false.
+ */
+function isBabelHelperName(name) {
+    return babelHelpers.has(name);
+}
 /**
  * A babel plugin factory function for adding the PURE annotation to top-level new and call expressions.
  *
@@ -82,9 +92,10 @@ function default_1() {
                     path.node.arguments.length !== 0) {
                     return;
                 }
-                // Do not annotate TypeScript helpers emitted by the TypeScript compiler.
-                // TypeScript helpers are intended to cause side effects.
-                if (callee.isIdentifier() && isTslibHelperName(callee.node.name)) {
+                // Do not annotate TypeScript helpers emitted by the TypeScript compiler or Babel helpers.
+                // They are intended to cause side effects.
+                if (callee.isIdentifier() &&
+                    (isTslibHelperName(callee.node.name) || isBabelHelperName(callee.node.name))) {
                     return;
                 }
                 (0, helper_annotate_as_pure_1.default)(path);

package/src/tools/esbuild/angular-localize-init-warning-plugin.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @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
+ */
+import type { Plugin } from 'esbuild';
+/**
+ * This plugin addresses an issue where '@angular/localize/init' is directly imported,
+ * potentially resulting in undefined behavior. By detecting such imports, the plugin
+ * issues a warning and suggests including '@angular/localize/init' as a polyfill.
+ *
+ * @returns An esbuild plugin.
+ */
+export declare function createAngularLocalizeInitWarningPlugin(): Plugin;

package/src/tools/esbuild/angular-localize-init-warning-plugin.js

@@ -0,0 +1,49 @@
+"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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAngularLocalizeInitWarningPlugin = createAngularLocalizeInitWarningPlugin;
+const NG_LOCALIZE_RESOLUTION = Symbol('NG_LOCALIZE_RESOLUTION');
+/**
+ * This plugin addresses an issue where '@angular/localize/init' is directly imported,
+ * potentially resulting in undefined behavior. By detecting such imports, the plugin
+ * issues a warning and suggests including '@angular/localize/init' as a polyfill.
+ *
+ * @returns An esbuild plugin.
+ */
+function createAngularLocalizeInitWarningPlugin() {
+    return {
+        name: 'angular-localize-init-warning',
+        setup(build) {
+            build.onResolve({ filter: /^@angular\/localize\/init/ }, async (args) => {
+                if (args.pluginData?.[NG_LOCALIZE_RESOLUTION]) {
+                    return null;
+                }
+                const { importer, kind, resolveDir, namespace, pluginData = {} } = args;
+                pluginData[NG_LOCALIZE_RESOLUTION] = true;
+                const result = await build.resolve(args.path, {
+                    importer,
+                    kind,
+                    namespace,
+                    pluginData,
+                    resolveDir,
+                });
+                return {
+                    ...result,
+                    warnings: [
+                        ...result.warnings,
+                        {
+                            text: `Direct import of '@angular/localize/init' detected. This may lead to undefined behavior.`,
+                            notes: [{ text: `Include '@angular/localize/init' as a polyfill instead.` }],
+                        },
+                    ],
+                };
+            });
+        },
+    };
+}

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

@@ -22,6 +22,7 @@ const schema_1 = require("../../builders/application/schema");
 const environment_options_1 = require("../../utils/environment-options");
 const manifest_1 = require("../../utils/server-rendering/manifest");
 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");
 const external_packages_plugin_1 = require("./external-packages-plugin");
 const i18n_locale_plugin_1 = require("./i18n-locale-plugin");
@@ -53,6 +54,7 @@ function createBrowserCodeBundleOptions(options, target, sourceFileCache, styles
                 (0, loader_import_attribute_plugin_1.createLoaderImportAttributePlugin)(),
                 (0, wasm_plugin_1.createWasmPlugin)({ allowAsync: zoneless, cache: loadCache }),
                 (0, sourcemap_ignorelist_plugin_1.createSourcemapIgnorelistPlugin)(),
+                (0, angular_localize_init_warning_plugin_1.createAngularLocalizeInitWarningPlugin)(),
                 (0, compiler_plugin_1.createCompilerPlugin)(
                 // JS/TS options
                 pluginOptions, 
@@ -196,6 +198,7 @@ function createServerMainCodeBundleOptions(options, target, sourceFileCache, sty
             plugins: [
                 (0, wasm_plugin_1.createWasmPlugin)({ allowAsync: zoneless, cache: loadResultCache }),
                 (0, sourcemap_ignorelist_plugin_1.createSourcemapIgnorelistPlugin)(),
+                (0, angular_localize_init_warning_plugin_1.createAngularLocalizeInitWarningPlugin)(),
                 (0, compiler_plugin_1.createCompilerPlugin)(
                 // JS/TS options
                 { ...pluginOptions, noopTypeScriptCompilation: true }, 
@@ -299,6 +302,7 @@ function createSsrEntryCodeBundleOptions(options, target, sourceFileCache, style
             supported: (0, utils_1.getFeatureSupport)(target, true),
             plugins: [
                 (0, sourcemap_ignorelist_plugin_1.createSourcemapIgnorelistPlugin)(),
+                (0, angular_localize_init_warning_plugin_1.createAngularLocalizeInitWarningPlugin)(),
                 (0, compiler_plugin_1.createCompilerPlugin)(
                 // JS/TS options
                 { ...pluginOptions, noopTypeScriptCompilation: true }, 

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

@@ -22,7 +22,10 @@ export interface RebuildState {
     componentStyleBundler: ComponentStylesheetBundler;
     codeBundleCache?: SourceFileCache;
     fileChanges: ChangedFiles;
-    previousOutputHashes: Map<string, string>;
+    previousOutputInfo: Map<string, {
+        hash: string;
+        type: BuildOutputFileType;
+    }>;
     templateUpdates?: Map<string, string>;
 }
 export interface ExternalResultMetadata {
@@ -81,8 +84,11 @@ export declare class ExecutionResult {
         errors: (PartialMessage | Message)[];
         externalMetadata: ExternalResultMetadata | undefined;
     };
-    get watchFiles(): string[];
+    get watchFiles(): Readonly<string[]>;
     createRebuildState(fileChanges: ChangedFiles): RebuildState;
-    findChangedFiles(previousOutputHashes: Map<string, string>): Set<string>;
+    findChangedFiles(previousOutputHashes: Map<string, {
+        hash: string;
+        type: BuildOutputFileType;
+    }>): Set<string>;
     dispose(): Promise<void>;
 }