Update version; improve comments

Author: afarber

README.md

@@ -14,7 +14,7 @@ Add to your `build.gradle.kts`:
 
 ```kotlin
 dependencies {
-    implementation("de.afarber:openmapview:0.11.0")
+    implementation("de.afarber:openmapview:0.12.0")
 }
 ```
 

docs/PERFORMANCE.md

@@ -269,7 +269,7 @@ HttpClient(Android) {
 All requests include a user-agent header as required by OSM tile usage policy:
 
 ```kotlin
-header("User-Agent", "OpenMapView/0.11.0 (https://github.com/afarber/OpenMapView)")
+header("User-Agent", "OpenMapView/0.12.0 (https://github.com/afarber/OpenMapView)")
 ```
 
 ### Coroutine-Based Downloads

docs/REPLACING_GOOGLE_MAPS.md

@@ -107,7 +107,7 @@ dependencies {
 ```kotlin
 // Add to build.gradle.kts
 dependencies {
-    implementation("de.afarber:openmapview:0.11.0")
+    implementation("de.afarber:openmapview:0.12.0")
 }
 ```
 

examples/Example03Markers/README.md

@@ -1,19 +1,19 @@
-# Example03Markers - Marker Overlays and Interactive Management
+# Example03Markers - Marker Navigation and Info Windows
 
 [Back to README](../../README.md)
 
-This example demonstrates the marker system in OpenMapView, including marker rendering, touch detection, info windows, and interactive marker management.
+This example demonstrates the marker system in OpenMapView, including marker rendering, touch detection, info windows, and marker navigation.
 
 ## Features Demonstrated
 
 - Multiple markers at real Bochum landmark locations
 - Default teardrop marker icons with color variations
-- Both API styles: Kotlin direct instantiation and Google Maps builder pattern
 - Marker click detection and selection tracking
-- Info windows showing marker titles and snippets
-- Interactive marker management (add, remove, clear)
-- Real-time status display (marker count, selection, camera state)
-- Reset functionality to restore initial state
+- Info windows showing marker titles and snippets with auto-dismiss
+- Navigation between markers with prev/next buttons
+- Info window toggle via FAB or marker tap
+- Real-time status display (selection index, camera state)
+- Visual feedback when info window is shown (red text)
 
 ## Screenshot
 
@@ -43,8 +43,9 @@ adb shell am start -n de.afarber.openmapview.example03markers/.MainActivity
 ```
 example03markers/
 ├── MainActivity.kt      # Main activity and MapViewScreen composable
-├── MarkerToolbar.kt     # Horizontal toolbar with add/remove/clear buttons
-├── StatusToolbar.kt     # Status overlay showing marker count and selection
+├── MarkerToolbar.kt     # Horizontal toolbar with prev/next navigation buttons
+├── StatusToolbar.kt     # Status overlay showing selection index and camera state
+├── MarkerData.kt        # Marker data class and initial Bochum locations
 └── Colors.kt            # OSM-inspired colors and shared dimensions
 ```
 
@@ -57,8 +58,9 @@ example03markers/
 fun MapViewScreen() {
     val lifecycleOwner = LocalLifecycleOwner.current
     var mapView: OpenMapView? by remember { mutableStateOf(null) }
-    var markerCount by remember { mutableIntStateOf(6) }
+    var selectedIndex by remember { mutableIntStateOf(0) }
     var selectedMarker: Marker? by remember { mutableStateOf(null) }
+    var isInfoWindowShown by remember { mutableStateOf(false) }
 
     Box(modifier = Modifier.fillMaxSize()) {
         AndroidView(
@@ -67,19 +69,24 @@ fun MapViewScreen() {
                     lifecycleOwner.lifecycle.addObserver(this)
                     setCenter(initialLocation)
                     setZoom(13.0f)
+                    getUiSettings().infoWindowAutoDismiss = 10.seconds
 
                     setOnMarkerClickListener { marker ->
                         selectedMarker = marker
+                        isInfoWindowShown = marker.isInfoWindowShown
                         true
                     }
+                    setOnInfoWindowCloseListener {
+                        isInfoWindowShown = false
+                    }
                     mapView = this
                 }
             },
             modifier = Modifier.fillMaxSize(),
         )
 
-        StatusToolbar(markerCount = markerCount, selectedMarkerTitle = selectedMarker?.title, ...)
-        MarkerToolbar(onAddClick = { ... }, onRemoveClick = { ... }, onClearClick = { ... })
+        StatusToolbar(selectedIndex, selectedMarker?.title, cameraState, isInfoWindowShown, ...)
+        MarkerToolbar(onPrevClick = { ... }, onNextClick = { ... })
     }
 }
 ```
@@ -112,30 +119,30 @@ addMarker(
 ### OSM-Inspired Colors (Colors.kt)
 
 ```kotlin
-val OsmParkGreen = Color(0xFFAAD3A2)   // Add button
-val OsmHighwayPink = Color(0xFFE892A2)  // Remove button, Reset FAB
-val OsmWaterBlue = Color(0xFFAAD3DF)    // Clear button
+val OsmParkGreen = Color(0xFFAAD3A2)   // Navigation buttons (prev/next)
+val OsmHighwayPink = Color(0xFFE892A2)  // Info window toggle FAB
+val OsmWaterBlue = Color(0xFFAAD3DF)    // Reserved for future use
 ```
 
 ### Key Concepts
 
 - **Marker**: Data class with position, title, snippet, icon, anchor, and tag
 - **addMarker()**: Add a marker to the map
-- **removeMarker()**: Remove a specific marker
-- **clearMarkers()**: Remove all markers
 - **getMarkers()**: Get list of all markers
 - **setOnMarkerClickListener()**: Handle marker click events
 - **setOnInfoWindowClickListener()**: Handle info window click events
+- **setOnInfoWindowCloseListener()**: Handle info window close events (manual or auto-dismiss)
+- **infoWindowAutoDismiss**: Auto-dismiss info windows after a duration
 
 ## What to Test
 
 1. **Launch the app** - you should see 6 colored markers at Bochum landmarks
-2. **Tap a marker** - info window shows title and snippet, status shows selection
-3. **Tap info window** - toast message confirms the click
-4. **Tap + button** - adds new marker at map center
-5. **Tap - button** - removes currently selected marker
-6. **Tap trash button** - clears all markers
-7. **Tap reset FAB** - restores initial markers and camera position
+2. **Tap a marker** - info window shows title and snippet, status text turns red
+3. **Tap the same marker again** - info window closes, status text turns black
+4. **Tap info window** - toast message confirms the click
+5. **Tap prev/next buttons** - navigate between markers with camera animation
+6. **Tap the FAB** - toggles info window on selected marker
+7. **Wait 10 seconds** - info window auto-dismisses, status text turns black
 8. **Pan/zoom the map** - markers stay at correct geographic positions
 
 ## Marker Locations

examples/Example03Markers/src/main/kotlin/de/afarber/openmapview/example03markers/MainActivity.kt

@@ -47,9 +47,9 @@ import kotlin.time.Duration.Companion.seconds
  * This example showcases:
  * - Displaying markers with different colors at real Bochum locations
  * - Navigating between markers with prev/next buttons
- * - Toggling info windows on selected markers
+ * - Toggling info windows via FAB or marker tap
  * - Camera animation when centering on markers
- * - Real-time marker count and selection tracking
+ * - Real-time selection index and info window state tracking
  * - Camera state monitoring
  */
 class MainActivity : ComponentActivity() {
@@ -228,7 +228,7 @@ fun MapViewScreen() {
         ) {
             Icon(
                 imageVector = Icons.Default.LocationOn,
-                contentDescription = "Reset",
+                contentDescription = "Toggle Info Window",
             )
         }
     }

examples/Example03Markers/src/main/kotlin/de/afarber/openmapview/example03markers/MarkerToolbar.kt

@@ -24,12 +24,9 @@ import androidx.compose.ui.graphics.Color
 import androidx.compose.ui.unit.dp
 
 /**
- * A horizontal toolbar with buttons to navigate markers.
+ * A horizontal toolbar with buttons to navigate between markers.
  *
- * Uses OSM-inspired colors for visual consistency:
- * - Previous button: OsmParkGreen
- * - Next button: OsmParkGreen
- * - Info button: OsmWaterBlue
+ * Both buttons use OsmParkGreen for visual consistency with OSM styling.
  *
  * @param onPrevClick Callback invoked when the previous marker button is clicked.
  * @param onNextClick Callback invoked when the next marker button is clicked.

examples/Example03Markers/src/main/kotlin/de/afarber/openmapview/example03markers/StatusToolbar.kt

@@ -20,10 +20,10 @@ import androidx.compose.ui.graphics.Color
 import androidx.compose.ui.unit.dp
 
 /**
- * A status overlay displaying current marker and camera state information.
+ * A status overlay displaying current marker selection and camera state.
  *
- * Shows the currently selected marker index and name, and camera state.
- * The marker number text turns red when an info window is shown.
+ * Shows the currently selected marker index, name, and camera state.
+ * The marker index text turns red when an info window is shown.
  *
  * @param selectedIndex The index of the currently selected marker.
  * @param selectedMarkerTitle Title of the currently selected marker, or null if none selected.

openmapview/src/main/kotlin/de/afarber/openmapview/TileDownloader.kt

@@ -33,7 +33,7 @@ class TileDownloader {
         try {
             val response =
                 client.get(url) {
-                    header("User-Agent", "OpenMapView/0.11.0 (https://github.com/afarber/OpenMapView)")
+                    header("User-Agent", "OpenMapView/0.12.0 (https://github.com/afarber/OpenMapView)")
                 }
             val bytes = response.readRawBytes()
             // Decode with RGB_565 to reduce memory usage (2 bytes per pixel vs 4 bytes for ARGB_8888)

openmapview/src/main/kotlin/de/afarber/openmapview/UrlTileProvider.kt

@@ -62,7 +62,7 @@ abstract class UrlTileProvider(
      *
      * @return User-Agent string
      */
-    protected open fun getUserAgent(): String = "OpenMapView/0.11.0 (https://github.com/afarber/OpenMapView)"
+    protected open fun getUserAgent(): String = "OpenMapView/0.12.0 (https://github.com/afarber/OpenMapView)"
 
     /**
      * Builds the URL for the specified tile coordinates by replacing placeholders