annotations

type Anchor string

type Annotation interface {
	// Render renders the annotation to SVG
	Render(xScale, yScale scales.Scale) string
}

type AnnotationLayer struct {
	Annotations []Annotation
}

type AnnotationStyle struct {
	Stroke       string
	StrokeWidth  float64
	Fill         string
	Opacity      float64
	StrokeDash   string
	FontSize     units.Length
	FontFamily   string
	FontWeight   string
	TextAnchor   Anchor
	TextBaseline Baseline
	Color        string
}

type Arrow struct {
	// Start and end positions in data coordinates (if PositionData)
	X1, Y1, X2, Y2 interface{}

	// Pixel positions (if PositionPixel)
	PxX1, PxY1, PxX2, PxY2 float64

	// Positioning mode
	Mode Position

	// Arrow head style
	HeadSize   float64
	HeadStyle  ArrowHeadStyle
	ShowStart  bool // Show arrow head at start
	ShowEnd    bool // Show arrow head at end
	DoubleHead bool // Deprecated: use ShowStart and ShowEnd

	// Curvature for curved arrows (0 = straight)
	Curve float64

	Style AnnotationStyle
}

type ArrowHeadStyle string

type Baseline string

type CalloutLabel struct {
	Text string
	X, Y interface{} // Data point position

	// Label position offset from point (in pixels)
	LabelOffsetX, LabelOffsetY float64

	// Whether to draw connecting line
	ShowLine bool

	Style AnnotationStyle
}

type Connector struct {
	X1, Y1, X2, Y2 interface{}
	Mode           Position

	// Line style
	LineStyle ConnectorStyle
	Style     AnnotationStyle
}

type ConnectorStyle string

type Grid struct {
	// Show horizontal and vertical grid lines
	ShowHorizontal bool
	ShowVertical   bool

	// Number of grid lines (0 = auto based on scale ticks)
	HorizontalCount int
	VerticalCount   int

	Style AnnotationStyle
}

type MultilineText struct {
	Lines []string
	X, Y  interface{}
	Mode  Position

	// Line spacing (multiplier of font size)
	LineSpacing float64

	OffsetX, OffsetY float64
	Style            AnnotationStyle
}

type Orientation string

type Position string

type ReferenceLine struct {
	// Value in data coordinates
	Value interface{}

	// Orientation
	Orientation Orientation

	// Label (optional)
	Label string

	// Label position (0-1 along the line)
	LabelPosition float64

	// Label alignment
	LabelAnchor Anchor

	Style AnnotationStyle
}

type ReferenceRegion struct {
	// Data coordinates for region bounds
	X1, Y1, X2, Y2 interface{}

	// Use nil for unbounded dimensions (spans full range)
	Mode Position

	// Label (optional)
	Label string

	// Label position within region (0-1, 0-1)
	LabelX, LabelY float64

	Style AnnotationStyle
}

type TextLabel struct {
	// Text content
	Text string

	// Position in data coordinates (if PositionData)
	X, Y interface{}

	// Position in pixels (if PositionPixel)
	PxX, PxY float64

	// Position as relative (0-1) (if PositionRelative)
	RelX, RelY float64

	// Positioning mode
	Mode Position

	// Offset from position (in pixels)
	OffsetX, OffsetY float64

	// Rotation angle in degrees
	Rotation float64

	// Style
	Style AnnotationStyle
}