Пространства имён (namespace)

Принципы

• namespace группирует связанные типы и классы под единым префиксом (Validation.StringValidator).
• Экспорт внутри пространства (export interface) делает сущности доступными снаружи.
• Ссылки /// <reference path="..." /> позволяют связывать несколько файлов namespace-объявлений в старом стиле.

Пример

namespace Validation {
  export interface StringValidator {
    isAcceptable(s: string): boolean;
  }

  const lettersRegexp = /^[A-Za-z]+$/;

  export class LettersOnlyValidator implements StringValidator {
    isAcceptable(s: string) {
      return lettersRegexp.test(s);
    }
  }
}

let validators: { [s: string]: Validation.StringValidator } = {};
validators['Letters only'] = new Validation.LettersOnlyValidator();

Практика

• Используйте namespace только в проектах без модульной системы; предпочитайте ES-модули для современных приложений.
• Разносите валидаторы и реализации по отдельным файлам с одинаковым пространством, чтобы активировать declaration merging.
• При миграции на модули заменяйте namespace на объекты/модули — сигнатура классов и интерфейсов останется прежней.