/**
 * WARP Symbol Timeline — ordered history of a symbol across commits.
 *
 * Reads WARP provenance for symbol ids and reconstructs versions from
 * patches that touched the symbol. Callers that need removed-symbol
 * history must pass filePath so the symbol id is explicit.
 */
import { type WarpContext } from "./context.js";
/** A single version of a symbol at a specific commit. */
export interface SymbolVersion {
    readonly sha: string;
    readonly tick: number;
    readonly changeKind: "added" | "changed" | "removed";
    readonly present: boolean;
    readonly signature?: string | undefined;
    readonly startLine?: number | undefined;
    readonly endLine?: number | undefined;
    readonly filePath: string;
}
/** Full ordered timeline for a symbol across commits. */
export interface SymbolTimelineResult {
    readonly symbol: string;
    readonly filePath?: string | undefined;
    readonly versions: readonly SymbolVersion[];
}
/**
 * Build an ordered timeline of every version of a symbol across commits.
 *
 * For each commit that touched the symbol (adds, changes, removes), the
 * returned array includes the commit SHA, tick, change kind, presence
 * flag, signature, and line range. Entries are sorted by tick ascending.
 */
export declare function symbolTimeline(ctx: WarpContext, symbolName: string, filePath?: string): Promise<SymbolTimelineResult>;
//# sourceMappingURL=symbol-timeline.d.ts.map