teqo/src/lib/campaignHomeSummaryDelta.ts
Cursor Agent af6c180211
B57 — delta 7 dias do total estimado no Início
- Collection campaignVoteSummarySnapshot (snapshot diário statewide)
- Gravação idempotente on-read no loadCampaignHomeSummary + retenção 30d
- UI: seta + magnitude ao lado do total B56 (aria-label completo)
- Reusa rollup statewide para CG/candidato; assessor vê Δ global (opção A)

Co-authored-by: Francisco Solla <fsolla@users.noreply.github.com>
2026-08-01 06:33:39 +00:00

33 lines
1.3 KiB
TypeScript

import { formatElectionNumber } from '@/lib/electionFormat'
/** B57 — client-safe contract for the Início hero delta (window + copy). */
export const HOME_SUMMARY_DELTA_WINDOW_DAYS = 7
export const homeSummaryDeltaPeriodLabel = `nos últimos ${HOME_SUMMARY_DELTA_WINDOW_DAYS} dias`
export type HomeSummaryDeltaDirection = 'up' | 'down' | 'flat' | 'unavailable'
export const resolveHomeSummaryDeltaDirection = (
delta: number | null,
): HomeSummaryDeltaDirection => {
if (delta === null) return 'unavailable'
if (delta === 0) return 'flat'
return delta > 0 ? 'up' : 'down'
}
/** Absolute magnitude for display; null when unavailable; "0" when flat. */
export const formatHomeSummaryDeltaMagnitude = (delta: number | null): string | null => {
if (delta === null) return null
if (delta === 0) return formatElectionNumber(0)
return formatElectionNumber(Math.abs(delta))
}
export const homeSummaryDeltaAriaLabel = (delta: number | null): string => {
const period = homeSummaryDeltaPeriodLabel
if (delta === null) return `Variação ${period} indisponível`
if (delta === 0) return `Sem variação ${period}`
const formatted = formatElectionNumber(Math.abs(delta))
return delta > 0
? `Aumento de ${formatted} votos ${period}`
: `Queda de ${formatted} votos ${period}`
}