Function moveCursorTo

src/ink/log-update.ts:1702–1753

(screen: VirtualScreen, targetX: number, targetY: number)

}

function moveCursorTo(screen: VirtualScreen, targetX: number, targetY: number) {
  const dx = targetX - screen.cursor.x
  const dy = targetY - screen.cursor.y
  const inPendingWrap = screen.cursor.x >= screen.viewportWidth

  if (dx === 0 && dy === 0) {
    recordMoveCursorStats('noop')
    return
  }

  if (inPendingWrap) {
    recordMoveCursorStats('pending-wrap')
    screen.txn(() => [
      [CARRIAGE_RETURN, { type: 'cursorMove', x: targetX, y: dy }],
      { dx, dy },
    ])
    return
  }

  if (dy !== 0) {
    if (dy === 1) {
      recordMoveCursorStats(
        targetX === 0
          ? 'line-change-next-row-home'
          : 'line-change-next-row-offset',
      )
      if (targetX === 0) {
        screen.txn(prev => [[CARRIAGE_RETURN, NEWLINE], { dx: -prev.x, dy: 1 }])
        return
      }
      screen.txn(prev => [
        [CARRIAGE_RETURN, NEWLINE, { type: 'cursorMove', x: targetX, y: 0 }],
        { dx: targetX - prev.x, dy: 1 },
      ])
      return
    } else {
      recordMoveCursorStats(
        targetX === 0
          ? 'line-change-multi-row-home'
          : 'line-change-multi-row-offset',
      )
    }
    screen.txn(() => [
      [CARRIAGE_RETURN, { type: 'cursorMove', x: targetX, y: dy }],
      { dx, dy },
    ])
    return
  }

  recordMoveCursorStats('same-line')
  screen.txn(() => [[{ type: 'cursorMove', x: dx, y: dy }], { dx, dy }])
}

/**
 * Identify emoji where the terminal's wcwidth may disagree with Unicode.