Я ищу способ ссылки на символ в комментариях к документу:
/** A wrapper of @see {Foo}. */
class Bar {
constructor(public readonly foo: Foo) {}
}
class Foo {}
Однако, когда я переименовываю Foo, он не переименовывает ссылку see.Такое поведение заставляет меня избегать ссылок на другие символы в комментариях к документам ...
Я знаю, что есть несколько аннотаций js-doc, и некоторые из них фактически поддерживают семантические ссылки (например, @type, @typedef, @extends), но они имеют особое семантическое значение, и они распознаются, только когда они начинают строку:
/**
* @type {Foo} The type. // does work
* See @type {Foo}. // does not work
*/
Разве это просто невозможно?