/**
 * stderr reporting for superseded references (#108).
 *
 * Read commands call this after writing their own output. Warnings never touch stdout, so
 * piping `ref export`, `ref cite`, or `ref list --output ids` stays byte-identical to the
 * unmarked case. See spec/features/superseded.md.
 */
import type { CslItem } from "../core/csl-json/types.js";
import type { ExecutionContext } from "./execution-context.js";
export interface ReportSupersededOptions {
    /** Suppress all output (config.logLevel === "silent") */
    silent?: boolean;
    /** Extra line written after the per-record warnings, when any were written */
    summary?: (count: number) => string;
}
/**
 * Write one `[SUPERSEDED]` line per superseded reference in `items`.
 *
 * @returns How many references were superseded
 */
export declare function reportSuperseded(items: CslItem[], context: ExecutionContext, options?: ReportSupersededOptions): Promise<number>;
//# sourceMappingURL=superseded-report.d.ts.map