reflex_copy/reflex/components/recharts/cartesian.py

"""Cartesian charts in Recharts."""

from __future__ import annotations

from typing import Any, Dict, List, Union

from reflex.constants import EventTriggers
from reflex.constants.colors import Color
from reflex.event import EventHandler, no_args_event_spec
from reflex.vars.base import LiteralVar, Var

from .recharts import (
    LiteralAnimationEasing,
    LiteralAreaType,
    LiteralDirection,
    LiteralIfOverflow,
    LiteralInterval,
    LiteralIntervalAxis,
    LiteralLayout,
    LiteralLegendType,
    LiteralLineType,
    LiteralOrientationLeftRight,
    LiteralOrientationTopBottom,
    LiteralOrientationTopBottomLeftRight,
    LiteralPolarRadiusType,
    LiteralScale,
    LiteralShape,
    LiteralTextAnchor,
    Recharts,
)


class Axis(Recharts):
    """A base class for axes in Recharts."""

    # The key of data displayed in the axis.
    data_key: Var[Union[str, int]]

    # If set true, the axis do not display in the chart. Default: False
    hide: Var[bool]

    # The width of axis which is usually calculated internally.
    width: Var[Union[str, int]]

    # The height of axis, which can be set by user.
    height: Var[Union[str, int]]

    # The type of axis 'number' | 'category'
    type_: Var[LiteralPolarRadiusType]

    # If set 0, all the ticks will be shown. If set preserveStart", "preserveEnd" or "preserveStartEnd", the ticks which is to be shown or hidden will be calculated automatically. Default: "preserveEnd"
    interval: Var[Union[LiteralIntervalAxis, int]]

    # Allow the ticks of Axis to be decimals or not. Default: True
    allow_decimals: Var[bool]

    # When domain of the axis is specified and the type of the axis is 'number', if allowDataOverflow is set to be false, the domain will be adjusted when the minimum value of data is smaller than domain[0] or the maximum value of data is greater than domain[1] so that the axis displays all data values. If set to true, graphic elements (line, area, bars) will be clipped to conform to the specified domain. Default: False
    allow_data_overflow: Var[bool]

    # Allow the axis has duplicated categorys or not when the type of axis is "category". Default: True
    allow_duplicated_category: Var[bool]

    # The range of the axis. Work best in conjunction with allow_data_overflow. Default: [0, "auto"]
    domain: Var[List]

    # If set false, no axis line will be drawn. Default: True
    axis_line: Var[bool]

    # If set true, flips ticks around the axis line, displaying the labels inside the chart instead of outside. Default: False
    mirror: Var[bool]

    # Reverse the ticks or not. Default: False
    reversed: Var[bool]

    # The label of axis, which appears next to the axis.
    label: Var[Union[str, int, Dict[str, Any]]]

    # If 'auto' set, the scale function is decided by the type of chart, and the props type. 'auto' | 'linear' | 'pow' | 'sqrt' | 'log' | 'identity' | 'time' | 'band' | 'point' | 'ordinal' | 'quantile' | 'quantize' | 'utc' | 'sequential' | 'threshold'. Default: "auto"
    scale: Var[LiteralScale]

    # The unit of data displayed in the axis. This option will be used to represent an index unit in a scatter chart.
    unit: Var[Union[str, int]]

    # The name of data displayed in the axis. This option will be used to represent an index in a scatter chart.
    name: Var[Union[str, int]]

    # Set the values of axis ticks manually.
    ticks: Var[List[Union[str, int]]]

    # If set false, no ticks will be drawn.
    tick: Var[bool]

    # The count of axis ticks. Not used if 'type' is 'category'. Default: 5
    tick_count: Var[int]

    # If set false, no axis tick lines will be drawn. Default: True
    tick_line: Var[bool]

    # The length of tick line. Default: 6
    tick_size: Var[int]

    # The minimum gap between two adjacent labels. Default: 5
    min_tick_gap: Var[int]

    # The stroke color of axis. Default: rx.color("gray", 9)
    stroke: Var[Union[str, Color]] = LiteralVar.create(Color("gray", 9))

    # The text anchor of axis. Default: "middle"
    text_anchor: Var[LiteralTextAnchor]

    # The customized event handler of click on the ticks of this axis
    on_click: EventHandler[no_args_event_spec]

    # The customized event handler of mousedown on the ticks of this axis
    on_mouse_down: EventHandler[no_args_event_spec]

    # The customized event handler of mouseup on the ticks of this axis
    on_mouse_up: EventHandler[no_args_event_spec]

    # The customized event handler of mousemove on the ticks of this axis
    on_mouse_move: EventHandler[no_args_event_spec]

    # The customized event handler of mouseout on the ticks of this axis
    on_mouse_out: EventHandler[no_args_event_spec]

    # The customized event handler of mouseenter on the ticks of this axis
    on_mouse_enter: EventHandler[no_args_event_spec]

    # The customized event handler of mouseleave on the ticks of this axis
    on_mouse_leave: EventHandler[no_args_event_spec]


class XAxis(Axis):
    """An XAxis component in Recharts."""

    tag = "XAxis"

    alias = "RechartsXAxis"

    # The orientation of axis 'top' | 'bottom'. Default: "bottom"
    orientation: Var[LiteralOrientationTopBottom]

    # The id of x-axis which is corresponding to the data. Default: 0
    x_axis_id: Var[Union[str, int]]

    # Ensures that all datapoints within a chart contribute to its domain calculation, even when they are hidden. Default: False
    include_hidden: Var[bool]

    # The angle of axis ticks. Default: 0
    angle: Var[int]

    # Specify the padding of x-axis. Default: {"left": 0, "right": 0}
    padding: Var[Dict[str, int]]


class YAxis(Axis):
    """A YAxis component in Recharts."""

    tag = "YAxis"

    alias = "RechartsYAxis"

    # The orientation of axis 'left' | 'right'. Default: "left"
    orientation: Var[LiteralOrientationLeftRight]

    # The id of y-axis which is corresponding to the data. Default: 0
    y_axis_id: Var[Union[str, int]]

    # Specify the padding of y-axis. Default: {"top": 0, "bottom": 0}
    padding: Var[Dict[str, int]]


class ZAxis(Recharts):
    """A ZAxis component in Recharts."""

    tag = "ZAxis"

    alias = "RechartsZAxis"

    # The key of data displayed in the axis.
    data_key: Var[Union[str, int]]

    # The unique id of z-axis. Default: 0
    z_axis_id: Var[Union[str, int]]

    # The range of axis. Default: [10, 10]
    range: Var[List[int]]

    # The unit of data displayed in the axis. This option will be used to represent an index unit in a scatter chart.
    unit: Var[Union[str, int]]

    # The name of data displayed in the axis. This option will be used to represent an index in a scatter chart.
    name: Var[Union[str, int]]

    # If 'auto' set, the scale function is decided by the type of chart, and the props type. Default: "auto"
    scale: Var[LiteralScale]


class Brush(Recharts):
    """A Brush component in Recharts."""

    tag = "Brush"

    alias = "RechartsBrush"

    # Stroke color. Default: rx.color("gray", 9)
    stroke: Var[Union[str, Color]] = LiteralVar.create(Color("gray", 9))

    # The fill color of brush. Default: rx.color("gray", 2)
    fill: Var[Union[str, Color]] = LiteralVar.create(Color("gray", 2))

    # The key of data displayed in the axis.
    data_key: Var[Union[str, int]]

    # The x-coordinate of brush. Default: 0
    x: Var[int]

    # The y-coordinate of brush. Default: 0
    y: Var[int]

    # The width of brush. Default: 0
    width: Var[int]

    # The height of brush. Default: 40
    height: Var[int]

    # The original data of a LineChart, a BarChart or an AreaChart.
    data: Var[List[Any]]

    # The width of each traveller. Default: 5
    traveller_width: Var[int]

    # The data with gap of refreshing chart. If the option is not set, the chart will be refreshed every time. Default: 1
    gap: Var[int]

    # The default start index of brush. If the option is not set, the start index will be 0. Default: 0
    start_index: Var[int]

    # The default end index of brush. If the option is not set, the end index will be calculated by the length of data.
    end_index: Var[int]

    # The fill color of brush
    fill: Var[Union[str, Color]]

    # The stroke color of brush
    stroke: Var[Union[str, Color]]

    def get_event_triggers(self) -> dict[str, Union[Var, Any]]:
        """Get the event triggers that pass the component's value to the handler.

        Returns:
            A dict mapping the event trigger to the var that is passed to the handler.
        """
        return {
            EventTriggers.ON_CHANGE: no_args_event_spec,
        }


class Cartesian(Recharts):
    """A base class for cartesian charts in Recharts."""

    # The layout of bar in the chart, usually inherited from parent. 'horizontal' | 'vertical'
    layout: Var[LiteralLayout]

    # The key of a group of data which should be unique in an area chart.
    data_key: Var[Union[str, int]]

    # The id of x-axis which is corresponding to the data. Default: 0
    x_axis_id: Var[Union[str, int]]

    # The id of y-axis which is corresponding to the data. Default: 0
    y_axis_id: Var[Union[str, int]]

    # The type of icon in legend. If set to 'none', no legend item will be rendered. 'line' | 'plainline' | 'square' | 'rect'| 'circle' | 'cross' | 'diamond' | 'star' | 'triangle' | 'wye' | 'none' optional
    legend_type: Var[LiteralLegendType]

    # If set false, animation of bar will be disabled. Default: True
    is_animation_active: Var[bool]

    # Specifies when the animation should begin, the unit of this option is ms. Default: 0
    animation_begin: Var[int]

    # Specifies the duration of animation, the unit of this option is ms. Default: 1500
    animation_duration: Var[int]

    # The type of easing function. Default: "ease"
    animation_easing: Var[LiteralAnimationEasing]

    # The unit of data. This option will be used in tooltip.
    unit: Var[Union[str, int]]

    # The name of data. This option will be used in tooltip and legend to represent the component. If no value was set to this option, the value of dataKey will be used alternatively.
    name: Var[Union[str, int]]

    # The customized event handler of animation start
    on_animation_start: EventHandler[no_args_event_spec]

    # The customized event handler of animation end
    on_animation_end: EventHandler[no_args_event_spec]

    # The customized event handler of click on the component in this group
    on_click: EventHandler[no_args_event_spec]

    # The customized event handler of mousedown on the component in this group
    on_mouse_down: EventHandler[no_args_event_spec]

    # The customized event handler of mouseup on the component in this group
    on_mouse_up: EventHandler[no_args_event_spec]

    # The customized event handler of mousemove on the component in this group
    on_mouse_move: EventHandler[no_args_event_spec]

    # The customized event handler of mouseover on the component in this group
    on_mouse_over: EventHandler[no_args_event_spec]

    # The customized event handler of mouseout on the component in this group
    on_mouse_out: EventHandler[no_args_event_spec]

    # The customized event handler of mouseenter on the component in this group
    on_mouse_enter: EventHandler[no_args_event_spec]

    # The customized event handler of mouseleave on the component in this group
    on_mouse_leave: EventHandler[no_args_event_spec]


class Area(Cartesian):
    """An Area component in Recharts."""

    tag = "Area"

    alias = "RechartsArea"

    # The color of the line stroke. Default: rx.color("accent", 9)
    stroke: Var[Union[str, Color]] = LiteralVar.create(Color("accent", 9))

    # The width of the line stroke. Default: 1
    stroke_width: Var[int]

    # The color of the area fill. Default: rx.color("accent", 5)
    fill: Var[Union[str, Color]] = LiteralVar.create(Color("accent", 5))

    # The interpolation type of area. And customized interpolation function can be set to type. 'basis' | 'basisClosed' | 'basisOpen' | 'bumpX' | 'bumpY' | 'bump' | 'linear' | 'linearClosed' | 'natural' | 'monotoneX' | 'monotoneY' | 'monotone' | 'step' | 'stepBefore' | 'stepAfter'. Default: "monotone"
    type_: Var[LiteralAreaType] = LiteralVar.create("monotone")

    # If false set, dots will not be drawn. If true set, dots will be drawn which have the props calculated internally. Default: False
    dot: Var[Union[bool, Dict[str, Any]]]

    # The dot is shown when user enter an area chart and this chart has tooltip. If false set, no active dot will not be drawn. If true set, active dot will be drawn which have the props calculated internally. Default: {stroke: rx.color("accent", 2), fill: rx.color("accent", 10)}
    active_dot: Var[Union[bool, Dict[str, Any]]] = LiteralVar.create(
        {
            "stroke": Color("accent", 2),
            "fill": Color("accent", 10),
        }
    )

    # If set false, labels will not be drawn. If set true, labels will be drawn which have the props calculated internally. Default: False
    label: Var[bool]

    # The value which can describle the line, usually calculated internally.
    base_line: Var[Union[str, List[Dict[str, Any]]]]

    # The coordinates of all the points in the area, usually calculated internally.
    points: Var[List[Dict[str, Any]]]

    # The stack id of area, when two areas have the same value axis and same stack_id, then the two areas are stacked in order.
    stack_id: Var[Union[str, int]]

    # Whether to connect a graph area across null points. Default: False
    connect_nulls: Var[bool]

    # Valid children components
    _valid_children: List[str] = ["LabelList"]


class Bar(Cartesian):
    """A Bar component in Recharts."""

    tag = "Bar"

    alias = "RechartsBar"

    # The color of the line stroke.
    stroke: Var[Union[str, Color]]

    # The width of the line stroke.
    stroke_width: Var[int]

    # The width of the line stroke. Default: Color("accent", 9)
    fill: Var[Union[str, Color]] = LiteralVar.create(Color("accent", 9))

    # If false set, background of bars will not be drawn. If true set, background of bars will be drawn which have the props calculated internally. Default: False
    background: Var[bool]

    # If false set, labels will not be drawn. If true set, labels will be drawn which have the props calculated internally. Default: False
    label: Var[bool]

    # The stack id of bar, when two bars have the same value axis and same stack_id, then the two bars are stacked in order.
    stack_id: Var[str]

    # The unit of data. This option will be used in tooltip.
    unit: Var[Union[str, int]]

    # The minimal height of a bar in a horizontal BarChart, or the minimal width of a bar in a vertical BarChart. By default, 0 values are not shown. To visualize a 0 (or close to zero) point, set the minimal point size to a pixel value like 3. In stacked bar charts, minPointSize might not be respected for tightly packed values. So we strongly recommend not using this prop in stacked BarCharts.
    min_point_size: Var[int]

    # The name of data. This option will be used in tooltip and legend to represent a bar. If no value was set to this option, the value of dataKey will be used alternatively.
    name: Var[Union[str, int]]

    # Size of the bar (if one bar_size is set then a bar_size must be set for all bars)
    bar_size: Var[int]

    # Max size of the bar
    max_bar_size: Var[int]

    # If set a value, the option is the radius of all the rounded corners. If set a array, the option are in turn the radiuses of top-left corner, top-right corner, bottom-right corner, bottom-left corner. Default: 0
    radius: Var[Union[int, List[int]]]

    # The active bar is shown when a user enters a bar chart and this chart has tooltip. If set to false, no active bar will be drawn. If set to true, active bar will be drawn with the props calculated internally. If passed an object, active bar will be drawn, and the internally calculated props will be merged with the key value pairs of the passed object.
    # active_bar: Var[Union[bool, Dict[str, Any]]] #noqa: ERA001

    # Valid children components
    _valid_children: List[str] = ["Cell", "LabelList", "ErrorBar"]


class Line(Cartesian):
    """A Line component in Recharts."""

    tag = "Line"

    alias = "RechartsLine"

    # The interpolation type of line. And customized interpolation function can be set to type. It's the same as type in Area.
    type_: Var[LiteralAreaType]

    # The color of the line stroke. Default: rx.color("accent", 9)
    stroke: Var[Union[str, Color]] = LiteralVar.create(Color("accent", 9))

    # The width of the line stroke. Default: 1
    stroke_width: Var[int]

    # The dot is shown when mouse enter a line chart and this chart has tooltip. If false set, no active dot will not be drawn. If true set, active dot will be drawn which have the props calculated internally. Default: {"stroke": rx.color("accent", 10), "fill": rx.color("accent", 4)}
    dot: Var[Union[bool, Dict[str, Any]]] = LiteralVar.create(
        {
            "stroke": Color("accent", 10),
            "fill": Color("accent", 4),
        }
    )

    # The dot is shown when user enter an area chart and this chart has tooltip. If false set, no active dot will not be drawn. If true set, active dot will be drawn which have the props calculated internally. Default: {"stroke": rx.color("accent", 2), "fill": rx.color("accent", 10)}
    active_dot: Var[Union[bool, Dict[str, Any]]] = LiteralVar.create(
        {
            "stroke": Color("accent", 2),
            "fill": Color("accent", 10),
        }
    )

    # If false set, labels will not be drawn. If true set, labels will be drawn which have the props calculated internally. Default: False
    label: Var[bool]

    # Hides the line when true, useful when toggling visibility state via legend. Default: False
    hide: Var[bool]

    # Whether to connect a graph line across null points.
    connect_nulls: Var[bool]

    # The unit of data. This option will be used in tooltip.
    unit: Var[Union[str, int]]

    # The coordinates of all the points in the line, usually calculated internally.
    points: Var[List[Dict[str, Any]]]

    # The pattern of dashes and gaps used to paint the line.
    stroke_dasharray: Var[str]

    # Valid children components
    _valid_children: List[str] = ["LabelList", "ErrorBar"]


class Scatter(Recharts):
    """A Scatter component in Recharts."""

    tag = "Scatter"

    alias = "RechartsScatter"

    # The source data, in which each element is an object.
    data: Var[List[Dict[str, Any]]]

    # The type of icon in legend. If set to 'none', no legend item will be rendered. 'line' | 'plainline' | 'square' | 'rect'| 'circle' | 'cross' | 'diamond' | 'square' | 'star' | 'triangle' | 'wye' | 'none'. Default: "circle"
    legend_type: Var[LiteralLegendType]

    # The id of x-axis which is corresponding to the data. Default: 0
    x_axis_id: Var[Union[str, int]]

    # The id of y-axis which is corresponding to the data. Default: 0
    y_axis_id: Var[Union[str, int]]

    # The id of z-axis which is corresponding to the data. Default: 0
    z_axis_id: Var[Union[str, int]]

    # If false set, line will not be drawn. If true set, line will be drawn which have the props calculated internally. Default: False
    line: Var[bool]

    # If a string set, specified symbol will be used to show scatter item. 'circle' | 'cross' | 'diamond' | 'square' | 'star' | 'triangle' | 'wye'. Default: "circle"
    shape: Var[LiteralShape]

    # If 'joint' set, line will generated by just jointing all the points. If 'fitting' set, line will be generated by fitting algorithm. 'joint' | 'fitting'. Default: "joint"
    line_type: Var[LiteralLineType]

    # The fill color of the scatter. Default: rx.color("accent", 9)
    fill: Var[Union[str, Color]] = LiteralVar.create(Color("accent", 9))

    # Valid children components.
    _valid_children: List[str] = ["LabelList", "ErrorBar"]

    # If set false, animation of bar will be disabled. Default: True in CSR, False in SSR
    is_animation_active: Var[bool]

    # Specifies when the animation should begin, the unit of this option is ms. Default: 0
    animation_begin: Var[int]

    # Specifies the duration of animation, the unit of this option is ms. Default: 1500
    animation_duration: Var[int]

    # The type of easing function. Default: "ease"
    animation_easing: Var[LiteralAnimationEasing]

    # The customized event handler of click on the component in this group
    on_click: EventHandler[no_args_event_spec]

    # The customized event handler of mousedown on the component in this group
    on_mouse_down: EventHandler[no_args_event_spec]

    # The customized event handler of mouseup on the component in this group
    on_mouse_up: EventHandler[no_args_event_spec]

    # The customized event handler of mousemove on the component in this group
    on_mouse_move: EventHandler[no_args_event_spec]

    # The customized event handler of mouseover on the component in this group
    on_mouse_over: EventHandler[no_args_event_spec]

    # The customized event handler of mouseout on the component in this group
    on_mouse_out: EventHandler[no_args_event_spec]

    # The customized event handler of mouseenter on the component in this group
    on_mouse_enter: EventHandler[no_args_event_spec]

    # The customized event handler of mouseleave on the component in this group
    on_mouse_leave: EventHandler[no_args_event_spec]


class Funnel(Recharts):
    """A Funnel component in Recharts."""

    tag = "Funnel"

    alias = "RechartsFunnel"

    # The source data, in which each element is an object.
    data: Var[List[Dict[str, Any]]]

    # The key or getter of a group of data which should be unique in a FunnelChart.
    data_key: Var[Union[str, int]]

    # The key of each sector's name. Default: "name"
    name_key: Var[str]

    # The type of icon in legend. If set to 'none', no legend item will be rendered. Default: "line"
    legend_type: Var[LiteralLegendType]

    # If set false, animation of line will be disabled. Default: True
    is_animation_active: Var[bool]

    # Specifies when the animation should begin, the unit of this option is ms. Default: 0
    animation_begin: Var[int]

    # Specifies the duration of animation, the unit of this option is ms. Default: 1500
    animation_duration: Var[int]

    # The type of easing function. 'ease' | 'ease-in' | 'ease-out' | 'ease-in-out' | 'linear'. Default "ease"
    animation_easing: Var[LiteralAnimationEasing]

    # Stroke color. Default: rx.color("gray", 3)
    stroke: Var[Union[str, Color]] = LiteralVar.create(Color("gray", 3))

    # The coordinates of all the trapezoids in the funnel, usually calculated internally.
    trapezoids: Var[List[Dict[str, Any]]]

    # Valid children components
    _valid_children: List[str] = ["LabelList", "Cell"]

    # The customized event handler of animation start
    on_animation_start: EventHandler[no_args_event_spec]

    # The customized event handler of animation end
    on_animation_end: EventHandler[no_args_event_spec]

    # The customized event handler of click on the component in this group
    on_click: EventHandler[no_args_event_spec]

    # The customized event handler of mousedown on the component in this group
    on_mouse_down: EventHandler[no_args_event_spec]

    # The customized event handler of mouseup on the component in this group
    on_mouse_up: EventHandler[no_args_event_spec]

    # The customized event handler of mousemove on the component in this group
    on_mouse_move: EventHandler[no_args_event_spec]

    # The customized event handler of mouseover on the component in this group
    on_mouse_over: EventHandler[no_args_event_spec]

    # The customized event handler of mouseout on the component in this group
    on_mouse_out: EventHandler[no_args_event_spec]

    # The customized event handler of mouseenter on the component in this group
    on_mouse_enter: EventHandler[no_args_event_spec]

    # The customized event handler of mouseleave on the component in this group
    on_mouse_leave: EventHandler[no_args_event_spec]


class ErrorBar(Recharts):
    """An ErrorBar component in Recharts."""

    tag = "ErrorBar"

    alias = "RechartsErrorBar"

    # Only used for ScatterChart with error bars in two directions. Only accepts a value of "x" or "y" and makes the error bars lie in that direction.
    direction: Var[LiteralDirection]

    # The key of a group of data which should be unique in an area chart.
    data_key: Var[Union[str, int]]

    # The width of the error bar ends. Default: 5
    width: Var[int]

    # The stroke color of error bar. Default: rx.color("gray", 8)
    stroke: Var[Union[str, Color]] = LiteralVar.create(Color("gray", 8))

    # The stroke width of error bar. Default: 1.5
    stroke_width: Var[Union[int, float]]


class Reference(Recharts):
    """A base class for reference components in Reference."""

    # The id of x-axis which is corresponding to the data. Default: 0
    x_axis_id: Var[Union[str, int]]

    # The id of y-axis which is corresponding to the data. Default: 0
    y_axis_id: Var[Union[str, int]]

    # Defines how to draw the reference line if it falls partly outside the canvas. If set to 'discard', the reference line will not be drawn at all. If set to 'hidden', the reference line will be clipped to the canvas. If set to 'visible', the reference line will be drawn completely. If set to 'extendDomain', the domain of the overflown axis will be extended such that the reference line fits into the canvas. Default: "discard"
    if_overflow: Var[LiteralIfOverflow]

    # If set a string or a number, default label will be drawn, and the option is content.
    label: Var[Union[str, int]]

    # If set true, the line will be rendered in front of bars in BarChart, etc. Default: False
    is_front: Var[bool]


class ReferenceLine(Reference):
    """A ReferenceLine component in Recharts."""

    tag = "ReferenceLine"

    alias = "RechartsReferenceLine"

    # If set a string or a number, a vertical line perpendicular to the x-axis specified by xAxisId will be drawn. If the specified x-axis is a number axis, the type of x must be Number. If the specified x-axis is a category axis, the value of x must be one of the categorys, otherwise no line will be drawn.
    x: Var[Union[str, int]]

    # If set a string or a number, a horizontal line perpendicular to the y-axis specified by yAxisId will be drawn. If the specified y-axis is a number axis, the type of y must be Number. If the specified y-axis is a category axis, the value of y must be one of the categorys, otherwise no line will be drawn.
    y: Var[Union[str, int]]

    # The color of the reference line.
    stroke: Var[Union[str, Color]]

    # The width of the stroke. Default: 1
    stroke_width: Var[Union[str, int]]

    # Valid children components
    _valid_children: List[str] = ["Label"]

    # Array of endpoints in { x, y } format. These endpoints would be used to draw the ReferenceLine.
    segment: List[Any] = []


class ReferenceDot(Reference):
    """A ReferenceDot component in Recharts."""

    tag = "ReferenceDot"

    alias = "RechartsReferenceDot"

    # If set a string or a number, a vertical line perpendicular to the x-axis specified by xAxisId will be drawn. If the specified x-axis is a number axis, the type of x must be Number. If the specified x-axis is a category axis, the value of x must be one of the categorys, otherwise no line will be drawn.
    x: Var[Union[str, int]]

    # If set a string or a number, a horizontal line perpendicular to the y-axis specified by yAxisId will be drawn. If the specified y-axis is a number axis, the type of y must be Number. If the specified y-axis is a category axis, the value of y must be one of the categorys, otherwise no line will be drawn.
    y: Var[Union[str, int]]

    # The radius of dot.
    r: Var[int]

    # The color of the area fill.
    fill: Var[Union[str, Color]]

    # The color of the line stroke.
    stroke: Var[Union[str, Color]]

    # Valid children components
    _valid_children: List[str] = ["Label"]

    # The customized event handler of click on the component in this chart
    on_click: EventHandler[no_args_event_spec]

    # The customized event handler of mousedown on the component in this chart
    on_mouse_down: EventHandler[no_args_event_spec]

    # The customized event handler of mouseup on the component in this chart
    on_mouse_up: EventHandler[no_args_event_spec]

    # The customized event handler of mouseover on the component in this chart
    on_mouse_over: EventHandler[no_args_event_spec]

    # The customized event handler of mouseout on the component in this chart
    on_mouse_out: EventHandler[no_args_event_spec]

    # The customized event handler of mouseenter on the component in this chart
    on_mouse_enter: EventHandler[no_args_event_spec]

    # The customized event handler of mousemove on the component in this chart
    on_mouse_move: EventHandler[no_args_event_spec]

    # The customized event handler of mouseleave on the component in this chart
    on_mouse_leave: EventHandler[no_args_event_spec]


class ReferenceArea(Recharts):
    """A ReferenceArea component in Recharts."""

    tag = "ReferenceArea"

    alias = "RechartsReferenceArea"

    # Stroke color
    stroke: Var[Union[str, Color]]

    # Fill color
    fill: Var[Union[str, Color]]

    # The opacity of area.
    fill_opacity: Var[float]

    # The id of x-axis which is corresponding to the data.
    x_axis_id: Var[Union[str, int]]

    # The id of y-axis which is corresponding to the data.
    y_axis_id: Var[Union[str, int]]

    # A boundary value of the area. If the specified x-axis is a number axis, the type of x must be Number. If the specified x-axis is a category axis, the value of x must be one of the categorys. If one of x1 or x2 is invalidate, the area will cover along x-axis.
    x1: Var[Union[str, int]]

    # A boundary value of the area. If the specified x-axis is a number axis, the type of x must be Number. If the specified x-axis is a category axis, the value of x must be one of the categorys. If one of x1 or x2 is invalidate, the area will cover along x-axis.
    x2: Var[Union[str, int]]

    # A boundary value of the area. If the specified y-axis is a number axis, the type of y must be Number. If the specified y-axis is a category axis, the value of y must be one of the categorys. If one of y1 or y2 is invalidate, the area will cover along y-axis.
    y1: Var[Union[str, int]]

    # A boundary value of the area. If the specified y-axis is a number axis, the type of y must be Number. If the specified y-axis is a category axis, the value of y must be one of the categorys. If one of y1 or y2 is invalidate, the area will cover along y-axis.
    y2: Var[Union[str, int]]

    # Defines how to draw the reference line if it falls partly outside the canvas. If set to 'discard', the reference line will not be drawn at all. If set to 'hidden', the reference line will be clipped to the canvas. If set to 'visible', the reference line will be drawn completely. If set to 'extendDomain', the domain of the overflown axis will be extended such that the reference line fits into the canvas. Default: "discard"
    if_overflow: Var[LiteralIfOverflow]

    # If set true, the line will be rendered in front of bars in BarChart, etc. Default: False
    is_front: Var[bool]

    # Valid children components
    _valid_children: List[str] = ["Label"]


class Grid(Recharts):
    """A base class for grid components in Recharts."""

    # The x-coordinate of grid. Default: 0
    x: Var[int]

    # The y-coordinate of grid. Default: 0
    y: Var[int]

    # The width of grid. Default: 0
    width: Var[int]

    # The height of grid. Default: 0
    height: Var[int]


class CartesianGrid(Grid):
    """A CartesianGrid component in Recharts."""

    tag = "CartesianGrid"

    alias = "RechartsCartesianGrid"

    # The horizontal line configuration. Default: True
    horizontal: Var[bool]

    # The vertical line configuration. Default: True
    vertical: Var[bool]

    # The x-coordinates in pixel values of all vertical lines. Default: []
    vertical_points: Var[List[Union[str, int]]]

    # The x-coordinates in pixel values of all vertical lines. Default: []
    horizontal_points: Var[List[Union[str, int]]]

    # The background of grid.
    fill: Var[Union[str, Color]]

    # The opacity of the background used to fill the space between grid lines.
    fill_opacity: Var[float]

    # The pattern of dashes and gaps used to paint the lines of the grid.
    stroke_dasharray: Var[str]

    # the stroke color of grid. Default: rx.color("gray", 7)
    stroke: Var[Union[str, Color]] = LiteralVar.create(Color("gray", 7))


class CartesianAxis(Grid):
    """A CartesianAxis component in Recharts."""

    tag = "CartesianAxis"

    alias = "RechartsCartesianAxis"

    # The orientation of axis 'top' | 'bottom' | 'left' | 'right'. Default: "bottom"
    orientation: Var[LiteralOrientationTopBottomLeftRight]

    # The box of viewing area. Default: {"x": 0, "y": 0, "width": 0, "height": 0}
    view_box: Var[Dict[str, Any]]

    # If set false, no axis line will be drawn. If set a object, the option is the configuration of axis line. Default: True
    axis_line: Var[bool]

    # If set false, no ticks will be drawn.
    tick: Var[bool]

    # If set false, no axis tick lines will be drawn. If set a object, the option is the configuration of tick lines. Default: True
    tick_line: Var[bool]

    # The length of tick line. Default: 6
    tick_size: Var[int]

    # If set 0, all the ticks will be shown. If set preserveStart", "preserveEnd" or "preserveStartEnd", the ticks which is to be shown or hidden will be calculated automatically. Default: "preserveEnd"
    interval: Var[LiteralInterval]

    # If set a string or a number, default label will be drawn, and the option is content.
    label: Var[Union[str, int]]

    # If set true, flips ticks around the axis line, displaying the labels inside the chart instead of outside. Default: False
    mirror: Var[bool]

    # The margin between tick line and tick.
    tick_margin: Var[int]


area = Area.create
bar = Bar.create
line = Line.create
scatter = Scatter.create
x_axis = XAxis.create
y_axis = YAxis.create
z_axis = ZAxis.create
brush = Brush.create
cartesian_axis = CartesianAxis.create
cartesian_grid = CartesianGrid.create
reference_line = ReferenceLine.create
reference_dot = ReferenceDot.create
reference_area = ReferenceArea.create
error_bar = ErrorBar.create
funnel = Funnel.create