render

type CoverPage struct {
	Title    string
	Subtitle string
	Author   string
	Date     string // empty -> today in YYYY-MM-DD
	Logo     string // path or data: URL
}

type ImageEmbedOptions struct {
	Enabled      bool
	Workspace    string        // root dir for resolving relative/file:// paths
	MaxBytes     int64         // per-image cap; 0 uses a sensible default (5 MB)
	AllowedHosts []string      // nil -> any public host (private IPs always rejected)
	Timeout      time.Duration // per-image fetch timeout; 0 uses 5s default
}

type Option func(*Options)

type Options struct {
	// Title is the document title. When empty, the first H1 heading in the
	// markdown is used; if no H1 is found, the title falls back to "Document".
	Title string
	// CustomCSS is appended after the preset CSS and overrides it.
	CustomCSS string
	// Theme selects a registered theme CSS (default: "report").
	Theme string
	// TOC, when true, prepends a table of contents derived from document headings.
	TOC bool
	// CoverPage sets an optional first-page cover.
	CoverPage  *CoverPage
	ImageEmbed ImageEmbedOptions
	Mermaid    bool
	// Directives enables directive-block parsing (:::name{...} ... :::).
	// Default false for zero-risk behavior; callers opt in via WithDirectives.
	Directives bool
	// Width is the target image width in pixels; 0 means use the theme default.
	// Honored by the Typst image pipeline only.
	Width int
	// Height is the target image height in pixels; 0 means use the theme default.
	// Honored by the Typst image pipeline only.
	Height int
	// PPI is the pixels-per-inch density for PNG output. 0 falls back to 144.
	PPI int
}