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
	// CodeLang 是围栏代码块的语言标记（“` 后的标识符），为空表示无语言。
	CodeLang 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 FlowBlock struct {
	ID              string
	Kind            string
	Text            string
	Runs            []Inline
	Level           int
	Marker          string
	Style           *TextStyle
	KeepWithNext    bool
	KeepTogether    bool
	PageBreakBefore bool
	PageBreakAfter  bool
	Orphans         int
	Widows          int
	Image           *FlowImage
	Table           *FlowTable
	Fixed           *FlowFixed
	TOC             *FlowTOC
	Section         *FlowSection
	// contains filtered or unexported fields
}

type FlowCellBorders struct{ Top, Right, Bottom, Left *FlowTableBorder }

type FlowCellStyle struct {
	Fill          *creator.Color
	Padding       *FlowMargins
	VerticalAlign string
	Borders       *FlowCellBorders
}

type FlowColumns struct {
	Count int
	Gap   float64
	// Balance 启用节末页栏高平衡，含显式换栏的末页保持原布局。
	Balance bool
}

type FlowFixed struct {
	Width, Height float64
	Align         string
	Items         []creator.Item
	Caption       string
	Numbered      bool
	CaptionPrefix string
}

type FlowFontFamily struct{ Regular, Bold, Italic, BoldItalic string }

type FlowFootnote struct {
	ID, Text string
	Runs     []Inline
	Style    *TextStyle
}

type FlowImage struct {
	Data          []byte
	Width         float64
	Height        float64
	Caption       string
	Numbered      bool
	CaptionPrefix string
}

type FlowMargins struct{ Top, Right, Bottom, Left float64 }

type FlowNamedStyle struct {
	Name  string
	Style TextStyle
}

type FlowOfficial struct {
	Fonts      FlowOfficialFonts
	Letterhead *FlowOfficialLetterhead
	Signature  *FlowOfficialSignature
	Colophon   *FlowOfficialColophon
}

type FlowOfficialColophon struct{ Cc, IssuedBy, IssuedDate string }

type FlowOfficialFonts struct{ Body, Title, Hei, Kai, Song string }

type FlowOfficialLetterhead struct {
	Org, DocNo, Signatory, SerialNo, Security, Urgency string
	OrgSize                                            float64
}

type FlowOfficialSignature struct{ Org, Date string }

type FlowOptions struct {
	PageSize         creator.PageSize
	MarginTop        float64
	MarginRight      float64
	MarginBottom     float64
	MarginLeft       float64
	Theme            Theme
	Official         *FlowOfficial
	Columns          FlowColumns
	Styles           []FlowNamedStyle
	Footnotes        []FlowFootnote
	FootnoteStyle    *TextStyle
	Fonts            []creator.Font
	FontFaces        map[string]int
	FontFamilies     []FlowFontFamily
	FallbackFonts    []string
	BoldFont         string
	ItalicFont       string
	BoldItalicFont   string
	PageNumbers      bool
	Header           string
	Footer           string
	GenerateOutlines bool

	ReferencePageNumbers string
	// contains filtered or unexported fields
}

type FlowSection struct {
	PageSize            *creator.PageSize
	Margins             *FlowMargins
	Columns             *FlowColumns
	Header              *string
	Footer              *string
	PageNumbers         *bool
	StartPageNumber     *int
	PageNumberStyle     string
	PageNumberPrefix    *string
	FirstPageHeader     *string
	FirstPageFooter     *string
	HideFirstPageNumber bool
}

type FlowTOC struct {
	Title    string
	MaxLevel int
	Source   string
}

type FlowTable struct {
	// SplitRows 按完整文字行续排普通及 ColSpan 单元格，正文 RowSpan 不支持。
	SplitRows    bool
	Header       []string
	Rows         [][]string
	ColumnWidths []float64
	// Grid 与 Header/Rows 互斥，合并单元格占据的位置无需额外占位。
	Grid               [][]FlowTableCell
	HeaderRows         int
	Columns            []FlowTableColumn
	CellStyle          *FlowCellStyle
	StripeFill         *creator.Color
	Caption            string
	Numbered           bool
	CaptionPrefix      string
	RepeatCaption      bool
	ContinuationSuffix string
}

type FlowTableBorder struct {
	Width float64
	Color *creator.Color
}

type FlowTableCell struct {
	Text       string
	Runs       []Inline
	ColSpan    int
	RowSpan    int
	Style      *TextStyle
	Appearance *FlowCellStyle
}

type FlowTableColumn struct {
	Width, MinWidth, MaxWidth, Weight float64
	NoWrap                            bool
	Align                             string
}

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
	// Font 是流式创作时显式选择的字体资源名，空值继承段落样式。
	Font   string
	Bold   bool
	Italic bool
	Code   bool
	Strike bool
	// Link 为真时按链接着色。
	Link bool
	// Href 是点击目标，落到图元的 CLICK 动作上。为空时只是着色、不可点击——
	// Markdown 的空目标链接（如 `[文字]()`）属于这种，着色仍要保留。
	Href string
	// Target 是文内内容 ID；PageRef 按配置填入最终物理页码或节内页码。
	Target  string
	PageRef string
	// CaptionRef 显示编号图表的标签并跳转至内容起点。
	CaptionRef string
	// TitleRef 显示目标章节标题或完整图表题注。
	TitleRef string
	// Footnote 指向页底注释定义，显示独立编号标记。
	Footnote string
}

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
	// CodePaddingX 和 CodePaddingY 是代码面板内边距，文字与面板边缘的留白。
	CodePaddingX float64
	CodePaddingY float64
	// CodeRadius 是代码面板圆角半径（毫米）；不超过面板短边的一半。
	CodeRadius float64
	// CodeLabelSize 是语言标签字号（磅）；0 时不绘制语言标签。
	CodeLabelSize float64
	// CodeLabelGap 是语言标签与首行代码之间的间距（毫米）。
	CodeLabelGap float64
	// InlineCodePaddingX 和 InlineCodePaddingY 是行内代码底色的内边距。
	InlineCodePaddingX float64
	InlineCodePaddingY 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
}

type TextStyle struct {
	BasedOn         string
	Set             uint32
	Font            string
	Size            float64
	LineHeight      float64
	SpaceBefore     float64
	SpaceAfter      float64
	FirstLineIndent float64
	Align           string
	Color           *creator.Color
}

type Theme struct {
	Body        TextStyle
	Headings    [6]TextStyle
	Caption     TextStyle
	Table       TextStyle
	BorderColor *creator.Color
	HeaderFill  *creator.Color
}