import type { DashboardPeriod } from '../types';
/**
 * Dirección deseable del cambio de un indicador.
 *
 * <b>No todo aumento es una buena noticia.</b> Hasta ahora el KPI pintaba en verde
 * cualquier subida y en rojo cualquier bajada, con un `tendencia >= 0` cableado. En
 * "Pedidos pendientes" eso significa que una caída del 50 % —que es exactamente lo
 * que se quiere— se veía en rojo, como una alarma.
 *
 * La declara el widget en `config_schema.direction`, no el endpoint: es presentación,
 * y así un administrador puede corregirla desde el Widget Builder sin tocar backend.
 */
export type IndicatorDirection = 'higher-is-better' | 'lower-is-better' | 'neutral';
/** Cómo se pinta un delta: color semántico y sentido del icono. */
export interface DeltaTone {
    /** Token de color a aplicar. */
    color: string;
    /** Si la flecha apunta hacia arriba. Independiente del color: el icono muestra el HECHO. */
    isUp: boolean;
}
/**
 * El tono de un delta, dado su valor y la dirección deseable del indicador.
 *
 * El icono siempre refleja **lo que pasó** (subió o bajó) y el color **si eso es
 * bueno**. Separarlos es lo que permite decir "bajó, y está bien" — que es
 * justamente lo que un `lower-is-better` necesita comunicar.
 */
export declare function deltaTone(value: number, direction?: IndicatorDirection): DeltaTone;
/**
 * La clave i18n de la referencia temporal del delta.
 *
 * <b>Se deriva del periodo activo, nunca se escribe a mano.</b> Un "↘ 50 %" sin
 * decir contra qué es ilegible: el usuario no sabe si compara con ayer, con la
 * semana pasada o con el año.
 */
export declare function deltaReferenceKey(period: DashboardPeriod | string | undefined): string | null;
//# sourceMappingURL=kpiDelta.d.ts.map