Autoremover-import NPM

🧹 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

npm install autoremover-import
# or
yarn add autoremover-import

🚀 Quick Start

After installation, initialize the configuration:

npx autoremover-import init

Start watching your imports:

npm run watch-imports
# or
yarn watch-imports

💻 Usage Examples

Basic Usage

const ImportManager = require('autoremover-import');

// Initialize with your project path
const manager = new ImportManager(__dirname);

// Start watching for changes
manager.start().catch(error => {
    console.error('Error:', error);
    process.exit(1);
});

With Safe Mode

const ImportManager = require('autoremover-import');
const path = require('path');

const manager = new ImportManager(__dirname);

async function run() {
    try {
        await manager.start();
        console.log('✨ Import manager is now watching for changes');
        
        // Keep the process running
        process.stdin.resume();
        
        // Handle graceful shutdown
        process.on('SIGINT', () => {
            console.log('Stopping import manager...');
            manager.stop();
            process.exit(0);
        });
    } catch (error) {
        console.error('Error:', error);
        process.exit(1);
    }
}

run();

⚙️ Configuration

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

module.exports = {
  // Packages that will never be removed automatically
  ignoredPackages: [
    'react',
    'typescript'
  ],

  // Watcher configuration
  watcherConfig: {
    watchOnSave: true,          // Watch for file changes
    watchInterval: 1000,        // Check interval in milliseconds
    ignoredPaths: [             // Paths to ignore
      'node_modules',
      'dist',
      'build',
      '.next',
      '*.test.*',
      'package.json',
      'package-lock.json'
    ],
    fileExtensions: [           // File types to watch
      '.js',
      '.jsx',
      '.ts',
      '.tsx'
    ]
  },

  // Package.json configuration
  packageJsonConfig: {
    checkDevDependencies: false,  // Whether to manage devDependencies
    defaultVersion: 'latest',     // Default version when installing new packages
    safeMode: false,             // Ask for confirmation before changes
    packageManager: 'npm'        // 'npm' or 'yarn'
  },

  // Enable debug logs
  debug: true
};

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:

// ES6 imports
import axios from 'axios';
import { get, post } from 'axios';
import * as React from 'react';

// CommonJS requires
const axios = require('axios');
const { 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:

🤔 Do you want to install axios? (y/n): y
📥 Installing axios...
✅ axios installed successfully

🤔 Do you want to remove moment? (y/n): n
⏭️ Skipping removal of moment