import type { ParsedDocument } from "./types/metadata.js";
export declare const TOKEN_BUDGET_SECTION_CANDIDATE_LIMIT = 3;
export interface TokenBudgetOverage {
    overBy: number;
    overPercent: number;
}
export interface TokenBudgetSectionCandidate {
    heading: string;
    line: number;
    estimatedTokens: number;
    sharePercent: number;
}
/** Derive stable non-negative overage facts for an exceeded advisory limit. */
export declare function tokenBudgetOverage(measured: number, limit: number): TokenBudgetOverage;
/**
 * Rank a small set of heading-backed review candidates without treating
 * nested headings as independent candidates inside an already measured parent.
 */
export declare function tokenBudgetSectionCandidates(document: ParsedDocument): TokenBudgetSectionCandidate[];
/** Render deterministic section evidence for existing remediation fields. */
export declare function formatTokenBudgetSectionReview(candidates: TokenBudgetSectionCandidate[]): string;