v1: Migrate Flet extensions to a main repo (#5690)

* Update links and metadata for flet-ads package

Corrected URLs in README, pyproject.toml, and pubspec.yaml to point to the main flet repository and documentation. Removed outdated repository and issue tracker fields from pubspec.yaml for consistency.

* Add flet-audio extension package and docs

Introduces the flet-audio extension for audio playback in Flet apps, including Python and Flutter source code, documentation, and example usage. Updates dependency configuration to use the local flet-audio package and integrates audio control documentation into the Flet docs and mkdocs navigation.

* Add flet-audio-recorder package and example

Introduces the flet-audio-recorder Python and Flutter package, including source code, documentation, and licensing. Updates client dependencies to use the local path for flet_audio_recorder. Adds an example usage in Python and documentation for new types and configuration options.

* Add flet-charts package and chart examples

Introduces the new flet-charts package with Python and Flutter implementations, including source code, documentation, and assets. Adds multiple chart examples (bar, line, pie, scatter, matplotlib, plotly) with sample code and media files, and updates client dependencies to use the local flet-charts path instead of a git reference.

* Add example image to scatter chart documentation

Introduced example_1.png and updated scatter_chart.md to display the image, enhancing the documentation with a visual example of the scatter chart.

* Add flet-video package and update video dependencies

Introduced the new flet-video package with Python and Flutter source, documentation, and example usage. Updated client and Python package dependencies to use the local flet-video path instead of the git source.

* Fix Video example

* Add flet-lottie package and update dependencies

Introduced the flet-lottie package with initial source, documentation, and assets. Updated client and SDK dependencies to use the local path for flet-lottie instead of the git repository. Added Lottie example and sample asset, and made minor updates to other package configurations.

* Add flet-map package and example integration

Introduced the flet-map Python package with interactive map controls, including layers for markers, circles, polygons, polylines, and attribution. Updated client dependencies to use local flet-map path. Added a comprehensive example demonstrating map usage and updated documentation and licensing files for the new package.

* Add flet-rive extension for Rive animation support

Introduces the flet-rive extension to enable Rive animation rendering in Flet apps. Adds Python and Flutter package files, example usage, documentation, and updates dependency references to include flet-rive in the project.

* Add flet-permission-handler extension and docs

Introduced the flet-permission-handler extension for managing runtime permissions in Flet apps, including Python and Flutter source, documentation, and example usage. Updated workspace configuration and dependencies to include the new extension, switched client dependency from git to local path, and added documentation references and navigation. Also removed unused README and CHANGELOG files from flet-charts and flet-video.

* Add flet-geolocator package and example

Introduced the flet-geolocator Python package with initial implementation, documentation, and licensing. Updated client dependencies to use local path for flet-geolocator and flet-permission-handler. Added example usage and integrated geolocator documentation into the Flet docs.

* Refactor text style and value handling in DropdownM2

Improves text style logic by separating font size, color, and focused color handling for clarity and correctness. Replaces 'value' with 'initialValue' in DropdownButtonFormField to match updated API usage.

* Add flet-datatable2, flet-flashlight, flet-webview packages

Added new Python packages for flet-datatable2, flet-flashlight, and flet-webview, including their Flutter implementations, documentation, and example usage. Updated client dependencies to use local paths for these packages instead of git sources. Also added example code for datatable2, flashlight, and webview controls, and updated dropdown_m2 example for improved usage.

* Add CI workflow for building Flet extension packages

Introduces a new GitHub Actions job to build and analyze multiple Flet extension Python packages. Updates the publish step to include these extensions, ensuring they are built and published alongside core packages.

* Remove pubspec.lock after Flutter analysis

Adds a step to delete pubspec.lock after running 'dart analyze' in the CI workflow. This helps ensure a clean state for subsequent steps and avoids potential issues with stale lock files.

* Add manual notify method to Observable and task status callback

Introduces a notify() method to Observable for manual listener notification. TaskItem now supports an on_status_changed callback, allowing TodoAppState to trigger UI updates when a task's status changes.

* Improve alt text generation in image macro

The image macro now generates alt text from the image filename if no alt is provided, using urlparse and os.path.basename. This enhances accessibility and provides more descriptive default alt text for images.

* Update CI workflow and README build badge

Added Python 3.14 to the CI test matrix for broader version support. Updated the README to use the GitHub Actions build status badge instead of AppVeyor.

* Expand supported Python versions to <3.15

Updated 'requires-python' in pyproject.toml files to allow Python versions up to 3.14, expanding compatibility for both the main SDK and examples.

* Update Flutter version and dependencies

Bump Flutter to 3.35.5 and update various Dart/Flutter package dependencies across multiple pubspec files for compatibility and latest features. Refactor code in bar_chart.dart for improved readability and update usage of tile providers in flet_map. Remove unused dependencies and ensure all packages use consistent versioning.

* Make chart axis properties optional in chart classes

Changed axis properties (left, top, right, bottom) in BarChart, LineChart, and ScatterChart to be Optional and default to None instead of instantiating ChartAxis by default. Also updated SectionBadge icon type in pie chart example for consistency. This allows for more flexible chart configuration and avoids unnecessary default axis creation.

* Add CandlestickChart control and documentation

Introduces the CandlestickChart control to flet-charts, including Python and Flutter implementations, example usage, and documentation. Updates README, CHANGELOG, and mkdocs navigation to reflect the new chart type and its related event and tooltip types.

* Remove timeout parameters from service methods

Eliminated the 'timeout' argument from async service methods in audio, geolocator, browser context menu, and clipboard modules for API simplification. Also deleted outdated documentation files for geolocator and permission handler.

* Add and improve docstrings for map and video modules

Added detailed docstrings to polygon_layer.py, polyline_layer.py, __init__.py, types.py, and video.py to clarify configuration options and public exports. Expanded attribute documentation in VideoSubtitleTrack for better developer understanding of media metadata fields.

Author: FeodorFitsner

.fvmrc

@@ -1,3 +1,3 @@
 {
-  "flutter": "3.35.1"
+  "flutter": "3.35.5"
 }

.github/workflows/ci.yml

@@ -48,7 +48,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: [ "3.10", "3.11", "3.12", "3.13" ]
+        python-version: [ "3.10", "3.11", "3.12", "3.13", "3.14" ]
     steps:
       - name: Checkout repository
         uses: actions/checkout@v4
@@ -547,6 +547,90 @@ jobs:
             sdk/python/dist/*.whl
             sdk/python/dist/*.tar.gz
 
+  # ============================================
+  # Build Flet extension Python packages
+  # ============================================
+  build_flet_extensions:
+    name: Build ${{ matrix.package }} extension
+    runs-on: ubuntu-latest
+    needs:
+      - python_tests
+      - build_flet_package
+    env:
+      PYPI_VER: ${{ needs.build_flet_package.outputs.PYPI_VER }}
+    strategy:
+      fail-fast: false
+      matrix:
+        package:
+          - flet-ads
+          - flet-audio
+          - flet-audio-recorder
+          - flet-charts
+          - flet-datatable2
+          - flet-flashlight
+          - flet-geolocator
+          - flet-lottie
+          - flet-map
+          - flet-permission-handler
+          - flet-rive
+          - flet-video
+          - flet-webview
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup uv
+        uses: astral-sh/setup-uv@v6
+
+      - name: Setup Flutter
+        uses: kuhnroyal/flutter-fvm-config-action/setup@v3
+        with:
+          path: '.fvmrc'
+          cache: true
+
+      - name: Analyze Flutter package with dart analyze
+        shell: bash
+        run: |
+          set -euo pipefail
+          PACKAGE="${{ matrix.package }}"
+          FLUTTER_PACKAGE="${PACKAGE//-/_}"
+          FLUTTER_DIR="${SDK_PYTHON}/packages/${PACKAGE}/src/flutter/${FLUTTER_PACKAGE}"
+
+          if [[ ! -d "$FLUTTER_DIR" ]]; then
+            echo "Flutter directory $FLUTTER_DIR not found"
+            exit 1
+          fi
+
+          pushd "$FLUTTER_DIR"
+          flutter pub get
+          dart analyze
+          rm -f pubspec.lock
+          popd
+
+      - name: Build Python package
+        shell: bash
+        working-directory: ${{ env.SDK_PYTHON }}
+        run: |
+          set -euo pipefail
+          PACKAGE="${{ matrix.package }}"
+          PYPROJECT="packages/${PACKAGE}/pyproject.toml"
+
+          source "$SCRIPTS/common.sh"
+          patch_toml_versions "$PYPROJECT" "$PYPI_VER"
+
+          rm -rf dist
+          uv build --package "$PACKAGE" --wheel
+          uv build --package "$PACKAGE" --sdist
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: python-extension-${{ matrix.package }}
+          if-no-files-found: error
+          path: |
+            sdk/python/dist/*.whl
+            sdk/python/dist/*.tar.gz
+
   # =====================================
   # Build flet, flet-cli and flet-desktop
   # =====================================
@@ -598,6 +682,7 @@ jobs:
       - build_macos
       - build_linux
       - build_web
+      - build_flet_extensions
     steps:
       - name: Setup uv
         uses: astral-sh/setup-uv@v6
@@ -613,7 +698,25 @@ jobs:
           # remove client to avoid glob conflicts with its contents
           rm -rf dist/client
 
-          for pkg in flet flet_cli flet_desktop flet_desktop_light flet_web; do
+          for pkg in \
+            flet \
+            flet_cli \
+            flet_desktop \
+            flet_desktop_light \
+            flet_web \
+            flet_ads \
+            flet_audio \
+            flet_audio_recorder \
+            flet_charts \
+            flet_datatable2 \
+            flet_flashlight \
+            flet_geolocator \
+            flet_lottie \
+            flet_map \
+            flet_permission_handler \
+            flet_rive \
+            flet_video \
+            flet_webview; do
             uv publish dist/**/${pkg}-*
           done
 

README.md

@@ -19,8 +19,8 @@
 <a href="https://pypi.org/project/flet" target="_blank">
     <img src="https://img.shields.io/pypi/pyversions/flet.svg?color=%2334D058" alt="Supported Python versions">
 </a>
-<a href="https://ci.appveyor.com/project/flet-dev/flet/branch/main" target="_blank">
-    <img src="https://ci.appveyor.com/api/projects/status/xwablctxslvey576/branch/main?svg=true" alt="Build status">
+<a href="https://github.com/flet-dev/flet/actions/workflows/ci.yml" target="_blank">
+    <img src="https://github.com/flet-dev/flet/actions/workflows/ci.yml/badge.svg" alt="Build status">
 </a>
 </p>
 
@@ -51,7 +51,7 @@ with assets hosting and desktop clients.
 
 Flet UI is built with [Flutter](https://flutter.dev/), so your app looks professional and could be delivered to any platform.
 Flet simplifies the Flutter model by combining smaller "widgets" to ready-to-use "controls"
-with an imperative programming model. 
+with an imperative programming model.
 
 ### 📱 Deliver to any device or platform