Для чего нужны d.ts файлы?

TypeScript компилируется в JavaScript, но для работы с существующим JS-кодом ему нужно знать о типах этого кода. .d.ts файлы решают эту задачу.

Основные сценарии использования:

1. Описание типов для сторонних JavaScript-библиотек:
   Когда вы устанавливаете библиотеку через npm (например, lodash), TypeScript ищет соответствующий файл деклараций (например, @types/lodash), чтобы "понять", какие функции и классы предоставляет эта библиотека и какие у них типы.

2. Описание глобальных переменных:
   Если в вашем проекте есть глобальные переменные, добавленные через тег <script> или другими способами, вы можете описать их в .d.ts файле.

   typescript

   // globals.d.ts
   declare const MY_GLOBAL_CONFIG: {
     apiUrl: string;
   };
   
   declare function myGlobalFunction(msg: string): void;

   После этого вы можете использовать MY_GLOBAL_CONFIG и myGlobalFunction в любом месте вашего TypeScript-кода без ошибок.

3. Описание модулей:
   Вы можете описать модуль, для которого нет типов.

   typescript

   // declarations.d.ts
   declare module 'some-untyped-js-library' {
     export function doSomethingCool(input: string): number;
     const defaultExport: any;
     export default defaultExport;
   }

4. Разделение типов и реализации в собственном коде:
   Иногда полезно вынести сложные типы интерфейсов в отдельные .d.ts файлы для лучшей организации кода. В таких файлах можно объявлять типы, интерфейсы и т.д., но не значения (функции, классы, переменные).

   typescript

   // types/user.d.ts
   export interface User {
     id: number;
     name: string;
   }
   
   // user-service.ts
   import { User } from './types/user';
   export function getUser(): User { ... }

Вывод: .d.ts файлы — это фундаментальная часть экосистемы TypeScript, которая обеспечивает безопасность типов при интеграции с огромным миром JavaScript-библиотек и кода. Они позволяют писать типизированный код, даже опираясь на нетипизированные зависимости.