layout

type Align int

type Block struct {
	Kind Kind
	// Level 是标题级别 1-6。
	Level int
	// Marker 是列表标记，如 "•" 或 "1."。
	Marker string
	// Indent 是缩进层级，用于列表和引用。
	Indent int
	// Inlines 是行内内容。
	Inlines []Inline
	// Code 是代码块纯文本。
	Code string
	// Image 是块级图片。
	Image *Image
	// Table 是表格。
	Table *Table
}

type Cell []Inline

type Colophon struct {
	// Cc 是抄送机关，如 "省委办公厅，省政府办公厅。"。
	Cc string
	// IssuedBy 是印发机关，如 "××省档案局办公室"。
	IssuedBy string
	// IssuedDate 是印发日期，如 "2026年9月19日"。
	IssuedDate string
	// Size 是版记字号（磅）；0 时使用默认值 14，对应四号。
	Size float64
}

type Document struct {
	// Title 是文档标题。
	Title string
	// Letterhead 是首页红色版头；为空则不渲染。设置后按 GB/T 9704-2012 编排。
	Letterhead *Letterhead
	// Sign 是落款（署名与成文日期）；为空则不渲染。
	Sign *Signature
	// Footer 是页脚页码；为空则不渲染。
	Footer *Footer
	// Colophon 是末页版记；为空则不渲染。
	Colophon *Colophon
	// Blocks 是按顺序排列的块级元素。
	Blocks []Block
}

type Footer struct {
	// PageNumber 指示是否在每页版心下边缘之下渲染页码。
	PageNumber bool
	// Size 是页码字号（磅）；0 时使用默认值 14，对应四号。
	Size float64
}

type Image struct {
	// Source 是原始地址，用于诊断信息。
	Source string
	// Alt 是替代文本。
	Alt string
	// Data 是图片二进制数据。
	Data []byte
	// Format 是图片格式，如 PNG、JPEG。
	Format string
	// PixelWidth 和 PixelHeight 是图片像素尺寸。
	PixelWidth  int
	PixelHeight int
}

type Inline struct {
	Text   string
	Bold   bool
	Italic bool
	Code   bool
	Strike bool
	Link   bool
}

type Kind int

type Letterhead struct {
	// Org 是发文机关标志，如 "××省档案局文件"。
	Org string
	// DocNo 是发文字号，如 "×档发〔2026〕1号"。
	DocNo string
	// Signatory 是签发人姓名；非空时发文字号左移、签发人右移（上行文版式）。
	Signatory string
	// SerialNo 是份号，如 "000001"；非空时在版心左上角第一行显示。
	SerialNo string
	// Security 是密级和保密期限，如 "绝密★5年"；非空时在份号下方显示。
	Security string
	// Urgency 是紧急程度，如 "特急"；非空时在密级下方显示。
	Urgency string
	// Height 是版头区最小高度（毫米），仅当内容较短时用于撑高版头区；0 忽略。
	Height float64
	// OrgSize 是机关标志字号（磅）；0 时使用默认值 56。
	OrgSize float64
	// DocNoSize 是发文字号、签发人与涉密标记字号（磅）；0 时使用默认值 16，对应三号。
	DocNoSize float64
}

type Options struct {
	// PageWidth 和 PageHeight 是页面物理尺寸。
	PageWidth  float64
	PageHeight float64
	// MarginTop、MarginRight、MarginBottom、MarginLeft 是页边距。
	MarginTop    float64
	MarginRight  float64
	MarginBottom float64
	MarginLeft   float64
	// BodySize 是正文字号，MonoSize 是代码字号。
	BodySize float64
	MonoSize float64
	// LineHeight 是行高倍率。
	LineHeight float64
	// CodeLineHeight 是代码块的行高倍率；小于 LineHeight 可以让代码更紧凑。
	CodeLineHeight float64
	// BlockSpacing 是块间距，单位为正文行高的倍率。
	BlockSpacing float64
	// BodyFamily 和 MonoFamily 是逻辑字体族名。
	BodyFamily string
	MonoFamily string
	// HeiFamily、KaiFamily、TitleFamily、SongFamily 是公文版式专用字族名，
	// 分别对应黑体、楷体、小标宋（文件标题/发文机关标志）与宋体（页码）；
	// 为空时回退到 BodyFamily。
	HeiFamily   string
	KaiFamily   string
	TitleFamily string
	SongFamily  string
}

type Signature struct {
	// Org 是发文机关署名。
	Org string
	// Date 是成文日期，如 "2026年9月19日"。
	Date string
	// Size 是落款字号（磅）；0 时使用默认值 16，对应三号。
	Size float64
}

type Table struct {
	Header []Cell
	Rows   [][]Cell
	Align  []Align
	// Landscape 强制横排表格；为空时按列宽是否超出版心自动判定。
	Landscape bool
}