TypeScript: флаг isolatedDeclarations для параллельной генерации типов в монорепозиторияхКратко · дайджест за 18 августа
Кратко≈ 1 мин

TypeScript: флаг isolatedDeclarations для параллельной генерации типов в монорепозиториях

В крупных монорепозиториях генерация файлов деклараций (.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 и инкрементальной сборкой.

Хочу подробный разборГолоса помогают выбрать, что разобрать подробно. За этот материал 0 голосов.
Источники · 2