Использование namespace-модулей

Принципы

• Пространства имён можно разбивать по файлам и импортировать как объекты (import { Keyof } from './keyof';).
• После компиляции до CommonJS/ESM namespace становится объектом, из которого можно читать экспортированные сущности.
• Объединяйте декларации, чтобы консолидировать типы и классы в одном пространстве имён.

Пример

import { Keyof } from './keyof';

console.log('USER', Keyof.User);

Практика

• Следите за путями: namespace не экспортируется по умолчанию, нужно использовать export namespace.
• При миграции на модули заменяйте обращения к namespace на явные импорты (import * as Validation from './validation';).
• Используйте единый файл-агрегатор, который реэкспортирует нужные пространства имён для удобства подключения.