config

type AIConfig struct {
	LlmsTxt        bool `yaml:"llmsTxt"`
	ContentAPI     bool `yaml:"contentAPI"`
	MarkdownMirror bool `yaml:"markdownMirror"`
}

type AuthorConfig struct {
	Name string `yaml:"name"`
}

type BuildConfig struct {
	List             string `yaml:"list"`   // never, always
	Render           string `yaml:"render"` // never, always
	PublishResources bool   `yaml:"publishResources"`
}

type CascadeConfig struct {
	Build   BuildConfig       `yaml:"build"`
	Sitemap SitemapPageConfig `yaml:"sitemap"`
}

type Config struct {
	BaseURL      string `yaml:"baseURL"`
	Title        string `yaml:"title"`
	LanguageCode string `yaml:"languageCode"`
	PublishDir   string `yaml:"publishDir"`
	// CleanPublishDir wipes the output dir before building. Default true.
	// Set false to keep stale files (legacy behavior).
	CleanPublishDir *bool `yaml:"cleanPublishDir"`
	Paginate        int   `yaml:"paginate"`
	Minify          bool  `yaml:"minify"`
	HasCJKLang      bool  `yaml:"hasCJKLanguage"`
	SummaryLen      int   `yaml:"summaryLength"`
	EnableEmoji     bool  `yaml:"enableEmoji"`

	// i18n: when Languages is non-empty, BuildMultiSite runs per-language.
	// See internal/config/languages.go and docs/adr/0007-i18n-build-system.md.
	DefaultContentLanguage string                    `yaml:"defaultContentLanguage"`
	Languages              map[string]LanguageConfig `yaml:"languages"`

	Author  AuthorConfig            `yaml:"author"`
	Params  ParamsConfig            `yaml:"params"`
	Menu    map[string][]MenuItem   `yaml:"menu"`
	Social  []SocialItem            `yaml:"social"`
	Markup  MarkupConfig            `yaml:"markup"`
	Sitemap SitemapConfig           `yaml:"sitemap"`
	RSS     RSSConfig               `yaml:"rss"`
	Outputs OutputsConfig           `yaml:"outputs"`
	AI      AIConfig                `yaml:"ai"`
	Plugins map[string]PluginConfig `yaml:"plugins"`
	Theme   string                  `yaml:"theme"`

	// Computed (not from YAML)
	BaseURLTemplate template.URL
	Services        ServicesConfig
}

type DisqusConfig struct {
	Shortname string
}

type ErrEnvVarNotSet struct {
	VarName string
}

type GoldmarkConfig struct {
	Renderer   GoldmarkRendererConfig   `yaml:"renderer"`
	Extensions GoldmarkExtensionsConfig `yaml:"extensions"`
}

type GoldmarkExtensionsConfig struct {
	Typographer bool `yaml:"typographer"`
}

type GoldmarkRendererConfig struct {
	Unsafe bool `yaml:"unsafe"`
}

type LanguageConfig struct {
	// Weight controls sort order in sitemap.xml and language switcher UI.
	// Lower weight sorts first. Default 0.
	Weight int `yaml:"weight"`

	// LanguageName is the display name (e.g. "中文", "English").
	LanguageName string `yaml:"languageName"`

	// BaseURL is the URL prefix for this language's content. Empty string
	// means root path (typically the default language). Non-empty (e.g. "/en")
	// prepends to all URLs for this language's pages.
	BaseURL string `yaml:"baseURL"`

	// ContentDir overrides the default content/ directory for this language.
	// Empty means use the project's top-level content/ dir (default behavior).
	// When set, huan loads pages from this dir INSTEAD of looking for
	// .<lang>.md sidecars in the main content/ dir.
	ContentDir string `yaml:"contentDir"`

	// Title overrides the top-level cfg.Title for this language.
	Title string `yaml:"title"`

	// LanguageCode is the BCP-47 language code (e.g. "zh-cn", "en").
	// Empty means use the map key from `languages:` block.
	LanguageCode string `yaml:"languageCode"`

	// ExcludeSections lists top-level content sections (e.g. "books",
	// "gallery") that should NOT appear in this language. Pages under these
	// sections are dropped from the build (no content/listing pages, no
	// sitemap entries), and templates use IsSectionExcludedForLang to hide
	// their entry points (menu items, social icons). Typically used to keep
	// untranslated or intentionally-monolingual sections off a translated
	// site. Empty means no exclusion (default).
	ExcludeSections []string `yaml:"excludeSections"`

	// CatalogSections lists top-level sections rendered in this language as
	// "catalog-only": the section index page renders (from its `_index.<lang>.md`
	// sidecar), but the section's content pages are dropped from the build (no
	// content pages, no sitemap entries). Used to advertise an untranslated
	// section's contents (e.g. a disabled book index) without publishing the
	// individual pages.
	CatalogSections []string `yaml:"catalogSections"`

	// NeutralSections lists top-level sections whose content is language-neutral
	// (e.g. an image gallery). In this (non-default) language's build, the
	// section's default-language content pages are included as-is, while the
	// section index uses this language's `_index.<lang>.md` sidecar.
	NeutralSections []string `yaml:"neutralSections"`

	// Params overrides the top-level `params:` block for this language's
	// build (e.g. translated subTitle / description / keywords). Only fields
	// that are relevant per-language are honored: subTitle, footerSlogan,
	// keywords, description. Empty fields fall back to the top-level params.
	Params LanguageParamsConfig `yaml:"params"`

	// StaticExclude lists slash-path prefixes under static/ skipped when
	// copying static assets for THIS language's build (e.g. ["en/"] on the
	// en language prevents static/en/ from landing at <out>/en/en/).
	StaticExclude []string `yaml:"staticExclude"`

	// StaticRoot maps a static/ subdirectory to this language's output root.
	// e.g. "en" makes static/en/* the language-local static dir, copied to
	// the output root of this language's build (replacing the plain static/
	// copy for those prefixed files).
	StaticRoot string `yaml:"staticRoot"`
}

type LanguageEntry struct {
	Code string
	Lang LanguageConfig
}

type LanguageParamsConfig struct {
	SubTitle     string   `yaml:"subTitle"`
	FooterSlogan string   `yaml:"footerSlogan"`
	Keywords     []string `yaml:"keywords"`
	Description  string   `yaml:"description"`
}

type MarkupConfig struct {
	Goldmark GoldmarkConfig `yaml:"goldmark"`
}

type MenuItem struct {
	Name       string `yaml:"name"`
	Weight     int    `yaml:"weight"`
	Identifier string `yaml:"identifier"`
	URL        string `yaml:"url"`
}

type OutputsConfig struct {
	Home     []string `yaml:"home"`
	Page     []string `yaml:"page"`
	Section  []string `yaml:"section"`
	Taxonomy []string `yaml:"taxonomy"`
	Term     []string `yaml:"term"`
}

type ParamsConfig struct {
	SubTitle        string   `yaml:"subTitle"`
	FooterSlogan    string   `yaml:"footerSlogan"`
	Keywords        []string `yaml:"keywords"`
	Description     string   `yaml:"description"`
	Copyrights      string   `yaml:"copyrights"`
	EnableMathJax   bool     `yaml:"enableMathJax"`
	EnableSummary   bool     `yaml:"enableSummary"`
	MainSections    []string `yaml:"mainSections"`
	GoogleAnalytics string   `yaml:"googleAnalytics"`
	CDNURL          string   `yaml:"cdnURL"`

	Author AuthorConfig `yaml:"author"`
}

type PluginConfig struct {
	Category string         `yaml:"category"` // "static" | "dynamic" | "mixed", empty = dynamic
	Config   map[string]any `yaml:",inline"`
}

type RSSConfig struct {
	Limit int `yaml:"limit"`
}

type ServicesConfig struct {
	RSS    RSSConfig
	Disqus DisqusConfig
}

type SitemapConfig struct {
	ChangeFreq string  `yaml:"changefreq"`
	Filename   string  `yaml:"filename"`
	Priority   float64 `yaml:"priority"`
}

type SitemapPageConfig struct {
	Disable    bool    `yaml:"disable"`
	ChangeFreq string  `yaml:"changefreq"`
	Priority   float64 `yaml:"priority"`
}

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