cmd

type BuildContext struct {
	Config             *config.BookConfig
	Theme              *theme.Theme
	SinglePageParts    *renderer.RenderParts
	PDFSinglePageParts *renderer.RenderParts
	ChaptersHTML       []renderer.ChapterHTML
	ChapterFiles       []string
	CustomCSS          string
	Logger             *slog.Logger
}

type BuildManifest struct {
	Version  string                   `json:"version"`
	AppVer   string                   `json:"app_version"`
	ConfigSH string                   `json:"config_sha256"`
	CSSHash  string                   `json:"css_hash"`
	Chapters map[string]ManifestEntry `json:"chapters"`
}

type BuildOrchestrator struct {
	Config *config.BookConfig
	Theme  *theme.Theme
	Parser *markdown.Parser
	Gloss  *glossary.Glossary
	Logger *slog.Logger
	// PluginManager manages loaded plugins and dispatches hook calls throughout the
	// build pipeline.  It is an empty (no-op) Manager when no plugins are configured.
	PluginManager *plugin.Manager
}

type CacheStatistics struct {
	Total     int
	Hits      int
	Misses    int
	Timestamp time.Time
}

type ChapterPipeline struct {
	Config   *config.BookConfig
	Theme    *theme.Theme
	Parser   *markdown.Parser
	Glossary *glossary.Glossary
	Logger   *slog.Logger
	// PluginManager is invoked at the AfterParse hook, allowing plugins to
	// transform the HTML of each chapter after Markdown parsing.
	PluginManager *plugin.Manager
}

type ChapterPipelineOptions struct {
	ImageOptions *utils.ImageProcessingOptions
	// MaxConcurrency controls how many chapters are parsed in parallel.
	// If 0, defaults to runtime.NumCPU() (capped at 8).
	// If negative, sequential processing (concurrency = 1).
	MaxConcurrency int
}

type ChapterPipelineResult struct {
	Chapters       []renderer.ChapterHTML
	ChapterFiles   []string
	Issues         []projectIssue
	AllHeadings    []toc.HeadingInfo
	Resolver       *crossref.Resolver
	HeadingRecords []chapterHeadingRecord
}

type EpubBuilder struct{}

type FormatBuilder interface {
	// Name returns the format name (e.g. "pdf", "html", "site", "epub").
	Name() string
	// Build generates the output file(s) at the given base path.
	Build(ctx *BuildContext, baseName string) error
}

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

type HTMLBuilder struct{}

type ManifestEntry struct {
	SHA256   string    `json:"sha256"`
	HTMLPath string    `json:"html_path"`
	Headings []string  `json:"headings"` // List of heading texts for TOC
	ModTime  time.Time `json:"mod_time"` // Chapter file modification time
}

type PDFBuilder struct{}

type ServeOptions struct {
	Port        int
	Host        string
	OutputDir   string
	AutoOpen    bool
	PortChanged bool
}

type SiteBuilder struct{}

type Theme struct {
	Name        string
	DisplayName string
	Description string
	Author      string
	Version     string
	License     string
	Features    []string
	Colors      ThemeColors
}

type ThemeColors struct {
	Primary    string
	Secondary  string
	Accent     string
	Text       string
	Background string
	CodeBg     string
}

type TypstBuilder struct{}