treeshake-check 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,178 @@
+# treeshake-check
+
+A production-grade CLI tool to analyze JavaScript/TypeScript React applications for tree-shaking issues.
+
+## Features
+
+- 🔍 **Auto-detect bundlers** - Vite, Webpack, Rollup, esbuild
+- 🌳 **Barrel file analysis** - Detect `export *` patterns that break tree-shaking
+- ⚠️ **Side effects detection** - Find top-level code that prevents dead code elimination
+- 📦 **CommonJS detection** - Identify modules that don't tree-shake
+- 📊 **Bundle stats parsing** - Analyze webpack stats.json, esbuild metafile, Vite/Rollup output
+- 💡 **Fix suggestions** - Actionable recommendations for each issue
+- 📋 **Multiple output formats** - Human-readable text or JSON for CI
+
+## Installation
+
+```bash
+npm install -g treeshake-check
+
+# Or use directly with npx
+npx treeshake-check analyze
+```
+
+## Usage
+
+### Analyze a project
+
+```bash
+# Analyze current directory (auto-detect bundler)
+treeshake-check analyze
+
+# Analyze a specific directory
+treeshake-check analyze ./my-react-app
+
+# With specific bundler stats
+treeshake-check analyze --stats dist/stats.json
+```
+
+### CLI Options
+
+```bash
+treeshake-check analyze [path] [options]
+
+Options:
+  -b, --bundler <type>       Force bundler type (vite|webpack|rollup|esbuild)
+  -s, --stats <file>         Path to bundle stats/metafile
+  -o, --output <format>      Output format (text|json) (default: "text")
+  -t, --threshold <bytes>    Minimum size to report (default: "0")
+  --no-suggestions           Hide fix suggestions
+  -i, --include <patterns>   Glob patterns to include
+  -e, --exclude <patterns>   Glob patterns to exclude
+```
+
+### Generate bundle stats
+
+#### Webpack
+
+```bash
+webpack --json > stats.json
+treeshake-check analyze --stats stats.json
+```
+
+#### Vite/Rollup
+
+```bash
+# Install rollup-plugin-visualizer
+npm install -D rollup-plugin-visualizer
+
+# Configure in vite.config.ts
+import { visualizer } from 'rollup-plugin-visualizer';
+
+export default defineConfig({
+  plugins: [
+    visualizer({ filename: 'stats.json', json: true })
+  ]
+});
+```
+
+#### esbuild
+
+```javascript
+// Enable metafile in build
+await esbuild
+  .build({
+    entryPoints: ["src/index.ts"],
+    bundle: true,
+    metafile: true,
+    outfile: "dist/bundle.js",
+  })
+  .then((result) => {
+    fs.writeFileSync("meta.json", JSON.stringify(result.metafile));
+  });
+```
+
+## Example Output
+
+```
+🔍 Tree-Shaking Analysis Report
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Summary:
+  📁 Project: /path/to/project
+  🔧 Bundler: vite
+  📊 Files Analyzed: 42
+
+  ⚠️  Issues Found: 5
+     ● Critical: 1
+     ● High: 2
+     ● Medium: 2
+  📦 Potential Savings: 85.3 KB
+
+CRITICAL ISSUES
+────────────────
+1. CommonJS Module: node_modules/lodash/index.js
+   └─ Pattern: require('lodash')
+   └─ Impact: 72 KB
+   └─ lodash CommonJS bundle is included. Use lodash-es for tree-shaking.
+   └─ Fix: Switch to lodash-es
+      import { debounce } from 'lodash-es'
+
+HIGH PRIORITY ISSUES
+────────────────────
+2. Wildcard Re-export: src/components/index.ts
+   └─ Line: 5
+   └─ Pattern: export * from './Button'
+   └─ Impact: 8.2 KB
+   └─ Wildcard re-export prevents tree-shaking.
+   └─ Fix: Use explicit named exports
+      export { Button } from './Button'
+```
+
+## JSON Output
+
+Use `--output json` for CI integration:
+
+```json
+{
+  "summary": {
+    "projectPath": "/path/to/project",
+    "bundler": "vite",
+    "totalIssues": 5,
+    "criticalCount": 1,
+    "highCount": 2,
+    "mediumCount": 2,
+    "lowCount": 0,
+    "estimatedSavings": 87347,
+    "analyzedFiles": 42
+  },
+  "issues": [
+    {
+      "type": "commonjs-module",
+      "severity": "critical",
+      "file": "node_modules/lodash/index.js",
+      "pattern": "require('lodash')",
+      "estimatedImpact": 72000,
+      "suggestion": {
+        "title": "Switch to lodash-es",
+        "code": "import { debounce } from 'lodash-es'"
+      }
+    }
+  ]
+}
+```
+
+## Issue Types
+
+| Type                         | Description                                  |
+| ---------------------------- | -------------------------------------------- |
+| `barrel-file`                | Barrel files with many re-exports            |
+| `wildcard-reexport`          | `export *` patterns that include all exports |
+| `side-effect`                | Top-level code that runs on import           |
+| `commonjs-module`            | CommonJS modules that don't tree-shake       |
+| `unused-export`              | Exports not imported anywhere                |
+| `missing-sideeffects-config` | Missing `sideEffects` in package.json        |
+
+## License
+
+MIT

package/bin/treeshake-check.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+
+import "../dist/index.js";

package/dist/analyzers/barrel.d.ts

@@ -0,0 +1,6 @@
+import type { TreeShakingIssue } from "../types/index.js";
+/**
+ * Analyzes files for barrel file patterns that can break tree-shaking
+ */
+export declare function analyzeBarrelFiles(files: string[], projectPath: string): Promise<TreeShakingIssue[]>;
+//# sourceMappingURL=barrel.d.ts.map

package/dist/analyzers/barrel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"barrel.d.ts","sourceRoot":"","sources":["../../src/analyzers/barrel.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAiB,MAAM,mBAAmB,CAAC;AAEzE;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,MAAM,EAAE,EACf,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAoB7B"}

package/dist/analyzers/barrel.js

@@ -0,0 +1,124 @@
+import * as acorn from "acorn";
+import * as walk from "acorn-walk";
+import { readFileSync } from "fs";
+import { basename, relative } from "path";
+/**
+ * Analyzes files for barrel file patterns that can break tree-shaking
+ */
+export async function analyzeBarrelFiles(files, projectPath) {
+    const issues = [];
+    for (const file of files) {
+        const fileName = basename(file);
+        // Only check index files (common barrel file pattern)
+        if (!fileName.match(/^index\.(js|ts|jsx|tsx|mjs|mts)$/)) {
+            continue;
+        }
+        try {
+            const content = readFileSync(file, "utf-8");
+            const fileIssues = analyzeBarrelContent(content, file, projectPath);
+            issues.push(...fileIssues);
+        }
+        catch {
+            // Skip files that can't be read
+        }
+    }
+    return issues;
+}
+function analyzeBarrelContent(content, filePath, projectPath) {
+    const issues = [];
+    const relPath = relative(projectPath, filePath);
+    // Count re-exports to determine if this is a barrel file
+    let reexportCount = 0;
+    let wildcardReexportCount = 0;
+    const wildcardSources = [];
+    try {
+        const ast = acorn.parse(content, {
+            ecmaVersion: "latest",
+            sourceType: "module",
+            locations: true,
+        });
+        walk.simple(ast, {
+            ExportAllDeclaration(node) {
+                wildcardReexportCount++;
+                reexportCount++;
+                wildcardSources.push({
+                    source: node.source?.value || "unknown",
+                    line: node.loc?.start?.line || 0,
+                });
+            },
+            ExportNamedDeclaration(node) {
+                if (node.source) {
+                    reexportCount++;
+                }
+            },
+        });
+    }
+    catch {
+        // Fall back to regex-based detection for files that fail to parse
+        const wildcardMatches = content.matchAll(/export\s+\*\s+from\s+['"]([^'"]+)['"]/g);
+        for (const match of wildcardMatches) {
+            wildcardReexportCount++;
+            reexportCount++;
+            const line = content.substring(0, match.index).split("\n").length;
+            wildcardSources.push({ source: match[1], line });
+        }
+        const namedReexportMatches = content.matchAll(/export\s+\{[^}]+\}\s+from\s+['"][^'"]+['"]/g);
+        for (const _match of namedReexportMatches) {
+            reexportCount++;
+        }
+    }
+    // Only warn about barrel files with wildcard re-exports
+    if (wildcardReexportCount > 0) {
+        for (const { source, line } of wildcardSources) {
+            const severity = wildcardReexportCount > 3 ? "critical" : "high";
+            issues.push({
+                type: "wildcard-reexport",
+                severity,
+                file: relPath,
+                line,
+                pattern: `export * from '${source}'`,
+                description: `Wildcard re-export prevents tree-shaking. All exports from '${source}' will be included even if unused.`,
+                estimatedImpact: estimateWildcardImpact(source),
+                suggestion: {
+                    title: "Use explicit named exports",
+                    description: "Replace wildcard re-exports with explicit named exports to enable tree-shaking.",
+                    code: `export { SpecificExport } from '${source}'`,
+                },
+            });
+        }
+    }
+    // Warn about barrel files in general if they have many re-exports
+    if (reexportCount > 5 && wildcardReexportCount === 0) {
+        issues.push({
+            type: "barrel-file",
+            severity: "medium",
+            file: relPath,
+            pattern: `${reexportCount} re-exports in barrel file`,
+            description: `Large barrel file with ${reexportCount} re-exports. Some bundlers may include all modules when importing from this barrel.`,
+            estimatedImpact: reexportCount * 500, // Rough estimate
+            suggestion: {
+                title: "Consider direct imports",
+                description: "Import directly from source modules instead of through the barrel file.",
+                code: `import { Component } from './components/Component' // instead of './components'`,
+            },
+        });
+    }
+    return issues;
+}
+/**
+ * Estimate the bundle size impact of a wildcard re-export
+ */
+function estimateWildcardImpact(source) {
+    // Rough heuristics based on common patterns
+    if (source.includes("lodash"))
+        return 25000;
+    if (source.includes("icons") || source.includes("Icon"))
+        return 50000;
+    if (source.includes("utils") || source.includes("helpers"))
+        return 5000;
+    if (source.includes("components"))
+        return 10000;
+    // Default estimate
+    return 3000;
+}
+//# sourceMappingURL=barrel.js.map

package/dist/analyzers/barrel.js.map

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

package/dist/analyzers/exports.d.ts

@@ -0,0 +1,6 @@
+import type { TreeShakingIssue } from "../types/index.js";
+/**
+ * Analyze exports to find unused ones
+ */
+export declare function analyzeUnusedExports(files: string[], projectPath: string): Promise<TreeShakingIssue[]>;
+//# sourceMappingURL=exports.d.ts.map

package/dist/analyzers/exports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exports.d.ts","sourceRoot":"","sources":["../../src/analyzers/exports.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,gBAAgB,EAGjB,MAAM,mBAAmB,CAAC;AAO3B;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,MAAM,EAAE,EACf,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAiC7B"}

package/dist/analyzers/exports.js

@@ -0,0 +1,192 @@
+import * as acorn from "acorn";
+import * as walk from "acorn-walk";
+import { readFileSync } from "fs";
+import { relative, dirname, resolve } from "path";
+/**
+ * Analyze exports to find unused ones
+ */
+export async function analyzeUnusedExports(files, projectPath) {
+    const issues = [];
+    // Build complete export/import graph
+    const graph = buildExportGraph(files, projectPath);
+    // Find exports that are never imported
+    const unusedExports = findUnusedExports(graph, files, projectPath);
+    for (const { file, exportName, line } of unusedExports) {
+        const relPath = relative(projectPath, file);
+        // Skip if it's a default export from an entry point
+        if (isEntryPoint(file, projectPath)) {
+            continue;
+        }
+        issues.push({
+            type: "unused-export",
+            severity: "low",
+            file: relPath,
+            line,
+            pattern: `export ${exportName}`,
+            description: `'${exportName}' is exported but never imported in the analyzed codebase.`,
+            estimatedImpact: 500,
+            suggestion: {
+                title: "Remove unused export",
+                description: `If '${exportName}' is not used externally, consider removing it or marking it as internal.`,
+            },
+        });
+    }
+    return issues;
+}
+function buildExportGraph(files, projectPath) {
+    const exports = new Map();
+    const imports = new Map();
+    for (const file of files) {
+        try {
+            const content = readFileSync(file, "utf-8");
+            const fileExports = new Set();
+            const fileImports = new Map();
+            const ast = acorn.parse(content, {
+                ecmaVersion: "latest",
+                sourceType: "module",
+                locations: true,
+            });
+            walk.simple(ast, {
+                ExportNamedDeclaration(node) {
+                    // export { a, b }
+                    if (node.specifiers) {
+                        for (const spec of node.specifiers) {
+                            const exportedName = spec.exported?.name || spec.local?.name;
+                            if (exportedName) {
+                                fileExports.add(exportedName);
+                            }
+                        }
+                    }
+                    // export const/let/var/function/class
+                    if (node.declaration) {
+                        if (node.declaration.declarations) {
+                            for (const decl of node.declaration.declarations) {
+                                if (decl.id?.name) {
+                                    fileExports.add(decl.id.name);
+                                }
+                            }
+                        }
+                        else if (node.declaration.id?.name) {
+                            fileExports.add(node.declaration.id.name);
+                        }
+                    }
+                },
+                ExportDefaultDeclaration() {
+                    fileExports.add("default");
+                },
+                ExportAllDeclaration(node) {
+                    // export * from "..."
+                    if (node.source?.value) {
+                        fileExports.add(`* from ${node.source.value}`);
+                    }
+                },
+                ImportDeclaration(node) {
+                    if (!node.source?.value)
+                        return;
+                    const sourcePath = node.source.value;
+                    for (const spec of node.specifiers || []) {
+                        if (spec.type === "ImportSpecifier") {
+                            const importedName = spec.imported?.name;
+                            if (importedName) {
+                                fileImports.set(importedName, resolveImportPath(file, sourcePath));
+                            }
+                        }
+                        else if (spec.type === "ImportDefaultSpecifier") {
+                            fileImports.set("default", resolveImportPath(file, sourcePath));
+                        }
+                        else if (spec.type === "ImportNamespaceSpecifier") {
+                            fileImports.set("*", resolveImportPath(file, sourcePath));
+                        }
+                    }
+                },
+            });
+            exports.set(file, fileExports);
+            imports.set(file, fileImports);
+        }
+        catch {
+            // Skip files that can't be parsed
+        }
+    }
+    return { exports, imports };
+}
+function findUnusedExports(graph, files, projectPath) {
+    const unusedExports = [];
+    // Collect all imported names across the codebase
+    const allImports = new Map(); // source file -> imported names
+    for (const [importingFile, fileImports] of graph.imports) {
+        for (const [importedName, sourceFile] of fileImports) {
+            if (!allImports.has(sourceFile)) {
+                allImports.set(sourceFile, new Set());
+            }
+            allImports.get(sourceFile).add(importedName);
+        }
+    }
+    // Check each export against imports
+    for (const [file, fileExports] of graph.exports) {
+        const usedInFile = allImports.get(file) || new Set();
+        for (const exportName of fileExports) {
+            // Skip wildcard re-exports
+            if (exportName.startsWith("*"))
+                continue;
+            // Check if this export is used
+            const isUsed = usedInFile.has(exportName) ||
+                usedInFile.has("*") || // namespace import uses all
+                (exportName === "default" && usedInFile.has("default"));
+            if (!isUsed) {
+                unusedExports.push({
+                    file,
+                    exportName,
+                    line: getExportLine(file, exportName),
+                });
+            }
+        }
+    }
+    return unusedExports;
+}
+function resolveImportPath(fromFile, importPath) {
+    // Handle relative imports
+    if (importPath.startsWith(".")) {
+        const dir = dirname(fromFile);
+        let resolved = resolve(dir, importPath);
+        // Add common extensions if needed
+        const extensions = [".ts", ".tsx", ".js", ".jsx", ".mjs", ".mts", ""];
+        for (const ext of extensions) {
+            if (resolved.endsWith(ext)) {
+                return resolved;
+            }
+        }
+        // Try adding extensions
+        return resolved;
+    }
+    // For node_modules, return as-is
+    return importPath;
+}
+function isEntryPoint(file, projectPath) {
+    const relPath = relative(projectPath, file).toLowerCase();
+    // Common entry point patterns
+    const entryPatterns = [
+        /^src\/index\./,
+        /^src\/main\./,
+        /^src\/app\./,
+        /^index\./,
+        /^main\./,
+    ];
+    return entryPatterns.some((pattern) => pattern.test(relPath));
+}
+function getExportLine(file, exportName) {
+    try {
+        const content = readFileSync(file, "utf-8");
+        const lines = content.split("\n");
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            if (line.includes(`export`) && line.includes(exportName)) {
+                return i + 1;
+            }
+        }
+    }
+    catch {
+        // Ignore
+    }
+    return 0;
+}
+//# sourceMappingURL=exports.js.map

package/dist/analyzers/exports.js.map

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

package/dist/analyzers/module-type.d.ts

@@ -0,0 +1,6 @@
+import type { TreeShakingIssue } from "../types/index.js";
+/**
+ * Analyze files to detect CommonJS vs ESM module patterns
+ */
+export declare function analyzeModuleTypes(files: string[], projectPath: string): Promise<TreeShakingIssue[]>;
+//# sourceMappingURL=module-type.d.ts.map

package/dist/analyzers/module-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-type.d.ts","sourceRoot":"","sources":["../../src/analyzers/module-type.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAoB1D;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,MAAM,EAAE,EACf,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAc7B"}