#!/usr/bin/env python
# -*- coding: utf-8 -*-
"""原型 JS 与模板字面量的**语法门禁**（③段 3b/3d 用，只读原型，⛔ 不写盘）。

为什么需要它（不是"为了严谨"，是同一个坑踩了 **4 次**的真实事故）：
  原型是单文件自包含，页面结构写在一堆 JS **模板字面量**里（反引号包起来的字符串）。
  只要在模板里的 **HTML 注释**（`<!-- ... -->`）中写出一个反引号，模板字面量就会被提前闭合，
  而后面那段被当成 JS 代码解析 —— 症状是**页面静默坏掉**（白屏 / `xxx is not defined` /
  `Unexpected identifier`），而 `node --check 整份 html` 是**报不出来**的（html 不是 js），
  于是它一路混到浏览器里才炸。

  已经踩到的 4 次（每次都是「HTML 注释里带反引号」）：
    1. P1 的 `.grid.cols2` 注释 → 页面白屏
    2. P2 的 `.home-stats` / `.stat-item` 注释 → `stats is not defined`，自检没跑完
    3. P2 的 `.grid-cards` / `font-size` 注释 → `Unexpected identifier 'style'`
    4. P1 的 `.qa-block` / `.func-card .qa{...}` 注释 → `Unexpected token '{'`

本脚本查两件事：
  ① **语法**：把 `<script>` 段抠出来交给 `node --check`（⛔ 不是查整份 html）。
  ② **模板里的反引号**：多行扫描 script 区内的每个 `<!-- ... -->` 块，块内出现反引号即报红。
     ⚠️ 必须**多行**扫：反引号常在注释的**续行**上（单行 grep 抓不到）。

用法：
    python _tools/check_js.py            # 查同目录的 mcn-workbench.html
    python _tools/check_js.py --proto X.html
退出码：0 = 全过；1 = 有 FAIL。
"""

import argparse
import io
import os
import re
import subprocess
import sys
import tempfile

HERE = os.path.dirname(os.path.abspath(__file__))
DEFAULT_PROTO = os.path.abspath(os.path.join(HERE, '..', 'mcn-workbench.html'))
NODE = r"E:\ProgramData\.workbuddy\binaries\node\versions\22.22.2-6\node.exe"


def main():
    ap = argparse.ArgumentParser()
    ap.add_argument('--proto', default=DEFAULT_PROTO)
    a = ap.parse_args()

    src = io.open(a.proto, encoding='utf-8').read()
    fails = []

    i = src.index('<script>') + len('<script>')
    j = src.rindex('</script>')
    js = src[i:j]

    # ① 语法：把 script 抠出来给 node --check
    node = NODE if os.path.exists(NODE) else 'node'
    with tempfile.NamedTemporaryFile('w', suffix='.js', delete=False, encoding='utf-8', newline='') as f:
        f.write(js)
        tmp = f.name
    try:
        r = subprocess.run([node, '--check', tmp], capture_output=True)
        if r.returncode == 0:
            print('PASS  语法：<script> 段 ' + str(js.count(chr(10))) + ' 行，node --check 通过')
        else:
            err = r.stderr.decode('utf-8', 'replace').strip().split('\n')
            # 把临时文件里的行号换算回原文件行号
            base = src[:i].count('\n') + 1
            head = [l for l in err if l.strip()][:4]
            fails.append('语法不过：' + ' ／ '.join(head))
            print('FAIL  语法：node --check 报错（下面的行号是 script 段内的，原文件约 +%d 行）' % base)
            for l in head:
                print('      ' + l)
    finally:
        os.unlink(tmp)

    # ② 模板里的反引号（多行扫描每个 HTML 注释块）
    bad = []
    for m in re.finditer(r'<!--[\s\S]*?-->', js):
        blk = m.group(0)
        if '`' in blk:
            line = js[:m.start()].count('\n') + src[:i].count('\n') + 2
            first = blk.split('\n')[0][:70]
            n_tick = blk.count('`')
            bad.append('原文件第 %d 行附近：模板里的 HTML 注释含 %d 个反引号 —— 「%s」' % (line, n_tick, first))
    if bad:
        fails.extend(bad)
        print('FAIL  模板里的反引号：')
        for b in bad:
            print('      ' + b)
    else:
        print('PASS  模板里的反引号：script 区内所有 <!-- --> 块（多行扫描）都不含反引号')

    print()
    if fails:
        print('结论：FAIL %d 项 —— 上面每一条都会让**页面在浏览器里才炸**（node --check 整份 html 看不到）。' % len(fails))
        print('修法：注释里的反引号一律去掉（用 .cls 或 「cls」代替 `.cls`）。')
        return 1
    print('结论：全过。')
    return 0


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