@cldmv/vitest-runner 1.4.2 → 1.4.4

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@cldmv/vitest-runner",
-	"version": "1.4.2",
+	"version": "1.4.4",
 	"description": "Sequential Vitest runner to avoid OOM issues with large test suites",
 	"type": "module",
 	"main": "./dist/index.cjs",
@@ -39,7 +39,7 @@
 		"types:check": "tsc -p .configs/tsconfig.json --noEmit",
 		"build": "tsup",
 		"build:ci": "npm run lint && npm run format:check && npm run types:build && npm run build",
-		"prepack": "node -e \"const fs=require('node:fs');const hasTsup=fs.existsSync('node_modules/.bin/tsup')||fs.existsSync('node_modules/.bin/tsup.cmd');if(hasTsup){require('node:child_process').execSync('npm run build',{stdio:'inherit'})}else if(!fs.existsSync('dist/index.mjs')){throw new Error('dist/ is missing and tsup is unavailable to build it (expected in a bare package-contents publish dir with a prebuilt dist/; unexpected anywhere else)')}\"",
+		"prepack": "npm run build",
 		"fix:headers": "node tools/fix-headers.mjs"
 	},
 	"keywords": [

package/types/src/core/report.d.mts

@@ -25,6 +25,10 @@ export function printMergeOutput(exitCode: number, output: string): void;
 /**
  * Compute a coverage-summary-style object from a raw V8/Istanbul `coverage-final.json`.
  *
+ * Matches istanbul's own summary: a file with no entries for a metric counts as
+ * 100% for that metric, and when there are no files at all every total `pct` is
+ * the string `"Unknown"`.
+ *
  * @param {Record<string, object>} finalData - Parsed `coverage-final.json` contents.
  * @returns {{ total: object, [filePath: string]: object }} Istanbul coverage-summary format.
  */
@@ -39,6 +43,11 @@ export function computeSummaryFromFinal(finalData: Record<string, object>): {
  * Tries `coverage-summary.json` first; falls back to computing from
  * `coverage-final.json` if that is not present.
  *
+ * A non-numeric `pct` (istanbul reports `"Unknown"` when the coverage `include`
+ * matched no files) is printed as `Unknown` and never throws. When no files were
+ * measured at all, a note says so: there is nothing for a coverage threshold to
+ * measure, and vitest's own threshold check does not fail on an `Unknown` value.
+ *
  * @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).
@@ -46,7 +55,8 @@ export function computeSummaryFromFinal(finalData: Record<string, object>): {
  * @returns {Promise<{
  *  coverageDir: string,
  *  total: object,
- *  worstFiles: Array<{file: string, lines: number, stmts: number, fns: number, branches: number}>,
+ *  noFilesMeasured: boolean,
+ *  worstFiles: Array<{file: string, lines: number|string, stmts: number|string, fns: number|string, branches: number|string}>,
  *  worstFilesShown: number,
  *  worstFilesTotal: number,
  *  summary: object
@@ -57,12 +67,13 @@ export function printCoverageSummary(cwd: string, extraCoverageArgs: string[], w
 }): Promise<{
     coverageDir: string;
     total: object;
+    noFilesMeasured: boolean;
     worstFiles: Array<{
         file: string;
-        lines: number;
-        stmts: number;
-        fns: number;
-        branches: number;
+        lines: number | string;
+        stmts: number | string;
+        fns: number | string;
+        branches: number | string;
     }>;
     worstFilesShown: number;
     worstFilesTotal: number;

package/types/src/utils/ansi.d.mts

@@ -22,13 +22,39 @@
  * stripAnsi('\x1B[32mhello\x1B[0m'); // 'hello'
  */
 export function stripAnsi(text: string): string;
+/**
+ * Check whether a coverage percentage is a real number.
+ *
+ * Istanbul reports a metric's `pct` as the string `"Unknown"` when nothing was
+ * measured (e.g. the coverage `include` matched no files), so a `pct` cannot be
+ * assumed to be numeric.
+ * @param {unknown} pct - Coverage percentage as read from a coverage summary.
+ * @returns {pct is number} `true` when `pct` is a finite number.
+ * @example
+ * isKnownPct(75.5); // true
+ * isKnownPct("Unknown"); // false
+ */
+export function isKnownPct(pct: unknown): pct is number;
+/**
+ * Format a coverage percentage with a fixed number of decimals, or `Unknown`
+ * when the value is not a number.
+ * @param {unknown} pct - Coverage percentage as read from a coverage summary.
+ * @param {number} digits - Decimal places for a numeric value.
+ * @returns {string} The formatted percentage (without a `%` sign).
+ * @example
+ * formatPct(75.5, 0); // '76'
+ * formatPct("Unknown", 0); // 'Unknown'
+ */
+export function formatPct(pct: unknown, digits: number): string;
 /**
  * Colour-code a coverage percentage value using chalk.
- * ≥ 80 % → green, ≥ 50 % → yellow, < 50 % → red.
+ * ≥ 80 % → green, ≥ 50 % → yellow, < 50 % → red. A non-numeric value
+ * (istanbul's `"Unknown"`) is rendered as a dim `Unknown`.
  * @param {import('chalk').ChalkInstance} chalk - Chalk instance supplied by the caller.
- * @param {number} pct - Coverage percentage 0–100.
+ * @param {unknown} pct - Coverage percentage 0–100, or a non-numeric value such as `"Unknown"`.
  * @returns {string} Chalk-coloured, right-aligned percentage string.
  * @example
  * colourPct(chalk, 75.5); // yellow '  75.50'
+ * colourPct(chalk, "Unknown"); // dim 'Unknown'
  */
-export function colourPct(chalk: import("chalk").ChalkInstance, pct: number): string;
+export function colourPct(chalk: import("chalk").ChalkInstance, pct: unknown): string;