feat(map): migrate from MapKit to MapLibre Native

.gitignore

@@ -51,6 +51,7 @@ playground.xcworkspace
 
 build/
 .build/
+.spm-cache/
 
 # CocoaPods
 #

MC1/Extensions/CLLocationCoordinate2D+BoundingRegion.swift

@@ -0,0 +1,46 @@
+import CoreLocation
+import MapKit
+import MapLibre
+
+extension Array where Element == CLLocationCoordinate2D {
+    /// Computes a bounding `MKCoordinateRegion` that fits all coordinates with padding.
+    func boundingRegion(paddingMultiplier: Double = 1.5) -> MKCoordinateRegion? {
+        guard let first else { return nil }
+
+        var minLat = first.latitude, maxLat = first.latitude
+        var minLon = first.longitude, maxLon = first.longitude
+
+        for coord in dropFirst() {
+            minLat = Swift.min(minLat, coord.latitude)
+            maxLat = Swift.max(maxLat, coord.latitude)
+            minLon = Swift.min(minLon, coord.longitude)
+            maxLon = Swift.max(maxLon, coord.longitude)
+        }
+
+        return MKCoordinateRegion(
+            center: CLLocationCoordinate2D(
+                latitude: (minLat + maxLat) / 2,
+                longitude: (minLon + maxLon) / 2
+            ),
+            span: MKCoordinateSpan(
+                latitudeDelta: Swift.min(180, Swift.max(0.01, (maxLat - minLat) * paddingMultiplier)),
+                longitudeDelta: Swift.min(360, Swift.max(0.01, (maxLon - minLon) * paddingMultiplier))
+            )
+        )
+    }
+}
+
+extension MKCoordinateRegion {
+    func toMLNCoordinateBounds() -> MLNCoordinateBounds {
+        MLNCoordinateBounds(
+            sw: CLLocationCoordinate2D(
+                latitude: center.latitude - span.latitudeDelta / 2,
+                longitude: center.longitude - span.longitudeDelta / 2
+            ),
+            ne: CLLocationCoordinate2D(
+                latitude: center.latitude + span.latitudeDelta / 2,
+                longitude: center.longitude + span.longitudeDelta / 2
+            )
+        )
+    }
+}

MC1/Extensions/CLLocationCoordinate2D+Formatting.swift

@@ -0,0 +1,7 @@
+import CoreLocation
+
+extension CLLocationCoordinate2D {
+    var formattedString: String {
+        "\(latitude.formatted(.number.precision(.fractionLength(6)))), \(longitude.formatted(.number.precision(.fractionLength(6))))"
+    }
+}

MC1/Extensions/ContactDTO+Coordinate.swift

@@ -0,0 +1,8 @@
+import CoreLocation
+import MC1Services
+
+extension ContactDTO {
+    var coordinate: CLLocationCoordinate2D {
+        CLLocationCoordinate2D(latitude: latitude, longitude: longitude)
+    }
+}

MC1/Extensions/ContactType+Display.swift

@@ -0,0 +1,28 @@
+import MeshCore
+import SwiftUI
+
+extension ContactType {
+    var iconSystemName: String {
+        switch self {
+        case .chat: "person.fill"
+        case .repeater: "antenna.radiowaves.left.and.right"
+        case .room: "person.3.fill"
+        }
+    }
+
+    var displayColor: Color {
+        switch self {
+        case .chat: .blue
+        case .repeater: .green
+        case .room: .purple
+        }
+    }
+
+    var pinStyle: MapPoint.PinStyle {
+        switch self {
+        case .chat: .contactChat
+        case .repeater: .contactRepeater
+        case .room: .contactRoom
+        }
+    }
+}

MC1/Extensions/View+LiquidGlass.swift

@@ -21,6 +21,16 @@ extension View {
         }
     }
 
+    /// Applies glass button style on iOS 26+, falls back to bordered (secondary weight) on earlier versions
+    @ViewBuilder
+    func liquidGlassSecondaryButtonStyle() -> some View {
+        if #available(iOS 26.0, *) {
+            self.buttonStyle(.glass)
+        } else {
+            self.buttonStyle(.bordered)
+        }
+    }
+
     /// Applies prominent glass button style with tint on iOS 26+, falls back to borderedProminent on earlier versions
     @ViewBuilder
     func liquidGlassProminentButtonStyle() -> some View {

MC1/Resources/Generated/L10n.swift

@@ -1511,6 +1511,12 @@ public enum L10n {
         public static func viewRuns(_ p1: Int) -> String {
           return L10n.tr("Contacts", "contacts.results.viewRuns", p1, fallback: "View %d runs")
         }
+        public enum Comparison {
+          /// Decreased
+          public static let decreased = L10n.tr("Contacts", "contacts.results.comparison.decreased", fallback: "Decreased")
+          /// Location: ComparisonRowView.swift - Purpose: Accessibility labels for change direction
+          public static let increased = L10n.tr("Contacts", "contacts.results.comparison.increased", fallback: "Increased")
+        }
         public enum Hop {
           /// Location: TraceResultsSheet.swift - Purpose: Average SNR display
           public static func avgSNR(_ p1: Any, _ p2: Any, _ p3: Any) -> String {
@@ -1772,8 +1778,12 @@ public enum L10n {
           }
         }
         public enum Map {
+          /// Location: TracePathMapView.swift - Purpose: Center on path accessibility
+          public static let centerOnPath = L10n.tr("Contacts", "contacts.trace.map.centerOnPath", fallback: "Center on path")
           /// Location: TracePathMapView.swift - Purpose: Clear button
           public static let clear = L10n.tr("Contacts", "contacts.trace.map.clear", fallback: "Clear")
+          /// Location: TracePathMapViewModel.swift - Purpose: Default path name fallback
+          public static let defaultPathName = L10n.tr("Contacts", "contacts.trace.map.defaultPathName", fallback: "Path")
           /// Location: TracePathMapView.swift - Purpose: Hide labels accessibility
           public static let hideLabels = L10n.tr("Contacts", "contacts.trace.map.hideLabels", fallback: "Hide labels")
           /// Location: TracePathMapView.swift - Purpose: Hops count in results banner
@@ -2021,10 +2031,10 @@ public enum L10n {
         }
       }
       public enum Common {
+        /// Dismiss
+        public static let dismissOverlay = L10n.tr("Map", "map.common.dismissOverlay", fallback: "Dismiss")
         /// Location: MapView.swift - Purpose: Done button for sheets
         public static let done = L10n.tr("Map", "map.common.done", fallback: "Done")
-        /// Location: MapView.swift - Purpose: Refresh button label
-        public static let refresh = L10n.tr("Map", "map.common.refresh", fallback: "Refresh")
       }
       public enum Controls {
         /// Location: MapView.swift - Purpose: Accessibility label for center on all contacts button
@@ -2035,8 +2045,14 @@ public enum L10n {
         public static let hideLabels = L10n.tr("Map", "map.controls.hideLabels", fallback: "Hide labels")
         /// Location: MapControlsToolbar.swift - Purpose: Accessibility label for layers button
         public static let layers = L10n.tr("Map", "map.controls.layers", fallback: "Map layers")
+        /// Location: MapCanvasView.swift - Purpose: Accessibility label for north lock button (lock)
+        public static let lockNorth = L10n.tr("Map", "map.controls.lockNorth", fallback: "Lock to north")
+        /// Location: MapView.swift - Purpose: Accessibility label for refresh button
+        public static let refresh = L10n.tr("Map", "map.controls.refresh", fallback: "Refresh contacts")
         /// Location: MapView.swift - Purpose: Accessibility label when labels are hidden
         public static let showLabels = L10n.tr("Map", "map.controls.showLabels", fallback: "Show labels")
+        /// Location: MapCanvasView.swift - Purpose: Accessibility label for north lock button (unlock)
+        public static let unlockNorth = L10n.tr("Map", "map.controls.unlockNorth", fallback: "Unlock rotation")
       }
       public enum Detail {
         /// Location: MapView.swift ContactDetailSheet - Purpose: Value showing contact is favorited
@@ -2088,12 +2104,6 @@ public enum L10n {
           public static let networkPath = L10n.tr("Map", "map.detail.section.networkPath", fallback: "Network Path")
         }
       }
-      public enum EmptyState {
-        /// Location: MapView.swift - Purpose: Empty state description
-        public static let description = L10n.tr("Map", "map.emptyState.description", fallback: "Contacts with location data will appear here once discovered on the mesh network.")
-        /// Location: MapView.swift - Purpose: Empty state title when no contacts have location
-        public static let title = L10n.tr("Map", "map.emptyState.title", fallback: "No Contacts on Map")
-      }
       public enum NodeKind {
         /// Location: MapView.swift ContactDetailSheet - Purpose: Display name for chat contact type
         public static let chatContact = L10n.tr("Map", "map.nodeKind.chatContact", fallback: "Chat Contact")
@@ -2102,13 +2112,23 @@ public enum L10n {
         /// Location: MapView.swift ContactDetailSheet - Purpose: Display name for room type
         public static let room = L10n.tr("Map", "map.nodeKind.room", fallback: "Room")
       }
+      public enum OfflineBadge {
+        /// Label shown on map when device has no internet connection
+        public static let label = L10n.tr("Map", "map.offlineBadge.label", fallback: "Offline")
+      }
       public enum Style {
-        /// Location: MapStyleSelection.swift - Purpose: Hybrid map style option
-        public static let hybrid = L10n.tr("Map", "map.style.hybrid", fallback: "Hybrid")
+        /// Location: LayersMenu.swift - Purpose: Accessibility label for map style menu
+        public static let accessibilityLabel = L10n.tr("Map", "map.style.accessibilityLabel", fallback: "Map style")
+        /// Location: LayersMenu.swift - Purpose: Hint when no offline pack covers viewport
+        public static let noOfflineCoverage = L10n.tr("Map", "map.style.noOfflineCoverage", fallback: "No offline map covers this area")
+        /// Location: LayersMenu.swift - Purpose: Hint when style requires network
+        public static let requiresNetwork = L10n.tr("Map", "map.style.requiresNetwork", fallback: "Requires network connection")
         /// Location: MapStyleSelection.swift - Purpose: Satellite map style option
         public static let satellite = L10n.tr("Map", "map.style.satellite", fallback: "Satellite")
         /// Location: MapStyleSelection.swift - Purpose: Standard map style option
         public static let standard = L10n.tr("Map", "map.style.standard", fallback: "Standard")
+        /// Location: MapStyleSelection.swift - Purpose: Topo map style option
+        public static let topo = L10n.tr("Map", "map.style.topo", fallback: "Topography")
       }
     }
   }
@@ -3701,6 +3721,76 @@ public enum L10n {
       /// Toggle label for room messages notifications
       public static let roomMessages = L10n.tr("Settings", "notifications.roomMessages", fallback: "Room Messages")
     }
+    public enum OfflineMaps {
+      /// Cancel button
+      public static let cancel = L10n.tr("Settings", "offlineMaps.cancel", fallback: "Cancel")
+      /// Status when pack download is complete
+      public static let complete = L10n.tr("Settings", "offlineMaps.complete", fallback: "Downloaded")
+      /// Delete button
+      public static let delete = L10n.tr("Settings", "offlineMaps.delete", fallback: "Delete")
+      /// Delete confirmation message
+      public static let deleteMessage = L10n.tr("Settings", "offlineMaps.deleteMessage", fallback: "The downloaded map data will be removed.")
+      /// Delete confirmation title
+      public static let deleteTitle = L10n.tr("Settings", "offlineMaps.deleteTitle", fallback: "Delete Offline Map?")
+      /// Button to start download
+      public static let download = L10n.tr("Settings", "offlineMaps.download", fallback: "Download")
+      /// Hint shown before estimate is available
+      public static let downloadHint = L10n.tr("Settings", "offlineMaps.downloadHint", fallback: "Enter a name and select an area to download.")
+      /// Status when pack is downloading
+      public static let downloading = L10n.tr("Settings", "offlineMaps.downloading", fallback: "Downloading…")
+      /// Button to download a new offline region
+      public static let downloadRegion = L10n.tr("Settings", "offlineMaps.downloadRegion", fallback: "Download Region")
+      /// Description for empty state
+      public static let emptyDescription = L10n.tr("Settings", "offlineMaps.emptyDescription", fallback: "Download map regions for use without internet.")
+      /// Title for empty state when no offline packs exist
+      public static let emptyTitle = L10n.tr("Settings", "offlineMaps.emptyTitle", fallback: "No Offline Maps")
+      /// Estimated download size
+      public static func estimatedSize(_ p1: Any) -> String {
+        return L10n.tr("Settings", "offlineMaps.estimatedSize", String(describing: p1), fallback: "Estimated size: ~%@")
+      }
+      /// Download exceeds available storage
+      public static let exceedsStorage = L10n.tr("Settings", "offlineMaps.exceedsStorage", fallback: "Not enough storage on this device. Zoom in to select a smaller area.")
+      /// Include layers prompt
+      public static let includeLayers = L10n.tr("Settings", "offlineMaps.includeLayers", fallback: "Include additional layers for offline use.")
+      /// Large tile download warning
+      public static let largeTileWarning = L10n.tr("Settings", "offlineMaps.largeTileWarning", fallback: "Large download area. This may take a while and use significant storage.")
+      /// Layers section header
+      public static let layers = L10n.tr("Settings", "offlineMaps.layers", fallback: "Layers")
+      /// No network available
+      public static let noNetwork = L10n.tr("Settings", "offlineMaps.noNetwork", fallback: "An internet connection is required to download maps.")
+      /// Pause download button
+      public static let pause = L10n.tr("Settings", "offlineMaps.pause", fallback: "Pause")
+      /// Paused status label
+      public static let paused = L10n.tr("Settings", "offlineMaps.paused", fallback: "Paused")
+      /// Navigation title for region picker sheet
+      public static let pickRegion = L10n.tr("Settings", "offlineMaps.pickRegion", fallback: "Select Region")
+      /// Placeholder for region name text field
+      public static let regionName = L10n.tr("Settings", "offlineMaps.regionName", fallback: "Region Name")
+      /// Resume download button
+      public static let resume = L10n.tr("Settings", "offlineMaps.resume", fallback: "Resume")
+      /// Section header for storage info
+      public static let storage = L10n.tr("Settings", "offlineMaps.storage", fallback: "Storage")
+      /// Storage section footer
+      public static let storageFooter = L10n.tr("Settings", "offlineMaps.storageFooter", fallback: "Includes map data and internal indexes. Total may be larger than the sum of individual downloads.")
+      /// Label for total storage used
+      public static let storageUsed = L10n.tr("Settings", "offlineMaps.storageUsed", fallback: "Storage Used")
+      /// Navigation title for offline maps settings
+      public static let title = L10n.tr("Settings", "offlineMaps.title", fallback: "Offline Maps")
+      /// Fallback name for unknown region
+      public static let unknownRegion = L10n.tr("Settings", "offlineMaps.unknownRegion", fallback: "Unknown Region")
+      public enum Error {
+        /// Error: insufficient disk space
+        public static let insufficientDiskSpace = L10n.tr("Settings", "offlineMaps.error.insufficientDiskSpace", fallback: "Not enough storage space. At least 100 MB is required.")
+        /// Error: tile limit reached
+        public static let tileLimitReached = L10n.tr("Settings", "offlineMaps.error.tileLimitReached", fallback: "The download tile limit has been reached.")
+      }
+      public enum Layer {
+        /// Layer type labels
+        public static let base = L10n.tr("Settings", "offlineMaps.layer.base", fallback: "Base Map")
+        /// Topography
+        public static let topo = L10n.tr("Settings", "offlineMaps.layer.topo", fallback: "Topography")
+      }
+    }
     public enum PathHashMode {
       /// Footer explaining path hash mode tradeoff
       public static let footer = L10n.tr("Settings", "pathHashMode.footer", fallback: "Larger hashes reduce routing collisions but limit the maximum number of hops per path.")

MC1/Resources/Localization/de.lproj/Contacts.strings

@@ -896,6 +896,9 @@
 /* Location: TracePathMapView.swift - Purpose: Show labels accessibility */
 "contacts.trace.map.showLabels" = "Beschriftungen einblenden";
 
+/* Location: TracePathMapView.swift - Purpose: Center on path accessibility */
+"contacts.trace.map.centerOnPath" = "Auf Pfad zentrieren";
+
 /* Location: TracePathMapView.swift - Purpose: Save path alert title */
 "contacts.trace.map.saveTitle" = "Pfad speichern";
 
@@ -920,6 +923,9 @@
 /* Location: TracePathMapView.swift - Purpose: View results button */
 "contacts.trace.map.viewResults" = "Ergebnisse";
 
+/* Location: TracePathMapViewModel.swift - Purpose: Default path name fallback */
+"contacts.trace.map.defaultPathName" = "Pfad";
+
 // MARK: - Trace Results Sheet
 
 /* Location: TraceResultsSheet.swift - Purpose: Navigation title */
@@ -949,6 +955,10 @@
 /* Location: TraceResultsSheet.swift - Purpose: Comparison text */
 "contacts.results.comparison" = "vs. %d ms am %@";
 
+/* Location: ComparisonRowView.swift - Purpose: Accessibility labels for change direction */
+"contacts.results.comparison.increased" = "Gestiegen";
+"contacts.results.comparison.decreased" = "Gesunken";
+
 /* Location: TraceResultsSheet.swift - Purpose: View runs link */
 "contacts.results.viewRuns" = "%d Durchläufe anzeigen";
 

MC1/Resources/Localization/de.lproj/Map.strings

@@ -10,17 +10,7 @@
 
 /* Location: MapView.swift - Purpose: Done button for sheets */
 "map.common.done" = "Fertig";
-
-/* Location: MapView.swift - Purpose: Refresh button label */
-"map.common.refresh" = "Aktualisieren";
-
-// MARK: - Map View Empty State
-
-/* Location: MapView.swift - Purpose: Empty state title when no contacts have location */
-"map.emptyState.title" = "Keine Kontakte auf der Karte";
-
-/* Location: MapView.swift - Purpose: Empty state description */
-"map.emptyState.description" = "Kontakte mit Standortdaten erscheinen hier, sobald sie im Mesh-Netzwerk entdeckt werden.";
+"map.common.dismissOverlay" = "Schließen";
 
 // MARK: - Map Controls
 
@@ -39,6 +29,15 @@
 /* Location: MapControlsToolbar.swift - Purpose: Accessibility label for layers button */
 "map.controls.layers" = "Kartenebenen";
 
+/* Location: MapCanvasView.swift - Purpose: Accessibility label for north lock button (lock) */
+"map.controls.lockNorth" = "Nach Norden ausrichten";
+
+/* Location: MapCanvasView.swift - Purpose: Accessibility label for north lock button (unlock) */
+"map.controls.unlockNorth" = "Drehung freigeben";
+
+/* Location: MapView.swift - Purpose: Accessibility label for refresh button */
+"map.controls.refresh" = "Kontakte aktualisieren";
+
 // MARK: - Map Style Selection
 
 /* Location: MapStyleSelection.swift - Purpose: Standard map style option */
@@ -47,8 +46,17 @@
 /* Location: MapStyleSelection.swift - Purpose: Satellite map style option */
 "map.style.satellite" = "Satellit";
 
-/* Location: MapStyleSelection.swift - Purpose: Hybrid map style option */
-"map.style.hybrid" = "Hybrid";
+/* Location: MapStyleSelection.swift - Purpose: Topo map style option */
+"map.style.topo" = "Topografie";
+
+/* Location: LayersMenu.swift - Purpose: Accessibility label for map style menu */
+"map.style.accessibilityLabel" = "Map style";
+
+/* Location: LayersMenu.swift - Purpose: Hint when style requires network */
+"map.style.requiresNetwork" = "Requires network connection";
+
+/* Location: LayersMenu.swift - Purpose: Hint when no offline pack covers viewport */
+"map.style.noOfflineCoverage" = "No offline map covers this area";
 
 // MARK: - Contact Detail Sheet
 
@@ -155,3 +163,8 @@
 
 /* Location: ContactAnnotation.swift - Purpose: Subtitle for room nodes */
 "map.annotation.room" = "Raum";
+
+// MARK: - Offline Badge
+
+/* Label shown on map when device has no internet connection */
+"map.offlineBadge.label" = "Offline";