8de22b9930
Remove 6 componentes não utilizados (dashboard-grid, expenses/income by category widgets, installment analysis panels, fatura-warning-dialog). Remove funções/tipos não utilizados: successResult, generateApiToken, validateApiToken, getTodayUTC/Local, formatDateForDb, getDateInfo, calculatePercentage, roundToDecimals, safeParseInt/Float, isPeriodValid, getLastPeriods, normalizeWhitespace, formatCurrency wrapper, InboxItemInput, InboxBatchInput, ProcessInboxInput, DiscardInboxInput, LancamentosColumnId, 5 funções de anticipation-helpers. Redireciona imports de formatCurrency para lib/lancamentos/formatting-helpers. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
116 lines
3.0 KiB
TypeScript
116 lines
3.0 KiB
TypeScript
import { calculatePercentageChange } from "@/lib/utils/math";
|
|
import { buildPeriodRange, MONTH_NAMES, parsePeriod } from "@/lib/utils/period";
|
|
import type { DateRangeValidation } from "./types";
|
|
|
|
// Re-export for convenience
|
|
export { calculatePercentageChange };
|
|
|
|
/**
|
|
* Formats period string from "YYYY-MM" to "MMM/YYYY" format
|
|
* Example: "2025-01" -> "Jan/2025"
|
|
*
|
|
* @param period - Period in YYYY-MM format
|
|
* @returns Formatted period string
|
|
*/
|
|
export function formatPeriodLabel(period: string): string {
|
|
try {
|
|
const { year, month } = parsePeriod(period);
|
|
const monthName = MONTH_NAMES[month - 1];
|
|
|
|
// Capitalize first letter and take first 3 chars
|
|
const shortMonth =
|
|
monthName.charAt(0).toUpperCase() + monthName.slice(1, 3);
|
|
|
|
return `${shortMonth}/${year}`;
|
|
} catch {
|
|
return period; // Return original if parsing fails
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Generates an array of periods between start and end (inclusive)
|
|
* Alias for buildPeriodRange from period utils
|
|
*
|
|
* @param startPeriod - Start period in YYYY-MM format
|
|
* @param endPeriod - End period in YYYY-MM format
|
|
* @returns Array of period strings in chronological order
|
|
*/
|
|
export function generatePeriodRange(
|
|
startPeriod: string,
|
|
endPeriod: string,
|
|
): string[] {
|
|
return buildPeriodRange(startPeriod, endPeriod);
|
|
}
|
|
|
|
/**
|
|
* Validates that end date is >= start date and period is within limits
|
|
* Maximum allowed period: 24 months
|
|
*
|
|
* @param startPeriod - Start period in YYYY-MM format
|
|
* @param endPeriod - End period in YYYY-MM format
|
|
* @returns Validation result with error message if invalid
|
|
*/
|
|
export function validateDateRange(
|
|
startPeriod: string,
|
|
endPeriod: string,
|
|
): DateRangeValidation {
|
|
try {
|
|
// Parse periods to validate format
|
|
const start = parsePeriod(startPeriod);
|
|
const end = parsePeriod(endPeriod);
|
|
|
|
// Check if end is before start
|
|
if (
|
|
end.year < start.year ||
|
|
(end.year === start.year && end.month < start.month)
|
|
) {
|
|
return {
|
|
isValid: false,
|
|
error: "A data final deve ser maior ou igual à data inicial",
|
|
};
|
|
}
|
|
|
|
// Calculate number of months between periods
|
|
const monthsDiff =
|
|
(end.year - start.year) * 12 + (end.month - start.month) + 1;
|
|
|
|
// Check if period exceeds 24 months
|
|
if (monthsDiff > 24) {
|
|
return {
|
|
isValid: false,
|
|
error: "O período máximo permitido é de 24 meses",
|
|
};
|
|
}
|
|
|
|
return { isValid: true };
|
|
} catch (error) {
|
|
return {
|
|
isValid: false,
|
|
error:
|
|
error instanceof Error
|
|
? error.message
|
|
: "Formato de período inválido. Use YYYY-MM",
|
|
};
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Formats percentage change for display
|
|
* Format: "±X%" or "±X.X%" (one decimal if < 10%)
|
|
*
|
|
* @param change - Percentage change value
|
|
* @returns Formatted percentage string
|
|
*/
|
|
export function formatPercentageChange(change: number | null): string {
|
|
if (change === null) return "-";
|
|
|
|
const absChange = Math.abs(change);
|
|
const sign = change >= 0 ? "+" : "-";
|
|
|
|
// Use one decimal place if less than 10%
|
|
const formatted =
|
|
absChange < 10 ? absChange.toFixed(1) : Math.round(absChange).toString();
|
|
|
|
return `${sign}${formatted}%`;
|
|
}
|