code-auditor-mcp 4.1.1 → 5.0.1

package/dist/codeIndexService.js

@@ -3,27 +3,61 @@
  * Main service functions for managing the function index using LokiJS + FlexSearch
  */
 import { CodeIndexDB } from './codeIndexDB.js';
+import { errorMessage } from './utils/errorMessage.js';
 import path from 'path';
 // Custom error types
+/**
+ * Base error type for code-index failures, carrying a stable machine-readable code.
+ */
 export class CodeIndexError extends Error {
     code;
+    /**
+     * Creates a code index error.
+     *
+     * @param message - The human-readable error message.
+     * @param code - The stable machine-readable error code.
+     */
     constructor(message, code) {
         super(message);
         this.code = code;
         this.name = 'CodeIndexError';
     }
 }
+/**
+ * Raised when function metadata fails validation.
+ */
 export class ValidationError extends CodeIndexError {
+    /**
+     * Creates a validation error with the `VALIDATION_ERROR` code.
+     *
+     * @param message - The human-readable validation failure message.
+     */
     constructor(message) {
         super(message, 'VALIDATION_ERROR');
     }
 }
+/**
+ * Raised when a database operation on the code index fails.
+ */
 export class DatabaseError extends CodeIndexError {
+    /**
+     * Creates a database error with the `DATABASE_ERROR` code.
+     *
+     * @param message - The human-readable database failure message.
+     */
     constructor(message) {
         super(message, 'DATABASE_ERROR');
     }
 }
+/**
+ * Raised when a search over the code index fails.
+ */
 export class SearchError extends CodeIndexError {
+    /**
+     * Creates a search error with the `SEARCH_ERROR` code.
+     *
+     * @param message - The human-readable search failure message.
+     */
     constructor(message) {
         super(message, 'SEARCH_ERROR');
     }
@@ -32,6 +66,9 @@ export class SearchError extends CodeIndexError {
  * Initialize database with schema.
  * Default (no path): same on-disk singleton as CodeIndexDB.getInstance() / MCP.
  * Explicit file path: separate DB instance (tests or advanced use).
+ *
+ * @param dbPath - Optional explicit database file path, or `:memory:`.
+ * @returns The initialized `CodeIndexDB` instance.
  */
 export async function initializeCodeIndex(dbPath) {
     try {
@@ -45,7 +82,7 @@ export async function initializeCodeIndex(dbPath) {
         return db;
     }
     catch (error) {
-        throw new DatabaseError(`Failed to initialize code index: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        throw new DatabaseError(`Failed to initialize code index: ${errorMessage(error)}`);
     }
 }
 /**
@@ -56,7 +93,10 @@ export async function getDatabase() {
     return initializeCodeIndex();
 }
 /**
- * Validate function metadata
+ * Validate function metadata.
+ *
+ * @param func - The function metadata to validate.
+ * @returns An error message, or null when the metadata is valid.
  */
 export function validateFunctionMetadata(func) {
     if (!func || typeof func !== 'object') {
@@ -86,7 +126,11 @@ export function validateFunctionMetadata(func) {
     return null;
 }
 /**
- * Register functions in the index
+ * Register functions in the index.
+ *
+ * @param functions - The function metadata records to register.
+ * @param options - Optional overwrite behavior.
+ * @returns The registration result including any validation errors.
  */
 export async function registerFunctions(functions, options = {}) {
     const db = await getDatabase();
@@ -103,7 +147,7 @@ export async function registerFunctions(functions, options = {}) {
         }
     }
     // Register valid functions
-    const result = await db.registerFunctions(validFunctions);
+    const result = await db.functionIndex.registerFunctions(validFunctions);
     // Combine errors
     if (errors.length > 0 && result.errors) {
         result.errors.push(...errors);
@@ -115,19 +159,26 @@ export async function registerFunctions(functions, options = {}) {
     return result;
 }
 /**
- * Search functions with full-text search
+ * Search functions with full-text search.
+ *
+ * @param searchOptions - The query, filters, and pagination for the search.
+ * @returns The matching functions and metadata.
  */
 export async function searchFunctions(searchOptions) {
     const db = await getDatabase();
     try {
-        return await db.searchFunctions(searchOptions);
+        return await db.search.searchFunctions(searchOptions);
     }
     catch (error) {
-        throw new SearchError(`Search failed: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        throw new SearchError(`Search failed: ${errorMessage(error)}`);
     }
 }
 /**
- * Synchronize file index - ensures index matches current file state
+ * Synchronize file index - ensures index matches current file state.
+ *
+ * @param filePath - The file whose index entry is being synced.
+ * @param currentFunctions - The functions currently present in the file.
+ * @returns Counts of added, updated, and removed functions.
  */
 export async function syncFileIndex(filePath, currentFunctions) {
     const db = await getDatabase();
@@ -135,28 +186,34 @@ export async function syncFileIndex(filePath, currentFunctions) {
         return await db.syncFileIndex(filePath, currentFunctions);
     }
     catch (error) {
-        throw new DatabaseError(`Failed to sync file index: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        throw new DatabaseError(`Failed to sync file index: ${errorMessage(error)}`);
     }
 }
 /**
- * Find a specific function definition
+ * Find a specific function definition.
+ *
+ * @param name - The function name to look up.
+ * @param filePath - Optional file path to disambiguate the lookup.
+ * @returns The matching function metadata, or null if not found.
  */
 export async function findDefinition(name, filePath) {
     const db = await getDatabase();
     try {
-        return await db.findDefinition(name, filePath);
+        return await db.functionIndex.findDefinition(name, filePath);
     }
     catch (error) {
-        throw new SearchError(`Failed to find definition: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        throw new SearchError(`Failed to find definition: ${errorMessage(error)}`);
     }
 }
 /**
- * Get index statistics
+ * Get index statistics.
+ *
+ * @returns The current index statistics.
  */
 export async function getIndexStats() {
     const db = await getDatabase();
     try {
-        const stats = await db.getStats();
+        const stats = await db.functionIndex.getStats();
         return {
             totalFunctions: stats.totalFunctions,
             languages: stats.languages,
@@ -166,12 +223,14 @@ export async function getIndexStats() {
         };
     }
     catch (error) {
-        throw new DatabaseError(`Failed to get index stats: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        throw new DatabaseError(`Failed to get index stats: ${errorMessage(error)}`);
     }
 }
 /**
  * Clear analysis-derived index data (functions, search, audits, code maps, schemas).
  * Does not remove project tasks, analyzer configs, or whitelist entries.
+ *
+ * @returns A promise that resolves once the index is cleared.
  */
 export async function clearIndex() {
     const db = await getDatabase();
@@ -179,7 +238,7 @@ export async function clearIndex() {
         await db.clearIndex();
     }
     catch (error) {
-        throw new DatabaseError(`Failed to clear index: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        throw new DatabaseError(`Failed to clear index: ${errorMessage(error)}`);
     }
 }
 /**
@@ -189,75 +248,92 @@ export async function closeDatabase() {
     await CodeIndexDB.getInstance().close();
 }
 /**
- * Update dependency graph for all functions or specific file
+ * Update dependency graph for all functions or a specific file.
+ *
+ * @param filePath - Optional file path to restrict the update to.
+ * @returns A promise that resolves once the graph is updated.
  */
 export async function updateDependencyGraph(filePath) {
     const db = await getDatabase();
     try {
-        await db.updateDependencyGraph(filePath);
+        await db.graph.updateDependencyGraph(filePath);
     }
     catch (error) {
-        throw new DatabaseError(`Failed to update dependency graph: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        throw new DatabaseError(`Failed to update dependency graph: ${errorMessage(error)}`);
     }
 }
 /**
- * Get transitive dependencies for a function
+ * Get transitive dependencies for a function.
+ *
+ * @param functionName - The function to resolve dependencies for.
+ * @param maxDepth - Maximum traversal depth (default 10).
+ * @returns The transitive dependencies with their depths.
  */
 export async function getTransitiveDependencies(functionName, maxDepth = 10) {
     const db = await getDatabase();
     try {
-        return await db.getTransitiveDependencies(functionName, maxDepth);
+        return await db.graph.getTransitiveDependencies(functionName, maxDepth);
     }
     catch (error) {
-        throw new DatabaseError(`Failed to get transitive dependencies: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        throw new DatabaseError(`Failed to get transitive dependencies: ${errorMessage(error)}`);
     }
 }
 /**
- * Get transitive callers for a function
+ * Get transitive callers for a function.
+ *
+ * @param functionName - The function to resolve callers for.
+ * @param maxDepth - Maximum traversal depth (default 10).
+ * @returns The transitive callers with their depths.
  */
 export async function getTransitiveCallers(functionName, maxDepth = 10) {
     const db = await getDatabase();
     try {
-        return await db.getTransitiveCallers(functionName, maxDepth);
+        return await db.graph.getTransitiveCallers(functionName, maxDepth);
     }
     catch (error) {
-        throw new DatabaseError(`Failed to get transitive callers: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        throw new DatabaseError(`Failed to get transitive callers: ${errorMessage(error)}`);
     }
 }
 /**
- * Detect circular dependencies in the codebase
+ * Detect circular dependencies in the codebase.
+ *
+ * @returns The detected dependency cycles.
  */
 export async function detectCircularDependencies() {
     const db = await getDatabase();
     try {
-        return await db.detectCircularDependencies();
+        return await db.graph.detectCircularDependencies();
     }
     catch (error) {
-        throw new DatabaseError(`Failed to detect circular dependencies: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        throw new DatabaseError(`Failed to detect circular dependencies: ${errorMessage(error)}`);
     }
 }
 /**
- * Calculate dependency depths for all functions
+ * Calculate dependency depths for all functions.
+ *
+ * @returns A promise that resolves once depths are calculated.
  */
 export async function calculateDependencyDepths() {
     const db = await getDatabase();
     try {
-        await db.calculateDependencyDepths();
+        await db.graph.calculateDependencyDepths();
     }
     catch (error) {
-        throw new DatabaseError(`Failed to calculate dependency depths: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        throw new DatabaseError(`Failed to calculate dependency depths: ${errorMessage(error)}`);
     }
 }
 /**
- * Get all functions from the index
+ * Get all functions from the index.
+ *
+ * @returns All indexed functions with their metadata.
  */
 export async function getAllFunctions() {
     const db = await getDatabase();
     try {
-        return await db.getAllFunctions();
+        return await db.functionIndex.getAllFunctions();
     }
     catch (error) {
-        throw new DatabaseError(`Failed to get all functions: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        throw new DatabaseError(`Failed to get all functions: ${errorMessage(error)}`);
     }
 }
 //# sourceMappingURL=codeIndexService.js.map

package/dist/codeIndexService.js.map

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

package/dist/componentScanner.d.ts

@@ -9,6 +9,7 @@
  * TypeChecker-based prop extraction is a documented capability regression (plan Step 2.5).
  */
 import { ComponentMetadata, FunctionMetadata } from './types.js';
+import type { AST } from './languages/types.js';
 /**
  * Configuration options for component scanning
  */
@@ -38,20 +39,54 @@ interface ComponentImport {
     path: string;
     isDefault: boolean;
 }
+/**
+ * Scan an already-parsed file for React components.
+ *
+ * This is the scan body split out of {@link scanFile} so the phase model's
+ * `react-component` producer can scan a `ParsedFile` it already holds — without
+ * re-reading from disk or re-parsing. `ast` is the tree-sitter parse (`ast.root`
+ * is the node the walk starts from); `content` is the source the node text is
+ * sliced from; `filePath` stamps every component's identity. The phase producer
+ * always passes `extractHooks: true` (the legacy visitor tied it to
+ * `checkHooksRules`, but the `hooks-naming` rule gates on that flag itself, so
+ * the extraction has no effect on findings).
+ *
+ * @param ast - Tree-sitter parse of the file (`ast.root` is the walk start).
+ * @param content - Source text the node text is sliced from.
+ * @param filePath - File path stamped onto every scanned component.
+ * @param options - Scanner options (extract hooks/props/imports, complexity, etc.).
+ * @returns Scan result with components, imports, and any parse errors.
+ */
+export declare function scanParsedFile(ast: AST, content: string, filePath: string, options?: ComponentScannerOptions): ComponentScanResult;
 /**
  * Scan a single file for React components
+ *
+ * @param filePath - Path to the file to read, parse, and scan.
+ * @param options - Scanner options forwarded to {@link scanParsedFile}.
+ * @returns Scan result (or an error-carrying result when read/parse fails).
  */
 export declare function scanFile(filePath: string, options?: ComponentScannerOptions): Promise<ComponentScanResult>;
 /**
  * Scan multiple files for React components
+ *
+ * @param filePaths - Paths of files to scan sequentially.
+ * @param options - Scanner options forwarded to each file.
+ * @param progressCallback - Optional callback invoked with (current, total) progress.
+ * @returns Scan results in input order.
  */
 export declare function scanFiles(filePaths: string[], options?: ComponentScannerOptions, progressCallback?: (current: number, total: number) => void): Promise<ComponentScanResult[]>;
 /**
  * Create a component dependency tree from scan results
+ *
+ * @param scanResults - Scan results whose component JSX usage defines the edges.
+ * @returns Map of component name to the set of imported component names it uses.
  */
 export declare function buildComponentTree(scanResults: ComponentScanResult[]): Map<string, Set<string>>;
 /**
  * Convert component metadata to function metadata for indexing
+ *
+ * @param component - Component metadata to convert.
+ * @returns Function metadata with component-specific fields moved into `metadata`.
  */
 export declare function componentToFunctionMetadata(component: ComponentMetadata): FunctionMetadata;
 export {};

package/dist/componentScanner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"componentScanner.d.ts","sourceRoot":"","sources":["../src/componentScanner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAwC,MAAM,YAAY,CAAC;AA6BvG;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAWD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAYD;;GAEG;AACH,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;CACpB;AAMD;;GAEG;AACH,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,uBAAyC,GACjD,OAAO,CAAC,mBAAmB,CAAC,CAmH9B;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC7B,SAAS,EAAE,MAAM,EAAE,EACnB,OAAO,GAAE,uBAAyC,EAClD,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,GAC1D,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAahC;AAkRD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,mBAAmB,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAmC/F;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,iBAAiB,GAAG,gBAAgB,CAgB1F"}
+{"version":3,"file":"componentScanner.d.ts","sourceRoot":"","sources":["../src/componentScanner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAwC,MAAM,YAAY,CAAC;AAavG,OAAO,KAAK,EAAE,GAAG,EAAW,MAAM,sBAAsB,CAAC;AAgBzD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAWD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAYD;;GAEG;AACH,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;CACpB;AAMD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,GAAG,EACR,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,uBAAyC,GACjD,mBAAmB,CA0FrB;AAED;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,uBAAyC,GACjD,OAAO,CAAC,mBAAmB,CAAC,CAwB9B;AAED;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAC7B,SAAS,EAAE,MAAM,EAAE,EACnB,OAAO,GAAE,uBAAyC,EAClD,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,GAC1D,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAahC;AAkRD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,mBAAmB,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAmC/F;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,iBAAiB,GAAG,gBAAgB,CAgB1F"}

package/dist/componentScanner.js

@@ -29,8 +29,110 @@ const DEFAULT_OPTIONS = {
 // ---------------------------------------------------------------------------
 // File scanning
 // ---------------------------------------------------------------------------
+/**
+ * Scan an already-parsed file for React components.
+ *
+ * This is the scan body split out of {@link scanFile} so the phase model's
+ * `react-component` producer can scan a `ParsedFile` it already holds — without
+ * re-reading from disk or re-parsing. `ast` is the tree-sitter parse (`ast.root`
+ * is the node the walk starts from); `content` is the source the node text is
+ * sliced from; `filePath` stamps every component's identity. The phase producer
+ * always passes `extractHooks: true` (the legacy visitor tied it to
+ * `checkHooksRules`, but the `hooks-naming` rule gates on that flag itself, so
+ * the extraction has no effect on findings).
+ *
+ * @param ast - Tree-sitter parse of the file (`ast.root` is the walk start).
+ * @param content - Source text the node text is sliced from.
+ * @param filePath - File path stamped onto every scanned component.
+ * @param options - Scanner options (extract hooks/props/imports, complexity, etc.).
+ * @returns Scan result with components, imports, and any parse errors.
+ */
+export function scanParsedFile(ast, content, filePath, options = DEFAULT_OPTIONS) {
+    const root = ast.root;
+    const state = {
+        currentFile: filePath,
+        components: [],
+        imports: [],
+        errors: []
+    };
+    // Extract component imports if requested
+    if (options.extractImports) {
+        state.imports = extractComponentImports(root, content);
+    }
+    // Pre-scan: find function declarations that use built-in hooks
+    // without starting with 'use' — these are hooks-naming violations
+    // when called inside components.
+    const hookUsingFunctions = options.extractHooks ? findHookUsingFunctions(root, content) : new Set();
+    // Walk the AST and scan for React components
+    // walkAST visits every node recursively — no manual recursion needed
+    walkAST(root, (node) => {
+        if (!isReactComponent(node, content))
+            return;
+        const componentType = detectComponentType(node, content);
+        if (!componentType)
+            return;
+        const componentName = getComponentName(node, content);
+        // Skip test/story components if configured
+        if (!options.includeTests && componentName.includes('Test'))
+            return;
+        if (!options.includeStories && componentName.includes('Story'))
+            return;
+        // Skip anonymous components — these are arrow callbacks in .map() / .filter()
+        // that return JSX and get misdetected as functional components.
+        if (componentName === 'AnonymousComponent')
+            return;
+        // getLineAndColumn returns 1-based via toSourceLocation — no compensation needed.
+        const { line } = getLineAndColumn(node);
+        const endLine = node.location?.end?.line ?? line;
+        const component = {
+            name: componentName,
+            filePath: state.currentFile,
+            lineNumber: line,
+            startLine: line,
+            endLine: endLine,
+            entityType: 'component',
+            componentType,
+            dependencies: [], // Will be populated later from imports
+            purpose: `React ${componentType} component`,
+            context: extractComponentContext(node, content),
+            isExported: isComponentExported(node),
+            body: getNodeText(node, content)
+        };
+        // Extract hooks if functional component
+        if (options.extractHooks && (componentType === 'functional' || componentType === 'memo' || componentType === 'forwardRef')) {
+            component.hooks = extractHooks(node, content, hookUsingFunctions.size > 0 ? hookUsingFunctions : undefined);
+        }
+        // Extract props (tree-sitter: no TypeChecker — capability regression per plan Step 2.5)
+        if (options.extractProps) {
+            component.props = extractPropTypes(node, content);
+        }
+        // Extract JSX elements used
+        component.jsxElements = extractJSXElements(node, content);
+        component.jsxElementDetails = extractJSXElementDetails(node, content);
+        // Calculate complexity if requested
+        if (options.detectComplexity) {
+            component.complexity = calculateComponentComplexity(node, content);
+        }
+        // Check for error boundary (class components)
+        if (componentType === 'class') {
+            component.hasErrorBoundary = hasErrorBoundaryMethods(node, content);
+        }
+        state.components.push(component);
+    });
+    return {
+        filePath,
+        components: state.components,
+        imports: state.imports,
+        fileHash: undefined, // TODO: implement file hash calculation
+        parseErrors: state.errors.length > 0 ? state.errors : undefined
+    };
+}
 /**
  * Scan a single file for React components
+ *
+ * @param filePath - Path to the file to read, parse, and scan.
+ * @param options - Scanner options forwarded to {@link scanParsedFile}.
+ * @returns Scan result (or an error-carrying result when read/parse fails).
  */
 export async function scanFile(filePath, options = DEFAULT_OPTIONS) {
     try {
@@ -45,86 +147,7 @@ export async function scanFile(filePath, options = DEFAULT_OPTIONS) {
                 parseErrors: ['Failed to parse file']
             };
         }
-        const root = ast.root;
-        const state = {
-            currentFile: filePath,
-            components: [],
-            imports: [],
-            errors: []
-        };
-        // Extract component imports if requested
-        if (options.extractImports) {
-            state.imports = extractComponentImports(root, content);
-        }
-        // Pre-scan: find function declarations that use built-in hooks
-        // without starting with 'use' — these are hooks-naming violations
-        // when called inside components.
-        const hookUsingFunctions = options.extractHooks ? findHookUsingFunctions(root, content) : new Set();
-        // Walk the AST and scan for React components
-        // walkAST visits every node recursively — no manual recursion needed
-        walkAST(root, (node) => {
-            if (!isReactComponent(node, content))
-                return;
-            const componentType = detectComponentType(node, content);
-            if (!componentType)
-                return;
-            const componentName = getComponentName(node, content);
-            // Skip test/story components if configured
-            if (!options.includeTests && componentName.includes('Test'))
-                return;
-            if (!options.includeStories && componentName.includes('Story'))
-                return;
-            // Skip anonymous components — these are arrow callbacks in .map() / .filter()
-            // that return JSX and get misdetected as functional components.
-            if (componentName === 'AnonymousComponent')
-                return;
-            // getLineAndColumn returns 1-based via toSourceLocation — no compensation needed.
-            const { line } = getLineAndColumn(node);
-            const endLine = node.location?.end?.line ?? line;
-            const component = {
-                name: componentName,
-                filePath: state.currentFile,
-                lineNumber: line,
-                startLine: line,
-                endLine: endLine,
-                entityType: 'component',
-                componentType,
-                dependencies: [], // Will be populated later from imports
-                purpose: `React ${componentType} component`,
-                context: extractComponentContext(node, content),
-                isExported: isComponentExported(node),
-                body: getNodeText(node, content)
-            };
-            // Extract hooks if functional component
-            if (options.extractHooks && (componentType === 'functional' || componentType === 'memo' || componentType === 'forwardRef')) {
-                component.hooks = extractHooks(node, content, hookUsingFunctions.size > 0 ? hookUsingFunctions : undefined);
-            }
-            // Extract props (tree-sitter: no TypeChecker — capability regression per plan Step 2.5)
-            if (options.extractProps) {
-                component.props = extractPropTypes(node, content);
-            }
-            // Extract JSX elements used
-            component.jsxElements = extractJSXElements(node, content);
-            component.jsxElementDetails = extractJSXElementDetails(node, content);
-            // Calculate complexity if requested
-            if (options.detectComplexity) {
-                component.complexity = calculateComponentComplexity(node, content);
-            }
-            // Check for error boundary (class components)
-            if (componentType === 'class') {
-                component.hasErrorBoundary = hasErrorBoundaryMethods(node, content);
-            }
-            state.components.push(component);
-        });
-        // Calculate file hash for change detection
-        const fileHash = undefined; // TODO: implement file hash calculation
-        return {
-            filePath,
-            components: state.components,
-            imports: state.imports,
-            fileHash,
-            parseErrors: state.errors.length > 0 ? state.errors : undefined
-        };
+        return scanParsedFile(ast, content, filePath, options);
     }
     catch (error) {
         return {
@@ -137,6 +160,11 @@ export async function scanFile(filePath, options = DEFAULT_OPTIONS) {
 }
 /**
  * Scan multiple files for React components
+ *
+ * @param filePaths - Paths of files to scan sequentially.
+ * @param options - Scanner options forwarded to each file.
+ * @param progressCallback - Optional callback invoked with (current, total) progress.
+ * @returns Scan results in input order.
  */
 export async function scanFiles(filePaths, options = DEFAULT_OPTIONS, progressCallback) {
     const results = [];
@@ -398,6 +426,9 @@ function hasErrorBoundaryMethods(node, content) {
 // ---------------------------------------------------------------------------
 /**
  * Create a component dependency tree from scan results
+ *
+ * @param scanResults - Scan results whose component JSX usage defines the edges.
+ * @returns Map of component name to the set of imported component names it uses.
  */
 export function buildComponentTree(scanResults) {
     const tree = new Map();
@@ -432,6 +463,9 @@ export function buildComponentTree(scanResults) {
 }
 /**
  * Convert component metadata to function metadata for indexing
+ *
+ * @param component - Component metadata to convert.
+ * @returns Function metadata with component-specific fields moved into `metadata`.
  */
 export function componentToFunctionMetadata(component) {
     const { entityType, componentType, props, hooks, jsxElements, imports, hasErrorBoundary, isExported, ...base } = component;