Git: components 301-320

docs/components/303-three-way-merge.md

@@ -0,0 +1,53 @@
+# 303 ThreeWayMerge 三方合并
+
+## 用途
+
+以本地、基准、远端三栏和结果栏显示三方合并，逐块采纳本地、远端、两者或基准。
+
+## 最小示例
+
+```go
+var state mujica.ThreeWayMergeState
+base, local, remote := "a\nb\nc", "a\nB1\nc", "a\nB2\nc"
+view := func(c *ui.Context) {
+	mujica.Use(c, mujica.Settings{})
+	r := mujica.ThreeWayMerge(c, &state, base, local, remote, mujica.ThreeWayMergeOptions{})
+	r.Element.Height(280)
+	if done, total := state.Resolved(); r.Changed() && done == total {
+		_ = state.Result() // write the merged file
+	}
+}
+ui.Render(view, 400, 300, 1)
+```
+
+签名：`func ThreeWayMerge(c *ui.Context, s *ThreeWayMergeState, base, ours, theirs string, opts ThreeWayMergeOptions) ChoiceResult`
+
+## 参数
+
+`ThreeWayMergeOptions`
+
+| 字段 | 类型 | 默认值 | 含义 |
+| --- | --- | --- | --- |
+| Disabled | bool | false | 禁用采纳。 |
+
+`ThreeWayMergeState.Result()` 返回合并文本，未解决的冲突保留冲突标记；`Resolved()` 返回已解决与总冲突数。分块只在三段文本改变时计算。给返回的 `Element` 一个高度。
+
+## 状态
+
+- 只有一侧修改或两侧相同修改的块自动合并，来源一侧以浅色底标出。
+- 冲突块在结果栏显示 Danger 色“未解决”与警示图标。
+- 已采纳的按钮为 Selection 底、AccentText 边框与对勾。
+- 较长的未变更块只显示首尾各两行。
+
+## 事件
+
+- `Changed()`：某个冲突的选择改变。
+
+## 键盘操作
+
+- 列表可获得焦点并滚动；采纳按钮用 Tab 到达，Enter 或 Space 选择。
+
+## 限制
+
+- 按行合并，不做词级合并。
+- 相邻（中间没有未变更行）的两侧修改视为冲突。