@angular/build 22.3.0-next.1 → 22.3.0-next.2

package/src/builders/library/builder-state.js

@@ -0,0 +1,282 @@
+"use strict";
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BuilderState = void 0;
+const path_1 = require("../../utils/path");
+const execution_result_1 = require("./execution-result");
+/**
+ * Encapsulates incremental compilation state, transitive resource reference tracking,
+ * watched compilation file tracking, and execution results across watch-mode rebuilds.
+ */
+class BuilderState {
+    #referencingFiles = new Map();
+    #referencedByFile = new Map();
+    #watchedCompilationFiles = new Set();
+    #pendingCompilationFiles = new Set();
+    #executionResult = new execution_result_1.ExecutionResult();
+    #singleProgramCache;
+    #compilationMode;
+    /** Map of entry point names to their previous bundle results. */
+    previousBundleResults = new Map();
+    /** Set of changed POSIX ESM file paths pending bundling. */
+    pendingChangedEsmFiles = new Set();
+    /** Set of changed POSIX TypeScript declaration file paths pending bundling. */
+    pendingChangedDtsFiles = new Set();
+    /** Whether the previous build iteration encountered a compilation or diagnostic error. */
+    hasCompilationError = false;
+    /** Whether package.json and secondary entry point manifests have been emitted. */
+    hasEmittedManifests = false;
+    /** Whether the last emitted root package.json included a tslib dependency. */
+    hasEmittedTslib = false;
+    /** Whether static assets have been emitted in a prior iteration. */
+    hasEmittedAssets = false;
+    /** Whether entry points in package.json changed since the last compilation. */
+    hasEntryPointsChanges = false;
+    constructor(options) {
+        if (options?.tsConfigPath) {
+            this.#watchedCompilationFiles.add(options.tsConfigPath);
+        }
+        if (options?.packageJsonPath) {
+            this.#watchedCompilationFiles.add(options.packageJsonPath);
+        }
+        if (options?.entryPoints) {
+            for (const entryPoint of options.entryPoints.values()) {
+                this.#watchedCompilationFiles.add(entryPoint.entryFilePath);
+            }
+        }
+    }
+    /** Cached unified TypeScript and Angular compilation state. */
+    get singleProgramCache() {
+        return this.#singleProgramCache;
+    }
+    /** Effective compilation mode resolved from builder options and tsconfig. */
+    get compilationMode() {
+        return this.#compilationMode;
+    }
+    /** Whether any active entry point bundle imports `tslib`. */
+    get hasTslibImport() {
+        for (const result of this.previousBundleResults.values()) {
+            if (result.hasTslibImport) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Set of POSIX file paths tracked for compilation and configuration
+     * (including `tsconfig.json`, `package.json`, entry points, and referenced source,
+     * template, and stylesheet files).
+     */
+    get watchedCompilationFiles() {
+        return this.#watchedCompilationFiles;
+    }
+    /**
+     * Execution result holding errors, warnings, and logs for the current build iteration.
+     */
+    get executionResult() {
+        return this.#executionResult;
+    }
+    /**
+     * Resets the execution result for a new build iteration.
+     *
+     * @returns The fresh `ExecutionResult` instance for the current build iteration.
+     */
+    resetExecutionResult() {
+        this.#executionResult = new execution_result_1.ExecutionResult();
+        return this.#executionResult;
+    }
+    /**
+     * Records transitive resource dependencies (such as Sass partials) for a containing
+     * component or stylesheet file and registers them in `watchedCompilationFiles`.
+     * Multiple calls for the same containing file accumulate references additively.
+     *
+     * @param containingFile Path of the referencing component or stylesheet file.
+     * @param referencedFiles Paths of the referenced files.
+     */
+    addFileReferences(containingFile, referencedFiles) {
+        const posixContainingFile = (0, path_1.toPosixPath)(containingFile);
+        let forwardReferences = this.#referencedByFile.get(posixContainingFile);
+        for (const file of referencedFiles) {
+            const posixFile = (0, path_1.toPosixPath)(file);
+            this.#watchedCompilationFiles.add(posixFile);
+            if (posixFile === posixContainingFile) {
+                continue;
+            }
+            if (!forwardReferences) {
+                forwardReferences = new Set();
+                this.#referencedByFile.set(posixContainingFile, forwardReferences);
+            }
+            forwardReferences.add(posixFile);
+            let referencing = this.#referencingFiles.get(posixFile);
+            if (!referencing) {
+                referencing = new Set();
+                this.#referencingFiles.set(posixFile, referencing);
+            }
+            referencing.add(posixContainingFile);
+        }
+    }
+    /**
+     * Clears previously recorded outgoing resource references for the given containing files
+     * before they are recompiled.
+     *
+     * @param containingFiles Paths of the containing or stylesheet files being recompiled.
+     */
+    clearFileReferences(containingFiles) {
+        for (const containingFile of containingFiles) {
+            const posixContainingFile = (0, path_1.toPosixPath)(containingFile);
+            const forwardReferences = this.#referencedByFile.get(posixContainingFile);
+            if (!forwardReferences) {
+                continue;
+            }
+            for (const prevRef of forwardReferences) {
+                const referencing = this.#referencingFiles.get(prevRef);
+                if (referencing) {
+                    referencing.delete(posixContainingFile);
+                    if (referencing.size === 0) {
+                        this.#referencingFiles.delete(prevRef);
+                    }
+                }
+            }
+            this.#referencedByFile.delete(posixContainingFile);
+        }
+    }
+    /**
+     * Returns the set of all files affected by the given changed files, including the
+     * changed files themselves and all transitively referencing files
+     * (e.g., partial `.scss` -> component `.scss` -> component `.ts`).
+     *
+     * @param files Initial changed file paths.
+     * @returns Set of POSIX paths including all transitively referencing files.
+     */
+    getAffectedFiles(files) {
+        const affected = new Set();
+        for (const file of files) {
+            affected.add((0, path_1.toPosixPath)(file));
+        }
+        for (const file of affected) {
+            const referencing = this.#referencingFiles.get(file);
+            if (referencing) {
+                for (const refFile of referencing) {
+                    affected.add(refFile);
+                }
+            }
+        }
+        return affected;
+    }
+    /**
+     * Determines whether compilation and bundling need to run for the current build iteration.
+     * Also records incoming modified files so they are retained if the iteration aborts early.
+     *
+     * @param packageJsonPath Normalized POSIX path to the library's `package.json`.
+     * @param modifiedFiles Optional set of modified POSIX file paths in watch mode.
+     * @returns `true` if entry points should be compiled; otherwise `false`.
+     */
+    shouldCompileEntryPoints(packageJsonPath, modifiedFiles) {
+        if (modifiedFiles) {
+            for (const file of modifiedFiles) {
+                if (file !== packageJsonPath) {
+                    this.#pendingCompilationFiles.add(file);
+                }
+            }
+        }
+        if (!modifiedFiles ||
+            !this.#singleProgramCache ||
+            this.hasCompilationError ||
+            this.hasEntryPointsChanges ||
+            this.pendingChangedEsmFiles.size > 0 ||
+            this.pendingChangedDtsFiles.size > 0) {
+            return true;
+        }
+        for (const file of this.#pendingCompilationFiles) {
+            if (this.#watchedCompilationFiles.has(file)) {
+                return true;
+            }
+        }
+        this.#pendingCompilationFiles.clear();
+        return false;
+    }
+    /**
+     * Returns the effective set of modified POSIX file paths for compilation,
+     * merging any pending compilation files from earlier aborted iterations.
+     *
+     * @param modifiedFiles Optional set of modified POSIX file paths from the current iteration.
+     * @returns Merged set of modified POSIX file paths, or `undefined` for a full compilation.
+     */
+    getCompilationModifiedFiles(modifiedFiles) {
+        if (!modifiedFiles) {
+            this.#pendingCompilationFiles.clear();
+            return undefined;
+        }
+        const files = new Set(modifiedFiles);
+        for (const file of this.#pendingCompilationFiles) {
+            files.add(file);
+        }
+        return files;
+    }
+    /**
+     * Records compilation output into the build state, updating the program cache,
+     * watched compilation files, and pending changed ESM/DTS file sets.
+     *
+     * @param output The compilation output produced by `compileLibrary`.
+     */
+    recordCompilationOutput(output) {
+        this.#pendingCompilationFiles.clear();
+        this.#singleProgramCache = output.cache;
+        if (this.#compilationMode !== output.compilationMode) {
+            this.#compilationMode = output.compilationMode;
+            this.hasEmittedManifests = false;
+        }
+        for (const file of output.referencedFiles) {
+            this.#watchedCompilationFiles.add(file);
+        }
+        for (const file of output.changedEsmFiles) {
+            this.pendingChangedEsmFiles.add(file);
+        }
+        for (const file of output.changedDtsFiles) {
+            this.pendingChangedDtsFiles.add(file);
+        }
+    }
+    /**
+     * Records active bundle results across entry points after compilation and bundling succeed,
+     * clearing pending compilation/bundle flags.
+     *
+     * @param bundleResults Newly bundled results keyed by entry point name.
+     */
+    recordBundleOutput(bundleResults) {
+        this.hasCompilationError = false;
+        this.hasEntryPointsChanges = false;
+        this.pendingChangedEsmFiles.clear();
+        this.pendingChangedDtsFiles.clear();
+        for (const [name, bundleResult] of bundleResults) {
+            this.previousBundleResults.set(name, bundleResult);
+        }
+    }
+    /**
+     * Disposes active compilation resources and clears cached state.
+     */
+    async dispose() {
+        await this.#singleProgramCache?.compilationInstance.close?.();
+        this.#singleProgramCache = undefined;
+        this.#compilationMode = undefined;
+        this.hasEmittedTslib = false;
+        this.hasEmittedAssets = false;
+        this.hasCompilationError = false;
+        this.hasEmittedManifests = false;
+        this.hasEntryPointsChanges = false;
+        this.previousBundleResults.clear();
+        this.pendingChangedEsmFiles.clear();
+        this.pendingChangedDtsFiles.clear();
+        this.#pendingCompilationFiles.clear();
+        this.#referencingFiles.clear();
+        this.#referencedByFile.clear();
+        this.#watchedCompilationFiles.clear();
+    }
+}
+exports.BuilderState = BuilderState;
+//# sourceMappingURL=builder-state.js.map

package/src/builders/library/builder-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder-state.js","sourceRoot":"","sources":["builder-state.ts"],"names":[],"mappings":"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"}

package/src/builders/library/builder.js

@@ -39,12 +39,8 @@ var __importStar = (this && this.__importStar) || (function () {
         return result;
     };
 })();
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.executeLibraryBuilder = executeLibraryBuilder;
-const promises_1 = __importDefault(require("node:fs/promises"));
 const sass_language_1 = require("../../tools/esbuild/stylesheets/sass-language");
 const target_1 = require("../../tools/esbuild/target");
 const utils_1 = require("../../tools/esbuild/utils");
@@ -56,8 +52,10 @@ const profiling_1 = require("../../utils/profiling");
 const purge_cache_1 = require("../../utils/purge-cache");
 const supported_browsers_1 = require("../../utils/supported-browsers");
 const version_1 = require("../../utils/version");
+const builder_state_1 = require("./builder-state");
 const options_1 = require("./options");
 const entry_points_1 = require("./pipeline/entry-points");
+const utils_2 = require("./pipeline/utils");
 /**
  * Executes the library builder to compile, bundle, and package an Angular library into the Angular Package Format (APF).
  *
@@ -67,16 +65,18 @@ const entry_points_1 = require("./pipeline/entry-points");
  */
 async function* executeLibraryBuilder(options, context) {
     (0, version_1.assertCompatibleAngularVersion)(context.workspaceRoot);
-    await (0, hash_1.initializeHash)();
-    // Purge old build disk cache
-    await (0, purge_cache_1.purgeStaleBuildCache)(context);
     const projectName = context.target?.project;
     if (!projectName) {
         yield { success: false, error: 'The library builder requires a target.' };
         return;
     }
-    const normalizedOptions = await (0, options_1.normalizeLibraryOptions)(context, projectName, options);
-    const { workspaceRoot, projectRoot, outputPath, deleteOutputPath, packageJsonPath, tsConfigPath, watch: isWatchMode, poll, cacheOptions, preserveSymlinks, progress, } = normalizedOptions;
+    const [normalizedOptions] = await Promise.all([
+        (0, options_1.normalizeLibraryOptions)(context, projectName, options),
+        (0, hash_1.initializeHash)(),
+        // Purge old build disk cache
+        (0, purge_cache_1.purgeStaleBuildCache)(context),
+    ]);
+    const { workspaceRoot, projectRoot, outputPath, deleteOutputPath, watch: isWatchMode, poll, cacheOptions, preserveSymlinks, progress, } = normalizedOptions;
     let signal = context.signal;
     if (!signal) {
         const controller = new AbortController();
@@ -90,29 +90,18 @@ async function* executeLibraryBuilder(options, context) {
         await (0, delete_output_dir_1.deleteOutputDir)(workspaceRoot, outputPath);
     }
     // Dynamically lazy-loaded to prevent importing dependencies at the top level.
-    const [{ buildAction, createSingleBuildState, hasModifiedWatchedFile }, { createComponentStylesheetBundlerForLibrary },] = await Promise.all([
+    const [{ buildAction }, { createComponentStylesheetBundlerForLibrary }] = await Promise.all([
         Promise.resolve().then(() => __importStar(require('./pipeline/build-action'))),
         Promise.resolve().then(() => __importStar(require('./pipeline/stylesheet-bundler'))),
     ]);
     let stylesheetBundler;
     let watcher;
-    const buildState = createSingleBuildState();
+    const buildState = new builder_state_1.BuilderState(normalizedOptions);
     try {
         const browsers = (0, supported_browsers_1.getSupportedBrowsers)(projectRoot, logger);
         const target = (0, target_1.transformSupportedBrowsersToTargets)(browsers);
         stylesheetBundler = createComponentStylesheetBundlerForLibrary(normalizedOptions, isWatchMode, target);
-        // Track all referenced compilation files for watch mode
-        const watchedCompilationFiles = new Set([
-            (0, path_1.toPosixPath)(tsConfigPath),
-            (0, path_1.toPosixPath)(packageJsonPath),
-        ]);
-        for (const entryPoint of normalizedOptions.entryPoints.values()) {
-            watchedCompilationFiles.add((0, path_1.toPosixPath)(entryPoint.entryFilePath));
-        }
         if (isWatchMode) {
-            if (progress) {
-                logger.info('Watch mode enabled. Watching for file changes...');
-            }
             const { setupWatcher } = await Promise.resolve().then(() => __importStar(require('../../utils/watcher')));
             watcher = await setupWatcher({
                 workspaceRoot,
@@ -122,7 +111,10 @@ async function* executeLibraryBuilder(options, context) {
                 poll,
                 preserveSymlinks,
                 signal,
-                watchFiles: watchedCompilationFiles,
+                watchFiles: [
+                    ...buildState.watchedCompilationFiles,
+                    ...normalizedOptions.assets.map((asset) => asset.input),
+                ],
             });
             context.addTeardown?.(() => void watcher?.close());
         }
@@ -130,16 +122,17 @@ async function* executeLibraryBuilder(options, context) {
         const initialResult = await executeBuild('Building...', {
             options: normalizedOptions,
             stylesheetBundler,
-            watchedCompilationFiles,
             isWatchMode,
-            context,
             buildState,
-        }, withProgress, watcher, buildAction);
+        }, logger, withProgress, watcher, buildAction);
+        if (isWatchMode && progress) {
+            logger.info('Watch mode enabled. Watching for file changes...');
+        }
         yield initialResult;
         if (!isWatchMode || !watcher) {
             return;
         }
-        yield* runWatchLoop(watcher, normalizedOptions, stylesheetBundler, watchedCompilationFiles, context, withProgress, buildState, buildAction, hasModifiedWatchedFile, signal);
+        yield* runWatchLoop(watcher, normalizedOptions, stylesheetBundler, logger, withProgress, buildState, buildAction, signal);
     }
     finally {
         (0, profiling_1.logCumulativeDurations)();
@@ -147,29 +140,43 @@ async function* executeLibraryBuilder(options, context) {
         await Promise.allSettled([
             watcher?.close(),
             stylesheetBundler?.dispose(),
-            buildState.singleProgramCache?.compilationInstance.close?.(),
+            buildState.dispose(),
         ]);
     }
 }
-async function executeBuild(message, actionContext, withProgress, watcher, buildAction) {
+/**
+ * Executes a single build iteration with progress reporting, logs any resulting
+ * messages, and registers newly discovered files with the watcher.
+ *
+ * @param message Progress spinner message to display while building.
+ * @param actionContext The build action context and state.
+ * @param logger The Architect logger API.
+ * @param withProgress Progress wrapper function (`withSpinner` or `withNoProgress`).
+ * @param watcher Optional file watcher for watch mode.
+ * @param buildAction The library build action function to execute.
+ * @returns A promise resolving to the Architect `BuilderOutput`.
+ */
+async function executeBuild(message, actionContext, logger, withProgress, watcher, buildAction) {
     const startTime = process.hrtime.bigint();
-    const { context, watchedCompilationFiles, isWatchMode } = actionContext;
+    const { buildState, isWatchMode, options } = actionContext;
     try {
-        await withProgress(message, () => buildAction(actionContext));
-        logBuildResult(context.logger, startTime, true);
-        if (isWatchMode) {
+        const result = await withProgress(message, () => buildAction(actionContext));
+        logMessages(logger, result);
+        const { output } = result;
+        logBuildResult(logger, startTime, output.success, options.outputPath);
+        if (output.success && isWatchMode) {
             (0, profiling_1.logCumulativeDurations)();
         }
-        return { success: true };
+        return output;
     }
     catch (error) {
         (0, error_1.assertIsError)(error);
-        logBuildResult(context.logger, startTime, false);
+        logBuildResult(logger, startTime, false);
         return { success: false, error: error.message };
     }
     finally {
         if (watcher) {
-            watcher.add(Array.from(watchedCompilationFiles));
+            watcher.add(Array.from(buildState.watchedCompilationFiles));
             const { assetsToEmit } = actionContext;
             if (assetsToEmit?.length) {
                 watcher.add(assetsToEmit.map((asset) => asset.source));
@@ -179,61 +186,50 @@ async function executeBuild(message, actionContext, withProgress, watcher, build
 }
 /**
  * Runs the watch loop, rebuilding the library as watched files are modified.
+ *
+ * @param watcher The file watcher instance.
+ * @param options The normalized library builder options with POSIX paths.
+ * @param stylesheetBundler The component stylesheet bundler instance.
+ * @param logger The Architect logger API.
+ * @param withProgress Progress wrapper function (`withSpinner` or `withNoProgress`).
+ * @param buildState The state preserved across incremental builds.
+ * @param buildAction The library build action function to execute.
+ * @param signal Abort signal to terminate the watch loop.
+ * @returns An async iterator yielding builder output results.
  */
-async function* runWatchLoop(watcher, options, stylesheetBundler, watchedCompilationFiles, context, withProgress, buildState, buildAction, hasModifiedWatchedFile, signal) {
+async function* runWatchLoop(watcher, options, stylesheetBundler, logger, withProgress, buildState, buildAction, signal) {
     const { collectAssetsToEmit } = await Promise.resolve().then(() => __importStar(require('./pipeline/assets')));
     const { workspaceRoot, packageJsonPath, assets, clearScreen } = options;
-    const posixPackageJsonPath = (0, path_1.toPosixPath)(packageJsonPath);
     for await (const changes of watcher) {
-        if (signal?.aborted) {
+        if (signal.aborted) {
             break;
         }
         if (clearScreen) {
             // eslint-disable-next-line no-console
             console.clear();
         }
-        const changedFiles = new Set();
-        let hasStyleChanges = false;
-        let hasSassChanges = false;
-        for (const file of changes.all) {
-            const posixFile = (0, path_1.toPosixPath)(file);
-            changedFiles.add(posixFile);
+        const rawChangedFiles = changes.all.map(path_1.toPosixPath);
+        stylesheetBundler.invalidate(rawChangedFiles);
+        const changedFiles = buildState.getAffectedFiles(rawChangedFiles);
+        for (const posixFile of changedFiles) {
             if (/\.(?:scss|sass)$/i.test(posixFile)) {
-                hasStyleChanges = true;
-                hasSassChanges = true;
-            }
-            else if (/\.(?:less|css)$/i.test(posixFile)) {
-                hasStyleChanges = true;
-            }
-        }
-        if (hasStyleChanges) {
-            if (hasSassChanges) {
                 (0, sass_language_1.resetSassWorkerPoolCaches)();
-            }
-            const invalidatedStyles = stylesheetBundler.invalidate(changedFiles);
-            if (invalidatedStyles) {
-                for (const styleFile of invalidatedStyles) {
-                    changedFiles.add((0, path_1.toPosixPath)(styleFile));
-                }
+                break;
             }
         }
         // Check if package.json was modified
-        let hasPackageJsonChanges = false;
-        if (changedFiles.has(posixPackageJsonPath)) {
+        if (changedFiles.has(packageJsonPath)) {
+            buildState.hasEmittedManifests = false;
             try {
-                const packageJson = await loadPackageJson(packageJsonPath);
-                options.packageJson = packageJson;
-                if (!packageJson.name) {
-                    throw new Error(`The package.json at '${packageJsonPath}' must contain a 'name'.`);
-                }
-                options.packageName = packageJson.name;
-                (0, entry_points_1.updateWatchedEntryPoints)(packageJson, options, buildState, watchedCompilationFiles, packageJsonPath);
-                hasPackageJsonChanges = true;
+                const packageJson = await (0, utils_2.loadPackageJson)(packageJsonPath);
+                (0, entry_points_1.updateWatchedEntryPoints)(packageJson, options, buildState);
             }
             catch (error) {
                 (0, error_1.assertIsError)(error);
                 await buildState.singleProgramCache?.compilationInstance.update?.(changedFiles);
-                buildState.hasEmittedManifests = false;
+                if (buildState.shouldCompileEntryPoints(packageJsonPath, changedFiles)) {
+                    buildState.hasCompilationError = true;
+                }
                 yield {
                     success: false,
                     error: `Failed to reload 'package.json': ${error.message}`,
@@ -241,45 +237,61 @@ async function* runWatchLoop(watcher, options, stylesheetBundler, watchedCompila
                 continue;
             }
         }
-        const hasSourceChanges = !buildState.singleProgramCache ||
-            buildState.hasCompilationError ||
-            buildState.hasEntryPointsChanges ||
-            hasModifiedWatchedFile(changedFiles, watchedCompilationFiles, posixPackageJsonPath);
+        const hasSourceChanges = buildState.shouldCompileEntryPoints(packageJsonPath, changedFiles);
+        if (!hasSourceChanges) {
+            await buildState.singleProgramCache?.compilationInstance.update?.(changedFiles);
+        }
         const assetsToEmit = await collectAssetsToEmit(assets, workspaceRoot, buildState.hasEmittedAssets ? changedFiles : undefined);
-        if (!hasSourceChanges && !hasPackageJsonChanges && assetsToEmit.length === 0) {
+        if (!hasSourceChanges && buildState.hasEmittedManifests && assetsToEmit.length === 0) {
             continue;
         }
         yield await executeBuild('Changes detected. Rebuilding...', {
             options,
             stylesheetBundler,
-            watchedCompilationFiles,
             isWatchMode: true,
-            context,
             buildState,
             modifiedFiles: changedFiles,
             assetsToEmit,
-        }, withProgress, watcher, buildAction);
+        }, logger, withProgress, watcher, buildAction);
     }
 }
 /**
- * Loads and parses a JSON file from disk.
+ * Logs informational, warning, and error messages produced during a build iteration.
+ *
+ * @param logger The Architect logger API.
+ * @param result The build execution result containing logs, warnings, and errors.
  */
-async function loadPackageJson(packageJsonPath) {
-    const content = await promises_1.default.readFile(packageJsonPath, 'utf-8');
-    return JSON.parse(content);
+function logMessages(logger, { logs, warnings, errors }) {
+    if (logs.length) {
+        logger.info(logs.join('\n'));
+    }
+    if (warnings.length) {
+        logger.warn(warnings.join('\n'));
+    }
+    if (errors.length) {
+        logger.error(errors.join('\n'));
+    }
 }
 /**
  * Logs the build completion time and status.
+ *
+ * @param logger The Architect logger API.
+ * @param startTime High-resolution timestamp recorded when the build iteration started.
+ * @param success Whether the build iteration succeeded without errors.
+ * @param outputPath Optional POSIX output directory path to log on successful builds.
  */
-function logBuildResult(logger, startTime, success) {
-    const durationMs = Number(process.hrtime.bigint() - startTime) / 1_000_000;
-    const durationSec = (durationMs / 1000).toFixed(2);
+function logBuildResult(logger, startTime, success, outputPath) {
+    const buildTime = Number(process.hrtime.bigint() - startTime) / 10 ** 9;
+    const message = `Library bundle generation ${success ? 'complete' : 'failed'}.` +
+        ` [${buildTime.toFixed(3)} seconds] - ${new Date().toISOString()}`;
     if (success) {
-        logger.info(`Build at: ${new Date().toISOString()} - Time: ${durationMs.toFixed(0)}ms`);
-        logger.info(`Built Angular library in ${durationSec}s.`);
+        logger.info(message);
+        if (outputPath) {
+            logger.info(`Output location: ${outputPath}\n`);
+        }
     }
     else {
-        logger.error(`Build failed after ${durationSec}s.`);
+        logger.error(message);
     }
 }
 //# sourceMappingURL=builder.js.map