rev-dep 2.1.0 → 2.2.0

package/Readme.md

@@ -1,11 +1,10 @@
 <p align="center">
-<img src="https://github.com/jayu/rev-dep/raw/master/logo.png" width="400">
+<img src="https://github.com/jayu/rev-dep/raw/master/logo.png" width="400" alt="Rev-dep logo">
 </p>
 
 <p align="center">
   <a href="#key-features-">Key Features</a>&nbsp;&nbsp;•&nbsp;&nbsp;  
   <a href="#installation-">Installation</a>&nbsp;&nbsp;•&nbsp;&nbsp; 
-  <a href="#quick-examples-">Quick Examples</a>&nbsp;&nbsp;•&nbsp;&nbsp; 
   <a href="#practical-examples-">Practical Examples</a>&nbsp;&nbsp;•&nbsp;&nbsp; 
   <a href="#cli-reference-">CLI Reference</a>
 </p>
@@ -18,11 +17,9 @@
 
 ---
 
-<img alt="rev-dep version" src="https://img.shields.io/npm/v/rev-dep">
-<img alt="rev-dep license" src="https://img.shields.io/npm/l/rev-dep">
-<img alt="rev-dep PRs welcome" src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square">
+<img alt="rev-dep version" src="https://img.shields.io/npm/v/rev-dep"> <img alt="rev-dep license" src="https://img.shields.io/npm/l/rev-dep"> <img alt="rev-dep PRs welcome" src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square">
+
 
----
 
 # **About 📣**
 
@@ -35,15 +32,14 @@ Working in large JS/TS projects makes it difficult to answer simple but crucial
 * Which packages in node_modules are unused?
 * Which modules take the most disk space?
 
-rev-dep helps you understand the real structure of your codebase so you can debug issues faster, refactor safely, and keep your dependencies clean.
+Rev-dep helps you understand the real structure of your codebase so you can debug issues faster, refactor safely, and keep your dependencies clean.
 
 It's particularly useful for JavaScript projects without TypeScript or test coverage — places where answering question "What will break if I change this" is not straightforward  
 
----
 
-## **Why rev-dep? 🤔**
+## **Why Rev-dep? 🤔**
 
-rev-dep is designed for **fast iteration** and **minimal, actionable results** — no noise, just answers.
+Rev-dep is designed for **fast iteration** and **minimal, actionable results** — no noise, just answers.
 
 ### ✅ **Results in milliseconds**
 
@@ -61,35 +57,27 @@ Works with mixed JS/TS projects, path aliases and thousands of files without con
 
 Unused files, unused or missing dependencies, reverse-imports, entry point detection, node_modules insights, dependency paths — everything in one tool.
 
-<!--
-### ✔ **Much faster than alternatives**
 
-rev-dep outperforms Madge, dpdm, dependency-cruiser, skott, knip, depcheck and other similar tools. 
+### ✅ **Much faster than alternatives**
 
-For 500k+ lines of code and 6k+ source code files get checks as fast as:
-
-| Task | Execution Time |
-|------|----------------|
-| Find circular dependencies | |
-| Find unused files | |
-| Find unused node modules | |
-| Find missing node modules | |
-| Trace reverse dependencies for a file | |
-| Trace full dependency paths | |
-| List all files imported by an entry point | |
-| Discover entry points | |
-| Count lines of code | |
-| Check node_modules disk usage | |
-| Analyze node_modules directory sizes | |
-| List file-to-file dependency graph | |
-
->Benchmark run on WSL Linux Debian Intel(R) Core(TM) i9-14900KF CPU @ 2.80GHz
+Rev-dep outperforms Madge, dpdm, dependency-cruiser, skott, knip, depcheck and other similar tools. 
 
---->
+For large project with 500k+ lines of code and 6k+ source code files get checks as fast as:
 
-If your project feels like a dependency maze, rev-dep gives you a map.
+| Task | Execution Time [ms] | Alternative | Alternative Time [ms] | Slower Than Rev-dep | 
+|------|-------|--------------|------|----|
+| Find circular dependencies | 289 | dpdm-fast | 7061|  24x|
+| Find unused files | 588 | knip | 6346 | 11x |
+| Find unused node modules | 594 | knip | 6230 | 10x |
+| Find missing node modules | 553 | knip| 6226 | 11x |
+| List all files imported by an entry point | 229 | madge | 4467 | 20x | 
+| Discover entry points | 323 | madge | 67000 | 207x
+| Resolve dependency path between files | 228 | please suggest | 
+| Count lines of code | 342 | please suggest | 
+| Check node_modules disk usage | 1619 | please suggest | 
+| Analyze node_modules directory sizes | 521 | please suggest | 
 
----
+>Benchmark run on WSL Linux Debian Intel(R) Core(TM) i9-14900KF CPU @ 2.80GHz
 
 # **Key Features 🚀**
 
@@ -100,13 +88,11 @@ If your project feels like a dependency maze, rev-dep gives you a map.
 * 🔄 **Circular imports/dependencies detection**
 * 🧭 **Trace all import paths between files**
 * 📁 **List all files imported by any entry point**
-* 📏 **Count actual lines of code (excluding comments, blanks and ai prompts)**
+* 📏 **Count actual lines of code (excluding comments and blanks)**
 * 💽 **Node modules disk usage & size analysis**
 * 💡 **Works with both JavaScript and TypeScript**
 * ⚡ **Built for large codebases**
 
----
-
 # **Installation 📦**
 
 Install globally to use as a CLI tool:
@@ -123,34 +109,37 @@ npm install -g rev-dep
 pnpm global add rev-dep
 ```
 
----
 
 # **Quick Examples ⚡**
 
 A few instant-use examples to get a feel for the tool:
 
 ```bash
-# Find every entry point that depends on a file
-rev-dep resolve --file src/utils/math.ts
+# Detect unused node modules
+rev-dep node-modules unused
+
+# Detect circular imports/dependencies
+rev-dep circular
 
 # List all entry points in the project
 rev-dep entry-points
 
-# Detect unused node modules
-rev-dep node-modules unused
-
 # Check which files an entry point imports
 rev-dep files --entry-point src/index.ts
 
-# Detect circular imports/dependencies
-rev-dep circular
-```
+# Find every entry point that depends on a file
+rev-dep resolve --file src/utils/math.ts
 
----
+# Resolve dependency path between files
+rev-dep resolve --file src/utils/math.ts --entry-point src/index.ts
+
+```
 
 # **Practical Examples 🔧**
 
 
+Practical examples show how to use rev-dep commands to build code quality checks for your project.
+
 ### **How to identify where a file is used in the project**
 
 ```
@@ -159,8 +148,6 @@ rev-dep resolve --file path/to/file.ts
 
 You’ll see all entry points that implicitly require that file, along with resolution paths.
 
----
-
 ### **How to check if a file is used**
 
 ```
@@ -169,8 +156,6 @@ rev-dep resolve --file path/to/file.ts --compact-summary
 
 Shows how many entry points indirectly depend on the file.
 
----
-
 ### **How to identify dead files**
 
 ```
@@ -179,8 +164,6 @@ rev-dep entry-points
 
 Exclude framework entry points if needed using `--result-exclude`.
 
----
-
 ### **How to list all files imported by an entry point**
 
 ```
@@ -189,8 +172,6 @@ rev-dep files --entry-point path/to/file.ts
 
 Useful for identifying heavy components or unintended dependencies.
 
----
-
 ### **How to reduce unnecessary imports for an entry point**
 
 1. List all files imported:
@@ -205,32 +186,24 @@ Useful for identifying heavy components or unintended dependencies.
    rev-dep resolve --file path/to/suspect --entry-points path/to/entry.ts --all
    ```
 
----
-
 ### **How to detect circular dependencies**
 
 ```
 rev-dep circular
 ```
 
----
-
 ### **How to find unused node modules**
 
 ```
 rev-dep node-modules unused
 ```
 
----
-
 ### **How to find missing node modules**
 
 ```
 rev-dep node-modules missing
 ```
 
----
-
 ### **How to check node_modules space usage**
 
 ```
@@ -347,9 +320,9 @@ Any other discrepancies between TypeScript module resolution and rev-dep should
 
 - Linux x64
 - MacOS Apple Silicon
+- Windows x64
 
-There are the platforms I use and know. For these I build and tested binaries. 
-Go allows for cross-compiling, so I'm happy to build and distribute binaries for other platforms as well, but I haven't tested it. 
+Go allows for cross-compiling, so I'm happy to build and distribute binaries for other platforms as well.
 Feel free to open an issue if you need support for another platform.
 
 ## CLI reference 📖

package/bin.js

@@ -11,6 +11,7 @@ const nestedNodeModulesPath = path.join(__dirname, 'node_modules', binaryPackage
 const siblingNodeModulesPath = path.join(__dirname, '../', binaryPackageName)
 
 const checkedPaths = []
+const fsRoot = path.parse(__dirname).root
 
 if (fs.existsSync(nestedNodeModulesPath)) {
   packageDir = nestedNodeModulesPath
@@ -27,7 +28,7 @@ else if (fs.existsSync(siblingNodeModulesPath)) {
     }
     else {
       checkedPaths.push(pathToCheck)
-      if (lookupDir === '/') {
+      if (lookupDir === fsRoot) {
         lookupDir = undefined
       }
       else {
@@ -41,6 +42,7 @@ if (packageDir === '') {
   console.error("Could not locate rev-dep binary for your platform: ", binaryPackageName)
   console.log('Checked paths', checkedPaths)
   console.log('Please open an issue to request platform support')
+  console.log('https://github.com/jayu/rev-dep/issues')
   process.exit(1)
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rev-dep",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "Trace imports, detect unused code, clean dependencies — all with a super-fast CLI",
   "bin": "bin.js",
   "files": [
@@ -17,8 +17,9 @@
     "node": ">=18"
   },
   "optionalDependencies": {
-    "@rev-dep/darwin-arm64": "2.1.0",
-    "@rev-dep/linux-x64": "2.1.0"
+    "@rev-dep/darwin-arm64": "2.2.0",
+    "@rev-dep/linux-x64": "2.2.0",
+    "@rev-dep/win32-x64": "2.2.0"
   },
   "keywords": [
     "dependency-analysis",