Formatador de TypeScript

TypeScript é um superconjunto de JavaScript, mas a sintaxe de nível de tipo que adiciona — interfaces, genéricos restritos com `extends`, decoradores, asserções de tipo `as`, e declarações independentes somente de tipo — não tem nenhum significado na gramática do JavaScript puro e faz com que um analisador apenas de JavaScript falhe diretamente em TypeScript perfeitamente válido. Usar o analisador dedicado do TypeScript em vez de tentar forçar o de JavaScript a aceitar um superconjunto de sua própria gramática é o que permite que um arquivo cheio de genéricos e interfaces seja formatado corretamente em vez de ser rejeitado como um erro de sintaxe no momento em que usa um recurso que o JavaScript em si não tem.

Um arquivo `.tsx` que combina sintaxe JSX com anotações de tipo do TypeScript é genuinamente ambíguo de analisar em um ponto específico: uma asserção de tipo entre colchetes angulares como `<Foo>value` parece idêntica ao início de uma tag de elemento JSX para um analisador que não foi informado qual dialeto está lendo. Selecionar o modo de análise TypeScript-com-JSX resolve essa ambiguidade corretamente, por isso escolher o dialeto correto de antemano — em vez de assumir que um analisador JavaScript genérico vai resolver isso — importa especificamente para arquivos de componente que misturam os dois.

Decoradores — as anotações estilo `@Component` comuns no Angular e em alguns frameworks de backend construídos sobre TypeScript — passaram por vários estágios distintos de proposta no processo de padronização da linguagem, e bases de código diferentes podem visar versões ligeiramente diferentes dessa sintaxe dependendo de quando foram escritas e quais opções de compilador usam. Analisar corretamente a sintaxe de decoradores exige especificamente o analisador ciente de TypeScript; um analisador de JavaScript puro que encontra um `@` antes de uma classe ou método não tem nenhum significado definido para recorrer e vai rejeitar o arquivo diretamente.