What problem does it solve?
Developers often make changes to shared TypeScript or JavaScript files without knowing which parts of the codebase import them, creating "change A breaks B" regressions. deps-check quickly identifies downstream importers so you can assess impact and plan safe, staged edits.
Core Features & Use Cases
- Project-root discovery: walks up to the nearest package.json to determine the repository root for accurate scanning.
- Madge first, grep fallback: prefers madge --reverse for precise dependency graphs and falls back to a grep-based search across common source directories when madge is unavailable.
- Targeted scope & guidance: only processes TS/JS files and summarizes importer counts with actionable strategies (safe to change, inspect a few files, or require deprecation/shims).
- Use cases: renaming or moving exported symbols, changing function signatures or public APIs, preparing large refactors of shared libraries.
Quick Start
Run the deps-check script on the target TypeScript or JavaScript file to list its importers before editing.