Prepare 1.3.0 release (#1)

* test: pin public API surface baseline

ドライバー層の共通化中にアプリ開発者向け API を凍結し続けるため、現在の公開 API
サーフェスをベースラインとして記録する。生成は親リポジトリの
gradle/api-surface.gradle.kts（release AAR の classes.jar を javap で読む）。

  ./gradlew :/Users/masashi/mapconductor/android-sdk/android-for-maptilerpiDump   ベースラインを更新
  ./gradlew :/Users/masashi/mapconductor/android-sdk/android-for-maptilerpiCheck  差分を検出

* refactor: use core WebMercatorZoomAltitudeConverter

ズーム換算の式をコアへ移し、このクラスはオフセット 1.0（512px タイルのベクタ
エンジン）を指定するだけにする。companion のズーム変換ヘルパーは
MapCameraPosition.kt から使われているのでそのまま残した。移行前の値と 320 点すべてで
ビット単位一致することをコア側のゴールデンテストで検証済み。

* refactor: move MapTilerViewState onto the core base

Step 3 のプロバイダ移行、7 つ目。145 行 -> 116 行。

削ったもの: _cameraPosition / cameraPosition の getter /
  moveCameraTo x2 / fitBounds / getMapViewHolder の自前実装

このプロバイダ固有の注意点:
  - コンストラクタの第3引数名は **initialCameraPosition**（他プロバイダは
    cameraPosition）。公開 API なので変えない。
  - setController は接続時にカメラを移動しない。初期カメラは MTMapOptions として
    地図生成時に渡しているため。attachController(controller,
    moveToInitialCamera = false) を使う。
  - _cameraPosition は mutableStateOf だったが、基底は素のフィールド。
    読み出しは MapTilerMapView の remember ブロック内（監視不要）のみで、
    example-app 側もコールバック/ViewModel からしか読んでいないことを確認済み。
    先行して移行済みの 6 プロバイダと同じ前提になる。

apiCheck の差分は getCameraPosition / moveCameraTo x2 がこのクラスの宣言から
消えたことのみで、いずれも基底に public で存在し継承で解決されるため互換。

* fix: keep the optimistic camera update after moving onto the core base

基底へ移した際に optimisticCameraUpdate の指定が漏れていた。移行前は
moveCameraTo がコントローラへ委譲する前に _cameraPosition を要求値で更新して
おり、WebView ブリッジ越しでカメライベントの往復が遅いこのプロバイダでは、
要求直後に cameraPosition を読むと古い値が返ってしまう。

基底に足した optimisticCameraUpdate = true を渡して元の挙動へ戻す。

* refactor: drop the Capable facade delegations in favour of the core defaults

compositionXxx / updateXxx / hasXxx のうち、登録済みコントローラへ 1 行転送
しているだけのものを削除する。BaseMapViewController の既定実装が
OverlayKind で振り分けて同じことをする。

追加処理が要るもの（MapLibre / Mapbox の polygon は z レイヤの再構築が要る）は
override したまま残している。

apiCheck の差分は基底へ移って継承される宣言のみ。

* refactor: use the core click cascade

タップの扱いを他プロバイダと揃える。従来は地図クリックを**先に無条件で**通知し、
そのうえでポリライン・ポリゴン・円の**すべて**に配送していた（早期 return が無い）。
そのためオーバーレイをタップすると onMapClick とオーバーレイの onClick が
両方飛んでいた。いまは marker -> circle -> groundImage -> polyline -> polygon -> map
の順で先に当たった 1 つだけ。グラウンドイメージが探索対象に入るのも今回から。

handleTap は公開済みの入口なので残し、中身をコアの dispatchOverlayTap に置き換えて
非推奨にする。handleMarkerTap は消費したかを返すようになり、clickable=false の
マーカーを透過させる。

実機確認: polygon-click で Inside、circle でトースト、polyline-click で線上の
最近傍点、marker-postoffice で情報ウィンドウ。

* test: update the API baseline for the marker drag hooks

MarkerOverlayRendererInterface に既定つきで onDragSelectionChanged /
onDragPositionChanged が増えたので、実装クラスにも既定実装が生える。
このプロバイダはドラッグ層を持たないので実装は空（コアの既定）。

* Prepare 1.3.0 release

- Bump `libraryVersion` to 1.3.0
- Point README docs links at the consolidated mapconductor.com site (`docs-android.mapconductor.com` is being retired)
- Fill in the LICENSE copyright line (2026)

Author: wf9a5m75

.github/workflows/publish-maven-central.yml

@@ -59,7 +59,7 @@ jobs:
 
             GROUP_ID="com.mapconductor"
             GROUP_PATH="${GROUP_ID//./\/}"
-            ARTIFACT_ID="for-maplibre"
+            ARTIFACT_ID="for-maptiler"
 
             local_version=$(grep '^libraryVersion=' gradle.properties | cut -d'=' -f2 | tr -d '\r')
             if [[ -z "$local_version" ]]; then

LICENSE

@@ -186,7 +186,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright [yyyy] [name of copyright owner]
+   Copyright 2026 Masashi Katsumata
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

README.md

@@ -12,6 +12,8 @@ This module wraps the official [`com.maptiler:maptiler-sdk-kotlin`](https://docs
 
 ## Setup
 
+https://mapconductor.com/setup/android/maptiler/
+
 Add your MapTiler Cloud API key. This module reads it from an
 `AndroidManifest.xml` `<meta-data>` entry (injected by the Secrets Gradle Plugin from
 `secrets.properties`):
@@ -46,6 +48,197 @@ fun MapView(modifier: Modifier = Modifier) {
 }
 ```
 
+## Components
+
+### MapTilerMapView [[docs]](https://mapconductor.com/mapview/)
+
+```kotlin
+@Composable
+fun MapExample() {
+    val initCameraPosition = MapCameraPosition(
+        position = GeoPoint(
+            latitude = 34.091,
+            longitude = -117.886,
+        ),
+        zoom = 9.0,
+        tilt = 60.0,
+        bearing = 30.0,
+    )
+
+    val mapViewState = rememberMapTilerMapViewState(
+        cameraPosition = initCameraPosition,
+    )
+
+    MapTilerMapView(mapViewState)
+}
+```
+
+------------------------------------------------------------------------
+
+### Marker [[docs]](https://mapconductor.com/markers/)
+
+```kotlin
+@Composable
+fun MarkerExample() {
+    val markerState = remember { MarkerState(
+        position = GeoPoint(...),
+        icon = DefaultMarkerIcon().copy(
+            label = "MapTiler",
+        ),
+        onClick = {
+            it.animate(MarkerAnimation.Bounce)
+        },
+    ) }
+
+    MapTilerMapView(...) {
+        Marker(markerState)
+    }
+}
+```
+
+------------------------------------------------------------------------
+
+### InfoBubble [[docs]](https://mapconductor.com/info-bubble/)
+
+```kotlin
+@Composable
+fun InfoBubbleExample() {
+    var selectedMarker by remember { mutableStateOf<MarkerState?>(null) }
+
+    val markerState = remember { MarkerState(
+        ...,
+        onClick = {
+            selectedMarker = it
+        },
+    ) }
+
+    MapTilerMapView(...) {
+        Marker(markerState)
+        selectedMarker?.let {
+            InfoBubble(
+                marker = it,
+            ) {
+                Text("Hello, world!")
+            }
+        }
+    }
+}
+```
+
+------------------------------------------------------------------------
+
+### Circle [[docs]](https://mapconductor.com/circle/)
+
+```kotlin
+@Composable
+fun CircleExample() {
+
+    val circleState = remember { CircleState(
+        center = GeoPoint(...),
+        radiusMeters = 50.0,
+        fillColor = Color.Blue.copy(alpha = 0.5f),
+        onClick = {
+            it.state.fillColor = Color.Red.copy(alpha = 0.5f)
+        }
+    ) }
+
+    MapTilerMapView(...) {
+        Circle(circleState)
+    }
+}
+```
+
+------------------------------------------------------------------------
+
+### Polyline [[docs]](https://mapconductor.com/polyline/)
+
+```kotlin
+@Composable
+fun PolylineExample() {
+
+    val polylineState = remember { PolylineState(
+            points = airports,
+            strokeColor = Color.Blue.copy(alpha = 0.5f),
+            strokeWidth = 4.dp,
+            geodesic = true,
+        ) }
+
+    MapTilerMapView(...) {
+        Polyline(polylineState)
+    }
+}
+```
+
+------------------------------------------------------------------------
+
+### Polygon [[docs]](https://mapconductor.com/polygon/)
+
+```kotlin
+@Composable
+fun PolygonExample() {
+
+    val polygonState = remember { PolygonState(
+        points = goryokaku,
+        strokeColor = Color.Blue.copy(alpha = 0.5f),
+        fillColor =  Color.Red.copy(alpha = 0.7f),
+    ) }
+
+    MapTilerMapView(...) {
+        Polygon(polygonState)
+    }
+}
+```
+
+------------------------------------------------------------------------
+
+### Polygon Hole
+
+```kotlin
+@Composable
+fun PolygonHoleExample() {
+
+    val polygonState =
+        remember {
+            PolygonState(
+                points = listOf(...),
+                holes = listOf(
+                            listOf(...),
+                            listOf(...),
+                        ),
+                fillColor = Color(0xCC787880),
+                strokeColor = Color.Red,
+                strokeWidth = 2.dp,
+            )
+        }
+
+    MapTilerMapView(...) {
+        Polygon(polygonState)
+    }
+}
+```
+
+------------------------------------------------------------------------
+
+### GroundImage [[docs]](https://mapconductor.com/ground-image/)
+
+```kotlin
+@Composable
+fun GroundImageExample() {
+    val groundImageState = remember { GroundImageState(
+        bounds = GeoRectBounds(
+            southWest = GeoPoint.fromLatLong(...),
+            northEast = GeoPoint.fromLatLong(...),
+        ),
+        image = image,
+        opacity = 0.5f,
+    ) }
+
+    MapTilerMapView(state = mapViewState) {
+        GroundImage(groundImageState)
+    }
+}
+```
+
 ## Available designs
 
 `MapTilerDesign` exposes MapTiler Cloud reference styles and variants, including: