Release 1.4.0

.claude/settings.json

@@ -0,0 +1,6 @@
+{
+  "attribution": {
+    "commit": "",
+    "pr": ""
+  }
+}

.github/workflows/build.yml

@@ -38,8 +38,29 @@ jobs:
           cache: 'gradle'
 
       - name: Build core and compose locally
+        env:
+          HEAD_REF: ${{ github.head_ref }}
         run: |
-          git clone --depth 1 https://github.com/MapConductor/android-sdk-core.git _core
+          # コア側に PR と同名のブランチがあるなら、そちらを組む。
+          #
+          # ここを default ブランチ固定にしていると、**コアの未マージな変更に追随する
+          # PR は永久に赤いまま**になる。実際 CameraBearing をコアへ足したとき、
+          # プロバイダ側の PR が 10 本まとめて Unresolved reference で落ちた。
+          # コアが先にマージされるまで待つ、という運用は取り込み順の事故を呼ぶので、
+          # 同名ブランチがあれば拾う形にしてある（無ければ従来どおり default）。
+          clone_matching() {
+            repo="$1"; dir="$2"
+            url="https://github.com/MapConductor/$repo.git"
+            if [ -n "$HEAD_REF" ] && git ls-remote --exit-code --heads "$url" "$HEAD_REF" >/dev/null 2>&1; then
+              echo "$repo: matching branch $HEAD_REF"
+              git clone --depth 1 --branch "$HEAD_REF" "$url" "$dir"
+            else
+              echo "$repo: default branch"
+              git clone --depth 1 "$url" "$dir"
+            fi
+          }
+
+          clone_matching android-sdk-core _core
           cd _core
           ./gradlew --no-daemon publishToMavenLocal
           cd ..
@@ -53,7 +74,7 @@ jobs:
           }
           EOF
 
-          git clone --depth 1 https://github.com/MapConductor/android-sdk-compose.git _compose
+          clone_matching android-sdk-compose _compose
           cd _compose
           ./gradlew --no-daemon publishToMavenLocal
           cd ..

build.gradle.kts

@@ -93,6 +93,12 @@ dependencies {
     testImplementation(libs.junit)
     androidTestImplementation(libs.androidx.junit)
     androidTestImplementation(libs.androidx.espresso.core)
+    // A real MapView loading real (local) styles: what a design change does to
+    // the overlays only shows on a map that actually swaps its style.
+    androidTestImplementation(libs.androidx.runner)
+    androidTestImplementation(platform(libs.androidx.compose.bom))
+    androidTestImplementation(libs.androidx.ui.test.junit4)
+    debugImplementation(libs.androidx.ui.test.manifest)
 }
 
 // Set project version for NMCP plugin

docs/polygon/MapboxPolygonCompositeRenderer.kt.md

@@ -0,0 +1,37 @@
+# MapboxPolygonCompositeRenderer
+
+## Signature
+
+```kotlin
+class MapboxPolygonCompositeRenderer(
+    val fill: MapboxPolygonOverlayRenderer,
+    val outline: MapboxPolylineOverlayRenderer,
+) : PolygonOverlayRendererInterface<MapboxActualPolygon>
+```
+
+## Description
+
+Presents the fill renderer and the outline renderer to the core `PolygonController` as a single
+renderer.
+
+A Mapbox fill layer can only draw a 1 px outline with no width, so to honour `strokeWidth` each
+polygon's outer ring is also drawn as a closed polyline with the id `outline-<polygon id>` through
+`outline`. Every call the controller makes on this renderer is forwarded to `fill` and mirrored on
+`outline`:
+
+- `onAdd` / `onChange`: the fill is created or rebuilt; when that succeeds, the outline polyline is
+  (re)created with the polygon's `strokeColor`, `strokeWidth`, `geodesic`, `zIndex` and `extra`.
+- `onRemove`: the outline polylines are dropped and both sources are redrawn without the removed
+  polygons (the controller's `clear()` does not call `onPostProcess`).
+- `onPostProcess`: both sources are redrawn.
+
+Holes are not outlined.
+
+## Constructor Parameters
+
+- `fill`
+    - Type: `MapboxPolygonOverlayRenderer`
+    - Description: Draws the polygon fill (with holes) into the fill source.
+- `outline`
+    - Type: `MapboxPolylineOverlayRenderer`
+    - Description: Draws the outlines into the polygon outline source.

docs/polygon/MapboxPolygonController.kt.md

@@ -0,0 +1,30 @@
+# MapboxPolygonController
+
+## Signature
+
+```kotlin
+class MapboxPolygonController(
+    override val renderer: MapboxPolygonCompositeRenderer,
+) : PolygonController<MapboxActualPolygon>(renderer.fill.polygonManager, renderer)
+```
+
+## Description
+
+The polygon controller of the Mapbox provider. It extends the core `PolygonController`, so diffing
+(add / change / remove), `has`, `find`, the click cascade (`resolveTap`, `dispatchClick`),
+`clear` and `destroy` are the core implementation shared with every other provider.
+
+The only provider-specific part is the renderer: a fill layer can only draw a 1 px outline, so the
+outline is drawn as a separate polyline by [`MapboxPolygonCompositeRenderer`](./MapboxPolygonCompositeRenderer.kt.md).
+
+## Constructor Parameters
+
+- `renderer`
+    - Type: `MapboxPolygonCompositeRenderer`
+    - Description: Draws both the fill and the outline. Its `fill.polygonManager` is used as the
+      controller's polygon manager, so the controller and the fill renderer always see the same
+      entities.
+
+## Properties
+
+- `zIndex`: `2` (unchanged from the former `MapboxPolygonConductor`).

gradle.properties

@@ -3,10 +3,10 @@ android.useAndroidX=true
 kotlin.code.style=official
 android.nonTransitiveRClass=true
 
-compileSdk=35
+compileSdk=37
 minSdk=26
 javaVersion=17
 jvmTarget=17
 
-libraryVersion=1.3.1
+libraryVersion=1.4.0
 android.generateSyncIssueWhenLibraryConstraintsAreEnabled=false