config

type AnalyticsSettings struct {
	Provider string `yaml:"provider"`
	SiteID   string `yaml:"site_id"`
	Script   string `yaml:"script"`
}

type AsidesSettings struct {
	Style string `yaml:"style"`
}

type BuildSettings struct {
	Output   string `yaml:"output"`
	BasePath string `yaml:"base_path"`
	Clean    *bool  `yaml:"clean"`
	Sitemap  *bool  `yaml:"sitemap"`
	Minify   *bool  `yaml:"minify"`
	// LastUpdated selects the strategy for page "last updated" timestamps:
	//   "git"   — last commit time for the file, fall back to mtime on error (default)
	//   "mtime" — filesystem modification time
	//   "false" / "off" — disabled; no timestamp rendered
	// Legacy YAML bool form is accepted: true → "mtime", false → "false" (with deprecation warning).
	LastUpdated LastUpdatedStrategy `yaml:"last_updated"`
	Feed        *bool               `yaml:"feed"`
	Drafts      *bool               `yaml:"drafts"`
	Future      *bool               `yaml:"future"`
	Expired     *bool               `yaml:"expired"`
	Parallel    *bool               `yaml:"parallel"`
	Cache       *bool               `yaml:"cache"`
}

type CodeblocksSettings struct {
	Engine           string `yaml:"engine"`
	Style            string `yaml:"style"`
	LightTheme       string `yaml:"light_theme"`
	DarkTheme        string `yaml:"dark_theme"`
	Theme            string `yaml:"theme"`
	DarkModeSelector string `yaml:"dark_mode_selector"`
}

type CollectionLabsConfig struct {
	Label string `yaml:"label"` // "Lab", "Exercise", "Activity", etc.
}

type CollectionPrevNextConfig struct {
	Enabled *bool    `yaml:"enabled"`
	Labels  []string `yaml:"labels"`
}

type CollectionSidebarConfig struct {
	Collapsible        *bool `yaml:"collapsible"`
	CollapsedByDefault *bool `yaml:"collapsed_by_default"`
	MaxDepth           int   `yaml:"max_depth"`
	Search             *bool `yaml:"search"`
	CollapseLevel      *int  `yaml:"collapse_level"`
}

type CollectionSiteConfig struct {
	Enabled      *bool                     `yaml:"enabled"`
	Path         string                    `yaml:"path"`
	URLPrefix    string                    `yaml:"url_prefix"`
	Sort         string                    `yaml:"sort"`
	Layout       string                    `yaml:"layout"`
	Permalink    string                    `yaml:"permalink"`
	Paginate     int                       `yaml:"paginate"`
	Feed         *bool                     `yaml:"feed"`
	Tabs         *bool                     `yaml:"tabs"`
	Sidebar      *CollectionSidebarConfig  `yaml:"sidebar"`
	TOC          *CollectionTOCConfig      `yaml:"toc"`
	PrevNext     *CollectionPrevNextConfig `yaml:"prev_next"`
	Versioning   *VersioningConfig         `yaml:"versioning"`
	Labs         *CollectionLabsConfig     `yaml:"labs"`
	I18nFallback string                    `yaml:"i18n_fallback"` // "" (inherit site), "default", or "omit"
}

type CollectionTOCConfig struct {
	Enabled         *bool `yaml:"enabled"`
	Depth           int   `yaml:"depth"`
	ScrollHighlight *bool `yaml:"scroll_highlight"`
}

type ContentLintRules struct {
	HeadingMaxLength    int      `yaml:"heading_max_length"`
	HeadingIncrement    *bool    `yaml:"heading_increment"`
	ImageAltRequired    *bool    `yaml:"image_alt_required"`
	NoEmptyLinks        *bool    `yaml:"no_empty_links"`
	FrontmatterRequired []string `yaml:"frontmatter_required"`
	TabsMarkerSyntax    *bool    `yaml:"tabs_marker_syntax"`
}

type ContentLintSettings struct {
	Enabled *bool            `yaml:"enabled"`
	Rules   ContentLintRules `yaml:"rules"`
}

type ContentSettings struct {
	Dir           string `yaml:"dir"`
	SummaryLength int    `yaml:"summary_length"`
}

type DeployConfig struct {
	Provider       string `yaml:"provider"`        // github, netlify, cloudflare, vercel, custom
	Branch         string `yaml:"branch"`          // GitHub Pages branch (default: gh-pages)
	SiteID         string `yaml:"site_id"`         // Netlify site ID
	ProjectName    string `yaml:"project_name"`    // Cloudflare Pages project name
	ProjectID      string `yaml:"project_id"`      // Vercel project ID
	Command        string `yaml:"command"`         // Custom deploy command
	RedirectFormat string `yaml:"redirect_format"` // html, netlify, vercel, all (default: all)
}

type ExternalCheckSettings struct {
	Check       *bool    `yaml:"check"`       // default: false
	Concurrency int      `yaml:"concurrency"` // default: 8
	Timeout     string   `yaml:"timeout"`     // default: "10s" (parsed with time.ParseDuration)
	Cache       string   `yaml:"cache"`       // default: ".sarde/linkcache.json"
	CacheTTL    string   `yaml:"cache_ttl"`   // default: "72h"
	OnBroken    string   `yaml:"on_broken"`   // "warn" (default) | "error" | "ignore"
	Ignore      []string `yaml:"ignore"`      // URL glob patterns to skip
	Method      string   `yaml:"method"`      // "head-then-get" (default) | "head" | "get"
}

type FooterSettings struct {
	Text    string    `yaml:"text"`
	Links   []NavLink `yaml:"links"`
	Credits *bool     `yaml:"credits"`
}

type HeadSettings struct {
	Tags      []HeadTag `yaml:"tags"`
	CustomCSS []string  `yaml:"custom_css"`
	CustomJS  []string  `yaml:"custom_js"`
}

type HeadTag struct {
	Tag     string            `yaml:"tag"`
	Attrs   map[string]string `yaml:"attrs"`
	Content string            `yaml:"content"`
}

type HeaderSettings struct {
	Search      *bool     `yaml:"search"`
	ThemeToggle *bool     `yaml:"theme_toggle"`
	Social      *bool     `yaml:"social"`
	Links       []NavLink `yaml:"links"`
}

type HeroCTA struct {
	Label string `yaml:"label"`
	URL   string `yaml:"url"`
	Icon  string `yaml:"icon"`
}

type HeroCode struct {
	Title    string `yaml:"title"`
	Language string `yaml:"language"`
	Body     string `yaml:"body"`
}

type HeroImageSettings struct {
	Src   string `yaml:"src"`
	Light string `yaml:"light"`
	Dark  string `yaml:"dark"`
	Alt   string `yaml:"alt"`
	HTML  string `yaml:"html"`
}

type HeroSettings struct {
	Eyebrow      string             `yaml:"eyebrow"`
	Title        string             `yaml:"title"`
	Subtitle     string             `yaml:"subtitle"`
	CTA          *HeroCTA           `yaml:"cta"`
	SecondaryCTA *HeroCTA           `yaml:"secondary_cta"`
	Stats        []HeroStat         `yaml:"stats"`
	Code         *HeroCode          `yaml:"code"`
	Image        *HeroImageSettings `yaml:"image"`
	Background   string             `yaml:"background"`
}

type HeroStat struct {
	Value string `yaml:"value"`
	Label string `yaml:"label"`
}

type HomepageSettings struct {
	Template string       `yaml:"template"`
	Hero     HeroSettings `yaml:"hero"`
}

type I18nSettings struct {
	DefaultLanguage string                    `yaml:"default_language"`
	Strategy        string                    `yaml:"strategy"` // "prefix-except-default" (default)
	Fallback        string                    `yaml:"fallback"` // "default" | "omit"
	Strict          bool                      `yaml:"strict"`
	Languages       map[string]LanguageConfig `yaml:"languages"`
}

type IconSet struct {
	Prefix string `yaml:"prefix"`
	File   string `yaml:"file"`
}

type IconSettings struct {
	DefaultPrefix string    `yaml:"default_prefix"`
	Sets          []IconSet `yaml:"sets"`
	SetsDir       string    `yaml:"sets_dir"`
	LocalDir      string    `yaml:"local_dir"`
	Attribution   string    `yaml:"attribution"`
	// Render selects the icon output mode: "inline" (default) emits a full SVG
	// per use; "sprite" emits one hidden <symbol> per unique icon per page and
	// references it with <use>.
	Render string `yaml:"render"`
}

type ImageSettings struct {
	Widths      []int    `yaml:"widths"`
	Formats     []string `yaml:"formats"`
	Quality     int      `yaml:"quality"`
	Placeholder string   `yaml:"placeholder"`
	MaxWidth    int      `yaml:"max_width"`
	LazyLoading *bool    `yaml:"lazy_loading"`
	Dimensions  *bool    `yaml:"dimensions"`
}

type LanguageConfig struct {
	Name   string `yaml:"name"`
	Title  string `yaml:"title"`
	Weight int    `yaml:"weight"`
	Dir    string `yaml:"dir"` // "ltr" or "rtl"
}

type LastUpdatedStrategy string

type LinkValidationSettings struct {
	Enabled              *bool                 `yaml:"enabled"`
	Level                string                `yaml:"level"`
	OnBroken             string                `yaml:"on_broken"`              // "error" (default) | "warn" | "ignore"
	OnBrokenAnchor       string                `yaml:"on_broken_anchor"`       // "error" (default) | "warn" | "ignore"
	Report               string                `yaml:"report"`                 // "pretty" (default) | "json" | "github-actions"
	OnRelativeLinks      string                `yaml:"on_relative_links"`      // "warn" (default) | "error" | "ignore"
	OnLocalLinks         string                `yaml:"on_local_links"`         // "warn" (default) | "error" | "ignore"
	OnUnverifiedInternal string                `yaml:"on_unverified_internal"` // "warn" (default) | "error" | "ignore" — extension-less internal links that didn't resolve in-lane
	CheckAnchors         *bool                 `yaml:"check_anchors"`
	CheckImages          *bool                 `yaml:"check_images"`
	SameSitePolicy       string                `yaml:"same_site_policy"`
	SiteRootEscapePrefix string                `yaml:"site_root_escape_prefix"` // prefix (e.g. "site:") routing a link to the site root, bypassing lane logic
	Exclude              []string              `yaml:"exclude"`
	Ignore               []string              `yaml:"ignore"`
	FailBuild            *bool                 `yaml:"fail_build"`
	External             ExternalCheckSettings `yaml:"external"`
}

type LlmsTxtSettings struct {
	Enabled     *bool `yaml:"enabled"`
	IncludeBlog *bool `yaml:"include_blog"`
}

type Logo struct {
	Light string `yaml:"light"`
	Dark  string `yaml:"dark"`
	Alt   string `yaml:"alt"`
	// ReplacesTitle visually hides the site title text so only the logo shows.
	// The title stays in the DOM (screen-reader only) so the link keeps an
	// accessible name.
	ReplacesTitle *bool `yaml:"replaces_title"`
}

type MarkdownSettings struct {
	KaTeX               *bool               `yaml:"katex"`
	Mermaid             *bool               `yaml:"mermaid"`
	CDN                 *bool               `yaml:"cdn"`
	Unsafe              *bool               `yaml:"unsafe"`
	Typographer         *bool               `yaml:"typographer"`
	GithubAlerts        *bool               `yaml:"github_alerts"`
	TripleColonCallouts *bool               `yaml:"triple_colon_callouts"`
	HardWraps           *bool               `yaml:"hard_wraps"`
	TOC                 MarkdownTOCSettings `yaml:"toc"`
	Codeblocks          CodeblocksSettings  `yaml:"codeblocks"`
	Asides              AsidesSettings      `yaml:"asides"`
}

type MarkdownTOCSettings struct {
	MinHeadingLevel int `yaml:"min_heading_level"`
	MaxHeadingLevel int `yaml:"max_heading_level"`
}

type NavLink struct {
	Label    string `yaml:"label"`
	URL      string `yaml:"url"`
	External bool   `yaml:"external"`
}

type PluginSettings struct {
	Enabled  []string                  `yaml:"enabled"`
	Disabled []string                  `yaml:"disabled"`
	Config   map[string]map[string]any `yaml:"config"`
}

type PrefetchSettings struct {
	Enabled  *bool  `yaml:"enabled"`
	Strategy string `yaml:"strategy"`
	Delay    *int   `yaml:"delay"`
}

type ResolveOptions struct {
	ConfigPath   string         // path to sarde.yaml (default: "sarde.yaml")
	ThemeDir     string         // path to active theme dir (empty = skip theme layer)
	CLIFlags     map[string]any // flag overrides from Cobra
	EnvPrefix    string         // env var prefix (default: "SARDE")
	Strict       bool           // reject unknown fields in user sarde.yaml
	KnownPlugins []string       // valid plugin names (collected by build layer from registries)
}

type SearchSettings struct {
	Enabled  *bool  `yaml:"enabled"`
	Provider string `yaml:"provider"`
}

type SecurityConfig struct {
	BlockedHrefSchemes []string `yaml:"blocked_href_schemes"`
}

type ServerSettings struct {
	Host       string `yaml:"host"`
	Port       int    `yaml:"port"`
	LiveReload *bool  `yaml:"live_reload"`
}

type SidebarCollectionEntry struct {
	// CollapseLevel, when set, expands sidebar groups at depth <= N by
	// default and collapses deeper groups. Wins over the sarde.yaml
	// collections.{name}.sidebar.collapse_level value.
	CollapseLevel *int `yaml:"collapse_level"`

	// Tabs holds tab-bar property overrides keyed by tab slug
	// (tabbed docs collections only).
	Tabs map[string]*SidebarTabOverride `yaml:"tabs"`

	// Overrides holds node property overrides keyed by collection-relative
	// path (for example "guide/advanced"). Keys address sections and pages.
	Overrides map[string]*SidebarNodeOverride `yaml:"overrides"`

	// Items is the structural sidebar skeleton (Phase 2). Declared so strict
	// decoding accepts the key; Phase 1 warns and ignores it when non-empty.
	Items []SidebarItemEntry `yaml:"items"`
}

type SidebarFile map[string]*SidebarCollectionEntry

type SidebarItemEntry struct {
	Label        string             `yaml:"label"`
	Page         string             `yaml:"page"`
	URL          string             `yaml:"url"`
	External     bool               `yaml:"external"`
	Badge        engine.Badge       `yaml:"badge"`
	Collapsed    *bool              `yaml:"collapsed"`
	Attrs        map[string]string  `yaml:"attrs"`
	Autogenerate string             `yaml:"autogenerate"`
	Items        []SidebarItemEntry `yaml:"items"`
}

type SidebarNodeOverride struct {
	Label       string            `yaml:"label"`
	Description string            `yaml:"description"`
	Order       *int              `yaml:"order"`
	Collapsed   *bool             `yaml:"collapsed"`
	Icon        string            `yaml:"icon"`
	Badge       engine.Badge      `yaml:"badge"`  // scalar or {text, variant} form
	Hidden      *bool             `yaml:"hidden"` // nil = unset; false un-hides a frontmatter-hidden page
	Attrs       map[string]string `yaml:"attrs"`
}

type SidebarTabOverride struct {
	Label       string `yaml:"label"`
	Description string `yaml:"description"`
	Icon        string `yaml:"icon"`
	Order       *int   `yaml:"order"`
}

type SiteConfig struct {
	Site           SiteIdentity                     `yaml:"site"`
	Social         []SocialLink                     `yaml:"social"`
	Theme          ThemeSettings                    `yaml:"theme"`
	TOC            TOCSettings                      `yaml:"toc"`
	Header         HeaderSettings                   `yaml:"header"`
	Footer         FooterSettings                   `yaml:"footer"`
	Head           HeadSettings                     `yaml:"head"`
	Build          BuildSettings                    `yaml:"build"`
	Markdown       MarkdownSettings                 `yaml:"markdown"`
	Prefetch       PrefetchSettings                 `yaml:"prefetch"`
	Images         ImageSettings                    `yaml:"images"`
	Search         SearchSettings                   `yaml:"search"`
	Icons          IconSettings                     `yaml:"icons"`
	LinkValidation LinkValidationSettings           `yaml:"link_validation"`
	ContentLint    ContentLintSettings              `yaml:"content_lint"`
	Analytics      AnalyticsSettings                `yaml:"analytics"`
	Deploy         DeployConfig                     `yaml:"deploy"`
	Redirects      map[string]string                `yaml:"redirects"`
	Collections    map[string]*CollectionSiteConfig `yaml:"collections"`
	Homepage       HomepageSettings                 `yaml:"homepage"`
	Plugins        PluginSettings                   `yaml:"plugins"`
	Taxonomies     map[string]TaxonomyConfig        `yaml:"taxonomies"`
	Server         ServerSettings                   `yaml:"server"`
	Permalinks     map[string]string                `yaml:"permalinks"`
	I18n           I18nSettings                     `yaml:"i18n"`
	Content        ContentSettings                  `yaml:"content"`
	LlmsTxt        LlmsTxtSettings                  `yaml:"llms_txt"`
	Security       SecurityConfig                   `yaml:"security"`

	// SidebarFile is the parsed root-level sidebar.yaml (nil when absent).
	// Populated programmatically by Resolve, never from sarde.yaml content.
	SidebarFile SidebarFile `yaml:"-"`
}

type SiteIdentity struct {
	Title          string `yaml:"title"`
	Description    string `yaml:"description"`
	Author         string `yaml:"author"`
	URL            string `yaml:"url"`
	Logo           Logo   `yaml:"logo"`
	Favicon        string `yaml:"favicon"`
	Language       string `yaml:"language"`
	EditURL        string `yaml:"edit_url"`
	TitleDelimiter string `yaml:"title_delimiter"`
	HeadingLinks   *bool  `yaml:"heading_links"`
	Custom404      string `yaml:"custom_404"`
}

type SocialLink struct {
	Label string `yaml:"label"`
	URL   string `yaml:"url"`
	Icon  string `yaml:"icon"`
}

type TOCSettings struct {
	Enabled  *bool `yaml:"enabled"`
	MinLevel int   `yaml:"min_level"`
	MaxLevel int   `yaml:"max_level"`
}

type TaxonomyConfig struct {
	Singular      string `yaml:"singular"`
	PaginateBy    int    `yaml:"paginate_by"`
	UndefinedTags string `yaml:"undefined_tags"`
	Render        *bool  `yaml:"render"`
	ShowTags      *bool  `yaml:"show_tags"`
}

type ThemeSettings struct {
	Name          string            `yaml:"name"`
	Preset        string            `yaml:"preset"`
	Dark          *bool             `yaml:"dark"`
	Overrides     map[string]string `yaml:"overrides"`
	DarkOverrides map[string]string `yaml:"dark_overrides"`
	PrimaryColor  string            `yaml:"primary_color"`
	AccentColor   string            `yaml:"accent_color"`
	FontFamily    string            `yaml:"font_family"`
	FontMono      string            `yaml:"font_mono"`
	CodeLight     string            `yaml:"code_light"`
	CodeDark      string            `yaml:"code_dark"`

	// DateFormat controls the "last updated" date display. Accepts the
	// preset names "short", "long", and "iso", or any raw Go layout. Kept raw
	// here: the dateFormat template function resolves presets per page
	// language (CLDR data when available, NormalizeDateFormat otherwise).
	// Custom Go layouts always render English month names.
	DateFormat string `yaml:"date_format"`
}

type ValidationError struct {
	Errors []validate.Error
}

type VersionBanner string

type VersionEntry struct {
	ID       string          `yaml:"id"`
	Label    string          `yaml:"label"`
	Path     string          `yaml:"path"`
	Banner   VersionBanner   `yaml:"banner"`
	Redirect VersionRedirect `yaml:"redirect"`
}

type VersionRedirect string

type VersioningConfig struct {
	Enabled                   *bool          `yaml:"enabled"`
	LastVersion               string         `yaml:"last_version"`
	PublishLatestAtVersionURL bool           `yaml:"publish_latest_at_version_url"`
	Fallback                  string         `yaml:"fallback"` // "" (inherit site), "default", or "omit"
	Versions                  []VersionEntry `yaml:"versions"`
}