from dataclasses import dataclass, field
from typing import Optional, Union

from flet.controls.border_radius import (
    BorderRadius,
)
from flet.controls.box import BoxDecoration
from flet.controls.duration import Duration, DurationValue, OptionalDurationValue
from flet.controls.margin import OptionalMarginValue
from flet.controls.padding import OptionalPaddingValue
from flet.controls.text_style import TextStyle
from flet.controls.types import (
    MouseCursor,
    OptionalColorValue,
    OptionalNumber,
    TextAlign,
)


class TooltipTriggerMode:
    MANUAL = "manual"
    """"""

    TAP = "tap"
    """
    Tooltip will be shown after a single tap.
    """

    LONG_PRESS = "long_press"
    """
    Tooltip will be shown after a long press.
    """


@dataclass
class Tooltip:
    """
    Tooltips provide text labels which help explain the function of a button or
    other user interface action.
    """

    message: str
    """
    The text to display in the tooltip.
    """

    decoration: Optional[BoxDecoration] = field(
        default_factory=lambda: BoxDecoration(border_radius=BorderRadius.all(4.0))
    )
    """
    The tooltip's background decoration.
    """

    enable_feedback: Optional[bool] = None
    """
    When `True` (default) the tooltip should provide acoustic and/or haptic
    feedback.

    For example, on Android a tap will produce a clicking sound and a long-press
    will produce a short vibration, when feedback is enabled.
    """

    height: OptionalNumber = None
    """
    The height of the tooltip's content.
    """

    vertical_offset: OptionalNumber = None
    """
    The vertical gap between the control and the displayed tooltip.
    """

    margin: OptionalMarginValue = None
    """
    The empty space that surrounds the tooltip.

    Value is of type [`Margin`](https://flet.dev/docs/reference/types/margin)
    or a number.
    """

    padding: OptionalPaddingValue = None
    """
    The amount of space by which to inset the tooltip's content.

    The value is an instance of
    [`Padding`](https://flet.dev/docs/reference/types/padding) class or a number.

    On mobile, defaults to `16.0` logical pixels horizontally and `4.0` vertically.
    On desktop, defaults to `8.0` logical pixels horizontally and `4.0` vertically.
    """

    bgcolor: OptionalColorValue = None
    """
    Background [color](https://flet.dev/docs/reference/colors) of the tooltip.
    """

    text_style: Optional[TextStyle] = None
    """
    The [TextStyle](https://flet.dev/docs/reference/types/textstyle) to use for the
    message of the tooltip.
    """

    text_align: Optional[TextAlign] = None
    """
    How the message of the tooltip is aligned horizontally.

    Value is of type [`TextAlign`](https://flet.dev/docs/reference/types/textalign)
    and defaults to `TextAlign.LEFT`.
    """

    prefer_below: Optional[bool] = None
    """
    Whether the tooltip defaults to being displayed below the control.

    If there is insufficient space to display the tooltip in the preferred
    direction, the tooltip will be displayed in the opposite direction.

    Defaults to `True`.
    """

    show_duration: OptionalDurationValue = None
    """
    The length of time, in milliseconds, that the tooltip will be shown after a
    long press is released or a tap is released or mouse pointer exits the control.
    """

    wait_duration: DurationValue = field(
        default_factory=lambda: Duration(milliseconds=800)
    )
    """
    The length of time, in milliseconds, that a pointer must hover over a
    tooltip's control before the tooltip will be shown.

    Defaults to 800 milliseconds.
    """

    exit_duration: OptionalDurationValue = None
    """
    The length of time, in milliseconds, that the tooltip will be shown after a
    long press is released or a tap is released or mouse pointer exits the control.
    """

    enable_tap_to_dismiss: bool = True
    """
    Whether the tooltip can be dismissed by tapping on it.

    Defaults to `True`.
    """

    exclude_from_semantics: Optional[bool] = None
    """
    Whether the tooltip's message should be excluded from the semantics tree.

    Defaults to `False`.
    """

    trigger_mode: Optional[TooltipTriggerMode] = None
    """
    The mode of the tooltip's trigger.

    Value is of type
    [`TooltipTriggerMode`](https://flet.dev/docs/reference/types/tooltiptriggermode).
    """

    mouse_cursor: Optional[MouseCursor] = None
    """
    The cursor for a mouse pointer when it enters or is hovering over the content.
    """


TooltipValue = Union[str, Tooltip]