globals.md

global.d.ts

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

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

Другой вариант использования файла global.d.ts - объявление компиляционных констант, которые вводятся в исходный код Webpack'ом через стандартный DefinePlugin плагин.

declare const BUILD_MODE_PRODUCTION: boolean; // можно использовать для компиляции с условием
declare const BUILD_VERSION: string;

Для любого кода, который будет генерировать JavaScript, мы настоятельно рекомендуем использовать файловые модули и использовать только global.d.ts для объявления компиляционных констант и/или для расширения стандартных объявлений типов, объявленных в lib.d.ts.

• Бонус: файл global.d.ts также хорош для быстрого declare module "some-library-you-dont-care-to-get-defs-for"; при выполнении миграции с JS на TS.