flet 0.70.0.dev6370__py3-none-any.whl → 0.70.0.dev6425__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/core/text.py

@@ -51,56 +51,96 @@ class TextSelection:
     A range of text that represents a selection.
     """
 
-    start: Optional[int] = None
-    """
-    The index of the first character in the range.
-    """
-
-    end: Optional[int] = None
-    """
-    The next index after the characters in this range.
-    """
-
-    selection: Optional[str] = None
-    """
-    The text string that is selected.
-    """
-
-    base_offset: Optional[int] = None
+    base_offset: int
     """
     The offset at which the selection originates.
     """
 
-    extent_offset: Optional[int] = None
+    extent_offset: int
     """
     The offset at which the selection terminates.
     """
 
-    affinity: Optional["TextAffinity"] = None
+    affinity: "TextAffinity" = TextAffinity.DOWNSTREAM
     """
     If the text range is collapsed and has more than one visual location (e.g., occurs
     at a line break), which of the two locations to use when painting the caret.
     """
 
-    directional: Optional[bool] = None
+    directional: bool = False
     """
     Whether this selection has disambiguated its base and extent.
     """
 
-    collapsed: Optional[bool] = None
-    """
-    Whether this range is empty (but still potentially placed inside the text).
-    """
-
-    valid: Optional[bool] = None
-    """
-    Whether this range represents a valid position in the text.
-    """
-
-    normalized: Optional[bool] = None
-    """
-    Whether the start of this range precedes the end.
-    """
+    @property
+    def start(self) -> int:
+        """
+        The index of the first character in the range.
+
+        Note:
+            This property is read-only.
+        """
+        if self.base_offset < self.extent_offset:
+            return self.base_offset
+        else:
+            return self.extent_offset
+
+    @property
+    def end(self) -> int:
+        """
+        The next index after the characters in this range.
+
+        Note:
+            This property is read-only.
+        """
+        if self.base_offset < self.extent_offset:
+            return self.extent_offset
+        else:
+            return self.base_offset
+
+    @property
+    def is_valid(self) -> bool:
+        """
+        Whether this range represents a valid position in the text.
+
+        Note:
+            This property is read-only.
+        """
+        return self.start >= 0 and self.end >= 0
+
+    @property
+    def is_collapsed(self) -> bool:
+        """
+        Whether this range is empty (but still potentially placed inside the text).
+
+        Note:
+            This property is read-only.
+        """
+        return self.start == self.end
+
+    @property
+    def is_normalized(self) -> bool:
+        """
+        Whether the start of this range precedes the end.
+
+        Note:
+            This property is read-only.
+        """
+        return self.start <= self.end
+
+    def get_selected_text(self, source_text: str) -> str:
+        """
+        Returns the selected text from the given full text.
+
+        Args:
+            source_text: The full text to get the selection from.
+
+        Raises:
+            AssertionError: If the selection is not valid,
+                i.e. [`is_valid`][(c).] is `False`.
+        """
+        assert self.is_valid
+        return source_text[self.start : self.end]
 
 
 class TextSelectionChangeCause(Enum):
@@ -166,9 +206,16 @@ class TextSelectionChangeCause(Enum):
 
 @dataclass
 class TextSelectionChangeEvent(Event[EventControlType]):
-    text: str
-    cause: TextSelectionChangeCause
+    """An event emitted when the text selection changes."""
+
+    selected_text: str
+    """The selected text."""
+
     selection: TextSelection
+    """The new text selection."""
+
+    cause: Optional[TextSelectionChangeCause] = None
+    """The cause of the selection change."""
 
 
 @control("Text")

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/form_field_control.py

@@ -324,4 +324,14 @@ class FormFieldControl(LayoutControl):
     """
 
     async def focus(self):
+        """
+        Request focus for this control.
+
+        Example:
+            ```python
+            async def main(page: ft.Page):
+                page.add(ctf := ft.TextField())
+                await ctf.focus()
+            ```
+        """
         await self._invoke_method("focus")

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/search_bar.py

@@ -30,7 +30,8 @@ class SearchBar(LayoutControl):
     controls: list[Control] = field(default_factory=list)
     """
     The list of controls to be displayed below the search bar when in search view.
-    These controls are usually [`ListTile`][flet.]s and will be displayed
+
+    Typically [`ListTile`][flet.]s and will be displayed
     in a [`ListView`][flet.].
     """
 
@@ -42,7 +43,8 @@ class SearchBar(LayoutControl):
     bar_leading: Optional[Control] = None
     """
     A control to display before the text input field when the search view is close.
-    This is typically an `Icon` or an `IconButton`.
+
+    Typically an [`Icon`][flet.] or an [`IconButton`][flet.].
     """
 
     bar_trailing: Optional[list[Control]] = None
@@ -89,7 +91,7 @@ class SearchBar(LayoutControl):
     """
     The color and weight of the search bar's outline.
 
-    This value is combined with [`SearchBar.bar_shape`][flet.] to
+    This value is combined with [`bar_shape`][(c).] to
     create a shape decorated with an outline.
     """
 
@@ -97,8 +99,7 @@ class SearchBar(LayoutControl):
     """
     The shape of the search bar.
 
-    This shape is combined with
-    [`SearchBar.bar_border_side`][flet.] to create a shape
+    This shape is combined with [`bar_border_side`][(c).] to create a shape
     decorated with an outline.
     """
 
@@ -134,7 +135,8 @@ class SearchBar(LayoutControl):
     view_leading: Optional[Control] = None
     """
     A `Control` to display before the text input field when the search view is open.
-    Typically an `Icon` or an `IconButton`.
+
+    Typically an [`Icon`][flet.] or an [`IconButton`][flet.].
 
     Defaults to a back button which closes/pops the search view.
     """
@@ -154,8 +156,7 @@ class SearchBar(LayoutControl):
 
     view_bgcolor: Optional[ColorValue] = None
     """
-    Defines the background color of the
-    search view.
+    Defines the background color of the search view.
     """
 
     view_hint_text: Optional[str] = None
@@ -175,14 +176,12 @@ class SearchBar(LayoutControl):
 
     view_header_text_style: Optional[TextStyle] = None
     """
-    Defines the [`TextStyle`][flet.] of the
-    text being edited on the search view.
+    Defines the text style of the text being edited on the search view.
     """
 
     view_hint_text_style: Optional[TextStyle] = None
     """
-    Defines the [`TextStyle`][flet.] of
-    `view_hint_text`.
+    Defines the text style of [`view_hint_text`][(c).].
     """
 
     view_size_constraints: Optional[BoxConstraints] = None
@@ -232,7 +231,7 @@ class SearchBar(LayoutControl):
     full_screen: bool = False
     """
     Defines whether the search view grows to fill the entire screen when the search
-    bar is tapped. Defaults to `False`.
+    bar is tapped.
     """
 
     keyboard_type: KeyboardType = KeyboardType.TEXT
@@ -243,8 +242,6 @@ class SearchBar(LayoutControl):
     autofocus: bool = False
     """
     Whether the text field should focus itself if nothing else is already focused.
-
-    Defaults to `False`.
     """
 
     on_tap: Optional[ControlEventHandler["SearchBar"]] = None
@@ -254,7 +251,7 @@ class SearchBar(LayoutControl):
 
     on_tap_outside_bar: Optional[ControlEventHandler["SearchBar"]] = None
     """
-    TBD
+    Fired when the user taps outside the search bar while the search view is open.
     """
 
     on_submit: Optional[ControlEventHandler["SearchBar"]] = None
@@ -269,12 +266,12 @@ class SearchBar(LayoutControl):
 
     on_focus: Optional[ControlEventHandler["SearchBar"]] = None
     """
-    TBD
+    Fired when the search bar gains focus.
     """
 
     on_blur: Optional[ControlEventHandler["SearchBar"]] = None
     """
-    TBD
+    Fired when the search bar loses focus.
     """
 
     def __contains__(self, item):
@@ -285,15 +282,21 @@ class SearchBar(LayoutControl):
 
     # Public methods
     async def focus(self):
+        """Requests focus for this control."""
         await self._invoke_method("focus")
 
-    async def blur(self):
-        await self._invoke_method("blur")
-
     async def open_view(self):
+        """Opens the search view."""
         await self._invoke_method("open_view")
 
     async def close_view(self, text: Optional[str] = None):
+        """
+        Closes an opened search view.
+
+        Args:
+            text: The text to set in the search bar when closing the view. If not
+                provided, the current [`value`][(c).] of the search bar will be used.
+        """
         await self._invoke_method(
             "close_view", {"text": text if text is not None else self.value}
         )

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/textfield.py

@@ -4,8 +4,9 @@ from typing import Optional, Union
 
 from flet.controls.adaptive_control import AdaptiveControl
 from flet.controls.base_control import BaseControl, control
-from flet.controls.control_event import ControlEventHandler
+from flet.controls.control_event import ControlEventHandler, EventHandler
 from flet.controls.core.autofill_group import AutofillHint
+from flet.controls.core.text import TextSelection, TextSelectionChangeEvent
 from flet.controls.material.form_field_control import FormFieldControl
 from flet.controls.padding import PaddingValue
 from flet.controls.text_style import StrutStyle
@@ -144,6 +145,19 @@ class TextField(FormFieldControl, AdaptiveControl):
     Current value of the TextField.
     """
 
+    selection: Optional[TextSelection] = None
+    """
+    Represents the current text selection or caret position in the field.
+
+    When the user selects text, this property is updated to reflect the selected range.
+    If no text is selected, it contains an empty range indicating the caret position.
+
+    Setting this property visually updates the field's selection to match the given
+    value, and hence leads to the [`on_selection_change`][(c).] event being triggered.
+    To ensure the selection is visible and the event is fired, the text field must
+    be focused. Call [`focus()`][(c).focus] on the field before setting this property.
+    """
+
     keyboard_type: KeyboardType = KeyboardType.TEXT
     """
     The type of keyboard to use for editing the text.
@@ -151,7 +165,7 @@ class TextField(FormFieldControl, AdaptiveControl):
 
     multiline: bool = False
     """
-    `True` if TextField can contain multiple lines of text.
+    Whether this field can contain multiple lines of text.
     """
 
     min_lines: Optional[int] = None
@@ -400,7 +414,8 @@ class TextField(FormFieldControl, AdaptiveControl):
     """
     Helps the autofill service identify the type of this text input.
 
-    More information [here](https://api.flutter.dev/flutter/material/TextField/autofillHints.html).
+    More information
+    [here](https://api.flutter.dev/flutter/material/TextField/autofillHints.html).
     """
 
     on_change: Optional[ControlEventHandler["TextField"]] = None
@@ -408,6 +423,16 @@ class TextField(FormFieldControl, AdaptiveControl):
     Called when the typed input for the TextField has changed.
     """
 
+    on_selection_change: Optional[
+        EventHandler[TextSelectionChangeEvent["TextField"]]
+    ] = None
+    """
+    Called when the text selection or caret position changes.
+
+    This can be triggered either by user interaction (selecting text or moving
+    the caret) or programmatically (through the [`selection`][(c).] property).
+    """
+
     on_click: Optional[ControlEventHandler["TextField"]] = None
     """
     TBD

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/controls/services/file_picker.py

@@ -29,8 +29,7 @@ class FilePickerFileType(Enum):
 
     MEDIA = "media"
     """
-    A combination of [`VIDEO`][(c).] and
-    [`IMAGE`][(c).].
+    A combination of [`VIDEO`][(c).] and [`IMAGE`][(c).].
     """
 
     IMAGE = "image"
@@ -158,8 +157,11 @@ class FilePicker(Service):
             dialog_title: The title of the dialog window. Defaults to [`FilePicker.
             initial_directory: The initial directory where the dialog should open.
 
+        Returns:
+            The selected directory path or `None` if the dialog was cancelled.
+
         Raises:
-            NotImplementedError: If called in web app.
+            FletUnsupportedPlatformException: If called in web mode.
         """
         if self.page.web:
             raise FletUnsupportedPlatformException(
@@ -213,7 +215,7 @@ class FilePicker(Service):
         if (self.page.web or self.page.platform.is_mobile()) and not src_bytes:
             raise ValueError(
                 '"src_bytes" is required when saving a file in web mode,'
-                "on Android and iOS."
+                "or on mobile (Android & iOS)."
             )
         if self.page.web and not file_name:
             raise ValueError('"file_name" is required when saving a file in web mode.')
@@ -248,8 +250,10 @@ class FilePicker(Service):
             file_type: The file types allowed to be selected.
             allow_multiple: Allow the selection of multiple files at once.
             allowed_extensions: The allowed file extensions. Has effect only if
-                `file_type` is
-                [`FilePickerFileType.CUSTOM`][flet.].
+                `file_type` is [`FilePickerFileType.CUSTOM`][flet.].
+
+        Returns:
+            A list of selected files.
         """
         files = await self._invoke_method(
             "pick_files",

flet/controls/services/semantics_service.py

@@ -1,14 +1,112 @@
+from dataclasses import dataclass
 from enum import Enum
 
 from flet.controls.base_control import control
 from flet.controls.services.service import Service
+from flet.utils import from_dict
 
-__all__ = ["Assertiveness", "SemanticsService"]
+__all__ = ["AccessibilityFeatures", "Assertiveness", "SemanticsService"]
 
 
 class Assertiveness(Enum):
+    """
+    Determines the assertiveness level of the accessibility announcement.
+    """
+
     POLITE = "polite"
+    """
+    The assistive technology will speak changes whenever the user is idle.
+    """
+
     ASSERTIVE = "assertive"
+    """
+    The assistive technology will interrupt any announcement that it is
+    currently making to notify the user about the change.
+
+    It should only be used for time-sensitive/critical notifications.
+    """
+
+
+@dataclass
+class AccessibilityFeatures:
+    """
+    Accessibility features that may be enabled by the platform.
+
+    Note:
+        It is not possible to enable these settings from Flet, instead they are
+        used by the platform to indicate that additional accessibility features are
+        enabled.
+    """
+
+    accessible_navigation: bool
+    """
+    Whether there is a running accessibility service which is changing the
+    interaction model of the device.
+
+    For example, TalkBack on Android and VoiceOver on iOS enable this flag.
+    """
+
+    bold_text: bool
+    """
+    The platform is requesting that text be rendered at a bold font weight.
+
+    Note:
+        Only supported on iOS and Android API 31+.
+    """
+
+    disable_animations: bool
+    """
+    The platform is requesting that animations be disabled or simplified.
+    """
+
+    high_contrast: bool
+    """
+    The platform is requesting that UI be rendered with darker colors.
+
+    Note:
+        Only supported on iOS.
+    """
+
+    invert_colors: bool
+    """
+    The platform is inverting the colors of the application.
+    """
+
+    reduce_motion: bool
+    """
+    The platform is requesting that certain animations be simplified and
+    parallax effects removed.
+
+    Note:
+        Only supported on iOS.
+    """
+
+    on_off_switch_labels: bool
+    """
+    The platform is requesting to show on/off labels inside switches.
+
+    Note:
+        Only supported on iOS.
+    """
+
+    supports_announcements: bool
+    """
+    Whether the platform supports accessibility announcement API, i.e.
+    [`SemanticsService.announce_message()`][flet.SemanticsService.announce_message].
+
+    Will be `False` on platforms where announcements are deprecated or
+    unsupported by the underlying platform and `True` on platforms where such
+    announcements are generally supported without discouragement (ex: iOS, web).
+
+    Note:
+        Some platforms do not support or discourage the use of
+        announcement. Using `SemanticsService.announce_message()` on those platforms
+        may be ignored. Consider using other way to convey message to the
+        user. For example, Android discourages the uses of direct message
+        announcement, and rather encourages using other semantic
+        properties such as [`Semantics.live_region`][flet.] to convey
+        message to the user.
+    """
 
 
 @control("SemanticsService")
@@ -19,9 +117,10 @@ class SemanticsService(Service):
 
     async def announce_tooltip(self, message: str):
         """
-        Sends a semantic announcement of a tooltip. Currently honored on Android only.
+        Sends a semantic announcement of a tooltip.
 
-        The provided `message` will be read by TalkBack.
+        Note:
+            Only supported on Android.
         """
         await self._invoke_method("announce_tooltip", arguments={"message": message})
 
@@ -32,15 +131,17 @@ class SemanticsService(Service):
         assertiveness: Assertiveness = Assertiveness.POLITE,
     ):
         """
-        Sends a semantic announcement with the given `message`. This should preferably
-        be used for announcements that are not seamlessly announced by the system as a
-        result of a UI state change.
+        Sends a semantic announcement with the given message.
 
-        `rtl` is a boolean and indicates the text direction of the `message`.
+        Args:
+            message: The message to be announced.
+            rtl: Indicates if the message text direction is right-to-left.
+            assertiveness: The assertiveness level of the announcement.
+                Only supported on web.
 
-        The `assertiveness` level of the announcement is only supported by the web
-        engine and has no effect on other platforms. Value is an `Assertiveness` enum
-        and can either be `Assertiveness.ASSERTIVE` or `Assertiveness.POLITE` (default).
+        Notes:
+            This method should be used for announcements that are not automatically
+            handled by the system as a result of a UI state change.
         """
         await self._invoke_method(
             "announce_message",
@@ -50,3 +151,14 @@ class SemanticsService(Service):
                 "assertiveness": assertiveness,
             },
         )
+
+    async def get_accessibility_features(self) -> AccessibilityFeatures:
+        """
+        Returns the current platform accessibility feature flags.
+
+        Returns:
+            A snapshot of the platform's accessibility
+                preferences at the time of invocation.
+        """
+        features = await self._invoke_method("get_accessibility_features")
+        return from_dict(AccessibilityFeatures, features)

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.dev6425"
 
 
 def update_version():

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flet
-Version: 0.70.0.dev6370
+Version: 0.70.0.dev6425
 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.dev6425.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=bsmWJ4dhyVkSfL4LEUHdvb1fHjod74HlV0ehKrH0zss,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,8 +98,8 @@ 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/text.py,sha256=jKl-j9Zzoj0nuxIbj-wRj4re6VLSvygvsqTwAIiMKqg,8903
+flet/controls/core/stack.py,sha256=Px_1SllMdOwDuMv8_xp28jwccy9wleSlaM3F5H5MXgA,2749
+flet/controls/core/text.py,sha256=u63G2TPDMzKcEnQwwsgfdtwU4_Bj_HjqFi7MdTdvG8o,10201
 flet/controls/core/text_span.py,sha256=-f60CaJ6H31_f6JcYLEogiwe14Lw_HdvCAccRRsANP8,2939
 flet/controls/core/transparent_pointer.py,sha256=BGDFuDWyDUIYOmwaEgMMks6OWS_lVjZObAw2M-3r2bQ,963
 flet/controls/core/view.py,sha256=J0C7VNl-qSyNlVMyCaesFFmuBFFskz9kS3-QsxqI2hc,5015
@@ -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
@@ -173,12 +173,12 @@ flet/controls/material/expansion_tile.py,sha256=sEAXoc7-FkjFUEIgM5pK3LVKIpjsTxI2
 flet/controls/material/filled_button.py,sha256=ZtCy47Yrv2B1RyDk1pszVKiUj-YtMcLI7koTf5Bz0Mo,452
 flet/controls/material/filled_tonal_button.py,sha256=t9zXaMvakzmHUWtPfJK1ORAd8P3O5XCPi098PYAiOCU,574
 flet/controls/material/floating_action_button.py,sha256=1i9__kC4Y0uuha2lnWInYszUXLQW05_PmgiAwPUOpAk,6023
-flet/controls/material/form_field_control.py,sha256=8T3wrdfJ3j9Npz_A90TjJSFOzuVuhzR50v1qCpiRLOM,8433
+flet/controls/material/form_field_control.py,sha256=kTVeg-gfytcQdoF3bwaGu_N2kZXSR_180beNPPwTi-w,8678
 flet/controls/material/icon_button.py,sha256=ZmOmOtk7fv1B2gWOvf0yTvwxxRdI7UDl5YsNLsEzLNA,7788
 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
@@ -190,25 +190,25 @@ flet/controls/material/radio.py,sha256=IK3hS-qT3BHA-0xDXWRDSoFQQHnMw4t-x6EayPBeb
 flet/controls/material/radio_group.py,sha256=-B1djdfuOPYF1_hfjTj4CQ6ytJHhfFs2iY64ebVg63U,972
 flet/controls/material/range_slider.py,sha256=drZjlzG3kQGI0Ybl18uAQhY7YIoB056TTxw5CqxOcwM,4413
 flet/controls/material/reorderable_list_view.py,sha256=iH87xlj7pIK1Kf-nQk5_PJ1sWmA0NXLCSQArDDrB-8Q,4692
-flet/controls/material/search_bar.py,sha256=hoeZxdTG4vqCqgWlRBaJi-iGenDOpIpedHrUJqp9X04,8448
+flet/controls/material/search_bar.py,sha256=vqq7HeQmdOwCwn6TVes4OKjNwN4FzdqoRiWpT95Q4KE,8770
 flet/controls/material/segmented_button.py,sha256=f01DPN_QbUvzGS8tEilASVI6VFQwURDZ-uy2en_0U74,5510
 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/textfield.py,sha256=_JrdBKfVwwSeROm3Yh-0u2TsuovYcW7P8nQevIP7g2I,11816
-flet/controls/material/time_picker.py,sha256=_gUTaQi4N-mo1Oj_yJEsti8ToM0WhwhofbCjP5v2gzA,3070
+flet/controls/material/text_button.py,sha256=xAHx613EN07MT9fuWhvp7oUQ6zZ7Gw7rtsO5YaHrd1A,2747
+flet/controls/material/textfield.py,sha256=veYqSHOz_YDBjQsd-cK8ALxrgtWyy50p_Yyj51biPSA,12909
+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
 flet/controls/services/browser_context_menu.py,sha256=orB2vzQmZ3TvgEdZV1NUUkcQkEs49uFr9unyum2J0ug,592
 flet/controls/services/clipboard.py,sha256=XWp8OqFBUwd1ULeQ35nufGI_yR0WqNauWv8Zf1CHR0k,846
-flet/controls/services/file_picker.py,sha256=Gsh1A4XBD3nIS9MDsLDirDwTMwO9nBZGHeC-F2furXI,7662
+flet/controls/services/file_picker.py,sha256=Pd72x7ZT4xBpGSXjmQ88M6F9J621qWHWdVrygxKGpzg,7819
 flet/controls/services/haptic_feedback.py,sha256=JZMveq3loC3CWt3LPp87iWl6IeAzyUOnRejKzX9nLmo,1164
-flet/controls/services/semantics_service.py,sha256=eF_EcVqOMsgUyyZYhKTNLP-PcFTX0a8NQsQkAU-jxyk,1662
+flet/controls/services/semantics_service.py,sha256=0DkKWE0cuv4v-RIusHy9I4QQSZmz8vmADA7lHaotTVk,4829
 flet/controls/services/service.py,sha256=1k3PGJxkJOub5Eb9SIjrRo2-Ik_xrmERQD0TfxjHYC0,378
 flet/controls/services/shake_detector.py,sha256=A9o5Z89lBUL7j6OhhMWv3Qna2O_ke1h3R1AFwKgmMwk,895
 flet/controls/services/shared_preferences.py,sha256=ec_dMBMozfAalyw1exdXd9ayDY7g08oC-oE8JkqU-PE,994
@@ -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.dev6425.dist-info/METADATA,sha256=W3ne-aoxSBH-shKc3Z447t3MCIJOESQmCotE3qWBRdM,6109
+flet-0.70.0.dev6425.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+flet-0.70.0.dev6425.dist-info/entry_points.txt,sha256=mbBhHNUnLHiDqR36WeJrfLJU0Y0y087-M4wagQmaQ_Y,39
+flet-0.70.0.dev6425.dist-info/top_level.txt,sha256=HbLrSnWJX2jZOEZAI14cGzW8Q5BbOGTtE-7knD5FDh0,5
+flet-0.70.0.dev6425.dist-info/RECORD,,