fix(@angular/build): expose unit test and karma builder API

This commit exposes the Karma and Unit test builder API

Closes: #30644

Author: alan-agius4

packages/angular/build/src/builders/unit-test/builder.ts

@@ -24,10 +24,14 @@ import { OutputHashing } from '../application/schema';
 import { writeTestFiles } from '../karma/application_builder';
 import { findTests, getTestEntrypoints } from '../karma/find-tests';
 import { useKarmaBuilder } from './karma-bridge';
-import { NormalizedUnitTestOptions, injectTestingPolyfills, normalizeOptions } from './options';
-import type { Schema as UnitTestOptions } from './schema';
+import {
+  NormalizedUnitTestBuilderOptions,
+  injectTestingPolyfills,
+  normalizeOptions,
+} from './options';
+import type { Schema as UnitTestBuilderOptions } from './schema';
 
-export type { UnitTestOptions };
+export type { UnitTestBuilderOptions };
 
 type VitestCoverageOption = Exclude<import('vitest/node').InlineConfig['coverage'], undefined>;
 
@@ -36,7 +40,7 @@ type VitestCoverageOption = Exclude<import('vitest/node').InlineConfig['coverage
  */
 // eslint-disable-next-line max-lines-per-function
 export async function* execute(
-  options: UnitTestOptions,
+  options: UnitTestBuilderOptions,
   context: BuilderContext,
   extensions: ApplicationBuilderExtensions = {},
 ): AsyncIterable<BuilderOutput> {
@@ -383,7 +387,7 @@ function generateOutputPath(): string {
   return path.join('dist', 'test-out', `${datePrefix}-${uuidSuffix}`);
 }
 function generateCoverageOption(
-  codeCoverage: NormalizedUnitTestOptions['codeCoverage'],
+  codeCoverage: NormalizedUnitTestBuilderOptions['codeCoverage'],
   workspaceRoot: string,
   outputPath: string,
 ): VitestCoverageOption {

packages/angular/build/src/builders/unit-test/index.ts

@@ -7,10 +7,10 @@
  */
 
 import { type Builder, createBuilder } from '@angular-devkit/architect';
-import { type UnitTestOptions, execute } from './builder';
+import { type UnitTestBuilderOptions, execute } from './builder';
 
-export { type UnitTestOptions, execute };
+export { type UnitTestBuilderOptions, execute };
 
-const builder: Builder<UnitTestOptions> = createBuilder(execute);
+const builder: Builder<UnitTestBuilderOptions> = createBuilder(execute);
 
 export default builder;

packages/angular/build/src/builders/unit-test/karma-bridge.ts

@@ -9,11 +9,11 @@
 import type { BuilderContext, BuilderOutput } from '@angular-devkit/architect';
 import type { ApplicationBuilderInternalOptions } from '../application/options';
 import type { KarmaBuilderOptions } from '../karma';
-import { type NormalizedUnitTestOptions, injectTestingPolyfills } from './options';
+import { type NormalizedUnitTestBuilderOptions, injectTestingPolyfills } from './options';
 
 export async function useKarmaBuilder(
   context: BuilderContext,
-  unitTestOptions: NormalizedUnitTestOptions,
+  unitTestOptions: NormalizedUnitTestBuilderOptions,
 ): Promise<AsyncIterable<BuilderOutput>> {
   if (unitTestOptions.debug) {
     context.logger.warn(

packages/angular/build/src/builders/unit-test/options.ts

@@ -11,14 +11,14 @@ import path from 'node:path';
 import { normalizeCacheOptions } from '../../utils/normalize-cache';
 import { getProjectRootPaths } from '../../utils/project-metadata';
 import { isTTY } from '../../utils/tty';
-import type { Schema as UnitTestOptions } from './schema';
+import type { Schema as UnitTestBuilderOptions } from './schema';
 
-export type NormalizedUnitTestOptions = Awaited<ReturnType<typeof normalizeOptions>>;
+export type NormalizedUnitTestBuilderOptions = Awaited<ReturnType<typeof normalizeOptions>>;
 
 export async function normalizeOptions(
   context: BuilderContext,
   projectName: string,
-  options: UnitTestOptions,
+  options: UnitTestBuilderOptions,
 ) {
   // Setup base paths based on workspace root and project information
   const workspaceRoot = context.workspaceRoot;

packages/angular/build/src/index.ts

@@ -26,3 +26,9 @@ export {
   execute as executeNgPackagrBuilder,
   type NgPackagrBuilderOptions,
 } from './builders/ng-packagr';
+export {
+  execute as executeUnitTestBuilder,
+  type UnitTestBuilderOptions,
+} from './builders/unit-test';
+
+export { execute as executeKarmaBuilder, type KarmaBuilderOptions } from './builders/karma';