pdf

type BackgroundPDFOptions struct {
	PageSize   PageSize
	TextStyle  TextStyle
	TextBlocks []TextBlock  // If set, used instead of markdown text for precise control
	Logo       *LogoOptions // Optional logo configuration (nil = no logo)
	LogoReader io.Reader    // Logo image reader (used with CreateBackgroundPDF)
	LogoPath   string       // Logo image path (used with CreateBackgroundPDFFile)
}

type LogoOptions struct {
	Position LogoPosition // Anchor position (e.g., "tl", "br", "c")
	OffsetX  float64      // Horizontal offset from anchor in points
	OffsetY  float64      // Vertical offset from anchor in points
	Scale    float64      // Scale factor (0.0-1.0 relative, or absolute if ScaleAbs is true)
	ScaleAbs bool         // If true, Scale represents absolute width in points
	Opacity  float64      // Opacity (0.0-1.0), defaults to 1.0 if zero
}

type LogoPosition string

type Page struct {
	BackgroundReader io.Reader    // Background image reader (nil = white page)
	BackgroundPath   string       // Background image path (file-based alternative)
	Logo             *LogoOptions // Optional logo configuration
	LogoReader       io.Reader    // Logo image reader
	LogoPath         string       // Logo image path
	TextStyle        TextStyle    // Base text style
	TextBlocks       []TextBlock  // Styled text blocks (takes precedence over MarkdownText)
	MarkdownText     string       // Markdown text (used if TextBlocks is empty)
}

type PageSize struct {
	Width  float64
	Height float64
}

type TextAlign string

type TextBlock struct {
	Text      string    // The text to render
	FontName  string    // Override font (empty = inherit from TextStyle)
	FontSize  float64   // Override font size in points (0 = inherit from TextStyle)
	Color     string    // Override color (empty = inherit from TextStyle)
	MarginTop float64   // Additional top margin before this block in points
	Align     TextAlign // Override alignment (empty = inherit from TextStyle)
}

type TextSegment struct {
	Text        string
	IsHeader    bool
	HeaderLevel int  // 1-6 for headers
	IsBold      bool // text was wrapped in **
	IsItalic    bool // text was wrapped in *
}

type TextStyle struct {
	FontName    string    // e.g., "Helvetica", "Courier"
	FontSize    float64   // points
	Color       string    // e.g., "0 0 0" (RGB) or "#000000"
	MarginTop   float64   // points from top
	MarginLeft  float64   // points from left
	MarginRight float64   // points from right (used to calculate line width)
	LineHeight  float64   // multiplier (e.g., 1.5)
	Align       TextAlign // horizontal alignment (default: left)
}