Declaration Files

Файлы деклараций (.d.ts) – мост между нетипизированным JavaScript-миром и строгой системой типов TypeScript. Они описывают форму (shape) существующих JS-библиотек, не содержа реализации – только сигнатуры типов, интерфейсы и объявления. Благодаря .d.ts TypeScript может проверять типы при использовании jQuery, Lodash, Express и тысяч других библиотек, написанных на чистом JavaScript.

Что вы изучите

1. Что такое .d.ts и зачем они нужны – ambient-декларации, структуры библиотек (глобальные, модульные, UMD), как TypeScript находит типы.
2. Написание declaration files – шаблоны для разных типов библиотек, declare keyword, do’s and don’ts, экспорт типов.
3. DefinitelyTyped, @types и публикация – экосистема @types, как устроен DefinitelyTyped, публикация собственных деклараций, бандлинг типов.
4. Triple-Slash Directives и Module Augmentation – /// <reference>, расширение существующих модулей, глобальное дополнение, declare module.

Предварительные знания

• Модули и пространства имён – ES-модули, стратегии разрешения, пространства имён

Подглавы

1. Что такое .d.ts и зачем они нужны
2. Написание declaration files
3. DefinitelyTyped, @types и публикация
4. Triple-Slash Directives и Module Augmentation

Почему это важно

Большинство npm-пакетов написаны на JavaScript. Без declaration files TypeScript не знает ничего об их API – каждый импорт превращается в any. Файлы .d.ts позволяют сохранить полную типобезопасность при работе с любыми библиотеками. Умение писать и публиковать декларации – обязательный навык для разработчиков, создающих библиотеки или интегрирующих legacy-код.