CSV, XLSX e JSON

O separador padrão é ponto e vírgula (;), não vírgula — porque a vírgula já é o separador decimal em pt-BR. Sem isso, o Excel interpreta cada número como duas colunas.

O arquivo também sai com BOM UTF-8 por padrão: sem ele, acentos e "ç" viram caracteres corrompidos quando o Excel abre o CSV direto (duplo clique) em vez de importar via assistente.

Os três parâmetros são ajustáveis via CsvOptions:

import { exportReportToCsv, type CsvOptions } from "cosmemilton-report";

// Default: delimitador ";", BOM UTF-8 e quebra de linha "\r\n" — abre certo no Excel pt-BR.
const options: CsvOptions = { delimiter: ";", includeBom: true, lineBreak: "\r\n" };
const csv = exportReportToCsv({ definition: relatorioVendas, rows: vendas }, options);

Cada célula sai com o valor bruto (raw) e um numFmt do Excel derivado do format da coluna — datas e moedas ficam editáveis e ordenáveis na planilha, não são só texto formatado.

Grupos viram subtotais por seção e o total geral sai em negrito ao final, junto do cabeçalho com a cor de destaque do relatório.

Roda em Node e no navegador, mas o pacote exceljs é pesado — prefira gerar num route handler:

import { exportReportToXlsx } from "cosmemilton-report/xlsx";

// Recomendado num route handler: mantém o exceljs fora do bundle do cliente.
const buffer = await exportReportToXlsx(
  { definition: relatorioVendas, rows: vendas },
  { sheetName: "Vendas", autoFilter: true, freezeHeader: true },
);