@depup/angular__build 21.2.2-depup.0

package/src/builders/application/setup-bundling.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @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 { AngularCompilation } from '../../tools/angular/compilation';
+import { ComponentStylesheetBundler } from '../../tools/esbuild/angular/component-stylesheets';
+import { SourceFileCache } from '../../tools/esbuild/angular/source-file-cache';
+import { BundlerContext } from '../../tools/esbuild/bundler-context';
+import { NormalizedApplicationBuildOptions } from './options';
+/**
+ * Generates one or more BundlerContext instances based on the builder provided
+ * configuration.
+ * @param options The normalized application builder options to use.
+ * @param browsers An string array of browserslist browsers to support.
+ * @param codeBundleCache An instance of the TypeScript source file cache.
+ * @returns An array of BundlerContext objects.
+ */
+export declare function setupBundlerContexts(options: NormalizedApplicationBuildOptions, target: string[], codeBundleCache: SourceFileCache, stylesheetBundler: ComponentStylesheetBundler, angularCompilation: AngularCompilation, templateUpdates: Map<string, string> | undefined): {
+    typescriptContexts: BundlerContext[];
+    otherContexts: BundlerContext[];
+};
+export declare function createComponentStyleBundler(options: NormalizedApplicationBuildOptions, target: string[]): ComponentStylesheetBundler;

package/src/builders/application/setup-bundling.js

@@ -0,0 +1,104 @@
+"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.setupBundlerContexts = setupBundlerContexts;
+exports.createComponentStyleBundler = createComponentStyleBundler;
+const component_stylesheets_1 = require("../../tools/esbuild/angular/component-stylesheets");
+const application_code_bundle_1 = require("../../tools/esbuild/application-code-bundle");
+const bundler_context_1 = require("../../tools/esbuild/bundler-context");
+const global_scripts_1 = require("../../tools/esbuild/global-scripts");
+const global_styles_1 = require("../../tools/esbuild/global-styles");
+const utils_1 = require("../../tools/esbuild/utils");
+/**
+ * Generates one or more BundlerContext instances based on the builder provided
+ * configuration.
+ * @param options The normalized application builder options to use.
+ * @param browsers An string array of browserslist browsers to support.
+ * @param codeBundleCache An instance of the TypeScript source file cache.
+ * @returns An array of BundlerContext objects.
+ */
+function setupBundlerContexts(options, target, codeBundleCache, stylesheetBundler, angularCompilation, templateUpdates) {
+    const { outputMode, serverEntryPoint, appShellOptions, prerenderOptions, ssrOptions, workspaceRoot, watch = false, } = options;
+    const typescriptContexts = [];
+    const otherContexts = [];
+    // Browser application code
+    typescriptContexts.push(new bundler_context_1.BundlerContext(workspaceRoot, watch, (0, application_code_bundle_1.createBrowserCodeBundleOptions)(options, target, codeBundleCache, stylesheetBundler, angularCompilation, templateUpdates)));
+    // Browser polyfills code
+    const browserPolyfillBundleOptions = (0, application_code_bundle_1.createBrowserPolyfillBundleOptions)(options, target, codeBundleCache, stylesheetBundler);
+    if (browserPolyfillBundleOptions) {
+        const browserPolyfillContext = new bundler_context_1.BundlerContext(workspaceRoot, watch, browserPolyfillBundleOptions);
+        if (typeof browserPolyfillBundleOptions === 'function') {
+            otherContexts.push(browserPolyfillContext);
+        }
+        else {
+            typescriptContexts.push(browserPolyfillContext);
+        }
+    }
+    // Global Stylesheets
+    if (options.globalStyles.length > 0) {
+        for (const initial of [true, false]) {
+            const bundleOptions = (0, global_styles_1.createGlobalStylesBundleOptions)(options, target, initial);
+            if (bundleOptions) {
+                otherContexts.push(new bundler_context_1.BundlerContext(workspaceRoot, watch, bundleOptions, () => initial));
+            }
+        }
+    }
+    // Global Scripts
+    if (options.globalScripts.length > 0) {
+        for (const initial of [true, false]) {
+            const bundleOptions = (0, global_scripts_1.createGlobalScriptsBundleOptions)(options, target, initial);
+            if (bundleOptions) {
+                otherContexts.push(new bundler_context_1.BundlerContext(workspaceRoot, watch, bundleOptions, () => initial));
+            }
+        }
+    }
+    // Skip server build when none of the features are enabled.
+    if (serverEntryPoint && (outputMode || prerenderOptions || appShellOptions || ssrOptions)) {
+        const nodeTargets = [...target, ...(0, utils_1.getSupportedNodeTargets)()];
+        typescriptContexts.push(new bundler_context_1.BundlerContext(workspaceRoot, watch, (0, application_code_bundle_1.createServerMainCodeBundleOptions)(options, nodeTargets, codeBundleCache, stylesheetBundler)));
+        if (outputMode && ssrOptions?.entry) {
+            // New behavior introduced: 'server.ts' is now bundled separately from 'main.server.ts'.
+            typescriptContexts.push(new bundler_context_1.BundlerContext(workspaceRoot, watch, (0, application_code_bundle_1.createSsrEntryCodeBundleOptions)(options, nodeTargets, codeBundleCache, stylesheetBundler)));
+        }
+        // Server polyfills code
+        const serverPolyfillBundleOptions = (0, application_code_bundle_1.createServerPolyfillBundleOptions)(options, nodeTargets, codeBundleCache.loadResultCache);
+        if (serverPolyfillBundleOptions) {
+            otherContexts.push(new bundler_context_1.BundlerContext(workspaceRoot, watch, serverPolyfillBundleOptions));
+        }
+    }
+    return { typescriptContexts, otherContexts };
+}
+function createComponentStyleBundler(options, target) {
+    const { workspaceRoot, optimizationOptions, sourcemapOptions, outputNames, externalDependencies, preserveSymlinks, stylePreprocessorOptions, inlineStyleLanguage, cacheOptions, tailwindConfiguration, postcssConfiguration, publicPath, } = options;
+    const incremental = !!options.watch;
+    return new component_stylesheets_1.ComponentStylesheetBundler({
+        workspaceRoot,
+        inlineFonts: !!optimizationOptions.fonts.inline,
+        optimization: !!optimizationOptions.styles.minify,
+        sourcemap: 
+        // Hidden component stylesheet sourcemaps are inaccessible which is effectively
+        // the same as being disabled. Disabling has the advantage of avoiding the overhead
+        // of sourcemap processing.
+        sourcemapOptions.styles && !sourcemapOptions.hidden ? 'linked' : false,
+        sourcesContent: sourcemapOptions.sourcesContent,
+        outputNames,
+        includePaths: stylePreprocessorOptions?.includePaths,
+        // string[] | undefined' is not assignable to type '(Version | DeprecationOrId)[] | undefined'.
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        sass: stylePreprocessorOptions?.sass,
+        externalDependencies,
+        target,
+        preserveSymlinks,
+        tailwindConfiguration,
+        postcssConfiguration,
+        cacheOptions,
+        publicPath,
+    }, inlineStyleLanguage, incremental);
+}
+//# sourceMappingURL=setup-bundling.js.map

package/src/builders/application/setup-bundling.js.map

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

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

@@ -0,0 +1,31 @@
+/**
+ * @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 http from 'node:http';
+import { type IndexHtmlTransform } from './internal';
+import type { DevServerBuilderOutput } from './output';
+import type { Schema as DevServerBuilderOptions } from './schema';
+/**
+ * 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 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.
+ */
+export declare function execute(options: DevServerBuilderOptions, context: BuilderContext, extensions?: {
+    buildPlugins?: Plugin[];
+    middleware?: ((req: http.IncomingMessage, res: http.ServerResponse, next: (err?: unknown) => void) => void)[];
+    indexHtmlTransformer?: IndexHtmlTransform;
+}): AsyncIterable<DevServerBuilderOutput>;

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

@@ -0,0 +1,61 @@
+"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.execute = execute;
+const check_port_1 = require("../../utils/check-port");
+const internal_1 = require("./internal");
+const options_1 = require("./options");
+const vite_1 = require("./vite");
+/**
+ * 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 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.
+ */
+async function* execute(options, context, 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;
+    }
+    const { builderName, normalizedOptions } = await initialize(options, projectName, context);
+    yield* (0, vite_1.serveWithVite)(normalizedOptions, builderName, (options, context, plugins) => (0, internal_1.buildApplicationInternal)(options, context, { codePlugins: plugins }), context, { indexHtml: extensions?.indexHtmlTransformer }, extensions);
+}
+async function initialize(initialOptions, projectName, context) {
+    // Purge old build disk cache.
+    await (0, internal_1.purgeStaleBuildCache)(context);
+    const normalizedOptions = await (0, options_1.normalizeOptions)(context, projectName, initialOptions);
+    const builderName = await context.getBuilderNameForTarget(normalizedOptions.buildTarget);
+    if (!/^127\.\d+\.\d+\.\d+/g.test(normalizedOptions.host) &&
+        normalizedOptions.host !== '::1' &&
+        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.
+    `);
+    }
+    normalizedOptions.port = await (0, check_port_1.checkPort)(normalizedOptions.port, normalizedOptions.host);
+    return {
+        builderName,
+        normalizedOptions,
+    };
+}
+//# 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":";AAAA;;;;;;GAMG;;AA6BH,0BAgCC;AAxDD,uDAAmD;AACnD,yCAIoB;AACpB,uCAA6C;AAG7C,iCAAuC;AAEvC;;;;;;;;;;;;GAYG;AACI,KAAK,SAAS,CAAC,CAAC,OAAO,CAC5B,OAAgC,EAChC,OAAuB,EACvB,UAQC;IAED,qDAAqD;IACrD,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC;IAC5C,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,6DAA6D,CAAC,CAAC;QAEpF,OAAO;IACT,CAAC;IAED,MAAM,EAAE,WAAW,EAAE,iBAAiB,EAAE,GAAG,MAAM,UAAU,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;IAE3F,KAAK,CAAC,CAAC,IAAA,oBAAa,EAClB,iBAAiB,EACjB,WAAW,EACX,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,CAC5B,IAAA,mCAAwB,EAAC,OAAO,EAAE,OAAO,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,EACtE,OAAO,EACP,EAAE,SAAS,EAAE,UAAU,EAAE,oBAAoB,EAAE,EAC/C,UAAU,CACX,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,UAAU,CACvB,cAAuC,EACvC,WAAmB,EACnB,OAAuB;IAEvB,8BAA8B;IAC9B,MAAM,IAAA,+BAAoB,EAAC,OAAO,CAAC,CAAC;IAEpC,MAAM,iBAAiB,GAAG,MAAM,IAAA,0BAAgB,EAAC,OAAO,EAAE,WAAW,EAAE,cAAc,CAAC,CAAC;IACvF,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,uBAAuB,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAEzF,IACE,CAAC,sBAAsB,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC;QACpD,iBAAiB,CAAC,IAAI,KAAK,KAAK;QAChC,iBAAiB,CAAC,IAAI,KAAK,WAAW,EACtC,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC;;;;;;;KAOnB,CAAC,CAAC;IACL,CAAC;IAED,iBAAiB,CAAC,IAAI,GAAG,MAAM,IAAA,sBAAS,EAAC,iBAAiB,CAAC,IAAI,EAAE,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAEzF,OAAO;QACL,WAAW;QACX,iBAAiB;KAClB,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,15 @@
+/**
+ * @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 { Builder } from '@angular-devkit/architect';
+import { execute } from './builder';
+import type { DevServerBuilderOutput } from './output';
+import type { Schema as DevServerBuilderOptions } from './schema';
+export { type DevServerBuilderOptions, type DevServerBuilderOutput, execute as executeDevServerBuilder, };
+declare const builder: Builder<DevServerBuilderOptions>;
+export default builder;
+export { execute as executeDevServer };

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

@@ -0,0 +1,17 @@
+"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; } });
+const builder = (0, architect_1.createBuilder)(builder_1.execute);
+exports.default = builder;
+//# 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;;;AAEH,yDAAmE;AACnE,uCAAoC;AAOvB,wGAPJ,iBAAO,OAOoB;AAUhB,iGAjBX,iBAAO,OAiBoB;AARpC,MAAM,OAAO,GAAqC,IAAA,yBAAa,EAG7D,iBAAO,CAAC,CAAC;AAEX,kBAAe,OAAO,CAAC"}

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

@@ -0,0 +1,18 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+export { type BuildOutputFile, BuildOutputFileType } from '../../tools/esbuild/bundler-context';
+export { createRxjsEsmResolutionPlugin } from '../../tools/esbuild/rxjs-esm-resolution-plugin';
+export { JavaScriptTransformer } from '../../tools/esbuild/javascript-transformer';
+export { getFeatureSupport, isZonelessApp } from '../../tools/esbuild/utils';
+export { type IndexHtmlTransform } from '../../utils/index-file/index-html-generator';
+export { purgeStaleBuildCache } from '../../utils/purge-cache';
+export { getSupportedBrowsers } from '../../utils/supported-browsers';
+export { transformSupportedBrowsersToTargets } from '../../tools/esbuild/utils';
+export { buildApplicationInternal } from '../../builders/application';
+export type { ApplicationBuilderInternalOptions } from '../../builders/application/options';
+export type { ExternalResultMetadata } from '../../tools/esbuild/bundler-execution-result';

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

@@ -0,0 +1,28 @@
+"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.buildApplicationInternal = exports.transformSupportedBrowsersToTargets = exports.getSupportedBrowsers = exports.purgeStaleBuildCache = exports.isZonelessApp = exports.getFeatureSupport = exports.JavaScriptTransformer = exports.createRxjsEsmResolutionPlugin = exports.BuildOutputFileType = void 0;
+var bundler_context_1 = require("../../tools/esbuild/bundler-context");
+Object.defineProperty(exports, "BuildOutputFileType", { enumerable: true, get: function () { return bundler_context_1.BuildOutputFileType; } });
+var rxjs_esm_resolution_plugin_1 = require("../../tools/esbuild/rxjs-esm-resolution-plugin");
+Object.defineProperty(exports, "createRxjsEsmResolutionPlugin", { enumerable: true, get: function () { return rxjs_esm_resolution_plugin_1.createRxjsEsmResolutionPlugin; } });
+var javascript_transformer_1 = require("../../tools/esbuild/javascript-transformer");
+Object.defineProperty(exports, "JavaScriptTransformer", { enumerable: true, get: function () { return javascript_transformer_1.JavaScriptTransformer; } });
+var utils_1 = require("../../tools/esbuild/utils");
+Object.defineProperty(exports, "getFeatureSupport", { enumerable: true, get: function () { return utils_1.getFeatureSupport; } });
+Object.defineProperty(exports, "isZonelessApp", { enumerable: true, get: function () { return utils_1.isZonelessApp; } });
+var purge_cache_1 = require("../../utils/purge-cache");
+Object.defineProperty(exports, "purgeStaleBuildCache", { enumerable: true, get: function () { return purge_cache_1.purgeStaleBuildCache; } });
+var supported_browsers_1 = require("../../utils/supported-browsers");
+Object.defineProperty(exports, "getSupportedBrowsers", { enumerable: true, get: function () { return supported_browsers_1.getSupportedBrowsers; } });
+var utils_2 = require("../../tools/esbuild/utils");
+Object.defineProperty(exports, "transformSupportedBrowsersToTargets", { enumerable: true, get: function () { return utils_2.transformSupportedBrowsersToTargets; } });
+var application_1 = require("../../builders/application");
+Object.defineProperty(exports, "buildApplicationInternal", { enumerable: true, get: function () { return application_1.buildApplicationInternal; } });
+//# sourceMappingURL=internal.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["internal.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,uEAAgG;AAAjE,sHAAA,mBAAmB,OAAA;AAClD,6FAA+F;AAAtF,2IAAA,6BAA6B,OAAA;AACtC,qFAAmF;AAA1E,+HAAA,qBAAqB,OAAA;AAC9B,mDAA6E;AAApE,0GAAA,iBAAiB,OAAA;AAAE,sGAAA,aAAa,OAAA;AAEzC,uDAA+D;AAAtD,mHAAA,oBAAoB,OAAA;AAC7B,qEAAsE;AAA7D,0HAAA,oBAAoB,OAAA;AAC7B,mDAAgF;AAAvE,4HAAA,mCAAmC,OAAA;AAC5C,0DAAsE;AAA7D,uHAAA,wBAAwB,OAAA"}

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

@@ -0,0 +1,51 @@
+/**
+ * @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>>;
+/**
+ * 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;
+    define: {
+        [key: string]: string;
+    } | undefined;
+    watch: boolean | undefined;
+    liveReload: boolean;
+    hmr: boolean;
+    headers: {
+        [key: string]: string;
+    } | undefined;
+    workspaceRoot: string;
+    projectRoot: string;
+    cacheOptions: import("../../utils/normalize-cache").NormalizedCachedOptions;
+    proxyConfig: string | undefined;
+    servePath: string | undefined;
+    ssl: boolean | undefined;
+    sslCert: string | undefined;
+    sslKey: string | undefined;
+    prebundle: import("./schema").PrebundleUnion | undefined;
+    inspect: boolean | {
+        host?: string;
+        port?: number;
+    };
+    allowedHosts: true | string[];
+}>;

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

@@ -0,0 +1,104 @@
+"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.normalizeOptions = normalizeOptions;
+const architect_1 = require("@angular-devkit/architect");
+const node_path_1 = __importDefault(require("node:path"));
+const utils_1 = require("../../utils");
+const normalize_cache_1 = require("../../utils/normalize-cache");
+/**
+ * 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);
+    const buildOptions = (await context.validateOptions(rawBuildOptions, browserBuilderName));
+    const optimization = (0, utils_1.normalizeOptimization)(buildOptions.optimization);
+    if (options.prebundle) {
+        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, define, watch, liveReload, hmr, headers, proxyConfig, servePath, ssl, sslCert, sslKey, prebundle, allowedHosts, } = options;
+    // Return all the normalized options
+    return {
+        buildTarget,
+        host: host ?? 'localhost',
+        port: port ?? 4200,
+        poll,
+        open,
+        verbose,
+        define,
+        watch,
+        liveReload: !!liveReload,
+        hmr: hmr ?? !!liveReload,
+        headers,
+        workspaceRoot,
+        projectRoot,
+        cacheOptions,
+        proxyConfig,
+        servePath,
+        ssl,
+        sslCert,
+        sslKey,
+        // Prebundling defaults to true but requires caching to function
+        prebundle: cacheOptions.enabled && !optimization.scripts && prebundle,
+        inspect,
+        allowedHosts: allowedHosts ? allowedHosts : [],
+    };
+}
+//# 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/output.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @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 { BuilderOutput } from '@angular-devkit/architect';
+/**
+ * @experimental Direct usage of this type is considered experimental.
+ */
+export interface DevServerBuilderOutput extends BuilderOutput {
+    baseUrl: string;
+    port?: number;
+    address?: string;
+}

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

@@ -0,0 +1,10 @@
+"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 });
+//# sourceMappingURL=output.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["output.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG"}

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

@@ -0,0 +1,121 @@
+/**
+ * Dev Server target options for Build Facade.
+ */
+export type Schema = {
+    /**
+     * The hosts that the development server will respond to. This option sets the Vite option
+     * of the same name. For further details:
+     * https://vite.dev/config/server-options.html#server-allowedhosts
+     */
+    allowedHosts?: AllowedHosts;
+    /**
+     * 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;
+    /**
+     * Defines global identifiers that will be replaced with a specified constant value when
+     * found in any JavaScript or TypeScript code including libraries. The value will be used
+     * directly. String values must be put in quotes. Identifiers within Angular metadata such
+     * as Component Decorators will not be replaced.
+     */
+    define?: {
+        [key: string]: string;
+    };
+    /**
+     * Custom HTTP headers to be added to all responses.
+     */
+    headers?: {
+        [key: string]: string;
+    };
+    /**
+     * Enable hot module replacement. Defaults to the value of 'liveReload'. Currently, only
+     * global and component stylesheets are supported.
+     */
+    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.
+     */
+    prebundle?: PrebundleUnion;
+    /**
+     * Proxy configuration file. For more information, see
+     * https://angular.dev/tools/cli/serve#proxying-to-a-backend-server.
+     */
+    proxyConfig?: 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;
+};
+/**
+ * The hosts that the development server will respond to. This option sets the Vite option
+ * of the same name. For further details:
+ * https://vite.dev/config/server-options.html#server-allowedhosts
+ */
+export type AllowedHosts = string[] | 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.
+ */
+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. Note: specifying `@foo/bar`
+     * marks all paths within the `@foo/bar` package as excluded, including sub-paths like
+     * `@foo/bar/baz`.
+     */
+    exclude: string[];
+};