from typing import Optional

from flet.controls.base_control import control
from flet.controls.constrained_control import ConstrainedControl
from flet.controls.control import Control
from flet.controls.padding import PaddingValue
from flet.controls.types import (
    ClipBehavior,
    ColorValue,
    NotchShape,
    Number,
)

__all__ = ["BottomAppBar"]


@control("BottomAppBar")
class BottomAppBar(ConstrainedControl):
    """
    A material design bottom app bar.

    Raises:
        AssertionError: If [`elevation`][(c).] is negative.
    """

    content: Optional[Control] = None
    """
    The content of this bottom app bar.
    """

    surface_tint_color: Optional[ColorValue] = None
    """
    The color used as an overlay
    on [`bgcolor`][flet.BottomAppBar.bgcolor] to indicate elevation.

    If this is `None`, no overlay will be applied. Otherwise this color will be
    composited on top of `bgcolor` with an opacity related
    to [`elevation`][flet.BottomAppBar.elevation] and used to
    paint this app bar's background.
    """

    bgcolor: Optional[ColorValue] = None
    """
    The fill color to use for this
    app bar.

    Defaults to [`BottomAppBarTheme.bgcolor`][flet.BottomAppBarTheme.bgcolor], or if that is `None`,
    falls back to [`ColorScheme.surface`][flet.ColorScheme.surface].
    """

    shadow_color: Optional[ColorValue] = None
    """
    The color of the shadow below this app bar.
    """

    padding: Optional[PaddingValue] = None
    """
    Empty space to inscribe inside a container decoration (background, border).

    Defaults to [`BottomAppBarTheme.padding`][flet.BottomAppBarTheme.padding], or if that is `None`,
    falls back to `Padding.symmetric(vertical=12.0, horizontal=16.0)`.
    """

    clip_behavior: ClipBehavior = ClipBehavior.NONE
    """
    Defines how the [`content`][flet.BottomAppBar.content] of this app bar should be clipped.
    """

    shape: Optional[NotchShape] = None
    """
    The notch that is made for the floating action button.
    """

    notch_margin: Number = 4.0
    """
    The margin between the [`FloatingActionButton`][flet.FloatingActionButton] and this app bar's notch.

    Can be visible only if `shape=None`.
    """

    elevation: Optional[Number] = None
    """
    This property controls the size of the shadow below this app bar.
    """

    def before_update(self):
        super().before_update()
        assert self.elevation is None or self.elevation >= 0, (
            f"elevation must be greater than or equal to 0, got {self.elevation}"
        )