flet 1.0.3__tar.gz → 1.1.0.dev0__tar.gz

{flet-1.0.3 → flet-1.1.0.dev0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flet
-Version: 1.0.3
+Version: 1.1.0.dev0
 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==1.0.3; extra == "cli"
-Requires-Dist: flet-web==1.0.3; extra == "web"
+Requires-Dist: flet-cli==1.1.0.dev0; extra == "cli"
+Requires-Dist: flet-web==1.1.0.dev0; extra == "web"
 Requires-Dist: oauthlib>=3.2.2; platform_system != "Emscripten"
 Requires-Dist: httpx>=0.28.1; platform_system != "Emscripten"
 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==1.0.3; extra == "all"
-Requires-Dist: flet-web==1.0.3; extra == "all"
-Requires-Dist: flet-desktop==1.0.3; extra == "all"
+Requires-Dist: flet-cli==1.1.0.dev0; extra == "all"
+Requires-Dist: flet-web==1.1.0.dev0; extra == "all"
+Requires-Dist: flet-desktop==1.1.0.dev0; extra == "all"
 Provides-Extra: cli
-Requires-Dist: flet-cli==1.0.3; extra == "cli"
+Requires-Dist: flet-cli==1.1.0.dev0; extra == "cli"
 Provides-Extra: desktop
-Requires-Dist: flet-desktop==1.0.3; extra == "desktop"
+Requires-Dist: flet-desktop==1.1.0.dev0; extra == "desktop"
 Provides-Extra: web
-Requires-Dist: flet-web==1.0.3; extra == "web"
+Requires-Dist: flet-web==1.1.0.dev0; extra == "web"
 Provides-Extra: test
 Requires-Dist: pytest>=7.2.0; extra == "test"
 Requires-Dist: pytest-asyncio>=1.1.0; extra == "test"

{flet-1.0.3 → flet-1.1.0.dev0}/pyproject.toml

@@ -1,14 +1,14 @@
 [project]
 name = "flet"
-version = "1.0.3"
+version = "1.1.0.dev0"
 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==1.0.3; extra == 'cli'",
-    "flet-web==1.0.3; extra == 'web'",
+    "flet-cli==1.1.0.dev0; extra == 'cli'",
+    "flet-web==1.1.0.dev0; extra == 'web'",
     "oauthlib >=3.2.2; platform_system != 'Emscripten'",
     "httpx >=0.28.1; platform_system != 'Emscripten'",
     "repath >=0.9.0",
@@ -23,15 +23,15 @@ Documentation = "https://flet.dev/docs/"
 
 [project.optional-dependencies]
 all = [
-    "flet-cli==1.0.3",
-    "flet-web==1.0.3",
-    "flet-desktop==1.0.3",
+    "flet-cli==1.1.0.dev0",
+    "flet-web==1.1.0.dev0",
+    "flet-desktop==1.1.0.dev0",
 ]
-cli = ["flet-cli==1.0.3"]
+cli = ["flet-cli==1.1.0.dev0"]
 desktop = [
-    "flet-desktop==1.0.3",
+    "flet-desktop==1.1.0.dev0",
 ]
-web = ["flet-web==1.0.3"]
+web = ["flet-web==1.1.0.dev0"]
 # Dependencies needed to run integration tests written with `flet.testing`
 # (the `flet test` command / the pytest plugin). Pillow/numpy/scikit-image
 # back screenshot and GIF comparison.
@@ -67,6 +67,7 @@ extensions = [
     "flet-permission-handler",
     "flet-rive",
     "flet-secure-storage",
+    "flet-shadcn-ui",
     "flet-spinkit",
     "flet-video",
     "flet-webview",

{flet-1.0.3 → flet-1.1.0.dev0}/src/flet/__init__.py

@@ -158,13 +158,17 @@ if TYPE_CHECKING:
     from flet.controls.core.flet_app import (
         FletApp,
         FletAppOutputEvent,
+        FletAppWindowEvent,
     )
     from flet.controls.core.gesture_detector import GestureDetector
     from flet.controls.core.grid_view import GridView
     from flet.controls.core.hero import Hero
     from flet.controls.core.icon import Icon
     from flet.controls.core.image import Image
-    from flet.controls.core.interactive_viewer import InteractiveViewer
+    from flet.controls.core.interactive_viewer import (
+        InteractiveViewer,
+        InteractiveViewerTransform,
+    )
     from flet.controls.core.keyboard_listener import (
         KeyboardListener,
         KeyDownEvent,
@@ -295,6 +299,7 @@ if TYPE_CHECKING:
         DragUpdateEvent,
         ForcePressEvent,
         HoverEvent,
+        InteractiveViewerTransformEvent,
         LongPressDownEvent,
         LongPressEndEvent,
         LongPressMoveUpdateEvent,
@@ -513,6 +518,7 @@ if TYPE_CHECKING:
     )
     from flet.controls.material.vertical_divider import VerticalDivider
     from flet.controls.multi_view import MultiView
+    from flet.controls.package_info import PackageInfo
     from flet.controls.padding import (
         Padding,
         PaddingValue,
@@ -650,6 +656,7 @@ if TYPE_CHECKING:
         FloatingActionButtonTheme,
         IconButtonTheme,
         IconTheme,
+        InputDecorationTheme,
         ListTileTheme,
         NavigationBarTheme,
         NavigationDrawerTheme,
@@ -670,8 +677,10 @@ if TYPE_CHECKING:
         SystemOverlayStyle,
         TabBarTheme,
         TextButtonTheme,
+        TextFieldTheme,
         TextTheme,
         Theme,
+        ThemeSurfaces,
         TimePickerTheme,
         TooltipTheme,
     )
@@ -705,6 +714,7 @@ if TYPE_CHECKING:
         Locale,
         LocaleConfiguration,
         MainAxisAlignment,
+        MaterialTapTargetSize,
         MouseCursor,
         NotchShape,
         Number,
@@ -936,6 +946,7 @@ __all__ = [
     "FilterQuality",
     "FletApp",
     "FletAppOutputEvent",
+    "FletAppWindowEvent",
     "FletException",
     "FletPageDisconnectedException",
     "FletUnimplementedPlatformException",
@@ -967,8 +978,11 @@ __all__ = [
     "Image",
     "ImageRepeat",
     "InputBorder",
+    "InputDecorationTheme",
     "InputFilter",
     "InteractiveViewer",
+    "InteractiveViewerTransform",
+    "InteractiveViewerTransformEvent",
     "IosDeviceInfo",
     "IosUtsname",
     "Key",
@@ -1010,6 +1024,7 @@ __all__ = [
     "MarkdownCustomCodeTheme",
     "MarkdownExtensionSet",
     "MarkdownStyleSheet",
+    "MaterialTapTargetSize",
     "Matrix4",
     "MenuBar",
     "MenuItemButton",
@@ -1048,6 +1063,7 @@ __all__ = [
     "OutlinedButtonTheme",
     "OutlinedIconButton",
     "OverlayVisibilityMode",
+    "PackageInfo",
     "Padding",
     "PaddingValue",
     "Page",
@@ -1188,6 +1204,7 @@ __all__ = [
     "TextDecorationStyle",
     "TextField",
     "TextFieldPasteFilesEvent",
+    "TextFieldTheme",
     "TextOnlyInputFilter",
     "TextOverflow",
     "TextSelection",
@@ -1199,6 +1216,7 @@ __all__ = [
     "TextThemeStyle",
     "Theme",
     "ThemeMode",
+    "ThemeSurfaces",
     "TileAffinity",
     "TimePicker",
     "TimePickerEntryMode",
@@ -1454,6 +1472,8 @@ _LAZY = {
     "DropdownM2": "flet.controls.material.dropdownm2",
     "DropdownOption": "flet.controls.material.dropdown",
     "DropdownTheme": "flet.controls.theme",
+    "InputDecorationTheme": "flet.controls.theme",
+    "TextFieldTheme": "flet.controls.theme",
     "Duration": "flet.controls.duration",
     "DurationValue": "flet.controls.duration",
     "Event": "flet.controls.control_event",
@@ -1478,6 +1498,7 @@ _LAZY = {
     "FilterQuality": "flet.controls.box",
     "FletApp": "flet.controls.core.flet_app",
     "FletAppOutputEvent": "flet.controls.core.flet_app",
+    "FletAppWindowEvent": "flet.controls.core.flet_app",
     "FletException": "flet.controls.exceptions",
     "FletPageDisconnectedException": "flet.controls.exceptions",
     "FletUnimplementedPlatformException": "flet.controls.exceptions",
@@ -1511,6 +1532,8 @@ _LAZY = {
     "InputBorder": "flet.controls.material.form_field_control",
     "InputFilter": "flet.controls.material.textfield",
     "InteractiveViewer": "flet.controls.core.interactive_viewer",
+    "InteractiveViewerTransform": "flet.controls.core.interactive_viewer",
+    "InteractiveViewerTransformEvent": "flet.controls.events",
     "IosDeviceInfo": "flet.controls.device_info",
     "IosUtsname": "flet.controls.device_info",
     "Key": "flet.controls.keys",
@@ -1590,6 +1613,7 @@ _LAZY = {
     "OutlinedButtonTheme": "flet.controls.theme",
     "OutlinedIconButton": "flet.controls.material.icon_button",
     "OverlayVisibilityMode": "flet.controls.cupertino.cupertino_textfield",
+    "PackageInfo": "flet.controls.package_info",
     "Padding": "flet.controls.padding",
     "PaddingValue": "flet.controls.padding",
     "Page": "flet.controls.page",
@@ -1741,6 +1765,7 @@ _LAZY = {
     "TextThemeStyle": "flet.controls.text_style",
     "Theme": "flet.controls.theme",
     "ThemeMode": "flet.controls.types",
+    "ThemeSurfaces": "flet.controls.theme",
     "TileAffinity": "flet.controls.material.expansion_tile",
     "TimePicker": "flet.controls.material.time_picker",
     "TimePickerEntryMode": "flet.controls.material.time_picker",
@@ -1768,6 +1793,7 @@ _LAZY = {
     "ViewPopEvent": "flet.controls.page",
     "ViewsPopUntilEvent": "flet.controls.page",
     "VisualDensity": "flet.controls.types",
+    "MaterialTapTargetSize": "flet.controls.types",
     "Wakelock": "flet.controls.services.wakelock",
     "WebBrowserName": "flet.controls.device_info",
     "WebDeviceInfo": "flet.controls.device_info",

{flet-1.0.3 → flet-1.1.0.dev0}/src/flet/app.py

@@ -30,10 +30,21 @@ from flet.utils.pip import (
 
 logger = logging.getLogger("flet")
 
-#: Conventional assets directory name, used as the default for `assets_dir`.
-#: A missing directory of this name is unremarkable; any other value was
-#: chosen deliberately, so a missing one is reported.
 DEFAULT_ASSETS_DIR = "assets"
+"""Conventional assets directory name, used as the default for `assets_dir`.
+
+A missing directory of this name is unremarkable; any other value was chosen
+deliberately, so a missing one is reported.
+"""
+
+DISPLAY_ASSETS_DIR_SUFFIX = "_ASSETS_DIR"
+"""Suffix of the line on which an app started by `flet run` reports its assets dir.
+
+Appended to `FLET_DISPLAY_URL_PREFIX`, it starts the line the app prints just
+before its page URL line, with its resolved assets directory (empty when it has
+none). `flet run` opens the desktop client with that directory, so the app's own
+`assets_dir` reaches it.
+"""
 
 AppCallable = Callable[[Page], Union[Any, Awaitable[Any]]]
 """Type alias for Flet app lifecycle callbacks.
@@ -222,11 +233,15 @@ async def run_async(
         """
         Handle app-start notification by logging/printing URL and optional browser open.
 
+        When started by `flet run`, the resolved assets directory is printed on
+        its own line first, so `flet run` can open the desktop client with it.
+
         Args:
             page_url: Resolved URL of the running app.
         """
 
         if url_prefix is not None:
+            print(f"{url_prefix}{DISPLAY_ASSETS_DIR_SUFFIX}", assets_dir or "")
             parts = [url_prefix, page_url]
             if view is not None:
                 parts.append(view.value)
@@ -688,9 +703,10 @@ def __get_assets_dir_path(assets_dir: Optional[str], relative_to_cwd=False):
     such a directory, so a missing one is unremarkable; any other value was
     chosen deliberately, so a missing one is a mistake worth a warning.
 
-    The env override is applied afterwards and is never dropped:
-    `FLET_ASSETS_DIR` is always set on purpose, so a bad value there is left
-    for downstream to report.
+    `FLET_ASSETS_DIR` takes precedence and is never dropped: it is always set
+    on purpose, so a bad value there is left for downstream to report. When it
+    is set, `assets_dir` is not checked, so nothing is logged about a
+    directory that isn't used.
 
     Args:
         assets_dir: Input assets directory path.
@@ -702,6 +718,11 @@ def __get_assets_dir_path(assets_dir: Optional[str], relative_to_cwd=False):
             exist.
     """
 
+    env_assets_dir = os.getenv("FLET_ASSETS_DIR")
+    if env_assets_dir:
+        logger.info("Assets path configured: %s (FLET_ASSETS_DIR)", env_assets_dir)
+        return env_assets_dir
+
     if assets_dir:
         requested = assets_dir
         if not Path(assets_dir).is_absolute():
@@ -724,10 +745,6 @@ def __get_assets_dir_path(assets_dir: Optional[str], relative_to_cwd=False):
             else:
                 logger.warning("assets_dir does not exist: %s", assets_dir)
             assets_dir = None
-
-    env_assets_dir = os.getenv("FLET_ASSETS_DIR")
-    if env_assets_dir:
-        assets_dir = env_assets_dir
     return assets_dir
 
 

{flet-1.0.3 → flet-1.1.0.dev0}/src/flet/controls/core/flet_app.py

@@ -1,11 +1,13 @@
-from dataclasses import dataclass
+from dataclasses import dataclass, field
 from typing import Any, Optional
 
 from flet.controls.base_control import control
 from flet.controls.control_event import ControlEventHandler, Event, EventHandler
 from flet.controls.layout_control import LayoutControl
+from flet.controls.padding import PaddingValue
+from flet.controls.types import Brightness
 
-__all__ = ["FletApp", "FletAppOutputEvent"]
+__all__ = ["FletApp", "FletAppOutputEvent", "FletAppWindowEvent"]
 
 
 @dataclass
@@ -21,6 +23,21 @@ class FletAppOutputEvent(Event["FletApp"]):
     """True for stderr writes; False for stdout."""
 
 
+@dataclass
+class FletAppWindowEvent(Event["FletApp"]):
+    """The embedded app asked its window to do something."""
+
+    action: str
+    """Either a `Window` method name (`close`, `maximize`, `minimize`,
+    `center`, `destroy`, ...) or `"set"` when the app wrote window properties
+    directly."""
+
+    # Not `data`: that name is already the base Event's payload, and shadowing
+    # it with a default reorders the base's own non-default fields.
+    args: dict[str, Any] = field(default_factory=dict, metadata={"data_field": "data"})
+    """Method arguments, or the properties written when `action` is `"set"`."""
+
+
 @control("FletApp")
 class FletApp(LayoutControl):
     """
@@ -37,6 +54,75 @@ class FletApp(LayoutControl):
     Optional dictionary of arguments to pass to the Flet app.
     """
 
+    route: Optional[str] = None
+    """
+    The embedded app's current route.
+
+    Two-way: setting it navigates the embedded app, and when the embedded app
+    navigates itself this property is updated to match and
+    [`on_route_change`][(c).] fires. Leave it `None` to let the embedded app
+    own its own routing.
+
+    Note:
+        The embedded app routes locally - it never touches the browser address
+        bar or the platform's deep links, both of which belong to the host app.
+    """
+
+    title: Optional[str] = None
+    """
+    The embedded app's `page.title`.
+
+    Written by the client whenever the embedded app sets its title, together
+    with [`on_title_change`][(c).]. A guest's title belongs to whatever window
+    its host draws around it - it does not touch the real OS window, because
+    the window service is suppressed for embedded apps.
+    """
+
+    window_state: Optional[dict[str, Any]] = None
+    """
+    The simulated window the embedded app should believe it lives in.
+
+    Keys are [`Window`][flet.Window] property names - `width`, `height`,
+    `top`, `left`, `maximized`, `minimized`, `full_screen`, `focused`. What
+    you set here is what the embedded app reads back from `page.window`, and
+    changing it raises the matching `page.window.on_event` inside the app
+    (`resize`, `maximize`, `focus`, ...) exactly as a real window would.
+
+    An embedded app never drives the real OS window, so without this its
+    `page.window` is inert.
+    """
+
+    media_padding: Optional[PaddingValue] = None
+    """
+    Overrides the safe-area insets the embedded app sees.
+
+    The embedded app normally inherits the host window's `MediaQuery`, so on a
+    desktop window its insets are zero regardless of what the app is being
+    previewed as. Setting this makes the embedded app lay out as though it had
+    those insets: `page.media.padding` reports them, and
+    [`SafeArea`][flet.SafeArea] avoids them.
+
+    Intended for previewing a phone layout inside a desktop window - a device
+    frame in a designer, say - where the chrome drawn around the app is not
+    something the platform knows about.
+    """
+
+    platform_brightness: Optional[Brightness] = None
+    """
+    Overrides the system light/dark appearance the embedded app sees.
+
+    By default the embedded app follows the host's platform brightness. Set
+    this to preview it as though its device were in light or dark mode: an app
+    whose [`theme_mode`][flet.Page.theme_mode] is `SYSTEM` switches to its dark
+    or light theme, [`page.platform_brightness`][flet.Page.platform_brightness]
+    reports the value, and
+    [`on_platform_brightness_change`][flet.Page.on_platform_brightness_change]
+    fires when it changes. An app that forces `LIGHT` or `DARK` keeps it, as
+    on a real device.
+
+    `None` follows the host.
+    """
+
     assets_dir: Optional[str] = None
     """
     Base location for assets referenced by the embedded app. On web this
@@ -89,6 +175,31 @@ class FletApp(LayoutControl):
     Called when a connection or any unhandled error occurs.
     """
 
+    on_title_change: Optional[ControlEventHandler["FletApp"]] = None
+    """
+    Called when the embedded app sets `page.title`. The event `data` is the new
+    title, which is also written back to [`title`][(c).].
+    """
+
+    on_window_event: Optional[EventHandler[FletAppWindowEvent]] = None
+    """
+    Called when the embedded app asks its window to do something - a method
+    call like `page.window.close()`, or a property write like
+    `page.window.maximized = True`.
+
+    A request, not a command: nothing happens unless the host acts on it, which
+    is how a host that does not simulate, say, minimizing simply ignores it.
+    """
+
+    on_route_change: Optional[ControlEventHandler["FletApp"]] = None
+    """
+    Called when the embedded app navigates itself. The event `data` is the new
+    route, which is also written back to [`route`][(c).].
+
+    Does not fire for navigation the host itself caused by setting
+    [`route`][(c).].
+    """
+
     on_connect: Optional[ControlEventHandler["FletApp"]] = None
     """
     Fires when the client allocates an in-process `dart_bridge` channel for this

{flet-1.0.3 → flet-1.1.0.dev0}/src/flet/controls/core/interactive_viewer.py

@@ -1,4 +1,4 @@
-from dataclasses import field
+from dataclasses import dataclass, field
 from typing import Annotated, Optional
 
 from flet.controls.alignment import Alignment
@@ -7,6 +7,7 @@ from flet.controls.control import Control
 from flet.controls.control_event import EventHandler
 from flet.controls.duration import DurationValue
 from flet.controls.events import (
+    InteractiveViewerTransformEvent,
     ScaleEndEvent,
     ScaleStartEvent,
     ScaleUpdateEvent,
@@ -16,7 +17,67 @@ from flet.controls.margin import Margin, MarginValue
 from flet.controls.types import ClipBehavior, Number
 from flet.utils.validation import V
 
-__all__ = ["InteractiveViewer"]
+__all__ = ["InteractiveViewer", "InteractiveViewerTransform"]
+
+
+@dataclass(kw_only=True)
+class InteractiveViewerTransform:
+    """
+    Effective transform currently applied to an :class:`InteractiveViewer`.
+
+    ``scale`` is Flutter's ``Matrix4.getMaxScaleOnAxis()`` after min/max scale
+    and boundary clamping. ``1.0`` is the identity transform of the laid-out
+    content, not a ratio against the content's original pixel size.
+
+    ``matrix`` is the 16 column-major entries of that matrix, in the same
+    order as Flutter's ``Matrix4.storage``. The translation component is also
+    available as :attr:`translation_x`, :attr:`translation_y` and
+    :attr:`translation_z` (storage indexes 12, 13 and 14).
+
+    This does not by itself give a physical length. That also depends on the
+    laid-out size of the content and on a separate mapping from that content
+    to the real world. If either changes, the same transform describes a
+    different physical size.
+    """
+
+    scale: float
+    """
+    Maximum scale factor along the matrix axes. ``1.0`` is identity.
+    """
+
+    translation_x: float
+    """
+    Horizontal translation, in logical pixels.
+    """
+
+    translation_y: float
+    """
+    Vertical translation, in logical pixels.
+    """
+
+    translation_z: float
+    """
+    Z translation stored on the matrix.
+    """
+
+    matrix: list[float]
+    """
+    Column-major 4x4 matrix. Length is 16.
+    """
+
+    @classmethod
+    def from_message(cls, message: dict) -> "InteractiveViewerTransform":
+        """
+        Build a transform from the map returned by the Dart viewer.
+        """
+        matrix = message["m"]
+        return cls(
+            scale=float(message["s"]),
+            translation_x=float(message["tx"]),
+            translation_y=float(message["ty"]),
+            translation_z=float(message["tz"]),
+            matrix=[float(item) for item in matrix],
+        )
 
 
 @control("InteractiveViewer")
@@ -167,8 +228,10 @@ class InteractiveViewer(LayoutControl):
 
     interaction_update_interval: int = 200
     """
-    The interval (in milliseconds) at which the :attr:`on_interaction_update` event is \
-    fired.
+    The minimum interval in milliseconds between intermediate
+    :attr:`on_interaction_update` and :attr:`on_transform_changed` events.
+    For :attr:`on_transform_changed`, the final effective transform
+    is also delivered after changes stop.
     """
 
     on_interaction_start: Optional[
@@ -192,6 +255,27 @@ class InteractiveViewer(LayoutControl):
     Called when the user ends a pan or scale gesture.
     """
 
+    on_transform_changed: Optional[
+        EventHandler[InteractiveViewerTransformEvent["InteractiveViewer"]]
+    ] = None
+    """
+    Called when the effective transform changes.
+
+    Fires for pinch and pan gestures, pointer-wheel or trackpad zoom, and for
+    :meth:`zoom`, :meth:`pan`, :meth:`reset` and :meth:`restore_state`.
+    :meth:`save_state` only stores a snapshot, so it does not fire this event.
+    Intermediate updates are limited to :attr:`interaction_update_interval`
+    milliseconds. When changes stop, including the end of a wheel burst, an
+    inertial pan, :meth:`zoom` and an animated :meth:`reset`, one further
+    event is delivered if needed. That event matches :meth:`get_transform`.
+
+    ``on_interaction_update`` reports the gesture's relative scale, not this
+    absolute transform. Neither event is a physical length: the content's
+    laid-out size and any mapping from that content to the real world are
+    separate. If those change, this transform alone does not keep a
+    real-world measurement correct.
+    """
+
     async def reset(self, animation_duration: Optional[DurationValue] = None):
         """
         Resets the current transform matrix to identity.
@@ -258,3 +342,33 @@ class InteractiveViewer(LayoutControl):
             and defaults to `0`.
         """
         await self._invoke_method("pan", arguments={"dx": dx, "dy": dy, "dz": dz})
+
+    async def get_scale(self) -> float:
+        """
+        Return the effective scale currently applied to :attr:`content`.
+
+        Returns:
+            ``1.0`` for identity, after min/max scale and boundary clamping.
+            This is the scale of the laid-out content, not a ratio against
+            the content's original pixel size, and not a physical length.
+
+        Raises:
+            RuntimeError: If this control is not on a page.
+        """
+        return float(await self._invoke_method("get_scale"))
+
+    async def get_transform(self) -> InteractiveViewerTransform:
+        """
+        Return the effective transform currently applied to :attr:`content`.
+
+        Returns:
+            Scale, translation and the column-major 4x4 matrix, after
+            clamping. A physical length also needs the content's laid-out
+            size and a mapping from that content to the real world.
+
+        Raises:
+            RuntimeError: If this control is not on a page.
+        """
+        return InteractiveViewerTransform.from_message(
+            await self._invoke_method("get_transform")
+        )

{flet-1.0.3 → flet-1.1.0.dev0}/src/flet/controls/core/semantics.py

@@ -160,7 +160,12 @@ class Semantics(Control):
 
     heading_level: Optional[int] = None
     """
-    The heading level in the DOM document structure.
+    The heading level in the document structure.
+
+    A level of `1` usually marks the main heading of a page, `2` its first
+    subsection, and so on. Screen readers use it to navigate between sections: on
+    web it sets the `aria-level` attribute, and on iOS and Android 9 (API 28) or
+    later any level marks the node as a heading for VoiceOver and TalkBack.
     """
 
     exclude_semantics: bool = False
@@ -208,7 +213,12 @@ class Semantics(Control):
 
     header: Optional[bool] = None
     """
-    Whether this subtree represents a header.
+    Whether this subtree represents a header, such as a page title or an app bar
+    title.
+
+    Note:
+        VoiceOver on iOS announces a node as a heading only when
+        :attr:`heading_level` is set.
     """
 
     image: Optional[bool] = None

{flet-1.0.3 → flet-1.1.0.dev0}/src/flet/controls/core/window.py

@@ -131,6 +131,12 @@ class Window(BaseControl):
     Tip:
         Can be used together with :attr:`flet.Page.bgcolor` to make
         a window transparent.
+
+    Limitation:
+        On Linux, a compositor must already be running when the app starts.
+        The window's visual is chosen once before the window is created and
+        cannot be swapped afterwards, so an app that starts before its
+        compositor stays opaque until it is restarted.
     """
 
     width: Optional[Number] = None
@@ -257,8 +263,13 @@ class Window(BaseControl):
 
     skip_task_bar: bool = False
     """
-    Whether the app window should be hidden from the Task Bar (on Windows) or Dock (on \
-    macOS).
+    Whether the app window should be hidden from the
+    Task Bar (on Windows) or Dock (on macOS).
+
+    Note:
+        On Windows 11, the window is also hidden from the Alt+Tab switcher, so a
+        window that is minimized while hidden can only be restored by the app itself.
+        Keep a way to bring it back, such as a tray icon.
     """
 
     title_bar_hidden: bool = False