from typing import Optional

from flet.controls.animation import AnimationStyle
from flet.controls.base_control import control
from flet.controls.box import BoxConstraints
from flet.controls.buttons import OutlinedBorder
from flet.controls.control import Control
from flet.controls.dialog_control import DialogControl
from flet.controls.types import ClipBehavior, ColorValue, Number

__all__ = ["BottomSheet"]


@control("BottomSheet")
class BottomSheet(DialogControl):
    """
    A modal bottom sheet.

    Displays a temporary surface anchored to the bottom of the
    screen that presents supplemental content or actions.
    Prevents interaction with the underlying app while visible.

    Example:
    ```python
    sheet = ft.BottomSheet(
        content=ft.Column(
            width=150,
            alignment=ft.MainAxisAlignment.CENTER,
            horizontal_alignment=ft.CrossAxisAlignment.CENTER,
            controls=[
                ft.Text("Choose an option"),
                ft.TextButton("Dismiss"),
            ],
        )
    )
    page.show_dialog(sheet)
    ```
    """

    content: Control
    """
    The content of this bottom sheet.

	Tip:
		Set [`scrollable`][(c).] `True` if this content is or contains scrollable
		controls (e.g., [`ListView`][flet.], [`GridView`][flet.]) or you plan to
		`expand` the [`content`][(c).] or give it a custom height, else the bottom
		sheet might ignore the custom height and stop around mid-screen.
    """

    elevation: Optional[Number] = None
    """
    Defines the size of the shadow below this bottom sheet.

    Raises:
        ValueError: If it is strictly less than `0`.
    """

    bgcolor: Optional[ColorValue] = None
    """
    The background color of this bottom sheet.
    """

    dismissible: bool = True
    """
    Specifies whether this bottom sheet will be dismissed when user taps on the scrim.
    """

    draggable: bool = False
    """
    Specifies whether this bottom sheet can be dragged up and down and dismissed by \
    swiping downwards.
    """

    show_drag_handle: bool = False
    """
    Whether to display drag handle at the top of sheet or not.
    """

    use_safe_area: bool = True
    """
    Specifies whether the sheet will avoid system intrusions on the top, left, and \
    right.
    """

    scrollable: bool = False
    """
    Removes the half-height cap so the sheet can grow with its content.

    Set this to `True` whenever the sheet body contains scrollable controls
    (e.g., [`ListView`][flet.], [`GridView`][flet.]) or you plan to `expand` the
    [`content`][(c).] or give it a custom height, else the bottom sheet might
    ignore the custom height and stop around mid-screen.
    """

    fullscreen: bool = False
    """
    Expands the sheet to fill the window/page height.

    If set to `True`, [`scrollable`][(c).] is internally set to `True` equally,
    so the sheet can grow freely to fill the page.
    """

    maintain_bottom_view_insets_padding: bool = True
    """
    Adds a padding at the bottom to avoid obstructing this bottom sheet's \
    [`content`][(c).] with on-screen keyboard or other system elements.
    """

    animation_style: Optional[AnimationStyle] = None
    """
    The animation style of this bottom sheet.
    """

    size_constraints: Optional[BoxConstraints] = None
    """
    The size constraints to apply to this bottom sheet.
    """

    clip_behavior: Optional[ClipBehavior] = None
    """
    Defines how the content of this bottom sheet should be clipped.
    """

    shape: Optional[OutlinedBorder] = None
    """
    Defines the shape of this bottom sheet.
    """

    barrier_color: Optional[ColorValue] = None
    """
    The color of the scrim that obscures content behind this bottom sheet.
    """

    def before_update(self):
        super().before_update()
        if self.elevation is not None and self.elevation < 0:
            raise ValueError(
                f"elevation must be greater than or equal to zero, got {self.elevation}"
            )
