pruny 1.22.0 → 1.24.0

package/dist/index.js

@@ -7631,7 +7631,7 @@ var chalkStderr = createChalk({ level: stderrColor ? stderrColor.level : 0 });
 var source_default = chalk;
 
 // src/index.ts
-import { rmSync, existsSync as existsSync7 } from "node:fs";
+import { rmSync, existsSync as existsSync7, readdirSync, lstatSync } from "node:fs";
 import { dirname as dirname4, join as join8 } from "node:path";
 
 // src/scanner.ts
@@ -9193,12 +9193,16 @@ var import_fast_glob2 = __toESM(require_out4(), 1);
 import { readFileSync as readFileSync2, statSync, existsSync as existsSync2 } from "node:fs";
 import { join as join2, dirname, resolve, relative, sep as sep2 } from "node:path";
 async function scanUnusedFiles(config) {
-  const cwd = config.dir;
+  const rootDir = config.appSpecificScan ? config.appSpecificScan.rootDir : config.dir;
+  const searchDir = config.appSpecificScan ? config.appSpecificScan.appDir : config.dir;
   const extensions = config.extensions;
   const extGlob = `**/*{${extensions.join(",")}}`;
+  console.log(`
+   \uD83D\uDD0D Finding source files in: ${searchDir}`);
   const allFiles = await import_fast_glob2.default(extGlob, {
-    cwd,
-    ignore: [...config.ignore.folders, ...config.ignore.files]
+    cwd: searchDir,
+    ignore: [...config.ignore.folders, ...config.ignore.files],
+    absolute: true
   });
   if (allFiles.length === 0) {
     return { total: 0, used: 0, unused: 0, files: [] };
@@ -9245,8 +9249,9 @@ async function scanUnusedFiles(config) {
     "**/api/index.ts"
   ];
   for (const file of allFiles) {
+    const relPath = relative(searchDir, file);
     const isEntry = entryPatterns.some((pattern) => {
-      return minimatch(file, pattern, { dot: true });
+      return minimatch(relPath, pattern, { dot: true });
     });
     if (isEntry)
       entryFiles.add(file);
@@ -9257,9 +9262,9 @@ async function scanUnusedFiles(config) {
   const importRegex = /from\s+['"]([^'"]+)['"]|import\(['"]([^'"]+)['"]\)|require\(['"]([^'"]+)['"]\)/g;
   while (queue.length > 0) {
     const currentFile = queue.shift();
-    const currentDir = dirname(join2(cwd, currentFile));
+    const currentDir = dirname(currentFile);
     try {
-      const content = readFileSync2(join2(cwd, currentFile), "utf-8");
+      const content = readFileSync2(currentFile, "utf-8");
       let match2;
       importRegex.lastIndex = 0;
       while ((match2 = importRegex.exec(content)) !== null) {
@@ -9268,23 +9273,30 @@ async function scanUnusedFiles(config) {
           continue;
         let resolvedFile = null;
         if (imp.startsWith(".")) {
-          resolvedFile = resolveImport(currentDir, imp, extensions, cwd);
+          resolvedFile = resolveImport(currentDir, imp, extensions, rootDir);
         } else if (imp.startsWith("@/") || imp.startsWith("~/")) {
           const aliasPath = imp.substring(2);
-          resolvedFile = resolveImport(cwd, aliasPath, extensions, cwd) || resolveImport(join2(cwd, "src"), aliasPath, extensions, cwd) || resolveImport(join2(cwd, "app"), aliasPath, extensions, cwd);
+          resolvedFile = resolveImport(rootDir, aliasPath, extensions, rootDir) || resolveImport(join2(rootDir, "src"), aliasPath, extensions, rootDir) || resolveImport(join2(rootDir, "app"), aliasPath, extensions, rootDir);
           if (!resolvedFile) {
-            const pathParts = currentFile.split(/[/\\]/);
-            if (pathParts.length >= 2 && (pathParts[0] === "apps" || pathParts[0] === "packages")) {
-              const projectRoot = join2(cwd, pathParts[0], pathParts[1]);
-              resolvedFile = resolveImport(projectRoot, aliasPath, extensions, cwd) || resolveImport(join2(projectRoot, "src"), aliasPath, extensions, cwd) || resolveImport(join2(projectRoot, "app"), aliasPath, extensions, cwd);
+            const pathParts = currentFile.split(sep2);
+            const appsIndex = pathParts.lastIndexOf("apps");
+            const packagesIndex = pathParts.lastIndexOf("packages");
+            const index = Math.max(appsIndex, packagesIndex);
+            if (index !== -1 && index + 1 < pathParts.length) {
+              const projectRoot = pathParts.slice(0, index + 2).join(sep2);
+              resolvedFile = resolveImport(projectRoot, aliasPath, extensions, rootDir) || resolveImport(join2(projectRoot, "src"), aliasPath, extensions, rootDir) || resolveImport(join2(projectRoot, "app"), aliasPath, extensions, rootDir);
             }
           }
         }
-        if (resolvedFile && allFilesSet.has(resolvedFile)) {
-          usedFiles.add(resolvedFile);
-          if (!visited.has(resolvedFile)) {
-            visited.add(resolvedFile);
-            queue.push(resolvedFile);
+        if (resolvedFile) {
+          const absoluteResolved = join2(rootDir, resolvedFile);
+          const absoluteTarget = resolve(rootDir, resolvedFile);
+          if (!visited.has(absoluteTarget) && existsSync2(absoluteTarget) && statSync(absoluteTarget).isFile()) {
+            visited.add(absoluteTarget);
+            usedFiles.add(absoluteTarget);
+            queue.push(absoluteTarget);
+          } else {
+            usedFiles.add(absoluteTarget);
           }
         }
       }
@@ -9293,15 +9305,15 @@ async function scanUnusedFiles(config) {
   const unusedResults = [];
   for (const file of allFiles) {
     if (!usedFiles.has(file)) {
-      const fullPath = join2(cwd, file);
+      const displayPath = relative(rootDir, file);
       try {
-        const stats = statSync(fullPath);
+        const stats = statSync(file);
         unusedResults.push({
-          path: file,
+          path: displayPath,
           size: stats.size
         });
       } catch {
-        unusedResults.push({ path: file, size: 0 });
+        unusedResults.push({ path: displayPath, size: 0 });
       }
     }
   }
@@ -9337,7 +9349,7 @@ function resolveImport(baseDir, impPath, extensions, rootDir) {
 // src/scanners/unused-exports.ts
 var import_fast_glob3 = __toESM(require_out4(), 1);
 import { readFileSync as readFileSync3 } from "node:fs";
-import { join as join3 } from "node:path";
+import { join as join3, relative as relative2 } from "node:path";
 import { Worker } from "node:worker_threads";
 import { fileURLToPath } from "node:url";
 import { dirname as dirname2 } from "node:path";
@@ -9440,42 +9452,66 @@ async function scanUnusedExports(config) {
   const cwd = config.dir;
   const extensions = config.extensions;
   const extGlob = `**/*{${extensions.join(",")}}`;
-  const allFiles = await import_fast_glob3.default(extGlob, {
-    cwd,
-    ignore: [...config.ignore.folders, ...config.ignore.files]
+  const candidateCwd = config.appSpecificScan ? config.appSpecificScan.appDir : cwd;
+  const referenceCwd = config.appSpecificScan ? config.appSpecificScan.rootDir : cwd;
+  console.log(`
+   \uD83D\uDD0D Finding export candidates in: ${candidateCwd}`);
+  console.log(`   \uD83C\uDF0D Checking usage in global scope: ${referenceCwd}
+`);
+  const candidateFiles = await import_fast_glob3.default(extGlob, {
+    cwd: candidateCwd,
+    ignore: [...config.ignore.folders, ...config.ignore.files],
+    absolute: true
   });
-  if (allFiles.length === 0) {
+  if (candidateFiles.length === 0) {
     return { total: 0, used: 0, unused: 0, exports: [] };
   }
+  const referenceFiles = await import_fast_glob3.default(extGlob, {
+    cwd: referenceCwd,
+    ignore: [...config.ignore.folders, ...config.ignore.files],
+    absolute: true
+  });
   const exportMap = new Map;
   const totalContents = new Map;
   let allExportsCount = 0;
   const inlineExportRegex = /^export\s+(?:async\s+)?(?:const|let|var|function|type|interface|enum|class)\s+([a-zA-Z0-9_$]+)/gm;
   const blockExportRegex = /^export\s*\{([^}]+)\}/gm;
-  const USE_WORKERS = allFiles.length >= 500;
+  const USE_WORKERS = referenceFiles.length >= 500;
   const WORKER_COUNT = 2;
   if (USE_WORKERS) {
-    console.log(`\uD83D\uDCDD Scanning ${allFiles.length} files for exports (using ${WORKER_COUNT} workers)...`);
-    const result = await processFilesInParallel(allFiles, cwd, WORKER_COUNT);
-    for (const [file, exports] of result.exportMap.entries()) {
-      exportMap.set(file, exports);
-      allExportsCount += exports.length;
-    }
+    console.log(`\uD83D\uDCDD Scanning ${candidateFiles.length} candidate files for exports & ${referenceFiles.length} files for usage...`);
+    const result = await processFilesInParallel(referenceFiles, referenceCwd, WORKER_COUNT);
     for (const [file, content] of result.contents.entries()) {
       totalContents.set(file, content);
     }
+    const candidateSet = new Set(candidateFiles);
+    for (const [file, exports] of result.exportMap.entries()) {
+      const absoluteFile = file.startsWith("/") ? file : join3(referenceCwd, file);
+      if (candidateSet.has(absoluteFile)) {
+        const displayPath = relative2(config.dir, absoluteFile);
+        const mappedExports = exports.map((e) => ({ ...e, file: displayPath }));
+        exportMap.set(displayPath, mappedExports);
+        allExportsCount += mappedExports.length;
+      }
+    }
   } else {
-    console.log(`\uD83D\uDCDD Scanning ${allFiles.length} files for exports...`);
+    console.log(`\uD83D\uDCDD Scanning ${candidateFiles.length} files for exports...`);
+    for (const file of referenceFiles) {
+      try {
+        const content = readFileSync3(file, "utf-8");
+        totalContents.set(file, content);
+      } catch {}
+    }
     let processedFiles = 0;
-    for (const file of allFiles) {
+    for (const file of candidateFiles) {
       try {
         processedFiles++;
-        if (processedFiles % 10 === 0 || processedFiles === allFiles.length) {
-          const percent = Math.round(processedFiles / allFiles.length * 100);
-          const shortFile = file.length > 50 ? "..." + file.slice(-47) : file;
-          process.stdout.write(`\r   Progress: ${processedFiles}/${allFiles.length} (${percent}%) - ${shortFile}${" ".repeat(10)}`);
+        const displayPath = relative2(config.dir, file);
+        if (processedFiles % 10 === 0 || processedFiles === candidateFiles.length) {
+          const percent = Math.round(processedFiles / candidateFiles.length * 100);
+          process.stdout.write(`\r   Progress: ${processedFiles}/${candidateFiles.length} (${percent}%)`);
         }
-        const content = readFileSync3(join3(cwd, file), "utf-8");
+        const content = totalContents.get(file) || readFileSync3(file, "utf-8");
         totalContents.set(file, content);
         const isService = file.endsWith(".service.ts") || file.endsWith(".service.tsx");
         const lines = content.split(`
@@ -9485,7 +9521,7 @@ async function scanUnusedExports(config) {
           inlineExportRegex.lastIndex = 0;
           let match2;
           while ((match2 = inlineExportRegex.exec(line)) !== null) {
-            if (addExport(file, match2[1], i + 1)) {
+            if (addExport(displayPath, match2[1], i + 1)) {
               allExportsCount++;
             }
           }
@@ -9496,7 +9532,7 @@ async function scanUnusedExports(config) {
               return parts[parts.length - 1];
             });
             for (const name of names) {
-              if (addExport(file, name, i + 1)) {
+              if (addExport(displayPath, name, i + 1)) {
                 allExportsCount++;
               }
             }
@@ -9506,9 +9542,9 @@ async function scanUnusedExports(config) {
             while ((match2 = classMethodRegex.exec(line)) !== null) {
               const name = match2[1];
               if (name && !NEST_LIFECYCLE_METHODS.has(name) && !IGNORED_EXPORT_NAMES.has(name)) {
-                const existing = exportMap.get(file)?.find((e) => e.name === name);
+                const existing = exportMap.get(displayPath)?.find((e) => e.name === name);
                 if (!existing) {
-                  if (addExport(file, name, i + 1)) {
+                  if (addExport(displayPath, name, i + 1)) {
                     allExportsCount++;
                   }
                 }
@@ -9791,20 +9827,30 @@ async function scan(config) {
     "apps/**/app/api/**/route.{ts,tsx,js,jsx}",
     "packages/**/app/api/**/route.{ts,tsx,js,jsx}"
   ];
+  let scanCwd = cwd;
+  let activeNextPatterns = nextPatterns;
+  if (config.appSpecificScan) {
+    scanCwd = config.appSpecificScan.appDir;
+    activeNextPatterns = [
+      "app/api/**/route.{ts,tsx,js,jsx}",
+      "src/app/api/**/route.{ts,tsx,js,jsx}"
+    ];
+  }
   if (config.extraRoutePatterns) {
-    nextPatterns.push(...config.extraRoutePatterns);
+    activeNextPatterns.push(...config.extraRoutePatterns);
   }
-  const nextFiles = await import_fast_glob4.default(nextPatterns, {
-    cwd,
+  const nextFiles = await import_fast_glob4.default(activeNextPatterns, {
+    cwd: scanCwd,
     ignore: config.ignore.folders
   });
   const nextRoutes = nextFiles.map((file) => {
-    const content = readFileSync4(join4(cwd, file), "utf-8");
+    const fullPath = join4(scanCwd, file);
+    const content = readFileSync4(fullPath, "utf-8");
     const { methods, methodLines } = extractExportedMethods(content);
     return {
       type: "nextjs",
       path: extractRoutePath(file),
-      filePath: file,
+      filePath: fullPath.replace(config.appSpecificScan ? config.appSpecificScan.rootDir + "/" : cwd + "/", ""),
       used: false,
       references: [],
       methods,
@@ -9814,12 +9860,14 @@ async function scan(config) {
   });
   const nestPatterns = ["**/*.controller.ts"];
   const nestFiles = await import_fast_glob4.default(nestPatterns, {
-    cwd,
+    cwd: scanCwd,
     ignore: config.ignore.folders
   });
   const nestRoutes = nestFiles.flatMap((file) => {
-    const content = readFileSync4(join4(cwd, file), "utf-8");
-    return extractNestRoutes(file, content, config.nestGlobalPrefix);
+    const fullPath = join4(scanCwd, file);
+    const content = readFileSync4(fullPath, "utf-8");
+    const relativePathFromRoot = fullPath.replace(config.appSpecificScan ? config.appSpecificScan.rootDir + "/" : cwd + "/", "");
+    return extractNestRoutes(relativePathFromRoot, content, config.nestGlobalPrefix);
   });
   const routes = [...nextRoutes, ...nestRoutes];
   const cronPaths = getVercelCronPaths(cwd);
@@ -9831,15 +9879,16 @@ async function scan(config) {
       route.unusedMethods = [];
     }
   }
+  const referenceScanCwd = config.appSpecificScan ? config.appSpecificScan.rootDir : cwd;
   const extGlob = `**/*{${config.extensions.join(",")}}`;
   const sourceFiles = await import_fast_glob4.default(extGlob, {
-    cwd,
+    cwd: referenceScanCwd,
     ignore: [...config.ignore.folders, ...config.ignore.files]
   });
   const allReferences = [];
   const fileReferences = new Map;
   for (const file of sourceFiles) {
-    const filePath = join4(cwd, file);
+    const filePath = join4(referenceScanCwd, file);
     try {
       const content = readFileSync4(filePath, "utf-8");
       const refs = extractApiReferences(content);
@@ -9890,7 +9939,7 @@ async function scan(config) {
 // src/config.ts
 var import_fast_glob5 = __toESM(require_out4(), 1);
 import { existsSync as existsSync4, readFileSync as readFileSync5 } from "node:fs";
-import { join as join5, resolve as resolve2, relative as relative2, dirname as dirname3 } from "node:path";
+import { join as join5, resolve as resolve2, relative as relative3, dirname as dirname3 } from "node:path";
 var DEFAULT_CONFIG = {
   dir: "./",
   ignore: {
@@ -9964,7 +10013,7 @@ function loadConfig(options) {
       const content = readFileSync5(configPath, "utf-8");
       const config = JSON.parse(content);
       const configDir = dirname3(configPath);
-      const relDir = relative2(cwd, configDir);
+      const relDir = relative3(cwd, configDir);
       const prefixPattern = (p) => {
         if (p.startsWith("**/") || p.startsWith("/") || !relDir)
           return p;
@@ -10248,327 +10297,297 @@ program2.command("init").description("Create a default pruny.config.json file").
 });
 program2.action(async (options) => {
   const startTime = Date.now();
-  const config = loadConfig({
-    dir: options.dir,
-    config: options.config,
-    excludePublic: !options.public
-  });
-  const absoluteDir = config.dir.startsWith("/") ? config.dir : join8(process.cwd(), config.dir);
-  config.dir = absoluteDir;
-  if (options.verbose) {
-    console.log("");
-  }
-  console.log(source_default.bold(`
-\uD83D\uDD0D Scanning for unused API routes...
-`));
   try {
-    let result = await scan(config);
-    const getAppName = (filePath) => {
-      if (filePath.startsWith("apps/"))
-        return filePath.split("/").slice(0, 2).join("/");
-      if (filePath.startsWith("packages/"))
-        return filePath.split("/").slice(0, 2).join("/");
-      return "Root";
-    };
-    if (options.filter) {
-      const filter2 = options.filter.toLowerCase();
-      console.log(source_default.blue(`
-\uD83D\uDD0D Filtering results by "${filter2}"...
-`));
-      const matchesFilter = (path2) => {
-        const lowerPath = path2.toLowerCase();
-        const appName = getAppName(path2).toLowerCase();
-        if (appName.includes(filter2))
-          return true;
-        const segments = lowerPath.split("/");
-        for (const segment of segments) {
-          if (segment === filter2)
-            return true;
-          const withoutExt = segment.replace(/\.[^.]+$/, "");
-          if (withoutExt === filter2)
-            return true;
-        }
-        return lowerPath.includes(filter2);
-      };
-      result.routes = result.routes.filter((r) => matchesFilter(r.filePath));
-      if (result.publicAssets) {
-        result.publicAssets.assets = result.publicAssets.assets.filter((a) => matchesFilter(a.path));
-        result.publicAssets.total = result.publicAssets.assets.length;
-        result.publicAssets.used = result.publicAssets.assets.filter((a) => a.used).length;
-        result.publicAssets.unused = result.publicAssets.assets.filter((a) => !a.used).length;
-      }
-      if (result.unusedFiles) {
-        result.unusedFiles.files = result.unusedFiles.files.filter((f) => matchesFilter(f.path));
-        result.unusedFiles.total = result.unusedFiles.files.length;
-        result.unusedFiles.unused = result.unusedFiles.files.length;
-      }
-      if (result.unusedExports) {
-        result.unusedExports.exports = result.unusedExports.exports.filter((e) => matchesFilter(e.file));
-        result.unusedExports.total = result.unusedExports.exports.length;
-        result.unusedExports.unused = result.unusedExports.exports.length;
-      }
-    }
-    if (options.json) {
-      console.log(JSON.stringify(result, null, 2));
-      return;
-    }
-    const partiallyUnusedRoutes = result.routes.filter((r) => r.used && r.unusedMethods.length > 0);
-    if (partiallyUnusedRoutes.length > 0) {
-      console.log(source_default.yellow.bold(`⚠️  Partially Unused API Routes:
-`));
-      for (const route of partiallyUnusedRoutes) {
-        console.log(source_default.yellow(`   ${route.path}`));
-        console.log(source_default.red(`      ❌ Unused: ${route.unusedMethods.join(", ")}`));
-        console.log(source_default.dim(`      → ${route.filePath}`));
-      }
+    const baseConfig = loadConfig({
+      dir: options.dir,
+      config: options.config,
+      excludePublic: !options.public
+    });
+    const absoluteDir = baseConfig.dir.startsWith("/") ? baseConfig.dir : join8(process.cwd(), baseConfig.dir);
+    baseConfig.dir = absoluteDir;
+    if (options.verbose)
       console.log("");
-    }
-    const unusedRoutes = result.routes.filter((r) => !r.used);
-    if (unusedRoutes.length > 0) {
-      console.log(source_default.red.bold(`❌ Unused API Routes (Fully Unused):
+    console.log(source_default.bold(`
+\uD83D\uDD0D Scanning for unused API routes...
 `));
-      for (const route of unusedRoutes) {
-        const methods = route.methods.length > 0 ? ` (${route.methods.join(", ")})` : "";
-        console.log(source_default.red(`   ${route.path}${source_default.dim(methods)}`));
-        console.log(source_default.dim(`      → ${route.filePath}`));
-      }
-      console.log("");
-    }
-    if (result.publicAssets) {
-      const unusedAssets = result.publicAssets.assets.filter((a) => !a.used);
-      if (unusedAssets.length > 0) {
-        console.log(source_default.red.bold(`\uD83D\uDDBC️  Unused Public Assets:
+    const appsDir = join8(absoluteDir, "apps");
+    const isMonorepo = existsSync7(appsDir) && lstatSync(appsDir).isDirectory();
+    const appsToScan = [];
+    if (isMonorepo) {
+      const apps = readdirSync(appsDir);
+      for (const app of apps) {
+        const appPath = join8(appsDir, app);
+        if (lstatSync(appPath).isDirectory()) {
+          appsToScan.push(app);
+        }
+      }
+      console.log(source_default.bold(`
+\uD83C\uDFE2 Monorepo Detected. Found ${appsToScan.length} apps: ${appsToScan.join(", ")}
 `));
-        for (const asset of unusedAssets) {
-          console.log(source_default.red(`   ${asset.relativePath}`));
-          console.log(source_default.dim(`      → ${asset.path}`));
-        }
-        console.log("");
+    } else {
+      appsToScan.push("root");
+    }
+    for (const appName of appsToScan) {
+      const currentConfig = { ...baseConfig };
+      let appLabel = "Root App";
+      let appDir = absoluteDir;
+      if (isMonorepo) {
+        appLabel = `App: ${appName}`;
+        appDir = join8(absoluteDir, "apps", appName);
+        currentConfig.appSpecificScan = {
+          appDir,
+          rootDir: absoluteDir
+        };
       }
-    }
-    if (result.unusedFiles && result.unusedFiles.files.length > 0) {
-      console.log(source_default.red.bold(`\uD83D\uDCC4 Unused Source Files:
-`));
-      for (const file of result.unusedFiles.files) {
-        const sizeKb = (file.size / 1024).toFixed(1);
-        console.log(source_default.red(`   ${file.path} ${source_default.dim(`(${sizeKb} KB)`)}`));
+      console.log(source_default.bold.magenta(`
+\uD83D\uDC49 Scanning ${appLabel}...`));
+      let result = await scan(currentConfig);
+      logScanStats(result, appLabel);
+      if (options.filter) {
+        filterResults(result, options.filter);
       }
-      console.log("");
-    }
-    if (result.unusedExports && result.unusedExports.exports.length > 0) {
-      console.log(source_default.red.bold(`\uD83D\uDD17 Unused Named Exports/Methods:
+      if (options.json) {
+        console.log(JSON.stringify(result, null, 2));
+      } else {
+        if (options.fix) {
+          await handleFixes(result, currentConfig, options);
+        } else if (hasUnusedItems(result)) {
+          console.log(source_default.dim(`\uD83D\uDCA1 Run with --fix to clean up.
 `));
-      for (const exp of result.unusedExports.exports) {
-        console.log(source_default.red(`   ${exp.name}`));
-        console.log(source_default.dim(`      → ${exp.file}:${exp.line}`));
+        }
+        printSummaryTable(result, appLabel);
       }
-      console.log("");
     }
-    if (unusedRoutes.length === 0 && partiallyUnusedRoutes.length === 0 && (!result.publicAssets || result.publicAssets.unused === 0)) {
-      console.log(source_default.green(`✅ Everything is used! Clean as a whistle.
+  } catch (err) {
+    console.error(source_default.red("Error scanning:"), err);
+    process.exit(1);
+  }
+  const elapsed = ((Date.now() - startTime) / 1000).toFixed(2);
+  console.log(source_default.dim(`
+⏱️  Completed in ${elapsed}s`));
+});
+program2.parse();
+function logScanStats(result, context) {
+  console.log(source_default.blue.bold(`\uD83D\uDCCA stats for ${context}:`));
+  console.log(source_default.blue(`   • API Routes:    ${result.total}`));
+  if (result.publicAssets) {
+    console.log(source_default.blue(`   • Public Assets: ${result.publicAssets.total}`));
+  }
+  if (result.unusedFiles) {
+    console.log(source_default.blue(`   • Source Files:  ${result.unusedFiles.total}`));
+  }
+  if (result.unusedExports) {
+    console.log(source_default.blue(`   • Exported Items: ${result.unusedExports.total}`));
+  }
+  console.log("");
+}
+function filterResults(result, filterPattern) {
+  const filter2 = filterPattern.toLowerCase();
+  console.log(source_default.blue(`\uD83D\uDD0D Filtering results by "${filter2}"...
 `));
+  const getAppName = (filePath) => {
+    if (filePath.startsWith("apps/"))
+      return filePath.split("/").slice(0, 2).join("/");
+    if (filePath.startsWith("packages/"))
+      return filePath.split("/").slice(0, 2).join("/");
+    return "Root";
+  };
+  const matchesFilter = (path2) => {
+    const lowerPath = path2.toLowerCase();
+    const appName = getAppName(path2).toLowerCase();
+    if (appName.includes(filter2))
+      return true;
+    const segments = lowerPath.split("/");
+    for (const segment of segments) {
+      if (segment === filter2)
+        return true;
+      const withoutExt = segment.replace(/\.[^.]+$/, "");
+      if (withoutExt === filter2)
+        return true;
     }
-    if (options.fix) {
-      let fixedSomething = false;
-      if (unusedRoutes.length > 0) {
-        console.log(source_default.yellow.bold(`\uD83D\uDDD1️  Deleting unused routes...
+    return lowerPath.includes(filter2);
+  };
+  result.routes = result.routes.filter((r) => matchesFilter(r.filePath));
+  if (result.publicAssets) {
+    result.publicAssets.assets = result.publicAssets.assets.filter((a) => matchesFilter(a.path));
+    result.publicAssets.total = result.publicAssets.assets.length;
+    result.publicAssets.used = result.publicAssets.assets.filter((a) => a.used).length;
+    result.publicAssets.unused = result.publicAssets.assets.filter((a) => !a.used).length;
+  }
+  if (result.unusedFiles) {
+    result.unusedFiles.files = result.unusedFiles.files.filter((f) => matchesFilter(f.path));
+    result.unusedFiles.total = result.unusedFiles.files.length;
+    result.unusedFiles.unused = result.unusedFiles.files.length;
+  }
+  if (result.unusedExports) {
+    result.unusedExports.exports = result.unusedExports.exports.filter((e) => matchesFilter(e.file));
+    result.unusedExports.total = result.unusedExports.exports.length;
+    result.unusedExports.unused = result.unusedExports.exports.length;
+  }
+  result.total = result.routes.length;
+  result.used = result.routes.filter((r) => r.used).length;
+  result.unused = result.routes.filter((r) => !r.used).length;
+}
+function hasUnusedItems(result) {
+  const unusedRoutes = result.routes.filter((r) => !r.used).length;
+  const partialRoutes = result.routes.filter((r) => r.used && r.unusedMethods.length > 0).length;
+  const unusedAssets = result.publicAssets ? result.publicAssets.unused : 0;
+  const unusedFiles = result.unusedFiles ? result.unusedFiles.unused : 0;
+  const unusedExports = result.unusedExports ? result.unusedExports.unused : 0;
+  return unusedRoutes > 0 || partialRoutes > 0 || unusedAssets > 0 || unusedFiles > 0 || unusedExports > 0;
+}
+async function handleFixes(result, config, options) {
+  let fixedSomething = false;
+  const unusedRoutes = result.routes.filter((r) => !r.used);
+  if (unusedRoutes.length > 0) {
+    console.log(source_default.yellow.bold(`\uD83D\uDDD1️  Deleting unused routes...
 `));
-        const routesByFile = new Map;
-        for (const r of unusedRoutes) {
-          const list = routesByFile.get(r.filePath) || [];
-          list.push(r);
-          routesByFile.set(r.filePath, list);
-        }
-        for (const [filePath, fileRoutes] of routesByFile) {
-          const fullPath = join8(config.dir, filePath);
-          if (!existsSync7(fullPath))
-            continue;
-          const route = fileRoutes[0];
-          const routeDir = dirname4(fullPath);
-          try {
-            if (route.type === "nextjs") {
-              if (filePath.includes("app/api") || filePath.includes("pages/api")) {
-                rmSync(routeDir, { recursive: true, force: true });
-                console.log(source_default.red(`   Deleted Folder: ${routeDir}`));
-              } else {
-                rmSync(fullPath, { force: true });
-                console.log(source_default.red(`   Deleted File: ${filePath}`));
-              }
-              fixedSomething = true;
-            } else if (route.type === "nestjs") {
-              const isInternallyUnused = result.unusedFiles?.files.some((f) => f.path === filePath);
-              if (isInternallyUnused || filePath.includes("api/")) {
-                rmSync(fullPath, { force: true });
-                console.log(source_default.red(`   Deleted File: ${filePath}`));
-                fixedSomething = true;
-              } else {
-                console.log(source_default.yellow(`   Skipped File Deletion (internally used): ${filePath}`));
-                const allMethodsToPrune = [];
-                for (const r of fileRoutes) {
-                  for (const m of r.unusedMethods) {
-                    if (r.methodLines[m] !== undefined) {
-                      allMethodsToPrune.push({ method: m, line: r.methodLines[m] });
-                    }
-                  }
-                }
-                allMethodsToPrune.sort((a, b) => b.line - a.line);
-                for (const { method, line } of allMethodsToPrune) {
-                  if (removeMethodFromRoute(config.dir, filePath, method, line)) {
-                    console.log(source_default.green(`      Fixed: Removed ${method} from ${filePath}`));
-                    fixedSomething = true;
-                  }
+    const routesByFile = new Map;
+    for (const r of unusedRoutes) {
+      const list = routesByFile.get(r.filePath) || [];
+      list.push(r);
+      routesByFile.set(r.filePath, list);
+    }
+    for (const [filePath, fileRoutes] of routesByFile) {
+      const fullPath = join8(config.dir, filePath);
+      if (!existsSync7(fullPath))
+        continue;
+      const route = fileRoutes[0];
+      const routeDir = dirname4(fullPath);
+      try {
+        if (route.type === "nextjs") {
+          if (filePath.includes("app/api") || filePath.includes("pages/api")) {
+            rmSync(routeDir, { recursive: true, force: true });
+            console.log(source_default.red(`   Deleted Folder: ${routeDir}`));
+          } else {
+            rmSync(fullPath, { force: true });
+            console.log(source_default.red(`   Deleted File: ${filePath}`));
+          }
+          fixedSomething = true;
+        } else if (route.type === "nestjs") {
+          const isInternallyUnused = result.unusedFiles?.files.some((f) => f.path === filePath);
+          if (isInternallyUnused || filePath.includes("api/")) {
+            rmSync(fullPath, { force: true });
+            console.log(source_default.red(`   Deleted File: ${filePath}`));
+            fixedSomething = true;
+          } else {
+            console.log(source_default.yellow(`   Skipped File Deletion (internally used): ${filePath}`));
+            const allMethodsToPrune = [];
+            for (const r of fileRoutes) {
+              for (const m of r.unusedMethods) {
+                if (r.methodLines[m] !== undefined) {
+                  allMethodsToPrune.push({ method: m, line: r.methodLines[m] });
                 }
               }
-            } else {
-              rmSync(fullPath, { force: true });
-              console.log(source_default.red(`   Deleted File: ${filePath}`));
-              fixedSomething = true;
             }
-            for (const r of fileRoutes) {
-              const idx = result.routes.indexOf(r);
-              if (idx !== -1)
-                result.routes.splice(idx, 1);
+            allMethodsToPrune.sort((a, b) => b.line - a.line);
+            for (const { method, line } of allMethodsToPrune) {
+              if (removeMethodFromRoute(config.dir, filePath, method, line)) {
+                console.log(source_default.green(`      Fixed: Removed ${method} from ${filePath}`));
+                fixedSomething = true;
+              }
             }
-          } catch (err) {
-            console.log(source_default.yellow(`   Failed to fix: ${filePath}`));
           }
+        } else {
+          rmSync(fullPath, { force: true });
+          console.log(source_default.red(`   Deleted File: ${filePath}`));
+          fixedSomething = true;
         }
-        console.log("");
-      }
-      const partiallyRoutes = result.routes.filter((r) => r.used && r.unusedMethods && r.unusedMethods.length > 0);
-      if (partiallyRoutes.length > 0) {
-        console.log(source_default.yellow.bold(`\uD83D\uDD27 Fixing partially unused routes...
-`));
-        for (const route of partiallyRoutes) {
-          const sortedMethods = [...route.unusedMethods].filter((m) => route.methodLines[m] !== undefined).sort((a, b) => route.methodLines[b] - route.methodLines[a]);
-          let fixedCount = 0;
-          for (const method of sortedMethods) {
-            const lineNum = route.methodLines[method];
-            if (removeMethodFromRoute(config.dir, route.filePath, method, lineNum)) {
-              console.log(source_default.green(`   Fixed: Removed ${method} from ${route.path}`));
-              fixedCount++;
-              fixedSomething = true;
-            }
-          }
-          if (fixedCount === route.methods.length) {
-            const idx = result.routes.indexOf(route);
-            if (idx !== -1)
-              result.routes.splice(idx, 1);
-          } else {
-            route.unusedMethods = route.unusedMethods.filter((m) => !sortedMethods.includes(m));
-          }
+        for (const r of fileRoutes) {
+          const idx = result.routes.indexOf(r);
+          if (idx !== -1)
+            result.routes.splice(idx, 1);
         }
-        console.log("");
+      } catch (err) {
+        console.log(source_default.yellow(`   Failed to fix: ${filePath}`));
       }
-      if (result.unusedFiles && result.unusedFiles.files.length > 0) {
-        console.log(source_default.yellow.bold(`\uD83D\uDDD1️  Deleting unused source files...
+    }
+    console.log("");
+  }
+  const partiallyRoutes = result.routes.filter((r) => r.used && r.unusedMethods && r.unusedMethods.length > 0);
+  if (partiallyRoutes.length > 0) {
+    console.log(source_default.yellow.bold(`\uD83D\uDD27 Fixing partially unused routes...
 `));
-        for (const file of result.unusedFiles.files) {
-          try {
-            const fullPath = join8(config.dir, file.path);
-            if (!existsSync7(fullPath))
-              continue;
-            rmSync(fullPath, { force: true });
-            console.log(source_default.red(`   Deleted: ${file.path}`));
-            fixedSomething = true;
-          } catch (_err) {
-            console.log(source_default.yellow(`   Failed to delete: ${file.path}`));
-          }
-        }
-        result.unusedFiles.files = [];
-        result.unusedFiles.unused = 0;
-        console.log("");
-      }
-      if (result.unusedExports && result.unusedExports.exports.length > 0) {
-        fixedSomething = await fixUnusedExports(result, config) || fixedSomething;
+    for (const route of partiallyRoutes) {
+      const sortedMethods = [...route.unusedMethods].filter((m) => route.methodLines[m] !== undefined).sort((a, b) => route.methodLines[b] - route.methodLines[a]);
+      let fixedCount = 0;
+      for (const method of sortedMethods) {
+        const lineNum = route.methodLines[method];
+        if (removeMethodFromRoute(config.dir, route.filePath, method, lineNum)) {
+          console.log(source_default.green(`   Fixed: Removed ${method} from ${route.path}`));
+          fixedCount++;
+          fixedSomething = true;
+        }
+      }
+      if (fixedCount === route.methods.length) {
+        const idx = result.routes.indexOf(route);
+        if (idx !== -1)
+          result.routes.splice(idx, 1);
+      } else {
+        route.unusedMethods = route.unusedMethods.filter((m) => !sortedMethods.includes(m));
       }
-      if (fixedSomething) {
-        console.log(source_default.cyan.bold(`
-\uD83D\uDD04 Checking for cascading dead code (newly unused implementation)...`));
-        const secondPass = await scanUnusedExports(config);
-        if (options.filter) {
-          const filter2 = options.filter.toLowerCase();
-          const matchesFilterPass2 = (path2) => {
-            const lowerPath = path2.toLowerCase();
-            const appName = getAppName(path2).toLowerCase();
-            if (appName.includes(filter2))
-              return true;
-            const segments = lowerPath.split("/");
-            for (const segment of segments) {
-              if (segment === filter2)
-                return true;
-              const withoutExt = segment.replace(/\.[^.]+$/, "");
-              if (withoutExt === filter2)
-                return true;
-            }
-            return lowerPath.includes(filter2);
-          };
-          secondPass.exports = secondPass.exports.filter((e) => matchesFilterPass2(e.file));
-          secondPass.total = secondPass.exports.length;
-          secondPass.unused = secondPass.exports.length;
-        }
-        if (secondPass.unused > 0) {
-          console.log(source_default.yellow(`   Found ${secondPass.unused} newly unused items/methods after pruning.
+    }
+    console.log("");
+  }
+  if (result.unusedFiles && result.unusedFiles.files.length > 0) {
+    console.log(source_default.yellow.bold(`\uD83D\uDDD1️  Deleting unused source files...
 `));
-          result.unusedExports = secondPass;
-          await fixUnusedExports(result, config);
-        }
-      }
-      if (fixedSomething) {
-        result.unused = result.routes.filter((r) => !r.used).length;
-        result.used = result.routes.filter((r) => r.used).length;
-        result.total = result.routes.length;
+    for (const file of result.unusedFiles.files) {
+      try {
+        const fullPath = join8(config.dir, file.path);
+        if (!existsSync7(fullPath))
+          continue;
+        rmSync(fullPath, { force: true });
+        console.log(source_default.red(`   Deleted: ${file.path}`));
+        fixedSomething = true;
+      } catch (_err) {
+        console.log(source_default.yellow(`   Failed to delete: ${file.path}`));
       }
-    } else if (unusedRoutes.length > 0 || result.unusedExports && result.unusedExports.exports.length > 0 || result.unusedFiles && result.unusedFiles.files.length > 0) {
-      console.log(source_default.dim(`\uD83D\uDCA1 Run with --fix to automatically clean up unused routes, files, and exports.
-`));
     }
-    console.log(source_default.bold(`\uD83D\uDCCA Summary Report
+    result.unusedFiles.files = [];
+    result.unusedFiles.unused = 0;
+    console.log("");
+  }
+  if (result.unusedExports && result.unusedExports.exports.length > 0) {
+    fixedSomething = await fixUnusedExports(result, config) || fixedSomething;
+  }
+  if (fixedSomething) {
+    console.log(source_default.cyan.bold(`
+\uD83D\uDD04 Checking for cascading dead code (newly unused implementation)...`));
+    const secondPass = await scanUnusedExports(config);
+    if (options.filter) {
+      const filter2 = options.filter.toLowerCase();
+      const getAppName = (filePath) => {
+        if (filePath.startsWith("apps/"))
+          return filePath.split("/").slice(0, 2).join("/");
+        if (filePath.startsWith("packages/"))
+          return filePath.split("/").slice(0, 2).join("/");
+        return "Root";
+      };
+      const matchesFilter = (path2) => {
+        const lowerPath = path2.toLowerCase();
+        const appName = getAppName(path2).toLowerCase();
+        if (appName.includes(filter2))
+          return true;
+        return lowerPath.includes(filter2);
+      };
+      secondPass.exports = secondPass.exports.filter((e) => matchesFilter(e.file));
+      secondPass.total = secondPass.exports.length;
+      secondPass.unused = secondPass.exports.length;
+    }
+    if (secondPass.unused > 0) {
+      console.log(source_default.yellow(`   Found ${secondPass.unused} newly unused items/methods after pruning.
 `));
-    const summary = [];
-    const groupedRoutes = new Map;
-    for (const route of result.routes) {
-      const keyAppName = getAppName(route.filePath);
-      const key = `${keyAppName}::${route.type}`;
-      if (!groupedRoutes.has(key)) {
-        groupedRoutes.set(key, { type: route.type, app: keyAppName, routes: [] });
-      }
-      groupedRoutes.get(key).routes.push(route);
-    }
-    const sortedKeys = Array.from(groupedRoutes.keys()).sort((a, b) => {
-      const [appA, typeA] = a.split("::");
-      const [appB, typeB] = b.split("::");
-      if (typeA !== typeB)
-        return typeA === "nextjs" ? -1 : 1;
-      return appA.localeCompare(appB);
-    });
-    for (const key of sortedKeys) {
-      const group = groupedRoutes.get(key);
-      const typeLabel = group.type === "nextjs" ? "Next.js" : "NestJS";
-      summary.push({
-        Category: `${typeLabel} (${group.app})`,
-        Total: group.routes.length,
-        Used: group.routes.filter((r) => r.used).length,
-        Unused: group.routes.filter((r) => !r.used).length
-      });
+      result.unusedExports = secondPass;
+      await fixUnusedExports(result, config);
     }
-    if (summary.length === 0)
-      summary.push({ Category: "API Routes", Total: result.total, Used: result.used, Unused: result.unused });
-    if (result.publicAssets)
-      summary.push({ Category: "Public Assets", Total: result.publicAssets.total, Used: result.publicAssets.used, Unused: result.publicAssets.unused });
-    if (result.unusedFiles)
-      summary.push({ Category: "Source Files", Total: result.unusedFiles.total, Used: result.unusedFiles.used, Unused: result.unusedFiles.unused });
-    if (result.unusedExports)
-      summary.push({ Category: "Exported Items", Total: result.unusedExports.total, Used: result.unusedExports.used, Unused: result.unusedExports.unused });
-    console.table(summary);
-  } catch (_err) {
-    console.error(source_default.red("Error scanning:"), _err);
-    process.exit(1);
   }
-  const elapsed = ((Date.now() - startTime) / 1000).toFixed(2);
-  console.log(source_default.dim(`
-⏱️  Completed in ${elapsed}s`));
-});
+  if (fixedSomething) {
+    result.unused = result.routes.filter((r) => !r.used).length;
+    result.used = result.routes.filter((r) => r.used).length;
+    result.total = result.routes.length;
+  }
+}
 async function fixUnusedExports(result, config) {
   if (!result.unusedExports || result.unusedExports.exports.length === 0)
     return false;
@@ -10606,4 +10625,50 @@ async function fixUnusedExports(result, config) {
 `));
   return fixedSomething;
 }
-program2.parse();
+function printSummaryTable(result, context) {
+  console.log(source_default.bold(`\uD83D\uDCCA Summary Report for ${context}
+`));
+  const summary = [];
+  const groupedRoutes = new Map;
+  const getAppName = (filePath) => {
+    if (filePath.startsWith("apps/"))
+      return filePath.split("/").slice(0, 2).join("/");
+    if (filePath.startsWith("packages/"))
+      return filePath.split("/").slice(0, 2).join("/");
+    return "Root";
+  };
+  for (const route of result.routes) {
+    const keyAppName = getAppName(route.filePath);
+    const key = `${keyAppName}::${route.type}`;
+    if (!groupedRoutes.has(key)) {
+      groupedRoutes.set(key, { type: route.type, app: keyAppName, routes: [] });
+    }
+    groupedRoutes.get(key).routes.push(route);
+  }
+  const sortedKeys = Array.from(groupedRoutes.keys()).sort((a, b) => {
+    const [appA, typeA] = a.split("::");
+    const [appB, typeB] = b.split("::");
+    if (typeA !== typeB)
+      return typeA === "nextjs" ? -1 : 1;
+    return appA.localeCompare(appB);
+  });
+  for (const key of sortedKeys) {
+    const group = groupedRoutes.get(key);
+    const typeLabel = group.type === "nextjs" ? "Next.js" : "NestJS";
+    summary.push({
+      Category: `${typeLabel} (${group.app})`,
+      Total: group.routes.length,
+      Used: group.routes.filter((r) => r.used).length,
+      Unused: group.routes.filter((r) => !r.used).length
+    });
+  }
+  if (summary.length === 0)
+    summary.push({ Category: "API Routes", Total: result.total, Used: result.used, Unused: result.unused });
+  if (result.publicAssets)
+    summary.push({ Category: "Public Assets", Total: result.publicAssets.total, Used: result.publicAssets.used, Unused: result.publicAssets.unused });
+  if (result.unusedFiles)
+    summary.push({ Category: "Source Files", Total: result.unusedFiles.total, Used: result.unusedFiles.used, Unused: result.unusedFiles.unused });
+  if (result.unusedExports)
+    summary.push({ Category: "Exported Items", Total: result.unusedExports.total, Used: result.unusedExports.used, Unused: result.unusedExports.unused });
+  console.table(summary);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pruny",
-  "version": "1.22.0",
+  "version": "1.24.0",
   "description": "Find and remove unused Next.js API routes & Nest.js Controllers",
   "type": "module",
   "files": [