keyboard

type Handler struct {

	// Output channels (plain Go channels)
	Keys  chan string // Parsed key events ("a", "M-a", "F1", etc.)
	Lines chan []byte // Assembled lines

	// Callbacks (optional, called in addition to channel sends)
	OnKey        func(key string)       // Called on each key event
	OnLine       func(line []byte)      // Called on each completed line
	OnPaste      func(content []byte)   // Called on bracketed paste content (complete)
	OnPasteChunk func(chunk PasteChunk) // Called on incremental paste chunks
	// contains filtered or unexported fields
}

type Options struct {
	// InputReader is the source of raw bytes (required)
	InputReader io.Reader

	// EchoWriter is where to echo typed characters during line mode (optional)
	EchoWriter io.Writer

	// KeyBufferSize is the size of the Keys channel buffer (default: 64)
	KeyBufferSize int

	// LineBufferSize is the size of the Lines channel buffer (default: 16)
	LineBufferSize int

	// PasteChunkSize is the size of chunks emitted during bracketed paste (default: 1024)
	// Only used when OnPasteChunk callback is set
	PasteChunkSize int

	// DecodeMacOSOption enables decoding of macOS Option+key Unicode characters
	// to M-key notation (e.g., ∂ → M-d, Ø → M-O). Default: true on Darwin, false otherwise
	DecodeMacOSOption *bool

	// DebugFn is called with debug messages (optional)
	DebugFn func(string)

	// ManageTerminal controls whether to put stdin in raw mode.
	// Only applies if InputReader is os.Stdin and is a terminal.
	// Default: true
	ManageTerminal *bool
}

type PasteChunk struct {
	Content []byte // The chunk content
	IsFinal bool   // True if this is the final chunk
}