backend

type AttrMask uint32

type Backend interface {
	// Init initializes the backend (enters alt screen, raw mode, etc).
	Init() error

	// Fini cleans up the backend (restores terminal state).
	Fini()

	// Size returns the current terminal dimensions.
	Size() (width, height int)

	// SetContent sets a cell at position (x, y) with the given rune and style.
	// The comb parameter contains combining characters (can be nil).
	SetContent(x, y int, mainc rune, comb []rune, style Style)

	// Show synchronizes the internal buffer to the terminal.
	// This is where actual output happens.
	Show()

	// Clear clears the screen.
	Clear()

	// HideCursor hides the terminal cursor.
	HideCursor()

	// ShowCursor shows the terminal cursor.
	ShowCursor()

	// SetCursorPos sets the cursor position.
	SetCursorPos(x, y int)

	// PollEvent blocks until an event is available and returns it.
	// Returns nil if the backend is shutting down.
	PollEvent() terminal.Event

	// PostEvent injects an event into the event queue.
	// Useful for testing and for posting timer/internal events.
	PostEvent(ev terminal.Event) error

	// Beep emits an audible bell.
	Beep()

	// Sync forces a full redraw on next Show().
	Sync()
}

type Cell struct {
	Rune  rune
	Style Style
}

type Color int32

type CursorShape int

type CursorShapeSetter interface {
	SetCursorShape(shape CursorShape)
}

type FrameWriter interface {
	WriteFrame(encoded []byte)
}

type Image struct {
	Width      int
	Height     int
	CellWidth  int
	CellHeight int
	Format     ImageFormat
	Protocol   ImageProtocol
	Pixels     []byte
}

type ImageFormat int

type ImageProtocol int

type ImageTarget interface {
	SetImage(x, y int, img Image)
}

type ImageWriter interface {
	DrawImage(x, y int, img Image)
}

type InlineHeightSetter interface {
	SetInlineHeight(lines int)
}

type InlineModeSetter interface {
	SetInlineMode(enabled bool)
}

type RectWriter interface {
	SetRect(x, y, width, height int, cells []Cell)
}

type RenderTarget interface {
	Size() (width, height int)
	SetContent(x, y int, mainc rune, comb []rune, style Style)
}

type RowWriter interface {
	SetRow(y int, startX int, cells []Cell)
}

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

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

type SyncOutputWriter interface {
	// SetSyncOutput enables or disables synchronized output support.
	// Call this after detecting terminal capabilities.
	SetSyncOutput(enabled bool)

	// SyncOutputSupported reports whether the terminal supports
	// synchronized output (DEC mode 2026).
	SyncOutputSupported() bool

	// BeginSync writes the DEC mode 2026 enable sequence (\x1b[?2026h)
	// to the terminal, starting a synchronized update block.
	BeginSync()

	// EndSync writes the DEC mode 2026 disable sequence (\x1b[?2026l)
	// to the terminal, ending a synchronized update block. The terminal
	// flushes all buffered output at this point.
	EndSync()
}