@angular-devkit/build-angular 14.0.0-next.1 → 14.0.0-next.12

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;

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

@@ -0,0 +1,65 @@
+"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.logExperimentalWarnings = void 0;
+const UNSUPPORTED_OPTIONS = [
+    'allowedCommonJsDependencies',
+    'budgets',
+    'extractLicenses',
+    'fileReplacements',
+    'progress',
+    'scripts',
+    'statsJson',
+    // * i18n support
+    'localize',
+    // The following two have no effect when localize is not enabled
+    // 'i18nDuplicateTranslation',
+    // 'i18nMissingTranslation',
+    // * Serviceworker support
+    'ngswConfigPath',
+    'serviceWorker',
+    // * Stylesheet preprocessor support
+    'inlineStyleLanguage',
+    // The following option has no effect until preprocessors are supported
+    // 'stylePreprocessorOptions',
+    // * Watch mode
+    'watch',
+    'poll',
+    // * Deprecated
+    'deployUrl',
+    // * Always enabled with esbuild
+    // 'commonChunk',
+    // * Currently unsupported by esbuild
+    'namedChunks',
+    'vendorChunk',
+    'webWorkerTsConfig',
+];
+function logExperimentalWarnings(options, context) {
+    // Warn about experimental status of this builder
+    context.logger.warn(`The esbuild browser application builder ('browser-esbuild') is currently experimental.`);
+    // Validate supported options
+    // Currently only a subset of the Webpack-based browser builder options are supported.
+    for (const unsupportedOption of UNSUPPORTED_OPTIONS) {
+        const value = options[unsupportedOption];
+        if (value === undefined || value === false) {
+            continue;
+        }
+        if (Array.isArray(value) && value.length === 0) {
+            continue;
+        }
+        if (typeof value === 'object' && Object.keys(value).length === 0) {
+            continue;
+        }
+        if (unsupportedOption === 'inlineStyleLanguage' && value === 'css') {
+            continue;
+        }
+        context.logger.warn(`The '${unsupportedOption}' option is currently unsupported by this experimental builder and will be ignored.`);
+    }
+}
+exports.logExperimentalWarnings = logExperimentalWarnings;

package/src/builders/browser-esbuild/index.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.io/license
+ */
+import { BuilderContext, BuilderOutput } from '@angular-devkit/architect';
+import { Schema as BrowserBuilderOptions } from '../browser/schema';
+/**
+ * Main execution function for the esbuild-based application builder.
+ * The options are compatible with the Webpack-based builder.
+ * @param options The browser builder options to use when setting up the application build
+ * @param context The Architect builder context object
+ * @returns A promise with the builder result output
+ */
+export declare function execute(options: BrowserBuilderOptions, context: BuilderContext): Promise<BuilderOutput>;
+declare const _default: import("@angular-devkit/architect/src/internal").Builder<BrowserBuilderOptions & import("../../../../core/src").JsonObject>;
+export default _default;