SaaS-FrameWork 0.1.1__py3-none-any.whl

components/__init__.py

@@ -0,0 +1,119 @@
+"""FrameWork — public API root."""
+
+from components.theme.DEx_Theme import Colors, Spacing, build_theme, build_theme_from_color_theme
+from components.theme.DEx_ColorThemes import COLOR_THEMES, DEx_ColorTheme
+
+from components.primitives.DEx_Badge import DEx_Badge
+from components.primitives.DEx_Divider import DEx_Divider
+from components.primitives.DEx_SectionEyebrow import DEx_SectionEyebrow
+from components.primitives.DEx_StatusDot import DEx_StatusDot
+from components.primitives.DEx_Avatar import DEx_Avatar, DEx_AvatarGroup
+from components.primitives.DEx_Image import DEx_Image, DEx_ImagePlaceholder
+from components.primitives.DEx_Icon import DEx_Icon, DEx_IconBadge
+from components.primitives.DEx_Markdown import DEx_Markdown
+
+from components.cards.DEx_Card import DEx_Card
+from components.cards.DEx_MetricCard import DEx_MetricCard
+from components.cards.DEx_ContactCard import DEx_ContactCard
+
+from components.buttons.DEx_BtnPrimary import DEx_BtnPrimary
+from components.buttons.DEx_BtnGhost import DEx_BtnGhost
+from components.buttons.DEx_BtnIcon import DEx_BtnIcon
+from components.buttons.DEx_BtnFilled import DEx_BtnFilled
+from components.buttons.DEx_BtnTonal import DEx_BtnTonal
+from components.buttons.DEx_BtnText import DEx_BtnText
+from components.buttons.DEx_BtnFAB import DEx_BtnFAB
+from components.buttons.DEx_BtnSegmented import DEx_BtnSegmented
+from components.buttons.DEx_MenuBar import DEx_MenuBar
+from components.buttons.DEx_PopupMenu import DEx_PopupMenu
+
+from components.inputs.DEx_TextField import DEx_TextField
+from components.inputs.DEx_SearchField import DEx_SearchField
+from components.inputs.DEx_Dropdown import DEx_Dropdown
+from components.inputs.DEx_Checkbox import DEx_Checkbox
+from components.inputs.DEx_Switch import DEx_Switch
+from components.inputs.DEx_Radio import DEx_Radio
+from components.inputs.DEx_Slider import DEx_Slider
+from components.inputs.DEx_Chip import DEx_Chip
+from components.inputs.DEx_AutoComplete import DEx_AutoComplete
+from components.inputs.DEx_SearchBar import DEx_SearchBar
+from components.inputs.DEx_DatePicker import DEx_DateField, DEx_DateRangeField
+from components.inputs.DEx_TimePicker import DEx_TimeField, DEx_TimeRangeField
+from components.inputs.DEx_FilePicker import DEx_FilePicker, DEx_FilePickerButton
+
+from components.data.DEx_DataTable import DEx_DataTable
+from components.data.DEx_PipelineColumn import DEx_PipelineColumn
+from components.data.DEx_TreeView import DEx_TreeView
+from components.data.DEx_ListTile import DEx_ListTile
+from components.data.DEx_ExpansionTile import DEx_ExpansionTile
+from components.data.DEx_ExpansionPanel import DEx_ExpansionPanel
+from components.data.DEx_ListView import DEx_ListView
+from components.data.DEx_GridView import DEx_GridView
+
+from components.layout.DEx_AppShell import DEx_AppShell
+from components.layout.DEx_Sidebar import DEx_Sidebar
+from components.layout.DEx_Header import DEx_Header
+from components.layout.DEx_NavItem import DEx_NavItem
+from components.layout.DEx_Tabs import DEx_Tabs, DEx_Tab
+from components.layout.DEx_NavigationBar import DEx_NavigationBar
+from components.layout.DEx_NavigationRail import DEx_NavigationRail
+from components.layout.DEx_NavigationDrawer import DEx_NavigationDrawer
+from components.layout.DEx_AppBar import DEx_AppBar, DEx_BottomAppBar
+from components.layout.DEx_Stack import DEx_Stack, DEx_StackOverlay, DEx_StackBadge
+from components.layout.DEx_ResponsiveRow import DEx_ResponsiveRow, DEx_Col
+from components.layout.DEx_GestureDetector import DEx_GestureDetector, DEx_Hoverable
+from components.layout.DEx_Draggable import DEx_Draggable, DEx_DragTarget
+from components.layout.DEx_AnimatedSwitcher import DEx_AnimatedSwitcher, DEx_AnimatedContainer
+
+from components.feedback.DEx_Notify import DEx_Notify
+from components.feedback.DEx_AlertDialog import DEx_AlertDialog
+from components.feedback.DEx_BottomSheet import DEx_BottomSheet
+from components.feedback.DEx_Banner import DEx_Banner
+from components.feedback.DEx_Tooltip import DEx_Tooltip
+from components.feedback.DEx_ProgressBar import DEx_ProgressBar
+from components.feedback.DEx_ProgressRing import DEx_ProgressRing
+from components.feedback.DEx_Shimmer import DEx_ShimmerCard, DEx_ShimmerListItem, DEx_ShimmerList
+
+__version__ = "0.1.1"
+
+__all__ = [
+    # theme
+    "Colors", "Spacing", "build_theme", "build_theme_from_color_theme", "COLOR_THEMES", "DEx_ColorTheme",
+    # primitives
+    "DEx_Badge", "DEx_Divider", "DEx_SectionEyebrow", "DEx_StatusDot",
+    "DEx_Avatar", "DEx_AvatarGroup", "DEx_Image", "DEx_ImagePlaceholder",
+    "DEx_Icon", "DEx_IconBadge", "DEx_Markdown",
+    # cards
+    "DEx_Card", "DEx_MetricCard", "DEx_ContactCard",
+    # buttons
+    "DEx_BtnPrimary", "DEx_BtnGhost", "DEx_BtnIcon", "DEx_BtnFilled",
+    "DEx_BtnTonal", "DEx_BtnText", "DEx_BtnFAB", "DEx_BtnSegmented",
+    "DEx_MenuBar", "DEx_PopupMenu",
+    # inputs
+    "DEx_TextField", "DEx_SearchField", "DEx_Dropdown", "DEx_Checkbox",
+    "DEx_Switch", "DEx_Radio", "DEx_Slider", "DEx_Chip",
+    "DEx_AutoComplete", "DEx_SearchBar",
+    "DEx_DateField", "DEx_DateRangeField",
+    "DEx_TimeField", "DEx_TimeRangeField",
+    "DEx_FilePicker", "DEx_FilePickerButton",
+    # data
+    "DEx_DataTable", "DEx_PipelineColumn", "DEx_TreeView",
+    "DEx_ListTile", "DEx_ExpansionTile", "DEx_ExpansionPanel",
+    "DEx_ListView", "DEx_GridView",
+    # layout
+    "DEx_AppShell", "DEx_Sidebar", "DEx_Header", "DEx_NavItem",
+    "DEx_Tabs", "DEx_Tab",
+    "DEx_NavigationBar", "DEx_NavigationRail", "DEx_NavigationDrawer", "DEx_AppBar",
+    "DEx_BottomAppBar",
+    "DEx_Stack", "DEx_StackOverlay", "DEx_StackBadge",
+    "DEx_ResponsiveRow", "DEx_Col",
+    "DEx_GestureDetector", "DEx_Hoverable",
+    "DEx_Draggable", "DEx_DragTarget",
+    "DEx_AnimatedSwitcher", "DEx_AnimatedContainer",
+    # feedback
+    "DEx_Notify", "DEx_AlertDialog", "DEx_BottomSheet", "DEx_Banner",
+    "DEx_Tooltip", "DEx_ProgressBar", "DEx_ProgressRing",
+    "DEx_ShimmerCard", "DEx_ShimmerListItem", "DEx_ShimmerList",
+    # meta
+    "__version__",
+]

components/buttons/DEx_BtnFAB.py

@@ -0,0 +1,37 @@
+import flet as ft
+from components.theme.DEx_Theme import Colors, Spacing
+
+COMPONENT_VERSION = "0.0.1"
+
+
+def DEx_BtnFAB(
+    icon: str,
+    label: str = "",
+    on_click=None,
+    mini: bool = False,
+) -> ft.FloatingActionButton:
+    """Floating action button for the primary creation or positive action on a screen.
+
+    Pass label for extended FAB; omit for compact circular form.
+    """
+    if label:
+        return ft.FloatingActionButton(
+            content=ft.Row(
+                [ft.Icon(icon, size=18, color=Colors.TEXT_PRIMARY), ft.Text(label, size=14, color=Colors.TEXT_PRIMARY)],
+                spacing=8,
+                tight=True,
+            ),
+            on_click=on_click,
+            bgcolor=Colors.ACCENT,
+            hover_color=Colors.ACCENT_DARK,
+            shape=ft.RoundedRectangleBorder(radius=Spacing.BUTTON_BORDER_RADIUS),
+        )
+    return ft.FloatingActionButton(
+        icon=icon,
+        on_click=on_click,
+        mini=mini,
+        bgcolor=Colors.ACCENT,
+        foreground_color=Colors.TEXT_PRIMARY,
+        hover_color=Colors.ACCENT_DARK,
+        shape=ft.RoundedRectangleBorder(radius=28),
+    )

components/buttons/DEx_BtnFilled.py

@@ -0,0 +1,20 @@
+import flet as ft
+from components.theme.DEx_Theme import Colors, Spacing
+
+COMPONENT_VERSION = "0.0.1"
+
+
+def DEx_BtnFilled(label: str, on_click=None, icon=None) -> ft.FilledButton:
+    """Primary filled button — highest emphasis action in a view."""
+    return ft.FilledButton(
+        content=label,
+        icon=icon,
+        on_click=on_click,
+        style=ft.ButtonStyle(
+            bgcolor=Colors.ACCENT,
+            color=Colors.TEXT_PRIMARY,
+            overlay_color=Colors.ACCENT_DARK,
+            shape=ft.RoundedRectangleBorder(radius=Spacing.BUTTON_BORDER_RADIUS),
+            padding=ft.Padding.symmetric(horizontal=Spacing.MD, vertical=Spacing.SM + 2),
+        ),
+    )

components/buttons/DEx_BtnGhost.py

@@ -0,0 +1,20 @@
+import flet as ft
+from components.theme.DEx_Theme import Colors, Spacing
+
+COMPONENT_VERSION = "0.0.1"
+
+
+def DEx_BtnGhost(label: str, on_click=None, icon=None) -> ft.OutlinedButton:
+    """Create the versioned secondary outlined button for lower-emphasis actions."""
+    return ft.OutlinedButton(
+        content=label,
+        icon=icon,
+        on_click=on_click,
+        style=ft.ButtonStyle(
+            color=Colors.TEXT_PRIMARY,
+            side=ft.BorderSide(1, Colors.BORDER),
+            overlay_color=Colors.BG_ELEVATED,
+            shape=ft.RoundedRectangleBorder(radius=Spacing.BUTTON_BORDER_RADIUS),
+            padding=ft.Padding.symmetric(horizontal=Spacing.MD, vertical=Spacing.SM + 2),
+        ),
+    )

components/buttons/DEx_BtnIcon.py

@@ -0,0 +1,18 @@
+import flet as ft
+from components.theme.DEx_Theme import Colors
+
+COMPONENT_VERSION = "0.0.1"
+
+
+def DEx_BtnIcon(icon, on_click=None, tooltip: str = "") -> ft.IconButton:
+    """Create the versioned icon-only action button with optional tooltip."""
+    return ft.IconButton(
+        icon=icon,
+        icon_color=Colors.TEXT_SECONDARY,
+        tooltip=tooltip,
+        on_click=on_click,
+        style=ft.ButtonStyle(
+            overlay_color=Colors.BG_ELEVATED,
+            shape=ft.RoundedRectangleBorder(radius=6),
+        ),
+    )

components/buttons/DEx_BtnPrimary.py

@@ -0,0 +1,21 @@
+import flet as ft
+from components.theme.DEx_Theme import Colors, Spacing
+
+COMPONENT_VERSION = "0.1.0"
+
+
+def DEx_BtnPrimary(label: str, on_click=None, icon=None) -> ft.Button:
+    """Create the versioned primary action button for main user commands."""
+    return ft.Button(
+        content=label,
+        icon=icon,
+        on_click=on_click,
+        bgcolor=Colors.ACCENT,
+        color=Colors.TEXT_PRIMARY,
+        elevation=1,
+        style=ft.ButtonStyle(
+            overlay_color=Colors.ACCENT_DARK,
+            shape=ft.RoundedRectangleBorder(radius=Spacing.BUTTON_BORDER_RADIUS),
+            padding=ft.Padding.symmetric(horizontal=Spacing.MD, vertical=Spacing.SM + 2),
+        ),
+    )

components/buttons/DEx_BtnSegmented.py

@@ -0,0 +1,45 @@
+import flet as ft
+from components.theme.DEx_Theme import Colors, Spacing
+
+COMPONENT_VERSION = "0.0.1"
+
+
+def DEx_BtnSegmented(
+    segments: list[dict],
+    selected: list[str] | set[str] | None = None,
+    on_change=None,
+    allow_multiple: bool = False,
+    allow_empty: bool = False,
+) -> ft.SegmentedButton:
+    """Multi-option toggle control for mutually exclusive or multi-select choices.
+
+    Each entry in segments: {"value": str, "label": str, "icon": str | None}
+    """
+    _selected = list(selected) if selected else [segments[0]["value"]]
+    return ft.SegmentedButton(
+        segments=[
+            ft.Segment(
+                value=s["value"],
+                label=ft.Text(s["label"], size=13),
+                icon=ft.Icon(s["icon"]) if s.get("icon") else None,
+            )
+            for s in segments
+        ],
+        selected=_selected,
+        on_change=on_change,
+        allow_multiple_selection=allow_multiple,
+        allow_empty_selection=allow_empty,
+        style=ft.ButtonStyle(
+            bgcolor={
+                ft.ControlState.SELECTED: Colors.ACCENT,
+                ft.ControlState.DEFAULT: Colors.BG_ELEVATED,
+            },
+            color={
+                ft.ControlState.SELECTED: Colors.TEXT_PRIMARY,
+                ft.ControlState.DEFAULT: Colors.TEXT_SECONDARY,
+            },
+            side=ft.BorderSide(1, Colors.BORDER),
+            shape=ft.RoundedRectangleBorder(radius=Spacing.BUTTON_BORDER_RADIUS),
+            padding=ft.Padding.symmetric(horizontal=Spacing.MD, vertical=Spacing.SM),
+        ),
+    )

components/buttons/DEx_BtnText.py

@@ -0,0 +1,19 @@
+import flet as ft
+from components.theme.DEx_Theme import Colors, Spacing
+
+COMPONENT_VERSION = "0.0.1"
+
+
+def DEx_BtnText(label: str, on_click=None, icon=None) -> ft.TextButton:
+    """Lowest-emphasis action button — no border, no background fill."""
+    return ft.TextButton(
+        content=label,
+        icon=icon,
+        on_click=on_click,
+        style=ft.ButtonStyle(
+            color=Colors.ACCENT,
+            overlay_color=Colors.BG_ELEVATED,
+            shape=ft.RoundedRectangleBorder(radius=Spacing.BUTTON_BORDER_RADIUS),
+            padding=ft.Padding.symmetric(horizontal=Spacing.SM, vertical=Spacing.SM + 2),
+        ),
+    )

components/buttons/DEx_BtnTonal.py

@@ -0,0 +1,20 @@
+import flet as ft
+from components.theme.DEx_Theme import Colors, Spacing
+
+COMPONENT_VERSION = "0.0.1"
+
+
+def DEx_BtnTonal(label: str, on_click=None, icon=None) -> ft.FilledTonalButton:
+    """Secondary filled button with muted emphasis — between outlined and filled."""
+    return ft.FilledTonalButton(
+        content=label,
+        icon=icon,
+        on_click=on_click,
+        style=ft.ButtonStyle(
+            bgcolor=Colors.BG_ELEVATED,
+            color=Colors.ACCENT,
+            overlay_color=Colors.ACCENT_DARK,
+            shape=ft.RoundedRectangleBorder(radius=Spacing.BUTTON_BORDER_RADIUS),
+            padding=ft.Padding.symmetric(horizontal=Spacing.MD, vertical=Spacing.SM + 2),
+        ),
+    )

components/buttons/DEx_MenuBar.py

@@ -0,0 +1,61 @@
+import flet as ft
+from components.theme.DEx_Theme import Colors, Spacing
+
+COMPONENT_VERSION = "0.0.1"
+
+_ITEM_STYLE = ft.ButtonStyle(
+    bgcolor={
+        ft.ControlState.HOVERED: Colors.BG_ELEVATED,
+        ft.ControlState.DEFAULT: Colors.BG_SURFACE,
+    },
+    color=Colors.TEXT_PRIMARY,
+    overlay_color=Colors.BG_ELEVATED,
+    padding=ft.Padding.symmetric(horizontal=Spacing.MD, vertical=Spacing.SM),
+)
+
+
+def DEx_MenuBarItem(
+    label: str,
+    children: list[ft.MenuItemButton | ft.SubmenuButton],
+) -> ft.SubmenuButton:
+    """Top-level menu entry inside a DEx_MenuBar."""
+    return ft.SubmenuButton(
+        content=ft.Text(label, size=13, color=Colors.TEXT_PRIMARY),
+        controls=children,
+        style=_ITEM_STYLE,
+    )
+
+
+def DEx_MenuItem(
+    label: str,
+    icon: str | None = None,
+    on_click=None,
+    shortcut: str = "",
+) -> ft.MenuItemButton:
+    """Single clickable item inside a submenu."""
+    return ft.MenuItemButton(
+        content=ft.Row(
+            [
+                ft.Text(label, size=13, color=Colors.TEXT_PRIMARY, expand=True),
+                ft.Text(shortcut, size=11, color=Colors.TEXT_MUTED) if shortcut else ft.Container(),
+            ],
+            spacing=Spacing.MD,
+        ),
+        leading=ft.Icon(icon, size=16, color=Colors.TEXT_SECONDARY) if icon else None,
+        on_click=on_click,
+        style=_ITEM_STYLE,
+    )
+
+
+def DEx_MenuBar(items: list[ft.SubmenuButton]) -> ft.MenuBar:
+    """Horizontal application menu bar styled with DEx tokens."""
+    return ft.MenuBar(
+        controls=items,
+        style=ft.MenuStyle(
+            bgcolor=Colors.BG_SURFACE,
+            shadow_color=ft.Colors.TRANSPARENT,
+            side=ft.BorderSide(0, ft.Colors.TRANSPARENT),
+            shape=ft.RoundedRectangleBorder(radius=0),
+            padding=ft.Padding.symmetric(horizontal=Spacing.SM, vertical=0),
+        ),
+    )

components/buttons/DEx_PopupMenu.py

@@ -0,0 +1,43 @@
+import flet as ft
+from components.theme.DEx_Theme import Colors, Spacing
+
+COMPONENT_VERSION = "0.0.1"
+
+
+def DEx_PopupMenuItem(
+    label: str,
+    icon: str | None = None,
+    on_click=None,
+    checked: bool | None = None,
+) -> ft.PopupMenuItem:
+    """Single item inside a DEx_PopupMenu."""
+    row_items: list[ft.Control] = []
+    if icon:
+        row_items.append(ft.Icon(icon, size=16, color=Colors.TEXT_SECONDARY))
+    row_items.append(ft.Text(label, size=13, color=Colors.TEXT_PRIMARY))
+    return ft.PopupMenuItem(
+        content=ft.Row(row_items, spacing=Spacing.SM, tight=True),
+        on_click=on_click,
+        checked=checked,
+    )
+
+
+def DEx_PopupMenuDivider() -> ft.PopupMenuItem:
+    """Visual separator between groups of popup menu items."""
+    return ft.PopupMenuItem()
+
+
+def DEx_PopupMenu(
+    items: list[ft.PopupMenuItem],
+    icon: str = ft.Icons.MORE_VERT,
+    tooltip: str = "Mais opções",
+    icon_color: str | None = None,
+) -> ft.PopupMenuButton:
+    """Context/overflow menu triggered by an icon button."""
+    return ft.PopupMenuButton(
+        icon=icon,
+        icon_color=icon_color or Colors.TEXT_SECONDARY,
+        tooltip=tooltip,
+        items=items,
+        menu_position=ft.PopupMenuPosition.UNDER,
+    )

components/cards/DEx_Card.py

@@ -0,0 +1,23 @@
+import flet as ft
+from components.theme.DEx_Theme import Colors, Spacing
+
+COMPONENT_VERSION = "0.0.1"
+
+
+def DEx_Card(
+    content: ft.Control,
+    padding: int = Spacing.MD,
+    elevated: bool = False,
+    width: int = 300,
+    expand: bool = False,
+) -> ft.Container:
+    """Create the versioned base card surface used by higher-level components."""
+    return ft.Container(
+        content=content,
+        bgcolor=Colors.BG_ELEVATED if elevated else Colors.BG_SURFACE,
+        border=ft.Border.all(1, Colors.BORDER),
+        border_radius=Spacing.CARD_BORDER_RADIUS,
+        padding=padding,
+        width=None if expand else width,
+        expand=expand,
+    )

components/cards/DEx_ContactCard.py

@@ -0,0 +1,52 @@
+import flet as ft
+from components.theme.DEx_Theme import Colors, Spacing
+from components.cards.DEx_Card import DEx_Card
+from components.primitives.DEx_Badge import DEx_Badge
+from components.primitives.DEx_Divider import DEx_Divider
+
+COMPONENT_VERSION = "0.0.1"
+
+
+def DEx_ContactCard(
+    name: str,
+    role: str,
+    company: str,
+    email: str = None,
+    tag: str = None,
+    value: str = None,
+) -> ft.Container:
+    """Create the versioned contact/entity card with avatar and optional footer."""
+    initials = "".join(p[0].upper() for p in name.split()[:2])
+
+    avatar = ft.Container(
+        content=ft.Text(initials, size=14, weight=ft.FontWeight.W_700, color=Colors.ACCENT),
+        width=42, height=42,
+        bgcolor=f"{Colors.ACCENT}22",
+        border_radius=21,
+        alignment=ft.Alignment(0, 0),
+    )
+
+    info = ft.Column([
+        ft.Text(name, size=14, weight=ft.FontWeight.W_600, color=Colors.TEXT_PRIMARY),
+        ft.Text(f"{role} · {company}", size=12, color=Colors.TEXT_SECONDARY),
+        ft.Text(email, size=12, color=Colors.DATA) if email else ft.Container(),
+    ], spacing=2, tight=True)
+
+    footer_controls = []
+    if tag:
+        footer_controls.append(
+            DEx_Badge(tag, color=f"{Colors.ACCENT}33", text_color=Colors.ACCENT)
+        )
+    if value:
+        footer_controls.append(
+            ft.Text(value, size=13, weight=ft.FontWeight.W_700, color=Colors.TEXT_PRIMARY)
+        )
+
+    return DEx_Card(ft.Column([
+        ft.Row([avatar, info], spacing=Spacing.MD),
+        DEx_Divider() if footer_controls else ft.Container(),
+        ft.Row(
+            footer_controls,
+            alignment=ft.MainAxisAlignment.SPACE_BETWEEN,
+        ) if footer_controls else ft.Container(),
+    ], spacing=Spacing.SM, tight=True))

components/cards/DEx_MetricCard.py

@@ -0,0 +1,36 @@
+import flet as ft
+from components.theme.DEx_Theme import Colors, Spacing
+from components.cards.DEx_Card import DEx_Card
+from components.primitives.DEx_StatusDot import DEx_StatusDot
+
+COMPONENT_VERSION = "0.0.1"
+
+
+def DEx_MetricCard(
+    label: str,
+    value: str,
+    delta: str = None,
+    delta_positive: bool = True,
+    icon=None,
+) -> ft.Container:
+    """Create the versioned metric card for KPI values and period deltas."""
+    delta_color = Colors.SUCCESS if delta_positive else Colors.DANGER
+
+    header_row = [ft.Text(label, size=12, color=Colors.TEXT_SECONDARY, weight=ft.FontWeight.W_500)]
+    if icon:
+        header_row.insert(0, ft.Icon(icon, size=14, color=Colors.TEXT_MUTED))
+
+    controls = [
+        ft.Row(header_row, spacing=Spacing.XS),
+        ft.Text(value, size=26, weight=ft.FontWeight.W_700, color=Colors.TEXT_PRIMARY),
+    ]
+    if delta:
+        controls.append(
+            ft.Row([
+                DEx_StatusDot(delta_color),
+                ft.Text(delta, size=12, color=delta_color, weight=ft.FontWeight.W_600),
+                ft.Text("vs período anterior", size=12, color=Colors.TEXT_MUTED),
+            ], spacing=Spacing.XS)
+        )
+
+    return DEx_Card(ft.Column(controls, spacing=Spacing.SM, tight=True))

components/data/DEx_DataTable.py

@@ -0,0 +1,82 @@
+import flet as ft
+from components.theme.DEx_Theme import Colors, Spacing
+
+COMPONENT_VERSION = "0.0.1"
+
+
+def _state_placeholder(state: str, empty_message: str, error_message: str) -> ft.Control:
+    if state == "loading":
+        return ft.Container(
+            content=ft.Column(
+                [ft.ProgressRing(width=32, height=32, stroke_width=3, color=Colors.ACCENT)],
+                alignment=ft.MainAxisAlignment.CENTER,
+                horizontal_alignment=ft.CrossAxisAlignment.CENTER,
+            ),
+            padding=Spacing.XL,
+        )
+    if state == "empty":
+        return ft.Container(
+            content=ft.Column(
+                [ft.Icon(ft.Icons.INBOX_ROUNDED, size=40, color=Colors.TEXT_MUTED),
+                 ft.Text(empty_message, size=13, color=Colors.TEXT_MUTED)],
+                alignment=ft.MainAxisAlignment.CENTER,
+                horizontal_alignment=ft.CrossAxisAlignment.CENTER,
+                spacing=Spacing.SM,
+            ),
+            padding=Spacing.XL,
+        )
+    return ft.Container(
+        content=ft.Column(
+            [ft.Icon(ft.Icons.ERROR_ROUNDED, size=40, color=Colors.DANGER),
+             ft.Text(error_message, size=13, color=Colors.DANGER)],
+            alignment=ft.MainAxisAlignment.CENTER,
+            horizontal_alignment=ft.CrossAxisAlignment.CENTER,
+            spacing=Spacing.SM,
+        ),
+        padding=Spacing.XL,
+    )
+
+
+def DEx_DataTable(
+    columns: list[str],
+    rows: list[list[str]],
+    on_row_click=None,
+    state: str | None = None,
+    empty_message: str = "Nenhum registro encontrado.",
+    error_message: str = "Erro ao carregar os dados.",
+) -> ft.Control:
+    """Create the versioned data table with DEx headers, borders, and rows."""
+    if state in ("loading", "empty", "error"):
+        return _state_placeholder(state, empty_message, error_message)
+    return ft.DataTable(
+        columns=[
+            ft.DataColumn(
+                ft.Text(
+                    col.upper(),
+                    size=11,
+                    weight=ft.FontWeight.W_600,
+                    color=Colors.TEXT_MUTED,
+                    style=ft.TextStyle(letter_spacing=1.2),
+                )
+            )
+            for col in columns
+        ],
+        rows=[
+            ft.DataRow(
+                cells=[
+                    ft.DataCell(ft.Text(cell, size=13, color=Colors.TEXT_PRIMARY))
+                    for cell in row
+                ],
+                on_select_change=on_row_click,
+            )
+            for row in rows
+        ],
+        border=ft.Border.all(1, Colors.BORDER),
+        border_radius=Spacing.CARD_BORDER_RADIUS,
+        horizontal_lines=ft.BorderSide(1, Colors.BORDER),
+        heading_row_color=Colors.BG_ELEVATED,
+        heading_row_height=44,
+        data_row_min_height=48,
+        data_row_max_height=56,
+        column_spacing=Spacing.LG,
+    )

components/data/DEx_ExpansionPanel.py

@@ -0,0 +1,39 @@
+import flet as ft
+from components.theme.DEx_Theme import Colors, Spacing
+
+COMPONENT_VERSION = "0.0.1"
+
+
+def DEx_ExpansionPanel(
+    title: str,
+    content: ft.Control,
+    subtitle: str = "",
+    expanded: bool = False,
+) -> ft.ExpansionPanel:
+    """Single panel for use inside DEx_ExpansionPanelList."""
+    header = ft.ListTile(
+        title=ft.Text(title, size=14, color=Colors.TEXT_PRIMARY),
+        subtitle=ft.Text(subtitle, size=11, color=Colors.TEXT_SECONDARY) if subtitle else None,
+    )
+    return ft.ExpansionPanel(
+        header=header,
+        content=ft.Container(
+            content=content,
+            padding=ft.Padding.symmetric(horizontal=Spacing.MD, vertical=Spacing.SM),
+        ),
+        expanded=expanded,
+        bgcolor=Colors.BG_ELEVATED,
+    )
+
+
+def DEx_ExpansionPanelList(
+    panels: list[ft.ExpansionPanel],
+    on_change=None,
+) -> ft.ExpansionPanelList:
+    """Accordion-style list of expandable panels."""
+    return ft.ExpansionPanelList(
+        controls=panels,
+        on_change=on_change,
+        divider_color=Colors.BORDER,
+        elevation=0,
+    )