Форматировщик TypeScript

TypeScript — надмножество JavaScript, но синтаксис уровня типов, который он добавляет, — интерфейсы, дженерики с ограничениями через `extends`, декораторы, приведения типов через `as` и самостоятельные объявления только типов — не имеет никакого смысла в грамматике обычного JavaScript и заставляет парсер, понимающий только JavaScript, сразу же падать на совершенно валидном TypeScript. Использование выделенного парсера TypeScript вместо попытки заставить парсер JavaScript принимать надмножество собственной грамматики — вот что позволяет файлу, полному дженериков и интерфейсов, форматироваться корректно, а не отклоняться как синтаксическая ошибка в момент, когда в нём используется возможность, которой в самом JavaScript просто нет.

Файл `.tsx`, сочетающий синтаксис JSX с аннотациями типов TypeScript, по-настоящему неоднозначен для разбора в одном конкретном месте: приведение типа через угловые скобки вроде `<Foo>value` выглядит точно так же, как начало тега JSX-элемента, для парсера, которому не сообщили, какой диалект он читает. Выбор режима разбора TypeScript с поддержкой JSX корректно устраняет эту неоднозначность, поэтому выбор правильного диалекта заранее — вместо расчёта на то, что обычный парсер JavaScript сам во всём разберётся, — особенно важен именно для файлов компонентов, сочетающих оба синтаксиса.

Декораторы — аннотации в стиле `@Component`, распространённые в Angular и некоторых бэкенд-фреймворках на TypeScript, — прошли через несколько разных стадий предложений в процессе стандартизации языка, и разные кодовые базы могут ориентироваться на немного разные версии этого синтаксиса в зависимости от того, когда они были написаны и какие опции компилятора используют. Корректный разбор синтаксиса декораторов требует именно парсера, понимающего TypeScript; обычный парсер JavaScript, встретив `@` перед классом или методом, не имеет для этого определённого значения и отклонит файл целиком.