DefinitelyTyped против index.d.ts углового библиотеки

Question

Я создал простую библиотеку модульного тестирования хелперов для углового 1.x: https://github.com/dakolech/angular-unit-testing-helpers

А теперь я хочу, чтобы добавить типы определений. Мой вопрос: Должен ли я создать файл index.d.ts в моем репозитории или мне нужно создать новую папку w в DefinitelyTyped репозитории?

Если во-первых, то как импортировать угловые типы в эти файлы (например, ng.IScope)?

Answer 1

Предпочтительный подход, если возможно, состоит в том, чтобы включать типы в ваш пакет NPM и указать их местоположение в вашем пакете. Json.

Вам необходимо включить файл [something] .d.ts в свой проект, добавить свойство «typings» к вашему пакету.json, ссылаясь на него, и опубликовать его и ваш код для NPM.

См. https://www.typescriptlang.org/docs/handbook/typings-for-npm-packages.html за официальную документацию по этому вопросу.

Если ваш проект зависит от любых типов, которые не имеют типов, включенных в их пакеты NPM, это становится более сложным. См. https://github.com/typings/typings/blob/master/docs/faq.md#should-i-use-the-typings-field-in-packagejson для некоторых деталей. Вы хотите включить файл typings.json, в котором указывается, как получить ваши зависимости с помощью Typings, а затем попросите ваших пользователей запустить typings install npm:your-page, что даст им определения вашего типа и все зависимые определения из вашего typings.json.