dex-framework 0.0.50__py3-none-any.whl

dex_framework/buttons/DEx_OutlinedButton.py

@@ -0,0 +1,52 @@
+"""
+DEx_OutlinedButton — DEx-Framework v3.0.0
+Encapsula flet.OutlinedButton com padrões DEx.
+
+Uso básico:
+    from dex_framework.buttons import DEx_OutlinedButton
+    componente = DEx_OutlinedButton(...)
+"""
+
+from __future__ import annotations
+import flet as ft
+from typing import Any, Callable, Optional
+
+
+class DEx_OutlinedButton(ft.OutlinedButton):
+    """
+    Encapsulamento DEx do controle flet.OutlinedButton.
+
+    Mantém 100% da API original do Flet e adiciona:
+      - Valores padrão opinados (brand defaults)
+      - Parâmetro `dex_id` para rastreamento
+      - Hook `on_dex_ready` disparado após montagem
+
+    Args:
+        dex_id: Identificador único do componente na aplicação.
+        on_dex_ready: Callback chamado quando o componente é montado.
+        **kwargs: Todos os parâmetros nativos de flet.OutlinedButton.
+
+    Example:
+        >>> btn = DEx_OutlinedButton(
+        ...     dex_id="exemplo",
+        ... )
+    """
+
+    def __init__(
+        self,
+        *args: Any,
+        dex_id: str = "",
+        dex_theme: str = "dell",
+        on_dex_ready: Optional[Callable[["DEx_OutlinedButton"], None]] = None,
+        **kwargs: Any,
+    ) -> None:
+        super().__init__(*args, **kwargs)
+        self.dex_id: str = dex_id
+        self.dex_theme: str = dex_theme
+        self._on_dex_ready = on_dex_ready
+
+    def did_mount(self) -> None:
+        """Chamado pelo Flet quando o controle é inserido na árvore."""
+        super().did_mount()
+        if self._on_dex_ready:
+            self._on_dex_ready(self)

dex_framework/buttons/DEx_PopupMenuButton.py

@@ -0,0 +1,52 @@
+"""
+DEx_PopupMenuButton — DEx-Framework v3.0.0
+Encapsula flet.PopupMenuButton com padrões DEx.
+
+Uso básico:
+    from dex_framework.buttons import DEx_PopupMenuButton
+    componente = DEx_PopupMenuButton(...)
+"""
+
+from __future__ import annotations
+import flet as ft
+from typing import Any, Callable, Optional
+
+
+class DEx_PopupMenuButton(ft.PopupMenuButton):
+    """
+    Encapsulamento DEx do controle flet.PopupMenuButton.
+
+    Mantém 100% da API original do Flet e adiciona:
+      - Valores padrão opinados (brand defaults)
+      - Parâmetro `dex_id` para rastreamento
+      - Hook `on_dex_ready` disparado após montagem
+
+    Args:
+        dex_id: Identificador único do componente na aplicação.
+        on_dex_ready: Callback chamado quando o componente é montado.
+        **kwargs: Todos os parâmetros nativos de flet.PopupMenuButton.
+
+    Example:
+        >>> btn = DEx_PopupMenuButton(
+        ...     dex_id="exemplo",
+        ... )
+    """
+
+    def __init__(
+        self,
+        *args: Any,
+        dex_id: str = "",
+        dex_theme: str = "dell",
+        on_dex_ready: Optional[Callable[["DEx_PopupMenuButton"], None]] = None,
+        **kwargs: Any,
+    ) -> None:
+        super().__init__(*args, **kwargs)
+        self.dex_id: str = dex_id
+        self.dex_theme: str = dex_theme
+        self._on_dex_ready = on_dex_ready
+
+    def did_mount(self) -> None:
+        """Chamado pelo Flet quando o controle é inserido na árvore."""
+        super().did_mount()
+        if self._on_dex_ready:
+            self._on_dex_ready(self)

dex_framework/buttons/DEx_SubmenuButton.py

@@ -0,0 +1,52 @@
+"""
+DEx_SubmenuButton — DEx-Framework v3.0.0
+Encapsula flet.SubmenuButton com padrões DEx.
+
+Uso básico:
+    from dex_framework.buttons import DEx_SubmenuButton
+    componente = DEx_SubmenuButton(...)
+"""
+
+from __future__ import annotations
+import flet as ft
+from typing import Any, Callable, Optional
+
+
+class DEx_SubmenuButton(ft.SubmenuButton):
+    """
+    Encapsulamento DEx do controle flet.SubmenuButton.
+
+    Mantém 100% da API original do Flet e adiciona:
+      - Valores padrão opinados (brand defaults)
+      - Parâmetro `dex_id` para rastreamento
+      - Hook `on_dex_ready` disparado após montagem
+
+    Args:
+        dex_id: Identificador único do componente na aplicação.
+        on_dex_ready: Callback chamado quando o componente é montado.
+        **kwargs: Todos os parâmetros nativos de flet.SubmenuButton.
+
+    Example:
+        >>> btn = DEx_SubmenuButton(
+        ...     dex_id="exemplo",
+        ... )
+    """
+
+    def __init__(
+        self,
+        *args: Any,
+        dex_id: str = "",
+        dex_theme: str = "dell",
+        on_dex_ready: Optional[Callable[["DEx_SubmenuButton"], None]] = None,
+        **kwargs: Any,
+    ) -> None:
+        super().__init__(*args, **kwargs)
+        self.dex_id: str = dex_id
+        self.dex_theme: str = dex_theme
+        self._on_dex_ready = on_dex_ready
+
+    def did_mount(self) -> None:
+        """Chamado pelo Flet quando o controle é inserido na árvore."""
+        super().did_mount()
+        if self._on_dex_ready:
+            self._on_dex_ready(self)

dex_framework/buttons/DEx_TextButton.py

@@ -0,0 +1,52 @@
+"""
+DEx_TextButton — DEx-Framework v3.0.0
+Encapsula flet.TextButton com padrões DEx.
+
+Uso básico:
+    from dex_framework.buttons import DEx_TextButton
+    componente = DEx_TextButton(...)
+"""
+
+from __future__ import annotations
+import flet as ft
+from typing import Any, Callable, Optional
+
+
+class DEx_TextButton(ft.TextButton):
+    """
+    Encapsulamento DEx do controle flet.TextButton.
+
+    Mantém 100% da API original do Flet e adiciona:
+      - Valores padrão opinados (brand defaults)
+      - Parâmetro `dex_id` para rastreamento
+      - Hook `on_dex_ready` disparado após montagem
+
+    Args:
+        dex_id: Identificador único do componente na aplicação.
+        on_dex_ready: Callback chamado quando o componente é montado.
+        **kwargs: Todos os parâmetros nativos de flet.TextButton.
+
+    Example:
+        >>> btn = DEx_TextButton(
+        ...     dex_id="exemplo",
+        ... )
+    """
+
+    def __init__(
+        self,
+        *args: Any,
+        dex_id: str = "",
+        dex_theme: str = "dell",
+        on_dex_ready: Optional[Callable[["DEx_TextButton"], None]] = None,
+        **kwargs: Any,
+    ) -> None:
+        super().__init__(*args, **kwargs)
+        self.dex_id: str = dex_id
+        self.dex_theme: str = dex_theme
+        self._on_dex_ready = on_dex_ready
+
+    def did_mount(self) -> None:
+        """Chamado pelo Flet quando o controle é inserido na árvore."""
+        super().did_mount()
+        if self._on_dex_ready:
+            self._on_dex_ready(self)

dex_framework/buttons/__init__.py

@@ -0,0 +1,30 @@
+from .DEx_ElevatedButton import DEx_ElevatedButton
+from .DEx_FilledButton import DEx_FilledButton
+from .DEx_FilledTonalButton import DEx_FilledTonalButton
+from .DEx_OutlinedButton import DEx_OutlinedButton
+from .DEx_TextButton import DEx_TextButton
+from .DEx_IconButton import DEx_IconButton
+from .DEx_FloatingActionButton import DEx_FloatingActionButton
+from .DEx_PopupMenuButton import DEx_PopupMenuButton
+from .DEx_MenuItemButton import DEx_MenuItemButton
+from .DEx_SubmenuButton import DEx_SubmenuButton
+from .DEx_CupertinoButton import DEx_CupertinoButton
+from .DEx_CupertinoFilledButton import DEx_CupertinoFilledButton
+from .DEx_ActionButtons import DEx_ActionButton, DEx_ActionButtons
+
+__all__ = [
+    "DEx_ElevatedButton",
+    "DEx_FilledButton",
+    "DEx_FilledTonalButton",
+    "DEx_OutlinedButton",
+    "DEx_TextButton",
+    "DEx_IconButton",
+    "DEx_FloatingActionButton",
+    "DEx_PopupMenuButton",
+    "DEx_MenuItemButton",
+    "DEx_SubmenuButton",
+    "DEx_CupertinoButton",
+    "DEx_CupertinoFilledButton",
+    "DEx_ActionButton",
+    "DEx_ActionButtons",
+]

dex_framework/canvas/DEx_Canvas.py

@@ -0,0 +1,50 @@
+"""
+DEx_Canvas — DEx-Framework v3.0.0
+Encapsula flet.canvas.Canvas com padrões DEx.
+
+Uso básico:
+    from dex_framework.canvas import DEx_Canvas
+    componente = DEx_Canvas(...)
+"""
+
+from __future__ import annotations
+import flet as ft
+import flet.canvas as cv
+from typing import Any, Callable, Optional
+
+
+class DEx_Canvas(cv.Canvas):
+    """
+    Encapsulamento DEx do controle flet.canvas.Canvas.
+
+    Mantém 100% da API original do Flet e adiciona:
+      - Parâmetro `dex_id` para rastreamento
+      - Hook `on_dex_ready` disparado após montagem
+
+    Args:
+        dex_id: Identificador único do componente na aplicação.
+        on_dex_ready: Callback chamado quando o componente é montado.
+        **kwargs: Todos os parâmetros nativos de flet.canvas.Canvas.
+
+    Example:
+        >>> canvas = DEx_Canvas(dex_id="meu_canvas")
+    """
+
+    def __init__(
+        self,
+        *args: Any,
+        dex_id: str = "",
+        dex_theme: str = "dell",
+        on_dex_ready: Optional[Callable[["DEx_Canvas"], None]] = None,
+        **kwargs: Any,
+    ) -> None:
+        super().__init__(*args, **kwargs)
+        self.dex_id: str = dex_id
+        self.dex_theme: str = dex_theme
+        self._on_dex_ready = on_dex_ready
+
+    def did_mount(self) -> None:
+        """Chamado pelo Flet quando o controle é inserido na árvore."""
+        super().did_mount()
+        if self._on_dex_ready:
+            self._on_dex_ready(self)

dex_framework/canvas/__init__.py

@@ -0,0 +1,3 @@
+from .DEx_Canvas import DEx_Canvas
+
+__all__ = ["DEx_Canvas"]

dex_framework/charts/DEx_BarChart.py

@@ -0,0 +1,82 @@
+"""
+DEx_BarChart — DEx-Framework v3.0.0
+Stub: flet.BarChart não está disponível no flet 0.84.0 base.
+Requer pacote adicional (flet-charts).
+
+Uso básico:
+    from dex_framework.charts import DEx_BarChart
+    componente = DEx_BarChart(bar_groups=[...], dex_id="chart")
+"""
+
+from __future__ import annotations
+import flet as ft
+from typing import Any, Callable, List, Optional
+
+
+class DEx_BarChart(ft.Container):
+    """
+    Stub DEx para BarChart.
+
+    flet.BarChart não está disponível no flet 0.84.0 padrão.
+    Requer instalação do pacote flet-charts.
+    Este stub preserva a interface sem quebrar imports.
+
+    Args:
+        bar_groups: Lista de BarChartGroup com dados.
+        max_y: Valor máximo do eixo Y.
+        left_axis: Configuração do eixo esquerdo.
+        bottom_axis: Configuração do eixo inferior.
+        dex_id: Identificador único do componente na aplicação.
+        on_dex_ready: Callback chamado quando o componente é montado.
+        **kwargs: Parâmetros adicionais.
+
+    Example:
+        >>> chart = DEx_BarChart(bar_groups=[...], dex_id="vendas")
+    """
+
+    def __init__(
+        self,
+        *args: Any,
+        bar_groups: Optional[List[Any]] = None,
+        max_y: Optional[float] = None,
+        left_axis: Any = None,
+        bottom_axis: Any = None,
+        dex_id: str = "",
+        dex_theme: str = "dell",
+        on_dex_ready: Optional[Callable[["DEx_BarChart"], None]] = None,
+        **kwargs: Any,
+    ) -> None:
+        self.dex_id: str = dex_id
+        self.dex_theme: str = dex_theme
+        self._on_dex_ready = on_dex_ready
+        self.bar_groups = bar_groups or []
+        self.max_y = max_y
+        self.left_axis = left_axis
+        self.bottom_axis = bottom_axis
+        kwargs.pop("content", None)
+        kwargs.pop("bgcolor", None)
+        kwargs.pop("alignment", None)
+        kwargs.pop("border", None)
+        super().__init__(
+            content=ft.Column(
+                controls=[
+                    ft.Icon(ft.Icons.BAR_CHART, size=48, color=ft.Colors.GREY_400),
+                    ft.Text(
+                        "[BarChart stub — instale flet-charts]",
+                        color=ft.Colors.GREY,
+                        italic=True,
+                    ),
+                ],
+                horizontal_alignment=ft.CrossAxisAlignment.CENTER,
+            ),
+            bgcolor=ft.Colors.GREY_50,
+            alignment=ft.Alignment(0, 0),
+            border=ft.Border.all(1, ft.Colors.GREY_300),
+            **kwargs,
+        )
+
+    def did_mount(self) -> None:
+        """Chamado pelo Flet quando o controle é inserido na árvore."""
+        super().did_mount()
+        if self._on_dex_ready:
+            self._on_dex_ready(self)

dex_framework/charts/DEx_CandlestickChart.py

@@ -0,0 +1,288 @@
+"""
+DEx_CandlestickChart — DEx-Framework v3.0.0
+Gráfico de candlestick (OHLC) desenhado nativamente via ft.canvas.
+
+Não requer dependências externas — usa apenas flet.canvas disponível no
+flet 0.84.0 padrão.
+
+Uso básico:
+    from dex_framework.charts import DEx_CandlestickChart, DEx_Candle
+
+    candles = [
+        DEx_Candle("Jan", open=100, high=120, low=90,  close=115),
+        DEx_Candle("Fev", open=115, high=130, low=110, close=108),
+    ]
+    chart = DEx_CandlestickChart(candles=candles, dex_id="chart_ohlc")
+"""
+
+from __future__ import annotations
+
+import flet as ft
+import flet.canvas as cv
+from dataclasses import dataclass
+from typing import Any, Callable, List, Optional
+
+
+# ── Modelo de dado ────────────────────────────────────────────────────────────
+
+@dataclass
+class DEx_Candle:
+    """
+    Representa uma vela (candle) OHLC.
+
+    Args:
+        label: Rótulo exibido no eixo X (ex: "Jan", "2024").
+        open:  Preço / valor de abertura.
+        high:  Máxima do período.
+        low:   Mínima do período.
+        close: Preço / valor de fechamento.
+    """
+    label: str
+    open:  float
+    high:  float
+    low:   float
+    close: float
+
+
+# ── Componente ────────────────────────────────────────────────────────────────
+
+class DEx_CandlestickChart(ft.Container):
+    """
+    Gráfico de candlestick desenhado nativamente via ft.canvas.
+
+    Cada vela exibe wick (pavio) e corpo colorido:
+      - Verde  → fechamento acima da abertura (bullish)
+      - Vermelho → fechamento abaixo da abertura (bearish)
+      - Cinza  → fechamento igual à abertura (neutral)
+
+    Recursos:
+      - Escala Y automática com padding
+      - Grade horizontal configurável
+      - Rótulos nos eixos X e Y
+      - Título opcional
+      - Largura das velas proporcional ao slot disponível
+      - Sem dependências externas
+
+    Args:
+        candles: Lista de :class:`DEx_Candle` com os dados OHLC.
+        title: Título exibido no topo do gráfico.
+        width: Largura total do gráfico em pixels.
+        height: Altura total do gráfico em pixels.
+        candle_width_ratio: Fração do slot ocupada pelo corpo (0.0–1.0).
+        bullish_color: Cor da vela de alta.
+        bearish_color: Cor da vela de baixa.
+        neutral_color: Cor da vela neutra.
+        grid_color: Cor das linhas de grade.
+        show_grid: Exibe ou oculta a grade horizontal.
+        y_decimals: Casas decimais dos rótulos do eixo Y.
+        dex_id: Identificador único do componente.
+        dex_theme: Nome do tema de marca.
+        on_dex_ready: Callback chamado após montagem.
+        **kwargs: Parâmetros adicionais repassados a ``ft.Container``.
+
+    Example:
+        >>> chart = DEx_CandlestickChart(
+        ...     candles=[DEx_Candle("Jan", 100, 120, 90, 115)],
+        ...     title="OHLC Mensal",
+        ...     dex_id="chart_ohlc",
+        ... )
+    """
+
+    _MARGIN_LEFT   = 62
+    _MARGIN_RIGHT  = 14
+    _MARGIN_TOP    = 20
+    _MARGIN_BOTTOM = 30
+    _GRID_LINES    = 5
+
+    def __init__(
+        self,
+        candles: List[DEx_Candle],
+        *,
+        title: str = "",
+        width: float = 600,
+        height: float = 320,
+        candle_width_ratio: float = 0.55,
+        bullish_color: str = ft.Colors.GREEN_600,
+        bearish_color: str = ft.Colors.RED_500,
+        neutral_color: str = ft.Colors.BLUE_GREY_400,
+        grid_color: str = ft.Colors.OUTLINE_VARIANT,
+        show_grid: bool = True,
+        y_decimals: int = 0,
+        # DEx
+        dex_id: str = "",
+        dex_theme: str = "dell",
+        on_dex_ready: Optional[Callable[["DEx_CandlestickChart"], None]] = None,
+        **kwargs: Any,
+    ) -> None:
+        self._candles       = candles
+        self._title         = title
+        self._w             = width
+        self._h             = height
+        self._candle_ratio  = max(0.1, min(candle_width_ratio, 0.95))
+        self._bullish       = bullish_color
+        self._bearish       = bearish_color
+        self._neutral       = neutral_color
+        self._grid_color    = grid_color
+        self._show_grid     = show_grid
+        self._y_dec         = y_decimals
+
+        self.dex_id         = dex_id
+        self.dex_theme      = dex_theme
+        self._on_dex_ready  = on_dex_ready
+
+        kwargs.pop("content", None)
+
+        super().__init__(
+            width=width,
+            height=height,
+            content=self._build_canvas(),
+            **kwargs,
+        )
+
+    # ── Helpers de coordenadas ────────────────────────────────────────────────
+
+    def _y_range(self) -> tuple[float, float]:
+        """Calcula min/max com padding de 8%."""
+        lows  = [c.low  for c in self._candles]
+        highs = [c.high for c in self._candles]
+        lo, hi = min(lows), max(highs)
+        pad = (hi - lo) * 0.08 or abs(hi) * 0.05 or 1.0
+        return lo - pad, hi + pad
+
+    def _to_y(self, value: float, lo: float, hi: float) -> float:
+        chart_h = self._h - self._MARGIN_TOP - self._MARGIN_BOTTOM
+        ratio   = (value - lo) / (hi - lo) if hi != lo else 0.5
+        return self._MARGIN_TOP + chart_h * (1.0 - ratio)
+
+    def _slot(self, i: int) -> tuple[float, float]:
+        """Retorna (centro_x, largura_slot) para o índice i."""
+        n       = len(self._candles)
+        chart_w = self._w - self._MARGIN_LEFT - self._MARGIN_RIGHT
+        sw      = chart_w / n
+        cx      = self._MARGIN_LEFT + sw * i + sw / 2.0
+        return cx, sw
+
+    # ── Construção do canvas ──────────────────────────────────────────────────
+
+    def _build_canvas(self) -> cv.Canvas:
+        shapes: list = []
+
+        lbl_style   = ft.TextStyle(size=9,  color=ft.Colors.ON_SURFACE_VARIANT)
+        title_style = ft.TextStyle(size=11, weight=ft.FontWeight.W_600,
+                                   color=ft.Colors.ON_SURFACE)
+
+        if not self._candles:
+            shapes.append(cv.Text(
+                x=self._w / 2, y=self._h / 2,
+                value="Sem dados",
+                style=ft.TextStyle(size=13, color=ft.Colors.ON_SURFACE_VARIANT),
+                alignment=ft.Alignment(0, 0),
+            ))
+            return cv.Canvas(shapes=shapes, width=self._w, height=self._h)
+
+        lo, hi = self._y_range()
+        chart_h = self._h - self._MARGIN_TOP  - self._MARGIN_BOTTOM
+        chart_w = self._w - self._MARGIN_LEFT - self._MARGIN_RIGHT
+
+        # ── Título ────────────────────────────────────────────────────────
+        if self._title:
+            shapes.append(cv.Text(
+                x=self._MARGIN_LEFT + chart_w / 2,
+                y=4,
+                value=self._title,
+                style=title_style,
+                alignment=ft.Alignment(0, -1),
+            ))
+
+        # ── Grade + rótulos Y ─────────────────────────────────────────────
+        for i in range(self._GRID_LINES + 1):
+            ratio = i / self._GRID_LINES
+            gy    = self._MARGIN_TOP + chart_h * (1.0 - ratio)
+            val   = lo + (hi - lo) * ratio
+
+            if self._show_grid:
+                shapes.append(cv.Line(
+                    x1=self._MARGIN_LEFT,           y1=gy,
+                    x2=self._MARGIN_LEFT + chart_w, y2=gy,
+                    paint=ft.Paint(
+                        color=self._grid_color,
+                        stroke_width=1.0 if i == 0 else 0.5,
+                    ),
+                ))
+
+            fmt = f"{val:,.{self._y_dec}f}"
+            shapes.append(cv.Text(
+                x=self._MARGIN_LEFT - 5, y=gy,
+                value=fmt,
+                style=lbl_style,
+                alignment=ft.Alignment(1, 0),
+            ))
+
+        # ── Eixo esquerdo (borda) ─────────────────────────────────────────
+        shapes.append(cv.Line(
+            x1=self._MARGIN_LEFT, y1=self._MARGIN_TOP,
+            x2=self._MARGIN_LEFT, y2=self._MARGIN_TOP + chart_h,
+            paint=ft.Paint(color=ft.Colors.OUTLINE_VARIANT, stroke_width=1),
+        ))
+
+        # ── Velas ─────────────────────────────────────────────────────────
+        for i, c in enumerate(self._candles):
+            cx, sw = self._slot(i)
+            cw     = max(sw * self._candle_ratio, 2.0)
+
+            oy  = self._to_y(c.open,  lo, hi)
+            cly = self._to_y(c.close, lo, hi)
+            hy  = self._to_y(c.high,  lo, hi)
+            ly  = self._to_y(c.low,   lo, hi)
+
+            # Cor da vela
+            if c.close > c.open:
+                color = self._bullish
+            elif c.close < c.open:
+                color = self._bearish
+            else:
+                color = self._neutral
+
+            # Pavio (wick)
+            shapes.append(cv.Line(
+                x1=cx, y1=hy, x2=cx, y2=ly,
+                paint=ft.Paint(color=color, stroke_width=1.5),
+            ))
+
+            # Corpo (body)
+            body_top = min(oy, cly)
+            body_h   = max(abs(cly - oy), 2.0)
+
+            shapes.append(cv.Rect(
+                x=cx - cw / 2, y=body_top,
+                width=cw, height=body_h,
+                paint=ft.Paint(color=color, style=ft.PaintingStyle.FILL),
+            ))
+            shapes.append(cv.Rect(
+                x=cx - cw / 2, y=body_top,
+                width=cw, height=body_h,
+                paint=ft.Paint(
+                    color=ft.Colors.with_opacity(0.25, ft.Colors.ON_SURFACE),
+                    stroke_width=0.5,
+                    style=ft.PaintingStyle.STROKE,
+                ),
+            ))
+
+            # Rótulo X
+            shapes.append(cv.Text(
+                x=cx,
+                y=self._MARGIN_TOP + chart_h + 6,
+                value=c.label,
+                style=lbl_style,
+                alignment=ft.Alignment(0, -1),
+            ))
+
+        return cv.Canvas(shapes=shapes, width=self._w, height=self._h)
+
+    # ── Ciclo de vida DEx ─────────────────────────────────────────────────────
+
+    def did_mount(self) -> None:
+        """Chamado pelo Flet quando o controle é inserido na árvore."""
+        super().did_mount()
+        if self._on_dex_ready:
+            self._on_dex_ready(self)