@cldmv/vitest-runner 1.2.0 → 1.4.3

package/src/core/parse.mjs

@@ -1,167 +0,0 @@
-/**
- * @fileoverview Vitest output parsing and error deduplication utilities.
- * @module vitest-runner/src/core/parse
- */
-
-import { stripAnsi } from "../utils/ansi.mjs";
-
-/**
- * @typedef {Object} ParsedVitestResult
- * @property {number} testFilesPass - Number of test files that passed.
- * @property {number} testFilesFail - Number of test files that failed.
- * @property {number} testsPass - Number of individual tests that passed.
- * @property {number} testsFail - Number of individual tests that failed.
- * @property {number} testsSkip - Number of individual tests that were skipped.
- * @property {number} duration - Duration in milliseconds (from Vitest output).
- * @property {number|null} heapMb - Peak heap usage in MB, or `null` if not reported.
- * @property {string[]} errors - Array of raw error blocks (with ANSI codes).
- */
-
-/**
- * Parse raw Vitest stdout/stderr output into structured result data.
- *
- * Extracts test-file counts, individual test counts, duration, heap usage,
- * and error blocks.  Counts are parsed from ANSI-stripped output; error blocks
- * are captured from the original coloured output.
- *
- * @param {string} output - Combined raw stdout + stderr from a vitest child process.
- * @returns {ParsedVitestResult}
- * @example
- * const result = parseVitestOutput(rawOutput);
- * console.log(result.testsPass, result.testsFail);
- */
-export function parseVitestOutput(output) {
-	const cleanOutput = stripAnsi(output);
-
-	const result = {
-		testFilesPass: 0,
-		testFilesFail: 0,
-		testsPass: 0,
-		testsFail: 0,
-		testsSkip: 0,
-		duration: 0,
-		heapMb: null,
-		errors: []
-	};
-
-	// "Test Files  1 passed (1)" / "Test Files  1 failed | 2 passed (3)"
-	const testFilesLineMatch = cleanOutput.match(/Test Files\s+(.+)/);
-	if (testFilesLineMatch) {
-		const line = testFilesLineMatch[1];
-		const passMatch = line.match(/(\d+)\s+passed/);
-		const failMatch = line.match(/(\d+)\s+failed/);
-		if (passMatch) result.testFilesPass = parseInt(passMatch[1], 10);
-		if (failMatch) result.testFilesFail = parseInt(failMatch[1], 10);
-	}
-
-	// "Tests  82 passed (82)" / "Tests  2 failed | 4 passed (6)"
-	const testsLineMatch = cleanOutput.match(/^\s*Tests\s+(.+)$/m);
-	if (testsLineMatch) {
-		const line = testsLineMatch[1];
-		const passMatch = line.match(/(\d+)\s+passed/);
-		const failMatch = line.match(/(\d+)\s+failed/);
-		const skipMatch = line.match(/(\d+)\s+skipped/);
-		if (passMatch) result.testsPass = parseInt(passMatch[1], 10);
-		if (failMatch) result.testsFail = parseInt(failMatch[1], 10);
-		if (skipMatch) result.testsSkip = parseInt(skipMatch[1], 10);
-	}
-
-	// "Duration  Xs"
-	const durationMatch = cleanOutput.match(/Duration\s+([\d.]+)s/);
-	if (durationMatch) {
-		result.duration = parseFloat(durationMatch[1]) * 1000;
-	}
-
-	// "N MB heap used"
-	const heapMatch = cleanOutput.match(/(\d+)\s*MB\s+heap\s+used/i);
-	if (heapMatch) {
-		result.heapMb = parseInt(heapMatch[1], 10);
-	}
-
-	// Error blocks — captured from the raw (coloured) output
-	const failedSectionStart = output.indexOf("Failed Tests");
-	if (failedSectionStart !== -1) {
-		const failedSectionEnd = output.indexOf("\n Test Files", failedSectionStart);
-		const errorSection =
-			failedSectionEnd !== -1 ? output.substring(failedSectionStart, failedSectionEnd) : output.substring(failedSectionStart);
-
-		// eslint-disable-next-line no-control-regex
-		const failPattern = /FAIL\s*(?:\x1B\[[0-9;]*[a-zA-Z]|\s)*tests\//g;
-		const matches = [...errorSection.matchAll(failPattern)];
-
-		for (let i = 0; i < matches.length; i++) {
-			const matchPos = matches[i].index;
-			const lineStart = errorSection.lastIndexOf("\n", matchPos);
-			const actualStart = lineStart === -1 ? 0 : lineStart;
-
-			const matchEnd = i < matches.length - 1 ? matches[i + 1].index : errorSection.length;
-			const nextLineStart = errorSection.lastIndexOf("\n", matchEnd);
-			const actualEnd = nextLineStart === -1 ? matchEnd : nextLineStart;
-
-			const errorBlock = errorSection.substring(actualStart, actualEnd).trim();
-			if (errorBlock) result.errors.push(errorBlock);
-		}
-	}
-
-	return result;
-}
-
-/**
- * Deduplicate similar FAIL lines that differ only by their `Config:` value.
- *
- * When the same test file fails across multiple matrix configs vitest emits
- * one FAIL line per config.  This collapses them into a single line listing
- * all configs as an array, keeping output concise.
- *
- * @param {string[]} errors - Array of raw error blocks (each a complete FAIL section).
- * @returns {string} Deduplicated error text joined as a single string.
- * @example
- * const deduped = deduplicateErrors(result.errors);
- * console.log(deduped);
- */
-export function deduplicateErrors(errors) {
-	const fullText = errors.join("\n");
-	const lines = fullText.split("\n");
-
-	const failLineMap = new Map();
-	const lineIndices = new Map();
-
-	lines.forEach((line, idx) => {
-		if (line.includes("FAIL") && line.includes("Config:")) {
-			lineIndices.set(line, idx);
-
-			const cleaned = stripAnsi(line);
-			const match = cleaned.match(/^(.+Config:\s+)'*([^'>]+)'*(.+)$/);
-			if (match) {
-				const [, before, config, after] = match;
-				const pattern = `${before.trim()}|||${after.trim()}`;
-
-				if (!failLineMap.has(pattern)) {
-					failLineMap.set(pattern, { lines: [], configs: [] });
-				}
-				failLineMap.get(pattern).lines.push(line);
-				failLineMap.get(pattern).configs.push(config.replace(/'/g, ""));
-			}
-		}
-	});
-
-	const skipIndices = new Set();
-
-	for (const [, data] of failLineMap.entries()) {
-		if (data.configs.length > 1) {
-			for (let i = 1; i < data.lines.length; i++) {
-				const idx = lineIndices.get(data.lines[i]);
-				skipIndices.add(idx);
-			}
-
-			const firstLine = data.lines[0];
-			const configArray = `[${data.configs.map((c) => `'${c}'`).join(",")}]`;
-			const consolidated = stripAnsi(firstLine).replace(/(Config:\s+)'*[^'>]+'*/, `$1${configArray}`);
-
-			const firstIdx = lineIndices.get(firstLine);
-			lines[firstIdx] = consolidated;
-		}
-	}
-
-	return lines.filter((_, idx) => !skipIndices.has(idx)).join("\n");
-}

package/src/core/progress.mjs

@@ -1,164 +0,0 @@
-/**
- * @fileoverview Live progress tracker for coverage runs.
- * @module vitest-runner/src/core/progress
- */
-
-import chalk from "chalk";
-import { formatDuration } from "../utils/duration.mjs";
-
-/**
- * Create a live progress tracker that renders to stdout.
- *
- * In TTY mode a spinner + bar overwrites the current line on each update.
- * In non-TTY mode a plain-text line is printed at most once every two seconds,
- * plus once on every `onComplete` call.
- *
- * @param {number} total - Total number of files to process.
- * @returns {{ onStart: () => void, onComplete: (failedRun: boolean) => void, finish: () => void }}
- * @example
- * const progress = createCoverageProgressTracker(120);
- * progress.onStart();
- * progress.onComplete(false);
- * progress.finish();
- */
-export function createCoverageProgressTracker(total) {
-	const isTTY = Boolean(process.stdout.isTTY);
-	const spinnerFrames = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
-	const barWidth = 26;
-	const startTime = Date.now();
-	let completed = 0;
-	let active = 0;
-	let failed = 0;
-	let frameIndex = 0;
-	let maxLineLength = 0;
-	let lastPlainLog = 0;
-	let spinnerTimer = null;
-
-	/**
-	 * Build the current progress line text.
-	 * @returns {string}
-	 */
-	function buildLine() {
-		const percent = total === 0 ? 100 : (completed / total) * 100;
-		const elapsedMs = Date.now() - startTime;
-		const avgPerFile = completed > 0 ? elapsedMs / completed : 0;
-		const etaMs = avgPerFile * Math.max(total - completed, 0);
-		const filled = Math.round((percent / 100) * barWidth);
-		const spinner = spinnerFrames[frameIndex % spinnerFrames.length];
-		const bar = `[${"=".repeat(filled)}${"-".repeat(Math.max(0, barWidth - filled))}]`;
-
-		let _percent = percent.toFixed(1).padStart(5);
-		if (percent < 30) {
-			_percent = chalk.red(_percent + "%");
-		} else if (percent < 70) {
-			_percent = chalk.rgb(255, 136, 0)(_percent + "%");
-		} else if (percent > 99) {
-			_percent = chalk.green(_percent + "%");
-		} else {
-			_percent = chalk.yellow(_percent + "%");
-		}
-
-		if (isTTY) {
-			return `${chalk.green(spinner)} ${chalk.green(bar)} ${chalk.bold(_percent)} ${completed}/${total} | active ${active} | failed ${failed} | ETA ${formatDuration(etaMs)} | elapsed ${formatDuration(elapsedMs)}`;
-		}
-
-		return `progress ${percent.toFixed(1)}% ${completed}/${total} | active ${active} | failed ${failed} | eta ${formatDuration(etaMs)} | elapsed ${formatDuration(elapsedMs)}`;
-	}
-
-	/**
-	 * Render the progress line to stdout.
-	 * @param {boolean} [forcePlainLog=false] - Force a plain log line in non-TTY mode.
-	 * @returns {void}
-	 */
-	function render(forcePlainLog = false) {
-		const line = buildLine();
-		frameIndex++;
-
-		if (isTTY) {
-			// eslint-disable-next-line no-control-regex
-			const visibleLength = line.replace(/\x1B\[[0-9;]*[a-zA-Z]/g, "").length;
-			maxLineLength = Math.max(maxLineLength, visibleLength);
-			process.stdout.write(`\r${line.padEnd(maxLineLength, " ")}`);
-			return;
-		}
-
-		const now = Date.now();
-		if (forcePlainLog || now - lastPlainLog >= 2000) {
-			console.log(line);
-			lastPlainLog = now;
-		}
-	}
-
-	/**
-	 * Start the periodic spinner redraw for TTY output.
-	 * @returns {void}
-	 */
-	function startSpinnerLoop() {
-		if (!isTTY || spinnerTimer) return;
-		spinnerTimer = setInterval(() => {
-			if (completed >= total && active === 0) return;
-			render();
-		}, 120);
-		spinnerTimer.unref?.();
-	}
-
-	/**
-	 * Stop the periodic spinner redraw loop.
-	 * @returns {void}
-	 */
-	function stopSpinnerLoop() {
-		if (!spinnerTimer) return;
-		clearInterval(spinnerTimer);
-		spinnerTimer = null;
-	}
-
-	render(true);
-	startSpinnerLoop();
-
-	return {
-		/**
-		 * Call when a file run starts (increments active count).
-		 * @returns {void}
-		 */
-		onStart() {
-			active++;
-			render();
-		},
-
-		/**
-		 * Call when a file run completes.
-		 * @param {boolean} failedRun - Whether the run exited with a non-zero code.
-		 * @returns {void}
-		 */
-		onComplete(failedRun) {
-			active = Math.max(0, active - 1);
-			completed++;
-			if (failedRun) failed++;
-			render(true);
-		},
-
-		/**
-		 * Stop the spinner and print the final progress line.
-		 * @returns {void}
-		 */
-		finish() {
-			stopSpinnerLoop();
-			render(true);
-			if (isTTY) process.stdout.write("\n");
-		}
-	};
-}
-
-/**
- * A no-op progress tracker used when quiet mode is disabled (progress is
- * handled via `console.log` inline).
- * @type {{ onStart: () => void, onComplete: (failedRun: boolean) => void, finish: () => void }}
- */
-export const noopProgressTracker = {
-	/** @returns {void} */
-	onStart() {},
-	/** @param {boolean} ___failedRun @returns {void} */
-	onComplete(___failedRun) {},
-	/** @returns {void} */
-	finish() {}
-};

package/src/core/report.mjs

@@ -1,255 +0,0 @@
-/**
- * @fileoverview Result reporting and coverage summary utilities.
- * @module vitest-runner/src/core/report
- */
-
-import fs from "node:fs/promises";
-import path from "node:path";
-import chalk from "chalk";
-import { stripAnsi, colourPct } from "../utils/ansi.mjs";
-
-/**
- * Print verbose output for files that failed during a quiet coverage run.
- *
- * @param {Array<{file: string, code: number, rawOutput: string}>} failedResults
- * @returns {void}
- * @example
- * printQuietCoverageFailureDetails(failedResults);
- */
-export function printQuietCoverageFailureDetails(failedResults) {
-	if (failedResults.length === 0) return;
-
-	console.log(`\n${"=".repeat(80)}`);
-	console.log(chalk.bold.red("✖ FAILED TEST FILES (VERBOSE OUTPUT)"));
-	console.log("=".repeat(80));
-
-	for (const r of failedResults) {
-		console.log(`\n${chalk.red("✖")} ${chalk.red(r.file)} ${chalk.dim(`(exit ${r.code})`)}`);
-		if (r.rawOutput?.trim()) {
-			console.log(r.rawOutput.trimEnd());
-		} else {
-			console.log(chalk.dim("(no child output captured)"));
-		}
-	}
-
-	console.log(`\n${"=".repeat(80)}`);
-}
-
-/**
- * Print the captured output from a quiet `--mergeReports` step.
- *
- * On success prints only the coverage block (from "% Coverage report from v8").
- * On failure prints the full raw output to stderr.
- *
- * @param {number} exitCode - The merge process exit code.
- * @param {string} output - Raw stdout + stderr from the merge process.
- * @returns {void}
- */
-export function printMergeOutput(exitCode, output) {
-	if (exitCode === 0) {
-		const marker = "% Coverage report from v8";
-		const rawLines = output.split("\n");
-		const markerLineIndex = rawLines.findIndex((line) => stripAnsi(line).includes(marker));
-
-		if (markerLineIndex >= 0) {
-			let endLineIndex = rawLines.length;
-			for (let i = markerLineIndex + 1; i < rawLines.length; i++) {
-				const line = stripAnsi(rawLines[i]).trimStart();
-				if (line.startsWith("stderr |") || line.startsWith("stdout |")) {
-					endLineIndex = i;
-					break;
-				}
-			}
-
-			const coverageBody = rawLines
-				.slice(markerLineIndex + 1, endLineIndex)
-				.join("\n")
-				.trimEnd();
-			if (coverageBody) {
-				const fullBlock = rawLines.slice(markerLineIndex, endLineIndex).join("\n").trimEnd();
-				console.log(`\n${fullBlock}\n`);
-			}
-		}
-	} else {
-		const trimmed = output.trimEnd();
-		if (trimmed) console.error(trimmed);
-	}
-}
-
-/**
- * Compute a coverage-summary-style object from a raw V8/Istanbul `coverage-final.json`.
- *
- * @param {Record<string, object>} finalData - Parsed `coverage-final.json` contents.
- * @returns {{ total: object, [filePath: string]: object }} Istanbul coverage-summary format.
- */
-export function computeSummaryFromFinal(finalData) {
-	const pct = (covered, total) => (total === 0 ? 100 : parseFloat(((covered / total) * 100).toFixed(2)));
-	const summary = {
-		total: {
-			statements: { total: 0, covered: 0, pct: 0 },
-			branches: { total: 0, covered: 0, pct: 0 },
-			functions: { total: 0, covered: 0, pct: 0 },
-			lines: { total: 0, covered: 0, pct: 0 }
-		}
-	};
-
-	for (const [filePath, data] of Object.entries(finalData)) {
-		const sKeys = Object.keys(data.s ?? {});
-		const stmtTotal = sKeys.length;
-		const stmtCovered = sKeys.filter((k) => data.s[k] > 0).length;
-
-		const fKeys = Object.keys(data.f ?? {});
-		const fnTotal = fKeys.length;
-		const fnCovered = fKeys.filter((k) => data.f[k] > 0).length;
-
-		let branchTotal = 0,
-			branchCovered = 0;
-		for (const counts of Object.values(data.b ?? {})) {
-			branchTotal += counts.length;
-			branchCovered += counts.filter((c) => c > 0).length;
-		}
-
-		const coveredLines = new Set();
-		const totalLines = new Set();
-		for (const [sid, loc] of Object.entries(data.statementMap ?? {})) {
-			const line = loc?.start?.line;
-			if (line == null) continue;
-			totalLines.add(line);
-			if ((data.s ?? {})[sid] > 0) coveredLines.add(line);
-		}
-
-		const fileStats = {
-			statements: { total: stmtTotal, covered: stmtCovered, pct: pct(stmtCovered, stmtTotal) },
-			branches: { total: branchTotal, covered: branchCovered, pct: pct(branchCovered, branchTotal) },
-			functions: { total: fnTotal, covered: fnCovered, pct: pct(fnCovered, fnTotal) },
-			lines: { total: totalLines.size, covered: coveredLines.size, pct: pct(coveredLines.size, totalLines.size) }
-		};
-		summary[filePath] = fileStats;
-
-		for (const key of ["statements", "branches", "functions", "lines"]) {
-			summary.total[key].total += fileStats[key].total;
-			summary.total[key].covered += fileStats[key].covered;
-		}
-	}
-
-	for (const key of ["statements", "branches", "functions", "lines"]) {
-		const { total, covered } = summary.total[key];
-		summary.total[key].pct = pct(covered, total);
-	}
-
-	return summary;
-}
-
-/**
- * Read the coverage JSON produced after a `mergeReports` run and print a
- * worst-offenders table plus overall-coverage totals.
- *
- * Tries `coverage-summary.json` first; falls back to computing from
- * `coverage-final.json` if that is not present.
- *
- * @param {string} cwd - Project root (used to make absolute file paths relative).
- * @param {string[]} extraCoverageArgs - Passthrough `--coverage.*` args (checked for `reportsDirectory`).
- * @param {number} [worstCount=10] - Number of worst-coverage files to show (0 = skip table).
- * @param {{silent?: boolean}} [options] - Output controls.
- * @returns {Promise<{
- *  coverageDir: string,
- *  total: object,
- *  worstFiles: Array<{file: string, lines: number, stmts: number, fns: number, branches: number}>,
- *  worstFilesShown: number,
- *  worstFilesTotal: number,
- *  summary: object
- * }|null>}
- */
-export async function printCoverageSummary(cwd, extraCoverageArgs, worstCount = 10, options = {}) {
-	const { silent = false } = options;
-	let coverageDir = path.resolve(cwd, "coverage");
-	const repoDirArg = extraCoverageArgs.find((a) => a.startsWith("--coverage.reportsDirectory="));
-	if (repoDirArg) {
-		const raw = repoDirArg.split("=").slice(1).join("=");
-		coverageDir = path.isAbsolute(raw) ? raw : path.resolve(cwd, raw);
-	}
-
-	let summary;
-
-	try {
-		const content = await fs.readFile(path.join(coverageDir, "coverage-summary.json"), "utf8");
-		summary = JSON.parse(content);
-	} catch {
-		try {
-			const content = await fs.readFile(path.join(coverageDir, "coverage-final.json"), "utf8");
-			summary = computeSummaryFromFinal(JSON.parse(content));
-		} catch {
-			if (!silent) console.log(chalk.dim("  (no coverage JSON found — skipping summary)"));
-			return null;
-		}
-	}
-
-	const { total, ...fileSummaries } = summary;
-
-	if (worstCount > 0) {
-		const fileRows = Object.entries(fileSummaries)
-			.map(([absFile, data]) => ({
-				file: path.relative(cwd, absFile),
-				lines: data.lines?.pct ?? 0,
-				stmts: data.statements?.pct ?? 0,
-				fns: data.functions?.pct ?? 0,
-				branches: data.branches?.pct ?? 0
-			}))
-			.filter((r) => Math.min(r.lines, r.stmts, r.fns, r.branches) < 100)
-			.sort((a, b) => Math.min(a.lines, a.stmts, a.fns, a.branches) - Math.min(b.lines, b.stmts, b.fns, b.branches));
-		const rowsToShow = fileRows.slice(0, worstCount);
-
-		if (!silent) {
-			console.log("\n" + chalk.bold("📉 WORST COVERAGE FILES (lowest metric)"));
-			console.log("-".repeat(80));
-
-			rowsToShow.forEach(({ file, lines, stmts, fns, branches }) => {
-				const worst = Math.min(lines, stmts, fns, branches);
-				const extras = chalk.dim(
-					`lines ${lines.toFixed(0)}% | stmts ${stmts.toFixed(0)}% | fns ${fns.toFixed(0)}% | branches ${branches.toFixed(0)}%`
-				);
-				console.log(`  ${colourPct(chalk, worst)}%  ${chalk.dim(file)}  ${extras}`);
-			});
-
-			if (fileRows.length > worstCount) {
-				console.log(chalk.dim(`  ... and ${fileRows.length - worstCount} more files`));
-			}
-		}
-
-		const tl = total.lines?.pct ?? 0;
-		const ts = total.statements?.pct ?? 0;
-		const tf = total.functions?.pct ?? 0;
-		const tb = total.branches?.pct ?? 0;
-		if (!silent) {
-			console.log(
-				`\n  ${chalk.bold("Coverage")}  ${colourPct(chalk, tl)}% lines ${chalk.dim("|")} ${colourPct(chalk, ts)}% statements ${chalk.dim("|")} ${colourPct(chalk, tf)}% functions ${chalk.dim("|")} ${colourPct(chalk, tb)}% branches`
-			);
-		}
-		return {
-			coverageDir,
-			total,
-			worstFiles: rowsToShow,
-			worstFilesShown: rowsToShow.length,
-			worstFilesTotal: fileRows.length,
-			summary
-		};
-	}
-
-	const tl = total.lines?.pct ?? 0;
-	const ts = total.statements?.pct ?? 0;
-	const tf = total.functions?.pct ?? 0;
-	const tb = total.branches?.pct ?? 0;
-	if (!silent) {
-		console.log(
-			`\n  ${chalk.bold("Coverage")}  ${colourPct(chalk, tl)}% lines ${chalk.dim("|")} ${colourPct(chalk, ts)}% statements ${chalk.dim("|")} ${colourPct(chalk, tf)}% functions ${chalk.dim("|")} ${colourPct(chalk, tb)}% branches`
-		);
-	}
-	return {
-		coverageDir,
-		total,
-		worstFiles: [],
-		worstFilesShown: 0,
-		worstFilesTotal: 0,
-		summary
-	};
-}