Unlucky-Launcher/crates/app-iced/src/pages/instances/tests/i18n.rs

//! 实例页的**文案守门**（M120）：中文态不许漏英文、切语言必须真的变、运行状态的数字不许变形。
//!
//! | 用例 | 抓得住什么 |
//! |---|---|
//! | [`the_chinese_page_has_no_english_words`] | 目录里某条中文忘了翻（或翻完还留着英文词） |
//! | [`every_instances_text_changes_with_the_language`] | 两套语言写成一样（= 切换语言时那一处不动，看着像「已 i18n」其实是死文案） |
//! | [`the_running_line_keeps_its_number_and_separator`] | `Running · pid 1234` 的数字 / `pid` / `·` 被翻译走样 |
//! | [`every_english_literal_in_the_page_sources_is_whitelisted`] | 页面里写死**任何**英文（旧串或新写的，白名单判定；r1 之前是黑名单，对新写的英文是哑的） |
//! | [`every_instances_key_is_referenced_by_the_page`] | 目录里加了 key、页面没人用（死 key，M117 那七条就是这么来的） |
//!
//! ## 边界（别把这张表读成「视图覆盖」）
//!
//! iced 0.14 的 `Element` **没有内省接口**（`instances/tests.rs` 里那条「为什么读源码」写的就是它），
//! 所以「上屏文本」取样只能从页面取词的那**一个入口** [`Texts`] 拿：页面用它画、测试用同一个
//! `Texts` 断言，不是另写一份平行实现。「页面又冒出一条**新**硬编码英文字面量」由
//! [`every_english_literal_in_the_page_sources_is_whitelisted`] 兜（白名单）；**中文**写死的
//! 字面量它看不见，那只能靠 `Texts::of(` 的反向锚与出图人工看。
//! 「模型这一层（快照 → 状态行 / 元信息）跟着 `Lang` 变」由 `app/view/tests.rs` 守。

use unlucky_i18n::catalog::MISSING;
use unlucky_i18n::{Catalog, Key, Lang};

use crate::pages::layout::source;

use super::super::Texts;

/// 中文界面里允许出现的 ASCII 词：**品牌名与技术标识**。
///
/// 每一条都要说清为什么：
///
/// - `Java`：运行时品牌名（`JAVA` 那格的值域里也全是 `Temurin 21` 这类品牌串），翻成「爪哇」是错的；
/// - `pid`：进程号的技术标识。用户拿它去任务管理器里搜进程，翻成「进程」就丢了这条可操作性。
const ALLOWED: &[&str] = &[
    "Java",
    "pid",
    "JVM",
    "OpenGL",
    "Vulkan",
    "MiB",
    // M224：`mods` 是**目录名**（文件系统事实）。中文界面上写成「模组目录」会让用户找不到那个
    // 文件夹——`mods/` 就是他要打开的那个东西，所以两套语言都原样写它。
    "mods",
    // M235：`saves` / `screenshots` 同样是**目录名**（文件系统事实，玩家要照着去找）。
    // 「正在读取 saves/…」「还没有 saves/ 或 screenshots/ 目录」里的这两个词不许翻——
    // 翻成「存档目录」用户就对不上那两层文件夹了。
    "saves",
    "screenshots",
    // M247：`zip` 是**归档格式名**（备份导出成什么，玩家拿去给别的东西解压时看的也是这个词）。
    // 中文界面上写「压缩包」会让「备份出来的是 .zip 吗」这个问题没有答案。
    "zip",
    // M273 r1：`.minecraft` 是**目录名**（用户要照着去文件管理器里找的那一层）。共用目录那句
    // 必须原样写它，翻成「游戏根目录」会让用户对不上盘上那个文件夹。
    "minecraft",
];

/// 页面取词的六个源码文件（死 key 扫描与旧串扫描共用）。
const PAGE_SOURCES: [(&str, &str); 12] = [
    ("instances.rs", include_str!("../../instances.rs")),
    ("instances/detail.rs", include_str!("../detail.rs")),
    ("instances/demo.rs", include_str!("../demo.rs")),
    ("instances/text.rs", include_str!("../text.rs")),
    // M251：存档 / 截图一族从 text.rs 拆出（那边越过 400 行）——新文件必须一起扫，
    // 否则那四句缩略图文案会被当成「死 key」。
    ("instances/text/saves.rs", include_str!("../text/saves.rs")),
    (
        "instances/launch_args.rs",
        include_str!("../launch_args.rs"),
    ),
    (
        "app/view/instances.rs",
        include_str!("../../../app/view/instances.rs"),
    ),
    // M224：MODS 区（本地 mod 列表 + 启停开关）
    ("instances/mods.rs", include_str!("../mods.rs")),
    // M235：SAVES 区（存档 / 截图的只读列表 + 打开文件夹）
    ("instances/saves.rs", include_str!("../saves.rs")),
    // M247：SAVES 区的行与操作区（重命名 / 备份 / 删除 + 行内输入框）
    ("instances/saves/rows.rs", include_str!("../saves/rows.rs")),
    // M251：SAVES 区的视图模型（快照 → 行/格子；缩略图句柄在这里建）
    (
        "instances/saves/model.rs",
        include_str!("../saves/model.rs"),
    ),
    // M251：截图缩略图墙
    ("instances/saves/wall.rs", include_str!("../saves/wall.rs")),
];

/// 页面五件套里**允许出现的字符串字面量**（凡是带 ASCII 单词的都必须在这张表里）。
///
/// M120 r1 复审实测出黑名单的哑点：只兜「已知的 29 条旧串」时，往页面里**新写一句英文**
/// 照样 612/612 + 12/12 全绿。判据现在反过来——**白名单**：页面源码里每个带 ASCII 单词的
/// 字面量都要在这里找到归宿，新写一句英文立刻红。
///
/// 全部 6 条都写了理由（剩下一批 `"{} · {}"` / `"{} · {:.0}%"` / `"{} {}"` 这类格式化模板
/// **连一个词都没有**，所以不需要条目）：
///
/// | 字面量 | 为什么它可以是英文 |
/// |---|---|
/// | `{date} {time} UTC` | `UTC` 是时区缩写，不是界面文案（本地时区换算属时间格式 mission） |
/// | `isolated` / `shared` | core 的隔离档位**稳定 id**（`IsolationMode::as_str`），`isolation()` 只认这两档，其余原样上屏 |
/// | `pid` / `reason` | `Catalog::render` 的**占位符名**（与 catalog 里的 `{pid}` / `{reason}` 对应） |
/// | `Instances` | `Texts::keys()` 的**族名前缀**（`Key::ALL` 的过滤条件，不是文案） |
const ALLOWED_LITERALS: [&str; 35] = [
    "{date} {time} UTC",
    "isolated",
    "shared",
    "pid",
    // M161：失败行由 `LaunchStageFailed` / `InstancesFailed` / `InstancesCrashed` 渲染，
    // 占位符名是 `{stage}` / `{detail}` / `{reason}` / `{code}`（占位符名不是文案）；
    // `{outcome}` / `{seconds}` 是收尾 Toast 的。
    "stage",
    "detail",
    "reason",
    "code",
    "outcome",
    "seconds",
    "Instances",
    // M157：图形后端三态的**稳定 id**（与 core 的 `GraphicsBackend::IDS` 同一份词表），
    // `backend_label` 只认这三档，其余原样上屏。
    "default",
    "opengl",
    "vulkan",
    // M157：`Catalog::render` 的占位符名（`{version}` / `{value}` / `{default}`），不是文案。
    "version",
    "value",
    // M157 r4：门槛文案的占位符名（版本号由 DTO 给，目录里不写死）。
    "min",
    // M157：`instances/demo.rs` 的**出图夹具**（用户数据的形状，不是界面文案）：
    // 一个示例 JVM 参数、两个示例 MC 版本、一个示例 Java 路径，以及夹具开关的环境变量名与取值。
    "-XX:+UseG1GC",
    // M157 r2：示例游戏参数（同上，是夹具不是文案）。
    "--fullscreen",
    "26.2-snapshot-2",
    "1.20.4",
    "C:/Java/temurin-21/bin/java.exe",
    "ULL_LAUNCH_ARGS_FIXTURE",
    // M161：示例「被门槛挡下」的取值（夹具）。
    "gated",
    // M224：MODS 区四个 key 的**占位符名**（`{enabled}` / `{disabled}` / `{count}` / `{file}`），
    // 不是文案——`Catalog::render` 按名字取值，换成别的词就渲染不出来了。
    "enabled",
    "disabled",
    "count",
    "file",
    // M235：存档区计数那条的**占位符名**（`{worlds}` / `{shots}`），同样不是文案。
    "worlds",
    "shots",
    // M247：删除确认与写操作回执的**占位符名**（`{dir}` 世界名 / `{from}` `{to}` 改名两端 /
    // `{path}` 备份落点 / `{size}` 人的可读字节数），都不是文案。
    "dir",
    "from",
    "to",
    "path",
    "size",
];

/// 抽出源码里的字符串字面量（够用的实现：本仓这五个文件没有 `\"` 转义、没有多行字符串）。
///
/// 按 `"` 切开取**奇数段**即可：`a"b"c"d"e` → 段 1 = `b`、段 3 = `d`。
fn string_literals(source: &str) -> Vec<&str> {
    source.split('"').skip(1).step_by(2).collect()
}

/// 把 `{占位符}` 抹掉再切 ASCII 词：占位符是**运行时数据**（pid / 原因 / 时间），不是文案。
fn ascii_words(text: &str) -> Vec<String> {
    let mut stripped = String::new();
    let mut depth = 0usize;
    for ch in text.chars() {
        match ch {
            '{' => depth += 1,
            '}' if depth > 0 => depth -= 1,
            _ if depth > 0 => {}
            _ => stripped.push(ch),
        }
    }

    let mut words = Vec::new();
    let mut current = String::new();
    for ch in stripped.chars() {
        if ch.is_ascii_alphabetic() {
            current.push(ch);
        } else if !current.is_empty() {
            words.push(std::mem::take(&mut current));
        }
    }
    if !current.is_empty() {
        words.push(current);
    }
    words
}

/// 有没有中日韩统一表意文字（「这条文案真的翻成中文了吗」的最直接判据）。
fn has_cjk(text: &str) -> bool {
    text.chars().any(|c| {
        matches!(c, '\u{3400}'..='\u{4DBF}' | '\u{4E00}'..='\u{9FFF}' | '\u{3000}'..='\u{303F}')
    })
}

/// **中文界面无英文词**：实例页这一族的每一条中文译文，除了 [`ALLOWED`] 之外不许出现 ASCII 单词。
///
/// 抓得住：漏翻（中英写成一样）、翻了一半（`Present on disk` → `已在磁盘上 Present`）、
/// 新加 key 时中文那栏顺手抄了英文。
/// 抓不住：译文本身读着别扭；也抓不住「页面另写了一条字面量」（见模块文档的边界一节）。
///
/// **变异实测**（M120 交付时跑过）：把 `InstancesPresentOnDisk` 的中文改回 `Present on disk`，
/// 这条立刻红并指出 key 名。
#[test]
fn the_chinese_page_has_no_english_words() {
    let zh = Lang::ZhCn.catalog();
    let mut offenders = Vec::new();
    let mut checked = 0;

    for key in Texts::keys() {
        let text = zh.text(key);
        assert_ne!(text, MISSING, "{} 没有中文译文", key.name());
        checked += 1;
        for word in ascii_words(text) {
            if !ALLOWED.contains(&word.as_str()) {
                offenders.push(format!("{} · 出现 {word:?} ← 「{text}」", key.name()));
            }
        }
    }

    assert!(
        offenders.is_empty(),
        "中文界面上这些英文词会漏出来（品牌名 / 技术标识请加进 ALLOWED 并写明理由）：\n{}",
        offenders.join("\n")
    );
    assert!(
        checked >= 30,
        "实例页的 key 不该被成批删掉（只查到 {checked} 条）"
    );
}

/// **切换语言，文本真的变**：这一族的每一条中英译文都必须不同。
///
/// 抓得住：翻完没改（两栏抄同一句）——那种 key 在切语言时**一个字都不动**，界面上看起来
/// 「已经国际化」，其实那一处永远是英文。今夜反复出现的「测试绿着但什么都没守住」就是这一类。
/// 抓不住：某条译文翻错了词。
#[test]
fn every_instances_text_changes_with_the_language() {
    let en = Lang::En.catalog();
    let zh = Lang::ZhCn.catalog();

    for key in Texts::keys() {
        let (a, b) = (en.text(key), zh.text(key));
        assert_ne!(a, MISSING, "{} 没有英文译文", key.name());
        assert_ne!(b, MISSING, "{} 没有中文译文", key.name());
        assert_ne!(
            a,
            b,
            "{} 的两套语言写成了一样（{a:?}）——切语言时这一处不会变",
            key.name()
        );
        // 中文那栏必须真的有汉字——**整句只有品牌名时例外**（`InstancesMetaJava` = "Java"：
        // 那一格的值域是 `Temurin 21` 这种品牌串，翻成「爪哇」是错的）。
        let brand_only = {
            let words = ascii_words(b);
            !words.is_empty() && words.iter().all(|word| ALLOWED.contains(&word.as_str()))
        };
        assert!(
            has_cjk(b) || brand_only,
            "{} 的中文译文里一个汉字都没有：{b:?}",
            key.name()
        );
    }
}

/// **数字与分隔符不随语言变形**：`Running · pid 1234` 的两套语言只换前半句。
///
/// 抓得住：把 `pid` 翻成「进程」、把 `·` 换成 `-`、把 `{pid}` 写成固定文字、少一个空格。
/// 抓不住：真实 pid 的取值（那是 core 的事，出图那台机器上也没真跑过）。
#[test]
fn the_running_line_keeps_its_number_and_separator() {
    let en = Catalog::of(Lang::En).render(Key::InstancesRunning, &[("pid", "1234")]);
    let zh = Catalog::of(Lang::ZhCn).render(Key::InstancesRunning, &[("pid", "1234")]);

    assert_eq!(en, "Running · pid 1234");
    assert_eq!(zh, "运行中 · pid 1234");
    assert_ne!(en, zh, "切换语言时这一行要变（只换标签本体）");
    for text in [en, zh] {
        assert!(text.contains("1234"), "数字丢了：{text}");
        assert!(text.contains(" · pid "), "分隔符或 pid 变形了：{text}");
    }

    // 失败那一行同理（M161：`InstancesFailed` 已被 `LaunchStageFailed` 取代——「哪一步」也要翻，
    // 只有 `detail` 那段原文原样保留）
    let args = [("stage", "Starting the game process"), ("detail", "exit 1")];
    let failed_en = Catalog::of(Lang::En).render(Key::LaunchStageFailed, &args);
    let failed_zh = Catalog::of(Lang::ZhCn).render(
        Key::LaunchStageFailed,
        &[("stage", "启动游戏进程"), ("detail", "exit 1")],
    );
    assert_eq!(
        failed_en,
        "Launch failed · Starting the game process: exit 1"
    );
    assert_eq!(failed_zh, "启动失败 · 启动游戏进程：exit 1");
    for text in [&failed_en, &failed_zh] {
        assert!(text.contains("exit 1"), "原文丢了：{text}");
    }
    assert_ne!(failed_en, failed_zh, "切换语言时前半句要变");
}

/// **页面里不许再写死界面文案**（白名单）：带 ASCII 单词的字面量必须在 [`ALLOWED_LITERALS`] 里。
///
/// 抓得住：①M120 之前那 29 条旧串被抄回页面（它们都带英文词 ⇒ 不在白名单 ⇒ 红）；
/// ②**任何新写的英文字面量**（r1 复审抓到的哑点：黑名单版本把 `"Ready"` 写进页面是全绿的）。
/// 抓不住：中文写死的字面量（`"实例"` 没有 ASCII 词）——那要靠 `Texts::of(` 的反向锚与出图；
/// 也抓不住夹具数据（`pages/instances/data.rs` 故意不在扫描范围：那是**用户数据**的样子，
/// 不是界面文案，见该文件的模块文档）。
///
/// **变异实测（M120 r1 交付时跑过三条）**：写回 `"ALL INSTANCES"` ⇒ 红；写进一条全新的
/// `"Ready"` ⇒ 红；把 `Texts::of(` 从实例页删掉 ⇒ 反向锚红。
#[test]
fn every_english_literal_in_the_page_sources_is_whitelisted() {
    let mut checked = 0;
    for (name, source) in PAGE_SOURCES {
        for literal in string_literals(source) {
            if ascii_words(literal).is_empty() {
                continue;
            }
            checked += 1;
            assert!(
                ALLOWED_LITERALS.contains(&literal),
                "{name} 里的字面量 {literal:?} 带 ASCII 单词但不在白名单里：界面文案要走 Texts / 目录；确属专有名词的话加进 ALLOWED_LITERALS 并写明理由"
            );
        }
    }

    // 反向锚①：扫描器真的扫到了东西（否则上面那个循环是空转）
    assert!(
        checked >= 6,
        "只扫到 {checked} 条带英文的字面量，扫描器可能失效了"
    );

    // 反向锚②：这些来源**必须**真的在用 Texts / 目录。
    //
    // M251：原来按下标取（`PAGE_SOURCES[5]`），插进一条新文件就整体错位——改成**按文件名取**，
    // 以后再拆文件不必回来改下标（拆错文件时仍然会红：找不到那个名字就 panic）。
    let source = |name: &str| -> &'static str {
        PAGE_SOURCES
            .iter()
            .find(|(file, _)| *file == name)
            .map(|(_, source)| *source)
            .unwrap_or_else(|| panic!("PAGE_SOURCES 里没有 {name}：拆文件之后忘了登记？"))
    };
    assert!(
        source::code_text(source("instances.rs")).contains("Texts::of("),
        "实例页没有从 Texts 取词（注释里写不算）"
    );
    assert!(
        source::code_text(source("instances.rs")).contains("Header::new(texts.title())"),
        "页头标题必须是词表里的那条（`Header::new` 里写死字符串 = 中文界面上顶着英文标题）"
    );
    assert!(
        source::code_text(source("instances/text.rs")).contains("Key::Instances"),
        "text.rs 没有引用本族的 key（注释里写不算）"
    );
    assert!(
        source::code_text(source("app/view/instances.rs")).contains("Key::InstancesStage"),
        "阶段标签没有走目录（注释里写不算）"
    );
    assert!(
        source::code_text(source("instances/launch_args.rs")).contains("texts.launch_title()"),
        "启动参数区没有走目录（注释里写不算）"
    );
}

/// **死 key 守门**：目录里每一条 `Instances*` 都必须被页面（或产品快照转换）真的引用。
///
/// M117 加的那七条就是这么沉的：目录里写着，页面上一个都没用。扫描是字面出现的
/// `Key::<名字>`，所以用宏拼 key 名能骗过它——这个局限写在这里，不假装它更强。
#[test]
fn every_instances_key_is_referenced_by_the_page() {
    for key in Texts::keys() {
        let needle = format!("Key::{}", key.name());
        assert!(
            PAGE_SOURCES
                .iter()
                .any(|(_, source)| source.contains(&needle)),
            "{needle} 在目录里定义了，但实例页没有任何地方用它（死 key，删掉或接上）"
        );
    }
}