Flet 0.26.0 release announcement (#374)

* add example for `Page.get_control()`

* remove deprecations

* document window.ignore_mouse_events

* Added /blog/flet-v-0-26-release-announcement

* Update 2025-01-17-flet-v-0-26-release-announcement.md

* Update 2025-01-17-flet-v-0-26-release-announcement.md

* Update 2025-01-17-flet-v-0-26-release-announcement.md

* update blog post - extensions

* Update 2025-01-17-flet-v-0-26-release-announcement.md

* Update 2025-01-17-flet-v-0-26-release-announcement.md

* updated blog

* extending flet

* user extensions

* Snackbar example updated

* Update built-in-extensions.md

* Update integrating-existing-flutter-packages.md

* updated user extension guide

* rename to user-extensions

* blog updated

* user-extensions, blog updated

* Update 2025-01-17-flet-v-0-26-release-announcement.md

* Prerequisites for all platforms updated

* update user-extensions

* Flet project structure updated

* Update user-extensions.md

* update user-extensions

* Renamed blog post file

* updated blog

* Update 2025-01-24-flet-v-0-26-release-announcement.md

* Update user-extensions.md

* updated built-in extensions

* fixed typo

* Python 3.8 removed/replaced

* Update 2025-01-24-flet-v-0-26-release-announcement.md

* Update user-extensions.md

* WSL notes in getting started updated

* Update user-extensions.md

* user extensions

* Update user-extensions.md

* update

* update

* getting started updated

* Added "uv" section to getting started

* updated blog

---------

Co-authored-by: ndonkoHenri <[email protected]>
Co-authored-by: InesaFitsner <[email protected]>

Author: 3 people

blog/2022-09-27-user-authentication.md

@@ -145,7 +145,7 @@ print(plain_text)
   * [`Image.gapless_playback`](/docs/controls/image#gapless_playback)
 * [`on_animation_end` callback](/docs/cookbook/animations#animation-end-callback) to chain animations.
 * [`Container.clip_behavior` property](/docs/controls/container#clip_behavior).
-* [`page.window_bgcolor`](/docs/controls/page#window_bgcolor) to make cool transparent app window:
+* [`page.window.bgcolor`](/docs/reference/types/window#bgcolor) to make cool transparent app window:
 
 ```python
 import flet as ft
@@ -166,7 +166,7 @@ ft.app(target=main)
     * `web_popup_window` - set to `True` to display a URL in a browser popup window. Default is `False`.
     * `window_width` - optional, popup window width.
     * `window_height` - optional, popup window height.
-* [`page.window_to_front()`](/docs/controls/page#window_to_front)
+* [`page.window.to_front()`](/docs/reference/types/window#to_front)
 * [`page.close_in_app_web_view()`](/docs/controls/page#close_in_app_web_view)
 
 

blog/2024-06-18-flet-v-0-23-release-announcement.md

@@ -108,7 +108,7 @@ solving the remaining ones.
   page.window.on_event = lambda e: print(e.type)
   ```
 
-* [`SafeArea.minimum`](/docs/controls/safearea#minimum) is deprecated and has been renamed
+* `SafeArea.minimum` is deprecated and has been renamed
   to [`minimum_padding`](/docs/controls/safearea#minimum_padding)
 * `MaterialState` enum is deprecated and has been renamed to [`ControlState`](/docs/reference/types/controlstate)
 * `NavigationDestination` is deprecated and has been renamed

blog/2025-01-24-flet-v-0-26-release-announcement.md

@@ -0,0 +1,144 @@
+---
+slug: flet-v-0-26-release-announcement
+title: Flet v0.26.0 Release Announcement
+author: Feodor Fitsner
+author_title: Flet founder and developer
+author_url: https://github.com/FeodorFitsner
+author_image_url: https://avatars0.githubusercontent.com/u/5041459?s=400&v=4
+tags: [releases]
+---
+
+The Flet 0.26.0 release is here, featuring a significant update to the extensibility approach!
+
+In summary, a Flet extension is now a single Python package that bundles both Python and Flutter code. This package can be part of your Flet project or hosted in a public Git repository or PyPI.
+
+Built-in Flet extensions, such as `Audio`, `Video`, and `Map`, have been moved to their own repositories. You’re welcome to fork these extensions to create your own or contribute to Flet! These extensions have been published to PyPI, making them easy to include in your Flet app. To use them, simply add the desired extensions to the `dependencies` section of your `pyproject.toml` file.
+
+For more details, see below.
+
+## How to upgrade
+
+Run the following command to upgrade Flet:
+
+```
+pip install 'flet[all]' --upgrade
+```
+
+:::note
+`[all]` is an "extra" specifier which tells pip to install or upgrade all `flet` packages: `flet`, `flet-cli`, `flet-desktop` and `flet-web`.
+:::
+
+Bump `flet` package version to `0.26.0` (or remove it at all to use the latest) in your `pyproject.toml`.
+
+## Extensibility changes
+
+### Built-in extensions
+
+Flet controls based on 3rd-party Flutter packages that used to be a part of Flet repository, now have been moved to separate repos and published on pypi:
+
+* [flet-ads](https://pypi.org/project/flet-ads/)
+* [flet-audio](https://pypi.org/project/flet-audio/)
+* [flet-audio-recorder](https://pypi.org/project/flet-audio-recorder/)
+* [flet-flashlight](https://pypi.org/project/flet-flashlight/)
+* [flet-geolocator](https://pypi.org/project/flet-geolocator/)
+* [flet-lottie](https://pypi.org/project/flet-lottie/)
+* [flet-map](https://pypi.org/project/flet-map/)
+* [flet-permission-handler](https://pypi.org/project/flet-permission-handler/)
+* [flet-rive](https://pypi.org/project/flet-rive/)
+* [flet-video](https://pypi.org/project/flet-video/)
+* [flet-webview](https://pypi.org/project/flet-webview/)
+
+To use a built-in Flet extension in your project, add it to the `dependencies` section of your `pyproject.toml` file, for example:
+
+```
+dependencies = [
+  "flet-audio",
+  "flet>=0.26.0",
+]
+```
+
+### User extensions
+
+Flet now makes it easy to create and build projects with your custom controls based on Flutter widgets or Flutter 3rd-party packages:
+
+1. Create new virtual enviroment and [install Flet](/docs/getting-started/#python-venv-module) there.
+
+2. Create new Flet extension project from template:
+
+```
+flet create --template extension --project-name my-control
+```
+
+A project with new MyControl control will be created. The control is just a Flutter Text widget with a single `text` property.
+
+3. Build your app.
+
+Flet project created from extension template has `examples/my_control_example` folder with the example app.
+
+When in the folder where your `pyproject.toml` for the app is, run `flet build` command, for example, for macOS:
+
+```
+flet build macos -v
+```
+
+Run the app and see the new custom Flet Control:
+
+```
+open build/macos/my-control-example.app
+```
+
+<img src="/img/blog/extensions/example.png" className="screenshot-30" />
+
+Read more about how to customise your extension [here](/docs/extend/user-extensions).
+
+## Development environment configuration
+
+To enhance the developer experience with the `flet build` command, Flet 0.26.0 ensures that the correct versions of Flutter SDK, Java (JDK), and Android SDK are installed. If any of these are missing or outdated, it automatically installs them for you.
+
+You still need to install Visual Studio 2022 yourself if you're building a Flet app for Windows, or Xcode if you're building for iOS or macOS.
+
+In the next releases we are going to introduce automatic configuration and startup of Android and iOS emulators.
+
+## Flutter 3.27
+
+Flet has been migrated to Flutter SDK 3.27. See [this pull request](https://github.com/flet-dev/flet/pull/4703) for new and updated control properties.
+
+## Python 3.9
+
+Flet 0.26.0 requires Python 3.9 or later. Python 3.8 has reached [EOL](https://devguide.python.org/versions/).
+
+## Other changes
+
+* Optional on-demand creation of `ListView.controls` ([#3931](https://github.com/flet-dev/flet/issues/3931))
+* Reset `InteractiveViewer` tranformations ([#4391](https://github.com/flet-dev/flet/issues/4391))
+* Passthrough of mouse events from main window to other applications ([#1438](https://github.com/flet-dev/flet/issues/1438))
+* Implemented `Window.ignore_mouse_events` ([#4465](https://github.com/flet-dev/flet/pull/4465))
+* Adding Google/Android TV platform support ([#4581](https://github.com/flet-dev/flet/pull/4581))
+* Remove `Optional[]` from predefined typing `*Value`s ([#4702](https://github.com/flet-dev/flet/pull/4702))
+* Throttle `InteractiveViewer` update events ([#4704](https://github.com/flet-dev/flet/pull/4704))
+* Remove v0.26.0-related deprecations ([#4456](https://github.com/flet-dev/flet/issues/4456))
+
+## Bug fixes
+
+* Fixed: Update project_dependencies.py ([#4459](https://github.com/flet-dev/flet/pull/4459))
+* Fixed: `SafeArea` object has no attribute `_SafeArea__minimum` ([#4500](https://github.com/flet-dev/flet/pull/4500))
+* Fixed: Tooltip corruption in `Segment` and `BarChartRod` on `update()` ([#4525](https://github.com/flet-dev/flet/pull/4525))
+* Fixed: Setting `CheckBox.border_side.stroke_align` to an Enum fails ([#4526](https://github.com/flet-dev/flet/pull/4526))
+* Fixed: `ControlState` should be resolved based on user-defined order ([#4556](https://github.com/flet-dev/flet/pull/4556))
+* Fixed: broken `Dismissible.dismiss_direction` ([#4557](https://github.com/flet-dev/flet/pull/4557))
+* Fixed: Fix Rive not updating ([#4582](https://github.com/flet-dev/flet/pull/4582))
+* Fixed: `DatePicker` regression with first and last dates ([#4661](https://github.com/flet-dev/flet/pull/4661))
+* `flet build` command: Copy `flutter-packages`, support for platform-specific dependencies ([#4667](https://github.com/flet-dev/flet/pull/4667))
+* Fixed: `CupertinoBottomSheet` applies a red color and yellow underline to `Text`  content ([#4673](https://github.com/flet-dev/flet/pull/4673))
+* Fixed: setting `ButtonTheme` displays a grey screen ([#4731](https://github.com/flet-dev/flet/pull/4731))
+* Fixed: `Textfield` input border color considers user-specified `border_color` property ([#4735](https://github.com/flet-dev/flet/pull/4735))
+* Fixed: make `Tooltip.message` a required parameter ([#4736](https://github.com/flet-dev/flet/pull/4736))
+
+## Conclusion
+
+Upgrade to Flet 0.26.0, test your apps and let us know how you find the new features we added.
+
+If you have any questions, please join [Flet Discord server](https://discord.gg/dzWXP8SHG8) or create a new thread
+on [Flet GitHub discussions](https://github.com/flet-dev/flet/discussions).
+
+Happy Flet-ing! 👾

docs/controls/banner.md

@@ -128,6 +128,12 @@ The amount of space surrounding the banner.
 
 The value is an instance of [`Margin`](/docs/reference/types/margin) class or a number.
 
+### `min_action_bar_height`
+
+The optional minimum action bar height.
+
+Defaults to `52`.
+
 ### `open`
 
 Set to `True` to display a banner.

docs/controls/bottomsheet.md

@@ -47,10 +47,22 @@ ft.app(main)
 
 ## Properties
 
+### `animation_style`
+
+The sheet's animation style.
+
+Value is of type [`AnimationStyle`](/docs/reference/types/animationstyle).
+
 ### `bgcolor`
 
 The sheet's background [color](/docs/reference/colors).
 
+### `clip_behavior`
+
+The sheet's clip behavior.
+
+Value is of type [`ClipBehavior`](/docs/reference/types/clipbehavior).
+
 ### `content`
 
 The content `Control` of the bottom sheet.
@@ -85,10 +97,22 @@ Set to `True` to display a bottom sheet.
 
 Defaults to `False`.
 
+### `shape`
+
+Defines the shape of the bottom sheet.
+
+Value is of type [`OutlinedBorder`](/docs/reference/types/outlinedborder).
+
 ### `show_drag_handle`
 
 Whether to display drag handle at the top of sheet or not.
 
+### `size_constraints`
+
+The size constraints to apply to the bottom sheet.
+
+Value is of type [`BoxConstraints`](/docs/reference/types/boxconstraints).
+
 ### `use_safe_area`
 
 Specifies whether the sheet will avoid system intrusions on the top, left, and right.

docs/controls/chip.md

@@ -114,7 +114,9 @@ True if the control will be selected as the initial focus. If there is more than
 
 ### `border_side`
 
-Defines the color and weight of the chip's outline. Value is the instance of [`BorderSide`](/docs/reference/types/borderside) class.
+Defines the color and weight of the chip's outline. 
+
+Value is of type [`BorderSide`](/docs/reference/types/borderside).
 
 ### `check_color`
 
@@ -134,8 +136,13 @@ Value is of type [`ClipBehavior`](/docs/reference/types/clipbehavior) and defaul
 
 ### `color`
 
-The [color](/docs/reference/colors) that fills the chip in various [`ControlState`](/docs/reference/types/controlstate)
-s.
+The [color](/docs/reference/colors) that fills the chip in various [`ControlState`](/docs/reference/types/controlstate)s.
+
+### `delete_drawer_animation_style`
+
+The animation style for the `delete_icon`'s animations.
+
+Value is of type [`AnimationStyle`](/docs/reference/types/animationstyle).
 
 ### `delete_icon_tooltip`
 
@@ -151,6 +158,13 @@ Defaults to an [`Icon(icons.CANCEL)`](/docs/controls/icon).
 
 [Color](/docs/reference/colors) of the `delete_icon`.
 
+### `delete_icon_size_constraints`
+
+The size constraints for the `delete_icon` control. 
+When unspecified, it defaults to a minimum size of chip height or label height (whichever is greater) and a padding of 8.0 pixels on all sides.
+
+Value is of type [`BoxConstraints`](/docs/reference/types/boxconstraints).
+
 ### `disabled_color`
 
 The [color](/docs/reference/colors) used for the chip's background if it is disabled.
@@ -161,6 +175,12 @@ A non-negative value which defines the size of the shadow below the chip.
 
 Defaults to `0`.
 
+### `enable_animation_style`
+
+The animation style for the enable and disable animations.
+
+Value is of type [`AnimationStyle`](/docs/reference/types/animationstyle).
+
 ### `label`
 
 A `Control` that represents primary content of the chip, typically a [`Text`](/docs/controls/text). Label is a required
@@ -186,6 +206,19 @@ A `Control` to display to the left of the chip's `label`.
 
 Typically the leading control is an [`Icon`](/docs/controls/icon) or a [`CircleAvatar`](/docs/controls/circleavatar).
 
+### `leading_drawer_animation_style`
+
+The animation style for the `leading` control's animations.
+
+Value is of type [`AnimationStyle`](/docs/reference/types/animationstyle).
+
+### `leading_size_constraints`
+
+The size constraints for the `leading` control. 
+When unspecified, it defaults to a minimum size of chip height or label height (whichever is greater) and a padding of 8.0 pixels on all sides.
+
+Value is of type [`BoxConstraints`](/docs/reference/types/boxconstraints).
+
 ### `padding`
 
 The padding between the `label` and the outside shape.
@@ -200,6 +233,12 @@ If `on_select` event is specified, `selected` property is used to determine whet
 
 Defaults to `False`.
 
+### `select_animation_style`
+
+The animation style for the select and unselect animations.
+
+Value is of type [`AnimationStyle`](/docs/reference/types/animationstyle).
+
 ### `selected_color`
 
 The [color](/docs/reference/colors) used for the chip's background when it is selected.

docs/controls/circleavatar.md

@@ -74,12 +74,6 @@ ft.app(main)
 
 The source (local asset file or URL) of the background image in the circle. Changing the background image will cause the avatar to animate to the new image. Typically used as a fallback image for `foreground_image_src`. If the CircleAvatar is to have the user's initials, use `content` instead.
 
-### ~~`background_image_url`~~
-
-The source (local asset file or URL) of the background image in the circle. Changing the background image will cause the avatar to animate to the new image. Typically used as a fallback image for `foreground_image_url`. If the CircleAvatar is to have the user's initials, use `content` instead.
-
-**Deprecated (renamed) in v0.22.0 and will be removed in v0.26.0. Use `background_image_src` instead.**
-
 ### `bgcolor`
 
 The [color](/docs/reference/colors) with which to fill the circle. Changing the background color will cause the avatar to animate to the new color.
@@ -96,12 +90,6 @@ Typically a `Text` control. If the CircleAvatar is to have an image, use `backgr
 
 The source (local asset file or URL) of the foreground image in the circle. Typically used as profile image. For fallback use `background_image_src`.
 
-### ~~`foreground_image_url`~~
-
-The source (local asset file or URL) of the foreground image in the circle. Typically used as profile image. For fallback use `background_image_url`.
-
-**Deprecated (renamed) in version 0.22.0 and will be removed in v0.26.0. Use `foreground_image_src` instead.**
-
 ### `max_radius`
 
 The maximum size of the avatar, expressed as the radius (half the diameter). If maxRadius is specified, then radius must not also be specified. Defaults to "infinity".

docs/controls/column.md

@@ -392,11 +392,21 @@ to `CrossAxisAlignment.START`.
 
 ### `on_scroll_interval`
 
-Throttling in milliseconds for `on_scroll` event. Default is `10`.
+Throttling in milliseconds for `on_scroll` event. 
+
+Defaults to `10`.
 
 ### `rtl`
 
-`True` to set text direction to right-to-left. Default is `False`.
+`True` to set text direction to right-to-left. 
+
+Defaults to `False`.
+
+### `run_alignment`
+
+How the runs should be placed in the cross-axis when `wrap=True`.
+
+Value is of type [`MainAxisAlignment`](/docs/reference/types/mainaxisalignment) and defaults to `MainAxisAlignment.START`.
 
 ### `run_spacing`
 
@@ -410,7 +420,10 @@ Value is of type [`ScrollMode`](/docs/reference/types/scrollmode) and defaults t
 
 ### `spacing`
 
-Spacing between controls in a Column. Default value is 10 virtual pixels. Spacing is applied only when `alignment` is set to `start`, `end` or `center`.
+Spacing between the `controls`. 
+It is applied only when `alignment` is set to `MainAxisAlignment.START`, `MainAxisAlignment.END` or `MainAxisAlignment.CENTER`.
+
+Default value is `10` virtual pixels. 
 
 ### `tight`
 

docs/controls/cupertinoalertdialog.md

@@ -117,7 +117,15 @@ If it is also `None`, then `Colors.BLACK_54` is used.
 
 ### `content`
 
-The (optional) content of the dialog is displayed in the center of the dialog in a lighter font. Typically this is a [`Column`](/docs/controls/column) that contains the dialog's [`Text`](/docs/controls/text) message.
+The (optional) content of the dialog is displayed in the center of the dialog in a lighter font. 
+
+Typically this is a [`Column`](/docs/controls/column) that contains the dialog's [`Text`](/docs/controls/text) message.
+
+### `inset_animation`
+
+The animation style to be used when the system keyboard intrudes into the space that the dialog is placed in.
+
+Value is of type [`AnimationStyle`](/docs/reference/types/animationstyle).
 
 ### `modal`