pkg-clean 1.0.0

package/dist/index.js

@@ -0,0 +1,179 @@
+"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.Cleaner = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const scanner_1 = require("./scanner");
+const analyzer_1 = require("./analyzer");
+const registry_1 = require("./registry");
+function loadConfig(projectRoot) {
+    const configPath = path.join(projectRoot, "pkg-clean.config.json");
+    if (!fs.existsSync(configPath)) {
+        return {};
+    }
+    try {
+        const content = fs.readFileSync(configPath, "utf-8");
+        const config = JSON.parse(content);
+        return { keep: config.keep };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.warn(`\x1b[33m⚠\x1b[0m Warning: Could not load config file: ${message}`);
+        return {};
+    }
+}
+function removeDependencies(projectRoot, packages) {
+    var _a, _b;
+    const pkgPath = path.join(projectRoot, "package.json");
+    if (!fs.existsSync(pkgPath)) {
+        throw new Error("package.json not found");
+    }
+    const content = fs.readFileSync(pkgPath, "utf-8");
+    const pkg = JSON.parse(content);
+    for (const packageName of packages) {
+        (_a = pkg.dependencies) === null || _a === void 0 ? true : delete _a[packageName];
+        (_b = pkg.devDependencies) === null || _b === void 0 ? true : delete _b[packageName];
+    }
+    fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
+    return true;
+}
+/**
+ * Main cleaner class that orchestrates the dependency analysis workflow.
+ * Scans project files, analyzes dependencies, checks for deprecation, and optionally removes unused packages.
+ */
+class Cleaner {
+    constructor() {
+        this.scanner = new scanner_1.Scanner();
+        this.analyzer = new analyzer_1.Analyzer();
+        this.registry = new registry_1.Registry();
+    }
+    /**
+     * 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
+     */
+    async clean(projectRoot, options = {}) {
+        // Load config file and merge with provided options
+        const configOptions = loadConfig(projectRoot);
+        const mergedOptions = { ...configOptions, ...options };
+        // Validate project root is a directory
+        const resolvedPath = path.resolve(projectRoot);
+        try {
+            const stats = fs.statSync(resolvedPath);
+            if (!stats.isDirectory()) {
+                throw new Error(`"${projectRoot}" is not a directory`);
+            }
+        }
+        catch (error) {
+            if (error instanceof Error && error.message.includes("not a directory")) {
+                throw error;
+            }
+            throw new Error(`Directory not found: "${projectRoot}"`);
+        }
+        // Print header
+        console.log("\n\x1b[36m◆\x1b[0m \x1b[1mpkg-clean\x1b[0m");
+        // Scan project for imports
+        console.log("\x1b[90m→\x1b[0m Scanning files...");
+        const imports = await this.scanner.scan(projectRoot);
+        console.log("\x1b[32m✓\x1b[0m Found \x1b[1m" + imports.size + "\x1b[0m imports");
+        if (options.verbose) {
+            console.log("  Imported packages:", Array.from(imports).sort());
+        }
+        // Analyze dependencies
+        console.log("\x1b[90m→\x1b[0m Analyzing dependencies...");
+        const analysis = this.analyzer.analyzeProject(projectRoot, imports);
+        if (options.verbose) {
+            console.log("  All dependencies:", analysis.allDeps.sort());
+        }
+        // Filter out packages to keep
+        const keepList = new Set(mergedOptions.keep || []);
+        if (options.verbose && keepList.size > 0) {
+            console.log("  Keeping packages:", Array.from(keepList)
+                .filter((pkg) => analysis.unused.includes(pkg))
+                .sort());
+        }
+        const unusedToRemove = analysis.unused.filter((pkg) => !keepList.has(pkg));
+        // Check for deprecated packages
+        console.log("\x1b[90m→\x1b[0m Checking for deprecated packages...");
+        let deprecated = [];
+        try {
+            deprecated = await this.registry.checkMultiple(analysis.allDeps);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            console.warn(`\x1b[33m⚠\x1b[0m Warning: Could not check deprecation status: ${message}`);
+        }
+        // Generate report
+        console.log("\n\x1b[36m◆\x1b[0m \x1b[1mReport\x1b[0m");
+        if (analysis.unused.length > 0) {
+            console.log(`\x1b[33m◆\x1b[0m Unused dependencies \x1b[33m(${analysis.unused.length})\x1b[0m`);
+            analysis.unused.forEach((dep) => {
+                const kept = keepList.has(dep) ? " \x1b[90m(kept)\x1b[0m" : "";
+                console.log(`  \x1b[90m●\x1b[0m ${dep}${kept}`);
+            });
+        }
+        else {
+            console.log("\x1b[32m◆\x1b[0m No unused dependencies found");
+        }
+        if (analysis.duplicates.length > 0) {
+            console.log(`\x1b[33m◆\x1b[0m Duplicates \x1b[33m(${analysis.duplicates.length})\x1b[0m`);
+            analysis.duplicates.forEach((dep) => console.log(`  \x1b[90m●\x1b[0m ${dep}`));
+        }
+        const deprecatedDeps = deprecated.filter((d) => d.deprecated);
+        if (deprecatedDeps.length > 0) {
+            console.log(`\x1b[31m◆\x1b[0m Deprecated packages \x1b[31m(${deprecatedDeps.length})\x1b[0m`);
+            deprecatedDeps.forEach((dep) => {
+                const reason = dep.reason ? ` \x1b[90m— ${dep.reason}\x1b[0m` : "";
+                console.log(`  \x1b[90m●\x1b[0m ${dep.name}${reason}`);
+            });
+        }
+        // Remove if requested
+        if (options.remove && unusedToRemove.length > 0) {
+            console.log("\n\x1b[36m◆\x1b[0m \x1b[1mRemoving\x1b[0m");
+            removeDependencies(projectRoot, unusedToRemove);
+            console.log("\x1b[32m✓\x1b[0m Removed from package.json");
+            console.log("\n  Run: \x1b[1mnpm install\x1b[0m");
+        }
+        else if (!options.remove && analysis.unused.length > 0) {
+            console.log("\n\x1b[36m→\x1b[0m Run with \x1b[1m--remove\x1b[0m to clean up unused dependencies");
+        }
+        console.log();
+    }
+}
+exports.Cleaner = Cleaner;

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.test.d.ts

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

package/dist/index.test.js

@@ -0,0 +1,316 @@
+"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 index_1 = require("./index");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+describe("Cleaner Integration", () => {
+    const testDir = path.join(__dirname, "fixtures-cleaner-integration");
+    beforeAll(() => {
+        if (!fs.existsSync(testDir)) {
+            fs.mkdirSync(testDir, { recursive: true });
+        }
+    });
+    afterAll(() => {
+        if (fs.existsSync(testDir)) {
+            fs.rmSync(testDir, { recursive: true });
+        }
+    });
+    it("should complete full clean workflow without removing", async () => {
+        // Setup test project
+        const projectDir = path.join(testDir, "test-project-1");
+        fs.mkdirSync(projectDir, { recursive: true });
+        const pkg = {
+            dependencies: {
+                lodash: "^4.17.0",
+                react: "^18.0.0",
+            },
+            devDependencies: {
+                jest: "^29.0.0",
+            },
+        };
+        fs.writeFileSync(path.join(projectDir, "package.json"), JSON.stringify(pkg));
+        // Create a source file that only imports react
+        const srcDir = path.join(projectDir, "src");
+        fs.mkdirSync(srcDir);
+        fs.writeFileSync(path.join(srcDir, "index.ts"), "import React from 'react';\n");
+        // Run cleaner in dry-run mode
+        const cleaner = new index_1.Cleaner();
+        // Capture console output
+        let output = "";
+        const originalLog = console.log;
+        console.log = (...args) => {
+            output += args.join(" ") + "\n";
+            originalLog(...args);
+        };
+        try {
+            await cleaner.clean(projectDir, { remove: false });
+            // Verify output contains expected findings
+            expect(output).toContain("lodash");
+            expect(output).toContain("jest");
+            expect(output).toContain("Unused dependencies");
+            // Verify package.json was not modified
+            const updated = JSON.parse(fs.readFileSync(path.join(projectDir, "package.json"), "utf-8"));
+            expect(updated.dependencies.lodash).toBe("^4.17.0");
+            expect(updated.devDependencies.jest).toBe("^29.0.0");
+        }
+        finally {
+            console.log = originalLog;
+        }
+    });
+    it("should detect duplicates in dependencies", async () => {
+        const projectDir = path.join(testDir, "test-project-2");
+        fs.mkdirSync(projectDir, { recursive: true });
+        const pkg = {
+            dependencies: {
+                typescript: "^5.0.0",
+                react: "^18.0.0",
+            },
+            devDependencies: {
+                typescript: "^5.0.0",
+                jest: "^29.0.0",
+            },
+        };
+        fs.writeFileSync(path.join(projectDir, "package.json"), JSON.stringify(pkg));
+        const srcDir = path.join(projectDir, "src");
+        fs.mkdirSync(srcDir);
+        fs.writeFileSync(path.join(srcDir, "index.ts"), "import React from 'react';\nimport ts from 'typescript';\n");
+        const cleaner = new index_1.Cleaner();
+        let output = "";
+        const originalLog = console.log;
+        console.log = (...args) => {
+            output += args.join(" ") + "\n";
+            originalLog(...args);
+        };
+        try {
+            await cleaner.clean(projectDir, { remove: false });
+            expect(output).toContain("Duplicates");
+            expect(output).toContain("typescript");
+        }
+        finally {
+            console.log = originalLog;
+        }
+    });
+    it("should remove unused dependencies when --remove flag is used", async () => {
+        const projectDir = path.join(testDir, "test-project-3");
+        fs.mkdirSync(projectDir, { recursive: true });
+        const pkg = {
+            dependencies: {
+                lodash: "^4.17.0",
+                react: "^18.0.0",
+            },
+            devDependencies: {
+                jest: "^29.0.0",
+            },
+        };
+        fs.writeFileSync(path.join(projectDir, "package.json"), JSON.stringify(pkg));
+        const srcDir = path.join(projectDir, "src");
+        fs.mkdirSync(srcDir);
+        fs.writeFileSync(path.join(srcDir, "index.ts"), "import React from 'react';\n");
+        const cleaner = new index_1.Cleaner();
+        let output = "";
+        const originalLog = console.log;
+        console.log = (...args) => {
+            output += args.join(" ") + "\n";
+            originalLog(...args);
+        };
+        try {
+            await cleaner.clean(projectDir, { remove: true });
+            expect(output).toContain("Removing");
+            // Verify package.json was modified
+            const updated = JSON.parse(fs.readFileSync(path.join(projectDir, "package.json"), "utf-8"));
+            expect(updated.dependencies.react).toBe("^18.0.0");
+            expect(updated.dependencies.lodash).toBeUndefined();
+            expect(updated.devDependencies.jest).toBeUndefined();
+        }
+        finally {
+            console.log = originalLog;
+        }
+    });
+    it("should handle project with no unused dependencies", async () => {
+        const projectDir = path.join(testDir, "test-project-4");
+        fs.mkdirSync(projectDir, { recursive: true });
+        const pkg = {
+            dependencies: {
+                react: "^18.0.0",
+            },
+            devDependencies: {
+                jest: "^29.0.0",
+            },
+        };
+        fs.writeFileSync(path.join(projectDir, "package.json"), JSON.stringify(pkg));
+        const srcDir = path.join(projectDir, "src");
+        fs.mkdirSync(srcDir);
+        fs.writeFileSync(path.join(srcDir, "index.ts"), "import React from 'react';\nimport 'jest';\n");
+        const cleaner = new index_1.Cleaner();
+        let output = "";
+        const originalLog = console.log;
+        console.log = (...args) => {
+            output += args.join(" ") + "\n";
+            originalLog(...args);
+        };
+        try {
+            await cleaner.clean(projectDir, { remove: false });
+            expect(output).toContain("No unused dependencies found");
+        }
+        finally {
+            console.log = originalLog;
+        }
+    });
+    it("should respect --keep flag to exclude packages from removal", async () => {
+        const projectDir = path.join(testDir, "test-project-5");
+        fs.mkdirSync(projectDir, { recursive: true });
+        const pkg = {
+            dependencies: {
+                lodash: "^4.17.0",
+                react: "^18.0.0",
+            },
+            devDependencies: {
+                jest: "^29.0.0",
+            },
+        };
+        fs.writeFileSync(path.join(projectDir, "package.json"), JSON.stringify(pkg));
+        const srcDir = path.join(projectDir, "src");
+        fs.mkdirSync(srcDir);
+        fs.writeFileSync(path.join(srcDir, "index.ts"), "import React from 'react';\n");
+        const cleaner = new index_1.Cleaner();
+        let output = "";
+        const originalLog = console.log;
+        console.log = (...args) => {
+            output += args.join(" ") + "\n";
+            originalLog(...args);
+        };
+        try {
+            await cleaner.clean(projectDir, {
+                remove: true,
+                keep: ["lodash"],
+            });
+            // Verify package.json was modified
+            const updated = JSON.parse(fs.readFileSync(path.join(projectDir, "package.json"), "utf-8"));
+            expect(updated.dependencies.react).toBe("^18.0.0");
+            expect(updated.dependencies.lodash).toBe("^4.17.0"); // kept
+            expect(updated.devDependencies.jest).toBeUndefined(); // removed
+        }
+        finally {
+            console.log = originalLog;
+        }
+    });
+    it("should handle malformed package.json gracefully", async () => {
+        const projectDir = path.join(testDir, "test-project-malformed");
+        fs.mkdirSync(projectDir, { recursive: true });
+        // Write invalid JSON
+        fs.writeFileSync(path.join(projectDir, "package.json"), '{ "dependencies": { invalid json');
+        const cleaner = new index_1.Cleaner();
+        try {
+            await cleaner.clean(projectDir);
+            fail("Should have thrown an error");
+        }
+        catch (error) {
+            expect(error).toBeDefined();
+        }
+    });
+    it("should load and respect config file", async () => {
+        const projectDir = path.join(testDir, "test-project-config");
+        fs.mkdirSync(projectDir, { recursive: true });
+        const pkg = {
+            dependencies: {
+                lodash: "^4.17.0",
+                react: "^18.0.0",
+            },
+        };
+        fs.writeFileSync(path.join(projectDir, "package.json"), JSON.stringify(pkg));
+        // Create config file
+        const config = {
+            keep: ["lodash"],
+            verbose: false,
+        };
+        fs.writeFileSync(path.join(projectDir, "pkg-clean.config.json"), JSON.stringify(config));
+        const srcDir = path.join(projectDir, "src");
+        fs.mkdirSync(srcDir);
+        fs.writeFileSync(path.join(srcDir, "index.ts"), "import React from 'react';\n");
+        const cleaner = new index_1.Cleaner();
+        let output = "";
+        const originalLog = console.log;
+        console.log = (...args) => {
+            output += args.join(" ") + "\n";
+            originalLog(...args);
+        };
+        try {
+            await cleaner.clean(projectDir, { remove: true });
+            // Verify config was loaded and lodash was kept
+            const updated = JSON.parse(fs.readFileSync(path.join(projectDir, "package.json"), "utf-8"));
+            expect(updated.dependencies.lodash).toBe("^4.17.0");
+            expect(updated.dependencies.react).toBe("^18.0.0");
+        }
+        finally {
+            console.log = originalLog;
+        }
+    });
+    it("should warn on invalid config file", async () => {
+        const projectDir = path.join(testDir, "test-project-bad-config");
+        fs.mkdirSync(projectDir, { recursive: true });
+        const pkg = {
+            dependencies: {
+                react: "^18.0.0",
+            },
+        };
+        fs.writeFileSync(path.join(projectDir, "package.json"), JSON.stringify(pkg));
+        // Create invalid config
+        fs.writeFileSync(path.join(projectDir, "pkg-clean.config.json"), "{ invalid json");
+        const srcDir = path.join(projectDir, "src");
+        fs.mkdirSync(srcDir);
+        fs.writeFileSync(path.join(srcDir, "index.ts"), "import React from 'react';\n");
+        const cleaner = new index_1.Cleaner();
+        let output = "";
+        const originalLog = console.log;
+        const originalWarn = console.warn;
+        console.log = (...args) => {
+            output += args.join(" ") + "\n";
+            originalLog(...args);
+        };
+        console.warn = (...args) => {
+            output += args.join(" ") + "\n";
+            originalWarn(...args);
+        };
+        try {
+            await cleaner.clean(projectDir);
+            expect(output).toContain("Warning");
+        }
+        finally {
+            console.log = originalLog;
+            console.warn = originalWarn;
+        }
+    });
+});

package/dist/packageManager.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Manages package.json file operations for removing dependencies.
+ */
+export declare class PackageManager {
+    /**
+     * Removes specified packages from both dependencies and devDependencies.
+     * @param projectRoot - The root directory containing package.json
+     * @param packages - Array of package names to remove
+     * @returns True if removal was successful
+     * @throws {Error} If package.json is not found
+     */
+    removeDependencies(projectRoot: string, packages: string[]): boolean;
+}
+//# sourceMappingURL=packageManager.d.ts.map

package/dist/packageManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packageManager.d.ts","sourceRoot":"","sources":["../src/packageManager.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,qBAAa,cAAc;IACzB;;;;;;OAMG;IACH,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO;CAoBrE"}

package/dist/packageManager.js

@@ -0,0 +1,67 @@
+"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.PackageManager = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * Manages package.json file operations for removing dependencies.
+ */
+class PackageManager {
+    /**
+     * Removes specified packages from both dependencies and devDependencies.
+     * @param projectRoot - The root directory containing package.json
+     * @param packages - Array of package names to remove
+     * @returns True if removal was successful
+     * @throws {Error} If package.json is not found
+     */
+    removeDependencies(projectRoot, packages) {
+        const pkgPath = path.join(projectRoot, "package.json");
+        if (!fs.existsSync(pkgPath)) {
+            throw new Error("package.json not found");
+        }
+        const content = fs.readFileSync(pkgPath, "utf-8");
+        const pkg = JSON.parse(content);
+        for (const packageName of packages) {
+            delete pkg.dependencies?.[packageName];
+            delete pkg.devDependencies?.[packageName];
+        }
+        // Pretty print with 2 spaces
+        fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
+        return true;
+    }
+}
+exports.PackageManager = PackageManager;
+//# sourceMappingURL=packageManager.js.map

package/dist/packageManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"packageManager.js","sourceRoot":"","sources":["../src/packageManager.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,uCAAyB;AACzB,2CAA6B;AAE7B;;GAEG;AACH,MAAa,cAAc;IACzB;;;;;;OAMG;IACH,kBAAkB,CAAC,WAAmB,EAAE,QAAkB;QACxD,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,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAClD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAEhC,KAAK,MAAM,WAAW,IAAI,QAAQ,EAAE,CAAC;YACnC,OAAO,GAAG,CAAC,YAAY,EAAE,CAAC,WAAW,CAAC,CAAC;YACvC,OAAO,GAAG,CAAC,eAAe,EAAE,CAAC,WAAW,CAAC,CAAC;QAC5C,CAAC;QAED,6BAA6B;QAC7B,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QAE/D,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AA5BD,wCA4BC"}

package/dist/packageManagerFactory.d.ts

@@ -0,0 +1,37 @@
+export type PackageManagerType = "npm" | "yarn" | "pnpm";
+export interface IPackageManager {
+    /** Get the type of package manager */
+    getType(): PackageManagerType;
+    /** Remove dependencies from package.json */
+    removeDependencies(projectRoot: string, packages: string[]): boolean;
+}
+export interface PackageJson {
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+    [key: string]: unknown;
+}
+/**
+ * Factory for creating package manager instances.
+ * Detects the package manager type based on lock files in the project.
+ */
+export declare class PackageManagerFactory {
+    /**
+     * Detects the package manager type by looking for lock files.
+     * @param projectRoot - The project root directory
+     * @returns The detected package manager type, defaults to 'npm'
+     */
+    static detect(projectRoot: string): PackageManagerType;
+    /**
+     * Creates a package manager instance.
+     * @param type - The type of package manager to create
+     * @returns An instance of the specified package manager
+     */
+    static create(type?: PackageManagerType): IPackageManager;
+    /**
+     * Creates and detects the appropriate package manager for a project.
+     * @param projectRoot - The project root directory
+     * @returns An instance of the detected package manager
+     */
+    static createForProject(projectRoot: string): IPackageManager;
+}
+//# sourceMappingURL=packageManagerFactory.d.ts.map

package/dist/packageManagerFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packageManagerFactory.d.ts","sourceRoot":"","sources":["../src/packageManagerFactory.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAEzD,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,OAAO,IAAI,kBAAkB,CAAC;IAC9B,4CAA4C;IAC5C,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;CACtE;AAED,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;AAsFD;;;GAGG;AACH,qBAAa,qBAAqB;IAChC;;;;OAIG;IACH,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,kBAAkB;IAoBtD;;;;OAIG;IACH,MAAM,CAAC,MAAM,CAAC,IAAI,GAAE,kBAA0B,GAAG,eAAe;IAYhE;;;;OAIG;IACH,MAAM,CAAC,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe;CAI9D"}