@angular-devkit/build-angular 15.0.0 → 15.1.0-next.0

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

@@ -34,16 +34,14 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createCompilerPlugin = exports.SourceFileCache = void 0;
-const core_1 = require("@babel/core");
 const assert = __importStar(require("node:assert"));
-const fs = __importStar(require("node:fs/promises"));
 const node_os_1 = require("node:os");
 const path = __importStar(require("node:path"));
 const node_url_1 = require("node:url");
 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 environment_options_1 = require("../../utils/environment-options");
+const angular_compilation_1 = require("./angular-compilation");
+const javascript_transformer_1 = require("./javascript-transformer");
 const profiling_1 = require("./profiling");
 const stylesheets_1 = require("./stylesheets");
 /**
@@ -51,11 +49,11 @@ const stylesheets_1 = require("./stylesheets");
  * Related information is a subset of a full TypeScript Diagnostic and also used for diagnostic
  * notes associated with the main Diagnostic.
  * @param info 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());
+function convertTypeScriptDiagnosticInfo(info, textPrefix) {
+    const newLine = (0, node_os_1.platform)() === 'win32' ? '\r\n' : '\n';
+    let text = typescript_1.default.flattenDiagnosticMessageText(info.messageText, newLine);
     if (textPrefix) {
         text = textPrefix + text;
     }
@@ -87,10 +85,9 @@ function convertTypeScriptDiagnosticInfo(info, host, textPrefix) {
 /**
  * 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) {
+function convertTypeScriptDiagnostic(diagnostic) {
     var _a;
     let codePrefix = 'TS';
     let code = `${diagnostic.code}`;
@@ -100,12 +97,12 @@ function convertTypeScriptDiagnostic(diagnostic, host) {
         code = code.slice(3);
     }
     const message = {
-        ...convertTypeScriptDiagnosticInfo(diagnostic, host, `${codePrefix}${code}: `),
+        ...convertTypeScriptDiagnosticInfo(diagnostic, `${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));
+        message.notes = diagnostic.relatedInformation.map((info) => convertTypeScriptDiagnosticInfo(info));
     }
     return message;
 }
@@ -133,7 +130,6 @@ class SourceFileCache extends Map {
     }
 }
 exports.SourceFileCache = SourceFileCache;
-// 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 {
@@ -143,11 +139,9 @@ function createCompilerPlugin(pluginOptions, styleOptions) {
             var _a, _b;
             var _c;
             let setupWarnings;
-            // 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 { GLOBAL_DEFS_FOR_TERSER_WITH_AOT, NgtscProgram, OptimizeFor, readConfiguration } = await (0, load_esm_1.loadEsmModule)('@angular/compiler-cli');
-            // Temporary deep import for transformer support
-            const { mergeTransformers, replaceBootstrap, } = require('@ngtools/webpack/src/ivy/transformation');
+            // Initialize a worker pool for JavaScript transformations
+            const javascriptTransformer = new javascript_transformer_1.JavaScriptTransformer(pluginOptions, environment_options_1.maxWorkers);
+            const { GLOBAL_DEFS_FOR_TERSER_WITH_AOT, readConfiguration } = await angular_compilation_1.AngularCompilation.loadCompilerCli();
             // Setup defines based on the values provided by the Angular compiler-cli
             (_a = (_c = build.initialOptions).define) !== null && _a !== void 0 ? _a : (_c.define = {});
             for (const [key, value] of Object.entries(GLOBAL_DEFS_FOR_TERSER_WITH_AOT)) {
@@ -198,11 +192,9 @@ function createCompilerPlugin(pluginOptions, styleOptions) {
             let fileEmitter;
             // The stylesheet resources from component stylesheets that will be added to the build results output files
             let stylesheetResourceFiles;
-            let previousBuilder;
-            let previousAngularProgram;
-            const babelDataCache = new Map();
-            const diagnosticCache = new WeakMap();
+            let compilation;
             build.onStart(async () => {
+                var _a;
                 const result = {
                     warnings: setupWarnings,
                 };
@@ -212,111 +204,50 @@ function createCompilerPlugin(pluginOptions, styleOptions) {
                 (0, profiling_1.resetCumulativeDurations)();
                 // Reset stylesheet resource output files
                 stylesheetResourceFiles = [];
-                // Create TypeScript compiler host
-                const host = typescript_1.default.createIncrementalCompilerHost(compilerOptions);
-                // Temporarily process external resources via readResource.
-                // The AOT compiler currently requires this hook to allow for a transformResource hook.
-                // Once the AOT compiler allows only a transformResource hook, this can be reevaluated.
-                host.readResource = async function (fileName) {
-                    var _a, _b, _c;
-                    // Template resources (.html/.svg) files are not bundled or transformed
-                    if (fileName.endsWith('.html') || fileName.endsWith('.svg')) {
-                        return (_a = this.readFile(fileName)) !== null && _a !== void 0 ? _a : '';
-                    }
-                    const { contents, resourceFiles, errors, warnings } = await (0, stylesheets_1.bundleStylesheetFile)(fileName, 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);
-                    stylesheetResourceFiles.push(...resourceFiles);
-                    return contents;
-                };
-                // Add an AOT compiler resource transform hook
-                host.transformResource = async function (data, context) {
-                    var _a, _b, _c;
-                    // Only inline style resources are transformed separately currently
-                    if (context.resourceFile || 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, resourceFiles, 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);
-                    stylesheetResourceFiles.push(...resourceFiles);
-                    return { content: contents };
+                // Create Angular compiler host options
+                const hostOptions = {
+                    fileReplacements: pluginOptions.fileReplacements,
+                    modifiedFiles: (_a = pluginOptions.sourceFileCache) === null || _a === void 0 ? void 0 : _a.modifiedFiles,
+                    sourceFileCache: pluginOptions.sourceFileCache,
+                    async transformStylesheet(data, containingFile, stylesheetFile) {
+                        var _a, _b;
+                        // Stylesheet file only exists for external stylesheets
+                        const filename = stylesheetFile !== null && stylesheetFile !== void 0 ? stylesheetFile : containingFile;
+                        // Temporary workaround for lack of virtual file support in the Sass plugin.
+                        // External Sass stylesheets are transformed using the file instead of the already read content.
+                        let stylesheetResult;
+                        if (filename.endsWith('.scss') || filename.endsWith('.sass')) {
+                            stylesheetResult = await (0, stylesheets_1.bundleStylesheetFile)(filename, styleOptions);
+                        }
+                        else {
+                            stylesheetResult = await (0, stylesheets_1.bundleStylesheetText)(data, {
+                                resolvePath: path.dirname(filename),
+                                virtualName: filename,
+                            }, styleOptions);
+                        }
+                        const { contents, resourceFiles, errors, warnings } = stylesheetResult;
+                        ((_a = result.errors) !== null && _a !== void 0 ? _a : (result.errors = [])).push(...errors);
+                        ((_b = result.warnings) !== null && _b !== void 0 ? _b : (result.warnings = [])).push(...warnings);
+                        stylesheetResourceFiles.push(...resourceFiles);
+                        return contents;
+                    },
                 };
-                // Temporary deep import for host augmentation support
-                const { augmentHostWithCaching, augmentHostWithReplacements, augmentProgramWithVersioning, } = require('@ngtools/webpack/src/ivy/host');
-                // Augment TypeScript Host for file replacements option
-                if (pluginOptions.fileReplacements) {
-                    augmentHostWithReplacements(host, pluginOptions.fileReplacements);
-                }
-                // Augment TypeScript Host with source file caching if provided
-                if (pluginOptions.sourceFileCache) {
-                    augmentHostWithCaching(host, pluginOptions.sourceFileCache);
-                    // Allow the AOT compiler to request the set of changed templates and styles
-                    host.getModifiedResourceFiles = function () {
-                        var _a;
-                        return (_a = pluginOptions.sourceFileCache) === null || _a === void 0 ? void 0 : _a.modifiedFiles;
-                    };
-                }
-                // Create the Angular specific program that contains the Angular compiler
-                const angularProgram = (0, profiling_1.profileSync)('NG_CREATE_PROGRAM', () => new NgtscProgram(rootNames, compilerOptions, host, previousAngularProgram));
-                previousAngularProgram = angularProgram;
-                const angularCompiler = angularProgram.compiler;
-                const typeScriptProgram = angularProgram.getTsProgram();
-                augmentProgramWithVersioning(typeScriptProgram);
-                const builder = typescript_1.default.createEmitAndSemanticDiagnosticsBuilderProgram(typeScriptProgram, host, previousBuilder, configurationDiagnostics);
-                previousBuilder = builder;
-                await (0, profiling_1.profileAsync)('NG_ANALYZE_PROGRAM', () => angularCompiler.analyzeAsync());
-                const affectedFiles = (0, profiling_1.profileSync)('NG_FIND_AFFECTED', () => findAffectedFiles(builder, angularCompiler));
+                // Create new compilation if first build; otherwise, use existing for rebuilds
+                compilation !== null && compilation !== void 0 ? compilation : (compilation = new angular_compilation_1.AngularCompilation());
+                // Initialize the Angular compilation for the current build.
+                // In watch mode, previous build state will be reused.
+                const { affectedFiles } = await compilation.initialize(rootNames, compilerOptions, hostOptions, configurationDiagnostics);
+                // Clear affected files from the cache (if present)
                 if (pluginOptions.sourceFileCache) {
                     for (const affected of affectedFiles) {
                         pluginOptions.sourceFileCache.typeScriptFileCache.delete((0, node_url_1.pathToFileURL)(affected.fileName).href);
                     }
                 }
-                function* collectDiagnostics() {
-                    // Collect program level diagnostics
-                    yield* builder.getConfigFileParsingDiagnostics();
-                    yield* angularCompiler.getOptionDiagnostics();
-                    yield* builder.getOptionsDiagnostics();
-                    yield* builder.getGlobalDiagnostics();
-                    // Collect source file specific diagnostics
-                    const optimizeFor = affectedFiles.size > 1 ? OptimizeFor.WholeProgram : OptimizeFor.SingleFile;
-                    for (const sourceFile of builder.getSourceFiles()) {
-                        if (angularCompiler.ignoreForDiagnostics.has(sourceFile)) {
-                            continue;
-                        }
-                        // TypeScript will use cached diagnostics for files that have not been
-                        // changed or affected for this build when using incremental building.
-                        yield* (0, profiling_1.profileSync)('NG_DIAGNOSTICS_SYNTACTIC', () => builder.getSyntacticDiagnostics(sourceFile), true);
-                        yield* (0, profiling_1.profileSync)('NG_DIAGNOSTICS_SEMANTIC', () => builder.getSemanticDiagnostics(sourceFile), true);
-                        // Declaration files cannot have template diagnostics
-                        if (sourceFile.isDeclarationFile) {
-                            continue;
-                        }
-                        // Only request Angular template diagnostics for affected files to avoid
-                        // overhead of template diagnostics for unchanged files.
-                        if (affectedFiles.has(sourceFile)) {
-                            const angularDiagnostics = (0, profiling_1.profileSync)('NG_DIAGNOSTICS_TEMPLATE', () => angularCompiler.getDiagnosticsForFile(sourceFile, optimizeFor), true);
-                            diagnosticCache.set(sourceFile, angularDiagnostics);
-                            yield* angularDiagnostics;
-                        }
-                        else {
-                            const angularDiagnostics = diagnosticCache.get(sourceFile);
-                            if (angularDiagnostics) {
-                                yield* angularDiagnostics;
-                            }
-                        }
-                    }
-                }
                 (0, profiling_1.profileSync)('NG_DIAGNOSTICS_TOTAL', () => {
                     var _a, _b;
-                    for (const diagnostic of collectDiagnostics()) {
-                        const message = convertTypeScriptDiagnostic(diagnostic, host);
+                    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+                    for (const diagnostic of compilation.collectDiagnostics()) {
+                        const message = convertTypeScriptDiagnostic(diagnostic);
                         if (diagnostic.category === typescript_1.default.DiagnosticCategory.Error) {
                             ((_a = result.errors) !== null && _a !== void 0 ? _a : (result.errors = [])).push(message);
                         }
@@ -325,13 +256,11 @@ function createCompilerPlugin(pluginOptions, styleOptions) {
                         }
                     }
                 });
-                fileEmitter = createFileEmitter(builder, mergeTransformers(angularCompiler.prepareEmit().transformers, {
-                    before: [replaceBootstrap(() => builder.getProgram().getTypeChecker())],
-                }), (sourceFile) => angularCompiler.incrementalCompilation.recordSuccessfulEmit(sourceFile));
+                fileEmitter = compilation.createFileEmitter();
                 return result;
             });
             build.onLoad({ filter: compilerOptions.allowJs ? /\.[cm]?[jt]sx?$/ : /\.[cm]?tsx?$/ }, (args) => (0, profiling_1.profileAsync)('NG_EMIT_TS*', async () => {
-                var _a, _b, _c, _d, _e, _f;
+                var _a, _b, _c, _d, _e;
                 assert.ok(fileEmitter, 'Invalid plugin execution order');
                 const request = (_b = (_a = pluginOptions.fileReplacements) === null || _a === void 0 ? void 0 : _a[args.path]) !== null && _b !== void 0 ? _b : args.path;
                 // The filename is currently used as a cache key. Since the cache is memory only,
@@ -341,7 +270,7 @@ function createCompilerPlugin(pluginOptions, styleOptions) {
                 let contents = (_c = pluginOptions.sourceFileCache) === null || _c === void 0 ? void 0 : _c.typeScriptFileCache.get((0, node_url_1.pathToFileURL)(request).href);
                 if (contents === undefined) {
                     const typescriptResult = await fileEmitter(request);
-                    if (!typescriptResult) {
+                    if (!(typescriptResult === null || typescriptResult === void 0 ? void 0 : typescriptResult.content)) {
                         // 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(request)) {
@@ -354,18 +283,8 @@ function createCompilerPlugin(pluginOptions, styleOptions) {
                             ],
                         };
                     }
-                    const data = (_e = typescriptResult.content) !== null && _e !== void 0 ? _e : '';
-                    // The pre-transformed data is used as a cache key. Since the cache is memory only,
-                    // the options cannot change and do not need to be represented in the key. If the
-                    // cache is later stored to disk, then the options that affect transform output
-                    // would need to be added to the key as well.
-                    contents = babelDataCache.get(data);
-                    if (contents === undefined) {
-                        const transformedData = await transformWithBabel(request, data, pluginOptions);
-                        contents = Buffer.from(transformedData, 'utf-8');
-                        babelDataCache.set(data, contents);
-                    }
-                    (_f = pluginOptions.sourceFileCache) === null || _f === void 0 ? void 0 : _f.typeScriptFileCache.set((0, node_url_1.pathToFileURL)(request).href, contents);
+                    contents = await javascriptTransformer.transformData(request, typescriptResult.content, true /* skipLinker */);
+                    (_e = pluginOptions.sourceFileCache) === null || _e === void 0 ? void 0 : _e.typeScriptFileCache.set((0, node_url_1.pathToFileURL)(request).href, contents);
                 }
                 return {
                     contents,
@@ -380,9 +299,7 @@ function createCompilerPlugin(pluginOptions, styleOptions) {
                 // would need to be added to the key as well as a check for any change of content.
                 let contents = (_a = pluginOptions.sourceFileCache) === null || _a === void 0 ? void 0 : _a.babelFileCache.get(args.path);
                 if (contents === undefined) {
-                    const data = await fs.readFile(args.path, 'utf-8');
-                    const transformedData = await transformWithBabel(args.path, data, pluginOptions);
-                    contents = Buffer.from(transformedData, 'utf-8');
+                    contents = await javascriptTransformer.transformFile(args.path);
                     (_b = pluginOptions.sourceFileCache) === null || _b === void 0 ? void 0 : _b.babelFileCache.set(args.path, contents);
                 }
                 return {
@@ -401,103 +318,6 @@ function createCompilerPlugin(pluginOptions, styleOptions) {
     };
 }
 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: [] };
-    };
-}
-async function transformWithBabel(filename, data, pluginOptions) {
-    var _a;
-    const forceAsyncTransformation = !/[\\/][_f]?esm2015[\\/]/.test(filename) && /async\s+function\s*\*/.test(data);
-    const shouldLink = await (0, webpack_loader_1.requiresLinking)(filename, data);
-    const useInputSourcemap = pluginOptions.sourcemap &&
-        (!!pluginOptions.thirdPartySourcemaps || !/[\\/]node_modules[\\/]/.test(filename));
-    // If no additional transformations are needed, return the data directly
-    if (!forceAsyncTransformation && !pluginOptions.advancedOptimizations && !shouldLink) {
-        // Strip sourcemaps if they should not be used
-        return useInputSourcemap ? data : data.replace(/^\/\/# sourceMappingURL=[^\r\n]*/gm, '');
-    }
-    const angularPackage = /[\\/]node_modules[\\/]@angular[\\/]/.test(filename);
-    const linkerPluginCreator = shouldLink
-        ? (await (0, load_esm_1.loadEsmModule)('@angular/compiler-cli/linker/babel')).createEs2015LinkerPlugin
-        : undefined;
-    const result = await (0, core_1.transformAsync)(data, {
-        filename,
-        inputSourceMap: (useInputSourcemap ? undefined : false),
-        sourceMaps: pluginOptions.sourcemap ? 'inline' : false,
-        compact: false,
-        configFile: false,
-        babelrc: false,
-        browserslistConfigFile: false,
-        plugins: [],
-        presets: [
-            [
-                application_1.default,
-                {
-                    angularLinker: {
-                        shouldLink,
-                        jitMode: false,
-                        linkerPluginCreator,
-                    },
-                    forceAsyncTransformation,
-                    optimize: pluginOptions.advancedOptimizations && {
-                        looseEnums: angularPackage,
-                        pureTopLevel: angularPackage,
-                    },
-                },
-            ],
-        ],
-    });
-    return (_a = result === null || result === void 0 ? void 0 : result.code) !== null && _a !== void 0 ? _a : data;
-}
-function findAffectedFiles(builder, { ignoreForDiagnostics, ignoreForEmit, incrementalCompilation }) {
-    const affectedFiles = new Set();
-    // eslint-disable-next-line no-constant-condition
-    while (true) {
-        const result = builder.getSemanticDiagnosticsOfNextAffectedFile(undefined, (sourceFile) => {
-            // If the affected file is a TTC shim, add the shim's original source file.
-            // This ensures that changes that affect TTC are typechecked even when the changes
-            // are otherwise unrelated from a TS perspective and do not result in Ivy codegen changes.
-            // For example, changing @Input property types of a directive used in another component's
-            // template.
-            // A TTC shim is a file that has been ignored for diagnostics and has a filename ending in `.ngtypecheck.ts`.
-            if (ignoreForDiagnostics.has(sourceFile) && sourceFile.fileName.endsWith('.ngtypecheck.ts')) {
-                // This file name conversion relies on internal compiler logic and should be converted
-                // to an official method when available. 15 is length of `.ngtypecheck.ts`
-                const originalFilename = sourceFile.fileName.slice(0, -15) + '.ts';
-                const originalSourceFile = builder.getSourceFile(originalFilename);
-                if (originalSourceFile) {
-                    affectedFiles.add(originalSourceFile);
-                }
-                return true;
-            }
-            return false;
-        });
-        if (!result) {
-            break;
-        }
-        affectedFiles.add(result.affected);
-    }
-    // A file is also affected if the Angular compiler requires it to be emitted
-    for (const sourceFile of builder.getSourceFiles()) {
-        if (ignoreForEmit.has(sourceFile) || incrementalCompilation.safeToSkipEmit(sourceFile)) {
-            continue;
-        }
-        affectedFiles.add(sourceFile);
-    }
-    return affectedFiles;
-}
 function createMissingFileError(request, original, root) {
     const error = {
         text: `File '${path.relative(root, request)}' is missing from the TypeScript compilation.`,

package/src/builders/browser-esbuild/javascript-transformer-worker.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @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
+ */
+interface JavaScriptTransformRequest {
+    filename: string;
+    data: string;
+    sourcemap: boolean;
+    thirdPartySourcemaps: boolean;
+    advancedOptimizations: boolean;
+    forceAsyncTransformation?: boolean;
+    skipLinker: boolean;
+}
+export default function transformJavaScript(request: JavaScriptTransformRequest): Promise<Uint8Array>;
+export {};

package/src/builders/browser-esbuild/javascript-transformer-worker.js

@@ -0,0 +1,70 @@
+"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 });
+const core_1 = require("@babel/core");
+const promises_1 = require("node:fs/promises");
+const application_1 = __importDefault(require("../../babel/presets/application"));
+const webpack_loader_1 = require("../../babel/webpack-loader");
+const load_esm_1 = require("../../utils/load-esm");
+async function transformJavaScript(request) {
+    var _a;
+    (_a = request.data) !== null && _a !== void 0 ? _a : (request.data = await (0, promises_1.readFile)(request.filename, 'utf-8'));
+    const transformedData = await transformWithBabel(request);
+    return Buffer.from(transformedData, 'utf-8');
+}
+exports.default = transformJavaScript;
+let linkerPluginCreator;
+async function transformWithBabel({ filename, data, ...options }) {
+    var _a, _b;
+    const forceAsyncTransformation = (_a = options.forceAsyncTransformation) !== null && _a !== void 0 ? _a : (!/[\\/][_f]?esm2015[\\/]/.test(filename) && /async\s+function\s*\*/.test(data));
+    const shouldLink = !options.skipLinker && (await (0, webpack_loader_1.requiresLinking)(filename, data));
+    const useInputSourcemap = options.sourcemap &&
+        (!!options.thirdPartySourcemaps || !/[\\/]node_modules[\\/]/.test(filename));
+    // If no additional transformations are needed, return the data directly
+    if (!forceAsyncTransformation && !options.advancedOptimizations && !shouldLink) {
+        // Strip sourcemaps if they should not be used
+        return useInputSourcemap ? data : data.replace(/^\/\/# sourceMappingURL=[^\r\n]*/gm, '');
+    }
+    const angularPackage = /[\\/]node_modules[\\/]@angular[\\/]/.test(filename);
+    // Lazy load the linker plugin only when linking is required
+    if (shouldLink) {
+        linkerPluginCreator !== null && linkerPluginCreator !== void 0 ? linkerPluginCreator : (linkerPluginCreator = (await (0, load_esm_1.loadEsmModule)('@angular/compiler-cli/linker/babel')).createEs2015LinkerPlugin);
+    }
+    const result = await (0, core_1.transformAsync)(data, {
+        filename,
+        inputSourceMap: (useInputSourcemap ? undefined : false),
+        sourceMaps: options.sourcemap ? 'inline' : false,
+        compact: false,
+        configFile: false,
+        babelrc: false,
+        browserslistConfigFile: false,
+        plugins: [],
+        presets: [
+            [
+                application_1.default,
+                {
+                    angularLinker: linkerPluginCreator && {
+                        shouldLink,
+                        jitMode: false,
+                        linkerPluginCreator,
+                    },
+                    forceAsyncTransformation,
+                    optimize: options.advancedOptimizations && {
+                        looseEnums: angularPackage,
+                        pureTopLevel: angularPackage,
+                    },
+                },
+            ],
+        ],
+    });
+    return (_b = result === null || result === void 0 ? void 0 : result.code) !== null && _b !== void 0 ? _b : data;
+}

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

@@ -0,0 +1,48 @@
+/**
+ * @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
+ */
+/**
+ * Transformation options that should apply to all transformed files and data.
+ */
+export interface JavaScriptTransformerOptions {
+    sourcemap: boolean;
+    thirdPartySourcemaps?: boolean;
+    advancedOptimizations?: boolean;
+}
+/**
+ * A class that performs transformation of JavaScript files and raw data.
+ * A worker pool is used to distribute the transformation actions and allow
+ * parallel processing. Transformation behavior is based on the filename and
+ * data. Transformations may include: async downleveling, Angular linking,
+ * and advanced optimizations.
+ */
+export declare class JavaScriptTransformer {
+    #private;
+    private options;
+    constructor(options: JavaScriptTransformerOptions, maxThreads?: number);
+    /**
+     * Performs JavaScript transformations on a file from the filesystem.
+     * If no transformations are required, the data for the original file will be returned.
+     * @param filename The full path to the file.
+     * @returns A promise that resolves to a UTF-8 encoded Uint8Array containing the result.
+     */
+    transformFile(filename: string): Promise<Uint8Array>;
+    /**
+     * Performs JavaScript transformations on the provided data of a file. The file does not need
+     * to exist on the filesystem.
+     * @param filename The full path of the file represented by the data.
+     * @param data The data of the file that should be transformed.
+     * @param skipLinker If true, bypass all Angular linker processing; if false, attempt linking.
+     * @returns A promise that resolves to a UTF-8 encoded Uint8Array containing the result.
+     */
+    transformData(filename: string, data: string, skipLinker: boolean): Promise<Uint8Array>;
+    /**
+     * Stops all active transformation tasks and shuts down all workers.
+     * @returns A void promise that resolves when closing is complete.
+     */
+    close(): Promise<void>;
+}

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

@@ -0,0 +1,95 @@
+"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 __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+var _JavaScriptTransformer_workerPool;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JavaScriptTransformer = void 0;
+const piscina_1 = __importDefault(require("piscina"));
+/**
+ * A class that performs transformation of JavaScript files and raw data.
+ * A worker pool is used to distribute the transformation actions and allow
+ * parallel processing. Transformation behavior is based on the filename and
+ * data. Transformations may include: async downleveling, Angular linking,
+ * and advanced optimizations.
+ */
+class JavaScriptTransformer {
+    constructor(options, maxThreads) {
+        this.options = options;
+        _JavaScriptTransformer_workerPool.set(this, void 0);
+        __classPrivateFieldSet(this, _JavaScriptTransformer_workerPool, new piscina_1.default({
+            filename: require.resolve('./javascript-transformer-worker'),
+            maxThreads,
+        }), "f");
+    }
+    /**
+     * Performs JavaScript transformations on a file from the filesystem.
+     * If no transformations are required, the data for the original file will be returned.
+     * @param filename The full path to the file.
+     * @returns A promise that resolves to a UTF-8 encoded Uint8Array containing the result.
+     */
+    transformFile(filename) {
+        // Always send the request to a worker. Files are almost always from node modules which measn
+        // they may need linking. The data is also not yet available to perform most transformation checks.
+        return __classPrivateFieldGet(this, _JavaScriptTransformer_workerPool, "f").run({
+            filename,
+            ...this.options,
+        });
+    }
+    /**
+     * Performs JavaScript transformations on the provided data of a file. The file does not need
+     * to exist on the filesystem.
+     * @param filename The full path of the file represented by the data.
+     * @param data The data of the file that should be transformed.
+     * @param skipLinker If true, bypass all Angular linker processing; if false, attempt linking.
+     * @returns A promise that resolves to a UTF-8 encoded Uint8Array containing the result.
+     */
+    async transformData(filename, data, skipLinker) {
+        // Perform a quick test to determine if the data needs any transformations.
+        // This allows directly returning the data without the worker communication overhead.
+        let forceAsyncTransformation;
+        if (skipLinker && !this.options.advancedOptimizations) {
+            // If the linker is being skipped and no optimizations are needed, only async transformation is left.
+            // This checks for async generator functions. All other async transformation is handled by esbuild.
+            forceAsyncTransformation = data.includes('async') && /async\s+function\s*\*/.test(data);
+            if (!forceAsyncTransformation) {
+                return Buffer.from(data, 'utf-8');
+            }
+        }
+        return __classPrivateFieldGet(this, _JavaScriptTransformer_workerPool, "f").run({
+            filename,
+            data,
+            // Send the async check result if present to avoid rechecking in the worker
+            forceAsyncTransformation,
+            skipLinker,
+            ...this.options,
+        });
+    }
+    /**
+     * Stops all active transformation tasks and shuts down all workers.
+     * @returns A void promise that resolves when closing is complete.
+     */
+    close() {
+        return __classPrivateFieldGet(this, _JavaScriptTransformer_workerPool, "f").destroy();
+    }
+}
+exports.JavaScriptTransformer = JavaScriptTransformer;
+_JavaScriptTransformer_workerPool = new WeakMap();