SaaS-FrameWork 0.1.1__py3-none-any.whl

components/data/DEx_ExpansionTile.py

@@ -0,0 +1,29 @@
+import flet as ft
+from components.theme.DEx_Theme import Colors, Spacing
+
+COMPONENT_VERSION = "0.0.1"
+
+
+def DEx_ExpansionTile(
+    title: str,
+    controls: list[ft.Control],
+    subtitle: str = "",
+    leading: ft.Control | None = None,
+    initially_expanded: bool = False,
+    on_change=None,
+) -> ft.ExpansionTile:
+    """Expandable list tile that reveals nested content."""
+    return ft.ExpansionTile(
+        title=ft.Text(title, size=14, color=Colors.TEXT_PRIMARY),
+        subtitle=ft.Text(subtitle, size=11, color=Colors.TEXT_SECONDARY) if subtitle else None,
+        leading=leading,
+        controls=controls,
+        expanded=initially_expanded,
+        on_change=on_change,
+        text_color=Colors.TEXT_PRIMARY,
+        icon_color=Colors.TEXT_SECONDARY,
+        collapsed_text_color=Colors.TEXT_SECONDARY,
+        collapsed_icon_color=Colors.TEXT_MUTED,
+        bgcolor=ft.Colors.TRANSPARENT,
+        collapsed_bgcolor=ft.Colors.TRANSPARENT,
+    )

components/data/DEx_GridView.py

@@ -0,0 +1,65 @@
+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_GridView(
+    controls: list[ft.Control],
+    runs_count: int = 3,
+    max_extent: int | None = None,
+    spacing: int | None = None,
+    run_spacing: int | None = None,
+    height: int | None = None,
+    padding: int | None = None,
+    state: str | None = None,
+    empty_message: str = "Nenhum item encontrado.",
+    error_message: str = "Erro ao carregar os itens.",
+) -> ft.Control:
+    """Responsive grid for cards, images and repeated items."""
+    if state in ("loading", "empty", "error"):
+        return _state_placeholder(state, empty_message, error_message)
+
+    _spacing = spacing if spacing is not None else Spacing.MD
+    return ft.GridView(
+        controls=controls,
+        runs_count=runs_count if max_extent is None else None,
+        max_extent=max_extent,
+        spacing=_spacing,
+        run_spacing=run_spacing if run_spacing is not None else _spacing,
+        height=height,
+        padding=padding or Spacing.XS,
+    )

components/data/DEx_ListTile.py

@@ -0,0 +1,27 @@
+import flet as ft
+from components.theme.DEx_Theme import Colors, Spacing
+
+COMPONENT_VERSION = "0.0.1"
+
+
+def DEx_ListTile(
+    title: str,
+    subtitle: str = "",
+    leading: ft.Control | None = None,
+    trailing: ft.Control | None = None,
+    on_click=None,
+    selected: bool = False,
+    dense: bool = False,
+) -> ft.ListTile:
+    """Styled list tile for use in lists, drawers and menus."""
+    return ft.ListTile(
+        title=ft.Text(title, size=13 if dense else 14, color=Colors.TEXT_PRIMARY),
+        subtitle=ft.Text(subtitle, size=11, color=Colors.TEXT_SECONDARY) if subtitle else None,
+        leading=leading,
+        trailing=trailing,
+        on_click=on_click,
+        selected=selected,
+        selected_color=Colors.ACCENT,
+        bgcolor=ft.Colors.TRANSPARENT,
+        dense=dense,
+    )

components/data/DEx_ListView.py

@@ -0,0 +1,65 @@
+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_ListView(
+    controls: list[ft.Control],
+    divider: bool = True,
+    spacing: int = 0,
+    padding: int | None = None,
+    height: int | None = None,
+    state: str | None = None,
+    empty_message: str = "Nenhum item encontrado.",
+    error_message: str = "Erro ao carregar os itens.",
+) -> ft.Control:
+    """Scrollable vertical list with optional dividers between items."""
+    if state in ("loading", "empty", "error"):
+        return _state_placeholder(state, empty_message, error_message)
+
+    items: list[ft.Control] = []
+    for i, ctrl in enumerate(controls):
+        items.append(ctrl)
+        if divider and i < len(controls) - 1:
+            items.append(ft.Divider(height=1, color=Colors.BORDER))
+
+    return ft.ListView(
+        controls=items,
+        spacing=spacing,
+        padding=padding or Spacing.XS,
+        height=height,
+    )

components/data/DEx_PipelineColumn.py

@@ -0,0 +1,74 @@
+import flet as ft
+from components.theme.DEx_Theme import Colors, Spacing
+from components.primitives.DEx_SectionEyebrow import DEx_SectionEyebrow
+from components.primitives.DEx_Divider import DEx_Divider
+
+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=28, height=28, 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=36, color=Colors.TEXT_MUTED),
+                 ft.Text(empty_message, size=12, color=Colors.TEXT_MUTED, text_align=ft.TextAlign.CENTER)],
+                alignment=ft.MainAxisAlignment.CENTER,
+                horizontal_alignment=ft.CrossAxisAlignment.CENTER,
+                spacing=Spacing.SM,
+            ),
+            padding=Spacing.LG,
+        )
+    return ft.Container(
+        content=ft.Column(
+            [ft.Icon(ft.Icons.ERROR_ROUNDED, size=36, color=Colors.DANGER),
+             ft.Text(error_message, size=12, color=Colors.DANGER, text_align=ft.TextAlign.CENTER)],
+            alignment=ft.MainAxisAlignment.CENTER,
+            horizontal_alignment=ft.CrossAxisAlignment.CENTER,
+            spacing=Spacing.SM,
+        ),
+        padding=Spacing.LG,
+    )
+
+
+def DEx_PipelineColumn(
+    stage_number: str,
+    stage_name: str,
+    count: int,
+    total_value: str,
+    cards: list[ft.Control],
+    state: str | None = None,
+    empty_message: str = "Nenhum card nesta etapa.",
+    error_message: str = "Erro ao carregar os cards.",
+) -> ft.Container:
+    """Create the versioned pipeline column for grouped workflow cards."""
+    body = (
+        _state_placeholder(state, empty_message, error_message)
+        if state in ("loading", "empty", "error")
+        else ft.Column([*cards], spacing=Spacing.SM, scroll=ft.ScrollMode.AUTO)
+    )
+    return ft.Container(
+        content=ft.Column([
+            DEx_SectionEyebrow(stage_number, stage_name),
+            ft.Row([
+                ft.Text(f"{count} itens", size=12, color=Colors.TEXT_SECONDARY),
+                ft.Text(total_value, size=12, weight=ft.FontWeight.W_700, color=Colors.DATA),
+            ], alignment=ft.MainAxisAlignment.SPACE_BETWEEN),
+            DEx_Divider(),
+            body,
+        ], spacing=Spacing.SM),
+        width=260,
+        bgcolor=Colors.BG_SURFACE,
+        border=ft.Border.all(1, Colors.BORDER),
+        border_radius=Spacing.CARD_BORDER_RADIUS,
+        padding=Spacing.MD,
+        expand=False,
+    )