Где нужно расположить .d.ts-файл, чтобы глобальные объявления корректно подхватывались TypeScript?

Как TypeScript находит глобальные объявления

TypeScript автоматически включает в компиляцию все файлы .ts и .d.ts, которые находятся в директориях, указанных в tsconfig.json в поле include (или files, если оно задано). Если файл .d.ts лежит вне этих путей, он не будет обработан, и глобальные типы не будут доступны.

Практические рекомендации

Чаще всего .d.ts-файл с глобальными объявлениями размещают в корне проекта или в папке types (например, src/types). Главное — чтобы путь к нему попадал в include. Например, если в tsconfig.json указано "include": ["src"], то файл должен лежать внутри src.

// tsconfig.json
{
  "compilerOptions": {
    "typeRoots": ["./node_modules/@types", "./types"]
  },
  "include": ["src", "types"]
}

В этом примере папка types добавлена в include, поэтому любой .d.ts внутри неё будет подхвачен.

Пример глобального объявления

// types/global.d.ts
declare interface Window {
  myGlobalVar: string;
}

После этого в любом файле проекта можно использовать window.myGlobalVar без ошибок типов.

Вывод

Чтобы глобальные объявления работали, убедитесь, что .d.ts-файл находится в директории, включённой в компиляцию через include или files в tsconfig.json. Это стандартный подход для расширения глобальных типов, например, для добавления свойств к Window или глобальных функций.