# -*- coding: utf-8 -*-
r'''扫 admin.py 里所有会被 Python 变成真换行的 \n（在注释和 JS 里）。

== 为什么 ==

admin.py 的 ADMIN_JS 是**普通三引号字符串**。
里面写 `\n`（一个反斜杠 + n）会被 Python 解释成**真实换行**。
在 JS 里，行注释 `// ...` 不能跨行 —— 一旦注释中间出现真实换行，
后面的内容就变成一行裸文本，整段 <script> 语法错误，
管理页**所有**按钮失效。

这个坑在同一个文件里踩了两次，第二次还是"注释为了举例说明
不能写 \n，自己写了一个 \n"。所以写个扫描器钉住它。

规则：
  * 在 ADMIN_JS 这类普通字符串里，**任何** \n \r \t 之类的转义
    都只应该出现在「要输出给 JS 的字符串字面量」里，
    而且必须写成 \\n（双反斜杠）。
  * 注释里一个转义都不该有。

这个扫描器逐行看：如果某行是 // 注释，却含有单个反斜杠转义，报警。
'''
from __future__ import annotations

import ast
import re
import sys
from pathlib import Path

SRC = Path(__file__).resolve().parent.parent / "relay" / "admin.py"


def main() -> int:
    text = SRC.read_text(encoding="utf-8")
    tree = ast.parse(text)

    # 找出所有大段的字符串常量（ADMIN_JS / HTML 模板）
    found = 0
    problems = []
    for node in ast.walk(tree):
        if not isinstance(node, ast.Constant) or not isinstance(node.value, str):
            continue
        val = node.value
        if len(val) < 500 or "<script" not in val and "querySelector" not in val:
            continue
        found += 1
        start = node.lineno
        # 逐行检查「注释行里有没有被吃掉的转义」
        for i, line in enumerate(val.splitlines()):
            stripped = line.strip()
            if not stripped.startswith("//"):
                continue
            # 注释里出现了真实的制表符/回车，或者其它控制字符
            for ch in line:
                if ord(ch) < 32 and ch != "\t":
                    problems.append(
                        "第 %d 行附近的注释里有裸控制字符 0x%02x：%r"
                        % (start + i, ord(ch), line[:60]))
                    break

    # 再直接扫源文件：在 JS 段里，行尾恰好断在奇怪位置的注释
    print("  找到 %d 段 JS/HTML 模板常量" % found)
    print()

    # 更直接的办法：把源文件里三引号字符串的原样行拿出来，
    # 找「// 注释行后面紧跟着一行不以 // 开头、也不像代码」的
    src_lines = text.splitlines()
    suspicious = []
    for i, line in enumerate(src_lines, 1):
        s = line.strip()
        if not s.startswith("//"):
            continue
        # 下一行
        if i < len(src_lines):
            nxt = src_lines[i].strip()
            # 注释的下一行既不是注释、也不像 JS 语句开头
            if (nxt and not nxt.startswith("//")
                    and not re.match(r"^(const|let|var|if|for|while|function|"
                                     r"document|window|return|}|\)|else|await|"
                                     r"try|catch|toast|setTimeout|\w+\s*[=(.]|"
                                     r"<|/\*|\*|--)",
                                     nxt)):
                suspicious.append((i, s[:70], nxt[:70]))

    if suspicious:
        print("  ⚠ 可疑的注释断行（注释下一行不像 JS）:")
        for ln, a, b in suspicious[:10]:
            print("    第 %d 行: %s" % (ln, a))
            print("      下一行: %s" % b)
    else:
        print("  ✓ 没有可疑的注释断行")

    if problems:
        print()
        for p in problems:
            print("  ⚠ " + p)
        return 1
    return 0


if __name__ == "__main__":
    sys.exit(main())