editor

type CancelMsg struct{}

type Completion struct {
	View   string
	Insert string
}

type CompletionContext struct {
	Line int
	Col  int

	// Lines is a snapshot of the whole buffer at trigger time, one
	// entry per row. Providers that need sibling context — e.g. a
	// `reasoning:` completer that wants to read the `model:` line
	// above it — scan this. Read-only; do not mutate.
	Lines []string
}

type CompletionProvider func(prefix string, ctx CompletionContext) []Completion

type LineStyler func(lineNum int, content string) []StyledSpan

type Model struct {
	// contains filtered or unexported fields
}

type Options struct {
	// Title appears in the header bar. Defaults to "Editor".
	Title string

	// InitialValue is the buffer text on open. May be empty.
	InitialValue string

	// OnSave validates the buffer when the user hits Ctrl+S. Required;
	// passing nil here defaults to a no-op validator that always
	// allows save (useful for free-form edits like /config edit).
	OnSave Validator

	// LineStyler is the per-line render hook. nil in B.2a.
	LineStyler LineStyler

	// Triggers maps a literal substring (e.g. "${secret:") to its
	// completion provider. nil/empty in B.2a.
	Triggers map[string]CompletionProvider

	// RequireSaveConfirm, when true, makes Ctrl+S open a "Apply
	// changes? [y/N]" prompt before running OnSave. Use this for
	// editors that mutate critical state (config upserts).
	RequireSaveConfirm bool

	// Styles overrides the editor's visual palette. nil uses DefaultStyles().
	Styles *Styles
}

type SaveMsg struct {
	// Value is the full buffer text, joined with '\n' line separators
	// and WITHOUT a trailing newline. Callers that need POSIX-style
	// "final newline" semantics should add one explicitly.
	Value string
}

type StyledSpan struct {
	From  int
	To    int
	Style lipgloss.Style
}

type Styles struct {
	// Header and footer band (background + foreground + padding).
	Header lipgloss.Style
	// Gutter is the line-number column style.
	Gutter lipgloss.Style
	// ErrorLine is the validation-error footer style.
	ErrorLine lipgloss.Style
	// Selection is the highlighted text style.
	Selection lipgloss.Style
	// Cursor is the block cursor style.
	Cursor lipgloss.Style
	// SearchMatch styles a non-current search hit.
	SearchMatch lipgloss.Style
	// SearchCurrentMatch styles the active search hit.
	SearchCurrentMatch lipgloss.Style
	// Modal chrome colors for in-editor prompts (discard/save/help).
	ModalBorder  color.Color
	ModalTitleBg color.Color
	ModalTitleFg color.Color
	ModalText    color.Color
	ModalDim     color.Color
	// Completer popup colors.
	CompleterBg     color.Color
	CompleterSelBg  color.Color
	CompleterFg     color.Color
	CompleterDim    color.Color
	CompleterAccent color.Color
	CompleterBorder color.Color
}

type Validator func(buffer string) []error