@derekhut/alvy 1.0.0

package/README.md

@@ -0,0 +1,96 @@
+# alvy 词根学习
+
+终端词根记忆工具，用新东方词根词缀记忆法帮你拆解英语单词。
+
+30个词根 × 5个单词 = 150个核心词汇
+
+## 安装
+
+### macOS / Linux
+
+需要 Node.js 18+。如果没有，安装脚本会自动安装。
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/derekhut/alvy/main/install.sh | bash
+```
+
+### Windows
+
+```powershell
+winget install OpenJS.NodeJS.LTS
+npm install -g @derekhut/alvy
+```
+
+## 命令
+
+| 命令 | 说明 |
+|------|------|
+| `alvy` | 开始今天的学习（每次3个词根） |
+| `alvy review` | 复习已学词根 |
+| `alvy stats` | 导出学习进度 |
+| `alvy doctor` | 检查运行环境 |
+
+## 学习方式
+
+每个单词通过词根推导链来记忆：
+
+```
+bene(好的) + fit(做) → 做好事 → 益处
+bene(好的) + vol(意愿) + ent(…的) → 有好意愿的 → 仁慈的
+pre(提前) + dict(说) → 提前说出 → 预测
+```
+
+每次学习3个词根，每个词根5个单词。按回车逐个学习，每个单词都有词根拆解、推导链、中文释义和例句。
+
+## 操作方式
+
+- **Enter** — 下一步（进入下一个单词/词根）
+- **q** — 退出（自动保存进度）
+- **Ctrl+C** — 退出（自动保存进度）
+
+## 数据存储
+
+学习进度保存在 `~/.alvy/data.json`。
+
+- 首次运行自动创建该文件
+- 从旧版（`~/.toefl-roots/`）升级时自动迁移数据
+- 如果文件损坏，自动备份至 `data.backup.json` 并重新开始
+- 重置进度：删除 `~/.alvy/data.json` 即可从头开始
+
+```bash
+# 查看进度文件
+cat ~/.alvy/data.json
+
+# 重置所有进度
+rm ~/.alvy/data.json
+```
+
+## 卸载
+
+```bash
+npm uninstall -g @derekhut/alvy
+```
+
+## 开发
+
+### 项目结构
+
+```
+src/
+  index.tsx           # CLI 入口
+  app.tsx             # 命令路由
+  components/         # UI 组件（Ink/React）
+  lib/                # 业务逻辑和数据层
+  data/roots.json     # 词根数据库
+DESIGN.md             # 设计系统
+ARCHITECTURE.md       # 架构文档
+```
+
+### 开发命令
+
+```bash
+npm run build          # 编译 TypeScript
+npm run dev            # 监听模式编译
+npm test               # 运行测试
+node dist/index.js     # 运行
+```

package/dist/app.d.ts

@@ -0,0 +1,6 @@
+import type { Command } from "./lib/types.js";
+interface AppProps {
+    command: Command;
+}
+export default function App({ command }: AppProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/app.js

@@ -0,0 +1,17 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import Doctor from "./components/doctor.js";
+import DailySession from "./components/daily-session.js";
+import ReviewSession from "./components/review-session.js";
+import Stats from "./components/stats.js";
+export default function App({ command }) {
+    switch (command) {
+        case "daily":
+            return _jsx(DailySession, {});
+        case "review":
+            return _jsx(ReviewSession, {});
+        case "stats":
+            return _jsx(Stats, {});
+        case "doctor":
+            return _jsx(Doctor, {});
+    }
+}

package/dist/components/celebration.d.ts

@@ -0,0 +1,7 @@
+import type { UserData } from "../lib/types.js";
+interface CelebrationProps {
+    data: UserData;
+    totalRoots: number;
+}
+export default function Celebration({ data, totalRoots }: CelebrationProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/components/celebration.js

@@ -0,0 +1,8 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from "ink";
+export default function Celebration({ data, totalRoots }) {
+    const totalWords = Array.isArray(data.wordsStudied)
+        ? data.wordsStudied.length
+        : 0;
+    return (_jsx(Box, { flexDirection: "column", paddingLeft: 2, paddingY: 1, children: _jsxs(Box, { flexDirection: "column", borderStyle: "double", borderColor: "#FFAF00", paddingX: 2, paddingY: 1, children: [_jsx(Text, { bold: true, color: "#FFAF00", children: "\uD83C\uDF31 \u606D\u559C\u4F60\uFF01\u5168\u90E8\u8BCD\u6839\u5B66\u4E60\u5B8C\u6210\uFF01" }), _jsx(Box, { marginTop: 1, children: _jsxs(Text, { children: ["\u4F60\u5DF2\u7ECF\u5B66\u4E60\u4E86\u6240\u6709 ", _jsx(Text, { bold: true, color: "#FFAF00", children: totalRoots }), " \u4E2A\u8BCD\u6839\uFF01"] }) }), _jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsxs(Text, { children: ["\u2B50 \u603B\u7ECF\u9A8C\u503C: ", _jsx(Text, { bold: true, color: "#FFAF00", children: data.xp.total }), " XP"] }), _jsxs(Text, { children: ["\uD83D\uDD25 \u6700\u957F\u8FDE\u7EED: ", _jsx(Text, { bold: true, color: "#FFAF00", children: data.streak.longest }), " \u5929"] }), _jsxs(Text, { children: ["\uD83D\uDCDA \u5DF2\u5B66\u5355\u8BCD: ", _jsx(Text, { bold: true, color: "#FFAF00", children: totalWords }), " \u4E2A"] })] }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: "\u7EE7\u7EED\u4F7F\u7528 alvy review \u6765\u590D\u4E60\u5DE9\u56FA\uFF01" }) })] }) }));
+}

package/dist/components/cjk-test.d.ts

@@ -0,0 +1 @@
+export default function CjkTest(): import("react/jsx-runtime").JSX.Element;

package/dist/components/cjk-test.js

@@ -0,0 +1,57 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from "ink";
+import RootLesson from "./root-lesson.js";
+// Sample entry for CJK alignment testing
+const sampleEntry = {
+    root: "bene-",
+    type: "root",
+    meaning_en: "good, well",
+    meaning_zh: "好的，善良的",
+    origin: "Latin",
+    related: ["mal-"],
+    words: [
+        {
+            word: "benefit",
+            breakdown: "bene-(好的) + fit-(做)",
+            meaning_en: "an advantage or profit",
+            meaning_zh: "益处，好处",
+            example: "Exercise has many health benefits.",
+            toefl_frequency: "high",
+        },
+        {
+            word: "benevolent",
+            breakdown: "bene-(好的) + vol-(愿意) + -ent(形容词)",
+            meaning_en: "well-meaning and kindly",
+            meaning_zh: "仁慈的，善意的",
+            example: "The benevolent donor gave millions to charity.",
+            toefl_frequency: "medium",
+        },
+        {
+            word: "benefactor",
+            breakdown: "bene-(好的) + fact-(做) + -or(人)",
+            meaning_en: "a person who gives money or help",
+            meaning_zh: "恩人，捐助者",
+            example: "The university honored its greatest benefactor.",
+            toefl_frequency: "medium",
+        },
+        {
+            word: "benediction",
+            breakdown: "bene-(好的) + dict-(说) + -ion(名词)",
+            meaning_en: "a blessing or prayer",
+            meaning_zh: "祝福，祈祷",
+            example: "The priest offered a benediction at the ceremony.",
+            toefl_frequency: "low",
+        },
+        {
+            word: "beneficial",
+            breakdown: "bene-(好的) + fic-(做) + -ial(形容词)",
+            meaning_en: "favorable or advantageous",
+            meaning_zh: "有益的，有利的",
+            example: "A balanced diet is beneficial to your health.",
+            toefl_frequency: "high",
+        },
+    ],
+};
+export default function CjkTest() {
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Box, { borderStyle: "double", borderColor: "magenta", paddingX: 1, marginBottom: 1, children: _jsx(Text, { bold: true, color: "magenta", children: "CJK Alignment Test \u2014 \u4E2D\u6587\u5BF9\u9F50\u6D4B\u8BD5" }) }), _jsx(RootLesson, { entry: sampleEntry, index: 0, total: 1, relatedMeanings: { "mal-": "bad, evil 坏的" }, onContinue: () => { } })] }));
+}

package/dist/components/daily-session.d.ts

@@ -0,0 +1 @@
+export default function DailySession(): import("react/jsx-runtime").JSX.Element;

package/dist/components/daily-session.js

@@ -0,0 +1,128 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState, useEffect, useCallback } from "react";
+import { Box, useInput, useApp } from "ink";
+import { loadData, saveData } from "../lib/store.js";
+import { getAllRoots, getRootCount, getRelatedMeanings } from "../lib/roots-db.js";
+import { selectNextMorphemes, markRootSeen, markWordStudied, addXP, updateStreak, masteredCount, } from "../lib/progress.js";
+import Dashboard from "./dashboard.js";
+import RootLesson from "./root-lesson.js";
+import WordDetail from "./word-detail.js";
+import SessionSummary from "./session-summary.js";
+import Celebration from "./celebration.js";
+import StreakHeader from "./streak-header.js";
+export default function DailySession() {
+    const { exit } = useApp();
+    const [data, setData] = useState(() => loadData());
+    const [phase, setPhase] = useState("dashboard");
+    const [morphemes, setMorphemes] = useState([]);
+    const [morphemeIdx, setMorphemeIdx] = useState(0);
+    const [wordIdx, setWordIdx] = useState(0);
+    // Session totals
+    const [sessionXP, setSessionXP] = useState(0);
+    const [sessionWords, setSessionWords] = useState(0);
+    const allRoots = getAllRoots();
+    const totalRoots = getRootCount();
+    // Save on unmount / SIGINT
+    useEffect(() => {
+        const save = () => saveData(data);
+        const handleSigint = () => {
+            save();
+            process.exit(0);
+        };
+        process.on("SIGINT", handleSigint);
+        return () => {
+            save();
+            process.removeListener("SIGINT", handleSigint);
+        };
+    }, [data]);
+    const startSession = useCallback(() => {
+        const selected = selectNextMorphemes(data, allRoots, data.dailyGoal);
+        if (selected.length === 0) {
+            setPhase("celebration");
+            return;
+        }
+        setMorphemes(selected);
+        setMorphemeIdx(0);
+        setPhase("root-intro");
+    }, [data, allRoots]);
+    const startWordWalkthrough = useCallback(() => {
+        const entry = morphemes[morphemeIdx];
+        const newData = { ...data };
+        markRootSeen(newData, entry.root);
+        setData(newData);
+        setWordIdx(0);
+        setPhase("word-detail");
+    }, [morphemes, morphemeIdx, data]);
+    const advanceWord = useCallback(() => {
+        const entry = morphemes[morphemeIdx];
+        const currentWord = entry.words[wordIdx];
+        // Mark word studied and add XP
+        const newData = { ...data };
+        markWordStudied(newData, entry.root, currentWord.word);
+        addXP(newData, 10);
+        setData(newData);
+        setSessionXP((x) => x + 10);
+        setSessionWords((w) => w + 1);
+        const nextWord = wordIdx + 1;
+        if (nextWord < entry.words.length) {
+            // More words in this root
+            setWordIdx(nextWord);
+        }
+        else {
+            // Root complete, move to next
+            const nextMorpheme = morphemeIdx + 1;
+            if (nextMorpheme < morphemes.length) {
+                setMorphemeIdx(nextMorpheme);
+                setPhase("root-intro");
+            }
+            else {
+                // Session complete
+                updateStreak(newData);
+                setData(newData);
+                saveData(newData);
+                if (masteredCount(newData) >= totalRoots) {
+                    setPhase("celebration");
+                }
+                else {
+                    setPhase("summary");
+                }
+            }
+        }
+    }, [morphemes, morphemeIdx, wordIdx, data, totalRoots]);
+    useInput((input, key) => {
+        if (input === "q") {
+            saveData(data);
+            exit();
+            return;
+        }
+        if (key.return) {
+            switch (phase) {
+                case "dashboard":
+                    startSession();
+                    break;
+                case "root-intro":
+                    startWordWalkthrough();
+                    break;
+                case "word-detail":
+                    advanceWord();
+                    break;
+                case "summary":
+                case "celebration":
+                    exit();
+                    break;
+            }
+        }
+    });
+    switch (phase) {
+        case "dashboard":
+            return _jsx(Dashboard, { data: data, totalRoots: totalRoots });
+        case "root-intro":
+            return (_jsxs(Box, { flexDirection: "column", children: [_jsx(StreakHeader, { data: data, totalRoots: totalRoots }), _jsx(RootLesson, { entry: morphemes[morphemeIdx], index: morphemeIdx, total: morphemes.length, relatedMeanings: getRelatedMeanings(morphemes[morphemeIdx]) })] }));
+        case "word-detail":
+            return (_jsxs(Box, { flexDirection: "column", children: [_jsx(StreakHeader, { data: data, totalRoots: totalRoots }), _jsx(WordDetail, { word: morphemes[morphemeIdx].words[wordIdx], wordNum: wordIdx + 1, totalWords: morphemes[morphemeIdx].words.length, rootKey: morphemes[morphemeIdx].root })] }));
+        case "summary":
+            return (_jsx(SessionSummary, { xpEarned: sessionXP, wordsLearned: sessionWords, rootsStudied: morphemes.length, streak: data.streak.current }));
+        case "celebration":
+            return _jsx(Celebration, { data: data, totalRoots: totalRoots });
+    }
+}

package/dist/components/dashboard.d.ts

@@ -0,0 +1,7 @@
+import type { UserData } from "../lib/types.js";
+interface DashboardProps {
+    data: UserData;
+    totalRoots: number;
+}
+export default function Dashboard({ data, totalRoots }: DashboardProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/components/dashboard.js

@@ -0,0 +1,13 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from "ink";
+import { masteredCount, seenCount } from "../lib/progress.js";
+export default function Dashboard({ data, totalRoots }) {
+    const mastered = masteredCount(data);
+    const seen = seenCount(data);
+    const barWidth = 30;
+    const filled = Math.round((mastered / totalRoots) * barWidth);
+    const empty = barWidth - filled;
+    const bar = "█".repeat(filled) + "░".repeat(empty);
+    const pct = totalRoots > 0 ? Math.round((mastered / totalRoots) * 100) : 0;
+    return (_jsxs(Box, { flexDirection: "column", paddingLeft: 2, paddingY: 1, children: [_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: "#4E4E4E", paddingX: 2, paddingY: 1, children: [_jsxs(Text, { children: [_jsx(Text, { bold: true, color: "#AF5FFF", children: "alvy" }), _jsx(Text, { color: "#AF5FFF", children: " \u8BCD\u6839\u5B66\u4E60" })] }), _jsx(Text, { dimColor: true, children: "\u89E3\u9501\u82F1\u8BED\u7684\u5E95\u5C42\u903B\u8F91" }), _jsxs(Box, { marginTop: 1, gap: 3, children: [_jsxs(Text, { children: ["\uD83D\uDD25 \u8FDE\u7EED ", _jsx(Text, { bold: true, color: "#FFAF00", children: data.streak.current }), " \u5929"] }), _jsxs(Text, { children: ["\u2B50 ", _jsx(Text, { bold: true, color: "#FFAF00", children: data.xp.total }), " XP"] })] }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsxs(Text, { children: ["\u8FDB\u5EA6: ", _jsxs(Text, { bold: true, color: "#FFAF00", children: [mastered, "/", totalRoots] }), " \u5DF2\u638C\u63E1\uFF08", seen, " \u5DF2\u5B66\u4E60\uFF09"] }), _jsxs(Box, { children: [_jsx(Text, { color: "#AF5FFF", children: bar }), _jsxs(Text, { children: [" ", pct, "%"] })] })] }), data.streak.longest > 1 && (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { dimColor: true, children: ["\u6700\u957F\u8FDE\u7EED: ", data.streak.longest, " \u5929"] }) }))] }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: "\u6309\u56DE\u8F66\u5F00\u59CB\u4ECA\u5929\u7684\u5B66\u4E60 \u2192" }) })] }));
+}

package/dist/components/doctor.d.ts

@@ -0,0 +1 @@
+export default function Doctor(): import("react/jsx-runtime").JSX.Element;

package/dist/components/doctor.js

@@ -0,0 +1,120 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useState } from "react";
+import { Box, Text } from "ink";
+import { execSync } from "node:child_process";
+import fs from "node:fs";
+import path from "node:path";
+import { DATA_DIR } from "../lib/store.js";
+export default function Doctor() {
+    const [checks, setChecks] = useState([
+        { label: "Node.js 版本", status: "pending", detail: "" },
+        { label: "npm 访问", status: "pending", detail: "" },
+        { label: "中文字体渲染", status: "pending", detail: "" },
+        { label: "数据目录", status: "pending", detail: "" },
+    ]);
+    const [done, setDone] = useState(false);
+    useEffect(() => {
+        const results = [];
+        // 1. Node.js version (>= 18 required)
+        const nodeVersion = process.version;
+        const major = parseInt(nodeVersion.slice(1).split(".")[0], 10);
+        if (major >= 18) {
+            results.push({
+                label: "Node.js 版本",
+                status: "pass",
+                detail: `${nodeVersion}（需要 >= 18）`,
+            });
+        }
+        else {
+            results.push({
+                label: "Node.js 版本",
+                status: "fail",
+                detail: `${nodeVersion} — 需要 Node.js 18+，请访问 https://nodejs.org`,
+            });
+        }
+        // 2. npm access
+        try {
+            const npmVersion = execSync("npm --version", { encoding: "utf-8" }).trim();
+            results.push({
+                label: "npm 访问",
+                status: "pass",
+                detail: `npm ${npmVersion}`,
+            });
+        }
+        catch {
+            results.push({
+                label: "npm 访问",
+                status: "fail",
+                detail: "未找到 npm，请确认 Node.js 安装正确",
+            });
+        }
+        // 3. CJK font rendering test
+        const lang = process.env["LANG"] || process.env["LC_ALL"] || "";
+        const hasUtf8 = lang.toLowerCase().includes("utf") || process.platform === "darwin";
+        if (hasUtf8) {
+            results.push({
+                label: "中文字体渲染",
+                status: "pass",
+                detail: `检测到 UTF-8（${lang || "macOS 默认"}）测试: 善良 仁慈 好的`,
+            });
+        }
+        else {
+            results.push({
+                label: "中文字体渲染",
+                status: "warn",
+                detail: `当前: "${lang}"，请设置 LANG=en_US.UTF-8 以支持中文。测试: 善良 仁慈 好的`,
+            });
+        }
+        // 4. Data directory (~/.alvy/)
+        try {
+            if (!fs.existsSync(DATA_DIR)) {
+                fs.mkdirSync(DATA_DIR, { recursive: true });
+            }
+            // Test write permission
+            const testFile = path.join(DATA_DIR, ".doctor-test");
+            fs.writeFileSync(testFile, "ok");
+            fs.unlinkSync(testFile);
+            results.push({
+                label: "数据目录",
+                status: "pass",
+                detail: `${DATA_DIR}（可写）`,
+            });
+        }
+        catch (err) {
+            results.push({
+                label: "数据目录",
+                status: "fail",
+                detail: `无法写入 ${DATA_DIR}: ${err instanceof Error ? err.message : String(err)}`,
+            });
+        }
+        setChecks(results);
+        setDone(true);
+    }, []);
+    const icon = (status) => {
+        switch (status) {
+            case "pass":
+                return "✓";
+            case "fail":
+                return "✗";
+            case "warn":
+                return "!";
+            case "pending":
+                return "…";
+        }
+    };
+    const color = (status) => {
+        switch (status) {
+            case "pass":
+                return "#5FD7FF";
+            case "fail":
+                return "#FF5F87";
+            case "warn":
+                return "#FFAF00";
+            case "pending":
+                return "#6C6C6C";
+        }
+    };
+    const passCount = checks.filter((c) => c.status === "pass").length;
+    const failCount = checks.filter((c) => c.status === "fail").length;
+    return (_jsxs(Box, { flexDirection: "column", paddingLeft: 2, paddingY: 1, children: [_jsx(Text, { bold: true, color: "#AF5FFF", children: "alvy \u73AF\u5883\u68C0\u67E5" }), _jsx(Text, { dimColor: true, children: "\u6B63\u5728\u68C0\u67E5\u4F60\u7684\u73AF\u5883\u2026" }), _jsx(Box, { flexDirection: "column", marginTop: 1, children: checks.map((check) => (_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: color(check.status), children: icon(check.status) }), _jsx(Text, { bold: true, children: check.label }), _jsx(Text, { dimColor: true, children: check.detail })] }, check.label))) }), done && (_jsx(Box, { marginTop: 1, children: failCount === 0 ? (_jsxs(Text, { color: "#5FD7FF", bold: true, children: ["\u5168\u90E8\u68C0\u67E5\u901A\u8FC7 (", passCount, "/", checks.length, ")\uFF0C\u53EF\u4EE5\u5F00\u59CB\u5B66\u4E60\uFF01"] })) : (_jsxs(Text, { color: "#FF5F87", bold: true, children: [failCount, " \u9879\u68C0\u67E5\u672A\u901A\u8FC7\uFF0C\u8BF7\u5148\u89E3\u51B3\u4E0A\u9762\u7684\u95EE\u9898\u3002"] })) }))] }));
+}

package/dist/components/explore.d.ts

@@ -0,0 +1 @@
+export default function Explore(): import("react/jsx-runtime").JSX.Element;

package/dist/components/explore.js

@@ -0,0 +1,5 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from "ink";
+export default function Explore() {
+    return (_jsxs(Box, { flexDirection: "column", paddingLeft: 2, paddingY: 1, children: [_jsx(Box, { borderStyle: "round", borderColor: "#4E4E4E", paddingX: 2, paddingY: 1, children: _jsx(Text, { dimColor: true, children: "\u63A2\u7D22\u6A21\u5F0F \u2014 \u5373\u5C06\u5728 V2 \u63A8\u51FA" }) }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: "AI \u9A71\u52A8\u7684\u8BCD\u6839\u63A2\u7D22\u529F\u80FD\u5C06\u5728\u672A\u6765\u66F4\u65B0\u4E2D\u63A8\u51FA\u3002" }) })] }));
+}

package/dist/components/result.d.ts

@@ -0,0 +1,7 @@
+import type { RootWord } from "../lib/types.js";
+interface ResultProps {
+    word: RootWord;
+    isCorrect: boolean;
+}
+export default function Result({ word, isCorrect }: ResultProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/components/result.js

@@ -0,0 +1,5 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from "ink";
+export default function Result({ word, isCorrect }) {
+    return (_jsx(Box, { flexDirection: "column", paddingX: 1, children: _jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: isCorrect ? "green" : "red", paddingX: 2, paddingY: 1, children: [_jsx(Text, { bold: true, color: isCorrect ? "green" : "red", children: isCorrect ? "✓ Correct!" : "✗ Incorrect" }), _jsx(Box, { marginTop: 1, children: _jsxs(Text, { children: [_jsx(Text, { bold: true, children: word.word }), " = ", word.breakdown] }) }), _jsx(Box, { marginTop: 1, gap: 2, children: _jsxs(Text, { children: ["English: ", word.meaning_en] }) }), _jsx(Box, { gap: 2, children: _jsxs(Text, { children: ["\u4E2D\u6587: ", _jsx(Text, { color: "yellow", children: word.meaning_zh })] }) }), _jsx(Box, { marginTop: 1, children: _jsxs(Text, { dimColor: true, italic: true, children: ["\"", word.example, "\""] }) })] }) }));
+}

package/dist/components/review-session.d.ts

@@ -0,0 +1 @@
+export default function ReviewSession(): import("react/jsx-runtime").JSX.Element;

package/dist/components/review-session.js

@@ -0,0 +1,108 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState, useEffect, useCallback } from "react";
+import { Box, Text, useInput, useApp } from "ink";
+import { loadData, saveData } from "../lib/store.js";
+import { getAllRoots, getRootCount, getRelatedMeanings } from "../lib/roots-db.js";
+import { markWordStudied, addXP, updateStreak, } from "../lib/progress.js";
+import RootLesson from "./root-lesson.js";
+import WordDetail from "./word-detail.js";
+import SessionSummary from "./session-summary.js";
+import StreakHeader from "./streak-header.js";
+export default function ReviewSession() {
+    const { exit } = useApp();
+    const [data, setData] = useState(() => loadData());
+    const allRoots = getAllRoots();
+    const totalRoots = getRootCount();
+    // Review: pick seen roots, sorted by fewest words studied
+    const reviewMorphemes = allRoots
+        .filter((r) => data.rootProgress[r.root]?.seen)
+        .sort((a, b) => {
+        const wA = data.rootProgress[a.root]?.wordsStudied ?? 0;
+        const wB = data.rootProgress[b.root]?.wordsStudied ?? 0;
+        return wA - wB;
+    })
+        .slice(0, 3);
+    const [phase, setPhase] = useState(reviewMorphemes.length === 0 ? "empty" : "intro");
+    const [morphemeIdx, setMorphemeIdx] = useState(0);
+    const [wordIdx, setWordIdx] = useState(0);
+    const [sessionXP, setSessionXP] = useState(0);
+    const [sessionWords, setSessionWords] = useState(0);
+    useEffect(() => {
+        const save = () => saveData(data);
+        const handleSigint = () => {
+            save();
+            process.exit(0);
+        };
+        process.on("SIGINT", handleSigint);
+        return () => {
+            save();
+            process.removeListener("SIGINT", handleSigint);
+        };
+    }, [data]);
+    const startWordWalkthrough = useCallback(() => {
+        setWordIdx(0);
+        setPhase("word-detail");
+    }, []);
+    const advanceWord = useCallback(() => {
+        const entry = reviewMorphemes[morphemeIdx];
+        const currentWord = entry.words[wordIdx];
+        const newData = { ...data };
+        markWordStudied(newData, entry.root, currentWord.word);
+        addXP(newData, 10);
+        setData(newData);
+        setSessionXP((x) => x + 10);
+        setSessionWords((w) => w + 1);
+        const nextWord = wordIdx + 1;
+        if (nextWord < entry.words.length) {
+            setWordIdx(nextWord);
+        }
+        else {
+            const nextMorpheme = morphemeIdx + 1;
+            if (nextMorpheme < reviewMorphemes.length) {
+                setMorphemeIdx(nextMorpheme);
+                setPhase("root-intro");
+            }
+            else {
+                updateStreak(newData);
+                setData(newData);
+                saveData(newData);
+                setPhase("summary");
+            }
+        }
+    }, [reviewMorphemes, morphemeIdx, wordIdx, data]);
+    useInput((input, key) => {
+        if (input === "q") {
+            saveData(data);
+            exit();
+            return;
+        }
+        if (key.return) {
+            switch (phase) {
+                case "intro":
+                case "root-intro":
+                    startWordWalkthrough();
+                    break;
+                case "word-detail":
+                    advanceWord();
+                    break;
+                case "summary":
+                case "empty":
+                    exit();
+                    break;
+            }
+        }
+    });
+    if (phase === "empty") {
+        return (_jsxs(Box, { flexDirection: "column", paddingLeft: 2, paddingY: 1, children: [_jsx(Text, { bold: true, color: "#AF5FFF", children: "\u8FD8\u6CA1\u6709\u53EF\u4EE5\u590D\u4E60\u7684\u8BCD\u6839" }), _jsx(Text, { children: "\u5148\u8FD0\u884C alvy \u5B66\u4E60\u65B0\u8BCD\u6839\u5427\uFF01" }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: "\u6309\u56DE\u8F66\u9000\u51FA" }) })] }));
+    }
+    switch (phase) {
+        case "intro":
+            return (_jsxs(Box, { flexDirection: "column", paddingLeft: 2, paddingY: 1, children: [_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: "#4E4E4E", paddingX: 2, paddingY: 1, children: [_jsx(Text, { bold: true, color: "#AF5FFF", children: "\u590D\u4E60\u6A21\u5F0F" }), _jsxs(Text, { children: ["\u4ECA\u5929\u590D\u4E60 ", reviewMorphemes.length, " \u4E2A\u8BCD\u6839:"] }), _jsx(Box, { marginTop: 1, flexDirection: "column", children: reviewMorphemes.map((r) => (_jsxs(Text, { children: ["\u00B7 ", r.root, " (", _jsx(Text, { dimColor: true, children: r.meaning_zh }), ")"] }, r.root))) })] }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: "\u6309\u56DE\u8F66\u5F00\u59CB \u2192" }) })] }));
+        case "root-intro":
+            return (_jsxs(Box, { flexDirection: "column", children: [_jsx(StreakHeader, { data: data, totalRoots: totalRoots }), _jsx(RootLesson, { entry: reviewMorphemes[morphemeIdx], index: morphemeIdx, total: reviewMorphemes.length, relatedMeanings: getRelatedMeanings(reviewMorphemes[morphemeIdx]) })] }));
+        case "word-detail":
+            return (_jsxs(Box, { flexDirection: "column", children: [_jsx(StreakHeader, { data: data, totalRoots: totalRoots }), _jsx(WordDetail, { word: reviewMorphemes[morphemeIdx].words[wordIdx], wordNum: wordIdx + 1, totalWords: reviewMorphemes[morphemeIdx].words.length, rootKey: reviewMorphemes[morphemeIdx].root })] }));
+        case "summary":
+            return (_jsx(SessionSummary, { xpEarned: sessionXP, wordsLearned: sessionWords, rootsStudied: reviewMorphemes.length, streak: data.streak.current }));
+    }
+}

package/dist/components/root-lesson.d.ts

@@ -0,0 +1,9 @@
+import type { RootEntry } from "../lib/types.js";
+interface RootLessonProps {
+    entry: RootEntry;
+    index: number;
+    total: number;
+    relatedMeanings?: Record<string, string>;
+}
+export default function RootLesson({ entry, index, total, relatedMeanings, }: RootLessonProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/components/root-lesson.js

@@ -0,0 +1,8 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { Box, Text } from "ink";
+export default function RootLesson({ entry, index, total, relatedMeanings, }) {
+    const typeLabel = entry.type === "root" ? "词根" : entry.type === "prefix" ? "前缀" : "后缀";
+    return (_jsxs(Box, { flexDirection: "column", paddingLeft: 2, paddingY: 1, children: [_jsxs(Text, { dimColor: true, children: ["\u8BCD\u6839 ", index + 1, "/", total] }), _jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: "#4E4E4E", paddingX: 2, paddingY: 1, marginTop: 1, children: [_jsxs(Box, { gap: 2, children: [_jsx(Text, { bold: true, color: "#AF5FFF", children: entry.root }), _jsxs(Text, { dimColor: true, children: ["(", entry.origin, ")"] }), _jsx(Text, { dimColor: true, children: typeLabel })] }), _jsx(Box, { marginTop: 1, children: _jsxs(Text, { children: ["\u8868\u793A \"", _jsx(Text, { dimColor: true, children: entry.meaning_zh }), "\"\uFF08", entry.meaning_en, "\uFF09"] }) }), entry.related.length > 0 && (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { dimColor: true, children: ["\u76F8\u5173:", " ", entry.related
+                                    .map((r) => relatedMeanings?.[r] ? `${r}(${relatedMeanings[r]})` : r)
+                                    .join("、")] }) }))] }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { dimColor: true, children: "\u5305\u542B\u8FD9\u4E2A\u8BCD\u6839\u7684\u5355\u8BCD:" }), _jsx(Box, { marginTop: 0, gap: 2, flexWrap: "wrap", children: entry.words.map((w) => (_jsx(Text, { bold: true, children: w.word }, w.word))) })] }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: "\u6309\u56DE\u8F66\u9010\u4E2A\u5B66\u4E60 \u2192" }) })] }));
+}

package/dist/components/session-summary.d.ts

@@ -0,0 +1,8 @@
+interface SessionSummaryProps {
+    xpEarned: number;
+    wordsLearned: number;
+    rootsStudied: number;
+    streak: number;
+}
+export default function SessionSummary({ xpEarned, wordsLearned, rootsStudied, streak, }: SessionSummaryProps): import("react/jsx-runtime").JSX.Element;
+export {};