Map DOM mouse button aliases

Author: SqlRush

docs/cc-100-roadmap.md

@@ -700,6 +700,8 @@ M7 补充：prompt history `LogEntry` 读取现在接受 `sessionID`/`session`/`
 
 本轮补充：interaction script mouse payload 现在可从 `wheel`/`mousewheel`、`scrollUp`/`scrollDown`、`direction`、`deltaY` 和旧式 `wheelDelta` 推导 SGR wheel button，录制的 DOM/compact 滚轮事件可直接驱动 viewport 滚动。
 
+本轮补充：interaction script mouse payload 现在接受 DOM `which` 和 `buttons`/`buttonState` bitmask，并映射到 SGR left/middle/right button，避免录制脚本的右键/中键被误当成 primary click。
+
 本轮补充：prompt/image history 的 `ImageDimensions` 读取 `width`/`height` 或仅 original 尺寸时，会默认 display 尺寸等于 original 尺寸，避免只有单尺寸字段的 image fixture 丢失 source metadata。
 
 本轮补充：prompt history 的 pasted-content 类型现在会归一化 `inputImage`/`pasted-image`/`input_text`/`pasted-text` 等别名，runtime history 和 stored history 恢复都会映射到规范 `image`/`text`。

docs/claude-code-go-rewrite-plan.md

@@ -234,6 +234,7 @@ test/parity/                 # golden tests against TS/official behavior
 - 本轮补充：interaction script key 字段现在接受 DOM-style key event object，可从 `key`/`code`、`ctrlKey`/`altKey`/`metaKey`/`shiftKey` 和 `modifiers` 数组还原现有 key 名，wrapper payload 中的 key event 也可驱动脚本回放。
 - 本轮补充：interaction script mouse payload 现在可从 `mouseup`、`pointerUp`、`touchend` 等 event type 推导 release 状态；显式 release bool 仍优先生效。
 - 本轮补充：interaction script mouse payload 现在可从 `wheel`/`mousewheel`、`scrollUp`/`scrollDown`、`direction`、`deltaY` 和旧式 `wheelDelta` 推导 SGR wheel button，录制的 DOM/compact 滚轮事件可直接驱动 viewport 滚动。
+- 本轮补充：interaction script mouse payload 现在接受 DOM `which` 和 `buttons`/`buttonState` bitmask，并映射到 SGR left/middle/right button，避免录制脚本的右键/中键被误当成 primary click。
 - 本轮补充：嵌套 contract message 接受 `messageId`/`messageID`/`message_id` 和 `messageUuid`/`messageUUID`/`message_uuid` 作为自身 ID/UUID 别名，indexed resume 会保留 payload 自带的 nested message id。
 - 本轮补充：嵌套 contract message 的 primary `id` 现在接受 JSON number，`LoadTranscript` 和 indexed resume 会保留为字符串 message id。
 - 本轮补充：基础 `SessionEntry` JSONL loader 接受 `role`/`entryType`/`messageType`、message ID/UUID、parent ID/UUID 和 `sessionID`/`session`/session UUID 别名，旧 entry 文件可通过 `session.Load` 保留类型、parent 和 session。

docs/first-second-parity-audit.md

@@ -225,6 +225,7 @@ M7 progress now includes:
 - `internal/tui`: interaction script key fields now accept DOM-style key event objects with `key`/`code`, modifier booleans such as `ctrlKey`/`altKey`/`metaKey`/`shiftKey`, and modifier arrays, including wrapper payloads and modifier-only event filtering.
 - `internal/tui`: interaction script mouse payloads now infer release state from event type aliases such as `mouseup`, `pointerUp`, and `touchend`, while explicit release booleans still take precedence.
 - `internal/tui`: interaction script mouse payloads now infer SGR wheel buttons from DOM/compact wheel inputs such as `wheel`, `mousewheel`, `scrollUp`/`scrollDown`, `direction`, `deltaY`, and legacy `wheelDelta`, allowing recorded wheel events to drive viewport scrolling.
+- `internal/tui`: interaction script mouse payloads now accept DOM `which` and `buttons`/`buttonState` bitmasks and map them to SGR left/middle/right buttons so recorded secondary or auxiliary clicks are not treated as primary clicks.
 - `internal/tui`: task runtime now canonicalizes state aliases such as `active`/`in_progress`, `success`/`done`, `error`, and `canceled` before status-line summaries, task dialogs, ordering, cancellation, and scripted task expectations.
 - `internal/tui`: scripted task runtime payloads and task expectations now accept adjacent fields such as `taskID`, `jobId`, `runId`, `label`, `displayName`, `phase`, `taskState`, `message`, `currentStep`, `percent`, `percentage`, and numeric/string task IDs or progress values.
 - `internal/tui`: permission runtime now treats action aliases such as `Reject`, `deny`, `decline`, `disallow`, and `no` as denied results, `Cancel`/`abort` as cancelled results, and keeps allowed aliases canonical for scripted dialog-result status checks.

internal/tui/script_aliases.go

@@ -3923,6 +3923,8 @@ func (mouse *ScriptMouse) UnmarshalJSON(data []byte) error {
 		mouse.Button = *button
 	} else if button, ok := scriptMouseWheelButtonFromFields(fields); ok {
 		mouse.Button = button
+	} else if button, ok := scriptMouseDOMButtonFromFields(fields); ok {
+		mouse.Button = button
 	} else if button := intPtrJSONField(fields, "Button", "button", "Btn", "btn", "Code", "code", "Mask", "mask"); button != nil {
 		mouse.Button = *button
 	}
@@ -3968,6 +3970,30 @@ func scriptMouseWheelButtonFromFields(fields map[string]json.RawMessage) (int, b
 	}
 }
 
+func scriptMouseDOMButtonFromFields(fields map[string]json.RawMessage) (int, bool) {
+	if which := intPtrJSONField(fields, "Which", "which"); which != nil {
+		switch *which {
+		case 1:
+			return 0, true
+		case 2:
+			return 1, true
+		case 3:
+			return 2, true
+		}
+	}
+	if buttons := intPtrJSONField(fields, "Buttons", "buttons", "ButtonState", "button_state", "buttonState", "ButtonsMask", "buttons_mask", "buttonsMask"); buttons != nil {
+		switch {
+		case *buttons&1 != 0:
+			return 0, true
+		case *buttons&4 != 0:
+			return 1, true
+		case *buttons&2 != 0:
+			return 2, true
+		}
+	}
+	return 0, false
+}
+
 func scriptMouseWheelDirection(fields map[string]json.RawMessage) int {
 	direction := stringJSONField(fields, "Direction", "direction", "WheelDirection", "wheel_direction", "wheelDirection", "ScrollDirection", "scroll_direction", "scrollDirection")
 	switch scriptNormalizeName(direction) {

internal/tui/tui_test.go

@@ -5074,6 +5074,25 @@ func TestRunInteractionScriptAcceptsStructuredMouse(t *testing.T) {
 	}
 }
 
+func TestRunInteractionScriptAcceptsDOMMouseButtonAliases(t *testing.T) {
+	steps, err := ParseInteractionScript([]byte(`[
+		{"dialog":{"title":"Permission","body":"Allow?","actions":["Allow","Deny"],"id":"perm_dom","kind":"permission"}},
+		{"mouseEvent":{"buttons":2,"clientX":13,"clientY":5},"expectNoEvent":true,"expectDialog":{"active":true,"id":"perm_dom"}},
+		{"mouseEvent":{"which":1,"clientX":13,"clientY":5},"expectEvent":{"type":"dialog_action","value":"Deny","dialogId":"perm_dom","dialogKind":"permission"}}
+	]`))
+	if err != nil {
+		t.Fatal(err)
+	}
+	screen := NewREPLScreen(40, 8, nil)
+	result, err := RunInteractionScriptChecked(&screen, steps)
+	if err != nil {
+		t.Fatal(err)
+	}
+	if len(result.Events) != 1 || result.Events[0].Type != ScreenEventDialogAction || result.Events[0].DialogID != "perm_dom" || result.Events[0].Value != "Deny" {
+		t.Fatalf("events = %#v", result.Events)
+	}
+}
+
 func TestScriptMouseAcceptsCoordinateAliases(t *testing.T) {
 	for _, tc := range []struct {
 		name string
@@ -5143,6 +5162,31 @@ func TestScriptMouseDerivesWheelButtonFromEventPayload(t *testing.T) {
 	}
 }
 
+func TestScriptMouseAcceptsDOMButtonAliases(t *testing.T) {
+	for _, tc := range []struct {
+		name   string
+		raw    string
+		button int
+	}{
+		{name: "which left", raw: `{"which":1,"clientX":13,"clientY":5}`, button: 0},
+		{name: "which middle", raw: `{"which":2,"clientX":13,"clientY":5}`, button: 1},
+		{name: "which right", raw: `{"which":3,"clientX":13,"clientY":5}`, button: 2},
+		{name: "buttons left", raw: `{"buttons":1,"clientX":13,"clientY":5}`, button: 0},
+		{name: "buttons right", raw: `{"buttons":2,"clientX":13,"clientY":5}`, button: 2},
+		{name: "buttons middle", raw: `{"buttons":4,"clientX":13,"clientY":5}`, button: 1},
+	} {
+		t.Run(tc.name, func(t *testing.T) {
+			var mouse ScriptMouse
+			if err := json.Unmarshal([]byte(tc.raw), &mouse); err != nil {
+				t.Fatal(err)
+			}
+			if mouse.Button != tc.button || mouse.X != 13 || mouse.Y != 5 {
+				t.Fatalf("mouse = %#v, button want %d", mouse, tc.button)
+			}
+		})
+	}
+}
+
 func TestScriptBooleanAliasesAcceptNonStrictValues(t *testing.T) {
 	var mouse ScriptMouse
 	if err := json.Unmarshal([]byte(`{"button":0,"x":13,"y":5,"mouseUp":"yes"}`), &mouse); err != nil {