Instalação
Um único pacote, cinco entradas. Instale o core e adicione peers só quando o recurso correspondente for usado.
Migração para @cosmemilton
Use @cosmemilton/report@0.6.0 com @cosmemilton/ui >=4.1.0. Atualize imports, CSS e CmToastProvider juntos, sem misturar os dois pacotes de UI. Para manter UI 3, continue com cosmemilton-report@0.6.0 e cosmemilton-ui@3 e os imports antigos. As versões antigas continuam disponíveis; a URL deste site e os repositórios GitHub não mudam.
1. Instale o pacote
O core não importa dependências em runtime. PDFKit e pdf-lib já vêm no pacote; os demais recursos usam peers opcionais.
npm i @cosmemilton/report2. Peers opcionais
Instale apenas os que o seu uso exige.
Uso só-servidor
Route handlers que só exportam arquivos não precisam de nenhum peer de UI.
Um route handler não precisa de UI
Se o único objetivo é servir /api/relatorios/[slug].pdf ou .xlsx, importe apenas @cosmemilton/report, @cosmemilton/report/pdf (ou /xlsx) e @cosmemilton/report/next. @cosmemilton/ui e @iconify/react só entram quando alguma tela renderiza CmReportPdfPreview, CmReportLayoutEditor ou CmReportDesigner.
Entradas do pacote
Cada import path carrega só o que precisa — o core nunca puxa PDF, XLSX ou UI de arraste.
Provider dos editores
CmReportLayoutEditor, CmReportDesigner e CmReportGlobalConfigEditor precisam de um CmToastProvider ancestral para validações, upload do logotipo e feedback de salvar ou duplicar. O preview isolado dispensa esse provider e mantém seu callback onError.
import { CmToastProvider } from "@cosmemilton/ui/client";
import "@cosmemilton/ui/styles.css";
import "@cosmemilton/report/styles.css";
// No layout, dentro do seu CmThemeProvider:
<CmToastProvider>
{children}
</CmToastProvider>;Próximo passo
Entenda como definição, colunas e formatos se encaixam antes de escrever o primeiro relatório.
Ver conceitosTestar agora
Cole seus próprios dados e veja o PDF, o editor e as exportações funcionando ao vivo.
Abrir playground