espterm-front-end/js/term/input.js

const { encode2B } = require('../utils')

/**
 * User input
 *
 * --- Rx messages: ---
 * S - screen content (binary encoding of the entire screen with simple compression)
 * T - text labels - Title and buttons, \0x01-separated
 * B - beep
 * . - heartbeat
 *
 * --- Tx messages ---
 * s - string
 * b - action button
 * p - mb press
 * r - mb release
 * m - mouse move
 */
module.exports = function (conn, screen) {
  // handle for input object
  let input

  const KEY_NAMES = {
    0x03: 'Cancel',
    0x06: 'Help',
    0x08: 'Backspace',
    0x09: 'Tab',
    0x0C: 'Clear',
    0x0D: 'Enter',
    0x10: 'Shift',
    0x11: 'Control',
    0x12: 'Alt',
    0x13: 'Pause',
    0x14: 'CapsLock',
    0x1B: 'Escape',
    0x20: ' ',
    0x21: 'PageUp',
    0x22: 'PageDown',
    0x23: 'End',
    0x24: 'Home',
    0x25: 'ArrowLeft',
    0x26: 'ArrowUp',
    0x27: 'ArrowRight',
    0x28: 'ArrowDown',
    0x29: 'Select',
    0x2A: 'Print',
    0x2B: 'Execute',
    0x2C: 'PrintScreen',
    0x2D: 'Insert',
    0x2E: 'Delete',
    0x3A: ':',
    0x3B: ';',
    0x3C: '<',
    0x3D: '=',
    0x3E: '>',
    0x3F: '?',
    0x40: '@',
    0x5B: 'Meta',
    0x5C: 'Meta',
    0x5D: 'ContextMenu',
    0x6A: 'Numpad*',
    0x6B: 'Numpad+',
    0x6D: 'Numpad-',
    0x6E: 'Numpad.',
    0x6F: 'Numpad/',
    0x90: 'NumLock',
    0x91: 'ScrollLock',
    0xA0: '^',
    0xA1: '!',
    0xA2: '"',
    0xA3: '#',
    0xA4: '$',
    0xA5: '%',
    0xA6: '&',
    0xA7: '_',
    0xA8: '(',
    0xA9: ')',
    0xAA: '*',
    0xAB: '+',
    0xAC: '|',
    0xAD: '-',
    0xAE: '{',
    0xAF: '}',
    0xB0: '~',
    0xBA: ';',
    0xBB: '=',
    0xBC: 'Numpad,',
    0xBD: '-',
    0xBE: 'Numpad,',
    0xC0: '`',
    0xC2: 'Numpad,',
    0xDB: '[',
    0xDC: '\\',
    0xDD: ']',
    0xDE: "'",
    0xE0: 'Meta'
  }
  // numbers 0-9
  for (let i = 0x30; i <= 0x39; i++) KEY_NAMES[i] = String.fromCharCode(i)
  // characters A-Z
  for (let i = 0x41; i <= 0x5A; i++) KEY_NAMES[i] = String.fromCharCode(i)
  // function F1-F20
  for (let i = 0x70; i <= 0x83; i++) KEY_NAMES[i] = `F${i - 0x70 + 1}`
  // numpad 0-9
  for (let i = 0x60; i <= 0x69; i++) KEY_NAMES[i] = `Numpad${i - 0x60}`

  let cfg = {
    np_alt: false,    // Application Numpad Mode
    cu_alt: false,    // Application Cursors Mode
    fn_alt: false,    // SS3 function keys mode
    mt_click: false,  // Mouse click tracking
    mt_move: false,   // Mouse move tracking
    no_keys: false,   // Suppress any key / clipboard event intercepting
    crlf_mode: false, // Enter sends CR LF
    all_fn: false     // Capture also F5, F11 and F12
  }

  /** Fn alt choice for key message */
  const fa = (alt, normal) => cfg.fn_alt ? alt : normal

  /** Cursor alt choice for key message */
  const ca = (alt, normal) => cfg.cu_alt ? alt : normal

  /** Numpad alt choice for key message */
  const na = (alt, normal) => cfg.np_alt ? alt : normal

  const keymap = {
    /* eslint-disable key-spacing */
    'Backspace':     '\x08',
    'Tab':           '\x09',
    'Enter':         () => cfg.crlf_mode ? '\x0d\x0a' : '\x0d',
    'Control+Enter': '\x0a',
    'Escape':        '\x1b',
    'ArrowUp':       () => ca('\x1bOA', '\x1b[A'),
    'ArrowDown':     () => ca('\x1bOB', '\x1b[B'),
    'ArrowRight':    () => ca('\x1bOC', '\x1b[C'),
    'ArrowLeft':     () => ca('\x1bOD', '\x1b[D'),
    'Home':          () => ca('\x1bOH', fa('\x1b[H', '\x1b[1~')),
    'Insert':        '\x1b[2~',
    'Delete':        '\x1b[3~',
    'End':           () => ca('\x1bOF', fa('\x1b[F', '\x1b[4~')),
    'PageUp':        '\x1b[5~',
    'PageDown':      '\x1b[6~',
    'F1':            () => fa('\x1bOP', '\x1b[11~'),
    'F2':            () => fa('\x1bOQ', '\x1b[12~'),
    'F3':            () => fa('\x1bOR', '\x1b[13~'),
    'F4':            () => fa('\x1bOS', '\x1b[14~'),
    'F5':            '\x1b[15~', // note the disconnect
    'F6':            '\x1b[17~',
    'F7':            '\x1b[18~',
    'F8':            '\x1b[19~',
    'F9':            '\x1b[20~',
    'F10':           '\x1b[21~', // note the disconnect
    'F11':           '\x1b[23~',
    'F12':           '\x1b[24~',
    'Shift+F1':      () => fa('\x1bO1;2P', '\x1b[25~'),
    'Shift+F2':      () => fa('\x1bO1;2Q', '\x1b[26~'), // note the disconnect
    'Shift+F3':      () => fa('\x1bO1;2R', '\x1b[28~'),
    'Shift+F4':      () => fa('\x1bO1;2S', '\x1b[29~'), // note the disconnect
    'Shift+F5':      () => fa('\x1b[15;2~', '\x1b[31~'),
    'Shift+F6':      () => fa('\x1b[17;2~', '\x1b[32~'),
    'Shift+F7':      () => fa('\x1b[18;2~', '\x1b[33~'),
    'Shift+F8':      () => fa('\x1b[19;2~', '\x1b[34~'),
    'Shift+F9':      () => fa('\x1b[20;2~', '\x1b[35~'), // 35-38 are not standard - but what is?
    'Shift+F10':     () => fa('\x1b[21;2~', '\x1b[36~'),
    'Shift+F11':     () => fa('\x1b[22;2~', '\x1b[37~'),
    'Shift+F12':     () => fa('\x1b[23;2~', '\x1b[38~'),
    'Numpad0':       () => na('\x1bOp', '0'),
    'Numpad1':       () => na('\x1bOq', '1'),
    'Numpad2':       () => na('\x1bOr', '2'),
    'Numpad3':       () => na('\x1bOs', '3'),
    'Numpad4':       () => na('\x1bOt', '4'),
    'Numpad5':       () => na('\x1bOu', '5'),
    'Numpad6':       () => na('\x1bOv', '6'),
    'Numpad7':       () => na('\x1bOw', '7'),
    'Numpad8':       () => na('\x1bOx', '8'),
    'Numpad9':       () => na('\x1bOy', '9'),
    'Numpad*':       () => na('\x1bOR', '*'),
    'Numpad+':       () => na('\x1bOl', '+'),
    'Numpad-':       () => na('\x1bOS', '-'),
    'Numpad.':       () => na('\x1bOn', '.'),
    'Numpad/':       () => na('\x1bOQ', '/'),
    // we don't implement numlock key (should change in numpad_alt mode,
    // but it's even more useless than the rest and also has the side
    // effect of changing the user's numlock state)

    // shortcuts
    'Control+]':  '\x1b', // alternate way to enter ESC
    'Control+\\': '\x1c',
    'Control+[':  '\x1d',
    'Control+^':  '\x1e',
    'Control+_':  '\x1f',

    // extra controls
    'Control+ArrowLeft':  '\x1f[1;5D',
    'Control+ArrowRight': '\x1f[1;5C',
    'Control+ArrowUp':    '\x1f[1;5A',
    'Control+ArrowDown':  '\x1f[1;5B',
    'Control+Home':       '\x1f[1;5H',
    'Control+End':        '\x1f[1;5F',

    // extra shift controls
    'Shift+ArrowLeft':    '\x1f[1;2D',
    'Shift+ArrowRight':   '\x1f[1;2C',
    'Shift+ArrowUp':      '\x1f[1;2A',
    'Shift+ArrowDown':    '\x1f[1;2B',
    'Shift+Home':         '\x1f[1;2H',
    'Shift+End':          '\x1f[1;2F',

    // macOS text editing commands
    'Alt+ArrowLeft':      '\x1bb',  // ⌥← to go back a word (^[b)
    'Alt+ArrowRight':     '\x1bf',  // ⌥→ to go forward one word (^[f)
    'Meta+ArrowLeft':     '\x01',   // ⌘← to go to the beginning of a line (^A)
    'Meta+ArrowRight':    '\x05',   // ⌘→ to go to the end of a line (^E)
    'Alt+Backspace':      '\x17',   // ⌥⌫ to delete a word (^W)
    'Meta+Backspace':     '\x15',   // ⌘⌫ to delete to the beginning of a line (^U)

    // copy to clipboard
    'Control+Shift+C' () {
      screen.copySelectionToClipboard()
    },
    'Control+Insert' () {
      screen.copySelectionToClipboard()
    },

    // toggle debug mode
    'Control+F12' () {
      screen.window.debug ^= 1
    }
    /* eslint-enable key-spacing */
  }

  // ctrl+[A-Z] sent as simple low ASCII codes
  for (let i = 1; i <= 26; i++) {
    keymap[`Control+${String.fromCharCode(0x40 + i)}`] = String.fromCharCode(i)
  }

  /** Send a literal message */
  function sendString (str) {
    return conn.send('s' + str)
  }

  /** Send a button event */
  function sendButton (index) {
    conn.send('b' + String.fromCharCode(index + 1))
  }

  const shouldAcceptEvent = function () {
    if (cfg.no_keys) return false
    if (document.activeElement instanceof window.HTMLTextAreaElement) return false
    return true
  }

  const keyBlacklist = [
    'F5', 'F11', 'F12', 'Shift+F5'
  ]

  let softModifiers = {
    alt: false,
    ctrl: false,
    meta: false,
    shift: false
  }

  const handleKeyDown = function (e) {
    if (!shouldAcceptEvent()) return

    let modifiers = []
    // sorted alphabetically
    if (e.altKey || softModifiers.alt) modifiers.push('Alt')
    if (e.ctrlKey || softModifiers.ctrl) modifiers.push('Control')
    if (e.metaKey || softModifiers.meta) modifiers.push('Meta')
    if (e.shiftKey || softModifiers.shift) modifiers.push('Shift')

    let key = KEY_NAMES[e.which] || e.key

    // ignore clipboard events
    if ((e.ctrlKey || e.metaKey) && key === 'V') return

    let binding = null

    for (let name in keymap) {
      let itemModifiers = name.split('+')
      let itemKey = itemModifiers.pop()

      if (itemKey === key && itemModifiers.sort().join() === modifiers.join()) {
        if (keyBlacklist.includes(name) && !cfg.all_fn) continue
        binding = keymap[name]
        break
      }
    }

    if (binding) {
      if (binding instanceof Function) binding = binding()
      e.preventDefault()
      if (typeof binding === 'string') {
        sendString(binding)
      }
    }
  }

  /** Bind/rebind key messages */
  function initKeys ({ allFn }) {
    // This takes care of text characters typed
    window.addEventListener('keypress', function (evt) {
      if (!shouldAcceptEvent()) return
      if (evt.ctrlKey || evt.metaKey) return

      let str = ''
      if (evt.key && evt.key.length === 1) str = evt.key
      else if (evt.which && evt.which !== 229) str = String.fromCodePoint(evt.which)

      if (str.length > 0 && str.charCodeAt(0) >= 32) {
        // prevent space from scrolling
        if (evt.which === 32) evt.preventDefault()
        sendString(str)
      }
    })

    window.addEventListener('keydown', handleKeyDown)
    window.addEventListener('copy', e => {
      if (!shouldAcceptEvent()) return
      let selectedText = screen.getSelectedText()
      if (selectedText) {
        e.preventDefault()
        e.clipboardData.setData('text/plain', selectedText)
      }
    })
    window.addEventListener('paste', e => {
      if (!shouldAcceptEvent()) return
      e.preventDefault()
      let string = e.clipboardData.getData('text/plain')
      if (string.includes('\n') || string.length > 90) {
        if (!input.termUpload) console.error('input.termUpload is undefined')
        input.termUpload.setContent(string)
        input.termUpload.open()
      } else {
        // simple string, just paste it
        if (screen.bracketedPaste) string = `\x1b[200~${string}\x1b[201~`
        sendString(string)
      }
    })

    cfg.all_fn = allFn
  }

  // mouse button states
  let mb1 = 0
  let mb2 = 0
  let mb3 = 0

  /** Init the Input module */
  function init (opts) {
    initKeys(opts)

    // global mouse state tracking - for motion reporting
    window.addEventListener('mousedown', evt => {
      if (evt.button === 0) mb1 = 1
      if (evt.button === 1) mb2 = 1
      if (evt.button === 2) mb3 = 1
    })

    window.addEventListener('mouseup', evt => {
      if (evt.button === 0) mb1 = 0
      if (evt.button === 1) mb2 = 0
      if (evt.button === 2) mb3 = 0
    })
  }

  // record modifier keys
  // bits: Meta, Alt, Shift, Ctrl
  let modifiers = 0b0000

  window.addEventListener('keydown', e => {
    if (e.ctrlKey) modifiers |= 1
    if (e.shiftKey) modifiers |= 2
    if (e.altKey) modifiers |= 4
    if (e.metaKey) modifiers |= 8
  })
  window.addEventListener('keyup', e => {
    modifiers = 0
    if (e.ctrlKey) modifiers |= 1
    if (e.shiftKey) modifiers |= 2
    if (e.altKey) modifiers |= 4
    if (e.metaKey) modifiers |= 8
  })

  /** Prepare modifiers byte for mouse message */
  function packModifiersForMouse () {
    return modifiers
  }

  input = {
    /** Init the Input module */
    init,

    /** Send a literal string message */
    sendString,
    sendButton,

    /** Enable alternate key modes (cursors, numpad, fn) */
    setAlts: function (cu, np, fn, crlf) {
      if (cfg.cu_alt !== cu || cfg.np_alt !== np || cfg.fn_alt !== fn || cfg.crlf_mode !== crlf) {
        cfg.cu_alt = cu
        cfg.np_alt = np
        cfg.fn_alt = fn
        cfg.crlf_mode = crlf
      }
    },

    setMouseMode (click, move) {
      cfg.mt_click = click
      cfg.mt_move = move
    },

    // Mouse events
    onMouseMove (x, y) {
      if (!cfg.mt_move) return
      const b = mb1 ? 1 : mb2 ? 2 : mb3 ? 3 : 0
      const m = packModifiersForMouse()
      conn.send('m' + encode2B(y) + encode2B(x) + encode2B(b) + encode2B(m))
    },

    onMouseDown (x, y, b) {
      if (!cfg.mt_click) return
      if (b > 3 || b < 1) return
      const m = packModifiersForMouse()
      conn.send('p' + encode2B(y) + encode2B(x) + encode2B(b) + encode2B(m))
    },

    onMouseUp (x, y, b) {
      if (!cfg.mt_click) return
      if (b > 3 || b < 1) return
      const m = packModifiersForMouse()
      conn.send('r' + encode2B(y) + encode2B(x) + encode2B(b) + encode2B(m))
      // console.log("B ",b," M ",m);
    },

    onMouseWheel (x, y, dir) {
      if (!cfg.mt_click) return
      // -1 ... btn 4 (away from user)
      // +1 ... btn 5 (towards user)
      const m = packModifiersForMouse()
      const b = (dir < 0 ? 4 : 5)
      conn.send('p' + encode2B(y) + encode2B(x) + encode2B(b) + encode2B(m))
      // console.log("B ",b," M ",m);
    },

    /**
     * Prevent capturing keys. This is used for text input
     * modals on the terminal screen
     */
    blockKeys (yes) {
      cfg.no_keys = yes
    },

    handleKeyDown,
    softModifiers
  }
  return input
}