import type { NormalizedProgressSettings } from "./progress-options.js";
/**
 * Aggregated metrics used when formatting the final lint summary.
 */
export interface LintSummaryStats {
    readonly durationMs: number;
    readonly exitCode: number;
    readonly filesLinted: number;
}
/**
 * Converts an absolute lint target path into a repository-relative display
 * path.
 *
 * @param filename - Raw filename reported by ESLint.
 * @param cwd - Working directory used for relative path resolution.
 *
 * @returns A path suitable for terminal display.
 */
export declare const toRelativeFilePath: (filename: string, cwd: string) => string;
/**
 * Formats a per-file live progress line for interactive CLI output.
 *
 * @param relativeFilePath - Relative file path being linted.
 * @param settings - Effective progress settings.
 *
 * @returns Rendered progress line.
 */
export declare const formatFileProgress: (relativeFilePath: string, settings: NormalizedProgressSettings) => string;
/**
 * Formats a generic live progress line when file names are hidden.
 *
 * @param settings - Effective progress settings.
 *
 * @returns Rendered progress line.
 */
export declare const formatGenericProgress: (settings: NormalizedProgressSettings) => string;
/**
 * Formats a duration in milliseconds for summary output.
 *
 * @param durationMs - Elapsed duration in milliseconds.
 *
 * @returns Human-readable duration string.
 */
export declare const formatDuration: (durationMs: number) => string;
/**
 * Formats the effective lint throughput for summary output.
 *
 * @param durationMs - Elapsed duration in milliseconds.
 * @param filesLinted - Number of linted files.
 *
 * @returns Human-readable throughput string.
 */
export declare const formatThroughput: (durationMs: number, filesLinted: number) => string;
/**
 * Formats the final success summary message.
 *
 * @param settings - Effective progress settings.
 * @param stats - Final lint summary metrics.
 *
 * @returns Rendered success summary.
 */
export declare const formatSuccessMessage: (settings: NormalizedProgressSettings, stats: LintSummaryStats) => string;
/**
 * Formats the final failure summary message.
 *
 * @param settings - Effective progress settings.
 * @param stats - Final lint summary metrics.
 *
 * @returns Rendered failure summary.
 */
export declare const formatFailureMessage: (settings: NormalizedProgressSettings, stats: LintSummaryStats) => string;
//# sourceMappingURL=progress-formatting.d.ts.map