Page height

Pass pageHeight to sone(...) and Sone will slice the same node tree into as many pages as needed:

const buffer = await sone(content, {
  pageHeight: 1056,    // Letter height @ 96 dpi
}).pdf();

That's it. There is no special "page" node. Your content is laid out continuously, and the painter slices it into page-sized rects.

Common page heights

Pair with width to set the page width. Without width, the canvas auto-sizes to content width.

await sone(content, { width: 816, pageHeight: 1056 }).pdf();

Margins

await sone(content, {
  pageHeight: 1056,
  margin: 48,
}).pdf();

Margin accepts:

• A single number — applied to all sides.
• { top, right, bottom, left } — per-side overrides.

margin: { top: 64, right: 48, bottom: 64, left: 48 }

Last page behavior

By default, every page is pageHeight tall, even if the last page only has a few lines. Set lastPageHeight: "content" to trim the last page to its actual content:

await sone(content, {
  pageHeight: 1056,
  lastPageHeight: "content",   // trim trailing whitespace from last page
}).pdf();

Multi-page output formats

Multi-page works for .pdf(), .pages() (returns one Canvas per page), and you can render each page individually:

const pages = await sone(content, { pageHeight: 1056 }).pages();
// pages: Canvas[]

Use .pages() when you need each page as an image (e.g., generating thumbnails).