repl

type Candidate struct {
	// Text is the full text that should replace the range from
	// PrefixStart to the cursor when this candidate is chosen.
	Text string

	// Display is an optional label shown in a completion popup.
	// v1 doesn't render a popup; Text is used everywhere. Reserved
	// for future use.
	Display string

	// Kind is an optional semantic tag ("function", "table",
	// "module", ...). Currently informational only.
	Kind string
}

type Completer func(mode, input string, cursorPos int) (candidates []Candidate, prefixStart int)

type Evaluator func(mode, line string) Result

type Mode struct {
	// Name is what gets passed to the Evaluator. Required and
	// unique within Options.Modes.
	Name string

	// Activator is the rune that switches TO this mode when typed
	// on an empty prompt. Zero means the mode is not
	// user-selectable (e.g. a default that only reachable via
	// backspace).
	Activator rune

	// Prompt is the string rendered before the input line while
	// this mode is active, e.g. "myapp(teal)> ".
	Prompt string

	// ContinuationPrompt is rendered when the previous submission
	// returned Result.Incomplete, so the user sees that their input
	// is being buffered. When empty, defaults to Prompt — typically
	// callers pass a same-width variant that swaps "> " for ". "
	// or "... " so column alignment is preserved.
	ContinuationPrompt string

	// PromptColor, when non-nil, overrides the base Styles.Prompt's
	// foreground for this mode. Any nil defers to the base style.
	PromptColor lipgloss.TerminalColor
}

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

type Options struct {
	// Prompt is the string shown before the input line when Modes
	// is empty (single-mode REPL). Defaults to "> ". Ignored when
	// Modes is set — each mode carries its own prompt.
	Prompt string

	// ContinuationPrompt is used in single-mode configurations when
	// the previous submission returned Result.Incomplete. Defaults
	// to Prompt (so continuation is visually indistinguishable
	// unless the caller sets this to something like "... ").
	ContinuationPrompt string

	// Completer, when non-nil, is called on Tab to compute
	// completions for the current input line. See Completer's
	// godoc for the contract.
	Completer Completer

	// Banner is optional multi-line text printed above the first
	// prompt. Newlines are respected.
	Banner string

	// Evaluator is called for each submitted line. Required.
	Evaluator Evaluator

	// Modes are the switchable modes. The first mode is the
	// default; users switch to another mode by typing its
	// Activator rune on an empty prompt, and return to the default
	// by pressing Backspace on an empty prompt.
	//
	// Empty means single-mode: the evaluator sees mode="" and
	// Prompt/Banner behave as before.
	Modes []Mode

	// HistoryLimit caps the in-memory command history. 0 or
	// negative means unlimited.
	HistoryLimit int
}

type Result struct {
	// Output is normal (stdout-like) content, rendered in the
	// default style.
	Output string

	// Err is error-like content, rendered in the error style
	// (a subdued red by default).
	Err string

	// Exit requests the REPL loop to terminate cleanly.
	Exit bool

	// Incomplete signals that the submitted input is syntactically
	// incomplete — e.g. an unclosed function block or table literal.
	// The REPL switches to a continuation prompt and buffers the
	// user's next line onto the current one instead of evaluating.
	// Output and Err are ignored when Incomplete is true.
	Incomplete bool
}

type Styles struct {
	Prompt lipgloss.Style
	Input  lipgloss.Style
	Output lipgloss.Style
	Error  lipgloss.Style
	Banner lipgloss.Style
}