react-code-smell-detector 1.4.1 → 1.5.0

package/dist/detectors/serverComponents.js

@@ -0,0 +1,222 @@
+import * as t from '@babel/types';
+// Hooks that are not allowed in Server Components
+const CLIENT_ONLY_HOOKS = [
+    'useState',
+    'useReducer',
+    'useEffect',
+    'useLayoutEffect',
+    'useInsertionEffect',
+    'useRef',
+    'useImperativeHandle',
+    'useSyncExternalStore',
+    'useTransition',
+    'useDeferredValue',
+    'useOptimistic',
+    'useFormStatus',
+    'useActionState',
+];
+// Browser-only APIs
+const BROWSER_APIS = [
+    'window',
+    'document',
+    'localStorage',
+    'sessionStorage',
+    'navigator',
+    'location',
+    'history',
+    'alert',
+    'confirm',
+    'prompt',
+    'fetch', // Can be used in Server Components but behaves differently
+];
+// Event handler props (indicate client interactivity)
+const EVENT_HANDLER_PATTERN = /^on[A-Z]/;
+/**
+ * Detect React 19 Server/Client component boundary issues
+ */
+export function detectServerComponentIssues(component, filePath, sourceCode, config, imports = []) {
+    if (!config.checkServerComponents)
+        return [];
+    const smells = [];
+    const lines = sourceCode.split('\n');
+    // Check if file has 'use client' or 'use server' directive
+    const hasUseClient = lines.some(line => /^['"]use client['"];?\s*$/.test(line.trim()));
+    const hasUseServer = lines.some(line => /^['"]use server['"];?\s*$/.test(line.trim()));
+    // Detect if this is a Server Component (no 'use client' directive in app/ directory)
+    const isInAppDir = filePath.includes('/app/') || filePath.includes('\\app\\');
+    const isServerComponent = isInAppDir && !hasUseClient;
+    if (isServerComponent) {
+        // Check for client-only hooks in Server Components
+        const clientHooksUsed = [];
+        for (const hookName of CLIENT_ONLY_HOOKS) {
+            const hooks = component.hooks[hookName];
+            if (hooks && hooks.length > 0) {
+                clientHooksUsed.push(hookName);
+            }
+        }
+        // Also traverse for any hook calls
+        component.path.traverse({
+            CallExpression(path) {
+                const callee = path.node.callee;
+                if (t.isIdentifier(callee) && CLIENT_ONLY_HOOKS.includes(callee.name)) {
+                    if (!clientHooksUsed.includes(callee.name)) {
+                        clientHooksUsed.push(callee.name);
+                    }
+                }
+            },
+        });
+        if (clientHooksUsed.length > 0) {
+            smells.push({
+                type: 'server-component-hooks',
+                severity: 'error',
+                message: `Server Component "${component.name}" uses client-only hooks: ${clientHooksUsed.join(', ')}`,
+                file: filePath,
+                line: component.startLine,
+                column: 0,
+                suggestion: `Add 'use client' directive at the top of the file, or move stateful logic to a Client Component.`,
+            });
+        }
+        // Check for event handlers in JSX (onClick, onChange, etc.)
+        const eventHandlers = [];
+        component.path.traverse({
+            JSXAttribute(path) {
+                if (t.isJSXIdentifier(path.node.name)) {
+                    const name = path.node.name.name;
+                    if (EVENT_HANDLER_PATTERN.test(name)) {
+                        if (!eventHandlers.includes(name)) {
+                            eventHandlers.push(name);
+                        }
+                    }
+                }
+            },
+        });
+        if (eventHandlers.length > 0) {
+            smells.push({
+                type: 'server-component-events',
+                severity: 'error',
+                message: `Server Component "${component.name}" uses event handlers: ${eventHandlers.join(', ')}`,
+                file: filePath,
+                line: component.startLine,
+                column: 0,
+                suggestion: `Add 'use client' directive or extract interactive elements to a Client Component.`,
+            });
+        }
+        // Check for browser APIs usage
+        const browserApisUsed = [];
+        component.path.traverse({
+            Identifier(path) {
+                const name = path.node.name;
+                if (BROWSER_APIS.includes(name)) {
+                    // Make sure it's not a property access like obj.window
+                    if (!t.isMemberExpression(path.parent) || !t.isIdentifier(path.parent.property) || path.parent.object === path.node) {
+                        if (!browserApisUsed.includes(name)) {
+                            browserApisUsed.push(name);
+                        }
+                    }
+                }
+            },
+        });
+        if (browserApisUsed.length > 0) {
+            smells.push({
+                type: 'server-component-browser-api',
+                severity: 'warning',
+                message: `Server Component "${component.name}" may use browser APIs: ${browserApisUsed.join(', ')}`,
+                file: filePath,
+                line: component.startLine,
+                column: 0,
+                suggestion: `Browser APIs are not available in Server Components. Move to a Client Component or use conditional checks.`,
+            });
+        }
+    }
+    // Check for 'use server' in client components (async actions)
+    if (hasUseClient && hasUseServer) {
+        smells.push({
+            type: 'mixed-directives',
+            severity: 'error',
+            message: `File has both 'use client' and 'use server' directives`,
+            file: filePath,
+            line: 1,
+            column: 0,
+            suggestion: `A file can only be either a Client Component or contain Server Actions, not both. Separate them into different files.`,
+        });
+    }
+    // Check for async component without 'use server' actions (they should be in Server Components)
+    if (!isServerComponent && !hasUseServer) {
+        let hasAsyncServerAction = false;
+        component.path.traverse({
+            FunctionDeclaration(path) {
+                if (path.node.async) {
+                    // Check if body starts with 'use server'
+                    const body = path.node.body;
+                    if (body.directives?.some(d => d.value.value === 'use server')) {
+                        hasAsyncServerAction = true;
+                    }
+                }
+            },
+            ArrowFunctionExpression(path) {
+                if (path.node.async && t.isBlockStatement(path.node.body)) {
+                    const directives = path.node.body.directives;
+                    if (directives?.some(d => d.value.value === 'use server')) {
+                        hasAsyncServerAction = true;
+                    }
+                }
+            },
+        });
+        // This is fine - Server Actions can be defined inline with 'use server' inside
+    }
+    // Check for passing server actions incorrectly to client components
+    // (This is complex to detect statically, so we provide guidance)
+    // Check for importing Server Component into Client Component (potential issue)
+    if (hasUseClient) {
+        // Look for imports that might be Server Components
+        const serverComponentImports = imports.filter(imp => {
+            // Heuristic: imports from app/ directory without 'use client'
+            return imp.includes('/app/') && !imp.includes('.client');
+        });
+        // Can't definitively detect, but can warn about patterns
+    }
+    return smells;
+}
+/**
+ * Detect proper async component patterns in React 19
+ */
+export function detectAsyncComponentIssues(component, filePath, sourceCode, config) {
+    if (!config.checkServerComponents)
+        return [];
+    const smells = [];
+    const lines = sourceCode.split('\n');
+    const hasUseClient = lines.some(line => /^['"]use client['"];?\s*$/.test(line.trim()));
+    // Check if component is async
+    let isAsync = false;
+    const node = component.path.node;
+    if (t.isFunctionDeclaration(node) || t.isFunctionExpression(node) || t.isArrowFunctionExpression(node)) {
+        isAsync = node.async || false;
+    }
+    // Async components in Client Components are not allowed
+    if (isAsync && hasUseClient) {
+        smells.push({
+            type: 'async-client-component',
+            severity: 'error',
+            message: `Client Component "${component.name}" is async, which is not supported`,
+            file: filePath,
+            line: component.startLine,
+            column: 0,
+            suggestion: `Remove async from the component. Use useEffect or React Query for data fetching in Client Components.`,
+        });
+    }
+    // Check for proper Suspense usage with async Server Components
+    if (isAsync && !hasUseClient) {
+        // Good pattern - async Server Component
+        // Could check if parent has Suspense boundary, but that requires cross-file analysis
+    }
+    return smells;
+}
+/**
+ * Get code snippet for context
+ */
+function getCodeSnippet(sourceCode, line) {
+    const lines = sourceCode.split('\n');
+    const startLine = Math.max(0, line - 2);
+    const endLine = Math.min(lines.length, line + 1);
+    return lines.slice(startLine, endLine).join('\n');
+}

package/dist/docGenerator.d.ts

@@ -0,0 +1,37 @@
+import { AnalysisResult, CodeSmell } from './types/index.js';
+export interface DocGeneratorOptions {
+    format: 'markdown' | 'html' | 'json';
+    outputDir?: string;
+    includeSmells?: boolean;
+    includeMetrics?: boolean;
+    groupByFolder?: boolean;
+}
+export interface ComponentDoc {
+    name: string;
+    file: string;
+    relativePath: string;
+    lineCount: number;
+    props: string[];
+    hooks: {
+        useState: number;
+        useEffect: number;
+        useMemo: number;
+        useCallback: number;
+        useRef: number;
+        custom: string[];
+    };
+    smells: CodeSmell[];
+    metrics: {
+        complexity: string;
+        maintainability: string;
+    };
+}
+/**
+ * Generate documentation from component analysis
+ */
+export declare function generateComponentDocs(result: AnalysisResult, rootDir: string, options?: DocGeneratorOptions): Promise<string>;
+/**
+ * Write documentation to file
+ */
+export declare function writeComponentDocs(result: AnalysisResult, rootDir: string, options: DocGeneratorOptions): Promise<string>;
+//# sourceMappingURL=docGenerator.d.ts.map

package/dist/docGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docGenerator.d.ts","sourceRoot":"","sources":["../src/docGenerator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAA+B,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE1F,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE;QACL,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB,CAAC;IACF,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,OAAO,EAAE;QACP,UAAU,EAAE,MAAM,CAAC;QACnB,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,mBAA4C,GACpD,OAAO,CAAC,MAAM,CAAC,CAYjB;AAqTD;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,MAAM,CAAC,CAYjB"}

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/git.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../src/git.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,OAAO;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAiFnD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAcpE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,MAAM,EAAE,CAcpF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAW7D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAG1D"}
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../src/git.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,OAAO;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAyEnD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAcpE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,MAAM,EAAE,CAcpF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAW7D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAG1D"}

package/dist/git.js

@@ -61,13 +61,6 @@ export function getGitInfo(rootDir) {
             stagedFiles,
             untrackedFiles,
         };
-        return {
-            isGitRepo: true,
-            currentBranch,
-            changedFiles,
-            stagedFiles,
-            untrackedFiles,
-        };
     }
     catch {
         return {

package/dist/graphGenerator.d.ts

@@ -0,0 +1,34 @@
+export interface DependencyNode {
+    id: string;
+    file: string;
+    type: 'component' | 'file';
+    imports: string[];
+    importedBy: string[];
+    size?: number;
+    isCircular?: boolean;
+}
+export interface DependencyGraph {
+    nodes: Map<string, DependencyNode>;
+    edges: Array<{
+        from: string;
+        to: string;
+        circular: boolean;
+    }>;
+    circularDependencies: string[][];
+}
+/**
+ * Build dependency graph from parsed components
+ */
+export declare function buildDependencyGraph(files: Array<{
+    file: string;
+    imports: string[];
+}>, rootDir: string): DependencyGraph;
+/**
+ * Generate SVG representation of dependency graph
+ */
+export declare function generateDependencyGraph(graph: DependencyGraph, width?: number, height?: number): string;
+/**
+ * Generate HTML report with dependency graph
+ */
+export declare function generateDependencyGraphHTML(graph: DependencyGraph, projectName: string, circularCount?: number): string;
+//# sourceMappingURL=graphGenerator.d.ts.map

package/dist/graphGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphGenerator.d.ts","sourceRoot":"","sources":["../src/graphGenerator.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,WAAW,GAAG,MAAM,CAAC;IAC3B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACnC,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC9D,oBAAoB,EAAE,MAAM,EAAE,EAAE,CAAC;CAClC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,EACjD,OAAO,EAAE,MAAM,GACd,eAAe,CA2CjB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,eAAe,EAAE,KAAK,SAAO,EAAE,MAAM,SAAM,GAAG,MAAM,CA4DlG;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,eAAe,EACtB,WAAW,EAAE,MAAM,EACnB,aAAa,SAAI,GAChB,MAAM,CA6HR"}