Распространение файлов определений TypeScript

Question

Я использовал TypeScript с самого начала и прошел через итерации инструментов и репозиториев для получения файлов определений TypeScript (т. Е. Somelib.d.ts) для сторонних библиотек - безусловно, typetyped, tsd, typings, nuget, и теперь npm @types репозиторий и разработчики, включая типы в их пакетах.

Сегодня у меня вопрос: каков идеальный способ распространения файла определения?

Я понял, что если разработчик не желает предоставлять файлы машинописного текста, другой разработчик может представить их в проект с определенными типами, чтобы они были доступны.

Если разработчик готов принять Pull-запрос, лучше ли распространять его вместе с пакетом?

Если файл определения включен в пакет, существует ли стандарт для их включения (папка / имя)?

Answer 1

Идеальный способ - отправлять наборы вместе с реальным кодом. Это делает эту историю очень легкой для потребителей пакетов, чтобы начать работу с Typescript без каких-либо дополнительных шагов.

Связывание типов с пакетом основного кода, а не через DefinitiveTyped, также является рекомендуемым документами TypeScript.

С точки зрения "стандарта для их включения" все, что вам действительно нужно сделать, это убедиться, что поле types или typings в package.json заполнено путем к вашим наборам.