DEx-Framework 0.0.39__tar.gz

dex_framework-0.0.39/DEx_Framework/__init__.py

@@ -0,0 +1,11 @@
+from __future__ import annotations
+
+from DEx_Framework import foundations as _foundations
+from DEx_Framework.foundations import *  # noqa: F401,F403
+
+__version__ = "0.0.39"
+
+__all__ = [
+    *_foundations.__all__,
+    "__version__",
+]

dex_framework-0.0.39/DEx_Framework/foundations/__init__.py

@@ -0,0 +1,11 @@
+from __future__ import annotations
+
+from DEx_Framework.foundations import components as _components
+from DEx_Framework.foundations import tokens as _tokens
+from DEx_Framework.foundations.components import *  # noqa: F401,F403
+from DEx_Framework.foundations.tokens import *  # noqa: F401,F403
+
+__all__ = [
+    *_components.__all__,
+    *_tokens.__all__,
+]

dex_framework-0.0.39/DEx_Framework/foundations/components/__init__.py

@@ -0,0 +1,76 @@
+from DEx_Framework.foundations.components.visual_foundations.ds_text         import DS_Text
+from DEx_Framework.foundations.components.actions_commands.ds_text_link    import DS_TextLink
+from DEx_Framework.foundations.components.actions_commands.ds_theme_action import DS_Theme_Action
+from DEx_Framework.foundations.components.actions_commands.ds_user_login_action import DS_User_Login_Action
+from DEx_Framework.foundations.components.authentication_session.ds_login        import DS_Login
+from DEx_Framework.foundations.components.authentication_session.ds_login_modal  import DS_Login_Modal
+from DEx_Framework.foundations.components.authentication_session.ds_login_screen import DS_Login_Screen
+from DEx_Framework.foundations.components.data_input_controls.ds_text_field   import DS_TextField
+from DEx_Framework.foundations.components.data_input_controls.ds_dropdown     import DS_Dropdown, DropdownOption
+from DEx_Framework.foundations.components.actions_commands.ds_button       import DS_Button
+from DEx_Framework.foundations.components.data_input_controls.ds_checkbox     import DS_Checkbox
+from DEx_Framework.foundations.components.data_input_controls.ds_radio        import DS_RadioGroup, RadioOption
+from DEx_Framework.foundations.components.layout_structure.ds_header       import DS_Header, HeaderAction
+from DEx_Framework.foundations.components.data_input_controls.ds_search       import DS_Search
+from DEx_Framework.foundations.components.layout_structure.ds_card         import DS_Card
+from DEx_Framework.foundations.components.overlays_dialogs.ds_modal        import DS_Modal, ModalAction
+from DEx_Framework.foundations.components.data_input_controls.ds_file_picker  import DS_FilePicker
+from DEx_Framework.foundations.components.data_display_visualization.ds_table        import DS_Table, TableColumn, TableRow
+from DEx_Framework.foundations.components.layout_structure.ds_sidebar      import DS_Sidebar, SidebarItem, SidebarAction
+from DEx_Framework.foundations.components.layout_structure.ds_app_shell    import DS_AppShell
+from DEx_Framework.foundations.components.layout_structure.ds_menu_nr import DS_Menu_NR
+from DEx_Framework.foundations.components.theming_styling.ds_theme_manager import DS_ThemeManager
+from DEx_Framework.foundations.components.theming_styling.ds_theme_list    import DS_ThemeList
+from DEx_Framework.foundations.components.data_display_visualization.ds_kpi_card     import DS_KPICard
+from DEx_Framework.foundations.components.feedback_status.ds_alert        import DS_Alert
+from DEx_Framework.foundations.components.navigation_components.ds_stepper      import DS_Stepper, StepItem
+from DEx_Framework.foundations.components.feedback_status.ds_toast        import DS_Toast
+from DEx_Framework.foundations.components.navigation_components.ds_tabs         import DS_Tabs, TabItem
+from DEx_Framework.foundations.components.feedback_status.ds_status_chip  import DS_StatusChip
+from DEx_Framework.foundations.components.navigation_components.ds_timeline     import DS_Timeline, TimelineEvent
+from DEx_Framework.foundations.components.data_display_visualization.ds_line_chart   import DS_LineChart, LineChartSeries, LineChartPoint
+from DEx_Framework.foundations.components.data_display_visualization.ds_progressbar  import DS_ProgressBar
+from DEx_Framework.foundations.components.layout_structure.ds_container    import DS_Container
+from DEx_Framework.foundations.components.layout_structure.ds_version_bar import DS_VersionBar
+
+__all__ = [
+    "DS_Text",
+    "DS_TextLink",
+    "DS_Theme_Action",
+    "DS_User_Login_Action",
+    "DS_Login",
+    "DS_Login_Modal",
+    "DS_Login_Screen",
+    "DS_TextField",
+    "DS_Dropdown",     "DropdownOption",
+    "DS_Button",
+    "DS_Checkbox",
+    "DS_RadioGroup",   "RadioOption",
+    "DS_Header",       "HeaderAction",
+    "DS_Search",
+    "DS_Card",
+    "DS_Modal",        "ModalAction",
+    "DS_FilePicker",
+    "DS_Table",        "TableColumn",  "TableRow",
+    "DS_Sidebar",      "SidebarItem",  "SidebarAction",
+    "DS_AppShell",
+    "DS_Menu_NR",
+    "DS_ThemeManager",
+    "DS_ThemeList",
+    "DS_KPICard",
+    "DS_Alert",
+    "DS_Stepper",      "StepItem",
+    "DS_Toast",
+    "DS_Tabs",         "TabItem",
+    "DS_StatusChip",
+    "DS_Timeline",     "TimelineEvent",
+    "DS_LineChart",    "LineChartSeries", "LineChartPoint",
+    "DS_ProgressBar",
+    "DS_Container",
+    "DS_VersionBar",
+]
+
+
+
+
+

dex_framework-0.0.39/DEx_Framework/foundations/components/actions_commands/__init__.py

@@ -0,0 +1,11 @@
+from DEx_Framework.foundations.components.actions_commands.ds_button import DS_Button
+from DEx_Framework.foundations.components.actions_commands.ds_text_link import DS_TextLink
+from DEx_Framework.foundations.components.actions_commands.ds_theme_action import DS_Theme_Action
+from DEx_Framework.foundations.components.actions_commands.ds_user_login_action import DS_User_Login_Action
+
+__all__ = [
+    "DS_Button",
+    "DS_TextLink",
+    "DS_Theme_Action",
+    "DS_User_Login_Action",
+]

dex_framework-0.0.39/DEx_Framework/foundations/components/actions_commands/ds_button.py

@@ -0,0 +1,160 @@
+from __future__ import annotations
+from typing import Optional
+
+import flet as ft
+
+from DEx_Framework.foundations.components.theming_styling.ds_theme_manager import DS_ThemeManager
+from DEx_Framework.foundations.tokens.tk_button import TK_ButtonToken as ButtonToken, TK_ButtonTokens as ButtonTokens
+from DEx_Framework.foundations.tokens.tk_theme import TK_Theme
+
+
+class DS_Button(ft.ElevatedButton):
+
+    def __init__(
+        self,
+
+        # Parâmetros do botão
+        # -------------------
+        label: str = "",
+
+        # Tokens e tema
+        # -------------
+        token: ButtonToken = ButtonTokens.filled,
+        icon: Optional[str] = None,
+
+        # Dimensões e layout
+        # ------------------
+        radius: Optional[float] = None,
+        icon_only: bool = False,
+        disabled: bool = False,
+
+        # Callbacks
+        # ---------
+        on_click=None,
+        theme_manager: Optional[DS_ThemeManager] = None,
+        auto_apply_theme: bool = True,
+
+        # Outros
+        # ------
+        **kwargs,
+    ):
+        __version__ = "0.0.1"
+        # -------------------
+        self._theme_manager = theme_manager if theme_manager is not None else (DS_ThemeManager.get() if auto_apply_theme else None)
+        self._disabled = disabled
+        self._radius_override = radius
+        self._icon_only = icon_only
+        self._icon_control = None
+        self._token_variant = self._resolve_variant(token)
+        self._use_theme_token = self._token_variant is not None and self._theme_manager is not None
+        self._token = token
+
+        if self._use_theme_token:
+            token = self._get_theme_token(self._theme_manager.theme)
+
+        self._token = token
+        bgcolor = token.bgcolor_disabled if disabled else token.bgcolor
+        color = "transparent" if icon_only else (token.color_disabled if disabled else token.color)
+
+        border = (
+            ft.BorderSide(width=token.border_width, color=token.border_color)
+            if token.border_color
+            else None
+        )
+
+        icon_color = token.icon_color if not disabled else token.color_disabled
+        if icon_only:
+            self._icon_control = ft.Icon(name=icon, size=token.icon_size, color=icon_color)
+            super().__init__(
+                content=self._icon_control,
+                disabled=disabled,
+                on_click=on_click,
+                style=ft.ButtonStyle(
+                    bgcolor=bgcolor,
+                    color=color,
+                    shape=ft.RoundedRectangleBorder(radius=self._effective_radius(token)),
+                    padding=ft.padding.all(0),
+                    side=border,
+                    alignment=ft.alignment.center,
+                ),
+                **kwargs,
+            )
+        else:
+            super().__init__(
+                text=label,
+                icon=icon,
+                icon_color=icon_color,
+                disabled=disabled,
+                on_click=on_click,
+                style=ft.ButtonStyle(
+                    bgcolor=bgcolor,
+                    color=color,
+                    shape=ft.RoundedRectangleBorder(radius=self._effective_radius(token)),
+                    padding=ft.padding.symmetric(
+                        horizontal=token.padding_horizontal,
+                        vertical=token.padding_vertical,
+                    ),
+                    side=border,
+                    text_style=ft.TextStyle(size=token.text_size),
+                    icon_size=token.icon_size,
+                ),
+                **kwargs,
+            )
+
+        if self._theme_manager is not None:
+            self._theme_manager.subscribe(self._on_theme_change)
+
+    @staticmethod
+    def _resolve_variant(token: ButtonToken) -> Optional[str]:
+        if token is ButtonTokens.filled:
+            return "button_filled"
+        if token is ButtonTokens.outlined:
+            return "button_outlined"
+        if token is ButtonTokens.tonal:
+            return "button_tonal"
+        return None
+
+    def _get_theme_token(self, theme: TK_Theme) -> ButtonToken:
+        return getattr(theme, self._token_variant, self._token)
+
+    def _apply_theme(self, theme: TK_Theme):
+        if not self._use_theme_token:
+            return
+        self._token = self._get_theme_token(theme)
+        token = self._token
+        disabled = self._disabled
+        bgcolor = token.bgcolor_disabled if disabled else token.bgcolor
+        color = "transparent" if self._icon_only else (token.color_disabled if disabled else token.color)
+        border = (
+            ft.BorderSide(width=token.border_width, color=token.border_color)
+            if token.border_color
+            else None
+        )
+        self.style = ft.ButtonStyle(
+            bgcolor=bgcolor,
+            color=color,
+            shape=ft.RoundedRectangleBorder(radius=self._effective_radius(token)),
+            padding=ft.padding.all(0) if self._icon_only else ft.padding.symmetric(
+                horizontal=token.padding_horizontal,
+                vertical=token.padding_vertical,
+            ),
+            side=border,
+            text_style=ft.TextStyle(size=0 if self._icon_only else token.text_size),
+            icon_size=token.icon_size,
+            alignment=ft.alignment.center if self._icon_only else None,
+        )
+        if self._icon_only and self._icon_control is not None:
+            self._icon_control.color = token.icon_color if not disabled else token.color_disabled
+            self._icon_control.size = token.icon_size
+        else:
+            self.icon_color = token.icon_color if not disabled else token.color_disabled
+        try:
+            self.update()
+        except Exception:
+            pass
+
+    def _effective_radius(self, token: ButtonToken) -> float:
+        return token.border_radius if self._radius_override is None else self._radius_override
+
+    def _on_theme_change(self, theme: TK_Theme):
+        self._apply_theme(theme)

dex_framework-0.0.39/DEx_Framework/foundations/components/actions_commands/ds_text_link.py

@@ -0,0 +1,122 @@
+from __future__ import annotations
+from typing import Optional
+
+import flet as ft
+
+from DEx_Framework.foundations.components.theming_styling.ds_theme_manager import DS_ThemeManager
+from DEx_Framework.foundations.tokens.tk_theme import TK_Theme
+from DEx_Framework.foundations.tokens.tk_typography import TK_TextToken as TextToken, TK_TypographyTokens as TypographyTokens
+
+
+class DS_TextLink(ft.Text):
+
+    def __init__(
+        self,
+
+        # Geral
+        # -----
+        text: str = "",
+
+        # Textos e rótulos
+        # ----------------
+        link_text: str = "",
+        url: Optional[str] = None,
+
+        # Tokens e tema
+        # -------------
+        token: TextToken = TypographyTokens.body_medium,
+        color: Optional[str] = None,
+        link_color: Optional[str] = None,
+        underline: bool = True,
+
+        # Callbacks
+        # ---------
+        on_click=None,
+        suffix: str = "",
+        theme_manager: Optional[DS_ThemeManager] = None,
+
+        # Parâmetros do botão
+        # -------------------
+        auto_apply_theme: bool = True,
+
+        # Outros
+        # ------
+        **kwargs,
+    ):
+        __version__ = "0.0.1"
+        # -------------------
+        self._theme_manager = theme_manager if theme_manager is not None else (DS_ThemeManager.get() if auto_apply_theme else None)
+        self._token = token
+        self._color_override = color
+        self._link_color_override = link_color
+        self._underline = underline
+        self._text = text
+        self._link_text = link_text
+        self._suffix = suffix
+        self._url = url
+        self._on_click = on_click
+        self._use_theme_colors = (color is None or link_color is None) and self._theme_manager is not None
+
+        base_color = self._resolve_base_color()
+        link_color_resolved = self._resolve_link_color(base_color)
+
+        spans = self._build_spans(base_color, link_color_resolved)
+        super().__init__(spans=spans, **kwargs)
+
+        if self._theme_manager is not None:
+            self._theme_manager.subscribe(self._on_theme_change)
+
+    def _resolve_base_color(self) -> str:
+        if self._color_override is not None:
+            return self._color_override
+        if self._theme_manager is not None and self._use_theme_colors:
+            return self._theme_manager.theme.text_secondary
+        return self._token.color
+
+    def _resolve_link_color(self, base_color: str) -> str:
+        if self._link_color_override is not None:
+            return self._link_color_override
+        if self._theme_manager is not None and self._use_theme_colors:
+            return self._theme_manager.theme.text_accent
+        return base_color
+
+    def _build_spans(self, base_color: str, link_color: str) -> list:
+        base_style = ft.TextStyle(
+            size=self._token.size,
+            weight=self._token.weight,
+            color=base_color,
+            font_family=self._token.font_family,
+            italic=self._token.italic,
+        )
+
+        link_style = ft.TextStyle(
+            size=self._token.size,
+            weight=self._token.weight,
+            color=link_color,
+            font_family=self._token.font_family,
+            italic=self._token.italic,
+            decoration=ft.TextDecoration.UNDERLINE if self._underline else None,
+        )
+
+        spans = []
+        if self._text:
+            spans.append(ft.TextSpan(text=self._text, style=base_style))
+        if self._link_text:
+            spans.append(ft.TextSpan(text=self._link_text, url=self._url, on_click=self._on_click, style=link_style))
+        if self._suffix:
+            spans.append(ft.TextSpan(text=self._suffix, style=base_style))
+        return spans
+
+    def _apply_theme(self, theme: TK_Theme):
+        if not self._use_theme_colors:
+            return
+        base_color = self._resolve_base_color()
+        link_color = self._resolve_link_color(base_color)
+        self.spans = self._build_spans(base_color, link_color)
+        try:
+            self.update()
+        except Exception:
+            pass
+
+    def _on_theme_change(self, theme: TK_Theme):
+        self._apply_theme(theme)

dex_framework-0.0.39/DEx_Framework/foundations/components/actions_commands/ds_theme_action.py

@@ -0,0 +1,114 @@
+from __future__ import annotations
+from dataclasses import replace
+from typing import Optional
+
+import flet as ft
+
+from DEx_Framework.foundations.components.actions_commands.ds_button import DS_Button
+from DEx_Framework.foundations.components.theming_styling.ds_theme_manager import DS_ThemeManager
+from DEx_Framework.foundations.tokens.tk_button import TK_ButtonToken as ButtonToken, TK_ButtonTokens as ButtonTokens
+
+
+class DS_Theme_Action(DS_Button):
+
+    def __init__(
+        self,
+
+        # Parâmetros do botão
+        # -------------------
+        label: str = "",
+
+        # Geral
+        # -----
+        page: Optional[ft.Page] = None,
+
+        # Tokens e tema
+        # -------------
+        token: ButtonToken = ButtonTokens.filled,
+        icon: Optional[str] = ft.Icons.PALETTE,
+        shape: str = "rounded",
+
+        # Dimensões e layout
+        # ------------------
+        radius: Optional[float] = 24,
+        height: Optional[float] = 32,
+        width: Optional[float] = 32,
+        icon_only: bool = True,
+        disabled: bool = False,
+        theme_manager: Optional[DS_ThemeManager] = None,
+        auto_apply_theme: bool = True,
+        use_header_style: bool = True,
+
+        # Outros
+        # ------
+        **kwargs,
+    ):
+        __version__ = "0.0.1"
+        # -------------------
+        self._page = page
+        self._shape = shape
+        self._theme_manager = theme_manager if theme_manager is not None else (DS_ThemeManager.get() if auto_apply_theme else None)
+        self._use_header_style = use_header_style
+        if self._use_header_style:
+            icon_only = True
+        if self._shape == "square":
+            radius = 0
+
+        super().__init__(
+            label=label,
+            token=token,
+            icon=icon,
+            radius=radius,
+            icon_only=icon_only,
+            disabled=disabled,
+            on_click=self._handle_click,
+            theme_manager=self._theme_manager,
+            auto_apply_theme=auto_apply_theme,
+            height=height,
+            width=width,
+            **kwargs,
+        )
+
+        if self._use_header_style and self._theme_manager is not None:
+            self._apply_header_style(self._theme_manager.theme)
+
+    def _handle_click(self, e):
+        if self._theme_manager is None or self._page is None:
+            return
+        self._theme_manager.cycle(self._page)
+
+    def _apply_header_style(self, theme):
+        header_token = theme.app_shell.header_token
+        self.style = ft.ButtonStyle(
+            bgcolor=header_token.action_btn_bgcolor,
+            shape=ft.CircleBorder(),
+            padding=ft.padding.all(8),
+            alignment=ft.alignment.center,
+        )
+        self.height = header_token.action_btn_size
+        self.width = header_token.action_btn_size
+        if self._icon_only and self._icon_control is not None:
+            self._icon_control.color = header_token.action_btn_icon_color
+            self._icon_control.size = header_token.action_btn_icon_size
+        else:
+            self.icon_color = header_token.action_btn_icon_color
+            self.icon_size = header_token.action_btn_icon_size
+        try:
+            self.update()
+        except Exception:
+            pass
+
+    def _apply_theme(self, theme):
+        if self._use_header_style:
+            self._apply_header_style(theme)
+            return
+        super()._apply_theme(theme)
+
+    def _apply_shape(self, token: ButtonToken) -> ButtonToken:
+        if self._shape == "square":
+            return replace(token, border_radius=0)
+        return token
+
+    def _get_theme_token(self, theme):
+        token = super()._get_theme_token(theme)
+        return self._apply_shape(token)