whyinstall 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Saumya Kushwah
+
+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,69 @@
+# whyinstall
+
+CLI tool to find why a dependency exists in your JS/TS project. Works with npm, yarn, and pnpm.
+
+## Installation
+
+```bash
+npm install -g whyinstall
+```
+
+Or use with npx:
+
+```bash
+npx whyinstall <package-name>
+```
+
+## Usage
+
+```bash
+whyinstall lodash
+```
+
+### Options
+
+- `-j, --json` - Output results as JSON
+- `-c, --cwd <path>` - Set working directory (default: current directory)
+
+## Features
+
+- Works with npm, Yarn, and pnpm (auto-detection)
+- Shows dependency chains for any package
+- Displays dependency type (prod, dev, peer, optional)
+- Shows package description, version, and size
+- Finds source files that actually use the package
+- Colored tree output for readability
+- JSON output for CI/CD
+- Actionable suggestions for optimization
+
+## Example Output
+
+```
+chalk v5.3.0 (43 KB)
+  Terminal string styling done right
+
+  installed via 1 path
+
+1. prod
+   whyinstall
+   └─> chalk
+
+Used in (2):
+  src/cli.ts
+  src/formatter.ts
+
+Suggested actions:
+  1. Can be removed from direct dependencies - it's installed transitively
+```
+
+## Development
+
+```bash
+npm install
+npm run build
+npm link
+```
+
+## License
+
+MIT

package/dist/analyzer.d.ts

@@ -0,0 +1,3 @@
+import { AnalyzeResult } from './types';
+export declare function analyzePackage(packageName: string, cwd?: string): AnalyzeResult;
+//# sourceMappingURL=analyzer.d.ts.map

package/dist/analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer.d.ts","sourceRoot":"","sources":["../src/analyzer.ts"],"names":[],"mappings":"AAEA,OAAO,EAA+B,aAAa,EAAE,MAAM,SAAS,CAAC;AA+LrE,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,GAAE,MAAsB,GAAG,aAAa,CA6D9F"}

package/dist/analyzer.js

@@ -0,0 +1,216 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.analyzePackage = analyzePackage;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const fileFinder_1 = require("./fileFinder");
+function readPackageJson(path) {
+    try {
+        if ((0, fs_1.existsSync)(path)) {
+            return JSON.parse((0, fs_1.readFileSync)(path, 'utf-8'));
+        }
+    }
+    catch {
+        // ignore
+    }
+    return null;
+}
+function findPackageJsonPath(packageName, cwd) {
+    try {
+        const resolved = require.resolve(`${packageName}/package.json`, { paths: [cwd] });
+        return resolved;
+    }
+    catch {
+        const nodeModulesPath = (0, path_1.join)(cwd, 'node_modules', packageName, 'package.json');
+        if ((0, fs_1.existsSync)(nodeModulesPath)) {
+            return nodeModulesPath;
+        }
+        return null;
+    }
+}
+function findPackageInNodeModules(packageName, basePath) {
+    const possiblePaths = [
+        (0, path_1.join)(basePath, 'node_modules', packageName, 'package.json'),
+        (0, path_1.join)(basePath, packageName, 'package.json')
+    ];
+    for (const path of possiblePaths) {
+        if ((0, fs_1.existsSync)(path)) {
+            return path;
+        }
+    }
+    const parent = (0, path_1.dirname)(basePath);
+    if (parent !== basePath && parent !== '/') {
+        return findPackageInNodeModules(packageName, parent);
+    }
+    return null;
+}
+function findPackageSize(packagePath) {
+    try {
+        const stats = (0, fs_1.statSync)(packagePath);
+        if (stats.isDirectory()) {
+            let totalSize = 0;
+            const files = (0, fs_1.readdirSync)(packagePath);
+            for (const file of files) {
+                const filePath = (0, path_1.join)(packagePath, file);
+                try {
+                    const fileStats = (0, fs_1.statSync)(filePath);
+                    if (fileStats.isDirectory()) {
+                        const subSize = findPackageSize(filePath);
+                        if (subSize)
+                            totalSize += subSize;
+                    }
+                    else {
+                        totalSize += fileStats.size;
+                    }
+                }
+                catch {
+                    // ignore
+                }
+            }
+            return totalSize;
+        }
+    }
+    catch {
+        // ignore
+    }
+    return undefined;
+}
+function getAllDependencies(pkg) {
+    const deps = {};
+    if (pkg.dependencies) {
+        for (const name of Object.keys(pkg.dependencies)) {
+            deps[name] = 'prod';
+        }
+    }
+    if (pkg.devDependencies) {
+        for (const name of Object.keys(pkg.devDependencies)) {
+            deps[name] = 'dev';
+        }
+    }
+    if (pkg.peerDependencies) {
+        for (const name of Object.keys(pkg.peerDependencies)) {
+            deps[name] = 'peer';
+        }
+    }
+    if (pkg.optionalDependencies) {
+        for (const name of Object.keys(pkg.optionalDependencies)) {
+            deps[name] = 'optional';
+        }
+    }
+    return deps;
+}
+function findDependencyPaths(targetPackage, cwd, maxDepth = 10) {
+    const paths = [];
+    const visited = new Set();
+    const rootPackageJson = (0, path_1.join)(cwd, 'package.json');
+    if (!(0, fs_1.existsSync)(rootPackageJson)) {
+        return [];
+    }
+    const queue = [{ packageName: '', chain: [], packageJsonPath: rootPackageJson }];
+    while (queue.length > 0) {
+        const current = queue.shift();
+        if (current.chain.length > maxDepth) {
+            continue;
+        }
+        const pkg = readPackageJson(current.packageJsonPath);
+        if (!pkg) {
+            continue;
+        }
+        const allDeps = getAllDependencies(pkg);
+        const currentPackageName = current.packageName || pkg.name || '';
+        const visitKey = `${currentPackageName}:${current.packageJsonPath}`;
+        if (visited.has(visitKey)) {
+            continue;
+        }
+        visited.add(visitKey);
+        for (const [depName, depType] of Object.entries(allDeps)) {
+            if (depName === targetPackage) {
+                const chain = currentPackageName
+                    ? (current.chain.length > 0 ? [...current.chain, currentPackageName, depName] : [currentPackageName, depName])
+                    : [depName];
+                paths.push({
+                    chain,
+                    type: depType,
+                    packageJsonPath: current.packageJsonPath
+                });
+            }
+            else {
+                const depPackageJsonPath = findPackageInNodeModules(depName, (0, path_1.dirname)(current.packageJsonPath));
+                if (depPackageJsonPath) {
+                    const newChain = currentPackageName
+                        ? (current.chain.length > 0 ? [...current.chain, currentPackageName] : [currentPackageName])
+                        : [];
+                    queue.push({
+                        packageName: depName,
+                        chain: newChain,
+                        packageJsonPath: depPackageJsonPath
+                    });
+                }
+            }
+        }
+    }
+    return paths;
+}
+function formatSize(bytes) {
+    if (!bytes)
+        return '';
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(0)} KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(2)} MB`;
+}
+function analyzePackage(packageName, cwd = process.cwd()) {
+    const rootPackageJson = (0, path_1.join)(cwd, 'package.json');
+    const packageJsonPath = findPackageJsonPath(packageName, cwd);
+    if (!packageJsonPath) {
+        throw new Error(`Package "${packageName}" not found in node_modules`);
+    }
+    const packageDir = (0, path_1.dirname)(packageJsonPath);
+    const pkg = readPackageJson(packageJsonPath);
+    const version = pkg?.version || 'unknown';
+    const description = pkg?.description;
+    const size = findPackageSize(packageDir);
+    let paths = findDependencyPaths(packageName, cwd);
+    // Deduplicate paths with same chain and type
+    const pathKeys = new Set();
+    paths = paths.filter(path => {
+        const key = `${path.type}:${path.chain.join('->')}`;
+        if (pathKeys.has(key)) {
+            return false;
+        }
+        pathKeys.add(key);
+        return true;
+    });
+    const suggestions = [];
+    if (paths.length === 0) {
+        suggestions.push(`Package "${packageName}" is not in dependency tree`);
+    }
+    else {
+        const devPaths = paths.filter(p => p.type === 'dev');
+        const peerPaths = paths.filter(p => p.type === 'peer');
+        if (devPaths.length > 0) {
+            suggestions.push(`Consider removing from devDependencies if not needed for development`);
+        }
+        if (peerPaths.length > 0) {
+            suggestions.push(`This is a peer dependency - ensure all consumers satisfy the peer requirement`);
+        }
+        const directDeps = paths.filter(p => p.chain.length === 1 && p.packageJsonPath === rootPackageJson);
+        if (directDeps.length > 0 && paths.length > directDeps.length) {
+            suggestions.push(`Can be removed from direct dependencies - it's installed transitively`);
+        }
+    }
+    const sourceFiles = (0, fileFinder_1.findFilesUsingPackage)(packageName, cwd);
+    return {
+        package: {
+            name: packageName,
+            version,
+            description,
+            size,
+            paths,
+            sourceFiles: sourceFiles.length > 0 ? sourceFiles : undefined
+        },
+        suggestions
+    };
+}
+//# sourceMappingURL=analyzer.js.map

package/dist/analyzer.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

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,39 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const analyzer_1 = require("./analyzer");
+const formatter_1 = require("./formatter");
+const packageManager_1 = require("./packageManager");
+const program = new commander_1.Command();
+program
+    .name('whyinstall')
+    .description('Find why a dependency exists in your JS/TS project')
+    .version('0.1.0')
+    .argument('<package-name>', 'Package name to analyze')
+    .option('-j, --json', 'Output as JSON')
+    .option('-c, --cwd <path>', 'Working directory', process.cwd())
+    .action((packageName, options) => {
+    try {
+        const cwd = options.cwd || process.cwd();
+        const pm = (0, packageManager_1.detectPackageManager)(cwd);
+        if (!options.json) {
+            console.log(`\n${chalk_1.default.gray(`Detected package manager: ${pm}`)}\n`);
+        }
+        const result = (0, analyzer_1.analyzePackage)(packageName, cwd);
+        const output = (0, formatter_1.formatOutput)(result, options.json);
+        console.log(output);
+        process.exit(0);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(chalk_1.default.red(`Error: ${message}`));
+        process.exit(1);
+    }
+});
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;;;;;AAEA,yCAAoC;AACpC,kDAA0B;AAC1B,yCAA4C;AAC5C,2CAA2C;AAC3C,qDAAwD;AAExD,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,YAAY,CAAC;KAClB,WAAW,CAAC,oDAAoD,CAAC;KACjE,OAAO,CAAC,OAAO,CAAC;KAChB,QAAQ,CAAC,gBAAgB,EAAE,yBAAyB,CAAC;KACrD,MAAM,CAAC,YAAY,EAAE,gBAAgB,CAAC;KACtC,MAAM,CAAC,kBAAkB,EAAE,mBAAmB,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;KAC9D,MAAM,CAAC,CAAC,WAAmB,EAAE,OAAyC,EAAE,EAAE;IACzE,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QACzC,MAAM,EAAE,GAAG,IAAA,qCAAoB,EAAC,GAAG,CAAC,CAAC;QAErC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YAClB,OAAO,CAAC,GAAG,CAAC,KAAK,eAAK,CAAC,IAAI,CAAC,6BAA6B,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;QACtE,CAAC;QAED,MAAM,MAAM,GAAG,IAAA,yBAAc,EAAC,WAAW,EAAE,GAAG,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,IAAA,wBAAY,EAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAClD,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAEpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,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,eAAK,CAAC,GAAG,CAAC,UAAU,OAAO,EAAE,CAAC,CAAC,CAAC;QAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/fileFinder.d.ts

@@ -0,0 +1,2 @@
+export declare function findFilesUsingPackage(packageName: string, cwd: string): string[];
+//# sourceMappingURL=fileFinder.d.ts.map

package/dist/fileFinder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileFinder.d.ts","sourceRoot":"","sources":["../src/fileFinder.ts"],"names":[],"mappings":"AAiEA,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAYhF"}

package/dist/fileFinder.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findFilesUsingPackage = findFilesUsingPackage;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const SOURCE_EXTENSIONS = ['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs'];
+const IGNORE_DIRS = ['node_modules', '.git', 'dist', 'build', '.next', 'coverage'];
+function shouldIgnoreDir(dirName) {
+    return IGNORE_DIRS.includes(dirName) || dirName.startsWith('.');
+}
+function isSourceFile(filePath) {
+    return SOURCE_EXTENSIONS.includes((0, path_1.extname)(filePath));
+}
+function findSourceFiles(dir, maxDepth = 5, currentDepth = 0) {
+    if (currentDepth > maxDepth) {
+        return [];
+    }
+    const files = [];
+    try {
+        const entries = (0, fs_1.readdirSync)(dir);
+        for (const entry of entries) {
+            const fullPath = (0, path_1.join)(dir, entry);
+            try {
+                const stats = (0, fs_1.statSync)(fullPath);
+                if (stats.isDirectory()) {
+                    if (!shouldIgnoreDir(entry)) {
+                        files.push(...findSourceFiles(fullPath, maxDepth, currentDepth + 1));
+                    }
+                }
+                else if (stats.isFile() && isSourceFile(fullPath)) {
+                    files.push(fullPath);
+                }
+            }
+            catch {
+                // ignore errors for individual files/dirs
+            }
+        }
+    }
+    catch {
+        // ignore errors
+    }
+    return files;
+}
+function fileContainsPackage(filePath, packageName) {
+    try {
+        const content = (0, fs_1.readFileSync)(filePath, 'utf-8');
+        const patterns = [
+            new RegExp(`require\\(['"]${packageName}(/.*)?['"]\\)`, 'g'),
+            new RegExp(`from\\s+['"]${packageName}(/.*)?['"]`, 'g'),
+            new RegExp(`import\\s+.*\\s+from\\s+['"]${packageName}(/.*)?['"]`, 'g'),
+            new RegExp(`import\\s+['"]${packageName}(/.*)?['"]`, 'g'),
+        ];
+        return patterns.some(pattern => pattern.test(content));
+    }
+    catch {
+        return false;
+    }
+}
+function findFilesUsingPackage(packageName, cwd) {
+    const sourceFiles = findSourceFiles(cwd);
+    const matchingFiles = [];
+    for (const file of sourceFiles) {
+        if (fileContainsPackage(file, packageName)) {
+            const relativePath = file.replace(cwd + '/', '');
+            matchingFiles.push(relativePath);
+        }
+    }
+    return matchingFiles;
+}
+//# sourceMappingURL=fileFinder.js.map

package/dist/fileFinder.js.map

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

package/dist/formatter.d.ts

@@ -0,0 +1,3 @@
+import { AnalyzeResult } from './types';
+export declare function formatOutput(result: AnalyzeResult, json?: boolean): string;
+//# sourceMappingURL=formatter.d.ts.map

package/dist/formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../src/formatter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAkB,MAAM,SAAS,CAAC;AAwDxD,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,GAAE,OAAe,GAAG,MAAM,CA8CjF"}

package/dist/formatter.js

@@ -0,0 +1,101 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatOutput = formatOutput;
+const chalk_1 = __importDefault(require("chalk"));
+function formatSize(bytes) {
+    if (!bytes)
+        return '';
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(0)} KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(2)} MB`;
+}
+function formatChain(chain, isLast) {
+    if (chain.length === 0)
+        return '';
+    const parts = [];
+    for (let i = 0; i < chain.length; i++) {
+        const isLastInChain = i === chain.length - 1;
+        let prefix;
+        let indent = '';
+        if (i === 0) {
+            prefix = '';
+            indent = '   ';
+        }
+        else {
+            indent = '   ' + ' '.repeat((i - 1) * 3);
+            if (isLastInChain) {
+                prefix = '└─> ';
+            }
+            else {
+                prefix = '├─> ';
+            }
+        }
+        let packageName = chain[i];
+        if (packageName.includes('node_modules/')) {
+            packageName = chalk_1.default.gray(packageName.replace(/.*node_modules\//, 'node_modules/'));
+        }
+        else if (packageName.includes('/')) {
+            packageName = chalk_1.default.white(packageName);
+        }
+        else {
+            packageName = chalk_1.default.cyan(packageName);
+        }
+        parts.push(`${indent}${prefix}${packageName}`);
+    }
+    return parts.join('\n');
+}
+function getTypeLabel(type) {
+    const labels = {
+        prod: chalk_1.default.green('prod'),
+        dev: chalk_1.default.yellow('dev'),
+        peer: chalk_1.default.blue('peer'),
+        optional: chalk_1.default.gray('optional')
+    };
+    return labels[type] || type;
+}
+function formatOutput(result, json = false) {
+    if (json) {
+        return JSON.stringify(result, null, 2);
+    }
+    const { package: pkg, suggestions } = result;
+    const sizeStr = pkg.size ? formatSize(pkg.size) : '';
+    const sizeDisplay = sizeStr ? ` (${sizeStr})` : '';
+    let output = '';
+    output += chalk_1.default.bold.cyan(`${pkg.name}`) + chalk_1.default.gray(` v${pkg.version}`) + chalk_1.default.dim(`${sizeDisplay}`) + '\n';
+    if (pkg.description) {
+        output += chalk_1.default.white(`  ${pkg.description}\n`);
+    }
+    output += '\n' + chalk_1.default.dim(`  installed via ${pkg.paths.length} path${pkg.paths.length !== 1 ? 's' : ''}\n\n`);
+    if (pkg.paths.length === 0) {
+        output += chalk_1.default.yellow('  No dependency paths found.\n');
+    }
+    else {
+        pkg.paths.forEach((path, index) => {
+            const pathNum = chalk_1.default.gray(`${index + 1}.`);
+            const typeLabel = getTypeLabel(path.type);
+            let chainDisplay = path.chain.length > 0 ? path.chain : [pkg.name];
+            output += `${pathNum} ${typeLabel}\n`;
+            output += formatChain(chainDisplay, index === pkg.paths.length - 1);
+            output += '\n';
+        });
+    }
+    if (pkg.sourceFiles && pkg.sourceFiles.length > 0) {
+        output += '\n' + chalk_1.default.bold(`Used in (${pkg.sourceFiles.length}):`) + '\n';
+        pkg.sourceFiles.forEach((file) => {
+            output += `  ${chalk_1.default.blue(file)}\n`;
+        });
+    }
+    if (suggestions.length > 0) {
+        output += '\n' + chalk_1.default.bold('Suggested actions:') + '\n';
+        suggestions.forEach((suggestion, index) => {
+            output += `  ${index + 1}. ${chalk_1.default.gray(suggestion)}\n`;
+        });
+    }
+    return output;
+}
+//# sourceMappingURL=formatter.js.map

package/dist/formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.js","sourceRoot":"","sources":["../src/formatter.ts"],"names":[],"mappings":";;;;;AAyDA,oCA8CC;AAvGD,kDAA0B;AAG1B,SAAS,UAAU,CAAC,KAAyB;IAC3C,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,IAAI,KAAK,GAAG,IAAI;QAAE,OAAO,GAAG,KAAK,IAAI,CAAC;IACtC,IAAI,KAAK,GAAG,IAAI,GAAG,IAAI;QAAE,OAAO,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;IAClE,OAAO,GAAG,CAAC,KAAK,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;AACpD,CAAC;AAED,SAAS,WAAW,CAAC,KAAe,EAAE,MAAe;IACnD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAElC,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,aAAa,GAAG,CAAC,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;QAC7C,IAAI,MAAc,CAAC;QACnB,IAAI,MAAM,GAAG,EAAE,CAAC;QAEhB,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACZ,MAAM,GAAG,EAAE,CAAC;YACZ,MAAM,GAAG,KAAK,CAAC;QACjB,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACzC,IAAI,aAAa,EAAE,CAAC;gBAClB,MAAM,GAAG,MAAM,CAAC;YAClB,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG,MAAM,CAAC;YAClB,CAAC;QACH,CAAC;QAED,IAAI,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAC3B,IAAI,WAAW,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;YAC1C,WAAW,GAAG,eAAK,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,kBAAkB,EAAE,eAAe,CAAC,CAAC,CAAC;QACrF,CAAC;aAAM,IAAI,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACrC,WAAW,GAAG,eAAK,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QACzC,CAAC;aAAM,CAAC;YACN,WAAW,GAAG,eAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACxC,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,GAAG,MAAM,GAAG,WAAW,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,YAAY,CAAC,IAA4B;IAChD,MAAM,MAAM,GAAG;QACb,IAAI,EAAE,eAAK,CAAC,KAAK,CAAC,MAAM,CAAC;QACzB,GAAG,EAAE,eAAK,CAAC,MAAM,CAAC,KAAK,CAAC;QACxB,IAAI,EAAE,eAAK,CAAC,IAAI,CAAC,MAAM,CAAC;QACxB,QAAQ,EAAE,eAAK,CAAC,IAAI,CAAC,UAAU,CAAC;KACjC,CAAC;IACF,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;AAC9B,CAAC;AAED,SAAgB,YAAY,CAAC,MAAqB,EAAE,OAAgB,KAAK;IACvE,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;IAC7C,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACrD,MAAM,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAEnD,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,MAAM,IAAI,eAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,eAAK,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC,GAAG,eAAK,CAAC,GAAG,CAAC,GAAG,WAAW,EAAE,CAAC,GAAG,IAAI,CAAC;IAC/G,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;QACpB,MAAM,IAAI,eAAK,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,WAAW,IAAI,CAAC,CAAC;IAClD,CAAC;IACD,MAAM,IAAI,IAAI,GAAG,eAAK,CAAC,GAAG,CAAC,mBAAmB,GAAG,CAAC,KAAK,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAE/G,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,eAAK,CAAC,MAAM,CAAC,gCAAgC,CAAC,CAAC;IAC3D,CAAC;SAAM,CAAC;QACN,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;YAChC,MAAM,OAAO,GAAG,eAAK,CAAC,IAAI,CAAC,GAAG,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC;YAC5C,MAAM,SAAS,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAE1C,IAAI,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAEnE,MAAM,IAAI,GAAG,OAAO,IAAI,SAAS,IAAI,CAAC;YACtC,MAAM,IAAI,WAAW,CAAC,YAAY,EAAE,KAAK,KAAK,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACpE,MAAM,IAAI,IAAI,CAAC;QACjB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,IAAI,GAAG,eAAK,CAAC,IAAI,CAAC,YAAY,GAAG,CAAC,WAAW,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC;QAC3E,GAAG,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;YAC/B,MAAM,IAAI,KAAK,eAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;QACtC,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,IAAI,GAAG,eAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,GAAG,IAAI,CAAC;QACzD,WAAW,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,KAAK,EAAE,EAAE;YACxC,MAAM,IAAI,KAAK,KAAK,GAAG,CAAC,KAAK,eAAK,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAC1D,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/packageManager.d.ts

@@ -0,0 +1,4 @@
+import { PackageManager } from './types';
+export declare function detectPackageManager(cwd?: string): PackageManager;
+export declare function getLockFilePath(cwd: string, pm: PackageManager): string;
+//# 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":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEzC,wBAAgB,oBAAoB,CAAC,GAAG,GAAE,MAAsB,GAAG,cAAc,CAWhF;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,cAAc,GAAG,MAAM,CAOvE"}

package/dist/packageManager.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectPackageManager = detectPackageManager;
+exports.getLockFilePath = getLockFilePath;
+const fs_1 = require("fs");
+const path_1 = require("path");
+function detectPackageManager(cwd = process.cwd()) {
+    if ((0, fs_1.existsSync)((0, path_1.join)(cwd, 'pnpm-lock.yaml'))) {
+        return 'pnpm';
+    }
+    if ((0, fs_1.existsSync)((0, path_1.join)(cwd, 'yarn.lock'))) {
+        return 'yarn';
+    }
+    if ((0, fs_1.existsSync)((0, path_1.join)(cwd, 'package-lock.json'))) {
+        return 'npm';
+    }
+    return 'npm';
+}
+function getLockFilePath(cwd, pm) {
+    const paths = {
+        npm: 'package-lock.json',
+        yarn: 'yarn.lock',
+        pnpm: 'pnpm-lock.yaml'
+    };
+    return (0, path_1.join)(cwd, paths[pm]);
+}
+//# sourceMappingURL=packageManager.js.map

package/dist/packageManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"packageManager.js","sourceRoot":"","sources":["../src/packageManager.ts"],"names":[],"mappings":";;AAIA,oDAWC;AAED,0CAOC;AAxBD,2BAAgC;AAChC,+BAA4B;AAG5B,SAAgB,oBAAoB,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE;IAC9D,IAAI,IAAA,eAAU,EAAC,IAAA,WAAI,EAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC;QAC5C,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,IAAA,eAAU,EAAC,IAAA,WAAI,EAAC,GAAG,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC;QACvC,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,IAAA,eAAU,EAAC,IAAA,WAAI,EAAC,GAAG,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC;QAC/C,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAgB,eAAe,CAAC,GAAW,EAAE,EAAkB;IAC7D,MAAM,KAAK,GAAG;QACZ,GAAG,EAAE,mBAAmB;QACxB,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,gBAAgB;KACvB,CAAC;IACF,OAAO,IAAA,WAAI,EAAC,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;AAC9B,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,19 @@
+export interface DependencyPath {
+    chain: string[];
+    type: 'prod' | 'dev' | 'peer' | 'optional';
+    packageJsonPath?: string;
+}
+export interface PackageInfo {
+    name: string;
+    version: string;
+    description?: string;
+    size?: number;
+    paths: DependencyPath[];
+    sourceFiles?: string[];
+}
+export interface AnalyzeResult {
+    package: PackageInfo;
+    suggestions: string[];
+}
+export type PackageManager = 'npm' | 'yarn' | 'pnpm';
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,UAAU,CAAC;IAC3C,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,WAAW,CAAC;IACrB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "whyinstall",
+  "version": "0.1.0",
+  "description": "CLI tool to find why a dependency exists in your JS/TS project",
+  "main": "dist/index.js",
+  "bin": {
+    "whyinstall": "dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "dependencies",
+    "cli",
+    "npm",
+    "yarn",
+    "pnpm",
+    "dependency-tree"
+  ],
+  "author": "Saumya Kushwah",
+  "license": "MIT",
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^11.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "typescript": "^5.3.3"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  }
+}

package/src/analyzer.ts

@@ -0,0 +1,255 @@
+import { readFileSync, existsSync, readdirSync, statSync } from 'fs';
+import { join, dirname } from 'path';
+import { PackageInfo, DependencyPath, AnalyzeResult } from './types';
+import { detectPackageManager } from './packageManager';
+import { findFilesUsingPackage } from './fileFinder';
+
+interface PackageJson {
+  name?: string;
+  version?: string;
+  description?: string;
+  dependencies?: Record<string, string>;
+  devDependencies?: Record<string, string>;
+  peerDependencies?: Record<string, string>;
+  optionalDependencies?: Record<string, string>;
+}
+
+function readPackageJson(path: string): PackageJson | null {
+  try {
+    if (existsSync(path)) {
+      return JSON.parse(readFileSync(path, 'utf-8'));
+    }
+  } catch {
+    // ignore
+  }
+  return null;
+}
+
+function findPackageJsonPath(packageName: string, cwd: string): string | null {
+  try {
+    const resolved = require.resolve(`${packageName}/package.json`, { paths: [cwd] });
+    return resolved;
+  } catch {
+    const nodeModulesPath = join(cwd, 'node_modules', packageName, 'package.json');
+    if (existsSync(nodeModulesPath)) {
+      return nodeModulesPath;
+    }
+    return null;
+  }
+}
+
+function findPackageInNodeModules(packageName: string, basePath: string): string | null {
+  const possiblePaths = [
+    join(basePath, 'node_modules', packageName, 'package.json'),
+    join(basePath, packageName, 'package.json')
+  ];
+  
+  for (const path of possiblePaths) {
+    if (existsSync(path)) {
+      return path;
+    }
+  }
+  
+  const parent = dirname(basePath);
+  if (parent !== basePath && parent !== '/') {
+    return findPackageInNodeModules(packageName, parent);
+  }
+  
+  return null;
+}
+
+function findPackageSize(packagePath: string): number | undefined {
+  try {
+    const stats = statSync(packagePath);
+    if (stats.isDirectory()) {
+      let totalSize = 0;
+      const files = readdirSync(packagePath);
+      for (const file of files) {
+        const filePath = join(packagePath, file);
+        try {
+          const fileStats = statSync(filePath);
+          if (fileStats.isDirectory()) {
+            const subSize = findPackageSize(filePath);
+            if (subSize) totalSize += subSize;
+          } else {
+            totalSize += fileStats.size;
+          }
+        } catch {
+          // ignore
+        }
+      }
+      return totalSize;
+    }
+  } catch {
+    // ignore
+  }
+  return undefined;
+}
+
+function getAllDependencies(pkg: PackageJson): Record<string, 'prod' | 'dev' | 'peer' | 'optional'> {
+  const deps: Record<string, 'prod' | 'dev' | 'peer' | 'optional'> = {};
+  
+  if (pkg.dependencies) {
+    for (const name of Object.keys(pkg.dependencies)) {
+      deps[name] = 'prod';
+    }
+  }
+  if (pkg.devDependencies) {
+    for (const name of Object.keys(pkg.devDependencies)) {
+      deps[name] = 'dev';
+    }
+  }
+  if (pkg.peerDependencies) {
+    for (const name of Object.keys(pkg.peerDependencies)) {
+      deps[name] = 'peer';
+    }
+  }
+  if (pkg.optionalDependencies) {
+    for (const name of Object.keys(pkg.optionalDependencies)) {
+      deps[name] = 'optional';
+    }
+  }
+  
+  return deps;
+}
+
+function findDependencyPaths(
+  targetPackage: string,
+  cwd: string,
+  maxDepth: number = 10
+): DependencyPath[] {
+  const paths: DependencyPath[] = [];
+  const visited = new Set<string>();
+  
+  interface QueueItem {
+    packageName: string;
+    chain: string[];
+    packageJsonPath: string;
+  }
+  
+  const rootPackageJson = join(cwd, 'package.json');
+  if (!existsSync(rootPackageJson)) {
+    return [];
+  }
+  
+  const queue: QueueItem[] = [{ packageName: '', chain: [], packageJsonPath: rootPackageJson }];
+  
+  while (queue.length > 0) {
+    const current = queue.shift()!;
+    
+    if (current.chain.length > maxDepth) {
+      continue;
+    }
+    
+    const pkg = readPackageJson(current.packageJsonPath);
+    if (!pkg) {
+      continue;
+    }
+    
+    const allDeps = getAllDependencies(pkg);
+    const currentPackageName = current.packageName || pkg.name || '';
+    
+    const visitKey = `${currentPackageName}:${current.packageJsonPath}`;
+    if (visited.has(visitKey)) {
+      continue;
+    }
+    visited.add(visitKey);
+    
+    for (const [depName, depType] of Object.entries(allDeps)) {
+      if (depName === targetPackage) {
+        const chain = currentPackageName 
+          ? (current.chain.length > 0 ? [...current.chain, currentPackageName, depName] : [currentPackageName, depName])
+          : [depName];
+        paths.push({
+          chain,
+          type: depType,
+          packageJsonPath: current.packageJsonPath
+        });
+      } else {
+        const depPackageJsonPath = findPackageInNodeModules(depName, dirname(current.packageJsonPath));
+        if (depPackageJsonPath) {
+          const newChain = currentPackageName 
+            ? (current.chain.length > 0 ? [...current.chain, currentPackageName] : [currentPackageName])
+            : [];
+          queue.push({
+            packageName: depName,
+            chain: newChain,
+            packageJsonPath: depPackageJsonPath
+          });
+        }
+      }
+    }
+  }
+  
+  return paths;
+}
+
+function formatSize(bytes: number | undefined): string {
+  if (!bytes) return '';
+  if (bytes < 1024) return `${bytes} B`;
+  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(0)} KB`;
+  return `${(bytes / (1024 * 1024)).toFixed(2)} MB`;
+}
+
+export function analyzePackage(packageName: string, cwd: string = process.cwd()): AnalyzeResult {
+  const rootPackageJson = join(cwd, 'package.json');
+  const packageJsonPath = findPackageJsonPath(packageName, cwd);
+  if (!packageJsonPath) {
+    throw new Error(`Package "${packageName}" not found in node_modules`);
+  }
+  
+  const packageDir = dirname(packageJsonPath);
+  const pkg = readPackageJson(packageJsonPath);
+  const version = pkg?.version || 'unknown';
+  const description = pkg?.description;
+  
+  const size = findPackageSize(packageDir);
+  
+  let paths = findDependencyPaths(packageName, cwd);
+  
+  // Deduplicate paths with same chain and type
+  const pathKeys = new Set<string>();
+  paths = paths.filter(path => {
+    const key = `${path.type}:${path.chain.join('->')}`;
+    if (pathKeys.has(key)) {
+      return false;
+    }
+    pathKeys.add(key);
+    return true;
+  });
+  
+  const suggestions: string[] = [];
+  
+  if (paths.length === 0) {
+    suggestions.push(`Package "${packageName}" is not in dependency tree`);
+  } else {
+    const devPaths = paths.filter(p => p.type === 'dev');
+    const peerPaths = paths.filter(p => p.type === 'peer');
+    
+    if (devPaths.length > 0) {
+      suggestions.push(`Consider removing from devDependencies if not needed for development`);
+    }
+    if (peerPaths.length > 0) {
+      suggestions.push(`This is a peer dependency - ensure all consumers satisfy the peer requirement`);
+    }
+    
+    const directDeps = paths.filter(p => p.chain.length === 1 && p.packageJsonPath === rootPackageJson);
+    if (directDeps.length > 0 && paths.length > directDeps.length) {
+      suggestions.push(`Can be removed from direct dependencies - it's installed transitively`);
+    }
+  }
+  
+  const sourceFiles = findFilesUsingPackage(packageName, cwd);
+  
+  return {
+    package: {
+      name: packageName,
+      version,
+      description,
+      size,
+      paths,
+      sourceFiles: sourceFiles.length > 0 ? sourceFiles : undefined
+    },
+    suggestions
+  };
+}

package/src/cli.ts

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { analyzePackage } from './analyzer';
+import { formatOutput } from './formatter';
+import { detectPackageManager } from './packageManager';
+
+const program = new Command();
+
+program
+  .name('whyinstall')
+  .description('Find why a dependency exists in your JS/TS project')
+  .version('0.1.0')
+  .argument('<package-name>', 'Package name to analyze')
+  .option('-j, --json', 'Output as JSON')
+  .option('-c, --cwd <path>', 'Working directory', process.cwd())
+  .action((packageName: string, options: { json?: boolean; cwd?: string }) => {
+    try {
+      const cwd = options.cwd || process.cwd();
+      const pm = detectPackageManager(cwd);
+      
+      if (!options.json) {
+        console.log(`\n${chalk.gray(`Detected package manager: ${pm}`)}\n`);
+      }
+      
+      const result = analyzePackage(packageName, cwd);
+      const output = formatOutput(result, options.json);
+      console.log(output);
+      
+      process.exit(0);
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      console.error(chalk.red(`Error: ${message}`));
+      process.exit(1);
+    }
+  });
+
+program.parse();

package/src/fileFinder.ts

@@ -0,0 +1,78 @@
+import { readdirSync, readFileSync, statSync } from 'fs';
+import { join, extname } from 'path';
+
+const SOURCE_EXTENSIONS = ['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs'];
+const IGNORE_DIRS = ['node_modules', '.git', 'dist', 'build', '.next', 'coverage'];
+
+function shouldIgnoreDir(dirName: string): boolean {
+  return IGNORE_DIRS.includes(dirName) || dirName.startsWith('.');
+}
+
+function isSourceFile(filePath: string): boolean {
+  return SOURCE_EXTENSIONS.includes(extname(filePath));
+}
+
+function findSourceFiles(dir: string, maxDepth: number = 5, currentDepth: number = 0): string[] {
+  if (currentDepth > maxDepth) {
+    return [];
+  }
+
+  const files: string[] = [];
+
+  try {
+    const entries = readdirSync(dir);
+    
+    for (const entry of entries) {
+      const fullPath = join(dir, entry);
+      
+      try {
+        const stats = statSync(fullPath);
+        
+        if (stats.isDirectory()) {
+          if (!shouldIgnoreDir(entry)) {
+            files.push(...findSourceFiles(fullPath, maxDepth, currentDepth + 1));
+          }
+        } else if (stats.isFile() && isSourceFile(fullPath)) {
+          files.push(fullPath);
+        }
+      } catch {
+        // ignore errors for individual files/dirs
+      }
+    }
+  } catch {
+    // ignore errors
+  }
+
+  return files;
+}
+
+function fileContainsPackage(filePath: string, packageName: string): boolean {
+  try {
+    const content = readFileSync(filePath, 'utf-8');
+    
+    const patterns = [
+      new RegExp(`require\\(['"]${packageName}(/.*)?['"]\\)`, 'g'),
+      new RegExp(`from\\s+['"]${packageName}(/.*)?['"]`, 'g'),
+      new RegExp(`import\\s+.*\\s+from\\s+['"]${packageName}(/.*)?['"]`, 'g'),
+      new RegExp(`import\\s+['"]${packageName}(/.*)?['"]`, 'g'),
+    ];
+    
+    return patterns.some(pattern => pattern.test(content));
+  } catch {
+    return false;
+  }
+}
+
+export function findFilesUsingPackage(packageName: string, cwd: string): string[] {
+  const sourceFiles = findSourceFiles(cwd);
+  const matchingFiles: string[] = [];
+  
+  for (const file of sourceFiles) {
+    if (fileContainsPackage(file, packageName)) {
+      const relativePath = file.replace(cwd + '/', '');
+      matchingFiles.push(relativePath);
+    }
+  }
+  
+  return matchingFiles;
+}

package/src/formatter.ts

@@ -0,0 +1,104 @@
+import chalk from 'chalk';
+import { AnalyzeResult, DependencyPath } from './types';
+
+function formatSize(bytes: number | undefined): string {
+  if (!bytes) return '';
+  if (bytes < 1024) return `${bytes} B`;
+  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(0)} KB`;
+  return `${(bytes / (1024 * 1024)).toFixed(2)} MB`;
+}
+
+function formatChain(chain: string[], isLast: boolean): string {
+  if (chain.length === 0) return '';
+  
+  const parts: string[] = [];
+  
+  for (let i = 0; i < chain.length; i++) {
+    const isLastInChain = i === chain.length - 1;
+    let prefix: string;
+    let indent = '';
+    
+    if (i === 0) {
+      prefix = '';
+      indent = '   ';
+    } else {
+      indent = '   ' + ' '.repeat((i - 1) * 3);
+      if (isLastInChain) {
+        prefix = '└─> ';
+      } else {
+        prefix = '├─> ';
+      }
+    }
+    
+    let packageName = chain[i];
+    if (packageName.includes('node_modules/')) {
+      packageName = chalk.gray(packageName.replace(/.*node_modules\//, 'node_modules/'));
+    } else if (packageName.includes('/')) {
+      packageName = chalk.white(packageName);
+    } else {
+      packageName = chalk.cyan(packageName);
+    }
+    
+    parts.push(`${indent}${prefix}${packageName}`);
+  }
+  
+  return parts.join('\n');
+}
+
+function getTypeLabel(type: DependencyPath['type']): string {
+  const labels = {
+    prod: chalk.green('prod'),
+    dev: chalk.yellow('dev'),
+    peer: chalk.blue('peer'),
+    optional: chalk.gray('optional')
+  };
+  return labels[type] || type;
+}
+
+export function formatOutput(result: AnalyzeResult, json: boolean = false): string {
+  if (json) {
+    return JSON.stringify(result, null, 2);
+  }
+  
+  const { package: pkg, suggestions } = result;
+  const sizeStr = pkg.size ? formatSize(pkg.size) : '';
+  const sizeDisplay = sizeStr ? ` (${sizeStr})` : '';
+  
+  let output = '';
+  output += chalk.bold.cyan(`${pkg.name}`) + chalk.gray(` v${pkg.version}`) + chalk.dim(`${sizeDisplay}`) + '\n';
+  if (pkg.description) {
+    output += chalk.white(`  ${pkg.description}\n`);
+  }
+  output += '\n' + chalk.dim(`  installed via ${pkg.paths.length} path${pkg.paths.length !== 1 ? 's' : ''}\n\n`);
+  
+  if (pkg.paths.length === 0) {
+    output += chalk.yellow('  No dependency paths found.\n');
+  } else {
+    pkg.paths.forEach((path, index) => {
+      const pathNum = chalk.gray(`${index + 1}.`);
+      const typeLabel = getTypeLabel(path.type);
+      
+      let chainDisplay = path.chain.length > 0 ? path.chain : [pkg.name];
+      
+      output += `${pathNum} ${typeLabel}\n`;
+      output += formatChain(chainDisplay, index === pkg.paths.length - 1);
+      output += '\n';
+    });
+  }
+  
+  if (pkg.sourceFiles && pkg.sourceFiles.length > 0) {
+    output += '\n' + chalk.bold(`Used in (${pkg.sourceFiles.length}):`) + '\n';
+    pkg.sourceFiles.forEach((file) => {
+      output += `  ${chalk.blue(file)}\n`;
+    });
+  }
+  
+  if (suggestions.length > 0) {
+    output += '\n' + chalk.bold('Suggested actions:') + '\n';
+    suggestions.forEach((suggestion, index) => {
+      output += `  ${index + 1}. ${chalk.gray(suggestion)}\n`;
+    });
+  }
+  
+  return output;
+}

package/src/packageManager.ts

@@ -0,0 +1,25 @@
+import { existsSync } from 'fs';
+import { join } from 'path';
+import { PackageManager } from './types';
+
+export function detectPackageManager(cwd: string = process.cwd()): PackageManager {
+  if (existsSync(join(cwd, 'pnpm-lock.yaml'))) {
+    return 'pnpm';
+  }
+  if (existsSync(join(cwd, 'yarn.lock'))) {
+    return 'yarn';
+  }
+  if (existsSync(join(cwd, 'package-lock.json'))) {
+    return 'npm';
+  }
+  return 'npm';
+}
+
+export function getLockFilePath(cwd: string, pm: PackageManager): string {
+  const paths = {
+    npm: 'package-lock.json',
+    yarn: 'yarn.lock',
+    pnpm: 'pnpm-lock.yaml'
+  };
+  return join(cwd, paths[pm]);
+}

package/src/types.ts

@@ -0,0 +1,21 @@
+export interface DependencyPath {
+  chain: string[];
+  type: 'prod' | 'dev' | 'peer' | 'optional';
+  packageJsonPath?: string;
+}
+
+export interface PackageInfo {
+  name: string;
+  version: string;
+  description?: string;
+  size?: number;
+  paths: DependencyPath[];
+  sourceFiles?: string[];
+}
+
+export interface AnalyzeResult {
+  package: PackageInfo;
+  suggestions: string[];
+}
+
+export type PackageManager = 'npm' | 'yarn' | 'pnpm';

package/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "lib": ["ES2020"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "moduleResolution": "node",
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}