flet 0.70.0.dev6370__py3-none-any.whl → 0.70.0.dev6412__py3-none-any.whl

flet/components/hooks/use_state.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 from collections.abc import Callable
 from dataclasses import dataclass
 from typing import Any, TypeVar
@@ -6,6 +8,9 @@ from flet.components.hooks.hook import Hook
 from flet.components.observable import Observable, ObservableSubscription
 from flet.components.utils import current_component
 
+StateT = TypeVar("StateT")
+Updater = Callable[[StateT], StateT]
+
 
 @dataclass
 class StateHook(Hook):
@@ -14,20 +19,21 @@ class StateHook(Hook):
     version: int = 0
 
 
-StateT = TypeVar("StateT")
-
-
 def use_state(
     initial: StateT | Callable[[], StateT],
-) -> tuple[StateT, Callable[[StateT], None]]:
+) -> tuple[StateT, Callable[[StateT | Updater], None]]:
     """
-    Add state to function components.
+    Adds state to a function component, similar to React's useState().
+
+    The returned setter accepts either:
+      - a new value, or
+      - a function receiving the previous state and returning the next one.
 
     Args:
-        initial: Initial state value or a function that returns the initial state value.
+        initial: Initial state value or a function returning it.
 
     Returns:
-        A tuple of the current state value and a function to update it.
+        (value, set_value) tuple.
     """
     component = current_component()
     hook = component.use_hook(
@@ -37,17 +43,34 @@ def use_state(
         )
     )
 
-    def update_subscription(hook: StateHook):
-        if hook.subscription:
-            component._detach_observable_subscription(hook.subscription)
-            hook.subscription = None
-        if isinstance(hook.value, Observable):
-            hook.subscription = component._attach_observable_subscription(hook.value)
+    def update_subscription(h: StateHook):
+        # Detach previous subscription if any
+        if h.subscription:
+            component._detach_observable_subscription(h.subscription)
+            h.subscription = None
+
+        # Attach new subscription if value is Observable
+        if isinstance(h.value, Observable):
+            h.subscription = component._attach_observable_subscription(h.value)
 
     update_subscription(hook)
 
-    def set_state(new_value: Any):
-        # shallow equality; swap to "is" or custom comparator if needed
+    def set_state(new_value_or_fn: StateT | Updater):
+        """
+        Update the state value.
+
+        Can be called with either:
+          - a direct new value, or
+          - a function that takes the current value and returns the next one.
+        """
+        # Compute next value
+        new_value = (
+            new_value_or_fn(hook.value)
+            if callable(new_value_or_fn)
+            else new_value_or_fn
+        )
+
+        # Only trigger update if value changed (shallow equality)
         if new_value != hook.value:
             hook.value = new_value
             update_subscription(hook)

flet/controls/core/stack.py

@@ -31,6 +31,33 @@ class Stack(LayoutControl, AdaptiveControl):
     Stack is also useful if you want to implement implicit animations
     (https://flet.dev/docs/guides/python/animations/) that require knowing absolute
     position of a target value.
+
+    ```python
+    ft.Stack(
+            width=300,
+            height=300,
+            controls=[
+                ft.Image(
+                    src="https://picsum.photos/300/300",
+                    width=300,
+                    height=300,
+                    fit=ft.BoxFit.CONTAIN,
+                ),
+                ft.Row(
+                    alignment=ft.MainAxisAlignment.CENTER,
+                    controls=[
+                        ft.Text(
+                            value="Image title",
+                            color=ft.Colors.SURFACE_TINT,
+                            size=40,
+                            weight=ft.FontWeight.BOLD,
+                            opacity=0.5,
+                        )
+                    ],
+                ),
+            ],
+        )
+    ```
     """
 
     controls: list[Control] = field(default_factory=list)

flet/controls/material/auto_complete.py

@@ -1,9 +1,9 @@
 from dataclasses import dataclass, field
 from typing import Optional
 
+from flet import LayoutControl
 from flet.controls.base_control import control
-from flet.controls.control import Control
-from flet.controls.control_event import Event, EventHandler
+from flet.controls.control_event import ControlEventHandler, Event, EventHandler
 from flet.controls.types import Number
 
 __all__ = ["AutoComplete", "AutoCompleteSelectEvent", "AutoCompleteSuggestion"]
@@ -11,22 +11,45 @@ __all__ = ["AutoComplete", "AutoCompleteSelectEvent", "AutoCompleteSuggestion"]
 
 @dataclass
 class AutoCompleteSuggestion:
+    """
+    Represents a suggestion item for the [`AutoComplete`][flet.] control.
+    """
+
     key: str
+    """A unique identifier or value used for filtering and selection."""
+
     value: str
+    """The display text shown to the user."""
 
 
 @dataclass
 class AutoCompleteSelectEvent(Event["AutoComplete"]):
+    """Event representing the selection of a suggestion in the AutoComplete control."""
+
+    index: int
+    """
+    The index of the selected suggestion from the corresponding
+    [`AutoComplete.suggestions`][flet.] list.
+    """
+
     selection: AutoCompleteSuggestion
+    """The selected suggestion."""
 
 
 @control("AutoComplete")
-class AutoComplete(Control):
+class AutoComplete(LayoutControl):
     """
     Helps the user make a selection by entering some text and choosing from among a
     list of displayed options.
     """
 
+    value: str = ""
+    """
+    Current text displayed in the input field.
+
+    This value reflects user input even if it does not match any provided suggestion.
+    """
+
     suggestions: list[AutoCompleteSuggestion] = field(default_factory=list)
     """
     A list of [`AutoCompleteSuggestion`][flet.]
@@ -53,7 +76,19 @@ class AutoComplete(Control):
     Called when a suggestion is selected.
     """
 
+    on_change: Optional[ControlEventHandler["AutoComplete"]] = None
+    """
+    Called when the input text changes.
+    """
+
     @property
-    def selected_index(self):
-        # TODO: check availability of _selected_index + a default if not yet available
-        return self._selected_index
+    def selected_index(self) -> Optional[int]:
+        """
+        The index of the (last) selected suggestion.
+
+        It is `None` until a suggestion has been selected from the UI.
+
+        Note:
+            This property is read-only.
+        """
+        return getattr(self, "_selected_index", None)

flet/controls/material/menu_item_button.py

@@ -80,7 +80,7 @@ class MenuItemButton(LayoutControl):
 
     on_click: Optional[ControlEventHandler["MenuItemButton"]] = None
     """
-    Called when the button is clicked.
+    Called when the button is clicked.If not defined the button will be disabled.
     """
 
     on_hover: Optional[ControlEventHandler["MenuItemButton"]] = None

flet/controls/material/submenu_button.py

@@ -19,6 +19,25 @@ class SubmenuButton(LayoutControl):
     A menu button that displays a cascading menu.
 
     Typically used in a [`MenuBar`][flet.] control.
+
+    ```python
+    ft.SubmenuButton(
+        content=ft.Text("Choose text style"),
+        key="smbutton",
+        expand=True,
+        menu_style=ft.MenuStyle(
+            alignment=ft.Alignment.BOTTOM_LEFT, side=ft.BorderSide(1)
+        ),
+        controls=[
+            ft.MenuItemButton(
+                content=ft.Text("Underlined"),
+                on_click=lambda e: print(f"{e.control.content.value}.on_click")
+            ),
+            ft.MenuItemButton(...),
+            ...
+        ]
+    )
+    ```
     """
 
     content: Optional[StrOrControl] = None

flet/controls/material/switch.py

@@ -26,6 +26,11 @@ class Switch(LayoutControl, AdaptiveControl):
     two mutually exclusive options.
 
     For example, "On/Off", "Show/Hide".
+
+    ```python
+        ft.Switch(label="Unchecked switch", value=False)
+        ft.Switch(label="Disabled switch", disabled=True)
+    ```
     """
 
     label: Optional[StrOrControl] = None

flet/controls/material/text_button.py

@@ -22,6 +22,14 @@ class TextButton(LayoutControl, AdaptiveControl):
     Text buttons are used for the lowest priority actions, especially when presenting
     multiple options. Text buttons can be placed on a variety of backgrounds. Until the
     button is interacted with, its container isn’t visible.
+
+    ```python
+    ft.TextButton(
+            content="Text Button",
+            icon=ft.Icons.STAR_BORDER,
+            icon_color=ft.Colors.BLUE_300,
+        )
+    ```
     """
 
     content: Optional[StrOrControl] = None

flet/controls/material/time_picker.py

@@ -38,6 +38,14 @@ class TimePicker(DialogControl):
 
     Depending on the `time_picker_entry_mode`, it will show either a Dial or
     an Input (hour and minute text fields) for picking a time.
+
+    ```python
+    ft.TimePicker(
+        value=time(1, 2),
+        time_picker_entry_mode=ft.TimePickerEntryMode.INPUT_ONLY,
+        open=True,
+    )
+    ```
     """
 
     value: Optional[time] = field(default_factory=lambda: datetime.now().time())

flet/version.py

@@ -10,7 +10,7 @@ from flet.utils import is_mobile, is_windows, which
 DEFAULT_VERSION = "0.1.0"
 
 # will be replaced by CI
-version = "0.70.0.dev6370"
+version = "0.70.0.dev6412"
 
 
 def update_version():

{flet-0.70.0.dev6370.dist-info → flet-0.70.0.dev6412.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flet
-Version: 0.70.0.dev6370
+Version: 0.70.0.dev6412
 Summary: Flet for Python - easily build interactive multi-platform apps in Python
 Author-email: "Appveyor Systems Inc." <hello@flet.dev>
 License-Expression: Apache-2.0

{flet-0.70.0.dev6370.dist-info → flet-0.70.0.dev6412.dist-info}/RECORD

@@ -1,7 +1,7 @@
 flet/__init__.py,sha256=39Ci10DOyWcl-9adUYDbIX7eR0PHsRELpESPQZnCw9M,26200
 flet/app.py,sha256=HSws0Zm4ZO0-Hp2P9h7xirCVnRkKCVXhuekyAXT_9Fo,11883
 flet/cli.py,sha256=IUM25fY_sqMtl0hlQGhlMQaBb1oNyO0VZeeBgRodhuA,204
-flet/version.py,sha256=G79_e0GaEWAHubI5qUf3Oswkoj0--Y3hrdFTF03GxoM,2512
+flet/version.py,sha256=aOmbhqYq3OsgaFkQ6pepK3pyPTjKQfxo1xFcT49CEHE,2512
 flet/auth/__init__.py,sha256=eDqmi0Ki8Resd198S7XxgYa2R14wnNqIXnYhBLPl8fQ,289
 flet/auth/authorization.py,sha256=hP_36RiRPtSwmK_Yp6MMzAjQdDxbBiEcZ2yFNqyNiRs,357
 flet/auth/authorization_service.py,sha256=6N2LvisSt7KI_VgfyCH0OaJ6jTcmXCkAldN1yYlakzQ,6410
@@ -29,7 +29,7 @@ flet/components/hooks/use_callback.py,sha256=TUTIfwBeZ5Xsbt7wI8OVbzfMKBGyPq27z3J
 flet/components/hooks/use_context.py,sha256=38_MYBIOzHE-X45psuyHV6cTjbcrQVXVRzcCz_bMwv8,2516
 flet/components/hooks/use_effect.py,sha256=dZik3viWSfkOi5uTzc-kWV00P2_DIWcV2OzA8OexAN4,3225
 flet/components/hooks/use_memo.py,sha256=4IbT89yQXicMgzqp9a6hJ6egit_6GX8sVkn4DczVeyQ,1693
-flet/components/hooks/use_state.py,sha256=ZAhtIRnm2CKDK2-cIWmkWWEV-Gz2eOx7f9ZhsE1b06M,1680
+flet/components/hooks/use_state.py,sha256=NXCkMQ-KIsu5pzr9CmaPZuUlQYUEE54CIKSQFr7KkyE,2351
 flet/controls/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 flet/controls/adaptive_control.py,sha256=Pw0E7z0IlNSe05cQTi5BLElLF3OnlVLzwfvtOQpsRr8,1594
 flet/controls/alignment.py,sha256=re4jnpuqNPPWs55bf8RB_c9llqcuGhZcCjdNutx2N5M,3257
@@ -98,7 +98,7 @@ flet/controls/core/safe_area.py,sha256=Yf2ZWmZpGZ_xpNw16xozbc99KTXXmyXGYo-gPlC9b
 flet/controls/core/screenshot.py,sha256=6X3f6rYaX7PHkvWM7gpFlyhA2xzt-M15ax-Nfd45n1g,1110
 flet/controls/core/semantics.py,sha256=tiRTyFMYYNIcj8kuiopZMPGxeo_n4L7eCchHcywColI,7413
 flet/controls/core/shader_mask.py,sha256=z4sr8RP2PnP-ooh0c5KNiUDLsHmj1S-R7ATm53j5CJo,1034
-flet/controls/core/stack.py,sha256=JqCIXFcDxd4C7dhJik0qwOu7IoHRmkj7BpvF6LhM03k,1954
+flet/controls/core/stack.py,sha256=Px_1SllMdOwDuMv8_xp28jwccy9wleSlaM3F5H5MXgA,2749
 flet/controls/core/text.py,sha256=jKl-j9Zzoj0nuxIbj-wRj4re6VLSvygvsqTwAIiMKqg,8903
 flet/controls/core/text_span.py,sha256=-f60CaJ6H31_f6JcYLEogiwe14Lw_HdvCAccRRsANP8,2939
 flet/controls/core/transparent_pointer.py,sha256=BGDFuDWyDUIYOmwaEgMMks6OWS_lVjZObAw2M-3r2bQ,963
@@ -150,7 +150,7 @@ flet/controls/cupertino/cupertino_tinted_button.py,sha256=SmLukUZWYU_c2roz81a1hY
 flet/controls/material/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 flet/controls/material/alert_dialog.py,sha256=_6D1a0iBDNImmExHjXzpxyGOnEA0DLk2Cj_Akl_uXio,7822
 flet/controls/material/app_bar.py,sha256=hEaZLSSKcJc5WQ7BcIPhB0m5_C9CnBVOkiYiMYQsJRY,6605
-flet/controls/material/auto_complete.py,sha256=MVesy4fUvLvY0pw_BDQXpRB5o9ac1Ci7icTdG4nC5oM,1856
+flet/controls/material/auto_complete.py,sha256=hLH4cuhxno1wkh_JcX9RERe1_oaZIIkHjAVk9aR-1X8,2797
 flet/controls/material/badge.py,sha256=gWkDrqoZMIrjEreWeTaANlnzJn394Gj4vQZikuVAEIk,3365
 flet/controls/material/banner.py,sha256=gFj9oNpPMNiAMnFNWkZiUdgGcE6T72VVVw73BeIRMvU,4512
 flet/controls/material/bottom_app_bar.py,sha256=_nnAUEP7_z3seEaDQ29qO5qEn8xbBEUxL-I68i9lk5c,2456
@@ -178,7 +178,7 @@ flet/controls/material/icon_button.py,sha256=ZmOmOtk7fv1B2gWOvf0yTvwxxRdI7UDl5Ys
 flet/controls/material/icons.py,sha256=dsBk2nwUW3SQjwpzPv8G53ILP_zCg7tJocylHQLC-RU,287261
 flet/controls/material/list_tile.py,sha256=RIBO8ibubZjnGyWV4iTw7FOhMVNJM6jImoUYumAvjfw,8061
 flet/controls/material/menu_bar.py,sha256=78RmnKy9npkdcp8QYqp4kHqXnVHaZWkRNqEURJISGZg,2250
-flet/controls/material/menu_item_button.py,sha256=ICiTw3FMCTL7maI04KggHOcuxEOEHLPxAU08D_XVVxY,2523
+flet/controls/material/menu_item_button.py,sha256=nlxXnBgJfB7oJ1F-7PuQy-67nmYTxglZ14u4uGf63kc,2566
 flet/controls/material/navigation_bar.py,sha256=HzSiMT6P6bgkxz-d1iWxRNACMuOqnPKi2qbLBmp7BCg,4998
 flet/controls/material/navigation_drawer.py,sha256=_Wraal9cxMqyXUbDC26wMEUWlWu0pVT7V28DR-MCoQE,3794
 flet/controls/material/navigation_rail.py,sha256=bnzSJ8LKV-Y7GUPslX7cTpkgnnzjsHp0DftFUp-5l2c,7856
@@ -195,12 +195,12 @@ flet/controls/material/segmented_button.py,sha256=f01DPN_QbUvzGS8tEilASVI6VFQwUR
 flet/controls/material/selection_area.py,sha256=KYjMBMuuSKmi6sKBl0UZgZurBOeJMbgNazi-jsR1KU4,1032
 flet/controls/material/slider.py,sha256=zV0Jres_HPwP590kNe663GeML9gIx4U24W_R7BpCV6o,6952
 flet/controls/material/snack_bar.py,sha256=8X3P_TgHBAWafMzaC6NskPey2_k-JeheL29PrgxAVYc,7374
-flet/controls/material/submenu_button.py,sha256=4iQvOPTNRjNwXx3in8FWqBFKW6Mt22awwAhL8HiWd_I,2683
-flet/controls/material/switch.py,sha256=EaeAF1qDQfzmHz_uLzQTurc5vKUXXYuCSmoKdXjmQCg,6892
+flet/controls/material/submenu_button.py,sha256=xDGBjZLT22Pi0UrRnUQFx9RAl7oJEWChuP5929rEkeE,3193
+flet/controls/material/switch.py,sha256=JLAPcOq0XzIkw1_HmsmBukROV9zBAkm-MZt8iqIKKXg,7030
 flet/controls/material/tabs.py,sha256=WIGsEs6lpw3LwqWsgIAJ4a0PpWKgLVOKkZRKfarnNY4,18565
-flet/controls/material/text_button.py,sha256=Mkvz4LIl0yH1-e0ekOjPD6z8CZ5ZUIyE00zcb7sLKns,2578
+flet/controls/material/text_button.py,sha256=xAHx613EN07MT9fuWhvp7oUQ6zZ7Gw7rtsO5YaHrd1A,2747
 flet/controls/material/textfield.py,sha256=_JrdBKfVwwSeROm3Yh-0u2TsuovYcW7P8nQevIP7g2I,11816
-flet/controls/material/time_picker.py,sha256=_gUTaQi4N-mo1Oj_yJEsti8ToM0WhwhofbCjP5v2gzA,3070
+flet/controls/material/time_picker.py,sha256=Jj1snTHdZdbG40d0AYrt2mwrXxxFEU-TfDcT6pH6Y5Q,3229
 flet/controls/material/tooltip.py,sha256=PTqJiiE95z4WCTlvCx7i3vA-gGwphUT7w_2oXMiiVtY,5636
 flet/controls/material/vertical_divider.py,sha256=kOqmL4XoL6tfRHoXA3oJurvIaixwn54Qf6ATC0-CT48,2752
 flet/controls/services/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -246,8 +246,8 @@ flet/utils/platform_utils.py,sha256=U4cqV3EPi5QNYjbhfZmtk41-KMtI_P7KvVdnZzMOgJA,
 flet/utils/slugify.py,sha256=e-lsoDc2_dk5jQnySaHCU83AA4O6mguEgCEdk2smW2Y,466
 flet/utils/strings.py,sha256=R63_i7PdSAStCDPJ-O_WHBt3H02JQ14GSbnjLIpPTUc,178
 flet/utils/vector.py,sha256=pYZzjldBWCZbSeSkZ8VmujwcZC7VBWk1NLBPA-2th3U,3207
-flet-0.70.0.dev6370.dist-info/METADATA,sha256=u9p6dNcRA2r0bUV9wWwDITiJtju60zql11_kt2JL7R4,6109
-flet-0.70.0.dev6370.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-flet-0.70.0.dev6370.dist-info/entry_points.txt,sha256=mbBhHNUnLHiDqR36WeJrfLJU0Y0y087-M4wagQmaQ_Y,39
-flet-0.70.0.dev6370.dist-info/top_level.txt,sha256=HbLrSnWJX2jZOEZAI14cGzW8Q5BbOGTtE-7knD5FDh0,5
-flet-0.70.0.dev6370.dist-info/RECORD,,
+flet-0.70.0.dev6412.dist-info/METADATA,sha256=LVdYij4ohQtAInMwcKj78dHaB-8rl4Iicx0Fn0nyPMA,6109
+flet-0.70.0.dev6412.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+flet-0.70.0.dev6412.dist-info/entry_points.txt,sha256=mbBhHNUnLHiDqR36WeJrfLJU0Y0y087-M4wagQmaQ_Y,39
+flet-0.70.0.dev6412.dist-info/top_level.txt,sha256=HbLrSnWJX2jZOEZAI14cGzW8Q5BbOGTtE-7knD5FDh0,5
+flet-0.70.0.dev6412.dist-info/RECORD,,