openmonetis/src/features/transactions/formatting-helpers.ts

/**
 * Formatting helpers for displaying lancamento data
 */
import {
	currencyFormatter,
	formatCurrency as formatCurrencyValue,
} from "@/shared/utils/currency";
import { formatDateOnly } from "@/shared/utils/date";
import { formatMonthYearLabel } from "@/shared/utils/period";
import { capitalize } from "@/shared/utils/string";

export { currencyFormatter };

/**
 * Formats a date string to localized format
 * @param value - ISO date string or null
 * @returns Formatted date string or "—"
 * @example formatDate("2024-01-15") => "15/01/2024"
 */
export function formatDate(value?: string | null): string {
	if (!value) return "—";
	return (
		formatDateOnly(value, {
			day: "2-digit",
			month: "2-digit",
			year: "numeric",
		}) ?? "—"
	);
}

/**
 * Formats a period (YYYY-MM) to localized month label
 * @param value - Period string (YYYY-MM) or null
 * @returns Formatted period string or "—"
 * @example formatPeriod("2024-01") => "Janeiro 2024"
 */
export function formatPeriod(value?: string | null): string {
	if (!value) return "—";
	try {
		return formatMonthYearLabel(value);
	} catch {
		return value;
	}
}

/**
 * Formats a condition string with proper capitalization
 * @param value - Condition string or null
 * @returns Formatted condition string or "—"
 * @example formatCondition("vista") => "À vista"
 */
export function formatCondition(value?: string | null): string {
	if (!value) return "—";
	if (value.toLowerCase() === "vista") return "À vista";
	return capitalize(value);
}

/**
 * Formats currency value
 * @param value - Numeric value
 * @returns Formatted currency string
 * @example formatCurrency(1234.56) => "R$ 1.234,56"
 */
export function formatCurrency(value: number): string {
	return formatCurrencyValue(value);
}