mindfulness/spec_kit/Text Wrap/modules/golden-tests/plan.md

golden-tests（技术计划）

1. 计划目标

建立可持续回归体系，覆盖：

• Golden Cases：固定输入 → 固定输出（lines/wrappedText/meta），作为“可治理基线”
• 性质测试（property tests）：
  • 确定性：同输入多次调用输出一致
  • 近似单调性：availableWidth 变小不会让任一行变得更宽（同测量口径下）
  • maxLines 不变差：maxLines 增加时至少不从可解变 overflow

本模块产出测试数据与测试规则，不产出业务功能。

2. 约束与策略

2.1 测量可控

• APP：使用稳定的测量 mock（例如 width = text.length）保证 CI 可运行
• WIDGET：使用固定 profile 或 widthMode=APPROX（单位为 tokenCount/graphemeCount）

2.2 Golden 的组织方式

• 采用 TS fixture（便于类型校验与可读性）
• Golden case 至少包含：
  • text/lang/context/availableWidth/maxLines/overflowMode/lineMode/configVersion
  • 期望：expected.lines/expected.wrappedText（可选 meta 断言）

2.3 覆盖面（首版）

首版优先覆盖“易回归且高价值”的样例集：

• EN/TC 各若干条：短/长、含标点/无标点、含 emoji、含 shift/accum/self、极窄宽度

说明：文档建议每种语言 20 条；首版先落最小可运行集合，后续迭代扩充但保持可解释与版本化。

3. 测试实现结构（客户端）

• client/src/features/textWrap/golden/fixtures.ts（Golden cases）
• client/src/features/textWrap/golden/__tests__/golden.test.ts
  • Golden 断言（lines/wrappedText）
  • 性质测试（determinism/monotonic/maxLines）

测试内暂时使用“测试版 wrapTextHarness”把已实现模块串起来：

• normalize/tokenize（EN=tokenizeEN，TC=segmentGraphemes）
• generateBreakpoints
• search-engine-app / search-engine-widget

待 integration 模块产出正式 wrapText() 后，再把测试入口切到正式函数（不改变期望数据）。

4. 完成定义（DoD）

• Golden fixtures + 测试可在 CI 一键运行
• 至少包含 EN/TC 的基础样例与 3 类性质测试
• overview 更新记录变更文件