flet 0.82.3.dev7882__tar.gz → 0.82.3.dev7889__tar.gz

{flet-0.82.3.dev7882 → flet-0.82.3.dev7889}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flet
-Version: 0.82.3.dev7882
+Version: 0.82.3.dev7889
 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
@@ -9,23 +9,23 @@ Project-URL: Repository, https://github.com/flet-dev/flet
 Project-URL: Documentation, https://docs.flet.dev/
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
-Requires-Dist: flet-cli==0.82.3.dev7882; extra == "cli"
-Requires-Dist: flet-web==0.82.3.dev7882; extra == "web"
+Requires-Dist: flet-cli==0.82.3.dev7889; extra == "cli"
+Requires-Dist: flet-web==0.82.3.dev7889; extra == "web"
 Requires-Dist: oauthlib>=3.2.2; platform_system != "Pyodide"
 Requires-Dist: httpx>=0.28.1; platform_system != "Pyodide"
 Requires-Dist: repath>=0.9.0
 Requires-Dist: msgpack>=1.1.0
 Requires-Dist: typing-extensions; python_version < "3.11"
 Provides-Extra: all
-Requires-Dist: flet-cli==0.82.3.dev7882; extra == "all"
-Requires-Dist: flet-web==0.82.3.dev7882; extra == "all"
-Requires-Dist: flet-desktop==0.82.3.dev7882; extra == "all"
+Requires-Dist: flet-cli==0.82.3.dev7889; extra == "all"
+Requires-Dist: flet-web==0.82.3.dev7889; extra == "all"
+Requires-Dist: flet-desktop==0.82.3.dev7889; extra == "all"
 Provides-Extra: cli
-Requires-Dist: flet-cli==0.82.3.dev7882; extra == "cli"
+Requires-Dist: flet-cli==0.82.3.dev7889; extra == "cli"
 Provides-Extra: desktop
-Requires-Dist: flet-desktop==0.82.3.dev7882; extra == "desktop"
+Requires-Dist: flet-desktop==0.82.3.dev7889; extra == "desktop"
 Provides-Extra: web
-Requires-Dist: flet-web==0.82.3.dev7882; extra == "web"
+Requires-Dist: flet-web==0.82.3.dev7889; extra == "web"
 
 <p align="center">
   <a href="https://flet.dev"><img src="https://raw.githubusercontent.com/flet-dev/flet/refs/heads/main/media/logo/flet-logo.svg" height="150" alt="Flet logo"></a>

{flet-0.82.3.dev7882 → flet-0.82.3.dev7889}/pyproject.toml

@@ -1,14 +1,14 @@
 [project]
 name = "flet"
-version = "0.82.3.dev7882"
+version = "0.82.3.dev7889"
 description = "Flet for Python - easily build interactive multi-platform apps in Python"
 authors = [{name = "Appveyor Systems Inc.", email = "hello@flet.dev"}]
 license = "Apache-2.0"
 readme = "README.md"
 requires-python = ">=3.10"
 dependencies = [
-    "flet-cli==0.82.3.dev7882; extra == 'cli'",
-    "flet-web==0.82.3.dev7882; extra == 'web'",
+    "flet-cli==0.82.3.dev7889; extra == 'cli'",
+    "flet-web==0.82.3.dev7889; extra == 'web'",
     "oauthlib >=3.2.2; platform_system != 'Pyodide'",
     "httpx >=0.28.1; platform_system != 'Pyodide'",
     "repath >=0.9.0",
@@ -23,15 +23,15 @@ Documentation = "https://docs.flet.dev/"
 
 [project.optional-dependencies]
 all = [
-    "flet-cli==0.82.3.dev7882",
-    "flet-web==0.82.3.dev7882",
-    "flet-desktop==0.82.3.dev7882",
+    "flet-cli==0.82.3.dev7889",
+    "flet-web==0.82.3.dev7889",
+    "flet-desktop==0.82.3.dev7889",
 ]
-cli = ["flet-cli==0.82.3.dev7882"]
+cli = ["flet-cli==0.82.3.dev7889"]
 desktop = [
-    "flet-desktop==0.82.3.dev7882",
+    "flet-desktop==0.82.3.dev7889",
 ]
-web = ["flet-web==0.82.3.dev7882"]
+web = ["flet-web==0.82.3.dev7889"]
 
 [project.scripts]
 flet = "flet.cli:main"

{flet-0.82.3.dev7882 → flet-0.82.3.dev7889}/src/flet/__init__.py

@@ -26,7 +26,7 @@ from flet.controls.animation import (
     AnimationStyle,
     AnimationValue,
 )
-from flet.controls.base_control import BaseControl, control
+from flet.controls.base_control import BaseControl, Value, control, value
 from flet.controls.base_page import BasePage, PageMediaData, PageResizeEvent
 from flet.controls.blur import (
     Blur,
@@ -304,7 +304,11 @@ from flet.controls.material.divider import Divider
 from flet.controls.material.dropdown import Dropdown, DropdownOption
 from flet.controls.material.dropdownm2 import DropdownM2
 from flet.controls.material.elevated_button import ElevatedButton
-from flet.controls.material.expansion_panel import ExpansionPanel, ExpansionPanelList
+from flet.controls.material.expansion_panel import (
+    ExpansionPanel,
+    ExpansionPanelList,
+    ExpansionPanelListChangeEvent,
+)
 from flet.controls.material.expansion_tile import ExpansionTile, TileAffinity
 from flet.controls.material.filled_button import FilledButton
 from flet.controls.material.filled_tonal_button import FilledTonalButton
@@ -775,6 +779,7 @@ __all__ = [
     "EventHandler",
     "ExpansionPanel",
     "ExpansionPanelList",
+    "ExpansionPanelListChangeEvent",
     "ExpansionTile",
     "ExpansionTileTheme",
     "FilePicker",
@@ -1058,6 +1063,7 @@ __all__ = [
     "UrlTarget",
     "UserAccelerometer",
     "UserAccelerometerReadingEvent",
+    "Value",
     "ValueKey",
     "VerticalAlignment",
     "VerticalDivider",
@@ -1106,6 +1112,7 @@ __all__ = [
     "use_memo",
     "use_ref",
     "use_state",
+    "value",
 ]
 
 _THEME_EXPORTS = {

{flet-0.82.3.dev7882 → flet-0.82.3.dev7889}/src/flet/app.py

@@ -221,7 +221,7 @@ async def run_async(
         if url_prefix is not None:
             print(url_prefix, page_url)
         else:
-            logger.info(f"App URL: {page_url}")
+            logger.info("App URL: %s", page_url)
 
         if view == AppView.WEB_BROWSER and url_prefix is None and not force_web_server:
             open_in_browser(page_url)
@@ -438,7 +438,7 @@ async def __run_web_server(
     if port == 0:
         port = get_free_tcp_port()
 
-    logger.info(f"Starting Flet web server on port {port}...")
+    logger.info("Starting Flet web server on port %s...", port)
 
     log_level = logging.getLogger("flet").getEffectiveLevel()
     if log_level == logging.CRITICAL or log_level == logging.NOTSET:
@@ -520,7 +520,7 @@ def __get_assets_dir_path(assets_dir: Optional[str], relative_to_cwd=False):
                     .joinpath(assets_dir)
                     .resolve()
                 )
-        logger.info(f"Assets path configured: {assets_dir}")
+        logger.info("Assets path configured: %s", assets_dir)
 
     env_assets_dir = os.getenv("FLET_ASSETS_DIR")
     if env_assets_dir:

{flet-0.82.3.dev7882 → flet-0.82.3.dev7889}/src/flet/controls/alignment.py

@@ -1,7 +1,7 @@
-from dataclasses import dataclass
 from enum import Enum
 from typing import ClassVar, Optional
 
+from flet.controls.base_control import value
 from flet.controls.types import Number
 
 __all__ = [
@@ -29,7 +29,7 @@ class Axis(Enum):
     """
 
 
-@dataclass
+@value
 class Alignment:
     """
     Defines an alignment relative to the center.

{flet-0.82.3.dev7882 → flet-0.82.3.dev7889}/src/flet/controls/animation.py

@@ -1,7 +1,8 @@
-from dataclasses import dataclass, field
+from dataclasses import field
 from enum import Enum
 from typing import Optional, Union
 
+from flet.controls.base_control import value
 from flet.controls.duration import Duration, DurationValue
 
 __all__ = [
@@ -228,7 +229,7 @@ class AnimationCurve(Enum):
     """
 
 
-@dataclass
+@value
 class Animation:
     """
     Explicit animation configuration for animatable control properties.
@@ -267,7 +268,7 @@ class Animation:
         )
 
 
-@dataclass
+@value
 class AnimationStyle:
     """
     Used to override the default parameters of an animation.

{flet-0.82.3.dev7882 → flet-0.82.3.dev7889}/src/flet/controls/base_control.py

@@ -7,8 +7,8 @@ from typing import TYPE_CHECKING, Any, Callable, Optional, TypeVar, Union, overl
 from flet.controls.context import _context_page, context
 from flet.controls.control_event import ControlEvent, get_event_field_type
 from flet.controls.id_counter import ControlId
-from flet.controls.keys import KeyValue
 from flet.controls.ref import Ref
+from flet.controls.value_types import Prop, Value, _install_props, value
 from flet.utils.from_dict import from_dict
 from flet.utils.object_model import get_param_count
 
@@ -23,14 +23,26 @@ else:
 
 if TYPE_CHECKING:
     from .base_page import BasePage
+    from .keys import KeyValue
     from .page import Page
 
 __all__ = [
     "BaseControl",
+    "Prop",
+    "Value",
     "control",
     "skip_field",
+    "value",
 ]
 
+# ---------------------------------------------------------------------------
+# Sparse property tracking is defined in value_types.py to avoid circular
+# imports: value types (Duration, Alignment, etc.) need @value but are
+# imported transitively by this module.
+# Prop, Value, _install_props and value are re-exported from here
+# for backwards compatibility.
+# ---------------------------------------------------------------------------
+
 
 def skip_field():
     """
@@ -123,6 +135,7 @@ def _apply_control(
 ) -> type[T]:
     """Applies @control logic, ensuring compatibility with @dataclass."""
     cls = dataclass(**dataclass_kwargs)(cls)  # Apply @dataclass first
+    _install_props(cls)  # Install Prop descriptors for sparse tracking
 
     orig_post_init = getattr(cls, "__post_init__", lambda self, *args: None)
 
@@ -147,6 +160,26 @@ class BaseControl:
     Base class for all Flet controls and services.
     """
 
+    # ------------------------------------------------------------------
+    # Sparse property tracking — MUST be the first two init=False fields
+    # so the dataclass-generated __init__ initialises them before any
+    # Prop.__set__ call for init=True fields.
+    # ------------------------------------------------------------------
+    _values: dict = field(
+        default_factory=dict,
+        init=False,
+        repr=False,
+        compare=False,
+        metadata={"skip": True},
+    )
+    _dirty: dict = field(
+        default_factory=dict,
+        init=False,
+        repr=False,
+        compare=False,
+        metadata={"skip": True},
+    )
+
     _i: int = field(init=False, compare=False)
     """
     Runtime-generated internal control id used by the session protocol.
@@ -162,7 +195,7 @@ class BaseControl:
     Arbitrary data of any type.
     """
 
-    key: Optional[KeyValue] = None
+    key: Optional["KeyValue"] = None
 
     ref: InitVar[Optional[Ref["BaseControl"]]] = None
     """A reference to this control."""
@@ -195,6 +228,9 @@ class BaseControl:
             ref.current = self
 
         self.init()
+        # Construction is not a mutation: clear dirty tracking so only
+        # post-construction mutations are visible to the non-frozen diff.
+        self._dirty.clear()
 
         # control_id = self._i
         # object_id = id(self)
@@ -228,7 +264,7 @@ class BaseControl:
         return parent_ref() if parent_ref else None
 
     @property
-    def page(self) -> Union["Page", "BasePage"]:
+    def page(self) -> "Union[Page, BasePage]":
         """
         The page to which this control belongs to.
         """
@@ -311,7 +347,7 @@ class BaseControl:
         Override to start resources that require an attached page, for example
         subscriptions, timers, or service listeners.
         """
-        controls_log.debug(f"{self}.did_mount()")
+        controls_log.debug("%s.did_mount()", self)
         pass
 
     def will_unmount(self):
@@ -321,7 +357,7 @@ class BaseControl:
         Override to dispose resources created in `did_mount()`, such as
         subscriptions, timers, or external handles.
         """
-        controls_log.debug(f"{self}.will_unmount()")
+        controls_log.debug("%s.will_unmount()", self)
         pass
 
     # public methods
@@ -398,7 +434,7 @@ class BaseControl:
             _context_page.set(self.page)
             context.reset_auto_update()
 
-            controls_log.debug(f"Trigger event {self}.{field_name} {e}")
+            controls_log.debug("Trigger event %s.%s %s", self, field_name, e)
 
             if not self.page:
                 raise RuntimeError(
@@ -460,3 +496,8 @@ class BaseControl:
         Return a debug-friendly control identifier string.
         """
         return f"{self._c}({self._i} - {id(self)})"
+
+
+# Install Prop descriptors for BaseControl's own public fields (key).
+# Subclasses decorated with @control get this called via _apply_control.
+_install_props(BaseControl)

{flet-0.82.3.dev7882 → flet-0.82.3.dev7889}/src/flet/controls/blur.py

@@ -1,7 +1,7 @@
-from dataclasses import dataclass
 from enum import Enum
 from typing import Optional, Union
 
+from flet.controls.base_control import value
 from flet.controls.types import Number
 
 __all__ = [
@@ -37,7 +37,7 @@ class BlurTileMode(Enum):
     """
 
 
-@dataclass
+@value
 class Blur:
     """
     Gaussian blur configuration.

{flet-0.82.3.dev7882 → flet-0.82.3.dev7889}/src/flet/controls/border.py

@@ -1,7 +1,8 @@
-from dataclasses import dataclass, field
+from dataclasses import field
 from enum import Enum
 from typing import Optional, Union
 
+from flet.controls.base_control import value
 from flet.controls.colors import Colors
 from flet.controls.types import ColorValue, Number
 from flet.utils import deprecated
@@ -52,7 +53,7 @@ class BorderStyle(Enum):
     """Draw the border as a solid line."""
 
 
-@dataclass
+@value
 class BorderSide:
     """
     Creates the side of a border.
@@ -172,7 +173,7 @@ class BorderSide:
         return BorderSide(width=0.0, style=BorderStyle.NONE)
 
 
-@dataclass
+@value
 class Border:
     """
     A border comprised of four sides: `top`, `right`, `bottom`, `left`.

{flet-0.82.3.dev7882 → flet-0.82.3.dev7889}/src/flet/controls/border_radius.py

@@ -1,6 +1,6 @@
-import dataclasses
 from typing import Optional, Union
 
+from flet.controls.base_control import value
 from flet.controls.types import Number
 from flet.utils import deprecated
 
@@ -14,7 +14,7 @@ __all__ = [
 ]
 
 
-@dataclasses.dataclass
+@value
 class BorderRadius:
     """
     Corner radii for a rectangle, defined for all four corners.

{flet-0.82.3.dev7882 → flet-0.82.3.dev7889}/src/flet/controls/box.py

@@ -1,8 +1,9 @@
-from dataclasses import dataclass, field
+from dataclasses import field
 from enum import Enum
 from typing import Optional, Union
 
 from flet.controls.alignment import Alignment
+from flet.controls.base_control import value
 from flet.controls.border import Border
 from flet.controls.border_radius import BorderRadiusValue
 from flet.controls.colors import Colors
@@ -29,7 +30,7 @@ __all__ = [
 ]
 
 
-@dataclass
+@value
 class ColorFilter:
     """
     Defines a color filter.
@@ -122,7 +123,7 @@ class BlurStyle(Enum):
     """
 
 
-@dataclass
+@value
 class BoxShadow:
     """
     Configuration for a box's shadow.
@@ -276,7 +277,7 @@ class BoxFit(Enum):
     """  # noqa: E501
 
 
-@dataclass
+@value
 class DecorationImage:
     """
     An image for a box decoration.
@@ -381,7 +382,7 @@ class DecorationImage:
         )
 
 
-@dataclass
+@value
 class BoxDecoration:
     """
     BoxDecoration provides a description of how to paint a box.
@@ -470,7 +471,7 @@ class BoxDecoration:
         )
 
 
-@dataclass
+@value
 class BoxConstraints:
     """
     Constraints that must be respected by a size of a box.

{flet-0.82.3.dev7882 → flet-0.82.3.dev7889}/src/flet/controls/buttons.py

@@ -1,7 +1,8 @@
-from dataclasses import dataclass, field
+from dataclasses import field
 from typing import Optional
 
 from flet.controls.alignment import Alignment
+from flet.controls.base_control import value
 from flet.controls.border import BorderSide
 from flet.controls.border_radius import BorderRadiusValue
 from flet.controls.control_state import ControlStateValue
@@ -27,7 +28,7 @@ __all__ = [
 ]
 
 
-@dataclass
+@value
 class ShapeBorder:
     """
     Base class for shape outlines. Not intended to be used directly.
@@ -38,7 +39,7 @@ class ShapeBorder:
     """
 
 
-@dataclass
+@value
 class OutlinedBorder(ShapeBorder):
     """
     An abstract class that can be used to create custom borders.
@@ -60,7 +61,7 @@ class OutlinedBorder(ShapeBorder):
     _type: Optional[str] = field(init=False, repr=False, compare=False, default=None)
 
 
-@dataclass
+@value
 class StadiumBorder(OutlinedBorder):
     """
     A border that looks like a stadium.
@@ -82,7 +83,7 @@ class StadiumBorder(OutlinedBorder):
         )
 
 
-@dataclass
+@value
 class RoundedRectangleBorder(OutlinedBorder):
     """
     A border with rounded rectangle corners.
@@ -111,7 +112,7 @@ class RoundedRectangleBorder(OutlinedBorder):
         )
 
 
-@dataclass
+@value
 class CircleBorder(OutlinedBorder):
     """
     A border with a circle shape.
@@ -139,7 +140,7 @@ class CircleBorder(OutlinedBorder):
         )
 
 
-@dataclass
+@value
 class BeveledRectangleBorder(RoundedRectangleBorder):
     """
     A border with beveled rectangle corners.
@@ -163,7 +164,7 @@ class BeveledRectangleBorder(RoundedRectangleBorder):
         )
 
 
-@dataclass
+@value
 class ContinuousRectangleBorder(RoundedRectangleBorder):
     """
     A border with continuous rectangle corners.
@@ -187,7 +188,7 @@ class ContinuousRectangleBorder(RoundedRectangleBorder):
         )
 
 
-@dataclass
+@value
 class ButtonStyle:
     """
     Allows controlling all visual aspects of a button, such as shape, foreground, \

{flet-0.82.3.dev7882 → flet-0.82.3.dev7889}/src/flet/controls/core/canvas/path.py

@@ -1,7 +1,7 @@
-from dataclasses import dataclass, field
+from dataclasses import field
 from typing import Optional
 
-from flet.controls.base_control import control
+from flet.controls.base_control import control, value
 from flet.controls.border_radius import BorderRadiusValue
 from flet.controls.core.canvas.shape import Shape
 from flet.controls.painting import Paint
@@ -20,7 +20,7 @@ class Path(Shape):
     (see `Path.Close`).
     """
 
-    @dataclass(kw_only=True)
+    @value(kw_only=True)
     class PathElement:
         """
         Base type for elements stored in `Path.elements`.
@@ -47,7 +47,7 @@ class Path(Shape):
     A style to draw a path with.
     """
 
-    @dataclass
+    @value
     class MoveTo(PathElement):
         """
         Starts a new sub-path at the given point (`x`,`y`).
@@ -59,7 +59,7 @@ class Path(Shape):
         def __post_init__(self):
             self._type = "MoveTo"
 
-    @dataclass
+    @value
     class LineTo(PathElement):
         """
         Adds a straight line segment from the current point to the given point \
@@ -72,7 +72,7 @@ class Path(Shape):
         def __post_init__(self):
             self._type = "LineTo"
 
-    @dataclass
+    @value
     class QuadraticTo(PathElement):
         """
         Adds a bezier segment that curves from the current point to the given point \
@@ -92,7 +92,7 @@ class Path(Shape):
         def __post_init__(self):
             self._type = "QuadraticTo"
 
-    @dataclass
+    @value
     class CubicTo(PathElement):
         """
         Adds a cubic bezier segment that curves from the current point to the given \
@@ -109,7 +109,7 @@ class Path(Shape):
         def __post_init__(self):
             self._type = "CubicTo"
 
-    @dataclass
+    @value
     class SubPath(PathElement):
         """
         Adds the sub-path described by `elements` to the given point (`x`,`y`).
@@ -122,7 +122,7 @@ class Path(Shape):
         def __post_init__(self):
             self._type = "SubPath"
 
-    @dataclass
+    @value
     class Arc(PathElement):
         """
         Adds a new sub-path with one arc segment that consists of the arc that follows \
@@ -167,7 +167,7 @@ class Path(Shape):
         def __post_init__(self):
             self._type = "Arc"
 
-    @dataclass
+    @value
     class ArcTo(PathElement):
         """
         Appends up to four conic curves weighted to describe an oval of `radius` and \
@@ -216,7 +216,7 @@ class Path(Shape):
         def __post_init__(self):
             self._type = "ArcTo"
 
-    @dataclass
+    @value
     class Oval(PathElement):
         """
         Adds a new sub-path that consists of a curve that forms the ellipse that fills \
@@ -246,7 +246,7 @@ class Path(Shape):
         def __post_init__(self):
             self._type = "Oval"
 
-    @dataclass
+    @value
     class Rect(PathElement):
         """
         Adds a rectangle as a new sub-path.
@@ -280,7 +280,7 @@ class Path(Shape):
         def __post_init__(self):
             self._type = "Rect"
 
-    @dataclass
+    @value
     class Close(PathElement):
         """
         Closes the last sub-path, as if a straight line had been drawn from the \

{flet-0.82.3.dev7882 → flet-0.82.3.dev7889}/src/flet/controls/core/markdown.py

@@ -1,8 +1,7 @@
-from dataclasses import dataclass
 from enum import Enum
 from typing import Optional, Union
 
-from flet.controls.base_control import control
+from flet.controls.base_control import control, value
 from flet.controls.box import BoxDecoration
 from flet.controls.control import Control
 from flet.controls.control_event import ControlEventHandler, EventHandler
@@ -55,7 +54,7 @@ class MarkdownExtensionSet(Enum):
     """
 
 
-@dataclass
+@value
 class MarkdownStyleSheet:
     """
     Style overrides for markdown element rendering.
@@ -676,7 +675,7 @@ class MarkdownCodeTheme(Enum):
     """
 
 
-@dataclass
+@value
 class MarkdownCustomCodeTheme:
     """
     Custom text-style mapping for code token highlighting.