modfile

type Comment struct {
	Start  Position
	Token  string // without trailing newline
	Suffix bool   // an end of line (not whole line) comment
}

type CommentBlock struct {
	Comments
	Start Position
}

type Comments struct {
	Before []Comment // whole-line comments before this expression
	Suffix []Comment // end-of-line comments after this expression

	// For top-level expressions only, After lists whole-line
	// comments following the expression.
	After []Comment
}

type Exclude struct {
	Mod    module.Version
	Syntax *Line
}

type Expr interface {
	// Span returns the start and end position of the expression,
	// excluding leading or trailing comments.
	Span() (start, end Position)

	// Comment returns the comments attached to the expression.
	// This method would normally be named 'Comments' but that
	// would interfere with embedding a type of the same name.
	Comment() *Comments
}

type File struct {
	Module  *Module
	Require []*Require
	Exclude []*Exclude
	Replace []*Replace

	Syntax *FileSyntax
}

type FileSyntax struct {
	Name string // file path
	Comments
	Stmt []Expr
}

type LParen struct {
	Comments
	Pos Position
}

type Line struct {
	Comments
	Start   Position
	Token   []string
	InBlock bool
	End     Position
}

type LineBlock struct {
	Comments
	Start  Position
	LParen LParen
	Token  []string
	Line   []*Line
	RParen RParen
}

type Module struct {
	Mod    module.Version
	Syntax *Line
}

type Position struct {
	Line     int // line in input (starting at 1)
	LineRune int // rune in line (starting at 1)
	Byte     int // byte in input (starting at 0)
}

type RParen struct {
	Comments
	Pos Position
}

type Replace struct {
	Old    module.Version
	New    module.Version
	Syntax *Line
}

type Require struct {
	Mod      module.Version
	Indirect bool // has "// indirect" comment
	Syntax   *Line
}

type VersionFixer func(path, version string) (string, error)