component-prune/bin/index.ts

Detect and optionally remove unused UI components in modern frontend frameworks(React, Svelte, Solid)

#!/usr/bin/env node
import { scanComponents } from "../src/scanner.js";
import { analyzeUsage } from "../src/usageAnalyzer.js";
import { removeUnused } from "../src/remover.js";
import { loadIgnorePatterns } from "../src/config.js";
import { writeJSONReport } from "../src/utils.js";

import { Command } from "commander";
import path from "path";

const program = new Command();

program
  .name("component-prune")
  .description("Find and remove unused UI components across frameworks")
  .version("0.1.0")
  .argument("[path]", "directory to scan for components", ".")
  .argument(
    "[components...]",
    "specific components to remove (e.g., calendar.tsx sheet.tsx)"
  )
  .option("--remove", "auto delete unused components")
  .option("--verbose", "output used files optionally")
  .option("--json <path>", "output result to JSON file")
  .parse(process.argv);

(async () => {
  const opts = program.opts();
  const rootDir = path.resolve(program.args[0] || ".");
  const selectedComponents = program.args.slice(1); // Get component names after path
  const ignorePatterns = await loadIgnorePatterns(rootDir);

  const components = await scanComponents(rootDir, ignorePatterns);
  const { used, unused } = await analyzeUsage(components, rootDir);

  // Filter unused components if specific components are provided
  let componentsToRemove = unused;
  if (selectedComponents.length > 0) {
    componentsToRemove = unused.filter((c) =>
      selectedComponents.some(
        (name) =>
          c.filePath.endsWith(name) ||
          c.name === name.replace(path.extname(name), "")
      )
    );
    if (componentsToRemove.length === 0) {
      console.log(
        "🟡 No matching unused components found for the provided names."
      );
      return;
    }
  }

  if (componentsToRemove.length === 0) {
    console.log("🎉 No unused components found.");
  } else {
    console.log(`🛑 Unused components (${componentsToRemove.length})`);
    componentsToRemove.forEach((c) => console.log(`  - ${c.filePath}`));
  }

  if (opts.json) {
    await writeJSONReport(used, componentsToRemove, opts.json);
    console.log(`📄 JSON report saved to ${opts.json}`);
  }

  if (opts.remove && componentsToRemove.length > 0) {
    await removeUnused(componentsToRemove);
    console.log("🧹 Selected unused components deleted.");
  }
})();