output

type ChapterContent struct {
	// Title is the chapter title.
	Title string
	// ID is the unique chapter identifier.
	ID string
	// HTML is the chapter HTML without the outer document shell.
	HTML string
	// Filename is the suggested output filename, for example "ch_001.xhtml".
	Filename string
}

type DocumentMeta struct {
	Title    string
	Author   string
	Language string
	Version  string
}

type EpubChapter struct {
	Title     string
	ID        string
	Filename  string
	HTML      string // XHTML body content.
	SourceDir string // Source directory used to resolve relative asset paths.
	// Depth is the chapter's nesting level (0 = top level). Reading systems
	// render the navigation document as a tree, so a book using `sections:`
	// needs this to keep its hierarchy instead of showing one flat list.
	Depth int
}

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

type EpubMeta struct {
	Title          string
	Subtitle       string
	Author         string
	Language       string
	Version        string
	Description    string
	IncludeCover   bool
	CoverImagePath string
	// CoverBackground is the configured cover background color (may be empty).
	CoverBackground string
	// Publishing metadata. Reading systems and library software index these:
	// without them a book shows up with no publisher, no publication date and
	// no subjects in every catalog it lands in.
	Publisher string
	ISBN      string
	// Date is the publication date, ideally ISO 8601 (YYYY or YYYY-MM-DD).
	Date     string
	Rights   string
	Subjects []string
}

type HTMLGenerator struct{}

type OutputFormat interface {
	// Name returns the format name, for example "pdf", "html", "epub", or "site".
	Name() string

	// Generate writes output using the provided render request.
	Generate(ctx context.Context, req *RenderRequest, outputPath string) error

	// Description returns a short human-readable description.
	Description() string
}

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

type RenderRequest struct {
	// FullHTML is the assembled full HTML document for PDF and standalone HTML output.
	FullHTML string

	// Chapters contains per-chapter content for ePub and site output.
	Chapters []ChapterContent

	// CSS is the merged theme CSS and custom CSS.
	CSS string

	// Meta contains document metadata.
	Meta DocumentMeta
}

type SiteChapter struct {
	Title    string
	ID       string
	Filename string // Output HTML filename, for example "ch01.html".
	Content  string // Rendered HTML content.
	Markdown string // Source markdown after variable expansion.
	// SourcePath is the chapter's markdown source path relative to the book
	// root (e.g. "chapter01/section1.md"), used to build "edit this page"
	// links. When empty, the path is derived from Filename as a best effort.
	SourcePath string
	// Section is an optional group label rendered above this chapter in the
	// sidebar, from SUMMARY.md "## Heading" lines or book.yaml's `section:`.
	Section  string
	Depth    int
	Headings []SiteNavHeading
	Children []SiteChapter
}

type SiteGenerator struct {
	Meta     SiteMeta
	Chapters []SiteChapter
	CSS      string // Theme CSS plus custom CSS.
	// BookRoot is the project directory. It is used to locate the optional
	// static/ directory whose contents are copied into the site root. Empty
	// disables that copy.
	BookRoot string
}

type SiteMeta struct {
	Title       string
	Subtitle    string
	Description string
	Author      string
	Language    string
	Theme       string // CSS theme name.
	// ThemeDescription is no longer rendered. It used to be the theme badge's
	// tooltip, which meant mdPress's own marketing copy about its themes sat
	// on the sidebar of every published site. Kept so existing callers still
	// compile; drop it together with the caller that sets it.
	ThemeDescription string
	// SiteURL is the public base URL of the deployed site (e.g.
	// https://user.github.io/repo). When set, an absolute-URL sitemap.xml is
	// generated. Empty disables the sitemap.
	SiteURL string
	// EditBase is the base URL for "edit this page" links (e.g.
	// https://github.com/user/repo/edit/main/). Empty disables the links.
	EditBase string

	// Branding. Each of these was previously unconfigurable: the favicon was
	// always mdPress's book emoji, there was no way to show a project logo,
	// and the footer and theme badge could only be removed with a CSS hack.
	//
	// Favicon and Logo are either a path relative to BookRoot (copied into the
	// site's asset directory) or an absolute URL / site-root path, used as-is.
	Favicon string
	Logo    string
	// Copyright is rendered in each page's footer above the mdPress line.
	Copyright string
	// FooterHTML replaces the default "Built with mdPress" line. nil keeps the
	// default; a non-nil empty string removes the line altogether.
	FooterHTML *string
	// ShowThemeBadge renders the theme name in the sidebar. Off by default.
	ShowThemeBadge bool
}

type SiteNavHeading struct {
	Title    string
	ID       string
	Children []SiteNavHeading
}