@depup/angular-devkit__build-angular 21.2.2-depup.0

package/src/builders/dev-server/builder.js

@@ -0,0 +1,160 @@
+"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.execute = execute;
+const private_1 = require("@angular/build/private");
+const rxjs_1 = require("rxjs");
+const options_1 = require("./options");
+/**
+ * A Builder that executes a development server based on the provided browser target option.
+ *
+ * Usage of the `transforms` and/or `extensions` parameters is NOT supported and may cause
+ * unexpected build output or build failures.
+ *
+ * @param options Dev Server options.
+ * @param context The build context.
+ * @param transforms A map of transforms that can be used to hook into some logic (such as
+ * transforming webpack configuration before passing it to webpack).
+ * @param extensions An optional object containing an array of build plugins (esbuild-based)
+ * and/or HTTP request middleware.
+ *
+ * @experimental Direct usage of this function is considered experimental.
+ */
+function execute(options, context, transforms = {}, extensions) {
+    // Determine project name from builder context target
+    const projectName = context.target?.project;
+    if (!projectName) {
+        context.logger.error(`The "dev-server" builder requires a target to be specified.`);
+        return rxjs_1.EMPTY;
+    }
+    return (0, rxjs_1.defer)(() => initialize(options, projectName, context, extensions?.builderSelector)).pipe((0, rxjs_1.switchMap)(({ builderName, normalizedOptions }) => {
+        // Use vite-based development server for esbuild-based builds
+        if ((0, options_1.isEsbuildBased)(builderName)) {
+            if (transforms?.logging || transforms?.webpackConfiguration) {
+                throw new Error(`The "application" and "browser-esbuild" builders do not support Webpack transforms.`);
+            }
+            if (options.publicHost) {
+                context.logger.warn(`The "publicHost" option will not be used because it is not supported by the "${builderName}" builder.`);
+            }
+            if (options.disableHostCheck) {
+                context.logger.warn(`The "disableHostCheck" option will not be used because it is not supported by the "${builderName}" builder.`);
+            }
+            // New build system defaults hmr option to the value of liveReload
+            normalizedOptions.hmr ??= normalizedOptions.liveReload;
+            // New build system uses Vite's allowedHost option convention of true for disabling host checks
+            if (normalizedOptions.disableHostCheck) {
+                normalizedOptions.allowedHosts = true;
+            }
+            else {
+                normalizedOptions.allowedHosts ??= [];
+            }
+            return (0, rxjs_1.defer)(() => Promise.all([Promise.resolve().then(() => __importStar(require('@angular/build/private'))), Promise.resolve().then(() => __importStar(require('../browser-esbuild')))])).pipe((0, rxjs_1.switchMap)(([{ serveWithVite, buildApplicationInternal }, { convertBrowserOptions }]) => serveWithVite(normalizedOptions, builderName, (options, context, codePlugins) => {
+                return builderName === '@angular-devkit/build-angular:browser-esbuild'
+                    ? // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                        buildApplicationInternal(convertBrowserOptions(options), context, {
+                            codePlugins,
+                        })
+                    : buildApplicationInternal(options, context, { codePlugins });
+            }, context, transforms, extensions)));
+        }
+        // Warn if the initial options provided by the user enable prebundling with Webpack-based builders
+        if (options.prebundle) {
+            context.logger.warn(`Prebundling has been configured but will not be used because it is not supported by the "${builderName}" builder.`);
+        }
+        if (extensions?.buildPlugins?.length) {
+            throw new Error('Only the "application" and "browser-esbuild" builders support plugins.');
+        }
+        if (extensions?.middleware?.length) {
+            throw new Error('Only the "application" and "browser-esbuild" builders support middleware.');
+        }
+        // Webpack based build systems default to false for hmr option
+        normalizedOptions.hmr ??= false;
+        // Use Webpack for all other browser targets
+        return (0, rxjs_1.defer)(() => Promise.resolve().then(() => __importStar(require('./webpack-server')))).pipe((0, rxjs_1.switchMap)(({ serveWebpackBrowser }) => serveWebpackBrowser(normalizedOptions, builderName, context, transforms)));
+    }));
+}
+async function initialize(initialOptions, projectName, context, builderSelector = defaultBuilderSelector) {
+    // Purge old build disk cache.
+    await (0, private_1.purgeStaleBuildCache)(context);
+    const normalizedOptions = await (0, options_1.normalizeOptions)(context, projectName, initialOptions);
+    const builderName = builderSelector({
+        builderName: await context.getBuilderNameForTarget(normalizedOptions.buildTarget),
+        forceEsbuild: !!normalizedOptions.forceEsbuild,
+    }, context.logger);
+    if (!normalizedOptions.disableHostCheck &&
+        !/^127\.\d+\.\d+\.\d+/g.test(normalizedOptions.host) &&
+        normalizedOptions.host !== 'localhost') {
+        context.logger.warn(`
+Warning: This is a simple server for use in testing or debugging Angular applications
+locally. It hasn't been reviewed for security issues.
+
+Binding this server to an open connection can result in compromising your application or
+computer. Using a different host than the one passed to the "--host" flag might result in
+websocket connection issues. You might need to use "--disable-host-check" if that's the
+case.
+    `);
+    }
+    if (normalizedOptions.disableHostCheck) {
+        context.logger.warn('Warning: Running a server with --disable-host-check is a security risk. ' +
+            'See https://medium.com/webpack/webpack-dev-server-middleware-security-issues-1489d950874a for more information.');
+    }
+    normalizedOptions.port = await (0, private_1.checkPort)(normalizedOptions.port, normalizedOptions.host);
+    return {
+        builderName,
+        normalizedOptions,
+    };
+}
+function defaultBuilderSelector(info, logger) {
+    if ((0, options_1.isEsbuildBased)(info.builderName)) {
+        return info.builderName;
+    }
+    if (info.forceEsbuild) {
+        if (!info.builderName.startsWith('@angular-devkit/build-angular:')) {
+            logger.warn('Warning: Forcing the use of the esbuild-based build system with third-party builders' +
+                ' may cause unexpected behavior and/or build failures.');
+        }
+        // The compatibility builder should be used if esbuild is force enabled.
+        return '@angular-devkit/build-angular:browser-esbuild';
+    }
+    return info.builderName;
+}
+//# sourceMappingURL=builder.js.map

package/src/builders/dev-server/builder.js.map

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

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

@@ -0,0 +1,14 @@
+/**
+ * @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 { DevServerBuilderOutput } from '@angular/build';
+import { execute } from './builder';
+import { Schema as DevServerBuilderOptions } from './schema';
+export { type DevServerBuilderOptions, type DevServerBuilderOutput, execute as executeDevServerBuilder, };
+declare const _default: import("@angular-devkit/architect").Builder<DevServerBuilderOptions & import("@angular-devkit/core").JsonObject>;
+export default _default;
+export { execute as executeDevServer };

package/src/builders/dev-server/index.js

@@ -0,0 +1,16 @@
+"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.executeDevServer = exports.executeDevServerBuilder = void 0;
+const architect_1 = require("@angular-devkit/architect");
+const builder_1 = require("./builder");
+Object.defineProperty(exports, "executeDevServerBuilder", { enumerable: true, get: function () { return builder_1.execute; } });
+Object.defineProperty(exports, "executeDevServer", { enumerable: true, get: function () { return builder_1.execute; } });
+exports.default = (0, architect_1.createBuilder)(builder_1.execute);
+//# sourceMappingURL=index.js.map

package/src/builders/dev-server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAGH,yDAA0D;AAC1D,uCAAoC;AAMvB,wGANJ,iBAAO,OAMoB;AAKhB,iGAXX,iBAAO,OAWoB;AAHpC,kBAAe,IAAA,yBAAa,EAAkD,iBAAO,CAAC,CAAC"}

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

@@ -0,0 +1,52 @@
+/**
+ * @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 { BuilderContext } from '@angular-devkit/architect';
+import { Schema as DevServerOptions } from './schema';
+export type NormalizedDevServerOptions = Awaited<ReturnType<typeof normalizeOptions>>;
+export declare function isEsbuildBased(builderName: string): builderName is '@angular/build:application' | '@angular-devkit/build-angular:application' | '@angular-devkit/build-angular:browser-esbuild';
+/**
+ * Normalize the user provided options by creating full paths for all path based options
+ * and converting multi-form options into a single form that can be directly used
+ * by the build process.
+ *
+ * @param context The context for current builder execution.
+ * @param projectName The name of the project for the current execution.
+ * @param options An object containing the options to use for the build.
+ * @returns An object containing normalized options required to perform the build.
+ */
+export declare function normalizeOptions(context: BuilderContext, projectName: string, options: DevServerOptions): Promise<{
+    buildTarget: import("@angular-devkit/architect").Target;
+    host: string;
+    port: number;
+    poll: number | undefined;
+    open: boolean | undefined;
+    verbose: boolean | undefined;
+    watch: boolean | undefined;
+    liveReload: boolean;
+    hmr: boolean | undefined;
+    headers: {
+        [key: string]: string;
+    } | undefined;
+    workspaceRoot: string;
+    projectRoot: string;
+    cacheOptions: import("../../utils/normalize-cache").NormalizedCachedOptions;
+    allowedHosts: string[] | undefined;
+    disableHostCheck: boolean | undefined;
+    proxyConfig: string | undefined;
+    servePath: string | undefined;
+    publicHost: string | undefined;
+    ssl: boolean | undefined;
+    sslCert: string | undefined;
+    sslKey: string | undefined;
+    forceEsbuild: boolean | undefined;
+    prebundle: import("./schema").PrebundleUnion;
+    inspect: boolean | {
+        host?: string;
+        port?: number;
+    };
+}>;

package/src/builders/dev-server/options.js

@@ -0,0 +1,116 @@
+"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 __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isEsbuildBased = isEsbuildBased;
+exports.normalizeOptions = normalizeOptions;
+const architect_1 = require("@angular-devkit/architect");
+const node_path_1 = __importDefault(require("node:path"));
+const normalize_cache_1 = require("../../utils/normalize-cache");
+const normalize_optimization_1 = require("../../utils/normalize-optimization");
+function isEsbuildBased(builderName) {
+    if (builderName === '@angular/build:application' ||
+        builderName === '@angular-devkit/build-angular:application' ||
+        builderName === '@angular-devkit/build-angular:browser-esbuild') {
+        return true;
+    }
+    return false;
+}
+/**
+ * Normalize the user provided options by creating full paths for all path based options
+ * and converting multi-form options into a single form that can be directly used
+ * by the build process.
+ *
+ * @param context The context for current builder execution.
+ * @param projectName The name of the project for the current execution.
+ * @param options An object containing the options to use for the build.
+ * @returns An object containing normalized options required to perform the build.
+ */
+async function normalizeOptions(context, projectName, options) {
+    const { workspaceRoot, logger } = context;
+    const projectMetadata = await context.getProjectMetadata(projectName);
+    const projectRoot = node_path_1.default.join(workspaceRoot, projectMetadata.root ?? '');
+    const cacheOptions = (0, normalize_cache_1.normalizeCacheOptions)(projectMetadata, workspaceRoot);
+    // Target specifier defaults to the current project's build target using a development configuration
+    const buildTargetSpecifier = options.buildTarget ?? `::development`;
+    const buildTarget = (0, architect_1.targetFromTargetString)(buildTargetSpecifier, projectName, 'build');
+    // Get the application builder options.
+    const browserBuilderName = await context.getBuilderNameForTarget(buildTarget);
+    const rawBuildOptions = await context.getTargetOptions(buildTarget);
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const buildOptions = (await context.validateOptions(rawBuildOptions, browserBuilderName));
+    const optimization = (0, normalize_optimization_1.normalizeOptimization)(buildOptions.optimization);
+    if (options.prebundle !== false && isEsbuildBased(browserBuilderName)) {
+        if (!cacheOptions.enabled) {
+            // Warn if the initial options provided by the user enable prebundling but caching is disabled
+            logger.warn('Prebundling has been configured but will not be used because caching has been disabled.');
+        }
+        else if (optimization.scripts) {
+            // Warn if the initial options provided by the user enable prebundling but script optimization is enabled.
+            logger.warn('Prebundling has been configured but will not be used because scripts optimization is enabled.');
+        }
+    }
+    let inspect = false;
+    const inspectRaw = options.inspect;
+    if (inspectRaw === true || inspectRaw === '' || inspectRaw === 'true') {
+        inspect = {
+            host: undefined,
+            port: undefined,
+        };
+    }
+    else if (typeof inspectRaw === 'string' && inspectRaw !== 'false') {
+        const port = +inspectRaw;
+        if (isFinite(port)) {
+            inspect = {
+                host: undefined,
+                port,
+            };
+        }
+        else {
+            const [host, port] = inspectRaw.split(':');
+            inspect = {
+                host,
+                port: isNaN(+port) ? undefined : +port,
+            };
+        }
+    }
+    // Initial options to keep
+    const { host, port, poll, open, verbose, watch, allowedHosts, disableHostCheck, liveReload, hmr, headers, proxyConfig, servePath, publicHost, ssl, sslCert, sslKey, forceEsbuild, prebundle, } = options;
+    // Return all the normalized options
+    return {
+        buildTarget,
+        host: host ?? 'localhost',
+        port: port ?? 4200,
+        poll,
+        open,
+        verbose,
+        watch,
+        liveReload: !!liveReload,
+        hmr,
+        headers,
+        workspaceRoot,
+        projectRoot,
+        cacheOptions,
+        allowedHosts,
+        disableHostCheck,
+        proxyConfig,
+        servePath,
+        publicHost,
+        ssl,
+        sslCert,
+        sslKey,
+        forceEsbuild,
+        // Prebundling defaults to true but requires caching to function
+        prebundle: cacheOptions.enabled && !optimization.scripts && (prebundle ?? true),
+        inspect,
+    };
+}
+//# sourceMappingURL=options.js.map

package/src/builders/dev-server/options.js.map

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

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

@@ -0,0 +1,118 @@
+/**
+ * Dev Server target options for Build Facade.
+ */
+export type Schema = {
+    /**
+     * List of hosts that are allowed to access the dev server.
+     */
+    allowedHosts?: string[];
+    /**
+     * A build builder target to serve in the format of `project:target[:configuration]`. You
+     * can also pass in more than one configuration name as a comma-separated list. Example:
+     * `project:target:production,staging`.
+     */
+    buildTarget: string;
+    /**
+     * Don't verify connected clients are part of allowed hosts.
+     */
+    disableHostCheck?: boolean;
+    /**
+     * Force the development server to use the 'browser-esbuild' builder when building.
+     */
+    forceEsbuild?: boolean;
+    /**
+     * Custom HTTP headers to be added to all responses.
+     */
+    headers?: {
+        [key: string]: string;
+    };
+    /**
+     * Enable hot module replacement.
+     */
+    hmr?: boolean;
+    /**
+     * Host to listen on.
+     */
+    host?: string;
+    /**
+     * Activate debugging inspector. This option only has an effect when 'SSR' or 'SSG' are
+     * enabled.
+     */
+    inspect?: Inspect;
+    /**
+     * Whether to reload the page on change, using live-reload.
+     */
+    liveReload?: boolean;
+    /**
+     * Opens the url in default browser.
+     */
+    open?: boolean;
+    /**
+     * Enable and define the file watching poll time period in milliseconds.
+     */
+    poll?: number;
+    /**
+     * Port to listen on.
+     */
+    port?: number;
+    /**
+     * Enable and control the Vite-based development server's prebundling capabilities. To
+     * enable prebundling, the Angular CLI cache must also be enabled. This option has no effect
+     * when using the 'browser' or other Webpack-based builders.
+     */
+    prebundle?: PrebundleUnion;
+    /**
+     * Proxy configuration file. For more information, see
+     * https://angular.dev/tools/cli/serve#proxying-to-a-backend-server.
+     */
+    proxyConfig?: string;
+    /**
+     * The URL that the browser client (or live-reload client, if enabled) should use to connect
+     * to the development server. Use for a complex dev server setup, such as one with reverse
+     * proxies. This option has no effect when using the 'application' or other esbuild-based
+     * builders.
+     */
+    publicHost?: string;
+    /**
+     * The pathname where the application will be served.
+     */
+    servePath?: string;
+    /**
+     * Serve using HTTPS.
+     */
+    ssl?: boolean;
+    /**
+     * SSL certificate to use for serving HTTPS.
+     */
+    sslCert?: string;
+    /**
+     * SSL key to use for serving HTTPS.
+     */
+    sslKey?: string;
+    /**
+     * Adds more details to output logging.
+     */
+    verbose?: boolean;
+    /**
+     * Rebuild on change.
+     */
+    watch?: boolean;
+};
+/**
+ * Activate debugging inspector. This option only has an effect when 'SSR' or 'SSG' are
+ * enabled.
+ */
+export type Inspect = boolean | string;
+/**
+ * Enable and control the Vite-based development server's prebundling capabilities. To
+ * enable prebundling, the Angular CLI cache must also be enabled. This option has no effect
+ * when using the 'browser' or other Webpack-based builders.
+ */
+export type PrebundleUnion = boolean | PrebundleClass;
+export type PrebundleClass = {
+    /**
+     * List of package imports that should not be prebundled by the development server. The
+     * packages will be bundled into the application code itself.
+     */
+    exclude: string[];
+};

package/src/builders/dev-server/schema.js

@@ -0,0 +1,5 @@
+"use strict";
+// THIS FILE IS AUTOMATICALLY GENERATED. TO UPDATE THIS FILE YOU NEED TO CHANGE THE
+// CORRESPONDING JSON SCHEMA FILE, THEN RUN devkit-admin build (or bazel build ...).
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=schema.js.map

package/src/builders/dev-server/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["schema.ts"],"names":[],"mappings":";AACA,mFAAmF;AACnF,oFAAoF"}

package/src/builders/dev-server/schema.json

@@ -0,0 +1,135 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema",
+  "title": "Dev Server Target",
+  "description": "Dev Server target options for Build Facade.",
+  "type": "object",
+  "properties": {
+    "buildTarget": {
+      "type": "string",
+      "description": "A build builder target to serve in the format of `project:target[:configuration]`. You can also pass in more than one configuration name as a comma-separated list. Example: `project:target:production,staging`.",
+      "pattern": "^[^:\\s]*:[^:\\s]*(:[^\\s]+)?$"
+    },
+    "port": {
+      "type": "number",
+      "description": "Port to listen on.",
+      "default": 4200
+    },
+    "host": {
+      "type": "string",
+      "description": "Host to listen on.",
+      "default": "localhost"
+    },
+    "proxyConfig": {
+      "type": "string",
+      "description": "Proxy configuration file. For more information, see https://angular.dev/tools/cli/serve#proxying-to-a-backend-server."
+    },
+    "ssl": {
+      "type": "boolean",
+      "description": "Serve using HTTPS.",
+      "default": false
+    },
+    "sslKey": {
+      "type": "string",
+      "description": "SSL key to use for serving HTTPS."
+    },
+    "sslCert": {
+      "type": "string",
+      "description": "SSL certificate to use for serving HTTPS."
+    },
+    "headers": {
+      "type": "object",
+      "description": "Custom HTTP headers to be added to all responses.",
+      "propertyNames": {
+        "pattern": "^[-_A-Za-z0-9]+$"
+      },
+      "additionalProperties": {
+        "type": "string"
+      }
+    },
+    "open": {
+      "type": "boolean",
+      "description": "Opens the url in default browser.",
+      "default": false,
+      "alias": "o"
+    },
+    "verbose": {
+      "type": "boolean",
+      "description": "Adds more details to output logging."
+    },
+    "liveReload": {
+      "type": "boolean",
+      "description": "Whether to reload the page on change, using live-reload.",
+      "default": true
+    },
+    "publicHost": {
+      "type": "string",
+      "description": "The URL that the browser client (or live-reload client, if enabled) should use to connect to the development server. Use for a complex dev server setup, such as one with reverse proxies. This option has no effect when using the 'application' or other esbuild-based builders."
+    },
+    "allowedHosts": {
+      "type": "array",
+      "description": "List of hosts that are allowed to access the dev server.",
+      "default": [],
+      "items": {
+        "type": "string"
+      }
+    },
+    "servePath": {
+      "type": "string",
+      "description": "The pathname where the application will be served."
+    },
+    "disableHostCheck": {
+      "type": "boolean",
+      "description": "Don't verify connected clients are part of allowed hosts.",
+      "default": false
+    },
+    "hmr": {
+      "type": "boolean",
+      "description": "Enable hot module replacement."
+    },
+    "watch": {
+      "type": "boolean",
+      "description": "Rebuild on change.",
+      "default": true
+    },
+    "poll": {
+      "type": "number",
+      "description": "Enable and define the file watching poll time period in milliseconds."
+    },
+    "inspect": {
+      "default": false,
+      "description": "Activate debugging inspector. This option only has an effect when 'SSR' or 'SSG' are enabled.",
+      "oneOf": [
+        {
+          "type": "string",
+          "description": "Activate the inspector on host and port in the format of `[[host:]port]`. See the security warning in https://nodejs.org/docs/latest-v22.x/api/cli.html#warning-binding-inspector-to-a-public-ipport-combination-is-insecure regarding the host parameter usage."
+        },
+        { "type": "boolean" }
+      ]
+    },
+    "forceEsbuild": {
+      "type": "boolean",
+      "description": "Force the development server to use the 'browser-esbuild' builder when building.",
+      "default": false
+    },
+    "prebundle": {
+      "description": "Enable and control the Vite-based development server's prebundling capabilities. To enable prebundling, the Angular CLI cache must also be enabled. This option has no effect when using the 'browser' or other Webpack-based builders.",
+      "oneOf": [
+        { "type": "boolean" },
+        {
+          "type": "object",
+          "properties": {
+            "exclude": {
+              "description": "List of package imports that should not be prebundled by the development server. The packages will be bundled into the application code itself.",
+              "type": "array",
+              "items": { "type": "string" }
+            }
+          },
+          "additionalProperties": false,
+          "required": ["exclude"]
+        }
+      ]
+    }
+  },
+  "additionalProperties": false,
+  "required": ["buildTarget"]
+}