Привет. Стало интересно, как правильно импортировать объект или класс, чтобы использовать его для документации в JSDoc. Поясню:
Например, у меня есть вот такой кусок кода:
/** @type {UsersModel} */
usersEntityModel;
Чтобы IDE или редактор адекватно воспринимали, что такое "UsersModel", его нужно заимпортировать. Можно это сделать
двумя способами:
/** @typedef {import('./entities/users.model').UsersModel} UsersModel */
Или
import { UsersModel } from './entities/users.model';
Собственно, какой из двух способов следует использовать? Сейчас я использую первый, т.к. это всё же комментарии, а не настоящие импорты. Второй, вроде как приятнее, но есть сомнения по поводу "правильности" импортирования сущности, которая явно в исходнике не используется.