renderer

type Config struct {
	Preset             string   // default, minimal, full, core, standard
	MaxTier            string   // optional tier override
	Locale             string   // optional BCP 47 locale tag override
	LocaleOverrides    string   // optional path to locale override JSON file
	AllReleases        bool     // include all releases (overrides default notable-only)
	NotableCategories  []string // custom notable categories (uses default if empty)
	ExcludeCategories  []string // categories to omit entirely (appended to preset)
	CollapseCategories []string // categories to render as a summary line (appended to preset)
	ExpandCategories   []string // categories to force-expand, overriding preset collapse defaults
}

type Options struct {
	// IncludeReferences includes issue/PR links in entries.
	IncludeReferences bool

	// IncludeCommits includes commit SHAs in references.
	IncludeCommits bool

	// LinkReferences creates hyperlinks for issues, PRs, and commits
	// when a repository URL is available. Requires IncludeReferences.
	LinkReferences bool

	// IncludeAuthors appends author attribution for external contributors.
	// Authors listed in Changelog.Maintainers or known bots are excluded.
	IncludeAuthors bool

	// IncludeSecurityMetadata includes CVE/GHSA/severity in security entries.
	IncludeSecurityMetadata bool

	// MarkBreakingChanges prefixes breaking changes with **BREAKING:**.
	MarkBreakingChanges bool

	// IncludeCompareLinks adds version comparison links at the bottom.
	IncludeCompareLinks bool

	// IncludeUnreleasedLink adds an [Unreleased] link comparing latest version to HEAD.
	// This lets users see what's been merged since the last release.
	IncludeUnreleasedLink bool

	// CompactMaintenanceReleases groups consecutive maintenance-only releases
	// (those with only dependencies, documentation, build, tests, internal changes)
	// into a single compact section like "## Versions 0.71.1 - 0.71.10 (Maintenance)".
	CompactMaintenanceReleases bool

	// MaxTier filters change types to include only those at or above this tier.
	// Default is TierOptional (include all).
	MaxTier changelog.Tier

	// Locale specifies the BCP 47 locale tag for output (e.g., "en", "fr", "de").
	// Default is "en" (English).
	Locale string

	// LocaleOverrides specifies a path to a JSON file with locale message overrides.
	// Only the messages specified in this file will be replaced; others use defaults.
	LocaleOverrides string

	// NotableOnly when true, only includes releases that are considered "notable"
	// according to the NotabilityPolicy. Non-notable releases (maintenance-only)
	// are excluded from the output entirely.
	NotableOnly bool

	// NotabilityPolicy defines which categories make a release notable.
	// If nil and NotableOnly is true, uses DefaultNotabilityPolicy().
	NotabilityPolicy *changelog.NotabilityPolicy

	// ExcludeCategories lists category names to omit entirely from the output
	// (e.g. "Dependencies"). Excluded categories produce no section at all.
	// This applies on top of MaxTier filtering.
	ExcludeCategories []string

	// CollapseCategories lists category names to render as a single summary
	// line (an entry count) instead of listing every entry. This preserves the
	// signal that maintenance occurred without the noise of a long list; the
	// full detail remains in the JSON source. ExcludeCategories takes
	// precedence: a category in both is omitted, not collapsed.
	CollapseCategories []string
}