Prepare 1.3.0 release: split remaining modules into submodules

.github/workflows/lint.yml

@@ -169,6 +169,44 @@ jobs:
             fi
           done
 
+      - name: Run unit tests
+        if: steps.detect.outputs.changed_modules != ''
+        run: |
+          echo "Running unit tests for modules: ${{ steps.detect.outputs.changed_modules }}"
+          for module in ${{ steps.detect.outputs.changed_modules }}; do
+            # サンプルアプリはユニットテストを持たない
+            case "$module" in
+              example-app|simple-map-app) continue ;;
+            esac
+            echo "Running testDebugUnitTest for $module"
+            if ./gradlew ":$module:testDebugUnitTest"; then
+              echo "✅ unit tests passed for $module"
+            else
+              echo "❌ unit tests failed for $module"
+              exit 1
+            fi
+          done
+
+      # 公開 API サーフェスの凍結ゲート。ドライバー層の共通化中、アプリ開発者向け API を
+      # 変えていないことを機械的に保証する。意図した変更なら ./gradlew :<module>:apiDump で
+      # ベースラインを更新してコミットすること。
+      - name: Check public API surface
+        if: steps.detect.outputs.changed_modules != ''
+        run: |
+          echo "Running apiCheck for modules: ${{ steps.detect.outputs.changed_modules }}"
+          for module in ${{ steps.detect.outputs.changed_modules }}; do
+            case "$module" in
+              example-app|simple-map-app|mapconductor-bom) continue ;;
+            esac
+            echo "Running apiCheck for $module"
+            if ./gradlew ":$module:apiCheck"; then
+              echo "✅ apiCheck passed for $module"
+            else
+              echo "❌ public API changed for $module"
+              exit 1
+            fi
+          done
+
       - name: Save hash cache
         if: success()
         uses: actions/cache/save@v5

.gitignore

@@ -32,3 +32,9 @@ arcgis-heatmap-issue.txt
 session.txt
 .idea
 google-services.json
+app1786438676688i1648980499/
+
+# Mappls auth config (account-specific, downloaded from Mappls console)
+example-app/*.a.conf
+example-app/*.a.olf
+example-app/src/debug/assets/mappls-conf.txt

.gitmodules

@@ -40,3 +40,27 @@
 [submodule "android-for-longdo"]
 	path = android-for-longdo
 	url = git@github.com:MapConductor/android-for-longdo.git
+[submodule "android-kml"]
+	path = android-kml
+	url = git@github.com:MapConductor/android-kml.git
+[submodule "android-for-openmobilemaps"]
+	path = android-for-openmobilemaps
+	url = git@github.com:MapConductor/android-for-openmobilemaps.git
+[submodule "android-for-template"]
+	path = android-for-template
+	url = git@github.com:MapConductor/android-for-template.git
+[submodule "mapconductor-bom"]
+	path = mapconductor-bom
+	url = git@github.com:MapConductor/mapconductor-bom.git
+[submodule "android-for-mappls"]
+	path = android-for-mappls
+	url = git@github.com:MapConductor/android-for-mappls.git
+[submodule "android-icons-jp"]
+	path = android-icons-jp
+	url = git@github.com:MapConductor/android-icons-jp.git
+[submodule "android-icons-us"]
+	path = android-icons-us
+	url = git@github.com:MapConductor/android-icons-us.git
+[submodule "android-icons-weather"]
+	path = android-icons-weather
+	url = git@github.com:MapConductor/android-icons-weather.git

CLAUDE.md

@@ -0,0 +1,124 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## 守っている前提（変えないこと）
+
+- **同一文法・同一動作・同一実装。** 少人数で保守するので「3 プラットフォーム
+  （android-sdk / ios-sdk / react-sdk）が同じ構造で書かれている」ことが最優先。
+  地図 SDK ごとの差でやむを得ず変える場合も、構造は可能な限り揃える。
+- **アプリ開発者向けの公開 API は凍結。** 見た目の変更と、後方互換な省略可能引数の
+  追加は可。それ以外は `apiCheck` が落とす（下記）。
+- **SDK は下げない。** 4.0 が出ているのに 3.3.0 を使う、はしない。
+- **基本的にすべての機能は一度動くことを確認してある。** 壊れて見えたら、まず
+  自分の変更を疑う。
+- **端末/エミュレータでの確認を必ず行う。** スクリーンショットだけで済ませない。
+- **API キーを git 管理下のファイルに書かない。** プレースホルダだけを置き、実値は
+  `secrets.properties` / `local.properties`（git 管理外）から流し込む。
+
+## リポジトリ構成
+
+Gradle のマルチモジュール。各モジュールは独立した Maven 成果物として publish する。
+
+```
+android-sdk-core/       # プロバイダ非依存のコア（com.mapconductor:core）
+android-sdk-compose/    # Jetpack Compose 層（com.mapconductor:compose）
+android-for-<sdk>/      # プロバイダ実装（googlemaps / maplibre / mapbox / arcgis /
+                        #   here / longdo / maptiler / mappls / tomtom /
+                        #   openmobilemaps / template）
+android-heatmap/        # 拡張: ヒートマップ
+android-marker-clustering/ # 拡張: マーカークラスタリング
+android-geojson-layer/  # 拡張: GeoJSON タイルレイヤ
+android-kml/            # 拡張: KML
+android-icons*/         # アイコン集（jp / us / weather）
+gradle/api-surface.gradle.kts  # 公開 API サーフェスの門番
+```
+
+`android-for-template` は**実在の地図 SDK ではなく代役を描くだけ**の雛形。
+新しいプロバイダを足すときの出発点で、アプリ開発者向けの選択肢ではない。
+
+## ビルドと検証
+
+```bash
+# Android Studio 同梱 JDK を明示しないと通らないことがある
+export JAVA_HOME="/Applications/Android Studio.app/Contents/jbr/Contents/Home"
+
+./gradlew :android-for-maplibre:compileDebugKotlin
+./gradlew apiCheck          # 公開 API の差分検査（後述）
+./gradlew apiDump           # 意図した変更ならベースラインを更新
+```
+
+### 公開 API サーフェス（apiDump / apiCheck）
+
+`gradle/api-surface.gradle.kts` が release AAR の `classes.jar` を `javap` で読み、
+`<module>/api/<module>.api` にテキストで記録する。`binary-compatibility-validator` は
+`com.android.library` に対応していない（`apiDump` タスクが 1 つも生成されない）ため
+この方式を採っている。
+
+`@InternalMapConductorApi` を付けた宣言は記録しない。**ドライバー実装点には必ず
+付けること。** 付け忘れるとアプリ向けの凍結 API に載ってしまう。
+iOS の `@_spi(MapConductorDriver)`、React の `/** @internal */` に対応する。
+
+## React Native から使うときの結合（重要）
+
+`react-sdk/reactnative-for-*` はこのリポジトリを **MavenLocal 経由**で参照する。
+コピーはしない。
+
+```bash
+# android-sdk を変更したら必ず publish してから RN 側を確認する
+./gradlew :android-for-maplibre:compileDebugKotlin :android-for-maplibre:publishToMavenLocal
+```
+
+publish を忘れると **RN 側は古い実装のまま静かに動く。** 「直したのに変わらない」の
+ほとんどはこれ。各 RN パッケージの `android/build.gradle` にある
+`com.mapconductor:*` のバージョンと MavenLocal を揃えること。
+
+Kotlin は 2.3.20 に固定してある（上げると pika の上限に当たる）。
+
+## アーキテクチャ
+
+### コントローラは Compose と RN で共有する
+
+プロバイダごとに `createXxxViewController()` というファクトリを持ち、
+**Compose 版も RN 版も同じファクトリを通る。**
+
+```
+Compose: XxxMapView.kt          ─┐
+                                 ├→ createXxxViewController() → XxxViewController
+RN:      XxxMapViewWrapper.kt   ─┘
+```
+
+新しいプロバイダを足すときも、Compose だけで動く経路を作らないこと。
+経路が 2 本あると、片方でしか露見しない不具合が入る（下の「タイル判定」参照）。
+
+### マーカーは RN で Compose 層を通さない
+
+RN のマーカーは意図的に Compose を経由しない（大量マーカーで固まるため）。
+Compose ホストは、ヒートマップやマーカークラスタリングなど **Compose が要る拡張**
+だけに限定してある。
+
+## 踏んだ落とし穴
+
+- **タイル判定を自分で書かない。**
+  `controller.useMarkerLayer = markerTiling != null` と手書きすると、RN の共通基底が
+  常に非 null の `MarkerTilingOptions` を渡すので **全マーカーが消える**。
+  Compose では各ページが null を渡すので露見しない。
+  `MarkerTilingOptions.shouldUseTiles` /
+  `shouldUseMarkerLayer(count)`（`options.enabled && count >= options.minMarkerCount`）
+  を呼ぶこと。android-for-longdo と android-for-maptiler が同じ穴を順に踏んだ。
+
+- **デザイン ID の受け渡し方はプロバイダごとに違う。**
+  `id` / `getValue()` / スタイル URI のどれが 3 プラットフォームで一致するかは
+  プロバイダによる（Longdo・MapTiler は `id`、Mapbox はスタイル URI）。
+  **web・android・iOS の 3 つを実際に読んでから決めること。** iOS だけ見て web も
+  同じと決めつけて、Mapbox のタイルが真っ白になったことがある。
+
+- **`map.animateCamera(update, duration)` は素の ease ではない。**
+  MapLibre / Mappls では `Transform.animateCamera` → `NativeMap.flyTo`、つまり
+  van Wijk のズームアークに落ちる。ease が要るなら `easeCamera`。
+  名前から素の ease だと決めつけると iOS 側の対向実装を誤る。
+
+## 対応するリポジトリ
+
+`ios-sdk`（Swift）と `react-sdk`（TypeScript + RN ブリッジ）が兄弟として並ぶ前提。
+RN の `:path` / MavenLocal 参照はこの配置に依存している。

LICENSE

@@ -186,7 +186,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright 2025 Masashi Katsumata
+   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.es-419.md

@@ -112,11 +112,11 @@ dependencies {
 Cada proveedor de mapas puede requerir su propia clave de API, token de acceso, configuración de Gradle o configuración en el manifiesto de Android.
 
 Por favor revisa la guía de configuración del proveedor que estés usando.
-- [Configuración de Google Maps Android API](https://docs-android.mapconductor.com/setup/google-maps/)
-- [Configuración de MapBox](https://docs-android.mapconductor.com/setup/mapbox/)
-- [Configuración de HERE](https://docs-android.mapconductor.com/setup/here-maps/)
-- [Configuración de ArcGIS](https://docs-android.mapconductor.com/setup/arcgis/)
-- [Configuración de MapLibre](https://docs-android.mapconductor.com/setup/maplibre/)
+- [Configuración de Google Maps Android API](https://mapconductor.com/setup/android/google-maps/)
+- [Configuración de MapBox](https://mapconductor.com/setup/android/mapbox/)
+- [Configuración de HERE](https://mapconductor.com/setup/android/here/)
+- [Configuración de ArcGIS](https://mapconductor.com/setup/android/arcgis/)
+- [Configuración de MapLibre](https://mapconductor.com/setup/android/maplibre/)
 
 ---
 
@@ -354,7 +354,7 @@ Es especialmente útil cuando quieres que tu código de aplicación describa qu
 
 La documentación está disponible en:
 
-https://docs-android.mapconductor.com/es-419/
+https://mapconductor.com/es-419/
 
 La documentación incluye:
 

README.ja.md

@@ -112,11 +112,11 @@ dependencies {
 各マッププロバイダーは、それぞれ独自のAPIキー、アクセストークン、Gradleの設定、またはAndroidマニフェストの設定が必要な場合があります。
 
 使用するプロバイダーのセットアップガイドを確認してください。
-- [Google Maps Android APIのセットアップ](https://docs-android.mapconductor.com/setup/google-maps/)
-- [MapBoxのセットアップ](https://docs-android.mapconductor.com/setup/mapbox/)
-- [HEREのセットアップ](https://docs-android.mapconductor.com/setup/here-maps/)
-- [ArcGISのセットアップ](https://docs-android.mapconductor.com/setup/arcgis/)
-- [MapLibreのセットアップ](https://docs-android.mapconductor.com/setup/maplibre/)
+- [Google Maps Android APIのセットアップ](https://mapconductor.com/setup/android/google-maps/)
+- [MapBoxのセットアップ](https://mapconductor.com/setup/android/mapbox/)
+- [HEREのセットアップ](https://mapconductor.com/setup/android/here/)
+- [ArcGISのセットアップ](https://mapconductor.com/setup/android/arcgis/)
+- [MapLibreのセットアップ](https://mapconductor.com/setup/android/maplibre/)
 
 ---
 
@@ -354,7 +354,7 @@ MapConductorは、以下のような方に役立ちます:
 
 ドキュメントは以下で利用できます:
 
-https://docs-android.mapconductor.com/ja/
+https://mapconductor.com/ja/
 
 ドキュメントには以下が含まれます:
 

README.md

@@ -112,11 +112,11 @@ dependencies {
 Each map provider may require its own API key, access token, Gradle setup, or Android manifest configuration. 
 
 Please check the setup guide for the provider you are using.
-- [Setup for Google Maps Android API](https://docs-android.mapconductor.com/setup/google-maps/)
-- [Setup for MapBox](https://docs-android.mapconductor.com/setup/mapbox/)
-- [Setup for HERE](https://docs-android.mapconductor.com/setup/here-maps/)
-- [Setup for ArcGIS](https://docs-android.mapconductor.com/setup/arcgis/)
-- [Setup for MapLibre](https://docs-android.mapconductor.com/setup/maplibre/)
+- [Setup for Google Maps Android API](https://mapconductor.com/setup/android/google-maps/)
+- [Setup for MapBox](https://mapconductor.com/setup/android/mapbox/)
+- [Setup for HERE](https://mapconductor.com/setup/android/here/)
+- [Setup for ArcGIS](https://mapconductor.com/setup/android/arcgis/)
+- [Setup for MapLibre](https://mapconductor.com/setup/android/maplibre/)
 
 ---
 
@@ -354,7 +354,7 @@ It is especially helpful when you want your application code to describe what sh
 
 Documentation is available at:
 
-https://docs-android.mapconductor.com/
+https://mapconductor.com/
 
 The documentation includes: