Custom Sections

Custom sections let you build freeform content from element primitives. Each custom section has a key for identification.

custom("terms-and-conditions") {
    text("Terms & Conditions", styleRef = "bold")
    divider()
    text("Payment is due within 30 days of the invoice date.")
    spacer()
    row(1f, 1f) {
        text("Questions? Contact billing@acme.com")
        text("Ref: T&C v2.1 (2026)")
    }
    spacer(8)
    link("View full terms", "https://acme.com/terms")
}

Element Types

Text

text("Hello, world!")
text("Bold heading", styleRef = "bold")

Divider

divider()  // Horizontal line

Spacer

spacer()       // Default 16px spacing
spacer(8)      // Custom height

Row (columns)

row(1f, 1f) {       // Two equal columns
    text("Left")
    text("Right")
}
row(2f, 1f) {       // 2:1 ratio columns
    text("Wider column")
    text("Narrow")
}

Link

link("View terms", "https://example.com/terms")

Image

image(pngBytes, "image/png", width = 200, height = 100)

Builder Reference

CustomBuilder

Method	Description
text(value, styleRef?)	Text element with optional style reference
divider()	Horizontal divider line
spacer(height = 16)	Vertical whitespace
row(vararg weights) { }	Horizontal layout with column weights
link(text, href)	Hyperlink
image(data, contentType, width?, height?)	Inline image from bytes
image(source, width?, height?)	Inline image from ImageSource