"""
Backend Controller for FilterMate.

Manages the backend indicator widget and selection menu.
Extracted from filter_mate_dockwidget.py (lines 1612-1966, 2945-3100, 12503-12650).

Story: MIG-071
Phase: 6 - God Class DockWidget Migration
"""

from typing import TYPE_CHECKING, Optional, List, Tuple, Dict
import logging

from qgis.PyQt.QtCore import pyqtSignal
from qgis.PyQt.QtWidgets import QMenu, QLabel
from qgis.PyQt.QtGui import QCursor
from qgis.core import QgsVectorLayer

from .base_controller import BaseController
from ...infrastructure.database.sql_utils import sanitize_sql_identifier

if TYPE_CHECKING:
    from filter_mate_dockwidget import FilterMateDockWidget

logger = logging.getLogger(__name__)


# Backend display configuration - v4.0: Softer "mousse" colors
BACKEND_STYLES = {
    'postgresql': {
        'text': 'PostgreSQL',
        'color': 'white',
        'background': '#58d68d',  # Softer green
        'icon': '🐘',
        'tooltip': 'Backend: PostgreSQL (High Performance)'
    },
    'spatialite': {
        'text': 'Spatialite',
        'color': 'white',
        'background': '#bb8fce',  # Softer purple
        'icon': '💾',
        'tooltip': 'Backend: Spatialite (Good Performance)'
    },
    'spatialite_fallback': {
        'text': 'Spatialite*',
        'color': 'white',
        'background': '#a569bd',  # Softer dark purple
        'icon': '💾',
        'tooltip': 'Backend: Spatialite → OGR fallback\n(Complex geometry handled by OGR)'
    },
    'ogr': {
        'text': 'OGR',
        'color': 'white',
        'background': '#5dade2',  # Softer blue
        'icon': '📁',
        'tooltip': 'Backend: OGR (Universal)'
    },
    'ogr_fallback': {
        'text': 'OGR*',
        'color': 'white',
        'background': '#f0b27a',  # Softer orange
        'icon': '📁',
        'tooltip': 'Backend: OGR (Fallback - Connection unavailable)'
    },
    'postgresql_fallback': {
        'text': 'PostgreSQL*',
        'color': 'white',
        'background': '#45b39d',  # Softer teal green
        'icon': '🐘',
        'tooltip': 'Backend: PostgreSQL → OGR fallback'
    },
    'unknown': {
        'text': '...',
        'color': '#7f8c8d',
        'background': '#f4f6f6',  # Softer light gray
        'icon': '❓',
        'tooltip': 'Backend: Unknown'
    }
}


class BackendController(BaseController):
    """
    Controller for backend indicator management.

    Handles:
    - Backend indicator display and styling
    - Backend selection menu
    - Backend switching per layer
    - Optimization settings
    - PostgreSQL maintenance options

    Signals:
        backend_changed: Emitted when backend is switched
        reload_requested: Emitted when user wants to reload layers

    Example:
        controller = BackendController(dockwidget)
        controller.setup()

        # React to backend changes
        controller.backend_changed.connect(on_backend_changed)
    """

    backend_changed = pyqtSignal(str, str)  # (layer_id, backend_name)
    reload_requested = pyqtSignal()

    def __init__(self, dockwidget: 'FilterMateDockWidget') -> None:
        """
        Initialize the backend controller.

        Args:
            dockwidget: Main dockwidget reference
        """
        super().__init__(dockwidget)
        self._forced_backends: Dict[str, str] = {}
        self._current_provider_type: Optional[str] = None
        self._current_postgresql_available: Optional[bool] = None
        self._indicator_label: Optional[QLabel] = None
        self._initialized: bool = False
        # Optimization settings
        self._optimization_enabled: bool = True
        self._centroid_auto_enabled: bool = True
        self._optimization_ask_before: bool = True

    def _tr(self, text: str) -> str:
        """Translate text using dockwidget's tr() if available."""
        if self.dockwidget and hasattr(self.dockwidget, 'tr'):
            return self.dockwidget.tr(text)
        return text

    @property
    def forced_backends(self) -> Dict[str, str]:
        """Get dictionary of forced backends by layer ID."""
        return self._forced_backends

    def setup(self) -> None:
        """
        Setup backend indicator widget.

        Finds and configures the backend indicator label from dockwidget.
        """
        self._find_indicator_label()
        self._sync_with_dockwidget()
        self._initialized = True
        logger.debug("BackendController setup complete")

    def teardown(self) -> None:
        """Clean up resources."""
        self._forced_backends.clear()
        super().teardown()

    def on_tab_activated(self) -> None:
        """Handle tab activation."""
        super().on_tab_activated()
        # Refresh indicator for current layer
        if self.dockwidget.current_layer:
            self.update_for_layer(self.dockwidget.current_layer)

    def on_tab_deactivated(self) -> None:
        """Handle tab deactivation."""
        super().on_tab_deactivated()

    # === Public API ===

    def update_for_layer(
        self,
        layer: QgsVectorLayer,
        postgresql_connection_available: Optional[bool] = None,
        actual_backend: Optional[str] = None
    ) -> None:
        """
        Update indicator for current layer.

        Args:
            layer: Current QgsVectorLayer
            postgresql_connection_available: Whether PostgreSQL connection is available
            actual_backend: Forced backend name, if any
        """
        if not layer or not layer.isValid():
            self._update_indicator_display('unknown')
            return

        provider_type = layer.providerType()
        self._current_provider_type = provider_type
        self._current_postgresql_available = postgresql_connection_available

        # Determine actual backend type
        backend_type = self._detect_backend_for_layer(
            layer, postgresql_connection_available, actual_backend
        )

        # Check if forced
        is_forced = (actual_backend is not None) or (layer.id() in self._forced_backends)

        self._update_indicator_display(backend_type, is_forced, layer)

    def get_available_backends_for_layer(
        self,
        layer: QgsVectorLayer
    ) -> List[Tuple[str, str, str]]:
        """
        Get list of available backends for the given layer.

        Args:
            layer: QgsVectorLayer to check

        Returns:
            List of tuples: (backend_type, backend_name, backend_icon)
        """
        from ...adapters.backends import POSTGRESQL_AVAILABLE

        available = []
        provider_type = layer.providerType()

        # PostgreSQL backend (only for postgres layers with psycopg2 available)
        if provider_type == 'postgres':
            try:
                if POSTGRESQL_AVAILABLE:
                    available.append(('postgresql', 'PostgreSQL', '🐘'))
            except ImportError:
                pass

        # Spatialite backend (for spatialite layers and some OGR layers)
        if provider_type in ['spatialite', 'ogr']:
            source = layer.source()
            if 'gpkg' in source.lower() or 'sqlite' in source.lower() or provider_type == 'spatialite':
                available.append(('spatialite', 'Spatialite', '💾'))

        # OGR backend (always available as fallback)
        available.append(('ogr', 'OGR', '📁'))

        # Remove current backend to show only alternatives (keep at least one)
        if len(available) > 1:
            current_backend = self.get_current_backend(layer)
            available = [b for b in available if b[0] != current_backend]

        return available

    def get_current_backend(self, layer: QgsVectorLayer) -> str:
        """
        Get the current backend for a layer.

        Args:
            layer: Layer to check

        Returns:
            Backend type string ('postgresql', 'spatialite', 'ogr')
        """
        # Check forced backend first
        if layer.id() in self._forced_backends:
            return self._forced_backends[layer.id()]

        # Auto-detection
        return self._detect_backend_for_layer(layer, self._current_postgresql_available)

    def set_forced_backend(
        self,
        layer_id: str,
        backend_type: Optional[str]
    ) -> None:
        """
        Force a specific backend for a layer.

        Args:
            layer_id: Layer ID
            backend_type: Backend type to force, or None for auto
        """
        if backend_type is None:
            if layer_id in self._forced_backends:
                del self._forced_backends[layer_id]
                logger.debug(f"Removed forced backend for layer {layer_id}")
        else:
            self._forced_backends[layer_id] = backend_type
            logger.debug(f"Forced backend {backend_type} for layer {layer_id}")

        # Sync with dockwidget
        if hasattr(self.dockwidget, 'forced_backends'):
            self.dockwidget.forced_backends = self._forced_backends.copy()

        # Update indicator display if this is the current layer
        current_layer = self.dockwidget.current_layer
        if current_layer and current_layer.id() == layer_id:
            display_backend = backend_type if backend_type else self._detect_backend_for_layer(
                current_layer, self._current_postgresql_available
            )
            self._update_indicator_display(display_backend, is_forced=(backend_type is not None), layer=current_layer)

        self.backend_changed.emit(layer_id, backend_type or 'auto')

    def force_backend_for_all_layers(self, backend_type: str) -> int:
        """
        Force a specific backend for all layers in the project.

        Args:
            backend_type: Backend type to force

        Returns:
            Number of layers updated
        """
        from qgis.core import QgsProject

        project = QgsProject.instance()
        layers = project.mapLayers().values()

        count = 0
        for layer in layers:
            if isinstance(layer, QgsVectorLayer) and layer.isValid():
                self.set_forced_backend(layer.id(), backend_type)
                count += 1

        logger.debug(f"Forced {backend_type} backend for {count} layers")
        return count

    def auto_select_optimal_backends(self) -> int:
        """
        Auto-select optimal backend for each layer based on characteristics.

        v4.0 Sprint 1: Full implementation migrated from dockwidget.

        Analyzes each layer's characteristics and sets the most appropriate backend:
        - PostgreSQL for large server-side datasets
        - Spatialite for SQLite/GeoPackage with > 5000 features
        - OGR for small datasets and file-based formats

        Returns:
            Number of layers optimized
        """
        from qgis.core import QgsProject

        project = QgsProject.instance()
        layers = project.mapLayers().values()

        optimized_count = 0
        skipped_count = 0
        backend_stats = {'postgresql': 0, 'spatialite': 0, 'ogr': 0, 'auto': 0}

        logger.info("=" * 60)
        logger.debug("AUTO-SELECTING OPTIMAL BACKENDS FOR ALL LAYERS")
        logger.info("=" * 60)

        for layer in layers:
            # Skip non-vector layers
            if not isinstance(layer, QgsVectorLayer):
                continue

            if not layer.isValid():
                skipped_count += 1
                continue

            layer_name = layer.name()
            logger.info(f"\nAnalyzing layer: {layer_name}")

            # Get optimal backend for this layer
            optimal_backend = self._get_optimal_backend_for_layer(layer)

            if optimal_backend:
                # Verify backend supports layer
                if self._verify_backend_supports_layer(layer, optimal_backend):
                    self.set_forced_backend(layer.id(), optimal_backend)
                    backend_stats[optimal_backend] += 1
                    optimized_count += 1
                    logger.info(f"  ✓ Set backend to: {optimal_backend.upper()}")
                else:
                    backend_stats['auto'] += 1
                    logger.info(f"  ⚠ Backend {optimal_backend.upper()} not compatible - using auto")
            else:
                backend_stats['auto'] += 1
                logger.info("  → Using auto-selection")

        logger.info("\n" + "=" * 60)
        logger.info("AUTO-SELECTION COMPLETE")
        logger.info(f"Optimized: {optimized_count} layers")
        logger.info(f"Skipped: {skipped_count} invalid layers")
        logger.info("Backend distribution:")
        for backend, count in backend_stats.items():
            if count > 0:
                logger.info(f"  - {backend.upper()}: {count} layer(s)")
        logger.info("=" * 60)

        # Emit signal with summary (requires 2 args: layer_id, backend_type)
        self.backend_changed.emit("batch_optimization", f"Optimized {optimized_count} layers")

        return optimized_count

    def _get_optimal_backend_for_layer(self, layer: QgsVectorLayer) -> Optional[str]:
        """
        Determine optimal backend for a layer based on characteristics.

        Args:
            layer: QgsVectorLayer instance

        Returns:
            Optimal backend ('postgresql', 'spatialite', 'ogr') or None for auto
        """
        try:
            from ...adapters.backends import POSTGRESQL_AVAILABLE
            from ...infrastructure.utils import detect_layer_provider_type
        except ImportError:
            logger.warning("Could not import backend detection functions")
            return None

        if not layer or not layer.isValid():
            return None

        provider_type = detect_layer_provider_type(layer)
        feature_count = layer.featureCount()
        source = layer.source().lower()

        logger.debug(f"  Provider: {provider_type}, Features: {feature_count:,}")
        logger.debug(f"  PostgreSQL available: {POSTGRESQL_AVAILABLE}")

        # PostgreSQL layers - ALWAYS use PostgreSQL backend (v4.1.4)
        # FIX v4.1.4: QGIS native API (setSubsetString) works without psycopg2
        # Never fallback to OGR for PostgreSQL layers
        if provider_type == 'postgresql':
            if not POSTGRESQL_AVAILABLE:
                logger.debug("  → PostgreSQL (QGIS native API) - psycopg2 not available for advanced features")
            else:
                logger.debug(f"  → PostgreSQL ({feature_count:,} features) - Full backend")
            return 'postgresql'

        # SQLite/Spatialite layers
        elif provider_type == 'spatialite':
            if feature_count > 5000:
                logger.debug(f"  → SQLite ({feature_count}) - Spatialite R-tree optimal")
                return 'spatialite'
            else:
                logger.debug(f"  → Small SQLite ({feature_count}) - OGR sufficient")
                return 'ogr'

        # OGR layers
        elif provider_type == 'ogr':
            if 'gpkg' in source or 'sqlite' in source:
                if feature_count > 5000:
                    logger.debug(f"  → GeoPackage ({feature_count}) - Spatialite optimal")
                    return 'spatialite'
                else:
                    logger.debug(f"  → Small GeoPackage ({feature_count}) - OGR sufficient")
                    return 'ogr'

            logger.debug(f"  → OGR format ({feature_count}) - OGR sufficient")
            return 'ogr'

        logger.debug(f"  → Unknown provider '{provider_type}' - auto-selection")
        return None

    def _verify_backend_supports_layer(self, layer: QgsVectorLayer, backend: str) -> bool:
        """
        Verify that a backend can actually process the layer.

        Args:
            layer: Layer to check
            backend: Backend type to verify

        Returns:
            True if backend supports this layer
        """
        try:
            from ...infrastructure.utils import detect_layer_provider_type, POSTGRESQL_AVAILABLE
        except ImportError:
            return True  # Assume compatible if can't check

        provider_type = detect_layer_provider_type(layer)

        if backend == 'postgresql':
            # PostgreSQL backend only for PostgreSQL layers
            return provider_type == 'postgresql' and POSTGRESQL_AVAILABLE
        elif backend == 'spatialite':
            # Spatialite works with SQLite and GeoPackage
            source = layer.source().lower()
            return provider_type == 'spatialite' or 'gpkg' in source or 'sqlite' in source
        elif backend == 'ogr':
            # OGR is universal fallback
            return True

        return False

    def handle_indicator_clicked(self) -> None:
        """
        Handle click on backend indicator.

        Shows backend selection menu or triggers reload if no layers.
        """

        # Lazy initialization fallback
        if not self._initialized:
            self.setup()

        # Check if in waiting state (no layers)
        if self._indicator_label:
            text = self._indicator_label.text()
            if text in ('...', '⟳'):
                logger.info("Backend indicator clicked in waiting state - requesting reload")
                self.reload_requested.emit()
                return

        current_layer = self.dockwidget.current_layer
        if not current_layer:
            self.reload_requested.emit()
            return

        self._show_backend_menu(current_layer)

    # === Private Methods ===

    def _find_indicator_label(self) -> None:
        """Find the backend indicator label in dockwidget."""
        if hasattr(self.dockwidget, 'backend_indicator_label') and self.dockwidget.backend_indicator_label:
            self._indicator_label = self.dockwidget.backend_indicator_label
            logger.debug(f"BackendController: Found indicator label: {self._indicator_label}")
        else:
            logger.debug("BackendController: backend_indicator_label not found in dockwidget")

    def _sync_with_dockwidget(self) -> None:
        """Sync state with dockwidget attributes."""
        # Sync forced backends
        if hasattr(self.dockwidget, 'forced_backends'):
            self._forced_backends = self.dockwidget.forced_backends.copy()

        # Sync optimization settings
        for attr in ('_optimization_enabled', '_centroid_auto_enabled', '_optimization_ask_before'):
            if hasattr(self.dockwidget, attr):
                setattr(self, attr, getattr(self.dockwidget, attr))

    def _detect_backend_for_layer(
        self,
        layer: QgsVectorLayer,
        postgresql_available: Optional[bool] = None,
        forced_backend: Optional[str] = None
    ) -> str:
        """
        Detect which backend should be used for a layer.

        Args:
            layer: Layer to analyze
            postgresql_available: PostgreSQL connection status
            forced_backend: Explicitly forced backend

        Returns:
            Backend type string
        """
        # Check forced backend
        if forced_backend:
            return forced_backend.lower()

        if layer.id() in self._forced_backends:
            return self._forced_backends[layer.id()].lower()

        # Auto-detection
        # FIX v4.1.4 (2026-01-21): PostgreSQL layers ALWAYS use PostgreSQL backend.
        # QGIS native API (setSubsetString) works without psycopg2.
        provider_type = layer.providerType()

        # PostgreSQL layers ALWAYS use PostgreSQL backend
        if provider_type == 'postgres':
            return 'postgresql'
        elif provider_type == 'spatialite':
            return 'spatialite'
        elif provider_type == 'ogr':
            # Check for GeoPackage/SQLite with Spatialite support
            source = layer.source().split('|')[0]
            if source.lower().endswith(('.gpkg', '.sqlite')):
                return 'spatialite'
            return 'ogr'
        else:
            return 'unknown'

    def _update_indicator_display(
        self,
        backend_type: str,
        is_forced: bool = False,
        layer: Optional[QgsVectorLayer] = None
    ) -> None:
        """
        Update the visual display of the backend indicator.

        Args:
            backend_type: Backend type to display
            is_forced: Whether backend is forced by user
            layer: Current layer for context
        """
        # Try to find indicator label if not set
        if not self._indicator_label:
            self._find_indicator_label()

        # Still no indicator label? Try direct access to dockwidget's label
        if not self._indicator_label:
            if hasattr(self.dockwidget, 'backend_indicator_label') and self.dockwidget.backend_indicator_label:
                self._indicator_label = self.dockwidget.backend_indicator_label
                logger.debug("Found backend_indicator_label via direct dockwidget access")
            else:
                logger.warning("BackendController: _indicator_label not found, cannot update display")
                return

        style = BACKEND_STYLES.get(backend_type, BACKEND_STYLES['unknown'])

        # Build text with forced indicator
        text = style['text']
        if is_forced:
            text = f"{text}⚡"

        self._indicator_label.setText(text)

        # Build stylesheet - v4.0: Soft "mousse" style with smoother appearance
        stylesheet = (
            f"QLabel#label_backend_indicator {{"
            f"  color: {style['color']};"
            f"  background-color: {style['background']};"
            f"  font-size: 8pt; font-weight: 500;"
            f"  padding: 2px 8px; border-radius: 10px; border: none;"
            f"}}"
            f"QLabel#label_backend_indicator:hover {{"
            f"  background-color: {style['background']};"
            f"}}"
        )
        self._indicator_label.setStyleSheet(stylesheet)

        # Build tooltip with context
        tooltip = style['tooltip']
        if layer:
            feature_count = layer.featureCount()
            tooltip += f"\nLayer: {layer.name()} ({feature_count:,} features)"
        if is_forced:
            tooltip += "\n⚡ Manually forced"

        self._indicator_label.setToolTip(tooltip)

    def _refresh_indicator_for_current_layer(self) -> None:
        """
        Refresh the backend indicator for the current layer.

        This method ensures the indicator is updated after batch operations
        (like force_backend_for_all_layers or auto_select_optimal_backends).
        """
        current_layer = self.dockwidget.current_layer
        if not current_layer or not current_layer.isValid():
            return

        # Get the backend for current layer (may have been changed by batch operation)
        backend_type = self._detect_backend_for_layer(
            current_layer, self._current_postgresql_available
        )

        # Check if forced
        is_forced = current_layer.id() in self._forced_backends

        # Update the display
        self._update_indicator_display(backend_type, is_forced, current_layer)
        logger.debug(f"Refreshed indicator for layer {current_layer.name()}: {backend_type} (forced: {is_forced})")

    def _show_backend_menu(self, layer: QgsVectorLayer) -> None:
        """
        Show the backend selection menu.

        Args:
            layer: Current layer for backend selection
        """
        from ...infrastructure.feedback import show_info, show_success, show_warning

        available = self.get_available_backends_for_layer(layer)

        if not available:
            show_warning("FilterMate", self._tr("No alternative backends available for this layer"))
            return

        menu = QMenu(self.dockwidget)
        menu.setStyleSheet("""
            QMenu {
                background-color: white;
                border: 1px solid #cccccc;
                padding: 5px;
            }
            QMenu::item {
                padding: 5px 20px;
            }
            QMenu::item:selected {
                background-color: #3498db;
                color: white;
            }
        """)

        # Header
        header = menu.addAction(self._tr("Select Backend:"))
        header.setEnabled(False)
        menu.addSeparator()

        # Available backends
        current_forced = self._forced_backends.get(layer.id())
        for backend_type, backend_name, backend_icon in available:
            action_text = f"{backend_icon} {backend_name}"
            if current_forced == backend_type:
                action_text += " ✓"
            action = menu.addAction(action_text)
            action.setData(backend_type)

        menu.addSeparator()

        # Auto option
        auto_action = menu.addAction("⚙️ " + self._tr("Auto (Default)"))
        auto_action.setData(None)
        if not current_forced:
            auto_action.setText(auto_action.text() + " ✓")

        menu.addSeparator()

        # Auto-select all
        auto_all_action = menu.addAction("🎯 " + self._tr("Auto-select Optimal for All Layers"))
        auto_all_action.setData('__AUTO_ALL__')

        # Force all
        current_backend = self.get_current_backend(layer)
        force_all_action = menu.addAction("🔒 " + self._tr("Force {0} for All Layers").format(current_backend.upper()))
        force_all_action.setData('__FORCE_ALL__')

        menu.addSeparator()

        # Cleanup Temp Tables submenu
        cleanup_menu = menu.addMenu("🧹 " + self._tr("Clear Temp Tables"))

        # Project cleanup
        project_cleanup_action = cleanup_menu.addAction(self._tr("📁 Current Project"))
        project_cleanup_action.setData('__CLEANUP_PROJECT__')
        project_cleanup_action.setToolTip(self._tr("Clear temporary tables for the current project only"))

        # Global cleanup
        global_cleanup_action = cleanup_menu.addAction(self._tr("🌐 All Projects (Global)"))
        global_cleanup_action.setData('__CLEANUP_GLOBAL__')
        global_cleanup_action.setToolTip(self._tr("Clear ALL FilterMate temporary tables from all databases"))

        # Show menu
        selected_action = menu.exec_(QCursor.pos())

        if selected_action:
            data = selected_action.data()

            if data == '__AUTO_ALL__':
                count = self.auto_select_optimal_backends()
                show_success("FilterMate", self._tr("Auto-selected backends for {0} layer(s)").format(count))
                # Update indicator for current layer after batch operation
                self._refresh_indicator_for_current_layer()
            elif data == '__FORCE_ALL__':
                count = self.force_backend_for_all_layers(current_backend)
                show_success("FilterMate", self._tr("Forced {0} backend for {1} layer(s)").format(current_backend.upper(), count))
                # Update indicator for current layer after batch operation
                self._refresh_indicator_for_current_layer()
            elif data == '__CLEANUP_PROJECT__':
                count = self.cleanup_temp_tables_project()
                if count > 0:
                    show_success("FilterMate", self._tr("Cleared {0} temporary table(s) for current project").format(count))
                else:
                    show_info("FilterMate", self._tr("No temporary tables found for current project"))
            elif data == '__CLEANUP_GLOBAL__':
                count = self.cleanup_temp_tables_global()
                if count > 0:
                    show_success("FilterMate", self._tr("Cleared {0} temporary table(s) globally").format(count))
                else:
                    show_info("FilterMate", self._tr("No temporary tables found"))
            else:
                self.set_forced_backend(layer.id(), data)
                if data:
                    self.update_for_layer(layer, actual_backend=data)
                    show_success("FilterMate", self._tr("Backend forced to {0} for '{1}'").format(data.upper(), layer.name()))
                else:
                    self.update_for_layer(layer)
                    show_info("FilterMate", self._tr("Backend set to Auto for '{0}'").format(layer.name()))

    # === Optimization Settings ===

    @property
    def optimization_enabled(self) -> bool:
        """Whether auto-optimization is enabled."""
        return self._optimization_enabled

    @optimization_enabled.setter
    def optimization_enabled(self, value: bool) -> None:
        """Set optimization enabled state."""
        self._optimization_enabled = value
        if hasattr(self.dockwidget, '_optimization_enabled'):
            self.dockwidget._optimization_enabled = value

    @property
    def centroid_auto_enabled(self) -> bool:
        """Whether centroid auto-detection is enabled."""
        return self._centroid_auto_enabled

    @centroid_auto_enabled.setter
    def centroid_auto_enabled(self, value: bool) -> None:
        """Set centroid auto-detection enabled state."""
        self._centroid_auto_enabled = value
        if hasattr(self.dockwidget, '_centroid_auto_enabled'):
            self.dockwidget._centroid_auto_enabled = value

    def toggle_optimization_enabled(self) -> bool:
        """Toggle optimization enabled state."""
        self.optimization_enabled = not self.optimization_enabled
        return self.optimization_enabled

    def toggle_centroid_auto(self) -> bool:
        """Toggle centroid auto-detection."""
        self.centroid_auto_enabled = not self.centroid_auto_enabled
        return self.centroid_auto_enabled

    # ========================================
    # POSTGRESQL MAINTENANCE METHODS (Sprint 13)
    # ========================================

    def get_pg_session_context(self):
        """
        Get PostgreSQL session context for maintenance operations.

        v4.0 Sprint 13: Migrated from dockwidget._get_pg_session_context()
        v4.3.8 (2026-01-23): Also search QGIS project layers for connection

        Returns:
            tuple: (app, session_id, schema, connexion)
        """
        from ...adapters.backends import POSTGRESQL_AVAILABLE
        if not POSTGRESQL_AVAILABLE:
            return None, None, None, None

        try:
            from ...infrastructure.utils.layer_utils import get_datasource_connexion_from_layer
        except ImportError:
            from ...infrastructure.utils.layer_utils import get_datasource_connexion_from_layer

        # Get app reference
        app = getattr(self.dockwidget, '_app_ref', None)
        if not app:
            parent = self.dockwidget.parent()
            while parent:
                if hasattr(parent, 'session_id'):
                    app = parent
                    break
                parent = parent.parent() if hasattr(parent, 'parent') else None

        session_id = getattr(app, 'session_id', None) if app else None
        schema = getattr(app, 'app_postgresql_temp_schema', 'filter_mate_temp') if app else 'filter_mate_temp'

        # Find a PostgreSQL connection
        connexion = None

        # 1. First try PROJECT_LAYERS (registered layers)
        project_layers = getattr(app, 'PROJECT_LAYERS', {}) if app else {}
        for layer_info in project_layers.values():
            layer = layer_info.get('layer')
            if layer and layer.isValid() and layer.providerType() == 'postgres':
                connexion, _ = get_datasource_connexion_from_layer(layer)
                if connexion:
                    break

        # 2. FIX v4.3.8: If no connection found, search ALL QGIS project layers
        # This handles cases where PostgreSQL layers exist but aren't in PROJECT_LAYERS
        if not connexion:
            from qgis.core import QgsProject
            for layer in QgsProject.instance().mapLayers().values():
                if hasattr(layer, 'providerType') and layer.providerType() == 'postgres':
                    if layer.isValid():
                        connexion, _ = get_datasource_connexion_from_layer(layer)
                        if connexion:
                            logger.debug(f"Got PostgreSQL connection from QGIS layer: {layer.name()}")
                            break

        return app, session_id, schema, connexion

    @property
    def pg_auto_cleanup_enabled(self) -> bool:
        """Whether PostgreSQL auto-cleanup is enabled."""
        return getattr(self, '_pg_auto_cleanup_enabled', True)

    @pg_auto_cleanup_enabled.setter
    def pg_auto_cleanup_enabled(self, value: bool) -> None:
        """Set PostgreSQL auto-cleanup enabled state."""
        self._pg_auto_cleanup_enabled = value
        if hasattr(self.dockwidget, '_pg_auto_cleanup_enabled'):
            self.dockwidget._pg_auto_cleanup_enabled = value

    def toggle_pg_auto_cleanup(self) -> bool:
        """
        Toggle PostgreSQL auto-cleanup.

        v4.0 Sprint 13: Migrated from dockwidget._toggle_pg_auto_cleanup()

        Returns:
            bool: New state of pg_auto_cleanup
        """
        self.pg_auto_cleanup_enabled = not self.pg_auto_cleanup_enabled
        return self.pg_auto_cleanup_enabled

    def cleanup_postgresql_session_views(self) -> bool:
        """
        Cleanup PostgreSQL materialized views for current session.

        v4.0 Sprint 13: Migrated from dockwidget._cleanup_postgresql_session_views()

        Returns:
            bool: True if cleanup successful
        """
        app, session_id, schema, connexion = self.get_pg_session_context()

        if not connexion:
            logger.warning("cleanup_postgresql_session_views: No PostgreSQL connection available")
            return False

        if not session_id:
            logger.warning("cleanup_postgresql_session_views: Session ID not available")
            return False

        try:
            with connexion.cursor() as cursor:
                # Find views for this session (unified fm_temp_* prefix v4.4.4)
                # Also check legacy mv_ prefix for backward compatibility
                cursor.execute(
                    """SELECT matviewname FROM pg_matviews
                       WHERE schemaname = %s
                       AND (matviewname LIKE %s OR matviewname LIKE %s)""",
                    (schema, f"fm_temp_mv_{session_id}_%", f"mv_{session_id}_%")
                )
                views = [v[0] for v in cursor.fetchall()]

                if not views:
                    logger.info(f"No views found for session {session_id[:8]}")
                    return True

                # Drop each view
                safe_schema = sanitize_sql_identifier(schema)
                for view in views:
                    try:
                        safe_view = sanitize_sql_identifier(view)
                        cursor.execute(f'DROP MATERIALIZED VIEW IF EXISTS "{safe_schema}"."{safe_view}" CASCADE;')
                    except Exception as e:
                        logger.warning(f"Failed to drop view {view}: {e}")

                connexion.commit()
                logger.info(f"Cleaned up {len(views)} view(s) for session {session_id[:8]}")
                return True

        except Exception as e:
            logger.error(f"Error cleaning PostgreSQL session views: {e}")
            return False
        finally:
            try:
                connexion.close()
            except Exception:
                pass

    def cleanup_postgresql_schema_if_empty(self, force: bool = False) -> bool:
        """
        Drop PostgreSQL schema if no other sessions are using it.

        v4.0 Sprint 13: Migrated from dockwidget._cleanup_postgresql_schema_if_empty()

        Args:
            force: If True, skip confirmation for views from other sessions

        Returns:
            bool: True if cleanup successful or schema doesn't exist
        """
        app, session_id, schema, connexion = self.get_pg_session_context()

        if not connexion:
            logger.warning("cleanup_postgresql_schema_if_empty: No PostgreSQL connection available")
            return False

        try:
            with connexion.cursor() as cursor:
                # Check if schema exists
                cursor.execute(
                    "SELECT COUNT(*) FROM information_schema.schemata WHERE schema_name = %s",
                    (schema,)
                )
                if cursor.fetchone()[0] == 0:
                    logger.info(f"Schema '{schema}' does not exist")
                    return True

                # Get all views in schema
                cursor.execute(
                    "SELECT matviewname FROM pg_matviews WHERE schemaname = %s",
                    (schema,)
                )
                views = [v[0] for v in cursor.fetchall()]

                # Check for views from other sessions (handle both new and legacy prefixes)
                other_views = [v for v in views if not (
                    session_id and (
                        v.startswith(f"fm_temp_mv_{session_id}_") or
                        v.startswith(f"mv_{session_id}_")
                    )
                )]

                if other_views and not force:
                    logger.warning(f"Schema '{schema}' has {len(other_views)} view(s) from other sessions")
                    return False

                # Drop schema
                safe_schema = sanitize_sql_identifier(schema)
                cursor.execute(f'DROP SCHEMA IF EXISTS "{safe_schema}" CASCADE;')
                connexion.commit()
                logger.info(f"Schema '{schema}' dropped successfully")
                return True

        except Exception as e:
            logger.error(f"Error cleaning PostgreSQL schema: {e}")
            return False
        finally:
            try:
                connexion.close()
            except Exception:
                pass

    def get_postgresql_session_info(self) -> dict:
        """
        Get PostgreSQL session information.

        v4.0 Sprint 13: Migrated from dockwidget._show_postgresql_session_info()

        Returns:
            dict: Session information with keys: session_id, schema, auto_cleanup,
                  schema_exists, our_views_count, total_views_count, connection_available
        """
        app, session_id, schema, connexion = self.get_pg_session_context()

        info = {
            'session_id': session_id,
            'schema': schema,
            'auto_cleanup': self.pg_auto_cleanup_enabled,
            'connection_available': connexion is not None,
            'schema_exists': False,
            'our_views_count': 0,
            'total_views_count': 0
        }

        if connexion:
            try:
                with connexion.cursor() as cursor:
                    # Count our views (both new and legacy prefixes)
                    if session_id:
                        cursor.execute(
                            """SELECT COUNT(*) FROM pg_matviews
                               WHERE schemaname = %s
                               AND (matviewname LIKE %s OR matviewname LIKE %s)""",
                            (schema, f"fm_temp_mv_{session_id}_%", f"mv_{session_id}_%")
                        )
                        info['our_views_count'] = cursor.fetchone()[0]

                    # Count total views
                    cursor.execute(
                        "SELECT COUNT(*) FROM pg_matviews WHERE schemaname = %s",
                        (schema,)
                    )
                    info['total_views_count'] = cursor.fetchone()[0]

                    # Check schema exists
                    cursor.execute(
                        "SELECT COUNT(*) FROM information_schema.schemata WHERE schema_name = %s",
                        (schema,)
                    )
                    info['schema_exists'] = cursor.fetchone()[0] > 0

            except Exception as e:
                info['error'] = str(e)[:50]
                logger.warning(f"Error getting PostgreSQL session info: {e}")
            finally:
                try:
                    connexion.close()
                except Exception:
                    pass

        return info

    # ========================================
    # TEMP TABLE CLEANUP METHODS (v4.0)
    # ========================================

    def cleanup_temp_tables_project(self) -> int:
        """
        Clean up temporary tables for the current project only.

        Cleans both PostgreSQL materialized views and Spatialite temp tables
        associated with the current session/project.

        Returns:
            int: Total number of tables cleaned up
        """
        total_count = 0

        # 1. Clean PostgreSQL views for current session
        pg_count = self._cleanup_postgresql_current_session()
        total_count += pg_count

        # 2. Clean Spatialite temp tables for current project databases
        spatialite_count = self._cleanup_spatialite_project_tables()
        total_count += spatialite_count

        logger.info(f"Project cleanup complete: {total_count} table(s) removed "
                   f"(PostgreSQL: {pg_count}, Spatialite: {spatialite_count})")
        return total_count

    def cleanup_temp_tables_global(self) -> int:
        """
        Clean up ALL FilterMate temporary tables globally.

        Cleans all FilterMate temp tables from:
        - PostgreSQL: All sessions in filter_mate_temp schema
        - Spatialite: All mv_* tables in all known databases

        Warning: This affects all projects, not just the current one!

        Returns:
            int: Total number of tables cleaned up
        """
        total_count = 0

        # 1. Clean ALL PostgreSQL views in schema
        pg_count = self._cleanup_postgresql_all_sessions()
        total_count += pg_count

        # 2. Clean ALL Spatialite temp tables
        spatialite_count = self._cleanup_spatialite_all_tables()
        total_count += spatialite_count

        logger.info(f"Global cleanup complete: {total_count} table(s) removed "
                   f"(PostgreSQL: {pg_count}, Spatialite: {spatialite_count})")
        return total_count

    def _cleanup_postgresql_current_session(self) -> int:
        """
        Clean PostgreSQL materialized views for current session only.

        Returns:
            int: Number of views dropped
        """
        app, session_id, schema, connexion = self.get_pg_session_context()

        if not connexion or not session_id:
            logger.debug("No PostgreSQL connection or session_id for current session cleanup")
            return 0

        try:
            with connexion.cursor() as cursor:
                # Find views for this session only (unified fm_temp_* prefix v4.4.4)
                # Also check legacy mv_ prefix for backward compatibility
                cursor.execute(
                    """SELECT matviewname FROM pg_matviews
                       WHERE schemaname = %s
                       AND (matviewname LIKE %s OR matviewname LIKE %s)""",
                    (schema, f"fm_temp_mv_{session_id}_%", f"mv_{session_id}_%")
                )
                views = [v[0] for v in cursor.fetchall()]

                if not views:
                    logger.debug(f"No PostgreSQL views found for session {session_id[:8]}")
                    return 0

                count = 0
                safe_schema = sanitize_sql_identifier(schema)
                for view in views:
                    try:
                        safe_view = sanitize_sql_identifier(view)
                        cursor.execute(f'DROP MATERIALIZED VIEW IF EXISTS "{safe_schema}"."{safe_view}" CASCADE;')
                        count += 1
                    except Exception as e:
                        logger.warning(f"Failed to drop PostgreSQL view {view}: {e}")

                connexion.commit()
                logger.info(f"PostgreSQL session cleanup: {count} view(s) dropped for session {session_id[:8]}")
                return count

        except Exception as e:
            logger.error(f"Error in PostgreSQL session cleanup: {e}")
            return 0
        finally:
            try:
                connexion.close()
            except Exception:
                pass

    def _cleanup_postgresql_all_sessions(self) -> int:
        """
        Clean ALL PostgreSQL materialized views AND tables created by FilterMate.

        Uses unified naming convention (v4.4.3+) - all FilterMate objects start with 'fm_temp_':
        - fm_temp_mv_* (materialized views)
        - fm_temp_buf_* (buffer geometry tables)
        - fm_temp_tbl_* (temporary tables)
        - fm_temp_src_* (source selection tables/MVs)
        - fm_temp_chain_* (filter chain MVs)

        Also cleans legacy prefixes for backward compatibility:
        - fm_mv_*, fm_buf_*, filtermate_mv_*, filtermate_src_*

        Returns:
            int: Total number of objects dropped
        """
        app, session_id, schema, connexion = self.get_pg_session_context()

        if not connexion:
            logger.warning("No PostgreSQL connection available for global cleanup")
            return 0

        total_count = 0

        try:
            with connexion.cursor() as cursor:
                # 1. Find ALL FilterMate materialized views in ANY schema
                # Includes both new (fm_temp_*) and legacy (fm_mv_*, filtermate_*) prefixes
                cursor.execute("""
                    SELECT schemaname, matviewname
                    FROM pg_matviews
                    WHERE matviewname LIKE 'fm\\_temp\\_%'
                       OR matviewname LIKE 'fm\\_mv\\_%'
                       OR matviewname LIKE 'filtermate\\_%'
                    ORDER BY schemaname, matviewname
                """)
                all_views = cursor.fetchall()

                if all_views:
                    logger.info(f"Found {len(all_views)} FilterMate materialized view(s) to clean:")
                    for view_schema, view_name in all_views:
                        logger.debug(f"  - MV: {view_schema}.{view_name}")

                    # Drop each materialized view
                    for view_schema, view_name in all_views:
                        try:
                            safe_vs = sanitize_sql_identifier(view_schema)
                            safe_vn = sanitize_sql_identifier(view_name)
                            cursor.execute(f'DROP MATERIALIZED VIEW IF EXISTS "{safe_vs}"."{safe_vn}" CASCADE;')
                            total_count += 1
                            logger.debug(f"Dropped MV: {view_schema}.{view_name}")
                        except Exception as e:
                            logger.warning(f"Failed to drop MV {view_schema}.{view_name}: {e}")

                connexion.commit()

                # 2. Clean ALL fm_temp_* TABLES (new unified prefix)
                # Also cleans legacy fm_buf_* tables
                cursor.execute("""
                    SELECT table_schema, table_name
                    FROM information_schema.tables
                    WHERE table_type = 'BASE TABLE'
                    AND (table_name LIKE 'fm\\_temp\\_%'
                         OR table_name LIKE 'fm\\_buf\\_%'
                         OR table_name LIKE 'filtermate\\_%')
                    ORDER BY table_schema, table_name
                """)
                all_tables = cursor.fetchall()

                if all_tables:
                    logger.info(f"Found {len(all_tables)} FilterMate table(s) to clean:")
                    for table_schema, table_name in all_tables:
                        logger.debug(f"  - TABLE: {table_schema}.{table_name}")

                    # Drop each table
                    for table_schema, table_name in all_tables:
                        try:
                            safe_ts = sanitize_sql_identifier(table_schema)
                            safe_tn = sanitize_sql_identifier(table_name)
                            cursor.execute(f'DROP TABLE IF EXISTS "{safe_ts}"."{safe_tn}" CASCADE;')  # nosec B608
                            total_count += 1
                            logger.debug(f"Dropped TABLE: {table_schema}.{table_name}")
                        except Exception as e:
                            logger.warning(f"Failed to drop TABLE {table_schema}.{table_name}: {e}")

                connexion.commit()

                # 3. Also try to drop the temp schemas if empty
                for temp_schema in ['filter_mate_temp', 'filtermate_temp']:
                    try:
                        safe_schema = sanitize_sql_identifier(temp_schema)
                        cursor.execute(f'DROP SCHEMA IF EXISTS "{safe_schema}" CASCADE;')
                        connexion.commit()
                        logger.debug(f"Dropped empty schema: {temp_schema}")
                    except Exception as e:
                        logger.debug(f"Could not drop schema {temp_schema}: {e}")

                logger.info(f"PostgreSQL global cleanup: {total_count} object(s) dropped")
                return total_count

        except Exception as e:
            logger.error(f"Error in PostgreSQL global cleanup: {e}")
            return 0
        finally:
            try:
                connexion.close()
            except Exception:
                pass

    def _cleanup_spatialite_project_tables(self) -> int:
        """Clean Spatialite temp tables for current project databases."""
        from qgis.core import QgsProject

        # Get session_id from app
        app = getattr(self.dockwidget, '_app_ref', None)
        session_id = getattr(app, 'session_id', None) if app else None

        if not session_id:
            logger.debug("No session_id available for Spatialite project cleanup")
            return 0

        # Collect unique database paths from project layers
        db_paths = set()
        project = QgsProject.instance()
        for layer in project.mapLayers().values():
            if hasattr(layer, 'providerType') and layer.providerType() in ('spatialite', 'ogr'):
                source = layer.source().split('|')[0]
                if source.lower().endswith(('.gpkg', '.sqlite', '.db')):
                    db_paths.add(source)

        total_count = 0
        for db_path in db_paths:
            count = self._cleanup_spatialite_db(db_path, session_id)
            total_count += count

        return total_count

    def _cleanup_spatialite_all_tables(self) -> int:
        """Clean ALL FilterMate temp tables from all known Spatialite databases."""
        from qgis.core import QgsProject

        # Collect unique database paths from project layers
        db_paths = set()
        project = QgsProject.instance()
        for layer in project.mapLayers().values():
            if hasattr(layer, 'providerType') and layer.providerType() in ('spatialite', 'ogr'):
                source = layer.source().split('|')[0]
                if source.lower().endswith(('.gpkg', '.sqlite', '.db')):
                    db_paths.add(source)

        total_count = 0
        for db_path in db_paths:
            # Pass None for session_id to clean ALL mv_* tables
            count = self._cleanup_spatialite_db(db_path, session_id=None)
            total_count += count

        return total_count

    def _cleanup_spatialite_db(self, db_path: str, session_id: str = None) -> int:
        """
        Clean FilterMate temp tables from a specific Spatialite database.

        Args:
            db_path: Path to the SQLite/GeoPackage database
            session_id: If provided, only clean tables for this session.
                       If None, clean ALL mv_* tables.

        Returns:
            int: Number of tables cleaned up
        """
        import sqlite3
        import os

        if not db_path or not os.path.exists(db_path):
            return 0

        try:
            conn = sqlite3.connect(db_path)
            cur = conn.cursor()

            # Build pattern based on session_id (unified fm_temp_* prefix v4.4.4)
            if session_id:
                pattern_new = f"fm_temp_mv_{session_id}_%"
                pattern_legacy = f"mv_{session_id}_%"
            else:
                pattern_new = "fm_temp_%"  # All FilterMate temp tables (new prefix)
                pattern_legacy = "mv_%"  # All FilterMate temp tables (legacy prefix)

            # Find matching tables (both new and legacy prefixes)
            cur.execute(
                """SELECT name FROM sqlite_master
                   WHERE type='table' AND (name LIKE ? OR name LIKE ?)""",
                (pattern_new, pattern_legacy)
            )
            tables = cur.fetchall()

            count = 0
            for (table_name,) in tables:
                try:
                    cur.execute(f'DROP TABLE IF EXISTS "{table_name}";')  # nosec B608
                    # Also drop R-tree index if exists
                    cur.execute(f'DROP TABLE IF EXISTS "idx_{table_name}_geometry";')  # nosec B608
                    count += 1
                except Exception as e:
                    logger.warning(f"Error dropping table {table_name}: {e}")

            conn.commit()
            conn.close()

            if count > 0:
                db_name = os.path.basename(db_path)
                scope = f"session {session_id[:8]}" if session_id else "all sessions"
                logger.info(f"Spatialite cleanup ({db_name}): {count} table(s) for {scope}")

            return count

        except Exception as e:
            logger.error(f"Error cleaning Spatialite database {db_path}: {e}")
            return 0
