🧹 Autoremover Import

Automatically manage your JavaScript/React project dependencies by analyzing imports in real-time. Never worry about unused dependencies or missing packages again!

✨ Features

• 🔍 Real-time Analysis: Monitors your code for import changes
• 🚀 Auto-Installation: Automatically installs missing dependencies
• 🗑️ Auto-Removal: Safely removes unused dependencies
• 🛡️ Safe Mode: Optional confirmation before any package changes
• 📦 Multiple Package Managers: Supports both npm and yarn
• 🌟 Smart Detection: Supports both ES6 imports and require syntax
• 🔒 Protected Packages: Prevent accidental removal of essential packages
• 📁 Deep Scanning: Recursively analyzes all project files

📥 Installation

1npm install autoremover-import
2# or
3yarn add autoremover-import

🚀 Quick Start

1. After installation, initialize the configuration:

1npx autoremover-import init

2. Start watching your imports:

1npm run watch-imports
2# or
3yarn watch-imports

💻 Usage Examples

Basic Usage

1const ImportManager = require('autoremover-import');
2
3// Initialize with your project path
4const manager = new ImportManager(__dirname);
5
6// Start watching for changes
7manager.start().catch(error => {
8    console.error('Error:', error);
9    process.exit(1);
10});

With Safe Mode

1const ImportManager = require('autoremover-import');
2const path = require('path');
3
4const manager = new ImportManager(__dirname);
5
6async function run() {
7    try {
8        await manager.start();
9        console.log('✨ Import manager is now watching for changes');
10        
11        // Keep the process running
12        process.stdin.resume();
13        
14        // Handle graceful shutdown
15        process.on('SIGINT', () => {
16            console.log('Stopping import manager...');
17            manager.stop();
18            process.exit(0);
19        });
20    } catch (error) {
21        console.error('Error:', error);
22        process.exit(1);
23    }
24}
25
26run();

⚙️ Configuration

Create an import-manager.config.js file in your project root:

1module.exports = {
2  // Packages that will never be removed automatically
3  ignoredPackages: [
4    'react',
5    'typescript'
6  ],
7
8  // Watcher configuration
9  watcherConfig: {
10    watchOnSave: true,          // Watch for file changes
11    watchInterval: 1000,        // Check interval in milliseconds
12    ignoredPaths: [             // Paths to ignore
13      'node_modules',
14      'dist',
15      'build',
16      '.next',
17      '*.test.*',
18      'package.json',
19      'package-lock.json'
20    ],
21    fileExtensions: [           // File types to watch
22      '.js',
23      '.jsx',
24      '.ts',
25      '.tsx'
26    ]
27  },
28
29  // Package.json configuration
30  packageJsonConfig: {
31    checkDevDependencies: false,  // Whether to manage devDependencies
32    defaultVersion: 'latest',     // Default version when installing new packages
33    safeMode: false,             // Ask for confirmation before changes
34    packageManager: 'npm'        // 'npm' or 'yarn'
35  },
36
37  // Enable debug logs
38  debug: true
39};

Configuration Options Explained

🛡️ ignoredPackages

• Purpose: Protect packages from being removed
• Example: ['react', 'typescript']
• Use Case: Essential packages that should never be removed

⚡ watcherConfig

• watchOnSave: Enable/disable file watching
  • true: Real-time monitoring
  • false: Manual analysis only
• watchInterval: Delay between checks
  • Lower value = More frequent checks
  • Higher value = Better performance
• ignoredPaths: Paths to exclude from analysis
• fileExtensions: File types to analyze

📦 packageJsonConfig

• checkDevDependencies: Include devDependencies in analysis
  • true: Manage both dependencies and devDependencies
  • false: Only manage dependencies
• safeMode: Confirmation prompts
  • true: Ask before any package changes
  • false: Automatic changes without confirmation
• packageManager: Choose your package manager
  • 'npm': Use npm commands
  • 'yarn': Use yarn commands

🔍 Import Detection

Supports various import syntaxes:

1// ES6 imports
2import axios from 'axios';
3import { get, post } from 'axios';
4import * as React from 'react';
5
6// CommonJS requires
7const axios = require('axios');
8const { get, post } = require('axios');

🛠️ Advanced Features

Protected Packages

Some packages are protected by default and won't be removed:

• The package itself (autoremover-import)
• Packages listed in ignoredPackages

Deep Analysis

• Analyzes all files in your project recursively
• Ensures packages used in any file are not removed
• Handles complex import patterns and dependencies

Safe Mode Operations

When safeMode is enabled:

1🤔 Do you want to install axios? (y/n): y
2📥 Installing axios...
3✅ axios installed successfully
4
5🤔 Do you want to remove moment? (y/n): n
6⏭️ Skipping removal of moment

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

MIT © [rs12]