import type Database from 'better-sqlite3';
/** A node a name could have referred to — enough to re-query unambiguously. */
export interface SymbolCandidate {
    id: string;
    name: string;
    label: string;
    filePath: string | null;
    startLine: number | null;
}
export interface NodeResolution {
    /** The single node the name resolved to, if it resolved to exactly one. */
    row?: Record<string, unknown>;
    /** Populated when the name matched several nodes — non-test definitions first. */
    candidates: SymbolCandidate[];
}
/** Candidate lists exist to be read by a human or an agent; a long one is noise. */
export declare const CANDIDATE_CAP = 25;
export declare function toCandidate(row: Record<string, unknown>): SymbolCandidate;
/** Exact path match, else a trailing-fragment match so `user.ts` narrows `/app/user.ts`. */
export declare function matchesFilePath(row: Record<string, unknown>, filePath: string): boolean;
/**
 * Resolve a symbol name (optionally narrowed by file path) to one node. When
 * several nodes still match, nothing is picked: a confident answer about the
 * wrong definition (say, a test mock) is worse than asking which one was meant.
 */
export declare function resolveNodeByName(db: Database.Database, name: string, filePath?: string): NodeResolution;
//# sourceMappingURL=resolve-node.d.ts.map