openclaw/scripts/lib/vitest-report-cli-utils.mjs

// Shared CLI parsing and formatting helpers for Vitest report scripts.
import { readJsonFile, runVitestJsonReport } from "../test-report-utils.mjs";
import { intFlag, parseFlagArgs, stringFlag } from "./arg-utils.mjs";

/**
 * Parses common Vitest report flags with caller-provided defaults.
 */
export function parseVitestReportArgs(argv, defaults) {
  return parseFlagArgs(
    argv,
    {
      config: defaults.config,
      limit: defaults.limit,
      reportPath: defaults.reportPath ?? "",
    },
    [
      stringFlag("--config", "config"),
      intFlag("--limit", "limit", { min: 1 }),
      stringFlag("--report", "reportPath"),
    ],
  );
}

/**
 * Runs Vitest JSON reporting from parsed args and loads the generated report.
 */
export function loadVitestReportFromArgs(args, prefix) {
  const reportPath = runVitestJsonReport({
    config: args.config,
    reportPath: args.reportPath,
    prefix,
  });
  return readJsonFile(reportPath);
}

/**
 * Formats milliseconds with a fixed decimal precision.
 */
export function formatMs(value, digits = 1) {
  return `${value.toFixed(digits)}ms`;
}