@angular/build 18.0.0-next.3

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (c) 2017 Google, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,5 @@
+# Angular Build System for Applications and Libraries
+
+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.

package/builders.json

@@ -0,0 +1,14 @@
+{
+  "builders": {
+    "application": {
+      "implementation": "./src/builders/application/index",
+      "schema": "./src/builders/application/schema.json",
+      "description": "Build an application."
+    },
+    "dev-server": {
+      "implementation": "./src/builders/dev-server/index",
+      "schema": "./src/builders/dev-server/schema.json",
+      "description": "Execute a development server for an application."
+    }
+  }
+}

package/package.json

@@ -0,0 +1,87 @@
+{
+  "name": "@angular/build",
+  "version": "18.0.0-next.3",
+  "description": "Official build system for Angular",
+  "keywords": [
+    "Angular CLI",
+    "Angular DevKit",
+    "angular",
+    "angular-cli",
+    "devkit",
+    "sdk"
+  ],
+  "exports": {
+    ".": {
+      "types": "./src/index.d.ts",
+      "default": "./src/index.js"
+    },
+    "./private": {
+      "default": "./src/private.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "builders": "builders.json",
+  "dependencies": {
+    "@ampproject/remapping": "2.3.0",
+    "@angular-devkit/architect": "0.1800.0-next.3",
+    "@babel/core": "7.24.4",
+    "@babel/helper-annotate-as-pure": "7.22.5",
+    "@babel/helper-split-export-declaration": "7.22.6",
+    "@vitejs/plugin-basic-ssl": "1.1.0",
+    "browserslist": "^4.23.0",
+    "critters": "0.0.22",
+    "esbuild": "0.20.2",
+    "fast-glob": "3.3.2",
+    "https-proxy-agent": "7.0.4",
+    "inquirer": "9.2.19",
+    "less": "4.2.0",
+    "magic-string": "0.30.10",
+    "mrmime": "2.0.0",
+    "ora": "5.4.1",
+    "piscina": "4.4.0",
+    "parse5-html-rewriting-stream": "7.0.0",
+    "postcss": "8.4.38",
+    "sass": "1.75.0",
+    "semver": "7.6.0",
+    "undici": "6.14.1",
+    "vite": "5.2.10",
+    "watchpack": "2.4.1"
+  },
+  "peerDependencies": {
+    "@angular/compiler-cli": "^18.0.0 || ^18.0.0-next.0",
+    "@angular/localize": "^18.0.0 || ^18.0.0-next.0",
+    "@angular/platform-server": "^18.0.0 || ^18.0.0-next.0",
+    "@angular/service-worker": "^18.0.0 || ^18.0.0-next.0",
+    "tailwindcss": "^2.0.0 || ^3.0.0",
+    "typescript": ">=5.4 <5.5"
+  },
+  "peerDependenciesMeta": {
+    "@angular/localize": {
+      "optional": true
+    },
+    "@angular/platform-server": {
+      "optional": true
+    },
+    "@angular/service-worker": {
+      "optional": true
+    },
+    "tailwindcss": {
+      "optional": true
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/angular/angular-cli.git"
+  },
+  "engines": {
+    "node": "^18.19.1 || >=20.11.1",
+    "npm": "^6.11.0 || ^7.5.6 || >=8.0.0",
+    "yarn": ">= 1.13.0"
+  },
+  "author": "Angular Authors",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/angular/angular-cli/issues"
+  },
+  "homepage": "https://github.com/angular/angular-cli"
+}

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

@@ -0,0 +1,33 @@
+/**
+ * @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.io/license
+ */
+import { BuilderContext, BuilderOutput } from '@angular-devkit/architect';
+import { BuildOutputFile } from '../../tools/esbuild/bundler-context';
+import { ExecutionResult, RebuildState } from '../../tools/esbuild/bundler-execution-result';
+import { NormalizedCachedOptions } from '../../utils/normalize-cache';
+import { NormalizedOutputOptions } from './options';
+type BuildActionOutput = (ExecutionResult['outputWithFiles'] | ExecutionResult['output']) & BuilderOutput;
+export declare function runEsBuildBuildAction(action: (rebuildState?: RebuildState) => Promise<ExecutionResult>, options: {
+    workspaceRoot: string;
+    projectRoot: string;
+    outputOptions: NormalizedOutputOptions;
+    logger: BuilderContext['logger'];
+    cacheOptions: NormalizedCachedOptions;
+    writeToFileSystem: boolean;
+    writeToFileSystemFilter: ((file: BuildOutputFile) => boolean) | undefined;
+    watch?: boolean;
+    verbose?: boolean;
+    progress?: boolean;
+    deleteOutputPath?: boolean;
+    poll?: number;
+    signal?: AbortSignal;
+    preserveSymlinks?: boolean;
+    clearScreen?: boolean;
+    colors?: boolean;
+    jsonLogs?: boolean;
+}): AsyncIterable<BuildActionOutput>;
+export {};

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

@@ -0,0 +1,183 @@
+"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.io/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 (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runEsBuildBuildAction = void 0;
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+const sass_language_1 = require("../../tools/esbuild/stylesheets/sass-language");
+const utils_1 = require("../../tools/esbuild/utils");
+const delete_output_dir_1 = require("../../utils/delete-output-dir");
+const environment_options_1 = require("../../utils/environment-options");
+// Watch workspace for package manager changes
+const packageWatchFiles = [
+    // manifest can affect module resolution
+    'package.json',
+    // npm lock file
+    'package-lock.json',
+    // pnpm lock file
+    'pnpm-lock.yaml',
+    // yarn lock file including Yarn PnP manifest files (https://yarnpkg.com/advanced/pnp-spec/)
+    'yarn.lock',
+    '.pnp.cjs',
+    '.pnp.data.json',
+];
+async function* runEsBuildBuildAction(action, options) {
+    const { writeToFileSystemFilter, writeToFileSystem, watch, poll, clearScreen, logger, deleteOutputPath, cacheOptions, outputOptions, verbose, projectRoot, workspaceRoot, progress, preserveSymlinks, colors, jsonLogs, } = options;
+    if (deleteOutputPath && writeToFileSystem) {
+        await (0, delete_output_dir_1.deleteOutputDir)(workspaceRoot, outputOptions.base, [
+            outputOptions.browser,
+            outputOptions.server,
+        ]);
+    }
+    const withProgress = progress ? utils_1.withSpinner : utils_1.withNoProgress;
+    // Initial build
+    let result;
+    try {
+        // Perform the build action
+        result = await withProgress('Building...', () => action());
+        // Log all diagnostic (error/warning/logs) messages
+        await (0, utils_1.logMessages)(logger, result, colors, jsonLogs);
+    }
+    finally {
+        // Ensure Sass workers are shutdown if not watching
+        if (!watch) {
+            (0, sass_language_1.shutdownSassWorkerPool)();
+        }
+    }
+    // Setup watcher if watch mode enabled
+    let watcher;
+    if (watch) {
+        if (progress) {
+            logger.info('Watch mode enabled. Watching for file changes...');
+        }
+        const ignored = [
+            // Ignore the output and cache paths to avoid infinite rebuild cycles
+            outputOptions.base,
+            cacheOptions.basePath,
+            `${workspaceRoot.replace(/\\/g, '/')}/**/.*/**`,
+        ];
+        if (!preserveSymlinks) {
+            // Ignore all node modules directories to avoid excessive file watchers.
+            // Package changes are handled below by watching manifest and lock files.
+            // NOTE: this is not enable when preserveSymlinks is true as this would break `npm link` usages.
+            ignored.push('**/node_modules/**');
+        }
+        // Setup a watcher
+        const { createWatcher } = await Promise.resolve().then(() => __importStar(require('../../tools/esbuild/watcher')));
+        watcher = createWatcher({
+            polling: typeof poll === 'number',
+            interval: poll,
+            followSymlinks: preserveSymlinks,
+            ignored,
+        });
+        // Setup abort support
+        options.signal?.addEventListener('abort', () => void watcher?.close());
+        // Watch the entire project root if 'NG_BUILD_WATCH_ROOT' environment variable is set
+        if (environment_options_1.shouldWatchRoot) {
+            watcher.add(projectRoot);
+        }
+        watcher.add(packageWatchFiles
+            .map((file) => node_path_1.default.join(workspaceRoot, file))
+            .filter((file) => (0, node_fs_1.existsSync)(file)));
+        // Watch locations provided by the initial build result
+        watcher.add(result.watchFiles);
+    }
+    // Output the first build results after setting up the watcher to ensure that any code executed
+    // higher in the iterator call stack will trigger the watcher. This is particularly relevant for
+    // unit tests which execute the builder and modify the file system programmatically.
+    yield await writeAndEmitOutput(writeToFileSystem, result, outputOptions, writeToFileSystemFilter);
+    // Finish if watch mode is not enabled
+    if (!watcher) {
+        return;
+    }
+    // Wait for changes and rebuild as needed
+    const currentWatchFiles = new Set(result.watchFiles);
+    try {
+        for await (const changes of watcher) {
+            if (options.signal?.aborted) {
+                break;
+            }
+            if (clearScreen) {
+                // eslint-disable-next-line no-console
+                console.clear();
+            }
+            if (verbose) {
+                logger.info(changes.toDebugString());
+            }
+            result = await withProgress('Changes detected. Rebuilding...', () => action(result.createRebuildState(changes)));
+            // Log all diagnostic (error/warning/logs) messages
+            await (0, utils_1.logMessages)(logger, result, colors, jsonLogs);
+            // Update watched locations provided by the new build result.
+            // Keep watching all previous files if there are any errors; otherwise consider all
+            // files stale until confirmed present in the new result's watch files.
+            const staleWatchFiles = result.errors.length > 0 ? undefined : new Set(currentWatchFiles);
+            for (const watchFile of result.watchFiles) {
+                if (!currentWatchFiles.has(watchFile)) {
+                    // Add new watch location
+                    watcher.add(watchFile);
+                    currentWatchFiles.add(watchFile);
+                }
+                // Present so remove from stale locations
+                staleWatchFiles?.delete(watchFile);
+            }
+            // Remove any stale locations if the build was successful
+            if (staleWatchFiles?.size) {
+                watcher.remove([...staleWatchFiles]);
+            }
+            yield await writeAndEmitOutput(writeToFileSystem, result, outputOptions, writeToFileSystemFilter);
+        }
+    }
+    finally {
+        // Stop the watcher and cleanup incremental rebuild state
+        await Promise.allSettled([watcher.close(), result.dispose()]);
+        (0, sass_language_1.shutdownSassWorkerPool)();
+    }
+}
+exports.runEsBuildBuildAction = runEsBuildBuildAction;
+async function writeAndEmitOutput(writeToFileSystem, { outputFiles, output, outputWithFiles, assetFiles }, outputOptions, writeToFileSystemFilter) {
+    if (writeToFileSystem) {
+        // Write output files
+        const outputFilesToWrite = writeToFileSystemFilter
+            ? outputFiles.filter(writeToFileSystemFilter)
+            : outputFiles;
+        await (0, utils_1.writeResultFiles)(outputFilesToWrite, assetFiles, outputOptions);
+        return output;
+    }
+    else {
+        // Requires casting due to unneeded `JsonObject` requirement. Remove once fixed.
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        return outputWithFiles;
+    }
+}

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

@@ -0,0 +1,11 @@
+/**
+ * @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.io/license
+ */
+import { BuilderContext } from '@angular-devkit/architect';
+import { ExecutionResult, RebuildState } from '../../tools/esbuild/bundler-execution-result';
+import { NormalizedApplicationBuildOptions } from './options';
+export declare function executeBuild(options: NormalizedApplicationBuildOptions, context: BuilderContext, rebuildState?: RebuildState): Promise<ExecutionResult>;

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

@@ -0,0 +1,125 @@
+"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.io/license
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeBuild = void 0;
+const source_file_cache_1 = require("../../tools/esbuild/angular/source-file-cache");
+const budget_stats_1 = require("../../tools/esbuild/budget-stats");
+const bundler_context_1 = require("../../tools/esbuild/bundler-context");
+const bundler_execution_result_1 = require("../../tools/esbuild/bundler-execution-result");
+const commonjs_checker_1 = require("../../tools/esbuild/commonjs-checker");
+const license_extractor_1 = require("../../tools/esbuild/license-extractor");
+const utils_1 = require("../../tools/esbuild/utils");
+const bundle_calculator_1 = require("../../utils/bundle-calculator");
+const resolve_assets_1 = require("../../utils/resolve-assets");
+const supported_browsers_1 = require("../../utils/supported-browsers");
+const execute_post_bundle_1 = require("./execute-post-bundle");
+const i18n_1 = require("./i18n");
+const setup_bundling_1 = require("./setup-bundling");
+async function executeBuild(options, context, rebuildState) {
+    const { projectRoot, workspaceRoot, i18nOptions, optimizationOptions, assets, cacheOptions, prerenderOptions, ssrOptions, verbose, colors, jsonLogs, } = options;
+    // TODO: Consider integrating into watch mode. Would require full rebuild on target changes.
+    const browsers = (0, supported_browsers_1.getSupportedBrowsers)(projectRoot, context.logger);
+    // Load active translations if inlining
+    // TODO: Integrate into watch mode and only load changed translations
+    if (i18nOptions.shouldInline) {
+        await (0, i18n_1.loadActiveTranslations)(context, i18nOptions);
+    }
+    // Reuse rebuild state or create new bundle contexts for code and global stylesheets
+    let bundlerContexts = rebuildState?.rebuildContexts;
+    const codeBundleCache = rebuildState?.codeBundleCache ??
+        new source_file_cache_1.SourceFileCache(cacheOptions.enabled ? cacheOptions.path : undefined);
+    if (bundlerContexts === undefined) {
+        bundlerContexts = (0, setup_bundling_1.setupBundlerContexts)(options, browsers, codeBundleCache);
+    }
+    const bundlingResult = await bundler_context_1.BundlerContext.bundleAll(bundlerContexts, rebuildState?.fileChanges.all);
+    const executionResult = new bundler_execution_result_1.ExecutionResult(bundlerContexts, codeBundleCache);
+    executionResult.addWarnings(bundlingResult.warnings);
+    // Return if the bundling has errors
+    if (bundlingResult.errors) {
+        executionResult.addErrors(bundlingResult.errors);
+        return executionResult;
+    }
+    // Analyze external imports if external options are enabled
+    if (options.externalPackages || bundlingResult.externalConfiguration) {
+        const { externalConfiguration, externalImports: { browser, server }, } = bundlingResult;
+        const implicitBrowser = browser ? [...browser] : [];
+        const implicitServer = server ? [...server] : [];
+        // TODO: Implement wildcard externalConfiguration filtering
+        executionResult.setExternalMetadata(externalConfiguration
+            ? implicitBrowser.filter((value) => !externalConfiguration.includes(value))
+            : implicitBrowser, externalConfiguration
+            ? implicitServer.filter((value) => !externalConfiguration.includes(value))
+            : implicitServer, externalConfiguration);
+    }
+    const { metafile, initialFiles, outputFiles } = bundlingResult;
+    executionResult.outputFiles.push(...outputFiles);
+    const changedFiles = rebuildState && executionResult.findChangedFiles(rebuildState.previousOutputHashes);
+    // Analyze files for bundle budget failures if present
+    let budgetFailures;
+    if (options.budgets) {
+        const compatStats = (0, budget_stats_1.generateBudgetStats)(metafile, initialFiles);
+        budgetFailures = [...(0, bundle_calculator_1.checkBudgets)(options.budgets, compatStats, true)];
+        for (const { message, severity } of budgetFailures) {
+            if (severity === 'error') {
+                executionResult.addError(message);
+            }
+            else {
+                executionResult.addWarning(message);
+            }
+        }
+    }
+    // Calculate estimated transfer size if scripts are optimized
+    let estimatedTransferSizes;
+    if (optimizationOptions.scripts || optimizationOptions.styles.minify) {
+        estimatedTransferSizes = await (0, utils_1.calculateEstimatedTransferSizes)(executionResult.outputFiles);
+    }
+    // Check metafile for CommonJS module usage if optimizing scripts
+    if (optimizationOptions.scripts) {
+        const messages = (0, commonjs_checker_1.checkCommonJSModules)(metafile, options.allowedCommonJsDependencies);
+        executionResult.addWarnings(messages);
+    }
+    // Copy assets
+    if (assets) {
+        executionResult.addAssets(await (0, resolve_assets_1.resolveAssets)(assets, workspaceRoot));
+    }
+    // Extract and write licenses for used packages
+    if (options.extractLicenses) {
+        executionResult.addOutputFile('3rdpartylicenses.txt', await (0, license_extractor_1.extractLicenses)(metafile, workspaceRoot), bundler_context_1.BuildOutputFileType.Root);
+    }
+    // Perform i18n translation inlining if enabled
+    if (i18nOptions.shouldInline) {
+        const result = await (0, i18n_1.inlineI18n)(options, executionResult, initialFiles);
+        executionResult.addErrors(result.errors);
+        executionResult.addWarnings(result.warnings);
+        executionResult.addPrerenderedRoutes(result.prerenderedRoutes);
+    }
+    else {
+        const result = await (0, execute_post_bundle_1.executePostBundleSteps)(options, executionResult.outputFiles, executionResult.assetFiles, initialFiles, 
+        // Set lang attribute to the defined source locale if present
+        i18nOptions.hasDefinedSourceLocale ? i18nOptions.sourceLocale : undefined);
+        executionResult.addErrors(result.errors);
+        executionResult.addWarnings(result.warnings);
+        executionResult.addPrerenderedRoutes(result.prerenderedRoutes);
+        executionResult.outputFiles.push(...result.additionalOutputFiles);
+        executionResult.assetFiles.push(...result.additionalAssets);
+    }
+    if (prerenderOptions) {
+        const prerenderedRoutes = executionResult.prerenderedRoutes;
+        executionResult.addOutputFile('prerendered-routes.json', JSON.stringify({ routes: prerenderedRoutes }, null, 2), bundler_context_1.BuildOutputFileType.Root);
+    }
+    // Write metafile if stats option is enabled
+    if (options.stats) {
+        executionResult.addOutputFile('stats.json', JSON.stringify(metafile, null, 2), bundler_context_1.BuildOutputFileType.Root);
+    }
+    if (!jsonLogs) {
+        executionResult.addLog((0, utils_1.logBuildStats)(metafile, initialFiles, budgetFailures, colors, changedFiles, estimatedTransferSizes, !!ssrOptions, verbose));
+    }
+    return executionResult;
+}
+exports.executeBuild = executeBuild;

package/src/builders/application/execute-post-bundle.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @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.io/license
+ */
+import { BuildOutputFile, InitialFileRecord } from '../../tools/esbuild/bundler-context';
+import { BuildOutputAsset } from '../../tools/esbuild/bundler-execution-result';
+import { NormalizedApplicationBuildOptions } from './options';
+/**
+ * Run additional builds steps including SSG, AppShell, Index HTML file and Service worker generation.
+ * @param options The normalized application builder options used to create the build.
+ * @param outputFiles The output files of an executed build.
+ * @param assetFiles The assets of an executed build.
+ * @param initialFiles A map containing initial file information for the executed build.
+ * @param locale A language locale to insert in the index.html.
+ */
+export declare function executePostBundleSteps(options: NormalizedApplicationBuildOptions, outputFiles: BuildOutputFile[], assetFiles: BuildOutputAsset[], initialFiles: Map<string, InitialFileRecord>, locale: string | undefined): Promise<{
+    errors: string[];
+    warnings: string[];
+    additionalOutputFiles: BuildOutputFile[];
+    additionalAssets: BuildOutputAsset[];
+    prerenderedRoutes: string[];
+}>;

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

@@ -0,0 +1,93 @@
+"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.io/license
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executePostBundleSteps = void 0;
+const node_assert_1 = __importDefault(require("node:assert"));
+const bundler_context_1 = require("../../tools/esbuild/bundler-context");
+const index_html_generator_1 = require("../../tools/esbuild/index-html-generator");
+const utils_1 = require("../../tools/esbuild/utils");
+const environment_options_1 = require("../../utils/environment-options");
+const prerender_1 = require("../../utils/server-rendering/prerender");
+const service_worker_1 = require("../../utils/service-worker");
+/**
+ * Run additional builds steps including SSG, AppShell, Index HTML file and Service worker generation.
+ * @param options The normalized application builder options used to create the build.
+ * @param outputFiles The output files of an executed build.
+ * @param assetFiles The assets of an executed build.
+ * @param initialFiles A map containing initial file information for the executed build.
+ * @param locale A language locale to insert in the index.html.
+ */
+async function executePostBundleSteps(options, outputFiles, assetFiles, initialFiles, locale) {
+    const additionalAssets = [];
+    const additionalOutputFiles = [];
+    const allErrors = [];
+    const allWarnings = [];
+    const prerenderedRoutes = [];
+    const { serviceWorker, indexHtmlOptions, optimizationOptions, sourcemapOptions, prerenderOptions, appShellOptions, workspaceRoot, verbose, } = options;
+    /**
+     * Index HTML content without CSS inlining to be used for server rendering (AppShell, SSG and SSR).
+     *
+     * NOTE: we don't perform critical CSS inlining as this will be done during server rendering.
+     */
+    let ssrIndexContent;
+    // When using prerender/app-shell the index HTML file can be regenerated.
+    // Thus, we use a Map so that we do not generate 2 files with the same filename.
+    const additionalHtmlOutputFiles = new Map();
+    // Generate index HTML file
+    // If localization is enabled, index generation is handled in the inlining process.
+    if (indexHtmlOptions) {
+        const { csrContent, ssrContent, errors, warnings } = await (0, index_html_generator_1.generateIndexHtml)(initialFiles, outputFiles, options, locale);
+        allErrors.push(...errors);
+        allWarnings.push(...warnings);
+        additionalHtmlOutputFiles.set(indexHtmlOptions.output, (0, utils_1.createOutputFileFromText)(indexHtmlOptions.output, csrContent, bundler_context_1.BuildOutputFileType.Browser));
+        if (ssrContent) {
+            const serverIndexHtmlFilename = 'index.server.html';
+            additionalHtmlOutputFiles.set(serverIndexHtmlFilename, (0, utils_1.createOutputFileFromText)(serverIndexHtmlFilename, ssrContent, bundler_context_1.BuildOutputFileType.Server));
+            ssrIndexContent = ssrContent;
+        }
+    }
+    // Pre-render (SSG) and App-shell
+    // If localization is enabled, prerendering is handled in the inlining process.
+    if (prerenderOptions || appShellOptions) {
+        (0, node_assert_1.default)(ssrIndexContent, 'The "index" option is required when using the "ssg" or "appShell" options.');
+        const { output, warnings, errors, prerenderedRoutes: generatedRoutes, } = await (0, prerender_1.prerenderPages)(workspaceRoot, appShellOptions, prerenderOptions, outputFiles, assetFiles, ssrIndexContent, sourcemapOptions.scripts, optimizationOptions.styles.inlineCritical, environment_options_1.maxWorkers, verbose);
+        allErrors.push(...errors);
+        allWarnings.push(...warnings);
+        prerenderedRoutes.push(...Array.from(generatedRoutes));
+        for (const [path, content] of Object.entries(output)) {
+            additionalHtmlOutputFiles.set(path, (0, utils_1.createOutputFileFromText)(path, content, bundler_context_1.BuildOutputFileType.Browser));
+        }
+    }
+    additionalOutputFiles.push(...additionalHtmlOutputFiles.values());
+    // Augment the application with service worker support
+    // If localization is enabled, service worker is handled in the inlining process.
+    if (serviceWorker) {
+        try {
+            const serviceWorkerResult = await (0, service_worker_1.augmentAppWithServiceWorkerEsbuild)(workspaceRoot, serviceWorker, options.baseHref || '/', options.indexHtmlOptions?.output, 
+            // Ensure additional files recently added are used
+            [...outputFiles, ...additionalOutputFiles], assetFiles);
+            additionalOutputFiles.push((0, utils_1.createOutputFileFromText)('ngsw.json', serviceWorkerResult.manifest, bundler_context_1.BuildOutputFileType.Browser));
+            additionalAssets.push(...serviceWorkerResult.assetFiles);
+        }
+        catch (error) {
+            allErrors.push(error instanceof Error ? error.message : `${error}`);
+        }
+    }
+    return {
+        errors: allErrors,
+        warnings: allWarnings,
+        additionalAssets,
+        prerenderedRoutes,
+        additionalOutputFiles,
+    };
+}
+exports.executePostBundleSteps = executePostBundleSteps;

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

@@ -0,0 +1,29 @@
+/**
+ * @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.io/license
+ */
+import { BuilderContext } from '@angular-devkit/architect';
+import { InitialFileRecord } from '../../tools/esbuild/bundler-context';
+import { ExecutionResult } from '../../tools/esbuild/bundler-execution-result';
+import { NormalizedApplicationBuildOptions } from './options';
+/**
+ * Inlines all active locales as specified by the application build options into all
+ * application JavaScript files created during the build.
+ * @param options The normalized application builder options used to create the build.
+ * @param executionResult The result of an executed build.
+ * @param initialFiles A map containing initial file information for the executed build.
+ */
+export declare function inlineI18n(options: NormalizedApplicationBuildOptions, executionResult: ExecutionResult, initialFiles: Map<string, InitialFileRecord>): Promise<{
+    errors: string[];
+    warnings: string[];
+    prerenderedRoutes: string[];
+}>;
+/**
+ * Loads all active translations using the translation loaders from the `@angular/localize` package.
+ * @param context The architect builder context for the current build.
+ * @param i18n The normalized i18n options to use.
+ */
+export declare function loadActiveTranslations(context: BuilderContext, i18n: NormalizedApplicationBuildOptions['i18nOptions']): Promise<void>;