func (p DefaultPainter) PaintCell(canvas widget.Canvas, cps CellPaintState) {
	if cps.Bounds.IsEmpty() {
		return
	}
	textColor := defaultCellTextColor
	if cps.ColorScheme != (TableColorScheme{}) {
		textColor = cps.ColorScheme.CellText
	}

	textBounds := geometry.NewRect(
		cps.Bounds.Min.X+cellPaddingH,
		cps.Bounds.Min.Y,
		cps.Bounds.Width()-cellPaddingH*2,
		cps.Bounds.Height(),
	)
	canvas.DrawText(cps.Value, textBounds, cellFontSize, textColor, false, cps.Align)
}

func (p DefaultPainter) PaintEmptyState(canvas widget.Canvas, bounds geometry.Rect) {
	if bounds.IsEmpty() {
		return
	}
	canvas.DrawText(emptyStateText, bounds, emptyStateFontSize, defaultEmptyTextColor, false, widget.TextAlignCenter)
}

func (p DefaultPainter) PaintHeader(canvas widget.Canvas, bounds geometry.Rect, hps HeaderPaintState) {
	if bounds.IsEmpty() {
		return
	}
	bg := defaultHeaderBackground
	if hps.ColorScheme != (TableColorScheme{}) {
		bg = hps.ColorScheme.HeaderBackground
	}
	canvas.DrawRect(bounds, bg)
}

func (p DefaultPainter) PaintHeaderCell(canvas widget.Canvas, bounds geometry.Rect, hcs HeaderCellPaintState) {
	if bounds.IsEmpty() {
		return
	}

	textColor := defaultHeaderTextColor
	if hcs.ColorScheme != (TableColorScheme{}) {
		textColor = hcs.ColorScheme.HeaderText
	}

	// Highlight on hover for sortable columns.
	if hcs.Hovered && hcs.Sortable && !hcs.Disabled {
		hoverColor := defaultHeaderHoverColor
		if hcs.ColorScheme != (TableColorScheme{}) {
			hoverColor = hcs.ColorScheme.HoverColor
		}
		canvas.DrawRect(bounds, hoverColor)
	}

	// Build display text with sort indicator.
	displayText := hcs.Title
	if indicator := hcs.SortDir.Indicator(); indicator != "" {
		displayText = hcs.Title + " " + indicator
	}

	// Inset for text padding.
	textBounds := geometry.NewRect(
		bounds.Min.X+cellPaddingH,
		bounds.Min.Y,
		bounds.Width()-cellPaddingH*2,
		bounds.Height(),
	)
	canvas.DrawText(displayText, textBounds, headerFontSize, textColor, true, hcs.Align)
}

func (p DefaultPainter) PaintRow(canvas widget.Canvas, rps RowPaintState) {
	if rps.Bounds.IsEmpty() {
		return
	}
	hasScheme := rps.ColorScheme != (TableColorScheme{})

	// Zebra striping.
	if rps.RowIndex%2 == 1 {
		bg := defaultRowAlternate
		if hasScheme {
			bg = rps.ColorScheme.RowAlternate
		}
		canvas.DrawRect(rps.Bounds, bg)
	}

	// Selection.
	if rps.Selected {
		color := defaultSelectionColor
		if hasScheme {
			color = rps.ColorScheme.SelectionColor
		}
		canvas.DrawRect(rps.Bounds, color)
	}

	// Hover (only if not selected, to avoid double-tinting).
	if rps.Hovered && !rps.Selected && !rps.Disabled {
		color := defaultHoverColor
		if hasScheme {
			color = rps.ColorScheme.HoverColor
		}
		canvas.DrawRect(rps.Bounds, color)
	}

	// Focus ring.
	if rps.Focused && !rps.Disabled {
		focusColor := defaultFocusBorderColor
		if hasScheme {
			focusColor = rps.ColorScheme.FocusColor
		}
		canvas.StrokeRect(rps.Bounds, focusColor, focusBorderWidth)
	}
}

type HeaderPaintState struct {
	// Disabled is true if the table is disabled.
	Disabled	bool

	// ColorScheme provides theme-derived colors.
	ColorScheme	TableColorScheme
}

type HeaderCellPaintState struct {
	// Title is the column display text.
	Title	string

	// Align is the column text alignment.
	Align	widget.TextAlign

	// Sortable is true if this column supports sorting.
	Sortable	bool

	// SortDir is the current sort direction for this column.
	SortDir	SortDirection

	// Hovered is true if the mouse is over this header cell.
	Hovered	bool

	// Disabled is true if the table is disabled.
	Disabled	bool

	// ColorScheme provides theme-derived colors.
	ColorScheme	TableColorScheme
}

type RowPaintState struct {
	// Bounds is the row's bounding rectangle.
	Bounds	geometry.Rect

	// RowIndex is the zero-based row index in the data source.
	RowIndex	int

	// Selected is true if this row is selected.
	Selected	bool

	// Focused is true if this row has focus within the table.
	Focused	bool

	// Hovered is true if the mouse is over this row.
	Hovered	bool

	// Disabled is true if the table is disabled.
	Disabled	bool

	// ColorScheme provides theme-derived colors.
	ColorScheme	TableColorScheme
}

type CellPaintState struct {
	// Bounds is the cell's bounding rectangle.
	Bounds	geometry.Rect

	// Value is the cell's text content.
	Value	string

	// Align is the column text alignment.
	Align	widget.TextAlign

	// RowIndex is the zero-based row index.
	RowIndex	int

	// ColIndex is the zero-based column index.
	ColIndex	int

	// Selected is true if the parent row is selected.
	Selected	bool

	// Disabled is true if the table is disabled.
	Disabled	bool

	// ColorScheme provides theme-derived colors.
	ColorScheme	TableColorScheme
}

type TableColorScheme struct {
	HeaderBackground	widget.Color	// header row background
	HeaderText		widget.Color	// header text color
	RowBackground		widget.Color	// normal row background
	RowAlternate		widget.Color	// alternate row background (zebra)
	SelectionColor		widget.Color	// selected row background
	HoverColor		widget.Color	// hovered row background
	FocusColor		widget.Color	// focused row border
	CellText		widget.Color	// cell text color
	Divider			widget.Color	// column/row divider color
	EmptyText		widget.Color	// empty state text color
}

type DefaultPainter struct{}

type Painter interface {
	// PaintHeader draws the table header background.
	PaintHeader(canvas widget.Canvas, bounds geometry.Rect, state HeaderPaintState)

	// PaintHeaderCell draws a single header cell (column title + sort indicator).
	PaintHeaderCell(canvas widget.Canvas, bounds geometry.Rect, state HeaderCellPaintState)

	// PaintRow draws the background for a data row.
	PaintRow(canvas widget.Canvas, state RowPaintState)

	// PaintCell draws a single data cell.
	PaintCell(canvas widget.Canvas, state CellPaintState)

	// PaintEmptyState draws the empty state when RowCount is 0.
	PaintEmptyState(canvas widget.Canvas, bounds geometry.Rect)
}