Типы — не документация

По скрытой от меня причине vscode стал считать, что декларации типов это самый лучший способ рассказать о чём-то. Каждый раз, когда я хочу подсмотреть аргументы, он выдаёт мне кучу магических закорючек:

В этом примере и рассказывать-то даже особо нечего. Могу даже словами сказать: «метод принимает значение, функцию замены (которая знает ключ и значение каждого объекта) и ширину отступа». Всё. Получилось даже на 3 символа короче.

Но это ещё не так плохо. Клинический случай — библиотека Telegraf.js. Вот её подсказка к методу, отправляющему сообщение в Телеграме:

Спасибо, очень полезно. Сайт с документацией у них, кстати, такой же.