@depup/angular__build 21.2.2-depup.0

package/src/builders/unit-test/runners/api.d.ts

@@ -0,0 +1,65 @@
+/**
+ * @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, BuilderOutput } from '@angular-devkit/architect';
+import type { ApplicationBuilderInternalOptions } from '../../application/options';
+import type { FullResult, IncrementalResult } from '../../application/results';
+import type { NormalizedUnitTestBuilderOptions } from '../options';
+/**
+ * Represents the options for a test runner.
+ */
+export interface RunnerOptions {
+    /**
+     * Partial options for the application builder.
+     * These will be merged with the options from the build target.
+     */
+    buildOptions: Partial<ApplicationBuilderInternalOptions>;
+    /**
+     * A record of virtual files to be added to the build.
+     * The key is the file path and the value is the file content.
+     */
+    virtualFiles?: Record<string, string>;
+    /**
+     * A map of test entry points to their corresponding test files.
+     * This is used to avoid re-discovering the test files in the executor.
+     */
+    testEntryPointMappings?: Map<string, string>;
+}
+/**
+ * Represents a stateful test execution session.
+ * An instance of this is created for each `ng test` command.
+ */
+export interface TestExecutor {
+    /**
+     * Executes tests using the artifacts from a specific build.
+     * This method can be called multiple times in watch mode.
+     *
+     * @param buildResult The output from the application builder.
+     * @returns An async iterable builder output stream.
+     */
+    execute(buildResult: FullResult | IncrementalResult): AsyncIterable<BuilderOutput>;
+    [Symbol.asyncDispose](): Promise<void>;
+}
+/**
+ * Represents the metadata and hooks for a specific test runner.
+ */
+export interface TestRunner {
+    readonly name: string;
+    readonly isStandalone?: boolean;
+    validateDependencies?(options: NormalizedUnitTestBuilderOptions): void | Promise<void>;
+    getBuildOptions(options: NormalizedUnitTestBuilderOptions, baseBuildOptions: Partial<ApplicationBuilderInternalOptions>): RunnerOptions | Promise<RunnerOptions>;
+    /**
+     * Creates a stateful executor for a test session.
+     * This is called once at the start of the `ng test` command.
+     *
+     * @param context The Architect builder context.
+     * @param options The normalized unit test options.
+     * @param testEntryPointMappings A map of test entry points to their corresponding test files.
+     * @returns A TestExecutor instance that will handle the test runs.
+     */
+    createExecutor(context: BuilderContext, options: NormalizedUnitTestBuilderOptions, testEntryPointMappings: Map<string, string> | undefined): Promise<TestExecutor>;
+}

package/src/builders/unit-test/runners/api.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=api.js.map

package/src/builders/unit-test/runners/api.js.map

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

package/src/builders/unit-test/runners/dependency-checker.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @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
+ */
+/**
+ * A custom error class to represent missing dependency errors.
+ * This is used to avoid printing a stack trace for this expected error.
+ */
+export declare class MissingDependenciesError extends Error {
+    constructor(message: string);
+}
+export declare class DependencyChecker {
+    private readonly resolver;
+    private readonly missingDependencies;
+    constructor(projectSourceRoot: string);
+    /**
+     * Checks if a package is installed.
+     * @param packageName The name of the package to check.
+     * @returns True if the package is found, false otherwise.
+     */
+    private isInstalled;
+    /**
+     * Verifies that a package is installed and adds it to a list of missing
+     * dependencies if it is not.
+     * @param packageName The name of the package to check.
+     */
+    check(packageName: string): void;
+    /**
+     * Verifies that at least one of a list of packages is installed. If none are
+     * installed, a custom error message is added to the list of errors.
+     * @param packageNames An array of package names to check.
+     * @param customErrorMessage The error message to use if none of the packages are found.
+     */
+    checkAny(packageNames: string[], customErrorMessage: string): void;
+    /**
+     * Throws a `MissingDependenciesError` if any dependencies were found to be missing.
+     * The error message is a formatted list of all missing packages.
+     */
+    report(): void;
+}

package/src/builders/unit-test/runners/dependency-checker.js

@@ -0,0 +1,83 @@
+"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.DependencyChecker = exports.MissingDependenciesError = void 0;
+const node_module_1 = require("node:module");
+/**
+ * A custom error class to represent missing dependency errors.
+ * This is used to avoid printing a stack trace for this expected error.
+ */
+class MissingDependenciesError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'MissingDependenciesError';
+    }
+}
+exports.MissingDependenciesError = MissingDependenciesError;
+class DependencyChecker {
+    resolver;
+    missingDependencies = new Set();
+    constructor(projectSourceRoot) {
+        this.resolver = (0, node_module_1.createRequire)(projectSourceRoot + '/').resolve;
+    }
+    /**
+     * Checks if a package is installed.
+     * @param packageName The name of the package to check.
+     * @returns True if the package is found, false otherwise.
+     */
+    isInstalled(packageName) {
+        try {
+            this.resolver(packageName);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Verifies that a package is installed and adds it to a list of missing
+     * dependencies if it is not.
+     * @param packageName The name of the package to check.
+     */
+    check(packageName) {
+        if (!this.isInstalled(packageName)) {
+            this.missingDependencies.add(packageName);
+        }
+    }
+    /**
+     * Verifies that at least one of a list of packages is installed. If none are
+     * installed, a custom error message is added to the list of errors.
+     * @param packageNames An array of package names to check.
+     * @param customErrorMessage The error message to use if none of the packages are found.
+     */
+    checkAny(packageNames, customErrorMessage) {
+        if (packageNames.every((name) => !this.isInstalled(name))) {
+            // This is a custom error, so we add it directly.
+            // Using a Set avoids duplicate custom messages.
+            this.missingDependencies.add(customErrorMessage);
+        }
+    }
+    /**
+     * Throws a `MissingDependenciesError` if any dependencies were found to be missing.
+     * The error message is a formatted list of all missing packages.
+     */
+    report() {
+        if (this.missingDependencies.size === 0) {
+            return;
+        }
+        let message = 'The following packages are required but were not found:\n';
+        for (const name of this.missingDependencies) {
+            message += `  - ${name}\n`;
+        }
+        message += 'Please install the missing packages and rerun the test command.';
+        throw new MissingDependenciesError(message);
+    }
+}
+exports.DependencyChecker = DependencyChecker;
+//# sourceMappingURL=dependency-checker.js.map

package/src/builders/unit-test/runners/dependency-checker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-checker.js","sourceRoot":"","sources":["dependency-checker.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,6CAA4C;AAE5C;;;GAGG;AACH,MAAa,wBAAyB,SAAQ,KAAK;IACjD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF;AALD,4DAKC;AAID,MAAa,iBAAiB;IACX,QAAQ,CAAW;IACnB,mBAAmB,GAAG,IAAI,GAAG,EAAU,CAAC;IAEzD,YAAY,iBAAyB;QACnC,IAAI,CAAC,QAAQ,GAAG,IAAA,2BAAa,EAAC,iBAAiB,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC;IACjE,CAAC;IAED;;;;OAIG;IACK,WAAW,CAAC,WAAmB;QACrC,IAAI,CAAC;YACH,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;YAE3B,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,WAAmB;QACvB,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE,CAAC;YACnC,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAC,YAAsB,EAAE,kBAA0B;QACzD,IAAI,YAAY,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YAC1D,iDAAiD;YACjD,gDAAgD;YAChD,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,MAAM;QACJ,IAAI,IAAI,CAAC,mBAAmB,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YACxC,OAAO;QACT,CAAC;QAED,IAAI,OAAO,GAAG,2DAA2D,CAAC;QAC1E,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC5C,OAAO,IAAI,OAAO,IAAI,IAAI,CAAC;QAC7B,CAAC;QACD,OAAO,IAAI,iEAAiE,CAAC;QAE7E,MAAM,IAAI,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAC9C,CAAC;CACF;AAjED,8CAiEC"}

package/src/builders/unit-test/runners/karma/executor.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @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, BuilderOutput } from '@angular-devkit/architect';
+import { type NormalizedUnitTestBuilderOptions } from '../../options';
+import type { TestExecutor } from '../api';
+export declare class KarmaExecutor implements TestExecutor {
+    private context;
+    private options;
+    constructor(context: BuilderContext, options: NormalizedUnitTestBuilderOptions);
+    execute(): AsyncIterable<BuilderOutput>;
+    [Symbol.asyncDispose](): Promise<void>;
+}

package/src/builders/unit-test/runners/karma/executor.js

@@ -0,0 +1,164 @@
+"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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KarmaExecutor = void 0;
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_path_1 = __importDefault(require("node:path"));
+const options_1 = require("../../options");
+class KarmaExecutor {
+    context;
+    options;
+    constructor(context, options) {
+        this.context = context;
+        this.options = options;
+    }
+    async *execute() {
+        const { context, options: unitTestOptions } = this;
+        if (unitTestOptions.browserViewport) {
+            context.logger.warn('The "karma" test runner does not support the "browserViewport" option. The option will be ignored.');
+        }
+        if (unitTestOptions.debug) {
+            context.logger.warn('The "karma" test runner does not support the "debug" option. The option will be ignored.');
+        }
+        if (unitTestOptions.setupFiles.length) {
+            context.logger.warn('The "karma" test runner does not support the "setupFiles" option. The option will be ignored.');
+        }
+        if (unitTestOptions.coverage?.include) {
+            context.logger.warn('The "karma" test runner does not support the "coverageInclude" option. The option will be ignored.');
+        }
+        if (unitTestOptions.headless !== undefined) {
+            context.logger.warn('The "karma" test runner does not support the "headless" option. The option will be ignored.');
+        }
+        const buildTargetOptions = (await context.validateOptions(await context.getTargetOptions(unitTestOptions.buildTarget), await context.getBuilderNameForTarget(unitTestOptions.buildTarget)));
+        let karmaConfig;
+        if (typeof unitTestOptions.runnerConfig === 'string') {
+            karmaConfig = unitTestOptions.runnerConfig;
+            context.logger.info(`Using Karma configuration file: ${karmaConfig}`);
+        }
+        else if (unitTestOptions.runnerConfig) {
+            const potentialPath = node_path_1.default.join(unitTestOptions.projectRoot, 'karma.conf.js');
+            try {
+                await promises_1.default.access(potentialPath);
+                karmaConfig = potentialPath;
+                context.logger.info(`Using Karma configuration file: ${karmaConfig}`);
+            }
+            catch {
+                context.logger.info('No Karma configuration file found. Using default configuration.');
+            }
+        }
+        const karmaOptions = {
+            karmaConfig,
+            tsConfig: unitTestOptions.tsConfig ?? buildTargetOptions.tsConfig,
+            polyfills: (0, options_1.injectTestingPolyfills)(buildTargetOptions.polyfills),
+            assets: buildTargetOptions.assets,
+            scripts: buildTargetOptions.scripts,
+            styles: buildTargetOptions.styles,
+            inlineStyleLanguage: buildTargetOptions.inlineStyleLanguage,
+            stylePreprocessorOptions: buildTargetOptions.stylePreprocessorOptions,
+            externalDependencies: buildTargetOptions.externalDependencies,
+            loader: buildTargetOptions.loader,
+            define: buildTargetOptions.define,
+            include: unitTestOptions.include,
+            exclude: unitTestOptions.exclude,
+            sourceMap: buildTargetOptions.sourceMap,
+            progress: unitTestOptions.buildProgress ?? buildTargetOptions.progress,
+            watch: unitTestOptions.watch,
+            poll: buildTargetOptions.poll,
+            preserveSymlinks: buildTargetOptions.preserveSymlinks,
+            browsers: unitTestOptions.browsers?.join(','),
+            codeCoverage: unitTestOptions.coverage.enabled,
+            codeCoverageExclude: unitTestOptions.coverage.exclude,
+            fileReplacements: buildTargetOptions.fileReplacements,
+            reporters: unitTestOptions.reporters?.map((reporter) => {
+                // Karma only supports string reporters.
+                if (Object.keys(reporter[1]).length > 0) {
+                    context.logger.warn(`The "karma" test runner does not support options for the "${reporter[0]}" reporter. The options will be ignored.`);
+                }
+                return reporter[0];
+            }),
+            webWorkerTsConfig: buildTargetOptions.webWorkerTsConfig,
+            aot: buildTargetOptions.aot,
+        };
+        const transformOptions = {
+            karmaOptions: (options) => {
+                if (unitTestOptions.filter) {
+                    let filter = unitTestOptions.filter;
+                    if (filter[0] === '/' && filter.at(-1) === '/') {
+                        this.context.logger.warn('The `--filter` option is always a regular expression.' +
+                            'Leading and trailing `/` are not required and will be ignored.');
+                    }
+                    else {
+                        filter = `/${filter}/`;
+                    }
+                    options.client ??= {};
+                    options.client.args ??= [];
+                    options.client.args.push('--grep', filter);
+                }
+                // Add coverage options
+                if (unitTestOptions.coverage.enabled) {
+                    const { thresholds, watermarks } = unitTestOptions.coverage;
+                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                    const coverageReporter = (options.coverageReporter ??= {});
+                    if (thresholds) {
+                        coverageReporter.check = thresholds.perFile
+                            ? { each: thresholds }
+                            : { global: thresholds };
+                    }
+                    if (watermarks) {
+                        coverageReporter.watermarks = watermarks;
+                    }
+                }
+                return options;
+            },
+        };
+        const { execute } = await Promise.resolve().then(() => __importStar(require('../../../karma')));
+        yield* execute(karmaOptions, context, transformOptions);
+    }
+    async [Symbol.asyncDispose]() {
+        // The Karma builder handles its own teardown
+    }
+}
+exports.KarmaExecutor = KarmaExecutor;
+//# sourceMappingURL=executor.js.map

package/src/builders/unit-test/runners/karma/executor.js.map

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

package/src/builders/unit-test/runners/karma/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @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 { TestRunner } from '../api';
+/**
+ * A declarative definition of the Karma test runner.
+ */
+declare const KarmaTestRunner: TestRunner;
+export default KarmaTestRunner;

package/src/builders/unit-test/runners/karma/index.js

@@ -0,0 +1,44 @@
+"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 });
+const dependency_checker_1 = require("../dependency-checker");
+const executor_1 = require("./executor");
+/**
+ * A declarative definition of the Karma test runner.
+ */
+const KarmaTestRunner = {
+    name: 'karma',
+    isStandalone: true,
+    validateDependencies(options) {
+        const checker = new dependency_checker_1.DependencyChecker(options.projectSourceRoot);
+        checker.check('karma');
+        checker.check('karma-jasmine');
+        // Check for browser launchers
+        if (options.browsers?.length) {
+            for (const browser of options.browsers) {
+                const launcherName = `karma-${browser.toLowerCase().split('headless')[0]}-launcher`;
+                checker.check(launcherName);
+            }
+        }
+        if (options.coverage) {
+            checker.check('karma-coverage');
+        }
+        checker.report();
+    },
+    getBuildOptions() {
+        return {
+            buildOptions: {},
+        };
+    },
+    async createExecutor(context, options) {
+        return new executor_1.KarmaExecutor(context, options);
+    },
+};
+exports.default = KarmaTestRunner;
+//# sourceMappingURL=index.js.map

package/src/builders/unit-test/runners/karma/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAGH,8DAA0D;AAC1D,yCAA2C;AAE3C;;GAEG;AACH,MAAM,eAAe,GAAe;IAClC,IAAI,EAAE,OAAO;IACb,YAAY,EAAE,IAAI;IAElB,oBAAoB,CAAC,OAAO;QAC1B,MAAM,OAAO,GAAG,IAAI,sCAAiB,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;QACjE,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACvB,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QAE/B,8BAA8B;QAC9B,IAAI,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;YAC7B,KAAK,MAAM,OAAO,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;gBACvC,MAAM,YAAY,GAAG,SAAS,OAAO,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;gBACpF,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;QAED,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrB,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QAClC,CAAC;QAED,OAAO,CAAC,MAAM,EAAE,CAAC;IACnB,CAAC;IAED,eAAe;QACb,OAAO;YACL,YAAY,EAAE,EAAE;SACjB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO;QACnC,OAAO,IAAI,wBAAa,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;CACF,CAAC;AAEF,kBAAe,eAAe,CAAC"}

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

@@ -0,0 +1,17 @@
+/**
+ * @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 { BrowserConfigOptions } from 'vitest/node';
+export interface BrowserConfiguration {
+    browser?: BrowserConfigOptions;
+    errors?: string[];
+    messages?: string[];
+}
+export declare function setupBrowserConfiguration(browsers: string[] | undefined, headless: boolean | undefined, debug: boolean, projectSourceRoot: string, viewport: {
+    width: number;
+    height: number;
+} | undefined): Promise<BrowserConfiguration>;

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

@@ -0,0 +1,174 @@
+"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.setupBrowserConfiguration = setupBrowserConfiguration;
+const node_module_1 = require("node:module");
+const error_1 = require("../../../../utils/error");
+function findBrowserProvider(projectResolver) {
+    const requiresPreview = !!process.versions.webcontainer;
+    // One of these must be installed in the project to use browser testing
+    const vitestBuiltinProviders = requiresPreview
+        ? ['preview']
+        : ['playwright', 'webdriverio', 'preview'];
+    for (const providerName of vitestBuiltinProviders) {
+        try {
+            projectResolver(`@vitest/browser-${providerName}`);
+            return providerName;
+        }
+        catch { }
+    }
+    return undefined;
+}
+function normalizeBrowserName(browserName) {
+    // Normalize browser names to match Vitest's expectations for headless but also supports karma's names
+    // e.g., 'ChromeHeadless' -> 'chrome', 'FirefoxHeadless' -> 'firefox'
+    // and 'Chrome' -> 'chrome', 'Firefox' -> 'firefox'.
+    const normalized = browserName.toLowerCase();
+    const headless = normalized.endsWith('headless');
+    return {
+        browser: headless ? normalized.slice(0, -8) : normalized,
+        headless: headless,
+    };
+}
+async function setupBrowserConfiguration(browsers, headless, debug, projectSourceRoot, viewport) {
+    if (browsers === undefined) {
+        if (headless !== undefined) {
+            return {
+                messages: ['The "headless" option is ignored when no browsers are configured.'],
+            };
+        }
+        return {};
+    }
+    const projectResolver = (0, node_module_1.createRequire)(projectSourceRoot + '/').resolve;
+    let errors;
+    const providerName = findBrowserProvider(projectResolver);
+    if (!providerName) {
+        errors ??= [];
+        errors.push('The "browsers" option requires either "playwright" or "webdriverio" to be installed within the project.' +
+            ' Please install one of these packages and rerun the test command.');
+    }
+    let provider;
+    if (providerName) {
+        const providerPackage = `@vitest/browser-${providerName}`;
+        try {
+            const providerModule = await Promise.resolve(`${projectResolver(providerPackage)}`).then(s => __importStar(require(s)));
+            // Validate that the imported module has the expected structure
+            const providerFactory = providerModule[providerName];
+            if (typeof providerFactory === 'function') {
+                if (providerName === 'playwright') {
+                    const executablePath = process.env['CHROME_BIN'];
+                    provider = providerFactory({
+                        launchOptions: executablePath
+                            ? {
+                                executablePath,
+                            }
+                            : undefined,
+                        contextOptions: {
+                            // Enables `prefer-color-scheme` for Vitest browser instead of `light`
+                            colorScheme: null,
+                        },
+                    });
+                }
+                else {
+                    provider = providerFactory();
+                }
+            }
+            else {
+                errors ??= [];
+                errors.push(`The "${providerPackage}" package does not have a valid browser provider export.`);
+            }
+        }
+        catch (e) {
+            (0, error_1.assertIsError)(e);
+            errors ??= [];
+            // Check for a module not found error to provide a more specific message
+            if (e.code === 'ERR_MODULE_NOT_FOUND') {
+                errors.push(`The "browsers" option with "${providerName}" requires the "${providerPackage}" package.` +
+                    ' Please install this package and rerun the test command.');
+            }
+            else {
+                // Handle other potential errors during import
+                errors.push(`An error occurred while loading the "${providerPackage}" browser provider:\n  ${e.message}`);
+            }
+        }
+    }
+    if (errors) {
+        return { errors };
+    }
+    const isCI = !!process.env['CI'];
+    const instances = browsers.map(normalizeBrowserName);
+    const messages = [];
+    if (providerName === 'preview') {
+        instances.forEach((instance) => {
+            // Preview mode only supports headed execution
+            instance.headless = false;
+        });
+        if (headless) {
+            messages.push('The "headless" option is ignored when using the "preview" provider.');
+        }
+    }
+    else if (headless !== undefined) {
+        if (headless) {
+            const allHeadlessByDefault = isCI || instances.every((i) => i.headless);
+            if (allHeadlessByDefault) {
+                messages.push('The "headless" option is unnecessary as all browsers are already configured to run in headless mode.');
+            }
+        }
+        instances.forEach((instance) => {
+            instance.headless = headless;
+        });
+    }
+    else if (isCI) {
+        instances.forEach((instance) => {
+            instance.headless = true;
+        });
+    }
+    const browser = {
+        enabled: true,
+        provider,
+        ui: !isCI && instances.some((instance) => !instance.headless),
+        viewport,
+        instances,
+    };
+    return { browser, messages };
+}
+//# sourceMappingURL=browser-provider.js.map