51 lines
1.9 KiB
Markdown
51 lines
1.9 KiB
Markdown
# golden-tests（任务清单）
|
||
|
||
> 目标：建立 Golden Cases 与性质测试（determinism/monotonic/maxLines）回归体系，保证算法演进可控。
|
||
|
||
## 0. 对齐与准备
|
||
|
||
- [x] 阅读并对齐口径
|
||
- [x] 阅读 `spec_kit/Text Wrap/modules/golden-tests/spec.md`
|
||
- [x] 阅读 `spec_kit/Text Wrap/modules/golden-tests/plan.md`
|
||
- [x] 阅读 `设计说明文档/文档换行算法.md` 的 16.1/16.2 章节
|
||
- [x] 创建客户端测试目录
|
||
- [x] 新建 `client/src/features/textWrap/golden/`
|
||
|
||
## 1. Golden fixtures
|
||
|
||
- [x] 新建 `client/src/features/textWrap/golden/fixtures.ts`
|
||
- [x] 定义 `GoldenCase` 类型（text/lang/context/availableWidth/maxLines 等）
|
||
- [x] 补充 EN/TC 基础样例集合（首版最小可运行）
|
||
- [x] 对每个 case 写入 `expected.lines/expected.wrappedText`
|
||
|
||
## 2. 测试 harness（临时串联）
|
||
|
||
- [x] 在测试中实现 `wrapTextHarness()`（仅用于测试）
|
||
- [x] normalizeWhitespace
|
||
- [x] EN tokenizeEN / TC segmentGraphemes
|
||
- [x] 使用“全断点集合”（1..N-1，首版避免候选裁剪影响）
|
||
- [x] APP：searchBestLayoutApp（测量 mock=length）
|
||
- [x] WIDGET：searchBestLayoutWidget（widthMode=APPROX，单位一致）
|
||
|
||
## 3. Golden cases 测试
|
||
|
||
- [x] 新建 `client/src/features/textWrap/golden/__tests__/golden.test.ts`
|
||
- [x] 遍历 fixtures，断言输出与 expected 完全一致
|
||
|
||
## 4. 性质测试（property tests）
|
||
|
||
- [x] 确定性：同输入运行多次输出一致
|
||
- [x] 近似单调性：availableWidth 变小不会让任一行变得更宽（同测量 mock 下，用 width=string.length）
|
||
- [x] maxLines 不变差：maxLines 增大时至少不从可解变 overflow（同测量 mock 下）
|
||
|
||
## 5. 收尾
|
||
|
||
- [x] 跑测试与类型检查
|
||
- [x] `npm test`
|
||
- [x] `npx tsc --noEmit`
|
||
- [x] 将本 `tasks.md` 全部勾选完成
|
||
- [x] 更新 `spec_kit/overview.md`
|
||
- [x] 标记 `golden-tests` 已完成（阶段性）
|
||
- [x] 写入变更文件清单
|
||
|