config

type APISpec struct {
	// Spec is the path to the OpenAPI file. It may be given relative to the
	// project root (e.g. "apis/teams.yaml") or as a bare file name ("teams.yaml")
	// that is matched against the files discovered under apis/.
	Spec        string `yaml:"spec"`
	Slug        string `yaml:"slug,omitempty"`
	Title       string `yaml:"title,omitempty"`
	Description string `yaml:"description,omitempty"`
}

type Banner struct {
	Message     string `yaml:"message"`
	Color       string `yaml:"color"`
	Dismissible bool   `yaml:"dismissible"`
}

type Branding struct {
	LogoLight  string `yaml:"logo_light"`
	LogoDark   string `yaml:"logo_dark"`
	LogoAlt    string `yaml:"logo_alt"`
	LogoLink   string `yaml:"logo_link"`
	LogoWidth  string `yaml:"logo_width"`
	LogoHeight string `yaml:"logo_height"`
	Favicon    string `yaml:"favicon"`
}

type Config struct {
	Title       string       `yaml:"title"`
	Description string       `yaml:"description"`
	URL         string       `yaml:"url"`
	Language    string       `yaml:"language"`
	Theme       string       `yaml:"theme"`
	Redirect    string       `yaml:"redirect,omitempty"`
	Branding    Branding     `yaml:"branding"`
	Footer      Footer       `yaml:"footer"`
	Navigation  []NavItem    `yaml:"navigation"`
	Sections    SectionPaths `yaml:"sections"`
	Banner      Banner       `yaml:"banner,omitempty"`
	EditBaseURL string       `yaml:"edit_base_url,omitempty"`
	LLMs        LLMsConfig   `yaml:"llms,omitempty"`
	APIs        []APISpec    `yaml:"apis,omitempty"`
}

type Footer struct {
	Copyright string         `yaml:"copyright"`
	Position  string         `yaml:"position"`
	Columns   []FooterColumn `yaml:"columns"`
	Social    []FooterSocial `yaml:"social"`
}

type FooterColumn struct {
	Title string       `yaml:"title"`
	Links []FooterLink `yaml:"links"`
}

type FooterLink struct {
	Label string `yaml:"label"`
	Href  string `yaml:"href"`
}

type FooterSocial struct {
	Icon  string `yaml:"icon"`
	Href  string `yaml:"href"`
	Label string `yaml:"label"`
}

type LLMsConfig struct {
	LLMsTxt     bool `yaml:"llms_txt"`
	LLMsTxtFull bool `yaml:"llms_txt_full"`
}

type NavItem struct {
	Label string `yaml:"label"`
	Path  string `yaml:"path"`
}

type SectionPaths struct {
	Docs      string `yaml:"docs"`
	Guides    string `yaml:"guides"`
	Tutorials string `yaml:"tutorials"`
}