CSV, XLSX e JSON
A mesma definição de relatório vira planilha, texto ou dado estruturado. Todos os formatos partem do mesmo ReportDataset — o que muda é só o serializador final.
Exportar no navegador
useReportExport sem endpoint: CSV e JSON saem do core zero-dep; XLSX importa o módulo @cosmemilton/report/xlsx sob demanda, só quando o botão é clicado.
Os 36 registros de vendas são serializados inteiramente no navegador — nada é enviado a um servidor.
CSV pt-BR
Pensado para abrir direto no Excel em português.
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.
As opções 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", escapeFormulas: true,
};
const csv = exportReportToCsv({ definition: relatorioVendas, rows: vendas }, options);CSV e TSV protegem textos e cabeçalhos que começam com =, +, - ou @, inclusive após espaços, adicionando um apóstrofo. Números, incluindo negativos, continuam numéricos. A proteção também vale para copyToClipboard.
escapeFormulas: false desativa a proteção para integrações que precisam do texto literal; use apenas quando o consumidor controla a interpretação desses dados.
XLSX
Planilha real, não CSV com extensão trocada.
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 },
);Os 7 formatos de coluna
format da coluna decide como formatValue converte o valor bruto em texto — usado por PDF, CSV, XLSX e pela pré-visualização do editor.
Casos especiais, fora da tabela: null/undefined sempre viram string vazia, e boolean sempre vira "Sim"/"Não" — não importa o format pedido pela coluna.