@angular-devkit/build-angular 14.0.0-next.9 → 14.0.0-rc.0

package/builders.json

@@ -11,6 +11,11 @@
       "schema": "./src/builders/browser/schema.json",
       "description": "Build a browser application."
     },
+    "browser-esbuild": {
+      "implementation": "./src/builders/browser-esbuild",
+      "schema": "./src/builders/browser/schema.json",
+      "description": "Build a browser application."
+    },
     "dev-server": {
       "implementation": "./src/builders/dev-server",
       "schema": "./src/builders/dev-server/schema.json",

package/package.json

@@ -1,38 +1,38 @@
 {
   "name": "@angular-devkit/build-angular",
-  "version": "14.0.0-next.9",
+  "version": "14.0.0-rc.0",
   "description": "Angular Webpack Build Facade",
   "main": "src/index.js",
   "typings": "src/index.d.ts",
   "builders": "builders.json",
   "dependencies": {
-    "@ampproject/remapping": "2.1.2",
-    "@angular-devkit/architect": "0.1400.0-next.9",
-    "@angular-devkit/build-webpack": "0.1400.0-next.9",
-    "@angular-devkit/core": "14.0.0-next.9",
-    "@babel/core": "7.17.9",
-    "@babel/generator": "7.17.9",
+    "@ampproject/remapping": "2.2.0",
+    "@angular-devkit/architect": "0.1400.0-rc.0",
+    "@angular-devkit/build-webpack": "0.1400.0-rc.0",
+    "@angular-devkit/core": "14.0.0-rc.0",
+    "@babel/core": "7.17.10",
+    "@babel/generator": "7.17.10",
     "@babel/helper-annotate-as-pure": "7.16.7",
     "@babel/plugin-proposal-async-generator-functions": "7.16.8",
     "@babel/plugin-transform-async-to-generator": "7.16.8",
-    "@babel/plugin-transform-runtime": "7.17.0",
-    "@babel/preset-env": "7.16.11",
+    "@babel/plugin-transform-runtime": "7.17.10",
+    "@babel/preset-env": "7.17.10",
     "@babel/runtime": "7.17.9",
     "@babel/template": "7.16.7",
     "@discoveryjs/json-ext": "0.5.7",
-    "@ngtools/webpack": "14.0.0-next.9",
+    "@ngtools/webpack": "14.0.0-rc.0",
     "ansi-colors": "4.1.1",
-    "babel-loader": "8.2.4",
+    "babel-loader": "8.2.5",
     "babel-plugin-istanbul": "6.1.1",
     "browserslist": "^4.9.1",
-    "cacache": "16.0.4",
+    "cacache": "16.0.7",
     "copy-webpack-plugin": "10.2.4",
     "critters": "0.0.16",
     "css-loader": "6.7.1",
-    "esbuild-wasm": "0.14.36",
-    "glob": "7.2.0",
-    "https-proxy-agent": "5.0.0",
-    "inquirer": "8.2.2",
+    "esbuild-wasm": "0.14.38",
+    "glob": "8.0.1",
+    "https-proxy-agent": "5.0.1",
+    "inquirer": "8.2.4",
     "jsonc-parser": "3.0.0",
     "karma-source-map-support": "1.4.0",
     "less": "4.1.2",
@@ -45,42 +45,42 @@
     "ora": "5.4.1",
     "parse5-html-rewriting-stream": "6.0.1",
     "piscina": "3.2.0",
-    "postcss": "8.4.12",
+    "postcss": "8.4.13",
     "postcss-import": "14.1.0",
     "postcss-loader": "6.2.1",
-    "postcss-preset-env": "7.4.3",
+    "postcss-preset-env": "7.5.0",
     "regenerator-runtime": "0.13.9",
     "resolve-url-loader": "5.0.0",
     "rxjs": "6.6.7",
-    "sass": "1.50.0",
+    "sass": "1.51.0",
     "sass-loader": "12.6.0",
-    "semver": "7.3.6",
+    "semver": "7.3.7",
     "source-map-loader": "3.0.1",
     "source-map-support": "0.5.21",
     "stylus": "0.57.0",
     "stylus-loader": "6.2.0",
-    "terser": "5.12.1",
+    "terser": "5.13.1",
     "text-table": "0.2.0",
     "tree-kill": "1.2.2",
-    "tslib": "2.3.1",
-    "webpack": "5.72.0",
+    "tslib": "2.4.0",
+    "webpack": "5.72.1",
     "webpack-dev-middleware": "5.3.1",
-    "webpack-dev-server": "4.8.1",
+    "webpack-dev-server": "4.9.0",
     "webpack-merge": "5.8.0",
     "webpack-subresource-integrity": "5.1.0"
   },
   "optionalDependencies": {
-    "esbuild": "0.14.36"
+    "esbuild": "0.14.38"
   },
   "peerDependencies": {
-    "@angular/compiler-cli": "^14.0.0 || ^14.0.0-next",
-    "@angular/localize": "^14.0.0 || ^14.0.0-next",
-    "@angular/service-worker": "^14.0.0 || ^14.0.0-next",
+    "@angular/compiler-cli": "^14.0.0 || ^14.0.0-rc",
+    "@angular/localize": "^14.0.0 || ^14.0.0-rc",
+    "@angular/service-worker": "^14.0.0 || ^14.0.0-rc",
     "karma": "^6.3.0",
     "ng-packagr": "^14.0.0 || ^14.0.0-next",
     "protractor": "^7.0.0",
     "tailwindcss": "^2.0.0 || ^3.0.0",
-    "typescript": "~4.6.2"
+    "typescript": ">=4.6.2 <4.8"
   },
   "peerDependenciesMeta": {
     "@angular/localize": {

package/src/babel/presets/application.d.ts

@@ -5,7 +5,7 @@
  * 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 type { ɵParsedTranslation } from '@angular/localize/private';
+import type { ɵParsedTranslation } from '@angular/localize';
 import type { makeEs2015TranslatePlugin, makeEs5TranslatePlugin, makeLocalePlugin } from '@angular/localize/tools';
 export declare type DiagnosticReporter = (type: 'error' | 'warning' | 'info', message: string) => void;
 /**

package/src/babel/webpack-loader.d.ts

@@ -14,5 +14,6 @@ interface AngularCustomOptions extends Omit<ApplicationPresetOptions, 'instrumen
     };
 }
 export declare type AngularBabelLoaderOptions = AngularCustomOptions & Record<string, unknown>;
+export declare function requiresLinking(path: string, source: string): Promise<boolean>;
 declare const _default: any;
 export default _default;

package/src/babel/webpack-loader.js

@@ -7,6 +7,7 @@
  * found in the LICENSE file at https://angular.io/license
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.requiresLinking = void 0;
 const babel_loader_1 = require("babel-loader");
 const typescript_1 = require("typescript");
 const load_esm_1 = require("../utils/load-esm");
@@ -38,6 +39,7 @@ async function requiresLinking(path, source) {
     }
     return needsLinking(path, source);
 }
+exports.requiresLinking = requiresLinking;
 // eslint-disable-next-line max-lines-per-function
 exports.default = (0, babel_loader_1.custom)(() => {
     const baseOptions = Object.freeze({

package/src/builders/app-shell/index.js

@@ -95,7 +95,7 @@ async function _renderUniversal(options, context, browserResult, serverResult, s
         }
         await fs.promises.writeFile(outputIndexPath, html);
         if (browserOptions.serviceWorker) {
-            await (0, service_worker_1.augmentAppWithServiceWorker)(projectRoot, outputPath, browserOptions.baseHref || '/', browserOptions.ngswConfigPath);
+            await (0, service_worker_1.augmentAppWithServiceWorker)(projectRoot, root, outputPath, browserOptions.baseHref || '/', browserOptions.ngswConfigPath);
         }
     }
     return browserResult;

package/src/builders/browser/index.js

@@ -252,7 +252,7 @@ function buildWebpackBrowser(options, context, transforms = {}) {
                         spinner.start('Generating service worker...');
                         for (const [locale, outputPath] of outputPaths.entries()) {
                             try {
-                                await (0, service_worker_1.augmentAppWithServiceWorker)(projectRoot, outputPath, getLocaleBaseHref(i18n, locale) || options.baseHref || '/', options.ngswConfigPath);
+                                await (0, service_worker_1.augmentAppWithServiceWorker)(projectRoot, context.workspaceRoot, outputPath, getLocaleBaseHref(i18n, locale) || options.baseHref || '/', options.ngswConfigPath);
                             }
                             catch (error) {
                                 spinner.fail('Service worker generation failed.');

package/src/builders/browser-esbuild/compiler-plugin.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @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 type { Plugin } from 'esbuild';
+import { BundleStylesheetOptions } from './stylesheets';
+export declare function createCompilerPlugin(pluginOptions: {
+    sourcemap: boolean;
+    tsconfig: string;
+    advancedOptimizations?: boolean;
+}, styleOptions: BundleStylesheetOptions): Plugin;

package/src/builders/browser-esbuild/compiler-plugin.js

@@ -0,0 +1,338 @@
+"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.createCompilerPlugin = void 0;
+const core_1 = require("@babel/core");
+const assert = __importStar(require("assert"));
+const fs_1 = require("fs");
+const path = __importStar(require("path"));
+const typescript_1 = __importDefault(require("typescript"));
+const application_1 = __importDefault(require("../../babel/presets/application"));
+const webpack_loader_1 = require("../../babel/webpack-loader");
+const load_esm_1 = require("../../utils/load-esm");
+const stylesheets_1 = require("./stylesheets");
+/**
+ * Converts TypeScript Diagnostic related information into an esbuild compatible note object.
+ * Related information is a subset of a full TypeScript Diagnostic and also used for diagnostic
+ * notes associated with the main Diagnostic.
+ * @param diagnostic The TypeScript diagnostic relative information to convert.
+ * @param host A TypeScript FormatDiagnosticsHost instance to use during conversion.
+ * @returns An esbuild diagnostic message as a PartialMessage object
+ */
+function convertTypeScriptDiagnosticInfo(info, host, textPrefix) {
+    let text = typescript_1.default.flattenDiagnosticMessageText(info.messageText, host.getNewLine());
+    if (textPrefix) {
+        text = textPrefix + text;
+    }
+    const note = { text };
+    if (info.file) {
+        note.location = {
+            file: info.file.fileName,
+            length: info.length,
+        };
+        // Calculate the line/column location and extract the full line text that has the diagnostic
+        if (info.start) {
+            const { line, character } = typescript_1.default.getLineAndCharacterOfPosition(info.file, info.start);
+            note.location.line = line + 1;
+            note.location.column = character;
+            // The start position for the slice is the first character of the error line
+            const lineStartPosition = typescript_1.default.getPositionOfLineAndCharacter(info.file, line, 0);
+            // The end position for the slice is the first character of the next line or the length of
+            // the entire file if the line is the last line of the file (getPositionOfLineAndCharacter
+            // will error if a nonexistent line is passed).
+            const { line: lastLineOfFile } = typescript_1.default.getLineAndCharacterOfPosition(info.file, info.file.text.length - 1);
+            const lineEndPosition = line < lastLineOfFile
+                ? typescript_1.default.getPositionOfLineAndCharacter(info.file, line + 1, 0)
+                : info.file.text.length;
+            note.location.lineText = info.file.text.slice(lineStartPosition, lineEndPosition).trimEnd();
+        }
+    }
+    return note;
+}
+/**
+ * Converts a TypeScript Diagnostic message into an esbuild compatible message object.
+ * @param diagnostic The TypeScript diagnostic to convert.
+ * @param host A TypeScript FormatDiagnosticsHost instance to use during conversion.
+ * @returns An esbuild diagnostic message as a PartialMessage object
+ */
+function convertTypeScriptDiagnostic(diagnostic, host) {
+    var _a;
+    let codePrefix = 'TS';
+    let code = `${diagnostic.code}`;
+    if (diagnostic.source === 'ngtsc') {
+        codePrefix = 'NG';
+        // Remove `-99` Angular prefix from diagnostic code
+        code = code.slice(3);
+    }
+    const message = {
+        ...convertTypeScriptDiagnosticInfo(diagnostic, host, `${codePrefix}${code}: `),
+        // Store original diagnostic for reference if needed downstream
+        detail: diagnostic,
+    };
+    if ((_a = diagnostic.relatedInformation) === null || _a === void 0 ? void 0 : _a.length) {
+        message.notes = diagnostic.relatedInformation.map((info) => convertTypeScriptDiagnosticInfo(info, host));
+    }
+    return message;
+}
+// This is a non-watch version of the compiler code from `@ngtools/webpack` augmented for esbuild
+// eslint-disable-next-line max-lines-per-function
+function createCompilerPlugin(pluginOptions, styleOptions) {
+    return {
+        name: 'angular-compiler',
+        // eslint-disable-next-line max-lines-per-function
+        async setup(build) {
+            var _a;
+            var _b;
+            // This uses a wrapped dynamic import to load `@angular/compiler-cli` which is ESM.
+            // Once TypeScript provides support for retaining dynamic imports this workaround can be dropped.
+            const compilerCli = await (0, load_esm_1.loadEsmModule)('@angular/compiler-cli');
+            // Temporary deep import for transformer support
+            const { createAotTransformers, mergeTransformers, } = require('@ngtools/webpack/src/ivy/transformation');
+            // Setup defines based on the values provided by the Angular compiler-cli
+            (_a = (_b = build.initialOptions).define) !== null && _a !== void 0 ? _a : (_b.define = {});
+            for (const [key, value] of Object.entries(compilerCli.GLOBAL_DEFS_FOR_TERSER_WITH_AOT)) {
+                if (key in build.initialOptions.define) {
+                    // Skip keys that have been manually provided
+                    continue;
+                }
+                // esbuild requires values to be a string (actual strings need to be quoted).
+                // In this case, all provided values are booleans.
+                build.initialOptions.define[key] = value.toString();
+            }
+            // The tsconfig is loaded in setup instead of in start to allow the esbuild target build option to be modified.
+            // esbuild build options can only be modified in setup prior to starting the build.
+            const { options: compilerOptions, rootNames, errors: configurationDiagnostics, } = compilerCli.readConfiguration(pluginOptions.tsconfig, {
+                enableIvy: true,
+                noEmitOnError: false,
+                suppressOutputPathCheck: true,
+                outDir: undefined,
+                inlineSources: pluginOptions.sourcemap,
+                inlineSourceMap: pluginOptions.sourcemap,
+                sourceMap: false,
+                mapRoot: undefined,
+                sourceRoot: undefined,
+                declaration: false,
+                declarationMap: false,
+                allowEmptyCodegenFiles: false,
+                annotationsAs: 'decorators',
+                enableResourceInlining: false,
+            });
+            // Adjust the esbuild output target based on the tsconfig target
+            if (compilerOptions.target === undefined ||
+                compilerOptions.target <= typescript_1.default.ScriptTarget.ES2015) {
+                build.initialOptions.target = 'es2015';
+            }
+            else if (compilerOptions.target >= typescript_1.default.ScriptTarget.ESNext) {
+                build.initialOptions.target = 'esnext';
+            }
+            else {
+                build.initialOptions.target = typescript_1.default.ScriptTarget[compilerOptions.target].toLowerCase();
+            }
+            // The file emitter created during `onStart` that will be used during the build in `onLoad` callbacks for TS files
+            let fileEmitter;
+            build.onStart(async () => {
+                var _a, _b;
+                const result = {};
+                // Create TypeScript compiler host
+                const host = typescript_1.default.createIncrementalCompilerHost(compilerOptions);
+                // Temporarily add a readResource hook to allow for a transformResource hook.
+                // Once the AOT compiler allows only a transformResource hook this can be removed.
+                host.readResource = function (fileName) {
+                    var _a;
+                    // Provide same no file found behavior as @ngtools/webpack
+                    return (_a = this.readFile(fileName)) !== null && _a !== void 0 ? _a : '';
+                };
+                // Add an AOT compiler resource transform hook
+                host.transformResource = async function (data, context) {
+                    var _a, _b, _c;
+                    // Only style resources are transformed currently
+                    if (context.type !== 'style') {
+                        return null;
+                    }
+                    // The file with the resource content will either be an actual file (resourceFile)
+                    // or the file containing the inline component style text (containingFile).
+                    const file = (_a = context.resourceFile) !== null && _a !== void 0 ? _a : context.containingFile;
+                    const { contents, errors, warnings } = await (0, stylesheets_1.bundleStylesheetText)(data, {
+                        resolvePath: path.dirname(file),
+                        virtualName: file,
+                    }, styleOptions);
+                    ((_b = result.errors) !== null && _b !== void 0 ? _b : (result.errors = [])).push(...errors);
+                    ((_c = result.warnings) !== null && _c !== void 0 ? _c : (result.warnings = [])).push(...warnings);
+                    return { content: contents };
+                };
+                // Create the Angular specific program that contains the Angular compiler
+                const angularProgram = new compilerCli.NgtscProgram(rootNames, compilerOptions, host);
+                const angularCompiler = angularProgram.compiler;
+                const { ignoreForDiagnostics, ignoreForEmit } = angularCompiler;
+                const typeScriptProgram = angularProgram.getTsProgram();
+                const builder = typescript_1.default.createAbstractBuilder(typeScriptProgram, host);
+                await angularCompiler.analyzeAsync();
+                function* collectDiagnostics() {
+                    // Collect program level diagnostics
+                    yield* configurationDiagnostics;
+                    yield* angularCompiler.getOptionDiagnostics();
+                    yield* builder.getOptionsDiagnostics();
+                    yield* builder.getGlobalDiagnostics();
+                    // Collect source file specific diagnostics
+                    const OptimizeFor = compilerCli.OptimizeFor;
+                    for (const sourceFile of builder.getSourceFiles()) {
+                        if (ignoreForDiagnostics.has(sourceFile)) {
+                            continue;
+                        }
+                        yield* builder.getSyntacticDiagnostics(sourceFile);
+                        yield* builder.getSemanticDiagnostics(sourceFile);
+                        const angularDiagnostics = angularCompiler.getDiagnosticsForFile(sourceFile, OptimizeFor.WholeProgram);
+                        yield* angularDiagnostics;
+                    }
+                }
+                for (const diagnostic of collectDiagnostics()) {
+                    const message = convertTypeScriptDiagnostic(diagnostic, host);
+                    if (diagnostic.category === typescript_1.default.DiagnosticCategory.Error) {
+                        ((_a = result.errors) !== null && _a !== void 0 ? _a : (result.errors = [])).push(message);
+                    }
+                    else {
+                        ((_b = result.warnings) !== null && _b !== void 0 ? _b : (result.warnings = [])).push(message);
+                    }
+                }
+                fileEmitter = createFileEmitter(builder, mergeTransformers(angularCompiler.prepareEmit().transformers, createAotTransformers(builder, {})), () => []);
+                return result;
+            });
+            build.onLoad({ filter: compilerOptions.allowJs ? /\.[cm]?[jt]sx?$/ : /\.[cm]?tsx?$/ }, async (args) => {
+                var _a, _b;
+                assert.ok(fileEmitter, 'Invalid plugin execution order');
+                const typescriptResult = await fileEmitter(args.path);
+                if (!typescriptResult) {
+                    // No TS result indicates the file is not part of the TypeScript program.
+                    // If allowJs is enabled and the file is JS then defer to the next load hook.
+                    if (compilerOptions.allowJs && /\.[cm]?js$/.test(args.path)) {
+                        return undefined;
+                    }
+                    // Otherwise return an error
+                    return {
+                        errors: [
+                            {
+                                text: 'File is missing from the TypeScript compilation.',
+                                location: { file: args.path },
+                                notes: [
+                                    {
+                                        text: `Ensure the file is part of the TypeScript program via the 'files' or 'include' property.`,
+                                    },
+                                ],
+                            },
+                        ],
+                    };
+                }
+                const data = (_a = typescriptResult.content) !== null && _a !== void 0 ? _a : '';
+                const babelResult = await (0, core_1.transformAsync)(data, {
+                    filename: args.path,
+                    inputSourceMap: (pluginOptions.sourcemap ? undefined : false),
+                    sourceMaps: pluginOptions.sourcemap ? 'inline' : false,
+                    compact: false,
+                    configFile: false,
+                    babelrc: false,
+                    browserslistConfigFile: false,
+                    plugins: [],
+                    presets: [
+                        [
+                            application_1.default,
+                            {
+                                forceAsyncTransformation: data.includes('async'),
+                                optimize: pluginOptions.advancedOptimizations && {},
+                            },
+                        ],
+                    ],
+                });
+                return {
+                    contents: (_b = babelResult === null || babelResult === void 0 ? void 0 : babelResult.code) !== null && _b !== void 0 ? _b : '',
+                    loader: 'js',
+                };
+            });
+            build.onLoad({ filter: /\.[cm]?js$/ }, async (args) => {
+                var _a;
+                const angularPackage = /[\\/]node_modules[\\/]@angular[\\/]/.test(args.path);
+                const linkerPluginCreator = (await (0, load_esm_1.loadEsmModule)('@angular/compiler-cli/linker/babel')).createEs2015LinkerPlugin;
+                const data = await fs_1.promises.readFile(args.path, 'utf-8');
+                const result = await (0, core_1.transformAsync)(data, {
+                    filename: args.path,
+                    inputSourceMap: (pluginOptions.sourcemap ? undefined : false),
+                    sourceMaps: pluginOptions.sourcemap ? 'inline' : false,
+                    compact: false,
+                    configFile: false,
+                    babelrc: false,
+                    browserslistConfigFile: false,
+                    plugins: [],
+                    presets: [
+                        [
+                            application_1.default,
+                            {
+                                angularLinker: {
+                                    shouldLink: await (0, webpack_loader_1.requiresLinking)(args.path, data),
+                                    jitMode: false,
+                                    linkerPluginCreator,
+                                },
+                                forceAsyncTransformation: !/[\\/][_f]?esm2015[\\/]/.test(args.path) && data.includes('async'),
+                                optimize: pluginOptions.advancedOptimizations && {
+                                    looseEnums: angularPackage,
+                                    pureTopLevel: angularPackage,
+                                },
+                            },
+                        ],
+                    ],
+                });
+                return {
+                    contents: (_a = result === null || result === void 0 ? void 0 : result.code) !== null && _a !== void 0 ? _a : data,
+                    loader: 'js',
+                };
+            });
+        },
+    };
+}
+exports.createCompilerPlugin = createCompilerPlugin;
+function createFileEmitter(program, transformers = {}, onAfterEmit) {
+    return async (file) => {
+        const sourceFile = program.getSourceFile(file);
+        if (!sourceFile) {
+            return undefined;
+        }
+        let content;
+        program.emit(sourceFile, (filename, data) => {
+            if (/\.[cm]?js$/.test(filename)) {
+                content = data;
+            }
+        }, undefined /* cancellationToken */, undefined /* emitOnlyDtsFiles */, transformers);
+        onAfterEmit === null || onAfterEmit === void 0 ? void 0 : onAfterEmit(sourceFile);
+        return { content, dependencies: [] };
+    };
+}

package/src/builders/browser-esbuild/esbuild.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @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 { BuildFailure, BuildOptions, BuildResult, Message, OutputFile } from 'esbuild';
+/**
+ * Determines if an unknown value is an esbuild BuildFailure error object thrown by esbuild.
+ * @param value A potential esbuild BuildFailure error object.
+ * @returns `true` if the object is determined to be a BuildFailure object; otherwise, `false`.
+ */
+export declare function isEsBuildFailure(value: unknown): value is BuildFailure;
+/**
+ * Executes the esbuild build function and normalizes the build result in the event of a
+ * build failure that results in no output being generated.
+ * All builds use the `write` option with a value of `false` to allow for the output files
+ * build result array to be populated.
+ *
+ * @param options The esbuild options object to use when building.
+ * @returns If output files are generated, the full esbuild BuildResult; if not, the
+ * warnings and errors for the attempted build.
+ */
+export declare function bundle(options: BuildOptions): Promise<(BuildResult & {
+    outputFiles: OutputFile[];
+}) | (BuildFailure & {
+    outputFiles?: never;
+})>;
+export declare function logMessages(context: BuilderContext, { errors, warnings }: {
+    errors: Message[];
+    warnings: Message[];
+}): Promise<void>;

package/src/builders/browser-esbuild/esbuild.js

@@ -0,0 +1,59 @@
+"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.logMessages = exports.bundle = exports.isEsBuildFailure = void 0;
+const esbuild_1 = require("esbuild");
+/**
+ * Determines if an unknown value is an esbuild BuildFailure error object thrown by esbuild.
+ * @param value A potential esbuild BuildFailure error object.
+ * @returns `true` if the object is determined to be a BuildFailure object; otherwise, `false`.
+ */
+function isEsBuildFailure(value) {
+    return !!value && typeof value === 'object' && 'errors' in value && 'warnings' in value;
+}
+exports.isEsBuildFailure = isEsBuildFailure;
+/**
+ * Executes the esbuild build function and normalizes the build result in the event of a
+ * build failure that results in no output being generated.
+ * All builds use the `write` option with a value of `false` to allow for the output files
+ * build result array to be populated.
+ *
+ * @param options The esbuild options object to use when building.
+ * @returns If output files are generated, the full esbuild BuildResult; if not, the
+ * warnings and errors for the attempted build.
+ */
+async function bundle(options) {
+    try {
+        return await (0, esbuild_1.build)({
+            ...options,
+            write: false,
+        });
+    }
+    catch (failure) {
+        // Build failures will throw an exception which contains errors/warnings
+        if (isEsBuildFailure(failure)) {
+            return failure;
+        }
+        else {
+            throw failure;
+        }
+    }
+}
+exports.bundle = bundle;
+async function logMessages(context, { errors, warnings }) {
+    if (warnings.length) {
+        const warningMessages = await (0, esbuild_1.formatMessages)(warnings, { kind: 'warning', color: true });
+        context.logger.warn(warningMessages.join('\n'));
+    }
+    if (errors.length) {
+        const errorMessages = await (0, esbuild_1.formatMessages)(errors, { kind: 'error', color: true });
+        context.logger.error(errorMessages.join('\n'));
+    }
+}
+exports.logMessages = logMessages;

package/src/builders/browser-esbuild/experimental-warnings.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @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 { Schema as BrowserBuilderOptions } from '../browser/schema';
+export declare function logExperimentalWarnings(options: BrowserBuilderOptions, context: BuilderContext): void;