pkg-clean 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,226 @@
+# pkg-clean
+
+> Find and remove unused dependencies from your Node.js project
+
+[![npm version](https://img.shields.io/npm/v/pkg-clean)](https://www.npmjs.com/package/pkg-clean)
+[![npm downloads](https://img.shields.io/npm/dm/pkg-clean)](https://www.npmjs.com/package/pkg-clean)
+[![GitHub license](https://img.shields.io/github/license/apassanisi/pkg-clean)](LICENSE)
+[![Tests](https://github.com/apassanisi/pkg-clean/actions/workflows/tests.yml/badge.svg)](https://github.com/apassanisi/pkg-clean/actions)
+
+A minimal, fast CLI tool that scans your project for unused npm dependencies. Identifies unused packages, duplicates, and deprecated packages in seconds.
+
+## Features
+
+- **Scan for unused dependencies** - finds packages in package.json that aren't imported anywhere
+- **Detect duplicates** - spots packages listed in both `dependencies` and `devDependencies`
+- **Check deprecation status** - warns about deprecated packages via NPM registry
+- **Safe by default** - uses dry-run mode, only removes with `--remove` flag
+- **Fast** - scans large projects in under a second
+- **Minimal & slick CLI** - beautiful colored output with clear formatting
+
+## Installation
+
+```bash
+npm install -g pkg-clean
+```
+
+Or run directly without installing:
+
+```bash
+npx pkg-clean
+```
+
+## Usage
+
+### Scan current project
+
+```bash
+pkg-clean
+```
+
+Output:
+```
+◆ pkg-clean
+→ Scanning files...
+✓ Found 12 imports
+→ Analyzing dependencies...
+→ Checking for deprecated packages...
+
+◆ Report
+◆ Unused dependencies (3)
+  ● @types/jest
+  ● @types/node
+  ● ts-jest
+
+→ Run with --remove to clean up unused dependencies
+```
+
+### Remove unused dependencies
+
+```bash
+pkg-clean --remove
+```
+
+This will:
+1. Remove unused packages from your `package.json`
+2. Show you which packages were removed
+3. Suggest running `npm install`
+
+### Show verbose output
+
+```bash
+pkg-clean --verbose
+```
+
+Displays detailed information about all imports, dependencies, and analysis results.
+
+### Keep specific packages
+
+```bash
+pkg-clean --keep lodash react
+```
+
+Excludes specified packages from removal (even if unused).
+
+### Scan a different directory
+
+```bash
+pkg-clean /path/to/project
+```
+
+### Combine options
+
+```bash
+pkg-clean /path/to/project --remove --verbose --keep lodash
+```
+
+### Dry-run to preview changes
+
+```bash
+pkg-clean --remove --verbose
+```
+
+Output (without `--remove`):
+```
+→ Run with --remove to clean up unused dependencies
+```
+
+This allows you to review what would be removed before applying changes.
+
+### Use with npm scripts
+
+Add to your `package.json`:
+
+```json
+{
+  "scripts": {
+    "clean:deps": "pkg-clean",
+    "clean:deps:remove": "pkg-clean --remove",
+    "clean:deps:check": "pkg-clean --verbose"
+  }
+}
+```
+
+Then run:
+```bash
+npm run clean:deps:check    # Preview unused dependencies
+npm run clean:deps:remove   # Remove unused dependencies
+```
+
+### CI/CD Integration
+
+Check for unused dependencies in your CI pipeline:
+
+```bash
+# Fail if unused dependencies are found
+pkg-clean --verbose
+```
+
+Exit code will be non-zero if unused dependencies are detected (useful for CI gates).
+
+## Configuration
+
+Create a `pkg-clean.config.json` file in your project root to set default packages to keep:
+
+```json
+{
+  "keep": ["lodash", "moment"]
+}
+```
+
+Example configurations:
+
+**For a React project:**
+```json
+{
+  "keep": ["react", "react-dom", "react-router-dom"]
+}
+```
+
+**For a monorepo:**
+```json
+{
+  "keep": ["@company/shared-utils", "@company/types"]
+}
+```
+
+**For a library with peer dependencies:**
+```json
+{
+  "keep": ["tslib", "@types/node"]
+}
+```
+
+## How it works
+
+1. **Scans** all `.js`, `.ts`, `.jsx`, `.tsx` files in your project
+2. **Extracts** import/require statements using regex patterns
+3. **Compares** found imports against package.json entries
+4. **Reports** unused, duplicates, and deprecated packages
+5. **Removes** from package.json (if `--remove` flag is used)
+
+## What it detects
+
+### ✅ Detects
+
+- `import` statements: `import foo from 'bar'`
+- `require()` calls: `require('foo')`
+- Scoped packages: `@babel/core`
+- Nested imports: `lodash/map` → detects `lodash`
+- Both `dependencies` and `devDependencies`
+- Duplicate packages in both sections
+- Deprecated packages from NPM registry
+
+### ⚠️ Limitations
+
+- Doesn't analyze dynamic imports like `require(variable)`
+- Doesn't check `.json`, `.html`, or config files
+- Doesn't evaluate webpack/babel configs
+- Doesn't track indirect dependencies
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build TypeScript
+npm run build
+
+# Run tests
+npm test
+
+# Run tests in watch mode
+npm test:watch
+
+# Run locally
+node dist/cli.js
+```
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## License
+
+MIT © 2026

package/dist/analyzer.d.ts

@@ -0,0 +1,24 @@
+export interface PackageJson {
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+    [key: string]: unknown;
+}
+export interface AnalysisResult {
+    unused: string[];
+    duplicates: string[];
+    allDeps: string[];
+}
+/**
+ * Analyzes package.json dependencies against imported packages.
+ * Identifies unused packages and duplicates across dependency types.
+ */
+export declare class Analyzer {
+    /**
+     * Analyzes a project's dependencies.
+     * @param projectRoot - The root directory containing package.json
+     * @param importedPackages - Set of package names found by Scanner
+     * @returns Analysis result containing unused packages, duplicates, and all dependencies
+     * @throws {Error} If package.json is not found
+     */
+    analyzeProject(projectRoot: string, importedPackages: Set<string>): AnalysisResult;
+}

package/dist/analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer.d.ts","sourceRoot":"","sources":["../src/analyzer.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,WAAW;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;GAGG;AACH,qBAAa,QAAQ;IACnB;;;;;;OAMG;IACH,cAAc,CACZ,WAAW,EAAE,MAAM,EACnB,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,GAC5B,cAAc;CA4BlB"}

package/dist/analyzer.js

@@ -0,0 +1,75 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Analyzer = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * Analyzes package.json dependencies against imported packages.
+ * Identifies unused packages and duplicates across dependency types.
+ */
+class Analyzer {
+    /**
+     * Analyzes a project's dependencies.
+     * @param projectRoot - The root directory containing package.json
+     * @param importedPackages - Set of package names found by Scanner
+     * @returns Analysis result containing unused packages, duplicates, and all dependencies
+     * @throws {Error} If package.json is not found
+     */
+    analyzeProject(projectRoot, importedPackages) {
+        const pkgPath = path.join(projectRoot, "package.json");
+        if (!fs.existsSync(pkgPath)) {
+            throw new Error("package.json not found");
+        }
+        const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+        const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+        const allDeps = Object.keys(deps);
+        const unused = allDeps.filter((dep) => !importedPackages.has(dep));
+        const duplicates = [];
+        if (pkg.dependencies && pkg.devDependencies) {
+            for (const dep of Object.keys(pkg.dependencies)) {
+                if (pkg.devDependencies[dep]) {
+                    duplicates.push(dep);
+                }
+            }
+        }
+        return {
+            unused,
+            duplicates,
+            allDeps,
+        };
+    }
+}
+exports.Analyzer = Analyzer;

package/dist/analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer.js","sourceRoot":"","sources":["../src/analyzer.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,uCAAyB;AACzB,2CAA6B;AAc7B;;;GAGG;AACH,MAAa,QAAQ;IACnB;;;;;;OAMG;IACH,cAAc,CACZ,WAAmB,EACnB,gBAA6B;QAE7B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;QAEvD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAC5C,CAAC;QAED,MAAM,GAAG,GAAgB,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QACvE,MAAM,IAAI,GAAG,EAAE,GAAG,GAAG,CAAC,YAAY,EAAE,GAAG,GAAG,CAAC,eAAe,EAAE,CAAC;QAC7D,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAElC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QAEnE,MAAM,UAAU,GAAa,EAAE,CAAC;QAChC,IAAI,GAAG,CAAC,YAAY,IAAI,GAAG,CAAC,eAAe,EAAE,CAAC;YAC5C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;gBAChD,IAAI,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC7B,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACvB,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO;YACL,MAAM;YACN,UAAU;YACV,OAAO;SACR,CAAC;IACJ,CAAC;CACF;AAvCD,4BAuCC"}

package/dist/analyzer.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/analyzer.test.js

@@ -0,0 +1,89 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const analyzer_1 = require("./analyzer");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+describe("Analyzer", () => {
+    const analyzer = new analyzer_1.Analyzer();
+    const testDir = path.join(__dirname, "fixtures-analyzer");
+    beforeAll(() => {
+        if (!fs.existsSync(testDir)) {
+            fs.mkdirSync(testDir, { recursive: true });
+        }
+    });
+    afterAll(() => {
+        if (fs.existsSync(testDir)) {
+            fs.rmSync(testDir, { recursive: true });
+        }
+    });
+    it("should detect unused dependencies", () => {
+        const pkg = {
+            dependencies: {
+                lodash: "^4.17.0",
+                react: "^18.0.0",
+            },
+            devDependencies: {
+                jest: "^29.0.0",
+            },
+        };
+        fs.writeFileSync(path.join(testDir, "package.json"), JSON.stringify(pkg));
+        const imported = new Set(["react"]);
+        const result = analyzer.analyzeProject(testDir, imported);
+        expect(result.unused).toContain("lodash");
+        expect(result.unused).toContain("jest");
+        expect(result.unused).not.toContain("react");
+    });
+    it("should detect duplicate dependencies", () => {
+        const pkg = {
+            dependencies: {
+                typescript: "^5.0.0",
+            },
+            devDependencies: {
+                typescript: "^5.0.0",
+                jest: "^29.0.0",
+            },
+        };
+        fs.writeFileSync(path.join(testDir, "package.json"), JSON.stringify(pkg));
+        const imported = new Set(["typescript", "jest"]);
+        const result = analyzer.analyzeProject(testDir, imported);
+        expect(result.duplicates).toContain("typescript");
+    });
+    it("should throw error when package.json not found", () => {
+        const nonExistentDir = path.join(testDir, "nonexistent");
+        const imported = new Set();
+        expect(() => analyzer.analyzeProject(nonExistentDir, imported)).toThrow();
+    });
+});

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const index_1 = require("./index");
+commander_1.program
+    .name("pkg-clean")
+    .description("Find and remove unused dependencies")
+    .version("1.0.0");
+commander_1.program
+    .arguments("[path]")
+    .option("--remove", "Remove unused dependencies from package.json")
+    .option("--verbose", "Show verbose output")
+    .option("--keep <packages...>", "Packages to keep (space-separated)")
+    .action(async (dirPath, options) => {
+    try {
+        const projectRoot = dirPath || process.cwd();
+        const cleaner = new index_1.Cleaner();
+        await cleaner.clean(projectRoot, options);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(`\x1b[31m✗\x1b[0m ${message}`);
+        process.exit(1);
+    }
+});
+commander_1.program.parse();

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;;AAEA,yCAAoC;AACpC,mCAAkC;AAElC,mBAAO;KACJ,IAAI,CAAC,WAAW,CAAC;KACjB,WAAW,CAAC,qCAAqC,CAAC;KAClD,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,mBAAO;KACJ,SAAS,CAAC,QAAQ,CAAC;KACnB,MAAM,CAAC,UAAU,EAAE,8CAA8C,CAAC;KAClE,MAAM,CAAC,WAAW,EAAE,qBAAqB,CAAC;KAC1C,MAAM,CAAC,sBAAsB,EAAE,oCAAoC,CAAC;KACpE,MAAM,CAAC,KAAK,EAAE,OAA2B,EAAE,OAAO,EAAE,EAAE;IACrD,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAC7C,MAAM,OAAO,GAAG,IAAI,eAAO,EAAE,CAAC;QAC9B,MAAM,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,OAAO,CAAC,KAAK,CAAC,YAAY,OAAO,EAAE,CAAC,CAAC;QACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,mBAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/configLoader.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Configuration options for pkg-clean
+ */
+export interface PkgCleanConfig {
+    /** Directories to ignore during scanning */
+    ignore?: string[];
+    /** Packages to always keep, even if unused */
+    keep?: string[];
+    /** Check for deprecated packages */
+    checkDeprecation?: boolean;
+    /** Enable verbose output */
+    verbose?: boolean;
+}
+/**
+ * Loads and manages pkg-clean configuration from pkg-clean.config.json
+ */
+export declare class ConfigLoader {
+    private static readonly CONFIG_FILE;
+    /**
+     * Loads configuration from pkg-clean.config.json if it exists
+     * @param projectRoot - The project root directory
+     * @returns The loaded configuration or empty object if file doesn't exist
+     */
+    static load(projectRoot: string): PkgCleanConfig;
+    /**
+     * Creates a default configuration file
+     * @param projectRoot - The project root directory
+     * @returns The created configuration
+     */
+    static createDefault(projectRoot: string): PkgCleanConfig;
+    /**
+     * Merges user options with loaded configuration
+     * CLI options take precedence over config file
+     * @param configFile - Configuration from file
+     * @param cliOptions - Command-line options
+     * @returns Merged configuration
+     */
+    static merge(configFile: PkgCleanConfig, cliOptions: Partial<PkgCleanConfig>): PkgCleanConfig;
+}
+//# sourceMappingURL=configLoader.d.ts.map

package/dist/configLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configLoader.d.ts","sourceRoot":"","sources":["../src/configLoader.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,oCAAoC;IACpC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,4BAA4B;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAA2B;IAE9D;;;;OAIG;IACH,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc;IAiBhD;;;;OAIG;IACH,MAAM,CAAC,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc;IAczD;;;;;;OAMG;IACH,MAAM,CAAC,KAAK,CACV,UAAU,EAAE,cAAc,EAC1B,UAAU,EAAE,OAAO,CAAC,cAAc,CAAC,GAClC,cAAc;CASlB"}

package/dist/configLoader.js

@@ -0,0 +1,97 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigLoader = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * Loads and manages pkg-clean configuration from pkg-clean.config.json
+ */
+class ConfigLoader {
+    /**
+     * Loads configuration from pkg-clean.config.json if it exists
+     * @param projectRoot - The project root directory
+     * @returns The loaded configuration or empty object if file doesn't exist
+     */
+    static load(projectRoot) {
+        const configPath = path.join(projectRoot, this.CONFIG_FILE);
+        if (!fs.existsSync(configPath)) {
+            return {};
+        }
+        try {
+            const content = fs.readFileSync(configPath, "utf-8");
+            const config = JSON.parse(content);
+            return config;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            throw new Error(`Failed to parse ${this.CONFIG_FILE}: ${message}`);
+        }
+    }
+    /**
+     * Creates a default configuration file
+     * @param projectRoot - The project root directory
+     * @returns The created configuration
+     */
+    static createDefault(projectRoot) {
+        const configPath = path.join(projectRoot, this.CONFIG_FILE);
+        const defaultConfig = {
+            ignore: ["node_modules", "dist", "build"],
+            keep: [],
+            checkDeprecation: true,
+            verbose: false,
+        };
+        fs.writeFileSync(configPath, JSON.stringify(defaultConfig, null, 2) + "\n");
+        return defaultConfig;
+    }
+    /**
+     * Merges user options with loaded configuration
+     * CLI options take precedence over config file
+     * @param configFile - Configuration from file
+     * @param cliOptions - Command-line options
+     * @returns Merged configuration
+     */
+    static merge(configFile, cliOptions) {
+        return {
+            ignore: cliOptions.ignore ?? configFile.ignore,
+            keep: cliOptions.keep ?? configFile.keep,
+            checkDeprecation: cliOptions.checkDeprecation ?? configFile.checkDeprecation ?? true,
+            verbose: cliOptions.verbose ?? configFile.verbose ?? false,
+        };
+    }
+}
+exports.ConfigLoader = ConfigLoader;
+ConfigLoader.CONFIG_FILE = "pkg-clean.config.json";
+//# sourceMappingURL=configLoader.js.map

package/dist/configLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configLoader.js","sourceRoot":"","sources":["../src/configLoader.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,uCAAyB;AACzB,2CAA6B;AAgB7B;;GAEG;AACH,MAAa,YAAY;IAGvB;;;;OAIG;IACH,MAAM,CAAC,IAAI,CAAC,WAAmB;QAC7B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAE5D,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC/B,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YACrD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACnC,OAAO,MAAwB,CAAC;QAClC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,CAAC,WAAW,KAAK,OAAO,EAAE,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,aAAa,CAAC,WAAmB;QACtC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAE5D,MAAM,aAAa,GAAmB;YACpC,MAAM,EAAE,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,CAAC;YACzC,IAAI,EAAE,EAAE;YACR,gBAAgB,EAAE,IAAI;YACtB,OAAO,EAAE,KAAK;SACf,CAAC;QAEF,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QAC5E,OAAO,aAAa,CAAC;IACvB,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,KAAK,CACV,UAA0B,EAC1B,UAAmC;QAEnC,OAAO;YACL,MAAM,EAAE,UAAU,CAAC,MAAM,IAAI,UAAU,CAAC,MAAM;YAC9C,IAAI,EAAE,UAAU,CAAC,IAAI,IAAI,UAAU,CAAC,IAAI;YACxC,gBAAgB,EACd,UAAU,CAAC,gBAAgB,IAAI,UAAU,CAAC,gBAAgB,IAAI,IAAI;YACpE,OAAO,EAAE,UAAU,CAAC,OAAO,IAAI,UAAU,CAAC,OAAO,IAAI,KAAK;SAC3D,CAAC;IACJ,CAAC;;AA9DH,oCA+DC;AA9DyB,wBAAW,GAAG,uBAAuB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+export interface CleanerOptions {
+    remove?: boolean;
+    verbose?: boolean;
+    keep?: string[];
+}
+/**
+ * Main cleaner class that orchestrates the dependency analysis workflow.
+ * Scans project files, analyzes dependencies, checks for deprecation, and optionally removes unused packages.
+ */
+export declare class Cleaner {
+    private scanner;
+    private analyzer;
+    private registry;
+    constructor();
+    /**
+     * Scans a project for unused dependencies and optionally removes them.
+     * @param projectRoot - The root directory of the project to scan
+     * @param options - Configuration options for the clean operation
+     * @param options.remove - If true, removes unused dependencies from package.json
+     * @param options.verbose - If true, outputs detailed diagnostic information
+     * @throws {Error} If package.json is not found in the project root
+     */
+    clean(projectRoot: string, options?: CleanerOptions): Promise<void>;
+}

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AA6ED;;;GAGG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,QAAQ,CAAW;;IAQ3B;;;;;;;OAOG;IACG,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB;CA8H9D"}