From e5728ca78f763b44f97742d193069d0bf4320cc7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=B6rg=20Breitbart?= <jerch@rockborn.de>
Date: Sun, 14 Jul 2019 20:34:51 +0200
Subject: [PATCH 1/3] test script for mouse modes

---
 fixtures/mouse_modes/test_modes.js | 97 ++++++++++++++++++++++++++++++
 1 file changed, 97 insertions(+)
 create mode 100644 fixtures/mouse_modes/test_modes.js

diff --git a/fixtures/mouse_modes/test_modes.js b/fixtures/mouse_modes/test_modes.js
new file mode 100644
index 00000000..98fdfd38
--- /dev/null
+++ b/fixtures/mouse_modes/test_modes.js
@@ -0,0 +1,97 @@
+let activeEnc = 0;
+
+const stdin = process.openStdin();
+process.stdin.setRawMode(true);
+
+// close handler - reset terminal on exit
+stdin.addListener('data', function(data) {
+  if (data[0] === 0x04) {
+      process.stdin.setRawMode(false);
+      process.stdout.write('\x1bc');
+      process.exit();
+  }
+  if (data[0] === 0x01) {
+    switchActive();
+    printMenu();
+  }
+  console.log('\x1b[100;H\x1b[2A\x1b[2KReport:', data, [data.toString('binary')]);
+  // filter mouse reports
+  if (data[0] === 0x1b && data[1] === '['.charCodeAt(0)) {
+    applyReportData(data);
+  }
+});
+
+const BUTTONS = ['left', 'middle', 'right'];
+
+// encodings: ENCODING_NAME => [sequence, parse_report]
+const ENC = {
+  'X10'  : [
+    '\x1b[?9h',
+    // format: CSI M <button + 32> <row + 32> <col + 32>
+    report => ({button: report[3] - 32, row: report[4] - 32, col: report[5] - 32})
+  ],
+  'UTF8' : [
+    '\x1b[?9h\x1b[?1005h',
+    // format: CSI M <button + 32> <row + 32> <col + 32>
+    //         + utf8 encoding on row/col
+    report => {
+      const sReport = report.toString(); // decode with utf8
+      return {button: sReport.charCodeAt(3) - 32, row: sReport.charCodeAt(4) - 32, col: sReport.charCodeAt(5) - 32};
+    }
+  ],
+  'SGR'  : [
+    '\x1b[?9h\x1b[?1006h',
+    // format: CSI < Pbutton ; Prow ; Pcol M
+    report => {
+      // strip off introducer + M
+      const sReport = report.toString().slice(3, -1);
+      const [button, row, col] = sReport.split(';');
+      return {button, row, col};
+    }
+  ],
+  'URXVT': [
+    '\x1b[?9h\x1b[?1015h',
+    // format: CSI <button + 32> ; Prow ; Pcol M 
+    report => {
+      // strip off introducer + M
+      const sReport = report.toString().slice(2, -1);
+      const [button, row, col] = sReport.split(';');
+      return {button: button - 32, row, col};
+    }
+  ]
+}
+
+function printMenu() {
+  console.log('\x1b[2J\x1b\[HTest mouse reports [Ctrl-D to exit]');
+  console.log();
+  console.log('  Selected encoding [Ctrl-A to switch]');
+  const encs = Object.keys(ENC);
+  for (let i = 0; i < encs.length; ++i) {
+    console.log(`  ${activeEnc === i ? '->' : '  '}  ${encs[i]}`);
+  }
+  process.stdout.write('\x1b[100;H');
+}
+
+function switchActive() {
+  activeEnc++;
+  activeEnc %= Object.keys(ENC).length;
+  activate();
+}
+
+function activate() {
+  // clear all protocols
+  process.stdout.write('\x1b[?9l\x1b[?1005l\x1b[?1006l\x1b[?1015l');
+  // apply new protocol
+  process.stdout.write(ENC[Object.keys(ENC)[activeEnc]][0]);
+  console.log('\x1b[100;H\x1b[2A\x1b[2KReport:');
+}
+
+function applyReportData(data) {
+  let {button, row, col} = ENC[Object.keys(ENC)[activeEnc]][1](data);
+  console.log('\x1b[2KButton:', BUTTONS[button], 'row:', row, 'col:', col);
+  // apply to cursor position
+  process.stdout.write(`\x1b[${col};${row}H`);
+}
+
+printMenu();
+activate();

From 5b52094aa2b036ec27304d95f7b32a4ae27c46a0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=B6rg=20Breitbart?= <jerch@rockborn.de>
Date: Sun, 14 Jul 2019 23:58:07 +0200
Subject: [PATCH 2/3] respect protocol and modifiers

---
 fixtures/mouse_modes/test_modes.js | 112 +++++++++++++++++++++++------
 1 file changed, 91 insertions(+), 21 deletions(-)

diff --git a/fixtures/mouse_modes/test_modes.js b/fixtures/mouse_modes/test_modes.js
index 98fdfd38..05ad7c35 100644
--- a/fixtures/mouse_modes/test_modes.js
+++ b/fixtures/mouse_modes/test_modes.js
@@ -1,3 +1,4 @@
+let activeProtocol = 0;
 let activeEnc = 0;
 
 const stdin = process.openStdin();
@@ -5,13 +6,17 @@ process.stdin.setRawMode(true);
 
 // close handler - reset terminal on exit
 stdin.addListener('data', function(data) {
-  if (data[0] === 0x04) {
+  if (data[0] === 0x03) {
       process.stdin.setRawMode(false);
       process.stdout.write('\x1bc');
       process.exit();
   }
   if (data[0] === 0x01) {
-    switchActive();
+    switchActiveProtocol();
+    printMenu();
+  }
+  if (data[0] === 0x02) {
+    switchActiveEnc();
     printMenu();
   }
   console.log('\x1b[100;H\x1b[2A\x1b[2KReport:', data, [data.toString('binary')]);
@@ -21,50 +26,107 @@ stdin.addListener('data', function(data) {
   }
 });
 
-const BUTTONS = ['left', 'middle', 'right'];
+// basic button codes (modifier keys are added on top)
+const BUTTONS = {
+  0: ['left', 'press'],
+  1: ['middle', 'press'],
+  2: ['right', 'press'],
+  3: ['', 'release'],
+  32: ['left', 'move'],
+  33: ['middle', 'move'],
+  34: ['right', 'move'],
+  35: ['', 'move'],
+  64: ['wheel', 'up'],
+  65: ['wheel', 'down']
+};
+
+function evalButtonCode(code) {
+  // 2 bits: 0 - left, 1 - middle, 2 - right, 3 - release
+  // higher bits: 4 - shift, 8 - meta, 16 - control
+  const modifier = {shift: !!(code & 4), meta: !!(code & 8), control: !!(code & 16)};
+  const wheel = code & 64;
+  let action;
+  let button;
+  if (wheel) {
+    action = (code & 1) ? 'down' : 'up';
+    button = 'wheel';
+  } else {
+    action = code & 32 ? 'move' : code === 3 ? 'release' : 'press';
+    code &= 3; // TODO: more than 3 buttons + wheel
+    button = code === 0 ? 'left' : code === 1 ? 'middle' : code === 2 ? 'right' : '<none>';
+  }
+  return {button, action, modifier};
+}
+
+// protocols
+const PROTOCOLS = {
+  '9    (X10: press only)': '\x1b[?9h',
+  '1000 (VT200: press, release, wheel)': '\x1b[?1000h',
+  // '1001 (VT200 highlight)': '\x1b[?1001h',  // handle of backreport not implemented
+  '1002 (press, release, move on pressed, wheel)': '\x1b[?1002h',
+  '1003 (press, relase, move, wheel)': '\x1b[?1003h'
+}
 
 // encodings: ENCODING_NAME => [sequence, parse_report]
 const ENC = {
-  'X10'  : [
-    '\x1b[?9h',
+  'DEFAULT'  : [
+    '',
     // format: CSI M <button + 32> <row + 32> <col + 32>
-    report => ({button: report[3] - 32, row: report[4] - 32, col: report[5] - 32})
+    report => ({
+      state: evalButtonCode(report[3] - 32),
+      row: report[4] - 32,
+      col: report[5] - 32
+    })
   ],
   'UTF8' : [
-    '\x1b[?9h\x1b[?1005h',
+    '\x1b[?1005h',
     // format: CSI M <button + 32> <row + 32> <col + 32>
     //         + utf8 encoding on row/col
     report => {
       const sReport = report.toString(); // decode with utf8
-      return {button: sReport.charCodeAt(3) - 32, row: sReport.charCodeAt(4) - 32, col: sReport.charCodeAt(5) - 32};
+      return {
+        state: evalButtonCode(sReport.charCodeAt(3) - 32),
+        row: sReport.charCodeAt(4) - 32,
+        col: sReport.charCodeAt(5) - 32
+      };
     }
   ],
   'SGR'  : [
-    '\x1b[?9h\x1b[?1006h',
+    '\x1b[?1006h',
     // format: CSI < Pbutton ; Prow ; Pcol M
     report => {
       // strip off introducer + M
       const sReport = report.toString().slice(3, -1);
-      const [button, row, col] = sReport.split(';');
-      return {button, row, col};
+      const [buttonCode, row, col] = sReport.split(';');
+      const state = evalButtonCode(buttonCode);
+      if (report[report.length - 1] === 'm'.charCodeAt(0)) {
+        state.action = 'release';
+      }
+      return {state, row, col};
     }
   ],
   'URXVT': [
-    '\x1b[?9h\x1b[?1015h',
+    '\x1b[?1015h',
     // format: CSI <button + 32> ; Prow ; Pcol M 
     report => {
       // strip off introducer + M
       const sReport = report.toString().slice(2, -1);
       const [button, row, col] = sReport.split(';');
-      return {button: button - 32, row, col};
+      return {state: evalButtonCode(button - 32), row, col};
     }
   ]
 }
 
 function printMenu() {
-  console.log('\x1b[2J\x1b\[HTest mouse reports [Ctrl-D to exit]');
+  console.log('\x1b[2J\x1b\[HTest mouse reports [Ctrl-C to exit]');
   console.log();
-  console.log('  Selected encoding [Ctrl-A to switch]');
+  console.log('  Selected protocol [Ctrl-A to switch]');
+  const protocols = Object.keys(PROTOCOLS);
+  for (let i = 0; i < protocols.length; ++i) {
+    console.log(`  ${activeProtocol === i ? '->' : '  '}  ${protocols[i]}`);
+  }
+  console.log();
+  console.log('  Selected encoding [Ctrl-B to switch]');
   const encs = Object.keys(ENC);
   for (let i = 0; i < encs.length; ++i) {
     console.log(`  ${activeEnc === i ? '->' : '  '}  ${encs[i]}`);
@@ -72,23 +134,31 @@ function printMenu() {
   process.stdout.write('\x1b[100;H');
 }
 
-function switchActive() {
+function switchActiveProtocol() {
+  activeProtocol++;
+  activeProtocol %= Object.keys(PROTOCOLS).length;
+  activate();
+}
+
+function switchActiveEnc() {
   activeEnc++;
   activeEnc %= Object.keys(ENC).length;
   activate();
 }
 
 function activate() {
-  // clear all protocols
-  process.stdout.write('\x1b[?9l\x1b[?1005l\x1b[?1006l\x1b[?1015l');
-  // apply new protocol
+  // clear all protocols and encodings
+  process.stdout.write('\x1b[?9l\x1b[?1000l\x1b[?1001l\x1b[?1002l\x1b[?1003l');
+  process.stdout.write('\x1b[?1005l\x1b[?1006l\x1b[?1015l');
+  // apply new protocol and encoding
+  process.stdout.write(PROTOCOLS[Object.keys(PROTOCOLS)[activeProtocol]]);
   process.stdout.write(ENC[Object.keys(ENC)[activeEnc]][0]);
   console.log('\x1b[100;H\x1b[2A\x1b[2KReport:');
 }
 
 function applyReportData(data) {
-  let {button, row, col} = ENC[Object.keys(ENC)[activeEnc]][1](data);
-  console.log('\x1b[2KButton:', BUTTONS[button], 'row:', row, 'col:', col);
+  let {state, row, col} = ENC[Object.keys(ENC)[activeEnc]][1](data);
+  console.log('\x1b[2KButton:', state.button, 'Action:', state.action, 'Modifier:', state.modifier, 'row:', row, 'col:', col);
   // apply to cursor position
   process.stdout.write(`\x1b[${col};${row}H`);
 }

From 78c1569a6e876d0bc90af6daa9b77f48b010638a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=B6rg=20Breitbart?= <jerch@rockborn.de>
Date: Tue, 16 Jul 2019 22:05:06 +0200
Subject: [PATCH 3/3] cleanup

---
 .../test_modes.js => bin/test_mousemodes.js   | 22 +++++++++++++++++++
 1 file changed, 22 insertions(+)
 rename fixtures/mouse_modes/test_modes.js => bin/test_mousemodes.js (84%)

diff --git a/fixtures/mouse_modes/test_modes.js b/bin/test_mousemodes.js
similarity index 84%
rename from fixtures/mouse_modes/test_modes.js
rename to bin/test_mousemodes.js
index 05ad7c35..12ee8a0c 100644
--- a/fixtures/mouse_modes/test_modes.js
+++ b/bin/test_mousemodes.js
@@ -1,3 +1,25 @@
+/**
+ * Copyright (c) 2019 The xterm.js authors. All rights reserved.
+ * @license MIT
+ * 
+ * Script to test different mouse modes in terminal emulators.
+ * Tests for protocols DECSET 9, 1000, 1002, 1003 with different
+ * report encodings (default, UTF8, SGR, URXVT).
+ * 
+ * VT200 Highlight mode (DECSET 1001) is not implemented.
+ * 
+ * The test basically applies the report data to the cursor, thus
+ * a mouse report should move the cursor to the cell under the mouse.
+ * Furthermore the reports are printed in the left lower corner as
+ * raw data and their meaning.
+ * 
+ * A failing test might show:
+ *  - wrong coords: the cursor will jump to some other place
+ *  - wrong buttons: see meaning output and check whether it makes sense
+ *  - faulty reports: inspect the raw data and compare with other emulators
+ *  - missing events: compare with spec / other emulators
+ */
+
 let activeProtocol = 0;
 let activeEnc = 0;