complete

type Completion struct {

	// completion text: what will actually be inserted if selected
	Text string

	// label to show the user; only used for menu display if non-empty; otherwise Text is used
	Label string

	// icon name
	Icon string

	// extra information, e.g. detailed description, type, arguments, etc; not currently used in Pi, but is used for tooltips in GUI
	Desc string

	// lang specific or other, e.g. class or type
	Extra map[string]string
}

type Completions []Completion

type Edit struct {

	// completion text after special edits
	NewText string

	// number of runes, past the cursor, to delete, if any
	ForwardDelete int

	// cursor adjustment if cursor should be placed in a location other than at end of newText
	CursorAdjust int
}

type EditFunc func(data any, text string, cursorPos int, comp Completion, seed string) Edit

type Lookup struct {

	// if non-empty, the result is to view this file (full path)
	Filename string

	// starting line number within file to display
	StLine int

	// ending line number within file
	EdLine int

	// if filename is empty, this is raw text to display for lookup result
	Text []byte
}

type LookupFunc func(data any, text string, posLn, posCh int) Lookup

type MatchFunc func(data any, text string, posLn, posCh int) Matches

type Matches struct {

	// the matches based on seed
	Matches Completions

	// seed is the prefix we use to find possible completions
	Seed string
}