chore: v0.3.0 release preparation (#355)

- [x] versioned docs
- [x] release `maplibre_ios` to pub.dev
- [x] update changelog
- [x] update github action that publishes to pub.dev
- [x] remove path dependencies
- [x] prepare GitHub release
- [x] ~~enable package score action~~, requires specified version of
`maplibre_ios` on pub.dev

Author: josxha

.github/workflows/publish.yml

@@ -6,18 +6,17 @@ on:
       - 'v[0-9]+.[0-9]+.[0-9]+*'
 
 jobs:
-  publish:
-    name: 'Publish to pub.dev'
+  publish-maplibre-ios:
+    name: "Publish `maplibre_ios`"
     permissions:
-      id-token: write # This is required for requesting the OIDC
-    runs-on: ubuntu-latest
-    if: github.repository_owner == 'josxha'
-    steps:
-      - uses: actions/checkout@v5
-      - uses: dart-lang/setup-dart@v1
-        # --force skips the y/N confirmation
-        # --skip-validation because of "Because maplibre requires the Flutter SDK, version solving failed. Flutter users should use `flutter pub` instead of `dart pub`."
-        # see https://github.com/dart-lang/setup-dart/issues/68
-      - name: Publish to pub.dev
-        working-directory: ${{ inputs.working-directory }}
-        run: dart pub publish --force --skip-validation
+      id-token: write
+    uses: dart-lang/setup-dart/.github/workflows/publish.yml@v1
+    with:
+      working-directory: maplibre_ios
+  publish-maplibre:
+    name: "Publish `maplibre`"
+    permissions:
+      id-token: write
+    uses: dart-lang/setup-dart/.github/workflows/publish.yml@v1
+    with:
+      working-directory: .

.nvmrc

@@ -0,0 +1 @@
+22

.pubignore

@@ -1,4 +1,3 @@
 docs/
 example/assets/
-pigeons/
-maplibre_ios/
+pigeons/

CHANGELOG.md

@@ -1,14 +1,58 @@
-# next
+# 0.3.0
 
-- `MapController#setStyle` no longer returns a Future. To know when the map
-  style has loaded, listen to `MapLibreMap#onStyleLoaded`
+In this release, I'm blazed to finally announce support for iOS.
+Similar to our other platforms, iOS uses FFI to natively interop between Dart
+and Swift/ObjC. Checkout
+the [iOS documentation](https://flutter-maplibre.pages.dev/docs/getting-started/setup-ios)
+to get started.
+A big thanks to @mhernz, @gabbopalma and @jt274 that helped with their awesome
+contributions in this release!
+
+This release introduces breaking changes. Head over to
+the [migration guide](https://flutter-maplibre.pages.dev/docs/upgrade) to learn
+more on how to update your implementation.
+
+### New Features
+
+- **Breaking** Require Flutter 3.35
+- **Breaking** Migrate from `geotypes`
+  to [geobase](https://pub.dev/packages/geobase).
+- **Breaking** Return logical pixels in events on all platforms.
+- **Breaking** Add `screenPoint` parameter to `MapEventUserInput` events to show
+  the screen coordinates in logical pixels where the user interacted with the
+  map.
+- **Breaking** Rename `rotationDuration` in `MapCompass` to
+  `nativeRotationDuration`.
+- **Breaking** Multiple `MapController` functions are now called synchronously,
+  their `*Sync()` overloads have been removed.
+- **Breaking** All declarative layers now require a `FeatureCollection`. This
+  allows users to add properties to their layers.
+- Add iOS as supported platform with MapLibre Native iOS 6.18.
+- Update MapLibre Native Android to 11.13
+- Load map styles from Flutter assets, a JSON string or via URI.
+- Add `setStyle()`, to know when the map style has loaded, listen to
+  `onStyleLoaded()`.
+- Add support for PMTiles on the web.
+- Add `androidTranslucentTextureSurface` and `androidForegroundLoadColor` to use
+  a translucent map.
+- Add `MapScalebar.units` to support imperial units in the scalebar.
+- Add `featuresAtPoint()` and `featuresInRect()` to `MapController`.
+- Update to `pigeon` 26.0.0
+
+### Bug Fixes
+
+- Fix missing export of `BearingRenderMode`
+- Remove `dart:io` import to fix pub.dev WASM compatibility detection
+
+Full
+Changelog: [v0.2.2...v0.3.0](https://github.com/josxha/flutter-maplibre/compare/v0.2.2...v0.3.0)
 
 ## 0.2.2
 
-Maintenance release and some new functionality. 
+Maintenance release and some new functionality.
 Thanks for your contribution in this release @jt274!
 
-## New Features
+### New Features
 
 - Migrate `requestLocationPermissions()` and `addLayer()` to use JNI
 - Update `jni` and `jnigen` to v0.14

docs/.yarn/install-state.gz

@@ -10,16 +10,46 @@ for `maplibre`.
 ## Abstraction Layers
 
 ```mermaid
-flowchart TD
-    MapLibreMap -->|uses| MapLibreMapState
-    MapLibreMapState -->|extends| MapLibreMapStateNative
-    MapLibreMapStateNative -->|extends| MapLibreMapStateAndroid
-    MapLibreMapStateNative -->|extends| MapLibreMapStateIos
-    MapLibreMapState --->|extends| MapLibreMapStateWeb
-    MapController -->|implements| MapLibreMapState
-    MapLibreMapStateAndroid -->|method channel, jni| Kotlin([Kotlin])
-    MapLibreMapStateIos -->|method channel, ffi| Swift([Swift])
-    MapLibreMapStateWeb -->|interop| TypeScript([TypeScript])
+flowchart TB
+    subgraph User["User Implementation"]
+    end
+    subgraph Public["Public API"]
+        MapLibreMap
+        MapController
+        StyleController
+    end
+
+    subgraph Widget["StatefulWidget"]
+        MapLibreMapState
+    end
+
+    subgraph Pigeon["Platform Channels (Pigeon)"]
+        MapLibreMapStateNative
+    end
+
+    subgraph Interop["Native Interop (FFI / JNI)"]
+        MapLibreMapStateAndroid
+        MapLibreMapStateIos
+        MapLibreMapStateWeb
+    end
+
+    subgraph Native["Native Code"]
+       Android["Android (Kotlin, Java)"]
+       iOS["iOS (Swift, Objective C)"]
+       Web["Web (TypeScript)"]
+    end
+
+    User --> MapLibreMap
+    MapLibreMap --> MapLibreMapState
+    MapController --> MapLibreMapState
+    StyleController --> MapLibreMapState
+    MapLibreMapState --> MapLibreMapStateNative
+    MapLibreMapStateNative --> MapLibreMapStateAndroid
+    MapLibreMapStateNative --> MapLibreMapStateIos
+    MapLibreMapState --> MapLibreMapStateWeb
+    MapLibreMapStateAndroid --> Android
+    MapLibreMapStateIos --> iOS
+    MapLibreMapStateWeb --> Web
 ```
 
 ### 1. Public API

docs/docs/architecture.md

@@ -18,7 +18,7 @@ run `flutter pub get`:
 ```yaml title="pubspec.yaml"
 dependencies:
   # highlight-next-line
-  maplibre: ^0.2.0
+  maplibre: ^0.3.0
 ```
 
 Ensure that you use the documentation of the right

docs/docs/getting-started/add-dependency.md

@@ -7,11 +7,9 @@ sidebar_position: 20
 ## Use a compatible Kotlin version
 
 Ensure that you are using Kotlin version
-**1.9.0** or newer. You can check the most recent Kotlin version on
+**1.9.0 or newer**. You can check the most recent Kotlin version on
 [kotlinlang.org](https://kotlinlang.org/docs/releases.html#release-details).
 
-### (new) Gradle with a declarative plugins block
-
 Open `android/settings.gradle` and set the Kotlin version like this:
 
 ```gradle title="android/settings.gradle"
@@ -22,10 +20,11 @@ plugins {
 }
 ```
 
-In case you can't find the `plugins {}` block your app still uses the old apply
-script method.
 
-### (old) In a legacy apply script gradle file
+
+<details>
+<summary>In case you can't find the `plugins {}` block your app still uses the old apply
+script method. Click here to view the instructions.</summary>
 
 Open `android/app/build.gradle` and set the Kotlin version like this:
 
@@ -37,36 +36,7 @@ buildscript {
 }
 ```
 
-## Adjust the minSdk version of Android
-
-The `maplibre` package on Flutter
-uses [platform views](https://docs.flutter.dev/platform-integration/android/platform-views)
-to display the native map. This requires an Android SDK version of at least 23
-(Android 6.0).
-
-:::tip
-
-The app compiles with a minSdk version of down to 21. However, the MapLibre map
-won't be visible on these Android versions. You can check for the SDK version
-with [device_info_plus](https://pub.dev/packages/device_info_plus)
-and render an alternative map as a workaround or limit the supported Android
-versions to Android 6.0 and onwards like demonstrated here.
-
-:::
-
-Open your `android/app/build.gradle` file and ensure that it is set to 23 or
-higher.
-
-```gradle title="android/app/build.gradle"
-android {
-    defaultConfig {
-        // ...
-        // highlight-next-line
-        minSdk = 23 // previously flutter.minSdkVersion
-        // ...
-    }
-}
-```
+</details>
 
 ## Set the permissions
 
@@ -85,7 +55,3 @@ manifest`android/app/src/main/AndroidManifest.xml`.
     // highlight-end
 </manifest>
 ```
-
-Starting from Android API level 23 you also need to request it at runtime.
-You can use the `PermissionManager` for it (only available with version 0.1.2 or
-later).

docs/docs/getting-started/setup-android.md

@@ -6,9 +6,18 @@ sidebar_position: 30
 
 ## Activate the Swift Package Manager
 
-The Swift Package Manager is available in Flutter 3.35 in the `stable` 
-channel but needs to be enabled by running the following command:
+The Swift Package Manager is available in the `stable` channel since 
+Flutter 3.24 but needs to be enabled by running the following command:
 
 ```bash
 flutter config --enable-swift-package-manager
 ```
+
+You can also add it just for this project by adding the following line to the 
+pubspec.yaml file of your app:
+
+```yaml title="pubspec.yaml"
+flutter:
+  config:
+    enable-swift-package-manager: true
+```

docs/docs/getting-started/setup-ios.md

@@ -0,0 +1,77 @@
+---
+sidebar_position: 70
+---
+
+# Sources
+
+MapLibre can use a variety of different data sources for its style layers.
+You can use the same source for multiple style layers.
+
+## Data
+
+### GeoJSON
+
+You can use
+the [GeoJsonSource](https://pub.dev/documentation/maplibre/latest/maplibre/GeoJsonSource-class.html)
+to attach data like points, lines or polygons. The data can then be used in a
+[StyleCircleLayer](style-layers/circle-layer),
+[FillStyleLayer](style-layers/fill-layer),
+[HeatmapStyleLayer](style-layers/heatmap-layer),
+[LineStyleLayer](style-layers/line-layer) or
+[SymbolStyleLayer](style-layers/symbol-layer).
+
+An example use cases is to display and visualize any kind of data on the map.
+
+## Media
+
+### Image
+
+Use
+the [ImageSource](https://pub.dev/documentation/maplibre/latest/maplibre/ImageSource-class.html)
+If you want to render an image on the map.
+
+An example use case is to position a weather radar image on the map.
+
+### Video
+
+Likewise,
+the [VideoSource](https://pub.dev/documentation/maplibre/latest/maplibre/VideoSource-class.html)
+can be used to render a video on the map.
+
+The video source is only supported on web.
+
+## Tiles
+
+The most common way to use a tile source is by an URL. This can either be
+
+- the direct URL of a tile server, e.g. `https://example.com/{z}/{x}/{y}.mvt`
+- the URL of a [TileJSON](https://github.com/mapbox/tilejson-spec) that provides
+  a tile server with additional metadata, e.g. `https://example.com/tiles.json`
+- a PMTiles file by adding `pmtiles://` in front of your url, e.g.
+  `pmtiles://https://example.com/tiles.pmtiles` or
+  `pmtiles://files://path/tiles.pmtiles`
+
+### Raster Tiles
+
+The [RasterSource](https://pub.dev/documentation/maplibre/latest/maplibre/RasterSource-class.html)
+can be used to add a raster tile server. Raster tiles are images that are
+positioned in a grid next to each other on the map. They are hosted on a tile
+server that follows the format `z/x/y.png` or any other image file extension.
+
+A common use case is to display a satellite map using
+a [RasterStyleLayer](style-layers/raster-layer).
+
+### Raster DEM Tiles
+
+Raster DEM tiles are similar to regular [raster tiles](#raster-tiles) but are
+used in the [HillshadeStyleLayer](style-layers/hillshade-layer) to display
+elevation. Use
+the [RasterDemSource](https://pub.dev/documentation/maplibre/latest/maplibre/RasterDemSource-class.html)
+for it.
+
+### Vector Tiles
+
+Last but not least you can use
+the [VectorSource](https://pub.dev/documentation/maplibre/latest/maplibre/VectorSource-class.html)
+to supply the map with a source of Mapbox Vector Tiles (MVT). The data is then
+shown in a combination of circle, fill, line and symbol layers on the map.