deflock-app/lib/widgets/map_view.dart

import 'dart:async';
import 'package:flutter/material.dart';
import 'package:flutter_map/flutter_map.dart';
import 'package:flutter_map_animations/flutter_map_animations.dart';
import 'package:latlong2/latlong.dart';
import 'package:geolocator/geolocator.dart';
import 'package:provider/provider.dart';
import 'package:http/http.dart' as http;
import 'package:collection/collection.dart';
import 'package:shared_preferences/shared_preferences.dart';

import '../app_state.dart';
import '../services/offline_area_service.dart';
import '../services/simple_tile_service.dart';
import '../services/network_status.dart';
import '../models/osm_camera_node.dart';
import '../models/camera_profile.dart';
import '../models/tile_provider.dart';
import 'debouncer.dart';
import 'camera_provider_with_cache.dart';
import 'map/camera_markers.dart';
import 'map/direction_cones.dart';
import 'map/map_overlays.dart';
import 'network_status_indicator.dart';
import '../dev_config.dart';
import '../screens/home_screen.dart' show FollowMeMode;

class MapView extends StatefulWidget {
  final AnimatedMapController controller;
  const MapView({
    super.key,
    required this.controller,
    required this.followMeMode,
    required this.onUserGesture,
  });

  final FollowMeMode followMeMode;
  final VoidCallback onUserGesture;

  @override
  State<MapView> createState() => MapViewState();
}

class MapViewState extends State<MapView> {
  late final AnimatedMapController _controller;
  final Debouncer _cameraDebounce = Debouncer(kDebounceCameraRefresh);
  final Debouncer _tileDebounce = Debouncer(const Duration(milliseconds: 150));
  final Debouncer _mapPositionDebounce = Debouncer(const Duration(milliseconds: 1000));

  StreamSubscription<Position>? _positionSub;
  LatLng? _currentLatLng;
  LatLng? _initialLocation;
  double? _initialZoom;
  bool _hasMovedToInitialLocation = false;

  late final CameraProviderWithCache _cameraProvider;
  late final SimpleTileHttpClient _tileHttpClient;
  
  // Track profile changes to trigger camera refresh
  List<CameraProfile>? _lastEnabledProfiles;
  
  // Track zoom to clear queue on zoom changes
  double? _lastZoom;
  
  // Track changes that require cache clearing
  String? _lastTileTypeId;
  bool? _lastOfflineMode;
  int _mapRebuildKey = 0;

  @override
  void initState() {
    super.initState();
    OfflineAreaService();
    _controller = widget.controller;
    _tileHttpClient = SimpleTileHttpClient();
    
    // Load last map position before initializing GPS
    _loadLastMapPosition().then((_) {
      // Move to last known position after loading and widget is built
      WidgetsBinding.instance.addPostFrameCallback((_) {
        _moveToInitialLocationIfNeeded();
      });
    });
    _initLocation();

    // Set up camera overlay caching
    _cameraProvider = CameraProviderWithCache.instance;
    _cameraProvider.addListener(_onCamerasUpdated);
    
    // Fetch initial cameras
    WidgetsBinding.instance.addPostFrameCallback((_) {
      _refreshCamerasFromProvider();
    });
  }

  /// Move to initial location if we have one and haven't moved yet
  void _moveToInitialLocationIfNeeded() {
    if (!_hasMovedToInitialLocation && _initialLocation != null && mounted) {
      try {
        final zoom = _initialZoom ?? 15.0;
        // Double-check coordinates are valid before moving
        if (_isValidCoordinate(_initialLocation!.latitude) && 
            _isValidCoordinate(_initialLocation!.longitude) && 
            _isValidZoom(zoom)) {
          _controller.mapController.move(_initialLocation!, zoom);
          _hasMovedToInitialLocation = true;
          debugPrint('[MapView] Moved to initial location: ${_initialLocation!.latitude}, ${_initialLocation!.longitude}');
        } else {
          debugPrint('[MapView] Invalid initial location, not moving: ${_initialLocation!.latitude}, ${_initialLocation!.longitude}, zoom: $zoom');
        }
      } catch (e) {
        debugPrint('[MapView] Failed to move to initial location: $e');
      }
    }
  }

  /// Validate that a coordinate value is valid (not NaN, not infinite, within bounds)
  bool _isValidCoordinate(double value) {
    return !value.isNaN && 
           !value.isInfinite && 
           value >= -180.0 && 
           value <= 180.0;
  }

  /// Validate that a zoom level is valid
  bool _isValidZoom(double zoom) {
    return !zoom.isNaN && 
           !zoom.isInfinite && 
           zoom >= 1.0 && 
           zoom <= 25.0;
  }



  @override
  void dispose() {
    _positionSub?.cancel();
    _cameraDebounce.dispose();
    _tileDebounce.dispose();
    _mapPositionDebounce.dispose();
    _cameraProvider.removeListener(_onCamerasUpdated);
    _tileHttpClient.close();
    super.dispose();
  }

  void _onCamerasUpdated() {
    if (mounted) setState(() {});
  }

  /// Public method to retry location initialization (e.g., after permission granted)
  void retryLocationInit() {
    debugPrint('[MapView] Retrying location initialization');
    _initLocation();
  }

  /// Save the last map position to persistent storage
  Future<void> _saveLastMapPosition(LatLng location, double zoom) async {
    try {
      // Validate coordinates and zoom before saving
      if (!_isValidCoordinate(location.latitude) || 
          !_isValidCoordinate(location.longitude) || 
          !_isValidZoom(zoom)) {
        debugPrint('[MapView] Invalid map position, not saving: lat=${location.latitude}, lng=${location.longitude}, zoom=$zoom');
        return;
      }
      
      final prefs = await SharedPreferences.getInstance();
      await prefs.setDouble(kLastMapLatKey, location.latitude);
      await prefs.setDouble(kLastMapLngKey, location.longitude);
      await prefs.setDouble(kLastMapZoomKey, zoom);
      debugPrint('[MapView] Saved last map position: ${location.latitude}, ${location.longitude}, zoom: $zoom');
    } catch (e) {
      debugPrint('[MapView] Failed to save last map position: $e');
    }
  }

  /// Load the last map position from persistent storage
  Future<void> _loadLastMapPosition() async {
    try {
      final prefs = await SharedPreferences.getInstance();
      final lat = prefs.getDouble(kLastMapLatKey);
      final lng = prefs.getDouble(kLastMapLngKey);
      final zoom = prefs.getDouble(kLastMapZoomKey);
      
      if (lat != null && lng != null && 
          _isValidCoordinate(lat) && _isValidCoordinate(lng)) {
        final validZoom = zoom != null && _isValidZoom(zoom) ? zoom : 15.0;
        _initialLocation = LatLng(lat, lng);
        _initialZoom = validZoom;
        debugPrint('[MapView] Loaded last map position: ${_initialLocation!.latitude}, ${_initialLocation!.longitude}, zoom: $_initialZoom');
      } else {
        debugPrint('[MapView] Invalid saved coordinates, using defaults');
      }
    } catch (e) {
      debugPrint('[MapView] Failed to load last map position: $e');
    }
  }

  /// Save the follow-me mode to persistent storage
  static Future<void> saveFollowMeMode(FollowMeMode mode) async {
    try {
      final prefs = await SharedPreferences.getInstance();
      await prefs.setInt(kFollowMeModeKey, mode.index);
      debugPrint('[MapView] Saved follow-me mode: $mode');
    } catch (e) {
      debugPrint('[MapView] Failed to save follow-me mode: $e');
    }
  }

  /// Load the follow-me mode from persistent storage
  static Future<FollowMeMode> loadFollowMeMode() async {
    try {
      final prefs = await SharedPreferences.getInstance();
      final modeIndex = prefs.getInt(kFollowMeModeKey);
      if (modeIndex != null && modeIndex < FollowMeMode.values.length) {
        final mode = FollowMeMode.values[modeIndex];
        debugPrint('[MapView] Loaded follow-me mode: $mode');
        return mode;
      }
    } catch (e) {
      debugPrint('[MapView] Failed to load follow-me mode: $e');
    }
    // Default to northUp if no saved mode
    return FollowMeMode.northUp;
  }

  /// Clear any stored map position (useful for recovery from invalid data)
  static Future<void> clearStoredMapPosition() async {
    try {
      final prefs = await SharedPreferences.getInstance();
      await prefs.remove(kLastMapLatKey);
      await prefs.remove(kLastMapLngKey);
      await prefs.remove(kLastMapZoomKey);
      debugPrint('[MapView] Cleared stored map position');
    } catch (e) {
      debugPrint('[MapView] Failed to clear stored map position: $e');
    }
  }



  void _refreshCamerasFromProvider() {
    final appState = context.read<AppState>();
    LatLngBounds? bounds;
    try {
      bounds = _controller.mapController.camera.visibleBounds;
    } catch (_) {
      return;
    }
    final zoom = _controller.mapController.camera.zoom;
    if (zoom < kCameraMinZoomLevel) {
      // Show a snackbar-style bubble, if desired
      if (mounted) {
        ScaffoldMessenger.of(context).showSnackBar(
          SnackBar(
            content: Text('Cameras not drawn below zoom level $kCameraMinZoomLevel'),
            duration: const Duration(seconds: 2),
          ),
        );
      }
      return;
    }
    _cameraProvider.fetchAndUpdate(
      bounds: bounds,
      profiles: appState.enabledProfiles,
      uploadMode: appState.uploadMode,
    );
  }





  @override
  void didUpdateWidget(covariant MapView oldWidget) {
    super.didUpdateWidget(oldWidget);
    // Back to original pattern - simple check
    if (widget.followMeMode != FollowMeMode.off && 
        oldWidget.followMeMode == FollowMeMode.off && 
        _currentLatLng != null) {
      // Move to current location when follow me is first enabled - smooth animation
      if (widget.followMeMode == FollowMeMode.northUp) {
        _controller.animateTo(
          dest: _currentLatLng!,
          zoom: _controller.mapController.camera.zoom,
          duration: kFollowMeAnimationDuration,
          curve: Curves.easeOut,
        );
      } else if (widget.followMeMode == FollowMeMode.rotating) {
        // When switching to rotating mode, reset to north-up first - smooth animation
        _controller.animateTo(
          dest: _currentLatLng!,
          zoom: _controller.mapController.camera.zoom,
          rotation: 0.0,
          duration: kFollowMeAnimationDuration,
          curve: Curves.easeOut,
        );
      }
    }
  }

  Future<void> _initLocation() async {
    final perm = await Geolocator.requestPermission();
    if (perm == LocationPermission.denied ||
        perm == LocationPermission.deniedForever) return;

    _positionSub =
        Geolocator.getPositionStream().listen((Position position) {
      final latLng = LatLng(position.latitude, position.longitude);
      setState(() => _currentLatLng = latLng);
      
      // Back to original pattern - directly check widget parameter
      if (widget.followMeMode != FollowMeMode.off) {
        WidgetsBinding.instance.addPostFrameCallback((_) {
          if (mounted) {
            try {
              if (widget.followMeMode == FollowMeMode.northUp) {
                // Follow position only, keep current rotation - smooth animation
                _controller.animateTo(
                  dest: latLng,
                  zoom: _controller.mapController.camera.zoom,
                  duration: kFollowMeAnimationDuration,
                  curve: Curves.easeOut,
                );
              } else if (widget.followMeMode == FollowMeMode.rotating) {
                // Follow position and rotation based on heading - smooth animation
                final heading = position.heading;
                final speed = position.speed; // Speed in m/s
                
                // Only apply rotation if moving fast enough to avoid wild spinning when stationary
                final shouldRotate = !speed.isNaN && speed >= kMinSpeedForRotationMps && !heading.isNaN;
                final rotation = shouldRotate ? -heading : _controller.mapController.camera.rotation;
                
                _controller.animateTo(
                  dest: latLng,
                  zoom: _controller.mapController.camera.zoom,
                  rotation: rotation,
                  duration: kFollowMeAnimationDuration,
                  curve: Curves.easeOut,
                );
              }
            } catch (e) {
              debugPrint('MapController not ready yet: $e');
            }
          }
        });
      }
    });
  }

  double _safeZoom() {
    try {
      return _controller.mapController.camera.zoom;
    } catch (_) {
      return 15.0;
    }
  }

  /// Helper to check if two profile lists are equal
  bool _profileListsEqual(List<CameraProfile> list1, List<CameraProfile> list2) {
    if (list1.length != list2.length) return false;
    // Compare by profile IDs since profiles are value objects
    final ids1 = list1.map((p) => p.id).toSet();
    final ids2 = list2.map((p) => p.id).toSet();
    return ids1.length == ids2.length && ids1.containsAll(ids2);
  }

  /// Build tile layer - uses fake domain that SimpleTileHttpClient can parse
  Widget _buildTileLayer(AppState appState) {
    final selectedTileType = appState.selectedTileType;
    final selectedProvider = appState.selectedTileProvider;
    
    // Use fake domain with standard HTTPS scheme: https://tiles.local/provider/type/z/x/y
    // This naturally separates cache entries by provider and type while being HTTP-compatible
    final urlTemplate = 'https://tiles.local/${selectedProvider?.id ?? 'unknown'}/${selectedTileType?.id ?? 'unknown'}/{z}/{x}/{y}';
    
    return TileLayer(
      urlTemplate: urlTemplate,
      userAgentPackageName: 'com.stopflock.flock_map_app',
      tileProvider: NetworkTileProvider(
        httpClient: _tileHttpClient,
        // Enable flutter_map caching - cache busting handled by URL changes and FlutterMap key
      ),
    );
  }



  @override
  Widget build(BuildContext context) {
    final appState = context.watch<AppState>();
    final session = appState.session;
    final editSession = appState.editSession;

    // Check if enabled profiles changed and refresh cameras if needed
    final currentEnabledProfiles = appState.enabledProfiles;
    if (_lastEnabledProfiles == null || 
        !_profileListsEqual(_lastEnabledProfiles!, currentEnabledProfiles)) {
      _lastEnabledProfiles = List.from(currentEnabledProfiles);
      // Refresh cameras when profiles change
      WidgetsBinding.instance.addPostFrameCallback((_) {
        // Clear camera cache to ensure fresh data for new profile combination
        _cameraProvider.clearCache();
        // Force display refresh first (for immediate UI update)
        _cameraProvider.refreshDisplay();
        // Then fetch new cameras for newly enabled profiles
        _refreshCamerasFromProvider();
      });
    }

    // Check if tile type OR offline mode changed and clear cache if needed
    final currentTileTypeId = appState.selectedTileType?.id;
    final currentOfflineMode = appState.offlineMode;
    
    if ((_lastTileTypeId != null && _lastTileTypeId != currentTileTypeId) ||
        (_lastOfflineMode != null && _lastOfflineMode != currentOfflineMode)) {
      // Force map rebuild with new key to bust flutter_map cache
      _mapRebuildKey++;
      final reason = _lastTileTypeId != currentTileTypeId 
          ? 'tile type ($currentTileTypeId)' 
          : 'offline mode ($currentOfflineMode)';
      debugPrint('[MapView] *** CACHE CLEAR *** $reason changed - rebuilding map $_mapRebuildKey');
      WidgetsBinding.instance.addPostFrameCallback((_) {
        debugPrint('[MapView] Post-frame: Clearing tile request queue');
        _tileHttpClient.clearTileQueue();
      });
    }
    
    _lastTileTypeId = currentTileTypeId;
    _lastOfflineMode = currentOfflineMode;

    // Seed add‑mode target once, after first controller center is available.
    if (session != null && session.target == null) {
      try {
        final center = _controller.mapController.camera.center;
        WidgetsBinding.instance.addPostFrameCallback(
          (_) => appState.updateSession(target: center),
        );
      } catch (_) {/* controller not ready yet */}
    }
    
    // For edit sessions, center the map on the camera being edited initially
    if (editSession != null && _controller.mapController.camera.center != editSession.target) {
      WidgetsBinding.instance.addPostFrameCallback(
        (_) {
          try {
            _controller.mapController.move(editSession.target, _controller.mapController.camera.zoom);
          } catch (_) {/* controller not ready yet */}
        },
      );
    }

    final zoom = _safeZoom();
    // Fetch cached cameras for current map bounds (using Consumer so overlays redraw instantly)
    Widget cameraLayers = Consumer<CameraProviderWithCache>(
      builder: (context, cameraProvider, child) {
        LatLngBounds? mapBounds;
        try {
          mapBounds = _controller.mapController.camera.visibleBounds;
        } catch (_) {
          mapBounds = null;
        }
        final cameras = (mapBounds != null)
            ? cameraProvider.getCachedCamerasForBounds(mapBounds)
            : <OsmCameraNode>[];
        
        final markers = CameraMarkersBuilder.buildCameraMarkers(
          cameras: cameras,
          mapController: _controller.mapController,
          userLocation: _currentLatLng,
        );

        final overlays = DirectionConesBuilder.buildDirectionCones(
          cameras: cameras,
          zoom: zoom,
          session: session,
          editSession: editSession,
        );

        // Build edit lines connecting original cameras to their edited positions
        final editLines = _buildEditLines(cameras);

        return Stack(
          children: [
            PolygonLayer(polygons: overlays),
            if (editLines.isNotEmpty) PolylineLayer(polylines: editLines),
            MarkerLayer(markers: markers),
          ],
        );
      }
    );

    return Stack(
      children: [
        FlutterMap(
          key: ValueKey('map_${appState.offlineMode}_${appState.selectedTileType?.id ?? 'none'}_$_mapRebuildKey'),
          mapController: _controller.mapController,
          options: MapOptions(
            initialCenter: _currentLatLng ?? _initialLocation ?? LatLng(37.7749, -122.4194),
            initialZoom: _initialZoom ?? 15,
            maxZoom: 19,
            onPositionChanged: (pos, gesture) {
              setState(() {}); // Instant UI update for zoom, etc.
              if (gesture) widget.onUserGesture();
              if (session != null) {
                appState.updateSession(target: pos.center);
              }
              if (editSession != null) {
                appState.updateEditSession(target: pos.center);
              }
              
              // Show waiting indicator when map moves (user is expecting new content)
              NetworkStatus.instance.setWaiting();
              
              // Only clear tile queue on significant ZOOM changes (not panning)
              final currentZoom = pos.zoom;
              final zoomChanged = _lastZoom != null && (currentZoom - _lastZoom!).abs() > 0.5;
              
              if (zoomChanged) {
                _tileDebounce(() {
                  // Clear stale tile requests on zoom change (quietly)
                  _tileHttpClient.clearTileQueue();
                });
              }
              _lastZoom = currentZoom;
              
              // Save map position (debounced to avoid excessive writes)
              _mapPositionDebounce(() {
                // Only save if position and zoom are valid
                if (_isValidCoordinate(pos.center.latitude) && 
                    _isValidCoordinate(pos.center.longitude) && 
                    _isValidZoom(pos.zoom)) {
                  _saveLastMapPosition(pos.center, pos.zoom);
                }
              });
              
              // Request more cameras on any map movement/zoom at valid zoom level (slower debounce)
              if (pos.zoom >= 10) {
                _cameraDebounce(_refreshCamerasFromProvider);
              }
            },
          ),
          children: [
            _buildTileLayer(appState),
            cameraLayers,
            // Built-in scale bar from flutter_map 
            Scalebar(
              alignment: Alignment.bottomLeft,
              padding: EdgeInsets.only(left: 8, bottom: kScaleBarBottomOffset), // from dev_config
              textStyle: TextStyle(color: Colors.black, fontWeight: FontWeight.bold),
              lineColor: Colors.black,
              strokeWidth: 3,
              // backgroundColor removed in flutter_map >=8 (wrap in Container if needed)
            ),
          ],
        ),

        // All map overlays (mode indicator, zoom, attribution, add pin)
        MapOverlays(
          mapController: _controller.mapController,
          uploadMode: appState.uploadMode,
          session: session,
          editSession: editSession,
          attribution: appState.selectedTileType?.attribution,
        ),

        // Network status indicator (top-left)
        const NetworkStatusIndicator(),
      ],
    );
  }

  /// Build polylines connecting original cameras to their edited positions
  List<Polyline> _buildEditLines(List<OsmCameraNode> cameras) {
    final lines = <Polyline>[];
    
    // Create a lookup map of original node IDs to their coordinates
    final originalNodes = <int, LatLng>{};
    for (final camera in cameras) {
      if (camera.tags['_pending_edit'] == 'true') {
        originalNodes[camera.id] = camera.coord;
      }
    }
    
    // Find edited cameras and draw lines to their originals
    for (final camera in cameras) {
      final originalIdStr = camera.tags['_original_node_id'];
      if (originalIdStr != null && camera.tags['_pending_upload'] == 'true') {
        final originalId = int.tryParse(originalIdStr);
        final originalCoord = originalId != null ? originalNodes[originalId] : null;
        
        if (originalCoord != null) {
          lines.add(Polyline(
            points: [originalCoord, camera.coord],
            color: kCameraRingColorPending,
            strokeWidth: 3.0,
          ));
        }
      }
    }
    
    return lines;
  }
}