3663f80 refactor(@angular/build): extract headless configuration logic into helper function

Author: Angular Builds

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular/build",
-  "version": "22.0.0-next.3+sha-8dd341e",
+  "version": "22.0.0-next.3+sha-3663f80",
   "description": "Official build system for Angular",
   "keywords": [
     "Angular CLI",
@@ -23,7 +23,7 @@
   "builders": "builders.json",
   "dependencies": {
     "@ampproject/remapping": "2.3.0",
-    "@angular-devkit/architect": "github:angular/angular-devkit-architect-builds#8dd341e",
+    "@angular-devkit/architect": "github:angular/angular-devkit-architect-builds#3663f80",
     "@babel/core": "7.29.0",
     "@babel/helper-annotate-as-pure": "7.27.3",
     "@babel/helper-split-export-declaration": "7.24.7",
@@ -60,7 +60,7 @@
     "@angular/platform-browser": "^22.0.0-next.0",
     "@angular/platform-server": "^22.0.0-next.0",
     "@angular/service-worker": "^22.0.0-next.0",
-    "@angular/ssr": "github:angular/angular-ssr-builds#8dd341e",
+    "@angular/ssr": "github:angular/angular-ssr-builds#3663f80",
     "karma": "^6.4.0",
     "less": "^4.2.0",
     "ng-packagr": "^22.0.0-next.0",

src/builders/unit-test/runners/vitest/browser-provider.d.ts

@@ -5,7 +5,7 @@
  * 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 { BrowserConfigOptions } from 'vitest/node';
+import type { BrowserBuiltinProvider, BrowserConfigOptions, BrowserProviderOption } from 'vitest/node';
 export interface BrowserConfiguration {
     browser?: BrowserConfigOptions;
     errors?: string[];
@@ -14,8 +14,31 @@ export interface BrowserConfiguration {
 export interface BrowserInstanceConfiguration {
     browser: string;
     headless: boolean;
-    provider?: import('vitest/node').BrowserProviderOption;
+    provider?: BrowserProviderOption;
 }
+/**
+ * Mutates the provided browser instances to apply standard headless execution
+ * constraints based on the chosen provider, user options, and CI environment presence.
+ *
+ * @param instances The normalized browser instances to mutate.
+ * @param providerName The identifier for the chosen Vitest browser provider.
+ * @param headless The user-provided headless configuration option.
+ * @param isCI Whether the current environment is running in CI.
+ * @returns An array of informational messages generated during evaluation.
+ */
+export declare function applyHeadlessConfiguration(instances: BrowserInstanceConfiguration[], providerName: BrowserBuiltinProvider | undefined, headless: boolean | undefined, isCI: boolean): string[];
+/**
+ * Resolves and configures the Vitest browser provider for the unit test builder.
+ * Dynamically discovers and imports the necessary provider (Playwright, WebdriverIO, or Preview),
+ * maps the requested browser instances, and applies environment-specific execution logic.
+ *
+ * @param browsers An array of requested browser names (e.g., 'chrome', 'firefox').
+ * @param headless User-provided configuration for headless execution.
+ * @param debug Whether the builder is running in watch or debug mode.
+ * @param projectSourceRoot The root directory of the project being tested for resolving installed packages.
+ * @param viewport Optional viewport dimensions to apply to the launched browser instances.
+ * @returns A fully resolved Vitest browser configuration object alongside any generated warning or error messages.
+ */
 export declare function setupBrowserConfiguration(browsers: string[] | undefined, headless: boolean | undefined, debug: boolean, projectSourceRoot: string, viewport: {
     width: number;
     height: number;

src/builders/unit-test/runners/vitest/browser-provider.js

@@ -1 +1 @@
-Mon Mar 30 2026 19:12:38 GMT+0000 (Coordinated Universal Time)
+Tue Mar 31 2026 07:18:10 GMT+0000 (Coordinated Universal Time)