Fale conosco
Desenvolvimento

TypeScript 7.1 devolve a API do compilador: content mappers, lint tipado no tsgo e o que ainda quebra

33 min de leitura
TypeScript 7.1 devolve a API do compilador: content mappers, lint tipado no tsgo e o que ainda quebra

TypeScript 7.1 devolve a API do compilador — e destrava Vue, Svelte e o lint tipado

O TypeScript 7 entregou o que a Microsoft vinha prometendo havia mais de um ano: o compilador reescrito em Go, com ganhos de ordem de grandeza no tempo de type-check. A conta chegou depois. A portagem nativa não expunha a API programática do compilador — aquela que permite a uma ferramenta varrer o programa, montar o grafo de símbolos e devolver diagnósticos. Quem dependia dela ficou para trás: vue-tsc e o Volar, o language server do Svelte, Astro, ts-morph, ts-node e o typescript-eslint .

O resultado foi um ecossistema rachado em dois mundos. O tsc 7 rápido rodava no CI, enquanto as ferramentas continuavam presas na linha 6.x. Quem tentava subir a versão via npm install batia em ERESOLVE por causa do peer dependency; quem forçava com --legacy-peer-deps via o ESLint morrer no boot com uma mensagem direta: typescript-eslint does not support TS 7.0 .

A beta do TypeScript 7.1, anunciada por Daniel Rosenwasser em 20 de outubro, ataca exatamente esse buraco. Não há sintaxe nova relevante para o dia a dia: há a reintrodução da API, em formato modular, e um mecanismo de content mappers que coloca arquivos .vue e .svelte dentro do compilador nativo. E, nas últimas duas semanas, o efeito em cadeia começou a aparecer nas ferramentas.

O que 7.0 levou e 7.1 devolve

A API antiga era um objeto monolítico ( ts.createProgram , ts.Program , ts.TypeChecker ) com a qual qualquer ferramenta conseguia inspecionar o código. A portagem para Go derrubou isso — junto com a API de transformação ( ts.Transformer ), que era como o Angular compilava templates.

Na 7.1, a API volta fragmentada em pontos de entrada com escopo definido:

typescript/sync — o caminho síncrono, para quem precisa montar um programa e consultar o checker;

typescript/async — a variante assíncrona, pensada para servidores de linguagem e editores;

typescript/fs — o acesso a sistema de arquivos, isolado;

typescript/ast — a árvore sintática, sem carregar o checker.

A separação é a parte interessante. Uma ferramenta que só precisa ler a AST não paga o custo de carregar o type checker, e um plugin de editor não precisa puxar APIs de I/O que não vai usar. A beta também traz reusable snapshots , um modelo incremental em que o programa é reaproveitado entre edições em vez de reconstruído — o que importa quando o alvo é o tempo de resposta dentro da IDE.

Os content mappers resolvem o outro problema estrutural. Historicamente, vue-tsc funcionava como um wrapper: extraía o bloco <script> do componente, montava um arquivo virtual, rodava o tsc e remapeava as posições de erro de volta. Com o compilador nativo, esse arranjo deixou de funcionar. Agora o TypeScript expõe um ponto de extensão: um plugin registra um mapper que apresenta o .vue como entrada virtual e devolve os diagnósticos nas coordenadas do arquivo original. Benchmarks iniciais citados na divulgação da beta apontam type-check de projetos Vue até 4,6 vezes mais rápido que o caminho antigo, ainda em cima do compilador 6.x.

O efeito em cadeia nas ferramentas

Três movimentos recentes mostram que a fila andou:

typescript-eslint 8.73 (16 de novembro) liberou um backend experimental e opt-in para rodar lint tipado sobre o parser nativo do 7.1. É a primeira vez que regras que dependem de tipos — no-floating-promises , no-misused-promises , strict-boolean-expressions — conseguem rodar em cima do tsgo.

Angular ngp entrou em beta (11 de novembro). A equipe do Angular fez a lição de casa mais profunda: em vez de esperar pela API de transformação, reescreveu a fase de análise do compilador em Rust, sobre o Oxc, e desacoplou a compilação de templates do pipeline do tsc . Os primeiros números falam em builds mais rápidos e menos memória no servidor de desenvolvimento.

tsrs , o port em Rust do compilador feito pela Cloudflare, entrou na conversa com a manchete de "8x mais rápido". A leitura correta do benchmark é mais modesta: o 8x foi medido contra o TypeScript 7.0; comparado ao 7.1, o ganho fica perto de 3x. Vale a pena registrar o padrão: números de anúncio quase sempre comparam contra a geração anterior, não contra a concorrente.

É nesse ponto que o tema deixa de ser curiosidade de mantenedor de ferramenta e vira decisão de projeto. Em times que mantêm uma base TypeScript grande, com Angular ou Vue no front e Node no back, a escolha de compilador deixa de ser um detalhe de devDependencies e passa a influenciar quanto tempo o CI gasta e quanto tempo o desenvolvedor espera por feedback. Na Maquinaweb, projetos com stack TypeScript/Angular e back-end em .NET ou Python costumam ter o type-check como gargalo do pipeline justamente porque a cadeia de ferramentas precisa estar toda alinhada — não adianta acelerar o tsc se o lint e o ts-node continuam no compilador antigo.

Na prática: montando o toolchain hoje

Enquanto a 7.1 está em beta, o caminho que tem funcionado em projetos reais é o toolchain dividido: compilador nativo para o type-check de verdade, TypeScript 6.x para as ferramentas que ainda dependem da API antiga. No package.json , o alias do npm resolve a convivência:

Duas trocas costumam ser inevitáveis nesse caminho. A primeira é substituir ts-node por tsx na execução local: o ts-node senta em cima da API do compilador e não tem previsão de suporte ao backend nativo. A segunda é revisar o tsconfig.json — o compilador 7 removeu opções que hoje ninguém questiona, e o primeiro tsc depois do upgrade simplesmente recusa checar o projeto inteiro. Não é bug: é o custo de limpar o arquivo de configuração.

Para o lint tipado experimental, a configuração é opt-in e deve ficar isolada, num job separado do CI:

A beta também traz itens menores que valem uma olhada: --target es2026 , suporte a source phase imports e a opção --runExternalCode , que transforma a execução de código de plugins numa fronteira explícita de segurança em vez de comportamento implícito.

Riscos e armadilhas

"A API voltou" não significa "a API é a mesma". Ferramentas que usavam ts.Transformer para reescrever código no pipeline do compilador não têm equivalente direto. O Angular resolveu reescrevendo a análise fora do tsc ; projetos com plugins próprios de transformação vão precisar de trabalho parecido.

Beta é beta. A 7.1 ainda não tem data de estável. Rodar em produção significa aceitar mudanças de API entre minors — exatamente o tipo de risco que ninguém quer descobrir num monorepo com 40 pacotes.

Lint experimental pode dar falso negativo. Um backend novo no parser não tem o mesmo conjunto de casos de teste que o caminho maduro. Se o time usa no-floating-promises como rede de segurança contra bugs assíncronos, não troque a engine e assuma que "passou no lint" quer dizer a mesma coisa.

Duas versões do compilador no mesmo node_modules . O alias resolve o conflito de peer dependency, mas aumenta o tempo de instalação e pode confundir IDEs que resolvem typescript pelo caminho padrão. Documente isso no README.

Benchmark de terceiro não é benchmark seu. Os 4,6x de Vue e os 3x do tsrs foram medidos em bases alheias. O ganho real depende do tamanho do projeto, do uso de tipos condicionais e da quantidade de arquivos .d.ts .

Recomendação

Para quem hoje está no TypeScript 6.x, não há motivo para pressa: a 7.1 está em beta e o ecossistema ainda está fechando as pontas. O movimento de valor imediato é de medição — instale o tsgo como job paralelo de --noEmit no CI, sem tirar o tsc atual do caminho crítico, e compare o tempo de type-check no seu repositório em uma semana de dados. É essa medição, e não o número do anúncio, que vai dizer se a migração se paga.

Para quem já está no 7.0 e sofreu com as ferramentas quebradas, a 7.1 beta é a primeira janela realista para sair do toolchain dividido — começando pelo lint, que é a peça com mais impacto no dia a dia do time.

Se o seu time está avaliando migrar a stack, montar um pipeline de type-check que aguente um monorepo grande ou desenvolver uma aplicação sob medida com Angular/TypeScript e back-end em .NET ou Python, vale conversar com o time da Maquinaweb. É o tipo de decisão de arquitetura que rende mais quando é discutida com quem já operou essa cadeia em produção.

Fontes

#TypeScript #tsgo #compilador #ESLint #Angular #Vue #Svelte #build #ferramentas de desenvolvimento #front-end
Contato

Bora conversar?

Três campos. A resposta vem no WhatsApp.

Ou escreva para contato@maquinaweb.com.br.

Você vai para o WhatsApp com a mensagem pronta. Sem spam, sem lista.

Seus dados seguem a nossa política de privacidade.