textinput

type AreaKeyMap struct {
	MoveBackward           []string
	MoveForward            []string
	MoveWordBackward       []string
	MoveWordForward        []string
	MoveUp                 []string
	MoveDown               []string
	JumpToLineBeginning    []string
	JumpToLineEnd          []string
	JumpToBeginning        []string
	JumpToEnd              []string
	DeleteBeforeCursor     []string
	DeleteWordBeforeCursor []string
	DeleteUnderCursor      []string
	DeleteWordAfterCursor  []string
	DeleteAllAfterCursor   []string
	DeleteAllBeforeCursor  []string
	InsertNewline          []string
	Paste                  []string
	Submit                 []string
	Abort                  []string
}

type AreaModel struct {
	*TextArea

	// Err holds errors that may occur during the execution of the text area.
	Err error

	// MaxWidth limits the width of the view using the TextArea's WrapMode.
	MaxWidth int
	// contains filtered or unexported fields
}

type KeyMap struct {
	MoveBackward           []string
	MoveForward            []string
	JumpToBeginning        []string
	JumpToEnd              []string
	DeleteBeforeCursor     []string
	DeleteWordBeforeCursor []string
	DeleteUnderCursor      []string
	DeleteAllAfterCursor   []string
	DeleteAllBeforeCursor  []string
	AutoComplete           []string
	Paste                  []string
	Clear                  []string
	Reset                  []string
	Submit                 []string
	Abort                  []string
}

type Model struct {
	*TextInput

	// Err holds errors that may occur during the execution of
	// the textinput.
	Err error

	// MaxWidth limits the width of the view using the TextInput's WrapMode.
	MaxWidth int
	// contains filtered or unexported fields
}

type TextArea struct {
	// Prompt holds the prompt text or question that is printed above the
	// text area in the default template (if not empty).
	Prompt string

	// Placeholder holds the text that is displayed in the text area when no
	// input has been entered yet.
	Placeholder string

	// InitialValue sets the initial content of the text area, as if it had
	// been entered by the user. This can be used to provide an editable
	// default value.
	InitialValue string

	// Validate is a function that validates whether the current input is
	// valid. If it is not, the data cannot be submitted. By default, Validate
	// ensures that the input is not empty. If Validate is set to nil, no
	// validation is performed.
	Validate func(string) error

	// CharLimit is the maximum number of characters this text area will
	// accept. If 0 or less, there is no limit.
	CharLimit int

	// Height is the number of visible rows in the text area. If 0 or less,
	// the text area automatically expands and contracts to fit the content.
	// Defaults to 0 (auto-expand). Set to DefaultAreaHeight or another
	// positive value for a fixed-height text area.
	Height int

	// ShowLineNumbers specifies whether line numbers are displayed. Defaults
	// to false.
	ShowLineNumbers bool

	// Template holds the display template. A custom template can be used to
	// completely customize the appearance of the text area. If empty,
	// DefaultAreaTemplate is used. The following variables and functions are
	// available:
	//
	//  * Prompt string: The configured prompt.
	//  * InitialValue string: The configured initial value.
	//  * Placeholder string: The configured placeholder.
	//  * Input string: The rendered text area widget.
	//  * ValidationError error: The error returned by Validate.
	//  * TerminalWidth int: The width of the terminal.
	//  * KeyMap *AreaKeyMap: The configured key map.
	//  * promptkit.UtilFuncMap: Handy helper functions.
	//  * termenv TemplateFuncs (see https://github.com/muesli/termenv).
	//  * The functions specified in ExtendedTemplateFuncs.
	Template string

	// ResultTemplate is rendered once input has been confirmed. It is
	// intended to permanently indicate the result of the prompt. This
	// template is only rendered in RunPrompt() and NOT when the text area is
	// used as a model. The following variables and functions are available:
	//
	//  * FinalValue string: The submitted text.
	//  * Prompt string: The configured prompt.
	//  * InitialValue string: The configured initial value.
	//  * Placeholder string: The configured placeholder.
	//  * TerminalWidth int: The width of the terminal.
	//  * promptkit.UtilFuncMap: Handy helper functions.
	//  * termenv TemplateFuncs (see https://github.com/muesli/termenv).
	//  * The functions specified in ExtendedTemplateFuncs.
	ResultTemplate string

	// ExtendedTemplateFuncs can be used to add additional functions to the
	// evaluation scope of the templates.
	ExtendedTemplateFuncs template.FuncMap

	// InputTextStyle is the style applied to the text in the text area.
	InputTextStyle lipgloss.Style

	// InputPlaceholderStyle is the style applied to the placeholder text.
	InputPlaceholderStyle lipgloss.Style

	// KeyMap determines with which keys the text area is controlled. By
	// default, NewDefaultAreaKeyMap() is used.
	KeyMap *AreaKeyMap

	// WrapMode decides which way the prompt view is wrapped if it does not
	// fit the terminal. It can be a WrapMode provided by promptkit or a
	// custom function. By default it is promptkit.WordWrap. It can also be
	// nil which disables wrapping and likely causes output glitches.
	WrapMode promptkit.WrapMode

	// Output is the output writer, by default os.Stdout is used.
	Output io.Writer
	// Input is the input reader, by default os.Stdin is used.
	Input io.Reader

	// ColorProfile determines how colors are rendered. By default, the
	// terminal is queried.
	ColorProfile termenv.Profile
}

type TextInput struct {
	// Prompt holds the prompt text or question that is printed above the
	// choices in the default template (if not empty).
	Prompt string

	// Placeholder holds the text that is displayed in the input field when the
	// input data is empty, e.g. when no text was entered yet.
	Placeholder string

	// InitialValue is similar to Placeholder, however, the actual input data is
	// set to InitialValue such that as if it was entered by the user. This can
	// be used to provide an editable default value.
	InitialValue string

	// Validate is a function that validates whether the current input data is
	// valid. If it is not, the data cannot be submitted. By default, Validate
	// ensures that the input data is not empty. If Validate is set to nil, no
	// validation is performed.
	Validate func(string) error

	// AutoComplete is a function that suggests multiple candidates for
	// auto-completion based on a given input. If it returns only a single
	// candidate, this candidate is auto-completed. If it returns multiple
	// candidates, these candidates may be displayed in custom templates using
	// the variables AutoCompleteTriggered, AutoCompleteIndecisive as well as
	// the function AutoCompleteSuggestions. If AutoComplete is nil, no
	// auto-completion is performed.
	AutoComplete func(string) []string

	// Hidden specified whether or not the input data is considered secret and
	// should be masked. This is useful for password prompts.
	Hidden bool

	// HideMask specified the character with which the input data should be
	// masked when Hidden is set to true.
	HideMask rune

	// CharLimit is the maximum amount of characters this input element will
	// accept. If 0 or less, there's no limit.
	CharLimit int

	// InputWidth is the maximum number of characters that can be displayed at
	// once. It essentially treats the text field like a horizontally scrolling
	// viewport. If 0 or less this setting is ignored.
	InputWidth int

	// Template holds the display template. A custom template can be used to
	// completely customize the appearance of the text input. If empty,
	// the DefaultTemplate is used. The following variables and functions are
	// available:
	//
	//  * Prompt string: The configured prompt.
	//  * InitialValue string: The configured initial value of the input.
	//  * Placeholder string: The configured placeholder of the input.
	//  * Input string: The actual input field.
	//  * InputValue string: The raw current input value.
	//  * ValidationError error: The error value returned by Validate.
	//    to the configured Validate function.
	//  * TerminalWidth int: The width of the terminal.
	//  * AutoCompleteTriggered bool: An indication that auto-complete was
	//    just triggered by the user. It resets after further input.
	//  * AutoCompleteIndecisive bool: An indication that auto-complete was
	//    just triggered by the user with an indecisive result. It resets
	//    after further input.
	//  * CursorOffset int: The column offset of the cursor in the current line,
	//    useful for aligning content below the input.
	//  * AutoCompleteSuggestions() []string: A function that returns the
	//    auto-complete suggestions for the current input.
	//  * KeyMap *KeyMap: The configured key map.
	//  * promptkit.UtilFuncMap: Handy helper functions.
	//  * termenv TemplateFuncs (see https://github.com/muesli/termenv).
	//  * The functions specified in ExtendedTemplateFuncs.
	Template string

	// ResultTemplate is rendered as soon as a input has been confirmed.
	// It is intended to permanently indicate the result of the prompt when the
	// input itself has disappeared. This template is only rendered in the Run()
	// method and NOT when the text input is used as a model. The following
	// variables and functions are available:
	//
	//  * FinalChoice: The choice that was selected by the user.
	//  * Prompt string: The configured prompt.
	//  * InitialValue string: The configured initial value of the input.
	//  * Placeholder string: The configured placeholder of the input.
	//  * InputValue string: The raw current input value.
	//  * TerminalWidth int: The width of the terminal.
	//  * AutoCompleteTriggered bool: An indication that auto-complete was
	//    just triggered by the user. It resets after further input.
	//  * AutoCompleteIndecisive bool: An indication that auto-complete was
	//    just triggered by the user with an indecisive result. It resets
	//    after further input.
	//  * CursorOffset int: The column offset of the cursor in the current line,
	//    useful for aligning content below the input.
	//  * AutoCompleteSuggestions() []string: A function that returns the
	//    auto-complete suggestions for the current input.
	//  * Mask(string) string: A function that replaces all characters of
	//    a string with the character specified in HideMask if Hidden is
	//    true and returns the input string if Hidden is false.
	//  * promptkit.UtilFuncMap: Handy helper functions.
	//  * termenv TemplateFuncs (see https://github.com/muesli/termenv).
	//  * The functions specified in ExtendedTemplateFuncs.
	ResultTemplate string

	// ExtendedTemplateFuncs can be used to add additional functions to the
	// evaluation scope of the templates.
	ExtendedTemplateFuncs template.FuncMap

	// Styles of the actual input field. These will be applied as inline styles.
	//
	// For an introduction to styling with Lip Gloss see:
	// https://github.com/charmbracelet/lipgloss
	InputTextStyle        lipgloss.Style
	InputBackgroundStyle  lipgloss.Style // Deprecated: This property is not used anymore.
	InputPlaceholderStyle lipgloss.Style
	InputCursorStyle      lipgloss.Style

	// KeyMap determines with which keys the text input is controlled. By
	// default, DefaultKeyMap is used.
	KeyMap *KeyMap

	// WrapMode decides which way the prompt view is wrapped if it does not fit
	// the terminal. It can be a WrapMode provided by promptkit or a custom
	// function. By default it is promptkit.WordWrap. It can also be nil which
	// disables wrapping and likely causes output glitches.
	WrapMode promptkit.WrapMode

	// Output is the output writer, by default os.Stdout is used.
	Output io.Writer
	// Input is the input reader, by default, os.Stdin is used.
	Input io.Reader

	// ColorProfile determines how colors are rendered. By default, the terminal
	// is queried.
	ColorProfile termenv.Profile
}