[JavaZeroo]

问题与最终行为

#29 的四层堆叠 PR 无法重基到 main：分支是 view_mapping / origin 路线，而 main 已落地 #169 的行存储路线（owned id、sealed rows、history_view.hpp 80 行）。

证据：

文件	main	分支
history_view.hpp	80 行，owned/anchor	268 行，Piece/DisplayRow/Layout/ViewMapping
view_mapping.hpp	不存在	81 行
text_document.hpp	96 行，带 epoch、精确 index_of、order_revision、compare	81 行，无 epoch、index_of 用 lower_bound_line 会吸附邻居

main 的 text_document.hpp 比分支的更新。 所以本 PR 不采纳分支的整套行模型，只把其中可叠加的一层引入：显示页的每个片段携带它在源文档中的区间。

最终行为：

• ViewMapping::hit() 把显示行列回映到 TextPosition
• ViewMapping::project() 把文档区间投影回显示单元格
• Screen 的行存储、历史与淘汰策略完全不变

与分支原版的必要适配

1. 分支的 before() 用 line_id 排序。main 明确规定「id 不定义文档顺序」，改为 TextDocument::compare()——对重排行仍正确，并顺带获得 epoch 校验。
2. main 的 TextPosition 带 epoch。映射因此会拒绝在旧缓冲区页面采集的坐标，而不是按 id 误判为有效。

验证

本机实际构建并运行（cmake -G "Visual Studio 17 2022" -A x64，Release）：

view_mapping_test.vcxproj -> build\bin\Release\view_mapping_test.exe
view mapping checks passed            (exit 0)
owned buffer state checks passed      (exit 0，既有测试未受影响)

测试覆盖三条路径：

1. 等宽片段的显示列 → 源列偏移映射
2. 尾部合成填充没有独立源坐标，回落到最后一个片段的 end
3. 切换缓冲区使 epoch 前进后，旧映射的 hit/project 均返回空

性能影响（如适用）

不适用。纯新增头文件与测试；未接入绘制或输入路径，运行期无调用方。

来源与限制

• 来源：fix/history-viewport-r29 的 view_mapping.hpp，按 main 的 TextDocument API 适配
• 限制：本 PR 只提供映射层，不接入 selection/Find/renderer。真正获得 reflow 感知的选择与查找，需要在 [R2-07][文字] 验收复杂 Unicode、IME 与键盘/选择语义 #30/[R2-06][终端] 定义并验证 resize、逻辑行与历史语义 #29 的后续切片里把该层接到消费者上
• 其余 18 个提交仍留在原分支：它们实现的是分支那条行模型路线，与已合入的 [R2][核心基础] 封装行结构发布并解耦稳定身份与文档顺序 #169 冲突，需要单独裁决