sweepy/CHANGELOG.md

All-in-one CLI tool to find and clean unused code, files, dependencies, assets, exports, envs, and more

# 📦 Changelog

## v1.2.1-v1.2.2

- 📦 **Bundled CLI for Faster Installs**: Sweepy is now fully bundled using esbuild, significantly reducing install size and improving startup performance. With fewer runtime dependencies, installation is faster and more reliable.
- 🧾 **HTML & JSON Detection Added**: Sweepy now detects unused `.html`, `.htm`, and `.json` files across your entire project, even in deeply nested subfolders.
- ⚙️ **New `--detect config`**: Detects unused or duplicate config files such as `.babelrc`, `.prettierrc`, `.editorconfig`, and all `tsconfig.*.json` variants — perfect for identifying leftovers after migrations.
- 🧹 **Expanded `--delete` Support**: You can now safely delete unused `.html`, `.json`, and config files using `--delete`, with support for `--confirm`, `--interactive`, and `--dry-run`.
- 🧠 **Interactive Deletion Enhanced**: Prompts are now grouped by file type (e.g. JS, CSS, HTML, JSON, Config). Easier to scan and safer to manage.
- 📄 **Report Improvements**: HTML and text reports now include unused HTML, JSON, and config files, with clearer section titles and exportable summaries.

## v1.2.0

- 🕳️ **Unused Variable Detection**: Sweepy now detects unused variable declarations (e.g. `const x = 1`) using `eslint-scope` with full block/global scope awareness. Enable it using `--detect vars`.
- 🧭 **Dead Alias Detection**: Sweepy now detects dead or misconfigured aliases defined in `tsconfig.json`, `webpack.config.js`, `babel.config.js`, and `vite.config.ts`. Enable this using `--detect alias` or run a full scan to include it automatically.
- 🛡️ **Safer Static Analysis**: Sweepy now gracefully skips unparsable files (e.g. invalid JS, corrupted TS, malformed ASTs), ensuring crash-free scans even in large or messy codebases.
- 🖼️ **Improved HTML Report Styling**: The visual report has been polished for better readability, clearer grouping, and cleaner spacing. Prepares the groundwork for future collapsible sections.
- 🚫 **Improved Invalid Command Handling**: Running Sweepy with unknown commands (e.g. `sweepy erfuerif`) now prints a helpful message instead of showing raw commander errors.
- 🧪 **Extension-Based Filtering with `--only`**: The `--only` flag now filters output by **actual file extensions** (e.g. `.js`, `.css`, `.env`, `.png`), not just category. This applies across all file-based detections, including exports, CSS selectors, alias paths, and unused files.

### 🐛 Bug Fixes

- 🐛 **Fixed `--detect` Parsing**: Fixed a bug where `--detect js --export file.json` would incorrectly trigger help output. The CLI now properly parses arguments even when detection types are followed by other flags.
- 🐛 **Correct `.txt` Export Behavior**: Fixed a bug where `.txt` exports only included unused files but excluded other sections (e.g. variables, exports, env, aliases). Sweepy now exports all relevant sections consistently in `.txt` format.


## v1.1.5

- 🧩 **Dependency Detection Integration**: Sweepy now detects unused and undeclared dependencies from `package.json`. Use `--detect deps` to include or isolate this check.
- 📤 **Smarter Inline Help**: Invalid or missing `--detect` values now redirect to `--detect --help` instead of showing generic usage output.
- 🌀 **Loading Spinners**: The CLI now displays loading indicators during scan and depcheck stages for improved user experience.
- 🔧 **Stronger CLI Guardrails**: Misused flags like `--export`, `--ignore`, or `--detect` now show helpful usage instructions instead of crashing.
- 🧠 **Improved String Extraction Logic**: Enhanced detection accuracy for dynamic expressions, templates, and conditional values across the entire codebase.
- 🚀 **Better Dynamic Detection**: Increased reliability when analyzing complex code patterns and expressions.
- 🎨 **CSS Selector Safelist Support**: Define safelist patterns using `customCssSafelist` in `.sweepyrc.json` or `package.json` to prevent false positives.
- 🎛️ **Enhanced `--verbose` Output**: Shows detailed insights about scanned directories, file counts, JSX matches, and import paths.
- 🛠 **Fixed `@babel/traverse` interop bug**: Sweepy now correctly resolves `traverse` in both ESM and CJS environments using a safe fallback.
- 🧪 Improved test coverage with Vitest and CI integration.  
- 📈 Codecov support: Code coverage is now automatically uploaded and visualized for every push and pull request.

## v1.1.0

- 🎯 **Unused CSS Selector Detection**: Now detects unused `.class`, `#id`, and element tags across JSX, HTML, and templates
- 🛠️ **.env Key Analysis**: Flags unused environment variables defined in `.env` files via `process.env.X`
- 🎛️ **Custom Detection via `--detect`**: Choose what to scan: `js`, `css`, `assets`, `exports`, or `env`
- 🧪 **Dynamic Import Tracking**: Handles `require()`, `import()`, and `fs.readdirSync()`-based usage patterns
- 🧠 **Improved Heuristics for JSX + className**: Extracts values from conditional and template expressions
- 💬 **Inline CLI Help**: Run `--detect --help` or `--ignore --help` to see examples and usage tips

## v1.0.5

- 🧠 **Export Symbol Detection**: Flags unused named & default exports
- 🧩 **Alias Resolution**: Supports Webpack, Vite, Babel & custom aliases via `package.json`
- ⚡ **Zero-config Setup**: Auto-detects config or injects into `package.json` via `--init`
- 🧼 **Auto-Cleanup Mode**: Use `--delete --confirm` to remove unused files instantly
- 🧪 **Improved JSX Matching**: Detects component usage via `<Component />` syntax

## v1.0.1

- 🚀 **First public release**: Detects unused JavaScript/TypeScript modules, CSS/SCSS files, and static assets (PNG, JPG, SVG)
- 🧼 **Safe delete support**: Use `--delete` or `--interactive` to move unused files to a recovery folder
- 📤 **Export support**: Output scan results as `.txt` or `.json`
- 📊 **CLI-friendly output**: Designed for clean, readable terminal usage and CI pipelines
- 🧪 **Initial test suite added**: Basic unit tests and CLI validation using [Vitest](https://vitest.dev)
- 🤖 **CI integration setup**: GitHub Actions configured for linting and test verification