app

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

type CommandCandidate struct {
	Show  string
	Apply string
}

type CommandCompleter interface {
	Suggest(line string) []CommandCandidate
}

type Completer interface {
	Complete(query string) []string
	Accepted(item string)
}

type Config struct {
	// Input is the terminal's raw byte stream (stdin in raw mode). The shell
	// stops when it reaches EOF or when Quit is called; closing Input is the
	// caller's responsibility and is what unblocks a pending read.
	Input io.Reader
	// Output receives frames (stdout). Writes are single buffered frames
	// wrapped in synchronized output.
	Output io.Writer
	// Timing is the shell's source of time (frame pacing, the escape-key
	// delay). Nil means the system clock.
	Timing clock.Timing
	// Width and Height are the terminal's size in cells at startup; resizes
	// arrive later through Resize. Zero values default to 80 by 24.
	Width, Height int
	// Theme styles the shell's own chrome (the prompt gutter, the status
	// line, the placeholder). Nil means the default theme.
	Theme *theme.Theme
	// FrameInterval is the minimum time between repaints. Zero means about
	// sixty frames per second.
	FrameInterval time.Duration
	// EscDelay is how long a lone Escape byte may dangle before it resolves
	// as the Escape key rather than the start of a sequence. Zero means 50ms.
	EscDelay time.Duration
	// Placeholder is the hint shown in the empty composer.
	Placeholder string
	// Keymap is the composer's key bindings. Nil means the default map;
	// build a custom one with editor.LoadKeymap.
	Keymap editor.Keymap
	// AltScreen selects the alternate-screen renderer instead of the default
	// inline one. The inline renderer commits the transcript to the terminal's
	// own scrollback and is the right choice almost everywhere; the alternate
	// screen is the fallback for emulators where inline scroll-region insertion
	// is unsafe (Zellij-class multiplexers). The caller enters and leaves the
	// alternate screen around Run (through the term package) when this is set.
	AltScreen bool

	// OnSubmit receives each submitted prompt: the prompt text and the images
	// attached to it (nil when there are none), in the order their chips
	// appeared. It runs on the event loop goroutine with no locks held; long
	// work belongs on the host's own goroutine, which reports back through
	// Append, SetLive, and SetStatus.
	OnSubmit func(text string, images []editor.Attachment)
	// OnEsc fires when Escape is pressed. The host owns what Escape means:
	// interrupt the in-flight turn, dismiss a panel, nothing.
	OnEsc func()
	// OnKey receives keys neither the editor nor a named hook claimed.
	// Return true to consume the key; unconsumed keys fall through to the
	// shell's defaults (Ctrl+C).
	OnKey func(k input.Key) bool
	// Completer supplies @-completion candidates. The shell owns the popup
	// (tracking the token at the cursor, navigation, accept, dismiss); the
	// host owns the universe being completed over. Nil disables completion.
	// Both methods run on the event loop goroutine with no locks held, so
	// Complete must be fast; slow indexing belongs behind a host-built cache.
	Completer Completer
	// Commands supplies completion for a slash-command line. A slashed line has no
	// trigger token the way an @-mention does, so command and argument completion look
	// at the whole composer line instead: given that line, Suggest returns the
	// candidates to replace it with. Nil disables slash-command completion.
	Commands CommandCompleter
	// Marker maps the composer's current content to its first-row gutter
	// marker, so the host can surface an input mode the content selects
	// ("! " while the prompt is a shell command). Empty selects the default
	// prompt marker; a non-empty marker is fitted to the gutter's width. It
	// runs on the paint goroutine under the shell's lock, so it must be a
	// fast pure function of its argument. Nil always uses the default.
	Marker func(content string) string
}