Reportix.Preview 0.1.0-alpha

Reportix

Library .NET untuk menyusun dokumen PDF dari kode C#. Acuannya satu: QuestPDF — fluent API, layout deklaratif, paginasi otomatis, tanpa file template dan tanpa designer.

Status: Fase 6 selesai — roadmap tuntas. Repo ini sempat mengejar parity Crystal Reports sampai Fase 5. Arah itu dibatalkan pada 2026-08-24: band, dataset, formula engine, template JSON, cross-tab, sub-report, barcode, dan bagan sudah dikeluarkan dari solution. Yang tersisa adalah lapis dokumen — dan itulah keseluruhan cakupan proyek sekarang. Fase 2 melengkapi kumpulan elemennya, Fase 3 jalur teksnya, Fase 4 keluaran PDF-nya, dan Fase 5 menambahkan keluaran HTML dan SVG di samping PDF dan PNG, dan Fase 6 menutupnya dengan previewer, diagnostik layout, dan panduan pemakaian. Lihat Roadmap.

Satu lapis API

Dokumen ditulis sebagai kode. Perulangan data adalah foreach biasa milik pemanggil — library tidak mengenal dataset, binding, atau sumber data.

using Reportix;
using Reportix.Layout;
using Reportix.Pdf;
using Reportix.Rendering;
using Reportix.Rendering.Skia;

using var resolver = new SkiaFontResolver();
resolver.RegisterFromFile("fonts/Inter-Regular.ttf");

var settings = new RenderSettings
{
    FontResolver = resolver,
    TextShaper = new HarfBuzzTextShaper(resolver),
};

var document = Document.Create(doc => doc.Page(page =>
{
    page.Size(PageSizes.A4);
    page.Margin(2, Unit.Centimetre);
    page.DefaultTextStyle(TextStyle.Default.WithFontFamily("Inter").WithFontSize(10f));

    page.Header().Text(t => t.FontSize(20f).Bold().Span("Faktur"));

    page.Content().Table(table =>
    {
        table.Columns(columns =>
        {
            columns.RelativeColumn(4f);
            columns.ConstantColumn(90f);
        });

        table.Header(row =>
        {
            row.Cell().Padding(4f).Text(t => t.Bold().Span("Keterangan"));
            row.Cell().Padding(4f).Text(t => t.Bold().AlignRight().Span("Jumlah"));
        });

        foreach (var line in lines)
        {
            table.Row(row =>
            {
                row.Cell().Padding(4f).Text(line.Description);
                row.Cell().Padding(4f).Text(t => t.AlignRight().Span(line.Amount));
            });
        }
    });

    page.Footer().Text(t =>
    {
        t.AlignCenter();
        t.CurrentPageNumber();
        t.Span(" / ");
        t.TotalPages();
    });
}));

using var target = PdfRenderTarget.ToFile("faktur.pdf");
DocumentRenderer.Render(document, target, settings);

dotnet run --project samples/Reportix.Sample.Invoice -- 60 faktur.pdf --png ./preview

Isi Fase 1

Isi Fase 2

page.Content().Column(column =>
{
    column.Item()
        .Background(Colors.Grey100, cornerRadius: 10f)
        .Border(1.5f, Colors.Grey500, cornerRadius: 10f)
        .Padding(10f)
        .Text("Kartu bersudut membulat");

    column.Item().Height(70f).Layers(layers =>
    {
        layers.Layer().AlignMiddle().AlignCenter()
            .Rotate(-20f)
            .Text(t => t.FontSize(22f).FontColor(Colors.Grey300).Span("SALINAN"));

        layers.PrimaryLayer().Padding(10f).Text("Di atas watermark");
    });

    column.Item().Grid(grid =>
    {
        grid.Columns(6);
        grid.Spacing(6f);

        grid.Item(3).Text("separuh");
        grid.Item(3).Text("separuh");
        grid.Item(4).Text("melipat ke baris baru");
    });

    column.Item().Height(90f).Svg(File.ReadAllText("logo.svg"));
});

SVG dibaca menjadi bentuk vektor, bukan dirasterisasi: tepinya tetap tajam pada resolusi cetak berapa pun. Yang didukung adalah subset statis — tanpa teks, gradien, filter, atau use; batasnya tercatat di docs/BACKLOG.md B-019.

Isi Fase 3

Faktur contoh 3 halaman menyusut dari 381 KB menjadi 87 KB — hampir seluruh selisihnya adalah glyph yang tidak pernah dipakai.

page.Content().Text(t =>
{
    t.AlignJustify();
    t.Hyphenate(hyphenator);      // polanya dimuat sendiri, lihat catatan di bawah
    t.Span("Paragraf panjang yang diratakan kiri sekaligus kanan.");
});

page.Content().Text(t =>
{
    t.AlignRight();
    t.TabularNumbers();           // agar kolom angka berjajar lurus
    t.Span("1.234.567");
});

Reportix tidak membawa berkas pola hyphenation. Pola TeX tersebar di berbagai lisensi, sebagian LGPL, yang dilarang aturan proyek ini. Algoritmanya ada dan diuji; polanya Anda muat sendiri:

var hyphenator = Hyphenator.Load(File.ReadAllText("hyph-id.pat"));

Isi Fase 4

var options = new PdfDocumentOptions
{
    Deterministic = true,
    Conformance = PdfConformance.PdfA2b,
    Tagged = true,
    Language = "id-ID",
};

using var target = PdfRenderTarget.ToFile("laporan.pdf", options);
DocumentRenderer.Render(document, target, settings);

page.Content().Column(column =>
{
    column.Item().Bookmark("Ringkasan").Text(t =>
    {
        t.Heading(1);              // struktur, bukan tampilan
        t.FontSize(18f).Bold();    // tampilan dinyatakan sendiri
        t.Span("Ringkasan");
    });

    column.Item().Anchor("rincian").Text("Rincian");
    column.Item().LinkTo("rincian").Text("Lompat ke rincian");
    column.Item().Link("https://example.test").Text("Buka situs");

    column.Item().Alt("Grafik penjualan naik sepanjang tahun")
        .Height(80f)
        .Canvas((canvas, size) => { /* ... */ });
});

Profil warna PDF/A dibangun dari angkanya — primer sRGB yang sudah diadaptasi ke D50 dan fungsi transfer sRGB — bukan disalin dari berkas ICC pihak ketiga, supaya tidak ada lisensi yang menempel pada keluaran Anda.

Belum ada: latar bergradien, subsetting font CFF, dan form field. Menyusul di fase berikutnya.

Isi Fase 5

Dokumen yang sama bisa dikeluarkan sebagai PDF, PNG, HTML, atau SVG — tanpa satu baris pun berubah di sisi penyusun dokumennya.

using var html = HtmlRenderTarget.ToFile("faktur.html");
DocumentRenderer.Render(document, html, settings);

using var svg = new SvgRenderTarget();
DocumentRenderer.Render(document, svg, settings);
svg.SaveTo("./halaman");           // halaman/page-1.svg, page-2.svg, ...

Keduanya menuliskan teks sebagai teks, bukan sebagai kontur: font hasil resolusi disusut lalu ditanam ke dalam berkasnya, sehingga hasilnya bisa diseleksi, dicari mesin pencari, dan dibacakan pembaca layar.

Koordinat HTML dinyatakan dalam piksel CSS, bukan point: clip-path: path() hanya menerima angka tanpa satuan, dan angka itu selalu dibaca sebagai piksel. Karena CSS mendefinisikan 96px = 1in, ukuran cetaknya tetap tepat.

Batasannya dicatat di docs/BACKLOG.md B-026. XPS belum ada — CLAUDE.md §13 menyebutnya "kalau ada permintaan".

Isi Fase 6

using var preview = DocumentPreview.Start(
    () => InvoiceDocument.Create(data),      // factory, bukan instance
    settings,
    new PreviewOptions { Title = "Faktur", Dpi = 110f });

Console.WriteLine(preview.Url);              // http://127.0.0.1:5005/
preview.WaitForShutdown();

dotnet watch run --project samples/Reportix.Sample.Preview

Posisi gulir dan tingkat perbesaran bertahan melewati setiap perubahan, karena yang ditukar hanyalah gambar halamannya — bukan halaman previewer-nya. Kegagalan layout tidak mematikan previewer: pesannya ditampilkan di atas halaman terakhir yang berhasil.

Ketika sebuah elemen tidak akan pernah muat, yang Anda dapat bukan satu baris pesan:

Element does not fit on an empty page and would never fit, so pagination cannot make progress.
  Slot:      Content
  Path:      ColumnElement > Container > Blok alamat (PaddingElement)
  Available: 200 x 150 pt

  ColumnElement                       wrap
  ├─ Container                        wrap
  │  └─ Blok alamat (PaddingElement)  wrap    wants 320 x 250 pt unconstrained  <-- does not fit
  │     └─ Text("alamat pelanggan")   full    80 x 10 pt
  └─ Container                        full    50 x 10 pt

Yang dibentangkan hanya simpul yang ikut gagal; saudara yang muat tetap ditampilkan supaya terlihat mana yang berbeda. Elemen yang sudah tergambar habis di halaman sebelumnya tidak ikut dituding — itu jebakan yang mudah terlewat, karena mengukurnya lagi memang menghasilkan Wrap.

Yang sengaja tidak ada

Reportix bukan report engine. Tidak ada band/section laporan, grouping, running total, sub-report, cross-tab, parameter prompt, drill-down, conditional suppression, template JSON, visual designer, formula engine, atau adapter database.

Aturan penyaringnya sederhana: kalau QuestPDF tidak punya, kemungkinan besar kita juga tidak butuh. Rinciannya di CLAUDE.md §1.

Kode lapis laporan yang dulu ada tetap tersimpan di riwayat git — commit terakhir yang memuatnya adalah 0b60cc2.

Struktur

src/Reportix.Core/            model, satuan, gaya, abstraksi ICanvas
src/Reportix.Layout/          pohon elemen, measure/draw, paginasi
src/Reportix.Rendering/       IRenderTarget, DocumentRenderer
src/Reportix.Rendering.Skia/  SkiaCanvas, font, HarfBuzz, keluaran PNG
src/Reportix.Pdf/             penulis PDF
src/Reportix.Export.Html/     keluaran HTML
src/Reportix.Export.Svg/      keluaran SVG
src/Reportix.Preview/         previewer dan hot reload
src/Shared/Export/            kode bersama kedua eksportir, di-link ke keduanya
tests/                        unit, visual (snapshot PNG), benchmark
samples/                      contoh siap jalan
docs/                         arsitektur, backlog, dependensi

Reportix.Core menargetkan netstandard2.0 dan net8.0, sehingga tetap bisa dipakai dari aplikasi .NET Framework 4.8.

Perintah

dotnet build -c Release
dotnet test                                   # 296 test
dotnet pack -c Release                        # 8 paket .nupkg + .snupkg ke ./artifacts
dotnet test tests/Reportix.VisualTests        # snapshot saja
dotnet format
dotnet run -c Release --project tests/Reportix.Benchmarks

# contoh lengkap: PDF, pratinjau PNG, HTML, dan SVG sekaligus
dotnet run --project samples/Reportix.Sample.Invoice -- \
  60 invoice.pdf --png ./preview --html invoice.html --svg ./svg

# previewer dengan hot reload
dotnet watch run --project samples/Reportix.Sample.Preview

Memperbarui snapshot visual — hanya bila perubahan gambarnya memang disengaja, dan wajib dijelaskan di PR:

REPORTIX_UPDATE_SNAPSHOTS=1 dotnet test tests/Reportix.VisualTests

Roadmap

Dokumentasi

• docs/GUIDE.md — panduan pemakaian, dari dokumen pertama sampai previewer
• CLAUDE.md — panduan kerja dan aturan proyek
• docs/ARCHITECTURE.md — bagaimana Fase 1–6 disusun, dan mengapa
• docs/BACKLOG.md — yang diketahui belum dikerjakan, termasuk angka performa
• docs/THIRD-PARTY.md — dependensi dan lisensinya

Paket

Delapan paket, dipisah supaya Anda hanya menarik apa yang dipakai. Menambahkan Reportix.Pdf sudah cukup untuk membuat PDF — sisanya ikut sebagai dependensi.

Seluruhnya menargetkan netstandard2.0 dan net8.0, sehingga tetap bisa dipakai dari aplikasi .NET Framework 4.8.

Lisensi

MIT. Reportix ditulis dari nol — tidak ada satu baris pun yang disalin dari QuestPDF maupun library berlisensi restriktif — dan seluruh dependensinya berlisensi permisif; rinciannya di docs/THIRD-PARTY.md.

Profil warna sRGB untuk PDF/A dibangun dari angkanya, bukan disalin dari berkas ICC pihak ketiga, supaya tidak ada lisensi yang menempel pada keluaran Anda.