JSDoc це як фієрична милиця так і геніальна ідея.
Перше що треба для себе з'ясувати - JSDoc це річ яка нічим не відрізняється від коментаря. Вона не має будь якого самостійного значення. І набуває його лише тоді, коли є якась зовнішня утилита яка, завдяки сигнатурі JSDoc впізнає - що можливо у цьому коментарі може бути щось що відповідає синтаксису JSDoc.
Сигнатура JSDoc це дурга зірочка яка йде відразу за першою
/**
Ця ідея виникла що як найменш у 1999 році, коли встала потреба документувати великі обсяги JS коду, та хтось винайшов, що якщо ми будемо це робити притримуючись якогось формату, то можна написати та використовувати надалі утилиту, яка буде парсити JS файл та з нього брати все необхідне для того, щоб створити хоча б основу для документації.Тобто сутність ідеї в тому, щоб використовуючи коментарі, додаючи до них унікальну мітку створювати мову в мові.
У подальшому синтаксис більш менш стандартизувувався. Його стали використовувати вже такі потужні речі як Google Closure Compiler та таке інше.
TS, використовує JSDoc як можливість допомогти тим людям, які анотують свій код завдяки JSDocs нотації використовувати tsc та його можливості.
Тобто чи потрібен взагалі JSDoc щодо TS? Ні не потрібен.
Чи впливає JSDoc на виконання JS коду? Ні. Тобто впливає так само як і будь який коментар, використовуючи пам'ять.
Історична довідка:
TS з'явився в тому числі завдякі JSDoc. Перша демо-версія TS була написана на Google Closure Compiler з використанням JSDoc для анотації типів.
Bonus Tip:
MultiLine comments у згоді з офиційною спецификацією, інтрепретується як
space character або line terminator якщо він є у тіі коментаря;Тобто завдяки йому можливо писати наприклад так:
var/**/someVar=1;
що буде інтерпретовано як:var someVar=1;