form

type Autocomplete struct {
	// Trigger starts a completion token at a word boundary, e.g. '@'. Zero
	// means bare mode: every trailing token completes and an acceptance
	// replaces the token as-is — for value lists rather than mentions.
	Trigger rune
	// MinQuery is how many runes must follow the trigger before fetching;
	// zero means 1, so a bare trigger never fires a fetch.
	MinQuery int
	// IsBoundary marks the runes that end a token; nil means whitespace.
	// A comma-separated field adds ',' so each list entry completes alone.
	IsBoundary func(r rune) bool
	// Fetch resolves a query to suggestions. It runs inside a tea.Cmd (its
	// own goroutine), so it may block on I/O; the result is dropped if the
	// query has moved on by the time it lands.
	Fetch func(query string) []Suggestion
}

type Config struct {
	// Title renders above the fields (e.g. "comment on PROJ-1").
	Title  string
	Fields []FieldSpec
	// EditorHatch offers ctrl+e on a focused multiline field: the form emits
	// EventEditor and the owner takes the draft to an external editor. The
	// in-TUI field is always the default; the editor is the escape hatch.
	EditorHatch bool
	// Width bounds every field's rendered width.
	Width  int
	Styles Styles
}

type EventKind int

type FieldSpec struct {
	// Label renders above the field; empty omits the row.
	Label string
	// Placeholder shows in the empty field.
	Placeholder string
	// Initial pre-fills the field; the dirty guard compares against it, so a
	// prefilled-then-untouched form still cancels without a confirmation.
	Initial string
	// Multiline makes the field a textarea (enter inserts a newline and
	// ctrl+s submits) instead of a one-line input.
	Multiline bool
	// Rows is the textarea height; zero means 5.
	Rows int
	// Options, when non-empty, makes the field a cycle selector rather than a
	// text input: it holds one of the listed values and ←/→ (or h/l) step
	// through them. Its value is always one of Options, so a required cycle
	// field can never be blank. Initial selects the starting option (the first
	// when Initial matches none). Multiline/Autocomplete are ignored on a
	// cycle field.
	Options []string
	// Notify marks a cycle field whose value changes the owner wants to react
	// to — a project selector that drives a dependent type list, say. When such
	// a field steps to a new value the form returns EventChanged, so the owner
	// can refetch and push new Options back through SetOptions.
	Notify bool
	// Optional lets the field submit blank. A required field left blank
	// blocks the submit and takes focus instead. An Optional field renders an
	// "(optional)" marker on its label so the blank-is-fine contract is visible.
	Optional bool
	// Validate, when set, runs on trySubmit against the field's value. A
	// non-nil error blocks the submit, focuses the field, and renders the
	// message inline beneath it — the same gate the required check uses, but
	// for content the field itself can't express (a duration that won't parse).
	Validate func(string) error
	// Autocomplete, when set, watches this field for its trigger token and
	// offers fetched suggestions. Nil disables the seam.
	Autocomplete *Autocomplete
}

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

type Styles struct {
	Title              lipgloss.Style
	Label              lipgloss.Style
	LabelFocused       lipgloss.Style
	Border             lipgloss.Style // an unfocused field's box border and cycle chevrons
	BorderFocused      lipgloss.Style // the focused field's box border and cycle chevrons
	HintKey            lipgloss.Style
	HintText           lipgloss.Style
	Question           lipgloss.Style // the dirty-discard confirmation
	Suggestion         lipgloss.Style
	SuggestionSelected lipgloss.Style
	Error              lipgloss.Style // field and form-level validation/submit errors
}

type Suggestion struct {
	Value string
	Label string
	// Detail is an opaque payload carried with the suggestion but never
	// inserted into the field — the owner reads it via AcceptedDetail after an
	// acceptance. It lets a readable label (an assignee's display name) stand
	// in the field while the owner keeps the value it maps to (an accountId),
	// so no re-resolve is needed at submit.
	Detail string
}

type SuggestionsMsg struct {
	Field int
	Query string
	Items []Suggestion
}