dex-framework 0.0.50__tar.gz

dex_framework-0.0.50/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Almir
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

dex_framework-0.0.50/MANIFEST.in

@@ -0,0 +1,5 @@
+include README.md
+include LICENSE
+recursive-include dex_framework *.py
+recursive-exclude dex_framework __pycache__/*
+recursive-exclude * *.pyc

dex_framework-0.0.50/PKG-INFO

@@ -0,0 +1,217 @@
+Metadata-Version: 2.4
+Name: dex-framework
+Version: 0.0.50
+Summary: Biblioteca reutilizável que encapsula todos os componentes do Flet v0.84.0, organizada em grupos temáticos.
+Author-email: Almir <almir.jg@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/almirjg/DEx-Framework_3
+Project-URL: Repository, https://github.com/almirjg/DEx-Framework_3
+Keywords: flet,ui,framework,components,saas,design-system
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: flet==0.84.0
+Provides-Extra: dev
+Requires-Dist: build>=1.0.0; extra == "dev"
+Requires-Dist: twine>=5.0.0; extra == "dev"
+Dynamic: license-file
+
+# DEx-Framework v0.0.49
+
+Biblioteca reutilizável que encapsula **todos os componentes do Flet v0.84.0**, organizada em grupos temáticos, com UseCases demonstrativos para cada grupo.
+
+---
+
+## Instalação
+
+```bash
+pip install flet==0.84.0
+```
+
+Clone o repositório e adicione ao `PYTHONPATH` ou instale em modo editável:
+
+```bash
+git clone <repo-url>
+cd DEx-Framework_3
+pip install -e .
+```
+
+---
+
+## Uso básico
+
+### Exemplo 1 — Botão com dex_id e callback de montagem
+
+```python
+import flet as ft
+from dex_framework import DEx_ElevatedButton
+
+def main(page: ft.Page) -> None:
+    btn = DEx_ElevatedButton(
+        text="Salvar",
+        dex_id="btn_salvar",
+        on_click=lambda e: print("clicou"),
+        on_dex_ready=lambda c: print(f"{c.dex_id} montado"),
+    )
+    page.add(btn)
+
+ft.app(target=main)
+```
+
+### Exemplo 2 — Layout responsivo
+
+```python
+import flet as ft
+from dex_framework import DEx_ResponsiveRow, DEx_Container, DEx_Text
+
+def main(page: ft.Page) -> None:
+    row = DEx_ResponsiveRow(
+        dex_id="row_principal",
+        controls=[
+            DEx_Container(
+                col={"sm": 12, "md": 6},
+                content=DEx_Text("Coluna esquerda", dex_id="txt_esq"),
+                bgcolor=ft.Colors.BLUE_50,
+                padding=16,
+            ),
+            DEx_Container(
+                col={"sm": 12, "md": 6},
+                content=DEx_Text("Coluna direita", dex_id="txt_dir"),
+                bgcolor=ft.Colors.GREEN_50,
+                padding=16,
+            ),
+        ],
+    )
+    page.add(row)
+
+ft.app(target=main)
+```
+
+### Exemplo 3 — Tema customizado
+
+```python
+import flet as ft
+from dex_framework import DEx_Theme, DEx_ColorScheme
+
+def main(page: ft.Page) -> None:
+    page.theme = DEx_Theme(
+        color_scheme_seed=ft.Colors.INDIGO,
+        color_scheme=DEx_ColorScheme(
+            primary=ft.Colors.INDIGO,
+            secondary=ft.Colors.TEAL,
+            dex_id="esquema_app",
+        ),
+        dex_id="tema_app",
+    )
+    page.add(ft.Text("App com tema DEx!", size=24))
+
+ft.app(target=main)
+```
+
+---
+
+## Estrutura de grupos
+
+| Grupo | Componentes | Quantidade |
+|---|---|---|
+| `layout` | DEx_Row, DEx_Column, DEx_Stack, DEx_Container, DEx_ResponsiveRow, DEx_SafeArea | 6 |
+| `navigation` | DEx_AppBar, DEx_NavigationBar, DEx_NavigationRail, DEx_NavigationDrawer, DEx_Tabs, DEx_CupertinoNavigationBar | 6 |
+| `input` | DEx_TextField, DEx_Dropdown, DEx_Checkbox, DEx_Radio, DEx_RadioGroup, DEx_Switch, DEx_Slider, DEx_RangeSlider, DEx_DatePicker, DEx_TimePicker, DEx_CupertinoTextField, DEx_CupertinoCheckbox, DEx_CupertinoSlider, DEx_CupertinoSwitch | 14 |
+| `buttons` | DEx_ElevatedButton, DEx_FilledButton, DEx_FilledTonalButton, DEx_OutlinedButton, DEx_TextButton, DEx_IconButton, DEx_FloatingActionButton, DEx_PopupMenuButton, DEx_MenuItemButton, DEx_SubmenuButton, DEx_CupertinoButton, DEx_CupertinoFilledButton | 12 |
+| `display` | DEx_Text, DEx_Icon, DEx_Image, DEx_CircleAvatar, DEx_Card, DEx_DataTable, DEx_ListView, DEx_GridView, DEx_ListTile, DEx_ExpansionTile, DEx_ExpansionPanel, DEx_Markdown | 12 |
+| `feedback` | DEx_ProgressBar, DEx_ProgressRing, DEx_SnackBar, DEx_AlertDialog, DEx_Banner, DEx_Tooltip, DEx_Badge, DEx_Chip, DEx_CupertinoAlertDialog, DEx_CupertinoActivityIndicator | 10 |
+| `overlay` | DEx_BottomSheet, DEx_CupertinoBottomSheet, DEx_Drawer, DEx_SearchBar, DEx_SearchAnchor, DEx_MenuBar, DEx_Pagelet | 7 |
+| `media` | DEx_Audio, DEx_Video, DEx_Lottie | 3 |
+| `canvas` | DEx_Canvas | 1 |
+| `maps` | DEx_Map | 1 |
+| `charts` | DEx_BarChart, DEx_LineChart, DEx_PieChart | 3 |
+| `scrolling` | DEx_ScrollableControl, DEx_DragTarget | 2 |
+| `interaction` | DEx_GestureDetector, DEx_Draggable, DEx_Dismissible, DEx_SelectionArea, DEx_TransparentPointer | 5 |
+| `theming` | DEx_Theme, DEx_ColorScheme | 2 |
+| **Total** | | **84** |
+
+---
+
+## Como rodar os UseCases
+
+Os UseCases ficam na pasta `usecases/` na raiz do projeto.
+Execute a partir da raiz do projeto (`DEx-Framework_3/`):
+
+```bash
+# Grupo buttons
+python -m usecases.buttons.UC_buttons
+
+# Grupo layout
+python -m usecases.layout.UC_layout
+
+# Grupo navigation
+python -m usecases.navigation.UC_navigation
+
+# Grupo input
+python -m usecases.input.UC_input
+
+# Grupo display
+python -m usecases.display.UC_display
+
+# Grupo feedback
+python -m usecases.feedback.UC_feedback
+
+# Grupo overlay
+python -m usecases.overlay.UC_overlay
+
+# Grupo media
+python -m usecases.media.UC_media
+
+# Grupo canvas
+python -m usecases.canvas.UC_canvas
+
+# Grupo maps
+python -m usecases.maps.UC_maps
+
+# Grupo charts
+python -m usecases.charts.UC_charts
+
+# Grupo scrolling
+python -m usecases.scrolling.UC_scrolling
+
+# Grupo interaction
+python -m usecases.interaction.UC_interaction
+
+# Grupo theming
+python -m usecases.theming.UC_theming
+```
+
+---
+
+## Convenções DEx
+
+Todos os componentes DEx seguem estas regras:
+
+- **Herança direta** de `ft.<NomeOriginal>` — 100% da API Flet preservada
+- **`dex_id: str`** — identificador keyword-only para rastreamento
+- **`on_dex_ready`** — callback disparado após montagem na árvore (`did_mount`)
+- **Type hints** em todas as assinaturas (PEP 484)
+- **Docstrings Google Style** em toda classe e método público
+
+```python
+# Todos os componentes aceitam:
+componente = DEx_<Nome>(
+    # ... parâmetros nativos do Flet ...
+    dex_id="meu_id",                        # identificador único
+    on_dex_ready=lambda c: print(c.dex_id), # callback de montagem
+)
+```
+
+---
+
+*DEx-Framework v3.0.0 — gerado via Claude Code*

dex_framework-0.0.50/README.md

@@ -0,0 +1,189 @@
+# DEx-Framework v0.0.49
+
+Biblioteca reutilizável que encapsula **todos os componentes do Flet v0.84.0**, organizada em grupos temáticos, com UseCases demonstrativos para cada grupo.
+
+---
+
+## Instalação
+
+```bash
+pip install flet==0.84.0
+```
+
+Clone o repositório e adicione ao `PYTHONPATH` ou instale em modo editável:
+
+```bash
+git clone <repo-url>
+cd DEx-Framework_3
+pip install -e .
+```
+
+---
+
+## Uso básico
+
+### Exemplo 1 — Botão com dex_id e callback de montagem
+
+```python
+import flet as ft
+from dex_framework import DEx_ElevatedButton
+
+def main(page: ft.Page) -> None:
+    btn = DEx_ElevatedButton(
+        text="Salvar",
+        dex_id="btn_salvar",
+        on_click=lambda e: print("clicou"),
+        on_dex_ready=lambda c: print(f"{c.dex_id} montado"),
+    )
+    page.add(btn)
+
+ft.app(target=main)
+```
+
+### Exemplo 2 — Layout responsivo
+
+```python
+import flet as ft
+from dex_framework import DEx_ResponsiveRow, DEx_Container, DEx_Text
+
+def main(page: ft.Page) -> None:
+    row = DEx_ResponsiveRow(
+        dex_id="row_principal",
+        controls=[
+            DEx_Container(
+                col={"sm": 12, "md": 6},
+                content=DEx_Text("Coluna esquerda", dex_id="txt_esq"),
+                bgcolor=ft.Colors.BLUE_50,
+                padding=16,
+            ),
+            DEx_Container(
+                col={"sm": 12, "md": 6},
+                content=DEx_Text("Coluna direita", dex_id="txt_dir"),
+                bgcolor=ft.Colors.GREEN_50,
+                padding=16,
+            ),
+        ],
+    )
+    page.add(row)
+
+ft.app(target=main)
+```
+
+### Exemplo 3 — Tema customizado
+
+```python
+import flet as ft
+from dex_framework import DEx_Theme, DEx_ColorScheme
+
+def main(page: ft.Page) -> None:
+    page.theme = DEx_Theme(
+        color_scheme_seed=ft.Colors.INDIGO,
+        color_scheme=DEx_ColorScheme(
+            primary=ft.Colors.INDIGO,
+            secondary=ft.Colors.TEAL,
+            dex_id="esquema_app",
+        ),
+        dex_id="tema_app",
+    )
+    page.add(ft.Text("App com tema DEx!", size=24))
+
+ft.app(target=main)
+```
+
+---
+
+## Estrutura de grupos
+
+| Grupo | Componentes | Quantidade |
+|---|---|---|
+| `layout` | DEx_Row, DEx_Column, DEx_Stack, DEx_Container, DEx_ResponsiveRow, DEx_SafeArea | 6 |
+| `navigation` | DEx_AppBar, DEx_NavigationBar, DEx_NavigationRail, DEx_NavigationDrawer, DEx_Tabs, DEx_CupertinoNavigationBar | 6 |
+| `input` | DEx_TextField, DEx_Dropdown, DEx_Checkbox, DEx_Radio, DEx_RadioGroup, DEx_Switch, DEx_Slider, DEx_RangeSlider, DEx_DatePicker, DEx_TimePicker, DEx_CupertinoTextField, DEx_CupertinoCheckbox, DEx_CupertinoSlider, DEx_CupertinoSwitch | 14 |
+| `buttons` | DEx_ElevatedButton, DEx_FilledButton, DEx_FilledTonalButton, DEx_OutlinedButton, DEx_TextButton, DEx_IconButton, DEx_FloatingActionButton, DEx_PopupMenuButton, DEx_MenuItemButton, DEx_SubmenuButton, DEx_CupertinoButton, DEx_CupertinoFilledButton | 12 |
+| `display` | DEx_Text, DEx_Icon, DEx_Image, DEx_CircleAvatar, DEx_Card, DEx_DataTable, DEx_ListView, DEx_GridView, DEx_ListTile, DEx_ExpansionTile, DEx_ExpansionPanel, DEx_Markdown | 12 |
+| `feedback` | DEx_ProgressBar, DEx_ProgressRing, DEx_SnackBar, DEx_AlertDialog, DEx_Banner, DEx_Tooltip, DEx_Badge, DEx_Chip, DEx_CupertinoAlertDialog, DEx_CupertinoActivityIndicator | 10 |
+| `overlay` | DEx_BottomSheet, DEx_CupertinoBottomSheet, DEx_Drawer, DEx_SearchBar, DEx_SearchAnchor, DEx_MenuBar, DEx_Pagelet | 7 |
+| `media` | DEx_Audio, DEx_Video, DEx_Lottie | 3 |
+| `canvas` | DEx_Canvas | 1 |
+| `maps` | DEx_Map | 1 |
+| `charts` | DEx_BarChart, DEx_LineChart, DEx_PieChart | 3 |
+| `scrolling` | DEx_ScrollableControl, DEx_DragTarget | 2 |
+| `interaction` | DEx_GestureDetector, DEx_Draggable, DEx_Dismissible, DEx_SelectionArea, DEx_TransparentPointer | 5 |
+| `theming` | DEx_Theme, DEx_ColorScheme | 2 |
+| **Total** | | **84** |
+
+---
+
+## Como rodar os UseCases
+
+Os UseCases ficam na pasta `usecases/` na raiz do projeto.
+Execute a partir da raiz do projeto (`DEx-Framework_3/`):
+
+```bash
+# Grupo buttons
+python -m usecases.buttons.UC_buttons
+
+# Grupo layout
+python -m usecases.layout.UC_layout
+
+# Grupo navigation
+python -m usecases.navigation.UC_navigation
+
+# Grupo input
+python -m usecases.input.UC_input
+
+# Grupo display
+python -m usecases.display.UC_display
+
+# Grupo feedback
+python -m usecases.feedback.UC_feedback
+
+# Grupo overlay
+python -m usecases.overlay.UC_overlay
+
+# Grupo media
+python -m usecases.media.UC_media
+
+# Grupo canvas
+python -m usecases.canvas.UC_canvas
+
+# Grupo maps
+python -m usecases.maps.UC_maps
+
+# Grupo charts
+python -m usecases.charts.UC_charts
+
+# Grupo scrolling
+python -m usecases.scrolling.UC_scrolling
+
+# Grupo interaction
+python -m usecases.interaction.UC_interaction
+
+# Grupo theming
+python -m usecases.theming.UC_theming
+```
+
+---
+
+## Convenções DEx
+
+Todos os componentes DEx seguem estas regras:
+
+- **Herança direta** de `ft.<NomeOriginal>` — 100% da API Flet preservada
+- **`dex_id: str`** — identificador keyword-only para rastreamento
+- **`on_dex_ready`** — callback disparado após montagem na árvore (`did_mount`)
+- **Type hints** em todas as assinaturas (PEP 484)
+- **Docstrings Google Style** em toda classe e método público
+
+```python
+# Todos os componentes aceitam:
+componente = DEx_<Nome>(
+    # ... parâmetros nativos do Flet ...
+    dex_id="meu_id",                        # identificador único
+    on_dex_ready=lambda c: print(c.dex_id), # callback de montagem
+)
+```
+
+---
+
+*DEx-Framework v3.0.0 — gerado via Claude Code*

dex_framework-0.0.50/dex_framework/__init__.py

@@ -0,0 +1,22 @@
+"""
+DEx-Framework v3.0.0
+Biblioteca reutilizável que encapsula todos os componentes do Flet v0.84.0.
+
+Uso básico:
+    from dex_framework import DEx_ElevatedButton, DEx_TextField, DEx_Column
+"""
+
+from .layout import *
+from .navigation import *
+from .input import *
+from .buttons import *
+from .display import *
+from .feedback import *
+from .overlay import *
+from .media import *
+from .canvas import *
+from .maps import *
+from .charts import *
+from .scrolling import *
+from .interaction import *
+from .theming import *

dex_framework-0.0.50/dex_framework/buttons/DEx_ActionButtons.py

@@ -0,0 +1,212 @@
+"""DEx_ActionButtons — barra de botões de ação direita-para-esquerda."""
+
+from __future__ import annotations
+from typing import Callable
+import flet as ft
+from dex_framework.theming.DEx_BrandThemes import DEx_BrandTheme
+
+
+class DEx_ActionButton:
+    """
+    Define um botão individual para uso em DEx_ActionButtons.
+
+    Params
+    ------
+    icon        : ícone do botão (opcional se text fornecido; obrigatório se sem text)
+    text        : rótulo do botão (opcional)
+    tooltip     : dica de contexto
+    on_click    : callback de clique
+    disabled    : botão desabilitado
+    button_type : tipo pré-definido — "exit" | "theme" | "brightness" | "user"
+                  define ícone padrão e comportamento embutido quando page é fornecido
+
+    Ícones e comportamentos padrão por tipo
+    ----------------------------------------
+    exit       → ft.Icons.LOGOUT          — fecha a janela
+    theme      → ft.Icons.PALETTE         — cicla entre temas por nome de marca
+    brightness → ft.Icons.BRIGHTNESS_6    — alterna entre modo claro e escuro
+    user       → ft.Icons.ACCOUNT_CIRCLE  — nasce como readonly (disabled=True)
+    """
+
+    _DEFAULT_ICONS: dict = {
+        "exit":       ft.Icons.LOGOUT,
+        "theme":      ft.Icons.PALETTE,
+        "brightness": ft.Icons.BRIGHTNESS_6,
+        "user":       ft.Icons.ACCOUNT_CIRCLE,
+    }
+
+    def __init__(
+        self,
+        icon: ft.IconData | None = None,
+        text: str | None = None,
+        tooltip: str | None = None,
+        on_click: Callable | None = None,
+        disabled: bool = False,
+        visible: bool = True,
+        button_type: str | None = None,
+    ) -> None:
+        self.button_type = button_type
+        self.text = text
+        self.icon = icon if icon is not None else self._DEFAULT_ICONS.get(button_type)
+        self.tooltip = tooltip
+        self.on_click = on_click
+        self.visible = visible
+        # "user" nasce como readonly salvo on_click explícito
+        self.disabled = disabled or (button_type == "user" and on_click is None)
+
+
+class DEx_ActionButtons(ft.Container):
+    """
+    Barra de botões de ação alinhada à direita, com quebra automática de linha.
+
+    Os botões são apresentados da direita para a esquerda conforme a ordem de
+    criação: o primeiro botão da lista aparece mais à direita. Quando o total
+    de botões ultrapassa a largura disponível, uma segunda linha é criada com
+    o mesmo alinhamento.
+
+    O container_main (exposto publicamente) não é expansível — seu tamanho é
+    determinado pelo conteúdo.
+
+    Params
+    ------
+    buttons : lista de DEx_ActionButton
+    page    : referência à ft.Page (necessário para ações embutidas exit/theme)
+    dex_id, dex_theme, on_dex_ready : padrão DEx
+    """
+
+    # Ordem canônica de todas as marcas para o ciclo de temas
+    _ALL_BRANDS: list[str] = [
+        brand
+        for brands in DEx_BrandTheme.BRAND_GROUPS.values()
+        for brand in brands
+    ]
+
+    def __init__(
+        self,
+        buttons: list[DEx_ActionButton] | None = None,
+        page: ft.Page | None = None,
+        dex_id: str = "",
+        dex_theme: str = "dell",
+        on_dex_ready: Callable | None = None,
+        **kwargs,
+    ) -> None:
+        self.dex_id: str = dex_id
+        self.dex_theme: str = dex_theme
+        # Desembrulha _UCProxy (hub) para sempre guardar a ft.Page real.
+        # getattr(proxy, "_real", proxy) funciona porque _UCProxy armazena
+        # "_real" via super().__setattr__, logo __getattr__ não é chamado.
+        self._page = getattr(page, "_real", page) if page is not None else None
+        # -1 → primeira clicada vai sempre para índice 0 (bradesco, vermelho),
+        # garantindo contraste visual imediato independente do dex_theme inicial.
+        self._theme_idx: int = -1
+        self._theme_widget: ft.IconButton | None = None
+        self._brightness_widget: ft.IconButton | None = None
+
+        # Inverte a lista para que o 1º definido fique mais à direita
+        btn_list = list(buttons or [])
+        widgets = [self._build_widget(btn) for btn in reversed(btn_list)]
+
+        self.container_main = ft.Container(
+            content=ft.Row(
+                controls=widgets,
+                wrap=True,
+                alignment=ft.MainAxisAlignment.END,
+                tight=True,
+                spacing=4,
+                run_spacing=4,
+            ),
+            padding=ft.Padding.symmetric(horizontal=4, vertical=4),
+        )
+
+        super().__init__(content=self.container_main, **kwargs)
+
+        if on_dex_ready:
+            on_dex_ready(self)
+
+    # ── Resolução de clique ────────────────────────────────────────────
+
+    def _resolve_click(self, btn: DEx_ActionButton) -> Callable | None:
+        if btn.on_click:
+            return btn.on_click
+        if self._page is None:
+            return None
+        if btn.button_type == "exit":
+            return self._do_exit
+        if btn.button_type == "theme":
+            return self._next_theme
+        if btn.button_type == "brightness":
+            return self._toggle_brightness
+        return None
+
+    async def _do_exit(self, e) -> None:
+        if self._page:
+            await self._page.window.close()
+
+    def _toggle_brightness(self, e) -> None:
+        if self._page is None:
+            return
+        is_dark = self._page.theme_mode == ft.ThemeMode.DARK
+        self._page.theme_mode = ft.ThemeMode.LIGHT if is_dark else ft.ThemeMode.DARK
+        # Atualiza ícone e tooltip para refletir o novo estado
+        if self._brightness_widget is not None:
+            if self._page.theme_mode == ft.ThemeMode.DARK:
+                self._brightness_widget.icon = ft.Icons.BRIGHTNESS_2
+                self._brightness_widget.tooltip = "Modo escuro (clique para claro)"
+            else:
+                self._brightness_widget.icon = ft.Icons.BRIGHTNESS_HIGH
+                self._brightness_widget.tooltip = "Modo claro (clique para escuro)"
+            self._brightness_widget.update()
+        self._page.update()
+
+    def _next_theme(self, e) -> None:
+        self._theme_idx = (self._theme_idx + 1) % len(self._ALL_BRANDS)
+        brand = self._ALL_BRANDS[self._theme_idx]
+
+        # Atualiza tooltip com grupo e nome da marca
+        if self._theme_widget is not None:
+            group = next(
+                (g for g, brands in DEx_BrandTheme.BRAND_GROUPS.items() if brand in brands),
+                "",
+            )
+            group_label = DEx_BrandTheme.GROUP_META.get(group, {}).get("label", group)
+            brand_display = brand.replace("_", " ").title()
+            self._theme_widget.tooltip = f"{group_label} · {brand_display}"
+            self._theme_widget.update()
+
+        if self._page:
+            DEx_BrandTheme.apply(self._page, brand)
+
+    # ── Construção de widget por botão ─────────────────────────────────
+
+    def _build_widget(self, btn: DEx_ActionButton) -> ft.Control:
+        on_click = self._resolve_click(btn)
+
+        if btn.text:
+            if btn.icon:
+                content = ft.Row(
+                    [ft.Icon(btn.icon, size=16), ft.Text(btn.text, size=12)],
+                    spacing=4,
+                    tight=True,
+                )
+            else:
+                content = ft.Text(btn.text, size=12)
+            return ft.Button(
+                content=content,
+                tooltip=btn.tooltip,
+                on_click=on_click,
+                disabled=btn.disabled,
+            )
+
+        widget = ft.IconButton(
+            icon=btn.icon or ft.Icons.RADIO_BUTTON_UNCHECKED,
+            tooltip=btn.tooltip,
+            on_click=on_click,
+            disabled=btn.disabled,
+            visible=btn.visible,
+            icon_size=20,
+        )
+        if btn.button_type == "theme":
+            self._theme_widget = widget
+        if btn.button_type == "brightness":
+            self._brightness_widget = widget
+        return widget