complete

type ArgGenerator func(args []string) ([]RawItem, error)

type CodeBuffer struct {
	Content string
	Dot     int
}

type ComplexItem struct {
	Stem          string   // Used in the code and the menu.
	CodeSuffix    string   // Appended to the code.
	DisplaySuffix string   // Appended to the display.
	DisplayStyle  ui.Style // Use for displaying.
}

type Config struct {
	// An interface to access the runtime. Complete will return an error if this
	// is nil.
	PureEvaler PureEvaler
	// A function for filtering raw candidates. If nil, no filtering is done.
	Filterer Filterer
	// Used to generate candidates for a command argument. Defaults to
	// Filenames.
	ArgGenerator ArgGenerator
}

type Filterer func(ctxName, seed string, rawItems []RawItem) []RawItem

type PlainItem string

type PureEvaler interface {
	EachExternal(func(cmd string))
	EachSpecial(func(special string))
	EachNs(func(string))
	EachVariableInNs(string, func(string))
	PurelyEvalPrimary(pn *parse.Primary) interface{}
	PurelyEvalCompound(*parse.Compound) (string, error)
	PurelyEvalPartialCompound(*parse.Compound, *parse.Indexing) (string, error)
}

type RawItem interface {
	String() string
	Cook(parse.PrimaryType) completion.Item
}

type Result struct {
	Name    string
	Replace diag.Ranging
	Items   []completion.Item
}