@andy2639/jest-context 1.0.0 → 1.0.2

package/dist/{chunk-DEJBEL4M.mjs → chunk-WEP26C5H.mjs}

@@ -1,6 +1,6 @@
 import {
   JEST_PATTERNS,
-  createProgressBar,
+  createSpinner,
   displayBanner,
   displayHelp,
   handleExportOrDisplay,
@@ -9,7 +9,7 @@ import {
   runJest,
   shouldShowUI,
   validateCliArgs
-} from "./chunk-YTFA3KPD.mjs";
+} from "./chunk-GV4AYRBZ.mjs";
 
 // src/commands/coverage-context.ts
 import path from "path";
@@ -116,25 +116,24 @@ async function runCoverageContext(argv = process.argv.slice(2)) {
   const showUI = shouldShowUI(exportFormat, noBanner);
   if (showUI) {
     displayBanner({
-      text: "COVERAGE",
+      text: "JEST",
+      subtitle: "COVERAGE",
       info: {
         Threshold: `>=${threshold}%`
       },
       colors: ["magenta", "blue"]
     });
   }
-  const bar = showUI ? createProgressBar(100, "Running coverage") : null;
-  bar?.update(10, { status: "Running Jest..." });
+  const spinner = showUI ? createSpinner("Running Jest coverage...", "magenta") : null;
+  spinner?.start();
   const result = await runJest([], {
     coverage: true,
     coverageReporters: ["text", "text-summary"],
     ignoreErrors: true
   });
-  bar?.update(70, { status: "Parsing output..." });
   const rows = parseCoverage(result.output);
   if (rows.length === 0) {
-    bar?.update(100, { status: "Done" });
-    bar?.stop();
+    spinner?.warn("No coverage rows parsed");
     handleExportOrDisplay("No coverage rows parsed from Jest output.", {
       exportFormat,
       prefix: "export-coverage-context",
@@ -144,9 +143,8 @@ async function runCoverageContext(argv = process.argv.slice(2)) {
   }
   const incomplete = filterIncomplete(rows, threshold);
   const grouped = groupByFolder(incomplete);
-  bar?.update(100, { status: "Done" });
-  bar?.stop();
   if (Object.keys(grouped).length === 0) {
+    spinner?.succeed(`All files meet threshold >= ${threshold}%`);
     handleExportOrDisplay(`All files meet threshold >= ${threshold}%`, {
       exportFormat,
       prefix: "export-coverage-context",
@@ -155,6 +153,7 @@ async function runCoverageContext(argv = process.argv.slice(2)) {
     return;
   }
   const formatted = formatCoverageOutput(grouped);
+  spinner?.warn(`Found ${incomplete.length} file(s) below threshold`);
   handleExportOrDisplay(formatted, {
     exportFormat,
     prefix: "export-coverage-context",
@@ -165,4 +164,4 @@ async function runCoverageContext(argv = process.argv.slice(2)) {
 export {
   runCoverageContext
 };
-//# sourceMappingURL=chunk-DEJBEL4M.mjs.map
+//# sourceMappingURL=chunk-WEP26C5H.mjs.map

package/dist/chunk-WEP26C5H.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/coverage-context.ts"],"sourcesContent":["import path from \"node:path\";\n\nimport {\n  createSpinner,\n  displayBanner,\n  displayHelp,\n  exitWithError,\n  handleExportOrDisplay,\n  JEST_PATTERNS,\n  parseExportCliArgs,\n  runJest,\n  shouldShowUI,\n  validateCliArgs,\n  logWarning,\n} from \"../core\";\n\nfunction parseCoverage(text: string) {\n  const lines = text.split(\"\\n\");\n  const rows: Array<{\n    folder: string;\n    file: string;\n    stmts: number;\n    branch: number;\n    funcs: number;\n    lines: number;\n    uncovered?: string;\n  }> = [];\n\n  let currentFolder: string | null = null;\n\n  for (const line of lines) {\n    const match = line.match(JEST_PATTERNS.COVERAGE_LINE);\n    if (!match) continue;\n\n    const [, rawFile, stmts, branch, funcs, linesPct, uncovered] = match;\n    const normalized = rawFile.trim();\n\n    if (normalized === \"All files\") continue;\n\n    const isFile = /\\.(ts|tsx)$/.test(normalized);\n    if (!isFile) {\n      currentFolder = normalized;\n      continue;\n    }\n\n    if (/index\\.(ts|tsx)$/.test(normalized)) continue;\n    if (!currentFolder) currentFolder = path.dirname(normalized);\n\n    rows.push({\n      folder: currentFolder,\n      file: path.basename(normalized),\n      stmts: Number(stmts),\n      branch: Number(branch),\n      funcs: Number(funcs),\n      lines: Number(linesPct),\n      uncovered: uncovered?.trim(),\n    });\n  }\n\n  return rows;\n}\n\nfunction filterIncomplete(rows: ReturnType<typeof parseCoverage>, threshold = 100) {\n  return rows.filter(\n    (r) => !(r.stmts >= threshold && r.branch >= threshold && r.funcs >= threshold && r.lines >= threshold)\n  );\n}\n\nfunction groupByFolder(rows: ReturnType<typeof parseCoverage>) {\n  const grouped: Record<string, Array<{ file: string; coverage: Omit<(typeof rows)[number], \"folder\" | \"file\"> }>> = {};\n\n  for (const row of rows) {\n    const { folder, file, ...rest } = row;\n    if (!grouped[folder]) grouped[folder] = [];\n    grouped[folder].push({ file, coverage: rest });\n  }\n\n  return grouped;\n}\n\nfunction formatCoverageOutput(grouped: ReturnType<typeof groupByFolder>): string {\n  let output = \"\";\n\n  for (const folder of Object.keys(grouped)) {\n    output += `📁 Folder: ${folder}\\n`;\n\n    for (const item of grouped[folder]) {\n      const { file, coverage } = item;\n      output += ` 📄 File: ${file}\\n`;\n      output += `- Coverage:\\n`;\n      output += `  - Stmts:  ${coverage.stmts}\\n`;\n      output += `  - Branch: ${coverage.branch}\\n`;\n      output += `  - Funcs:  ${coverage.funcs}\\n`;\n      output += `  - Lines:  ${coverage.lines}\\n`;\n      output += `  - Uncovered: ${coverage.uncovered || \"N/A\"}\\n\\n`;\n    }\n\n    output += \"\\n\";\n  }\n\n  return output.trim();\n}\n\nexport async function runCoverageContext(argv = process.argv.slice(2)): Promise<void> {\n  if (argv.includes(\"-h\") || argv.includes(\"--help\")) {\n    displayHelp(\"Coverage Context Script\", {\n      description: \"Run Jest coverage and print files below threshold.\",\n      usage: [\"coverage-context\", \"coverage-context --threshold=90\"],\n      options: [\n        \"--threshold=0..100  Minimum percentage for stmts/branch/funcs/lines (default: 100)\",\n        \"--export            Export output as txt\",\n        \"--export=txt|md     Export output in selected format\",\n        \"--no-banner         Disable fancy terminal UI\",\n        \"-h, --help          Show this help\",\n      ],\n      examples: [\"coverage-context --threshold=90 --export=md\"],\n    });\n  }\n\n  const noBanner = argv.includes(\"--no-banner\");\n  const args = argv.filter((arg) => arg !== \"--no-banner\");\n\n  const { exportFormat, exportArgs } = parseExportCliArgs(args);\n  const { parsed, unknownArgs } = validateCliArgs(args, {\n    threshold: {\n      prefix: \"--threshold=\",\n      allowedValues: Array.from({ length: 101 }, (_, i) => String(i)),\n    },\n  });\n\n  const exportArgSet = new Set(exportArgs);\n  const filteredUnknownArgs = unknownArgs.filter((arg) => !exportArgSet.has(arg));\n  if (filteredUnknownArgs.length > 0) {\n    logWarning(`Unknown arguments ignored: ${filteredUnknownArgs.join(\", \")}`);\n  }\n\n  const threshold = parsed.threshold ? Number(parsed.threshold) : 100;\n  const showUI = shouldShowUI(exportFormat, noBanner);\n\n  if (showUI) {\n    displayBanner({\n      text: \"JEST\",\n      subtitle: \"COVERAGE\",\n      info: {\n        Threshold: `>=${threshold}%`,\n      },\n      colors: [\"magenta\", \"blue\"],\n    });\n  }\n\n  const spinner = showUI ? createSpinner(\"Running Jest coverage...\", \"magenta\") : null;\n  spinner?.start();\n\n  const result = await runJest([], {\n    coverage: true,\n    coverageReporters: [\"text\", \"text-summary\"],\n    ignoreErrors: true,\n  });\n\n  const rows = parseCoverage(result.output);\n  if (rows.length === 0) {\n    spinner?.warn(\"No coverage rows parsed\");\n\n    handleExportOrDisplay(\"No coverage rows parsed from Jest output.\", {\n      exportFormat,\n      prefix: \"export-coverage-context\",\n      title: \"Coverage Context\",\n    });\n\n    return;\n  }\n\n  const incomplete = filterIncomplete(rows, threshold);\n  const grouped = groupByFolder(incomplete);\n\n  if (Object.keys(grouped).length === 0) {\n    spinner?.succeed(`All files meet threshold >= ${threshold}%`);\n\n    handleExportOrDisplay(`All files meet threshold >= ${threshold}%`, {\n      exportFormat,\n      prefix: \"export-coverage-context\",\n      title: \"Coverage Context\",\n    });\n\n    return;\n  }\n\n  const formatted = formatCoverageOutput(grouped);\n  spinner?.warn(`Found ${incomplete.length} file(s) below threshold`);\n\n  handleExportOrDisplay(formatted, {\n    exportFormat,\n    prefix: \"export-coverage-context\",\n    title: \"Coverage Context\",\n  });\n}\n"],"mappings":"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","names":[]}

package/dist/index.cjs

@@ -69,6 +69,7 @@ __export(index_exports, {
   resolveCommand: () => resolveCommand,
   runConsoleContext: () => runConsoleContext,
   runCoverageContext: () => runCoverageContext,
+  runInitContextScripts: () => runInitContextScripts,
   runJest: () => runJest,
   runTestContext: () => runTestContext,
   shouldShowUI: () => shouldShowUI,
@@ -147,7 +148,7 @@ async function execCommand(cmd, args = [], options = {}) {
   return new Promise((resolve, reject) => {
     const resolvedCmd = resolveCommand(cmd);
     const child = (0, import_node_child_process.spawn)(resolvedCmd, args, {
-      shell: options.shell ?? process.platform === "win32"
+      shell: options.shell ?? false
     });
     let stdout = "";
     let stderr = "";
@@ -227,6 +228,7 @@ async function runJest(args = [], options = {}) {
     disableVerbose = false
   } = options;
   const jestCmd = getJestCommand(packageManager);
+  const command = resolveCommand(jestCmd[0]);
   const jestArgs = [...jestCmd.slice(1)];
   if (verbose && !disableVerbose) {
     jestArgs.push("--verbose");
@@ -244,8 +246,8 @@ async function runJest(args = [], options = {}) {
   }
   jestArgs.push(...args);
   return new Promise((resolve, reject) => {
-    const child = (0, import_node_child_process2.spawn)(jestCmd[0], jestArgs, {
-      shell: isWindows()
+    const child = (0, import_node_child_process2.spawn)(command, jestArgs, {
+      shell: false
     });
     let stdout = "";
     let stderr = "";
@@ -470,6 +472,14 @@ function logSuccess(message) {
 }
 
 // src/core/ui.ts
+var NOOP_PROGRESS_BAR = {
+  update: () => {
+  },
+  stop: () => {
+  }
+};
+var hasWarnedSpinnerFallback = false;
+var hasWarnedProgressFallback = false;
 function shouldShowUI(exportMode, noBanner = false) {
   return !exportMode && !noBanner && Boolean(process.stdout.isTTY);
 }
@@ -515,29 +525,38 @@ function displayBanner(config) {
   console.log(boxed);
 }
 function createSpinner(text, color = "cyan") {
-  const ora = require("ora");
-  return ora({ text, color, spinner: "dots" });
+  try {
+    const ora = require("ora");
+    return ora({ text, color, spinner: "dots" });
+  } catch {
+    if (!hasWarnedSpinnerFallback) {
+      hasWarnedSpinnerFallback = true;
+      console.warn("Warning: spinner UI unavailable, continuing without spinner.");
+    }
+    return {
+      start: () => NOOP_SPINNER,
+      stop: () => NOOP_SPINNER,
+      succeed: () => NOOP_SPINNER,
+      warn: () => NOOP_SPINNER,
+      fail: () => NOOP_SPINNER
+    };
+  }
 }
+var NOOP_SPINNER = {
+  start: () => NOOP_SPINNER,
+  stop: () => NOOP_SPINNER,
+  succeed: () => NOOP_SPINNER,
+  warn: () => NOOP_SPINNER,
+  fail: () => NOOP_SPINNER
+};
 function createProgressBar(total = 100, task = "Progress") {
-  const cliProgress = require("cli-progress");
-  const bar = new cliProgress.SingleBar(
-    {
-      format: "{task} [{bar}] {percentage}% | {status}",
-      barCompleteChar: "\u2588",
-      barIncompleteChar: "\u2591",
-      hideCursor: true,
-      barsize: 24
-    },
-    cliProgress.Presets.shades_classic
-  );
-  bar.start(total, 0, {
-    task,
-    status: "Starting..."
-  });
-  return {
-    update: (value, payload) => bar.update(value, payload),
-    stop: () => bar.stop()
-  };
+  if (!hasWarnedProgressFallback) {
+    hasWarnedProgressFallback = true;
+    console.warn(
+      `Warning: progress bar UI is no longer used. Ignoring createProgressBar(${total}, ${JSON.stringify(task)}).`
+    );
+  }
+  return NOOP_PROGRESS_BAR;
 }
 
 // src/commands/test-context.ts
@@ -627,8 +646,8 @@ async function runTestContext(argv = process.argv.slice(2)) {
   const showUI = shouldShowUI(exportFormat, noBanner);
   if (showUI) {
     displayBanner({
-      text: "TEST",
-      subtitle: "CONTEXT",
+      text: "JEST",
+      subtitle: "TEST",
       info: {
         Mode: mode
       },
@@ -792,25 +811,24 @@ async function runCoverageContext(argv = process.argv.slice(2)) {
   const showUI = shouldShowUI(exportFormat, noBanner);
   if (showUI) {
     displayBanner({
-      text: "COVERAGE",
+      text: "JEST",
+      subtitle: "COVERAGE",
       info: {
         Threshold: `>=${threshold}%`
       },
       colors: ["magenta", "blue"]
     });
   }
-  const bar = showUI ? createProgressBar(100, "Running coverage") : null;
-  bar?.update(10, { status: "Running Jest..." });
+  const spinner = showUI ? createSpinner("Running Jest coverage...", "magenta") : null;
+  spinner?.start();
   const result = await runJest([], {
     coverage: true,
     coverageReporters: ["text", "text-summary"],
     ignoreErrors: true
   });
-  bar?.update(70, { status: "Parsing output..." });
   const rows = parseCoverage(result.output);
   if (rows.length === 0) {
-    bar?.update(100, { status: "Done" });
-    bar?.stop();
+    spinner?.warn("No coverage rows parsed");
     handleExportOrDisplay("No coverage rows parsed from Jest output.", {
       exportFormat,
       prefix: "export-coverage-context",
@@ -820,9 +838,8 @@ async function runCoverageContext(argv = process.argv.slice(2)) {
   }
   const incomplete = filterIncomplete(rows, threshold);
   const grouped = groupByFolder(incomplete);
-  bar?.update(100, { status: "Done" });
-  bar?.stop();
   if (Object.keys(grouped).length === 0) {
+    spinner?.succeed(`All files meet threshold >= ${threshold}%`);
     handleExportOrDisplay(`All files meet threshold >= ${threshold}%`, {
       exportFormat,
       prefix: "export-coverage-context",
@@ -831,6 +848,7 @@ async function runCoverageContext(argv = process.argv.slice(2)) {
     return;
   }
   const formatted = formatCoverageOutput(grouped);
+  spinner?.warn(`Found ${incomplete.length} file(s) below threshold`);
   handleExportOrDisplay(formatted, {
     exportFormat,
     prefix: "export-coverage-context",
@@ -1021,8 +1039,8 @@ async function runConsoleContext(argv = process.argv.slice(2)) {
   const showUI = shouldShowUI(exportFormat, noBanner);
   if (showUI) {
     displayBanner({
-      text: "CONSOLE",
-      subtitle: "WARNINGS",
+      text: "JEST",
+      subtitle: "CONSOLE",
       info: {
         Mode: mode,
         Filter: filter ?? "none"
@@ -1062,6 +1080,66 @@ async function runConsoleContext(argv = process.argv.slice(2)) {
     title: "Console Warnings Context"
   });
 }
+
+// src/commands/init-context-scripts.ts
+var import_node_fs2 = require("fs");
+var import_node_path4 = __toESM(require("path"));
+var CONTEXT_SCRIPTS = {
+  "console:context": "console-context",
+  "coverage:context": "coverage-context",
+  "test:context": "test-context"
+};
+function runInitContextScripts(argv = process.argv.slice(2)) {
+  if (argv.includes("-h") || argv.includes("--help")) {
+    displayHelp("Jest Context Init Script", {
+      description: "Inject context scripts into package.json in the current project.",
+      usage: ["jest-context-init", "jest-context-init --help"],
+      options: ["-h, --help  Show this help"],
+      examples: ["npx jest-context-init", "pnpm dlx @andy2639/jest-context jest-context-init"]
+    });
+  }
+  const packageJsonPath = import_node_path4.default.resolve(process.cwd(), "package.json");
+  let raw = "";
+  try {
+    raw = (0, import_node_fs2.readFileSync)(packageJsonPath, "utf-8");
+  } catch {
+    exitWithError(`Could not read package.json at: ${packageJsonPath}`);
+  }
+  let packageJson;
+  try {
+    packageJson = JSON.parse(raw);
+  } catch {
+    exitWithError(`Invalid JSON in package.json: ${packageJsonPath}`);
+  }
+  const scripts = packageJson.scripts && typeof packageJson.scripts === "object" ? { ...packageJson.scripts } : {};
+  const added = [];
+  const updated = [];
+  for (const [name, value] of Object.entries(CONTEXT_SCRIPTS)) {
+    if (!(name in scripts)) {
+      scripts[name] = value;
+      added.push(name);
+      continue;
+    }
+    if (scripts[name] !== value) {
+      scripts[name] = value;
+      updated.push(name);
+    }
+  }
+  if (added.length === 0 && updated.length === 0) {
+    logInfo("package.json already has the expected context scripts.");
+    return;
+  }
+  packageJson.scripts = scripts;
+  (0, import_node_fs2.writeFileSync)(packageJsonPath, `${JSON.stringify(packageJson, null, 2)}
+`, "utf-8");
+  logSuccess(`Updated package.json scripts at: ${packageJsonPath}`);
+  if (added.length > 0) {
+    logInfo(`Added scripts: ${added.join(", ")}`);
+  }
+  if (updated.length > 0) {
+    logInfo(`Updated scripts: ${updated.join(", ")}`);
+  }
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   CONSOLE_LOG_TYPES,
@@ -1103,6 +1181,7 @@ async function runConsoleContext(argv = process.argv.slice(2)) {
   resolveCommand,
   runConsoleContext,
   runCoverageContext,
+  runInitContextScripts,
   runJest,
   runTestContext,
   shouldShowUI,