В крупных монорепозиториях генерация файлов деклараций (.d.ts) часто становится узким местом: стандартный компилятор tsc строит полный граф типов проекта, чтобы вывести типы нетипизированных экспортов.
Опция isolatedDeclarations (TypeScript 5.5+) устраняет эту проблему:
- Пофайловая изоляция: файлы компилируются независимо без анализа всего проекта.
- Параллельная генерация: изоляция позволяет нативным сборщикам на Rust/Go (oxc, swc, esbuild) генерировать
.d.tsв разы быстрее однопоточногоtsc. - Экономия ресурсов: сокращает время инкрементальных сборок на 30–70% и снижает потребление памяти в CI на 20–50%.
Компромисс — обязательная явная типизация экспортируемых сущностей:
// Ошибка при isolatedDeclarations:
export function getUser() { return { id: 1, name: 'Alex' }; }
// Корректный явный контракт:
type User = { id: number; name: string };
export function getUser(): User { return { id: 1, name: 'Alex' }; }
Флаг "isolatedDeclarations": true в tsconfig.json внедряют поэтапно, сочетая с Project References и инкрементальной сборкой.
![Node.JS [ru]](/api/digests/it_development/daily/20260818/assets/sources/we-use-js.jpg)