Возможно это можно настроить в jsdoc, или сторонними библиотеками генерации документации (из jsdoc) решить.
Собственно две проблемы.
1. jsDoc в VS Code поддерживает подсветку синтаксиса когда
описываю параметр через деструктуризацию, а генератор документации jsDoc - нет, отображает как Object, приходится писать 10 строк чтоб описать структуру incomeObject.params, incomeObject.params.field, итд... (кроме того он не поддерживает [], а только Array<>)
* @param { {params:{ field:Array<{name:string, type:CustomType.name}>, entity:Entity }} } incomeObject описание
2.
Не поддерживает описание параметра как свойства объектов кастомных типов.
CustomType работает, и отображает и ссылку ставит, CustomType.name - не работает не подсвечивается и ссылку не ставит (и не встраивает описание свойства например)