Fale conosco
Desenvolvimento

TypeScript 7.1 devolve a API do compilador: o que destrava em Vue, Svelte e no lint tipado

32 min de leitura

TypeScript 7.1 devolve a API do compilador: o que destrava em Vue, Svelte e no lint tipado

TypeScript 7.0 foi o que a Microsoft chamou de port nativo: compilador e language server reescritos em Go, com build completo tipicamente de 8x a 12x mais rápido que a 6.0 e checagem paralela em múltiplos núcleos. O problema apareceu três dias depois do upgrade, quando alguém percebeu que o CI estava rápido e o editor estava silencioso demais.

Silencioso no sentido ruim. A 7.0 não expunha API programática. Toda ferramenta que precisa ler um programa TypeScript — e não só compilá-lo — ficou de fora: Volar (e portanto vue-tsc ), a toolchain do Svelte, Astro, MDX, ts-morph , plugins de tsserver e o lint com informação de tipo. A beta da 7.1, anunciada em 20 de outubro por Daniel Rosenwasser, resolve a maior parte disso. E resolve de um jeito que interessa a quem mantém código, não só a quem escreve ferramenta.

A API que faltava, agora em pedaços

A 7.1 não reapresenta a API antiga. Ela foi fatiada em pontos de entrada separados — typescript/sync , typescript/async , mais superfícies para sistema de arquivos e AST — para que uma ferramenta importe só o que precisa, sem arrastar o compilador inteiro para dentro do processo.

Isso importa na prática por dois motivos:

Custo de bootstrap. Um plugin de editor não precisa carregar o checker inteiro para resolver um import ; ele carrega a fatia síncrona.

Isolamento de breaking change. A API monolítica era acoplada a detalhes internos do compilador em JavaScript. Ao fatiar, o time consegue evoluir o miolo em Go sem quebrar todo consumidor de uma vez.

Nas primeiras medições divulgadas pela Microsoft, a 7.1 fica até 4,6x mais rápida que a 7.0 em checagem de tipo. Num projeto Vue citado no anúncio, o tempo caiu de 14,19 s para 3,10 s. É número de fornecedor, mas o sinal é coerente com o ganho estrutural: menos camada JS no caminho.

Onde o ganho fica menos óbvio é no tsconfig.json . Depois de subir para a 7.x, o primeiro tsc costuma falhar antes de checar qualquer arquivo — types , typeRoots e resolução de @types mudaram de comportamento, e projetos que dependiam de chrome ou de tipos globais específicos passam a não enxergá-los. Vale rodar tsc --showConfig e comparar com a saída da 6.0 antes de culpar o código.

Content mappers: .vue , .svelte , .astro e .mdx dentro do compilador

Antes, vue-tsc funcionava aplicando um patch no compilador JavaScript por fora: transformava o bloco <script setup> em um arquivo virtual e devolvia o erro na posição certa do arquivo original. Com o compilador em Go, não havia onde aplicar o patch.

A 7.1 troca o gambito por um ponto de extensão oficial: content mappers . Um mapper declara "eu sei transformar arquivos com estas extensões em fonte TypeScript" e devolve o mapeamento de posições para que os erros apareçam na linha correta do .vue , não na linha do arquivo intermediário. O esqueleto conceitual é este:

O detalhe que costuma passar batido é o mapRange . Sem ele, o type check até funciona, mas a linha reportada aponta para o arquivo virtual — e o time perde meia hora procurando um erro que "não existe" na linha 3.

Com isso, o Vue Language Tools v4 alpha passou a usar content mappers em vez do patch, e existe RFC aberta no repositório do Oxc para o Oxlint rodar regras type-aware em .vue , .svelte e .astro , que hoje ficam fora do lint tipado.

O que fazer hoje: a toolchain dividida

Até a 7.1 estável — a discussão pública no repositório do Oxc aponta 24 de novembro, com RC antes disso — o caminho de menor atrito é dividir a responsabilidade. A 7.0 já permite instalar a 6.0 lado a lado; é a mesma ideia que o time usou no RC.

Duas armadilhas aqui:

typescript-eslint recusa instalar ao lado da 7.0 por causa da peer dependency. Se você forçar, o lint type-aware simplesmente não roda — e o build passa verde sem que ninguém tenha checado nada.

Plugins de tsserver deixam de carregar. Blocos plugins no tsconfig.json (GraphQL, styled-components, CSS Modules) viram configuração morta: sem erro, sem aviso.

Esse é o tipo de quebra que não aparece no CI, só na confiança do time no editor. Em times que usam Python e Node no mesmo stack, com Angular, .NET e bancos relacionais em projetos sob medida, é comum a esteira ter mais de uma linguagem e o TypeScript ficar no meio do caminho — daí a importância de tratar o upgrade como mudança de plataforma, com plano de rollback, e não como bump de package.json .

Quem já se mexeu

O Angular é o caso mais instrutivo. A equipe não esperou: colocou em beta o ngp , um pré-processador que reescreve a fase de análise em Rust com o Oxc, justamente porque o ngc dependia da API de transformers que a 7.0 removeu. O benchmark inicial fala em builds a frio de 2x a 3x mais rápidos, e a adoção está prevista para uma minor do Angular 22 — builds de produção devem continuar no ngc até lá. Tradução: mesmo quem não usa Vue nem Svelte teve de redesenhar pedaço do toolchain.

Riscos e custo de adoção

Duas versões do TypeScript no repo é dívida, não destino. Enquanto durar, prefixe scripts ( typecheck:native , lint:legacy ) para ninguém trocar um pelo outro por engano.

Performance não é verificação. Os 8x–12x da 7.0 compram tempo de CI, não cobertura. Se o lint ficou para trás, o número de defeitos pegos não melhorou.

Content mappers têm fronteira. Mappers resolvem arquivos que são fontes virtuais. Chamadas graphql() dentro de um .ts continuam precisando de outro arranjo — normalmente extrair para .graphql e mapear o arquivo.

Ecossistema desigual. Ferramentas com mantenedor ativo já estão na fila; plugins internos da sua empresa, provavelmente não. Faça inventário antes do upgrade, não durante.

Recomendação

Se você está na 6.x: teste a 7.1 RC com --noEmit num pipeline paralelo, mantendo a 6.0 como fonte da verdade para lint e editores. Se já está na 7.0: a 7.1 é o upgrade que devolve as ferramentas, então priorize-a como patch de plataforma — e valide manualmente o caminho de erros em .vue , .svelte ou .mdx , porque é ali que as quebras silenciosas moram.

Se o seu time precisa decidir entre migrar agora, esperar a estável ou reorganizar a esteira inteira para várias linguagens, o time da Maquinaweb pode ajudar a mapear o impacto no seu stack e desenhar a migração sem parar a entrega — inclusive em projetos sob medida que já nascem com TypeScript, Node.js e .NET no mesmo repositório.

Fontes

#TypeScript #TypeScript 7.1 #compilador nativo #Vue #Svelte #typescript-eslint #tooling #Angular #front-end #migração
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.