epub

type DCCreator struct {
	ID    string // id attribute (used as refines target in EPUB 3)
	Value string
	Role  string // opf:role attribute (EPUB 2)
}

type DCIdentifier struct {
	ID    string
	Value string
}

type DCTitle struct {
	ID    string // id attribute (used as refines target in EPUB 3)
	Value string
}

type EPUB struct {
	Path    string
	ZipFile *zip.ReadCloser
	Files   map[string]*zip.File // path -> zip.File

	// Parsed from container.xml
	RootfilePath   string
	AllRootfiles   []Rootfile // all rootfile elements from container.xml
	ContainerLinks []string   // hrefs from <links> in container.xml
	ContainerData  []byte     // raw container.xml bytes

	// Parsed from OPF
	Package *Package

	// Raw OPF parse info (set during ParseOPF)
	OPFParseError error
	HasMetadata   bool
	HasManifest   bool
	HasSpine      bool
}

type GuideReference struct {
	Type  string
	Title string
	Href  string
}

type ManifestItem struct {
	ID           string
	Href         string
	MediaType    string
	Properties   string
	Fallback     string
	HasID        bool   // false when id attribute is missing
	MediaOverlay string // media-overlay attribute
}

type MetaRefines struct {
	ID       string // id attribute on the meta element itself
	Refines  string // the refines attribute value (e.g., "#id")
	Property string
	Value    string
}

type Metadata struct {
	Titles       []DCTitle
	Identifiers  []DCIdentifier
	Languages    []string
	Modified     string // dcterms:modified value
	Dates        []string
	Sources      []string
	Creators     []DCCreator
	Contributors []DCCreator // dc:contributor elements (same structure as dc:creator)
	DCElementIDs []string    // id attributes from all dc:* elements (publisher, subject, description, etc.)
}

type Package struct {
	UniqueIdentifier         string
	Version                  string
	Dir                      string // dir attribute on package element
	Prefix                   string // prefix attribute on package element
	Metadata                 Metadata
	Manifest                 []ManifestItem
	Spine                    []SpineItemref
	SpineToc                 string // EPUB 2 spine toc attribute
	RenditionLayout          string // "pre-paginated" or "reflowable"
	RenditionFlow            string // rendition:flow property
	Guide                    []GuideReference
	HasGuide                 bool // whether a <guide> element was present
	ModifiedCount            int  // number of dcterms:modified meta elements
	RenditionOrientation     string
	RenditionSpread          string
	PageProgressionDirection string        // spine page-progression-direction attribute
	MetaRefines              []MetaRefines // meta elements with refines attribute
	MetaIDs                  []string      // id attributes from all meta elements in metadata
	ElementOrder             []string      // order of top-level OPF elements (metadata, manifest, spine, guide)
}

type Rootfile struct {
	FullPath  string
	MediaType string
}

type SpineItemref struct {
	IDRef      string
	Properties string
	Linear     string // linear attribute value ("yes", "no", or empty)
}