chore: prepare for v8 release (#2021)

.github/ISSUE_TEMPLATE/bug-report.yaml

@@ -1,37 +1,35 @@
 name: Bug Report
-description: Create a bug report to help us improve
-title: "[BUG] <title>"
-labels: ["bug", "needs triage"]
+description: Let us know about something that isn't working
+labels: ["needs triage"]
+type: Bug
 body:
   - type: markdown
     attributes:
       value: "
         # Bug Report
 
         Thanks for taking the time to fill out this bug report! To help us verify the issue quicker, please include as much information as you can.
-        
-        
+
+
         ---
-        
-        
+
+
         Before reporting a bug, please:
 
         * Check if there is already an open or closed issue that is similar to yours
-        
-        * Ensure that you have fully read the documentation (both the website and API docs) that pertains to the function you're having problems with
 
-        * Ensure that your Flutter environment is correctly installed & set-up
+        * Ensure that you have fully read the documentation (both the website and API docs) that relates to the feature(s) you're having problems with
 
         * Remember that we're volunteers trying our best to help, so please be polite
-        
-        
+
+
         ---
         "
   - type: textarea
     id: details
     attributes:
       label: What is the bug?
-      description: What were you implementing when you found this issue? What happens when the bug triggers? What do you think should have happened instead? Please include as much detail as possible, including screenshots and screen-recordings if you can.
+      description: What were you implementing when you found this issue? What happens when the bug triggers? What do you think should have happened instead? Does it only occur on a specific platform? Please include as much detail as possible, including screenshots and screen-recordings if you can.
     validations:
       required: true
   - type: textarea
@@ -47,27 +45,4 @@ body:
     id: solution
     attributes:
       label: Do you have a potential solution?
-      description: "If so, please detail it: it will make it quicker for us to fix the issue."
-  - type: markdown
-    attributes:
-      value: ---
-  - type: input
-    id: platform
-    attributes:
-      label: Platforms
-      description: Please detail the devices and operating systems you can reproduce this bug on, separated by commas.
-      placeholder: eg. Android 13 (Samsung Galaxy S99), Windows 11 (x64)
-    validations:
-      required: true
-  - type: dropdown
-    id: severity
-    attributes:
-      label: Severity
-      description: How much of a problem is this issue, when it does occur?
-      options:
-        - "Minimum: Allows normal functioning"
-        - "Obtrusive: Prevents normal functioning but causes no errors in the console"
-        - "Erroneous: Prevents normal functioning and causes errors in the console"
-        - "Fatal: Causes the application to crash"
-    validations:
-      required: true
+      description: "If so, please detail it: it will make it quicker for us to fix the issue. We also hugely appriciate PRs!"

.github/ISSUE_TEMPLATE/config.yml

@@ -1,11 +1,11 @@
 blank_issues_enabled: false
 contact_links:
-  - name: Get Help
+  - name: Get help
     url: https://discord.gg/BwpEsjqMAH
     about: Don't quite understand how to implement something, or just want to talk? Join the Discord server!
-  - name: Frequently Asked Questions
-    url: https://docs.fleaflet.dev/frequently-asked-questions
+  - name: Check the FAQs
+    url: https://docs.fleaflet.dev/#faqs
     about: Before posting an issue or asking for help, please check whether your question has already been answered!
-  - name: Documentation
+  - name: Read the documentation
     url: https://docs.fleaflet.dev/
     about: Before posting an issue or asking for help, please ensure you read the documentation thoroughly

.github/ISSUE_TEMPLATE/feature-request.yaml

@@ -1,29 +1,29 @@
 name: Feature Request
 description: Suggest functionality that you'd like to see
-title: "[FEATURE] <title>"
-labels: ["feature", "P3 (low)"]
+labels: ["P3 (low)"]
+type: Feature
 body:
   - type: markdown
     attributes:
       value: "
         # Feature Request
 
-        Thanks for taking the time to let us know what you want to see!  
+        Thanks for taking the time to let us know what you want to see in flutter_map!
         Unfortunately, response times for feature requests are longer than bug reports, as they are lower priority. If you want this functionality implemented quickly, please make a Pull Request to go alongside this feature request.
-        
-        
+
+
         ---
-        
-        
+
+
         Before requesting a feature, please:
 
         * Check if there is already an open or closed issue that is similar to yours
-        
+
         * Ensure that you're using the latest version of flutter_map
-        
+
         * Ensure that you've read the documentation (both the website and API docs) thoroughly
-        
-        
+
+
         ---
         "
   - type: textarea
@@ -46,14 +46,3 @@ body:
     attributes:
       label: Can you provide any other information?
       description: Is there anything else you'd like to say?
-  - type: dropdown
-    id: severity
-    attributes:
-      label: Severity
-      description: How much of a problem is the lack of functionality for you?
-      options:
-        - "Minimum: Not required for my use"
-        - "Annoying: Currently have to use workarounds"
-        - "Obtrusive: No workarounds are available, and this is essential to me"
-    validations:
-      required: true

.gitignore

@@ -30,7 +30,6 @@
 .pub-cache/
 .pub/
 build/
-# TODO: document why we don't want this file
 pubspec.lock
 
 # Android related
@@ -41,6 +40,7 @@ pubspec.lock
 **/android/gradlew.bat
 **/android/local.properties
 **/android/**/GeneratedPluginRegistrant.java
+**/android/app/.cxx
 
 # iOS/XCode related
 **/ios/**/*.mode1v3

CHANGELOG.md

@@ -2,21 +2,44 @@
 
 Please consider [donating](https://docs.fleaflet.dev/supporters#support-us) or [contributing](https://docs.fleaflet.dev/credits#contributing) if you're a fan of what we're doing and you'd like to support future releases!
 
-This CHANGELOG does not include every commit and/or PR - it is a hand picked selection of the most important ones. For a full list of changes, please check the GitHub repository releases/tags.
+This CHANGELOG does not include every commit and/or PR - it is a hand picked selection of the ones that have an effect on you. For a full list of changes, please check the GitHub repository releases/tags.
 
-## [8.0.0] - 2024/07/02
+## [8.0.0] - 2025/XX/XX
 
-Migration from `Point` class internally, but this also affects the external API.
+**"Infinite Worlds**
 
-Migration Guide:
-- any methods that previously required `Point<double>` now require `Offset`, `Size`, or `Rect` as return values and parameters
-- `pointToLatLng` -> `offsetToLatLng`
-- `PointExtension` and `OffsetToPointExtension` marked as internal
-- `MapController.rotateAroundPoint` now only accepts an Offset
+Contains the following user-affecting changes:
 
+- 🟢 Added unbounded horizontal scroll (with the default projection) and support for layers to cross anti-meridian - [#1948 (💰)](https://github.com/fleaflet/flutter_map/pull/1948), [#1969](https://github.com/fleaflet/flutter_map/pull/1969), [#1978](https://github.com/fleaflet/flutter_map/pull/1978), [#2000](https://github.com/fleaflet/flutter_map/pull/2000), [#2018](https://github.com/fleaflet/flutter_map/pull/2018), [#2025](https://github.com/fleaflet/flutter_map/pull/2025) for [#1582](https://github.com/fleaflet/flutter_map/issues/1582)
+- 🟢 Added animated keyboard controls for gestures - [#1987](https://github.com/fleaflet/flutter_map/pull/1987)
+- 🟢 Added `filterQuality` parameter to `(Base)OverlayImage` - [#1989](https://github.com/fleaflet/flutter_map/pull/1989)
+- 🟢 Exposed `BaseOverlayImage` for external implementation/extension - [#1990](https://github.com/fleaflet/flutter_map/pull/1990)
+- 🟡 Changed the majority of references to `Point` to `Offset`, and method names accordingly - [#1996](https://github.com/fleaflet/flutter_map/pull/1996)
+- 🟡 Added integer `tileDimension` & deprecated `TileLayer.tileSize` - [#1940](https://github.com/fleaflet/flutter_map/pull/1940)
 
 Contains the following user-affecting bug fixes:
 
+- Fixed polygon hit detection when map rotated - [#1942](https://github.com/fleaflet/flutter_map/pull/1942) for [#1934](https://github.com/fleaflet/flutter_map/issues/1934)
+- Fixed polygon hit detection when polygon invalid - [#1964](https://github.com/fleaflet/flutter_map/pull/1964) for [#1933](https://github.com/fleaflet/flutter_map/issues/1933)
+- Eagerly listen to `TileLayer.reset` stream internally to ensure handler is fired - [#1943](https://github.com/fleaflet/flutter_map/pull/1943) for [#1808](https://github.com/fleaflet/flutter_map/issues/1808)
+- Fixed some tile loading/pruning state issues - [#2007](https://github.com/fleaflet/flutter_map/pull/2007) for partially [#1837](https://github.com/fleaflet/flutter_map/issues/1837)
+- Use `Client` instead of `BaseClient` in network tile/image provider - [#2011](https://github.com/fleaflet/flutter_map/pull/2011) for [#2010](https://github.com/fleaflet/flutter_map/issues/2010)
+- Avoid closing externally created `http.Client` in `NetworkTileProvider` - [#2012](https://github.com/fleaflet/flutter_map/pull/2012) for [#2009](https://github.com/fleaflet/flutter_map/issues/2009)
+
+Contains the following user-affecting performance improvements:
+
+- Fixed performance-related bug where `Polyline.renderHashCode` included `hashCode` unnecessarily causing internal draw batching to fail - [#1967](https://github.com/fleaflet/flutter_map/pull/1967)
+- Fixed massive performance-related bug where the simplification cache for the `Polyline/gonLayer`s was incorrectly used - [#1991](https://github.com/fleaflet/flutter_map/pull/1991)
+- Perform bounding-box culling prior to aggressive culling for `Polyline`s - [#1993](https://github.com/fleaflet/flutter_map/pull/1993)
+
+Many thanks to these contributors (in no particular order):
+
+- @monsieurtanuki
+- @alestiago
+- @RBT22
+- @TechnicJelle
+- @slightfoot
+- ... and all the maintainers
 
 ## [7.0.2] - 2024/07/02
 
@@ -90,7 +113,7 @@ Many thanks to these contributors (in no particular order):
 ## [6.2.1] - 2024/05/27
 
 > If possible, prefer to update directly to v7. This version is provided only to enable Flutter 3.22 compatibility without requiring a breaking change.
-
+>
 > v6.2.0 was retracted from pub.dev due to a mistake in the release preparation. For more information, see [this comment](https://github.com/fleaflet/flutter_map/pull/1891#issuecomment-2134069848). v6.2.1 is the replacement without the issues.
 
 Contains the following user-affecting changes:

analysis_options.yaml

@@ -17,7 +17,6 @@ linter:
     cancel_subscriptions: true
     close_sinks: true
     directives_ordering: true
-    package_api_docs: true
     prefer_constructors_over_static_methods: true
     prefer_final_in_for_each: true
     prefer_final_locals: true

example/.metadata

@@ -4,7 +4,7 @@
 # This file should be version controlled and should not be manually edited.
 
 version:
-  revision: "7c6b7e9ca485f7eaaed913c6bb50f4be6da47e30"
+  revision: "53c27e519d33b4e13b01a8710b38a3591d6ca6f1"
   channel: "beta"
 
 project_type: app
@@ -13,11 +13,11 @@ project_type: app
 migration:
   platforms:
     - platform: root
-      create_revision: 7c6b7e9ca485f7eaaed913c6bb50f4be6da47e30
-      base_revision: 7c6b7e9ca485f7eaaed913c6bb50f4be6da47e30
-    - platform: web
-      create_revision: 7c6b7e9ca485f7eaaed913c6bb50f4be6da47e30
-      base_revision: 7c6b7e9ca485f7eaaed913c6bb50f4be6da47e30
+      create_revision: 53c27e519d33b4e13b01a8710b38a3591d6ca6f1
+      base_revision: 53c27e519d33b4e13b01a8710b38a3591d6ca6f1
+    - platform: windows
+      create_revision: 53c27e519d33b4e13b01a8710b38a3591d6ca6f1
+      base_revision: 53c27e519d33b4e13b01a8710b38a3591d6ca6f1
 
   # User provided section
 

example/README.md

@@ -1,4 +1,4 @@
-# Example Application For '[flutter_map](https://github.com/fleaflet/flutter_map)'
+# Demo app for '[flutter_map](https://github.com/fleaflet/flutter_map)'
 
 Showcases functionality of the library in a neat and useful format that can be used for further API references, and just to see if you want this library for your app.
 

example/android/app/build.gradle → example/android/app/build.gradle.kts

@@ -1,8 +1,8 @@
 plugins {
-    id "com.android.application"
-    id "kotlin-android"
+    id("com.android.application")
+    id("kotlin-android")
     // The Flutter Gradle Plugin must be applied after the Android and Kotlin Gradle plugins.
-    id "dev.flutter.flutter-gradle-plugin"
+    id("dev.flutter.flutter-gradle-plugin")
 }
 
 android {
@@ -17,7 +17,7 @@ android {
     }
 
     kotlinOptions {
-        jvmTarget = JavaVersion.VERSION_1_8
+        jvmTarget = JavaVersion.VERSION_1_8.toString()
     }
 
     defaultConfig {
@@ -30,7 +30,7 @@ android {
 
     buildTypes {
         release {
-            signingConfig = signingConfigs.debug
+            signingConfig = signingConfigs.getByName("debug")
         }
     }
 }

example/android/build.gradle.kts

@@ -0,0 +1,21 @@
+allprojects {
+    repositories {
+        google()
+        mavenCentral()
+    }
+}
+
+val newBuildDir: Directory = rootProject.layout.buildDirectory.dir("../../build").get()
+rootProject.layout.buildDirectory.value(newBuildDir)
+
+subprojects {
+    val newSubprojectBuildDir: Directory = newBuildDir.dir(project.name)
+    project.layout.buildDirectory.value(newSubprojectBuildDir)
+}
+subprojects {
+    project.evaluationDependsOn(":app")
+}
+
+tasks.register<Delete>("clean") {
+    delete(rootProject.layout.buildDirectory)
+}

example/android/gradle.properties

@@ -1,3 +1,3 @@
-org.gradle.jvmargs=-Xmx4G -XX:MaxMetaspaceSize=2G -XX:+HeapDumpOnOutOfMemoryError
+org.gradle.jvmargs=-Xmx8G -XX:MaxMetaspaceSize=4G -XX:ReservedCodeCacheSize=512m -XX:+HeapDumpOnOutOfMemoryError
 android.useAndroidX=true
 android.enableJetifier=true

example/android/gradle/wrapper/gradle-wrapper.properties

@@ -2,4 +2,4 @@ distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-8.9-all.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.10.2-all.zip