epub

type Content struct {
	// Body contains the actual HTML/text data for this section.
	Body body.Body
	// ReferenceType defines the semantic nature (e.g., Preface, Text, Index).
	ReferenceType reftype.ReferenceType
	// SubContents allows for hierarchical nesting of chapters (e.g., Part > Chapter).
	SubContents []Content
	// ContentReferences defines internal navigational points within this content.
	ContentReferences []ContentReference
	// Filename is an optional custom name for the generated XHTML file.
	Filename nilo.Option[string]
}

type ContentReference struct {
	// Title is the text displayed in the navigation menu.
	Title string
	// SubContentReferences allows for nested navigation levels (e.g., Chapter 1 > Section A).
	SubContentReferences []ContentReference
	// ID is an optional HTML anchor ID within the target file.
	ID nilo.Option[string]
}

type Epub struct {
	// Metadata contains the bibliographic information for the publication.
	Metadata Metadata
	// Stylesheet is an optional global CSS body applied to all content sections.
	Stylesheet nilo.Option[body.Body]
	// CoverImage is the optional image designated as the book's front cover.
	CoverImage nilo.Option[resource.Image]
	// Resources is a collection of secondary assets like fonts, audio, or video.
	Resources []resource.Resource
	// Contents holds the primary reading order and structural sections of the book.
	Contents []Content
}

type Metadata struct {
	// Title is the primary name of the publication.
	Title string
	// Language defines the primary language of the content (ISO 639-1).
	Language lang.Language
	// Identifier is the unique ID for the book (e.g., UUID or ISBN).
	Identifier ident.Identifier
	// Creator is the primary author or organization responsible for the work.
	Creator nilo.Option[string]
	// Contributor is an entity that made secondary contributions.
	Contributor nilo.Option[string]
	// Publisher is the entity responsible for publication.
	Publisher nilo.Option[string]
	// Date is the publication or creation timestamp.
	Date nilo.Option[time.Time]
	// Subject defines the keywords or categories for the book.
	Subject nilo.Option[string]
	// Description is a summary or abstract of the content.
	Description nilo.Option[string]
}