config

type DocSectionSource struct {
	Package     string   `yaml:"package" jsonschema:"description=Package name (must exist in configured ecosystems)"`
	Doc         string   `yaml:"doc,omitempty" jsonschema:"description=Explicit path to doc file (auto-discovers schema_to_md output if omitted)"`
	Title       string   `yaml:"title,omitempty" jsonschema:"description=H2 section title (e.g., User Configuration)"`
	Description string   `yaml:"description,omitempty" jsonschema:"description=Description of what this configuration context is for"`
	Properties  []string `yaml:"properties,omitempty" jsonschema:"description=Properties to document in this section (dot notation supported)"`
}

type DocgenConfig struct {
	Enabled     bool            `yaml:"enabled" jsonschema:"description=Whether documentation generation is enabled for this package"`
	Title       string          `yaml:"title" jsonschema:"description=Title of the package documentation"`
	Description string          `yaml:"description" jsonschema:"description=Brief description of the package"`
	Category    string          `yaml:"category" jsonschema:"description=Category for grouping in documentation sidebar"`
	Settings    SettingsConfig  `yaml:"settings,omitempty" jsonschema:"description=Generator-wide settings"`
	Sections    []SectionConfig `yaml:"sections" jsonschema:"description=List of documentation sections to generate"`
	Readme      *ReadmeConfig   `yaml:"readme,omitempty" jsonschema:"description=README synchronization configuration"`
	Sidebar     *SidebarConfig  `yaml:"sidebar,omitempty" jsonschema:"description=Website sidebar configuration"`
	Logos       []string        `` /* 130-byte string literal not displayed */
}

type GenerationConfig struct {
	Temperature     *float32 `yaml:"temperature,omitempty" jsonschema:"description=Controls randomness in generation (0.0-1.0),minimum=0,maximum=1"`
	TopP            *float32 `yaml:"top_p,omitempty" jsonschema:"description=Nucleus sampling parameter (0.0-1.0),minimum=0,maximum=1"`
	TopK            *int32   `yaml:"top_k,omitempty" jsonschema:"description=Top-k sampling parameter,minimum=1"`
	MaxOutputTokens *int32   `yaml:"max_output_tokens,omitempty" jsonschema:"description=Maximum length of generated content,minimum=1"`
}

type LogoConfig struct {
	Input     string  `yaml:"input" jsonschema:"description=Path to input logo SVG (relative to base_url root or absolute)"`
	Output    string  `yaml:"output" jsonschema:"description=Path for output logo-with-text SVG"`
	Text      string  `yaml:"text" jsonschema:"description=Text to display below logo"`
	Font      string  `yaml:"font" jsonschema:"description=Path to TTF/OTF font file"`
	Color     string  `yaml:"color,omitempty" jsonschema:"description=Text color (hex), defaults to #589ac7"`
	Spacing   float64 `yaml:"spacing,omitempty" jsonschema:"description=Spacing between logo and text (default: 35)"`
	TextScale float64 `yaml:"text_scale,omitempty" jsonschema:"description=Text width as proportion of logo (default: 1.1)"`
	Width     float64 `yaml:"width,omitempty" jsonschema:"description=Output SVG width in pixels (default: 200)"`
}

type ReadmeConfig struct {
	Template      string      `yaml:"template" jsonschema:"description=Path to the README template, relative to package root"`
	Output        string      `yaml:"output" jsonschema:"description=Path to the output README file, relative to package root"`
	SourceSection string      `yaml:"source_section" jsonschema:"description=The name of the section to inject into the template"`
	StripLines    int         `yaml:"strip_lines,omitempty" jsonschema:"description=Number of lines to strip from the top of source file (default: 0)"`
	GenerateTOC   bool        `yaml:"generate_toc,omitempty" jsonschema:"description=Whether to generate a table of contents from sections"`
	BaseURL       string      `yaml:"base_url,omitempty" jsonschema:"description=Base URL for converting root-relative paths to absolute URLs"`
	Logo          *LogoConfig `yaml:"logo,omitempty" jsonschema:"description=Optional logo generation configuration"`
}

type SchemaInput struct {
	Path  string `yaml:"path" jsonschema:"description=Path to the schema file"`
	Title string `yaml:"title,omitempty" jsonschema:"description=Title for the H2 section"`
}

type SectionConfig struct {
	Name             string             `yaml:"name" jsonschema:"description=Unique identifier for this section"`
	Title            string             `yaml:"title" jsonschema:"description=Display title for the section"`
	Order            int                `yaml:"order" jsonschema:"description=Order in which the section appears"`
	Schemas          []SchemaInput      `yaml:"schemas,omitempty" jsonschema:"description=List of schemas to aggregate into one page (for schema_to_md type)"`
	DocSources       []DocSectionSource `yaml:"doc_sources,omitempty" jsonschema:"description=Sources for pulling from generated package docs (for doc_sections type)"`
	Status           string             `` /* 147-byte string literal not displayed */
	Prompt           string             `yaml:"prompt,omitempty" jsonschema:"description=Path to the LLM prompt file"`
	Output           string             `yaml:"output" jsonschema:"description=Output markdown filename"`
	OutputDir        string             `yaml:"output_dir,omitempty" jsonschema:"description=Output directory name for sections mode"`
	JSONKey          string             `yaml:"json_key,omitempty" jsonschema:"description=Key for structured JSON output"`
	Type             string             `` /* 209-byte string literal not displayed */
	Source           string             `` /* 234-byte string literal not displayed */
	Binary           string             `yaml:"binary,omitempty" jsonschema:"description=Binary name for capture type"`
	Format           string             `` /* 129-byte string literal not displayed */
	Depth            int                `yaml:"depth,omitempty" jsonschema:"description=Recursion depth for capture type (default: 5)"`
	SubcommandOrder  []string           `yaml:"subcommand_order,omitempty" jsonschema:"description=Priority order for subcommands (rest alphabetical)"`
	Model            string             `yaml:"model,omitempty" jsonschema:"description=Per-section model override"`
	AggStripLines    int                `yaml:"agg_strip_lines,omitempty" jsonschema:"description=Number of lines to strip from the top during aggregation"`
	GenerationConfig `yaml:",inline"`
}

type SettingsConfig struct {
	Model                string   `yaml:"model,omitempty" jsonschema:"description=LLM model to use for generation"`
	OutputMode           string   `` /* 143-byte string literal not displayed */
	Ecosystems           []string `yaml:"ecosystems,omitempty" jsonschema:"description=List of ecosystem names to aggregate from"`
	RegenerationMode     string   `` /* 127-byte string literal not displayed */
	RulesFile            string   `yaml:"rules_file,omitempty" jsonschema:"description=Custom rules file for cx generate"`
	StructuredOutputFile string   `yaml:"structured_output_file,omitempty" jsonschema:"description=Path for JSON output"`
	SystemPrompt         string   `yaml:"system_prompt,omitempty" jsonschema:"description=Path to system prompt file or 'default' to use built-in"`
	OutputDir            string   `yaml:"output_dir,omitempty" jsonschema:"description=Output directory for generated docs"`
	TocDepth             int      `yaml:"toc_depth,omitempty" jsonschema:"description=Maximum heading level to show in Table of Contents (default: 3)"`
	GenerationConfig     `yaml:",inline"`
}

type SidebarCategory struct {
	Icon     string   `yaml:"icon,omitempty" jsonschema:"description=Nerd font icon for the category"`
	Flat     bool     `yaml:"flat,omitempty" jsonschema:"description=If true, show docs flat without package nesting"`
	Packages []string `yaml:"packages,omitempty" jsonschema:"description=Order of packages within this category"`
}

type SidebarConfig struct {
	CategoryOrder           []string                   `yaml:"category_order,omitempty" jsonschema:"description=Order of categories in sidebar"`
	Categories              map[string]SidebarCategory `yaml:"categories,omitempty" jsonschema:"description=Category configuration (icon, flat, packages order)"`
	Packages                map[string]SidebarPackage  `yaml:"packages,omitempty" jsonschema:"description=Package configuration (icon, color, status)"`
	PackageCategoryOverride map[string]string          `yaml:"package_category_override,omitempty" jsonschema:"description=Remap packages to different categories"`
}

type SidebarPackage struct {
	Icon   string `yaml:"icon,omitempty" jsonschema:"description=Nerd font icon for the package"`
	Color  string `yaml:"color,omitempty" jsonschema:"description=Color name (green, blue, cyan, etc.)"`
	Status string `` /* 130-byte string literal not displayed */
}