flet 0.70.0.dev5776__py3-none-any.whl → 0.70.0.dev6145__py3-none-any.whl

flet/controls/base_control.py

@@ -7,7 +7,7 @@ from typing import TYPE_CHECKING, Any, Callable, Optional, TypeVar, Union
 
 from flet.controls.context import _context_page, context
 from flet.controls.control_event import ControlEvent, get_event_field_type
-from flet.controls.control_id import ControlId
+from flet.controls.id_counter import ControlId
 from flet.controls.keys import KeyValue
 from flet.controls.ref import Ref
 from flet.utils.from_dict import from_dict
@@ -119,7 +119,6 @@ class BaseControl:
     """
     Arbitrary data of any type.
     """
-
     key: Optional[KeyValue] = None
 
     ref: InitVar[Optional[Ref["BaseControl"]]] = None
@@ -173,18 +172,21 @@ class BaseControl:
         return parent_ref() if parent_ref else None
 
     @property
-    def page(self) -> Optional[Union["Page", "BasePage"]]:
+    def page(self) -> Union["Page", "BasePage"]:
         """
         The page to which this control belongs to.
         """
-        from .page import BasePage, Page
+        from .page import Page
 
         parent = self
         while parent:
-            if isinstance(parent, (Page, BasePage)):
+            if isinstance(parent, (Page)):
                 return parent
             parent = parent.parent
-        return None
+        raise RuntimeError(
+            f"{self.__class__.__qualname__}({self._i}) "
+            "Control must be added to the page first"
+        )
 
     def is_isolated(self):
         return hasattr(self, "_isolated") and self._isolated
@@ -209,15 +211,25 @@ class BaseControl:
         """
         pass
 
+    def _before_update_safe(self):
+        frozen = getattr(self, "_frozen", None)
+        if frozen is not None:
+            del self._frozen
+
+        self.before_update()
+
+        if frozen is not None:
+            self._frozen = frozen
+
     def before_event(self, e: ControlEvent):
         return True
 
     def did_mount(self):
-        controls_log.debug(f"{self._c}({self._i}).did_mount")
+        controls_log.debug(f"{self}.did_mount()")
         pass
 
     def will_unmount(self):
-        controls_log.debug(f"{self._c}({self._i}).will_unmount")
+        controls_log.debug(f"{self}.will_unmount()")
         pass
 
     # public methods
@@ -239,7 +251,7 @@ class BaseControl:
             f"{self.__class__.__qualname__} Control must be added to the page first"
         )
 
-        return await self.page.get_session().invoke_method(
+        return await self.page.session.invoke_method(
             self._i, method_name, arguments, timeout
         )
 
@@ -271,11 +283,13 @@ class BaseControl:
             _context_page.set(self.page)
             context.reset_auto_update()
 
+            controls_log.debug(f"Trigger event {self}.{field_name} {e}")
+
             assert self.page, (
                 "Control must be added to a page before triggering events. "
                 "Use page.add(control) or add it to a parent control that's on a page."
             )
-            session = self.page.get_session()
+            session = self.page.session
 
             # Handle async and sync event handlers accordingly
             event_handler = getattr(self, field_name)
@@ -310,3 +324,13 @@ class BaseControl:
                     event_handler(e)
 
             await session.after_event(session.index.get(self._i))
+
+    def _migrate_state(self, other: "BaseControl"):
+        if not isinstance(other, BaseControl):
+            return
+        self._i = other._i
+        if self.data is None:
+            self.data = other.data
+
+    def __str__(self):
+        return f"{self._c}({self._i} - {id(self)})"

flet/controls/base_page.py

@@ -159,33 +159,32 @@ class BasePage(AdaptiveControl):
     reported by the framework.
     """
 
-    width: Optional[Number] = None
+    title: Optional[str] = None
+    """
+    Page or window title.
     """
-    Page width in logical pixels.
 
-    Note:
-        - This property is read-only.
-        - To get or set the full window height including window chrome (e.g.,
-            title bar and borders) when running a Flet app on desktop,
-            use the [`width`][flet.Window.] property of
-            [`Page.window`][flet.] instead.
+    enable_screenshots: bool = False
+    """
+    Enable taking screenshots of the entire page with `take_screenshot` method.
     """
 
-    height: Optional[Number] = None
+    on_resize: Optional[EventHandler["PageResizeEvent"]] = None
     """
-    Page height in logical pixels.
+    Called when a user resizes a browser or native OS window containing Flet app, for
+    example:
 
-    Note:
-        - This property is read-only.
-        - To get or set the full window height including window chrome (e.g.,
-            title bar and borders) when running a Flet app on desktop,
-            use the [`height`][flet.Window.] property of
-            [`Page.window`][flet.] instead.
+    ```python
+    def page_resize(e):
+        print("New page size:", page.window.width, page.window_height)
+
+    page.on_resize = page_resize
+    ```
     """
 
-    title: Optional[str] = None
+    on_media_change: Optional[EventHandler[PageMediaData]] = None
     """
-    Page or window title.
+    Called when `media` has changed.
     """
 
     media: PageMediaData = field(
@@ -197,30 +196,35 @@ class BasePage(AdaptiveControl):
         )
     )
     """
-    Represents the environmental metrics of a page or window.
-    """
+    The current environmental metrics of the page or window.
 
-    enable_screenshots: bool = False
-    """
-    Enable taking screenshots of the entire page with `take_screenshot` method.
+    This data is updated whenever the platform window or layout changes,
+    such as when rotating a device, resizing a browser window, or adjusting
+    system UI elements like the keyboard or safe areas.
     """
 
-    on_resize: Optional[EventHandler["PageResizeEvent"]] = None
+    width: Optional[Number] = None
     """
-    Called when a user resizes a browser or native OS window containing Flet app, for
-    example:
-
-    ```python
-    def page_resize(e):
-        print("New page size:", page.window.width, page.window_height)
+    Page width in logical pixels.
 
-    page.on_resize = page_resize
-    ```
+    Note:
+        - This property is read-only.
+        - To get or set the full window height including window chrome (e.g.,
+            title bar and borders) when running a Flet app on desktop,
+            use the [`width`][flet.Window.width] property of
+            [`Page.window`][flet.Page.window] instead.
     """
 
-    on_media_change: Optional[EventHandler[PageMediaData]] = None
+    height: Optional[Number] = None
     """
-    Called when `media` has changed.
+    Page height in logical pixels.
+
+    Note:
+        - This property is read-only.
+        - To get or set the full window height including window chrome (e.g.,
+            title bar and borders) when running a Flet app on desktop,
+            use the [`height`][flet.Window.height] property of
+            [`Page.window`][flet.Page.window] instead.
     """
 
     _overlay: "Overlay" = field(default_factory=lambda: Overlay())
@@ -492,29 +496,29 @@ class BasePage(AdaptiveControl):
 
     # horizontal_alignment
     @property
-    def horizontal_alignment(self) -> Optional[CrossAxisAlignment]:
+    def horizontal_alignment(self) -> CrossAxisAlignment:
         return self.__default_view().horizontal_alignment
 
     @horizontal_alignment.setter
-    def horizontal_alignment(self, value: Optional[CrossAxisAlignment]):
+    def horizontal_alignment(self, value: CrossAxisAlignment):
         self.__default_view().horizontal_alignment = value
 
     # vertical_alignment
     @property
-    def vertical_alignment(self) -> Optional[MainAxisAlignment]:
+    def vertical_alignment(self) -> MainAxisAlignment:
         return self.__default_view().vertical_alignment
 
     @vertical_alignment.setter
-    def vertical_alignment(self, value: Optional[MainAxisAlignment]):
+    def vertical_alignment(self, value: MainAxisAlignment):
         self.__default_view().vertical_alignment = value
 
     # spacing
     @property
-    def spacing(self) -> Optional[Number]:
+    def spacing(self) -> Number:
         return self.__default_view().spacing
 
     @spacing.setter
-    def spacing(self, value: Optional[Number]):
+    def spacing(self, value: Number):
         self.__default_view().spacing = value
 
     # padding

flet/controls/context.py

@@ -13,6 +13,9 @@ class Context:
     Context instance is accessed via [`flet.context`][flet.context].
     """
 
+    def __init__(self) -> None:
+        self.__components_mode = False
+
     @property
     def page(self) -> "Page":
         """
@@ -95,6 +98,21 @@ class Context:
         """
         _update_behavior_context_var.get()._auto_update_enabled = False
 
+    def enable_components_mode(self):
+        """
+        Enables components mode in the current context.
+        """
+        self.__components_mode = True
+
+    def is_components_mode(self) -> bool:
+        """
+        Returns whether the current context is in components mode.
+
+        Returns:
+            `True` if in components mode, `False` otherwise.
+        """
+        return self.__components_mode
+
     def auto_update_enabled(self) -> bool:
         """
         Returns whether auto-update is enabled in the current context.
@@ -102,7 +120,10 @@ class Context:
         Returns:
             `True` if auto-update is enabled, `False` otherwise.
         """
-        return _update_behavior_context_var.get()._auto_update_enabled
+        return (
+            not self.__components_mode
+            and _update_behavior_context_var.get()._auto_update_enabled
+        )
 
     def reset_auto_update(self):
         """

flet/controls/control_event.py

@@ -32,14 +32,17 @@ __all__ = [
 
 def get_event_field_type(control: Any, field_name: str):
     frame = inspect.currentframe().f_back
-    globalns = sys.modules[control.__class__.__module__].__dict__
     localns = frame.f_globals.copy()
     localns.update(frame.f_locals)
 
     merged_annotations = {}
+    annotation_modules = {}
 
     for cls in control.__class__.__mro__:
         annotations = getattr(cls, "__annotations__", {})
+        module = sys.modules.get(cls.__module__)
+        module_dict = module.__dict__ if module else {}
+
         for name, annotation in annotations.items():
             if get_origin(annotation) is InitVar or str(annotation).startswith(
                 "dataclasses.InitVar"
@@ -47,12 +50,25 @@ def get_event_field_type(control: Any, field_name: str):
                 continue  # Skip InitVar
             if name not in merged_annotations:
                 merged_annotations[name] = annotation
+                annotation_modules[name] = module_dict
 
     if field_name not in merged_annotations:
         return None
 
     annotation = merged_annotations[field_name]
 
+    globalns = {}
+    current_module = sys.modules.get(control.__class__.__module__)
+    if current_module:
+        globalns.update(current_module.__dict__)
+
+    owner_module_dict = annotation_modules.get(field_name)
+    if owner_module_dict:
+        for key, value in owner_module_dict.items():
+            globalns.setdefault(key, value)
+
+    globalns.setdefault("__builtins__", __builtins__)
+
     try:
         # Resolve forward refs manually
         if isinstance(annotation, ForwardRef):
@@ -80,7 +96,8 @@ class Event(Generic[EventControlType]):
     control: EventControlType = field(repr=False)
 
     @property
-    def page(self) -> Optional[Union["Page", "BasePage"]]:
+    def page(self) -> Union["Page", "BasePage"]:
+        assert self.control.page
         return self.control.page
 
     @property

flet/controls/core/column.py

@@ -65,6 +65,11 @@ class Column(LayoutControl, ScrollableControl, AdaptiveControl):
     is `True`.
     """
 
+    intrinsic_width: bool = False
+    """
+    If `True`, the Column will be as wide as the widest child control.
+    """
+
     def init(self):
         super().init()
         self._internals["host_expanded"] = True

flet/controls/core/drag_target.py

@@ -1,9 +1,10 @@
-from dataclasses import dataclass
-from typing import Optional
+from dataclasses import dataclass, field
+from typing import Optional, cast
 
 from flet.controls.base_control import control
 from flet.controls.control import Control
 from flet.controls.control_event import Event, EventHandler
+from flet.controls.core.draggable import Draggable
 from flet.controls.transform import Offset
 
 __all__ = [
@@ -15,14 +16,22 @@ __all__ = [
 
 
 @dataclass
-class DragWillAcceptEvent(Event["DragTarget"]):
+class DragEventBase(Event["DragTarget"]):
+    src_id: Optional[int]
+    src: Draggable = field(init=False)
+
+    def __post_init__(self):
+        if self.src_id is not None:
+            self.src = cast(Draggable, self.page.get_control(self.src_id))
+
+
+@dataclass
+class DragWillAcceptEvent(DragEventBase):
     accept: bool
-    src_id: int
 
 
 @dataclass
-class DragTargetEvent(Event["DragTarget"]):
-    src_id: int
+class DragTargetEvent(DragEventBase):
     x: float
     y: float
 
@@ -32,8 +41,8 @@ class DragTargetEvent(Event["DragTarget"]):
 
 
 @dataclass
-class DragTargetLeaveEvent(Event["DragTarget"]):
-    src_id: Optional[int]
+class DragTargetLeaveEvent(DragEventBase):
+    pass
 
 
 @control("DragTarget")

flet/controls/core/row.py

@@ -68,6 +68,11 @@ class Row(LayoutControl, ScrollableControl, AdaptiveControl):
     How the runs should be placed in the cross-axis when `wrap=True`.
     """
 
+    intrinsic_height: bool = False
+    """
+    If `True`, the Row will be as tall as the tallest child control.
+    """
+
     def init(self):
         super().init()
         self._internals["host_expanded"] = True

flet/controls/core/view.py

@@ -37,12 +37,6 @@ class View(ScrollableControl, LayoutControl):
     control, so it has a similar behavior and shares same properties.
     """
 
-    route: Optional[str] = None
-    """
-    View's route - not currently used by Flet framework, but can be used in a user
-    program to update [`Page.route`][flet.] when a view popped.
-    """
-
     controls: list[BaseControl] = field(default_factory=list)
     """
     A list of controls to display.
@@ -71,6 +65,12 @@ class View(ScrollableControl, LayoutControl):
     ///
     """
 
+    route: Optional[str] = field(default_factory=lambda: "/")
+    """
+    View's route - not currently used by Flet framework, but can be used in a user
+    program to update [`Page.route`][flet.Page.route] when a view popped.
+    """
+
     appbar: Optional[Union[AppBar, CupertinoAppBar]] = None
     """
     An [`AppBar`][flet.] control to display at the top of

flet/controls/cupertino/cupertino_icons.py

@@ -4,7 +4,7 @@ Flet Cupertino Icons
 To generate/update this file run from the root of the repository:
 
 ```
-uv run ci/generate_icons.py
+uv run .github/scripts/generate_icons.py
 ```
 """
 

flet/controls/id_counter.py

@@ -0,0 +1,24 @@
+import itertools
+import threading
+from typing import Optional
+
+from flet.utils.locks import NopeLock
+from flet.utils.platform_utils import is_pyodide
+
+
+class IdCounter:
+    def __init__(
+        self, start: int = 1, step: int = 1, lock: Optional[threading.Lock] = None
+    ):
+        self._counter = itertools.count(start, step)
+        self._lock = lock or (NopeLock() if is_pyodide() else threading.Lock())
+
+    def next(self) -> int:
+        with self._lock:
+            return next(self._counter)
+
+    def __call__(self) -> int:  # for dataclass default_factory
+        return self.next()
+
+
+ControlId = IdCounter(start=3)

flet/controls/material/divider.py

@@ -1,6 +1,7 @@
 from typing import Optional
 
 from flet.controls.base_control import control
+from flet.controls.border_radius import BorderRadiusValue
 from flet.controls.control import Control
 from flet.controls.types import ColorValue, Number
 
@@ -62,6 +63,11 @@ class Divider(Control):
     If that is also `None`, defaults to `0.0`.
     """
 
+    radius: Optional[BorderRadiusValue] = None
+    """
+    The border radius of the divider.
+    """
+
     def before_update(self):
         super().before_update()
         if self.height is not None and self.height < 0:

flet/controls/material/icons.py

@@ -4,7 +4,7 @@ Flet Material Icons
 To generate/update this file run from the root of the repository:
 
 ```
-uv run ci/generate_icons.py
+uv run .github/scripts/generate_icons.py
 ```
 """
 

flet/controls/material/textfield.py

@@ -3,7 +3,7 @@ from enum import Enum
 from typing import Optional, Union
 
 from flet.controls.adaptive_control import AdaptiveControl
-from flet.controls.base_control import control
+from flet.controls.base_control import BaseControl, control
 from flet.controls.control_event import ControlEventHandler
 from flet.controls.core.autofill_group import AutofillHint
 from flet.controls.material.form_field_control import FormFieldControl
@@ -424,6 +424,15 @@ class TextField(FormFieldControl, AdaptiveControl):
     TBD
     """
 
+    def _migrate_state(self, other: BaseControl):
+        super()._migrate_state(other)
+        if (
+            isinstance(other, TextField)
+            and self.value is None
+            and self.value != other.value
+        ):
+            self.value = other.value
+
     def before_update(self):
         super().before_update()
         if self.min_lines is not None and self.min_lines <= 0:

flet/controls/material/vertical_divider.py

@@ -1,6 +1,7 @@
 from typing import Optional
 
 from flet.controls.base_control import control
+from flet.controls.border_radius import BorderRadiusValue
 from flet.controls.control import Control
 from flet.controls.types import ColorValue, Number
 
@@ -67,6 +68,11 @@ class VerticalDivider(Control):
     If that's is also `None`, defaults to `0.0`.
     """
 
+    radius: Optional[BorderRadiusValue] = None
+    """
+    The border radius of the divider.
+    """
+
     def before_update(self):
         super().before_update()
         if self.width is not None and self.width < 0: