/**
 * Canonical identity key for the `list`/`list_files` cross-reference: a file's
 * realpath, falling back to the input path when realpath fails (orphaned or
 * raw-data entries). Matching ingested DB entries against scanned files by this
 * key recognizes the same physical file across symlinked spellings (prefix or
 * alias). Storage, lookup, and display still use the normal resolve() path —
 * realpath here is the file-identity comparison, not a user-facing value.
 */
export declare function realpathForMatch(filePath: string): Promise<string>;
/** A directory that could not be read during the scan. */
export interface UnreadableDir {
    dirPath: string;
    /** Node error `code` (e.g. `EACCES`), or `'UNKNOWN'` when unavailable. */
    code: string;
}
/** Structured result of a bounded directory scan. */
export interface DirScanResult {
    /** Supported files found under the root, in BFS-discovery order (unsorted). */
    files: string[];
    /** Directories skipped because `readdir` failed (caller decides how to warn). */
    unreadableDirs: UnreadableDir[];
    /** True if any branch was pruned for exceeding `maxDepth`. */
    depthLimited: boolean;
}
/**
 * Bounded BFS scan of a single root, collecting every supported file up to
 * `maxDepth` levels deep. Symlinks are skipped; paths under any `excludePaths`
 * prefix are filtered out. A per-directory `readdir` failure is captured into
 * `unreadableDirs` and does not abort the scan (best-effort per directory).
 *
 * Does not sort, dedupe, or emit warnings — callers handle those so their
 * existing output contracts are preserved.
 */
export declare function bfsCollectSupportedFiles(rootPath: string, excludePaths: readonly string[], maxDepth?: number): Promise<DirScanResult>;
//# sourceMappingURL=scan.d.ts.map