SaaS-FrameWork 0.1.1__py3-none-any.whl

components/feedback/DEx_ProgressRing.py

@@ -0,0 +1,52 @@
+import flet as ft
+from components.theme.DEx_Theme import Colors, Spacing
+
+COMPONENT_VERSION = "0.0.2"
+
+
+def DEx_ProgressRing(
+    value: float | None = None,
+    size: int = 40,
+    stroke_width: float = 4,
+    color: str | None = None,
+    bgcolor: str | None = None,
+    label: str = "",
+) -> ft.Stack:
+    """Circular progress indicator with optional center label."""
+    ring = ft.ProgressRing(
+        value=value,
+        width=size,
+        height=size,
+        stroke_width=stroke_width,
+        color=color or Colors.ACCENT,
+        bgcolor=bgcolor or Colors.BG_ELEVATED,
+        stroke_align=-1,
+        year_2023=True,
+    )
+    label_text = ft.Container(
+        content=ft.Text(
+            label,
+            size=max(9, size // 5),
+            color=Colors.TEXT_PRIMARY,
+            weight=ft.FontWeight.W_600,
+            text_align=ft.TextAlign.CENTER,
+        ),
+        width=size,
+        height=size,
+        alignment=ft.Alignment(0, 0),
+    )
+    stack = ft.Stack(
+        [ring] if not label else [ring, label_text],
+        width=size,
+        height=size,
+        clip_behavior=ft.ClipBehavior.HARD_EDGE,
+        alignment=ft.Alignment(0, 0),
+    )
+    return ft.Container(
+        content=stack,
+        width=size,
+        height=size,
+        alignment=ft.Alignment(0, 0),
+        padding=ft.Padding.all(0),
+        clip_behavior=ft.ClipBehavior.HARD_EDGE,
+    )

components/feedback/DEx_Shimmer.py

@@ -0,0 +1,84 @@
+import flet as ft
+from components.theme.DEx_Theme import Colors, Spacing
+
+COMPONENT_VERSION = "0.0.1"
+
+
+def _shimmer_block(width: int | str, height: int, radius: int = 6) -> ft.Container:
+    """Single animated placeholder block."""
+    return ft.Container(
+        width=width if isinstance(width, int) else None,
+        expand=width == "expand",
+        height=height,
+        bgcolor=Colors.BG_ELEVATED,
+        border_radius=radius,
+        animate=ft.Animation(1200, ft.AnimationCurve.EASE_IN_OUT),
+    )
+
+
+def DEx_ShimmerCard(width: int = 280) -> ft.Container:
+    """Card-shaped shimmer skeleton for loading states."""
+    return ft.Container(
+        content=ft.Column([
+            ft.Row([
+                _shimmer_block(40, 40, radius=20),
+                ft.Container(width=Spacing.SM),
+                ft.Column([
+                    _shimmer_block(120, 12),
+                    ft.Container(height=4),
+                    _shimmer_block(80, 10),
+                    ft.Container(height=6),
+                    _shimmer_block(56, 8),
+                ], spacing=0, tight=True),
+                ft.Container(expand=True),
+                _shimmer_block(64, 24, radius=12),
+            ]),
+            ft.Container(height=Spacing.SM),
+            _shimmer_block("expand", 10),
+            ft.Container(height=4),
+            _shimmer_block("expand", 10),
+            ft.Container(height=4),
+            _shimmer_block(100, 10),
+            ft.Container(height=Spacing.SM),
+            ft.Row([
+                _shimmer_block(72, 20, radius=10),
+                ft.Container(width=Spacing.SM),
+                _shimmer_block(48, 20, radius=10),
+                ft.Container(width=Spacing.SM),
+                _shimmer_block(88, 20, radius=10),
+            ], wrap=True),
+        ], spacing=0, tight=True),
+        border_radius=Spacing.CARD_BORDER_RADIUS,
+        padding=Spacing.MD,
+        width=width,
+    )
+
+
+def DEx_ShimmerListItem() -> ft.Container:
+    """List item-shaped shimmer skeleton."""
+    return ft.Container(
+        content=ft.Row([
+            _shimmer_block(36, 36, radius=18),
+            ft.Container(width=Spacing.SM),
+            ft.Column([
+                _shimmer_block(140, 12),
+                ft.Container(height=4),
+                _shimmer_block(100, 10),
+                ft.Container(height=4),
+                _shimmer_block(72, 8),
+            ], spacing=0, tight=True),
+            ft.Container(expand=True),
+            _shimmer_block(44, 18, radius=9),
+        ]),
+        padding=ft.Padding.symmetric(horizontal=Spacing.SM, vertical=Spacing.SM),
+    )
+
+
+def DEx_ShimmerList(count: int = 3) -> ft.Column:
+    """Vertical list of shimmer list items."""
+    items: list[ft.Control] = []
+    for i in range(count):
+        items.append(DEx_ShimmerListItem())
+        if i < count - 1:
+            items.append(ft.Divider(height=1, color=Colors.BORDER))
+    return ft.Column(items, spacing=0, tight=True)

components/feedback/DEx_Tooltip.py

@@ -0,0 +1,24 @@
+import flet as ft
+from components.theme.DEx_Theme import Colors, Spacing
+
+COMPONENT_VERSION = "0.0.1"
+
+
+def DEx_Tooltip(
+    message: str,
+    content: ft.Control,
+    wait_duration: int = 300,
+) -> ft.Control:
+    """Aplica tooltip estilizado ao controle e o retorna."""
+    content.tooltip = ft.Tooltip(
+        message=message,
+        wait_duration=wait_duration,
+        bgcolor=Colors.BG_ELEVATED,
+        text_style=ft.TextStyle(size=12, color=Colors.TEXT_PRIMARY),
+        decoration=ft.BoxDecoration(
+            bgcolor=Colors.BG_ELEVATED,
+            border_radius=ft.BorderRadius.all(Spacing.SM),
+        ),
+        padding=ft.Padding.symmetric(horizontal=Spacing.SM, vertical=Spacing.XS),
+    )
+    return content

components/inputs/DEx_AutoComplete.py

@@ -0,0 +1,29 @@
+import flet as ft
+from components.theme.DEx_Theme import Colors, Spacing
+
+COMPONENT_VERSION = "0.0.1"
+
+
+def DEx_AutoComplete(
+    suggestions: list[str],
+    label: str = "",
+    hint: str = "",
+    on_select=None,
+) -> ft.AutoComplete:
+    """Text field with dropdown suggestion list from a predefined set of values."""
+    suggestions_view = ft.ListView(
+        controls=[
+            ft.ListTile(
+                title=ft.Text(s, size=13, color=Colors.TEXT_PRIMARY),
+                bgcolor=Colors.BG_SURFACE,
+                hover_color=Colors.BG_ELEVATED,
+            )
+            for s in suggestions
+        ],
+        padding=0,
+    )
+    return ft.AutoComplete(
+        suggestions=[ft.AutoCompleteSuggestion(key=s, value=s) for s in suggestions],
+        on_select=on_select,
+        suggestions_max_height=200,
+    )

components/inputs/DEx_Checkbox.py

@@ -0,0 +1,27 @@
+import flet as ft
+from components.theme.DEx_Theme import Colors, Spacing
+
+COMPONENT_VERSION = "0.0.1"
+
+
+def DEx_Checkbox(
+    label: str = "",
+    value: bool = False,
+    on_change=None,
+    tristate: bool = False,
+) -> ft.Checkbox:
+    """Styled checkbox for boolean or tristate selection."""
+    return ft.Checkbox(
+        label=label,
+        value=value,
+        on_change=on_change,
+        tristate=tristate,
+        active_color=Colors.ACCENT,
+        check_color=Colors.TEXT_PRIMARY,
+        border_side=ft.BorderSide(1.5, Colors.BORDER),
+        label_style=ft.TextStyle(size=13, color=Colors.TEXT_PRIMARY),
+        fill_color={
+            ft.ControlState.SELECTED: Colors.ACCENT,
+            ft.ControlState.DEFAULT: ft.Colors.TRANSPARENT,
+        },
+    )

components/inputs/DEx_Chip.py

@@ -0,0 +1,33 @@
+import flet as ft
+from components.theme.DEx_Theme import Colors, Spacing
+
+COMPONENT_VERSION = "0.0.1"
+
+
+def DEx_Chip(
+    label: str,
+    selected: bool = False,
+    on_select=None,
+    on_delete=None,
+    leading: ft.Control | None = None,
+    disabled: bool = False,
+) -> ft.Chip:
+    """Selectable tag chip for filters, categories, and multi-select inputs."""
+    return ft.Chip(
+        label=ft.Text(
+            label,
+            size=12,
+            color=Colors.TEXT_PRIMARY if selected else Colors.TEXT_SECONDARY,
+        ),
+        selected=selected,
+        on_select=on_select,
+        on_delete=on_delete,
+        leading=leading,
+        disabled=disabled,
+        selected_color=Colors.ACCENT,
+        bgcolor=Colors.BG_ELEVATED,
+        check_color=Colors.TEXT_PRIMARY,
+        border_side=ft.BorderSide(1, Colors.ACCENT if selected else Colors.BORDER),
+        shape=ft.RoundedRectangleBorder(radius=20),
+        padding=ft.Padding.symmetric(horizontal=Spacing.SM, vertical=Spacing.XS),
+    )

components/inputs/DEx_DatePicker.py

@@ -0,0 +1,72 @@
+import flet as ft
+from components.theme.DEx_Theme import Colors, Spacing
+
+COMPONENT_VERSION = "0.0.1"
+
+
+def DEx_DateField(
+    label: str = "Data",
+    value: str = "",
+    hint: str = "dd/mm/aaaa",
+    on_change=None,
+    width: int | None = None,
+) -> ft.TextField:
+    """Date field that opens a native calendar picker on icon click."""
+    picker = ft.DatePicker()
+
+    def _on_picked(e):
+        if e.control.value:
+            field.value = e.control.value.strftime("%d/%m/%Y")
+            try:
+                field.update()
+            except RuntimeError:
+                pass
+            if on_change:
+                on_change(e)
+
+    picker.on_change = _on_picked
+
+    def _open(e):
+        if not hasattr(e.page, "overlay"):
+            return
+        if picker not in e.page.overlay:
+            e.page.overlay.append(picker)
+            e.page.update()
+        picker.open = True
+        e.page.update()
+
+    field = ft.TextField(
+        label=label,
+        value=value,
+        hint_text=hint,
+        read_only=True,
+        suffix=ft.IconButton(
+            ft.Icons.CALENDAR_MONTH_ROUNDED,
+            on_click=_open,
+            icon_color=Colors.TEXT_SECONDARY,
+            icon_size=18,
+        ),
+        border_color=Colors.BORDER,
+        focused_border_color=Colors.ACCENT,
+        label_style=ft.TextStyle(color=Colors.TEXT_SECONDARY),
+        text_style=ft.TextStyle(color=Colors.TEXT_PRIMARY),
+        hint_style=ft.TextStyle(color=Colors.TEXT_MUTED),
+        cursor_color=Colors.ACCENT,
+        bgcolor=Colors.BG_ELEVATED,
+        width=width,
+    )
+    return field
+
+
+def DEx_DateRangeField(
+    start_label: str = "Data de início",
+    end_label: str = "Data de término",
+    on_change=None,
+    width: int | None = None,
+) -> ft.Column:
+    """Two date fields stacked vertically for date range input."""
+    return ft.Column([
+        DEx_DateField(label=start_label, on_change=on_change, width=width),
+        ft.Container(height=Spacing.SM),
+        DEx_DateField(label=end_label, on_change=on_change, width=width),
+    ], spacing=0, tight=True)

components/inputs/DEx_Dropdown.py

@@ -0,0 +1,25 @@
+import flet as ft
+from components.theme.DEx_Theme import Colors, Spacing
+
+COMPONENT_VERSION = "0.0.1"
+
+
+def DEx_Dropdown(
+    label: str,
+    options: list[str],
+    on_change=None,
+) -> ft.Dropdown:
+    """Create the versioned styled dropdown selector."""
+    dd = ft.Dropdown(
+        label=label,
+        options=[ft.dropdown.Option(o) for o in options],
+        border_color=Colors.BORDER,
+        focused_border_color=Colors.ACCENT,
+        label_style=ft.TextStyle(color=Colors.TEXT_SECONDARY, size=12),
+        text_style=ft.TextStyle(color=Colors.TEXT_PRIMARY, size=14),
+        bgcolor=Colors.BG_SURFACE,
+        border_radius=Spacing.BUTTON_BORDER_RADIUS,
+    )
+    if on_change is not None:
+        dd.on_change = on_change
+    return dd

components/inputs/DEx_FilePicker.py

@@ -0,0 +1,70 @@
+import flet as ft
+from components.theme.DEx_Theme import Colors, Spacing
+
+COMPONENT_VERSION = "0.1.0"
+
+
+def DEx_FilePicker(
+    on_result=None,
+    on_upload=None,
+    allowed_extensions: list[str] | None = None,
+    allow_multiple: bool = False,
+) -> ft.FilePicker:
+    """File picker overlay. Must be added to page.overlay before use."""
+    picker = ft.FilePicker()
+    if on_result:
+        picker.on_result = on_result
+    if on_upload:
+        picker.on_upload = on_upload
+    return picker
+
+
+def DEx_FilePickerButton(
+    label: str = "Selecionar arquivo",
+    icon: str = ft.Icons.UPLOAD_FILE_ROUNDED,
+    allowed_extensions: list[str] | None = None,
+    allow_multiple: bool = False,
+    on_result=None,
+) -> ft.Column:
+    """Self-contained file picker button. Add col.data (FilePicker) to page.overlay."""
+    result_text = ft.Text("", size=12, color=Colors.TEXT_MUTED)
+
+    picker = ft.FilePicker()
+
+    def _on_result(e):
+        if e.files:
+            result_text.value = ", ".join(f.name for f in e.files)
+        else:
+            result_text.value = "Nenhum arquivo selecionado"
+        try:
+            result_text.update()
+        except RuntimeError:
+            pass
+        if on_result:
+            on_result(e)
+
+    picker.on_result = _on_result
+
+    async def open_picker(e):
+        if hasattr(e.page, "overlay") and picker not in e.page.overlay:
+            e.page.overlay.append(picker)
+            e.page.update()
+        await picker.pick_files(
+            allow_multiple=allow_multiple,
+            allowed_extensions=allowed_extensions,
+        )
+
+    btn = ft.Button(
+        content=label,
+        icon=icon,
+        on_click=open_picker,
+        bgcolor=Colors.BG_ELEVATED,
+        color=Colors.TEXT_PRIMARY,
+        style=ft.ButtonStyle(
+            shape=ft.RoundedRectangleBorder(radius=Spacing.BUTTON_BORDER_RADIUS),
+        ),
+    )
+
+    col = ft.Column([btn, result_text], spacing=Spacing.XS, tight=True)
+    col.data = picker
+    return col

components/inputs/DEx_Radio.py

@@ -0,0 +1,37 @@
+import flet as ft
+from components.theme.DEx_Theme import Colors, Spacing
+
+COMPONENT_VERSION = "0.0.1"
+
+
+def DEx_Radio(label: str, value: str) -> ft.Radio:
+    """Single radio option — always used inside DEx_RadioGroup."""
+    return ft.Radio(
+        label=label,
+        value=value,
+        active_color=Colors.ACCENT,
+        fill_color={
+            ft.ControlState.SELECTED: Colors.ACCENT,
+            ft.ControlState.DEFAULT: Colors.BORDER,
+        },
+        label_style=ft.TextStyle(size=13, color=Colors.TEXT_PRIMARY),
+    )
+
+
+def DEx_RadioGroup(
+    options: list[dict],
+    value: str | None = None,
+    on_change=None,
+    horizontal: bool = False,
+) -> ft.RadioGroup:
+    """Styled radio group for mutually exclusive option selection.
+
+    Each entry in options: {"value": str, "label": str}
+    """
+    radios = [DEx_Radio(label=o["label"], value=o["value"]) for o in options]
+    content = (
+        ft.Row(radios, spacing=Spacing.MD, wrap=True)
+        if horizontal
+        else ft.Column(radios, spacing=Spacing.XS, tight=True)
+    )
+    return ft.RadioGroup(content=content, value=value, on_change=on_change)

components/inputs/DEx_SearchBar.py

@@ -0,0 +1,37 @@
+import flet as ft
+from components.theme.DEx_Theme import Colors, Spacing
+
+COMPONENT_VERSION = "0.0.1"
+
+
+def DEx_SearchBar(
+    suggestions: list[str] | None = None,
+    hint: str = "Pesquisar...",
+    bar_hint: str = "Pesquisar...",
+    on_change=None,
+    on_submit=None,
+    width: float | None = None,
+) -> ft.SearchBar:
+    """Full SearchBar with expandable overlay and suggestion list."""
+    controls = [
+        ft.ListTile(
+            title=ft.Text(s, size=13, color=Colors.TEXT_PRIMARY),
+            on_click=lambda e, s=s: (
+                e.control.page.close(e.control.page.controls[-1]),
+            ) if e.control.page else None,
+        )
+        for s in (suggestions or [])
+    ]
+    return ft.SearchBar(
+        controls=controls,
+        view_hint_text=hint,
+        bar_hint_text=bar_hint,
+        bar_bgcolor=Colors.BG_ELEVATED,
+        bar_overlay_color=Colors.BG_SURFACE,
+        view_bgcolor=Colors.BG_SURFACE,
+        bar_border_side=ft.BorderSide(1, Colors.BORDER),
+        on_change=on_change,
+        on_submit=on_submit,
+        width=width,
+        bar_leading=ft.Icon(ft.Icons.SEARCH_ROUNDED, color=Colors.TEXT_MUTED, size=18),
+    )

components/inputs/DEx_SearchField.py

@@ -0,0 +1,9 @@
+import flet as ft
+from components.inputs.DEx_TextField import DEx_TextField
+
+COMPONENT_VERSION = "0.0.1"
+
+
+def DEx_SearchField(hint: str = "Buscar...", on_change=None) -> ft.TextField:
+    """Create the versioned search field with the standard search icon."""
+    return DEx_TextField(label="", hint=hint, icon=ft.Icons.SEARCH, on_change=on_change)

components/inputs/DEx_Slider.py

@@ -0,0 +1,49 @@
+import flet as ft
+from components.theme.DEx_Theme import Colors
+
+COMPONENT_VERSION = "0.0.1"
+
+
+def DEx_Slider(
+    min: float = 0,
+    max: float = 100,
+    value: float = 50,
+    divisions: int | None = None,
+    label: str | None = "{value}",
+    on_change=None,
+) -> ft.Slider:
+    """Styled single-value slider for numeric range input."""
+    return ft.Slider(
+        min=min,
+        max=max,
+        value=value,
+        divisions=divisions,
+        label=label,
+        on_change=on_change,
+        active_color=Colors.ACCENT,
+        inactive_color=Colors.BG_ELEVATED,
+        thumb_color=Colors.ACCENT,
+    )
+
+
+def DEx_RangeSlider(
+    min: float = 0,
+    max: float = 100,
+    start_value: float = 20,
+    end_value: float = 80,
+    divisions: int | None = None,
+    label: str | None = "{value}",
+    on_change=None,
+) -> ft.RangeSlider:
+    """Styled two-handle slider for selecting a numeric range."""
+    return ft.RangeSlider(
+        min=min,
+        max=max,
+        start_value=start_value,
+        end_value=end_value,
+        divisions=divisions,
+        label=label,
+        on_change=on_change,
+        active_color=Colors.ACCENT,
+        inactive_color=Colors.BG_ELEVATED,
+    )

components/inputs/DEx_Switch.py

@@ -0,0 +1,22 @@
+import flet as ft
+from components.theme.DEx_Theme import Colors
+
+COMPONENT_VERSION = "0.0.1"
+
+
+def DEx_Switch(
+    label: str = "",
+    value: bool = False,
+    on_change=None,
+    label_position: ft.LabelPosition = ft.LabelPosition.RIGHT,
+) -> ft.Switch:
+    """Styled toggle switch for binary settings and feature flags."""
+    return ft.Switch(
+        label=label,
+        value=value,
+        on_change=on_change,
+        label_position=label_position,
+        active_color=Colors.ACCENT,
+        active_track_color=Colors.ACCENT_DARK,
+        label_text_style=ft.TextStyle(size=13, color=Colors.TEXT_PRIMARY),
+    )

components/inputs/DEx_TextField.py

@@ -0,0 +1,29 @@
+import flet as ft
+from components.theme.DEx_Theme import Colors, Spacing
+
+COMPONENT_VERSION = "0.0.1"
+
+
+def DEx_TextField(
+    label: str,
+    hint: str = "",
+    icon=None,
+    password: bool = False,
+    on_change=None,
+) -> ft.TextField:
+    """Create the versioned DEx text field for forms and filters."""
+    return ft.TextField(
+        label=label,
+        hint_text=hint,
+        prefix_icon=icon,
+        password=password,
+        can_reveal_password=password,
+        on_change=on_change,
+        border_color=Colors.BORDER,
+        focused_border_color=Colors.ACCENT,
+        label_style=ft.TextStyle(color=Colors.TEXT_SECONDARY, size=12),
+        text_style=ft.TextStyle(color=Colors.TEXT_PRIMARY, size=14),
+        cursor_color=Colors.ACCENT,
+        bgcolor=Colors.BG_SURFACE,
+        border_radius=Spacing.BUTTON_BORDER_RADIUS,
+    )

components/inputs/DEx_TimePicker.py

@@ -0,0 +1,71 @@
+import flet as ft
+from components.theme.DEx_Theme import Colors, Spacing
+
+COMPONENT_VERSION = "0.0.1"
+
+
+def DEx_TimeField(
+    label: str = "Horário",
+    value: str = "",
+    hint: str = "hh:mm",
+    on_change=None,
+    width: int | None = None,
+) -> ft.TextField:
+    """Time field that opens a native clock picker on icon click."""
+    picker = ft.TimePicker()
+
+    def _on_picked(e):
+        if e.control.value:
+            field.value = e.control.value.strftime("%H:%M")
+            try:
+                field.update()
+            except RuntimeError:
+                pass
+            if on_change:
+                on_change(e)
+
+    picker.on_change = _on_picked
+
+    def _open(e):
+        if not hasattr(e.page, "overlay"):
+            return
+        if picker not in e.page.overlay:
+            e.page.overlay.append(picker)
+            e.page.update()
+        picker.open = True
+        e.page.update()
+
+    field = ft.TextField(
+        label=label,
+        value=value,
+        hint_text=hint,
+        read_only=True,
+        suffix=ft.IconButton(
+            ft.Icons.ACCESS_TIME_ROUNDED,
+            on_click=_open,
+            icon_color=Colors.TEXT_SECONDARY,
+            icon_size=18,
+        ),
+        border_color=Colors.BORDER,
+        focused_border_color=Colors.ACCENT,
+        label_style=ft.TextStyle(color=Colors.TEXT_SECONDARY),
+        text_style=ft.TextStyle(color=Colors.TEXT_PRIMARY),
+        hint_style=ft.TextStyle(color=Colors.TEXT_MUTED),
+        cursor_color=Colors.ACCENT,
+        bgcolor=Colors.BG_ELEVATED,
+        width=width,
+    )
+    return field
+
+
+def DEx_TimeRangeField(
+    start_label: str = "Hora de início",
+    end_label: str = "Hora de término",
+    on_change=None,
+    width: int | None = None,
+) -> ft.Row:
+    """Two time fields side by side for time range input."""
+    return ft.Row([
+        DEx_TimeField(label=start_label, on_change=on_change, width=width),
+        DEx_TimeField(label=end_label, on_change=on_change, width=width),
+    ], spacing=Spacing.SM)