func (p DataTablePainter) PaintCell(canvas widget.Canvas, cps datatable.CellPaintState) {
	if cps.Bounds.IsEmpty() {
		return
	}
	colors := p.effectiveCellColors(cps.ColorScheme)
	fg := colors.CellText
	if cps.Disabled {
		fg = fg.WithAlpha(m3TableDisabledAlpha)
	}

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

func (p DataTablePainter) PaintEmptyState(canvas widget.Canvas, bounds geometry.Rect) {
	if bounds.IsEmpty() {
		return
	}
	colors := p.resolveColors()
	canvas.DrawText(m3TableEmptyText, bounds, m3TableEmptyFontSize, colors.EmptyText, false, widget.TextAlignCenter)
}

func (p DataTablePainter) PaintHeader(canvas widget.Canvas, bounds geometry.Rect, hps datatable.HeaderPaintState) {
	if bounds.IsEmpty() {
		return
	}
	colors := p.effectiveHeaderColors(hps.ColorScheme)
	canvas.DrawRect(bounds, colors.HeaderBackground)

	// Bottom divider line.
	dividerRect := geometry.NewRect(bounds.Min.X, bounds.Max.Y-m3TableDividerHeight, bounds.Width(), m3TableDividerHeight)
	canvas.DrawRect(dividerRect, colors.Divider)
}

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

	colors := p.effectiveHeaderCellColors(hcs.ColorScheme)

	// Highlight on hover for sortable columns.
	if hcs.Hovered && hcs.Sortable && !hcs.Disabled {
		canvas.DrawRect(bounds, colors.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+m3TableCellPaddingH,
		bounds.Min.Y,
		bounds.Width()-m3TableCellPaddingH*2,
		bounds.Height(),
	)

	fg := colors.HeaderText
	if hcs.Disabled {
		fg = fg.WithAlpha(m3TableDisabledAlpha)
	}
	canvas.DrawText(displayText, textBounds, m3TableHeaderFontSize, fg, true, hcs.Align)
}

func (p DataTablePainter) PaintRow(canvas widget.Canvas, rps datatable.RowPaintState) {
	if rps.Bounds.IsEmpty() {
		return
	}
	colors := p.effectiveRowColors(rps.ColorScheme)

	// Zebra striping for alternate rows.
	if rps.RowIndex%2 == 1 {
		canvas.DrawRect(rps.Bounds, colors.RowAlternate)
	}

	// Selection highlight.
	if rps.Selected {
		canvas.DrawRect(rps.Bounds, colors.SelectionColor)
	}

	// Hover highlight (only when not selected to avoid double-tinting).
	if rps.Hovered && !rps.Selected && !rps.Disabled {
		canvas.DrawRect(rps.Bounds, colors.HoverColor)
	}

	// Focus ring.
	if rps.Focused && !rps.Disabled {
		canvas.StrokeRect(rps.Bounds, colors.FocusColor, m3TableFocusBorderWidth)
	}
}

type DataTablePainter struct {
	Theme *Theme	// nil uses default M3 purple fallback
}