/** Logger surface required by score guard utilities. */
export interface ScoreGuardLogger {
    warn: (message: string, meta?: Record<string, unknown>) => void;
}
/** Clamps non-finite/out-of-range numbers into the [0, 1] interval. */
export declare function clamp01(value: number): number;
/**
 * Coerces any non-finite/out-of-range score into the valid [0, 1] interval.
 * Alias for clamp01 — kept for backward compatibility and semantic clarity.
 */
export declare const clampScore: typeof clamp01;
/** Normalizes one value into [0, 1] based on the provided range. */
export declare function normalizeRange(value: number, min: number, max: number): number;
/**
 * Enforces score range and emits a warning when a clamp occurs.
 * Use this in engine output normalization before persistence.
 */
export declare function enforceScoreRange(score: number, logger?: ScoreGuardLogger, context?: Record<string, unknown>): number;
//# sourceMappingURL=score-utils.d.ts.map