circle-ir-ai 1.1.0

package/dist/dead-code/detector.d.ts

@@ -0,0 +1,200 @@
+/**
+ * Dead Code Detector
+ *
+ * Detects unreachable code in a codebase by:
+ * 1. Identifying entry points (main methods, exports, HTTP handlers, etc.)
+ * 2. Building a call graph from those entry points
+ * 3. Finding functions/classes that are never reached
+ */
+import { type SupportedLanguage } from 'circle-ir';
+export interface DeadCodeOptions {
+    /** Root directory or file to analyze */
+    target: string;
+    /** Languages to analyze (default: auto-detect) */
+    languages?: SupportedLanguage[];
+    /** File patterns to include (glob) */
+    includePatterns?: string[];
+    /** File patterns to exclude (glob) */
+    excludePatterns?: string[];
+    /** Additional entry point patterns (method names that are entry points) */
+    additionalEntryPoints?: string[];
+    /** Include test files in analysis (default: false) */
+    includeTests?: boolean;
+    /** Consider all public methods as potential entry points (default: false) */
+    publicMethodsAsEntryPoints?: boolean;
+    /** Maximum depth for call graph traversal (default: 50) */
+    maxDepth?: number;
+    /** Verbose output */
+    verbose?: boolean;
+    /** Progress callback */
+    onProgress?: (progress: DetectionProgress) => void;
+}
+export interface DetectionProgress {
+    phase: 'discover' | 'analyze' | 'build-graph' | 'detect';
+    filesProcessed: number;
+    totalFiles: number;
+    message?: string;
+}
+export interface DeadCodeResult {
+    /** Analysis metadata */
+    meta: {
+        target: string;
+        timestamp: string;
+        durationMs: number;
+        filesAnalyzed: number;
+        totalMethods: number;
+        totalClasses: number;
+    };
+    /** Detected entry points */
+    entryPoints: EntryPoint[];
+    /** Unreachable (dead) code */
+    deadCode: DeadCodeItem[];
+    /** Summary statistics */
+    summary: DeadCodeSummary;
+    /** Reachability graph (for visualization) */
+    callGraph?: CallGraphNode[];
+}
+export interface EntryPoint {
+    type: 'main' | 'export' | 'handler' | 'public' | 'annotation' | 'constructor';
+    file: string;
+    className?: string;
+    methodName: string;
+    line: number;
+    reason: string;
+}
+export interface DeadCodeItem {
+    type: 'method' | 'class' | 'interface' | 'field';
+    file: string;
+    name: string;
+    className?: string;
+    startLine: number;
+    endLine: number;
+    lineCount: number;
+    reason: string;
+    confidence: 'high' | 'medium' | 'low';
+}
+export interface DeadCodeSummary {
+    totalFiles: number;
+    totalLOC: number;
+    totalMethods: number;
+    totalClasses: number;
+    deadMethods: number;
+    deadClasses: number;
+    deadLOC: number;
+    deadPercentage: number;
+    byFile: Array<{
+        file: string;
+        deadMethods: number;
+        deadClasses: number;
+        deadLOC: number;
+    }>;
+}
+export interface CallGraphNode {
+    id: string;
+    file: string;
+    className?: string;
+    methodName: string;
+    line: number;
+    calls: string[];
+    calledBy: string[];
+    isEntryPoint: boolean;
+    isReachable: boolean;
+}
+export declare class DeadCodeDetector {
+    private verbose;
+    private onProgress?;
+    private methodMap;
+    private callGraph;
+    private reverseCallGraph;
+    private entryPoints;
+    private reachable;
+    /**
+     * Detect dead code in a codebase.
+     */
+    detect(options: DeadCodeOptions): Promise<DeadCodeResult>;
+    /**
+     * Discover files to analyze.
+     */
+    private discoverFiles;
+    /**
+     * Check if path matches glob patterns.
+     */
+    private matchesPattern;
+    /**
+     * Analyze files and extract methods.
+     */
+    private analyzeFiles;
+    /**
+     * Build call graph from analyzed files.
+     */
+    private buildCallGraph;
+    /**
+     * Check if a method is an entry point.
+     */
+    private isEntryPoint;
+    /**
+     * Find the method containing a given line.
+     */
+    private findContainingMethod;
+    /**
+     * Resolve a call to potential target methods.
+     */
+    private resolveCallTarget;
+    /**
+     * Detect dead code using reachability analysis.
+     */
+    private detectDeadCode;
+    /**
+     * Generate final result.
+     */
+    private generateResult;
+    /**
+     * Get entry point type.
+     */
+    private getEntryPointType;
+    /**
+     * Get entry point reason.
+     */
+    private getEntryPointReason;
+    /**
+     * Generate method ID.
+     */
+    private getMethodId;
+    /**
+     * Detect language from file extension.
+     */
+    private detectLanguage;
+    /**
+     * Check if language is JavaScript or TypeScript.
+     */
+    private isJSTS;
+    /**
+     * Check if language is Python.
+     */
+    private isPython;
+    /**
+     * Check if language is Rust.
+     */
+    private isRust;
+    /**
+     * Check if language uses module-level entry points (JS/TS/Python).
+     */
+    private isModuleBasedLanguage;
+    /**
+     * Report progress.
+     */
+    private reportProgress;
+}
+/**
+ * Detect dead code in a directory or file.
+ */
+export declare function detectDeadCode(options: DeadCodeOptions): Promise<DeadCodeResult>;
+/**
+ * Quick dead code detection with default options.
+ */
+export declare function quickDeadCodeCheck(target: string): Promise<DeadCodeResult>;
+/**
+ * Generate a text report from dead code results.
+ */
+export declare function formatDeadCodeReport(result: DeadCodeResult): string;
+//# sourceMappingURL=detector.d.ts.map

package/dist/dead-code/detector.d.ts.map

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