render

type Action struct {
	// Instructions is the descriptive text displayed above the action button or invite code
	Instructions string
	// Button holds the CTA button details
	Button Button
	// InviteCode is an invite or authentication code displayed instead of a button
	InviteCode string
	// Style is per-Action style overrides
	Style Style
}

type Button struct {
	// Text is the button label
	Text string
	// Link is the URL the button navigates to
	Link string
	// Color is the hex background color; convenience override of Style.ButtonColor
	Color string
	// TextColor is the hex label color; convenience override of Style.ButtonTextColor
	TextColor string
	// Style is per-Button style overrides
	Style Style
}

type Callout struct {
	// Title is the heading displayed above the list items
	Title string
	// Items is the list of entries rendered without escaping; use render.Link / render.Bold for inline formatting
	Items []template.HTML
	// Ordered renders a numbered list when true; unordered (bulleted) when false
	Ordered bool
	// Style is per-Callout style overrides
	Style Style
}

type Cell struct {
	// Key is the column or property name
	Key string
	// Value is the text value, HTML-escaped during rendering
	Value string
	// UnsafeValue is a raw HTML value used when Value is empty
	UnsafeValue template.HTML
}

type ContentBody struct {
	// Preheader is hidden text shown as the email preview in email clients
	Preheader string
	// Header is the top header row rendered by modern themes
	Header HeaderBlock
	// Icon is an image displayed between the logo and content area
	Icon *ContentIcon
	// Name is the recipient name used in the greeting line
	Name string
	// Greeting is the greeting text preceding the recipient name
	Greeting string
	// Title overrides the greeting and name when set, used as the full heading line
	Title string
	// Intros is the introductory block rendered before the main content
	Intros IntrosBlock
	// ContentBlocks are standalone raw HTML blocks rendered after intros and before structured content
	ContentBlocks []template.HTML
	// Callout is a visually distinct block for bulleted or numbered lists with an optional heading
	Callout *Callout
	// Dictionary is a block of key-value pairs rendered as a definition list
	Dictionary Dictionary
	// Tables contains data tables rendered in the body
	Tables []DataTable
	// Actions contains call-to-action buttons and invite codes
	Actions []Action
	// Outros is the closing block rendered after the main content
	Outros OutrosBlock
	// Signature is the sign-off text (e.g. "Best regards")
	Signature string
	// SignatureName is the name appended under the signature line
	SignatureName string
	// FreeMarkdown is a markdown block that replaces all structured body content when set
	FreeMarkdown MarkdownContent
	// BodyWidth overrides the email body width (e.g. "600px")
	BodyWidth string
	// AdditionalCSS is raw CSS appended to the theme styles
	AdditionalCSS string
	// Style is per-Body style overrides
	Style Style
}

type ContentIcon struct {
	// Src is the URL of the icon image
	Src string
	// Alt is the alt text for the icon image
	Alt string
}

type DataTable struct {
	// Title is the heading displayed above the table
	Title string
	// TitleUnsafe is a raw HTML title that overrides Title when non-empty
	TitleUnsafe template.HTML
	// Data is a 2D array of cells representing the table rows and columns
	Data [][]Cell
	// Columns holds column width and alignment configuration
	Columns TableColumns
	// Class is the CSS class applied to the table wrapper element
	Class string
	// Footer is the text displayed below the table
	Footer string
	// FooterUnsafe is a raw HTML footer that overrides Footer when non-empty
	FooterUnsafe template.HTML
	// Style is per-DataTable style overrides
	Style Style
}

type Dictionary struct {
	// Cells is the list of key-value entries
	Cells []Cell
	// Style is per-Dictionary style overrides
	Style Style
}

type EmailContent struct {
	// Request is the operation input value, typed at the dispatch site
	// Templates reach its fields via reflection (e.g. .Request.FirstName, .Request.CampaignID)
	Request any
	// Config is the per-send config supplied by the dispatcher
	Config any
	// Body is the per-send structured body content
	Body ContentBody
}

type HeaderBlock struct {
	// Logo overrides Config.LogoURL in the compact header slot; nil falls back to Config.LogoURL
	Logo *ContentIcon
	// Style is per-HeaderBlock style overrides
	Style Style
}

type IntrosBlock struct {
	// Paragraphs is the list of plain-text paragraphs rendered in order
	Paragraphs []string
	// Markdown is a markdown intro block convertible to HTML via goldmark
	Markdown MarkdownContent
	// Unsafe contains raw HTML intro blocks trusted by the template author
	Unsafe []template.HTML
	// Style is per-Intros style overrides
	Style Style
}

type MarkdownContent template.HTML

type OutrosBlock struct {
	// Paragraphs is the list of plain-text paragraphs rendered in order
	Paragraphs []string
	// Markdown is a markdown outro block convertible to HTML via goldmark
	Markdown MarkdownContent
	// Unsafe contains raw HTML outro blocks trusted by the template author
	Unsafe []template.HTML
	// Style is per-Outros style overrides
	Style Style
}

type Renderer struct {
	// contains filtered or unexported fields
}

type RendererOption func(*Renderer)

type Style struct {
	// PrimaryColor is the headline/emphasis color
	PrimaryColor string
	// SecondaryColor is the secondary accent color
	SecondaryColor string
	// BackgroundColor is the outer page background color
	BackgroundColor string
	// TextColor is the body text color
	TextColor string
	// ButtonColor is the call-to-action button background color
	ButtonColor string
	// ButtonTextColor is the call-to-action button text color
	ButtonTextColor string
	// LinkColor is the anchor link color
	LinkColor string
	// FontFamily is the CSS font-family stack
	FontFamily string
}

type TableColumns struct {
	// CustomWidth maps column keys to width values (e.g. "Price": "15%")
	CustomWidth map[string]string
	// CustomAlignment maps column keys to alignment values (e.g. "Price": "right")
	CustomAlignment map[string]string
}

type Theme struct {
	// Name is the human-readable identifier for the theme
	Name string
	// HTML is the raw Go html/template string for the theme
	HTML string
	// Text is the raw Go text/template string for the theme
	Text string
}