#!/usr/bin/env python3
"""Audit Alpine.js templates for semicolons in event handler expressions.

Alpine evaluates expressions via `return <expr>`. Semicolons inside
event handler expressions terminate the return prematurely:

    Expression: "a = 1; b = 2"
               → return a = 1; b = 2
               → SyntaxError: Unexpected token ';'

When this happens in a PARENT component, ALL child x-data components
fail to initialize → cascading ReferenceError for every variable.

Usage:
    python3 scripts/audit-semicolons.py app/templates/

Returns exit code 1 if any offending ; are found.
"""

import re
import sys
from pathlib import Path


def audit_file(filepath: Path) -> int:
    with open(filepath) as f:
        content = f.read()
    count = 0
    for m in re.finditer(r'@\w+(?:\.\w+)*="([^"]*)"', content):
        val = m.group(1)
        if ";" in val and not val.startswith("$nextTick"):
            count += 1
            line_no = content[: m.start()].count("\n") + 1
            print(f"  {filepath}:{line_no}  {val[:100]}")
    return count


def main():
    if len(sys.argv) < 2:
        print(f"Usage: {sys.argv[0]} <template_file_or_dir> [more files...]")
        sys.exit(1)

    total = 0
    for arg in sys.argv[1:]:
        p = Path(arg)
        files = [p] if p.is_file() else sorted(p.rglob("*.html"))
        for f in files:
            n = audit_file(f)
            if n:
                print(f"  → {n} issue(s) in {f.name}")
            total += n

    if total:
        print(f"\nTOTAL: {total} semicolon issue(s) across all templates")
        print("Fix: replace ';' with ',' (comma operator) in Alpine @event expressions")
        sys.exit(1)
    else:
        print("CLEAN — no semicolons in Alpine expressions")
        sys.exit(0)


if __name__ == "__main__":
    main()