flet 0.84.0.dev0__tar.gz → 0.85.0.dev1__tar.gz

{flet-0.84.0.dev0 → flet-0.85.0.dev1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flet
-Version: 0.84.0.dev0
+Version: 0.85.0.dev1
 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://flet.dev/docs/
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
-Requires-Dist: flet-cli==0.84.0.dev0; extra == "cli"
-Requires-Dist: flet-web==0.84.0.dev0; extra == "web"
+Requires-Dist: flet-cli==0.85.0.dev1; extra == "cli"
+Requires-Dist: flet-web==0.85.0.dev1; 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.84.0.dev0; extra == "all"
-Requires-Dist: flet-web==0.84.0.dev0; extra == "all"
-Requires-Dist: flet-desktop==0.84.0.dev0; extra == "all"
+Requires-Dist: flet-cli==0.85.0.dev1; extra == "all"
+Requires-Dist: flet-web==0.85.0.dev1; extra == "all"
+Requires-Dist: flet-desktop==0.85.0.dev1; extra == "all"
 Provides-Extra: cli
-Requires-Dist: flet-cli==0.84.0.dev0; extra == "cli"
+Requires-Dist: flet-cli==0.85.0.dev1; extra == "cli"
 Provides-Extra: desktop
-Requires-Dist: flet-desktop==0.84.0.dev0; extra == "desktop"
+Requires-Dist: flet-desktop==0.85.0.dev1; extra == "desktop"
 Provides-Extra: web
-Requires-Dist: flet-web==0.84.0.dev0; extra == "web"
+Requires-Dist: flet-web==0.85.0.dev1; 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.84.0.dev0 → flet-0.85.0.dev1}/pyproject.toml

@@ -1,14 +1,14 @@
 [project]
 name = "flet"
-version = "0.84.0.dev0"
+version = "0.85.0.dev1"
 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.84.0.dev0; extra == 'cli'",
-    "flet-web==0.84.0.dev0; extra == 'web'",
+    "flet-cli==0.85.0.dev1; extra == 'cli'",
+    "flet-web==0.85.0.dev1; 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://flet.dev/docs/"
 
 [project.optional-dependencies]
 all = [
-    "flet-cli==0.84.0.dev0",
-    "flet-web==0.84.0.dev0",
-    "flet-desktop==0.84.0.dev0",
+    "flet-cli==0.85.0.dev1",
+    "flet-web==0.85.0.dev1",
+    "flet-desktop==0.85.0.dev1",
 ]
-cli = ["flet-cli==0.84.0.dev0"]
+cli = ["flet-cli==0.85.0.dev1"]
 desktop = [
-    "flet-desktop==0.84.0.dev0",
+    "flet-desktop==0.85.0.dev1",
 ]
-web = ["flet-web==0.84.0.dev0"]
+web = ["flet-web==0.85.0.dev1"]
 
 [project.scripts]
 flet = "flet.cli:main"

{flet-0.84.0.dev0 → flet-0.85.0.dev1}/src/flet/__init__.py

@@ -4,7 +4,12 @@ from flet.app import AppCallable, app, app_async, run, run_async
 from flet.components.component import Component
 from flet.components.component_decorator import component
 from flet.components.hooks.use_callback import use_callback
-from flet.components.hooks.use_context import create_context, use_context
+from flet.components.hooks.use_context import (
+    ContextProvider,
+    create_context,
+    use_context,
+)
+from flet.components.hooks.use_dialog import use_dialog
 from flet.components.hooks.use_effect import (
     on_mounted,
     on_unmounted,
@@ -17,6 +22,17 @@ from flet.components.hooks.use_state import use_state
 from flet.components.memo import memo
 from flet.components.observable import Observable, observable
 from flet.components.public_utils import unwrap_component
+from flet.components.router import (
+    LocationInfo,
+    Route,
+    Router,
+    is_route_active,
+    use_route_loader_data,
+    use_route_location,
+    use_route_outlet,
+    use_route_params,
+    use_view_path,
+)
 from flet.controls import alignment, border, border_radius, margin, padding
 from flet.controls.adaptive_control import AdaptiveControl
 from flet.controls.alignment import Alignment, Axis
@@ -102,7 +118,7 @@ from flet.controls.core.drag_target import (
     DragWillAcceptEvent,
 )
 from flet.controls.core.draggable import Draggable
-from flet.controls.core.flet_app import FletApp
+from flet.controls.core.flet_app import FletApp, FletAppOutputEvent
 from flet.controls.core.gesture_detector import GestureDetector
 from flet.controls.core.grid_view import GridView
 from flet.controls.core.hero import Hero
@@ -409,6 +425,7 @@ from flet.controls.page import (
     PlatformBrightnessChangeEvent,
     RouteChangeEvent,
     ViewPopEvent,
+    ViewsPopUntilEvent,
 )
 from flet.controls.painting import (
     Paint,
@@ -699,6 +716,7 @@ __all__ = [
     "ContextMenuDismissEvent",
     "ContextMenuSelectEvent",
     "ContextMenuTrigger",
+    "ContextProvider",
     "ContinuousRectangleBorder",
     "Control",
     "ControlEvent",
@@ -796,6 +814,7 @@ __all__ = [
     "FilledTonalIconButton",
     "FilterQuality",
     "FletApp",
+    "FletAppOutputEvent",
     "FletException",
     "FletPageDisconnectedException",
     "FletUnimplementedPlatformException",
@@ -853,6 +872,7 @@ __all__ = [
     "Locale",
     "LocaleChangeEvent",
     "LocaleConfiguration",
+    "LocationInfo",
     "LoginEvent",
     "LongPressDownEvent",
     "LongPressEndEvent",
@@ -950,8 +970,10 @@ __all__ = [
     "RotateValue",
     "RotatedBox",
     "RoundedRectangleBorder",
+    "Route",
     "RouteChangeEvent",
     "RouteUrlStrategy",
+    "Router",
     "Row",
     "SafeArea",
     "Scale",
@@ -1072,6 +1094,7 @@ __all__ = [
     "VerticalDivider",
     "View",
     "ViewPopEvent",
+    "ViewsPopUntilEvent",
     "VisualDensity",
     "Wakelock",
     "WebBrowserName",
@@ -1099,6 +1122,7 @@ __all__ = [
     "dropdown",
     "dropdownm2",
     "icons",
+    "is_route_active",
     "margin",
     "memo",
     "observable",
@@ -1111,10 +1135,16 @@ __all__ = [
     "unwrap_component",
     "use_callback",
     "use_context",
+    "use_dialog",
     "use_effect",
     "use_memo",
     "use_ref",
+    "use_route_loader_data",
+    "use_route_location",
+    "use_route_outlet",
+    "use_route_params",
     "use_state",
+    "use_view_path",
     "value",
 ]
 

{flet-0.84.0.dev0 → flet-0.85.0.dev1}/src/flet/components/component.py

@@ -80,6 +80,8 @@ class Component(BaseControl):
     memoized: bool = field(default=False, metadata={"skip": True})
     _stale: bool = field(default=False, metadata={"skip": True})
 
+    visible: bool = True
+
     _b: Any = None  # body
 
     def _migrate_state(self, other: BaseControl):
@@ -104,6 +106,14 @@ class Component(BaseControl):
             logger.debug("%s.update(): skipping (stale)", self)
             return
 
+        # Don't re-render unmounted components.  A stale observable listener
+        # (or queued pending update) can fire after `will_unmount` — running
+        # the component body here would create a new render tree that is
+        # never attached, leaking fresh subscriptions and zombie children.
+        if not self._state.mounted:
+            logger.debug("%s.update(): skipping (unmounted)", self)
+            return
+
         logger.debug(
             "%s.update(), memoized: %s",
             self,
@@ -183,6 +193,12 @@ class Component(BaseControl):
         Mark component dirty and enqueue a session update.
         """
 
+        # Skip updates for unmounted components.  Stale observable listeners
+        # that fire after will_unmount must not resurrect a zombie control.
+        if not self._state.mounted:
+            logger.debug("%s.schedule_update(): skipping (unmounted)", self)
+            return
+
         logger.debug("%s.schedule_update()", self)
         self._state.is_dirty = True
         context.page.session.schedule_update(self)

flet-0.85.0.dev1/src/flet/components/hooks/use_dialog.py

@@ -0,0 +1,136 @@
+from __future__ import annotations
+
+import dataclasses
+import weakref
+
+from flet.components.hooks.use_effect import use_effect
+from flet.components.hooks.use_ref import use_ref
+from flet.controls.context import context
+from flet.controls.dialog_control import DialogControl
+
+
+def _find_dialog_index(dialogs, target):
+    # Identity (`is`) comparison — dialog controls are dataclasses and two
+    # dialogs built from the same field values compare equal with `==`,
+    # so `in` / `.index()` would match the wrong entry when two sibling
+    # hosts each manage a similarly-shaped dialog.
+    for i, c in enumerate(dialogs.controls):
+        if c is target:
+            return i
+    return -1
+
+
+def _bind_dialog_subtree(value, parent):
+    if dataclasses.is_dataclass(value):
+        if parent is not None and parent is not value:
+            value._parent = weakref.ref(parent)
+        for field in dataclasses.fields(value):
+            if not field.metadata.get("skip", False):
+                _bind_dialog_subtree(getattr(value, field.name), value)
+    elif isinstance(value, list):
+        for item in value:
+            _bind_dialog_subtree(item, parent)
+    elif isinstance(value, dict):
+        for item in value.values():
+            _bind_dialog_subtree(item, parent)
+
+
+def use_dialog(dialog: DialogControl | None = None):
+    """
+    Portal a :class:`~flet.DialogControl` to the page's dialog overlay.
+
+    Call this hook inside a :func:`~flet.component` function on every render.
+    Pass a :class:`~flet.DialogControl` instance to show the dialog,
+    or `None` to hide/remove it.
+
+    The hook automatically sets `open=True` on the dialog when it is
+    added to the overlay and removes it when `None` is passed or the
+    component unmounts.
+
+    Args:
+        dialog: A :class:`~flet.DialogControl` to display, or `None`
+            to hide it.
+    """
+    ref = use_ref(None)
+    page = context.page
+
+    prev = ref.current
+
+    if prev is not None and _find_dialog_index(page._dialogs, prev) < 0:
+        ref.current = None
+        prev = None
+
+    if dialog is not None:
+        prev_idx = _find_dialog_index(page._dialogs, prev) if prev is not None else -1
+        if (
+            prev is not None
+            and prev_idx >= 0
+            and prev.open
+            and type(prev) is type(dialog)
+        ):
+            # Frozen diff: compares prev and dialog field-by-field, migrates
+            # `_i` onto the new instance via `_migrate_state`, and emits only
+            # actual field deltas. This is what preserves Flutter widget
+            # identity for nested controls — notably the TextField inside an
+            # AlertDialog keeps its cursor/focus across re-renders.
+            dialog.open = True
+            page._prepare_dialog(dialog)
+            page.session.patch_control(control=dialog, prev_control=prev, frozen=True)
+            # Strip the `_frozen` marker set by _dataclass_added during the
+            # frozen diff so we can later set open=False for dismissal.
+            if hasattr(dialog, "_frozen"):
+                del dialog._frozen
+            # Replace the old instance with the new one in the overlay list
+            # — at the SAME index, so sibling hosts' entries aren't disturbed.
+            _bind_dialog_subtree(dialog, page._dialogs)
+            page._dialogs.controls[prev_idx] = dialog
+            # Keep `_dialogs.__prev_lists['controls']` aligned with the new
+            # instance. Without this, a later `_dialogs.update()` triggered
+            # by an unrelated operation (e.g. `page.show_dialog(SnackBar)`)
+            # would diff the fresh `controls` list against a snapshot
+            # pointing at the old Python object — different `id()`, so the
+            # diff emits a full REPLACE of the dialog. On Dart, REPLACE
+            # creates a new Control with `_open` unset, and the next build
+            # re-enters the show branch and pushes a second DialogRoute on
+            # top of the existing one. The dialog then refuses to close.
+            prev_lists = getattr(page._dialogs, "__prev_lists", None)
+            if prev_lists is not None and "controls" in prev_lists:
+                prev_lists["controls"][prev_idx] = dialog
+            ref.current = dialog
+        else:
+            dialog.open = True
+            page._prepare_dialog(dialog)
+            _bind_dialog_subtree(dialog, page._dialogs)
+            # Either `prev` is gone (already dismissed on the client) or
+            # is still in the list with `open=False` (mid-dismiss,
+            # awaiting the client's on_dismiss round-trip).  In the
+            # latter case we must NOT reuse `prev`'s `_i` — Flutter's
+            # `AlertDialogControl` still carries `_open=True` locally
+            # from when the previous dialog was shown, so reusing `_i`
+            # means the new `open=True` patch hits `open == lastOpen`
+            # and the new dialog never calls `showDialog`.  Append a
+            # fresh entry (new `_i`) and let the dismissing one finish
+            # on its own.
+            page._dialogs.controls.append(dialog)
+            ref.current = dialog
+            page.session.schedule_update(page._dialogs)
+    elif prev is not None and prev.open:
+        # Dismiss: flip open=False and patch the dialog directly.  The
+        # frozen-patch path above swaps the dialog instance in
+        # `_dialogs.controls`, which desyncs `_dialogs.__prev_lists`
+        # — so a `schedule_update(_dialogs)` here would miss the
+        # `open=False` delta entirely. Patching `prev` directly is both
+        # cheaper (one op vs a full list diff) and unaffected by the
+        # list-snapshot state.
+        prev.open = False
+        page.session.patch_control(prev)
+
+    def _cleanup():
+        d = ref.current
+        if d is not None:
+            ref.current = None
+            if d.open:
+                d.open = False
+                page.session.patch_control(d)
+
+    use_effect(lambda: None, dependencies=[], cleanup=_cleanup)

{flet-0.84.0.dev0 → flet-0.85.0.dev1}/src/flet/components/observable.py

@@ -151,7 +151,6 @@ class Observable:
             """
             Remove the subscribed listener from this observable.
             """
-
             with contextlib.suppress(KeyError):
                 self.__listeners.remove(fn)