from __future__ import annotations

from typing import Any
from urllib.parse import quote

from .evidence import make_evidence
from .models import EvidenceItem, SiteSelection


def build_earth_reference(
    selection: SiteSelection,
    observation_notes: str,
) -> tuple[dict[str, Any], list[EvidenceItem]]:
    """Create safe external satellite/map reference links without using Google as evidence."""
    links: dict[str, str] = {}
    evidence: list[EvidenceItem] = []
    if selection.anchor_lat is not None and selection.anchor_lon is not None:
        lat = f"{selection.anchor_lat:.6f}"
        lon = f"{selection.anchor_lon:.6f}"
        query = quote(f"{lat},{lon}")
        links = {
            "Google Maps reference": f"https://www.google.com/maps/search/?api=1&query={query}",
            "Google Earth reference": f"https://earth.google.com/web/search/{query}",
            "OpenStreetMap reference": f"https://www.openstreetmap.org/?mlat={lat}&mlon={lon}#map=17/{lat}/{lon}",
        }
        evidence.append(
            make_evidence(
                category="Satellite / Earth reference",
                finding="External map and earth-imagery links were generated for visual reference only.",
                source_name="Google Maps / Google Earth / OpenStreetMap links",
                source_url=links["OpenStreetMap reference"],
                source_type="external visual reference",
                resolution_or_scope="anchor coordinate link; no imagery was processed by the app",
                confidence="low",
                limitation="External imagery may be outdated, cloud affected, differently aligned, or too coarse for plot-level evidence.",
                design_implication="Use only to guide manual checking of visible roads, water, vegetation, built forms, and site edges.",
                verification_needed="Confirm all visible satellite/map observations through site visit or uploaded KML/CAD/GeoJSON.",
                output_label="site_visit_required",
            )
        )
    if observation_notes.strip():
        evidence.append(
            make_evidence(
                category="Satellite / Earth reference",
                finding="User supplied satellite/Earth/site-observation notes.",
                source_name="User observation",
                source_url="",
                source_type="user-provided",
                resolution_or_scope="editable field/reference note",
                confidence="medium",
                limitation="Not independently verified by the app.",
                design_implication="Use as a draft observation layer and verify with photos, site visit, or source drawings.",
                verification_needed="Mark which notes came from Google Earth, site visit, faculty drawing, or local observation.",
                output_label="user_input",
            )
        )
    return {
        "markdown": earth_reference_markdown(links, observation_notes),
        "links": links,
    }, evidence


def earth_reference_markdown(links: dict[str, str], observation_notes: str) -> str:
    lines = [
        "### Satellite / Earth Reference",
        "",
        "This section is a visual-reference workflow, not a satellite-analysis engine. The app does not extract facts from Google imagery. Use these links and notes to check visible site context, then verify on site.",
        "",
    ]
    if links:
        lines.append("**External references**")
        lines.extend(f"- [{label}]({url})" for label, url in links.items())
        lines.append("")
    else:
        lines.append("- External reference links unavailable because no anchor coordinate is available.")
        lines.append("")
    lines.extend(
        [
            "**What to inspect manually**",
            "",
            "- visible trees and canopy",
            "- water bodies, drainage lines, and wet edges",
            "- existing structures, compound walls, and open ground",
            "- access roads, informal paths, and construction nearby",
            "- possible slope/drainage signs, shadowed areas, and surrounding heights",
            "",
            "**Safety note**",
            "",
            "- Satellite imagery may be outdated or too coarse for small plots.",
            "- Google Earth/Maps references are not legal, cadastral, survey, or engineering evidence.",
            "- Use KML/KMZ, CAD/DXF, GeoJSON, survey drawings, photos, and site visit to confirm observations.",
        ]
    )
    if observation_notes.strip():
        lines.extend(["", "**User observation notes**", "", observation_notes.strip()])
    return "\n".join(lines)