react-code-smell-detector 1.4.2 → 1.5.0

package/dist/docGenerator.js

@@ -0,0 +1,306 @@
+import path from 'path';
+import fs from 'fs/promises';
+/**
+ * Generate documentation from component analysis
+ */
+export async function generateComponentDocs(result, rootDir, options = { format: 'markdown' }) {
+    const docs = extractComponentDocs(result, rootDir);
+    switch (options.format) {
+        case 'html':
+            return generateHTMLDocs(docs, result, options);
+        case 'json':
+            return JSON.stringify(docs, null, 2);
+        case 'markdown':
+        default:
+            return generateMarkdownDocs(docs, result, options);
+    }
+}
+/**
+ * Extract documentation data from analysis
+ */
+function extractComponentDocs(result, rootDir) {
+    const docs = [];
+    for (const file of result.files) {
+        for (const component of file.components) {
+            const relativePath = file.file.replace(rootDir, '').replace(/^\//, '');
+            const componentSmells = file.smells.filter(s => s.line >= component.startLine && s.line <= component.endLine);
+            // Determine complexity rating
+            const complexity = getComplexityRating(component);
+            const maintainability = getMaintainabilityRating(componentSmells.length, component.lineCount);
+            docs.push({
+                name: component.name,
+                file: file.file,
+                relativePath,
+                lineCount: component.lineCount,
+                props: [], // Would need parser enhancement to get prop names
+                hooks: {
+                    useState: component.useStateCount,
+                    useEffect: component.useEffectCount,
+                    useMemo: component.useMemoCount,
+                    useCallback: component.useCallbackCount,
+                    useRef: 0, // Would need parser enhancement
+                    custom: [],
+                },
+                smells: componentSmells,
+                metrics: {
+                    complexity,
+                    maintainability,
+                },
+            });
+        }
+    }
+    return docs.sort((a, b) => a.name.localeCompare(b.name));
+}
+/**
+ * Generate Markdown documentation
+ */
+function generateMarkdownDocs(docs, result, options) {
+    let md = '# Component Documentation\n\n';
+    md += `*Generated by react-code-smell-detector*\n\n`;
+    md += `---\n\n`;
+    // Summary
+    md += '## Summary\n\n';
+    md += `| Metric | Value |\n`;
+    md += `|--------|-------|\n`;
+    md += `| Total Components | ${docs.length} |\n`;
+    md += `| Total Files | ${result.summary.totalFiles} |\n`;
+    md += `| Technical Debt Grade | ${result.debtScore.grade} |\n`;
+    md += `| Estimated Refactor Time | ${result.debtScore.estimatedRefactorTime} |\n\n`;
+    // Table of contents
+    md += '## Components\n\n';
+    if (options.groupByFolder) {
+        const grouped = groupByFolder(docs);
+        for (const [folder, folderDocs] of Object.entries(grouped)) {
+            md += `### 📁 ${folder || 'Root'}\n\n`;
+            for (const doc of folderDocs) {
+                md += formatComponentMarkdown(doc, options);
+            }
+        }
+    }
+    else {
+        for (const doc of docs) {
+            md += formatComponentMarkdown(doc, options);
+        }
+    }
+    // Index
+    md += '\n---\n\n';
+    md += '## Index\n\n';
+    md += '| Component | File | Lines | Hooks | Issues |\n';
+    md += '|-----------|------|-------|-------|--------|\n';
+    for (const doc of docs) {
+        const totalHooks = doc.hooks.useState + doc.hooks.useEffect + doc.hooks.useMemo + doc.hooks.useCallback;
+        md += `| [${doc.name}](#${doc.name.toLowerCase()}) | \`${doc.relativePath}\` | ${doc.lineCount} | ${totalHooks} | ${doc.smells.length} |\n`;
+    }
+    return md;
+}
+/**
+ * Format a single component as Markdown
+ */
+function formatComponentMarkdown(doc, options) {
+    let md = `#### ${doc.name}\n\n`;
+    md += `📄 \`${doc.relativePath}\`\n\n`;
+    // Metrics table
+    if (options.includeMetrics !== false) {
+        md += `| Metric | Value |\n`;
+        md += `|--------|-------|\n`;
+        md += `| Lines | ${doc.lineCount} |\n`;
+        md += `| Complexity | ${doc.metrics.complexity} |\n`;
+        md += `| Maintainability | ${doc.metrics.maintainability} |\n`;
+    }
+    // Hooks
+    const hooks = [];
+    if (doc.hooks.useState > 0)
+        hooks.push(`useState (${doc.hooks.useState})`);
+    if (doc.hooks.useEffect > 0)
+        hooks.push(`useEffect (${doc.hooks.useEffect})`);
+    if (doc.hooks.useMemo > 0)
+        hooks.push(`useMemo (${doc.hooks.useMemo})`);
+    if (doc.hooks.useCallback > 0)
+        hooks.push(`useCallback (${doc.hooks.useCallback})`);
+    if (hooks.length > 0) {
+        md += `\n**Hooks:** ${hooks.join(', ')}\n`;
+    }
+    // Issues
+    if (options.includeSmells !== false && doc.smells.length > 0) {
+        md += `\n**Issues (${doc.smells.length}):**\n`;
+        for (const smell of doc.smells.slice(0, 5)) {
+            const emoji = smell.severity === 'error' ? '🔴' : smell.severity === 'warning' ? '🟡' : '🔵';
+            md += `- ${emoji} ${smell.type}: ${smell.message}\n`;
+        }
+        if (doc.smells.length > 5) {
+            md += `- *... and ${doc.smells.length - 5} more*\n`;
+        }
+    }
+    md += '\n---\n\n';
+    return md;
+}
+/**
+ * Generate HTML documentation
+ */
+function generateHTMLDocs(docs, result, options) {
+    return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Component Documentation</title>
+  <style>
+    * { box-sizing: border-box; margin: 0; padding: 0; }
+    body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; line-height: 1.6; color: #333; background: #f5f5f5; }
+    .container { max-width: 1200px; margin: 0 auto; padding: 20px; }
+    header { background: linear-gradient(135deg, #667eea 0%, #764ba2 100%); color: white; padding: 40px 20px; margin-bottom: 30px; border-radius: 10px; }
+    h1 { font-size: 2.5rem; margin-bottom: 10px; }
+    .subtitle { opacity: 0.9; }
+    .summary { display: grid; grid-template-columns: repeat(auto-fit, minmax(200px, 1fr)); gap: 20px; margin-bottom: 30px; }
+    .summary-card { background: white; padding: 20px; border-radius: 8px; box-shadow: 0 2px 4px rgba(0,0,0,0.1); text-align: center; }
+    .summary-value { font-size: 2rem; font-weight: bold; color: #667eea; }
+    .summary-label { color: #666; font-size: 0.9rem; }
+    .components { display: grid; gap: 20px; }
+    .component-card { background: white; padding: 20px; border-radius: 8px; box-shadow: 0 2px 4px rgba(0,0,0,0.1); }
+    .component-name { font-size: 1.3rem; color: #333; margin-bottom: 5px; }
+    .component-path { color: #666; font-size: 0.85rem; font-family: monospace; background: #f0f0f0; padding: 2px 8px; border-radius: 4px; }
+    .metrics { display: flex; gap: 15px; margin: 15px 0; flex-wrap: wrap; }
+    .metric { background: #f0f0f0; padding: 5px 12px; border-radius: 20px; font-size: 0.85rem; }
+    .hooks { display: flex; gap: 10px; flex-wrap: wrap; margin: 10px 0; }
+    .hook { background: #e3f2fd; color: #1976d2; padding: 4px 10px; border-radius: 4px; font-size: 0.8rem; }
+    .issues { margin-top: 15px; }
+    .issue { padding: 8px; margin: 5px 0; border-radius: 4px; font-size: 0.9rem; }
+    .issue.error { background: #ffebee; color: #c62828; }
+    .issue.warning { background: #fff3e0; color: #ef6c00; }
+    .issue.info { background: #e3f2fd; color: #1565c0; }
+    .search { margin-bottom: 20px; }
+    .search input { width: 100%; padding: 12px; border: 1px solid #ddd; border-radius: 8px; font-size: 1rem; }
+    .grade { font-size: 3rem; }
+    footer { text-align: center; padding: 20px; color: #666; font-size: 0.85rem; }
+  </style>
+</head>
+<body>
+  <div class="container">
+    <header>
+      <h1>📚 Component Documentation</h1>
+      <p class="subtitle">Generated by react-code-smell-detector</p>
+    </header>
+    
+    <div class="summary">
+      <div class="summary-card">
+        <div class="summary-value">${docs.length}</div>
+        <div class="summary-label">Components</div>
+      </div>
+      <div class="summary-card">
+        <div class="summary-value">${result.summary.totalFiles}</div>
+        <div class="summary-label">Files</div>
+      </div>
+      <div class="summary-card">
+        <div class="summary-value grade">${result.debtScore.grade}</div>
+        <div class="summary-label">Debt Grade</div>
+      </div>
+      <div class="summary-card">
+        <div class="summary-value">${result.debtScore.score}</div>
+        <div class="summary-label">Score</div>
+      </div>
+    </div>
+    
+    <div class="search">
+      <input type="text" placeholder="Search components..." id="search" onkeyup="filterComponents()">
+    </div>
+    
+    <div class="components" id="components">
+      ${docs.map(doc => `
+        <div class="component-card" data-name="${doc.name.toLowerCase()}">
+          <div class="component-name">${doc.name}</div>
+          <span class="component-path">${doc.relativePath}</span>
+          
+          <div class="metrics">
+            <span class="metric">📏 ${doc.lineCount} lines</span>
+            <span class="metric">⚡ ${doc.metrics.complexity}</span>
+            <span class="metric">🔧 ${doc.metrics.maintainability}</span>
+          </div>
+          
+          <div class="hooks">
+            ${doc.hooks.useState > 0 ? `<span class="hook">useState ×${doc.hooks.useState}</span>` : ''}
+            ${doc.hooks.useEffect > 0 ? `<span class="hook">useEffect ×${doc.hooks.useEffect}</span>` : ''}
+            ${doc.hooks.useMemo > 0 ? `<span class="hook">useMemo ×${doc.hooks.useMemo}</span>` : ''}
+            ${doc.hooks.useCallback > 0 ? `<span class="hook">useCallback ×${doc.hooks.useCallback}</span>` : ''}
+          </div>
+          
+          ${doc.smells.length > 0 ? `
+            <div class="issues">
+              ${doc.smells.slice(0, 3).map(s => `
+                <div class="issue ${s.severity}">${s.type}: ${s.message}</div>
+              `).join('')}
+              ${doc.smells.length > 3 ? `<div class="issue info">... and ${doc.smells.length - 3} more</div>` : ''}
+            </div>
+          ` : ''}
+        </div>
+      `).join('')}
+    </div>
+    
+    <footer>
+      Generated by <a href="https://github.com/vsthakur101/react-code-smell-detector">react-code-smell-detector</a>
+    </footer>
+  </div>
+  
+  <script>
+    function filterComponents() {
+      const query = document.getElementById('search').value.toLowerCase();
+      const cards = document.querySelectorAll('.component-card');
+      cards.forEach(card => {
+        const name = card.dataset.name;
+        card.style.display = name.includes(query) ? 'block' : 'none';
+      });
+    }
+  </script>
+</body>
+</html>`;
+}
+/**
+ * Group components by folder
+ */
+function groupByFolder(docs) {
+    const grouped = {};
+    for (const doc of docs) {
+        const parts = doc.relativePath.split('/');
+        const folder = parts.length > 1 ? parts.slice(0, -1).join('/') : '';
+        if (!grouped[folder]) {
+            grouped[folder] = [];
+        }
+        grouped[folder].push(doc);
+    }
+    return grouped;
+}
+/**
+ * Get complexity rating based on component metrics
+ */
+function getComplexityRating(component) {
+    const hookCount = component.useEffectCount + component.useStateCount +
+        component.useMemoCount + component.useCallbackCount;
+    if (component.lineCount > 300 || hookCount > 10)
+        return '🔴 High';
+    if (component.lineCount > 150 || hookCount > 5)
+        return '🟡 Medium';
+    return '🟢 Low';
+}
+/**
+ * Get maintainability rating based on smells and size
+ */
+function getMaintainabilityRating(smellCount, lineCount) {
+    const ratio = smellCount / Math.max(lineCount / 50, 1);
+    if (ratio > 2 || smellCount > 5)
+        return '🔴 Poor';
+    if (ratio > 1 || smellCount > 2)
+        return '🟡 Fair';
+    return '🟢 Good';
+}
+/**
+ * Write documentation to file
+ */
+export async function writeComponentDocs(result, rootDir, options) {
+    const content = await generateComponentDocs(result, rootDir, options);
+    const ext = options.format === 'html' ? 'html' : options.format === 'json' ? 'json' : 'md';
+    const filename = `COMPONENTS.${ext}`;
+    const outputPath = options.outputDir
+        ? path.join(options.outputDir, filename)
+        : path.join(rootDir, filename);
+    await fs.writeFile(outputPath, content, 'utf-8');
+    return outputPath;
+}

package/dist/index.d.ts

@@ -2,4 +2,8 @@ export { analyzeProject, type AnalyzerOptions } from './analyzer.js';
 export { reportResults, type ReporterOptions } from './reporter.js';
 export * from './types/index.js';
 export { parseFile, parseCode, type ParseResult, type ParsedComponent } from './parser/index.js';
+export { runInteractiveFix, previewFixes, type InteractiveFixOptions } from './interactiveFixer.js';
+export { generatePRComment, postPRComment, generateInlineComments, type PRCommentConfig } from './prComments.js';
+export { loadBudget, checkBudget, formatBudgetReport, createBudgetConfig, type PerformanceBudget, type BudgetCheckResult } from './performanceBudget.js';
+export { generateComponentDocs, writeComponentDocs, type DocGeneratorOptions } from './docGenerator.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AACpE,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AACpE,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACjG,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,KAAK,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACpG,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,sBAAsB,EAAE,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACjH,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AACzJ,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -2,3 +2,7 @@ export { analyzeProject } from './analyzer.js';
 export { reportResults } from './reporter.js';
 export * from './types/index.js';
 export { parseFile, parseCode } from './parser/index.js';
+export { runInteractiveFix, previewFixes } from './interactiveFixer.js';
+export { generatePRComment, postPRComment, generateInlineComments } from './prComments.js';
+export { loadBudget, checkBudget, formatBudgetReport, createBudgetConfig } from './performanceBudget.js';
+export { generateComponentDocs, writeComponentDocs } from './docGenerator.js';

package/dist/interactiveFixer.d.ts

@@ -0,0 +1,20 @@
+import { CodeSmell } from './types/index.js';
+export interface InteractiveFixOptions {
+    smells: CodeSmell[];
+    rootDir: string;
+    showDiff?: boolean;
+}
+export interface InteractiveFixResult {
+    applied: number;
+    skipped: number;
+    total: number;
+}
+/**
+ * Interactive fix mode - review and apply fixes one by one
+ */
+export declare function runInteractiveFix(options: InteractiveFixOptions): Promise<InteractiveFixResult>;
+/**
+ * Preview all fixable issues without applying
+ */
+export declare function previewFixes(smells: CodeSmell[], rootDir: string): void;
+//# sourceMappingURL=interactiveFixer.d.ts.map

package/dist/interactiveFixer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactiveFixer.d.ts","sourceRoot":"","sources":["../src/interactiveFixer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAa,MAAM,kBAAkB,CAAC;AAIxD,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA6HrG;AAoCD;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CA6BvE"}

package/dist/interactiveFixer.js

@@ -0,0 +1,178 @@
+import chalk from 'chalk';
+import fs from 'fs/promises';
+import { isFixable, describeFixAction } from './fixer.js';
+import * as readline from 'readline';
+/**
+ * Interactive fix mode - review and apply fixes one by one
+ */
+export async function runInteractiveFix(options) {
+    const { smells, rootDir, showDiff = true } = options;
+    const fixableSmells = smells.filter(isFixable);
+    if (fixableSmells.length === 0) {
+        console.log(chalk.yellow('\nNo auto-fixable issues found.\n'));
+        return { applied: 0, skipped: 0, total: 0 };
+    }
+    console.log(chalk.cyan(`\n🔧 Interactive Fix Mode`));
+    console.log(chalk.dim(`Found ${fixableSmells.length} fixable issue(s). Review each one:\n`));
+    console.log(chalk.dim('Commands: [y]es, [n]o, [a]ll, [q]uit\n'));
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    const question = (prompt) => {
+        return new Promise((resolve) => {
+            rl.question(prompt, resolve);
+        });
+    };
+    let applied = 0;
+    let skipped = 0;
+    let applyAll = false;
+    // Group smells by file for efficient processing
+    const smellsByFile = new Map();
+    for (const smell of fixableSmells) {
+        const existing = smellsByFile.get(smell.file) || [];
+        existing.push(smell);
+        smellsByFile.set(smell.file, existing);
+    }
+    for (const [file, fileSmells] of smellsByFile) {
+        let content = await fs.readFile(file, 'utf-8');
+        const lines = content.split('\n');
+        const relativePath = file.replace(rootDir, '').replace(/^\//, '');
+        // Sort by line descending to preserve line numbers when fixing
+        const sortedSmells = [...fileSmells].sort((a, b) => b.line - a.line);
+        for (const smell of sortedSmells) {
+            const lineIndex = smell.line - 1;
+            if (lineIndex < 0 || lineIndex >= lines.length) {
+                skipped++;
+                continue;
+            }
+            const originalLine = lines[lineIndex];
+            const fixedLine = getFixedLine(smell, originalLine);
+            if (fixedLine === originalLine) {
+                skipped++;
+                continue;
+            }
+            // Display the issue
+            console.log(chalk.white('─'.repeat(60)));
+            console.log(chalk.yellow(`${relativePath}:${smell.line}`));
+            console.log(chalk.red(`  ${smell.type}: ${smell.message}`));
+            console.log(chalk.blue(`  Fix: ${describeFixAction(smell.type)}`));
+            if (showDiff) {
+                console.log();
+                console.log(chalk.red(`  - ${originalLine.trim()}`));
+                if (fixedLine !== null) {
+                    console.log(chalk.green(`  + ${fixedLine.trim()}`));
+                }
+                else {
+                    console.log(chalk.green(`  + (line removed)`));
+                }
+                console.log();
+            }
+            let shouldApply = applyAll;
+            if (!applyAll) {
+                const answer = await question(chalk.cyan('Apply this fix? [y/n/a/q]: '));
+                const choice = answer.toLowerCase().trim();
+                if (choice === 'q') {
+                    console.log(chalk.yellow('\nQuitting interactive mode.\n'));
+                    rl.close();
+                    return { applied, skipped: skipped + (fixableSmells.length - applied - skipped), total: fixableSmells.length };
+                }
+                else if (choice === 'a') {
+                    applyAll = true;
+                    shouldApply = true;
+                }
+                else if (choice === 'y' || choice === 'yes') {
+                    shouldApply = true;
+                }
+                else {
+                    shouldApply = false;
+                }
+            }
+            if (shouldApply) {
+                if (fixedLine === null) {
+                    lines.splice(lineIndex, 1);
+                }
+                else {
+                    lines[lineIndex] = fixedLine;
+                }
+                applied++;
+                console.log(chalk.green('  ✓ Applied'));
+            }
+            else {
+                skipped++;
+                console.log(chalk.dim('  ○ Skipped'));
+            }
+        }
+        // Write back the file if any changes were made
+        if (applied > 0) {
+            await fs.writeFile(file, lines.join('\n'), 'utf-8');
+        }
+    }
+    rl.close();
+    console.log(chalk.white('\n' + '─'.repeat(60)));
+    console.log(chalk.green(`✓ Applied ${applied} fix(es)`));
+    console.log(chalk.dim(`○ Skipped ${skipped} issue(s)`));
+    console.log();
+    return { applied, skipped, total: fixableSmells.length };
+}
+/**
+ * Get the fixed version of a line
+ */
+function getFixedLine(smell, line) {
+    switch (smell.type) {
+        case 'debug-statement':
+            return fixDebugStatement(line);
+        case 'js-var-usage':
+            return line.replace(/\bvar\s+/, 'let ');
+        case 'js-loose-equality':
+            return line
+                .replace(/([^=!])={2}([^=])/g, '$1===$2')
+                .replace(/!={1}([^=])/g, '!==$1');
+        case 'a11y-missing-alt':
+            return line.replace(/<img\s+(?![^>]*\balt\b)([^>]*?)(\/?>)/gi, '<img $1alt="" $2');
+        default:
+            return line;
+    }
+}
+function fixDebugStatement(line) {
+    const trimmed = line.trim();
+    if (/^console\.(log|debug|info|warn|error|trace|dir)\s*\(.*\);?\s*$/.test(trimmed)) {
+        return null;
+    }
+    if (/^debugger;?\s*$/.test(trimmed)) {
+        return null;
+    }
+    if (/console\.(log|debug|info|warn|error|trace|dir)\s*\(/.test(line)) {
+        return line.replace(/console\.(log|debug|info|warn|error|trace|dir)\s*\([^)]*\);?/g, '/* $& */');
+    }
+    return line;
+}
+/**
+ * Preview all fixable issues without applying
+ */
+export function previewFixes(smells, rootDir) {
+    const fixableSmells = smells.filter(isFixable);
+    if (fixableSmells.length === 0) {
+        console.log(chalk.yellow('\nNo auto-fixable issues found.\n'));
+        return;
+    }
+    console.log(chalk.cyan(`\n📋 Fixable Issues Preview (${fixableSmells.length} total)\n`));
+    const grouped = new Map();
+    for (const smell of fixableSmells) {
+        const existing = grouped.get(smell.type) || [];
+        existing.push(smell);
+        grouped.set(smell.type, existing);
+    }
+    for (const [type, typeSmells] of grouped) {
+        console.log(chalk.yellow(`\n${type} (${typeSmells.length})`));
+        console.log(chalk.dim(`  Fix: ${describeFixAction(type)}`));
+        for (const smell of typeSmells.slice(0, 5)) {
+            const relativePath = smell.file.replace(rootDir, '').replace(/^\//, '');
+            console.log(chalk.white(`  ${relativePath}:${smell.line}`));
+        }
+        if (typeSmells.length > 5) {
+            console.log(chalk.dim(`  ... and ${typeSmells.length - 5} more`));
+        }
+    }
+    console.log();
+}

package/dist/performanceBudget.d.ts

@@ -0,0 +1,54 @@
+import { AnalysisResult, AnalysisSummary, SmellType } from './types/index.js';
+export interface PerformanceBudget {
+    maxTotalSmells?: number;
+    maxErrors?: number;
+    maxWarnings?: number;
+    minScore?: number;
+    minGrade?: 'A' | 'B' | 'C' | 'D' | 'F';
+    maxByType?: Partial<Record<SmellType, number>>;
+    maxCyclomaticComplexity?: number;
+    maxCognitiveComplexity?: number;
+    maxComponentLines?: number;
+    maxPropsCount?: number;
+    maxUseEffectsPerComponent?: number;
+    maxSmellsPerFile?: number;
+    maxNewSmells?: number;
+    allowedGrowthPercent?: number;
+}
+export interface BudgetCheckResult {
+    passed: boolean;
+    violations: BudgetViolation[];
+    summary: {
+        total: number;
+        passed: number;
+        failed: number;
+    };
+}
+export interface BudgetViolation {
+    rule: string;
+    actual: number | string;
+    threshold: number | string;
+    message: string;
+    severity: 'error' | 'warning';
+}
+/**
+ * Load performance budget from config file
+ */
+export declare function loadBudget(configPath?: string): Promise<PerformanceBudget>;
+/**
+ * Check analysis results against performance budget
+ */
+export declare function checkBudget(result: AnalysisResult, budget: PerformanceBudget): BudgetCheckResult;
+/**
+ * Format budget check result for console output
+ */
+export declare function formatBudgetReport(result: BudgetCheckResult): string;
+/**
+ * Create a default budget config file
+ */
+export declare function createBudgetConfig(targetPath?: string): Promise<string>;
+/**
+ * Compare current results with baseline for growth limits
+ */
+export declare function checkGrowthLimits(current: AnalysisSummary, baseline: AnalysisSummary, budget: PerformanceBudget): BudgetViolation[];
+//# sourceMappingURL=performanceBudget.d.ts.map

package/dist/performanceBudget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"performanceBudget.d.ts","sourceRoot":"","sources":["../src/performanceBudget.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,eAAe,EAAsB,SAAS,EAAiB,MAAM,kBAAkB,CAAC;AAEjH,MAAM,WAAW,iBAAiB;IAEhC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IAGvC,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;IAG/C,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAGhC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,yBAAyB,CAAC,EAAE,MAAM,CAAC;IAGnC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAG1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;CAC/B;AAOD;;GAEG;AACH,wBAAsB,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAsChF;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,iBAAiB,GACxB,iBAAiB,CA6GnB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAqBpE;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAoB7E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,eAAe,EACxB,QAAQ,EAAE,eAAe,EACzB,MAAM,EAAE,iBAAiB,GACxB,eAAe,EAAE,CA6BnB"}