"""
Catalog of slides: (key, scene_file, scene_class).

Single source of truth shared by `__main__.py` (render orchestrator) and
`web/app.py` (the /slides routes). Update here when adding/removing slides.

Paths are relative to the manim/ directory (which is the cwd when running
`python -m src.slides` from there).
"""
from pathlib import Path


SCENES = [
    ("01", "src/slides/s01_title.py",            "S01Title"),
    ("02", "src/slides/s02_threat.py",           "S02Threat"),
    ("03", "src/slides/s03_research_q.py",       "S03ResearchQ"),
    ("04", "src/slides/s04_memory_model.py",     "S04MemoryModel"),
    ("05", "src/slides/s05_vuln_family.py",      "S05VulnFamily"),
    ("06", "src/slides/s06_timeline.py",         "S06Timeline"),
    # 07 key reserved; s07 stack frame was folded into s08 step 0
    ("08", "src/slides/s08_overflow.py",         "S08Overflow"),
    # 09 key reserved
    ("10", "src/slides/s10_chain.py",            "S10Chain"),
    ("11", "src/slides/s11_cve_55177.py",        "S11Cve55177"),
    ("12", "src/slides/s12_cve_43300.py",        "S12Cve43300"),
    ("13", "src/slides/s13_money_shot.py",       "S13MoneyShot"),
    ("14", "src/slides/s14_2026.py",             "S142026"),
    ("15", "src/slides/s15_mitigations_fail.py", "S15MitigationsFail"),
    ("16", "src/slides/s16_solutions.py",        "S16Solutions"),
    # 18 key reserved
    ("17", "src/slides/s17_references.py",       "S17References"),
    ("19", "src/slides/s19_thank_you.py",        "S19ThankYou"),
]


TITLES = {
    "01": "Cover (title)",
    "02": "The threat",
    "03": "Research question",
    "04": "C memory model",
    "05": "Memory vulnerability family",
    "06": "Timeline 1996-2026",
    "07": "Stack frame anatomy",
    "08": "Buffer overflow (centerpiece)",
    "09": "Textbook = primitive",
    "10": "The 2025 chain",
    "11": "CVE-2025-55177 (delivery)",
    "12": "CVE-2025-43300 (exploitation)",
    "13": "CTF heap = CVE heap",
    "14": "2026: Copy Fail + Dirty Frag",
    "15": "Mitigations fail",
    "16": "Solutions: Rust + MTE",
    "17": "References 1/2",
    "18": "References 2/2",
    "19": "Thank you + QR",
}


def existing_scenes(project_root: Path) -> list[tuple[str, str, str]]:
    return [(k, f, c) for k, f, c in SCENES if (project_root / f).exists()]


def lookup(key: str) -> tuple[str, str, str] | None:
    for k, f, c in SCENES:
        if k == key:
            return (k, f, c)
    return None
