form

type CancelledMsg struct{}

type ConfirmOptions struct {
	Key, Label string
	Initial    bool

	// Validate reports why the answer is unacceptable, or nil. A yes/no
	// always has a value, so there is no Required — express "must accept"
	// here instead.
	Validate func(any) error
}

type Field interface {
	Key() string
	Update(tea.Msg) (Field, tea.Cmd)
	// View renders the field into the given rect. Fields that occupy a
	// fixed number of rows may ignore r.H and use their own. focused tells
	// the field whether it currently owns input — fields use it to flip
	// border colors and expand inline (e.g. Select shows all options when
	// focused).
	View(r geom.Rect, focused bool) string
	// Rect reports where the field last rendered, so the form can work out
	// which one a click landed in.
	Rect() geom.Rect
	// SetRect records that area. The form calls it after rendering, because
	// a field's height is only known once it has drawn — handing every
	// field the form's full height would overlap them all and make a click
	// resolve to whichever the search reached first.
	SetRect(geom.Rect)
	Value() any
	// Validate reports why the field's current value is unacceptable, or
	// nil when it is fine.
	Validate() error
	// SetError shows err on the field; nil clears it. The form calls this,
	// so a field never decides on its own when to complain.
	SetError(err error)
	Focus() tea.Cmd
	Blur()
	SetStyles(*Styles)
	// Help returns the keys this field responds to — typically delegates
	// to the embedded component's Help().
	Help() []key.Binding
}

type InvalidMsg struct{ Keys []string }

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

type Options struct {
	Width, Height int
	Fields        []Field
	// SubmitText is the label on the submit button. Defaults to "Submit".
	SubmitText string
	// FieldSpacing is the number of blank lines between adjacent fields and
	// before the submit button. Defaults to 0 (borders touch). Set higher
	// for a looser layout.
	FieldSpacing *int
	Styles       Styles
}

type SelectOptions struct {
	Key, Label string
	Options    []string
	Initial    int // initial cursor index
	// Height is the total field height including borders. Defaults to
	// min(len(Options)+2, 6) — i.e. auto-fit up to 4 visible rows; longer
	// option lists scroll within the fixed height.
	Height int

	// RequirePick starts the select with nothing highlighted and rejects
	// submission until the user chooses. A select always has a cursor
	// otherwise, so "required" for it means "must be picked deliberately"
	// rather than "must be non-empty". The label gains a "*".
	RequirePick bool
	// Validate reports why the chosen option is unacceptable, or nil.
	Validate func(any) error
}

type Styles struct {
	// Input styles the text inside text fields (mapped to input.TextStyle).
	Input lipgloss.Style
	// Placeholder styles the placeholder text inside empty text fields.
	Placeholder lipgloss.Style
	// CursorColor is the foreground for the text-input cursor glyph.
	CursorColor lipgloss.TerminalColor

	// Selected styles the active item in Select and the chosen side of Confirm.
	Selected lipgloss.Style

	// PaneActive / PaneInactive color the field's border. Forwarded to each
	// field's pane (input.SetActiveColor / SetInactiveColor or pane defaults).
	PaneActive   lipgloss.TerminalColor
	PaneInactive lipgloss.TerminalColor

	// ErrorColor tints a field's border while it is showing a validation
	// error, regardless of focus — an invalid field is invalid whether or
	// not you are standing on it.
	ErrorColor lipgloss.TerminalColor
	// ErrorText styles the message rendered on the field's border.
	ErrorText lipgloss.Style

	// Submit and SubmitActive style the submit button (unfocused / focused).
	Submit       lipgloss.Style
	SubmitActive lipgloss.Style
}

type SubmittedMsg struct{ Values map[string]any }

type TextOptions struct {
	Key, Label, Placeholder, Initial string

	// Required rejects an empty value. The label gains a "*" so the
	// obligation is visible before anyone submits.
	Required bool
	// Validate reports why the value is unacceptable, or nil. Runs after
	// Required, so a blank required field says "required" rather than
	// whatever a format check would say about "".
	Validate func(any) error
}