picker

type Host interface {
	Theme() *theme.Theme
	Size() (width, height int)
	// Line is the shared edit line the search is typed in.
	Line() *lineedit.Line
	// Close closes the open overlay.
	Close()
	// RecordAnswer tells a macro recording the answer to the question of
	// the command that opened the picker, or that it was cancelled.
	RecordAnswer(answer string, cancelled bool)
}

type Item struct {
	Title  string // e.g. "Save as"
	Name   int    // bytes of Title that are searched, e.g. just "SUM" of "SUM(value, ...)"
	Detail string // a dimmed second column, also searched, e.g. the menu path
	Key    string // shortcut, shown as a key chip
	Desc   string // what it does, for the status line
	Off    bool   // unavailable right now
	Pick   func() tea.Cmd
	// Swatch, when set, is drawn before the title as it is, styled: a
	// sample of a color or a line.
	Swatch string
}

type Match struct {
	Item              *Item
	InTitle, InDetail []int
}

type Picker struct {
	overlay.List

	// Action is what Enter does, for the key hints ("run" by default).
	Action string
	Items  []Item

	// Narrow, when set, sees the search first and can narrow the items by
	// it, as "dark" does the themes: it returns the rest of the search,
	// matched against the kept items' titles only, and which items to
	// keep, or a nil keep to search every item as usual.
	Narrow func(query string) (rest string, keep func(*Item) bool)

	// Enter, when set, gets the first look at Enter with the search text,
	// e.g. to take a typed path; it reports whether it handled it.
	Enter func(query string) (tea.Cmd, bool)

	// Answers marks a picker that is the question of a command that
	// changes the workbook: a recording keeps the title picked as the
	// command's answer, and scripts answer it with a title.
	Answers bool

	// At, when set, is where the box's top-left corner goes, as a
	// dropdown opens under its cell; the box stays on screen. Pickers
	// open centered under the menu bar otherwise.
	At *[2]int
	// contains filtered or unexported fields
}