Написать или написать машинописный текст .d.ts?

Question

Typescript позволяет использовать "declaration": true" в tsconfig для генерации файлов d.ts на основе существующего кода Typescript.Они не так кратки, как если бы я написал это сам, но мне интересно, есть ли причина не полагаться на них, поскольку они кажутся несколько точными.

Редактировать: Мы создаем библиотеку в Typescript.

Answer 1

Как правило, вы должны разрешить TypeScript создавать файлы объявлений для вас при создании библиотеки.Написание *.d.ts файлов хорошо, когда у вас есть библиотека JavaScript, но вы хотите описать ее поведение с типами.

Существуют исключения - например, вы можете очистить сгенерированные файлы, удалив ненужныеКомментарии.Кто-то может поспорить, что это можно решить, пометив их как @internal.