JetsonPDF.Flow 0.2.0-preview

JetsonPDF.Flow

A Word-like, retained-mode document model that renders to PDF via JetsonPDF.

If JetsonPDF.Fluent is QuestPDF's idiom (immediate-mode, build-then-render container chain), JetsonPDF.Flow is the other end of the spectrum: a mutable POCO tree of FlowDocument → Section → Paragraph → Run, plus tables, images, and explicit page breaks. Edit the tree in place, then Save.

using JetsonPDF.Flow;
using JetsonPDF.Flow.Blocks;
using JetsonPDF.Flow.Runs;

var doc = new FlowDocument();
var section = doc.Sections.Add();
section.PageSize = JetsonPDF.PageSize.Letter;
section.Margins = new Margins(72, 72, 72, 72);

section.Blocks.Add(new Paragraph
{
    Style = ParagraphStyle.Heading1,
    Runs = { new TextRun("Quarterly Report") },
});

var body = new Paragraph();
body.Runs.Add(new TextRun("Revenue grew "));
body.Runs.Add(new TextRun("12.4%") { Properties = { Bold = true } });
body.Runs.Add(new TextRun(" year-over-year."));
section.Blocks.Add(body);

doc.Save("report.pdf");

Save overloads: Save(string path), Save(Stream), and a parameterless byte[] Save() for in-memory serialization.

What you get

• Auto-pagination at paragraph, line, and table-row boundaries.
• KeepWithNext, KeepLinesTogether, PageBreakBefore for fine-grained pagination control.
• Sections with their own page size, margins, and headers / footers.
• Tables with column widths, header rows, and cell-level paragraphs.
• Lists — bullet, decimal, lowercase / uppercase alpha, lowercase / uppercase Roman — via ListMarker on a paragraph.
• Drop caps, tab stops, named styles + StylePresets for consistent typography.
• Anchored images with text wrapping.
• Headers and footers per section, with page-number / total-pages placeholders.
• Hyphenation via the included Liang-style dictionary.

When to pick Flow over Fluent

• You want a document tree you can edit, serialize, or generate from a template — Flow is a data structure first, render target second.
• Your input shape is closer to "paragraphs of runs" than to "rows of cells in a layout grid".
• You need Word-style flow features (KeepWithNext, drop caps, anchored images with wrap) without writing pagination logic yourself.

For invoices, dashboards, and forms that are layout-driven, prefer JetsonPDF.Fluent.

Targets

• net8.0

License

MIT.