import type { SymbolKind } from './types';
/** Common directories to ignore when scanning */
export declare const IGNORED_DIRS: Set<string>;
/** File extensions to ignore */
export declare const IGNORED_EXTS: Set<string>;
interface CollectedFile {
    path: string;
    mtimeMs: number;
}
interface CollectResult {
    files: CollectedFile[];
    warning?: string;
}
/**
 * Collects a lightweight fingerprint of the repository for startup freshness checks.
 * Returns file count and max mtime without reading file contents.
 * Excludes the graph cache directory to avoid counting the metadata file itself.
 *
 * @param dir - Directory to fingerprint (usually cwd)
 * @param graphCacheDir - Optional graph cache directory to exclude. If not provided,
 *                        excludes common graph cache locations.
 * @returns Object with fileCount and maxMtimeMs
 */
export declare function collectIndexFingerprint(dir: string, graphCacheDir?: string): Promise<{
    fileCount: number;
    maxMtimeMs: number;
}>;
/**
 * Collect files from a directory - async version using git ls-files first
 */
export declare function collectFilesAsync(dir: string): Promise<CollectResult>;
/**
 * Collect files from a directory recursively (sync version)
 */
export declare function collectFiles(dir: string, maxFiles?: number, extensions?: string[]): string[];
/**
 * Estimate token count for a string
 */
export declare function estimateTokens(text: string): number;
/**
 * Get file extension from path
 */
export declare function getExtension(path: string): string;
/**
 * Check if file is a barrel file
 */
export declare function isBarrelFile(path: string): boolean;
/**
 * Normalize path separators
 */
export declare function normalizePath(path: string): string;
/**
 * Make path relative to a base directory
 */
export declare function makeRelative(path: string, baseDir: string): string;
/**
 * Extract a doc comment immediately above the symbol line
 */
export declare function extractDocComment(lines: string[], symbolLineIdx: number): string | null;
/**
 * Extract signature from a line
 */
export declare function extractSignature(lines: string[], lineIdx: number, kind: string): string | null;
/**
 * Get kind tag prefix
 */
export declare function kindTag(kind: SymbolKind): string;
/**
 * Generate synthetic summary for a symbol
 */
export declare function generateSyntheticSummary(name: string, kind: string, filePath: string): string;
/**
 * Get directory group for a file path
 */
export declare function getDirGroup(filePath: string): string | null;
export declare function barrelToDir(barrelPath: string): string;
export {};
//# sourceMappingURL=utils.d.ts.map