@angular-devkit/build-angular 17.1.2 → 17.2.0-next.1

package/src/tools/esbuild/utils.js

@@ -10,23 +10,25 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getSupportedNodeTargets = exports.transformSupportedBrowsersToTargets = exports.convertOutputFile = exports.createOutputFileFromData = exports.createOutputFileFromText = exports.emitFilesToDisk = exports.writeResultFiles = exports.getFeatureSupport = exports.logMessages = exports.withNoProgress = exports.withSpinner = exports.calculateEstimatedTransferSizes = exports.logBuildStats = void 0;
+exports.logMessages = exports.getSupportedNodeTargets = exports.transformSupportedBrowsersToTargets = exports.convertOutputFile = exports.createOutputFileFromData = exports.createOutputFileFromText = exports.emitFilesToDisk = exports.writeResultFiles = exports.getFeatureSupport = exports.withNoProgress = exports.withSpinner = exports.calculateEstimatedTransferSizes = exports.logBuildStats = void 0;
 const esbuild_1 = require("esbuild");
 const node_crypto_1 = require("node:crypto");
 const node_fs_1 = require("node:fs");
 const promises_1 = __importDefault(require("node:fs/promises"));
-const node_path_1 = __importDefault(require("node:path"));
+const node_path_1 = require("node:path");
+const node_url_1 = require("node:url");
 const node_zlib_1 = require("node:zlib");
 const semver_1 = require("semver");
 const spinner_1 = require("../../utils/spinner");
 const stats_1 = require("../webpack/utils/stats");
 const bundler_context_1 = require("./bundler-context");
-function logBuildStats(logger, metafile, initial, budgetFailures, changedFiles, estimatedTransferSizes) {
-    const stats = [];
+function logBuildStats(metafile, initial, budgetFailures, colors, changedFiles, estimatedTransferSizes, ssrOutputEnabled, verbose) {
+    const browserStats = [];
+    const serverStats = [];
     let unchangedCount = 0;
     for (const [file, output] of Object.entries(metafile.outputs)) {
         // Only display JavaScript and CSS files
-        if (!file.endsWith('.js') && !file.endsWith('.css')) {
+        if (!/\.(?:css|m?js)$/.test(file)) {
             continue;
         }
         // Skip internal component resources
@@ -39,28 +41,40 @@ function logBuildStats(logger, metafile, initial, budgetFailures, changedFiles,
             ++unchangedCount;
             continue;
         }
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const isPlatformServer = output['ng-platform-server'];
+        if (isPlatformServer && !ssrOutputEnabled) {
+            // Only log server build stats when SSR is enabled.
+            continue;
+        }
         let name = initial.get(file)?.name;
         if (name === undefined && output.entryPoint) {
-            name = node_path_1.default
-                .basename(output.entryPoint)
+            name = (0, node_path_1.basename)(output.entryPoint)
                 .replace(/\.[cm]?[jt]s$/, '')
                 .replace(/[\\/.]/g, '-');
         }
-        stats.push({
+        const stat = {
             initial: initial.has(file),
             stats: [file, name ?? '-', output.bytes, estimatedTransferSizes?.get(file) ?? '-'],
-        });
+        };
+        if (isPlatformServer) {
+            serverStats.push(stat);
+        }
+        else {
+            browserStats.push(stat);
+        }
     }
-    if (stats.length > 0) {
-        const tableText = (0, stats_1.generateBuildStatsTable)(stats, true, unchangedCount === 0, !!estimatedTransferSizes, budgetFailures);
-        logger.info('\n' + tableText + '\n');
+    if (browserStats.length > 0 || serverStats.length > 0) {
+        const tableText = (0, stats_1.generateEsbuildBuildStatsTable)([browserStats, serverStats], colors, unchangedCount === 0, !!estimatedTransferSizes, budgetFailures, verbose);
+        return tableText + '\n';
     }
     else if (changedFiles !== undefined) {
-        logger.info('\nNo output file changes.\n');
+        return '\nNo output file changes.\n';
     }
     if (unchangedCount > 0) {
-        logger.info(`Unchanged output files: ${unchangedCount}`);
+        return `Unchanged output files: ${unchangedCount}`;
     }
+    return '';
 }
 exports.logBuildStats = logBuildStats;
 async function calculateEstimatedTransferSizes(outputFiles) {
@@ -117,17 +131,6 @@ async function withNoProgress(text, action) {
     return action();
 }
 exports.withNoProgress = withNoProgress;
-async function logMessages(logger, { errors, warnings }) {
-    if (warnings?.length) {
-        const warningMessages = await (0, esbuild_1.formatMessages)(warnings, { kind: 'warning', color: true });
-        logger.warn(warningMessages.join('\n'));
-    }
-    if (errors?.length) {
-        const errorMessages = await (0, esbuild_1.formatMessages)(errors, { kind: 'error', color: true });
-        logger.error(errorMessages.join('\n'));
-    }
-}
-exports.logMessages = logMessages;
 /**
  * Generates a syntax feature object map for Angular applications based on a list of targets.
  * A full set of feature names can be found here: https://esbuild.github.io/api/#supported
@@ -179,9 +182,9 @@ exports.getFeatureSupport = getFeatureSupport;
 async function writeResultFiles(outputFiles, assetFiles, { base, browser, media, server }) {
     const directoryExists = new Set();
     const ensureDirectoryExists = async (destPath) => {
-        const basePath = node_path_1.default.dirname(destPath);
+        const basePath = (0, node_path_1.dirname)(destPath);
         if (!directoryExists.has(basePath)) {
-            await promises_1.default.mkdir(node_path_1.default.join(base, basePath), { recursive: true });
+            await promises_1.default.mkdir((0, node_path_1.join)(base, basePath), { recursive: true });
             directoryExists.add(basePath);
         }
     };
@@ -202,19 +205,19 @@ async function writeResultFiles(outputFiles, assetFiles, { base, browser, media,
             default:
                 throw new Error(`Unhandled write for file "${file.path}" with type "${bundler_context_1.BuildOutputFileType[file.type]}".`);
         }
-        const destPath = node_path_1.default.join(outputDir, file.path);
+        const destPath = (0, node_path_1.join)(outputDir, file.path);
         // Ensure output subdirectories exist
         await ensureDirectoryExists(destPath);
         // Write file contents
-        await promises_1.default.writeFile(node_path_1.default.join(base, destPath), file.contents);
+        await promises_1.default.writeFile((0, node_path_1.join)(base, destPath), file.contents);
     });
     if (assetFiles?.length) {
         await emitFilesToDisk(assetFiles, async ({ source, destination }) => {
-            const destPath = node_path_1.default.join(browser, destination);
+            const destPath = (0, node_path_1.join)(browser, destination);
             // Ensure output subdirectories exist
             await ensureDirectoryExists(destPath);
             // Copy file contents
-            await promises_1.default.copyFile(source, node_path_1.default.join(base, destPath), node_fs_1.constants.COPYFILE_FICLONE);
+            await promises_1.default.copyFile(source, (0, node_path_1.join)(base, destPath), node_fs_1.constants.COPYFILE_FICLONE);
         });
     }
 }
@@ -341,3 +344,33 @@ function getSupportedNodeTargets() {
     return SUPPORTED_NODE_VERSIONS.split('||').map((v) => 'node' + (0, semver_1.coerce)(v)?.version);
 }
 exports.getSupportedNodeTargets = getSupportedNodeTargets;
+async function logMessages(logger, executionResult, options) {
+    const { outputOptions: { base, server, browser }, ssrOptions, jsonLogs, colors: color, } = options;
+    const { warnings, errors, prerenderedRoutes } = executionResult;
+    const warningMessages = warnings.length
+        ? await (0, esbuild_1.formatMessages)(warnings, { kind: 'warning', color })
+        : [];
+    const errorMessages = errors.length ? await (0, esbuild_1.formatMessages)(errors, { kind: 'error', color }) : [];
+    if (jsonLogs) {
+        // JSON format output
+        const manifest = {
+            errors: errorMessages,
+            warnings: warningMessages,
+            outputPaths: {
+                root: (0, node_url_1.pathToFileURL)(base),
+                browser: (0, node_url_1.pathToFileURL)((0, node_path_1.join)(base, browser)),
+                server: ssrOptions ? (0, node_url_1.pathToFileURL)((0, node_path_1.join)(base, server)) : undefined,
+            },
+            prerenderedRoutes,
+        };
+        logger.info(JSON.stringify(manifest, undefined, 2));
+        return;
+    }
+    if (warningMessages.length) {
+        logger.warn(warningMessages.join('\n'));
+    }
+    if (errorMessages.length) {
+        logger.error(errorMessages.join('\n'));
+    }
+}
+exports.logMessages = logMessages;

package/src/tools/vite/angular-memory-plugin.js

@@ -214,12 +214,13 @@ exports.createAngularMemoryPlugin = createAngularMemoryPlugin;
  */
 async function loadViteClientCode(file) {
     const originalContents = await (0, promises_1.readFile)(file, 'utf-8');
-    let contents = originalContents.replace('You can also disable this overlay by setting', '');
-    contents = contents.replace(
+    const firstUpdate = originalContents.replace('You can also disable this overlay by setting', '');
+    (0, node_assert_1.default)(originalContents !== firstUpdate, 'Failed to update Vite client error overlay text. (1)');
+    const secondUpdate = firstUpdate.replace(
     // eslint-disable-next-line max-len
-    '<code part="config-option-name">server.hmr.overlay</code> to <code part="config-option-value">false</code> in <code part="config-file-name">vite.config.js.</code>', '');
-    (0, node_assert_1.default)(originalContents !== contents, 'Failed to update Vite client error overlay text.');
-    return contents;
+    '<code part="config-option-name">server.hmr.overlay</code> to <code part="config-option-value">false</code> in <code part="config-file-name">${hmrConfigName}.</code>', '');
+    (0, node_assert_1.default)(firstUpdate !== secondUpdate, 'Failed to update Vite client error overlay text. (2)');
+    return secondUpdate;
 }
 function pathnameWithoutBasePath(url, basePath) {
     const parsedUrl = new URL(url, 'http://localhost');

package/src/tools/webpack/utils/stats.d.ts

@@ -22,6 +22,7 @@ export interface BundleStats {
     initial: boolean;
     stats: BundleStatsData;
 }
+export declare function generateEsbuildBuildStatsTable([browserStats, serverStats]: [browserStats: BundleStats[], serverStats: BundleStats[]], colors: boolean, showTotalSize: boolean, showEstimatedTransferSize: boolean, budgetFailures?: BudgetCalculatorResult[], verbose?: boolean): string;
 export declare function generateBuildStatsTable(data: BundleStats[], colors: boolean, showTotalSize: boolean, showEstimatedTransferSize: boolean, budgetFailures?: BudgetCalculatorResult[]): string;
 export declare function statsWarningsToString(json: StatsCompilation, statsConfig: WebpackStatsOptions): string;
 export declare function statsErrorsToString(json: StatsCompilation, statsConfig: WebpackStatsOptions): string;

package/src/tools/webpack/utils/stats.js

@@ -33,11 +33,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.webpackStatsLogger = exports.generateBuildEventStats = exports.createWebpackLoggingCallback = exports.statsHasWarnings = exports.statsHasErrors = exports.statsErrorsToString = exports.statsWarningsToString = exports.generateBuildStatsTable = exports.formatSize = void 0;
-const core_1 = require("@angular-devkit/core");
-const assert_1 = __importDefault(require("assert"));
-const path = __importStar(require("path"));
-const text_table_1 = __importDefault(require("text-table"));
+exports.webpackStatsLogger = exports.generateBuildEventStats = exports.createWebpackLoggingCallback = exports.statsHasWarnings = exports.statsHasErrors = exports.statsErrorsToString = exports.statsWarningsToString = exports.generateBuildStatsTable = exports.generateEsbuildBuildStatsTable = exports.formatSize = void 0;
+const node_assert_1 = __importDefault(require("node:assert"));
+const path = __importStar(require("node:path"));
 const utils_1 = require("../../../utils");
 const color_1 = require("../../../utils/color");
 const async_chunks_1 = require("./async-chunks");
@@ -55,8 +53,8 @@ function formatSize(size) {
 }
 exports.formatSize = formatSize;
 function getBuildDuration(webpackStats) {
-    (0, assert_1.default)(webpackStats.builtAt, 'buildAt cannot be undefined');
-    (0, assert_1.default)(webpackStats.time, 'time cannot be undefined');
+    (0, node_assert_1.default)(webpackStats.builtAt, 'buildAt cannot be undefined');
+    (0, node_assert_1.default)(webpackStats.time, 'time cannot be undefined');
     return Date.now() - webpackStats.builtAt + webpackStats.time;
 }
 function generateBundleStats(info) {
@@ -73,9 +71,31 @@ function generateBundleStats(info) {
         stats: [files, names, rawSize, estimatedTransferSize],
     };
 }
+function generateEsbuildBuildStatsTable([browserStats, serverStats], colors, showTotalSize, showEstimatedTransferSize, budgetFailures, verbose) {
+    const bundleInfo = generateBuildStatsData(browserStats, colors, showTotalSize, showEstimatedTransferSize, budgetFailures, verbose);
+    if (serverStats.length) {
+        const m = (x) => (colors ? color_1.colors.magenta(x) : x);
+        if (browserStats.length) {
+            bundleInfo.unshift([m('Browser bundles')]);
+            // Add seperators between browser and server logs
+            bundleInfo.push([], []);
+        }
+        bundleInfo.push([m('Server bundles')], ...generateBuildStatsData(serverStats, colors, false, false, undefined, verbose));
+    }
+    return generateTableText(bundleInfo, colors);
+}
+exports.generateEsbuildBuildStatsTable = generateEsbuildBuildStatsTable;
 function generateBuildStatsTable(data, colors, showTotalSize, showEstimatedTransferSize, budgetFailures) {
-    const g = (x) => (colors ? color_1.colors.greenBright(x) : x);
-    const c = (x) => (colors ? color_1.colors.cyanBright(x) : x);
+    const bundleInfo = generateBuildStatsData(data, colors, showTotalSize, showEstimatedTransferSize, budgetFailures, true);
+    return generateTableText(bundleInfo, colors);
+}
+exports.generateBuildStatsTable = generateBuildStatsTable;
+function generateBuildStatsData(data, colors, showTotalSize, showEstimatedTransferSize, budgetFailures, verbose) {
+    if (data.length === 0) {
+        return [];
+    }
+    const g = (x) => (colors ? color_1.colors.green(x) : x);
+    const c = (x) => (colors ? color_1.colors.cyan(x) : x);
     const r = (x) => (colors ? color_1.colors.redBright(x) : x);
     const y = (x) => (colors ? color_1.colors.yellowBright(x) : x);
     const bold = (x) => (colors ? color_1.colors.bold(x) : x);
@@ -94,7 +114,9 @@ function generateBuildStatsTable(data, colors, showTotalSize, showEstimatedTrans
     const changedEntryChunksStats = [];
     const changedLazyChunksStats = [];
     let initialTotalRawSize = 0;
+    let changedLazyChunksCount = 0;
     let initialTotalEstimatedTransferSize;
+    const maxLazyChunksWithoutBudgetFailures = 15;
     const budgets = new Map();
     if (budgetFailures) {
         for (const { label, severity } of budgetFailures) {
@@ -117,12 +139,21 @@ function generateBuildStatsTable(data, colors, showTotalSize, showEstimatedTrans
     });
     for (const { initial, stats } of data) {
         const [files, names, rawSize, estimatedTransferSize] = stats;
+        if (!initial &&
+            !verbose &&
+            changedLazyChunksStats.length >= maxLazyChunksWithoutBudgetFailures &&
+            !budgets.has(names) &&
+            !budgets.has(files)) {
+            // Limit the number of lazy chunks displayed in the stats table when there is no budget failure and not in verbose mode.
+            changedLazyChunksCount++;
+            continue;
+        }
         const getRawSizeColor = getSizeColor(names, files);
         let data;
         if (showEstimatedTransferSize) {
             data = [
                 g(files),
-                names,
+                dim(names),
                 getRawSizeColor(typeof rawSize === 'number' ? formatSize(rawSize) : rawSize),
                 c(typeof estimatedTransferSize === 'number'
                     ? formatSize(estimatedTransferSize)
@@ -132,7 +163,7 @@ function generateBuildStatsTable(data, colors, showTotalSize, showEstimatedTrans
         else {
             data = [
                 g(files),
-                names,
+                dim(names),
                 getRawSizeColor(typeof rawSize === 'number' ? formatSize(rawSize) : rawSize),
                 '',
             ];
@@ -151,24 +182,22 @@ function generateBuildStatsTable(data, colors, showTotalSize, showEstimatedTrans
         }
         else {
             changedLazyChunksStats.push(data);
+            changedLazyChunksCount++;
         }
     }
     const bundleInfo = [];
-    const baseTitles = ['Names', 'Raw Size'];
-    const tableAlign = ['l', 'l', 'r'];
+    const baseTitles = ['Names', 'Raw size'];
     if (showEstimatedTransferSize) {
-        baseTitles.push('Estimated Transfer Size');
-        tableAlign.push('r');
+        baseTitles.push('Estimated transfer size');
     }
     // Entry chunks
     if (changedEntryChunksStats.length) {
-        bundleInfo.push(['Initial Chunk Files', ...baseTitles].map(bold), ...changedEntryChunksStats);
+        bundleInfo.push(['Initial chunk files', ...baseTitles].map(bold), ...changedEntryChunksStats);
         if (showTotalSize) {
-            bundleInfo.push([]);
             const initialSizeTotalColor = getSizeColor('bundle initial', undefined, (x) => x);
             const totalSizeElements = [
                 ' ',
-                'Initial Total',
+                'Initial total',
                 initialSizeTotalColor(formatSize(initialTotalRawSize)),
             ];
             if (showEstimatedTransferSize) {
@@ -176,7 +205,7 @@ function generateBuildStatsTable(data, colors, showTotalSize, showEstimatedTrans
                     ? formatSize(initialTotalEstimatedTransferSize)
                     : '-');
             }
-            bundleInfo.push(totalSizeElements.map(bold));
+            bundleInfo.push([], totalSizeElements.map(bold));
         }
     }
     // Seperator
@@ -185,18 +214,54 @@ function generateBuildStatsTable(data, colors, showTotalSize, showEstimatedTrans
     }
     // Lazy chunks
     if (changedLazyChunksStats.length) {
-        bundleInfo.push(['Lazy Chunk Files', ...baseTitles].map(bold), ...changedLazyChunksStats);
+        bundleInfo.push(['Lazy chunk files', ...baseTitles].map(bold), ...changedLazyChunksStats);
+        if (changedLazyChunksCount > changedLazyChunksStats.length) {
+            bundleInfo.push([
+                dim(`...and ${changedLazyChunksCount - changedLazyChunksStats.length} more lazy chunks files. ` +
+                    'Use "--verbose" to show all the files.'),
+            ]);
+        }
     }
-    return (0, text_table_1.default)(bundleInfo, {
-        hsep: dim(' | '),
-        stringLength: (s) => (0, color_1.removeColor)(s).length,
-        align: tableAlign,
-    });
+    return bundleInfo;
 }
-exports.generateBuildStatsTable = generateBuildStatsTable;
-function generateBuildStats(hash, time, colors) {
-    const w = (x) => (colors ? color_1.colors.bold.white(x) : x);
-    return `Build at: ${w(new Date().toISOString())} - Hash: ${w(hash)} - Time: ${w('' + time)}ms`;
+function generateTableText(bundleInfo, colors) {
+    const skipText = (value) => value.includes('...and ');
+    const longest = [];
+    for (const item of bundleInfo) {
+        for (let i = 0; i < item.length; i++) {
+            if (item[i] === undefined) {
+                continue;
+            }
+            const currentItem = item[i].toString();
+            if (skipText(currentItem)) {
+                continue;
+            }
+            const currentLongest = (longest[i] ??= 0);
+            const currentItemLength = (0, color_1.removeColor)(currentItem).length;
+            if (currentLongest < currentItemLength) {
+                longest[i] = currentItemLength;
+            }
+        }
+    }
+    const seperator = colors ? color_1.colors.dim(' | ') : ' | ';
+    const outputTable = [];
+    for (const item of bundleInfo) {
+        for (let i = 0; i < longest.length; i++) {
+            if (item[i] === undefined) {
+                continue;
+            }
+            const currentItem = item[i].toString();
+            if (skipText(currentItem)) {
+                continue;
+            }
+            const currentItemLength = (0, color_1.removeColor)(currentItem).length;
+            const stringPad = ' '.repeat(longest[i] - currentItemLength);
+            // Values in columns at index 2 and 3 (Raw and Estimated sizes) are always right aligned.
+            item[i] = i >= 2 ? stringPad + currentItem : currentItem + stringPad;
+        }
+        outputTable.push(item.join(seperator));
+    }
+    return outputTable.join('\n');
 }
 // We use this cache because we can have multiple builders running in the same process,
 // where each builder has different output path.
@@ -210,6 +275,7 @@ statsConfig, budgetFailures) {
     }
     const colors = statsConfig.colors;
     const rs = (x) => (colors ? color_1.colors.reset(x) : x);
+    const w = (x) => (colors ? color_1.colors.bold.white(x) : x);
     const changedChunksStats = [];
     let unchangedChunkNumber = 0;
     let hasEstimatedTransferSizes = false;
@@ -247,24 +313,9 @@ statsConfig, budgetFailures) {
     // Such us index generation, service worker augmentation etc...
     // This will correct the time and include these.
     const time = getBuildDuration(json);
-    if (unchangedChunkNumber > 0) {
-        return ('\n' +
-            rs(core_1.tags.stripIndents `
-      ${statsTable}
-
-      ${unchangedChunkNumber} unchanged chunks
-
-      ${generateBuildStats(json.hash || '', time, colors)}
-      `));
-    }
-    else {
-        return ('\n' +
-            rs(core_1.tags.stripIndents `
-      ${statsTable}
-
-      ${generateBuildStats(json.hash || '', time, colors)}
-      `));
-    }
+    return rs(`\n${statsTable}\n\n` +
+        (unchangedChunkNumber > 0 ? `${unchangedChunkNumber} unchanged chunks\n\n` : '') +
+        `Build at: ${w(new Date().toISOString())} - Hash: ${w(json.hash || '')} - Time: ${w('' + time)}ms`);
 }
 function statsWarningsToString(json, statsConfig) {
     const colors = statsConfig.colors;

package/src/utils/environment-options.d.ts

@@ -13,3 +13,5 @@ export declare const useParallelTs: boolean;
 export declare const useLegacySass: boolean;
 export declare const debugPerformance: boolean;
 export declare const shouldWatchRoot: boolean;
+export declare const useTypeChecking: boolean;
+export declare const useJSONBuildLogs: boolean;

package/src/utils/environment-options.js

@@ -7,7 +7,7 @@
  * found in the LICENSE file at https://angular.io/license
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.shouldWatchRoot = exports.debugPerformance = exports.useLegacySass = exports.useParallelTs = exports.maxWorkers = exports.allowMinify = exports.shouldBeautify = exports.allowMangle = void 0;
+exports.useJSONBuildLogs = exports.useTypeChecking = exports.shouldWatchRoot = exports.debugPerformance = exports.useLegacySass = exports.useParallelTs = exports.maxWorkers = exports.allowMinify = exports.shouldBeautify = exports.allowMangle = void 0;
 const color_1 = require("./color");
 function isDisabled(variable) {
     return variable === '0' || variable.toLowerCase() === 'false';
@@ -83,3 +83,7 @@ const debugPerfVariable = process.env['NG_BUILD_DEBUG_PERF'];
 exports.debugPerformance = isPresent(debugPerfVariable) && isEnabled(debugPerfVariable);
 const watchRootVariable = process.env['NG_BUILD_WATCH_ROOT'];
 exports.shouldWatchRoot = isPresent(watchRootVariable) && isEnabled(watchRootVariable);
+const typeCheckingVariable = process.env['NG_BUILD_TYPE_CHECK'];
+exports.useTypeChecking = !isPresent(typeCheckingVariable) || !isDisabled(typeCheckingVariable);
+const buildLogsJsonVariable = process.env['NG_BUILD_LOGS_JSON'];
+exports.useJSONBuildLogs = isPresent(buildLogsJsonVariable) && isEnabled(buildLogsJsonVariable);

package/src/utils/postcss-configuration.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.io/license
+ */
+export interface PostcssConfiguration {
+    plugins: [name: string, options?: object][];
+}
+export declare function loadPostcssConfiguration(workspaceRoot: string, projectRoot: string): Promise<PostcssConfiguration | undefined>;

package/src/utils/postcss-configuration.js

@@ -0,0 +1,77 @@
+"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.loadPostcssConfiguration = void 0;
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+const postcssConfigurationFiles = ['postcss.config.json', '.postcssrc.json'];
+async function generateSearchDirectories(roots) {
+    return await Promise.all(roots.map((root) => (0, promises_1.readdir)(root, { withFileTypes: true }).then((entries) => ({
+        root,
+        files: new Set(entries.filter((entry) => entry.isFile()).map((entry) => entry.name)),
+    }))));
+}
+function findFile(searchDirectories, potentialFiles) {
+    for (const { root, files } of searchDirectories) {
+        for (const potential of potentialFiles) {
+            if (files.has(potential)) {
+                return (0, node_path_1.join)(root, potential);
+            }
+        }
+    }
+    return undefined;
+}
+async function readPostcssConfiguration(configurationFile) {
+    const data = await (0, promises_1.readFile)(configurationFile, 'utf-8');
+    const config = JSON.parse(data);
+    return config;
+}
+async function loadPostcssConfiguration(workspaceRoot, projectRoot) {
+    // A configuration file can exist in the project or workspace root
+    const searchDirectories = await generateSearchDirectories([projectRoot, workspaceRoot]);
+    const configPath = findFile(searchDirectories, postcssConfigurationFiles);
+    if (!configPath) {
+        return undefined;
+    }
+    const raw = await readPostcssConfiguration(configPath);
+    // If no plugins are defined, consider it equivalent to no configuration
+    if (!raw.plugins || typeof raw.plugins !== 'object') {
+        return undefined;
+    }
+    // Normalize plugin array form
+    if (Array.isArray(raw.plugins)) {
+        if (raw.plugins.length < 1) {
+            return undefined;
+        }
+        const config = { plugins: [] };
+        for (const element of raw.plugins) {
+            if (typeof element === 'string') {
+                config.plugins.push([element]);
+            }
+            else {
+                config.plugins.push(element);
+            }
+        }
+        return config;
+    }
+    // Normalize plugin object map form
+    const entries = Object.entries(raw.plugins);
+    if (entries.length < 1) {
+        return undefined;
+    }
+    const config = { plugins: [] };
+    for (const [name, options] of entries) {
+        if (!options || typeof options !== 'object') {
+            continue;
+        }
+        config.plugins.push([name, options]);
+    }
+    return config;
+}
+exports.loadPostcssConfiguration = loadPostcssConfiguration;