site

type AssetsConfig struct {
	InputDir    string `yaml:"inputDir"`
	OutputDir   string `yaml:"outputDir"`
	Minify      bool   `yaml:"minify"`
	Fingerprint bool   `yaml:"fingerprint"`
}

type AtomAuthor struct {
	Name string `xml:"name"`
}

type AtomEntry struct {
	Title   string      `xml:"title"`
	Link    AtomFLink   `xml:"link"`
	ID      string      `xml:"id"`
	Updated string      `xml:"updated"`
	Summary string      `xml:"summary,omitempty"`
	Author  *AtomAuthor `xml:"author,omitempty"`
}

type AtomFLink struct {
	Href string `xml:"href,attr"`
	Rel  string `xml:"rel,attr,omitempty"`
	Type string `xml:"type,attr,omitempty"`
}

type AtomFeed struct {
	XMLName xml.Name    `xml:"feed"`
	Xmlns   string      `xml:"xmlns,attr"`
	Title   string      `xml:"title"`
	Link    []AtomFLink `xml:"link"`
	Updated string      `xml:"updated"`
	ID      string      `xml:"id"`
	Author  *AtomAuthor `xml:"author,omitempty"`
	Entries []AtomEntry `xml:"entry"`
}

type AtomLink struct {
	Href string `xml:"href,attr"`
	Rel  string `xml:"rel,attr"`
	Type string `xml:"type,attr"`
}

type BuildConfig struct {
	// Drafts includes draft pages in the build when true
	Drafts bool `yaml:"drafts,omitempty"`
	// Future includes pages with future dates when true
	Future bool `yaml:"future,omitempty"`
}

type Config struct {
	Title       string        `yaml:"title"`
	BaseURL     string        `yaml:"baseURL"`
	Description string        `yaml:"description,omitempty"`
	Language    string        `yaml:"language,omitempty"`
	Content     ContentConfig `yaml:"content"`
	Assets      AssetsConfig  `yaml:"assets"`
	OutputDir   string        `yaml:"outputDir"`
	ThemeColor  string        `yaml:"themeColor,omitempty"`

	// Taxonomies lists the taxonomy names to build (e.g., ["tags", "categories"])
	// Each taxonomy extracts terms from page frontmatter with the same key
	Taxonomies []string `yaml:"taxonomies,omitempty"`

	// Menus defines navigation menus (e.g., "main", "footer")
	Menus map[string][]MenuItemConfig `yaml:"menus,omitempty"`

	// DataDir is the directory containing data files (YAML/JSON)
	DataDir string `yaml:"dataDir,omitempty"`

	// StaticDir is the directory containing files to copy to the output root
	// (favicons, etc.). Defaults to "static".
	StaticDir string `yaml:"staticDir,omitempty"`

	// Build contains build-time options
	Build BuildConfig `yaml:"build,omitempty"`

	// Highlight configures syntax highlighting for code blocks
	Highlight HighlightConfig `yaml:"highlight,omitempty"`

	// Params holds arbitrary user-defined parameters accessible in templates
	// via s.Config.Params["key"]. Environment overrides merge into this map.
	Params map[string]any `yaml:"params,omitempty"`

	// LLMs configures llms.txt generation for LLM-friendly content discovery
	LLMs LLMsConfig `yaml:"llms,omitempty"`
}

type ContentConfig struct {
	Dir           string `yaml:"dir"`
	DefaultLayout string `yaml:"defaultLayout"`
}

type HighlightConfig struct {
	// Style is the Chroma style name (e.g., "monokai", "github", "dracula").
	// When set, code blocks are syntax-highlighted and a chroma.css file is generated.
	// Empty string disables syntax highlighting.
	Style string `yaml:"style,omitempty"`
	// LineNumbers adds line numbers to code blocks when true
	LineNumbers bool `yaml:"lineNumbers,omitempty"`
}

type JSONFeed struct {
	Version     string         `json:"version"`
	Title       string         `json:"title"`
	HomePageURL string         `json:"home_page_url"`
	FeedURL     string         `json:"feed_url"`
	Description string         `json:"description,omitempty"`
	Language    string         `json:"language,omitempty"`
	Items       []JSONFeedItem `json:"items"`
}

type JSONFeedItem struct {
	ID            string `json:"id"`
	URL           string `json:"url"`
	Title         string `json:"title"`
	ContentText   string `json:"content_text,omitempty"`
	Summary       string `json:"summary,omitempty"`
	DatePublished string `json:"date_published,omitempty"`
	Author        *struct {
		Name string `json:"name"`
	} `json:"author,omitempty"`
}

type LLMsConfig struct {
	// Enabled turns on llms.txt generation
	Enabled bool `yaml:"enabled"`
	// Description overrides the site description in the llms.txt blockquote
	Description string `yaml:"description,omitempty"`
	// Sections defines explicit content sections for llms.txt.
	// If empty, sections are auto-derived from the site's directory structure.
	Sections []LLMsSectionConfig `yaml:"sections,omitempty"`
	// Exclude lists section patterns to exclude from llms.txt (e.g., "internal")
	Exclude []string `yaml:"exclude,omitempty"`
}

type LLMsSectionConfig struct {
	// Name is the display name for the section heading
	Name string `yaml:"name"`
	// Pattern is the section name (content directory) to match
	Pattern string `yaml:"pattern"`
	// Priority is "required" (default) or "optional".
	// Optional sections are grouped under "## Optional" in the output.
	Priority string `yaml:"priority,omitempty"`
}

type MenuItem struct {
	Name   string
	URL    string
	Weight int
	Active bool // Set during rendering based on current page
}

type MenuItemConfig struct {
	Name   string `yaml:"name"`
	URL    string `yaml:"url"`
	Weight int    `yaml:"weight,omitempty"`
}

type Paginator struct {
	Items      []*content.Page // pages for current page
	TotalItems int             // total number of items across all pages
	PerPage    int             // items per page
	TotalPages int             // total number of pages
	PageNum    int             // current page number (1-indexed)
	HasPrev    bool            // true if there's a previous page
	HasNext    bool            // true if there's a next page
	PrevURL    string          // URL of previous page (empty if no prev)
	NextURL    string          // URL of next page (empty if no next)
	PageURLs   []string        // URLs for all pages (for building navigation)
	BaseURL    string          // base URL for this paginated section
}

type RSSChannel struct {
	Title         string    `xml:"title"`
	Link          string    `xml:"link"`
	Description   string    `xml:"description"`
	Language      string    `xml:"language,omitempty"`
	LastBuildDate string    `xml:"lastBuildDate,omitempty"`
	AtomLink      AtomLink  `xml:"atom:link"`
	Items         []RSSItem `xml:"item"`
}

type RSSFeed struct {
	XMLName xml.Name   `xml:"rss"`
	Version string     `xml:"version,attr"`
	Atom    string     `xml:"xmlns:atom,attr"`
	Channel RSSChannel `xml:"channel"`
}

type RSSItem struct {
	Title       string `xml:"title"`
	Link        string `xml:"link"`
	Description string `xml:"description,omitempty"`
	PubDate     string `xml:"pubDate,omitempty"`
	GUID        string `xml:"guid"`
	Author      string `xml:"author,omitempty"`
}

type Section struct {
	// Name is the section identifier (directory name)
	Name string

	// Title is the display title (from _index.md or derived from Name)
	Title string

	// Description is from _index.md frontmatter
	Description string

	// Pages contains all pages in this section, sorted by date descending
	Pages []*content.Page

	// URL is the section's URL path (e.g., /blog/)
	URL string

	// Index is the _index.md page for this section (if it exists)
	Index *content.Page
}

type Site struct {
	Config       *Config
	Pages        []*content.Page
	Sections     map[string]*Section
	Taxonomies   map[string]*Taxonomy
	Menus        map[string][]*MenuItem
	Data         map[string]any
	BuildTime    time.Time
	AssetVersion string // content hash for cache-busting query strings
	// contains filtered or unexported fields
}

type SitemapURL struct {
	Loc        string `xml:"loc"`
	LastMod    string `xml:"lastmod,omitempty"`
	ChangeFreq string `xml:"changefreq,omitempty"`
	Priority   string `xml:"priority,omitempty"`
}

type Taxonomy struct {
	// Name is the taxonomy identifier (e.g., "tags")
	Name string

	// Plural is used for URLs (usually same as Name)
	Plural string

	// Terms maps term slugs to Term structs
	Terms map[string]*Term
}

type Term struct {
	// Name is the display name of the term
	Name string

	// Slug is the URL-safe version of the name
	Slug string

	// Pages contains all pages with this term
	Pages []*content.Page

	// URL is the term's URL path (e.g., /tags/go/)
	URL string

	// Taxonomy is the parent taxonomy name
	Taxonomy string
}

type URLSet struct {
	XMLName xml.Name     `xml:"urlset"`
	Xmlns   string       `xml:"xmlns,attr"`
	URLs    []SitemapURL `xml:"url"`
}