@angular/build 20.2.0 → 21.0.0-next.0

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

@@ -5,16 +5,59 @@
  * 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
  */
+/**
+ * Allows disabling of code mangling when the `NG_BUILD_MANGLE` environment variable is set to `0` or `false`.
+ * This is useful for debugging build output.
+ */
 export declare const allowMangle: boolean;
+/**
+ * Allows beautification of build output when the `NG_BUILD_DEBUG_OPTIMIZE` environment variable is enabled.
+ * This is useful for debugging build output.
+ */
 export declare const shouldBeautify: boolean;
+/**
+ * Allows disabling of code minification when the `NG_BUILD_DEBUG_OPTIMIZE` environment variable is enabled.
+ * This is useful for debugging build output.
+ */
 export declare const allowMinify: boolean;
+/**
+ * The maximum number of workers to use for parallel processing.
+ * This can be controlled by the `NG_BUILD_MAX_WORKERS` environment variable.
+ */
 export declare const maxWorkers: number;
+/**
+ * When `NG_BUILD_PARALLEL_TS` is set to `0` or `false`, parallel TypeScript compilation is disabled.
+ */
 export declare const useParallelTs: boolean;
+/**
+ * When `NG_BUILD_DEBUG_PERF` is enabled, performance debugging information is printed.
+ */
 export declare const debugPerformance: boolean;
+/**
+ * When `NG_BUILD_WATCH_ROOT` is enabled, the build will watch the root directory for changes.
+ */
 export declare const shouldWatchRoot: boolean;
+/**
+ * When `NG_BUILD_TYPE_CHECK` is set to `0` or `false`, type checking is disabled.
+ */
 export declare const useTypeChecking: boolean;
+/**
+ * When `NG_BUILD_LOGS_JSON` is enabled, build logs will be output in JSON format.
+ */
 export declare const useJSONBuildLogs: boolean;
+/**
+ * When `NG_BUILD_OPTIMIZE_CHUNKS` is enabled, the build will optimize chunks.
+ */
 export declare const shouldOptimizeChunks: boolean;
+/**
+ * When `NG_HMR_CSTYLES` is enabled, component styles will be hot-reloaded.
+ */
 export declare const useComponentStyleHmr: boolean;
+/**
+ * When `NG_HMR_TEMPLATES` is set to `0` or `false`, component templates will not be hot-reloaded.
+ */
 export declare const useComponentTemplateHmr: boolean;
+/**
+ * When `NG_BUILD_PARTIAL_SSR` is enabled, a partial server-side rendering build will be performed.
+ */
 export declare const usePartialSsrBuild: boolean;

package/src/utils/environment-options.js

@@ -9,19 +9,42 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.usePartialSsrBuild = exports.useComponentTemplateHmr = exports.useComponentStyleHmr = exports.shouldOptimizeChunks = exports.useJSONBuildLogs = exports.useTypeChecking = exports.shouldWatchRoot = exports.debugPerformance = exports.useParallelTs = exports.maxWorkers = exports.allowMinify = exports.shouldBeautify = exports.allowMangle = void 0;
 const node_os_1 = require("node:os");
-function isDisabled(variable) {
-    return variable === '0' || variable.toLowerCase() === 'false';
-}
-function isEnabled(variable) {
-    return variable === '1' || variable.toLowerCase() === 'true';
-}
+/** A set of strings that are considered "truthy" when parsing environment variables. */
+const TRUTHY_VALUES = new Set(['1', 'true']);
+/** A set of strings that are considered "falsy" when parsing environment variables. */
+const FALSY_VALUES = new Set(['0', 'false']);
+/**
+ * Checks if an environment variable is present and has a non-empty value.
+ * @param variable The environment variable to check.
+ * @returns `true` if the variable is a non-empty string.
+ */
 function isPresent(variable) {
     return typeof variable === 'string' && variable !== '';
 }
+/**
+ * Parses an environment variable into a boolean or undefined.
+ * @returns `true` if the variable is truthy ('1', 'true').
+ * @returns `false` if the variable is falsy ('0', 'false').
+ * @returns `undefined` if the variable is not present or has an unknown value.
+ */
+function parseTristate(variable) {
+    if (!isPresent(variable)) {
+        return undefined;
+    }
+    const value = variable.toLowerCase();
+    if (TRUTHY_VALUES.has(value)) {
+        return true;
+    }
+    if (FALSY_VALUES.has(value)) {
+        return false;
+    }
+    // TODO: Consider whether a warning is useful in this case of a malformed value
+    return undefined;
+}
 // Optimization and mangling
 const debugOptimizeVariable = process.env['NG_BUILD_DEBUG_OPTIMIZE'];
 const debugOptimize = (() => {
-    if (!isPresent(debugOptimizeVariable) || isDisabled(debugOptimizeVariable)) {
+    if (!isPresent(debugOptimizeVariable) || parseTristate(debugOptimizeVariable) === false) {
         return {
             mangle: true,
             minify: true,
@@ -33,7 +56,7 @@ const debugOptimize = (() => {
         minify: false,
         beautify: true,
     };
-    if (isEnabled(debugOptimizeVariable)) {
+    if (parseTristate(debugOptimizeVariable) === true) {
         return debugValue;
     }
     for (const part of debugOptimizeVariable.split(',')) {
@@ -51,11 +74,20 @@ const debugOptimize = (() => {
     }
     return debugValue;
 })();
-const mangleVariable = process.env['NG_BUILD_MANGLE'];
-exports.allowMangle = isPresent(mangleVariable)
-    ? !isDisabled(mangleVariable)
-    : debugOptimize.mangle;
+/**
+ * Allows disabling of code mangling when the `NG_BUILD_MANGLE` environment variable is set to `0` or `false`.
+ * This is useful for debugging build output.
+ */
+exports.allowMangle = parseTristate(process.env['NG_BUILD_MANGLE']) ?? debugOptimize.mangle;
+/**
+ * Allows beautification of build output when the `NG_BUILD_DEBUG_OPTIMIZE` environment variable is enabled.
+ * This is useful for debugging build output.
+ */
 exports.shouldBeautify = debugOptimize.beautify;
+/**
+ * Allows disabling of code minification when the `NG_BUILD_DEBUG_OPTIMIZE` environment variable is enabled.
+ * This is useful for debugging build output.
+ */
 exports.allowMinify = debugOptimize.minify;
 /**
  * Some environments, like CircleCI which use Docker report a number of CPUs by the host and not the count of available.
@@ -67,24 +99,46 @@ exports.allowMinify = debugOptimize.minify;
  *
  */
 const maxWorkersVariable = process.env['NG_BUILD_MAX_WORKERS'];
+/**
+ * The maximum number of workers to use for parallel processing.
+ * This can be controlled by the `NG_BUILD_MAX_WORKERS` environment variable.
+ */
 exports.maxWorkers = isPresent(maxWorkersVariable)
     ? +maxWorkersVariable
     : Math.min(4, Math.max((0, node_os_1.availableParallelism)() - 1, 1));
-const parallelTsVariable = process.env['NG_BUILD_PARALLEL_TS'];
-exports.useParallelTs = !isPresent(parallelTsVariable) || !isDisabled(parallelTsVariable);
-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);
-const optimizeChunksVariable = process.env['NG_BUILD_OPTIMIZE_CHUNKS'];
-exports.shouldOptimizeChunks = isPresent(optimizeChunksVariable) && isEnabled(optimizeChunksVariable);
-const hmrComponentStylesVariable = process.env['NG_HMR_CSTYLES'];
-exports.useComponentStyleHmr = isPresent(hmrComponentStylesVariable) && isEnabled(hmrComponentStylesVariable);
-const hmrComponentTemplateVariable = process.env['NG_HMR_TEMPLATES'];
-exports.useComponentTemplateHmr = !isPresent(hmrComponentTemplateVariable) || !isDisabled(hmrComponentTemplateVariable);
-const partialSsrBuildVariable = process.env['NG_BUILD_PARTIAL_SSR'];
-exports.usePartialSsrBuild = isPresent(partialSsrBuildVariable) && isEnabled(partialSsrBuildVariable);
+/**
+ * When `NG_BUILD_PARALLEL_TS` is set to `0` or `false`, parallel TypeScript compilation is disabled.
+ */
+exports.useParallelTs = parseTristate(process.env['NG_BUILD_PARALLEL_TS']) !== false;
+/**
+ * When `NG_BUILD_DEBUG_PERF` is enabled, performance debugging information is printed.
+ */
+exports.debugPerformance = parseTristate(process.env['NG_BUILD_DEBUG_PERF']) === true;
+/**
+ * When `NG_BUILD_WATCH_ROOT` is enabled, the build will watch the root directory for changes.
+ */
+exports.shouldWatchRoot = parseTristate(process.env['NG_BUILD_WATCH_ROOT']) === true;
+/**
+ * When `NG_BUILD_TYPE_CHECK` is set to `0` or `false`, type checking is disabled.
+ */
+exports.useTypeChecking = parseTristate(process.env['NG_BUILD_TYPE_CHECK']) !== false;
+/**
+ * When `NG_BUILD_LOGS_JSON` is enabled, build logs will be output in JSON format.
+ */
+exports.useJSONBuildLogs = parseTristate(process.env['NG_BUILD_LOGS_JSON']) === true;
+/**
+ * When `NG_BUILD_OPTIMIZE_CHUNKS` is enabled, the build will optimize chunks.
+ */
+exports.shouldOptimizeChunks = parseTristate(process.env['NG_BUILD_OPTIMIZE_CHUNKS']) === true;
+/**
+ * When `NG_HMR_CSTYLES` is enabled, component styles will be hot-reloaded.
+ */
+exports.useComponentStyleHmr = parseTristate(process.env['NG_HMR_CSTYLES']) === true;
+/**
+ * When `NG_HMR_TEMPLATES` is set to `0` or `false`, component templates will not be hot-reloaded.
+ */
+exports.useComponentTemplateHmr = parseTristate(process.env['NG_HMR_TEMPLATES']) !== false;
+/**
+ * When `NG_BUILD_PARTIAL_SSR` is enabled, a partial server-side rendering build will be performed.
+ */
+exports.usePartialSsrBuild = parseTristate(process.env['NG_BUILD_PARTIAL_SSR']) === true;

package/src/utils/normalize-cache.js

@@ -10,7 +10,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.normalizeCacheOptions = normalizeCacheOptions;
 const node_path_1 = require("node:path");
 /** Version placeholder is replaced during the build process with actual package version */
-const VERSION = '20.2.0';
+const VERSION = '21.0.0-next.0';
 function hasCacheMetadata(value) {
     return (!!value &&
         typeof value === 'object' &&

package/src/utils/version.js

@@ -28,7 +28,7 @@ function assertCompatibleAngularVersion(projectRoot) {
             'This likely indicates a corrupted local installation. Please try reinstalling your packages.');
         process.exit(2);
     }
-    const supportedAngularSemver = '^20.0.0';
+    const supportedAngularSemver = '^21.0.0-next.0';
     if (angularPkgJson['version'] === '0.0.0' || supportedAngularSemver.startsWith('0.0.0')) {
         // Internal CLI and FW testing version.
         return;

package/src/builders/dev-server/vite-server.d.ts

@@ -1,42 +0,0 @@
-/**
- * @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
- */
-import type { BuilderContext } from '@angular-devkit/architect';
-import type { Plugin } from 'esbuild';
-import type { Connect, InlineConfig } from 'vite';
-import type { ComponentStyleRecord } from '../../tools/vite/middlewares';
-import { ServerSsrMode } from '../../tools/vite/plugins';
-import { EsbuildLoaderOption } from '../../tools/vite/utils';
-import { Result } from '../application/results';
-import { type ApplicationBuilderInternalOptions, BuildOutputFileType, type ExternalResultMetadata, JavaScriptTransformer } from './internal';
-import type { NormalizedDevServerOptions } from './options';
-import type { DevServerBuilderOutput } from './output';
-interface OutputFileRecord {
-    contents: Uint8Array;
-    size: number;
-    hash: string;
-    updated: boolean;
-    servable: boolean;
-    type: BuildOutputFileType;
-}
-interface OutputAssetRecord {
-    source: string;
-    updated: boolean;
-}
-interface DevServerExternalResultMetadata extends Omit<ExternalResultMetadata, 'explicit'> {
-    explicitBrowser: string[];
-    explicitServer: string[];
-}
-export type BuilderAction = (options: ApplicationBuilderInternalOptions, context: BuilderContext, plugins?: Plugin[]) => AsyncIterable<Result>;
-export declare function serveWithVite(serverOptions: NormalizedDevServerOptions, builderName: string, builderAction: BuilderAction, context: BuilderContext, transformers?: {
-    indexHtml?: (content: string) => Promise<string>;
-}, extensions?: {
-    middleware?: Connect.NextHandleFunction[];
-    buildPlugins?: Plugin[];
-}): AsyncIterableIterator<DevServerBuilderOutput>;
-export declare function setupServer(serverOptions: NormalizedDevServerOptions, outputFiles: Map<string, OutputFileRecord>, assets: Map<string, OutputAssetRecord>, preserveSymlinks: boolean | undefined, externalMetadata: DevServerExternalResultMetadata, ssrMode: ServerSsrMode, prebundleTransformer: JavaScriptTransformer, target: string[], zoneless: boolean, componentStyles: Map<string, ComponentStyleRecord>, templateUpdates: Map<string, string>, prebundleLoaderExtensions: EsbuildLoaderOption | undefined, define: ApplicationBuilderInternalOptions['define'], extensionMiddleware?: Connect.NextHandleFunction[], indexHtmlTransformer?: (content: string) => Promise<string>, thirdPartySourcemaps?: boolean): Promise<InlineConfig>;
-export {};

package/src/builders/unit-test/karma-bridge.d.ts

@@ -1,10 +0,0 @@
-/**
- * @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
- */
-import type { BuilderContext, BuilderOutput } from '@angular-devkit/architect';
-import { type NormalizedUnitTestBuilderOptions } from './options';
-export declare function useKarmaBuilder(context: BuilderContext, unitTestOptions: NormalizedUnitTestBuilderOptions): Promise<AsyncIterable<BuilderOutput>>;

package/src/builders/unit-test/karma-bridge.js

@@ -1,82 +0,0 @@
-"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
- */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.useKarmaBuilder = useKarmaBuilder;
-const options_1 = require("./options");
-async function useKarmaBuilder(context, unitTestOptions) {
-    if (unitTestOptions.debug) {
-        context.logger.warn('The "karma" test runner does not support the "debug" option. The option will be ignored.');
-    }
-    if (unitTestOptions.setupFiles.length) {
-        context.logger.warn('The "karma" test runner does not support the "setupFiles" option. The option will be ignored.');
-    }
-    const buildTargetOptions = (await context.validateOptions(await context.getTargetOptions(unitTestOptions.buildTarget), await context.getBuilderNameForTarget(unitTestOptions.buildTarget)));
-    buildTargetOptions.polyfills = (0, options_1.injectTestingPolyfills)(buildTargetOptions.polyfills);
-    const options = {
-        tsConfig: unitTestOptions.tsConfig,
-        polyfills: buildTargetOptions.polyfills,
-        assets: buildTargetOptions.assets,
-        scripts: buildTargetOptions.scripts,
-        styles: buildTargetOptions.styles,
-        inlineStyleLanguage: buildTargetOptions.inlineStyleLanguage,
-        stylePreprocessorOptions: buildTargetOptions.stylePreprocessorOptions,
-        externalDependencies: buildTargetOptions.externalDependencies,
-        loader: buildTargetOptions.loader,
-        define: buildTargetOptions.define,
-        include: unitTestOptions.include,
-        exclude: unitTestOptions.exclude,
-        sourceMap: buildTargetOptions.sourceMap,
-        progress: buildTargetOptions.progress,
-        watch: unitTestOptions.watch,
-        poll: buildTargetOptions.poll,
-        preserveSymlinks: buildTargetOptions.preserveSymlinks,
-        browsers: unitTestOptions.browsers?.join(','),
-        codeCoverage: !!unitTestOptions.codeCoverage,
-        codeCoverageExclude: unitTestOptions.codeCoverage?.exclude,
-        fileReplacements: buildTargetOptions.fileReplacements,
-        reporters: unitTestOptions.reporters,
-        webWorkerTsConfig: buildTargetOptions.webWorkerTsConfig,
-        aot: buildTargetOptions.aot,
-    };
-    const { execute } = await Promise.resolve().then(() => __importStar(require('../karma')));
-    return execute(options, context);
-}