changelog

type ChangeLog struct {
	Module         changeentry.ModuleConfig
	InvalidEntries []InvalidEntry
	Groups         []VersionGroup
}

type EntryWithMeta struct {
	Entry            changeentry.Entry
	Module           changeentry.ModuleConfig
	Path             string    // absolute path to the .md file
	AddedAt          time.Time // author date of the commit that first added the file
	AddedCommitHash  string    // commit hash where the file was first introduced
	OriginalFilename string    // filename at first introduction
	HasGit           bool      // false when the file is untracked or git is unavailable
	Version          string    // "staging" or a version tag name / pinned release value
}

type FilterOptions struct {
	Audience  string // keep only entries whose audience list contains this value
	Component string // keep only entries whose component list contains this value
	Type      string // keep only entries whose type matches this value
}

type InvalidEntry struct {
	Path   string
	Errors []error
}

type LogHints struct {
	LatestTag string
	NextTag   string
}

type Resource struct {
	AbsPath string `json:"abs_path"`
	RelPath string `json:"rel_path"`
	EntryID string `json:"entry_id"`
}

type TypeGroup struct {
	ChangeType changeentry.ChangeType
	Title      string
	Entries    []EntryWithMeta
}

type VersionFilterOptions struct {
	N           int    // max tagged releases to include (0 = all)
	ShowStaging bool   // include staging group
	OnlyStaging bool   // include only staging group
	Since       string // lower version boundary (inclusive)
}

type VersionGroup struct {
	Version    string      // "staging" or a version tag/release name
	Tag        *semver.Tag // nil for staging and pinned-but-untagged versions
	TypeGroups []TypeGroup
}