charts

type BarChartOption struct {
	// Theme specifies the colors used for the bar chart.
	Theme ColorPalette
	// Padding specifies the padding around the chart.
	Padding Box
	// Deprecated: Font is deprecated, instead the font needs to be set on the SeriesLabel, or other specific elements.
	Font *truetype.Font
	// SeriesList provides the data population for the chart. Typically constructed using NewSeriesListBar.
	SeriesList BarSeriesList
	// StackSeries when *true renders series stacked within one bar.
	// This ignores some options including BarMargin and SeriesLabelPosition.
	// MarkLine only renders for the first series and stacking only applies to the first y-axis.
	StackSeries *bool
	// SeriesLabelPosition specifies the label position for the series: "top" or "bottom".
	SeriesLabelPosition string
	// XAxis contains options for the x-axis.
	XAxis XAxisOption
	// YAxis contains options for the y-axis. At most two y-axes are supported.
	YAxis []YAxisOption
	// Title contains options for rendering the chart title.
	Title TitleOption
	// Legend contains options for the data legend.
	Legend LegendOption
	// BarWidth specifies the width of each bar. May be reduced to fit all series on the chart.
	BarWidth int
	// BarMargin specifies the margin between grouped bars. BarWidth takes priority over a set margin.
	BarMargin *float64
	// RoundedBarCaps when *true draws bars with rounded top corners.
	RoundedBarCaps *bool
	// ValueFormatter defines how float values are rendered to strings, notably for numeric axis labels.
	ValueFormatter ValueFormatter
}

type BarSeries struct {
	// Values provides the series data values.
	Values []float64
	// YAxisIndex is the index for the axis, it must be 0 or 1.
	YAxisIndex int
	// Label provides the series labels.
	Label SeriesLabel
	// Name specifies a name for the series.
	Name string
	// MarkPoint provides a configuration for mark points for this series. If Label is also enabled, the MarkPoint
	// will replace the label where rendered.
	MarkPoint SeriesMarkPoint
	// MarkLine provides a configuration for mark lines for this series. When using a MarkLine, you will want to
	// configure padding to the chart on the right for the values.
	MarkLine SeriesMarkLine
}

type BarSeriesList []BarSeries

type BarSeriesOption struct {
	Label     SeriesLabel
	Names     []string
	MarkPoint SeriesMarkPoint
	MarkLine  SeriesMarkLine
}

type Box = chartdraw.Box

type ChartOption struct {
	// OutputFormat specifies the output type of chart: "svg", "png", or "jpg". Default is "png".
	OutputFormat string
	// Width is the width of the chart.
	Width int
	// Height is the height of the chart.
	Height int
	// Theme specifies the colors used for the chart. Built in themes can be loaded using GetTheme with
	// "light", "dark", "vivid-light", "vivid-dark", "ant" or "grafana".
	Theme ColorPalette
	// Padding specifies the padding for the chart. Default is [20, 20, 20, 20].
	Padding Box
	// XAxis contains options for the x-axis.
	XAxis XAxisOption
	// YAxis contains options for the y-axis. At most two y-axes are supported.
	YAxis []YAxisOption
	// Title contains options for rendering the chart title.
	Title TitleOption
	// Legend contains options for the data legend.
	Legend LegendOption
	// Deprecated: Font is deprecated, instead the font needs to be set on the SeriesLabel, or other specific elements.
	Font *truetype.Font
	// Box specifies the drawing area for the chart.
	Box Box
	// SeriesList provides the population data for the chart, constructed through NewSeriesListGeneric.
	SeriesList GenericSeriesList
	// StackSeries when set to *true causes series to be layered or stacked.
	// This significantly changes chart visualization; see specific chart godocs for details.
	StackSeries *bool
	// RadarIndicators is the list of radar indicators for radar charts.
	RadarIndicators []RadarIndicator
	// Symbol specifies the symbol to draw at data points. Empty (default) varies by chart type.
	// Specify 'none' to enforce no symbol, or specify a desired symbol: 'circle', 'dot', 'square', 'diamond'.
	Symbol Symbol
	// LineStrokeWidth is the stroke width for line charts.
	LineStrokeWidth float64
	// FillArea when set to *true fills the area under the line in line charts.
	FillArea *bool
	// FillOpacity is the opacity or alpha channel (0-255) of the area fill in line charts.
	FillOpacity uint8
	// Deprecated: BarWidth is deprecated, instead use BarSize.
	BarWidth int
	// Deprecated: BarHeight is deprecated, instead use BarSize.
	BarHeight int
	// BarSize represents the width of bars, or height for horizontal bar charts.
	BarSize int
	// BarMargin specifies the margin between grouped bars. BarSize takes priority over margin.
	BarMargin *float64
	// Radius is the target radius for pie and radar charts. Default is "40%".
	Radius string
	// Children are child charts to render together.
	Children []ChartOption

	// ValueFormatter formats numeric values into labels.
	ValueFormatter ValueFormatter
	// contains filtered or unexported fields
}

type Color = drawing.Color

type ColorPalette interface {
	IsDark() bool
	GetXAxisStrokeColor() Color
	GetYAxisStrokeColor() Color
	GetAxisSplitLineColor() Color
	GetSeriesColor(int) Color
	GetSeriesTrendColor(int) Color
	GetBackgroundColor() Color
	GetTitleTextColor() Color
	GetMarkTextColor() Color
	GetLabelTextColor() Color
	GetLegendTextColor() Color
	GetXAxisTextColor() Color
	GetYAxisTextColor() Color
	GetTitleBorderColor() Color
	GetLegendBorderColor() Color
	// WithXAxisColor returns a new ColorPalette with the specified x-axis color.
	// Use WithXAxisTextColor to adjust the text color.
	WithXAxisColor(Color) ColorPalette
	// WithYAxisColor returns a new ColorPalette with the specified y-axis color.
	// Use WithYAxisTextColor to adjust the text color.
	WithYAxisColor(Color) ColorPalette
	// WithYAxisSeriesColor returns a new ColorPalette using the specified series color for y-axis and values.
	WithYAxisSeriesColor(int) ColorPalette
	// WithTitleTextColor returns a new ColorPalette with the specified title text color.
	WithTitleTextColor(Color) ColorPalette
	// WithMarkTextColor returns a new ColorPalette with the specified mark point and line label color.
	WithMarkTextColor(Color) ColorPalette
	// WithLabelTextColor returns a new ColorPalette with the specified value label color.
	WithLabelTextColor(Color) ColorPalette
	// WithLegendTextColor returns a new ColorPalette with the specified legend text color.
	WithLegendTextColor(Color) ColorPalette
	// WithXAxisTextColor returns a new ColorPalette with the specified x-axis label color.
	WithXAxisTextColor(Color) ColorPalette
	// WithYAxisTextColor returns a new ColorPalette with the specified y-axis label color.
	WithYAxisTextColor(Color) ColorPalette
	// WithSeriesColors returns a new ColorPalette with the specified series colors.
	// Trend line colors default to match series colors. Use WithSeriesTrendColors for further customization.
	WithSeriesColors([]Color) ColorPalette
	// WithSeriesTrendColors returns a new ColorPalette with the specified trend line colors.
	WithSeriesTrendColors([]Color) ColorPalette
	// WithBackgroundColor returns a new ColorPalette with the specified background color.
	WithBackgroundColor(Color) ColorPalette
	// WithTitleBorderColor returns a new ColorPalette with the specified title border color.
	WithTitleBorderColor(Color) ColorPalette
	// WithLegendBorderColor returns a new ColorPalette with the specified legend border color.
	WithLegendBorderColor(Color) ColorPalette
}

type DoughnutChartOption struct {
	// Theme specifies the colors used for the doughnut chart.
	Theme ColorPalette
	// Padding specifies the padding around the chart.
	Padding Box
	// SeriesList provides the data population for the chart. Typically constructed using NewSeriesListDoughnut.
	SeriesList DoughnutSeriesList
	// Title contains options for rendering the chart title.
	Title TitleOption
	// Legend contains options for the data legend.
	Legend LegendOption
	// RadiusRing sets the outer radius of the ring, for example "40%".
	// Default is "40%".
	RadiusRing string
	// RadiusCenter is the radius for the center hole of the doughnut and must be smaller than RadiusRing.
	RadiusCenter string
	// CenterValues specifies what should be rendered in the center of the doughnut,
	// current options are "none" (default), "labels", "sum".
	// * labels - Will render the labels on the inside of the circle instead of the outside (more risk of collision).
	// * sum - Will put the sum count of all the series (formatted using ValueFormatter).
	CenterValues string
	// CenterValuesFontStyle provides the styling for center values (series labels prefer their specific series styling).
	CenterValuesFontStyle FontStyle
	// SegmentGap provides a margin between each series section.
	SegmentGap float64
	// ValueFormatter defines how float values are rendered to strings, notably for series labels.
	ValueFormatter ValueFormatter
}

type DoughnutSeries struct {
	// Value provides the value for the Doughnut section.
	Value float64
	// Label provides the series labels.
	Label SeriesLabel
	// Name specifies a name for the series.
	Name string
	// Radius for Doughnut chart, e.g.: 40%, default is "40%"
	Radius string
}

type DoughnutSeriesList []DoughnutSeries

type DoughnutSeriesOption struct {
	Label SeriesLabel
	Names []string
}

type EChartStyle struct {
	Color   string   `json:"color"`
	Opacity *float64 `json:"opacity,omitempty"`
}

type EChartsAxisLabel struct {
	Formatter string `json:"formatter,omitempty"`
	Show      *bool  `json:"show,omitempty"`
	Color     string `json:"color,omitempty"`
	FontSize  *int   `json:"fontSize,omitempty"`
}

type EChartsAxisLine struct {
	Show      *bool `json:"show,omitempty"`
	LineStyle struct {
		Color   string   `json:"color,omitempty"`
		Opacity *float64 `json:"opacity,omitempty"`
		Width   *int     `json:"width,omitempty"` // TODO - add support
	} `json:"lineStyle,omitempty"`
}

type EChartsLabelOption struct {
	Show     bool   `json:"show"`
	Distance int    `json:"distance"`
	Color    string `json:"color"`
}

type EChartsLegend struct {
	Show            *bool            `json:"show"`
	Data            []string         `json:"data"`
	Align           string           `json:"align"`
	Orient          string           `json:"orient"`
	Padding         EChartsPadding   `json:"padding,omitempty"`
	Left            EChartsPosition  `json:"left"`
	Top             EChartsPosition  `json:"top"`
	TextStyle       EChartsTextStyle `json:"textStyle"`
	BackgroundColor string           `json:"backgroundColor,omitempty"` // TODO - add support
	BorderColor     string           `json:"borderColor,omitempty"`
}

type EChartsMarkData struct {
	Type string `json:"type"`
	// TODO - support position values below
	XAxis float64 `json:"xAxis,omitempty"`
	YAxis float64 `json:"yAxis,omitempty"`
}

type EChartsMarkLine struct {
	Data []EChartsMarkData `json:"data"`
}

type EChartsMarkPoint struct {
	SymbolSize int               `json:"symbolSize"`
	Data       []EChartsMarkData `json:"data"`
}

type EChartsOption struct {
	Type       string         `json:"type"`
	Theme      string         `json:"theme"`
	FontFamily string         `json:"fontFamily"`
	Padding    EChartsPadding `json:"padding"`
	Box        Box            `json:"box"`
	Width      int            `json:"width"`
	Height     int            `json:"height"`
	Title      struct {
		Show            *bool            `json:"show,omitempty"`
		Text            string           `json:"text"`
		Subtext         string           `json:"subtext"`
		Left            EChartsPosition  `json:"left"`
		Top             EChartsPosition  `json:"top"`
		TextStyle       EChartsTextStyle `json:"textStyle"`
		SubtextStyle    EChartsTextStyle `json:"subtextStyle"`
		BackgroundColor string           `json:"backgroundColor,omitempty"` // TODO - add support
		BorderColor     string           `json:"borderColor,omitempty"`
	} `json:"title"`
	XAxis  EChartsXAxis  `json:"xAxis"`
	YAxis  EChartsYAxis  `json:"yAxis"`
	Legend EChartsLegend `json:"legend"`
	Radar  struct {
		Indicator []RadarIndicator `json:"indicator"`
	} `json:"radar"`
	Series          EChartsSeriesList `json:"series"`
	BackgroundColor string            `json:"backgroundColor,omitempty"`
	Children        []EChartsOption   `json:"children"`
}

type EChartsPadding struct {
	Box Box
}

type EChartsPosition string

type EChartsSeries struct {
	Data       []EChartsSeriesData `json:"data"`
	Name       string              `json:"name"`
	Type       string              `json:"type"`
	Radius     string              `json:"radius"`
	YAxisIndex int                 `json:"yAxisIndex"`
	ItemStyle  EChartStyle         `json:"itemStyle,omitempty"` // TODO - add support
	// label configuration
	Label     EChartsLabelOption `json:"label"`
	MarkPoint EChartsMarkPoint   `json:"markPoint"`
	MarkLine  EChartsMarkLine    `json:"markLine"`
	Max       *float64           `json:"max"` // TODO - add support
	Min       *float64           `json:"min"` // TODO - add support
}

type EChartsSeriesData struct {
	Value     EChartsSeriesDataValue `json:"value"`
	Name      string                 `json:"name"`
	ItemStyle EChartStyle            `json:"itemStyle,omitempty"` // TODO - add support
}

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

type EChartsSeriesList []EChartsSeries

type EChartsTextStyle struct {
	Color      string  `json:"color"`
	FontFamily string  `json:"fontFamily"`
	FontSize   float64 `json:"fontSize"`
}

type EChartsXAxis struct {
	Data []EChartsXAxisData
}

type EChartsXAxisData struct {
	BoundaryGap *bool            `json:"boundaryGap,omitempty"`
	SplitNumber int              `json:"splitNumber,omitempty"`
	AxisLabel   EChartsAxisLabel `json:"axisLabel,omitempty"`
	AxisLine    EChartsAxisLine  `json:"axisLine,omitempty"`
	Data        []string         `json:"data"`
	Type        string           `json:"type"`
}

type EChartsYAxis struct {
	Data []EChartsYAxisData `json:"data"`
}

type EChartsYAxisData struct {
	Min       *float64         `json:"min,omitempty"`
	Max       *float64         `json:"max,omitempty"`
	AxisLabel EChartsAxisLabel `json:"axisLabel,omitempty"`
	AxisLine  EChartsAxisLine  `json:"axisLine,omitempty"`
	Data      []string         `json:"data"`
}

type FontStyle = chartdraw.FontStyle

type FunnelChartOption struct {
	// Theme specifies the colors used for the chart.
	Theme ColorPalette
	// Padding specifies the padding around the chart.
	Padding Box
	// Deprecated: Font is deprecated, instead the font needs to be set on the SeriesLabel, or other specific elements.
	Font *truetype.Font
	// SeriesList provides the data population for the chart. Typically constructed using NewSeriesListFunnel.
	SeriesList FunnelSeriesList
	// Title contains options for rendering the chart title.
	Title TitleOption
	// Legend contains options for the data legend.
	Legend LegendOption
	// Deprecated: ValueFormatter is deprecated, instead set the ValueFormatter at `SeriesList[*].Label.ValueFormatter`.
	ValueFormatter ValueFormatter
}

type FunnelSeries struct {
	// Value provides the value for the funnel section.
	Value float64
	// Label provides the series labels.
	Label SeriesLabel
	// Name specifies a name for the series.
	Name string
}

type FunnelSeriesList []FunnelSeries

type FunnelSeriesOption struct {
	Label SeriesLabel
	Names []string
}

type GenericSeries struct {
	// Type is the series chart type. Default is "line".
	Type string
	// Values provides the series data values.
	Values []float64
	// YAxisIndex is the y-axis to apply the series to: must be 0 or 1.
	YAxisIndex int
	// Label provides the series labels.
	Label SeriesLabel
	// Name specifies a name for the series.
	Name string
	// Radius for circular charts. Default is "40%".
	Radius string
	// MarkPoint provides a mark point configuration for this series. If Label is enabled, MarkPoint
	// replaces the label where rendered.
	MarkPoint SeriesMarkPoint
	// MarkLine provides amark line configuration for this series. When using MarkLine, configure
	// padding on the chart's right side to ensure space for the values.
	MarkLine SeriesMarkLine
}

type GenericSeriesList []GenericSeries

type HeatMapAxis struct {
	// Title specifies the title to display next to the axis.
	Title string
	// TitleFontStyle specifies the font style for the axis title.
	TitleFontStyle FontStyle
	// Labels specifies custom labels for the axis. If empty, numeric indices are used.
	// Must match the data size for the corresponding axis.
	Labels []string
	// LabelFontStyle specifies the font style for the axis labels.
	LabelFontStyle FontStyle
	// LabelRotation is the rotation angle in radians for labels. Use DegreesToRadians(float64) to convert from degrees.
	LabelRotation float64
	// LabelCount is the number of labels to show on the axis. Use a smaller count to reduce text collisions.
	LabelCount int
	// LabelCountAdjustment specifies relative influence on label count.
	// Negative values result in cleaner graphs; positive values may cause text collisions.
	LabelCountAdjustment int
}

type HeatMapOption struct {
	// Theme specifies the color palette used for rendering the heat map.
	Theme ColorPalette
	// BaseColorIndex specifies which color from the theme palette to use as the base for gradients.
	BaseColorIndex int
	// Padding specifies the padding around the heat map chart.
	Padding Box
	// Deprecated: Font is deprecated, instead the font needs to be set on the SeriesLabel, or other specific elements.
	Font *truetype.Font
	// Title contains options for rendering the chart title.
	Title TitleOption
	// Values provides the 2D data for the heat map.
	// The outer slice represents the rows (y-axis) and the inner slice represents the columns (x-axis).
	Values [][]float64
	// XAxis contains configuration options for the x-axis.
	XAxis HeatMapAxis
	// YAxis contains configuration options for the y-axis.
	YAxis HeatMapAxis
	// ScaleMinValue overrides the minimum value for color gradient calculation. If nil, calculated from the data.
	ScaleMinValue *float64
	// ScaleMaxValue overrides the maximum value for color gradient calculation. If nil, calculated from the data.
	ScaleMaxValue *float64
	// ValuesLabel contains configuration for displaying numeric values on heat map cells.
	ValuesLabel SeriesLabel
}

type HorizontalBarChartOption struct {
	// Theme specifies the colors used for the chart.
	Theme ColorPalette
	// Padding specifies the padding around the chart.
	Padding Box
	// Deprecated: Font is deprecated, instead the font needs to be set on the SeriesLabel, or other specific elements.
	Font *truetype.Font
	// SeriesList provides the data population for the chart. Typically constructed using NewSeriesListHorizontalBar.
	SeriesList HorizontalBarSeriesList
	// StackSeries when *true renders the series stacked within one bar.
	// This causes some options, including BarMargin and SeriesLabelPosition, to be
	// ignored. MarkLine only renders for the first series.
	StackSeries *bool
	// SeriesLabelPosition specifies the label position for the series: "left" or "right".
	SeriesLabelPosition string
	// XAxis contains options for the x-axis.
	XAxis XAxisOption
	// YAxis contains options for the y-axis.
	YAxis YAxisOption
	// Title contains options for rendering the chart title.
	Title TitleOption
	// Legend contains options for the data legend.
	Legend LegendOption
	// BarHeight specifies the height of each horizontal bar. Height may be reduced to ensure all series fit on the chart.
	BarHeight int
	// BarMargin specifies the margin between grouped bars. BarHeight takes priority over a set margin.
	BarMargin *float64
	// ValueFormatter defines how float values are rendered to strings, notably for numeric axis labels.
	ValueFormatter ValueFormatter
}

type HorizontalBarSeries struct {
	// Values provides the series data values.
	Values []float64
	// Label provides the series labels.
	Label SeriesLabel
	// Name specifies a name for the series.
	Name string
	// MarkLine provides a configuration for mark lines for this series.
	MarkLine SeriesMarkLine
}

type HorizontalBarSeriesList []HorizontalBarSeries

type LabelStyle struct {
	// FontStyle overrides font properties (color, size, family) for this specific label.
	FontStyle FontStyle
	// BackgroundColor provides a background color behind the label text.
	BackgroundColor Color
	// CornerRadius sets the radius for rounded corners on the background rectangle.
	CornerRadius int
	// BorderColor sets the border color around the label background.
	BorderColor Color
	// BorderWidth sets the width of the border around the label background.
	BorderWidth float64
}

type LegendOption struct {
	// Show specifies if the legend should be rendered. Set to *false (via Ptr(false)) to hide the legend.
	Show *bool
	// Theme specifies the colors used for the legend.
	Theme ColorPalette
	// SeriesNames provides the text labels for the data series.
	SeriesNames []string
	// FontStyle specifies the font, size, and style for legend text.
	FontStyle FontStyle
	// Padding specifies the space around the legend.
	Padding Box
	// Offset specifies the position of the legend relative to the left and top sides.
	Offset OffsetStr
	// Align is the legend marker and text alignment: 'left', 'right', or 'center'. Default is 'left'.
	Align string
	// Vertical when set to *true makes the legend orientation vertical.
	Vertical *bool
	// Symbol defines the icon shape next to each label. Options: 'square', 'dot', 'diamond', 'circle'.
	Symbol Symbol // TODO - should Symbol configuration be changed now that we support per-series symbols
	// OverlayChart when set to *true renders the legend over the chart. Ignored if Vertical is true (Vertical always forces overlay).
	OverlayChart *bool
	// BorderWidth can be set to a non-zero value to render a box around the legend.
	BorderWidth float64
	// contains filtered or unexported fields
}

type LineChartOption struct {
	// Theme specifies the colors used for the line chart.
	Theme ColorPalette
	// Padding specifies the padding around the chart.
	Padding Box
	// Deprecated: Font is deprecated, instead the font needs to be set on the SeriesLabel, or other specific elements.
	Font *truetype.Font
	// SeriesList provides the data population for the chart. Typically constructed using NewSeriesListLine.
	SeriesList LineSeriesList
	// StackSeries when true layers each series so the last represents the cumulative sum.
	// This forces FillArea and ignores options like StrokeSmoothingTension.
	// MarkLine only renders for the first series, and only the first y-axis is stacked.
	StackSeries *bool
	// XAxis contains options for the x-axis.
	XAxis XAxisOption
	// YAxis contains options for the y-axis. At most two y-axes are supported.
	YAxis []YAxisOption
	// Title contains options for rendering the chart title.
	Title TitleOption
	// Legend contains options for the data legend.
	Legend LegendOption
	// Symbol specifies the symbol to draw at data points. Empty (default) varies by dataset.
	// Options: 'none', 'circle', 'dot', 'square', 'diamond'. Can be overridden per series.
	Symbol Symbol
	// LineStrokeWidth is the width of the rendered line.
	LineStrokeWidth float64
	// StrokeSmoothingTension controls line smoothing (0-1). 0 creates straight lines, 1 creates heavily smoothed curves.
	// Smoothing the line may move it from hitting points exactly.
	// Higher tension values move the line further from exact data points.
	StrokeSmoothingTension float64
	// FillArea when set to *true fills the area below the line.
	FillArea *bool
	// FillOpacity is the opacity/alpha (0-255) of the area fill.
	FillOpacity uint8
	// ValueFormatter defines how float values are rendered to strings, notably for numeric axis labels.
	ValueFormatter ValueFormatter
}

type LineSeries struct {
	// Values provides the series data values.
	Values []float64
	// YAxisIndex is the index for the axis, it must be 0 or 1.
	YAxisIndex int
	// Label provides the series labels.
	Label SeriesLabel
	// Name specifies a name for the series.
	Name string
	// MarkPoint provides a configuration for mark points for this series. If Label is also enabled, the MarkPoint
	// will replace the label where rendered.
	MarkPoint SeriesMarkPoint
	// MarkLine provides a configuration for mark lines for this series. When using a MarkLine, you will want to
	// configure padding to the chart on the right for the values.
	MarkLine SeriesMarkLine
	// Symbol specifies a custom symbol for the series.
	Symbol Symbol
}

type LineSeriesList []LineSeries

type LineSeriesOption struct {
	Label     SeriesLabel
	Names     []string
	MarkPoint SeriesMarkPoint
	MarkLine  SeriesMarkLine
}

type OffsetInt struct {
	// Top indicates a vertical spacing adjustment from the top.
	Top int
	// Left indicates a horizontal spacing adjustment from the left.
	Left int
}

type OffsetStr struct {
	// Left is the distance between the component and the left side of the container.
	// It can be pixel value (20), percentage value (20%), or position description: 'left', 'right', 'center'.
	Left string
	// Top is the distance between the component and the top side of the container.
	// It can be pixel value (20), or percentage value (20%), or position description: 'top', 'bottom'.
	Top string
}

type OptionFunc func(opt *ChartOption)

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

type PainterOptionFunc func(*Painter)

type PainterOptions struct {
	// OutputFormat specifies the output type: "svg", "png", "jpg". Default is "png".
	OutputFormat string
	// Width is the width of the painter canvas.
	Width int
	// Height is the height of the painter canvas.
	Height int
	// Font is the default font for rendering text.
	Font *truetype.Font
	// Theme is the default theme used when charts don't specify one.
	Theme ColorPalette
}

type PieChartOption struct {
	// Theme specifies the colors used for the pie chart.
	Theme ColorPalette
	// Padding specifies the padding around the chart.
	Padding Box
	// Deprecated: Font is deprecated, instead the font needs to be set on the SeriesLabel, or other specific elements.
	Font *truetype.Font
	// SeriesList provides the data population for the chart. Typically constructed using NewSeriesListPie.
	SeriesList PieSeriesList
	// Title contains options for rendering the chart title.
	Title TitleOption
	// Legend contains options for the data legend.
	Legend LegendOption
	// Radius sets the pie radius. Default is "40%".
	Radius string
	// SegmentGap provides the gap between each pie slice.
	SegmentGap float64
	// Deprecated: ValueFormatter is deprecated, instead set the ValueFormatter at `SeriesList[*].Label.ValueFormatter`.
	ValueFormatter ValueFormatter
}

type PieSeries struct {
	// Value provides the value for the pie section.
	Value float64
	// Label provides the series labels.
	Label SeriesLabel
	// Name specifies a name for the series.
	Name string
	// Radius for Pie chart, e.g.: 40%, default is "40%"
	Radius string
}

type PieSeriesList []PieSeries

type PieSeriesOption struct {
	Label SeriesLabel
	Names []string
}

type Point = chartdraw.Point

type RadarChartOption struct {
	// Theme specifies the colors used for the radar chart.
	Theme ColorPalette
	// Padding specifies the padding around the chart.
	Padding Box
	// Deprecated: Font is deprecated, instead the font needs to be set on the SeriesLabel, or other specific elements.
	Font *truetype.Font
	// SeriesList provides the data population for the chart. Constructed using NewSeriesListRadar.
	SeriesList RadarSeriesList
	// Title contains options for rendering the chart title.
	Title TitleOption
	// Legend contains options for the data legend.
	Legend LegendOption
	// RadarIndicators provides the radar indicator list.
	RadarIndicators []RadarIndicator
	// Radius sets the chart radius. Default is "40%".
	Radius string
	// ValueFormatter defines how float values are rendered to strings, notably for series labels.
	ValueFormatter ValueFormatter
}

type RadarIndicator struct {
	// Name specifies a name for the indicator.
	Name string
	// Max is the maximum value of indicator.
	Max float64
	// Min is the minimum value of indicator.
	Min float64
	// FontStyle provides the font configuration for the indicator.
	FontStyle FontStyle
}

type RadarSeries struct {
	// Values provides the series data list.
	Values []float64
	// Label provides the series labels.
	Label SeriesLabel
	// Name specifies a name for the series.
	Name string
}

type RadarSeriesList []RadarSeries

type RadarSeriesOption struct {
	Label SeriesLabel
	Names []string
}

type ScatterChartOption struct {
	// Theme specifies the colors used for the scatter chart.
	Theme ColorPalette
	// Padding specifies the padding around the chart.
	Padding Box
	// Deprecated: Font is deprecated, instead the font needs to be set on the SeriesLabel, or other specific elements.
	Font *truetype.Font
	// SeriesList provides the data population for the chart. Typically constructed using
	// NewSeriesListScatter or NewSeriesListScatterMultiValue.
	SeriesList ScatterSeriesList
	// XAxis contains options for the x-axis.
	XAxis XAxisOption
	// YAxis contains options for the y-axis. At most two y-axes are supported.
	YAxis []YAxisOption
	// Title contains options for rendering the chart title.
	Title TitleOption
	// Legend contains options for the data legend.
	Legend LegendOption
	// Symbol specifies the default shape for each data point. Default is 'dot'.
	// Options: 'circle', 'dot', 'square', 'diamond'. Can be overridden per series.
	Symbol Symbol
	// SymbolSize specifies the size for each data point. Default is 2.0.
	SymbolSize float64
	// ValueFormatter defines how float values are rendered to strings, notably for numeric axis labels.
	ValueFormatter ValueFormatter
}

type ScatterSeries struct {
	// Values provides the series data values.
	Values [][]float64
	// YAxisIndex is the index for the axis, it must be 0 or 1.
	YAxisIndex int
	// Label provides the series labels.
	Label SeriesLabel
	// Name specifies a name for the series.
	Name string
	// MarkLine provides a configuration for mark lines for this series. When using a MarkLine, you will want to
	// configure padding to the chart on the right for the values.
	MarkLine SeriesMarkLine
	// TrendLine provides configurations for trend lines for this series.
	TrendLine []SeriesTrendLine
	// Symbol specifies a custom symbol for the series.
	Symbol Symbol
}

type ScatterSeriesList []ScatterSeries

type ScatterSeriesOption struct {
	Label     SeriesLabel
	Names     []string
	MarkLine  SeriesMarkLine
	TrendLine []SeriesTrendLine
}

type SeriesLabel struct {
	// Show controls whether data labels are displayed for this series.
	// Use Ptr(true) to show labels, Ptr(false) to hide them, or nil for chart-specific defaults.
	Show *bool
	// LabelFormatter provides complete control over label content and per-point styling.
	// When set, this takes precedence for label production.
	LabelFormatter SeriesLabelFormatter
	// Deprecated: FormatTemplate is deprecated, use LabelFormatter instead for better control.
	// Template string for formatting data labels with placeholders:
	//   {b}: the name of the data item
	//   {c}: the value of the data item
	//   {d}: the percentage of the data item (pie/doughnut charts only)
	// Example: "{b}: {c} ({d})" produces "Sales: 150 (25%)"
	FormatTemplate string
	// ValueFormatter functions as the simplest method of number formatting or customization.
	// Only utilized when other methods are not set.
	ValueFormatter ValueFormatter
	// FontStyle specifies the default font styling for labels in this series.
	// Individual labels can override this via LabelFormatter's LabelStyle return value.
	FontStyle FontStyle
	// Distance specifies the pixel distance between the label and its associated data point or chart element.
	Distance int // TODO - do we want to replace with just Offset?
	// Offset specifies an offset from the position.
	Offset OffsetInt
}

type SeriesLabelFormatter func(index int, name string, val float64) (string, *LabelStyle)

type SeriesMark struct {
	// Type is the mark data type: "max", "min", "average". "average" is only for mark line.
	Type string
	// Global specifies the mark references the sum of all series. Only used when
	// the Series is "Stacked" and the mark is on the LAST Series of the SeriesList.
	Global bool
}

type SeriesMarkLine struct {
	// ValueFormatter is used to produce the label for the Mark Line.
	ValueFormatter ValueFormatter
	// Lines are the mark lines for the series.
	Lines SeriesMarkList
}

type SeriesMarkList []SeriesMark

type SeriesMarkPoint struct {
	// SymbolSize is the width of symbol, default value is 28.
	SymbolSize int
	// ValueFormatter is used to produce the label for the Mark Point.
	ValueFormatter ValueFormatter
	// Points are the mark points for the series.
	Points SeriesMarkList
}

type SeriesTrendLine struct {
	// LineStrokeWidth is the width of the rendered line.
	LineStrokeWidth float64
	// StrokeSmoothingTension should be between 0 and 1. At 0 lines are sharp and precise, 1 provides smoother lines.
	StrokeSmoothingTension float64
	// LineColor overrides the theme color for this trend line.
	LineColor Color
	// Type specifies the trend line type: "linear", "cubic", "average".
	Type string
	// Window is only used for average, defining how many points to consider.
	Window int
}

type Symbol string

type TableCell struct {
	// Text is the text content of the table cell.
	Text string
	// FontStyle contains the font configuration for the cell text.
	FontStyle FontStyle
	// FillColor sets the background color for this table cell.
	FillColor Color
	// Row is the row index of the table cell.
	Row int
	// Column is the column index of the table cell.
	Column int
}

type TableChartOption struct {
	// OutputFormat specifies the output type: "svg", "png", "jpg".
	OutputFormat string
	// Theme specifies the colors used for the table.
	Theme ColorPalette
	// Padding specifies the padding around the table.
	Padding Box
	// Width specifies the width of the table.
	Width int
	// Header provides header data for the top of the table.
	Header []string
	// Data provides the row and column data for the table.
	Data [][]string
	// Spans provides the column span for each column.
	Spans []int
	// TextAligns specifies the text alignment for each cell.
	TextAligns []string
	// FontStyle contains the font configuration for table text.
	FontStyle FontStyle
	// HeaderBackgroundColor provides the background color for the header row.
	HeaderBackgroundColor Color
	// HeaderFontColor specifies the text color for header text.
	HeaderFontColor Color
	// RowBackgroundColors specifies the background colors for each row.
	RowBackgroundColors []Color
	// BackgroundColor specifies the general background color.
	BackgroundColor Color
	// CellModifier is an optional function to modify TableCell style or content before rendering.
	CellModifier func(TableCell) TableCell
}

type ThemeOption struct {
	// IsDarkMode indicates whether the theme is designed for dark backgrounds, affecting color adjustments and text visibility.
	IsDarkMode bool
	// AxisStrokeColor is the default stroke color for both axes.
	AxisStrokeColor Color
	// XAxisStrokeColor overrides AxisStrokeColor for the x-axis.
	XAxisStrokeColor Color
	// YAxisStrokeColor overrides AxisStrokeColor for the y-axis.
	YAxisStrokeColor Color
	// AxisSplitLineColor sets the color of grid lines drawn between ticks.
	AxisSplitLineColor Color
	// BackgroundColor sets the chart background.
	BackgroundColor Color
	// TextColor is the default font color applied if specific text colors are unset.
	TextColor Color
	// TextColorTitle sets the title text color.
	TextColorTitle Color
	// TextColorMark sets the color of mark line and point labels.
	TextColorMark Color
	// TextColorLabel defines the color of series labels.
	TextColorLabel Color
	// TextColorLegend defines the legend text color.
	TextColorLegend Color
	// TextColorXAxis defines the x-axis label text color.
	TextColorXAxis Color
	// TextColorYAxis defines the y-axis label text color.
	TextColorYAxis Color
	// TitleBorderColor draws an optional border around the title.
	TitleBorderColor Color
	// LegendBorderColor draws an optional border around the legend.
	LegendBorderColor Color
	// SeriesColors provides the color palette used for series data.
	SeriesColors []Color
	// SeriesTrendColors provides the palette for rendered trend lines.
	SeriesTrendColors []Color
}

type TitleOption struct {
	// Show specifies if the title should be rendered. Set to *false (via Ptr(false)) to hide the title.
	Show *bool
	// Theme specifies the colors used for the title.
	Theme ColorPalette
	// Text is the title text. Supports '\n' for line breaks.
	Text string
	// Subtext is additional text below the title. Supports '\n' for line breaks.
	Subtext string
	// Offset specifies the position of the title relative to the left and top sides.
	Offset OffsetStr
	// FontStyle specifies the font, size, and style for the title text.
	FontStyle FontStyle
	// SubtextFontStyle specifies the font, size, and style for the subtext.
	SubtextFontStyle FontStyle
	// BorderWidth can be set to a non-zero value to render a box around the title.
	BorderWidth float64
}

type ValueFormatter func(float64) string

type XAxisOption struct {
	// Show specifies if the x-axis should be rendered. Set to *false (via Ptr(false)) to hide the axis.
	Show *bool
	// Theme specifies the colors used for the x-axis.
	Theme ColorPalette
	// Title specifies a name for the axis. If set, the title is rendered below the x-axis.
	Title string
	// TitleFontStyle specifies the font, size, and color for the axis title.
	TitleFontStyle FontStyle
	// Labels provides labels for each value on the x-axis. Indices must match series data indices.
	Labels []string
	// DataStartIndex specifies the starting index for data values.
	DataStartIndex int
	// Deprecated: Position is deprecated. Currently, when set to `bottom` and the labels would render on the top
	// side of the axis line. However, the line would remain at the bottom of the chart. This seems confusing, and
	// attempts to actually move the axis line to the top of the chart are currently very messy looking. For that
	// reason this is currently deprecated. If a top x-Axis is valuable to you, please open a feature request.
	Position string
	// BoundaryGap specifies that the chart should have additional space on the left and right, with data points being
	// centered between two axis ticks. Default is set based on the dataset density / size to produce an easy-to-read
	// graph. Specify a *bool (through charts.Ptr(false) or charts.Ptr(true)) to enforce a spacing.
	BoundaryGap *bool
	// Deprecated: FontStyle is deprecated, use LabelFontStyle.
	FontStyle FontStyle
	// LabelFontStyle specifies the font configuration for each label.
	LabelFontStyle FontStyle
	// LabelRotation is the rotation angle in radians for labels. Use DegreesToRadians(float64) to convert from degrees.
	LabelRotation float64
	// LabelOffset is the position offset for each label.
	LabelOffset OffsetInt
	// ValueFormatter defines how float values are rendered to strings, notably for numeric axis labels.
	ValueFormatter ValueFormatter
	// Unit suggests the axis step size (recommendation only). Larger values result in fewer labels.
	Unit float64
	// LabelCount is the number of labels to show on the axis. Use a smaller count to reduce text collisions.
	LabelCount int
	// LabelCountAdjustment specifies a relative influence on how many labels should be rendered.
	// Typically, this is negative to result in cleaner graphs, positive values may result in text collisions.
	LabelCountAdjustment int
}

type YAxisOption struct {
	// Show specifies if the y-axis should be rendered. Set to *false (via Ptr(false)) to hide the axis.
	Show *bool
	// Theme specifies the colors used for the y-axis.
	Theme ColorPalette
	// Title specifies a name for the axis. If set, the axis name is rendered on the outside of the y-Axis.
	Title string
	// TitleFontStyle specifies the font, size, and color for the axis title.
	TitleFontStyle FontStyle
	// Min forces the minimum value of the y-axis when set (Use Ptr(float64)).
	Min *float64
	// Max forces the maximum value of the y-axis when set (Use Ptr(float64)).
	Max *float64
	// RangeValuePaddingScale suggests a padding scale to apply to the max and min values.
	RangeValuePaddingScale *float64
	// Labels provides labels for each value on the y-axis.
	Labels []string
	// Position describes the y-axis position: 'left' or 'right'.
	Position string
	// Deprecated: FontStyle is deprecated, use LabelFontStyle.
	FontStyle FontStyle
	// LabelFontStyle specifies the font configuration for each label.
	LabelFontStyle FontStyle
	// LabelRotation is the rotation angle in radians for labels. Use DegreesToRadians(float64) to convert from degrees.
	LabelRotation float64
	// Deprecated: Formatter is deprecated, use ValueFormatter instead.
	Formatter string
	// Unit suggests the axis step size (recommendation only). Larger values result in fewer labels.
	Unit float64
	// LabelCount is the number of labels to show on the axis. Use a smaller count to reduce text collisions.
	LabelCount int
	// LabelCountAdjustment specifies relative influence on label count.
	// Negative values result in cleaner graphs; positive values may cause text collisions.
	LabelCountAdjustment int
	// LabelSkipCount specifies a qty of lines between labels that show only horizontal lines without labels.
	LabelSkipCount int
	// SplitLineShow when set to *true shows horizontal axis split lines.
	SplitLineShow *bool
	// SpineLineShow controls whether the vertical spine line is shown.
	// Default is hidden unless it's a category axis.
	SpineLineShow *bool
	// ValueFormatter defines how float values are rendered to strings, notably for numeric axis labels.
	ValueFormatter ValueFormatter
	// contains filtered or unexported fields
}