charts

type AreaChartData struct {
	Points      []TimeSeriesData
	Color       string
	FillColor   string
	UseGradient bool                // If true, use gradient fill
	GradientID  string              // Optional custom gradient ID
	ColorSpace  color.GradientSpace // Color space for gradient interpolation
	Label       string
	Smooth      bool    // If true, use smooth curves
	Tension     float64 // Curve tension (0-1), 0.3 recommended
	BaselineY   int     // Y value for baseline (default: bottom of chart)
	Stacked     bool    // For multiple series (future enhancement)
}

type BarChartData struct {
	Bars    []BarData
	Color   string
	Label   string
	Stacked bool
}

type BarData struct {
	Value     int
	Secondary int // For stacked bars
	Label     string
}

type BollingerBands struct {
	Upper  []float64
	Middle []float64 // SMA
	Lower  []float64
}

type Bounds struct {
	X      int
	Y      int
	Width  int
	Height int
}

type BoxPlotData struct {
	Values      []float64 // Raw data values
	Label       string    // Category label
	Color       string    // Box fill color
	StrokeColor string    // Box outline color

	// Optional: Pre-calculated statistics (if nil, will be calculated)
	Q1       *float64  // First quartile (25th percentile)
	Median   *float64  // Median (50th percentile)
	Q3       *float64  // Third quartile (75th percentile)
	Min      *float64  // Minimum value (or lower whisker)
	Max      *float64  // Maximum value (or upper whisker)
	Outliers []float64 // Optional: outlier values
}

type BoxPlotSpec struct {
	Data              []*BoxPlotData
	Width             float64
	Height            float64
	Horizontal        bool    // If true, render horizontal box plots
	BoxWidth          float64 // Width of each box (0 = auto)
	ShowOutliers      bool    // If true, show outlier points
	ShowMean          bool    // If true, show mean marker
	ShowNotch         bool    // If true, show confidence interval notch
	WhiskerMultiplier float64 // IQR multiplier for whiskers (default: 1.5)

	// Axis configuration
	XAxisLabel string
	YAxisLabel string
	ShowGrid   bool
}

type BoxPlotStats struct {
	Q1         float64
	Median     float64
	Q3         float64
	Min        float64
	Max        float64
	Mean       float64
	IQR        float64
	LowerFence float64
	UpperFence float64
	Outliers   []float64
}

type BrailleCanvas struct {
	Width  int
	Height int
	// contains filtered or unexported fields
}

type CandlestickData struct {
	X      interface{} // Time or category (converted via x scale)
	Open   float64
	High   float64
	Low    float64
	Close  float64
	Volume float64 // Optional volume data
}

type CandlestickSpec struct {
	Data          []CandlestickData
	Width         float64
	Height        float64
	XScale        scales.Scale
	YScale        scales.Scale
	CandleWidth   float64 // Width of each candle body
	WickWidth     float64 // Width of wick line
	RisingColor   string  // Color for rising candles (close > open)
	FallingColor  string  // Color for falling candles (close < open)
	ShowVolume    bool    // Show volume bars
	VolumeHeight  float64 // Height allocated for volume bars
	VolumeColor   string
	VolumeOpacity float64
}

type CapStyle string

type Card struct {
	Width        int
	Height       int
	Title        string
	Icon         string       // Optional SVG icon content
	Legends      []LegendItem // Optional legend items for header end
	Footer       string       // Optional footer content
	DesignTokens *design.DesignTokens
	MotionTokens *design.MotionTokens
}

type ChordDiagramSpec struct {
	Entities     []ChordEntity
	Relations    []ChordRelation
	Width        float64
	Height       float64
	InnerRadius  float64 // Inner radius for entity arcs (auto if 0)
	ArcWidth     float64 // Width of entity arcs (default: 20)
	ArcPadding   float64 // Padding between entity arcs in degrees (default: 2)
	DefaultColor string  // Default entity color
	ShowLabels   bool    // Show entity labels
	Title        string
}

type ChordEntity struct {
	ID    string
	Label string
	Color string // Optional custom color
}

type ChordRelation struct {
	Source string  // Source entity ID
	Target string  // Target entity ID
	Value  float64 // Relationship strength (determines chord width)
}

type CirclePackingSpec struct {
	Root        *TreeNode
	Width       float64
	Height      float64
	Padding     float64 // Padding between circles
	ShowLabels  bool
	ColorScheme []string
}

type CircularBarPlotSpec struct {
	Data           []CircularBarPoint
	Width          float64
	Height         float64
	InnerRadius    float64 // Inner radius (creates donut hole, 0 = start from center)
	BarWidth       float64 // Angular width of bars (0 = auto-calculate with gaps)
	DefaultColor   string  // Default bar color
	ShowLabels     bool    // Show value labels on bars
	ShowAxisLabels bool    // Show labels around the circle
	Title          string
	StartAngle     float64 // Starting angle in degrees (0 = top, clockwise)
}

type CircularBarPoint struct {
	Label string
	Value float64
	Color string // Optional custom color
}

type ConfidenceBand struct {
	XValues      []float64 // X positions (data coordinates)
	YCenters     []float64 // Center Y values
	YLowerBounds []float64 // Lower bound Y values
	YUpperBounds []float64 // Upper bound Y values
	Color        string    // Fill color
	Opacity      float64   // Band opacity (0-1)
	Label        string    // Optional label
}

type ConfidenceBandSpec struct {
	Bands []*ConfidenceBand
}

type ConnectedScatterPoint struct {
	X     float64
	Y     float64
	Label string  // Optional label for the point
	Size  float64 // Optional custom size for this point
	Color string  // Optional custom color for this point
}

type ConnectedScatterSeries struct {
	Points     []ConnectedScatterPoint
	Label      string  // Series label for legend
	Color      string  // Line and marker color
	LineStyle  string  // "solid", "dashed", "dotted"
	LineWidth  float64 // Width of connecting line
	MarkerType string  // "circle", "square", "diamond", "triangle", "cross", "x"
	MarkerSize float64 // Size of markers
}

type ConnectedScatterSpec struct {
	Series      []*ConnectedScatterSeries
	Width       float64
	Height      float64
	ShowGrid    bool
	ShowMarkers bool // If false, only lines are shown
	ShowLines   bool // If false, only markers are shown (regular scatter)
	Title       string
	XAxisLabel  string
	YAxisLabel  string
	XAxisMin    *float64 // Optional: force X axis min
	XAxisMax    *float64 // Optional: force X axis max
	YAxisMin    *float64 // Optional: force Y axis min
	YAxisMax    *float64 // Optional: force Y axis max
}

type ContributionDay struct {
	Date  time.Time
	Count int
}

type CorrelationMatrix struct {
	Variables []string    // Variable names
	Matrix    [][]float64 // Correlation values (must be square matrix)
}

type CorrelogramSpec struct {
	Data         CorrelationMatrix
	Width        float64
	Height       float64
	ShowValues   bool   // Show correlation values in cells
	ShowDiagonal bool   // Show diagonal (always 1.0)
	TriangleMode string // "full", "upper", "lower"
	ColorScheme  string // "redblue", "bluered", "coolwarm"
	Title        string
	CellPadding  float64 // Padding between cells
}

type DendrogramNode struct {
	Label    string            // Label for leaf nodes
	Height   float64           // Height (distance) at which this cluster was formed
	Children []*DendrogramNode // Child nodes (empty for leaf nodes)
}

type DendrogramSpec struct {
	Root        *DendrogramNode
	Width       float64
	Height      float64
	Orientation string  // "vertical", "horizontal" (default: vertical)
	ShowLabels  bool    // Show leaf labels
	ShowHeights bool    // Show height scale
	LineWidth   float64 // Width of dendrogram lines (default: 2)
	LineColor   string  // Color of dendrogram lines
	Title       string
}

type DensityPlotData struct {
	Values    []float64 // Raw data values
	Color     string    // Line color
	FillColor string    // Optional fill color
	Label     string    // Optional label
	Bandwidth float64   // KDE bandwidth (0 = auto)
}

type DensityPlotSpec struct {
	Data      []*DensityPlotData
	Width     float64
	Height    float64
	ShowFill  bool    // If true, fill area under curve
	Smooth    bool    // If true, use smooth curves
	LineWidth float64 // Line width

	// Axis configuration
	XAxisLabel string
	YAxisLabel string
}

type DensityPoint struct {
	Value   float64 // Y value
	Density float64 // Density at this value
}

type ErrorBar struct {
	X          float64 // X position (data coordinates)
	Y          float64 // Y value (data coordinates)
	ErrorLower float64 // Lower error (absolute value or relative)
	ErrorUpper float64 // Upper error (absolute value or relative)
	IsRelative bool    // If true, errors are relative to Y; if false, absolute values
}

type ErrorBarSpec struct {
	Bars      []ErrorBar
	Color     string
	CapWidth  float64 // Width of error bar caps (pixels)
	CapStyle  CapStyle
	LineWidth float64
}

type HeatmapData struct {
	Days      []ContributionDay
	StartDate time.Time
	EndDate   time.Time
	Type      string // "linear" or "weeks" (GitHub-style grid)
}

type HeikinAshiData struct {
	X     interface{}
	Open  float64
	High  float64
	Low   float64
	Close float64
}

type HistogramData struct {
	Values []float64 // Raw data values
	Color  string    // Bar fill color
	Label  string    // Optional label
}

type HistogramSpec struct {
	Data        *HistogramData
	Width       float64
	Height      float64
	BinCount    int     // Number of bins (0 = auto)
	BinSize     float64 // Fixed bin size (0 = use BinCount)
	Nice        bool    // If true, use nice round bin edges
	ShowDensity bool    // If true, normalize to show density instead of counts
	BarGap      float64 // Gap between bars (pixels)

	// Axis configuration
	XAxisLabel string
	YAxisLabel string
}

type IcicleRect struct {
	X, Y, Width, Height float64
	Node                *TreeNode
	Depth               int
}

type IcicleSpec struct {
	Root        *TreeNode
	Width       float64
	Height      float64
	Padding     float64 // Padding between rectangles
	Orientation string  // "vertical" or "horizontal"
	ShowLabels  bool
	ColorScheme []string
}

type LegendItem struct {
	Color string
	Label string
	X     int // Optional X position (if 0, will be auto-positioned)
}

type LineGraphData struct {
	Points      []TimeSeriesData
	Color       string
	FillColor   string
	UseGradient bool                // If true, use gradient fill instead of solid color
	GradientID  string              // Optional custom gradient ID (auto-generated if empty)
	ColorSpace  color.GradientSpace // Color space for gradient interpolation
	Label       string
	Smooth      bool    // If true, use smooth curves instead of straight lines
	Tension     float64 // Curve tension (0-1), only used if Smooth is true. 0.3 is recommended
	MarkerType  string  // Marker type: "circle", "square", "diamond", "triangle", "dot", "" (none)
	MarkerSize  float64 // Size of markers in pixels (default: 3)
}

type LollipopData struct {
	Values []LollipopPoint
	Color  string // Stem and circle color
}

type LollipopPoint struct {
	Label  string
	Value  float64
	Color  string  // Optional: override default color
	Radius float64 // Optional: custom circle size
}

type LollipopSpec struct {
	Data       *LollipopData
	Width      float64
	Height     float64
	Horizontal bool    // If true, render horizontal lollipops
	StemWidth  float64 // Width of stem line (default: 2)
	CircleSize float64 // Radius of circle (default: 6)
	ShowLabels bool    // Show value labels
	ShowGrid   bool    // Show background grid
	Title      string
	XAxisLabel string
	YAxisLabel string
	BaselineY  float64 // Y value for baseline (default: 0)
}

type OHLCData struct {
	X     interface{} // Time or category
	Open  float64
	High  float64
	Low   float64
	Close float64
}

type OHLCSpec struct {
	Data         []OHLCData
	Width        float64
	Height       float64
	XScale       scales.Scale
	YScale       scales.Scale
	TickWidth    float64 // Width of open/close ticks
	LineWidth    float64 // Width of high-low line
	RisingColor  string
	FallingColor string
}

type Output interface {
	String() string
}

type PackedCircle struct {
	X, Y, Radius float64
	Node         *TreeNode
	Depth        int
}

type ParallelAxis struct {
	Label string
	Min   float64
	Max   float64
}

type ParallelCoordinatesSpec struct {
	Axes           []ParallelAxis      // Axis definitions
	Data           []ParallelDataPoint // Data points
	Width          float64
	Height         float64
	LineOpacity    float64 // Opacity of lines (default: 0.6)
	LineWidth      float64 // Width of lines (default: 1.5)
	DefaultColor   string  // Default line color
	HighlightColor string  // Color for highlighted lines
	ShowAxesLabels bool    // Show axis labels
	ShowTicks      bool    // Show tick marks on axes
	Title          string
}

type ParallelDataPoint struct {
	Values []float64 // One value per axis
	Label  string    // Optional label for this data point
	Color  string    // Optional custom color
}

type PieChartData struct {
	Slices []PieSlice
	Colors []string // Optional custom color palette (uses default if empty)
}

type PieSlice struct {
	Label string
	Value float64
}

type Point struct {
	X, Y float64
}

type RadarAxis struct {
	Label string
	Min   float64
	Max   float64
}

type RadarChartSpec struct {
	Axes       []RadarAxis    // Axes definitions
	Series     []*RadarSeries // Data series
	Width      float64
	Height     float64
	ShowGrid   bool // Show concentric grid circles
	GridLevels int  // Number of grid levels (default: 5)
	ShowLabels bool // Show axis labels
	ShowValues bool // Show value labels on points
	Title      string
}

type RadarSeries struct {
	Label       string
	Values      []float64 // One value per axis
	Color       string
	FillOpacity float64 // Opacity of filled area (0-1)
	LineWidth   float64
}

type RenderConfig struct {
	DesignTokens *design.DesignTokens
	MotionTokens *design.MotionTokens
	Color        string
	Theme        string
}

type Renderer interface {
	RenderHeatmap(data HeatmapData, bounds Bounds, config RenderConfig) Output
	RenderLineGraph(data LineGraphData, bounds Bounds, config RenderConfig) Output
	RenderBarChart(data BarChartData, bounds Bounds, config RenderConfig) Output
	RenderStatCard(data StatCardData, bounds Bounds, config RenderConfig) Output
	RenderAreaChart(data AreaChartData, bounds Bounds, config RenderConfig) Output
	RenderScatterPlot(data ScatterPlotData, bounds Bounds, config RenderConfig) Output
}

type RidgelineData struct {
	Values    []float64 // Raw data values
	Label     string    // Category label
	Color     string    // Fill color
	Bandwidth float64   // KDE bandwidth (0 = auto)
}

type RidgelineSpec struct {
	Data      []*RidgelineData
	Width     float64
	Height    float64
	Overlap   float64 // Amount of overlap between ridges (0-1, default 0.5)
	ShowFill  bool    // If true, fill ridges with color
	LineWidth float64 // Line width
	Reverse   bool    // If true, reverse order (top to bottom)

	// Axis configuration
	XAxisLabel string
	ShowLabels bool // If true, show category labels on Y axis
}

type SVGOutput string

type SVGRenderer struct{}

type SankeyLink struct {
	Source string  // Source node ID
	Target string  // Target node ID
	Value  float64 // Flow value (determines link width)
	Color  string  // Optional custom color
}

type SankeyNode struct {
	ID    string
	Label string
	Color string  // Optional custom color
	X     float64 // Optional: manual X position (0-1 normalized, 0 = auto)
	Y     float64 // Optional: manual Y position (0-1 normalized, 0 = auto)
}

type SankeySpec struct {
	Nodes        []SankeyNode
	Links        []SankeyLink
	Width        float64
	Height       float64
	NodeWidth    float64 // Width of node rectangles (default: 15)
	NodePadding  float64 // Vertical padding between nodes (default: 10)
	DefaultColor string  // Default node color
	ShowLabels   bool    // Show node labels
	Title        string
}

type ScatterPlotData struct {
	Points     []ScatterPoint
	Color      string
	Label      string
	MarkerType string  // Marker shape: "circle", "square", "diamond", "triangle", "cross", "x", "dot"
	MarkerSize float64 // Size of markers in pixels
}

type ScatterPoint struct {
	Date  time.Time
	Value int
	Size  float64 // Optional: custom size for this point (0 = use default)
	Label string  // Optional: label for this specific point
}

type SimpleDensityData struct {
	Values    []float64
	Label     string
	Color     string
	Bandwidth float64 // KDE bandwidth (0 = auto)
}

type SimpleDensitySpec struct {
	Data       []*SimpleDensityData
	Width      float64
	Height     float64
	ShowFill   bool
	ShowRug    bool // Show rug plot (data points on x-axis)
	LineWidth  float64
	Title      string
	XAxisLabel string
	YAxisLabel string
}

type StackedAreaPoint struct {
	X      float64
	Values []float64 // One value per series
}

type StackedAreaSeries struct {
	Label string
	Color string
}

type StackedAreaSpec struct {
	Points     []StackedAreaPoint  // X positions with values for all series
	Series     []StackedAreaSeries // Metadata for each series (colors, labels)
	Width      float64
	Height     float64
	ShowGrid   bool
	Smooth     bool // Use smooth curves instead of straight lines
	Title      string
	XAxisLabel string
	YAxisLabel string
	XAxisMin   *float64 // Optional: force X axis min
	XAxisMax   *float64 // Optional: force X axis max
	YAxisMin   *float64 // Optional: force Y axis min (usually 0 for stacked)
	YAxisMax   *float64 // Optional: force Y axis max
}

type StatCardData struct {
	Title       string
	Value       string
	Subtitle    string
	Change      int
	ChangePct   float64
	Color       string
	TrendData   []TimeSeriesData // Optional trend data for mini graph
	TrendColor  string           // Primary color for trend (lighter)
	TrendColor2 string           // Secondary color for trend (darker)
	Legend1     string           // Label for first legend item
	Legend2     string           // Label for second legend item
}

type StreamChartSpec struct {
	Points     []StreamPoint  // X positions with values for all series
	Series     []StreamSeries // Metadata for each series (colors, labels)
	Width      float64
	Height     float64
	Layout     string // "center", "wiggle", "silhouette" (default: center)
	Smooth     bool   // Use smooth curves
	Title      string
	XAxisLabel string
	ShowLegend bool
}

type StreamPoint struct {
	X      float64
	Values []float64 // One value per series
}

type StreamSeries struct {
	Label string
	Color string
}

type SunburstArc struct {
	InnerRadius float64
	OuterRadius float64
	StartAngle  float64 // In radians
	EndAngle    float64 // In radians
	Node        *TreeNode
	Depth       int
}

type SunburstSpec struct {
	Root        *TreeNode
	Width       float64
	Height      float64
	InnerRadius float64 // Radius of center hole (0 for no hole)
	ShowLabels  bool
	ColorScheme []string
	StartAngle  float64 // Starting angle in degrees (0 = top)
}

type TerminalColorMode int

type TerminalOutput struct {
	Content string
}

type TerminalRenderer struct{}

type TimeSeriesData struct {
	Date  time.Time
	Value int
}

type TreeNode struct {
	Name     string
	Value    float64                // Size/weight of this node
	Children []*TreeNode            // Child nodes (nil for leaf nodes)
	Color    string                 // Optional custom color
	Metadata map[string]interface{} // Optional metadata
}

type TreemapRect struct {
	X, Y, Width, Height float64
	Node                *TreeNode
	Depth               int
}

type TreemapSpec struct {
	Root         *TreeNode
	Width        float64
	Height       float64
	Padding      float64 // Padding between rectangles
	ShowLabels   bool
	MinLabelSize float64  // Minimum rectangle size to show label
	ColorScheme  []string // Color palette
}

type ViolinPlotData struct {
	Values      []float64 // Raw data values
	Label       string    // Category label
	Color       string    // Fill color
	StrokeColor string    // Outline color
}

type ViolinPlotSpec struct {
	Data        []*ViolinPlotData
	Width       float64
	Height      float64
	Bandwidth   float64 // KDE bandwidth (0 = auto)
	ShowBox     bool    // If true, show box plot inside violin
	ShowMedian  bool    // If true, show median line
	ShowMean    bool    // If true, show mean marker
	ViolinWidth float64 // Maximum width of violin (0 = auto)

	// Axis configuration
	XAxisLabel string
	YAxisLabel string
}

type ViolinStats struct {
	Density []DensityPoint // KDE density points
	Mean    float64
	Median  float64
	Q1      float64
	Q3      float64
}

type WordCloudSpec struct {
	Words        []WordCloudWord
	Width        float64
	Height       float64
	MinFontSize  float64 // Minimum font size (default: 12)
	MaxFontSize  float64 // Maximum font size (default: 72)
	FontFamily   string  // Font family (default: sans-serif)
	DefaultColor string  // Default word color
	Layout       string  // "spiral", "horizontal" (default: spiral)
	Title        string
}

type WordCloudWord struct {
	Text      string
	Frequency float64 // Frequency/weight of the word
	Color     string  // Optional custom color
	Angle     float64 // Optional rotation angle in degrees (0 = horizontal)
}