c74e61842 refactor(@angular-devkit/build-angular): export application builder for experimental programmatic usage

Author: Angular Builds

package.json

@@ -1,15 +1,15 @@
 {
   "name": "@angular-devkit/build-angular",
-  "version": "17.0.0-next.8+sha-3938863",
+  "version": "17.0.0-next.8+sha-c74e618",
   "description": "Angular Webpack Build Facade",
   "main": "src/index.js",
   "typings": "src/index.d.ts",
   "builders": "builders.json",
   "dependencies": {
     "@ampproject/remapping": "2.2.1",
-    "@angular-devkit/architect": "github:angular/angular-devkit-architect-builds#3938863b9",
-    "@angular-devkit/build-webpack": "github:angular/angular-devkit-build-webpack-builds#3938863b9",
-    "@angular-devkit/core": "github:angular/angular-devkit-core-builds#3938863b9",
+    "@angular-devkit/architect": "github:angular/angular-devkit-architect-builds#c74e61842",
+    "@angular-devkit/build-webpack": "github:angular/angular-devkit-build-webpack-builds#c74e61842",
+    "@angular-devkit/core": "github:angular/angular-devkit-core-builds#c74e61842",
     "@babel/core": "7.23.0",
     "@babel/generator": "7.23.0",
     "@babel/helper-annotate-as-pure": "7.22.5",
@@ -20,7 +20,7 @@
     "@babel/preset-env": "7.22.20",
     "@babel/runtime": "7.23.1",
     "@discoveryjs/json-ext": "0.5.7",
-    "@ngtools/webpack": "github:angular/ngtools-webpack-builds#3938863b9",
+    "@ngtools/webpack": "github:angular/ngtools-webpack-builds#c74e61842",
     "@vitejs/plugin-basic-ssl": "1.0.1",
     "ansi-colors": "4.1.3",
     "autoprefixer": "10.4.16",

src/builders/application/index.d.ts

@@ -6,21 +6,37 @@
  * found in the LICENSE file at https://angular.io/license
  */
 import { BuilderContext, BuilderOutput } from '@angular-devkit/architect';
+import type { Plugin } from 'esbuild';
 import { BuildOutputFile } from '../../tools/esbuild/bundler-context';
 import { ApplicationBuilderInternalOptions } from './options';
 import { Schema as ApplicationBuilderOptions } from './schema';
+export { ApplicationBuilderOptions };
 export declare function buildApplicationInternal(options: ApplicationBuilderInternalOptions, context: BuilderContext & {
     signal?: AbortSignal;
 }, infrastructureSettings?: {
     write?: boolean;
-}): AsyncIterable<BuilderOutput & {
+}, plugins?: Plugin[]): AsyncIterable<BuilderOutput & {
     outputFiles?: BuildOutputFile[];
     assetFiles?: {
         source: string;
         destination: string;
     }[];
 }>;
-export declare function buildApplication(options: ApplicationBuilderOptions, context: BuilderContext): AsyncIterable<BuilderOutput & {
+/**
+ * Builds an application using the `application` builder with the provided
+ * options.
+ *
+ * Usage of the `plugins` parameter is NOT supported and may cause unexpected
+ * build output or build failures.
+ *
+ * @experimental Direct usage of this function is considered experimental.
+ *
+ * @param options The options defined by the builder's schema to use.
+ * @param context An Architect builder context instance.
+ * @param plugins An array of plugins to apply to the main code bundling.
+ * @returns The build output results of the build.
+ */
+export declare function buildApplication(options: ApplicationBuilderOptions, context: BuilderContext, plugins?: Plugin[]): AsyncIterable<BuilderOutput & {
     outputFiles?: BuildOutputFile[];
     assetFiles?: {
         source: string;