render

type CodeOptions struct {
	LineNumbers bool
	Theme       string
}

type CodeResult struct {
	HTML  template.HTML
	Lang  string
	Lines int
}

type Glossary map[string]GlossaryTerm

type GlossarySource struct {
	Label GlossaryText
	URL   string
}

type GlossaryStrictness string

type GlossaryTerm struct {
	Key     string
	Title   GlossaryText
	Alias   GlossaryText
	Summary GlossaryText
	Page    GlossaryText
	Warning GlossaryText
	Source  *GlossarySource
	// DefinedIn is the repo-relative path of the public glossary file.
	// Private front-matter terms leave it empty.
	DefinedIn string
}

type GlossaryText struct {
	Text string
	HTML template.HTML
}

type Kind int

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

type MarkdownOptions struct {
	TOC              bool
	TOCMinHeadings   int
	Anchors          bool
	Mermaid          bool
	FrontmatterTitle bool

	// Glossary enables term annotations in the browsing-layer HTML.
	Glossary bool
	// GlossaryStrict controls undefined-key handling. An empty value equals
	// GlossaryStrictRefs.
	GlossaryStrict GlossaryStrictness
	// Terms is the build-time public glossary, indexed by normalized key.
	// It is read-only; Render never mutates it. A nil map is an empty library.
	Terms Glossary
	// GlossaryTermLabel is the aria-label format for .term links, with a
	// single %s placeholder for the visible link text. Empty omits the
	// attribute. Site fills this from theme.UIStrings so render stays
	// language-agnostic.
	GlossaryTermLabel string
}

type MarkdownResult struct {
	HTML       template.HTML
	Title      string
	TOC        []TOCItem
	HasMermaid bool
	Meta       map[string]any
	// Terms holds the terms referenced on this page after front-matter
	// overrides, in first-appearance order and de-duplicated by key.
	Terms []GlossaryTerm
	// Warnings holds recoverable issues from this page: front-matter
	// glossary entries (invalid source URL, truncated fields) and
	// undefined term references when GlossaryStrict is off. Public
	// library problems are reported by site.LoadGlossary, not here.
	Warnings []string
}

type PageRef struct {
	Path string

	// Resolve returns "view" for files with a browsing page, "mirror" for
	// files that should link to the raw mirror layer, or "" for unknown paths.
	Resolve func(target string) string
}

type TOCItem struct {
	Title    string
	Anchor   string
	Level    int
	Children []TOCItem
}