tz-clean 2.3.2 → 2.4.0

package/index.js

@@ -1,428 +1,386 @@
-#!/usr/bin/env node
-import { execSync } from 'child_process';
-import fs from 'fs';
-import http from 'http';
-import open from 'open';
-import path from 'path';
-import prompts from 'prompts';
-import { fileURLToPath } from 'url';
-
-const filename = fileURLToPath(import.meta.url);
-const dirname = path.dirname(filename);
-const configDir = dirname;
-const targetDir = process.cwd();
-
-/**
- * Calculates the total number of errors and warnings from the ESLint report data.
- * @param {Array<object>} reportData - The report data from ESLint.
- * @returns {{totalErrors: number, totalWarnings: number}} The calculated totals.
- */
-function calculateTotals(reportData) {
-  let totalErrors = 0;
-  let totalWarnings = 0;
-  reportData.forEach((file) => {
-    totalErrors += file.errorCount;
-    totalWarnings += file.warningCount;
-  });
-  return { totalErrors, totalWarnings };
-}
-
-/**
- * Generates an HTML dashboard report.
- * @param {Array<object>} reportData - The report data from ESLint.
- * @param {string[]} fixedFiles - The list of formatted files.
- * @returns {string} The output path of the generated HTML file.
- */
-function generateHtmlReport(reportData, fixedFiles) {
-  const templatePath = path.join(configDir, 'report-template.html');
-  let html = fs.readFileSync(templatePath, 'utf-8');
-
-  html = html.replace('/* REPORT_DATA_PLACEHOLDER */ null', JSON.stringify(reportData));
-  html = html.replace('/* FIXED_FILES_PLACEHOLDER */ []', JSON.stringify(fixedFiles));
-
-  const outputPath = path.join(targetDir, '.tz-clean-report.html');
-  fs.writeFileSync(outputPath, html);
-  return outputPath;
-}
-
-/**
- * Parses command line arguments to determine which tools to run.
- * @returns {{runEslint: boolean, runPrettier: boolean, runTypecheck: boolean, tools: string[], includePaths: string[], excludePaths: string[]}} The configuration object.
- */
-function parseArgs() {
-  const args = process.argv.slice(2);
-  const runPrettier = !args.includes('--no-prettier');
-  const runEslint = !args.includes('--no-eslint');
-  const runTypecheck = !args.includes('--no-typecheck');
-
-  const includePaths = [];
-  const excludePaths = [];
-
-  for (let i = 0; i < args.length; i++) {
-    if (args[i] === '--include' && args[i + 1]) {
-      args[i + 1].split(',').forEach((p) => includePaths.push(p.trim()));
-      i++;
-    } else if (args[i] === '--exclude' && args[i + 1]) {
-      args[i + 1].split(',').forEach((p) => excludePaths.push(p.trim()));
-      i++;
-    }
-  }
-
-  const tools = [];
-  if (runPrettier) tools.push('Prettier');
-  if (runEslint) tools.push('ESLint');
-  if (runTypecheck) tools.push('Typecheck');
-
-  return { excludePaths, includePaths, runEslint, runPrettier, runTypecheck, tools };
-}
-
-/**
- * Prints a summary of the analysis report to the terminal.
- * @param {Array<object>} reportData - The report data from ESLint.
- * @param {string[]} fixedFiles - The list of formatted files.
- * @param {number} totalErrors - Total ESLint errors.
- * @param {number} totalWarnings - Total ESLint warnings.
- * @param {{error: string|null, ran: boolean}} typecheckResult - The typecheck execution result.
- * @returns {void}
- */
-function printTerminalSummary(reportData, fixedFiles, totalErrors, totalWarnings, typecheckResult) {
-  console.log('\n--- 📊 tz-clean Summary ---');
-  console.log(`Files Analyzed: ${reportData.length}`);
-  console.log(`Errors (Critical) : ${totalErrors > 0 ? '❌ ' + totalErrors : '✅ 0'}`);
-  console.log(`Warnings          : ${totalWarnings > 0 ? '⚠️ ' + totalWarnings : '✅ 0'}`);
-
-  if (!typecheckResult.ran) {
-    console.log(`Typecheck         : ⚠️ Skipped`);
-  } else if (typecheckResult.error) {
-    console.log(`Typecheck         : ❌ ${typecheckResult.error}`);
-  } else {
-    console.log(`Typecheck         : ✅ Passed`);
-  }
-  console.log('---------------------------');
-
-  if (fixedFiles.length > 0) {
-    console.log('\n✨ Auto-Fixed (Formatted):');
-    fixedFiles.forEach((file) => console.log(`  - ${file}`));
-  }
-
-  if (totalErrors > 0 || totalWarnings > 0) {
-    console.log('\n📝 Details:');
-    reportData.forEach((file) => {
-      if (file.errorCount > 0 || file.warningCount > 0) {
-        console.log(`\n📂 ${path.relative(targetDir, file.filePath) || file.filePath}`);
-        file.messages.forEach((msg) => {
-          const severity = msg.severity === 2 ? '❌ Error' : '⚠️ Warning';
-          console.log(`   ${severity} [${msg.line || 0}:${msg.column || 0}] ${msg.message} (${msg.ruleId || ''})`);
-        });
-      }
-    });
-    console.log('\n---------------------------\n');
-  } else {
-    console.log('\n');
-  }
-}
-
-/**
- * Orchestrates the overall execution of the CLI.
- * @returns {Promise<void>}
- */
-async function run() {
-  const { runEslint, runPrettier, runTypecheck, tools, includePaths, excludePaths } = parseArgs();
-
-  if (tools.length === 0) {
-    console.log('No tools selected to run.');
-    process.exit(0);
-  }
-
-  console.log(`🧹 Running tz-clean (${tools.join(', ')})...`);
-  if (includePaths.length > 0) console.log(`📁 Include: ${includePaths.join(', ')}`);
-  if (excludePaths.length > 0) console.log(`🚫 Exclude: ${excludePaths.join(', ')}`);
-
-  try {
-    const fixedFiles = runPrettier ? runPrettierTools(includePaths, excludePaths) : [];
-    const strippedFiles = stripCommentsAndEmptyLines(includePaths, excludePaths);
-    const allFixedFiles = [...new Set([...fixedFiles, ...strippedFiles])];
-    const typecheckResult = runTypecheck ? runTypecheckTools() : { error: null, ran: false };
-    const reportData = runEslint ? runEslintTools(includePaths, excludePaths) : [];
-    const { totalErrors, totalWarnings } = calculateTotals(reportData);
-
-    console.log('\n✅ Analysis complete!');
-    const response = await prompts({
-      choices: [
-        { description: 'Quick overview in terminal', title: 'Terminal Summary', value: 'terminal' },
-        { description: 'Detailed HTML visual report', title: 'UI Dashboard (Browser)', value: 'ui' },
-        { description: 'Serve on localhost port 8080', title: 'UI Dashboard (Hosted)', value: 'hosted' },
-      ],
-      initial: 0,
-      message: 'How would you like to view the analysis report?',
-      name: 'reportType',
-      type: 'select',
-    });
-
-    if (!response.reportType) {
-      console.log('Operation cancelled.');
-      process.exit(0);
-    }
-
-    if (response.reportType === 'terminal') {
-      printTerminalSummary(reportData, allFixedFiles, totalErrors, totalWarnings, typecheckResult);
-    } else if (response.reportType === 'ui') {
-      console.log('⏳ Generating UI Dashboard...');
-      const outputPath = generateHtmlReport(reportData, allFixedFiles);
-      console.log(`🚀 Opening report in browser: ${outputPath}`);
-      await open(outputPath);
-    } else if (response.reportType === 'hosted') {
-      console.log('⏳ Generating Hosted UI Dashboard...');
-      const templatePath = path.join(configDir, 'report-template.html');
-      let html = fs.readFileSync(templatePath, 'utf-8');
-      html = html.replace('/* REPORT_DATA_PLACEHOLDER */ null', JSON.stringify(reportData));
-      html = html.replace('/* FIXED_FILES_PLACEHOLDER */ []', JSON.stringify(allFixedFiles));
-      serveHostedReport(html);
-    }
-  } catch (globalError) {
-    console.error('\n❌ tz-clean encountered a fatal error:', globalError.message);
-    process.exit(1);
-  }
-}
-
-/**
- * Strips all comments from a JS/TS source string without touching string literals or regex.
- * Handles single-line (//), block (/* *\/), and preserves URLs inside strings like 'http://...'.
- * @param {string} source - The source code string.
- * @returns {string} The source with all comments removed.
- */
-function stripCommentsFromSource(source) {
-  let result = '';
-  let i = 0;
-  const len = source.length;
-
-  while (i < len) {
-    const ch = source[i];
-
-    // String literals: single, double, or template
-    if (ch === '"' || ch === "'" || ch === '`') {
-      const quote = ch;
-      result += ch;
-      i++;
-      while (i < len) {
-        const sc = source[i];
-        if (sc === '\\') {
-          result += sc + (source[i + 1] || '');
-          i += 2;
-          continue;
-        }
-        result += sc;
-        i++;
-        if (sc === quote) break;
-      }
-      continue;
-    }
-
-    // Block comment: /* ... */
-    if (ch === '/' && source[i + 1] === '*') {
-      i += 2;
-      while (i < len) {
-        if (source[i] === '*' && source[i + 1] === '/') {
-          i += 2;
-          break;
-        }
-        i++;
-      }
-      continue;
-    }
-
-    // Single-line comment: // ...
-    if (ch === '/' && source[i + 1] === '/') {
-      i += 2;
-      while (i < len && source[i] !== '\n') i++;
-      continue;
-    }
-
-    result += ch;
-    i++;
-  }
-
-  return result;
-}
-
-/**
- * Strips all comments and excess blank lines from JS/TS files in the target paths.
- * Removes single-line comments (//), block comments (/* *\/), eslint-disable directives,
- * and collapses multiple consecutive blank lines into one.
- * @param {string[]} includePaths - Paths to process (defaults to targetDir).
- * @param {string[]} excludePaths - Paths to skip.
- * @returns {string[]} List of files that were modified.
- */
-function stripCommentsAndEmptyLines(includePaths = [], excludePaths = []) {
-  const extensions = ['.js', '.ts', '.jsx', '.tsx', '.mjs', '.cjs'];
-  const modifiedFiles = [];
-
-  const defaultIgnorePatterns = [
-    /node_modules/,
-    /\.min\.(js|cjs|mjs)$/,
-    /\.bundle\.js$/,
-    /[/\\](dist|build|vendor|libs)[/\\]/,
-  ];
-
-  const userIgnorePatterns = excludePaths.map((p) => new RegExp(p.replace(/\//g, '[/\\\\]')));
-  const allIgnorePatterns = [...defaultIgnorePatterns, ...userIgnorePatterns];
-
-  const scanDir = (dir) => {
-    let entries;
-    try {
-      entries = fs.readdirSync(dir, { withFileTypes: true });
-    } catch {
-      return;
-    }
-    for (const entry of entries) {
-      const fullPath = path.join(dir, entry.name);
-      if (allIgnorePatterns.some((re) => re.test(fullPath))) continue;
-      if (entry.isDirectory()) {
-        scanDir(fullPath);
-      } else if (entry.isFile() && extensions.includes(path.extname(entry.name))) {
-        const original = fs.readFileSync(fullPath, 'utf-8');
-        let cleaned = original;
-
-        // Use parser-aware comment stripper (safe for URLs in strings)
-        cleaned = stripCommentsFromSource(cleaned);
-
-        // Collapse multiple blank lines into one
-        cleaned = cleaned.replace(/\n{3,}/g, '\n\n');
-
-        // Remove blank lines at start of file
-        cleaned = cleaned.replace(/^\n+/, '');
-
-        // Ensure single newline at end of file
-        cleaned = cleaned.trimEnd() + '\n';
-
-        if (cleaned !== original) {
-          fs.writeFileSync(fullPath, cleaned, 'utf-8');
-          modifiedFiles.push(path.relative(targetDir, fullPath));
-        }
-      }
-    }
-  };
-
-  const targets = includePaths.length > 0 ? includePaths.map((p) => path.resolve(targetDir, p)) : [targetDir];
-  targets.forEach((t) => scanDir(t));
-
-  return modifiedFiles;
-}
-
-/**
- * Executes ESLint to analyze code.
- * @param {string[]} includePaths - Paths to include in analysis.
- * @param {string[]} excludePaths - Paths to exclude from analysis.
- * @returns {Array<object>} An array containing the report data from ESLint.
- */
-function runEslintTools(includePaths = [], excludePaths = []) {
-  let eslintOutput = '';
-  let reportData = [];
-
-  const targets = includePaths.length > 0 ? includePaths.map((p) => `"${p}"`).join(' ') : '.';
-  const ignoreFlags = excludePaths.map((p) => `--ignore-pattern "${p}"`).join(' ');
-
-  try {
-    eslintOutput = execSync(
-      `npx eslint ${targets} -c "${path.join(configDir, 'eslint.config.mjs')}" -f json ${ignoreFlags}`,
-      {
-        encoding: 'utf-8',
-        maxBuffer: 1024 * 1024 * 10,
-      },
-    );
-  } catch (err) {
-    eslintOutput = err.stdout;
-  }
-
-  if (eslintOutput) {
-    try {
-      reportData = JSON.parse(eslintOutput);
-    } catch (e) {
-      console.error('❌ Failed to parse ESLint output.', e);
-      process.exit(1);
-    }
-  }
-  return reportData;
-}
-
-/**
- * Executes Prettier to format files.
- * @param {string[]} includePaths - Paths to include in formatting.
- * @param {string[]} excludePaths - Paths to exclude from formatting.
- * @returns {string[]} An array of files that were fixed.
- */
-function runPrettierTools(includePaths = [], excludePaths = []) {
-  let fixedFiles = [];
-
-  const targets = includePaths.length > 0 ? includePaths.map((p) => `"${p}"`).join(' ') : '.';
-
-  // Build a temporary .prettierignore combining the default one + user excludes
-  const defaultIgnorePath = path.join(configDir, '.prettierignore');
-  let ignoreContent = fs.readFileSync(defaultIgnorePath, 'utf-8');
-  if (excludePaths.length > 0) {
-    ignoreContent += '\n# User-specified excludes\n' + excludePaths.join('\n') + '\n';
-  }
-  const tempIgnorePath = path.join(targetDir, '.tz-clean-prettierignore');
-  fs.writeFileSync(tempIgnorePath, ignoreContent);
-
-  try {
-    const prettierOutput = execSync(
-      `npx prettier --write ${targets} --config "${path.join(configDir, '.prettierrc')}" --ignore-path "${tempIgnorePath}" --ignore-unknown`,
-      { encoding: 'utf-8' },
-    );
-    fixedFiles = prettierOutput
-      .split('\n')
-      .filter((line) => line.trim() && !line.includes('(unchanged)'))
-      .map((line) => line.split(' ')[0]);
-  } catch (err) {
-    if (err.stdout) {
-      fixedFiles = err.stdout
-        .split('\n')
-        .filter((line) => line.trim() && !line.includes('(unchanged)'))
-        .map((line) => line.split(' ')[0]);
-    }
-  } finally {
-    if (fs.existsSync(tempIgnorePath)) fs.unlinkSync(tempIgnorePath);
-  }
-  return fixedFiles;
-}
-
-/**
- * Executes TypeScript type checking.
- * @returns {{error: string|null, ran: boolean}} The result of type checking.
- */
-function runTypecheckTools() {
-  let typecheckError = null;
-  let ran = false;
-  if (fs.existsSync(path.join(targetDir, 'tsconfig.json'))) {
-    ran = true;
-    try {
-      execSync(`npx tsc --noEmit`, { stdio: 'ignore' });
-    } catch {
-      typecheckError = 'TypeScript validation failed. Check your types.';
-    }
-  }
-  return { error: typecheckError, ran };
-}
-
-/**
- * Serves the HTML report on localhost.
- * @param {string} html - The HTML string content.
- * @returns {void}
- */
-function serveHostedReport(html) {
-  const port = 8080;
-  const server = http.createServer((req, res) => {
-    res.writeHead(200, { 'Content-Type': 'text/html' });
-    res.end(html);
-  });
-
-  server.listen(port, async () => {
-    const url = `http://localhost:${port}`;
-    console.log(`🚀 Server running at ${url}`);
-    console.log('Press Ctrl+C to stop the server.');
-    await open(url);
-  });
-}
-
-run();
+#!/usr/bin/env node
+import { execSync } from 'child_process';
+import fs from 'fs';
+import http from 'http';
+import open from 'open';
+import path from 'path';
+import prompts from 'prompts';
+import { fileURLToPath } from 'url';
+
+const filename = fileURLToPath(import.meta.url);
+const dirname = path.dirname(filename);
+const configDir = dirname;
+const targetDir = process.cwd();
+
+function buildIgnorePatterns(excludePaths) {
+  const defaults = [
+    new RegExp('node_modules'),
+    new RegExp('\\.min\\.(js|cjs|mjs)$'),
+    new RegExp('\\.bundle\\.js$'),
+    new RegExp('[/\\\\](dist|build|vendor|libs)[/\\\\]'),
+  ];
+  const user = excludePaths.map((p) => new RegExp(p.replace(new RegExp('/', 'g'), '[/\\\\]')));
+  return [...defaults, ...user];
+}
+
+function calculateTotals(reportData) {
+  let totalErrors = 0;
+  let totalWarnings = 0;
+  reportData.forEach((file) => {
+    totalErrors += file.errorCount;
+    totalWarnings += file.warningCount;
+  });
+  return { totalErrors, totalWarnings };
+}
+
+function generateHtmlReport(reportData, fixedFiles) {
+  const templatePath = path.join(configDir, 'report-template.html');
+  let html = fs.readFileSync(templatePath, 'utf-8');
+  html = html.replace('/* REPORT_DATA_PLACEHOLDER */ null', JSON.stringify(reportData));
+  html = html.replace('/* FIXED_FILES_PLACEHOLDER */ []', JSON.stringify(fixedFiles));
+  const outputPath = path.join(targetDir, '.tz-clean-report.html');
+  fs.writeFileSync(outputPath, html);
+  return outputPath;
+}
+
+function parseArgs() {
+  const args = process.argv.slice(2);
+  const runPrettier = !args.includes('--no-prettier');
+  const runEslint = !args.includes('--no-eslint');
+  const runTypecheck = !args.includes('--no-typecheck');
+
+  const excludePaths = [];
+  const includePaths = [];
+
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '--include' && args[i + 1]) {
+      args[i + 1].split(',').forEach((p) => includePaths.push(p.trim()));
+      i++;
+    } else if (args[i] === '--exclude' && args[i + 1]) {
+      args[i + 1].split(',').forEach((p) => excludePaths.push(p.trim()));
+      i++;
+    }
+  }
+
+  const tools = [];
+  if (runPrettier) tools.push('Prettier');
+  if (runEslint) tools.push('ESLint');
+  if (runTypecheck) tools.push('Typecheck');
+
+  return { excludePaths, includePaths, runEslint, runPrettier, runTypecheck, tools };
+}
+
+function printTerminalSummary(reportData, fixedFiles, totalErrors, totalWarnings, typecheckResult) {
+  console.log('\n--- 📊 tz-clean Summary ---');
+  console.log(`Files Analyzed: ${reportData.length}`);
+  console.log(`Errors (Critical) : ${totalErrors > 0 ? '❌ ' + totalErrors : '✅ 0'}`);
+  console.log(`Warnings          : ${totalWarnings > 0 ? '⚠️ ' + totalWarnings : '✅ 0'}`);
+
+  if (!typecheckResult.ran) {
+    console.log(`Typecheck         : ⚠️ Skipped`);
+  } else if (typecheckResult.error) {
+    console.log(`Typecheck         : ❌ ${typecheckResult.error}`);
+  } else {
+    console.log(`Typecheck         : ✅ Passed`);
+  }
+  console.log('---------------------------');
+
+  if (fixedFiles.length > 0) {
+    console.log('\n✨ Auto-Fixed (Formatted):');
+    fixedFiles.forEach((file) => console.log(`  - ${file}`));
+  }
+
+  if (totalErrors > 0 || totalWarnings > 0) {
+    console.log('\n📝 Details:');
+    reportData.forEach((file) => {
+      if (file.errorCount > 0 || file.warningCount > 0) {
+        console.log(`\n📂 ${path.relative(targetDir, file.filePath) || file.filePath}`);
+        file.messages.forEach((msg) => {
+          const severity = msg.severity === 2 ? '❌ Error' : '⚠️ Warning';
+          console.log(`   ${severity} [${msg.line || 0}:${msg.column || 0}] ${msg.message} (${msg.ruleId || ''})`);
+        });
+      }
+    });
+    console.log('\n---------------------------\n');
+  } else {
+    console.log('\n');
+  }
+}
+
+async function run() {
+  const { excludePaths, includePaths, runEslint, runPrettier, runTypecheck, tools } = parseArgs();
+
+  if (tools.length === 0) {
+    console.log('No tools selected to run.');
+    process.exit(0);
+  }
+
+  console.log(`🧹 Running tz-clean (${tools.join(', ')})...`);
+  if (includePaths.length > 0) console.log(`📁 Include: ${includePaths.join(', ')}`);
+  if (excludePaths.length > 0) console.log(`🚫 Exclude: ${excludePaths.join(', ')}`);
+
+  try {
+    process.stdout.write('⏳ [1/4] Running Prettier...');
+    const fixedFiles = runPrettier ? runPrettierTools(includePaths, excludePaths) : [];
+    process.stdout.write(`\r✅ [1/4] Prettier done (${fixedFiles.length} file(s) formatted)         \n`);
+
+    process.stdout.write('⏳ [2/4] Stripping comments...');
+    const strippedFiles = stripCommentsAndEmptyLines(includePaths, excludePaths);
+    process.stdout.write(`\r✅ [2/4] Comments stripped (${strippedFiles.length} file(s) modified)   \n`);
+
+    const allFixedFiles = [...new Set([...fixedFiles, ...strippedFiles])];
+
+    process.stdout.write('⏳ [3/4] Running Typecheck...');
+    const typecheckResult = runTypecheck ? runTypecheckTools() : { error: null, ran: false };
+    let typecheckStatus = 'skipped';
+    if (typecheckResult.ran) {
+      typecheckStatus = typecheckResult.error ? 'failed' : 'passed';
+    }
+    process.stdout.write(`\r✅ [3/4] Typecheck ${typecheckStatus}                                   \n`);
+
+    process.stdout.write('⏳ [4/4] Running ESLint...');
+    const reportData = runEslint ? runEslintTools(includePaths, excludePaths) : [];
+    const { totalErrors, totalWarnings } = calculateTotals(reportData);
+    process.stdout.write(`\r✅ [4/4] ESLint done (${totalErrors} error(s), ${totalWarnings} warning(s))   \n`);
+
+    console.log('\n✅ Analysis complete!');
+    const response = await prompts({
+      choices: [
+        { description: 'Quick overview in terminal', title: 'Terminal Summary', value: 'terminal' },
+        { description: 'Detailed HTML visual report', title: 'UI Dashboard (Browser)', value: 'ui' },
+        { description: 'Serve on localhost port 8080', title: 'UI Dashboard (Hosted)', value: 'hosted' },
+      ],
+      initial: 0,
+      message: 'How would you like to view the analysis report?',
+      name: 'reportType',
+      type: 'select',
+    });
+
+    if (!response.reportType) {
+      console.log('Operation cancelled.');
+      process.exit(0);
+    }
+
+    if (response.reportType === 'terminal') {
+      printTerminalSummary(reportData, allFixedFiles, totalErrors, totalWarnings, typecheckResult);
+    } else if (response.reportType === 'ui') {
+      console.log('⏳ Generating UI Dashboard...');
+      const outputPath = generateHtmlReport(reportData, allFixedFiles);
+      console.log(`🚀 Opening report in browser: ${outputPath}`);
+      await open(outputPath);
+    } else if (response.reportType === 'hosted') {
+      console.log('⏳ Generating Hosted UI Dashboard...');
+      const templatePath = path.join(configDir, 'report-template.html');
+      let html = fs.readFileSync(templatePath, 'utf-8');
+      html = html.replace('/* REPORT_DATA_PLACEHOLDER */ null', JSON.stringify(reportData));
+      html = html.replace('/* FIXED_FILES_PLACEHOLDER */ []', JSON.stringify(allFixedFiles));
+      serveHostedReport(html);
+    }
+  } catch (globalError) {
+    console.error('\n❌ tz-clean encountered a fatal error:', globalError.message);
+    process.exit(1);
+  }
+}
+
+function runEslintTools(includePaths = [], excludePaths = []) {
+  let eslintOutput = '';
+  let reportData = [];
+
+  const targets = includePaths.length > 0 ? includePaths.map((p) => `"${p}"`).join(' ') : '.';
+  const ignoreFlags = excludePaths.map((p) => `--ignore-pattern "${p}"`).join(' ');
+
+  try {
+    eslintOutput = execSync(
+      `npx eslint ${targets} -c "${path.join(configDir, 'eslint.config.mjs')}" -f json ${ignoreFlags}`,
+      {
+        encoding: 'utf-8',
+        maxBuffer: 1024 * 1024 * 10,
+      },
+    );
+  } catch (err) {
+    eslintOutput = err.stdout;
+  }
+
+  if (eslintOutput) {
+    try {
+      reportData = JSON.parse(eslintOutput);
+    } catch (e) {
+      console.error('❌ Failed to parse ESLint output.', e);
+      process.exit(1);
+    }
+  }
+  return reportData;
+}
+
+function runPrettierTools(includePaths = [], excludePaths = []) {
+  let fixedFiles = [];
+
+  const targets = includePaths.length > 0 ? includePaths.map((p) => `"${p}"`).join(' ') : '.';
+  const defaultIgnorePath = path.join(configDir, '.prettierignore');
+  let ignoreContent = fs.readFileSync(defaultIgnorePath, 'utf-8');
+  if (excludePaths.length > 0) {
+    ignoreContent += '\n# User-specified excludes\n' + excludePaths.join('\n') + '\n';
+  }
+  const tempIgnorePath = path.join(targetDir, '.tz-clean-prettierignore');
+  fs.writeFileSync(tempIgnorePath, ignoreContent);
+
+  try {
+    const prettierOutput = execSync(
+      `npx prettier --write ${targets} --config "${path.join(configDir, '.prettierrc')}" --ignore-path "${tempIgnorePath}" --ignore-unknown`,
+      { encoding: 'utf-8' },
+    );
+    fixedFiles = prettierOutput
+      .split('\n')
+      .filter((line) => line.trim() && !line.includes('(unchanged)'))
+      .map((line) => line.split(' ')[0]);
+  } catch (err) {
+    if (err.stdout) {
+      fixedFiles = err.stdout
+        .split('\n')
+        .filter((line) => line.trim() && !line.includes('(unchanged)'))
+        .map((line) => line.split(' ')[0]);
+    }
+  } finally {
+    if (fs.existsSync(tempIgnorePath)) fs.unlinkSync(tempIgnorePath);
+  }
+  return fixedFiles;
+}
+
+function runTypecheckTools() {
+  let typecheckError = null;
+  let ran = false;
+  if (fs.existsSync(path.join(targetDir, 'tsconfig.json'))) {
+    ran = true;
+    try {
+      execSync(`npx tsc --noEmit`, { stdio: 'ignore' });
+    } catch {
+      typecheckError = 'TypeScript validation failed. Check your types.';
+    }
+  }
+  return { error: typecheckError, ran };
+}
+
+function serveHostedReport(html) {
+  const port = 8080;
+  const server = http.createServer((req, res) => {
+    res.writeHead(200, { 'Content-Type': 'text/html' });
+    res.end(html);
+  });
+
+  server.listen(port, async () => {
+    const url = `http://localhost:${port}`;
+    console.log(`🚀 Server running at ${url}`);
+    console.log('Press Ctrl+C to stop the server.');
+    await open(url);
+  });
+}
+
+function skipLineComment(source, startIndex) {
+  let i = startIndex + 2;
+  const len = source.length;
+  while (i < len && source[i] !== '\n') i++;
+  return i;
+}
+
+function skipStringLiteral(source, startIndex) {
+  const quote = source[startIndex];
+  let i = startIndex + 1;
+  const len = source.length;
+  while (i < len) {
+    const sc = source[i];
+    if (sc === '\\') {
+      i += 2;
+      continue;
+    }
+    i++;
+    if (sc === quote) break;
+  }
+  return i;
+}
+
+function stripBlockComment(source, startIndex) {
+  let i = startIndex + 2;
+  const len = source.length;
+  while (i < len) {
+    if (source[i] === '*' && source[i + 1] === '/') return i + 2;
+    i++;
+  }
+  return i;
+}
+
+function stripCommentsAndEmptyLines(includePaths = [], excludePaths = []) {
+  const extensions = ['.cjs', '.js', '.jsx', '.mjs', '.ts', '.tsx'];
+  const ignorePatterns = buildIgnorePatterns(excludePaths);
+  const modifiedFiles = [];
+
+  const scanDir = (dir) => {
+    let entries;
+    try {
+      entries = fs.readdirSync(dir, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    for (const entry of entries) {
+      const fullPath = path.join(dir, entry.name);
+      if (ignorePatterns.some((re) => re.test(fullPath))) continue;
+      if (entry.isDirectory()) {
+        scanDir(fullPath);
+      } else if (entry.isFile() && extensions.includes(path.extname(entry.name))) {
+        const original = fs.readFileSync(fullPath, 'utf-8');
+        let cleaned = stripCommentsFromSource(original);
+        cleaned = cleaned.replace(new RegExp('\\n{3,}', 'g'), '\n\n');
+        cleaned = cleaned.replace(new RegExp('^\\n+'), '');
+        cleaned = cleaned.trimEnd() + '\n';
+        if (cleaned !== original) {
+          fs.writeFileSync(fullPath, cleaned, 'utf-8');
+          modifiedFiles.push(path.relative(targetDir, fullPath));
+        }
+      }
+    }
+  };
+
+  const targets = includePaths.length > 0 ? includePaths.map((p) => path.resolve(targetDir, p)) : [targetDir];
+  targets.forEach((t) => scanDir(t));
+  return modifiedFiles;
+}
+
+function stripCommentsFromSource(source) {
+  let result = '';
+  let i = 0;
+  const len = source.length;
+
+  if (source.startsWith('#!')) {
+    const end = source.indexOf('\n');
+    const shebanEnd = end === -1 ? len : end + 1;
+    result += source.slice(0, shebanEnd);
+    i = shebanEnd;
+  }
+
+  while (i < len) {
+    const ch = source[i];
+
+    if (ch === '"' || ch === "'" || ch === '`') {
+      const start = i;
+      i = skipStringLiteral(source, i);
+      result += source.slice(start, i);
+      continue;
+    }
+
+    if (ch === '/' && source[i + 1] === '*') {
+      i = stripBlockComment(source, i);
+      continue;
+    }
+
+    if (ch === '/' && source[i + 1] === '/') {
+      i = skipLineComment(source, i);
+      continue;
+    }
+
+    result += ch;
+    i++;
+  }
+
+  return result;
+}
+
+run();